@jskit-ai/agent-docs 0.1.244 → 0.1.246

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 (32) hide show
  1. package/guide/agent/app-setup/multi-homing.md +189 -1
  2. package/package.json +1 -1
  3. package/patterns/feature-package/example/booking-engine/package.json +1 -1
  4. package/patterns/minimal-foundation/example/package.json +3 -3
  5. package/patterns/shell-foundation/example/package.json +4 -4
  6. package/patterns/shell-foundation/example/packages/main/package.json +1 -1
  7. package/reference/autogen/PATTERN_INDEX.md +37 -37
  8. package/reference/autogen/README.md +1 -0
  9. package/reference/autogen/packages/architecture-inspector.md +85 -0
  10. package/reference/autogen/packages/assistant-core.md +1 -0
  11. package/reference/autogen/packages/shell-web.md +1 -62
  12. package/reference/autogen/packages/workspaces-core.md +4 -3
  13. package/reference/autogen/packages/workspaces-web.md +25 -2
  14. package/skills/jskit/references/multi-homing.md +189 -1
  15. package/skills/jskit/references/pattern-index.md +37 -37
  16. package/skills/jskit/references/patterns/app/minimal-foundation/example/package.json +3 -3
  17. package/skills/jskit/references/patterns/app/shell-foundation/example/package.json +4 -4
  18. package/skills/jskit/references/patterns/app/shell-foundation/example/packages/main/package.json +1 -1
  19. package/skills/jskit/references/patterns/auth/accounts-hub/example/package.json +2 -2
  20. package/skills/jskit/references/patterns/auth/oidc-sign-in/example/package.json +2 -2
  21. package/skills/jskit/references/patterns/auth/supabase-auth/example/package.json +1 -1
  22. package/skills/jskit/references/patterns/connectors/calendar-cli/example/package.json +4 -4
  23. package/skills/jskit/references/patterns/crud/json-api-resource-package/example/packages/books/package.json +2 -2
  24. package/skills/jskit/references/patterns/database/mysql-application/example/package.json +1 -1
  25. package/skills/jskit/references/patterns/database/postgres-application/example/package.json +1 -1
  26. package/skills/jskit/references/patterns/realtime/realtime-application/example/package.json +2 -2
  27. package/skills/jskit/references/patterns/server/feature-package/example/booking-engine/package.json +1 -1
  28. package/skills/jskit/references/patterns/users/user-administration-server/example/packages/users/package.json +2 -2
  29. package/skills/jskit/references/patterns/users/user-administration-server/example/packages/users-workspace/package.json +3 -3
  30. package/skills/jskit/references/patterns/workspaces/workspace-server/PATTERN.md +6 -0
  31. package/skills/jskit/references/patterns/workspaces/workspace-surfaces/PATTERN.md +10 -2
  32. package/skills/jskit/references/patterns/workspaces/workspace-surfaces/example/src/pages/home/workspaces/index.vue +7 -0
package/guide/agent/app-setup/multi-homing.md CHANGED
@@ -26,6 +26,70 @@ Choose whether the product is:
26
26
  Do not add workspace machinery to a product that only needs an owner id on one
27
27
  domain record.
28
28
 
