@zhixuan92/multi-model-agent-core 3.12.7 → 4.0.0

package/dist/tools/delegate/schema.d.ts

@@ -0,0 +1,70 @@
+import { z } from 'zod';
+export declare const inputSchema: z.ZodObject<{
+    tasks: z.ZodArray<z.ZodObject<{
+        prompt: z.ZodString;
+        agentType: z.ZodOptional<z.ZodEnum<{
+            standard: "standard";
+            complex: "complex";
+        }>>;
+        filePaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        done: z.ZodOptional<z.ZodString>;
+        contextBlockIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        maxCostUSD: z.ZodOptional<z.ZodNumber>;
+        verifyCommand: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        reviewPolicy: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+            full: "full";
+            quality_only: "quality_only";
+            diff_only: "diff_only";
+            none: "none";
+        }>>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type Input = z.infer<typeof inputSchema>;
+export declare const outputSchema: z.ZodObject<{
+    headline: z.ZodString;
+    results: z.ZodUnion<readonly [z.ZodArray<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>, z.ZodObject<{
+        kind: z.ZodLiteral<"not_applicable">;
+        reason: z.ZodString;
+    }, z.core.$strip>]>;
+    batchTimings: z.ZodUnion<readonly [z.ZodObject<{}, z.core.$loose>, z.ZodObject<{
+        kind: z.ZodLiteral<"not_applicable">;
+        reason: z.ZodString;
+    }, z.core.$strip>]>;
+    costSummary: z.ZodUnion<readonly [z.ZodObject<{}, z.core.$loose>, z.ZodObject<{
+        kind: z.ZodLiteral<"not_applicable">;
+        reason: z.ZodString;
+    }, z.core.$strip>]>;
+    structuredReport: z.ZodUnion<readonly [z.ZodObject<{}, z.core.$loose>, z.ZodObject<{
+        kind: z.ZodLiteral<"not_applicable">;
+        reason: z.ZodString;
+    }, z.core.$strip>]>;
+    error: z.ZodUnion<readonly [z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        details: z.ZodOptional<z.ZodUnknown>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"not_applicable">;
+        reason: z.ZodString;
+    }, z.core.$strip>]>;
+    specReviewVerdict: z.ZodOptional<z.ZodEnum<{
+        approved: "approved";
+        concerns: "concerns";
+        changes_required: "changes_required";
+        annotated: "annotated";
+        error: "error";
+        skipped: "skipped";
+        not_applicable: "not_applicable";
+    }>>;
+    qualityReviewVerdict: z.ZodOptional<z.ZodEnum<{
+        approved: "approved";
+        concerns: "concerns";
+        changes_required: "changes_required";
+        annotated: "annotated";
+        error: "error";
+        skipped: "skipped";
+        not_applicable: "not_applicable";
+    }>>;
+    roundsUsed: z.ZodOptional<z.ZodNumber>;
+}, z.core.$loose>;
+export type Output = z.infer<typeof outputSchema>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/tools/delegate/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/tools/delegate/schema.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA8BxB,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;kBAEb,CAAC;AAEZ,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEhD,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAA8B,CAAC;AAExD,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC"}

package/dist/tools/delegate/schema.js

@@ -0,0 +1,18 @@
+// packages/core/src/tool-schemas/delegate.ts
+import { z } from 'zod';
+import { buildOutputEnvelopeSchema } from '../shared-output.js';
+const taskSchema = z.object({
+    prompt: z.string().describe('The task instruction. Required.'),
+    agentType: z.enum(['standard', 'complex']).optional().describe('How hard the task is. Default: standard (cost-effective). Set to complex for harder reasoning or ambiguous scope.'),
+    filePaths: z.array(z.string()).optional().describe('Files the sub-agent should focus on. Existing files are pre-verified. Non-existent paths are treated as output targets.'),
+    done: z.string().optional().describe('Acceptance criteria in plain language. The worker works toward this goal. The reviewer verifies it.'),
+    contextBlockIds: z.array(z.string()).optional().describe('IDs from register_context_block to prepend to prompt.'),
+    maxCostUSD: z.number().positive().finite().optional().describe('Maximum estimated cost in USD for this task. Optional; the executor applies a default of 10 when omitted. When explicitly passed it must be a positive finite number; <=0, NaN, or Infinity are rejected with HTTP 400.'),
+    verifyCommand: z.array(z.string().refine((s) => s.trim().length > 0, 'non-empty after trim')).min(1).optional().describe('Commands to run after task completion to verify the work.'),
+    reviewPolicy: z.enum(['full', 'quality_only', 'diff_only', 'none']).optional().default('full').describe('Review lifecycle policy for this task. Default: full.'),
+}).strict();
+export const inputSchema = z.object({
+    tasks: z.array(taskSchema).describe('Array of tasks to execute in parallel'),
+}).strict();
+export const outputSchema = buildOutputEnvelopeSchema();
+//# sourceMappingURL=schema.js.map

