@jskit-ai/agent-docs 0.1.305 → 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.305",
+  "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.57",
+    "@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.57",
+    "@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.305`
+- 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.305`
+- 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`
@@ -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.305`
+- 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`

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.305`
+- 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.305`
+- 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`
@@ -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.305`
+- 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`

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.57",
+    "@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.57",
+    "@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/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