@jskit-ai/agent-docs 0.1.288 → 0.1.290

package/guide/agent/app-extras/assistant-conversation.md

@@ -4847,7 +4847,13 @@ wait loop cannot hold the input for minutes, each steer sends the
 `background_tasks` control request (Claude's Ctrl+B equivalent) after its write,
 and again on each `task_started` event until Claude reads it. Foreground Bash
 commands and subagents keep running in the background and report completion with
-a task notification; the blocked tool call returns at once.
+a task notification; the blocked tool call returns at once. A Bash command moved
+this way keeps its own time limit (its `timeout`, or Claude's two-minute default),
+counted from when it started: when that passes, the shared owner stops its task
+with the `stop_task` control and publishes the `steered_command_limit` diagnostic
+(`steered_command_stop_failed` if Claude refuses it). Claude then answers the task
+notification and the turn settles as it would have after a foreground timeout.
+Commands Claude itself starts with `run_in_background` have no limit.
 Claude Code 2.1.308 supports the control. A refused control (an older CLI) only
 leaves the input waiting for the tool call and publishes the
 `steering_background_failed` diagnostic; `steering_backgrounded` reports success.

package/guide/agent/app-setup/a-more-interesting-shell.md

@@ -58,7 +58,9 @@ Use Vuetify Material navigation. On compact/mobile layouts, close dismisses the
 temporary drawer. Wide layouts normally use
 `desktopDrawerClosedMode="rail"`; choose `hidden` only when another navigation
 affordance remains. The public `drawerWidth`, `railWidth`, and
-`navigationItemSpacing` controls own density and spacing. The standard 80px
+`navigationItemSpacing` controls own density and spacing. The drawer fits its
+labels by default, up to Material 3's 360dp; `drawerWidth="material"` gives the
+full 360dp and a number fixes the width. The standard 80px
 rail centres 48px targets, and drawer items keep an outer inset of 12 CSS pixels.
 Do not override private shell CSS to imitate these states.
 

package/guide/agent/app-setup/material-3-migration.md

@@ -183,8 +183,9 @@ actions behave as in `ShellLayout`:
 <script setup>
 import { ShellPageActionsTarget, ShellPageTitle, ShellUpButton, useShellAppBar } from "@jskit-ai/shell-web/client";
 
-// On a phone the bar keeps one trailing item: the page's primary action when pageActions.hasPrimary is true,
-// otherwise the app's own control nearest the corner; put the others in ShellPageActionsTarget's #menu slot.
+// On a phone the page's actions are in the bar's menu, apart from a primary one (pageActions.hasPrimary). Put the
+// app's own controls that don't fit beside the title in ShellPageActionsTarget's #menu slot: the menu keeps it
+// mounted while it is closed, and :menu-items="false" leaves its items out while the slot holds none.
 const { pageActions } = useShellAppBar();
 </script>
 
@@ -235,8 +236,10 @@ changes:
 
 ## 8. The navigation drawer and app tests
 
-The drawer is 360dp wide; `drawerWidth="content"` on `ShellLayout` sizes it to
-its items instead. Medium windows show the navigation rail, whose menu control
+The drawer fits its labels and identity, within Material 3's 360dp, so a layout
+that wraps `ShellLayout` only to narrow the drawer can go; `drawerWidth="material"`
+gives it the full 360dp and a number fixes its width. Medium windows show the
+navigation rail, whose menu control
 opens the drawer over the page. A modal drawer opens over the app bar, as
 Material 3 draws it, so a browser test that clicked the menu control again to
 close it taps the scrim or presses Escape instead.

package/guide/agent/framework/crud-operations.md

@@ -49,8 +49,10 @@ false }` hides one), so a column added later stays out of every API until a
 contract names it. A CRUD feature's answers follow the same rule: an unnamed
 relationship is left out, and an included record shows only its id, its
 relation's `labelKey` and the fields the including contract lists in that
-field's `output.includeFields` (`{ breed: ["name"] }` in the list shows a
-record it links to, as deep as listed), never another contract's output.
+field's `output.includeFields`, never another contract's output. The list
+names a link by its relationship, as deep as listed: `{ breed: ["name"] }`
+shows the breed's name, `{ location: [] }` its id; a field name such as
+`"locationId"` is refused at boot.
 A package with a CRUD feature lists `crud.contracts` in its descriptor's
 `capabilities.requires`. Do not duplicate their schema or serializers.
 Prefer `useCrudListScreen()`, `useCrudViewScreen()`, and

package/guide/agent/framework/data-access.md

@@ -435,6 +435,12 @@ fields: {
   petId: { output: { required: false, includeFields: ["name", { breed: ["name"] }] } }
 }
 ```
+An included record's link is listed by its relationship, never as a field:
+`{ location: [] }` answers the pet's location id, with its fields inside the
+list when the include reaches it. A belongs-to field named by its key
+(`"locationId"`) or its relationship (`"location"`) is a relationship in the
+document, never an attribute, so it would never show; the app refuses it at
+boot, naming the link form.
 A `decorateService` that also needs the record it wrote (for an audit or a
 history row) reads it from its own answer, `simplifyJsonApiResult(answer)`
 from `@jskit-ai/http-runtime/shared`, never with a second read; a relationship

package/guide/agent/framework/material-3.md

@@ -259,12 +259,15 @@ dialog, chip or FAB.
   tooltip), and `primary`, `to`, `replace`, `href` (with `download` for a
   file, such as a CSV export), `disabled`, `loading` or `color` (`error` for a
   destructive one); attributes such as `target` reach its button. On compact
