@compresr/sdk 1.3.2 → 1.5.0

package/dist/esm/agents/facades/native.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.js","sourceRoot":"","sources":["../../../../src/agents/facades/native.ts"],"names":[],"mappings":"AAgCA,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,MAAsB,EACtB,OAAyB;IAEzB,MAAM,OAAO,GAAqC;QAChD,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;QACrD,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE;QAC1B,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI;KACrC,CAAC;IACF,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC/D,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAClE,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAClE,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS;QAAE,OAAO,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IACjF,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAC5D,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAC5D,IAAI,OAAO,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;QACxC,OAAO,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAChD,CAAC;IACD,OAAO,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAC7B,CAAC"}

package/dist/esm/agents/facades/openai.d.ts

@@ -0,0 +1,32 @@
+import { CompresrEngine } from '../engine.js';
+import { type ChatCompletion } from '../schemas/openai.js';
+export interface OpenAICompletionsCreateOptions {
+    /**
+     * Optional per-call model. Defaults to the model encoded on the engine's
+     * ``llm`` spec (``'openai:gpt-...'``). If neither is set, the engine throws
+     * ``CompresrError("missing_model")``.
+     */
+    model?: string;
+    messages: ReadonlyArray<unknown>;
+    maxTokens?: number;
+    tools?: ReadonlyArray<unknown>;
+    config?: Record<string, unknown>;
+    temperature?: number;
+    topP?: number;
+    presencePenalty?: number;
+    frequencyPenalty?: number;
+    seed?: number;
+    stop?: string[];
+    logprobs?: boolean;
+    topLogprobs?: number;
+}
+export interface OpenAICompletionsFacade {
+    create(options: OpenAICompletionsCreateOptions): Promise<ChatCompletion>;
+    /** Streaming not yet implemented — throws. */
+    stream(options: OpenAICompletionsCreateOptions): Promise<never>;
+}
+export interface OpenAIChatFacade {
+    completions: OpenAICompletionsFacade;
+}
+export declare function openaiChatCompletions(engine: CompresrEngine): OpenAIChatFacade;
+//# sourceMappingURL=openai.d.ts.map

package/dist/esm/agents/facades/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../../../src/agents/facades/openai.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE7E,MAAM,WAAW,8BAA8B;IAC7C;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAIjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,OAAO,EAAE,8BAA8B,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACzE,8CAA8C;IAC9C,MAAM,CAAC,OAAO,EAAE,8BAA8B,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;CACjE;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,uBAAuB,CAAC;CACtC;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,cAAc,GAAG,gBAAgB,CAsC9E"}

package/dist/esm/agents/facades/openai.js

@@ -0,0 +1,52 @@
+/**
+ * OpenAI-shaped facade — ``client.chat.completions.create(...)``.
+ *
+ * Delegates the actual run to a private :class:`CompresrEngine` and remaps the
+ * returned :class:`NormalizedResult` to an OpenAI ``ChatCompletion`` shape.
+ *
+ * Mirrors Python ``compresr/agents/facades/openai.py``.
+ */
+import { CompresrError } from '../../errors/index.js';
+import { toChatCompletion } from '../schemas/openai.js';
+export function openaiChatCompletions(engine) {
+    const completions = {
+        async create(options) {
+            const runOpts = {
+                messages: options.messages,
+                tools: options.tools ?? [],
+                maxTokens: options.maxTokens ?? 4096,
+            };
+            if (options.model !== undefined)
+                runOpts.model = options.model;
+            if (options.config !== undefined)
+                runOpts.config = options.config;
+            if (options.temperature !== undefined)
+                runOpts.temperature = options.temperature;
+            if (options.topP !== undefined)
+                runOpts.topP = options.topP;
+            if (options.presencePenalty !== undefined) {
+                runOpts.presencePenalty = options.presencePenalty;
+            }
+            if (options.frequencyPenalty !== undefined) {
+                runOpts.frequencyPenalty = options.frequencyPenalty;
+            }
+            if (options.seed !== undefined)
+                runOpts.seed = options.seed;
+            if (options.stop !== undefined)
+                runOpts.stop = options.stop;
+            if (options.logprobs !== undefined)
+                runOpts.logprobs = options.logprobs;
+            if (options.topLogprobs !== undefined) {
+                runOpts.topLogprobs = options.topLogprobs;
+            }
+            const result = await engine.run(runOpts);
+            const responseModel = options.model ?? engine.defaultModelName ?? '';
+            return toChatCompletion(result, { model: responseModel });
+        },
+        stream(_options) {
+            return Promise.reject(new CompresrError('streaming not yet implemented — Phase 2 work item', 'not_implemented'));
+        },
+    };
+    return { completions };
+}
+//# sourceMappingURL=openai.js.map