package/dist/tools/delegate/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/tools/delegate/schema.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAEhE,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CACzB,iCAAiC,CAClC;IACD,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAC5D,mHAAmH,CACpH;IACD,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAChD,yHAAyH,CAC1H;IACD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAClC,qGAAqG,CACtG;IACD,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CACtD,uDAAuD,CACxD;IACD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAC5D,yNAAyN,CAC1N;IACD,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,sBAAsB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CACtH,2DAA2D,CAC5D;IACD,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,QAAQ,CACrG,uDAAuD,CACxD;CACF,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,uCAAuC,CAAC;CAC7E,CAAC,CAAC,MAAM,EAAE,CAAC;AAIZ,MAAM,CAAC,MAAM,YAAY,GAAG,yBAAyB,EAAE,CAAC"}

package/dist/tools/delegate/tool-config.d.ts

@@ -0,0 +1,17 @@
+import { ToolSurfaceRegistry } from '../../tool-surface/tool-surface-registry.js';
+import type { Input } from './schema.js';
+import type { ToolConfig } from '../../lifecycle/tool-config-types.js';
+import type { ReviewPolicy } from '../../intake/brief-compiler-slots/delegate.js';
+export declare function registerDelegate(registry: ToolSurfaceRegistry): void;
+export interface DelegateBrief {
+    prompt: string;
+    done?: string;
+    filePaths?: string[];
+    agentType: 'standard' | 'complex';
+    reviewPolicy: ReviewPolicy;
+    contextBlockIds?: string[];
+    verifyCommand?: string[];
+    maxCostUSD?: number;
+}
+export declare const toolConfig: ToolConfig<Input, DelegateBrief, unknown>;
+//# sourceMappingURL=tool-config.d.ts.map

package/dist/tools/delegate/tool-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-config.d.ts","sourceRoot":"","sources":["../../../src/tools/delegate/tool-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,6CAA6C,CAAC;AAElF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sCAAsC,CAAC;AAIvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+CAA+C,CAAC;AAIlF,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI,CAYpE;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,UAAU,GAAG,SAAS,CAAC;IAClC,YAAY,EAAE,YAAY,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,UAAU,EAAE,UAAU,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,CAoChE,CAAC"}

package/dist/tools/delegate/tool-config.js

@@ -0,0 +1,56 @@
+import { inputSchema } from './schema.js';
+import { delegateHeadlineTemplate } from '../../reporting/headline-templates/delegate.js';
+import { delegateReportSchema } from '../../reporting/report-parser-slots/delegate-report.js';
+import { compileDelegatePrompt } from '../../intake/brief-compiler-slots/delegate.js';
+import { specTemplate, qualityAPTemplate, diffTemplate } from '../../review/reviewer-engine.js';
+import { DEFAULT_TASK_TIMEOUT_MS } from '../../config/schema.js';
+export function registerDelegate(registry) {
+    registry.register({
+        routeName: 'delegate',
+        httpMethod: 'POST',
+        httpPath: '/delegate',
+        surface: 'tool',
+        schema: inputSchema,
+        toolCategory: 'artifact_producing',
+        agentTypeDefault: 'standard',
+        agentTypeOverridable: true,
+        responseShapeName: 'BatchResponse',
+    });
+}
+export const toolConfig = {
+    name: 'delegate',
+    category: 'artifact_producing',
+    agentType: 'standard',
+    briefSlot: (input) => input.tasks.map((t) => ({
+        prompt: compileDelegatePrompt({ prompt: t.prompt }),
+        done: t.done,
+        filePaths: t.filePaths,
+        agentType: t.agentType ?? 'standard',
+        reviewPolicy: t.reviewPolicy ?? 'full',
+        contextBlockIds: t.contextBlockIds,
+        verifyCommand: t.verifyCommand,
+        maxCostUSD: t.maxCostUSD,
+    })),
+    buildTaskSpec: (brief, ctx) => ({
+        prompt: brief.prompt,
+        agentType: brief.agentType,
+        reviewPolicy: brief.reviewPolicy,
+        done: brief.done,
+        filePaths: brief.filePaths,
+        contextBlockIds: brief.contextBlockIds,
+        verifyCommand: brief.verifyCommand,
+        maxCostUSD: brief.maxCostUSD,
+        cwd: ctx.projectContext?.cwd ?? ctx.cwd,
+        tools: ctx.config.defaults?.tools ?? 'full',
+        timeoutMs: ctx.config.defaults?.timeoutMs ?? DEFAULT_TASK_TIMEOUT_MS,
+        sandboxPolicy: ctx.config.defaults?.sandboxPolicy ?? 'cwd-only',
+    }),
+    reportSchema: delegateReportSchema,
+    headlineTemplate: delegateHeadlineTemplate,
+    reviewTemplates: {
+        spec: specTemplate,
+        qualityAP: qualityAPTemplate,
+        diff: diffTemplate,
+    },
+};
+//# sourceMappingURL=tool-config.js.map

