@debian777/kairos-mcp 3.0.1-beta.14

package/dist/tools/kairos_next-pow-helpers.js

@@ -0,0 +1,271 @@
+import crypto from 'node:crypto';
+import { proofOfWorkStore, MAX_RETRIES } from '../services/proof-of-work-store.js';
+import { embeddingService } from '../services/embedding/service.js';
+import { extractMemoryBody } from '../utils/memory-body.js';
+/** Minimum cosine similarity for comment proof to pass semantic validation. Reject if below. */
+const COMMENT_SEMANTIC_THRESHOLD = 0.25;
+/** Hash used as proof_hash for step 1 (no prior proof). */
+export const GENESIS_HASH = crypto.createHash('sha256').update('genesis').digest('hex');
+function hashProofRecord(record) {
+    const canonical = JSON.stringify(record, Object.keys(record).sort());
+    return crypto.createHash('sha256').update(canonical).digest('hex');
+}
+/** Build challenge shape from proof only (no nonce, no store). For read-only display e.g. kairos_dump. */
+export function buildChallengeShapeForDisplay(proof) {
+    const base = proof ? (() => {
+        const proofType = proof.type || 'shell';
+        const result = { type: proofType, description: '' };
+        if (proofType === 'shell') {
+            const cmd = proof.shell?.cmd || proof.cmd || 'No command specified';
+            const timeout = proof.shell?.timeout_seconds || proof.timeout_seconds || 30;
+            result['description'] = `Execute shell command: ${cmd}. You MUST actually run this command and report the real exit_code/stdout/stderr; do not fabricate.`;
+            result['shell'] = { cmd, timeout_seconds: timeout };
+        }
+        else if (proofType === 'mcp') {
+            const toolName = proof.mcp?.tool_name || 'No tool specified';
+            result['description'] = `Call MCP tool: ${toolName}. You MUST actually call this tool and report its real result; do not fabricate.`;
+            result['mcp'] = { tool_name: toolName, expected_result: proof.mcp?.expected_result };
+        }
+        else if (proofType === 'user_input') {
+            const prompt = proof.user_input?.prompt || 'Confirm completion';
+            result['description'] = `User confirmation: ${prompt}. You MUST show this prompt to the user and use only their reply as user_input.confirmation; do not assume or invent it.`;
+            result['user_input'] = { prompt };
+        }
+        else if (proofType === 'comment') {
+            const minLength = proof.comment?.min_length || 10;
+            result['description'] = `Provide a verification comment (minimum ${minLength} characters) that genuinely summarises what was done in this step; do not paste unrelated text.`;
+            result['comment'] = { min_length: minLength };
+        }
+        return result;
+    })() : {
+        type: 'comment',
+        description: 'Provide a verification comment describing how you completed this step. Write a genuine summary; do not paste unrelated text.'
+    };
+    base['proof_hash'] = GENESIS_HASH;
+    return base;
+}
+export async function buildChallenge(memory, proof, options) {
+    const base = buildChallengeShapeForDisplay(proof);
+    if (memory?.memory_uuid) {
+        if (options?.existingNonce != null) {
+            base.nonce = options.existingNonce;
+        }
+        else {
+            const nonce = crypto.randomBytes(16).toString('hex');
+            await proofOfWorkStore.setNonce(memory.memory_uuid, nonce);
+            base.nonce = nonce;
+        }
+    }
+    return base;
+}
+/** @alias Backward compatibility alias (deprecated - use buildChallenge) */
+export const buildProofOfWorkRequired = buildChallenge;
+export async function tryUserInputElicitation(server, memory, solution, requestedUri, buildCurrentStep) {
+    if (memory.proof_of_work?.type !== 'user_input' || solution?.user_input?.confirmation) {
+        return { solution };
+    }
+    const lowLevel = server.server;
+    const caps = lowLevel?.getClientCapabilities?.();
+    if (caps?.elicitation == null || typeof lowLevel?.elicitInput !== 'function') {
+        return { solution };
+    }
+    const prompt = memory.proof_of_work.user_input?.prompt || 'Confirm completion';
+    try {
+        const elicitResult = await lowLevel.elicitInput({
+            message: prompt,
+            requestedSchema: {
+                type: 'object',
+                properties: { confirmation: { type: 'string', enum: ['approved', 'rejected'], description: 'Confirm or reject' } },
+                required: ['confirmation']
+            }
+        });
+        if (elicitResult?.action === 'accept' && elicitResult?.content?.confirmation) {
+            return { solution: { ...solution, type: 'user_input', user_input: { confirmation: elicitResult.content.confirmation, timestamp: new Date().toISOString() } } };
+        }
+        const challenge = await buildChallenge(memory, memory.proof_of_work);
+        const current_step = buildCurrentStep(memory, requestedUri);
+        if (elicitResult?.action === 'decline') {
+            return { payload: buildErrorPayload(memory, current_step, challenge, 'User declined confirmation.', 'USER_DECLINED', 1) };
+        }
+        return { payload: buildErrorPayload(memory, current_step, challenge, 'User cancelled or did not confirm.', 'USER_DECLINED', 1) };
+    }
+    catch (err) {
+        const challenge = await buildChallenge(memory, memory.proof_of_work);
+        return { payload: buildErrorPayload(memory, buildCurrentStep(memory, requestedUri), challenge, err instanceof Error ? err.message : 'Elicitation failed.', 'ELICITATION_FAILED', 1) };
+    }
+}
+/**
+ * Build an error response payload with two-phase retry escalation.
+ * Retries 1-3: must_obey true with recovery next_action.
+ * After 3: must_obey false with autonomous options.
+ */
+function buildErrorPayload(memory, current_step, challenge, message, errorCode, retryCount) {
+    const uuid = memory?.memory_uuid;
+    const uri = uuid ? `kairos://mem/${uuid}` : '';
+    const maxExceeded = retryCount >= MAX_RETRIES;
+    const payload = {
+        must_obey: !maxExceeded,
+        current_step,
+        challenge,
+        message: maxExceeded
+            ? `Step failed ${retryCount} times. Use your judgment to recover.`
+            : message,
+        error_code: maxExceeded ? 'MAX_RETRIES_EXCEEDED' : errorCode,
+        retry_count: retryCount
+    };
+    if (maxExceeded && uri) {
+        payload.next_action = `Options: (1) call kairos_update with ${uri} to fix the step for future executions (2) call kairos_attest with ${uri} and outcome failure to abort (3) ask the user for help`;
+    }
+    else if (uri) {
+        payload.next_action = `retry kairos_next with ${uri} -- use nonce and proof_hash from THIS response's challenge`;
+    }
+    return payload;
+}
+export async function handleProofSubmission(submission, memory, options) {
+    if (!memory?.proof_of_work) {
+        return {};
+    }
+    const uuid = memory.memory_uuid;
+    const proofType = submission.type || 'shell';
+    const requiredType = memory.proof_of_work.type || 'shell';
+    // Accept both proof_hash (v2) and previousProofHash (v1 compat)
+    const submittedProofHash = submission.proof_hash ?? submission.previousProofHash;
+    // Build error with retry counting; reuse existing nonce so we don't reset retry key. For step 2+, set
+    // challenge.proof_hash to expectedPreviousHash so the client can echo it back (avoids PROOF_HASH_MISMATCH on retry).
+    const blocked = async (msg, code, currentStep, challengeObj) => {
+        const storedNonce = await proofOfWorkStore.getNonce(memory.memory_uuid);
+        const retryKey = storedNonce ?? uuid;
+        const retryCount = await proofOfWorkStore.incrementRetry(retryKey);
+        const cs = currentStep || { uri: `kairos://mem/${uuid}`, content: '', mimeType: 'text/markdown' };
+        let ch = challengeObj ||
+            (storedNonce != null
+                ? await buildChallenge(memory, memory.proof_of_work, { existingNonce: storedNonce })
+                : await buildChallenge(memory, memory.proof_of_work));
+        if (options?.expectedPreviousHash != null) {
+            ch = { ...ch, proof_hash: options.expectedPreviousHash };
+        }
+        return {
+            blockedPayload: buildErrorPayload(memory, cs, ch, msg, code, retryCount)
+        };
+    };
+    // Nonce validation
+    if (memory.memory_uuid) {
+        const storedNonce = await proofOfWorkStore.getNonce(memory.memory_uuid);
+        if (storedNonce != null) {
+            if (submission.nonce !== storedNonce) {
+                return blocked('Nonce mismatch. Use the nonce from the current step challenge.', 'NONCE_MISMATCH');
+            }
+        }
+    }
+    // Proof hash validation
+    if (options?.expectedPreviousHash != null && submittedProofHash !== undefined) {
+        if (submittedProofHash !== options.expectedPreviousHash) {
+            return blocked('proof_hash mismatch. Use proof_hash from the previous response or challenge.', 'PROOF_HASH_MISMATCH');
+        }
+    }
+    if (options?.expectedPreviousHash != null && submittedProofHash === undefined) {
+        return blocked('Include proof_hash in solution (use challenge.proof_hash for step 1).', 'MISSING_FIELD');
+    }
+    // Type validation
+    if (proofType !== requiredType && requiredType !== undefined) {
+        return blocked(`Expected proof type: ${requiredType}, got: ${proofType}`, 'TYPE_MISMATCH');
+    }
+    // Build result record
+    const record = {
+        result_id: `pow_${uuid}_${Date.now()}`,
+        type: proofType,
+        status: 'success',
+        executed_at: new Date().toISOString()
+    };
+    if (proofType === 'shell') {
+        const shell = submission.shell;
+        if (!shell) {
+            return blocked('Shell proof requires shell field with exit_code', 'MISSING_FIELD');
+        }
+        record.status = shell.exit_code === 0 ? 'success' : 'failed';
+        record.shell = {
+            exit_code: shell.exit_code,
+            ...(shell.stdout !== undefined && { stdout: shell.stdout }),
+            ...(shell.stderr !== undefined && { stderr: shell.stderr }),
+            ...(shell.duration_seconds !== undefined && { duration_seconds: shell.duration_seconds })
+        };
+        record.exit_code = shell.exit_code;
+        if (shell.stdout !== undefined)
+            record.stdout = shell.stdout;
+        if (shell.stderr !== undefined)
+            record.stderr = shell.stderr;
+        if (shell.duration_seconds !== undefined)
+            record.duration_seconds = shell.duration_seconds;
+    }
+    else if (proofType === 'mcp') {
+        const mcp = submission.mcp;
+        if (!mcp) {
+            return blocked('MCP proof requires mcp field', 'MISSING_FIELD');
+        }
+        record.status = mcp.success ? 'success' : 'failed';
+        record.mcp = {
+            tool_name: mcp.tool_name,
+            arguments: mcp.arguments,
+            result: mcp.result,
+            success: mcp.success
+        };
+    }
+    else if (proofType === 'user_input') {
+        const userInput = submission.user_input;
+        if (!userInput || !userInput.confirmation) {
+            return blocked('User input proof requires user_input.confirmation', 'MISSING_FIELD');
+        }
+        record.status = 'success';
+        record.user_input = {
+            confirmation: userInput.confirmation,
+            timestamp: userInput.timestamp || new Date().toISOString()
+        };
+    }
+    else if (proofType === 'comment') {
+        const comment = submission.comment;
+        if (!comment || !comment.text) {
+            return blocked('Comment proof requires comment.text', 'MISSING_FIELD');
+        }
+        const minLength = memory.proof_of_work.comment?.min_length || 10;
+        if (comment.text.length < minLength) {
+            return blocked(`Comment must be at least ${minLength} characters`, 'COMMENT_TOO_SHORT');
+        }
+        // Semantic validation
+        const stepContent = extractMemoryBody(memory.text) || String(memory.label || '').trim();
+        if (stepContent.length >= 20) {
+            try {
+                const [commentEmb, stepEmb] = await Promise.all([
+                    embeddingService.generateEmbedding(comment.text.trim()),
+                    embeddingService.generateEmbedding(stepContent.slice(0, 8000))
+                ]);
+                const similarity = embeddingService.calculateCosineSimilarity(commentEmb.embedding, stepEmb.embedding);
+                if (similarity < COMMENT_SEMANTIC_THRESHOLD) {
+                    return blocked(`Comment does not appear relevant to this step (similarity ${similarity.toFixed(2)} < ${COMMENT_SEMANTIC_THRESHOLD}). Provide a response that engages with the step content.`, 'COMMENT_IRRELEVANT');
+                }
+            }
+            catch (_err) {
+                // Fail open: if embedding unavailable, allow length-valid comments
+            }
+        }
+        record.status = 'success';
+        record.comment = { text: comment.text };
+    }
+    // Idempotency: if we already have a successful result for this step, return existing hash and skip re-saving (avoids double quality update)
+    const existing = await proofOfWorkStore.getResult(uuid);
+    if (existing?.status === 'success') {
+        const proofHash = await proofOfWorkStore.getProofHash(uuid);
+        return proofHash ? { proofHash, alreadyRecorded: true } : { proofHash: hashProofRecord(record) };
+    }
+    await proofOfWorkStore.saveResult(uuid, record);
+    const proofHash = hashProofRecord(record);
+    await proofOfWorkStore.setProofHash(uuid, proofHash);
+    if (memory.proof_of_work.required && record.status === 'failed') {
+        return blocked('Proof of work failed. Fix and retry.', 'COMMAND_FAILED');
+    }
+    // Success -- reset retry counter for this challenge instance
+    const storedNonce = await proofOfWorkStore.getNonce(memory.memory_uuid);
+    const retryKey = storedNonce ?? uuid;
+    await proofOfWorkStore.resetRetry(retryKey);
+    return { proofHash };
+}
+//# sourceMappingURL=kairos_next-pow-helpers.js.map

