@aerostack/sdk-langchain 0.10.1

package/README.md

@@ -0,0 +1,62 @@
+# @aerostack/sdk-langchain
+
+Use [Aerostack](https://aerostack.dev) workspace tools as [LangChain.js](https://js.langchain.com/) tools.
+
+## Install
+
+```bash
+npm install @aerostack/sdk-langchain @langchain/core
+```
+
+## Quick Start
+
+```typescript
+import { ChatOpenAI } from '@langchain/openai';
+import { createReactAgent } from '@langchain/langgraph/prebuilt';
+import { getTools } from '@aerostack/sdk-langchain';
+
+const { tools } = await getTools({ workspace: 'my-workspace', token: 'mwt_...' });
+
+const agent = createReactAgent({
+    llm: new ChatOpenAI({ model: 'gpt-4o' }),
+    tools,
+});
+
+const result = await agent.invoke({
+    messages: [{ role: 'user', content: 'Create a GitHub issue for the login bug' }],
+});
+```
+
+## Direct Tool Binding
+
+```typescript
+import { ChatAnthropic } from '@langchain/anthropic';
+import { getTools } from '@aerostack/sdk-langchain';
+
+const { tools } = await getTools({ workspace: 'my-workspace', token: 'mwt_...' });
+const model = new ChatAnthropic({ model: 'claude-sonnet-4-20250514' }).bindTools(tools);
+```
+
+## Factory Pattern
+
+```typescript
+import { createAerostackLangChain } from '@aerostack/sdk-langchain';
+
+const aero = createAerostackLangChain({ workspace: 'my-workspace', token: 'mwt_...' });
+const { tools } = await aero.tools();
+```
+
+## API
+
+### `getTools(config)` → `Promise<ToolSetResult>`
+
+Fetches tools from the workspace. Each tool auto-executes via the workspace gateway. Returns `{ tools, raw }`.
+
+### `createAerostackLangChain(config)` → `AerostackLangChainClient`
+
+Creates a reusable client that shares a single WorkspaceClient instance.
+
+## Requirements
+
+- `@langchain/core` >= 0.2.0
+- An Aerostack workspace with a token (`mwt_...`)

package/dist/commonjs/__tests__/converter.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=converter.test.d.ts.map

package/dist/commonjs/__tests__/converter.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"converter.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/converter.test.ts"],"names":[],"mappings":""}

package/dist/commonjs/__tests__/converter.test.js

@@ -0,0 +1,125 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const converter_js_1 = require("../converter.js");
+const core_1 = require("@aerostack/core");
+function mockClient(callToolResult, shouldThrow = false) {
+    return {
+        callTool: shouldThrow
+            ? vitest_1.vi.fn().mockRejectedValue(callToolResult)
+            : vitest_1.vi.fn().mockResolvedValue(callToolResult),
+    };
+}
+(0, vitest_1.describe)('convertTools', () => {
+    (0, vitest_1.it)('converts MCP tools to LangChain DynamicStructuredTool array', () => {
+        const mcpTools = [
+            {
+                name: 'github__create_issue',
+                description: 'Create a GitHub issue',
+                inputSchema: {
+                    type: 'object',
+                    properties: { title: { type: 'string' } },
+                    required: ['title'],
+                },
+            },
+            {
+                name: 'slack__post_message',
+                description: 'Post to Slack',
+            },
+        ];
+        const client = mockClient({});
+        const tools = (0, converter_js_1.convertTools)(mcpTools, client);
+        (0, vitest_1.expect)(tools).toHaveLength(2);
+        (0, vitest_1.expect)(tools[0].name).toBe('github__create_issue');
+        (0, vitest_1.expect)(tools[0].description).toBe('Create a GitHub issue');
+        (0, vitest_1.expect)(tools[1].name).toBe('slack__post_message');
+    });
+    (0, vitest_1.it)('handles tools with no description', () => {
+        const mcpTools = [
+            { name: 'my_tool', inputSchema: { type: 'object', properties: {} } },
+        ];
+        const client = mockClient({});
+        const tools = (0, converter_js_1.convertTools)(mcpTools, client);
+        (0, vitest_1.expect)(tools[0].name).toBe('my_tool');
+        (0, vitest_1.expect)(tools[0].description).toBe('my_tool tool');
+    });
+    (0, vitest_1.it)('skips tools with empty names', () => {
+        const mcpTools = [
+            { name: '', description: 'Bad' },
+            { name: 'good', description: 'Good' },
+        ];
+        const client = mockClient({});
+        const tools = (0, converter_js_1.convertTools)(mcpTools, client);
+        (0, vitest_1.expect)(tools).toHaveLength(1);
+        (0, vitest_1.expect)(tools[0].name).toBe('good');
+    });
+    (0, vitest_1.it)('handles empty tools array', () => {
+        const client = mockClient({});
+        (0, vitest_1.expect)((0, converter_js_1.convertTools)([], client)).toEqual([]);
+    });
+    (0, vitest_1.it)('tool invoke calls WorkspaceClient.callTool', async () => {
+        const mcpTools = [
+            {
+                name: 'test_tool',
+                description: 'Test',
+                inputSchema: { type: 'object', properties: { x: { type: 'number' } } },
+            },
+        ];
+        const client = mockClient({
+            content: [{ type: 'text', text: 'result123' }],
+        });
+        const tools = (0, converter_js_1.convertTools)(mcpTools, client);
+        const result = await tools[0].invoke({ x: 42 });
+        (0, vitest_1.expect)(client.callTool).toHaveBeenCalledWith('test_tool', { x: 42 });
+        (0, vitest_1.expect)(result).toBe('result123');
+    });
+    (0, vitest_1.it)('tool handles AerostackError gracefully', async () => {
+        const err = new core_1.AerostackError('Server down', 503, -32603, 'req-1');
+        const client = mockClient(err, true);
+        const mcpTools = [
+            { name: 'failing_tool', description: 'Fails' },
+        ];
+        const tools = (0, converter_js_1.convertTools)(mcpTools, client);
+        const result = await tools[0].invoke({});
+        (0, vitest_1.expect)(result).toContain('Error (-32603)');
+        (0, vitest_1.expect)(result).toContain('Server down');
+    });
+    (0, vitest_1.it)('tool handles generic errors', async () => {
+        const client = mockClient(new Error('Network timeout'), true);
+        const mcpTools = [
+            { name: 'timeout_tool', description: 'Timeouts' },
+        ];
+        const tools = (0, converter_js_1.convertTools)(mcpTools, client);
+        const result = await tools[0].invoke({});
+        (0, vitest_1.expect)(result).toBe('Error: Network timeout');
+    });
+});
+(0, vitest_1.describe)('formatToolResult', () => {
+    (0, vitest_1.it)('formats single text content', () => {
+        (0, vitest_1.expect)((0, converter_js_1.formatToolResult)({
+            content: [{ type: 'text', text: 'Hello' }],
+        })).toBe('Hello');
+    });
+    (0, vitest_1.it)('concatenates multiple text blocks', () => {
+        (0, vitest_1.expect)((0, converter_js_1.formatToolResult)({
+            content: [
+                { type: 'text', text: 'Line 1' },
+                { type: 'text', text: 'Line 2' },
+            ],
+        })).toBe('Line 1\nLine 2');
+    });
+    (0, vitest_1.it)('prefixes error results', () => {
+        (0, vitest_1.expect)((0, converter_js_1.formatToolResult)({
+            content: [{ type: 'text', text: 'Failed' }],
+            isError: true,
+        })).toBe('Error: Failed');
+    });
+    (0, vitest_1.it)('handles empty content', () => {
+        (0, vitest_1.expect)((0, converter_js_1.formatToolResult)({ content: [] })).toBe('Success (no output)');
+        (0, vitest_1.expect)((0, converter_js_1.formatToolResult)({})).toBe('Success (no output)');
+    });
+    (0, vitest_1.it)('handles empty content with isError', () => {
+        (0, vitest_1.expect)((0, converter_js_1.formatToolResult)({ content: [], isError: true })).toBe('Error: Tool returned no content');
+    });
+});
+//# sourceMappingURL=converter.test.js.map

