@compresr/sdk 1.3.2 → 1.5.1

package/dist/cjs/integrations/langchain/wrappers.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.wrapToolWithCompression = wrapToolWithCompression;
+exports.compressToolOutput = compressToolOutput;
+/**
+ * Tool-output wrappers for LangChain.js.
+ *
+ * Mirrors Python `wrap_tool_with_compression`. Works without `createAgent`
+ * middleware — wrap any tool and call it directly in LCEL chains or
+ * LangGraph custom graphs.
+ *
+ * For `latte_v1` the unified Compresr query API applies (see middleware).
+ */
+const tools_1 = require("@langchain/core/tools");
+const index_js_1 = require("../_shared/index.js");
+function isWrappableTool(t) {
+    if (typeof t !== 'object' || t === null)
+        return false;
+    const x = t;
+    return (typeof x.name === 'string' &&
+        (typeof x.func === 'function' ||
+            typeof x._call === 'function' ||
+            typeof x.invoke === 'function'));
+}
+/**
+ * Wrap a structured tool so its string output is compressed transparently.
+ *
+ * The wrapped tool preserves the original `name`, `description`, and schema.
+ * Accepts any tool that exposes `name` + (`func` | `_call` | `invoke`) — i.e.
+ * what the `tool()` factory and `StructuredTool` subclasses produce.
+ */
+function wrapToolWithCompression(tool, options = {}) {
+    if (!isWrappableTool(tool)) {
+        throw new TypeError('wrapToolWithCompression supports structured tools (with `name` + ' +
+            '`func`/`_call`/`invoke`). Use the `tool()` factory from @langchain/core.');
+    }
+    const { apiKey, client, baseUrl, compressionModel = index_js_1.DEFAULT_MODEL, targetCompressionRatio = index_js_1.DEFAULT_RATIO, minTokens = index_js_1.DEFAULT_MIN_TOKENS, coarse, query, queryExtractor, queryArg, onError = index_js_1.DEFAULT_POLICY, } = options;
+    const compresr = client ?? (0, index_js_1.buildClient)({ apiKey, baseUrl, caller: 'wrapToolWithCompression' });
+    function resolveTheQuery(args) {
+        return (0, index_js_1.resolveQuery)({
+            staticQuery: query,
+            extractor: queryExtractor
+                ? (arg) => queryExtractor(arg)
+                : undefined,
+            extractorArg: queryExtractor ? args : undefined,
+            args,
+            argsKey: queryArg,
+        });
+    }
+    const t = tool;
+    const innerCall = pickCallable(t, tool);
+    const wrappedFunc = async (args) => {
+        const out = await innerCall(args);
+        if (typeof out !== 'string')
+            return out;
+        const q = resolveTheQuery(args);
+        return (0, index_js_1.compressSafe)(compresr, {
+            context: out,
+            ...(q !== undefined ? { query: q } : {}),
+            compressionModel,
+            targetCompressionRatio,
+            ...(coarse !== undefined ? { coarse } : {}),
+            minTokens,
+            onError,
+            contextLabel: `tool:${t.name}`,
+        });
+    };
+    const cfg = { name: t.name };
+    if (t.description !== undefined)
+        cfg.description = t.description;
+    if (t.schema !== undefined)
+        cfg.schema = t.schema;
+    return tools_1.tool(wrappedFunc, cfg);
+}
+function pickCallable(meta, tool) {
+    if (typeof meta.func === 'function')
+        return meta.func.bind(tool);
+    if (typeof meta._call === 'function')
+        return meta._call.bind(tool);
+    if (typeof meta.invoke === 'function')
+        return meta.invoke.bind(tool);
+    throw new TypeError(`Tool '${meta.name}' has no callable surface.`);
+}
+/** Decorator-style helper — for users who prefer function composition. */
+function compressToolOutput(options = {}) {
+    return (tool) => wrapToolWithCompression(tool, options);
+}
+//# sourceMappingURL=wrappers.js.map

package/dist/cjs/integrations/langchain/wrappers.js.map

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

package/dist/cjs/integrations/langgraph/checkpoint.d.ts

