@squadrules/mcp 4.8.6

package/dist/tools/next.js

@@ -0,0 +1,205 @@
+import { structuredLogger } from '../utils/structured-logger.js';
+import { resolveAdapterNextLayer, resolveAdapterPreviousLayer } from '../services/adapter-navigation.js';
+import { getInferenceContract } from '../services/memory/memory-accessors.js';
+import { redisCacheService } from '../services/redis-cache.js';
+import { extractMemoryBody } from '../utils/memory-body.js';
+import { proofOfWorkStore } from '../services/proof-of-work-store.js';
+import { buildChallenge, handleProofSubmission, GENESIS_HASH } from './next-pow-helpers.js';
+import { tryApplySolutionToPreviousStep, tryApplySolutionToPreviousStepWhenSolutionMatchesPrevious, ensurePreviousProofCompleted } from './next-previous-step.js';
+import { buildMissingProofPayload } from './next-missing-proof-payload.js';
+import { modelStats } from '../services/stats/model-stats.js';
+import { kairosQualityUpdateErrors } from '../services/metrics/mcp-metrics.js';
+import { buildLayerUri, parseKairosUri } from './kairos-uri.js';
+import { KAIROS_LOCAL_ARTIFACT_DIRS } from '../config.js';
+import { buildLocalArtifactDirFields } from './local-artifact-dir-contract.js';
+async function loadMemoryWithCache(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;
+}
+function normalizeLayerUri(value) {
+    const parsed = parseKairosUri(value);
+    if (parsed.kind !== 'layer') {
+        throw new Error('Invalid KAIROS URI. next expects a layer URI.');
+    }
+    return {
+        uuid: parsed.id,
+        uri: parsed.raw,
+        ...(parsed.executionId ? { executionId: parsed.executionId } : {})
+    };
+}
+function buildCurrentStep(memory, requestedUri, executionId) {
+    const uri = memory ? buildLayerUri(memory.memory_uuid, executionId) : requestedUri;
+    const content = memory ? extractMemoryBody(memory.text) : '';
+    return {
+        uri,
+        content,
+        mimeType: 'text/markdown'
+    };
+}
+async function buildNextPayload(memory, requestedUri, nextStepId, proof, executionId) {
+    const current_step = buildCurrentStep(memory, requestedUri, executionId);
+    const challenge = await buildChallenge(memory, proof);
+    const payload = {
+        must_obey: true,
+        current_step,
+        challenge,
+        ...buildLocalArtifactDirFields(KAIROS_LOCAL_ARTIFACT_DIRS)
+    };
+    if (nextStepId) {
+        payload.next_action = `call forward with ${buildLayerUri(nextStepId, executionId)} and solution.type="${challenge.type}" plus solution.${challenge.type}`;
+    }
+    else {
+        payload.message = 'Adapter layers complete. Call reward to finalize.';
+        payload.next_action = `call reward with ${requestedUri} and outcome (success or failure) and feedback to complete the adapter`;
+    }
+    return payload;
+}
+/** Update quality_metadata and quality_metrics for the completed step. Log and continue on error; do not fail the request. Shared by the forward bridge and the older HTTP next route. */
+export async function updateStepQuality(qdrantService, memory, outcome, tenantId) {
+    try {
+        const qdrantUuid = memory.memory_uuid;
+        const currentPoint = await qdrantService.retrieveById(qdrantUuid);
+        const payload = currentPoint?.payload;
+        const label = payload?.['label'] || 'Knowledge step';
+        const domain = payload?.['domain'] || 'general';
+        const task = payload?.['task'] || 'general';
+        const type = payload?.['type'] || 'context';
+        const tags = Array.isArray(payload?.['tags']) ? payload['tags'] : [];
+        const metricsUpdate = {
+            retrievalCount: 1,
+            successCount: outcome === 'success' ? 1 : 0,
+            failureCount: outcome === 'failure' ? 1 : 0,
+            lastRated: new Date().toISOString(),
+            lastRater: 'forward',
+            qualityBonus: outcome === 'success' ? 1 : -0.2
+        };
+        await qdrantService.updateQualityMetrics(qdrantUuid, metricsUpdate);
+        const updatedQualityMetadata = modelStats.calculateStepQualityMetadata(label, domain, task, type, tags, outcome);
+        await qdrantService.updateQualityMetadata(qdrantUuid, {
+            step_quality_score: updatedQualityMetadata.step_quality_score,
+            step_quality: updatedQualityMetadata.step_quality
+        });
+        structuredLogger.debug(`forward: Updated quality for ${memory.memory_uuid} outcome=${outcome}`);
+    }
+    catch (error) {
+        kairosQualityUpdateErrors.inc({ tenant_id: tenantId });
+        structuredLogger.warn(`forward: Quality update failed for ${memory.memory_uuid}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Shared execute: submit solution and return next step/challenge. Used by the forward bridge and the older HTTP route.
+ * When tryElicit is provided, user_input elicitation may return a payload or adjusted solution.
+ */
+async function _executeNext(memoryStore, qdrantService, input, tenantId, options) {
+    const { uri, solution } = input;
+    const { uuid, uri: requestedUri, executionId } = normalizeLayerUri(uri);
+    const memory = await loadMemoryWithCache(memoryStore, uuid);
+    let solutionToUse = solution;
+    if (memory && options?.tryElicit) {
+        const elicitResult = await options.tryElicit(memory, solution, requestedUri);
+        if ('payload' in elicitResult)
+            return elicitResult.payload;
+        solutionToUse = elicitResult.solution;
+    }
+    let submissionOutcome;
+    if (memory) {
+        const memoryContract = getInferenceContract(memory);
+        if (!memoryContract && solutionToUse) {
+            const prevResult = await tryApplySolutionToPreviousStep(memory, solutionToUse, (id) => loadMemoryWithCache(memoryStore, id), qdrantService);
+            if (prevResult.applied) {
+                if (prevResult.outcome.blockedPayload) {
+                    if (qdrantService)
+                        await updateStepQuality(qdrantService, prevResult.prevMemory, 'failure', tenantId);
+                    return prevResult.outcome.blockedPayload;
+                }
+                const previousBlock = await ensurePreviousProofCompleted(memory, (id) => loadMemoryWithCache(memoryStore, id), qdrantService, executionId);
+                if (!previousBlock && qdrantService && !prevResult.outcome.alreadyRecorded) {
+                    await updateStepQuality(qdrantService, prevResult.prevMemory, 'success', tenantId);
+                }
+                if (!previousBlock) {
+                    const nextFromRequested = await resolveAdapterNextLayer(memory, qdrantService);
+                    const nextStepId = nextFromRequested?.uuid ?? null;
+                    const output = (await buildNextPayload(memory, requestedUri, nextStepId, undefined, executionId));
+                    if (prevResult.outcome.proofHash)
+                        output.proof_hash = prevResult.outcome.proofHash;
+                    return output;
+                }
+            }
+        }
+        if (memoryContract && solutionToUse) {
+            const prevResultWhenMatch = await tryApplySolutionToPreviousStepWhenSolutionMatchesPrevious(memory, solutionToUse, (id) => loadMemoryWithCache(memoryStore, id), qdrantService);
+            if (prevResultWhenMatch.applied) {
+                if (prevResultWhenMatch.outcome.blockedPayload) {
+                    if (qdrantService)
+                        await updateStepQuality(qdrantService, prevResultWhenMatch.prevMemory, 'failure', tenantId);
+                    return prevResultWhenMatch.outcome.blockedPayload;
+                }
+                if (qdrantService && !prevResultWhenMatch.outcome.alreadyRecorded) {
+                    await updateStepQuality(qdrantService, prevResultWhenMatch.prevMemory, 'success', tenantId);
+                }
+                const nextFromRequested = await resolveAdapterNextLayer(memory, qdrantService);
+                const nextStepId = nextFromRequested?.uuid ?? null;
+                const nextMemory = nextFromRequested ? await loadMemoryWithCache(memoryStore, nextFromRequested.uuid) : null;
+                const challengeProof = (nextMemory ? getInferenceContract(nextMemory) : undefined) ?? memoryContract;
+                const output = (await buildNextPayload(memory, requestedUri, nextStepId, challengeProof, executionId));
+                if (prevResultWhenMatch.outcome.proofHash)
+                    output.proof_hash = prevResultWhenMatch.outcome.proofHash;
+                return output;
+            }
+        }
+        const isStep1 = !memory.adapter || memory.adapter.layer_index <= 1;
+        let expectedPreviousHash;
+        if (isStep1) {
+            expectedPreviousHash = GENESIS_HASH;
+        }
+        else {
+            const previous = await resolveAdapterPreviousLayer(memory, qdrantService);
+            const prevHash = previous?.uuid ? await proofOfWorkStore.getProofHash(previous.uuid) : null;
+            expectedPreviousHash = prevHash ?? GENESIS_HASH;
+        }
+        submissionOutcome = await handleProofSubmission(solutionToUse, memory, { expectedPreviousHash });
+        if (submissionOutcome.blockedPayload) {
+            if (qdrantService)
+                await updateStepQuality(qdrantService, memory, 'failure', tenantId);
+            return submissionOutcome.blockedPayload;
+        }
+        const previousBlock = await ensurePreviousProofCompleted(memory, (id) => loadMemoryWithCache(memoryStore, id), qdrantService, executionId);
+        if (previousBlock) {
+            if (qdrantService)
+                await updateStepQuality(qdrantService, memory, 'failure', tenantId);
+            const payload = await buildMissingProofPayload(memory, previousBlock, requestedUri, uuid, (id) => loadMemoryWithCache(memoryStore, id), qdrantService, executionId);
+            return {
+                must_obey: payload.retry_count < 3,
+                current_step: payload.current_step,
+                challenge: payload.challenge,
+                ...buildLocalArtifactDirFields(KAIROS_LOCAL_ARTIFACT_DIRS),
+                message: previousBlock.message,
+                next_action: payload.next_action,
+                error_code: previousBlock.error_code || 'MISSING_PROOF',
+                retry_count: payload.retry_count
+            };
+        }
+        if (qdrantService && !submissionOutcome.alreadyRecorded) {
+            await updateStepQuality(qdrantService, memory, 'success', tenantId);
+        }
+    }
+    const nextStepInfo = memory ? await resolveAdapterNextLayer(memory, qdrantService) : undefined;
+    const nextMemory = nextStepInfo ? await loadMemoryWithCache(memoryStore, nextStepInfo.uuid) : null;
+    const displayMemory = nextMemory ?? memory ?? null;
+    const challengeProof = displayMemory ? getInferenceContract(displayMemory) : undefined;
+    const displayUri = nextStepInfo ? buildLayerUri(nextStepInfo.uuid, executionId) : requestedUri;
+    const nextFromDisplay = displayMemory ? await resolveAdapterNextLayer(displayMemory, qdrantService) : undefined;
+    const nextStepId = nextFromDisplay?.uuid ?? null;
+    const output = (await buildNextPayload(displayMemory, displayUri, nextStepId, challengeProof, executionId));
+    if (submissionOutcome?.proofHash)
+        output.proof_hash = submissionOutcome.proofHash;
+    return output;
+}
+//# sourceMappingURL=next.js.map

package/dist/tools/next.js.map

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

package/dist/tools/next_schema.d.ts

@@ -0,0 +1,148 @@
+/**
+ * Step-engine input/output schemas used by the forward runtime.
+ * V2: removed next_step, protocol_status, attest_required, final_challenge.
+ * Renamed genesis_hash -> proof_hash, previousProofHash -> proof_hash, last_proof_hash -> proof_hash.
+ * Added error_code and retry_count for two-phase retry escalation.
+ */
+import { z } from 'zod';
+declare const layerUriSchema: z.ZodString;
+export declare const solutionSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        shell: "shell";
+        mcp: "mcp";
+        user_input: "user_input";
+        comment: "comment";
+    }>;
+    nonce: z.ZodOptional<z.ZodString>;
+    proof_hash: z.ZodOptional<z.ZodString>;
+    shell: z.ZodOptional<z.ZodObject<{
+        exit_code: z.ZodNumber;
+        stdout: z.ZodOptional<z.ZodString>;
+        stderr: z.ZodOptional<z.ZodString>;
+        duration_seconds: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    mcp: z.ZodOptional<z.ZodObject<{
+        tool_name: z.ZodString;
+        arguments: z.ZodOptional<z.ZodAny>;
+        result: z.ZodAny;
+        success: z.ZodBoolean;
+    }, z.core.$strip>>;
+    user_input: z.ZodOptional<z.ZodObject<{
+        confirmation: z.ZodString;
+        timestamp: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    comment: z.ZodOptional<z.ZodObject<{
+        text: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const challengeSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        shell: "shell";
+        mcp: "mcp";
+        user_input: "user_input";
+        comment: "comment";
+    }>;
+    description: z.ZodString;
+    nonce: z.ZodOptional<z.ZodString>;
+    proof_hash: z.ZodOptional<z.ZodString>;
+    shell: z.ZodOptional<z.ZodObject<{
+        cmd: z.ZodString;
+        timeout_seconds: z.ZodNumber;
+        interpreter: z.ZodOptional<z.ZodString>;
+        flags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        workdir: z.ZodOptional<z.ZodString>;
+        invocation_display: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    mcp: z.ZodOptional<z.ZodObject<{
+        tool_name: z.ZodString;
+        arguments: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        expected_result: z.ZodOptional<z.ZodAny>;
+    }, z.core.$strip>>;
+    user_input: z.ZodOptional<z.ZodObject<{
+        prompt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    comment: z.ZodOptional<z.ZodObject<{
+        min_length: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const nextInputSchema: z.ZodObject<{
+    uri: z.ZodString;
+    solution: z.ZodObject<{
+        type: z.ZodEnum<{
+            shell: "shell";
+            mcp: "mcp";
+            user_input: "user_input";
+            comment: "comment";
+        }>;
+        nonce: z.ZodOptional<z.ZodString>;
+        proof_hash: z.ZodOptional<z.ZodString>;
+        shell: z.ZodOptional<z.ZodObject<{
+            exit_code: z.ZodNumber;
+            stdout: z.ZodOptional<z.ZodString>;
+            stderr: z.ZodOptional<z.ZodString>;
+            duration_seconds: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        mcp: z.ZodOptional<z.ZodObject<{
+            tool_name: z.ZodString;
+            arguments: z.ZodOptional<z.ZodAny>;
+            result: z.ZodAny;
+            success: z.ZodBoolean;
+        }, z.core.$strip>>;
+        user_input: z.ZodOptional<z.ZodObject<{
+            confirmation: z.ZodString;
+            timestamp: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        comment: z.ZodOptional<z.ZodObject<{
+            text: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const nextOutputSchema: z.ZodObject<{
+    must_obey: z.ZodBoolean;
+    current_step: z.ZodNullable<z.ZodOptional<z.ZodObject<{
+        uri: z.ZodString;
+        content: z.ZodString;
+        mimeType: z.ZodLiteral<"text/markdown">;
+    }, z.core.$strip>>>;
+    challenge: z.ZodObject<{
+        type: z.ZodEnum<{
+            shell: "shell";
+            mcp: "mcp";
+            user_input: "user_input";
+            comment: "comment";
+        }>;
+        description: z.ZodString;
+        nonce: z.ZodOptional<z.ZodString>;
+        proof_hash: z.ZodOptional<z.ZodString>;
+        shell: z.ZodOptional<z.ZodObject<{
+            cmd: z.ZodString;
+            timeout_seconds: z.ZodNumber;
+            interpreter: z.ZodOptional<z.ZodString>;
+            flags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            workdir: z.ZodOptional<z.ZodString>;
+            invocation_display: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        mcp: z.ZodOptional<z.ZodObject<{
+            tool_name: z.ZodString;
+            arguments: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            expected_result: z.ZodOptional<z.ZodAny>;
+        }, z.core.$strip>>;
+        user_input: z.ZodOptional<z.ZodObject<{
+            prompt: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        comment: z.ZodOptional<z.ZodObject<{
+            min_length: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    next_action: z.ZodString;
+    proof_hash: z.ZodOptional<z.ZodString>;
+    message: z.ZodOptional<z.ZodString>;
+    error_code: z.ZodOptional<z.ZodString>;
+    retry_count: z.ZodOptional<z.ZodNumber>;
+    kairos_local_artifact_dir: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    squadrules_local_artifact_dir: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export { layerUriSchema };
+//# sourceMappingURL=next_schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"next_schema.d.ts","sourceRoot":"","sources":["../../src/tools/next_schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,QAAA,MAAM,cAAc,aAKjB,CAAC;AAEJ,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiC1B,CAAC;AAEF,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA0B1B,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAG1B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAuB3B,CAAC;AAEH,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/tools/next_schema.js

@@ -0,0 +1,99 @@
+/**
+ * Step-engine input/output schemas used by the forward runtime.
+ * V2: removed next_step, protocol_status, attest_required, final_challenge.
+ * Renamed genesis_hash -> proof_hash, previousProofHash -> proof_hash, last_proof_hash -> proof_hash.
+ * Added error_code and retry_count for two-phase retry escalation.
+ */
+import { z } from 'zod';
+const layerUriSchema = z
+    .string()
+    .regex(/^(?:kairos|squadrules):\/\/layer\/[0-9a-f-]{36}(?:\?execution_id=[0-9a-f-]{36})?$/i, 'must match kairos://layer/{uuid}[?execution_id={uuid}] (squadrules:// also accepted)');
+export const solutionSchema = z.object({
+    type: z.enum(['shell', 'mcp', 'user_input', 'comment']).describe('Must match challenge.type'),
+    nonce: z.string().optional().describe('Echo nonce from challenge'),
+    proof_hash: z.string().optional().describe('Echo proof_hash from previous challenge or response'),
+    shell: z.object({
+        exit_code: z.number(),
+        stdout: z.string().optional(),
+        stderr: z.string().optional(),
+        duration_seconds: z.number().optional()
+    }).optional(),
+    mcp: z.object({
+        tool_name: z.string(),
+        arguments: z.any().optional(),
+        result: z.any(),
+        success: z.boolean()
+    }).optional(),
+    user_input: z.object({
+        confirmation: z.string(),
+        timestamp: z.string().optional()
+    }).optional(),
+    comment: z.object({ text: z.string() }).optional()
+}).refine((data) => !!(data.shell || data.mcp || data.user_input || data.comment), { message: 'At least one type-specific field (shell, mcp, user_input, or comment) must be provided' }).refine((data) => {
+    if (data.type === 'shell' && !data.shell)
+        return false;
+    if (data.type === 'mcp' && !data.mcp)
+        return false;
+    if (data.type === 'user_input' && !data.user_input)
+        return false;
+    if (data.type === 'comment' && !data.comment)
+        return false;
+    return true;
+}, { message: 'The type-specific field must match the solution type' });
+export const challengeSchema = z.object({
+    type: z.enum(['shell', 'mcp', 'user_input', 'comment']),
+    description: z.string(),
+    nonce: z.string().optional().describe('Echo back as solution.nonce'),
+    proof_hash: z.string().optional().describe('Echo back as solution.proof_hash'),
+    shell: z.object({
+        cmd: z.string(),
+        timeout_seconds: z.number(),
+        interpreter: z.string().optional(),
+        flags: z.array(z.string()).optional(),
+        args: z.array(z.string()).optional(),
+        workdir: z.string().optional(),
+        /** Server-computed display line for agents/UI. */
+        invocation_display: z.string().optional()
+    }).optional(),
+    mcp: z.object({
+        tool_name: z.string(),
+        arguments: z.record(z.string(), z.unknown()).optional(),
+        expected_result: z.any().optional()
+    }).optional(),
+    user_input: z.object({
+        prompt: z.string().optional()
+    }).optional(),
+    comment: z.object({
+        min_length: z.number().optional()
+    }).optional()
+});
+export const nextInputSchema = z.object({
+    uri: layerUriSchema.describe('Current layer URI (from next_action of previous response)'),
+    solution: solutionSchema.describe('Proof matching challenge.type: shell/mcp/user_input/comment')
+});
+export const nextOutputSchema = z.object({
+    must_obey: z.boolean().describe('true for success and recoverable errors, false after max retries'),
+    current_step: z.object({
+        uri: layerUriSchema,
+        content: z.string(),
+        mimeType: z.literal('text/markdown')
+    }).optional().nullable(),
+    challenge: challengeSchema,
+    next_action: z.string().describe('Next tool call with embedded kairos://layer/ URI'),
+    proof_hash: z.string().optional().describe('Hash of proof just stored. Use as solution.proof_hash for next step.'),
+    message: z.string().optional(),
+    error_code: z.string().optional().describe('Machine-readable error code (e.g., NONCE_MISMATCH, MAX_RETRIES_EXCEEDED)'),
+    retry_count: z.number().optional().describe('Number of retries on this step (present on error responses)'),
+    /**
+     * Ordered URI hints (preferred first) for the run's local handoff dir. Resolve **on the client**:
+     * `project://<rel>` → `<client project root>/<rel>`; `user://<rel>` → `<client home or $XDG_CONFIG_HOME>/<rel>`.
+     * Use `project://` when you have exactly one project context; fall through to `user://` when your session
+     * spans multiple projects. Export the resolved absolute path as `KAIROS_LOCAL_ARTIFACT_DIR` for shell
+     * challenges. The server never resolves these to a path on its own filesystem.
+     */
+    kairos_local_artifact_dir: z.array(z.string()).optional(),
+    /** Compatibility alias for kairos_local_artifact_dir (same value). */
+    squadrules_local_artifact_dir: z.array(z.string()).optional()
+});
+export { layerUriSchema };
+//# sourceMappingURL=next_schema.js.map

package/dist/tools/next_schema.js.map

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

package/dist/tools/review-evidence-check.d.ts

@@ -0,0 +1,12 @@
+export interface ReviewEvidence {
+    verdict_file: string;
+    exit_code: number;
+    stdout: string;
+}
+/**
+ * Assert that review_evidence proves a PASS verdict from phase-critic.
+ * Throws TrainError on any failure so that the train error pipeline
+ * formats the response correctly.
+ */
+export declare function assertReviewEvidencePassed(evidence: ReviewEvidence | undefined): void;
+//# sourceMappingURL=review-evidence-check.d.ts.map

package/dist/tools/review-evidence-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-evidence-check.d.ts","sourceRoot":"","sources":["../../src/tools/review-evidence-check.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,cAAc,GAAG,SAAS,GAAG,IAAI,CAuBrF"}

package/dist/tools/review-evidence-check.js

@@ -0,0 +1,23 @@
+/**
+ * Shared review_evidence validation for train and tune.
+ * Extracted to keep per-file line counts within ESLint max-lines.
+ */
+import { TrainError } from './train-store.js';
+/**
+ * Assert that review_evidence proves a PASS verdict from phase-critic.
+ * Throws TrainError on any failure so that the train error pipeline
+ * formats the response correctly.
+ */
+export function assertReviewEvidencePassed(evidence) {
+    if (!evidence) {
+        throw new TrainError('REVIEW_EVIDENCE_REQUIRED', 'Adapter train requires review_evidence: run phase-critic first and provide the verdict file as proof.', { must_obey: true, next_action: 'call forward with kairos://adapter/phase-critic to run the phase-critic review' });
+    }
+    if (evidence.exit_code !== 0) {
+        throw new TrainError('REVIEW_GATE_FAILED', `Phase-critic review gate failed: exit_code ${evidence.exit_code} (expected 0). The adapter did not pass review.`, { must_obey: true, next_action: 'address phase-critic findings and re-invoke the review' });
+    }
+    const firstLine = evidence.stdout.split(/\r?\n/)[0]?.trim() ?? '';
+    if (!/^PASS$/i.test(firstLine)) {
+        throw new TrainError('REVIEW_GATE_FAILED', `Phase-critic review gate failed: verdict is "${firstLine}" (expected PASS). The adapter did not pass review.`, { must_obey: true, next_action: 'address phase-critic findings and re-invoke the review' });
+    }
+}
+//# sourceMappingURL=review-evidence-check.js.map

package/dist/tools/review-evidence-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-evidence-check.js","sourceRoot":"","sources":["../../src/tools/review-evidence-check.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAQ9C;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CAAC,QAAoC;IAC7E,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,UAAU,CAClB,0BAA0B,EAC1B,uGAAuG,EACvG,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,gFAAgF,EAAE,CACnH,CAAC;IACJ,CAAC;IACD,IAAI,QAAQ,CAAC,SAAS,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,UAAU,CAClB,oBAAoB,EACpB,8CAA8C,QAAQ,CAAC,SAAS,iDAAiD,EACjH,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,wDAAwD,EAAE,CAC3F,CAAC;IACJ,CAAC;IACD,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAClE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,UAAU,CAClB,oBAAoB,EACpB,gDAAgD,SAAS,qDAAqD,EAC9G,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,wDAAwD,EAAE,CAC3F,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/tools/reward.d.ts

@@ -0,0 +1,9 @@
+import type { QdrantService } from '../services/qdrant/service.js';
+import { type RewardInput, type RewardOutput } from './reward_schema.js';
+interface RegisterRewardOptions {
+    toolName?: string;
+}
+export declare function executeReward(qdrantService: QdrantService, input: RewardInput): Promise<RewardOutput>;
+export declare function registerRewardTool(server: any, qdrantService: QdrantService, options?: RegisterRewardOptions): void;
+export {};
+//# sourceMappingURL=reward.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reward.d.ts","sourceRoot":"","sources":["../../src/tools/reward.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAKnE,OAAO,EAAyC,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAQhH,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAWD,wBAAsB,aAAa,CACjC,aAAa,EAAE,aAAa,EAC5B,KAAK,EAAE,WAAW,GACjB,OAAO,CAAC,YAAY,CAAC,CAgFvB;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,GAAG,EAAE,aAAa,EAAE,aAAa,EAAE,OAAO,GAAE,qBAA0B,QA2ChH"}