@jskit-ai/jskit-catalog 0.1.37 → 0.1.39

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 (2) hide show
  1. package/catalog/packages.json +365 -444
  2. package/package.json +1 -1
package/catalog/packages.json CHANGED
@@ -6,19 +6,19 @@
6
6
  "packages": [
7
7
  {
8
8
  "packageId": "@jskit-ai/assistant",
9
- "version": "0.1.38",
9
+ "version": "0.1.40",
10
10
  "descriptor": {
11
11
  "packageVersion": 1,
12
12
  "packageId": "@jskit-ai/assistant",
13
- "version": "0.1.38",
13
+ "version": "0.1.40",
14
14
  "kind": "generator",
15
- "description": "Generate an app-local assistant runtime and settings integration from explicit surface choices.",
15
+ "description": "Generate an assistant page and per-surface assistant config using the shared assistant runtime.",
16
16
  "options": {
17
- "runtime-surface": {
17
+ "surface": {
18
18
  "required": true,
19
19
  "inputType": "text",
20
- "defaultValue": "",
21
- "promptLabel": "Runtime surface",
20
+ "defaultFromConfig": "surfaceDefaultId",
21
+ "promptLabel": "Assistant surface",
22
22
  "promptHint": "Enabled surface id where the assistant page will run."
23
23
  },
24
24
  "settings-surface": {
@@ -26,7 +26,14 @@
26
26
  "inputType": "text",
27
27
  "defaultValue": "",
28
28
  "promptLabel": "Settings surface",
29
- "promptHint": "Enabled surface id whose settings outlet will host the assistant settings form."
29
+ "promptHint": "Enabled surface id whose settings pages will include the assistant settings section."
30
+ },
31
+ "settings-route-path": {
32
+ "required": false,
33
+ "inputType": "text",
34
+ "defaultValue": "assistant",
35
+ "promptLabel": "Settings route path",
36
+ "promptHint": "Route segment to use for the assistant settings section page."
30
37
  },
31
38
  "config-scope": {
32
39
  "required": true,
@@ -56,6 +63,13 @@
56
63
  "promptLabel": "Menu label",
57
64
  "promptHint": "Menu label for the assistant page entry."
58
65
  },
66
+ "ai-config-prefix": {
67
+ "required": false,
68
+ "inputType": "text",
69
+ "defaultValue": "",
70
+ "promptLabel": "AI config prefix",
71
+ "promptHint": "Optional env/config prefix override. Defaults to <SURFACE>_ASSISTANT."
72
+ },
59
73
  "ai-provider": {
60
74
  "required": true,
61
75
  "defaultValue": "openai",
@@ -67,7 +81,7 @@
67
81
  "allowEmpty": true,
68
82
  "defaultValue": "",
69
83
  "promptLabel": "AI API key",
70
- "promptHint": "Leave empty to keep assistant disabled until you add a key."
84
+ "promptHint": "Leave empty to keep the assistant disabled until you add a key."
71
85
  },
72
86
  "ai-base-url": {
73
87
  "required": true,
@@ -83,7 +97,9 @@
83
97
  "promptHint": "Abort AI requests after this many milliseconds."
84
98
  }
85
99
  },
86
- "dependsOn": [],
100
+ "dependsOn": [
101
+ "@jskit-ai/assistant-runtime"
102
+ ],
87
103
  "capabilities": {
88
104
  "provides": [
89
105
  "assistant-generator"
@@ -99,78 +115,6 @@
99
115
  }
100
116
  },
101
117
  "metadata": {
102
- "generatorPrimarySubcommand": "install",
103
- "generatorSubcommands": {
104
- "install": {
105
- "description": "Generate and install an app-local assistant runtime from explicit surface choices.",
106
- "examples": [
107
- {
108
- "label": "App runtime, console settings, global config",
109
- "lines": [
110
- "npx jskit generate @jskit-ai/assistant install \\",
111
- " --runtime-surface app \\",
112
- " --settings-surface console \\",
113
- " --config-scope global \\",
114
- " --placement shell-layout:primary-menu \\",
115
- " --menu-label Assistant \\",
116
- " --ai-provider openai \\",
117
- " --ai-api-key \"$OPENAI_API_KEY\" \\",
118
- " --ai-base-url \"\" \\",
119
- " --ai-timeout-ms 120000 \\",
120
- " --run-npm-install"
121
- ]
122
- },
123
- {
124
- "label": "App runtime, app settings, global config",
125
- "lines": [
126
- "npx jskit generate @jskit-ai/assistant install \\",
127
- " --runtime-surface app \\",
128
- " --settings-surface app \\",
129
- " --config-scope global \\",
130
- " --placement shell-layout:primary-menu \\",
131
- " --menu-label Assistant \\",
132
- " --ai-provider openai \\",
133
- " --ai-api-key \"$OPENAI_API_KEY\" \\",
134
- " --ai-base-url \"\" \\",
135
- " --ai-timeout-ms 120000 \\",
136
- " --run-npm-install"
137
- ]
138
- },
139
- {
140
- "label": "Workspace runtime, console settings, global config",
141
- "lines": [
142
- "npx jskit generate @jskit-ai/assistant install \\",
143
- " --runtime-surface admin \\",
144
- " --settings-surface console \\",
145
- " --config-scope global \\",
146
- " --placement shell-layout:primary-menu \\",
147
- " --menu-label Assistant \\",
148
- " --ai-provider openai \\",
149
- " --ai-api-key \"$OPENAI_API_KEY\" \\",
150
- " --ai-base-url \"\" \\",
151
- " --ai-timeout-ms 120000 \\",
152
- " --run-npm-install"
153
- ]
154
- },
155
- {
156
- "label": "Workspace runtime, workspace settings, workspace config",
157
- "lines": [
158
- "npx jskit generate @jskit-ai/assistant install \\",
159
- " --runtime-surface admin \\",
160
- " --settings-surface admin \\",
161
- " --config-scope workspace \\",
162
- " --placement shell-layout:primary-menu \\",
163
- " --menu-label Assistant \\",
164
- " --ai-provider openai \\",
165
- " --ai-api-key \"$OPENAI_API_KEY\" \\",
166
- " --ai-base-url \"\" \\",
167
- " --ai-timeout-ms 120000 \\",
168
- " --run-npm-install"
169
- ]
170
- }
171
- ]
172
- }
173
- },
174
118
  "apiSummary": {
175
119
  "surfaces": [
176
120
  {
@@ -186,18 +130,7 @@
186
130
  },
187
131
  "mutations": {
188
132
  "dependencies": {
189
- "runtime": {
190
- "@local/assistant": "file:packages/assistant",
191
- "@jskit-ai/assistant-core": "0.1.5",
192
- "@jskit-ai/database-runtime": "0.1.29",
193
- "@jskit-ai/http-runtime": "0.1.28",
194
- "@jskit-ai/kernel": "0.1.29",
195
- "@jskit-ai/shell-web": "0.1.28",
196
- "@jskit-ai/users-core": "0.1.39",
197
- "@jskit-ai/users-web": "0.1.44",
198
- "@tanstack/vue-query": "^5.90.5",
199
- "vuetify": "^4.0.0"
200
- },
133
+ "runtime": {},
201
134
  "dev": {}
202
135
  },
203
136
  "packageJson": {
@@ -206,235 +139,102 @@
206
139
  "procfile": {},
207
140
  "files": [
208
141
  {
209
- "op": "install-migration",
210
- "from": "templates/migrations/assistant_config_initial.cjs",
211
- "toDir": "migrations",
212
- "extension": ".cjs",
213
- "reason": "Install assistant configuration schema migration.",
214
- "category": "assistant",
215
- "id": "assistant-config-initial-schema",
216
- "templateContext": {
217
- "entrypoint": "src/server/buildTemplateContext.js",
218
- "export": "buildTemplateContext"
219
- }
220
- },
221
- {
222
- "op": "install-migration",
223
- "from": "templates/migrations/assistant_transcripts_initial.cjs",
224
- "toDir": "migrations",
225
- "extension": ".cjs",
226
- "reason": "Install assistant transcript schema migration.",
227
- "category": "assistant",
228
- "id": "assistant-transcripts-initial-schema",
229
- "templateContext": {
230
- "entrypoint": "src/server/buildTemplateContext.js",
231
- "export": "buildTemplateContext"
232
- }
233
- },
234
- {
235
- "from": "templates/src/local-package/package.json",
236
- "to": "packages/assistant/package.json",
237
- "reason": "Install app-local assistant package manifest.",
238
- "category": "assistant",
239
- "id": "assistant-local-package-json"
240
- },
241
- {
242
- "from": "templates/src/local-package/package.descriptor.mjs",
243
- "to": "packages/assistant/package.descriptor.mjs",
244
- "reason": "Install app-local assistant package descriptor.",
245
- "category": "assistant",
246
- "id": "assistant-local-package-descriptor"
247
- },
248
- {
249
- "from": "templates/src/local-package/shared/assistantRuntimeConfig.js",
250
- "to": "packages/assistant/src/shared/assistantRuntimeConfig.js",
251
- "reason": "Install generated assistant runtime configuration.",
252
- "category": "assistant",
253
- "id": "assistant-local-runtime-config",
254
- "templateContext": {
255
- "entrypoint": "src/server/buildTemplateContext.js",
256
- "export": "buildTemplateContext"
257
- }
258
- },
259
- {
260
- "from": "templates/src/local-package/shared/index.js",
261
- "to": "packages/assistant/src/shared/index.js",
262
- "reason": "Install generated assistant shared exports.",
263
- "category": "assistant",
264
- "id": "assistant-local-shared-index"
265
- },
266
- {
267
- "from": "templates/src/local-package/client/index.js",
268
- "to": "packages/assistant/src/client/index.js",
269
- "reason": "Install generated assistant client exports.",
270
- "category": "assistant",
271
- "id": "assistant-local-client-index"
272
- },
273
- {
274
- "from": "templates/src/local-package/client/components/AssistantSurfaceClientElement.vue",
275
- "to": "packages/assistant/src/client/components/AssistantSurfaceClientElement.vue",
276
- "reason": "Install generated assistant surface page component.",
277
- "category": "assistant",
278
- "id": "assistant-local-surface-client-element",
279
- "templateContext": {
280
- "entrypoint": "src/server/buildTemplateContext.js",
281
- "export": "buildTemplateContext"
282
- }
283
- },
284
- {
285
- "from": "templates/src/local-package/client/components/AssistantSettingsClientElement.vue",
286
- "to": "packages/assistant/src/client/components/AssistantSettingsClientElement.vue",
287
- "reason": "Install generated assistant settings form component.",
288
- "category": "assistant",
289
- "id": "assistant-local-settings-client-element",
290
- "templateContext": {
291
- "entrypoint": "src/server/buildTemplateContext.js",
292
- "export": "buildTemplateContext"
293
- }
294
- },
295
- {
296
- "from": "templates/src/local-package/client/composables/useAssistantRuntime.js",
297
- "to": "packages/assistant/src/client/composables/useAssistantRuntime.js",
298
- "reason": "Install generated assistant runtime composable.",
299
- "category": "assistant",
300
- "id": "assistant-local-runtime-composable",
301
- "templateContext": {
302
- "entrypoint": "src/server/buildTemplateContext.js",
303
- "export": "buildTemplateContext"
304
- }
305
- },
306
- {
307
- "from": "templates/src/local-package/client/providers/AssistantClientProvider.js",
308
- "to": "packages/assistant/src/client/providers/AssistantClientProvider.js",
309
- "reason": "Install generated assistant client provider.",
310
- "category": "assistant",
311
- "id": "assistant-local-client-provider"
312
- },
313
- {
314
- "from": "templates/src/local-package/server/AssistantProvider.js",
315
- "to": "packages/assistant/src/server/AssistantProvider.js",
316
- "reason": "Install generated assistant server provider.",
317
- "category": "assistant",
318
- "id": "assistant-local-server-provider",
319
- "templateContext": {
320
- "entrypoint": "src/server/buildTemplateContext.js",
321
- "export": "buildTemplateContext"
322
- }
323
- },
324
- {
325
- "from": "templates/src/local-package/server/actionIds.js",
326
- "to": "packages/assistant/src/server/actionIds.js",
327
- "reason": "Install generated assistant action identifiers.",
328
- "category": "assistant",
329
- "id": "assistant-local-action-ids"
330
- },
331
- {
332
- "from": "templates/src/local-package/server/actions.js",
333
- "to": "packages/assistant/src/server/actions.js",
334
- "reason": "Install generated assistant action definitions.",
335
- "category": "assistant",
336
- "id": "assistant-local-actions",
337
- "templateContext": {
338
- "entrypoint": "src/server/buildTemplateContext.js",
339
- "export": "buildTemplateContext"
340
- }
341
- },
342
- {
343
- "from": "templates/src/local-package/server/registerRoutes.js",
344
- "to": "packages/assistant/src/server/registerRoutes.js",
345
- "reason": "Install generated assistant route registration.",
346
- "category": "assistant",
347
- "id": "assistant-local-register-routes",
348
- "templateContext": {
349
- "entrypoint": "src/server/buildTemplateContext.js",
350
- "export": "buildTemplateContext"
351
- }
352
- },
353
- {
354
- "from": "templates/src/local-package/server/repositories/assistantConfigRepository.js",
355
- "to": "packages/assistant/src/server/repositories/assistantConfigRepository.js",
356
- "reason": "Install generated assistant config repository.",
142
+ "from": "templates/src/pages/assistant/index.vue",
143
+ "toSurface": "${option:surface|lower}",
144
+ "toSurfacePath": "assistant/index.vue",
145
+ "reason": "Install generated assistant runtime page.",
357
146
  "category": "assistant",
358
- "id": "assistant-local-config-repository",
147
+ "id": "assistant-page-runtime",
359
148
  "templateContext": {
360
149
  "entrypoint": "src/server/buildTemplateContext.js",
361
150
  "export": "buildTemplateContext"
362
151
  }
363
152
  },
364
153
  {
365
- "from": "templates/src/local-package/server/repositories/conversationsRepository.js",
366
- "to": "packages/assistant/src/server/repositories/conversationsRepository.js",
367
- "reason": "Install generated assistant conversations repository.",
154
+ "from": "templates/src/pages/settings/assistant/index.vue",
155
+ "toSurface": "${option:settings-surface|lower}",
156
+ "toSurfacePath": "settings/${option:settings-route-path|path}/index.vue",
157
+ "reason": "Install generated assistant settings section page.",
368
158
  "category": "assistant",
369
- "id": "assistant-local-conversations-repository",
159
+ "id": "assistant-page-settings-standard",
160
+ "when": {
161
+ "option": "settings-surface",
162
+ "notEquals": "admin"
163
+ },
370
164
  "templateContext": {
371
165
  "entrypoint": "src/server/buildTemplateContext.js",
372
166
  "export": "buildTemplateContext"
373
167
  }
374
168
  },
375
169
  {
376
- "from": "templates/src/local-package/server/repositories/messagesRepository.js",
377
- "to": "packages/assistant/src/server/repositories/messagesRepository.js",
378
- "reason": "Install generated assistant messages repository.",
170
+ "from": "templates/src/pages/settings/assistant/index.vue",
171
+ "toSurface": "${option:settings-surface|lower}",
172
+ "toSurfacePath": "workspace/settings/${option:settings-route-path|path}/index.vue",
173
+ "reason": "Install generated assistant settings section page.",
379
174
  "category": "assistant",
380
- "id": "assistant-local-messages-repository",
175
+ "id": "assistant-page-settings-admin",
176
+ "when": {
177
+ "option": "settings-surface",
178
+ "equals": "admin"
179
+ },
381
180
  "templateContext": {
382
181
  "entrypoint": "src/server/buildTemplateContext.js",
383
182
  "export": "buildTemplateContext"
384
183
  }
385
- },
184
+ }
185
+ ],
186
+ "text": [
386
187
  {
387
- "from": "templates/src/local-package/server/services/assistantConfigService.js",
388
- "to": "packages/assistant/src/server/services/assistantConfigService.js",
389
- "reason": "Install generated assistant config service.",
188
+ "op": "append-text",
189
+ "file": "src/placement.js",
190
+ "position": "bottom",
191
+ "skipIfContains": "assistant.generated.menu:${option:surface|lower}",
192
+ "value": "\n// assistant.generated.menu:${option:surface|lower}\naddPlacement({\n id: \"assistant.generated.menu.${option:surface|kebab}\",\n host: \"__ASSISTANT_MENU_PLACEMENT_HOST__\",\n position: \"__ASSISTANT_MENU_PLACEMENT_POSITION__\",\n surfaces: [\"${option:surface|lower}\"],\n order: 310,\n componentToken: \"__ASSISTANT_MENU_COMPONENT_TOKEN__\",\n props: {\n label: \"__ASSISTANT_MENU_LABEL__\",\n surface: \"${option:surface|lower}\",\n workspaceSuffix: \"__ASSISTANT_MENU_WORKSPACE_SUFFIX__\",\n nonWorkspaceSuffix: \"__ASSISTANT_MENU_NON_WORKSPACE_SUFFIX__\"\n },\n when: ({ auth }) => Boolean(auth?.authenticated)\n});\n",
193
+ "reason": "Append generated assistant runtime menu placement into app-owned placement registry.",
390
194
  "category": "assistant",
391
- "id": "assistant-local-config-service",
195
+ "id": "assistant-placement-menu",
392
196
  "templateContext": {
393
197
  "entrypoint": "src/server/buildTemplateContext.js",
394
198
  "export": "buildTemplateContext"
395
199
  }
396
200
  },
397
201
  {
398
- "from": "templates/src/local-package/server/services/chatService.js",
399
- "to": "packages/assistant/src/server/services/chatService.js",
400
- "reason": "Install generated assistant chat service.",
202
+ "op": "append-text",
203
+ "file": "src/placement.js",
204
+ "position": "bottom",
205
+ "skipIfContains": "assistant.generated.settings.menu:${option:surface|lower}",
206
+ "value": "\n// assistant.generated.settings.menu:${option:surface|lower}\naddPlacement({\n id: \"assistant.generated.settings.menu.${option:surface|kebab}\",\n host: \"__ASSISTANT_SETTINGS_HOST__\",\n position: \"primary-menu\",\n surfaces: [\"${option:settings-surface|lower}\"],\n order: 250,\n componentToken: \"users.web.shell.surface-aware-menu-link-item\",\n props: {\n label: \"__ASSISTANT_SETTINGS_MENU_LABEL__\",\n surface: \"${option:settings-surface|lower}\",\n workspaceSuffix: \"__ASSISTANT_SETTINGS_MENU_WORKSPACE_SUFFIX__\",\n nonWorkspaceSuffix: \"__ASSISTANT_SETTINGS_MENU_NON_WORKSPACE_SUFFIX__\"\n },\n when: ({ auth }) => Boolean(auth?.authenticated)\n});\n",
207
+ "reason": "Append generated assistant settings section menu placement into app-owned settings placements.",
401
208
  "category": "assistant",
402
- "id": "assistant-local-chat-service",
209
+ "id": "assistant-settings-menu-placement",
403
210
  "templateContext": {
404
211
  "entrypoint": "src/server/buildTemplateContext.js",
405
212
  "export": "buildTemplateContext"
406
213
  }
407
214
  },
408
215
  {
409
- "from": "templates/src/local-package/server/services/transcriptService.js",
410
- "to": "packages/assistant/src/server/services/transcriptService.js",
411
- "reason": "Install generated assistant transcript service.",
216
+ "op": "append-text",
217
+ "file": "config/public.js",
218
+ "position": "bottom",
219
+ "skipIfContains": "config.assistantSurfaces.${option:surface|lower} = {",
220
+ "value": "\nconfig.assistantSurfaces.${option:surface|lower} = {\n settingsSurfaceId: \"__ASSISTANT_SETTINGS_SURFACE_ID__\",\n configScope: \"__ASSISTANT_CONFIG_SCOPE__\"\n};\n",
221
+ "reason": "Register the generated assistant surface in public app config.",
412
222
  "category": "assistant",
413
- "id": "assistant-local-transcript-service",
223
+ "id": "assistant-public-surface-config",
414
224
  "templateContext": {
415
225
  "entrypoint": "src/server/buildTemplateContext.js",
416
226
  "export": "buildTemplateContext"
417
227
  }
418
228
  },
419
- {
420
- "from": "templates/src/pages/assistant/index.vue",
421
- "toSurface": "${option:runtime-surface|lower}",
422
- "toSurfacePath": "assistant/index.vue",
423
- "reason": "Install generated assistant runtime page.",
424
- "category": "assistant",
425
- "id": "assistant-page-runtime"
426
- }
427
- ],
428
- "text": [
429
229
  {
430
230
  "op": "append-text",
431
- "file": "src/placement.js",
231
+ "file": "config/server.js",
432
232
  "position": "bottom",
433
- "skipIfContains": "id: \"assistant.generated.menu\"",
434
- "value": "\naddPlacement({\n id: \"assistant.generated.menu\",\n host: \"__ASSISTANT_MENU_PLACEMENT_HOST__\",\n position: \"__ASSISTANT_MENU_PLACEMENT_POSITION__\",\n surfaces: [\"${option:runtime-surface|lower}\"],\n order: 310,\n componentToken: \"__ASSISTANT_MENU_COMPONENT_TOKEN__\",\n props: {\n label: \"__ASSISTANT_MENU_LABEL__\",\n surface: \"${option:runtime-surface|lower}\",\n workspaceSuffix: \"__ASSISTANT_MENU_WORKSPACE_SUFFIX__\",\n nonWorkspaceSuffix: \"__ASSISTANT_MENU_NON_WORKSPACE_SUFFIX__\"\n },\n when: ({ auth }) => Boolean(auth?.authenticated)\n});\n",
435
- "reason": "Append generated assistant runtime menu placement into app-owned placement registry.",
233
+ "skipIfContains": "config.assistantServer.${option:surface|lower} = {",
234
+ "value": "\nconfig.assistantServer.${option:surface|lower} = {\n aiConfigPrefix: \"__ASSISTANT_AI_CONFIG_PREFIX__\"\n};\n",
235
+ "reason": "Register generated assistant server config for the selected surface.",
436
236
  "category": "assistant",
437
- "id": "assistant-placement-menu",
237
+ "id": "assistant-server-surface-config",
438
238
  "templateContext": {
439
239
  "entrypoint": "src/server/buildTemplateContext.js",
440
240
  "export": "buildTemplateContext"
@@ -442,53 +242,17 @@
442
242
  },
443
243
  {
444
244
  "op": "append-text",
445
- "file": "src/placement.js",
245
+ "file": ".env",
446
246
  "position": "bottom",
447
- "skipIfContains": "id: \"assistant.generated.settings.form\"",
448
- "value": "\naddPlacement({\n id: \"assistant.generated.settings.form\",\n host: \"__ASSISTANT_SETTINGS_HOST__\",\n position: \"forms\",\n surfaces: [\"${option:settings-surface|lower}\"],\n order: 250,\n componentToken: \"assistant.web.settings.element\",\n when: ({ auth }) => Boolean(auth?.authenticated)\n});\n",
449
- "reason": "Append generated assistant settings form placement into app-owned settings placements.",
450
- "category": "assistant",
451
- "id": "assistant-settings-form-placement",
247
+ "skipIfContains": "__ASSISTANT_AI_CONFIG_PREFIX___AI_PROVIDER=",
248
+ "value": "\n__ASSISTANT_AI_CONFIG_PREFIX___AI_PROVIDER=${option:ai-provider}\n__ASSISTANT_AI_CONFIG_PREFIX___AI_API_KEY=${option:ai-api-key}\n__ASSISTANT_AI_CONFIG_PREFIX___AI_BASE_URL=${option:ai-base-url}\n__ASSISTANT_AI_CONFIG_PREFIX___AI_TIMEOUT_MS=${option:ai-timeout-ms}\n",
249
+ "reason": "Append assistant AI env defaults for the generated surface prefix.",
250
+ "category": "runtime-config",
251
+ "id": "assistant-ai-prefixed-env",
452
252
  "templateContext": {
453
253
  "entrypoint": "src/server/buildTemplateContext.js",
454
254
  "export": "buildTemplateContext"
455
255
  }
456
- },
457
- {
458
- "file": ".env",
459
- "op": "upsert-env",
460
- "key": "AI_PROVIDER",
461
- "value": "${option:ai-provider}",
462
- "reason": "Configure assistant AI provider id.",
463
- "category": "runtime-config",
464
- "id": "assistant-ai-provider"
465
- },
466
- {
467
- "file": ".env",
468
- "op": "upsert-env",
469
- "key": "AI_API_KEY",
470
- "value": "${option:ai-api-key}",
471
- "reason": "Configure assistant AI API key.",
472
- "category": "runtime-config",
473
- "id": "assistant-ai-api-key"
474
- },
475
- {
476
- "file": ".env",
477
- "op": "upsert-env",
478
- "key": "AI_BASE_URL",
479
- "value": "${option:ai-base-url}",
480
- "reason": "Configure assistant AI base URL override.",
481
- "category": "runtime-config",
482
- "id": "assistant-ai-base-url"
483
- },
484
- {
485
- "file": ".env",
486
- "op": "upsert-env",
487
- "key": "AI_TIMEOUT_MS",
488
- "value": "${option:ai-timeout-ms}",
489
- "reason": "Configure assistant AI timeout in milliseconds.",
490
- "category": "runtime-config",
491
- "id": "assistant-ai-timeout-ms"
492
256
  }
493
257
  ]
494
258
  }
@@ -496,11 +260,11 @@
496
260
  },
497
261
  {
498
262
  "packageId": "@jskit-ai/assistant-core",
499
- "version": "0.1.5",
263
+ "version": "0.1.7",
500
264
  "descriptor": {
501
265
  "packageVersion": 1,
502
266
  "packageId": "@jskit-ai/assistant-core",
503
- "version": "0.1.5",
267
+ "version": "0.1.7",
504
268
  "kind": "runtime",
505
269
  "description": "Reusable assistant client/server/shared primitives without surface-specific routes or settings ownership.",
506
270
  "dependsOn": [
@@ -546,9 +310,9 @@
546
310
  "mutations": {
547
311
  "dependencies": {
548
312
  "runtime": {
549
- "@jskit-ai/http-runtime": "0.1.28",
550
- "@jskit-ai/kernel": "0.1.29",
551
- "@jskit-ai/users-core": "0.1.39",
313
+ "@jskit-ai/http-runtime": "0.1.30",
314
+ "@jskit-ai/kernel": "0.1.31",
315
+ "@jskit-ai/users-core": "0.1.41",
552
316
  "@tanstack/vue-query": "^5.90.5",
553
317
  "dompurify": "^3.3.3",
554
318
  "marked": "^17.0.4",
@@ -567,13 +331,155 @@
567
331
  }
568
332
  }
569
333
  },
334
+ {
335
+ "packageId": "@jskit-ai/assistant-runtime",
336
+ "version": "0.1.2",
337
+ "descriptor": {
338
+ "packageVersion": 1,
339
+ "packageId": "@jskit-ai/assistant-runtime",
340
+ "version": "0.1.2",
341
+ "kind": "runtime",
342
+ "description": "Shared assistant runtime with per-surface assistant registration.",
343
+ "dependsOn": [
344
+ "@jskit-ai/assistant-core",
345
+ "@jskit-ai/database-runtime",
346
+ "@jskit-ai/http-runtime",
347
+ "@jskit-ai/shell-web",
348
+ "@jskit-ai/users-core",
349
+ "@jskit-ai/users-web"
350
+ ],
351
+ "capabilities": {
352
+ "provides": [
353
+ "assistant.runtime"
354
+ ],
355
+ "requires": [
356
+ "runtime.actions",
357
+ "runtime.database",
358
+ "auth.policy",
359
+ "runtime.http-client",
360
+ "users.core",
361
+ "users.web"
362
+ ]
363
+ },
364
+ "runtime": {
365
+ "server": {
366
+ "providers": [
367
+ {
368
+ "entrypoint": "src/server/AssistantProvider.js",
369
+ "export": "AssistantProvider"
370
+ }
371
+ ]
372
+ },
373
+ "client": {
374
+ "providers": [
375
+ {
376
+ "entrypoint": "src/client/providers/AssistantClientProvider.js",
377
+ "export": "AssistantClientProvider"
378
+ }
379
+ ]
380
+ }
381
+ },
382
+ "metadata": {
383
+ "apiSummary": {
384
+ "surfaces": [
385
+ {
386
+ "subpath": "./client",
387
+ "summary": "Exports assistant runtime client elements and composables."
388
+ },
389
+ {
390
+ "subpath": "./shared",
391
+ "summary": "Exports assistant runtime shared config helpers."
392
+ },
393
+ {
394
+ "subpath": "./server/actionIds",
395
+ "summary": "Exports assistant runtime action identifiers."
396
+ }
397
+ ],
398
+ "containerTokens": {
399
+ "server": [
400
+ "assistant.config.repository",
401
+ "assistant.conversation.repository",
402
+ "assistant.message.repository",
403
+ "assistant.ai.client.factory",
404
+ "assistant.service.tool-catalog"
405
+ ],
406
+ "client": [
407
+ "assistant.web.settings.element"
408
+ ]
409
+ }
410
+ }
411
+ },
412
+ "mutations": {
413
+ "dependencies": {
414
+ "runtime": {
415
+ "@jskit-ai/assistant-core": "0.1.7",
416
+ "@jskit-ai/database-runtime": "0.1.31",
417
+ "@jskit-ai/http-runtime": "0.1.30",
418
+ "@jskit-ai/kernel": "0.1.31",
419
+ "@jskit-ai/shell-web": "0.1.30",
420
+ "@jskit-ai/users-core": "0.1.41",
421
+ "@jskit-ai/users-web": "0.1.46",
422
+ "@tanstack/vue-query": "^5.90.5",
423
+ "vuetify": "^4.0.0"
424
+ },
425
+ "dev": {}
426
+ },
427
+ "packageJson": {
428
+ "scripts": {}
429
+ },
430
+ "procfile": {},
431
+ "files": [
432
+ {
433
+ "op": "install-migration",
434
+ "from": "templates/migrations/assistant_config_initial.cjs",
435
+ "toDir": "migrations",
436
+ "extension": ".cjs",
437
+ "reason": "Install assistant configuration schema migration.",
438
+ "category": "assistant-runtime",
439
+ "id": "assistant-runtime-config-initial-schema"
440
+ },
441
+ {
442
+ "op": "install-migration",
443
+ "from": "templates/migrations/assistant_transcripts_initial.cjs",
444
+ "toDir": "migrations",
445
+ "extension": ".cjs",
446
+ "reason": "Install assistant transcript schema migration.",
447
+ "category": "assistant-runtime",
448
+ "id": "assistant-runtime-transcripts-initial-schema"
449
+ }
450
+ ],
451
+ "text": [
452
+ {
453
+ "op": "append-text",
454
+ "file": "config/public.js",
455
+ "position": "bottom",
456
+ "skipIfContains": "config.assistantSurfaces ||= {};",
457
+ "value": "\nconfig.assistantSurfaces ||= {};\n",
458
+ "reason": "Initialize the shared assistant surface registry in public app config.",
459
+ "category": "assistant-runtime",
460
+ "id": "assistant-runtime-public-surface-registry-init"
461
+ },
462
+ {
463
+ "op": "append-text",
464
+ "file": "config/server.js",
465
+ "position": "bottom",
466
+ "skipIfContains": "config.assistantServer ||= {};",
467
+ "value": "\nconfig.assistantServer ||= {};\n",
468
+ "reason": "Initialize the shared assistant server config registry.",
469
+ "category": "assistant-runtime",
470
+ "id": "assistant-runtime-server-surface-registry-init"
471
+ }
472
+ ]
473
+ }
474
+ }
475
+ },
570
476
  {
571
477
  "packageId": "@jskit-ai/auth-core",
572
- "version": "0.1.28",
478
+ "version": "0.1.30",
573
479
  "descriptor": {
574
480
  "packageVersion": 1,
575
481
  "packageId": "@jskit-ai/auth-core",
576
- "version": "0.1.28",
482
+ "version": "0.1.30",
577
483
  "kind": "runtime",
578
484
  "dependsOn": [
579
485
  "@jskit-ai/value-app-config-shared"
@@ -641,7 +547,7 @@
641
547
  "mutations": {
642
548
  "dependencies": {
643
549
  "runtime": {
644
- "@jskit-ai/kernel": "0.1.29",
550
+ "@jskit-ai/kernel": "0.1.31",
645
551
  "@fastify/cookie": "^11.0.2",
646
552
  "@fastify/csrf-protection": "^7.1.0",
647
553
  "@fastify/rate-limit": "^10.3.0"
@@ -659,11 +565,11 @@
659
565
  },
660
566
  {
661
567
  "packageId": "@jskit-ai/auth-provider-supabase-core",
662
- "version": "0.1.28",
568
+ "version": "0.1.30",
663
569
  "descriptor": {
664
570
  "packageVersion": 1,
665
571
  "packageId": "@jskit-ai/auth-provider-supabase-core",
666
- "version": "0.1.28",
572
+ "version": "0.1.30",
667
573
  "kind": "runtime",
668
574
  "options": {
669
575
  "auth-supabase-url": {
@@ -745,8 +651,8 @@
745
651
  "mutations": {
746
652
  "dependencies": {
747
653
  "runtime": {
748
- "@jskit-ai/auth-core": "0.1.28",
749
- "@jskit-ai/kernel": "0.1.29",
654
+ "@jskit-ai/auth-core": "0.1.30",
655
+ "@jskit-ai/kernel": "0.1.31",
750
656
  "dotenv": "^16.4.5",
751
657
  "@supabase/supabase-js": "^2.57.4",
752
658
  "jose": "^6.1.0"
@@ -811,11 +717,11 @@
811
717
  },
812
718
  {
813
719
  "packageId": "@jskit-ai/auth-web",
814
- "version": "0.1.30",
720
+ "version": "0.1.32",
815
721
  "descriptor": {
816
722
  "packageVersion": 1,
817
723
  "packageId": "@jskit-ai/auth-web",
818
- "version": "0.1.30",
724
+ "version": "0.1.32",
819
725
  "kind": "runtime",
820
726
  "description": "Auth web module: Fastify auth routes plus web login/sign-out scaffolds.",
821
727
  "dependsOn": [
@@ -1045,10 +951,10 @@
1045
951
  "@tanstack/vue-query": "5.92.12",
1046
952
  "@mdi/js": "^7.4.47",
1047
953
  "@fastify/type-provider-typebox": "^6.1.0",
1048
- "@jskit-ai/auth-core": "0.1.28",
1049
- "@jskit-ai/http-runtime": "0.1.28",
1050
- "@jskit-ai/kernel": "0.1.29",
1051
- "@jskit-ai/shell-web": "0.1.28",
954
+ "@jskit-ai/auth-core": "0.1.30",
955
+ "@jskit-ai/http-runtime": "0.1.30",
956
+ "@jskit-ai/kernel": "0.1.31",
957
+ "@jskit-ai/shell-web": "0.1.30",
1052
958
  "vuetify": "^4.0.0"
1053
959
  },
1054
960
  "dev": {}
@@ -1118,11 +1024,11 @@
1118
1024
  },
1119
1025
  {
1120
1026
  "packageId": "@jskit-ai/crud-core",
1121
- "version": "0.1.37",
1027
+ "version": "0.1.39",
1122
1028
  "descriptor": {
1123
1029
  "packageVersion": 1,
1124
1030
  "packageId": "@jskit-ai/crud-core",
1125
- "version": "0.1.37",
1031
+ "version": "0.1.39",
1126
1032
  "kind": "runtime",
1127
1033
  "description": "Shared CRUD helpers used by CRUD modules.",
1128
1034
  "dependsOn": [
@@ -1149,7 +1055,7 @@
1149
1055
  "mutations": {
1150
1056
  "dependencies": {
1151
1057
  "runtime": {
1152
- "@jskit-ai/crud-core": "0.1.37"
1058
+ "@jskit-ai/crud-core": "0.1.39"
1153
1059
  },
1154
1060
  "dev": {}
1155
1061
  },
@@ -1163,11 +1069,11 @@
1163
1069
  },
1164
1070
  {
1165
1071
  "packageId": "@jskit-ai/crud-server-generator",
1166
- "version": "0.1.37",
1072
+ "version": "0.1.39",
1167
1073
  "descriptor": {
1168
1074
  "packageVersion": 1,
1169
1075
  "packageId": "@jskit-ai/crud-server-generator",
1170
- "version": "0.1.37",
1076
+ "version": "0.1.39",
1171
1077
  "kind": "generator",
1172
1078
  "description": "CRUD server generator with routes, actions, and persistence scaffolding.",
1173
1079
  "options": {
@@ -1302,13 +1208,13 @@
1302
1208
  "mutations": {
1303
1209
  "dependencies": {
1304
1210
  "runtime": {
1305
- "@jskit-ai/auth-core": "0.1.28",
1306
- "@jskit-ai/crud-core": "0.1.37",
1307
- "@jskit-ai/database-runtime": "0.1.29",
1308
- "@jskit-ai/http-runtime": "0.1.28",
1309
- "@jskit-ai/kernel": "0.1.29",
1310
- "@jskit-ai/realtime": "0.1.28",
1311
- "@jskit-ai/users-core": "0.1.39",
1211
+ "@jskit-ai/auth-core": "0.1.30",
1212
+ "@jskit-ai/crud-core": "0.1.39",
1213
+ "@jskit-ai/database-runtime": "0.1.31",
1214
+ "@jskit-ai/http-runtime": "0.1.30",
1215
+ "@jskit-ai/kernel": "0.1.31",
1216
+ "@jskit-ai/realtime": "0.1.30",
1217
+ "@jskit-ai/users-core": "0.1.41",
1312
1218
  "@local/${option:namespace|kebab}": "file:packages/${option:namespace|kebab}",
1313
1219
  "typebox": "^1.0.81"
1314
1220
  },
@@ -1432,11 +1338,11 @@
1432
1338
  },
1433
1339
  {
1434
1340
  "packageId": "@jskit-ai/crud-ui-generator",
1435
- "version": "0.1.12",
1341
+ "version": "0.1.14",
1436
1342
  "descriptor": {
1437
1343
  "packageVersion": 1,
1438
1344
  "packageId": "@jskit-ai/crud-ui-generator",
1439
- "version": "0.1.12",
1345
+ "version": "0.1.14",
1440
1346
  "kind": "generator",
1441
1347
  "description": "Generate app-local CRUD UI scaffolds from resource validators.",
1442
1348
  "options": {
@@ -1570,7 +1476,7 @@
1570
1476
  "mutations": {
1571
1477
  "dependencies": {
1572
1478
  "runtime": {
1573
- "@jskit-ai/users-web": "0.1.44"
1479
+ "@jskit-ai/users-web": "0.1.46"
1574
1480
  },
1575
1481
  "dev": {}
1576
1482
  },
@@ -1843,11 +1749,11 @@
1843
1749
  },
1844
1750
  {
1845
1751
  "packageId": "@jskit-ai/database-runtime",
1846
- "version": "0.1.29",
1752
+ "version": "0.1.31",
1847
1753
  "descriptor": {
1848
1754
  "packageVersion": 1,
1849
1755
  "packageId": "@jskit-ai/database-runtime",
1850
- "version": "0.1.29",
1756
+ "version": "0.1.31",
1851
1757
  "kind": "runtime",
1852
1758
  "dependsOn": [
1853
1759
  "@jskit-ai/kernel"
@@ -1904,7 +1810,7 @@
1904
1810
  "mutations": {
1905
1811
  "dependencies": {
1906
1812
  "runtime": {
1907
- "@jskit-ai/kernel": "0.1.29",
1813
+ "@jskit-ai/kernel": "0.1.31",
1908
1814
  "dotenv": "^16.4.5",
1909
1815
  "knex": "^3.1.0"
1910
1816
  },
@@ -1939,11 +1845,11 @@
1939
1845
  },
1940
1846
  {
1941
1847
  "packageId": "@jskit-ai/database-runtime-mysql",
1942
- "version": "0.1.28",
1848
+ "version": "0.1.30",
1943
1849
  "descriptor": {
1944
1850
  "packageVersion": 1,
1945
1851
  "packageId": "@jskit-ai/database-runtime-mysql",
1946
- "version": "0.1.28",
1852
+ "version": "0.1.30",
1947
1853
  "kind": "runtime",
1948
1854
  "options": {
1949
1855
  "db-host": {
@@ -2033,7 +1939,7 @@
2033
1939
  "mutations": {
2034
1940
  "dependencies": {
2035
1941
  "runtime": {
2036
- "@jskit-ai/database-runtime": "0.1.29",
1942
+ "@jskit-ai/database-runtime": "0.1.31",
2037
1943
  "mysql2": "^3.11.2"
2038
1944
  },
2039
1945
  "dev": {}
@@ -2104,11 +2010,11 @@
2104
2010
  },
2105
2011
  {
2106
2012
  "packageId": "@jskit-ai/database-runtime-postgres",
2107
- "version": "0.1.28",
2013
+ "version": "0.1.30",
2108
2014
  "descriptor": {
2109
2015
  "packageVersion": 1,
2110
2016
  "packageId": "@jskit-ai/database-runtime-postgres",
2111
- "version": "0.1.28",
2017
+ "version": "0.1.30",
2112
2018
  "kind": "runtime",
2113
2019
  "options": {
2114
2020
  "db-host": {
@@ -2198,7 +2104,7 @@
2198
2104
  "mutations": {
2199
2105
  "dependencies": {
2200
2106
  "runtime": {
2201
- "@jskit-ai/database-runtime": "0.1.29",
2107
+ "@jskit-ai/database-runtime": "0.1.31",
2202
2108
  "pg": "^8.13.1"
2203
2109
  },
2204
2110
  "dev": {}
@@ -2269,11 +2175,11 @@
2269
2175
  },
2270
2176
  {
2271
2177
  "packageId": "@jskit-ai/http-runtime",
2272
- "version": "0.1.28",
2178
+ "version": "0.1.30",
2273
2179
  "descriptor": {
2274
2180
  "packageVersion": 1,
2275
2181
  "packageId": "@jskit-ai/http-runtime",
2276
- "version": "0.1.28",
2182
+ "version": "0.1.30",
2277
2183
  "kind": "runtime",
2278
2184
  "dependsOn": [],
2279
2185
  "capabilities": {
@@ -2339,7 +2245,7 @@
2339
2245
  "mutations": {
2340
2246
  "dependencies": {
2341
2247
  "runtime": {
2342
- "@jskit-ai/kernel": "0.1.29",
2248
+ "@jskit-ai/kernel": "0.1.31",
2343
2249
  "@fastify/type-provider-typebox": "^6.1.0",
2344
2250
  "typebox": "^1.0.81"
2345
2251
  },
@@ -2355,11 +2261,11 @@
2355
2261
  },
2356
2262
  {
2357
2263
  "packageId": "@jskit-ai/realtime",
2358
- "version": "0.1.28",
2264
+ "version": "0.1.30",
2359
2265
  "descriptor": {
2360
2266
  "packageVersion": 1,
2361
2267
  "packageId": "@jskit-ai/realtime",
2362
- "version": "0.1.28",
2268
+ "version": "0.1.30",
2363
2269
  "kind": "runtime",
2364
2270
  "description": "Thin, generic realtime runtime wrappers for socket.io server and client.",
2365
2271
  "options": {
@@ -2455,7 +2361,7 @@
2455
2361
  "mutations": {
2456
2362
  "dependencies": {
2457
2363
  "runtime": {
2458
- "@jskit-ai/kernel": "0.1.29",
2364
+ "@jskit-ai/kernel": "0.1.31",
2459
2365
  "@socket.io/redis-adapter": "^8.3.0",
2460
2366
  "redis": "^5.8.2",
2461
2367
  "socket.io": "^4.8.3",
@@ -2504,11 +2410,11 @@
2504
2410
  },
2505
2411
  {
2506
2412
  "packageId": "@jskit-ai/shell-web",
2507
- "version": "0.1.28",
2413
+ "version": "0.1.30",
2508
2414
  "descriptor": {
2509
2415
  "packageVersion": 1,
2510
2416
  "packageId": "@jskit-ai/shell-web",
2511
- "version": "0.1.28",
2417
+ "version": "0.1.30",
2512
2418
  "kind": "runtime",
2513
2419
  "description": "Web shell layout runtime with outlet-based placement contributions.",
2514
2420
  "dependsOn": [],
@@ -2599,15 +2505,7 @@
2599
2505
  "surfaces": [
2600
2506
  "home"
2601
2507
  ],
2602
- "source": "templates/src/pages/home/settings/index.vue"
2603
- },
2604
- {
2605
- "host": "home-settings",
2606
- "position": "forms",
2607
- "surfaces": [
2608
- "home"
2609
- ],
2610
- "source": "templates/src/pages/home/settings/index.vue"
2508
+ "source": "templates/src/pages/home/settings.vue"
2611
2509
  }
2612
2510
  ],
2613
2511
  "contributions": []
@@ -2618,7 +2516,7 @@
2618
2516
  "dependencies": {
2619
2517
  "runtime": {
2620
2518
  "@tanstack/vue-query": "^5.90.5",
2621
- "@jskit-ai/kernel": "0.1.29",
2519
+ "@jskit-ai/kernel": "0.1.31",
2622
2520
  "vuetify": "^4.0.0"
2623
2521
  },
2624
2522
  "dev": {}
@@ -2677,11 +2575,19 @@
2677
2575
  "category": "shell-web",
2678
2576
  "id": "shell-web-page-home"
2679
2577
  },
2578
+ {
2579
+ "from": "templates/src/pages/home/settings.vue",
2580
+ "toSurface": "home",
2581
+ "toSurfacePath": "settings.vue",
2582
+ "reason": "Install shell-driven home settings shell route with section navigation.",
2583
+ "category": "shell-web",
2584
+ "id": "shell-web-page-home-settings-shell"
2585
+ },
2680
2586
  {
2681
2587
  "from": "templates/src/pages/home/settings/index.vue",
2682
2588
  "toSurface": "home",
2683
2589
  "toSurfacePath": "settings/index.vue",
2684
- "reason": "Install shell-driven home settings page scaffold with surface-derived settings outlets.",
2590
+ "reason": "Install shell-driven home settings landing page scaffold.",
2685
2591
  "category": "shell-web",
2686
2592
  "id": "shell-web-page-home-settings"
2687
2593
  },
@@ -2707,11 +2613,11 @@
2707
2613
  },
2708
2614
  {
2709
2615
  "packageId": "@jskit-ai/storage-runtime",
2710
- "version": "0.1.28",
2616
+ "version": "0.1.30",
2711
2617
  "descriptor": {
2712
2618
  "packageVersion": 1,
2713
2619
  "packageId": "@jskit-ai/storage-runtime",
2714
- "version": "0.1.28",
2620
+ "version": "0.1.30",
2715
2621
  "kind": "runtime",
2716
2622
  "dependsOn": [
2717
2623
  "@jskit-ai/kernel"
@@ -2760,7 +2666,7 @@
2760
2666
  "mutations": {
2761
2667
  "dependencies": {
2762
2668
  "runtime": {
2763
- "@jskit-ai/kernel": "0.1.29",
2669
+ "@jskit-ai/kernel": "0.1.31",
2764
2670
  "unstorage": "^1.17.3"
2765
2671
  },
2766
2672
  "dev": {}
@@ -2776,11 +2682,11 @@
2776
2682
  },
2777
2683
  {
2778
2684
  "packageId": "@jskit-ai/ui-generator",
2779
- "version": "0.1.12",
2685
+ "version": "0.1.14",
2780
2686
  "descriptor": {
2781
2687
  "packageVersion": 1,
2782
2688
  "packageId": "@jskit-ai/ui-generator",
2783
- "version": "0.1.12",
2689
+ "version": "0.1.14",
2784
2690
  "kind": "generator",
2785
2691
  "description": "Generate app-local non-CRUD UI pages and outlet elements.",
2786
2692
  "options": {
@@ -2954,7 +2860,7 @@
2954
2860
  "mutations": {
2955
2861
  "dependencies": {
2956
2862
  "runtime": {
2957
- "@jskit-ai/users-web": "0.1.44"
2863
+ "@jskit-ai/users-web": "0.1.46"
2958
2864
  },
2959
2865
  "dev": {}
2960
2866
  },
@@ -2978,7 +2884,7 @@
2978
2884
  "file": "src/placement.js",
2979
2885
  "position": "bottom",
2980
2886
  "skipIfContains": "jskit:ui-generator.page.menu:${option:surface|lower}:${option:directory-prefix|path}:${option:name|path}",
2981
- "value": "\n// jskit:ui-generator.page.menu:${option:surface|lower}:${option:directory-prefix|path}:${option:name|path}\n{\n addPlacement({\n id: \"ui-generator.page.${option:name|kebab}.menu\",\n host: \"__JSKIT_UI_MENU_PLACEMENT_HOST__\",\n position: \"__JSKIT_UI_MENU_PLACEMENT_POSITION__\",\n surfaces: [\"${option:surface|lower}\"],\n order: 155,\n componentToken: \"__JSKIT_UI_MENU_COMPONENT_TOKEN__\",\n props: {\n label: \"${option:name|trim}\",\n surface: \"${option:surface|lower}\",\n workspaceSuffix: \"__JSKIT_UI_MENU_WORKSPACE_SUFFIX__\",\n nonWorkspaceSuffix: \"__JSKIT_UI_MENU_NON_WORKSPACE_SUFFIX__\",\n__JSKIT_UI_MENU_TO_PROP_LINE__ },\n when: ({ auth }) => Boolean(auth?.authenticated)\n });\n}\n",
2887
+ "value": "\n// jskit:ui-generator.page.menu:${option:surface|lower}:${option:directory-prefix|path}:${option:name|path}\n{\n addPlacement({\n id: \"__JSKIT_UI_MENU_PLACEMENT_ID__\",\n host: \"__JSKIT_UI_MENU_PLACEMENT_HOST__\",\n position: \"__JSKIT_UI_MENU_PLACEMENT_POSITION__\",\n surfaces: [\"${option:surface|lower}\"],\n order: 155,\n componentToken: \"__JSKIT_UI_MENU_COMPONENT_TOKEN__\",\n props: {\n label: \"${option:name|trim}\",\n surface: \"${option:surface|lower}\",\n workspaceSuffix: \"__JSKIT_UI_MENU_WORKSPACE_SUFFIX__\",\n nonWorkspaceSuffix: \"__JSKIT_UI_MENU_NON_WORKSPACE_SUFFIX__\",\n__JSKIT_UI_MENU_TO_PROP_LINE__ },\n when: ({ auth }) => Boolean(auth?.authenticated)\n });\n}\n",
2982
2888
  "reason": "Append generated UI page menu placement.",
2983
2889
  "category": "ui-generator",
2984
2890
  "id": "ui-generator-page-placement-menu-${option:name|snake}",
@@ -2993,11 +2899,11 @@
2993
2899
  },
2994
2900
  {
2995
2901
  "packageId": "@jskit-ai/uploads-image-web",
2996
- "version": "0.1.7",
2902
+ "version": "0.1.9",
2997
2903
  "descriptor": {
2998
2904
  "packageVersion": 1,
2999
2905
  "packageId": "@jskit-ai/uploads-image-web",
3000
- "version": "0.1.7",
2906
+ "version": "0.1.9",
3001
2907
  "kind": "runtime",
3002
2908
  "description": "Reusable client-side image upload runtime with pre-upload image editing.",
3003
2909
  "dependsOn": [
@@ -3061,7 +2967,7 @@
3061
2967
  "mutations": {
3062
2968
  "dependencies": {
3063
2969
  "runtime": {
3064
- "@jskit-ai/uploads-runtime": "0.1.7",
2970
+ "@jskit-ai/uploads-runtime": "0.1.9",
3065
2971
  "@uppy/compressor": "^3.1.0",
3066
2972
  "@uppy/core": "^5.2.0",
3067
2973
  "@uppy/dashboard": "^5.1.1",
@@ -3081,11 +2987,11 @@
3081
2987
  },
3082
2988
  {
3083
2989
  "packageId": "@jskit-ai/uploads-runtime",
3084
- "version": "0.1.7",
2990
+ "version": "0.1.9",
3085
2991
  "descriptor": {
3086
2992
  "packageVersion": 1,
3087
2993
  "packageId": "@jskit-ai/uploads-runtime",
3088
- "version": "0.1.7",
2994
+ "version": "0.1.9",
3089
2995
  "kind": "runtime",
3090
2996
  "description": "Reusable upload runtime primitives for multipart parsing, policy validation, and blob storage.",
3091
2997
  "dependsOn": [
@@ -3155,7 +3061,7 @@
3155
3061
  "dependencies": {
3156
3062
  "runtime": {
3157
3063
  "@fastify/multipart": "^9.4.0",
3158
- "@jskit-ai/kernel": "0.1.29"
3064
+ "@jskit-ai/kernel": "0.1.31"
3159
3065
  },
3160
3066
  "dev": {}
3161
3067
  },
@@ -3170,11 +3076,11 @@
3170
3076
  },
3171
3077
  {
3172
3078
  "packageId": "@jskit-ai/users-core",
3173
- "version": "0.1.39",
3079
+ "version": "0.1.41",
3174
3080
  "descriptor": {
3175
3081
  "packageVersion": 1,
3176
3082
  "packageId": "@jskit-ai/users-core",
3177
- "version": "0.1.39",
3083
+ "version": "0.1.41",
3178
3084
  "kind": "runtime",
3179
3085
  "description": "Users/account runtime plus HTTP routes for account and console features.",
3180
3086
  "dependsOn": [
@@ -3310,11 +3216,11 @@
3310
3216
  "mutations": {
3311
3217
  "dependencies": {
3312
3218
  "runtime": {
3313
- "@jskit-ai/auth-core": "0.1.28",
3314
- "@jskit-ai/database-runtime": "0.1.29",
3315
- "@jskit-ai/http-runtime": "0.1.28",
3316
- "@jskit-ai/kernel": "0.1.29",
3317
- "@jskit-ai/uploads-runtime": "0.1.7",
3219
+ "@jskit-ai/auth-core": "0.1.30",
3220
+ "@jskit-ai/database-runtime": "0.1.31",
3221
+ "@jskit-ai/http-runtime": "0.1.30",
3222
+ "@jskit-ai/kernel": "0.1.31",
3223
+ "@jskit-ai/uploads-runtime": "0.1.9",
3318
3224
  "@fastify/type-provider-typebox": "^6.1.0",
3319
3225
  "typebox": "^1.0.81"
3320
3226
  },
@@ -3425,11 +3331,11 @@
3425
3331
  },
3426
3332
  {
3427
3333
  "packageId": "@jskit-ai/users-web",
3428
- "version": "0.1.44",
3334
+ "version": "0.1.46",
3429
3335
  "descriptor": {
3430
3336
  "packageVersion": 1,
3431
3337
  "packageId": "@jskit-ai/users-web",
3432
- "version": "0.1.44",
3338
+ "version": "0.1.46",
3433
3339
  "kind": "runtime",
3434
3340
  "description": "Users web module: account/profile UI plus shared shell link components.",
3435
3341
  "dependsOn": [
@@ -3475,6 +3381,14 @@
3475
3381
  "subpath": "./client/components/ProfileClientElement",
3476
3382
  "summary": "Exports profile settings client element scaffold component."
3477
3383
  },
3384
+ {
3385
+ "subpath": "./client/components/ConsoleSettingsClientElement",
3386
+ "summary": "Exports console settings landing-page client element."
3387
+ },
3388
+ {
3389
+ "subpath": "./client/components/WorkspaceSettingsClientElement",
3390
+ "summary": "Exports workspace settings client element."
3391
+ },
3478
3392
  {
3479
3393
  "subpath": "./client/composables/useAddEdit",
3480
3394
  "summary": "Exports add/edit operation composable."
@@ -3532,15 +3446,7 @@
3532
3446
  "surfaces": [
3533
3447
  "console"
3534
3448
  ],
3535
- "source": "templates/src/pages/console/settings/index.vue"
3536
- },
3537
- {
3538
- "host": "console-settings",
3539
- "position": "forms",
3540
- "surfaces": [
3541
- "console"
3542
- ],
3543
- "source": "templates/src/pages/console/settings/index.vue"
3449
+ "source": "templates/src/pages/console/settings.vue"
3544
3450
  }
3545
3451
  ],
3546
3452
  "contributions": [
@@ -3589,12 +3495,12 @@
3589
3495
  "runtime": {
3590
3496
  "@tanstack/vue-query": "5.92.12",
3591
3497
  "@mdi/js": "^7.4.47",
3592
- "@jskit-ai/http-runtime": "0.1.28",
3593
- "@jskit-ai/realtime": "0.1.28",
3594
- "@jskit-ai/kernel": "0.1.29",
3595
- "@jskit-ai/shell-web": "0.1.28",
3596
- "@jskit-ai/uploads-image-web": "0.1.7",
3597
- "@jskit-ai/users-core": "0.1.39",
3498
+ "@jskit-ai/http-runtime": "0.1.30",
3499
+ "@jskit-ai/realtime": "0.1.30",
3500
+ "@jskit-ai/kernel": "0.1.31",
3501
+ "@jskit-ai/shell-web": "0.1.30",
3502
+ "@jskit-ai/uploads-image-web": "0.1.9",
3503
+ "@jskit-ai/users-core": "0.1.41",
3598
3504
  "vuetify": "^4.0.0"
3599
3505
  },
3600
3506
  "dev": {}
@@ -3650,11 +3556,19 @@
3650
3556
  "category": "users-web",
3651
3557
  "id": "users-web-component-account-settings-invites"
3652
3558
  },
3559
+ {
3560
+ "from": "templates/src/pages/console/settings.vue",
3561
+ "toSurface": "console",
3562
+ "toSurfacePath": "settings.vue",
3563
+ "reason": "Install console settings shell route scaffold for users-web console UI.",
3564
+ "category": "users-web",
3565
+ "id": "users-web-page-console-settings-shell"
3566
+ },
3653
3567
  {
3654
3568
  "from": "templates/src/pages/console/settings/index.vue",
3655
3569
  "toSurface": "console",
3656
3570
  "toSurfacePath": "settings/index.vue",
3657
- "reason": "Install console settings page scaffold for users-web console UI.",
3571
+ "reason": "Install console settings landing page scaffold for users-web console UI.",
3658
3572
  "category": "users-web",
3659
3573
  "id": "users-web-page-console-settings"
3660
3574
  }
@@ -3706,11 +3620,11 @@
3706
3620
  },
3707
3621
  {
3708
3622
  "packageId": "@jskit-ai/workspaces-core",
3709
- "version": "0.1.5",
3623
+ "version": "0.1.7",
3710
3624
  "descriptor": {
3711
3625
  "packageVersion": 1,
3712
3626
  "packageId": "@jskit-ai/workspaces-core",
3713
- "version": "0.1.5",
3627
+ "version": "0.1.7",
3714
3628
  "kind": "runtime",
3715
3629
  "description": "Workspace tenancy runtime plus HTTP routes, role catalog, and workspace config scaffolding.",
3716
3630
  "dependsOn": [
@@ -3819,7 +3733,7 @@
3819
3733
  "mutations": {
3820
3734
  "dependencies": {
3821
3735
  "runtime": {
3822
- "@jskit-ai/users-core": "0.1.39"
3736
+ "@jskit-ai/users-core": "0.1.41"
3823
3737
  },
3824
3738
  "dev": {}
3825
3739
  },
@@ -4009,11 +3923,11 @@
4009
3923
  },
4010
3924
  {
4011
3925
  "packageId": "@jskit-ai/workspaces-web",
4012
- "version": "0.1.5",
3926
+ "version": "0.1.7",
4013
3927
  "descriptor": {
4014
3928
  "packageVersion": 1,
4015
3929
  "packageId": "@jskit-ai/workspaces-web",
4016
- "version": "0.1.5",
3930
+ "version": "0.1.7",
4017
3931
  "kind": "runtime",
4018
3932
  "description": "Workspace web module: workspace selector, tools widget, workspace surfaces, and members/settings UI.",
4019
3933
  "dependsOn": [
@@ -4071,15 +3985,7 @@
4071
3985
  "surfaces": [
4072
3986
  "admin"
4073
3987
  ],
4074
- "source": "templates/src/pages/admin/workspace/settings/index.vue"
4075
- },
4076
- {
4077
- "host": "admin-settings",
4078
- "position": "forms",
4079
- "surfaces": [
4080
- "admin"
4081
- ],
4082
- "source": "templates/src/pages/admin/workspace/settings/index.vue"
3988
+ "source": "templates/src/pages/admin/workspace/settings.vue"
4083
3989
  }
4084
3990
  ],
4085
3991
  "contributions": [
@@ -4141,15 +4047,15 @@
4141
4047
  "source": "mutations.text#users-web-placement-block"
4142
4048
  },
4143
4049
  {
4144
- "id": "users.workspace.settings.form",
4050
+ "id": "users.workspace.settings.general",
4145
4051
  "host": "admin-settings",
4146
- "position": "forms",
4052
+ "position": "primary-menu",
4147
4053
  "surfaces": [
4148
4054
  "admin"
4149
4055
  ],
4150
4056
  "order": 100,
4151
- "componentToken": "users.web.workspace-settings.element",
4152
- "source": "mutations.text#users-web-workspace-settings-form-placement"
4057
+ "componentToken": "users.web.shell.surface-aware-menu-link-item",
4058
+ "source": "mutations.text#users-web-workspace-settings-general-placement"
4153
4059
  }
4154
4060
  ]
4155
4061
  }
@@ -4158,8 +4064,8 @@
4158
4064
  "mutations": {
4159
4065
  "dependencies": {
4160
4066
  "runtime": {
4161
- "@jskit-ai/workspaces-core": "0.1.5",
4162
- "@jskit-ai/users-web": "0.1.44"
4067
+ "@jskit-ai/workspaces-core": "0.1.7",
4068
+ "@jskit-ai/users-web": "0.1.46"
4163
4069
  },
4164
4070
  "dev": {}
4165
4071
  },
@@ -4283,11 +4189,26 @@
4283
4189
  ]
4284
4190
  }
4285
4191
  },
4192
+ {
4193
+ "from": "templates/src/pages/admin/workspace/settings.vue",
4194
+ "toSurface": "admin",
4195
+ "toSurfacePath": "workspace/settings.vue",
4196
+ "reason": "Install workspace settings shell route scaffold for workspaces-web workspace admin UI.",
4197
+ "category": "workspaces-web",
4198
+ "id": "users-web-page-admin-workspace-settings-shell",
4199
+ "when": {
4200
+ "config": "tenancyMode",
4201
+ "in": [
4202
+ "personal",
4203
+ "workspaces"
4204
+ ]
4205
+ }
4206
+ },
4286
4207
  {
4287
4208
  "from": "templates/src/pages/admin/workspace/settings/index.vue",
4288
4209
  "toSurface": "admin",
4289
4210
  "toSurfacePath": "workspace/settings/index.vue",
4290
- "reason": "Install workspace settings page scaffold for workspaces-web workspace admin UI.",
4211
+ "reason": "Install workspace settings landing page scaffold for workspaces-web workspace admin UI.",
4291
4212
  "category": "workspaces-web",
4292
4213
  "id": "users-web-page-admin-workspace-settings",
4293
4214
  "when": {
@@ -4341,11 +4262,11 @@
4341
4262
  "op": "append-text",
4342
4263
  "file": "src/placement.js",
4343
4264
  "position": "bottom",
4344
- "skipIfContains": "id: \"users.workspace.settings.form\"",
4345
- "value": "\naddPlacement({\n id: \"users.workspace.settings.form\",\n host: \"admin-settings\",\n position: \"forms\",\n surfaces: [\"admin\"],\n order: 100,\n componentToken: \"users.web.workspace-settings.element\"\n});\n",
4346
- "reason": "Append workspace settings form placement into app-owned placement registry.",
4265
+ "skipIfContains": "id: \"users.workspace.settings.general\"",
4266
+ "value": "\naddPlacement({\n id: \"users.workspace.settings.general\",\n host: \"admin-settings\",\n position: \"primary-menu\",\n surfaces: [\"admin\"],\n order: 100,\n componentToken: \"users.web.shell.surface-aware-menu-link-item\",\n props: {\n label: \"General\",\n surface: \"admin\",\n workspaceSuffix: \"/workspace/settings\",\n nonWorkspaceSuffix: \"/workspace/settings\"\n },\n when: ({ auth }) => Boolean(auth?.authenticated)\n});\n",
4267
+ "reason": "Append workspace settings general-page placement into app-owned placement registry.",
4347
4268
  "category": "workspaces-web",
4348
- "id": "users-web-workspace-settings-form-placement",
4269
+ "id": "users-web-workspace-settings-general-placement",
4349
4270
  "when": {
4350
4271
  "config": "tenancyMode",
4351
4272
  "in": [