@zhixuan92/multi-model-agent-core 2.7.5 → 3.0.0

package/dist/executors/execute-plan.js

@@ -0,0 +1,128 @@
+// packages/core/src/executors/execute-plan.ts
+import { randomUUID } from 'node:crypto';
+import { readFile } from 'node:fs/promises';
+import { runTasks, extractPlanSection } from '../run-tasks.js';
+import { computeTimings, computeAggregateCost } from './shared-compute.js';
+// --- Ported from packages/mcp/src/tools/execute-plan.ts ---
+function buildExecutePlanPrompt(fileContents, task, context) {
+    const parts = [
+        'Below are the plan and/or spec documents for this project:',
+        '',
+        '---',
+        fileContents,
+        '---',
+        '',
+        'Execute the following task from the documents above:',
+        '',
+        `Requested task: "${task}"`,
+    ];
+    if (context) {
+        parts.push('', `Additional context: ${context}`);
+    }
+    parts.push('', 'Find this task in the plan/spec documents above (not in any preceding context blocks),', 'understand its requirements, and implement it fully.', 'Follow any acceptance criteria, file paths, and constraints specified in the plan.', 'If you cannot find a unique matching task, report that no match was found and do not implement anything.');
+    return parts.join('\n');
+}
+function autoRegisterContextBlock(results, store) {
+    if (!store)
+        return undefined;
+    const usable = results.filter(r => !r.outputIsDiagnostic && r.output.trim().length > 0);
+    if (usable.length === 0)
+        return undefined;
+    const combined = usable.map(r => r.output).join('\n\n---\n\n');
+    const { id } = store.register(combined);
+    return id;
+}
+export async function executeExecutePlan(ctx, input) {
+    const { config, contextBlockStore } = ctx;
+    const filePaths = input.filePaths;
+    const validPaths = (filePaths ?? []).filter(p => p.trim().length > 0);
+    if (validPaths.length === 0) {
+        return {
+            error: 'Provide filePaths with at least one plan or spec file',
+            isError: true,
+        };
+    }
+    // Read all plan/spec files
+    let fileContents;
+    try {
+        const contents = await Promise.all(validPaths.map(async (fp) => {
+            const content = await readFile(fp, 'utf-8');
+            return `--- ${fp} ---\n${content}`;
+        }));
+        fileContents = contents.join('\n\n');
+    }
+    catch (err) {
+        return {
+            error: `Error reading plan files: ${err instanceof Error ? err.message : String(err)}`,
+            isError: true,
+        };
+    }
+    const parentModel = ctx.parentModel ?? config.defaults?.parentModel ?? undefined;
+    const baseTaskSpec = {
+        agentType: 'standard',
+        reviewPolicy: 'full',
+        briefQualityPolicy: 'off',
+        done: 'Implement the task fully. Report: which task heading you matched, what files were created or modified, and any issues encountered. If no unique matching task was found, report that explicitly and do not implement anything.',
+        tools: config.defaults?.tools ?? 'full',
+        timeoutMs: config.defaults?.timeoutMs ?? 1_800_000,
+        maxCostUSD: config.defaults?.maxCostUSD ?? 10,
+        sandboxPolicy: config.defaults?.sandboxPolicy ?? 'cwd-only',
+        cwd: ctx.projectContext.cwd,
+        contextBlockIds: input.contextBlockIds,
+        parentModel,
+        autoCommit: true,
+    };
+    const runtime = contextBlockStore ? { contextBlockStore } : undefined;
+    const tasks = input.tasks.map(task => ({
+        ...baseTaskSpec,
+        prompt: buildExecutePlanPrompt(fileContents, task, input.context),
+    }));
+    // Inject plan section context so spec reviewer checks implementation against the plan
+    for (let i = 0; i < tasks.length; i++) {
+        const section = await extractPlanSection(validPaths, input.tasks[i], baseTaskSpec.cwd);
+        if (section) {
+            tasks[i].planContext = section;
+        }
+    }
+    if (tasks.length === 1) {
+        const results = await runTasks(tasks, config, { runtime });
+        const result = results[0];
+        if (!result) {
+            return {
+                error: 'task produced no result',
+                isError: true,
+            };
+        }
+        const ctxId = autoRegisterContextBlock(results, contextBlockStore);
+        const batchTimings = computeTimings(0, results);
+        const costSummary = computeAggregateCost(results);
+        return {
+            results,
+            headline: '',
+            batchTimings,
+            costSummary,
+            batchId: randomUUID(),
+            wallClockMs: 0,
+            parentModel,
+            ...(ctxId !== undefined && { contextBlockId: ctxId }),
+        };
+    }
+    // Multiple tasks = fan out (parallel)
+    const startMs = Date.now();
+    const results = await runTasks(tasks, config, { runtime });
+    const wallClockMs = Date.now() - startMs;
+    const ctxId = autoRegisterContextBlock(results, contextBlockStore);
+    const batchTimings = computeTimings(wallClockMs, results);
+    const costSummary = computeAggregateCost(results);
+    return {
+        results,
+        headline: '',
+        batchTimings,
+        costSummary,
+        batchId: randomUUID(),
+        wallClockMs,
+        parentModel,
+        ...(ctxId !== undefined && { contextBlockId: ctxId }),
+    };
+}
+//# sourceMappingURL=execute-plan.js.map

