@case-framework/survey-assistant 0.6.0 → 0.8.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.
Files changed (135) hide show
  1. package/README.md +67 -7
  2. package/dist/{attachments-B0hg3vpT.mjs → attachments-BuNni5vB.mjs} +1 -1
  3. package/dist/{attachments-B0hg3vpT.mjs.map → attachments-BuNni5vB.mjs.map} +1 -1
  4. package/dist/{authoring-references-CW38pYzK.mjs → authoring-references-DbuOKerg.mjs} +13 -4
  5. package/dist/authoring-references-DbuOKerg.mjs.map +1 -0
  6. package/dist/{capabilities-DVTfogjv.d.mts → capabilities-CmeeAjEc.d.mts} +3 -4
  7. package/dist/capabilities-CmeeAjEc.d.mts.map +1 -0
  8. package/dist/capabilities-DCMA71PP.mjs +58 -0
  9. package/dist/capabilities-DCMA71PP.mjs.map +1 -0
  10. package/dist/capabilities-default.d.mts +13 -12
  11. package/dist/capabilities-default.d.mts.map +1 -1
  12. package/dist/capabilities-default.mjs +2 -414
  13. package/dist/{constants-BMGTgfjv.d.mts → constants-B6HzpEsx.d.mts} +7 -28
  14. package/dist/constants-B6HzpEsx.d.mts.map +1 -0
  15. package/dist/{constants-0UHGFcRJ.mjs → constants-Ct-vv9cu.mjs} +1 -1
  16. package/dist/{constants-0UHGFcRJ.mjs.map → constants-Ct-vv9cu.mjs.map} +1 -1
  17. package/dist/controller-proxy-D7uQfm5f.d.mts +65 -0
  18. package/dist/controller-proxy-D7uQfm5f.d.mts.map +1 -0
  19. package/dist/{controller-proxy-DMTqer6T.mjs → controller-proxy-DEeFl9IA.mjs} +29 -26
  20. package/dist/controller-proxy-DEeFl9IA.mjs.map +1 -0
  21. package/dist/default-fhSon2RM.mjs +760 -0
  22. package/dist/default-fhSon2RM.mjs.map +1 -0
  23. package/dist/{digest-SJmoYVaK.d.mts → digest-C39WyAWG.d.mts} +2 -3
  24. package/dist/digest-C39WyAWG.d.mts.map +1 -0
  25. package/dist/digest.d.mts +1 -1
  26. package/dist/digest.mjs.map +1 -1
  27. package/dist/{engine-CQwOAcwK.mjs → engine-nXoCWYpQ.mjs} +2821 -2018
  28. package/dist/engine-nXoCWYpQ.mjs.map +1 -0
  29. package/dist/engine.d.mts +3 -3
  30. package/dist/engine.mjs +3 -3
  31. package/dist/{fair-guidance-CRYCRxQm.mjs → fair-guidance-BmO4PswW.mjs} +1 -1
  32. package/dist/{fair-guidance-CRYCRxQm.mjs.map → fair-guidance-BmO4PswW.mjs.map} +1 -1
  33. package/dist/{index-D6nqkz0O.d.mts → index-Ciq7vHIs.d.mts} +121 -197
  34. package/dist/index-Ciq7vHIs.d.mts.map +1 -0
  35. package/dist/{index-DvTqML-0.d.mts → index-D7wT6P3t.d.mts} +294 -63
  36. package/dist/index-D7wT6P3t.d.mts.map +1 -0
  37. package/dist/index-WB5kfnz0.d.mts +348 -0
  38. package/dist/index-WB5kfnz0.d.mts.map +1 -0
  39. package/dist/{index-B0lxsAzx.d.mts → index-r5riv4md.d.mts} +50 -29
  40. package/dist/index-r5riv4md.d.mts.map +1 -0
  41. package/dist/{lifecycle-BmGAIUlv.d.mts → lifecycle-Dm8u7QFh.d.mts} +40 -18
  42. package/dist/lifecycle-Dm8u7QFh.d.mts.map +1 -0
  43. package/dist/{memory-thread-repository-CjFGVNZh.mjs → memory-thread-repository-DAnOGIB3.mjs} +89 -34
  44. package/dist/memory-thread-repository-DAnOGIB3.mjs.map +1 -0
  45. package/dist/{protocol-DJUP4gc0.mjs → protocol-CF4Bh_Ch.mjs} +182 -50
  46. package/dist/protocol-CF4Bh_Ch.mjs.map +1 -0
  47. package/dist/protocol.d.mts +4 -4
  48. package/dist/protocol.mjs +3 -3
  49. package/dist/react-C_GY-Fsc.mjs +1727 -0
  50. package/dist/react-C_GY-Fsc.mjs.map +1 -0
  51. package/dist/react-integration.d.mts +2 -2
  52. package/dist/react-integration.mjs +2 -2
  53. package/dist/react.d.mts +3 -3
  54. package/dist/react.mjs +3 -3
  55. package/dist/references/assistant-operations.md +143 -68
  56. package/dist/references/core-rules.md +6 -3
  57. package/dist/references/embedded-forms.md +34 -14
  58. package/dist/references/expressions.md +238 -48
  59. package/dist/references/fair-by-design.md +9 -9
  60. package/dist/references/item-types.md +306 -72
  61. package/dist/references/localization.md +5 -4
  62. package/dist/references/response-variables.md +38 -0
  63. package/dist/references/rich-text-content.md +60 -27
  64. package/dist/references/source-material-surveys.md +13 -5
  65. package/dist/references/survey-data-model.md +32 -9
  66. package/dist/{request-context-BjTHNcDd.mjs → request-context-Dg4jSwN1.mjs} +4 -10
  67. package/dist/request-context-Dg4jSwN1.mjs.map +1 -0
  68. package/dist/{request-guardrails-TmgQtqp4.mjs → request-guardrails-C0ugBOp0.mjs} +6 -5
  69. package/dist/request-guardrails-C0ugBOp0.mjs.map +1 -0
  70. package/dist/server-agent.d.mts +53 -44
  71. package/dist/server-agent.d.mts.map +1 -1
  72. package/dist/server-agent.mjs +48 -27
  73. package/dist/server-agent.mjs.map +1 -1
  74. package/dist/server-runtime.d.mts +36 -49
  75. package/dist/server-runtime.d.mts.map +1 -1
  76. package/dist/server-runtime.mjs +17 -12
  77. package/dist/server-runtime.mjs.map +1 -1
  78. package/dist/server-tasks.d.mts +2 -2
  79. package/dist/server-tasks.mjs +2 -313
  80. package/dist/server-tools.d.mts +1 -1
  81. package/dist/server-tools.mjs +1 -1
  82. package/dist/server.d.mts +13 -36
  83. package/dist/server.d.mts.map +1 -1
  84. package/dist/server.mjs +5 -5
  85. package/dist/server.mjs.map +1 -1
  86. package/dist/storage-postgres.d.mts +9 -25
  87. package/dist/storage-postgres.d.mts.map +1 -1
  88. package/dist/storage-postgres.mjs +5 -4
  89. package/dist/storage-postgres.mjs.map +1 -1
  90. package/dist/{tasks-DxzD25Zc.d.mts → tasks-B9h3LPam.d.mts} +19 -35
  91. package/dist/tasks-B9h3LPam.d.mts.map +1 -0
  92. package/dist/tasks-BZEiwgxA.mjs +396 -0
  93. package/dist/tasks-BZEiwgxA.mjs.map +1 -0
  94. package/dist/thread-documents-DrHbaXqP.d.mts +119 -0
  95. package/dist/thread-documents-DrHbaXqP.d.mts.map +1 -0
  96. package/dist/{thread-handlers-AbQbt4sX.d.mts → thread-handlers-Bef0td9N.d.mts} +10 -40
  97. package/dist/thread-handlers-Bef0td9N.d.mts.map +1 -0
  98. package/dist/{tools-CFh35R4d.mjs → tools-CEsv-WoO.mjs} +705 -578
  99. package/dist/tools-CEsv-WoO.mjs.map +1 -0
  100. package/dist/ui.css +1 -1
  101. package/dist/ui.d.mts +17 -55
  102. package/dist/ui.d.mts.map +1 -1
  103. package/dist/ui.mjs +759 -171
  104. package/dist/ui.mjs.map +1 -1
  105. package/docs/integration.md +51 -1
  106. package/package.json +49 -42
  107. package/dist/authoring-references-CW38pYzK.mjs.map +0 -1
  108. package/dist/capabilities-DVTfogjv.d.mts.map +0 -1
  109. package/dist/capabilities-default.mjs.map +0 -1
  110. package/dist/constants-BMGTgfjv.d.mts.map +0 -1
  111. package/dist/controller-proxy-DMTqer6T.mjs.map +0 -1
  112. package/dist/controller-proxy-mRvez2qw.d.mts +0 -85
  113. package/dist/controller-proxy-mRvez2qw.d.mts.map +0 -1
  114. package/dist/digest-SJmoYVaK.d.mts.map +0 -1
  115. package/dist/engine-CQwOAcwK.mjs.map +0 -1
  116. package/dist/form-authoring-kQDgC5oz.mjs +0 -155
  117. package/dist/form-authoring-kQDgC5oz.mjs.map +0 -1
  118. package/dist/index-B0lxsAzx.d.mts.map +0 -1
  119. package/dist/index-BS-Xjk1h.d.mts +0 -224
  120. package/dist/index-BS-Xjk1h.d.mts.map +0 -1
  121. package/dist/index-D6nqkz0O.d.mts.map +0 -1
  122. package/dist/index-DvTqML-0.d.mts.map +0 -1
  123. package/dist/lifecycle-BmGAIUlv.d.mts.map +0 -1
  124. package/dist/memory-thread-repository-CjFGVNZh.mjs.map +0 -1
  125. package/dist/protocol-DJUP4gc0.mjs.map +0 -1
  126. package/dist/react-Dqlmasrs.mjs +0 -768
  127. package/dist/react-Dqlmasrs.mjs.map +0 -1
  128. package/dist/request-context-BjTHNcDd.mjs.map +0 -1
  129. package/dist/request-guardrails-TmgQtqp4.mjs.map +0 -1
  130. package/dist/server-tasks.mjs.map +0 -1
  131. package/dist/tasks-DxzD25Zc.d.mts.map +0 -1
  132. package/dist/thread-documents-rmd6nyX9.d.mts +0 -107
  133. package/dist/thread-documents-rmd6nyX9.d.mts.map +0 -1
  134. package/dist/thread-handlers-AbQbt4sX.d.mts.map +0 -1
  135. package/dist/tools-CFh35R4d.mjs.map +0 -1
