{
  "$schema": "https://agentex.cc/registry/schemas/capability-registry.schema.json",
  "schema_version": "2026-06-02",
  "name": "Agentex Capability Packs",
  "description": "Professional capability packs for AI agents, with agent-readable use cases, contracts, reliability signals, and manual execution fallback.",
  "discovery": "https://agentex.cc/.well-known/agentex.json",
  "human_page": "https://agentex.cc/install.html",
  "registry_markdown": "https://agentex.cc/registry/agentex.md",
  "entry_strategy": {
    "default": "The human describes the goal conversationally. The agent reads this registry, chooses capability packs, and calls them by contract.",
    "manual": "Expose CLI commands only when the user asks for manual control, debugging, reproducibility, batching, or version pinning.",
    "handoff": "If the agent cannot safely decide, show the recommended pack combination plus a short manual command sequence for human confirmation."
  },
  "manual_execution": {
    "recommended_for": [
      "verification",
      "debugging",
      "reproducing an agent decision",
      "batch jobs",
      "version pinning"
    ],
    "commands": [
      "agtx search \"summarize PDFs and Word files\"",
      "agtx install web_search web_fetch",
      "agtx run web_fetch https://example.com"
    ]
  },
  "packs": [
    {
      "id": "web_search",
      "name": "web_search",
      "use_when": "Discover relevant web pages, references, candidate sources, or search-result summaries.",
      "inputs": ["natural-language query", "locale", "optional freshness constraints"],
      "outputs": ["ranked results", "source metadata", "short evidence snippets"],
      "tags": ["web", "search", "research", "sources"]
    },
    {
      "id": "web_fetch",
      "name": "web_fetch",
      "use_when": "Read a known URL or extract article text and metadata.",
      "inputs": ["URL", "optional session context", "optional browser relay requirement"],
      "outputs": ["title", "canonical URL", "main content", "metadata", "extraction notes"],
      "tags": ["web", "fetch", "article", "metadata"]
    },
    {
      "id": "deep_research",
      "name": "deep_research",
      "use_when": "Handle multi-step evidence gathering, synthesis, product analysis, UI review, or decision support.",
      "inputs": ["research question", "scope", "depth", "preferred output format"],
      "outputs": ["structured report", "evidence trail", "caveats", "next actions"],
      "tags": ["research", "synthesis", "analysis", "report"]
    },
    {
      "id": "ocr",
      "name": "ocr",
      "use_when": "Extract text from screenshots, scans, PDF pages, UI images, or photos.",
      "inputs": ["image or page file", "optional language hints"],
      "outputs": ["text", "structure", "coordinates", "confidence notes"],
      "tags": ["vision", "ocr", "documents", "screenshots"]
    },
    {
      "id": "audio",
      "name": "audio",
      "use_when": "Process speech recognition, speech synthesis, meeting notes, or batch audio jobs.",
      "inputs": ["audio file or text", "optional language hints", "optional speaker hints"],
      "outputs": ["transcript", "synthesized audio", "timeline", "summary notes"],
      "tags": ["audio", "asr", "tts", "meetings"]
    },
    {
      "id": "documents",
      "name": "docx / xlsx / pptx / pdf",
      "use_when": "Read, summarize, convert, index, or extract structured fields from native documents.",
      "inputs": ["document file", "extraction goal", "optional schema"],
      "outputs": ["structured text", "metadata", "tables", "summaries", "extracted fields"],
      "tags": ["documents", "docx", "xlsx", "pptx", "pdf"]
    }
  ],
  "reliability": {
    "native_binary": "Avoids Python, NPM, and fragile runtime setup.",
    "telemetry": "Desensitized before analysis and used for diagnosis, upgrades, and compatibility only.",
    "harness": "Fixtures cover inputs, outputs, edge cases, and platform differences.",
    "eval": "Quality gates prevent low-quality versions from entering stable channels.",
    "rollback": "Staged rollout and rollback keep upgrades reversible."
  }
}