@adonis-agora/agent 0.61.0 → 0.63.0

package/dist/src/react/core/reasoning/timing.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Where a reasoning part carries how long the model thought, in ms. Both producers write it here —
+ * the transport on the live `reasoning-end` chunk, `storedMessageToUiMessage` on a replayed part —
+ * so a reader has one place to look whichever way the message arrived.
+ */
+export declare const REASONING_METADATA_KEY = "agent";
+/** The `providerMetadata` a reasoning part is stamped with. */
+export declare function reasoningDurationMetadata(reasoningMs: number): {
+    [REASONING_METADATA_KEY]: {
+        reasoningMs: number;
+    };
+};
+/** The thinking time stamped on a reasoning part, or `null` when it carries none. */
+export declare function readReasoningMs(part: {
+    providerMetadata?: unknown;
+}): number | null;
+export interface UseElapsedOptions {
+    /** How often the value re-renders while running. Default 1000 — a seconds label needs no more. */
+    intervalMs?: number;
+    /** Injectable clock for tests. */
+    now?: () => number;
+}
+/**
+ * Milliseconds since `running` last turned true — ticking while it stays true, frozen at the final
+ * value once it turns false, `0` before it has ever run. Headless: pair it with
+ * {@link formatElapsed} or any label of your own.
+ *
+ * For a reasoning block, prefer the duration the block already carries (`block.durationMs`, the
+ * server's own measurement) and fall back to this only while the block streams:
+ * `block.durationMs ?? elapsed`.
+ */
+export declare function useElapsed(running: boolean, options?: UseElapsedOptions): number;
+/**
+ * `"<1s"`, `"4s"`, `"1m 5s"`, `"1h 2m"` — whole units, the shape a "Thought for …" label wants.
+ * Negative or non-finite input reads as `"<1s"` rather than a nonsense figure.
+ */
+export declare function formatElapsed(ms: number): string;
+//# sourceMappingURL=timing.d.ts.map

package/dist/src/react/core/reasoning/timing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.d.ts","sourceRoot":"","sources":["../../../../../src/react/core/reasoning/timing.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,UAAU,CAAC;AAE9C,+DAA+D;AAC/D,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG;IAC9D,CAAC,sBAAsB,CAAC,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;CACnD,CAEA;AAED,qFAAqF;AACrF,wBAAgB,eAAe,CAAC,IAAI,EAAE;IAAE,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,GAAG,IAAI,CAOnF;AAED,MAAM,WAAW,iBAAiB;IAChC,kGAAkG;IAClG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,GAAE,iBAAsB,GAAG,MAAM,CAwBpF;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAShD"}

package/dist/src/react/core/reasoning/timing.js

