@roackb2/heddle 1.3.0 → 1.5.0

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

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

@@ -0,0 +1,83 @@
+import type { Logger } from 'pino';
+import type { LlmAdapter, ChatMessage, LlmUsage } from '../../core/llm/types.js';
+import type { ToolApprovalPolicy } from '../../core/approvals/types.js';
+import type { ToolRegistry } from '../../core/tools/registry.js';
+import type { PlanItem } from '../../core/tools/toolkits/internal/update-plan.js';
+import type { RunResult, ToolDefinition, ToolCall, ToolResult, TraceEvent, StopReason } from '../../core/types.js';
+import type { createBudget } from '../../core/utils/budget.js';
+import type { createTraceRecorder } from '../../core/trace/recorder.js';
+import type { MutationState } from './mutation/index.js';
+export type RunAgentOptions = {
+    goal: string;
+    llm: LlmAdapter;
+    tools: ToolDefinition[];
+    maxSteps?: number;
+    workspaceRoot?: string;
+    logger?: Logger;
+    history?: ChatMessage[];
+    systemContext?: string;
+    onEvent?: (event: TraceEvent) => void;
+    onAssistantStream?: (update: {
+        step: number;
+        text: string;
+        done: boolean;
+    }) => void;
+    onToolCalling?: (call: ToolCall, step: number, toolDef: ToolDefinition) => void;
+    onToolCompleted?: (call: ToolCall, result: ToolResult, step: number, durationMs: number) => void;
+    approvalPolicies?: ToolApprovalPolicy[];
+    approveToolCall?: (call: ToolCall, tool: ToolDefinition) => Promise<{
+        approved: boolean;
+        reason?: string;
+    }>;
+    shouldStop?: () => boolean;
+    abortSignal?: AbortSignal;
+};
+export type AgentMemoryCheckpointState = {
+    required: boolean;
+    completed: boolean;
+};
+export type AgentReminderState = {
+    postMutationFollowUpSent: boolean;
+    memoryCheckpointSent: boolean;
+    structuredSummarySent: boolean;
+};
+export type AgentPlanState = {
+    explanation?: string;
+    items: PlanItem[];
+};
+export type AgentRunState = {
+    step: number;
+    consecutiveErrors: number;
+    executedToolCalls: number;
+    outcome: StopReason;
+    summary: string;
+    usage?: LlmUsage;
+    memoryCheckpoint: AgentMemoryCheckpointState;
+    reminders: AgentReminderState;
+    activePlan?: AgentPlanState;
+};
+export type AgentRunContext = {
+    goal: string;
+    maxSteps: number;
+    llm: LlmAdapter;
+    registry: ToolRegistry;
+    workspaceRoot: string;
+    log: Logger;
+    messages: ChatMessage[];
+    trace: ReturnType<typeof createTraceRecorder>;
+    record: (event: TraceEvent) => void;
+    now: () => string;
+    budget: ReturnType<typeof createBudget>;
+    seenToolCalls: Map<string, number>;
+    mutation: MutationState;
+    onAssistantStream?: RunAgentOptions['onAssistantStream'];
+    onToolCalling?: RunAgentOptions['onToolCalling'];
+    onToolCompleted?: RunAgentOptions['onToolCompleted'];
+    approvalPolicies: ToolApprovalPolicy[];
+    approveToolCall?: RunAgentOptions['approveToolCall'];
+    shouldStop?: RunAgentOptions['shouldStop'];
+    abortSignal?: AbortSignal;
+    state: AgentRunState;
+};
+export type AgentRunStepResult = RunResult | 'continue';
+//# sourceMappingURL=types.d.ts.map

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

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

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

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

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

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

package/dist/src/core/agent/utils/abort.d.ts

@@ -0,0 +1,2 @@
+export declare function isAbortError(err: unknown): boolean;
+//# sourceMappingURL=abort.d.ts.map

package/dist/src/core/agent/utils/abort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort.d.ts","sourceRoot":"","sources":["../../../../../src/core/agent/utils/abort.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAUlD"}

package/dist/src/core/agent/utils/abort.js

@@ -0,0 +1,9 @@
+export function isAbortError(err) {
+    if (!(err instanceof Error)) {
+        return false;
+    }
+    return (err.name === 'AbortError' ||
+        err.name === 'APIUserAbortError' ||
+        /aborted/i.test(err.message));
+}
+//# sourceMappingURL=abort.js.map

package/dist/src/core/agent/utils/abort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort.js","sourceRoot":"","sources":["../../../../../src/core/agent/utils/abort.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,YAAY,CAAC,GAAY;IACvC,IAAI,CAAC,CAAC,GAAG,YAAY,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,CACL,GAAG,CAAC,IAAI,KAAK,YAAY;QACzB,GAAG,CAAC,IAAI,KAAK,mBAAmB;QAChC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAC7B,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,4 @@
+export { isAbortError } from './abort.js';
+export { stableSerialize } from './serialization.js';
+export { extractShellCommand, normalizeToolInput } from './tool-input.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/core/agent/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC"}

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

@@ -0,0 +1,4 @@
+export { isAbortError } from './abort.js';
+export { stableSerialize } from './serialization.js';
+export { extractShellCommand, normalizeToolInput } from './tool-input.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/core/agent/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/src/core/agent/utils/serialization.d.ts

@@ -0,0 +1,2 @@
+export declare function stableSerialize(value: unknown): string;
+//# sourceMappingURL=serialization.d.ts.map

package/dist/src/core/agent/utils/serialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.d.ts","sourceRoot":"","sources":["../../../../../src/core/agent/utils/serialization.ts"],"names":[],"mappings":"AAAA,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAWtD"}

package/dist/src/core/agent/utils/serialization.js

