@adonis-agora/agent 0.54.0 → 0.56.0

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

@@ -0,0 +1,519 @@
+import { encodeInterruptId } from './interrupt-id.js';
+import { AG_UI_CUSTOM, AG_UI_PROTOCOL_VERSION, } from './types.js';
+const APPROVAL_SCHEMA = {
+    type: 'object',
+    properties: {
+        approved: { type: 'boolean' },
+        reason: { type: 'string' },
+        remember: { type: 'boolean' },
+    },
+    required: ['approved'],
+};
+/** The answer an elicitation expects: `{ answers: { <questionId>: string[] } }`. */
+function elicitationSchema(request) {
+    const properties = {};
+    for (const question of request.questions) {
+        const options = question.options?.map((option) => option.value);
+        properties[question.id] = {
+            type: 'array',
+            title: question.prompt,
+            ...(question.description !== undefined ? { description: question.description } : {}),
+            items: options !== undefined && options.length > 0 && question.allowFreeText !== true
+                ? { type: 'string', enum: options }
+                : { type: 'string' },
+            ...(question.multiple === true ? {} : { maxItems: 1 }),
+            ...(question.defaults !== undefined ? { default: question.defaults } : {}),
+        };
+    }
+    return {
+        type: 'object',
+        properties: { answers: { type: 'object', properties } },
+        required: ['answers'],
+    };
+}
+function text(value) {
+    if (typeof value === 'string')
+        return value;
+    const json = JSON.stringify(value);
+    return json === undefined ? '' : json;
+}
+/**
+ * Projects one library run's stream ({@link StreamFrame}s, in buffer order) onto AG-UI 1.0 events.
+ *
+ * A pure state machine: the same frames always give the same events, which is what lets a resuming
+ * request — served by any replica — replay the run's buffer, skip what the interrupted AG-UI run
+ * already delivered, and continue. It writes nothing itself; {@link agUiEvents} drives it and
+ * decides when the run has stopped to ask.
+ *
+ * What maps where:
+ *  - `text` → `TEXT_MESSAGE_*` (one message per stretch of text);
+ *  - `reasoning` → a reasoning span with one reasoning message;
+ *  - `step-start`/`step-finish` → `STEP_STARTED`/`STEP_FINISHED`, the step's usage folded into the
+ *    run's `usage`;
+ *  - `tool-input-*` → `TOOL_CALL_START`/`ARGS`/`END`; `tool-output*` → `TOOL_CALL_RESULT`;
+ *  - an approval or a question set the run parks on → an `Interrupt` on the closing `RUN_FINISHED`;
+ *  - `cancelled` → the cancelled outcome; an error frame → `RUN_ERROR`;
+ *  - generative UI, title, queue and the native approval/elicitation frames → `CUSTOM` events named
+ *    in {@link AG_UI_CUSTOM}, for what AG-UI has no event for.
+ *
+ * Not mapped: sub-agent attribution (`subagentRunId`) — a delegated agent's frames are projected
+ * flat, as the protocol allows of a producer that does not attribute.
+ */
+export class AgUiEncoder {
+    options;
+    position = 0;
+    started = false;
+    closed = false;
+    cancelled = false;
+    crossed = false;
+    messageSeq = 0;
+    stepSeq = 0;
+    openText;
+    openReasoning;
+    /** The last text message of the current step: a tool call attaches to it. */
+    stepMessage;
+    openSteps = [];
+    calls = new Map();
+    pending = new Map();
+    usage = new Map();
+    constructor(options) {
+        this.options = options;
+    }
+    /** How many frames of the library stream this encoder has consumed. */
+    get consumed() {
+        return this.position;
+    }
+    /** The run is waiting on at least one approval or question set nobody has settled yet. */
+    get waiting() {
+        return this.pending.size > 0;
+    }
+    /**
+     * Is anything still in flight that is NOT waiting on a person — a tool call announced and neither
+     * answered nor parked? While there is, more frames are coming without anyone's help.
+     */
+    get busy() {
+        for (const [id, call] of this.calls) {
+            if (!call.answered && !this.pending.has(id))
+                return true;
+        }
+        return false;
+    }
+    /** `RUN_STARTED`, and the library's own ids for the run. Call once, before the first frame. */
+    start() {
+        if (this.started)
+            return [];
+        this.started = true;
+        return [
+            {
+                type: 'RUN_STARTED',
+                threadId: this.options.threadId,
+                runId: this.options.runId,
+                protocolVersion: AG_UI_PROTOCOL_VERSION,
+            },
+            {
+                type: 'CUSTOM',
+                name: AG_UI_CUSTOM.run,
+                value: {
+                    runId: this.options.streamRunId,
+                    threadId: this.options.streamThreadId ?? this.options.threadId,
+                },
+            },
+        ];
+    }
+    /** The AG-UI events the next frame of the library stream stands for (possibly none). */
+    encode(frame) {
+        const position = this.position;
+        this.position += 1;
+        if (this.closed)
+            return [];
+        const skip = this.options.skip ?? 0;
+        if (!this.crossed && position >= skip)
+            this.crossBoundary();
+        const events = this.project(frame, position);
+        // A frame an earlier AG-UI run already delivered still moves the state (what is open, what is
+        // pending; NOT what was spent — usage is per run) but writes nothing. The last of them is the
+        // boundary: crossed at once, not when the next frame happens to arrive, because a run that was
+        // just answered may take a moment to write one.
+        if (position < skip) {
+            if (this.position >= skip)
+                this.crossBoundary();
+            return [];
+        }
+        return events;
+    }
+    /**
+     * The replayed frames are behind us: from here on events are written. The AG-UI run that delivered
+     * them closed everything it had open before it finished, so this run starts with nothing open, and
+     * what the resuming request answered is no longer waiting.
+     */
+    crossBoundary() {
+        this.crossed = true;
+        this.openText = undefined;
+        this.openReasoning = undefined;
+        this.stepMessage = undefined;
+        this.openSteps.length = 0;
+        for (const call of this.calls.values()) {
+            call.started = false;
+            call.ended = true;
+        }
+        for (const id of this.options.answered ?? [])
+            this.pending.delete(id);
+    }
+    get replaying() {
+        return this.position <= (this.options.skip ?? 0);
+    }
+    project(frame, position) {
+        switch (frame.t) {
+            case 'text':
+                return frame.v.length > 0 ? this.textDelta(frame.v) : [];
+            case 'component':
+                return [
+                    this.custom(AG_UI_CUSTOM.ui, {
+                        id: frame.id ?? `ui:${position}`,
+                        component: frame.name,
+                        props: frame.data,
+                        ...(frame.version !== undefined ? { version: frame.version } : {}),
+                        ...(frame.toolCallId !== undefined ? { toolCallId: frame.toolCallId } : {}),
+                    }),
+                ];
+            case 'approval': {
+                this.pending.set(frame.id, {
+                    kind: 'approval',
+                    parked: frame.runId,
+                    toolCallId: frame.id,
+                    interrupt: {
+                        reason: 'tool_approval',
+                        message: `Approve ${frame.toolName}?`,
+                        toolCallId: frame.id,
+                        responseSchema: APPROVAL_SCHEMA,
+                        ...(frame.expiresAt !== undefined ? { expiresAt: frame.expiresAt } : {}),
+                        metadata: {
+                            'agora.toolName': frame.toolName,
+                            'agora.input': frame.input ?? null,
+                            'agora.approver': frame.approver ?? 'requester',
+                        },
+                    },
+                });
+                return [
+                    this.custom(AG_UI_CUSTOM.approvalRequested, {
+                        id: frame.id,
+                        runId: frame.runId,
+                        toolName: frame.toolName,
+                        input: frame.input ?? null,
+                        approver: frame.approver ?? 'requester',
+                        ...(frame.expiresAt !== undefined ? { expiresAt: frame.expiresAt } : {}),
+                    }),
+                ];
+            }
+            case 'elicitation': {
+                this.pending.set(frame.id, {
+                    kind: 'elicitation',
+                    parked: frame.runId,
+                    toolCallId: frame.id,
+                    interrupt: {
+                        reason: 'input_required',
+                        message: frame.request.preamble ?? frame.request.questions[0]?.prompt ?? 'Input required',
+                        // An intake's question set belongs to no tool call the stream announced.
+                        ...(this.calls.has(frame.id) ? { toolCallId: frame.id } : {}),
+                        responseSchema: elicitationSchema(frame.request),
+                        metadata: { 'agora.request': frame.request },
+                    },
+                });
+                return [
+                    this.custom(AG_UI_CUSTOM.elicitation, { runId: frame.runId, request: frame.request }),
+                ];
+            }
+            case 'error': {
+                this.closed = true;
+                const usage = this.usageEntries();
+                return [
+                    {
+                        type: 'RUN_ERROR',
+                        message: frame.message,
+                        code: frame.code,
+                        ...(usage.length > 0 ? { usage } : {}),
+                    },
+                ];
+            }
+            case 'event':
+                return this.event(frame.event);
+        }
+    }
+    event(event) {
+        switch (event.kind) {
+            case 'text':
+                return event.text.length > 0 ? this.textDelta(event.text) : [];
+            case 'reasoning':
+                return event.text.length > 0 ? this.reasoningDelta(event.text) : [];
+            case 'step-start': {
+                this.stepSeq += 1;
+                const stepName = `step-${this.stepSeq}`;
+                this.openSteps.push(stepName);
+                this.stepMessage = undefined;
+                return [...this.closeStreams(), { type: 'STEP_STARTED', stepName }];
+            }
+            case 'step-finish': {
+                const out = this.closeStreams();
+                if (!this.replaying)
+                    this.addUsage(event.usage, event.model);
+                const stepName = this.openSteps.pop();
+                if (stepName !== undefined)
+                    out.push({ type: 'STEP_FINISHED', stepName });
+                if (event.usage !== undefined || event.costUsd !== undefined) {
+                    out.push(this.custom(AG_UI_CUSTOM.stepUsage, {
+                        ...(event.usage !== undefined ? { usage: event.usage } : {}),
+                        ...(event.costUsd !== undefined ? { costUsd: event.costUsd } : {}),
+                        ...(event.reasoningMs !== undefined ? { reasoningMs: event.reasoningMs } : {}),
+                    }));
+                }
+                return out;
+            }
+            case 'tool-input-start': {
+                if (this.calls.has(event.id))
+                    return [];
+                const out = this.closeStreams();
+                this.calls.set(event.id, {
+                    name: event.name,
+                    started: true,
+                    ended: false,
+                    sawDelta: false,
+                    answered: false,
+                });
+                out.push(this.callStart(event.id, event.name));
+                return out;
+            }
+            case 'tool-input-delta': {
+                const call = this.calls.get(event.id);
+                if (call === undefined || call.ended || event.delta.length === 0)
+                    return [];
+                call.sawDelta = true;
+                return [{ type: 'TOOL_CALL_ARGS', toolCallId: event.id, delta: event.delta }];
+            }
+            case 'tool-input-available': {
+                const known = this.calls.get(event.id);
+                if (known?.ended === true)
+                    return [];
+                const out = this.closeStreams();
+                const call = known ?? {
+                    name: event.name,
+                    started: false,
+                    ended: false,
+                    sawDelta: false,
+                    answered: false,
+                };
+                if (!call.started) {
+                    call.started = true;
+                    out.push(this.callStart(event.id, event.name));
+                }
+                if (!call.sawDelta) {
+                    out.push({
+                        type: 'TOOL_CALL_ARGS',
+                        toolCallId: event.id,
+                        delta: text(event.input ?? {}),
+                    });
+                }
+                call.ended = true;
+                this.calls.set(event.id, call);
+                out.push({ type: 'TOOL_CALL_END', toolCallId: event.id });
+                return out;
+            }
+            case 'tool-output':
+                return this.result(event.id, text(event.output));
+            case 'tool-output-error':
+                return this.result(event.id, event.error, { 'agora.outcome': 'error' });
+            case 'tool-output-denied':
+                return this.result(event.id, event.reason ?? 'denied', { 'agora.outcome': 'denied' });
+            case 'approval-requested':
+                // Written by the loop as a typed `approval` frame; an event of this kind reaching the sink
+                // directly is carried as-is rather than guessed into an interrupt without its run id.
+                return [this.custom(AG_UI_CUSTOM.approvalRequested, event)];
+            case 'approval-settled':
+                this.pending.delete(event.id);
+                return [this.custom(AG_UI_CUSTOM.approvalSettled, event)];
+            case 'elicitation':
+                return [this.custom(AG_UI_CUSTOM.elicitation, { request: event.request })];
+            case 'ui': {
+                const { kind: _kind, ...component } = event;
+                return [this.custom(AG_UI_CUSTOM.ui, component)];
+            }
+            case 'title':
+                return [this.custom(AG_UI_CUSTOM.title, { title: event.title })];
+            case 'queue':
+                return [
+                    this.custom(AG_UI_CUSTOM.queue, {
+                        queue: event.queue,
+                        ...(event.started !== undefined ? { started: event.started } : {}),
+                    }),
+                ];
+            case 'cancelled':
+                this.cancelled = true;
+                return [];
+            default:
+                // A kind newer than this encoder: tolerated, as every reader of the stream must.
+                return [];
+        }
+    }
+    /**
+     * The events that end the AG-UI run: whatever is still open is closed first, then `RUN_FINISHED`
+     * with how it ended — interrupted when the run is waiting on someone, cancelled when it was
+     * stopped, success otherwise. Nothing after a `RUN_ERROR`. `ended` says the library run's stream
+     * itself ended, rather than this reader having stopped following it.
+     */
+    finish(ended = false) {
+        if (this.closed)
+            return [];
+        this.closed = true;
+        if (!this.crossed)
+            this.crossBoundary();
+        // A library run that ended is waiting on no one, whatever it asked along the way.
+        if (ended)
+            this.pending.clear();
+        const out = this.start();
+        out.push(...this.closeStreams());
+        for (const [id, call] of this.calls) {
+            if (call.started && !call.ended) {
+                call.ended = true;
+                out.push({ type: 'TOOL_CALL_END', toolCallId: id });
+            }
+        }
+        while (this.openSteps.length > 0) {
+            out.push({ type: 'STEP_FINISHED', stepName: this.openSteps.pop() });
+        }
+        const usage = this.usageEntries();
+        const interrupts = this.cancelled ? [] : this.interrupts();
+        out.push({
+            type: 'RUN_FINISHED',
+            threadId: this.options.threadId,
+            runId: this.options.runId,
+            ...(this.cancelled
+                ? { outcome: { type: 'cancelled' } }
+                : interrupts.length > 0
+                    ? { outcome: { type: 'interrupt', interrupts } }
+                    : {}),
+            ...(usage.length > 0 ? { usage } : {}),
+        });
+        return out;
+    }
+    interrupts() {
+        return [...this.pending.values()].map((entry) => ({
+            id: encodeInterruptId({
+                kind: entry.kind,
+                parked: entry.parked,
+                stream: this.options.streamRunId,
+                toolCallId: entry.toolCallId,
+                position: this.position,
+            }),
+            ...entry.interrupt,
+        }));
+    }
+    custom(name, value) {
+        return { type: 'CUSTOM', name, value };
+    }
+    nextMessageId() {
+        this.messageSeq += 1;
+        return `${this.options.runId}:m${this.messageSeq}`;
+    }
+    textDelta(delta) {
+        const out = [];
+        if (this.openReasoning !== undefined)
+            out.push(...this.closeReasoning());
+        if (this.openText === undefined) {
+            this.openText = this.nextMessageId();
+            this.stepMessage = this.openText;
+            out.push({ type: 'TEXT_MESSAGE_START', messageId: this.openText, role: 'assistant' });
+        }
+        out.push({ type: 'TEXT_MESSAGE_CONTENT', messageId: this.openText, delta });
+        return out;
+    }
+    reasoningDelta(delta) {
+        const out = [];
+        if (this.openText !== undefined)
+            out.push(...this.closeText());
+        if (this.openReasoning === undefined) {
+            this.openReasoning = this.nextMessageId();
+            out.push({ type: 'REASONING_START', messageId: this.openReasoning }, { type: 'REASONING_MESSAGE_START', messageId: this.openReasoning, role: 'reasoning' });
+        }
+        out.push({ type: 'REASONING_MESSAGE_CONTENT', messageId: this.openReasoning, delta });
+        return out;
+    }
+    closeText() {
+        if (this.openText === undefined)
+            return [];
+        const messageId = this.openText;
+        this.openText = undefined;
+        return [{ type: 'TEXT_MESSAGE_END', messageId }];
+    }
+    closeReasoning() {
+        if (this.openReasoning === undefined)
+            return [];
+        const messageId = this.openReasoning;
+        this.openReasoning = undefined;
+        return [
+            { type: 'REASONING_MESSAGE_END', messageId },
+            { type: 'REASONING_END', messageId },
+        ];
+    }
+    closeStreams() {
+        return [...this.closeReasoning(), ...this.closeText()];
+    }
+    callStart(id, name) {
+        return {
+            type: 'TOOL_CALL_START',
+            toolCallId: id,
+            toolCallName: name,
+            ...(this.stepMessage !== undefined ? { parentMessageId: this.stepMessage } : {}),
+        };
+    }
+    result(id, content, metadata) {
+        const call = this.calls.get(id);
+        if (call !== undefined)
+            call.answered = true;
+        else {
+            this.calls.set(id, {
+                name: '',
+                started: false,
+                ended: true,
+                sawDelta: false,
+                answered: true,
+            });
+        }
+        this.pending.delete(id);
+        return [
+            ...this.closeStreams(),
+            {
+                type: 'TOOL_CALL_RESULT',
+                messageId: `${this.options.runId}:tool:${id}`,
+                toolCallId: id,
+                content,
+                role: 'tool',
+                ...(metadata !== undefined ? { metadata } : {}),
+            },
+        ];
+    }
+    addUsage(usage, model) {
+        if (usage === undefined)
+            return;
+        const name = typeof model === 'string' && model.length > 0 ? model : this.options.model;
+        const key = name ?? '';
+        const entry = this.usage.get(key) ?? (name !== undefined ? { model: name } : {});
+        // The library's accounting is already the protocol's: input and output are totals, cache and
+        // reasoning counts are parts of them. A count the provider did not report stays absent.
+        entry.inputTokens = (entry.inputTokens ?? 0) + usage.inputTokens;
+        entry.outputTokens = (entry.outputTokens ?? 0) + usage.outputTokens;
+        entry.totalTokens = entry.inputTokens + entry.outputTokens;
+        if (usage.cacheReadTokens !== undefined) {
+            entry.cachedInputTokens = (entry.cachedInputTokens ?? 0) + usage.cacheReadTokens;
+        }
+        if (usage.cacheWriteTokens !== undefined) {
+            entry.cacheWriteInputTokens = (entry.cacheWriteInputTokens ?? 0) + usage.cacheWriteTokens;
+        }
+        if (usage.reasoningTokens !== undefined) {
+            entry.reasoningTokens = (entry.reasoningTokens ?? 0) + usage.reasoningTokens;
+        }
+        this.usage.set(key, entry);
+    }
+    usageEntries() {
+        return [...this.usage.values()];
+    }
+}
+//# sourceMappingURL=encoder.js.map

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

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

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

