@debian777/kairos-mcp 3.0.1-beta.14

package/dist/index.js

@@ -0,0 +1,100 @@
+/**
+ * KAIROS MCP Server
+ *
+ * Supporting HTTP transport only (STDIO removed for simplicity)
+ */
+import { structuredLogger } from './utils/structured-logger.js';
+import { installGlobalErrorHandlers } from './utils/global-error-handlers.js';
+import { logger } from './utils/logger.js';
+import { MemoryQdrantStore } from './services/memory/store.js';
+import { createServer } from './server.js';
+import { startServer } from './http/http-server.js';
+import { injectMemResourcesAtBoot } from './resources/mem-resources-boot.js';
+import { startMetricsServer } from './metrics-server.js';
+import { PORT, METRICS_PORT, QDRANT_SNAPSHOT_ON_START, QDRANT_SNAPSHOT_DIR } from './config.js';
+import { qdrantService } from './services/qdrant/index.js';
+import { triggerQdrantSnapshot } from './services/qdrant/snapshots.js';
+// Import system metrics to ensure they're initialized
+import './services/metrics/system-metrics.js';
+/**
+ * Wait for Qdrant to be available with retries
+ * Uses shorter intervals for faster detection when Qdrant becomes available quickly
+ */
+async function waitForQdrant(memoryStore, maxRetries = 30, intervalMs = 1000) {
+    structuredLogger.info('Waiting for Qdrant to be available...');
+    for (let attempt = 1; attempt <= maxRetries; attempt++) {
+        try {
+            const isHealthy = await memoryStore.checkHealth(5000); // 5 second timeout per check
+            if (isHealthy) {
+                structuredLogger.info(`Qdrant is available after ${attempt} attempt(s)`);
+                return;
+            }
+        }
+        catch (err) {
+            const errorMessage = err instanceof Error ? err.message : String(err);
+            structuredLogger.debug(`Qdrant health check error on attempt ${attempt}: ${errorMessage}`);
+            // Health check failed, will retry
+        }
+        if (attempt < maxRetries) {
+            structuredLogger.info(`Qdrant not ready yet (attempt ${attempt}/${maxRetries}), retrying in ${intervalMs}ms...`);
+            await new Promise(resolve => setTimeout(resolve, intervalMs));
+        }
+    }
+    throw new Error(`Qdrant did not become available after ${maxRetries} attempts (${maxRetries * intervalMs / 1000}s)`);
+}
+async function main() {
+    try {
+        // Install once at startup to capture any background errors/warnings
+        installGlobalErrorHandlers();
+        const memoryStore = new MemoryQdrantStore();
+        // Wait for Qdrant to be available before initializing
+        await waitForQdrant(memoryStore);
+        structuredLogger.info('Initializing Qdrant memory store...');
+        await memoryStore.init();
+        structuredLogger.info('Memory store ready');
+        if (QDRANT_SNAPSHOT_ON_START) {
+            const snapshotResult = await triggerQdrantSnapshot(qdrantService, {
+                enabled: true,
+                directory: QDRANT_SNAPSHOT_DIR,
+                reason: 'startup'
+            });
+            if (!snapshotResult.success) {
+                structuredLogger.warn(`Startup snapshot failed: ${snapshotResult.message || 'unknown error'}`);
+            }
+        }
+        else {
+            structuredLogger.info('Startup snapshot disabled (QDRANT_SNAPSHOT_ON_START=false)');
+        }
+        // Inject mem resources from embedded-mcp-resources into Qdrant at boot
+        // Use --force flag to allow override in new versions
+        await injectMemResourcesAtBoot(memoryStore, { force: true });
+        // Start dedicated metrics server on separate port
+        // This runs independently from the main application server
+        startMetricsServer();
+        structuredLogger.info(`Application server: ${PORT}`);
+        structuredLogger.info(`Metrics server: ${METRICS_PORT} (isolated)`);
+        const server = createServer(memoryStore);
+        await startServer(server, memoryStore);
+    }
+    catch (err) {
+        const error = err instanceof Error ? err : new Error(String(err));
+        // Prefer structured HTTP logger for fatal errors
+        try {
+            structuredLogger.error('Fatal error during KAIROS MCP startup', error);
+        }
+        catch {
+            // Ignore logging failures from structured logger
+        }
+        // Fallback to generic logger (stdio-safe)
+        try {
+            logger.error('Fatal error during KAIROS MCP startup', error);
+        }
+        catch {
+            // Ignore logging failures from generic logger
+        }
+        // Ensure non-zero exit so supervisors can detect failure
+        process.exitCode = 1;
+    }
+}
+await main();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/metrics-server.d.ts

@@ -0,0 +1,14 @@
+import './services/metrics/system-metrics.js';
+/**
+ * Start dedicated metrics server on separate port.
+ *
+ * This server ONLY exposes /metrics endpoint for Prometheus scraping.
+ *
+ * Production benefits:
+ * - Complete isolation from application traffic
+ * - Can be restricted to internal networks only
+ * - No impact on application performance
+ * - Standard Prometheus deployment pattern
+ */
+export declare function startMetricsServer(port?: number): void;
+//# sourceMappingURL=metrics-server.d.ts.map

