@wrongstack/core 0.284.0 → 0.285.0

package/dist/coordination/task-dag.d.ts

@@ -0,0 +1,147 @@
+/**
+ * TaskDAG — Directed Acyclic Graph of tasks with fork/join semantics.
+ *
+ * Replaces the Director's flat `awaitTasks()` with a proper dependency graph.
+ * Each task has explicit dependencies; the DAG resolves which tasks are
+ * runnable at any moment and manages blocking/unblocking as tasks complete.
+ *
+ * Key features:
+ * - Fork: one parent spawns multiple children that run in parallel
+ * - Join: a task can wait for multiple children before continuing
+ * - Dynamic: tasks can be added dynamically; the graph re-evaluates runnable set
+ * - Cycle detection: inserting a dependency that would create a cycle throws
+ * - Priority queue: within a "runnable" set, tasks are ordered by priority
+ * - Deadlock detection: if no tasks are runnable and no tasks are complete,
+ *   the DAG is in deadlock — agents are notified
+ *
+ * @module task-dag
+ */
+/** Represents a node in the DAG. */
+export interface DAGNode {
+    id: string;
+    description: string;
+    role?: string;
+    priority: number;
+    status: DAGNodeStatus;
+    deps: string[];
+    dependents: string[];
+    result?: unknown;
+    error?: string;
+    spawnedAt?: string;
+    completedAt?: string;
+    assignedTo?: string;
+    tags: string[];
+}
+export type DAGNodeStatus = 'pending' | 'ready' | 'running' | 'done' | 'failed' | 'skipped';
+/** Event emitted by the DAG on state changes. */
+export type DAGEdgeEvent = {
+    type: 'node:ready';
+    nodeId: string;
+    deps: string[];
+} | {
+    type: 'node:started';
+    nodeId: string;
+    assignedTo: string;
+} | {
+    type: 'node:completed';
+    nodeId: string;
+    result: unknown;
+    blockers: string[];
+} | {
+    type: 'node:failed';
+    nodeId: string;
+    error: string;
+    blockers: string[];
+} | {
+    type: 'node:skipped';
+    nodeId: string;
+    reason: string;
+} | {
+    type: 'deadlock';
+    blocked: string[];
+} | {
+    type: 'graph:done';
+    allDone: boolean;
+};
+export type DAGEdgeHandler = (event: DAGEdgeEvent) => void;
+/** Callback invoked when the DAG produces a set of runnable tasks. */
+export type RunnablesHandler = (nodes: DAGNode[]) => void;
+export declare class TaskDAG {
+    private readonly nodes;
+    private readonly handlers;
+    private readonly runnablesHandlers;
+    private runnableCache;
+    /**
+     * Add a task node. Dependencies are validated for cycles.
+     * Throws if adding a dep would create a cycle.
+     */
+    addNode(id: string, description: string, deps?: string[], opts?: {
+        role?: string;
+        priority?: number;
+        tags?: string[];
+    }): void;
+    /**
+     * Remove a node and all edges to/from it.
+     * Skips any dependents that would become dangling.
+     */
+    removeNode(id: string): void;
+    /**
+     * Mark a task as running. Returns true if the transition was valid
+     * (task was in 'ready' state), false otherwise.
+     */
+    start(id: string, assignedTo: string): boolean;
+    /**
+     * Mark a task as completed. Unblocks all dependents; they become 'ready'
+     * if all their deps are done.
+     */
+    complete(id: string, result: unknown): void;
+    /**
+     * Mark a task as failed. Unblocks dependents but they remain 'pending'
+     * (they may still be runnable if other deps succeeded).
+     */
+    fail(id: string, error: string): void;
+    /**
+     * Skip a task (e.g., it was deemed unnecessary by an earlier step).
+     * Treats it as done for dependency purposes.
+     */
+    skip(id: string, reason: string): void;
+    getNode(id: string): DAGNode | undefined;
+    getAll(): DAGNode[];
+    getReady(): DAGNode[];
+    getRunning(): DAGNode[];
+    getPending(): DAGNode[];
+    getDone(): DAGNode[];
+    getFailed(): DAGNode[];
+    getCompleted(): DAGNode[];
+    isDone(): boolean;
+    isFailed(): boolean;
+    /** All tasks that are currently blocked (pending but not ready). */
+    getBlocked(): DAGNode[];
+    /** Topological sort — tasks in dependency order. */
+    getTopologicalOrder(): DAGNode[];
+    /** Check for deadlock: no runnable tasks but not done. */
+    hasDeadlock(): boolean;
+    /** Stats snapshot for reporting. */
+    stats(): {
+        total: number;
+        pending: number;
+        ready: number;
+        running: number;
+        done: number;
+        failed: number;
+        skipped: number;
+        progress: number;
+    };
+    onEvent(handler: DAGEdgeHandler): () => void;
+    onRunnable(handler: RunnablesHandler): () => void;
+    private _transition;
+    private _emit;
+    private _emitReady;
+    private invalidateCache;
+    /**
+     * DFS cycle detection. Adding edge (id → dep) creates a cycle if
+     * there already exists a path from dep to id.
+     */
+    private _wouldCycle;
+}
+//# sourceMappingURL=task-dag.d.ts.map

