@adonis-agora/agent 0.53.2 → 0.55.0

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

@@ -0,0 +1,216 @@
+import { decodeInterruptId } from './interrupt-id.js';
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * 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 function parseRunInput(body) {
+    if (!isRecord(body))
+        return 'the body must be a RunAgentInput object';
+    if (typeof body.threadId !== 'string' || body.threadId.length === 0) {
+        return 'threadId must be a non-empty string';
+    }
+    if (body.threadId.length > 255)
+        return 'threadId must be at most 255 characters';
+    if (typeof body.runId !== 'string' || body.runId.length === 0) {
+        return 'runId must be a non-empty string';
+    }
+    if (!Array.isArray(body.messages))
+        return 'messages must be an array';
+    for (const message of body.messages) {
+        if (!isRecord(message) || typeof message.role !== 'string') {
+            return 'each message must be an object with a role';
+        }
+    }
+    if (body.resume !== undefined) {
+        if (!Array.isArray(body.resume))
+            return 'resume must be an array';
+        for (const entry of body.resume) {
+            if (!isRecord(entry) ||
+                typeof entry.interruptId !== 'string' ||
+                (entry.status !== 'resolved' && entry.status !== 'cancelled')) {
+                return "each resume entry needs an interruptId and a status of 'resolved' or 'cancelled'";
+            }
+        }
+    }
+    if (body.context !== undefined && !Array.isArray(body.context)) {
+        return 'context must be an array';
+    }
+    return body;
+}
+const EXTENSIONS = {
+    'image/png': 'png',
+    'image/jpeg': 'jpg',
+    'image/gif': 'gif',
+    'image/webp': 'webp',
+    'application/pdf': 'pdf',
+    'text/plain': 'txt',
+};
+function filenameOf(part, index, contentType) {
+    const metadata = part.metadata;
+    if (isRecord(metadata)) {
+        for (const key of ['filename', 'name', 'title']) {
+            const value = metadata[key];
+            if (typeof value === 'string' && value.trim().length > 0)
+                return value.trim().slice(0, 200);
+        }
+    }
+    const extension = EXTENSIONS[contentType];
+    return `${part.type}-${index + 1}${extension !== undefined ? `.${extension}` : ''}`;
+}
+/**
+ * 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 function readUserTurn(messages) {
+    let last;
+    for (let index = messages.length - 1; index >= 0; index -= 1) {
+        if (messages[index]?.role === 'user') {
+            last = messages[index];
+            break;
+        }
+    }
+    if (last === undefined)
+        return null;
+    if (typeof last.content === 'string')
+        return { text: last.content, media: [], dropped: [] };
+    if (!Array.isArray(last.content))
+        return { text: '', media: [], dropped: [] };
+    const texts = [];
+    const media = [];
+    const dropped = [];
+    last.content.forEach((part, index) => {
+        if (!isRecord(part))
+            return;
+        if (part.type === 'text') {
+            if (typeof part.text === 'string')
+                texts.push(part.text);
+            return;
+        }
+        if (part.type !== 'image' &&
+            part.type !== 'audio' &&
+            part.type !== 'video' &&
+            part.type !== 'document') {
+            return;
+        }
+        const source = part.source;
+        if (!isRecord(source) || source.type !== 'data') {
+            const how = isRecord(source) && typeof source.type === 'string' ? source.type : 'unknown';
+            dropped.push(`The ${part.type} part ${index + 1} was not used: only inline data is accepted, not a ${how} source.`);
+            return;
+        }
+        if (typeof source.value !== 'string' || typeof source.mimeType !== 'string') {
+            dropped.push(`The ${part.type} part ${index + 1} was not used: its inline data is malformed.`);
+            return;
+        }
+        const data = Buffer.from(source.value, 'base64');
+        if (data.length === 0) {
+            dropped.push(`The ${part.type} part ${index + 1} was not used: it carries no bytes.`);
+            return;
+        }
+        const contentType = source.mimeType.toLowerCase();
+        media.push({
+            kind: part.type,
+            contentType,
+            data,
+            filename: filenameOf(part, index, contentType),
+        });
+    });
+    return { text: texts.join('\n'), media, dropped };
+}
+/** `context` entries as the library's page context carries them, or `undefined` for none. */
+export function readContext(context) {
+    if (context === undefined)
+        return undefined;
+    const entries = context.filter((entry) => isRecord(entry) && typeof entry.description === 'string' && typeof entry.value === 'string');
+    return entries.length > 0 ? entries : undefined;
+}
+export function readForwardedProps(forwarded) {
+    if (!isRecord(forwarded))
+        return {};
+    const pick = (key) => {
+        const value = forwarded[key];
+        return typeof value === 'string' && value.length > 0 ? value : undefined;
+    };
+    const agent = pick('agent');
+    const model = pick('model');
+    const persona = pick('persona');
+    return {
+        ...(agent !== undefined ? { agent } : {}),
+        ...(model !== undefined ? { model } : {}),
+        ...(persona !== undefined ? { persona } : {}),
+        ...(isRecord(forwarded.pageContext) ? { pageContext: forwarded.pageContext } : {}),
+    };
+}
+/**
+ * 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 function planResume(resume) {
+    const decisions = [];
+    const unrecognised = [];
+    for (const entry of resume) {
+        const address = decodeInterruptId(entry.interruptId);
+        if (address === null) {
+            unrecognised.push(entry.interruptId);
+            continue;
+        }
+        decisions.push({ address, entry });
+    }
+    const first = decisions[0];
+    if (first === undefined)
+        return { decisions, unrecognised };
+    for (const { address } of decisions) {
+        if (address.stream !== first.address.stream || address.position !== first.address.position) {
+            return 'the resume entries answer interrupts of different runs';
+        }
+    }
+    const seen = new Set();
+    for (const { address } of decisions) {
+        if (seen.has(address.toolCallId))
+            return 'an interrupt is answered twice';
+        seen.add(address.toolCallId);
+    }
+    return { decisions, unrecognised };
+}
+/** `{ approved, reason?, remember? }` out of an approval's resume payload. A bare boolean is accepted. */
+export function readApprovalPayload(payload) {
+    if (typeof payload === 'boolean')
+        return { approved: payload };
+    if (!isRecord(payload) || typeof payload.approved !== 'boolean')
+        return null;
+    return {
+        approved: payload.approved,
+        ...(typeof payload.reason === 'string' ? { reason: payload.reason } : {}),
+        ...(typeof payload.remember === 'boolean' ? { remember: payload.remember } : {}),
+    };
+}
+/** `questionId → string[]` out of an elicitation's resume payload (`{ answers }` or the map itself). */
+export function readAnswersPayload(payload) {
+    const source = isRecord(payload) && isRecord(payload.answers) ? payload.answers : payload;
+    if (!isRecord(source))
+        return null;
+    const answers = {};
+    for (const [key, value] of Object.entries(source)) {
+        if (typeof value === 'string')
+            answers[key] = [value];
+        else if (Array.isArray(value) && value.every((item) => typeof item === 'string')) {
+            answers[key] = value;
+        }
+        else
+            return null;
+    }
+    return answers;
+}
+//# sourceMappingURL=input.js.map

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

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

