@laserdata/laser-sdk 0.0.1-rc.2 → 0.0.1-rc.3

package/dist/bridges/a2a.js

@@ -0,0 +1,244 @@
+import { CodecError, HandlerConfigError } from "../client/errors.js";
+import { AgentTopic } from "../provenance/agent-topic.js";
+import { signCardValue } from "../signing.js";
+import { ConversationId } from "../types/ids.js";
+import { AgentKind, METADATA_BRIDGE_HOPS, OPERATION_CHAT, taskStateDisplay } from "../wire/agent.js";
+import { ContentType } from "../wire/content.js";
+import { CorrelationId } from "../wire/ids.js";
+import { bridgeHopMetadata, enterBridge } from "./hops.js";
+export const A2A_PROTOCOL_VERSION = "1.0";
+export const A2A_JSONRPC_BINDING = "JSONRPC";
+export const A2A_APP_ERROR_CODE = -32_000;
+export const SDK_VERSION = "0.0.1-rc.3";
+export const A2aMethod = {
+    MessageSend: "SendMessage",
+    MessageStream: "SendStreamingMessage",
+    TasksGet: "GetTask",
+    TasksCancel: "CancelTask"
+};
+function jsonObject(value, context) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        throw new HandlerConfigError(`${context} must be a JSON object`);
+    }
+    return value;
+}
+function jsonBytes(value, context) {
+    try {
+        const encoded = JSON.stringify(value);
+        if (typeof encoded !== "string")
+            throw new Error("value is not JSON serializable");
+        return new TextEncoder().encode(encoded);
+    }
+    catch (cause) {
+        throw new CodecError(`${context} is not JSON serializable`, "a2a", "json", { cause });
+    }
+}
+function correlationOf(conversation) {
+    return CorrelationId.parse(conversation.toString());
+}
+export function contentRefMode(reference) {
+    if (reference.kind === "schemaId") {
+        return `application/x-agdx-schema;id=${reference.value}`;
+    }
+    const modes = {
+        [ContentType.Raw]: "application/octet-stream",
+        [ContentType.Json]: "application/json",
+        [ContentType.Msgpack]: "application/msgpack",
+        [ContentType.Cbor]: "application/cbor",
+        [ContentType.Bson]: "application/bson",
+        [ContentType.Avro]: "application/avro",
+        [ContentType.Protobuf]: "application/protobuf",
+        [ContentType.Arrow]: "application/vnd.apache.arrow.stream",
+        [ContentType.Ref]: "application/x-agdx-ref",
+        [ContentType.Any]: "*/*"
+    };
+    return modes[reference.value];
+}
+export function taskFromEnvelope(taskId, envelope) {
+    const state = envelope.taskState ??
+        (envelope.kind === AgentKind.Error
+            ? { kind: "known", name: "Failed" }
+            : { kind: "known", name: "Completed" });
+    return {
+        id: taskId,
+        status: { state },
+        artifacts: envelope.body.byteLength === 0 ? [] : [{ text: new TextDecoder().decode(envelope.body) }]
+    };
+}
+export function taskToJson(task) {
+    return {
+        id: task.id,
+        status: { state: taskStateDisplay(task.status.state) },
+        ...(task.artifacts.length > 0 ? { artifacts: task.artifacts } : {})
+    };
+}
+export class A2aBridge {
+    laser;
+    source;
+    requestTopic;
+    replyTopic;
+    capabilities = [];
+    signingKey;
+    hops;
+    constructor(laser, source, requestTopic, replyTopic) {
+        this.laser = laser;
+        this.source = source;
+        this.requestTopic = requestTopic;
+        this.replyTopic = replyTopic;
+        this.hops = enterBridge(source.asString());
+    }
+    withBridgeHops(previous) {
+        this.hops = enterBridge(this.source.asString(), previous);
+        return this;
+    }
+    withSigningKey(key) {
+        this.signingKey = key;
+        return this;
+    }
+    withCapabilities(capabilities) {
+        this.capabilities = [...capabilities];
+        return this;
+    }
+    async submit(params) {
+        return this.submitJson(jsonBytes(params, "A2A message params"));
+    }
+    async submitJson(paramsJson) {
+        const task = ConversationId.new();
+        await this.laser
+            .agdx(this.requestTopic, this.source, task)
+            .command(correlationOf(task), paramsJson)
+            .withOperation(OPERATION_CHAT)
+            .withMetadata(METADATA_BRIDGE_HOPS, bridgeHopMetadata(this.hops))
+            .contentType(ContentType.Json)
+            .send();
+        return {
+            id: task.toString(),
+            status: { state: { kind: "known", name: "Submitted" } },
+            artifacts: []
+        };
+    }
+    async task(id) {
+        let conversation;
+        try {
+            conversation = ConversationId.parse(id);
+        }
+        catch (cause) {
+            throw new HandlerConfigError(`invalid task id \`${id}\``, { cause });
+        }
+        const correlation = correlationOf(conversation);
+        const messages = await this.laser
+            .context(conversation)
+            .fetch([this.replyTopic], Number.MAX_SAFE_INTEGER);
+        const answer = messages.findLast((message) => message.envelope?.correlation?.equals(correlation) === true &&
+            (message.envelope.kind === AgentKind.Response || message.envelope.kind === AgentKind.Error))?.envelope;
+        return answer === undefined
+            ? {
+                id,
+                status: { state: { kind: "known", name: "Working" } },
+                artifacts: []
+            }
+            : taskFromEnvelope(id, answer);
+    }
+    async cancel(id) {
+        let conversation;
+        try {
+            conversation = ConversationId.parse(id);
+        }
+        catch (cause) {
+            throw new HandlerConfigError(`invalid task id \`${id}\``, { cause });
+        }
+        let send = this.laser
+            .agdx(this.replyTopic, this.source, conversation)
+            .fail(correlationOf(conversation), {
+            code: { kind: "known", name: "Cancelled" },
+            message: "canceled by the A2A client",
+            retryable: false
+        })
+            .withTaskState({ kind: "known", name: "Canceled" })
+            .withMetadata(METADATA_BRIDGE_HOPS, bridgeHopMetadata(this.hops));
+        if (this.signingKey !== undefined)
+            send = send.signedBy(this.signingKey);
+        await send.send();
+        return {
+            id,
+            status: { state: { kind: "known", name: "Canceled" } },
+            artifacts: []
+        };
+    }
+    card() {
+        return {
+            name: this.source.asString(),
+            description: "LaserData AGDX bridge over the durable log",
+            version: SDK_VERSION,
+            supportedInterfaces: [
+                { url: "/", protocolBinding: A2A_JSONRPC_BINDING, protocolVersion: A2A_PROTOCOL_VERSION }
+            ],
+            capabilities: {
+                streaming: true,
+                pushNotifications: false,
+                stateTransitionHistory: false,
+                extendedAgentCard: false
+            },
+            defaultInputModes: ["text/plain"],
+            defaultOutputModes: ["text/plain"],
+            skills: this.capabilities.map((capability) => ({
+                id: capability.skillId,
+                name: capability.skillId,
+                description: "",
+                tags: [],
+                ...(capability.input !== undefined
+                    ? { inputModes: [contentRefMode(capability.input)] }
+                    : {}),
+                ...(capability.output !== undefined
+                    ? { outputModes: [contentRefMode(capability.output)] }
+                    : {})
+            }))
+        };
+    }
+    signedCard(key) {
+        const card = this.card();
+        return { ...card, signatures: [signCardValue(key, card)] };
+    }
+    async handleRpc(input) {
+        let id = null;
+        try {
+            const request = jsonObject(input, "A2A JSON-RPC request");
+            id = request["id"] ?? null;
+            const method = request["method"];
+            if (typeof method !== "string")
+                throw new HandlerConfigError("A2A method must be a string");
+            const params = request["params"] ?? {};
+            let task;
+            switch (method) {
+                case A2aMethod.MessageSend:
+                case A2aMethod.MessageStream:
+                    task = await this.submit(params);
+                    break;
+                case A2aMethod.TasksGet:
+                case A2aMethod.TasksCancel: {
+                    const object = jsonObject(params, "A2A task params");
+                    const taskId = object["id"];
+                    if (typeof taskId !== "string")
+                        throw new HandlerConfigError("A2A task id must be a string");
+                    task = method === A2aMethod.TasksGet ? await this.task(taskId) : await this.cancel(taskId);
+                    break;
+                }
+                default:
+                    throw new HandlerConfigError(`unknown A2A method \`${method}\``);
+            }
+            return { jsonrpc: "2.0", id, result: taskToJson(task) };
+        }
+        catch (error) {
+            return {
+                jsonrpc: "2.0",
+                id,
+                error: {
+                    code: A2A_APP_ERROR_CODE,
+                    message: error instanceof Error ? error.message : String(error)
+                }
+            };
+        }
+    }
+}
+export { AgentTopic };
+//# sourceMappingURL=a2a.js.map