@@ -0,0 +1,12 @@
+/**
+ * AG-UI 1.0 (https://docs.ag-ui.com/spec/1.0), producer side: the encoder that projects a run's
+ * stream onto AG-UI events, and the pieces the `POST <path>/ag-ui` route is built from — for a host
+ * that mounts its own route instead of the provider's.
+ */
+export { type AgUiAdapterOptions, agUiAdapter } from './adapter.js';
+export { AgUiEncoder, type AgUiEncoderOptions } from './encoder.js';
+export { type ForwardedOptions, type InlineMedia, parseRunInput, planResume, type ResumeDecision, type ResumePlan, readAnswersPayload, readApprovalPayload, readContext, readForwardedProps, readUserTurn, type UserTurn, } from './input.js';
+export { decodeInterruptId, encodeInterruptId, type InterruptAddress } from './interrupt-id.js';
+export { type AgUiStreamOptions, agUiEvents, agUiSse } from './stream.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ag-ui/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,kBAAkB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,aAAa,EACb,UAAU,EACV,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,kBAAkB,EAClB,mBAAmB,EACnB,WAAW,EACX,kBAAkB,EAClB,YAAY,EACZ,KAAK,QAAQ,GACd,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAChG,OAAO,EAAE,KAAK,iBAAiB,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC1E,cAAc,YAAY,CAAC"}

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