package/dist/coordination/task-dag.d.ts.map

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

package/dist/coordination/techstack-mailbox-consumer.d.ts

@@ -0,0 +1,50 @@
+/**
+ * techstack-mailbox-consumer — Auto-spawns the tech-stack agent when
+ * dep-watcher messages land in the mailbox.
+ *
+ * This module runs a lightweight polling loop that checks the mailbox
+ * for unread `assign` messages directed at the `tech-stack` agent.
+ * When found, it invokes the provided `onSpawn` callback to spawn a
+ * tech-stack subagent, passing the manifest path as the task.
+ *
+ * The consumer also records file-author entries when it detects that
+ * a manifest was edited, so the tech-stack agent knows who to warn.
+ *
+ * @module techstack-mailbox-consumer
+ */
+import type { Mailbox } from './mailbox-types.js';
+import { type FileAuthorTrackerOptions } from './file-author-tracker.js';
+export interface TechStackConsumerOptions {
+    /** The mailbox to poll. */
+    mailbox: Mailbox;
+    /** Called when a tech-stack agent should be spawned. Receives the task description. */
+    onSpawn: (task: string, name: string) => Promise<{
+        subagentId: string;
+        taskId: string;
+    }>;
+    /** Agent id that the consumer watches for. Default: 'tech-stack'. */
+    targetAgent?: string | undefined;
+    /** Agent id that sends the completion ack. Default: 'tech-stack-consumer'. */
+    consumerAgentId?: string | undefined;
+    /** Polling interval in ms. Default: 5000. */
+    pollIntervalMs?: number | undefined;
+    /** File-author tracker config (for recording manifest edits). */
+    fileAuthorOpts?: FileAuthorTrackerOptions | undefined;
+    /** Current session id (for file-author entries). */
+    sessionId?: string | undefined;
+    /** Current agent id (for file-author entries). */
+    currentAgentId?: string | undefined;
+    /** Current agent name (for file-author entries). */
+    currentAgentName?: string | undefined;
+    /** Called on each poll cycle for logging. */
+    onLog?: ((msg: string) => void) | undefined;
+    /** Called when an error occurs. */
+    onError?: ((err: unknown) => void) | undefined;
+}
+/**
+ * Start the mailbox consumer loop.
+ *
+ * Returns a dispose function that stops polling and cleans up.
+ */
+export declare function startTechStackConsumer(opts: TechStackConsumerOptions): () => void;
+//# sourceMappingURL=techstack-mailbox-consumer.d.ts.map

package/dist/coordination/techstack-mailbox-consumer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"techstack-mailbox-consumer.d.ts","sourceRoot":"","sources":["../../src/coordination/techstack-mailbox-consumer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAkB,MAAM,oBAAoB,CAAC;AAElE,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,0BAA0B,CAAC;AAElC,MAAM,WAAW,wBAAwB;IACvC,2BAA2B;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,uFAAuF;IACvF,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzF,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,8EAA8E;IAC9E,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,6CAA6C;IAC7C,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,iEAAiE;IACjE,cAAc,CAAC,EAAE,wBAAwB,GAAG,SAAS,CAAC;IACtD,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,kDAAkD;IAClD,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,oDAAoD;IACpD,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,6CAA6C;IAC7C,KAAK,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAC5C,mCAAmC;IACnC,OAAO,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CAChD;AAQD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,wBAAwB,GAAG,MAAM,IAAI,CA6GjF"}