package/dist/src/ag-ui/interrupt-id.d.ts

@@ -0,0 +1,27 @@
+/**
+ * An interrupt's id carries everything a resuming request needs, so the producer keeps NOTHING
+ * between the run that stopped to ask and the run that answers — the statelessness AG-UI lets a
+ * producer have, and what lets any replica serve the resume.
+ *
+ * It names the library run the human is answering (`parked` — a delegated sub-agent parks its OWN
+ * run), the run whose stream carries the work (`stream`), the tool call, and how many of that
+ * stream's frames the interrupted AG-UI run already delivered (`position`), which is where the
+ * resuming run picks the stream up.
+ *
+ * It is an address, not a credential: the resume route checks the caller owns the run exactly as
+ * the native approve/answer routes do.
+ */
+export interface InterruptAddress {
+    kind: 'approval' | 'elicitation';
+    /** The run to settle the call on. */
+    parked: string;
+    /** The run whose buffered stream the resume re-attaches to. */
+    stream: string;
+    toolCallId: string;
+    /** Frames of `stream` already delivered when the run was reported interrupted. */
+    position: number;
+}
+export declare function encodeInterruptId(address: InterruptAddress): string;
+/** The address an id names, or `null` for an id this producer did not mint. */
+export declare function decodeInterruptId(id: unknown): InterruptAddress | null;
+//# sourceMappingURL=interrupt-id.d.ts.map

