@axlsdk/axl 0.24.0 → 0.24.1

package/dist/index.d.cts

@@ -158,8 +158,9 @@ declare function summarizeModelInput(input: ModelInput): string;
  *
  * - `'complete'` — every operation in the scope reached a terminal state with a
  *   usable charge (including known $0).
- * - `'incomplete'` — at least one operation settled without a usable charge;
- *   `knownCost` is a lower bound and `reasons` says why.
+ * - `'incomplete'` — at least one operation lacked a usable charge, or the
+ *   scope detected work from an incompatible loaded copy; `knownCost` is a
+ *   lower bound and `reasons` says why.
  * - `'unverified'` — reserved for READERS of artifacts that carry no
  *   accounting at all (legacy eval results). A live scope never produces it.
  */
@@ -185,9 +186,8 @@ type AccountingReason =
 /** An external operation finished without calling `report.setCost()`. */
  | 'external_unreported'
 /**
- * A consumer ran work with no accounting scope available (e.g. `@axlsdk/eval`
- * driving a runtime that predates `trackOutcome`). Core defines the name only
- * — no core producer emits it.
+ * A consumer ran work with no accounting scope available, or another loaded
+ * copy attempted work under a scope whose accounting protocol it cannot join.
  */
  | 'uninstrumented';
 /** The instrumented boundaries that can open an operation. */