-  widths the bar keeps one trailing item after the title: the single
-  `primary` action when the page has one (a form's Save), otherwise its own
-  item nearest the corner (a top-right placement such as the account avatar).
-  Every other action and the bar's other items (a notification bell, tools)
-  go to its "More actions" menu, where `overflow` actions always are. Medium
-  and wider bars show them all.
+  widths the bar shows the single `primary` action (a form's Save) and puts
+  every other action in its "More actions" menu, where `overflow` actions
+  always are. The bar's own items (top-right placements such as tools, a
+  notification bell and the account avatar) stay while they fit beside the
+  whole title; those that don't follow the actions into the menu, farthest
+  from the corner first, and the item nearest the corner stays unless the
+  `primary` action takes its place. An item keeps running while it is in the
+  menu, closed or open, so its live count, its panel or a floating button it
+  shows elsewhere on the page stay. Medium and wider bars show them all.
 - **Window size classes:** compact under 600 (navigation bar), medium 600–839
   (navigation rail), expanded 840–1199 and large from 1200 (drawer), read from
   `useShellWindowSizeClass()`

package/guide/agent/framework/ui-operations.md

@@ -68,7 +68,9 @@ when another navigation affordance remains.
 The drawer omits the app bar's surface label. Open and rail icons share a
 centreline. It uses a 12px outer item inset; `navigationItemSpacing` controls
 icon/label and label/end gaps. The normal 80px rail centres 48px targets;
-`railWidth` and `drawerWidth` are public density/width controls. Restyle shell
+`railWidth` and `drawerWidth` are public density/width controls: the drawer fits
+its labels up to 360dp unless `drawerWidth` is `"material"` (the full 360dp) or a
+number. Restyle shell
 chrome only through the `--shell-*` tokens in the `shell/application-shell`
 pattern, never its private CSS.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jskit-ai/agent-docs",
-  "version": "0.1.288",
+  "version": "0.1.290",
   "description": "Distributed JSKIT agent references, prompts, guides, and generated reference maps.",
   "type": "module",
   "files": [

package/patterns/feature-package/example/booking-engine/package.json

@@ -5,7 +5,7 @@
   "private": true,
   "type": "module",
   "dependencies": {
-    "@jskit-ai/kernel": "0.2.15",
+    "@jskit-ai/kernel": "0.2.16",
     "json-rest-schema": "^1.0.17"
   },
   "exports": {

package/patterns/minimal-foundation/example/package.json

@@ -34,7 +34,7 @@
   "dependencies": {
     "@local/main": "0.1.0",
     "@fastify/static": "^10.1.3",
-    "@jskit-ai/kernel": "0.2.15",
+    "@jskit-ai/kernel": "0.2.16",
     "@jskit-ai/material-web": "0.1.4",
     "@tanstack/vue-query": "^5.101.0",
     "fastify": "^5.12.7",
@@ -44,13 +44,13 @@
     "vue": "^3.5.44",
     "vue-router": "^5.3.1",
     "vuetify": "^4.3.0",
-    "@jskit-ai/http-runtime": "0.2.15",
+    "@jskit-ai/http-runtime": "0.2.16",
     "@fastify/fast-json-stringify-compiler": "^5.1.0",
     "@vue/devtools-api": "^8.2.1"
   },
   "devDependencies": {
     "@jskit-ai/config-eslint": "0.1.248",
-    "@jskit-ai/jskit-catalog": "0.2.40",
+    "@jskit-ai/jskit-catalog": "0.2.42",
     "@playwright/test": "1.61.1",
     "@vitejs/plugin-vue": "^6.0.7",
     "eslint": "^10.8.0",

package/patterns/shell-foundation/example/package.json

@@ -34,7 +34,7 @@
   "dependencies": {
     "@local/main": "0.1.0",
     "@fastify/static": "^10.1.3",
-    "@jskit-ai/kernel": "0.2.15",
+    "@jskit-ai/kernel": "0.2.16",
     "@jskit-ai/material-web": "0.1.4",
     "@tanstack/vue-query": "^5.101.0",
     "fastify": "^5.12.7",
@@ -44,14 +44,14 @@
     "vue": "^3.5.44",
     "vue-router": "^5.3.1",
     "vuetify": "^4.3.0",
-    "@jskit-ai/http-runtime": "0.2.15",
-    "@jskit-ai/shell-web": "0.2.19",
+    "@jskit-ai/http-runtime": "0.2.16",
+    "@jskit-ai/shell-web": "0.2.20",
     "@fastify/fast-json-stringify-compiler": "^5.1.0",
     "@vue/devtools-api": "^8.2.1"
   },
   "devDependencies": {
     "@jskit-ai/config-eslint": "0.1.248",
-    "@jskit-ai/jskit-catalog": "0.2.40",
+    "@jskit-ai/jskit-catalog": "0.2.42",
     "@playwright/test": "1.61.1",
     "@vitejs/plugin-vue": "^6.0.7",
     "eslint": "^10.8.0",

package/patterns/shell-foundation/example/packages/main/package.json

@@ -9,7 +9,7 @@
   },
   "description": "App-local runtime composition and lightweight glue.",
   "dependencies": {
-    "@jskit-ai/kernel": "0.2.15"
+    "@jskit-ai/kernel": "0.2.16"
   },
   "jskit": {
     "kind": "runtime",

package/reference/autogen/PATTERN_INDEX.md

@@ -15,7 +15,7 @@ A concrete Fastify, Vue, and JSKIT application foundation for products that do n
 
 - Id: `app/minimal-foundation`
 - Keywords: `app`, `fastify`, `foundation`, `minimal`, `server`, `vite`, `vue`
-- Owner: `@jskit-ai/agent-docs@0.1.288`
+- Owner: `@jskit-ai/agent-docs@0.1.290`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/app/minimal-foundation/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/app/minimal-foundation/example/)
 - Requires: `@jskit-ai/http-runtime`, `@jskit-ai/kernel`
@@ -26,7 +26,7 @@ A concrete JSKIT web application foundation with responsive shell navigation, se
 
 - Id: `app/shell-foundation`
 - Keywords: `app`, `foundation`, `material`, `navigation`, `placements`, `shell`, `vite`, `vue`
-- Owner: `@jskit-ai/agent-docs@0.1.288`
+- Owner: `@jskit-ai/agent-docs@0.1.290`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/app/shell-foundation/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/app/shell-foundation/example/)
 - 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
 
 - Id: `assistant/assistant-surface`
 - Keywords: `ai`, `assistant`, `chat`, `config`, `environment`, `page`, `placement`, `settings`, `surface`
-- Owner: `@jskit-ai/assistant-runtime@0.2.34`
+- Owner: `@jskit-ai/assistant-runtime@0.2.36`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/assistant/assistant-surface/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/assistant/assistant-surface/example/)
 - 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
 
 - Id: `auth/accounts-hub`
 - Keywords: `accounts hub`, `auth`, `authentication`, `issuer`, `master login`, `oidc`, `openid connect`, `single sign-on`, `sso`
-- Owner: `@jskit-ai/oidc-issuer-core@0.1.23`
+- Owner: `@jskit-ai/oidc-issuer-core@0.1.24`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/auth/accounts-hub/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/auth/accounts-hub/example/)
 - Requires: `@jskit-ai/oidc-issuer-core`
@@ -59,7 +59,7 @@ Compose JSKIT authentication routes, views, profile controls, and public surface
 
 - Id: `auth/auth-surface`
 - Keywords: `account`, `auth`, `login`, `logout`, `password`, `placement`, `profile`, `reset`, `surface`
-- Owner: `@jskit-ai/auth-web@0.2.21`
+- Owner: `@jskit-ai/auth-web@0.2.22`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/auth/auth-surface/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/auth/auth-surface/example/)
 - 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
 
 - Id: `auth/oidc-sign-in`
 - Keywords: `accounts hub`, `auth`, `authentication`, `back-channel logout`, `dynamic client registration`, `issuer`, `master login`, `oidc`, `openid connect`, `single sign-on`, `sso`