package/dist/esm/agents/facades/openai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.js","sourceRoot":"","sources":["../../../../src/agents/facades/openai.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,EAAE,gBAAgB,EAAuB,MAAM,sBAAsB,CAAC;AAoC7E,MAAM,UAAU,qBAAqB,CAAC,MAAsB;IAC1D,MAAM,WAAW,GAA4B;QAC3C,KAAK,CAAC,MAAM,CAAC,OAAuC;YAClD,MAAM,OAAO,GAAqC;gBAChD,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE;gBAC1B,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI;aACrC,CAAC;YACF,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS;gBAAE,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;YAC/D,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;gBAAE,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAClE,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS;gBAAE,OAAO,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;YACjF,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;gBAAE,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;YAC5D,IAAI,OAAO,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;gBAC1C,OAAO,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;YACpD,CAAC;YACD,IAAI,OAAO,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;gBAC3C,OAAO,CAAC,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;YACtD,CAAC;YACD,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;gBAAE,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;YAC5D,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;gBAAE,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;YAC5D,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS;gBAAE,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;YACxE,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;gBACtC,OAAO,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;YAC5C,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACzC,MAAM,aAAa,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAAC,gBAAgB,IAAI,EAAE,CAAC;YACrE,OAAO,gBAAgB,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC,CAAC;QAC5D,CAAC;QACD,MAAM,CAAC,QAAwC;YAC7C,OAAO,OAAO,CAAC,MAAM,CACnB,IAAI,aAAa,CACf,mDAAmD,EACnD,iBAAiB,CAClB,CACF,CAAC;QACJ,CAAC;KACF,CAAC;IACF,OAAO,EAAE,WAAW,EAAE,CAAC;AACzB,CAAC"}

package/dist/esm/agents/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Compresr agents — provider-shape facades over LangChain.js.
+ *
+ * Public surface is intentionally minimal. Heavy LangChain imports stay
+ * dynamic so ``import "@compresr/sdk/agents"`` stays cheap when the user
+ * only needs the type names.
+ *
+ *     npm install langchain @langchain/core     # engine peers
+ *     npm install @langchain/anthropic          # for anthropic:...
+ *     npm install @langchain/openai             # for openai:...
+ *     npm install @langchain/google-genai       # for google_genai:...
+ *     npm install @langchain/tavily             # for WebSearchTool.tavily
+ *     npm install @langchain/community          # for WebSearchTool.brave
+ */
+export { CompresrEngine, parseLlmSpec, type CompresrEngineOptions, type CompressionPolicyOptions, type RunOptions, } from './engine.js';
+export { WebSearchTool, createWebSearchTool, type TavilyOptions, type BraveOptions, } from './tools/index.js';
+export { type Citation, type CompresrStats, type NormalizedResult, type NormalizedToolUse, defaultCompresrStats, emptyNormalizedResult, } from './normalized.js';
+export { anthropicMessages, type AnthropicMessagesFacade, type AnthropicMessagesCreateOptions, } from './facades/anthropic.js';
+export { openaiChatCompletions, type OpenAIChatFacade, type OpenAICompletionsFacade, type OpenAICompletionsCreateOptions, } from './facades/openai.js';
+export { nativeRun, type NativeRunOptions } from './facades/native.js';
+export { type AnthropicMessage, type ContentBlock, type TextBlock, type ToolUseBlock, type AnthropicUsage, toAnthropicMessage, } from './schemas/anthropic.js';
+export { type ChatCompletion, type ChatMessage, type Choice, type FunctionCall, type ToolCall, type OpenAIUsage, toChatCompletion, } from './schemas/openai.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/agents/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agents/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EACL,cAAc,EACd,YAAY,EACZ,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,UAAU,GAChB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,KAAK,aAAa,EAClB,KAAK,YAAY,GAClB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,iBAAiB,EACjB,KAAK,uBAAuB,EAC5B,KAAK,8BAA8B,GACpC,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,qBAAqB,EACrB,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,8BAA8B,GACpC,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvE,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,kBAAkB,GACnB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,MAAM,EACX,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,gBAAgB,GACjB,MAAM,qBAAqB,CAAC"}

