@jskit-ai/agent-docs 0.1.302 → 0.1.303

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 (9) hide show
  1. package/guide/agent/app-extras/assistant.md +20 -0
  2. package/package.json +1 -1
  3. package/patterns/minimal-foundation/example/package.json +1 -1
  4. package/patterns/shell-foundation/example/package.json +1 -1
  5. package/reference/autogen/PATTERN_INDEX.md +4 -4
  6. package/reference/autogen/packages/assistant-runtime.md +5 -0
  7. package/skills/jskit/references/pattern-index.md +4 -4
  8. package/skills/jskit/references/patterns/app/minimal-foundation/example/package.json +1 -1
  9. package/skills/jskit/references/patterns/app/shell-foundation/example/package.json +1 -1
package/guide/agent/app-extras/assistant.md CHANGED
@@ -492,6 +492,26 @@ The assistant validates the transformed result against
492
492
  JSON:API CRUD actions supply these assistant contracts and transformations
493
493
  automatically; their native action and HTTP result shapes do not change.
494
494
 
495
+ A tool call's arguments may be at most 32 KiB, and its result at most 48 KiB.
496
+ A surface whose assistant writes a larger document in one call, or reads one
497
+ back, raises its own limits, up to 1 MiB each:
498
+
499
+ ```js
500
+ assistantServer: {
501
+ planner: { aiIntegrationId: "assistant", maxToolArgumentBytes: 128 * 1024, maxToolResultBytes: 128 * 1024 }
502
+ }
503
+ ```
504
+
505
+ Every engine is given the surface's argument limit, and a larger call ends the
506
+ turn with "The application tool arguments exceed their size limit." before the
507
+ action runs. A larger result is not handed to the model: the action has run, and
508
+ the model reads the error `assistant_tool_result_too_large` (status 413) in its
509
+ place and carries on. A malformed value stops the server from starting. On
510
+ MySQL, apply the package's migrations as usual: one lets a saved call's
511
+ arguments and result pass 64 KiB. The model must still write the call in one
512
+ step: the API engine asks for at most 32,000 output tokens a step, and a model's
513
+ own output limit, or its reasoning, can leave less.
514
+
495
515
  ### Framework account and workspace actions
496
516
 
497
517
  Account and workspace action owners supply assistant-specific descriptions,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@jskit-ai/agent-docs",
3
- "version": "0.1.302",
3
+ "version": "0.1.303",
4
4
  "description": "Distributed JSKIT agent references, prompts, guides, and generated reference maps.",
5
5
  "type": "module",
6
6
  "files": [
package/patterns/minimal-foundation/example/package.json CHANGED
@@ -50,7 +50,7 @@
50
50
  },
51
51
  "devDependencies": {
52
52
  "@jskit-ai/config-eslint": "0.1.250",
53
- "@jskit-ai/jskit-catalog": "0.2.54",
53
+ "@jskit-ai/jskit-catalog": "0.2.55",
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/package.json CHANGED
@@ -51,7 +51,7 @@
51
51
  },
52
52
  "devDependencies": {
53
53
  "@jskit-ai/config-eslint": "0.1.250",
54
- "@jskit-ai/jskit-catalog": "0.2.54",
54
+ "@jskit-ai/jskit-catalog": "0.2.55",
55
55
  "@playwright/test": "1.61.1",
56
56
  "@vitejs/plugin-vue": "^6.0.7",
57
57
  "eslint": "^10.8.0",
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.302`
18
+ - Owner: `@jskit-ai/agent-docs@0.1.303`
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.302`
29
+ - Owner: `@jskit-ai/agent-docs@0.1.303`
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.2.46`
40
+ - Owner: `@jskit-ai/assistant-runtime@0.2.47`
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`
@@ -356,7 +356,7 @@ Define a server feature through explicit capabilities and first-class actions, a
356
356
 
357
357
  - Id: `server/feature-package`
358
358
  - Keywords: `actions`, `aggregate`, `feature`, `handle`, `orchestration`, `owns`, `package`, `provider`, `repository`, `routes`, `server`, `table resource`
359
- - Owner: `@jskit-ai/agent-docs@0.1.302`
359
+ - Owner: `@jskit-ai/agent-docs@0.1.303`
360
360
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/server/feature-package/PATTERN.md)
361
361
  - Examples: [example/](../../skills/jskit/references/patterns/server/feature-package/example/)
