@nextclaw/nextclaw-narp-runtime-opencode 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 NextClaw contributors
+
+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/controllers/opencode-narp.controller.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/controllers/opencode-narp.controller.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+import { OpencodeNarpRuntimeWrapper } from "../services/opencode-narp-runtime-wrapper.service.js";
+//#region src/controllers/opencode-narp.controller.ts
+new OpencodeNarpRuntimeWrapper().start();
+//#endregion
+export {};
+
+//# sourceMappingURL=opencode-narp.controller.js.map

package/dist/controllers/opencode-narp.controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode-narp.controller.js","names":[],"sources":["../../src/controllers/opencode-narp.controller.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport { OpencodeNarpRuntimeWrapper } from \"@opencode-narp/services/opencode-narp-runtime-wrapper.service.js\";\n\nnew OpencodeNarpRuntimeWrapper().start();\n"],"mappings":";;;AAIA,IAAI,4BAA4B,CAAC,OAAO"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+import { OpencodeNarpRuntimeFactory, OpencodeNarpRuntimeWrapper } from "./services/opencode-narp-runtime-wrapper.service.js";
+export { type OpencodeNarpRuntimeFactory, OpencodeNarpRuntimeWrapper };

package/dist/index.js

@@ -0,0 +1,2 @@
+import { OpencodeNarpRuntimeWrapper } from "./services/opencode-narp-runtime-wrapper.service.js";
+export { OpencodeNarpRuntimeWrapper };

package/dist/services/opencode-acp-runtime.service.js

@@ -0,0 +1,31 @@
+import { StdioRuntimeNcpAgentRuntime } from "@nextclaw/nextclaw-ncp-runtime-stdio-client";
+//#region src/services/opencode-acp-runtime.service.ts
+var OpencodeAcpRuntime = class {
+	runtime;
+	constructor(config) {
+		this.config = config;
+		this.runtime = new StdioRuntimeNcpAgentRuntime({
+			wireDialect: "acp",
+			processScope: "per-session",
+			command: config.command,
+			args: config.args,
+			cwd: config.cwd,
+			env: config.env,
+			startupTimeoutMs: config.startupTimeoutMs,
+			probeTimeoutMs: config.startupTimeoutMs,
+			requestTimeoutMs: config.requestTimeoutMs,
+			sessionId: config.sessionId,
+			resolveProviderRoute: () => this.config.providerRoute
+		});
+	}
+	run = async function* (input, options) {
+		yield* this.runtime.run(input, options);
+	};
+	dispose = async () => {
+		await this.runtime.dispose();
+	};
+};
+//#endregion
+export { OpencodeAcpRuntime };
+
+//# sourceMappingURL=opencode-acp-runtime.service.js.map

package/dist/services/opencode-acp-runtime.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode-acp-runtime.service.js","names":[],"sources":["../../src/services/opencode-acp-runtime.service.ts"],"sourcesContent":["import type {\n  NcpAgentRunInput,\n  NcpAgentRunOptions,\n  NcpAgentRuntime,\n  NcpEndpointEvent,\n} from \"@nextclaw/ncp\";\nimport { StdioRuntimeNcpAgentRuntime } from \"@nextclaw/nextclaw-ncp-runtime-stdio-client\";\nimport type { OpencodeAcpRuntimeConfig } from \"@opencode-narp/types/opencode-narp-runtime.types.js\";\n\nexport class OpencodeAcpRuntime implements NcpAgentRuntime {\n  private readonly runtime: StdioRuntimeNcpAgentRuntime;\n\n  constructor(private readonly config: OpencodeAcpRuntimeConfig) {\n    this.runtime = new StdioRuntimeNcpAgentRuntime({\n      wireDialect: \"acp\",\n      processScope: \"per-session\",\n      command: config.command,\n      args: config.args,\n      cwd: config.cwd,\n      env: config.env,\n      startupTimeoutMs: config.startupTimeoutMs,\n      probeTimeoutMs: config.startupTimeoutMs,\n      requestTimeoutMs: config.requestTimeoutMs,\n      sessionId: config.sessionId,\n      resolveProviderRoute: () => this.config.providerRoute,\n    });\n  }\n\n  run = async function* (\n    this: OpencodeAcpRuntime,\n    input: NcpAgentRunInput,\n    options?: NcpAgentRunOptions,\n  ): AsyncGenerator<NcpEndpointEvent> {\n    yield* this.runtime.run(input, options);\n  };\n\n  dispose = async (): Promise<void> => {\n    await this.runtime.dispose();\n  };\n}\n"],"mappings":";;AASA,IAAa,qBAAb,MAA2D;CACzD;CAEA,YAAY,QAAmD;AAAlC,OAAA,SAAA;AAC3B,OAAK,UAAU,IAAI,4BAA4B;GAC7C,aAAa;GACb,cAAc;GACd,SAAS,OAAO;GAChB,MAAM,OAAO;GACb,KAAK,OAAO;GACZ,KAAK,OAAO;GACZ,kBAAkB,OAAO;GACzB,gBAAgB,OAAO;GACvB,kBAAkB,OAAO;GACzB,WAAW,OAAO;GAClB,4BAA4B,KAAK,OAAO;GACzC,CAAC;;CAGJ,MAAM,iBAEJ,OACA,SACkC;AAClC,SAAO,KAAK,QAAQ,IAAI,OAAO,QAAQ;;CAGzC,UAAU,YAA2B;AACnC,QAAM,KAAK,QAAQ,SAAS"}

