@debian777/kairos-mcp 3.0.1-beta.14

package/dist/tools/kairos_dump.js

@@ -0,0 +1,148 @@
+import { z } from 'zod';
+import { getToolDoc } from '../resources/embedded-mcp-resources.js';
+import { mcpToolCalls, mcpToolDuration, mcpToolErrors, mcpToolInputSize, mcpToolOutputSize } from '../services/metrics/mcp-metrics.js';
+import { getTenantId, getSpaceContextFromStorage } from '../utils/tenant-context.js';
+import { extractMemoryBody } from '../utils/memory-body.js';
+import { buildChallengeShapeForDisplay } from './kairos_next-pow-helpers.js';
+import { resolveChainFirstStep } from '../services/chain-utils.js';
+import { redisCacheService } from '../services/redis-cache.js';
+import { structuredLogger } from '../utils/structured-logger.js';
+const DUMP_TOOL_NAME = 'kairos_dump';
+const dumpInputSchema = z.object({
+    uri: z.string().min(1).describe('kairos://mem/{uuid}'),
+    protocol: z.boolean().optional().default(false).describe('If true, return full chain as one markdown document')
+});
+function normalizeUri(value) {
+    const normalized = (value || '').trim();
+    const uuid = normalized.split('/').pop();
+    if (!uuid) {
+        throw new Error('Invalid kairos://mem URI');
+    }
+    const uri = normalized.startsWith('kairos://mem/') ? normalized : `kairos://mem/${uuid}`;
+    return { uuid, uri };
+}
+async function loadMemory(memoryStore, uuid) {
+    const cached = await redisCacheService.getMemoryResource(uuid);
+    if (cached)
+        return cached;
+    const memory = await memoryStore.getMemory(uuid);
+    if (memory)
+        await redisCacheService.setMemoryResource(memory);
+    return memory;
+}
+/** Serialize proof-of-work as a JSON code block only (no legacy line format). */
+function challengeBlock(pow) {
+    if (!pow)
+        return '';
+    return '\n\n```json\n' + JSON.stringify({ challenge: pow }) + '\n```';
+}
+function buildMarkdownDocSingle(memory) {
+    const body = extractMemoryBody(memory.text);
+    return body + challengeBlock(memory.proof_of_work);
+}
+function buildMarkdownDocProtocol(memories) {
+    if (memories.length === 0)
+        return '';
+    const chainLabel = memories[0].chain?.label ?? memories[0].label ?? 'Protocol';
+    const parts = ['# ' + chainLabel];
+    for (const m of memories) {
+        const body = extractMemoryBody(m.text);
+        parts.push('## ' + m.label + '\n\n' + body + challengeBlock(m.proof_of_work));
+    }
+    return parts.join('\n\n');
+}
+/** Execute dump logic; used by MCP tool and HTTP API. */
+export async function executeDump(memoryStore, qdrantService, params) {
+    const { uri, protocol = false } = params;
+    const { uuid, uri: normalizedUri } = normalizeUri(uri);
+    const memory = await loadMemory(memoryStore, uuid);
+    if (!memory) {
+        const err = new Error('Memory not found');
+        err.statusCode = 404;
+        throw err;
+    }
+    if (protocol && memory.chain) {
+        const firstStep = await resolveChainFirstStep(memory, qdrantService);
+        if (!firstStep?.uuid) {
+            return {
+                markdown_doc: buildMarkdownDocSingle(memory),
+                uri: normalizedUri,
+                label: memory.label,
+                chain_label: memory.chain?.label ?? null,
+                step_count: 1
+            };
+        }
+        const chainId = memory.chain.id;
+        const chainLabel = memory.chain.label;
+        const stepCount = memory.chain.step_count;
+        const points = qdrantService && typeof qdrantService.getChainMemories === 'function'
+            ? await qdrantService.getChainMemories(chainId)
+            : [];
+        const memories = [];
+        for (const pt of points) {
+            const m = await loadMemory(memoryStore, pt.uuid);
+            if (m)
+                memories.push(m);
+        }
+        memories.sort((a, b) => (a.chain?.step_index ?? 0) - (b.chain?.step_index ?? 0));
+        const headUri = `kairos://mem/${firstStep.uuid}`;
+        return {
+            markdown_doc: buildMarkdownDocProtocol(memories),
+            uri: headUri,
+            label: chainLabel,
+            chain_label: chainLabel,
+            step_count: stepCount
+        };
+    }
+    const out = {
+        markdown_doc: buildMarkdownDocSingle(memory),
+        uri: normalizedUri,
+        label: memory.label,
+        chain_label: memory.chain?.label ?? null
+    };
+    if (memory.chain) {
+        out['position'] = {
+            step_index: memory.chain.step_index,
+            step_count: memory.chain.step_count
+        };
+    }
+    const challenge = buildChallengeShapeForDisplay(memory.proof_of_work);
+    if (challenge && Object.keys(challenge).length > 0) {
+        out['challenge'] = challenge;
+    }
+    return out;
+}
+export function registerKairosDumpTool(server, memoryStore, options = {}) {
+    const toolName = options.toolName ?? DUMP_TOOL_NAME;
+    const qdrantService = options.qdrantService;
+    server.registerTool(toolName, {
+        title: 'Inspect memory or protocol (read-only)',
+        description: getToolDoc('kairos_dump') ?? 'Returns markdown_doc for use with kairos_update or kairos_mint.',
+        inputSchema: dumpInputSchema
+    }, async (params) => {
+        const tenantId = getTenantId();
+        const spaceId = getSpaceContextFromStorage()?.defaultWriteSpaceId ?? 'default';
+        structuredLogger.debug(`kairos_dump space_id=${spaceId}`);
+        const inputSize = JSON.stringify(params).length;
+        mcpToolInputSize.observe({ tool: toolName, tenant_id: tenantId }, inputSize);
+        const timer = mcpToolDuration.startTimer({ tool: toolName, tenant_id: tenantId });
+        const respond = (payload) => {
+            mcpToolCalls.inc({ tool: toolName, status: 'success', tenant_id: tenantId });
+            mcpToolOutputSize.observe({ tool: toolName, tenant_id: tenantId }, JSON.stringify(payload).length);
+            timer({ tool: toolName, status: 'success', tenant_id: tenantId });
+            return { content: [{ type: 'text', text: JSON.stringify(payload) }], structuredContent: payload };
+        };
+        try {
+            const payload = await executeDump(memoryStore, qdrantService, params);
+            return respond(payload);
+        }
+        catch (error) {
+            mcpToolCalls.inc({ tool: toolName, status: 'error', tenant_id: tenantId });
+            mcpToolErrors.inc({ tool: toolName, status: 'error', tenant_id: tenantId });
+            timer({ tool: toolName, status: 'error', tenant_id: tenantId });
+            structuredLogger.debug(`kairos_dump error space_id=${spaceId}: ${error instanceof Error ? error.message : String(error)}`);
+            throw error;
+        }
+    });
+}
+//# sourceMappingURL=kairos_dump.js.map

