@antelopejs/dms-ai 0.0.6 → 0.1.0

package/README.md

@@ -7,8 +7,9 @@
 </div>
 
 An AntelopeJS DMS development assistant. It adds an owner-only AI workspace to the dashboard and
-runs Claude Code in a local sidecar that can inspect the loaded modules and their declared skills,
-edit the host project, and stream activity back to the dashboard.
+runs a coding agent in a local sidecar that can inspect the loaded modules and their declared skills,
+edit the host project, and stream activity back to the dashboard. Claude Code drives it by default;
+OpenAI's Codex is selectable once its CLI is installed.
 
 ## Installation
 
@@ -22,6 +23,55 @@ The module starts its bundled sidecar with the project as its working directory.
 set `DMS_AI=0` before starting the backend to disable the sidecar. If
 `@antelopejs/dms-builder` is installed, the assistant also exposes its builder integration.
 
+## Agent providers
+
+The assistant runs on either Claude Code or Codex, picked in the AI settings page. Both go through
+the same seam, so the chat, the tool calls, the permission prompts and the file-change animation
+behave the same either way. `GET /settings` reports which ones this install can actually drive:
+
+```json
+{ "provider": "claude", "providers": { "claude": { "available": true }, "codex": { "available": false, "reason": "Install @openai/codex, at the exact version dms-ai pins, to enable this provider." } } }
+```
+
+`claude` is the default *choice*, not a fallback. A provider that this install cannot drive — its
+package uninstalled, its API key gone from the environment — fails the turn with that reason in the
+chat, and the conversation is never quietly handed to the other backend: someone who picked OpenAI
+may have picked it precisely so their code does not reach Anthropic.
+
+Switching provider disposes the live sessions of the previous one — an open conversation loses its
+in-agent context, its transcript is kept.
+
+### Enabling Codex
+
+1. **Install the `codex` CLI.** It is an *optional* peer dependency, so it is never installed for
+   you: the platform packages weigh ~324 MB unpacked, and only the installs that want Codex should
+   pay for them. Use the exact version this module pins, in `peerDependencies["@openai/codex"]`:
+
+   ```bash
+   pnpm add @openai/codex@0.154.0
+   ```
+
+   The app-server protocol is versioned by binary and OpenAI publishes roughly ten versions a
+   month. The sidecar ships protocol types generated from the pinned version and checks
+   `codex --version` against it at spawn, refusing to start on a mismatch rather than speaking a
+   protocol its types do not describe. The refusal names both versions, so an upgrade says what to
+   pin back to. To run a newer binary anyway — at the risk of a protocol its types do not
+   describe — set `DMS_AI_CODEX_ALLOW_VERSION_MISMATCH=1`; the drift is then logged once, at startup, instead of
+   blocking the provider.
+
+2. **Provide an API key.** Export `OPENAI_API_KEY` in the host process environment. The binary does
+   not read that variable itself: the sidecar writes it into an `auth.json` (mode `0600`) inside a
+   `CODEX_HOME` dedicated to the conversation. On Windows that mode is not enforced by the
+   filesystem, so the file is only as private as the directory it sits in. ChatGPT login is not
+   supported here — it shares a token refresh with the user's own `codex` install.
+
+3. **Restart the sidecar**, then pick *OpenAI (Codex)* in the AI settings page.
+
+Linux, macOS and Windows are all supported. One app-server process runs per conversation, and the
+sidecar records its pid so a previous run's orphans are killed at startup — through procfs on
+Linux, `ps` on macOS and `taskkill /T` on Windows, which is also what takes the sandboxed children
+of the app-server with it.
+
 ## Vue frontend
 
 The module registers `frontend-vue` through `AddFrontendModule` with the Vue 3 renderer. The host DMS supplies authentication and shared state.

package/dist/routes/settings.d.ts