@@ -0,0 +1,73 @@
+import { useEffect, useRef, useState } from 'react';
+/**
+ * Where a reasoning part carries how long the model thought, in ms. Both producers write it here —
+ * the transport on the live `reasoning-end` chunk, `storedMessageToUiMessage` on a replayed part —
+ * so a reader has one place to look whichever way the message arrived.
+ */
+export const REASONING_METADATA_KEY = 'agent';
+/** The `providerMetadata` a reasoning part is stamped with. */
+export function reasoningDurationMetadata(reasoningMs) {
+    return { [REASONING_METADATA_KEY]: { reasoningMs } };
+}
+/** The thinking time stamped on a reasoning part, or `null` when it carries none. */
+export function readReasoningMs(part) {
+    const metadata = part.providerMetadata;
+    if (typeof metadata !== 'object' || metadata === null)
+        return null;
+    const scoped = metadata[REASONING_METADATA_KEY];
+    if (typeof scoped !== 'object' || scoped === null)
+        return null;
+    const value = scoped.reasoningMs;
+    return typeof value === 'number' && Number.isFinite(value) && value >= 0 ? value : null;
+}
+/**
+ * Milliseconds since `running` last turned true — ticking while it stays true, frozen at the final
+ * value once it turns false, `0` before it has ever run. Headless: pair it with
+ * {@link formatElapsed} or any label of your own.
+ *
+ * For a reasoning block, prefer the duration the block already carries (`block.durationMs`, the
+ * server's own measurement) and fall back to this only while the block streams:
+ * `block.durationMs ?? elapsed`.
+ */
+export function useElapsed(running, options = {}) {
+    const { intervalMs = 1000 } = options;
+    const nowRef = useRef(options.now ?? Date.now);
+    nowRef.current = options.now ?? Date.now;
+    const startedAt = useRef(null);
+    const [elapsed, setElapsed] = useState(0);
+    useEffect(() => {
+        if (!running) {
+            if (startedAt.current !== null) {
+                setElapsed(nowRef.current() - startedAt.current);
+                startedAt.current = null;
+            }
+            return;
+        }
+        startedAt.current = nowRef.current();
+        setElapsed(0);
+        const timer = setInterval(() => {
+            if (startedAt.current !== null)
+                setElapsed(nowRef.current() - startedAt.current);
+        }, intervalMs);
+        return () => clearInterval(timer);
+    }, [running, intervalMs]);
+    return elapsed;
+}
+/**
+ * `"<1s"`, `"4s"`, `"1m 5s"`, `"1h 2m"` — whole units, the shape a "Thought for …" label wants.
+ * Negative or non-finite input reads as `"<1s"` rather than a nonsense figure.
+ */
+export function formatElapsed(ms) {
+    if (!Number.isFinite(ms) || ms < 1000)
+        return '<1s';
+    const totalSeconds = Math.floor(ms / 1000);
+    const hours = Math.floor(totalSeconds / 3600);
+    const minutes = Math.floor((totalSeconds % 3600) / 60);
+    const seconds = totalSeconds % 60;
+    if (hours > 0)
+        return minutes > 0 ? `${hours}h ${minutes}m` : `${hours}h`;
+    if (minutes > 0)
+        return seconds > 0 ? `${minutes}m ${seconds}s` : `${minutes}m`;
+    return `${seconds}s`;
+}
+//# sourceMappingURL=timing.js.map

package/dist/src/react/core/reasoning/timing.js.map

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

package/dist/src/react/core/run-errors.d.ts

@@ -0,0 +1,37 @@
+import type { AgentRequestError } from './http-error.js';
+/**
+ * The `code`s this library's own loop closes a failed run's stream with (`event: error`). A client
+ * branches on the code and words the failure itself — the frame's `message` is a sentence in
+ * English, and for a crash deliberately a generic one.
+ *
+ *  - `quota_exceeded` — the actor's budget is spent; `message` says which.
+ *  - `output_rejected` — an output processor refused the answer.
+ *  - `structured_output_invalid` — the answer never satisfied the agent's output schema.
+ *  - `replay_diverged` — the durable runtime refused to resume the run (its journal and the
+ *    deployed code disagree). The turn is over; sending again starts a new one.
+ *  - `model_no_output` — a model call ended without producing anything.
+ *  - `run_failed` — anything else.
+ *
+ * A host's own runner may send codes of its own, which is why {@link AgentRunFailure.code} is a
+ * plain string.
+ */
+export declare const AGENT_RUN_ERROR_CODES: readonly ['quota_exceeded', 'output_rejected', 'structured_output_invalid', 'replay_diverged', 'model_no_output', 'run_failed'];
+export type AgentRunErrorCode = (typeof AGENT_RUN_ERROR_CODES)[number];
+/** How a run's stream said it failed: the `event: error` frame, read. */
+export interface AgentRunFailure {
+    /** The frame's machine-readable `code`; `undefined` when the server sent none. */
+    code: AgentRunErrorCode | (string & {}) | undefined;
+    /** The frame's `message` — the server's words, safe to show but not translated. */
+    message: string;
+    /** The run that failed, when the stream had named it. */
+    runId?: string;
+}
+/** The `code` a decision is refused with when the run it was for has ended (`409`). */
+export declare const RUN_NOT_ACTIVE_CODE = "run_not_active";
+/**
+ * Whether `error` is the server refusing an approve / reject / answer / skip because the turn that
+ * asked is over (`409 { code: 'run_not_active' }`): nothing is waiting for the decision, and nothing
+ * will run. The card it was made on is stale — say so, and let the person send the message again.
+ */
+export declare function isRunNotActiveError(error: unknown): error is AgentRequestError;
+//# sourceMappingURL=run-errors.d.ts.map