package/dist/executors/execute-plan.js.map

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

package/dist/executors/index.d.ts

@@ -0,0 +1,9 @@
+export * from './types.js';
+export { executeDelegate } from './delegate.js';
+export { executeAudit } from './audit.js';
+export { executeReview } from './review.js';
+export { executeVerify } from './verify.js';
+export { executeDebug } from './debug.js';
+export { executeExecutePlan } from './execute-plan.js';
+export { executeRetry } from './retry.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/executors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/executors/index.ts"],"names":[],"mappings":"AACA,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/executors/index.js

@@ -0,0 +1,10 @@
+// packages/core/src/executors/index.ts
+export * from './types.js';
+export { executeDelegate } from './delegate.js';
+export { executeAudit } from './audit.js';
+export { executeReview } from './review.js';
+export { executeVerify } from './verify.js';
+export { executeDebug } from './debug.js';
+export { executeExecutePlan } from './execute-plan.js';
+export { executeRetry } from './retry.js';
+//# sourceMappingURL=index.js.map

package/dist/executors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/executors/index.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/executors/retry.d.ts

@@ -0,0 +1,20 @@
+import type { ExecutionContext, ExecutorOutput } from './types.js';
+import type { Input } from '../tool-schemas/retry.js';
+import type { TaskSpec } from '../types.js';
+import { runTasks } from '../run-tasks.js';
+export interface RetryOptions {
+    /**
+     * Injects harness-level defaults (tools, timeoutMs, cwd, etc.) into each TaskSpec.
+     * Provided by the MCP layer.
+     */
+    injectDefaults: (tasks: TaskSpec[]) => TaskSpec[];
+    /**
+     * Optional override for `runTasks` — used in tests to inject a mock implementation.
+     */
+    runTasksOverride?: typeof runTasks;
+}
+export interface RetryOutput extends ExecutorOutput {
+    retryBatchId: string;
+}
+export declare function executeRetry(ctx: ExecutionContext, input: Input, options: RetryOptions): Promise<RetryOutput>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/executors/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/executors/retry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAK3C,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,cAAc,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,QAAQ,EAAE,CAAC;IAClD;;OAEG;IACH,gBAAgB,CAAC,EAAE,OAAO,QAAQ,CAAC;CACpC;AAED,MAAM,WAAW,WAAY,SAAQ,cAAc;IACjD,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,wBAAsB,YAAY,CAChC,GAAG,EAAE,gBAAgB,EACrB,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,WAAW,CAAC,CA6DtB"}

package/dist/executors/retry.js

