@duetso/agent 0.2.2 → 0.2.4

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

@@ -43,14 +43,16 @@ export declare const COMPACT_MESSAGE_TOKENS_RATIO = 0.2;
  * leading `toolResult` or `assistant` message until the head is `user` — the
  * only role every provider accepts at position 0.
  *
- * Front-eviction preserves tool-call / tool-result pairing by construction:
- * tool results always follow their assistant call in source order, so
- * dropping an assistant naturally drops its trailing results through the
- * head-fix loop.
+ * Front-eviction preserves tool-call / tool-result pairing by construction.
+ * When a result carries a live task id, both sides of that pair are pinned:
+ * the full invalid-head cascade is inspected before removal, and compaction
+ * stops at the preceding valid boundary rather than split or evict the pair.
+ * `TurnState.tasks` remains authoritative if no transcript pair can be found.
  *
  * Preserves the original state reference (no mutation) and every non-message
  * field on `TurnState` and `state.agent` (`status`, `mode`, `options`,
- * `stateMachine`, `todos`, `followUpQueue`, `queuedCommands`).
+ * `stateMachine`, `todos`, `followUpQueue`, `queuedCommands`, `tasks`, and
+ * `nextTaskId`).
  *
  * Stops once `messages.length <= MIN_RETAINED_MESSAGES`. If the remainder
  * still exceeds `maxBytes`, the caller persists/emits the oversize state: a

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