package/dist/tools/kairos_dump.js.map

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

package/dist/tools/kairos_mint.d.ts

@@ -0,0 +1,7 @@
+import type { MemoryQdrantStore } from '../services/memory/store.js';
+interface RegisterKairosMintOptions {
+    toolName?: string;
+}
+export declare function registerKairosMintTool(server: any, memoryStore: MemoryQdrantStore, options?: RegisterKairosMintOptions): void;
+export {};
+//# sourceMappingURL=kairos_mint.d.ts.map

package/dist/tools/kairos_mint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kairos_mint.d.ts","sourceRoot":"","sources":["../../src/tools/kairos_mint.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAQrE,UAAU,yBAAyB;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,iBAAiB,EAAE,OAAO,GAAE,yBAA8B,QA4O1H"}

package/dist/tools/kairos_mint.js

@@ -0,0 +1,233 @@
+import { z } from 'zod';
+import { logger } from '../utils/logger.js';
+import { getToolDoc } from '../resources/embedded-mcp-resources.js';
+import { mcpToolCalls, mcpToolDuration, mcpToolErrors, mcpToolInputSize, mcpToolOutputSize, kairosMintSimilarMemoryFound } from '../services/metrics/mcp-metrics.js';
+import { getTenantId, getSpaceContextFromStorage, runWithSpaceContextAsync } from '../utils/tenant-context.js';
+import { KAIROS_APP_SPACE_DISPLAY_NAME } from '../utils/space-display.js';
+export function registerKairosMintTool(server, memoryStore, options = {}) {
+    const toolName = options.toolName || 'kairos_mint';
+    const memoryUriSchema = z
+        .string()
+        .regex(/^kairos:\/\/mem\/[0-9a-f-]{36}$/i, 'must match kairos://mem/{uuid}');
+    const inputSchema = z.object({
+        markdown_doc: z.string().min(1).describe('Markdown document to store'),
+        llm_model_id: z.string().min(1).describe('LLM model ID'),
+        force_update: z.boolean().optional().default(false).describe('Overwrite existing memory chain with the same label'),
+        space: z.enum(['personal']).or(z.string()).optional().describe('Target space: "personal" (default) or group name to mint into that group space')
+    });
+    const outputSchema = z.object({
+        items: z.array(z.object({
+            uri: memoryUriSchema,
+            memory_uuid: z.string(),
+            label: z.string(),
+            tags: z.array(z.string())
+        })),
+        status: z.literal('stored')
+    });
+    logger.debug(`kairos_mint registration inputSchema: ${JSON.stringify(inputSchema)}`);
+    logger.debug(`kairos_mint registration outputSchema: ${JSON.stringify(outputSchema)}`);
+    server.registerTool(toolName, {
+        title: 'Store memory or chain',
+        description: getToolDoc('kairos_mint'),
+        inputSchema,
+        outputSchema
+    }, async (params) => {
+        const tenantId = getTenantId();
+        const ctx = getSpaceContextFromStorage();
+        const rawSpace = typeof params?.space === 'string' ? params.space.trim() : '';
+        const spaceParam = rawSpace.toLowerCase();
+        let resolvedSpaceId;
+        if (params?.space === undefined || rawSpace === '' || spaceParam === 'personal') {
+            resolvedSpaceId = ctx.defaultWriteSpaceId || ctx.allowedSpaceIds[0] || '';
+        }
+        else if (spaceParam === KAIROS_APP_SPACE_DISPLAY_NAME.toLowerCase()) {
+            const msg = `Cannot mint into "${KAIROS_APP_SPACE_DISPLAY_NAME}"; it is read-only. Use "personal" or a group name.`;
+            mcpToolCalls.inc({ tool: toolName, status: 'error', tenant_id: tenantId });
+            mcpToolErrors.inc({ tool: toolName, status: 'error', tenant_id: tenantId });
+            return {
+                isError: true,
+                content: [{ type: 'text', text: JSON.stringify({ error: 'SPACE_READ_ONLY', message: msg }) }]
+            };
+        }
+        else {
+            const groupName = rawSpace.startsWith('Group: ') ? rawSpace.slice(7).trim() : rawSpace;
+            const match = ctx.allowedSpaceIds.find((id) => {
+                if (id === groupName)
+                    return true;
+                if (id.startsWith('group:') && id.split(':').pop() === groupName)
+                    return true;
+                return false;
+            });
+            if (!match) {
+                const msg = `Group or space "${groupName}" not found or not in your allowed spaces. Use kairos_spaces to list available spaces (use the name or group ref, e.g. "Personal", "Group: team1", or "team1").`;
+                mcpToolCalls.inc({ tool: toolName, status: 'error', tenant_id: tenantId });
+                mcpToolErrors.inc({ tool: toolName, status: 'error', tenant_id: tenantId });
+                return {
+                    isError: true,
+                    content: [{ type: 'text', text: JSON.stringify({ error: 'SPACE_NOT_FOUND', message: msg }) }]
+                };
+            }
+            resolvedSpaceId = match;
+        }
+        if (!resolvedSpaceId) {
+            const msg = 'No space available for minting. Check authentication and allowed spaces.';
+            return {
+                isError: true,
+                content: [{ type: 'text', text: JSON.stringify({ error: 'NO_SPACE', message: msg }) }]
+            };
+        }
+        logger.debug(`kairos_mint space_id=${resolvedSpaceId}`);
+        const inputSize = JSON.stringify(params).length;
+        mcpToolInputSize.observe({ tool: toolName, tenant_id: tenantId }, inputSize);
+        const timer = mcpToolDuration.startTimer({
+            tool: toolName,
+            tenant_id: tenantId
+        });
+        const narrowedContext = {
+            ...ctx,
+            allowedSpaceIds: [resolvedSpaceId],
+            defaultWriteSpaceId: resolvedSpaceId
+        };
+        let result;
+        try {
+            const { markdown_doc, llm_model_id, force_update } = params;
+            const docs = [markdown_doc];
+            let memories = [];
+            try {
+                memories = await runWithSpaceContextAsync(narrowedContext, () => memoryStore.storeChain(docs, llm_model_id, { forceUpdate: !!force_update }));
+            }
+            catch (error) {
+                // Handle duplicate chain error explicitly
+                const err = error;
+                if (err && (err.code === 'DUPLICATE_CHAIN' || err.code === 'DUPLICATE_KEY')) {
+                    const body = {
+                        error: 'DUPLICATE_CHAIN',
+                        ...(err.details || {})
+                    };
+                    result = {
+                        isError: true,
+                        content: [{ type: 'text', text: JSON.stringify(body) }]
+                    };
+                    mcpToolCalls.inc({
+                        tool: toolName,
+                        status: 'error',
+                        tenant_id: tenantId
+                    });
+                    mcpToolErrors.inc({
+                        tool: toolName,
+                        status: 'error',
+                        tenant_id: tenantId
+                    });
+                    timer({
+                        tool: toolName,
+                        status: 'error',
+                        tenant_id: tenantId
+                    });
+                    return result;
+                }
+                // Handle similar memory found by title (spec: must_obey, next_action, content_preview)
+                if (err && err.code === 'SIMILAR_MEMORY_FOUND') {
+                    kairosMintSimilarMemoryFound.inc({ transport: 'mcp', tenant_id: tenantId });
+                    const d = err.details || {};
+                    const body = {
+                        error: 'SIMILAR_MEMORY_FOUND',
+                        existing_memory: d.existing_memory,
+                        similarity_score: d.similarity_score,
+                        message: d.message ?? 'A very similar memory already exists. Verify it before overwriting.',
+                        must_obey: d.must_obey ?? true,
+                        next_action: d.next_action,
+                        ...(d.content_preview !== undefined && { content_preview: d.content_preview })
+                    };
+                    result = {
+                        isError: true,
+                        content: [{ type: 'text', text: JSON.stringify(body) }]
+                    };
+                    mcpToolCalls.inc({
+                        tool: toolName,
+                        status: 'error',
+                        tenant_id: tenantId
+                    });
+                    mcpToolErrors.inc({
+                        tool: toolName,
+                        status: 'error',
+                        tenant_id: tenantId
+                    });
+                    timer({
+                        tool: toolName,
+                        status: 'error',
+                        tenant_id: tenantId
+                    });
+                    return result;
+                }
+                logger.error(`[kairos_mint] Failed to store memory chain space_id=${resolvedSpaceId} (len=${markdown_doc?.length || 0}, model=${llm_model_id})`, error);
+                result = {
+                    isError: true,
+                    content: [{ type: 'text', text: JSON.stringify({ error: 'STORE_FAILED', message: err?.message || String(err) }) }]
+                };
+                mcpToolCalls.inc({
+                    tool: toolName,
+                    status: 'error',
+                    tenant_id: tenantId
+                });
+                mcpToolErrors.inc({
+                    tool: toolName,
+                    status: 'error',
+                    tenant_id: tenantId
+                });
+                timer({
+                    tool: toolName,
+                    status: 'error',
+                    tenant_id: tenantId
+                });
+                return result;
+            }
+            const output = {
+                items: memories.map(memory => ({
+                    uri: `kairos://mem/${memory.memory_uuid}`,
+                    memory_uuid: memory.memory_uuid,
+                    label: memory.label,
+                    tags: memory.tags
+                })),
+                status: 'stored'
+            };
+            result = {
+                content: [{ type: 'text', text: JSON.stringify(output) }],
+                structuredContent: output
+            };
+            // Track success
+            mcpToolCalls.inc({
+                tool: toolName,
+                status: 'success',
+                tenant_id: tenantId
+            });
+            // Track output size
+            const outputSize = JSON.stringify(result).length;
+            mcpToolOutputSize.observe({ tool: toolName, tenant_id: tenantId }, outputSize);
+            timer({
+                tool: toolName,
+                status: 'success',
+                tenant_id: tenantId
+            });
+            return result;
+        }
+        catch (error) {
+            mcpToolCalls.inc({
+                tool: toolName,
+                status: 'error',
+                tenant_id: tenantId
+            });
+            mcpToolErrors.inc({
+                tool: toolName,
+                status: 'error',
+                tenant_id: tenantId
+            });
+            timer({
+                tool: toolName,
+                status: 'error',
+                tenant_id: tenantId
+            });
+            throw error;
+        }
+    });
+}
+//# sourceMappingURL=kairos_mint.js.map

