@dawn-ai/langchain 0.2.0 → 0.3.0

package/dist/agent-adapter.d.ts

@@ -4,6 +4,8 @@ import { type BaseMessageLike } from "@langchain/core/messages";
 import type { BaseCheckpointSaver } from "@langchain/langgraph-checkpoint";
 import { type ResolvedStateField } from "./state-adapter.js";
 import { type SubagentResolverResult } from "./subagent-tool-bridge.js";
+import { type ResolvedSummarizationConfig } from "./summarization/index.js";
+import { type OffloadFn } from "./tool-converter.js";
 export type SubagentResolver = (leafName: string) => SubagentResolverResult | undefined;
 export interface DawnToolDefinition {
     readonly description?: string;
@@ -14,6 +16,14 @@ export interface DawnToolDefinition {
     }) => Promise<unknown> | unknown;
     readonly schema?: unknown;
 }
+/**
+ * Test-only escape hatch: reset the materialized-agents cache so the next
+ * harness run creates a fresh LLM instance (e.g. pointing at a new aimock
+ * port). Exported (and re-exported via `@dawn-ai/cli/runtime`) so the
+ * `@dawn-ai/testing` harness can clear the cache on teardown. Not for
+ * production use; the `__`/`ForTests` name marks it internal-by-convention.
+ */
+export declare function __resetMaterializedAgentsForTests(): void;
 export declare function composePromptMessages(systemPrompt: string, promptFragments: readonly PromptFragment[], state: Record<string, unknown>): BaseMessageLike[];
 export declare function materializeAgentGraph(options: {
     readonly checkpointer: BaseCheckpointSaver;
@@ -21,6 +31,7 @@ export declare function materializeAgentGraph(options: {
     readonly tools?: readonly DawnToolDefinition[];
     readonly stateFields?: readonly ResolvedStateField[];
     readonly promptFragments?: readonly PromptFragment[];
+    readonly summarization?: ResolvedSummarizationConfig;
 }): Promise<unknown>;
 export interface AgentStreamChunk {
     readonly type: "token" | "tool_call" | "tool_result" | "interrupt" | "done" | (string & {});
@@ -43,6 +54,7 @@ export interface AgentOptions {
      */
     readonly input: unknown;
     readonly middlewareContext?: Readonly<Record<string, unknown>>;
+    readonly offload?: OffloadFn;
     readonly retry?: RetryConfig;
     readonly routeParamNames: readonly string[];
     readonly signal: AbortSignal;
@@ -66,6 +78,7 @@ export interface AgentOptions {
      * replay.
      */
     readonly threadId?: string;
+    readonly summarization?: ResolvedSummarizationConfig;
 }
 export declare function executeAgent(options: AgentOptions): Promise<unknown>;
 export declare function streamAgent(options: AgentOptions): AsyncGenerator<AgentStreamChunk>;

package/dist/agent-adapter.d.ts.map

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

package/dist/agent-adapter.js

@@ -7,6 +7,7 @@ import { isRetryableError, withRetry } from "./retry.js";
 import { materializeStateSchema } from "./state-adapter.js";
 import { createSubagentStreamContext, } from "./subagent-dispatcher.js";
 import { bridgeSubagentTool } from "./subagent-tool-bridge.js";
+import { buildSummarizationHook } from "./summarization/index.js";
 import { convertToolToLangChain } from "./tool-converter.js";
 function assertAgentLike(entry) {
     if (typeof entry !== "object" ||
@@ -20,7 +21,17 @@ function assertAgentLike(entry) {
 // invoked with the same capability contributions (prompt fragments come from
 // the route directory, which is stable per descriptor). If that assumption
 // changes, the cache key must include a hash of the fragments/transformers.
-const materializedAgents = new WeakMap();
+let materializedAgents = new WeakMap();
+/**
+ * Test-only escape hatch: reset the materialized-agents cache so the next
+ * harness run creates a fresh LLM instance (e.g. pointing at a new aimock
+ * port). Exported (and re-exported via `@dawn-ai/cli/runtime`) so the
+ * `@dawn-ai/testing` harness can clear the cache on teardown. Not for
+ * production use; the `__`/`ForTests` name marks it internal-by-convention.
+ */
+export function __resetMaterializedAgentsForTests() {
+    materializedAgents = new WeakMap();
+}
 export function composePromptMessages(systemPrompt, promptFragments, state) {
     const rendered = promptFragments
         .filter((f) => f.placement === "after_user_prompt")
@@ -30,15 +41,15 @@ export function composePromptMessages(systemPrompt, promptFragments, state) {
     const messages = Array.isArray(state.messages) ? state.messages : [];
     return [{ role: "system", content: composed }, ...messages];
 }
-async function materializeAgent(descriptor, tools, checkpointer, stateFields, middlewareContext, promptFragments, options) {
-    if (!options?.bypassCache) {
+async function materializeAgent(descriptor, tools, checkpointer, opts = {}) {
+    if (!opts.bypassCache) {
         const cached = materializedAgents.get(descriptor);
         if (cached) {
             return cached;
         }
     }
     const { createReactAgent } = await import("@langchain/langgraph/prebuilt");
-    const langchainTools = tools.map((tool) => convertToolToLangChain(tool, middlewareContext));
+    const langchainTools = tools.map((tool) => convertToolToLangChain(tool, opts.middlewareContext, opts.offload));
     const provider = resolveProvider({
         model: descriptor.model,
         ...(descriptor.provider !== undefined ? { provider: descriptor.provider } : {}),
@@ -48,7 +59,7 @@ async function materializeAgent(descriptor, tools, checkpointer, stateFields, mi
         provider,
         ...(descriptor.reasoning ? { reasoning: descriptor.reasoning } : {}),
     });
-    const fragments = promptFragments ?? [];
+    const fragments = opts.promptFragments ?? [];
     const agentOptions = {
         llm,
         tools: langchainTools,
@@ -61,18 +72,33 @@ async function materializeAgent(descriptor, tools, checkpointer, stateFields, mi
         // can replay it. Paired with `config.configurable.thread_id`.
         checkpointer,
     };
-    if (stateFields && stateFields.length > 0) {
-        agentOptions.stateSchema = materializeStateSchema(stateFields);
+    const runningSummaryField = {
+        name: "runningSummary",
+        reducer: "replace",
+        default: undefined,
+    };
+    const effectiveStateFields = opts.summarization
+        ? [...(opts.stateFields ?? []).filter((f) => f.name !== "runningSummary"), runningSummaryField]
+        : (opts.stateFields ?? []);
+    if (effectiveStateFields.length > 0) {
+        agentOptions.stateSchema = materializeStateSchema(effectiveStateFields);
+    }
+    if (opts.summarization) {
+        agentOptions.preModelHook = buildSummarizationHook(opts.summarization);
     }
     // biome-ignore lint/suspicious/noExplicitAny: dynamically-built options don't satisfy strict StateDefinition type
     const compiled = createReactAgent(agentOptions);
-    if (!options?.bypassCache) {
+    if (!opts.bypassCache) {
         materializedAgents.set(descriptor, compiled);
     }
     return compiled;
 }
 export async function materializeAgentGraph(options) {
-    return materializeAgent(options.descriptor, options.tools ?? [], options.checkpointer, options.stateFields, undefined, options.promptFragments);
+    return materializeAgent(options.descriptor, options.tools ?? [], options.checkpointer, {
+        ...(options.stateFields ? { stateFields: options.stateFields } : {}),
+        ...(options.promptFragments ? { promptFragments: options.promptFragments } : {}),
+        ...(options.summarization ? { summarization: options.summarization } : {}),
+    });
 }
 /**
  * LangGraph 1.x's `interrupt()` throws a `GraphInterrupt` from inside the tool
@@ -243,7 +269,14 @@ export async function* streamAgent(options) {
         // Bypass the per-descriptor cache when a resolver is wired: the bridged
         // tool closes over the per-call queue + parent config, so caching would
         // bind those to a single call.
-        const materializedAgent = await materializeAgent(options.entry, effectiveTools, options.checkpointer, options.stateFields, options.middlewareContext, options.promptFragments, resolver && hasTaskTool ? { bypassCache: true } : undefined);
+        const materializedAgent = await materializeAgent(options.entry, effectiveTools, options.checkpointer, {
+            ...(options.stateFields ? { stateFields: options.stateFields } : {}),
+            ...(options.middlewareContext ? { middlewareContext: options.middlewareContext } : {}),
+            ...(options.promptFragments ? { promptFragments: options.promptFragments } : {}),
+            ...(resolver && hasTaskTool ? { bypassCache: true } : {}),
+            ...(options.offload ? { offload: options.offload } : {}),
+            ...(options.summarization ? { summarization: options.summarization } : {}),
+        });
         const retryConfig = options.entry.retry;
         const runnableInput = isCommandInput ? options.input : { messages };
         yield* streamFromRunnable(materializedAgent, runnableInput, config, retryConfig, options.streamTransformers, subagentEvents, streamContext);
@@ -251,7 +284,7 @@ export async function* streamAgent(options) {
     }
     // Legacy path — raw Runnable with .invoke()
     assertAgentLike(options.entry);
-    const langchainTools = effectiveTools.map((tool) => convertToolToLangChain(tool, options.middlewareContext));
+    const langchainTools = effectiveTools.map((tool) => convertToolToLangChain(tool, options.middlewareContext, options.offload));
     if (langchainTools.length > 0) {
         config.tools = langchainTools;
     }
@@ -347,7 +380,7 @@ async function* streamFromRunnable(runnable, input, config, retryConfig, streamT
                                 type: "tool_call",
                                 data: {
                                     name: event.name,
-                                    input: event.data.chunk ?? event.data.output,
+                                    input: event.data.input ?? event.data.chunk ?? event.data.output,
                                 },
                             };
                             break;

package/dist/chat-model-factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat-model-factory.d.ts","sourceRoot":"","sources":["../src/chat-model-factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAE3E,KAAK,QAAQ,GAAG,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;AAoBvE,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,sBAAsB,EAChC,WAAW,EAAE,MAAM,GAClB,MAAM,CAER;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE;IAC7C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAA;IACzC,QAAQ,CAAC,SAAS,CAAC,EAAE,eAAe,CAAA;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAA;CAC7B,GAAG,OAAO,CAAC,OAAO,CAAC,CA6BnB"}
+{"version":3,"file":"chat-model-factory.d.ts","sourceRoot":"","sources":["../src/chat-model-factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAE3E,KAAK,QAAQ,GAAG,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;AAoBvE,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,sBAAsB,EAChC,WAAW,EAAE,MAAM,GAClB,MAAM,CAER;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE;IAC7C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAA;IACzC,QAAQ,CAAC,SAAS,CAAC,EAAE,eAAe,CAAA;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAA;CAC7B,GAAG,OAAO,CAAC,OAAO,CAAC,CAoCnB"}

package/dist/chat-model-factory.js

@@ -34,6 +34,12 @@ export async function createChatModel(options) {
     if (options.provider === "openai" && options.reasoning?.effort) {
         constructorOptions.reasoningEffort = options.reasoning.effort;
     }
+    if (options.provider === "openai") {
+        const baseURL = process.env.OPENAI_BASE_URL;
+        if (baseURL) {
+            constructorOptions.configuration = { baseURL };
+        }
+    }
     return new Constructor(constructorOptions);
 }
 function isMissingModuleError(error, expectedPackageName) {

package/dist/index.d.ts

@@ -1,10 +1,15 @@
 export type { BuiltInModelProviderId, ModelProviderId } from "@dawn-ai/sdk";
 export { Command } from "@langchain/langgraph";
 export type { AgentStreamChunk, DawnToolDefinition, SubagentResolver, } from "./agent-adapter.js";
-export { executeAgent, materializeAgentGraph, streamAgent, } from "./agent-adapter.js";
+export { __resetMaterializedAgentsForTests, executeAgent, materializeAgentGraph, streamAgent, } from "./agent-adapter.js";
 export { chainAdapter } from "./chain-adapter.js";
 export { createChatModel } from "./chat-model-factory.js";
 export { inferProvider, resolveProvider } from "./model-provider-resolver.js";
+export type { OffloadStoreOptions } from "./offload/offload-store.js";
+export { buildOffloadFileName, OffloadStore } from "./offload/offload-store.js";
+export type { OffloadToolOutputCtx } from "./offload/offload-tool-output.js";
+export { offloadToolOutput } from "./offload/offload-tool-output.js";
+export { buildStub } from "./offload/stub.js";
 export type { RetryOptions } from "./retry.js";
 export { isRetryableError, withRetry } from "./retry.js";
 export { materializeStateSchema } from "./state-adapter.js";
@@ -12,6 +17,8 @@ export type { SubagentEvent, SubagentStreamContext, } from "./subagent-dispatche
 export { createSubagentStreamContext, dispatchSubagent, MAX_SUBAGENT_DEPTH, } from "./subagent-dispatcher.js";
 export type { SubagentResolverResult } from "./subagent-tool-bridge.js";
 export { bridgeSubagentTool } from "./subagent-tool-bridge.js";
+export * from "./summarization/index.js";
+export type { OffloadFn } from "./tool-converter.js";
 export { convertToolToLangChain } from "./tool-converter.js";
 export { executeWithToolLoop } from "./tool-loop.js";
 export type { UnwrappedToolResult } from "./unwrap-tool-result.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAC3E,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAC9C,YAAY,EACV,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,WAAW,GACZ,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AACzD,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAA;AAC7E,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,YAAY,EACV,aAAa,EACb,qBAAqB,GACtB,MAAM,0BAA0B,CAAA;AACjC,OAAO,EACL,2BAA2B,EAC3B,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,0BAA0B,CAAA;AACjC,YAAY,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAA;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AAC9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AACpD,YAAY,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAA;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAC3E,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAC9C,YAAY,EACV,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACL,iCAAiC,EACjC,YAAY,EACZ,qBAAqB,EACrB,WAAW,GACZ,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AACzD,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAA;AAC7E,YAAY,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AACrE,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAC/E,YAAY,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAA;AAC5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAA;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAC7C,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,YAAY,EACV,aAAa,EACb,qBAAqB,GACtB,MAAM,0BAA0B,CAAA;AACjC,OAAO,EACL,2BAA2B,EAC3B,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,0BAA0B,CAAA;AACjC,YAAY,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAA;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AAC9D,cAAc,0BAA0B,CAAA;AACxC,YAAY,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AACpD,YAAY,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAA;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA"}

package/dist/index.js

@@ -1,12 +1,16 @@
 export { Command } from "@langchain/langgraph";
-export { executeAgent, materializeAgentGraph, streamAgent, } from "./agent-adapter.js";
+export { __resetMaterializedAgentsForTests, executeAgent, materializeAgentGraph, streamAgent, } from "./agent-adapter.js";
 export { chainAdapter } from "./chain-adapter.js";
 export { createChatModel } from "./chat-model-factory.js";
 export { inferProvider, resolveProvider } from "./model-provider-resolver.js";
+export { buildOffloadFileName, OffloadStore } from "./offload/offload-store.js";
+export { offloadToolOutput } from "./offload/offload-tool-output.js";
+export { buildStub } from "./offload/stub.js";
 export { isRetryableError, withRetry } from "./retry.js";
 export { materializeStateSchema } from "./state-adapter.js";
 export { createSubagentStreamContext, dispatchSubagent, MAX_SUBAGENT_DEPTH, } from "./subagent-dispatcher.js";
 export { bridgeSubagentTool } from "./subagent-tool-bridge.js";
+export * from "./summarization/index.js";
 export { convertToolToLangChain } from "./tool-converter.js";
 export { executeWithToolLoop } from "./tool-loop.js";
 export { unwrapToolResult } from "./unwrap-tool-result.js";

package/dist/offload/offload-store.d.ts

@@ -0,0 +1,30 @@
+import type { FilesystemBackend } from "@dawn-ai/workspace";
+/**
+ * Deterministic offload filename. Keyed on the tool_call_id when present
+ * (unique per call in production; fixture-controlled in replay tests). Falls
+ * back to a content hash when no id is available — still deterministic and
+ * reproducible, since the caller controls the content.
+ */
+export declare function buildOffloadFileName(toolName: string, content: string, toolCallId?: string): string;
+export interface OffloadStoreOptions {
+    readonly backend: FilesystemBackend;
+    readonly workspaceRoot: string;
+    readonly signal: AbortSignal;
+    readonly maxBytes: number;
+    readonly ttlMs: number;
+    readonly gcThrottleMs: number;
+    /** Injectable clock for tests. Defaults to Date.now. */
+    readonly now?: () => number;
+}
+export declare class OffloadStore {
+    private readonly opts;
+    private lastGcAt;
+    constructor(opts: OffloadStoreOptions);
+    private get ctx();
+    private now;
+    /** Persist full content; returns the workspace-relative path. Runs throttled GC. */
+    write(toolName: string, content: string, toolCallId?: string): Promise<string>;
+    private maybeGc;
+    private safeRemove;
+}
+//# sourceMappingURL=offload-store.d.ts.map

package/dist/offload/offload-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"offload-store.d.ts","sourceRoot":"","sources":["../../src/offload/offload-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAS3D;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,CAOR;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAA;IACnC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,wDAAwD;IACxD,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;CAC5B;AAED,qBAAa,YAAY;IAEX,OAAO,CAAC,QAAQ,CAAC,IAAI;IADjC,OAAO,CAAC,QAAQ,CAAQ;gBACK,IAAI,EAAE,mBAAmB;IAItD,OAAO,KAAK,GAAG,GAEd;IACD,OAAO,CAAC,GAAG;IAIX,oFAAoF;IAC9E,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAWtE,OAAO;YA+CP,UAAU;CAQzB"}

package/dist/offload/offload-store.js

@@ -0,0 +1,105 @@
+import { createHash } from "node:crypto";
+import { join } from "node:path";
+// NOTE: must match the tool-outputs/ predicate in @dawn-ai/core workspace capability readFile.
+const SUBDIR = "tool-outputs";
+function sanitizeSegment(value) {
+    return value.replace(/[^A-Za-z0-9._-]/g, "_");
+}
+/**
+ * Deterministic offload filename. Keyed on the tool_call_id when present
+ * (unique per call in production; fixture-controlled in replay tests). Falls
+ * back to a content hash when no id is available — still deterministic and
+ * reproducible, since the caller controls the content.
+ */
+export function buildOffloadFileName(toolName, content, toolCallId) {
+    const name = sanitizeSegment(toolName);
+    if (toolCallId && toolCallId.length > 0) {
+        return `${name}-${sanitizeSegment(toolCallId)}.txt`;
+    }
+    const hash = createHash("sha256").update(content).digest("hex").slice(0, 16);
+    return `${name}-${hash}.txt`;
+}
+export class OffloadStore {
+    opts;
+    lastGcAt;
+    constructor(opts) {
+        this.opts = opts;
+        this.lastGcAt = (opts.now ?? Date.now)();
+    }
+    get ctx() {
+        return { signal: this.opts.signal, workspaceRoot: this.opts.workspaceRoot };
+    }
+    now() {
+        return (this.opts.now ?? Date.now)();
+    }
+    /** Persist full content; returns the workspace-relative path. Runs throttled GC. */
+    async write(toolName, content, toolCallId) {
+        const fileName = buildOffloadFileName(toolName, content, toolCallId);
+        const relPath = `${SUBDIR}/${fileName}`;
+        const dirAbs = join(this.opts.workspaceRoot, SUBDIR);
+        await this.opts.backend.mkdir?.(dirAbs, this.ctx);
+        const absPath = join(this.opts.workspaceRoot, relPath);
+        await this.opts.backend.writeFile(absPath, content, this.ctx);
+        await this.maybeGc();
+        return relPath;
+    }
+    async maybeGc() {
+        const now = this.now();
+        if (now - this.lastGcAt < this.opts.gcThrottleMs)
+            return;
+        this.lastGcAt = now;
+        const { backend } = this.opts;
+        if (!backend.statFile || !backend.removeFile)
+            return; // GC unsupported by backend
+        const dirAbs = join(this.opts.workspaceRoot, SUBDIR);
+        let names;
+        try {
+            names = await backend.listDir(dirAbs, this.ctx);
+        }
+        catch {
+            return; // dir not created yet / unreadable
+        }
+        const entries = [];
+        for (const name of names) {
+            const abs = join(dirAbs, name);
+            try {
+                const s = await backend.statFile(abs, this.ctx);
+                entries.push({ abs, size: s.size, mtimeMs: s.mtimeMs });
+            }
+            catch {
+                /* skip unstattable */
+            }
+        }
+        // TTL pass
+        const ttlCutoff = now - this.opts.ttlMs;
+        const survivors = [];
+        for (const e of entries) {
+            if (e.mtimeMs < ttlCutoff) {
+                await this.safeRemove(e.abs);
+            }
+            else {
+                survivors.push(e);
+            }
+        }
+        // Size pass: oldest-first until under maxBytes
+        let total = survivors.reduce((sum, e) => sum + e.size, 0);
+        if (total <= this.opts.maxBytes)
+            return;
+        survivors.sort((a, b) => a.mtimeMs - b.mtimeMs);
+        for (const e of survivors) {
+            if (total <= this.opts.maxBytes)
+                break;
+            if (await this.safeRemove(e.abs))
+                total -= e.size;
+        }
+    }
+    async safeRemove(abs) {
+        try {
+            await this.opts.backend.removeFile?.(abs, this.ctx);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}

package/dist/offload/offload-tool-output.d.ts

@@ -0,0 +1,10 @@
+import type { OffloadStore } from "./offload-store.js";
+export interface OffloadToolOutputCtx {
+    readonly toolName: string;
+    readonly thresholdChars: number;
+    readonly previewLines: number;
+    readonly store: Pick<OffloadStore, "write">;
+    readonly toolCallId?: string;
+}
+export declare function offloadToolOutput(content: string, ctx: OffloadToolOutputCtx): Promise<string>;
+//# sourceMappingURL=offload-tool-output.d.ts.map

package/dist/offload/offload-tool-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"offload-tool-output.d.ts","sourceRoot":"","sources":["../../src/offload/offload-tool-output.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAGtD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;IAC3C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAC7B;AAED,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,oBAAoB,GACxB,OAAO,CAAC,MAAM,CAAC,CAcjB"}

package/dist/offload/offload-tool-output.js

@@ -0,0 +1,18 @@
+import { buildStub } from "./stub.js";
+export async function offloadToolOutput(content, ctx) {
+    if (content.length <= ctx.thresholdChars)
+        return content;
+    try {
+        const relPath = await ctx.store.write(ctx.toolName, content, ctx.toolCallId);
+        return buildStub({
+            content,
+            relPath,
+            previewLines: ctx.previewLines,
+            thresholdChars: ctx.thresholdChars,
+        });
+    }
+    catch {
+        // Never break a tool because offloading failed; keep the original content.
+        return content;
+    }
+}

package/dist/offload/stub.d.ts

@@ -0,0 +1,8 @@
+export interface BuildStubArgs {
+    readonly content: string;
+    readonly relPath: string;
+    readonly previewLines: number;
+    readonly thresholdChars: number;
+}
+export declare function buildStub(args: BuildStubArgs): string;
+//# sourceMappingURL=stub.d.ts.map

package/dist/offload/stub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stub.d.ts","sourceRoot":"","sources":["../../src/offload/stub.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;CAChC;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAarD"}

package/dist/offload/stub.js

@@ -0,0 +1,14 @@
+export function buildStub(args) {
+    const lines = args.content.split("\n").slice(0, args.previewLines);
+    const shown = lines.length;
+    const preview = lines.join("\n");
+    const chars = args.content.length.toLocaleString("en-US");
+    const threshold = args.thresholdChars.toLocaleString("en-US");
+    return [
+        `[Tool output offloaded — ${chars} chars exceeded the ${threshold}-char limit.`,
+        `Full output saved to: ${args.relPath}`,
+        `Preview (first ${shown} lines):`,
+        preview,
+        `Read the full output with the readFile tool at the path above.]`,
+    ].join("\n");
+}

package/dist/summarization/hook.d.ts

@@ -0,0 +1,31 @@
+import { type BaseMessage } from "@langchain/core/messages";
+export interface RunningSummary {
+    readonly summary: string;
+    readonly coveredCount: number;
+}
+export type TokenCounter = (text: string) => number | Promise<number>;
+export type SummarizeFn = (args: {
+    readonly messages: readonly BaseMessage[];
+    readonly model: string;
+    readonly previousSummary?: string;
+    readonly signal: AbortSignal;
+}) => Promise<string>;
+export interface ResolvedSummarizationConfig {
+    readonly maxTokens: number;
+    readonly keepRecentTurns: number;
+    readonly model: string;
+    readonly tokenCounter: TokenCounter;
+    readonly summarize: SummarizeFn;
+}
+export interface PreModelHookState {
+    readonly messages: BaseMessage[];
+    readonly runningSummary?: RunningSummary;
+}
+export interface PreModelHookResult {
+    llmInputMessages?: BaseMessage[];
+    runningSummary?: RunningSummary;
+}
+export declare function buildSummarizationHook(cfg: ResolvedSummarizationConfig): (state: PreModelHookState, nodeConfig?: {
+    readonly signal?: AbortSignal;
+}) => Promise<PreModelHookResult>;
+//# sourceMappingURL=hook.d.ts.map

package/dist/summarization/hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook.d.ts","sourceRoot":"","sources":["../../src/summarization/hook.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAiB,MAAM,0BAA0B,CAAA;AAI1E,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAC9B;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;AAErE,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE;IAC/B,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAA;IACzC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;CAC7B,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;AAErB,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAA;IACnC,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAA;CAChC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAA;IAChC,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAA;CACzC;AAED,MAAM,WAAW,kBAAkB;IACjC,gBAAgB,CAAC,EAAE,WAAW,EAAE,CAAA;IAChC,cAAc,CAAC,EAAE,cAAc,CAAA;CAChC;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,2BAA2B,IAEnE,OAAO,iBAAiB,EACxB,aAAa;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,KAC7C,OAAO,CAAC,kBAAkB,CAAC,CA0C/B"}

package/dist/summarization/hook.js

@@ -0,0 +1,44 @@
+import { SystemMessage } from "@langchain/core/messages";
+import { splitForSummary } from "./split.js";
+import { countMessagesTokens } from "./token-counter.js";
+export function buildSummarizationHook(cfg) {
+    return async (state, nodeConfig) => {
+        const messages = state.messages ?? [];
+        const total = await countMessagesTokens(messages, cfg.tokenCounter);
+        if (total <= cfg.maxTokens)
+            return {};
+        const prev = state.runningSummary;
+        const coveredCount = prev?.coveredCount ?? 0;
+        const { toSummarize, recent } = splitForSummary(messages, cfg.keepRecentTurns);
+        const newlyAged = toSummarize.slice(coveredCount);
+        let summary = prev?.summary ?? "";
+        if (newlyAged.length > 0) {
+            try {
+                summary = await cfg.summarize({
+                    messages: newlyAged,
+                    model: cfg.model,
+                    ...(prev?.summary ? { previousSummary: prev.summary } : {}),
+                    signal: nodeConfig?.signal ?? new AbortController().signal,
+                });
+            }
+            catch (error) {
+                // Summarization failed this turn — fall back to the FULL history.
+                // We must explicitly set llmInputMessages to the full messages (not
+                // return {}), otherwise a stale condensed view from a prior turn would
+                // remain in the channel and the model would answer without the latest
+                // turn's messages.
+                if (process.env.DAWN_DEBUG_SUMMARIZATION === "1") {
+                    console.warn("[dawn] summarization failed — falling back to full history this turn:", error instanceof Error ? error.message : String(error));
+                }
+                return { llmInputMessages: messages };
+            }
+        }
+        if (!summary)
+            return {};
+        const summaryMessage = new SystemMessage(`Summary of earlier conversation:\n${summary}`);
+        return {
+            llmInputMessages: [summaryMessage, ...recent],
+            runningSummary: { summary, coveredCount: toSummarize.length },
+        };
+    };
+}

package/dist/summarization/index.d.ts

@@ -0,0 +1,5 @@
+export { buildSummarizationHook, type PreModelHookResult, type PreModelHookState, type ResolvedSummarizationConfig, type RunningSummary, type SummarizeFn, type TokenCounter, } from "./hook.js";
+export { splitForSummary } from "./split.js";
+export { defaultSummarize } from "./summarize.js";
+export { countMessagesTokens, defaultTokenCounter } from "./token-counter.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/summarization/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/summarization/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,2BAA2B,EAChC,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,YAAY,GAClB,MAAM,WAAW,CAAA;AAClB,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACjD,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/summarization/index.js

@@ -0,0 +1,4 @@
+export { buildSummarizationHook, } from "./hook.js";
+export { splitForSummary } from "./split.js";
+export { defaultSummarize } from "./summarize.js";
+export { countMessagesTokens, defaultTokenCounter } from "./token-counter.js";

package/dist/summarization/split.d.ts

@@ -0,0 +1,12 @@
+import type { BaseMessage } from "@langchain/core/messages";
+/**
+ * Split into { toSummarize, recent }, keeping the last `keepRecentTurns` turns
+ * verbatim. A turn begins at a HumanMessage; slicing on a HumanMessage boundary
+ * keeps every tool round (AIMessage-with-tool_calls + its ToolMessages) intact,
+ * so `recent` never starts mid-round. Fewer turns than requested -> all recent.
+ */
+export declare function splitForSummary(messages: readonly BaseMessage[], keepRecentTurns: number): {
+    toSummarize: BaseMessage[];
+    recent: BaseMessage[];
+};
+//# sourceMappingURL=split.d.ts.map

package/dist/summarization/split.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"split.d.ts","sourceRoot":"","sources":["../../src/summarization/split.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAS3D;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,SAAS,WAAW,EAAE,EAChC,eAAe,EAAE,MAAM,GACtB;IAAE,WAAW,EAAE,WAAW,EAAE,CAAC;IAAC,MAAM,EAAE,WAAW,EAAE,CAAA;CAAE,CAWvD"}

package/dist/summarization/split.js

@@ -0,0 +1,27 @@
+function isHuman(m) {
+    const getType = m.getType;
+    if (typeof getType === "function")
+        return getType.call(m) === "human";
+    const legacy = m._getType;
+    return typeof legacy === "function" ? legacy.call(m) === "human" : false;
+}
+/**
+ * Split into { toSummarize, recent }, keeping the last `keepRecentTurns` turns
+ * verbatim. A turn begins at a HumanMessage; slicing on a HumanMessage boundary
+ * keeps every tool round (AIMessage-with-tool_calls + its ToolMessages) intact,
+ * so `recent` never starts mid-round. Fewer turns than requested -> all recent.
+ */
+export function splitForSummary(messages, keepRecentTurns) {
+    if (keepRecentTurns <= 0)
+        return { toSummarize: [...messages], recent: [] };
+    const humanIdx = [];
+    messages.forEach((m, i) => {
+        if (isHuman(m))
+            humanIdx.push(i);
+    });
+    if (humanIdx.length <= keepRecentTurns) {
+        return { toSummarize: [], recent: [...messages] };
+    }
+    const cut = humanIdx[humanIdx.length - keepRecentTurns];
+    return { toSummarize: messages.slice(0, cut), recent: messages.slice(cut) };
+}

package/dist/summarization/summarize.d.ts

@@ -0,0 +1,10 @@
+import type { BaseMessage } from "@langchain/core/messages";
+export declare function defaultSummarize(args: {
+    readonly messages: readonly BaseMessage[];
+    readonly model: string;
+    readonly previousSummary?: string;
+    readonly signal: AbortSignal;
+    /** Test seam: override the model invocation. */
+    readonly invokeModel?: (prompt: string) => Promise<string>;
+}): Promise<string>;
+//# sourceMappingURL=summarize.d.ts.map

package/dist/summarization/summarize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarize.d.ts","sourceRoot":"","sources":["../../src/summarization/summarize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AA4B3D,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAA;IACzC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,gDAAgD;IAChD,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;CAC3D,GAAG,OAAO,CAAC,MAAM,CAAC,CAUlB"}

package/dist/summarization/summarize.js

@@ -0,0 +1,30 @@
+import { createChatModel } from "../chat-model-factory.js";
+import { resolveProvider } from "../model-provider-resolver.js";
+function renderMessages(messages) {
+    return messages
+        .map((m) => {
+        const getType = m.getType;
+        const role = typeof getType === "function" ? getType.call(m) : "message";
+        const content = typeof m.content === "string" ? m.content : JSON.stringify(m.content);
+        const toolCalls = m.tool_calls;
+        const tc = toolCalls && toolCalls.length > 0 ? `\n[tool_calls: ${JSON.stringify(toolCalls)}]` : "";
+        return `${role}: ${content}${tc}`;
+    })
+        .join("\n");
+}
+function buildPrompt(messages, previousSummary) {
+    const prior = previousSummary ? `Existing running summary so far:\n${previousSummary}\n\n` : "";
+    return (`${prior}New conversation messages to fold into the summary:\n${renderMessages(messages)}\n\n` +
+        `Write an updated, concise running summary of the ENTIRE conversation so far. ` +
+        `Preserve concrete facts, decisions, user goals, tool results, identifiers, and open questions. ` +
+        `Do not invent information. Output only the summary text.`);
+}
+export async function defaultSummarize(args) {
+    const prompt = buildPrompt(args.messages, args.previousSummary);
+    if (args.invokeModel)
+        return args.invokeModel(prompt);
+    const provider = resolveProvider({ model: args.model });
+    const llm = (await createChatModel({ model: args.model, provider }));
+    const res = await llm.invoke([{ role: "user", content: prompt }], { signal: args.signal });
+    return typeof res.content === "string" ? res.content : JSON.stringify(res.content);
+}

package/dist/summarization/token-counter.d.ts

@@ -0,0 +1,10 @@
+import type { BaseMessage } from "@langchain/core/messages";
+/**
+ * Default token counter. Lazily imports a single gpt-tokenizer encoding
+ * (o200k_base — current OpenAI models) so apps that don't enable summarization
+ * never load the large encoding tables. Async because of the lazy import.
+ */
+export declare function defaultTokenCounter(text: string): Promise<number>;
+/** Sum a (possibly async) token counter across a message list. */
+export declare function countMessagesTokens(messages: readonly BaseMessage[], counter: (text: string) => number | Promise<number>): Promise<number>;
+//# sourceMappingURL=token-counter.d.ts.map

package/dist/summarization/token-counter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-counter.d.ts","sourceRoot":"","sources":["../../src/summarization/token-counter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAI3D;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAQvE;AAUD,kEAAkE;AAClE,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,SAAS,WAAW,EAAE,EAChC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,GAClD,OAAO,CAAC,MAAM,CAAC,CAMjB"}

package/dist/summarization/token-counter.js

@@ -0,0 +1,29 @@
+let encodeFn;
+/**
+ * Default token counter. Lazily imports a single gpt-tokenizer encoding
+ * (o200k_base — current OpenAI models) so apps that don't enable summarization
+ * never load the large encoding tables. Async because of the lazy import.
+ */
+export async function defaultTokenCounter(text) {
+    if (!encodeFn) {
+        const mod = (await import("gpt-tokenizer/encoding/o200k_base"));
+        encodeFn = mod.encode;
+    }
+    return encodeFn(text).length;
+}
+function messageToText(m) {
+    const parts = [];
+    parts.push(typeof m.content === "string" ? m.content : JSON.stringify(m.content));
+    const toolCalls = m.tool_calls;
+    if (toolCalls)
+        parts.push(JSON.stringify(toolCalls));
+    return parts.join("\n");
+}
+/** Sum a (possibly async) token counter across a message list. */
+export async function countMessagesTokens(messages, counter) {
+    let total = 0;
+    for (const m of messages) {
+        total += await counter(messageToText(m));
+    }
+    return total;
+}

package/dist/tool-converter.d.ts

@@ -10,7 +10,8 @@ interface DawnToolDefinition {
     }) => Promise<unknown> | unknown;
     readonly schema?: unknown;
 }
-export declare function convertToolToLangChain(tool: DawnToolDefinition, middlewareContext?: Readonly<Record<string, unknown>>): DynamicStructuredTool;
+export type OffloadFn = (content: string, toolName: string, toolCallId?: string) => Promise<string>;
+export declare function convertToolToLangChain(tool: DawnToolDefinition, middlewareContext?: Readonly<Record<string, unknown>>, offload?: OffloadFn): DynamicStructuredTool;
 export declare function jsonSchemaToZod(schema: JsonSchemaProperty): z.ZodObject<z.ZodRawShape>;
 export {};
 //# sourceMappingURL=tool-converter.d.ts.map

package/dist/tool-converter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-converter.d.ts","sourceRoot":"","sources":["../src/tool-converter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAEvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAE7D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,UAAU,kBAAkB;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,GAAG,EAAE,CACZ,KAAK,EAAE,OAAO,EACd,OAAO,EAAE;QACP,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;QACvD,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;KAC7B,KACE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAA;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAC1B;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,kBAAkB,EACxB,iBAAiB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACpD,qBAAqB,CAkCvB;AA6BD,wBAAgB,eAAe,CAAC,MAAM,EAAE,kBAAkB,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAEtF"}
+{"version":3,"file":"tool-converter.d.ts","sourceRoot":"","sources":["../src/tool-converter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAEvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAE7D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,UAAU,kBAAkB;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,GAAG,EAAE,CACZ,KAAK,EAAE,OAAO,EACd,OAAO,EAAE;QACP,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;QACvD,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;KAC7B,KACE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAA;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAC1B;AAED,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;AAEnG,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,kBAAkB,EACxB,iBAAiB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACrD,OAAO,CAAC,EAAE,SAAS,GAClB,qBAAqB,CAqCvB;AA6BD,wBAAgB,eAAe,CAAC,MAAM,EAAE,kBAAkB,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAEtF"}

package/dist/tool-converter.js

@@ -3,7 +3,7 @@ import { DynamicStructuredTool } from "@langchain/core/tools";
 import { Command } from "@langchain/langgraph";
 import { z } from "zod";
 import { unwrapToolResult } from "./unwrap-tool-result.js";
-export function convertToolToLangChain(tool, middlewareContext) {
+export function convertToolToLangChain(tool, middlewareContext, offload) {
     const schema = toZodSchema(tool.schema);
     return new DynamicStructuredTool({
         name: tool.name,
@@ -16,14 +16,17 @@ export function convertToolToLangChain(tool, middlewareContext) {
                 signal,
             });
             const { content, stateUpdates } = unwrapToolResult(rawResult);
+            const toolCallId = extractToolCallId(config);
+            const finalContent = offload
+                ? await offload(content, tool.name, toolCallId || undefined)
+                : content;
             if (stateUpdates) {
-                const toolCallId = extractToolCallId(config);
                 return new Command({
                     update: {
                         ...stateUpdates,
                         messages: [
                             new ToolMessage({
-                                content,
+                                content: finalContent,
                                 tool_call_id: toolCallId,
                                 name: tool.name,
                             }),
@@ -31,7 +34,7 @@ export function convertToolToLangChain(tool, middlewareContext) {
                     },
                 });
             }
-            return content;
+            return finalContent;
         },
     });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dawn-ai/langchain",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "private": false,
   "type": "module",
   "license": "MIT",
@@ -32,8 +32,10 @@
   "dependencies": {
     "@langchain/langgraph": "^1.3.0",
     "@langchain/openai": "^1.4.5",
-    "@dawn-ai/core": "0.2.0",
-    "@dawn-ai/sdk": "0.2.0"
+    "gpt-tokenizer": "^3.4.0",
+    "@dawn-ai/core": "0.3.0",
+    "@dawn-ai/sdk": "0.3.0",
+    "@dawn-ai/workspace": "0.2.0"
   },
   "peerDependencies": {
     "@langchain/core": "^1.1.47",
@@ -86,7 +88,7 @@
     "@langchain/xai": "^1.3.18",
     "@types/node": "25.6.0",
     "zod": "4.4.3",
-    "@dawn-ai/config-typescript": "0.2.0"
+    "@dawn-ai/config-typescript": "0.3.0"
   },
   "scripts": {
     "build": "tsc -b tsconfig.json",