@duetso/agent 0.1.20

package/dist/src/turn-runner/turn-runner.d.ts

@@ -0,0 +1,160 @@
+import { Agent, type AgentEvent, type AgentTool } from "@earendil-works/pi-agent-core";
+import { type Usage } from "@earendil-works/pi-ai";
+import type { Skill } from "@earendil-works/pi-coding-agent";
+import type { SkillCollision } from "./skills.js";
+import { MemoryStore } from "../memory/store.js";
+import type { TurnRunnerConfig } from "../types/config.js";
+import type { TurnAgentFile, TurnAnswerCommand, TurnEditFollowUpQueueCommand, TurnEvent, TurnInterruptCommand, TurnMode, TurnPromptCommand, TurnState, TurnTokenUsage, TurnStartCommand, TurnTerminalEvent, TurnCommand } from "../types/protocol.js";
+import type { StateMachineAgentState } from "../types/state-machine.js";
+import { type TurnRunnerControlResult } from "./tools.js";
+import { SkillContext } from "./skill-context.js";
+import { type StateAgentHandle } from "./state-machine-controller.js";
+export type TurnEventHandler = (event: TurnEvent) => void;
+export interface AgentWorkerInput {
+    state: TurnState;
+    prompt: string;
+}
+export interface AgentConfigInput {
+    state: TurnState;
+    appendSystemPrompt?: string;
+    skills?: Skill[];
+    tools: AgentTool[];
+}
+export interface AgentWorkerResult {
+    terminal: TurnTerminalEvent;
+    control: TurnRunnerControlResult;
+}
+export declare class TurnRunner {
+    readonly config: TurnRunnerConfig;
+    private readonly eventHandlers;
+    /** In-memory observation store used by context transforms during agent turns. */
+    protected readonly memory: MemoryStore;
+    /** Stops memory persistence subscriptions/databases when the runner is disposed. */
+    private memoryDispose?;
+    /**
+     * Session-scoped parent pi agent. It is created once during start() so model,
+     * tools, and system prompt shape stay stable for prompt caching while the
+     * transcript grows across every pi-agent turn in this duet-agent session.
+     */
+    private parentAgent?;
+    /** True only while the parent pi agent is actively producing the public terminal event. */
+    private parentAgentRunning;
+    /** Last turn-runner control tool result observed from the parent agent. */
+    private parentControlResult;
+    /** Runtime owner for state-machine progress and active state work. */
+    private readonly stateMachineController;
+    /** Parent prompt started by a steer while state-machine work is driving the turn. */
+    private activeStateWorkPrompt?;
+    /** Terminal event prepared by `interrupt()` and returned when active work unwinds. */
+    private interruptedTerminal?;
+    /**
+     * Active work-chain promise. Callers may call turn() repeatedly while this is
+     * set; those commands are folded into the same duet-agent turn. A duet-agent
+     * turn may contain multiple parent pi-agent turns and multiple state-machine
+     * transitions, but it emits one public terminal event for the whole chain.
+     */
+    private activeTurnPromise?;
+    /** Latest runner-owned state, hydrated by start() and advanced by terminal events. */
+    private state?;
+    /** True after `start()` has emitted the initial `turn_started` event. */
+    private started;
+    /** Aggregates model usage across parent agents, state agents, and memory work for one turn chain. */
+    private turnUsage?;
+    /** Ensures persisted memory hydrates once before the first turn that needs it. */
+    private memoryLoaded;
+    protected readonly skillContext: SkillContext;
+    constructor(config: TurnRunnerConfig);
+    dispose(): Promise<void>;
+    subscribe(handler: TurnEventHandler): () => void;
+    editFollowUpQueue(command: TurnEditFollowUpQueueCommand): void;
+    /**
+     * Set up a session before any turn runs. Loads memory and skills, then
+     * emits `turn_started` with the initial state (a fresh state, or the
+     * resumed state when `command.state` is provided). No agent work runs.
+     *
+     * Callers (CLI/TUI/session managers) call this once on launch so the user
+     * sees available skills before typing the first prompt.
+     */
+    start(command: TurnStartCommand): Promise<TurnState>;
+    turn(command: TurnCommand): Promise<TurnTerminalEvent>;
+    private runTurnChain;
+    private executeTurnCommand;
+    private handleCommandDuringActiveTurn;
+    private sendCommandToAgent;
+    private startParentPromptDuringActiveStateWork;
+    private runParentPromptDuringActiveStateWork;
+    private drainQueuedTurnCommands;
+    private commandToUserMessage;
+    private enqueueTurnCommand;
+    private replaceFollowUpQueue;
+    private replaceQueuedFollowUpCommands;
+    private removeQueuedFollowUpCommands;
+    private isFollowUpQueueCommand;
+    private appendFollowUpPrompt;
+    private removeQueuedFollowUpPrompt;
+    private removeFollowUpPrompt;
+    private clearFollowUpQueue;
+    private emitFollowUpQueue;
+    interrupt(_command: TurnInterruptCommand): void;
+    protected emit(event: TurnEvent): void;
+    private consumeInterruptedTerminal;
+    protected prompt(command: TurnPromptCommand): Promise<TurnTerminalEvent>;
+    protected answer(command: TurnAnswerCommand): Promise<TurnTerminalEvent>;
+    protected wake(): Promise<TurnTerminalEvent>;
+    private restoreSleepAfterPromptIfNeeded;
+    private controllerResultToTerminal;
+    private driveStateMachineResult;
+    private selectNextStateAfterCompletion;
+    protected createStateAgentHandle(input: {
+        state: StateMachineAgentState;
+        prompt: string;
+    }): StateAgentHandle;
+    private requireRunnerState;
+    getState(): TurnState | undefined;
+    private snapshotState;
+    private setState;
+    private snapshotActiveAgentState;
+    private getFollowUpQueue;
+    private setFollowUpQueue;
+    private getQueuedCommands;
+    private setQueuedCommands;
+    private shiftQueuedCommand;
+    private getTodos;
+    private setTodos;
+    private requireStarted;
+    private requireParentAgent;
+    private initializeParentAgent;
+    protected runTurnRunnerAgentWithStateMachineTools(input: {
+        state: TurnState;
+        prompt: string;
+        mode: Exclude<TurnMode, "agent">;
+    }): Promise<TurnTerminalEvent>;
+    private controllerResultFromWorkerResult;
+    protected createTools(mode: TurnMode): {
+        tools: AgentTool[];
+    };
+    private replayFollowUpQueueIntoAgent;
+    protected runAgentMode(state: TurnState, prompt: string): Promise<TurnTerminalEvent>;
+    protected runAgentWorker(input: AgentWorkerInput): Promise<AgentWorkerResult>;
+    private setParentAgentRunning;
+    private runAgentWorkerWithUsage;
+    protected createAgent(input: AgentConfigInput, onControlResult?: (result: TurnRunnerControlResult) => void): Agent;
+    protected createMemoryTransform(model: string): (messages: import("@earendil-works/pi-agent-core").AgentMessage[], signal?: AbortSignal) => Promise<import("@earendil-works/pi-agent-core").AgentMessage[]>;
+    getSkills(): Promise<readonly Skill[]>;
+    /** System-prompt files (AGENTS.md by default) that resolved on disk for this session. */
+    getResolvedAgentFiles(): Promise<readonly TurnAgentFile[]>;
+    /** Skill name collisions where one definition shadowed another during discovery. */
+    getSkillCollisions(): Promise<readonly SkillCollision[]>;
+    getSkillInstructions(skillId: string): string;
+    private ensureSkillsLoaded;
+    private ensureMemoryLoaded;
+    protected createBaseSystemPromptWithAppendedLayers(input?: {
+        append?: Array<string | undefined>;
+        skills?: readonly Skill[];
+    }): string;
+    private askUserQuestion;
+    private resolveTurnOptions;
+    protected recordUsage(usage?: TurnTokenUsage | Usage): void;
+    protected emitAgentEvent(event: AgentEvent): void;
+}
+//# sourceMappingURL=turn-runner.d.ts.map

package/dist/src/turn-runner/turn-runner.d.ts.map

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