zora-agent 0.10.0 → 0.10.2

package/dist/orchestrator/code-tool-runner.js

@@ -0,0 +1,375 @@
+/**
+ * CodeToolRunner — Tier 1 deterministic tool implementations for TLCI.
+ *
+ * Each function corresponds to a `suggestedCodeTool` hint from the StepClassifier.
+ * Callers pass structured parameters via `step.context`.
+ *
+ * Context keys (caller-provided):
+ *   httpFetch:   { url: string, headers?: Record<string,string> }
+ *   httpPost:    { url: string, body?: unknown, headers?: Record<string,string> }
+ *   transform:   { data: unknown, operation?: 'json-parse'|'json-stringify'|'to-array'|'flatten' }
+ *   collectionOp:{ data: unknown[], operation?: 'sort'|'filter'|'count'|'deduplicate', key?: string, value?: unknown }
+ *   fileOp:      { path: string, operation?: 'read'|'write'|'list'|'exists', content?: string }
+ *   compute:     { expression: string }       — safe arithmetic only (no eval)
+ *   validate:    { data: unknown, required?: string[] }
+ *   notify:      { message: string, channel?: string }
+ *   dbQuery:     { query: string }            — stub; real DB wired by caller
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import os from 'node:os';
+import { createLogger } from '../utils/logger.js';
+const log = createLogger('code-tool-runner');
+function validateUrl(url) {
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        throw new Error(`Invalid URL: ${url}`);
+    }
+    if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {
+        throw new Error(`Blocked URL scheme "${parsed.protocol}" — only http/https allowed`);
+    }
+    const host = parsed.hostname.toLowerCase();
+    // Block literal private/metadata IP ranges and known internal hostnames.
+    // KNOWN LIMITATION: DNS-rebinding attacks (public hostname → private IP) are not
+    // prevented here because pre-resolution DNS checks have an inherent TOCTOU race.
+    // For production hardening, use a network-level egress proxy or firewall instead.
+    const BLOCKED = [
+        /^localhost$/,
+        /^127\./,
+        /^10\./,
+        /^172\.(1[6-9]|2\d|3[01])\./,
+        /^192\.168\./,
+        /^169\.254\./, // link-local / AWS metadata
+        /^::1$/, // IPv6 loopback (URL parser strips brackets)
+        /^::ffff:/, // IPv4-mapped IPv6 (e.g. ::ffff:192.168.1.1)
+        /^0+:0+:0+:0+:0+:0+:0+:1$/, // full-form IPv6 loopback
+        /^metadata\.google\.internal$/,
+    ];
+    if (BLOCKED.some(r => r.test(host))) {
+        throw new Error(`Blocked host "${host}" — private/metadata addresses not allowed`);
+    }
+}
+// ─── Individual tool implementations ─────────────────────────────────────────
+async function runHttpFetch(ctx) {
+    const url = ctx['url'];
+    if (!url)
+        return { tool: 'httpFetch', success: false, error: 'context.url required' };
+    const headers = ctx['headers'] ?? {};
+    try {
+        validateUrl(url);
+    }
+    catch (err) {
+        return { tool: 'httpFetch', success: false, error: String(err) };
+    }
+    try {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 30_000);
+        const res = await fetch(url, { headers, signal: controller.signal });
+        clearTimeout(timeout);
+        const text = await res.text();
+        let data = text;
+        try {
+            data = JSON.parse(text);
+        }
+        catch { /* keep raw text */ }
+        log.debug({ url, status: res.status }, 'httpFetch complete');
+        return { tool: 'httpFetch', success: res.ok, data };
+    }
+    catch (err) {
+        return { tool: 'httpFetch', success: false, error: String(err) };
+    }
+}
+async function runHttpPost(ctx) {
+    const url = ctx['url'];
+    if (!url)
+        return { tool: 'httpPost', success: false, error: 'context.url required' };
+    const body = ctx['body'];
+    const headers = ctx['headers'] ?? { 'Content-Type': 'application/json' };
+    try {
+        validateUrl(url);
+    }
+    catch (err) {
+        return { tool: 'httpPost', success: false, error: String(err) };
+    }
+    try {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 30_000);
+        const res = await fetch(url, {
+            method: 'POST',
+            headers,
+            body: body !== undefined ? JSON.stringify(body) : undefined,
+            signal: controller.signal,
+        });
+        clearTimeout(timeout);
+        const text = await res.text();
+        let data = text;
+        try {
+            data = JSON.parse(text);
+        }
+        catch { /* keep raw text */ }
+        log.debug({ url, status: res.status }, 'httpPost complete');
+        return { tool: 'httpPost', success: res.ok, data };
+    }
+    catch (err) {
+        return { tool: 'httpPost', success: false, error: String(err) };
+    }
+}
+function runTransform(ctx) {
+    const data = ctx['data'];
+    const operation = ctx['operation'] ?? 'json-stringify';
+    try {
+        let result;
+        switch (operation) {
+            case 'json-parse':
+                result = typeof data === 'string' ? JSON.parse(data) : data;
+                break;
+            case 'json-stringify':
+                result = JSON.stringify(data, null, 2);
+                break;
+            case 'to-array':
+                result = Array.isArray(data) ? data : data !== undefined ? [data] : [];
+                break;
+            case 'flatten':
+                result = Array.isArray(data) ? data.flat(Infinity) : data;
+                break;
+            default:
+                result = data;
+        }
+        return { tool: 'transform', success: true, data: result };
+    }
+    catch (err) {
+        return { tool: 'transform', success: false, error: String(err) };
+    }
+}
+function runCollectionOp(ctx) {
+    const raw = ctx['data'];
+    const arr = Array.isArray(raw) ? raw : raw !== undefined ? [raw] : [];
+    const operation = ctx['operation'] ?? 'count';
+    const key = ctx['key'];
+    const value = ctx['value'];
+    try {
+        let result;
+        switch (operation) {
+            case 'count':
+                result = arr.length;
+                break;
+            case 'filter':
+                result = key !== undefined
+                    ? arr.filter((item) => typeof item === 'object' && item !== null && item[key] === value)
+                    : arr;
+                break;
+            case 'sort':
+                result = key !== undefined
+                    ? [...arr].sort((a, b) => {
+                        const av = typeof a === 'object' && a !== null ? a[key] : a;
+                        const bv = typeof b === 'object' && b !== null ? b[key] : b;
+                        if (av === undefined && bv === undefined)
+                            return 0;
+                        if (av === undefined)
+                            return 1;
+                        if (bv === undefined)
+                            return -1;
+                        return av < bv ? -1 : av > bv ? 1 : 0;
+                    })
+                    : [...arr].sort();
+                break;
+            case 'deduplicate':
+                result = key !== undefined
+                    ? [...new Map(arr.map((item) => [item[key], item])).values()]
+                    : [...new Set(arr)];
+                break;
+            case 'sum':
+                result = arr.reduce((acc, item) => {
+                    const v = key !== undefined && typeof item === 'object' && item !== null
+                        ? Number(item[key])
+                        : Number(item);
+                    return acc + (isNaN(v) ? 0 : v);
+                }, 0);
+                break;
+            default:
+                result = arr;
+        }
+        return { tool: 'collectionOp', success: true, data: result };
+    }
+    catch (err) {
+        return { tool: 'collectionOp', success: false, error: String(err) };
+    }
+}
+async function runFileOp(ctx) {
+    const filePath = ctx['path'];
+    if (!filePath)
+        return { tool: 'fileOp', success: false, error: 'context.path required' };
+    const expanded = filePath.replace(/^~/, os.homedir() ?? '');
+    const normalized = path.resolve(expanded);
+    if (normalized.includes('\0')) {
+        return { tool: 'fileOp', success: false, error: 'Path traversal attempt blocked' };
+    }
+    // Restrict to safe directories — block sensitive paths first, then require an allowed prefix
+    const home = os.homedir() ?? os.tmpdir();
+    const ALLOWED_PREFIXES = [
+        path.join(home, '.zora'),
+        path.join(home, 'Dev'),
+        path.join(home, 'Documents'),
+        '/tmp',
+        '/private/tmp', // macOS resolves /tmp → /private/tmp
+        os.tmpdir(), // macOS: /var/folders/... or /tmp on Linux
+        process.cwd(),
+    ];
+    const BLOCKED_PREFIXES = [
+        path.join(home, '.ssh'),
+        path.join(home, '.gnupg'),
+        path.join(home, '.aws'),
+        path.join(home, '.env'),
+        '/etc',
+        '/sys',
+        '/proc',
+    ];
+    if (BLOCKED_PREFIXES.some(p => normalized.startsWith(p))) {
+        return { tool: 'fileOp', success: false, error: `Path "${normalized}" is outside allowed workspace` };
+    }
+    if (!ALLOWED_PREFIXES.some(p => normalized.startsWith(p))) {
+        return { tool: 'fileOp', success: false, error: `Path "${normalized}" is outside allowed workspace` };
+    }
+    const operation = ctx['operation'] ?? 'read';
+    try {
+        let data;
+        switch (operation) {
+            case 'read': {
+                const raw = await fs.readFile(normalized, 'utf-8');
+                try {
+                    data = JSON.parse(raw);
+                }
+                catch {
+                    data = raw;
+                }
+                break;
+            }
+            case 'write': {
+                const content = ctx['content'];
+                const str = typeof content === 'string' ? content : JSON.stringify(content, null, 2);
+                await fs.writeFile(normalized, str, 'utf-8');
+                data = { written: str.length };
+                break;
+            }
+            case 'list': {
+                const entries = await fs.readdir(normalized, { withFileTypes: true });
+                data = entries.map(e => ({ name: e.name, isDir: e.isDirectory() }));
+                break;
+            }
+            case 'exists': {
+                try {
+                    await fs.access(normalized);
+                    data = true;
+                }
+                catch {
+                    data = false;
+                }
+                break;
+            }
+            default:
+                return { tool: 'fileOp', success: false, error: `Unknown operation: ${operation}` };
+        }
+        log.debug({ path: normalized, operation }, 'fileOp complete');
+        return { tool: 'fileOp', success: true, data };
+    }
+    catch (err) {
+        return { tool: 'fileOp', success: false, error: String(err) };
+    }
+}
+function runCompute(ctx) {
+    const expression = ctx['expression'];
+    if (!expression)
+        return { tool: 'compute', success: false, error: 'context.expression required' };
+    // Safe: only allow numbers, operators, parentheses, spaces, dots
+    if (!/^[\d\s+\-*/().%]+$/.test(expression)) {
+        return { tool: 'compute', success: false, error: 'Expression contains disallowed characters (only arithmetic allowed)' };
+    }
+    try {
+        // Use Function constructor with no scope — safe for pure arithmetic
+        // eslint-disable-next-line no-new-func
+        const result = new Function(`"use strict"; return (${expression});`)();
+        return { tool: 'compute', success: true, data: result };
+    }
+    catch (err) {
+        return { tool: 'compute', success: false, error: String(err) };
+    }
+}
+function runValidate(ctx) {
+    const data = ctx['data'];
+    const required = ctx['required'];
+    if (!required || required.length === 0) {
+        return { tool: 'validate', success: true, data: { valid: data !== null && data !== undefined } };
+    }
+    if (typeof data !== 'object' || data === null) {
+        return { tool: 'validate', success: true, data: { valid: false, missing: required } };
+    }
+    const obj = data;
+    const missing = required.filter(k => !(k in obj) || obj[k] === null || obj[k] === undefined);
+    return { tool: 'validate', success: true, data: { valid: missing.length === 0, missing } };
+}
+function runNotify(ctx) {
+    const message = ctx['message'] ?? 'Notification';
+    const channel = ctx['channel'] ?? 'log';
+    log.info({ channel, message }, 'tlci notify step');
+    return { tool: 'notify', success: true, data: { sent: true, channel, message } };
+}
+async function runDbQuery(ctx) {
+    // Stub — real DB connection is caller-provided via context.execute fn
+    const query = ctx['query'];
+    const executeFn = ctx['execute'];
+    if (executeFn && query) {
+        try {
+            const rows = await executeFn(query);
+            return { tool: 'dbQuery', success: true, data: rows };
+        }
+        catch (err) {
+            return { tool: 'dbQuery', success: false, error: String(err) };
+        }
+    }
+    log.info({ query }, 'tlci dbQuery step (stub — provide context.execute for real queries)');
+    return { tool: 'dbQuery', success: true, data: { rows: [], stub: true } };
+}
+// ─── Dispatch table ───────────────────────────────────────────────────────────
+const SYNC_TOOLS = {
+    transform: runTransform,
+    collectionOp: runCollectionOp,
+    compute: runCompute,
+    validate: runValidate,
+    notify: runNotify,
+};
+const ASYNC_TOOLS = {
+    httpFetch: runHttpFetch,
+    httpPost: runHttpPost,
+    fileOp: runFileOp,
+    dbQuery: runDbQuery,
+};
+// ─── Public runner ────────────────────────────────────────────────────────────
+/**
+ * Execute a Tier 1 code tool step.
+ * Returns a CodeToolResult — callers may inspect result.data for downstream steps.
+ */
+export async function runCodeTool(tool, context = {}) {
+    const asyncFn = ASYNC_TOOLS[tool];
+    if (asyncFn)
+        return asyncFn(context);
+    const syncFn = SYNC_TOOLS[tool];
+    if (syncFn)
+        return syncFn(context);
+    // Unknown tool — log and pass through
+    log.info({ tool }, 'tlci code-tool step (no implementation for this tool — pass-through)');
+    return { tool, success: true, data: null };
+}
+/**
+ * Resolve the suggested tool from a ClassifiedStep and run it.
+ * The step's `context` field holds structured parameters.
+ */
+export async function runCodeToolStep(step) {
+    const tool = step.suggestedCodeTool ?? 'pass-through';
+    const ctx = step.context ?? {};
+    log.debug({ stepId: step.id, tool }, 'running code tool');
+    return runCodeTool(tool, ctx);
+}
+//# sourceMappingURL=code-tool-runner.js.map