package/dist/tools/delegate/tool-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-config.js","sourceRoot":"","sources":["../../../src/tools/delegate/tool-config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1C,OAAO,EAAE,wBAAwB,EAAE,MAAM,gDAAgD,CAAC;AAC1F,OAAO,EAAE,oBAAoB,EAAE,MAAM,wDAAwD,CAAC;AAC9F,OAAO,EAAE,qBAAqB,EAAE,MAAM,+CAA+C,CAAC;AAEtF,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAChG,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,MAAM,UAAU,gBAAgB,CAAC,QAA6B;IAC5D,QAAQ,CAAC,QAAQ,CAAC;QAChB,SAAS,EAAE,UAAU;QACrB,UAAU,EAAE,MAAM;QAClB,QAAQ,EAAE,WAAW;QACrB,OAAO,EAAE,MAAM;QACf,MAAM,EAAE,WAAW;QACnB,YAAY,EAAE,oBAAoB;QAClC,gBAAgB,EAAE,UAAU;QAC5B,oBAAoB,EAAE,IAAI;QAC1B,iBAAiB,EAAE,eAAe;KACnC,CAAC,CAAC;AACL,CAAC;AAaD,MAAM,CAAC,MAAM,UAAU,GAA8C;IACnE,IAAI,EAAE,UAAU;IAChB,QAAQ,EAAE,oBAAoB;IAC9B,SAAS,EAAE,UAAU;IACrB,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE,CACnB,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACtB,MAAM,EAAE,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;QACnD,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,SAAS,EAAE,CAAC,CAAC,SAAS,IAAI,UAAU;QACpC,YAAY,EAAE,CAAC,CAAC,YAAY,IAAI,MAAM;QACtC,eAAe,EAAE,CAAC,CAAC,eAAe;QAClC,aAAa,EAAE,CAAC,CAAC,aAAa;QAC9B,UAAU,EAAE,CAAC,CAAC,UAAU;KACzB,CAAC,CAAC;IACL,aAAa,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;QAC9B,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,GAAG,EAAE,GAAG,CAAC,cAAc,EAAE,GAAG,IAAI,GAAG,CAAC,GAAG;QACvC,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,IAAI,MAAM;QAC3C,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,SAAS,IAAI,uBAAuB;QACpE,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,aAAa,IAAI,UAAU;KAChE,CAAC;IACF,YAAY,EAAE,oBAAoB;IAClC,gBAAgB,EAAE,wBAAwB;IAC1C,eAAe,EAAE;QACf,IAAI,EAAE,YAAY;QAClB,SAAS,EAAE,iBAAiB;QAC5B,IAAI,EAAE,YAAY;KACnB;CACF,CAAC"}

package/dist/tools/execute-plan/schema.d.ts

