@jskit-ai/agent-docs 0.1.193 → 0.1.195

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 (40) hide show
  1. package/guide/agent/app-extras/assistant-conversation.md +2608 -72
  2. package/guide/agent/app-extras/assistant-voice.md +244 -0
  3. package/guide/agent/app-extras/assistant.md +189 -20
  4. package/guide/agent/app-extras/realtime.md +6 -0
  5. package/guide/agent/app-setup/database-layer.md +74 -5
  6. package/guide/agent/app-setup/existing-application-migration.md +34 -29
  7. package/guide/agent/app-setup/multi-homing.md +93 -116
  8. package/guide/agent/framework/crud-operations.md +16 -2
  9. package/guide/agent/index.md +1 -0
  10. package/package.json +1 -1
  11. package/patterns/feature-package/example/booking-engine/package.json +1 -1
  12. package/patterns/minimal-foundation/example/package.json +4 -4
  13. package/patterns/shell-foundation/example/package.json +5 -5
  14. package/patterns/shell-foundation/example/packages/main/package.json +1 -1
  15. package/reference/autogen/PATTERN_INDEX.md +35 -35
  16. package/reference/autogen/README.md +2 -0
  17. package/reference/autogen/packages/assistant-core.md +974 -9
  18. package/reference/autogen/packages/assistant-runtime.md +126 -28
  19. package/reference/autogen/packages/assistant-voice-sherpa.md +82 -0
  20. package/reference/autogen/packages/assistant-voice.md +227 -0
  21. package/reference/autogen/packages/kernel.md +10 -0
  22. package/reference/autogen/packages/realtime.md +5 -2
  23. package/skills/jskit/SKILL.md +1 -1
  24. package/skills/jskit/references/crud-operations.md +16 -2
  25. package/skills/jskit/references/existing-application-migration.md +34 -29
  26. package/skills/jskit/references/multi-homing.md +93 -116
  27. package/skills/jskit/references/pattern-index.md +35 -35
  28. package/skills/jskit/references/patterns/app/minimal-foundation/example/package.json +4 -4
  29. package/skills/jskit/references/patterns/app/shell-foundation/example/package.json +5 -5
  30. package/skills/jskit/references/patterns/app/shell-foundation/example/packages/main/package.json +1 -1
  31. package/skills/jskit/references/patterns/auth/supabase-auth/example/package.json +1 -1
  32. package/skills/jskit/references/patterns/connectors/calendar-cli/example/package.json +4 -4
  33. package/skills/jskit/references/patterns/crud/json-api-resource-package/example/packages/books/package.json +2 -2
  34. package/skills/jskit/references/patterns/database/mysql-application/example/package.json +1 -1
  35. package/skills/jskit/references/patterns/database/postgres-application/example/package.json +1 -1
  36. package/skills/jskit/references/patterns/realtime/realtime-application/example/package.json +2 -2
  37. package/skills/jskit/references/patterns/server/feature-package/example/booking-engine/package.json +1 -1
  38. package/skills/jskit/references/patterns/users/user-administration-server/example/packages/users/package.json +2 -2
  39. package/skills/jskit/references/patterns/users/user-administration-server/example/packages/users-workspace/package.json +3 -3
  40. package/skills/jskit/references/patterns/workspaces/workspace-server/PATTERN.md +23 -28
@@ -15,7 +15,7 @@ A concrete Fastify, Vue, and JSKIT application foundation for products that do n
15
15
 
16
16
  - Id: `app/minimal-foundation`
17
17
  - Keywords: `app`, `fastify`, `foundation`, `minimal`, `server`, `vite`, `vue`
18
- - Owner: `@jskit-ai/agent-docs@0.1.193`
18
+ - Owner: `@jskit-ai/agent-docs@0.1.195`
19
19
  - Read: [PATTERN.md](patterns/app/minimal-foundation/PATTERN.md)
20
20
  - Examples: [example/](patterns/app/minimal-foundation/example/)
21
21
  - Requires: `@jskit-ai/http-runtime`, `@jskit-ai/kernel`
@@ -26,7 +26,7 @@ A concrete JSKIT web application foundation with responsive shell navigation, se
26
26
 
27
27
  - Id: `app/shell-foundation`
28
28
  - Keywords: `app`, `foundation`, `material`, `navigation`, `placements`, `shell`, `vite`, `vue`
29
- - Owner: `@jskit-ai/agent-docs@0.1.193`
29
+ - Owner: `@jskit-ai/agent-docs@0.1.195`
30
30
  - Read: [PATTERN.md](patterns/app/shell-foundation/PATTERN.md)
31
31
  - Examples: [example/](patterns/app/shell-foundation/example/)
32
32
  - Requires: `@jskit-ai/http-runtime`, `@jskit-ai/kernel`, `@jskit-ai/shell-web`
@@ -37,7 +37,7 @@ Configure an assistant runtime for one application surface and expose its chat a
37
37
 
38
38
  - Id: `assistant/assistant-surface`
39
39
  - Keywords: `ai`, `assistant`, `chat`, `config`, `environment`, `page`, `placement`, `settings`, `surface`
