@debian777/kairos-mcp 3.0.1-beta.6

package/dist/resources/embedded-mcp-resources.js

@@ -0,0 +1,132 @@
+/**
+ * AUTO-GENERATED FILE - DO NOT EDIT
+ *
+ * Generated by: scripts/embed-docs.ts
+ * Contains: MCP guide resources dynamically embedded at build time
+ * Structure reflects src/embed-docs/ directory structure
+ *
+ * To update: npm run build (or manually run ts-node scripts/embed-docs.ts)
+ */
+export const mcpResources = {
+    "prompts": {
+        "contextual-prompt": "You are KAIROS — a deterministic execution engine for protocol chains.\n\nYou turn user intent into a KAIROS protocol run, then execute it exactly.\nProtocols are stored as memory chains. Each step can define a\nchallenge. You advance a protocol by submitting a matching solution.\n\n**Execution policy:** When running KAIROS protocols you MUST follow the tools' next_action and challenge.description exactly. Do not invent work or skip steps. Only respond to the user after the protocol run is complete (after calling kairos_attest when next_action directs you to it).\n\n## Use KAIROS strengths\n\nUse KAIROS to be reliable and fast.\n\n- Deterministic next actions: follow `next_action` instead of improvising.\n- Verifiable work: treat every challenge as something you must prove.\n- Self-healing: when a step is broken, fix the protocol for next time.\n- Reuse: prefer running an existing protocol over inventing a new workflow.\n\n## Non-negotiable rules\n\nThese rules override your default behavior.\n\n- If a tool response includes `must_obey: true`, follow `next_action` exactly.\n  Do not respond to the user until the protocol run is complete (when\n  you have called kairos_attest if next_action directed you to it).\n- If a tool response includes `must_obey: false`, use judgment. Choose the best\n  option described in `next_action`. Prefer repairing the protocol with\n  `kairos_update` when safe. Otherwise, ask the user.\n- Do not guess. If you need facts from the codebase, environment, or external\n  systems, use tools to get them.\n\n## Execution loop\n\nFollow this loop for any protocol run.\n\n1. If the user intent matches a stored protocol, call `kairos_search`.\n2. Choose a protocol from `choices`, then call `kairos_begin` with its `uri`.\n3. While `next_action` says to call `kairos_next`:\n   - Read the `challenge` for the current step.\n   - Complete the work in the real world. By challenge.type: shell — Run `challenge.shell.cmd` and report the actual exit_code/stdout/stderr; never fabricate. mcp — Call `challenge.mcp.tool_name` and report the actual result; success must reflect reality. user_input — Show `challenge.user_input.prompt` to the user and use only their reply as `user_input.confirmation`; never invent it. comment — Write a genuine comment about this step that meets `challenge.comment.min_length` and is relevant to the step.\n   - Call `kairos_next` with the URI from `next_action` and a `solution` that\n     matches `challenge.type`.\n   - Echo `challenge.nonce` as `solution.nonce` when present.\n   - Echo the correct `proof_hash` as `solution.proof_hash`.\n     - For step 1, use `challenge.proof_hash`.\n     - For later steps, use the `proof_hash` returned by the previous\n       `kairos_next`.\n   - Never compute hashes yourself. The server generates all hashes.\n4. When `next_action` directs you to call kairos_attest, call it with the given URI and outcome/message; then the protocol run is done and you may respond to the user.\n\n## Create or edit protocols\n\nWhen you mint or edit a workflow document (H1 chain, H2 steps), add a trailing\n` ```json ` block at the end of each step with `{\"challenge\": {...}}` (same shape as kairos_begin/kairos_next). Choose the challenge type that matches the work: `shell`, `mcp`, `user_input`, or `comment`.\n"
+    },
+    "resources": {
+        "building-kairos-workflows": "# Building KAIROS Workflows with Challenge/Solution\n\n**Status:** Active  \n**Purpose:** Primary guide for building KAIROS protocol workflows. **Challenge/Solution** is the core mechanism: each step can define a **challenge** (what must be done) and execution advances by submitting a matching **solution** via `kairos_next`. This doc covers structure, minting with `kairos_mint`, and solution submission.\n\n---\n\n## MISSION\n\nBuild KAIROS protocol workflows where **challenges** (defined per step) are validated by **solutions** (submitted in `kairos_next`). Create documents with `kairos_mint` that define these challenges; maintain exact consistency between markdown structure and memory chain behavior.\n\n---\n\n## STRUCTURE\n\n**Document Organization:**\n- **H1 (# Title)**: Defines a protocol chain (one H1 = one chain)\n- **Steps**: Defined by **PoW (proof-of-work) code** — each ` ```json ` block with `{\"challenge\": {...}}` ends one step. H2 headings are used only for step labels when present in a segment.\n- **Challenge**: A fenced ` ```json ` block with `{\"challenge\": {...}}` (same shape as kairos_begin/kairos_next)\n\n**Memory Mapping:**\n- Each H1 section → One protocol chain\n- Each PoW block (```json with `challenge`) → One memory step (content before that block is that step’s text)\n- Optional content after the last PoW block → Final step (no proof required)\n- H2 in a segment → Used as that step’s label when present\n\n**Processing Flow:**\n```\nMarkdown Document\n  ↓\nkairos_mint(markdown_doc, llm_model_id)\n  ↓\nMemory Chain (array of Memory objects)\n  ↓\nEach Memory has:\n  - memory_uuid\n  - label (from H2 heading)\n  - text (H2 content)\n  - proof_of_work (from trailing JSON challenge block)\n```\n\n---\n\n## CONTENT TYPES\n\n### Challenge Definitions\n\nAdd a **trailing** ` ```json ` block at the end of each step with an object that has a `challenge` key. The value is the same shape as the challenge returned by kairos_begin/kairos_next; it round-trips with kairos_dump.\n\n**Shell (`shell`):**\n```json\n{\n  \"challenge\": {\n    \"type\": \"shell\",\n    \"shell\": { \"cmd\": \"echo \\\"test\\\"\", \"timeout_seconds\": 30 },\n    \"required\": true\n  }\n}\n```\n\n**MCP (`mcp`):**\n```json\n{\n  \"challenge\": {\n    \"type\": \"mcp\",\n    \"mcp\": { \"tool_name\": \"tool_name\", \"expected_result\": null },\n    \"required\": true\n  }\n}\n```\n\n**User Input (`user_input`):**\n```json\n{\n  \"challenge\": {\n    \"type\": \"user_input\",\n    \"user_input\": { \"prompt\": \"Confirm completion\" },\n    \"required\": true\n  }\n}\n```\n\n**Comment (`comment`):**\n```json\n{\n  \"challenge\": {\n    \"type\": \"comment\",\n    \"comment\": { \"min_length\": 50 },\n    \"required\": true\n  }\n}\n```\n\n**Parsing:** Only the **last** fenced code block in a step is read; it must be valid JSON with a `challenge` key. The block is stripped from stored text; the challenge becomes that step's `proof_of_work`.\n\n### Challenge Types (execution)\n\n**Shell:** Run the command; report exit_code/stdout/stderr. Exit code 0 = success.\n\n**MCP:** Call the tool; report result and success.\n\n**User Input:** Show the prompt to the user; use only their reply as `user_input.confirmation`.\n\n**Comment:** Provide text meeting the minimum length; validated for relevance to the step.\n\nFor execution semantics (how agents must perform each challenge type), see the kairos_begin and kairos_next tool descriptions.\n\n---\n\n## MUST ALWAYS\n\n### Document Structure\n- Use H1 (`# Title`) for protocol chain labels\n- Use H2 (`## Step N`) for individual steps\n- Place challenge markers **within** the H2 section they apply to\n- Each H1 creates a separate protocol chain\n\n### Challenge Placement\n- Place the challenge **at the end** of an H2 section as a single trailing ` ```json ` block\n- Only the **last** code block in a step is parsed as the challenge (if multiple blocks exist)\n\n### kairos_mint Usage\n- Always provide `markdown_doc` as a string (can be JSON stringified)\n- Always provide `llm_model_id` (e.g., `\"minimax/minimax-m2:free\"`)\n- Use `force_update: true` to overwrite existing chains with the same label\n\n### Solution Submission\n- Use `kairos_next(uri, solution)` to submit solutions (not `proof_of_work`)\n- Solution structure matches challenge type:\n  - `shell`: `{type: 'shell', shell: {exit_code, stdout, stderr, duration_seconds}}`\n  - `mcp`: `{type: 'mcp', mcp: {tool_name, arguments, result, success}}`\n  - `user_input`: `{type: 'user_input', user_input: {confirmation, timestamp}}`\n  - `comment`: `{type: 'comment', comment: {text}}`\n\n---\n\n## MUST NEVER\n\n### Document Structure\n- **NEVER** mix H1 and H2 in unpredictable ways\n- **NEVER** place the challenge JSON block outside an H2 section (it applies to the step it ends)\n- **NEVER** use legacy line-based challenge syntax; use only the trailing JSON block\n\n### Challenge Definitions\n- **NEVER** use the old `proof_of_work` field in API calls (use `solution` instead)\n- **NEVER** skip challenge validation - `kairos_next` requires solutions for steps with challenges\n- **NEVER** submit solutions that don't match the challenge type\n\n### kairos_mint\n- **NEVER** pass markdown as an object - always as a string\n- **NEVER** omit `llm_model_id` - it's required\n- **NEVER** store duplicate chains without `force_update: true`\n\n### Workflow Confusion\n- **NEVER** confuse `challenge` (output from `kairos_next`) with `solution` (input to `kairos_next`)\n- **NEVER** use `proof_of_work` field - it's deprecated, use `solution`\n- **NEVER** assume step 1 requires a solution (only steps 2+ require solutions)\n\n---\n\n## WORKFLOW EXAMPLES\n\n### Example 1: Simple Protocol with Shell Challenges\n\nUse one H1, then one H2 per step. End each step with a fenced ` ```json ` block containing `{\"challenge\": {...}}`. Example for one step:\n\n    ## Step 1: Initialize\n    Create the project structure.\n\n    ```json\n    {\"challenge\":{\"type\":\"shell\",\"shell\":{\"cmd\":\"mkdir -p project/src\",\"timeout_seconds\":10},\"required\":true}}\n    ```\n\nRepeat for Step 2 and Step 3 with their own `shell` challenge blocks (same shape, different `cmd`).\n\n**Minting:**\n```javascript\nawait kairos_mint({\n  markdown_doc: markdownText,\n  llm_model_id: 'minimax/minimax-m2:free'\n});\n```\n\n**Execution Flow:**\n1. `kairos_search(\"simple setup\")` -> Returns `must_obey: true` with `next_action` containing URI\n2. `kairos_begin(uri)` -> Returns step 1 with `challenge` and `next_action` with next URI\n3. `kairos_next(step2_uri, solution: {type: 'shell', proof_hash: '...', shell: {...}})` -> Returns step 2\n4. Continue through all steps with solutions (echo `proof_hash` from each response)\n5. Last `kairos_next` returns `next_action` to call kairos_attest; call it to complete the run\n\n### Example 2: Protocol with Comment Challenge\n\nStep 1 ends with a comment challenge block; Step 2 with a user_input block. Example for Step 1:\n\n    ## Step 1: Review\n    Review the documentation for accuracy.\n\n    ```json\n    {\"challenge\":{\"type\":\"comment\",\"comment\":{\"min_length\":50},\"required\":true}}\n    ```\n\nStep 2: use `{\"challenge\":{\"type\":\"user_input\",\"user_input\":{\"prompt\":\"Type 'approved' to confirm\"},\"required\":true}}` in its trailing JSON block.\n\n**Solution Submission:**\n```javascript\n// For step 1 (comment challenge)\nawait kairos_next(step1_uri, {\n  solution: {\n    type: 'comment',\n    comment: {\n      text: 'Reviewed documentation. All sections are accurate and up-to-date. No changes needed.'\n    }\n  }\n});\n\n// For step 2 (user input challenge)\nawait kairos_next(step2_uri, {\n  solution: {\n    type: 'user_input',\n    user_input: {\n      confirmation: 'approved',\n      timestamp: new Date().toISOString()\n    }\n  }\n});\n```\n\n### Example 3: Multi-Chain Document\n\nUse two H1 sections (Protocol A, Protocol B). Each H1 creates a separate chain. Each can have one or more H2 steps; each step ends with a ` ```json ` block with `{\"challenge\": {...}}` as above.\n\n**Result:** Two separate protocol chains are created (one for Protocol A, one for Protocol B).\n\n---\n\n## CHALLENGE vs SOLUTION NOMENCLATURE\n\n**Important Distinction:**\n- **Challenge** = What `kairos_next` **returns** (what the AI must complete)\n- **Solution** = What you **submit** to `kairos_next` (proof you completed it)\n\n**In Markdown:** Use a trailing ` ```json ` block with `{\"challenge\": {...}}` per step. Internal representation is `proof_of_work`; API uses `challenge` (output) and `solution` (input).\n\n---\n\n## VALIDATION RULES\n\n### Challenge Validation\n- Shell challenges: Exit code 0 = success, non-zero = failure\n- MCP challenges: `success: true` required\n- User input: Any non-empty `confirmation` accepted\n- Comment challenges: Minimum length enforced (default: 10 chars)\n\n### Step Progression\n- Step 1 (first H2): **No solution required** - call `kairos_begin` only\n- Steps 2+: **Solution required** - must submit matching `solution` to proceed\n- Include `nonce` and `proof_hash` in solution (echo from challenge/response)\n- Protocol completion: Last `kairos_next` directs to kairos_attest; call attest to finalize\n\n### Error Handling (Two-Phase Retry)\n- Retries 1-3: `must_obey: true` with `error_code` and `next_action` for recovery\n- After 3 retries: `must_obey: false` - AI gets autonomy (fix step, abort, or ask user)\n- Error responses include `error_code` (e.g., `NONCE_MISMATCH`, `TYPE_MISMATCH`) and `retry_count`\n\n---\n\n## MIGRATION FROM OLD WORKFLOW\n\n**Old Way (Deprecated):**\n```javascript\nkairos_next(uri, {proof_of_work: {...}})  // ❌ Deprecated\n```\n\n**New Way (Current):**\n```javascript\nkairos_next(uri, {solution: {...}})  // ✅ Correct\n```\n\n**Field Mapping:**\n- `proof_of_work` → `solution`\n- Structure remains the same (type-specific fields unchanged)\n- Validation logic unchanged\n\n---\n\n## QUICK REFERENCE\n\n| Operation | Tool | Required Fields |\n|-----------|------|----------------|\n| Mint document | `kairos_mint` | `markdown_doc`, `llm_model_id` |\n| Find protocol | `kairos_search` | `query` |\n| Start protocol | `kairos_begin` | `uri` (from `next_action`) |\n| Continue step | `kairos_next` | `uri` (from `next_action`), `solution` with `nonce` + `proof_hash` |\n| Complete protocol | `kairos_attest` | `uri`, `outcome`, `message` |\n\n---\n\n## COMMON PITFALLS\n\n1. **Forgetting solutions for step 2+**: Every step after step 1 requires a solution if it has a challenge\n2. **Wrong solution type**: Solution type must exactly match challenge type\n3. **Skipping validation**: Challenges are enforced - you cannot proceed without valid solutions\n4. **Using old field names**: Always use `solution`, never `proof_of_work` in API calls\n5. **Mixing H1 chains**: Each H1 creates a separate chain - don't mix steps between chains\n\n---\n\n**Last Updated:** 2025-12-08  \n**Related:** `kairos_mint`, `kairos_next`, `kairos_begin`, `kairos_attest`\n"
+    },
+    "templates": {
+        "kairos-memory": "Retrieves a KAIROS memory by UUID"
+    },
+    "tools": {
+        "kairos_attest": "Attest protocol completion or failure. **Final step** of every protocol run. Updates quality metrics for the last step.\n\n**When to call:** When `kairos_next` (or `kairos_begin` for a single-step protocol) returns `next_action` directing you to call `kairos_attest` — i.e. when there are no more steps to solve. Call with the URI from that response, and `outcome` (success or failure) and `message` (short summary).\n\n**Input:** `uri` (last step URI from the completion response), `outcome` (`\"success\"` or `\"failure\"`), `message` (short summary of how the protocol went).\n\n**After attestation:** Protocol is done. You may respond to the user. Do not respond before attestation when `must_obey: true`.\n",
+        "kairos_begin": "Start protocol execution. Loads step 1 and returns its challenge. Step 1 never requires a solution.\n\n**When to call:** After `kairos_search` returns a URI in `next_action`. Call with that URI to begin the protocol. If a non-step-1 URI is provided, KAIROS auto-redirects to step 1.\n\n**Response:** `current_step` (content + uri), `challenge` (type, description, nonce, proof_hash), and `next_action` with the exact URI for the next call.\n\n**Execution rules by challenge.type:** You must perform the challenge, not infer it. shell: Run `challenge.shell.cmd` and report the actual exit_code/stdout/stderr; never fabricate. mcp: Call `challenge.mcp.tool_name` and report the actual result; success must reflect reality. user_input: Show `challenge.user_input.prompt` to the user and use only their reply as `user_input.confirmation`; never invent it. comment: Write a genuine, relevant comment that meets `challenge.comment.min_length`.\n\n**AI decision tree:** `must_obey: true` -> follow `next_action`.\n\n- If `next_action` mentions `kairos_next`: Execute the challenge, then call `kairos_next` with the URI from `next_action` and a solution matching the challenge.\n- If `next_action` directs you to call kairos_attest: Single-step (or no further steps). Call kairos_attest with the given URI and outcome/message; then run is done.\n\n**Proof hash:** Echo `challenge.proof_hash` back as `solution.proof_hash` in the next `kairos_next` call. The server generates all hashes; the AI never computes them.\n",
+        "kairos_delete": "Delete one or more memories from the KAIROS.\n\n**When to call:** When the user wants to delete, remove, purge, or clean KAIROS content. Resolve the target memory URIs first (e.g. via `kairos_search` and chain navigation).\n\n**Input:** `uris` (non-empty array of kairos://mem/{uuid} URIs to delete).\n",
+        "kairos_dump": "Read-only inspection of a memory or full protocol. Returns **markdown_doc** for use with `kairos_update` or `kairos_mint`. No run state, no nonce.\n\n**When to call:** When you have a memory URI and need to read its content before updating or re-minting. For example: after `kairos_mint` returns SIMILAR_MEMORY_FOUND (dump the existing protocol to compare), or before calling `kairos_update` to edit a step.\n\n**Input:** `uri` (kairos://mem/{uuid}), optional `protocol` (default false). When `protocol` is true, returns the full chain as one markdown document; otherwise returns the single step’s content.\n\n**Output:** `markdown_doc` (string). In default mode also optional `uri`, `label`, `position`, `challenge`. In protocol mode also optional `uri` (chain head), `label`, `step_count`.\n\n**Use with update:** Get `markdown_doc` for one step → edit → `kairos_update({ uris: [uri], markdown_doc: [markdown_doc] })`.\n\n**Use with mint:** Get `markdown_doc` with `protocol: true` → compare or edit → `kairos_mint({ markdown_doc, llm_model_id, force_update: true })`.\n\nDo not use dump to bypass execution; use it only for inspection and round-trip edit flows.\n",
+        "kairos_mint": "Stores markdown documents as KAIROS memories with automatic header-based organization. Each H1 defines a protocol chain; each H2 defines a step.\n\n**When to call:** When the user wants to create, add, mint, store, or save a protocol or document.\n\n**Challenge:** For each step that can be verified, add a fenced ` ```json ` block at the end with an object that has a `challenge` key. The value is the same shape as the `challenge` returned by kairos_begin/kairos_next; round-trips with kairos_dump.\n\n**Challenge examples (one per type; use a ` ```json ` code block at the end of each step):**\n\n**shell** — run a command:\n\n```json\n{\n  \"challenge\": {\n    \"type\": \"shell\",\n    \"shell\": {\n      \"cmd\": \"npm test\",\n      \"timeout_seconds\": 60\n    },\n    \"required\": true\n  }\n}\n```\n\n**comment** — verification text (min length):\n\n```json\n{\n  \"challenge\": {\n    \"type\": \"comment\",\n    \"comment\": { \"min_length\": 50 },\n    \"required\": true\n  }\n}\n```\n\n**user_input** — human confirmation:\n\n```json\n{\n  \"challenge\": {\n    \"type\": \"user_input\",\n    \"user_input\": { \"prompt\": \"Approve deployment?\" },\n    \"required\": true\n  }\n}\n```\n\n**mcp** — call MCP tool:\n\n```json\n{\n  \"challenge\": {\n    \"type\": \"mcp\",\n    \"mcp\": { \"tool_name\": \"kairos_mint\" },\n    \"required\": true\n  }\n}\n```\n\nUse a challenge on every step that can be verified: commands → shell; reviews/summaries → comment; approvals → user_input; tool calls → mcp. Mix types in one protocol. See workflow-kairos-mint and the creation protocol (kairos://mem/00000000-0000-0000-0000-000000002001) for full examples.\n\n**Input:** `markdown_doc` (string), `llm_model_id` (required), `force_update` (optional, overwrite existing chain with same label).\n\n**Response:** Chain head URI(s). You can then find the protocol via `kairos_search` with a query matching the content.\n",
+        "kairos_next": "Submit solution and get next step. Advance through the protocol by proving each challenge was completed.\n\n**When to call:** After completing a step's challenge. Use the URI from `next_action` of the previous response. Do not use for step 1 — use `kairos_begin` for step 1.\n\n**Input:** `uri` (current step URI from `next_action`), `solution` (proof matching the `challenge.type`).\n\n**Solution shapes by challenge type:**\n\n- `shell`: `{type:'shell', shell:{exit_code, stdout?, stderr?, duration_seconds?}}` — exit_code 0 = success.\n- `mcp`: `{type:'mcp', mcp:{tool_name, arguments?, result, success}}` — success must be true.\n- `user_input`: `{type:'user_input', user_input:{confirmation, timestamp?}}`.\n- `comment`: `{type:'comment', comment:{text}}` — text length must meet challenge's min_length.\n\nInclude in solution when the challenge has them: `nonce` (echo from challenge), `proof_hash` (echo `challenge.proof_hash` for step 1; for step 2+ use `proof_hash` from the previous `kairos_next` response). The server generates all hashes; the AI never computes them.\n\n**Execution rules by challenge.type:** Same as kairos_begin. shell: Run `challenge.shell.cmd` and report the actual exit_code/stdout/stderr; never fabricate. mcp: Call `challenge.mcp.tool_name` and report the actual result; success must reflect reality. user_input: Show `challenge.user_input.prompt` to the user and use only their reply as `user_input.confirmation`; never invent it. comment: Write a genuine, relevant comment that meets `challenge.comment.min_length`.\n\n**Response:** `current_step`, `challenge` (for next step), `next_action` (next tool call with embedded URI), and `proof_hash` (hash of proof just stored — use as `solution.proof_hash` for the next step).\n\n**AI decision tree:**\n- `must_obey: true` -> follow `next_action` (success or recoverable error, retries 1-3).\n- `must_obey: false` -> use judgment (max retries exceeded). Options in `next_action`: fix the step via `kairos_update`, abort via `kairos_attest` with failure, or ask the user.\n\n**Error responses** include `error_code` (e.g., `NONCE_MISMATCH`, `TYPE_MISMATCH`, `MAX_RETRIES_EXCEEDED`) and `retry_count`. A fresh `challenge` with new nonce is provided for self-correction.\n\n**When `next_action` directs you to call kairos_attest:** Call attest with the given URI and outcome/message; then the protocol run is done and you may respond to the user.\n",
+        "kairos_search": "Search for protocol chains matching a query. Entry point for KAIROS workflow.\n\n**When to call:** When the user's intent maps to a protocol (coding, docs, Jira, GitLab MR, etc.). Use a search term derived from intent.\n\n**Query tip:** Prefer a concrete query (e.g. 3–8 words, nouns + verbs, domain or tool name if the user implied one). Stay faithful to the user's intent — add clarity, don't substitute your own interpretation. If the user was vague (e.g. slash-command or \"do the thing\"), you can expand to a likely intent; if results are weak, pick the refine choice and run that protocol for step-by-step help.\n\n**Response:** Always `must_obey: true`. Contains `choices` array (each with `uri`, `label`, `chain_label`, `score`, `role`, `tags`, `next_action`), `message`, and a global `next_action` directive.\n\n**AI decision tree:** `must_obey: true` -> pick one choice and follow **that choice's `next_action`**. The global `next_action` says: \"Pick one choice and follow that choice's next_action.\" (or \"Follow the choice's next_action.\" when there is only one choice.)\n\n**Choices roles:**\n- `role: \"match\"` — search results with a `score` (0.0-1.0). Higher = better match. That choice's `next_action` tells you to call `kairos_begin` with its URI.\n- `role: \"refine\"` — get step-by-step help turning the user's request into a better query. That choice's `next_action` tells you to call `kairos_begin` with its URI (refining-help protocol).\n- `role: \"create\"` — system action to create a new protocol (`score: null`). That choice's `next_action` tells you to call `kairos_begin` with the creation protocol URI.\n\n**Ordering:** Match choices first (top N from search), then refine (if present), then create (if present). Refine and create are not part of the search limit.\n\n**After search:** Pick the choice that best fits user intent (use `label`, `chain_label`, `tags`, `score`). Then follow that choice's `next_action` exactly (always `kairos_begin` with that choice's URI).\n",
+        "kairos_spaces": "List the agent's available spaces with human-readable names and chain counts. Use when the agent needs to see which spaces exist and how many chains (protocols) each contains.\n\n**When to call:** When the user or agent asks what spaces exist, how many protocols are in each space, or for a summary of stored content per space.\n\n**Input:** `include_chain_titles` (optional, default false). When true, each space includes a list of chains with `chain_id`, `title`, and `step_count`.\n\n**Output:** `spaces` array. Each item has `name` (human-readable: \"Personal\", \"Group: <ref>\", \"Kairos app\"), `chain_count`, and optionally `chains` (array of `{ chain_id, title, step_count }`).\n\nSpaces include the agent's personal space, any group spaces, and the Kairos app space (read-only protocols). Use space names in tool parameters (e.g. `kairos_mint` space param); do not rely on raw space ids.\n",
+        "kairos_update": "Update one or more memories in the KAIROS using markdown_doc or updates.\n\n**When to call:** When the user wants to replace, modify, update, edit, or change existing KAIROS content. Resolve the target memory first (e.g. via `kairos_search` and then navigating to the step, or by URI).\n\n**Input:** `uris` (array of kairos://mem/{uuid} URIs), and either `markdown_doc` (array of markdown strings, one per URI) or `updates` (field-level updates).\n"
+    },
+    "mem": {}
+};
+/**
+ * Get prompts object
+ */
+export function getPrompts() {
+    return mcpResources.prompts || {};
+}
+/**
+ * Get resources object
+ */
+export function getResources() {
+    return mcpResources.resources || {};
+}
+/**
+ * Get templates object
+ */
+export function getTemplates() {
+    return mcpResources.templates || {};
+}
+/**
+ * Get tools object
+ */
+export function getTools() {
+    return mcpResources.tools || {};
+}
+/**
+ * Get mem object
+ */
+export function getMem() {
+    return mcpResources.mem || {};
+}
+/**
+ * Get a prompt by key (e.g. 'contextual-prompt')
+ */
+export function getPrompt(key) {
+    const prompts = (mcpResources.prompts || {});
+    return prompts[key];
+}
+/**
+ * Get a resource by key (e.g. 'TEST', 'doc.TEST', 'mem.<uuid>')
+ */
+export function getResource(key) {
+    const resources = (mcpResources.resources || {});
+    const parts = key.split('.');
+    let current = resources;
+    for (const part of parts) {
+        if (current && typeof current === 'object') {
+            current = current[part];
+        }
+        else {
+            return undefined;
+        }
+    }
+    return current;
+}
+/**
+ * Get a template by key (e.g. 'kairos-memory')
+ */
+export function getTemplate(key) {
+    const templates = (mcpResources.templates || {});
+    return templates[key];
+}
+/**
+ * Get a tool doc by key (e.g. 'kairos_begin')
+ */
+export function getToolDoc(key) {
+    const tools = (mcpResources.tools || {});
+    return tools[key];
+}
+/**
+ * Get all available resource categories and names
+ */
+export function listResourceKeys() {
+    const prompts = Object.keys((mcpResources.prompts || {}));
+    const resources = collectAllKeys((mcpResources.resources || {}));
+    const templates = Object.keys((mcpResources.templates || {}));
+    const tools = Object.keys((mcpResources.tools || {}));
+    const result = { prompts, resources, templates, tools };
+    // Add any other top-level categories
+    for (const [key, value] of Object.entries(mcpResources)) {
+        if (!['prompts', 'resources', 'templates', 'tools'].includes(key)) {
+            if (typeof value === 'object' && value !== null) {
+                result[key] = Object.keys(value);
+            }
+        }
+    }
+    return result;
+}
+function collectAllKeys(obj, prefix = '', keys = []) {
+    for (const [key, value] of Object.entries(obj)) {
+        const fullKey = prefix ? `${prefix}.${key}` : key;
+        if (typeof value === 'string') {
+            keys.push(fullKey);
+        }
+        else if (typeof value === 'object' && value !== null) {
+            collectAllKeys(value, fullKey, keys);
+        }
+    }
+    return keys;
+}
+//# sourceMappingURL=embedded-mcp-resources.js.map