package/dist/esm/agents/index.js

@@ -0,0 +1,23 @@
+/**
+ * Compresr agents — provider-shape facades over LangChain.js.
+ *
+ * Public surface is intentionally minimal. Heavy LangChain imports stay
+ * dynamic so ``import "@compresr/sdk/agents"`` stays cheap when the user
+ * only needs the type names.
+ *
+ *     npm install langchain @langchain/core     # engine peers
+ *     npm install @langchain/anthropic          # for anthropic:...
+ *     npm install @langchain/openai             # for openai:...
+ *     npm install @langchain/google-genai       # for google_genai:...
+ *     npm install @langchain/tavily             # for WebSearchTool.tavily
+ *     npm install @langchain/community          # for WebSearchTool.brave
+ */
+export { CompresrEngine, parseLlmSpec, } from './engine.js';
+export { WebSearchTool, createWebSearchTool, } from './tools/index.js';
+export { defaultCompresrStats, emptyNormalizedResult, } from './normalized.js';
+export { anthropicMessages, } from './facades/anthropic.js';
+export { openaiChatCompletions, } from './facades/openai.js';
+export { nativeRun } from './facades/native.js';
+export { toAnthropicMessage, } from './schemas/anthropic.js';
+export { toChatCompletion, } from './schemas/openai.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/agents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agents/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EACL,cAAc,EACd,YAAY,GAIb,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,aAAa,EACb,mBAAmB,GAGpB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAKL,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,iBAAiB,GAGlB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,qBAAqB,GAItB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,SAAS,EAAyB,MAAM,qBAAqB,CAAC;AAEvE,OAAO,EAML,kBAAkB,GACnB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAOL,gBAAgB,GACjB,MAAM,qBAAqB,CAAC"}

package/dist/esm/agents/normalized.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Normalized result types used by Wave 2B's provider-shape facades.
+ *
+ * These shapes are intentionally provider-agnostic — every backend (Anthropic,
+ * OpenAI Responses, Gemini grounding) gets remapped into the same
+ * ``NormalizedResult`` by ``CompresrEngine``. Plain interfaces keep the shape
+ * immutable on the type-level and free of runtime overhead.
+ *
+ * Mirrors Python ``compresr/agents/normalized.py``.
+ */
+/**
+ * Aggregate compression stats for a single agent run.
+ *
+ * ``byTool`` maps tool name -> tokens saved. Wave 2A leaves these at
+ * zero; Wave 2B+ will plumb the actual middleware savings.
+ */
+export interface CompresrStats {
+    readonly tokensSaved: number;
+    readonly originalTotal: number;
+    readonly compressedTotal: number;
+    readonly byTool: Readonly<Record<string, number>>;
+}
+export declare function defaultCompresrStats(): CompresrStats;
+/**
+ * A single citation extracted from a provider response.
+ *
+ * Raw provider data is preserved in ``providerMetadata`` so callers
+ * can recover anything the normalizer dropped.
+ */
+export interface Citation {
+    readonly url: string;
+    readonly title?: string;
+    readonly citedText?: string;
+    readonly providerMetadata: Readonly<Record<string, unknown>>;
+}
+/** Normalized tool-use shape — ``{ id, name, input }`` triples. */
+export interface NormalizedToolUse {
+    readonly id?: string;
+    readonly name?: string;
+    readonly input?: Record<string, unknown>;
+}
+/**
+ * Provider-agnostic agent invocation result.
+ *
+ * ``raw`` preserves the original ``AIMessage`` so advanced users can
+ * reach in for fields the normalizer doesn't surface.
+ */
+export interface NormalizedResult {
+    readonly text: string;
+    readonly contentBlocks: ReadonlyArray<unknown>;
+    readonly toolUses: ReadonlyArray<NormalizedToolUse>;
+    readonly citations: ReadonlyArray<Citation>;
+    readonly stopReason: string;
+    readonly usage: Readonly<Record<string, number>>;
+    readonly compresrStats: CompresrStats;
+    readonly raw: unknown;
+}
+export declare function emptyNormalizedResult(): NormalizedResult;
+//# sourceMappingURL=normalized.d.ts.map