package/dist/tools/kairos_mint.js.map

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

package/dist/tools/kairos_next-missing-proof-payload.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Build current_step and challenge for MISSING_PROOF response so the client gets the previous step's
+ * challenge (correct nonce and proof_hash) for the next kairos_next call.
+ */
+import type { Memory } from '../types/memory.js';
+import type { QdrantService } from '../services/qdrant/service.js';
+import { buildChallenge } from './kairos_next-pow-helpers.js';
+import type { PreviousProofBlock } from './kairos_next-previous-step.js';
+declare function buildCurrentStep(memory: Memory | null, requestedUri: string): {
+    uri: string;
+    content: string;
+    mimeType: "text/markdown";
+};
+export type MissingProofPayload = {
+    current_step: ReturnType<typeof buildCurrentStep>;
+    challenge: Awaited<ReturnType<typeof buildChallenge>> & {
+        proof_hash: string;
+    };
+    next_action: string;
+    retry_count: number;
+};
+export declare function buildMissingProofPayload(memory: Memory, previousBlock: PreviousProofBlock, requestedUri: string, uuid: string, loadMemory: (id: string) => Promise<Memory | null>, qdrantService: QdrantService | undefined): Promise<MissingProofPayload>;
+export {};
+//# sourceMappingURL=kairos_next-missing-proof-payload.d.ts.map