@@ -0,0 +1,66 @@
+import { z } from 'zod';
+export declare const inputSchema: z.ZodObject<{
+    tasks: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        task: z.ZodString;
+        reviewPolicy: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+            full: "full";
+            quality_only: "quality_only";
+            diff_only: "diff_only";
+            none: "none";
+        }>>>;
+    }, z.core.$strict>]>>;
+    context: z.ZodOptional<z.ZodString>;
+    filePaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    contextBlockIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    maxCostUSD: z.ZodOptional<z.ZodNumber>;
+    verifyCommand: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+export type Input = z.infer<typeof inputSchema>;
+export declare const outputSchema: z.ZodObject<{
+    headline: z.ZodString;
+    results: z.ZodUnion<readonly [z.ZodArray<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>, z.ZodObject<{
+        kind: z.ZodLiteral<"not_applicable">;
+        reason: z.ZodString;
+    }, z.core.$strip>]>;
+    batchTimings: z.ZodUnion<readonly [z.ZodObject<{}, z.core.$loose>, z.ZodObject<{
+        kind: z.ZodLiteral<"not_applicable">;
+        reason: z.ZodString;
+    }, z.core.$strip>]>;
+    costSummary: z.ZodUnion<readonly [z.ZodObject<{}, z.core.$loose>, z.ZodObject<{
+        kind: z.ZodLiteral<"not_applicable">;
+        reason: z.ZodString;
+    }, z.core.$strip>]>;
+    structuredReport: z.ZodUnion<readonly [z.ZodObject<{}, z.core.$loose>, z.ZodObject<{
+        kind: z.ZodLiteral<"not_applicable">;
+        reason: z.ZodString;
+    }, z.core.$strip>]>;
+    error: z.ZodUnion<readonly [z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        details: z.ZodOptional<z.ZodUnknown>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"not_applicable">;
+        reason: z.ZodString;
+    }, z.core.$strip>]>;
+    specReviewVerdict: z.ZodOptional<z.ZodEnum<{
+        approved: "approved";
+        concerns: "concerns";
+        changes_required: "changes_required";
+        annotated: "annotated";
+        error: "error";
+        skipped: "skipped";
+        not_applicable: "not_applicable";
+    }>>;
+    qualityReviewVerdict: z.ZodOptional<z.ZodEnum<{
+        approved: "approved";
+        concerns: "concerns";
+        changes_required: "changes_required";
+        annotated: "annotated";
+        error: "error";
+        skipped: "skipped";
+        not_applicable: "not_applicable";
+    }>>;
+    roundsUsed: z.ZodOptional<z.ZodNumber>;
+}, z.core.$loose>;
+export type Output = z.infer<typeof outputSchema>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/tools/execute-plan/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/tools/execute-plan/schema.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAoBxB,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;kBAmBb,CAAC;AAEZ,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEhD,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAA8B,CAAC;AAExD,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC"}

package/dist/tools/execute-plan/schema.js

@@ -0,0 +1,34 @@
+// packages/core/src/tool-schemas/execute-plan.ts
+import { z } from 'zod';
+import { buildOutputEnvelopeSchema } from '../shared-output.js';
+// Ported verbatim from packages/mcp/src/tools/execute-plan.ts (executePlanSchema).
+// commonToolFields (filePaths + contextBlockIds) are inlined to avoid cross-package coupling.
+const taskSchema = z.object({
+    task: z.string().trim().min(1, 'Task descriptor must be non-empty'),
+    reviewPolicy: z.enum(['full', 'quality_only', 'diff_only', 'none']).optional().default('full')
+        .describe('Review lifecycle policy for this task. Default: full.'),
+}).strict();
+const taskInputSchema = z.union([
+    z.string().trim().min(1, 'Task descriptor must be non-empty'),
+    taskSchema,
+]);
+function taskDescriptor(task) {
+    return typeof task === 'string' ? task : task.task;
+}
+export const inputSchema = z.object({
+    tasks: z.array(taskInputSchema).min(1, 'At least one task required')
+        .refine((tasks) => new Set(tasks.map(taskDescriptor)).size === tasks.length, { message: 'Duplicate task descriptors are not allowed' })
+        .describe('Descriptive task strings or task objects matching plan headings, e.g. "1. Setup database schema". Multiple = parallel.'),
+    context: z.string().optional()
+        .describe('Short additional context the plan does not contain, e.g. "Tasks 1-16 are done, files already exist". Injected into the worker prompt.'),
+    filePaths: z.array(z.string()).optional()
+        .describe('Files the sub-agent should focus on. Multiple files are processed in parallel.'),
+    contextBlockIds: z.array(z.string()).optional()
+        .describe('IDs from register_context_block to prepend to prompt. Use for delta audits, diff-scoped reviews, or shared specs.'),
+    maxCostUSD: z.number().positive().finite().optional()
+        .describe('Maximum estimated cost in USD for each generated plan task. Optional; the executor applies a default of 10 when omitted. Validation when explicitly passed: positive finite.'),
+    verifyCommand: z.array(z.string().refine((s) => s.trim().length > 0, 'non-empty after trim')).min(1).optional()
+        .describe('Commands to run after plan task completion to verify the work.'),
+}).strict();
+export const outputSchema = buildOutputEnvelopeSchema();
+//# sourceMappingURL=schema.js.map