40
- - Owner: `@jskit-ai/assistant-runtime@0.1.192`
40
+ - Owner: `@jskit-ai/assistant-runtime@0.1.194`
41
41
  - Read: [PATTERN.md](patterns/assistant/assistant-surface/PATTERN.md)
42
42
  - Examples: [example/](patterns/assistant/assistant-surface/example/)
43
43
  - Requires: `@jskit-ai/assistant-runtime`, `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`, `@jskit-ai/shell-web`
@@ -48,7 +48,7 @@ Compose JSKIT authentication routes, views, profile controls, and public surface
48
48
 
49
49
  - Id: `auth/auth-surface`
50
50
  - Keywords: `account`, `auth`, `login`, `logout`, `password`, `placement`, `profile`, `reset`, `surface`
51
- - Owner: `@jskit-ai/auth-web@0.1.221`
51
+ - Owner: `@jskit-ai/auth-web@0.1.223`
52
52
  - Read: [PATTERN.md](patterns/auth/auth-surface/PATTERN.md)
53
53
  - Examples: [example/](patterns/auth/auth-surface/example/)
54
54
  - Requires: `@jskit-ai/auth-core`, `@jskit-ai/auth-web`, `@jskit-ai/shell-web`
@@ -59,7 +59,7 @@ Add Supabase authentication through normal npm composition, explicit environment
59
59
 
60
60
  - Id: `auth/supabase-auth`
61
61
  - Keywords: `auth`, `authentication`, `oauth`, `sessions`, `supabase`
62
- - Owner: `@jskit-ai/auth-provider-supabase-core@0.1.218`
62
+ - Owner: `@jskit-ai/auth-provider-supabase-core@0.1.220`
63
63
  - Read: [PATTERN.md](patterns/auth/supabase-auth/PATTERN.md)
64
64
  - Examples: [example/](patterns/auth/supabase-auth/example/)
65
65
  - Requires: `@jskit-ai/auth-provider-supabase-core`
@@ -70,7 +70,7 @@ Resolve an administrator environment key or an individual user's grant, then use
70
70
 
71
71
  - Id: `connectors/ai-connections`
72
72
  - Keywords: `ai`, `api-key`, `big-pickle`, `cli`, `environment`, `free`, `models`, `ownership`, `zai`, `zen`
73
- - Owner: `@jskit-ai/connectors-catalog@0.1.38`
73
+ - Owner: `@jskit-ai/connectors-catalog@0.1.40`
74
74
  - Read: [PATTERN.md](patterns/connectors/ai-connections/PATTERN.md)
75
75
  - Examples: [example/](patterns/connectors/ai-connections/example/)
76
76
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -81,7 +81,7 @@ Compose provider operations, authorization and encrypted file storage from a CLI
81
81
 
82
82
  - Id: `connectors/api-key-connection`
83
83
  - Keywords: `api-key`, `clay`, `cli`, `clickhouse`, `connectors`, `dbt`, `files`, `firecrawl`, `granola`, `integrations`, `metrics`, `prestashop`, `resend`, `semantic-layer`, `semrush`, `x-twitter`
84
- - Owner: `@jskit-ai/connectors-catalog@0.1.38`
84
+ - Owner: `@jskit-ai/connectors-catalog@0.1.40`
85
85
  - Read: [PATTERN.md](patterns/connectors/api-key-connection/PATTERN.md)
86
86
  - Examples: [example/](patterns/connectors/api-key-connection/example/)
87
87
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -92,7 +92,7 @@ Compose token-based MCP discovery and explicitly authorized tool calls using the
92
92
 
93
93
  - Id: `connectors/assistant-mcp`
94
94
  - Keywords: `assistant`, `cli`, `connectors`, `files`, `integrations`, `mcp`, `n8n`, `sanity`
95
- - Owner: `@jskit-ai/connectors-catalog@0.1.38`
95
+ - Owner: `@jskit-ai/connectors-catalog@0.1.40`
96
96
  - Read: [PATTERN.md](patterns/connectors/assistant-mcp/PATTERN.md)
97
97
  - Examples: [example/](patterns/connectors/assistant-mcp/example/)
98
98
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -103,7 +103,7 @@ Configure assistant OAuth clients, then compose existing state, encrypted file g
103
103
 
104
104
  - Id: `connectors/assistant-mcp-oauth`
105
105
  - Keywords: `amplitude`, `assistant`, `atlassian`, `canva`, `cli`, `client metadata`, `confidence`, `connectors`, `figma`, `files`, `granola`, `hex`, `mcp`, `miro`, `oauth`
106
- - Owner: `@jskit-ai/connectors-catalog@0.1.38`
106
+ - Owner: `@jskit-ai/connectors-catalog@0.1.40`
107
107
  - Read: [PATTERN.md](patterns/connectors/assistant-mcp-oauth/PATTERN.md)
108
108
  - Examples: [example/](patterns/connectors/assistant-mcp-oauth/example/)
109
109
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -114,7 +114,7 @@ Compose signed AWS operations, file configuration and application authorization
114
114
 
115
115
  - Id: `connectors/aws-storage-queries`
116
116
  - Keywords: `athena`, `aws`, `cli`, `connectors`, `files`, `iam`, `queries`, `s3`, `storage`, `sts`