package/dist/orchestrator/code-tool-runner.js.map

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

package/dist/orchestrator/error-pattern-detector.d.ts

@@ -0,0 +1,54 @@
+/**
+ * ErrorPatternDetector — ERR-10: In-Session Repeat Detection (Circuit Breaker)
+ *
+ * Maintains a rolling window of recent tool results within a single session.
+ * If the same tool+args signature fails twice, it injects a hard steering hint
+ * to force the LLM to change its approach.
+ */
+export interface ToolAttempt {
+    signature: string;
+    toolName: string;
+    /** Canonical string of args used to generate the signature */
+    argsKey: string;
+    succeeded: boolean;
+    timestamp: number;
+}
+export interface RepeatDetectionResult {
+    /** True if the same (tool, args) has failed the threshold number of times */
+    isRepeating: boolean;
+    /** Steering hint to inject when isRepeating is true */
+    hint?: string;
+    /** Tool name that is repeating */
+    toolName?: string;
+}
+export declare class ErrorPatternDetector {
+    /** Rolling window of the last N tool attempts (per session instance) */
+    private readonly _window;
+    /**
+     * Record a tool result in the rolling window.
+     *
+     * @param toolName - Name of the tool that was called
+     * @param args - Arguments passed to the tool
+     * @param succeeded - Whether the tool call succeeded
+     * @returns RepeatDetectionResult — isRepeating=true if a steering hint should be injected
+     */
+    record(toolName: string, args: Record<string, unknown>, succeeded: boolean): RepeatDetectionResult;
+    /**
+     * Reset the rolling window (e.g. at the start of a new task).
+     */
+    reset(): void;
+    /**
+     * Return the current window contents for inspection/testing.
+     */
+    getWindow(): readonly ToolAttempt[];
+    /**
+     * Compute a stable SHA-256 hash over tool_name + canonical args string.
+     */
+    private _computeSignature;
+    /**
+     * Normalize args to a canonical string for stable hashing.
+     * Sorts keys so {a:1, b:2} and {b:2, a:1} produce the same signature.
+     */
+    private _normalizeArgs;
+}
+//# sourceMappingURL=error-pattern-detector.d.ts.map