-- Owner: `@jskit-ai/auth-provider-oidc-core@0.2.23`
+- Owner: `@jskit-ai/auth-provider-oidc-core@0.2.24`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/auth/oidc-sign-in/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/auth/oidc-sign-in/example/)
 - Requires: `@jskit-ai/auth-provider-oidc-core`, `@jskit-ai/auth-web`
@@ -81,7 +81,7 @@ Add Supabase authentication through normal npm composition, explicit environment
 
 - Id: `auth/supabase-auth`
 - Keywords: `auth`, `authentication`, `oauth`, `sessions`, `supabase`
-- Owner: `@jskit-ai/auth-provider-supabase-core@0.2.17`
+- Owner: `@jskit-ai/auth-provider-supabase-core@0.2.18`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/auth/supabase-auth/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/auth/supabase-auth/example/)
 - Requires: `@jskit-ai/auth-provider-supabase-core`
@@ -92,7 +92,7 @@ Resolve an administrator environment key or an individual user's grant, then use
 
 - Id: `connectors/ai-connections`
 - Keywords: `ai`, `api-key`, `cli`, `environment`, `free`, `models`, `ownership`, `zai`, `zen`
-- Owner: `@jskit-ai/connectors-catalog@0.2.18`
+- Owner: `@jskit-ai/connectors-catalog@0.2.20`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/ai-connections/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/connectors/ai-connections/example/)
 - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -103,7 +103,7 @@ Compose provider operations, authorization and encrypted file storage from a CLI
 
 - Id: `connectors/api-key-connection`
 - Keywords: `api-key`, `clay`, `cli`, `clickhouse`, `connectors`, `dbt`, `files`, `firecrawl`, `granola`, `integrations`, `metrics`, `prestashop`, `resend`, `semantic-layer`, `semrush`, `x-twitter`