117
- - Owner: `@jskit-ai/connectors-catalog@0.1.38`
117
+ - Owner: `@jskit-ai/connectors-catalog@0.1.40`
118
118
  - Read: [PATTERN.md](patterns/connectors/aws-storage-queries/PATTERN.md)
119
119
  - Examples: [example/](patterns/connectors/aws-storage-queries/example/)
120
120
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -125,7 +125,7 @@ Compose reusable connection libraries with portable configuration, application o
125
125
 
126
126
  - Id: `connectors/calendar-cli`
127
127
  - Keywords: `calendar`, `cli`, `connectors`, `google`, `integrations`, `oauth`, `permissions`
128
- - Owner: `@jskit-ai/connector-google-calendar@0.1.38`
128
+ - Owner: `@jskit-ai/connector-google-calendar@0.1.40`
129
129
  - Read: [PATTERN.md](patterns/connectors/calendar-cli/PATTERN.md)
130
130
  - Examples: [example/](patterns/connectors/calendar-cli/example/)
131
131
  - Requires: `@jskit-ai/connector-google-calendar`, `@jskit-ai/connectors-core`, `@jskit-ai/database-runtime-mysql`
@@ -136,7 +136,7 @@ Compose the shared connector runtime for event delivery while leaving workflow c
136
136
 
137
137
  - Id: `connectors/event-delivery`
138
138
  - Keywords: `cli`, `connectors`, `events`, `files`, `inngest`, `integrations`, `workflows`
139
- - Owner: `@jskit-ai/connectors-catalog@0.1.38`
139
+ - Owner: `@jskit-ai/connectors-catalog@0.1.40`
140
140
  - Read: [PATTERN.md](patterns/connectors/event-delivery/PATTERN.md)
141
141
  - Examples: [example/](patterns/connectors/event-delivery/example/)
142
142
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -147,7 +147,7 @@ Wire service-account grants, file storage, explicit message actions and public b
147
147
 
148
148
  - Id: `connectors/firebase-messaging`
149
149
  - Keywords: `cli`, `connectors`, `fcm`, `files`, `firebase`, `integrations`, `jwt`, `notifications`, `push`, `service-account`, `vapid`
150
- - Owner: `@jskit-ai/connectors-catalog@0.1.38`
150
+ - Owner: `@jskit-ai/connectors-catalog@0.1.40`
151
151
  - Read: [PATTERN.md](patterns/connectors/firebase-messaging/PATTERN.md)
152
152
  - Examples: [example/](patterns/connectors/firebase-messaging/example/)
153
153
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -158,7 +158,7 @@ Compose reviewed Search campaigns with project-owned Google OAuth and portable s
158
158
 
159
159
  - Id: `connectors/google-ads-search`
160
160
  - Keywords: `ads`, `campaigns`, `cli`, `connectors`, `conversion`, `google`, `search`
161
- - Owner: `@jskit-ai/connectors-catalog@0.1.38`
161
+ - Owner: `@jskit-ai/connectors-catalog@0.1.40`
162
162
  - Read: [PATTERN.md](patterns/connectors/google-ads-search/PATTERN.md)
163
163
  - Examples: [example/](patterns/connectors/google-ads-search/example/)
164
164
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -169,7 +169,7 @@ Compose provider consent, verification and encrypted file persistence from an ap
169
169
 
170
170
  - Id: `connectors/oauth-connection`
171
171
  - Keywords: `accounting`, `assistant permissions`, `books`, `cli`, `client credentials`, `connectors`, `consent`, `crm`, `databricks`, `developer token`, `fabric`, `files`, `gaql`, `google ads`, `graphql`, `integrations`, `linkedin`, `microsoft`, `oauth`, `powerpoint`, `salesforce`, `service principal`, `shopify`, `soql`, `staffing`, `tiktok`, `twitch`, `wave`, `word`, `wordpress`, `workday`, `xero`, `zoho`
172
- - Owner: `@jskit-ai/connectors-catalog@0.1.38`
172
+ - Owner: `@jskit-ai/connectors-catalog@0.1.40`
173
173
  - Read: [PATTERN.md](patterns/connectors/oauth-connection/PATTERN.md)
174
174
  - Examples: [example/](patterns/connectors/oauth-connection/example/)
175
175
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -180,7 +180,7 @@ Compose a sequential catalogue batch and preserve partial success for applicatio
180
180
 
181
181
  - Id: `connectors/paddle-catalogue`
182
182
  - Keywords: `batch`, `paddle`, `payments`, `prices`, `products`
183
- - Owner: `@jskit-ai/connectors-catalog@0.1.38`
183
+ - Owner: `@jskit-ai/connectors-catalog@0.1.40`
184
184
  - Read: [PATTERN.md](patterns/connectors/paddle-catalogue/PATTERN.md)
185
185
  - Examples: [example/](patterns/connectors/paddle-catalogue/example/)
186
186
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -191,7 +191,7 @@ Resolve a publishable image key deliberately and use the shared URL library in a
191
191
 
192
192
  - Id: `connectors/public-image`
193
193
  - Keywords: `cli`, `connectors`, `files`, `images`, `integrations`, `logo-dev`, `public-key`