@@ -1 +1 @@
-{"version":3,"file":"state-compaction.d.ts","sourceRoot":"","sources":["../../../src/turn-runner/state-compaction.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEtD;;;;;;;;;GASG;AACH,eAAO,MAAM,uBAAuB,QAAoB,CAAC;AAEzD;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAEvC,MAAM,WAAW,0BAA0B;IACzC,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,SAAS,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,4BAA4B,MAAM,CAAC;AAahD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,EAChB,OAAO,GAAE,0BAA+B,GACvC,gBAAgB,CA8BlB"}
+{"version":3,"file":"state-compaction.d.ts","sourceRoot":"","sources":["../../../src/turn-runner/state-compaction.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEtD;;;;;;;;;GASG;AACH,eAAO,MAAM,uBAAuB,QAAoB,CAAC;AAEzD;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAEvC,MAAM,WAAW,0BAA0B;IACzC,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,SAAS,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,4BAA4B,MAAM,CAAC;AAwEhD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,EAChB,OAAO,GAAE,0BAA+B,GACvC,gBAAgB,CAoClB"}

package/dist/src/turn-runner/state-compaction.js

@@ -37,20 +37,74 @@ function isInvalidHead(message) {
         return false;
     return message.role === "toolResult" || message.role === "assistant";
 }
+function taskIdsReferencedBy(message) {
+    return new Set(JSON.stringify(message).match(/\bt\d+\b/g) ?? []);
+}
+function toolCallIds(message) {
+    if (!("role" in message) || message.role !== "assistant" || !("content" in message)) {
+        return new Set();
+    }
+    const content = Array.isArray(message.content) ? message.content : [];
+    return new Set(content.flatMap((block) => {
+        if (!block || typeof block !== "object" || !("type" in block) || block.type !== "toolCall") {
+            return [];
+        }
+        const candidate = block;
+        const id = candidate.id ?? candidate.toolCallId;
+        return typeof id === "string" ? [id] : [];
+    }));
+}
+/**
+ * Find both messages in every tool-call/result pair whose result carries a
+ * live task id. A result can be separated from its assistant call by sibling
+ * results, so match the structural tool-call id rather than adjacency.
+ */
+function findLiveTaskPairMessages(state, messages) {
+    const liveTaskIds = new Set((state.tasks ?? [])
+        .filter(({ status }) => status === "running" || status === "scheduled")
+        .map(({ id }) => id));
+    const pinned = new Set();
+    if (liveTaskIds.size === 0)
+        return pinned;
+    for (let resultIndex = 0; resultIndex < messages.length; resultIndex += 1) {
+        const result = messages[resultIndex];
+        if (!result || !("role" in result) || result.role !== "toolResult")
+            continue;
+        const referencesLiveTask = [...taskIdsReferencedBy(result)].some((id) => liveTaskIds.has(id));
+        if (!referencesLiveTask)
+            continue;
+        const resultCallId = "toolCallId" in result ? result.toolCallId : undefined;
+        if (typeof resultCallId !== "string")
+            continue;
+        for (let callIndex = resultIndex - 1; callIndex >= 0; callIndex -= 1) {
+            const call = messages[callIndex];
+            if (!call)
+                continue;
+            if (toolCallIds(call).has(resultCallId)) {
+                pinned.add(call);
+                pinned.add(result);
+                break;
+            }
+        }
+    }
+    return pinned;
+}
 /**
  * Returns a new `TurnState` whose serialized size is at most `maxBytes`,
  * evicting the oldest agent messages first. After each eviction, drops any
  * leading `toolResult` or `assistant` message until the head is `user` — the
  * only role every provider accepts at position 0.
  *
- * Front-eviction preserves tool-call / tool-result pairing by construction:
- * tool results always follow their assistant call in source order, so
- * dropping an assistant naturally drops its trailing results through the
- * head-fix loop.
+ * Front-eviction preserves tool-call / tool-result pairing by construction.
+ * When a result carries a live task id, both sides of that pair are pinned:
+ * the full invalid-head cascade is inspected before removal, and compaction
+ * stops at the preceding valid boundary rather than split or evict the pair.
+ * `TurnState.tasks` remains authoritative if no transcript pair can be found.
  *
  * Preserves the original state reference (no mutation) and every non-message
  * field on `TurnState` and `state.agent` (`status`, `mode`, `options`,
- * `stateMachine`, `todos`, `followUpQueue`, `queuedCommands`).
+ * `stateMachine`, `todos`, `followUpQueue`, `queuedCommands`, `tasks`, and
+ * `nextTaskId`).
  *
  * Stops once `messages.length <= MIN_RETAINED_MESSAGES`. If the remainder
  * still exceeds `maxBytes`, the caller persists/emits the oversize state: a
@@ -69,15 +123,20 @@ export function compactTurnState(state, options = {}) {
         return { state, evicted: 0, bytes: serialized.length };
     }
     const trimmed = [...messages];
+    const pinned = findLiveTaskPairMessages(state, messages);
     let current = state;
     let evicted = 0;
     while (serialized.length > maxBytes && trimmed.length > MIN_RETAINED_MESSAGES) {
-        trimmed.shift();
-        evicted += 1;
-        while (trimmed.length > MIN_RETAINED_MESSAGES && isInvalidHead(trimmed[0])) {
-            trimmed.shift();
-            evicted += 1;
+        let removeCount = 1;
+        while (trimmed.length - removeCount > MIN_RETAINED_MESSAGES &&
+            isInvalidHead(trimmed[removeCount])) {
+            removeCount += 1;
         }
+        const removal = trimmed.slice(0, removeCount);
+        if (removal.some((message) => pinned.has(message)))
+            break;
+        trimmed.splice(0, removeCount);
+        evicted += removeCount;
         current = { ...current, agent: { ...current.agent, messages: trimmed } };
         serialized = JSON.stringify(current);
     }

package/dist/src/turn-runner/state-compaction.js.map

@@ -1 +1 @@
-{"version":3,"file":"state-compaction.js","sourceRoot":"","sources":["../../../src/turn-runner/state-compaction.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC;AAEzD;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC;AAcvC;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,GAAG,CAAC;AAEhD;;;;;GAKG;AACH,SAAS,aAAa,CAAC,OAAiC;IACtD,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC,MAAM,IAAI,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IACnD,OAAO,OAAO,CAAC,IAAI,KAAK,YAAY,IAAI,OAAO,CAAC,IAAI,KAAK,WAAW,CAAC;AACvE,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAgB,EAChB,UAAsC,EAAE;IAExC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,uBAAuB,CAAC;IAC7D,IAAI,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACvC,IAAI,UAAU,CAAC,MAAM,IAAI,QAAQ,EAAE,CAAC;QAClC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC;IACzD,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,EAAE,QAAQ,CAAC;IACvC,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvC,uEAAuE;QACvE,UAAU;QACV,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC;IACzD,CAAC;IAED,MAAM,OAAO,GAAmB,CAAC,GAAG,QAAQ,CAAC,CAAC;IAC9C,IAAI,OAAO,GAAc,KAAK,CAAC;IAC/B,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,OAAO,UAAU,CAAC,MAAM,GAAG,QAAQ,IAAI,OAAO,CAAC,MAAM,GAAG,qBAAqB,EAAE,CAAC;QAC9E,OAAO,CAAC,KAAK,EAAE,CAAC;QAChB,OAAO,IAAI,CAAC,CAAC;QACb,OAAO,OAAO,CAAC,MAAM,GAAG,qBAAqB,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3E,OAAO,CAAC,KAAK,EAAE,CAAC;YAChB,OAAO,IAAI,CAAC,CAAC;QACf,CAAC;QACD,OAAO,GAAG,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,CAAC;QACzE,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC;AAC/D,CAAC"}
+{"version":3,"file":"state-compaction.js","sourceRoot":"","sources":["../../../src/turn-runner/state-compaction.ts"],"names":[],"mappings":"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"}

package/dist/src/turn-runner/state-machine-decisions.d.ts

@@ -0,0 +1,135 @@
+import type { TurnQuestion } from "../types/protocol.js";
+import type { StateMachineDefinition, StateMachineSession, StateMachineState, StateMachineTerminalResult } from "../types/state-machine.js";
+import type { ShellCommandOutput, ShellPartialOutput } from "./shell-state-handle.js";
+import type { SubagentResult, SubagentSpec } from "./subagent.js";
+import type { StateMachineRunnerDecision, StateMachineStateOverride } from "./tools.js";
+export { consecutivePollGateSuccesses, MISCONFIGURED_POLL_GATE_THRESHOLD, repeatedSelectionLoopCount, repeatedStateSelectionStreak, REPEATED_SELECTION_LOOP_THRESHOLD, REPEATED_SELECTION_LOOP_WINDOW_MS, } from "./state-machine-session.js";
+type StateCompletedOutcome = {
+    type: "state_completed";
+    stateName: string;
+    output?: unknown;
+};
+type TerminalOutcome = {
+    type: "terminal";
+    status: StateMachineTerminalResult["status"];
+    result?: string;
+    error?: string;
+};
+type AskOutcome = {
+    type: "ask";
+    questions: TurnQuestion[];
+};
+type SleepOutcome = {
+    type: "sleep";
+    wakeAt: number;
+};
+type InterruptedOutcome = {
+    type: "interrupted";
+};
+/** Serializable shell work selected by state-machine policy. */
+export interface ShellSpec {
+    /** Rendered command for this state attempt. */
+    command: string;
+    /** State-local working directory; the turn loop resolves it against its base cwd. */
+    cwd?: string;
+    /** Hard runtime limit for script states; polls use their timeout as a session-level policy. */
+    timeoutMs?: number;
+    /** Exit codes that settle the shell attempt successfully. */
+    successCodes?: number[];
+}
+/** Policy needed to fold a non-successful shell attempt back into a scheduled poll. */
+export interface PollPolicy {
+    /** Delay before the next poll attempt. */
+    intervalMs: number | string;
+}
+/** Execution-free work description produced by a state-machine decision. */
+export type PlannedWork = {
+    park: {
+        stateName: string;
+    };
+} | {
+    run: {
+        subagent: SubagentSpec;
+        stateName: string;
+    };
+} | {
+    run: {
+        shell: ShellSpec;
+        stateName: string;
+        pollPolicy?: PollPolicy;
+    };
+} | {
+    schedule: {
+        wakeAt: number;
+        stateName: string;
+    };
+} | {
+    terminal: Omit<TerminalOutcome, "type"> & {
+        stateName: string;
+        ledger: "recorded" | "failed" | "completed";
+        notifyStarted: boolean;
+    };
+};
+export interface PlannedDecision {
+    /** Updated durable ledger after applying and recording the decision. */
+    session: StateMachineSession;
+    /** Execution or scheduling work the turn loop performs. */
+    work: PlannedWork;
+}
+export type SettledDecision = {
+    session: StateMachineSession;
+    outcome: StateCompletedOutcome;
+} | {
+    session: StateMachineSession;
+    outcome: TerminalOutcome;
+} | {
+    session: StateMachineSession;
+    outcome: AskOutcome;
+} | {
+    session: StateMachineSession;
+    outcome: SleepOutcome;
+} | {
+    session: StateMachineSession;
+    outcome: InterruptedOutcome;
+};
+export type ShellSettlement = {
+    type: "completed";
+    output: ShellCommandOutput;
+} | {
+    type: "failed";
+    error: string;
+} | {
+    type: "interrupted";
+    reason?: string;
+};
+export type TimerSettlement = {
+    type: "completed";
+    output: {
+        elapsedMs: number;
+        timestamp: number;
+    };
+};
+export declare function hydrate(stateMachine: StateMachineSession | undefined): StateMachineSession | undefined;
+export declare function getSession(stateMachine: StateMachineSession | undefined): StateMachineSession | undefined;
+export declare function startSession(input: {
+    prompt: string;
+    definition: StateMachineDefinition;
+    currentState: string;
+}): StateMachineSession;
+export declare function markTerminalAcknowledged(session: StateMachineSession): StateMachineSession;
+export declare function failActiveSession(session: StateMachineSession, state: string, error: string): SettledDecision;
+export declare function supersede(session: StateMachineSession, reason: string): StateMachineSession;
+export declare function planDecision(stateMachine: StateMachineSession, decision: StateMachineRunnerDecision, now?: number): PlannedDecision;
+export declare function planWake(stateMachine: StateMachineSession | undefined, now?: number): PlannedDecision | undefined;
+export declare function recordScheduled(stateMachine: StateMachineSession, stateName: string, wakeAt: number): SettledDecision;
+export declare function recordPlannedTerminal(stateMachine: StateMachineSession, terminal: Extract<PlannedWork, {
+    terminal: unknown;
+}>["terminal"]): SettledDecision;
+export declare function recordSettled(stateMachine: StateMachineSession, stateName: string, kind: "agent" | "script" | "poll" | "timer", result: SubagentResult | ShellSettlement | TimerSettlement, partial?: {
+    assistantText?: string;
+} | ShellPartialOutput, now?: number): SettledDecision;
+export declare function applyStateOverride(state: StateMachineState, override: StateMachineStateOverride | undefined): StateMachineState;
+export declare function renderTemplate(template: string, input: Record<string, unknown>): string;
+export declare function parseStructuredOutput(stdout: string): Record<string, unknown>;
+export declare function parseJsonObject(text: string): Record<string, unknown>;
+//# sourceMappingURL=state-machine-decisions.d.ts.map

package/dist/src/turn-runner/state-machine-decisions.d.ts.map

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