package/dist/services/opencode-narp-runtime-wrapper.service.d.ts

@@ -0,0 +1,19 @@
+import { OpencodeAcpRuntimeConfig } from "../types/opencode-narp-runtime.types.js";
+import { NarpStdioRuntimeWrapperContext } from "@nextclaw/nextclaw-narp-stdio-runtime-wrapper";
+import { NcpAgentRuntime } from "@nextclaw/ncp";
+
+//#region src/services/opencode-narp-runtime-wrapper.service.d.ts
+type OpencodeNarpRuntimeFactory = (config: OpencodeAcpRuntimeConfig) => NcpAgentRuntime;
+type OpencodeRuntimeConfigResolver = {
+  resolve: (context: NarpStdioRuntimeWrapperContext) => Promise<OpencodeAcpRuntimeConfig>;
+};
+declare class OpencodeNarpRuntimeWrapper {
+  private readonly configService;
+  private readonly createRuntime;
+  constructor(configService?: OpencodeRuntimeConfigResolver, createRuntime?: OpencodeNarpRuntimeFactory);
+  start: () => void;
+  createOpencodeRuntime: (context: NarpStdioRuntimeWrapperContext) => Promise<NcpAgentRuntime>;
+}
+//#endregion
+export { OpencodeNarpRuntimeFactory, OpencodeNarpRuntimeWrapper };
+//# sourceMappingURL=opencode-narp-runtime-wrapper.service.d.ts.map

package/dist/services/opencode-narp-runtime-wrapper.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode-narp-runtime-wrapper.service.d.ts","names":[],"sources":["../../src/services/opencode-narp-runtime-wrapper.service.ts"],"mappings":";;;;;KASY,0BAAA,IACV,MAAA,EAAQ,wBAAA,KACL,eAAA;AAAA,KAEO,6BAAA;EACV,OAAA,GACE,OAAA,EAAS,8BAAA,KACN,OAAA,CAAQ,wBAAA;AAAA;AAAA,cAGF,0BAAA;EAAA,iBAEQ,aAAA;EAAA,iBACA,aAAA;cADA,aAAA,GAAe,6BAAA,EACf,aAAA,GAAe,0BAAA;EAKlC,KAAA;EAOA,qBAAA,GACE,OAAA,EAAS,8BAAA,KACR,OAAA,CAAQ,eAAA;AAAA"}

package/dist/services/opencode-narp-runtime-wrapper.service.js

@@ -0,0 +1,21 @@
+import { OpencodeAcpRuntime } from "./opencode-acp-runtime.service.js";
+import { OpencodeRuntimeConfigService } from "./opencode-runtime-config.service.js";
+import { NarpStdioRuntimeWrapper } from "@nextclaw/nextclaw-narp-stdio-runtime-wrapper";
+//#region src/services/opencode-narp-runtime-wrapper.service.ts
+var OpencodeNarpRuntimeWrapper = class {
+	constructor(configService = new OpencodeRuntimeConfigService(), createRuntime = (config) => new OpencodeAcpRuntime(config)) {
+		this.configService = configService;
+		this.createRuntime = createRuntime;
+	}
+	start = () => {
+		new NarpStdioRuntimeWrapper({
+			agentName: "NextClaw OpenCode NARP",
+			createRuntime: (context) => this.createOpencodeRuntime(context)
+		}).start();
+	};
+	createOpencodeRuntime = async (context) => this.createRuntime(await this.configService.resolve(context));
+};
+//#endregion
+export { OpencodeNarpRuntimeWrapper };
+
+//# sourceMappingURL=opencode-narp-runtime-wrapper.service.js.map

