@jini-ai/core 0.6.19 → 0.6.21

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # @jini-ai/core
 
+## 0.6.21
+
+- `createPreparedBatchHandler`: prepares a complete direct batch before any effect, reusing the approval handler's input snapshot, cap, duplicate detection and cancellation lifecycle, with no review card.
+
 ## 0.6.19
 
 - Preserve detached, frozen batch schema symbol metadata in tool exposure snapshots and single-call required-field guidance in plan-mode descriptions.

package/dist/approval.d.ts

@@ -73,6 +73,16 @@ export interface ApprovalSteps<TPrepared, TDescription> {
 export declare function createApprovalHandler<TPrepared, TDescription>(steps: ApprovalSteps<TPrepared, TDescription>, { remembered }?: {
     remembered?: RememberedApprovalPort;
 }): ToolHandler;
+/** Prepare a complete direct batch before effects, reusing the approval owner's input snapshot,
+ * cap, duplicate detection and cancellation lifecycle. No review description or transport exists.
+ * @returns A handler preserving scalar results and ordered batch results.
+ * @throws ToolInputError on cancellation or invalid batches; preparation/effect failures propagate.
+ * @complexity Same bounds as createBatchApprovalHandler: O(input bytes) plus bounded port effects.
+ * @example createPreparedBatchHandler({ prepare, run });
+ */
+export declare function createPreparedBatchHandler<TPrepared>(steps: Pick<ApprovalSteps<TPrepared, undefined>, 'prepare' | 'run'>, options?: {
+    maxItems?: number;
+}): ToolHandler;
 /** Prepare every item before asking once for the complete batch. Reuses the single-call approval
  * lifecycle, including its detached inputs, authenticated confirmer and abort checks.
  * Single inputs preserve their result shape. Batch effects run in order and stop on the first

package/dist/approval.js

@@ -90,6 +90,20 @@ export function createApprovalHandler(steps, { remembered } = {}) {
         },
     });
 }
+/** Prepare a complete direct batch before effects, reusing the approval owner's input snapshot,
+ * cap, duplicate detection and cancellation lifecycle. No review description or transport exists.
+ * @returns A handler preserving scalar results and ordered batch results.
+ * @throws ToolInputError on cancellation or invalid batches; preparation/effect failures propagate.
+ * @complexity Same bounds as createBatchApprovalHandler: O(input bytes) plus bounded port effects.
+ * @example createPreparedBatchHandler({ prepare, run });
+ */
+export function createPreparedBatchHandler(steps, options = {}) {
+    return createBatchApprovalHandler({ steps: { ...steps,
+            describe: () => ({ ask: false, description: undefined }),
+            askHuman: async () => { throw new Error('Direct batches have no approval transport'); },
+            notConfirmed: ({ reason }) => { throw new ToolInputError({ message: `This tool call was ${reason} before the next change. Retry the remaining changes when ready.` }); },
+        }, combineDescriptions: () => undefined }, options);
+}
 /** Prepare every item before asking once for the complete batch. Reuses the single-call approval
  * lifecycle, including its detached inputs, authenticated confirmer and abort checks.
  * Single inputs preserve their result shape. Batch effects run in order and stop on the first

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jini-ai/core",
-  "version": "0.6.19",
+  "version": "0.6.21",
   "description": "The Jini kernel: typed DI tokens, pack composition and lifecycle, the tool registry, redaction, and origin/API-token auth primitives. Zero dependencies.",
   "license": "Apache-2.0",
   "repository": {