@cendor/core 0.3.2 → 0.4.0

package/dist/langchain.js

@@ -0,0 +1,345 @@
+/**
+ * Optional LangChain.js / LangGraph integration — the SDK-aligned way to observe a framework.
+ *
+ * The SDK-aligned integration point for a framework is its **callback system**, not client
+ * monkeypatching: `@langchain/openai` consumes usage through its own response path and streams via
+ * async iterators, so `instrument()` on the raw client can miss usage — observing through callbacks
+ * sidesteps that. {@link CendorCallbackHandler} reads LangChain's own `usage_metadata` (which carries
+ * **reasoning** and **cached** token breakdowns), prices the call offline, correlates multi-node /
+ * multi-agent runs via `traceId`, and emits normalized {@link LLMCall} / {@link ToolCall} events on
+ * the bus — so `tokenguard`, `acttrace`, and any other subscriber see LangChain activity with no
+ * client touch.
+ *
+ * **Recording-only.** This path is post-call: it *observes*, it never enforces. `tokenguard`'s caps
+ * and `acttrace`'s `guard()` act on the `instrument()` seam, which the callback path does not touch —
+ * so pre-flight enforcement (budget blocking, redact-before-send) is a **no-op** here. Use the direct
+ * provider SDK with `instrument()` when you need enforcement.
+ *
+ * Requires the optional peer dependency, keeping `@cendor/core` dependency-light (like
+ * `@opentelemetry/api`). Importing this subpath without `@langchain/core` installed throws a clear
+ * error.
+ *
+ *     npm install @langchain/core
+ *
+ * Usage:
+ *
+ * ```ts
+ * import { CendorCallbackHandler } from '@cendor/core/langchain';
+ * const handler = new CendorCallbackHandler();
+ *
+ * const llm = new ChatOpenAI({ model: 'gpt-4o', callbacks: [handler] });  // every call recorded
+ * await llm.invoke('hi');
+ *
+ * // or per-call / per-agent — propagates to all LangGraph nodes, correlated by root run:
+ * await agent.invoke({ messages: [...] }, { callbacks: [handler] });
+ * ```
+ */
+import { createRequire } from 'node:module';
+import * as bus from './bus.js';
+import * as prices from './prices.js';
+import { LLMCall, ToolCall, Usage } from './types.js';
+/**
+ * Load LangChain's `BaseCallbackHandler` synchronously so this class can extend it, mirroring the
+ * Python handler's import-time `ImportError` when the optional dependency is absent. LangChain
+ * accepts handlers by duck-typing (`copy`/`name`/`awaitHandlers`), so the CJS build resolved here
+ * interoperates with an ESM-imported `@langchain/core` in the host app.
+ */
+function loadBaseCallbackHandler() {
+    try {
+        const req = createRequire(import.meta.url);
+        const mod = req('@langchain/core/callbacks/base');
+        return mod.BaseCallbackHandler;
+    }
+    catch (cause) {
+        throw new Error('@cendor/core/langchain requires @langchain/core. Install it with:  npm install @langchain/core', { cause });
+    }
+}
+const BaseCallbackHandler = loadBaseCallbackHandler();
+/**
+ * A LangChain / LangGraph callback handler that records usage, reasoning, tool calls, and run
+ * correlation onto cendor's bus. **Recording-only** — never enforces (see the module docstring).
+ *
+ * Attach it globally (`new ChatOpenAI({ callbacks: [new CendorCallbackHandler()] })`), per call
+ * (`{ callbacks: [handler] }`), or on an agent (`agent.invoke(..., { callbacks: [handler] })`) — for
+ * LangGraph it propagates to every node and its tools.
+ *
+ * **Correlation.** Every emitted event carries a `traceId` that is the **root run id** of the
+ * invocation — resolved by tracking the callback run tree (each run's `parentRunId`) and walking to
+ * the top. So all model/tool calls of one `agent.invoke` (across its nodes and the react loop) share
+ * one `traceId`, while separate invocations get distinct ones. A standalone `llm.invoke` uses its own
+ * run id. This is a correlation *hook*, not an orchestrator: cendor groups by the framework's own run
+ * tree; it invents no run graph.
+ *
+ * Every handler body is exception-safe (a recorder must never break the app); `raiseError` is left
+ * `false` (the base default) so LangChain also swallows any escape.
+ */
+export class CendorCallbackHandler extends BaseCallbackHandler {
+    name = 'CendorCallbackHandler';
+    // runId -> parentRunId (or null for a root), built from the *Start callbacks so each event can be
+    // resolved to the root run it belongs to. Bounded: entries are removed on run end/error.
+    parents = new Map();
+    // tool runId -> pending { name, input }, bridged from handleToolStart to handleToolEnd.
+    toolRuns = new Map();
+    // Node is single-threaded, so — unlike the Python handler — there is no lock guarding the maps.
+    /**
+     * Share one handler instance across merged callback managers instead of copying. A stateful
+     * correlation handler must observe the *whole* run tree; the base `copy()` returns a fresh clone
+     * with empty maps, which would break trace-id resolution. Sharing is safe here: every handler body
+     * is exception-safe and the map operations are idempotent, and returning the same identity also
+     * lets LangChain's identity-based handler de-duplication work.
+     */
+    copy() {
+        return this;
+    }
+    // ------------------------------------------------------------------ run-tree bookkeeping
+    register(runId, parentRunId) {
+        if (!runId)
+            return;
+        this.parents.set(runId, parentRunId ?? null);
+    }
+    forget(runId) {
+        if (!runId)
+            return;
+        this.parents.delete(runId);
+    }
+    /**
+     * The root run id for this event: walk `parent` links up to the top. Falls back to
+     * `parentRunId`/`runId` when the run tree wasn't observed (e.g. a bare model call).
+     */
+    traceId(runId, parentRunId) {
+        let rid = runId ?? '';
+        if (!rid)
+            return parentRunId ?? '';
+        const seen = new Set();
+        while (this.parents.has(rid) && this.parents.get(rid) && !seen.has(rid)) {
+            seen.add(rid);
+            rid = this.parents.get(rid); // guarded truthy above
+        }
+        return rid;
+    }
+    handleChainStart(_chain, _inputs, runId, _runType, _tags, _metadata, _runName, parentRunId) {
+        this.register(runId, parentRunId);
+    }
+    handleChainEnd(_outputs, runId) {
+        this.forget(runId);
+    }
+    handleChainError(_err, runId) {
+        this.forget(runId);
+    }
+    handleChatModelStart(_llm, _messages, runId, parentRunId) {
+        this.register(runId, parentRunId);
+    }
+    handleLLMStart(_llm, _prompts, runId, parentRunId) {
+        this.register(runId, parentRunId);
+    }
+    // ------------------------------------------------------------------ LLM calls
+    /** Emit an {@link LLMCall} with usage/reasoning/cost and a run-correlated `traceId`. */
+    handleLLMEnd(output, runId, parentRunId) {
+        try {
+            const usage = usageFromResult(output);
+            const call = new LLMCall({
+                id: uuidHex(),
+                provider: 'langchain', // observed via the framework; the real model rides call.model
+                model: modelFromResult(output),
+                messages: [], // the callback path is usage-focused; prompts aren't recorded here
+                usage,
+                traceId: this.traceId(runId, parentRunId),
+            });
+            call.metadata.source = 'langchain';
+            setCost(call, usage);
+            bus.emit(call);
+        }
+        catch {
+            // recording must never break the app
+        }
+        finally {
+            this.forget(runId);
+        }
+    }
+    /** Record a failed model call (no usage) with the error on metadata — never re-raised. */
+    handleLLMError(err, runId, parentRunId) {
+        try {
+            const call = new LLMCall({
+                id: uuidHex(),
+                provider: 'langchain',
+                model: '',
+                messages: [],
+                traceId: this.traceId(runId, parentRunId),
+            });
+            call.metadata.source = 'langchain';
+            call.metadata.error = errorMessage(err);
+            bus.emit(call);
+        }
+        catch {
+            // recording must never break the app
+        }
+        finally {
+            this.forget(runId);
+        }
+    }
+    // ------------------------------------------------------------------ tool calls
+    /** Record the tool's parent (for correlation) and stash its name/args until it ends. */
+    handleToolStart(tool, input, runId, parentRunId) {
+        this.register(runId, parentRunId);
+        try {
+            this.toolRuns.set(runId, { name: serializedName(tool) ?? 'tool', input });
+        }
+        catch {
+            // recording must never break the app
+        }
+    }
+    /** Emit a {@link ToolCall} (name, args, result) correlated to its run's root. */
+    handleToolEnd(output, runId, parentRunId) {
+        try {
+            const pending = this.toolRuns.get(runId);
+            this.toolRuns.delete(runId);
+            const tc = new ToolCall({
+                id: uuidHex(),
+                name: pending?.name ?? 'tool',
+                arguments: { input: pending?.input },
+                result: output,
+                traceId: this.traceId(runId, parentRunId),
+            });
+            tc.metadata.source = 'langchain';
+            bus.emit(tc);
+        }
+        catch {
+            // recording must never break the app
+        }
+        finally {
+            this.forget(runId);
+        }
+    }
+    /** Emit a {@link ToolCall} marking the failure; drop the pending entry. Never re-raised. */
+    handleToolError(err, runId, parentRunId) {
+        try {
+            const pending = this.toolRuns.get(runId);
+            this.toolRuns.delete(runId);
+            const tc = new ToolCall({
+                id: uuidHex(),
+                name: pending?.name ?? 'tool',
+                arguments: { input: pending?.input },
+                traceId: this.traceId(runId, parentRunId),
+            });
+            tc.metadata.source = 'langchain';
+            tc.metadata.error = errorMessage(err);
+            bus.emit(tc);
+        }
+        catch {
+            // recording must never break the app
+        }
+        finally {
+            this.forget(runId);
+        }
+    }
+}
+// --------------------------------------------------------------------------- extraction helpers
+/** A hex UUID (no dashes), mirroring the ids `instrument()` stamps. */
+function uuidHex() {
+    return globalThis.crypto.randomUUID().replace(/-/g, '');
+}
+function num(value) {
+    if (typeof value === 'number')
+        return Number.isFinite(value) ? value : 0;
+    if (typeof value === 'string') {
+        const n = Number.parseInt(value, 10);
+        return Number.isNaN(n) ? 0 : n;
+    }
+    return 0;
+}
+/**
+ * Recover usage from an `LLMResult`: prefer a generation message's `usage_metadata` (it carries
+ * reasoning + cache breakdowns), falling back to `llmOutput`'s token usage.
+ */
+function usageFromResult(result) {
+    for (const gens of result.generations ?? []) {
+        for (const gen of gens) {
+            const meta = gen.message?.usage_metadata;
+            if (meta)
+                return usageFromMetadata(meta);
+        }
+    }
+    const llmOutput = (result.llmOutput ?? {});
+    const tokenUsage = (llmOutput.tokenUsage ?? llmOutput.token_usage ?? llmOutput.usage);
+    if (tokenUsage) {
+        const inp = num(tokenUsage.promptTokens ?? tokenUsage.prompt_tokens ?? tokenUsage.input_tokens);
+        const out = num(tokenUsage.completionTokens ?? tokenUsage.completion_tokens ?? tokenUsage.output_tokens);
+        const cdetails = (tokenUsage.completion_tokens_details ??
+            tokenUsage.completionTokensDetails ??
+            {});
+        const reasoning = num(cdetails.reasoning_tokens ?? cdetails.reasoningTokens);
+        const pdetails = (tokenUsage.prompt_tokens_details ??
+            tokenUsage.promptTokensDetails ??
+            {});
+        const cached = num(pdetails.cached_tokens ?? pdetails.cachedTokens);
+        return new Usage({
+            inputTokens: inp,
+            outputTokens: out,
+            cachedTokens: cached,
+            reasoningTokens: reasoning,
+        });
+    }
+    return null;
+}
+/**
+ * Map LangChain's `usage_metadata` to {@link Usage}. LangChain already reports `input_tokens`
+ * *including* the cached read (`cached ⊆ input`, the same convention cendor normalizes to), so no
+ * folding is needed. Reasoning is under `output_token_details.reasoning`; cache read/creation under
+ * `input_token_details`.
+ */
+function usageFromMetadata(meta) {
+    return new Usage({
+        inputTokens: num(meta.input_tokens),
+        outputTokens: num(meta.output_tokens),
+        cachedTokens: num(meta.input_token_details?.cache_read),
+        reasoningTokens: num(meta.output_token_details?.reasoning),
+        cacheWrite: num(meta.input_token_details?.cache_creation),
+    });
+}
+/** Read the model id from `llmOutput` or a generation message's `response_metadata`. */
+function modelFromResult(result) {
+    const llmOutput = (result.llmOutput ?? {});
+    const direct = llmOutput.model_name ?? llmOutput.modelName ?? llmOutput.model;
+    if (direct)
+        return String(direct);
+    for (const gens of result.generations ?? []) {
+        for (const gen of gens) {
+            const meta = gen.message?.response_metadata ?? {};
+            const m = meta.model_name ?? meta.model;
+            if (m)
+                return String(m);
+        }
+    }
+    return '';
+}
+/** Price the call offline from the bundled snapshot; unknown model ⇒ `cost` stays `null`. */
+function setCost(call, usage) {
+    if (usage === null)
+        return;
+    try {
+        call.cost = prices.estimate(call.model, usage.inputTokens, {
+            outputTokens: usage.outputTokens,
+            cachedTokens: usage.cachedTokens,
+            cacheWriteTokens: usage.cacheWrite,
+        });
+        call.metadata.cost_estimated = true;
+    }
+    catch (err) {
+        if (err instanceof prices.UnknownModelError) {
+            call.cost = null;
+        }
+        else {
+            throw err;
+        }
+    }
+}
+/** LangChain's serialized tool descriptor carries a `name`; default when absent. */
+function serializedName(tool) {
+    const name = tool?.name;
+    return typeof name === 'string' ? name : undefined;
+}
+/** The message of an error, mirroring Python's `str(exc)`. */
+function errorMessage(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+//# sourceMappingURL=langchain.js.map

package/dist/langchain.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cendor/core",
-  "version": "0.3.2",
+  "version": "0.4.0",
   "description": "Wrap your LLM client once and capture exact token counts and cost on every call — the shared foundation the other Cendor tools build on.",
   "type": "module",
   "license": "Apache-2.0",
@@ -10,11 +10,17 @@
     ".": {
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
+    },
+    "./langchain": {
+      "types": "./dist/langchain.d.ts",
+      "default": "./dist/langchain.js"
     }
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "LICENSE",
+    "NOTICE"
   ],
   "sideEffects": false,
   "engines": {
@@ -25,9 +31,13 @@
     "js-tiktoken": "^1.0.15"
   },
   "peerDependencies": {
+    "@langchain/core": ">=0.3",
     "@opentelemetry/api": ">=1"
   },
   "peerDependenciesMeta": {
+    "@langchain/core": {
+      "optional": true
+    },
     "@opentelemetry/api": {
       "optional": true
     }
@@ -46,7 +56,14 @@
     "url": "git+https://github.com/cendorhq/cendor-libs-js.git",
     "directory": "packages/core"
   },
+  "homepage": "https://cendor.ai/docs/core",
+  "bugs": {
+    "url": "https://github.com/cendorhq/cendor-libs-js/issues"
+  },
   "publishConfig": {
     "access": "public"
+  },
+  "devDependencies": {
+    "@langchain/core": "^1.2.1"
   }
 }