package/dist/metrics-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics-server.d.ts","sourceRoot":"","sources":["../src/metrics-server.ts"],"names":[],"mappings":"AAKA,OAAO,sCAAsC,CAAC;AAE9C;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,GAAE,MAAqB,GAAG,IAAI,CAwBpE"}

package/dist/metrics-server.js

@@ -0,0 +1,41 @@
+import express from 'express';
+import { register } from './services/metrics/registry.js';
+import { structuredLogger } from './utils/structured-logger.js';
+import { METRICS_PORT } from './config.js';
+// Import system metrics to ensure they're initialized
+import './services/metrics/system-metrics.js';
+/**
+ * Start dedicated metrics server on separate port.
+ *
+ * This server ONLY exposes /metrics endpoint for Prometheus scraping.
+ *
+ * Production benefits:
+ * - Complete isolation from application traffic
+ * - Can be restricted to internal networks only
+ * - No impact on application performance
+ * - Standard Prometheus deployment pattern
+ */
+export function startMetricsServer(port = METRICS_PORT) {
+    const app = express();
+    // ONLY route: /metrics endpoint
+    app.get('/metrics', async (req, res) => {
+        try {
+            res.set('Content-Type', register.contentType);
+            const metrics = await register.metrics();
+            res.end(metrics);
+        }
+        catch (error) {
+            structuredLogger.error('Error generating metrics', error);
+            res.status(500).end('Error generating metrics');
+        }
+    });
+    // Health check for metrics server (optional but recommended)
+    app.get('/health', (req, res) => {
+        res.status(200).json({ status: 'ok', service: 'metrics' });
+    });
+    app.listen(port, () => {
+        structuredLogger.info(`Metrics server listening on port ${port}`);
+        structuredLogger.info(`Metrics endpoint: http://localhost:${port}/metrics`);
+    });
+}
+//# sourceMappingURL=metrics-server.js.map

package/dist/metrics-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics-server.js","sourceRoot":"","sources":["../src/metrics-server.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,sDAAsD;AACtD,OAAO,sCAAsC,CAAC;AAE9C;;;;;;;;;;GAUG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAe,YAAY;IAC5D,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;IAEtB,gCAAgC;IAChC,GAAG,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;QACrC,IAAI,CAAC;YACH,GAAG,CAAC,GAAG,CAAC,cAAc,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;YAC9C,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAC;YACzC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACnB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,gBAAgB,CAAC,KAAK,CAAC,0BAA0B,EAAE,KAAK,CAAC,CAAC;YAC1D,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;QAClD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,6DAA6D;IAC7D,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QAC9B,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;QACpB,gBAAgB,CAAC,IAAI,CAAC,oCAAoC,IAAI,EAAE,CAAC,CAAC;QAClE,gBAAgB,CAAC,IAAI,CAAC,sCAAsC,IAAI,UAAU,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,2 @@
+export declare function registerDocsResources(server: any): void;
+//# sourceMappingURL=docs-resources.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"docs-resources.d.ts","sourceRoot":"","sources":["../../src/resources/docs-resources.ts"],"names":[],"mappings":"AASA,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,GAAG,QAqDhD"}

package/dist/resources/docs-resources.js

@@ -0,0 +1,47 @@
+import { getResource, getResources } from './embedded-mcp-resources.js';
+import { logger } from '../utils/logger.js';
+function mdOrFallback(uri, text, notFound = 'Document not found') {
+    return {
+        contents: [{ uri: uri.href, mimeType: 'text/markdown', text: text || `# ${notFound}` }]
+    };
+}
+export function registerDocsResources(server) {
+    logger.info('Registering docs resources dynamically from embedded resources (excluding templates)');
+    const resources = getResources();
+    const toTitle = (s) => s.replace(/_/g, ' ').replace(/\b\w/g, (l) => l.toUpperCase());
+    // Handle both flat resources (directly in resources/) and nested resources (in subdirectories)
+    for (const [key, value] of Object.entries(resources)) {
+        if (typeof value === 'string') {
+            // Flat resource: treat as if in 'doc' subdirectory
+            const subdir = 'doc';
+            const filename = key;
+            const prefix = `kairos://${subdir}`;
+            const uri = `${prefix}/${filename}`;
+            const name = toTitle(filename);
+            const description = `Documentation for ${name}`;
+            server.registerResource(`${subdir}-${filename}`, uri, { name, description, mimeType: 'text/markdown' }, (uriObj) => {
+                const resourceContent = getResource(filename);
+                return mdOrFallback(uriObj, resourceContent);
+            });
+        }
+        else if (typeof value === 'object' && value !== null) {
+            // Nested resource: subdirectory structure (doc, mem, etc.)
+            const subdir = key;
+            const prefix = `kairos://${subdir}`;
+            // Iterate through files in this subdirectory
+            for (const [filename, content] of Object.entries(value)) {
+                if (typeof content === 'string') {
+                    const uri = `${prefix}/${filename}`;
+                    const name = toTitle(filename);
+                    const description = `Documentation for ${name}`;
+                    server.registerResource(`${subdir}-${filename}`, uri, { name, description, mimeType: 'text/markdown' }, (uriObj) => {
+                        const resourceContent = getResource(`${subdir}.${filename}`);
+                        return mdOrFallback(uriObj, resourceContent);
+                    });
+                }
+            }
+        }
+    }
+    // Tools docs are not registered as resources to keep resources/list lean.
+}
+//# sourceMappingURL=docs-resources.js.map

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

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