29
+ Set the model with `tenancyMode` and `tenancyPolicy` in `config/public.js`:
30
+
31
+ | `tenancyMode` | Workspaces | First workspace | Creating more |
32
+ | --- | --- | --- | --- |
33
+ | `none` | None | None | No |
34
+ | `personal` | One personal workspace per user | Always provisioned | No |
35
+ | `workspaces` | Named workspaces with membership, invitations and switching | Only with `tenancyPolicy.workspace.autoProvision: true` | With `tenancyPolicy.workspace.allowSelfCreate: true` |
36
+
37
+ In `workspaces` mode the product chooses one of two styles:
38
+
39
+ - **Team-first** (the default, `autoProvision` unset or `false`): a new account
40
+ has no workspace until it creates one or accepts an invitation. Mount the
41
+ **Your workspaces** page (see [Browser composition](#browser-composition)) so
42
+ these people can do either.
43
+ - **Personal workspace plus shared workspaces** (`autoProvision: true`): every
44
+ user, including people who signed up through an invitation, owns one personal
45
+ workspace and can also join or create others.
46
+
47
+ ```js
48
+ // config/public.js
49
+ config.tenancyMode = "workspaces";
50
+ config.tenancyPolicy = {
51
+ workspace: {
52
+ allowSelfCreate: true,
53
+ autoProvision: true
54
+ }
55
+ };
56
+ ```
57
+
58
+ Provisioning runs in the users profile-sync lifecycle after registration and
59
+ sign-in. The first run creates the personal workspace, its owner membership and
60
+ its settings; later runs reuse it. The default name is the user's display name,
61
+ or email, followed by "'s Workspace". Set `personalWorkspaceName` in
62
+ `config/server.js` to choose another; it receives the synchronized profile
63
+ (`id`, `displayName`, `email`, `username`), and an empty result keeps the default:
64
+
65
+ ```js
66
+ // config/server.js
67
+ config.personalWorkspaceName = (user) => `${user.displayName || user.email}'s home`;
68
+ ```
69
+
70
+ ### Development sign-in
71
+
72
+ Development sign-in (`POST /api/dev-auth/login-as`, used by the Playwright
73
+ `loginAsExistingUser()` helper and managed previews) signs in as an existing
74
+ user without changing data. It does not run the profile-sync lifecycle, so
75
+ workspace provisioning and other lifecycle contributors do not run. Create the
76
+ workspaces that seeded users need in seed data, or sign in normally once.
77
+
78
+ ## Data model
79
+
80
+ The package migrations create and own these tables:
81
+
82
+ | Table | Columns that applications use |
83
+ | --- | --- |
84
+ | `workspaces` | `id`, `slug` (unique), `name`, `owner_user_id`, `is_personal`, `avatar_url`, `deleted_at` |
85
+ | `workspace_memberships` | `workspace_id`, `user_id`, `role_sid`, `status`; one row per workspace and user |
86
+ | `workspace_settings` | One row per workspace keyed by `workspace_id`: the eight palette colours and `invites_enabled` |
87
+ | `workspace_invites` | `workspace_id`, `email`, `role_sid`, `status`, `token_hash`, `invited_by_user_id`, `expires_at`, `accepted_at`, `revoked_at` |
88
+
89
+ Application records that belong to a workspace use a non-null `workspace_id`
90
+ foreign key to `workspaces.id`. Read and change these tables through the
91
+ `workspaces.core` repositories and services, not directly.
92
+
29
93
  ## Server composition
30
94
 
31
95
  Use `workspaces/workspace-server` for role vocabulary, creation policy,
@@ -35,6 +99,103 @@ Workspace scope must reach repository queries. Parsing a workspace slug or
35
99
  hiding an admin link is not authorization. Membership and role checks happen
36
100
  before an operation discloses records or record existence.
37
101
 
102
+ ### Workspace-scoped features and routes
103
+
104
+ For a standard CRUD resource owned by a workspace, give its table the
105
+ `workspace_id` column, set the resource's `autofilter: "workspace"`, and bind
106
+ `defineCrudJsonApiFeature()` with `ownershipFilter: "workspace"` on a workspace
107
+ surface. JSKIT then filters `workspaceId` by the workspace in the route.
108
+ `workspace_user` also filters by the signed-in user. See the CRUD operations
109
+ guide.
110
+
111
+ A hand-written route registers under `/api/w/:workspaceSlug/...` with
112
+ `contextPolicy: "required"`:
113
+
114
+ ```js
115
+ router.register(
116
+ "GET",
117
+ "/api/w/:workspaceSlug/projects",
118
+ {
119
+ auth: "required",
120
+ surface: "app",
121
+ contextPolicy: "required",
122
+ permission: "projects.view" // optional
123
+ },
124
+ async function (request, reply) {
125
+ const projects = await projectsService.listForWorkspace(request.workspace.id);
126
+ // ...
127
+ }
128
+ );
129
+ ```
130
+
131
+ Before the handler runs, the auth plugin resolves the slug for the signed-in
132
+ user and sets `request.workspace`, `request.membership` (including `roleSid`
133
+ and `status`) and `request.permissions`. An unknown slug returns 404 and a
134
+ non-member receives 403, unless the route's `surface` uses an access policy with
135
+ `requireWorkspaceMembership: false`. A route with `permission` returns 403 when
136
+ the membership lacks it. Scope queries with `request.workspace.id`; never take a
137
+ workspace id from request input.
138
+
139
+ ### Workspace services from another feature
140
+
141
+ Declare `workspaces: "workspaces.core"` in the feature's `requires`. The
142
+ capability provides:
143
+
144
+ | Member | Use |
145
+ | --- | --- |
146
+ | `workspaces.services.directory` | Workspace lists, context by slug, creation and provisioning |
147
+ | `workspaces.services.members` | Members, roles and invitations |
148
+ | `workspaces.services.pendingInvitations` | Invitation resolution, redemption and acceptance participants |
149
+ | `workspaces.services.settings` | Workspace settings |
150
+ | `workspaces.repositories.workspaces`, `.workspaceMemberships`, `.workspaceSettings`, `.workspaceInvites` | Repository access inside the application's own transactions |
151
+ | `workspaces.tenancyProfile` | The resolved tenancy mode and workspace policy |
152
+
153
+ ### Invitation email
154
+
155
+ To send invitation email, set a mailer in `config/server.js`. Without one,
156
+ invitations are still created and delivery reports `mailer_unconfigured`.
157
+ `workspaceInviteMailer` is an object whose `sendWorkspaceInvite(message,
158
+ options)` receives `{ email, inviteUrl, workspace, inviter, roleSid, expiresAt,
159
+ message }`, where the inner `message` is the rendered `{ subject, text, html }`.
160
+ `workspaceInviteEmailTemplate` is an optional function that renders that inner
161
+ message; it receives `{ email, inviteUrl, workspace, inviter, roleSid,
162
+ roleLabel, expiresAt }` (`roleLabel` only when configured). Invitation links use `/invite/:token` unless
163
+ `workspaceInvitations.invitePath` names another path. The
164
+ `workspaces/workspace-server` pattern includes an example renderer.
165
+
166
+ ### Workspace colours
167
+
168
+ Each workspace stores a light and a dark palette in `workspace_settings`. On
169
+ workspace routes, `workspaces-web` switches Vuetify to the `workspace-light` or
170
+ `workspace-dark` theme, built from the application's own theme with `primary`,
171
+ `secondary`, `surface` and `surface-variant` replaced by the workspace's
172
+ colours. Other routes use the application's themes.
173
+
174
+ New workspaces start from JSKIT's blue palette unless `config/server.js` sets
175
+ the application's own. Missing fields keep JSKIT's values; an invalid colour
176
+ stops the server at startup:
177
+
178
+ ```js
179
+ // config/server.js
180
+ config.workspaceSettings = {
181
+ defaults: {
182
+ invitesEnabled: true,
183
+ lightPrimaryColor: "#1C1C1C",
184
+ lightSecondaryColor: "#5C5C5C",
185
+ lightSurfaceColor: "#FFFFFF",
186
+ lightSurfaceVariantColor: "#424242",
187
+ darkPrimaryColor: "#F5F5F5",
188
+ darkSecondaryColor: "#BDBDBD",
189
+ darkSurfaceColor: "#121212",
190
+ darkSurfaceVariantColor: "#C8C8C8"
191
+ }
192
+ };
193
+ ```
194
+
195
+ Defaults apply when a workspace is created. Existing workspaces keep their
196
+ stored colours; change them with `PATCH /api/w/:workspaceSlug/settings` or
197
+ `workspaces.services.settings.updateWorkspaceSettings(workspace, patch)`.
198
+
38
199
  `workspace_authenticated` and similar policies must implement their documented
39
200
  membership semantics exactly; do not synthesize memberships to compensate for
40
201
  a policy/runtime mismatch.
@@ -265,7 +426,34 @@ placements.
265
426
 
266
427
  The route slug, selected workspace, query keys, and server scope stay aligned.
267
428
  Invalid workspace URLs show a deliberate not-found/forbidden state instead of
268
- silently selecting another workspace.
429
+ silently selecting another workspace. The browser waits for the server's answer
430
+ about an unknown slug before deciding, so the surface can show that state.
431
+
432
+ ### Surfaces and where `/` lands
433
+
434
+ Workspace surfaces put the slug in their pages root, such as
435
+ `pagesRoot: "w/[workspaceSlug]"` with `requiresWorkspace: true`, and
436
+ `w/[workspaceSlug]/admin` for administration. Keep the default surface
437
+ (`surfaceDefaultId`, usually `home`) free of a workspace requirement: `/`,
438
+ invitation links and other unscoped pages belong to it. With
439
+ `webRootAllowed: "no"`, `/` opens that surface's root.
440
+
441
+ `workspaces-web` remembers the last workspace each person opened in this
442
+ browser. The **Your workspaces** page, `WorkspacesClientElement` from
443
+ `@jskit-ai/workspaces-web/client/components/WorkspacesClientElement`, uses it:
444
+
445
+ 1. With pending invitations, it shows them so the person can join or refuse.
446
+ 2. Otherwise it opens the last workspace used in this browser, if the person is
447
+ still a member, or their only workspace.
448
+ 3. Otherwise it lists their workspaces and, when they have none and
449
+ `allowSelfCreate` is on, offers to create the first one.
450
+
451
+ The page sends signed-out visitors to sign in. The
452
+ `workspaces/workspace-surfaces` pattern mounts it at `/home/workspaces`. The
453
+ product decides where people land: keep a public landing page at `/home` that
454
+ links signed-in people there, or mount the page at `/home` itself so everyone
455
+ goes straight to sign-in or into their workspace. Applications may replace it
456
+ with their own page.
269
457
 
270
458
  Loading uses skeletons; mutation errors use toasts. Warm-cache and browser
271
459
  back/forward navigation must restore the correct workspace context.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@jskit-ai/agent-docs",
3
- "version": "0.1.244",
3
+ "version": "0.1.246",
4
4
  "description": "Distributed JSKIT agent references, prompts, guides, and generated reference maps.",
5
5
  "type": "module",
6
6
  "files": [
package/patterns/feature-package/example/booking-engine/package.json CHANGED
@@ -5,7 +5,7 @@
5
5
  "private": true,
6
6
  "type": "module",
7
7
  "dependencies": {
8
- "@jskit-ai/kernel": "0.1.246",
8
+ "@jskit-ai/kernel": "0.1.247",
9
9
  "json-rest-schema": "^1.0.17"
10
10
  },
11
11
  "exports": {
package/patterns/minimal-foundation/example/package.json CHANGED
@@ -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.246",
37
+ "@jskit-ai/kernel": "0.1.247",
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.44",
43
43
  "vue-router": "^5.3.1",
44
44
  "vuetify": "^4.1.2",
45
- "@jskit-ai/http-runtime": "0.1.244",
45
+ "@jskit-ai/http-runtime": "0.1.245",
46
46
  "@fastify/fast-json-stringify-compiler": "^5.1.0",
47
47
  "@vue/devtools-api": "^8.2.1"
48
48
  },
49
49
  "devDependencies": {
50
50
  "@jskit-ai/config-eslint": "0.1.241",
51
- "@jskit-ai/jskit-catalog": "0.1.297",
51
+ "@jskit-ai/jskit-catalog": "0.1.299",
52
52
  "@playwright/test": "1.61.1",
53
53
  "@vitejs/plugin-vue": "^6.0.7",
54
54
  "eslint": "^10.8.0",
package/patterns/shell-foundation/example/package.json CHANGED
@@ -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.246",
37
+ "@jskit-ai/kernel": "0.1.247",
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.44",
43
43
  "vue-router": "^5.3.1",
44
44
  "vuetify": "^4.1.2",
45
- "@jskit-ai/http-runtime": "0.1.244",
45
+ "@jskit-ai/http-runtime": "0.1.245",
46
46
  "@mdi/js": "^7.4.47",
47
- "@jskit-ai/shell-web": "0.1.252",
47
+ "@jskit-ai/shell-web": "0.1.254",
48
48
  "@fastify/fast-json-stringify-compiler": "^5.1.0",
49
49
  "@vue/devtools-api": "^8.2.1"
50
50
  },
51
51
  "devDependencies": {
52
52
  "@jskit-ai/config-eslint": "0.1.241",
53
- "@jskit-ai/jskit-catalog": "0.1.297",
53
+ "@jskit-ai/jskit-catalog": "0.1.299",
54
54
  "@playwright/test": "1.61.1",
55
55
  "@vitejs/plugin-vue": "^6.0.7",
56
56
  "eslint": "^10.8.0",
package/patterns/shell-foundation/example/packages/main/package.json CHANGED
@@ -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.246"
12
+ "@jskit-ai/kernel": "0.1.247"
13
13
  },
14
14
  "jskit": {
15
15
  "kind": "runtime",
package/reference/autogen/PATTERN_INDEX.md CHANGED
@@ -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.244`
18
+ - Owner: `@jskit-ai/agent-docs@0.1.246`
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.244`
29
+ - Owner: `@jskit-ai/agent-docs@0.1.246`
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.235`
40
+ - Owner: `@jskit-ai/assistant-runtime@0.1.237`
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 @@ Run one OpenID Connect sign-in for all of an owner's apps as its own JSKIT proje
48
48
 
49
49
  - Id: `auth/accounts-hub`
50
50
  - Keywords: `accounts hub`, `auth`, `authentication`, `issuer`, `master login`, `oidc`, `openid connect`, `single sign-on`, `sso`
51
- - Owner: `@jskit-ai/oidc-issuer-core@0.1.2`
51
+ - Owner: `@jskit-ai/oidc-issuer-core@0.1.3`
52
52
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/auth/accounts-hub/PATTERN.md)
53
53
  - Examples: [example/](../../skills/jskit/references/patterns/auth/accounts-hub/example/)
54
54
  - Requires: `@jskit-ai/oidc-issuer-core`
@@ -59,7 +59,7 @@ Compose JSKIT authentication routes, views, profile controls, and public surface
59
59
 
60
60
  - Id: `auth/auth-surface`
61
61
  - Keywords: `account`, `auth`, `login`, `logout`, `password`, `placement`, `profile`, `reset`, `surface`
62
- - Owner: `@jskit-ai/auth-web@0.1.248`
62
+ - Owner: `@jskit-ai/auth-web@0.1.250`
63
63
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/auth/auth-surface/PATTERN.md)
64
64
  - Examples: [example/](../../skills/jskit/references/patterns/auth/auth-surface/example/)