-- Owner: `@jskit-ai/connectors-catalog@0.2.18`
+- Owner: `@jskit-ai/connectors-catalog@0.2.20`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/api-key-connection/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/connectors/api-key-connection/example/)
 - 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
 
 - Id: `connectors/assistant-mcp`
 - Keywords: `assistant`, `cli`, `connectors`, `files`, `integrations`, `mcp`, `n8n`, `sanity`
-- Owner: `@jskit-ai/connectors-catalog@0.2.18`
+- Owner: `@jskit-ai/connectors-catalog@0.2.20`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/assistant-mcp/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/connectors/assistant-mcp/example/)
 - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -125,7 +125,7 @@ Configure assistant OAuth clients, then compose existing state, encrypted file g
 
 - Id: `connectors/assistant-mcp-oauth`
 - Keywords: `amplitude`, `assistant`, `atlassian`, `canva`, `cli`, `client metadata`, `confidence`, `connectors`, `figma`, `files`, `granola`, `hex`, `mcp`, `miro`, `oauth`
-- Owner: `@jskit-ai/connectors-catalog@0.2.18`
+- Owner: `@jskit-ai/connectors-catalog@0.2.20`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/assistant-mcp-oauth/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/connectors/assistant-mcp-oauth/example/)
 - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -136,7 +136,7 @@ Compose signed AWS operations, file configuration and application authorization
 
 - Id: `connectors/aws-storage-queries`
 - Keywords: `athena`, `aws`, `cli`, `connectors`, `files`, `iam`, `queries`, `s3`, `storage`, `sts`
-- Owner: `@jskit-ai/connectors-catalog@0.2.18`
+- Owner: `@jskit-ai/connectors-catalog@0.2.20`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/aws-storage-queries/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/connectors/aws-storage-queries/example/)
 - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -147,7 +147,7 @@ Compose reusable connection libraries with portable configuration, application o
 
 - Id: `connectors/calendar-cli`
 - Keywords: `calendar`, `cli`, `connectors`, `google`, `integrations`, `oauth`, `permissions`
