@adonis-agora/agent 0.60.1 → 0.62.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../../../src/ag-ui/core/input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAA0B,MAAM,6BAA6B,CAAC;AAC1F,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,CAsClE;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,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,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,CAkBvE;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"}

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

@@ -0,0 +1,228 @@
+import { validateUiCapabilities } from '../../genui/capabilities.js';
+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';
+    }
+    if (isRecord(body.forwardedProps) && Object.hasOwn(body.forwardedProps, 'uiCapabilities')) {
+        try {
+            validateUiCapabilities(body.forwardedProps.uiCapabilities);
+        }
+        catch {
+            return 'forwardedProps.uiCapabilities must be valid UI capabilities';
+        }
+    }
+    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 {
+        ...(Object.hasOwn(forwarded, 'uiCapabilities')
+            ? { uiCapabilities: validateUiCapabilities(forwarded.uiCapabilities) }
+            : {}),
+        ...(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/core/input.js.map

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

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

@@ -0,0 +1,31 @@
+/**
+ * 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 {
+    /** `proposal` — an independent proposal's approval, decided through the proposal service. */
+    kind: 'approval' | 'elicitation' | 'proposal';
+    /** 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;
+    /** `proposal` only: the proposal and the library thread it belongs to. */
+    proposalId?: string;
+    threadId?: string;
+}
+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/core/interrupt-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interrupt-id.d.ts","sourceRoot":"","sources":["../../../../src/ag-ui/core/interrupt-id.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,gBAAgB;IAC/B,6FAA6F;IAC7F,IAAI,EAAE,UAAU,GAAG,aAAa,GAAG,UAAU,CAAC;IAC9C,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;IACjB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAMD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAUnE;AAED,+EAA+E;AAC/E,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,OAAO,GAAG,gBAAgB,GAAG,IAAI,CAgCtE"}

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

@@ -0,0 +1,48 @@
+const KIND_CODES = { approval: 'a', elicitation: 'e', proposal: 'p' };
+const PREFIX = 'agora_';
+export function encodeInterruptId(address) {
+    const compact = [
+        KIND_CODES[address.kind],
+        address.parked,
+        address.stream,
+        address.toolCallId,
+        address.position,
+    ];
+    if (address.kind === 'proposal')
+        compact.push(address.proposalId, address.threadId);
+    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))
+            return null;
+        const [kind, parked, stream, toolCallId, position, proposalId, threadId] = parsed;
+        if (parsed.length !== (kind === 'p' ? 7 : 5) ||
+            (kind === 'p' && (typeof proposalId !== 'string' || typeof threadId !== 'string')) ||
+            (kind !== 'a' && kind !== 'e' && kind !== 'p') ||
+            typeof parked !== 'string' ||
+            typeof stream !== 'string' ||
+            typeof toolCallId !== 'string' ||
+            typeof position !== 'number' ||
+            !Number.isSafeInteger(position) ||
+            position < 0) {
+            return null;
+        }
+        return {
+            kind: kind === 'a' ? 'approval' : kind === 'e' ? 'elicitation' : 'proposal',
+            parked,
+            stream,
+            toolCallId,
+            position,
+            ...(kind === 'p' ? { proposalId: proposalId, threadId: threadId } : {}),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=interrupt-id.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interrupt-id.js","sourceRoot":"","sources":["../../../../src/ag-ui/core/interrupt-id.ts"],"names":[],"mappings":"AA4BA,MAAM,UAAU,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAW,CAAC;AAE/E,MAAM,MAAM,GAAG,QAAQ,CAAC;AAExB,MAAM,UAAU,iBAAiB,CAAC,OAAyB;IACzD,MAAM,OAAO,GAAc;QACzB,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC;QACxB,OAAO,CAAC,MAAM;QACd,OAAO,CAAC,MAAM;QACd,OAAO,CAAC,UAAU;QAClB,OAAO,CAAC,QAAQ;KACjB,CAAC;IACF,IAAI,OAAO,CAAC,IAAI,KAAK,UAAU;QAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IACpF,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;YAAE,OAAO,IAAI,CAAC;QACxC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,CAAC,GAAG,MAAmB,CAAC;QAC/F,IACE,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACxC,CAAC,IAAI,KAAK,GAAG,IAAI,CAAC,OAAO,UAAU,KAAK,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC;YAClF,CAAC,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,CAAC;YAC9C,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,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,UAAU;YAC3E,MAAM;YACN,MAAM;YACN,UAAU;YACV,QAAQ;YACR,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,UAAoB,EAAE,QAAQ,EAAE,QAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5F,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/src/ag-ui/core/proposal-decision.d.ts

@@ -0,0 +1,9 @@
+import { type AgUiEvent } from './types.js';
+/** A decision-only protocol invocation: no model run, stream holder or tool execution is created. */
+export declare function actionProposalDecisionEvents(input: {
+    threadId: string;
+    runId: string;
+    text: string;
+    proposalDecision: unknown;
+}): AgUiEvent[];
+//# sourceMappingURL=proposal-decision.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"proposal-decision.d.ts","sourceRoot":"","sources":["../../../../src/ag-ui/core/proposal-decision.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwC,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAElF,qGAAqG;AACrG,wBAAgB,4BAA4B,CAAC,KAAK,EAAE;IAClD,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,OAAO,CAAC;CAC3B,GAAG,SAAS,EAAE,CAgBd"}

package/dist/src/ag-ui/core/proposal-decision.js

@@ -0,0 +1,20 @@
+import { AG_UI_CUSTOM, AG_UI_PROTOCOL_VERSION } from './types.js';
+/** A decision-only protocol invocation: no model run, stream holder or tool execution is created. */
+export function actionProposalDecisionEvents(input) {
+    const messageId = `${input.runId}:proposal-decision`;
+    const value = { threadId: input.threadId, proposalDecision: input.proposalDecision };
+    return [
+        {
+            type: 'RUN_STARTED',
+            threadId: input.threadId,
+            runId: input.runId,
+            protocolVersion: AG_UI_PROTOCOL_VERSION,
+        },
+        { type: 'CUSTOM', name: AG_UI_CUSTOM.actionProposalDecision, value },
+        { type: 'TEXT_MESSAGE_START', messageId, role: 'assistant' },
+        { type: 'TEXT_MESSAGE_CONTENT', messageId, delta: input.text },
+        { type: 'TEXT_MESSAGE_END', messageId },
+        { type: 'RUN_FINISHED', threadId: input.threadId, runId: input.runId },
+    ];
+}
+//# sourceMappingURL=proposal-decision.js.map

package/dist/src/ag-ui/core/proposal-decision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proposal-decision.js","sourceRoot":"","sources":["../../../../src/ag-ui/core/proposal-decision.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAkB,MAAM,YAAY,CAAC;AAElF,qGAAqG;AACrG,MAAM,UAAU,4BAA4B,CAAC,KAK5C;IACC,MAAM,SAAS,GAAG,GAAG,KAAK,CAAC,KAAK,oBAAoB,CAAC;IACrD,MAAM,KAAK,GAAG,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,gBAAgB,EAAE,KAAK,CAAC,gBAAgB,EAAE,CAAC;IACrF,OAAO;QACL;YACE,IAAI,EAAE,aAAa;YACnB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,eAAe,EAAE,sBAAsB;SACxC;QACD,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,CAAC,sBAAsB,EAAE,KAAK,EAAE;QACpE,EAAE,IAAI,EAAE,oBAAoB,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE;QAC5D,EAAE,IAAI,EAAE,sBAAsB,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE;QAC9D,EAAE,IAAI,EAAE,kBAAkB,EAAE,SAAS,EAAE;QACvC,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE;KACvE,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,27 @@
+import { type AgUiEncoderOptions } from './encoder.js';
+import type { AgUiEvent, AgUiSourceFrame } 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<AgUiSourceFrame>, 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/core/stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../../../src/ag-ui/core/stream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7D,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,eAAe,CAAC,EACtC,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/core/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/core/stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.js","sourceRoot":"","sources":["../../../../src/ag-ui/core/stream.ts"],"names":[],"mappings":"AAAA,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,MAAsC,EACtC,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,QAA8D,CAAC;IACnE,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,QAAkD,EAAE,EAAU;IAC/E,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"}