darwin-langgraph 0.3.0-alpha.1 → 0.4.0-alpha.1

package/dist/darwin-callback-handler.js

@@ -51,8 +51,26 @@
  */
 import { BaseCallbackHandler } from "@langchain/core/callbacks/base";
 import { DarwinEvolutionHookError } from "./errors.js";
+/**
+ * Highest `ExecutionTrace.version` this handler natively understands.
+ * The forward-compat guard in {@link isExecutionTrace} warns once for
+ * higher versions but still emits them (structural shape covers the
+ * required fields) so a Darwin upgrade ahead of the adapter doesn't
+ * silently drop trajectories.
+ *
+ * NEW V0.4 (S1235).
+ */
+export const MAX_KNOWN_TRACE_VERSION = 1;
 /** Default cap. Aligned with reasonable LangGraph fan-out (~1k nodes / minute). */
 const DEFAULT_MAX_IN_FLIGHT_RUNS = 1024;
+/** Default size cap for trajectory `onTrajectory` emission (256 KiB). */
+const DEFAULT_MAX_TRAJECTORY_BYTES = 262_144;
+/**
+ * Process-wide flag so the unknown-version warning fires once per
+ * process even across multiple handler instances. Exported intentionally
+ * undefined — re-bound via module-reload in tests.
+ */
+let unknownTraceVersionWarned = false;
 function isExecutionTrace(value) {
     if (!value || typeof value !== "object")
         return false;
@@ -61,9 +79,61 @@ function isExecutionTrace(value) {
     // version. Downstream consumers (e.g. toOtelAttributes) read
     // `toolCalls.length` directly — a malformed trace with missing arrays
     // would crash there. Guard explicitly.
-    return (v.version === 1 &&
-        Array.isArray(v.toolCalls) &&
-        Array.isArray(v.errors));
+    //
+    // V0.4 (S1235): forward-compat — accept v ≥ 1 as long as the structural
+    // shape `toolCalls + errors` is preserved. A future Darwin release that
+    // bumps the version while adding fields will still flow through; only
+    // structurally-incompatible payloads are dropped. We warn once per
+    // process when we observe a higher-than-known version so an out-of-date
+    // adapter dependency is loud rather than silent.
+    if (typeof v.version !== "number" ||
+        !Number.isFinite(v.version) ||
+        v.version < 1 ||
+        !Array.isArray(v.toolCalls) ||
+        !Array.isArray(v.errors)) {
+        return false;
+    }
+    if (v.version > MAX_KNOWN_TRACE_VERSION && !unknownTraceVersionWarned) {
+        unknownTraceVersionWarned = true;
+        console.warn(`[darwin-langgraph] Observed ExecutionTrace.version=${v.version} — ` +
+            `this adapter knows up to v${MAX_KNOWN_TRACE_VERSION}. Emitting as ` +
+            `compatible v${MAX_KNOWN_TRACE_VERSION}-shape; upgrade darwin-langgraph ` +
+            `to access any new fields. Subsequent unknown-version observations ` +
+            `are silent.`);
+    }
+    return true;
+}
+/**
+ * Build a structurally-compatible BUT minimal stub when a trajectory's
+ * serialised size exceeds the configured cap. Preserves the aggregate
+ * counts (turns / textBlocks / mcp invocations / errors-count via empty
+ * array — counts go through via the dedicated count fields) plus
+ * `capturedAt` for traceability. Caller-visible flag
+ * `trajectoryTruncated = true` is set on the event payload so consumers
+ * can branch on it.
+ */
+function buildTruncatedTrace(t) {
+    // R1 P1-2 fix (S1235): shallow-copy `tokenUsage` instead of leaking
+    // the original object reference. The original trajectory may carry
+    // BigInt fields (some providers expose 64-bit token counts) which
+    // downstream JSON.stringify cannot handle — coerce them to Number
+    // via the explicit spread/normaliser.
+    const tokenUsage = t.tokenUsage
+        ? Object.fromEntries(Object.entries(t.tokenUsage).map(([k, v]) => [
+            k,
+            typeof v === "bigint" ? Number(v) : v,
+        ]))
+        : undefined;
+    return {
+        version: t.version,
+        toolCalls: [],
+        textBlockCount: t.textBlockCount,
+        turnCount: t.turnCount,
+        mcpInvocations: t.mcpInvocations,
+        errors: [],
+        capturedAt: t.capturedAt,
+        ...(tokenUsage ? { tokenUsage: tokenUsage } : {}),
+    };
 }
 function normaliseNodeMap(nodeMap, defaultKey) {
     const resolved = new Map();
@@ -98,15 +168,48 @@ export class DarwinCallbackHandler extends BaseCallbackHandler {
     awaitHandlers = false;
     resolved;
     onTrajectory;
+    onToolEvent;
     /**
      * runId → in-flight run state. Map preserves insertion order so the
      * oldest entry is always at `.keys().next().value` for LRU eviction
      * when the cap is exceeded (V0.3 hung-invoke guard).
      */
     runIdToName = new Map();
+    /**
+     * V0.4 (R1 P1-1 fix, S1235) — `toolRunId → toolName` cache populated
+     * from `handleToolStart` and consumed by `handleToolEnd` /
+     * `handleToolError`. LangChain v0.3 `handleToolEnd` does NOT reliably
+     * carry the tool name in its signature (the slot was repurposed
+     * across releases); reading `output.name` only works for some shapes
+     * and yields "<anonymous-tool>" for the common ToolNode case.
+     */
+    toolRunIdToName = new Map();
+    /**
+     * V0.4 (R1 P1-1 fix, S1235) — pending callbacks keyed by parent chain
+     * runId so we can also restore the chain's tool name at end-time even
+     * after the `toolRunIdToName` entry is cleaned up.
+     */
     maxInFlightRuns;
+    /** V0.4 — byte cap before trajectory replacement. */
+    maxTrajectoryBytes;
+    /**
+     * V0.4 (R1 P1-1 fix) — also cap the tool-name cache. Default matches
+     * `maxInFlightRuns` since tool runs are children of chain runs.
+     */
+    maxInFlightToolRuns;
+    /**
+     * Pending trajectory dispatches keyed by chain runId. When a chain
+     * ends with tools still in flight we hold the dispatch closure here
+     * and fire it from the LAST `handleToolEnd` / `handleToolError`.
+     *
+     * V0.4 (R1 P1-4 fix, S1235).
+     */
+    pendingTrajectoryDispatch = new Map();
     warned = false;
     evictionWarned = false;
+    toolWarned = false;
+    /** V0.4 — once-per-handler warn for trajectory size cap. */
+    trajectoryTruncatedWarned = false;
     constructor(opts) {
         super();
         if (!opts || !opts.nodeMap || Object.keys(opts.nodeMap).length === 0) {
@@ -115,6 +218,7 @@ export class DarwinCallbackHandler extends BaseCallbackHandler {
         const defaultKey = opts.defaultTrajectoryKey ?? "darwinTrajectory";
         this.resolved = normaliseNodeMap(opts.nodeMap, defaultKey);
         this.onTrajectory = opts.onTrajectory;
+        this.onToolEvent = opts.onToolEvent;
         // V0.3 (S1187): hung-invoke guard. NaN / negative / non-number falls
         // back to default. Infinity disables the cap (opt-out).
         const raw = opts.maxInFlightRuns;
@@ -127,6 +231,24 @@ export class DarwinCallbackHandler extends BaseCallbackHandler {
         else {
             this.maxInFlightRuns = DEFAULT_MAX_IN_FLIGHT_RUNS;
         }
+        // V0.4 (S1235): trajectory size guard. Same shape as maxInFlightRuns.
+        const rawBytes = opts.maxTrajectoryBytes;
+        if (rawBytes === Infinity) {
+            this.maxTrajectoryBytes = Infinity;
+        }
+        else if (typeof rawBytes === "number" &&
+            Number.isFinite(rawBytes) &&
+            rawBytes > 0) {
+            this.maxTrajectoryBytes = Math.floor(rawBytes);
+        }
+        else {
+            this.maxTrajectoryBytes = DEFAULT_MAX_TRAJECTORY_BYTES;
+        }
+        // V0.4 (R1 P1-1 fix): tool-name cache cap mirrors the chain cap.
+        this.maxInFlightToolRuns =
+            this.maxInFlightRuns === Infinity
+                ? Infinity
+                : Math.max(this.maxInFlightRuns, 1) * 4;
     }
     /**
      * Capture the run-id → node-name mapping.
@@ -181,6 +303,8 @@ export class DarwinCallbackHandler extends BaseCallbackHandler {
         this.runIdToName.set(runId, {
             nodeName,
             parentRunId: typeof parentRunId === "string" ? parentRunId : undefined,
+            pendingTools: 0,
+            finalized: false,
         });
     }
     /**
@@ -196,23 +320,65 @@ export class DarwinCallbackHandler extends BaseCallbackHandler {
         const inFlight = this.runIdToName.get(runId);
         if (!inFlight)
             return;
-        // One-shot cleanup of the mapping so completed runs don't leak.
-        // R1 V0.2 Critic Finding 1 (S1185): the `runIdToName.delete` here
-        // is the ONLY dedup we need — LangGraph guarantees `handleChainEnd`
-        // fires exactly once per `runId`, and after deletion any second
-        // call returns early at `if (!inFlight)`. The pre-V0.2 `firedRuns`
-        // Set was redundant AND leaked unbounded — removed.
-        this.runIdToName.delete(runId);
-        if (!this.onTrajectory)
+        // V0.4 (R1 P1-4 fix, S1235): defer the chain-entry cleanup if tool
+        // events are still pending. Without this, `handleToolEnd` for a
+        // still-executing tool would see `runIdToName.get(parentRunId) ===
+        // undefined` and silently drop the tool event. We mark the entry
+        // `finalized` so subsequent `handleChainStart` for the SAME runId
+        // (which LangGraph never does, but defense-in-depth) is treated as
+        // a re-fire and ignored; and we hold the trajectory dispatch in
+        // `pendingTrajectoryDispatch` to fire from the last tool callback.
+        inFlight.finalized = true;
+        if (inFlight.pendingTools === 0) {
+            this.runIdToName.delete(runId);
+        }
+        if (!this.onTrajectory) {
+            if (inFlight.pendingTools === 0) {
+                // Already cleaned up; nothing more to do.
+                return;
+            }
+            // Caller does not care about the trajectory, just the tool events.
+            // No pending dispatch needed; the tool-callback path will clean up
+            // the chain entry when pending hits 0.
             return;
+        }
         const entry = this.resolved.get(inFlight.nodeName);
         if (!entry)
             return;
         if (outputs === null || typeof outputs !== "object")
             return;
-        const trajectory = outputs[entry.trajectoryKey];
-        if (!isExecutionTrace(trajectory))
+        const trajectoryRaw = outputs[entry.trajectoryKey];
+        if (!isExecutionTrace(trajectoryRaw))
             return;
+        // V0.4 (S1235): size-guard. Run JSON.stringify ONCE and reuse its
+        // length for the cap test — the result is discarded, we never log
+        // raw payloads. JSON.stringify can throw on circular refs / BigInt
+        // / Symbol values; defensive catch keeps the hook robust regardless.
+        let serialisedSize = 0;
+        try {
+            serialisedSize = JSON.stringify(trajectoryRaw).length;
+        }
+        catch {
+            // Unserialisable trajectories are themselves a signal worth
+            // surfacing — treat as oversized so consumers see the replacement.
+            serialisedSize = Number.POSITIVE_INFINITY;
+        }
+        let trajectory = trajectoryRaw;
+        let trajectoryTruncated = false;
+        if (this.maxTrajectoryBytes !== Infinity &&
+            serialisedSize > this.maxTrajectoryBytes) {
+            trajectory = buildTruncatedTrace(trajectoryRaw);
+            trajectoryTruncated = true;
+            if (!this.trajectoryTruncatedWarned) {
+                this.trajectoryTruncatedWarned = true;
+                console.warn(`[darwin-langgraph] DarwinCallbackHandler: trajectory for ` +
+                    `"${inFlight.nodeName}" was ${serialisedSize} bytes — exceeded ` +
+                    `${this.maxTrajectoryBytes} byte cap. Emitting structurally-` +
+                    `compatible minimal stub with the original counts preserved. ` +
+                    `Set DarwinCallbackHandlerOptions.maxTrajectoryBytes to raise ` +
+                    `the cap or Infinity to opt out. Subsequent truncations are silent.`);
+            }
+        }
         const frozen = Object.freeze({ ...outputs });
         // V0.3 (S1187): propagate runId + parentRunId so OTEL exporters,
         // Langfuse, LangSmith, etc. can rebuild the span hierarchy from the
@@ -224,19 +390,187 @@ export class DarwinCallbackHandler extends BaseCallbackHandler {
             finalState: frozen,
             runId,
             ...(inFlight.parentRunId !== undefined ? { parentRunId: inFlight.parentRunId } : {}),
+            ...(trajectoryTruncated ? { trajectoryTruncated: true } : {}),
         };
-        // Fire-and-forget. The handler base class supports async returns
-        // but we don't want to block the chain end on slow user callbacks.
-        void Promise.resolve()
-            .then(() => this.onTrajectory(event))
-            .catch((err) => this.swallow(err));
+        const dispatch = () => {
+            void Promise.resolve()
+                .then(() => this.onTrajectory(event))
+                .catch((err) => this.swallow(err));
+        };
+        if (inFlight.pendingTools > 0) {
+            // V0.4 (R1 P1-4 fix): defer the dispatch until all tool events
+            // have surfaced so consumers see tool spans BEFORE the agent span
+            // closes. The last tool callback drains this map.
+            this.pendingTrajectoryDispatch.set(runId, dispatch);
+        }
+        else {
+            dispatch();
+        }
     }
     /**
      * Forget the in-flight runId when a chain errors out. We don't fire
      * the hook on error — the trajectory is by definition incomplete.
      */
     handleChainError(_err, runId, _parentRunId) {
+        // V0.4 (R1 P1-4): on error we discard pending trajectory dispatch —
+        // an errored chain has no complete trajectory by definition.
         this.runIdToName.delete(runId);
+        this.pendingTrajectoryDispatch.delete(runId);
+    }
+    /**
+     * V0.4 (S1235) — tool-chain start event. LangGraph fires `handleToolStart`
+     * for every tool-invocation a node performs (whether via `ToolNode`,
+     * `createReactAgent`, or a custom tool-call dispatcher). We use the
+     * `parentRunId` slot to associate the tool with the tracking node and
+     * emit a `DarwinToolEvent` so consumers can build per-tool OTEL spans
+     * or progress UIs.
+     *
+     * If `parentRunId` is missing OR the parent is not a tracked node, the
+     * tool event is silently dropped — the handler never surfaces unmapped
+     * activity (consistent with the chain-side `resolved.has(nodeName)` gate).
+     */
+    handleToolStart(_tool, input, runId, parentRunId, _tags, _metadata, _runType, name) {
+        if (typeof parentRunId !== "string")
+            return;
+        const inFlight = this.runIdToName.get(parentRunId);
+        if (!inFlight)
+            return;
+        const entry = this.resolved.get(inFlight.nodeName);
+        if (!entry)
+            return;
+        const toolName = typeof name === "string" && name.length > 0 ? name : "<anonymous-tool>";
+        // V0.4 (R1 P1-1 fix): cache the tool name keyed by tool runId so
+        // `handleToolEnd` / `handleToolError` can recover it. The LangChain
+        // tool-end signature does NOT carry the name reliably across versions.
+        if (this.maxInFlightToolRuns !== Infinity && !this.toolRunIdToName.has(runId)) {
+            if (this.toolRunIdToName.size >= this.maxInFlightToolRuns) {
+                const oldest = this.toolRunIdToName.keys().next().value;
+                if (oldest !== undefined)
+                    this.toolRunIdToName.delete(oldest);
+            }
+        }
+        this.toolRunIdToName.set(runId, toolName);
+        // V0.4 (R1 P1-4 fix): increment pending-tools counter on the chain
+        // so `handleChainEnd` knows to defer trajectory dispatch.
+        inFlight.pendingTools++;
+        if (!this.onToolEvent)
+            return;
+        const event = {
+            nodeName: inFlight.nodeName,
+            agentName: entry.agentName,
+            toolName,
+            phase: "start",
+            runId,
+            parentRunId,
+            ...(typeof input === "string" ? { input } : {}),
+        };
+        this.dispatchToolEvent(event);
+    }
+    /**
+     * V0.4 (S1235) — tool-chain end event.
+     */
+    handleToolEnd(output, runId, parentRunId) {
+        if (typeof parentRunId !== "string")
+            return;
+        const inFlight = this.runIdToName.get(parentRunId);
+        if (!inFlight) {
+            // Pending-tools counter is gone with the chain — best-effort
+            // cleanup of the tool-name cache only.
+            this.toolRunIdToName.delete(runId);
+            return;
+        }
+        const entry = this.resolved.get(inFlight.nodeName);
+        if (!entry) {
+            this.toolRunIdToName.delete(runId);
+            return;
+        }
+        // V0.4 (R1 P1-1 fix): recover the tool name from the cache populated
+        // at `handleToolStart`. Fall back to inspecting `output.name` for
+        // adversarial cases where start was missed (eg LangChain version
+        // mismatch). Both paths preserve the start/end name symmetry that
+        // older revisions broke.
+        let toolName = this.toolRunIdToName.get(runId);
+        if (!toolName) {
+            if (output && typeof output === "object" && "name" in output) {
+                const n = output.name;
+                if (typeof n === "string" && n.length > 0)
+                    toolName = n;
+            }
+            if (!toolName)
+                toolName = "<anonymous-tool>";
+        }
+        this.toolRunIdToName.delete(runId);
+        if (this.onToolEvent) {
+            const event = {
+                nodeName: inFlight.nodeName,
+                agentName: entry.agentName,
+                toolName,
+                phase: "end",
+                runId,
+                parentRunId,
+                output,
+            };
+            this.dispatchToolEvent(event);
+        }
+        // V0.4 (R1 P1-4 fix): decrement pending counter and drain the
+        // deferred trajectory dispatch if this was the last tool AND
+        // handleChainEnd had already fired.
+        inFlight.pendingTools = Math.max(0, inFlight.pendingTools - 1);
+        if (inFlight.finalized && inFlight.pendingTools === 0) {
+            const dispatch = this.pendingTrajectoryDispatch.get(parentRunId);
+            if (dispatch) {
+                this.pendingTrajectoryDispatch.delete(parentRunId);
+                dispatch();
+            }
+            this.runIdToName.delete(parentRunId);
+        }
+    }
+    /**
+     * V0.4 (S1235) — tool-chain error event.
+     */
+    handleToolError(err, runId, parentRunId) {
+        if (typeof parentRunId !== "string")
+            return;
+        const inFlight = this.runIdToName.get(parentRunId);
+        if (!inFlight) {
+            this.toolRunIdToName.delete(runId);
+            return;
+        }
+        const entry = this.resolved.get(inFlight.nodeName);
+        if (!entry) {
+            this.toolRunIdToName.delete(runId);
+            return;
+        }
+        // V0.4 (R1 P1-1 fix): recover the tool name from the cache.
+        const toolName = this.toolRunIdToName.get(runId) ?? "<anonymous-tool>";
+        this.toolRunIdToName.delete(runId);
+        if (this.onToolEvent) {
+            const event = {
+                nodeName: inFlight.nodeName,
+                agentName: entry.agentName,
+                toolName,
+                phase: "error",
+                runId,
+                parentRunId,
+                error: err instanceof Error ? err : new Error(String(err)),
+            };
+            this.dispatchToolEvent(event);
+        }
+        // V0.4 (R1 P1-4 fix): mirror the pending-count drain from handleToolEnd.
+        inFlight.pendingTools = Math.max(0, inFlight.pendingTools - 1);
+        if (inFlight.finalized && inFlight.pendingTools === 0) {
+            const dispatch = this.pendingTrajectoryDispatch.get(parentRunId);
+            if (dispatch) {
+                this.pendingTrajectoryDispatch.delete(parentRunId);
+                dispatch();
+            }
+            this.runIdToName.delete(parentRunId);
+        }
+    }
+    dispatchToolEvent(event) {
+        void Promise.resolve()
+            .then(() => this.onToolEvent(event))
+            .catch((err) => this.swallowTool(err));
     }
     swallow(err) {
         // R1 V0.2 Critic Finding 5 (S1185): do NOT short-circuit on falsy
@@ -249,6 +583,14 @@ export class DarwinCallbackHandler extends BaseCallbackHandler {
             `Subsequent throws will be silent. Original error: ` +
             `${err instanceof Error ? err.message : String(err)}`);
     }
+    swallowTool(err) {
+        if (this.toolWarned)
+            return;
+        this.toolWarned = true;
+        console.warn(`[darwin-langgraph] DarwinCallbackHandler.onToolEvent threw — swallowed. ` +
+            `Subsequent throws will be silent. Original error: ` +
+            `${err instanceof Error ? err.message : String(err)}`);
+    }
     /**
      * Helper for tests + debug introspection — returns how many in-flight
      * chain runs we are currently tracking. Should be 0 between

package/dist/darwin-callback-handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"darwin-callback-handler.js","sourceRoot":"","sources":["../src/darwin-callback-handler.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"darwin-callback-handler.js","sourceRoot":"","sources":["../src/darwin-callback-handler.ts"],"names":[],"mappings":"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"}

package/dist/errors.d.ts

@@ -19,4 +19,20 @@ export declare class DarwinEvolutionHookError extends Error {
         cause?: unknown;
     });
 }
+/**
+ * Thrown by `createTokenBudgetCallbacks` when a configured per-invocation
+ * token budget is exceeded. The handler attaches the cumulative tokens
+ * counted at the moment of the throw so consumers can log / alert.
+ *
+ * NEW V0.4 (S1235).
+ */
+export declare class DarwinTokenBudgetExceededError extends Error {
+    readonly budget: number;
+    readonly totalTokens: number;
+    readonly providerHint: string | undefined;
+    readonly name = "DarwinTokenBudgetExceededError";
+    constructor(message: string, budget: number, totalTokens: number, providerHint: string | undefined, options?: {
+        cause?: unknown;
+    });
+}
 //# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,qBAAa,eAAgB,SAAQ,KAAK;aAKtB,SAAS,EAAE,MAAM;IAJnC,SAAyB,IAAI,qBAAqB;gBAGhD,OAAO,EAAE,MAAM,EACC,SAAS,EAAE,MAAM,EACjC,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAIhC;AAED,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,SAAyB,IAAI,8BAA8B;gBAE/C,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAG3D"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,qBAAa,eAAgB,SAAQ,KAAK;aAKtB,SAAS,EAAE,MAAM;IAJnC,SAAyB,IAAI,qBAAqB;gBAGhD,OAAO,EAAE,MAAM,EACC,SAAS,EAAE,MAAM,EACjC,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAIhC;AAED,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,SAAyB,IAAI,8BAA8B;gBAE/C,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAG3D;AAED;;;;;;GAMG;AACH,qBAAa,8BAA+B,SAAQ,KAAK;aAKrC,MAAM,EAAE,MAAM;aACd,WAAW,EAAE,MAAM;aACnB,YAAY,EAAE,MAAM,GAAG,SAAS;IANlD,SAAyB,IAAI,oCAAoC;gBAG/D,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GAAG,SAAS,EAChD,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAIhC"}

package/dist/errors.js

@@ -20,4 +20,23 @@ export class DarwinEvolutionHookError extends Error {
         super(message, options);
     }
 }
+/**
+ * Thrown by `createTokenBudgetCallbacks` when a configured per-invocation
+ * token budget is exceeded. The handler attaches the cumulative tokens
+ * counted at the moment of the throw so consumers can log / alert.
+ *
+ * NEW V0.4 (S1235).
+ */
+export class DarwinTokenBudgetExceededError extends Error {
+    budget;
+    totalTokens;
+    providerHint;
+    name = "DarwinTokenBudgetExceededError";
+    constructor(message, budget, totalTokens, providerHint, options) {
+        super(message, options);
+        this.budget = budget;
+        this.totalTokens = totalTokens;
+        this.providerHint = providerHint;
+    }
+}
 //# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAKtB;IAJO,IAAI,GAAG,iBAAiB,CAAC;IAElD,YACE,OAAe,EACC,SAAiB,EACjC,OAA6B;QAE7B,KAAK,CAAC,OAAO,EAAE,OAAuB,CAAC,CAAC;QAHxB,cAAS,GAAT,SAAS,CAAQ;IAInC,CAAC;CACF;AAED,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IACxB,IAAI,GAAG,0BAA0B,CAAC;IAE3D,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,OAAO,EAAE,OAAuB,CAAC,CAAC;IAC1C,CAAC;CACF"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAKtB;IAJO,IAAI,GAAG,iBAAiB,CAAC;IAElD,YACE,OAAe,EACC,SAAiB,EACjC,OAA6B;QAE7B,KAAK,CAAC,OAAO,EAAE,OAAuB,CAAC,CAAC;QAHxB,cAAS,GAAT,SAAS,CAAQ;IAInC,CAAC;CACF;AAED,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IACxB,IAAI,GAAG,0BAA0B,CAAC;IAE3D,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,OAAO,EAAE,OAAuB,CAAC,CAAC;IAC1C,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,OAAO,8BAA+B,SAAQ,KAAK;IAKrC;IACA;IACA;IANO,IAAI,GAAG,gCAAgC,CAAC;IAEjE,YACE,OAAe,EACC,MAAc,EACd,WAAmB,EACnB,YAAgC,EAChD,OAA6B;QAE7B,KAAK,CAAC,OAAO,EAAE,OAAuB,CAAC,CAAC;QALxB,WAAM,GAAN,MAAM,CAAQ;QACd,gBAAW,GAAX,WAAW,CAAQ;QACnB,iBAAY,GAAZ,YAAY,CAAoB;IAIlD,CAAC;CACF"}

package/dist/index.d.ts

@@ -40,11 +40,15 @@
 export { createDarwinNode, type CreateDarwinNodeOptions, type DarwinNodeFn, type DarwinRunOptionsPassthrough, } from "./create-darwin-node.js";
 export { darwinAnnotation, getDarwinChannelSpec, lastWriteWinsTrajectoryReducer, } from "./darwin-annotation.js";
 export { withDarwinEvolution, type DarwinEvolutionOptions, type DarwinNodeMapEntry, type DarwinTrajectoryEvent, } from "./with-darwin-evolution.js";
-export { DarwinCallbackHandler, type DarwinCallbackHandlerOptions, } from "./darwin-callback-handler.js";
+export { DarwinCallbackHandler, MAX_KNOWN_TRACE_VERSION, type DarwinCallbackHandlerOptions, type DarwinToolEvent, } from "./darwin-callback-handler.js";
 export { toOtelAttributes, toolCallToOtelAttributes, type OtelAttributes, type ToOtelAttributesOptions, type ToolCallOtelOptions, } from "./to-otel-attributes.js";
 export { darwinMessagesAnnotation, getMessagesChannelSpec, } from "./darwin-messages-annotation.js";
-export { DarwinNodeError, DarwinEvolutionHookError } from "./errors.js";
+export { darwinAccumulatingAnnotation, getDarwinAccumulatingChannelSpec, darwinTrajectoryAccumulatorReducer, } from "./darwin-accumulating-annotation.js";
+export { TokenBudgetCallbackHandler, createTokenBudgetCallbacks, type TokenBudgetOptions, type TokenBudgetExceedInfo, type TokenBudgetTickInfo, } from "./token-budget.js";
+export { toW3CTraceContext, type ToW3CTraceContextOptions, type W3CTraceContext, } from "./to-w3c-trace-context.js";
+export type { DarwinNodeAttemptInfo } from "./create-darwin-node.js";
+export { DarwinNodeError, DarwinEvolutionHookError, DarwinTokenBudgetExceededError, } from "./errors.js";
 export type { AgentDefinition, DarwinExperiment, ExecutionTrace, MemoryProvider, RunResult, TraceToolCall, TraceTokenUsage, TraceTurnError, } from "./types.js";
 /** Adapter version — sync with `package.json` on every release. */
-export declare const VERSION = "0.3.0-alpha.1";
+export declare const VERSION = "0.4.0-alpha.1";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,OAAO,EACL,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,KAAK,YAAY,EACjB,KAAK,2BAA2B,GACjC,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,8BAA8B,GAC/B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,mBAAmB,EACnB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,GAC3B,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EACL,qBAAqB,EACrB,KAAK,4BAA4B,GAClC,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EACL,gBAAgB,EAChB,wBAAwB,EACxB,KAAK,cAAc,EACnB,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,GACzB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAExE,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,SAAS,EACT,aAAa,EACb,eAAe,EACf,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,mEAAmE;AACnE,eAAO,MAAM,OAAO,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,OAAO,EACL,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,KAAK,YAAY,EACjB,KAAK,2BAA2B,GACjC,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,8BAA8B,GAC/B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,mBAAmB,EACnB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,GAC3B,MAAM,4BAA4B,CAAC;AAIpC,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,KAAK,4BAA4B,EACjC,KAAK,eAAe,GACrB,MAAM,8BAA8B,CAAC;AAItC,OAAO,EACL,gBAAgB,EAChB,wBAAwB,EACxB,KAAK,cAAc,EACnB,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,GACzB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,iCAAiC,CAAC;AAGzC,OAAO,EACL,4BAA4B,EAC5B,gCAAgC,EAChC,kCAAkC,GACnC,MAAM,qCAAqC,CAAC;AAG7C,OAAO,EACL,0BAA0B,EAC1B,0BAA0B,EAC1B,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,GACzB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,KAAK,eAAe,GACrB,MAAM,2BAA2B,CAAC;AAGnC,YAAY,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAErE,OAAO,EACL,eAAe,EACf,wBAAwB,EACxB,8BAA8B,GAC/B,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,SAAS,EACT,aAAa,EACb,eAAe,EACf,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,mEAAmE;AACnE,eAAO,MAAM,OAAO,kBAAkB,CAAC"}

package/dist/index.js

@@ -41,12 +41,20 @@ export { createDarwinNode, } from "./create-darwin-node.js";
 export { darwinAnnotation, getDarwinChannelSpec, lastWriteWinsTrajectoryReducer, } from "./darwin-annotation.js";
 export { withDarwinEvolution, } from "./with-darwin-evolution.js";
 // V0.2 — LangChain-native callback handler (preferred over `withDarwinEvolution`)
-export { DarwinCallbackHandler, } from "./darwin-callback-handler.js";
+// V0.4 — extended with onToolEvent + maxTrajectoryBytes + MAX_KNOWN_TRACE_VERSION
+export { DarwinCallbackHandler, MAX_KNOWN_TRACE_VERSION, } from "./darwin-callback-handler.js";
 // V0.2 — OTEL GenAI Semantic Conventions mapping
+// V0.4 — extended with langGraphNode / langGraphStep / userId / requestId
 export { toOtelAttributes, toolCallToOtelAttributes, } from "./to-otel-attributes.js";
 // V0.2 — MessagesAnnotation interop for graphs mixing createReactAgent + createDarwinNode
 export { darwinMessagesAnnotation, getMessagesChannelSpec, } from "./darwin-messages-annotation.js";
-export { DarwinNodeError, DarwinEvolutionHookError } from "./errors.js";
+// V0.4 — accumulating annotation for graphs that fan-out multiple Darwin nodes
+export { darwinAccumulatingAnnotation, getDarwinAccumulatingChannelSpec, darwinTrajectoryAccumulatorReducer, } from "./darwin-accumulating-annotation.js";
+// V0.4 — token-budget callbacks (production guard against runaway agents)
+export { TokenBudgetCallbackHandler, createTokenBudgetCallbacks, } from "./token-budget.js";
+// V0.4 — W3C Trace Context mapper for cross-process span correlation
+export { toW3CTraceContext, } from "./to-w3c-trace-context.js";
+export { DarwinNodeError, DarwinEvolutionHookError, DarwinTokenBudgetExceededError, } from "./errors.js";
 /** Adapter version — sync with `package.json` on every release. */
-export const VERSION = "0.3.0-alpha.1";
+export const VERSION = "0.4.0-alpha.1";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,OAAO,EACL,gBAAgB,GAIjB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,8BAA8B,GAC/B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,mBAAmB,GAIpB,MAAM,4BAA4B,CAAC;AAEpC,kFAAkF;AAClF,OAAO,EACL,qBAAqB,GAEtB,MAAM,8BAA8B,CAAC;AAEtC,iDAAiD;AACjD,OAAO,EACL,gBAAgB,EAChB,wBAAwB,GAIzB,MAAM,yBAAyB,CAAC;AAEjC,0FAA0F;AAC1F,OAAO,EACL,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAaxE,mEAAmE;AACnE,MAAM,CAAC,MAAM,OAAO,GAAG,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,OAAO,EACL,gBAAgB,GAIjB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,8BAA8B,GAC/B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,mBAAmB,GAIpB,MAAM,4BAA4B,CAAC;AAEpC,kFAAkF;AAClF,kFAAkF;AAClF,OAAO,EACL,qBAAqB,EACrB,uBAAuB,GAGxB,MAAM,8BAA8B,CAAC;AAEtC,iDAAiD;AACjD,0EAA0E;AAC1E,OAAO,EACL,gBAAgB,EAChB,wBAAwB,GAIzB,MAAM,yBAAyB,CAAC;AAEjC,0FAA0F;AAC1F,OAAO,EACL,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,iCAAiC,CAAC;AAEzC,+EAA+E;AAC/E,OAAO,EACL,4BAA4B,EAC5B,gCAAgC,EAChC,kCAAkC,GACnC,MAAM,qCAAqC,CAAC;AAE7C,0EAA0E;AAC1E,OAAO,EACL,0BAA0B,EAC1B,0BAA0B,GAI3B,MAAM,mBAAmB,CAAC;AAE3B,qEAAqE;AACrE,OAAO,EACL,iBAAiB,GAGlB,MAAM,2BAA2B,CAAC;AAKnC,OAAO,EACL,eAAe,EACf,wBAAwB,EACxB,8BAA8B,GAC/B,MAAM,aAAa,CAAC;AAarB,mEAAmE;AACnE,MAAM,CAAC,MAAM,OAAO,GAAG,eAAe,CAAC"}