package/dist/coordination/transport.d.ts

@@ -0,0 +1,2 @@
+export { InMemoryBridgeTransport } from './in-memory-transport.js';
+//# sourceMappingURL=transport.d.ts.map

package/dist/coordination/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/coordination/transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/coordination/worktree-task-runner.d.ts

@@ -0,0 +1,45 @@
+import type { FleetConfig } from '../types/config.js';
+import type { SubagentConfig, SubagentRunner, TaskSpec } from '../types/multi-agent.js';
+import type { WorktreeManager } from '../worktree/worktree-manager.js';
+export type FleetWorktreePolicy = NonNullable<FleetConfig['worktrees']>;
+export type WorktreeIsolationDecision = 'off' | 'optional' | 'required';
+export interface WorktreeTaskStateUpdate {
+    taskId: string;
+    subagentId: string;
+    handleId: string;
+    dir: string;
+    branch: string;
+    baseBranch: string;
+    status: 'allocated' | 'fallback' | 'committed' | 'merged' | 'kept' | 'released' | 'conflict' | 'failed';
+    commitSha?: string | undefined;
+    conflictFiles?: string[] | undefined;
+    error?: string | undefined;
+}
+export interface WorktreeTaskRunnerOptions {
+    runner: SubagentRunner;
+    worktrees?: WorktreeManager | undefined;
+    policy?: FleetWorktreePolicy | undefined;
+    conflictResolver?: ((info: {
+        task: TaskSpec;
+        config: SubagentConfig;
+        conflictFiles: string[];
+        cwd: string;
+    }) => Promise<boolean>) | undefined;
+    onUpdate?: ((update: WorktreeTaskStateUpdate) => void) | undefined;
+}
+export declare class WorktreeIntegrationError extends Error {
+    readonly taskId: string;
+    readonly subagentId: string;
+    readonly branch?: string | undefined;
+    readonly conflictFiles?: string[] | undefined;
+    constructor(message: string, opts: {
+        taskId: string;
+        subagentId: string;
+        branch?: string | undefined;
+        conflictFiles?: string[] | undefined;
+    });
+}
+export declare function subagentNeedsWorktree(config: SubagentConfig): boolean;
+export declare function resolveSubagentWorktreeDecision(config: SubagentConfig, policy?: FleetWorktreePolicy | undefined): WorktreeIsolationDecision;
+export declare function wrapSubagentRunnerWithWorktrees(opts: WorktreeTaskRunnerOptions): SubagentRunner;
+//# sourceMappingURL=worktree-task-runner.d.ts.map

package/dist/coordination/worktree-task-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-task-runner.d.ts","sourceRoot":"","sources":["../../src/coordination/worktree-task-runner.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EACV,cAAc,EAEd,cAAc,EAEd,QAAQ,EACT,MAAM,yBAAyB,CAAC;AAEjC,OAAO,KAAK,EAAkB,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAEvF,MAAM,MAAM,mBAAmB,GAAG,WAAW,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC;AAExE,MAAM,MAAM,yBAAyB,GAAG,KAAK,GAAG,UAAU,GAAG,UAAU,CAAC;AAExE,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EACF,WAAW,GACX,UAAU,GACV,WAAW,GACX,QAAQ,GACR,MAAM,GACN,UAAU,GACV,UAAU,GACV,QAAQ,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACrC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;IACxC,MAAM,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;IACzC,gBAAgB,CAAC,EACb,CAAC,CAAC,IAAI,EAAE;QACN,IAAI,EAAE,QAAQ,CAAC;QACf,MAAM,EAAE,cAAc,CAAC;QACvB,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,GAAG,EAAE,MAAM,CAAC;KACb,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,GACvB,SAAS,CAAC;IACd,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,uBAAuB,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CACpE;AAED,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAE9C,YACE,OAAO,EAAE,MAAM,EACf,IAAI,EAAE;QACJ,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC5B,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;KACtC,EAQF;CACF;AA8BD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAKrE;AAED,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,cAAc,EACtB,MAAM,CAAC,EAAE,mBAAmB,GAAG,SAAS,GACvC,yBAAyB,CAQ3B;AAED,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,yBAAyB,GAAG,cAAc,CAwD/F"}

package/dist/core/agent-internals.d.ts