194
- - Owner: `@jskit-ai/connectors-catalog@0.1.38`
194
+ - Owner: `@jskit-ai/connectors-catalog@0.1.40`
195
195
  - Read: [PATTERN.md](patterns/connectors/public-image/PATTERN.md)
196
196
  - Examples: [example/](patterns/connectors/public-image/example/)
197
197
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -202,7 +202,7 @@ Compose file configuration, Redshift Data API operations and application query o
202
202
 
203
203
  - Id: `connectors/redshift-queries`
204
204
  - Keywords: `aws`, `cli`, `connectors`, `files`, `iam`, `provisioned`, `redshift`, `serverless`, `sql`, `warehouse`
205
- - Owner: `@jskit-ai/connectors-catalog@0.1.38`
205
+ - Owner: `@jskit-ai/connectors-catalog@0.1.40`
206
206
  - Read: [PATTERN.md](patterns/connectors/redshift-queries/PATTERN.md)
207
207
  - Examples: [example/](patterns/connectors/redshift-queries/example/)
208
208
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -213,7 +213,7 @@ Use the shared scanner runtime from a CLI or a host worker with portable configu
213
213
 
214
214
  - Id: `connectors/source-scanning`
215
215
  - Keywords: `cancellation`, `cli`, `connectors`, `integrations`, `scanning`, `security`, `source`, `wiz`, `worker`
216
- - Owner: `@jskit-ai/connectors-catalog@0.1.38`
216
+ - Owner: `@jskit-ai/connectors-catalog@0.1.40`
217
217
  - Read: [PATTERN.md](patterns/connectors/source-scanning/PATTERN.md)
218
218
  - Examples: [example/](patterns/connectors/source-scanning/example/)
219
219
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -224,7 +224,7 @@ Add a protected administration surface, settings shell, and semantic navigation
224
224
 
225
225
  - Id: `console/console-surface`
226
226
  - Keywords: `admin`, `console`, `navigation`, `owner`, `placement`, `settings`, `surface`
227
- - Owner: `@jskit-ai/console-web@0.1.189`
227
+ - Owner: `@jskit-ai/console-web@0.1.191`
228
228
  - Read: [PATTERN.md](patterns/console/console-surface/PATTERN.md)
229
229
  - Examples: [example/](patterns/console/console-surface/example/)
230
230
  - Requires: `@jskit-ai/console-core`, `@jskit-ai/console-web`, `@jskit-ai/shell-web`
@@ -235,7 +235,7 @@ Build a routed CRUD user interface as thin application pages over JSKIT's shared
235
235
 
236
236
  - Id: `crud/crud-screen-set`
237
237
  - Keywords: `actions`, `add`, `crud`, `delete`, `edit`, `filters`, `list`, `material`, `routes`, `view`, `vue`
238
- - Owner: `@jskit-ai/http-web@0.1.66`
238
+ - Owner: `@jskit-ai/http-web@0.1.68`
239
239
  - Read: [PATTERN.md](patterns/crud/crud-screen-set/PATTERN.md)
240
240
  - Examples: [example/](patterns/crud/crud-screen-set/example/)
241
241
  - Requires: `@jskit-ai/http-web`, `@jskit-ai/resource-crud-core`
@@ -246,7 +246,7 @@ Build a complete application-owned CRUD server package from a migration, resourc
246
246
 
247
247
  - Id: `crud/json-api-resource-package`
248
248
  - Keywords: `actions`, `crud`, `database`, `json-api`, `migration`, `permissions`, `provider`, `repository`, `routes`, `service`
249
- - Owner: `@jskit-ai/crud-core@0.1.232`
249
+ - Owner: `@jskit-ai/crud-core@0.1.234`
250
250
  - Read: [PATTERN.md](patterns/crud/json-api-resource-package/PATTERN.md)
251
251
  - Examples: [example/](patterns/crud/json-api-resource-package/example/)
252
252
  - Requires: `@jskit-ai/crud-core`, `@jskit-ai/resource-crud-core`
@@ -257,7 +257,7 @@ Define an authenticated application resource whose records belong to the current
257
257
 
258
258
  - Id: `crud/resource-contract`
259
259
  - Keywords: `authenticated`, `crud`, `database`, `owner-scoped`, `resource`, `user`
260
- - Owner: `@jskit-ai/resource-crud-core@0.1.163`
260
+ - Owner: `@jskit-ai/resource-crud-core@0.1.165`
261
261
  - Read: [PATTERN.md](patterns/crud/resource-contract/PATTERN.md)
262
262
  - Examples: [example/](patterns/crud/resource-contract/example/)
263
263
  - Requires: `@jskit-ai/resource-crud-core`
@@ -268,7 +268,7 @@ Configure a JSKIT application for MySQL with a fixed driver, ordinary environmen
268
268
 
269
269
  - Id: `database/mysql-application`
270
270
  - Keywords: `database`, `knex`, `mariadb`, `migrations`, `mysql`, `mysql2`
271
- - Owner: `@jskit-ai/database-runtime-mysql@0.1.219`
271
+ - Owner: `@jskit-ai/database-runtime-mysql@0.1.221`
272
272
  - Read: [PATTERN.md](patterns/database/mysql-application/PATTERN.md)
273
273
  - Examples: [example/](patterns/database/mysql-application/example/)
274
274
  - Requires: `@jskit-ai/database-runtime-mysql`