package/dist/services/opencode-narp-runtime-wrapper.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode-narp-runtime-wrapper.service.js","names":[],"sources":["../../src/services/opencode-narp-runtime-wrapper.service.ts"],"sourcesContent":["import type { NcpAgentRuntime } from \"@nextclaw/ncp\";\nimport {\n  NarpStdioRuntimeWrapper,\n  type NarpStdioRuntimeWrapperContext,\n} from \"@nextclaw/nextclaw-narp-stdio-runtime-wrapper\";\nimport { OpencodeAcpRuntime } from \"./opencode-acp-runtime.service.js\";\nimport { OpencodeRuntimeConfigService } from \"./opencode-runtime-config.service.js\";\nimport type { OpencodeAcpRuntimeConfig } from \"@opencode-narp/types/opencode-narp-runtime.types.js\";\n\nexport type OpencodeNarpRuntimeFactory = (\n  config: OpencodeAcpRuntimeConfig,\n) => NcpAgentRuntime;\n\nexport type OpencodeRuntimeConfigResolver = {\n  resolve: (\n    context: NarpStdioRuntimeWrapperContext,\n  ) => Promise<OpencodeAcpRuntimeConfig>;\n};\n\nexport class OpencodeNarpRuntimeWrapper {\n  constructor(\n    private readonly configService: OpencodeRuntimeConfigResolver = new OpencodeRuntimeConfigService(),\n    private readonly createRuntime: OpencodeNarpRuntimeFactory = (\n      config,\n    ) => new OpencodeAcpRuntime(config),\n  ) {}\n\n  start = (): void => {\n    new NarpStdioRuntimeWrapper({\n      agentName: \"NextClaw OpenCode NARP\",\n      createRuntime: (context) => this.createOpencodeRuntime(context),\n    }).start();\n  };\n\n  createOpencodeRuntime = async (\n    context: NarpStdioRuntimeWrapperContext,\n  ): Promise<NcpAgentRuntime> => this.createRuntime(await this.configService.resolve(context));\n}\n"],"mappings":";;;;AAmBA,IAAa,6BAAb,MAAwC;CACtC,YACE,gBAAgE,IAAI,8BAA8B,EAClG,iBACE,WACG,IAAI,mBAAmB,OAAO,EACnC;AAJiB,OAAA,gBAAA;AACA,OAAA,gBAAA;;CAKnB,cAAoB;AAClB,MAAI,wBAAwB;GAC1B,WAAW;GACX,gBAAgB,YAAY,KAAK,sBAAsB,QAAQ;GAChE,CAAC,CAAC,OAAO;;CAGZ,wBAAwB,OACtB,YAC6B,KAAK,cAAc,MAAM,KAAK,cAAc,QAAQ,QAAQ,CAAC"}

package/dist/services/opencode-runtime-config.service.js