@@ -0,0 +1,41 @@
+import type { Context } from './context.js';
+import type { Container } from '../kernel/container.js';
+import type { EventBus } from '../kernel/events.js';
+import type { ExtensionRegistry } from '../extension/registry.js';
+import type { ToolRegistry } from '../registry/tool-registry.js';
+import type { ProviderRegistry } from '../registry/provider-registry.js';
+import type { Logger } from '../types/logger.js';
+import type { Renderer } from '../types/renderer.js';
+import type { RetryPolicy } from '../types/retry-policy.js';
+import type { ErrorHandler } from '../types/error-handler.js';
+import type { PermissionPolicy } from '../types/permission.js';
+import type { ToolExecutorLike } from '../types/tool-executor.js';
+import type { AgentPipelines, ResolvedLoopDetectionConfig } from './agent-types.js';
+/**
+ * Minimal interface exposing the Agent fields that the extracted
+ * loop / tool-execution / response modules need. Each extracted
+ * function takes this interface instead of the full Agent class,
+ * keeping coupling explicit and testable.
+ */
+export interface AgentInternals {
+    readonly container: Container;
+    readonly tools: ToolRegistry;
+    readonly providers: ProviderRegistry;
+    readonly events: EventBus;
+    readonly pipelines: AgentPipelines;
+    readonly ctx: Context;
+    readonly maxIterations: number;
+    readonly executionStrategy: 'parallel' | 'sequential' | 'smart';
+    readonly perIterationOutputCapBytes: number;
+    readonly autoExtendLimit: boolean;
+    readonly loopDetection: ResolvedLoopDetectionConfig;
+    readonly toolExecutor: ToolExecutorLike;
+    readonly extensions: ExtensionRegistry;
+    readonly logger: Logger;
+    readonly retry: RetryPolicy;
+    readonly errorHandler: ErrorHandler;
+    readonly permission: PermissionPolicy;
+    readonly renderer: Renderer | undefined;
+    readonly tracer: import('../types/observability.js').Tracer | undefined;
+}
+//# sourceMappingURL=agent-internals.d.ts.map

package/dist/core/agent-internals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-internals.d.ts","sourceRoot":"","sources":["../../src/core/agent-internals.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAEpF;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,EAAE,UAAU,GAAG,YAAY,GAAG,OAAO,CAAC;IAChE,QAAQ,CAAC,0BAA0B,EAAE,MAAM,CAAC;IAC5C,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,aAAa,EAAE,2BAA2B,CAAC;IACpD,QAAQ,CAAC,YAAY,EAAE,gBAAgB,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,OAAO,2BAA2B,EAAE,MAAM,GAAG,SAAS,CAAC;CACzE"}

package/dist/core/agent-loop.d.ts

@@ -0,0 +1,18 @@
+import type { RunController } from '../kernel/run-controller.js';
+import type { RunOptions } from './context.js';
+import type { RunResult, UserInputPayload } from './agent-types.js';
+import type { AgentInternals } from './agent-internals.js';
+import type { AgentToolHandler } from './agent-tools.js';
+import type { AgentResponseHandler } from './agent-response.js';
+/** Extract a human-readable reason from an AbortSignal. */
+export declare function signalAbortReason(signal: AbortSignal): string;
+interface LoopHandlers {
+    tools: AgentToolHandler;
+    response: AgentResponseHandler;
+}
+export interface AgentLoopHandler {
+    runInner(inputPayload: UserInputPayload, opts: RunOptions, controller: RunController, autonomousContinue: boolean): Promise<RunResult>;
+}
+export declare function createAgentLoopHandler(a: AgentInternals, handlers: LoopHandlers): AgentLoopHandler;
+export {};
+//# sourceMappingURL=agent-loop.d.ts.map

package/dist/core/agent-loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-loop.d.ts","sourceRoot":"","sources":["../../src/core/agent-loop.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAMhE,2DAA2D;AAC3D,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAK7D;AAED,UAAU,YAAY;IACpB,KAAK,EAAE,gBAAgB,CAAC;IACxB,QAAQ,EAAE,oBAAoB,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CACN,YAAY,EAAE,gBAAgB,EAC9B,IAAI,EAAE,UAAU,EAChB,UAAU,EAAE,aAAa,EACzB,kBAAkB,EAAE,OAAO,GAC1B,OAAO,CAAC,SAAS,CAAC,CAAC;CACvB;AAED,wBAAgB,sBAAsB,CACpC,CAAC,EAAE,cAAc,EACjB,QAAQ,EAAE,YAAY,GACrB,gBAAgB,CA64BlB"}