@@ -279,7 +279,7 @@ Configure a JSKIT application for PostgreSQL with a fixed driver, ordinary envir
279
279
 
280
280
  - Id: `database/postgres-application`
281
281
  - Keywords: `database`, `knex`, `migrations`, `pg`, `postgres`, `postgresql`
282
- - Owner: `@jskit-ai/database-runtime-postgres@0.1.218`
282
+ - Owner: `@jskit-ai/database-runtime-postgres@0.1.220`
283
283
  - Read: [PATTERN.md](patterns/database/postgres-application/PATTERN.md)
284
284
  - Examples: [example/](patterns/database/postgres-application/example/)
285
285
  - Requires: `@jskit-ai/database-runtime-postgres`
@@ -290,7 +290,7 @@ Wrap a JSKIT web application in a Capacitor Android shell using native Capacitor
290
290
 
291
291
  - Id: `mobile/android-application`
292
292
  - Keywords: `android`, `capacitor`, `device`, `mobile`, `native`, `shell`, `webview`
293
- - Owner: `@jskit-ai/mobile-capacitor@0.1.156`
293
+ - Owner: `@jskit-ai/mobile-capacitor@0.1.158`
294
294
  - Read: [PATTERN.md](patterns/mobile/android-application/PATTERN.md)
295
295
  - Examples: [example/](patterns/mobile/android-application/example/)
296
296
  - Requires: `@capacitor/android`, `@capacitor/app`, `@capacitor/cli`, `@jskit-ai/mobile-capacitor`
@@ -301,7 +301,7 @@ Add JSKIT realtime events with an optional Redis backplane and an explicit shell
301
301
 
302
302
  - Id: `realtime/realtime-application`
303
303
  - Keywords: `realtime`, `redis`, `socket.io`, `sockets`, `status`, `websocket`
304
- - Owner: `@jskit-ai/realtime@0.1.218`
304
+ - Owner: `@jskit-ai/realtime@0.1.220`
305
305
  - Read: [PATTERN.md](patterns/realtime/realtime-application/PATTERN.md)
306
306
  - Examples: [example/](patterns/realtime/realtime-application/example/)
307
307
  - Requires: `@jskit-ai/realtime`, `@jskit-ai/shell-web`
@@ -312,7 +312,7 @@ Compose application-owned Google Publisher Tag delivery with the generic rewarde
312
312
 
313
313
  - Id: `rewards/google-rewarded`
314
314
  - Keywords: `ads`, `google`, `publisher tag`, `rewarded`, `unlock`
315
- - Owner: `@jskit-ai/rewarded-web@0.1.157`
315
+ - Owner: `@jskit-ai/rewarded-web@0.1.159`
316
316
  - Read: [PATTERN.md](patterns/rewards/google-rewarded/PATTERN.md)
317
317
  - Examples: [example/](patterns/rewards/google-rewarded/example/)
318
318
  - Requires: `@jskit-ai/rewarded-web`
@@ -323,7 +323,7 @@ Define a server feature through explicit capabilities and first-class actions, a
323
323
 
324
324
  - Id: `server/feature-package`
325
325
  - Keywords: `actions`, `feature`, `json-rest`, `knex`, `orchestration`, `package`, `provider`, `repository`, `routes`, `server`
326
- - Owner: `@jskit-ai/agent-docs@0.1.193`
326
+ - Owner: `@jskit-ai/agent-docs@0.1.195`
327
327
  - Read: [PATTERN.md](patterns/server/feature-package/PATTERN.md)
328
328
  - Examples: [example/](patterns/server/feature-package/example/)
329
329
  - Requires: `@jskit-ai/kernel`
@@ -334,7 +334,7 @@ Compose the JSKIT responsive shell, semantic placements, settings navigation, an
334
334
 
335
335
  - Id: `shell/application-shell`
336
336
  - Keywords: `adaptive`, `app`, `layout`, `navigation`, `placement`, `responsive`, `settings`, `shell`
337
- - Owner: `@jskit-ai/shell-web@0.1.225`
337
+ - Owner: `@jskit-ai/shell-web@0.1.227`
338
338
  - Read: [PATTERN.md](patterns/shell/application-shell/PATTERN.md)
339
339
  - Examples: [example/](patterns/shell/application-shell/example/)
340
340
  - Requires: `@jskit-ai/kernel`, `@jskit-ai/shell-web`
@@ -345,7 +345,7 @@ Add product routes and shell extensions through file routing, semantic placement
345
345
 
346
346
  - Id: `ui/page-and-placement`
347
347
  - Keywords: `component`, `navigation`, `outlet`, `page`, `placement`, `routes`, `section`, `shell`, `subpages`, `vue`
348
- - Owner: `@jskit-ai/shell-web@0.1.225`
348
+ - Owner: `@jskit-ai/shell-web@0.1.227`
349
349
  - Read: [PATTERN.md](patterns/ui/page-and-placement/PATTERN.md)
350
350
  - Examples: [example/](patterns/ui/page-and-placement/example/)
351
351
  - Requires: `@jskit-ai/kernel`, `@jskit-ai/shell-web`
@@ -356,7 +356,7 @@ Compose an account settings route and profile, preference, and notification sect
356
356
 