362
362
  - Requires: `@jskit-ai/kernel`
package/reference/autogen/packages/assistant-runtime.md CHANGED
@@ -427,6 +427,7 @@ Exports
427
427
  - `resolveAssistantAiConfig({ appConfig = {}, env = {} } = {}, targetSurfaceId = "")`
428
428
  Local functions
429
429
  - `normalizeSettingsUpdatePermission(value, targetSurfaceId)`
430
+ - `normalizeMaxToolBytes(entry, key, targetSurfaceId)`
430
431
  - `readPrefixedEnvValue(env = {}, prefix = "", key = "")`
431
432
 
432
433
  ### `src/server/support/assistantStreamWriter.js`
@@ -566,6 +567,10 @@ Exports
566
567
  Exports
567
568
  - None
568
569
 
570
+ ### `migrations/assistant_transcripts_tool_arguments.cjs`
571
+ Exports
572
+ - None
573
+
569
574
  ### `migrations/assistant_turn_requests.cjs`
570
575
  Exports
571
576
  - None
package/skills/jskit/references/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.302`
18
+ - Owner: `@jskit-ai/agent-docs@0.1.303`
19
19
  - Read: [PATTERN.md](patterns/app/minimal-foundation/PATTERN.md)
20
20
  - Examples: [example/](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.302`
29
+ - Owner: `@jskit-ai/agent-docs@0.1.303`
30
30
  - Read: [PATTERN.md](patterns/app/shell-foundation/PATTERN.md)
31
31
  - Examples: [example/](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.2.46`
40
+ - Owner: `@jskit-ai/assistant-runtime@0.2.47`
41
41
  - Read: [PATTERN.md](patterns/assistant/assistant-surface/PATTERN.md)
42
42
  - Examples: [example/](patterns/assistant/assistant-surface/example/)
43
43
  - Requires: `@jskit-ai/assistant-runtime`, `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`, `@jskit-ai/shell-web`
@@ -356,7 +356,7 @@ Define a server feature through explicit capabilities and first-class actions, a
356
356
 
357
357
  - Id: `server/feature-package`
358
358
  - Keywords: `actions`, `aggregate`, `feature`, `handle`, `orchestration`, `owns`, `package`, `provider`, `repository`, `routes`, `server`, `table resource`
359
- - Owner: `@jskit-ai/agent-docs@0.1.302`
359
+ - Owner: `@jskit-ai/agent-docs@0.1.303`
360
360
  - Read: [PATTERN.md](patterns/server/feature-package/PATTERN.md)
361
361
  - Examples: [example/](patterns/server/feature-package/example/)
362
362
  - Requires: `@jskit-ai/kernel`
package/skills/jskit/references/patterns/app/minimal-foundation/example/package.json CHANGED
@@ -50,7 +50,7 @@
50
50
  },
51
51
  "devDependencies": {
52
52
  "@jskit-ai/config-eslint": "0.1.250",
53
- "@jskit-ai/jskit-catalog": "0.2.54",
53
+ "@jskit-ai/jskit-catalog": "0.2.55",
54
54
  "@playwright/test": "1.61.1",
55
55
  "@vitejs/plugin-vue": "^6.0.7",
56
56
  "eslint": "^10.8.0",
package/skills/jskit/references/patterns/app/shell-foundation/example/package.json CHANGED
@@ -51,7 +51,7 @@
51
51
  },
52
52
  "devDependencies": {
53
53
  "@jskit-ai/config-eslint": "0.1.250",
54
- "@jskit-ai/jskit-catalog": "0.2.54",
54
+ "@jskit-ai/jskit-catalog": "0.2.55",
55
55
  "@playwright/test": "1.61.1",
56
56
  "@vitejs/plugin-vue": "^6.0.7",
57
57
  "eslint": "^10.8.0",