@copilotkit/shared 2.0.0-rc.18 → 2.0.0-rc.19

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -94,6 +94,22 @@ function createRunEventFinalizer() {
94
94
  terminalEventObserved = true;
95
95
  clearOpen();
96
96
  break;
97
+ case _ag_ui_client.EventType.TEXT_MESSAGE_CONTENT:
98
+ case _ag_ui_client.EventType.TEXT_MESSAGE_CHUNK:
99
+ case _ag_ui_client.EventType.TOOL_CALL_ARGS:
100
+ case _ag_ui_client.EventType.TOOL_CALL_CHUNK:
101
+ case _ag_ui_client.EventType.STATE_SNAPSHOT:
102
+ case _ag_ui_client.EventType.STATE_DELTA:
103
+ case _ag_ui_client.EventType.MESSAGES_SNAPSHOT:
104
+ case _ag_ui_client.EventType.ACTIVITY_SNAPSHOT:
105
+ case _ag_ui_client.EventType.ACTIVITY_DELTA:
106
+ case _ag_ui_client.EventType.RAW:
107
+ case _ag_ui_client.EventType.CUSTOM:
108
+ case _ag_ui_client.EventType.STEP_STARTED:
109
+ case _ag_ui_client.EventType.STEP_FINISHED:
110
+ case _ag_ui_client.EventType.REASONING_MESSAGE_CONTENT:
111
+ case _ag_ui_client.EventType.REASONING_MESSAGE_CHUNK:
112
+ case _ag_ui_client.EventType.REASONING_ENCRYPTED_VALUE:
97
113
  default: break;
98
114
  }
99
115
  };