@@ -0,0 +1,65 @@
+import { runTasks } from '../run-tasks.js';
+import { computeTimings, computeAggregateCost } from './shared-compute.js';
+export async function executeRetry(ctx, input, options) {
+    const { config, projectContext, contextBlockStore } = ctx;
+    const { batchCache } = projectContext;
+    const { injectDefaults } = options;
+    const runTasksImpl = options.runTasksOverride ?? runTasks;
+    const batch = batchCache.get(input.batchId);
+    if (!batch) {
+        throw new Error(`batch "${input.batchId}" is unknown or expired — re-dispatch with full task specs via delegate_tasks`);
+    }
+    // Mark this batch as recently used so the LRU eviction does not
+    // drop a hot entry when newer batches arrive. Does NOT refresh TTL.
+    batchCache.touch(input.batchId);
+    for (const i of input.taskIndices) {
+        if (i < 0 || i >= batch.tasks.length) {
+            throw new Error(`index ${i} is out of range for batch ${input.batchId} (size ${batch.tasks.length})`);
+        }
+    }
+    const subset = input.taskIndices.map((i) => batch.tasks[i]);
+    // Create a fresh batch for the retried tasks so the original batch
+    // entry is preserved and get_batch_slice can still retrieve it.
+    const retryBatchId = batchCache.remember(subset);
+    const batchStartMs = Date.now();
+    let results = [];
+    let retryAborted = false;
+    try {
+        results = await runTasksImpl(injectDefaults(subset), config, {
+            runtime: { contextBlockStore },
+        });
+    }
+    catch (err) {
+        retryAborted = true;
+        throw err;
+    }
+    finally {
+        if (retryAborted) {
+            try {
+                batchCache.abort(retryBatchId);
+            }
+            catch { /* already terminal */ }
+        }
+        else {
+            try {
+                batchCache.complete(retryBatchId, results);
+            }
+            catch { /* already terminal */ }
+        }
+    }
+    const wallClockMs = Date.now() - batchStartMs;
+    const batchTimings = computeTimings(wallClockMs, results);
+    const costSummary = computeAggregateCost(results);
+    const parentModel = ctx.parentModel ?? config.defaults?.parentModel ?? undefined;
+    return {
+        results,
+        headline: '',
+        batchTimings,
+        costSummary,
+        batchId: retryBatchId,
+        retryBatchId,
+        wallClockMs,
+        parentModel,
+    };
+}
+//# sourceMappingURL=retry.js.map

package/dist/executors/retry.js.map

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

package/dist/executors/review.d.ts

@@ -0,0 +1,7 @@
+import type { ExecutionContext, ExecutorOutput } from './types.js';
+import type { Input } from '../tool-schemas/review.js';
+export interface ReviewOutput extends ExecutorOutput {
+    contextBlockId?: string;
+}
+export declare function executeReview(ctx: ExecutionContext, input: Input): Promise<ReviewOutput>;
+//# sourceMappingURL=review.d.ts.map

package/dist/executors/review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../src/executors/review.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAuFvD,MAAM,WAAW,YAAa,SAAQ,cAAc;IAClD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAsB,aAAa,CACjC,GAAG,EAAE,gBAAgB,EACrB,KAAK,EAAE,KAAK,GACX,OAAO,CAAC,YAAY,CAAC,CAkEvB"}

package/dist/executors/review.js