@@ -0,0 +1,49 @@
+/**
+ * `CompresrCheckpointSerializer` — compresses long string fields before
+ * they hit the checkpoint store.
+ *
+ * Lossy by design: there is no decompression — compressed strings persist
+ * in storage and flow back into state on resume. Use `fields` to restrict
+ * compression to known-large keys.
+ */
+import type { CompressionClient } from '../../clients/compression.js';
+import { type ErrorPolicy } from '../_shared/index.js';
+export interface CompresrCheckpointSerializerOptions {
+    apiKey?: string;
+    client?: CompressionClient;
+    baseUrl?: string;
+    compressionModel?: string;
+    /**
+     * Query passed to `latte_v1`. If unset, the field name (e.g. `retrieved_text`)
+     * is used as the query — a reasonable hint for what the value represents.
+     */
+    query?: string;
+    targetCompressionRatio?: number;
+    minTokens?: number;
+    coarse?: boolean;
+    fields?: ReadonlySet<string>;
+    onError?: ErrorPolicy;
+}
+/**
+ * Drop-in for LangGraph.js checkpoint serializers. Calls
+ * `dumpsTyped(obj) → [tag, bytes]`; recursively rewrites long strings
+ * into a `{ __compresr__: true, v: <compressed> }` sentinel before
+ * JSON-encoding. `loadsTyped` returns the payload as-is (sentinels and all).
+ */
+export declare class CompresrCheckpointSerializer {
+    private readonly compresr;
+    private readonly compressionModel;
+    private readonly query;
+    private readonly targetCompressionRatio;
+    private readonly minTokens;
+    private readonly coarse;
+    private readonly fields;
+    private readonly onError;
+    constructor(options: CompresrCheckpointSerializerOptions);
+    dumpsTyped(obj: unknown): Promise<[string, Uint8Array]>;
+    loadsTyped([_tag, bytes]: [string, Uint8Array]): unknown;
+    private walkCompress;
+    private shouldCompress;
+    private wrapCompressed;
+}
+//# sourceMappingURL=checkpoint.d.ts.map

package/dist/cjs/integrations/langgraph/checkpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint.d.ts","sourceRoot":"","sources":["../../../../src/integrations/langgraph/checkpoint.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EAML,KAAK,WAAW,EAEjB,MAAM,qBAAqB,CAAC;AAI7B,MAAM,WAAW,mCAAmC;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC7B,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAED;;;;;GAKG;AACH,qBAAa,4BAA4B;IACvC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoB;IAC7C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAC3C,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAS;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkC;IACzD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;gBAE1B,OAAO,EAAE,mCAAmC;IAyBlD,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAM7D,UAAU,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,OAAO;YAI1C,YAAY;IAmB1B,OAAO,CAAC,cAAc;YAOR,cAAc;CAc7B"}

package/dist/cjs/integrations/langgraph/checkpoint.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CompresrCheckpointSerializer = void 0;
+const index_js_1 = require("../_shared/index.js");
+const SENTINEL_KEY = '__compresr__';
+/**
+ * Drop-in for LangGraph.js checkpoint serializers. Calls
+ * `dumpsTyped(obj) → [tag, bytes]`; recursively rewrites long strings
+ * into a `{ __compresr__: true, v: <compressed> }` sentinel before
+ * JSON-encoding. `loadsTyped` returns the payload as-is (sentinels and all).
+ */
+class CompresrCheckpointSerializer {
+    compresr;
+    compressionModel;
+    query;
+    targetCompressionRatio;
+    minTokens;
+    coarse;
+    fields;
+    onError;
+    constructor(options) {
+        const { apiKey, client, baseUrl, compressionModel = index_js_1.DEFAULT_MODEL, query, targetCompressionRatio = index_js_1.DEFAULT_RATIO, minTokens = 500, coarse, fields, onError = index_js_1.DEFAULT_POLICY, } = options;
+        this.compresr =
+            client ?? (0, index_js_1.buildClient)({ apiKey, baseUrl, caller: 'CompresrCheckpointSerializer' });
+        this.compressionModel = compressionModel;
+        this.query = query;
+        this.targetCompressionRatio = targetCompressionRatio;
+        this.minTokens = Math.max(1, minTokens);
+        this.coarse = coarse;
+        this.fields = fields;
+        this.onError = onError;
+    }
+    async dumpsTyped(obj) {
+        const transformed = await this.walkCompress(obj, undefined);
+        const encoded = new TextEncoder().encode(JSON.stringify(transformed));
+        return ['json', encoded];
+    }
+    loadsTyped([_tag, bytes]) {
+        return JSON.parse(new TextDecoder().decode(bytes));
+    }
+    async walkCompress(value, parentKey) {
+        if (typeof value === 'string') {
+            if (!this.shouldCompress(value, parentKey))
+                return value;
+            return await this.wrapCompressed(value, parentKey);
+        }
+        if (Array.isArray(value)) {
+            return Promise.all(value.map((v) => this.walkCompress(v, parentKey)));
+        }
+        if (value !== null && typeof value === 'object') {
+            const entries = await Promise.all(Object.entries(value).map(async ([k, v]) => [k, await this.walkCompress(v, k)]));
+            return Object.fromEntries(entries);
+        }
+        return value;
+    }
+    shouldCompress(text, parentKey) {
+        if (this.fields !== undefined && (parentKey === undefined || !this.fields.has(parentKey))) {
+            return false;
+        }
+        return (0, index_js_1.estimateTokens)(text) >= this.minTokens;
+    }
+    async wrapCompressed(text, parentKey) {
+        const compressed = await (0, index_js_1.compressSafe)(this.compresr, {
+            context: text,
+            query: this.query ?? parentKey ?? 'stored content',
+            compressionModel: this.compressionModel,
+            targetCompressionRatio: this.targetCompressionRatio,
+            ...(this.coarse !== undefined ? { coarse: this.coarse } : {}),
+            minTokens: 1,
+            onError: this.onError,
+            contextLabel: `checkpoint:${parentKey ?? '?'}`,
+        });
+        if (compressed === text)
+            return text;
+        return { [SENTINEL_KEY]: true, v: compressed };
+    }
+}
+exports.CompresrCheckpointSerializer = CompresrCheckpointSerializer;
+//# sourceMappingURL=checkpoint.js.map

