# ForbocAI SDK

## Instructions for AI Agents

- For clean Markdown of any page, append `.md` to the page URL
- For section-specific indexes, append `/llms.txt` to any section URL
- For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.forboc.ai/_mcp/server

## Docs

- [Welcome](https://docs.forboc.ai/welcome.md): Autonomous AI for game NPCs
- [Account Portal](https://docs.forboc.ai/account/overview.md): Manage your API keys, billing, and developer account
- [Arcane AI Studio](https://docs.forboc.ai/studio/overview.md): Design, test, and export autonomous npcs
- [Introduction](https://docs.forboc.ai/npm/welcome.md): Store/thunk runtime for autonomous NPC protocol execution
- [Installation](https://docs.forboc.ai/npm/installation.md): Package selection and runtime setup
- [Platform & Account](https://docs.forboc.ai/npm/platform.md): API keys, runtime config, and operational setup
- [User Stories](https://docs.forboc.ai/npm/user-stories.md): Behavior-driven stories aligned to current SDK runtime
- [Integration Workflow](https://docs.forboc.ai/npm/workflow.md): Source-accurate setup for protocol execution
- [CLI Reference](https://docs.forboc.ai/npm/cli.md): Commands implemented by @forbocai/node
- [System Status & Known Issues](https://docs.forboc.ai/npm/status.md): Current state of the ForbocAI Protocol
- [Concepts](https://docs.forboc.ai/npm/concepts.md): Runtime architecture and contract boundaries
- [Story Engine](https://docs.forboc.ai/npm/story-engine.md): Composing multi-NPC narrative systems with thunk orchestration
- [Cortex (Inference)](https://docs.forboc.ai/npm/cortex.md): Local Node/Web inference and remote completion thunk
- [NPC (Entity)](https://docs.forboc.ai/npm/npc.md): Managing NPC state and protocol execution with store + thunks
- [Memory (RAG)](https://docs.forboc.ai/npm/memory.md): Remote memory operations and protocol-driven local memory requirements
- [Bridge (Validation)](https://docs.forboc.ai/npm/bridge.md): API-backed action validation and preset loading
- [Soul Module](https://docs.forboc.ai/npm/soul.md): Export, import, and list portable NPC souls via API-backed thunks
- [Presets (Game Logic)](https://docs.forboc.ai/npm/presets.md): API-driven rule presets and bridge rule loading
- [Ghost (QA Testing)](https://docs.forboc.ai/npm/ghost.md): API-orchestrated automated test session control
- [Test Game](https://docs.forboc.ai/npm/test-game.md): Echoes of the Spire CLI coverage harness
- [Support](https://docs.forboc.ai/npm/support.md): Get help from the ForbocAI team and community
- [Changelog](https://docs.forboc.ai/npm-sdk/changelog/changelog/llms.txt)
- [Unreal Engine SDK](https://docs.forboc.ai/ue/welcome.md): Store/thunk runtime for Unreal Engine 5.7
- [Installation](https://docs.forboc.ai/ue/installation.md): Install the plugin, build it in your project, and configure the runtime
- [Runtime Architecture](https://docs.forboc.ai/ue/architecture.md): Store, slices, middleware, and thunks in the current UE SDK
- [Functional Core (C++)](https://docs.forboc.ai/ue/functional-core.md): Support types used by the current store/thunk runtime
- [NPC State And Protocol](https://docs.forboc.ai/ue/npc.md): Register NPCs, inspect slice state, and run the multi-turn protocol
- [Memory (RAG)](https://docs.forboc.ai/ue/memory.md): Remote NPC memory and local node-backed recall
- [Bridge (Validation)](https://docs.forboc.ai/ue/bridge.md): API-backed action validation, presets, and rulesets
- [Soul Module](https://docs.forboc.ai/ue/soul.md): Local and remote Soul export, import, listing, and verification
- [Cortex (Inference)](https://docs.forboc.ai/ue/cortex.md): Local llama.cpp and remote cortex helpers in the UE runtime
- [Ghost (QA Testing)](https://docs.forboc.ai/ue/ghost.md): API-backed Ghost session execution, polling, and history
- [CLI Reference](https://docs.forboc.ai/ue/cli.md): Current UE commandlet surface and the broader synchronous SDKOps layer
- [Blueprint Guide](https://docs.forboc.ai/ue/blueprint.md): Blueprint wrappers for the current UE SDK surface
- [Demo Project](https://docs.forboc.ai/ue/demo.md): Current status of the UE demo project and how to use it safely
- [Unity SDK](https://docs.forboc.ai/unity/welcome.md): Coming Soon
- [Godot SDK](https://docs.forboc.ai/godot/welcome.md): Coming Soon
- [API Reference](https://docs.forboc.ai/api-reference.md): Complete endpoint documentation for the ForbocAI SDK API

## API Docs

- ForbocAI SDK API > Status [Health check](https://docs.forboc.ai/api-reference/endpoints/forboc-ai-sdk-api/status/get-status.md)
- ForbocAI SDK API > Cortex [List available models](https://docs.forboc.ai/api-reference/endpoints/forboc-ai-sdk-api/cortex/list-models.md)
- ForbocAI SDK API > Cortex [Initialize Cortex instance](https://docs.forboc.ai/api-reference/endpoints/forboc-ai-sdk-api/cortex/init-cortex.md)
- ForbocAI SDK API > Cortex [Generate completion (deprecated)](https://docs.forboc.ai/api-reference/endpoints/forboc-ai-sdk-api/cortex/generate-completion.md)
- ForbocAI SDK API > NP Cs [Atomic protocol step](https://docs.forboc.ai/api-reference/endpoints/forboc-ai-sdk-api/np-cs/process-npc-step.md)
- ForbocAI SDK API > NP Cs [Get directive (Step 2)](https://docs.forboc.ai/api-reference/endpoints/forboc-ai-sdk-api/np-cs/get-npc-directive.md)
- ForbocAI SDK API > NP Cs [Get context / SLM prompt (Step 4)](https://docs.forboc.ai/api-reference/endpoints/forboc-ai-sdk-api/np-cs/get-npc-context.md)
- ForbocAI SDK API > NP Cs [Get verdict (Step 7)](https://docs.forboc.ai/api-reference/endpoints/forboc-ai-sdk-api/np-cs/get-npc-verdict.md)
- ForbocAI SDK API > Memory [List memories](https://docs.forboc.ai/api-reference/endpoints/forboc-ai-sdk-api/memory/list-memories.md)
- ForbocAI SDK API > Memory [Confirm memory storage](https://docs.forboc.ai/api-reference/endpoints/forboc-ai-sdk-api/memory/store-memory.md)
- ForbocAI SDK API > Memory [Report recall results](https://docs.forboc.ai/api-reference/endpoints/forboc-ai-sdk-api/memory/recall-memories.md)
- ForbocAI SDK API > Memory [Clear memories](https://docs.forboc.ai/api-reference/endpoints/forboc-ai-sdk-api/memory/clear-memories.md)
- ForbocAI SDK API > Bridge [Validate action](https://docs.forboc.ai/api-reference/endpoints/forboc-ai-sdk-api/bridge/validate-action.md)
- ForbocAI SDK API > Bridge [Validate action for NPC](https://docs.forboc.ai/api-reference/endpoints/forboc-ai-sdk-api/bridge/validate-action-for-npc.md)
- ForbocAI SDK API > Bridge [List bridge rules](https://docs.forboc.ai/api-reference/endpoints/forboc-ai-sdk-api/bridge/list-bridge-rules.md)
- ForbocAI SDK API > Rules [List rulesets](https://docs.forboc.ai/api-reference/endpoints/forboc-ai-sdk-api/rules/list-rulesets.md)
- ForbocAI SDK API > Rules [Register ruleset](https://docs.forboc.ai/api-reference/endpoints/forboc-ai-sdk-api/rules/register-ruleset.md)
- ForbocAI SDK API > Rules [Delete ruleset](https://docs.forboc.ai/api-reference/endpoints/forboc-ai-sdk-api/rules/delete-ruleset.md)
- ForbocAI SDK API > Rules [List bridge presets](https://docs.forboc.ai/api-reference/endpoints/forboc-ai-sdk-api/rules/list-bridge-presets.md)
- ForbocAI SDK API > Rules [Create ruleset from preset](https://docs.forboc.ai/api-reference/endpoints/forboc-ai-sdk-api/rules/create-ruleset-from-preset.md)
- ForbocAI SDK API > Soul [Export Soul (Phase 1)](https://docs.forboc.ai/api-reference/endpoints/forboc-ai-sdk-api/soul/export-soul.md)
- ForbocAI SDK API > Soul [Confirm Soul Export (Phase 2)](https://docs.forboc.ai/api-reference/endpoints/forboc-ai-sdk-api/soul/confirm-soul-export.md)
- ForbocAI SDK API > Soul [Import Soul (Phase 1)](https://docs.forboc.ai/api-reference/endpoints/forboc-ai-sdk-api/soul/import-soul.md)
- ForbocAI SDK API > Soul [Confirm Soul Import (Phase 2)](https://docs.forboc.ai/api-reference/endpoints/forboc-ai-sdk-api/soul/confirm-soul-import.md)
- ForbocAI SDK API > Soul [Verify Soul](https://docs.forboc.ai/api-reference/endpoints/forboc-ai-sdk-api/soul/verify-soul-by-tx-id.md)
- ForbocAI SDK API > Soul [Get Soul by TXID](https://docs.forboc.ai/api-reference/endpoints/forboc-ai-sdk-api/soul/get-soul-by-tx-id.md)
- ForbocAI SDK API > Soul [List Souls](https://docs.forboc.ai/api-reference/endpoints/forboc-ai-sdk-api/soul/list-souls.md)
- ForbocAI SDK API > Ghost [Run Ghost Session](https://docs.forboc.ai/api-reference/endpoints/forboc-ai-sdk-api/ghost/run-ghost-agent.md)
- ForbocAI SDK API > Ghost [Get session status](https://docs.forboc.ai/api-reference/endpoints/forboc-ai-sdk-api/ghost/get-ghost-status.md)
- ForbocAI SDK API > Ghost [Get session results](https://docs.forboc.ai/api-reference/endpoints/forboc-ai-sdk-api/ghost/get-ghost-results.md)
- ForbocAI SDK API > Ghost [Stop Ghost session](https://docs.forboc.ai/api-reference/endpoints/forboc-ai-sdk-api/ghost/stop-ghost-session.md)
- ForbocAI SDK API > Ghost [Get Ghost history](https://docs.forboc.ai/api-reference/endpoints/forboc-ai-sdk-api/ghost/get-ghost-history.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://docs.forboc.ai/openapi.json)
- [OpenAPI YAML](https://docs.forboc.ai/openapi.yaml)