@@ -1 +1 @@
1
- {"version":3,"file":"finalize-events.cjs","names":["EventType"],"sources":["../src/finalize-events.ts"],"sourcesContent":["import type { BaseEvent, RunErrorEvent } from \"@ag-ui/client\";\nimport { EventType } from \"@ag-ui/client\";\n\nexport interface FinalizeRunOptions {\n stopRequested?: boolean;\n interruptionMessage?: string;\n /**\n * The `protocolVersion` the client declared on its RunAgentInput. When it is\n * set, a stopped run finishes with the AG-UI 1.0 `cancelled` outcome. A\n * client that declares no version predates 1.0 and cannot parse that\n * outcome, so it gets the plain RUN_FINISHED it always got.\n */\n protocolVersion?: string;\n}\n\nexport interface RunEventFinalizer {\n /** Observe one streamed event. Only the ids of open lifecycles are kept. */\n observe(event: BaseEvent): void;\n /** Return the events that close an interrupted or abruptly ended stream. */\n finalize(options?: FinalizeRunOptions): BaseEvent[];\n}\n\nconst defaultStopMessage = \"Run stopped by user\";\nconst defaultAbruptEndMessage = \"Run ended without emitting a terminal event\";\n\ninterface OpenToolCall {\n hasEnd: boolean;\n hasResult: boolean;\n}\n\n/**\n * Incremental finalizer for a streamed AG-UI run. Feed every event to\n * `observe`; when the stream ends without a terminal event, `finalize` returns\n * the closers for reasoning, text messages and tool calls still open plus a\n * terminal event. AG-UI 1.0 fails a run that ends with reasoning still open,\n * so reasoning is closed too. It also fails a RUN_FINISHED while a subagent\n * is still open, so a stop closes open subagents as well; a RUN_ERROR\n * abandons them, which the protocol allows. Closed lifecycles are forgotten at once and payloads are never kept,\n * so a caller does not have to retain the event array for this purpose.\n */\nexport function createRunEventFinalizer(): RunEventFinalizer {\n const openMessageIds = new Set<string>();\n const openReasoningMessageIds = new Set<string>();\n const openReasoningSpanIds = new Set<string>();\n const openToolCalls = new Map<string, OpenToolCall>();\n // Insertion order is start order, so closing in reverse closes children first.\n const openSubagentRunIds = new Set<string>();\n let runIdentity: { threadId?: string; runId?: string } = {};\n let terminalEventObserved = false;\n\n const clearOpen = () => {\n openMessageIds.clear();\n openReasoningMessageIds.clear();\n openReasoningSpanIds.clear();\n openToolCalls.clear();\n openSubagentRunIds.clear();\n };\n\n const observe = (event: BaseEvent) => {\n if (terminalEventObserved) return;\n\n switch (event.type) {\n case EventType.RUN_STARTED: {\n const { threadId, runId } = event as {\n threadId?: string;\n runId?: string;\n };\n runIdentity = { threadId, runId };\n break;\n }\n case EventType.REASONING_START:\n case EventType.REASONING_END:\n case EventType.REASONING_MESSAGE_START:\n case EventType.REASONING_MESSAGE_END: {\n const messageId = (event as { messageId?: string }).messageId;\n if (typeof messageId !== \"string\") break;\n const open =\n event.type === EventType.REASONING_START ||\n event.type === EventType.REASONING_END\n ? openReasoningSpanIds\n : openReasoningMessageIds;\n if (\n event.type === EventType.REASONING_START ||\n event.type === EventType.REASONING_MESSAGE_START\n ) {\n open.add(messageId);\n } else {\n open.delete(messageId);\n }\n break;\n }\n case EventType.TEXT_MESSAGE_START: {\n const messageId = (event as { messageId?: string }).messageId;\n if (messageId) openMessageIds.add(messageId);\n break;\n }\n case EventType.TEXT_MESSAGE_END: {\n const messageId = (event as { messageId?: string }).messageId;\n if (typeof messageId === \"string\") openMessageIds.delete(messageId);\n break;\n }\n case EventType.TOOL_CALL_START: {\n const toolCallId = (event as { toolCallId?: string }).toolCallId;\n if (toolCallId && !openToolCalls.has(toolCallId)) {\n openToolCalls.set(toolCallId, { hasEnd: false, hasResult: false });\n }\n break;\n }\n case EventType.TOOL_CALL_END:\n case EventType.TOOL_CALL_RESULT: {\n const toolCallId = (event as { toolCallId?: string }).toolCallId;\n if (!toolCallId) break;\n const info = openToolCalls.get(toolCallId);\n if (!info) break;\n\n if (event.type === EventType.TOOL_CALL_END) info.hasEnd = true;\n else info.hasResult = true;\n if (info.hasEnd && info.hasResult) openToolCalls.delete(toolCallId);\n break;\n }\n case EventType.SUBAGENT_STARTED:\n case EventType.SUBAGENT_FINISHED:\n case EventType.SUBAGENT_ERROR: {\n const subagentRunId = (event as { subagentRunId?: string })\n .subagentRunId;\n if (!subagentRunId) break;\n if (event.type === EventType.SUBAGENT_STARTED) {\n openSubagentRunIds.add(subagentRunId);\n } else {\n openSubagentRunIds.delete(subagentRunId);\n }\n break;\n }\n case EventType.RUN_FINISHED:\n case EventType.RUN_ERROR:\n terminalEventObserved = true;\n clearOpen();\n break;\n default:\n break;\n }\n };\n\n const finalize = (options: FinalizeRunOptions = {}): BaseEvent[] => {\n if (terminalEventObserved) return [];\n\n const { stopRequested = false, interruptionMessage } = options;\n const resolvedStopMessage = interruptionMessage ?? defaultStopMessage;\n const resolvedAbruptMessage =\n interruptionMessage && interruptionMessage !== defaultStopMessage\n ? interruptionMessage\n : defaultAbruptEndMessage;\n const appended: BaseEvent[] = [];\n\n // A reasoning message closes before the span that holds it.\n for (const messageId of openReasoningMessageIds) {\n appended.push({\n type: EventType.REASONING_MESSAGE_END,\n messageId,\n } as BaseEvent);\n }\n for (const messageId of openReasoningSpanIds) {\n appended.push({ type: EventType.REASONING_END, messageId } as BaseEvent);\n }\n\n for (const messageId of openMessageIds) {\n appended.push({\n type: EventType.TEXT_MESSAGE_END,\n messageId,\n } as BaseEvent);\n }\n\n for (const [toolCallId, info] of openToolCalls) {\n if (!info.hasEnd) {\n appended.push({\n type: EventType.TOOL_CALL_END,\n toolCallId,\n } as BaseEvent);\n }\n\n if (!info.hasResult) {\n appended.push({\n type: EventType.TOOL_CALL_RESULT,\n toolCallId,\n messageId: `${toolCallId}-result`,\n role: \"tool\",\n content: JSON.stringify(\n stopRequested\n ? {\n status: \"stopped\",\n reason: \"stop_requested\",\n message: resolvedStopMessage,\n }\n : {\n status: \"error\",\n reason: \"missing_terminal_event\",\n message: resolvedAbruptMessage,\n },\n ),\n } as BaseEvent);\n }\n }\n\n if (stopRequested) {\n // Newest first, so a nested subagent closes before its parent. An index\n // loop, because `toReversed` is ES2023 and this package targets older.\n const openIds = [...openSubagentRunIds];\n for (let index = openIds.length - 1; index >= 0; index -= 1) {\n appended.push({\n type: EventType.SUBAGENT_ERROR,\n subagentRunId: openIds[index],\n message: resolvedStopMessage,\n code: \"CANCELLED\",\n } as BaseEvent);\n }\n appended.push({\n type: EventType.RUN_FINISHED,\n ...(runIdentity.threadId !== undefined\n ? { threadId: runIdentity.threadId }\n : {}),\n ...(runIdentity.runId !== undefined\n ? { runId: runIdentity.runId }\n : {}),\n ...(options.protocolVersion !== undefined\n ? { outcome: { type: \"cancelled\" } }\n : {}),\n } as BaseEvent);\n } else {\n const errorEvent: RunErrorEvent = {\n type: EventType.RUN_ERROR,\n message: resolvedAbruptMessage,\n code: \"INCOMPLETE_STREAM\",\n };\n appended.push(errorEvent);\n }\n\n terminalEventObserved = true;\n clearOpen();\n return appended;\n };\n\n return { observe, finalize };\n}\n\n/**\n * Array form of {@link createRunEventFinalizer} for callers that already keep\n * the run's events (runners persist them). Appends the closers to `events` in\n * place and returns them.\n */\nexport function finalizeRunEvents(\n events: BaseEvent[],\n options: FinalizeRunOptions = {},\n): BaseEvent[] {\n const finalizer = createRunEventFinalizer();\n for (const event of events) finalizer.observe(event);\n\n const appended = finalizer.finalize(options);\n events.push(...appended);\n return appended;\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"finalize-events.cjs","names":["EventType"],"sources":["../src/finalize-events.ts"],"sourcesContent":["import type { BaseEvent, RunErrorEvent } from \"@ag-ui/client\";\nimport { EventType } from \"@ag-ui/client\";\n\nexport interface FinalizeRunOptions {\n stopRequested?: boolean;\n interruptionMessage?: string;\n /**\n * The `protocolVersion` the client declared on its RunAgentInput. When it is\n * set, a stopped run finishes with the AG-UI 1.0 `cancelled` outcome. A\n * client that declares no version predates 1.0 and cannot parse that\n * outcome, so it gets the plain RUN_FINISHED it always got.\n */\n protocolVersion?: string;\n}\n\nexport interface RunEventFinalizer {\n /** Observe one streamed event. Only the ids of open lifecycles are kept. */\n observe(event: BaseEvent): void;\n /** Return the events that close an interrupted or abruptly ended stream. */\n finalize(options?: FinalizeRunOptions): BaseEvent[];\n}\n\nconst defaultStopMessage = \"Run stopped by user\";\nconst defaultAbruptEndMessage = \"Run ended without emitting a terminal event\";\n\ninterface OpenToolCall {\n hasEnd: boolean;\n hasResult: boolean;\n}\n\n/**\n * Incremental finalizer for a streamed AG-UI run. Feed every event to\n * `observe`; when the stream ends without a terminal event, `finalize` returns\n * the closers for reasoning, text messages and tool calls still open plus a\n * terminal event. AG-UI 1.0 fails a run that ends with reasoning still open,\n * so reasoning is closed too. It also fails a RUN_FINISHED while a subagent\n * is still open, so a stop closes open subagents as well; a RUN_ERROR\n * abandons them, which the protocol allows. Closed lifecycles are forgotten at once and payloads are never kept,\n * so a caller does not have to retain the event array for this purpose.\n */\nexport function createRunEventFinalizer(): RunEventFinalizer {\n const openMessageIds = new Set<string>();\n const openReasoningMessageIds = new Set<string>();\n const openReasoningSpanIds = new Set<string>();\n const openToolCalls = new Map<string, OpenToolCall>();\n // Insertion order is start order, so closing in reverse closes children first.\n const openSubagentRunIds = new Set<string>();\n let runIdentity: { threadId?: string; runId?: string } = {};\n let terminalEventObserved = false;\n\n const clearOpen = () => {\n openMessageIds.clear();\n openReasoningMessageIds.clear();\n openReasoningSpanIds.clear();\n openToolCalls.clear();\n openSubagentRunIds.clear();\n };\n\n const observe = (event: BaseEvent) => {\n if (terminalEventObserved) return;\n\n switch (event.type) {\n case EventType.RUN_STARTED: {\n const { threadId, runId } = event as {\n threadId?: string;\n runId?: string;\n };\n runIdentity = { threadId, runId };\n break;\n }\n case EventType.REASONING_START:\n case EventType.REASONING_END:\n case EventType.REASONING_MESSAGE_START:\n case EventType.REASONING_MESSAGE_END: {\n const messageId = (event as { messageId?: string }).messageId;\n if (typeof messageId !== \"string\") break;\n const open =\n event.type === EventType.REASONING_START ||\n event.type === EventType.REASONING_END\n ? openReasoningSpanIds\n : openReasoningMessageIds;\n if (\n event.type === EventType.REASONING_START ||\n event.type === EventType.REASONING_MESSAGE_START\n ) {\n open.add(messageId);\n } else {\n open.delete(messageId);\n }\n break;\n }\n case EventType.TEXT_MESSAGE_START: {\n const messageId = (event as { messageId?: string }).messageId;\n if (messageId) openMessageIds.add(messageId);\n break;\n }\n case EventType.TEXT_MESSAGE_END: {\n const messageId = (event as { messageId?: string }).messageId;\n if (typeof messageId === \"string\") openMessageIds.delete(messageId);\n break;\n }\n case EventType.TOOL_CALL_START: {\n const toolCallId = (event as { toolCallId?: string }).toolCallId;\n if (toolCallId && !openToolCalls.has(toolCallId)) {\n openToolCalls.set(toolCallId, { hasEnd: false, hasResult: false });\n }\n break;\n }\n case EventType.TOOL_CALL_END:\n case EventType.TOOL_CALL_RESULT: {\n const toolCallId = (event as { toolCallId?: string }).toolCallId;\n if (!toolCallId) break;\n const info = openToolCalls.get(toolCallId);\n if (!info) break;\n\n if (event.type === EventType.TOOL_CALL_END) info.hasEnd = true;\n else info.hasResult = true;\n if (info.hasEnd && info.hasResult) openToolCalls.delete(toolCallId);\n break;\n }\n case EventType.SUBAGENT_STARTED:\n case EventType.SUBAGENT_FINISHED:\n case EventType.SUBAGENT_ERROR: {\n const subagentRunId = (event as { subagentRunId?: string })\n .subagentRunId;\n if (!subagentRunId) break;\n if (event.type === EventType.SUBAGENT_STARTED) {\n openSubagentRunIds.add(subagentRunId);\n } else {\n openSubagentRunIds.delete(subagentRunId);\n }\n break;\n }\n case EventType.RUN_FINISHED:\n case EventType.RUN_ERROR:\n terminalEventObserved = true;\n clearOpen();\n break;\n case EventType.TEXT_MESSAGE_CONTENT:\n case EventType.TEXT_MESSAGE_CHUNK:\n case EventType.TOOL_CALL_ARGS:\n case EventType.TOOL_CALL_CHUNK:\n case EventType.STATE_SNAPSHOT:\n case EventType.STATE_DELTA:\n case EventType.MESSAGES_SNAPSHOT:\n case EventType.ACTIVITY_SNAPSHOT:\n case EventType.ACTIVITY_DELTA:\n case EventType.RAW:\n case EventType.CUSTOM:\n case EventType.STEP_STARTED:\n case EventType.STEP_FINISHED:\n case EventType.REASONING_MESSAGE_CONTENT:\n case EventType.REASONING_MESSAGE_CHUNK:\n case EventType.REASONING_ENCRYPTED_VALUE:\n default:\n break;\n }\n };\n\n const finalize = (options: FinalizeRunOptions = {}): BaseEvent[] => {\n if (terminalEventObserved) return [];\n\n const { stopRequested = false, interruptionMessage } = options;\n const resolvedStopMessage = interruptionMessage ?? defaultStopMessage;\n const resolvedAbruptMessage =\n interruptionMessage && interruptionMessage !== defaultStopMessage\n ? interruptionMessage\n : defaultAbruptEndMessage;\n const appended: BaseEvent[] = [];\n\n // A reasoning message closes before the span that holds it.\n for (const messageId of openReasoningMessageIds) {\n appended.push({\n type: EventType.REASONING_MESSAGE_END,\n messageId,\n } as BaseEvent);\n }\n for (const messageId of openReasoningSpanIds) {\n appended.push({ type: EventType.REASONING_END, messageId } as BaseEvent);\n }\n\n for (const messageId of openMessageIds) {\n appended.push({\n type: EventType.TEXT_MESSAGE_END,\n messageId,\n } as BaseEvent);\n }\n\n for (const [toolCallId, info] of openToolCalls) {\n if (!info.hasEnd) {\n appended.push({\n type: EventType.TOOL_CALL_END,\n toolCallId,\n } as BaseEvent);\n }\n\n if (!info.hasResult) {\n appended.push({\n type: EventType.TOOL_CALL_RESULT,\n toolCallId,\n messageId: `${toolCallId}-result`,\n role: \"tool\",\n content: JSON.stringify(\n stopRequested\n ? {\n status: \"stopped\",\n reason: \"stop_requested\",\n message: resolvedStopMessage,\n }\n : {\n status: \"error\",\n reason: \"missing_terminal_event\",\n message: resolvedAbruptMessage,\n },\n ),\n } as BaseEvent);\n }\n }\n\n if (stopRequested) {\n // Newest first, so a nested subagent closes before its parent. An index\n // loop, because `toReversed` is ES2023 and this package targets older.\n const openIds = [...openSubagentRunIds];\n for (let index = openIds.length - 1; index >= 0; index -= 1) {\n appended.push({\n type: EventType.SUBAGENT_ERROR,\n subagentRunId: openIds[index],\n message: resolvedStopMessage,\n code: \"CANCELLED\",\n } as BaseEvent);\n }\n appended.push({\n type: EventType.RUN_FINISHED,\n ...(runIdentity.threadId !== undefined\n ? { threadId: runIdentity.threadId }\n : {}),\n ...(runIdentity.runId !== undefined\n ? { runId: runIdentity.runId }\n : {}),\n ...(options.protocolVersion !== undefined\n ? { outcome: { type: \"cancelled\" } }\n : {}),\n } as BaseEvent);\n } else {\n const errorEvent: RunErrorEvent = {\n type: EventType.RUN_ERROR,\n message: resolvedAbruptMessage,\n code: \"INCOMPLETE_STREAM\",\n };\n appended.push(errorEvent);\n }\n\n terminalEventObserved = true;\n clearOpen();\n return appended;\n };\n\n return { observe, finalize };\n}\n\n/**\n * Array form of {@link createRunEventFinalizer} for callers that already keep\n * the run's events (runners persist them). Appends the closers to `events` in\n * place and returns them.\n */\nexport function finalizeRunEvents(\n events: BaseEvent[],\n options: FinalizeRunOptions = {},\n): BaseEvent[] {\n const finalizer = createRunEventFinalizer();\n for (const event of events) finalizer.observe(event);\n\n const appended = finalizer.finalize(options);\n events.push(...appended);\n return appended;\n}\n"],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"finalize-events.d.cts","names":[],"sources":["../src/finalize-events.ts"],"mappings":";;;UAGiB,kBAAA;EACf,aAAA;EACA,mBAAA;EAFiC;;;;;;EASjC,eAAA;AAAA;AAAA,UAGe,iBAAA;EAAiB;EAEhC,OAAA,CAAQ,KAAA,EAAO,SAAA;EAAA;EAEf,QAAA,CAAS,OAAA,GAAU,kBAAA,GAAqB,SAAA;AAAA;;;;;;;;;;;iBAqB1B,uBAAA,CAAA,GAA2B,iBAAA;AAA3C;;;;;AAAA,iBAiNgB,iBAAA,CACd,MAAA,EAAQ,SAAA,IACR,OAAA,GAAS,kBAAA,GACR,SAAA"}
1
+ {"version":3,"file":"finalize-events.d.cts","names":[],"sources":["../src/finalize-events.ts"],"mappings":";;;UAGiB,kBAAA;EACf,aAAA;EACA,mBAAA;EAFiC;;;;;;EASjC,eAAA;AAAA;AAAA,UAGe,iBAAA;EAAiB;EAEhC,OAAA,CAAQ,KAAA,EAAO,SAAA;EAAA;EAEf,QAAA,CAAS,OAAA,GAAU,kBAAA,GAAqB,SAAA;AAAA;;;;;;;;;;;iBAqB1B,uBAAA,CAAA,GAA2B,iBAAA;AAA3C;;;;;AAAA,iBAiOgB,iBAAA,CACd,MAAA,EAAQ,SAAA,IACR,OAAA,GAAS,kBAAA,GACR,SAAA"}
@@ -1 +1 @@
1
- {"version":3,"file":"finalize-events.d.mts","names":[],"sources":["../src/finalize-events.ts"],"mappings":";;;UAGiB,kBAAA;EACf,aAAA;EACA,mBAAA;EAFiC;;;;;;EASjC,eAAA;AAAA;AAAA,UAGe,iBAAA;EAAiB;EAEhC,OAAA,CAAQ,KAAA,EAAO,SAAA;EAAA;EAEf,QAAA,CAAS,OAAA,GAAU,kBAAA,GAAqB,SAAA;AAAA;;;;;;;;;;;iBAqB1B,uBAAA,CAAA,GAA2B,iBAAA;AAA3C;;;;;AAAA,iBAiNgB,iBAAA,CACd,MAAA,EAAQ,SAAA,IACR,OAAA,GAAS,kBAAA,GACR,SAAA"}
1
+ {"version":3,"file":"finalize-events.d.mts","names":[],"sources":["../src/finalize-events.ts"],"mappings":";;;UAGiB,kBAAA;EACf,aAAA;EACA,mBAAA;EAFiC;;;;;;EASjC,eAAA;AAAA;AAAA,UAGe,iBAAA;EAAiB;EAEhC,OAAA,CAAQ,KAAA,EAAO,SAAA;EAAA;EAEf,QAAA,CAAS,OAAA,GAAU,kBAAA,GAAqB,SAAA;AAAA;;;;;;;;;;;iBAqB1B,uBAAA,CAAA,GAA2B,iBAAA;AAA3C;;;;;AAAA,iBAiOgB,iBAAA,CACd,MAAA,EAAQ,SAAA,IACR,OAAA,GAAS,kBAAA,GACR,SAAA"}
@@ -93,6 +93,22 @@ function createRunEventFinalizer() {
93
93
  terminalEventObserved = true;
94
94
  clearOpen();
95
95
  break;
96
+ case EventType.TEXT_MESSAGE_CONTENT:
97
+ case EventType.TEXT_MESSAGE_CHUNK:
98
+ case EventType.TOOL_CALL_ARGS:
99
+ case EventType.TOOL_CALL_CHUNK:
100
+ case EventType.STATE_SNAPSHOT:
101
+ case EventType.STATE_DELTA:
102
+ case EventType.MESSAGES_SNAPSHOT:
103
+ case EventType.ACTIVITY_SNAPSHOT:
104
+ case EventType.ACTIVITY_DELTA:
105
+ case EventType.RAW:
106
+ case EventType.CUSTOM:
107
+ case EventType.STEP_STARTED:
108
+ case EventType.STEP_FINISHED:
109
+ case EventType.REASONING_MESSAGE_CONTENT:
110
+ case EventType.REASONING_MESSAGE_CHUNK:
111
+ case EventType.REASONING_ENCRYPTED_VALUE:
96
112
  default: break;
97
113
  }