@@ -0,0 +1,91 @@
+import { readString, resolveOpencodeProviderNpm, resolveOpencodeRoute } from "../utils/opencode-provider-route.utils.js";
+import { mkdir, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+//#region src/services/opencode-runtime-config.service.ts
+const DEFAULT_OPENCODE_COMMAND = "opencode";
+const DEFAULT_REQUEST_TIMEOUT_MS = 24e4;
+const DEFAULT_STARTUP_TIMEOUT_MS = 15e3;
+const OPENCODE_CONFIG_SCHEMA = "https://opencode.ai/config.json";
+var OpencodeRuntimeConfigService = class {
+	resolve = async (context) => {
+		const { cwd, modelId, promptMeta, sessionId } = context;
+		const sessionMetadata = promptMeta.sessionMetadata ?? {};
+		const route = resolveOpencodeRoute({
+			modelId,
+			providerRoute: promptMeta.providerRoute,
+			sessionMetadata
+		});
+		const sessionRoot = join(this.resolveRuntimeRoot(), sanitizePathSegment(sessionId));
+		const homeDir = join(sessionRoot, "home");
+		const configPath = join(sessionRoot, "opencode.json");
+		const env = this.buildEnv({
+			apiKey: route.apiKey,
+			configPath,
+			headers: route.headers,
+			homeDir
+		});
+		await mkdir(sessionRoot, { recursive: true });
+		await mkdir(homeDir, { recursive: true });
+		await writeFile(configPath, `${JSON.stringify({
+			$schema: OPENCODE_CONFIG_SCHEMA,
+			autoupdate: false,
+			model: route.modelRoute,
+			small_model: route.modelRoute,
+			enabled_providers: [route.providerId],
+			provider: { [route.providerId]: {
+				npm: resolveOpencodeProviderNpm(route.apiMode),
+				...this.resolveOpencodeApi(route.apiMode) ? { api: this.resolveOpencodeApi(route.apiMode) } : {},
+				name: `NextClaw ${route.providerId}`,
+				options: {
+					...route.apiBase ? { baseURL: route.apiBase } : {},
+					apiKey: "{env:NEXTCLAW_OPENCODE_API_KEY}",
+					...route.apiMode === "chat_completions" ? { disableMaxOutputTokens: true } : {},
+					...route.headers ? { headers: this.buildHeaderConfig(route.headers) } : {}
+				},
+				models: { [route.modelId]: { name: route.modelId } }
+			} }
+		}, null, 2)}\n`, "utf8");
+		return {
+			args: [
+				"acp",
+				"--pure",
+				"--cwd",
+				cwd ?? process.cwd()
+			],
+			command: readString(sessionMetadata.opencode_command) ?? readString(process.env.NEXTCLAW_OPENCODE_COMMAND) ?? DEFAULT_OPENCODE_COMMAND,
+			cwd: cwd ?? process.cwd(),
+			env,
+			providerRoute: route.providerRoute,
+			requestTimeoutMs: DEFAULT_REQUEST_TIMEOUT_MS,
+			sessionId,
+			startupTimeoutMs: DEFAULT_STARTUP_TIMEOUT_MS
+		};
+	};
+	resolveRuntimeRoot = () => readString(process.env.NEXTCLAW_OPENCODE_NARP_HOME) ?? join(tmpdir(), "nextclaw-opencode-narp");
+	buildEnv = (params) => {
+		const { apiKey, configPath, headers, homeDir } = params;
+		const env = {
+			HOME: homeDir,
+			NEXTCLAW_OPENCODE_API_KEY: apiKey,
+			OPENCODE_CONFIG: configPath
+		};
+		for (const [index, value] of Object.values(headers ?? {}).entries()) env[`NEXTCLAW_OPENCODE_HEADER_${index}`] = value;
+		return env;
+	};
+	buildHeaderConfig = (headers) => {
+		const entries = Object.keys(headers).map((key, index) => [key, `{env:NEXTCLAW_OPENCODE_HEADER_${index}}`]);
+		return Object.fromEntries(entries);
+	};
+	resolveOpencodeApi = (apiMode) => {
+		if (apiMode === "codex_responses") return "responses";
+		if (apiMode === "chat_completions") return "chat";
+	};
+};
+function sanitizePathSegment(value) {
+	return value.replace(/[^a-zA-Z0-9._-]+/g, "-").replace(/^-+|-+$/g, "") || "session";
+}
+//#endregion
+export { OpencodeRuntimeConfigService };
+
+//# sourceMappingURL=opencode-runtime-config.service.js.map

package/dist/services/opencode-runtime-config.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode-runtime-config.service.js","names":[],"sources":["../../src/services/opencode-runtime-config.service.ts"],"sourcesContent":["import { mkdir, writeFile } from \"node:fs/promises\";\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\nimport type { NarpStdioRuntimeWrapperContext } from \"@nextclaw/nextclaw-narp-stdio-runtime-wrapper\";\nimport type { OpencodeAcpRuntimeConfig } from \"@opencode-narp/types/opencode-narp-runtime.types.js\";\nimport {\n  readString,\n  resolveOpencodeProviderNpm,\n  resolveOpencodeRoute,\n} from \"@opencode-narp/utils/opencode-provider-route.utils.js\";\n\nconst DEFAULT_OPENCODE_COMMAND = \"opencode\";\nconst DEFAULT_REQUEST_TIMEOUT_MS = 240_000;\nconst DEFAULT_STARTUP_TIMEOUT_MS = 15_000;\nconst OPENCODE_CONFIG_SCHEMA = \"https://opencode.ai/config.json\";\n\nexport class OpencodeRuntimeConfigService {\n  resolve = async (\n    context: NarpStdioRuntimeWrapperContext,\n  ): Promise<OpencodeAcpRuntimeConfig> => {\n    const { cwd, modelId, promptMeta, sessionId } = context;\n    const sessionMetadata = promptMeta.sessionMetadata ?? {};\n    const route = resolveOpencodeRoute({\n      modelId,\n      providerRoute: promptMeta.providerRoute,\n      sessionMetadata,\n    });\n    const sessionRoot = join(this.resolveRuntimeRoot(), sanitizePathSegment(sessionId));\n    const homeDir = join(sessionRoot, \"home\");\n    const configPath = join(sessionRoot, \"opencode.json\");\n    const env = this.buildEnv({\n      apiKey: route.apiKey,\n      configPath,\n      headers: route.headers,\n      homeDir,\n    });\n\n    await mkdir(sessionRoot, { recursive: true });\n    await mkdir(homeDir, { recursive: true });\n    await writeFile(\n      configPath,\n      `${JSON.stringify({\n        $schema: OPENCODE_CONFIG_SCHEMA,\n        autoupdate: false,\n        model: route.modelRoute,\n        small_model: route.modelRoute,\n        enabled_providers: [route.providerId],\n        provider: {\n          [route.providerId]: {\n            npm: resolveOpencodeProviderNpm(route.apiMode),\n            ...(this.resolveOpencodeApi(route.apiMode) ? { api: this.resolveOpencodeApi(route.apiMode) } : {}),\n            name: `NextClaw ${route.providerId}`,\n            options: {\n              ...(route.apiBase ? { baseURL: route.apiBase } : {}),\n              apiKey: \"{env:NEXTCLAW_OPENCODE_API_KEY}\",\n              ...(route.apiMode === \"chat_completions\" ? { disableMaxOutputTokens: true } : {}),\n              ...(route.headers ? { headers: this.buildHeaderConfig(route.headers) } : {}),\n            },\n            models: {\n              [route.modelId]: {\n                name: route.modelId,\n              },\n            },\n          },\n        },\n      }, null, 2)}\\n`,\n      \"utf8\",\n    );\n\n    return {\n      args: [\"acp\", \"--pure\", \"--cwd\", cwd ?? process.cwd()],\n      command:\n        readString(sessionMetadata.opencode_command) ??\n        readString(process.env.NEXTCLAW_OPENCODE_COMMAND) ??\n        DEFAULT_OPENCODE_COMMAND,\n      cwd: cwd ?? process.cwd(),\n      env,\n      providerRoute: route.providerRoute,\n      requestTimeoutMs: DEFAULT_REQUEST_TIMEOUT_MS,\n      sessionId,\n      startupTimeoutMs: DEFAULT_STARTUP_TIMEOUT_MS,\n    };\n  };\n\n  private resolveRuntimeRoot = (): string =>\n    readString(process.env.NEXTCLAW_OPENCODE_NARP_HOME) ??\n    join(tmpdir(), \"nextclaw-opencode-narp\");\n\n  private buildEnv = (params: {\n    apiKey: string;\n    configPath: string;\n    headers?: Record<string, string>;\n    homeDir: string;\n  }): Record<string, string> => {\n    const { apiKey, configPath, headers, homeDir } = params;\n    const env: Record<string, string> = {\n      HOME: homeDir,\n      NEXTCLAW_OPENCODE_API_KEY: apiKey,\n      OPENCODE_CONFIG: configPath,\n    };\n    for (const [index, value] of Object.values(headers ?? {}).entries()) {\n      env[`NEXTCLAW_OPENCODE_HEADER_${index}`] = value;\n    }\n    return env;\n  };\n\n  private buildHeaderConfig = (\n    headers: Record<string, string>,\n  ): Record<string, string> => {\n    const entries = Object.keys(headers).map((key, index) => [\n      key,\n      `{env:NEXTCLAW_OPENCODE_HEADER_${index}}`,\n    ]);\n    return Object.fromEntries(entries);\n  };\n\n  private resolveOpencodeApi = (apiMode: string): string | undefined => {\n    if (apiMode === \"codex_responses\") {\n      return \"responses\";\n    }\n    if (apiMode === \"chat_completions\") {\n      return \"chat\";\n    }\n    return undefined;\n  };\n}\n\nfunction sanitizePathSegment(value: string): string {\n  return value.replace(/[^a-zA-Z0-9._-]+/g, \"-\").replace(/^-+|-+$/g, \"\") || \"session\";\n}\n"],"mappings":";;;;;AAWA,MAAM,2BAA2B;AACjC,MAAM,6BAA6B;AACnC,MAAM,6BAA6B;AACnC,MAAM,yBAAyB;AAE/B,IAAa,+BAAb,MAA0C;CACxC,UAAU,OACR,YACsC;EACtC,MAAM,EAAE,KAAK,SAAS,YAAY,cAAc;EAChD,MAAM,kBAAkB,WAAW,mBAAmB,EAAE;EACxD,MAAM,QAAQ,qBAAqB;GACjC;GACA,eAAe,WAAW;GAC1B;GACD,CAAC;EACF,MAAM,cAAc,KAAK,KAAK,oBAAoB,EAAE,oBAAoB,UAAU,CAAC;EACnF,MAAM,UAAU,KAAK,aAAa,OAAO;EACzC,MAAM,aAAa,KAAK,aAAa,gBAAgB;EACrD,MAAM,MAAM,KAAK,SAAS;GACxB,QAAQ,MAAM;GACd;GACA,SAAS,MAAM;GACf;GACD,CAAC;AAEF,QAAM,MAAM,aAAa,EAAE,WAAW,MAAM,CAAC;AAC7C,QAAM,MAAM,SAAS,EAAE,WAAW,MAAM,CAAC;AACzC,QAAM,UACJ,YACA,GAAG,KAAK,UAAU;GAChB,SAAS;GACT,YAAY;GACZ,OAAO,MAAM;GACb,aAAa,MAAM;GACnB,mBAAmB,CAAC,MAAM,WAAW;GACrC,UAAU,GACP,MAAM,aAAa;IAClB,KAAK,2BAA2B,MAAM,QAAQ;IAC9C,GAAI,KAAK,mBAAmB,MAAM,QAAQ,GAAG,EAAE,KAAK,KAAK,mBAAmB,MAAM,QAAQ,EAAE,GAAG,EAAE;IACjG,MAAM,YAAY,MAAM;IACxB,SAAS;KACP,GAAI,MAAM,UAAU,EAAE,SAAS,MAAM,SAAS,GAAG,EAAE;KACnD,QAAQ;KACR,GAAI,MAAM,YAAY,qBAAqB,EAAE,wBAAwB,MAAM,GAAG,EAAE;KAChF,GAAI,MAAM,UAAU,EAAE,SAAS,KAAK,kBAAkB,MAAM,QAAQ,EAAE,GAAG,EAAE;KAC5E;IACD,QAAQ,GACL,MAAM,UAAU,EACf,MAAM,MAAM,SACb,EACF;IACF,EACF;GACF,EAAE,MAAM,EAAE,CAAC,KACZ,OACD;AAED,SAAO;GACL,MAAM;IAAC;IAAO;IAAU;IAAS,OAAO,QAAQ,KAAK;IAAC;GACtD,SACE,WAAW,gBAAgB,iBAAiB,IAC5C,WAAW,QAAQ,IAAI,0BAA0B,IACjD;GACF,KAAK,OAAO,QAAQ,KAAK;GACzB;GACA,eAAe,MAAM;GACrB,kBAAkB;GAClB;GACA,kBAAkB;GACnB;;CAGH,2BACE,WAAW,QAAQ,IAAI,4BAA4B,IACnD,KAAK,QAAQ,EAAE,yBAAyB;CAE1C,YAAoB,WAKU;EAC5B,MAAM,EAAE,QAAQ,YAAY,SAAS,YAAY;EACjD,MAAM,MAA8B;GAClC,MAAM;GACN,2BAA2B;GAC3B,iBAAiB;GAClB;AACD,OAAK,MAAM,CAAC,OAAO,UAAU,OAAO,OAAO,WAAW,EAAE,CAAC,CAAC,SAAS,CACjE,KAAI,4BAA4B,WAAW;AAE7C,SAAO;;CAGT,qBACE,YAC2B;EAC3B,MAAM,UAAU,OAAO,KAAK,QAAQ,CAAC,KAAK,KAAK,UAAU,CACvD,KACA,iCAAiC,MAAM,GACxC,CAAC;AACF,SAAO,OAAO,YAAY,QAAQ;;CAGpC,sBAA8B,YAAwC;AACpE,MAAI,YAAY,kBACd,QAAO;AAET,MAAI,YAAY,mBACd,QAAO;;;AAMb,SAAS,oBAAoB,OAAuB;AAClD,QAAO,MAAM,QAAQ,qBAAqB,IAAI,CAAC,QAAQ,YAAY,GAAG,IAAI"}

