@xi-era/acp-adapter-openai 0.1.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 xi-era (open-source community arm of Stellxis)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/dist/index.d.ts

@@ -0,0 +1,48 @@
+import { ComponentDescriptor, AcpClient } from '@xi-era/acp-sdk/client';
+
+/**
+ * ACP -> OpenAI Tool-Call adapter (spec 附录 B).
+ * Zero runtime dependencies besides the SDK: pure functions plus a handler
+ * factory that executes model tool_calls against an ACP client.
+ */
+
+/** Minimal OpenAI tool-call types (deliberately inline — no OpenAI SDK needed). */
+interface OpenAiToolDef {
+    type: "function";
+    function: {
+        name: string;
+        description: string;
+        parameters: object;
+    };
+}
+interface OpenAiToolCall {
+    id: string;
+    type?: "function";
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+interface OpenAiToolMessage {
+    role: "tool";
+    tool_call_id: string;
+    content: string;
+}
+/**
+ * Converts ACP component descriptors to OpenAI function tool definitions.
+ * name = component_id with "." -> "_" (spec §7.1 lossless mapping);
+ * parameters = the descriptor's draft-07 inputSchema, passed through as-is.
+ */
+declare function componentsToOpenaiTools(descriptors: ComponentDescriptor[]): OpenAiToolDef[];
+interface ToolCallHandlerOptions {
+    /** Max tool messages produced per invocation; default unlimited. */
+    limit?: number;
+}
+/**
+ * Creates a handler for the `tool_calls` array of an OpenAI assistant message.
+ * Each call's JSON arguments are parsed and used as the ACP `input`;
+ * the ACP result is returned serialized as the tool message content.
+ */
+declare function createToolCallHandler(client: AcpClient, options?: ToolCallHandlerOptions): (toolCalls: OpenAiToolCall[]) => Promise<OpenAiToolMessage[]>;
+
+export { type OpenAiToolCall, type OpenAiToolDef, type OpenAiToolMessage, type ToolCallHandlerOptions, componentsToOpenaiTools, createToolCallHandler };

package/dist/index.js

@@ -0,0 +1,44 @@
+// src/index.ts
+import { componentIdToToolName } from "@xi-era/acp-sdk/client";
+function componentsToOpenaiTools(descriptors) {
+  return descriptors.map((d) => ({
+    type: "function",
+    function: {
+      name: componentIdToToolName(d.id),
+      description: d.description,
+      parameters: d.inputSchema ?? { type: "object", properties: {}, required: [] }
+    }
+  }));
+}
+function createToolCallHandler(client, options = {}) {
+  return async (toolCalls) => {
+    const calls = options.limit ? toolCalls.slice(0, options.limit) : toolCalls;
+    return Promise.all(
+      calls.map(async (toolCall) => {
+        const componentId = toolCall.function.name.replaceAll("_", ".");
+        let input;
+        try {
+          input = toolCall.function.arguments ? JSON.parse(toolCall.function.arguments) : null;
+        } catch {
+          return {
+            role: "tool",
+            tool_call_id: toolCall.id,
+            content: `error: arguments is not valid JSON: ${toolCall.function.arguments}`
+          };
+        }
+        try {
+          const result = await client.call(componentId, input);
+          return { role: "tool", tool_call_id: toolCall.id, content: JSON.stringify(result) };
+        } catch (e) {
+          const message = e instanceof Error ? e.message : String(e);
+          return { role: "tool", tool_call_id: toolCall.id, content: `error: ${message}` };
+        }
+      })
+    );
+  };
+}
+export {
+  componentsToOpenaiTools,
+  createToolCallHandler
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * ACP -> OpenAI Tool-Call adapter (spec 附录 B).\n * Zero runtime dependencies besides the SDK: pure functions plus a handler\n * factory that executes model tool_calls against an ACP client.\n */\nimport type { ComponentDescriptor } from \"@xi-era/acp-sdk/client\";\nimport type { AcpClient } from \"@xi-era/acp-sdk/client\";\nimport { componentIdToToolName } from \"@xi-era/acp-sdk/client\";\n\n/** Minimal OpenAI tool-call types (deliberately inline — no OpenAI SDK needed). */\nexport interface OpenAiToolDef {\n  type: \"function\";\n  function: {\n    name: string;\n    description: string;\n    parameters: object;\n  };\n}\n\nexport interface OpenAiToolCall {\n  id: string;\n  type?: \"function\";\n  function: { name: string; arguments: string };\n}\n\nexport interface OpenAiToolMessage {\n  role: \"tool\";\n  tool_call_id: string;\n  content: string;\n}\n\n/**\n * Converts ACP component descriptors to OpenAI function tool definitions.\n * name = component_id with \".\" -> \"_\" (spec §7.1 lossless mapping);\n * parameters = the descriptor's draft-07 inputSchema, passed through as-is.\n */\nexport function componentsToOpenaiTools(descriptors: ComponentDescriptor[]): OpenAiToolDef[] {\n  return descriptors.map((d) => ({\n    type: \"function\" as const,\n    function: {\n      name: componentIdToToolName(d.id),\n      description: d.description,\n      parameters: d.inputSchema ?? { type: \"object\", properties: {}, required: [] },\n    },\n  }));\n}\n\nexport interface ToolCallHandlerOptions {\n  /** Max tool messages produced per invocation; default unlimited. */\n  limit?: number;\n}\n\n/**\n * Creates a handler for the `tool_calls` array of an OpenAI assistant message.\n * Each call's JSON arguments are parsed and used as the ACP `input`;\n * the ACP result is returned serialized as the tool message content.\n */\nexport function createToolCallHandler(\n  client: AcpClient,\n  options: ToolCallHandlerOptions = {}\n): (toolCalls: OpenAiToolCall[]) => Promise<OpenAiToolMessage[]> {\n  return async (toolCalls) => {\n    const calls = options.limit ? toolCalls.slice(0, options.limit) : toolCalls;\n    return Promise.all(\n      calls.map(async (toolCall): Promise<OpenAiToolMessage> => {\n        const componentId = toolCall.function.name.replaceAll(\"_\", \".\");\n        let input: unknown;\n        try {\n          input = toolCall.function.arguments ? JSON.parse(toolCall.function.arguments) : null;\n        } catch {\n          return {\n            role: \"tool\",\n            tool_call_id: toolCall.id,\n            content: `error: arguments is not valid JSON: ${toolCall.function.arguments}`,\n          };\n        }\n        try {\n          const result = await client.call(componentId, input);\n          return { role: \"tool\", tool_call_id: toolCall.id, content: JSON.stringify(result) };\n        } catch (e) {\n          const message = e instanceof Error ? e.message : String(e);\n          return { role: \"tool\", tool_call_id: toolCall.id, content: `error: ${message}` };\n        }\n      })\n    );\n  };\n}\n"],"mappings":";AAOA,SAAS,6BAA6B;AA6B/B,SAAS,wBAAwB,aAAqD;AAC3F,SAAO,YAAY,IAAI,CAAC,OAAO;AAAA,IAC7B,MAAM;AAAA,IACN,UAAU;AAAA,MACR,MAAM,sBAAsB,EAAE,EAAE;AAAA,MAChC,aAAa,EAAE;AAAA,MACf,YAAY,EAAE,eAAe,EAAE,MAAM,UAAU,YAAY,CAAC,GAAG,UAAU,CAAC,EAAE;AAAA,IAC9E;AAAA,EACF,EAAE;AACJ;AAYO,SAAS,sBACd,QACA,UAAkC,CAAC,GAC4B;AAC/D,SAAO,OAAO,cAAc;AAC1B,UAAM,QAAQ,QAAQ,QAAQ,UAAU,MAAM,GAAG,QAAQ,KAAK,IAAI;AAClE,WAAO,QAAQ;AAAA,MACb,MAAM,IAAI,OAAO,aAAyC;AACxD,cAAM,cAAc,SAAS,SAAS,KAAK,WAAW,KAAK,GAAG;AAC9D,YAAI;AACJ,YAAI;AACF,kBAAQ,SAAS,SAAS,YAAY,KAAK,MAAM,SAAS,SAAS,SAAS,IAAI;AAAA,QAClF,QAAQ;AACN,iBAAO;AAAA,YACL,MAAM;AAAA,YACN,cAAc,SAAS;AAAA,YACvB,SAAS,uCAAuC,SAAS,SAAS,SAAS;AAAA,UAC7E;AAAA,QACF;AACA,YAAI;AACF,gBAAM,SAAS,MAAM,OAAO,KAAK,aAAa,KAAK;AACnD,iBAAO,EAAE,MAAM,QAAQ,cAAc,SAAS,IAAI,SAAS,KAAK,UAAU,MAAM,EAAE;AAAA,QACpF,SAAS,GAAG;AACV,gBAAM,UAAU,aAAa,QAAQ,EAAE,UAAU,OAAO,CAAC;AACzD,iBAAO,EAAE,MAAM,QAAQ,cAAc,SAAS,IAAI,SAAS,UAAU,OAAO,GAAG;AAAA,QACjF;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF;AACF;","names":[]}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@xi-era/acp-adapter-openai",
+  "version": "0.1.0",
+  "description": "ACP (Agent-Component-Protocol) to OpenAI Tool-Call adapter — convert ACP component descriptors to OpenAI function tools and execute tool calls against ACP servers.",
+  "license": "MIT",
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "acp",
+    "openai",
+    "tool-call",
+    "adapter",
+    "agent"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xi-era/acp-protocol.git",
+    "directory": "packages/acp-adapter-openai"
+  },
+  "homepage": "https://github.com/xi-era/acp-protocol",
+  "dependencies": {
+    "@xi-era/acp-sdk": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.7.4",
+    "tsup": "^8.3.0"
+  },
+  "scripts": {
+    "build": "tsup"
+  }
+}