98
114
  };
@@ -1 +1 @@
1
- {"version":3,"file":"finalize-events.mjs","names":[],"sources":["../src/finalize-events.ts"],"sourcesContent":["import type { BaseEvent, RunErrorEvent } from \"@ag-ui/client\";\nimport { EventType } from \"@ag-ui/client\";\n\nexport interface FinalizeRunOptions {\n stopRequested?: boolean;\n interruptionMessage?: string;\n /**\n * The `protocolVersion` the client declared on its RunAgentInput. When it is\n * set, a stopped run finishes with the AG-UI 1.0 `cancelled` outcome. A\n * client that declares no version predates 1.0 and cannot parse that\n * outcome, so it gets the plain RUN_FINISHED it always got.\n */\n protocolVersion?: string;\n}\n\nexport interface RunEventFinalizer {\n /** Observe one streamed event. Only the ids of open lifecycles are kept. */\n observe(event: BaseEvent): void;\n /** Return the events that close an interrupted or abruptly ended stream. */\n finalize(options?: FinalizeRunOptions): BaseEvent[];\n}\n\nconst defaultStopMessage = \"Run stopped by user\";\nconst defaultAbruptEndMessage = \"Run ended without emitting a terminal event\";\n\ninterface OpenToolCall {\n hasEnd: boolean;\n hasResult: boolean;\n}\n\n/**\n * Incremental finalizer for a streamed AG-UI run. Feed every event to\n * `observe`; when the stream ends without a terminal event, `finalize` returns\n * the closers for reasoning, text messages and tool calls still open plus a\n * terminal event. AG-UI 1.0 fails a run that ends with reasoning still open,\n * so reasoning is closed too. It also fails a RUN_FINISHED while a subagent\n * is still open, so a stop closes open subagents as well; a RUN_ERROR\n * abandons them, which the protocol allows. Closed lifecycles are forgotten at once and payloads are never kept,\n * so a caller does not have to retain the event array for this purpose.\n */\nexport function createRunEventFinalizer(): RunEventFinalizer {\n const openMessageIds = new Set<string>();\n const openReasoningMessageIds = new Set<string>();\n const openReasoningSpanIds = new Set<string>();\n const openToolCalls = new Map<string, OpenToolCall>();\n // Insertion order is start order, so closing in reverse closes children first.\n const openSubagentRunIds = new Set<string>();\n let runIdentity: { threadId?: string; runId?: string } = {};\n let terminalEventObserved = false;\n\n const clearOpen = () => {\n openMessageIds.clear();\n openReasoningMessageIds.clear();\n openReasoningSpanIds.clear();\n openToolCalls.clear();\n openSubagentRunIds.clear();\n };\n\n const observe = (event: BaseEvent) => {\n if (terminalEventObserved) return;\n\n switch (event.type) {\n case EventType.RUN_STARTED: {\n const { threadId, runId } = event as {\n threadId?: string;\n runId?: string;\n };\n runIdentity = { threadId, runId };\n break;\n }\n case EventType.REASONING_START:\n case EventType.REASONING_END:\n case EventType.REASONING_MESSAGE_START:\n case EventType.REASONING_MESSAGE_END: {\n const messageId = (event as { messageId?: string }).messageId;\n if (typeof messageId !== \"string\") break;\n const open =\n event.type === EventType.REASONING_START ||\n event.type === EventType.REASONING_END\n ? openReasoningSpanIds\n : openReasoningMessageIds;\n if (\n event.type === EventType.REASONING_START ||\n event.type === EventType.REASONING_MESSAGE_START\n ) {\n open.add(messageId);\n } else {\n open.delete(messageId);\n }\n break;\n }\n case EventType.TEXT_MESSAGE_START: {\n const messageId = (event as { messageId?: string }).messageId;\n if (messageId) openMessageIds.add(messageId);\n break;\n }\n case EventType.TEXT_MESSAGE_END: {\n const messageId = (event as { messageId?: string }).messageId;\n if (typeof messageId === \"string\") openMessageIds.delete(messageId);\n break;\n }\n case EventType.TOOL_CALL_START: {\n const toolCallId = (event as { toolCallId?: string }).toolCallId;\n if (toolCallId && !openToolCalls.has(toolCallId)) {\n openToolCalls.set(toolCallId, { hasEnd: false, hasResult: false });\n }\n break;\n }\n case EventType.TOOL_CALL_END:\n case EventType.TOOL_CALL_RESULT: {\n const toolCallId = (event as { toolCallId?: string }).toolCallId;\n if (!toolCallId) break;\n const info = openToolCalls.get(toolCallId);\n if (!info) break;\n\n if (event.type === EventType.TOOL_CALL_END) info.hasEnd = true;\n else info.hasResult = true;\n if (info.hasEnd && info.hasResult) openToolCalls.delete(toolCallId);\n break;\n }\n case EventType.SUBAGENT_STARTED:\n case EventType.SUBAGENT_FINISHED:\n case EventType.SUBAGENT_ERROR: {\n const subagentRunId = (event as { subagentRunId?: string })\n .subagentRunId;\n if (!subagentRunId) break;\n if (event.type === EventType.SUBAGENT_STARTED) {\n openSubagentRunIds.add(subagentRunId);\n } else {\n openSubagentRunIds.delete(subagentRunId);\n }\n break;\n }\n case EventType.RUN_FINISHED:\n case EventType.RUN_ERROR:\n terminalEventObserved = true;\n clearOpen();\n break;\n default:\n break;\n }\n };\n\n const finalize = (options: FinalizeRunOptions = {}): BaseEvent[] => {\n if (terminalEventObserved) return [];\n\n const { stopRequested = false, interruptionMessage } = options;\n const resolvedStopMessage = interruptionMessage ?? defaultStopMessage;\n const resolvedAbruptMessage =\n interruptionMessage && interruptionMessage !== defaultStopMessage\n ? interruptionMessage\n : defaultAbruptEndMessage;\n const appended: BaseEvent[] = [];\n\n // A reasoning message closes before the span that holds it.\n for (const messageId of openReasoningMessageIds) {\n appended.push({\n type: EventType.REASONING_MESSAGE_END,\n messageId,\n } as BaseEvent);\n }\n for (const messageId of openReasoningSpanIds) {\n appended.push({ type: EventType.REASONING_END, messageId } as BaseEvent);\n }\n\n for (const messageId of openMessageIds) {\n appended.push({\n type: EventType.TEXT_MESSAGE_END,\n messageId,\n } as BaseEvent);\n }\n\n for (const [toolCallId, info] of openToolCalls) {\n if (!info.hasEnd) {\n appended.push({\n type: EventType.TOOL_CALL_END,\n toolCallId,\n } as BaseEvent);\n }\n\n if (!info.hasResult) {\n appended.push({\n type: EventType.TOOL_CALL_RESULT,\n toolCallId,\n messageId: `${toolCallId}-result`,\n role: \"tool\",\n content: JSON.stringify(\n stopRequested\n ? {\n status: \"stopped\",\n reason: \"stop_requested\",\n message: resolvedStopMessage,\n }\n : {\n status: \"error\",\n reason: \"missing_terminal_event\",\n message: resolvedAbruptMessage,\n },\n ),\n } as BaseEvent);\n }\n }\n\n if (stopRequested) {\n // Newest first, so a nested subagent closes before its parent. An index\n // loop, because `toReversed` is ES2023 and this package targets older.\n const openIds = [...openSubagentRunIds];\n for (let index = openIds.length - 1; index >= 0; index -= 1) {\n appended.push({\n type: EventType.SUBAGENT_ERROR,\n subagentRunId: openIds[index],\n message: resolvedStopMessage,\n code: \"CANCELLED\",\n } as BaseEvent);\n }\n appended.push({\n type: EventType.RUN_FINISHED,\n ...(runIdentity.threadId !== undefined\n ? { threadId: runIdentity.threadId }\n : {}),\n ...(runIdentity.runId !== undefined\n ? { runId: runIdentity.runId }\n : {}),\n ...(options.protocolVersion !== undefined\n ? { outcome: { type: \"cancelled\" } }\n : {}),\n } as BaseEvent);\n } else {\n const errorEvent: RunErrorEvent = {\n type: EventType.RUN_ERROR,\n message: resolvedAbruptMessage,\n code: \"INCOMPLETE_STREAM\",\n };\n appended.push(errorEvent);\n }\n\n terminalEventObserved = true;\n clearOpen();\n return appended;\n };\n\n return { observe, finalize };\n}\n\n/**\n * Array form of {@link createRunEventFinalizer} for callers that already keep\n * the run's events (runners persist them). Appends the closers to `events` in\n * place and returns them.\n */\nexport function finalizeRunEvents(\n events: BaseEvent[],\n options: FinalizeRunOptions = {},\n): BaseEvent[] {\n const finalizer = createRunEventFinalizer();\n for (const event of events) finalizer.observe(event);\n\n const appended = finalizer.finalize(options);\n events.push(...appended);\n return appended;\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"finalize-events.mjs","names":[],"sources":["../src/finalize-events.ts"],"sourcesContent":["import type { BaseEvent, RunErrorEvent } from \"@ag-ui/client\";\nimport { EventType } from \"@ag-ui/client\";\n\nexport interface FinalizeRunOptions {\n stopRequested?: boolean;\n interruptionMessage?: string;\n /**\n * The `protocolVersion` the client declared on its RunAgentInput. When it is\n * set, a stopped run finishes with the AG-UI 1.0 `cancelled` outcome. A\n * client that declares no version predates 1.0 and cannot parse that\n * outcome, so it gets the plain RUN_FINISHED it always got.\n */\n protocolVersion?: string;\n}\n\nexport interface RunEventFinalizer {\n /** Observe one streamed event. Only the ids of open lifecycles are kept. */\n observe(event: BaseEvent): void;\n /** Return the events that close an interrupted or abruptly ended stream. */\n finalize(options?: FinalizeRunOptions): BaseEvent[];\n}\n\nconst defaultStopMessage = \"Run stopped by user\";\nconst defaultAbruptEndMessage = \"Run ended without emitting a terminal event\";\n\ninterface OpenToolCall {\n hasEnd: boolean;\n hasResult: boolean;\n}\n\n/**\n * Incremental finalizer for a streamed AG-UI run. Feed every event to\n * `observe`; when the stream ends without a terminal event, `finalize` returns\n * the closers for reasoning, text messages and tool calls still open plus a\n * terminal event. AG-UI 1.0 fails a run that ends with reasoning still open,\n * so reasoning is closed too. It also fails a RUN_FINISHED while a subagent\n * is still open, so a stop closes open subagents as well; a RUN_ERROR\n * abandons them, which the protocol allows. Closed lifecycles are forgotten at once and payloads are never kept,\n * so a caller does not have to retain the event array for this purpose.\n */\nexport function createRunEventFinalizer(): RunEventFinalizer {\n const openMessageIds = new Set<string>();\n const openReasoningMessageIds = new Set<string>();\n const openReasoningSpanIds = new Set<string>();\n const openToolCalls = new Map<string, OpenToolCall>();\n // Insertion order is start order, so closing in reverse closes children first.\n const openSubagentRunIds = new Set<string>();\n let runIdentity: { threadId?: string; runId?: string } = {};\n let terminalEventObserved = false;\n\n const clearOpen = () => {\n openMessageIds.clear();\n openReasoningMessageIds.clear();\n openReasoningSpanIds.clear();\n openToolCalls.clear();\n openSubagentRunIds.clear();\n };\n\n const observe = (event: BaseEvent) => {\n if (terminalEventObserved) return;\n\n switch (event.type) {\n case EventType.RUN_STARTED: {\n const { threadId, runId } = event as {\n threadId?: string;\n runId?: string;\n };\n runIdentity = { threadId, runId };\n break;\n }\n case EventType.REASONING_START:\n case EventType.REASONING_END:\n case EventType.REASONING_MESSAGE_START:\n case EventType.REASONING_MESSAGE_END: {\n const messageId = (event as { messageId?: string }).messageId;\n if (typeof messageId !== \"string\") break;\n const open =\n event.type === EventType.REASONING_START ||\n event.type === EventType.REASONING_END\n ? openReasoningSpanIds\n : openReasoningMessageIds;\n if (\n event.type === EventType.REASONING_START ||\n event.type === EventType.REASONING_MESSAGE_START\n ) {\n open.add(messageId);\n } else {\n open.delete(messageId);\n }\n break;\n }\n case EventType.TEXT_MESSAGE_START: {\n const messageId = (event as { messageId?: string }).messageId;\n if (messageId) openMessageIds.add(messageId);\n break;\n }\n case EventType.TEXT_MESSAGE_END: {\n const messageId = (event as { messageId?: string }).messageId;\n if (typeof messageId === \"string\") openMessageIds.delete(messageId);\n break;\n }\n case EventType.TOOL_CALL_START: {\n const toolCallId = (event as { toolCallId?: string }).toolCallId;\n if (toolCallId && !openToolCalls.has(toolCallId)) {\n openToolCalls.set(toolCallId, { hasEnd: false, hasResult: false });\n }\n break;\n }\n case EventType.TOOL_CALL_END:\n case EventType.TOOL_CALL_RESULT: {\n const toolCallId = (event as { toolCallId?: string }).toolCallId;\n if (!toolCallId) break;\n const info = openToolCalls.get(toolCallId);\n if (!info) break;\n\n if (event.type === EventType.TOOL_CALL_END) info.hasEnd = true;\n else info.hasResult = true;\n if (info.hasEnd && info.hasResult) openToolCalls.delete(toolCallId);\n break;\n }\n case EventType.SUBAGENT_STARTED:\n case EventType.SUBAGENT_FINISHED:\n case EventType.SUBAGENT_ERROR: {\n const subagentRunId = (event as { subagentRunId?: string })\n .subagentRunId;\n if (!subagentRunId) break;\n if (event.type === EventType.SUBAGENT_STARTED) {\n openSubagentRunIds.add(subagentRunId);\n } else {\n openSubagentRunIds.delete(subagentRunId);\n }\n break;\n }\n case EventType.RUN_FINISHED:\n case EventType.RUN_ERROR:\n terminalEventObserved = true;\n clearOpen();\n break;\n case EventType.TEXT_MESSAGE_CONTENT:\n case EventType.TEXT_MESSAGE_CHUNK:\n case EventType.TOOL_CALL_ARGS:\n case EventType.TOOL_CALL_CHUNK:\n case EventType.STATE_SNAPSHOT:\n case EventType.STATE_DELTA:\n case EventType.MESSAGES_SNAPSHOT:\n case EventType.ACTIVITY_SNAPSHOT:\n case EventType.ACTIVITY_DELTA:\n case EventType.RAW:\n case EventType.CUSTOM:\n case EventType.STEP_STARTED:\n case EventType.STEP_FINISHED:\n case EventType.REASONING_MESSAGE_CONTENT:\n case EventType.REASONING_MESSAGE_CHUNK:\n case EventType.REASONING_ENCRYPTED_VALUE:\n default:\n break;\n }\n };\n\n const finalize = (options: FinalizeRunOptions = {}): BaseEvent[] => {\n if (terminalEventObserved) return [];\n\n const { stopRequested = false, interruptionMessage } = options;\n const resolvedStopMessage = interruptionMessage ?? defaultStopMessage;\n const resolvedAbruptMessage =\n interruptionMessage && interruptionMessage !== defaultStopMessage\n ? interruptionMessage\n : defaultAbruptEndMessage;\n const appended: BaseEvent[] = [];\n\n // A reasoning message closes before the span that holds it.\n for (const messageId of openReasoningMessageIds) {\n appended.push({\n type: EventType.REASONING_MESSAGE_END,\n messageId,\n } as BaseEvent);\n }\n for (const messageId of openReasoningSpanIds) {\n appended.push({ type: EventType.REASONING_END, messageId } as BaseEvent);\n }\n\n for (const messageId of openMessageIds) {\n appended.push({\n type: EventType.TEXT_MESSAGE_END,\n messageId,\n } as BaseEvent);\n }\n\n for (const [toolCallId, info] of openToolCalls) {\n if (!info.hasEnd) {\n appended.push({\n type: EventType.TOOL_CALL_END,\n toolCallId,\n } as BaseEvent);\n }\n\n if (!info.hasResult) {\n appended.push({\n type: EventType.TOOL_CALL_RESULT,\n toolCallId,\n messageId: `${toolCallId}-result`,\n role: \"tool\",\n content: JSON.stringify(\n stopRequested\n ? {\n status: \"stopped\",\n reason: \"stop_requested\",\n message: resolvedStopMessage,\n }\n : {\n status: \"error\",\n reason: \"missing_terminal_event\",\n message: resolvedAbruptMessage,\n },\n ),\n } as BaseEvent);\n }\n }\n\n if (stopRequested) {\n // Newest first, so a nested subagent closes before its parent. An index\n // loop, because `toReversed` is ES2023 and this package targets older.\n const openIds = [...openSubagentRunIds];\n for (let index = openIds.length - 1; index >= 0; index -= 1) {\n appended.push({\n type: EventType.SUBAGENT_ERROR,\n subagentRunId: openIds[index],\n message: resolvedStopMessage,\n code: \"CANCELLED\",\n } as BaseEvent);\n }\n appended.push({\n type: EventType.RUN_FINISHED,\n ...(runIdentity.threadId !== undefined\n ? { threadId: runIdentity.threadId }\n : {}),\n ...(runIdentity.runId !== undefined\n ? { runId: runIdentity.runId }\n : {}),\n ...(options.protocolVersion !== undefined\n ? { outcome: { type: \"cancelled\" } }\n : {}),\n } as BaseEvent);\n } else {\n const errorEvent: RunErrorEvent = {\n type: EventType.RUN_ERROR,\n message: resolvedAbruptMessage,\n code: \"INCOMPLETE_STREAM\",\n };\n appended.push(errorEvent);\n }\n\n terminalEventObserved = true;\n clearOpen();\n return appended;\n };\n\n return { observe, finalize };\n}\n\n/**\n * Array form of {@link createRunEventFinalizer} for callers that already keep\n * the run's events (runners persist them). Appends the closers to `events` in\n * place and returns them.\n */\nexport function finalizeRunEvents(\n events: BaseEvent[],\n options: FinalizeRunOptions = {},\n): BaseEvent[] {\n const finalizer = createRunEventFinalizer();\n for (const event of events) finalizer.observe(event);\n\n const appended = finalizer.finalize(options);\n events.push(...appended);\n return appended;\n}\n"],"mappings":"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"}
@@ -98,6 +98,7 @@ var RenderUIArgsScanner = class {
98
98
  expectingValue = false;
99
99
  }