package/dist/commonjs/__tests__/converter.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"converter.test.js","sourceRoot":"","sources":["../../../src/__tests__/converter.test.ts"],"names":[],"mappings":"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"}

package/dist/commonjs/__tests__/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/dist/commonjs/__tests__/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/index.test.ts"],"names":[],"mappings":""}

package/dist/commonjs/__tests__/index.test.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const index_js_1 = require("../index.js");
+(0, vitest_1.describe)('createAerostackLangChain', () => {
+    (0, vitest_1.it)('returns an object with tools() and workspaceClient', () => {
+        const client = (0, index_js_1.createAerostackLangChain)({
+            workspace: 'test-ws',
+            token: 'mwt_test',
+        });
+        (0, vitest_1.expect)(client.tools).toBeTypeOf('function');
+        (0, vitest_1.expect)(client.workspaceClient).toBeDefined();
+    });
+});
+(0, vitest_1.describe)('getTools', () => {
+    (0, vitest_1.it)('is exported as a function', () => {
+        (0, vitest_1.expect)(index_js_1.getTools).toBeTypeOf('function');
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/dist/commonjs/__tests__/index.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../../../src/__tests__/index.test.ts"],"names":[],"mappings":";;AAAA,mCAA8C;AAC9C,0CAAiE;AAEjE,IAAA,iBAAQ,EAAC,0BAA0B,EAAE,GAAG,EAAE;IACtC,IAAA,WAAE,EAAC,oDAAoD,EAAE,GAAG,EAAE;QAC1D,MAAM,MAAM,GAAG,IAAA,mCAAwB,EAAC;YACpC,SAAS,EAAE,SAAS;YACpB,KAAK,EAAE,UAAU;SACpB,CAAC,CAAC;QAEH,IAAA,eAAM,EAAC,MAAM,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QAC5C,IAAA,eAAM,EAAC,MAAM,CAAC,eAAe,CAAC,CAAC,WAAW,EAAE,CAAC;IACjD,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC;AAEH,IAAA,iBAAQ,EAAC,UAAU,EAAE,GAAG,EAAE;IACtB,IAAA,WAAE,EAAC,2BAA2B,EAAE,GAAG,EAAE;QACjC,IAAA,eAAM,EAAC,mBAAQ,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/commonjs/converter.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Converts Aerostack McpTool definitions to LangChain.js tool format.
+ */
+import { DynamicStructuredTool } from '@langchain/core/tools';
+import { WorkspaceClient } from '@aerostack/core';
+import type { McpTool, McpToolResult } from '@aerostack/core';
+/**
+ * Convert McpTool array to LangChain DynamicStructuredTool array.
+ *
+ * Each tool gets a function that proxies through WorkspaceClient.callTool().
+ * Pass the resulting array directly to `createReactAgent({ tools })` or
+ * `model.bindTools(tools)`.
+ *
+ * @param mcpTools - Tools from WorkspaceClient.listTools()
+ * @param client - WorkspaceClient instance for executing tool calls
+ */
+export declare function convertTools(mcpTools: McpTool[], client: WorkspaceClient): DynamicStructuredTool[];
+/**
+ * Flatten McpToolResult content array into a single string.
+ */
+export declare function formatToolResult(result: McpToolResult): string;
+//# sourceMappingURL=converter.d.ts.map

package/dist/commonjs/converter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"converter.d.ts","sourceRoot":"","sources":["../../src/converter.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAkB,MAAM,iBAAiB,CAAC;AAClE,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE9D;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CACxB,QAAQ,EAAE,OAAO,EAAE,EACnB,MAAM,EAAE,eAAe,GACxB,qBAAqB,EAAE,CAiCzB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAkB9D"}

package/dist/commonjs/converter.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convertTools = convertTools;
+exports.formatToolResult = formatToolResult;
+/**
+ * Converts Aerostack McpTool definitions to LangChain.js tool format.
+ */
+const tools_1 = require("@langchain/core/tools");
+const core_1 = require("@aerostack/core");
+/**
+ * Convert McpTool array to LangChain DynamicStructuredTool array.
+ *
+ * Each tool gets a function that proxies through WorkspaceClient.callTool().
+ * Pass the resulting array directly to `createReactAgent({ tools })` or
+ * `model.bindTools(tools)`.
+ *
+ * @param mcpTools - Tools from WorkspaceClient.listTools()
+ * @param client - WorkspaceClient instance for executing tool calls
+ */
+function convertTools(mcpTools, client) {
+    const tools = [];
+    for (const mcpTool of mcpTools) {
+        if (!mcpTool.name)
+            continue;
+        const schema = mcpTool.inputSchema
+            ? mcpTool.inputSchema
+            : { type: 'object', properties: {} };
+        tools.push(new tools_1.DynamicStructuredTool({
+            name: mcpTool.name,
+            description: mcpTool.description ?? `${mcpTool.name} tool`,
+            schema,
+            func: async (args) => {
+                try {
+                    const result = await client.callTool(mcpTool.name, args);
+                    return formatToolResult(result);
+                }
+                catch (err) {
+                    if (err instanceof core_1.AerostackError) {
+                        return `Error (${err.rpcCode}): ${err.message}`;
+                    }
+                    return err instanceof Error
+                        ? `Error: ${err.message}`
+                        : 'Error: Unknown error executing tool';
+                }
+            },
+        }));
+    }
+    return tools;
+}
+/**
+ * Flatten McpToolResult content array into a single string.
+ */
+function formatToolResult(result) {
+    if (!result.content || result.content.length === 0) {
+        return result.isError ? 'Error: Tool returned no content' : 'Success (no output)';
+    }
+    const parts = [];
+    for (const block of result.content) {
+        if (block.text) {
+            parts.push(block.text);
+        }
+        else if (block.data) {
+            parts.push(`[${block.mimeType ?? 'binary'} data: ${block.data.length} chars base64]`);
+        }
+        else {
+            parts.push(JSON.stringify(block));
+        }
+    }
+    const text = parts.join('\n');
+    return result.isError ? `Error: ${text}` : text;
+}
+//# sourceMappingURL=converter.js.map

package/dist/commonjs/converter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"converter.js","sourceRoot":"","sources":["../../src/converter.ts"],"names":[],"mappings":";;AAiBA,oCAoCC;AAKD,4CAkBC;AA5ED;;GAEG;AACH,iDAA8D;AAC9D,0CAAkE;AAGlE;;;;;;;;;GASG;AACH,SAAgB,YAAY,CACxB,QAAmB,EACnB,MAAuB;IAEvB,MAAM,KAAK,GAA4B,EAAE,CAAC;IAE1C,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC7B,IAAI,CAAC,OAAO,CAAC,IAAI;YAAE,SAAS;QAE5B,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW;YAC9B,CAAC,CAAE,OAAO,CAAC,WAAuC;YAClD,CAAC,CAAC,EAAE,IAAI,EAAE,QAAiB,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;QAElD,KAAK,CAAC,IAAI,CACN,IAAI,6BAAqB,CAAC;YACtB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,GAAG,OAAO,CAAC,IAAI,OAAO;YAC1D,MAAM;YACN,IAAI,EAAE,KAAK,EAAE,IAA6B,EAAE,EAAE;gBAC1C,IAAI,CAAC;oBACD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;oBACzD,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC;gBACpC,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACX,IAAI,GAAG,YAAY,qBAAc,EAAE,CAAC;wBAChC,OAAO,UAAU,GAAG,CAAC,OAAO,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC;oBACpD,CAAC;oBACD,OAAO,GAAG,YAAY,KAAK;wBACvB,CAAC,CAAC,UAAU,GAAG,CAAC,OAAO,EAAE;wBACzB,CAAC,CAAC,qCAAqC,CAAC;gBAChD,CAAC;YACL,CAAC;SACJ,CAAC,CACL,CAAC;IACN,CAAC;IAED,OAAO,KAAK,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,SAAgB,gBAAgB,CAAC,MAAqB;IAClD,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjD,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,iCAAiC,CAAC,CAAC,CAAC,qBAAqB,CAAC;IACtF,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACjC,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YACb,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YACpB,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,QAAQ,IAAI,QAAQ,UAAU,KAAK,CAAC,IAAI,CAAC,MAAM,gBAAgB,CAAC,CAAC;QAC1F,CAAC;aAAM,CAAC;YACJ,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QACtC,CAAC;IACL,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACpD,CAAC"}

package/dist/commonjs/index.d.ts

@@ -0,0 +1,69 @@
+/**
+ * @aerostack/sdk-langchain — Use Aerostack workspace tools as LangChain.js tools.
+ *
+ * @example
+ * ```ts
+ * import { ChatOpenAI } from '@langchain/openai';
+ * import { createReactAgent } from '@langchain/langgraph/prebuilt';
+ * import { getTools } from '@aerostack/sdk-langchain';
+ *
+ * const tools = await getTools({ workspace: 'my-workspace', token: 'mwt_...' });
+ *
+ * const agent = createReactAgent({
+ *     llm: new ChatOpenAI({ model: 'gpt-4o' }),
+ *     tools,
+ * });
+ *
+ * const result = await agent.invoke({
+ *     messages: [{ role: 'user', content: 'Create a GitHub issue for the login bug' }],
+ * });
+ * ```
+ *
+ * @example Direct tool binding
+ * ```ts
+ * import { ChatAnthropic } from '@langchain/anthropic';
+ * import { getTools } from '@aerostack/sdk-langchain';
+ *
+ * const tools = await getTools({ workspace: 'my-workspace', token: 'mwt_...' });
+ * const model = new ChatAnthropic({ model: 'claude-sonnet-4-20250514' }).bindTools(tools);
+ * ```
+ */
+import type { DynamicStructuredTool } from '@langchain/core/tools';
+import { WorkspaceClient } from '@aerostack/core';
+import type { McpTool } from '@aerostack/core';
+export { formatToolResult } from './converter.js';
+export interface WorkspaceConfig {
+    /** Workspace slug */
+    workspace: string;
+    /** Workspace token (mwt_...) */
+    token: string;
+    /** Override gateway base URL */
+    baseUrl?: string;
+}
+/** Result from getTools. */
+export interface ToolSetResult {
+    /** LangChain tools — pass to createReactAgent({ tools }) or model.bindTools(tools) */
+    tools: DynamicStructuredTool[];
+    /** Raw MCP tools from the workspace for inspection */
+    raw: McpTool[];
+}
+/**
+ * Fetch tools from an Aerostack workspace and convert to LangChain format.
+ *
+ * Each tool includes a function that calls the workspace gateway,
+ * so you just pass the tools to an agent or bind them to a model.
+ */
+export declare function getTools(config: WorkspaceConfig): Promise<ToolSetResult>;
+export interface AerostackLangChainClient {
+    /** Fetch and convert workspace tools to LangChain format. */
+    tools(): Promise<ToolSetResult>;
+    /** Access the underlying WorkspaceClient for advanced use. */
+    readonly workspaceClient: WorkspaceClient;
+}
+/**
+ * Create a reusable Aerostack LangChain client.
+ *
+ * Reuses a single WorkspaceClient instance across tool calls.
+ */
+export declare function createAerostackLangChain(config: WorkspaceConfig): AerostackLangChainClient;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAG/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,WAAW,eAAe;IAC5B,qBAAqB;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,4BAA4B;AAC5B,MAAM,WAAW,aAAa;IAC1B,sFAAsF;IACtF,KAAK,EAAE,qBAAqB,EAAE,CAAC;IAC/B,sDAAsD;IACtD,GAAG,EAAE,OAAO,EAAE,CAAC;CAClB;AAcD;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,CAAC,CAK9E;AAMD,MAAM,WAAW,wBAAwB;IACrC,6DAA6D;IAC7D,KAAK,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;IAChC,8DAA8D;IAC9D,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;CAC7C;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,eAAe,GAAG,wBAAwB,CAc1F"}

package/dist/commonjs/index.js

@@ -0,0 +1,80 @@
+"use strict";
+/**
+ * @aerostack/sdk-langchain — Use Aerostack workspace tools as LangChain.js tools.
+ *
+ * @example
+ * ```ts
+ * import { ChatOpenAI } from '@langchain/openai';
+ * import { createReactAgent } from '@langchain/langgraph/prebuilt';
+ * import { getTools } from '@aerostack/sdk-langchain';
+ *
+ * const tools = await getTools({ workspace: 'my-workspace', token: 'mwt_...' });
+ *
+ * const agent = createReactAgent({
+ *     llm: new ChatOpenAI({ model: 'gpt-4o' }),
+ *     tools,
+ * });
+ *
+ * const result = await agent.invoke({
+ *     messages: [{ role: 'user', content: 'Create a GitHub issue for the login bug' }],
+ * });
+ * ```
+ *
+ * @example Direct tool binding
+ * ```ts
+ * import { ChatAnthropic } from '@langchain/anthropic';
+ * import { getTools } from '@aerostack/sdk-langchain';
+ *
+ * const tools = await getTools({ workspace: 'my-workspace', token: 'mwt_...' });
+ * const model = new ChatAnthropic({ model: 'claude-sonnet-4-20250514' }).bindTools(tools);
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatToolResult = void 0;
+exports.getTools = getTools;
+exports.createAerostackLangChain = createAerostackLangChain;
+const core_1 = require("@aerostack/core");
+const converter_js_1 = require("./converter.js");
+var converter_js_2 = require("./converter.js");
+Object.defineProperty(exports, "formatToolResult", { enumerable: true, get: function () { return converter_js_2.formatToolResult; } });
+function createWorkspaceClient(config) {
+    return new core_1.WorkspaceClient({
+        slug: config.workspace,
+        token: config.token,
+        baseUrl: config.baseUrl,
+    });
+}
+// ---------------------------------------------------------------------------
+// Standalone function
+// ---------------------------------------------------------------------------
+/**
+ * Fetch tools from an Aerostack workspace and convert to LangChain format.
+ *
+ * Each tool includes a function that calls the workspace gateway,
+ * so you just pass the tools to an agent or bind them to a model.
+ */
+async function getTools(config) {
+    const client = createWorkspaceClient(config);
+    const raw = await client.listTools();
+    const tools = (0, converter_js_1.convertTools)(raw, client);
+    return { tools, raw };
+}
+/**
+ * Create a reusable Aerostack LangChain client.
+ *
+ * Reuses a single WorkspaceClient instance across tool calls.
+ */
+function createAerostackLangChain(config) {
+    const wsClient = createWorkspaceClient(config);
+    return {
+        async tools() {
+            const raw = await wsClient.listTools();
+            const tools = (0, converter_js_1.convertTools)(raw, wsClient);
+            return { tools, raw };
+        },
+        get workspaceClient() {
+            return wsClient;
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/commonjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;;;AA4CH,4BAKC;AAkBD,4DAcC;AA9ED,0CAAkD;AAElD,iDAA8C;AAE9C,+CAAkD;AAAzC,gHAAA,gBAAgB,OAAA;AAmBzB,SAAS,qBAAqB,CAAC,MAAuB;IAClD,OAAO,IAAI,sBAAe,CAAC;QACvB,IAAI,EAAE,MAAM,CAAC,SAAS;QACtB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,OAAO,EAAE,MAAM,CAAC,OAAO;KAC1B,CAAC,CAAC;AACP,CAAC;AAED,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E;;;;;GAKG;AACI,KAAK,UAAU,QAAQ,CAAC,MAAuB;IAClD,MAAM,MAAM,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC;IACrC,MAAM,KAAK,GAAG,IAAA,2BAAY,EAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACxC,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;AAC1B,CAAC;AAaD;;;;GAIG;AACH,SAAgB,wBAAwB,CAAC,MAAuB;IAC5D,MAAM,QAAQ,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAE/C,OAAO;QACH,KAAK,CAAC,KAAK;YACP,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,SAAS,EAAE,CAAC;YACvC,MAAM,KAAK,GAAG,IAAA,2BAAY,EAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;YAC1C,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;QAC1B,CAAC;QAED,IAAI,eAAe;YACf,OAAO,QAAQ,CAAC;QACpB,CAAC;KACJ,CAAC;AACN,CAAC"}

package/dist/commonjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/dist/esm/__tests__/converter.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=converter.test.d.ts.map

package/dist/esm/__tests__/converter.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"converter.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/converter.test.ts"],"names":[],"mappings":""}

package/dist/esm/__tests__/converter.test.js

@@ -0,0 +1,123 @@
+import { describe, it, expect, vi } from 'vitest';
+import { convertTools, formatToolResult } from '../converter.js';
+import { AerostackError } from '@aerostack/core';
+function mockClient(callToolResult, shouldThrow = false) {
+    return {
+        callTool: shouldThrow
+            ? vi.fn().mockRejectedValue(callToolResult)
+            : vi.fn().mockResolvedValue(callToolResult),
+    };
+}
+describe('convertTools', () => {
+    it('converts MCP tools to LangChain DynamicStructuredTool array', () => {
+        const mcpTools = [
+            {
+                name: 'github__create_issue',
+                description: 'Create a GitHub issue',
+                inputSchema: {
+                    type: 'object',
+                    properties: { title: { type: 'string' } },
+                    required: ['title'],
+                },
+            },
+            {
+                name: 'slack__post_message',
+                description: 'Post to Slack',
+            },
+        ];
+        const client = mockClient({});
+        const tools = convertTools(mcpTools, client);
+        expect(tools).toHaveLength(2);
+        expect(tools[0].name).toBe('github__create_issue');
+        expect(tools[0].description).toBe('Create a GitHub issue');
+        expect(tools[1].name).toBe('slack__post_message');
+    });
+    it('handles tools with no description', () => {
+        const mcpTools = [
+            { name: 'my_tool', inputSchema: { type: 'object', properties: {} } },
+        ];
+        const client = mockClient({});
+        const tools = convertTools(mcpTools, client);
+        expect(tools[0].name).toBe('my_tool');
+        expect(tools[0].description).toBe('my_tool tool');
+    });
+    it('skips tools with empty names', () => {
+        const mcpTools = [
+            { name: '', description: 'Bad' },
+            { name: 'good', description: 'Good' },
+        ];
+        const client = mockClient({});
+        const tools = convertTools(mcpTools, client);
+        expect(tools).toHaveLength(1);
+        expect(tools[0].name).toBe('good');
+    });
+    it('handles empty tools array', () => {
+        const client = mockClient({});
+        expect(convertTools([], client)).toEqual([]);
+    });
+    it('tool invoke calls WorkspaceClient.callTool', async () => {
+        const mcpTools = [
+            {
+                name: 'test_tool',
+                description: 'Test',
+                inputSchema: { type: 'object', properties: { x: { type: 'number' } } },
+            },
+        ];
+        const client = mockClient({
+            content: [{ type: 'text', text: 'result123' }],
+        });
+        const tools = convertTools(mcpTools, client);
+        const result = await tools[0].invoke({ x: 42 });
+        expect(client.callTool).toHaveBeenCalledWith('test_tool', { x: 42 });
+        expect(result).toBe('result123');
+    });
+    it('tool handles AerostackError gracefully', async () => {
+        const err = new AerostackError('Server down', 503, -32603, 'req-1');
+        const client = mockClient(err, true);
+        const mcpTools = [
+            { name: 'failing_tool', description: 'Fails' },
+        ];
+        const tools = convertTools(mcpTools, client);
+        const result = await tools[0].invoke({});
+        expect(result).toContain('Error (-32603)');
+        expect(result).toContain('Server down');
+    });
+    it('tool handles generic errors', async () => {
+        const client = mockClient(new Error('Network timeout'), true);
+        const mcpTools = [
+            { name: 'timeout_tool', description: 'Timeouts' },
+        ];
+        const tools = convertTools(mcpTools, client);
+        const result = await tools[0].invoke({});
+        expect(result).toBe('Error: Network timeout');
+    });
+});
+describe('formatToolResult', () => {
+    it('formats single text content', () => {
+        expect(formatToolResult({
+            content: [{ type: 'text', text: 'Hello' }],
+        })).toBe('Hello');
+    });
+    it('concatenates multiple text blocks', () => {
+        expect(formatToolResult({
+            content: [
+                { type: 'text', text: 'Line 1' },
+                { type: 'text', text: 'Line 2' },
+            ],
+        })).toBe('Line 1\nLine 2');
+    });
+    it('prefixes error results', () => {
+        expect(formatToolResult({
+            content: [{ type: 'text', text: 'Failed' }],
+            isError: true,
+        })).toBe('Error: Failed');
+    });
+    it('handles empty content', () => {
+        expect(formatToolResult({ content: [] })).toBe('Success (no output)');
+        expect(formatToolResult({})).toBe('Success (no output)');
+    });
+    it('handles empty content with isError', () => {
+        expect(formatToolResult({ content: [], isError: true })).toBe('Error: Tool returned no content');
+    });
+});
+//# sourceMappingURL=converter.test.js.map

package/dist/esm/__tests__/converter.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"converter.test.js","sourceRoot":"","sources":["../../../src/__tests__/converter.test.ts"],"names":[],"mappings":"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"}

package/dist/esm/__tests__/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/dist/esm/__tests__/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/index.test.ts"],"names":[],"mappings":""}

package/dist/esm/__tests__/index.test.js

@@ -0,0 +1,18 @@
+import { describe, it, expect } from 'vitest';
+import { getTools, createAerostackLangChain } from '../index.js';
+describe('createAerostackLangChain', () => {
+    it('returns an object with tools() and workspaceClient', () => {
+        const client = createAerostackLangChain({
+            workspace: 'test-ws',
+            token: 'mwt_test',
+        });
+        expect(client.tools).toBeTypeOf('function');
+        expect(client.workspaceClient).toBeDefined();
+    });
+});
+describe('getTools', () => {
+    it('is exported as a function', () => {
+        expect(getTools).toBeTypeOf('function');
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/dist/esm/__tests__/index.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../../../src/__tests__/index.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAEjE,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;IACtC,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC1D,MAAM,MAAM,GAAG,wBAAwB,CAAC;YACpC,SAAS,EAAE,SAAS;YACpB,KAAK,EAAE,UAAU;SACpB,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QAC5C,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,WAAW,EAAE,CAAC;IACjD,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE;IACtB,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACjC,MAAM,CAAC,QAAQ,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/esm/converter.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Converts Aerostack McpTool definitions to LangChain.js tool format.
+ */
+import { DynamicStructuredTool } from '@langchain/core/tools';
+import { WorkspaceClient } from '@aerostack/core';
+import type { McpTool, McpToolResult } from '@aerostack/core';
+/**
+ * Convert McpTool array to LangChain DynamicStructuredTool array.
+ *
+ * Each tool gets a function that proxies through WorkspaceClient.callTool().
+ * Pass the resulting array directly to `createReactAgent({ tools })` or
+ * `model.bindTools(tools)`.
+ *
+ * @param mcpTools - Tools from WorkspaceClient.listTools()
+ * @param client - WorkspaceClient instance for executing tool calls
+ */
+export declare function convertTools(mcpTools: McpTool[], client: WorkspaceClient): DynamicStructuredTool[];
+/**
+ * Flatten McpToolResult content array into a single string.
+ */
+export declare function formatToolResult(result: McpToolResult): string;
+//# sourceMappingURL=converter.d.ts.map

package/dist/esm/converter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"converter.d.ts","sourceRoot":"","sources":["../../src/converter.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAkB,MAAM,iBAAiB,CAAC;AAClE,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE9D;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CACxB,QAAQ,EAAE,OAAO,EAAE,EACnB,MAAM,EAAE,eAAe,GACxB,qBAAqB,EAAE,CAiCzB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAkB9D"}

package/dist/esm/converter.js

@@ -0,0 +1,68 @@
+/**
+ * Converts Aerostack McpTool definitions to LangChain.js tool format.
+ */
+import { DynamicStructuredTool } from '@langchain/core/tools';
+import { AerostackError } from '@aerostack/core';
+/**
+ * Convert McpTool array to LangChain DynamicStructuredTool array.
+ *
+ * Each tool gets a function that proxies through WorkspaceClient.callTool().
+ * Pass the resulting array directly to `createReactAgent({ tools })` or
+ * `model.bindTools(tools)`.
+ *
+ * @param mcpTools - Tools from WorkspaceClient.listTools()
+ * @param client - WorkspaceClient instance for executing tool calls
+ */
+export function convertTools(mcpTools, client) {
+    const tools = [];
+    for (const mcpTool of mcpTools) {
+        if (!mcpTool.name)
+            continue;
+        const schema = mcpTool.inputSchema
+            ? mcpTool.inputSchema
+            : { type: 'object', properties: {} };
+        tools.push(new DynamicStructuredTool({
+            name: mcpTool.name,
+            description: mcpTool.description ?? `${mcpTool.name} tool`,
+            schema,
+            func: async (args) => {
+                try {
+                    const result = await client.callTool(mcpTool.name, args);
+                    return formatToolResult(result);
+                }
+                catch (err) {
+                    if (err instanceof AerostackError) {
+                        return `Error (${err.rpcCode}): ${err.message}`;
+                    }
+                    return err instanceof Error
+                        ? `Error: ${err.message}`
+                        : 'Error: Unknown error executing tool';
+                }
+            },
+        }));
+    }
+    return tools;
+}
+/**
+ * Flatten McpToolResult content array into a single string.
+ */
+export function formatToolResult(result) {
+    if (!result.content || result.content.length === 0) {
+        return result.isError ? 'Error: Tool returned no content' : 'Success (no output)';
+    }
+    const parts = [];
+    for (const block of result.content) {
+        if (block.text) {
+            parts.push(block.text);
+        }
+        else if (block.data) {
+            parts.push(`[${block.mimeType ?? 'binary'} data: ${block.data.length} chars base64]`);
+        }
+        else {
+            parts.push(JSON.stringify(block));
+        }
+    }
+    const text = parts.join('\n');
+    return result.isError ? `Error: ${text}` : text;
+}
+//# sourceMappingURL=converter.js.map

package/dist/esm/converter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"converter.js","sourceRoot":"","sources":["../../src/converter.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAmB,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGlE;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY,CACxB,QAAmB,EACnB,MAAuB;IAEvB,MAAM,KAAK,GAA4B,EAAE,CAAC;IAE1C,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC7B,IAAI,CAAC,OAAO,CAAC,IAAI;YAAE,SAAS;QAE5B,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW;YAC9B,CAAC,CAAE,OAAO,CAAC,WAAuC;YAClD,CAAC,CAAC,EAAE,IAAI,EAAE,QAAiB,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;QAElD,KAAK,CAAC,IAAI,CACN,IAAI,qBAAqB,CAAC;YACtB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,GAAG,OAAO,CAAC,IAAI,OAAO;YAC1D,MAAM;YACN,IAAI,EAAE,KAAK,EAAE,IAA6B,EAAE,EAAE;gBAC1C,IAAI,CAAC;oBACD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;oBACzD,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC;gBACpC,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACX,IAAI,GAAG,YAAY,cAAc,EAAE,CAAC;wBAChC,OAAO,UAAU,GAAG,CAAC,OAAO,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC;oBACpD,CAAC;oBACD,OAAO,GAAG,YAAY,KAAK;wBACvB,CAAC,CAAC,UAAU,GAAG,CAAC,OAAO,EAAE;wBACzB,CAAC,CAAC,qCAAqC,CAAC;gBAChD,CAAC;YACL,CAAC;SACJ,CAAC,CACL,CAAC;IACN,CAAC;IAED,OAAO,KAAK,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAqB;IAClD,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjD,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,iCAAiC,CAAC,CAAC,CAAC,qBAAqB,CAAC;IACtF,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACjC,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YACb,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YACpB,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,QAAQ,IAAI,QAAQ,UAAU,KAAK,CAAC,IAAI,CAAC,MAAM,gBAAgB,CAAC,CAAC;QAC1F,CAAC;aAAM,CAAC;YACJ,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QACtC,CAAC;IACL,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACpD,CAAC"}

package/dist/esm/index.d.ts

@@ -0,0 +1,69 @@
+/**
+ * @aerostack/sdk-langchain — Use Aerostack workspace tools as LangChain.js tools.
+ *
+ * @example
+ * ```ts
+ * import { ChatOpenAI } from '@langchain/openai';
+ * import { createReactAgent } from '@langchain/langgraph/prebuilt';
+ * import { getTools } from '@aerostack/sdk-langchain';
+ *
+ * const tools = await getTools({ workspace: 'my-workspace', token: 'mwt_...' });
+ *
+ * const agent = createReactAgent({
+ *     llm: new ChatOpenAI({ model: 'gpt-4o' }),
+ *     tools,
+ * });
+ *
+ * const result = await agent.invoke({
+ *     messages: [{ role: 'user', content: 'Create a GitHub issue for the login bug' }],
+ * });
+ * ```
+ *
+ * @example Direct tool binding
+ * ```ts
+ * import { ChatAnthropic } from '@langchain/anthropic';
+ * import { getTools } from '@aerostack/sdk-langchain';
+ *
+ * const tools = await getTools({ workspace: 'my-workspace', token: 'mwt_...' });
+ * const model = new ChatAnthropic({ model: 'claude-sonnet-4-20250514' }).bindTools(tools);
+ * ```
+ */
+import type { DynamicStructuredTool } from '@langchain/core/tools';
+import { WorkspaceClient } from '@aerostack/core';
+import type { McpTool } from '@aerostack/core';
+export { formatToolResult } from './converter.js';
+export interface WorkspaceConfig {
+    /** Workspace slug */
+    workspace: string;
+    /** Workspace token (mwt_...) */
+    token: string;
+    /** Override gateway base URL */
+    baseUrl?: string;
+}
+/** Result from getTools. */
+export interface ToolSetResult {
+    /** LangChain tools — pass to createReactAgent({ tools }) or model.bindTools(tools) */
+    tools: DynamicStructuredTool[];
+    /** Raw MCP tools from the workspace for inspection */
+    raw: McpTool[];
+}
+/**
+ * Fetch tools from an Aerostack workspace and convert to LangChain format.
+ *
+ * Each tool includes a function that calls the workspace gateway,
+ * so you just pass the tools to an agent or bind them to a model.
+ */
+export declare function getTools(config: WorkspaceConfig): Promise<ToolSetResult>;
+export interface AerostackLangChainClient {
+    /** Fetch and convert workspace tools to LangChain format. */
+    tools(): Promise<ToolSetResult>;
+    /** Access the underlying WorkspaceClient for advanced use. */
+    readonly workspaceClient: WorkspaceClient;
+}
+/**
+ * Create a reusable Aerostack LangChain client.
+ *
+ * Reuses a single WorkspaceClient instance across tool calls.
+ */
+export declare function createAerostackLangChain(config: WorkspaceConfig): AerostackLangChainClient;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAG/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,WAAW,eAAe;IAC5B,qBAAqB;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,4BAA4B;AAC5B,MAAM,WAAW,aAAa;IAC1B,sFAAsF;IACtF,KAAK,EAAE,qBAAqB,EAAE,CAAC;IAC/B,sDAAsD;IACtD,GAAG,EAAE,OAAO,EAAE,CAAC;CAClB;AAcD;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,CAAC,CAK9E;AAMD,MAAM,WAAW,wBAAwB;IACrC,6DAA6D;IAC7D,KAAK,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;IAChC,8DAA8D;IAC9D,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;CAC7C;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,eAAe,GAAG,wBAAwB,CAc1F"}

package/dist/esm/index.js

@@ -0,0 +1,74 @@
+/**
+ * @aerostack/sdk-langchain — Use Aerostack workspace tools as LangChain.js tools.
+ *
+ * @example
+ * ```ts
+ * import { ChatOpenAI } from '@langchain/openai';
+ * import { createReactAgent } from '@langchain/langgraph/prebuilt';
+ * import { getTools } from '@aerostack/sdk-langchain';
+ *
+ * const tools = await getTools({ workspace: 'my-workspace', token: 'mwt_...' });
+ *
+ * const agent = createReactAgent({
+ *     llm: new ChatOpenAI({ model: 'gpt-4o' }),
+ *     tools,
+ * });
+ *
+ * const result = await agent.invoke({
+ *     messages: [{ role: 'user', content: 'Create a GitHub issue for the login bug' }],
+ * });
+ * ```
+ *
+ * @example Direct tool binding
+ * ```ts
+ * import { ChatAnthropic } from '@langchain/anthropic';
+ * import { getTools } from '@aerostack/sdk-langchain';
+ *
+ * const tools = await getTools({ workspace: 'my-workspace', token: 'mwt_...' });
+ * const model = new ChatAnthropic({ model: 'claude-sonnet-4-20250514' }).bindTools(tools);
+ * ```
+ */
+import { WorkspaceClient } from '@aerostack/core';
+import { convertTools } from './converter.js';
+export { formatToolResult } from './converter.js';
+function createWorkspaceClient(config) {
+    return new WorkspaceClient({
+        slug: config.workspace,
+        token: config.token,
+        baseUrl: config.baseUrl,
+    });
+}
+// ---------------------------------------------------------------------------
+// Standalone function
+// ---------------------------------------------------------------------------
+/**
+ * Fetch tools from an Aerostack workspace and convert to LangChain format.
+ *
+ * Each tool includes a function that calls the workspace gateway,
+ * so you just pass the tools to an agent or bind them to a model.
+ */
+export async function getTools(config) {
+    const client = createWorkspaceClient(config);
+    const raw = await client.listTools();
+    const tools = convertTools(raw, client);
+    return { tools, raw };
+}
+/**
+ * Create a reusable Aerostack LangChain client.
+ *
+ * Reuses a single WorkspaceClient instance across tool calls.
+ */
+export function createAerostackLangChain(config) {
+    const wsClient = createWorkspaceClient(config);
+    return {
+        async tools() {
+            const raw = await wsClient.listTools();
+            const tools = convertTools(raw, wsClient);
+            return { tools, raw };
+        },
+        get workspaceClient() {
+            return wsClient;
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAmBlD,SAAS,qBAAqB,CAAC,MAAuB;IAClD,OAAO,IAAI,eAAe,CAAC;QACvB,IAAI,EAAE,MAAM,CAAC,SAAS;QACtB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,OAAO,EAAE,MAAM,CAAC,OAAO;KAC1B,CAAC,CAAC;AACP,CAAC;AAED,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,MAAuB;IAClD,MAAM,MAAM,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC;IACrC,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACxC,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;AAC1B,CAAC;AAaD;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAuB;IAC5D,MAAM,QAAQ,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAE/C,OAAO;QACH,KAAK,CAAC,KAAK;YACP,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,SAAS,EAAE,CAAC;YACvC,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;YAC1C,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;QAC1B,CAAC;QAED,IAAI,eAAe;YACf,OAAO,QAAQ,CAAC;QACpB,CAAC;KACJ,CAAC;AACN,CAAC"}

package/dist/esm/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "module"
+}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@aerostack/sdk-langchain",
+  "version": "0.10.1",
+  "description": "Use Aerostack workspace tools as LangChain.js tools",
+  "author": "Aerostack",
+  "license": "MIT",
+  "type": "module",
+  "tshy": {
+    "sourceDialects": [
+      "@aerostack/sdk-langchain/source"
+    ],
+    "exports": {
+      ".": "./src/index.ts",
+      "./package.json": "./package.json"
+    }
+  },
+  "sideEffects": false,
+  "scripts": {
+    "lint": "eslint --cache --max-warnings=0 src",
+    "build": "tshy",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@aerostack/core": "^0.10.1"
+  },
+  "peerDependencies": {
+    "@langchain/core": ">=0.2.0"
+  },
+  "peerDependenciesMeta": {
+    "@langchain/core": {
+      "optional": false
+    }
+  },
+  "devDependencies": {
+    "@langchain/core": "^0.3.0",
+    "tshy": "^2.0.0",
+    "typescript": "~5.8.3",
+    "vitest": "^3.2.1",
+    "zod": "^3.25.0"
+  },
+  "exports": {
+    ".": {
+      "import": {
+        "@aerostack/sdk-langchain/source": "./src/index.ts",
+        "types": "./dist/esm/index.d.ts",
+        "default": "./dist/esm/index.js"
+      },
+      "require": {
+        "types": "./dist/commonjs/index.d.ts",
+        "default": "./dist/commonjs/index.js"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/commonjs/index.js",
+  "types": "./dist/commonjs/index.d.ts",
+  "module": "./dist/esm/index.js",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}