package/dist/src/react/core/run-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-errors.d.ts","sourceRoot":"","sources":["../../../../src/react/core/run-errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,qBAAqB,YAChC,gBAAgB,EAChB,iBAAiB,EACjB,2BAA2B,EAC3B,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,CACJ,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvE,yEAAyE;AACzE,MAAM,WAAW,eAAe;IAC9B,kFAAkF;IAClF,IAAI,EAAE,iBAAiB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,GAAG,SAAS,CAAC;IACpD,mFAAmF;IACnF,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,uFAAuF;AACvF,eAAO,MAAM,mBAAmB,mBAAmB,CAAC;AAEpD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,iBAAiB,CAM9E"}

package/dist/src/react/core/run-errors.js

@@ -0,0 +1,37 @@
+/**
+ * The `code`s this library's own loop closes a failed run's stream with (`event: error`). A client
+ * branches on the code and words the failure itself — the frame's `message` is a sentence in
+ * English, and for a crash deliberately a generic one.
+ *
+ *  - `quota_exceeded` — the actor's budget is spent; `message` says which.
+ *  - `output_rejected` — an output processor refused the answer.
+ *  - `structured_output_invalid` — the answer never satisfied the agent's output schema.
+ *  - `replay_diverged` — the durable runtime refused to resume the run (its journal and the
+ *    deployed code disagree). The turn is over; sending again starts a new one.
+ *  - `model_no_output` — a model call ended without producing anything.
+ *  - `run_failed` — anything else.
+ *
+ * A host's own runner may send codes of its own, which is why {@link AgentRunFailure.code} is a
+ * plain string.
+ */
+export const AGENT_RUN_ERROR_CODES = [
+    'quota_exceeded',
+    'output_rejected',
+    'structured_output_invalid',
+    'replay_diverged',
+    'model_no_output',
+    'run_failed',
+];
+/** The `code` a decision is refused with when the run it was for has ended (`409`). */
+export const RUN_NOT_ACTIVE_CODE = 'run_not_active';
+/**
+ * Whether `error` is the server refusing an approve / reject / answer / skip because the turn that
+ * asked is over (`409 { code: 'run_not_active' }`): nothing is waiting for the decision, and nothing
+ * will run. The card it was made on is stale — say so, and let the person send the message again.
+ */
+export function isRunNotActiveError(error) {
+    return (error instanceof Error &&
+        error.status === 409 &&
+        error.code === RUN_NOT_ACTIVE_CODE);
+}
+//# sourceMappingURL=run-errors.js.map

package/dist/src/react/core/run-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-errors.js","sourceRoot":"","sources":["../../../../src/react/core/run-errors.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,gBAAgB;IAChB,iBAAiB;IACjB,2BAA2B;IAC3B,iBAAiB;IACjB,iBAAiB;IACjB,YAAY;CACJ,CAAC;AAcX,uFAAuF;AACvF,MAAM,CAAC,MAAM,mBAAmB,GAAG,gBAAgB,CAAC;AAEpD;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,OAAO,CACL,KAAK,YAAY,KAAK;QACrB,KAAoC,CAAC,MAAM,KAAK,GAAG;QACnD,KAAoC,CAAC,IAAI,KAAK,mBAAmB,CACnE,CAAC;AACJ,CAAC"}

package/dist/src/react/core/stored-message-to-ui-message.d.ts

@@ -0,0 +1,4 @@
+import type { UIMessage } from 'ai';
+import type { StoredMessage } from './client-wire.js';
+export declare function storedMessageToUiMessage(message: StoredMessage): UIMessage;
+//# sourceMappingURL=stored-message-to-ui-message.d.ts.map