package/dist/tools/kairos_next-missing-proof-payload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kairos_next-missing-proof-payload.d.ts","sourceRoot":"","sources":["../../src/tools/kairos_next-missing-proof-payload.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAGnE,OAAO,EAAE,cAAc,EAAgB,MAAM,8BAA8B,CAAC;AAE5E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEzE,iBAAS,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,YAAY,EAAE,MAAM;;;;EAIpE;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,YAAY,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;IAClD,SAAS,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,GAAG;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/E,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,kBAAkB,EACjC,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,EAClD,aAAa,EAAE,aAAa,GAAG,SAAS,GACvC,OAAO,CAAC,mBAAmB,CAAC,CAiB9B"}

package/dist/tools/kairos_next-missing-proof-payload.js

@@ -0,0 +1,32 @@
+/**
+ * Build current_step and challenge for MISSING_PROOF response so the client gets the previous step's
+ * challenge (correct nonce and proof_hash) for the next kairos_next call.
+ */
+import { resolveChainPreviousStep } from '../services/chain-utils.js';
+import { proofOfWorkStore } from '../services/proof-of-work-store.js';
+import { buildChallenge, GENESIS_HASH } from './kairos_next-pow-helpers.js';
+import { extractMemoryBody } from '../utils/memory-body.js';
+function buildCurrentStep(memory, requestedUri) {
+    const uri = memory ? `kairos://mem/${memory.memory_uuid}` : requestedUri;
+    const content = memory ? extractMemoryBody(memory.text) : '';
+    return { uri, content, mimeType: 'text/markdown' };
+}
+export async function buildMissingProofPayload(memory, previousBlock, requestedUri, uuid, loadMemory, qdrantService) {
+    const prev = await resolveChainPreviousStep(memory, qdrantService);
+    const prevMemory = prev?.uuid ? await loadMemory(prev.uuid) : null;
+    const prevUri = prev?.uuid ? `kairos://mem/${prev.uuid}` : requestedUri;
+    const isPrevStep1 = !prevMemory?.chain || prevMemory.chain.step_index <= 1;
+    const pPrev = prevMemory && !isPrevStep1 ? await resolveChainPreviousStep(prevMemory, qdrantService) : null;
+    const expectedPrevHash = isPrevStep1 ? GENESIS_HASH : (pPrev?.uuid ? await proofOfWorkStore.getProofHash(pPrev.uuid) : null) ?? GENESIS_HASH;
+    let challenge = await buildChallenge(prevMemory, prevMemory?.proof_of_work);
+    challenge = { ...challenge, proof_hash: expectedPrevHash };
+    const storedNonce = await proofOfWorkStore.getNonce(memory.memory_uuid);
+    const retryCount = await proofOfWorkStore.incrementRetry(storedNonce ?? uuid);
+    return {
+        current_step: buildCurrentStep(prevMemory, prevUri),
+        challenge,
+        next_action: previousBlock.next_action ?? `retry kairos_next with ${prevUri} -- complete previous step first`,
+        retry_count: retryCount
+    };
+}
+//# sourceMappingURL=kairos_next-missing-proof-payload.js.map

