@parcha/agentrun-pi 0.1.0-beta.8 → 0.1.0-beta.9

package/dist/extension-service.js

@@ -54,8 +54,10 @@ async function withAdapterDiagnostic(stage, run) {
                 if (error.code === 'http') {
                     if (Number.isInteger(error.status) && error.status >= 100 && error.status <= 599)
                         diagnostic.status = error.status;
-                    if (reason === 'max_tokens_exceeded')
+                    if (reason === 'max_tokens_exceeded') {
                         diagnostic.reason = reason;
+                        diagnostic.message = 'Jev refused the request: it exceeds the model\'s token budget. Send fewer or shorter items per request. No judgment was accepted; provider details are omitted.';
+                    }
                 }
             }
         }
@@ -124,7 +126,7 @@ function localDiagnostic(error) {
             && stateBytes > maxStateBytes && maxStateBytes > 0)
             return {
                 code: 'jev_state_too_large', stage, stateBytes, maxStateBytes,
-                message: `Jev state at ${stage} is ${stateBytes} UTF-8 bytes; configured host limit is ${maxStateBytes}. No request was sent. A sift batches every item in one state; select original context explicitly or use per-item judgments without losing headers or qualifiers.`
+                message: `Jev state at ${stage} is ${stateBytes} UTF-8 bytes; configured host limit is ${maxStateBytes}. No request was sent. A sift splits its items across requests only when the host sets maxStateBytesPerRequest; otherwise send less of each item or use per-item judgments without losing headers or qualifiers.`
             };
         if (reason === 'invalid_state' || reason === 'invalid_questions')
             return { code: `jev_${reason}`, stage,
@@ -361,11 +363,36 @@ export class WorkflowExtensionService {
                 queue.shift()?.();
             }
         };