package/dist/cjs/integrations/langgraph/checkpoint.js.map

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

package/dist/cjs/integrations/langgraph/handoff.d.ts

@@ -0,0 +1,44 @@
+import { Command } from '@langchain/langgraph';
+import { z } from 'zod';
+import type { CompressionClient } from '../../clients/compression.js';
+import { type ErrorPolicy } from '../_shared/index.js';
+export interface CompresrHandoffToolOptions {
+    description?: string;
+    apiKey?: string;
+    client?: CompressionClient;
+    baseUrl?: string;
+    compressionModel?: string;
+    targetCompressionRatio?: number;
+    minTokens?: number;
+    coarse?: boolean;
+    onError?: ErrorPolicy;
+}
+/**
+ * Build a handoff tool for `agentName`.
+ *
+ * @example
+ * const supervisor = createAgent({
+ *   model,
+ *   tools: [
+ *     compresrHandoffTool('researcher', { apiKey: process.env.COMPRESR_API_KEY }),
+ *     compresrHandoffTool('writer',     { apiKey: process.env.COMPRESR_API_KEY }),
+ *   ],
+ * });
+ */
+export declare function compresrHandoffTool(agentName: string, options?: CompresrHandoffToolOptions): import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+    task_description: z.ZodString;
+    context: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    context: string;
+    task_description: string;
+}, {
+    task_description: string;
+    context?: string | undefined;
+}>, {
+    task_description: string;
+    context?: string;
+}, {
+    task_description: string;
+    context?: string | undefined;
+}, Command<unknown, Record<string, unknown>, string>, unknown, string>;
+//# sourceMappingURL=handoff.d.ts.map

package/dist/cjs/integrations/langgraph/handoff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoff.d.ts","sourceRoot":"","sources":["../../../../src/integrations/langgraph/handoff.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EAOL,KAAK,WAAW,EACjB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,0BAA0B;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,0BAA+B;;;;;;;;;;sBA6C9D,MAAM;cAAY,MAAM;;;;uEAyCxD"}