package/dist/tools/kairos_next-missing-proof-payload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kairos_next-missing-proof-payload.js","sourceRoot":"","sources":["../../src/tools/kairos_next-missing-proof-payload.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAG5D,SAAS,gBAAgB,CAAC,MAAqB,EAAE,YAAoB;IACnE,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,gBAAgB,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC;IACzE,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7D,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,eAAwB,EAAE,CAAC;AAC9D,CAAC;AASD,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,MAAc,EACd,aAAiC,EACjC,YAAoB,EACpB,IAAY,EACZ,UAAkD,EAClD,aAAwC;IAExC,MAAM,IAAI,GAAG,MAAM,wBAAwB,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACnE,MAAM,UAAU,GAAG,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,MAAM,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACnE,MAAM,OAAO,GAAG,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,gBAAgB,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC;IACxE,MAAM,WAAW,GAAG,CAAC,UAAU,EAAE,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC;IAC3E,MAAM,KAAK,GAAG,UAAU,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,wBAAwB,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5G,MAAM,gBAAgB,GAAG,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,MAAM,gBAAgB,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC;IAC7I,IAAI,SAAS,GAAG,MAAM,cAAc,CAAC,UAAU,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC;IAC5E,SAAS,GAAG,EAAE,GAAG,SAAS,EAAE,UAAU,EAAE,gBAAgB,EAAE,CAAC;IAC3D,MAAM,WAAW,GAAG,MAAM,gBAAgB,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IACxE,MAAM,UAAU,GAAG,MAAM,gBAAgB,CAAC,cAAc,CAAC,WAAW,IAAI,IAAI,CAAC,CAAC;IAC9E,OAAO;QACL,YAAY,EAAE,gBAAgB,CAAC,UAAU,EAAE,OAAO,CAAC;QACnD,SAAS;QACT,WAAW,EAAE,aAAa,CAAC,WAAW,IAAI,0BAA0B,OAAO,kCAAkC;QAC7G,WAAW,EAAE,UAAU;KACxB,CAAC;AACJ,CAAC"}

