@squadrules/mcp 4.8.6

package/dist/tools/forward_schema.js

@@ -0,0 +1,309 @@
+import { z } from 'zod';
+import { ADAPTER_SLUG_URI_INPUT_REGEX, LAYER_URI_INPUT_REGEX } from './kairos-uri.js';
+const adapterUriSchema = z
+    .string()
+    .regex(ADAPTER_SLUG_URI_INPUT_REGEX, 'must match kairos://adapter/{slug}');
+const layerUriSchema = z
+    .string()
+    .regex(LAYER_URI_INPUT_REGEX, 'must match kairos://layer/{uuid}[?execution_id={uuid}]');
+const forwardUriSchema = z.union([adapterUriSchema, layerUriSchema]);
+const tensorOutputSchema = z.object({
+    name: z.string(),
+    type: z.string(),
+    min_length: z.number().optional(),
+    max_length: z.number().optional(),
+    min_items: z.number().optional(),
+    max_items: z.number().optional()
+});
+const tensorContractSchema = z.object({
+    required_inputs: z.array(z.string()),
+    output: tensorOutputSchema,
+    merge: z.string().optional(),
+    condition: z.string().optional()
+});
+export const forwardContractSchema = z.object({
+    type: z.enum(['tensor', 'shell', 'mcp', 'user_input', 'comment']),
+    required: z.boolean().optional(),
+    description: z.string().optional(),
+    nonce: z.string().optional(),
+    proof_hash: z.string().optional(),
+    tensor: tensorContractSchema.optional(),
+    shell: z.object({
+        cmd: z.string(),
+        timeout_seconds: z.number()
+    }).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()
+});
+const solutionTypeSchema = z.enum(['tensor', 'shell', 'mcp', 'user_input', 'comment']);
+const solutionTemplateSchema = z
+    .object({
+    type: solutionTypeSchema,
+    outcome: z.enum(['success', 'failure', 'skipped']).optional(),
+    evidence: z.record(z.string(), z.unknown()).optional(),
+    tensor: z.record(z.string(), z.unknown()).optional(),
+    shell: z.record(z.string(), z.unknown()).optional(),
+    mcp: z.record(z.string(), z.unknown()).optional(),
+    user_input: z.record(z.string(), z.unknown()).optional(),
+    comment: z.record(z.string(), z.unknown()).optional()
+})
+    .strict()
+    .superRefine((value, ctx) => {
+    const typeToField = {
+        tensor: 'tensor',
+        shell: 'shell',
+        mcp: 'mcp',
+        user_input: 'user_input',
+        comment: 'comment'
+    };
+    const expectedField = typeToField[value.type];
+    const providedFields = Object.keys(typeToField).filter((typeKey) => {
+        const field = typeToField[typeKey];
+        return value[field] !== undefined;
+    });
+    if (value.evidence === undefined && !providedFields.includes(value.type)) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: `solution_template.${expectedField} is required for type "${value.type}".`
+        });
+        return;
+    }
+    if (providedFields.some((field) => field !== value.type)) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: 'solution_template must include only the payload field matching solution_template.type.'
+        });
+    }
+});
+const forwardNextCallSchema = z.discriminatedUnion('kind', [
+    z.object({
+        kind: z.literal('forward'),
+        args: z
+            .object({
+            uri: layerUriSchema,
+            solution_template: solutionTemplateSchema
+        })
+            .strict()
+    }),
+    z.object({
+        kind: z.literal('reward'),
+        args: z
+            .object({
+            uri: layerUriSchema,
+            outcome_template: z
+                .object({
+                outcome: z.literal('success')
+            })
+                .strict()
+        })
+            .strict()
+    })
+]);
+const forwardCommentSolutionCanonicalSchema = z.object({
+    text: z.string()
+});
+function normalizeForwardSolutionCommentInput(raw) {
+    if (raw === null || raw === undefined || typeof raw !== 'object' || Array.isArray(raw)) {
+        return raw;
+    }
+    const o = raw;
+    const c = o['comment'];
+    if (typeof c === 'string') {
+        return { ...o, comment: { text: c } };
+    }
+    return raw;
+}
+function normalizeCommentTextToEvidence(solution) {
+    if (solution['type'] !== 'comment' || typeof solution['text'] !== 'string')
+        return null;
+    const existingEvidence = solution['evidence'] !== null && solution['evidence'] !== undefined && typeof solution['evidence'] === 'object' && !Array.isArray(solution['evidence'])
+        ? solution['evidence']
+        : {};
+    if (existingEvidence['text'] === undefined) {
+        return { ...solution, evidence: { ...existingEvidence, text: solution['text'] } };
+    }
+    return null;
+}
+function normalizeForwardSolutionFormat(raw) {
+    if (raw === null || raw === undefined || typeof raw !== 'object' || Array.isArray(raw)) {
+        return raw;
+    }
+    const solution = raw;
+    const normalizedWithComment = normalizeForwardSolutionCommentInput(solution);
+    if (normalizedWithComment !== solution) {
+        return normalizeForwardSolutionFormat(normalizedWithComment);
+    }
+    // Normalize flat comment text into evidence.text when type=comment
+    const withTextEvidence = normalizeCommentTextToEvidence(solution);
+    if (withTextEvidence)
+        return withTextEvidence;
+    if (solution['evidence'] !== undefined && typeof solution['evidence'] === 'object') {
+        const outcome = solution['outcome'];
+        if (outcome === undefined) {
+            return { ...solution, outcome: 'success' };
+        }
+        return solution;
+    }
+    const type = solution['type'];
+    if (typeof type === 'string' && ['tensor', 'shell', 'mcp', 'user_input', 'comment'].includes(type)) {
+        const typeSpecificData = solution[type];
+        if (typeSpecificData !== undefined && typeof typeSpecificData === 'object') {
+            const v2Solution = { type, outcome: 'success', evidence: typeSpecificData, nonce: solution['nonce'], proof_hash: solution['proof_hash'], trace: solution['trace'] };
+            if (type === 'mcp' && typeSpecificData['result'] !== undefined) {
+                const mcpData = typeSpecificData;
+                const { result, ...rest } = mcpData;
+                v2Solution['evidence'] = {
+                    ...rest,
+                    response: result
+                };
+            }
+            return v2Solution;
+        }
+    }
+    return solution;
+}
+const forwardSolutionShapeSchema = z.object({
+    type: z.enum(['tensor', 'shell', 'mcp', 'user_input', 'comment']).describe('Must match contract.type on continuation calls'),
+    outcome: z.enum(['success', 'failure', 'skipped']).optional().describe('Universal outcome signal. Required in v2 format.'),
+    evidence: z.record(z.string(), z.unknown()).optional().describe('Type-specific proof of execution. Shape depends on solution.type.'),
+    nonce: z.string().optional().describe('Echo nonce from contract for proof-based layers'),
+    proof_hash: z.string().optional().describe('Echo proof_hash from previous layer when required'),
+    tensor: z.object({
+        name: z.string(),
+        value: z.any()
+    }).optional().describe('Deprecated: Use \'evidence\' envelope instead. Still accepted.'),
+    shell: z.object({
+        exit_code: z.number(),
+        stdout: z.string().optional(),
+        stderr: z.string().optional(),
+        duration_seconds: z.number().optional()
+    }).optional().describe('Deprecated: Use \'evidence\' envelope instead. Still accepted.'),
+    mcp: z.object({ tool_name: z.string(), arguments: z.any().optional(), result: z.any(), success: z.boolean() }).optional().describe('Deprecated: Use \'evidence\' envelope instead. Still accepted.'),
+    user_input: z.object({ confirmation: z.string(), timestamp: z.string().optional() }).optional().describe('Deprecated: Use \'evidence\' envelope instead. Still accepted.'),
+    comment: forwardCommentSolutionCanonicalSchema.optional().describe('Deprecated: Use \'evidence\' envelope instead. Still accepted.'),
+    trace: z.string().optional().describe('Optional reasoning trace stored with the execution trace')
+}).refine((data) => !!(data.tensor || data.shell || data.mcp || data.user_input || data.comment || data.evidence), { message: 'At least one type-specific field must be provided' }).refine((data) => {
+    if (data.type === 'tensor' && !data.tensor && !data.evidence)
+        return false;
+    if (data.type === 'shell' && !data.shell && !data.evidence)
+        return false;
+    if (data.type === 'mcp' && !data.mcp && !data.evidence)
+        return false;
+    if (data.type === 'user_input' && !data.user_input && !data.evidence)
+        return false;
+    if (data.type === 'comment' && !data.comment && !data.evidence)
+        return false;
+    return true;
+}, { message: 'The type-specific field must match the solution type' });
+export const forwardSolutionSchema = z.preprocess(normalizeForwardSolutionFormat, forwardSolutionShapeSchema);
+function isLayerUriWithExecutionId(uri) {
+    const match = uri.match(LAYER_URI_INPUT_REGEX);
+    return Boolean(match?.[2]);
+}
+function isStartingNewForwardRun(uri) {
+    if (ADAPTER_SLUG_URI_INPUT_REGEX.test(uri)) {
+        return true;
+    }
+    const match = uri.match(LAYER_URI_INPUT_REGEX);
+    return Boolean(match?.[1] && !match[2]);
+}
+export const FORWARD_SOLUTION_FORBIDDEN_ON_START_MESSAGE = 'Omit `solution` when starting a run (`kairos://adapter/...` or `kairos://layer/{uuid}` without `?execution_id=...`). The first call loads `contract`; then call `forward` again with the layer URI including `?execution_id=...` and a `solution` whose `type` matches `contract.type` (prefer v2: include `outcome` and `evidence`).';
+export const forwardInputSchema = z.object({
+    uri: forwardUriSchema.describe('Adapter or layer URI'),
+    solution: forwardSolutionSchema
+        .optional()
+        .describe('Layer solution. Required only when continuing a run (layer URI with `?execution_id=...`). Omit entirely on the first call (adapter URI or layer without `?execution_id=...`). For continuation calls, include solution.type, outcome, and evidence payload (older type-specific fields are still accepted), and echo nonce/proof_hash when present.')
+}).superRefine((data, ctx) => {
+    if (isStartingNewForwardRun(data.uri) && data.solution !== undefined) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            path: ['solution'],
+            message: FORWARD_SOLUTION_FORBIDDEN_ON_START_MESSAGE
+        });
+    }
+    if (isLayerUriWithExecutionId(data.uri) && !data.solution) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            path: ['solution'],
+            message: '`solution` is required when continuing a run with `kairos://layer/...?execution_id=...`. Omit `solution` only on the first forward call of a run.'
+        });
+    }
+});
+const forwardWireSolutionShapeSchema = z.object({
+    type: z
+        .enum(['tensor', 'shell', 'mcp', 'user_input', 'comment'])
+        .optional()
+        .describe('Required for continuation calls; must match contract.type. Do not send `solution` at all on start calls.'),
+    outcome: z.enum(['success', 'failure', 'skipped']).optional().describe('Universal outcome signal. Required in v2 format.'),
+    evidence: z.record(z.string(), z.unknown()).optional().describe('Type-specific proof of execution. Shape depends on solution.type.'),
+    nonce: z.string().optional(),
+    proof_hash: z.string().optional(),
+    tensor: z.object({
+        name: z.string().optional(),
+        value: z.any().optional()
+    }).optional().describe('Deprecated: Use \'evidence\' envelope instead. Still accepted.'),
+    shell: z.object({
+        exit_code: z.number().optional(),
+        stdout: z.string().optional(),
+        stderr: z.string().optional(),
+        duration_seconds: z.number().optional()
+    }).optional().describe('Deprecated: Use \'evidence\' envelope instead. Still accepted.'),
+    mcp: z.object({
+        tool_name: z.string().optional(),
+        arguments: z.any().optional(),
+        result: z.any().optional(),
+        success: z.boolean().optional()
+    }).optional().describe('Deprecated: Use \'evidence\' envelope instead. Still accepted.'),
+    user_input: z.object({
+        confirmation: z.string().optional(),
+        timestamp: z.string().optional()
+    }).optional().describe('Deprecated: Use \'evidence\' envelope instead. Still accepted.'),
+    comment: forwardCommentSolutionCanonicalSchema.optional().describe('Deprecated: Use \'evidence\' envelope instead. Still accepted.'),
+    trace: z.string().optional()
+}).passthrough();
+const forwardWireSolutionSchema = z
+    .preprocess(normalizeForwardSolutionFormat, forwardWireSolutionShapeSchema)
+    .describe('Start call (adapter URI or layer URI without `?execution_id=...`): omit `solution`. Continuation call (layer URI with `?execution_id=...`): include solution.type, outcome, evidence payload (older type-specific fields are still accepted), and echo nonce/proof_hash when present. Empty solution objects or missing solution.type will be rejected.');
+export const forwardMcpWireInputSchema = z
+    .object({
+    uri: z
+        .string()
+        .optional()
+        .describe('Adapter or layer URI. Use adapter or layer without execution_id to start; use layer with execution_id to continue.'),
+    solution: forwardWireSolutionSchema
+        .optional()
+        .describe('Only for continuation calls; omit on start. Must include solution.type and proof payload (prefer v2: outcome + evidence).')
+})
+    .passthrough();
+export const forwardOutputSchema = z.object({
+    must_obey: z.boolean(),
+    current_layer: z.object({ uri: layerUriSchema, content: z.string(), mimeType: z.literal('text/markdown') }).optional().nullable(),
+    contract: forwardContractSchema,
+    tensor_in: z.record(z.string(), z.unknown()).optional(),
+    next_action: z.string(),
+    proof_hash: z.string().optional(),
+    execution_id: z.string().optional(),
+    message: z.string().optional(),
+    error_code: z.string().optional(),
+    retry_count: z.number().optional(),
+    slug_disambiguation_note: z.string().optional().describe('When forward started from a slug that matched multiple adapters, explains which was chosen'),
+    next_call: forwardNextCallSchema,
+    activation_space_name: z.string().optional(),
+    context_adapter_name: z.string().optional(),
+    current_layer_label: z.string().optional(),
+    adapter_layer_index: z.number().int().positive().optional(),
+    adapter_layer_count: z.number().int().positive().optional(),
+    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()
+}).strict();
+//# sourceMappingURL=forward_schema.js.map