package/dist/esm/agents/normalized.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalized.d.ts","sourceRoot":"","sources":["../../../src/agents/normalized.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACnD;AAED,wBAAgB,oBAAoB,IAAI,aAAa,CAOpD;AAED;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC9D;AAED,mEAAmE;AACnE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IAC/C,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAC;IACpD,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC5C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACjD,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;CACvB;AAED,wBAAgB,qBAAqB,IAAI,gBAAgB,CAWxD"}

package/dist/esm/agents/normalized.js

@@ -0,0 +1,31 @@
+/**
+ * Normalized result types used by Wave 2B's provider-shape facades.
+ *
+ * These shapes are intentionally provider-agnostic — every backend (Anthropic,
+ * OpenAI Responses, Gemini grounding) gets remapped into the same
+ * ``NormalizedResult`` by ``CompresrEngine``. Plain interfaces keep the shape
+ * immutable on the type-level and free of runtime overhead.
+ *
+ * Mirrors Python ``compresr/agents/normalized.py``.
+ */
+export function defaultCompresrStats() {
+    return {
+        tokensSaved: 0,
+        originalTotal: 0,
+        compressedTotal: 0,
+        byTool: {},
+    };
+}
+export function emptyNormalizedResult() {
+    return {
+        text: '',
+        contentBlocks: [],
+        toolUses: [],
+        citations: [],
+        stopReason: 'end_turn',
+        usage: {},
+        compresrStats: defaultCompresrStats(),
+        raw: null,
+    };
+}
+//# sourceMappingURL=normalized.js.map

package/dist/esm/agents/normalized.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalized.js","sourceRoot":"","sources":["../../../src/agents/normalized.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAeH,MAAM,UAAU,oBAAoB;IAClC,OAAO;QACL,WAAW,EAAE,CAAC;QACd,aAAa,EAAE,CAAC;QAChB,eAAe,EAAE,CAAC;QAClB,MAAM,EAAE,EAAE;KACX,CAAC;AACJ,CAAC;AAuCD,MAAM,UAAU,qBAAqB;IACnC,OAAO;QACL,IAAI,EAAE,EAAE;QACR,aAAa,EAAE,EAAE;QACjB,QAAQ,EAAE,EAAE;QACZ,SAAS,EAAE,EAAE;QACb,UAAU,EAAE,UAAU;QACtB,KAAK,EAAE,EAAE;QACT,aAAa,EAAE,oBAAoB,EAAE;QACrC,GAAG,EAAE,IAAI;KACV,CAAC;AACJ,CAAC"}

package/dist/esm/agents/schemas/anthropic.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Anthropic ``Message`` look-alike interfaces.
+ *
+ * These duck-type the Anthropic SDK's response shape (``message.content[0].text``,
+ * ``message.usage.input_tokens``, ``message.stop_reason``) so customers can
+ * swap ``CompressionClient`` in for their existing ``Anthropic`` client without
+ * installing the ``@anthropic-ai/sdk`` package or rewriting downstream parsing.
+ *
+ * Mirrors Python ``compresr/agents/schemas/anthropic.py``.
+ */
+import type { Citation, CompresrStats, NormalizedResult } from '../normalized.js';
+export interface TextBlock {
+    readonly type: 'text';
+    readonly text: string;
+    readonly citations: ReadonlyArray<Citation>;
+}
+export interface ToolUseBlock {
+    readonly type: 'tool_use';
+    readonly id: string;
+    readonly name: string;
+    readonly input: Readonly<Record<string, unknown>>;
+}
+export type ContentBlock = TextBlock | ToolUseBlock;
+export interface AnthropicUsage {
+    readonly input_tokens: number;
+    readonly output_tokens: number;
+    readonly cache_read_input_tokens: number;
+    readonly cache_creation_input_tokens: number;
+}
+export interface AnthropicMessage {
+    readonly id: string;
+    readonly role: 'assistant';
+    readonly type: 'message';
+    readonly model: string;
+    readonly content: ReadonlyArray<ContentBlock>;
+    readonly stop_reason: string;
+    readonly usage: AnthropicUsage;
+    readonly compresr: CompresrStats;
+    readonly raw: unknown;
+}
+export interface ToAnthropicMessageOptions {
+    model: string;
+    msgId?: string;
+}
+export declare function toAnthropicMessage(result: NormalizedResult, options: ToAnthropicMessageOptions): AnthropicMessage;
+//# sourceMappingURL=anthropic.d.ts.map