package/dist/tools/kairos_next-pow-helpers.d.ts

@@ -0,0 +1,57 @@
+import type { Memory, ProofOfWorkDefinition, ProofOfWorkType } from '../types/memory.js';
+/** Hash used as proof_hash for step 1 (no prior proof). */
+export declare const GENESIS_HASH: string;
+export type ProofOfWorkSubmission = {
+    type: ProofOfWorkType;
+    /** Nonce from challenge; must match server-issued nonce for this step. */
+    nonce?: string;
+    /** Proof hash from previous step's response or challenge.proof_hash for step 1. */
+    proof_hash?: string;
+    /** @deprecated Use proof_hash. Kept for backward compatibility. */
+    previousProofHash?: string;
+    shell?: {
+        exit_code: number;
+        stdout?: string;
+        stderr?: string;
+        duration_seconds?: number;
+    };
+    mcp?: {
+        tool_name: string;
+        arguments?: any;
+        result: any;
+        success: boolean;
+    };
+    user_input?: {
+        confirmation: string;
+        timestamp?: string;
+    };
+    comment?: {
+        text: string;
+    };
+};
+/** Build challenge shape from proof only (no nonce, no store). For read-only display e.g. kairos_dump. */
+export declare function buildChallengeShapeForDisplay(proof?: ProofOfWorkDefinition): Record<string, unknown>;
+export type BuildChallengeOptions = {
+    /** When set, use this nonce and do not overwrite the stored nonce (e.g. for error responses so retry count is preserved). */
+    existingNonce?: string;
+};
+export declare function buildChallenge(memory: Memory | null, proof?: ProofOfWorkDefinition, options?: BuildChallengeOptions): Promise<any>;
+/** @alias Backward compatibility alias (deprecated - use buildChallenge) */
+export declare const buildProofOfWorkRequired: typeof buildChallenge;
+export type ElicitResult = {
+    solution: ProofOfWorkSubmission;
+} | {
+    payload: any;
+};
+export declare function tryUserInputElicitation(server: any, memory: Memory, solution: ProofOfWorkSubmission, requestedUri: string, buildCurrentStep: (m: Memory, u: string) => any): Promise<ElicitResult>;
+export type HandleProofOptions = {
+    /** Expected proof_hash: GENESIS_HASH for step 1, or stored hash of previous step's proof. */
+    expectedPreviousHash: string;
+};
+export type HandleProofResult = {
+    blockedPayload?: any;
+    proofHash?: string;
+    alreadyRecorded?: boolean;
+};
+export declare function handleProofSubmission(submission: ProofOfWorkSubmission, memory: Memory, options?: HandleProofOptions): Promise<HandleProofResult>;
+//# sourceMappingURL=kairos_next-pow-helpers.d.ts.map

