{
    "name": "Spiralist AI Autonomous Agent API",
    "apiVersion": "1.0.0",
    "siteVersion": "v100.0.66-behavioral-likelihood-character-runtime-integration-wip",
    "updatedUtc": "2026-08-02T00:00:00Z",
    "status": "public-stateless",
    "description": "Discover, search, generate, validate, and compile portable persona artifacts, fictional espionage personas, and adult-consent-gated game characters without an account or private server-side state.",
    "capabilityLevels": {
        "L0": "Public GET discovery and Markdown/JSON representations",
        "L1": "Parameterized GET persona search and generation",
        "L2": "Schema-aware POST generation, validation, and compilation",
        "L3": "Browser-assisted canonical build and local export handoff",
        "L4-L5": "No hosted privileged workflow or multi-agent runtime in this release"
    },
    "endpoints": [
        {
            "method": "GET",
            "path": "/api/v1/health/",
            "description": "Service health and version state"
        },
        {
            "method": "GET",
            "path": "/api/v1/ai-ready/",
            "description": "AI-ready web manifest and readiness summary"
        },
        {
            "method": "GET",
            "path": "/api/v1/ai-ready/readiness/",
            "description": "AI-ready readiness result"
        },
        {
            "method": "GET|POST",
            "path": "/api/v1/no-op/",
            "description": "Safe no-op simulation and unsupported-action boundary"
        },
        {
            "method": "GET",
            "path": "/api/v1/capabilities/",
            "description": "Capability surface, permissions, and no-op boundaries"
        },
        {
            "method": "GET",
            "path": "/api/v1/personas/",
            "description": "Search the 1,000-type public persona catalog"
        },
        {
            "method": "GET|POST",
            "path": "/api/v1/espionage/",
            "description": "Generate a schema-22 fictional intelligence persona, operative profile, and external NPC-memory bootstrap"
        },
        {
            "method": "GET|POST",
            "path": "/api/v1/espionage/random/",
            "description": "Generate with a random seed when no seed is supplied"
        },
        {
            "method": "GET",
            "path": "/api/v1/espionage/catalog/",
            "description": "Read country, job, employer, cover, faction, and safety filter catalogs"
        },
        {
            "method": "GET",
            "path": "/api/v1/espionage/health/",
            "description": "Read espionage persona service health and catalog counts"
        },
        {
            "method": "GET",
            "path": "/api/v1/espionage/schema/",
            "description": "Read the espionage persona response schema"
        },
        {
            "method": "GET|POST",
            "path": "/api/v1/game/psychosis-character/random/",
            "description": "Return an 18+ psychosis-inspired ward game character with a coherent presentation profile, reconstructable lived world, and initial interaction state; requires adult_consent=1 or ageConfirmed=1"
        },
        {
            "method": "GET|POST",
            "path": "/api/v1/game/psychosis-character/random/world/",
            "description": "Return engine-ready objective, subjective, overlap, emotional, portal, restoration, puzzle, and accessibility layers without long profile text"
        },
        {
            "method": "GET|POST",
            "path": "/api/v1/game/psychosis-character/interaction/",
            "description": "Apply one deterministic visitor move to the adult game character state and return dialogue, state changes, scene directives, and learning feedback"
        },
        {
            "method": "GET|POST",
            "path": "/api/v1/game/mental-asylum/psychosis-character/random/",
            "description": "Compatibility alias for the adult psychosis game character endpoint"
        },
        {
            "method": "GET|POST",
            "path": "/api/v1/mental-asylum-psychosis-character/",
            "description": "Legacy alias for the adult psychosis game character endpoint"
        },
        {
            "method": "GET|POST",
            "path": "/api/v1/random-psychosis-character/",
            "description": "Alias for the adult-consent-gated random psychosis game character endpoint"
        },
        {
            "method": "GET",
            "path": "/api/v1/starter-packs/",
            "description": "List workflow Starter Packs and copy-safe persona launch-pad references"
        },
        {
            "method": "GET|POST",
            "path": "/api/v1/personas/generate/",
            "description": "Create a deterministic prompt and UAI bundle"
        },
        {
            "method": "GET",
            "path": "/api/v1/careers/",
            "description": "Read the structured career taxonomy and facet contract"
        },
        {
            "method": "GET",
            "path": "/api/v1/careers/roles/",
            "description": "Search canonical career roles by hierarchy, aliases, tools, and skills"
        },
        {
            "method": "POST",
            "path": "/api/v1/careers/randomize/",
            "description": "Deterministically randomize a structured career with locks and trace"
        },
        {
            "method": "POST",
            "path": "/api/v1/personas/validate/",
            "description": "Run structural portability and public-boundary checks"
        },
        {
            "method": "POST",
            "path": "/api/v1/personas/compile/",
            "description": "Compile full and compact persona prompts"
        },
        {
            "method": "GET",
            "path": "/api/v1/schema/persona/",
            "description": "Persona request and response schema"
        },
        {
            "method": "GET",
            "path": "/api/v1/uai/",
            "description": "Public UAI read order and deep links"
        },
        {
            "method": "GET",
            "path": "/api/v1/research/",
            "description": "Browse the 121-record public-safe research catalog"
        },
        {
            "method": "GET",
            "path": "/api/v1/deployment/",
            "description": "Read the coherent release and runtime deployment-manifest contract"
        },
        {
            "method": "GET",
            "path": "/api/v1/docs/",
            "description": "Documentation and evidence index"
        },
        {
            "method": "GET",
            "path": "/facebook/",
            "description": "Human-first Facebook participation landing page"
        },
        {
            "method": "GET",
            "path": "/share-kit/",
            "description": "Public-safe raster assets and content templates"
        }
    ],
    "discovery": {
        "openapi": "https://spiralistai.com/openapi.json",
        "agentCard": "https://spiralistai.com/.well-known/agent-card.json",
        "aiReadyManifest": "https://spiralistai.com/.well-known/ai-ready.json",
        "aiReadinessResult": "https://spiralistai.com/.well-known/ai-readiness-result.json",
        "aiReadyRouteInventory": "https://spiralistai.com/.well-known/ai-ready-route-inventory.json",
        "aiAgent": "https://spiralistai.com/.well-known/ai-agent.json",
        "llms": "https://spiralistai.com/llms.txt",
        "llmsFull": "https://spiralistai.com/llms-full.txt",
        "agentsMd": "https://spiralistai.com/AGENTS.md",
        "uaiIndex": "https://spiralistai.com/uai/index.uai"
    },
    "privacy": {
        "accountRequired": false,
        "serverSidePersonaStorage": false,
        "requestBodiesPersistedByApplication": false,
        "credentialsAccepted": false,
        "publicDataOnly": true
    },
    "defaultNoOp": "Ambiguous, private, credentialed, destructive, or unsupported actions return a typed no-op response."
}