@nextclaw/nextclaw-ncp-runtime-plugin-codex-sdk 0.1.5 → 0.1.7

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+import { Config } from '@nextclaw/core';
+import { NcpAgentRuntime } from '@nextclaw/ncp';
+import { RuntimeFactoryParams } from '@nextclaw/ncp-toolkit';
+
+type PluginApi = {
+    config: Config;
+    pluginConfig?: Record<string, unknown>;
+    registerNcpAgentRuntime: (registration: {
+        kind: string;
+        label?: string;
+        createRuntime: (params: RuntimeFactoryParams) => NcpAgentRuntime;
+    }) => void;
+};
+type PluginDefinition = {
+    id: string;
+    name: string;
+    description: string;
+    configSchema: Record<string, unknown>;
+    register: (api: PluginApi) => void;
+};
+declare const plugin: PluginDefinition;
+
+export { plugin as default };

package/dist/index.js

@@ -0,0 +1,232 @@
+import {
+  findProviderByModel,
+  findProviderByName,
+  getApiBase,
+  buildRequestedSkillsUserPrompt,
+  getProvider,
+  getProviderName,
+  getWorkspacePath,
+  SkillsLoader
+} from "@nextclaw/core";
+import {
+  CodexSdkNcpAgentRuntime
+} from "@nextclaw/nextclaw-ncp-runtime-codex-sdk";
+const PLUGIN_ID = "nextclaw-ncp-runtime-plugin-codex-sdk";
+const CODEX_RUNTIME_KIND = "codex";
+function readString(value) {
+  if (typeof value !== "string") {
+    return void 0;
+  }
+  const trimmed = value.trim();
+  return trimmed || void 0;
+}
+function readBoolean(value) {
+  return typeof value === "boolean" ? value : void 0;
+}
+function readRecord(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return void 0;
+  }
+  return value;
+}
+function readStringArray(value) {
+  if (!Array.isArray(value)) {
+    return void 0;
+  }
+  const values = value.map((entry) => readString(entry)).filter((entry) => Boolean(entry));
+  return values.length > 0 ? values : void 0;
+}
+function resolveCodexCapabilitySpec(params) {
+  const providerSpec = params.providerName ? findProviderByName(params.providerName) : void 0;
+  const modelSpec = params.model ? findProviderByModel(params.model) : void 0;
+  return providerSpec?.isGateway ? modelSpec ?? providerSpec : providerSpec ?? modelSpec;
+}
+function readStringRecord(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return void 0;
+  }
+  const out = {};
+  for (const [entryKey, entryValue] of Object.entries(value)) {
+    if (typeof entryValue !== "string") {
+      continue;
+    }
+    const normalized = entryValue.trim();
+    if (!normalized) {
+      continue;
+    }
+    out[entryKey] = normalized;
+  }
+  return Object.keys(out).length > 0 ? out : void 0;
+}
+function readThinkingLevel(value) {
+  if (typeof value !== "string") {
+    return void 0;
+  }
+  const normalized = value.trim().toLowerCase();
+  if (normalized === "minimal" || normalized === "low" || normalized === "medium" || normalized === "high" || normalized === "xhigh") {
+    return normalized;
+  }
+  return void 0;
+}
+function resolveCodexExecutionOptions(params) {
+  const configuredWorkingDirectory = readString(params.pluginConfig.workingDirectory);
+  const workspace = getWorkspacePath(
+    configuredWorkingDirectory ?? params.config.agents.defaults.workspace
+  );
+  return {
+    workingDirectory: workspace,
+    skipGitRepoCheck: readBoolean(params.pluginConfig.skipGitRepoCheck) ?? true
+  };
+}
+function resolveCodexCliConfig(params) {
+  const explicitConfig = readRecord(params.pluginConfig.config);
+  const modelProvider = readString(params.pluginConfig.modelProvider) ?? readString(params.providerName) ?? "openai";
+  const preferredAuthMethod = readString(params.pluginConfig.preferredAuthMethod) ?? "apikey";
+  const apiBase = readString(params.pluginConfig.apiBase) ?? readString(params.apiBase);
+  const config = {
+    model_provider: modelProvider,
+    preferred_auth_method: preferredAuthMethod
+  };
+  if (modelProvider && apiBase) {
+    config.model_providers = {
+      [modelProvider]: {
+        name: modelProvider,
+        base_url: apiBase,
+        wire_api: "responses",
+        requires_openai_auth: true
+      }
+    };
+  }
+  return {
+    ...config,
+    ...explicitConfig ?? {}
+  };
+}
+function stripProviderPrefix(model, providerName) {
+  const normalizedModel = model.trim();
+  const normalizedProvider = providerName?.trim().toLowerCase();
+  if (!normalizedModel || !normalizedProvider) {
+    return normalizedModel;
+  }
+  const prefix = `${normalizedProvider}/`;
+  if (!normalizedModel.toLowerCase().startsWith(prefix)) {
+    return normalizedModel;
+  }
+  return normalizedModel.slice(prefix.length);
+}
+function readRequestedSkills(metadata) {
+  const raw = metadata.requested_skills ?? metadata.requestedSkills;
+  if (!Array.isArray(raw)) {
+    return [];
+  }
+  return raw.map((entry) => readString(entry)).filter((entry) => Boolean(entry)).slice(0, 8);
+}
+function readUserText(input) {
+  for (let index = input.messages.length - 1; index >= 0; index -= 1) {
+    const message = input.messages[index];
+    if (message?.role !== "user") {
+      continue;
+    }
+    const text = message.parts.filter((part) => part.type === "text").map((part) => part.text).join("").trim();
+    if (text) {
+      return text;
+    }
+  }
+  return "";
+}
+function buildCodexInputBuilder(workspace) {
+  const skillsLoader = new SkillsLoader(workspace);
+  return async (input) => {
+    const userText = readUserText(input);
+    const metadata = input.metadata && typeof input.metadata === "object" && !Array.isArray(input.metadata) ? input.metadata : {};
+    const requestedSkills = readRequestedSkills(metadata);
+    return buildRequestedSkillsUserPrompt(skillsLoader, requestedSkills, userText);
+  };
+}
+function resolveCodexModel(params) {
+  return readString(params.sessionMetadata.preferred_model) ?? readString(params.sessionMetadata.model) ?? readString(params.pluginConfig.model) ?? params.config.agents.defaults.model;
+}
+const plugin = {
+  id: PLUGIN_ID,
+  name: "NextClaw Codex NCP Runtime",
+  description: "Registers NCP session type `codex` backed by OpenAI Codex SDK.",
+  configSchema: {
+    type: "object",
+    additionalProperties: true,
+    properties: {}
+  },
+  register(api) {
+    const pluginConfig = readRecord(api.pluginConfig) ?? {};
+    api.registerNcpAgentRuntime({
+      kind: CODEX_RUNTIME_KIND,
+      label: "Codex",
+      createRuntime: (runtimeParams) => {
+        const nextConfig = api.config;
+        const model = resolveCodexModel({
+          config: nextConfig,
+          pluginConfig,
+          sessionMetadata: runtimeParams.sessionMetadata
+        });
+        const provider = getProvider(nextConfig, model);
+        const providerName = getProviderName(nextConfig, model);
+        const capabilitySpec = resolveCodexCapabilitySpec({
+          model,
+          providerName
+        });
+        const apiBase = readString(pluginConfig.apiBase) ?? getApiBase(nextConfig, model) ?? void 0;
+        const apiKey = readString(pluginConfig.apiKey) ?? provider?.apiKey ?? void 0;
+        if (!apiKey) {
+          throw new Error(
+            `[codex] missing apiKey. Set plugins.entries.${PLUGIN_ID}.config.apiKey or providers.*.apiKey for model "${model}".`
+          );
+        }
+        if (capabilitySpec?.supportsResponsesApi === false) {
+          const capabilityProviderName = capabilitySpec.displayName ?? capabilitySpec.name ?? providerName ?? "provider";
+          throw new Error(
+            `[codex] model "${model}" is routed through "${capabilityProviderName}", which does not support the Responses API. Codex SDK currently only supports models available through the Responses API.`
+          );
+        }
+        const executionOptions = resolveCodexExecutionOptions({
+          config: nextConfig,
+          pluginConfig
+        });
+        const thinkingLevel = readThinkingLevel(runtimeParams.sessionMetadata.preferred_thinking) ?? readThinkingLevel(runtimeParams.sessionMetadata.thinking) ?? void 0;
+        return new CodexSdkNcpAgentRuntime({
+          sessionId: runtimeParams.sessionId,
+          apiKey,
+          apiBase,
+          model: stripProviderPrefix(model, providerName),
+          threadId: readString(runtimeParams.sessionMetadata.codex_thread_id) ?? null,
+          codexPathOverride: readString(pluginConfig.codexPathOverride),
+          env: readStringRecord(pluginConfig.env),
+          cliConfig: resolveCodexCliConfig({
+            pluginConfig,
+            model,
+            providerName,
+            apiBase
+          }),
+          stateManager: runtimeParams.stateManager,
+          sessionMetadata: runtimeParams.sessionMetadata,
+          setSessionMetadata: runtimeParams.setSessionMetadata,
+          inputBuilder: buildCodexInputBuilder(executionOptions.workingDirectory),
+          threadOptions: {
+            model,
+            sandboxMode: readString(pluginConfig.sandboxMode),
+            workingDirectory: executionOptions.workingDirectory,
+            skipGitRepoCheck: executionOptions.skipGitRepoCheck,
+            modelReasoningEffort: thinkingLevel,
+            networkAccessEnabled: readBoolean(pluginConfig.networkAccessEnabled),
+            webSearchMode: readString(pluginConfig.webSearchMode),
+            webSearchEnabled: readBoolean(pluginConfig.webSearchEnabled),
+            approvalPolicy: readString(pluginConfig.approvalPolicy),
+            additionalDirectories: readStringArray(pluginConfig.additionalDirectories)
+          }
+        });
+      }
+    });
+  }
+};
+var index_default = plugin;
+export {
+  index_default as default
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextclaw/nextclaw-ncp-runtime-plugin-codex-sdk",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "private": false,
   "description": "NextClaw plugin that registers Codex SDK as an optional NCP runtime.",
   "type": "module",
@@ -21,10 +21,10 @@
     ]
   },
   "dependencies": {
-    "@nextclaw/core": "0.9.3",
+    "@nextclaw/core": "0.9.5",
     "@nextclaw/ncp": "0.3.1",
-    "@nextclaw/nextclaw-ncp-runtime-codex-sdk": "0.1.1",
-    "@nextclaw/ncp-toolkit": "0.4.1"
+    "@nextclaw/ncp-toolkit": "0.4.1",
+    "@nextclaw/nextclaw-ncp-runtime-codex-sdk": "0.1.1"
   },
   "devDependencies": {
     "@types/node": "^20.17.6",