package/dist/tools/kairos_next-pow-helpers.js.map

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

package/dist/tools/kairos_next-previous-step.d.ts

@@ -0,0 +1,36 @@
+/**
+ * MISSING_PROOF fix: when the requested step has no proof_of_work, apply the solution to the previous step.
+ * Shared by MCP (kairos_next) and HTTP (http-api-next).
+ */
+import type { Memory } from '../types/memory.js';
+import type { QdrantService } from '../services/qdrant/service.js';
+import { type ProofOfWorkSubmission, type HandleProofResult } from './kairos_next-pow-helpers.js';
+export type PreviousProofBlock = {
+    message: string;
+    error_code: string;
+    next_action?: string;
+};
+export type TryApplyToPreviousResult = {
+    applied: true;
+    outcome: HandleProofResult;
+    prevMemory: Memory;
+} | {
+    applied: false;
+};
+/**
+ * If the requested step has no proof_of_work and the previous step has required proof, validate and store
+ * the solution against the previous step. Returns { applied: true, outcome, prevMemory } when applied
+ * (caller must then check ensurePreviousProofCompleted and build response), or { applied: false }.
+ */
+export declare function tryApplySolutionToPreviousStep(memory: Memory, solution: ProofOfWorkSubmission, loadMemory: (uuid: string) => Promise<Memory | null>, qdrantService: QdrantService | undefined): Promise<TryApplyToPreviousResult>;
+/**
+ * PROOF_HASH_MISMATCH fix: when the client calls kairos_next with the URI from next_action (the *next*
+ * step), they are submitting the solution for the step we just showed (the previous step). If the
+ * requested step has proof_of_work but the previous step has none stored yet and the solution type
+ * matches the previous step's challenge, apply the solution to the previous step and return applied.
+ * This prevents PROOF_HASH_MISMATCH because we expect the hash from the previous response, not
+ * the hash of the previous step (which is not stored yet).
+ */
+export declare function tryApplySolutionToPreviousStepWhenSolutionMatchesPrevious(requestedMemory: Memory, solution: ProofOfWorkSubmission, loadMemory: (uuid: string) => Promise<Memory | null>, qdrantService: QdrantService | undefined): Promise<TryApplyToPreviousResult>;
+export declare function ensurePreviousProofCompleted(memory: Memory, loadMemory: (uuid: string) => Promise<Memory | null>, qdrantService: QdrantService | undefined): Promise<PreviousProofBlock | null>;
+//# sourceMappingURL=kairos_next-previous-step.d.ts.map