@@ -0,0 +1,128 @@
+// packages/core/src/executors/review.ts
+import { randomUUID } from 'node:crypto';
+import { runTasks } from '../run-tasks.js';
+import { computeTimings, computeAggregateCost } from './shared-compute.js';
+// --- Ported from packages/mcp/src/tools/review-code.ts ---
+const REVIEW_DONE_CONDITIONS = {
+    security: 'Identify security vulnerabilities with severity, location, and remediation.',
+    performance: 'Identify performance issues with impact level, location, and fix recommendation.',
+    correctness: 'Identify logic errors, edge cases, and contract violations with severity and location.',
+    style: 'Identify style issues, naming inconsistencies, and dead code with location and fix.',
+};
+const DELTA_REVIEW_SUFFIX = ' Perform a full review (do not reduce thoroughness). Verify each prior finding as addressed or unaddressed. Omit addressed prior findings. Include unaddressed prior findings and new findings. End with a summary of which prior findings were resolved.';
+function resolveReviewDoneCondition(focus, hasContextBlocks) {
+    let base;
+    if (!focus || focus.length === 0) {
+        base = 'Review code for correctness, security, performance, and style. Each finding has category, severity, location, and recommendation.';
+    }
+    else {
+        base = focus.map(f => REVIEW_DONE_CONDITIONS[f] ?? '').filter(Boolean).join(' ');
+    }
+    return hasContextBlocks ? base + DELTA_REVIEW_SUFFIX : base;
+}
+function buildFilePathsPrompt(filePaths) {
+    if (!filePaths || filePaths.length === 0)
+        return '';
+    return `Read and analyze these files:\n${filePaths.map(p => `- ${p}`).join('\n')}`;
+}
+function buildPerFilePrompt(filePath, promptTemplate) {
+    return `${promptTemplate}\n\nRead and analyze this file:\n- ${filePath}`;
+}
+function buildReviewPrompt(code, filePaths, focus, hasContextBlocks) {
+    const parts = ['Review this code:'];
+    if (code)
+        parts.push(`\`\`\`\n${code}\n\`\`\``);
+    const fileSection = buildFilePathsPrompt(filePaths);
+    if (fileSection)
+        parts.push(fileSection);
+    if (focus && focus.length > 0)
+        parts.push(`Focus areas: ${focus.join(', ')}.`);
+    if (hasContextBlocks) {
+        parts.push('Context is provided above (e.g. a diff or prior review). Perform a full review as normal — do not skip areas or reduce thoroughness.', 'If the context contains prior review findings:', '- **Omit** findings that have been addressed — do not re-report them.', '- **Include** findings that are still present (mark as "unfixed from prior review").', '- **Include** any new findings.', '- End with a **Fixed** summary listing which prior findings were resolved.');
+    }
+    else {
+        parts.push('Provide a structured review with findings and recommendations.');
+    }
+    return parts.join('\n\n');
+}
+function hasContent(value) {
+    return value !== undefined && value.trim().length > 0;
+}
+function resolveDispatchMode(inlineContent, filePaths) {
+    if (hasContent(inlineContent))
+        return 'single';
+    const validPaths = (filePaths ?? []).filter(p => p.trim().length > 0);
+    if (validPaths.length >= 2)
+        return 'fan_out';
+    return 'single';
+}
+function autoRegisterContextBlock(results, store) {
+    if (!store)
+        return undefined;
+    const usable = results.filter(r => !r.outputIsDiagnostic && r.output.trim().length > 0);
+    if (usable.length === 0)
+        return undefined;
+    const combined = usable.map(r => r.output).join('\n\n---\n\n');
+    const { id } = store.register(combined);
+    return id;
+}
+export async function executeReview(ctx, input) {
+    const { config, contextBlockStore } = ctx;
+    const hasContextBlocks = Array.isArray(input.contextBlockIds) && input.contextBlockIds.length > 0;
+    const parentModel = ctx.parentModel ?? config.defaults?.parentModel ?? undefined;
+    const baseTaskSpec = {
+        agentType: 'complex',
+        reviewPolicy: 'full',
+        briefQualityPolicy: 'off',
+        done: resolveReviewDoneCondition(input.focus, hasContextBlocks),
+        tools: config.defaults?.tools ?? 'full',
+        timeoutMs: config.defaults?.timeoutMs ?? 1_800_000,
+        maxCostUSD: config.defaults?.maxCostUSD ?? 10,
+        sandboxPolicy: config.defaults?.sandboxPolicy ?? 'cwd-only',
+        cwd: ctx.projectContext.cwd,
+        contextBlockIds: input.contextBlockIds,
+        parentModel,
+    };
+    const runtime = contextBlockStore ? { contextBlockStore } : undefined;
+    const mode = resolveDispatchMode(input.code, input.filePaths);
+    if (mode === 'fan_out') {
+        const validPaths = input.filePaths.filter(p => p.trim().length > 0);
+        const promptTemplate = buildReviewPrompt(undefined, undefined, input.focus, hasContextBlocks);
+        const tasks = validPaths.map(fp => ({
+            ...baseTaskSpec,
+            prompt: buildPerFilePrompt(fp, promptTemplate),
+        }));
+        const startMs = Date.now();
+        const results = await runTasks(tasks, config, { runtime });
+        const wallClockMs = Date.now() - startMs;
+        const ctxId = autoRegisterContextBlock(results, contextBlockStore);
+        const batchTimings = computeTimings(wallClockMs, results);
+        const costSummary = computeAggregateCost(results);
+        return {
+            results,
+            headline: '',
+            batchTimings,
+            costSummary,
+            batchId: randomUUID(),
+            wallClockMs,
+            parentModel,
+            ...(ctxId !== undefined && { contextBlockId: ctxId }),
+        };
+    }
+    const prompt = buildReviewPrompt(input.code, input.filePaths, input.focus, hasContextBlocks);
+    const results = await runTasks([{ ...baseTaskSpec, prompt }], config, { runtime });
+    const ctxId = autoRegisterContextBlock(results, contextBlockStore);
+    const batchTimings = computeTimings(0, results);
+    const costSummary = computeAggregateCost(results);
+    return {
+        results,
+        headline: '',
+        batchTimings,
+        costSummary,
+        batchId: randomUUID(),
+        wallClockMs: 0,
+        parentModel,
+        ...(ctxId !== undefined && { contextBlockId: ctxId }),
+    };
+}
+//# sourceMappingURL=review.js.map

