@velum-labs/routekit-tool-codex 0.17.2 → 0.17.4

package/dist/launch.d.ts

@@ -24,7 +24,7 @@ export declare function hasCodexLogin(home?: string): boolean;
  */
 export declare function createIsolatedCodexHome(prefix: string, env?: Record<string, string | undefined>): string;
 export declare function codexListedStockSlugs(home?: string): string[];
-export declare function codexCatalogEntries(spec: Pick<ToolLaunchSpec, "defaultModel" | "models">, template: CodexModelPreset, stockModels?: readonly CodexModelPreset[], options?: {
+export declare function codexCatalogEntries(spec: Pick<ToolLaunchSpec, "defaultModel" | "modelSelection" | "models">, template: CodexModelPreset, stockModels?: readonly CodexModelPreset[], options?: {
     appendUnlistedStock?: boolean;
 }): Record<string, unknown>[];
 export declare function codexModelCatalogJson(spec: Pick<ToolLaunchSpec, "defaultModel" | "models">, template: CodexModelPreset, stockModels?: readonly CodexModelPreset[], options?: {

package/dist/launch.js

@@ -2,7 +2,7 @@ import { spawn } from "node:child_process";
 import { existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { homedir, tmpdir } from "node:os";
 import { isAbsolute, join } from "node:path";
-import { isCodexPickerEligibleModel, reasoningEffortDescriptors } from "@velum-labs/routekit-contracts";
+import { codexCompatibility, isCodexPickerEligibleModel, reasoningEffortDescriptors } from "@velum-labs/routekit-contracts";
 import { trimTrailingSlashes } from "@velum-labs/routekit-runtime";
 import { stringify as tomlStringify } from "smol-toml";
 const PROVIDER_ID = "routekit";
@@ -88,9 +88,33 @@ function codexModelId(modelId) {
     return modelId.startsWith("codex/") ? modelId.slice("codex/".length) : modelId;
 }
 function catalogModels(spec) {
-    return spec.models.filter((model) => model.id === spec.defaultModel ||
-        model.aliases?.includes(spec.defaultModel) === true ||
-        isCodexPickerEligibleModel(model));
+    return spec.models.filter((model) => {
+        const isDefault = model.id === spec.defaultModel ||
+            model.aliases?.includes(spec.defaultModel) === true;
+        if (spec.modelSelection === undefined) {
+            return isDefault || isCodexPickerEligibleModel(model);
+        }
+        if (isDefault && spec.modelSelection !== "implicit")
+            return true;
+        return codexCompatibility({
+            id: model.id,
+            ...(model.provider !== undefined ? { provider: model.provider } : {}),
+            ...(model.architecture !== undefined ? { architecture: model.architecture } : {}),
+            ...(model.supportedParameters !== undefined
+                ? { supportedParameters: model.supportedParameters }
+                : {}),
+            ...(model.features?.tools !== undefined
+                ? {
+                    capabilities: {
+                        tools: model.features.tools === "full"
+                            ? "supported"
+                            : model.features.tools
+                    }
+                }
+                : {}),
+            ...(model.reasoning !== undefined ? { reasoning: model.reasoning } : {})
+        }).status === "compatible";
+    });
 }
 function catalogIds(spec) {
     return [
@@ -387,6 +411,13 @@ function spawnCodex(args, home, cwd, token, dependencies) {
 }
 /** Launch against the user's real Codex home; only generated catalog data is temporary. */
 export async function launchCodex(ctx, deps = {}) {
+    if (!ctx.spec.models.some((model) => model.id === ctx.spec.defaultModel)) {
+        throw new Error(`Codex startup model "${ctx.spec.defaultModel}" is absent from the advertised catalog`);
+    }
+    if (!catalogModels(ctx.spec).some((model) => model.id === ctx.spec.defaultModel ||
+        model.aliases?.includes(ctx.spec.defaultModel) === true)) {
+        throw new Error(`Codex startup model "${ctx.spec.defaultModel}" is not in the compatible model picker`);
+    }
     const home = resolveCodexHome(deps.env ?? process.env);
     const temp = mkdtempSync(join(tmpdir(), "rk-codex-"));
     ctx.registerDisposer(() => rmSync(temp, { recursive: true, force: true }));

package/dist/test/launch.test.js

@@ -3,7 +3,7 @@ import { existsSync, mkdtempSync, rmSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
 import { test } from "node:test";
-import { codexAgentRoleToml, codexCatalogEntries, codexLaunchConfigToml, codexModelCatalogJson, codexPersistentModelCatalogJson, createIsolatedCodexHome, resolveCodexHome } from "../launch.js";
+import { codexAgentRoleToml, codexCatalogEntries, codexLaunchConfigToml, codexModelCatalogJson, codexPersistentModelCatalogJson, createIsolatedCodexHome, launchCodex, resolveCodexHome } from "../launch.js";
 const SPEC = {
     gatewayUrl: "http://127.0.0.1:9999",
     defaultModel: "opaque-primary",
@@ -71,6 +71,72 @@ test("Codex launcher filters incompatible OpenRouter models and aliases", () =>
     };
     assert.deepEqual(codexCatalogEntries(spec, { slug: "stock" }, [], { appendUnlistedStock: false }).map((entry) => entry.slug), ["openai/unknown", "openrouter/reasoning", "reasoning-alias", "openai-alias"]);
 });
+test("implicit Codex picker excludes embedding models and keeps the selected generation model", () => {
+    const spec = {
+        gatewayUrl: "http://127.0.0.1:9999",
+        defaultModel: "openai/a-generation",
+        modelSelection: "implicit",
+        models: [
+            {
+                id: "openai/text-embedding-ada-002",
+                provider: "openai",
+                architecture: {
+                    inputModalities: ["text"],
+                    outputModalities: ["embeddings"]
+                }
+            },
+            {
+                id: "openai/a-generation",
+                provider: "openai",
+                architecture: {
+                    inputModalities: ["text"],
+                    outputModalities: ["text"]
+                },
+                supportedParameters: ["tools"]
+            }
+        ],
+        args: []
+    };
+    assert.deepEqual(codexCatalogEntries(spec, { slug: "stock" }, [], {
+        appendUnlistedStock: false
+    }).map((entry) => entry.slug), ["openai/a-generation"]);
+});
+test("Codex fails before passthrough or child spawn when an implicit default is incompatible", async () => {
+    let prepared = false;
+    let spawned = false;
+    await assert.rejects(launchCodex({
+        spec: {
+            gatewayUrl: "http://127.0.0.1:9999",
+            defaultModel: "openai/text-embedding-ada-002",
+            modelSelection: "implicit",
+            models: [
+                {
+                    id: "openai/text-embedding-ada-002",
+                    provider: "openai",
+                    architecture: {
+                        inputModalities: ["text"],
+                        outputModalities: ["embeddings"]
+                    }
+                }
+            ],
+            args: []
+        },
+        log: () => { },
+        prepareForPassthrough: () => {
+            prepared = true;
+        },
+        registerPort: () => "",
+        unregisterPort: () => { },
+        registerDisposer: () => { }
+    }, {
+        spawnProcess: (() => {
+            spawned = true;
+            throw new Error("must not spawn");
+        })
+    }), /not in the compatible model picker/);
+    assert.equal(prepared, false);
+    assert.equal(spawned, false);
+});
 test("Codex launcher neutralizes stock-model behavior for gateway-routed models", () => {
     const template = {
         slug: "gpt-stock",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@velum-labs/routekit-tool-codex",
   "private": false,
-  "version": "0.17.2",
+  "version": "0.17.4",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/velum-labs/routekit.git",
@@ -29,11 +29,11 @@
     "@openai/codex-sdk": "0.145.0",
     "smol-toml": "1.7.0",
     "zod": "4.4.3",
-    "@velum-labs/routekit-contracts": "0.17.2",
-    "@velum-labs/routekit-harness-core": "0.17.2",
-    "@velum-labs/routekit-runtime": "0.17.2",
-    "@velum-labs/routekit-tools": "0.17.2",
-    "@velum-labs/routekit-registry": "0.17.2"
+    "@velum-labs/routekit-contracts": "0.17.4",
+    "@velum-labs/routekit-harness-core": "0.17.4",
+    "@velum-labs/routekit-registry": "0.17.4",
+    "@velum-labs/routekit-tools": "0.17.4",
+    "@velum-labs/routekit-runtime": "0.17.4"
   },
   "keywords": [
     "llm",