[codex] Add Codex slash command support

apps/server/src/provider/Layers/CodexAdapter.test.ts

@@ -43,6 +43,7 @@ import {
   type CodexSessionRuntimeOptions,
   type CodexSessionRuntimeSendTurnInput,
   type CodexSessionRuntimeShape,
+  type CodexSessionRuntimeSlashCommandInput,
   type CodexThreadSnapshot,
 } from "./CodexSessionRuntime.ts";
 import { makeCodexAdapter } from "./CodexAdapter.ts";
@@ -83,6 +84,14 @@ class FakeCodexRuntime implements CodexSessionRuntimeShape {
       }),
   );
 
+  public readonly runSlashCommandImpl = vi.fn(
+    (_input: CodexSessionRuntimeSlashCommandInput): Promise<ProviderTurnStartResult> =>
+      Promise.resolve({
+        threadId: this.options.threadId,
+        turnId: asTurnId("turn-1"),
+      }),
+  );
+
   public readonly interruptTurnImpl = vi.fn(
     (_turnId?: TurnId): Promise<void> => Promise.resolve(undefined),
   );
@@ -131,6 +140,10 @@ class FakeCodexRuntime implements CodexSessionRuntimeShape {
     return Effect.promise(() => this.sendTurnImpl(input));
   }
 
+  runSlashCommand(input: CodexSessionRuntimeSlashCommandInput) {
+    return Effect.promise(() => this.runSlashCommandImpl(input));
+  }
+
   interruptTurn(turnId?: TurnId) {
     return Effect.promise(() => this.interruptTurnImpl(turnId));
   }

apps/server/src/provider/Layers/CodexAdapter.ts

@@ -58,6 +58,7 @@ import {
   makeCodexSessionRuntime,
   type CodexSessionRuntimeError,
   type CodexSessionRuntimeOptions,
+  type CodexSessionRuntimeSlashCommandInput,
   type CodexSessionRuntimeShape,
 } from "./CodexSessionRuntime.ts";
 import { type EventNdjsonLogger, makeEventNdjsonLogger } from "./EventNdjsonLogger.ts";
@@ -92,6 +93,34 @@ interface CodexAdapterSessionContext {
   stopped: boolean;
 }
 
+function parseStandaloneCodexSlashCommand(
+  input: ProviderSendTurnInput,
+): CodexSessionRuntimeSlashCommandInput | null {
+  if ((input.attachments?.length ?? 0) > 0) {
+    return null;
+  }
+
+  const text = input.input?.trim();
+  if (!text) {
+    return null;
+  }
+
+  const match = /^\/([a-z][a-z-]*)(?:\s+([\s\S]*))?$/i.exec(text);
+  if (!match) {
+    return null;
+  }
+
+  const command = match[1]?.toLowerCase();
+  const args = match[2]?.trim();
+  if (command === "compact" && !args) {
+    return { command: "compact" };
+  }
+  if (command === "review") {
+    return args ? { command: "review", instructions: args } : { command: "review" };
+  }
+  return null;
+}
+
 function mapCodexRuntimeError(
   threadId: ThreadId,
   method: string,
@@ -1531,16 +1560,29 @@ export const makeCodexAdapter = Effect.fn("makeCodexAdapter")(function* (
       input.modelSelection?.instanceId === boundInstanceId
         ? getModelSelectionStringOptionValue(input.modelSelection, "reasoningEffort")
         : undefined;
+    const selectedModel =
+      input.modelSelection?.instanceId === boundInstanceId ? input.modelSelection.model : undefined;
     const serviceTier =
       input.modelSelection?.instanceId === boundInstanceId
         ? getCodexServiceTierOptionValue(input.modelSelection)
         : undefined;
+    const slashCommand = parseStandaloneCodexSlashCommand(input);
+    if (slashCommand) {
+      return yield* session.runtime
+        .runSlashCommand({
+          ...slashCommand,
+          ...(selectedModel ? { model: selectedModel } : {}),
+        })
+        .pipe(
+          Effect.mapError((cause) =>
+            mapCodexRuntimeError(input.threadId, `/${slashCommand.command}`, cause),
+          ),
+        );
+    }
     return yield* session.runtime
       .sendTurn({
         ...(input.input !== undefined ? { input: input.input } : {}),
-        ...(input.modelSelection?.instanceId === boundInstanceId
-          ? { model: input.modelSelection.model }
-          : {}),
+        ...(selectedModel ? { model: selectedModel } : {}),
         ...(reasoningEffort
           ? {
               effort: reasoningEffort as EffectCodexSchema.V2TurnStartParams__ReasoningEffort,

apps/server/src/provider/Layers/CodexProvider.ts

@@ -20,6 +20,7 @@ import type {
   ModelCapabilities,
   ProviderOptionDescriptor,
   ServerProviderModel,
+  ServerProviderSlashCommand,
   ServerProviderSkill,
 } from "@t3tools/contracts";
 import { ServerSettingsError } from "@t3tools/contracts";
@@ -42,6 +43,18 @@ const CODEX_PRESENTATION = {
   showInteractionModeToggle: true,
 } as const;
 
+const CODEX_APP_SERVER_SLASH_COMMANDS = [
+  {
+    name: "review",
+    description: "Review current changes and find issues",
+    input: { hint: "optional review instructions" },
+  },
+  {
+    name: "compact",
+    description: "Summarize conversation history to preserve context",
+  },
+] satisfies ReadonlyArray<ServerProviderSlashCommand>;
+
 export interface CodexAppServerProviderSnapshot {
   readonly account: CodexSchema.V2GetAccountResponse;
   readonly version: string | undefined;
@@ -402,6 +415,7 @@ const makePendingCodexProvider = (
         enabled: false,
         checkedAt,
         models,
+        slashCommands: [],
         skills: [],
         probe: {
           installed: false,
@@ -418,6 +432,7 @@ const makePendingCodexProvider = (
       enabled: true,
       checkedAt,
       models,
+      slashCommands: [],
       skills: [],
       probe: {
         installed: false,
@@ -487,6 +502,7 @@ export const checkCodexProviderStatus = Effect.fn("checkCodexProviderStatus")(fu
       enabled: false,
       checkedAt,
       models: emptyModels,
+      slashCommands: [],
       skills: [],
       probe: {
         installed: false,
@@ -518,6 +534,7 @@ export const checkCodexProviderStatus = Effect.fn("checkCodexProviderStatus")(fu
       enabled: codexSettings.enabled,
       checkedAt,
       models: emptyModels,
+      slashCommands: [],
       skills: [],
       probe: {
         installed,
@@ -537,6 +554,7 @@ export const checkCodexProviderStatus = Effect.fn("checkCodexProviderStatus")(fu
       enabled: codexSettings.enabled,
       checkedAt,
       models: emptyModels,
+      slashCommands: [],
       skills: [],
       probe: {
         installed: true,
@@ -556,6 +574,7 @@ export const checkCodexProviderStatus = Effect.fn("checkCodexProviderStatus")(fu
     enabled: codexSettings.enabled,
     checkedAt,
     models: snapshot.models,
+    slashCommands: CODEX_APP_SERVER_SLASH_COMMANDS,
     skills: snapshot.skills,
     probe: {
       installed: true,