65
65
  - Requires: `@jskit-ai/auth-core`, `@jskit-ai/auth-web`, `@jskit-ai/shell-web`
@@ -70,7 +70,7 @@ Let people sign in with the accounts they already have in an accounts hub or ano
70
70
 
71
71
  - Id: `auth/oidc-sign-in`
72
72
  - Keywords: `accounts hub`, `auth`, `authentication`, `back-channel logout`, `dynamic client registration`, `issuer`, `master login`, `oidc`, `openid connect`, `single sign-on`, `sso`
73
- - Owner: `@jskit-ai/auth-provider-oidc-core@0.1.2`
73
+ - Owner: `@jskit-ai/auth-provider-oidc-core@0.1.4`
74
74
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/auth/oidc-sign-in/PATTERN.md)
75
75
  - Examples: [example/](../../skills/jskit/references/patterns/auth/oidc-sign-in/example/)
76
76
  - Requires: `@jskit-ai/auth-provider-oidc-core`, `@jskit-ai/auth-web`
@@ -81,7 +81,7 @@ Add Supabase authentication through normal npm composition, explicit environment
81
81
 
82
82
  - Id: `auth/supabase-auth`
83
83
  - Keywords: `auth`, `authentication`, `oauth`, `sessions`, `supabase`
84
- - Owner: `@jskit-ai/auth-provider-supabase-core@0.1.243`
84
+ - Owner: `@jskit-ai/auth-provider-supabase-core@0.1.244`
85
85
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/auth/supabase-auth/PATTERN.md)
86
86
  - Examples: [example/](../../skills/jskit/references/patterns/auth/supabase-auth/example/)
