@jskit-ai/agent-docs 0.1.304 → 0.1.306

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

@@ -516,6 +516,15 @@ arguments and result pass 64 KiB. The model must still write the call in one
 step: the API engine asks for at most 32,000 output tokens a step, and a model's
 own output limit, or its reasoning, can leave less.
 
+By default the assistant refuses a tool's arguments past 32 KiB and its result
+past 48 KiB ([limits](./assistant-conversation.md#application-tools)). An
+action that takes a whole document (a template, a plan, a long settings record)
+as its input usually works on small documents and fails on the largest, and
+the model must write the whole document again on every edit. Prefer actions
+shaped as changes for the assistant (add, update or remove one part, by id),
+and call each tool with the largest real document, seeded and library records
+included, not only with the small ones tests create.
+
 ### Framework account and workspace actions
 
 Account and workspace action owners supply assistant-specific descriptions,

package/guide/agent/framework/sanity-checks.md

@@ -57,6 +57,8 @@ truthful model-facing output; the assistant validates the result against
 `extensions.assistant.output` and rejects unexpected fields, so a contract
 that promises what execution cannot return fails at run time, not at review
 ([Assistant](/guide/app-extras/assistant#database-surface-action-tools)).
+Call it with the largest real input too, seeded records included: a tool's
+arguments stop at 32 KiB and its result at 48 KiB by default.
 
 **Example:** sparse primary fields stay sparse, and an included record is read
 from its lookup container (`items[0].lookups.pet.name`); a contract that

package/guide/agent/framework/translation.md

@@ -210,6 +210,19 @@ translate a key and show any other string as written:
 { label: "Reports" }
 ```
 
+## Content the app ships as data
+
+Names and descriptions in records the app seeds or ships, such as a
+catalogue's items or a library's templates, are the app's own text. Prefer
+storing their message key (`app.templates.starter.name`) with the English in
+the app's `en` messages, and show the field with `text()` from
+`useJskitText()`, the helper placement labels use: it translates a key and
+shows any other string as written. Stored English cannot follow the user's
+language, and matching it back to a key breaks once someone edits it. When a
+person renames their own copy, the field takes what they wrote and shows it as
+written. Server code that writes such a field into an email or an export
+resolves the key with `createServerI18n` (see [Emails](#emails)).
+
 ## Dates and numbers
 
 JSKIT formats dates, times, numbers and relative times with `Intl` in the

package/package.json

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

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

@@ -50,7 +50,7 @@
   },
   "devDependencies": {
     "@jskit-ai/config-eslint": "0.1.250",
-    "@jskit-ai/jskit-catalog": "0.2.56",
+    "@jskit-ai/jskit-catalog": "0.2.58",
     "@playwright/test": "1.61.1",
     "@vitejs/plugin-vue": "^6.0.7",
     "eslint": "^10.8.0",

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

@@ -51,7 +51,7 @@
   },
   "devDependencies": {
     "@jskit-ai/config-eslint": "0.1.250",
-    "@jskit-ai/jskit-catalog": "0.2.56",
+    "@jskit-ai/jskit-catalog": "0.2.58",
     "@playwright/test": "1.61.1",
     "@vitejs/plugin-vue": "^6.0.7",
     "eslint": "^10.8.0",

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.304`
+- Owner: `@jskit-ai/agent-docs@0.1.306`
 - 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.304`
+- Owner: `@jskit-ai/agent-docs@0.1.306`
 - 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`
@@ -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.257`
+- Owner: `@jskit-ai/console-web@0.1.258`
 - 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`
@@ -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.35`
+- Owner: `@jskit-ai/rewarded-web@0.2.36`
 - 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.304`
+- Owner: `@jskit-ai/agent-docs@0.1.306`
 - 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`
@@ -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.40`
+- Owner: `@jskit-ai/users-web@0.2.41`
 - 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.30`
+- Owner: `@jskit-ai/users-core@0.2.31`
 - 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.30`
+- Owner: `@jskit-ai/workspaces-core@0.2.31`
 - 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.40`
+- Owner: `@jskit-ai/workspaces-web@0.2.41`
 - 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/skills/jskit/references/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.304`
+- Owner: `@jskit-ai/agent-docs@0.1.306`
 - Read: [PATTERN.md](patterns/app/minimal-foundation/PATTERN.md)
 - Examples: [example/](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.304`
+- Owner: `@jskit-ai/agent-docs@0.1.306`
 - Read: [PATTERN.md](patterns/app/shell-foundation/PATTERN.md)
 - Examples: [example/](patterns/app/shell-foundation/example/)
 - Requires: `@jskit-ai/http-runtime`, `@jskit-ai/kernel`, `@jskit-ai/shell-web`
@@ -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.257`
+- Owner: `@jskit-ai/console-web@0.1.258`
 - Read: [PATTERN.md](patterns/console/console-surface/PATTERN.md)
 - Examples: [example/](patterns/console/console-surface/example/)
 - Requires: `@jskit-ai/console-core`, `@jskit-ai/console-web`, `@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.35`
+- Owner: `@jskit-ai/rewarded-web@0.2.36`
 - Read: [PATTERN.md](patterns/rewards/google-rewarded/PATTERN.md)
 - Examples: [example/](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.304`
+- Owner: `@jskit-ai/agent-docs@0.1.306`
 - Read: [PATTERN.md](patterns/server/feature-package/PATTERN.md)
 - Examples: [example/](patterns/server/feature-package/example/)
 - Requires: `@jskit-ai/kernel`
@@ -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.40`
+- Owner: `@jskit-ai/users-web@0.2.41`
 - Read: [PATTERN.md](patterns/users/account-settings/PATTERN.md)
 - Examples: [example/](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.30`
+- Owner: `@jskit-ai/users-core@0.2.31`
 - Read: [PATTERN.md](patterns/users/user-administration-server/PATTERN.md)
 - Examples: [example/](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.30`
+- Owner: `@jskit-ai/workspaces-core@0.2.31`
 - Read: [PATTERN.md](patterns/workspaces/workspace-server/PATTERN.md)
 - Examples: [example/](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.40`
+- Owner: `@jskit-ai/workspaces-web@0.2.41`
 - Read: [PATTERN.md](patterns/workspaces/workspace-surfaces/PATTERN.md)
 - Examples: [example/](patterns/workspaces/workspace-surfaces/example/)
 - Requires: `@jskit-ai/shell-web`, `@jskit-ai/workspaces-core`, `@jskit-ai/workspaces-web`

package/skills/jskit/references/patterns/app/minimal-foundation/example/package.json

@@ -50,7 +50,7 @@
   },
   "devDependencies": {
     "@jskit-ai/config-eslint": "0.1.250",
-    "@jskit-ai/jskit-catalog": "0.2.56",
+    "@jskit-ai/jskit-catalog": "0.2.58",
     "@playwright/test": "1.61.1",
     "@vitejs/plugin-vue": "^6.0.7",
     "eslint": "^10.8.0",

package/skills/jskit/references/patterns/app/shell-foundation/example/package.json

@@ -51,7 +51,7 @@
   },
   "devDependencies": {
     "@jskit-ai/config-eslint": "0.1.250",
-    "@jskit-ai/jskit-catalog": "0.2.56",
+    "@jskit-ai/jskit-catalog": "0.2.58",
     "@playwright/test": "1.61.1",
     "@vitejs/plugin-vue": "^6.0.7",
     "eslint": "^10.8.0",

package/skills/jskit/references/patterns/users/user-administration-server/example/packages/users/package.json

@@ -12,7 +12,7 @@
   "dependencies": {
     "@jskit-ai/crud-core": "0.2.28",
     "@jskit-ai/resource-crud-core": "0.1.213",
-    "@jskit-ai/users-core": "0.2.30"
+    "@jskit-ai/users-core": "0.2.31"
   },
   "jskit": {
     "kind": "runtime",

package/skills/jskit/references/patterns/users/user-administration-server/example/packages/users-workspace/package.json

@@ -12,8 +12,8 @@
   "dependencies": {
     "@jskit-ai/crud-core": "0.2.28",
     "@jskit-ai/resource-crud-core": "0.1.213",
-    "@jskit-ai/users-core": "0.2.30",
-    "@jskit-ai/workspaces-core": "0.2.30"
+    "@jskit-ai/users-core": "0.2.31",
+    "@jskit-ai/workspaces-core": "0.2.31"
   },
   "peerDependencies": {
     "@jskit-ai/kernel": "0.2.20",

package/skills/jskit/references/sanity-checks.md

@@ -57,6 +57,8 @@ truthful model-facing output; the assistant validates the result against
 `extensions.assistant.output` and rejects unexpected fields, so a contract
 that promises what execution cannot return fails at run time, not at review
 ([Assistant](/guide/app-extras/assistant#database-surface-action-tools)).
+Call it with the largest real input too, seeded records included: a tool's
+arguments stop at 32 KiB and its result at 48 KiB by default.
 
 **Example:** sparse primary fields stay sparse, and an included record is read
 from its lookup container (`items[0].lookups.pet.name`); a contract that

package/skills/jskit/references/translation.md

@@ -210,6 +210,19 @@ translate a key and show any other string as written:
 { label: "Reports" }
 ```
 
+## Content the app ships as data
+
+Names and descriptions in records the app seeds or ships, such as a
+catalogue's items or a library's templates, are the app's own text. Prefer
+storing their message key (`app.templates.starter.name`) with the English in
+the app's `en` messages, and show the field with `text()` from
+`useJskitText()`, the helper placement labels use: it translates a key and
+shows any other string as written. Stored English cannot follow the user's
+language, and matching it back to a key breaks once someone edits it. When a
+person renames their own copy, the field takes what they wrote and shows it as
+written. Server code that writes such a field into an email or an export
+resolves the key with `createServerI18n` (see [Emails](#emails)).
+
 ## Dates and numbers
 
 JSKIT formats dates, times, numbers and relative times with `Intl` in the