package/dist/esm/agents/schemas/anthropic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../../../src/agents/schemas/anthropic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EACV,QAAQ,EACR,aAAa,EACb,gBAAgB,EACjB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACnD;AAED,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,YAAY,CAAC;AAEpD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;IACzC,QAAQ,CAAC,2BAA2B,EAAE,MAAM,CAAC;CAC9C;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;IAC9C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;CACvB;AAiBD,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,yBAAyB,GACjC,gBAAgB,CAkClB"}

package/dist/esm/agents/schemas/anthropic.js

@@ -0,0 +1,52 @@
+function intOrZero(v) {
+    if (typeof v === 'number' && Number.isFinite(v))
+        return Math.trunc(v);
+    if (typeof v === 'string') {
+        const n = Number(v);
+        if (Number.isFinite(n))
+            return Math.trunc(n);
+    }
+    return 0;
+}
+function deriveId(result, prefix) {
+    const raw = result.raw;
+    if (raw && typeof raw.id === 'string' && raw.id)
+        return raw.id;
+    return `${prefix}generated`;
+}
+export function toAnthropicMessage(result, options) {
+    const blocks = [];
+    if (result.text) {
+        blocks.push({
+            type: 'text',
+            text: result.text,
+            citations: [...result.citations],
+        });
+    }
+    for (const tu of result.toolUses) {
+        blocks.push({
+            type: 'tool_use',
+            id: tu.id ?? '',
+            name: tu.name ?? '',
+            input: { ...(tu.input ?? {}) },
+        });
+    }
+    const u = result.usage;
+    return {
+        id: options.msgId ?? deriveId(result, 'msg_'),
+        role: 'assistant',
+        type: 'message',
+        model: options.model,
+        content: blocks,
+        stop_reason: result.stopReason || 'end_turn',
+        usage: {
+            input_tokens: intOrZero(u['input_tokens']),
+            output_tokens: intOrZero(u['output_tokens']),
+            cache_read_input_tokens: intOrZero(u['cache_read_input_tokens']),
+            cache_creation_input_tokens: intOrZero(u['cache_creation_input_tokens']),
+        },
+        compresr: result.compresrStats,
+        raw: result.raw,
+    };
+}
+//# sourceMappingURL=anthropic.js.map

package/dist/esm/agents/schemas/anthropic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.js","sourceRoot":"","sources":["../../../../src/agents/schemas/anthropic.ts"],"names":[],"mappings":"AAkDA,SAAS,SAAS,CAAC,CAAU;IAC3B,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACtE,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC1B,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,QAAQ,CAAC,MAAwB,EAAE,MAAc;IACxD,MAAM,GAAG,GAAG,MAAM,CAAC,GAA6B,CAAC;IACjD,IAAI,GAAG,IAAI,OAAO,GAAG,CAAC,EAAE,KAAK,QAAQ,IAAI,GAAG,CAAC,EAAE;QAAE,OAAO,GAAG,CAAC,EAAE,CAAC;IAC/D,OAAO,GAAG,MAAM,WAAW,CAAC;AAC9B,CAAC;AAOD,MAAM,UAAU,kBAAkB,CAChC,MAAwB,EACxB,OAAkC;IAElC,MAAM,MAAM,GAAmB,EAAE,CAAC;IAClC,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,SAAS,EAAE,CAAC,GAAG,MAAM,CAAC,SAAS,CAAC;SACjC,CAAC,CAAC;IACL,CAAC;IACD,KAAK,MAAM,EAAE,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACjC,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,UAAU;YAChB,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE;YACf,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,EAAE;YACnB,KAAK,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE;SAC/B,CAAC,CAAC;IACL,CAAC;IACD,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC;IACvB,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,KAAK,IAAI,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAC7C,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,OAAO,EAAE,MAAM;QACf,WAAW,EAAE,MAAM,CAAC,UAAU,IAAI,UAAU;QAC5C,KAAK,EAAE;YACL,YAAY,EAAE,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC;YAC1C,aAAa,EAAE,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;YAC5C,uBAAuB,EAAE,SAAS,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC;YAChE,2BAA2B,EAAE,SAAS,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC;SACzE;QACD,QAAQ,EAAE,MAAM,CAAC,aAAa;QAC9B,GAAG,EAAE,MAAM,CAAC,GAAG;KAChB,CAAC;AACJ,CAAC"}

