@copilotkit/shared 2.0.0-next.1 → 2.0.0-rc.0
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,104 @@
|
|
|
1
|
+
//#region src/utils/inspector-learning.d.ts
|
|
2
|
+
/** A bounded page in the Inspector Learning snapshot. */
|
|
3
|
+
interface InspectorLearningPage<T> {
|
|
4
|
+
readonly page: number;
|
|
5
|
+
readonly pageSize: number;
|
|
6
|
+
readonly total: number;
|
|
7
|
+
readonly totalPages: number;
|
|
8
|
+
readonly items: readonly T[];
|
|
9
|
+
}
|
|
10
|
+
type InspectorLearningEvidence = {
|
|
11
|
+
readonly status: "available";
|
|
12
|
+
readonly threadId: string;
|
|
13
|
+
readonly threadName: string | null;
|
|
14
|
+
readonly messageIds: readonly string[];
|
|
15
|
+
readonly updatedAt: string;
|
|
16
|
+
} | {
|
|
17
|
+
readonly status: "unavailable";
|
|
18
|
+
};
|
|
19
|
+
/** A cited Trajectory, linked into the Intelligence web app. */
|
|
20
|
+
type InspectorLearningTrajectoryEvidence = {
|
|
21
|
+
readonly status: "available";
|
|
22
|
+
readonly trajectoryId: string;
|
|
23
|
+
readonly eventCount: number;
|
|
24
|
+
readonly url: string;
|
|
25
|
+
} | {
|
|
26
|
+
readonly status: "unavailable";
|
|
27
|
+
};
|
|
28
|
+
interface InspectorLearningInsight {
|
|
29
|
+
readonly id: string;
|
|
30
|
+
readonly statement: string;
|
|
31
|
+
readonly impact: string;
|
|
32
|
+
readonly totalThreadCount: number;
|
|
33
|
+
readonly evidenceTruncated: boolean;
|
|
34
|
+
readonly evidence: readonly InspectorLearningEvidence[];
|
|
35
|
+
/** Absent when Intelligence predates Trajectory evidence. */
|
|
36
|
+
readonly totalTrajectoryCount?: number;
|
|
37
|
+
/** Absent when Intelligence predates Trajectory evidence. */
|
|
38
|
+
readonly trajectoryEvidence?: readonly InspectorLearningTrajectoryEvidence[];
|
|
39
|
+
}
|
|
40
|
+
interface InspectorLearningSkill {
|
|
41
|
+
readonly id: string;
|
|
42
|
+
readonly name: string;
|
|
43
|
+
readonly description: string;
|
|
44
|
+
readonly revision: number;
|
|
45
|
+
readonly skillMd: string;
|
|
46
|
+
readonly sourceInsight: InspectorLearningInsight | null;
|
|
47
|
+
}
|
|
48
|
+
interface InspectorLearningSnapshotV1 {
|
|
49
|
+
readonly schemaVersion: 1;
|
|
50
|
+
readonly projectKey: string;
|
|
51
|
+
readonly snapshotVersion: string;
|
|
52
|
+
readonly webAppOrigin: string;
|
|
53
|
+
readonly configuration: {
|
|
54
|
+
readonly state: "not_configured";
|
|
55
|
+
} | {
|
|
56
|
+
readonly state: "invalid";
|
|
57
|
+
readonly reason: "container" | "instrumentation";
|
|
58
|
+
} | {
|
|
59
|
+
readonly state: "configured";
|
|
60
|
+
readonly container: {
|
|
61
|
+
readonly id: string;
|
|
62
|
+
readonly name: string;
|
|
63
|
+
};
|
|
64
|
+
} | {
|
|
65
|
+
readonly state: "selection_required";
|
|
66
|
+
};
|
|
67
|
+
readonly pendingThreadCount: number;
|
|
68
|
+
readonly run: {
|
|
69
|
+
readonly hasActiveRun: boolean;
|
|
70
|
+
readonly hasEverSucceeded: boolean;
|
|
71
|
+
readonly latest: {
|
|
72
|
+
readonly completedAt: string | null;
|
|
73
|
+
readonly status: "queued" | "freezing" | "batching" | "reducing" | "finalizing" | "succeeded" | "failed";
|
|
74
|
+
} | null;
|
|
75
|
+
};
|
|
76
|
+
readonly pendingCandidateCount: number;
|
|
77
|
+
readonly skillsPage: InspectorLearningPage<InspectorLearningSkill>;
|
|
78
|
+
readonly insightsPage: InspectorLearningPage<InspectorLearningInsight>;
|
|
79
|
+
readonly links: {
|
|
80
|
+
readonly learning: string;
|
|
81
|
+
readonly candidates: string | null;
|
|
82
|
+
readonly runs: string | null;
|
|
83
|
+
};
|
|
84
|
+
}
|
|
85
|
+
interface InspectorLearningRequestV1 {
|
|
86
|
+
readonly agentId?: string;
|
|
87
|
+
readonly skillsPage?: number;
|
|
88
|
+
readonly insightsPage?: number;
|
|
89
|
+
}
|
|
90
|
+
/**
|
|
91
|
+
* Accepts only the configured Intelligence web-app origin.
|
|
92
|
+
*
|
|
93
|
+
* Learning links are server-authored actions. Treating every HTTPS origin as
|
|
94
|
+
* trusted would let a misconfigured or compromised upstream turn Inspector
|
|
95
|
+
* copy into a navigation primitive for an arbitrary site.
|
|
96
|
+
*/
|
|
97
|
+
declare function parseInspectorLearningUrl(value: unknown, trustedOrigin: unknown): string | undefined;
|
|
98
|
+
/** Validates and copies an untrusted Learning snapshot at each process boundary. */
|
|
99
|
+
declare function parseInspectorLearningSnapshotV1(value: unknown): InspectorLearningSnapshotV1 | undefined;
|
|
100
|
+
/** Normalizes the browser-owned request without accepting container scope. */
|
|
101
|
+
declare function parseInspectorLearningRequestV1(value: unknown): InspectorLearningRequestV1 | undefined;
|
|
102
|
+
//#endregion
|
|
103
|
+
export { InspectorLearningEvidence, InspectorLearningInsight, InspectorLearningPage, InspectorLearningRequestV1, InspectorLearningSkill, InspectorLearningSnapshotV1, InspectorLearningTrajectoryEvidence, parseInspectorLearningRequestV1, parseInspectorLearningSnapshotV1, parseInspectorLearningUrl };
|
|
104
|
+
//# sourceMappingURL=inspector-learning.d.cts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"inspector-learning.d.cts","names":[],"sources":["../../src/utils/inspector-learning.ts"],"mappings":";;UAGiB,qBAAA;EAAA,SACN,IAAA;EAAA,SACA,QAAA;EAAA,SACA,KAAA;EAAA,SACA,UAAA;EAAA,SACA,KAAA,WAAgB,CAAA;AAAA;AAAA,KAGf,yBAAA;EAAA,SAEG,MAAA;EAAA,SACA,QAAA;EAAA,SACA,UAAA;EAAA,SACA,UAAA;EAAA,SACA,SAAA;AAAA;EAAA,SAEA,MAAA;AAAA;;KAGH,mCAAA;EAAA,SAEG,MAAA;EAAA,SACA,YAAA;EAAA,SACA,UAAA;EAAA,SACA,GAAA;AAAA;EAAA,SAEA,MAAA;AAAA;AAAA,UAEE,wBAAA;EAAA,SACN,EAAA;EAAA,SACA,SAAA;EAAA,SACA,MAAA;EAAA,SACA,gBAAA;EAAA,SACA,iBAAA;EAAA,SACA,QAAA,WAAmB,yBAAA;EAVf;EAAA,SAYJ,oBAAA;EAVU;EAAA,SAYV,kBAAA,YAA8B,mCAAA;AAAA;AAAA,UAGxB,sBAAA;EAAA,SACN,EAAA;EAAA,SACA,IAAA;EAAA,SACA,WAAA;EAAA,SACA,QAAA;EAAA,SACA,OAAA;EAAA,SACA,aAAA,EAAe,wBAAA;AAAA;AAAA,UAGT,2BAAA;EAAA,SACN,aAAA;EAAA,SACA,UAAA;EAAA,SACA,eAAA;EAAA,SACA,YAAA;EAAA,SACA,aAAA;IAAA,SACM,KAAA;EAAA;IAAA,SAEA,KAAA;IAAA,SACA,MAAA;EAAA;IAAA,SAGA,KAAA;IAAA,SACA,SAAA;MAAA,SAAsB,EAAA;MAAA,SAAqB,IAAA;IAAA;EAAA;IAAA,SAE3C,KAAA;EAAA;EAAA,SACN,kBAAA;EAAA,SACA,GAAA;IAAA,SACE,YAAA;IAAA,SACA,gBAAA;IAAA,SACA,MAAA;MAAA,SACE,WAAA;MAAA,SACA,MAAA;IAAA;EAAA;EAAA,SAUJ,qBAAA;EAAA,SACA,UAAA,EAAY,qBAAA,CAAsB,sBAAA;EAAA,SAClC,YAAA,EAAc,qBAAA,CAAsB,wBAAA;EAAA,SACpC,KAAA;IAAA,SACE,QAAA;IAAA,SACA,UAAA;IAAA,SACA,IAAA;EAAA;AAAA;AAAA,UAII,0BAAA;EAAA,SACN,OAAA;EAAA,SACA,UAAA;EAAA,SACA,YAAA;AAAA;;;;;;;;iBAuBK,yBAAA,CACd,KAAA,WACA,aAAA;;iBA6Rc,gCAAA,CACd,KAAA,YACC,2BAAA;;iBA0Fa,+BAAA,CACd,KAAA,YACC,0BAAA"}
|
|
@@ -0,0 +1,104 @@
|
|
|
1
|
+
//#region src/utils/inspector-learning.d.ts
|
|
2
|
+
/** A bounded page in the Inspector Learning snapshot. */
|
|
3
|
+
interface InspectorLearningPage<T> {
|
|
4
|
+
readonly page: number;
|
|
5
|
+
readonly pageSize: number;
|
|
6
|
+
readonly total: number;
|
|
7
|
+
readonly totalPages: number;
|
|
8
|
+
readonly items: readonly T[];
|
|
9
|
+
}
|
|
10
|
+
type InspectorLearningEvidence = {
|
|
11
|
+
readonly status: "available";
|
|
12
|
+
readonly threadId: string;
|
|
13
|
+
readonly threadName: string | null;
|
|
14
|
+
readonly messageIds: readonly string[];
|
|
15
|
+
readonly updatedAt: string;
|
|
16
|
+
} | {
|
|
17
|
+
readonly status: "unavailable";
|
|
18
|
+
};
|
|
19
|
+
/** A cited Trajectory, linked into the Intelligence web app. */
|
|
20
|
+
type InspectorLearningTrajectoryEvidence = {
|
|
21
|
+
readonly status: "available";
|
|
22
|
+
readonly trajectoryId: string;
|
|
23
|
+
readonly eventCount: number;
|
|
24
|
+
readonly url: string;
|
|
25
|
+
} | {
|
|
26
|
+
readonly status: "unavailable";
|
|
27
|
+
};
|
|
28
|
+
interface InspectorLearningInsight {
|
|
29
|
+
readonly id: string;
|
|
30
|
+
readonly statement: string;
|
|
31
|
+
readonly impact: string;
|
|
32
|
+
readonly totalThreadCount: number;
|
|
33
|
+
readonly evidenceTruncated: boolean;
|
|
34
|
+
readonly evidence: readonly InspectorLearningEvidence[];
|
|
35
|
+
/** Absent when Intelligence predates Trajectory evidence. */
|
|
36
|
+
readonly totalTrajectoryCount?: number;
|
|
37
|
+
/** Absent when Intelligence predates Trajectory evidence. */
|
|
38
|
+
readonly trajectoryEvidence?: readonly InspectorLearningTrajectoryEvidence[];
|
|
39
|
+
}
|
|
40
|
+
interface InspectorLearningSkill {
|
|
41
|
+
readonly id: string;
|
|
42
|
+
readonly name: string;
|
|
43
|
+
readonly description: string;
|
|
44
|
+
readonly revision: number;
|
|
45
|
+
readonly skillMd: string;
|
|
46
|
+
readonly sourceInsight: InspectorLearningInsight | null;
|
|
47
|
+
}
|
|
48
|
+
interface InspectorLearningSnapshotV1 {
|
|
49
|
+
readonly schemaVersion: 1;
|
|
50
|
+
readonly projectKey: string;
|
|
51
|
+
readonly snapshotVersion: string;
|
|
52
|
+
readonly webAppOrigin: string;
|
|
53
|
+
readonly configuration: {
|
|
54
|
+
readonly state: "not_configured";
|
|
55
|
+
} | {
|
|
56
|
+
readonly state: "invalid";
|
|
57
|
+
readonly reason: "container" | "instrumentation";
|
|
58
|
+
} | {
|
|
59
|
+
readonly state: "configured";
|
|
60
|
+
readonly container: {
|
|
61
|
+
readonly id: string;
|
|
62
|
+
readonly name: string;
|
|
63
|
+
};
|
|
64
|
+
} | {
|
|
65
|
+
readonly state: "selection_required";
|
|
66
|
+
};
|
|
67
|
+
readonly pendingThreadCount: number;
|
|
68
|
+
readonly run: {
|
|
69
|
+
readonly hasActiveRun: boolean;
|
|
70
|
+
readonly hasEverSucceeded: boolean;
|
|
71
|
+
readonly latest: {
|
|
72
|
+
readonly completedAt: string | null;
|
|
73
|
+
readonly status: "queued" | "freezing" | "batching" | "reducing" | "finalizing" | "succeeded" | "failed";
|
|
74
|
+
} | null;
|
|
75
|
+
};
|
|
76
|
+
readonly pendingCandidateCount: number;
|
|
77
|
+
readonly skillsPage: InspectorLearningPage<InspectorLearningSkill>;
|
|
78
|
+
readonly insightsPage: InspectorLearningPage<InspectorLearningInsight>;
|
|
79
|
+
readonly links: {
|
|
80
|
+
readonly learning: string;
|
|
81
|
+
readonly candidates: string | null;
|
|
82
|
+
readonly runs: string | null;
|
|
83
|
+
};
|
|
84
|
+
}
|
|
85
|
+
interface InspectorLearningRequestV1 {
|
|
86
|
+
readonly agentId?: string;
|
|
87
|
+
readonly skillsPage?: number;
|
|
88
|
+
readonly insightsPage?: number;
|
|
89
|
+
}
|
|
90
|
+
/**
|
|
91
|
+
* Accepts only the configured Intelligence web-app origin.
|
|
92
|
+
*
|
|
93
|
+
* Learning links are server-authored actions. Treating every HTTPS origin as
|
|
94
|
+
* trusted would let a misconfigured or compromised upstream turn Inspector
|
|
95
|
+
* copy into a navigation primitive for an arbitrary site.
|
|
96
|
+
*/
|
|
97
|
+
declare function parseInspectorLearningUrl(value: unknown, trustedOrigin: unknown): string | undefined;
|
|
98
|
+
/** Validates and copies an untrusted Learning snapshot at each process boundary. */
|
|
99
|
+
declare function parseInspectorLearningSnapshotV1(value: unknown): InspectorLearningSnapshotV1 | undefined;
|
|
100
|
+
/** Normalizes the browser-owned request without accepting container scope. */
|
|
101
|
+
declare function parseInspectorLearningRequestV1(value: unknown): InspectorLearningRequestV1 | undefined;
|
|
102
|
+
//#endregion
|
|
103
|
+
export { InspectorLearningEvidence, InspectorLearningInsight, InspectorLearningPage, InspectorLearningRequestV1, InspectorLearningSkill, InspectorLearningSnapshotV1, InspectorLearningTrajectoryEvidence, parseInspectorLearningRequestV1, parseInspectorLearningSnapshotV1, parseInspectorLearningUrl };
|
|
104
|
+
//# sourceMappingURL=inspector-learning.d.mts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"inspector-learning.d.mts","names":[],"sources":["../../src/utils/inspector-learning.ts"],"mappings":";;UAGiB,qBAAA;EAAA,SACN,IAAA;EAAA,SACA,QAAA;EAAA,SACA,KAAA;EAAA,SACA,UAAA;EAAA,SACA,KAAA,WAAgB,CAAA;AAAA;AAAA,KAGf,yBAAA;EAAA,SAEG,MAAA;EAAA,SACA,QAAA;EAAA,SACA,UAAA;EAAA,SACA,UAAA;EAAA,SACA,SAAA;AAAA;EAAA,SAEA,MAAA;AAAA;;KAGH,mCAAA;EAAA,SAEG,MAAA;EAAA,SACA,YAAA;EAAA,SACA,UAAA;EAAA,SACA,GAAA;AAAA;EAAA,SAEA,MAAA;AAAA;AAAA,UAEE,wBAAA;EAAA,SACN,EAAA;EAAA,SACA,SAAA;EAAA,SACA,MAAA;EAAA,SACA,gBAAA;EAAA,SACA,iBAAA;EAAA,SACA,QAAA,WAAmB,yBAAA;EAVf;EAAA,SAYJ,oBAAA;EAVU;EAAA,SAYV,kBAAA,YAA8B,mCAAA;AAAA;AAAA,UAGxB,sBAAA;EAAA,SACN,EAAA;EAAA,SACA,IAAA;EAAA,SACA,WAAA;EAAA,SACA,QAAA;EAAA,SACA,OAAA;EAAA,SACA,aAAA,EAAe,wBAAA;AAAA;AAAA,UAGT,2BAAA;EAAA,SACN,aAAA;EAAA,SACA,UAAA;EAAA,SACA,eAAA;EAAA,SACA,YAAA;EAAA,SACA,aAAA;IAAA,SACM,KAAA;EAAA;IAAA,SAEA,KAAA;IAAA,SACA,MAAA;EAAA;IAAA,SAGA,KAAA;IAAA,SACA,SAAA;MAAA,SAAsB,EAAA;MAAA,SAAqB,IAAA;IAAA;EAAA;IAAA,SAE3C,KAAA;EAAA;EAAA,SACN,kBAAA;EAAA,SACA,GAAA;IAAA,SACE,YAAA;IAAA,SACA,gBAAA;IAAA,SACA,MAAA;MAAA,SACE,WAAA;MAAA,SACA,MAAA;IAAA;EAAA;EAAA,SAUJ,qBAAA;EAAA,SACA,UAAA,EAAY,qBAAA,CAAsB,sBAAA;EAAA,SAClC,YAAA,EAAc,qBAAA,CAAsB,wBAAA;EAAA,SACpC,KAAA;IAAA,SACE,QAAA;IAAA,SACA,UAAA;IAAA,SACA,IAAA;EAAA;AAAA;AAAA,UAII,0BAAA;EAAA,SACN,OAAA;EAAA,SACA,UAAA;EAAA,SACA,YAAA;AAAA;;;;;;;;iBAuBK,yBAAA,CACd,KAAA,WACA,aAAA;;iBA6Rc,gCAAA,CACd,KAAA,YACC,2BAAA;;iBA0Fa,+BAAA,CACd,KAAA,YACC,0BAAA"}
|
|
@@ -0,0 +1,215 @@
|
|
|
1
|
+
import { isSafeDashboardUrl } from "./dashboard-url.mjs";
|
|
2
|
+
|
|
3
|
+
//#region src/utils/inspector-learning.ts
|
|
4
|
+
const record = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
|
|
5
|
+
const string = (value, maximum) => typeof value === "string" && value.trim().length > 0 && value.length <= maximum;
|
|
6
|
+
const integer = (value, minimum = 0) => typeof value === "number" && Number.isSafeInteger(value) && value >= minimum;
|
|
7
|
+
const date = (value) => typeof value === "string" && !Number.isNaN(Date.parse(value));
|
|
8
|
+
/**
|
|
9
|
+
* Accepts only the configured Intelligence web-app origin.
|
|
10
|
+
*
|
|
11
|
+
* Learning links are server-authored actions. Treating every HTTPS origin as
|
|
12
|
+
* trusted would let a misconfigured or compromised upstream turn Inspector
|
|
13
|
+
* copy into a navigation primitive for an arbitrary site.
|
|
14
|
+
*/
|
|
15
|
+
function parseInspectorLearningUrl(value, trustedOrigin) {
|
|
16
|
+
if (typeof value !== "string" || value.length > 4e3 || typeof trustedOrigin !== "string" || trustedOrigin.length > 2e3) return;
|
|
17
|
+
try {
|
|
18
|
+
const parsed = new URL(value);
|
|
19
|
+
const configured = new URL(trustedOrigin);
|
|
20
|
+
if (parsed.username || parsed.password || configured.username || configured.password || configured.pathname !== "/" || configured.search || configured.hash || !isSafeDashboardUrl(configured) || parsed.origin !== configured.origin) return;
|
|
21
|
+
return parsed.toString();
|
|
22
|
+
} catch {
|
|
23
|
+
return;
|
|
24
|
+
}
|
|
25
|
+
}
|
|
26
|
+
/** Validates the canonical dashboard route after the origin check. */
|
|
27
|
+
function validLearningPath(value, kind) {
|
|
28
|
+
const url = new URL(value);
|
|
29
|
+
if (url.search || url.hash) return false;
|
|
30
|
+
if (kind === "learning") return url.pathname === "/learning" || /^\/o\/[^/]+\/[^/]+\/learning(?:\/[^/]+)?$/u.test(url.pathname);
|
|
31
|
+
return kind === "candidates" ? /^\/o\/[^/]+\/[^/]+\/learning\/[^/]+\/skills$/u.test(url.pathname) : /^\/o\/[^/]+\/[^/]+\/learning\/[^/]+\/analysis-results$/u.test(url.pathname);
|
|
32
|
+
}
|
|
33
|
+
function parseEvidence(value) {
|
|
34
|
+
if (record(value) && value.status === "unavailable") return Object.keys(value).length === 1 ? { status: "unavailable" } : void 0;
|
|
35
|
+
if (!record(value) || value.status !== "available" || !string(value.threadId, 128) || !date(value.updatedAt)) return;
|
|
36
|
+
if (value.threadName !== null && !(typeof value.threadName === "string" && value.threadName.length <= 4e3)) return;
|
|
37
|
+
if (!Array.isArray(value.messageIds) || value.messageIds.length > 200 || !value.messageIds.every((id) => string(id, 128))) return;
|
|
38
|
+
return {
|
|
39
|
+
status: "available",
|
|
40
|
+
threadId: value.threadId,
|
|
41
|
+
threadName: value.threadName,
|
|
42
|
+
messageIds: [...value.messageIds],
|
|
43
|
+
updatedAt: value.updatedAt
|
|
44
|
+
};
|
|
45
|
+
}
|
|
46
|
+
function parseTrajectoryEvidence(value, webAppOrigin) {
|
|
47
|
+
if (record(value) && value.status === "unavailable") return Object.keys(value).length === 1 ? { status: "unavailable" } : void 0;
|
|
48
|
+
if (!record(value) || value.status !== "available" || !string(value.trajectoryId, 128) || !integer(value.eventCount)) return;
|
|
49
|
+
const url = parseInspectorLearningUrl(value.url, webAppOrigin);
|
|
50
|
+
if (!url) return void 0;
|
|
51
|
+
return {
|
|
52
|
+
status: "available",
|
|
53
|
+
trajectoryId: value.trajectoryId,
|
|
54
|
+
eventCount: value.eventCount,
|
|
55
|
+
url
|
|
56
|
+
};
|
|
57
|
+
}
|
|
58
|
+
function parseInsight(value, webAppOrigin) {
|
|
59
|
+
if (!record(value) || !string(value.id, 128) || !string(value.statement, 4e3) || !string(value.impact, 4e3) || !integer(value.totalThreadCount) || typeof value.evidenceTruncated !== "boolean" || !Array.isArray(value.evidence) || value.evidence.length > 100) return;
|
|
60
|
+
const evidence = value.evidence.map(parseEvidence);
|
|
61
|
+
if (evidence.some((item) => item === void 0)) return void 0;
|
|
62
|
+
const insight = {
|
|
63
|
+
id: value.id,
|
|
64
|
+
statement: value.statement,
|
|
65
|
+
impact: value.impact,
|
|
66
|
+
totalThreadCount: value.totalThreadCount,
|
|
67
|
+
evidenceTruncated: value.evidenceTruncated,
|
|
68
|
+
evidence
|
|
69
|
+
};
|
|
70
|
+
let totalTrajectoryCount;
|
|
71
|
+
if (value.totalTrajectoryCount !== void 0) {
|
|
72
|
+
if (!integer(value.totalTrajectoryCount)) return void 0;
|
|
73
|
+
totalTrajectoryCount = value.totalTrajectoryCount;
|
|
74
|
+
}
|
|
75
|
+
let trajectoryEvidence;
|
|
76
|
+
if (value.trajectoryEvidence !== void 0) {
|
|
77
|
+
if (!Array.isArray(value.trajectoryEvidence) || value.trajectoryEvidence.length > 100) return;
|
|
78
|
+
const parsed = value.trajectoryEvidence.map((item) => parseTrajectoryEvidence(item, webAppOrigin));
|
|
79
|
+
if (parsed.some((item) => item === void 0)) return void 0;
|
|
80
|
+
trajectoryEvidence = parsed;
|
|
81
|
+
}
|
|
82
|
+
return {
|
|
83
|
+
...insight,
|
|
84
|
+
...totalTrajectoryCount === void 0 ? {} : { totalTrajectoryCount },
|
|
85
|
+
...trajectoryEvidence === void 0 ? {} : { trajectoryEvidence }
|
|
86
|
+
};
|
|
87
|
+
}
|
|
88
|
+
function parseSkill(value, webAppOrigin) {
|
|
89
|
+
if (!record(value) || !string(value.id, 128) || !string(value.name, 128) || !string(value.description, 4e3) || !integer(value.revision, 1) || typeof value.skillMd !== "string" || value.skillMd.length > 131072) return;
|
|
90
|
+
const sourceInsight = value.sourceInsight === null ? null : parseInsight(value.sourceInsight, webAppOrigin);
|
|
91
|
+
if (sourceInsight === void 0) return void 0;
|
|
92
|
+
return {
|
|
93
|
+
id: value.id,
|
|
94
|
+
name: value.name,
|
|
95
|
+
description: value.description,
|
|
96
|
+
revision: value.revision,
|
|
97
|
+
skillMd: value.skillMd,
|
|
98
|
+
sourceInsight
|
|
99
|
+
};
|
|
100
|
+
}
|
|
101
|
+
function parsePage(value, pageSize, parseItem) {
|
|
102
|
+
if (!record(value) || !integer(value.page, 1) || value.pageSize !== pageSize || !integer(value.total) || !integer(value.totalPages) || !Array.isArray(value.items) || value.items.length > pageSize) return;
|
|
103
|
+
const items = value.items.map(parseItem);
|
|
104
|
+
if (items.some((item) => item === void 0)) return void 0;
|
|
105
|
+
if (value.total === 0) {
|
|
106
|
+
if (value.page !== 1 || value.totalPages !== 0 || items.length !== 0) return;
|
|
107
|
+
} else {
|
|
108
|
+
const totalPages = Math.ceil(value.total / pageSize);
|
|
109
|
+
const expectedItems = Math.min(pageSize, value.total - (value.page - 1) * pageSize);
|
|
110
|
+
if (value.totalPages !== totalPages || value.page > totalPages || items.length !== expectedItems) return;
|
|
111
|
+
}
|
|
112
|
+
return {
|
|
113
|
+
page: value.page,
|
|
114
|
+
pageSize,
|
|
115
|
+
total: value.total,
|
|
116
|
+
totalPages: value.totalPages,
|
|
117
|
+
items
|
|
118
|
+
};
|
|
119
|
+
}
|
|
120
|
+
function parseConfiguration(value) {
|
|
121
|
+
if (!record(value)) return void 0;
|
|
122
|
+
if (value.state === "not_configured" || value.state === "selection_required") return { state: value.state };
|
|
123
|
+
if (value.state === "invalid" && (value.reason === "container" || value.reason === "instrumentation")) return {
|
|
124
|
+
state: value.state,
|
|
125
|
+
reason: value.reason
|
|
126
|
+
};
|
|
127
|
+
if (value.state === "configured" && record(value.container) && string(value.container.id, 128) && string(value.container.name, 128)) return {
|
|
128
|
+
state: "configured",
|
|
129
|
+
container: {
|
|
130
|
+
id: value.container.id,
|
|
131
|
+
name: value.container.name
|
|
132
|
+
}
|
|
133
|
+
};
|
|
134
|
+
}
|
|
135
|
+
const runStatuses = new Set([
|
|
136
|
+
"queued",
|
|
137
|
+
"freezing",
|
|
138
|
+
"batching",
|
|
139
|
+
"reducing",
|
|
140
|
+
"finalizing",
|
|
141
|
+
"succeeded",
|
|
142
|
+
"failed"
|
|
143
|
+
]);
|
|
144
|
+
/** Validates and copies an untrusted Learning snapshot at each process boundary. */
|
|
145
|
+
function parseInspectorLearningSnapshotV1(value) {
|
|
146
|
+
if (!record(value) || value.schemaVersion !== 1 || !string(value.projectKey, 128) || !string(value.snapshotVersion, 128) || !integer(value.pendingThreadCount) || !integer(value.pendingCandidateCount) || !record(value.run) || typeof value.run.hasActiveRun !== "boolean" || typeof value.run.hasEverSucceeded !== "boolean") return;
|
|
147
|
+
const originUrl = parseInspectorLearningUrl(value.webAppOrigin, value.webAppOrigin);
|
|
148
|
+
if (!originUrl || new URL(originUrl).pathname !== "/") return void 0;
|
|
149
|
+
const webAppOrigin = new URL(originUrl).origin;
|
|
150
|
+
const configuration = parseConfiguration(value.configuration);
|
|
151
|
+
const skillsPage = parsePage(value.skillsPage, 3, (item) => parseSkill(item, webAppOrigin));
|
|
152
|
+
const insightsPage = parsePage(value.insightsPage, 4, (item) => parseInsight(item, webAppOrigin));
|
|
153
|
+
if (!configuration || !skillsPage || !insightsPage) return void 0;
|
|
154
|
+
let latest = null;
|
|
155
|
+
if (value.run.latest !== null) {
|
|
156
|
+
const latestRun = value.run.latest;
|
|
157
|
+
if (!record(latestRun)) return;
|
|
158
|
+
const { status, completedAt } = latestRun;
|
|
159
|
+
if (typeof status !== "string" || !runStatuses.has(status) || completedAt !== null && !date(completedAt)) return void 0;
|
|
160
|
+
latest = {
|
|
161
|
+
status,
|
|
162
|
+
completedAt
|
|
163
|
+
};
|
|
164
|
+
}
|
|
165
|
+
if (!record(value.links)) return void 0;
|
|
166
|
+
const learning = parseInspectorLearningUrl(value.links.learning, webAppOrigin);
|
|
167
|
+
const candidates = value.links.candidates === null ? null : parseInspectorLearningUrl(value.links.candidates, webAppOrigin);
|
|
168
|
+
const runs = value.links.runs === null ? null : parseInspectorLearningUrl(value.links.runs, webAppOrigin);
|
|
169
|
+
if (!learning || candidates === void 0 || runs === void 0 || !validLearningPath(learning, "learning") || candidates !== null && !validLearningPath(candidates, "candidates") || runs !== null && !validLearningPath(runs, "runs") || value.pendingThreadCount > 0 && runs === null || value.pendingCandidateCount > 0 && candidates === null) return void 0;
|
|
170
|
+
return {
|
|
171
|
+
schemaVersion: 1,
|
|
172
|
+
projectKey: value.projectKey,
|
|
173
|
+
snapshotVersion: value.snapshotVersion,
|
|
174
|
+
webAppOrigin,
|
|
175
|
+
configuration,
|
|
176
|
+
pendingThreadCount: value.pendingThreadCount,
|
|
177
|
+
run: {
|
|
178
|
+
hasActiveRun: value.run.hasActiveRun,
|
|
179
|
+
hasEverSucceeded: value.run.hasEverSucceeded,
|
|
180
|
+
latest
|
|
181
|
+
},
|
|
182
|
+
pendingCandidateCount: value.pendingCandidateCount,
|
|
183
|
+
skillsPage,
|
|
184
|
+
insightsPage,
|
|
185
|
+
links: {
|
|
186
|
+
learning,
|
|
187
|
+
candidates,
|
|
188
|
+
runs
|
|
189
|
+
}
|
|
190
|
+
};
|
|
191
|
+
}
|
|
192
|
+
/** Normalizes the browser-owned request without accepting container scope. */
|
|
193
|
+
function parseInspectorLearningRequestV1(value) {
|
|
194
|
+
if (!record(value)) return void 0;
|
|
195
|
+
if (Object.keys(value).some((key) => ![
|
|
196
|
+
"agentId",
|
|
197
|
+
"skillsPage",
|
|
198
|
+
"insightsPage"
|
|
199
|
+
].includes(key))) return;
|
|
200
|
+
const agentId = value.agentId;
|
|
201
|
+
const skillsPage = value.skillsPage;
|
|
202
|
+
const insightsPage = value.insightsPage;
|
|
203
|
+
if (agentId !== void 0 && !string(agentId, 128)) return void 0;
|
|
204
|
+
if (skillsPage !== void 0 && !integer(skillsPage, 1)) return void 0;
|
|
205
|
+
if (insightsPage !== void 0 && !integer(insightsPage, 1)) return void 0;
|
|
206
|
+
return {
|
|
207
|
+
...agentId === void 0 ? {} : { agentId },
|
|
208
|
+
...skillsPage === void 0 ? {} : { skillsPage },
|
|
209
|
+
...insightsPage === void 0 ? {} : { insightsPage }
|
|
210
|
+
};
|
|
211
|
+
}
|
|
212
|
+
|
|
213
|
+
//#endregion
|
|
214
|
+
export { parseInspectorLearningRequestV1, parseInspectorLearningSnapshotV1, parseInspectorLearningUrl };
|
|
215
|
+
//# sourceMappingURL=inspector-learning.mjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"inspector-learning.mjs","names":[],"sources":["../../src/utils/inspector-learning.ts"],"sourcesContent":["import { isSafeDashboardUrl } from \"./dashboard-url\";\n\n/** A bounded page in the Inspector Learning snapshot. */\nexport interface InspectorLearningPage<T> {\n readonly page: number;\n readonly pageSize: number;\n readonly total: number;\n readonly totalPages: number;\n readonly items: readonly T[];\n}\n\nexport type InspectorLearningEvidence =\n | {\n readonly status: \"available\";\n readonly threadId: string;\n readonly threadName: string | null;\n readonly messageIds: readonly string[];\n readonly updatedAt: string;\n }\n | { readonly status: \"unavailable\" };\n\n/** A cited Trajectory, linked into the Intelligence web app. */\nexport type InspectorLearningTrajectoryEvidence =\n | {\n readonly status: \"available\";\n readonly trajectoryId: string;\n readonly eventCount: number;\n readonly url: string;\n }\n | { readonly status: \"unavailable\" };\n\nexport interface InspectorLearningInsight {\n readonly id: string;\n readonly statement: string;\n readonly impact: string;\n readonly totalThreadCount: number;\n readonly evidenceTruncated: boolean;\n readonly evidence: readonly InspectorLearningEvidence[];\n /** Absent when Intelligence predates Trajectory evidence. */\n readonly totalTrajectoryCount?: number;\n /** Absent when Intelligence predates Trajectory evidence. */\n readonly trajectoryEvidence?: readonly InspectorLearningTrajectoryEvidence[];\n}\n\nexport interface InspectorLearningSkill {\n readonly id: string;\n readonly name: string;\n readonly description: string;\n readonly revision: number;\n readonly skillMd: string;\n readonly sourceInsight: InspectorLearningInsight | null;\n}\n\nexport interface InspectorLearningSnapshotV1 {\n readonly schemaVersion: 1;\n readonly projectKey: string;\n readonly snapshotVersion: string;\n readonly webAppOrigin: string;\n readonly configuration:\n | { readonly state: \"not_configured\" }\n | {\n readonly state: \"invalid\";\n readonly reason: \"container\" | \"instrumentation\";\n }\n | {\n readonly state: \"configured\";\n readonly container: { readonly id: string; readonly name: string };\n }\n | { readonly state: \"selection_required\" };\n readonly pendingThreadCount: number;\n readonly run: {\n readonly hasActiveRun: boolean;\n readonly hasEverSucceeded: boolean;\n readonly latest: {\n readonly completedAt: string | null;\n readonly status:\n | \"queued\"\n | \"freezing\"\n | \"batching\"\n | \"reducing\"\n | \"finalizing\"\n | \"succeeded\"\n | \"failed\";\n } | null;\n };\n readonly pendingCandidateCount: number;\n readonly skillsPage: InspectorLearningPage<InspectorLearningSkill>;\n readonly insightsPage: InspectorLearningPage<InspectorLearningInsight>;\n readonly links: {\n readonly learning: string;\n readonly candidates: string | null;\n readonly runs: string | null;\n };\n}\n\nexport interface InspectorLearningRequestV1 {\n readonly agentId?: string;\n readonly skillsPage?: number;\n readonly insightsPage?: number;\n}\n\ntype RecordValue = Record<string, unknown>;\n\nconst record = (value: unknown): value is RecordValue =>\n typeof value === \"object\" && value !== null && !Array.isArray(value);\nconst string = (value: unknown, maximum: number): value is string =>\n typeof value === \"string\" &&\n value.trim().length > 0 &&\n value.length <= maximum;\nconst integer = (value: unknown, minimum = 0): value is number =>\n typeof value === \"number\" && Number.isSafeInteger(value) && value >= minimum;\nconst date = (value: unknown): value is string =>\n typeof value === \"string\" && !Number.isNaN(Date.parse(value));\n\n/**\n * Accepts only the configured Intelligence web-app origin.\n *\n * Learning links are server-authored actions. Treating every HTTPS origin as\n * trusted would let a misconfigured or compromised upstream turn Inspector\n * copy into a navigation primitive for an arbitrary site.\n */\nexport function parseInspectorLearningUrl(\n value: unknown,\n trustedOrigin: unknown,\n): string | undefined {\n if (\n typeof value !== \"string\" ||\n value.length > 4_000 ||\n typeof trustedOrigin !== \"string\" ||\n trustedOrigin.length > 2_000\n ) {\n return undefined;\n }\n try {\n const parsed = new URL(value);\n const configured = new URL(trustedOrigin);\n if (\n parsed.username ||\n parsed.password ||\n configured.username ||\n configured.password ||\n configured.pathname !== \"/\" ||\n configured.search ||\n configured.hash ||\n !isSafeDashboardUrl(configured) ||\n parsed.origin !== configured.origin\n ) {\n return undefined;\n }\n return parsed.toString();\n } catch {\n return undefined;\n }\n}\n\n/** Validates the canonical dashboard route after the origin check. */\nfunction validLearningPath(\n value: string,\n kind: \"learning\" | \"candidates\" | \"runs\",\n): boolean {\n const url = new URL(value);\n if (url.search || url.hash) return false;\n if (kind === \"learning\") {\n return (\n url.pathname === \"/learning\" ||\n /^\\/o\\/[^/]+\\/[^/]+\\/learning(?:\\/[^/]+)?$/u.test(url.pathname)\n );\n }\n return kind === \"candidates\"\n ? /^\\/o\\/[^/]+\\/[^/]+\\/learning\\/[^/]+\\/skills$/u.test(url.pathname)\n : /^\\/o\\/[^/]+\\/[^/]+\\/learning\\/[^/]+\\/analysis-results$/u.test(\n url.pathname,\n );\n}\n\nfunction parseEvidence(value: unknown): InspectorLearningEvidence | undefined {\n if (record(value) && value.status === \"unavailable\") {\n return Object.keys(value).length === 1\n ? { status: \"unavailable\" }\n : undefined;\n }\n if (\n !record(value) ||\n value.status !== \"available\" ||\n !string(value.threadId, 128) ||\n !date(value.updatedAt)\n ) {\n return undefined;\n }\n if (\n value.threadName !== null &&\n !(typeof value.threadName === \"string\" && value.threadName.length <= 4_000)\n ) {\n return undefined;\n }\n if (\n !Array.isArray(value.messageIds) ||\n value.messageIds.length > 200 ||\n !value.messageIds.every((id) => string(id, 128))\n ) {\n return undefined;\n }\n return {\n status: \"available\",\n threadId: value.threadId,\n threadName: value.threadName,\n messageIds: [...value.messageIds],\n updatedAt: value.updatedAt,\n };\n}\n\nfunction parseTrajectoryEvidence(\n value: unknown,\n webAppOrigin: string,\n): InspectorLearningTrajectoryEvidence | undefined {\n if (record(value) && value.status === \"unavailable\") {\n return Object.keys(value).length === 1\n ? { status: \"unavailable\" }\n : undefined;\n }\n if (\n !record(value) ||\n value.status !== \"available\" ||\n !string(value.trajectoryId, 128) ||\n !integer(value.eventCount)\n ) {\n return undefined;\n }\n const url = parseInspectorLearningUrl(value.url, webAppOrigin);\n if (!url) return undefined;\n return {\n status: \"available\",\n trajectoryId: value.trajectoryId,\n eventCount: value.eventCount,\n url,\n };\n}\n\nfunction parseInsight(\n value: unknown,\n webAppOrigin: string,\n): InspectorLearningInsight | undefined {\n if (\n !record(value) ||\n !string(value.id, 128) ||\n !string(value.statement, 4_000) ||\n !string(value.impact, 4_000) ||\n !integer(value.totalThreadCount) ||\n typeof value.evidenceTruncated !== \"boolean\" ||\n !Array.isArray(value.evidence) ||\n value.evidence.length > 100\n ) {\n return undefined;\n }\n const evidence = value.evidence.map(parseEvidence);\n if (evidence.some((item) => item === undefined)) return undefined;\n const insight: InspectorLearningInsight = {\n id: value.id,\n statement: value.statement,\n impact: value.impact,\n totalThreadCount: value.totalThreadCount,\n evidenceTruncated: value.evidenceTruncated,\n evidence: evidence as InspectorLearningEvidence[],\n };\n // Each Trajectory field is optional on its own; a malformed one rejects\n // the Insight, an absent one leaves the Thread-only shape untouched.\n let totalTrajectoryCount: number | undefined;\n if (value.totalTrajectoryCount !== undefined) {\n if (!integer(value.totalTrajectoryCount)) return undefined;\n totalTrajectoryCount = value.totalTrajectoryCount;\n }\n let trajectoryEvidence: InspectorLearningTrajectoryEvidence[] | undefined;\n if (value.trajectoryEvidence !== undefined) {\n if (\n !Array.isArray(value.trajectoryEvidence) ||\n value.trajectoryEvidence.length > 100\n ) {\n return undefined;\n }\n const parsed = value.trajectoryEvidence.map((item) =>\n parseTrajectoryEvidence(item, webAppOrigin),\n );\n if (parsed.some((item) => item === undefined)) return undefined;\n trajectoryEvidence = parsed as InspectorLearningTrajectoryEvidence[];\n }\n return {\n ...insight,\n ...(totalTrajectoryCount === undefined ? {} : { totalTrajectoryCount }),\n ...(trajectoryEvidence === undefined ? {} : { trajectoryEvidence }),\n };\n}\n\nfunction parseSkill(\n value: unknown,\n webAppOrigin: string,\n): InspectorLearningSkill | undefined {\n if (\n !record(value) ||\n !string(value.id, 128) ||\n !string(value.name, 128) ||\n !string(value.description, 4_000) ||\n !integer(value.revision, 1) ||\n typeof value.skillMd !== \"string\" ||\n value.skillMd.length > 131_072\n ) {\n return undefined;\n }\n const sourceInsight =\n value.sourceInsight === null\n ? null\n : parseInsight(value.sourceInsight, webAppOrigin);\n if (sourceInsight === undefined) return undefined;\n return {\n id: value.id,\n name: value.name,\n description: value.description,\n revision: value.revision,\n skillMd: value.skillMd,\n sourceInsight,\n };\n}\n\nfunction parsePage<T>(\n value: unknown,\n pageSize: 3 | 4,\n parseItem: (item: unknown) => T | undefined,\n): InspectorLearningPage<T> | undefined {\n if (\n !record(value) ||\n !integer(value.page, 1) ||\n value.pageSize !== pageSize ||\n !integer(value.total) ||\n !integer(value.totalPages) ||\n !Array.isArray(value.items) ||\n value.items.length > pageSize\n ) {\n return undefined;\n }\n const items = value.items.map(parseItem);\n if (items.some((item) => item === undefined)) return undefined;\n if (value.total === 0) {\n if (value.page !== 1 || value.totalPages !== 0 || items.length !== 0) {\n return undefined;\n }\n } else {\n const totalPages = Math.ceil(value.total / pageSize);\n const expectedItems = Math.min(\n pageSize,\n value.total - (value.page - 1) * pageSize,\n );\n if (\n value.totalPages !== totalPages ||\n value.page > totalPages ||\n items.length !== expectedItems\n ) {\n return undefined;\n }\n }\n return {\n page: value.page,\n pageSize,\n total: value.total,\n totalPages: value.totalPages,\n items: items as T[],\n };\n}\n\nfunction parseConfiguration(\n value: unknown,\n): InspectorLearningSnapshotV1[\"configuration\"] | undefined {\n if (!record(value)) return undefined;\n if (\n value.state === \"not_configured\" ||\n value.state === \"selection_required\"\n ) {\n return { state: value.state };\n }\n if (\n value.state === \"invalid\" &&\n (value.reason === \"container\" || value.reason === \"instrumentation\")\n ) {\n return { state: value.state, reason: value.reason };\n }\n if (\n value.state === \"configured\" &&\n record(value.container) &&\n string(value.container.id, 128) &&\n string(value.container.name, 128)\n ) {\n return {\n state: \"configured\",\n container: { id: value.container.id, name: value.container.name },\n };\n }\n return undefined;\n}\n\nconst runStatuses = new Set([\n \"queued\",\n \"freezing\",\n \"batching\",\n \"reducing\",\n \"finalizing\",\n \"succeeded\",\n \"failed\",\n]);\n\n/** Validates and copies an untrusted Learning snapshot at each process boundary. */\nexport function parseInspectorLearningSnapshotV1(\n value: unknown,\n): InspectorLearningSnapshotV1 | undefined {\n if (\n !record(value) ||\n value.schemaVersion !== 1 ||\n !string(value.projectKey, 128) ||\n !string(value.snapshotVersion, 128) ||\n !integer(value.pendingThreadCount) ||\n !integer(value.pendingCandidateCount) ||\n !record(value.run) ||\n typeof value.run.hasActiveRun !== \"boolean\" ||\n typeof value.run.hasEverSucceeded !== \"boolean\"\n ) {\n return undefined;\n }\n const originUrl = parseInspectorLearningUrl(\n value.webAppOrigin,\n value.webAppOrigin,\n );\n if (!originUrl || new URL(originUrl).pathname !== \"/\") return undefined;\n const webAppOrigin = new URL(originUrl).origin;\n const configuration = parseConfiguration(value.configuration);\n const skillsPage = parsePage(value.skillsPage, 3, (item) =>\n parseSkill(item, webAppOrigin),\n );\n const insightsPage = parsePage(value.insightsPage, 4, (item) =>\n parseInsight(item, webAppOrigin),\n );\n if (!configuration || !skillsPage || !insightsPage) return undefined;\n let latest: InspectorLearningSnapshotV1[\"run\"][\"latest\"] = null;\n if (value.run.latest !== null) {\n const latestRun = value.run.latest;\n if (!record(latestRun)) {\n return undefined;\n }\n const { status, completedAt } = latestRun;\n if (\n typeof status !== \"string\" ||\n !runStatuses.has(status) ||\n (completedAt !== null && !date(completedAt))\n )\n return undefined;\n latest = {\n status: status as NonNullable<typeof latest>[\"status\"],\n completedAt: completedAt as NonNullable<typeof latest>[\"completedAt\"],\n };\n }\n if (!record(value.links)) return undefined;\n const learning = parseInspectorLearningUrl(\n value.links.learning,\n webAppOrigin,\n );\n const candidates =\n value.links.candidates === null\n ? null\n : parseInspectorLearningUrl(value.links.candidates, webAppOrigin);\n const runs =\n value.links.runs === null\n ? null\n : parseInspectorLearningUrl(value.links.runs, webAppOrigin);\n if (\n !learning ||\n candidates === undefined ||\n runs === undefined ||\n !validLearningPath(learning, \"learning\") ||\n (candidates !== null && !validLearningPath(candidates, \"candidates\")) ||\n (runs !== null && !validLearningPath(runs, \"runs\")) ||\n (value.pendingThreadCount > 0 && runs === null) ||\n (value.pendingCandidateCount > 0 && candidates === null)\n )\n return undefined;\n return {\n schemaVersion: 1,\n projectKey: value.projectKey,\n snapshotVersion: value.snapshotVersion,\n webAppOrigin,\n configuration,\n pendingThreadCount: value.pendingThreadCount,\n run: {\n hasActiveRun: value.run.hasActiveRun,\n hasEverSucceeded: value.run.hasEverSucceeded,\n latest,\n },\n pendingCandidateCount: value.pendingCandidateCount,\n skillsPage,\n insightsPage,\n links: { learning, candidates, runs },\n };\n}\n\n/** Normalizes the browser-owned request without accepting container scope. */\nexport function parseInspectorLearningRequestV1(\n value: unknown,\n): InspectorLearningRequestV1 | undefined {\n if (!record(value)) return undefined;\n if (\n Object.keys(value).some(\n (key) => ![\"agentId\", \"skillsPage\", \"insightsPage\"].includes(key),\n )\n ) {\n return undefined;\n }\n const agentId = value.agentId;\n const skillsPage = value.skillsPage;\n const insightsPage = value.insightsPage;\n if (agentId !== undefined && !string(agentId, 128)) return undefined;\n if (skillsPage !== undefined && !integer(skillsPage, 1)) return undefined;\n if (insightsPage !== undefined && !integer(insightsPage, 1)) return undefined;\n return {\n ...(agentId === undefined ? {} : { agentId }),\n ...(skillsPage === undefined ? {} : { skillsPage }),\n ...(insightsPage === undefined ? {} : { insightsPage }),\n };\n}\n"],"mappings":"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"}
|
|
@@ -0,0 +1,146 @@
|
|
|
1
|
+
const require_dashboard_url = require('./dashboard-url.cjs');
|
|
2
|
+
|
|
3
|
+
//#region src/utils/inspector-metadata.ts
|
|
4
|
+
function isRecord(value) {
|
|
5
|
+
if (typeof value !== "object" || value === null || Array.isArray(value)) return false;
|
|
6
|
+
try {
|
|
7
|
+
const prototype = Object.getPrototypeOf(value);
|
|
8
|
+
return prototype === Object.prototype || prototype === null;
|
|
9
|
+
} catch {
|
|
10
|
+
return false;
|
|
11
|
+
}
|
|
12
|
+
}
|
|
13
|
+
function readOwnDataProperty(value, key) {
|
|
14
|
+
try {
|
|
15
|
+
const descriptor = Object.getOwnPropertyDescriptor(value, key);
|
|
16
|
+
return descriptor !== void 0 && "value" in descriptor ? descriptor.value : void 0;
|
|
17
|
+
} catch {
|
|
18
|
+
return;
|
|
19
|
+
}
|
|
20
|
+
}
|
|
21
|
+
function parseNonBlankString(value) {
|
|
22
|
+
if (typeof value !== "string") return;
|
|
23
|
+
const parsed = value.trim();
|
|
24
|
+
return parsed.length > 0 ? parsed : void 0;
|
|
25
|
+
}
|
|
26
|
+
function parseIdentity(value) {
|
|
27
|
+
if (!isRecord(value)) return;
|
|
28
|
+
const organizationName = parseNonBlankString(value.organizationName);
|
|
29
|
+
const projectName = parseNonBlankString(value.projectName);
|
|
30
|
+
if (organizationName === void 0 || projectName === void 0) return;
|
|
31
|
+
return {
|
|
32
|
+
organizationName,
|
|
33
|
+
projectName
|
|
34
|
+
};
|
|
35
|
+
}
|
|
36
|
+
function parsePlan(value) {
|
|
37
|
+
if (!isRecord(value)) return;
|
|
38
|
+
const code = parseNonBlankString(value.code);
|
|
39
|
+
const label = parseNonBlankString(value.label);
|
|
40
|
+
if (code === void 0 || label === void 0) return;
|
|
41
|
+
return {
|
|
42
|
+
code,
|
|
43
|
+
label
|
|
44
|
+
};
|
|
45
|
+
}
|
|
46
|
+
function parseLicense(value) {
|
|
47
|
+
if (!isRecord(value)) return;
|
|
48
|
+
switch (value.state) {
|
|
49
|
+
case "valid":
|
|
50
|
+
case "none":
|
|
51
|
+
case "expired":
|
|
52
|
+
case "unknown": return { state: value.state };
|
|
53
|
+
default: return;
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
function parseActionKind(value) {
|
|
57
|
+
switch (value) {
|
|
58
|
+
case "manage_plan":
|
|
59
|
+
case "renew":
|
|
60
|
+
case "enable_intelligence": return value;
|
|
61
|
+
default: return;
|
|
62
|
+
}
|
|
63
|
+
}
|
|
64
|
+
function parseSafeActionUrl(value) {
|
|
65
|
+
const url = parseNonBlankString(value);
|
|
66
|
+
if (url === void 0 || url.includes("?") || url.includes("#")) return;
|
|
67
|
+
const authorityStart = url.indexOf("://");
|
|
68
|
+
if (authorityStart < 1) return;
|
|
69
|
+
const authorityAndPath = url.slice(authorityStart + 3);
|
|
70
|
+
const pathStart = authorityAndPath.indexOf("/");
|
|
71
|
+
if ((pathStart === -1 ? authorityAndPath : authorityAndPath.slice(0, pathStart)).includes("@")) return;
|
|
72
|
+
let parsed;
|
|
73
|
+
try {
|
|
74
|
+
parsed = new URL(url);
|
|
75
|
+
} catch {
|
|
76
|
+
return;
|
|
77
|
+
}
|
|
78
|
+
if (parsed.hostname.length === 0 || parsed.username || parsed.password) return;
|
|
79
|
+
return require_dashboard_url.isSafeDashboardUrl(parsed) ? url : void 0;
|
|
80
|
+
}
|
|
81
|
+
function parseAction(value) {
|
|
82
|
+
if (!isRecord(value)) return;
|
|
83
|
+
const kind = parseActionKind(value.kind);
|
|
84
|
+
const url = parseSafeActionUrl(value.url);
|
|
85
|
+
if (kind === void 0 || url === void 0) return;
|
|
86
|
+
return {
|
|
87
|
+
kind,
|
|
88
|
+
url
|
|
89
|
+
};
|
|
90
|
+
}
|
|
91
|
+
function isFiniteNonnegativeInteger(value) {
|
|
92
|
+
return typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
|
|
93
|
+
}
|
|
94
|
+
function parseUsageLimit(value) {
|
|
95
|
+
if (!isRecord(value)) return;
|
|
96
|
+
if (value.kind === "finite") {
|
|
97
|
+
if (typeof value.value !== "number" || !Number.isSafeInteger(value.value) || value.value < 1) return;
|
|
98
|
+
return {
|
|
99
|
+
kind: "finite",
|
|
100
|
+
value: value.value
|
|
101
|
+
};
|
|
102
|
+
}
|
|
103
|
+
if (value.kind === "unlimited") return { kind: "unlimited" };
|
|
104
|
+
if (value.kind === "unknown") return { kind: "unknown" };
|
|
105
|
+
}
|
|
106
|
+
function parseUsage(value) {
|
|
107
|
+
if (!isRecord(value)) return;
|
|
108
|
+
const limit = parseUsageLimit(value.limit);
|
|
109
|
+
const used = value.used;
|
|
110
|
+
if (!isFiniteNonnegativeInteger(used) || limit === void 0) return;
|
|
111
|
+
const rawExpiringSoonCount = readOwnDataProperty(value, "expiringSoonCount");
|
|
112
|
+
const expiringSoonCount = isFiniteNonnegativeInteger(rawExpiringSoonCount) ? rawExpiringSoonCount : void 0;
|
|
113
|
+
return {
|
|
114
|
+
used,
|
|
115
|
+
limit,
|
|
116
|
+
...expiringSoonCount === void 0 ? {} : { expiringSoonCount }
|
|
117
|
+
};
|
|
118
|
+
}
|
|
119
|
+
/**
|
|
120
|
+
* Parses untrusted inspector metadata without letting one invalid optional
|
|
121
|
+
* module hide the other valid modules.
|
|
122
|
+
*
|
|
123
|
+
* @param value - The decoded runtime response body.
|
|
124
|
+
* @returns Normalized version 1 metadata, or `undefined` for an unsupported
|
|
125
|
+
* top-level payload.
|
|
126
|
+
*/
|
|
127
|
+
function parseInspectorMetadataV1(value) {
|
|
128
|
+
if (!isRecord(value) || value.schemaVersion !== 1) return;
|
|
129
|
+
const identity = parseIdentity(value.identity);
|
|
130
|
+
const plan = parsePlan(value.plan);
|
|
131
|
+
const license = parseLicense(value.license);
|
|
132
|
+
const action = parseAction(value.action);
|
|
133
|
+
const usage = parseUsage(value.usage);
|
|
134
|
+
return {
|
|
135
|
+
schemaVersion: 1,
|
|
136
|
+
...identity === void 0 ? {} : { identity },
|
|
137
|
+
...plan === void 0 ? {} : { plan },
|
|
138
|
+
...license === void 0 ? {} : { license },
|
|
139
|
+
...action === void 0 ? {} : { action },
|
|
140
|
+
...usage === void 0 ? {} : { usage }
|
|
141
|
+
};
|
|
142
|
+
}
|
|
143
|
+
|
|
144
|
+
//#endregion
|
|
145
|
+
exports.parseInspectorMetadataV1 = parseInspectorMetadataV1;
|
|
146
|
+
//# sourceMappingURL=inspector-metadata.cjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"inspector-metadata.cjs","names":["isSafeDashboardUrl"],"sources":["../../src/utils/inspector-metadata.ts"],"sourcesContent":["import { isSafeDashboardUrl } from \"./dashboard-url\";\n\n/**\n * Inspector metadata supplied by a trusted CopilotKit runtime.\n *\n * Each optional module is independent so clients can render partial metadata\n * from runtimes that do not expose every module.\n */\nexport interface InspectorMetadataV1 {\n readonly schemaVersion: 1;\n readonly identity?: {\n readonly organizationName: string;\n readonly projectName: string;\n };\n readonly plan?: {\n readonly code: string;\n readonly label: string;\n };\n readonly license?: {\n readonly state: \"valid\" | \"none\" | \"expired\" | \"unknown\";\n };\n readonly action?:\n | { readonly kind: \"manage_plan\"; readonly url: string }\n | { readonly kind: \"renew\"; readonly url: string }\n | { readonly kind: \"enable_intelligence\"; readonly url: string };\n readonly usage?: {\n readonly used: number;\n readonly limit:\n | { readonly kind: \"finite\"; readonly value: number }\n | { readonly kind: \"unlimited\" }\n | { readonly kind: \"unknown\" };\n readonly expiringSoonCount?: number;\n };\n}\n\ntype UnknownRecord = Record<string, unknown>;\ntype InspectorIdentity = NonNullable<InspectorMetadataV1[\"identity\"]>;\ntype InspectorPlan = NonNullable<InspectorMetadataV1[\"plan\"]>;\ntype InspectorLicense = NonNullable<InspectorMetadataV1[\"license\"]>;\ntype InspectorAction = NonNullable<InspectorMetadataV1[\"action\"]>;\ntype InspectorUsage = NonNullable<InspectorMetadataV1[\"usage\"]>;\ntype InspectorUsageLimit = InspectorUsage[\"limit\"];\n\nfunction isRecord(value: unknown): value is UnknownRecord {\n if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n return false;\n }\n\n try {\n const prototype = Object.getPrototypeOf(value);\n return prototype === Object.prototype || prototype === null;\n } catch {\n return false;\n }\n}\n\nfunction readOwnDataProperty(value: UnknownRecord, key: string): unknown {\n try {\n const descriptor = Object.getOwnPropertyDescriptor(value, key);\n return descriptor !== undefined && \"value\" in descriptor\n ? descriptor.value\n : undefined;\n } catch {\n return undefined;\n }\n}\n\nfunction parseNonBlankString(value: unknown): string | undefined {\n if (typeof value !== \"string\") {\n return undefined;\n }\n\n const parsed = value.trim();\n return parsed.length > 0 ? parsed : undefined;\n}\n\nfunction parseIdentity(value: unknown): InspectorIdentity | undefined {\n if (!isRecord(value)) {\n return undefined;\n }\n\n const organizationName = parseNonBlankString(value.organizationName);\n const projectName = parseNonBlankString(value.projectName);\n if (organizationName === undefined || projectName === undefined) {\n return undefined;\n }\n\n return { organizationName, projectName };\n}\n\nfunction parsePlan(value: unknown): InspectorPlan | undefined {\n if (!isRecord(value)) {\n return undefined;\n }\n\n const code = parseNonBlankString(value.code);\n const label = parseNonBlankString(value.label);\n if (code === undefined || label === undefined) {\n return undefined;\n }\n\n return { code, label };\n}\n\nfunction parseLicense(value: unknown): InspectorLicense | undefined {\n if (!isRecord(value)) {\n return undefined;\n }\n\n switch (value.state) {\n case \"valid\":\n case \"none\":\n case \"expired\":\n case \"unknown\":\n return { state: value.state };\n default:\n return undefined;\n }\n}\n\nfunction parseActionKind(value: unknown): InspectorAction[\"kind\"] | undefined {\n switch (value) {\n case \"manage_plan\":\n case \"renew\":\n case \"enable_intelligence\":\n return value;\n default:\n return undefined;\n }\n}\n\nfunction parseSafeActionUrl(value: unknown): string | undefined {\n const url = parseNonBlankString(value);\n if (url === undefined || url.includes(\"?\") || url.includes(\"#\")) {\n return undefined;\n }\n\n const authorityStart = url.indexOf(\"://\");\n if (authorityStart < 1) {\n return undefined;\n }\n\n const authorityAndPath = url.slice(authorityStart + 3);\n const pathStart = authorityAndPath.indexOf(\"/\");\n const authority =\n pathStart === -1 ? authorityAndPath : authorityAndPath.slice(0, pathStart);\n if (authority.includes(\"@\")) {\n return undefined;\n }\n\n let parsed: URL;\n try {\n parsed = new URL(url);\n } catch {\n return undefined;\n }\n\n if (parsed.hostname.length === 0 || parsed.username || parsed.password) {\n return undefined;\n }\n\n return isSafeDashboardUrl(parsed) ? url : undefined;\n}\n\nfunction parseAction(value: unknown): InspectorAction | undefined {\n if (!isRecord(value)) {\n return undefined;\n }\n\n const kind = parseActionKind(value.kind);\n const url = parseSafeActionUrl(value.url);\n if (kind === undefined || url === undefined) {\n return undefined;\n }\n\n return { kind, url };\n}\n\nfunction isFiniteNonnegativeInteger(value: unknown): value is number {\n return typeof value === \"number\" && Number.isSafeInteger(value) && value >= 0;\n}\n\nfunction parseUsageLimit(value: unknown): InspectorUsageLimit | undefined {\n if (!isRecord(value)) {\n return undefined;\n }\n\n if (value.kind === \"finite\") {\n if (\n typeof value.value !== \"number\" ||\n !Number.isSafeInteger(value.value) ||\n value.value < 1\n ) {\n return undefined;\n }\n\n return { kind: \"finite\", value: value.value };\n }\n\n if (value.kind === \"unlimited\") {\n return { kind: \"unlimited\" };\n }\n\n if (value.kind === \"unknown\") {\n return { kind: \"unknown\" };\n }\n\n return undefined;\n}\n\nfunction parseUsage(value: unknown): InspectorUsage | undefined {\n if (!isRecord(value)) {\n return undefined;\n }\n\n const limit = parseUsageLimit(value.limit);\n const used = value.used;\n if (!isFiniteNonnegativeInteger(used) || limit === undefined) {\n return undefined;\n }\n\n const rawExpiringSoonCount = readOwnDataProperty(value, \"expiringSoonCount\");\n const expiringSoonCount = isFiniteNonnegativeInteger(rawExpiringSoonCount)\n ? rawExpiringSoonCount\n : undefined;\n\n return {\n used,\n limit,\n ...(expiringSoonCount === undefined ? {} : { expiringSoonCount }),\n };\n}\n\n/**\n * Parses untrusted inspector metadata without letting one invalid optional\n * module hide the other valid modules.\n *\n * @param value - The decoded runtime response body.\n * @returns Normalized version 1 metadata, or `undefined` for an unsupported\n * top-level payload.\n */\nexport function parseInspectorMetadataV1(\n value: unknown,\n): InspectorMetadataV1 | undefined {\n if (!isRecord(value) || value.schemaVersion !== 1) {\n return undefined;\n }\n\n const identity = parseIdentity(value.identity);\n const plan = parsePlan(value.plan);\n const license = parseLicense(value.license);\n const action = parseAction(value.action);\n const usage = parseUsage(value.usage);\n\n return {\n schemaVersion: 1,\n ...(identity === undefined ? {} : { identity }),\n ...(plan === undefined ? {} : { plan }),\n ...(license === undefined ? {} : { license }),\n ...(action === undefined ? {} : { action }),\n ...(usage === undefined ? {} : { usage }),\n };\n}\n"],"mappings":"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"}
|