{
  "openapi": "3.1.0",
  "info": {
    "title": "See2Ready public discovery API",
    "version": "1.0.0",
    "description": "Public metadata only. This is not MCP or Agent2Agent. No authentication credentials should be submitted."
  },
  "servers": [
    {
      "url": "https://api.see2ready.live"
    }
  ],
  "paths": {
    "/v1/service.json": {
      "get": {
        "operationId": "service",
        "summary": "Service identity and scope",
        "responses": {
          "200": {
            "description": "Public JSON resource",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "schema": "hsimc.service-entry.v1",
                  "id": "hri:hsimc:service:see2ready:entry:1.0",
                  "brand": "See2Ready",
                  "provider": {
                    "name": "Hong Kong & Shenzhen Instant Manufacturing Corporation Limited",
                    "url": "https://hsimc.tech/"
                  },
                  "edition": "1.0",
                  "artifact": "HRI-HSIMC-C004-MULTIBRAND-HOME-API-FOUNDATION-P12-001",
                  "home": "https://see2ready.live/",
                  "api_base": "https://api.see2ready.live/",
                  "role": "Visual understanding → Real-world capability",
                  "a2a_meaning": "Action -> Asset",
                  "stage": "PUBLIC_HOME_AND_READ_ONLY_DISCOVERY",
                  "interfaces": {
                    "read_http_json": true,
                    "openapi": "https://api.see2ready.live/openapi.json",
                    "new_mcp_service": false,
                    "new_agent2agent_service": false,
                    "customer_mailbox_access": false,
                    "device_execution": false,
                    "cross_origin_a2a_writes": false
                  },
                  "resources": [
                    {
                      "url": "https://api.see2ready.live/v1/service.json",
                      "methods": [
                        "GET",
                        "HEAD"
                      ]
                    },
                    {
                      "url": "https://api.see2ready.live/v1/capabilities.json",
                      "methods": [
                        "GET",
                        "HEAD"
                      ]
                    },
                    {
                      "url": "https://api.see2ready.live/v1/routes.json",
                      "methods": [
                        "GET",
                        "HEAD"
                      ]
                    },
                    {
                      "url": "https://api.see2ready.live/v1/status.json",
                      "methods": [
                        "GET",
                        "HEAD"
                      ]
                    }
                  ],
                  "notes": [
                    "MCP and external Agent2Agent are not enabled on this host.",
                    "Originating a read does not grant authority to act.",
                    "Publication metadata is not a live health or commercial readiness statement."
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/v1/capabilities.json": {
      "get": {
        "operationId": "capabilities",
        "summary": "Implemented vs planned capabilities",
        "responses": {
          "200": {
            "description": "Public JSON resource",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "schema": "hsimc.capability-scope.v1",
                  "service_id": "hri:hsimc:service:see2ready:entry:1.0",
                  "implemented": [
                    {
                      "id": "public-service-reading",
                      "stage": "READ_ONLY",
                      "methods": [
                        "GET",
                        "HEAD"
                      ]
                    },
                    {
                      "id": "public-url-handoff",
                      "stage": "URL_QR_COPY_PRINT_NFC_IF_SUPPORTED"
                    }
                  ],
                  "external_existing_routes": [
                    {
                      "rel": "start",
                      "url": "https://hsimc.tech/start/",
                      "integration": "OUTBOUND_LINK_ONLY"
                    },
                    {
                      "rel": "work",
                      "url": "https://hsimc.tech/work/",
                      "integration": "OUTBOUND_LINK_ONLY"
                    },
                    {
                      "rel": "a2a",
                      "url": "https://hsimc.tech/a2a/",
                      "integration": "NATIVE_LOGIN_AT_HSIMC_ONLY"
                    },
                    {
                      "rel": "reality",
                      "url": "https://hsimc.tech/runtime-map/",
                      "integration": "OUTBOUND_LINK_ONLY"
                    },
                    {
                      "rel": "publications",
                      "url": "https://hsimc.tech/publications/",
                      "integration": "OUTBOUND_LINK_ONLY"
                    },
                    {
                      "rel": "existing-building-agent-guide",
                      "url": "https://hsimc.tech/runtime-map/hk/buildings/agent/",
                      "integration": "EXTERNAL_EXISTING_SERVICE_NOT_PROXIED"
                    }
                  ],
                  "not_enabled": [
                    "mailbox ingestion",
                    "private records API",
                    "new MCP endpoint",
                    "Agent2Agent task execution",
                    "payment",
                    "physical device control",
                    "automatic cross-domain project writes"
                  ],
                  "integration_policy": "Scope, permissions, inputs, tests and acceptance are agreed before connecting a business capability."
                }
              }
            }
          }
        }
      }
    },
    "/v1/routes.json": {
      "get": {
        "operationId": "routes",
        "summary": "Canonical routes and external continuations",
        "responses": {
          "200": {
            "description": "Public JSON resource",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "schema": "hsimc.entry-routes.v1",
                  "service_id": "hri:hsimc:service:see2ready:entry:1.0",
                  "canonical": "https://see2ready.live/",
                  "api_base": "https://api.see2ready.live/",
                  "aliases": [
                    "https://www.see2ready.live/",
                    "https://see2ready.com/",
                    "https://www.see2ready.com/"
                  ],
                  "links": [
                    {
                      "rel": "start",
                      "url": "https://hsimc.tech/start/",
                      "integration": "OUTBOUND_LINK_ONLY"
                    },
                    {
                      "rel": "work",
                      "url": "https://hsimc.tech/work/",
                      "integration": "OUTBOUND_LINK_ONLY"
                    },
                    {
                      "rel": "a2a",
                      "url": "https://hsimc.tech/a2a/",
                      "integration": "NATIVE_LOGIN_AT_HSIMC_ONLY"
                    },
                    {
                      "rel": "reality",
                      "url": "https://hsimc.tech/runtime-map/",
                      "integration": "OUTBOUND_LINK_ONLY"
                    },
                    {
                      "rel": "publications",
                      "url": "https://hsimc.tech/publications/",
                      "integration": "OUTBOUND_LINK_ONLY"
                    },
                    {
                      "rel": "existing-building-agent-guide",
                      "url": "https://hsimc.tech/runtime-map/hk/buildings/agent/",
                      "integration": "EXTERNAL_EXISTING_SERVICE_NOT_PROXIED"
                    }
                  ],
                  "related_brands": [
                    {
                      "brand": "See2Ready",
                      "home": "https://see2ready.live/",
                      "api": "https://api.see2ready.live/"
                    },
                    {
                      "brand": "Ready4Agents",
                      "home": "https://ready4agents.live/",
                      "api": "https://api.ready4agents.live/"
                    },
                    {
                      "brand": "AI2AI",
                      "home": "https://ai2ai.live/",
                      "api": "https://api.ai2ai.live/"
                    }
                  ],
                  "api_aliases": [
                    "https://api.see2ready.com/"
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/v1/status.json": {
      "get": {
        "operationId": "status",
        "summary": "Static edition status, not live health",
        "responses": {
          "200": {
            "description": "Public JSON resource",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "schema": "hsimc.publication-status.v1",
                  "service_id": "hri:hsimc:service:see2ready:entry:1.0",
                  "edition": "1.0",
                  "publication_kind": "STATIC_READ_ONLY_DISCOVERY",
                  "live_health_measurement": false,
                  "business_integration_status": "NOT_CONNECTED_BY_THIS_EDITION",
                  "external_model_acceptance": "NOT_RUN",
                  "updated_at": "2026-09-13",
                  "artifact": "HRI-HSIMC-C004-MULTIBRAND-HOME-API-FOUNDATION-P12-001"
                }
              }
            }
          }
        }
      }
    }
  },
  "security": []
}