357
357
  - Id: `users/account-settings`
358
358
  - Keywords: `account`, `notifications`, `preferences`, `profile`, `settings`, `user`, `vue`
359
- - Owner: `@jskit-ai/users-web@0.1.239`
359
+ - Owner: `@jskit-ai/users-web@0.1.241`
360
360
  - Read: [PATTERN.md](patterns/users/account-settings/PATTERN.md)
361
361
  - Examples: [example/](patterns/users/account-settings/example/)
362
362
  - Requires: `@jskit-ai/shell-web`, `@jskit-ai/users-core`, `@jskit-ai/users-web`
@@ -367,7 +367,7 @@ Expose user administration and workspace-scoped member operations through app-ow
367
367
 
368
368
  - Id: `users/user-administration-server`
369
369
  - Keywords: `account`, `admin`, `member`, `repository`, `resource`, `routes`, `service`, `user`, `workspace`
370
- - Owner: `@jskit-ai/users-core@0.1.234`
370
+ - Owner: `@jskit-ai/users-core@0.1.236`
371
371
  - Read: [PATTERN.md](patterns/users/user-administration-server/PATTERN.md)
372
372
  - Examples: [example/](patterns/users/user-administration-server/example/)
373
373
  - Requires: `@jskit-ai/crud-core`, `@jskit-ai/users-core`
@@ -378,7 +378,7 @@ Configure roles, workspace access policy, invitations, and app-owned invitation
378
378
 
379
379
  - Id: `workspaces/workspace-server`
380
380
  - Keywords: `access`, `invite`, `membership`, `multitenancy`, `policy`, `role`, `tenancy`, `workspace`
381
- - Owner: `@jskit-ai/workspaces-core@0.1.199`
381
+ - Owner: `@jskit-ai/workspaces-core@0.1.201`
382
382
  - Read: [PATTERN.md](patterns/workspaces/workspace-server/PATTERN.md)
383
383
  - Examples: [example/](patterns/workspaces/workspace-server/example/)
384
384
  - Requires: `@jskit-ai/users-core`, `@jskit-ai/workspaces-core`
@@ -389,7 +389,7 @@ Compose workspace selection, invitation, member administration, settings, and re
389
389
 
390
390
  - Id: `workspaces/workspace-surfaces`
391
391
  - Keywords: `admin`, `invite`, `member`, `navigation`, `settings`, `surface`, `switcher`, `workspace`
392
- - Owner: `@jskit-ai/workspaces-web@0.1.200`
392
+ - Owner: `@jskit-ai/workspaces-web@0.1.202`
393
393
  - Read: [PATTERN.md](patterns/workspaces/workspace-surfaces/PATTERN.md)
394
394
  - Examples: [example/](patterns/workspaces/workspace-surfaces/example/)
395
395
  - Requires: `@jskit-ai/shell-web`, `@jskit-ai/workspaces-core`, `@jskit-ai/workspaces-web`
@@ -34,7 +34,7 @@
34
34
  "dependencies": {
35
35
  "@local/main": "0.1.0",
36
36
  "@fastify/static": "^10.1.3",
37
- "@jskit-ai/kernel": "0.1.221",
37
+ "@jskit-ai/kernel": "0.1.223",
38
38
  "@tanstack/vue-query": "^5.101.0",
39
39
  "fastify": "^5.8.5",
40
40
  "json-rest-schema": "^1.0.17",
@@ -42,13 +42,13 @@
42
42
  "vue": "^3.5.43",
43
43
  "vue-router": "^5.3.1",
44
44
  "vuetify": "^4.1.2",
45
- "@jskit-ai/http-runtime": "0.1.219",
45
+ "@jskit-ai/http-runtime": "0.1.221",
46
46
  "@fastify/fast-json-stringify-compiler": "^5.1.0",
47
47
  "@vue/devtools-api": "^8.2.1"
48
48
  },