package/dist/tools/execute-plan/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/tools/execute-plan/schema.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAEhE,mFAAmF;AACnF,8FAA8F;AAC9F,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,mCAAmC,CAAC;IACnE,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;SAC3F,QAAQ,CAAC,uDAAuD,CAAC;CACrE,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC;IAC9B,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,mCAAmC,CAAC;IAC7D,UAAU;CACX,CAAC,CAAC;AAEH,SAAS,cAAc,CAAC,IAAqC;IAC3D,OAAO,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;AACrD,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,KAAK,EAAE,CAAC,CAAC,KAAK,CACZ,eAAe,CAChB,CAAC,GAAG,CAAC,CAAC,EAAE,4BAA4B,CAAC;SACnC,MAAM,CACL,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,MAAM,EACnE,EAAE,OAAO,EAAE,4CAA4C,EAAE,CAC1D;SACA,QAAQ,CAAC,wHAAwH,CAAC;IACrI,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC3B,QAAQ,CAAC,uIAAuI,CAAC;IACpJ,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;SACtC,QAAQ,CAAC,gFAAgF,CAAC;IAC7F,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;SAC5C,QAAQ,CAAC,mHAAmH,CAAC;IAChI,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAClD,QAAQ,CAAC,8KAA8K,CAAC;IAC3L,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,sBAAsB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;SAC5G,QAAQ,CAAC,gEAAgE,CAAC;CAC9E,CAAC,CAAC,MAAM,EAAE,CAAC;AAIZ,MAAM,CAAC,MAAM,YAAY,GAAG,yBAAyB,EAAE,CAAC"}

package/dist/tools/execute-plan/tool-config.d.ts

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+import { ToolSurfaceRegistry } from '../../tool-surface/tool-surface-registry.js';
+import type { ToolConfig } from '../../lifecycle/tool-config-types.js';
+import { type ToolExecutePlanBrief } from '../../intake/brief-compiler-slots/execute-plan.js';
+export declare const executePlanInputSchema: z.ZodObject<{
+    filePaths: z.ZodArray<z.ZodString>;
+    taskDescriptors: z.ZodArray<z.ZodString>;
+    cwd: z.ZodOptional<z.ZodString>;
+    perTaskReviewPolicy: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
+        full: "full";
+        quality_only: "quality_only";
+        diff_only: "diff_only";
+        none: "none";
+    }>>>;
+    contextBlockIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    verifyCommand: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+export type ExecutePlanWireInput = z.infer<typeof executePlanInputSchema>;
+export declare function registerExecutePlan(registry: ToolSurfaceRegistry): void;
+export declare const toolConfig: ToolConfig<ExecutePlanWireInput, ToolExecutePlanBrief>;
+//# sourceMappingURL=tool-config.d.ts.map

package/dist/tools/execute-plan/tool-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-config.d.ts","sourceRoot":"","sources":["../../../src/tools/execute-plan/tool-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,6CAA6C,CAAC;AAMlF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sCAAsC,CAAC;AACvE,OAAO,EAA4B,KAAK,oBAAoB,EAAE,MAAM,mDAAmD,CAAC;AAKxH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;kBAOxB,CAAC;AAEZ,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE1E,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI,CAYvE;AAsCD,eAAO,MAAM,UAAU,EAAE,UAAU,CAAC,oBAAoB,EAAE,oBAAoB,CA4B7E,CAAC"}

package/dist/tools/execute-plan/tool-config.js