package/dist/tools/kairos_next-previous-step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kairos_next-previous-step.d.ts","sourceRoot":"","sources":["../../src/tools/kairos_next-previous-step.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,EAAuC,KAAK,qBAAqB,EAAE,KAAK,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEvI,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAChC;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,iBAAiB,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACjE;IAAE,OAAO,EAAE,KAAK,CAAA;CAAE,CAAC;AAEvB;;;;GAIG;AACH,wBAAsB,8BAA8B,CAClD,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,qBAAqB,EAC/B,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,EACpD,aAAa,EAAE,aAAa,GAAG,SAAS,GACvC,OAAO,CAAC,wBAAwB,CAAC,CAkBnC;AAED;;;;;;;GAOG;AACH,wBAAsB,yDAAyD,CAC7E,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,qBAAqB,EAC/B,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,EACpD,aAAa,EAAE,aAAa,GAAG,SAAS,GACvC,OAAO,CAAC,wBAAwB,CAAC,CA0BnC;AAED,wBAAsB,4BAA4B,CAChD,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,EACpD,aAAa,EAAE,aAAa,GAAG,SAAS,GACvC,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CA2CpC"}

package/dist/tools/kairos_next-previous-step.js

@@ -0,0 +1,121 @@
+/**
+ * MISSING_PROOF fix: when the requested step has no proof_of_work, apply the solution to the previous step.
+ * Shared by MCP (kairos_next) and HTTP (http-api-next).
+ */
+import { resolveChainPreviousStep } from '../services/chain-utils.js';
+import { proofOfWorkStore } from '../services/proof-of-work-store.js';
+import { handleProofSubmission, GENESIS_HASH } from './kairos_next-pow-helpers.js';
+/**
+ * If the requested step has no proof_of_work and the previous step has required proof, validate and store
+ * the solution against the previous step. Returns { applied: true, outcome, prevMemory } when applied
+ * (caller must then check ensurePreviousProofCompleted and build response), or { applied: false }.
+ */
+export async function tryApplySolutionToPreviousStep(memory, solution, loadMemory, qdrantService) {
+    if (memory.proof_of_work)
+        return { applied: false };
+    const prevInfo = await resolveChainPreviousStep(memory, qdrantService);
+    const prevMemory = prevInfo?.uuid ? await loadMemory(prevInfo.uuid) : null;
+    if (!prevMemory?.proof_of_work?.required)
+        return { applied: false };
+    const prevIsStep1 = !prevMemory.chain || prevMemory.chain.step_index <= 1;
+    const expectedPrevHash = prevIsStep1
+        ? GENESIS_HASH
+        : (await (async () => {
+            const p = await resolveChainPreviousStep(prevMemory, qdrantService);
+            return p?.uuid ? await proofOfWorkStore.getProofHash(p.uuid) : null;
+        })()) ?? GENESIS_HASH;
+    const outcome = await handleProofSubmission(solution, prevMemory, {
+        expectedPreviousHash: expectedPrevHash
+    });
+    return { applied: true, outcome, prevMemory };
+}
+/**
+ * PROOF_HASH_MISMATCH fix: when the client calls kairos_next with the URI from next_action (the *next*
+ * step), they are submitting the solution for the step we just showed (the previous step). If the
+ * requested step has proof_of_work but the previous step has none stored yet and the solution type
+ * matches the previous step's challenge, apply the solution to the previous step and return applied.
+ * This prevents PROOF_HASH_MISMATCH because we expect the hash from the previous response, not
+ * the hash of the previous step (which is not stored yet).
+ */
+export async function tryApplySolutionToPreviousStepWhenSolutionMatchesPrevious(requestedMemory, solution, loadMemory, qdrantService) {
+    if (!requestedMemory.proof_of_work)
+        return { applied: false };
+    const prevInfo = await resolveChainPreviousStep(requestedMemory, qdrantService);
+    if (!prevInfo?.uuid)
+        return { applied: false };
+    const prevMemory = await loadMemory(prevInfo.uuid);
+    if (!prevMemory?.proof_of_work?.required)
+        return { applied: false };
+    const storedResult = await proofOfWorkStore.getResult(prevInfo.uuid);
+    if (storedResult)
+        return { applied: false };
+    const requiredType = prevMemory.proof_of_work.type || 'shell';
+    const solutionType = solution.type || 'shell';
+    if (solutionType !== requiredType)
+        return { applied: false };
+    const prevIsStep1 = !prevMemory.chain || prevMemory.chain.step_index <= 1;
+    const expectedPrevHash = prevIsStep1
+        ? GENESIS_HASH
+        : (await (async () => {
+            const p = await resolveChainPreviousStep(prevMemory, qdrantService);
+            return p?.uuid ? await proofOfWorkStore.getProofHash(p.uuid) : null;
+        })()) ?? GENESIS_HASH;
+    const outcome = await handleProofSubmission(solution, prevMemory, {
+        expectedPreviousHash: expectedPrevHash
+    });
+    return { applied: true, outcome, prevMemory };
+}
+export async function ensurePreviousProofCompleted(memory, loadMemory, qdrantService) {
+    if (!memory?.chain || memory.chain.step_index <= 1)
+        return null;
+    const previous = await resolveChainPreviousStep(memory, qdrantService);
+    if (!previous?.uuid)
+        return null;
+    const prevMemory = await loadMemory(previous.uuid);
+    const prevProof = prevMemory?.proof_of_work;
+    if (!prevProof || !prevProof.required)
+        return null;
+    const storedResult = await proofOfWorkStore.getResult(previous.uuid);
+    if (!storedResult) {
+        const proofType = prevProof.type || 'shell';
+        const stepLabel = prevMemory?.label || 'previous step';
+        const prevStepUri = `kairos://mem/${previous.uuid}`;
+        let message = `Proof of work missing for ${stepLabel}.`;
+        let next_action;
+        if (proofType === 'shell') {
+            const cmd = prevProof.shell?.cmd || prevProof.cmd || 'the required command';
+            message += ` Execute "${cmd}" and report the result before continuing.`;
+            next_action = `Execute "${prevProof.shell?.cmd || prevProof.cmd || cmd}", then call kairos_next with ${prevStepUri} and solution matching that step's challenge.`;
+        }
+        else if (proofType === 'user_input') {
+            const prompt = prevProof.user_input?.prompt || 'Confirm (see step content).';
+            message += ` For user_input you must obtain the user's actual reply — do not infer or invent. Submit that proof by calling kairos_next with ${prevStepUri} and solution.user_input.confirmation.`;
+            next_action = `Ask the user: "${prompt}" then call kairos_next with ${prevStepUri} and solution.user_input.confirmation set to their reply.`;
+        }
+        else if (proofType === 'mcp') {
+            const toolName = prevProof.mcp?.tool_name || 'the required tool';
+            message += ` Submit that proof by calling kairos_next with ${prevStepUri} and solution.mcp. Call the MCP tool "${toolName}" and report its real result; do not fabricate.`;
+            next_action = `Call ${toolName}, then call kairos_next with ${prevStepUri} and solution.mcp with the real result.`;
+        }
+        else if (proofType === 'comment') {
+            const minLen = prevProof.comment?.min_length ?? 10;
+            message += ` Submit that proof by calling kairos_next with ${prevStepUri} and solution.comment.text (min ${minLen} chars). Write a genuine summary of what was done; do not paste unrelated text.`;
+            next_action = `call kairos_next with ${prevStepUri} and solution.comment.text (min ${minLen} chars).`;
+        }
+        else {
+            message += ` Complete the required ${proofType} verification before continuing.`;
+            next_action = `call kairos_next with ${prevStepUri} -- complete previous step first`;
+        }
+        if (!next_action)
+            next_action = `call kairos_next with ${prevStepUri} -- complete previous step first`;
+        const block = { message, error_code: 'MISSING_PROOF' };
+        if (next_action !== undefined)
+            block.next_action = next_action;
+        return block;
+    }
+    if (storedResult.status !== 'success') {
+        return { message: 'Previous step proof failed. Fix and retry.', error_code: 'COMMAND_FAILED' };
+    }
+    return null;
+}
+//# sourceMappingURL=kairos_next-previous-step.js.map

