@squadrules/mcp 4.8.6

package/dist/tools/local-artifact-dir-contract.js

@@ -0,0 +1,24 @@
+/**
+ * JSON field exposing the run's local handoff dir as ordered URI hints
+ * (`project://<rel>`, `user://<rel>`). The server never names a path on
+ * its own filesystem; the client resolves a hint to an absolute path on
+ * its own machine and exports it as `KAIROS_LOCAL_ARTIFACT_DIR` for shell
+ * challenges. Lowercase snake of the env var name on the client side.
+ */
+export const KAIROS_LOCAL_ARTIFACT_DIR_JSON_FIELD = 'kairos_local_artifact_dir';
+/**
+ * Compatibility alias emitted alongside the primary field so that clients
+ * adopting the SquadRules name can read either. Both fields always carry
+ * the same value.
+ */
+export const SQUADRULES_LOCAL_ARTIFACT_DIR_JSON_FIELD = 'squadrules_local_artifact_dir';
+export function buildLocalArtifactDirFields(hints) {
+    // Return a fresh mutable copy so schema-typed responses (z.array(z.string()))
+    // can hold the value; the source array is frozen at config parse time.
+    const copy = [...hints];
+    return {
+        [KAIROS_LOCAL_ARTIFACT_DIR_JSON_FIELD]: copy,
+        [SQUADRULES_LOCAL_ARTIFACT_DIR_JSON_FIELD]: [...copy]
+    };
+}
+//# sourceMappingURL=local-artifact-dir-contract.js.map

package/dist/tools/local-artifact-dir-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-artifact-dir-contract.js","sourceRoot":"","sources":["../../src/tools/local-artifact-dir-contract.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,oCAAoC,GAAG,2BAA2B,CAAC;AAEhF;;;;GAIG;AACH,MAAM,CAAC,MAAM,wCAAwC,GAAG,+BAA+B,CAAC;AAExF,MAAM,UAAU,2BAA2B,CACzC,KAAwB;IAExB,8EAA8E;IAC9E,uEAAuE;IACvE,MAAM,IAAI,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;IACxB,OAAO;QACL,CAAC,oCAAoC,CAAC,EAAE,IAAI;QAC5C,CAAC,wCAAwC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;KACtD,CAAC;AACJ,CAAC"}

package/dist/tools/mcp-contract-match.d.ts

@@ -0,0 +1,21 @@
+import type { ProofOfWorkDefinition } from '../types/memory.js';
+/** True for JSON-like objects (not null, not array). */
+export declare function isPlainMcpArgumentsObject(value: unknown): value is Record<string, unknown>;
+/**
+ * Contract value vs submission value: objects use subset semantics; arrays are fixed length with per-index matching; primitives use SameValue.
+ */
+export declare function mcpArgumentValuesMatch(contractValue: unknown, submissionValue: unknown): boolean;
+/** Every key in `contractArgs` must match the corresponding value in `submissionArgs`; extra submission keys allowed at each object level. */
+export declare function deepMcpArgumentSubset(contractArgs: Record<string, unknown>, submissionArgs: Record<string, unknown>): boolean;
+export type McpContractValidation = {
+    ok: true;
+} | {
+    ok: false;
+    code: 'MCP_TOOL_MISMATCH' | 'MCP_ARGUMENTS_MISMATCH' | 'MISSING_FIELD';
+    message: string;
+};
+export declare function validateMcpSubmissionAgainstContract(proof: ProofOfWorkDefinition, mcp: {
+    tool_name: string;
+    arguments?: unknown;
+}): McpContractValidation;
+//# sourceMappingURL=mcp-contract-match.d.ts.map

package/dist/tools/mcp-contract-match.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-contract-match.d.ts","sourceRoot":"","sources":["../../src/tools/mcp-contract-match.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAEhE,wDAAwD;AACxD,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE1F;AAOD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,OAAO,EAAE,eAAe,EAAE,OAAO,GAAG,OAAO,CAiBhG;AAED,8IAA8I;AAC9I,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAK7H;AAED,MAAM,MAAM,qBAAqB,GAC7B;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GACZ;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,mBAAmB,GAAG,wBAAwB,GAAG,eAAe,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3G,wBAAgB,oCAAoC,CAClD,KAAK,EAAE,qBAAqB,EAC5B,GAAG,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GAC9C,qBAAqB,CAoCvB"}

package/dist/tools/mcp-contract-match.js