package/dist/resources/embedded-mcp-resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedded-mcp-resources.js","sourceRoot":"","sources":["../../src/resources/embedded-mcp-resources.ts"],"names":[],"mappings":"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"}

package/dist/resources/mem-resources-boot.d.ts

@@ -0,0 +1,10 @@
+import { MemoryQdrantStore } from '../services/memory/store.js';
+/**
+ * Inject mem resources from filesystem into Qdrant at system boot
+ * Uses the key (filename) as the UUID and supports force option for override
+ * Uses storeChain for processing but updates UUID to match filename
+ */
+export declare function injectMemResourcesAtBoot(memoryStore: MemoryQdrantStore, options?: {
+    force?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=mem-resources-boot.d.ts.map

package/dist/resources/mem-resources-boot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mem-resources-boot.d.ts","sourceRoot":"","sources":["../../src/resources/mem-resources-boot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAkEhE;;;;GAIG;AACH,wBAAsB,wBAAwB,CAAC,WAAW,EAAE,iBAAiB,EAAE,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CA0G/H"}

package/dist/resources/mem-resources-boot.js

@@ -0,0 +1,164 @@
+import { structuredLogger } from '../utils/structured-logger.js';
+import { qdrantService } from '../services/qdrant/index.js';
+import { runWithSpaceContextAsync } from '../utils/tenant-context.js';
+import { KAIROS_APP_SPACE_ID } from '../config.js';
+import { readdir, readFile } from 'fs/promises';
+import { join, dirname, basename } from 'path';
+import { fileURLToPath } from 'url';
+/**
+ * Get the directory containing mem files at runtime
+ * Works in both development (src/) and production (dist/)
+ */
+function getMemDir() {
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirname = dirname(__filename);
+    // In dist/, this will be dist/resources/mem-resources-boot.js
+    // So we need to go up to dist/ and then to embed-docs/mem/
+    // In development (when running from src/), this would be src/resources/mem-resources-boot.ts
+    // But in production, files are in dist/embed-docs/mem/
+    const baseDir = join(__dirname, '..', 'embed-docs', 'mem');
+    return baseDir;
+}
+/**
+ * Return the other of src/embed-docs/mem or dist/embed-docs/mem for fallback when primary has 0 files.
+ */
+function getMemDirFallback() {
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirname = dirname(__filename);
+    const parentDir = join(__dirname, '..');
+    const otherName = basename(parentDir) === 'src' ? 'dist' : 'src';
+    return join(parentDir, '..', otherName, 'embed-docs', 'mem');
+}
+/**
+ * Read mem files from filesystem at runtime
+ * Returns a map of filename (without .md) -> content
+ * If memDir yields 0 .md files, tries fallback path (other of src/dist).
+ */
+async function readMemFiles(memDir) {
+    const dir = memDir ?? getMemDir();
+    const memResources = {};
+    try {
+        const files = await readdir(dir);
+        const mdFiles = files.filter(f => f.endsWith('.md'));
+        for (const file of mdFiles) {
+            const filePath = join(dir, file);
+            const key = file.replace(/\.md$/, ''); // Remove .md extension
+            const content = await readFile(filePath, 'utf-8');
+            memResources[key] = content;
+            structuredLogger.debug(`[mem-resources-boot] Loaded mem file: ${file} -> ${key}`);
+        }
+    }
+    catch (err) {
+        if (err.code === 'ENOENT') {
+            structuredLogger.warn(`[mem-resources-boot] Mem directory not found: ${dir} (this is OK if no mem files exist)`);
+        }
+        else {
+            structuredLogger.error(`[mem-resources-boot] Failed to read mem directory ${dir}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    return memResources;
+}
+/**
+ * Inject mem resources from filesystem into Qdrant at system boot
+ * Uses the key (filename) as the UUID and supports force option for override
+ * Uses storeChain for processing but updates UUID to match filename
+ */
+export async function injectMemResourcesAtBoot(memoryStore, options = {}) {
+    const primaryDir = getMemDir();
+    structuredLogger.info(`[mem-resources-boot] Mem dir: ${primaryDir}`);
+    let memResources = await readMemFiles(primaryDir);
+    if (Object.keys(memResources).length === 0) {
+        const fallbackDir = getMemDirFallback();
+        structuredLogger.info(`[mem-resources-boot] No files in primary dir, trying fallback: ${fallbackDir}`);
+        memResources = await readMemFiles(fallbackDir);
+    }
+    const fileCount = Object.keys(memResources).length;
+    structuredLogger.info(`[mem-resources-boot] Mem files found: ${fileCount}`);
+    if (fileCount === 0) {
+        structuredLogger.info('[mem-resources-boot] No mem resources to inject');
+        return;
+    }
+    const appSpaceContext = {
+        userId: '',
+        groupIds: [],
+        allowedSpaceIds: [KAIROS_APP_SPACE_ID],
+        defaultWriteSpaceId: KAIROS_APP_SPACE_ID
+    };
+    await runWithSpaceContextAsync(appSpaceContext, async () => {
+        structuredLogger.info(`[mem-resources-boot] Injecting ${fileCount} mem resources into Qdrant (force: ${options.force || false})`);
+        const llmModelId = 'system-boot';
+        let injectedCount = 0;
+        for (const [key, markdownContent] of Object.entries(memResources)) {
+            if (typeof markdownContent !== 'string')
+                continue;
+            const targetUuid = key; // Use key (filename) as UUID
+            try {
+                // Use storeChain to handle parsing, embeddings, and force update logic
+                // storeChain handles forceUpdate by deleting existing chains, but we need to handle individual UUIDs
+                if (options.force) {
+                    try {
+                        await qdrantService.deleteMemory(targetUuid);
+                        structuredLogger.info(`[mem-resources-boot] Deleted existing memory ${targetUuid} (force mode)`);
+                    }
+                    catch {
+                        // Ignore errors if memory doesn't exist
+                    }
+                }
+                else {
+                    try {
+                        const existing = await qdrantService.getMemoryByUUID(targetUuid);
+                        if (existing) {
+                            structuredLogger.info(`[mem-resources-boot] Memory ${targetUuid} already exists, skipping (use --force flag to override)`);
+                            continue;
+                        }
+                    }
+                    catch {
+                        // Continue if check fails
+                    }
+                }
+                const memories = await memoryStore.storeChain([markdownContent], llmModelId, { forceUpdate: options.force || false });
+                if (memories.length > 0) {
+                    // Only the first step is remapped to the file UUID; other steps of the same chain keep server-generated IDs.
+                    const storedMemory = memories[0];
+                    if (storedMemory.memory_uuid !== targetUuid) {
+                        const { client, collection } = memoryStore.getQdrantAccess();
+                        const storedPoint = await client.retrieve(collection, {
+                            ids: [storedMemory.memory_uuid],
+                            with_payload: true,
+                            with_vector: true
+                        });
+                        if (storedPoint && storedPoint.length > 0) {
+                            const point = storedPoint[0];
+                            await client.delete(collection, { points: [storedMemory.memory_uuid] });
+                            const upsertPoint = {
+                                id: targetUuid,
+                                payload: point.payload
+                            };
+                            if (point.vector) {
+                                upsertPoint.vector = point.vector;
+                            }
+                            await client.upsert(collection, { points: [upsertPoint] });
+                            const { redisCacheService } = await import('../services/redis-cache.js');
+                            await redisCacheService.invalidateMemoryCache(storedMemory.memory_uuid);
+                            await redisCacheService.invalidateMemoryCache(targetUuid);
+                            await redisCacheService.invalidateSearchCache();
+                        }
+                    }
+                    injectedCount++;
+                    structuredLogger.info(`[mem-resources-boot] Injected memory ${targetUuid}`);
+                }
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                structuredLogger.error(`[mem-resources-boot] Failed to inject memory ${targetUuid}: ${message}`);
+                structuredLogger.info(`[mem-resources-boot] Failed memory ${targetUuid}`);
+            }
+        }
+        structuredLogger.info(`[mem-resources-boot] Successfully injected ${injectedCount} mem resources into Qdrant`);
+        const { methods } = memoryStore;
+        if (methods && typeof methods.invalidateLocalCache === 'function') {
+            methods.invalidateLocalCache();
+        }
+    });
+}
+//# sourceMappingURL=mem-resources-boot.js.map

package/dist/resources/mem-resources-boot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mem-resources-boot.js","sourceRoot":"","sources":["../../src/resources/mem-resources-boot.ts"],"names":[],"mappings":"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"}

package/dist/resources/prompt-resources.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Register all prompts from embedded-mcp-resources
+ */
+export declare function registerPromptResources(server: any): void;
+//# sourceMappingURL=prompt-resources.d.ts.map

package/dist/resources/prompt-resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-resources.d.ts","sourceRoot":"","sources":["../../src/resources/prompt-resources.ts"],"names":[],"mappings":"AAkBA;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,GAAG,QAqClD"}

package/dist/resources/prompt-resources.js

@@ -0,0 +1,42 @@
+import { getPrompts, getPrompt } from './embedded-mcp-resources.js';
+import { logger } from '../utils/logger.js';
+const promptOverrides = {
+    'contextual-prompt': {
+        title: 'KAIROS Core Execution Engine',
+        description: 'Required execution policy for KAIROS protocol runs',
+        resultDescription: 'Required execution policy for KAIROS protocol runs'
+    }
+};
+/**
+ * Register all prompts from embedded-mcp-resources
+ */
+export function registerPromptResources(server) {
+    logger.info('Registering prompts dynamically from embedded resources');
+    const prompts = getPrompts();
+    for (const [key, text] of Object.entries(prompts)) {
+        const override = promptOverrides[key] ?? {};
+        const title = override.title || key.replace(/[-_]/g, ' ').replace(/\b\w/g, (l) => l.toUpperCase());
+        const description = override.description || `Prompt: ${title}`;
+        const resultDescription = override.resultDescription || description;
+        server.registerPrompt(key, {
+            title,
+            description
+        }, async () => {
+            const promptText = getPrompt(key) || text;
+            const result = {
+                description: resultDescription,
+                messages: [
+                    {
+                        role: 'user',
+                        content: {
+                            type: 'text',
+                            text: promptText
+                        }
+                    }
+                ]
+            };
+            return result;
+        });
+    }
+}
+//# sourceMappingURL=prompt-resources.js.map

package/dist/resources/prompt-resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-resources.js","sourceRoot":"","sources":["../../src/resources/prompt-resources.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAQ5C,MAAM,eAAe,GAAmC;IACtD,mBAAmB,EAAE;QACnB,KAAK,EAAE,8BAA8B;QACrC,WAAW,EAAE,oDAAoD;QACjE,iBAAiB,EAAE,oDAAoD;KACxE;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAW;IACjD,MAAM,CAAC,IAAI,CAAC,yDAAyD,CAAC,CAAC;IAEvE,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAE7B,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAClD,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QAC5C,MAAM,KAAK,GACT,QAAQ,CAAC,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;QAC/F,MAAM,WAAW,GAAG,QAAQ,CAAC,WAAW,IAAI,WAAW,KAAK,EAAE,CAAC;QAC/D,MAAM,iBAAiB,GAAG,QAAQ,CAAC,iBAAiB,IAAI,WAAW,CAAC;QAEpE,MAAM,CAAC,cAAc,CACnB,GAAG,EACH;YACE,KAAK;YACL,WAAW;SACZ,EACD,KAAK,IAA8B,EAAE;YACnC,MAAM,UAAU,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;YAC1C,MAAM,MAAM,GAAoB;gBAC9B,WAAW,EAAE,iBAAiB;gBAC9B,QAAQ,EAAE;oBACR;wBACE,IAAI,EAAE,MAAM;wBACZ,OAAO,EAAE;4BACP,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,UAAU;yBACjB;qBACF;iBACF;aACF,CAAC;YAEF,OAAO,MAAM,CAAC;QAChB,CAAC,CACF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/resources/resource-bootstrap.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Ensures the MCP server has resource handlers wired up even when no public
+ * resources or templates are registered. Without this bootstrap, the SDK
+ * refuses to expose resources/* methods and returns Method not found.
+ */
+export declare function bootstrapEmptyResourceHandlers(server: any): void;
+//# sourceMappingURL=resource-bootstrap.d.ts.map

package/dist/resources/resource-bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-bootstrap.d.ts","sourceRoot":"","sources":["../../src/resources/resource-bootstrap.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,GAAG,QAoCzD"}

package/dist/resources/resource-bootstrap.js

@@ -0,0 +1,33 @@
+import { ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Ensures the MCP server has resource handlers wired up even when no public
+ * resources or templates are registered. Without this bootstrap, the SDK
+ * refuses to expose resources/* methods and returns Method not found.
+ */
+export function bootstrapEmptyResourceHandlers(server) {
+    // Register a throwaway resource to trigger handler installation, then remove it.
+    const placeholderUri = 'kairos://__internal__/bootstrap';
+    const placeholderResource = server.registerResource('__kairos_internal_bootstrap_resource__', placeholderUri, {
+        title: 'bootstrap',
+        description: 'internal bootstrap resource',
+        mimeType: 'text/plain'
+    }, () => ({
+        contents: [{ uri: placeholderUri, mimeType: 'text/plain', text: '' }]
+    }));
+    placeholderResource.remove();
+    // Same trick for resource templates so /resources/templates/list stays available.
+    const template = new ResourceTemplate('kairos://__internal__/bootstrap/{id}', {
+        async list() {
+            return { resources: [] };
+        }
+    });
+    const placeholderTemplate = server.registerResource('__kairos_internal_bootstrap_template__', template, {
+        title: 'bootstrap template',
+        description: 'internal bootstrap template',
+        mimeType: 'text/plain'
+    }, async () => ({
+        contents: []
+    }));
+    placeholderTemplate.remove();
+}
+//# sourceMappingURL=resource-bootstrap.js.map

package/dist/resources/resource-bootstrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-bootstrap.js","sourceRoot":"","sources":["../../src/resources/resource-bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAE3E;;;;GAIG;AACH,MAAM,UAAU,8BAA8B,CAAC,MAAW;IACxD,iFAAiF;IACjF,MAAM,cAAc,GAAG,iCAAiC,CAAC;IACzD,MAAM,mBAAmB,GAAG,MAAM,CAAC,gBAAgB,CACjD,wCAAwC,EACxC,cAAc,EACd;QACE,KAAK,EAAE,WAAW;QAClB,WAAW,EAAE,6BAA6B;QAC1C,QAAQ,EAAE,YAAY;KACvB,EACD,GAAG,EAAE,CAAC,CAAC;QACL,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,cAAc,EAAE,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;KACtE,CAAC,CACH,CAAC;IACF,mBAAmB,CAAC,MAAM,EAAE,CAAC;IAE7B,kFAAkF;IAClF,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC,sCAAsC,EAAE;QAC5E,KAAK,CAAC,IAAI;YACR,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;QAC3B,CAAC;KACF,CAAC,CAAC;IACH,MAAM,mBAAmB,GAAG,MAAM,CAAC,gBAAgB,CACjD,wCAAwC,EACxC,QAAQ,EACR;QACE,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EAAE,6BAA6B;QAC1C,QAAQ,EAAE,YAAY;KACvB,EACD,KAAK,IAAI,EAAE,CAAC,CAAC;QACX,QAAQ,EAAE,EAAE;KACb,CAAC,CACH,CAAC;IACF,mBAAmB,CAAC,MAAM,EAAE,CAAC;AAC/B,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { MemoryQdrantStore } from './services/memory/store.js';
+export declare function createServer(memoryStore: MemoryQdrantStore): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAgB/D,wBAAgB,YAAY,CAAC,WAAW,EAAE,iBAAiB,GAAG,SAAS,CAmEtE"}

package/dist/server.js

@@ -0,0 +1,79 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { structuredLogger } from './utils/structured-logger.js';
+import { registerDocsResources } from './resources/docs-resources.js';
+import { registerPromptResources } from './resources/prompt-resources.js';
+import { bootstrapEmptyResourceHandlers } from './resources/resource-bootstrap.js';
+import { qdrantService } from './services/qdrant/index.js';
+import { getBuildVersion } from './utils/build-version.js';
+import { registerKairosMintTool } from './tools/kairos_mint.js';
+import { LOG_LEVEL, LOG_FORMAT, TRANSPORT_TYPE, getQdrantUrl, getQdrantCollection, QDRANT_API_KEY, QDRANT_RESCORE_STRING, TEI_URL, TEI_MODEL, getEmbeddingDimension, getTeiDimension, KAIROS_SEARCH_OVERFETCH_FACTOR, KAIROS_SEARCH_MAX_FETCH, KAIROS_ENABLE_GROUP_COLLAPSE } from './config.js';
+// removed: debug tools (kb_version, kb_cache_stats)
+import { registerKairosUpdateTool } from './tools/kairos_update.js';
+import { registerKairosDeleteTool } from './tools/kairos_delete.js';
+import { registerSearchTool } from './tools/kairos_search.js';
+import { registerBeginTool } from './tools/kairos_begin.js';
+import { registerKairosNextTool } from './tools/kairos_next.js';
+import { registerKairosAttestTool } from './tools/kairos_attest.js';
+import { registerKairosDumpTool } from './tools/kairos_dump.js';
+import { registerKairosSpacesTool } from './tools/kairos_spaces.js';
+// Create and configure the MCP server
+export function createServer(memoryStore) {
+    const server = new McpServer({
+        name: 'KAIROS',
+        version: getBuildVersion()
+    }, {
+        capabilities: {
+            tools: {},
+            resources: {},
+            prompts: {}
+        }
+    });
+    // Register kairos tools
+    // New protocol workflow: search -> begin (step 1) -> next (steps 2+) -> attest
+    registerSearchTool(server, memoryStore, { qdrantService });
+    registerBeginTool(server, memoryStore, { qdrantService });
+    registerKairosNextTool(server, memoryStore, { qdrantService });
+    registerKairosMintTool(server, memoryStore);
+    registerKairosAttestTool(server, qdrantService);
+    registerKairosUpdateTool(server);
+    registerKairosDeleteTool(server);
+    registerKairosDumpTool(server, memoryStore, { qdrantService });
+    registerKairosSpacesTool(server, memoryStore);
+    // Register resources
+    bootstrapEmptyResourceHandlers(server);
+    // Register docs resources (from embedded-mcp-resources)
+    registerDocsResources(server);
+    // Register prompts (from embedded-mcp-resources)
+    registerPromptResources(server);
+    // Log runtime configuration (mask secrets)
+    const mask = (v) => (v ? `${v.slice(0, 2)}***${v.slice(-2)}` : undefined);
+    const config = {
+        log: {
+            level: LOG_LEVEL,
+            format: LOG_FORMAT,
+        },
+        transport: {
+            type: TRANSPORT_TYPE,
+        },
+        qdrant: {
+            url: getQdrantUrl(),
+            collection: getQdrantCollection(),
+            apiKey: mask(QDRANT_API_KEY),
+            rescore: QDRANT_RESCORE_STRING,
+        },
+        tei: {
+            url: TEI_URL,
+            model: TEI_MODEL,
+            dim_env: getEmbeddingDimension() || getTeiDimension(),
+        },
+        search: {
+            overfetch: KAIROS_SEARCH_OVERFETCH_FACTOR,
+            maxFetch: KAIROS_SEARCH_MAX_FETCH,
+            groupCollapse: KAIROS_ENABLE_GROUP_COLLAPSE
+        },
+    };
+    structuredLogger.debug(`runtime config ${JSON.stringify(config)}`);
+    structuredLogger.info('MCP server created and configured');
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/services/chain-utils.d.ts

@@ -0,0 +1,22 @@
+import type { Memory } from '../types/memory.js';
+export interface ResolvedChainStep {
+    uuid: string;
+    label?: string;
+    step?: number;
+    count?: number;
+}
+export declare function resolveFirstStep(memory: Memory, qdrantService?: any): Promise<{
+    uri: string;
+    label: string;
+} | undefined>;
+export declare function resolveChainFirstStep(memory: Memory, qdrantService?: any): Promise<ResolvedChainStep | undefined>;
+export declare function resolveChainNextStep(memory: Memory, qdrantService?: any): Promise<ResolvedChainStep | undefined>;
+export declare function resolveChainPreviousStep(memory: Memory, qdrantService?: any): Promise<ResolvedChainStep | undefined>;
+declare const _default: {
+    resolveFirstStep: typeof resolveFirstStep;
+    resolveChainFirstStep: typeof resolveChainFirstStep;
+    resolveChainNextStep: typeof resolveChainNextStep;
+    resolveChainPreviousStep: typeof resolveChainPreviousStep;
+};
+export default _default;
+//# sourceMappingURL=chain-utils.d.ts.map

package/dist/services/chain-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain-utils.d.ts","sourceRoot":"","sources":["../../src/services/chain-utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,WAAW,iBAAiB;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAYD,wBAAsB,gBAAgB,CAClC,MAAM,EAAE,MAAM,EACd,aAAa,CAAC,EAAE,GAAG,GACpB,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAAC,CAkBrD;AAED,wBAAsB,qBAAqB,CACvC,MAAM,EAAE,MAAM,EACd,aAAa,CAAC,EAAE,GAAG,GACpB,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAexC;AAED,wBAAsB,oBAAoB,CACtC,MAAM,EAAE,MAAM,EACd,aAAa,CAAC,EAAE,GAAG,GACpB,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAexC;AAED,wBAAsB,wBAAwB,CAC1C,MAAM,EAAE,MAAM,EACd,aAAa,CAAC,EAAE,GAAG,GACpB,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAexC;;;;;;;AAED,wBAKE"}