package/dist/core/agent-response.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Response processing handler — extracted from Agent class.
+ * Handles provider response pipeline, event emission, session
+ * persistence, text rendering, and autonomous continuation parsing.
+ */
+import type { Request, Response } from '../types/provider.js';
+import { type ContinueDirective } from './continue-to-next-iteration.js';
+import type { RunOptions } from './context.js';
+import type { AgentInternals } from './agent-internals.js';
+export interface ProcessResponseResult {
+    finalText: string;
+    aborted: boolean;
+    done: boolean;
+    directive?: ContinueDirective | undefined;
+}
+export interface AgentResponseHandler {
+    buildAndRunRequestPipeline(opts: RunOptions): Promise<Request>;
+    processResponse(raw: Response, req: Request): Promise<ProcessResponseResult>;
+}
+export declare function createAgentResponseHandler(a: AgentInternals): AgentResponseHandler;
+//# sourceMappingURL=agent-response.d.ts.map

package/dist/core/agent-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-response.d.ts","sourceRoot":"","sources":["../../src/core/agent-response.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAK9D,OAAO,EAA0B,KAAK,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACjG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;CAC3C;AAED,MAAM,WAAW,oBAAoB;IACnC,0BAA0B,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/D,eAAe,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;CAC9E;AAED,wBAAgB,0BAA0B,CAAC,CAAC,EAAE,cAAc,GAAG,oBAAoB,CA4IlF"}

package/dist/core/agent-tools.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Tool execution handler — extracted from Agent class for testability.
+ * Handles batch tool execution, confirmation flow, and post-execution
+ * pipeline/session/event emission.
+ */
+import type { ToolUseBlock, ToolResultBlock } from '../types/blocks.js';
+import type { Tool } from '../types/tool.js';
+import type { AgentInternals } from './agent-internals.js';
+export interface AgentToolHandler {
+    executeTools(toolUses: ToolUseBlock[]): Promise<ToolResultBlock[]>;
+    executeSingleWithDecision(tool: Tool, use: {
+        id: string;
+        name: string;
+        input: unknown;
+    }): Promise<{
+        result: ToolResultBlock;
+        durationMs: number;
+    }>;
+}
+export declare function createAgentToolHandler(a: AgentInternals): AgentToolHandler;
+//# sourceMappingURL=agent-tools.d.ts.map

package/dist/core/agent-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-tools.d.ts","sourceRoot":"","sources":["../../src/core/agent-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAK7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAc3D,MAAM,WAAW,gBAAgB;IAC/B,YAAY,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IACnE,yBAAyB,CACvB,IAAI,EAAE,IAAI,EACV,GAAG,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,GAChD,OAAO,CAAC;QAAE,MAAM,EAAE,eAAe,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC7D;AAED,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,cAAc,GAAG,gBAAgB,CAkR1E"}

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

