@duetso/agent 0.1.20

package/dist/src/turn-runner/state-machine-session.js

@@ -0,0 +1,189 @@
+import { INTERRUPTED_STATE_MACHINE_STATE as INTERRUPTED_STATE } from "../types/state-machine.js";
+export function createStateMachineSession(prompt, definition, currentState) {
+    const now = Date.now();
+    return {
+        definition,
+        prompt,
+        currentState,
+        history: [{ type: "state_machine_started", timestamp: now }],
+        createdAt: now,
+        updatedAt: now,
+    };
+}
+export function findState(stateMachine, name) {
+    return stateMachine.definition.states.find((state) => state.name === name);
+}
+export function currentScheduledState(stateMachine) {
+    const currentState = stateMachine?.currentState;
+    if (!stateMachine || !currentState)
+        return undefined;
+    const definitionState = findState(stateMachine, currentState);
+    return definitionState?.kind === "poll" || definitionState?.kind === "timer"
+        ? definitionState
+        : undefined;
+}
+export function isWaitingOnScheduledState(stateMachine) {
+    return Boolean(currentScheduledState(stateMachine) && !stateMachine?.terminal);
+}
+export function recordRunnerDecision(stateMachine, decision) {
+    return {
+        ...stateMachine,
+        history: [...stateMachine.history, { type: "runner_decided", timestamp: Date.now(), decision }],
+        updatedAt: Date.now(),
+    };
+}
+export function recordStateStarted(stateMachine, state, input) {
+    const now = Date.now();
+    const stateMachineWithoutScheduledWake = {
+        ...stateMachine,
+        progress: clearProgressWakeTimes(stateMachine.progress),
+    };
+    return {
+        ...stateMachine,
+        currentState: state.name,
+        currentInput: input,
+        progress: updateStateProgress(stateMachineWithoutScheduledWake, state.name, state.kind, (entry) => ({
+            ...entry,
+            runs: entry.runs + 1,
+        })),
+        history: [
+            ...stateMachine.history,
+            {
+                type: "state_started",
+                timestamp: now,
+                state: state.name,
+                input,
+            },
+        ],
+        updatedAt: now,
+    };
+}
+export function recordStateCompleted(stateMachine, state, output) {
+    const now = Date.now();
+    const kind = findState(stateMachine, state)?.kind;
+    return {
+        ...stateMachine,
+        progress: updateStateProgress(stateMachine, state, kind, (entry) => ({
+            ...entry,
+            nextWakeAt: undefined,
+        })),
+        history: [...stateMachine.history, { type: "state_completed", timestamp: now, state, output }],
+        updatedAt: now,
+    };
+}
+export function recordStateSleep(stateMachine, state, wakeAt) {
+    const now = Date.now();
+    return {
+        ...stateMachine,
+        progress: updateStateProgress(stateMachine, state.name, state.kind, (entry) => ({
+            ...entry,
+            sleeps: entry.sleeps + 1,
+            nextWakeAt: wakeAt,
+        })),
+        updatedAt: now,
+    };
+}
+export function elapsedSinceStateStarted(stateMachine, state) {
+    const history = stateMachine?.history ?? [];
+    for (let index = history.length - 1; index >= 0; index--) {
+        const event = history[index];
+        if (event.type === "state_started" && event.state === state) {
+            return Math.max(0, Date.now() - event.timestamp);
+        }
+    }
+    return 0;
+}
+export function recordStateFailed(stateMachine, state, error) {
+    const now = Date.now();
+    const terminal = { state, status: "failed", reason: error };
+    const kind = findState(stateMachine, state)?.kind;
+    return {
+        ...stateMachine,
+        terminal,
+        progress: updateStateProgress(stateMachine, state, kind, (entry) => ({
+            ...entry,
+            nextWakeAt: undefined,
+        })),
+        history: [
+            ...stateMachine.history,
+            { type: "state_failed", timestamp: now, state, error },
+            { type: "state_machine_completed", timestamp: now, terminal },
+        ],
+        updatedAt: now,
+    };
+}
+export function recordStateInterrupted(stateMachine, state, reason, output) {
+    const now = Date.now();
+    const kind = findState(stateMachine, state)?.kind;
+    return {
+        ...stateMachine,
+        currentState: INTERRUPTED_STATE,
+        currentInput: undefined,
+        progress: updateStateProgress(stateMachine, state, kind, (entry) => ({
+            ...entry,
+            nextWakeAt: undefined,
+        })),
+        history: [
+            ...stateMachine.history,
+            {
+                type: "state_interrupted",
+                timestamp: now,
+                state,
+                reason,
+                output,
+            },
+        ],
+        updatedAt: now,
+    };
+}
+export function recordStateAskedUser(stateMachine, state, questions) {
+    const now = Date.now();
+    return {
+        ...stateMachine,
+        history: [
+            ...stateMachine.history,
+            { type: "state_asked_user", timestamp: now, state, questions },
+        ],
+        updatedAt: now,
+    };
+}
+export function recordStateMachineCompleted(stateMachine, terminal) {
+    const now = Date.now();
+    return {
+        ...stateMachine,
+        terminal,
+        history: [
+            ...stateMachine.history,
+            { type: "state_machine_completed", timestamp: now, terminal },
+        ],
+        updatedAt: now,
+    };
+}
+function updateStateProgress(stateMachine, state, kind, update) {
+    const states = stateMachine.progress?.states ?? {};
+    const current = normalizeStateProgress(states[state], kind);
+    return {
+        states: {
+            ...states,
+            [state]: update(current),
+        },
+    };
+}
+function normalizeStateProgress(entry, kind) {
+    return {
+        kind: entry?.kind ?? kind,
+        runs: entry?.runs ?? 0,
+        sleeps: entry?.sleeps ?? 0,
+        nextWakeAt: entry?.nextWakeAt,
+    };
+}
+function clearProgressWakeTimes(progress) {
+    if (!progress)
+        return undefined;
+    const states = {};
+    for (const [state, entry] of Object.entries(progress.states)) {
+        states[state] = { ...entry, nextWakeAt: undefined };
+    }
+    return { states };
+}
+//# sourceMappingURL=state-machine-session.js.map

