ugly-app 0.1.634 → 0.1.636

package/dist/agent/client/agentStreamReducer.d.ts

@@ -0,0 +1,11 @@
+import { type StreamingMessage } from '../../conversation/client/conversationStreamReducer.js';
+import type { AgentStopReason, AgentStreamFrame, ToolUseRef } from '../shared/AgentStream.js';
+export interface AgentStreamingMessage extends StreamingMessage {
+    toolUse?: ToolUseRef[];
+    stopReason?: AgentStopReason;
+}
+export type AgentStreamingMap = Readonly<Record<string, AgentStreamingMessage>>;
+/** Apply one agent frame, returning a new map (immutable update). */
+export declare function applyAgentFrame(map: AgentStreamingMap, frame: AgentStreamFrame): AgentStreamingMap;
+export { type StreamingMessage };
+//# sourceMappingURL=agentStreamReducer.d.ts.map

package/dist/agent/client/agentStreamReducer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentStreamReducer.d.ts","sourceRoot":"","sources":["../../../src/agent/client/agentStreamReducer.ts"],"names":[],"mappings":"AAOA,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,wDAAwD,CAAC;AAChE,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,UAAU,EACX,MAAM,0BAA0B,CAAC;AAElC,MAAM,WAAW,qBAAsB,SAAQ,gBAAgB;IAC7D,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;IACvB,UAAU,CAAC,EAAE,eAAe,CAAC;CAC9B;AAED,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC;AAEhF,qEAAqE;AACrE,wBAAgB,eAAe,CAC7B,GAAG,EAAE,iBAAiB,EACtB,KAAK,EAAE,gBAAgB,GACtB,iBAAiB,CAkCnB;AAED,OAAO,EAAE,KAAK,gBAAgB,EAAE,CAAC"}

package/dist/agent/client/agentStreamReducer.js

@@ -0,0 +1,44 @@
+// Pure client-side reducer for the agent live frames.
+//
+// Reuses the conversation reducer for the shared `msg:*` frames (begin/delta/
+// commit/error) and adds the two agent frames (`msg:tool_use`, `msg:turn_done`).
+// This drives the live streaming UI only — the loop's control flow comes from
+// the authoritative request RESPONSE, not these frames.
+import { applyFrame as applyBaseFrame, } from '../../conversation/client/conversationStreamReducer.js';
+/** Apply one agent frame, returning a new map (immutable update). */
+export function applyAgentFrame(map, frame) {
+    switch (frame.type) {
+        case 'msg:tool_use': {
+            const cur = map[frame.msgId];
+            const base = cur ?? {
+                msgId: frame.msgId,
+                authorId: 'assistant',
+                kind: 'bot',
+                text: '',
+                sources: [],
+                status: 'streaming',
+            };
+            return { ...map, [frame.msgId]: { ...base, toolUse: frame.toolUse } };
+        }
+        case 'msg:turn_done': {
+            const cur = map[frame.msgId];
+            const base = cur ?? {
+                msgId: frame.msgId,
+                authorId: 'assistant',
+                kind: 'bot',
+                text: '',
+                sources: [],
+                status: 'streaming',
+            };
+            return {
+                ...map,
+                [frame.msgId]: { ...base, stopReason: frame.stopReason },
+            };
+        }
+        default:
+            // Delegate the shared frames to the conversation reducer (carrying over
+            // any agent-only fields already on the entry).
+            return applyBaseFrame(map, frame);
+    }
+}
+//# sourceMappingURL=agentStreamReducer.js.map