87
87
  - Requires: `@jskit-ai/auth-provider-supabase-core`
@@ -92,7 +92,7 @@ Resolve an administrator environment key or an individual user's grant, then use
92
92
 
93
93
  - Id: `connectors/ai-connections`
94
94
  - Keywords: `ai`, `api-key`, `cli`, `environment`, `free`, `models`, `ownership`, `zai`, `zen`
95
- - Owner: `@jskit-ai/connectors-catalog@0.1.65`
95
+ - Owner: `@jskit-ai/connectors-catalog@0.1.66`
96
96
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/ai-connections/PATTERN.md)
97
97
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/ai-connections/example/)
98
98
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -103,7 +103,7 @@ Compose provider operations, authorization and encrypted file storage from a CLI
103
103
 
104
104
  - Id: `connectors/api-key-connection`
105
105
  - Keywords: `api-key`, `clay`, `cli`, `clickhouse`, `connectors`, `dbt`, `files`, `firecrawl`, `granola`, `integrations`, `metrics`, `prestashop`, `resend`, `semantic-layer`, `semrush`, `x-twitter`
106
- - Owner: `@jskit-ai/connectors-catalog@0.1.65`
106
+ - Owner: `@jskit-ai/connectors-catalog@0.1.66`
107
107
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/api-key-connection/PATTERN.md)
108
108
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/api-key-connection/example/)
109
109
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -114,7 +114,7 @@ Compose token-based MCP discovery and explicitly authorized tool calls using the
114
114
 
