@alma-harness/batch 0.6.0

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,65 @@
+# @alma-harness/batch
+
+Governed single-dispatch batch execution. Node >=22 and matching Alma
+packages are required. `createGovernedBatchRunner` composes BatchSubmissionStore,
+BatchUsageStore, BatchAccountingStore, ExecutionResultStore, governed settlement,
+same-counter spend.peek, audit and SingleDispatchBatchClient capabilities.
+
+Supply immutable configRevision (including provider account selection), bounded
+request/output/aggregate sizes, runTimeoutMs <=5 minutes and onBackgroundError.
+The host creates authorized complete manifests: scope/session, item identities,
+original prices/policy/controls, content/config revisions and result retention.
+The host derives allowed tools/media/schema; this primitive does not route policy
+or execute handlers. Never accept manifests/scopes/handles from model output or
+unverified browser input. Changing config requires a new revision; old batches
+must still resolve their original configuration, prices and provider account.
+
+`submit({input,rationale,loadItems,signal?})` reserves every result and awaits audit
+before loading content. Requests must match ordered IDs, model, batch tier and
+controls. Only the first durable dispatch:true response permits a provider attempt.
+Equal replay never loads input or submits again. The optional awaited onInputFile
+hook can retain upload references before create; without it no durable orphan-file
+inventory is claimed. Any ambiguous submission stays unresolved, even after expiry.
+No fallback, automatic resubmission, provider cancellation or lease takeover exists.
+
+`collect({scope,key},{signal?})` resolves the stored handle and collects every
+terminal status, including failed/expired/cancelled. Every observation is journaled
+before governed settlement and inclusive accounting. Those are the only financial
+writers: neither SpendStore.add nor AuditLog.cost runs. Hashes deduplicate metadata
+observations only; original manifest settlement identities own charges. Unknown,
+unpriced and contradictory evidence stays pending for explicit reconciliation.
+
+New output is retained only after complete, independently validated EOF. Corrupt
+or missing tails cannot authorize partial new output. Content bounds/failures do
+not stop known-usage drainage. `eof` describes this invocation, not a durable
+completion certificate. `reconciliationRequired` reports this collection's pending
+financial/content work. Existing output remains readable after a later failed GET.
+A crash between puts can require another GET, but never another model submission.
+
+`read({scope,key})` returns persisted metadata, inclusive financial evidence and
+current retained item results; it makes no claim of EOF or delivery. Successful
+`output` is a backstage `governed-batch-v1` envelope with ordered neutral blocks and
+stop. Reasoning is not a public reply; the host validates its business schema and
+authorizes any effects. Refusal/truncation/invalid/blocked/unavailable stay distinct.
+Original block decisions suppress successful outputs; missing aggregate receipts
+keep block-mode success pending until those decisions can be evaluated; warn preserves them. Monetary
+warnings are durable evidence, not calls to an external notification service.
+
+`reconcile({scope,key},query?)` repairs journaled finance without provider/content
+access. It returns scanned/repaired/pending counts and afterId. Pages default50,
+maximum100; restart future passes at the beginning. Already adopted observations
+must still repair missing aggregate receipts, so default queries include them.
+
+Result retention begins at submission reservation. Collection never prepares a
+new reservation, renews retention or resurrects erasure. Read/put respect the
+original binding; register result erasure/purge with the host. Successful public
+submit/collect promises are bounded by timeout/abort (submission also by its
+original deadline); cancellation does not prove dependency termination. Late
+acceptance/financial work is observed, and background failures report only scoped
+stage metadata. Permanent process loss cannot guarantee missing provider evidence.
+
+Migrate batch accounting (which composes submission, usage and governed costs),
+results and audit before enabling this runner. PostgreSQL store deadlines still
+apply to read/reconcile. Routines and channel/business delivery require their own
+persistent claims; this runner never sends real messages or certifies delivery.
+See [spec](../../docs/specs/099-governed-batch-runner.md).

package/dist/index.d.ts

@@ -0,0 +1,71 @@
+import { BatchSubmissionRecord, BatchFinancialSummary, BatchFinancialReceipt, BatchSubmissionStore, BatchUsageStore, BatchAccountingStore, GovernedCostSettlementStore, SingleDispatchBatchClient, BatchSubmissionInput, BatchUsageQuery } from '@alma-harness/execution';
+import { Scope, ExecutionResultRecord, ExecutionResult, JobOutput, ExecutionResultStore, SpendStore, AuditLog, ProviderId, JobItem } from '@alma-harness/core';
+
+interface BatchKey {
+    scope: Scope;
+    key: string;
+}
+interface GovernedBatchConfig {
+    batches: BatchSubmissionStore;
+    usage: BatchUsageStore;
+    accounting: BatchAccountingStore;
+    results: ExecutionResultStore;
+    settlements: GovernedCostSettlementStore;
+    spend: Pick<SpendStore, 'peek'>;
+    audit: AuditLog;
+    clients: Partial<Record<ProviderId, SingleDispatchBatchClient>>;
+    configRevision: string;
+    runTimeoutMs: number;
+    maxRequestChars: number;
+    maxOutputChars: number;
+    maxBatchOutputChars: number;
+    onBackgroundError(event: BatchKey & {
+        stage: string;
+    }): void;
+    /** Metadata observation only. Failure stops submission before advancing past the uploaded file. */
+    onInputFile?(event: BatchKey & {
+        fileId: string;
+    }): Promise<void>;
+}
+interface GovernedBatchSubmit {
+    input: BatchSubmissionInput;
+    rationale: string;
+    loadItems(): Promise<JobItem[]>;
+    signal?: AbortSignal;
+}
+interface GovernedBatchOutput extends Omit<JobOutput, 'usage'> {
+    version: 'governed-batch-v1';
+}
+interface GovernedBatchItemView {
+    id: string;
+    state: ExecutionResultRecord['state'] | 'unavailable';
+    result: ExecutionResult;
+    receipt?: BatchFinancialReceipt;
+    output?: GovernedBatchOutput;
+}
+interface GovernedBatchView {
+    record: BatchSubmissionRecord;
+    financial: BatchFinancialSummary | null;
+    items: GovernedBatchItemView[];
+}
+interface GovernedBatchCollection {
+    eof: boolean;
+    reconciliationRequired: boolean;
+    view: GovernedBatchView;
+}
+
+declare function createGovernedBatchRunner(value: GovernedBatchConfig): {
+    submit: (value: GovernedBatchSubmit) => Promise<GovernedBatchView>;
+    collect: (value: BatchKey, opts?: {
+        signal?: AbortSignal;
+    }) => Promise<GovernedBatchCollection>;
+    read: (value: BatchKey) => Promise<GovernedBatchView | null>;
+    reconcile: (value: BatchKey, query?: BatchUsageQuery) => Promise<{
+        afterId?: string;
+        scanned: number;
+        repaired: number;
+        pending: number;
+    } | null>;
+};
+
+export { type BatchKey, type GovernedBatchCollection, type GovernedBatchConfig, type GovernedBatchItemView, type GovernedBatchOutput, type GovernedBatchSubmit, type GovernedBatchView, createGovernedBatchRunner };