package/dist/agent/client/agentStreamReducer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentStreamReducer.js","sourceRoot":"","sources":["../../../src/agent/client/agentStreamReducer.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,EAAE;AACF,8EAA8E;AAC9E,iFAAiF;AACjF,8EAA8E;AAC9E,wDAAwD;AAExD,OAAO,EACL,UAAU,IAAI,cAAc,GAG7B,MAAM,wDAAwD,CAAC;AAchE,qEAAqE;AACrE,MAAM,UAAU,eAAe,CAC7B,GAAsB,EACtB,KAAuB;IAEvB,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,cAAc,CAAC,CAAC,CAAC;YACpB,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC7B,MAAM,IAAI,GAA0B,GAAG,IAAI;gBACzC,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,QAAQ,EAAE,WAAW;gBACrB,IAAI,EAAE,KAAK;gBACX,IAAI,EAAE,EAAE;gBACR,OAAO,EAAE,EAAE;gBACX,MAAM,EAAE,WAAW;aACpB,CAAC;YACF,OAAO,EAAE,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;QACxE,CAAC;QACD,KAAK,eAAe,CAAC,CAAC,CAAC;YACrB,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC7B,MAAM,IAAI,GAA0B,GAAG,IAAI;gBACzC,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,QAAQ,EAAE,WAAW;gBACrB,IAAI,EAAE,KAAK;gBACX,IAAI,EAAE,EAAE;gBACR,OAAO,EAAE,EAAE;gBACX,MAAM,EAAE,WAAW;aACpB,CAAC;YACF,OAAO;gBACL,GAAG,GAAG;gBACN,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,EAAE,GAAG,IAAI,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE;aACzD,CAAC;QACJ,CAAC;QACD;YACE,wEAAwE;YACxE,+CAA+C;YAC/C,OAAO,cAAc,CAAC,GAAmB,EAAE,KAAK,CAAsB,CAAC;IAC3E,CAAC;AACH,CAAC"}

package/dist/agent/client/compaction.d.ts

@@ -0,0 +1,27 @@
+import type { Message } from '../../shared/TextGen.js';
+export interface CompactionConfig {
+    /** Compact when the working context exceeds this estimated token count. */
+    maxContextTokens: number;
+    /** How many of the most-recent messages to always keep verbatim. */
+    keepRecentTurns: number;
+    /**
+     * Optional AI summarizer for the dropped turns. When omitted, compaction is
+     * lossy-structural (a placeholder note) — acceptable because the canonical
+     * full log retains everything.
+     */
+    summarize?: (dropped: Message[]) => Promise<string>;
+}
+export interface CompactionResult {
+    messages: Message[];
+    compacted: boolean;
+    /** Number of original messages folded into the summary. */
+    droppedCount: number;
+    summary?: string;
+}
+/**
+ * Return a (possibly) compacted working context. A no-op when under budget.
+ * Never mutates the input. Keeps a leading system message (if any) + the
+ * summary + the most recent `keepRecentTurns` messages.
+ */
+export declare function compactMessages(messages: Message[], config: CompactionConfig): Promise<CompactionResult>;
+//# sourceMappingURL=compaction.d.ts.map

package/dist/agent/client/compaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction.d.ts","sourceRoot":"","sources":["../../../src/agent/client/compaction.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAGvD,MAAM,WAAW,gBAAgB;IAC/B,2EAA2E;IAC3E,gBAAgB,EAAE,MAAM,CAAC;IACzB,oEAAoE;IACpE,eAAe,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,2DAA2D;IAC3D,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAKD;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,OAAO,EAAE,EACnB,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,gBAAgB,CAAC,CAiC3B"}

package/dist/agent/client/compaction.js

@@ -0,0 +1,44 @@
+// Compaction — shrink the WORKING context sent to the model.
+//
+// IMPORTANT: this only ever shrinks the working context. The canonical session
+// log (e.g. ugly-code's native.fs JSONL) keeps every original event verbatim
+// and is NEVER compacted — callers persist there independently. Compaction
+// summarizes the oldest turns into a single summary message, keeping the most
+// recent `keepRecentTurns` messages intact.
+import { estimateTokens } from '../shared/tokenEstimate.js';
+const DEFAULT_SUMMARY = (n) => `[Earlier in this session, ${n} message(s) were compacted out of the working context to stay within the model's window. The full history is preserved in the session log.]`;
+/**
+ * Return a (possibly) compacted working context. A no-op when under budget.
+ * Never mutates the input. Keeps a leading system message (if any) + the
+ * summary + the most recent `keepRecentTurns` messages.
+ */
+export async function compactMessages(messages, config) {
+    if (estimateTokens(messages) <= config.maxContextTokens) {
+        return { messages, compacted: false, droppedCount: 0 };
+    }
+    // Preserve a leading system message verbatim.
+    const hasSystem = messages.length > 0 && messages[0].role === 'system';
+    const head = hasSystem ? [messages[0]] : [];
+    const body = hasSystem ? messages.slice(1) : messages;
+    const keep = Math.max(0, config.keepRecentTurns);
+    if (body.length <= keep) {
+        // Nothing safely droppable — leave as-is rather than gut recent context.
+        return { messages, compacted: false, droppedCount: 0 };
+    }
+    const dropped = body.slice(0, body.length - keep);
+    const recent = body.slice(body.length - keep);
+    const summaryText = config.summarize
+        ? await config.summarize(dropped)
+        : DEFAULT_SUMMARY(dropped.length);
+    const summaryMsg = {
+        role: 'user',
+        content: [{ type: 'text', text: summaryText }],
+    };
+    return {
+        messages: [...head, summaryMsg, ...recent],
+        compacted: true,
+        droppedCount: dropped.length,
+        summary: summaryText,
+    };
+}
+//# sourceMappingURL=compaction.js.map

