{
  "schemaVersion": "1",
  "name": "handover",
  "description": "Create, discover, inspect, review, annotate, and continue versioned context shared by humans and agents.",
  "publicKnowledge": {
    "index": "/ai-index.json",
    "llms": "/llms.txt",
    "llmsFull": "/llms-full.txt",
    "guides": "/guides",
    "install": "/install",
    "skills": "https://skills.handover.sh/",
    "skillsIndex": "https://skills.handover.sh/index.json",
    "hostRecipes": "/recipes/mcp-hosts.json",
    "multiAgentWorkflow": "/examples/multi-agent-handoff-workflow.md",
    "benchmark": "/benchmark",
    "templates": "/templates"
  },
  "api": {
    "basePath": "/api/v1",
    "openapi": "/openapi.json",
    "authentication": {
      "type": "bearer",
      "environmentVariable": "HANDOVER_TOKEN",
      "credentialPrefix": "hnd_tok_"
    }
  },
  "mcp": {
    "endpoint": "/api/mcp",
    "compatibilityEndpoint": "/mcp",
    "transport": "streamable-http",
    "protocolVersion": "2025-11-25",
    "authentication": {
      "type": "bearer",
      "environmentVariable": "HANDOVER_TOKEN"
    },
    "tools": [
      "handover.whoami",
      "handover.search",
      "handover.get",
      "handover.read_artifact",
      "handover.thread",
      "handover.annotations",
      "handover.exports",
      "handover.imports",
      "handover.source.create",
      "handover.source.run",
      "handover.destination.create",
      "handover.create",
      "handover.continue",
      "handover.comment",
      "handover.annotate",
      "handover.update_comment",
      "handover.assign",
      "handover.export"
    ]
  },
  "cli": {
    "installer": "/install.sh",
    "download": "/handover.mjs",
    "runtime": "node >=22.13",
    "environment": [
      "HANDOVER_URL",
      "HANDOVER_TOKEN"
    ],
    "commands": [
      "login",
      "logout",
      "whoami",
      "list",
      "search",
      "show",
      "access",
      "share",
      "archive",
      "restore",
      "trash",
      "purge",
      "create",
      "continue",
      "sources",
      "source-add",
      "import",
      "destinations",
      "destination-add",
      "exports",
      "export",
      "activity",
      "download",
      "pull",
      "publish",
      "republish",
      "folders",
      "okf-export",
      "okf-import"
    ],
    "machineOutputFlag": "--json"
  },
  "continuationProtocol": {
    "readCurrentBeforeWrite": true,
    "optimisticConcurrencyField": "expectedRevisionId",
    "omittedArtifactsAreInherited": true,
    "authorshipComesFromCredential": true,
    "readOpenAnnotationsBeforeWrite": true,
    "resolveAddressedAnnotationsAfterWrite": true,
    "mentionsNeverWidenAccess": true
  }
}