@roackb2/heddle 1.3.0 → 1.5.0

package/dist/src/core/agent/memory/memory-checkpoint-tracker.js

@@ -0,0 +1,92 @@
+/**
+ * Owns in-run memory checkpoint policy and trace events.
+ */
+export class AgentMemoryCheckpointTracker {
+    static createState(args) {
+        return {
+            required: args.toolNames.includes('memory_checkpoint') && AgentMemoryCheckpointTracker.hasExplicitMemoryIntent(args.goal),
+            completed: false,
+        };
+    }
+    static trackToolResult(args) {
+        AgentMemoryCheckpointTracker.trackCheckpointNeed(args.context, args.effectiveCall.tool);
+        AgentMemoryCheckpointTracker.recordMemoryCandidateEvent(args);
+        AgentMemoryCheckpointTracker.recordMemoryCheckpointSkippedEvent(args);
+    }
+    static buildReminder(context) {
+        if (context.state.memoryCheckpoint.required && !context.state.memoryCheckpoint.completed) {
+            context.log.info({ step: context.state.step }, 'Reminding agent to run memory checkpoint');
+            return 'Before your final answer, call memory_checkpoint exactly once. Use decision "record" if the user asked you to remember a durable preference/workflow/fact or this turn discovered stable reusable workspace knowledge. Use decision "skip" if there is nothing durable to preserve, the fact is speculative/temporary/duplicate, or it should not be stored.';
+        }
+        return undefined;
+    }
+    static recordMemoryCandidateEvent(args) {
+        const { context, effectiveCall, result } = args;
+        if (effectiveCall.tool !== 'record_knowledge' && effectiveCall.tool !== 'memory_checkpoint') {
+            return;
+        }
+        if (effectiveCall.tool === 'memory_checkpoint') {
+            context.state.memoryCheckpoint.completed = true;
+        }
+        const output = result.output;
+        if (!output || typeof output !== 'object' || Array.isArray(output)) {
+            return;
+        }
+        const candidateId = output.id;
+        const path = output.path;
+        if (typeof candidateId !== 'string' || typeof path !== 'string') {
+            return;
+        }
+        context.record({
+            type: 'memory.candidate_recorded',
+            candidateId,
+            path,
+            step: context.state.step,
+            timestamp: context.now(),
+        });
+    }
+    static recordMemoryCheckpointSkippedEvent(args) {
+        const { context, effectiveCall, result } = args;
+        if (effectiveCall.tool !== 'memory_checkpoint') {
+            return;
+        }
+        context.state.memoryCheckpoint.completed = true;
+        const output = result.output;
+        if (!output || typeof output !== 'object' || Array.isArray(output)) {
+            return;
+        }
+        const decision = output.decision;
+        const rationale = output.rationale;
+        if (decision !== 'skip' || typeof rationale !== 'string') {
+            return;
+        }
+        context.record({
+            type: 'memory.checkpoint_skipped',
+            rationale,
+            step: context.state.step,
+            timestamp: context.now(),
+        });
+    }
+    static trackCheckpointNeed(context, toolName) {
+        if (toolName === 'memory_checkpoint') {
+            return;
+        }
+        if (AgentMemoryCheckpointTracker.isMemoryOnlyTool(toolName)) {
+            return;
+        }
+        if (context.registry.get('memory_checkpoint')) {
+            context.state.memoryCheckpoint.required = true;
+        }
+    }
+    static hasExplicitMemoryIntent(goal) {
+        return /\b(?:remember|note down|keep in memory|use this going forward|going forward|preferred format|preference|don't forget|do not forget|preserve this|save this)\b/i.test(goal);
+    }
+    static isMemoryOnlyTool(tool) {
+        return tool === 'list_memory_notes'
+            || tool === 'read_memory_note'
+            || tool === 'search_memory_notes'
+            || tool === 'record_knowledge'
+            || tool === 'memory_checkpoint';
+    }
+}
+//# sourceMappingURL=memory-checkpoint-tracker.js.map

package/dist/src/core/agent/memory/memory-checkpoint-tracker.js.map

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

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

@@ -0,0 +1,13 @@
+import type { ToolCall, ToolResult } from '../../../core/types.js';
+import type { AgentRunContext, AgentMemoryCheckpointState } from '../types.js';
+export type CreateAgentMemoryCheckpointStateArgs = {
+    goal: string;
+    toolNames: string[];
+};
+export type TrackAgentMemoryToolResultArgs = {
+    context: AgentRunContext;
+    effectiveCall: ToolCall;
+    result: ToolResult;
+};
+export type { AgentMemoryCheckpointState };
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/core/agent/memory/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,KAAK,EAAE,eAAe,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAE/E,MAAM,MAAM,oCAAoC,GAAG;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG;IAC3C,OAAO,EAAE,eAAe,CAAC;IACzB,aAAa,EAAE,QAAQ,CAAC;IACxB,MAAM,EAAE,UAAU,CAAC;CACpB,CAAC;AAEF,YAAY,EAAE,0BAA0B,EAAE,CAAC"}

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

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

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

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

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

@@ -0,0 +1,3 @@
+export { AgentModelTurnService } from './model-turn-service.js';
+export type { AccumulateAgentUsageArgs, AgentModelTurnResult, RequestAgentModelTurnArgs, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/core/agent/model/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,YAAY,EACV,wBAAwB,EACxB,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,YAAY,CAAC"}

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

@@ -0,0 +1,2 @@
+export { AgentModelTurnService } from './model-turn-service.js';
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,12 @@
+import type { AgentModelTurnResult, RequestAgentModelTurnArgs } from './types.js';
+/**
+ * Owns one LLM request/stream step inside an agent run.
+ */
+export declare class AgentModelTurnService {
+    static request(args: RequestAgentModelTurnArgs): Promise<AgentModelTurnResult>;
+    private static handleStreamEvent;
+    private static accumulateUsage;
+    private static formatReasoningSummary;
+    private static stripReasoningSummaryMarkdown;
+}
+//# sourceMappingURL=model-turn-service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"model-turn-service.d.ts","sourceRoot":"","sources":["../../../../../src/core/agent/model/model-turn-service.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAA4B,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAE5G;;GAEG;AACH,qBAAa,qBAAqB;WACnB,OAAO,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAkCpF,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAkDhC,OAAO,CAAC,MAAM,CAAC,eAAe;IAuB9B,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAKrC,OAAO,CAAC,MAAM,CAAC,6BAA6B;CAM7C"}

package/dist/src/core/agent/model/model-turn-service.js

@@ -0,0 +1,103 @@
+import { isAbortError } from '../../../core/agent/utils/index.js';
+import { STREAM_UPDATE_INTERVAL_MS } from '../constants.js';
+import { AgentRunFinisher } from '../finish/index.js';
+/**
+ * Owns one LLM request/stream step inside an agent run.
+ */
+export class AgentModelTurnService {
+    static async request(args) {
+        const { context } = args;
+        if (context.abortSignal?.aborted) {
+            return AgentRunFinisher.finishInterrupted(context, 'Agent run interrupted before LLM call');
+        }
+        try {
+            const streamState = {
+                content: '',
+                reasoningSummary: '',
+                lastRecordAt: 0,
+            };
+            const response = await context.llm.chat(context.messages, context.registry.list(), context.abortSignal, (event) => AgentModelTurnService.handleStreamEvent({ context, event, streamState }));
+            context.state.usage = AgentModelTurnService.accumulateUsage({
+                current: context.state.usage,
+                next: response.usage,
+            });
+            return response;
+        }
+        catch (error) {
+            if (isAbortError(error) || context.abortSignal?.aborted || context.shouldStop?.()) {
+                return AgentRunFinisher.finishInterrupted(context, 'Agent run interrupted during LLM call');
+            }
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            context.log.error({ step: context.state.step, error: errorMessage }, 'LLM call failed');
+            return AgentRunFinisher.finish(context, 'error', `LLM error: ${errorMessage}`);
+        }
+    }
+    static handleStreamEvent(args) {
+        const { context, event, streamState } = args;
+        if (event.type === 'content.delta') {
+            const nowMs = Date.now();
+            streamState.content += event.delta;
+            if (nowMs - streamState.lastRecordAt >= STREAM_UPDATE_INTERVAL_MS) {
+                streamState.lastRecordAt = nowMs;
+            }
+            context.onAssistantStream?.({ step: context.state.step, text: streamState.content, done: false });
+            return;
+        }
+        if (event.type === 'content.done') {
+            streamState.content = event.content;
+            context.onAssistantStream?.({ step: context.state.step, text: streamState.content, done: true });
+            return;
+        }
+        if (event.type === 'reasoning_summary.delta') {
+            streamState.reasoningSummary += event.delta;
+            if (!streamState.content) {
+                context.onAssistantStream?.({
+                    step: context.state.step,
+                    text: AgentModelTurnService.formatReasoningSummary(streamState.reasoningSummary),
+                    done: false,
+                });
+            }
+            return;
+        }
+        if (event.type === 'reasoning_summary.done') {
+            streamState.reasoningSummary = event.text;
+            if (!streamState.content) {
+                context.onAssistantStream?.({
+                    step: context.state.step,
+                    text: AgentModelTurnService.formatReasoningSummary(streamState.reasoningSummary),
+                    done: false,
+                });
+            }
+        }
+    }
+    static accumulateUsage(args) {
+        if (!args.next) {
+            return args.current;
+        }
+        if (!args.current) {
+            return { ...args.next };
+        }
+        const cachedInputTokens = (args.current.cachedInputTokens ?? 0) + (args.next.cachedInputTokens ?? 0);
+        const reasoningTokens = (args.current.reasoningTokens ?? 0) + (args.next.reasoningTokens ?? 0);
+        const requests = (args.current.requests ?? 0) + (args.next.requests ?? 0);
+        return {
+            inputTokens: args.current.inputTokens + args.next.inputTokens,
+            outputTokens: args.current.outputTokens + args.next.outputTokens,
+            totalTokens: args.current.totalTokens + args.next.totalTokens,
+            cachedInputTokens: cachedInputTokens || undefined,
+            reasoningTokens: reasoningTokens || undefined,
+            requests: requests || undefined,
+        };
+    }
+    static formatReasoningSummary(text) {
+        const trimmed = AgentModelTurnService.stripReasoningSummaryMarkdown(text.trim());
+        return trimmed ? `Thinking: ${trimmed}` : 'Thinking...';
+    }
+    static stripReasoningSummaryMarkdown(text) {
+        return text
+            .replace(/\*\*([^*]+)\*\*/g, '$1')
+            .replace(/__([^_]+)__/g, '$1')
+            .replace(/([.!?])([A-Z][A-Za-z ]{2,}:?)/g, '$1 $2');
+    }
+}
+//# sourceMappingURL=model-turn-service.js.map

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

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

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

@@ -0,0 +1,12 @@
+import type { LlmResponse, LlmUsage } from '../../../core/llm/types.js';
+import type { RunResult } from '../../../core/types.js';
+import type { AgentRunContext } from '../types.js';
+export type RequestAgentModelTurnArgs = {
+    context: AgentRunContext;
+};
+export type AgentModelTurnResult = LlmResponse | RunResult;
+export type AccumulateAgentUsageArgs = {
+    current?: LlmUsage;
+    next?: LlmUsage;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/core/agent/model/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,MAAM,MAAM,yBAAyB,GAAG;IACtC,OAAO,EAAE,eAAe,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG,SAAS,CAAC;AAE3D,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,CAAC,EAAE,QAAQ,CAAC;IACnB,IAAI,CAAC,EAAE,QAAQ,CAAC;CACjB,CAAC"}

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

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

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

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

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

@@ -0,0 +1,3 @@
+export { AgentMutationTracker } from './mutation-tracker.js';
+export type { MutationState, TrackAgentMutationResultArgs } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/core/agent/mutation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,YAAY,EAAE,aAAa,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAC"}

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

@@ -0,0 +1,2 @@
+export { AgentMutationTracker } from './mutation-tracker.js';
+//# sourceMappingURL=index.js.map

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

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

package/dist/src/core/agent/mutation/mutation-tracker.d.ts

@@ -0,0 +1,20 @@
+import type { TrackAgentMutationResultArgs, MutationState } from './types.js';
+/**
+ * Tracks workspace-changing actions observed during a low-level agent run.
+ *
+ * The state is intentionally lightweight today; future review or verification
+ * requirements should extend this class instead of scattering mutation policy
+ * across the run loop.
+ */
+export declare class AgentMutationTracker {
+    static createState(): MutationState;
+    static trackToolResult(args: TrackAgentMutationResultArgs): void;
+    static isWorkspaceChangeMutateCommand(command: string): boolean;
+    static isVerificationMutateCommand(command: string): boolean;
+    static isRepoReviewCommand(command: string): boolean;
+    private static normalizeCommand;
+    private static includesFlag;
+    private static escapeRegExp;
+    private static describeEditMutation;
+}
+//# sourceMappingURL=mutation-tracker.d.ts.map

package/dist/src/core/agent/mutation/mutation-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutation-tracker.d.ts","sourceRoot":"","sources":["../../../../../src/core/agent/mutation/mutation-tracker.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,4BAA4B,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE9E;;;;;;GAMG;AACH,qBAAa,oBAAoB;IAC/B,MAAM,CAAC,WAAW,IAAI,aAAa;IAMnC,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE,4BAA4B,GAAG,IAAI;IAgBhE,MAAM,CAAC,8BAA8B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAqB/D,MAAM,CAAC,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAW5D,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IASpD,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAI/B,OAAO,CAAC,MAAM,CAAC,YAAY;IAK3B,OAAO,CAAC,MAAM,CAAC,YAAY;IAI3B,OAAO,CAAC,MAAM,CAAC,oBAAoB;CAQpC"}

package/dist/src/core/agent/mutation/mutation-tracker.js

@@ -0,0 +1,75 @@
+import { extractShellCommand } from '../../../core/agent/utils/index.js';
+/**
+ * Tracks workspace-changing actions observed during a low-level agent run.
+ *
+ * The state is intentionally lightweight today; future review or verification
+ * requirements should extend this class instead of scattering mutation policy
+ * across the run loop.
+ */
+export class AgentMutationTracker {
+    static createState() {
+        return {
+            executedMutationCommands: [],
+        };
+    }
+    static trackToolResult(args) {
+        if (!args.result.ok) {
+            return;
+        }
+        const command = extractShellCommand(args.effectiveCall.input);
+        if (args.effectiveCall.tool === 'run_shell_mutate' && command && AgentMutationTracker.isWorkspaceChangeMutateCommand(command)) {
+            args.state.executedMutationCommands.push(command);
+        }
+        if (args.effectiveCall.tool === 'edit_file') {
+            args.state.executedMutationCommands.push(AgentMutationTracker.describeEditMutation(args.effectiveCall.input));
+        }
+    }
+    static isWorkspaceChangeMutateCommand(command) {
+        return (/^yarn format\b/.test(command) ||
+            /^yarn prettier\b/.test(command) ||
+            /^yarn eslint\b/.test(command) ||
+            /^yarn add\b/.test(command) ||
+            /^yarn install\b/.test(command) ||
+            /^yarn remove\b/.test(command) ||
+            /^mkdir\b/.test(command) ||
+            /^touch\b/.test(command) ||
+            /^mv\b/.test(command) ||
+            /^cp\b/.test(command) ||
+            /^git add\b/.test(command) ||
+            /^git mv\b/.test(command) ||
+            /^npx prettier --write\b/.test(command) ||
+            /^npx eslint --fix\b/.test(command) ||
+            /^prettier --write\b/.test(command) ||
+            /^eslint --fix\b/.test(command));
+    }
+    static isVerificationMutateCommand(command) {
+        return (/^yarn test\b/.test(command) ||
+            /^yarn build\b/.test(command) ||
+            /^yarn lint\b/.test(command) ||
+            /^yarn vitest\b/.test(command) ||
+            /^vitest\b/.test(command) ||
+            /^tsc\b/.test(command));
+    }
+    static isRepoReviewCommand(command) {
+        const normalized = AgentMutationTracker.normalizeCommand(command);
+        return (normalized.startsWith('git status') && AgentMutationTracker.includesFlag(normalized, '--short')) || (normalized.startsWith('git diff') && AgentMutationTracker.includesFlag(normalized, '--stat'));
+    }
+    static normalizeCommand(command) {
+        return command.trim().replace(/\s+/g, ' ');
+    }
+    static includesFlag(command, flag) {
+        const pattern = new RegExp(`(?:^|\\s)${AgentMutationTracker.escapeRegExp(flag)}(?:=\\S+|\\s|$)`);
+        return pattern.test(command);
+    }
+    static escapeRegExp(value) {
+        return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    }
+    static describeEditMutation(input) {
+        if (!input || typeof input !== 'object' || Array.isArray(input)) {
+            return 'edit_file';
+        }
+        const path = input.path;
+        return typeof path === 'string' && path.trim() ? `edit_file ${path.trim()}` : 'edit_file';
+    }
+}
+//# sourceMappingURL=mutation-tracker.js.map

package/dist/src/core/agent/mutation/mutation-tracker.js.map

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

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

@@ -0,0 +1,13 @@
+import type { ToolCall } from '../../../core/types.js';
+export type MutationState = {
+    executedMutationCommands: string[];
+};
+export type TrackAgentMutationResultArgs = {
+    state: MutationState;
+    effectiveCall: ToolCall;
+    result: {
+        ok: boolean;
+        output?: unknown;
+    };
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/core/agent/mutation/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEhD,MAAM,MAAM,aAAa,GAAG;IAC1B,wBAAwB,EAAE,MAAM,EAAE,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,KAAK,EAAE,aAAa,CAAC;IACrB,aAAa,EAAE,QAAQ,CAAC;IACxB,MAAM,EAAE;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAC3C,CAAC"}

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

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

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