package/dist/bridges/a2a.js.map

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

package/dist/bridges/agui.d.ts

@@ -0,0 +1,66 @@
+import type { Laser } from "../client/laser.js";
+import type { AgentId, ConversationId } from "../types/ids.js";
+import { type AgentEnvelope } from "../wire/agent.js";
+export type AgUiEvent = {
+    readonly type: "RUN_STARTED";
+    readonly threadId: string;
+    readonly runId: string;
+} | {
+    readonly type: "RUN_FINISHED";
+    readonly threadId: string;
+    readonly runId: string;
+} | {
+    readonly type: "TEXT_MESSAGE_START";
+    readonly messageId: string;
+    readonly role: string;
+} | {
+    readonly type: "TEXT_MESSAGE_CONTENT";
+    readonly messageId: string;
+    readonly delta: string;
+} | {
+    readonly type: "TEXT_MESSAGE_END";
+    readonly messageId: string;
+} | {
+    readonly type: "REASONING_MESSAGE_START";
+    readonly messageId: string;
+    readonly role: string;
+} | {
+    readonly type: "REASONING_MESSAGE_CONTENT";
+    readonly messageId: string;
+    readonly delta: string;
+} | {
+    readonly type: "REASONING_MESSAGE_END";
+    readonly messageId: string;
+} | {
+    readonly type: "TOOL_CALL_START";
+    readonly toolCallId: string;
+    readonly toolCallName: string;
+} | {
+    readonly type: "TOOL_CALL_ARGS";
+    readonly toolCallId: string;
+    readonly delta: string;
+} | {
+    readonly type: "TOOL_CALL_END";
+    readonly toolCallId: string;
+} | {
+    readonly type: "TOOL_CALL_RESULT";
+    readonly toolCallId: string;
+    readonly content: string;
+} | {
+    readonly type: "STATE_SNAPSHOT";
+    readonly snapshot: unknown;
+} | {
+    readonly type: "STATE_DELTA";
+    readonly delta: unknown;
+} | {
+    readonly type: "RUN_ERROR";
+    readonly message: string;
+};
+export declare function applyJsonPatch(document: unknown, patch: unknown): unknown;
+export declare function envelopeToAgUi(envelope: AgentEnvelope): readonly AgUiEvent[];
+export declare function envelopesToAgUi(envelopes: readonly AgentEnvelope[]): readonly AgUiEvent[];
+export declare function publishStateSnapshot(laser: Laser, topic: string, source: AgentId, conversation: ConversationId, state: unknown): Promise<void>;
+export declare function publishStateDelta(laser: Laser, topic: string, source: AgentId, conversation: ConversationId, patch: unknown): Promise<void>;
+export declare function reconstructState(laser: Laser, conversation: ConversationId, topic: string): Promise<unknown>;
+export declare function aguiEvents(laser: Laser, conversation: ConversationId, topic: string): Promise<readonly AgUiEvent[]>;
+//# sourceMappingURL=agui.d.ts.map