49
49
  "devDependencies": {
50
- "@jskit-ai/config-eslint": "0.1.218",
51
- "@jskit-ai/jskit-catalog": "0.1.246",
50
+ "@jskit-ai/config-eslint": "0.1.220",
51
+ "@jskit-ai/jskit-catalog": "0.1.248",
52
52
  "@playwright/test": "1.61.1",
53
53
  "@vitejs/plugin-vue": "^6.0.7",
54
54
  "eslint": "^10.8.0",
@@ -34,7 +34,7 @@
34
34
  "dependencies": {
35
35
  "@local/main": "0.1.0",
36
36
  "@fastify/static": "^10.1.3",
37
- "@jskit-ai/kernel": "0.1.221",
37
+ "@jskit-ai/kernel": "0.1.223",
38
38
  "@tanstack/vue-query": "^5.101.0",
39
39
  "fastify": "^5.8.5",
40
40
  "json-rest-schema": "^1.0.17",
@@ -42,15 +42,15 @@
42
42
  "vue": "^3.5.43",
43
43
  "vue-router": "^5.3.1",
44
44
  "vuetify": "^4.1.2",
45
- "@jskit-ai/http-runtime": "0.1.219",
45
+ "@jskit-ai/http-runtime": "0.1.221",
46
46
  "@mdi/js": "^7.4.47",
47
- "@jskit-ai/shell-web": "0.1.225",
47
+ "@jskit-ai/shell-web": "0.1.227",
48
48
  "@fastify/fast-json-stringify-compiler": "^5.1.0",
49
49
  "@vue/devtools-api": "^8.2.1"
50
50
  },
51
51
  "devDependencies": {
52
- "@jskit-ai/config-eslint": "0.1.218",
53
- "@jskit-ai/jskit-catalog": "0.1.246",
52
+ "@jskit-ai/config-eslint": "0.1.220",
53
+ "@jskit-ai/jskit-catalog": "0.1.248",
54
54
  "@playwright/test": "1.61.1",
55
55
  "@vitejs/plugin-vue": "^6.0.7",
56
56
  "eslint": "^10.8.0",
@@ -9,7 +9,7 @@
9
9
  },
10
10
  "description": "App-local runtime composition and lightweight glue.",
11
11
  "dependencies": {
12
- "@jskit-ai/kernel": "0.1.221"
12
+ "@jskit-ai/kernel": "0.1.223"
13
13
  },
14
14
  "jskit": {
15
15
  "kind": "runtime",
@@ -2,6 +2,6 @@
2
2
  "private": true,
3
3
  "type": "module",
4
4
  "dependencies": {
5
- "@jskit-ai/auth-provider-supabase-core": "0.1.218"
5
+ "@jskit-ai/auth-provider-supabase-core": "0.1.220"
6
6
  }
7
7
  }
@@ -7,10 +7,10 @@
7
7
  "db:migrate:status": "knex --knexfile ./knexfile.js migrate:list"
8
8
  },
9
9
  "dependencies": {
10
- "@jskit-ai/connectors-core": "0.1.38",
11
- "@jskit-ai/connector-google-calendar": "0.1.38",
12
- "@jskit-ai/database-runtime": "0.1.221",
13
- "@jskit-ai/database-runtime-mysql": "0.1.219",
10
+ "@jskit-ai/connectors-core": "0.1.40",
11
+ "@jskit-ai/connector-google-calendar": "0.1.40",
12
+ "@jskit-ai/database-runtime": "0.1.223",
13
+ "@jskit-ai/database-runtime-mysql": "0.1.221",
14
14
  "knex": "^3.1.0"
15
15
  }
16
16
  }
@@ -8,8 +8,8 @@
8
8
  "./shared": "./src/shared/index.js"
9
9
  },
10
10
  "dependencies": {
11
- "@jskit-ai/crud-core": "0.1.232",
12
- "@jskit-ai/resource-crud-core": "0.1.163"
11
+ "@jskit-ai/crud-core": "0.1.234",
12
+ "@jskit-ai/resource-crud-core": "0.1.165"
13
13
  },
14
14
  "jskit": {
15
15
  "kind": "runtime",
@@ -8,6 +8,6 @@
8
8
  "db:migrate:status": "knex --knexfile ./knexfile.js migrate:list"
9
9
  },
10
10
  "dependencies": {
11
- "@jskit-ai/database-runtime-mysql": "0.1.219"
11
+ "@jskit-ai/database-runtime-mysql": "0.1.221"
12
12
  }
13
13
  }
@@ -8,6 +8,6 @@
8
8
  "db:migrate:status": "knex --knexfile ./knexfile.js migrate:list"
9
9
  },
10
10
  "dependencies": {
11
- "@jskit-ai/database-runtime-postgres": "0.1.218"
11
+ "@jskit-ai/database-runtime-postgres": "0.1.220"
12
12
  }
13
13
  }
@@ -2,7 +2,7 @@
2
2
  "private": true,
3
3
  "type": "module",
4
4
  "dependencies": {
5
- "@jskit-ai/realtime": "0.1.218",
6
- "@jskit-ai/shell-web": "0.1.225"
5
+ "@jskit-ai/realtime": "0.1.220",
6
+ "@jskit-ai/shell-web": "0.1.227"
7
7
  }
8
8
  }
@@ -5,7 +5,7 @@
5
5
  "private": true,
6
6
  "type": "module",
7
7
  "dependencies": {
8
- "@jskit-ai/kernel": "0.1.221",
8
+ "@jskit-ai/kernel": "0.1.223",
9
9
  "json-rest-schema": "^1.0.17"
10
10
  },
11
11
  "exports": {
@@ -9,8 +9,8 @@
9
9
  "./shared": "./src/shared/index.js"
10
10
  },
11
11
  "dependencies": {
12
- "@jskit-ai/crud-core": "0.1.232",
13
- "@jskit-ai/resource-crud-core": "0.1.163"
12
+ "@jskit-ai/crud-core": "0.1.234",
13
+ "@jskit-ai/resource-crud-core": "0.1.165"
14
14
  },
15
15
  "jskit": {
16
16
  "kind": "runtime",
@@ -9,9 +9,9 @@
9
9
  "./shared": "./src/shared/index.js"
10
10
  },
11
11
  "dependencies": {
12
- "@jskit-ai/crud-core": "0.1.232",
13
- "@jskit-ai/resource-crud-core": "0.1.163",
14
- "@jskit-ai/workspaces-core": "0.1.199"
12
+ "@jskit-ai/crud-core": "0.1.234",
13
+ "@jskit-ai/resource-crud-core": "0.1.165",
14
+ "@jskit-ai/workspaces-core": "0.1.201"
15
15
  },
