@nextclaw/nextclaw-narp-runtime-codex-sdk 0.1.1

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/codex-narp.controller.d.ts

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

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

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+import { CodexNarpRuntimeFactory, CodexNarpRuntimeWrapper } from "./services/codex-narp-runtime-wrapper.service.js";
+export { type CodexNarpRuntimeFactory, CodexNarpRuntimeWrapper };

package/dist/index.js

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

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

@@ -0,0 +1,19 @@
+import { NarpStdioRuntimeWrapperContext } from "@nextclaw/nextclaw-narp-stdio-runtime-wrapper";
+import { CodexSdkNcpAgentRuntimeConfig } from "@nextclaw/nextclaw-ncp-runtime-codex-sdk";
+import { CodexOpenAiResponsesBridgeConfig, CodexOpenAiResponsesBridgeResult } from "@nextclaw/nextclaw-ncp-runtime-plugin-codex-sdk";
+import { NcpAgentRuntime } from "@nextclaw/ncp";
+
+//#region src/services/codex-narp-runtime-wrapper.service.d.ts
+type CodexNarpRuntimeFactory = (config: CodexSdkNcpAgentRuntimeConfig) => NcpAgentRuntime;
+type CodexResponsesBridgeFactory = (config: CodexOpenAiResponsesBridgeConfig) => Promise<CodexOpenAiResponsesBridgeResult>;
+declare class CodexNarpRuntimeWrapper {
+  private readonly createRuntime;
+  private readonly ensureResponsesBridge;
+  constructor(createRuntime?: CodexNarpRuntimeFactory, ensureResponsesBridge?: CodexResponsesBridgeFactory);
+  start: () => void;
+  createCodexRuntime: (context: NarpStdioRuntimeWrapperContext) => NcpAgentRuntime;
+  buildRuntimeConfig: (context: NarpStdioRuntimeWrapperContext) => Promise<CodexSdkNcpAgentRuntimeConfig>;
+  private resolveRuntimeConfig;
+}
+//#endregion
+export { CodexNarpRuntimeFactory, CodexNarpRuntimeWrapper };

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