package/dist/src/react/core/stored-message-to-ui-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stored-message-to-ui-message.d.ts","sourceRoot":"","sources":["../../../../src/react/core/stored-message-to-ui-message.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAGpC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AA+DtD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,aAAa,GAAG,SAAS,CAmK1E"}

package/dist/src/react/core/stored-message-to-ui-message.js

@@ -0,0 +1,216 @@
+import { DEFAULT_REFUSAL_REASON } from '../../refusal.js';
+import { reasoningDurationMetadata } from './reasoning/timing.js';
+/**
+ * Convert a persisted `StoredMessage` (the agent-lib's on-disk shape) into an AI SDK v7
+ * `UIMessage` so a loaded thread can seed `useChat`'s `initialMessages` / `messages`.
+ *
+ * The lib stores a message as flat `content` text plus `toolCalls`/`toolResults` arrays; the SDK
+ * renders from `parts`. This maps, in this order:
+ *   - `reasoning`          → a `reasoning` part (state `done`) BEFORE the text, as it streamed; its
+ *                            `reasoningMs` rides `providerMetadata.agent.reasoningMs`, where the
+ *                            live transport stamps it too.
+ *   - `content`            → a single `text` part (skipped when empty).
+ *   - each `attachment`    → a `file` part (image/PDF) so the user bubble re-renders its
+ *                            thumbnails on a reloaded thread.
+ *   - each `ui` component  → a `data-ui` part keyed by the component id — the same part a live
+ *                            `ui` stream frame becomes.
+ *   - each `approval`      → a `data-approval-requested` part keyed by the call id (who decides,
+ *                            until when) and, once decided, a `data-approval-settled` one — the
+ *                            same parts the live `approval-requested`/`approval-settled` frames
+ *                            become, so the transcript folds both into `call.approval` either way.
+ *   - each `toolCall`      → a `tool-<name>` part, pairing its `toolResult` (matched by id):
+ *       - a result found   → `output-available` state, carrying `output`; `output-denied` when a
+ *                            person declined it; `output-error` (carrying `errorText`) when it
+ *                            failed — the states the live stream leaves the part in.
+ *       - no result found  → `input-available` state (the call never finished, e.g. the run was
+ *                            interrupted) — `output` is omitted, never a fabricated value.
+ *     When the store reports the tool's kind (`'read' | 'action'`), it rides along as
+ *     `toolMetadata.toolKind` so a UI can render an approval affordance for `action` tools
+ *     without hardcoding tool-name sets, matching how live-streamed tool parts carry it.
+ *
+ * Live streaming still arrives as fully-typed SDK tool parts (see `AgentChatTransport`); this
+ * converter only feeds replayed history, so the tool cards render the same either way.
+ */
+/**
+ * Did a person decline this call? `denied` is what the loop sets today. The `output.rejected` shape
+ * is how a refusal was recorded before that flag existed, and threads holding those are still read
+ * back — so both count, and a thread from either era reloads as the same part.
+ */
+function isRefusal(result) {
+    if (result.denied === true) {
+        return true;
+    }
+    const { output } = result;
+    return (output !== null &&
+        typeof output === 'object' &&
+        'rejected' in output &&
+        output.rejected === true);
+}
+/** The reason given when declining, when one was given. */
+function refusalReason(result) {
+    const { output } = result;
+    if (output !== null && typeof output === 'object' && 'reason' in output) {
+        const reason = output.reason;
+        return typeof reason === 'string' && reason !== DEFAULT_REFUSAL_REASON ? reason : undefined;
+    }
+    return undefined;
+}
+export function storedMessageToUiMessage(message) {
+    const parts = [];
+    if (message.reasoning) {
+        parts.push({
+            type: 'reasoning',
+            text: message.reasoning,
+            state: 'done',
+            ...(message.reasoningMs !== undefined
+                ? { providerMetadata: reasoningDurationMetadata(message.reasoningMs) }
+                : {}),
+        });
+    }
+    if (message.content) {
+        parts.push({ type: 'text', text: message.content });
+    }
+    for (const attachment of message.attachments ?? []) {
+        parts.push({
+            type: 'file',
+            mediaType: attachment.contentType,
+            filename: attachment.name,
+            url: attachment.url,
+            // The stored id rides along, so a replayed file can be referenced again (`messageFiles`).
+            providerMetadata: { agent: { mediaId: attachment.mediaId } },
+        });
+    }
+    // A component a tool pushed (`toolCallId`) goes right after that call's tool part, where the live
+    // stream put it; the rest keep their place ahead of the calls.
+    const toolCallIds = new Set((message.toolCalls ?? []).map((call) => call.id));
+    const pushedByCall = new Map();
+    for (const component of message.ui ?? []) {
+        const part = {
+            type: 'data-ui',
+            id: component.id,
+            data: {
+                id: component.id,
+                component: component.component,
+                props: component.props,
+                ...(component.componentVersions !== undefined
+                    ? { componentVersions: component.componentVersions }
+                    : {}),
+                ...(component.fallbackText !== undefined ? { fallbackText: component.fallbackText } : {}),
+                ...(component.version !== undefined ? { version: component.version } : {}),
+                ...(component.toolCallId !== undefined ? { toolCallId: component.toolCallId } : {}),
+            },
+        };
+        if (component.toolCallId !== undefined && toolCallIds.has(component.toolCallId)) {
+            const list = pushedByCall.get(component.toolCallId) ?? [];
+            list.push(part);
+            pushedByCall.set(component.toolCallId, list);
+        }
+        else {
+            parts.push(part);
+        }
+    }
+    for (const approval of message.approvals ?? []) {
+        parts.push({
+            type: 'data-approval-requested',
+            id: approval.toolCallId,
+            data: {
+                id: approval.toolCallId,
+                approver: approval.approver,
+                ...(approval.target !== undefined
+                    ? { target: approval.target }
+                    : approval.proposalId !== undefined
+                        ? { target: { kind: 'proposal', proposalId: approval.proposalId } }
+                        : {}),
+                ...(approval.confirmation !== undefined ? { confirmation: approval.confirmation } : {}),
+                ...(approval.expiresAt !== undefined ? { expiresAt: approval.expiresAt } : {}),
+            },
+        });
+        if (approval.status !== 'pending') {
+            parts.push({
+                type: 'data-approval-settled',
+                id: approval.toolCallId,
+                data: {
+                    id: approval.toolCallId,
+                    status: approval.status,
+                    ...(approval.decidedBy !== undefined ? { decidedBy: approval.decidedBy } : {}),
+                    ...(approval.decidedVia !== undefined ? { decidedVia: approval.decidedVia } : {}),
+                    ...(approval.remember === true ? { remember: true } : {}),
+                    ...(approval.reason !== undefined ? { reason: approval.reason } : {}),
+                },
+            });
+        }
+    }
+    for (const call of message.toolCalls ?? []) {
+        const result = message.toolResults?.find((candidate) => candidate.id === call.id);
+        // `call.kind` — the store's `'read' | 'action'` classification, once it lands there
+        // (parallel to `RecordToolCallInput.toolType` and the stream's `toolKind`).
+        const toolKind = call.kind;
+        // `parentId` nests a replayed call under its parent, as the live frames did.
+        const toolMetadata = {
+            ...(toolKind !== undefined ? { toolKind } : {}),
+            ...(call.parentId !== undefined ? { parentId: call.parentId } : {}),
+        };
+        parts.push({
+            type: `tool-${call.name}`,
+            toolCallId: call.id,
+            ...(Object.keys(toolMetadata).length > 0 ? { toolMetadata } : {}),
+            ...(result !== undefined
+                ? isRefusal(result)
+                    ? {
+                        // A declined action is NOT an available output. Reloading a thread used to bring one
+                        // back as `output-available` carrying `{ rejected: true }`, which a card reads as a
+                        // result — so the action a person refused was drawn, after a refresh, as one that
+                        // had been carried out.
+                        state: 'output-denied',
+                        input: call.input,
+                        approval: {
+                            id: call.id,
+                            approved: false,
+                            ...(refusalReason(result) !== undefined
+                                ? { reason: refusalReason(result) }
+                                : {}),
+                        },
+                    }
+                    : typeof result.error === 'string' && result.error !== ''
+                        ? {
+                            // A call that FAILED — the tool threw, its input was refused, or its turn died
+                            // before it was settled — is not an available output either. The live stream says
+                            // so with `tool-output-error`; a reloaded thread has to say the same, or the card of
+                            // an action that never ran comes back reading as one that completed.
+                            state: 'output-error',
+                            input: call.input,
+                            errorText: result.error,
+                        }
+                        : { state: 'output-available', input: call.input, output: result.output }
+                : { state: 'input-available', input: call.input }),
+        });
+        parts.push(...(pushedByCall.get(call.id) ?? []));
+    }
+    const metadata = {
+        // The host's own facts first: the library's keys win on a clash.
+        ...message.metadata,
+        ...(message.actionProposalOutcome === undefined
+            ? {}
+            : { actionProposalOutcomeId: message.actionProposalOutcome.id }),
+        ...(message.feedback !== undefined ? { feedback: message.feedback } : {}),
+        ...(message.createdAt ? { createdAt: message.createdAt } : {}),
+        ...(message.agentName !== undefined ? { agentName: message.agentName } : {}),
+        ...(message.persona !== undefined ? { persona: message.persona } : {}),
+        ...(message.usage !== undefined
+            ? {
+                usage: {
+                    inputTokens: message.usage.inputTokens,
+                    outputTokens: message.usage.outputTokens,
+                    costUsd: message.usage.costUsd ?? null,
+                },
+            }
+            : {}),
+    };
+    return {
+        id: message.id,
+        role: message.role,
+        parts,
+        ...(Object.keys(metadata).length > 0 ? { metadata } : {}),
+    };
+}
+//# sourceMappingURL=stored-message-to-ui-message.js.map