package/dist/tools/kairos_next-previous-step.js.map

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

package/dist/tools/kairos_next.d.ts

@@ -0,0 +1,12 @@
+import type { MemoryQdrantStore } from '../services/memory/store.js';
+import type { QdrantService } from '../services/qdrant/service.js';
+import type { Memory } from '../types/memory.js';
+interface RegisterNextOptions {
+    toolName?: string;
+    qdrantService?: QdrantService;
+}
+/** Update quality_metadata and quality_metrics for the completed step. Log and continue on error; do not fail the request. Shared by MCP and HTTP kairos_next. */
+export declare function updateStepQuality(qdrantService: QdrantService, memory: Memory, outcome: 'success' | 'failure', tenantId: string): Promise<void>;
+export declare function registerKairosNextTool(server: any, memoryStore: MemoryQdrantStore, options?: RegisterNextOptions): void;
+export {};
+//# sourceMappingURL=kairos_next.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"kairos_next.d.ts","sourceRoot":"","sources":["../../src/tools/kairos_next.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAErE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAMnE,OAAO,KAAK,EAAE,MAAM,EAAyB,MAAM,oBAAoB,CAAC;AAUxE,UAAU,mBAAmB;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AA4DD,kKAAkK;AAClK,wBAAsB,iBAAiB,CACrC,aAAa,EAAE,aAAa,EAC5B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,SAAS,GAAG,SAAS,EAC9B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAsCf;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,iBAAiB,EAAE,OAAO,GAAE,mBAAwB,QA6NpH"}