package/dist/cjs/integrations/langgraph/handoff.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compresrHandoffTool = compresrHandoffTool;
+/**
+ * `compresrHandoffTool` — supervisor → subagent handoff tool with
+ * compression baked in for LangGraph.js multi-agent systems.
+ *
+ * Returns a LangChain `DynamicStructuredTool` that emits a `Command`
+ * routing control to `agentName` with a compressed `task_description`
+ * and (optionally) compressed `context` field.
+ */
+const messages_1 = require("@langchain/core/messages");
+const tools_1 = require("@langchain/core/tools");
+const langgraph_1 = require("@langchain/langgraph");
+const zod_1 = require("zod");
+const index_js_1 = require("../_shared/index.js");
+/**
+ * Build a handoff tool for `agentName`.
+ *
+ * @example
+ * const supervisor = createAgent({
+ *   model,
+ *   tools: [
+ *     compresrHandoffTool('researcher', { apiKey: process.env.COMPRESR_API_KEY }),
+ *     compresrHandoffTool('writer',     { apiKey: process.env.COMPRESR_API_KEY }),
+ *   ],
+ * });
+ */
+function compresrHandoffTool(agentName, options = {}) {
+    const { description, apiKey, client, baseUrl, compressionModel = index_js_1.DEFAULT_MODEL, targetCompressionRatio = index_js_1.DEFAULT_RATIO, minTokens = index_js_1.DEFAULT_MIN_TOKENS, coarse, onError = index_js_1.DEFAULT_POLICY, } = options;
+    const compresr = client ?? (0, index_js_1.buildClient)({ apiKey, baseUrl, caller: 'compresrHandoffTool' });
+    const toolName = `transfer_to_${agentName}`;
+    const toolDescription = description ??
+        `Hand off the task to the \`${agentName}\` agent. ` +
+            'Provide a clear task_description and any context the agent needs.';
+    const schema = zod_1.z.object({
+        task_description: zod_1.z.string().describe(`Task description for the ${agentName} agent.`),
+        context: zod_1.z
+            .string()
+            .optional()
+            .default('')
+            .describe('Optional context excerpts to share with the agent.'),
+    });
+    async function maybeCompress(text, query, label) {
+        if (!text)
+            return text;
+        return await (0, index_js_1.compressSafe)(compresr, {
+            context: text,
+            query,
+            compressionModel,
+            targetCompressionRatio,
+            ...(coarse !== undefined ? { coarse } : {}),
+            minTokens,
+            onError,
+            contextLabel: label,
+        });
+    }
+    return (0, tools_1.tool)(async (input, runtime) => {
+        // latte_v1 requires a query — the task description itself is the natural
+        // one for the context excerpt (what the subagent will do with it).
+        const compressedTask = await maybeCompress(input.task_description, `task for ${agentName}`, 'handoff:task');
+        const ctx = input.context ?? '';
+        const compressedCtx = ctx
+            ? await maybeCompress(ctx, input.task_description || `context for ${agentName}`, 'handoff:context')
+            : '';
+        const ack = new messages_1.ToolMessage({
+            content: `Successfully transferred to ${agentName}.`,
+            tool_call_id: runtime.toolCallId ?? '',
+            name: toolName,
+        });
+        return new langgraph_1.Command({
+            goto: agentName,
+            update: {
+                messages: [ack],
+                task_description: compressedTask,
+                context: compressedCtx,
+            },
+            graph: langgraph_1.Command.PARENT,
+        });
+    }, {
+        name: toolName,
+        description: toolDescription,
+        schema,
+    });
+}
+//# sourceMappingURL=handoff.js.map

package/dist/cjs/integrations/langgraph/handoff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoff.js","sourceRoot":"","sources":["../../../../src/integrations/langgraph/handoff.ts"],"names":[],"mappings":";;AAgDA,kDAsFC;AAtID;;;;;;;GAOG;AACH,uDAAuD;AACvD,iDAA+D;AAC/D,oDAA+C;AAC/C,6BAAwB;AAGxB,kDAQ6B;AAc7B;;;;;;;;;;;GAWG;AACH,SAAgB,mBAAmB,CAAC,SAAiB,EAAE,UAAsC,EAAE;IAC7F,MAAM,EACJ,WAAW,EACX,MAAM,EACN,MAAM,EACN,OAAO,EACP,gBAAgB,GAAG,wBAAa,EAChC,sBAAsB,GAAG,wBAAa,EACtC,SAAS,GAAG,6BAAkB,EAC9B,MAAM,EACN,OAAO,GAAG,yBAAc,GACzB,GAAG,OAAO,CAAC;IAEZ,MAAM,QAAQ,GAAG,MAAM,IAAI,IAAA,sBAAW,EAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC,CAAC;IAC3F,MAAM,QAAQ,GAAG,eAAe,SAAS,EAAE,CAAC;IAC5C,MAAM,eAAe,GACnB,WAAW;QACX,8BAA8B,SAAS,YAAY;YACjD,mEAAmE,CAAC;IAExE,MAAM,MAAM,GAAG,OAAC,CAAC,MAAM,CAAC;QACtB,gBAAgB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4BAA4B,SAAS,SAAS,CAAC;QACrF,OAAO,EAAE,OAAC;aACP,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,OAAO,CAAC,EAAE,CAAC;aACX,QAAQ,CAAC,oDAAoD,CAAC;KAClE,CAAC,CAAC;IAEH,KAAK,UAAU,aAAa,CAAC,IAAY,EAAE,KAAa,EAAE,KAAa;QACrE,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC;QACvB,OAAO,MAAM,IAAA,uBAAY,EAAC,QAAQ,EAAE;YAClC,OAAO,EAAE,IAAI;YACb,KAAK;YACL,gBAAgB;YAChB,sBAAsB;YACtB,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3C,SAAS;YACT,OAAO;YACP,YAAY,EAAE,KAAK;SACpB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,IAAA,YAAI,EACT,KAAK,EACH,KAAqD,EACrD,OAAoB,EACF,EAAE;QACpB,yEAAyE;QACzE,mEAAmE;QACnE,MAAM,cAAc,GAAG,MAAM,aAAa,CACxC,KAAK,CAAC,gBAAgB,EACtB,YAAY,SAAS,EAAE,EACvB,cAAc,CACf,CAAC;QACF,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC;QAChC,MAAM,aAAa,GAAG,GAAG;YACvB,CAAC,CAAC,MAAM,aAAa,CACjB,GAAG,EACH,KAAK,CAAC,gBAAgB,IAAI,eAAe,SAAS,EAAE,EACpD,iBAAiB,CAClB;YACH,CAAC,CAAC,EAAE,CAAC;QAEP,MAAM,GAAG,GAAG,IAAI,sBAAW,CAAC;YAC1B,OAAO,EAAE,+BAA+B,SAAS,GAAG;YACpD,YAAY,EAAE,OAAO,CAAC,UAAU,IAAI,EAAE;YACtC,IAAI,EAAE,QAAQ;SACf,CAAC,CAAC;QAEH,OAAO,IAAI,mBAAO,CAAC;YACjB,IAAI,EAAE,SAAS;YACf,MAAM,EAAE;gBACN,QAAQ,EAAE,CAAC,GAAG,CAAC;gBACf,gBAAgB,EAAE,cAAc;gBAChC,OAAO,EAAE,aAAa;aACvB;YACD,KAAK,EAAE,mBAAO,CAAC,MAAM;SACtB,CAAC,CAAC;IACL,CAAC,EACD;QACE,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,eAAe;QAC5B,MAAM;KACP,CACF,CAAC;AACJ,CAAC"}