@@ -0,0 +1,78 @@
+/** True for JSON-like objects (not null, not array). */
+export function isPlainMcpArgumentsObject(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function samePrimitive(a, b) {
+    if (a === b)
+        return true;
+    return Number.isNaN(a) && Number.isNaN(b);
+}
+/**
+ * Contract value vs submission value: objects use subset semantics; arrays are fixed length with per-index matching; primitives use SameValue.
+ */
+export function mcpArgumentValuesMatch(contractValue, submissionValue) {
+    if (Array.isArray(contractValue)) {
+        if (!Array.isArray(submissionValue) || contractValue.length !== submissionValue.length) {
+            return false;
+        }
+        return contractValue.every((cv, i) => mcpArgumentValuesMatch(cv, submissionValue[i]));
+    }
+    if (contractValue !== null && typeof contractValue === 'object') {
+        if (!isPlainMcpArgumentsObject(submissionValue))
+            return false;
+        const c = contractValue;
+        const s = submissionValue;
+        for (const key of Object.keys(c)) {
+            if (!mcpArgumentValuesMatch(c[key], s[key]))
+                return false;
+        }
+        return true;
+    }
+    return samePrimitive(contractValue, submissionValue);
+}
+/** Every key in `contractArgs` must match the corresponding value in `submissionArgs`; extra submission keys allowed at each object level. */
+export function deepMcpArgumentSubset(contractArgs, submissionArgs) {
+    for (const key of Object.keys(contractArgs)) {
+        if (!mcpArgumentValuesMatch(contractArgs[key], submissionArgs[key]))
+            return false;
+    }
+    return true;
+}
+export function validateMcpSubmissionAgainstContract(proof, mcp) {
+    if (proof.type !== 'mcp' || !proof.mcp) {
+        return { ok: true };
+    }
+    const expectedTool = proof.mcp.tool_name;
+    if (expectedTool !== undefined && expectedTool !== '' && mcp.tool_name !== expectedTool) {
+        return {
+            ok: false,
+            code: 'MCP_TOOL_MISMATCH',
+            message: `MCP tool_name must match the contract (expected "${expectedTool}", got "${mcp.tool_name}").`
+        };
+    }
+    if (proof.mcp.arguments !== undefined) {
+        if (mcp.arguments === undefined) {
+            return {
+                ok: false,
+                code: 'MISSING_FIELD',
+                message: 'MCP proof requires solution.evidence.arguments (object) because the contract specifies mcp.arguments.'
+            };
+        }
+        if (!isPlainMcpArgumentsObject(mcp.arguments)) {
+            return {
+                ok: false,
+                code: 'MCP_ARGUMENTS_MISMATCH',
+                message: 'solution.evidence.arguments must be a plain object when the contract specifies mcp.arguments.'
+            };
+        }
+        if (!deepMcpArgumentSubset(proof.mcp.arguments, mcp.arguments)) {
+            return {
+                ok: false,
+                code: 'MCP_ARGUMENTS_MISMATCH',
+                message: 'solution.evidence.arguments does not satisfy the contract (required keys must match values, including nested objects).'
+            };
+        }
+    }
+    return { ok: true };
+}
+//# sourceMappingURL=mcp-contract-match.js.map

package/dist/tools/mcp-contract-match.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-contract-match.js","sourceRoot":"","sources":["../../src/tools/mcp-contract-match.ts"],"names":[],"mappings":"AAEA,wDAAwD;AACxD,MAAM,UAAU,yBAAyB,CAAC,KAAc;IACtD,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,aAAa,CAAC,CAAU,EAAE,CAAU;IAC3C,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACzB,OAAO,MAAM,CAAC,KAAK,CAAC,CAAW,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAW,CAAC,CAAC;AAChE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,aAAsB,EAAE,eAAwB;IACrF,IAAI,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;QACjC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC,IAAI,aAAa,CAAC,MAAM,KAAK,eAAe,CAAC,MAAM,EAAE,CAAC;YACvF,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,sBAAsB,CAAC,EAAE,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACxF,CAAC;IACD,IAAI,aAAa,KAAK,IAAI,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE,CAAC;QAChE,IAAI,CAAC,yBAAyB,CAAC,eAAe,CAAC;YAAE,OAAO,KAAK,CAAC;QAC9D,MAAM,CAAC,GAAG,aAAwC,CAAC;QACnD,MAAM,CAAC,GAAG,eAAe,CAAC;QAC1B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YACjC,IAAI,CAAC,sBAAsB,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;gBAAE,OAAO,KAAK,CAAC;QAC5D,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,aAAa,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC;AACvD,CAAC;AAED,8IAA8I;AAC9I,MAAM,UAAU,qBAAqB,CAAC,YAAqC,EAAE,cAAuC;IAClH,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;QAC5C,IAAI,CAAC,sBAAsB,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;IACpF,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAMD,MAAM,UAAU,oCAAoC,CAClD,KAA4B,EAC5B,GAA+C;IAE/C,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QACvC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IACtB,CAAC;IACD,MAAM,YAAY,GAAG,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC;IACzC,IAAI,YAAY,KAAK,SAAS,IAAI,YAAY,KAAK,EAAE,IAAI,GAAG,CAAC,SAAS,KAAK,YAAY,EAAE,CAAC;QACxF,OAAO;YACL,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,mBAAmB;YACzB,OAAO,EAAE,oDAAoD,YAAY,WAAW,GAAG,CAAC,SAAS,KAAK;SACvG,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,CAAC,GAAG,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACtC,IAAI,GAAG,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YAChC,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,IAAI,EAAE,eAAe;gBACrB,OAAO,EAAE,uGAAuG;aACjH,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,yBAAyB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9C,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,IAAI,EAAE,wBAAwB;gBAC9B,OAAO,EAAE,+FAA+F;aACzG,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YAC/D,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,IAAI,EAAE,wBAAwB;gBAC9B,OAAO,EAAE,wHAAwH;aAClI,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACtB,CAAC"}

package/dist/tools/mcp-loose-input-schema.d.ts

@@ -0,0 +1,8 @@
+import { z } from 'zod';
+/**
+ * MCP SDK validates tool arguments before the handler runs. To return agent-teaching
+ * bodies instead of the SDK generic message, register this union: strict branch accepts
+ * valid calls; the record branch accepts any object so the handler can safeParse and reply.
+ */
+export declare function mcpLooseToolInput<T extends z.ZodTypeAny>(strict: T): z.ZodUnion<readonly [T, z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodUndefined, z.ZodNull]>;
+//# sourceMappingURL=mcp-loose-input-schema.d.ts.map

package/dist/tools/mcp-loose-input-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-loose-input-schema.d.ts","sourceRoot":"","sources":["../../src/tools/mcp-loose-input-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC,+FAElE"}

package/dist/tools/mcp-loose-input-schema.js

@@ -0,0 +1,10 @@
+import { z } from 'zod';
+/**
+ * MCP SDK validates tool arguments before the handler runs. To return agent-teaching
+ * bodies instead of the SDK generic message, register this union: strict branch accepts
+ * valid calls; the record branch accepts any object so the handler can safeParse and reply.
+ */
+export function mcpLooseToolInput(strict) {
+    return z.union([strict, z.record(z.string(), z.unknown()), z.undefined(), z.null()]);
+}
+//# sourceMappingURL=mcp-loose-input-schema.js.map

package/dist/tools/mcp-loose-input-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-loose-input-schema.js","sourceRoot":"","sources":["../../src/tools/mcp-loose-input-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAyB,MAAS;IACjE,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AACvF,CAAC"}

package/dist/tools/mcp-runtime-error.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Build a structured MCP error result for an embedding provider rate-limit error.
+ *
+ * Without this, a 429 surfaces as a raw error string (e.g.
+ * "OpenAI rate limit (429): ...") that breaks client `JSON.parse` of the tool
+ * `content[0].text`. Returning structured JSON lets clients parse a clear,
+ * actionable `EMBEDDING_RATE_LIMIT` payload instead.
+ *
+ * Returns `null` for non-rate-limit errors so the caller preserves existing
+ * behavior (re-throw) for those.
+ */
+export declare function mcpRateLimitErrorResult(error: unknown): {
+    isError: true;
+    content: [{
+        type: 'text';
+        text: string;
+    }];
+} | null;
+//# sourceMappingURL=mcp-runtime-error.d.ts.map

package/dist/tools/mcp-runtime-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-runtime-error.d.ts","sourceRoot":"","sources":["../../src/tools/mcp-runtime-error.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACnC,KAAK,EAAE,OAAO,GACf;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,GAAG,IAAI,CAmBrE"}

package/dist/tools/mcp-runtime-error.js

@@ -0,0 +1,34 @@
+import { EmbeddingRateLimitError } from '../services/embedding/providers.js';
+/**
+ * Build a structured MCP error result for an embedding provider rate-limit error.
+ *
+ * Without this, a 429 surfaces as a raw error string (e.g.
+ * "OpenAI rate limit (429): ...") that breaks client `JSON.parse` of the tool
+ * `content[0].text`. Returning structured JSON lets clients parse a clear,
+ * actionable `EMBEDDING_RATE_LIMIT` payload instead.
+ *
+ * Returns `null` for non-rate-limit errors so the caller preserves existing
+ * behavior (re-throw) for those.
+ */
+export function mcpRateLimitErrorResult(error) {
+    if (!(error instanceof EmbeddingRateLimitError))
+        return null;
+    const isQuota = error.code === 'insufficient_quota';
+    return {
+        isError: true,
+        content: [{
+                type: 'text',
+                text: JSON.stringify({
+                    error: 'EMBEDDING_RATE_LIMIT',
+                    provider: error.provider,
+                    http_status: error.httpStatus,
+                    code: error.code ?? 'rate_limit_exceeded',
+                    message: error.message,
+                    retry_hint: isQuota
+                        ? 'OpenAI account is out of quota. Add billing/quota, then retry.'
+                        : 'Transient rate limit. Wait and retry, or reduce request rate.'
+                })
+            }]
+    };
+}
+//# sourceMappingURL=mcp-runtime-error.js.map

package/dist/tools/mcp-runtime-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-runtime-error.js","sourceRoot":"","sources":["../../src/tools/mcp-runtime-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAE7E;;;;;;;;;;GAUG;AACH,MAAM,UAAU,uBAAuB,CACnC,KAAc;IAEd,IAAI,CAAC,CAAC,KAAK,YAAY,uBAAuB,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7D,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,KAAK,oBAAoB,CAAC;IACpD,OAAO;QACH,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,CAAC;gBACN,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACjB,KAAK,EAAE,sBAAsB;oBAC7B,QAAQ,EAAE,KAAK,CAAC,QAAQ;oBACxB,WAAW,EAAE,KAAK,CAAC,UAAU;oBAC7B,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,qBAAqB;oBACzC,OAAO,EAAE,KAAK,CAAC,OAAO;oBACtB,UAAU,EAAE,OAAO;wBACf,CAAC,CAAC,gEAAgE;wBAClE,CAAC,CAAC,+DAA+D;iBACxE,CAAC;aACL,CAAC;KACL,CAAC;AACN,CAAC"}

package/dist/tools/mcp-tool-input-teaching.d.ts

@@ -0,0 +1,12 @@
+import type { ZodError } from 'zod';
+export declare const MCP_INVALID_TOOL_INPUT: "INVALID_TOOL_INPUT";
+export type KairosToolNameForInputTeaching = 'activate' | 'forward' | 'reward' | 'train' | 'tune' | 'delete' | 'export' | 'spaces';
+export declare function buildMcpInputTeachingPayload(tool: KairosToolNameForInputTeaching, error: ZodError, _raw: unknown): Record<string, unknown>;
+export declare function mcpToolInputValidationErrorResult(tool: KairosToolNameForInputTeaching, error: ZodError, raw: unknown): {
+    isError: true;
+    content: [{
+        type: 'text';
+        text: string;
+    }];
+};
+//# sourceMappingURL=mcp-tool-input-teaching.d.ts.map

package/dist/tools/mcp-tool-input-teaching.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tool-input-teaching.d.ts","sourceRoot":"","sources":["../../src/tools/mcp-tool-input-teaching.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AAGpC,eAAO,MAAM,sBAAsB,EAAG,oBAA6B,CAAC;AAKpE,MAAM,MAAM,8BAA8B,GACtC,UAAU,GACV,SAAS,GACT,QAAQ,GACR,OAAO,GACP,MAAM,GACN,QAAQ,GACR,QAAQ,GACR,QAAQ,CAAC;AA2Qb,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,8BAA8B,EACpC,KAAK,EAAE,QAAQ,EACf,IAAI,EAAE,OAAO,GACZ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAmBzB;AAED,wBAAgB,iCAAiC,CAC/C,IAAI,EAAE,8BAA8B,EACpC,KAAK,EAAE,QAAQ,EACf,GAAG,EAAE,OAAO,GACX;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAK9D"}

package/dist/tools/mcp-tool-input-teaching.js

@@ -0,0 +1,259 @@
+import { FORWARD_SOLUTION_FORBIDDEN_ON_START_MESSAGE } from './forward_schema.js';
+export const MCP_INVALID_TOOL_INPUT = 'INVALID_TOOL_INPUT';
+const MAX_INPUT_RETRIES = 3;
+const RETRY_TTL_MS = 60_000;
+const retryCounters = new Map();
+function issuePaths(error) {
+    return error.issues.map((i) => (i.path.length ? i.path.join('.') : '(root)'));
+}
+function hasTopLevelField(error, field) {
+    return error.issues.some((i) => i.path[0] === field);
+}
+function readString(raw, keys) {
+    if (!raw || typeof raw !== 'object')
+        return null;
+    const rec = raw;
+    for (const key of keys) {
+        const value = rec[key];
+        if (typeof value === 'string' && value.trim().length > 0)
+            return value.trim();
+    }
+    return null;
+}
+function uriExecutionId(raw) {
+    const uri = readString(raw, ['uri']);
+    if (!uri)
+        return null;
+    const match = uri.match(/^(?:kairos|squadrules):\/\/layer\/[0-9a-f-]{36}\?execution_id=([0-9a-f-]{36})$/i);
+    return match?.[1] ?? null;
+}
+function retryCounter(tool, raw) {
+    const executionId = uriExecutionId(raw);
+    const scope = executionId ??
+        readString(raw, ['X-Idempotency-Key', 'x-idempotency-key', 'idempotency_key']) ??
+        readString(raw, ['transport_session_id', 'session_id']) ??
+        readString(raw, ['origin_ip', 'ip']) ??
+        'unknown';
+    const key = `kairos:retry:default:${tool}:${scope}`;
+    const now = Date.now();
+    const existing = retryCounters.get(key);
+    const count = existing && existing.expiresAt > now ? existing.count + 1 : 1;
+    retryCounters.set(key, { count, expiresAt: now + RETRY_TTL_MS });
+    return { retry_count: count, max_retries: MAX_INPUT_RETRIES };
+}
+function withRetry(tool, raw, payload) {
+    const retry = retryCounter(tool, raw);
+    const mustObey = retry.retry_count <= retry.max_retries;
+    return {
+        ...payload,
+        must_obey: mustObey,
+        ...(mustObey
+            ? {}
+            : {
+                next_action: 'Stop retrying this exact payload. Ask for clarification or call activate again to regenerate the next step.'
+            }),
+        ...retry
+    };
+}
+function teachingActivate(error, raw) {
+    const paths = issuePaths(error);
+    const queryProblem = hasTopLevelField(error, 'query') || paths.some((p) => p.startsWith('query'));
+    const message = queryProblem
+        ? 'Input validation error: `activate` needs a non-empty `query` string summarizing the user intent (about 3–8 words is enough). Optional: `space` / `space_id` to narrow search; optional `max_choices` within the allowed range.'
+        : 'Input validation error: Check `activate` arguments against the tool schema: required `query`; optional `space`, `space_id`, `max_choices`.';
+    return withRetry('activate', raw, {
+        error: MCP_INVALID_TOOL_INPUT,
+        tool: 'activate',
+        message,
+        next_action: 'Call activate again with {"query":"<short intent from the user message>"}. Use spaces first if you need allowed space names.',
+        invalid_fields: paths,
+        example: { query: 'review and publish adapter' }
+    });
+}
+function teachingForward(error, raw) {
+    const paths = issuePaths(error);
+    const uriProblem = hasTopLevelField(error, 'uri');
+    const solutionProblem = hasTopLevelField(error, 'solution') || paths.some((p) => p.startsWith('solution'));
+    const forbiddenSolutionOnStart = error.issues.some((i) => i.message === FORWARD_SOLUTION_FORBIDDEN_ON_START_MESSAGE);
+    const missingSolutionType = error.issues.some((issue) => issue.path.length === 2 && issue.path[0] === 'solution' && issue.path[1] === 'type');
+    const rawUri = readString(raw, ['uri']);
+    const adapterUuidOnWire = typeof rawUri === 'string' && /^(?:kairos|squadrules):\/\/adapter\/[0-9a-f-]{36}$/i.test(rawUri);
+    const memUriMisuse = typeof rawUri === 'string' && /^(?:kairos|squadrules):\/\/mem\//i.test(rawUri);
+    if (uriProblem && adapterUuidOnWire) {
+        return withRetry('forward', raw, {
+            error: MCP_INVALID_TOOL_INPUT,
+            tool: 'forward',
+            message: 'Input validation error: Adapter URIs are slug-only on the wire for forward.',
+            next_action: 'Retry forward with {"uri":"kairos://adapter/<slug>"} copied from activate `choices[].forward_first_call.uri`.',
+            invalid_fields: paths,
+            example: { uri: 'kairos://adapter/phase-critic' }
+        });
+    }
+    if (uriProblem && memUriMisuse) {
+        return withRetry('forward', raw, {
+            error: MCP_INVALID_TOOL_INPUT,
+            tool: 'forward',
+            message: 'Input validation error: memory URIs are for resource reads, not forward.',
+            next_action: 'Retry forward with an adapter slug URI for start calls or a layer URI with execution_id for continuation calls.',
+            invalid_fields: paths,
+            example: { uri: 'kairos://adapter/phase-critic' }
+        });
+    }
+    if (uriProblem) {
+        return withRetry('forward', raw, {
+            error: MCP_INVALID_TOOL_INPUT,
+            tool: 'forward',
+            message: 'Input validation error: `uri` is required and must be a JSON string using kairos://adapter/<slug> or kairos://layer/<uuid>[?execution_id=<uuid>].',
+            next_action: 'Retry forward with {"uri":"kairos://adapter/<slug>"} for start, or the exact layer URI from the previous forward response.',
+            invalid_fields: paths,
+            example: { uri: 'kairos://adapter/phase-critic' }
+        });
+    }
+    if (solutionProblem && forbiddenSolutionOnStart) {
+        return withRetry('forward', raw, {
+            error: MCP_INVALID_TOOL_INPUT,
+            tool: 'forward',
+            message: `Input validation error: ${FORWARD_SOLUTION_FORBIDDEN_ON_START_MESSAGE}`,
+            next_action: 'Retry forward with {"uri":"<adapter-slug-or-layer-uri-without-execution_id>"} only. Omit `solution` on start.',
+            invalid_fields: paths,
+            example: { uri: 'kairos://adapter/phase-critic' }
+        });
+    }
+    if (solutionProblem && missingSolutionType) {
+        return withRetry('forward', raw, {
+            error: MCP_INVALID_TOOL_INPUT,
+            tool: 'forward',
+            message: 'Input validation error: `solution.type` is required on continuation calls and must match the current contract.type.',
+            next_action: 'Retry with the same layer URI including execution_id and provide solution.type plus evidence payload.',
+            invalid_fields: paths,
+            example: {
+                uri: 'kairos://layer/<uuid>?execution_id=<uuid>',
+                solution: { type: 'comment', outcome: 'success', evidence: { text: 'done' } }
+            }
+        });
+    }
+    if (solutionProblem) {
+        return withRetry('forward', raw, {
+            error: MCP_INVALID_TOOL_INPUT,
+            tool: 'forward',
+            message: 'Input validation error: `solution` must include type, outcome, and evidence payload.',
+            next_action: 'Retry with solution.type set to contract.type, outcome: "success", and evidence with required proof data.',
+            invalid_fields: paths,
+            example: {
+                uri: 'kairos://layer/<uuid>?execution_id=<uuid>',
+                solution: { type: 'shell', outcome: 'success', evidence: { exit_code: 0 } }
+            }
+        });
+    }
+    return withRetry('forward', raw, {
+        error: MCP_INVALID_TOOL_INPUT,
+        tool: 'forward',
+        message: 'Input validation error: Invalid arguments for tool forward.',
+        next_action: 'Retry forward with valid JSON matching the schema.',
+        invalid_fields: paths,
+        example: { uri: 'kairos://adapter/phase-critic' }
+    });
+}
+function teachingReward(error, raw) {
+    const paths = issuePaths(error);
+    return withRetry('reward', raw, {
+        error: MCP_INVALID_TOOL_INPUT,
+        tool: 'reward',
+        message: 'Input validation error: `reward` needs `uri` = final layer URI from the last forward (`kairos://layer/<uuid>` with `?execution_id=...` when the run used it), plus `outcome` ("success" or "failure"). Optional: score, feedback, rater, rubric_version (required for SFT/preference export), llm_model_id (required with rater for evaluator identity).',
+        next_action: 'Call reward with {"uri":"<layer uri from forward>","outcome":"success"|"failure","rubric_version":"v1","rater":"agent","llm_model_id":"<model>"} — copy the layer uri verbatim from the forward response that told you to reward.',
+        invalid_fields: paths,
+        example: { uri: 'kairos://layer/<uuid>?execution_id=<uuid>', outcome: 'success' }
+    });
+}
+function teachingTrain(error, raw) {
+    const paths = issuePaths(error);
+    const md = hasTopLevelField(error, 'content') || hasTopLevelField(error, 'source_adapter_uri');
+    const model = hasTopLevelField(error, 'llm_model_id');
+    let extra = '';
+    if (model) {
+        extra += ' Provide non-empty `llm_model_id`.';
+    }
+    if (md) {
+        extra +=
+            ' Supply full adapter `content` and/or `source_adapter_uri` (fork) so at least one source of content exists.';
+    }
+    return withRetry('train', raw, {
+        error: MCP_INVALID_TOOL_INPUT,
+        tool: 'train',
+        message: `Input validation error: Invalid arguments for tool train.${extra} See train tool description for optional force_update, protocol_version, space.`,
+        next_action: 'Retry train with {"content":"...","llm_model_id":"..."} or with source_adapter_uri (and optional content override).',
+        invalid_fields: paths,
+        example: { content: '# My adapter\n\n## Step\n\n```json\n{"contract":{"type":"comment"}}\n```', llm_model_id: 'gpt-5.3-codex' }
+    });
+}
+function teachingTune(error, raw) {
+    const paths = issuePaths(error);
+    return withRetry('tune', raw, {
+        error: MCP_INVALID_TOOL_INPUT,
+        tool: 'tune',
+        message: 'Input validation error: `tune` requires non-empty `uris` (adapter and/or layer URIs). Provide at least one of: parallel `content` strings (same length as uris), `updates` map, or `space` to move targets.',
+        next_action: 'Call tune with {"uris":["kairos://adapter/<slug>"],"content":["..."]} or {"uris":[...],"space":"personal"}.',
+        invalid_fields: paths,
+        example: { uris: ['kairos://adapter/phase-critic'], content: ['# Updated adapter markdown'] }
+    });
+}
+function teachingDelete(error, raw) {
+    const paths = issuePaths(error);
+    return withRetry('delete', raw, {
+        error: MCP_INVALID_TOOL_INPUT,
+        tool: 'delete',
+        message: 'Input validation error: `delete` requires `uris`: a non-empty array of adapter-slug or layer URIs.',
+        next_action: 'Retry delete with {"uris":["kairos://adapter/<slug>"]} or layer URIs you intend to remove.',
+        invalid_fields: paths,
+        example: { uris: ['kairos://adapter/phase-critic'] }
+    });
+}
+function teachingExport(error, raw) {
+    const paths = issuePaths(error);
+    return withRetry('export', raw, {
+        error: MCP_INVALID_TOOL_INPUT,
+        tool: 'export',
+        message: 'Input validation error: `export` requires exactly one selection: `uri`, or non-empty `adapters`, or `all_adapters`+`space_name`. Default `format` is `skill_zip`; use `format: markdown` for flat single-file adapter Markdown. Optional `include_reward`.',
+        next_action: 'Call export with {"uri":"kairos://adapter/<slug>","format":"skill_zip"} or for flat Markdown {"uri":"kairos://adapter/<slug>","format":"markdown"}.',
+        invalid_fields: paths,
+        example: { uri: 'kairos://adapter/phase-critic', format: 'skill_zip' }
+    });
+}
+function teachingSpaces(error, raw) {
+    const paths = issuePaths(error);
+    return withRetry('spaces', raw, {
+        error: MCP_INVALID_TOOL_INPUT,
+        tool: 'spaces',
+        message: 'Input validation error: `spaces` accepts optional booleans only: `include_adapter_titles`, `include_widget_html` (both default false).',
+        next_action: 'Call spaces with {} or {"include_adapter_titles":true} — use JSON true/false, not strings.',
+        invalid_fields: paths,
+        example: { include_adapter_titles: true }
+    });
+}
+export function buildMcpInputTeachingPayload(tool, error, _raw) {
+    switch (tool) {
+        case 'activate':
+            return teachingActivate(error, _raw);
+        case 'forward':
+            return teachingForward(error, _raw);
+        case 'reward':
+            return teachingReward(error, _raw);
+        case 'train':
+            return teachingTrain(error, _raw);
+        case 'tune':
+            return teachingTune(error, _raw);
+        case 'delete':
+            return teachingDelete(error, _raw);
+        case 'export':
+            return teachingExport(error, _raw);
+        case 'spaces':
+            return teachingSpaces(error, _raw);
+    }
+}
+export function mcpToolInputValidationErrorResult(tool, error, raw) {
+    return {
+        isError: true,
+        content: [{ type: 'text', text: JSON.stringify(buildMcpInputTeachingPayload(tool, error, raw)) }]
+    };
+}
+//# sourceMappingURL=mcp-tool-input-teaching.js.map

package/dist/tools/mcp-tool-input-teaching.js.map

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

package/dist/tools/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 forward call.
+ */
+import type { Memory } from '../types/memory.js';
+import type { QdrantService } from '../services/qdrant/service.js';
+import { buildChallenge } from './next-pow-helpers.js';
+import type { PreviousProofBlock } from './next-previous-step.js';
+declare function buildCurrentStep(memory: Memory | null, requestedUri: string, executionId?: 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, executionId?: string): Promise<MissingProofPayload>;
+export {};
+//# sourceMappingURL=next-missing-proof-payload.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"next-missing-proof-payload.d.ts","sourceRoot":"","sources":["../../src/tools/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;AAInE,OAAO,EAAE,cAAc,EAAgB,MAAM,uBAAuB,CAAC;AAErE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAGlE,iBAAS,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM;;;;EAI1F;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,EACxC,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,mBAAmB,CAAC,CAmB9B"}

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

@@ -0,0 +1,36 @@
+/**
+ * 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 forward call.
+ */
+import { resolveAdapterPreviousLayer } from '../services/adapter-navigation.js';
+import { getInferenceContract } from '../services/memory/memory-accessors.js';
+import { proofOfWorkStore } from '../services/proof-of-work-store.js';
+import { buildChallenge, GENESIS_HASH } from './next-pow-helpers.js';
+import { extractMemoryBody } from '../utils/memory-body.js';
+import { buildLayerUri } from './kairos-uri.js';
+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' };
+}
+export async function buildMissingProofPayload(memory, previousBlock, requestedUri, uuid, loadMemory, qdrantService, executionId) {
+    const previous = await resolveAdapterPreviousLayer(memory, qdrantService);
+    const prevMemory = previous?.uuid ? await loadMemory(previous.uuid) : null;
+    const prevUri = previous?.uuid ? buildLayerUri(previous.uuid, executionId) : requestedUri;
+    const isPrevStep1 = !prevMemory?.adapter || prevMemory.adapter.layer_index <= 1;
+    const previousOfPrevious = prevMemory && !isPrevStep1 ? await resolveAdapterPreviousLayer(prevMemory, qdrantService) : null;
+    const expectedPrevHash = isPrevStep1
+        ? GENESIS_HASH
+        : (previousOfPrevious?.uuid ? await proofOfWorkStore.getProofHash(previousOfPrevious.uuid) : null) ?? GENESIS_HASH;
+    let challenge = await buildChallenge(prevMemory, prevMemory ? getInferenceContract(prevMemory) : undefined);
+    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, executionId),
+        challenge,
+        next_action: previousBlock.next_action ?? `retry forward with ${prevUri} -- complete previous step first`,
+        retry_count: retryCount
+    };
+}
+//# sourceMappingURL=next-missing-proof-payload.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"next-missing-proof-payload.js","sourceRoot":"","sources":["../../src/tools/next-missing-proof-payload.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,2BAA2B,EAAE,MAAM,mCAAmC,CAAC;AAChF,OAAO,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,SAAS,gBAAgB,CAAC,MAAqB,EAAE,YAAoB,EAAE,WAAoB;IACzF,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;IACnF,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,EACxC,WAAoB;IAEpB,MAAM,QAAQ,GAAG,MAAM,2BAA2B,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC1E,MAAM,UAAU,GAAG,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,MAAM,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3E,MAAM,OAAO,GAAG,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;IAC1F,MAAM,WAAW,GAAG,CAAC,UAAU,EAAE,OAAO,IAAI,UAAU,CAAC,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC;IAChF,MAAM,kBAAkB,GAAG,UAAU,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,2BAA2B,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5H,MAAM,gBAAgB,GAAG,WAAW;QAClC,CAAC,CAAC,YAAY;QACd,CAAC,CAAC,CAAC,kBAAkB,EAAE,IAAI,CAAC,CAAC,CAAC,MAAM,gBAAgB,CAAC,YAAY,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC;IACrH,IAAI,SAAS,GAAG,MAAM,cAAc,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC5G,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,EAAE,WAAW,CAAC;QAChE,SAAS;QACT,WAAW,EAAE,aAAa,CAAC,WAAW,IAAI,sBAAsB,OAAO,kCAAkC;QACzG,WAAW,EAAE,UAAU;KACxB,CAAC;AACJ,CAAC"}

package/dist/tools/next-pow-challenge-shape.d.ts

@@ -0,0 +1,4 @@
+import type { ProofOfWorkDefinition } from '../types/memory.js';
+/** Build challenge shape from proof only (no nonce, no store). Used by forward / next proof flow. */
+export declare function buildChallengeShapeForDisplay(proof?: ProofOfWorkDefinition): Record<string, unknown>;
+//# sourceMappingURL=next-pow-challenge-shape.d.ts.map

package/dist/tools/next-pow-challenge-shape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-pow-challenge-shape.d.ts","sourceRoot":"","sources":["../../src/tools/next-pow-challenge-shape.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAmB,MAAM,oBAAoB,CAAC;AAGjF,qGAAqG;AACrG,wBAAgB,6BAA6B,CAAC,KAAK,CAAC,EAAE,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA0CpG"}