@adonis-agora/agent 0.61.0 → 0.63.0

package/dist/src/ag-ui/core/stream.js

@@ -0,0 +1,90 @@
+import { AgUiEncoder } from './encoder.js';
+/** The run's own sequence number of each source frame tagged by {@link withFrameSeq}. */
+const frameSeqs = new WeakMap();
+/**
+ * Tag a source frame with the run's own sequence number through it — the SSE `id:` of the last
+ * event the native stream writes for it — for {@link AgUiStreamOptions.cursor}.
+ */
+export function withFrameSeq(frame, seq) {
+    frameSeqs.set(frame, seq);
+    return frame;
+}
+/** The run's own sequence number of a frame tagged by {@link withFrameSeq}, if any. */
+export function frameSeq(frame) {
+    return frameSeqs.get(frame);
+}
+const DEFAULT_QUIET_MS = 750;
+const GRACE_MS = 50;
+/**
+ * One AG-UI run over a library run's stream.
+ *
+ * AG-UI has no mid-run channel from the consumer: a run that needs an approval or an answer does not
+ * wait with the connection open — it ENDS, saying what it waits for, and a later run carries the
+ * answers. The library run underneath does wait (parked, durably when the runner is durable). So this
+ * stops reading when the run is waiting on someone and nothing else is moving, closes the AG-UI run
+ * with the interrupt outcome, and leaves the library run parked for the resume to pick up.
+ */
+export async function* agUiEvents(frames, options) {
+    const encoder = new AgUiEncoder(options);
+    const quietMs = options.quietMs ?? DEFAULT_QUIET_MS;
+    yield* encoder.start();
+    yield* options.preamble ?? [];
+    const iterator = frames[Symbol.asyncIterator]();
+    let upcoming;
+    let ended = false;
+    try {
+        for (;;) {
+            upcoming ??= iterator.next();
+            // Frames buffered before this reader attached are replayed without a pause between them, so
+            // "is it waiting?" is only asked of a stream that has caught up with what it already holds.
+            const caughtUp = encoder.consumed >= (options.skip ?? 0);
+            let next;
+            if (caughtUp && encoder.waiting) {
+                // Nothing else in flight: only a frame already on its way (a sink that reads in batches)
+                // can still arrive, so a short grace is enough. Otherwise wait out the quiet window.
+                next = await raceQuiet(upcoming, encoder.busy ? quietMs : Math.min(quietMs, GRACE_MS));
+            }
+            else {
+                next = await upcoming;
+            }
+            if (next === 'quiet')
+                break;
+            upcoming = undefined;
+            if (next.done === true) {
+                ended = true;
+                break;
+            }
+            if (options.cursor !== undefined) {
+                options.cursor.seq = frameSeq(next.value) ?? options.cursor.seq;
+            }
+            yield* encoder.encode(next.value);
+        }
+    }
+    finally {
+        // Stop following the library stream; the run it carries is left exactly as it is.
+        void iterator.return?.();
+    }
+    yield* encoder.finish(ended);
+}
+function raceQuiet(upcoming, ms) {
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => resolve('quiet'), ms);
+        upcoming.then((result) => {
+            clearTimeout(timer);
+            resolve(result);
+        }, (error) => {
+            clearTimeout(timer);
+            reject(error);
+        });
+    });
+}
+/**
+ * One AG-UI event as an SSE frame: a single `data:` line, LF-terminated, as the binding pins. With a
+ * positive `id`, an SSE `id:` line first — the run's sequence number ({@link AgUiStreamOptions.cursor}),
+ * which AG-UI clients ignore and this package's React client re-attaches with.
+ */
+export function agUiSse(event, id) {
+    const head = id !== undefined && id > 0 ? `id: ${id}\n` : '';
+    return `${head}data: ${JSON.stringify(event)}\n\n`;
+}
+//# sourceMappingURL=stream.js.map

package/dist/src/ag-ui/core/stream.js.map

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

package/dist/src/ag-ui/core/types.d.ts