@@ -0,0 +1,12 @@
+/**
+ * AG-UI 1.0 (https://docs.ag-ui.com/spec/1.0), producer side: the encoder that projects a run's
+ * stream onto AG-UI events, and the pieces the `POST <path>/ag-ui` route is built from — for a host
+ * that mounts its own route instead of the provider's.
+ */
+export { agUiAdapter } from './adapter.js';
+export { AgUiEncoder } from './encoder.js';
+export { parseRunInput, planResume, readAnswersPayload, readApprovalPayload, readContext, readForwardedProps, readUserTurn, } from './input.js';
+export { decodeInterruptId, encodeInterruptId } from './interrupt-id.js';
+export { agUiEvents, agUiSse } from './stream.js';
+export * from './types.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ag-ui/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAA2B,WAAW,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,WAAW,EAA2B,MAAM,cAAc,CAAC;AACpE,OAAO,EAGL,aAAa,EACb,UAAU,EAGV,kBAAkB,EAClB,mBAAmB,EACnB,WAAW,EACX,kBAAkB,EAClB,YAAY,GAEb,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAyB,MAAM,mBAAmB,CAAC;AAChG,OAAO,EAA0B,UAAU,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC1E,cAAc,YAAY,CAAC"}

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

@@ -0,0 +1,72 @@
+import { type InterruptAddress } from './interrupt-id.js';
+import type { AgUiContext, AgUiMessage, AgUiResumeEntry, AgUiRunInput } from './types.js';
+/**
+ * Read a request body as a `RunAgentInput`, or say why it is not one.
+ *
+ * Only what this producer acts on is checked, and a KNOWN member with a value the schema rejects is
+ * malformed (the run never starts). A member it does not recognise is not an error — the protocol's
+ * asymmetry: a newer consumer's input must not bounce off an older producer.
+ */
+export declare function parseRunInput(body: unknown): AgUiRunInput | string;
+/** A media part carried inline, ready to be staged as an attachment. */
+export interface InlineMedia {
+    kind: 'image' | 'audio' | 'video' | 'document';
+    contentType: string;
+    data: Buffer;
+    filename: string;
+}
+export interface UserTurn {
+    /** The text of the message the run answers. */
+    text: string;
+    media: InlineMedia[];
+    /** Why a part was not used, one sentence each — reported, never fatal. */
+    dropped: string[];
+}
+/**
+ * The turn a run answers: the LAST user message of the input. The library keeps each thread's
+ * history itself, so the earlier messages the consumer restates are not read back in — what the
+ * agent resumes from is what it stored.
+ *
+ * Multimodal parts: text parts are the message's text; a media part carried inline (`data`) becomes
+ * an attachment. A part by `url` or by provider `file` handle is dropped and said so — this producer
+ * hands the model only bytes it staged itself, never an address a caller supplied.
+ */
+export declare function readUserTurn(messages: readonly AgUiMessage[]): UserTurn | null;
+/** `context` entries as the library's page context carries them, or `undefined` for none. */
+export declare function readContext(context: readonly AgUiContext[] | undefined): AgUiContext[] | undefined;
+/**
+ * What the library reads from `forwardedProps` — the consumer's channel for what AG-UI does not
+ * model: which agent, which model, which persona, and the page context the tools see.
+ */
+export interface ForwardedOptions {
+    agent?: string;
+    model?: string;
+    persona?: string;
+    pageContext?: Record<string, unknown>;
+}
+export declare function readForwardedProps(forwarded: unknown): ForwardedOptions;
+/** One resume entry this producer can act on. */
+export interface ResumeDecision {
+    address: InterruptAddress;
+    entry: AgUiResumeEntry;
+}
+export interface ResumePlan {
+    decisions: ResumeDecision[];
+    /** Entries naming an interrupt this producer did not raise: skipped with a warning, never fatal. */
+    unrecognised: string[];
+}
+/**
+ * Sort a resume list into what it answers. Every recognised entry must continue the SAME library
+ * run from the SAME point — they are the interrupts of one `RUN_FINISHED` — and a list that does not
+ * is malformed (a string says why).
+ */
+export declare function planResume(resume: readonly AgUiResumeEntry[]): ResumePlan | string;
+/** `{ approved, reason?, remember? }` out of an approval's resume payload. A bare boolean is accepted. */
+export declare function readApprovalPayload(payload: unknown): {
+    approved: boolean;
+    reason?: string;
+    remember?: boolean;
+} | null;
+/** `questionId → string[]` out of an elicitation's resume payload (`{ answers }` or the map itself). */
+export declare function readAnswersPayload(payload: unknown): Record<string, string[]> | null;
+//# sourceMappingURL=input.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../../src/ag-ui/input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,KAAK,EAEV,WAAW,EACX,WAAW,EACX,eAAe,EACf,YAAY,EACb,MAAM,YAAY,CAAC;AAMpB;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,YAAY,GAAG,MAAM,CA+BlE;AAED,wEAAwE;AACxE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,CAAC;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,QAAQ;IACvB,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,0EAA0E;IAC1E,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAuBD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,GAAG,QAAQ,GAAG,IAAI,CAyD9E;AAED,6FAA6F;AAC7F,wBAAgB,WAAW,CACzB,OAAO,EAAE,SAAS,WAAW,EAAE,GAAG,SAAS,GAC1C,WAAW,EAAE,GAAG,SAAS,CAO3B;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,OAAO,GAAG,gBAAgB,CAevE;AAED,iDAAiD;AACjD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,gBAAgB,CAAC;IAC1B,KAAK,EAAE,eAAe,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,oGAAoG;IACpG,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,GAAG,UAAU,GAAG,MAAM,CAwBlF;AAED,0GAA0G;AAC1G,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG;IACrD,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,GAAG,IAAI,CAQP;AAED,wGAAwG;AACxG,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI,CAWpF"}