package/dist/esm/agents/schemas/index.d.ts

@@ -0,0 +1,3 @@
+export { type AnthropicMessage, type AnthropicUsage, type ContentBlock, type TextBlock, type ToolUseBlock, toAnthropicMessage, type ToAnthropicMessageOptions, } from './anthropic.js';
+export { type ChatCompletion, type ChatMessage, type Choice, type FunctionCall, type ToolCall, type OpenAIUsage, toChatCompletion, type ToChatCompletionOptions, } from './openai.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/agents/schemas/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/agents/schemas/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,kBAAkB,EAClB,KAAK,yBAAyB,GAC/B,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,MAAM,EACX,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,gBAAgB,EAChB,KAAK,uBAAuB,GAC7B,MAAM,aAAa,CAAC"}

package/dist/esm/agents/schemas/index.js

@@ -0,0 +1,3 @@
+export { toAnthropicMessage, } from './anthropic.js';
+export { toChatCompletion, } from './openai.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/agents/schemas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/agents/schemas/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,kBAAkB,GAEnB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAOL,gBAAgB,GAEjB,MAAM,aAAa,CAAC"}

package/dist/esm/agents/schemas/openai.d.ts

@@ -0,0 +1,51 @@
+/**
+ * OpenAI ``ChatCompletion`` look-alike interfaces.
+ *
+ * Customers using ``new OpenAI().chat.completions.create(...)`` can swap in
+ * ``new CompressionClient(...).chat.completions.create(...)`` without
+ * installing ``openai`` or rewriting downstream parsing — the return shape
+ * mirrors ``openai.types.chat.ChatCompletion``.
+ *
+ * Mirrors Python ``compresr/agents/schemas/openai.py``.
+ */
+import type { CompresrStats, NormalizedResult } from '../normalized.js';
+export interface FunctionCall {
+    readonly name: string;
+    /** JSON-encoded arguments string, per OpenAI's wire shape. */
+    readonly arguments: string;
+}
+export interface ToolCall {
+    readonly id: string;
+    readonly type: 'function';
+    readonly function: FunctionCall;
+}
+export interface ChatMessage {
+    readonly role: 'assistant';
+    readonly content: string | null;
+    readonly tool_calls: ReadonlyArray<ToolCall>;
+}
+export interface Choice {
+    readonly index: number;
+    readonly message: ChatMessage;
+    readonly finish_reason: string;
+}
+export interface OpenAIUsage {
+    readonly prompt_tokens: number;
+    readonly completion_tokens: number;
+    readonly total_tokens: number;
+}
+export interface ChatCompletion {
+    readonly id: string;
+    readonly object: 'chat.completion';
+    readonly model: string;
+    readonly choices: ReadonlyArray<Choice>;
+    readonly usage: OpenAIUsage;
+    readonly compresr: CompresrStats;
+    readonly raw: unknown;
+}
+export interface ToChatCompletionOptions {
+    model: string;
+    completionId?: string;
+}
+export declare function toChatCompletion(result: NormalizedResult, options: ToChatCompletionOptions): ChatCompletion;
+//# sourceMappingURL=openai.d.ts.map

package/dist/esm/agents/schemas/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../../../src/agents/schemas/openai.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAExE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8DAA8D;IAC9D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;CACjC;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;CACvB;AAyBD,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,uBAAuB,GAC/B,cAAc,CAoChB"}

package/dist/esm/agents/schemas/openai.js