package/dist/bridges/agui.d.ts.map

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

package/dist/bridges/agui.js

@@ -0,0 +1,335 @@
+import { CodecError, InvalidError } from "../client/errors.js";
+import { AgentKind, OPERATION_REASONING, OPERATION_STATE_DELTA, OPERATION_STATE_SNAPSHOT, OPERATION_TASK, OPERATION_TOOL_ARGS, taskStateIsTerminal } from "../wire/agent.js";
+import { ContentType } from "../wire/content.js";
+function jsonBytes(value, operation) {
+    try {
+        const encoded = JSON.stringify(value);
+        if (typeof encoded !== "string")
+            throw new Error("value is not JSON serializable");
+        return new TextEncoder().encode(encoded);
+    }
+    catch (cause) {
+        throw new CodecError(`cannot encode ${operation}`, "agui", operation, { cause });
+    }
+}
+function parseJson(bytes, operation) {
+    try {
+        return JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(bytes));
+    }
+    catch (cause) {
+        throw new CodecError(`cannot decode ${operation}`, "agui", operation, { cause });
+    }
+}
+function decodePointer(path) {
+    if (path === "")
+        return [];
+    if (!path.startsWith("/"))
+        throw new InvalidError(`invalid JSON Pointer \`${path}\``);
+    return path
+        .slice(1)
+        .split("/")
+        .map((part) => {
+        if (/~(?:[^01]|$)/.test(part))
+            throw new InvalidError(`invalid JSON Pointer \`${path}\``);
+        return part.replaceAll("~1", "/").replaceAll("~0", "~");
+    });
+}
+function arrayIndex(token, length, allowEnd) {
+    if (token === "-" && allowEnd)
+        return length;
+    if (!/^(?:0|[1-9][0-9]*)$/.test(token)) {
+        throw new InvalidError(`invalid JSON Patch array index \`${token}\``);
+    }
+    const index = Number(token);
+    const maximum = allowEnd ? length : length - 1;
+    if (!Number.isSafeInteger(index) || index < 0 || index > maximum) {
+        throw new InvalidError(`JSON Patch array index \`${token}\` is out of bounds`);
+    }
+    return index;
+}
+function objectOf(value, path) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        throw new InvalidError(`JSON Patch path \`${path}\` does not address a container`);
+    }
+    return value;
+}
+function parentAt(document, tokens, path) {
+    if (tokens.length === 0)
+        throw new InvalidError("the document root has no parent");
+    let current = document;
+    for (const token of tokens.slice(0, -1)) {
+        if (Array.isArray(current)) {
+            current = current[arrayIndex(token, current.length, false)];
+        }
+        else {
+            const object = objectOf(current, path);
+            if (!(token in object))
+                throw new InvalidError(`JSON Patch path \`${path}\` does not exist`);
+            current = object[token];
+        }
+    }
+    return [current, tokens.at(-1) ?? ""];
+}
+function valueAt(document, path) {
+    const tokens = decodePointer(path);
+    let current = document;
+    for (const token of tokens) {
+        if (Array.isArray(current))
+            current = current[arrayIndex(token, current.length, false)];
+        else {
+            const object = objectOf(current, path);
+            if (!(token in object))
+                throw new InvalidError(`JSON Patch path \`${path}\` does not exist`);
+            current = object[token];
+        }
+    }
+    return current;
+}
+function addValue(document, path, value) {
+    const tokens = decodePointer(path);
+    if (tokens.length === 0)
+        return value;
+    const [parent, token] = parentAt(document, tokens, path);
+    if (Array.isArray(parent))
+        parent.splice(arrayIndex(token, parent.length, true), 0, value);
+    else
+        objectOf(parent, path)[token] = value;
+    return document;
+}
+function removeValue(document, path) {
+    const tokens = decodePointer(path);
+    if (tokens.length === 0)
+        return { document: null, value: document };
+    const [parent, token] = parentAt(document, tokens, path);
+    if (Array.isArray(parent)) {
+        const index = arrayIndex(token, parent.length, false);
+        const value = parent[index];
+        parent.splice(index, 1);
+        return { document, value };
+    }
+    const object = objectOf(parent, path);
+    if (!(token in object))
+        throw new InvalidError(`JSON Patch path \`${path}\` does not exist`);
+    const value = object[token];
+    Reflect.deleteProperty(object, token);
+    return { document, value };
+}
+function equalJson(left, right) {
+    if (Object.is(left, right))
+        return true;
+    if (Array.isArray(left) && Array.isArray(right)) {
+        return (left.length === right.length && left.every((value, index) => equalJson(value, right[index])));
+    }
+    if (typeof left === "object" &&
+        left !== null &&
+        !Array.isArray(left) &&
+        typeof right === "object" &&
+        right !== null &&
+        !Array.isArray(right)) {
+        const a = left;
+        const b = right;
+        const keys = Object.keys(a);
+        return (keys.length === Object.keys(b).length &&
+            keys.every((key) => key in b && equalJson(a[key], b[key])));
+    }
+    return false;
+}
+function patchObject(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        throw new InvalidError("each JSON Patch operation must be an object");
+    }
+    return value;
+}
+export function applyJsonPatch(document, patch) {
+    if (!Array.isArray(patch))
+        throw new InvalidError("a JSON Patch document must be an array");
+    let result = structuredClone(document);
+    for (const raw of patch) {
+        const operation = patchObject(raw);
+        const op = operation["op"];
+        const path = operation["path"];
+        if (typeof op !== "string" || typeof path !== "string") {
+            throw new InvalidError("a JSON Patch operation requires string `op` and `path`");
+        }
+        switch (op) {
+            case "add":
+                if (!("value" in operation))
+                    throw new InvalidError("JSON Patch add requires `value`");
+                result = addValue(result, path, structuredClone(operation["value"]));
+                break;
+            case "remove":
+                result = removeValue(result, path).document;
+                break;
+            case "replace":
+                if (!("value" in operation))
+                    throw new InvalidError("JSON Patch replace requires `value`");
+                valueAt(result, path);
+                result = removeValue(result, path).document;
+                result = addValue(result, path, structuredClone(operation["value"]));
+                break;
+            case "move": {
+                const from = operation["from"];
+                if (typeof from !== "string")
+                    throw new InvalidError("JSON Patch move requires `from`");
+                if (path.startsWith(`${from}/`))
+                    throw new InvalidError("JSON Patch cannot move a value into its child");
+                const removed = removeValue(result, from);
+                result = addValue(removed.document, path, removed.value);
+                break;
+            }
+            case "copy": {
+                const from = operation["from"];
+                if (typeof from !== "string")
+                    throw new InvalidError("JSON Patch copy requires `from`");
+                result = addValue(result, path, structuredClone(valueAt(result, from)));
+                break;
+            }
+            case "test":
+                if (!("value" in operation))
+                    throw new InvalidError("JSON Patch test requires `value`");
+                if (!equalJson(valueAt(result, path), operation["value"])) {
+                    throw new InvalidError(`JSON Patch test failed at \`${path}\``);
+                }
+                break;
+            default:
+                throw new InvalidError(`unknown JSON Patch operation \`${op}\``);
+        }
+    }
+    return result;
+}
+function chunkKind(envelope) {
+    if (envelope.operation === OPERATION_REASONING)
+        return "reasoning";
+    if (envelope.operation === OPERATION_TOOL_ARGS)
+        return "toolArgs";
+    return "chat";
+}
+function chunkEvents(envelope, kind) {
+    const id = envelope.channel?.toString() ?? "";
+    const body = new TextDecoder().decode(envelope.body);
+    const opening = envelope.sequence === 0n;
+    const events = [];
+    if (kind === "chat") {
+        if (opening)
+            events.push({ type: "TEXT_MESSAGE_START", messageId: id, role: "assistant" });
+        if (body.length > 0)
+            events.push({ type: "TEXT_MESSAGE_CONTENT", messageId: id, delta: body });
+        if (envelope.last)
+            events.push({ type: "TEXT_MESSAGE_END", messageId: id });
+    }
+    else if (kind === "reasoning") {
+        if (opening)
+            events.push({ type: "REASONING_MESSAGE_START", messageId: id, role: "reasoning" });
+        if (body.length > 0)
+            events.push({ type: "REASONING_MESSAGE_CONTENT", messageId: id, delta: body });
+        if (envelope.last)
+            events.push({ type: "REASONING_MESSAGE_END", messageId: id });
+    }
+    else {
+        if (opening)
+            events.push({ type: "TOOL_CALL_START", toolCallId: id, toolCallName: envelope.tool ?? "" });
+        if (body.length > 0)
+            events.push({ type: "TOOL_CALL_ARGS", toolCallId: id, delta: body });
+        if (envelope.last)
+            events.push({ type: "TOOL_CALL_END", toolCallId: id });
+    }
+    return events;
+}
+export function envelopeToAgUi(envelope) {
+    if (envelope.kind === AgentKind.Status && envelope.operation === OPERATION_TASK) {
+        const threadId = envelope.conversation.toString();
+        const runId = envelope.correlation?.toString() ?? "";
+        if (envelope.taskState?.kind === "known" && envelope.taskState.name === "Submitted") {
+            return [{ type: "RUN_STARTED", threadId, runId }];
+        }
+        if (envelope.taskState !== undefined && taskStateIsTerminal(envelope.taskState)) {
+            return [{ type: "RUN_FINISHED", threadId, runId }];
+        }
+        return [];
+    }
+    if ((envelope.kind === AgentKind.Response || envelope.kind === AgentKind.Error) &&
+        envelope.tool !== undefined) {
+        return [
+            {
+                type: "TOOL_CALL_RESULT",
+                toolCallId: envelope.correlation?.toString() ?? "",
+                content: new TextDecoder().decode(envelope.body)
+            }
+        ];
+    }
+    if (envelope.kind === AgentKind.Error) {
+        return [{ type: "RUN_ERROR", message: new TextDecoder().decode(envelope.body) }];
+    }
+    if (envelope.kind === AgentKind.Event && envelope.operation === OPERATION_STATE_SNAPSHOT) {
+        try {
+            return [{ type: "STATE_SNAPSHOT", snapshot: parseJson(envelope.body, "state snapshot") }];
+        }
+        catch {
+            return [];
+        }
+    }
+    if (envelope.kind === AgentKind.Event && envelope.operation === OPERATION_STATE_DELTA) {
+        try {
+            return [{ type: "STATE_DELTA", delta: parseJson(envelope.body, "state delta") }];
+        }
+        catch {
+            return [];
+        }
+    }
+    return [];
+}
+export function envelopesToAgUi(envelopes) {
+    const channels = new Map();
+    const events = [];
+    for (const envelope of envelopes) {
+        if (envelope.kind !== AgentKind.Chunk) {
+            events.push(...envelopeToAgUi(envelope));
+            continue;
+        }
+        const id = envelope.channel?.toString() ?? "";
+        const kind = envelope.sequence === 0n ? chunkKind(envelope) : (channels.get(id) ?? "chat");
+        if (envelope.sequence === 0n)
+            channels.set(id, kind);
+        events.push(...chunkEvents(envelope, kind));
+    }
+    return events;
+}
+export async function publishStateSnapshot(laser, topic, source, conversation, state) {
+    await laser
+        .agdx(topic, source, conversation)
+        .emit(jsonBytes(state, "state snapshot"))
+        .withOperation(OPERATION_STATE_SNAPSHOT)
+        .contentType(ContentType.Json)
+        .send();
+}
+export async function publishStateDelta(laser, topic, source, conversation, patch) {
+    if (!Array.isArray(patch))
+        throw new InvalidError("an AG-UI state delta must be a JSON Patch array");
+    await laser
+        .agdx(topic, source, conversation)
+        .emit(jsonBytes(patch, "state delta"))
+        .withOperation(OPERATION_STATE_DELTA)
+        .contentType(ContentType.Json)
+        .send();
+}
+export async function reconstructState(laser, conversation, topic) {
+    const messages = await laser.context(conversation).fetch([topic], Number.MAX_SAFE_INTEGER);
+    let state = undefined;
+    for (const message of messages) {
+        const envelope = message.envelope;
+        if (envelope?.kind !== AgentKind.Event)
+            continue;
+        if (envelope.operation === OPERATION_STATE_SNAPSHOT) {
+            state = parseJson(envelope.body, "state snapshot");
+        }
+        else if (envelope.operation === OPERATION_STATE_DELTA && state !== undefined) {
+            state = applyJsonPatch(state, parseJson(envelope.body, "state delta"));
+        }
+    }
+    return state;
+}
+export async function aguiEvents(laser, conversation, topic) {
+    const messages = await laser.context(conversation).fetch([topic], Number.MAX_SAFE_INTEGER);
+    return envelopesToAgUi(messages.flatMap((message) => (message.envelope === undefined ? [] : [message.envelope])));
+}
+//# sourceMappingURL=agui.js.map