package/dist/tools/forward_schema.js.map

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

package/dist/tools/kairos-challenge-display.d.ts

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

package/dist/tools/kairos-challenge-display.d.ts.map

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

package/dist/tools/kairos-challenge-display.js

@@ -0,0 +1,86 @@
+import { structuredLogger } from '../utils/structured-logger.js';
+import { GENESIS_HASH } from './kairos-genesis-proof-hash.js';
+import { buildShellChallengeArgv, formatShellInvocationForDisplay, pickShellChallengeFields } from './shell-challenge-invocation.js';
+/** Safe fragment inside backticks in description text. */
+function shellQuoteForDesc(s) {
+    return s.replace(/[`$\\]/g, '');
+}
+function isAllowedStoredChallengeType(t) {
+    return t === 'shell' || t === 'mcp' || t === 'user_input' || t === 'comment';
+}
+/** Build challenge shape from proof only (no nonce, no store). For read-only display e.g. export. */
+export function buildChallengeShapeForDisplay(proof) {
+    const base = proof ? (() => {
+        let proofType;
+        if (proof.type === undefined) {
+            proofType = 'shell';
+        }
+        else if (isAllowedStoredChallengeType(proof.type)) {
+            proofType = proof.type;
+        }
+        else {
+            structuredLogger.warn({ event: 'invalid_stored_challenge_type', storedType: proof.type }, 'Invalid stored contract type in adapter layer; coercing to comment for MCP output schema compliance');
+            proofType = 'comment';
+        }
+        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;
+            const interpreter = proof.shell?.interpreter;
+            const flags = proof.shell?.flags;
+            const args = proof.shell?.args;
+            const workdir = proof.shell?.workdir;
+            const argv = buildShellChallengeArgv(pickShellChallengeFields({ cmd, interpreter, flags, args, workdir }));
+            const invocationLine = formatShellInvocationForDisplay(argv);
+            let description = `Shell contract (timeout ${timeout}s): run exactly: ${invocationLine}. Capture stdout and stderr (do not suppress stderr); exit_code 0 = pass. Report real exit_code/stdout/stderr; do not fabricate.`;
+            const interpTrim = interpreter?.trim();
+            if (interpTrim) {
+                description += ` Before running, ensure the interpreter is on PATH (e.g. \`which ${shellQuoteForDesc(interpTrim)}\`); if not found, fail with a clear local error.`;
+            }
+            const wd = workdir?.trim();
+            if (wd) {
+                description += ` Use workdir "${wd}" as the process working directory after expanding env vars. This is real cwd behavior, not the shared local artifact directory. When a contract also refers to local handoff files, pick a hint from the latest activate/forward/next response field kairos_local_artifact_dir (an ordered list of project://<rel> and user://<rel> URIs), resolve it on your machine (project://<rel> -> <project root>/<rel>; user://<rel> -> <home or $XDG_CONFIG_HOME>/<rel>), and export KAIROS_LOCAL_ARTIFACT_DIR to the absolute path unless your shell already defines it. If the workdir path does not exist, is not a directory, or expansion leaves an empty path, fail with a clear local error.`;
+            }
+            result['description'] = description;
+            const shellOut = { cmd, timeout_seconds: timeout };
+            if (interpreter !== undefined && interpreter !== '')
+                shellOut['interpreter'] = interpreter;
+            if (flags !== undefined && flags.length > 0)
+                shellOut['flags'] = flags;
+            if (args !== undefined && args.length > 0)
+                shellOut['args'] = args;
+            if (workdir !== undefined && workdir !== '')
+                shellOut['workdir'] = workdir;
+            shellOut['invocation_display'] = invocationLine;
+            result['shell'] = shellOut;
+        }
+        else if (proofType === 'mcp') {
+            const toolName = proof.mcp?.tool_name || 'No tool specified';
+            const argsHint = proof.mcp?.arguments !== undefined
+                ? ` Include solution.evidence.arguments matching (subset of) ${JSON.stringify(proof.mcp.arguments)}.`
+                : '';
+            result['description'] = `Call MCP tool: ${toolName}.${argsHint} You MUST actually call this tool and report its real result; do not fabricate.`;
+            const mcpOut = { tool_name: toolName, expected_result: proof.mcp?.expected_result };
+            if (proof.mcp?.arguments !== undefined)
+                mcpOut['arguments'] = proof.mcp.arguments;
+            result['mcp'] = mcpOut;
+        }
+        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 evidence.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;
+}
+//# sourceMappingURL=kairos-challenge-display.js.map

package/dist/tools/kairos-challenge-display.js.map

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

package/dist/tools/kairos-genesis-proof-hash.d.ts

@@ -0,0 +1,3 @@
+/** Hash used as proof_hash for step 1 (no prior proof). */
+export declare const GENESIS_HASH: string;
+//# sourceMappingURL=kairos-genesis-proof-hash.d.ts.map

package/dist/tools/kairos-genesis-proof-hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kairos-genesis-proof-hash.d.ts","sourceRoot":"","sources":["../../src/tools/kairos-genesis-proof-hash.ts"],"names":[],"mappings":"AAEA,2DAA2D;AAC3D,eAAO,MAAM,YAAY,QAA8D,CAAC"}

package/dist/tools/kairos-genesis-proof-hash.js

@@ -0,0 +1,4 @@
+import crypto from 'node:crypto';
+/** Hash used as proof_hash for step 1 (no prior proof). */
+export const GENESIS_HASH = crypto.createHash('sha256').update('genesis').digest('hex');
+//# sourceMappingURL=kairos-genesis-proof-hash.js.map

package/dist/tools/kairos-genesis-proof-hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kairos-genesis-proof-hash.js","sourceRoot":"","sources":["../../src/tools/kairos-genesis-proof-hash.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AAEjC,2DAA2D;AAC3D,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC"}

package/dist/tools/kairos-uri.d.ts

@@ -0,0 +1,28 @@
+export declare const ADAPTER_SLUG_URI_INPUT_REGEX: RegExp;
+export declare const ARTIFACT_URI_INPUT_REGEX: RegExp;
+export declare const LAYER_URI_INPUT_REGEX: RegExp;
+export type ParsedKairosUri = {
+    kind: 'adapter';
+    id: string;
+    idKind: 'uuid' | 'slug';
+    raw: string;
+} | {
+    kind: 'artifact';
+    id: string;
+    idKind: 'uuid' | 'slug';
+    raw: string;
+} | {
+    kind: 'layer';
+    id: string;
+    executionId?: string;
+    raw: string;
+};
+export declare function buildAdapterUri(adapterId: string): string;
+export declare function buildLayerUri(layerId: string, executionId?: string): string;
+export declare function parseKairosUri(value: string): ParsedKairosUri;
+export declare function parseKairosUriOrThrow(value: string): ParsedKairosUri;
+/**
+ * Wire contract guard for public tool inputs: validates adapter URI format.
+ */
+export declare function assertWireAdapterUri(value: string): string;
+//# sourceMappingURL=kairos-uri.d.ts.map

package/dist/tools/kairos-uri.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kairos-uri.d.ts","sourceRoot":"","sources":["../../src/tools/kairos-uri.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,4BAA4B,QAGxC,CAAC;AACF,eAAO,MAAM,wBAAwB,QAGpC,CAAC;AACF,eAAO,MAAM,qBAAqB,QAGjC,CAAC;AAEF,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACrE;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACtE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAErE,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAI3E;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAsE7D;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAUpE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAU1D"}

package/dist/tools/kairos-uri.js

@@ -0,0 +1,105 @@
+// URI SCHEME COMPATIBILITY: Both kairos:// and squadrules:// are accepted on input.
+// All build/emit functions produce kairos:// as the canonical stored form.
+// This is a permanent decision — stored Qdrant data uses kairos:// URIs.
+// See issue #835 for migration context.
+import { KairosError } from '../types/index.js';
+import { normalizeAuthorSlug } from '../utils/protocol-slug.js';
+const UUID_PATTERN = '[0-9a-f-]{36}';
+const SLUG_PATTERN = '[a-z0-9](?:[a-z0-9-]*[a-z0-9])?';
+/** Accepted input URI schemes: canonical kairos:// plus the squadrules:// alias. */
+const SCHEME_PATTERN = '(?:kairos|squadrules)';
+const UUID_REGEX = new RegExp(`^${UUID_PATTERN}$`, 'i');
+const ADAPTER_URI_BODY_REGEX = /^(?:kairos|squadrules):\/\/adapter\/([^/?#]+)$/i;
+const ARTIFACT_URI_BODY_REGEX = /^(?:kairos|squadrules):\/\/artifact\/([^/?#]+)$/i;
+export const ADAPTER_SLUG_URI_INPUT_REGEX = new RegExp(`^${SCHEME_PATTERN}://adapter/(${UUID_PATTERN}|${SLUG_PATTERN})$`, 'i');
+export const ARTIFACT_URI_INPUT_REGEX = new RegExp(`^${SCHEME_PATTERN}://artifact/(${UUID_PATTERN}|${SLUG_PATTERN})$`, 'i');
+export const LAYER_URI_INPUT_REGEX = new RegExp(`^${SCHEME_PATTERN}://layer/(${UUID_PATTERN})(?:\\?execution_id=([0-9a-f-]{36}))?$`, 'i');
+export function buildAdapterUri(adapterId) {
+    return `kairos://adapter/${adapterId}`;
+}
+export function buildLayerUri(layerId, executionId) {
+    return executionId
+        ? `kairos://layer/${layerId}?execution_id=${executionId}`
+        : `kairos://layer/${layerId}`;
+}
+export function parseKairosUri(value) {
+    const normalized = (value || '').trim();
+    const adapterMatch = normalized.match(ADAPTER_URI_BODY_REGEX);
+    if (adapterMatch?.[1]) {
+        if (UUID_REGEX.test(adapterMatch[1])) {
+            return {
+                kind: 'adapter',
+                id: adapterMatch[1],
+                idKind: 'uuid',
+                raw: normalized
+            };
+        }
+        const normalizedSlug = normalizeAuthorSlug(adapterMatch[1]);
+        if (normalizedSlug) {
+            return {
+                kind: 'adapter',
+                id: normalizedSlug,
+                idKind: 'slug',
+                raw: normalized
+            };
+        }
+    }
+    const layerMatch = normalized.match(LAYER_URI_INPUT_REGEX);
+    if (layerMatch?.[1]) {
+        return {
+            kind: 'layer',
+            id: layerMatch[1],
+            ...(layerMatch[2] ? { executionId: layerMatch[2] } : {}),
+            raw: normalized
+        };
+    }
+    /** Transitional input only: older ambiguous surface that meant a layer row UUID. */
+    const olderLayerRowPrefix = ['kairos', '://', 'me', 'm', '/'].join('');
+    if (normalized.startsWith(olderLayerRowPrefix)) {
+        const rest = normalized.slice(olderLayerRowPrefix.length).split('?')[0] ?? '';
+        const id = rest.split('/')[0] ?? '';
+        if (UUID_REGEX.test(id)) {
+            return { kind: 'layer', id, raw: normalized };
+        }
+    }
+    const artifactMatch = normalized.match(ARTIFACT_URI_BODY_REGEX);
+    if (artifactMatch?.[1]) {
+        if (UUID_REGEX.test(artifactMatch[1])) {
+            return {
+                kind: 'artifact',
+                id: artifactMatch[1],
+                idKind: 'uuid',
+                raw: normalized
+            };
+        }
+        const normalizedSlug = normalizeAuthorSlug(artifactMatch[1]);
+        if (normalizedSlug) {
+            return {
+                kind: 'artifact',
+                id: normalizedSlug,
+                idKind: 'slug',
+                raw: normalized
+            };
+        }
+    }
+    throw new Error('Invalid KAIROS URI. Expected kairos://adapter/{uuid|slug} or squadrules://adapter/{uuid|slug}, kairos://artifact/{uuid|slug} or squadrules://artifact/{uuid|slug}, kairos://layer/{uuid}[?execution_id=…] or squadrules://layer/{uuid}[?execution_id=…], or the transitional older layer-row form');
+}
+export function parseKairosUriOrThrow(value) {
+    try {
+        return parseKairosUri(value);
+    }
+    catch (error) {
+        throw new KairosError(error instanceof Error ? error.message : 'Invalid KAIROS URI.', 'INVALID_URI', 400);
+    }
+}
+/**
+ * Wire contract guard for public tool inputs: validates adapter URI format.
+ */
+export function assertWireAdapterUri(value) {
+    const parsed = parseKairosUri(value);
+    if (parsed.kind !== 'adapter') {
+        throw new KairosError('Invalid adapter URI. Expected kairos://adapter/{slug} or squadrules://adapter/{slug}.', 'INVALID_URI', 400);
+    }
+    return buildAdapterUri(parsed.id);
+}
+//# sourceMappingURL=kairos-uri.js.map

package/dist/tools/kairos-uri.js.map

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

package/dist/tools/local-artifact-dir-contract.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 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 declare 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 declare const SQUADRULES_LOCAL_ARTIFACT_DIR_JSON_FIELD = "squadrules_local_artifact_dir";
+export declare function buildLocalArtifactDirFields(hints: readonly string[]): Record<typeof KAIROS_LOCAL_ARTIFACT_DIR_JSON_FIELD | typeof SQUADRULES_LOCAL_ARTIFACT_DIR_JSON_FIELD, string[]>;
+//# sourceMappingURL=local-artifact-dir-contract.d.ts.map

package/dist/tools/local-artifact-dir-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-artifact-dir-contract.d.ts","sourceRoot":"","sources":["../../src/tools/local-artifact-dir-contract.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,oCAAoC,8BAA8B,CAAC;AAEhF;;;;GAIG;AACH,eAAO,MAAM,wCAAwC,kCAAkC,CAAC;AAExF,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,SAAS,MAAM,EAAE,GACvB,MAAM,CAAC,OAAO,oCAAoC,GAAG,OAAO,wCAAwC,EAAE,MAAM,EAAE,CAAC,CAQjH"}