@zmdb/ai-langchain 1.0.0-beta.1

package/LICENSE

@@ -0,0 +1,10 @@
+GNU GENERAL PUBLIC LICENSE
+Version 3, 29 June 2007
+
+@zmdb/ai-langchain is free software licensed under the GNU General Public
+License, version 3 or (at your option) any later version.
+
+The complete license text is published by the Free Software Foundation at:
+https://www.gnu.org/licenses/gpl-3.0.txt
+
+SPDX-License-Identifier: GPL-3.0-or-later

package/README.md

@@ -0,0 +1,39 @@
+# @zmdb/ai-langchain
+
+`@zmdb/ai-langchain` adapts provider-neutral zmdb tool documents to the structural fields accepted by LangChain's `DynamicStructuredTool`. It passes the generated JSON Schema directly to LangChain,
+runs a caller-owned validator before the handler, and serializes tool results without introducing Zod or another runtime schema producer.
+
+## Install
+
+```bash
+yarn add @zmdb/ai@1.0.0-beta.1 @zmdb/ai-langchain@1.0.0-beta.1 @langchain/core@^1.2.9
+```
+
+> **Prerelease** (`1.0.0-beta.1`). Requires **Node.js 26+** and is **ESM-only**. `@langchain/core` is an optional peer used by applications that construct a real LangChain tool.
+
+## Usage
+
+```ts
+import { DynamicStructuredTool } from '@langchain/core/tools';
+import { langchainTool } from '@zmdb/ai-langchain';
+
+const createUser = new DynamicStructuredTool(
+  langchainTool('create_user', users, {
+    description: 'Create a user',
+    validate: input => assert<CreateDTO<User>>(input),
+    execute: dto => userRepo.create(dto),
+  }),
+);
+```
+
+The validator belongs in application code so the AOT transform can resolve its concrete type. The adapter passes zmdb's JSON Schema document through byte-for-byte; do not convert it through Zod.
+
+The shipped adapter is physically owned by this package and depends at runtime only on `@zmdb/ai`; schema-core has no LangChain compatibility export.
+
+## Documentation
+
+Full docs: **https://ambasta.github.io/zmdb/docs/llm-langchain.html**
+
+## License
+
+GNU General Public License v3.0 or later (GPL-3.0-or-later) — see [LICENSE](./LICENSE).

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+import { type ToolSchema, type ToolSpec } from '@zmdb/ai';
+import { type ToolAdapterOptions } from '@zmdb/ai/tool-runtime';
+/**
+ * The fields accepted by `new DynamicStructuredTool(...)`.
+ *
+ * Kept structural so this optional subpath does not import LangChain or its
+ * runtime schema dependencies. The real-package consumer fixture checks this
+ * shape against the tested peer version.
+ */
+export interface LangChainToolFields {
+    readonly name: string;
+    readonly description: string;
+    readonly schema: ToolSpec['parameters'];
+    readonly func: (input: unknown) => Promise<string>;
+}
+export declare function langchainTool<T, Output>(name: string, schema: ToolSchema, options: ToolAdapterOptions<T, Output>): LangChainToolFields;
+export type { ToolAdapterOptions } from '@zmdb/ai/tool-runtime';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,UAAU,EAAE,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AAC1E,OAAO,EAA2C,KAAK,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEzG;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC;IACxC,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACpD;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EACrC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,kBAAkB,CAAC,CAAC,EAAE,MAAM,CAAC,GACrC,mBAAmB,CASrB;AAED,YAAY,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+import { toolFromSchema } from '@zmdb/ai';
+import { executeToolAdapter, serialiseToolResult } from '@zmdb/ai/tool-runtime';
+export function langchainTool(name, schema, options) {
+    return {
+        name,
+        description: options.description,
+        schema: toolFromSchema(name, schema).parameters,
+        async func(input) {
+            return serialiseToolResult(await executeToolAdapter(name, input, options));
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAkC,MAAM,UAAU,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAA2B,MAAM,uBAAuB,CAAC;AAgBzG,MAAM,UAAU,aAAa,CAC3B,IAAY,EACZ,MAAkB,EAClB,OAAsC;IAEtC,OAAO;QACL,IAAI;QACJ,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,MAAM,EAAE,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,UAAU;QAC/C,KAAK,CAAC,IAAI,CAAC,KAAK;YACd,OAAO,mBAAmB,CAAC,MAAM,kBAAkB,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;QAC7E,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@zmdb/ai-langchain",
+  "version": "1.0.0-beta.1",
+  "description": "Optional LangChain structured-tool adapter for provider-neutral zmdb AI tool documents.",
+  "keywords": [
+    "ai",
+    "json-schema",
+    "langchain",
+    "llm",
+    "typescript",
+    "zmdb"
+  ],
+  "homepage": "https://github.com/ambasta/zmdb#readme",
+  "bugs": {
+    "url": "https://github.com/ambasta/zmdb/issues"
+  },
+  "license": "GPL-3.0-or-later",
+  "author": "zmdb contributors",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ambasta/zmdb.git",
+    "directory": "packages/ai-langchain"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "tag": "beta"
+  },
+  "scripts": {
+    "build": "node ../../scripts/build-package.mjs",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@zmdb/ai": "1.0.0-beta.1"
+  },
+  "peerDependencies": {
+    "@langchain/core": "^1.2.9"
+  },
+  "peerDependenciesMeta": {
+    "@langchain/core": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=26"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts"
+}

package/src/index.ts

@@ -0,0 +1,33 @@
+import { toolFromSchema, type ToolSchema, type ToolSpec } from '@zmdb/ai';
+import { executeToolAdapter, serialiseToolResult, type ToolAdapterOptions } from '@zmdb/ai/tool-runtime';
+
+/**
+ * The fields accepted by `new DynamicStructuredTool(...)`.
+ *
+ * Kept structural so this optional subpath does not import LangChain or its
+ * runtime schema dependencies. The real-package consumer fixture checks this
+ * shape against the tested peer version.
+ */
+export interface LangChainToolFields {
+  readonly name: string;
+  readonly description: string;
+  readonly schema: ToolSpec['parameters'];
+  readonly func: (input: unknown) => Promise<string>;
+}
+
+export function langchainTool<T, Output>(
+  name: string,
+  schema: ToolSchema,
+  options: ToolAdapterOptions<T, Output>,
+): LangChainToolFields {
+  return {
+    name,
+    description: options.description,
+    schema: toolFromSchema(name, schema).parameters,
+    async func(input) {
+      return serialiseToolResult(await executeToolAdapter(name, input, options));
+    },
+  };
+}
+
+export type { ToolAdapterOptions } from '@zmdb/ai/tool-runtime';