package/dist/cjs/integrations/langgraph/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * LangGraph.js integration for Compresr.
+ *
+ *     npm install @langchain/langgraph @langchain/core   # (peers)
+ *
+ * LangGraph 1.0+ uses the same middleware mechanism as LangChain's
+ * `createAgent`. Both middlewares below are re-exported from
+ * `@compresr/sdk/integrations/langchain` so they're discoverable here
+ * too — import either path you prefer.
+ */
+export { compresrToolMiddleware, compresrSummarizationMiddleware, compresrPromptMiddleware, type CompresrMiddleware, type CompresrToolMiddlewareOptions, type CompresrSummarizationMiddlewareOptions, type CompresrPromptMiddlewareOptions, } from '../langchain/middleware.js';
+export { makeCompresrNode, type MakeCompresrNodeOptions } from './nodes.js';
+export { makeCompresrNode as compresrNode } from './nodes.js';
+export { CompresrCheckpointSerializer, type CompresrCheckpointSerializerOptions, } from './checkpoint.js';
+export { compresrHandoffTool, type CompresrHandoffToolOptions } from './handoff.js';
+export { CompresrStore, type CompresrStoreOptions } from './store.js';
+export type { ErrorPolicy } from '../_shared/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/integrations/langgraph/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/integrations/langgraph/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EACL,sBAAsB,EACtB,+BAA+B,EAC/B,wBAAwB,EACxB,KAAK,kBAAkB,EACvB,KAAK,6BAA6B,EAClC,KAAK,sCAAsC,EAC3C,KAAK,+BAA+B,GACrC,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAC5E,OAAO,EAAE,gBAAgB,IAAI,YAAY,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EACL,4BAA4B,EAC5B,KAAK,mCAAmC,GACzC,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,mBAAmB,EAAE,KAAK,0BAA0B,EAAE,MAAM,cAAc,CAAC;AACpF,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEtE,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/cjs/integrations/langgraph/index.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CompresrStore = exports.compresrHandoffTool = exports.CompresrCheckpointSerializer = exports.compresrNode = exports.makeCompresrNode = exports.compresrPromptMiddleware = exports.compresrSummarizationMiddleware = exports.compresrToolMiddleware = void 0;
+/**
+ * LangGraph.js integration for Compresr.
+ *
+ *     npm install @langchain/langgraph @langchain/core   # (peers)
+ *
+ * LangGraph 1.0+ uses the same middleware mechanism as LangChain's
+ * `createAgent`. Both middlewares below are re-exported from
+ * `@compresr/sdk/integrations/langchain` so they're discoverable here
+ * too — import either path you prefer.
+ */
+var middleware_js_1 = require("../langchain/middleware.js");
+Object.defineProperty(exports, "compresrToolMiddleware", { enumerable: true, get: function () { return middleware_js_1.compresrToolMiddleware; } });
+Object.defineProperty(exports, "compresrSummarizationMiddleware", { enumerable: true, get: function () { return middleware_js_1.compresrSummarizationMiddleware; } });
+Object.defineProperty(exports, "compresrPromptMiddleware", { enumerable: true, get: function () { return middleware_js_1.compresrPromptMiddleware; } });
+var nodes_js_1 = require("./nodes.js");
+Object.defineProperty(exports, "makeCompresrNode", { enumerable: true, get: function () { return nodes_js_1.makeCompresrNode; } });
+var nodes_js_2 = require("./nodes.js");
+Object.defineProperty(exports, "compresrNode", { enumerable: true, get: function () { return nodes_js_2.makeCompresrNode; } });
+var checkpoint_js_1 = require("./checkpoint.js");
+Object.defineProperty(exports, "CompresrCheckpointSerializer", { enumerable: true, get: function () { return checkpoint_js_1.CompresrCheckpointSerializer; } });
+var handoff_js_1 = require("./handoff.js");
+Object.defineProperty(exports, "compresrHandoffTool", { enumerable: true, get: function () { return handoff_js_1.compresrHandoffTool; } });
+var store_js_1 = require("./store.js");
+Object.defineProperty(exports, "CompresrStore", { enumerable: true, get: function () { return store_js_1.CompresrStore; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/integrations/langgraph/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/integrations/langgraph/index.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;GASG;AACH,4DAQoC;AAPlC,uHAAA,sBAAsB,OAAA;AACtB,gIAAA,+BAA+B,OAAA;AAC/B,yHAAA,wBAAwB,OAAA;AAO1B,uCAA4E;AAAnE,4GAAA,gBAAgB,OAAA;AACzB,uCAA8D;AAArD,wGAAA,gBAAgB,OAAgB;AACzC,iDAGyB;AAFvB,6HAAA,4BAA4B,OAAA;AAG9B,2CAAoF;AAA3E,iHAAA,mBAAmB,OAAA;AAC5B,uCAAsE;AAA7D,yGAAA,aAAa,OAAA"}

package/dist/cjs/integrations/langgraph/nodes.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Drop-in compression node for a custom `StateGraph`.
+ *
+ * Mirrors Python `make_compresr_node`. Reads a string field from state,
+ * compresses it, writes back. Same unified query API.
+ */
+import type { CompressionClient } from '../../clients/compression.js';
+import { type ErrorPolicy } from '../_shared/index.js';
+export interface MakeCompresrNodeOptions<S extends Record<string, unknown>> {
+    apiKey?: string;
+    client?: CompressionClient;
+    baseUrl?: string;
+    /** State key holding the text to compress. Required. */
+    contextKey: keyof S & string;
+    compressionModel?: string;
+    targetCompressionRatio?: number;
+    minTokens?: number;
+    coarse?: boolean;
+    /** Static query (latte_v1 only). */
+    query?: string;
+    /** State key holding the query string. */
+    queryKey?: keyof S & string;
+    /** Custom extractor over state. Highest priority after `query`. */
+    queryExtractor?: (state: S) => string | undefined;
+    onError?: ErrorPolicy;
+}
+/**
+ * Build a state-graph node that compresses `state[contextKey]`.
+ *
+ * Returns an async function `(state) => Partial<State>` compatible with
+ * `graph.addNode("compress", node)` in LangGraph.js.
+ */
+export declare function makeCompresrNode<S extends Record<string, unknown>>(options: MakeCompresrNodeOptions<S>): (state: S) => Promise<Partial<S>>;
+//# sourceMappingURL=nodes.d.ts.map

package/dist/cjs/integrations/langgraph/nodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodes.d.ts","sourceRoot":"","sources":["../../../../src/integrations/langgraph/nodes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EAOL,KAAK,WAAW,EAEjB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,uBAAuB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACxE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,UAAU,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC;IAC5B,mEAAmE;IACnE,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,GAAG,SAAS,CAAC;IAClD,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChE,OAAO,EAAE,uBAAuB,CAAC,CAAC,CAAC,GAClC,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CA2DnC"}

package/dist/cjs/integrations/langgraph/nodes.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeCompresrNode = makeCompresrNode;
+const index_js_1 = require("../_shared/index.js");
+/**
+ * Build a state-graph node that compresses `state[contextKey]`.
+ *
+ * Returns an async function `(state) => Partial<State>` compatible with
+ * `graph.addNode("compress", node)` in LangGraph.js.
+ */
+function makeCompresrNode(options) {
+    const { apiKey, client, baseUrl, contextKey, compressionModel = index_js_1.DEFAULT_MODEL, targetCompressionRatio = index_js_1.DEFAULT_RATIO, minTokens = index_js_1.DEFAULT_MIN_TOKENS, coarse, query, queryKey, queryExtractor, onError = index_js_1.DEFAULT_POLICY, } = options;
+    const compresr = client ?? (0, index_js_1.buildClient)({ apiKey, baseUrl, caller: 'makeCompresrNode' });
+    function resolve(state) {
+        let argsDict = null;
+        if (queryKey !== undefined) {
+            const v = state[queryKey];
+            if (typeof v === 'string' && v.trim()) {
+                argsDict = { [queryKey]: v };
+            }
+        }
+        return (0, index_js_1.resolveQuery)({
+            staticQuery: query,
+            extractor: queryExtractor
+                ? (arg) => queryExtractor(arg)
+                : undefined,
+            extractorArg: queryExtractor ? state : undefined,
+            args: argsDict,
+            argsKey: queryKey,
+        });
+    }
+    return async (state) => {
+        const ctx = state[contextKey];
+        if (typeof ctx !== 'string' || !ctx.trim()) {
+            return {};
+        }
+        const q = resolve(state);
+        const compressed = await (0, index_js_1.compressSafe)(compresr, {
+            context: ctx,
+            ...(q !== undefined ? { query: q } : {}),
+            compressionModel,
+            targetCompressionRatio,
+            ...(coarse !== undefined ? { coarse } : {}),
+            minTokens,
+            onError,
+            contextLabel: `node:${String(contextKey)}`,
+        });
+        if (compressed === ctx) {
+            return {};
+        }
+        return { [contextKey]: compressed };
+    };
+}
+//# sourceMappingURL=nodes.js.map

package/dist/cjs/integrations/langgraph/nodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodes.js","sourceRoot":"","sources":["../../../../src/integrations/langgraph/nodes.ts"],"names":[],"mappings":";;AA2CA,4CA6DC;AAjGD,kDAS6B;AAqB7B;;;;;GAKG;AACH,SAAgB,gBAAgB,CAC9B,OAAmC;IAEnC,MAAM,EACJ,MAAM,EACN,MAAM,EACN,OAAO,EACP,UAAU,EACV,gBAAgB,GAAG,wBAAa,EAChC,sBAAsB,GAAG,wBAAa,EACtC,SAAS,GAAG,6BAAkB,EAC9B,MAAM,EACN,KAAK,EACL,QAAQ,EACR,cAAc,EACd,OAAO,GAAG,yBAAc,GACzB,GAAG,OAAO,CAAC;IAEZ,MAAM,QAAQ,GACZ,MAAM,IAAI,IAAA,sBAAW,EAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC,CAAC;IAEzE,SAAS,OAAO,CAAC,KAAQ;QACvB,IAAI,QAAQ,GAAmC,IAAI,CAAC;QACpD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;YAC1B,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;gBACtC,QAAQ,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;YAC/B,CAAC;QACH,CAAC;QACD,OAAO,IAAA,uBAAY,EAAC;YAClB,WAAW,EAAE,KAAK;YAClB,SAAS,EAAE,cAAc;gBACvB,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,cAAc,CAAC,GAAQ,CAAC;gBACnC,CAAC,CAAC,SAAS;YACb,YAAY,EAAE,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;YAChD,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,QAAQ;SAClB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,KAAK,EAAE,KAAQ,EAAE,EAAE;QACxB,MAAM,GAAG,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC;QAC9B,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;YAC3C,OAAO,EAAgB,CAAC;QAC1B,CAAC;QACD,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;QACzB,MAAM,UAAU,GAAG,MAAM,IAAA,uBAAY,EAAC,QAAQ,EAAE;YAC9C,OAAO,EAAE,GAAG;YACZ,GAAG,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxC,gBAAgB;YAChB,sBAAsB;YACtB,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3C,SAAS;YACT,OAAO;YACP,YAAY,EAAE,QAAQ,MAAM,CAAC,UAAU,CAAC,EAAE;SAC3C,CAAC,CAAC;QACH,IAAI,UAAU,KAAK,GAAG,EAAE,CAAC;YACvB,OAAO,EAAgB,CAAC;QAC1B,CAAC;QACD,OAAO,EAAE,CAAC,UAAU,CAAC,EAAE,UAAU,EAAgB,CAAC;IACpD,CAAC,CAAC;AACJ,CAAC"}

package/dist/cjs/integrations/langgraph/store.d.ts

@@ -0,0 +1,76 @@
+/**
+ * `CompresrStore` — wrap a LangGraph.js `BaseStore` so long string fields
+ * are compressed before being persisted to the underlying store.
+ *
+ * Composition over inheritance: holds an inner store and proxies all
+ * methods, intercepting `put` and `batch` to walk the value object and
+ * rewrite strings above `minTokens` in place. Lossy — there is no
+ * decompression on read.
+ */
+import { BaseStore, type Item, type Operation, type OperationResults, type SearchItem } from '@langchain/langgraph-checkpoint';
+import type { CompressionClient } from '../../clients/compression.js';
+import { type ErrorPolicy } from '../_shared/index.js';
+export interface CompresrStoreOptions {
+    apiKey?: string;
+    client?: CompressionClient;
+    baseUrl?: string;
+    compressionModel?: string;
+    /**
+     * Query passed to `latte_v1`. If unset, the field name (e.g. `retrievedText`)
+     * is used as the query.
+     */
+    query?: string;
+    targetCompressionRatio?: number;
+    minTokens?: number;
+    coarse?: boolean;
+    fields?: ReadonlySet<string>;
+    onError?: ErrorPolicy;
+}
+/**
+ * Drop-in `BaseStore` wrapper that compresses string fields on write.
+ *
+ * @example
+ * import { InMemoryStore } from '@langchain/langgraph';
+ * import { CompresrStore } from '@compresr/sdk/integrations/langgraph';
+ *
+ * const store = new CompresrStore(new InMemoryStore(), {
+ *   apiKey: process.env.COMPRESR_API_KEY!,
+ *   fields: new Set(['retrievedText']),
+ *   minTokens: 500,
+ * });
+ */
+export declare class CompresrStore extends BaseStore {
+    private readonly inner;
+    private readonly compresr;
+    private readonly compressionModel;
+    private readonly query;
+    private readonly targetCompressionRatio;
+    private readonly minTokens;
+    private readonly coarse;
+    private readonly fields;
+    private readonly onError;
+    constructor(inner: BaseStore, options?: CompresrStoreOptions);
+    private shouldCompress;
+    private compressValue;
+    private walk;
+    put(namespace: string[], key: string, value: Record<string, unknown>, index?: false | string[]): Promise<void>;
+    batch<Op extends Operation[]>(operations: Op): Promise<OperationResults<Op>>;
+    get(namespace: string[], key: string): Promise<Item | null>;
+    search(namespacePrefix: string[], options?: {
+        filter?: Record<string, unknown>;
+        limit?: number;
+        offset?: number;
+        query?: string;
+    }): Promise<SearchItem[]>;
+    delete(namespace: string[], key: string): Promise<void>;
+    listNamespaces(options?: {
+        prefix?: string[];
+        suffix?: string[];
+        maxDepth?: number;
+        limit?: number;
+        offset?: number;
+    }): Promise<string[][]>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/cjs/integrations/langgraph/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../../src/integrations/langgraph/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EACL,SAAS,EACT,KAAK,IAAI,EACT,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,UAAU,EAChB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EAML,KAAK,WAAW,EAEjB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC7B,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAcD;;;;;;;;;;;;GAYG;AACH,qBAAa,aAAc,SAAQ,SAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoB;IAC7C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAC3C,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAS;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkC;IACzD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;gBAE1B,KAAK,EAAE,SAAS,EAAE,OAAO,GAAE,oBAAyB;IA0BhE,OAAO,CAAC,cAAc;YAOR,aAAa;YAab,IAAI;IAmBZ,GAAG,CACP,SAAS,EAAE,MAAM,EAAE,EACnB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,EAAE,GACvB,OAAO,CAAC,IAAI,CAAC;IAKV,KAAK,CAAC,EAAE,SAAS,SAAS,EAAE,EAAE,UAAU,EAAE,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;IAY5E,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IAI3D,MAAM,CACV,eAAe,EAAE,MAAM,EAAE,EACzB,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAC9F,OAAO,CAAC,UAAU,EAAE,CAAC;IAIlB,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvD,cAAc,CAAC,OAAO,CAAC,EAAE;QAC7B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;IAIjB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAG5B"}