@hachej/boring-agent 0.4.28 → 0.4.29

package/README.md

@@ -551,3 +551,7 @@ Reply placeholders such as `{note.title}` accept actual strings, finite numbers
 Hosts must explicitly configure existing conversations when adopting this virtual model; deployment alone does not change their persisted selection. Keep the action's tool and result contract compatible while native work is pending. Changing definitions during an outstanding action is not a version-pinning guarantee.
 
 Evidence: `node --test test/packages/agent-actions.test.mjs` runs the public package through a native Harness, SQLite reopen, native tool gates and scripted models. `npm run test:definitions-consumer -- --actions` repeats these tests and checks strict installed declarations. Real-model speed and decision accuracy remain consumer evals, not claims of these scripted tests.
+
+### Deferred action context
+
+`withActionModels(models, { resolve, prepareFullContext })` optionally prepares context only before a full-model fallback. The asynchronous callback receives the native model context and request options, including cancellation. Successful extraction and automatic replies never invoke it. A preparation failure fails the generation without sending unprepared context. Hosts must install required guards before routing and preserve their native request/task ownership when deferring memory; this callback does not create background work or persist anything.

package/dist/actions.d.ts

@@ -26,6 +26,8 @@ export interface StructuredAction {
 export interface ActionModelsOptions {
     /** Resolve trusted configuration; this never registers tools or grants permissions. */
     readonly resolve: (id: string) => StructuredAction | undefined;
+    /** Prepare memory only when a real full-model request is needed; errors fail closed. */
+    readonly prepareFullContext?: (context: Parameters<Models['streamSimple']>[1], options: Parameters<Models['streamSimple']>[2]) => Promise<Parameters<Models['streamSimple']>[1]>;
     readonly now?: () => number;
 }
 /** Substitute actual scalar results only. Missing values cannot become invented confirmations. */

package/dist/actions.js

@@ -72,8 +72,12 @@ export function withActionModels(models, options) {
             const action = resolve(model.id);
             const original = required(action.model);
             const out = createAssistantMessageEventStream();
-            const full = async () => { for await (const event of models.streamSimple(original, context, requestOptions))
-                out.push(event); };
+            const full = async () => {
+                const prepared = options.prepareFullContext ? await options.prepareFullContext(context, requestOptions) : context;
+                requestOptions?.signal?.throwIfAborted();
+                for await (const event of models.streamSimple(original, prepared, requestOptions))
+                    out.push(event);
+            };
             const emit = (message) => {
                 if (message.stopReason === 'error' || message.stopReason === 'aborted')
                     out.push({ type: 'error', reason: message.stopReason, error: message });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hachej/boring-agent",
-  "version": "0.4.28",
+  "version": "0.4.29",
   "license": "MIT",
   "private": false,
   "type": "module",
@@ -180,8 +180,8 @@
     "@earendil-works/pi-durable": "~1.4.0",
     "@earendil-works/pi-ai": "~1.4.0",
     "@earendil-works/chord": "~1.4.0",
-    "@hachej/boring-files": "^0.4.28",
-    "@hachej/boring-ui-kit": "^0.4.28",
+    "@hachej/boring-files": "^0.4.29",
+    "@hachej/boring-ui-kit": "^0.4.29",
     "typebox": "1.3.27",
     "xlsx": "^0.20.3"
   },