+        const rejectTrace = (error) => {
+            rejectedEvents++;
+            traceTruncated = true;
+            if (!signal.aborted) {
+                // Snapshot rejects unsafe/non-JSON values separately from resource bounds.
+                // Keep fail-closed cancellation; never echo values or arbitrary error text.
+                const diagnostic = error instanceof ExtensionServiceError && error.code === 'data'
+                    ? new ExtensionServiceError('trace_invalid_data', 'Workflow trace contains non-JSON data. Numbers must be finite; objects and arrays must be plain, acyclic and free of accessors or symbols.')
+                    : error instanceof ExtensionServiceError && error.code === 'bounds'
+                        ? new ExtensionServiceError('limit', 'Workflow trace exceeded its JSON byte, depth or value-count limit.')
+                        : new ExtensionServiceError('trace_capture_failed', 'Workflow trace capture failed. Unsafe event details are omitted.');
+                controller.abort(diagnostic);
+            }
+        };
+        const prepareEvent = (event) => {
+            if (closed)
+                return { type: event.type, label: event.label };
+            try {
+                return snapshot(event, this.limits.maxEventBytes);
+            }
+            catch (error) {
+                rejectTrace(error);
+                return undefined;
+            }
+        };
         const onEvent = (event) => {
             if (closed)
                 return;
             try {
-                const clean = sanitize(snapshot(event, this.limits.maxEventBytes));
+                const clean = sanitize(event);
                 const size = Buffer.byteLength(JSON.stringify(clean));
                 if (size > this.limits.maxEventBytes)
                     throw new ExtensionServiceError('bounds', 'Workflow event exceeds its serialized byte limit.');
@@ -405,26 +432,17 @@ export class WorkflowExtensionService {
                 }
             }
             catch (error) {
-                rejectedEvents++;
-                traceTruncated = true;
-                if (!signal.aborted) {
-                    // Snapshot rejects unsafe/non-JSON values separately from resource bounds.
-                    // Keep fail-closed cancellation; never echo values or arbitrary error text.
-                    const diagnostic = error instanceof ExtensionServiceError && error.code === 'data'
-                        ? new ExtensionServiceError('trace_invalid_data', 'Workflow trace contains non-JSON data. Numbers must be finite; objects and arrays must be plain, acyclic and free of accessors or symbols.')
-                        : error instanceof ExtensionServiceError && error.code === 'bounds'
-                            ? new ExtensionServiceError('limit', 'Workflow trace exceeded its JSON byte, depth or value-count limit.')
-                            : new ExtensionServiceError('trace_capture_failed', 'Workflow trace capture failed. Unsafe event details are omitted.');
-                    controller.abort(diagnostic);
-                }
+                rejectTrace(error);
             }
         };
         const sections = Object.entries(this.rubricSections);
         const deps = {
-            signal, onEvent,
+            signal, onEvent, prepareEvent,
             ...(options.deps.skill ? { skill: options.deps.skill } : {}),
             ...(sections.length ? { sop: sections.map(([name, text]) => `## ${name}\n${text}`).join('\n\n') } : options.deps.sop ? { sop: options.deps.sop } : {}),
-            ...(options.deps.maxQuestionsPerRequest ? { maxQuestionsPerRequest: options.deps.maxQuestionsPerRequest } : {}),
+            // Forward any set limit, so the interpreter rejects an invalid one rather than running without it.
+            ...(options.deps.maxQuestionsPerRequest !== undefined ? { maxQuestionsPerRequest: options.deps.maxQuestionsPerRequest } : {}),
+            ...(options.deps.maxStateBytesPerRequest !== undefined ? { maxStateBytesPerRequest: options.deps.maxStateBytesPerRequest } : {}),
             ...(options.deps.runNode ? { runNode: params => dispatch('agent', params.signal, () => withAdapterDiagnostic(params.label, () => options.deps.runNode({ ...params, tools: params.tools ?? [...this.allowedTools] })), true) } : {}),
             ...(options.deps.runJudge ? { runJudge: params => dispatch('judge', params.signal, () => withAdapterDiagnostic(params.label, () => options.deps.runJudge(params)), true) } : {}),
             ...(options.deps.runEffect ? { runEffect: params => dispatch('tool', params.signal, () => {

package/dist/skills/author/references/language.md

@@ -69,7 +69,7 @@ Typed questions answered by the host's judge in one request each: no tools, no s
 - A question schema is a flat object. Each property's `description` is its question. A boolean yields a yes-probability; a string enum (at most 240 options, optional per-option `criteria`) yields a choice; an integer with `criteria`: [level descriptions] (2 to 10 levels, minimum 0, maximum the last level index) yields a score. Nothing else is a question.
 - `judge`: a non-empty `state` map, `out` (a question schema) and `as`. The decoded value lands at `as`, the raw answers at `<as>$answers`.
 - `pick`: `itemsPath`, `describe` (the option text per item, such as "{item.name}"), `instructions` (the one question) and `as`; `allowNone` adds a none-of-these option. The result is {index, item, none, option}.
-- `sift`: `itemsPath`, `out` (a question schema asked of every item in one request) and `as`. `keep` {path: a question id or <id>.confidence, never a choice, gte?} keeps passing items, in order, at `<as>.items`.
+- `sift`: `itemsPath`, `out` (a question schema asked of every item; the host splits the items across requests when they exceed its limits) and `as`. `keep` {path: a question id or <id>.confidence, never a choice, gte?} keeps passing items, in order, at `<as>.items`.
 - `route`: a non-empty `state` map, `instructions` (the one question) and 2 to 240 named `branches`, each {criteria?, body}. `unsure` {branch: one of the branches, gte: a number in (0, 1]} takes that branch when the choice's confidence is below `gte`. `as` records the choice.
 - A decoded boolean is true at yes-probability 0.5. To hold a different threshold, read `<as>$answers.answers.<id>.noul` in a code node.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@parcha/agentrun-pi",
-  "version": "0.1.0-beta.8",
+  "version": "0.1.0-beta.9",
   "description": "Pi extension for building, running and evaluating AgentRun workflows",
   "type": "module",
   "license": "Apache-2.0",
@@ -35,8 +35,8 @@
     "@earendil-works/pi-ai": "0.87.0"
   },
   "dependencies": {
-    "@parcha/agentrun-dsl": "0.1.0-beta.8",
-    "@parcha/agentrun-jev": "0.1.0-beta.8",
+    "@parcha/agentrun-dsl": "0.1.0-beta.9",
+    "@parcha/agentrun-jev": "0.1.0-beta.9",
     "@earendil-works/pi-agent-core": "0.87.0",
     "@earendil-works/pi-coding-agent": "0.87.0",
     "@earendil-works/pi-tui": "0.87.0",