package/dist/types/opencode-narp-runtime.types.d.ts

@@ -0,0 +1,16 @@
+import { NcpProviderRuntimeRoute } from "@nextclaw/ncp";
+
+//#region src/types/opencode-narp-runtime.types.d.ts
+type OpencodeAcpRuntimeConfig = {
+  args: string[];
+  command: string;
+  cwd: string;
+  env: Record<string, string>;
+  providerRoute: NcpProviderRuntimeRoute;
+  requestTimeoutMs: number;
+  sessionId: string;
+  startupTimeoutMs: number;
+};
+//#endregion
+export { OpencodeAcpRuntimeConfig };
+//# sourceMappingURL=opencode-narp-runtime.types.d.ts.map

package/dist/types/opencode-narp-runtime.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode-narp-runtime.types.d.ts","names":[],"sources":["../../src/types/opencode-narp-runtime.types.ts"],"mappings":";;;KAkBY,wBAAA;EACV,IAAA;EACA,OAAA;EACA,GAAA;EACA,GAAA,EAAK,MAAA;EACL,aAAA,EAAe,uBAAA;EACf,gBAAA;EACA,SAAA;EACA,gBAAA;AAAA"}

package/dist/utils/opencode-provider-route.utils.js

@@ -0,0 +1,90 @@
+//#region src/utils/opencode-provider-route.utils.ts
+const NARP_API_MODE_HEADER = "x-nextclaw-narp-api-mode";
+const DEFAULT_PROVIDER_ID = "nextclaw";
+function readString(value) {
+	if (typeof value !== "string") return;
+	const trimmed = value.trim();
+	return trimmed.length > 0 ? trimmed : void 0;
+}
+function stripProviderPrefix(value) {
+	const normalized = readString(value);
+	if (!normalized) return;
+	const slashIndex = normalized.indexOf("/");
+	if (slashIndex <= 0) return normalized;
+	return readString(normalized.slice(slashIndex + 1));
+}
+function readModelProvider(value) {
+	const normalized = readString(value);
+	if (!normalized) return;
+	const slashIndex = normalized.indexOf("/");
+	if (slashIndex <= 0) return;
+	return readString(normalized.slice(0, slashIndex));
+}
+function resolveOpencodeRoute(params) {
+	const { modelId, providerRoute, sessionMetadata } = params;
+	const selectedModel = readString(sessionMetadata?.preferred_model) ?? readString(sessionMetadata?.preferredModel) ?? readString(sessionMetadata?.model) ?? readString(modelId) ?? readString(providerRoute?.model);
+	const modelLocalId = stripProviderPrefix(readString(providerRoute?.model)) ?? stripProviderPrefix(selectedModel);
+	if (!modelLocalId) throw new Error("[opencode-narp] missing selected model for OpenCode runtime");
+	const providerId = normalizeProviderId(readModelProvider(selectedModel) ?? readModelProvider(modelId) ?? inferProviderId(providerRoute?.apiBase) ?? DEFAULT_PROVIDER_ID);
+	const apiMode = readApiMode(providerRoute?.headers);
+	const modelRoute = `${providerId}/${modelLocalId}`;
+	const apiKey = readString(providerRoute?.apiKey) ?? readString(process.env.NEXTCLAW_API_KEY) ?? "";
+	const apiBase = readString(providerRoute?.apiBase) ?? readString(process.env.NEXTCLAW_API_BASE);
+	const headers = stripInternalRouteHeaders(providerRoute?.headers);
+	return {
+		apiBase,
+		apiKey,
+		apiMode,
+		headers,
+		modelId: modelLocalId,
+		modelRoute,
+		providerId,
+		providerRoute: {
+			model: modelRoute,
+			apiKey,
+			apiBase,
+			headers: {
+				...headers ?? {},
+				[NARP_API_MODE_HEADER]: apiMode
+			}
+		}
+	};
+}
+function resolveOpencodeProviderNpm(apiMode) {
+	if (apiMode === "anthropic_messages") return "@ai-sdk/anthropic";
+	if (apiMode === "codex_responses") return "@ai-sdk/openai";
+	return "@ai-sdk/openai-compatible";
+}
+function readApiMode(headers) {
+	const raw = Object.entries(headers ?? {}).find(([key]) => key.toLowerCase() === NARP_API_MODE_HEADER)?.[1];
+	const normalized = readString(raw)?.toLowerCase();
+	if (normalized === "anthropic_messages" || normalized === "chat_completions" || normalized === "codex_responses") return normalized;
+	return "chat_completions";
+}
+function stripInternalRouteHeaders(headers) {
+	const output = {};
+	for (const [key, value] of Object.entries(headers ?? {})) {
+		if (key.toLowerCase() === NARP_API_MODE_HEADER) continue;
+		output[key] = value;
+	}
+	return Object.keys(output).length > 0 ? output : void 0;
+}
+function normalizeProviderId(value) {
+	return value.trim().toLowerCase().replace(/[^a-z0-9_-]+/g, "-").replace(/^-+|-+$/g, "") || DEFAULT_PROVIDER_ID;
+}
+function inferProviderId(apiBase) {
+	const normalized = readString(apiBase);
+	if (!normalized) return;
+	try {
+		const host = new URL(normalized).hostname.toLowerCase();
+		if (host.includes("deepseek")) return "deepseek";
+		if (host.includes("minimaxi")) return "minimax";
+		if (host.includes("openrouter")) return "openrouter";
+	} catch {
+		return;
+	}
+}
+//#endregion
+export { readString, resolveOpencodeProviderNpm, resolveOpencodeRoute };
+
+//# sourceMappingURL=opencode-provider-route.utils.js.map

