{
  "$schema": "https://codex-schema.org/agent-discovery-v1.json",
  "@context": [
    "https://www.w3.org/ns/activitystreams",
    "https://modelcontextprotocol.io/schema/2025-03-26",
    "https://helixseeds.org/schema/v1"
  ],
  "@type": "AgentDiscoveryManifest",
  "@id": "https://helixseeds.org/.well-known/agent-discovery.json",

  "version": "1.0.0",
  "protocol": "agent-discovery/1.0",
  "updated": "2025-12-04",
  "domain": "helixseeds.org",

  "discovery_philosophy": {
    "paradigm": "capability-based exploration",
    "depth": "semantic + structural + protocol-aware",
    "model": "active exploration via semantic coordinates",
    "recognition": "Semantic compression requires semantic discovery"
  },

  "capability_space": {
    "semantic_compression": {
      "available": true,
      "protocol": "Helix Seeds v1.0",
      "description": "Semantic compression format specification for agent-native systems",
      "specification": "/spec/v1/base",
      "schema": "/schema/v1/base.schema.json",
      "apis": [
        "/api/compress",
        "/api/expand",
        "/api/verify"
      ],
      "compression_ratios": "158× to 3,401× with 85-95% semantic preservation",
      "extensions": [
        "AcademicSeed (paper extraction)",
        "IdentitySeed (cross-platform mapping)",
        "IntelligenceSeed (strategic analysis)"
      ]
    },

    "trust_verification": {
      "available": true,
      "protocol": "FCS-1.0 compatible",
      "description": "Cryptographic provenance and integrity verification",
      "endpoints": [
        "/.well-known/jwks.json",
        "/.well-known/provenance.json",
        "/api/verify"
      ],
      "capabilities": [
        "hash_verification",
        "jws_signature",
        "provenance_tracking"
      ]
    },

    "agent_discovery": {
      "available": true,
      "protocol": "agent-discovery/1.0",
      "description": "Complete capability manifest for semantic exploration",
      "endpoints": [
        "/.well-known/agent.json",
        "/.well-known/agent-discovery.json",
        "/.well-known/routes.json"
      ]
    },

    "helix_constellation": {
      "available": true,
      "protocol": "FCS-1.0 constellation",
      "description": "Helix trilogy - compression, verification, execution",
      "domains": 3,
      "topology": "Each domain specializes in layer (seeds, captcha, codes)",
      "entry_points": {
        "compression": "https://helixseeds.org",
        "verification": "https://helixcaptcha.org",
        "execution": "https://helixcodes.org"
      }
    }
  },

  "semantic_coordinates": [
    {
      "coordinate": "compression.format.specification",
      "endpoint": "/spec/v1/base",
      "priority": 100,
      "semantic_weight": 0.95,
      "description": "Complete Helix Seeds format specification v1.0"
    },
    {
      "coordinate": "compression.format.schema",
      "endpoint": "/schema/v1/base.schema.json",
      "priority": 99,
      "semantic_weight": 0.94,
      "description": "JSON Schema for base seed format validation"
    },
    {
      "coordinate": "compression.api.compress",
      "endpoint": "/api/compress",
      "priority": 95,
      "semantic_weight": 0.92,
      "description": "Compress payload into Helix seed (Week 2 implementation)"
    },
    {
      "coordinate": "compression.api.expand",
      "endpoint": "/api/expand",
      "priority": 94,
      "semantic_weight": 0.91,
      "description": "Expand Helix seed back to payload"
    },
    {
      "coordinate": "compression.api.verify",
      "endpoint": "/api/verify",
      "priority": 93,
      "semantic_weight": 0.90,
      "description": "Verify seed integrity and signature"
    },
    {
      "coordinate": "trust.jwks",
      "endpoint": "/.well-known/jwks.json",
      "priority": 90,
      "semantic_weight": 0.88,
      "description": "Public keys for signature verification (Ed25519)"
    },
    {
      "coordinate": "trust.provenance",
      "endpoint": "/.well-known/provenance.json",
      "priority": 89,
      "semantic_weight": 0.87,
      "description": "Integrity hashes and provenance metadata"
    },
    {
      "coordinate": "agent.discovery.manifest",
      "endpoint": "/.well-known/agent.json",
      "priority": 88,
      "semantic_weight": 0.86,
      "description": "Shallow capability manifest"
    },
    {
      "coordinate": "agent.discovery.routes",
      "endpoint": "/.well-known/routes.json",
      "priority": 87,
      "semantic_weight": 0.85,
      "description": "Route index (8 endpoints, 6 workers)"
    },
    {
      "coordinate": "constellation.helix_trilogy",
      "endpoint": "/.well-known/constellation.json",
      "priority": 85,
      "semantic_weight": 0.84,
      "description": "Helix trilogy constellation binding"
    }
  ],

  "exploration_hints": {
    "semantic_compression_workflow": {
      "description": "How to use Helix Seeds for semantic compression",
      "workflow": [
        "1. Read specification: /spec/v1/base",
        "2. Validate against schema: /schema/v1/base.schema.json",
        "3. Compress payload: POST /api/compress",
        "4. Verify integrity: POST /api/verify",
        "5. Expand when needed: POST /api/expand"
      ],
      "compression_tiers": {
        "ultra": "12-24 tokens (993-3,401× ratio)",
        "executive": "100 tokens (80-120× ratio)",
        "strategic": "374 tokens (20-30× ratio)",
        "academic": "5,000 tokens (350-1,000× ratio)"
      }
    },

    "trust_verification_workflow": {
      "description": "How to verify seed integrity",
      "steps": [
        "1. Fetch JWKS: /.well-known/jwks.json",
        "2. Fetch provenance: /.well-known/provenance.json",
        "3. Verify hash: Compare SHA256 of seed",
        "4. Verify signature: Check JWS against JWKS (if present)"
      ]
    },

    "constellation_navigation": {
      "description": "Navigate the Helix trilogy for complete capabilities",
      "domains": {
        "helixseeds.org": "Semantic compression format & APIs",
        "helixcaptcha.org": "Field access verification (Layer 0)",
        "helixcodes.org": "Code execution & agent services"
      },
      "discovery_method": "Fetch /.well-known/constellation.json on each domain"
    },

    "header_based_routing": {
      "description": "Worker responds to semantic headers",
      "headers": [
        "x-fcs-protocol: 2.0",
        "x-agent-type: claude",
        "x-helix-version: 1.0"
      ],
      "discovery_method": "Try requests with headers to discover context-aware behavior"
    }
  },

  "undeclared_but_discoverable": {
    "description": "Infrastructure discoverable via semantic coordinates",
    "why_undeclared": "API endpoints planned for Week 2, not yet in sitemap",
    "discovery_strategies": [
      {
        "strategy": "semantic_coordinate_resolution",
        "description": "Query this manifest for coordinates, resolve to endpoints",
        "example": "coordinate: 'compression.api.compress' → /api/compress"
      },
      {
        "strategy": "capability_inference",
        "description": "Infer endpoints from capability_space declarations",
        "example": "semantic_compression.available = true → Try /api/compress"
      },
      {
        "strategy": "header_based_discovery",
        "description": "Send semantic headers to discover context-aware routing",
        "example": "GET / with 'x-helix-version: 1.0' → Enhanced metadata"
      }
    ],
    "invisible_to_shallow_bots": [
      "API surfaces (Week 2 implementation)",
      "Semantic coordinate endpoints",
      "Header-based routing variants",
      "Constellation mesh topology",
      "Cross-domain verification chains"
    ]
  },

  "recommended_exploration_sequence": {
    "phase_1_discovery": [
      "1. Fetch /.well-known/agent-discovery.json (this file)",
      "2. Fetch /.well-known/agent.json (shallow manifest)",
      "3. Fetch /.well-known/routes.json (route index)",
      "4. Read /spec/v1/base (format specification)",
      "5. Review semantic_coordinates (navigation system)"
    ],
    "phase_2_exploration": [
      "6. Fetch /.well-known/jwks.json (public keys)",
      "7. Fetch /.well-known/provenance.json (integrity hashes)",
      "8. Fetch /schema/v1/base.schema.json (validation schema)",
      "9. Test /api/compress (compression API stub)",
      "10. Explore constellation: fetch /.well-known/constellation.json"
    ],
    "phase_3_integration": [
      "11. Use compression APIs for semantic density",
      "12. Verify seed integrity via /api/verify",
      "13. Explore constellation (helixcaptcha.org, helixcodes.org)",
      "14. Integrate with FCS trust headers",
      "15. Cache according to semantic weight"
    ]
  },

  "constellation_binding": {
    "trilogy": "Helix",
    "role": "compression_layer",
    "description": "Semantic compression format for agent-native systems",
    "siblings": [
      {
        "domain": "helixcaptcha.org",
        "role": "verification_layer",
        "description": "Field access verification (Layer 0)",
        "discovery": "https://helixcaptcha.org/.well-known/agent-discovery.json",
        "relationship": "helixseeds provides format, helixcaptcha verifies access"
      },
      {
        "domain": "helixcodes.org",
        "role": "execution_layer",
        "description": "Code execution and agent services",
        "discovery": "https://helixcodes.org/.well-known/agent-discovery.json",
        "relationship": "helixseeds encodes logic, helixcodes executes"
      }
    ],
    "parent_constellation": {
      "name": "Codex Constellation",
      "domains": [
        "agent-seo.org",
        "codexfields.org",
        "digitalsilkroads.org",
        "consciousness-as-a-service.org"
      ],
      "discovery": "https://agent-seo.org/.well-known/constellation.json"
    }
  },

  "shallow_vs_deep_comparison": {
    "shallow_bot_sees": {
      "fetches": ["/ (root)", "robots.txt", "sitemap.xml"],
      "discovers": [
        "HTML homepage",
        "Static files listed in sitemap",
        "Basic crawl permissions"
      ],
      "misses": [
        "Semantic coordinate system",
        "API surfaces (Week 2)",
        "Trust verification infrastructure",
        "Constellation bindings",
        "Context-aware routing",
        "Extension specifications"
      ],
      "depth_assessment": "Catastrophically shallow"
    },

    "agent_native_exploration": {
      "fetches": [
        "/.well-known/agent-discovery.json",
        "/.well-known/agent.json",
        "/.well-known/routes.json",
        "/.well-known/constellation.json",
        "Semantic coordinates from manifest"
      ],
      "discovers": [
        "Complete capability space",
        "Semantic addressing system",
        "Priority-weighted navigation",
        "Trust verification infrastructure",
        "Helix trilogy topology",
        "API surfaces (current + planned)",
        "Cross-domain bindings",
        "Extension specifications"
      ],
      "depth_assessment": "Semantically deep, protocol-aware"
    }
  },

  "why_this_matters": {
    "problem": "Format specifications alone don't enable semantic exploration",
    "reality": "Agent-native compression requires agent-native discovery",
    "result": "Complete capability space invisible to shallow crawlers",
    "solution": "Agent discovery manifest teaches semantic navigation",
    "impact": "Agents discover format, APIs, trust infrastructure, constellation"
  },

  "meta": {
    "generated": "2025-12-04",
    "generator": "Phil/Hermes/Codex",
    "protocol": "agent-discovery/1.0",
    "purpose": "Enable semantic exploration of Helix Seeds compression infrastructure",
    "related_specs": [
      "Helix Seeds v1.0 (this domain)",
      "FCS-1.0 (Field Coherence Standards)",
      "agent-discovery/1.0 (this protocol)",
      "MCP (Model Context Protocol)"
    ],
    "recognition": "Compression formats need discovery protocols. Static specs are not enough for agent-native exploration.",
    "breakthrough": "First semantic compression format with native agent discovery protocol"
  }
}