115
115
  - Id: `connectors/assistant-mcp`
116
116
  - Keywords: `assistant`, `cli`, `connectors`, `files`, `integrations`, `mcp`, `n8n`, `sanity`
117
- - Owner: `@jskit-ai/connectors-catalog@0.1.65`
117
+ - Owner: `@jskit-ai/connectors-catalog@0.1.66`
118
118
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/assistant-mcp/PATTERN.md)
119
119
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/assistant-mcp/example/)
120
120
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -125,7 +125,7 @@ Configure assistant OAuth clients, then compose existing state, encrypted file g
125
125
 
126
126
  - Id: `connectors/assistant-mcp-oauth`
127
127
  - Keywords: `amplitude`, `assistant`, `atlassian`, `canva`, `cli`, `client metadata`, `confidence`, `connectors`, `figma`, `files`, `granola`, `hex`, `mcp`, `miro`, `oauth`
128
- - Owner: `@jskit-ai/connectors-catalog@0.1.65`
128
+ - Owner: `@jskit-ai/connectors-catalog@0.1.66`
129
129
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/assistant-mcp-oauth/PATTERN.md)
130
130
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/assistant-mcp-oauth/example/)
131
131
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -136,7 +136,7 @@ Compose signed AWS operations, file configuration and application authorization
136
136
 
137
137
  - Id: `connectors/aws-storage-queries`
138
138
  - Keywords: `athena`, `aws`, `cli`, `connectors`, `files`, `iam`, `queries`, `s3`, `storage`, `sts`
139
- - Owner: `@jskit-ai/connectors-catalog@0.1.65`
139
+ - Owner: `@jskit-ai/connectors-catalog@0.1.66`
140
140
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/aws-storage-queries/PATTERN.md)
141
141
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/aws-storage-queries/example/)
142
142
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -147,7 +147,7 @@ Compose reusable connection libraries with portable configuration, application o
147
147
 
148
148
  - Id: `connectors/calendar-cli`
149
149
  - Keywords: `calendar`, `cli`, `connectors`, `google`, `integrations`, `oauth`, `permissions`
150
- - Owner: `@jskit-ai/connector-google-calendar@0.1.63`
150
+ - Owner: `@jskit-ai/connector-google-calendar@0.1.64`
151
151
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/calendar-cli/PATTERN.md)
152
152
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/calendar-cli/example/)
153
153
  - Requires: `@jskit-ai/connector-google-calendar`, `@jskit-ai/connectors-core`, `@jskit-ai/database-runtime-mysql`
@@ -158,7 +158,7 @@ Compose the shared connector runtime for event delivery while leaving workflow c
158
158
 
159
159
  - Id: `connectors/event-delivery`
160
160
  - Keywords: `cli`, `connectors`, `events`, `files`, `inngest`, `integrations`, `workflows`
161
- - Owner: `@jskit-ai/connectors-catalog@0.1.65`
161
+ - Owner: `@jskit-ai/connectors-catalog@0.1.66`
162
162
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/event-delivery/PATTERN.md)
163
163
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/event-delivery/example/)
164
164
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -169,7 +169,7 @@ Wire service-account grants, file storage, explicit message actions and public b
169
169
 
170
170
  - Id: `connectors/firebase-messaging`
171
171
  - Keywords: `cli`, `connectors`, `fcm`, `files`, `firebase`, `integrations`, `jwt`, `notifications`, `push`, `service-account`, `vapid`
172
- - Owner: `@jskit-ai/connectors-catalog@0.1.65`
172
+ - Owner: `@jskit-ai/connectors-catalog@0.1.66`
173
173
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/firebase-messaging/PATTERN.md)
174
174
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/firebase-messaging/example/)
175
175
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -180,7 +180,7 @@ Compose reviewed Search campaigns with project-owned Google OAuth and portable s
180
180
 