package/dist/orchestrator/error-pattern-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-pattern-detector.d.ts","sourceRoot":"","sources":["../../src/orchestrator/error-pattern-detector.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,6EAA6E;IAC7E,WAAW,EAAE,OAAO,CAAC;IACrB,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAYD,qBAAa,oBAAoB;IAC/B,wEAAwE;IACxE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAE7C;;;;;;;OAOG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,EAAE,OAAO,GAAG,qBAAqB;IAsClG;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,SAAS,IAAI,SAAS,WAAW,EAAE;IAMnC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAQzB;;;OAGG;IACH,OAAO,CAAC,cAAc;CAGvB"}

package/dist/orchestrator/error-pattern-detector.js

@@ -0,0 +1,87 @@
+/**
+ * ErrorPatternDetector — ERR-10: In-Session Repeat Detection (Circuit Breaker)
+ *
+ * Maintains a rolling window of recent tool results within a single session.
+ * If the same tool+args signature fails twice, it injects a hard steering hint
+ * to force the LLM to change its approach.
+ */
+import crypto from 'node:crypto';
+import { canonicalizeArgs } from '../utils/args.js';
+// ─── Constants ────────────────────────────────────────────────────────
+/** How many recent tool results to keep in the rolling window */
+const WINDOW_SIZE = 5;
+/** How many failures of the same signature trigger a steering injection */
+const FAILURE_THRESHOLD = 2;
+// ─── ErrorPatternDetector ─────────────────────────────────────────────
+export class ErrorPatternDetector {
+    /** Rolling window of the last N tool attempts (per session instance) */
+    _window = [];
+    /**
+     * Record a tool result in the rolling window.
+     *
+     * @param toolName - Name of the tool that was called
+     * @param args - Arguments passed to the tool
+     * @param succeeded - Whether the tool call succeeded
+     * @returns RepeatDetectionResult — isRepeating=true if a steering hint should be injected
+     */
+    record(toolName, args, succeeded) {
+        const argsKey = this._normalizeArgs(args);
+        const signature = this._computeSignature(toolName, argsKey);
+        const attempt = {
+            signature,
+            toolName,
+            argsKey,
+            succeeded,
+            timestamp: Date.now(),
+        };
+        // Append and keep only the last WINDOW_SIZE entries
+        this._window.push(attempt);
+        if (this._window.length > WINDOW_SIZE) {
+            this._window.shift();
+        }
+        // Check if this signature has failed >= FAILURE_THRESHOLD times in the window
+        if (!succeeded) {
+            const failureCount = this._window.filter(a => a.signature === signature && !a.succeeded).length;
+            if (failureCount >= FAILURE_THRESHOLD) {
+                return {
+                    isRepeating: true,
+                    toolName,
+                    hint: `You have attempted ${toolName} with these arguments ${failureCount} time(s) and failed. ` +
+                        `You MUST change your parameters or use a different tool.`,
+                };
+            }
+        }
+        return { isRepeating: false };
+    }
+    /**
+     * Reset the rolling window (e.g. at the start of a new task).
+     */
+    reset() {
+        this._window.length = 0;
+    }
+    /**
+     * Return the current window contents for inspection/testing.
+     */
+    getWindow() {
+        return this._window;
+    }
+    // ─── Internal ──────────────────────────────────────────────────────
+    /**
+     * Compute a stable SHA-256 hash over tool_name + canonical args string.
+     */
+    _computeSignature(toolName, argsKey) {
+        return crypto
+            .createHash('sha256')
+            .update(toolName + ':' + argsKey)
+            .digest('hex')
+            .slice(0, 16); // 16 hex chars = 64 bits — sufficient for in-session use
+    }
+    /**
+     * Normalize args to a canonical string for stable hashing.
+     * Sorts keys so {a:1, b:2} and {b:2, a:1} produce the same signature.
+     */
+    _normalizeArgs(args) {
+        return canonicalizeArgs(args);
+    }
+}
+//# sourceMappingURL=error-pattern-detector.js.map

