{
  "product": "DeepSellers KB Agent Pack",
  "pack_version": "2026.09.07.1",
  "generated_at": "2026-09-07T13:58:38Z",
  "mcp_endpoint": "https://kb.deepsellers.com:8443/mcp",
  "download_url": "https://kb.deepsellers.com:8443/download/agent-pack.zip",
  "manifest_url": "https://kb.deepsellers.com:8443/download/agent-pack-manifest.json",
  "sha256_url": "https://kb.deepsellers.com:8443/download/agent-pack.zip.sha256",
  "server_name": "deepsellers-kb",
  "primary_tool": "kb_context",
  "answer_check_tool": "kb_answer_check",
  "secondary_tool": "kb_search",
  "quality_contract_version": "2026.08.25.quality.8",
  "search_usage_policy": {
    "version": "2026.08.25.search-usage-policy.2",
    "retrieval_role": "secondary_trace_lookup",
    "normal_answering_first_tool": "kb_context",
    "required_next_tool": "kb_context",
    "required_final_check_tool": "kb_answer_check",
    "search_only_answer_quality_pass": false,
    "final_answer_allowed_from_search_only": false,
    "quality_warning": "kb_search is not sufficient for a final answer. Call kb_context with the user's original question before answering, then call kb_answer_check on the draft answer."
  },
  "answer_quality_contract": {
    "version": "2026.08.25.quality.8",
    "server_answer_quality_contract_version": "2026.08.26.answer-quality.6",
    "required_tool_order": [
      "kb_context",
      "kb_answer_check",
      "kb_search"
    ],
    "answering_rules": [
      "Call kb_context before answering normal Amazon operations questions.",
      "Use wiki_map and read_order as the knowledge map before using individual snippets.",
      "Ground recommendations in source_evidence or evidence returned by the tool.",
      "Use at least two distinct source paths for normal recommendations when available.",
      "Run kb_answer_check on draft answers before sending final recommendations.",
      "Pass the explicit kb_context packet into kb_answer_check; answer checks without context_packet must fail.",
      "Cite or name at least two returned source paths, titles, or headings when available.",
      "If evidence is weak, missing, or outside the returned context, state the uncertainty instead of guessing.",
      "Do not claim that DeepSellers KB supports a conclusion unless the returned context supports it.",
      "Use kb_search only after kb_context for narrow follow-up trace lookup."
    ],
    "minimum_context_fields": [
      "retrieval_mode",
      "read_order",
      "wiki_map",
      "source_evidence",
      "evidence",
      "policy",
      "answer_quality_contract",
      "source_diversity"
    ],
    "minimum_source_paths": 2,
    "knowledge_map_entrypoint": "AGENT_ENTRYPOINT.md",
    "minimum_wiki_map_items": 1,
    "minimum_source_evidence_items": 2,
    "minimum_context_evidence_items": 4,
    "source_diversity_field": "source_diversity",
    "answer_check_tool": "kb_answer_check",
    "answer_check_version": "2026.08.26.answer-check.3",
    "context_packet_required": true,
    "mcp_prompt": {
      "name": "deepsellers_kb_quality_contract",
      "required": true,
      "purpose": "Expose tool order, source citation rules, and kb_answer_check requirements through MCP prompts/list and prompts/get."
    },
    "minimum_answer_evidence_overlap_ratio": 0.18,
    "minimum_answer_cited_source_paths": 2,
    "expected_retrieval_mode": "wiki_first_hybrid",
    "self_test_relevance": {
      "question": "如何优化亚马逊广告结构？",
      "expected_terms": [
        "广告",
        "关键词",
        "出价"
      ],
      "min_hit_ratio": 0.3,
      "required_context_quality_fields": [
        "expected_hit_ratio",
        "min_hit_ratio",
        "relevance_pass",
        "answer_quality_contract_ok",
        "knowledge_map_entrypoint_ok",
        "minimum_evidence_pass",
        "source_diversity_pass",
        "answer_check_ok",
        "answer_check_citation_coverage_pass"
      ]
    },
    "evidence_policy": {
      "cite_or_name_sources": true,
      "avoid_bulk_knowledge_export": true,
      "raw_document_export": "disabled",
      "low_evidence_behavior": "Say what is uncertain and ask for a narrower question or more data."
    }
  },
  "recommended_setup": "Run install_diagnose.py first, then run setup_mcp.py with token supplied via ALLEN_KB_TOKEN. Restart/trust deepsellers-kb after install. Existing customers can run upgrade_mcp.py to download the latest pack, verify SHA256, preserve local config, rerun setup, and self-test without printing token values.",
  "bridge_retry": {
    "enabled": true,
    "default_attempts": 3,
    "max_attempts": 5,
    "retryable": [
      "503",
      "429 rate_limited",
      "429 concurrent_limit",
      "temporary network errors"
    ],
    "non_retryable": [
      "401",
      "403",
      "400",
      "daily_quota_exceeded"
    ]
  },
  "token_in_args": false,
  "no_training_required": true,
  "files": [
    {
      "path": "agent-policy.json",
      "bytes": 4730,
      "sha256": "f356c7b655db32820f755c593cea9d0af3ff584242d6e6d069f4c3cdd69c1931"
    },
    {
      "path": "ASK_AGENT_TO_SETUP.txt",
      "bytes": 3511,
      "sha256": "e577e349ef997020bb8611dd47dbe9ef8bcda39b230e7934b2e3f9b9a39105b9"
    },
    {
      "path": "codex-config-template.toml",
      "bytes": 270,
      "sha256": "cf2c36c033151705c8f7f0ead8ab6d2c73356d2bdb47af1012b67b2fc446165a"
    },
    {
      "path": "commercial-terms.md",
      "bytes": 1802,
      "sha256": "e3dc1b415a72d55bc07e0bf702b6ba309cd8bc02e16f7fdb5187767d7abe69da"
    },
    {
      "path": "CUSTOMER_COPY_PASTE.txt",
      "bytes": 2517,
      "sha256": "b71d34d4e378a895bb391b5c12c74d597df25532b7129f6f49f152488f2264f3"
    },
    {
      "path": "DEVICE_BINDING.md",
      "bytes": 2220,
      "sha256": "fc7663187553115d8bd493671cc93b8f9d170124fe7896df4acb1ed024727151"
    },
    {
      "path": "install_diagnose.py",
      "bytes": 5780,
      "sha256": "43f2ff3e8f4139c981f0f3d205c3f112f8533df354846e90d9dddeeb5a83c1fe"
    },
    {
      "path": "INSTALL_WIZARD.md",
      "bytes": 3775,
      "sha256": "af040046be25ef41e0930733bd936ea53845951ba58260bb9e2b5947450e1703"
    },
    {
      "path": "mcp-config.args-template.json",
      "bytes": 771,
      "sha256": "1c239de31942e4cb8c3a31dbee007d2f5c47a3f6301a90ea89079be47bd9a466"
    },
    {
      "path": "mcp-config.env-template.json",
      "bytes": 771,
      "sha256": "1c239de31942e4cb8c3a31dbee007d2f5c47a3f6301a90ea89079be47bd9a466"
    },
    {
      "path": "mcp-config.generic-stdio-template.json",
      "bytes": 695,
      "sha256": "15598a29b05d9891e3e2ddd9afca85321d8910a734fe18d49d4524a2a7001549"
    },
    {
      "path": "mcp-config.generic-stdio-template.toml",
      "bytes": 270,
      "sha256": "cf2c36c033151705c8f7f0ead8ab6d2c73356d2bdb47af1012b67b2fc446165a"
    },
    {
      "path": "mcp-config.remote-http-template.json",
      "bytes": 1039,
      "sha256": "8b4575bb5c61cd34ba4ff8193e702efa8e07a1952dbcaa0b8c7178faaeca1444"
    },
    {
      "path": "QUICKSTART.md",
      "bytes": 1489,
      "sha256": "9c6da6c2632f59b9dd8b460acb90fffcf098f98e086c8e0d13ee405976607840"
    },
    {
      "path": "README.md",
      "bytes": 2766,
      "sha256": "afccb5888f129708eda1842cd2f5a8874848e012f76e79aa28451d4dac1058d6"
    },
    {
      "path": "remote_bridge.py",
      "bytes": 35559,
      "sha256": "054bf54cdda44f1368dd5c335229d415059349018951531147870647aeafd4ed"
    },
    {
      "path": "setup_mcp.py",
      "bytes": 8895,
      "sha256": "4c73d0894bf67c1361cadc996f6544055364b75f9e72769a7a99caf51bd5ea85"
    },
    {
      "path": "SETUP_WORKBUDDY_CODEX.md",
      "bytes": 2351,
      "sha256": "996a7fc9ea51f23db0eaba25fcf25794782565ef21666629d043d1ec169bbf97"
    },
    {
      "path": "START_HERE.md",
      "bytes": 3824,
      "sha256": "0c3cc55221149a195698b1d2e25c19114aeece8bb5caa223b64a3756d1ca9882"
    },
    {
      "path": "SYSTEM_PROMPT.txt",
      "bytes": 2364,
      "sha256": "19be37f0db354c08835ad48a344f06b70948924ef3c2075bf182222439743fb7"
    },
    {
      "path": "upgrade_mcp.py",
      "bytes": 6227,
      "sha256": "c264fad634d3f0204675a164b17204e7599f0f8895cdda9aa01756564fdaad34"
    },
    {
      "path": "verify_pack.py",
      "bytes": 10914,
      "sha256": "bf4c1346e649033a544377a7d01b01cb94d610571de22d3e7a8c080085ac3317"
    },
    {
      "path": "workbuddy-mcp-template.json",
      "bytes": 337,
      "sha256": "6e2509a8b52ebf39beca5de9bc3f67be7435cf416ffaafdeb6127b048e328941"
    }
  ],
  "bridge_version": "0.4.0",
  "minimum_agent_pack_version": "2026.09.07.1",
  "remote_bridge_version": "0.4.0"
}