package/dist/src/turn-runner/state-machine-session.js.map

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

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

@@ -0,0 +1,193 @@
+import type { AgentTool } from "@earendil-works/pi-agent-core";
+import { type Skill } from "@earendil-works/pi-coding-agent";
+import { Type, type Static } from "typebox";
+import type { TurnMode, TurnQuestion, TurnTodo } from "../types/protocol.js";
+import type { StateMachineSession, StateMachineSessionEvent, StateMachineAgentState, StateMachineDefinition, StateMachinePollState, StateMachineProgress, StateMachineScriptState, StateMachineState, StateMachineTimerState, StateMachineTerminalResult } from "../types/state-machine.js";
+import type { ActiveStateOutput } from "./state-machine-controller.js";
+declare const askUserQuestionSchema: Type.TObject<{
+    questions: Type.TArray<Type.TObject<{
+        question: Type.TString;
+        header: Type.TOptional<Type.TString>;
+        options: Type.TArray<Type.TObject<{
+            label: Type.TString;
+            description: Type.TOptional<Type.TString>;
+        }>>;
+        multiSelect: Type.TOptional<Type.TBoolean>;
+    }>>;
+}>;
+type AskUserQuestionParams = Static<typeof askUserQuestionSchema>;
+declare const todoWriteSchema: Type.TObject<{
+    merge: Type.TBoolean;
+    todos: Type.TArray<Type.TObject<{
+        id: Type.TString;
+        content: Type.TString;
+        status: Type.TUnion<[Type.TLiteral<"pending">, Type.TLiteral<"in_progress">, Type.TLiteral<"completed">, Type.TLiteral<"failed">]>;
+    }>>;
+}>;
+export interface TodoWriteToolStorage {
+    getTodos(): TurnTodo[];
+    setTodos(todos: TurnTodo[]): void;
+}
+export type StateMachineAgentStateOverride = Partial<Pick<StateMachineAgentState, "prompt" | "systemPrompt" | "allowedSkills" | "inputSchema">>;
+export type StateMachineScriptStateOverride = Partial<Pick<StateMachineScriptState, "command" | "cwd" | "timeoutMs" | "successCodes" | "inputSchema">>;
+export type StateMachinePollStateOverride = Partial<Pick<StateMachinePollState, "intervalMs" | "timeoutMs" | "command" | "cwd" | "successCodes" | "inputSchema">>;
+export type StateMachineTimerStateOverride = Partial<Pick<StateMachineTimerState, "wakeAt" | "inputSchema">>;
+export type StateMachineStateOverride = {
+    kind: "agent";
+    state: StateMachineAgentStateOverride;
+} | {
+    kind: "script";
+    state: StateMachineScriptStateOverride;
+} | {
+    kind: "poll";
+    state: StateMachinePollStateOverride;
+} | {
+    kind: "timer";
+    state: StateMachineTimerStateOverride;
+};
+declare const createDefinitionSchema: Type.TObject<{
+    definition: Type.TObject<{
+        name: Type.TString;
+        prompt: Type.TString;
+        states: Type.TArray<Type.TUnion<[Type.TObject<{
+            kind: Type.TLiteral<"agent">;
+            prompt: Type.TString;
+            systemPrompt: Type.TOptional<Type.TString>;
+            allowedSkills: Type.TOptional<Type.TArray<Type.TString>>;
+            name: Type.TString;
+            when: Type.TOptional<Type.TString>;
+            inputSchema: Type.TOptional<Type.TRecord<"^.*$", Type.TAny>>;
+        }>, Type.TObject<{
+            kind: Type.TLiteral<"script">;
+            command: Type.TString;
+            cwd: Type.TOptional<Type.TString>;
+            timeoutMs: Type.TOptional<Type.TNumber>;
+            successCodes: Type.TOptional<Type.TArray<Type.TNumber>>;
+            name: Type.TString;
+            when: Type.TOptional<Type.TString>;
+            inputSchema: Type.TOptional<Type.TRecord<"^.*$", Type.TAny>>;
+        }>, Type.TObject<{
+            kind: Type.TLiteral<"poll">;
+            intervalMs: Type.TNumber;
+            timeoutMs: Type.TOptional<Type.TNumber>;
+            command: Type.TString;
+            cwd: Type.TOptional<Type.TString>;
+            successCodes: Type.TOptional<Type.TArray<Type.TNumber>>;
+            name: Type.TString;
+            when: Type.TOptional<Type.TString>;
+            inputSchema: Type.TOptional<Type.TRecord<"^.*$", Type.TAny>>;
+        }>, Type.TObject<{
+            kind: Type.TLiteral<"timer">;
+            wakeAt: Type.TNumber;
+            name: Type.TString;
+            when: Type.TOptional<Type.TString>;
+            inputSchema: Type.TOptional<Type.TRecord<"^.*$", Type.TAny>>;
+        }>, Type.TObject<{
+            kind: Type.TLiteral<"terminal">;
+            status: Type.TUnion<[Type.TLiteral<"completed">, Type.TLiteral<"failed">, Type.TLiteral<"cancelled">]>;
+            reason: Type.TOptional<Type.TString>;
+            name: Type.TString;
+            when: Type.TOptional<Type.TString>;
+            inputSchema: Type.TOptional<Type.TRecord<"^.*$", Type.TAny>>;
+        }>]>>;
+    }>;
+    firstState: Type.TOptional<Type.TString>;
+}>;
+type CreateDefinitionParams = Static<typeof createDefinitionSchema>;
+type ToolStateMachineDefinition = CreateDefinitionParams["definition"];
+declare const selectStateSchema: Type.TObject<{
+    decision: Type.TObject<{
+        kind: Type.TUnion<[Type.TLiteral<"run_state">, Type.TLiteral<"terminal">, Type.TLiteral<"fail">]>;
+        state: Type.TOptional<Type.TString>;
+        reason: Type.TOptional<Type.TString>;
+        override: Type.TOptional<Type.TUnion<[Type.TObject<{
+            kind: Type.TLiteral<"agent">;
+            state: Type.TObject<{
+                prompt: Type.TOptional<Type.TString>;
+                systemPrompt: Type.TOptional<Type.TString>;
+                allowedSkills: Type.TOptional<Type.TArray<Type.TString>>;
+                inputSchema: Type.TOptional<Type.TRecord<"^.*$", Type.TAny>>;
+            }>;
+        }>, Type.TObject<{
+            kind: Type.TLiteral<"script">;
+            state: Type.TObject<{
+                command: Type.TOptional<Type.TString>;
+                cwd: Type.TOptional<Type.TString>;
+                timeoutMs: Type.TOptional<Type.TNumber>;
+                successCodes: Type.TOptional<Type.TArray<Type.TNumber>>;
+                inputSchema: Type.TOptional<Type.TRecord<"^.*$", Type.TAny>>;
+            }>;
+        }>, Type.TObject<{
+            kind: Type.TLiteral<"poll">;
+            state: Type.TObject<{
+                intervalMs: Type.TOptional<Type.TNumber>;
+                timeoutMs: Type.TOptional<Type.TNumber>;
+                command: Type.TOptional<Type.TString>;
+                cwd: Type.TOptional<Type.TString>;
+                successCodes: Type.TOptional<Type.TArray<Type.TNumber>>;
+                inputSchema: Type.TOptional<Type.TRecord<"^.*$", Type.TAny>>;
+            }>;
+        }>, Type.TObject<{
+            kind: Type.TLiteral<"timer">;
+            state: Type.TObject<{
+                wakeAt: Type.TOptional<Type.TNumber>;
+                inputSchema: Type.TOptional<Type.TRecord<"^.*$", Type.TAny>>;
+            }>;
+        }>]>>;
+        input: Type.TOptional<Type.TRecord<"^.*$", Type.TAny>>;
+    }>;
+}>;
+type SelectStateParams = Static<typeof selectStateSchema>;
+type ToolRunnerDecision = SelectStateParams["decision"];
+export interface CurrentStateMachineStateResult {
+    currentState?: string;
+    currentInput?: Record<string, unknown>;
+    terminal?: StateMachineTerminalResult;
+    /** Compact per-state counters for obvious progress questions. */
+    progress?: StateMachineProgress;
+    /** Total state-machine history records; `history` below is only the recent tail. */
+    historyCount: number;
+    /** Transient output from the currently running state, if one is active. */
+    activeOutput?: ActiveStateOutput;
+    history: StateMachineSessionEvent[];
+}
+export type StateMachineRunnerDecision = (ToolRunnerDecision & {
+    kind: "run_state";
+    state: string;
+    override?: StateMachineStateOverride;
+    input?: Record<string, unknown>;
+}) | (ToolRunnerDecision & {
+    kind: "terminal";
+    state: string;
+}) | (ToolRunnerDecision & {
+    kind: "fail";
+    reason: string;
+});
+export type TurnRunnerControlResult = {
+    type: "none";
+} | ({
+    type: "ask_user_question";
+    questions: TurnQuestion[];
+} & AskUserQuestionParams) | ({
+    type: "create_state_machine_definition";
+    definition: ToolStateMachineDefinition;
+} & Pick<CreateDefinitionParams, "firstState">) | {
+    type: "select_state_machine_state";
+    decision: StateMachineRunnerDecision;
+};
+export declare function isTurnRunnerControlResult(value: unknown): value is TurnRunnerControlResult;
+interface TurnRunnerToolsInput {
+    cwd: string;
+    mode: TurnMode;
+    todoStorage: TodoWriteToolStorage;
+    getDefinition?: () => StateMachineDefinition | undefined;
+    getStateMachine?: () => StateMachineSession | undefined;
+    getActiveStateOutput?: () => ActiveStateOutput | undefined;
+    skills?: readonly Skill[];
+}
+export declare function createDefaultTurnRunnerTools(cwd: string, todoStorage: TodoWriteToolStorage, skills?: readonly Skill[]): AgentTool[];
+export declare function createTurnRunnerTools(input: TurnRunnerToolsInput): AgentTool[];
+export declare function applyStateOverride(state: StateMachineState, override: StateMachineStateOverride | undefined): StateMachineState;
+export declare function createTodoWriteTool(storage: TodoWriteToolStorage): AgentTool<typeof todoWriteSchema>;
+export {};
+//# sourceMappingURL=tools.d.ts.map

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

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