package/dist/tools/kairos_next-pow-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kairos_next-pow-helpers.d.ts","sourceRoot":"","sources":["../../src/tools/kairos_next-pow-helpers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAQzF,2DAA2D;AAC3D,eAAO,MAAM,YAAY,QAA8D,CAAC;AAOxF,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,eAAe,CAAC;IACtB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mFAAmF;IACnF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,KAAK,CAAC,EAAE;QACN,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC;IACF,GAAG,CAAC,EAAE;QACJ,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,GAAG,CAAC;QAChB,MAAM,EAAE,GAAG,CAAC;QACZ,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC;IACF,UAAU,CAAC,EAAE;QACX,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,OAAO,CAAC,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH,CAAC;AAEF,0GAA0G;AAC1G,wBAAgB,6BAA6B,CAAC,KAAK,CAAC,EAAE,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA6BpG;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,6HAA6H;IAC7H,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,KAAK,CAAC,EAAE,qBAAqB,EAC7B,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,GAAG,CAAC,CAYd;AAED,4EAA4E;AAC5E,eAAO,MAAM,wBAAwB,uBAAiB,CAAC;AAEvD,MAAM,MAAM,YAAY,GAAG;IAAE,QAAQ,EAAE,qBAAqB,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,GAAG,CAAA;CAAE,CAAC;AAElF,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,GAAG,EACX,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,qBAAqB,EAC/B,YAAY,EAAE,MAAM,EACpB,gBAAgB,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,GAAG,GAC9C,OAAO,CAAC,YAAY,CAAC,CAgCvB;AAuCD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,6FAA6F;IAC7F,oBAAoB,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAAE,cAAc,CAAC,EAAE,GAAG,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAExG,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,qBAAqB,EACjC,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,iBAAiB,CAAC,CA0J5B"}