@@ -0,0 +1,57 @@
+const FINISH_REASON_MAP = {
+    end_turn: 'stop',
+    stop_sequence: 'stop',
+    max_tokens: 'length',
+    tool_use: 'tool_calls',
+    pause_turn: 'tool_calls',
+};
+function intOrZero(v) {
+    if (typeof v === 'number' && Number.isFinite(v))
+        return Math.trunc(v);
+    if (typeof v === 'string') {
+        const n = Number(v);
+        if (Number.isFinite(n))
+            return Math.trunc(n);
+    }
+    return 0;
+}
+function deriveId(result, prefix) {
+    const raw = result.raw;
+    if (raw && typeof raw.id === 'string' && raw.id)
+        return raw.id;
+    return `${prefix}generated`;
+}
+export function toChatCompletion(result, options) {
+    const toolCalls = result.toolUses.map((tu) => ({
+        id: tu.id ?? '',
+        type: 'function',
+        function: {
+            name: tu.name ?? '',
+            arguments: JSON.stringify(tu.input ?? {}),
+        },
+    }));
+    const message = {
+        role: 'assistant',
+        content: result.text || null,
+        tool_calls: toolCalls,
+    };
+    const stop = result.stopReason || '';
+    const finishReason = FINISH_REASON_MAP[stop] ?? (stop || 'stop');
+    const u = result.usage;
+    const promptTokens = intOrZero(u['input_tokens'] ?? u['prompt_tokens']);
+    const completionTokens = intOrZero(u['output_tokens'] ?? u['completion_tokens']);
+    return {
+        id: options.completionId ?? deriveId(result, 'chatcmpl-'),
+        object: 'chat.completion',
+        model: options.model,
+        choices: [{ index: 0, message, finish_reason: finishReason }],
+        usage: {
+            prompt_tokens: promptTokens,
+            completion_tokens: completionTokens,
+            total_tokens: promptTokens + completionTokens,
+        },
+        compresr: result.compresrStats,
+        raw: result.raw,
+    };
+}
+//# sourceMappingURL=openai.js.map

package/dist/esm/agents/schemas/openai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.js","sourceRoot":"","sources":["../../../../src/agents/schemas/openai.ts"],"names":[],"mappings":"AAoDA,MAAM,iBAAiB,GAAqC;IAC1D,QAAQ,EAAE,MAAM;IAChB,aAAa,EAAE,MAAM;IACrB,UAAU,EAAE,QAAQ;IACpB,QAAQ,EAAE,YAAY;IACtB,UAAU,EAAE,YAAY;CACzB,CAAC;AAEF,SAAS,SAAS,CAAC,CAAU;IAC3B,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACtE,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC1B,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,QAAQ,CAAC,MAAwB,EAAE,MAAc;IACxD,MAAM,GAAG,GAAG,MAAM,CAAC,GAA6B,CAAC;IACjD,IAAI,GAAG,IAAI,OAAO,GAAG,CAAC,EAAE,KAAK,QAAQ,IAAI,GAAG,CAAC,EAAE;QAAE,OAAO,GAAG,CAAC,EAAE,CAAC;IAC/D,OAAO,GAAG,MAAM,WAAW,CAAC;AAC9B,CAAC;AAOD,MAAM,UAAU,gBAAgB,CAC9B,MAAwB,EACxB,OAAgC;IAEhC,MAAM,SAAS,GAAe,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACzD,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE;QACf,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE;YACR,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,EAAE;YACnB,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC;SAC1C;KACF,CAAC,CAAC,CAAC;IACJ,MAAM,OAAO,GAAgB;QAC3B,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,MAAM,CAAC,IAAI,IAAI,IAAI;QAC5B,UAAU,EAAE,SAAS;KACtB,CAAC;IACF,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC;IACrC,MAAM,YAAY,GAAG,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,MAAM,CAAC,CAAC;IACjE,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC;IACvB,MAAM,YAAY,GAAG,SAAS,CAC5B,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,eAAe,CAAC,CACxC,CAAC;IACF,MAAM,gBAAgB,GAAG,SAAS,CAChC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,mBAAmB,CAAC,CAC7C,CAAC;IACF,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,YAAY,IAAI,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;QACzD,MAAM,EAAE,iBAAiB;QACzB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,CAAC;QAC7D,KAAK,EAAE;YACL,aAAa,EAAE,YAAY;YAC3B,iBAAiB,EAAE,gBAAgB;YACnC,YAAY,EAAE,YAAY,GAAG,gBAAgB;SAC9C;QACD,QAAQ,EAAE,MAAM,CAAC,aAAa;QAC9B,GAAG,EAAE,MAAM,CAAC,GAAG;KAChB,CAAC;AACJ,CAAC"}

package/dist/esm/agents/tools/index.d.ts