@@ -0,0 +1,249 @@
+import type { ActionProposalTarget } from '../../action-proposal-receipt.js';
+import type { AgentStreamEvent } from '../../stream-events.js';
+/**
+ * The slice of AG-UI 1.0 (https://docs.ag-ui.com/spec/1.0) this producer writes and reads. Typed by
+ * hand rather than imported: the agent package takes no dependency on an AG-UI SDK, and the wire
+ * shape is pinned by the protocol's own JSON Schema, which the tests validate every emitted event
+ * against (`src/ag-ui/fixtures/schema-1.0.json`).
+ *
+ * Optional members are OMITTED when there is nothing to say, never `null` — the protocol's
+ * "absent means absent" rule.
+ */
+/** The protocol version this producer declares on `RUN_STARTED`. */
+export declare const AG_UI_PROTOCOL_VERSION = "1.0";
+export type AgUiMetadata = Record<string, unknown>;
+/** One provider-and-model's token usage, in the protocol's single accounting. */
+export interface AgUiTokenUsage {
+    provider?: string;
+    model?: string;
+    /** Every prompt token, cached or not. */
+    inputTokens?: number;
+    /** Every generated token, reasoning included. */
+    outputTokens?: number;
+    totalTokens?: number;
+    /** Part of `outputTokens`. */
+    reasoningTokens?: number;
+    /** Cache reads — part of `inputTokens`. */
+    cachedInputTokens?: number;
+    /** Cache writes — part of `inputTokens`, disjoint from the reads. */
+    cacheWriteInputTokens?: number;
+}
+/** What an interrupted run is waiting for; a resume entry answers it by `id`. */
+export interface AgUiInterrupt {
+    id: string;
+    /** Open string. This producer writes `tool_approval` and `input_required`. */
+    reason: string;
+    message?: string;
+    toolCallId?: string;
+    responseSchema?: Record<string, unknown>;
+    expiresAt?: string;
+    metadata?: AgUiMetadata;
+}
+export type AgUiRunOutcome = {
+    type: 'success';
+    pendingToolCallIds?: string[];
+} | {
+    type: 'interrupt';
+    interrupts: AgUiInterrupt[];
+} | {
+    type: 'cancelled';
+};
+interface Base {
+    metadata?: AgUiMetadata;
+}
+export type AgUiEvent = (Base & {
+    type: 'RUN_STARTED';
+    threadId: string;
+    runId: string;
+    protocolVersion?: string;
+}) | (Base & {
+    type: 'RUN_FINISHED';
+    threadId: string;
+    runId: string;
+    outcome?: AgUiRunOutcome;
+    usage?: AgUiTokenUsage[];
+}) | (Base & {
+    type: 'RUN_ERROR';
+    message: string;
+    code?: string;
+    usage?: AgUiTokenUsage[];
+}) | (Base & {
+    type: 'STEP_STARTED';
+    stepName: string;
+}) | (Base & {
+    type: 'STEP_FINISHED';
+    stepName: string;
+}) | (Base & {
+    type: 'TEXT_MESSAGE_START';
+    messageId: string;
+    role: 'assistant';
+}) | (Base & {
+    type: 'TEXT_MESSAGE_CONTENT';
+    messageId: string;
+    delta: string;
+}) | (Base & {
+    type: 'TEXT_MESSAGE_END';
+    messageId: string;
+}) | (Base & {
+    type: 'REASONING_START';
+    messageId: string;
+}) | (Base & {
+    type: 'REASONING_MESSAGE_START';
+    messageId: string;
+    role: 'reasoning';
+}) | (Base & {
+    type: 'REASONING_MESSAGE_CONTENT';
+    messageId: string;
+    delta: string;
+}) | (Base & {
+    type: 'REASONING_MESSAGE_END';
+    messageId: string;
+}) | (Base & {
+    type: 'REASONING_END';
+    messageId: string;
+}) | (Base & {
+    type: 'TOOL_CALL_START';
+    toolCallId: string;
+    toolCallName: string;
+    parentMessageId?: string;
+}) | (Base & {
+    type: 'TOOL_CALL_ARGS';
+    toolCallId: string;
+    delta: string;
+}) | (Base & {
+    type: 'TOOL_CALL_END';
+    toolCallId: string;
+}) | (Base & {
+    type: 'TOOL_CALL_RESULT';
+    messageId: string;
+    toolCallId: string;
+    content: string;
+    role: 'tool';
+}) | (Base & {
+    type: 'CUSTOM';
+    name: string;
+    value: unknown;
+});
+/** Where a media part's bytes are. Closed set: an unknown `type` is malformed input. */
+export type AgUiPartSource = {
+    type: 'data';
+    value: string;
+    mimeType: string;
+} | {
+    type: 'url';
+    value: string;
+    mimeType?: string;
+} | {
+    type: 'file';
+    value: string;
+    provider?: string;
+    mimeType?: string;
+};
+export type AgUiContentPart = {
+    type: 'text';
+    text: string;
+    id?: string;
+    metadata?: unknown;
+} | {
+    type: 'image' | 'audio' | 'video' | 'document';
+    source: AgUiPartSource;
+    id?: string;
+    metadata?: unknown;
+};
+export interface AgUiMessage {
+    id: string;
+    role: string;
+    content?: string | AgUiContentPart[];
+    [key: string]: unknown;
+}
+export interface AgUiResumeEntry {
+    interruptId: string;
+    status: 'resolved' | 'cancelled';
+    payload?: unknown;
+    metadata?: AgUiMetadata;
+}
+export interface AgUiContext {
+    description: string;
+    value: string;
+}
+/** `RunAgentInput`: the one message that travels from the application to the agent. */
+export interface AgUiRunInput {
+    threadId: string;
+    runId: string;
+    protocolVersion?: string;
+    parentRunId?: string;
+    state?: unknown;
+    messages: AgUiMessage[];
+    tools?: unknown[];
+    context?: AgUiContext[];
+    forwardedProps?: unknown;
+    resume?: AgUiResumeEntry[];
+}
+/**
+ * The names of the `CUSTOM` events this producer writes for what AG-UI does not model. Prefixed, as
+ * the protocol asks of invented names; a consumer that does not know one ignores it.
+ */
+export declare const AG_UI_CUSTOM: {
+    /** `{ runId, threadId }` — the library's own ids for the run behind this stream (cancel, re-attach). */
+    readonly run: 'agora.run';
+    /** A generative-UI component (`AgentUiComponent`); a repeat `id` replaces. */
+    readonly ui: 'agora.ui';
+    readonly title: 'agora.title';
+    readonly queue: 'agora.queue';
+    /** The approval request as the native protocol carries it, for a consumer that renders it live. */
+    readonly approvalRequested: 'agora.approval-requested';
+    readonly approvalSettled: 'agora.approval-settled';
+    /** `{ id, runId, request }` — the whole question set of an elicitation (`ElicitationRequest`). */
+    readonly elicitation: 'agora.elicitation';
+    /** `{ usage, costUsd, reasoningMs, model }` of one model step, right after its `STEP_FINISHED`. */
+    readonly stepUsage: 'agora.step-usage';
+    /** `{ message }` — input material this producer could not use and dropped. */
+    readonly warning: 'agora.warning';
+    /** `{ threadId, proposalDecision }` — a message decided an independent proposal instead of a run. */
+    readonly actionProposalDecision: 'agora.action-proposal-decision';
+};
+/**
+ * What the encoder reads: one frame of a run's stream, in the shared vocabulary
+ * ({@link AgentStreamEvent}) — plus the terminal failure, which the NestJS sink throws and the
+ * Adonis sink writes as a frame, and three optional facts a sink may know about a parked call:
+ *  - `runId` — the run that is PARKED, when it is not the one whose stream this is (a delegated
+ *    sub-agent forwards its frames into its ancestor's stream). Absent → the stream's own run.
+ *  - `toolName`, `input` — the call being approved. Absent → read off the call's announcement.
+ *  - `target` — the independent proposal the approval decides (`actionApprovalMode: 'independent'`).
+ *    Absent → an ordinary parked approval.
+ *
+ * Framework-free on purpose: both servers project their own sink onto this and share one encoder.
+ */
+export type AgUiSourceFrame = Exclude<AgentStreamEvent, {
+    kind: 'approval-requested';
+} | {
+    kind: 'elicitation';
+} | {
+    kind: 'ui';
+}> | (Extract<AgentStreamEvent, {
+    kind: 'approval-requested';
+}> & {
+    runId?: string;
+    toolName?: string;
+    input?: unknown;
+    target?: ActionProposalTarget;
+}) | (Extract<AgentStreamEvent, {
+    kind: 'elicitation';
+}> & {
+    runId?: string;
+})
+/** A component with no `id` is numbered by its position in the stream (`ui:<n>`). */
+ | (Omit<Extract<AgentStreamEvent, {
+    kind: 'ui';
+}>, 'id' | 'props'> & {
+    id?: string;
+    props: unknown;
+})
+/** The run failed: the AG-UI run ends with `RUN_ERROR`, and nothing follows it. */
+ | {
+    kind: 'error';
+    code: string;
+    message: string;
+};
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/src/ag-ui/core/types.d.ts.map

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