package/dist/orchestrator/error-pattern-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-pattern-detector.js","sourceRoot":"","sources":["../../src/orchestrator/error-pattern-detector.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAsBpD,yEAAyE;AAEzE,iEAAiE;AACjE,MAAM,WAAW,GAAG,CAAC,CAAC;AAEtB,2EAA2E;AAC3E,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAE5B,yEAAyE;AAEzE,MAAM,OAAO,oBAAoB;IAC/B,wEAAwE;IACvD,OAAO,GAAkB,EAAE,CAAC;IAE7C;;;;;;;OAOG;IACH,MAAM,CAAC,QAAgB,EAAE,IAA6B,EAAE,SAAkB;QACxE,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,iBAAiB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAE5D,MAAM,OAAO,GAAgB;YAC3B,SAAS;YACT,QAAQ;YACR,OAAO;YACP,SAAS;YACT,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC;QAEF,oDAAoD;QACpD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3B,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,WAAW,EAAE,CAAC;YACtC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;QAED,8EAA8E;QAC9E,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CACtC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,SAAS,IAAI,CAAC,CAAC,CAAC,SAAS,CAC/C,CAAC,MAAM,CAAC;YAET,IAAI,YAAY,IAAI,iBAAiB,EAAE,CAAC;gBACtC,OAAO;oBACL,WAAW,EAAE,IAAI;oBACjB,QAAQ;oBACR,IAAI,EACF,sBAAsB,QAAQ,yBAAyB,YAAY,uBAAuB;wBAC1F,0DAA0D;iBAC7D,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,sEAAsE;IAEtE;;OAEG;IACK,iBAAiB,CAAC,QAAgB,EAAE,OAAe;QACzD,OAAO,MAAM;aACV,UAAU,CAAC,QAAQ,CAAC;aACpB,MAAM,CAAC,QAAQ,GAAG,GAAG,GAAG,OAAO,CAAC;aAChC,MAAM,CAAC,KAAK,CAAC;aACb,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,yDAAyD;IAC5E,CAAC;IAED;;;OAGG;IACK,cAAc,CAAC,IAA6B;QAClD,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;CACF"}