@@ -216,7 +216,7 @@ type Accounting = {
     /** Sum of settled, usable, disjoint charges. Never includes caller aggregates. */
     knownCost: number;
     completeness: AccountingCompleteness;
-    /** Reason → count of operations carrying it. Empty object when complete. */
+    /** Reason → count of unresolved operations or coverage failures. */
     reasons: Partial<Record<AccountingReason, number>>;
     usage: AccountingUsage;
     operations: {
@@ -229,7 +229,7 @@ type Accounting = {
         total: number;
         /** Terminal with a usable cost, including a known $0. */
         settled: number;
-        /** Terminal or abandoned without a usable cost. Drives `completeness`. */
+        /** Terminal or abandoned without a usable cost. Coverage failures can also make `incomplete`. */
         unknown: number;
         /** Refused admission — never dispatched, contributes nothing anywhere. */
         denied: number;

package/dist/index.d.ts

@@ -158,8 +158,9 @@ declare function summarizeModelInput(input: ModelInput): string;
  *
  * - `'complete'` — every operation in the scope reached a terminal state with a
  *   usable charge (including known $0).
- * - `'incomplete'` — at least one operation settled without a usable charge;
- *   `knownCost` is a lower bound and `reasons` says why.
+ * - `'incomplete'` — at least one operation lacked a usable charge, or the
+ *   scope detected work from an incompatible loaded copy; `knownCost` is a
+ *   lower bound and `reasons` says why.
  * - `'unverified'` — reserved for READERS of artifacts that carry no
  *   accounting at all (legacy eval results). A live scope never produces it.
  */
@@ -185,9 +186,8 @@ type AccountingReason =
 /** An external operation finished without calling `report.setCost()`. */
  | 'external_unreported'
 /**
- * A consumer ran work with no accounting scope available (e.g. `@axlsdk/eval`
- * driving a runtime that predates `trackOutcome`). Core defines the name only
- * — no core producer emits it.
+ * A consumer ran work with no accounting scope available, or another loaded
+ * copy attempted work under a scope whose accounting protocol it cannot join.
  */
  | 'uninstrumented';
 /** The instrumented boundaries that can open an operation. */
@@ -216,7 +216,7 @@ type Accounting = {
     /** Sum of settled, usable, disjoint charges. Never includes caller aggregates. */
     knownCost: number;
     completeness: AccountingCompleteness;
-    /** Reason → count of operations carrying it. Empty object when complete. */
+    /** Reason → count of unresolved operations or coverage failures. */
     reasons: Partial<Record<AccountingReason, number>>;
     usage: AccountingUsage;
     operations: {
@@ -229,7 +229,7 @@ type Accounting = {
         total: number;
         /** Terminal with a usable cost, including a known $0. */
         settled: number;
-        /** Terminal or abandoned without a usable cost. Drives `completeness`. */
+        /** Terminal or abandoned without a usable cost. Coverage failures can also make `incomplete`. */
         unknown: number;
         /** Refused admission — never dispatched, contributes nothing anywhere. */
         denied: number;

package/dist/index.js

@@ -1,8 +1,9 @@
 import { createRequire as __axlCreateRequire } from 'node:module';
 const require = __axlCreateRequire(import.meta.url);
+const __AXL_BUILD_PATH__ = import.meta.url;
 import {
   __require
-} from "./chunk-O7Y6WXE2.js";
+} from "./chunk-PJROX3XU.js";
 
 // src/tool.ts
 import { ZodError } from "zod";
@@ -277,8 +278,62 @@ var ValidationError = class extends AxlError {
   }
 };
 
-// src/accounting.ts
+// src/shared-context.ts
 import { AsyncLocalStorage } from "async_hooks";
+import { fileURLToPath } from "url";
+var PROTOCOL = 1;
+var CONTEXT_KEY = /* @__PURE__ */ Symbol.for(`axl.accounting.context.v${PROTOCOL}`);
+var GUARD_KEY = /* @__PURE__ */ Symbol.for("axl.accounting.scopeGuard");
+function createContext() {
+  let operationCounter = 0;
+  return {
+    protocol: PROTOCOL,
+    id: /* @__PURE__ */ Symbol("axl.accounting.context.instance"),
+    accounting: new AsyncLocalStorage(),
+    dispatch: new AsyncLocalStorage(),
+    capture: new AsyncLocalStorage(),
+    correlation: new AsyncLocalStorage(),
+    turn: new AsyncLocalStorage(),
+    nextOperationId: () => `op_${++operationCounter}`
+  };
+}
+function isStorage(value) {
+  return typeof value === "object" && value !== null && typeof value.getStore === "function" && typeof value.run === "function";
+}
+function isCompatible(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const candidate = value;
+  return candidate.protocol === PROTOCOL && typeof candidate.id === "symbol" && isStorage(candidate.accounting) && isStorage(candidate.dispatch) && isStorage(candidate.capture) && isStorage(candidate.correlation) && isStorage(candidate.turn) && typeof candidate.nextOperationId === "function";
+}
+var registry = globalThis;
+var installed = registry[CONTEXT_KEY];
+var sharedContext = installed === void 0 ? registry[CONTEXT_KEY] = createContext() : isCompatible(installed) ? installed : createContext();
+var installedGuard = registry[GUARD_KEY];
+var sharedGuard = typeof installedGuard === "object" && installedGuard !== null && isStorage(installedGuard.storage) && installedGuard.warned instanceof WeakMap ? installedGuard : registry[GUARD_KEY] = {
+  storage: new AsyncLocalStorage(),
+  warned: /* @__PURE__ */ new WeakMap()
+};
+var buildPath = typeof __AXL_BUILD_PATH__ === "string" ? __AXL_BUILD_PATH__ : "<source>";
+var thisCopy = {
+  path: buildPath.startsWith("file:") ? fileURLToPath(buildPath) : buildPath,
+  version: true ? "0.24.1" : "unknown"
+};
+function warnCrossCopy(other, joined) {
+  if (other === thisCopy) return;
+  if (sharedGuard.warned.get(other)?.has(thisCopy)) return;
+  const fromThis = sharedGuard.warned.get(thisCopy) ?? /* @__PURE__ */ new WeakSet();
+  if (fromThis.has(other)) return;
+  fromThis.add(other);
+  sharedGuard.warned.set(thisCopy, fromThis);
+  try {
+    console.warn(
+      `[axl] Cross-copy accounting: ${other.path} (v${other.version}) and ${thisCopy.path} (v${thisCopy.version}). ` + (joined ? "Shared accounting, admission, and request capture context joined." : "Accounting protocols could not join; paid work is refused and the active scope is incomplete.")
+    );
+  } catch {
+  }
+}
+
+// src/accounting.ts
 var RECORD_SPEND = /* @__PURE__ */ Symbol.for("axl.accounting.recordSpend");
 var AdmissionController = class {
   /** The configured USD threshold. Admission closes at `knownSpend >= limit`. */
@@ -340,10 +395,8 @@ function emptyUsage() {
 function isUsableCost(cost) {
   return typeof cost === "number" && Number.isFinite(cost) && cost >= 0;
 }
-var operationCounter = 0;
 function nextOperationId() {
-  operationCounter += 1;
-  return `op_${operationCounter}`;
+  return sharedContext.nextOperationId();
 }
 var AccountingScope = class {
   parent;
@@ -381,6 +434,11 @@ var AccountingScope = class {
   recordDenied() {
     this.denied += 1;
   }
+  /** A foreign protocol attempted work we cannot measure. Mark every live ancestor. */
+  markUninstrumented() {
+    if (this.finalized || this.reasons.has("uninstrumented")) return;
+    this.reasons.set("uninstrumented", 1);
+  }
   /** An already-open operation refused at the dispatch check: retract it. */
   recordRetracted(op) {
     this.seen.add(op.id);
@@ -433,7 +491,7 @@ var AccountingScope = class {
       version: 1,
       currency: "USD",
       knownCost: this.knownCost,
-      completeness: this.unknown > 0 ? "incomplete" : "complete",
+      completeness: this.reasons.size > 0 ? "incomplete" : "complete",
       reasons: Object.fromEntries(this.reasons),
       usage: { ...this.usage },
       operations: {
@@ -448,8 +506,8 @@ var AccountingScope = class {
     };
   }
 };
-var accountingStorage = new AsyncLocalStorage();
-var dispatchAdmissionStorage = new AsyncLocalStorage();
+var accountingStorage = sharedContext.accounting;
+var dispatchAdmissionStorage = sharedContext.dispatch;
 function currentDispatchAdmission() {
   return dispatchAdmissionStorage.getStore();
 }
@@ -510,6 +568,17 @@ function admissionDenied(controller, descriptor) {
   });
 }
 function openOperation(descriptor) {
+  const inheritedGuard = sharedGuard.storage.getStore();
+  const guard = inheritedGuard && (inheritedGuard.isActive?.() ?? true) ? inheritedGuard : void 0;
+  if (guard && guard.contextId !== sharedContext.id) {
+    guard.markUninstrumented();
+    warnCrossCopy(guard.owner, false);
+    throw new AxlError(
+      "INCOMPATIBLE_ACCOUNTING_SCOPE",
+      "The active @axlsdk/axl accounting scope uses an incompatible loaded copy; paid work was refused before dispatch."
+    );
+  }
+  if (guard) warnCrossCopy(guard.owner, true);
   const scope = accountingStorage.getStore();
   if (!scope || scope.isFinalized) return void 0;
   const denier = denyingController(scope);
@@ -599,8 +668,45 @@ async function runInAccountingScope(options, fn) {
     purpose: options.purpose ?? parent?.purpose ?? "generation",
     admission: options.admission
   });
+  const inheritedGuard = sharedGuard.storage.getStore();
+  const enclosingGuard = inheritedGuard && (inheritedGuard.isActive?.() ?? true) ? inheritedGuard : void 0;
+  if (enclosingGuard)
+    warnCrossCopy(enclosingGuard.owner, enclosingGuard.contextId === sharedContext.id);
+  if (enclosingGuard && enclosingGuard.contextId !== sharedContext.id) {
+    enclosingGuard.markUninstrumented();
+    scope.markUninstrumented();
+    scope.finalize();
+    return {
+      outcome: {
+        status: "rejected",
+        error: new AxlError(
+          "INCOMPATIBLE_ACCOUNTING_SCOPE",
+          "The active @axlsdk/axl accounting scope uses an incompatible loaded copy; paid work was refused before dispatch."
+        )
+      },
+      accounting: scope.toAccounting()
+    };
+  }
+  const markUninstrumented = () => {
+    let current = scope;
+    while (current) {
+      if (!current.isFinalized) current.markUninstrumented();
+      current = current.parent;
+    }
+  };
+  const isActive = () => {
+    let current = scope;
+    while (current) {
+      if (!current.isFinalized) return true;
+      current = current.parent;
+    }
+    return false;
+  };
   try {
-    const value = await accountingStorage.run(scope, fn);
+    const value = await sharedGuard.storage.run(
+      { contextId: sharedContext.id, owner: thisCopy, markUninstrumented, isActive },
+      () => accountingStorage.run(scope, fn)
+    );
     scope.finalize();
     return { outcome: { status: "fulfilled", value }, accounting: scope.toAccounting() };
   } catch (error) {
@@ -1034,7 +1140,7 @@ function tool(config) {
       } catch (err) {
         if (options?.signal?.aborted) options.signal.throwIfAborted();
         if (isAbortError(err)) throw err;
-        if (err instanceof AdmissionDeniedError) throw err;
+        if (isAdmissionDeniedError(err)) throw err;
         rethrowEventStreamOverflow(err);
         lastError = err instanceof Error ? err : new Error(String(err));
         if (attempt === maxAttempts) break;
@@ -8788,7 +8894,7 @@ var TranscriptionProviderRegistry = class {
 };
 
 // src/context.ts
-import { AsyncLocalStorage as AsyncLocalStorage3 } from "async_hooks";
+import { AsyncLocalStorage as AsyncLocalStorage2 } from "async_hooks";
 import { randomUUID } from "crypto";
 import { z, ZodError as ZodError2 } from "zod";
 
@@ -10973,7 +11079,6 @@ function warnDiagnosticOnce(key, message, silent, docs = DOCS_URL) {
 var warnSchemaDiagnosticOnce = warnDiagnosticOnce;
 
 // src/diagnostics/capture.ts
-import { AsyncLocalStorage as AsyncLocalStorage2 } from "async_hooks";
 var DEFAULT_MAX_RECORD_BYTES = 256 * 1024;
 var DEFAULT_MAX_RUN_BYTES = 16 * 1024 * 1024;
 var DEFAULT_MAX_QUEUE_BYTES = 1024 * 1024;
@@ -11234,8 +11339,8 @@ function positive(value, fallback) {
 function describe(error) {
   return error instanceof Error ? error.message : String(error);
 }
-var channelStorage = new AsyncLocalStorage2();
-var correlationStorage = new AsyncLocalStorage2();
+var channelStorage = sharedContext.capture;
+var correlationStorage = sharedContext.correlation;
 function currentCaptureChannel() {
   return channelStorage.getStore();
 }
@@ -11251,7 +11356,7 @@ function runWithCaptureCorrelation(correlation, fn) {
   const merged = { ...correlationStorage.getStore(), ...correlation };
   return correlationStorage.run(merged, fn);
 }
-var turnStorage = new AsyncLocalStorage2();
+var turnStorage = sharedContext.turn;
 function currentCaptureTurn() {
   return turnStorage.getStore()?.current;
 }
@@ -12120,7 +12225,7 @@ async function executeAcceptedTool(options) {
     }
   } catch (error) {
     rethrowEventStreamOverflow(error);
-    if (error instanceof AdmissionDeniedError) throw error;
+    if (isAdmissionDeniedError(error)) throw error;
     const abort = cancellationError(signal, error);
     if (abort !== void 0) return cancellation("handler", abort);
     return failed("handler", error, { attempts });
@@ -12293,9 +12398,9 @@ function recordToolSpanOutcome(span, outcome) {
 }
 
 // src/context.ts
-var signalStorage = new AsyncLocalStorage3();
-var hardSignalStorage = new AsyncLocalStorage3();
-var timeoutTrackerStorage = new AsyncLocalStorage3();
+var signalStorage = new AsyncLocalStorage2();
+var hardSignalStorage = new AsyncLocalStorage2();
+var timeoutTrackerStorage = new AsyncLocalStorage2();
 var MAX_TIMER_DELAY_MS = 2147483647;
 function composeAbortSignals(...signals) {
   const active = signals.filter((signal) => signal !== void 0);
@@ -12400,7 +12505,7 @@ function parseHumanDecision(value) {
   }
   return invalid3();
 }
-var askStorage = new AsyncLocalStorage3();
+var askStorage = new AsyncLocalStorage2();
 var inlineSchemaCache = /* @__PURE__ */ new WeakMap();
 function zodToJsonSchema(schema) {
   const cached = inlineSchemaCache.get(schema);
@@ -16235,7 +16340,7 @@ ${summaryResponse.content}`
       try {
         result = await (transcriptionOperation ? transcriptionOperation.run(() => resolved.provider.transcribe(providerRequest)) : resolved.provider.transcribe(providerRequest));
       } catch (error) {
-        if (error instanceof AdmissionDeniedError) {
+        if (isAdmissionDeniedError(error)) {
           transcriptionOperation?.settleFailure();
           throw error;
         }
@@ -16499,13 +16604,13 @@ function agent(config) {
     _config: config,
     _name: defaultName,
     async ask(prompt, options) {
-      const registry = new ProviderRegistry();
+      const registry2 = new ProviderRegistry();
       const transcriptionRegistry = new TranscriptionProviderRegistry();
       const ctx = new WorkflowContext({
         input: prompt,
         executionId: randomUUID2(),
         config: {},
-        providerRegistry: registry,
+        providerRegistry: registry2,
         transcriptionProviderRegistry: transcriptionRegistry
       });
       return ctx.ask(agentInstance, prompt, options);
@@ -16529,7 +16634,7 @@ function workflow(config) {
 // src/runtime.ts
 import { EventEmitter as EventEmitter2 } from "events";
 import { randomUUID as randomUUID4 } from "crypto";
-import { AsyncLocalStorage as AsyncLocalStorage4 } from "async_hooks";
+import { AsyncLocalStorage as AsyncLocalStorage3 } from "async_hooks";
 import { appendFileSync, mkdirSync as mkdirSync2 } from "fs";
 import { dirname } from "path";
 
@@ -18491,7 +18596,7 @@ async function createSpanManager(config) {
   if (!config?.enabled) {
     return new NoopSpanManager();
   }
-  const { OTelSpanManager } = await import("./span-manager-WZHJOY7N.js");
+  const { OTelSpanManager } = await import("./span-manager-L4H6ZCRQ.js");
   return OTelSpanManager.create(config);
 }
 
@@ -18718,7 +18823,7 @@ function assertNoRemovedObservationCallbacks(options) {
     `runtime.createContext() no longer accepts ${removed.join(", ")}. Observe ctx.events or use runtime.stream() instead. See docs/migration/stream-first-observation.md.`
   );
 }
-var costScopeStorage = new AsyncLocalStorage4();
+var costScopeStorage = new AsyncLocalStorage3();
 function forwardAbortSignal(external, internal) {
   if (!external) return () => {
   };