@@ -0,0 +1,76 @@
+import { z } from 'zod';
+import { specTemplate, qualityAPTemplate, diffTemplate, } from '../../review/reviewer-engine.js';
+import { toolExecutePlanBriefSlot } from '../../intake/brief-compiler-slots/execute-plan.js';
+import { executePlanHeadlineTemplate } from '../../reporting/headline-templates/execute-plan.js';
+import { executePlanReportSchema } from '../../reporting/report-parser-slots/execute-plan-report.js';
+import { DEFAULT_TASK_TIMEOUT_MS } from '../../config/schema.js';
+export const executePlanInputSchema = z.object({
+    filePaths: z.array(z.string()).length(1, { message: "execute_plan requires exactly one plan filePath" }),
+    taskDescriptors: z.array(z.string()).min(1),
+    cwd: z.string().optional(),
+    perTaskReviewPolicy: z.record(z.string(), z.enum(['full', 'quality_only', 'diff_only', 'none'])).optional(),
+    contextBlockIds: z.array(z.string()).optional(),
+    verifyCommand: z.array(z.string()).optional(),
+}).strict();
+export function registerExecutePlan(registry) {
+    registry.register({
+        routeName: 'execute_plan',
+        httpMethod: 'POST',
+        httpPath: '/execute-plan',
+        surface: 'tool',
+        schema: executePlanInputSchema,
+        toolCategory: 'artifact_producing',
+        agentTypeDefault: 'standard',
+        agentTypeOverridable: false,
+        responseShapeName: 'BatchResponse',
+    });
+}
+/**
+ * Build a compact worker prompt for one plan task. Extracted from the legacy
+ * executor — just the section matched by the slot, not the full plan file.
+ */
+function buildExecutePlanPrompt(filePaths, task, taskSection) {
+    const parts = [
+        `Execute this task from the plan: "${task}"`,
+        '',
+    ];
+    if (taskSection) {
+        parts.push('Relevant plan section:', '', '---', taskSection.trim(), '---', '');
+    }
+    else {
+        parts.push('No unique plan section matched that task heading. The full plan file is at:', ...filePaths.map((p) => `  - ${p}`), 'Read the plan file(s) yourself to find the task.', '');
+    }
+    parts.push('Plan files for reference (read on demand if you need adjacent context):', ...filePaths.map((p) => `  - ${p}`), '');
+    parts.push('Implement the task fully. Follow any acceptance criteria, file paths, and', 'constraints in the plan section above. If you cannot find or understand', 'the task, report that explicitly and do not implement anything.');
+    return parts.join('\n');
+}
+export const toolConfig = {
+    name: 'execute_plan',
+    category: 'artifact_producing',
+    agentType: 'standard',
+    briefSlot: toolExecutePlanBriefSlot,
+    buildTaskSpec: (brief, ctx) => ({
+        prompt: buildExecutePlanPrompt(brief.filePaths, brief.taskDescriptor, brief.sectionBody),
+        agentType: 'standard',
+        reviewPolicy: brief.reviewPolicy,
+        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: ctx.config.defaults?.tools ?? 'full',
+        timeoutMs: ctx.config.defaults?.timeoutMs ?? DEFAULT_TASK_TIMEOUT_MS,
+        maxCostUSD: ctx.config.defaults?.maxCostUSD ?? 10,
+        sandboxPolicy: ctx.config.defaults?.sandboxPolicy ?? 'cwd-only',
+        cwd: brief.cwd,
+        filePaths: brief.filePaths,
+        contextBlockIds: brief.contextBlockIds,
+        autoCommit: true,
+        verifyCommand: brief.verifyCommand,
+        ...(brief.sectionBody ? { planContext: brief.sectionBody } : {}),
+    }),
+    reportSchema: executePlanReportSchema,
+    headlineTemplate: executePlanHeadlineTemplate,
+    reviewTemplates: {
+        spec: specTemplate,
+        qualityAP: qualityAPTemplate,
+        diff: diffTemplate,
+    },
+};
+//# sourceMappingURL=tool-config.js.map

package/dist/tools/execute-plan/tool-config.js.map

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

package/dist/tools/explore/schema.d.ts

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+export declare const inputSchema: z.ZodPipe<z.ZodPipe<z.ZodUnknown, z.ZodTransform<Record<string, unknown>, unknown>>, z.ZodObject<{
+    currentContext: z.ZodString;
+    explorationQuestion: z.ZodString;
+    anchors: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    contextBlockIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>>;
+export type Input = z.infer<typeof inputSchema>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/tools/explore/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/tools/explore/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA4BxB,eAAO,MAAM,WAAW;;;;;kBAyCC,CAAC;AAE1B,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC"}

package/dist/tools/explore/schema.js

@@ -0,0 +1,64 @@
+import { z } from 'zod';
+const Trimmed = (min, max) => z.string().trim().min(min, `min length ${min}`).max(max, `max length ${max}`);
+const ALLOWED_KEYS = new Set([
+    'currentContext', 'explorationQuestion', 'anchors', 'contextBlockIds',
+]);
+const BLOCKED_KEYS_TO_CODE = {
+    agentType: 'tier_not_overridable',
+    tools: 'tool_surface_not_overridable',
+};
+const ExploreInputBase = z.object({
+    currentContext: Trimmed(20, 8000),
+    explorationQuestion: Trimmed(20, 8000),
+    anchors: z.array(z.string().min(1).max(512)).max(32).default([]),
+    contextBlockIds: z.array(z.string().min(1)).max(16).default([]),
+});
+// Single-pass scan that emits ALL key-shape errors deterministically and
+// returns `z.NEVER` if any blocked or unknown key was found, preventing the
+// typed pipe stage from running on malformed input. This avoids the
+// double-error problem where both .superRefine() AND .strict() flag the same
+// blocked field.
+//
+// Export name: `inputSchema` (lowercase) — matches `tool-schemas/investigate.ts`
+// convention (verified Plan R6).
+export const inputSchema = z
+    .unknown()
+    .transform((raw, ctx) => {
+    if (typeof raw !== 'object' || raw === null || Array.isArray(raw)) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: 'invalid_request: body must be an object',
+        });
+        return z.NEVER;
+    }
+    const obj = raw;
+    let bad = false;
+    // Phase 1: blocked keys, in deterministic order (agentType before tools).
+    for (const key of ['agentType', 'tools']) {
+        if (key in obj) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: BLOCKED_KEYS_TO_CODE[key],
+                path: [key],
+            });
+            bad = true;
+        }
+    }
+    // Phase 2: any other unknown key, in lexicographic order.
+    const unknown = Object.keys(obj)
+        .filter((k) => !ALLOWED_KEYS.has(k) && !(k in BLOCKED_KEYS_TO_CODE))
+        .sort();
+    for (const key of unknown) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: 'unknown_field',
+            path: [key],
+        });
+        bad = true;
+    }
+    if (bad)
+        return z.NEVER;
+    return obj;
+})
+    .pipe(ExploreInputBase); // typed validation only runs on key-clean objects
+//# sourceMappingURL=schema.js.map

