@copilotkit/shared 2.0.0-next.1 → 2.0.0-rc.1
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.
- package/LICENSE +21 -0
- package/README.md +93 -12
- package/dist/_virtual/_rolldown/runtime.cjs +29 -0
- package/dist/a2ui-envelope.cjs +154 -0
- package/dist/a2ui-envelope.cjs.map +1 -0
- package/dist/a2ui-envelope.d.cts +101 -0
- package/dist/a2ui-envelope.d.cts.map +1 -0
- package/dist/a2ui-envelope.d.mts +101 -0
- package/dist/a2ui-envelope.d.mts.map +1 -0
- package/dist/a2ui-envelope.mjs +151 -0
- package/dist/a2ui-envelope.mjs.map +1 -0
- package/dist/a2ui-prompts.cjs +259 -0
- package/dist/a2ui-prompts.cjs.map +1 -0
- package/dist/a2ui-prompts.d.cts +79 -0
- package/dist/a2ui-prompts.d.cts.map +1 -0
- package/dist/a2ui-prompts.d.mts +79 -0
- package/dist/a2ui-prompts.d.mts.map +1 -0
- package/dist/a2ui-prompts.mjs +251 -0
- package/dist/a2ui-prompts.mjs.map +1 -0
- package/dist/attachments/content.cjs +17 -0
- package/dist/attachments/content.cjs.map +1 -0
- package/dist/attachments/content.d.cts +9 -0
- package/dist/attachments/content.d.cts.map +1 -0
- package/dist/attachments/content.d.mts +9 -0
- package/dist/attachments/content.d.mts.map +1 -0
- package/dist/attachments/content.mjs +16 -0
- package/dist/attachments/content.mjs.map +1 -0
- package/dist/attachments/types.d.cts +64 -0
- package/dist/attachments/types.d.cts.map +1 -0
- package/dist/attachments/types.d.mts +64 -0
- package/dist/attachments/types.d.mts.map +1 -0
- package/dist/attachments/utils.cjs +137 -0
- package/dist/attachments/utils.cjs.map +1 -0
- package/dist/attachments/utils.d.cts +44 -0
- package/dist/attachments/utils.d.cts.map +1 -0
- package/dist/attachments/utils.d.mts +44 -0
- package/dist/attachments/utils.d.mts.map +1 -0
- package/dist/attachments/utils.mjs +129 -0
- package/dist/attachments/utils.mjs.map +1 -0
- package/dist/constants/index.cjs +25 -0
- package/dist/constants/index.cjs.map +1 -0
- package/dist/constants/index.d.cts +17 -0
- package/dist/constants/index.d.cts.map +1 -0
- package/dist/constants/index.d.mts +17 -0
- package/dist/constants/index.d.mts.map +1 -0
- package/dist/constants/index.mjs +17 -12
- package/dist/constants/index.mjs.map +1 -1
- package/dist/debug-event-envelope.d.cts +13 -0
- package/dist/debug-event-envelope.d.cts.map +1 -0
- package/dist/debug-event-envelope.d.mts +13 -0
- package/dist/debug-event-envelope.d.mts.map +1 -0
- package/dist/debug.cjs +38 -0
- package/dist/debug.cjs.map +1 -0
- package/dist/debug.d.cts +29 -0
- package/dist/debug.d.cts.map +1 -0
- package/dist/debug.d.mts +29 -0
- package/dist/debug.d.mts.map +1 -0
- package/dist/debug.mjs +37 -0
- package/dist/debug.mjs.map +1 -0
- package/dist/event-transforms/index.cjs +15 -0
- package/dist/event-transforms/index.d.cts +4 -0
- package/dist/event-transforms/index.d.mts +4 -0
- package/dist/event-transforms/index.mjs +5 -0
- package/dist/event-transforms/open-generative-ui-middleware.cjs +286 -0
- package/dist/event-transforms/open-generative-ui-middleware.cjs.map +1 -0
- package/dist/event-transforms/open-generative-ui-middleware.d.cts +60 -0
- package/dist/event-transforms/open-generative-ui-middleware.d.cts.map +1 -0
- package/dist/event-transforms/open-generative-ui-middleware.d.mts +60 -0
- package/dist/event-transforms/open-generative-ui-middleware.d.mts.map +1 -0
- package/dist/event-transforms/open-generative-ui-middleware.mjs +283 -0
- package/dist/event-transforms/open-generative-ui-middleware.mjs.map +1 -0
- package/dist/event-transforms/recorded-events.cjs +59 -0
- package/dist/event-transforms/recorded-events.cjs.map +1 -0
- package/dist/event-transforms/recorded-events.d.cts +23 -0
- package/dist/event-transforms/recorded-events.d.cts.map +1 -0
- package/dist/event-transforms/recorded-events.d.mts +23 -0
- package/dist/event-transforms/recorded-events.d.mts.map +1 -0
- package/dist/event-transforms/recorded-events.mjs +58 -0
- package/dist/event-transforms/recorded-events.mjs.map +1 -0
- package/dist/finalize-events.cjs +186 -0
- package/dist/finalize-events.cjs.map +1 -0
- package/dist/finalize-events.d.cts +40 -0
- package/dist/finalize-events.d.cts.map +1 -0
- package/dist/finalize-events.d.mts +40 -0
- package/dist/finalize-events.d.mts.map +1 -0
- package/dist/finalize-events.mjs +184 -0
- package/dist/finalize-events.mjs.map +1 -0
- package/dist/generative-ui/basic-functions.cjs +177 -0
- package/dist/generative-ui/basic-functions.cjs.map +1 -0
- package/dist/generative-ui/basic-functions.d.cts +108 -0
- package/dist/generative-ui/basic-functions.d.cts.map +1 -0
- package/dist/generative-ui/basic-functions.d.mts +108 -0
- package/dist/generative-ui/basic-functions.d.mts.map +1 -0
- package/dist/generative-ui/basic-functions.mjs +167 -0
- package/dist/generative-ui/basic-functions.mjs.map +1 -0
- package/dist/generative-ui/child-refs.cjs +161 -0
- package/dist/generative-ui/child-refs.cjs.map +1 -0
- package/dist/generative-ui/child-refs.d.cts +68 -0
- package/dist/generative-ui/child-refs.d.cts.map +1 -0
- package/dist/generative-ui/child-refs.d.mts +68 -0
- package/dist/generative-ui/child-refs.d.mts.map +1 -0
- package/dist/generative-ui/child-refs.mjs +152 -0
- package/dist/generative-ui/child-refs.mjs.map +1 -0
- package/dist/generative-ui/is-record.cjs +10 -0
- package/dist/generative-ui/is-record.cjs.map +1 -0
- package/dist/generative-ui/is-record.mjs +9 -0
- package/dist/generative-ui/is-record.mjs.map +1 -0
- package/dist/generative-ui/prompt.cjs +91 -0
- package/dist/generative-ui/prompt.cjs.map +1 -0
- package/dist/generative-ui/prompt.d.cts +13 -0
- package/dist/generative-ui/prompt.d.cts.map +1 -0
- package/dist/generative-ui/prompt.d.mts +13 -0
- package/dist/generative-ui/prompt.d.mts.map +1 -0
- package/dist/generative-ui/prompt.mjs +90 -0
- package/dist/generative-ui/prompt.mjs.map +1 -0
- package/dist/generative-ui/render-ui-args.cjs +160 -0
- package/dist/generative-ui/render-ui-args.cjs.map +1 -0
- package/dist/generative-ui/render-ui-args.d.cts +40 -0
- package/dist/generative-ui/render-ui-args.d.cts.map +1 -0
- package/dist/generative-ui/render-ui-args.d.mts +40 -0
- package/dist/generative-ui/render-ui-args.d.mts.map +1 -0
- package/dist/generative-ui/render-ui-args.mjs +159 -0
- package/dist/generative-ui/render-ui-args.mjs.map +1 -0
- package/dist/generative-ui/types.cjs +101 -0
- package/dist/generative-ui/types.cjs.map +1 -0
- package/dist/generative-ui/types.d.cts +270 -0
- package/dist/generative-ui/types.d.cts.map +1 -0
- package/dist/generative-ui/types.d.mts +270 -0
- package/dist/generative-ui/types.d.mts.map +1 -0
- package/dist/generative-ui/types.mjs +86 -0
- package/dist/generative-ui/types.mjs.map +1 -0
- package/dist/generative-ui/validate-operation.cjs +405 -0
- package/dist/generative-ui/validate-operation.cjs.map +1 -0
- package/dist/generative-ui/validate-operation.d.cts +86 -0
- package/dist/generative-ui/validate-operation.d.cts.map +1 -0
- package/dist/generative-ui/validate-operation.d.mts +86 -0
- package/dist/generative-ui/validate-operation.d.mts.map +1 -0
- package/dist/generative-ui/validate-operation.mjs +399 -0
- package/dist/generative-ui/validate-operation.mjs.map +1 -0
- package/dist/index.cjs +233 -0
- package/dist/index.cjs.map +1 -0
- package/dist/index.d.cts +80 -0
- package/dist/index.d.cts.map +1 -0
- package/dist/index.d.mts +80 -0
- package/dist/index.d.mts.map +1 -0
- package/dist/index.mjs +78 -123
- package/dist/index.mjs.map +1 -1
- package/dist/index.umd.js +3979 -0
- package/dist/index.umd.js.map +1 -0
- package/dist/intelligence-routing-fields.cjs +35 -0
- package/dist/intelligence-routing-fields.cjs.map +1 -0
- package/dist/intelligence-routing-fields.d.cts +18 -0
- package/dist/intelligence-routing-fields.d.cts.map +1 -0
- package/dist/intelligence-routing-fields.d.mts +18 -0
- package/dist/intelligence-routing-fields.d.mts.map +1 -0
- package/dist/intelligence-routing-fields.mjs +34 -0
- package/dist/intelligence-routing-fields.mjs.map +1 -0
- package/dist/logger.cjs +7 -0
- package/dist/logger.cjs.map +1 -0
- package/dist/logger.d.cts +5 -0
- package/dist/logger.d.cts.map +1 -0
- package/dist/logger.d.mts +5 -0
- package/dist/logger.d.mts.map +1 -0
- package/dist/logger.mjs +6 -0
- package/dist/logger.mjs.map +1 -0
- package/dist/open-generative-ui-prompts.cjs +8 -0
- package/dist/open-generative-ui-prompts.cjs.map +1 -0
- package/dist/open-generative-ui-prompts.d.cts +6 -0
- package/dist/open-generative-ui-prompts.d.cts.map +1 -0
- package/dist/open-generative-ui-prompts.d.mts +6 -0
- package/dist/open-generative-ui-prompts.d.mts.map +1 -0
- package/dist/open-generative-ui-prompts.mjs +7 -0
- package/dist/open-generative-ui-prompts.mjs.map +1 -0
- package/dist/package.cjs +12 -0
- package/dist/package.cjs.map +1 -0
- package/dist/package.mjs +6 -0
- package/dist/package.mjs.map +1 -0
- package/dist/standard-schema.cjs +31 -0
- package/dist/standard-schema.cjs.map +1 -0
- package/dist/standard-schema.d.cts +33 -0
- package/dist/standard-schema.d.cts.map +1 -0
- package/dist/standard-schema.d.mts +33 -0
- package/dist/standard-schema.d.mts.map +1 -0
- package/dist/standard-schema.mjs +30 -0
- package/dist/standard-schema.mjs.map +1 -0
- package/dist/telemetry/events.d.cts +72 -0
- package/dist/telemetry/events.d.cts.map +1 -0
- package/dist/telemetry/events.d.mts +72 -0
- package/dist/telemetry/events.d.mts.map +1 -0
- package/dist/telemetry/index.cjs +18 -0
- package/dist/telemetry/index.d.cts +5 -0
- package/dist/telemetry/index.d.mts +5 -0
- package/dist/telemetry/index.mjs +6 -12
- package/dist/telemetry/lambda-client.cjs +91 -0
- package/dist/telemetry/lambda-client.cjs.map +1 -0
- package/dist/telemetry/lambda-client.d.cts +31 -0
- package/dist/telemetry/lambda-client.d.cts.map +1 -0
- package/dist/telemetry/lambda-client.d.mts +31 -0
- package/dist/telemetry/lambda-client.d.mts.map +1 -0
- package/dist/telemetry/lambda-client.mjs +87 -0
- package/dist/telemetry/lambda-client.mjs.map +1 -0
- package/dist/telemetry/model-host.cjs +104 -0
- package/dist/telemetry/model-host.cjs.map +1 -0
- package/dist/telemetry/model-host.d.cts +26 -0
- package/dist/telemetry/model-host.d.cts.map +1 -0
- package/dist/telemetry/model-host.d.mts +26 -0
- package/dist/telemetry/model-host.d.mts.map +1 -0
- package/dist/telemetry/model-host.mjs +102 -0
- package/dist/telemetry/model-host.mjs.map +1 -0
- package/dist/telemetry/sampling.cjs +50 -0
- package/dist/telemetry/sampling.cjs.map +1 -0
- package/dist/telemetry/sampling.d.cts +57 -0
- package/dist/telemetry/sampling.d.cts.map +1 -0
- package/dist/telemetry/sampling.d.mts +57 -0
- package/dist/telemetry/sampling.d.mts.map +1 -0
- package/dist/telemetry/sampling.mjs +44 -0
- package/dist/telemetry/sampling.mjs.map +1 -0
- package/dist/telemetry/telemetry-client.cjs +165 -0
- package/dist/telemetry/telemetry-client.cjs.map +1 -0
- package/dist/telemetry/telemetry-client.d.cts +87 -0
- package/dist/telemetry/telemetry-client.d.cts.map +1 -0
- package/dist/telemetry/telemetry-client.d.mts +87 -0
- package/dist/telemetry/telemetry-client.d.mts.map +1 -0
- package/dist/telemetry/telemetry-client.mjs +162 -9
- package/dist/telemetry/telemetry-client.mjs.map +1 -1
- package/dist/telemetry/telemetry-disabled.cjs +20 -0
- package/dist/telemetry/telemetry-disabled.cjs.map +1 -0
- package/dist/telemetry/telemetry-disabled.d.cts +16 -0
- package/dist/telemetry/telemetry-disabled.d.cts.map +1 -0
- package/dist/telemetry/telemetry-disabled.d.mts +16 -0
- package/dist/telemetry/telemetry-disabled.d.mts.map +1 -0
- package/dist/telemetry/telemetry-disabled.mjs +19 -0
- package/dist/telemetry/telemetry-disabled.mjs.map +1 -0
- package/dist/telemetry/utils.cjs +14 -0
- package/dist/telemetry/utils.cjs.map +1 -0
- package/dist/telemetry/utils.mjs +12 -8
- package/dist/telemetry/utils.mjs.map +1 -1
- package/dist/transcription-errors.cjs +84 -0
- package/dist/transcription-errors.cjs.map +1 -0
- package/dist/transcription-errors.d.cts +52 -0
- package/dist/transcription-errors.d.cts.map +1 -0
- package/dist/transcription-errors.d.mts +52 -0
- package/dist/transcription-errors.d.mts.map +1 -0
- package/dist/transcription-errors.mjs +82 -0
- package/dist/transcription-errors.mjs.map +1 -0
- package/dist/types/{action.d.ts → action.d.cts} +32 -32
- package/dist/types/action.d.cts.map +1 -0
- package/dist/types/action.d.mts +59 -0
- package/dist/types/action.d.mts.map +1 -0
- package/dist/types/copilot-cloud-config.d.cts +15 -0
- package/dist/types/copilot-cloud-config.d.cts.map +1 -0
- package/dist/types/copilot-cloud-config.d.mts +15 -0
- package/dist/types/copilot-cloud-config.d.mts.map +1 -0
- package/dist/types/error.d.cts +57 -0
- package/dist/types/error.d.cts.map +1 -0
- package/dist/types/error.d.mts +57 -0
- package/dist/types/error.d.mts.map +1 -0
- package/dist/types/message.d.cts +42 -0
- package/dist/types/message.d.cts.map +1 -0
- package/dist/types/message.d.mts +42 -0
- package/dist/types/message.d.mts.map +1 -0
- package/dist/types/openai-assistant.d.cts +55 -0
- package/dist/types/openai-assistant.d.cts.map +1 -0
- package/dist/types/openai-assistant.d.mts +55 -0
- package/dist/types/openai-assistant.d.mts.map +1 -0
- package/dist/types/utility.d.cts +6 -0
- package/dist/types/utility.d.cts.map +1 -0
- package/dist/types/utility.d.mts +6 -0
- package/dist/types/utility.d.mts.map +1 -0
- package/dist/utils/clipboard.cjs +28 -0
- package/dist/utils/clipboard.cjs.map +1 -0
- package/dist/utils/clipboard.d.cts +14 -0
- package/dist/utils/clipboard.d.cts.map +1 -0
- package/dist/utils/clipboard.d.mts +14 -0
- package/dist/utils/clipboard.d.mts.map +1 -0
- package/dist/utils/clipboard.mjs +27 -0
- package/dist/utils/clipboard.mjs.map +1 -0
- package/dist/utils/conditions.cjs +32 -0
- package/dist/utils/conditions.cjs.map +1 -0
- package/dist/utils/{conditions.d.ts → conditions.d.cts} +16 -11
- package/dist/utils/conditions.d.cts.map +1 -0
- package/dist/utils/conditions.d.mts +31 -0
- package/dist/utils/conditions.d.mts.map +1 -0
- package/dist/utils/conditions.mjs +30 -6
- package/dist/utils/conditions.mjs.map +1 -1
- package/dist/utils/console-styling.cjs +91 -0
- package/dist/utils/console-styling.cjs.map +1 -0
- package/dist/utils/console-styling.d.cts +65 -0
- package/dist/utils/console-styling.d.cts.map +1 -0
- package/dist/utils/console-styling.d.mts +65 -0
- package/dist/utils/console-styling.d.mts.map +1 -0
- package/dist/utils/console-styling.mjs +83 -15
- package/dist/utils/console-styling.mjs.map +1 -1
- package/dist/utils/dashboard-url.cjs +19 -0
- package/dist/utils/dashboard-url.cjs.map +1 -0
- package/dist/utils/dashboard-url.mjs +18 -0
- package/dist/utils/dashboard-url.mjs.map +1 -0
- package/dist/utils/errors.cjs +439 -0
- package/dist/utils/errors.cjs.map +1 -0
- package/dist/utils/{errors.d.ts → errors.d.cts} +188 -156
- package/dist/utils/errors.d.cts.map +1 -0
- package/dist/utils/errors.d.mts +312 -0
- package/dist/utils/errors.d.mts.map +1 -0
- package/dist/utils/errors.mjs +416 -63
- package/dist/utils/errors.mjs.map +1 -1
- package/dist/utils/index.cjs +105 -0
- package/dist/utils/index.cjs.map +1 -0
- package/dist/utils/index.d.cts +58 -0
- package/dist/utils/index.d.cts.map +1 -0
- package/dist/utils/index.d.mts +58 -0
- package/dist/utils/index.d.mts.map +1 -0
- package/dist/utils/index.mjs +97 -107
- package/dist/utils/index.mjs.map +1 -1
- package/dist/utils/inspector-learning.cjs +217 -0
- package/dist/utils/inspector-learning.cjs.map +1 -0
- package/dist/utils/inspector-learning.d.cts +104 -0
- package/dist/utils/inspector-learning.d.cts.map +1 -0
- package/dist/utils/inspector-learning.d.mts +104 -0
- package/dist/utils/inspector-learning.d.mts.map +1 -0
- package/dist/utils/inspector-learning.mjs +215 -0
- package/dist/utils/inspector-learning.mjs.map +1 -0
- package/dist/utils/inspector-metadata.cjs +146 -0
- package/dist/utils/inspector-metadata.cjs.map +1 -0
- package/dist/utils/inspector-metadata.d.cts +55 -0
- package/dist/utils/inspector-metadata.d.cts.map +1 -0
- package/dist/utils/inspector-metadata.d.mts +55 -0
- package/dist/utils/inspector-metadata.d.mts.map +1 -0
- package/dist/utils/inspector-metadata.mjs +146 -0
- package/dist/utils/inspector-metadata.mjs.map +1 -0
- package/dist/utils/inspector-visibility.cjs +13 -0
- package/dist/utils/inspector-visibility.cjs.map +1 -0
- package/dist/utils/inspector-visibility.d.cts +18 -0
- package/dist/utils/inspector-visibility.d.cts.map +1 -0
- package/dist/utils/inspector-visibility.d.mts +18 -0
- package/dist/utils/inspector-visibility.d.mts.map +1 -0
- package/dist/utils/inspector-visibility.mjs +12 -0
- package/dist/utils/inspector-visibility.mjs.map +1 -0
- package/dist/utils/json-schema.cjs +215 -0
- package/dist/utils/json-schema.cjs.map +1 -0
- package/dist/utils/{json-schema.d.ts → json-schema.d.cts} +20 -18
- package/dist/utils/json-schema.d.cts.map +1 -0
- package/dist/utils/json-schema.d.mts +36 -0
- package/dist/utils/json-schema.d.mts.map +1 -0
- package/dist/utils/json-schema.mjs +210 -12
- package/dist/utils/json-schema.mjs.map +1 -1
- package/dist/utils/random-id.cjs +38 -0
- package/dist/utils/random-id.cjs.map +1 -0
- package/dist/utils/{random-id.d.ts → random-id.d.cts} +3 -1
- package/dist/utils/random-id.d.cts.map +1 -0
- package/dist/utils/random-id.d.mts +8 -0
- package/dist/utils/random-id.d.mts.map +1 -0
- package/dist/utils/random-id.mjs +33 -12
- package/dist/utils/random-id.mjs.map +1 -1
- package/dist/utils/requests.cjs +58 -0
- package/dist/utils/requests.cjs.map +1 -0
- package/dist/utils/{requests.d.ts → requests.d.cts} +3 -1
- package/dist/utils/requests.d.cts.map +1 -0
- package/dist/utils/requests.d.mts +12 -0
- package/dist/utils/requests.d.mts.map +1 -0
- package/dist/utils/requests.mjs +56 -6
- package/dist/utils/requests.mjs.map +1 -1
- package/dist/utils/row-render-keys.cjs +206 -0
- package/dist/utils/row-render-keys.cjs.map +1 -0
- package/dist/utils/row-render-keys.d.cts +65 -0
- package/dist/utils/row-render-keys.d.cts.map +1 -0
- package/dist/utils/row-render-keys.d.mts +65 -0
- package/dist/utils/row-render-keys.d.mts.map +1 -0
- package/dist/utils/row-render-keys.mjs +201 -0
- package/dist/utils/row-render-keys.mjs.map +1 -0
- package/dist/utils/types.cjs +9 -0
- package/dist/utils/types.cjs.map +1 -0
- package/dist/utils/types.d.cts +122 -0
- package/dist/utils/types.d.cts.map +1 -0
- package/dist/utils/types.d.mts +122 -0
- package/dist/utils/types.d.mts.map +1 -0
- package/dist/utils/types.mjs +6 -1
- package/dist/utils/types.mjs.map +1 -1
- package/package.json +74 -40
- package/scripts/verify-cjs-exports.cjs +16 -0
- package/src/__tests__/a2ui-envelope.test.ts +434 -0
- package/src/__tests__/a2ui-prompts.test.ts +362 -0
- package/src/__tests__/debug.test.ts +116 -0
- package/src/__tests__/license-context.test.ts +253 -0
- package/src/__tests__/root-entry-browser-safety.test.ts +91 -0
- package/src/__tests__/standard-schema-types.test.ts +144 -0
- package/src/__tests__/standard-schema.test.ts +359 -0
- package/src/__tests__/zod-regression.test.ts +319 -0
- package/src/a2ui-envelope.ts +309 -0
- package/src/a2ui-prompts.ts +322 -0
- package/src/attachments/__tests__/utils.test.ts +214 -0
- package/src/attachments/content.test.ts +48 -0
- package/src/attachments/content.ts +16 -0
- package/src/attachments/index.ts +21 -0
- package/src/attachments/types.ts +77 -0
- package/src/attachments/utils.ts +169 -0
- package/src/constants/index.ts +14 -1
- package/src/debug-event-envelope.ts +9 -0
- package/src/debug.ts +55 -0
- package/src/event-transforms/index.ts +5 -0
- package/src/event-transforms/open-generative-ui-middleware.ts +392 -0
- package/src/event-transforms/recorded-events.test.ts +166 -0
- package/src/event-transforms/recorded-events.ts +74 -0
- package/src/finalize-events.test.ts +284 -0
- package/src/finalize-events.ts +260 -0
- package/src/generative-ui/__tests__/render-ui-args.test.ts +175 -0
- package/src/generative-ui/__tests__/validate-operation.test.ts +977 -0
- package/src/generative-ui/basic-functions.ts +282 -0
- package/src/generative-ui/child-refs.ts +210 -0
- package/src/generative-ui/index.ts +6 -0
- package/src/generative-ui/is-record.ts +4 -0
- package/src/generative-ui/prompt.ts +174 -0
- package/src/generative-ui/render-ui-args.ts +199 -0
- package/src/generative-ui/types.ts +314 -0
- package/src/generative-ui/validate-operation.ts +723 -0
- package/src/index.ts +190 -1
- package/src/intelligence-routing-fields.test.ts +51 -0
- package/src/intelligence-routing-fields.ts +40 -0
- package/src/logger.ts +1 -0
- package/src/open-generative-ui-prompts.ts +20 -0
- package/src/standard-schema.ts +82 -0
- package/src/telemetry/events.ts +37 -10
- package/src/telemetry/index.ts +8 -0
- package/src/telemetry/lambda-client.test.ts +446 -0
- package/src/telemetry/lambda-client.ts +194 -0
- package/src/telemetry/model-host.test.ts +145 -0
- package/src/telemetry/model-host.ts +156 -0
- package/src/telemetry/sampling.test.ts +65 -0
- package/src/telemetry/sampling.ts +103 -0
- package/src/telemetry/telemetry-blank-license-identity.test.ts +128 -0
- package/src/telemetry/telemetry-client.test.ts +798 -0
- package/src/telemetry/telemetry-client.ts +223 -37
- package/src/telemetry/telemetry-disabled.ts +22 -0
- package/src/telemetry/utils.ts +0 -24
- package/src/transcription-errors.ts +99 -0
- package/src/types/__tests__/message.test.ts +62 -0
- package/src/types/action.ts +9 -5
- package/src/types/error.ts +11 -2
- package/src/types/message.ts +33 -5
- package/src/types/openai-assistant.ts +6 -2
- package/src/utils/__tests__/clipboard.test.ts +87 -0
- package/src/utils/__tests__/conditions.test.ts +161 -0
- package/src/utils/__tests__/json-schema.test.ts +812 -0
- package/src/utils/__tests__/row-render-keys.test.ts +388 -0
- package/src/utils/clipboard.ts +23 -0
- package/src/utils/conditions.ts +27 -9
- package/src/utils/console-styling.ts +10 -8
- package/src/utils/dashboard-url.ts +17 -0
- package/src/utils/errors.ts +55 -22
- package/src/utils/index.ts +70 -1
- package/src/utils/inspector-learning.test.ts +423 -0
- package/src/utils/inspector-learning.ts +523 -0
- package/src/utils/inspector-metadata.test.ts +743 -0
- package/src/utils/inspector-metadata.ts +263 -0
- package/src/utils/inspector-visibility.test.ts +43 -0
- package/src/utils/inspector-visibility.ts +17 -0
- package/src/utils/json-schema.ts +156 -12
- package/src/utils/random-id.ts +5 -2
- package/src/utils/requests.ts +3 -1
- package/src/utils/row-render-keys.ts +263 -0
- package/src/utils/types.ts +128 -1
- package/src/utils.test.ts +137 -0
- package/tsconfig.json +10 -2
- package/tsdown.config.ts +49 -0
- package/vitest.config.mjs +11 -0
- package/CHANGELOG.md +0 -1817
- package/dist/chunk-2OJ5OJ2D.mjs +0 -1
- package/dist/chunk-2OJ5OJ2D.mjs.map +0 -1
- package/dist/chunk-64DYJ27R.mjs +0 -201
- package/dist/chunk-64DYJ27R.mjs.map +0 -1
- package/dist/chunk-6QGXWNS5.mjs +0 -34
- package/dist/chunk-6QGXWNS5.mjs.map +0 -1
- package/dist/chunk-6W2UEO2M.mjs +0 -94
- package/dist/chunk-6W2UEO2M.mjs.map +0 -1
- package/dist/chunk-7DJDTRNX.mjs +0 -426
- package/dist/chunk-7DJDTRNX.mjs.map +0 -1
- package/dist/chunk-A66772CV.mjs +0 -107
- package/dist/chunk-A66772CV.mjs.map +0 -1
- package/dist/chunk-BOKE4OKY.mjs +0 -41
- package/dist/chunk-BOKE4OKY.mjs.map +0 -1
- package/dist/chunk-FCCOSO5L.mjs +0 -1
- package/dist/chunk-FCCOSO5L.mjs.map +0 -1
- package/dist/chunk-GYZIHHE6.mjs +0 -13
- package/dist/chunk-GYZIHHE6.mjs.map +0 -1
- package/dist/chunk-IAFBVORQ.mjs +0 -1
- package/dist/chunk-IAFBVORQ.mjs.map +0 -1
- package/dist/chunk-JAAUCDUR.mjs +0 -38
- package/dist/chunk-JAAUCDUR.mjs.map +0 -1
- package/dist/chunk-MSUB6DGR.mjs +0 -1
- package/dist/chunk-MSUB6DGR.mjs.map +0 -1
- package/dist/chunk-N5EP5OD5.mjs +0 -1
- package/dist/chunk-N5EP5OD5.mjs.map +0 -1
- package/dist/chunk-NAFEBKSO.mjs +0 -1
- package/dist/chunk-NAFEBKSO.mjs.map +0 -1
- package/dist/chunk-P7STFMPO.mjs +0 -1
- package/dist/chunk-P7STFMPO.mjs.map +0 -1
- package/dist/chunk-PL5WNHFZ.mjs +0 -50
- package/dist/chunk-PL5WNHFZ.mjs.map +0 -1
- package/dist/chunk-UYARLQNA.mjs +0 -1
- package/dist/chunk-UYARLQNA.mjs.map +0 -1
- package/dist/chunk-XEMZTHQZ.mjs +0 -67
- package/dist/chunk-XEMZTHQZ.mjs.map +0 -1
- package/dist/chunk-XTHC46M2.mjs +0 -1
- package/dist/chunk-XTHC46M2.mjs.map +0 -1
- package/dist/constants/index.d.ts +0 -6
- package/dist/constants/index.js +0 -40
- package/dist/constants/index.js.map +0 -1
- package/dist/index.d.ts +0 -25
- package/dist/index.js +0 -1098
- package/dist/index.js.map +0 -1
- package/dist/telemetry/events.d.ts +0 -45
- package/dist/telemetry/events.js +0 -19
- package/dist/telemetry/events.js.map +0 -1
- package/dist/telemetry/events.mjs +0 -1
- package/dist/telemetry/events.mjs.map +0 -1
- package/dist/telemetry/index.d.ts +0 -3
- package/dist/telemetry/index.js +0 -188
- package/dist/telemetry/index.js.map +0 -1
- package/dist/telemetry/index.mjs.map +0 -1
- package/dist/telemetry/scarf-client.d.ts +0 -7
- package/dist/telemetry/scarf-client.js +0 -59
- package/dist/telemetry/scarf-client.js.map +0 -1
- package/dist/telemetry/scarf-client.mjs +0 -7
- package/dist/telemetry/scarf-client.mjs.map +0 -1
- package/dist/telemetry/security-check.d.ts +0 -2
- package/dist/telemetry/security-check.js +0 -2
- package/dist/telemetry/security-check.js.map +0 -1
- package/dist/telemetry/security-check.mjs +0 -1
- package/dist/telemetry/security-check.mjs.map +0 -1
- package/dist/telemetry/telemetry-client.d.ts +0 -40
- package/dist/telemetry/telemetry-client.js +0 -186
- package/dist/telemetry/telemetry-client.js.map +0 -1
- package/dist/telemetry/utils.d.ts +0 -8
- package/dist/telemetry/utils.js +0 -69
- package/dist/telemetry/utils.js.map +0 -1
- package/dist/types/action.js +0 -19
- package/dist/types/action.js.map +0 -1
- package/dist/types/action.mjs +0 -2
- package/dist/types/action.mjs.map +0 -1
- package/dist/types/copilot-cloud-config.d.ts +0 -13
- package/dist/types/copilot-cloud-config.js +0 -19
- package/dist/types/copilot-cloud-config.js.map +0 -1
- package/dist/types/copilot-cloud-config.mjs +0 -2
- package/dist/types/copilot-cloud-config.mjs.map +0 -1
- package/dist/types/error.d.ts +0 -55
- package/dist/types/error.js +0 -19
- package/dist/types/error.js.map +0 -1
- package/dist/types/error.mjs +0 -2
- package/dist/types/error.mjs.map +0 -1
- package/dist/types/index.d.ts +0 -7
- package/dist/types/index.js +0 -19
- package/dist/types/index.js.map +0 -1
- package/dist/types/index.mjs +0 -8
- package/dist/types/index.mjs.map +0 -1
- package/dist/types/message.d.ts +0 -26
- package/dist/types/message.js +0 -19
- package/dist/types/message.js.map +0 -1
- package/dist/types/message.mjs +0 -2
- package/dist/types/message.mjs.map +0 -1
- package/dist/types/openai-assistant.d.ts +0 -53
- package/dist/types/openai-assistant.js +0 -19
- package/dist/types/openai-assistant.js.map +0 -1
- package/dist/types/openai-assistant.mjs +0 -2
- package/dist/types/openai-assistant.mjs.map +0 -1
- package/dist/types/utility.d.ts +0 -6
- package/dist/types/utility.js +0 -19
- package/dist/types/utility.js.map +0 -1
- package/dist/types/utility.mjs +0 -2
- package/dist/types/utility.mjs.map +0 -1
- package/dist/utils/conditions.js +0 -74
- package/dist/utils/conditions.js.map +0 -1
- package/dist/utils/console-styling.d.ts +0 -84
- package/dist/utils/console-styling.js +0 -123
- package/dist/utils/console-styling.js.map +0 -1
- package/dist/utils/errors.js +0 -443
- package/dist/utils/errors.js.map +0 -1
- package/dist/utils/index.d.ts +0 -32
- package/dist/utils/index.js +0 -927
- package/dist/utils/index.js.map +0 -1
- package/dist/utils/json-schema.js +0 -228
- package/dist/utils/json-schema.js.map +0 -1
- package/dist/utils/random-id.js +0 -68
- package/dist/utils/random-id.js.map +0 -1
- package/dist/utils/requests.js +0 -91
- package/dist/utils/requests.js.map +0 -1
- package/dist/utils/types.d.ts +0 -20
- package/dist/utils/types.js +0 -19
- package/dist/utils/types.js.map +0 -1
- package/jest.config.js +0 -5
- package/src/telemetry/scarf-client.ts +0 -39
- package/src/telemetry/security-check.ts +0 -0
- package/src/utils/json-schema.test.ts +0 -383
- package/tsup.config.ts +0 -11
|
@@ -0,0 +1,186 @@
|
|
|
1
|
+
const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
|
|
2
|
+
let _ag_ui_client = require("@ag-ui/client");
|
|
3
|
+
|
|
4
|
+
//#region src/finalize-events.ts
|
|
5
|
+
const defaultStopMessage = "Run stopped by user";
|
|
6
|
+
const defaultAbruptEndMessage = "Run ended without emitting a terminal event";
|
|
7
|
+
/**
|
|
8
|
+
* Incremental finalizer for a streamed AG-UI run. Feed every event to
|
|
9
|
+
* `observe`; when the stream ends without a terminal event, `finalize` returns
|
|
10
|
+
* the closers for reasoning, text messages and tool calls still open plus a
|
|
11
|
+
* terminal event. AG-UI 1.0 fails a run that ends with reasoning still open,
|
|
12
|
+
* so reasoning is closed too. It also fails a RUN_FINISHED while a subagent
|
|
13
|
+
* is still open, so a stop closes open subagents as well; a RUN_ERROR
|
|
14
|
+
* abandons them, which the protocol allows. Closed lifecycles are forgotten at once and payloads are never kept,
|
|
15
|
+
* so a caller does not have to retain the event array for this purpose.
|
|
16
|
+
*/
|
|
17
|
+
function createRunEventFinalizer() {
|
|
18
|
+
const openMessageIds = /* @__PURE__ */ new Set();
|
|
19
|
+
const openReasoningMessageIds = /* @__PURE__ */ new Set();
|
|
20
|
+
const openReasoningSpanIds = /* @__PURE__ */ new Set();
|
|
21
|
+
const openToolCalls = /* @__PURE__ */ new Map();
|
|
22
|
+
const openSubagentRunIds = /* @__PURE__ */ new Set();
|
|
23
|
+
let runIdentity = {};
|
|
24
|
+
let terminalEventObserved = false;
|
|
25
|
+
const clearOpen = () => {
|
|
26
|
+
openMessageIds.clear();
|
|
27
|
+
openReasoningMessageIds.clear();
|
|
28
|
+
openReasoningSpanIds.clear();
|
|
29
|
+
openToolCalls.clear();
|
|
30
|
+
openSubagentRunIds.clear();
|
|
31
|
+
};
|
|
32
|
+
const observe = (event) => {
|
|
33
|
+
if (terminalEventObserved) return;
|
|
34
|
+
switch (event.type) {
|
|
35
|
+
case _ag_ui_client.EventType.RUN_STARTED: {
|
|
36
|
+
const { threadId, runId } = event;
|
|
37
|
+
runIdentity = {
|
|
38
|
+
threadId,
|
|
39
|
+
runId
|
|
40
|
+
};
|
|
41
|
+
break;
|
|
42
|
+
}
|
|
43
|
+
case _ag_ui_client.EventType.REASONING_START:
|
|
44
|
+
case _ag_ui_client.EventType.REASONING_END:
|
|
45
|
+
case _ag_ui_client.EventType.REASONING_MESSAGE_START:
|
|
46
|
+
case _ag_ui_client.EventType.REASONING_MESSAGE_END: {
|
|
47
|
+
const messageId = event.messageId;
|
|
48
|
+
if (typeof messageId !== "string") break;
|
|
49
|
+
const open = event.type === _ag_ui_client.EventType.REASONING_START || event.type === _ag_ui_client.EventType.REASONING_END ? openReasoningSpanIds : openReasoningMessageIds;
|
|
50
|
+
if (event.type === _ag_ui_client.EventType.REASONING_START || event.type === _ag_ui_client.EventType.REASONING_MESSAGE_START) open.add(messageId);
|
|
51
|
+
else open.delete(messageId);
|
|
52
|
+
break;
|
|
53
|
+
}
|
|
54
|
+
case _ag_ui_client.EventType.TEXT_MESSAGE_START: {
|
|
55
|
+
const messageId = event.messageId;
|
|
56
|
+
if (messageId) openMessageIds.add(messageId);
|
|
57
|
+
break;
|
|
58
|
+
}
|
|
59
|
+
case _ag_ui_client.EventType.TEXT_MESSAGE_END: {
|
|
60
|
+
const messageId = event.messageId;
|
|
61
|
+
if (typeof messageId === "string") openMessageIds.delete(messageId);
|
|
62
|
+
break;
|
|
63
|
+
}
|
|
64
|
+
case _ag_ui_client.EventType.TOOL_CALL_START: {
|
|
65
|
+
const toolCallId = event.toolCallId;
|
|
66
|
+
if (toolCallId && !openToolCalls.has(toolCallId)) openToolCalls.set(toolCallId, {
|
|
67
|
+
hasEnd: false,
|
|
68
|
+
hasResult: false
|
|
69
|
+
});
|
|
70
|
+
break;
|
|
71
|
+
}
|
|
72
|
+
case _ag_ui_client.EventType.TOOL_CALL_END:
|
|
73
|
+
case _ag_ui_client.EventType.TOOL_CALL_RESULT: {
|
|
74
|
+
const toolCallId = event.toolCallId;
|
|
75
|
+
if (!toolCallId) break;
|
|
76
|
+
const info = openToolCalls.get(toolCallId);
|
|
77
|
+
if (!info) break;
|
|
78
|
+
if (event.type === _ag_ui_client.EventType.TOOL_CALL_END) info.hasEnd = true;
|
|
79
|
+
else info.hasResult = true;
|
|
80
|
+
if (info.hasEnd && info.hasResult) openToolCalls.delete(toolCallId);
|
|
81
|
+
break;
|
|
82
|
+
}
|
|
83
|
+
case _ag_ui_client.EventType.SUBAGENT_STARTED:
|
|
84
|
+
case _ag_ui_client.EventType.SUBAGENT_FINISHED:
|
|
85
|
+
case _ag_ui_client.EventType.SUBAGENT_ERROR: {
|
|
86
|
+
const subagentRunId = event.subagentRunId;
|
|
87
|
+
if (!subagentRunId) break;
|
|
88
|
+
if (event.type === _ag_ui_client.EventType.SUBAGENT_STARTED) openSubagentRunIds.add(subagentRunId);
|
|
89
|
+
else openSubagentRunIds.delete(subagentRunId);
|
|
90
|
+
break;
|
|
91
|
+
}
|
|
92
|
+
case _ag_ui_client.EventType.RUN_FINISHED:
|
|
93
|
+
case _ag_ui_client.EventType.RUN_ERROR:
|
|
94
|
+
terminalEventObserved = true;
|
|
95
|
+
clearOpen();
|
|
96
|
+
break;
|
|
97
|
+
default: break;
|
|
98
|
+
}
|
|
99
|
+
};
|
|
100
|
+
const finalize = (options = {}) => {
|
|
101
|
+
if (terminalEventObserved) return [];
|
|
102
|
+
const { stopRequested = false, interruptionMessage } = options;
|
|
103
|
+
const resolvedStopMessage = interruptionMessage ?? defaultStopMessage;
|
|
104
|
+
const resolvedAbruptMessage = interruptionMessage && interruptionMessage !== defaultStopMessage ? interruptionMessage : defaultAbruptEndMessage;
|
|
105
|
+
const appended = [];
|
|
106
|
+
for (const messageId of openReasoningMessageIds) appended.push({
|
|
107
|
+
type: _ag_ui_client.EventType.REASONING_MESSAGE_END,
|
|
108
|
+
messageId
|
|
109
|
+
});
|
|
110
|
+
for (const messageId of openReasoningSpanIds) appended.push({
|
|
111
|
+
type: _ag_ui_client.EventType.REASONING_END,
|
|
112
|
+
messageId
|
|
113
|
+
});
|
|
114
|
+
for (const messageId of openMessageIds) appended.push({
|
|
115
|
+
type: _ag_ui_client.EventType.TEXT_MESSAGE_END,
|
|
116
|
+
messageId
|
|
117
|
+
});
|
|
118
|
+
for (const [toolCallId, info] of openToolCalls) {
|
|
119
|
+
if (!info.hasEnd) appended.push({
|
|
120
|
+
type: _ag_ui_client.EventType.TOOL_CALL_END,
|
|
121
|
+
toolCallId
|
|
122
|
+
});
|
|
123
|
+
if (!info.hasResult) appended.push({
|
|
124
|
+
type: _ag_ui_client.EventType.TOOL_CALL_RESULT,
|
|
125
|
+
toolCallId,
|
|
126
|
+
messageId: `${toolCallId}-result`,
|
|
127
|
+
role: "tool",
|
|
128
|
+
content: JSON.stringify(stopRequested ? {
|
|
129
|
+
status: "stopped",
|
|
130
|
+
reason: "stop_requested",
|
|
131
|
+
message: resolvedStopMessage
|
|
132
|
+
} : {
|
|
133
|
+
status: "error",
|
|
134
|
+
reason: "missing_terminal_event",
|
|
135
|
+
message: resolvedAbruptMessage
|
|
136
|
+
})
|
|
137
|
+
});
|
|
138
|
+
}
|
|
139
|
+
if (stopRequested) {
|
|
140
|
+
const openIds = [...openSubagentRunIds];
|
|
141
|
+
for (let index = openIds.length - 1; index >= 0; index -= 1) appended.push({
|
|
142
|
+
type: _ag_ui_client.EventType.SUBAGENT_ERROR,
|
|
143
|
+
subagentRunId: openIds[index],
|
|
144
|
+
message: resolvedStopMessage,
|
|
145
|
+
code: "CANCELLED"
|
|
146
|
+
});
|
|
147
|
+
appended.push({
|
|
148
|
+
type: _ag_ui_client.EventType.RUN_FINISHED,
|
|
149
|
+
...runIdentity.threadId !== void 0 ? { threadId: runIdentity.threadId } : {},
|
|
150
|
+
...runIdentity.runId !== void 0 ? { runId: runIdentity.runId } : {},
|
|
151
|
+
...options.protocolVersion !== void 0 ? { outcome: { type: "cancelled" } } : {}
|
|
152
|
+
});
|
|
153
|
+
} else {
|
|
154
|
+
const errorEvent = {
|
|
155
|
+
type: _ag_ui_client.EventType.RUN_ERROR,
|
|
156
|
+
message: resolvedAbruptMessage,
|
|
157
|
+
code: "INCOMPLETE_STREAM"
|
|
158
|
+
};
|
|
159
|
+
appended.push(errorEvent);
|
|
160
|
+
}
|
|
161
|
+
terminalEventObserved = true;
|
|
162
|
+
clearOpen();
|
|
163
|
+
return appended;
|
|
164
|
+
};
|
|
165
|
+
return {
|
|
166
|
+
observe,
|
|
167
|
+
finalize
|
|
168
|
+
};
|
|
169
|
+
}
|
|
170
|
+
/**
|
|
171
|
+
* Array form of {@link createRunEventFinalizer} for callers that already keep
|
|
172
|
+
* the run's events (runners persist them). Appends the closers to `events` in
|
|
173
|
+
* place and returns them.
|
|
174
|
+
*/
|
|
175
|
+
function finalizeRunEvents(events, options = {}) {
|
|
176
|
+
const finalizer = createRunEventFinalizer();
|
|
177
|
+
for (const event of events) finalizer.observe(event);
|
|
178
|
+
const appended = finalizer.finalize(options);
|
|
179
|
+
events.push(...appended);
|
|
180
|
+
return appended;
|
|
181
|
+
}
|
|
182
|
+
|
|
183
|
+
//#endregion
|
|
184
|
+
exports.createRunEventFinalizer = createRunEventFinalizer;
|
|
185
|
+
exports.finalizeRunEvents = finalizeRunEvents;
|
|
186
|
+
//# sourceMappingURL=finalize-events.cjs.map
|
|
@@ -0,0 +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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"}
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
import { BaseEvent } from "@ag-ui/client";
|
|
2
|
+
|
|
3
|
+
//#region src/finalize-events.d.ts
|
|
4
|
+
interface FinalizeRunOptions {
|
|
5
|
+
stopRequested?: boolean;
|
|
6
|
+
interruptionMessage?: string;
|
|
7
|
+
/**
|
|
8
|
+
* The `protocolVersion` the client declared on its RunAgentInput. When it is
|
|
9
|
+
* set, a stopped run finishes with the AG-UI 1.0 `cancelled` outcome. A
|
|
10
|
+
* client that declares no version predates 1.0 and cannot parse that
|
|
11
|
+
* outcome, so it gets the plain RUN_FINISHED it always got.
|
|
12
|
+
*/
|
|
13
|
+
protocolVersion?: string;
|
|
14
|
+
}
|
|
15
|
+
interface RunEventFinalizer {
|
|
16
|
+
/** Observe one streamed event. Only the ids of open lifecycles are kept. */
|
|
17
|
+
observe(event: BaseEvent): void;
|
|
18
|
+
/** Return the events that close an interrupted or abruptly ended stream. */
|
|
19
|
+
finalize(options?: FinalizeRunOptions): BaseEvent[];
|
|
20
|
+
}
|
|
21
|
+
/**
|
|
22
|
+
* Incremental finalizer for a streamed AG-UI run. Feed every event to
|
|
23
|
+
* `observe`; when the stream ends without a terminal event, `finalize` returns
|
|
24
|
+
* the closers for reasoning, text messages and tool calls still open plus a
|
|
25
|
+
* terminal event. AG-UI 1.0 fails a run that ends with reasoning still open,
|
|
26
|
+
* so reasoning is closed too. It also fails a RUN_FINISHED while a subagent
|
|
27
|
+
* is still open, so a stop closes open subagents as well; a RUN_ERROR
|
|
28
|
+
* abandons them, which the protocol allows. Closed lifecycles are forgotten at once and payloads are never kept,
|
|
29
|
+
* so a caller does not have to retain the event array for this purpose.
|
|
30
|
+
*/
|
|
31
|
+
declare function createRunEventFinalizer(): RunEventFinalizer;
|
|
32
|
+
/**
|
|
33
|
+
* Array form of {@link createRunEventFinalizer} for callers that already keep
|
|
34
|
+
* the run's events (runners persist them). Appends the closers to `events` in
|
|
35
|
+
* place and returns them.
|
|
36
|
+
*/
|
|
37
|
+
declare function finalizeRunEvents(events: BaseEvent[], options?: FinalizeRunOptions): BaseEvent[];
|
|
38
|
+
//#endregion
|
|
39
|
+
export { FinalizeRunOptions, RunEventFinalizer, createRunEventFinalizer, finalizeRunEvents };
|
|
40
|
+
//# sourceMappingURL=finalize-events.d.cts.map
|
|
@@ -0,0 +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"}
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
import { BaseEvent } from "@ag-ui/client";
|
|
2
|
+
|
|
3
|
+
//#region src/finalize-events.d.ts
|
|
4
|
+
interface FinalizeRunOptions {
|
|
5
|
+
stopRequested?: boolean;
|
|
6
|
+
interruptionMessage?: string;
|
|
7
|
+
/**
|
|
8
|
+
* The `protocolVersion` the client declared on its RunAgentInput. When it is
|
|
9
|
+
* set, a stopped run finishes with the AG-UI 1.0 `cancelled` outcome. A
|
|
10
|
+
* client that declares no version predates 1.0 and cannot parse that
|
|
11
|
+
* outcome, so it gets the plain RUN_FINISHED it always got.
|
|
12
|
+
*/
|
|
13
|
+
protocolVersion?: string;
|
|
14
|
+
}
|
|
15
|
+
interface RunEventFinalizer {
|
|
16
|
+
/** Observe one streamed event. Only the ids of open lifecycles are kept. */
|
|
17
|
+
observe(event: BaseEvent): void;
|
|
18
|
+
/** Return the events that close an interrupted or abruptly ended stream. */
|
|
19
|
+
finalize(options?: FinalizeRunOptions): BaseEvent[];
|
|
20
|
+
}
|
|
21
|
+
/**
|
|
22
|
+
* Incremental finalizer for a streamed AG-UI run. Feed every event to
|
|
23
|
+
* `observe`; when the stream ends without a terminal event, `finalize` returns
|
|
24
|
+
* the closers for reasoning, text messages and tool calls still open plus a
|
|
25
|
+
* terminal event. AG-UI 1.0 fails a run that ends with reasoning still open,
|
|
26
|
+
* so reasoning is closed too. It also fails a RUN_FINISHED while a subagent
|
|
27
|
+
* is still open, so a stop closes open subagents as well; a RUN_ERROR
|
|
28
|
+
* abandons them, which the protocol allows. Closed lifecycles are forgotten at once and payloads are never kept,
|
|
29
|
+
* so a caller does not have to retain the event array for this purpose.
|
|
30
|
+
*/
|
|
31
|
+
declare function createRunEventFinalizer(): RunEventFinalizer;
|
|
32
|
+
/**
|
|
33
|
+
* Array form of {@link createRunEventFinalizer} for callers that already keep
|
|
34
|
+
* the run's events (runners persist them). Appends the closers to `events` in
|
|
35
|
+
* place and returns them.
|
|
36
|
+
*/
|
|
37
|
+
declare function finalizeRunEvents(events: BaseEvent[], options?: FinalizeRunOptions): BaseEvent[];
|
|
38
|
+
//#endregion
|
|
39
|
+
export { FinalizeRunOptions, RunEventFinalizer, createRunEventFinalizer, finalizeRunEvents };
|
|
40
|
+
//# sourceMappingURL=finalize-events.d.mts.map
|
|
@@ -0,0 +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"}
|
|
@@ -0,0 +1,184 @@
|
|
|
1
|
+
import { EventType } from "@ag-ui/client";
|
|
2
|
+
|
|
3
|
+
//#region src/finalize-events.ts
|
|
4
|
+
const defaultStopMessage = "Run stopped by user";
|
|
5
|
+
const defaultAbruptEndMessage = "Run ended without emitting a terminal event";
|
|
6
|
+
/**
|
|
7
|
+
* Incremental finalizer for a streamed AG-UI run. Feed every event to
|
|
8
|
+
* `observe`; when the stream ends without a terminal event, `finalize` returns
|
|
9
|
+
* the closers for reasoning, text messages and tool calls still open plus a
|
|
10
|
+
* terminal event. AG-UI 1.0 fails a run that ends with reasoning still open,
|
|
11
|
+
* so reasoning is closed too. It also fails a RUN_FINISHED while a subagent
|
|
12
|
+
* is still open, so a stop closes open subagents as well; a RUN_ERROR
|
|
13
|
+
* abandons them, which the protocol allows. Closed lifecycles are forgotten at once and payloads are never kept,
|
|
14
|
+
* so a caller does not have to retain the event array for this purpose.
|
|
15
|
+
*/
|
|
16
|
+
function createRunEventFinalizer() {
|
|
17
|
+
const openMessageIds = /* @__PURE__ */ new Set();
|
|
18
|
+
const openReasoningMessageIds = /* @__PURE__ */ new Set();
|
|
19
|
+
const openReasoningSpanIds = /* @__PURE__ */ new Set();
|
|
20
|
+
const openToolCalls = /* @__PURE__ */ new Map();
|
|
21
|
+
const openSubagentRunIds = /* @__PURE__ */ new Set();
|
|
22
|
+
let runIdentity = {};
|
|
23
|
+
let terminalEventObserved = false;
|
|
24
|
+
const clearOpen = () => {
|
|
25
|
+
openMessageIds.clear();
|
|
26
|
+
openReasoningMessageIds.clear();
|
|
27
|
+
openReasoningSpanIds.clear();
|
|
28
|
+
openToolCalls.clear();
|
|
29
|
+
openSubagentRunIds.clear();
|
|
30
|
+
};
|
|
31
|
+
const observe = (event) => {
|
|
32
|
+
if (terminalEventObserved) return;
|
|
33
|
+
switch (event.type) {
|
|
34
|
+
case EventType.RUN_STARTED: {
|
|
35
|
+
const { threadId, runId } = event;
|
|
36
|
+
runIdentity = {
|
|
37
|
+
threadId,
|
|
38
|
+
runId
|
|
39
|
+
};
|
|
40
|
+
break;
|
|
41
|
+
}
|
|
42
|
+
case EventType.REASONING_START:
|
|
43
|
+
case EventType.REASONING_END:
|
|
44
|
+
case EventType.REASONING_MESSAGE_START:
|
|
45
|
+
case EventType.REASONING_MESSAGE_END: {
|
|
46
|
+
const messageId = event.messageId;
|
|
47
|
+
if (typeof messageId !== "string") break;
|
|
48
|
+
const open = event.type === EventType.REASONING_START || event.type === EventType.REASONING_END ? openReasoningSpanIds : openReasoningMessageIds;
|
|
49
|
+
if (event.type === EventType.REASONING_START || event.type === EventType.REASONING_MESSAGE_START) open.add(messageId);
|
|
50
|
+
else open.delete(messageId);
|
|
51
|
+
break;
|
|
52
|
+
}
|
|
53
|
+
case EventType.TEXT_MESSAGE_START: {
|
|
54
|
+
const messageId = event.messageId;
|
|
55
|
+
if (messageId) openMessageIds.add(messageId);
|
|
56
|
+
break;
|
|
57
|
+
}
|
|
58
|
+
case EventType.TEXT_MESSAGE_END: {
|
|
59
|
+
const messageId = event.messageId;
|
|
60
|
+
if (typeof messageId === "string") openMessageIds.delete(messageId);
|
|
61
|
+
break;
|
|
62
|
+
}
|
|
63
|
+
case EventType.TOOL_CALL_START: {
|
|
64
|
+
const toolCallId = event.toolCallId;
|
|
65
|
+
if (toolCallId && !openToolCalls.has(toolCallId)) openToolCalls.set(toolCallId, {
|
|
66
|
+
hasEnd: false,
|
|
67
|
+
hasResult: false
|
|
68
|
+
});
|
|
69
|
+
break;
|
|
70
|
+
}
|
|
71
|
+
case EventType.TOOL_CALL_END:
|
|
72
|
+
case EventType.TOOL_CALL_RESULT: {
|
|
73
|
+
const toolCallId = event.toolCallId;
|
|
74
|
+
if (!toolCallId) break;
|
|
75
|
+
const info = openToolCalls.get(toolCallId);
|
|
76
|
+
if (!info) break;
|
|
77
|
+
if (event.type === EventType.TOOL_CALL_END) info.hasEnd = true;
|
|
78
|
+
else info.hasResult = true;
|
|
79
|
+
if (info.hasEnd && info.hasResult) openToolCalls.delete(toolCallId);
|
|
80
|
+
break;
|
|
81
|
+
}
|
|
82
|
+
case EventType.SUBAGENT_STARTED:
|
|
83
|
+
case EventType.SUBAGENT_FINISHED:
|
|
84
|
+
case EventType.SUBAGENT_ERROR: {
|
|
85
|
+
const subagentRunId = event.subagentRunId;
|
|
86
|
+
if (!subagentRunId) break;
|
|
87
|
+
if (event.type === EventType.SUBAGENT_STARTED) openSubagentRunIds.add(subagentRunId);
|
|
88
|
+
else openSubagentRunIds.delete(subagentRunId);
|
|
89
|
+
break;
|
|
90
|
+
}
|
|
91
|
+
case EventType.RUN_FINISHED:
|
|
92
|
+
case EventType.RUN_ERROR:
|
|
93
|
+
terminalEventObserved = true;
|
|
94
|
+
clearOpen();
|
|
95
|
+
break;
|
|
96
|
+
default: break;
|
|
97
|
+
}
|
|
98
|
+
};
|
|
99
|
+
const finalize = (options = {}) => {
|
|
100
|
+
if (terminalEventObserved) return [];
|
|
101
|
+
const { stopRequested = false, interruptionMessage } = options;
|
|
102
|
+
const resolvedStopMessage = interruptionMessage ?? defaultStopMessage;
|
|
103
|
+
const resolvedAbruptMessage = interruptionMessage && interruptionMessage !== defaultStopMessage ? interruptionMessage : defaultAbruptEndMessage;
|
|
104
|
+
const appended = [];
|
|
105
|
+
for (const messageId of openReasoningMessageIds) appended.push({
|
|
106
|
+
type: EventType.REASONING_MESSAGE_END,
|
|
107
|
+
messageId
|
|
108
|
+
});
|
|
109
|
+
for (const messageId of openReasoningSpanIds) appended.push({
|
|
110
|
+
type: EventType.REASONING_END,
|
|
111
|
+
messageId
|
|
112
|
+
});
|
|
113
|
+
for (const messageId of openMessageIds) appended.push({
|
|
114
|
+
type: EventType.TEXT_MESSAGE_END,
|
|
115
|
+
messageId
|
|
116
|
+
});
|
|
117
|
+
for (const [toolCallId, info] of openToolCalls) {
|
|
118
|
+
if (!info.hasEnd) appended.push({
|
|
119
|
+
type: EventType.TOOL_CALL_END,
|
|
120
|
+
toolCallId
|
|
121
|
+
});
|
|
122
|
+
if (!info.hasResult) appended.push({
|
|
123
|
+
type: EventType.TOOL_CALL_RESULT,
|
|
124
|
+
toolCallId,
|
|
125
|
+
messageId: `${toolCallId}-result`,
|
|
126
|
+
role: "tool",
|
|
127
|
+
content: JSON.stringify(stopRequested ? {
|
|
128
|
+
status: "stopped",
|
|
129
|
+
reason: "stop_requested",
|
|
130
|
+
message: resolvedStopMessage
|
|
131
|
+
} : {
|
|
132
|
+
status: "error",
|
|
133
|
+
reason: "missing_terminal_event",
|
|
134
|
+
message: resolvedAbruptMessage
|
|
135
|
+
})
|
|
136
|
+
});
|
|
137
|
+
}
|
|
138
|
+
if (stopRequested) {
|
|
139
|
+
const openIds = [...openSubagentRunIds];
|
|
140
|
+
for (let index = openIds.length - 1; index >= 0; index -= 1) appended.push({
|
|
141
|
+
type: EventType.SUBAGENT_ERROR,
|
|
142
|
+
subagentRunId: openIds[index],
|
|
143
|
+
message: resolvedStopMessage,
|
|
144
|
+
code: "CANCELLED"
|
|
145
|
+
});
|
|
146
|
+
appended.push({
|
|
147
|
+
type: EventType.RUN_FINISHED,
|
|
148
|
+
...runIdentity.threadId !== void 0 ? { threadId: runIdentity.threadId } : {},
|
|
149
|
+
...runIdentity.runId !== void 0 ? { runId: runIdentity.runId } : {},
|
|
150
|
+
...options.protocolVersion !== void 0 ? { outcome: { type: "cancelled" } } : {}
|
|
151
|
+
});
|
|
152
|
+
} else {
|
|
153
|
+
const errorEvent = {
|
|
154
|
+
type: EventType.RUN_ERROR,
|
|
155
|
+
message: resolvedAbruptMessage,
|
|
156
|
+
code: "INCOMPLETE_STREAM"
|
|
157
|
+
};
|
|
158
|
+
appended.push(errorEvent);
|
|
159
|
+
}
|
|
160
|
+
terminalEventObserved = true;
|
|
161
|
+
clearOpen();
|
|
162
|
+
return appended;
|
|
163
|
+
};
|
|
164
|
+
return {
|
|
165
|
+
observe,
|
|
166
|
+
finalize
|
|
167
|
+
};
|
|
168
|
+
}
|
|
169
|
+
/**
|
|
170
|
+
* Array form of {@link createRunEventFinalizer} for callers that already keep
|
|
171
|
+
* the run's events (runners persist them). Appends the closers to `events` in
|
|
172
|
+
* place and returns them.
|
|
173
|
+
*/
|
|
174
|
+
function finalizeRunEvents(events, options = {}) {
|
|
175
|
+
const finalizer = createRunEventFinalizer();
|
|
176
|
+
for (const event of events) finalizer.observe(event);
|
|
177
|
+
const appended = finalizer.finalize(options);
|
|
178
|
+
events.push(...appended);
|
|
179
|
+
return appended;
|
|
180
|
+
}
|
|
181
|
+
|
|
182
|
+
//#endregion
|
|
183
|
+
export { createRunEventFinalizer, finalizeRunEvents };
|
|
184
|
+
//# sourceMappingURL=finalize-events.mjs.map
|
|
@@ -0,0 +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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"}
|