package/dist/executors/review.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review.js","sourceRoot":"","sources":["../../src/executors/review.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAIzC,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3E,4DAA4D;AAE5D,MAAM,sBAAsB,GAA2B;IACrD,QAAQ,EAAE,6EAA6E;IACvF,WAAW,EAAE,kFAAkF;IAC/F,WAAW,EAAE,wFAAwF;IACrG,KAAK,EAAE,qFAAqF;CAC7F,CAAC;AAEF,MAAM,mBAAmB,GAAG,2PAA2P,CAAC;AAExR,SAAS,0BAA0B,CAAC,KAA2B,EAAE,gBAAyB;IACxF,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,IAAI,GAAG,mIAAmI,CAAC;IAC7I,CAAC;SAAM,CAAC;QACN,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,sBAAsB,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnF,CAAC;IACD,OAAO,gBAAgB,CAAC,CAAC,CAAC,IAAI,GAAG,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9D,CAAC;AAED,SAAS,oBAAoB,CAAC,SAAoB;IAChD,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACpD,OAAO,kCAAkC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AACrF,CAAC;AAED,SAAS,kBAAkB,CAAC,QAAgB,EAAE,cAAsB;IAClE,OAAO,GAAG,cAAc,sCAAsC,QAAQ,EAAE,CAAC;AAC3E,CAAC;AAED,SAAS,iBAAiB,CACxB,IAAwB,EACxB,SAA+B,EAC/B,KAA2B,EAC3B,gBAAyB;IAEzB,MAAM,KAAK,GAAa,CAAC,mBAAmB,CAAC,CAAC;IAC9C,IAAI,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,UAAU,CAAC,CAAC;IAChD,MAAM,WAAW,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC;IACpD,IAAI,WAAW;QAAE,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACzC,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,gBAAgB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/E,IAAI,gBAAgB,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CACR,sIAAsI,EACtI,gDAAgD,EAChD,uEAAuE,EACvE,sFAAsF,EACtF,iCAAiC,EACjC,4EAA4E,CAC7E,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED,SAAS,UAAU,CAAC,KAAyB;IAC3C,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;AACxD,CAAC;AAED,SAAS,mBAAmB,CAC1B,aAAiC,EACjC,SAA+B;IAE/B,IAAI,UAAU,CAAC,aAAa,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC/C,MAAM,UAAU,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACtE,IAAI,UAAU,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IAC7C,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,wBAAwB,CAC/B,OAA0C,EAC1C,KAAgF;IAEhF,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,kBAAkB,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACxF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC1C,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC/D,MAAM,EAAE,EAAE,EAAE,GAAG,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACxC,OAAO,EAAE,CAAC;AACZ,CAAC;AAMD,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,GAAqB,EACrB,KAAY;IAEZ,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,GAAG,GAAG,CAAC;IAE1C,MAAM,gBAAgB,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,IAAI,KAAK,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC;IAClG,MAAM,WAAW,GAAG,GAAG,CAAC,WAAW,IAAI,MAAM,CAAC,QAAQ,EAAE,WAAW,IAAI,SAAS,CAAC;IAEjF,MAAM,YAAY,GAAsB;QACtC,SAAS,EAAE,SAAS;QACpB,YAAY,EAAE,MAAM;QACpB,kBAAkB,EAAE,KAAK;QACzB,IAAI,EAAE,0BAA0B,CAAC,KAAK,CAAC,KAAK,EAAE,gBAAgB,CAAC;QAC/D,KAAK,EAAE,MAAM,CAAC,QAAQ,EAAE,KAAK,IAAI,MAAM;QACvC,SAAS,EAAE,MAAM,CAAC,QAAQ,EAAE,SAAS,IAAI,SAAS;QAClD,UAAU,EAAE,MAAM,CAAC,QAAQ,EAAE,UAAU,IAAI,EAAE;QAC7C,aAAa,EAAE,MAAM,CAAC,QAAQ,EAAE,aAAa,IAAI,UAAU;QAC3D,GAAG,EAAE,GAAG,CAAC,cAAc,CAAC,GAAG;QAC3B,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,WAAW;KACZ,CAAC;IACF,MAAM,OAAO,GAAG,iBAAiB,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAEtE,MAAM,IAAI,GAAG,mBAAmB,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IAE9D,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,UAAU,GAAG,KAAK,CAAC,SAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACrE,MAAM,cAAc,GAAG,iBAAiB,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC;QAC9F,MAAM,KAAK,GAAe,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YAC9C,GAAG,YAAY;YACf,MAAM,EAAE,kBAAkB,CAAC,EAAE,EAAE,cAAc,CAAC;SAClC,CAAA,CAAC,CAAC;QAEhB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAC3D,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC;QACzC,MAAM,KAAK,GAAG,wBAAwB,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC;QACnE,MAAM,YAAY,GAAG,cAAc,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAC1D,MAAM,WAAW,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;QAElD,OAAO;YACL,OAAO;YACP,QAAQ,EAAE,EAAE;YACZ,YAAY;YACZ,WAAW;YACX,OAAO,EAAE,UAAU,EAAE;YACrB,WAAW;YACX,WAAW;YACX,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC;SACtD,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC;IAC7F,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,CAAC,EAAE,GAAG,YAAY,EAAE,MAAM,EAAc,CAAC,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAC/F,MAAM,KAAK,GAAG,wBAAwB,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC;IACnE,MAAM,YAAY,GAAG,cAAc,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAChD,MAAM,WAAW,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAElD,OAAO;QACL,OAAO;QACP,QAAQ,EAAE,EAAE;QACZ,YAAY;QACZ,WAAW;QACX,OAAO,EAAE,UAAU,EAAE;QACrB,WAAW,EAAE,CAAC;QACd,WAAW;QACX,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC;KACtD,CAAC;AACJ,CAAC"}