100
100
  break;
101
+ case void 0: break;
101
102
  }
102
103
  }
103
104
  this.inString = inString;
@@ -1 +1 @@
1
- {"version":3,"file":"render-ui-args.cjs","names":["isRecord"],"sources":["../../src/generative-ui/render-ui-args.ts"],"sourcesContent":["import { isRecord } from \"./is-record\";\nexport interface ExtractedRenderUIArgs {\n target?: string;\n /**\n * Complete elements of the `operations` array, in order. A balanced element\n * that is not a valid JSON object is returned as `null`.\n */\n operations: Array<Record<string, unknown> | null>;\n /**\n * Set when an `operations[]` element was opened but its closing brace never\n * arrived: the text ends mid-operation (still streaming, or truncated).\n */\n incompleteOperation?: boolean;\n}\n\n/**\n * Reads `target` and every complete `operations[]` element from a possibly\n * truncated `render_ui` argument string.\n */\nexport function extractRenderUIArgs(text: string) {\n return new RenderUIArgsScanner().scan(text);\n}\n\n/**\n * The parser of {@link extractRenderUIArgs}, with its state kept between\n * calls. Each call scans only the text after the text it scanned before, so\n * a streamed argument string is scanned once in total.\n */\nclass RenderUIArgsScanner {\n private readonly result: ExtractedRenderUIArgs = { operations: [] };\n private readonly stack: Array<\"{\" | \"[\"> = [];\n private inString = false;\n private escaped = false;\n private stringStart = -1;\n private pendingKey: string | null = null;\n private currentKey: string | null = null;\n private expectingValue = false;\n private inOperations = false;\n private elementStart = -1;\n private scanned = 0;\n\n /**\n * Scans `text` from where the last call stopped.\n *\n * @param text - The whole text so far. It starts with the text of the\n * last call.\n * @returns The result so far. It is the same object on each call.\n */\n scan(text: string) {\n const { result, stack } = this;\n let {\n inString,\n escaped,\n stringStart,\n pendingKey,\n currentKey,\n expectingValue,\n inOperations,\n elementStart,\n } = this;\n for (let i = this.scanned; i < text.length; i++) {\n const ch = text[i];\n if (inString) {\n if (escaped) {\n escaped = false;\n } else if (ch === \"\\\\\") {\n escaped = true;\n } else if (ch === '\"') {\n inString = false;\n if (stack.length === 1) {\n const literal = text.slice(stringStart, i + 1);\n if (expectingValue) {\n if (currentKey === \"target\") {\n try {\n result.target = JSON.parse(literal);\n } catch {\n // Unreachable for a closed literal; keep scanning.\n }\n }\n expectingValue = false;\n } else {\n pendingKey = literal;\n }\n }\n }\n continue;\n }\n switch (ch) {\n case '\"':\n inString = true;\n stringStart = i;\n break;\n case \":\":\n if (stack.length === 1 && pendingKey !== null) {\n try {\n currentKey = JSON.parse(pendingKey);\n } catch {\n currentKey = null;\n }\n pendingKey = null;\n expectingValue = true;\n }\n break;\n case \",\":\n if (stack.length === 1) {\n expectingValue = false;\n currentKey = null;\n }\n break;\n case \"{\":\n if (inOperations && stack.length === 2) elementStart = i;\n stack.push(\"{\");\n break;\n case \"[\":\n if (\n stack.length === 1 &&\n expectingValue &&\n currentKey === \"operations\"\n ) {\n inOperations = true;\n }\n stack.push(\"[\");\n break;\n case \"}\":\n case \"]\":\n stack.pop();\n if (\n ch === \"}\" &&\n inOperations &&\n stack.length === 2 &&\n elementStart >= 0\n ) {\n result.operations.push(\n parseObject(text.slice(elementStart, i + 1)),\n );\n elementStart = -1;\n }\n if (ch === \"]\" && inOperations && stack.length === 1) {\n inOperations = false;\n expectingValue = false;\n }\n break;\n }\n }\n this.inString = inString;\n this.escaped = escaped;\n this.stringStart = stringStart;\n this.pendingKey = pendingKey;\n this.currentKey = currentKey;\n this.expectingValue = expectingValue;\n this.inOperations = inOperations;\n this.elementStart = elementStart;\n this.scanned = text.length;\n if (elementStart >= 0) result.incompleteOperation = true;\n else delete result.incompleteOperation;\n return result;\n }\n}\n\nfunction parseObject(raw: string) {\n try {\n const value: unknown = JSON.parse(raw);\n return isRecord(value) ? value : null;\n } catch {\n return null;\n }\n}\n\n/** Feeds streamed argument deltas and reports operations not yet seen. */\nexport class RenderUIArgsStream {\n private buffer = \"\";\n private emitted = 0;\n private incomplete = false;\n private readonly scanner = new RenderUIArgsScanner();\n\n push(delta: string) {\n this.buffer += delta;\n const { target, operations, incompleteOperation } = this.scanner.scan(\n this.buffer,\n );\n const newOperations = operations.slice(this.emitted);\n this.emitted = operations.length;\n this.incomplete = incompleteOperation === true;\n return { target, newOperations };\n }\n\n /** Every argument delta received so far, concatenated. */\n get text() {\n return this.buffer;\n }\n\n /**\n * True when the text received so far ends inside an `operations[]` element.\n * Once the tool call has ended, that element was truncated.\n */\n get hasIncompleteOperation() {\n return this.incomplete;\n }\n}\n"],"mappings":";;;;;;;AAmBA,SAAgB,oBAAoB,MAAc;AAChD,QAAO,IAAI,qBAAqB,CAAC,KAAK,KAAK;;;;;;;AAQ7C,IAAM,sBAAN,MAA0B;;gBACyB,EAAE,YAAY,EAAE,EAAE;eACxB,EAAE;kBAC1B;iBACD;qBACI;oBACc;oBACA;wBACX;sBACF;sBACA;iBACL;;;;;;;;;CASlB,KAAK,MAAc;EACjB,MAAM,EAAE,QAAQ,UAAU;EAC1B,IAAI,EACF,UACA,SACA,aACA,YACA,YACA,gBACA,cACA,iBACE;AACJ,OAAK,IAAI,IAAI,KAAK,SAAS,IAAI,KAAK,QAAQ,KAAK;GAC/C,MAAM,KAAK,KAAK;AAChB,OAAI,UAAU;AACZ,QAAI,QACF,WAAU;aACD,OAAO,KAChB,WAAU;aACD,OAAO,MAAK;AACrB,gBAAW;AACX,SAAI,MAAM,WAAW,GAAG;MACtB,MAAM,UAAU,KAAK,MAAM,aAAa,IAAI,EAAE;AAC9C,UAAI,gBAAgB;AAClB,WAAI,eAAe,SACjB,KAAI;AACF,eAAO,SAAS,KAAK,MAAM,QAAQ;eAC7B;AAIV,wBAAiB;YAEjB,cAAa;;;AAInB;;AAEF,WAAQ,IAAR;IACE,KAAK;AACH,gBAAW;AACX,mBAAc;AACd;IACF,KAAK;AACH,SAAI,MAAM,WAAW,KAAK,eAAe,MAAM;AAC7C,UAAI;AACF,oBAAa,KAAK,MAAM,WAAW;cAC7B;AACN,oBAAa;;AAEf,mBAAa;AACb,uBAAiB;;AAEnB;IACF,KAAK;AACH,SAAI,MAAM,WAAW,GAAG;AACtB,uBAAiB;AACjB,mBAAa;;AAEf;IACF,KAAK;AACH,SAAI,gBAAgB,MAAM,WAAW,EAAG,gBAAe;AACvD,WAAM,KAAK,IAAI;AACf;IACF,KAAK;AACH,SACE,MAAM,WAAW,KACjB,kBACA,eAAe,aAEf,gBAAe;AAEjB,WAAM,KAAK,IAAI;AACf;IACF,KAAK;IACL,KAAK;AACH,WAAM,KAAK;AACX,SACE,OAAO,OACP,gBACA,MAAM,WAAW,KACjB,gBAAgB,GAChB;AACA,aAAO,WAAW,KAChB,YAAY,KAAK,MAAM,cAAc,IAAI,EAAE,CAAC,CAC7C;AACD,qBAAe;;AAEjB,SAAI,OAAO,OAAO,gBAAgB,MAAM,WAAW,GAAG;AACpD,qBAAe;AACf,uBAAiB;;AAEnB;;;AAGN,OAAK,WAAW;AAChB,OAAK,UAAU;AACf,OAAK,cAAc;AACnB,OAAK,aAAa;AAClB,OAAK,aAAa;AAClB,OAAK,iBAAiB;AACtB,OAAK,eAAe;AACpB,OAAK,eAAe;AACpB,OAAK,UAAU,KAAK;AACpB,MAAI,gBAAgB,EAAG,QAAO,sBAAsB;MAC/C,QAAO,OAAO;AACnB,SAAO;;;AAIX,SAAS,YAAY,KAAa;AAChC,KAAI;EACF,MAAM,QAAiB,KAAK,MAAM,IAAI;AACtC,SAAOA,2BAAS,MAAM,GAAG,QAAQ;SAC3B;AACN,SAAO;;;;AAKX,IAAa,qBAAb,MAAgC;;gBACb;iBACC;oBACG;iBACM,IAAI,qBAAqB;;CAEpD,KAAK,OAAe;AAClB,OAAK,UAAU;EACf,MAAM,EAAE,QAAQ,YAAY,wBAAwB,KAAK,QAAQ,KAC/D,KAAK,OACN;EACD,MAAM,gBAAgB,WAAW,MAAM,KAAK,QAAQ;AACpD,OAAK,UAAU,WAAW;AAC1B,OAAK,aAAa,wBAAwB;AAC1C,SAAO;GAAE;GAAQ;GAAe;;;CAIlC,IAAI,OAAO;AACT,SAAO,KAAK;;;;;;CAOd,IAAI,yBAAyB;AAC3B,SAAO,KAAK"}
1
+ {"version":3,"file":"render-ui-args.cjs","names":["isRecord"],"sources":["../../src/generative-ui/render-ui-args.ts"],"sourcesContent":["import { isRecord } from \"./is-record\";\nexport interface ExtractedRenderUIArgs {\n target?: string;\n /**\n * Complete elements of the `operations` array, in order. A balanced element\n * that is not a valid JSON object is returned as `null`.\n */\n operations: Array<Record<string, unknown> | null>;\n /**\n * Set when an `operations[]` element was opened but its closing brace never\n * arrived: the text ends mid-operation (still streaming, or truncated).\n */\n incompleteOperation?: boolean;\n}\n\n/**\n * Reads `target` and every complete `operations[]` element from a possibly\n * truncated `render_ui` argument string.\n */\nexport function extractRenderUIArgs(text: string) {\n return new RenderUIArgsScanner().scan(text);\n}\n\n/**\n * The parser of {@link extractRenderUIArgs}, with its state kept between\n * calls. Each call scans only the text after the text it scanned before, so\n * a streamed argument string is scanned once in total.\n */\nclass RenderUIArgsScanner {\n private readonly result: ExtractedRenderUIArgs = { operations: [] };\n private readonly stack: Array<\"{\" | \"[\"> = [];\n private inString = false;\n private escaped = false;\n private stringStart = -1;\n private pendingKey: string | null = null;\n private currentKey: string | null = null;\n private expectingValue = false;\n private inOperations = false;\n private elementStart = -1;\n private scanned = 0;\n\n /**\n * Scans `text` from where the last call stopped.\n *\n * @param text - The whole text so far. It starts with the text of the\n * last call.\n * @returns The result so far. It is the same object on each call.\n */\n scan(text: string) {\n const { result, stack } = this;\n let {\n inString,\n escaped,\n stringStart,\n pendingKey,\n currentKey,\n expectingValue,\n inOperations,\n elementStart,\n } = this;\n for (let i = this.scanned; i < text.length; i++) {\n const ch = text[i];\n if (inString) {\n if (escaped) {\n escaped = false;\n } else if (ch === \"\\\\\") {\n escaped = true;\n } else if (ch === '\"') {\n inString = false;\n if (stack.length === 1) {\n const literal = text.slice(stringStart, i + 1);\n if (expectingValue) {\n if (currentKey === \"target\") {\n try {\n result.target = JSON.parse(literal);\n } catch {\n // Unreachable for a closed literal; keep scanning.\n }\n }\n expectingValue = false;\n } else {\n pendingKey = literal;\n }\n }\n }\n continue;\n }\n switch (ch) {\n case '\"':\n inString = true;\n stringStart = i;\n break;\n case \":\":\n if (stack.length === 1 && pendingKey !== null) {\n try {\n currentKey = JSON.parse(pendingKey);\n } catch {\n currentKey = null;\n }\n pendingKey = null;\n expectingValue = true;\n }\n break;\n case \",\":\n if (stack.length === 1) {\n expectingValue = false;\n currentKey = null;\n }\n break;\n case \"{\":\n if (inOperations && stack.length === 2) elementStart = i;\n stack.push(\"{\");\n break;\n case \"[\":\n if (\n stack.length === 1 &&\n expectingValue &&\n currentKey === \"operations\"\n ) {\n inOperations = true;\n }\n stack.push(\"[\");\n break;\n case \"}\":\n case \"]\":\n stack.pop();\n if (\n ch === \"}\" &&\n inOperations &&\n stack.length === 2 &&\n elementStart >= 0\n ) {\n result.operations.push(\n parseObject(text.slice(elementStart, i + 1)),\n );\n elementStart = -1;\n }\n if (ch === \"]\" && inOperations && stack.length === 1) {\n inOperations = false;\n expectingValue = false;\n }\n break;\n case undefined:\n // Unreachable: `i < text.length`, so `text[i]` is always a char.\n break;\n }\n }\n this.inString = inString;\n this.escaped = escaped;\n this.stringStart = stringStart;\n this.pendingKey = pendingKey;\n this.currentKey = currentKey;\n this.expectingValue = expectingValue;\n this.inOperations = inOperations;\n this.elementStart = elementStart;\n this.scanned = text.length;\n if (elementStart >= 0) result.incompleteOperation = true;\n else delete result.incompleteOperation;\n return result;\n }\n}\n\nfunction parseObject(raw: string) {\n try {\n const value: unknown = JSON.parse(raw);\n return isRecord(value) ? value : null;\n } catch {\n return null;\n }\n}\n\n/** Feeds streamed argument deltas and reports operations not yet seen. */\nexport class RenderUIArgsStream {\n private buffer = \"\";\n private emitted = 0;\n private incomplete = false;\n private readonly scanner = new RenderUIArgsScanner();\n\n push(delta: string) {\n this.buffer += delta;\n const { target, operations, incompleteOperation } = this.scanner.scan(\n this.buffer,\n );\n const newOperations = operations.slice(this.emitted);\n this.emitted = operations.length;\n this.incomplete = incompleteOperation === true;\n return { target, newOperations };\n }\n\n /** Every argument delta received so far, concatenated. */\n get text() {\n return this.buffer;\n }\n\n /**\n * True when the text received so far ends inside an `operations[]` element.\n * Once the tool call has ended, that element was truncated.\n */\n get hasIncompleteOperation() {\n return this.incomplete;\n }\n}\n"],"mappings":";;;;;;;AAmBA,SAAgB,oBAAoB,MAAc;AAChD,QAAO,IAAI,qBAAqB,CAAC,KAAK,KAAK;;;;;;;AAQ7C,IAAM,sBAAN,MAA0B;;gBACyB,EAAE,YAAY,EAAE,EAAE;eACxB,EAAE;kBAC1B;iBACD;qBACI;oBACc;oBACA;wBACX;sBACF;sBACA;iBACL;;;;;;;;;CASlB,KAAK,MAAc;EACjB,MAAM,EAAE,QAAQ,UAAU;EAC1B,IAAI,EACF,UACA,SACA,aACA,YACA,YACA,gBACA,cACA,iBACE;AACJ,OAAK,IAAI,IAAI,KAAK,SAAS,IAAI,KAAK,QAAQ,KAAK;GAC/C,MAAM,KAAK,KAAK;AAChB,OAAI,UAAU;AACZ,QAAI,QACF,WAAU;aACD,OAAO,KAChB,WAAU;aACD,OAAO,MAAK;AACrB,gBAAW;AACX,SAAI,MAAM,WAAW,GAAG;MACtB,MAAM,UAAU,KAAK,MAAM,aAAa,IAAI,EAAE;AAC9C,UAAI,gBAAgB;AAClB,WAAI,eAAe,SACjB,KAAI;AACF,eAAO,SAAS,KAAK,MAAM,QAAQ;eAC7B;AAIV,wBAAiB;YAEjB,cAAa;;;AAInB;;AAEF,WAAQ,IAAR;IACE,KAAK;AACH,gBAAW;AACX,mBAAc;AACd;IACF,KAAK;AACH,SAAI,MAAM,WAAW,KAAK,eAAe,MAAM;AAC7C,UAAI;AACF,oBAAa,KAAK,MAAM,WAAW;cAC7B;AACN,oBAAa;;AAEf,mBAAa;AACb,uBAAiB;;AAEnB;IACF,KAAK;AACH,SAAI,MAAM,WAAW,GAAG;AACtB,uBAAiB;AACjB,mBAAa;;AAEf;IACF,KAAK;AACH,SAAI,gBAAgB,MAAM,WAAW,EAAG,gBAAe;AACvD,WAAM,KAAK,IAAI;AACf;IACF,KAAK;AACH,SACE,MAAM,WAAW,KACjB,kBACA,eAAe,aAEf,gBAAe;AAEjB,WAAM,KAAK,IAAI;AACf;IACF,KAAK;IACL,KAAK;AACH,WAAM,KAAK;AACX,SACE,OAAO,OACP,gBACA,MAAM,WAAW,KACjB,gBAAgB,GAChB;AACA,aAAO,WAAW,KAChB,YAAY,KAAK,MAAM,cAAc,IAAI,EAAE,CAAC,CAC7C;AACD,qBAAe;;AAEjB,SAAI,OAAO,OAAO,gBAAgB,MAAM,WAAW,GAAG;AACpD,qBAAe;AACf,uBAAiB;;AAEnB;IACF,KAAK,OAEH;;;AAGN,OAAK,WAAW;AAChB,OAAK,UAAU;AACf,OAAK,cAAc;AACnB,OAAK,aAAa;AAClB,OAAK,aAAa;AAClB,OAAK,iBAAiB;AACtB,OAAK,eAAe;AACpB,OAAK,eAAe;AACpB,OAAK,UAAU,KAAK;AACpB,MAAI,gBAAgB,EAAG,QAAO,sBAAsB;MAC/C,QAAO,OAAO;AACnB,SAAO;;;AAIX,SAAS,YAAY,KAAa;AAChC,KAAI;EACF,MAAM,QAAiB,KAAK,MAAM,IAAI;AACtC,SAAOA,2BAAS,MAAM,GAAG,QAAQ;SAC3B;AACN,SAAO;;;;AAKX,IAAa,qBAAb,MAAgC;;gBACb;iBACC;oBACG;iBACM,IAAI,qBAAqB;;CAEpD,KAAK,OAAe;AAClB,OAAK,UAAU;EACf,MAAM,EAAE,QAAQ,YAAY,wBAAwB,KAAK,QAAQ,KAC/D,KAAK,OACN;EACD,MAAM,gBAAgB,WAAW,MAAM,KAAK,QAAQ;AACpD,OAAK,UAAU,WAAW;AAC1B,OAAK,aAAa,wBAAwB;AAC1C,SAAO;GAAE;GAAQ;GAAe;;;CAIlC,IAAI,OAAO;AACT,SAAO,KAAK;;;;;;CAOd,IAAI,yBAAyB;AAC3B,SAAO,KAAK"}
@@ -1 +1 @@
1
- {"version":3,"file":"render-ui-args.d.cts","names":[],"sources":["../../src/generative-ui/render-ui-args.ts"],"mappings":";UACiB,qBAAA;EACf,MAAA;EADoC;;;;EAMpC,UAAA,EAAY,KAAA,CAAM,MAAA;EAAN;;;;EAKZ,mBAAA;AAAA;;;;;iBAOc,mBAAA,CAAoB,IAAA,WAAY,qBAAA;;cAsJnC,kBAAA;EAAA,QACH,MAAA;EAAA,QACA,OAAA;EAAA,QACA,UAAA;EAAA,iBACS,OAAA;EAEjB,IAAA,CAAK,KAAA;;oBANwB,MAAA;EAAA;;MAkBzB,IAAA,CAAA;EAAA;;;;EAAA,IAQA,sBAAA,CAAA;AAAA"}
1
+ {"version":3,"file":"render-ui-args.d.cts","names":[],"sources":["../../src/generative-ui/render-ui-args.ts"],"mappings":";UACiB,qBAAA;EACf,MAAA;EADoC;;;;EAMpC,UAAA,EAAY,KAAA,CAAM,MAAA;EAAN;;;;EAKZ,mBAAA;AAAA;;;;;iBAOc,mBAAA,CAAoB,IAAA,WAAY,qBAAA;;cAyJnC,kBAAA;EAAA,QACH,MAAA;EAAA,QACA,OAAA;EAAA,QACA,UAAA;EAAA,iBACS,OAAA;EAEjB,IAAA,CAAK,KAAA;;oBANwB,MAAA;EAAA;;MAkBzB,IAAA,CAAA;EAAA;;;;EAAA,IAQA,sBAAA,CAAA;AAAA"}
@@ -1 +1 @@
1
- {"version":3,"file":"render-ui-args.d.mts","names":[],"sources":["../../src/generative-ui/render-ui-args.ts"],"mappings":";UACiB,qBAAA;EACf,MAAA;EADoC;;;;EAMpC,UAAA,EAAY,KAAA,CAAM,MAAA;EAAN;;;;EAKZ,mBAAA;AAAA;;;;;iBAOc,mBAAA,CAAoB,IAAA,WAAY,qBAAA;;cAsJnC,kBAAA;EAAA,QACH,MAAA;EAAA,QACA,OAAA;EAAA,QACA,UAAA;EAAA,iBACS,OAAA;EAEjB,IAAA,CAAK,KAAA;;oBANwB,MAAA;EAAA;;MAkBzB,IAAA,CAAA;EAAA;;;;EAAA,IAQA,sBAAA,CAAA;AAAA"}
1
+ {"version":3,"file":"render-ui-args.d.mts","names":[],"sources":["../../src/generative-ui/render-ui-args.ts"],"mappings":";UACiB,qBAAA;EACf,MAAA;EADoC;;;;EAMpC,UAAA,EAAY,KAAA,CAAM,MAAA;EAAN;;;;EAKZ,mBAAA;AAAA;;;;;iBAOc,mBAAA,CAAoB,IAAA,WAAY,qBAAA;;cAyJnC,kBAAA;EAAA,QACH,MAAA;EAAA,QACA,OAAA;EAAA,QACA,UAAA;EAAA,iBACS,OAAA;EAEjB,IAAA,CAAK,KAAA;;oBANwB,MAAA;EAAA;;MAkBzB,IAAA,CAAA;EAAA;;;;EAAA,IAQA,sBAAA,CAAA;AAAA"}
@@ -98,6 +98,7 @@ var RenderUIArgsScanner = class {
98
98
  expectingValue = false;
99
99
  }