@@ -0,0 +1,2 @@
+export { WebSearchTool, createWebSearchTool, type TavilyOptions, type BraveOptions, } from './web-search.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/agents/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/agents/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,KAAK,aAAa,EAClB,KAAK,YAAY,GAClB,MAAM,iBAAiB,CAAC"}

package/dist/esm/agents/tools/index.js

@@ -0,0 +1,2 @@
+export { WebSearchTool, createWebSearchTool, } from './web-search.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/agents/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/agents/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,mBAAmB,GAGpB,MAAM,iBAAiB,CAAC"}

package/dist/esm/agents/tools/web-search.d.ts

@@ -0,0 +1,56 @@
+/**
+ * ``WebSearchTool`` — backed by Tavily or Brave.
+ *
+ * Returns a LangChain.js ``BaseTool`` whose output flows through Compresr's
+ * ``compresrToolMiddleware`` automatically when used with the SDK's engine
+ * (``client.messages.create`` / ``client.chat.completions.create`` /
+ * ``client.run``).
+ *
+ * Provider-native server tools (Anthropic ``web_search_20250305``, OpenAI
+ * ``web_search_preview``, Gemini ``google_search``) are intentionally NOT
+ * supported here — they execute server-side and return opaque/encrypted
+ * content that Compresr cannot read or compress. Use a real search API
+ * (Tavily or Brave) so the result is plaintext we can compress.
+ *
+ * Mirrors Python ``compresr/agents/tools/web_search.py``.
+ */
+import type { StructuredToolInterface } from '@langchain/core/tools';
+/** Public return type for the web-search factories — any tool that satisfies
+ * LangChain.js's ``StructuredToolInterface`` is acceptable. We use the
+ * interface form (not the abstract class) so we avoid generic parameter
+ * gymnastics at the call site. */
+export type WebSearchToolInstance = StructuredToolInterface;
+export interface TavilyOptions {
+    apiKey?: string;
+    maxResults?: number;
+    allowedDomains?: ReadonlyArray<string>;
+    blockedDomains?: ReadonlyArray<string>;
+    /** Additional kwargs forwarded to the underlying LangChain tool. */
+    extra?: Record<string, unknown>;
+}
+export interface BraveOptions {
+    apiKey?: string;
+    maxResults?: number;
+    /** Additional kwargs forwarded to the underlying LangChain tool. */
+    extra?: Record<string, unknown>;
+}
+/**
+ * Factory namespace for web-search tools — pick a provider via
+ * ``WebSearchTool.tavily(...)`` or ``WebSearchTool.brave(...)``.
+ *
+ * Each method returns a LangChain.js ``StructuredToolInterface`` ready to
+ * pass into the engine's ``tools: []`` array. The interface form is used
+ * (instead of the abstract ``StructuredTool`` class) so callers can drop
+ * in any compatible tool implementation without hitting generic-parameter
+ * mismatches.
+ */
+export declare const WebSearchTool: {
+    readonly tavily: (options?: TavilyOptions) => Promise<WebSearchToolInstance>;
+    readonly brave: (options?: BraveOptions) => Promise<WebSearchToolInstance>;
+};
+export type WebSearchTool = typeof WebSearchTool;
+/** Direct factory for the Tavily variant — preferred when ``tools: [...]``
+ * needs a synchronous reference. Returns a promise that resolves to a tool. */
+export declare function createWebSearchTool(provider: 'tavily', options?: TavilyOptions): Promise<WebSearchToolInstance>;
+export declare function createWebSearchTool(provider: 'brave', options?: BraveOptions): Promise<WebSearchToolInstance>;
+//# sourceMappingURL=web-search.d.ts.map

package/dist/esm/agents/tools/web-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-search.d.ts","sourceRoot":"","sources":["../../../../src/agents/tools/web-search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAIrE;;;kCAGkC;AAClC,MAAM,MAAM,qBAAqB,GAAG,uBAAuB,CAAC;AAE5D,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACvC,cAAc,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACvC,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAwFD;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa;gCACR,aAAa,KAAQ,OAAO,CAAC,qBAAqB,CAAC;+BAGpD,YAAY,KAAQ,OAAO,CAAC,qBAAqB,CAAC;CAGzD,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC;AAEjD;+EAC+E;AAC/E,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,qBAAqB,CAAC,CAAC;AAClC,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,OAAO,EACjB,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,qBAAqB,CAAC,CAAC"}