@jskit-ai/agent-docs 0.1.207 → 0.1.209

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 (35) hide show
  1. package/guide/agent/app-extras/assistant-conversation.md +543 -6
  2. package/guide/agent/app-extras/assistant-voice.md +16 -1
  3. package/guide/agent/app-extras/assistant.md +8 -0
  4. package/guide/agent/framework/application-operations.md +29 -0
  5. package/guide/agent/framework/crud-operations.md +100 -0
  6. package/package.json +1 -1
  7. package/patterns/feature-package/example/booking-engine/package.json +1 -1
  8. package/patterns/minimal-foundation/example/package.json +4 -4
  9. package/patterns/server-search.md +16 -0
  10. package/patterns/shell-foundation/example/package.json +5 -5
  11. package/patterns/shell-foundation/example/packages/main/package.json +1 -1
  12. package/patterns/ui-testing.md +13 -0
  13. package/reference/autogen/PATTERN_INDEX.md +35 -35
  14. package/reference/autogen/packages/assistant-core.md +33 -10
  15. package/reference/autogen/packages/assistant-runtime.md +3 -2
  16. package/reference/autogen/packages/assistant-voice-sherpa.md +1 -0
  17. package/reference/autogen/packages/assistant-voice.md +1 -0
  18. package/reference/autogen/packages/shell-web.md +15 -0
  19. package/skills/jskit/SKILL.md +20 -7
  20. package/skills/jskit/references/app-operations.md +29 -0
  21. package/skills/jskit/references/crud-operations.md +100 -0
  22. package/skills/jskit/references/pattern-index.md +35 -35
  23. package/skills/jskit/references/patterns/app/minimal-foundation/example/package.json +4 -4
  24. package/skills/jskit/references/patterns/app/shell-foundation/example/package.json +5 -5
  25. package/skills/jskit/references/patterns/app/shell-foundation/example/packages/main/package.json +1 -1
  26. package/skills/jskit/references/patterns/auth/supabase-auth/example/package.json +1 -1
  27. package/skills/jskit/references/patterns/connectors/calendar-cli/example/package.json +4 -4
  28. package/skills/jskit/references/patterns/crud/json-api-resource-package/PATTERN.md +33 -0
  29. package/skills/jskit/references/patterns/crud/json-api-resource-package/example/packages/books/package.json +2 -2
  30. package/skills/jskit/references/patterns/database/mysql-application/example/package.json +1 -1
  31. package/skills/jskit/references/patterns/database/postgres-application/example/package.json +1 -1
  32. package/skills/jskit/references/patterns/realtime/realtime-application/example/package.json +2 -2
  33. package/skills/jskit/references/patterns/server/feature-package/example/booking-engine/package.json +1 -1
  34. package/skills/jskit/references/patterns/users/user-administration-server/example/packages/users/package.json +2 -2
  35. package/skills/jskit/references/patterns/users/user-administration-server/example/packages/users-workspace/package.json +3 -3
@@ -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.207`
18
+ - Owner: `@jskit-ai/agent-docs@0.1.209`
19
19
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/app/minimal-foundation/PATTERN.md)
20
20
  - Examples: [example/](../../skills/jskit/references/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.207`