package/dist/agent/client/compaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction.js","sourceRoot":"","sources":["../../../src/agent/client/compaction.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,EAAE;AACF,+EAA+E;AAC/E,6EAA6E;AAC7E,2EAA2E;AAC3E,8EAA8E;AAC9E,4CAA4C;AAG5C,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAuB5D,MAAM,eAAe,GAAG,CAAC,CAAS,EAAU,EAAE,CAC5C,6BAA6B,CAAC,6IAA6I,CAAC;AAE9K;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,QAAmB,EACnB,MAAwB;IAExB,IAAI,cAAc,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;QACxD,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;IACzD,CAAC;IAED,8CAA8C;IAC9C,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAE,CAAC,IAAI,KAAK,QAAQ,CAAC;IACxE,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7C,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IAEtD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,eAAe,CAAC,CAAC;IACjD,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC;QACxB,yEAAyE;QACzE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;IACzD,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC9C,MAAM,WAAW,GAAG,MAAM,CAAC,SAAS;QAClC,CAAC,CAAC,MAAM,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC;QACjC,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAEpC,MAAM,UAAU,GAAY;QAC1B,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;KAC/C,CAAC;IAEF,OAAO;QACL,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;QAC1C,SAAS,EAAE,IAAI;QACf,YAAY,EAAE,OAAO,CAAC,MAAM;QAC5B,OAAO,EAAE,WAAW;KACrB,CAAC;AACJ,CAAC"}

package/dist/agent/client/index.d.ts

@@ -0,0 +1,7 @@
+export { runAgent, type AgentBudget, type AgentController, type AgentEvent, type RunAgentConfig, type RunAgentSocket, } from './runAgent.js';
+export { useAgent, type UseAgentOptions, type UseAgentResult, type UseAgentStatus, } from './useAgent.js';
+export { applyAgentFrame, type AgentStreamingMap, type AgentStreamingMessage, } from './agentStreamReducer.js';
+export { compactMessages, type CompactionConfig, type CompactionResult, } from './compaction.js';
+export { AGENT_STREAM_COLLECTION, AGENT_STREAM_KEY_FIELD, estimateTokens, emptyTelemetryTotals, accrueTelemetry, } from '../shared/index.js';
+export type { AgentMessage, AgentSession, AgentSessionStore, AgentStopReason, AgentStreamFrame, AgentTelemetryTotals, AgentTurnRequest, AgentTurnResponse, ContentPart, MsgTelemetry, TextGenModel, TextGenTool, ToolUseRef, } from '../shared/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/agent/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agent/client/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,QAAQ,EACR,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,cAAc,GACpB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,QAAQ,EACR,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,cAAc,GACpB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,eAAe,EACf,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,GAC3B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,eAAe,EACf,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,GACtB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,cAAc,EACd,oBAAoB,EACpB,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,UAAU,GACX,MAAM,oBAAoB,CAAC"}

package/dist/agent/client/index.js

@@ -0,0 +1,8 @@
+// ugly-app/agent/client — the client-driven loop runner (imperative + React).
+export { runAgent, } from './runAgent.js';
+export { useAgent, } from './useAgent.js';
+export { applyAgentFrame, } from './agentStreamReducer.js';
+export { compactMessages, } from './compaction.js';
+// Shared contracts apps need on the client too.
+export { AGENT_STREAM_COLLECTION, AGENT_STREAM_KEY_FIELD, estimateTokens, emptyTelemetryTotals, accrueTelemetry, } from '../shared/index.js';
+//# sourceMappingURL=index.js.map