package/dist/src/ag-ui/interrupt-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interrupt-id.d.ts","sourceRoot":"","sources":["../../../src/ag-ui/interrupt-id.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,UAAU,GAAG,aAAa,CAAC;IACjC,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,kFAAkF;IAClF,QAAQ,EAAE,MAAM,CAAC;CAClB;AAID,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CASnE;AAED,+EAA+E;AAC/E,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,OAAO,GAAG,gBAAgB,GAAG,IAAI,CA6BtE"}

package/dist/src/ag-ui/interrupt-id.js

@@ -0,0 +1,42 @@
+const PREFIX = 'agora_';
+export function encodeInterruptId(address) {
+    const compact = [
+        address.kind === 'approval' ? 'a' : 'e',
+        address.parked,
+        address.stream,
+        address.toolCallId,
+        address.position,
+    ];
+    return PREFIX + Buffer.from(JSON.stringify(compact), 'utf8').toString('base64url');
+}
+/** The address an id names, or `null` for an id this producer did not mint. */
+export function decodeInterruptId(id) {
+    if (typeof id !== 'string' || !id.startsWith(PREFIX))
+        return null;
+    try {
+        const parsed = JSON.parse(Buffer.from(id.slice(PREFIX.length), 'base64url').toString('utf8'));
+        if (!Array.isArray(parsed) || parsed.length !== 5)
+            return null;
+        const [kind, parked, stream, toolCallId, position] = parsed;
+        if ((kind !== 'a' && kind !== 'e') ||
+            typeof parked !== 'string' ||
+            typeof stream !== 'string' ||
+            typeof toolCallId !== 'string' ||
+            typeof position !== 'number' ||
+            !Number.isSafeInteger(position) ||
+            position < 0) {
+            return null;
+        }
+        return {
+            kind: kind === 'a' ? 'approval' : 'elicitation',
+            parked,
+            stream,
+            toolCallId,
+            position,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=interrupt-id.js.map

package/dist/src/ag-ui/interrupt-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interrupt-id.js","sourceRoot":"","sources":["../../../src/ag-ui/interrupt-id.ts"],"names":[],"mappings":"AAwBA,MAAM,MAAM,GAAG,QAAQ,CAAC;AAExB,MAAM,UAAU,iBAAiB,CAAC,OAAyB;IACzD,MAAM,OAAO,GAAG;QACd,OAAO,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;QACvC,OAAO,CAAC,MAAM;QACd,OAAO,CAAC,MAAM;QACd,OAAO,CAAC,UAAU;QAClB,OAAO,CAAC,QAAQ;KACjB,CAAC;IACF,OAAO,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AACrF,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,iBAAiB,CAAC,EAAW;IAC3C,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IAClE,IAAI,CAAC;QACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAChC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CACnE,CAAC;QACF,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAC/D,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,GAAG,MAAmB,CAAC;QACzE,IACE,CAAC,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,CAAC;YAC9B,OAAO,MAAM,KAAK,QAAQ;YAC1B,OAAO,MAAM,KAAK,QAAQ;YAC1B,OAAO,UAAU,KAAK,QAAQ;YAC9B,OAAO,QAAQ,KAAK,QAAQ;YAC5B,CAAC,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC;YAC/B,QAAQ,GAAG,CAAC,EACZ,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO;YACL,IAAI,EAAE,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,aAAa;YAC/C,MAAM;YACN,MAAM;YACN,UAAU;YACV,QAAQ;SACT,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,28 @@
+import type { StreamFrame } from '../spi/token-stream-sink.js';
+import { type AgUiEncoderOptions } from './encoder.js';
+import type { AgUiEvent } from './types.js';
+export interface AgUiStreamOptions extends AgUiEncoderOptions {
+    /**
+     * How long the library stream may stay silent, while the run waits on a person AND has other work
+     * announced, before the AG-UI run is reported interrupted. Default 750 ms.
+     *
+     * Only that mixed case needs a clock. A run whose every open tool call is waiting on someone is
+     * reported at once; a run waiting on no one is never cut short.
+     */
+    quietMs?: number;
+    /** Events to write right after `RUN_STARTED` (warnings about input that was dropped). */
+    preamble?: AgUiEvent[];
+}
+/**
+ * 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 declare function agUiEvents(frames: AsyncIterable<StreamFrame>, options: AgUiStreamOptions): AsyncGenerator<AgUiEvent>;
+/** One AG-UI event as an SSE frame: a single `data:` line, LF-terminated, as the binding pins. */
+export declare function agUiSse(event: AgUiEvent): string;
+//# sourceMappingURL=stream.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../../src/ag-ui/stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAe,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,WAAW,iBAAkB,SAAQ,kBAAkB;IAC3D;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yFAAyF;IACzF,QAAQ,CAAC,EAAE,SAAS,EAAE,CAAC;CACxB;AAOD;;;;;;;;GAQG;AACH,wBAAuB,UAAU,CAC/B,MAAM,EAAE,aAAa,CAAC,WAAW,CAAC,EAClC,OAAO,EAAE,iBAAiB,GACzB,cAAc,CAAC,SAAS,CAAC,CAmC3B;AAkBD,kGAAkG;AAClG,wBAAgB,OAAO,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAEhD"}

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

@@ -0,0 +1,68 @@
+import { AgUiEncoder } from './encoder.js';
+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;
+            }
+            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. */
+export function agUiSse(event) {
+    return `data: ${JSON.stringify(event)}\n\n`;
+}
+//# sourceMappingURL=stream.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stream.js","sourceRoot":"","sources":["../../../src/ag-ui/stream.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAA2B,MAAM,cAAc,CAAC;AAgBpE,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAC7B,MAAM,QAAQ,GAAG,EAAE,CAAC;AAIpB;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,UAAU,CAC/B,MAAkC,EAClC,OAA0B;IAE1B,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,gBAAgB,CAAC;IACpD,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,KAAK,CAAC,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;IAC9B,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;IAChD,IAAI,QAA0D,CAAC;IAC/D,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,IAAI,CAAC;QACH,SAAS,CAAC;YACR,QAAQ,KAAK,QAAQ,CAAC,IAAI,EAAE,CAAC;YAC7B,4FAA4F;YAC5F,4FAA4F;YAC5F,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;YACzD,IAAI,IAAU,CAAC;YACf,IAAI,QAAQ,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;gBAChC,yFAAyF;gBACzF,qFAAqF;gBACrF,IAAI,GAAG,MAAM,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;YACzF,CAAC;iBAAM,CAAC;gBACN,IAAI,GAAG,MAAM,QAAQ,CAAC;YACxB,CAAC;YACD,IAAI,IAAI,KAAK,OAAO;gBAAE,MAAM;YAC5B,QAAQ,GAAG,SAAS,CAAC;YACrB,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;gBACvB,KAAK,GAAG,IAAI,CAAC;gBACb,MAAM;YACR,CAAC;YACD,KAAK,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;YAAS,CAAC;QACT,kFAAkF;QAClF,KAAK,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;IAC3B,CAAC;IACD,KAAK,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED,SAAS,SAAS,CAAC,QAA8C,EAAE,EAAU;IAC3E,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC3C,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;QACrD,QAAQ,CAAC,IAAI,CACX,CAAC,MAAM,EAAE,EAAE;YACT,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO,CAAC,MAAM,CAAC,CAAC;QAClB,CAAC,EACD,CAAC,KAAc,EAAE,EAAE;YACjB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,kGAAkG;AAClG,MAAM,UAAU,OAAO,CAAC,KAAgB;IACtC,OAAO,SAAS,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC;AAC9C,CAAC"}

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

@@ -0,0 +1,202 @@
+/**
+ * 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 (`test/fixtures/ag-ui/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';
+    /** The whole question set of an elicitation (`ElicitationRequest`). */
+    readonly elicitation: 'agora.elicitation';
+    /** `{ usage, costUsd, reasoningMs }` of one model step. */
+    readonly stepUsage: 'agora.step-usage';
+    /** `{ message }` — input material this producer could not use and dropped. */
+    readonly warning: 'agora.warning';
+};
+export {};
+//# sourceMappingURL=types.d.ts.map

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

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

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

@@ -0,0 +1,33 @@
+/**
+ * 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 (`test/fixtures/ag-ui/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',
+    /** The whole question set of an elicitation (`ElicitationRequest`). */
+    elicitation: 'agora.elicitation',
+    /** `{ usage, costUsd, reasoningMs }` of one model step. */
+    stepUsage: 'agora.step-usage',
+    /** `{ message }` — input material this producer could not use and dropped. */
+    warning: 'agora.warning',
+};
+//# sourceMappingURL=types.js.map