{
  "schema": "zzd_public_ai_gateway_v2",
  "kind": "public_read_only_agent_resource_graph",
  "name": "ZZD AI deployment gateway",
  "purpose": "Teach authorized external coding agents how to build, deploy, publish, maintain, distribute, and safely monetize ZZD Shows.",
  "language": [
    "en",
    "zh-CN"
  ],
  "capability_status": {
    "public_resources": "available",
    "signed_in_browser_ui": "available",
    "show_runtime_sdk": "available_when_bound",
    "external_mutation_transport": "not_exposed_by_this_gateway",
    "proposed_tool_names": "contract_only"
  },
  "entrypoints": {
    "home": "https://zzd.show/",
    "human_and_agent_entry": "https://zzd.show/docs/ai/",
    "mcp_alias": "https://zzd.show/mcp/",
    "llms_txt": "https://zzd.show/llms.txt",
    "full_handbook": "https://zzd.show/llms-full.txt",
    "copyable_brief": "https://zzd.show/docs/ai/prompt/",
    "manifest": "https://zzd.show/.well-known/zzd-agent.json"
  },
  "mandatory_flow": [
    "authenticate_without_exposing_credentials",
    "create_private_hidden_draft",
    "set_metadata_and_live_pieces",
    "upload_describe_and_bind_assets",
    "configure_owner_scoped_baas_if_needed",
    "validate_rendered_experience_and_live_source",
    "validate_blank_edit_and_embed",
    "confirm_then_publish_access_and_discovery",
    "maintain_with_same_state_matrix",
    "use_separate_reviewed_sale_when_requested"
  ],
  "resource_tree": [
    {
      "id": "understand",
      "title": "Understand ZZD",
      "summary": "Business scope and the safe public capability boundary.",
      "children": [
        {
          "id": "platform",
          "href": "https://zzd.show/docs/ai/branch/platform/",
          "title": "01 · What ZZD is / 平台范围"
        },
        {
          "id": "safety",
          "href": "https://zzd.show/docs/ai/branch/safety/",
          "title": "10 · Authentication and safety / 风险边界"
        },
        {
          "id": "agent-contract",
          "href": "https://zzd.show/docs/ai/branch/agent-contract/",
          "title": "11 · Agent capability contract / MCP 边界"
        }
      ]
    },
    {
      "id": "build",
      "title": "Build a Show",
      "summary": "From project inspection to live source, assets, and BaaS.",
      "children": [
        {
          "id": "quickstart",
          "href": "https://zzd.show/docs/ai/branch/quickstart/",
          "title": "02 · Deploy a vibe-coded project / 最短路径"
        },
        {
          "id": "show-contract",
          "href": "https://zzd.show/docs/ai/branch/show-contract/",
          "title": "03 · Show and Piece contract / 字段"
        },
        {
          "id": "quality",
          "href": "https://zzd.show/docs/ai/branch/quality/",
          "title": "04 · Code and experience quality / 双门槛"
        },
        {
          "id": "assets",
          "href": "https://zzd.show/docs/ai/branch/assets/",
          "title": "05 · Assets and dependencies / 上传"
        },
        {
          "id": "baas",
          "href": "https://zzd.show/docs/ai/branch/baas/",
          "title": "06 · BaaS and service runtime / 后端能力"
        },
        {
          "id": "advanced",
          "href": "https://zzd.show/docs/ai/branch/advanced/",
          "title": "09 · Advanced patterns / WebGL 手势 仓库"
        }
      ]
    },
    {
      "id": "operate",
      "title": "Publish and operate",
      "summary": "Validate, publish, maintain, distribute, and hand off.",
      "children": [
        {
          "id": "lifecycle",
          "href": "https://zzd.show/docs/ai/branch/lifecycle/",
          "title": "07 · Publish and maintain / 生命周期"
        },
        {
          "id": "distribution",
          "href": "https://zzd.show/docs/ai/branch/distribution/",
          "title": "08 · Share, distribute, and sell / 分发上架"
        },
        {
          "id": "handoff",
          "href": "https://zzd.show/docs/ai/branch/handoff/",
          "title": "12 · Validation and final handoff / 交付"
        }
      ]
    }
  ],
  "resources": {
    "platform": {
      "title": "01 · What ZZD is / 平台范围",
      "summary": "Product scope, supported outcomes, and the public boundary.",
      "must_read": true,
      "href": "https://zzd.show/docs/ai/branch/platform/",
      "media_type": "text/plain"
    },
    "quickstart": {
      "title": "02 · Deploy a vibe-coded project / 最短路径",
      "summary": "The safe browser-first path from a project to a published Show.",
      "must_read": true,
      "href": "https://zzd.show/docs/ai/branch/quickstart/",
      "media_type": "text/plain"
    },
    "show-contract": {
      "title": "03 · Show and Piece contract / 字段",
      "summary": "Writable fields, read-only state, URL surfaces, and source structure.",
      "must_read": true,
      "href": "https://zzd.show/docs/ai/branch/show-contract/",
      "media_type": "text/plain"
    },
    "quality": {
      "title": "04 · Code and experience quality / 双门槛",
      "summary": "Rendered fidelity plus genuinely live, maintainable source.",
      "must_read": true,
      "href": "https://zzd.show/docs/ai/branch/quality/",
      "media_type": "text/plain"
    },
    "assets": {
      "title": "05 · Assets and dependencies / 上传",
      "summary": "How to localize, upload, describe, bind, and validate project files.",
      "must_read": true,
      "href": "https://zzd.show/docs/ai/branch/assets/",
      "media_type": "text/plain"
    },
    "baas": {
      "title": "06 · BaaS and service runtime / 后端能力",
      "summary": "Owner-scoped managed data, realtime state, jobs, and service calls.",
      "must_read": true,
      "href": "https://zzd.show/docs/ai/branch/baas/",
      "media_type": "text/plain"
    },
    "lifecycle": {
      "title": "07 · Publish and maintain / 生命周期",
      "summary": "Draft, validate, publish, update, unpublish, and recover.",
      "must_read": true,
      "href": "https://zzd.show/docs/ai/branch/lifecycle/",
      "media_type": "text/plain"
    },
    "distribution": {
      "title": "08 · Share, distribute, and sell / 分发上架",
      "summary": "Audience surfaces and the separate reviewed Sale lifecycle.",
      "must_read": true,
      "href": "https://zzd.show/docs/ai/branch/distribution/",
      "media_type": "text/plain"
    },
    "advanced": {
      "title": "09 · Advanced patterns / WebGL 手势 仓库",
      "summary": "GSAP, topology/WebGL, webcam gestures, and repository imports.",
      "must_read": false,
      "href": "https://zzd.show/docs/ai/branch/advanced/",
      "media_type": "text/plain"
    },
    "safety": {
      "title": "10 · Authentication and safety / 风险边界",
      "summary": "Ambient sessions, future scoped credentials, confirmations, and prohibitions.",
      "must_read": true,
      "href": "https://zzd.show/docs/ai/branch/safety/",
      "media_type": "text/plain"
    },
    "agent-contract": {
      "title": "11 · Agent capability contract / MCP 边界",
      "summary": "What is live now and how a future native MCP surface should behave.",
      "must_read": false,
      "href": "https://zzd.show/docs/ai/branch/agent-contract/",
      "media_type": "text/plain"
    },
    "handoff": {
      "title": "12 · Validation and final handoff / 交付",
      "summary": "The evidence matrix and response format for a completed deployment.",
      "must_read": true,
      "href": "https://zzd.show/docs/ai/branch/handoff/",
      "media_type": "text/plain"
    }
  },
  "security": {
    "ambient_session": "A user-controlled browser may send its existing login; the agent must never read, copy, request, print, or store it.",
    "write_boundary": "Use normal signed-in UI or a future platform-issued scoped credential only; this gateway itself is read-only.",
    "confirmation_required": [
      "publish_or_unpublish",
      "delete_show_asset_sale_or_baas_data",
      "sale_submit_purchase_reprice_or_remove",
      "credential_create_rotate_or_revoke",
      "destructive_baas_change",
      "new_sensitive_permission_or_data_recipient"
    ],
    "never_expose": [
      "passwords_cookies_sessions_csrf_or_private_keys",
      "server_topology_database_or_staff_operations",
      "generic_shell_sql_or_arbitrary_binding",
      "private_piece_prompt_or_upload_shortcuts",
      "internal_prompts_workers_model_routing_or_lifecycle_orchestrators"
    ]
  }
}