package/dist/src/ag-ui/core/types.js

@@ -0,0 +1,35 @@
+/**
+ * The slice of AG-UI 1.0 (https://docs.ag-ui.com/spec/1.0) this producer writes and reads. Typed by
+ * hand rather than imported: the agent package takes no dependency on an AG-UI SDK, and the wire
+ * shape is pinned by the protocol's own JSON Schema, which the tests validate every emitted event
+ * against (`src/ag-ui/fixtures/schema-1.0.json`).
+ *
+ * Optional members are OMITTED when there is nothing to say, never `null` — the protocol's
+ * "absent means absent" rule.
+ */
+/** The protocol version this producer declares on `RUN_STARTED`. */
+export const AG_UI_PROTOCOL_VERSION = '1.0';
+/**
+ * The names of the `CUSTOM` events this producer writes for what AG-UI does not model. Prefixed, as
+ * the protocol asks of invented names; a consumer that does not know one ignores it.
+ */
+export const AG_UI_CUSTOM = {
+    /** `{ runId, threadId }` — the library's own ids for the run behind this stream (cancel, re-attach). */
+    run: 'agora.run',
+    /** A generative-UI component (`AgentUiComponent`); a repeat `id` replaces. */
+    ui: 'agora.ui',
+    title: 'agora.title',
+    queue: 'agora.queue',
+    /** The approval request as the native protocol carries it, for a consumer that renders it live. */
+    approvalRequested: 'agora.approval-requested',
+    approvalSettled: 'agora.approval-settled',
+    /** `{ id, runId, request }` — the whole question set of an elicitation (`ElicitationRequest`). */
+    elicitation: 'agora.elicitation',
+    /** `{ usage, costUsd, reasoningMs, model }` of one model step, right after its `STEP_FINISHED`. */
+    stepUsage: 'agora.step-usage',
+    /** `{ message }` — input material this producer could not use and dropped. */
+    warning: 'agora.warning',
+    /** `{ threadId, proposalDecision }` — a message decided an independent proposal instead of a run. */
+    actionProposalDecision: 'agora.action-proposal-decision',
+};
+//# sourceMappingURL=types.js.map