package/dist/executors/shared-compute.d.ts

@@ -0,0 +1,4 @@
+import type { RunResult, BatchTimings, BatchAggregateCost } from '../types.js';
+export declare function computeTimings(wallClockMs: number, results: RunResult[]): BatchTimings;
+export declare function computeAggregateCost(results: RunResult[]): BatchAggregateCost;
+//# sourceMappingURL=shared-compute.d.ts.map

package/dist/executors/shared-compute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-compute.d.ts","sourceRoot":"","sources":["../../src/executors/shared-compute.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAE/E,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,YAAY,CAItF;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,kBAAkB,CAY7E"}

package/dist/executors/shared-compute.js

@@ -0,0 +1,19 @@
+export function computeTimings(wallClockMs, results) {
+    const sumOfTaskMs = results.reduce((sum, r) => sum + (r.durationMs ?? 0), 0);
+    const estimatedParallelSavingsMs = Math.max(0, sumOfTaskMs - wallClockMs);
+    return { wallClockMs, sumOfTaskMs, estimatedParallelSavingsMs };
+}
+export function computeAggregateCost(results) {
+    let totalActualCostUSD = 0;
+    let totalSavedCostUSD = 0;
+    for (const r of results) {
+        if (r.usage.costUSD !== null && r.usage.costUSD !== undefined) {
+            totalActualCostUSD += r.usage.costUSD;
+        }
+        if (r.usage.savedCostUSD !== null && r.usage.savedCostUSD !== undefined) {
+            totalSavedCostUSD += r.usage.savedCostUSD;
+        }
+    }
+    return { totalActualCostUSD, totalSavedCostUSD };
+}
+//# sourceMappingURL=shared-compute.js.map

package/dist/executors/shared-compute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-compute.js","sourceRoot":"","sources":["../../src/executors/shared-compute.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,cAAc,CAAC,WAAmB,EAAE,OAAoB;IACtE,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC7E,MAAM,0BAA0B,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,GAAG,WAAW,CAAC,CAAC;IAC1E,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,0BAA0B,EAAE,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAAoB;IACvD,IAAI,kBAAkB,GAAG,CAAC,CAAC;IAC3B,IAAI,iBAAiB,GAAG,CAAC,CAAC;IAC1B,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,KAAK,IAAI,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAC9D,kBAAkB,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC;QACxC,CAAC;QACD,IAAI,CAAC,CAAC,KAAK,CAAC,YAAY,KAAK,IAAI,IAAI,CAAC,CAAC,KAAK,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YACxE,iBAAiB,IAAI,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC;QAC5C,CAAC;IACH,CAAC;IACD,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,CAAC;AACnD,CAAC"}

package/dist/executors/types.d.ts

