@supercorks/krnl 0.1.0 → 0.1.1

package/README.md

@@ -1,7 +1,7 @@
 # Kernel CLI
 
-Connect [Kernel](https://app.krnl.work) to Codex on your Mac. Start a task from Kernel in Plan or
-Work mode, then open the same task in Codex. Conversations and approvals stay in Codex; Kernel
+Connect [Kernel](https://app.krnl.work) to Codex on your Mac. Choose **Launch in Codex** on a Kernel task, review Plan/Work mode, destination, model, reasoning,
+and folder options in the popup, then open the same task in Codex. Conversations and approvals stay in Codex; Kernel
 shows execution status and a direct link.
 
 ## Install and connect
@@ -14,6 +14,8 @@ krnl login
 krnl connect codex
 ```
 
+If pnpm reports `ERR_PNPM_NO_GLOBAL_BIN_DIR`, run `pnpm setup`, open a new Terminal tab, and retry the install.
+
 `krnl login` opens Kernel in your default browser. Sign in with your invited Kernel account and
 choose **Connect CLI**. Return to Terminal when the browser says the login is finishing.
 
@@ -24,8 +26,12 @@ instructions if the new hooks need review. Review the eight Kernel hooks and res
 tasks afterward. The companion detects completed review automatically.
 
 Open **Settings → Integrations → Codex** in Kernel to map an organization or project to a saved
-Codex project. Your Mac and saved projects appear automatically. Launches stay disabled until setup
-is ready; one unavailable project does not disable healthy projects.
+Codex project. Your Mac and saved projects appear automatically. Each connection card contains its organization and
+project mappings. Choose **Add mapping** or **Edit** to set the destination, model, and reasoning.
+New mappings default to **GPT-6 Astra · xhigh**; choices come from that Mac’s current Codex model
+catalog. Launches stay disabled until setup is ready; one unavailable project does not disable
+healthy projects. **Delete connection** revokes its authorization and removes its mappings, while
+keeping existing tasks, handoff history, receipts, and worktrees.
 
 No repository checkout, build tools, copied IDs, or per-folder authorization commands are needed.
 Installing the npm package alone does not start a service or change Codex configuration.
@@ -50,6 +56,9 @@ pnpm add -g @supercorks/krnl@latest
 krnl connect codex
 ```
 
+Version **0.1.1 or later** is required to launch with mapping model and reasoning settings.
+Kernel explains when an older companion needs this update; existing task monitoring continues.
+
 Repeated connection reuses the machine identity. Review changed hook commands in `/hooks` if Node
 moved. After updating Node, run `krnl connect codex` to refresh the service’s executable path.
 

package/dist/kernel-companion.mjs

@@ -22061,6 +22061,25 @@ var reconcileTogglEntrySchema = external_exports.discriminatedUnion("action", [
 
 // ../domain/src/codex.ts
 var CODEX_PROTOCOL_VERSION = 1;
+var CODEX_DEFAULT_MODEL = "gpt-6-astra";
+var CODEX_DEFAULT_REASONING_EFFORT = "xhigh";
+var CODEX_REASONING_EFFORTS = [
+  "none",
+  "minimal",
+  "low",
+  "medium",
+  "high",
+  "xhigh",
+  "max",
+  "ultra"
+];
+var codexReasoningEffortSchema = external_exports.enum(CODEX_REASONING_EFFORTS);
+var codexModelIdSchema = external_exports.string().trim().min(1).max(200).regex(/^[A-Za-z0-9][A-Za-z0-9._:/-]*$/);
+var codexModelSchema = external_exports.strictObject({
+  id: codexModelIdSchema,
+  label: external_exports.string().trim().min(1).max(200),
+  reasoningEfforts: external_exports.array(codexReasoningEffortSchema).min(1).max(CODEX_REASONING_EFFORTS.length)
+});
 var protocolVersion = external_exports.literal(CODEX_PROTOCOL_VERSION);
 var sequence = external_exports.number().int().nonnegative().max(Number.MAX_SAFE_INTEGER);
 var identity = external_exports.string().min(1).max(200);
@@ -22078,6 +22097,9 @@ var codexCatalogProjectSchema = external_exports.strictObject({
 var codexHealthSchema = external_exports.strictObject({
   reachable: external_exports.boolean(),
   hooksReady: external_exports.boolean(),
+  // Older companions cannot parse model settings in strict launch payloads.
+  supportsModelSelection: external_exports.boolean().optional(),
+  models: external_exports.array(codexModelSchema).max(100).optional(),
   appServerVersion: external_exports.string().max(100),
   desktopVersion: external_exports.string().max(100),
   issue: external_exports.string().max(500).nullable()
@@ -22103,6 +22125,8 @@ var saveCodexMappingSchema = external_exports.strictObject({
   machineId: external_exports.uuid(),
   projectId: identity,
   checkout: codexCheckoutSchema,
+  model: codexModelIdSchema.default(CODEX_DEFAULT_MODEL),
+  reasoningEffort: codexReasoningEffortSchema.default(CODEX_DEFAULT_REASONING_EFFORT),
   version: sequence.default(0)
 });
 var deleteCodexMappingSchema = external_exports.strictObject({
@@ -22116,6 +22140,9 @@ var launchCodexTaskSchema = external_exports.strictObject({
   taskId: external_exports.uuid(),
   taskVersion: external_exports.number().int().positive(),
   mode: codexModeSchema,
+  model: codexModelIdSchema.optional(),
+  reasoningEffort: codexReasoningEffortSchema.optional(),
+  checkout: codexCheckoutSchema.optional(),
   override: external_exports.strictObject({ machineId: external_exports.uuid(), projectId: identity }).optional()
 });
 var codexLaunchSchema = external_exports.strictObject({
@@ -22125,6 +22152,8 @@ var codexLaunchSchema = external_exports.strictObject({
   mode: codexModeSchema,
   destination: codexCatalogProjectSchema,
   checkout: codexCheckoutSchema,
+  model: codexModelIdSchema.optional(),
+  reasoningEffort: codexReasoningEffortSchema.optional(),
   submittedAt: external_exports.iso.datetime(),
   expiresAt: external_exports.iso.datetime(),
   task: external_exports.strictObject({
@@ -22269,6 +22298,71 @@ var settingsHealthSnapshotSchema = external_exports.object({
   })
 });
 
+// src/models.ts
+var messages = {
+  catalog: "Codex's model catalog could not be read. Reconnect the companion and try again.",
+  model: "The selected model is unavailable on this Mac. Choose another model in Codex settings.",
+  effort: "The selected model does not support this reasoning effort. Update the Codex settings and try again."
+};
+var CodexModelSelectionError = class extends Error {
+  constructor(reason) {
+    super(messages[reason]);
+  }
+};
+var modelPageSchema = external_exports.object({
+  data: external_exports.array(
+    external_exports.object({
+      model: codexModelIdSchema,
+      displayName: external_exports.string().trim().min(1),
+      supportedReasoningEfforts: external_exports.array(external_exports.object({ reasoningEffort: external_exports.string() }))
+    })
+  ),
+  nextCursor: external_exports.string().min(1).nullable().optional()
+});
+async function discoverModels(server) {
+  try {
+    const models = /* @__PURE__ */ new Map();
+    const cursors = /* @__PURE__ */ new Set();
+    let cursor;
+    do {
+      const page = modelPageSchema.parse(
+        await server.call("model/list", { limit: 100, ...cursor ? { cursor } : {} }, 5e3)
+      );
+      for (const model of page.data) {
+        const reasoningEfforts = model.supportedReasoningEfforts.flatMap((option) => {
+          const parsed = codexReasoningEffortSchema.safeParse(option.reasoningEffort);
+          return parsed.success ? [parsed.data] : [];
+        });
+        if (!reasoningEfforts.length) continue;
+        models.set(model.model, {
+          id: model.model,
+          label: model.displayName.slice(0, 200),
+          reasoningEfforts: [...new Set(reasoningEfforts)]
+        });
+        if (models.size > 100) throw new CodexModelSelectionError("catalog");
+      }
+      cursor = page.nextCursor ?? void 0;
+      if (cursor) {
+        if (cursors.has(cursor) || cursors.size >= 100)
+          throw new CodexModelSelectionError("catalog");
+        cursors.add(cursor);
+      }
+    } while (cursor);
+    return [...models.values()];
+  } catch {
+    throw new CodexModelSelectionError("catalog");
+  }
+}
+function resolveModelSelection(launch, models) {
+  const model = launch.model ?? CODEX_DEFAULT_MODEL;
+  const reasoningEffort = launch.reasoningEffort ?? CODEX_DEFAULT_REASONING_EFFORT;
+  const available = models.find((candidate) => candidate.id === model);
+  if (!available) throw new CodexModelSelectionError("model");
+  if (!available.reasoningEfforts.includes(reasoningEffort))
+    throw new CodexModelSelectionError("effort");
+  return { model, reasoningEffort };
+}
+
 // src/runtime.ts
 var sourceMarker = (id) => `kernel-handoff:${id}`;
 function initialReceipt(launch) {
@@ -22353,6 +22447,8 @@ async function runCompanion(machineId, entrypoint2, signal) {
     let health = {
       reachable: false,
       hooksReady: false,
+      supportsModelSelection: true,
+      models: [],
       appServerVersion: "",
       desktopVersion: "",
       issue: "Checking Codex compatibility."
@@ -22418,16 +22514,22 @@ async function runCompanion(machineId, entrypoint2, signal) {
           () => queue.push({ launchId: launch.id, event: { method: "kernel/closed" } })
         );
         await owner.initialize();
+        const selection = resolveModelSelection(launch, await discoverModels(owner));
+        if (!canBegin(receipt, Date.now() + clockOffset))
+          throw new Error("The launch expired while checking model availability");
+        receipt.model = selection.model;
+        receipt.effort = selection.reasoningEffort;
         receipt.phase = "creating";
         await save(receipt);
         const created = await owner.call("thread/start", {
           cwd: receipt.cwd,
           projectId: project.id,
-          threadSource: sourceMarker(launch.id)
+          threadSource: sourceMarker(launch.id),
+          model: selection.model,
+          config: { model_reasoning_effort: selection.reasoningEffort },
+          allowProviderModelFallback: false
         });
         receipt.threadId = created.thread.id;
-        receipt.model = created.model;
-        receipt.effort = created.reasoningEffort ?? null;
         receipt.phase = "created";
         await save(receipt);
         await indexThreads();
@@ -22442,14 +22544,14 @@ async function runCompanion(machineId, entrypoint2, signal) {
           input: [{ type: "text", text: codexLaunchPrompt(launch) }],
           collaborationMode: collaborationMode(
             launch.mode,
-            created.model,
-            created.reasoningEffort ?? null
+            selection.model,
+            selection.reasoningEffort
           )
         });
         receipt.turnId = response.turn.id;
         receipt.status.turnId = response.turn.id;
         await save(receipt);
-      } catch {
+      } catch (error51) {
         try {
           await owners.get(launch.id)?.stop();
         } catch {
@@ -22474,7 +22576,7 @@ async function runCompanion(machineId, entrypoint2, signal) {
           };
         } else {
           receipt.ambiguous = receipt.phase === "creating";
-          receipt.failure = receipt.ambiguous ? "Confirming whether Codex created the task. This launch will not be repeated." : "The task could not start. Check the locally authorized project and checkout policy.";
+          receipt.failure = receipt.ambiguous ? "Confirming whether Codex created the task. This launch will not be repeated." : error51 instanceof CodexModelSelectionError ? error51.message : "The task could not start. Check the locally authorized project and checkout policy.";
           if (!receipt.ambiguous) receipt.phase = "failed";
         }
         await save(receipt);
@@ -22518,21 +22620,25 @@ async function runCompanion(machineId, entrypoint2, signal) {
               "Print:CFBundleShortVersionString",
               "/Applications/ChatGPT.app/Contents/Info.plist"
             ]).then((result) => result.stdout.trim()).catch(() => "");
+            const models = await discoverModels(observer);
             health = {
               reachable: true,
               hooksReady: ready,
+              supportsModelSelection: true,
+              models,
               appServerVersion: stdout.trim(),
               desktopVersion: desktop,
               issue: ready ? null : "Review the eight Kernel hooks using /hooks in Codex CLI. The companion detects completed review automatically."
             };
-          } catch {
+          } catch (error51) {
             observer?.close();
             observer = void 0;
             health = {
               ...health,
               reachable: false,
               hooksReady: false,
-              issue: "Codex could not be reached through its supported app-server interface."
+              models: [],
+              issue: error51 instanceof CodexModelSelectionError ? error51.message : "Codex could not be reached through its supported app-server interface."
             };
           }
           try {
@@ -23243,7 +23349,7 @@ async function main() {
   }
   if (command === "--version") {
     process.stdout.write(
-      `${false ? "development" : "0.1.0"}
+      `${false ? "development" : "0.1.1"}
 `
     );
     return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supercorks/krnl",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Connect Kernel to Codex on your Mac",
   "type": "module",
   "bin": {