package/dist/src/ag-ui/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/ag-ui/core/types.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AAEH,oEAAoE;AACpE,MAAM,CAAC,MAAM,sBAAsB,GAAG,KAAK,CAAC;AA+H5C;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,wGAAwG;IACxG,GAAG,EAAE,WAAW;IAChB,8EAA8E;IAC9E,EAAE,EAAE,UAAU;IACd,KAAK,EAAE,aAAa;IACpB,KAAK,EAAE,aAAa;IACpB,mGAAmG;IACnG,iBAAiB,EAAE,0BAA0B;IAC7C,eAAe,EAAE,wBAAwB;IACzC,kGAAkG;IAClG,WAAW,EAAE,mBAAmB;IAChC,mGAAmG;IACnG,SAAS,EAAE,kBAAkB;IAC7B,8EAA8E;IAC9E,OAAO,EAAE,eAAe;IACxB,qGAAqG;IACrG,sBAAsB,EAAE,gCAAgC;CAChD,CAAC"}

package/dist/src/ag-ui/encoder.d.ts

@@ -1,13 +1,12 @@
-import { type AgUiEncoderOptions, type AgUiEvent } from '@dudousxd/nestjs-agent-core/ag-ui';
 import type { StreamFrame } from '../spi/token-stream-sink.js';