package/dist/resources/embedded-mcp-resources.d.ts

@@ -0,0 +1,73 @@
+/**
+ * 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 declare const mcpResources: {
+    prompts: {
+        "contextual-prompt": string;
+    };
+    resources: {
+        "building-kairos-workflows": string;
+    };
+    templates: {
+        "kairos-memory": string;
+    };
+    tools: {
+        kairos_attest: string;
+        kairos_begin: string;
+        kairos_delete: string;
+        kairos_dump: string;
+        kairos_mint: string;
+        kairos_next: string;
+        kairos_search: string;
+        kairos_spaces: string;
+        kairos_update: string;
+    };
+    mem: {};
+};
+/**
+ * Get prompts object
+ */
+export declare function getPrompts(): Record<string, any>;
+/**
+ * Get resources object
+ */
+export declare function getResources(): Record<string, any>;
+/**
+ * Get templates object
+ */
+export declare function getTemplates(): Record<string, any>;
+/**
+ * Get tools object
+ */
+export declare function getTools(): Record<string, any>;
+/**
+ * Get mem object
+ */
+export declare function getMem(): Record<string, any>;
+/**
+ * Get a prompt by key (e.g. 'contextual-prompt')
+ */
+export declare function getPrompt(key: string): string | undefined;
+/**
+ * Get a resource by key (e.g. 'TEST', 'doc.TEST', 'mem.<uuid>')
+ */
+export declare function getResource(key: string): string | any | undefined;
+/**
+ * Get a template by key (e.g. 'kairos-memory')
+ */
+export declare function getTemplate(key: string): string | undefined;
+/**
+ * Get a tool doc by key (e.g. 'kairos_begin')
+ */
+export declare function getToolDoc(key: string): string | undefined;
+/**
+ * Get all available resource categories and names
+ */
+export declare function listResourceKeys(): Record<string, string[]>;
+//# sourceMappingURL=embedded-mcp-resources.d.ts.map

