@roackb2/heddle 1.4.0 → 1.6.0

package/dist/src/core/agent/mutation/types.js.map

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

package/dist/src/core/agent/planning/index.d.ts

@@ -0,0 +1,3 @@
+export { AgentPlanStateParser } from './plan-state-parser.js';
+export type { AgentPlanState, ParseAgentPlanStateArgs, PlanItem } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/core/agent/planning/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/core/agent/planning/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EAAE,cAAc,EAAE,uBAAuB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/src/core/agent/planning/index.js

@@ -0,0 +1,2 @@
+export { AgentPlanStateParser } from './plan-state-parser.js';
+//# sourceMappingURL=index.js.map

package/dist/src/core/agent/planning/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/core/agent/planning/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/src/core/agent/planning/plan-state-parser.d.ts

@@ -0,0 +1,9 @@
+import type { AgentPlanState, ParseAgentPlanStateArgs } from './types.js';
+/**
+ * Parses update_plan tool output into the agent's active plan state.
+ */
+export declare class AgentPlanStateParser {
+    static parse(args: ParseAgentPlanStateArgs): AgentPlanState | undefined;
+    private static parseItem;
+}
+//# sourceMappingURL=plan-state-parser.d.ts.map

package/dist/src/core/agent/planning/plan-state-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-state-parser.d.ts","sourceRoot":"","sources":["../../../../../src/core/agent/planning/plan-state-parser.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAI1E;;GAEG;AACH,qBAAa,oBAAoB;IAC/B,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,uBAAuB,GAAG,cAAc,GAAG,SAAS;IAqBvE,OAAO,CAAC,MAAM,CAAC,SAAS;CAazB"}

package/dist/src/core/agent/planning/plan-state-parser.js

@@ -0,0 +1,35 @@
+const PLAN_ITEM_STATUSES = new Set(['pending', 'in_progress', 'completed']);
+/**
+ * Parses update_plan tool output into the agent's active plan state.
+ */
+export class AgentPlanStateParser {
+    static parse(args) {
+        if (!args.output || typeof args.output !== 'object' || Array.isArray(args.output)) {
+            return undefined;
+        }
+        const candidate = args.output;
+        if (!Array.isArray(candidate.plan)) {
+            return undefined;
+        }
+        const items = candidate.plan.flatMap((item) => AgentPlanStateParser.parseItem(item));
+        if (items.length === 0) {
+            return undefined;
+        }
+        return {
+            explanation: typeof candidate.explanation === 'string' ? candidate.explanation : undefined,
+            items,
+        };
+    }
+    static parseItem(item) {
+        if (!item || typeof item !== 'object' || Array.isArray(item)) {
+            return [];
+        }
+        const step = typeof item.step === 'string' ? item.step : undefined;
+        const status = item.status;
+        if (!step || typeof status !== 'string' || !PLAN_ITEM_STATUSES.has(status)) {
+            return [];
+        }
+        return [{ step, status: status }];
+    }
+}
+//# sourceMappingURL=plan-state-parser.js.map

package/dist/src/core/agent/planning/plan-state-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-state-parser.js","sourceRoot":"","sources":["../../../../../src/core/agent/planning/plan-state-parser.ts"],"names":[],"mappings":"AAGA,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAqB,CAAC,SAAS,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC,CAAC;AAEhG;;GAEG;AACH,MAAM,OAAO,oBAAoB;IAC/B,MAAM,CAAC,KAAK,CAAC,IAA6B;QACxC,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YAClF,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,MAAmD,CAAC;QAC3E,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,oBAAoB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;QACrF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO;YACL,WAAW,EAAE,OAAO,SAAS,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;YAC1F,KAAK;SACN,CAAC;IACJ,CAAC;IAEO,MAAM,CAAC,SAAS,CAAC,IAAa;QACpC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7D,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,IAAI,GAAG,OAAQ,IAA2B,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAE,IAAyB,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;QACjH,MAAM,MAAM,GAAI,IAA6B,CAAC,MAAM,CAAC;QACrD,IAAI,CAAC,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,MAA4B,CAAC,EAAE,CAAC;YACjG,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAA4B,EAAE,CAAC,CAAC;IAC1D,CAAC;CACF"}