100
100
  break;
101
+ case void 0: break;
101
102
  }
102
103
  }
103
104
  this.inString = inString;
@@ -1 +1 @@
1
- {"version":3,"file":"render-ui-args.mjs","names":[],"sources":["../../src/generative-ui/render-ui-args.ts"],"sourcesContent":["import { isRecord } from \"./is-record\";\nexport interface ExtractedRenderUIArgs {\n target?: string;\n /**\n * Complete elements of the `operations` array, in order. A balanced element\n * that is not a valid JSON object is returned as `null`.\n */\n operations: Array<Record<string, unknown> | null>;\n /**\n * Set when an `operations[]` element was opened but its closing brace never\n * arrived: the text ends mid-operation (still streaming, or truncated).\n */\n incompleteOperation?: boolean;\n}\n\n/**\n * Reads `target` and every complete `operations[]` element from a possibly\n * truncated `render_ui` argument string.\n */\nexport function extractRenderUIArgs(text: string) {\n return new RenderUIArgsScanner().scan(text);\n}\n\n/**\n * The parser of {@link extractRenderUIArgs}, with its state kept between\n * calls. Each call scans only the text after the text it scanned before, so\n * a streamed argument string is scanned once in total.\n */\nclass RenderUIArgsScanner {\n private readonly result: ExtractedRenderUIArgs = { operations: [] };\n private readonly stack: Array<\"{\" | \"[\"> = [];\n private inString = false;\n private escaped = false;\n private stringStart = -1;\n private pendingKey: string | null = null;\n private currentKey: string | null = null;\n private expectingValue = false;\n private inOperations = false;\n private elementStart = -1;\n private scanned = 0;\n\n /**\n * Scans `text` from where the last call stopped.\n *\n * @param text - The whole text so far. It starts with the text of the\n * last call.\n * @returns The result so far. It is the same object on each call.\n */\n scan(text: string) {\n const { result, stack } = this;\n let {\n inString,\n escaped,\n stringStart,\n pendingKey,\n currentKey,\n expectingValue,\n inOperations,\n elementStart,\n } = this;\n for (let i = this.scanned; i < text.length; i++) {\n const ch = text[i];\n if (inString) {\n if (escaped) {\n escaped = false;\n } else if (ch === \"\\\\\") {\n escaped = true;\n } else if (ch === '\"') {\n inString = false;\n if (stack.length === 1) {\n const literal = text.slice(stringStart, i + 1);\n if (expectingValue) {\n if (currentKey === \"target\") {\n try {\n result.target = JSON.parse(literal);\n } catch {\n // Unreachable for a closed literal; keep scanning.\n }\n }\n expectingValue = false;\n } else {\n pendingKey = literal;\n }\n }\n }\n continue;\n }\n switch (ch) {\n case '\"':\n inString = true;\n stringStart = i;\n break;\n case \":\":\n if (stack.length === 1 && pendingKey !== null) {\n try {\n currentKey = JSON.parse(pendingKey);\n } catch {\n currentKey = null;\n }\n pendingKey = null;\n expectingValue = true;\n }\n break;\n case \",\":\n if (stack.length === 1) {\n expectingValue = false;\n currentKey = null;\n }\n break;\n case \"{\":\n if (inOperations && stack.length === 2) elementStart = i;\n stack.push(\"{\");\n break;\n case \"[\":\n if (\n stack.length === 1 &&\n expectingValue &&\n currentKey === \"operations\"\n ) {\n inOperations = true;\n }\n stack.push(\"[\");\n break;\n case \"}\":\n case \"]\":\n stack.pop();\n if (\n ch === \"}\" &&\n inOperations &&\n stack.length === 2 &&\n elementStart >= 0\n ) {\n result.operations.push(\n parseObject(text.slice(elementStart, i + 1)),\n );\n elementStart = -1;\n }\n if (ch === \"]\" && inOperations && stack.length === 1) {\n inOperations = false;\n expectingValue = false;\n }\n break;\n }\n }\n this.inString = inString;\n this.escaped = escaped;\n this.stringStart = stringStart;\n this.pendingKey = pendingKey;\n this.currentKey = currentKey;\n this.expectingValue = expectingValue;\n this.inOperations = inOperations;\n this.elementStart = elementStart;\n this.scanned = text.length;\n if (elementStart >= 0) result.incompleteOperation = true;\n else delete result.incompleteOperation;\n return result;\n }\n}\n\nfunction parseObject(raw: string) {\n try {\n const value: unknown = JSON.parse(raw);\n return isRecord(value) ? value : null;\n } catch {\n return null;\n }\n}\n\n/** Feeds streamed argument deltas and reports operations not yet seen. */\nexport class RenderUIArgsStream {\n private buffer = \"\";\n private emitted = 0;\n private incomplete = false;\n private readonly scanner = new RenderUIArgsScanner();\n\n push(delta: string) {\n this.buffer += delta;\n const { target, operations, incompleteOperation } = this.scanner.scan(\n this.buffer,\n );\n const newOperations = operations.slice(this.emitted);\n this.emitted = operations.length;\n this.incomplete = incompleteOperation === true;\n return { target, newOperations };\n }\n\n /** Every argument delta received so far, concatenated. */\n get text() {\n return this.buffer;\n }\n\n /**\n * True when the text received so far ends inside an `operations[]` element.\n * Once the tool call has ended, that element was truncated.\n */\n get hasIncompleteOperation() {\n return this.incomplete;\n }\n}\n"],"mappings":";;;;;;;AAmBA,SAAgB,oBAAoB,MAAc;AAChD,QAAO,IAAI,qBAAqB,CAAC,KAAK,KAAK;;;;;;;AAQ7C,IAAM,sBAAN,MAA0B;;gBACyB,EAAE,YAAY,EAAE,EAAE;eACxB,EAAE;kBAC1B;iBACD;qBACI;oBACc;oBACA;wBACX;sBACF;sBACA;iBACL;;;;;;;;;CASlB,KAAK,MAAc;EACjB,MAAM,EAAE,QAAQ,UAAU;EAC1B,IAAI,EACF,UACA,SACA,aACA,YACA,YACA,gBACA,cACA,iBACE;AACJ,OAAK,IAAI,IAAI,KAAK,SAAS,IAAI,KAAK,QAAQ,KAAK;GAC/C,MAAM,KAAK,KAAK;AAChB,OAAI,UAAU;AACZ,QAAI,QACF,WAAU;aACD,OAAO,KAChB,WAAU;aACD,OAAO,MAAK;AACrB,gBAAW;AACX,SAAI,MAAM,WAAW,GAAG;MACtB,MAAM,UAAU,KAAK,MAAM,aAAa,IAAI,EAAE;AAC9C,UAAI,gBAAgB;AAClB,WAAI,eAAe,SACjB,KAAI;AACF,eAAO,SAAS,KAAK,MAAM,QAAQ;eAC7B;AAIV,wBAAiB;YAEjB,cAAa;;;AAInB;;AAEF,WAAQ,IAAR;IACE,KAAK;AACH,gBAAW;AACX,mBAAc;AACd;IACF,KAAK;AACH,SAAI,MAAM,WAAW,KAAK,eAAe,MAAM;AAC7C,UAAI;AACF,oBAAa,KAAK,MAAM,WAAW;cAC7B;AACN,oBAAa;;AAEf,mBAAa;AACb,uBAAiB;;AAEnB;IACF,KAAK;AACH,SAAI,MAAM,WAAW,GAAG;AACtB,uBAAiB;AACjB,mBAAa;;AAEf;IACF,KAAK;AACH,SAAI,gBAAgB,MAAM,WAAW,EAAG,gBAAe;AACvD,WAAM,KAAK,IAAI;AACf;IACF,KAAK;AACH,SACE,MAAM,WAAW,KACjB,kBACA,eAAe,aAEf,gBAAe;AAEjB,WAAM,KAAK,IAAI;AACf;IACF,KAAK;IACL,KAAK;AACH,WAAM,KAAK;AACX,SACE,OAAO,OACP,gBACA,MAAM,WAAW,KACjB,gBAAgB,GAChB;AACA,aAAO,WAAW,KAChB,YAAY,KAAK,MAAM,cAAc,IAAI,EAAE,CAAC,CAC7C;AACD,qBAAe;;AAEjB,SAAI,OAAO,OAAO,gBAAgB,MAAM,WAAW,GAAG;AACpD,qBAAe;AACf,uBAAiB;;AAEnB;;;AAGN,OAAK,WAAW;AAChB,OAAK,UAAU;AACf,OAAK,cAAc;AACnB,OAAK,aAAa;AAClB,OAAK,aAAa;AAClB,OAAK,iBAAiB;AACtB,OAAK,eAAe;AACpB,OAAK,eAAe;AACpB,OAAK,UAAU,KAAK;AACpB,MAAI,gBAAgB,EAAG,QAAO,sBAAsB;MAC/C,QAAO,OAAO;AACnB,SAAO;;;AAIX,SAAS,YAAY,KAAa;AAChC,KAAI;EACF,MAAM,QAAiB,KAAK,MAAM,IAAI;AACtC,SAAO,SAAS,MAAM,GAAG,QAAQ;SAC3B;AACN,SAAO;;;;AAKX,IAAa,qBAAb,MAAgC;;gBACb;iBACC;oBACG;iBACM,IAAI,qBAAqB;;CAEpD,KAAK,OAAe;AAClB,OAAK,UAAU;EACf,MAAM,EAAE,QAAQ,YAAY,wBAAwB,KAAK,QAAQ,KAC/D,KAAK,OACN;EACD,MAAM,gBAAgB,WAAW,MAAM,KAAK,QAAQ;AACpD,OAAK,UAAU,WAAW;AAC1B,OAAK,aAAa,wBAAwB;AAC1C,SAAO;GAAE;GAAQ;GAAe;;;CAIlC,IAAI,OAAO;AACT,SAAO,KAAK;;;;;;CAOd,IAAI,yBAAyB;AAC3B,SAAO,KAAK"}
1
+ {"version":3,"file":"render-ui-args.mjs","names":[],"sources":["../../src/generative-ui/render-ui-args.ts"],"sourcesContent":["import { isRecord } from \"./is-record\";\nexport interface ExtractedRenderUIArgs {\n target?: string;\n /**\n * Complete elements of the `operations` array, in order. A balanced element\n * that is not a valid JSON object is returned as `null`.\n */\n operations: Array<Record<string, unknown> | null>;\n /**\n * Set when an `operations[]` element was opened but its closing brace never\n * arrived: the text ends mid-operation (still streaming, or truncated).\n */\n incompleteOperation?: boolean;\n}\n\n/**\n * Reads `target` and every complete `operations[]` element from a possibly\n * truncated `render_ui` argument string.\n */\nexport function extractRenderUIArgs(text: string) {\n return new RenderUIArgsScanner().scan(text);\n}\n\n/**\n * The parser of {@link extractRenderUIArgs}, with its state kept between\n * calls. Each call scans only the text after the text it scanned before, so\n * a streamed argument string is scanned once in total.\n */\nclass RenderUIArgsScanner {\n private readonly result: ExtractedRenderUIArgs = { operations: [] };\n private readonly stack: Array<\"{\" | \"[\"> = [];\n private inString = false;\n private escaped = false;\n private stringStart = -1;\n private pendingKey: string | null = null;\n private currentKey: string | null = null;\n private expectingValue = false;\n private inOperations = false;\n private elementStart = -1;\n private scanned = 0;\n\n /**\n * Scans `text` from where the last call stopped.\n *\n * @param text - The whole text so far. It starts with the text of the\n * last call.\n * @returns The result so far. It is the same object on each call.\n */\n scan(text: string) {\n const { result, stack } = this;\n let {\n inString,\n escaped,\n stringStart,\n pendingKey,\n currentKey,\n expectingValue,\n inOperations,\n elementStart,\n } = this;\n for (let i = this.scanned; i < text.length; i++) {\n const ch = text[i];\n if (inString) {\n if (escaped) {\n escaped = false;\n } else if (ch === \"\\\\\") {\n escaped = true;\n } else if (ch === '\"') {\n inString = false;\n if (stack.length === 1) {\n const literal = text.slice(stringStart, i + 1);\n if (expectingValue) {\n if (currentKey === \"target\") {\n try {\n result.target = JSON.parse(literal);\n } catch {\n // Unreachable for a closed literal; keep scanning.\n }\n }\n expectingValue = false;\n } else {\n pendingKey = literal;\n }\n }\n }\n continue;\n }\n switch (ch) {\n case '\"':\n inString = true;\n stringStart = i;\n break;\n case \":\":\n if (stack.length === 1 && pendingKey !== null) {\n try {\n currentKey = JSON.parse(pendingKey);\n } catch {\n currentKey = null;\n }\n pendingKey = null;\n expectingValue = true;\n }\n break;\n case \",\":\n if (stack.length === 1) {\n expectingValue = false;\n currentKey = null;\n }\n break;\n case \"{\":\n if (inOperations && stack.length === 2) elementStart = i;\n stack.push(\"{\");\n break;\n case \"[\":\n if (\n stack.length === 1 &&\n expectingValue &&\n currentKey === \"operations\"\n ) {\n inOperations = true;\n }\n stack.push(\"[\");\n break;\n case \"}\":\n case \"]\":\n stack.pop();\n if (\n ch === \"}\" &&\n inOperations &&\n stack.length === 2 &&\n elementStart >= 0\n ) {\n result.operations.push(\n parseObject(text.slice(elementStart, i + 1)),\n );\n elementStart = -1;\n }\n if (ch === \"]\" && inOperations && stack.length === 1) {\n inOperations = false;\n expectingValue = false;\n }\n break;\n case undefined:\n // Unreachable: `i < text.length`, so `text[i]` is always a char.\n break;\n }\n }\n this.inString = inString;\n this.escaped = escaped;\n this.stringStart = stringStart;\n this.pendingKey = pendingKey;\n this.currentKey = currentKey;\n this.expectingValue = expectingValue;\n this.inOperations = inOperations;\n this.elementStart = elementStart;\n this.scanned = text.length;\n if (elementStart >= 0) result.incompleteOperation = true;\n else delete result.incompleteOperation;\n return result;\n }\n}\n\nfunction parseObject(raw: string) {\n try {\n const value: unknown = JSON.parse(raw);\n return isRecord(value) ? value : null;\n } catch {\n return null;\n }\n}\n\n/** Feeds streamed argument deltas and reports operations not yet seen. */\nexport class RenderUIArgsStream {\n private buffer = \"\";\n private emitted = 0;\n private incomplete = false;\n private readonly scanner = new RenderUIArgsScanner();\n\n push(delta: string) {\n this.buffer += delta;\n const { target, operations, incompleteOperation } = this.scanner.scan(\n this.buffer,\n );\n const newOperations = operations.slice(this.emitted);\n this.emitted = operations.length;\n this.incomplete = incompleteOperation === true;\n return { target, newOperations };\n }\n\n /** Every argument delta received so far, concatenated. */\n get text() {\n return this.buffer;\n }\n\n /**\n * True when the text received so far ends inside an `operations[]` element.\n * Once the tool call has ended, that element was truncated.\n */\n get hasIncompleteOperation() {\n return this.incomplete;\n }\n}\n"],"mappings":";;;;;;;AAmBA,SAAgB,oBAAoB,MAAc;AAChD,QAAO,IAAI,qBAAqB,CAAC,KAAK,KAAK;;;;;;;AAQ7C,IAAM,sBAAN,MAA0B;;gBACyB,EAAE,YAAY,EAAE,EAAE;eACxB,EAAE;kBAC1B;iBACD;qBACI;oBACc;oBACA;wBACX;sBACF;sBACA;iBACL;;;;;;;;;CASlB,KAAK,MAAc;EACjB,MAAM,EAAE,QAAQ,UAAU;EAC1B,IAAI,EACF,UACA,SACA,aACA,YACA,YACA,gBACA,cACA,iBACE;AACJ,OAAK,IAAI,IAAI,KAAK,SAAS,IAAI,KAAK,QAAQ,KAAK;GAC/C,MAAM,KAAK,KAAK;AAChB,OAAI,UAAU;AACZ,QAAI,QACF,WAAU;aACD,OAAO,KAChB,WAAU;aACD,OAAO,MAAK;AACrB,gBAAW;AACX,SAAI,MAAM,WAAW,GAAG;MACtB,MAAM,UAAU,KAAK,MAAM,aAAa,IAAI,EAAE;AAC9C,UAAI,gBAAgB;AAClB,WAAI,eAAe,SACjB,KAAI;AACF,eAAO,SAAS,KAAK,MAAM,QAAQ;eAC7B;AAIV,wBAAiB;YAEjB,cAAa;;;AAInB;;AAEF,WAAQ,IAAR;IACE,KAAK;AACH,gBAAW;AACX,mBAAc;AACd;IACF,KAAK;AACH,SAAI,MAAM,WAAW,KAAK,eAAe,MAAM;AAC7C,UAAI;AACF,oBAAa,KAAK,MAAM,WAAW;cAC7B;AACN,oBAAa;;AAEf,mBAAa;AACb,uBAAiB;;AAEnB;IACF,KAAK;AACH,SAAI,MAAM,WAAW,GAAG;AACtB,uBAAiB;AACjB,mBAAa;;AAEf;IACF,KAAK;AACH,SAAI,gBAAgB,MAAM,WAAW,EAAG,gBAAe;AACvD,WAAM,KAAK,IAAI;AACf;IACF,KAAK;AACH,SACE,MAAM,WAAW,KACjB,kBACA,eAAe,aAEf,gBAAe;AAEjB,WAAM,KAAK,IAAI;AACf;IACF,KAAK;IACL,KAAK;AACH,WAAM,KAAK;AACX,SACE,OAAO,OACP,gBACA,MAAM,WAAW,KACjB,gBAAgB,GAChB;AACA,aAAO,WAAW,KAChB,YAAY,KAAK,MAAM,cAAc,IAAI,EAAE,CAAC,CAC7C;AACD,qBAAe;;AAEjB,SAAI,OAAO,OAAO,gBAAgB,MAAM,WAAW,GAAG;AACpD,qBAAe;AACf,uBAAiB;;AAEnB;IACF,KAAK,OAEH;;;AAGN,OAAK,WAAW;AAChB,OAAK,UAAU;AACf,OAAK,cAAc;AACnB,OAAK,aAAa;AAClB,OAAK,aAAa;AAClB,OAAK,iBAAiB;AACtB,OAAK,eAAe;AACpB,OAAK,eAAe;AACpB,OAAK,UAAU,KAAK;AACpB,MAAI,gBAAgB,EAAG,QAAO,sBAAsB;MAC/C,QAAO,OAAO;AACnB,SAAO;;;AAIX,SAAS,YAAY,KAAa;AAChC,KAAI;EACF,MAAM,QAAiB,KAAK,MAAM,IAAI;AACtC,SAAO,SAAS,MAAM,GAAG,QAAQ;SAC3B;AACN,SAAO;;;;AAKX,IAAa,qBAAb,MAAgC;;gBACb;iBACC;oBACG;iBACM,IAAI,qBAAqB;;CAEpD,KAAK,OAAe;AAClB,OAAK,UAAU;EACf,MAAM,EAAE,QAAQ,YAAY,wBAAwB,KAAK,QAAQ,KAC/D,KAAK,OACN;EACD,MAAM,gBAAgB,WAAW,MAAM,KAAK,QAAQ;AACpD,OAAK,UAAU,WAAW;AAC1B,OAAK,aAAa,wBAAwB;AAC1C,SAAO;GAAE;GAAQ;GAAe;;;CAIlC,IAAI,OAAO;AACT,SAAO,KAAK;;;;;;CAOd,IAAI,yBAAyB;AAC3B,SAAO,KAAK"}
package/dist/index.umd.js CHANGED
@@ -438,6 +438,7 @@ ${getSeeMoreMarkdown(troubleshootingLink)}`;
438
438
  case "ECONNREFUSED": return `Connection to ${url} was refused. Ensure the server is running and accessible.\n\n${getSeeMoreMarkdown(troubleshootingLink)}`;
439
439
  case "ENOTFOUND": return `The server on ${url} could not be found. Check the URL or your network configuration.\n\n${getSeeMoreMarkdown(ERROR_CONFIG[CopilotKitErrorCode.NOT_FOUND].troubleshootingUrl)}`;
440
440
  case "ETIMEDOUT": return `The connection to ${url} timed out. The server might be overloaded or taking too long to respond.\n\n${getSeeMoreMarkdown(troubleshootingLink)}`;
441
+ case void 0:
441
442
  default: return;
442
443
  }
443
444
  };
@@ -562,6 +563,10 @@ ${getSeeMoreMarkdown(troubleshootingLink)}`;
562
563
  ...properties && { properties },
