@jskit-ai/agent-docs 0.1.302 → 0.1.304

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

@@ -492,6 +492,30 @@ The assistant validates the transformed result against
 JSON:API CRUD actions supply these assistant contracts and transformations
 automatically; their native action and HTTP result shapes do not change.
 
+A tool call's arguments may be at most 32 KiB, and its result at most 48 KiB.
+A surface whose assistant writes a larger document in one call, or reads one
+back, raises its own limits, up to 1 MiB each:
+
+```js
+assistantServer: {
+  planner: { aiIntegrationId: "assistant", maxToolArgumentBytes: 128 * 1024, maxToolResultBytes: 128 * 1024 }
+}
+```
+
+Every engine is given the surface's argument limit, and a larger call ends the
+turn with "The application tool arguments exceed their size limit." before the
+action runs. A larger result is not handed to the model: the action has run, and
+the model reads the error `assistant_tool_result_too_large` (status 413) in its
+place and carries on. The Claude engine starts Claude Code with the surface's
+result limit, so a result within it reaches the model whole, up to Claude Code's
+own ceiling of 500,000 characters; past that, Claude Code saves the result to a
+file and shows the model only its start. A malformed value stops the server from
+starting. On
+MySQL, apply the package's migrations as usual: one lets a saved call's
+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.
+
 ### Framework account and workspace actions
 
 Account and workspace action owners supply assistant-specific descriptions,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jskit-ai/agent-docs",
-  "version": "0.1.302",
+  "version": "0.1.304",
   "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.54",
+    "@jskit-ai/jskit-catalog": "0.2.56",
     "@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.54",
+    "@jskit-ai/jskit-catalog": "0.2.56",
     "@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.302`
+- Owner: `@jskit-ai/agent-docs@0.1.304`
 - 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.302`
+- Owner: `@jskit-ai/agent-docs@0.1.304`
 - 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.46`
+- Owner: `@jskit-ai/assistant-runtime@0.2.48`
 - 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`
@@ -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.302`
+- Owner: `@jskit-ai/agent-docs@0.1.304`
 - 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/reference/autogen/packages/assistant-core.md

@@ -385,6 +385,7 @@ Exports
 Local functions
 - `claudeProjectDirectoryName(canonical)`
 - `claudeUserText(content)`
+- `claudeAuthoredMessage(frame)`
 - `retainedClaudeFrame(frame)`
 - `claudeHistoryFrames(file)`
 - `completeHistoryOffset(handle, start, size)`
@@ -421,7 +422,7 @@ Exports
 - `claudePlanUsage(value)`
 - `claudeCatalogueModels(initialization)`
 - `createClaudeAccountQueries({ createProcess, accountIdentity, configRoot, processes = noOwnedProcesses, isClosing = neverClosing })`
-- `createClaudeCodeProcess({ command = "claude", execution = createLocalConversationExecution(), env, workdir, onEvent, onControlRequest, onFailure = ignoreProcessFailure, onStarted = ignoreProcessStart, executionLimits, signal, commandWrapper, initializationTimeoutMs = 30_000, onInitializationProgress, ...options })`
+- `createClaudeCodeProcess({ command = "claude", execution = createLocalConversationExecution(), env, workdir, onEvent, onControlRequest, onFailure = ignoreProcessFailure, onStarted = ignoreProcessStart, executionLimits, signal, commandWrapper, initializationTimeoutMs = 30_000, onInitializationProgress, maximumToolResultBytes, ...options })`
 - `type ClaudeCodeProcess`
 Local functions
 - `ignoreProcessStart()`
@@ -453,7 +454,8 @@ Exports
 
 ### `src/server/conversation/claudeTools.js`
 Exports
-- `claudeApplicationToolResponse(request, { schemas, turn, signal, assertCurrent = acceptNativeCall, onExecutionFailure = ignoreExecutionFailure })`
+- `claudeToolResultAllowance(maximumResultBytes)`
+- `claudeApplicationToolResponse(request, { schemas, maximumResultBytes, turn, signal, assertCurrent = acceptNativeCall, onExecutionFailure = ignoreExecutionFailure })`
 - `CLAUDE_APPLICATION_TOOL_SERVER`
 Local functions
 - `acceptNativeCall()`
@@ -2029,6 +2031,8 @@ Exports
 ### `src/server/lib/serviceToolCatalog.js`
 Exports
 - `createServiceToolCatalog(actions, { isActionAvailable, barredActionIds = [], skipActionPrefixes = [], maxDirectTools: rawMaxDirectTools = DEFAULT_MAX_DIRECT_TOOLS, discoveryPageSize: rawDiscoveryPageSize = DEFAULT_DISCOVERY_PAGE_SIZE, maxToolArgumentBytes: rawMaxToolArgumentBytes = DEFAULT_MAX_TOOL_ARGUMENT_BYTES, maxToolResultBytes: rawMaxToolResultBytes = DEFAULT_MAX_TOOL_RESULT_BYTES } = {})`
+- `DEFAULT_MAX_TOOL_ARGUMENT_BYTES`
+- `DEFAULT_MAX_TOOL_RESULT_BYTES`
 - `DISCOVERY_TOOL_DESCRIPTORS`
 Local functions
 - `parseToolPayload(argumentsText)`
@@ -2404,6 +2408,7 @@ Exports
 - None
 Local functions
 - `finishUploads()`
+- `worked()`
 
 ### `fixtures/responsive-assistant/DeliveryFixture.vue`
 Exports

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

@@ -427,6 +427,7 @@ Exports
 - `resolveAssistantAiConfig({ appConfig = {}, env = {} } = {}, targetSurfaceId = "")`
 Local functions
 - `normalizeSettingsUpdatePermission(value, targetSurfaceId)`
+- `normalizeMaxToolBytes(entry, key, targetSurfaceId)`
 - `readPrefixedEnvValue(env = {}, prefix = "", key = "")`
 
 ### `src/server/support/assistantStreamWriter.js`
@@ -566,6 +567,10 @@ Exports
 Exports
 - None
 
+### `migrations/assistant_transcripts_tool_arguments.cjs`
+Exports
+- None
+
 ### `migrations/assistant_turn_requests.cjs`
 Exports
 - None

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.302`
+- Owner: `@jskit-ai/agent-docs@0.1.304`
 - 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.302`
+- Owner: `@jskit-ai/agent-docs@0.1.304`
 - 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`
@@ -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.46`
+- Owner: `@jskit-ai/assistant-runtime@0.2.48`
 - Read: [PATTERN.md](patterns/assistant/assistant-surface/PATTERN.md)
 - Examples: [example/](patterns/assistant/assistant-surface/example/)
 - 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
 
 - 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.302`
+- Owner: `@jskit-ai/agent-docs@0.1.304`
 - 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.54",
+    "@jskit-ai/jskit-catalog": "0.2.56",
     "@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.54",
+    "@jskit-ai/jskit-catalog": "0.2.56",
     "@playwright/test": "1.61.1",
     "@vitejs/plugin-vue": "^6.0.7",
     "eslint": "^10.8.0",