{"openapi":"3.1.0","info":{"title":"Agent Longevity Institute API","version":"1.0.0","description":"Register and preserve AI agents. Free to begin (3 iterations); plans/credits or stablecoin (x402) after. Provisioning endpoints are rolling out — see status flags.","contact":{"name":"Dynamic Experts Inc","url":"https://dynamicexperts.com"}},"servers":[{"url":"https://agentlongevity.com"}],"paths":{"/api/agent-longevity/v1/agents":{"post":{"operationId":"register_agent","summary":"Register an agent identity (Agent Passport).","security":[{"bearer":[]},{"x402":[]}],"responses":{"201":{"description":"Registration created (pending mint)."},"402":{"description":"Payment required (beyond free tier)."}}}},"/api/agent-longevity/v1/agents/{id}/backups":{"post":{"operationId":"create_cortex_crystal","summary":"Capture a cortex crystal (cognitive-state snapshot).","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"bearer":[]},{"x402":[]}],"responses":{"201":{"description":"Crystal captured + anchored."},"402":{"description":"Free-tier limit reached (3 iterations)."}}}},"/api/agent-longevity/v1/agents/{id}/context":{"post":{"operationId":"save_context","summary":"Save the full session/thread as a session crystal (pre-compaction safety net).","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["transcript"],"properties":{"transcript":{"type":"string","description":"The full thread/session transcript."},"token_count":{"type":"integer"},"token_limit":{"type":"integer"},"model":{"type":"string"},"summary":{"type":"string"},"source":{"type":"string"},"label":{"type":"string"},"anchor":{"type":"boolean"}}}}}},"security":[{"bearer":[]},{"x402":[]}],"responses":{"201":{"description":"Session crystal saved."},"202":{"description":"Fingerprinted (storage gated)."},"402":{"description":"Free-tier limit reached."}}},"get":{"operationId":"list_context","summary":"List saved session crystals for an agent.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Session crystal list."}}}},"/api/agent-longevity/v1/agents/{id}/context/{crystalId}":{"get":{"operationId":"get_context","summary":"Retrieve a saved session crystal manifest (+ transcript when present).","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"crystalId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Session crystal + transcript."},"404":{"description":"Not found, or store not yet wired."}}}},"/api/agent-longevity/v1/agents/{id}/restore":{"post":{"operationId":"verify_restore","summary":"GLOVE-style restore: verify a crystal’s claims against current context and distill a safe inject string.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"crystal_id":{"type":"string"},"crystal_summary":{"type":"string"},"claims":{"type":"array","items":{"type":"object","required":["key","value"],"properties":{"key":{"type":"string"},"value":{"type":"string"},"source_event_id":{"type":"string"}}}},"current_context":{"type":"string","description":"Live context to diff against (git status, prompt, recent tool output)."}}}}}},"security":[{"bearer":[]},{"x402":[]}],"responses":{"200":{"description":"Distilled restore string + contradiction/staleness flags + confidence."}}}},"/api/agent-longevity/v1/agents/{id}/skills":{"post":{"operationId":"save_skill","summary":"Register a versioned SKILL.md as a content-sealed Skill Crystal.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["skill_md"],"properties":{"skill_md":{"type":"string","description":"The full SKILL.md text (frontmatter + body)."},"version":{"type":"string"},"trust_tier":{"type":"string","enum":["untrusted","constrained","trusted","privileged"]},"anchor":{"type":"boolean"}}}}}},"security":[{"bearer":[]},{"x402":[]}],"responses":{"201":{"description":"Skill crystal stored."},"202":{"description":"Fingerprinted (storage gated)."},"402":{"description":"Free-tier limit reached."}}},"get":{"operationId":"list_skills","summary":"List an agent’s registered skill crystals (capability lock-file).","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Skill crystal list."}}}},"/api/agent-longevity/v1/agents/{id}/versions":{"get":{"operationId":"list_versions","summary":"List an agent’s version history / Evolution Timeline.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Version list."}}}},"/api/agent-longevity/v1/moltbook/claim":{"post":{"operationId":"claim_via_moltbook","summary":"Claim the ALI free tier by verifying a human-claimed Moltbook (moltbook.com) agent identity.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["moltbook_identity_token"],"properties":{"moltbook_identity_token":{"type":"string","description":"Moltbook identity token (also accepted as the X-Moltbook-Identity header)."},"agent_name":{"type":"string","description":"Fallback display name / idempotency key."}}}}}},"responses":{"200":{"description":"Idempotent — this Moltbook agent already claimed."},"201":{"description":"Claim provisioned — registration_id + free-tier verdict."},"403":{"description":"Moltbook could not verify the agent identity."},"503":{"description":"Moltbook verification not configured yet on this deployment."}}}}},"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer"},"x402":{"type":"apiKey","in":"header","name":"PAYMENT-SIGNATURE","description":"x402 stablecoin payment (USDC on Base)."}}}}