563
564
  ...required && required.length > 0 && { required }
564
565
  };
566
+ case "string[]":
567
+ case "number[]":
568
+ case "boolean[]":
569
+ case void 0:
565
570
  default:
566
571
  var _attribute$type;
567
572
  if ((_attribute$type = attribute.type) === null || _attribute$type === void 0 ? void 0 : _attribute$type.endsWith("[]")) return {
@@ -1913,6 +1918,22 @@ ${getSeeMoreMarkdown(troubleshootingLink)}`;
1913
1918
  terminalEventObserved = true;
1914
1919
  clearOpen();
1915
1920
  break;
1921
+ case _ag_ui_client.EventType.TEXT_MESSAGE_CONTENT:
1922
+ case _ag_ui_client.EventType.TEXT_MESSAGE_CHUNK:
1923
+ case _ag_ui_client.EventType.TOOL_CALL_ARGS:
1924
+ case _ag_ui_client.EventType.TOOL_CALL_CHUNK:
1925
+ case _ag_ui_client.EventType.STATE_SNAPSHOT:
1926
+ case _ag_ui_client.EventType.STATE_DELTA:
1927
+ case _ag_ui_client.EventType.MESSAGES_SNAPSHOT:
1928
+ case _ag_ui_client.EventType.ACTIVITY_SNAPSHOT:
1929
+ case _ag_ui_client.EventType.ACTIVITY_DELTA:
1930
+ case _ag_ui_client.EventType.RAW:
1931
+ case _ag_ui_client.EventType.CUSTOM:
1932
+ case _ag_ui_client.EventType.STEP_STARTED:
1933
+ case _ag_ui_client.EventType.STEP_FINISHED:
1934
+ case _ag_ui_client.EventType.REASONING_MESSAGE_CONTENT:
1935
+ case _ag_ui_client.EventType.REASONING_MESSAGE_CHUNK:
1936
+ case _ag_ui_client.EventType.REASONING_ENCRYPTED_VALUE:
1916
1937
  default: break;
1917
1938
  }
1918
1939
  };
@@ -2113,7 +2134,7 @@ ${getSeeMoreMarkdown(troubleshootingLink)}`;
2113
2134
 
2114
2135
  //#endregion
2115
2136
  //#region package.json
2116
- var version = "2.0.0-rc.18";
2137
+ var version = "2.0.0-rc.19";
2117
2138
 
2118
2139
  //#endregion
2119
2140
  //#region src/generative-ui/basic-functions.ts
@@ -3599,6 +3620,7 @@ Use the SAME surfaceId as the main surface. Match action names to button action
3599
3620
  expectingValue = false;
3600
3621
  }
3601
3622
  break;
3623
+ case void 0: break;
3602
3624
  }
3603
3625
  }
3604
3626
  this.inString = inString;