29
+ - Owner: `@jskit-ai/agent-docs@0.1.209`
30
30
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/app/shell-foundation/PATTERN.md)
31
31
  - Examples: [example/](../../skills/jskit/references/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.206`
40
+ - Owner: `@jskit-ai/assistant-runtime@0.1.208`
41
41
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/assistant/assistant-surface/PATTERN.md)
42
42
  - Examples: [example/](../../skills/jskit/references/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.235`
51
+ - Owner: `@jskit-ai/auth-web@0.1.237`
52
52
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/auth/auth-surface/PATTERN.md)
53
53
  - Examples: [example/](../../skills/jskit/references/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.232`
62
+ - Owner: `@jskit-ai/auth-provider-supabase-core@0.1.234`
63
63
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/auth/supabase-auth/PATTERN.md)
64
64
  - Examples: [example/](../../skills/jskit/references/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.52`
73
+ - Owner: `@jskit-ai/connectors-catalog@0.1.54`
74
74
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/ai-connections/PATTERN.md)
75
75
  - Examples: [example/](../../skills/jskit/references/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.52`
84
+ - Owner: `@jskit-ai/connectors-catalog@0.1.54`
85
85
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/api-key-connection/PATTERN.md)
86
86
  - Examples: [example/](../../skills/jskit/references/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.52`
95
+ - Owner: `@jskit-ai/connectors-catalog@0.1.54`
96
96
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/assistant-mcp/PATTERN.md)
97
97
  - Examples: [example/](../../skills/jskit/references/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.52`
106
+ - Owner: `@jskit-ai/connectors-catalog@0.1.54`
107
107
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/assistant-mcp-oauth/PATTERN.md)
108
108
  - Examples: [example/](../../skills/jskit/references/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.52`
117
+ - Owner: `@jskit-ai/connectors-catalog@0.1.54`
118
118
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/aws-storage-queries/PATTERN.md)
119
119
  - Examples: [example/](../../skills/jskit/references/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.52`
128
+ - Owner: `@jskit-ai/connector-google-calendar@0.1.54`
129
129
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/calendar-cli/PATTERN.md)
130
130
  - Examples: [example/](../../skills/jskit/references/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.52`
139
+ - Owner: `@jskit-ai/connectors-catalog@0.1.54`
140
140
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/event-delivery/PATTERN.md)
141
141
  - Examples: [example/](../../skills/jskit/references/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.52`
150
+ - Owner: `@jskit-ai/connectors-catalog@0.1.54`
151
151
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/firebase-messaging/PATTERN.md)
152
152
  - Examples: [example/](../../skills/jskit/references/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.52`
161
+ - Owner: `@jskit-ai/connectors-catalog@0.1.54`
162
162
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/google-ads-search/PATTERN.md)
163
163
  - Examples: [example/](../../skills/jskit/references/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.52`
172
+ - Owner: `@jskit-ai/connectors-catalog@0.1.54`
173
173
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/oauth-connection/PATTERN.md)
174
174
  - Examples: [example/](../../skills/jskit/references/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.52`
183
+ - Owner: `@jskit-ai/connectors-catalog@0.1.54`
184
184
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/paddle-catalogue/PATTERN.md)
185
185
  - Examples: [example/](../../skills/jskit/references/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.52`
194
+ - Owner: `@jskit-ai/connectors-catalog@0.1.54`
195
195
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/public-image/PATTERN.md)
196
196
  - Examples: [example/](../../skills/jskit/references/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.52`
205
+ - Owner: `@jskit-ai/connectors-catalog@0.1.54`
206
206
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/redshift-queries/PATTERN.md)
207
207
  - Examples: [example/](../../skills/jskit/references/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.52`
216
+ - Owner: `@jskit-ai/connectors-catalog@0.1.54`
217
217
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/source-scanning/PATTERN.md)
218
218
  - Examples: [example/](../../skills/jskit/references/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.203`
227
+ - Owner: `@jskit-ai/console-web@0.1.205`
228
228
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/console/console-surface/PATTERN.md)
229
229
  - Examples: [example/](../../skills/jskit/references/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.80`
238
+ - Owner: `@jskit-ai/http-web@0.1.82`
239
239
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/crud/crud-screen-set/PATTERN.md)
240
240
  - Examples: [example/](../../skills/jskit/references/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.246`
249
+ - Owner: `@jskit-ai/crud-core@0.1.248`
250
250
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/crud/json-api-resource-package/PATTERN.md)
251
251
  - Examples: [example/](../../skills/jskit/references/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.177`
260
+ - Owner: `@jskit-ai/resource-crud-core@0.1.179`
261
261
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/crud/resource-contract/PATTERN.md)
262
262
  - Examples: [example/](../../skills/jskit/references/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.233`
271
+ - Owner: `@jskit-ai/database-runtime-mysql@0.1.235`
272
272
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/database/mysql-application/PATTERN.md)
273
273
  - Examples: [example/](../../skills/jskit/references/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.232`
282
+ - Owner: `@jskit-ai/database-runtime-postgres@0.1.234`
283
283
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/database/postgres-application/PATTERN.md)
284
284
  - Examples: [example/](../../skills/jskit/references/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.170`
293
+ - Owner: `@jskit-ai/mobile-capacitor@0.1.172`
294
294
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/mobile/android-application/PATTERN.md)
295
295
  - Examples: [example/](../../skills/jskit/references/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.232`
304
+ - Owner: `@jskit-ai/realtime@0.1.234`
305
305
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/realtime/realtime-application/PATTERN.md)
306
306
  - Examples: [example/](../../skills/jskit/references/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.171`
315
+ - Owner: `@jskit-ai/rewarded-web@0.1.173`
316
316
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/rewards/google-rewarded/PATTERN.md)
317
317
  - Examples: [example/](../../skills/jskit/references/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.207`
326
+ - Owner: `@jskit-ai/agent-docs@0.1.209`
327
327
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/server/feature-package/PATTERN.md)
328
328
  - Examples: [example/](../../skills/jskit/references/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.239`
337
+ - Owner: `@jskit-ai/shell-web@0.1.241`
338
338
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/shell/application-shell/PATTERN.md)
339
339
  - Examples: [example/](../../skills/jskit/references/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.239`
348
+ - Owner: `@jskit-ai/shell-web@0.1.241`
349
349
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/ui/page-and-placement/PATTERN.md)
350
350
  - Examples: [example/](../../skills/jskit/references/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.253`
359
+ - Owner: `@jskit-ai/users-web@0.1.255`
360
360
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/users/account-settings/PATTERN.md)
361
361
  - Examples: [example/](../../skills/jskit/references/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.248`
370
+ - Owner: `@jskit-ai/users-core@0.1.250`
371
371
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/users/user-administration-server/PATTERN.md)
372
372
  - Examples: [example/](../../skills/jskit/references/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.213`
381
+ - Owner: `@jskit-ai/workspaces-core@0.1.215`
382
382
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/workspaces/workspace-server/PATTERN.md)
383
383
  - Examples: [example/](../../skills/jskit/references/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.214`
392
+ - Owner: `@jskit-ai/workspaces-web@0.1.216`
393
393
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/workspaces/workspace-surfaces/PATTERN.md)
394
394
  - Examples: [example/](../../skills/jskit/references/patterns/workspaces/workspace-surfaces/example/)
395
395
  - Requires: `@jskit-ai/shell-web`, `@jskit-ai/workspaces-core`, `@jskit-ai/workspaces-web`
@@ -305,17 +305,17 @@ Exports
305
305
  - `listClaudeConversationStorage({ configRoot, binding })`
306
306
  - `deleteClaudeConversationHistory({ configRoot, workdir, conversationId })`
307
307
  - `retireClaudeConversationHistory({ configRoot, binding, beforeDelete, requireIdle, signal })`
308
+ - `claudeHistoryPath({ configRoot, workdir, conversationId })`
308
309
  - `claudeMessageBlocks(frame, { includeNested = false } = {})`
309
310
  - `readClaudeHistory(options)`
310
311
  - `requireClaudeSessionId(id)`
311
312
  - `archivedClaudeProjectDirectory(workdir)`
312
313
  - `matchingClaudeProjectDirectories(names, directory)`
313
- Local functions
314
- - `claudeHistoryPath({ configRoot, workdir, conversationId })`
315
314
 
316
315
  ### `src/server/conversation/claudeProcess.js`
317
316
  Exports
318
317
  - `readClaudeCodeAuthStatus({ env = process.env, credentialHome = { home: env.HOME || homedir() }, command = "claude", commandRunner, signal } = {})`
318
+ - `claudeConnectionIdentity(configRoot, providerId, baseUrl, apiKey)`
319
319
  - `claudeModelConfiguration({ providerId, model: modelId }, connection)`
320
320
  - `verifyClaudeProviderKey(provider, apiKey, fetchImpl)`
321
321
  - `claudeFlagSettings({ effort = "", providerEnv, hooks, commandHook } = {})`
@@ -483,6 +483,7 @@ Exports
483
483
  - `startCodexHistoryAdapter({ token, codexHome, readHistoryPath, fetchImpl = fetch, maxRequestBytes = MAX_REQUEST_BYTES } = {})`
484
484
  - `translateCodexHistory(body, destination = "openai")`
485
485
  - `prepareCodexHistory(params, client, { baseUrl, modelProviderId, ...options } = {})`
486
+ - `readCodexHistoryRows`
486
487
  Local functions
487
488
  - `compactionHistoryError(reason, statusCode = 422)`
488
489
  - `retainedUserRecord(item)`
@@ -517,7 +518,7 @@ Exports
517
518
 
518
519
  ### `src/server/conversation/codexOutput.js`
519
520
  Exports
520
- - `createCodexAppServerOutput({ namespace, createRuntime, createStore, publish, acquireProvider, turnState, turnStateFromAgentRun, debugLog, debugError, liveProgressMaxLength, storeReadError, messageMetadata, snapshotRecoveryItemLimit })`
521
+ - `createCodexAppServerOutput({ namespace, createRuntime, createStore, publish, acquireProvider, turnState, turnStateFromAgentRun, debugLog, debugError, liveProgressMaxLength, persistCommentary = true, storeReadError, messageMetadata, snapshotRecoveryItemLimit })`
521
522
 
522
523
  ### `src/server/conversation/codexProcess.js`
523
524
  Exports
@@ -601,6 +602,7 @@ Exports
601
602
  - `shellQuote(value = "")`
602
603
  - `exportCodexNativeHistory`
603
604
  - `retireCodexConversationHistory(provider, binding, { toolHomeSource, beforeDelete, signal, errorPrefix = "" } = {})`
605
+ - `readCodexNativeGoal(databasePath, { threadId, signal } = {})`
604
606
  - `createCodexAppServerProviderOwner`
605
607
  - `codexAppServerOwnedRuntimeKey`
606
608
  - `codexAppServerRuntimeStopWasVerified`
@@ -681,7 +683,7 @@ Exports
681
683
 
682
684
  ### `src/server/conversation/codexTurn.js`
683
685
  Exports
684
- - `createCodexAppServerRunOwner({ namespace = normalizeCodexRunText, normalizeRunState = normalizeCodexAppServerRunState, debugLog = () => {}, debugError = error => normalizeCodexRunText(error?.message || error), createRuntime, createStore, publish = async () => null, acquireProvider = async () => null, providerSessions = null, serverClosingError = null, helperThreads = null, modelCatalogCacheMs = 30_000, conversationPreparation = null, storeReadError = "The session store does not support agent-run reads.", sessionIdRequiredError = "A session ID is required.", turnClaimsUnsupportedError = "The session runtime does not support Codex turn claims.", turnAlreadyRunningError = "Codex is already working on this session.", messageIdPrefix = "codex:", idlePublishPayload = null, checkpoint = async () => null, messageMetadata = {}, deliveryStateMetadataKey = "assistant_delivery", hasRuntime = () => true, recoverAdmission = null, admissionTaskFinished = () => false, outcomeNotice = async () => null, resultDeliveryFailureMessage = ({ error = "" } = {}) => { const detail = normalizeCodexRunText(error); if (!detail) return "Codex app-server finished this turn, but the assistant result text was not received."; const punctuation = [".", "!", "?"].some(character => detail.endsWith(character)) ? "" : "."; return "Codex completed, but its response could not be processed: " + detail + punctuation; }, orphanedPromptMessage = "The application restarted before Codex confirmed the message. Your message is safe; retry it.", onNotificationSignal = async () => null, captureContext = () => null, runInContext = (_context, operation) => operation(), notificationQueue = null, activeReconcileMs = 2000, finalizingGraceMs = 10000, finalizingGraceAfterHistoryRead = false, failureDetailGraceMs = 0, steerFailedCode = "codex_turn_steer_failed", interruptFailedCode = "codex_turn_interrupt_failed", errorPrefix = "" } = {})`
686
+ - `createCodexAppServerRunOwner({ namespace = normalizeCodexRunText, normalizeRunState = normalizeCodexAppServerRunState, debugLog = () => {}, debugError = error => normalizeCodexRunText(error?.message || error), createRuntime, createStore, publish = async () => null, acquireProvider = async () => null, providerSessions = null, serverClosingError = null, helperThreads = null, modelCatalogCacheMs = 30_000, conversationPreparation = null, storeReadError = "The session store does not support agent-run reads.", sessionIdRequiredError = "A session ID is required.", turnClaimsUnsupportedError = "The session runtime does not support Codex turn claims.", turnAlreadyRunningError = "Codex is already working on this session.", messageIdPrefix = "codex:", idlePublishPayload = null, checkpoint = async () => null, messageMetadata = {}, persistCommentary = true, deliveryStateMetadataKey = "assistant_delivery", hasRuntime = () => true, recoverAdmission = null, admissionTaskFinished = () => false, outcomeNotice = async () => null, resultDeliveryFailureMessage = ({ error = "" } = {}) => { const detail = normalizeCodexRunText(error); if (!detail) return "Codex app-server finished this turn, but the assistant result text was not received."; const punctuation = [".", "!", "?"].some(character => detail.endsWith(character)) ? "" : "."; return "Codex completed, but its response could not be processed: " + detail + punctuation; }, orphanedPromptMessage = "The application restarted before Codex confirmed the message. Your message is safe; retry it.", onNotificationSignal = async () => null, captureContext = () => null, runInContext = (_context, operation) => operation(), notificationQueue = null, activeReconcileMs = 2000, finalizingGraceMs = 10000, finalizingGraceAfterHistoryRead = false, failureDetailGraceMs = 0, steerFailedCode = "codex_turn_steer_failed", interruptFailedCode = "codex_turn_interrupt_failed", errorPrefix = "" } = {})`
685
687
  - `CODEX_APP_SERVER_RUN_STATE`
686
688
  - `normalizeCodexAppServerRunState`
687
689
  - `codexAppServerRunStateIsActive`
@@ -799,7 +801,7 @@ Exports
799
801
  Exports
800
802
  - `conversationMessageIdentity(turnId, message)`
801
803
  - `conversationMessageVersion(message, { includeData = false } = {})`
802
- - `createConversationChangeover({ state, transcript, agent, identity, presentation = {}, log = () => {}, captureContext = false, applicationMessages = false })`
804
+ - `createConversationChangeover({ state, transcript, agent, identity, presentation = {}, log = () => {}, captureContext = false, applicationMessages = false, maximumInitialMessages = 30, maximumInitialMessageCharacters = Infinity })`
803
805
  - `conversationHistoryVersions(history)`
804
806
  - `conversationRequestText({ text, origin, data })`
805
807
  - `conversationContinuity({ history, briefing = "", maximumCharacters = 128_000 })`
@@ -820,7 +822,9 @@ Exports
820
822
  - `createConversationTranscript`
821
823
  - `conversationMessageIdentity`
822
824
  - `conversationMessageVersion`
825
+ - `conversationHistoryVersions`
823
826
  - `createConversationChangeover`
827
+ - `conversationRequestText`
824
828
  - `createMemoryConversationStorage`
825
829
  - `createConversationStorage`
826
830
  - `createReentrantConversationStorage`
@@ -851,6 +855,7 @@ Exports
851
855
 
852
856
  ### `src/server/conversation/nativeHistoryExport.js`
853
857
  Exports
858
+ - `readStoppedNativeDatabase(databasePath, read, { signal } = {})`
854
859
  - `canonicalNativeHistoryJson(value)`
855
860
  - `createNativeHistoryExport(onRecord, { signal, maxBytes = 2 * 1024 ** 3 } = {})`
856
861
  - `retireNativeConversation({ binding, inspect, remove, beforeDelete, readConversation, exportConversation })`
@@ -866,6 +871,7 @@ Exports
866
871
 
867
872
  ### `src/server/conversation/openCodeClient.js`
868
873
  Exports
874
+ - `readOpenCodeConversationDatabase({ databasePath, conversationId, onMessage, signal } = {})`
869
875
  - `retireOpenCodeConversationHistory(storageClient, controlClient, binding, options = {})`
870
876
  - `openCodeAssistantMessageText(message = {})`
871
877
  - `OPENCODE_RESPONSE_LIMIT_BYTES`
@@ -956,7 +962,7 @@ Exports
956
962
  - `openCodeStructuredOutput(value = "")`
957
963
  - `observeOpenCodeEvents(client, conversationId, { abortController, signal = abortController.signal, ...options } = {})`
958
964
  - `openCodeMessageError(message = {})`
959
- - `inspectOpenCodeMessageAdmission(client, conversationId, inputMessageId, { signal = AbortSignal.timeout(OPENCODE_INTERRUPT_TIMEOUT_MS) } = {})`
965
+ - `inspectOpenCodeMessageAdmission(client, conversationId, inputMessageId, { signal = AbortSignal.timeout(OPENCODE_INTERRUPT_TIMEOUT_MS), wait = false, readFailure = () => null } = {})`
960
966
  - `steerOpenCodeTurn(client, conversationId, turn, input, { signal } = {})`
961
967
  - `dispatchOpenCodeTurn(client, conversationId, turn, input, options = {})`
962
968
  - `openCodeMessageRows(value = null)`
@@ -1041,7 +1047,7 @@ Local functions
1041
1047
 
1042
1048
  ### `src/server/conversation/runtime.js`
1043
1049
  Exports
1044
- - `createConversationRuntime({ engine: defaultEngine = "api", defaultIntegrationId, storage, authorize, connections, apiClientFactory, apiHistory, actions, toolPolicy, toolCatalog, attachments, fetch, host: defaultHost, limits = {} } = {})`
1050
+ - `createConversationRuntime({ engine: defaultEngine = "api", defaultIntegrationId, storage, authorize, connections, apiClientFactory, apiHistory, actions, toolPolicy, toolCatalog, attachments, fetch, host: defaultHost, persistCommentary = true, completedEnvelope = false, limits = {} } = {})`
1045
1051
  Local functions
1046
1052
  - `failure(message, code, statusCode = 409)`
1047
1053
  - `submittedMessage(turn)`
@@ -1053,13 +1059,18 @@ Local functions
1053
1059
  ### `src/server/conversation/runtimeStateUpgrade.js`
1054
1060
  Exports
1055
1061
  - `hasUnfinishedConversationRewind(runtime)`
1056
- - `upgradeConversationRuntimeState({ metadata, conversationLog })`
1062
+ - `createConversationRuntimeReplacement({ request, engine, configuration, reason, segmentId, continuity, seen, destination })`
1063
+ - `releaseConversationRuntimeBinding(state, pending, request, engine)`
1064
+ - `finishConversationRuntimeReplacement(state, { engine, selection, retireNative, pending, value })`
1065
+ - `createInertCodexConversationBinding({ workdir, configRoot })`
1066
+ - `upgradeConversationRuntimeState({ metadata, conversationLog, retirement })`
1057
1067
  Local functions
1058
1068
  - `object(value)`
1059
1069
  - `invalid(message)`
1060
1070
  - `validateSegment(segment)`
1061
1071
  - `nativeIdentity(segment)`
1062
1072
  - `inspectRequest(request, segment, version, warnings)`
1073
+ - `retireCodexBinding(runtime, retirement)`
1063
1074
 
1064
1075
  ### `src/server/conversation/storage.js`
1065
1076
  Exports
@@ -1089,16 +1100,18 @@ Exports
1089
1100
 
1090
1101
  ### `src/server/conversation/tools.js`
1091
1102
  Exports
1092
- - `createConversationTools({ catalog, context, prepareContext, signal: turnSignal, previousCalls = [], authorize, save, emit, maximumCalls = 32, discoveryOnly = false, transient = false, propagateErrors = false })`
1103
+ - `createConversationTools({ catalog, toolSet: retainedToolSet, context, prepareContext, signal: turnSignal, previousCalls = [], authorize, save, emit, maximumCalls = 32, discoveryOnly = false, transient = false, propagateErrors = false })`
1093
1104
 
1094
1105
  ### `src/server/conversation/transcript.js`
1095
1106
  Exports
1096
1107
  - `createConversationTranscript({ storage, clock = () => new Date(), applicationTurns = false } = {})`
1108
+ - `isCompletedEnvelopeTurn(turn)`
1097
1109
  Local functions
1098
1110
  - `hasMessages(turn)`
1099
1111
 
1100
1112
  ### `src/server/hosts/claudeHistory.js`
1101
1113
  Exports
1114
+ - `claudeHistoryPath`
1102
1115
  - `listClaudeConversationStorage`
1103
1116
  - `readClaudeHistory`
1104
1117
  - `retireClaudeConversationHistory`
@@ -1107,6 +1120,7 @@ Exports
1107
1120
  Exports
1108
1121
  - `bindClaudeConversationAccount`
1109
1122
  - `claudeCodeArguments`
1123
+ - `claudeConnectionIdentity`
1110
1124
  - `claudeCatalogueModels`
1111
1125
  - `claudeFlagSettings`
1112
1126
  - `claudeModelConfiguration`
@@ -1202,10 +1216,12 @@ Exports
1202
1216
  - `ensureCodexAppServerThread`
1203
1217
  - `inspectCodexAppServerMessageAdmission`
1204
1218
  - `retireCodexConversationHistory`
1219
+ - `readCodexNativeGoal`
1205
1220
  - `resumeExactCodexAppServerThread`
1206
1221
  - `sendCodexAppServerPrompt`
1207
1222
  - `shellQuote`
1208
1223
  - `startFreshCodexAppServerThread`
1224
+ - `readCodexHistoryRows`
1209
1225
 
1210
1226
  ### `src/server/hosts/codexTurn.js`
1211
1227
  Exports
@@ -1232,6 +1248,7 @@ Exports
1232
1248
 
1233
1249
  ### `src/server/hosts/nativeHistory.js`
1234
1250
  Exports
1251
+ - `readStoppedNativeDatabase`
1235
1252
  - `retireNativeConversation`
1236
1253
 
1237
1254
  ### `src/server/hosts/openCodeClient.js`
@@ -1240,6 +1257,7 @@ Exports
1240
1257
  - `createOpenCodeServerClient`
1241
1258
  - `openCodeAssistantMessageText`
1242
1259
  - `readBoundedResponse`
1260
+ - `readOpenCodeConversationDatabase`
1243
1261
  - `retireOpenCodeConversationHistory`
1244
1262
 
1245
1263
  ### `src/server/hosts/openCodeProcess.js`
@@ -1272,6 +1290,7 @@ Exports
1272
1290
  - `openCodeDetachedPrompt`
1273
1291
  - `openCodeMessageError`
1274
1292
  - `openCodeRowsForInput`
1293
+ - `openCodeLastAssistantResult`
1275
1294
  - `openCodeStructuredOutput`
1276
1295
  - `runOpenCodeConversationTurn`
1277
1296
 
@@ -1295,6 +1314,8 @@ Exports
1295
1314
  - `sanitizeAssistantMessageText`
1296
1315
  - `runAssistantToolLoop`
1297
1316
  - `runBoundedAssistantToolLoop`
1317
+ - `readAssistantResponseEnvelope`
1318
+ - `readPartialAssistantReply`
1298
1319
 
1299
1320
  ### `src/server/lib/aiClient.js`
1300
1321
  Exports
@@ -1319,7 +1340,9 @@ Local functions
1319
1340
  ### `src/server/lib/assistantToolLoop.js`
1320
1341
  Exports
1321
1342
  - `runAssistantToolLoop({ messages, input, toolSet, toToolSchema, complete, executeToolCalls, finish, preserveWhitespace = false })`
1322
- - `runBoundedAssistantToolLoop({ prompt, signal, policy, complete, outputSchema, limitError, invalidResponseError = new Error("The assistant returned an invalid response."), failureError = new Error("The assistant could not complete this request."), toolCatalog, toolContext })`
1343
+ - `runBoundedAssistantToolLoop({ prompt, signal, policy, complete, outputSchema, limitError, invalidResponseError = new Error("The assistant returned an invalid response."), failureError = new Error("The assistant could not complete this request."), toolCatalog, toolContext, completedEnvelope = false, settle })`
1344
+ - `readAssistantResponseEnvelope(text)`
1345
+ - `readPartialAssistantReply(text)`
1323
1346
  Local functions
1324
1347
  - `requiresCurrentTime(value = "")`
1325
1348
  - `resolvePreflightTools(toolDescriptors = [], input = "")`
@@ -45,10 +45,11 @@ Local functions
45
45
  - `compareTurnIds(left, right)`
46
46
  - `isQuestionConfiguration(value)`
47
47
  - `draftAfterAcceptedSubmission(currentDraft = "", submittedDraft = "")`
48
- - `createConversation(identity, { api, socket, actorKey, placement, readers, queueWhileSending, deferWhileWorking, draftStorage, application, goalReadEnabled })`
48
+ - `resolveWorkingPolicy(snapshot, { deferWhileWorking, admitWhileWorking })`
49
+ - `createConversation(identity, { api, socket, actorKey, placement, readers, queueWhileSending, deferWhileWorking, admitWhileWorking, draftStorage, application, goalReadEnabled })`
49
50
  - `useBoundedTask({ command, endpoint, scope, input, result, onResult }, { active, data, presentation })`
50
51
  - `conversationBindingSetup({ socket, boundedTask = null } = {})`
51
- - `createConversationBinding({ conversationId, endpoint = "", surfaceId = "", hostSurfaceId = "", workspaceSlug, actorKey: suppliedActorKey, api: suppliedApi = null, socket: suppliedSocket = null, active = true, onEvent, clearDraftOn: suppliedClearDraftOn, queueWhileSending, deferWhileWorking = false, draftWhileLoading = false, draftStorage = null, application = null, boundedTask = null, data, attachments = null, suggestions = null, models = null, questions = null, goal = null, presentation = {} } = {}, setup)`
52
+ - `createConversationBinding({ conversationId, endpoint = "", surfaceId = "", hostSurfaceId = "", workspaceSlug, actorKey: suppliedActorKey, api: suppliedApi = null, socket: suppliedSocket = null, active = true, onEvent, clearDraftOn: suppliedClearDraftOn, queueWhileSending, deferWhileWorking = false, admitWhileWorking = false, draftWhileLoading = false, draftStorage = null, application = null, boundedTask = null, data, attachments = null, suggestions = null, models = null, questions = null, goal = null, presentation = {} } = {}, setup)`
52
53
 
53
54
  ### `src/client/composables/useAssistantRuntime.js`
54
55
  Exports
@@ -40,6 +40,7 @@ Exports
40
40
  ### `src/synthesisProcess.js`
41
41
  Exports
42
42
  - `createSynthesisProcess(configuration, { outputSampleRate, signal = null, workerUrl = new URL("./synthesisWorker.js", import.meta.url) } = {})`
43
+ - `SYNTHESIS_REQUEST_TIMEOUT_MS`
43
44
 
44
45
  ### `src/synthesisWorker.js`
45
46
  Exports
@@ -171,6 +171,7 @@ Exports
171
171
  - `VOICE_MAX_SPEECH_CHUNK_CHARACTERS`
172
172
  - `VOICE_MAX_SPEECH_TEXT_CHARACTERS`
173
173
  - `VOICE_MAX_UTTERANCE_SECONDS`
174
+ - `VOICE_MAX_SYNTHESIS_TIMEOUT_MS`
174
175
  - `VOICE_OUTPUT_SAMPLE_RATE`
175
176
  - `VOICE_PROTOCOL_VERSION`
176
177
  - `assertVoiceAudioFrame(frame = null)`
@@ -14,6 +14,21 @@ Use this on demand; do not load the full index at startup.
14
14
 
15
15
  ### src
16
16
 
17
+ ### `src/architecture/cli.js`
18
+ Exports
19
+ - None
20
+
21
+ ### `src/architecture/inspectVueArchitecture.js`
22
+ Exports
23
+ - `inspectVueArchitecture({ projectRoot, input, aliases = {}, httpScope = "", apiBasePath = "" })`
24
+ Local functions
25
+ - `hash(source)`
26
+ - `canonical(value)`
27
+ - `property(node, key)`
28
+ - `nodes(root)`
29
+ - `staticValue(node, bindings, seen = new Set())`
30
+ - `bindingNode(node, bindings, seen = new Set())`
31
+
17
32
  ### `src/client/asyncModuleRecovery/index.js`
18
33
  Exports
19
34
  - `SHELL_ASYNC_MODULE_RECOVERY_RUNTIME_KEY`
@@ -20,6 +20,15 @@ patterns, or treat it as evidence for a different implementation through the
20
20
  same public APIs. If its owner runtime package is already installed at a
21
21
  different version, prefer that package's version-matched pattern.
22
22
 
23
+ **Implement from the documented contract, then verify.** Once the relevant
24
+ guide and example answer the task, stop reading and build the smallest working
25
+ slice. Do not trace framework or dependency internals to confirm documented
26
+ options, routing, package discovery, transport, or lifecycle behaviour before
27
+ trying the documented API. Inspect implementation source only for a concrete
28
+ failure or an API question the guide and example cannot answer. Name that
29
+ failure or question first, inspect only its relevant owner, then return to
30
+ implementation and verification. Do not tour a dependency tree for confidence.
31
+
23
32
  Do not write or consult receipts, provenance, completion ledgers, or other
24
33
  durable bookkeeping for pattern or authoring-tool runs. Current source,
25
34
  manifests, migrations, tests, and runtime behaviour are the evidence.
@@ -58,13 +67,17 @@ installed packages directly, edit app-owned files deliberately, and use npm
58
67
  for dependency installation.
59
68
 
60
69
  Finish a dependency installation before inspecting the installed package or
61
- changing the same manifest/lockfile; do not overlap npm operations on one app. Import
62
- subpaths are package `exports` aliases, not physical file paths: a package may
63
- map `client/...` to `src/client/...` and keep shared code outside `src`. If source
64
- inspection is still needed, resolve the import with the installed `package.json`
65
- `exports` or `import.meta.resolve()`, or locate the file with `rg --files` before
66
- opening it. Do not guess a package's directory layout. Use the documented option
67
- when the guide or pattern already explains the required behaviour.
70
+ changing the same manifest/lockfile; do not overlap npm operations on one app.
71
+
72
+ **Discover the file, then read it. Do not infer its location from a convention.**
73
+ Use paths identified in the current tree, installed metadata, or the relevant
74
+ example. Before inspecting an unfamiliar package, use `rg --files` on its
75
+ observed directory and select the relevant files from that inventory; do not
76
+ try guessed source directories. Import subpaths are `exports` aliases, not
77
+ physical paths: resolve them through installed `package.json#exports` or
78
+ `import.meta.resolve()` when following an import. This rule applies to every
79
+ package and task, not only CRUDs. Use the documented option when the guide or
80
+ pattern already explains the behaviour instead of inspecting internals.
68
81
 
69
82
  ## Implement a change
70
83