package/dist/orchestrator/execution-planner.d.ts

@@ -0,0 +1,33 @@
+import { type ClassifiedStep, type WorkflowStep, type StepTier } from './step-classifier.js';
+export interface TierBreakdown {
+    code: number;
+    slm: number;
+    frontier: number;
+}
+export interface CostComparison {
+    tlciEstimate: number;
+    allLLMEstimate: number;
+    savingsUSD: number;
+    savingsPct: number;
+}
+export interface ExecutionPlan {
+    planId: string;
+    planHash: string;
+    steps: ClassifiedStep[];
+    tierBreakdown: TierBreakdown;
+    costComparison: CostComparison;
+    createdAt: number;
+    approvedAt?: number;
+    approved: boolean;
+}
+export type { StepTier };
+/**
+ * Compute a deterministic plan hash from step descriptions and type metadata.
+ * Excludes `context` (runtime state) — only classification-relevant fields are hashed.
+ * 32 hex chars (128 bits) to reduce collision risk.
+ */
+export declare function computePlanHash(steps: WorkflowStep[]): string;
+export declare function buildExecutionPlan(steps: WorkflowStep[]): ExecutionPlan;
+export declare function formatPlanForApproval(plan: ExecutionPlan): string;
+export declare function formatPlanSummary(plan: ExecutionPlan): string;
+//# sourceMappingURL=execution-planner.d.ts.map