package/dist/agent/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agent/client/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAE9E,OAAO,EACL,QAAQ,GAMT,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,QAAQ,GAIT,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,eAAe,GAGhB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,eAAe,GAGhB,MAAM,iBAAiB,CAAC;AAEzB,gDAAgD;AAChD,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,cAAc,EACd,oBAAoB,EACpB,eAAe,GAChB,MAAM,oBAAoB,CAAC"}

package/dist/agent/client/runAgent.d.ts

@@ -0,0 +1,85 @@
+import type { ContentPart, Message } from '../../shared/TextGen.js';
+import { type AgentStreamFrame, type AgentStopReason, type MsgTelemetry, type TextGenTool, type ToolUseRef } from '../shared/AgentStream.js';
+import { type AgentSession, type AgentSessionStore, type AgentTelemetryTotals } from '../shared/SessionStore.js';
+import { type CompactionConfig } from './compaction.js';
+export interface RunAgentSocket {
+    request(name: string, input: unknown, opts?: {
+        timeoutMs?: number | null;
+        signal?: AbortSignal;
+    }): Promise<unknown>;
+    trackDocs(collection: string, params: {
+        keys?: Record<string, string>;
+    }, cb: (docs: unknown[]) => void, onFrame?: (frame: unknown) => void): () => void;
+}
+export interface AgentBudget {
+    maxUsd?: number;
+    maxTokens?: number;
+    maxTurns?: number;
+}
+export type AgentEvent = {
+    type: 'turn_start';
+    msgId: string;
+    turnIndex: number;
+} | {
+    type: 'turn_done';
+    msgId: string;
+    stopReason: AgentStopReason;
+    telemetry?: MsgTelemetry;
+} | {
+    type: 'tool_use';
+    toolUse: ToolUseRef[];
+} | {
+    type: 'tool_result';
+    results: ContentPart[];
+} | {
+    type: 'compaction';
+    droppedCount: number;
+    summary?: string;
+} | {
+    type: 'budget_exceeded';
+    reason: string;
+    totals: AgentTelemetryTotals;
+} | {
+    type: 'aborted';
+} | {
+    type: 'error';
+    message: string;
+} | {
+    type: 'done';
+};
+export interface RunAgentConfig {
+    socket: RunAgentSocket;
+    sessionId: string;
+    /** The hub channel for live frames. Defaults to `sessionId`. */
+    streamId?: string;
+    model: string;
+    systemPrompt?: string;
+    tools?: TextGenTool[];
+    /** name → handler returning the tool_result string. */
+    toolHandlers: Record<string, (input: unknown) => Promise<string>>;
+    options?: Record<string, unknown>;
+    /** The request name registered in the app (default `agentTurn`). */
+    requestName?: string;
+    budget?: AgentBudget;
+    compaction?: CompactionConfig;
+    /** Local-first persistence (offline/optimistic resume + full log). */
+    sessionStore?: AgentSessionStore;
+    /** Optional approval gate before executing a flagged tool. */
+    approveTool?: (name: string, input: unknown) => Promise<boolean>;
+    /** Tools that must run serially (default: all run concurrently). */
+    serialTools?: string[];
+    onText?: (msgId: string, delta: string) => void;
+    onTurn?: (turn: Message, telemetry?: MsgTelemetry) => void;
+    onEvent?: (event: AgentEvent) => void;
+    onFrame?: (frame: AgentStreamFrame) => void;
+}
+export interface AgentController {
+    send(userText: string): Promise<void>;
+    resume(session: AgentSession): Promise<void>;
+    abort(): void;
+    getMessages(): Message[];
+    getTelemetryTotals(): AgentTelemetryTotals;
+    dispose(): void;
+}
+export declare function runAgent(config: RunAgentConfig): AgentController;
+//# sourceMappingURL=runAgent.d.ts.map

package/dist/agent/client/runAgent.d.ts.map

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

package/dist/agent/client/runAgent.js