@@ -0,0 +1,11 @@
+export function stableSerialize(value) {
+    if (Array.isArray(value)) {
+        return `[${value.map((item) => stableSerialize(item)).join(',')}]`;
+    }
+    if (value && typeof value === 'object') {
+        const entries = Object.entries(value).sort(([left], [right]) => left.localeCompare(right));
+        return `{${entries.map(([key, entryValue]) => `${JSON.stringify(key)}:${stableSerialize(entryValue)}`).join(',')}}`;
+    }
+    return JSON.stringify(value);
+}
+//# sourceMappingURL=serialization.js.map

package/dist/src/core/agent/utils/serialization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.js","sourceRoot":"","sources":["../../../../../src/core/agent/utils/serialization.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IACrE,CAAC;IAED,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;QACtH,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,eAAe,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IACtH,CAAC;IAED,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC"}

package/dist/src/core/agent/utils/tool-input.d.ts

@@ -0,0 +1,3 @@
+export declare function extractShellCommand(input: unknown): string | undefined;
+export declare function normalizeToolInput(tool: string, input: unknown): unknown;
+//# sourceMappingURL=tool-input.d.ts.map

package/dist/src/core/agent/utils/tool-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-input.d.ts","sourceRoot":"","sources":["../../../../../src/core/agent/utils/tool-input.ts"],"names":[],"mappings":"AAAA,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAOtE;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAoBxE"}

package/dist/src/core/agent/{util.js → utils/tool-input.js}

@@ -1,6 +1,3 @@
-// ---------------------------------------------------------------------------
-// Small utilities shared across the run-agent submodules.
-// ---------------------------------------------------------------------------
 export function extractShellCommand(input) {
     if (!input || typeof input !== 'object' || Array.isArray(input)) {
         return undefined;
@@ -8,16 +5,6 @@ export function extractShellCommand(input) {
     const command = input.command;
     return typeof command === 'string' && command.trim() ? command.trim() : undefined;
 }
-export function stableSerialize(value) {
-    if (Array.isArray(value)) {
-        return `[${value.map((item) => stableSerialize(item)).join(',')}]`;
-    }
-    if (value && typeof value === 'object') {
-        const entries = Object.entries(value).sort(([left], [right]) => left.localeCompare(right));
-        return `{${entries.map(([key, entryValue]) => `${JSON.stringify(key)}:${stableSerialize(entryValue)}`).join(',')}}`;
-    }
-    return JSON.stringify(value);
-}
 export function normalizeToolInput(tool, input) {
     if (!input || typeof input !== 'object' || Array.isArray(input)) {
         return input;
@@ -41,18 +28,4 @@ function normalizePathValue(path) {
     }
     return trimmed.replace(/\/+$/, '') || '.';
 }
-export function isRecoverableToolError(error) {
-    if (!error) {
-        return false;
-    }
-    return error.startsWith('Invalid input for ');
-}
-export function isAbortError(err) {
-    if (!(err instanceof Error)) {
-        return false;
-    }
-    return (err.name === 'AbortError' ||
-        err.name === 'APIUserAbortError' ||
-        /aborted/i.test(err.message));
-}
-//# sourceMappingURL=util.js.map
+//# sourceMappingURL=tool-input.js.map

package/dist/src/core/agent/utils/tool-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-input.js","sourceRoot":"","sources":["../../../../../src/core/agent/utils/tool-input.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChE,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,OAAO,GAAI,KAA+B,CAAC,OAAO,CAAC;IACzD,OAAO,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AACpF,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,KAAc;IAC7D,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,UAAU,GAAG,EAAE,GAAI,KAAiC,EAAE,CAAC;IAE7D,IAAI,CAAC,IAAI,KAAK,YAAY,IAAI,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,cAAc,CAAC,IAAI,OAAO,UAAU,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtH,UAAU,CAAC,IAAI,GAAG,kBAAkB,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACxD,CAAC;IAED,IAAI,IAAI,KAAK,WAAW,IAAI,OAAO,UAAU,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAChE,UAAU,CAAC,IAAI,GAAG,kBAAkB,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACxD,CAAC;IAED,IAAI,CAAC,IAAI,KAAK,mBAAmB,IAAI,IAAI,KAAK,kBAAkB,CAAC,IAAI,OAAO,UAAU,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC5G,UAAU,CAAC,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACtE,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAY;IACtC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC;QACxC,OAAO,GAAG,CAAC;IACb,CAAC;IAED,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC;AAC5C,CAAC"}

package/dist/src/core/approvals/index.d.ts

@@ -0,0 +1,5 @@
+export { PendingToolApprovalRequests } from './pending-approval.js';
+export { ToolApprovalPolicies } from './policies.js';
+export { ToolApprovalService } from './service.js';
+export type { EvaluateToolApprovalPoliciesArgs, PendingToolApprovalView, RequestPendingToolApprovalArgs, ResolveToolApprovalArgs, ToolApprovalDecision, ToolApprovalPolicy, ToolApprovalPolicyContext, ToolApprovalPolicyDecision, ToolApprovalSurface, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/core/approvals/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/approvals/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,YAAY,EACV,gCAAgC,EAChC,uBAAuB,EACvB,8BAA8B,EAC9B,uBAAuB,EACvB,oBAAoB,EACpB,kBAAkB,EAClB,yBAAyB,EACzB,0BAA0B,EAC1B,mBAAmB,GACpB,MAAM,YAAY,CAAC"}

package/dist/src/core/approvals/index.js

@@ -0,0 +1,4 @@
+export { PendingToolApprovalRequests } from './pending-approval.js';
+export { ToolApprovalPolicies } from './policies.js';
+export { ToolApprovalService } from './service.js';
+//# sourceMappingURL=index.js.map

package/dist/src/core/approvals/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/approvals/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC"}