-- Owner: `@jskit-ai/connector-google-calendar@0.2.18`
+- Owner: `@jskit-ai/connector-google-calendar@0.2.20`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/calendar-cli/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/connectors/calendar-cli/example/)
 - 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
 
 - Id: `connectors/event-delivery`
 - Keywords: `cli`, `connectors`, `events`, `files`, `inngest`, `integrations`, `workflows`
-- Owner: `@jskit-ai/connectors-catalog@0.2.18`
+- Owner: `@jskit-ai/connectors-catalog@0.2.20`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/event-delivery/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/connectors/event-delivery/example/)
 - 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
 
 - Id: `connectors/firebase-messaging`
 - Keywords: `cli`, `connectors`, `fcm`, `files`, `firebase`, `integrations`, `jwt`, `notifications`, `push`, `service-account`, `vapid`
-- Owner: `@jskit-ai/connectors-catalog@0.2.18`
+- Owner: `@jskit-ai/connectors-catalog@0.2.20`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/firebase-messaging/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/connectors/firebase-messaging/example/)
 - 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
 
 - Id: `connectors/google-ads-search`
 - Keywords: `ads`, `campaigns`, `cli`, `connectors`, `conversion`, `google`, `search`
-- Owner: `@jskit-ai/connectors-catalog@0.2.18`
+- Owner: `@jskit-ai/connectors-catalog@0.2.20`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/google-ads-search/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/connectors/google-ads-search/example/)
 - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -191,7 +191,7 @@ Compose provider consent, verification and encrypted file persistence from an ap
 
 - Id: `connectors/oauth-connection`
 - 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`
-- Owner: `@jskit-ai/connectors-catalog@0.2.18`
+- Owner: `@jskit-ai/connectors-catalog@0.2.20`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/oauth-connection/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/connectors/oauth-connection/example/)
 - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -202,7 +202,7 @@ Compose a sequential catalogue batch and preserve partial success for applicatio
 
 - Id: `connectors/paddle-catalogue`
 - Keywords: `batch`, `paddle`, `payments`, `prices`, `products`
-- Owner: `@jskit-ai/connectors-catalog@0.2.18`
+- Owner: `@jskit-ai/connectors-catalog@0.2.20`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/paddle-catalogue/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/connectors/paddle-catalogue/example/)
 - 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
 
 - Id: `connectors/public-image`
 - Keywords: `cli`, `connectors`, `files`, `images`, `integrations`, `logo-dev`, `public-key`
-- Owner: `@jskit-ai/connectors-catalog@0.2.18`
+- Owner: `@jskit-ai/connectors-catalog@0.2.20`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/public-image/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/connectors/public-image/example/)
 - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -224,7 +224,7 @@ Compose file configuration, Redshift Data API operations and application query o
 
 - Id: `connectors/redshift-queries`
 - Keywords: `aws`, `cli`, `connectors`, `files`, `iam`, `provisioned`, `redshift`, `serverless`, `sql`, `warehouse`
-- Owner: `@jskit-ai/connectors-catalog@0.2.18`
+- Owner: `@jskit-ai/connectors-catalog@0.2.20`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/redshift-queries/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/connectors/redshift-queries/example/)
 - 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
 
 - Id: `connectors/source-scanning`
 - Keywords: `cancellation`, `cli`, `connectors`, `integrations`, `scanning`, `security`, `source`, `wiz`, `worker`
-- Owner: `@jskit-ai/connectors-catalog@0.2.18`
+- Owner: `@jskit-ai/connectors-catalog@0.2.20`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/source-scanning/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/connectors/source-scanning/example/)
 - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -246,7 +246,7 @@ Add a protected administration surface, settings shell, and semantic navigation
 
 - Id: `console/console-surface`
 - Keywords: `admin`, `console`, `navigation`, `owner`, `placement`, `settings`, `surface`
-- Owner: `@jskit-ai/console-web@0.1.245`
+- Owner: `@jskit-ai/console-web@0.1.247`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/console/console-surface/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/console/console-surface/example/)
 - Requires: `@jskit-ai/console-core`, `@jskit-ai/console-web`, `@jskit-ai/shell-web`
@@ -257,7 +257,7 @@ Define an application table resource whose records belong to the current user, a
 
 - Id: `crud/crud-contract`
 - Keywords: `authenticated`, `crud`, `database`, `owner-scoped`, `resource`, `table`, `user`
-- Owner: `@jskit-ai/resource-crud-core@0.1.206`
+- Owner: `@jskit-ai/resource-crud-core@0.1.207`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/crud/crud-contract/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/crud/crud-contract/example/)
 - Requires: `@jskit-ai/resource-core`, `@jskit-ai/resource-crud-core`
@@ -268,7 +268,7 @@ Build a complete application-owned CRUD server package from a migration, a table
 
 - Id: `crud/crud-feature-package`
 - Keywords: `actions`, `crud`, `database`, `defineCrudFeature`, `json-api`, `migration`, `owns`, `permissions`, `repository`, `routes`, `service`, `table resource`
-- Owner: `@jskit-ai/crud-core@0.2.18`
+- Owner: `@jskit-ai/crud-core@0.2.20`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/crud/crud-feature-package/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/crud/crud-feature-package/example/)
 - Requires: `@jskit-ai/crud-core`, `@jskit-ai/resource-core`, `@jskit-ai/resource-crud-core`
@@ -279,7 +279,7 @@ Build a routed CRUD user interface as thin application pages over JSKIT's shared
 
 - Id: `crud/crud-screen-set`
 - Keywords: `actions`, `add`, `crud`, `delete`, `edit`, `filters`, `list`, `material`, `routes`, `view`, `vue`
-- Owner: `@jskit-ai/http-web@0.2.24`
+- Owner: `@jskit-ai/http-web@0.2.25`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/crud/crud-screen-set/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/crud/crud-screen-set/example/)
 - Requires: `@jskit-ai/http-web`, `@jskit-ai/resource-core`, `@jskit-ai/resource-crud-core`
@@ -290,7 +290,7 @@ Configure a JSKIT application for MySQL with a fixed driver, ordinary environmen
 
 - Id: `database/mysql-application`
 - Keywords: `database`, `knex`, `mariadb`, `migrations`, `mysql`, `mysql2`
-- Owner: `@jskit-ai/database-runtime-mysql@0.1.262`
+- Owner: `@jskit-ai/database-runtime-mysql@0.1.263`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/database/mysql-application/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/database/mysql-application/example/)
 - Requires: `@jskit-ai/database-runtime-mysql`
@@ -301,7 +301,7 @@ Configure a JSKIT application for PostgreSQL with a fixed driver, ordinary envir
 
 - Id: `database/postgres-application`
 - Keywords: `database`, `knex`, `migrations`, `pg`, `postgres`, `postgresql`
-- Owner: `@jskit-ai/database-runtime-postgres@0.1.261`
+- Owner: `@jskit-ai/database-runtime-postgres@0.1.262`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/database/postgres-application/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/database/postgres-application/example/)
 - Requires: `@jskit-ai/database-runtime-postgres`
@@ -312,7 +312,7 @@ Describe one database table once (its fields, columns, ownership, search and sor
 
 - Id: `database/table-resource`
 - Keywords: `database`, `defaultTo`, `defineTableResource`, `lockVersionField`, `lookup`, `ownership`, `owns`, `resource`, `system`, `table`, `workspace_or_shared`
-- Owner: `@jskit-ai/resource-core@0.1.206`
+- Owner: `@jskit-ai/resource-core@0.1.207`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/database/table-resource/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/database/table-resource/example/)
 - Requires: `@jskit-ai/resource-core`
@@ -323,7 +323,7 @@ Wrap a JSKIT web application in a Capacitor Android shell using native Capacitor
 
 - Id: `mobile/android-application`
 - Keywords: `android`, `capacitor`, `device`, `mobile`, `native`, `shell`, `webview`
-- Owner: `@jskit-ai/mobile-capacitor@0.2.19`
+- Owner: `@jskit-ai/mobile-capacitor@0.2.20`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/mobile/android-application/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/mobile/android-application/example/)
 - Requires: `@capacitor/android`, `@capacitor/app`, `@capacitor/cli`, `@jskit-ai/mobile-capacitor`
@@ -334,7 +334,7 @@ Add JSKIT realtime events with an optional Redis backplane and an explicit shell
 
 - Id: `realtime/realtime-application`
 - Keywords: `realtime`, `redis`, `socket.io`, `sockets`, `status`, `websocket`
-- Owner: `@jskit-ai/realtime@0.2.22`
+- Owner: `@jskit-ai/realtime@0.2.23`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/realtime/realtime-application/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/realtime/realtime-application/example/)
 - Requires: `@jskit-ai/realtime`, `@jskit-ai/shell-web`
@@ -345,7 +345,7 @@ Compose application-owned Google Publisher Tag delivery with the generic rewarde
 
 - Id: `rewards/google-rewarded`
 - Keywords: `ads`, `google`, `publisher tag`, `rewarded`, `unlock`
-- Owner: `@jskit-ai/rewarded-web@0.2.23`
+- Owner: `@jskit-ai/rewarded-web@0.2.25`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/rewards/google-rewarded/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/rewards/google-rewarded/example/)
 - Requires: `@jskit-ai/rewarded-web`
@@ -356,7 +356,7 @@ Define a server feature through explicit capabilities and first-class actions, a
 
 - Id: `server/feature-package`
 - Keywords: `actions`, `aggregate`, `feature`, `handle`, `orchestration`, `owns`, `package`, `provider`, `repository`, `routes`, `server`, `table resource`
-- Owner: `@jskit-ai/agent-docs@0.1.288`
+- Owner: `@jskit-ai/agent-docs@0.1.290`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/server/feature-package/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/server/feature-package/example/)
 - Requires: `@jskit-ai/kernel`
@@ -367,7 +367,7 @@ Compose the JSKIT responsive shell, semantic placements, settings navigation, an
 
 - Id: `shell/application-shell`
 - Keywords: `adaptive`, `app`, `layout`, `navigation`, `placement`, `responsive`, `settings`, `shell`
-- Owner: `@jskit-ai/shell-web@0.2.19`
+- Owner: `@jskit-ai/shell-web@0.2.20`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/shell/application-shell/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/shell/application-shell/example/)
 - Requires: `@jskit-ai/kernel`, `@jskit-ai/shell-web`
@@ -378,7 +378,7 @@ Add product routes and shell extensions through file routing, semantic placement
 
 - Id: `ui/page-and-placement`
 - Keywords: `component`, `navigation`, `outlet`, `page`, `placement`, `routes`, `section`, `shell`, `subpages`, `vue`
-- Owner: `@jskit-ai/shell-web@0.2.19`
+- Owner: `@jskit-ai/shell-web@0.2.20`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/ui/page-and-placement/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/ui/page-and-placement/example/)
 - Requires: `@jskit-ai/kernel`, `@jskit-ai/shell-web`
@@ -389,7 +389,7 @@ Compose an account settings route and profile, preference, notification, and sig
 
 - Id: `users/account-settings`
 - Keywords: `account`, `link provider`, `notifications`, `oauth`, `preferences`, `profile`, `settings`, `sign-in methods`, `user`, `vue`
-- Owner: `@jskit-ai/users-web@0.2.28`
+- Owner: `@jskit-ai/users-web@0.2.30`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/users/account-settings/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/users/account-settings/example/)
 - Requires: `@jskit-ai/shell-web`, `@jskit-ai/users-core`, `@jskit-ai/users-web`
@@ -400,7 +400,7 @@ Expose user administration and workspace-scoped member operations through app-ow
 
 - Id: `users/user-administration-server`
 - Keywords: `account`, `admin`, `member`, `repository`, `resource`, `routes`, `service`, `user`, `workspace`
-- Owner: `@jskit-ai/users-core@0.2.19`
+- Owner: `@jskit-ai/users-core@0.2.21`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/users/user-administration-server/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/users/user-administration-server/example/)
 - Requires: `@jskit-ai/crud-core`, `@jskit-ai/users-core`
@@ -411,7 +411,7 @@ Configure roles, workspace access policy, invitations, and app-owned invitation
 
 - Id: `workspaces/workspace-server`
 - Keywords: `access`, `invite`, `membership`, `multitenancy`, `policy`, `role`, `tenancy`, `workspace`
-- Owner: `@jskit-ai/workspaces-core@0.2.19`
+- Owner: `@jskit-ai/workspaces-core@0.2.21`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/workspaces/workspace-server/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/workspaces/workspace-server/example/)
 - Requires: `@jskit-ai/users-core`, `@jskit-ai/workspaces-core`
@@ -422,7 +422,7 @@ Compose workspace selection, invitation, member administration, settings, and re
 
 - Id: `workspaces/workspace-surfaces`
 - Keywords: `admin`, `invite`, `member`, `navigation`, `settings`, `surface`, `switcher`, `workspace`
-- Owner: `@jskit-ai/workspaces-web@0.2.28`
+- Owner: `@jskit-ai/workspaces-web@0.2.30`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/workspaces/workspace-surfaces/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/workspaces/workspace-surfaces/example/)
 - Requires: `@jskit-ai/shell-web`, `@jskit-ai/workspaces-core`, `@jskit-ai/workspaces-web`

package/reference/autogen/packages/assistant-core.md

@@ -447,6 +447,10 @@ Exports
 Exports
 - `createClaudeSessionCleanup({ entries, store, configRoot, acquire, savedState, holdsNativeWork, disconnectedMessage })`
 
+### `src/server/conversation/claudeSteeringBackground.js`
+Exports
+- `createClaudeSteeringBackground({ publish, running, counts })`
+
 ### `src/server/conversation/claudeTools.js`
 Exports
 - `claudeApplicationToolResponse(request, { schemas, turn, signal, assertCurrent = acceptNativeCall, onExecutionFailure = ignoreExecutionFailure })`

package/reference/autogen/packages/crud-core.md

@@ -95,6 +95,7 @@ Local functions
 
 ### `src/server/jsonApiModule/service.js`
 Exports
+- `checkIncludedFields(crud, tableResource)`
 - `createCrudService({ repository, crud })`
 Local functions
 - `documentNotFound()`
@@ -104,6 +105,7 @@ Local functions
 - `contractShape(crud)`
 - `includedShape({ attributes, relationships }, labelKey = "")`
 - `documentShapes(crud)`
+- `linksOf(resource)`
 - `contractShapes(crud)`
 
 ### `src/server/jsonApiResourceContract.js`

package/reference/autogen/packages/shell-web.md

@@ -126,6 +126,8 @@ Exports
 Exports
 - None
 Local functions
+- `showsItems()`
+- `showsMenu()`
 - `itemProps(entry)`
 
 ### `src/client/components/ShellPageTitle.vue`
@@ -214,6 +216,12 @@ Local functions
 Exports
 - `useShellRouteTransition(props)`
 
+### `src/client/composables/useShellTopRightOverflow.js`
+Exports
+- `useShellTopRightOverflow({ enabled, placements, pageActions, row, headline, items, menuId })`
+Local functions
+- `wholeTitleWidth(title)`
+
 ### `src/client/composables/useShellWindowSizeClass.js`
 Exports
 - `useShellWindowSizeClass()`
@@ -663,6 +671,10 @@ Exports
 Exports
 - `resolveShellLayoutClass(viewportWidth = pageViewportWidth())`
 
+### `src/client/support/topRightOverflow.js`
+Exports
+- `resolveTopRightItemsInMenu({ room, title, items, menuButton, menuShown, keepLast })`
+
 ### `src/client/support/windowSizeClass.js`
 Exports
 - `EXPANDED_MIN_WIDTH`
@@ -757,6 +769,8 @@ Exports
 ### `fixtures/adaptive-shell/src/StatusButton.vue`
 Exports
 - None
+Local functions
+- `count(event)`
 
 ### `fixtures/adaptive-shell/src/StudioPage.vue`
 Exports

package/skills/jskit/references/crud-operations.md

@@ -43,8 +43,10 @@ false }` hides one), so a column added later stays out of every API until a
 contract names it. A CRUD feature's answers follow the same rule: an unnamed
 relationship is left out, and an included record shows only its id, its
 relation's `labelKey` and the fields the including contract lists in that
-field's `output.includeFields` (`{ breed: ["name"] }` in the list shows a
-record it links to, as deep as listed), never another contract's output.
+field's `output.includeFields`, never another contract's output. The list
+names a link by its relationship, as deep as listed: `{ breed: ["name"] }`
+shows the breed's name, `{ location: [] }` its id; a field name such as
+`"locationId"` is refused at boot.
 A package with a CRUD feature lists `crud.contracts` in its descriptor's
 `capabilities.requires`. Do not duplicate their schema or serializers.
 Prefer `useCrudListScreen()`, `useCrudViewScreen()`, and