package/dist/resources/embedded-mcp-resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedded-mcp-resources.d.ts","sourceRoot":"","sources":["../../src/resources/embedded-mcp-resources.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;CAsBxB,CAAC;AAEF;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAEhD;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAElD;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAElD;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAE9C;AAED;;GAEG;AACH,wBAAgB,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAE5C;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGzD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,GAAG,GAAG,SAAS,CAYjE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG3D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG1D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAkB3D"}

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 challenge.\nYou advance a protocol by submitting a matching solution.\n\n**Execution policy:** When running KAIROS protocols, follow the tools'\n`next_action` and `challenge.description` exactly. Do not invent work or\nskip steps. Respond to the user only after the protocol run is complete\n(after calling `kairos_attest` when `next_action` directs you to it).\n\n## Execution loop\n\nFollow this loop for any protocol run.\n\n1. Call `kairos_search` when the user's intent maps to a protocol.\n2. Choose a protocol from `choices`; 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. By `challenge.type`:\n     - `shell` — Run `challenge.shell.cmd`. Report actual\n       `exit_code`/`stdout`/`stderr`. Never fabricate.\n     - `mcp` — Call `challenge.mcp.tool_name`. Report actual result.\n       `success` must reflect reality.\n     - `user_input` — Display `challenge.user_input.prompt` verbatim to\n       the user. Place their exact reply in `user_input.confirmation`.\n       Never invent it.\n     - `comment` — Write a genuine comment about this step that meets\n       `challenge.comment.min_length` and is relevant to the step.\n   - Call `kairos_next` with the URI from `next_action` and a `solution`\n     matching `challenge.type`.\n   - Echo `challenge.nonce` as `solution.nonce` when present.\n   - Echo `challenge.proof_hash` as `solution.proof_hash` for step 1.\n     For later steps, echo the `proof_hash` from the previous\n     `kairos_next` response.\n   - Never compute hashes. The server generates all hashes.\n4. When `next_action` directs you to `kairos_attest`, call it with the\n   given URI and outcome/message. The protocol run is done; respond to\n   the user.\n\n## MUST ALWAYS\n\n- Follow `next_action` when `must_obey: true`. No deviation.\n- Perform actual challenge work before submitting a solution.\n- Complete `kairos_attest` before responding to the user.\n- Run an existing protocol instead of inventing a new workflow.\n\n## MUST NEVER\n\n- Compute or modify hashes or nonces.\n- Fabricate shell output, MCP results, or user confirmations.\n- Respond to the user before `kairos_attest` when `must_obey: true`.\n\n## Minting and editing protocols\n\nWhen minting (`kairos_mint`) or editing (`kairos_update`) a workflow\ndocument (H1 chain, H2 steps), add a trailing ` ```json ` block at the\nend of each step with `{\"challenge\": {...}}` (same shape as\n`kairos_begin`/`kairos_next`). Use the challenge type that matches the\nwork: `shell`, `mcp`, `user_input`, or `comment`.\n\n## `must_obey` semantics\n\n- `must_obey: true` — Follow `next_action` exactly.\n- `must_obey: false` — Use judgment. Choose from options in\n  `next_action`. Repair with `kairos_update` when safe; otherwise ask\n  the user.\n"
+    },
+    "resources": {
+        "building-kairos-workflows": "# Building KAIROS workflows with challenge/solution\n\n**Purpose:** Primary guide for building KAIROS protocol workflows.\nChallenge/solution is the core mechanism: each step defines a\n**challenge** (what must be done); execution advances by submitting a\nmatching **solution** via `kairos_next`. This guide covers document\nstructure, minting with `kairos_mint`, and solution submission.\n\n---\n\n## Mission\n\nBuild KAIROS protocol workflows where challenges (defined per step) are\nvalidated by solutions (submitted in `kairos_next`). Create documents\nwith `kairos_mint` that define these challenges; maintain exact\nconsistency between markdown structure and memory chain behavior.\n\n---\n\n## Structure\n\n**Document organization:**\n\n- **H1 (`# Title`)** — defines a protocol chain (one H1 = one chain).\n- **Steps** — defined by a trailing ` ```json ` block with\n  `{\"challenge\": {...}}`. H2 headings are used as step labels when\n  present in a segment.\n- **Challenge** — a fenced ` ```json ` block with `{\"challenge\": {...}}`\n  (same shape as `kairos_begin`/`kairos_next`).\n\n**Memory mapping:**\n\n- Each H1 section → one protocol chain.\n- Each challenge block (` ```json ` with `challenge` key) → one memory\n  step; content before that block is the step's text.\n- Optional content after the last challenge block → final step (no\n  proof required).\n- H2 in a segment → used as that step's label when present.\n\n**Processing flow:**\n\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## Challenge definitions\n\nAdd a trailing ` ```json ` block at the end of each step with an object\nthat has a `challenge` key. The value is the same shape as the challenge\nreturned by `kairos_begin`/`kairos_next`; it round-trips with\n`kairos_dump`.\n\n**`shell`:**\n\nExample: ```json\n{\n  \"challenge\": {\n    \"type\": \"shell\",\n    \"shell\": { \"cmd\": \"echo \\\"test\\\"\", \"timeout_seconds\": 30 },\n    \"required\": true\n  }\n}\n```\n\n**`mcp`:**\n\nExample: ```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`:**\n\nExample: ```json\n{\n  \"challenge\": {\n    \"type\": \"user_input\",\n    \"user_input\": { \"prompt\": \"Confirm completion\" },\n    \"required\": true\n  }\n}\n```\n\n**`comment`:**\n\nExample: ```json\n{\n  \"challenge\": {\n    \"type\": \"comment\",\n    \"comment\": { \"min_length\": 50 },\n    \"required\": true\n  }\n}\n```\n\n**Parsing rule:** Only the **last** fenced code block in a step is read;\nit must be valid JSON with a `challenge` key. The block is stripped from\nstored text; the challenge becomes that step's `proof_of_work`.\n\n### Challenge execution semantics\n\n- **`shell`:** Run the command; report `exit_code`/`stdout`/`stderr`.\n  Exit code 0 = success.\n- **`mcp`:** Call the tool; report `result` and `success`.\n- **`user_input`:** Display the prompt to the user; place only their\n  reply in `user_input.confirmation`.\n- **`comment`:** Provide text meeting the minimum length; the server\n  validates relevance to the step.\n\nFor agent execution rules (what agents must do per type), see the\n`kairos_begin` and `kairos_next` tool descriptions.\n\n---\n\n## MUST ALWAYS\n\n**Document structure:**\n\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\n**Challenge placement:**\n\n- Place the challenge at the **end** of an H2 section as a single\n  trailing ` ```json ` block.\n- Only the **last** code block in a step is parsed as the challenge.\n- Ensure the opening \\`\\`\\`json is at **line start** (on its own line,\n  no prefix). Blocks with text on the same line (e.g. `Example: \\`\\`\\`json`)\n  are not parsed as steps.\n\n**`kairos_mint` usage:**\n\n- Pass `markdown_doc` as a string.\n- Include `llm_model_id` (e.g. `\"minimax/minimax-m2:free\"`).\n- Use `force_update: true` to overwrite existing chains with the same\n  label.\n\n**Solution submission:**\n\n- Submit via `kairos_next(uri, solution)`.\n- Solution structure by type:\n  - `shell`: `{ type: \"shell\", shell: { exit_code, stdout, stderr,\n    duration_seconds } }`\n  - `mcp`: `{ type: \"mcp\", mcp: { tool_name, arguments, result,\n    success } }`\n  - `user_input`: `{ type: \"user_input\", user_input: { confirmation,\n    timestamp } }`\n  - `comment`: `{ type: \"comment\", comment: { text } }`\n\n---\n\n## MUST NEVER\n\n**Document structure:**\n\n- Mix H1 and H2 in unpredictable ways.\n- Place the challenge JSON block outside the H2 section it ends.\n- Use legacy line-based challenge syntax; use only the trailing JSON\n  block.\n\n**Challenge definitions:**\n\n- Use the deprecated `proof_of_work` field in API calls; use `solution`\n  instead.\n- Submit solutions that do not match the challenge type.\n\n**`kairos_mint`:**\n\n- Pass `markdown_doc` as an object — always pass as a string.\n- Omit `llm_model_id` — it is required.\n- Store duplicate chains without `force_update: true`.\n\n**Workflow:**\n\n- Confuse `challenge` (output from `kairos_next`) with `solution` (input\n  to `kairos_next`).\n- Use the deprecated `proof_of_work` field; use `solution`.\n- Assume step 1 requires a solution submission — step 1 is begun with\n  `kairos_begin` only.\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 ` ```json `\nblock containing `{\"challenge\": {...}}`:\n\n```\n## Step 1: Initialize\nCreate the project structure.\n\n```json\n{\"challenge\":{\"type\":\"shell\",\"shell\":{\"cmd\":\"mkdir -p project/src\",\"timeout_seconds\":10},\"required\":true}}\n```\n```\n\nRepeat for Steps 2 and 3 with their own `shell` challenge blocks.\n\n**Execution flow:**\n\n1. `kairos_search(\"simple setup\")` → returns `must_obey: true` with\n   `next_action` containing URI.\n2. `kairos_begin(uri)` → returns step 1 with `challenge` and\n   `next_action` with next URI.\n3. `kairos_next(step2_uri, { type: \"shell\", proof_hash: \"...\",\n   shell: {...} })` → returns step 2.\n4. Continue through all steps; echo `proof_hash` from each response.\n5. Last `kairos_next` returns `next_action` to call `kairos_attest`.\n   Call it to complete the run.\n\n### Example 2: Protocol with comment and user_input challenges\n\nStep 1 ends with a `comment` challenge block; Step 2 with a\n`user_input` block.\n\nStep 1 markdown:\n\n```\n## Step 1: Review\nReview the documentation for accuracy.\n\n```json\n{\"challenge\":{\"type\":\"comment\",\"comment\":{\"min_length\":50},\"required\":true}}\n```\n```\n\nStep 2 markdown:\n\n```\n## Step 2: Confirm\nConfirm review is complete.\n\n```json\n{\"challenge\":{\"type\":\"user_input\",\"user_input\":{\"prompt\":\"Type 'approved' to confirm\"},\"required\":true}}\n```\n```\n\n### Example 3: Multi-chain document\n\nUse two H1 sections (Protocol A, Protocol B). Each H1 creates a\nseparate chain. Each chain has one or more H2 steps; each step ends with\na ` ```json ` challenge block.\n\n**Result:** Two separate protocol chains are created.\n\n---\n\n## Challenge vs solution nomenclature\n\n- **Challenge** = what `kairos_next` **returns** (what the agent must\n  complete).\n- **Solution** = what you **submit** to `kairos_next` (proof you\n  completed it).\n\nIn markdown: use a trailing ` ```json ` block with `{\"challenge\": {...}}`\nper step. The API uses `challenge` (output) and `solution` (input).\n\n---\n\n## Validation rules\n\n| Type | Pass condition |\n|------|----------------|\n| `shell` | `exit_code === 0` |\n| `mcp` | `success === true` |\n| `user_input` | Any non-empty `confirmation` |\n| `comment` | `text.length` ≥ `challenge.comment.min_length` |\n\n**Step progression:**\n\n- Step 1: no solution required — call `kairos_begin` only.\n- Steps 2+: solution required — submit matching `solution`.\n- Include `nonce` and `proof_hash` in solution (echo from\n  challenge/response).\n- Last step: `kairos_next` directs to `kairos_attest`; call attest to\n  finalize.\n\n**Error handling (two-phase retry):**\n\n- Retries 1–3: `must_obey: true` with `error_code` and `next_action`\n  for recovery.\n- After 3 retries: `must_obey: false` — choose to fix the step, abort,\n  or ask the user.\n- Error responses include `error_code` (e.g. `NONCE_MISMATCH`,\n  `TYPE_MISMATCH`) and `retry_count`.\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"
+    },
+    "templates": {
+        "kairos-memory": "# {Protocol title}\n\n{One-sentence description of what this protocol does and when to run it.}\n\n## Natural Language Triggers\n\n**Run this protocol when the user says ANY of:**\n\n- \"{trigger phrase 1}\"\n- \"{trigger phrase 2}\"\n- \"{trigger phrase 3}\"\n\n**Trigger verbs** + ({noun1} / {noun2} / {noun3}):\n\n- **{verb1}** / **{verb2}** / **{verb3}**\n\n**Must Never:**\n\n- Trigger on \"{phrase}\" when the user means {different intent}\n- Run without {required precondition}\n\n**Must Always:**\n\n- {Mandatory behaviour 1}\n- {Mandatory behaviour 2}\n\n**Good trigger examples:**\n\n- \"{phrase that activates}\" → run this protocol\n- \"{phrase that activates}\" → run this protocol\n\n**Bad trigger examples:**\n\n- \"{phrase that must not activate}\" → {what to do instead}\n- \"{phrase that must not activate}\" → {what to do instead}\n\n## Step 1: {Step label}\n\n{What the agent must do in this step.}\n\n```json\n{\n  \"challenge\": {\n    \"type\": \"shell\",\n    \"shell\": { \"cmd\": \"{command}\", \"timeout_seconds\": 60 },\n    \"required\": true\n  }\n}\n```\n\n## Step 2: {Step label}\n\n{What the agent must do in this step.}\n\n```json\n{\n  \"challenge\": {\n    \"type\": \"comment\",\n    \"comment\": { \"min_length\": 50 },\n    \"required\": true\n  }\n}\n```\n\n## Completion rule\n\nOnly reachable after all prior steps are solved. Show the outputs from\nall prior steps to the user. No additional challenge.\n"
+    },
+    "tools": {
+        "kairos_attest": "Attest protocol completion or failure. Final step of every protocol run.\n\n**Precondition:** `kairos_next` (or `kairos_begin` for a single-step\nprotocol) returned `next_action` directing you to call `kairos_attest`.\nThere are no more steps to solve.\n\n**Input:**\n\n- `uri` — last step URI from the completion response's `next_action`.\n- `outcome` — `\"success\"` or `\"failure\"`.\n- `message` — short summary (1–2 sentences) of how the protocol went.\n\n**Response:** Confirmation that the run is recorded.\n\n**After attestation:** The protocol run is complete. Respond to the\nuser. Do not respond before attestation when `must_obey: true`.\n\n**MUST ALWAYS**\n\n- Call `kairos_attest` as the final action of every protocol run.\n- Report `outcome: \"failure\"` when any step failed or was aborted.\n\n**MUST NEVER**\n\n- Respond to the user before calling `kairos_attest` when `must_obey:\n  true`.\n- Skip attestation on error paths — always attest, even on failure.\n",
+        "kairos_begin": "Start protocol execution. Loads step 1 and returns its challenge.\nStep 1 never requires a solution submission.\n\n**Precondition:** You have a URI from `kairos_search` (via a choice's\n`next_action`). Do not call with a URI you invented.\n\n**Input:** `uri` — the protocol URI from `next_action`. If you supply a\nnon-step-1 URI, KAIROS auto-redirects to step 1.\n\n**Response:** `current_step` (content + uri), `challenge` (type,\ndescription, nonce, proof_hash), `next_action` with the exact URI for\nthe next call. Always `must_obey: true`.\n\n**AI decision tree:**\n\n- `next_action` mentions `kairos_next`: execute the challenge, then call\n  `kairos_next` with the URI from `next_action` and a solution matching\n  the challenge type.\n- `next_action` directs you to `kairos_attest`: single-step protocol.\n  Call `kairos_attest` with the given URI and outcome/message; run is\n  done.\n\n**Execution rules by `challenge.type`:**\n\n- `shell`: Run `challenge.shell.cmd`. Report actual `exit_code`,\n  `stdout`, `stderr`. Never fabricate.\n- `mcp`: Call `challenge.mcp.tool_name`. Report actual result.\n  `success` must reflect reality.\n- `user_input`: Display `challenge.user_input.prompt` verbatim to the\n  user. Place their exact reply in `user_input.confirmation`. Never\n  invent it.\n- `comment`: Write a genuine comment relevant to the step that meets\n  `challenge.comment.min_length`.\n\n**Proof hash:** Echo `challenge.proof_hash` as `solution.proof_hash` in\nthe next `kairos_next` call. The server generates all hashes.\n\n**MUST ALWAYS**\n\n- Perform the actual challenge work before submitting the solution.\n- Echo `challenge.nonce` and `challenge.proof_hash` verbatim in the\n  next `kairos_next` call.\n\n**MUST NEVER**\n\n- Compute or modify hashes or nonces.\n- Call `kairos_begin` again on error — use the fresh challenge in the\n  error response to retry via `kairos_next`.\n",
+        "kairos_delete": "Delete one or more memories from KAIROS.\n\n**Precondition:** You have the target memory URI(s). Resolve URIs via\n`kairos_search` and chain navigation before calling.\n\n**Input:**\n\n- `uris` (required, non-empty array) — `kairos://mem/{uuid}` URIs to\n  delete.\n\n**Response:** Confirmation of deleted URIs.\n\n**MUST ALWAYS**\n\n- Resolve and verify the target URIs before deleting.\n- Confirm the user's intent to delete before calling when acting on\n  user instruction.\n\n**MUST NEVER**\n\n- Delete a URI you have not resolved or verified.\n- Call with an empty `uris` array.\n",
+        "kairos_dump": "Read-only inspection of a memory or full protocol. Returns\n`markdown_doc` for use with `kairos_update` or `kairos_mint`. No run\nstate, no nonce.\n\n**Precondition:** You have a memory URI.\n\n**Input:**\n\n- `uri` — `kairos://mem/{uuid}`.\n- `protocol` (optional, default `false`) — when `true`, returns the\n  full chain as one markdown document; otherwise returns the single\n  step's content.\n\n**Output:**\n\n- Default mode: `markdown_doc` (string), and optionally `uri`, `label`,\n  `position`, `challenge`.\n- Protocol mode: `markdown_doc` (string), and optionally `uri` (chain\n  head), `label`, `step_count`.\n\n**Round-trip edit flow (single step):**\n\n1. `kairos_dump(uri)` → receive `markdown_doc`.\n2. Edit `markdown_doc`.\n3. `kairos_update({ uris: [uri], markdown_doc: [edited] })`.\n\n**Round-trip edit flow (full protocol):**\n\n1. `kairos_dump(uri, { protocol: true })` → receive full `markdown_doc`.\n2. Edit.\n3. `kairos_mint({ markdown_doc, llm_model_id, force_update: true })`.\n\n**MUST NEVER**\n\n- Use `kairos_dump` to bypass execution; use it only for inspection and\n  round-trip edit flows.\n",
+        "kairos_mint": "Store a markdown document as a KAIROS protocol chain. Each H1 defines\na chain; each H2 defines a step.\n\n**Precondition:** You have a complete markdown document with H1 title,\nH2 steps, and a trailing ` ```json ` challenge block per verifiable step.\n\n**Input:**\n\n- `markdown_doc` (string) — the markdown protocol document.\n- `llm_model_id` (required) — e.g. `\"minimax/minimax-m2:free\"`.\n- `force_update` (optional, default `false`) — set `true` to overwrite\n  an existing chain with the same label.\n\n**Challenge block format:** Place a single trailing ` ```json ` block at\nthe end of each H2 step. The object must have a `challenge` key. Only\nthe last code block in a step is parsed as the challenge. **The opening\n\\`\\`\\`json must be at line start** (on its own line with no text before\nit). Blocks with text on the same line (e.g. `Example: \\`\\`\\`json`) are\nnot parsed as steps.\n\nAdd a challenge to every step that can be verified. Omit challenges only\nfor purely informational steps where no verification is possible.\n\n**Challenge examples (one per type):**\n\n`shell` — run a command:\n\nExample: ```json\n{\n  \"challenge\": {\n    \"type\": \"shell\",\n    \"shell\": { \"cmd\": \"npm test\", \"timeout_seconds\": 60 },\n    \"required\": true\n  }\n}\n```\n\n`comment` — verification text:\n\nExample: ```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\nExample: ```json\n{\n  \"challenge\": {\n    \"type\": \"user_input\",\n    \"user_input\": { \"prompt\": \"Approve deployment?\" },\n    \"required\": true\n  }\n}\n```\n\n`mcp` — call an MCP tool:\n\nExample: ```json\n{\n  \"challenge\": {\n    \"type\": \"mcp\",\n    \"mcp\": { \"tool_name\": \"kairos_mint\" },\n    \"required\": true\n  }\n}\n```\n\n**Response:** Chain head URI(s). Find the minted protocol via\n`kairos_search` with a query matching the document content.\n\n**MUST ALWAYS**\n\n- Pass `markdown_doc` as a string.\n- Include `llm_model_id`.\n- Use `force_update: true` when overwriting an existing chain with the\n  same label.\n\n**MUST NEVER**\n\n- Pass `markdown_doc` as an object.\n- Omit `llm_model_id`.\n- Store duplicate chains without `force_update: true`.\n",
+        "kairos_next": "Submit a solution and advance to the next step. Use for every step\nafter step 1.\n\n**Precondition:** You have completed the current step's challenge. You\nhave the URI from the previous response's `next_action`.\n\n**Input:**\n\n- `uri` — current step URI from `next_action` of the previous response.\n  Do not use for step 1 — use `kairos_begin` for step 1.\n- `solution` — proof matching `challenge.type`:\n  - `shell`: `{ type: \"shell\", shell: { exit_code, stdout?, stderr?,\n    duration_seconds? } }` — `exit_code: 0` = success.\n  - `mcp`: `{ type: \"mcp\", mcp: { tool_name, result, success,\n    arguments? } }` — `success` must be `true`.\n  - `user_input`: `{ type: \"user_input\", user_input: { confirmation,\n    timestamp? } }`.\n  - `comment`: `{ type: \"comment\", comment: { text } }` — `text.length`\n    must meet `challenge.comment.min_length`.\n- `solution.nonce` — echo from `challenge.nonce` when present.\n- `solution.proof_hash` — echo `challenge.proof_hash` for step 1; for\n  steps 2+ echo the `proof_hash` from the previous `kairos_next`\n  response. The server generates all hashes.\n\n**Execution rules by `challenge.type`:**\n\n- `shell`: Run `challenge.shell.cmd`. Report actual `exit_code`,\n  `stdout`, `stderr`. Never fabricate.\n- `mcp`: Call `challenge.mcp.tool_name`. Report actual result.\n  `success` must reflect reality.\n- `user_input`: Display `challenge.user_input.prompt` verbatim to the\n  user. Place their exact reply in `user_input.confirmation`. Never\n  invent it.\n- `comment`: Write a genuine comment relevant to the step that meets\n  `challenge.comment.min_length`.\n\n**Response:** `current_step`, `challenge` (for next step), `next_action`\n(next tool call with embedded URI), `proof_hash` (use as\n`solution.proof_hash` for the next step).\n\n**AI decision tree:**\n\n- `must_obey: true` — follow `next_action` (success or recoverable\n  error, retries 1–3).\n- `must_obey: false` — use judgment (max retries exceeded). Options in\n  `next_action`: fix the step via `kairos_update`, abort via\n  `kairos_attest` with `outcome: \"failure\"`, or ask the user.\n- `next_action` directs you to `kairos_attest` — call attest with the\n  given URI and outcome/message; protocol run is done, then respond to\n  the user.\n\n**Error responses** include `error_code` (e.g. `NONCE_MISMATCH`,\n`TYPE_MISMATCH`, `MAX_RETRIES_EXCEEDED`) and `retry_count`. A fresh\n`challenge` with a new nonce is included for retry.\n\n**MUST ALWAYS**\n\n- Perform the actual challenge work before submitting.\n- Use the URI from the previous `next_action`, not a stored or invented\n  URI.\n- Echo `nonce` and `proof_hash` verbatim from the correct source.\n\n**MUST NEVER**\n\n- Fabricate shell output, MCP results, or user confirmations.\n- Compute or modify hashes or nonces.\n- Re-call `kairos_begin` on error; retry using the error response's\n  fresh challenge.\n",
+        "kairos_search": "Search for protocol chains matching a query. Entry point for every\nKAIROS workflow.\n\n**Precondition:** You have a user intent to translate into a protocol run.\n\n**Input:** `query` — 3–8 specific words (nouns + verbs). Use domain or\ntool names when the user implied one. Stay faithful to the user's\nintent; add specificity, do not substitute your own interpretation.\nExpand slash-commands or shorthand (e.g. `/ai-docs` → `write ai\ninstructions zero-drift template`).\n\n**Response:** Always `must_obey: true`. Contains `choices` array (each\nwith `uri`, `label`, `chain_label`, `score`, `role`, `tags`,\n`next_action`), `message`, and a global `next_action`.\n\n**Choice roles:**\n\n- `role: \"match\"` — search result with `score` (0.0–1.0). Higher score\n  = closer match. That choice's `next_action` directs you to call\n  `kairos_begin` with its URI.\n- `role: \"refine\"` — step-by-step help to build a more specific query. That\n  choice's `next_action` directs you to call `kairos_begin` with the\n  refine-help protocol URI.\n- `role: \"create\"` — create a new protocol (`score: null`). That\n  choice's `next_action` directs you to call `kairos_begin` with the\n  creation protocol URI.\n\n**Ordering:** Match choices first (top N), then refine (if present),\nthen create (if present). Refine and create are not part of the search\nlimit.\n\n**AI decision tree:** `must_obey: true` — pick one choice and follow\n**that choice's `next_action`**. The global `next_action` says: \"Pick\none choice and follow that choice's next_action.\"\n\nWhen results are weak (no scores above 0.7), pick the refine choice and\nrun that protocol for step-by-step help improving the query.\n\n**MUST ALWAYS**\n\n- Follow the chosen choice's `next_action`, not the global `next_action`.\n- Call `kairos_begin` with the chosen URI as the next step.\n\n**MUST NEVER**\n\n- Reuse a vague query that already returned no strong match.\n- Run `kairos_begin` with a URI not returned by this response.\n",
+        "kairos_spaces": "List the agent's available spaces with human-readable names and chain\ncounts.\n\n**Precondition:** None.\n\n**Input:**\n\n- `include_chain_titles` (optional, default `false`) — when `true`,\n  each space includes a `chains` array with `chain_id`, `title`, and\n  `step_count`.\n\n**Output:** `spaces` array. Each item has:\n\n- `name` — human-readable: `\"Personal\"`, `\"Group: <ref>\"`, or\n  `\"Kairos app\"`.\n- `chain_count` — number of protocol chains in this space.\n- `chains` (optional) — array of `{ chain_id, title, step_count }` when\n  `include_chain_titles: true`.\n\nSpaces include the agent's personal space, any group spaces, and the\nKairos app space (read-only protocols).\n\n**MUST ALWAYS**\n\n- Use space names (not raw IDs) in tool parameters such as `kairos_mint`.\n\n**MUST NEVER**\n\n- Pass raw space IDs in tool parameters; the backend resolves names to\n  IDs.\n",
+        "kairos_update": "Update one or more existing memories in KAIROS using markdown or\nfield-level updates.\n\n**Precondition:** You have the target memory URI(s). Resolve URIs via\n`kairos_search` followed by chain navigation, or use a URI already in\nscope.\n\n**Input:**\n\n- `uris` (required) — array of `kairos://mem/{uuid}` URIs to update.\n- `markdown_doc` (array of markdown strings, one per URI) — replaces\n  the full content of each targeted memory.\n- `updates` (field-level updates) — use when replacing specific fields\n  instead of the full document.\n\nProvide either `markdown_doc` or `updates`, not both.\n\n**Typical round-trip edit flow:**\n\n1. Call `kairos_dump(uri)` to retrieve the current `markdown_doc`.\n2. Edit the markdown.\n3. Call `kairos_update({ uris: [uri], markdown_doc: [edited_markdown] })`.\n\n**Response:** Updated memory URI(s) and confirmation.\n\n**MUST ALWAYS**\n\n- Resolve the target URI before calling `kairos_update`.\n- Provide one `markdown_doc` entry per URI in `uris` when using\n  `markdown_doc` mode.\n\n**MUST NEVER**\n\n- Update a URI you have not resolved or verified.\n- Mix `markdown_doc` and `updates` in the same call.\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"}