package/dist/utils/opencode-provider-route.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode-provider-route.utils.js","names":[],"sources":["../../src/utils/opencode-provider-route.utils.ts"],"sourcesContent":["import type { NcpProviderRuntimeRoute } from \"@nextclaw/ncp\";\nimport type {\n  OpencodeProviderApiMode,\n  OpencodeResolvedRoute,\n} from \"@opencode-narp/types/opencode-narp-runtime.types.js\";\n\nconst NARP_API_MODE_HEADER = \"x-nextclaw-narp-api-mode\";\nconst DEFAULT_PROVIDER_ID = \"nextclaw\";\n\nexport function readString(value: unknown): string | undefined {\n  if (typeof value !== \"string\") {\n    return undefined;\n  }\n  const trimmed = value.trim();\n  return trimmed.length > 0 ? trimmed : undefined;\n}\n\nexport function readRecord(value: unknown): Record<string, unknown> | undefined {\n  if (!value || typeof value !== \"object\" || Array.isArray(value)) {\n    return undefined;\n  }\n  return value as Record<string, unknown>;\n}\n\nexport function stripProviderPrefix(value: string | undefined): string | undefined {\n  const normalized = readString(value);\n  if (!normalized) {\n    return undefined;\n  }\n  const slashIndex = normalized.indexOf(\"/\");\n  if (slashIndex <= 0) {\n    return normalized;\n  }\n  return readString(normalized.slice(slashIndex + 1));\n}\n\nexport function readModelProvider(value: string | undefined): string | undefined {\n  const normalized = readString(value);\n  if (!normalized) {\n    return undefined;\n  }\n  const slashIndex = normalized.indexOf(\"/\");\n  if (slashIndex <= 0) {\n    return undefined;\n  }\n  return readString(normalized.slice(0, slashIndex));\n}\n\nexport function resolveOpencodeRoute(params: {\n  modelId?: string;\n  providerRoute?: NcpProviderRuntimeRoute;\n  sessionMetadata?: Record<string, unknown>;\n}): OpencodeResolvedRoute {\n  const { modelId, providerRoute, sessionMetadata } = params;\n  const selectedModel =\n    readString(sessionMetadata?.preferred_model) ??\n    readString(sessionMetadata?.preferredModel) ??\n    readString(sessionMetadata?.model) ??\n    readString(modelId) ??\n    readString(providerRoute?.model);\n  const modelLocalId =\n    stripProviderPrefix(readString(providerRoute?.model)) ??\n    stripProviderPrefix(selectedModel);\n  if (!modelLocalId) {\n    throw new Error(\"[opencode-narp] missing selected model for OpenCode runtime\");\n  }\n\n  const providerId = normalizeProviderId(\n    readModelProvider(selectedModel) ??\n    readModelProvider(modelId) ??\n    inferProviderId(providerRoute?.apiBase) ??\n    DEFAULT_PROVIDER_ID,\n  );\n  const apiMode = readApiMode(providerRoute?.headers);\n  const modelRoute = `${providerId}/${modelLocalId}`;\n  const apiKey = readString(providerRoute?.apiKey) ?? readString(process.env.NEXTCLAW_API_KEY) ?? \"\";\n  const apiBase =\n    readString(providerRoute?.apiBase) ??\n    readString(process.env.NEXTCLAW_API_BASE);\n  const headers = stripInternalRouteHeaders(providerRoute?.headers);\n\n  return {\n    apiBase,\n    apiKey,\n    apiMode,\n    headers,\n    modelId: modelLocalId,\n    modelRoute,\n    providerId,\n    providerRoute: {\n      model: modelRoute,\n      apiKey,\n      apiBase,\n      headers: {\n        ...(headers ?? {}),\n        [NARP_API_MODE_HEADER]: apiMode,\n      },\n    },\n  };\n}\n\nexport function resolveOpencodeProviderNpm(apiMode: OpencodeProviderApiMode): string {\n  if (apiMode === \"anthropic_messages\") {\n    return \"@ai-sdk/anthropic\";\n  }\n  if (apiMode === \"codex_responses\") {\n    return \"@ai-sdk/openai\";\n  }\n  return \"@ai-sdk/openai-compatible\";\n}\n\nfunction readApiMode(headers: Record<string, string> | undefined): OpencodeProviderApiMode {\n  const raw = Object.entries(headers ?? {}).find(\n    ([key]) => key.toLowerCase() === NARP_API_MODE_HEADER,\n  )?.[1];\n  const normalized = readString(raw)?.toLowerCase();\n  if (\n    normalized === \"anthropic_messages\" ||\n    normalized === \"chat_completions\" ||\n    normalized === \"codex_responses\"\n  ) {\n    return normalized;\n  }\n  return \"chat_completions\";\n}\n\nfunction stripInternalRouteHeaders(\n  headers: Record<string, string> | undefined,\n): Record<string, string> | undefined {\n  const output: Record<string, string> = {};\n  for (const [key, value] of Object.entries(headers ?? {})) {\n    if (key.toLowerCase() === NARP_API_MODE_HEADER) {\n      continue;\n    }\n    output[key] = value;\n  }\n  return Object.keys(output).length > 0 ? output : undefined;\n}\n\nfunction normalizeProviderId(value: string): string {\n  const normalized = value\n    .trim()\n    .toLowerCase()\n    .replace(/[^a-z0-9_-]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\");\n  return normalized || DEFAULT_PROVIDER_ID;\n}\n\nfunction inferProviderId(apiBase: string | null | undefined): string | undefined {\n  const normalized = readString(apiBase);\n  if (!normalized) {\n    return undefined;\n  }\n  try {\n    const host = new URL(normalized).hostname.toLowerCase();\n    if (host.includes(\"deepseek\")) {\n      return \"deepseek\";\n    }\n    if (host.includes(\"minimaxi\")) {\n      return \"minimax\";\n    }\n    if (host.includes(\"openrouter\")) {\n      return \"openrouter\";\n    }\n  } catch {\n    return undefined;\n  }\n  return undefined;\n}\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@nextclaw/nextclaw-narp-runtime-opencode",
+  "version": "0.1.0",
+  "private": false,
+  "description": "NARP stdio launcher for the OpenCode runtime.",
+  "type": "module",
+  "bin": {
+    "nextclaw-opencode-narp": "dist/controllers/opencode-narp.controller.js"
+  },
+  "exports": {
+    ".": {
+      "development": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@nextclaw/ncp": "0.5.21",
+    "@nextclaw/nextclaw-narp-stdio-runtime-wrapper": "0.2.1",
+    "@nextclaw/nextclaw-ncp-runtime-stdio-client": "0.2.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.17.6",
+    "typescript": "^5.6.3",
+    "vitest": "^4.1.2"
+  },
+  "scripts": {
+    "build": "tsdown src/index.ts src/controllers/opencode-narp.controller.ts --dts.sourcemap --clean --target es2022 --no-fixedExtension --unbundle",
+    "lint": "eslint .",
+    "tsc": "tsc -p tsconfig.json",
+    "test": "vitest run"
+  }
+}