package/dist/src/core/agent/planning/types.d.ts

@@ -0,0 +1,7 @@
+import type { PlanItem } from '../../../core/tools/toolkits/internal/update-plan.js';
+import type { AgentPlanState } from '../types.js';
+export type ParseAgentPlanStateArgs = {
+    output: unknown;
+};
+export type { AgentPlanState, PlanItem };
+//# sourceMappingURL=types.d.ts.map

package/dist/src/core/agent/planning/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/core/agent/planning/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+CAA+C,CAAC;AAC9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,MAAM,uBAAuB,GAAG;IACpC,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,YAAY,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAC"}

package/dist/src/core/agent/planning/types.js

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

package/dist/src/core/agent/planning/types.js.map

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

package/dist/src/core/agent/service.d.ts

@@ -0,0 +1,10 @@
+import type { RunResult } from '../../core/types.js';
+import type { RunAgentOptions } from './types.js';
+/**
+ * Owns the low-level model/tool loop for one agent run.
+ */
+export declare class AgentRunService {
+    static run(options: RunAgentOptions): Promise<RunResult>;
+    private static beginStep;
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/src/core/agent/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../../src/core/agent/service.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAmB,MAAM,YAAY,CAAC;AAEnE;;GAEG;AACH,qBAAa,eAAe;WACb,GAAG,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC;IAqC9D,OAAO,CAAC,MAAM,CAAC,SAAS;CAKzB"}

package/dist/src/core/agent/service.js

@@ -0,0 +1,44 @@
+import { AgentRunContextBuilder } from './context/index.js';
+import { AgentModelTurnService } from './model/index.js';
+import { AgentToolTurnService } from './tools/index.js';
+import { AgentRunFinisher } from './finish/index.js';
+/**
+ * Owns the low-level model/tool loop for one agent run.
+ */
+export class AgentRunService {
+    static async run(options) {
+        const context = AgentRunContextBuilder.create(options);
+        context.log.info({ goal: options.goal, maxSteps: context.maxSteps, tools: context.registry.names() }, 'Agent run started');
+        context.record({ type: 'run.started', goal: options.goal, timestamp: context.now() });
+        while (!context.budget.exhausted()) {
+            const interrupted = AgentRunFinisher.maybeInterrupted(context, 'Agent run interrupted before next step');
+            if (interrupted) {
+                return interrupted;
+            }
+            AgentRunService.beginStep(context);
+            const responseResult = await AgentModelTurnService.request({ context });
+            if (AgentRunFinisher.isRunResult(responseResult)) {
+                return responseResult;
+            }
+            if (responseResult.toolCalls && responseResult.toolCalls.length > 0) {
+                const toolTurnResult = await AgentToolTurnService.handle({ context, response: responseResult });
+                if (toolTurnResult !== 'continue') {
+                    return toolTurnResult;
+                }
+                continue;
+            }
+            const finalResponse = AgentRunFinisher.finishAssistantResponse(context, responseResult);
+            if (finalResponse === 'continue') {
+                continue;
+            }
+            return finalResponse;
+        }
+        return AgentRunFinisher.maxSteps(context);
+    }
+    static beginStep(context) {
+        context.state.step++;
+        context.budget.step();
+        context.log.debug({ step: context.state.step, budgetRemaining: context.budget.remaining() }, 'Calling LLM');
+    }
+}
+//# sourceMappingURL=service.js.map

package/dist/src/core/agent/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../../../src/core/agent/service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAIrD;;GAEG;AACH,MAAM,OAAO,eAAe;IAC1B,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,OAAwB;QACvC,MAAM,OAAO,GAAG,sBAAsB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAEvD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,EAAE,mBAAmB,CAAC,CAAC;QAC3H,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAEtF,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,CAAC;YACnC,MAAM,WAAW,GAAG,gBAAgB,CAAC,gBAAgB,CAAC,OAAO,EAAE,wCAAwC,CAAC,CAAC;YACzG,IAAI,WAAW,EAAE,CAAC;gBAChB,OAAO,WAAW,CAAC;YACrB,CAAC;YAED,eAAe,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YACnC,MAAM,cAAc,GAAG,MAAM,qBAAqB,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;YACxE,IAAI,gBAAgB,CAAC,WAAW,CAAC,cAAc,CAAC,EAAE,CAAC;gBACjD,OAAO,cAAc,CAAC;YACxB,CAAC;YAED,IAAI,cAAc,CAAC,SAAS,IAAI,cAAc,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpE,MAAM,cAAc,GAAG,MAAM,oBAAoB,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC,CAAC;gBAChG,IAAI,cAAc,KAAK,UAAU,EAAE,CAAC;oBAClC,OAAO,cAAc,CAAC;gBACxB,CAAC;gBACD,SAAS;YACX,CAAC;YAED,MAAM,aAAa,GAAG,gBAAgB,CAAC,uBAAuB,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;YACxF,IAAI,aAAa,KAAK,UAAU,EAAE,CAAC;gBACjC,SAAS;YACX,CAAC;YAED,OAAO,aAAa,CAAC;QACvB,CAAC;QAED,OAAO,gBAAgB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;IAEO,MAAM,CAAC,SAAS,CAAC,OAAwB;QAC/C,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QACrB,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,EAAE,aAAa,CAAC,CAAC;IAC9G,CAAC;CACF"}

package/dist/src/core/agent/tools/index.d.ts

@@ -0,0 +1,4 @@
+export { AgentToolTurnService } from './tool-turn-service.js';
+export { AgentToolDispatcher } from './tool-dispatcher.js';
+export type { AgentToolTurnResult, ExecuteAgentToolTurnArgs, HandleAgentToolResultArgs, HandleAgentToolTurnArgs, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/core/agent/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/core/agent/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,YAAY,EACV,mBAAmB,EACnB,wBAAwB,EACxB,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,YAAY,CAAC"}

package/dist/src/core/agent/tools/index.js

@@ -0,0 +1,3 @@
+export { AgentToolTurnService } from './tool-turn-service.js';
+export { AgentToolDispatcher } from './tool-dispatcher.js';
+//# sourceMappingURL=index.js.map

package/dist/src/core/agent/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/core/agent/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/src/core/agent/tools/tool-dispatcher.d.ts

@@ -0,0 +1,47 @@
+import type { Logger } from 'pino';
+import type { ToolApprovalPolicy } from '../../../core/approvals/types.js';
+import { executeTool } from '../../../core/tools/execute-tool.js';
+import { createToolRegistry } from '../../../core/tools/registry.js';
+import type { ToolCall, ToolDefinition, TraceEvent } from '../../../core/types.js';
+import type { RunAgentOptions } from '../types.js';
+/**
+ * Owns tool approval, execution, deduplication, and inspect-to-mutate fallback.
+ *
+ * ToolTurnService decides when tool calls are needed; this dispatcher owns how
+ * a single call is authorized, executed, traced, and optionally retried.
+ */
+export declare class AgentToolDispatcher {
+    static maybeDenyToolCall(args: {
+        call: ToolCall;
+        tool: ToolDefinition | undefined;
+        step: number;
+        now: () => string;
+        approvalPolicies?: ToolApprovalPolicy[];
+        approveToolCall: RunAgentOptions['approveToolCall'];
+        workspaceRoot?: string;
+        record: (event: TraceEvent) => void;
+        log: Logger;
+    }): Promise<{
+        ok: false;
+        error: string;
+    } | undefined>;
+    static executeToolCallWithFallback(args: {
+        call: ToolCall;
+        step: number;
+        now: () => string;
+        registry: ReturnType<typeof createToolRegistry>;
+        seenToolCalls: Map<string, number>;
+        approvalPolicies?: ToolApprovalPolicy[];
+        approveToolCall: RunAgentOptions['approveToolCall'];
+        workspaceRoot?: string;
+        record: (event: TraceEvent) => void;
+        log: Logger;
+    }): Promise<{
+        effectiveCall: ToolCall;
+        result: Awaited<ReturnType<typeof executeTool>>;
+    }>;
+    private static executeRecordedToolCall;
+    private static getInspectFallbackReason;
+    private static getInspectMutateFallbackReason;
+}
+//# sourceMappingURL=tool-dispatcher.d.ts.map

package/dist/src/core/agent/tools/tool-dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-dispatcher.d.ts","sourceRoot":"","sources":["../../../../../src/core/agent/tools/tool-dispatcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE5E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD;;;;;GAKG;AACH,qBAAa,mBAAmB;WACjB,iBAAiB,CAAC,IAAI,EAAE;QACnC,IAAI,EAAE,QAAQ,CAAC;QACf,IAAI,EAAE,cAAc,GAAG,SAAS,CAAC;QACjC,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,MAAM,CAAC;QAClB,gBAAgB,CAAC,EAAE,kBAAkB,EAAE,CAAC;QACxC,eAAe,EAAE,eAAe,CAAC,iBAAiB,CAAC,CAAC;QACpD,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,MAAM,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;QACpC,GAAG,EAAE,MAAM,CAAC;KACb,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;WA0CxC,2BAA2B,CAAC,IAAI,EAAE;QAC7C,IAAI,EAAE,QAAQ,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,MAAM,CAAC;QAClB,QAAQ,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC;QAChD,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACnC,gBAAgB,CAAC,EAAE,kBAAkB,EAAE,CAAC;QACxC,eAAe,EAAE,eAAe,CAAC,iBAAiB,CAAC,CAAC;QACpD,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,MAAM,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;QACpC,GAAG,EAAE,MAAM,CAAC;KACb,GAAG,OAAO,CAAC;QAAE,aAAa,EAAE,QAAQ,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC,CAAA;KAAE,CAAC;mBA+CpE,uBAAuB;IA+B5C,OAAO,CAAC,MAAM,CAAC,wBAAwB;IAWvC,OAAO,CAAC,MAAM,CAAC,8BAA8B;CAe9C"}

package/dist/src/core/agent/tools/tool-dispatcher.js

@@ -0,0 +1,123 @@
+import { ToolApprovalPolicies, ToolApprovalService } from '../../../core/approvals/index.js';
+import { executeTool } from '../../../core/tools/execute-tool.js';
+import { normalizeToolInput, stableSerialize } from '../../../core/agent/utils/index.js';
+/**
+ * Owns tool approval, execution, deduplication, and inspect-to-mutate fallback.
+ *
+ * ToolTurnService decides when tool calls are needed; this dispatcher owns how
+ * a single call is authorized, executed, traced, and optionally retried.
+ */
+export class AgentToolDispatcher {
+    static async maybeDenyToolCall(args) {
+        const { call, tool, step, now, approveToolCall, record, log } = args;
+        if (!tool) {
+            return undefined;
+        }
+        const approval = await ToolApprovalService.resolve({
+            policies: [...ToolApprovalPolicies.default(), ...(args.approvalPolicies ?? [])],
+            context: {
+                call,
+                tool,
+                workspaceRoot: args.workspaceRoot,
+            },
+            requestHumanApproval: approveToolCall ? async () => {
+                record({ type: 'tool.approval_requested', call, step, timestamp: now() });
+                const humanDecision = await approveToolCall(call, tool);
+                record({
+                    type: 'tool.approval_resolved',
+                    call,
+                    approved: humanDecision.approved,
+                    reason: humanDecision.reason,
+                    step,
+                    timestamp: now(),
+                });
+                return humanDecision;
+            } : undefined,
+        });
+        if (approval.approved) {
+            return undefined;
+        }
+        const result = {
+            ok: false,
+            error: approval.reason ? `Approval denied for ${call.tool}: ${approval.reason}`
+                : `Approval denied for ${call.tool}`,
+        };
+        log.warn({ step, tool: call.tool, reason: approval.reason }, 'Tool execution denied by approval policy');
+        record({ type: 'tool.result', tool: call.tool, result, step, timestamp: now() });
+        return result;
+    }
+    static async executeToolCallWithFallback(args) {
+        const primary = await AgentToolDispatcher.executeRecordedToolCall(args.call, args);
+        const fallbackReason = AgentToolDispatcher.getInspectFallbackReason(args.call, primary.result);
+        if (!fallbackReason) {
+            return primary;
+        }
+        const mutateTool = args.registry.get('run_shell_mutate');
+        if (!mutateTool) {
+            return primary;
+        }
+        const mutateCall = {
+            id: `${args.call.id}-mutate-fallback`,
+            tool: 'run_shell_mutate',
+            input: args.call.input,
+        };
+        args.record({
+            type: 'tool.fallback',
+            fromCall: args.call,
+            toCall: mutateCall,
+            reason: fallbackReason,
+            step: args.step,
+            timestamp: args.now(),
+        });
+        const approvalDeniedResult = await AgentToolDispatcher.maybeDenyToolCall({
+            call: mutateCall,
+            tool: mutateTool,
+            step: args.step,
+            now: args.now,
+            approveToolCall: args.approveToolCall,
+            approvalPolicies: args.approvalPolicies,
+            workspaceRoot: args.workspaceRoot,
+            record: args.record,
+            log: args.log,
+        });
+        if (approvalDeniedResult) {
+            return { effectiveCall: mutateCall, result: approvalDeniedResult };
+        }
+        args.log.info({ step: args.step, from: args.call.tool, to: mutateCall.tool, reason: fallbackReason }, 'Retrying inspect failure through mutate fallback');
+        return AgentToolDispatcher.executeRecordedToolCall(mutateCall, args);
+    }
+    static async executeRecordedToolCall(call, args) {
+        const { step, now, registry, seenToolCalls, record, log } = args;
+        log.info({ step, tool: call.tool }, 'Executing tool');
+        record({ type: 'tool.call', call, step, timestamp: now() });
+        const signature = `${call.tool}:${stableSerialize(normalizeToolInput(call.tool, call.input))}`;
+        const seenCount = seenToolCalls.get(signature) ?? 0;
+        if (seenCount >= 2) {
+            log.warn({ step, tool: call.tool, repeatCount: seenCount + 1 }, 'Executing repeated identical tool call; warning only');
+        }
+        const result = await executeTool(registry, call);
+        seenToolCalls.set(signature, seenCount + 1);
+        log.debug({ step, tool: call.tool, ok: result.ok }, 'Tool result');
+        record({ type: 'tool.result', tool: call.tool, result, step, timestamp: now() });
+        return { effectiveCall: call, result };
+    }
+    static getInspectFallbackReason(call, result) {
+        if (call.tool !== 'run_shell_inspect' || result.ok) {
+            return undefined;
+        }
+        return AgentToolDispatcher.getInspectMutateFallbackReason(result.error);
+    }
+    static getInspectMutateFallbackReason(error) {
+        if (!error) {
+            return undefined;
+        }
+        if (error.includes('run_shell_inspect policy')) {
+            return 'inspect policy rejected the command';
+        }
+        if (error.includes('Inspect mode permits read-only pipes')) {
+            return 'inspect shell restrictions rejected the command';
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=tool-dispatcher.js.map

package/dist/src/core/agent/tools/tool-dispatcher.js.map

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

package/dist/src/core/agent/tools/tool-turn-service.d.ts

@@ -0,0 +1,13 @@
+import type { AgentToolTurnResult, HandleAgentToolTurnArgs } from './types.js';
+/**
+ * Owns assistant tool-call turns inside the agent loop.
+ */
+export declare class AgentToolTurnService {
+    static handle(args: HandleAgentToolTurnArgs): Promise<AgentToolTurnResult>;
+    private static execute;
+    private static handleDeniedResult;
+    private static handleExecutedResult;
+    private static handleFailedExecution;
+    private static pushHostRequirementReminders;
+}
+//# sourceMappingURL=tool-turn-service.d.ts.map

package/dist/src/core/agent/tools/tool-turn-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-turn-service.d.ts","sourceRoot":"","sources":["../../../../../src/core/agent/tools/tool-turn-service.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,mBAAmB,EAGnB,uBAAuB,EACxB,MAAM,YAAY,CAAC;AAGpB;;GAEG;AACH,qBAAa,oBAAoB;WAClB,MAAM,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,mBAAmB,CAAC;mBA6B3D,OAAO;IAuD5B,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAejC,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAyBnC,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAKpC,OAAO,CAAC,MAAM,CAAC,4BAA4B;CAQ5C"}

package/dist/src/core/agent/tools/tool-turn-service.js

@@ -0,0 +1,129 @@
+import { AgentMemoryCheckpointTracker } from '../memory/index.js';
+import { AgentMutationTracker } from '../mutation/index.js';
+import { AgentPlanStateParser } from '../planning/index.js';
+import { AgentRunFinisher } from '../finish/index.js';
+import { AgentToolDispatcher } from './tool-dispatcher.js';
+/**
+ * Owns assistant tool-call turns inside the agent loop.
+ */
+export class AgentToolTurnService {
+    static async handle(args) {
+        const { context, response } = args;
+        const toolCalls = response.toolCalls ?? [];
+        context.record({
+            type: 'assistant.turn',
+            content: response.content ?? '',
+            diagnostics: response.diagnostics,
+            requestedTools: true,
+            toolCalls,
+            step: context.state.step,
+            timestamp: context.now(),
+        });
+        context.messages.push({
+            role: 'assistant',
+            content: response.content ?? '',
+            toolCalls,
+        });
+        for (const call of toolCalls) {
+            const toolCallResult = await AgentToolTurnService.execute({ context, call });
+            if (toolCallResult) {
+                return toolCallResult;
+            }
+        }
+        return 'continue';
+    }
+    static async execute(args) {
+        const { context, call } = args;
+        const interrupted = AgentRunFinisher.maybeInterrupted(context, 'Agent run interrupted before tool execution');
+        if (interrupted) {
+            return interrupted;
+        }
+        const tool = context.registry.get(call.tool);
+        if (tool) {
+            context.onToolCalling?.(call, context.state.step, tool);
+        }
+        const toolStartTime = Date.now();
+        const approvalDeniedResult = await AgentToolDispatcher.maybeDenyToolCall({
+            call,
+            tool,
+            step: context.state.step,
+            now: context.now,
+            approveToolCall: context.approveToolCall,
+            approvalPolicies: context.approvalPolicies,
+            workspaceRoot: context.workspaceRoot,
+            record: context.record,
+            log: context.log,
+        });
+        if (approvalDeniedResult) {
+            const durationMs = Date.now() - toolStartTime;
+            context.onToolCompleted?.(call, approvalDeniedResult, context.state.step, durationMs);
+            return AgentToolTurnService.handleDeniedResult(context, call.id, approvalDeniedResult);
+        }
+        const execution = await AgentToolDispatcher.executeToolCallWithFallback({
+            call,
+            step: context.state.step,
+            now: context.now,
+            registry: context.registry,
+            seenToolCalls: context.seenToolCalls,
+            approveToolCall: context.approveToolCall,
+            approvalPolicies: context.approvalPolicies,
+            workspaceRoot: context.workspaceRoot,
+            record: context.record,
+            log: context.log,
+        });
+        const durationMs = Date.now() - toolStartTime;
+        context.state.executedToolCalls++;
+        context.onToolCompleted?.(execution.effectiveCall, execution.result, context.state.step, durationMs);
+        return AgentToolTurnService.handleExecutedResult({
+            context,
+            effectiveCall: execution.effectiveCall,
+            toolCallId: call.id,
+            result: execution.result,
+        });
+    }
+    static handleDeniedResult(context, toolCallId, result) {
+        context.state.consecutiveErrors++;
+        context.messages.push({
+            role: 'tool',
+            content: JSON.stringify(result),
+            toolCallId,
+        });
+        return undefined;
+    }
+    static handleExecutedResult(args) {
+        const { context, effectiveCall, toolCallId, result } = args;
+        if (!result.ok) {
+            const maybeFailure = AgentToolTurnService.handleFailedExecution(context, result);
+            if (maybeFailure) {
+                return maybeFailure;
+            }
+        }
+        else {
+            context.state.consecutiveErrors = 0;
+            AgentMutationTracker.trackToolResult({ state: context.mutation, effectiveCall, result });
+            AgentMemoryCheckpointTracker.trackToolResult({ context, effectiveCall, result });
+            if (effectiveCall.tool === 'update_plan') {
+                context.state.activePlan = AgentPlanStateParser.parse({ output: result.output });
+            }
+        }
+        context.messages.push({
+            role: 'tool',
+            content: JSON.stringify(result),
+            toolCallId,
+        });
+        AgentToolTurnService.pushHostRequirementReminders(context);
+        return undefined;
+    }
+    static handleFailedExecution(context, _result) {
+        context.state.consecutiveErrors++;
+        return undefined;
+    }
+    static pushHostRequirementReminders(context) {
+        const memoryReminder = AgentMemoryCheckpointTracker.buildReminder(context);
+        if (memoryReminder && !context.state.reminders.memoryCheckpointSent) {
+            context.state.reminders.memoryCheckpointSent = true;
+            context.messages.push({ role: 'system', content: memoryReminder });
+        }
+    }
+}
+//# sourceMappingURL=tool-turn-service.js.map

package/dist/src/core/agent/tools/tool-turn-service.js.map

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

package/dist/src/core/agent/tools/types.d.ts

@@ -0,0 +1,19 @@
+import type { LlmResponse } from '../../../core/llm/types.js';
+import type { RunResult, ToolCall, ToolResult } from '../../../core/types.js';
+import type { AgentRunContext } from '../types.js';
+export type HandleAgentToolTurnArgs = {
+    context: AgentRunContext;
+    response: LlmResponse;
+};
+export type ExecuteAgentToolTurnArgs = {
+    context: AgentRunContext;
+    call: ToolCall;
+};
+export type AgentToolTurnResult = RunResult | 'continue';
+export type HandleAgentToolResultArgs = {
+    context: AgentRunContext;
+    effectiveCall: ToolCall;
+    toolCallId: string;
+    result: ToolResult;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/src/core/agent/tools/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/core/agent/tools/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,EAAE,eAAe,CAAC;IACzB,QAAQ,EAAE,WAAW,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,EAAE,eAAe,CAAC;IACzB,IAAI,EAAE,QAAQ,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,UAAU,CAAC;AAEzD,MAAM,MAAM,yBAAyB,GAAG;IACtC,OAAO,EAAE,eAAe,CAAC;IACzB,aAAa,EAAE,QAAQ,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,UAAU,CAAC;CACpB,CAAC"}

package/dist/src/core/agent/tools/types.js

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

package/dist/src/core/agent/tools/types.js.map

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