@@ -0,0 +1,65 @@
+import type { ProjectContext } from '../project-context.js';
+import type { Provider, RunResult, BatchTimings, BatchAggregateCost, MultiModelConfig } from '../types.js';
+import type { DiagnosticLogger } from '../diagnostics/disconnect-log.js';
+import type { ContextBlockStore } from '../context/context-block-store.js';
+export interface ClarificationProposal {
+    kind: string;
+    interpretation: string;
+    details?: Record<string, unknown>;
+}
+export type ClarificationResponse = {
+    interpretation: string;
+};
+export interface ProgressEvent {
+    kind: string;
+    message: string;
+    timestamp: number;
+}
+export interface ExecutionContext {
+    projectContext: ProjectContext;
+    config: MultiModelConfig;
+    /**
+     * Diagnostic logger for the request scope.
+     *
+     * NOTE: interface-populated but not currently consumed by any executor. Diagnostic events
+     * today emit from the HTTP pipeline and `run-tasks.ts` runner layer. Retained so future
+     * executor-internal events (e.g. mid-flight aborts, partial-progress signals) can flow
+     * through the same scoped logger.
+     */
+    logger: DiagnosticLogger;
+    contextBlockStore: ContextBlockStore;
+    /**
+     * Resolves a named agent profile (e.g. "standard", "complex") to a Provider instance.
+     *
+     * NOTE: interface-populated but not currently consumed by any executor. Today executors pass
+     * `ctx.config` to `runTasks()`, which resolves providers internally via `createProvider`.
+     * Declared here because the 3.0.0 plan mandates this channel; retained so future per-request
+     * provider overrides (tenant auth, per-request model swap) can flow through the context.
+     */
+    providerFactory: (profile: string) => Provider;
+    /** Optional progress callback for streaming progress events to callers. */
+    onProgress?: (event: ProgressEvent) => void;
+    /** Awaits a clarification response from the caller. Not supported in MCP context (stub rejects). */
+    awaitClarification: (proposal: ClarificationProposal) => Promise<ClarificationResponse>;
+    /** The parent model name, resolved from env at context-build time. */
+    parentModel?: string;
+}
+/**
+ * Uniform output envelope returned by every executor.
+ * Required shape for GET /batch/:id?taskIndex=N slicing (see spec §6.5).
+ *
+ * All four top-level fields are required; additional passthrough fields
+ * (batchId, contextBlockId, clarificationId, etc.) are preserved.
+ */
+export interface ExecutorOutput {
+    results: RunResult[];
+    headline: string;
+    batchTimings: BatchTimings;
+    costSummary: BatchAggregateCost;
+    batchId: string;
+    contextBlockId?: string;
+    clarificationId?: string;
+    wallClockMs?: number;
+    parentModel?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/executors/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/executors/types.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC3G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAI3E,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,cAAc,CAAC;IAC/B,MAAM,EAAE,gBAAgB,CAAC;IACzB;;;;;;;OAOG;IACH,MAAM,EAAE,gBAAgB,CAAC;IACzB,iBAAiB,EAAE,iBAAiB,CAAC;IACrC;;;;;;;OAOG;IACH,eAAe,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,QAAQ,CAAC;IAC/C,2EAA2E;IAC3E,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IAC5C,oGAAoG;IACpG,kBAAkB,EAAE,CAAC,QAAQ,EAAE,qBAAqB,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACxF,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,YAAY,CAAC;IAC3B,WAAW,EAAE,kBAAkB,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}

package/dist/executors/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/executors/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/executors/types.ts"],"names":[],"mappings":""}

package/dist/executors/verify.d.ts

@@ -0,0 +1,7 @@
+import type { ExecutionContext, ExecutorOutput } from './types.js';
+import type { Input } from '../tool-schemas/verify.js';
+export interface VerifyOutput extends ExecutorOutput {
+    contextBlockId?: string;
+}
+export declare function executeVerify(ctx: ExecutionContext, input: Input): Promise<VerifyOutput>;
+//# sourceMappingURL=verify.d.ts.map

package/dist/executors/verify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../src/executors/verify.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAyDvD,MAAM,WAAW,YAAa,SAAQ,cAAc;IAClD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAsB,aAAa,CACjC,GAAG,EAAE,gBAAgB,EACrB,KAAK,EAAE,KAAK,GACX,OAAO,CAAC,YAAY,CAAC,CAiEvB"}