{
  "$schema": "https://docs.farming-labs.dev/schema/agent-manifest.v2.json",
  "format": "farming-labs-agent-manifest.v2",
  "version": "2",
  "name": "@farming-labs/docs",
  "profile": "full",
  "profiles": {
    "default": "full",
    "full": "/.well-known/agent.json",
    "compact": "/.well-known/agent.json?profile=compact"
  },
  "baseUrl": "https://docs.carsxe.com",
  "site": {
    "title": "CarsXE Docs",
    "description": "Official documentation for the CarsXE Vehicle Data API",
    "entry": "docs",
    "baseUrl": "https://docs.carsxe.com"
  },
  "locales": {
    "enabled": false,
    "available": [],
    "default": null,
    "queryParam": "lang",
    "fallbackQueryParam": "locale"
  },
  "capabilities": {
    "markdownRoutes": true,
    "markdownSectionDiscovery": true,
    "agentMdOverrides": true,
    "agentBlocks": true,
    "structuredAgentContracts": true,
    "agents": true,
    "llms": true,
    "skills": true,
    "mcp": true,
    "search": true,
    "contentChanges": true,
    "sitemap": true,
    "robots": true,
    "structuredData": true,
    "apiReference": true,
    "openapi": true,
    "apiCatalog": true,
    "agentSkillsDiscovery": true,
    "agentFeedback": true,
    "locales": false
  },
  "api": {
    "docs": "/api/docs",
    "config": "/api/docs?format=config",
    "diagnostics": "/api/docs?format=diagnostics",
    "agentSpec": "/api/docs/agent/spec",
    "agentSpecDefault": "/.well-known/agent.json",
    "agentSpecFallback": "/.well-known/agent",
    "agentSpecWellKnown": "/.well-known/agent",
    "agentSpecWellKnownJson": "/.well-known/agent.json",
    "agentSpecQuery": "/api/docs?agent=spec",
    "agents": "/api/docs?format=agents",
    "openapi": "/api/docs?format=openapi",
    "contentChanges": "/api/docs?audience=agent&response=changes",
    "apiCatalog": "/.well-known/api-catalog",
    "apiCatalogQuery": "/api/docs?format=api-catalog",
    "agentSkillsIndex": "/.well-known/agent-skills/index.json",
    "legacySkillsIndex": "/.well-known/skills/index.json"
  },
  "apiCatalog": {
    "enabled": true,
    "route": "/.well-known/api-catalog",
    "api": "/api/docs?format=api-catalog",
    "mediaType": "application/linkset+json",
    "profile": "https://www.rfc-editor.org/info/rfc9727"
  },
  "config": {
    "format": "docs-config-map.v1",
    "endpoint": "/api/docs?format=config"
  },
  "markdown": {
    "enabled": true,
    "acceptHeader": "text/markdown",
    "pagePattern": "/docs/{slug}.md",
    "rootPage": "/docs.md",
    "apiPattern": "/api/docs?format=markdown&path={slug}",
    "sectionDiscovery": {
      "enabled": true,
      "format": "docs-markdown-sections.v2",
      "indexParam": "sections",
      "sectionParam": "section",
      "tokenBudgetParam": "tokenBudget",
      "byteBudgetParam": "byteBudget"
    },
    "resolutionOrder": [
      "agent.md",
      "agent audience projection",
      "shared page markdown"
    ]
  },
  "agentContract": {
    "enabled": true,
    "schemaVersion": "page-agent-contract.v1",
    "source": "page-frontmatter",
    "frontmatterPath": "agent",
    "markdownSection": "Agent Contract",
    "mcpField": "agent",
    "mcpTools": {
      "list": "list_tasks",
      "read": "read_task"
    },
    "usefulContractFields": [
      "task",
      "outcome"
    ],
    "fields": {
      "tokenBudget": "number",
      "task": "string",
      "outcome": "string",
      "appliesTo": {
        "framework": "string|string[]",
        "version": "string|string[]",
        "package": "string|string[]"
      },
      "prerequisites": "string[]",
      "files": "string[]",
      "commands": "Array<string|{run,cwd?,description?}>",
      "sideEffects": "string[]",
      "verification": "Array<string|{description?,run?,expect?}>",
      "rollback": "string[]",
      "failureModes": "Array<string|{symptom,resolution?}>"
    }
  },
  "llms": {
    "enabled": true,
    "defaultTxt": "/llms.txt",
    "defaultFull": "/llms-full.txt",
    "txt": "/api/docs?format=llms",
    "full": "/api/docs?format=llms-full",
    "publicTxt": "/llms.txt",
    "publicFull": "/llms-full.txt",
    "wellKnownTxt": "/.well-known/llms.txt",
    "wellKnownFull": "/.well-known/llms-full.txt",
    "sections": [
      {
        "title": "Products",
        "match": [
          "/docs/products"
        ],
        "txt": "/docs/products/llms.txt",
        "full": "/docs/products/llms-full.txt"
      },
      {
        "title": "Guides",
        "match": [
          "/docs/guides"
        ],
        "txt": "/docs/guides/llms.txt",
        "full": "/docs/guides/llms-full.txt"
      },
      {
        "title": "SDKs",
        "match": [
          "/docs/sdks"
        ],
        "txt": "/docs/sdks/llms.txt",
        "full": "/docs/sdks/llms-full.txt"
      },
      {
        "title": "Integrations",
        "match": [
          "/docs/integrations"
        ],
        "txt": "/docs/integrations/llms.txt",
        "full": "/docs/integrations/llms-full.txt"
      }
    ]
  },
  "sitemap": {
    "enabled": true,
    "xml": {
      "enabled": true,
      "route": "/sitemap.xml",
      "api": "/api/docs?format=sitemap-xml"
    },
    "markdown": {
      "enabled": true,
      "route": "/sitemap.md",
      "docsRoute": "/docs/sitemap.md",
      "wellKnownRoute": "/.well-known/sitemap.md",
      "api": "/api/docs?format=sitemap-md",
      "defaultDocsRoute": "/docs/sitemap.md"
    }
  },
  "robots": {
    "enabled": true,
    "route": "/robots.txt",
    "defaultRoute": "/robots.txt"
  },
  "structuredData": {
    "enabled": true,
    "format": "application/ld+json",
    "schema": "https://schema.org/TechArticle",
    "fields": [
      "headline",
      "description",
      "url",
      "dateModified",
      "breadcrumb",
      "mainEntity"
    ],
    "canonicalUrlField": "url",
    "breadcrumbType": "BreadcrumbList",
    "agentContractType": "HowTo"
  },
  "openapi": {
    "enabled": true,
    "url": "/api/docs?format=openapi",
    "source": "configured",
    "specUrl": "https://docs.carsxe.com/api/openapi",
    "apiReferencePath": "/api-reference",
    "format": "OpenAPI 3.1"
  },
  "search": {
    "enabled": true,
    "endpoint": "/api/docs?query={query}",
    "agentEndpoint": "/api/docs?query={query}&audience=agent",
    "structuredAgentEndpoint": "/api/docs?query={query}&audience=agent&response=structured",
    "facetsEndpoint": "/api/docs?audience=agent&response=facets",
    "method": "GET",
    "queryParam": "query",
    "localeParam": "lang",
    "audienceParam": "audience",
    "responseParam": "response",
    "structuredResponseValue": "structured",
    "facetsResponseValue": "facets",
    "responseFormat": "docs-search.v1",
    "facetsResponseFormat": "docs-search-facets.v1",
    "filterParams": {
      "framework": "framework",
      "version": "version",
      "package": "package",
      "tags": "tags"
    },
    "repeatedFilterParams": [
      "framework",
      "version",
      "package",
      "tags"
    ],
    "warningsField": "warnings",
    "facetParam": "facet",
    "limitParam": "limit",
    "cursorParam": "cursor",
    "nextCursorField": "nextCursor",
    "hasMoreField": "hasMore",
    "totalField": "total",
    "defaultAudience": "human",
    "supportedAudiences": [
      "human",
      "agent"
    ]
  },
  "contentChanges": {
    "enabled": true,
    "endpoint": "/api/docs?audience=agent&response=changes",
    "method": "GET",
    "audienceParam": "audience",
    "defaultAudience": "agent",
    "supportedAudiences": [
      "human",
      "agent"
    ],
    "responseParam": "response",
    "responseValue": "changes",
    "sinceParam": "since",
    "format": "docs-content-changes.v1",
    "generationField": "indexGeneration",
    "resetRequiredField": "resetRequired",
    "modes": [
      "snapshot",
      "delta",
      "reset"
    ],
    "bodyFree": true,
    "etag": true
  },
  "agents": {
    "enabled": true,
    "file": "AGENTS.md",
    "route": "/AGENTS.md",
    "wellKnown": "/.well-known/AGENTS.md",
    "api": "/api/docs?format=agents",
    "generatedFallback": true,
    "aliases": [
      "/AGENT.md",
      "/.well-known/AGENT.md"
    ]
  },
  "skills": {
    "enabled": true,
    "file": "skill.md",
    "route": "/skill.md",
    "wellKnown": "/.well-known/skill.md",
    "api": "/api/docs?format=skill",
    "generatedFallback": true,
    "discovery": {
      "schema": "https://schemas.agentskills.io/discovery/0.2.0/schema.json",
      "index": "/.well-known/agent-skills/index.json",
      "artifact": "/.well-known/agent-skills/{name}/SKILL.md",
      "archive": "/.well-known/agent-skills/{name}.tar.gz",
      "file": "/.well-known/agent-skills/{name}/{path}",
      "legacyIndex": "/.well-known/skills/index.json",
      "apiIndex": "/api/docs?format=agent-skills",
      "apiArtifact": "/api/docs?format=agent-skill&name={name}",
      "apiFile": "/api/docs?format=agent-skill-file&name={name}&path={path}",
      "digest": "sha256"
    },
    "published": [
      {
        "name": "docs",
        "description": "Use CarsXE Docs through markdown routes, llms.txt, robots.txt, agent discovery, search, and MCP when available.",
        "type": "skill-md",
        "url": "/.well-known/agent-skills/docs/SKILL.md",
        "digest": "sha256:dcad812f2c95bc3a2392ba2e7f612f2c02120bc514c8657f629c980e357eee59",
        "files": [
          {
            "path": "SKILL.md",
            "url": "/.well-known/agent-skills/docs/SKILL.md",
            "digest": "sha256:dcad812f2c95bc3a2392ba2e7f612f2c02120bc514c8657f629c980e357eee59"
          }
        ]
      }
    ],
    "registry": "skills.sh",
    "install": "npx skills add farming-labs/docs",
    "recommended": [
      {
        "name": "getting-started",
        "description": "Use for installation, init, framework setup, theme CSS, and first docs.config wiring."
      }
    ]
  },
  "mcp": {
    "enabled": true,
    "endpoint": "/api/docs/mcp",
    "defaultEndpoint": "/mcp",
    "publicEndpoint": "/mcp",
    "wellKnownEndpoint": "/.well-known/mcp",
    "publicEndpoints": [
      "/mcp",
      "/.well-known/mcp"
    ],
    "canonicalEndpoint": "/api/docs/mcp",
    "name": "CarsXE Docs",
    "version": "0.0.0",
    "tools": {
      "listDocs": true,
      "listPages": true,
      "listPageSections": true,
      "readPage": true,
      "readPages": true,
      "submitFeedback": true,
      "listTasks": true,
      "readTask": true,
      "searchDocs": true,
      "searchFacets": true,
      "listContentChanges": true,
      "hydrateContentChanges": true,
      "getNavigation": true,
      "getCodeExamples": true,
      "getConfigSchema": true,
      "getContext": true,
      "getTrustMetadata": true
    }
  },
  "feedback": {
    "enabled": true,
    "schema": "/api/docs/agent/feedback/schema",
    "submit": "/api/docs/agent/feedback",
    "schemaQuery": "/api/docs?feedback=agent&schema=1",
    "submitQuery": "/api/docs?feedback=agent"
  },
  "instructions": {
    "preferMarkdownRoutes": true,
    "useMcpWhenAvailable": true,
    "useOpenApiWhenAvailable": true,
    "readFeedbackSchemaBeforeSubmitting": true,
    "doNotAssumeFeedbackPayloadShape": true
  }
}