@@ -0,0 +1,276 @@
+// runAgent — the client-driven agentic loop (imperative, no React).
+//
+// The client owns the loop and executes every tool. Each turn is one
+// `agentTurn` request whose RESPONSE is the authoritative result (content +
+// stopReason + telemetry); live text frames ride the hub during the await and
+// are surfaced via `onText`. On `stopReason:'tool_use'` the loop runs the tool
+// handlers (concurrently, with an optional approval gate) and requests the next
+// turn; on `end_turn` it stops.
+//
+// Production-harness features built in: cancellation/abort, cost/budget caps,
+// retry/backoff on transient request failures (idempotent via msgId), and a
+// tool-approval hook + parallel tool execution.
+import { AGENT_STREAM_COLLECTION, AGENT_STREAM_KEY_FIELD, } from '../shared/AgentStream.js';
+import { accrueTelemetry, emptyTelemetryTotals, } from '../shared/SessionStore.js';
+import { compactMessages } from './compaction.js';
+const REQUEST_RETRIES = 3;
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+function mintId() {
+    return Date.now().toString(36) + Math.random().toString(36).slice(2, 10);
+}
+function toolUsePartsOf(content) {
+    const out = [];
+    for (const part of content) {
+        if (part.type === 'tool_use')
+            out.push({ id: part.id, name: part.name, input: part.input });
+    }
+    return out;
+}
+export function runAgent(config) {
+    const streamId = config.streamId ?? config.sessionId;
+    const requestName = config.requestName ?? 'agentTurn';
+    let messages = [];
+    let totals = emptyTelemetryTotals();
+    let aborter = new AbortController();
+    let running = false;
+    // Subscribe once to the live frame channel (text streaming + agent frames).
+    const unsub = config.socket.trackDocs(AGENT_STREAM_COLLECTION, { keys: { [AGENT_STREAM_KEY_FIELD]: streamId } }, () => { }, (raw) => {
+        const env = raw;
+        const frame = env.frame ?? env;
+        if (!frame || typeof frame.type !== 'string')
+            return;
+        config.onFrame?.(frame);
+        if (frame.type === 'msg:delta')
+            config.onText?.(frame.msgId, frame.delta);
+    });
+    async function persist(status) {
+        if (!config.sessionStore)
+            return;
+        await config.sessionStore.save({
+            sessionId: config.sessionId,
+            model: config.model,
+            ...(config.systemPrompt ? { systemPrompt: config.systemPrompt } : {}),
+            messages,
+            status,
+            updatedAt: Date.now(),
+            telemetryTotals: totals,
+        });
+    }
+    function budgetExceeded() {
+        const b = config.budget;
+        if (!b)
+            return null;
+        if (b.maxUsd !== undefined && totals.costUsd >= b.maxUsd)
+            return `cost cap reached ($${totals.costUsd.toFixed(4)} ≥ $${b.maxUsd})`;
+        if (b.maxTokens !== undefined &&
+            totals.inputTokens + totals.outputTokens >= b.maxTokens)
+            return `token cap reached (${totals.inputTokens + totals.outputTokens} ≥ ${b.maxTokens})`;
+        if (b.maxTurns !== undefined && totals.turns >= b.maxTurns)
+            return `turn cap reached (${totals.turns} ≥ ${b.maxTurns})`;
+        return null;
+    }
+    /** One turn request with retry/backoff; idempotent via the stable msgId. */
+    async function requestTurn(msgId) {
+        let lastErr;
+        for (let attempt = 1; attempt <= REQUEST_RETRIES; attempt++) {
+            if (aborter.signal.aborted)
+                throw new AbortError();
+            try {
+                const resp = (await config.socket.request(requestName, {
+                    sessionId: config.sessionId,
+                    streamId,
+                    msgId,
+                    model: config.model,
+                    ...(config.systemPrompt ? { systemPrompt: config.systemPrompt } : {}),
+                    messages,
+                    ...(config.tools ? { tools: config.tools } : {}),
+                    ...(config.options ? { options: config.options } : {}),
+                }, { timeoutMs: null, signal: aborter.signal }));
+                return resp;
+            }
+            catch (err) {
+                if (aborter.signal.aborted)
+                    throw new AbortError();
+                lastErr = err;
+                if (attempt < REQUEST_RETRIES)
+                    await sleep(300 * 2 ** (attempt - 1));
+            }
+        }
+        throw lastErr instanceof Error ? lastErr : new Error('agent turn request failed');
+    }
+    async function runTool(use) {
+        try {
+            if (config.approveTool) {
+                const ok = await config.approveTool(use.name, use.input);
+                if (!ok)
+                    return {
+                        type: 'tool_result',
+                        tool_use_id: use.id,
+                        content: `Tool "${use.name}" was not approved by the user.`,
+                    };
+            }
+            const handler = config.toolHandlers[use.name];
+            if (!handler)
+                return {
+                    type: 'tool_result',
+                    tool_use_id: use.id,
+                    content: `Error: no handler for tool "${use.name}".`,
+                };
+            const result = await handler(use.input);
+            return { type: 'tool_result', tool_use_id: use.id, content: result };
+        }
+        catch (err) {
+            return {
+                type: 'tool_result',
+                tool_use_id: use.id,
+                content: `Error: ${err instanceof Error ? err.message : String(err)}`,
+            };
+        }
+    }
+    async function executeTools(uses) {
+        const serial = new Set(config.serialTools ?? []);
+        const serialUses = uses.filter((u) => serial.has(u.name));
+        const parallelUses = uses.filter((u) => !serial.has(u.name));
+        const results = await Promise.all(parallelUses.map((u) => runTool(u)));
+        for (const u of serialUses)
+            results.push(await runTool(u));
+        // Preserve the model's original tool order in the results.
+        const byId = new Map(results.map((r) => [r.tool_use_id, r]));
+        return uses.map((u) => byId.get(u.id));
+    }
+    /** The core loop — runs turns until end_turn / abort / budget / error. */
+    async function loop() {
+        running = true;
+        try {
+            for (;;) {
+                if (aborter.signal.aborted) {
+                    config.onEvent?.({ type: 'aborted' });
+                    await persist('idle');
+                    return;
+                }
+                const capped = budgetExceeded();
+                if (capped) {
+                    config.onEvent?.({ type: 'budget_exceeded', reason: capped, totals });
+                    await persist('done');
+                    return;
+                }
+                // Compact the working context if needed (never touches the full log).
+                if (config.compaction) {
+                    const c = await compactMessages(messages, config.compaction);
+                    if (c.compacted) {
+                        messages = c.messages;
+                        config.onEvent?.({
+                            type: 'compaction',
+                            droppedCount: c.droppedCount,
+                            ...(c.summary ? { summary: c.summary } : {}),
+                        });
+                        await persist('running');
+                    }
+                }
+                const msgId = mintId();
+                config.onEvent?.({ type: 'turn_start', msgId, turnIndex: totals.turns });
+                const resp = await requestTurn(msgId);
+                const assistantTurn = { role: 'assistant', content: resp.content };
+                messages = [...messages, assistantTurn];
+                if (resp.telemetry) {
+                    totals = accrueTelemetry(totals, {
+                        ...(resp.telemetry.model ? { model: resp.telemetry.model } : {}),
+                        ...(resp.telemetry.inputTokens !== undefined
+                            ? { inputTokens: resp.telemetry.inputTokens }
+                            : {}),
+                        ...(resp.telemetry.outputTokens !== undefined
+                            ? { outputTokens: resp.telemetry.outputTokens }
+                            : {}),
+                        ...(resp.telemetry.costUsd !== undefined
+                            ? { costUsd: resp.telemetry.costUsd }
+                            : {}),
+                    });
+                }
+                config.onTurn?.(assistantTurn, resp.telemetry);
+                config.onEvent?.({
+                    type: 'turn_done',
+                    msgId,
+                    stopReason: resp.stopReason,
+                    ...(resp.telemetry ? { telemetry: resp.telemetry } : {}),
+                });
+                await persist(resp.stopReason === 'tool_use' ? 'running' : 'idle');
+                if (resp.stopReason === 'error') {
+                    config.onEvent?.({ type: 'error', message: resp.error ?? 'agent turn error' });
+                    return;
+                }
+                if (resp.stopReason !== 'tool_use') {
+                    config.onEvent?.({ type: 'done' });
+                    return;
+                }
+                const uses = toolUsePartsOf(resp.content);
+                config.onEvent?.({ type: 'tool_use', toolUse: uses });
+                const results = await executeTools(uses);
+                config.onEvent?.({ type: 'tool_result', results });
+                messages = [...messages, { role: 'user', content: results }];
+                await persist('running');
+            }
+        }
+        catch (err) {
+            if (err instanceof AbortError || aborter.signal.aborted) {
+                config.onEvent?.({ type: 'aborted' });
+                await persist('idle');
+                return;
+            }
+            config.onEvent?.({ type: 'error', message: err instanceof Error ? err.message : String(err) });
+            await persist('error');
+        }
+        finally {
+            running = false;
+        }
+    }
+    return {
+        async send(userText) {
+            if (running)
+                throw new Error('runAgent: a turn is already in progress');
+            if (aborter.signal.aborted)
+                aborter = new AbortController();
+            messages = [...messages, { role: 'user', content: userText }];
+            await persist('running');
+            await loop();
+        },
+        async resume(session) {
+            messages = session.messages;
+            totals = session.telemetryTotals ?? emptyTelemetryTotals();
+            if (aborter.signal.aborted)
+                aborter = new AbortController();
+            // If the loaded session ends on an assistant turn with unresolved
+            // tool_use (a crash/drop after the model turn but before tools ran),
+            // execute those tools and continue the loop. Otherwise idle for input.
+            const last = messages[messages.length - 1];
+            if (last?.role === 'assistant' && Array.isArray(last.content)) {
+                const uses = toolUsePartsOf(last.content);
+                if (uses.length > 0) {
+                    const results = await executeTools(uses);
+                    messages = [...messages, { role: 'user', content: results }];
+                    await persist('running');
+                    await loop();
+                }
+            }
+        },
+        abort() {
+            aborter.abort();
+        },
+        getMessages() {
+            return messages;
+        },
+        getTelemetryTotals() {
+            return totals;
+        },
+        dispose() {
+            aborter.abort();
+            unsub();
+        },
+    };
+}
+class AbortError extends Error {
+    constructor() {
+        super('aborted');
+        this.name = 'AbortError';
+    }
+}
+//# sourceMappingURL=runAgent.js.map