package/dist/index.js

@@ -0,0 +1,416 @@
+// src/index.ts
+import { createHash } from "crypto";
+import { AuditSinkError, BudgetExceededError, equalExecution, ExecutionConflictError, ExecutionResultPolicyError, ExecutionStateError, normalizeSpendTotals, normalizeBudgetCaps, settlementIdentifier, settlementScope } from "@alma-harness/core";
+import { batchUsageQuery, batchUsageSettlement, normalizeBatchRecord, normalizeBatchSubmission, normalizeBatchUsage } from "@alma-harness/execution";
+
+// src/output.ts
+var unavailable = () => ({ outcome: "unavailable", stopReason: null });
+var binding = (e) => ({ scope: e.scope, callId: e.callId, sessionId: e.sessionId, sensitivity: e.intent.sensitivity, retentionMs: e.governance.resultRetentionMs });
+function json(value, depth = 0) {
+  if (depth > 100) throw new TypeError("Invalid batch output");
+  if (value === null || typeof value === "boolean") return;
+  if (typeof value === "string") {
+    if (!value.isWellFormed() || value.includes("\0")) throw new TypeError("Invalid batch output");
+    return;
+  }
+  if (typeof value === "number" && Number.isFinite(value)) return;
+  if (!value || typeof value !== "object" || !Array.isArray(value) && Object.getPrototypeOf(value) !== Object.prototype) throw new TypeError("Invalid batch output");
+  if (Array.isArray(value) && Object.keys(value).length !== value.length) throw new TypeError("Sparse batch output");
+  for (const k of Reflect.ownKeys(value)) {
+    if (k === "length" && Array.isArray(value)) continue;
+    if (typeof k !== "string") throw new TypeError("Invalid batch output");
+    json(k, depth + 1);
+    json(value[k], depth + 1);
+  }
+}
+function decode(text, max) {
+  if (text.length > max) throw new TypeError("Oversized batch output");
+  const v = JSON.parse(text);
+  json(v);
+  if (!v || Object.keys(v).sort().join() !== "blocks,stop,version" || v.version !== "governed-batch-v1" || !Array.isArray(v.blocks) || !["end_turn", "tool_use", "pause"].includes(v.stop)) throw new TypeError("Invalid batch output");
+  const ids = /* @__PURE__ */ new Map(), results = /* @__PURE__ */ new Set();
+  const bad = () => {
+    throw new TypeError("Invalid batch block");
+  };
+  const string = (v2) => typeof v2 === "string" && v2.length > 0 && v2.length <= 200;
+  const provider = (v2) => ["anthropic", "openai", "openrouter"].includes(v2);
+  const closed = (b, keys) => {
+    if (Object.keys(b).some((k) => !keys.includes(k))) bad();
+  };
+  for (const b of v.blocks) {
+    if (!b || typeof b !== "object" || Array.isArray(b)) bad();
+    switch (b.type) {
+      case "text":
+        closed(b, ["type", "text", "origin"]);
+        if (typeof b.text !== "string" || b.origin !== void 0 && b.origin !== "harness") bad();
+        break;
+      case "reasoning":
+        closed(b, ["type", "provider", "text", "opaque"]);
+        if (!provider(b.provider) || b.text !== void 0 && typeof b.text !== "string") bad();
+        break;
+      case "tool_call":
+      case "provider_tool_call": {
+        const remote = b.type === "provider_tool_call";
+        closed(b, remote ? ["type", "id", "name", "provider", "input"] : ["type", "id", "name", "input"]);
+        if (!string(b.id) || !string(b.name) || !Object.hasOwn(b, "input") || ids.has(b.id) || remote && (!provider(b.provider) || b.name !== "web_search")) bad();
+        ids.set(b.id, remote ? `provider:${b.provider}:${b.name}` : "local");
+        break;
+      }
+      case "tool_result":
+      case "provider_tool_result": {
+        const remote = b.type === "provider_tool_result";
+        closed(b, remote ? ["type", "callId", "name", "provider", "results", "error", "opaque"] : ["type", "callId", "output", "isError"]);
+        if (!string(b.callId) || results.has(b.callId) || ids.get(b.callId) !== (remote ? `provider:${b.provider}:${b.name}` : "local")) bad();
+        results.add(b.callId);
+        if (remote) {
+          if (!provider(b.provider) || b.name !== "web_search" || !Array.isArray(b.results) || b.error !== void 0 && typeof b.error !== "string") bad();
+          for (const r of b.results) {
+            if (!r || typeof r !== "object" || Array.isArray(r)) bad();
+            closed(r, ["url", "title", "pageAge"]);
+            if (typeof r.url !== "string" || r.title !== void 0 && typeof r.title !== "string" || r.pageAge !== void 0 && typeof r.pageAge !== "string") bad();
+          }
+        } else if (!Object.hasOwn(b, "output") || b.isError !== void 0 && typeof b.isError !== "boolean") bad();
+        break;
+      }
+      default:
+        bad();
+    }
+  }
+  return v;
+}
+function encode(content, max) {
+  if (content.outcome !== "succeeded") return { outcome: content.outcome === "unusable" ? "invalid" : content.outcome === "cancelled" ? "cancelled" : "unavailable", stopReason: null };
+  const { stop, blocks } = content.output;
+  if (stop === "refusal") return { outcome: "refusal", stopReason: stop };
+  if (stop === "max_tokens" || stop === "context_window_exceeded") return { outcome: "truncated", stopReason: stop };
+  try {
+    const value = { version: "governed-batch-v1", blocks, stop };
+    json(value);
+    const text = JSON.stringify(value);
+    decode(text, max);
+    return { outcome: "success", stopReason: stop, output: { format: "json", text } };
+  } catch {
+    return { outcome: "invalid", stopReason: ["end_turn", "tool_use", "pause"].includes(stop) ? stop : null };
+  }
+}
+
+// src/index.ts
+var abortError = () => new DOMException("Batch operation interrupted", "AbortError");
+function canonical(v) {
+  if (v === null || typeof v !== "object") return JSON.stringify(v);
+  if (Array.isArray(v)) return `[${v.map(canonical).join(",")}]`;
+  return `{${Object.keys(v).sort().map((k) => JSON.stringify(k) + ":" + canonical(v[k])).join(",")}}`;
+}
+function createGovernedBatchRunner(value) {
+  for (const [key2, max] of [["runTimeoutMs", 3e5], ["maxRequestChars", 64e6], ["maxOutputChars", 1e6], ["maxBatchOutputChars", 64e6]])
+    if (!Number.isSafeInteger(value[key2]) || value[key2] < 1 || value[key2] > max) throw new TypeError("Invalid batch limits");
+  if (typeof value.onBackgroundError !== "function") throw new TypeError("Missing background observer");
+  const c = { ...value, configRevision: settlementIdentifier(value.configRevision), clients: { ...value.clients } };
+  const key = (v) => ({ scope: settlementScope(v.scope), key: settlementIdentifier(v.key) });
+  function config(r) {
+    if (r.input.configRevision !== c.configRevision) throw new ExecutionConflictError();
+  }
+  function client(r) {
+    config(r);
+    const v = c.clients[r.input.items[0].execution.model.provider];
+    if (!v || v.dispatchPolicy !== "single" || typeof v.validate !== "function") throw new TypeError("Single-dispatch batch client required");
+    return v;
+  }
+  async function lookup(k) {
+    const raw = await c.batches.get(k.scope, k.key);
+    if (!raw) return null;
+    const r = normalizeBatchRecord(raw);
+    if (!equalExecution(r.input.scope, k.scope) || r.input.key !== k.key) throw new ExecutionConflictError();
+    config(r);
+    return r;
+  }
+  async function receipts(k) {
+    const all = [];
+    for (let afterOrdinal = 0; afterOrdinal < 512; ) {
+      const page = await c.accounting.list(k.scope, k.key, { afterOrdinal, limit: 100 });
+      all.push(...page);
+      if (page.length < 100) break;
+      afterOrdinal = page.at(-1).accountingOrdinal;
+    }
+    return all;
+  }
+  async function read(value2) {
+    const k = key(value2), record = await lookup(k);
+    if (!record) return null;
+    const financial = await c.accounting.get(k.scope, k.key), rows = await receipts(k), items = [];
+    const incompleteBlock = Object.values(normalizeBudgetCaps(record.input.items[0].execution.governance.caps)).some((cap) => cap.onExceeded === "block") && rows.length !== record.input.items.length;
+    const block = rows.some((r) => r.decisions.some((d) => d.exceeded && d.onExceeded === "block"));
+    let chars = 0;
+    for (const member of record.input.items) {
+      const e = member.execution, receipt = rows.find((r) => r.itemId === member.id);
+      if (receipt && (receipt.batchId !== record.input.id || receipt.callId !== e.callId || receipt.settlementId !== e.settlementId)) throw new ExecutionConflictError();
+      let saved;
+      try {
+        saved = await c.results.get(k.scope, e.callId);
+      } catch (err) {
+        if (!(err instanceof ExecutionResultPolicyError)) throw err;
+      }
+      if (saved && !equalExecution(saved.binding, binding(e))) throw new ExecutionConflictError();
+      let result = saved?.state === "available" && receipt && saved.result ? saved.result : unavailable(), output;
+      if (result.outcome === "success") {
+        try {
+          if (result.output.format !== "json") throw new TypeError();
+          output = decode(result.output.text, c.maxOutputChars);
+          if (output.stop !== result.stopReason) throw new TypeError();
+          chars += result.output.text.length;
+          if (chars > c.maxBatchOutputChars) throw new TypeError();
+        } catch {
+          result = unavailable();
+          output = void 0;
+        }
+        if (incompleteBlock) {
+          result = unavailable();
+          output = void 0;
+        } else if (block) {
+          result = { outcome: "blocked", stopReason: result.stopReason };
+          output = void 0;
+        }
+      }
+      items.push({ id: member.id, state: saved?.state ?? "unavailable", result, ...receipt ? { receipt } : {}, ...output ? { output } : {} });
+    }
+    return { record, financial, items };
+  }
+  async function required(k) {
+    const view = await read(k);
+    if (!view) throw new ExecutionStateError();
+    return view;
+  }
+  async function repair(k, row) {
+    const request = batchUsageSettlement(row);
+    if (!request) return false;
+    await c.settlements.settleGoverned(request);
+    const adopted = await c.usage.recordSettlement(k.scope, k.key, row.input.id);
+    if (adopted.status === "pending") return false;
+    return (await c.accounting.record(k.scope, k.key, row.input.id)).status !== "pending";
+  }
+  async function reconcile(value2, query) {
+    const k = key(value2), record = await lookup(k);
+    if (!record) return null;
+    const rows = await c.usage.list(k.scope, k.key, batchUsageQuery(query));
+    let repaired = 0, pending = 0;
+    for (const row of rows) {
+      try {
+        if (await repair(k, row)) repaired++;
+        else pending++;
+      } catch {
+        pending++;
+      }
+    }
+    return { scanned: rows.length, repaired, pending, ...rows.length ? { afterId: rows.at(-1).input.id } : {} };
+  }
+  function bounded(k, external, work) {
+    const controller = new AbortController();
+    let stage = "lookup", interrupted = false;
+    let deadlineTimer;
+    const abort = () => controller.abort();
+    const timer = setTimeout(abort, c.runTimeoutMs);
+    const rejected = new Promise((_, reject) => controller.signal.addEventListener("abort", () => {
+      interrupted = true;
+      reject(abortError());
+    }, { once: true }));
+    external?.addEventListener("abort", abort, { once: true });
+    if (external?.aborted) abort();
+    const check = () => {
+      if (controller.signal.aborted) throw abortError();
+    };
+    const active = work(controller.signal, check, (v) => {
+      stage = v;
+    }, (at) => {
+      deadlineTimer = setTimeout(abort, Math.max(1, Date.parse(at) - Date.now()));
+    });
+    void active.catch(() => {
+      if (interrupted) try {
+        void Promise.resolve(c.onBackgroundError({ ...structuredClone(k), stage })).catch(() => {
+        });
+      } catch {
+      }
+    });
+    return Promise.race([active, rejected]).finally(() => {
+      clearTimeout(timer);
+      clearTimeout(deadlineTimer);
+      external?.removeEventListener("abort", abort);
+    });
+  }
+  function submit(value2) {
+    const input = normalizeBatchSubmission(value2.input), k = key(input), load = value2.loadItems, rationale = value2.rationale;
+    if (input.configRevision !== c.configRevision || typeof load !== "function" || typeof rationale !== "string" || rationale.length > 1e3 || input.items.some((i) => !/^[A-Za-z0-9_-]{1,64}$/.test(i.id))) throw new TypeError("Invalid batch submission");
+    return bounded(k, value2.signal, async (signal, check, stage, armDeadline) => {
+      check();
+      const old = await lookup(k);
+      check();
+      if (old) {
+        if (!equalExecution(old.input, input)) throw new ExecutionConflictError();
+        return required(k);
+      }
+      const active = () => {
+        check();
+        if (Date.now() >= Date.parse(input.submitDeadlineAt)) throw abortError();
+      };
+      active();
+      armDeadline(input.submitDeadlineAt);
+      const transport = c.clients[input.items[0].execution.model.provider];
+      if (!transport || transport.dispatchPolicy !== "single") throw new TypeError("Single-dispatch batch client required");
+      for (const { execution: e } of input.items) {
+        const blocked = Object.entries(e.governance.caps).filter(([, cap]) => cap.onExceeded === "block");
+        const totals = blocked.some(([name]) => name !== "perTurnUsd") ? normalizeSpendTotals(await c.spend.peek({ scope: k.scope, sessionId: e.sessionId, at: e.occurredAt })) : { sessionUsd: 0, tenantDayUsd: 0 };
+        active();
+        for (const [name, cap] of blocked) {
+          const spent = name === "perTurnUsd" ? 0 : name === "perSessionUsd" ? totals.sessionUsd : totals.tenantDayUsd;
+          if (spent > cap.usd) throw new BudgetExceededError(name, cap.usd, spent);
+        }
+      }
+      stage("claim");
+      const claim = await c.batches.claim(input);
+      active();
+      if (claim.status !== "claimed") return required(k);
+      try {
+        stage("reservation");
+        for (const { execution: e } of input.items) {
+          const p = await c.results.prepare(binding(e));
+          active();
+          if (p.state !== "pending" || !equalExecution(p.binding, binding(e))) throw new ExecutionStateError();
+        }
+        stage("audit");
+        for (const { execution: e } of input.items) {
+          const correlation = { scope: k.scope, at: e.occurredAt, sessionId: e.sessionId, operationId: e.operationId, attemptId: e.attemptId, callId: e.callId };
+          try {
+            await c.audit.routing({ ...correlation, ...e.intent, model: e.model, rationale, serviceTier: "batch", ...e.controls.reasoning ? { reasoning: e.controls.reasoning.effort } : {}, ...e.controls.cache ? { cacheTtl: e.controls.cache.ttl } : {} });
+          } catch (err) {
+            throw new AuditSinkError("routing", err);
+          }
+          active();
+          try {
+            await c.audit.access({ ...correlation, tool: "governed_batch_input", action: "read", resource: e.inputRevision });
+          } catch (err) {
+            throw new AuditSinkError("access", err);
+          }
+          active();
+        }
+        stage("input");
+        const items = structuredClone(await load());
+        active();
+        if (!Array.isArray(items) || items.length !== input.items.length || JSON.stringify(items).length > c.maxRequestChars) throw new ExecutionConflictError();
+        for (let n = 0; n < items.length; n++) {
+          const item = items[n], member = input.items[n], r = item.request, e = member.execution;
+          const controls = { maxTokens: r.maxTokens, ...r.temperature !== void 0 ? { temperature: r.temperature } : {}, ...r.reasoning !== void 0 ? { reasoning: r.reasoning } : {}, ...r.cache !== void 0 ? { cache: r.cache } : {} };
+          if (item.id !== member.id || !equalExecution(r.model, e.model) || r.serviceTier !== "batch" || !equalExecution(controls, e.controls)) throw new ExecutionConflictError();
+        }
+        transport.validate(structuredClone(items));
+        active();
+        for (const { execution: e } of input.items) {
+          const p = await c.results.get(k.scope, e.callId);
+          active();
+          if (p?.state !== "pending" || !equalExecution(p.binding, binding(e))) throw new ExecutionStateError();
+        }
+        stage("dispatch");
+        const dispatched = await c.batches.beginDispatch(claim.fence);
+        active();
+        if (!dispatched.dispatch) return required(k);
+        let accepted = false;
+        stage("submission");
+        for await (const event of transport.submitEvidence(items, { signal })) {
+          if (event.type === "accepted") {
+            await c.batches.accept(claim.fence, event.handle);
+            accepted = true;
+          } else if (event.type === "input_file") {
+            active();
+            await c.onInputFile?.({ ...structuredClone(k), fileId: settlementIdentifier(event.fileId) });
+            active();
+          } else throw new ExecutionStateError();
+        }
+        if (!accepted) throw new ExecutionStateError();
+        return required(k);
+      } catch (err) {
+        try {
+          await c.batches.markUncertain(claim.fence);
+        } catch {
+        }
+        throw err;
+      }
+    });
+  }
+  function collect(value2, opts = {}) {
+    const k = key(value2);
+    return bounded(k, opts.signal, async (signal, check, stage) => {
+      check();
+      const record = await lookup(k);
+      check();
+      if (!record) throw new ExecutionStateError();
+      if (!record.handle) return { eof: false, reconciliationRequired: true, view: await required(k) };
+      const transport = client(record);
+      stage("status");
+      const progress = await transport.status(record.handle, { signal });
+      check();
+      if (!["done", "failed", "expired", "cancelled"].includes(progress.status)) return { eof: false, reconciliationRequired: false, view: await required(k) };
+      const expected = record.input.items.map((i) => i.id), seen = /* @__PURE__ */ new Set(), outputs = /* @__PURE__ */ new Map();
+      let failed = false, eof = false, chars = 0;
+      stage("evidence");
+      try {
+        for await (const raw of transport.resultsEvidence(record.handle, expected, { signal })) {
+          if (!expected.includes(raw.id) || seen.has(raw.id)) throw new ExecutionConflictError();
+          seen.add(raw.id);
+          const normalized = normalizeBatchUsage({ id: "observation", itemId: raw.id, handle: record.handle, evidence: raw.evidence, outcome: raw.content.outcome, ...raw.providerRequestId === void 0 ? {} : { providerRequestId: raw.providerRequestId } });
+          normalized.id = createHash("sha256").update(canonical(normalized)).digest("hex");
+          const itemId = normalized.itemId;
+          let result;
+          try {
+            result = encode(structuredClone(raw.content), c.maxOutputChars);
+          } catch {
+            result = { outcome: "invalid", stopReason: null };
+          }
+          let accounted = false;
+          try {
+            const row = await c.usage.append(k.scope, k.key, normalized);
+            accounted = await repair(k, row);
+            if (!accounted) failed = true;
+          } catch {
+            failed = true;
+          }
+          try {
+            const size = result.outcome === "success" ? result.output.text.length : 0;
+            chars += size;
+            if (chars > c.maxBatchOutputChars) {
+              failed = true;
+            } else if (accounted) outputs.set(itemId, result);
+          } catch {
+            failed = true;
+          }
+          check();
+        }
+        check();
+        eof = seen.size === expected.length;
+        if (!eof) failed = true;
+      } catch {
+        failed = true;
+      }
+      if (eof) {
+        stage("results");
+        for (const member of record.input.items) {
+          check();
+          const result = outputs.get(member.id);
+          if (!result) continue;
+          try {
+            const p = await c.results.get(k.scope, member.execution.callId);
+            check();
+            if (!p || !equalExecution(p.binding, binding(member.execution))) throw new ExecutionConflictError();
+            if (p.state === "pending" || p.state === "available") await c.results.put(k.scope, member.execution.callId, result);
+          } catch {
+            failed = true;
+          }
+        }
+      }
+      check();
+      return { eof, reconciliationRequired: failed, view: await required(k) };
+    });
+  }
+  return { submit, collect, read, reconcile };
+}
+export {
+  createGovernedBatchRunner
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/output.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\nimport { AuditSinkError, BudgetExceededError, equalExecution, ExecutionConflictError, ExecutionResultPolicyError, ExecutionStateError, normalizeSpendTotals, normalizeBudgetCaps, settlementIdentifier, settlementScope, type ExecutionResult, type Scope } from '@alma-harness/core';\nimport { batchUsageQuery, batchUsageSettlement, normalizeBatchRecord, normalizeBatchSubmission, normalizeBatchUsage, type BatchFinancialReceipt, type BatchSubmissionRecord, type BatchUsageQuery, type BatchUsageRecord } from '@alma-harness/execution';\nimport { binding, decode, encode, unavailable } from './output';\nimport type { BatchKey, GovernedBatchCollection, GovernedBatchConfig, GovernedBatchItemView, GovernedBatchSubmit, GovernedBatchView } from './types';\nexport type * from './types';\nconst abortError=()=>new DOMException('Batch operation interrupted','AbortError');\nfunction canonical(v:unknown):string {if(v===null||typeof v!=='object')return JSON.stringify(v);if(Array.isArray(v))return `[${v.map(canonical).join(',')}]`;return `{${Object.keys(v).sort().map(k=>JSON.stringify(k)+':'+canonical((v as Record<string,unknown>)[k])).join(',')}}`;}\nexport function createGovernedBatchRunner(value:GovernedBatchConfig) {\n  for(const [key,max] of [['runTimeoutMs',300_000],['maxRequestChars',64_000_000],['maxOutputChars',1_000_000],['maxBatchOutputChars',64_000_000]] as const)\n    if(!Number.isSafeInteger(value[key])||value[key]<1||value[key]>max)throw new TypeError('Invalid batch limits');\n  if(typeof value.onBackgroundError!=='function')throw new TypeError('Missing background observer');\n  const c={...value,configRevision:settlementIdentifier(value.configRevision),clients:{...value.clients}};\n  const key=(v:BatchKey):BatchKey=>({scope:settlementScope(v.scope),key:settlementIdentifier(v.key)});\n  function config(r:BatchSubmissionRecord):void {if(r.input.configRevision!==c.configRevision)throw new ExecutionConflictError();}\n  function client(r:BatchSubmissionRecord){config(r);const v=c.clients[r.input.items[0]!.execution.model.provider];if(!v||v.dispatchPolicy!=='single'||typeof v.validate!=='function')throw new TypeError('Single-dispatch batch client required');return v;}\n  async function lookup(k:BatchKey){const raw=await c.batches.get(k.scope,k.key);if(!raw)return null;const r=normalizeBatchRecord(raw);if(!equalExecution(r.input.scope,k.scope)||r.input.key!==k.key)throw new ExecutionConflictError();config(r);return r;}\n  async function receipts(k:BatchKey){const all:BatchFinancialReceipt[]=[];for(let afterOrdinal=0;afterOrdinal<512;){const page=await c.accounting.list(k.scope,k.key,{afterOrdinal,limit:100});all.push(...page);if(page.length<100)break;afterOrdinal=page.at(-1)!.accountingOrdinal;}return all;}\n  async function read(value:BatchKey):Promise<GovernedBatchView|null> {\n    const k=key(value),record=await lookup(k);if(!record)return null;\n    const financial=await c.accounting.get(k.scope,k.key),rows=await receipts(k),items:GovernedBatchItemView[]=[];\n    const incompleteBlock=Object.values(normalizeBudgetCaps(record.input.items[0]!.execution.governance!.caps)).some(cap=>cap.onExceeded==='block')&&rows.length!==record.input.items.length;\n    const block=rows.some(r=>r.decisions.some(d=>d.exceeded&&d.onExceeded==='block'));let chars=0;\n    for(const member of record.input.items){const e=member.execution,receipt=rows.find(r=>r.itemId===member.id);\n      if(receipt&&(receipt.batchId!==record.input.id||receipt.callId!==e.callId||receipt.settlementId!==e.settlementId))throw new ExecutionConflictError();\n      let saved;try{saved=await c.results.get(k.scope,e.callId);}catch(err){if(!(err instanceof ExecutionResultPolicyError))throw err;}\n      if(saved&&!equalExecution(saved.binding,binding(e)))throw new ExecutionConflictError();\n      let result=saved?.state==='available'&&receipt&&saved.result?saved.result:unavailable(),output;\n      if(result.outcome==='success'){\n        try{if(result.output.format!=='json')throw new TypeError();output=decode(result.output.text,c.maxOutputChars);if(output.stop!==result.stopReason)throw new TypeError();chars+=result.output.text.length;if(chars>c.maxBatchOutputChars)throw new TypeError();}\n        catch{result=unavailable();output=undefined;}\n        if(incompleteBlock){result=unavailable();output=undefined;}else if(block){result={outcome:'blocked',stopReason:result.stopReason};output=undefined;}\n      }\n      items.push({id:member.id,state:saved?.state??'unavailable',result,...(receipt?{receipt}:{}),...(output?{output}:{})});\n    }\n    return {record,financial,items};\n  }\n  async function required(k:BatchKey){const view=await read(k);if(!view)throw new ExecutionStateError();return view;}\n  async function repair(k:BatchKey,row:BatchUsageRecord):Promise<boolean>{\n    const request=batchUsageSettlement(row);if(!request)return false;\n    await c.settlements.settleGoverned(request);\n    const adopted=await c.usage.recordSettlement(k.scope,k.key,row.input.id);if(adopted.status==='pending')return false;\n    return (await c.accounting.record(k.scope,k.key,row.input.id)).status!=='pending';\n  }\n  async function reconcile(value:BatchKey,query?:BatchUsageQuery){const k=key(value),record=await lookup(k);if(!record)return null;\n    const rows=await c.usage.list(k.scope,k.key,batchUsageQuery(query));let repaired=0,pending=0;\n    for(const row of rows){try{if(await repair(k,row))repaired++;else pending++;}catch{pending++;}}\n    return {scanned:rows.length,repaired,pending,...(rows.length?{afterId:rows.at(-1)!.input.id}:{})};\n  }\n  function bounded<T>(k:BatchKey,external:AbortSignal|undefined,work:(signal:AbortSignal,check:()=>void,stage:(v:string)=>void,deadline:(at:string)=>void)=>Promise<T>):Promise<T>{\n    const controller=new AbortController();let stage='lookup',interrupted=false;let deadlineTimer:ReturnType<typeof setTimeout>|undefined;\n    const abort=()=>controller.abort();const timer=setTimeout(abort,c.runTimeoutMs);\n    const rejected=new Promise<never>((_,reject)=>controller.signal.addEventListener('abort',()=>{interrupted=true;reject(abortError());},{once:true}));\n    external?.addEventListener('abort',abort,{once:true});if(external?.aborted)abort();\n    const check=()=>{if(controller.signal.aborted)throw abortError();};\n    const active=work(controller.signal,check,v=>{stage=v;},at=>{deadlineTimer=setTimeout(abort,Math.max(1,Date.parse(at)-Date.now()));});\n    void active.catch(()=>{if(interrupted)try{void Promise.resolve(c.onBackgroundError({...structuredClone(k),stage})).catch(()=>{});}catch{/* Monitoring cannot create an unhandled rejection. */}});\n    return Promise.race([active,rejected]).finally(()=>{clearTimeout(timer);clearTimeout(deadlineTimer);external?.removeEventListener('abort',abort);});\n  }\n  function submit(value:GovernedBatchSubmit):Promise<GovernedBatchView>{\n    const input=normalizeBatchSubmission(value.input),k=key(input),load=value.loadItems,rationale=value.rationale;\n    if(input.configRevision!==c.configRevision||typeof load!=='function'||typeof rationale!=='string'||rationale.length>1000||input.items.some(i=>! /^[A-Za-z0-9_-]{1,64}$/.test(i.id)))throw new TypeError('Invalid batch submission');\n    return bounded(k,value.signal,async(signal,check,stage,armDeadline)=>{\n      check();const old=await lookup(k);check();if(old){if(!equalExecution(old.input,input))throw new ExecutionConflictError();return required(k);}\n      const active=()=>{check();if(Date.now()>=Date.parse(input.submitDeadlineAt))throw abortError();};active();armDeadline(input.submitDeadlineAt);\n      const transport=c.clients[input.items[0]!.execution.model.provider];if(!transport||transport.dispatchPolicy!=='single')throw new TypeError('Single-dispatch batch client required');\n      // Each item's original UTC day may differ, so check each relevant projection.\n      for(const {execution:e} of input.items){const blocked=Object.entries(e.governance!.caps).filter(([,cap])=>cap.onExceeded==='block');\n        const totals=blocked.some(([name])=>name!=='perTurnUsd')?normalizeSpendTotals(await c.spend.peek({scope:k.scope,sessionId:e.sessionId,at:e.occurredAt})):{sessionUsd:0,tenantDayUsd:0};active();\n        for(const [name,cap] of blocked){const spent=name==='perTurnUsd'?0:name==='perSessionUsd'?totals.sessionUsd:totals.tenantDayUsd;if(spent>cap.usd)throw new BudgetExceededError(name as 'perTurnUsd',cap.usd,spent);}}\n      stage('claim');const claim=await c.batches.claim(input);active();if(claim.status!=='claimed')return required(k);\n      try{\n        stage('reservation');for(const {execution:e} of input.items){const p=await c.results.prepare(binding(e));active();if(p.state!=='pending'||!equalExecution(p.binding,binding(e)))throw new ExecutionStateError();}\n        stage('audit');for(const {execution:e} of input.items){const correlation={scope:k.scope,at:e.occurredAt,sessionId:e.sessionId,operationId:e.operationId,attemptId:e.attemptId,callId:e.callId};\n          try{await c.audit.routing({...correlation,...e.intent,model:e.model,rationale,serviceTier:'batch',...(e.controls.reasoning?{reasoning:e.controls.reasoning.effort}:{}),...(e.controls.cache?{cacheTtl:e.controls.cache.ttl}:{})});}catch(err){throw new AuditSinkError('routing',err);}active();\n          try{await c.audit.access({...correlation,tool:'governed_batch_input',action:'read',resource:e.inputRevision});}catch(err){throw new AuditSinkError('access',err);}active();}\n        stage('input');const items=structuredClone(await load());active();\n        if(!Array.isArray(items)||items.length!==input.items.length||JSON.stringify(items).length>c.maxRequestChars)throw new ExecutionConflictError();\n        for(let n=0;n<items.length;n++){const item=items[n]!,member=input.items[n]!,r=item.request,e=member.execution;\n          const controls={maxTokens:r.maxTokens,...(r.temperature!==undefined?{temperature:r.temperature}:{}),...(r.reasoning!==undefined?{reasoning:r.reasoning}:{}),...(r.cache!==undefined?{cache:r.cache}:{})};\n          if(item.id!==member.id||!equalExecution(r.model,e.model)||r.serviceTier!=='batch'||!equalExecution(controls,e.controls))throw new ExecutionConflictError();}\n        transport.validate(structuredClone(items));active();\n        for(const {execution:e} of input.items){const p=await c.results.get(k.scope,e.callId);active();if(p?.state!=='pending'||!equalExecution(p.binding,binding(e)))throw new ExecutionStateError();}\n        stage('dispatch');const dispatched=await c.batches.beginDispatch(claim.fence);active();if(!dispatched.dispatch)return required(k);\n        let accepted=false;stage('submission');\n        for await(const event of transport.submitEvidence(items,{signal})){\n          if(event.type==='accepted'){await c.batches.accept(claim.fence,event.handle);accepted=true;}\n          else if(event.type==='input_file'){active();await c.onInputFile?.({...structuredClone(k),fileId:settlementIdentifier(event.fileId)});active();}\n          else throw new ExecutionStateError();\n        }\n        if(!accepted)throw new ExecutionStateError();return required(k);\n      }catch(err){try{await c.batches.markUncertain(claim.fence);}catch{/* Original record never grants dispatch again. */}throw err;}\n    });\n  }\n  function collect(value:BatchKey,opts:{signal?:AbortSignal}={}):Promise<GovernedBatchCollection>{\n    const k=key(value);\n    return bounded(k,opts.signal,async(signal,check,stage)=>{\n      check();const record=await lookup(k);check();if(!record)throw new ExecutionStateError();\n      if(!record.handle)return {eof:false,reconciliationRequired:true,view:await required(k)};\n      const transport=client(record);stage('status');const progress=await transport.status(record.handle,{signal});check();\n      if(!['done','failed','expired','cancelled'].includes(progress.status))return {eof:false,reconciliationRequired:false,view:await required(k)};\n      const expected=record.input.items.map(i=>i.id),seen=new Set<string>(),outputs=new Map<string,ExecutionResult>();let failed=false,eof=false,chars=0;\n      stage('evidence');try{\n        for await(const raw of transport.resultsEvidence(record.handle,expected,{signal})){\n          // Persist a yielded observation even when cancellation races its arrival.\n          if(!expected.includes(raw.id)||seen.has(raw.id))throw new ExecutionConflictError();seen.add(raw.id);\n          const normalized=normalizeBatchUsage({id:'observation',itemId:raw.id,handle:record.handle,evidence:raw.evidence,outcome:raw.content.outcome,...(raw.providerRequestId===undefined?{}:{providerRequestId:raw.providerRequestId})});\n          normalized.id=createHash('sha256').update(canonical(normalized)).digest('hex');\n          const itemId=normalized.itemId;let result:ExecutionResult;try{result=encode(structuredClone(raw.content),c.maxOutputChars);}catch{result={outcome:'invalid',stopReason:null};}\n          let accounted=false;try{const row=await c.usage.append(k.scope,k.key,normalized);accounted=await repair(k,row);if(!accounted)failed=true;}catch{failed=true;}\n          // Content failure cannot terminate the financial drain.\n          try{const size=result.outcome==='success'?result.output.text.length:0;chars+=size;\n            if(chars>c.maxBatchOutputChars){failed=true;}else if(accounted)outputs.set(itemId,result);\n          }catch{failed=true;}\n          check();\n        }\n        check();eof=seen.size===expected.length;if(!eof)failed=true;\n      }catch{failed=true;}\n      if(eof){stage('results');for(const member of record.input.items){check();const result=outputs.get(member.id);if(!result)continue;\n        try{const p=await c.results.get(k.scope,member.execution.callId);check();if(!p||!equalExecution(p.binding,binding(member.execution)))throw new ExecutionConflictError();\n          if(p.state==='pending'||p.state==='available')await c.results.put(k.scope,member.execution.callId,result);\n        }catch{failed=true;}\n      }}\n      check();return {eof,reconciliationRequired:failed,view:await required(k)};\n    });\n  }\n  return {submit,collect,read,reconcile};\n}\n","import type { ExecutionInput, ExecutionResult, ExecutionResultBinding } from '@alma-harness/core';\nimport type { BatchContent } from '@alma-harness/execution';\nimport type { GovernedBatchOutput } from './types';\nexport const unavailable = ():ExecutionResult => ({outcome:'unavailable',stopReason:null});\nexport const binding = (e:ExecutionInput):ExecutionResultBinding => ({scope:e.scope,callId:e.callId,sessionId:e.sessionId,sensitivity:e.intent.sensitivity,retentionMs:e.governance!.resultRetentionMs});\nfunction json(value:unknown,depth=0):void {\n  if(depth>100)throw new TypeError('Invalid batch output');\n  if(value===null||typeof value==='boolean')return;\n  if(typeof value==='string'){if(!value.isWellFormed()||value.includes('\\0'))throw new TypeError('Invalid batch output');return;}\n  if(typeof value==='number'&&Number.isFinite(value))return;\n  if(!value||typeof value!=='object'||(!Array.isArray(value)&&Object.getPrototypeOf(value)!==Object.prototype))throw new TypeError('Invalid batch output');\n  if(Array.isArray(value)&&Object.keys(value).length!==value.length)throw new TypeError('Sparse batch output');\n  for(const k of Reflect.ownKeys(value)){if(k==='length'&&Array.isArray(value))continue;if(typeof k!=='string')throw new TypeError('Invalid batch output');json(k,depth+1);json((value as Record<string,unknown>)[k],depth+1);}\n}\nexport function decode(text:string,max:number):GovernedBatchOutput {\n  if(text.length>max)throw new TypeError('Oversized batch output');const v=JSON.parse(text);json(v);\n  if(!v||Object.keys(v).sort().join()!=='blocks,stop,version'||v.version!=='governed-batch-v1'||!Array.isArray(v.blocks)||!['end_turn','tool_use','pause'].includes(v.stop))throw new TypeError('Invalid batch output');\n  const ids=new Map<string,string>(),results=new Set<string>();\n  const bad=():never=>{throw new TypeError('Invalid batch block');};\n  const string=(v:unknown):v is string=>typeof v==='string'&&v.length>0&&v.length<=200;\n  const provider=(v:unknown)=>['anthropic','openai','openrouter'].includes(v as string);\n  const closed=(b:Record<string,unknown>,keys:string[])=>{if(Object.keys(b).some(k=>!keys.includes(k)))bad();};\n  for(const b of v.blocks){\n    if(!b||typeof b!=='object'||Array.isArray(b))bad();\n    switch(b.type){\n      case 'text':closed(b,['type','text','origin']);if(typeof b.text!=='string'||(b.origin!==undefined&&b.origin!=='harness'))bad();break;\n      case 'reasoning':closed(b,['type','provider','text','opaque']);if(!provider(b.provider)||(b.text!==undefined&&typeof b.text!=='string'))bad();break;\n      case 'tool_call':case 'provider_tool_call':{\n        const remote=b.type==='provider_tool_call';closed(b,remote?['type','id','name','provider','input']:['type','id','name','input']);\n        if(!string(b.id)||!string(b.name)||!Object.hasOwn(b,'input')||ids.has(b.id)||(remote&&(!provider(b.provider)||b.name!=='web_search')))bad();\n        ids.set(b.id,remote?`provider:${b.provider}:${b.name}`:'local');break;\n      }\n      case 'tool_result':case 'provider_tool_result':{\n        const remote=b.type==='provider_tool_result';closed(b,remote?['type','callId','name','provider','results','error','opaque']:['type','callId','output','isError']);\n        if(!string(b.callId)||results.has(b.callId)||ids.get(b.callId)!==(remote?`provider:${b.provider}:${b.name}`:'local'))bad();\n        results.add(b.callId);\n        if(remote){if(!provider(b.provider)||b.name!=='web_search'||!Array.isArray(b.results)||(b.error!==undefined&&typeof b.error!=='string'))bad();\n          for(const r of b.results){if(!r||typeof r!=='object'||Array.isArray(r))bad();closed(r,['url','title','pageAge']);if(typeof r.url!=='string'||(r.title!==undefined&&typeof r.title!=='string')||(r.pageAge!==undefined&&typeof r.pageAge!=='string'))bad();}\n        }else if(!Object.hasOwn(b,'output')||(b.isError!==undefined&&typeof b.isError!=='boolean'))bad();break;\n      }\n      default:bad();\n    }\n  }\n  return v;\n}\nexport function encode(content:BatchContent,max:number):ExecutionResult {\n  if(content.outcome!=='succeeded')return {outcome:content.outcome==='unusable'?'invalid':content.outcome==='cancelled'?'cancelled':'unavailable',stopReason:null};\n  const {stop,blocks}=content.output;\n  if(stop==='refusal')return {outcome:'refusal',stopReason:stop};\n  if(stop==='max_tokens'||stop==='context_window_exceeded')return {outcome:'truncated',stopReason:stop};\n  try{const value={version:'governed-batch-v1',blocks,stop};json(value);const text=JSON.stringify(value);decode(text,max);return {outcome:'success',stopReason:stop,output:{format:'json',text}};}\n  catch{return {outcome:'invalid',stopReason:['end_turn','tool_use','pause'].includes(stop)?stop:null};}\n}\n"],"mappings":"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","names":["v","key","value"]}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@alma-harness/batch",
+  "version": "0.6.0",
+  "description": "Governed single-dispatch batch execution for Alma.",
+  "license": "Apache-2.0",
+  "type": "module",
+  "engines": {
+    "node": ">=22"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/FabioFernandesCarneiro/alma.git",
+    "directory": "packages/batch"
+  },
+  "peerDependencies": {
+    "@alma-harness/execution": "^0.6.0",
+    "@alma-harness/core": "^0.6.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.1.0",
+    "typescript": "^5.9.2",
+    "vitest": "^3.2.4",
+    "pg": "^8.16.3",
+    "@types/pg": "^8.15.4",
+    "@alma-harness/core": "^0.6.0",
+    "@alma-harness/execution": "^0.6.0",
+    "@alma-harness/memory": "^0.6.0",
+    "@alma-harness/postgres": "^0.6.0",
+    "@alma-harness/postgres-execution": "^0.6.0"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "build": "tsup"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts"
+}