181
181
  - Id: `connectors/google-ads-search`
182
182
  - Keywords: `ads`, `campaigns`, `cli`, `connectors`, `conversion`, `google`, `search`
183
- - Owner: `@jskit-ai/connectors-catalog@0.1.65`
183
+ - Owner: `@jskit-ai/connectors-catalog@0.1.66`
184
184
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/google-ads-search/PATTERN.md)
185
185
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/google-ads-search/example/)
186
186
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -191,7 +191,7 @@ Compose provider consent, verification and encrypted file persistence from an ap
191
191
 
192
192
  - Id: `connectors/oauth-connection`
193
193
  - 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`
194
- - Owner: `@jskit-ai/connectors-catalog@0.1.65`
194
+ - Owner: `@jskit-ai/connectors-catalog@0.1.66`
195
195
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/oauth-connection/PATTERN.md)
196
196
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/oauth-connection/example/)
197
197
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -202,7 +202,7 @@ Compose a sequential catalogue batch and preserve partial success for applicatio
202
202
 
203
203
  - Id: `connectors/paddle-catalogue`
204
204
  - Keywords: `batch`, `paddle`, `payments`, `prices`, `products`
205
- - Owner: `@jskit-ai/connectors-catalog@0.1.65`
205
+ - Owner: `@jskit-ai/connectors-catalog@0.1.66`
206
206
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/paddle-catalogue/PATTERN.md)
207
207
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/paddle-catalogue/example/)
208
208
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -213,7 +213,7 @@ Resolve a publishable image key deliberately and use the shared URL library in a
213
213
 
214
214
  - Id: `connectors/public-image`
215
215
  - Keywords: `cli`, `connectors`, `files`, `images`, `integrations`, `logo-dev`, `public-key`
216
- - Owner: `@jskit-ai/connectors-catalog@0.1.65`
216
+ - Owner: `@jskit-ai/connectors-catalog@0.1.66`
217
217
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/public-image/PATTERN.md)
218
218
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/public-image/example/)
219
219
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -224,7 +224,7 @@ Compose file configuration, Redshift Data API operations and application query o
224
224
 
225
225
  - Id: `connectors/redshift-queries`
226
226
  - Keywords: `aws`, `cli`, `connectors`, `files`, `iam`, `provisioned`, `redshift`, `serverless`, `sql`, `warehouse`
227
- - Owner: `@jskit-ai/connectors-catalog@0.1.65`
227
+ - Owner: `@jskit-ai/connectors-catalog@0.1.66`
228
228
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/redshift-queries/PATTERN.md)
229
229
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/redshift-queries/example/)
230
230
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -235,7 +235,7 @@ Use the shared scanner runtime from a CLI or a host worker with portable configu
235
235
 
236
236
  - Id: `connectors/source-scanning`
237
237
  - Keywords: `cancellation`, `cli`, `connectors`, `integrations`, `scanning`, `security`, `source`, `wiz`, `worker`
238
- - Owner: `@jskit-ai/connectors-catalog@0.1.65`
238
+ - Owner: `@jskit-ai/connectors-catalog@0.1.66`
239
239
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/source-scanning/PATTERN.md)
240
240
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/source-scanning/example/)
241
241
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -246,7 +246,7 @@ Add a protected administration surface, settings shell, and semantic navigation
246
246
 
247
247
  - Id: `console/console-surface`
248
248
  - Keywords: `admin`, `console`, `navigation`, `owner`, `placement`, `settings`, `surface`
249
- - Owner: `@jskit-ai/console-web@0.1.216`
249
+ - Owner: `@jskit-ai/console-web@0.1.218`
250
250
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/console/console-surface/PATTERN.md)
251
251
  - Examples: [example/](../../skills/jskit/references/patterns/console/console-surface/example/)
252
252
  - Requires: `@jskit-ai/console-core`, `@jskit-ai/console-web`, `@jskit-ai/shell-web`
@@ -257,7 +257,7 @@ Build a routed CRUD user interface as thin application pages over JSKIT's shared
257
257
 
258
258
  - Id: `crud/crud-screen-set`
259
259
  - Keywords: `actions`, `add`, `crud`, `delete`, `edit`, `filters`, `list`, `material`, `routes`, `view`, `vue`
260
- - Owner: `@jskit-ai/http-web@0.1.93`
260
+ - Owner: `@jskit-ai/http-web@0.1.95`
261
261
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/crud/crud-screen-set/PATTERN.md)
262
262
  - Examples: [example/](../../skills/jskit/references/patterns/crud/crud-screen-set/example/)
263
263
  - Requires: `@jskit-ai/http-web`, `@jskit-ai/resource-crud-core`
@@ -268,7 +268,7 @@ Build a complete application-owned CRUD server package from a migration, resourc
268
268
 
269
269
  - Id: `crud/json-api-resource-package`
270
270
  - Keywords: `actions`, `crud`, `database`, `json-api`, `migration`, `permissions`, `provider`, `repository`, `routes`, `service`
271
- - Owner: `@jskit-ai/crud-core@0.1.257`
271
+ - Owner: `@jskit-ai/crud-core@0.1.258`
272
272
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/crud/json-api-resource-package/PATTERN.md)
273
273
  - Examples: [example/](../../skills/jskit/references/patterns/crud/json-api-resource-package/example/)
274
274
  - Requires: `@jskit-ai/crud-core`, `@jskit-ai/resource-crud-core`
@@ -279,7 +279,7 @@ Define an authenticated application resource whose records belong to the current
279
279
 
280
280
  - Id: `crud/resource-contract`
281
281
  - Keywords: `authenticated`, `crud`, `database`, `owner-scoped`, `resource`, `user`
282
- - Owner: `@jskit-ai/resource-crud-core@0.1.188`
282
+ - Owner: `@jskit-ai/resource-crud-core@0.1.189`
283
283
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/crud/resource-contract/PATTERN.md)
284
284
  - Examples: [example/](../../skills/jskit/references/patterns/crud/resource-contract/example/)
285
285
  - Requires: `@jskit-ai/resource-crud-core`
@@ -290,7 +290,7 @@ Configure a JSKIT application for MySQL with a fixed driver, ordinary environmen
290
290
 
291
291
  - Id: `database/mysql-application`
292
292
  - Keywords: `database`, `knex`, `mariadb`, `migrations`, `mysql`, `mysql2`
293
- - Owner: `@jskit-ai/database-runtime-mysql@0.1.244`
293
+ - Owner: `@jskit-ai/database-runtime-mysql@0.1.245`
294
294
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/database/mysql-application/PATTERN.md)
295
295
  - Examples: [example/](../../skills/jskit/references/patterns/database/mysql-application/example/)
296
296
  - Requires: `@jskit-ai/database-runtime-mysql`
@@ -301,7 +301,7 @@ Configure a JSKIT application for PostgreSQL with a fixed driver, ordinary envir
301
301
 
302
302
  - Id: `database/postgres-application`
303
303
  - Keywords: `database`, `knex`, `migrations`, `pg`, `postgres`, `postgresql`
304
- - Owner: `@jskit-ai/database-runtime-postgres@0.1.243`
304
+ - Owner: `@jskit-ai/database-runtime-postgres@0.1.244`
305
305
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/database/postgres-application/PATTERN.md)
306
306
  - Examples: [example/](../../skills/jskit/references/patterns/database/postgres-application/example/)
307
307
  - Requires: `@jskit-ai/database-runtime-postgres`
@@ -312,7 +312,7 @@ Wrap a JSKIT web application in a Capacitor Android shell using native Capacitor
312
312
 
313
313
  - Id: `mobile/android-application`
314
314
  - Keywords: `android`, `capacitor`, `device`, `mobile`, `native`, `shell`, `webview`
315
- - Owner: `@jskit-ai/mobile-capacitor@0.1.183`
315
+ - Owner: `@jskit-ai/mobile-capacitor@0.1.185`
316
316
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/mobile/android-application/PATTERN.md)
317
317
  - Examples: [example/](../../skills/jskit/references/patterns/mobile/android-application/example/)
318
318
  - Requires: `@capacitor/android`, `@capacitor/app`, `@capacitor/cli`, `@jskit-ai/mobile-capacitor`
@@ -323,7 +323,7 @@ Add JSKIT realtime events with an optional Redis backplane and an explicit shell
323
323
 
324
324
  - Id: `realtime/realtime-application`
325
325
  - Keywords: `realtime`, `redis`, `socket.io`, `sockets`, `status`, `websocket`
326
- - Owner: `@jskit-ai/realtime@0.1.245`
326
+ - Owner: `@jskit-ai/realtime@0.1.247`
327
327
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/realtime/realtime-application/PATTERN.md)
328
328
  - Examples: [example/](../../skills/jskit/references/patterns/realtime/realtime-application/example/)
329
329
  - Requires: `@jskit-ai/realtime`, `@jskit-ai/shell-web`
@@ -334,7 +334,7 @@ Compose application-owned Google Publisher Tag delivery with the generic rewarde
334
334
 
335
335
  - Id: `rewards/google-rewarded`
336
336
  - Keywords: `ads`, `google`, `publisher tag`, `rewarded`, `unlock`
337
- - Owner: `@jskit-ai/rewarded-web@0.1.184`
337
+ - Owner: `@jskit-ai/rewarded-web@0.1.186`
338
338
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/rewards/google-rewarded/PATTERN.md)
339
339
  - Examples: [example/](../../skills/jskit/references/patterns/rewards/google-rewarded/example/)
340
340
  - Requires: `@jskit-ai/rewarded-web`
@@ -345,7 +345,7 @@ Define a server feature through explicit capabilities and first-class actions, a
345
345
 
346
346
  - Id: `server/feature-package`
347
347
  - Keywords: `actions`, `feature`, `json-rest`, `knex`, `orchestration`, `package`, `provider`, `repository`, `routes`, `server`
348
- - Owner: `@jskit-ai/agent-docs@0.1.244`
348
+ - Owner: `@jskit-ai/agent-docs@0.1.246`
349
349
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/server/feature-package/PATTERN.md)
350
350
  - Examples: [example/](../../skills/jskit/references/patterns/server/feature-package/example/)
351
351
  - Requires: `@jskit-ai/kernel`
@@ -356,7 +356,7 @@ Compose the JSKIT responsive shell, semantic placements, settings navigation, an
356
356
 
357
357
  - Id: `shell/application-shell`
358
358
  - Keywords: `adaptive`, `app`, `layout`, `navigation`, `placement`, `responsive`, `settings`, `shell`
359
- - Owner: `@jskit-ai/shell-web@0.1.252`
359
+ - Owner: `@jskit-ai/shell-web@0.1.254`
360
360
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/shell/application-shell/PATTERN.md)
361
361
  - Examples: [example/](../../skills/jskit/references/patterns/shell/application-shell/example/)
362
362
  - Requires: `@jskit-ai/kernel`, `@jskit-ai/shell-web`
@@ -367,7 +367,7 @@ Add product routes and shell extensions through file routing, semantic placement
367
367
 
368
368
  - Id: `ui/page-and-placement`
369
369
  - Keywords: `component`, `navigation`, `outlet`, `page`, `placement`, `routes`, `section`, `shell`, `subpages`, `vue`
370
- - Owner: `@jskit-ai/shell-web@0.1.252`
370
+ - Owner: `@jskit-ai/shell-web@0.1.254`
371
371
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/ui/page-and-placement/PATTERN.md)
372
372
  - Examples: [example/](../../skills/jskit/references/patterns/ui/page-and-placement/example/)
373
373
  - Requires: `@jskit-ai/kernel`, `@jskit-ai/shell-web`
@@ -378,7 +378,7 @@ Compose an account settings route and profile, preference, and notification sect
378
378
 
379
379
  - Id: `users/account-settings`
380
380
  - Keywords: `account`, `notifications`, `preferences`, `profile`, `settings`, `user`, `vue`
381
- - Owner: `@jskit-ai/users-web@0.1.266`
381
+ - Owner: `@jskit-ai/users-web@0.1.268`
382
382
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/users/account-settings/PATTERN.md)
383
383
  - Examples: [example/](../../skills/jskit/references/patterns/users/account-settings/example/)
384
384
  - Requires: `@jskit-ai/shell-web`, `@jskit-ai/users-core`, `@jskit-ai/users-web`
@@ -389,7 +389,7 @@ Expose user administration and workspace-scoped member operations through app-ow
389
389
 
390
390
  - Id: `users/user-administration-server`
391
391
  - Keywords: `account`, `admin`, `member`, `repository`, `resource`, `routes`, `service`, `user`, `workspace`
392
- - Owner: `@jskit-ai/users-core@0.1.259`
392
+ - Owner: `@jskit-ai/users-core@0.1.260`
393
393
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/users/user-administration-server/PATTERN.md)
394
394
  - Examples: [example/](../../skills/jskit/references/patterns/users/user-administration-server/example/)
395
395
  - Requires: `@jskit-ai/crud-core`, `@jskit-ai/users-core`
@@ -400,7 +400,7 @@ Configure roles, workspace access policy, invitations, and app-owned invitation
400
400
 
401
401
  - Id: `workspaces/workspace-server`
402
402
  - Keywords: `access`, `invite`, `membership`, `multitenancy`, `policy`, `role`, `tenancy`, `workspace`
403
- - Owner: `@jskit-ai/workspaces-core@0.1.224`
403
+ - Owner: `@jskit-ai/workspaces-core@0.1.225`
404
404
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/workspaces/workspace-server/PATTERN.md)
405
405
  - Examples: [example/](../../skills/jskit/references/patterns/workspaces/workspace-server/example/)
406
406
  - Requires: `@jskit-ai/users-core`, `@jskit-ai/workspaces-core`
@@ -411,7 +411,7 @@ Compose workspace selection, invitation, member administration, settings, and re
411
411
 
412
412
  - Id: `workspaces/workspace-surfaces`
413
413
  - Keywords: `admin`, `invite`, `member`, `navigation`, `settings`, `surface`, `switcher`, `workspace`
414
- - Owner: `@jskit-ai/workspaces-web@0.1.227`
414
+ - Owner: `@jskit-ai/workspaces-web@0.1.229`
415
415
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/workspaces/workspace-surfaces/PATTERN.md)
416
416
  - Examples: [example/](../../skills/jskit/references/patterns/workspaces/workspace-surfaces/example/)
417
417
  - Requires: `@jskit-ai/shell-web`, `@jskit-ai/workspaces-core`, `@jskit-ai/workspaces-web`
package/reference/autogen/README.md CHANGED
@@ -12,6 +12,7 @@ AI-first source patterns are indexed in `PATTERN_INDEX.md`.
12
12
 
13
13
  ## Package Maps
14
14
  - [agent-docs](/packages/agent-docs/reference/autogen/packages/agent-docs.md)
15
+ - [architecture-inspector](/packages/agent-docs/reference/autogen/packages/architecture-inspector.md)
15
16
  - [assistant-core](/packages/agent-docs/reference/autogen/packages/assistant-core.md)
16
17
  - [assistant-runtime](/packages/agent-docs/reference/autogen/packages/assistant-runtime.md)
17
18
  - [assistant-voice](/packages/agent-docs/reference/autogen/packages/assistant-voice.md)