@dawn-ai/langchain 0.6.0 → 0.8.0

package/README.md

@@ -4,11 +4,13 @@
 
 # @dawn-ai/langchain
 
-LangChain backend adapters Dawn uses to materialize `chain` routes and provider-aware `agent` routes (tool conversion, streaming, retry).
+LangChain backend adapters for Dawn, the TypeScript meta-framework for LangGraph. Dawn uses this package to materialize `chain` routes and provider-aware `agent` routes — handling tool conversion, streaming, and retry.
 
 `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:
+## Optional provider integrations
+
+Install the provider packages your agents use, as needed:
 
 ```bash
 pnpm add @langchain/anthropic     # anthropic
@@ -20,7 +22,14 @@ 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>.
+## Documentation
+
+- [Routes](https://dawnai.org/docs/routes)
+- [Getting started](https://dawnai.org/docs/getting-started)
+
+---
+
+⭐ [Star Dawn on GitHub](https://github.com/cacheplane/dawnai) · 📚 [Read the docs](https://dawnai.org/docs/getting-started) · 💬 [Ask in GitHub Discussions](https://github.com/cacheplane/dawnai/discussions)
 
 ## License
 

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

@@ -1,5 +1,10 @@
 import type { BuiltInModelProviderId, ReasoningConfig } from "@dawn-ai/sdk";
 type Importer = (specifier: string) => Promise<Record<string, unknown>>;
+/** Advisory once-per-process warning; never blocks model construction. */
+export declare function warnOnUnknownModelId(opts: {
+    readonly model: string;
+    readonly provider: string;
+}): void;
 export declare function missingProviderPackageMessage(provider: BuiltInModelProviderId, packageName: string): string;
 export declare function createChatModel(options: {
     readonly model: string;

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,CAoCnB"}
+{"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;AAG3E,KAAK,QAAQ,GAAG,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;AAsBvE,0EAA0E;AAC1E,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B,GAAG,IAAI,CAYP;AAED,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,CAqCnB"}

package/dist/chat-model-factory.js

@@ -1,3 +1,4 @@
+import { validateModelId } from "@dawn-ai/sdk";
 const providerSpecs = {
     openai: { packageName: "@langchain/openai", exportName: "ChatOpenAI" },
     anthropic: { packageName: "@langchain/anthropic", exportName: "ChatAnthropic" },
@@ -9,10 +10,26 @@ const providerSpecs = {
     xai: { packageName: "@langchain/xai", exportName: "ChatXAI" },
     openrouter: { packageName: "@langchain/openrouter", exportName: "ChatOpenRouter" },
 };
+const warnedModelIds = new Set();
+/** Advisory once-per-process warning; never blocks model construction. */
+export function warnOnUnknownModelId(opts) {
+    const key = `${opts.provider} ${opts.model}`;
+    if (warnedModelIds.has(key))
+        return;
+    const verdict = validateModelId(opts);
+    if (verdict.ok)
+        return;
+    warnedModelIds.add(key);
+    const suggestions = verdict.suggestions.map((s) => `"${s}"`).join(", ");
+    console.warn(`[dawn:models] model "${opts.model}" is not a known ${verdict.provider} model id.` +
+        (suggestions ? ` Did you mean ${suggestions}?` : "") +
+        " Proceeding anyway.");
+}
 export function missingProviderPackageMessage(provider, packageName) {
     return `Provider "${provider}" requires ${packageName}. Install it with: pnpm add ${packageName}`;
 }
 export async function createChatModel(options) {
+    warnOnUnknownModelId({ model: options.model, provider: options.provider });
     const spec = providerSpecs[options.provider];
     const importer = options.importer ??
         ((specifier) => import(specifier));

package/dist/model-provider-resolver.d.ts

@@ -1,6 +1,6 @@
 import type { BuiltInModelProviderId, ModelProviderId } from "@dawn-ai/sdk";
-export declare const SUPPORTED_AGENT_PROVIDERS: readonly ["openai", "anthropic", "google", "mistral", "groq", "ollama", "xai", "openrouter"];
-export declare function inferProvider(model: string): BuiltInModelProviderId | undefined;
+import { inferProvider, SUPPORTED_AGENT_PROVIDERS } from "@dawn-ai/sdk";
+export { inferProvider, SUPPORTED_AGENT_PROVIDERS };
 export declare function resolveProvider(options: {
     readonly model: string;
     readonly provider?: ModelProviderId;

package/dist/model-provider-resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model-provider-resolver.d.ts","sourceRoot":"","sources":["../src/model-provider-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAE3E,eAAO,MAAM,yBAAyB,8FASgB,CAAA;AAItD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,sBAAsB,GAAG,SAAS,CAgB/E;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,eAAe,CAAA;CACpC,GAAG,sBAAsB,CAgBzB"}
+{"version":3,"file":"model-provider-resolver.d.ts","sourceRoot":"","sources":["../src/model-provider-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAC3E,OAAO,EAAE,aAAa,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAA;AAEvE,OAAO,EAAE,aAAa,EAAE,yBAAyB,EAAE,CAAA;AAInD,wBAAgB,eAAe,CAAC,OAAO,EAAE;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,eAAe,CAAA;CACpC,GAAG,sBAAsB,CAgBzB"}

package/dist/model-provider-resolver.js

@@ -1,31 +1,6 @@
-export const SUPPORTED_AGENT_PROVIDERS = [
-    "openai",
-    "anthropic",
-    "google",
-    "mistral",
-    "groq",
-    "ollama",
-    "xai",
-    "openrouter",
-];
+import { inferProvider, SUPPORTED_AGENT_PROVIDERS } from "@dawn-ai/sdk";
+export { inferProvider, SUPPORTED_AGENT_PROVIDERS };
 const supportedProviderSet = new Set(SUPPORTED_AGENT_PROVIDERS);
-export function inferProvider(model) {
-    const normalized = model.trim().toLowerCase();
-    if (/^(gpt-|o3|o4)/.test(normalized))
-        return "openai";
-    if (normalized.startsWith("claude-"))
-        return "anthropic";
-    if (normalized.startsWith("gemini-"))
-        return "google";
-    if (normalized.startsWith("mistral-") ||
-        normalized.startsWith("mixtral-") ||
-        normalized.startsWith("codestral-")) {
-        return "mistral";
-    }
-    if (normalized.startsWith("grok-"))
-        return "xai";
-    return undefined;
-}
 export function resolveProvider(options) {
     if (options.provider !== undefined) {
         if (supportedProviderSet.has(options.provider)) {

package/package.json

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