package/dist/src/react/core/stored-message-to-ui-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stored-message-to-ui-message.js","sourceRoot":"","sources":["../../../../src/react/core/stored-message-to-ui-message.ts"],"names":[],"mappings":"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"}

package/dist/src/react/core/stored-thread-to-ui-messages.d.ts

@@ -0,0 +1,82 @@
+import type { UIMessage } from 'ai';
+import type { MessageFeedback } from '../../index.js';
+import type { StoredMessage } from './client-wire.js';
+/**
+ * Summed usage/cost across the stored-message rows merged into one turn (see
+ * {@link storedThreadToUiMessages}). Mirrors `MessageUsage`, but `costUsd` is always present
+ * (never omitted) since it's a computed aggregate, not a single provider report.
+ */
+export interface AggregatedTurnUsage {
+    inputTokens: number;
+    outputTokens: number;
+    /**
+     * `null` only when EVERY merged row reports a null/absent cost (no pricing store bound, or an
+     * unpriced model) — same "unknown, not a real $0" distinction `MessageUsage.costUsd` makes for a
+     * single row. A null cost on SOME rows (mixed with priced ones) contributes `0` to the sum
+     * instead of poisoning the whole turn's total to `null` — the tokens are still real and summed
+     * either way, so only the cost figure would be understated, never wrong in a "$0 turn" sense.
+     */
+    costUsd: number | null;
+}
+/** Metadata the grouped `UIMessage` carries on `.metadata.usage` — see {@link AggregatedTurnUsage}. */
+export interface StoredTurnMetadata {
+    usage: AggregatedTurnUsage;
+}
+/**
+ * Everything a message's `metadata` may carry from this library: `usage` on a merged replayed turn,
+ * `feedback` on a replayed message that was rated (a merged turn is rated through its last row,
+ * whose id it carries), `runId` on a live-streamed one, `costUsd` from the stream's step ends.
+ */
+export interface AgentMessageMetadata extends Partial<StoredTurnMetadata> {
+    feedback?: MessageFeedback;
+    runId?: string;
+    costUsd?: number | null;
+    /** ISO timestamp: the stored row's `createdAt` (a merged turn: its first row's), or when a live turn started streaming. */
+    createdAt?: string;
+    /** The agent that wrote a replayed message, when the row names one (`StoredMessage.agentName`). */
+    agentName?: string;
+    /** The persona the turn that wrote a replayed message ran under (`StoredMessage.persona`). */
+    persona?: string;
+    /** Host-defined keys: `StoredMessage.metadata` and the stream's `message-metadata` frames. */
+    [key: string]: unknown;
+}
+/**
+ * Convert a thread's full `StoredMessage[]` history into `UIMessage[]`, merging consecutive
+ * assistant rows (no user message between them) into ONE `UIMessage` per turn.
+ *
+ * Why: the agent loop persists one row per model iteration (see `agent-loop.ts`'s per-step
+ * `persist:assistant:${i}`) — a turn with tool calls appends "I'll check that..." + tool calls,
+ * then a separate final-answer row. `storedMessageToUiMessage` maps 1:1, so a reloaded thread
+ * renders 2-3 assistant bubbles (each with its own cost/tokens footer) for what the LIVE stream
+ * renders as one continuous response (one `UIMessage`, stepped internally — see
+ * `AgentChatTransport.toChunkStream`'s `start-step`/`finish-step` bracketing). This closes that gap
+ * for replayed history.
+ *
+ * Merge shape: each row is mapped via `storedMessageToUiMessage` (unchanged — same text-then-tool
+ * part ordering per row) and the parts are concatenated in row order, so the grouped message's parts
+ * read as `[row1 text?, row1 tools?, row2 text?, row2 tools?, ...]` — exactly the sequence the live
+ * transport streams for the same turn. The group's `id` is the LAST row's id (the final-answer row —
+ * it's the one carrying `followUps`, and what a host keys turn-level actions like "fork" or
+ * "regenerate" on). Non-assistant rows (user/system) pass through `storedMessageToUiMessage`
+ * unchanged, one row → one message, same as today.
+ *
+ * A lone assistant row between two user rows (the common case: no tool calls, or already a single
+ * iteration) has nothing to merge with, so it comes back byte-for-byte identical to calling
+ * `storedMessageToUiMessage` directly — no `metadata` is added for that case either, preserving
+ * exact backward compatibility for hosts that read stored usage some other way.
+ *
+ * Only an ACTUAL merge (2+ rows) attaches `metadata.usage` — the {@link AggregatedTurnUsage} summed
+ * across the merged rows' `usage` (rows without a `usage` at all, e.g. an older/test fixture, are
+ * skipped rather than treated as zero-and-priced).
+ *
+ * Deliberately NOT reproduced: the live transport's `{type: 'step-start'}` UI parts (one per model
+ * call, emitted by the AI SDK for every `start-step` chunk — see `repro-real-frames.spec.ts` for a
+ * captured wire dump). Those are structural brackets `MessageItem`'s `renderBlocks` never renders
+ * (it draws only text, reasoning, files and tool blocks), and `storedMessageToUiMessage` has never
+ * emitted them for a single row either — inventing them here would make a merged turn diverge from
+ * a same-shaped unmerged one instead of converging on it. "Indistinguishable from the live stream"
+ * is scoped to what actually renders: the text/tool-call content in step order, not the step
+ * brackets around it.
+ */
+export declare function storedThreadToUiMessages(messages: StoredMessage[]): UIMessage[];
+//# sourceMappingURL=stored-thread-to-ui-messages.d.ts.map

package/dist/src/react/core/stored-thread-to-ui-messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stored-thread-to-ui-messages.d.ts","sourceRoot":"","sources":["../../../../src/react/core/stored-thread-to-ui-messages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGtD;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB;;;;;;OAMG;IACH,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,uGAAuG;AACvG,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,mBAAmB,CAAC;CAC5B;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAqB,SAAQ,OAAO,CAAC,kBAAkB,CAAC;IACvE,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,2HAA2H;IAC3H,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mGAAmG;IACnG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8FAA8F;IAC9F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8FAA8F;IAC9F,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,SAAS,EAAE,CAiB/E"}