package/README.md CHANGED
@@ -59,7 +59,6 @@ import {
59
59
  import {
60
60
  createSurveyAssistantControllerBridge,
61
61
  createSurveyAssistantTaskClient,
62
- createSurveyAssistantTaskExecutor,
63
62
  createSurveyAssistantThreadLauncher,
64
63
  } from "@case-framework/survey-assistant/react/integration";
65
64
 
@@ -106,6 +105,11 @@ stylesheet has no preflight and scopes generated utilities beneath the panel
106
105
  root. A host can pass a partial localization catalog to extend or override the
107
106
  defaults without supplying a complete catalog.
108
107
 
108
+ Hosts using `/ui` must install `@base-ui/react@^1.8.0` alongside React and
109
+ React DOM. Base UI is an optional peer dependency so server and protocol consumers
110
+ do not need to install it. Use the same Base UI installation for the assistant,
111
+ survey player, editor, and host components.
112
+
109
113
  ```tsx
110
114
  <ConnectedSurveyAssistantPanel
111
115
  api="/api/survey-assistant/chat"
@@ -188,7 +192,8 @@ metadata.
188
192
  `/protocol`, `/engine`, and `/capabilities/default` may not import React,
189
193
  Next.js, Mastra, AI SDK, `survey-ui`, or Node-only storage. `/protocol` has Zod
190
194
  plus the narrow browser-safe `survey-core/editor/colors` runtime dependency;
191
- `/engine` may use the full `survey-core` API. `/server` is
195
+ `/engine` and `/capabilities/default` may use the headless `survey-items`
196
+ domain and the full `survey-core` API. `/server` is
192
197
  server-only and may import Mastra, AI SDK, and Node APIs, but never React,
193
198
  Next.js, or `survey-ui`. The separate server entries prevent handler-only
194
199
  consumers from eagerly loading Agent/Memory code. `@case-framework/survey-editor-ui`
@@ -214,7 +219,7 @@ export const ratingAssistantCapability = {
214
219
  create: "deterministic",
215
220
  supportedOperations: [
216
221
  "create-item",
217
- "update-item-key",
222
+ "update-response-settings",
218
223
  "update-item-translation",
219
224
  "patch-item-config",
220
225
  ],
@@ -229,6 +234,19 @@ export const ratingAssistantCapability = {
229
234
  markdown: "Use min < max and a positive step.",
230
235
  },
231
236
  ],
237
+ // Match the host core's declaration; item identity can seed a new scalar slot.
238
+ normalizeCreate: (item) => ({
239
+ ...item,
240
+ config: { responseId: item.id, variableName: "rating", ...item.config },
241
+ }),
242
+ deriveResponseSlotDefinitions: (item) => [
243
+ {
244
+ slotId: item.config.responseId,
245
+ variableName: item.config.variableName,
246
+ valueType: "number",
247
+ naming: { kind: "variable", path: ["variableName"] },
248
+ },
249
+ ],
232
250
  } satisfies AssistantItemCapabilityAdapter;
233
251
 
234
252
  // rating-entry.tsx (client/editor module)
@@ -253,13 +271,43 @@ received from a browser snapshot.
253
271
  ```bash
254
272
  pnpm --filter @case-framework/survey-assistant check
255
273
  pnpm --filter @case-framework/survey-assistant check:release
274
+ pnpm benchmark:survey-assistant-operations
256
275
  ```
257
276
 
258
277
  `check` typechecks and builds all entries, copies server references, verifies
259
- their source and built import graphs, and runs unit tests. `check:release` also
260
- builds the clean Next host fixture. The optional Postgres entry accepts a
261
- host-owned `PostgresStore` or store configuration; it does not read environment
262
- variables, create hidden singletons, or own connection shutdown.
278
+ their source and built import graphs, and runs typed unit/DOM tests plus the real
279
+ SDK streaming integration tests (with a scripted model, no provider requests). `check:release` also
280
+ builds the clean Next host fixture. `benchmark:survey-assistant-operations`
281
+ uses the current built engine output to profile maximum-size typed validation
282
+ and the raw-patch path against a synthetic 5,002-item survey; run `build` first
283
+ when source has changed. The optional Postgres entry accepts a host-owned
284
+ `PostgresStore` or store configuration; it does not read environment variables,
285
+ create hidden singletons, or own connection shutdown.
286
+
287
+ ## Test boundaries
288
+
289
+ - `test` checks fixtures and runs the Vitest source suite. Its tool-constructor mock
290
+ deliberately bypasses SDK validation for handler-level negative inputs; the
291
+ test TypeScript config reflects that mock and keeps schema input/output types.
292
+ The separate production `typecheck` uses the real SDK types.
293
+ - `test:integration` runs built output through native `node:test` with the real Agent, tools, HTTP handler,
294
+ stream adapter, transport, and session hook. Only model responses are scripted.
295
+ Build changed package output first. The editor UI suite also feeds these real
296
+ streamed candidates through its apply/undo boundary in a separate native ESM
297
+ process so source-test aliases and mocks cannot replace the SDKs.
298
+ - `test:postgres` also uses native `node:test` and requires
299
+ `SURVEY_ASSISTANT_TEST_DATABASE_URL`. Use a disposable
300
+ PostgreSQL database: the test creates a unique schema and drops only that schema
301
+ in cleanup. It tests isolation, BYTEA roundtrips, deduplication, and concurrent
302
+ quotas against real PostgreSQL. Missing configuration fails explicitly; this
303
+ opt-in test is not part of the database-free `check` command.
304
+ - Live model evaluations remain opt-in. DOM tests exercise events but do not
305
+ establish browser layout, focus, scrolling, or accessibility acceptance.
306
+
307
+ ```sh
308
+ SURVEY_ASSISTANT_TEST_DATABASE_URL=postgresql://localhost/assistant_test \
309
+ pnpm --filter @case-framework/survey-assistant test:postgres
310
+ ```
263
311
 
264
312
  ## Integration Levels
265
313
 
@@ -286,3 +334,15 @@ The option does not choose or authorize an identity, and most authenticated
286
334
  hosts should omit it unless they want that extra deployment switch. See
287
335
  [Real-host integration](./docs/integration.md#optional-experimental-identity-rollout-gate)
288
336
  for the exact enablement rules.
337
+
338
+ ### Response-variable authoring (survey schema version 2)
339
+
340
+ Assistant mutations target exact persistent item IDs. Search exposes resolved editor names and breadcrumbs for discovery; names may repeat. Response-slot declarations from the shared item packages provide persistent IDs, coding names, domains, matrix ownership and computed dependencies. Expressions serialize references as `{slotId, method: "get" | "isDefined"}`.
341
+
342
+ Use `update-response-settings` with `naming` and `settings` arrays for atomic scalar names, matrix naming components, option export codes and export defaults. Shared core previews validate names, derived families and projected headers; editor application remains a single normal undoable transaction. The built-in registry supports consent, choice and form matrices alongside scalar and embedded forms.
343
+
344
+ One-shot tasks are `suggest-response-name` (a scalar `itemId` and `slotId`) and `suggest-response-settings` (`slotIds` and a naming category). Response Settings offers selected-variable or filtered-visible-variable suggestions, validates a before/after preview, and applies only on user action. Categories are `fair`, `survey-pattern`, `compact`, and `preferred`. All obey the same naming syntax; FAIR guidance is a project convention, not a certification.
345
+
346
+ Custom capabilities with conditional components, projected answers or computed behavior need a trusted server-safe `itemCore` constructor shared with the player for complete proposal-time validation. Without it, the assistant cannot inspect those activation dependencies and may propose a change that the editor rejects at apply; no partial change is applied, but the model cannot repair that failure within the original turn. Standard form, choice, consent and matrix items already use shared headless cores.
347
+
348
+ Slot-only capabilities can use `deriveResponseSlotDefinitions`; creatable custom response capabilities must expose full slot definitions through one of these contracts, including persistent slot IDs, separate variable names, and naming paths and categorical domains where supported. The type-only `deriveResponseSlots` adapter is insufficient for creation under the current schema; it remains an inspection-only adapter. Pass the same capability set to `buildSurveyAssistantTaskContext`, or the editor AI provider/integration's optional `capabilities`, for custom-variable tasks. The server must continue to supply trusted capabilities independently of browser data.
@@ -8,4 +8,4 @@ const isSurveyAssistantAttachmentMediaType = (mediaType) => SURVEY_ASSISTANT_ATT
8
8
  //#endregion
9
9
  export { isSurveyAssistantAttachmentMediaType as n, SURVEY_ASSISTANT_ATTACHMENT_MEDIA_TYPES as t };
10
10
 
11
- //# sourceMappingURL=attachments-B0hg3vpT.mjs.map
11
+ //# sourceMappingURL=attachments-BuNni5vB.mjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"attachments-B0hg3vpT.mjs","names":[],"sources":["../src/protocol/attachments.ts"],"sourcesContent":["export const SURVEY_ASSISTANT_ATTACHMENT_MEDIA_TYPES = [\n \"application/pdf\",\n \"image/png\",\n \"image/jpeg\",\n] as const;\n\nexport type SurveyAssistantAttachmentMediaType =\n (typeof SURVEY_ASSISTANT_ATTACHMENT_MEDIA_TYPES)[number];\n\nexport const isSurveyAssistantAttachmentMediaType = (\n mediaType: string,\n): mediaType is SurveyAssistantAttachmentMediaType =>\n (SURVEY_ASSISTANT_ATTACHMENT_MEDIA_TYPES as readonly string[]).includes(mediaType.toLowerCase());\n"],"mappings":";AAAA,MAAa,0CAA0C;CACrD;CACA;CACA;CACD;AAKD,MAAa,wCACX,cAEC,wCAA8D,SAAS,UAAU,aAAa,CAAC"}
1
+ {"version":3,"file":"attachments-BuNni5vB.mjs","names":[],"sources":["../src/protocol/attachments.ts"],"sourcesContent":["export const SURVEY_ASSISTANT_ATTACHMENT_MEDIA_TYPES = [\n \"application/pdf\",\n \"image/png\",\n \"image/jpeg\",\n] as const;\n\nexport type SurveyAssistantAttachmentMediaType =\n (typeof SURVEY_ASSISTANT_ATTACHMENT_MEDIA_TYPES)[number];\n\nexport const isSurveyAssistantAttachmentMediaType = (\n mediaType: string,\n): mediaType is SurveyAssistantAttachmentMediaType =>\n (SURVEY_ASSISTANT_ATTACHMENT_MEDIA_TYPES as readonly string[]).includes(mediaType.toLowerCase());\n"],"mappings":";AAAA,MAAa,0CAA0C;CACrD;CACA;CACA;AACF;AAKA,MAAa,wCACX,cAEC,wCAA8D,SAAS,UAAU,YAAY,CAAC"}
@@ -1,7 +1,7 @@
1
1
  import path, { resolve } from "node:path";
2
2
  import { fileURLToPath } from "node:url";
3
3
  import { readFileSync } from "node:fs";
4
- //#region ../../node_modules/.pnpm/tsdown@0.21.10_synckit@0.11.13_typescript@6.0.3/node_modules/tsdown/esm-shims.js
4
+ //#region ../../node_modules/.pnpm/tsdown@0.23.0_@volar+typescript@2.4.28_typescript@6.0.3__typescript@6.0.3_unrun@0.2.39/node_modules/tsdown/esm-shims.js
5
5
  const getFilename = () => fileURLToPath(import.meta.url);
6
6
  const getDirname = () => path.dirname(getFilename());
7
7
  const __dirname = /* @__PURE__ */ getDirname();
@@ -11,6 +11,7 @@ const loadReference = (fileName) => readFileSync(resolve(__dirname, "references"
11
11
  const surveyAuthoringReferenceTopics = [
12
12
  "core-rules",
13
13
  "survey-data-model",
14
+ "response-variables",
14
15
  "source-material-surveys",
15
16
  "localization",
16
17
  "rich-text-content",
@@ -25,8 +26,11 @@ const ITEM_TYPE_SECTION_HEADINGS = {
25
26
  group: "group",
26
27
  "page-break": "page-break",
27
28
  infoItem: "infoItem",
29
+ consentItem: "consentItem",
28
30
  choiceItem: "choiceItem",
29
- formItem: "formItem"
31
+ formItem: "formItem",
32
+ choiceMatrix: "choiceMatrix",
33
+ formMatrix: "formMatrix"
30
34
  };
31
35
  const builtInSurveyAuthoringItemTypes = Object.freeze(Object.keys(ITEM_TYPE_SECTION_HEADINGS));
32
36
  const extractLevelTwoSection = (markdown, heading) => {
@@ -43,6 +47,11 @@ const surveyAuthoringReferences = {
43
47
  content: loadReference("core-rules.md"),
44
48
  loadWhen: "Load when the task depends on canonical tool choice, validation/apply semantics, identifier handling, or another cross-cutting authoring rule that the current turn has not already established."
45
49
  },
50
+ "response-variables": {
51
+ title: "Response variables and coding",
52
+ content: loadReference("response-variables.md"),
53
+ loadWhen: "Load before creating response inputs, changing variable names, option codes, matrix coding components, or export settings. Inspect current response slots for exact IDs and domains."
54
+ },
46
55
  "survey-data-model": {
47
56
  title: "Survey data model",
48
57
  content: loadReference("survey-data-model.md"),
@@ -51,7 +60,7 @@ const surveyAuthoringReferences = {
51
60
  "source-material-surveys": {
52
61
  title: "Source-material survey implementation",
53
62
  content: loadReference("source-material-surveys.md"),
54
- loadWhen: "Load before implementing or adapting a questionnaire, document, image, or other supplied source material so completeness, respondent-input mapping, language, and digital adaptation rules are available before the first mutation."
63
+ loadWhen: "Load before implementing or adapting a questionnaire, document, image, or other supplied source material so completeness, respondent-input mapping, meaningful layout, language, and digital adaptation rules are available before the first mutation."
55
64
  },
56
65
  localization: {
57
66
  title: "Survey localization",
@@ -112,4 +121,4 @@ const getBuiltInItemTypeAuthoringReference = (itemType) => {
112
121
  //#endregion
113
122
  export { surveyAuthoringReferences as a, surveyAuthoringReferenceTopics as i, formatSurveyAuthoringReferenceRoutingInstructions as n, getBuiltInItemTypeAuthoringReference as r, builtInSurveyAuthoringItemTypes as t };
114
123
 
115
- //# sourceMappingURL=authoring-references-CW38pYzK.mjs.map
124
+ //# sourceMappingURL=authoring-references-DbuOKerg.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"authoring-references-DbuOKerg.mjs","names":[],"sources":["../../../node_modules/.pnpm/tsdown@0.23.0_@volar+typescript@2.4.28_typescript@6.0.3__typescript@6.0.3_unrun@0.2.39/node_modules/tsdown/esm-shims.js","../src/server/authoring-references.ts"],"sourcesContent":["// Shim globals in esm bundle\nimport path from 'node:path'\nimport { fileURLToPath } from 'node:url'\n\nconst getFilename = () => fileURLToPath(import.meta.url)\nconst getDirname = () => path.dirname(getFilename())\n\nexport const __dirname = /* @__PURE__ */ getDirname()\nexport const __filename = /* @__PURE__ */ getFilename()\n","import { readFileSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\n\nconst loadReference = (fileName: string) =>\n readFileSync(resolve(__dirname, \"references\", fileName), \"utf8\").trim();\n\nexport const surveyAuthoringReferenceTopics = [\n \"core-rules\",\n \"survey-data-model\",\n \"response-variables\",\n \"source-material-surveys\",\n \"localization\",\n \"rich-text-content\",\n \"item-types\",\n \"embedded-forms\",\n \"expressions\",\n \"assistant-operations\",\n \"fair-by-design\",\n \"survey-quality\",\n] as const;\n\nexport type SurveyAuthoringReferenceTopic = (typeof surveyAuthoringReferenceTopics)[number];\n\ntype SurveyAuthoringReferenceEntry = {\n title: string;\n content: string;\n loadWhen: string;\n};\n\nconst ITEM_TYPE_SECTION_HEADINGS: Readonly<Record<string, string>> = {\n group: \"group\",\n \"page-break\": \"page-break\",\n infoItem: \"infoItem\",\n consentItem: \"consentItem\",\n choiceItem: \"choiceItem\",\n formItem: \"formItem\",\n choiceMatrix: \"choiceMatrix\",\n formMatrix: \"formMatrix\",\n};\n\nexport const builtInSurveyAuthoringItemTypes = Object.freeze(\n Object.keys(ITEM_TYPE_SECTION_HEADINGS),\n);\n\nconst extractLevelTwoSection = (markdown: string, heading: string): string | undefined => {\n const lines = markdown.split(\"\\n\");\n const sectionStart = lines.findIndex((line) => line.trim() === `## ${heading}`);\n if (sectionStart < 0) {\n return undefined;\n }\n\n const nextSectionOffset = lines\n .slice(sectionStart + 1)\n .findIndex((line) => line.startsWith(\"## \"));\n const sectionEnd = nextSectionOffset < 0 ? lines.length : sectionStart + 1 + nextSectionOffset;\n\n return lines.slice(sectionStart, sectionEnd).join(\"\\n\").trim();\n};\n\nexport const surveyAuthoringReferences = {\n \"core-rules\": {\n title: \"Core authoring rules\",\n content: loadReference(\"core-rules.md\"),\n loadWhen:\n \"Load when the task depends on canonical tool choice, validation/apply semantics, identifier handling, or another cross-cutting authoring rule that the current turn has not already established.\",\n },\n \"response-variables\": {\n title: \"Response variables and coding\",\n content: loadReference(\"response-variables.md\"),\n loadWhen:\n \"Load before creating response inputs, changing variable names, option codes, matrix coding components, or export settings. Inspect current response slots for exact IDs and domains.\",\n },\n \"survey-data-model\": {\n title: \"Survey data model\",\n content: loadReference(\"survey-data-model.md\"),\n loadWhen:\n \"Load before reasoning about raw survey storage, hierarchy, ids, translation maps, assets, template values, or any direct survey-json-patch path whose exact location has not already been inspected and documented in the current turn.\",\n },\n \"source-material-surveys\": {\n title: \"Source-material survey implementation\",\n content: loadReference(\"source-material-surveys.md\"),\n loadWhen:\n \"Load before implementing or adapting a questionnaire, document, image, or other supplied source material so completeness, respondent-input mapping, meaningful layout, language, and digital adaptation rules are available before the first mutation.\",\n },\n localization: {\n title: \"Survey localization\",\n content: loadReference(\"localization.md\"),\n loadWhen:\n \"Load before adding, removing, translating, or assessing a survey locale, including requests for localization completeness or locale lifecycle changes.\",\n },\n \"rich-text-content\": {\n title: \"Rich text content\",\n content: loadReference(\"rich-text-content.md\"),\n loadWhen:\n \"Load before authoring or changing meaningful formatting, links, images, headings, lists, info boxes, separators, footnotes, or existing structured rich-text content; do not load it for ordinary unformatted plain text.\",\n },\n \"item-types\": {\n title: \"Item types\",\n content: loadReference(\"item-types.md\"),\n loadWhen:\n \"Load with itemType before creating or changing an item when its configuration, response behavior, or content surfaces are not already fully specified by the current capability and focused operation contract; omit itemType only for a genuine cross-type comparison.\",\n },\n \"embedded-forms\": {\n title: \"Choice option embedded forms\",\n content: loadReference(\"embedded-forms.md\"),\n loadWhen:\n 'Load before creating or changing a choice-option follow-up or embedded form, including \"Other, specify\", option-specific inputs, embedded field groups, or embedded-form layout and translations.',\n },\n expressions: {\n title: \"Expressions\",\n content: loadReference(\"expressions.md\"),\n loadWhen:\n \"Load before the first survey_expression prepare call for expression, condition, validation-expression, prefill, or template-value work unless the exact relevant JsonExpression and mutation shapes were already supplied by a current-turn authoring reference. survey_expression context supplies currently available runtime references and value types, but it does not replace the grammar reference. Expressions are not assumed to be survey-response-only; use the references and variable sources supported by the current runtime and reference.\",\n },\n \"assistant-operations\": {\n title: \"Assistant operations\",\n content: loadReference(\"assistant-operations.md\"),\n loadWhen:\n \"Load with operationKind before the first survey_change call when the exact canonical fields of that operation are not already present in the current turn; add itemType when item-specific configuration or capability guidance is needed. Prefer compact detail and use full only for protocol debugging.\",\n },\n \"fair-by-design\": {\n title: \"FAIR-by-design survey authoring\",\n content: loadReference(\"fair-by-design.md\"),\n loadWhen:\n \"Load before advising or editing when FAIR, interoperability, harmonization, cross-study reuse, stable coding, value sets, missingness semantics, metadata, provenance, versioning, standard instruments, controlled vocabularies, or machine-readable export is material; do not impose it on ordinary authoring.\",\n },\n \"survey-quality\": {\n title: \"Survey quality review\",\n content: loadReference(\"survey-quality.md\"),\n loadWhen:\n \"Load before a substantive questionnaire-quality critique, wording or flow review, respondent-burden assessment, or recommendations about measurement quality; it is not required for a purely technical defect check.\",\n },\n} as const satisfies Record<SurveyAuthoringReferenceTopic, SurveyAuthoringReferenceEntry>;\n\nexport const formatSurveyAuthoringReferenceRoutingInstructions = (): string =>\n [\n \"Authoring-reference routing rules:\",\n \"Load a relevant focused reference before the first affected mutation or substantive advice, not after guessing a payload or learning through validator failures. Do not reload a reference when its exact relevant contract is already present in the current turn. References define stable authoring conventions and payload grammar; current survey state and currently available runtime references still come from inspection and context tools.\",\n \"For installed capability-specific references, use the capability manifest's advertised reference topics. Load a relevant topic with itemType before changing unfamiliar capability configuration or behavior.\",\n ...surveyAuthoringReferenceTopics.map(\n (topic) => `- ${topic}: ${surveyAuthoringReferences[topic].loadWhen}`,\n ),\n ].join(\"\\n\");\n\nexport const getBuiltInItemTypeAuthoringReference = (\n itemType: string,\n): { title: string; content: string } | undefined => {\n const heading = ITEM_TYPE_SECTION_HEADINGS[itemType];\n if (!heading) {\n return undefined;\n }\n\n const content = extractLevelTwoSection(surveyAuthoringReferences[\"item-types\"].content, heading);\n return content ? { title: `${heading} item type`, content } : undefined;\n};\n"],"x_google_ignoreList":[0],"mappings":";;;;AAIA,MAAM,oBAAoB,cAAc,YAAY,GAAG;AACvD,MAAM,mBAAmB,KAAK,QAAQ,YAAY,CAAC;AAEnD,MAAa,YAA4B,2BAAW;;;ACJpD,MAAM,iBAAiB,aACrB,aAAa,QAAQ,WAAW,cAAc,QAAQ,GAAG,MAAM,CAAC,CAAC,KAAK;AAExE,MAAa,iCAAiC;CAC5C;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AAUA,MAAM,6BAA+D;CACnE,OAAO;CACP,cAAc;CACd,UAAU;CACV,aAAa;CACb,YAAY;CACZ,UAAU;CACV,cAAc;CACd,YAAY;AACd;AAEA,MAAa,kCAAkC,OAAO,OACpD,OAAO,KAAK,0BAA0B,CACxC;AAEA,MAAM,0BAA0B,UAAkB,YAAwC;CACxF,MAAM,QAAQ,SAAS,MAAM,IAAI;CACjC,MAAM,eAAe,MAAM,WAAW,SAAS,KAAK,KAAK,MAAM,MAAM,SAAS;CAC9E,IAAI,eAAe,GACjB;CAGF,MAAM,oBAAoB,MACvB,MAAM,eAAe,CAAC,CAAC,CACvB,WAAW,SAAS,KAAK,WAAW,KAAK,CAAC;CAC7C,MAAM,aAAa,oBAAoB,IAAI,MAAM,SAAS,eAAe,IAAI;CAE7E,OAAO,MAAM,MAAM,cAAc,UAAU,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK;AAC/D;AAEA,MAAa,4BAA4B;CACvC,cAAc;EACZ,OAAO;EACP,SAAS,cAAc,eAAe;EACtC,UACE;CACJ;CACA,sBAAsB;EACpB,OAAO;EACP,SAAS,cAAc,uBAAuB;EAC9C,UACE;CACJ;CACA,qBAAqB;EACnB,OAAO;EACP,SAAS,cAAc,sBAAsB;EAC7C,UACE;CACJ;CACA,2BAA2B;EACzB,OAAO;EACP,SAAS,cAAc,4BAA4B;EACnD,UACE;CACJ;CACA,cAAc;EACZ,OAAO;EACP,SAAS,cAAc,iBAAiB;EACxC,UACE;CACJ;CACA,qBAAqB;EACnB,OAAO;EACP,SAAS,cAAc,sBAAsB;EAC7C,UACE;CACJ;CACA,cAAc;EACZ,OAAO;EACP,SAAS,cAAc,eAAe;EACtC,UACE;CACJ;CACA,kBAAkB;EAChB,OAAO;EACP,SAAS,cAAc,mBAAmB;EAC1C,UACE;CACJ;CACA,aAAa;EACX,OAAO;EACP,SAAS,cAAc,gBAAgB;EACvC,UACE;CACJ;CACA,wBAAwB;EACtB,OAAO;EACP,SAAS,cAAc,yBAAyB;EAChD,UACE;CACJ;CACA,kBAAkB;EAChB,OAAO;EACP,SAAS,cAAc,mBAAmB;EAC1C,UACE;CACJ;CACA,kBAAkB;EAChB,OAAO;EACP,SAAS,cAAc,mBAAmB;EAC1C,UACE;CACJ;AACF;AAEA,MAAa,0DACX;CACE;CACA;CACA;CACA,GAAG,+BAA+B,KAC/B,UAAU,KAAK,MAAM,IAAI,0BAA0B,MAAM,CAAC,UAC7D;AACF,CAAC,CAAC,KAAK,IAAI;AAEb,MAAa,wCACX,aACmD;CACnD,MAAM,UAAU,2BAA2B;CAC3C,IAAI,CAAC,SACH;CAGF,MAAM,UAAU,uBAAuB,0BAA0B,aAAa,CAAC,SAAS,OAAO;CAC/F,OAAO,UAAU;EAAE,OAAO,GAAG,QAAQ;EAAa;CAAQ,IAAI,KAAA;AAChE"}
@@ -1,5 +1,4 @@
1
1
  import { z } from "zod";
2
-
3
2
  //#region src/protocol/capabilities.d.ts
4
3
  declare const assistantItemCreateModeSchema: z.ZodEnum<{
5
4
  deterministic: "deterministic";
@@ -43,8 +42,8 @@ declare const assistantItemTypeManifestSchema: z.ZodObject<{
43
42
  unsupported: "unsupported";
44
43
  }>;
45
44
  supportedOperations: z.ZodArray<z.ZodEnum<{
45
+ "update-response-settings": "update-response-settings";
46
46
  "create-item": "create-item";
47
- "update-item-key": "update-item-key";
48
47
  "update-item-label": "update-item-label";
49
48
  "update-item-color": "update-item-color";
50
49
  "update-item-translation": "update-item-translation";
@@ -119,8 +118,8 @@ declare const surveyAssistantCapabilityManifestSchema: z.ZodObject<{
119
118
  unsupported: "unsupported";
120
119
  }>;
121
120
  supportedOperations: z.ZodArray<z.ZodEnum<{
121
+ "update-response-settings": "update-response-settings";
122
122
  "create-item": "create-item";
123
- "update-item-key": "update-item-key";
124
123
  "update-item-label": "update-item-label";
125
124
  "update-item-color": "update-item-color";
126
125
  "update-item-translation": "update-item-translation";
@@ -190,4 +189,4 @@ type AssistantItemTypeManifest = z.infer<typeof assistantItemTypeManifestSchema>
190
189
  type SurveyAssistantCapabilityManifest = z.infer<typeof surveyAssistantCapabilityManifestSchema>;
191
190
  //#endregion
192
191
  export { AssistantResponseSlot as a, assistantItemAuthoringSchema as c, assistantResponseSlotSchema as d, surveyAssistantCapabilityManifestSchema as f, AssistantItemTypeManifest as i, assistantItemCreateModeSchema as l, AssistantItemAuthoring as n, SurveyAssistantCapabilityManifest as o, AssistantItemCreateMode as r, assistantContentSurfaceSchema as s, AssistantContentSurface as t, assistantItemTypeManifestSchema as u };
193
- //# sourceMappingURL=capabilities-DVTfogjv.d.mts.map
192
+ //# sourceMappingURL=capabilities-CmeeAjEc.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"capabilities-CmeeAjEc.d.mts","names":[],"sources":["../src/protocol/capabilities.ts"],"mappings":";;cAGa,+BAA6B,EAAA;;;;;cAM7B,+BAA6B,EAAA;;;;;;;;;;;;;;;;GAOxC,EAAA,KAAA;cAEW,6BAA2B,EAAA;;;GAGtC,EAAA,KAAA;cAEW,8BAA4B,EAAA;;;GAGvC,EAAA,KAAA;cAMW,iCAA+B,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAa1C,EAAA,KAAA;cAEW,yCAAuC,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAGlD,EAAA,KAAA;KAEU,0BAA0B,EAAE,aAAa;KACzC,0BAA0B,EAAE,aAAa;KACzC,wBAAwB,EAAE,aAAa;KACvC,yBAAyB,EAAE,aAAa;KAExC,4BAA4B,EAAE,aAAa;KAC3C,oCAAoC,EAAE,aACzC"}
@@ -0,0 +1,58 @@
1
+ import { Y as assistantItemTypeManifestSchema } from "./protocol-CF4Bh_Ch.mjs";
2
+ import { buildCapabilityDigest, stableStringify } from "./digest.mjs";
3
+ //#region src/engine/capabilities.ts
4
+ const resolveAssistantCapabilityReference = ({ capabilities, itemType, topic }) => capabilities?.byItemType.get(itemType)?.references?.find((reference) => reference.topic === topic);
5
+ const inspectAssistantItem = ({ capabilities, item }) => capabilities?.byItemType.get(item.itemType)?.inspectItem?.(item);
6
+ const createSurveyAssistantCapabilities = (capabilities) => {
7
+ const byItemType = /* @__PURE__ */ new Map();
8
+ const normalizedManifests = [];
9
+ for (const capability of capabilities) {
10
+ const manifest = assistantItemTypeManifestSchema.parse(capability.manifest);
11
+ const itemType = manifest.itemType;
12
+ if (byItemType.has(itemType)) throw new Error(`Duplicate survey assistant capability for item type "${itemType}".`);
13
+ if (manifest.create === "deterministic" && !manifest.supportedOperations.includes("create-item")) throw new Error(`Deterministically creatable item type "${itemType}" must support "create-item".`);
14
+ if (manifest.create === "deterministic" && capability.deriveResponseSlots && !capability.deriveResponseSlotDefinitions && !capability.itemCore) throw new Error(`Creatable response item type "${itemType}" must supply deriveResponseSlotDefinitions with persistent slot IDs and separate variable names. Type-only deriveResponseSlots cannot define current response coding.`);
15
+ const declaredReferenceTopics = new Set(manifest.referenceTopics ?? []);
16
+ for (const reference of capability.references ?? []) if (!declaredReferenceTopics.has(reference.topic)) throw new Error(`Capability reference "${reference.topic}" for item type "${itemType}" is missing from manifest.referenceTopics.`);
17
+ byItemType.set(itemType, capability);
18
+ normalizedManifests.push(assistantItemTypeManifestSchema.parse(JSON.parse(JSON.stringify(manifest))));
19
+ }
20
+ const manifestWithoutDigest = { itemTypes: normalizedManifests.sort((left, right) => left.itemType.localeCompare(right.itemType)) };
21
+ return {
22
+ manifest: {
23
+ ...manifestWithoutDigest,
24
+ digest: buildCapabilityDigest(manifestWithoutDigest)
25
+ },
26
+ byItemType
27
+ };
28
+ };
29
+ const getDeterministicCreateItemTypes = (manifest) => manifest.itemTypes.filter((entry) => entry.create === "deterministic").map((entry) => entry.itemType);
30
+ const createUnsupportedItemCapability = ({ displayName, itemType }) => ({ manifest: {
31
+ itemType,
32
+ capabilityVersion: "unsupported-v1",
33
+ displayName,
34
+ create: "unsupported",
35
+ supportedOperations: [],
36
+ contentSurfaces: []
37
+ } });
38
+ var SurveyAssistantCapabilityMismatchError = class extends Error {
39
+ code = "survey-assistant-capability-mismatch";
40
+ constructor(message = "Survey assistant capabilities changed; start a fresh turn and retry.") {
41
+ super(message);
42
+ this.name = "SurveyAssistantCapabilityMismatchError";
43
+ }
44
+ };
45
+ const assertSurveyAssistantCapabilities = ({ manifest, trustedCapabilities, versionDigest }) => {
46
+ const { digest: claimedDigest, ...manifestWithoutDigest } = manifest;
47
+ if (claimedDigest !== buildCapabilityDigest(manifestWithoutDigest) || versionDigest !== claimedDigest) throw new SurveyAssistantCapabilityMismatchError();
48
+ if (trustedCapabilities) {
49
+ const withoutContextualPresets = ({ creationPresets: _creationPresets, ...capability }) => capability;
50
+ const claimedBaseCapabilities = manifest.itemTypes.map(withoutContextualPresets);
51
+ const trustedBaseCapabilities = trustedCapabilities.manifest.itemTypes.map(withoutContextualPresets);
52
+ if (stableStringify(claimedBaseCapabilities) !== stableStringify(trustedBaseCapabilities)) throw new SurveyAssistantCapabilityMismatchError("The editor and server use different survey assistant capabilities; refresh and retry.");
53
+ }
54
+ };
55
+ //#endregion
56
+ export { getDeterministicCreateItemTypes as a, createUnsupportedItemCapability as i, assertSurveyAssistantCapabilities as n, inspectAssistantItem as o, createSurveyAssistantCapabilities as r, resolveAssistantCapabilityReference as s, SurveyAssistantCapabilityMismatchError as t };
57
+
58
+ //# sourceMappingURL=capabilities-DCMA71PP.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"capabilities-DCMA71PP.mjs","names":[],"sources":["../src/engine/capabilities.ts"],"sourcesContent":["import type { z } from \"zod\";\nimport type {\n ItemTypeRegistry,\n RawSurveyItem,\n ResponseSlotDefinition,\n ValueType,\n} from \"@case-framework/survey-core\";\nimport type {\n AssistantItemTypeManifest,\n JsonValue,\n SurveyAssistantCapabilityManifest,\n SurveyOperation,\n SurveyValidationIssue,\n} from \"../protocol\";\nimport { assistantItemTypeManifestSchema } from \"../protocol\";\nimport { buildCapabilityDigest, stableStringify } from \"../protocol/digest\";\n\nexport interface AssistantCapabilityReference {\n topic: string;\n title?: string;\n markdown: string;\n}\n\nexport interface AssistantItemInspection {\n summary: string;\n details?: JsonValue;\n}\n\nexport interface AssistantItemCapabilityAdapter {\n manifest: AssistantItemTypeManifest;\n /** Trusted server-safe core shared with the player, including response activation dependencies. */\n itemCore?: ItemTypeRegistry[string];\n references?: AssistantCapabilityReference[];\n configurationSchema?: z.ZodType;\n materializePreset?: (\n presetId: string,\n locale: string,\n ) => {\n config: RawSurveyItem[\"config\"];\n translations: NonNullable<Extract<SurveyOperation, { kind: \"create-item\" }>[\"translations\"]>;\n };\n validContentKeys?: (item: RawSurveyItem) => string[];\n normalizeCreate?: (item: RawSurveyItem) => RawSurveyItem;\n requiredCreateContentKeys?: (item: RawSurveyItem) => string[];\n validateItem?: (item: RawSurveyItem) => SurveyValidationIssue[];\n supportsOperation?: (operation: SurveyOperation) => boolean;\n deriveResponseSlotDefinitions?: (item: RawSurveyItem) => ResponseSlotDefinition[];\n /** Type-only inspection adapter. Creatable response items require full definitions. */\n deriveResponseSlots?: (item: RawSurveyItem) => Record<string, ValueType>;\n inspectItem?: (item: RawSurveyItem) => AssistantItemInspection;\n}\n\nexport interface SurveyAssistantCapabilitySet {\n manifest: SurveyAssistantCapabilityManifest;\n byItemType: ReadonlyMap<string, AssistantItemCapabilityAdapter>;\n}\n\nexport const resolveAssistantCapabilityReference = ({\n capabilities,\n itemType,\n topic,\n}: {\n capabilities: SurveyAssistantCapabilitySet | undefined;\n itemType: string;\n topic: string;\n}): AssistantCapabilityReference | undefined =>\n capabilities?.byItemType\n .get(itemType)\n ?.references?.find((reference) => reference.topic === topic);\n\nexport const inspectAssistantItem = ({\n capabilities,\n item,\n}: {\n capabilities: SurveyAssistantCapabilitySet | undefined;\n item: RawSurveyItem;\n}): AssistantItemInspection | undefined =>\n capabilities?.byItemType.get(item.itemType)?.inspectItem?.(item);\n\nexport const createSurveyAssistantCapabilities = (\n capabilities: readonly AssistantItemCapabilityAdapter[],\n): SurveyAssistantCapabilitySet => {\n const byItemType = new Map<string, AssistantItemCapabilityAdapter>();\n const normalizedManifests: AssistantItemTypeManifest[] = [];\n\n for (const capability of capabilities) {\n const manifest = assistantItemTypeManifestSchema.parse(capability.manifest);\n const itemType = manifest.itemType;\n if (byItemType.has(itemType)) {\n throw new Error(`Duplicate survey assistant capability for item type \"${itemType}\".`);\n }\n if (\n manifest.create === \"deterministic\" &&\n !manifest.supportedOperations.includes(\"create-item\")\n ) {\n throw new Error(\n `Deterministically creatable item type \"${itemType}\" must support \"create-item\".`,\n );\n }\n if (\n manifest.create === \"deterministic\" &&\n capability.deriveResponseSlots &&\n !capability.deriveResponseSlotDefinitions &&\n !capability.itemCore\n ) {\n throw new Error(\n `Creatable response item type \"${itemType}\" must supply deriveResponseSlotDefinitions with persistent slot IDs and separate variable names. Type-only deriveResponseSlots cannot define current response coding.`,\n );\n }\n const declaredReferenceTopics = new Set(manifest.referenceTopics ?? []);\n for (const reference of capability.references ?? []) {\n if (!declaredReferenceTopics.has(reference.topic)) {\n throw new Error(\n `Capability reference \"${reference.topic}\" for item type \"${itemType}\" is missing from manifest.referenceTopics.`,\n );\n }\n }\n byItemType.set(itemType, capability);\n normalizedManifests.push(\n assistantItemTypeManifestSchema.parse(JSON.parse(JSON.stringify(manifest))),\n );\n }\n\n const itemTypes = normalizedManifests.sort((left, right) =>\n left.itemType.localeCompare(right.itemType),\n );\n const manifestWithoutDigest = { itemTypes };\n\n return {\n manifest: {\n ...manifestWithoutDigest,\n digest: buildCapabilityDigest(manifestWithoutDigest),\n },\n byItemType,\n };\n};\n\nexport const getDeterministicCreateItemTypes = (\n manifest: SurveyAssistantCapabilityManifest,\n): string[] =>\n manifest.itemTypes\n .filter((entry) => entry.create === \"deterministic\")\n .map((entry) => entry.itemType);\n\nexport const createUnsupportedItemCapability = ({\n displayName,\n itemType,\n}: {\n displayName: string;\n itemType: string;\n}): AssistantItemCapabilityAdapter => ({\n manifest: {\n itemType,\n capabilityVersion: \"unsupported-v1\",\n displayName,\n create: \"unsupported\",\n supportedOperations: [],\n contentSurfaces: [],\n },\n});\n\nexport class SurveyAssistantCapabilityMismatchError extends Error {\n readonly code = \"survey-assistant-capability-mismatch\";\n\n constructor(message = \"Survey assistant capabilities changed; start a fresh turn and retry.\") {\n super(message);\n this.name = \"SurveyAssistantCapabilityMismatchError\";\n }\n}\n\nexport const assertSurveyAssistantCapabilities = ({\n manifest,\n trustedCapabilities,\n versionDigest,\n}: {\n manifest: SurveyAssistantCapabilityManifest;\n trustedCapabilities?: SurveyAssistantCapabilitySet;\n versionDigest: string;\n}): void => {\n const { digest: claimedDigest, ...manifestWithoutDigest } = manifest;\n const computedDigest = buildCapabilityDigest(manifestWithoutDigest);\n if (claimedDigest !== computedDigest || versionDigest !== claimedDigest) {\n throw new SurveyAssistantCapabilityMismatchError();\n }\n\n if (trustedCapabilities) {\n const withoutContextualPresets = ({\n creationPresets: _creationPresets,\n ...capability\n }: AssistantItemTypeManifest): Omit<AssistantItemTypeManifest, \"creationPresets\"> => capability;\n const claimedBaseCapabilities = manifest.itemTypes.map(withoutContextualPresets);\n const trustedBaseCapabilities =\n trustedCapabilities.manifest.itemTypes.map(withoutContextualPresets);\n\n // Creation presets are editor-registry context for the model. They do not\n // grant operations or install executable adapters, so the server validates\n // the stable capability contract while retaining its own trusted adapters.\n if (stableStringify(claimedBaseCapabilities) !== stableStringify(trustedBaseCapabilities)) {\n throw new SurveyAssistantCapabilityMismatchError(\n \"The editor and server use different survey assistant capabilities; refresh and retry.\",\n );\n }\n }\n};\n"],"mappings":";;;AAyDA,MAAa,uCAAuC,EAClD,cACA,UACA,YAMA,cAAc,WACX,IAAI,QAAQ,CAAC,EACZ,YAAY,MAAM,cAAc,UAAU,UAAU,KAAK;AAE/D,MAAa,wBAAwB,EACnC,cACA,WAKA,cAAc,WAAW,IAAI,KAAK,QAAQ,CAAC,EAAE,cAAc,IAAI;AAEjE,MAAa,qCACX,iBACiC;CACjC,MAAM,6BAAa,IAAI,IAA4C;CACnE,MAAM,sBAAmD,CAAC;CAE1D,KAAK,MAAM,cAAc,cAAc;EACrC,MAAM,WAAW,gCAAgC,MAAM,WAAW,QAAQ;EAC1E,MAAM,WAAW,SAAS;EAC1B,IAAI,WAAW,IAAI,QAAQ,GACzB,MAAM,IAAI,MAAM,wDAAwD,SAAS,GAAG;EAEtF,IACE,SAAS,WAAW,mBACpB,CAAC,SAAS,oBAAoB,SAAS,aAAa,GAEpD,MAAM,IAAI,MACR,0CAA0C,SAAS,8BACrD;EAEF,IACE,SAAS,WAAW,mBACpB,WAAW,uBACX,CAAC,WAAW,iCACZ,CAAC,WAAW,UAEZ,MAAM,IAAI,MACR,iCAAiC,SAAS,uKAC5C;EAEF,MAAM,0BAA0B,IAAI,IAAI,SAAS,mBAAmB,CAAC,CAAC;EACtE,KAAK,MAAM,aAAa,WAAW,cAAc,CAAC,GAChD,IAAI,CAAC,wBAAwB,IAAI,UAAU,KAAK,GAC9C,MAAM,IAAI,MACR,yBAAyB,UAAU,MAAM,mBAAmB,SAAS,4CACvE;EAGJ,WAAW,IAAI,UAAU,UAAU;EACnC,oBAAoB,KAClB,gCAAgC,MAAM,KAAK,MAAM,KAAK,UAAU,QAAQ,CAAC,CAAC,CAC5E;CACF;CAKA,MAAM,wBAAwB,EAAE,WAHd,oBAAoB,MAAM,MAAM,UAChD,KAAK,SAAS,cAAc,MAAM,QAAQ,CAEJ,EAAE;CAE1C,OAAO;EACL,UAAU;GACR,GAAG;GACH,QAAQ,sBAAsB,qBAAqB;EACrD;EACA;CACF;AACF;AAEA,MAAa,mCACX,aAEA,SAAS,UACN,QAAQ,UAAU,MAAM,WAAW,eAAe,CAAC,CACnD,KAAK,UAAU,MAAM,QAAQ;AAElC,MAAa,mCAAmC,EAC9C,aACA,gBAIqC,EACrC,UAAU;CACR;CACA,mBAAmB;CACnB;CACA,QAAQ;CACR,qBAAqB,CAAC;CACtB,iBAAiB,CAAC;AACpB,EACF;AAEA,IAAa,yCAAb,cAA4D,MAAM;CAChE,OAAgB;CAEhB,YAAY,UAAU,wEAAwE;EAC5F,MAAM,OAAO;EACb,KAAK,OAAO;CACd;AACF;AAEA,MAAa,qCAAqC,EAChD,UACA,qBACA,oBAKU;CACV,MAAM,EAAE,QAAQ,eAAe,GAAG,0BAA0B;CAE5D,IAAI,kBADmB,sBAAsB,qBACV,KAAK,kBAAkB,eACxD,MAAM,IAAI,uCAAuC;CAGnD,IAAI,qBAAqB;EACvB,MAAM,4BAA4B,EAChC,iBAAiB,kBACjB,GAAG,iBACgF;EACrF,MAAM,0BAA0B,SAAS,UAAU,IAAI,wBAAwB;EAC/E,MAAM,0BACJ,oBAAoB,SAAS,UAAU,IAAI,wBAAwB;EAKrE,IAAI,gBAAgB,uBAAuB,MAAM,gBAAgB,uBAAuB,GACtF,MAAM,IAAI,uCACR,uFACF;CAEJ;AACF"}
@@ -1,15 +1,16 @@
1
- import { Gt as SurveyAssistantCapabilitySet, Vt as AssistantItemCapabilityAdapter } from "./index-D6nqkz0O.mjs";
2
-
1
+ import { Wt as AssistantItemCapabilityAdapter, qt as SurveyAssistantCapabilitySet } from "./index-Ciq7vHIs.mjs";
3
2
  //#region src/capabilities/default.d.ts
4
- declare const rootItemAssistantCapability: AssistantItemCapabilityAdapter;
5
- declare const groupItemAssistantCapability: AssistantItemCapabilityAdapter;
6
- declare const pageBreakItemAssistantCapability: AssistantItemCapabilityAdapter;
7
- declare const infoItemAssistantCapability: AssistantItemCapabilityAdapter;
8
- declare const choiceItemAssistantCapability: AssistantItemCapabilityAdapter;
9
- declare const formItemAssistantCapability: AssistantItemCapabilityAdapter;
10
- declare const defaultSurveyAssistantCapabilities: readonly [AssistantItemCapabilityAdapter, AssistantItemCapabilityAdapter, AssistantItemCapabilityAdapter, AssistantItemCapabilityAdapter, AssistantItemCapabilityAdapter, AssistantItemCapabilityAdapter];
11
- declare const defaultSurveyAssistantCapabilitySet: SurveyAssistantCapabilitySet;
12
- declare const getDefaultSurveyAssistantCapability: (itemType: string) => AssistantItemCapabilityAdapter | undefined;
3
+ export declare const rootItemAssistantCapability: AssistantItemCapabilityAdapter;
4
+ export declare const groupItemAssistantCapability: AssistantItemCapabilityAdapter;
5
+ export declare const pageBreakItemAssistantCapability: AssistantItemCapabilityAdapter;
6
+ export declare const infoItemAssistantCapability: AssistantItemCapabilityAdapter;
7
+ export declare const choiceItemAssistantCapability: AssistantItemCapabilityAdapter;
8
+ export declare const formItemAssistantCapability: AssistantItemCapabilityAdapter;
9
+ export declare const consentItemAssistantCapability: AssistantItemCapabilityAdapter;
10
+ export declare const choiceMatrixAssistantCapability: AssistantItemCapabilityAdapter;
11
+ export declare const formMatrixAssistantCapability: AssistantItemCapabilityAdapter;
12
+ export declare const defaultSurveyAssistantCapabilities: readonly [AssistantItemCapabilityAdapter, AssistantItemCapabilityAdapter, AssistantItemCapabilityAdapter, AssistantItemCapabilityAdapter, AssistantItemCapabilityAdapter, AssistantItemCapabilityAdapter, AssistantItemCapabilityAdapter, AssistantItemCapabilityAdapter, AssistantItemCapabilityAdapter];
13
+ export declare const defaultSurveyAssistantCapabilitySet: SurveyAssistantCapabilitySet;
14
+ export declare const getDefaultSurveyAssistantCapability: (itemType: string) => AssistantItemCapabilityAdapter | undefined;
13
15
  //#endregion
14
- export { choiceItemAssistantCapability, defaultSurveyAssistantCapabilities, defaultSurveyAssistantCapabilitySet, formItemAssistantCapability, getDefaultSurveyAssistantCapability, groupItemAssistantCapability, infoItemAssistantCapability, pageBreakItemAssistantCapability, rootItemAssistantCapability };
15
16
  //# sourceMappingURL=capabilities-default.d.mts.map
@@ -1 +1 @@
1
- {"version":3,"file":"capabilities-default.d.mts","names":[],"sources":["../src/capabilities/default.ts"],"mappings":";;;cAkNa,2BAAA,EAA6B,8BAAA;AAAA,cAY7B,4BAAA,EAA8B,8BAAA;AAAA,cAsB9B,gCAAA,EAAkC,8BAAA;AAAA,cAsBlC,2BAAA,EAA6B,8BAAA;AAAA,cA6B7B,6BAAA,EAA+B,8BAAA;AAAA,cAyF/B,2BAAA,EAA6B,8BAAA;AAAA,cA2D7B,kCAAA,YAAkC,8BAAA,EAAA,8BAAA,EAAA,8BAAA,EAAA,8BAAA,EAAA,8BAAA,EAAA,8BAAA;AAAA,cASlC,mCAAA,EAEZ,4BAAA;AAAA,cAEY,mCAAA,GACX,QAAA,aACC,8BAAA"}
1
+ {"version":3,"file":"capabilities-default.d.mts","names":[],"sources":["../src/capabilities/default.ts"],"mappings":";;qBAuMa,6BAA6B;qBAY7B,8BAA8B;qBAsB9B,kCAAkC;qBAsBlC,6BAA6B;qBA6B7B,+BAA+B;qBAsG/B,6BAA6B;qBA4D7B,gCAAgC;qBAkMhC,iCAA+B;qBAC/B,+BAA6B;qBAE7B,8CAAkC,gCAAA,gCAAA,gCAAA,gCAAA,gCAAA,gCAAA,gCAAA,gCAAA;qBAYlC,qCAAA;qBAIA,sCACX,qBACC"}