@@ -0,0 +1,168 @@
+import { NarpStdioRuntimeWrapper } from "@nextclaw/nextclaw-narp-stdio-runtime-wrapper";
+import { CodexSdkNcpAgentRuntime } from "@nextclaw/nextclaw-ncp-runtime-codex-sdk";
+import { buildCodexBridgeModelProviderId, ensureCodexOpenAiResponsesBridge } from "@nextclaw/nextclaw-ncp-runtime-plugin-codex-sdk";
+//#region src/services/codex-narp-runtime-wrapper.service.ts
+const NARP_API_MODE_HEADER = "x-nextclaw-narp-api-mode";
+var DeferredCodexNarpRuntime = class {
+	runtimePromise = null;
+	constructor(createRuntime) {
+		this.createRuntime = createRuntime;
+	}
+	run = async function* (input, options) {
+		if (!this.runtimePromise) this.runtimePromise = this.createRuntime();
+		yield* (await this.runtimePromise).run(input, options);
+	};
+};
+var CodexNarpRuntimeWrapper = class {
+	constructor(createRuntime = (config) => new CodexSdkNcpAgentRuntime(config), ensureResponsesBridge = ensureCodexOpenAiResponsesBridge) {
+		this.createRuntime = createRuntime;
+		this.ensureResponsesBridge = ensureResponsesBridge;
+	}
+	start = () => {
+		new NarpStdioRuntimeWrapper({
+			agentName: "NextClaw Codex NARP",
+			createRuntime: (context) => this.createCodexRuntime(context)
+		}).start();
+	};
+	createCodexRuntime = (context) => {
+		return new DeferredCodexNarpRuntime(async () => this.createRuntime(await this.buildRuntimeConfig(context)));
+	};
+	buildRuntimeConfig = (context) => {
+		const { cwd, modelId, promptMeta, sessionId } = context;
+		const providerRoute = promptMeta.providerRoute;
+		const sessionMetadata = promptMeta.sessionMetadata ?? {};
+		const providerLocalModel = stripProviderPrefix(readString(providerRoute?.model)) ?? stripProviderPrefix(readString(modelId)) ?? readString(process.env.NEXTCLAW_MODEL);
+		const upstreamApiBase = readString(providerRoute?.apiBase) ?? readString(process.env.NEXTCLAW_API_BASE);
+		const externalModelProvider = resolveExternalModelProvider({
+			apiBase: upstreamApiBase,
+			modelId
+		});
+		return this.resolveRuntimeConfig({
+			apiKey: readString(providerRoute?.apiKey) ?? readString(process.env.NEXTCLAW_API_KEY) ?? "",
+			cwd,
+			externalModelProvider,
+			providerLocalModel,
+			sessionId,
+			sessionMetadata,
+			threadModel: readString(modelId) ?? composeModelRoute({
+				modelProvider: externalModelProvider,
+				providerLocalModel
+			}) ?? providerLocalModel,
+			upstreamApiBase,
+			upstreamExtraHeaders: providerRoute?.headers
+		});
+	};
+	resolveRuntimeConfig = async (params) => {
+		const { apiKey, cwd, externalModelProvider, providerLocalModel, sessionId, sessionMetadata, threadModel: requestedThreadModel, upstreamApiBase, upstreamExtraHeaders } = params;
+		const bridgeModelProvider = upstreamApiBase && shouldUseResponsesBridge({
+			apiBase: upstreamApiBase,
+			headers: upstreamExtraHeaders
+		}) ? buildCodexBridgeModelProviderId(externalModelProvider ?? "chat") : void 0;
+		const apiBase = (bridgeModelProvider ? await this.ensureResponsesBridge({
+			upstreamApiBase: upstreamApiBase ?? "",
+			upstreamApiKey: apiKey,
+			upstreamExtraHeaders: stripInternalRouteHeaders(upstreamExtraHeaders),
+			defaultModel: providerLocalModel,
+			upstreamReasoningSplit: isMiniMaxApiBase(upstreamApiBase ?? ""),
+			modelPrefixes: [externalModelProvider ?? "", bridgeModelProvider]
+		}) : null)?.baseUrl ?? upstreamApiBase;
+		const modelProvider = bridgeModelProvider ?? externalModelProvider;
+		const codexPathOverride = readString(process.env.NEXTCLAW_CODEX_PATH) ?? readString(process.env.CODEX_PATH);
+		const modelReasoningEffort = readReasoningEffort(sessionMetadata.preferred_thinking) ?? readReasoningEffort(sessionMetadata.thinking);
+		const threadModel = bridgeModelProvider ? composeModelRoute({
+			modelProvider: bridgeModelProvider,
+			providerLocalModel
+		}) : requestedThreadModel;
+		return {
+			sessionId,
+			apiKey,
+			apiBase,
+			model: providerLocalModel,
+			threadId: readString(sessionMetadata.codex_thread_id) ?? null,
+			...codexPathOverride ? { codexPathOverride } : {},
+			sessionMetadata,
+			cliConfig: buildCodexCliConfig({
+				apiBase,
+				modelProvider
+			}),
+			threadOptions: {
+				...threadModel ? { model: threadModel } : {},
+				workingDirectory: cwd ?? process.cwd(),
+				skipGitRepoCheck: true,
+				...modelReasoningEffort ? { modelReasoningEffort } : {}
+			}
+		};
+	};
+};
+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 readReasoningEffort(value) {
+	if (typeof value !== "string") return;
+	const normalized = value.trim().toLowerCase();
+	if (normalized === "minimal" || normalized === "low" || normalized === "medium" || normalized === "high" || normalized === "xhigh") return normalized;
+}
+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 composeModelRoute(params) {
+	const { modelProvider, providerLocalModel } = params;
+	if (!modelProvider || !providerLocalModel) return;
+	return `${modelProvider}/${providerLocalModel}`;
+}
+function buildCodexCliConfig(params) {
+	const { apiBase, modelProvider } = params;
+	if (!modelProvider) return;
+	const config = {
+		model_provider: modelProvider,
+		preferred_auth_method: "apikey"
+	};
+	if (apiBase) config.model_providers = { [modelProvider]: {
+		name: modelProvider,
+		base_url: apiBase,
+		wire_api: "responses",
+		requires_openai_auth: true
+	} };
+	return config;
+}
+function readApiMode(headers) {
+	for (const [key, value] of Object.entries(headers ?? {})) if (key.toLowerCase() === NARP_API_MODE_HEADER) return readString(value)?.toLowerCase();
+}
+function shouldUseResponsesBridge(params) {
+	if (readApiMode(params.headers) === "chat_completions") return true;
+	return Boolean(params.apiBase && isMiniMaxApiBase(params.apiBase));
+}
+function stripInternalRouteHeaders(headers) {
+	const out = {};
+	for (const [key, value] of Object.entries(headers ?? {})) {
+		if (key.toLowerCase() === NARP_API_MODE_HEADER) continue;
+		out[key] = value;
+	}
+	return Object.keys(out).length > 0 ? out : void 0;
+}
+function resolveExternalModelProvider(params) {
+	return readModelProvider(params.modelId) ?? (params.apiBase && isMiniMaxApiBase(params.apiBase) ? "minimax" : void 0);
+}
+function isMiniMaxApiBase(apiBase) {
+	try {
+		const host = new URL(apiBase).hostname.toLowerCase();
+		return host === "api.minimaxi.com" || host.endsWith(".minimaxi.com");
+	} catch {
+		return apiBase.toLowerCase().includes("api.minimaxi.com");
+	}
+}
+//#endregion
+export { CodexNarpRuntimeWrapper };

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@nextclaw/nextclaw-narp-runtime-codex-sdk",
+  "version": "0.1.1",
+  "private": false,
+  "description": "NARP stdio launcher for the NextClaw Codex SDK runtime.",
+  "type": "module",
+  "bin": {
+    "nextclaw-codex-narp": "dist/controllers/codex-narp.controller.js"
+  },
+  "exports": {
+    ".": {
+      "development": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@nextclaw/nextclaw-ncp-runtime-plugin-codex-sdk": "0.1.58",
+    "@nextclaw/ncp": "0.5.7",
+    "@nextclaw/nextclaw-narp-stdio-runtime-wrapper": "0.1.1",
+    "@nextclaw/nextclaw-ncp-runtime-codex-sdk": "0.1.24"
+  },
+  "devDependencies": {
+    "@types/node": "^20.17.6",
+    "typescript": "^5.6.3",
+    "vitest": "^4.1.2"
+  },
+  "scripts": {
+    "build": "tsdown src/index.ts src/controllers/codex-narp.controller.ts --dts --clean --target es2022 --no-fixedExtension --unbundle",
+    "lint": "eslint .",
+    "tsc": "tsc -p tsconfig.json",
+    "test": "vitest run"
+  }
+}