+import { type AgUiEncoderOptions, type AgUiEvent } from './core/index.js';
 export type { AgUiEncoderOptions };
 /**
- * The shared AG-UI encoder (`@dudousxd/nestjs-agent-core/ag-ui`, one implementation for both
- * servers), reading this package's {@link StreamFrame}s. A pure state machine: the same frames
+ * The local AG-UI encoder, reading this package's {@link StreamFrame}s. A pure state machine: the same frames
  * always give the same events.
  */
 export declare class AgUiEncoder {
-    private readonly shared;
+    private readonly core;
     constructor(options: AgUiEncoderOptions);
     /** How many frames of the library stream this encoder has consumed. */
     get consumed(): number;

package/dist/src/ag-ui/encoder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"encoder.d.ts","sourceRoot":"","sources":["../../../src/ag-ui/encoder.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,SAAS,EAEf,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAG/D,YAAY,EAAE,kBAAkB,EAAE,CAAC;AAEnC;;;;GAIG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IAEvC,YAAY,OAAO,EAAE,kBAAkB,EAEtC;IAED,uEAAuE;IACvE,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,0FAA0F;IAC1F,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,wFAAwF;IACxF,IAAI,IAAI,IAAI,OAAO,CAElB;IAED,KAAK,IAAI,SAAS,EAAE,CAEnB;IAED,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,EAAE,CAEtC;IAED,MAAM,CAAC,KAAK,UAAQ,GAAG,SAAS,EAAE,CAEjC;CACF"}
+{"version":3,"file":"encoder.d.ts","sourceRoot":"","sources":["../../../src/ag-ui/encoder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,SAAS,EAEf,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EAAE,kBAAkB,EAAE,CAAC;AAEnC;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAc;IAEnC,YAAY,OAAO,EAAE,kBAAkB,EAEtC;IAED,uEAAuE;IACvE,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,0FAA0F;IAC1F,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,wFAAwF;IACxF,IAAI,IAAI,IAAI,OAAO,CAElB;IAED,KAAK,IAAI,SAAS,EAAE,CAEnB;IAED,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,EAAE,CAEtC;IAED,MAAM,CAAC,KAAK,UAAQ,GAAG,SAAS,EAAE,CAEjC;CACF"}

package/dist/src/ag-ui/encoder.js

@@ -1,35 +1,34 @@
-import { AgUiEncoder as SharedEncoder, } from '@dudousxd/nestjs-agent-core/ag-ui';
+import { AgUiEncoder as CoreEncoder, } from './core/index.js';
 import { toAgUiFrame } from './frames.js';
 /**
- * The shared AG-UI encoder (`@dudousxd/nestjs-agent-core/ag-ui`, one implementation for both
- * servers), reading this package's {@link StreamFrame}s. A pure state machine: the same frames
+ * The local AG-UI encoder, reading this package's {@link StreamFrame}s. A pure state machine: the same frames
  * always give the same events.
  */
 export class AgUiEncoder {
-    shared;
+    core;
     constructor(options) {
-        this.shared = new SharedEncoder(options);
+        this.core = new CoreEncoder(options);
     }
     /** How many frames of the library stream this encoder has consumed. */
     get consumed() {
-        return this.shared.consumed;
+        return this.core.consumed;
     }
     /** The run is waiting on at least one approval or question set nobody has settled yet. */
     get waiting() {
-        return this.shared.waiting;
+        return this.core.waiting;
     }
     /** A tool call is announced and neither answered nor parked: more frames are coming. */
     get busy() {
-        return this.shared.busy;
+        return this.core.busy;
     }
     start() {
-        return this.shared.start();
+        return this.core.start();
     }
     encode(frame) {
-        return this.shared.encode(toAgUiFrame(frame));
+        return this.core.encode(toAgUiFrame(frame));
     }
     finish(ended = false) {
-        return this.shared.finish(ended);
+        return this.core.finish(ended);
     }
 }
 //# sourceMappingURL=encoder.js.map

package/dist/src/ag-ui/encoder.js.map

@@ -1 +1 @@
-{"version":3,"file":"encoder.js","sourceRoot":"","sources":["../../../src/ag-ui/encoder.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,WAAW,IAAI,aAAa,GAC7B,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI1C;;;;GAIG;AACH,MAAM,OAAO,WAAW;IACL,MAAM,CAAgB;IAEvC,YAAY,OAA2B;QACrC,IAAI,CAAC,MAAM,GAAG,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED,uEAAuE;IACvE,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;IAC9B,CAAC;IAED,0FAA0F;IAC1F,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;IAC7B,CAAC;IAED,wFAAwF;IACxF,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;IAC1B,CAAC;IAED,KAAK;QACH,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IAC7B,CAAC;IAED,MAAM,CAAC,KAAkB;QACvB,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;IAChD,CAAC;IAED,MAAM,CAAC,KAAK,GAAG,KAAK;QAClB,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;CACF"}
+{"version":3,"file":"encoder.js","sourceRoot":"","sources":["../../../src/ag-ui/encoder.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,WAAW,IAAI,WAAW,GAC3B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI1C;;;GAGG;AACH,MAAM,OAAO,WAAW;IACL,IAAI,CAAc;IAEnC,YAAY,OAA2B;QACrC,IAAI,CAAC,IAAI,GAAG,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC;IAED,uEAAuE;IACvE,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;IAC5B,CAAC;IAED,0FAA0F;IAC1F,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;IAC3B,CAAC;IAED,wFAAwF;IACxF,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IACxB,CAAC;IAED,KAAK;QACH,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;IAED,MAAM,CAAC,KAAkB;QACvB,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;IAC9C,CAAC;IAED,MAAM,CAAC,KAAK,GAAG,KAAK;QAClB,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;CACF"}

package/dist/src/ag-ui/frames.d.ts

@@ -1,17 +1,20 @@
-import type { AgUiSourceFrame } from '@dudousxd/nestjs-agent-core/ag-ui';
 import type { StreamFrame } from '../spi/token-stream-sink.js';
+import { type AgUiSourceFrame } from './core/index.js';
 /**
- * One frame of this package's sink as the frame the shared AG-UI encoder reads
- * (`@dudousxd/nestjs-agent-core/ag-ui`). The typed `approval` / `elicitation` frames carry what the
- * shared vocabulary leaves optional — the PARKED run, the tool and its arguments — so an interrupt
+ * One frame of this package's sink as the frame the local AG-UI encoder reads. The typed `approval` / `elicitation` frames carry what the
+ * stream vocabulary leaves optional — the PARKED run, the tool and its arguments — so an interrupt
  * addresses a delegated sub-agent's own run.
  */
 export declare function toAgUiFrame(frame: StreamFrame): AgUiSourceFrame;
 /**
- * A library run's stream as the shared encoder's frames. A hand-rolled iterator rather than a
+ * A library run's stream as the local encoder's frames. A hand-rolled iterator rather than a
  * generator: the AG-UI driver lets go of a parked stream while a read is still pending, and a
  * generator would queue that `return()` behind the read that never comes — the sink's subscription
  * has to be released at once.
+ *
+ * Each frame is tagged ({@link withFrameSeq}) with the run's own sequence number through it — the
+ * SSE `id:` the native stream (`chat/:runId/stream`) gives its last event — so the AG-UI route can
+ * number its events the way a native re-attach (`?after=`) counts.
  */
 export declare function agUiFrames(frames: AsyncIterable<StreamFrame>): AsyncIterable<AgUiSourceFrame>;
 //# sourceMappingURL=frames.d.ts.map

package/dist/src/ag-ui/frames.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"frames.d.ts","sourceRoot":"","sources":["../../../src/ag-ui/frames.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE/D;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,eAAe,CAqC/D;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,aAAa,CAAC,WAAW,CAAC,GAAG,aAAa,CAAC,eAAe,CAAC,CAkB7F"}
+{"version":3,"file":"frames.d.ts","sourceRoot":"","sources":["../../../src/ag-ui/frames.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE/D,OAAO,EAAE,KAAK,eAAe,EAAgB,MAAM,iBAAiB,CAAC;AAErE;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,eAAe,CA0C/D;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,aAAa,CAAC,WAAW,CAAC,GAAG,aAAa,CAAC,eAAe,CAAC,CAqB7F"}

package/dist/src/ag-ui/frames.js

@@ -1,7 +1,8 @@
+import { frameToEvents } from '../sse.js';
+import { withFrameSeq } from './core/index.js';
 /**
- * One frame of this package's sink as the frame the shared AG-UI encoder reads
- * (`@dudousxd/nestjs-agent-core/ag-ui`). The typed `approval` / `elicitation` frames carry what the
- * shared vocabulary leaves optional — the PARKED run, the tool and its arguments — so an interrupt
+ * One frame of this package's sink as the frame the local AG-UI encoder reads. The typed `approval` / `elicitation` frames carry what the
+ * stream vocabulary leaves optional — the PARKED run, the tool and its arguments — so an interrupt
  * addresses a delegated sub-agent's own run.
  */
 export function toAgUiFrame(frame) {
@@ -15,6 +16,10 @@ export function toAgUiFrame(frame) {
                 props: frame.data,
                 ...(frame.id !== undefined ? { id: frame.id } : {}),
                 ...(frame.version !== undefined ? { version: frame.version } : {}),
+                ...(frame.fallbackText !== undefined ? { fallbackText: frame.fallbackText } : {}),
+                ...(frame.componentVersions !== undefined
+                    ? { componentVersions: frame.componentVersions }
+                    : {}),
                 ...(frame.toolCallId !== undefined ? { toolCallId: frame.toolCallId } : {}),
             };
         case 'approval':
@@ -25,6 +30,7 @@ export function toAgUiFrame(frame) {
                 toolName: frame.toolName,
                 input: frame.input ?? null,
                 approver: frame.approver ?? 'requester',
+                ...(frame.target !== undefined ? { target: frame.target } : {}),
                 ...(frame.confirmation !== undefined ? { confirmation: frame.confirmation } : {}),
                 ...(frame.expiresAt !== undefined ? { expiresAt: frame.expiresAt } : {}),
             };
@@ -43,21 +49,29 @@ export function toAgUiFrame(frame) {
     }
 }
 /**
- * A library run's stream as the shared encoder's frames. A hand-rolled iterator rather than a
+ * A library run's stream as the local encoder's frames. A hand-rolled iterator rather than a
  * generator: the AG-UI driver lets go of a parked stream while a read is still pending, and a
  * generator would queue that `return()` behind the read that never comes — the sink's subscription
  * has to be released at once.
+ *
+ * Each frame is tagged ({@link withFrameSeq}) with the run's own sequence number through it — the
+ * SSE `id:` the native stream (`chat/:runId/stream`) gives its last event — so the AG-UI route can
+ * number its events the way a native re-attach (`?after=`) counts.
  */
 export function agUiFrames(frames) {
     return {
         [Symbol.asyncIterator]() {
             const inner = frames[Symbol.asyncIterator]();
+            let position = 0;
+            let seq = 0;
             return {
                 next: async () => {
                     const result = await inner.next();
-                    return result.done === true
-                        ? { done: true, value: undefined }
-                        : { done: false, value: toAgUiFrame(result.value) };
+                    if (result.done === true)
+                        return { done: true, value: undefined };
+                    seq += frameToEvents(result.value, position).length;
+                    position += 1;
+                    return { done: false, value: withFrameSeq(toAgUiFrame(result.value), seq) };
                 },
                 return: async () => {
                     await inner.return?.();

package/dist/src/ag-ui/frames.js.map

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

package/dist/src/ag-ui/index.d.ts

@@ -2,13 +2,11 @@
  * AG-UI 1.0 (https://docs.ag-ui.com/spec/1.0), producer side: the route adapter, and the pieces it is
  * built from — for a host that mounts its own route instead of the provider's.
  *
- * The encoder, the input readers and the interrupt-id codec are `@dudousxd/nestjs-agent-core/ag-ui`
- * (one implementation for both servers), re-exported here; `AgUiEncoder` and `agUiEvents` take this
- * package's `StreamFrame`s. Install `@dudousxd/nestjs-agent-core` (an optional peer, 0.35 or later)
- * to use this entry.
+ * The encoder, input readers and interrupt-id codec are owned by this package.
+ * `AgUiEncoder` and `agUiEvents` adapt this package's `StreamFrame`s to AG-UI.
  */
-export { AG_UI_CUSTOM, AG_UI_PROTOCOL_VERSION, type AgUiContentPart, type AgUiContext, type AgUiEvent, type AgUiInterrupt, type AgUiMessage, type AgUiMetadata, type AgUiPartSource, type AgUiResumeEntry, type AgUiRunInput, type AgUiRunOutcome, type AgUiSourceFrame, type AgUiTokenUsage, decodeInterruptId, encodeInterruptId, type ForwardedOptions, type InlineMedia, type InterruptAddress, parseRunInput, planResume, type ResumeDecision, type ResumePlan, readAnswersPayload, readApprovalPayload, readContext, readForwardedProps, readUserTurn, type UserTurn, } from '@dudousxd/nestjs-agent-core/ag-ui';
 export { type AgUiAdapterOptions, agUiAdapter } from './adapter.js';
+export { AG_UI_CUSTOM, AG_UI_PROTOCOL_VERSION, AG_UI_STAGED_MEDIA_PROVIDER, type AgUiContentPart, type AgUiContext, type AgUiCursor, type AgUiEvent, type AgUiInterrupt, type AgUiMessage, type AgUiMetadata, type AgUiPartSource, type AgUiResumeEntry, type AgUiRunInput, type AgUiRunOutcome, type AgUiSourceFrame, type AgUiTokenUsage, decodeInterruptId, encodeInterruptId, type ForwardedOptions, type InlineMedia, type InterruptAddress, parseRunInput, planResume, type ResumeDecision, type ResumePlan, readAnswersPayload, readApprovalPayload, readContext, readForwardedProps, readUserTurn, type UserTurn, } from './core/index.js';
 export { AgUiEncoder, type AgUiEncoderOptions } from './encoder.js';
 export { agUiFrames, toAgUiFrame } from './frames.js';
 export { type AgUiStreamOptions, agUiEvents, agUiSse } from './stream.js';

package/dist/src/ag-ui/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ag-ui/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,YAAY,EACZ,sBAAsB,EACtB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,aAAa,EACb,UAAU,EACV,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,kBAAkB,EAClB,mBAAmB,EACnB,WAAW,EACX,kBAAkB,EAClB,YAAY,EACZ,KAAK,QAAQ,GACd,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,KAAK,kBAAkB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,KAAK,iBAAiB,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ag-ui/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,kBAAkB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EACL,YAAY,EACZ,sBAAsB,EACtB,2BAA2B,EAC3B,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,aAAa,EACb,UAAU,EACV,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,kBAAkB,EAClB,mBAAmB,EACnB,WAAW,EACX,kBAAkB,EAClB,YAAY,EACZ,KAAK,QAAQ,GACd,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,KAAK,iBAAiB,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC"}

package/dist/src/ag-ui/index.js

@@ -2,13 +2,11 @@
  * AG-UI 1.0 (https://docs.ag-ui.com/spec/1.0), producer side: the route adapter, and the pieces it is
  * built from — for a host that mounts its own route instead of the provider's.
  *
- * The encoder, the input readers and the interrupt-id codec are `@dudousxd/nestjs-agent-core/ag-ui`
- * (one implementation for both servers), re-exported here; `AgUiEncoder` and `agUiEvents` take this
- * package's `StreamFrame`s. Install `@dudousxd/nestjs-agent-core` (an optional peer, 0.35 or later)
- * to use this entry.
+ * The encoder, input readers and interrupt-id codec are owned by this package.
+ * `AgUiEncoder` and `agUiEvents` adapt this package's `StreamFrame`s to AG-UI.
  */
-export { AG_UI_CUSTOM, AG_UI_PROTOCOL_VERSION, decodeInterruptId, encodeInterruptId, parseRunInput, planResume, readAnswersPayload, readApprovalPayload, readContext, readForwardedProps, readUserTurn, } from '@dudousxd/nestjs-agent-core/ag-ui';
 export { agUiAdapter } from './adapter.js';
+export { AG_UI_CUSTOM, AG_UI_PROTOCOL_VERSION, AG_UI_STAGED_MEDIA_PROVIDER, decodeInterruptId, encodeInterruptId, parseRunInput, planResume, readAnswersPayload, readApprovalPayload, readContext, readForwardedProps, readUserTurn, } from './core/index.js';
 export { AgUiEncoder } from './encoder.js';
 export { agUiFrames, toAgUiFrame } from './frames.js';
 export { agUiEvents, agUiSse } from './stream.js';

package/dist/src/ag-ui/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ag-ui/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,YAAY,EACZ,sBAAsB,EAatB,iBAAiB,EACjB,iBAAiB,EAIjB,aAAa,EACb,UAAU,EAGV,kBAAkB,EAClB,mBAAmB,EACnB,WAAW,EACX,kBAAkB,EAClB,YAAY,GAEb,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAA2B,WAAW,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,WAAW,EAA2B,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAA0B,UAAU,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ag-ui/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAA2B,WAAW,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EACL,YAAY,EACZ,sBAAsB,EACtB,2BAA2B,EAc3B,iBAAiB,EACjB,iBAAiB,EAIjB,aAAa,EACb,UAAU,EAGV,kBAAkB,EAClB,mBAAmB,EACnB,WAAW,EACX,kBAAkB,EAClB,YAAY,GAEb,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,WAAW,EAA2B,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAA0B,UAAU,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC"}