package/dist/tools/explore/schema.js.map

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

package/dist/tools/explore/tool-config.d.ts

@@ -0,0 +1,7 @@
+import { ToolSurfaceRegistry } from '../../tool-surface/tool-surface-registry.js';
+import type { Input } from './schema.js';
+import type { ToolConfig } from '../../lifecycle/tool-config-types.js';
+import { type ExploreReport } from '../../reporting/report-parser-slots/explore-report.js';
+export declare function registerExplore(registry: ToolSurfaceRegistry): void;
+export declare const toolConfig: ToolConfig<Input, Input, ExploreReport>;
+//# sourceMappingURL=tool-config.d.ts.map

package/dist/tools/explore/tool-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-config.d.ts","sourceRoot":"","sources":["../../../src/tools/explore/tool-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,6CAA6C,CAAC;AAElF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sCAAsC,CAAC;AACvE,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,uDAAuD,CAAC;AAGhH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI,CAYnE;AAED,eAAO,MAAM,UAAU,EAAE,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,aAAa,CAkB9D,CAAC"}

package/dist/tools/explore/tool-config.js

@@ -0,0 +1,36 @@
+import { inputSchema } from './schema.js';
+import { exploreReportSchema } from '../../reporting/report-parser-slots/explore-report.js';
+import { exploreHeadlineTemplate } from '../../reporting/headline-templates/explore.js';
+export function registerExplore(registry) {
+    registry.register({
+        routeName: 'explore',
+        httpMethod: 'POST',
+        httpPath: '/explore',
+        surface: 'tool',
+        schema: inputSchema,
+        toolCategory: 'research',
+        agentTypeDefault: 'complex',
+        agentTypeOverridable: false,
+        responseShapeName: 'BatchResponse',
+    });
+}
+export const toolConfig = {
+    name: 'explore',
+    category: 'research',
+    agentType: 'complex',
+    briefSlot: (input) => [input],
+    buildTaskSpec: (brief, ctx) => ({
+        prompt: `Explore: ${brief.explorationQuestion ?? ''}\n\nContext: ${brief.currentContext ?? ''}`,
+        agentType: 'complex',
+        reviewPolicy: 'none',
+        cwd: ctx.projectContext?.cwd ?? ctx.cwd,
+        contextBlockIds: brief.contextBlockIds,
+        tools: ctx.config.defaults?.tools ?? 'full',
+        timeoutMs: ctx.config.defaults?.timeoutMs,
+        maxCostUSD: ctx.config.defaults?.maxCostUSD,
+        sandboxPolicy: ctx.config.defaults?.sandboxPolicy ?? 'cwd-only',
+    }),
+    reportSchema: exploreReportSchema,
+    headlineTemplate: exploreHeadlineTemplate,
+};
+//# sourceMappingURL=tool-config.js.map