package/dist/orchestrator/execution-planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-planner.d.ts","sourceRoot":"","sources":["../../src/orchestrator/execution-planner.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiB,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAE5G,MAAM,WAAW,aAAa;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;CAAE;AAC/E,MAAM,WAAW,cAAc;IAAG,YAAY,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;CAAE;AACzH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,cAAc,EAAE,CAAC;IAC1D,aAAa,EAAE,aAAa,CAAC;IAAC,cAAc,EAAE,cAAc,CAAC;IAC7D,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC;CAC3D;AAGD,YAAY,EAAE,QAAQ,EAAE,CAAC;AAEzB;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,MAAM,CAO7D;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,aAAa,CAqBvE;AAoBD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAcjE;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAM7D"}

package/dist/orchestrator/execution-planner.js

@@ -0,0 +1,67 @@
+// Stub — full implementation in feature/tlci-foundation (will be resolved on merge)
+import { createHash } from 'node:crypto';
+import { classifySteps } from './step-classifier.js';
+/**
+ * Compute a deterministic plan hash from step descriptions and type metadata.
+ * Excludes `context` (runtime state) — only classification-relevant fields are hashed.
+ * 32 hex chars (128 bits) to reduce collision risk.
+ */
+export function computePlanHash(steps) {
+    return createHash('sha256')
+        .update(steps.map(s => `${s.description.trim().toLowerCase()}|${s.inputType ?? ''}|${s.outputType ?? ''}`).join('||'))
+        .digest('hex')
+        .slice(0, 32);
+}
+export function buildExecutionPlan(steps) {
+    const classified = classifySteps(steps);
+    const tierBreakdown = classified.reduce((acc, s) => { acc[s.tier]++; return acc; }, { code: 0, slm: 0, frontier: 0 });
+    const tlciEstimate = classified.reduce((sum, s) => sum + s.estimatedCostUSD, 0);
+    const allLLMEstimate = steps.length * 0.065;
+    const savingsUSD = allLLMEstimate - tlciEstimate;
+    const savingsPct = allLLMEstimate === 0 ? 0 : Math.round((savingsUSD / allLLMEstimate) * 100);
+    const planHash = computePlanHash(steps);
+    const planId = `plan_${Date.now()}_${Math.random().toString(36).slice(2, 7)}`;
+    return {
+        planId,
+        planHash,
+        steps: classified,
+        tierBreakdown,
+        costComparison: { tlciEstimate, allLLMEstimate, savingsUSD, savingsPct },
+        createdAt: Date.now(),
+        approved: false,
+    };
+}
+const TIER_ICONS = {
+    code: '⚙️',
+    slm: '🔵',
+    frontier: '🟣',
+};
+const TIER_LABELS = {
+    code: 'CODE  ',
+    slm: 'SLM   ',
+    frontier: 'AI    ',
+};
+/** Strip ANSI escape sequences from user-supplied text to prevent terminal injection. */
+function sanitize(s) {
+    // eslint-disable-next-line no-control-regex
+    return s.replace(/\x1b\[[0-9;]*[a-zA-Z]/g, '').replace(/[\x00-\x08\x0b-\x1f\x7f]/g, '');
+}
+export function formatPlanForApproval(plan) {
+    const { steps, tierBreakdown, costComparison } = plan;
+    const lines = [
+        `┌─ Execution Plan ──────────────────────────────────────`,
+        `│  Est. cost:  $${costComparison.tlciEstimate.toFixed(4)}  (vs $${costComparison.allLLMEstimate.toFixed(2)} all-LLM → ${costComparison.savingsPct}% savings)`,
+        `│  Tiers:      ⚙️  ${tierBreakdown.code} code   🔵 ${tierBreakdown.slm} local   🟣 ${tierBreakdown.frontier} frontier`,
+        `├───────────────────────────────────────────────────────`,
+        ...steps.map((s, i) => `│  ${String(i + 1).padStart(2)}. ${TIER_ICONS[s.tier]} [${TIER_LABELS[s.tier]}] ${sanitize(s.description)}`),
+        `└───────────────────────────────────────────────────────`,
+        `  Proceed? (y/n/edit)`,
+    ];
+    return lines.join('\n');
+}
+export function formatPlanSummary(plan) {
+    const { tierBreakdown, costComparison } = plan;
+    return (`TLCI Plan: ${tierBreakdown.code} code / ${tierBreakdown.slm} SLM / ${tierBreakdown.frontier} frontier` +
+        ` | Est. $${costComparison.tlciEstimate.toFixed(4)} (${costComparison.savingsPct}% cheaper than all-LLM)`);
+}
+//# sourceMappingURL=execution-planner.js.map