@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,263 @@
|
|
|
1
|
+
import { isSafeDashboardUrl } from "./dashboard-url";
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* Inspector metadata supplied by a trusted CopilotKit runtime.
|
|
5
|
+
*
|
|
6
|
+
* Each optional module is independent so clients can render partial metadata
|
|
7
|
+
* from runtimes that do not expose every module.
|
|
8
|
+
*/
|
|
9
|
+
export interface InspectorMetadataV1 {
|
|
10
|
+
readonly schemaVersion: 1;
|
|
11
|
+
readonly identity?: {
|
|
12
|
+
readonly organizationName: string;
|
|
13
|
+
readonly projectName: string;
|
|
14
|
+
};
|
|
15
|
+
readonly plan?: {
|
|
16
|
+
readonly code: string;
|
|
17
|
+
readonly label: string;
|
|
18
|
+
};
|
|
19
|
+
readonly license?: {
|
|
20
|
+
readonly state: "valid" | "none" | "expired" | "unknown";
|
|
21
|
+
};
|
|
22
|
+
readonly action?:
|
|
23
|
+
| { readonly kind: "manage_plan"; readonly url: string }
|
|
24
|
+
| { readonly kind: "renew"; readonly url: string }
|
|
25
|
+
| { readonly kind: "enable_intelligence"; readonly url: string };
|
|
26
|
+
readonly usage?: {
|
|
27
|
+
readonly used: number;
|
|
28
|
+
readonly limit:
|
|
29
|
+
| { readonly kind: "finite"; readonly value: number }
|
|
30
|
+
| { readonly kind: "unlimited" }
|
|
31
|
+
| { readonly kind: "unknown" };
|
|
32
|
+
readonly expiringSoonCount?: number;
|
|
33
|
+
};
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
type UnknownRecord = Record<string, unknown>;
|
|
37
|
+
type InspectorIdentity = NonNullable<InspectorMetadataV1["identity"]>;
|
|
38
|
+
type InspectorPlan = NonNullable<InspectorMetadataV1["plan"]>;
|
|
39
|
+
type InspectorLicense = NonNullable<InspectorMetadataV1["license"]>;
|
|
40
|
+
type InspectorAction = NonNullable<InspectorMetadataV1["action"]>;
|
|
41
|
+
type InspectorUsage = NonNullable<InspectorMetadataV1["usage"]>;
|
|
42
|
+
type InspectorUsageLimit = InspectorUsage["limit"];
|
|
43
|
+
|
|
44
|
+
function isRecord(value: unknown): value is UnknownRecord {
|
|
45
|
+
if (typeof value !== "object" || value === null || Array.isArray(value)) {
|
|
46
|
+
return false;
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
try {
|
|
50
|
+
const prototype = Object.getPrototypeOf(value);
|
|
51
|
+
return prototype === Object.prototype || prototype === null;
|
|
52
|
+
} catch {
|
|
53
|
+
return false;
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
function readOwnDataProperty(value: UnknownRecord, key: string): unknown {
|
|
58
|
+
try {
|
|
59
|
+
const descriptor = Object.getOwnPropertyDescriptor(value, key);
|
|
60
|
+
return descriptor !== undefined && "value" in descriptor
|
|
61
|
+
? descriptor.value
|
|
62
|
+
: undefined;
|
|
63
|
+
} catch {
|
|
64
|
+
return undefined;
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
function parseNonBlankString(value: unknown): string | undefined {
|
|
69
|
+
if (typeof value !== "string") {
|
|
70
|
+
return undefined;
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
const parsed = value.trim();
|
|
74
|
+
return parsed.length > 0 ? parsed : undefined;
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
function parseIdentity(value: unknown): InspectorIdentity | undefined {
|
|
78
|
+
if (!isRecord(value)) {
|
|
79
|
+
return undefined;
|
|
80
|
+
}
|
|
81
|
+
|
|
82
|
+
const organizationName = parseNonBlankString(value.organizationName);
|
|
83
|
+
const projectName = parseNonBlankString(value.projectName);
|
|
84
|
+
if (organizationName === undefined || projectName === undefined) {
|
|
85
|
+
return undefined;
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
return { organizationName, projectName };
|
|
89
|
+
}
|
|
90
|
+
|
|
91
|
+
function parsePlan(value: unknown): InspectorPlan | undefined {
|
|
92
|
+
if (!isRecord(value)) {
|
|
93
|
+
return undefined;
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
const code = parseNonBlankString(value.code);
|
|
97
|
+
const label = parseNonBlankString(value.label);
|
|
98
|
+
if (code === undefined || label === undefined) {
|
|
99
|
+
return undefined;
|
|
100
|
+
}
|
|
101
|
+
|
|
102
|
+
return { code, label };
|
|
103
|
+
}
|
|
104
|
+
|
|
105
|
+
function parseLicense(value: unknown): InspectorLicense | undefined {
|
|
106
|
+
if (!isRecord(value)) {
|
|
107
|
+
return undefined;
|
|
108
|
+
}
|
|
109
|
+
|
|
110
|
+
switch (value.state) {
|
|
111
|
+
case "valid":
|
|
112
|
+
case "none":
|
|
113
|
+
case "expired":
|
|
114
|
+
case "unknown":
|
|
115
|
+
return { state: value.state };
|
|
116
|
+
default:
|
|
117
|
+
return undefined;
|
|
118
|
+
}
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
function parseActionKind(value: unknown): InspectorAction["kind"] | undefined {
|
|
122
|
+
switch (value) {
|
|
123
|
+
case "manage_plan":
|
|
124
|
+
case "renew":
|
|
125
|
+
case "enable_intelligence":
|
|
126
|
+
return value;
|
|
127
|
+
default:
|
|
128
|
+
return undefined;
|
|
129
|
+
}
|
|
130
|
+
}
|
|
131
|
+
|
|
132
|
+
function parseSafeActionUrl(value: unknown): string | undefined {
|
|
133
|
+
const url = parseNonBlankString(value);
|
|
134
|
+
if (url === undefined || url.includes("?") || url.includes("#")) {
|
|
135
|
+
return undefined;
|
|
136
|
+
}
|
|
137
|
+
|
|
138
|
+
const authorityStart = url.indexOf("://");
|
|
139
|
+
if (authorityStart < 1) {
|
|
140
|
+
return undefined;
|
|
141
|
+
}
|
|
142
|
+
|
|
143
|
+
const authorityAndPath = url.slice(authorityStart + 3);
|
|
144
|
+
const pathStart = authorityAndPath.indexOf("/");
|
|
145
|
+
const authority =
|
|
146
|
+
pathStart === -1 ? authorityAndPath : authorityAndPath.slice(0, pathStart);
|
|
147
|
+
if (authority.includes("@")) {
|
|
148
|
+
return undefined;
|
|
149
|
+
}
|
|
150
|
+
|
|
151
|
+
let parsed: URL;
|
|
152
|
+
try {
|
|
153
|
+
parsed = new URL(url);
|
|
154
|
+
} catch {
|
|
155
|
+
return undefined;
|
|
156
|
+
}
|
|
157
|
+
|
|
158
|
+
if (parsed.hostname.length === 0 || parsed.username || parsed.password) {
|
|
159
|
+
return undefined;
|
|
160
|
+
}
|
|
161
|
+
|
|
162
|
+
return isSafeDashboardUrl(parsed) ? url : undefined;
|
|
163
|
+
}
|
|
164
|
+
|
|
165
|
+
function parseAction(value: unknown): InspectorAction | undefined {
|
|
166
|
+
if (!isRecord(value)) {
|
|
167
|
+
return undefined;
|
|
168
|
+
}
|
|
169
|
+
|
|
170
|
+
const kind = parseActionKind(value.kind);
|
|
171
|
+
const url = parseSafeActionUrl(value.url);
|
|
172
|
+
if (kind === undefined || url === undefined) {
|
|
173
|
+
return undefined;
|
|
174
|
+
}
|
|
175
|
+
|
|
176
|
+
return { kind, url };
|
|
177
|
+
}
|
|
178
|
+
|
|
179
|
+
function isFiniteNonnegativeInteger(value: unknown): value is number {
|
|
180
|
+
return typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
|
|
181
|
+
}
|
|
182
|
+
|
|
183
|
+
function parseUsageLimit(value: unknown): InspectorUsageLimit | undefined {
|
|
184
|
+
if (!isRecord(value)) {
|
|
185
|
+
return undefined;
|
|
186
|
+
}
|
|
187
|
+
|
|
188
|
+
if (value.kind === "finite") {
|
|
189
|
+
if (
|
|
190
|
+
typeof value.value !== "number" ||
|
|
191
|
+
!Number.isSafeInteger(value.value) ||
|
|
192
|
+
value.value < 1
|
|
193
|
+
) {
|
|
194
|
+
return undefined;
|
|
195
|
+
}
|
|
196
|
+
|
|
197
|
+
return { kind: "finite", value: value.value };
|
|
198
|
+
}
|
|
199
|
+
|
|
200
|
+
if (value.kind === "unlimited") {
|
|
201
|
+
return { kind: "unlimited" };
|
|
202
|
+
}
|
|
203
|
+
|
|
204
|
+
if (value.kind === "unknown") {
|
|
205
|
+
return { kind: "unknown" };
|
|
206
|
+
}
|
|
207
|
+
|
|
208
|
+
return undefined;
|
|
209
|
+
}
|
|
210
|
+
|
|
211
|
+
function parseUsage(value: unknown): InspectorUsage | undefined {
|
|
212
|
+
if (!isRecord(value)) {
|
|
213
|
+
return undefined;
|
|
214
|
+
}
|
|
215
|
+
|
|
216
|
+
const limit = parseUsageLimit(value.limit);
|
|
217
|
+
const used = value.used;
|
|
218
|
+
if (!isFiniteNonnegativeInteger(used) || limit === undefined) {
|
|
219
|
+
return undefined;
|
|
220
|
+
}
|
|
221
|
+
|
|
222
|
+
const rawExpiringSoonCount = readOwnDataProperty(value, "expiringSoonCount");
|
|
223
|
+
const expiringSoonCount = isFiniteNonnegativeInteger(rawExpiringSoonCount)
|
|
224
|
+
? rawExpiringSoonCount
|
|
225
|
+
: undefined;
|
|
226
|
+
|
|
227
|
+
return {
|
|
228
|
+
used,
|
|
229
|
+
limit,
|
|
230
|
+
...(expiringSoonCount === undefined ? {} : { expiringSoonCount }),
|
|
231
|
+
};
|
|
232
|
+
}
|
|
233
|
+
|
|
234
|
+
/**
|
|
235
|
+
* Parses untrusted inspector metadata without letting one invalid optional
|
|
236
|
+
* module hide the other valid modules.
|
|
237
|
+
*
|
|
238
|
+
* @param value - The decoded runtime response body.
|
|
239
|
+
* @returns Normalized version 1 metadata, or `undefined` for an unsupported
|
|
240
|
+
* top-level payload.
|
|
241
|
+
*/
|
|
242
|
+
export function parseInspectorMetadataV1(
|
|
243
|
+
value: unknown,
|
|
244
|
+
): InspectorMetadataV1 | undefined {
|
|
245
|
+
if (!isRecord(value) || value.schemaVersion !== 1) {
|
|
246
|
+
return undefined;
|
|
247
|
+
}
|
|
248
|
+
|
|
249
|
+
const identity = parseIdentity(value.identity);
|
|
250
|
+
const plan = parsePlan(value.plan);
|
|
251
|
+
const license = parseLicense(value.license);
|
|
252
|
+
const action = parseAction(value.action);
|
|
253
|
+
const usage = parseUsage(value.usage);
|
|
254
|
+
|
|
255
|
+
return {
|
|
256
|
+
schemaVersion: 1,
|
|
257
|
+
...(identity === undefined ? {} : { identity }),
|
|
258
|
+
...(plan === undefined ? {} : { plan }),
|
|
259
|
+
...(license === undefined ? {} : { license }),
|
|
260
|
+
...(action === undefined ? {} : { action }),
|
|
261
|
+
...(usage === undefined ? {} : { usage }),
|
|
262
|
+
};
|
|
263
|
+
}
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
import { describe, expect, it } from "vitest";
|
|
2
|
+
import { shouldEnableInspector } from "./inspector-visibility";
|
|
3
|
+
|
|
4
|
+
describe("shouldEnableInspector", () => {
|
|
5
|
+
it("shows by default in a development browser", () => {
|
|
6
|
+
expect(
|
|
7
|
+
shouldEnableInspector({
|
|
8
|
+
isBrowser: true,
|
|
9
|
+
isDevelopment: true,
|
|
10
|
+
}),
|
|
11
|
+
).toBe(true);
|
|
12
|
+
});
|
|
13
|
+
|
|
14
|
+
it("honors an explicit disable in development", () => {
|
|
15
|
+
expect(
|
|
16
|
+
shouldEnableInspector({
|
|
17
|
+
enableInspector: false,
|
|
18
|
+
isBrowser: true,
|
|
19
|
+
isDevelopment: true,
|
|
20
|
+
}),
|
|
21
|
+
).toBe(false);
|
|
22
|
+
});
|
|
23
|
+
|
|
24
|
+
it("never shows in production, even when explicitly enabled", () => {
|
|
25
|
+
expect(
|
|
26
|
+
shouldEnableInspector({
|
|
27
|
+
enableInspector: true,
|
|
28
|
+
isBrowser: true,
|
|
29
|
+
isDevelopment: false,
|
|
30
|
+
}),
|
|
31
|
+
).toBe(false);
|
|
32
|
+
});
|
|
33
|
+
|
|
34
|
+
it("never shows during server rendering", () => {
|
|
35
|
+
expect(
|
|
36
|
+
shouldEnableInspector({
|
|
37
|
+
enableInspector: true,
|
|
38
|
+
isBrowser: false,
|
|
39
|
+
isDevelopment: true,
|
|
40
|
+
}),
|
|
41
|
+
).toBe(false);
|
|
42
|
+
});
|
|
43
|
+
});
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
export interface InspectorVisibilityOptions {
|
|
2
|
+
enableInspector?: boolean;
|
|
3
|
+
isBrowser: boolean;
|
|
4
|
+
isDevelopment: boolean;
|
|
5
|
+
}
|
|
6
|
+
|
|
7
|
+
/**
|
|
8
|
+
* The Inspector is a development-only browser tool. Consumers may disable it,
|
|
9
|
+
* but an explicit `true` never overrides a production or server environment.
|
|
10
|
+
*/
|
|
11
|
+
export function shouldEnableInspector({
|
|
12
|
+
enableInspector,
|
|
13
|
+
isBrowser,
|
|
14
|
+
isDevelopment,
|
|
15
|
+
}: InspectorVisibilityOptions): boolean {
|
|
16
|
+
return isBrowser && isDevelopment && enableInspector !== false;
|
|
17
|
+
}
|
package/src/utils/json-schema.ts
CHANGED
|
@@ -37,7 +37,9 @@ export type JSONSchema =
|
|
|
37
37
|
| JSONSchemaObject
|
|
38
38
|
| JSONSchemaArray;
|
|
39
39
|
|
|
40
|
-
export function actionParametersToJsonSchema(
|
|
40
|
+
export function actionParametersToJsonSchema(
|
|
41
|
+
actionParameters: Parameter[],
|
|
42
|
+
): JSONSchema {
|
|
41
43
|
// Create the parameters object based on the argumentAnnotations
|
|
42
44
|
let parameters: { [key: string]: any } = {};
|
|
43
45
|
for (let parameter of actionParameters || []) {
|
|
@@ -60,7 +62,9 @@ export function actionParametersToJsonSchema(actionParameters: Parameter[]): JSO
|
|
|
60
62
|
}
|
|
61
63
|
|
|
62
64
|
// Convert JSONSchema to Parameter[]
|
|
63
|
-
export function jsonSchemaToActionParameters(
|
|
65
|
+
export function jsonSchemaToActionParameters(
|
|
66
|
+
jsonSchema: JSONSchema,
|
|
67
|
+
): Parameter[] {
|
|
64
68
|
if (jsonSchema.type !== "object" || !jsonSchema.properties) {
|
|
65
69
|
return [];
|
|
66
70
|
}
|
|
@@ -69,7 +73,11 @@ export function jsonSchemaToActionParameters(jsonSchema: JSONSchema): Parameter[
|
|
|
69
73
|
const requiredFields = jsonSchema.required || [];
|
|
70
74
|
|
|
71
75
|
for (const [name, schema] of Object.entries(jsonSchema.properties)) {
|
|
72
|
-
const parameter = convertJsonSchemaToParameter(
|
|
76
|
+
const parameter = convertJsonSchemaToParameter(
|
|
77
|
+
name,
|
|
78
|
+
schema,
|
|
79
|
+
requiredFields.includes(name),
|
|
80
|
+
);
|
|
73
81
|
parameters.push(parameter);
|
|
74
82
|
}
|
|
75
83
|
|
|
@@ -91,6 +99,19 @@ function convertJsonSchemaToParameter(
|
|
|
91
99
|
baseParameter.required = false;
|
|
92
100
|
}
|
|
93
101
|
|
|
102
|
+
// Handle null-union types like ["string", "null"] by picking the non-null type
|
|
103
|
+
if (Array.isArray(schema.type)) {
|
|
104
|
+
const types = schema.type as string[];
|
|
105
|
+
const hasNull = types.includes("null");
|
|
106
|
+
const nonNullTypes = types.filter((t: string) => t !== "null");
|
|
107
|
+
const resolvedType = nonNullTypes.length > 0 ? nonNullTypes[0] : "string";
|
|
108
|
+
return convertJsonSchemaToParameter(
|
|
109
|
+
name,
|
|
110
|
+
{ ...schema, type: resolvedType } as JSONSchema,
|
|
111
|
+
hasNull ? false : isRequired,
|
|
112
|
+
);
|
|
113
|
+
}
|
|
114
|
+
|
|
94
115
|
switch (schema.type) {
|
|
95
116
|
case "string":
|
|
96
117
|
return {
|
|
@@ -109,9 +130,15 @@ function convertJsonSchemaToParameter(
|
|
|
109
130
|
const attributes: Parameter[] = [];
|
|
110
131
|
const requiredFields = schema.required || [];
|
|
111
132
|
|
|
112
|
-
for (const [propName, propSchema] of Object.entries(
|
|
133
|
+
for (const [propName, propSchema] of Object.entries(
|
|
134
|
+
schema.properties,
|
|
135
|
+
)) {
|
|
113
136
|
attributes.push(
|
|
114
|
-
convertJsonSchemaToParameter(
|
|
137
|
+
convertJsonSchemaToParameter(
|
|
138
|
+
propName,
|
|
139
|
+
propSchema,
|
|
140
|
+
requiredFields.includes(propName),
|
|
141
|
+
),
|
|
115
142
|
);
|
|
116
143
|
}
|
|
117
144
|
|
|
@@ -130,9 +157,15 @@ function convertJsonSchemaToParameter(
|
|
|
130
157
|
const attributes: Parameter[] = [];
|
|
131
158
|
const requiredFields = schema.items.required || [];
|
|
132
159
|
|
|
133
|
-
for (const [propName, propSchema] of Object.entries(
|
|
160
|
+
for (const [propName, propSchema] of Object.entries(
|
|
161
|
+
schema.items.properties || {},
|
|
162
|
+
)) {
|
|
134
163
|
attributes.push(
|
|
135
|
-
convertJsonSchemaToParameter(
|
|
164
|
+
convertJsonSchemaToParameter(
|
|
165
|
+
propName,
|
|
166
|
+
propSchema,
|
|
167
|
+
requiredFields.includes(propName),
|
|
168
|
+
),
|
|
136
169
|
);
|
|
137
170
|
}
|
|
138
171
|
|
|
@@ -218,7 +251,91 @@ function convertAttribute(attribute: Parameter): JSONSchema {
|
|
|
218
251
|
}
|
|
219
252
|
}
|
|
220
253
|
|
|
221
|
-
export function convertJsonSchemaToZodSchema(
|
|
254
|
+
export function convertJsonSchemaToZodSchema(
|
|
255
|
+
jsonSchema: any,
|
|
256
|
+
required: boolean,
|
|
257
|
+
definitions?: Record<string, any>,
|
|
258
|
+
visitedRefs?: Set<string>,
|
|
259
|
+
): z.ZodSchema {
|
|
260
|
+
// Resolve $ref references
|
|
261
|
+
if (jsonSchema.$ref && definitions) {
|
|
262
|
+
const refPath = jsonSchema.$ref.replace(
|
|
263
|
+
/^#\/\$defs\/|^#\/definitions\//,
|
|
264
|
+
"",
|
|
265
|
+
);
|
|
266
|
+
|
|
267
|
+
// Detect circular $ref cycles
|
|
268
|
+
const refs = visitedRefs ?? new Set<string>();
|
|
269
|
+
if (refs.has(refPath)) {
|
|
270
|
+
console.warn(
|
|
271
|
+
`[CopilotKit] Circular $ref detected for "${refPath}" — falling back to z.any()`,
|
|
272
|
+
);
|
|
273
|
+
let schema = z.any();
|
|
274
|
+
if (jsonSchema.description) {
|
|
275
|
+
schema = schema.describe(jsonSchema.description);
|
|
276
|
+
}
|
|
277
|
+
return required ? schema : schema.optional();
|
|
278
|
+
}
|
|
279
|
+
|
|
280
|
+
const resolved = definitions[refPath];
|
|
281
|
+
if (resolved) {
|
|
282
|
+
// Clone the set so sibling branches don't see each other's visited refs
|
|
283
|
+
const nextRefs = new Set(refs);
|
|
284
|
+
nextRefs.add(refPath);
|
|
285
|
+
return convertJsonSchemaToZodSchema(
|
|
286
|
+
resolved,
|
|
287
|
+
required,
|
|
288
|
+
definitions,
|
|
289
|
+
nextRefs,
|
|
290
|
+
);
|
|
291
|
+
}
|
|
292
|
+
}
|
|
293
|
+
|
|
294
|
+
// Collect top-level definitions for $ref resolution
|
|
295
|
+
const defs = definitions ?? jsonSchema.$defs ?? jsonSchema.definitions;
|
|
296
|
+
|
|
297
|
+
// Handle null-union types like ["string", "null"]
|
|
298
|
+
if (Array.isArray(jsonSchema.type)) {
|
|
299
|
+
const types = jsonSchema.type as string[];
|
|
300
|
+
const hasNull = types.includes("null");
|
|
301
|
+
const nonNullTypes = types.filter((t: string) => t !== "null");
|
|
302
|
+
const resolvedType = nonNullTypes.length > 0 ? nonNullTypes[0] : "string";
|
|
303
|
+
const innerSchema = convertJsonSchemaToZodSchema(
|
|
304
|
+
{ ...jsonSchema, type: resolvedType },
|
|
305
|
+
true,
|
|
306
|
+
defs,
|
|
307
|
+
visitedRefs,
|
|
308
|
+
);
|
|
309
|
+
let schema = hasNull ? z.union([innerSchema, z.null()]) : innerSchema;
|
|
310
|
+
if (jsonSchema.description) {
|
|
311
|
+
schema = schema.describe(jsonSchema.description);
|
|
312
|
+
}
|
|
313
|
+
return required ? schema : schema.optional();
|
|
314
|
+
}
|
|
315
|
+
|
|
316
|
+
// Handle anyOf / oneOf as z.union
|
|
317
|
+
const unionVariants = jsonSchema.anyOf ?? jsonSchema.oneOf;
|
|
318
|
+
if (Array.isArray(unionVariants) && unionVariants.length > 0) {
|
|
319
|
+
if (unionVariants.length === 1) {
|
|
320
|
+
return convertJsonSchemaToZodSchema(
|
|
321
|
+
unionVariants[0],
|
|
322
|
+
required,
|
|
323
|
+
defs,
|
|
324
|
+
visitedRefs,
|
|
325
|
+
);
|
|
326
|
+
}
|
|
327
|
+
const schemas = unionVariants.map((v: any) =>
|
|
328
|
+
convertJsonSchemaToZodSchema(v, true, defs, visitedRefs),
|
|
329
|
+
);
|
|
330
|
+
let schema = z.union(
|
|
331
|
+
schemas as [z.ZodSchema, z.ZodSchema, ...z.ZodSchema[]],
|
|
332
|
+
);
|
|
333
|
+
if (jsonSchema.description) {
|
|
334
|
+
schema = schema.describe(jsonSchema.description);
|
|
335
|
+
}
|
|
336
|
+
return required ? schema : schema.optional();
|
|
337
|
+
}
|
|
338
|
+
|
|
222
339
|
if (jsonSchema.type === "object") {
|
|
223
340
|
const spec: { [key: string]: z.ZodSchema } = {};
|
|
224
341
|
|
|
@@ -230,28 +347,55 @@ export function convertJsonSchemaToZodSchema(jsonSchema: any, required: boolean)
|
|
|
230
347
|
spec[key] = convertJsonSchemaToZodSchema(
|
|
231
348
|
value,
|
|
232
349
|
jsonSchema.required ? jsonSchema.required.includes(key) : false,
|
|
350
|
+
defs,
|
|
351
|
+
visitedRefs,
|
|
233
352
|
);
|
|
234
353
|
}
|
|
235
354
|
let schema = z.object(spec).describe(jsonSchema.description);
|
|
236
355
|
return required ? schema : schema.optional();
|
|
237
356
|
} else if (jsonSchema.type === "string") {
|
|
357
|
+
if (jsonSchema.enum && jsonSchema.enum.length > 0) {
|
|
358
|
+
let schema = z
|
|
359
|
+
.enum(jsonSchema.enum as [string, ...string[]])
|
|
360
|
+
.describe(jsonSchema.description);
|
|
361
|
+
return required ? schema : schema.optional();
|
|
362
|
+
}
|
|
238
363
|
let schema = z.string().describe(jsonSchema.description);
|
|
239
364
|
return required ? schema : schema.optional();
|
|
240
|
-
} else if (jsonSchema.type === "number") {
|
|
365
|
+
} else if (jsonSchema.type === "number" || jsonSchema.type === "integer") {
|
|
241
366
|
let schema = z.number().describe(jsonSchema.description);
|
|
242
367
|
return required ? schema : schema.optional();
|
|
243
368
|
} else if (jsonSchema.type === "boolean") {
|
|
244
369
|
let schema = z.boolean().describe(jsonSchema.description);
|
|
245
370
|
return required ? schema : schema.optional();
|
|
246
371
|
} else if (jsonSchema.type === "array") {
|
|
247
|
-
let itemSchema = convertJsonSchemaToZodSchema(
|
|
372
|
+
let itemSchema = convertJsonSchemaToZodSchema(
|
|
373
|
+
jsonSchema.items,
|
|
374
|
+
true,
|
|
375
|
+
defs,
|
|
376
|
+
visitedRefs,
|
|
377
|
+
);
|
|
248
378
|
let schema = z.array(itemSchema).describe(jsonSchema.description);
|
|
249
379
|
return required ? schema : schema.optional();
|
|
380
|
+
} else if (jsonSchema.type === "null") {
|
|
381
|
+
let schema = z.null().describe(jsonSchema.description);
|
|
382
|
+
return required ? schema : schema.optional();
|
|
383
|
+
}
|
|
384
|
+
|
|
385
|
+
// Fallback: accept any value rather than throwing
|
|
386
|
+
console.warn(
|
|
387
|
+
`[CopilotKit] Unsupported JSON schema type "${jsonSchema.type ?? "unknown"}" — falling back to z.any()`,
|
|
388
|
+
);
|
|
389
|
+
let schema = z.any();
|
|
390
|
+
if (jsonSchema.description) {
|
|
391
|
+
schema = schema.describe(jsonSchema.description);
|
|
250
392
|
}
|
|
251
|
-
|
|
393
|
+
return required ? schema : schema.optional();
|
|
252
394
|
}
|
|
253
395
|
|
|
254
|
-
export function getZodParameters<T extends [] | Parameter[] | undefined>(
|
|
396
|
+
export function getZodParameters<T extends [] | Parameter[] | undefined>(
|
|
397
|
+
parameters: T,
|
|
398
|
+
): any {
|
|
255
399
|
if (!parameters) return z.object({});
|
|
256
400
|
const jsonParams = actionParametersToJsonSchema(parameters);
|
|
257
401
|
return convertJsonSchemaToZodSchema(jsonParams, true);
|
package/src/utils/random-id.ts
CHANGED
|
@@ -31,9 +31,12 @@ function toSerializable(value: unknown): unknown {
|
|
|
31
31
|
export function dataToUUID(input: string | object, namespace?: string): string {
|
|
32
32
|
const BASE_NAMESPACE = "e4b01160-ff74-4c6e-9b27-d53cd930fe8e";
|
|
33
33
|
// Since namespace needs to be a uuid, we are creating a uuid for it.
|
|
34
|
-
const boundNamespace = namespace
|
|
34
|
+
const boundNamespace = namespace
|
|
35
|
+
? uuidv5(namespace, BASE_NAMESPACE)
|
|
36
|
+
: BASE_NAMESPACE;
|
|
35
37
|
|
|
36
|
-
const stringInput =
|
|
38
|
+
const stringInput =
|
|
39
|
+
typeof input === "string" ? input : JSON.stringify(toSerializable(input));
|
|
37
40
|
return uuidv5(stringInput, boundNamespace);
|
|
38
41
|
}
|
|
39
42
|
|
package/src/utils/requests.ts
CHANGED
|
@@ -5,7 +5,9 @@
|
|
|
5
5
|
* - Tries JSON first regardless of content-type
|
|
6
6
|
* - Falls back to text and optionally parses when it "looks" like JSON
|
|
7
7
|
*/
|
|
8
|
-
export async function readBody<T extends Response | Request>(
|
|
8
|
+
export async function readBody<T extends Response | Request>(
|
|
9
|
+
r: T,
|
|
10
|
+
): Promise<unknown> {
|
|
9
11
|
// skip GET/HEAD requests (unchanged)
|
|
10
12
|
const method = "method" in r ? r.method.toUpperCase() : undefined;
|
|
11
13
|
if (method === "GET" || method === "HEAD") {
|