package/dist/tools/explore/tool-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-config.js","sourceRoot":"","sources":["../../../src/tools/explore/tool-config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1C,OAAO,EAAE,mBAAmB,EAAsB,MAAM,uDAAuD,CAAC;AAChH,OAAO,EAAE,uBAAuB,EAAE,MAAM,+CAA+C,CAAC;AAExF,MAAM,UAAU,eAAe,CAAC,QAA6B;IAC3D,QAAQ,CAAC,QAAQ,CAAC;QAChB,SAAS,EAAE,SAAS;QACpB,UAAU,EAAE,MAAM;QAClB,QAAQ,EAAE,UAAU;QACpB,OAAO,EAAE,MAAM;QACf,MAAM,EAAE,WAAW;QACnB,YAAY,EAAE,UAAU;QACxB,gBAAgB,EAAE,SAAS;QAC3B,oBAAoB,EAAE,KAAK;QAC3B,iBAAiB,EAAE,eAAe;KACnC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,MAAM,UAAU,GAA4C;IACjE,IAAI,EAAE,SAAS;IACf,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,SAAS;IACpB,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC;IAC7B,aAAa,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;QAC9B,MAAM,EAAE,YAAY,KAAK,CAAC,mBAAmB,IAAI,EAAE,gBAAgB,KAAK,CAAC,cAAc,IAAI,EAAE,EAAE;QAC/F,SAAS,EAAE,SAAS;QACpB,YAAY,EAAE,MAAe;QAC7B,GAAG,EAAE,GAAG,CAAC,cAAc,EAAE,GAAG,IAAI,GAAG,CAAC,GAAG;QACvC,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,IAAI,MAAM;QAC3C,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,SAAS;QACzC,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,UAAU;QAC3C,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,aAAa,IAAI,UAAU;KAChE,CAAC;IACF,YAAY,EAAE,mBAAmB;IACjC,gBAAgB,EAAE,uBAAuB;CAC1C,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,11 @@
+export * as delegate from './delegate/schema.js';
+export * as audit from './audit/schema.js';
+export * as review from './review/schema.js';
+export * as verify from './verify/schema.js';
+export * as debug from './debug/schema.js';
+export * as executePlan from './execute-plan/schema.js';
+export * as retry from './retry/schema.js';
+export * as investigate from './investigate/schema.js';
+export * as explore from './explore/schema.js';
+export * as registerContextBlock from './register-context-block/schema.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,QAAQ,MAAM,sBAAsB,CAAC;AACjD,OAAO,KAAK,KAAK,MAAM,mBAAmB,CAAC;AAC3C,OAAO,KAAK,MAAM,MAAM,oBAAoB,CAAC;AAC7C,OAAO,KAAK,MAAM,MAAM,oBAAoB,CAAC;AAC7C,OAAO,KAAK,KAAK,MAAM,mBAAmB,CAAC;AAC3C,OAAO,KAAK,WAAW,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,KAAK,MAAM,mBAAmB,CAAC;AAC3C,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AACvD,OAAO,KAAK,OAAO,MAAM,qBAAqB,CAAC;AAC/C,OAAO,KAAK,oBAAoB,MAAM,oCAAoC,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,16 @@
+// Public schema barrel — namespaces every per-tool input/output schema so
+// contract tests (`tests/per-task/envelope-contract.test.ts`) and external
+// SDK consumers can iterate `Object.entries(...)` to assert envelope-shape
+// invariants across all tools at once. Per-tool internal code imports each
+// `tools/<tool>/schema.ts` directly.
+export * as delegate from './delegate/schema.js';
+export * as audit from './audit/schema.js';
+export * as review from './review/schema.js';
+export * as verify from './verify/schema.js';
+export * as debug from './debug/schema.js';
+export * as executePlan from './execute-plan/schema.js';
+export * as retry from './retry/schema.js';
+export * as investigate from './investigate/schema.js';
+export * as explore from './explore/schema.js';
+export * as registerContextBlock from './register-context-block/schema.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,2EAA2E;AAC3E,2EAA2E;AAC3E,2EAA2E;AAC3E,qCAAqC;AACrC,OAAO,KAAK,QAAQ,MAAM,sBAAsB,CAAC;AACjD,OAAO,KAAK,KAAK,MAAM,mBAAmB,CAAC;AAC3C,OAAO,KAAK,MAAM,MAAM,oBAAoB,CAAC;AAC7C,OAAO,KAAK,MAAM,MAAM,oBAAoB,CAAC;AAC7C,OAAO,KAAK,KAAK,MAAM,mBAAmB,CAAC;AAC3C,OAAO,KAAK,WAAW,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,KAAK,MAAM,mBAAmB,CAAC;AAC3C,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AACvD,OAAO,KAAK,OAAO,MAAM,qBAAqB,CAAC;AAC/C,OAAO,KAAK,oBAAoB,MAAM,oCAAoC,CAAC"}