@@ -1,9 +1,16 @@
+type ProviderName = "claude" | "codex";
+interface ProviderAvailability {
+    available: boolean;
+    reason?: string;
+}
 interface AiSettings {
+    provider: ProviderName;
     mode: "normal" | "acceptEdits" | "plan" | "auto";
     thinking: "off" | "low" | "medium" | "high";
     generationMode: "safe" | "vibe";
     allowLocalSkills: boolean;
     builderAvailable: boolean;
+    providers: Record<ProviderName, ProviderAvailability>;
 }
 declare const AISettingsController_base: import("@antelopejs/interface-api").ControllerClass<object>;
 export declare class AISettingsController extends AISettingsController_base {

package/dist/routes/settings.js

@@ -18,11 +18,13 @@ const auth_1 = require("@antelopejs/interface-dms/auth");
 const module_1 = require("../constants/module");
 const proxy_1 = require("./proxy");
 const DEFAULT_SETTINGS = {
+    provider: "claude",
     mode: "normal",
     thinking: "medium",
     generationMode: "safe",
     allowLocalSkills: false,
     builderAvailable: false,
+    providers: { claude: { available: true }, codex: { available: false } },
 };
 let AISettingsController = class AISettingsController extends (0, interface_api_1.Controller)(module_1.ROUTE_PREFIX) {
     getSettings() {

package/dist/routes/settings.js.map

@@ -1 +1 @@
-{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../src/routes/settings.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,6DAA2E;AAC3E,yDAA+D;AAC/D,gDAAmD;AACnD,mCAAiD;AAYjD,MAAM,gBAAgB,GAAe;IACnC,IAAI,EAAE,QAAQ;IACd,QAAQ,EAAE,QAAQ;IAClB,cAAc,EAAE,MAAM;IACtB,gBAAgB,EAAE,KAAK;IACvB,gBAAgB,EAAE,KAAK;CACxB,CAAC;AAGK,IAAM,oBAAoB,GAA1B,MAAM,oBAAqB,SAAQ,IAAA,0BAAU,EAAC,qBAAY,CAAC;IAEhE,WAAW;QACT,OAAO,IAAA,kBAAU,EAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC;IACnD,CAAC;IAGD,cAAc,CAAa,IAAa;QACtC,OAAO,IAAA,kBAAU,EAAC,WAAW,EAAE,IAAI,EAAE,gBAAgB,CAAC,CAAC;IACzD,CAAC;CACF,CAAA;AAVY,oDAAoB;AAE/B;IADC,IAAA,mBAAG,EAAC,WAAW,CAAC;;;;uDAGhB;AAGD;IADC,IAAA,mBAAG,EAAC,WAAW,CAAC;IACD,WAAA,IAAA,wBAAQ,GAAE,CAAA;;;;0DAEzB;+BATU,oBAAoB;IADhC,IAAA,oBAAa,GAAE;GACH,oBAAoB,CAUhC"}
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../src/routes/settings.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,6DAA2E;AAC3E,yDAA+D;AAC/D,gDAAmD;AACnD,mCAAiD;AAwBjD,MAAM,gBAAgB,GAAe;IACnC,QAAQ,EAAE,QAAQ;IAClB,IAAI,EAAE,QAAQ;IACd,QAAQ,EAAE,QAAQ;IAClB,cAAc,EAAE,MAAM;IACtB,gBAAgB,EAAE,KAAK;IACvB,gBAAgB,EAAE,KAAK;IACvB,SAAS,EAAE,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE;CACxE,CAAC;AAGK,IAAM,oBAAoB,GAA1B,MAAM,oBAAqB,SAAQ,IAAA,0BAAU,EAAC,qBAAY,CAAC;IAEhE,WAAW;QACT,OAAO,IAAA,kBAAU,EAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC;IACnD,CAAC;IAGD,cAAc,CAAa,IAAa;QACtC,OAAO,IAAA,kBAAU,EAAC,WAAW,EAAE,IAAI,EAAE,gBAAgB,CAAC,CAAC;IACzD,CAAC;CACF,CAAA;AAVY,oDAAoB;AAE/B;IADC,IAAA,mBAAG,EAAC,WAAW,CAAC;;;;uDAGhB;AAGD;IADC,IAAA,mBAAG,EAAC,WAAW,CAAC;IACD,WAAA,IAAA,wBAAQ,GAAE,CAAA;;;;0DAEzB;+BATU,oBAAoB;IADhC,IAAA,oBAAa,GAAE;GACH,oBAAoB,CAUhC"}

package/frontend-vue/app/components/SettingsView.vue

@@ -4,23 +4,33 @@ import { computed, onMounted, ref } from 'vue'
 type Mode = 'normal' | 'acceptEdits' | 'plan' | 'auto'
 type Thinking = 'off' | 'low' | 'medium' | 'high'
 type GenerationMode = 'safe' | 'vibe'
+type ProviderName = 'claude' | 'codex'
+
+interface ProviderAvailability {
+	available: boolean
+	reason?: string
+}
 
 interface AiSettings {
+	provider: ProviderName
 	mode: Mode
 	thinking: Thinking
 	generationMode: GenerationMode
 	allowLocalSkills: boolean
 	builderAvailable: boolean
+	providers: Record<ProviderName, ProviderAvailability>
 }
 
 const { $authFetch } = useAuthFetch()
 
 const settings = ref<AiSettings>({
+	provider: 'claude',
 	mode: 'normal',
 	thinking: 'medium',
 	generationMode: 'safe',
 	allowLocalSkills: false,
 	builderAvailable: false,
+	providers: { claude: { available: true }, codex: { available: false } },
 })
 const loading = ref(false)
 const saving = ref(false)
@@ -37,6 +47,23 @@ const MODE_OPTIONS: Array<{ value: Mode; label: string; hint: string }> = [
 	{ value: 'auto', label: 'Auto', hint: 'Auto-approve every tool action' },
 ]
 
+const PROVIDER_OPTIONS: Array<{
+	value: ProviderName
+	label: string
+	model: string
+}> = [
+	{ value: 'claude', label: 'Anthropic (Claude)', model: 'Claude Opus 4.x' },
+	{ value: 'codex', label: 'OpenAI (Codex)', model: 'GPT-5.x (Codex default)' },
+]
+
+// One control, two meanings: a token budget on Claude, a reasoning effort level
+// on Codex, which has no "off" and maps it to its lowest level.
+const THINKING_HINTS: Record<ProviderName, string> = {
+	claude: 'Thinking budget handed to the model.',
+	codex:
+		'Reasoning effort handed to the model. Codex has no "off": it maps to the lowest level.',
+}
+
 const THINKING_OPTIONS: Array<{ value: Thinking; label: string }> = [
 	{ value: 'off', label: 'Off' },
 	{ value: 'low', label: 'Low' },
@@ -71,6 +98,39 @@ async function persist(): Promise<void> {
 	}
 }
 
+function availabilityOf(name: ProviderName): ProviderAvailability {
+	return settings.value.providers?.[name] ?? { available: false }
+}
+
+function providerLabel(option: (typeof PROVIDER_OPTIONS)[number]): string {
+	return availabilityOf(option.value).available
+		? option.label
+		: `${option.label} — unavailable`
+}
+
+const activeProvider = computed(() => settings.value.provider)
+
+const providerReason = computed(
+	() => availabilityOf(settings.value.provider).reason ?? null,
+)
+
+const activeModel = computed(
+	() =>
+		PROVIDER_OPTIONS.find((o) => o.value === settings.value.provider)?.model ??
+		'',
+)
+
+function onProvider(event: Event): void {
+	const next = (event.target as HTMLSelectElement).value as ProviderName
+	if (!availabilityOf(next).available) {
+		// The option is disabled, so this only fires on a stale DOM; snap back.
+		;(event.target as HTMLSelectElement).value = settings.value.provider
+		return
+	}
+	settings.value.provider = next
+	void persist()
+}
+
 function onMode(event: Event): void {
 	settings.value.mode = (event.target as HTMLSelectElement).value as Mode
 	void persist()
@@ -123,14 +183,33 @@ const SELECT_CLASS =
 				<div class="flex flex-col gap-4 p-5">
 					<div>
 						<label class="mb-1.5 block text-xs font-medium text-toned">Provider</label>
-						<select :class="SELECT_CLASS" disabled>
-							<option>Anthropic (Claude)</option>
+						<select
+							:class="SELECT_CLASS"
+							:value="activeProvider"
+							:disabled="loading || saving"
+							@change="onProvider"
+						>
+							<option
+								v-for="option in PROVIDER_OPTIONS"
+								:key="option.value"
+								:value="option.value"
+								:disabled="!availabilityOf(option.value).available"
+							>
+								{{ providerLabel(option) }}
+							</option>
 						</select>
+						<p v-if="providerReason" class="mt-1.5 text-xs text-error">
+							{{ providerReason }}
+						</p>
+						<p class="mt-1.5 text-xs text-dimmed">
+							Switching provider ends the live context of open conversations;
+							their transcripts are kept.
+						</p>
 					</div>
 					<div>
 						<label class="mb-1.5 block text-xs font-medium text-toned">Model</label>
 						<select :class="SELECT_CLASS" disabled>
-							<option>Claude Opus 4.x</option>
+							<option>{{ activeModel }}</option>
 						</select>
 					</div>
 				</div>
@@ -181,6 +260,9 @@ const SELECT_CLASS =
 								{{ option.label }}
 							</option>
 						</select>
+						<p class="mt-1.5 text-xs text-dimmed">
+							{{ THINKING_HINTS[settings.provider] }}
+						</p>
 					</div>
 					<div>
 						<label class="flex items-start gap-3">

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@antelopejs/dms-ai",
-  "version": "0.0.6",
+  "version": "0.1.0",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -53,6 +53,7 @@
     "@antelopejs/interface-dms": ">=0.0.1 <1.0.0",
     "@anthropic-ai/claude-agent-sdk": "^0.2.131",
     "@anthropic-ai/claude-code": "^2.1.131",
+    "@modelcontextprotocol/sdk": "1.29.0",
     "ws": "^8.18.0",
     "zod": "^4.0.0"
   },
@@ -68,6 +69,14 @@
     "rimraf": "^6.1.3",
     "typescript": "^5.9.3"
   },
+  "peerDependencies": {
+    "@openai/codex": "0.154.0"
+  },
+  "peerDependenciesMeta": {
+    "@openai/codex": {
+      "optional": true
+    }
+  },
   "optionalDependencies": {
     "@antelopejs/interface-dms-builder": ">=0.0.1 <1.0.0"
   },