@dawn-ai/langchain 0.1.8 → 0.3.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Dawn contributors
+Copyright (c) Brian Love
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -4,9 +4,23 @@
 
 # @dawn-ai/langchain
 
-LangChain backend adapters Dawn uses to materialize `chain` and `agent` routes (tool conversion, streaming, retry).
+LangChain backend adapters Dawn uses to materialize `chain` routes and provider-aware `agent` routes (tool conversion, streaming, retry).
 
-This is an internal Dawn workspace package. For Dawn documentation, see <https://dawn-ai.org>.
+`agent()` materialization resolves a LangChain chat model from the route descriptor. Dawn includes `@langchain/openai` for the default/backcompat path and lazy-loads optional provider packages when an agent selects or infers another provider.
+
+Install optional provider integrations in applications as needed:
+
+```bash
+pnpm add @langchain/anthropic     # anthropic
+pnpm add @langchain/google-genai  # google
+pnpm add @langchain/mistralai     # mistral
+pnpm add @langchain/groq          # groq
+pnpm add @langchain/ollama        # ollama
+pnpm add @langchain/xai           # xai
+pnpm add @langchain/openrouter    # openrouter
+```
+
+This is an internal Dawn workspace package. For Dawn documentation, see <https://github.com/cacheplane/dawnai/tree/main/apps/web/content/docs>.
 
 ## License
 

package/dist/agent-adapter.d.ts

@@ -1,6 +1,13 @@
-import type { RetryConfig } from "@dawn-ai/sdk";
+import type { PromptFragment, StreamTransformer } from "@dawn-ai/core";
+import type { DawnAgent, RetryConfig } from "@dawn-ai/sdk";
+import { type BaseMessageLike } from "@langchain/core/messages";
+import type { BaseCheckpointSaver } from "@langchain/langgraph-checkpoint";
 import { type ResolvedStateField } from "./state-adapter.js";
-interface DawnToolDefinition {
+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;
     readonly name: string;
     readonly run: (input: unknown, context: {
@@ -9,21 +16,70 @@ 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;
+    readonly descriptor: DawnAgent;
+    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" | "done";
+    readonly type: "token" | "tool_call" | "tool_result" | "interrupt" | "done" | (string & {});
     readonly data: unknown;
 }
 export interface AgentOptions {
+    /**
+     * Checkpointer used by LangGraph to park interrupted graph state and replay
+     * from it on resume. Required — the CLI runtime supplies a SQLite-backed
+     * instance by default. If you call agent-adapter directly (e.g. in tests),
+     * pass `new MemorySaver()` from `@langchain/langgraph`.
+     */
+    readonly checkpointer: BaseCheckpointSaver;
     readonly entry: unknown;
+    /**
+     * The agent input. For a normal invocation, this is a record like
+     * `{messages: [...]}`. For a resume invocation (after a parked interrupt),
+     * pass a `Command({resume: decision})` instance directly — the adapter will
+     * forward it verbatim to `streamEvents` instead of wrapping it in messages.
+     */
     readonly input: unknown;
     readonly middlewareContext?: Readonly<Record<string, unknown>>;
+    readonly offload?: OffloadFn;
     readonly retry?: RetryConfig;
     readonly routeParamNames: readonly string[];
     readonly signal: AbortSignal;
     readonly stateFields?: readonly ResolvedStateField[];
     readonly tools: readonly DawnToolDefinition[];
+    readonly promptFragments?: readonly PromptFragment[];
+    readonly streamTransformers?: readonly StreamTransformer[];
+    /**
+     * Resolves a subagent leaf name to a child graph + routeId. When set, the
+     * `task` tool contributed by the subagents capability marker is intercepted
+     * inside `streamFromRunnable` and replaced with a bridge that dispatches the
+     * call via `dispatchSubagent`. Emitted `subagent.*` events are queued and
+     * drained alongside normal stream chunks (no module-level mutable state).
+     */
+    readonly subagentResolver?: SubagentResolver;
+    /**
+     * Stable per-conversation identifier used as LangGraph's `thread_id`. When
+     * set, the agent-adapter wires it into `config.configurable.thread_id` so
+     * the checkpointer can park interrupted state. Required for resume to work
+     * — without a thread_id, an interrupt ends the stream with no way to
+     * replay.
+     */
+    readonly threadId?: string;
+    readonly summarization?: ResolvedSummarizationConfig;
 }
 export declare function executeAgent(options: AgentOptions): Promise<unknown>;
 export declare function streamAgent(options: AgentOptions): AsyncGenerator<AgentStreamChunk>;
-export {};
 //# sourceMappingURL=agent-adapter.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"agent-adapter.d.ts","sourceRoot":"","sources":["../src/agent-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,WAAW,EAAE,MAAM,cAAc,CAAA;AAI1D,OAAO,EAA0B,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAGpF,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;AAwDD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,WAAW,GAAG,aAAa,GAAG,MAAM,CAAA;IAC7D,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,iBAAiB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IAC9D,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAA;IAC5B,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAA;IAC3C,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAA;IACpD,QAAQ,CAAC,KAAK,EAAE,SAAS,kBAAkB,EAAE,CAAA;CAC9C;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CAQ1E;AAED,wBAAuB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,cAAc,CAAC,gBAAgB,CAAC,CA4B1F"}
+{"version":3,"file":"agent-adapter.d.ts","sourceRoot":"","sources":["../src/agent-adapter.ts"],"names":[],"mappings":"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"}