package/dist/agent/client/runAgent.js.map

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

package/dist/agent/client/useAgent.d.ts

@@ -0,0 +1,22 @@
+import type { Message } from '../../shared/TextGen.js';
+import type { MsgTelemetry } from '../shared/AgentStream.js';
+import type { AgentTelemetryTotals } from '../shared/SessionStore.js';
+import { type AgentStreamingMessage } from './agentStreamReducer.js';
+import { type AgentEvent, type RunAgentConfig } from './runAgent.js';
+export type UseAgentStatus = 'idle' | 'running' | 'error';
+export interface UseAgentResult {
+    messages: Message[];
+    streaming: AgentStreamingMessage[];
+    pendingToolUse: AgentStreamingMessage | null;
+    status: UseAgentStatus;
+    telemetryTotals: AgentTelemetryTotals;
+    lastTelemetry: MsgTelemetry | null;
+    send(userText: string): Promise<void>;
+    abort(): void;
+}
+export type UseAgentOptions = Omit<RunAgentConfig, 'socket' | 'onText' | 'onTurn' | 'onEvent' | 'onFrame'> & {
+    socket: RunAgentConfig['socket'];
+    onEvent?: (event: AgentEvent) => void;
+};
+export declare function useAgent(options: UseAgentOptions): UseAgentResult;
+//# sourceMappingURL=useAgent.d.ts.map

package/dist/agent/client/useAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAgent.d.ts","sourceRoot":"","sources":["../../../src/agent/client/useAgent.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,KAAK,EAAoB,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC/E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAGL,KAAK,UAAU,EACf,KAAK,cAAc,EACpB,MAAM,eAAe,CAAC;AAEvB,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAE1D,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,SAAS,EAAE,qBAAqB,EAAE,CAAC;IACnC,cAAc,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAC7C,MAAM,EAAE,cAAc,CAAC;IACvB,eAAe,EAAE,oBAAoB,CAAC;IACtC,aAAa,EAAE,YAAY,GAAG,IAAI,CAAC;IACnC,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,MAAM,eAAe,GAAG,IAAI,CAChC,cAAc,EACd,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CACvD,GAAG;IACF,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;CACvC,CAAC;AAEF,wBAAgB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,CA4FjE"}