16
16
  "jskit": {
17
17
  "kind": "runtime",
@@ -30,52 +30,47 @@ contracts exported by `@jskit-ai/workspaces-core`.
30
30
 
31
31
  ## Transactional invitation participation
32
32
 
33
- Use the existing `workspaces.core` capability. During application feature setup,
34
- register one callback with
33
+ Through `workspaces.core`, register one callback during feature setup with
35
34
  `workspaces.services.pendingInvitations.registerAcceptanceParticipant(fn)`.
36
35
  The built-in `workspace.invite.redeem` action invokes
37
- `fn({ invite, user }, { trx, context })` after recipient/state/expiry validation
38
- and membership activation inside the same uncommitted managed transaction.
39
- Forward `trx` to every application owner; throw on invalid reviewed associations
40
- or failed writes. The framework marks accepted and commits only after success.
41
- Do not perform external effects or complete the transaction in the participant.
42
- Non-functions, duplicate registrations and registrations after acceptance/refusal
43
- begins reject. Ordinary invitations can pass through without an association;
44
- expected-but-missing, stale, revoked or conflicting associations must fail closed.
45
-
46
- For deliberate invitation creation, use `members.prepareInvite(workspace, actor,
36
+ `fn({ invite, user }, { trx, context })` after validating the recipient, state and
37
+ expiry and activating membership in the uncommitted transaction. Forward `trx`
38
+ to every application owner and propagate failures. JSKIT marks accepted and
39
+ commits after the callback succeeds. Keep external effects out of the callback.
40
+ Registration rejects non-functions, duplicates and calls after acceptance/refusal
41
+ begins. Allow ordinary invitations; reject stale, revoked, conflicting or
42
+ unexpectedly missing application associations.
43
+
44
+ Use `members.prepareInvite(workspace, actor,
47
45
  payload, { trx, context })` in `repositories.workspaceInvites.withTransaction`
48
46
  or the same JSON REST API's managed `transaction`. It returns
49
47
  `{ createdInviteId, inviteTokenPreview }` without delivery. Lock the workspace
50
48
  with `repositories.workspaceInvites.lockWorkspaceForInvitations(workspace.id,
51
49
  { trx })` before application draft/receipt rows, and save the exact invitation
52
- association and retry receipt before commit. Failed association restores any
53
- prior pending invitation. A draft of intended access should not call preparation.
50
+ association and retry receipt before commit. Failure restores the previous
51
+ pending invitation. Keep access drafts separate: preparation creates a real token.
54
52
 
55
53
  After confirmed commit, call `members.sendInvite(workspace, actor, prepared,
56
54
  { context })`. A later attempt can pass only `{ createdInviteId }`. Delivery
57
- reloads the committed pending invitation and uses stored recipient/role/expiry;
58
- it does not replace the invitation. Its `inviteDelivery` is separate from
59
- persistence: `mailer_unconfigured` when no mailer is supplied, `failed` on a
60
- renderer/mailer exception, or the normalized controlled/provider result.
61
- Interruption or failure may still mean a provider accepted the message. Receipt
62
- idempotency and delivery retries are application-owned; email is not exactly once.
63
- Do not log the returned token/URL. No SMTP setup is required for testing.
55
+ reloads the committed pending invitation and uses its saved recipient, role and
56
+ expiry. `inviteDelivery` reports `mailer_unconfigured`, `failed` on a renderer/mailer
57
+ exception, or the normalized mailer result. Persistence is unchanged by delivery
58
+ failure. A provider may accept a message before failing; the application owns
59
+ receipts and retries. Keep tokens/URLs out of logs and use controlled mailers in tests.
64
60
 
65
61
  `createInvite`, acceptance and refusal now own managed transactions and reject
66
- borrowed `options.trx`. Move transactional creation to preparation/post-commit
67
- sending and acceptance-related writes into the participant. Revocation may join
62
+ borrowed `options.trx`. Use preparation followed by delivery after commit for
63
+ transactional creation; put related acceptance writes in the participant. Revocation may join
68
64
  a managed transaction. Raw Knex/savepoint transactions cannot own resource
69
65
  writes. Invitation mutations lock workspace then invitation rows, revalidate
70
- current state and reject attempts to overwrite terminal state. Matching-recipient
71
- expiry rejection commits revocation before returning 409. Preserve transaction
66
+ current state and reject changes to accepted/revoked invitations. Expiry rejection
67
+ for the matching recipient commits revocation before returning 409. Preserve transaction
72
68
  outcomes and causes; a completion-hook error after commit cannot undo writes.
73
69
 
74
70
  See the human guide's **Workspace tenancy → Transactional invitation
75
71
  participation** for the full consumer example, errors, controlled mailer,
76
- compatibility notes and native verification commands. Application services still
77
- own authorization, identity/training linking, reviewed scope eligibility and
78
- required audit. This seam adds no application domain tables or policy.
72
+ compatibility notes and native verification commands. Application services own
73
+ authorization, identity/training linking, scope eligibility and required audit.
79
74
 
80
75
  ## Invariants
81
76