@@ -0,0 +1,95 @@
+/**
+ * Agent type definitions — extracted from agent.ts to break circular
+ * dependencies and keep the Agent class focused on runtime logic.
+ */
+import { Pipeline } from '../kernel/pipeline.js';
+import type { ExtensionRegistry } from '../extension/registry.js';
+import type { Container } from '../kernel/container.js';
+import type { EventBus } from '../kernel/events.js';
+import type { ProviderRegistry } from '../registry/provider-registry.js';
+import type { ToolRegistry } from '../registry/tool-registry.js';
+import type { ContentBlock, TextBlock, ToolResultBlock, ToolUseBlock } from '../types/blocks.js';
+import type { WrongStackError } from '../types/errors.js';
+import type { Tracer } from '../types/observability.js';
+import type { PermissionPolicy } from '../types/permission.js';
+import type { LoopDetectionConfig } from '../types/config.js';
+import type { Request, Response } from '../types/provider.js';
+import type { Tool } from '../types/tool.js';
+import type { ToolExecutorLike } from '../types/tool-executor.js';
+import type { Context } from './context.js';
+/** Default iteration cap. Use 0 or Infinity via config to disable. */
+export declare const DEFAULT_MAX_ITERATIONS = 100;
+export interface RunResult {
+    status: 'done' | 'failed' | 'max_iterations' | 'aborted';
+    error?: WrongStackError | undefined;
+    finalText?: string | undefined;
+    iterations: number;
+    delegateSummaries?: Array<{
+        summary: string | undefined;
+        ok: boolean;
+    }>;
+    /** Human-readable reason for abort (e.g. "user interrupt", "tool timeout", "stream hang"). */
+    abortReason?: string | undefined;
+}
+export interface AgentInit {
+    container: Container;
+    tools: ToolRegistry;
+    providers: ProviderRegistry;
+    events: EventBus;
+    pipelines: AgentPipelines;
+    context: Context;
+    maxIterations?: number | undefined;
+    iterationTimeoutMs?: number | undefined;
+    executionStrategy?: 'parallel' | 'sequential' | 'smart' | undefined;
+    perIterationOutputCapBytes?: number | undefined;
+    autoExtendLimit?: boolean | undefined;
+    autonomousContinue?: boolean | undefined;
+    confirmAwaiter?: import('../types/tool-executor.js').ConfirmAwaiter | undefined;
+    permissionPolicy?: PermissionPolicy | undefined;
+    tracer?: Tracer | undefined;
+    extensions?: ExtensionRegistry | undefined;
+    toolExecutor: ToolExecutorLike;
+    /** Loop-detector tuning (`tools.loopDetection`). Omitted fields use defaults. */
+    loopDetection?: LoopDetectionConfig | undefined;
+}
+/** Fully-resolved loop-detector settings (defaults applied, bounds clamped). */
+export interface ResolvedLoopDetectionConfig {
+    mode: 'steer-then-cut' | 'cut' | 'off';
+    steerThreshold: number;
+    cutThreshold: number;
+    windowSize: number;
+    callRepeatThreshold: number;
+}
+/**
+ * Apply defaults and sanity bounds to a (possibly partial) loop-detection
+ * config. Clamping keeps a bad config from disabling the safety valve by
+ * accident: the cut threshold always sits strictly above the steer
+ * threshold so 'steer-then-cut' can never cut before it has steered.
+ */
+export declare function resolveLoopDetection(cfg?: LoopDetectionConfig): ResolvedLoopDetectionConfig;
+export interface AgentPipelines {
+    request: Pipeline<Request>;
+    response: Pipeline<Response>;
+    toolCall: Pipeline<ToolCallPipelinePayload>;
+    userInput: Pipeline<UserInputPayload>;
+    assistantOutput: Pipeline<TextBlock>;
+    contextWindow: Pipeline<Context>;
+}
+export interface UserInputPayload {
+    content: ContentBlock[];
+    text: string;
+    ctx: Context;
+}
+export type AgentInput = string | ContentBlock[];
+export declare function normalizeInput(input: AgentInput): {
+    blocks: ContentBlock[];
+    text: string;
+};
+export interface ToolCallPipelinePayload {
+    toolUse: ToolUseBlock;
+    result: ToolResultBlock;
+    ctx: Context;
+    tool?: Tool | undefined;
+}
+export declare function createDefaultPipelines(): AgentPipelines;
+//# sourceMappingURL=agent-types.d.ts.map

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

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

package/dist/core/agent.d.ts

