@zhixuan92/multi-model-agent-core 2.8.0 → 3.0.1

package/dist/executors/audit.js

@@ -0,0 +1,140 @@
+// packages/core/src/executors/audit.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/audit-document.ts ---
+function resolveAuditTypeText(auditType) {
+    if (auditType === 'general')
+        return 'security, performance, correctness, and style';
+    if (Array.isArray(auditType))
+        return auditType.join(', ');
+    return auditType;
+}
+const AUDIT_DONE_CONDITIONS = {
+    security: 'Identify all security vulnerabilities (injection, auth bypass, data exposure, OWASP top 10). Each finding has severity (critical/high/medium/low), location, and remediation.',
+    performance: 'Identify all performance issues (O(n²) loops, unnecessary allocations, missing caching, blocking I/O). Each finding has impact level, location, and fix recommendation.',
+    correctness: 'Identify all logic errors, off-by-one bugs, unhandled edge cases, type mismatches, and contract violations. Each finding has severity, location, and correct behavior.',
+    style: 'Identify all style issues (naming, formatting, dead code, inconsistent patterns). Each finding has location and recommended fix.',
+    general: 'Identify issues across security, performance, correctness, and style. Each finding has category, severity, location, and remediation.',
+};
+const DELTA_AUDIT_SUFFIX = ' Perform a full audit (do not reduce thoroughness). Verify each prior finding as fixed or unfixed. Omit fixed prior findings from the main report. Include unfixed prior findings and new findings. End with a summary of which prior findings were resolved.';
+function resolveAuditDoneCondition(auditType, hasContextBlocks) {
+    let base;
+    if (auditType === 'general') {
+        base = AUDIT_DONE_CONDITIONS.general;
+    }
+    else if (Array.isArray(auditType)) {
+        base = auditType.map(t => AUDIT_DONE_CONDITIONS[t]).join(' ');
+    }
+    else {
+        base = AUDIT_DONE_CONDITIONS[auditType] ?? AUDIT_DONE_CONDITIONS.general;
+    }
+    return hasContextBlocks ? base + DELTA_AUDIT_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 buildAuditPrompt(auditTypeText, document, filePaths, hasContextBlocks) {
+    const parts = [`Audit for ${auditTypeText} issues.`];
+    if (document)
+        parts.push(`Document:\n\n${document}`);
+    const fileSection = buildFilePathsPrompt(filePaths);
+    if (fileSection)
+        parts.push(fileSection);
+    if (hasContextBlocks) {
+        parts.push('A prior audit report is provided as context above.', 'First, verify which prior findings have been fixed. Then perform a full audit as normal — do not skip areas or reduce thoroughness.', 'In your output:', '- **Omit** prior findings that have been fixed — do not re-report them.', '- **Include** prior findings that are still present (mark as "unfixed from prior audit").', '- **Include** any new findings not in the prior report.', '- End with a **Fixed** summary listing which prior findings were resolved.');
+    }
+    else {
+        parts.push('Provide a structured audit report with findings and severity.');
+    }
+    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 executeAudit(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: 'off',
+        briefQualityPolicy: 'off',
+        done: resolveAuditDoneCondition(input.auditType, 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.document, input.filePaths);
+    if (mode === 'fan_out') {
+        const validPaths = input.filePaths.filter(p => p.trim().length > 0);
+        const auditTypeText = resolveAuditTypeText(input.auditType);
+        const promptTemplate = buildAuditPrompt(auditTypeText, undefined, undefined, 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 }),
+        };
+    }
+    // Single-task mode
+    const auditTypeText = resolveAuditTypeText(input.auditType);
+    const prompt = buildAuditPrompt(auditTypeText, input.document, input.filePaths, 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=audit.js.map

package/dist/executors/audit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.js","sourceRoot":"","sources":["../../src/executors/audit.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,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,+DAA+D;AAE/D,SAAS,oBAAoB,CAAC,SAA6B;IACzD,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,+CAA+C,CAAC;IACpF,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;QAAE,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1D,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,qBAAqB,GAA2B;IACpD,QAAQ,EAAE,+KAA+K;IACzL,WAAW,EAAE,yKAAyK;IACtL,WAAW,EAAE,wKAAwK;IACrL,KAAK,EAAE,kIAAkI;IACzI,OAAO,EAAE,uIAAuI;CACjJ,CAAC;AAEF,MAAM,kBAAkB,GAAG,+PAA+P,CAAC;AAE3R,SAAS,yBAAyB,CAAC,SAA6B,EAAE,gBAAyB;IACzF,IAAI,IAAY,CAAC;IACjB,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,IAAI,GAAG,qBAAqB,CAAC,OAAO,CAAC;IACvC,CAAC;SAAM,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACpC,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChE,CAAC;SAAM,CAAC;QACN,IAAI,GAAG,qBAAqB,CAAC,SAAS,CAAC,IAAI,qBAAqB,CAAC,OAAO,CAAC;IAC3E,CAAC;IACD,OAAO,gBAAgB,CAAC,CAAC,CAAC,IAAI,GAAG,kBAAkB,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7D,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,gBAAgB,CACvB,aAAqB,EACrB,QAA4B,EAC5B,SAA+B,EAC/B,gBAAyB;IAEzB,MAAM,KAAK,GAAa,CAAC,aAAa,aAAa,UAAU,CAAC,CAAC;IAC/D,IAAI,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,gBAAgB,QAAQ,EAAE,CAAC,CAAC;IACrD,MAAM,WAAW,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC;IACpD,IAAI,WAAW;QAAE,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACzC,IAAI,gBAAgB,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CACR,oDAAoD,EACpD,qIAAqI,EACrI,iBAAiB,EACjB,yEAAyE,EACzE,2FAA2F,EAC3F,yDAAyD,EACzD,4EAA4E,CAC7E,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC;IAC9E,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,YAAY,CAChC,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;IAElG,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,KAAK;QACnB,kBAAkB,EAAE,KAAK;QACzB,IAAI,EAAE,yBAAyB,CAAC,KAAK,CAAC,SAAS,EAAE,gBAAgB,CAAC;QAClE,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,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IAElE,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,aAAa,GAAG,oBAAoB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC5D,MAAM,cAAc,GAAG,gBAAgB,CAAC,aAAa,EAAE,SAAS,EAAE,SAAS,EAAE,gBAAgB,CAAC,CAAC;QAC/F,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,mBAAmB;IACnB,MAAM,aAAa,GAAG,oBAAoB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC5D,MAAM,MAAM,GAAG,gBAAgB,CAAC,aAAa,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;IAClG,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/debug.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../../src/executors/debug.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAwBtD,MAAM,WAAW,WAAY,SAAQ,cAAc;IACjD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAsB,YAAY,CAChC,GAAG,EAAE,gBAAgB,EACrB,KAAK,EAAE,KAAK,GACX,OAAO,CAAC,WAAW,CAAC,CA6CtB"}

package/dist/executors/debug.js

@@ -0,0 +1,65 @@
+// packages/core/src/executors/debug.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/debug-task.ts ---
+function buildFilePathsPrompt(filePaths) {
+    if (!filePaths || filePaths.length === 0)
+        return '';
+    return `Read and analyze these files:\n${filePaths.map(p => `- ${p}`).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 executeDebug(ctx, input) {
+    const { config, contextBlockStore } = ctx;
+    const parts = [`Debug this problem:\n\n${input.problem}`];
+    if (input.context)
+        parts.push(`Context: ${input.context}`);
+    if (input.hypothesis)
+        parts.push(`Initial hypothesis: ${input.hypothesis}`);
+    const fileSection = buildFilePathsPrompt(input.filePaths);
+    if (fileSection)
+        parts.push(fileSection);
+    parts.push('Use hypothesis-driven debugging: identify root cause, propose fix, verify.');
+    const prompt = parts.join('\n\n');
+    const parentModel = ctx.parentModel ?? config.defaults?.parentModel ?? undefined;
+    const taskSpec = {
+        agentType: 'complex',
+        reviewPolicy: 'full',
+        briefQualityPolicy: 'off',
+        done: 'Identify the root cause with evidence (file, line, mechanism). Propose a fix. Verify the fix resolves the problem.',
+        maxReviewRounds: 1,
+        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 results = await runTasks([{ ...taskSpec, 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=debug.js.map

package/dist/executors/debug.js.map

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

package/dist/executors/delegate.d.ts

@@ -0,0 +1,28 @@
+import type { ExecutionContext, ExecutorOutput } from './types.js';
+import type { Input } from '../tool-schemas/delegate.js';
+import type { TaskSpec } from '../types.js';
+import { runTasks } from '../run-tasks.js';
+import type { RunTasksOptions } from '../run-tasks.js';
+import type { ClarificationEntry } from '../intake/types.js';
+export interface DelegateOptions {
+    /**
+     * Injects harness-level defaults (tools, timeoutMs, cwd, etc.) into each TaskSpec.
+     * Provided by the MCP layer; a future REST layer will supply its own implementation.
+     */
+    injectDefaults: (tasks: TaskSpec[]) => TaskSpec[];
+    /**
+     * Optional override for `runTasks` — used in tests to inject a mock implementation.
+     */
+    runTasksOverride?: typeof runTasks;
+    /**
+     * Optional progress callback passed through to runTasks.
+     */
+    onProgress?: RunTasksOptions['onProgress'];
+}
+export interface DelegateOutput extends ExecutorOutput {
+    clarifications?: ClarificationEntry[];
+    tasks: TaskSpec[];
+    wallClockMs: number;
+}
+export declare function executeDelegate(ctx: ExecutionContext, input: Input, options: DelegateOptions): Promise<DelegateOutput>;
+//# sourceMappingURL=delegate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delegate.d.ts","sourceRoot":"","sources":["../../src/executors/delegate.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAa,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAIvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,cAAc,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,QAAQ,EAAE,CAAC;IAClD;;OAEG;IACH,gBAAgB,CAAC,EAAE,OAAO,QAAQ,CAAC;IACnC;;OAEG;IACH,UAAU,CAAC,EAAE,eAAe,CAAC,YAAY,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,cAAe,SAAQ,cAAc;IACpD,cAAc,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACtC,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,eAAe,CACnC,GAAG,EAAE,gBAAgB,EACrB,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,cAAc,CAAC,CAoEzB"}

package/dist/executors/delegate.js

@@ -0,0 +1,76 @@
+// packages/core/src/executors/delegate.ts
+import { randomUUID } from 'node:crypto';
+import { runTasks } from '../run-tasks.js';
+import { compileDelegateTasks } from '../intake/compilers/delegate.js';
+import { runIntakePipeline } from '../intake/pipeline.js';
+import { computeTimings, computeAggregateCost } from './shared-compute.js';
+export async function executeDelegate(ctx, input, options) {
+    const { config, projectContext, contextBlockStore } = ctx;
+    const { injectDefaults, onProgress } = options;
+    const runTasksImpl = options.runTasksOverride ?? runTasks;
+    const { batchCache, clarifications: clarificationStore } = projectContext;
+    // Intake pipeline: compile → infer → classify → resolve
+    const requestId = randomUUID();
+    const drafts = compileDelegateTasks(input.tasks, requestId);
+    const intakeResult = runIntakePipeline(drafts, config, contextBlockStore);
+    let results = [];
+    const readySpecs = intakeResult.ready.map(r => r.task);
+    const batchId = batchCache.remember(readySpecs.length > 0 ? readySpecs : input.tasks);
+    const batchStartMs = Date.now();
+    let batchAborted = false;
+    try {
+        if (readySpecs.length > 0) {
+            const resolvedTasks = injectDefaults(readySpecs);
+            results = await runTasksImpl(resolvedTasks, config, {
+                onProgress,
+                runtime: { contextBlockStore },
+            });
+            intakeResult.intakeProgress.executedDrafts = results.length;
+        }
+    }
+    catch (err) {
+        batchAborted = true;
+        throw err;
+    }
+    finally {
+        if (batchAborted) {
+            try {
+                batchCache.abort(batchId);
+            }
+            catch { /* already terminal */ }
+        }
+        else {
+            try {
+                batchCache.complete(batchId, results);
+            }
+            catch { /* already terminal */ }
+        }
+    }
+    const wallClockMs = Date.now() - batchStartMs;
+    // Create clarification set if needed
+    let clarificationId;
+    if (intakeResult.clarifications.length > 0) {
+        const storedDrafts = intakeResult.clarifications.map(c => ({
+            draft: drafts.find(d => d.draftId === c.draftId),
+            taskIndex: c.taskIndex,
+            roundCount: 0,
+        }));
+        clarificationId = clarificationStore.create(storedDrafts, batchId);
+    }
+    const batchTimings = computeTimings(wallClockMs, results);
+    const costSummary = computeAggregateCost(results);
+    const parentModel = ctx.parentModel ?? config.defaults?.parentModel ?? undefined;
+    return {
+        results,
+        headline: '', // composed by the caller using composeHeadline
+        batchTimings,
+        costSummary,
+        batchId,
+        tasks: readySpecs,
+        wallClockMs,
+        parentModel,
+        ...(clarificationId !== undefined && { clarificationId }),
+        ...(intakeResult.clarifications.length > 0 && { clarifications: intakeResult.clarifications }),
+    };
+}
+//# sourceMappingURL=delegate.js.map

package/dist/executors/delegate.js.map

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

package/dist/executors/execute-plan.d.ts

@@ -0,0 +1,11 @@
+import type { ExecutionContext, ExecutorOutput } from './types.js';
+import type { Input } from '../tool-schemas/execute-plan.js';
+export interface ExecutePlanValidationError {
+    error: string;
+    isError: true;
+}
+export interface ExecutePlanOutput extends ExecutorOutput {
+    contextBlockId?: string;
+}
+export declare function executeExecutePlan(ctx: ExecutionContext, input: Input): Promise<ExecutePlanOutput | ExecutePlanValidationError>;
+//# sourceMappingURL=execute-plan.d.ts.map

package/dist/executors/execute-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-plan.d.ts","sourceRoot":"","sources":["../../src/executors/execute-plan.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iCAAiC,CAAC;AA4C7D,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,IAAI,CAAC;CACf;AAED,MAAM,WAAW,iBAAkB,SAAQ,cAAc;IACvD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,gBAAgB,EACrB,KAAK,EAAE,KAAK,GACX,OAAO,CAAC,iBAAiB,GAAG,0BAA0B,CAAC,CAwGzD"}

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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"}