@@ -0,0 +1,54 @@
+import { ExtensionRegistry } from '../extension/registry.js';
+import type { Container } from '../kernel/container.js';
+import type { EventBus } from '../kernel/events.js';
+import type { ProviderRegistry } from '../registry/provider-registry.js';
+import type { ToolRegistry } from '../registry/tool-registry.js';
+import type { ErrorHandler } from '../types/error-handler.js';
+import type { Logger } from '../types/logger.js';
+import type { Tracer } from '../types/observability.js';
+import type { PermissionPolicy } from '../types/permission.js';
+import type { Plugin, PluginAPI } from '../types/plugin.js';
+import type { Renderer } from '../types/renderer.js';
+import type { RetryPolicy } from '../types/retry-policy.js';
+import type { Tool } from '../types/tool.js';
+import type { ToolExecutorLike } from '../types/tool-executor.js';
+import { type ResolvedLoopDetectionConfig, type RunResult, type AgentInit, type AgentPipelines, type AgentInput } from './agent-types.js';
+import type { Context, RunOptions } from './context.js';
+export { DEFAULT_MAX_ITERATIONS, normalizeInput, createDefaultPipelines, resolveLoopDetection, type ResolvedLoopDetectionConfig, type RunResult, type AgentInit, type AgentPipelines, type UserInputPayload, type AgentInput, type ToolCallPipelinePayload, } from './agent-types.js';
+export declare class Agent {
+    readonly container: Container;
+    readonly tools: ToolRegistry;
+    readonly providers: ProviderRegistry;
+    readonly events: EventBus;
+    readonly pipelines: AgentPipelines;
+    readonly ctx: Context;
+    /** Max agent-loop iterations per run. Mutable so the TUI `/settings` picker
+     *  can apply a new value to the live session (takes effect next run). */
+    maxIterations: number;
+    readonly executionStrategy: 'parallel' | 'sequential' | 'smart';
+    readonly perIterationOutputCapBytes: number;
+    private readonly plugins;
+    readonly toolExecutor: ToolExecutorLike;
+    readonly autoExtendLimit: boolean;
+    /** Resolved loop-detector settings (see `tools.loopDetection`). */
+    readonly loopDetection: ResolvedLoopDetectionConfig;
+    private readonly autonomousContinue;
+    readonly tracer: Tracer | undefined;
+    readonly extensions: ExtensionRegistry;
+    private readonly _toolHandler;
+    private readonly _responseHandler;
+    private readonly _loopHandler;
+    private readonly _logger;
+    constructor(init: AgentInit);
+    get logger(): Logger;
+    get retry(): RetryPolicy;
+    get errorHandler(): ErrorHandler;
+    get permission(): PermissionPolicy;
+    get renderer(): Renderer | undefined;
+    disableInteractiveConfirmation(): void;
+    register(tool: Tool): void;
+    use(plugin: Plugin, api: PluginAPI): Promise<void>;
+    teardown(): Promise<void>;
+    run(userInput: AgentInput, opts?: RunOptions): Promise<RunResult>;
+}
+//# sourceMappingURL=agent.d.ts.map

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

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

package/dist/core/btw.d.ts

@@ -0,0 +1,40 @@
+/**
+ * `/btw` — non-aborting mid-run steering ("by the way").
+ *
+ * Unlike `/steer` (which aborts the current iteration and prepends a heavy
+ * STEERING preamble), `/btw` stashes a short note on the live `Context` and
+ * lets the agent pick it up at the NEXT iteration boundary — between tool
+ * batches — without tearing down in-flight work.
+ *
+ * Flow:
+ *  1. The `/btw <text>` slash command calls `setBtwNote(ctx, text)` on the
+ *     live run context. Multiple notes accumulate in order.
+ *  2. At the top of each agent iteration (before the request is built),
+ *     `Agent` drains the queue via `consumeBtwNotes(ctx)` and folds the
+ *     notes into the conversation as a user-visible block.
+ *
+ * The notes live in `ctx.meta` so the slash command and the agent loop share
+ * one source of truth, the same way `_autonomousContinue` is plumbed in
+ * {@link ./continue-to-next-iteration.ts}.
+ */
+import type { Context } from './context.js';
+/**
+ * Stash a "by the way" note on the context. The agent surfaces it at the
+ * start of its next iteration. Blank notes are ignored. Returns the number
+ * of notes now pending.
+ */
+export declare function setBtwNote(ctx: Context, text: string): number;
+/** Number of notes currently waiting to be delivered. */
+export declare function pendingBtwCount(ctx: Context): number;
+/**
+ * Read and clear all pending notes in one call. Returns them in the order
+ * they were added (empty array when none).
+ */
+export declare function consumeBtwNotes(ctx: Context): string[];
+/**
+ * Format pending notes as the text the agent reads. Kept deliberately light
+ * (no "I interrupted you" framing) so the model folds the note into its
+ * current work rather than restarting.
+ */
+export declare function buildBtwBlock(notes: string[]): string;
+//# sourceMappingURL=btw.d.ts.map

package/dist/core/btw.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"btw.d.ts","sourceRoot":"","sources":["../../src/core/btw.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAa5C;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAM7D;AAED,yDAAyD;AACzD,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAEpD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,EAAE,CAItD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAUrD"}