@minniexcode/codex-switch 0.0.10 → 0.0.12

package/README.md

@@ -1,136 +1,149 @@
-## @minniexcode/codex-switch
+# @minniexcode/codex-switch
 
-`codex-switch` is a local-first CLI for managing and switching Codex provider/profile configuration safely.
+`@minniexcode/codex-switch` is a local-first CLI for managing and switching Codex provider and profile configuration safely.
 
-It is designed for users who work with multiple Codex providers, API keys, or profiles and want a repeatable, backup-first workflow instead of manually editing files under `~/.codex/`.
+It keeps `codex-switch` tool state separate from the target Codex runtime, so provider management, backup flow, and runtime projection stay explicit instead of relying on manual file edits.
 
-中文版: [README.CN.md](./README.CN.md)
+Chinese version: [README.CN.md](./README.CN.md)
 
-## Overview
+## Version
 
-What it does:
+Current package version: `0.0.12`
 
-- Initialize an empty managed `providers.json`
-- Migrate unmanaged runtime profiles from an existing Codex directory
-- List, show, add, edit, and remove provider records
-- Switch the active provider/profile safely
-- Import and export provider definitions
-- Run diagnostics and detect local drift
-- List backups and roll back to a previous managed state
-
-Current version: `0.0.10`
+This repository is still on a development-version line. The current release focuses on making the primary workflows, help text, and operational boundaries consistent with the implementation.
 
 ## Install
 
-Install globally:
-
 ```bash
 npm install -g @minniexcode/codex-switch
 ```
 
-Or run directly:
+Run without a global install:
 
 ```bash
 npx @minniexcode/codex-switch --help
 ```
 
-CLI entry:
+Built CLI entrypoint:
 
 ```bash
 codexs --help
 ```
 
-## Quick Start
+## Primary Workflows
 
-Take over an existing Codex directory:
+Direct provider workflow:
 
 ```bash
 codexs init
-codexs migrate
+codexs add my-provider --profile my-provider --api-key sk-xxx
+codexs switch my-provider
+codexs status
+codexs doctor
 ```
 
-Inspect managed providers:
+GitHub Copilot workflow:
 
 ```bash
-codexs list
-codexs show my-provider
+codexs init
+codexs login copilot
+codexs add copilot-main --copilot --profile copilot-main
+codexs switch copilot-main
+codexs status
+codexs doctor
 ```
 
-Add and switch:
+Notes:
 
-```bash
-codexs add my-provider --profile my-provider --api-key sk-xxx
-codexs switch my-provider
-```
+- `init` prepares the `codex-switch` tool home and managed state.
+- `login copilot` handles upstream Copilot onboarding and auth readiness.
+- `add --copilot` does not perform login for you; it assumes Copilot login is already ready.
+- `status` is the main read command after switching.
+- `doctor` is the main repair-oriented diagnostic command.
+
+## Advanced Adopt Workflow
 
-Check runtime state:
+Use `migrate` only when you already have Codex runtime state that should be adopted into managed `providers.json` state:
 
 ```bash
-codexs current
-codexs status
-codexs doctor
+codexs init
+codexs migrate
 ```
 
-## Common Commands
+`migrate` is an advanced adopt helper. It is not the default first step for a fresh install.
+
+## Command Surface
 
 ```bash
 codexs init
+codexs login copilot
 codexs migrate
 codexs list
 codexs show <provider>
 codexs current
 codexs status
+codexs config show [profile]
+codexs config list-profiles
 codexs add <provider> --profile <name> --api-key <key>
-codexs edit <provider> [--profile <name>] [--api-key <key>]
+codexs add <provider> --copilot --profile <name>
+codexs edit <provider>
 codexs switch <provider>
-codexs remove <provider>
-codexs import <file> [--merge]
-codexs export <file>
+codexs remove <provider> [--force] [--switch-to <profile>]
+codexs import <file>
+codexs export <file> [--force]
+codexs bridge start [provider]
+codexs bridge status [provider]
+codexs bridge stop [provider]
 codexs backups list
 codexs rollback [backup-id]
 codexs doctor
 ```
 
-Command help:
+`setup` still exists only as a deprecated compatibility entry that points callers to `init` or `migrate`.
 
-```bash
-codexs help switch
-codexs help init
-codexs help migrate
-codexs help setup
-```
+## Runtime Model
+
+`codex-switch` uses a dual-path model.
 
-## How It Works
+Tool home:
 
-By default, `codex-switch` operates on `~/.codex/`, and you can override the target with `--codex-dir`.
+```text
+~/.config/codex-switch/
+  codex-switch.json
+  providers.json
+  backups/
+  runtime/
+  runtimes/
+```
 
-Managed files:
+Target Codex runtime:
 
 ```text
 ~/.codex/
   config.toml
   auth.json
-  providers.json
-  backups/
 ```
 
-Notes:
+Key points:
 
-- `providers.json` is the managed provider registry
-- `config.toml` is the managed runtime-routing file
-- `auth.json` is the active auth projection file; direct-provider switches rewrite `OPENAI_API_KEY`, while `status` and `doctor` inspect its state
-- mutating commands back up before writing
-- rollback is available after failed or undesired changes
+- `providers.json` is the managed provider registry and lives under the tool home.
+- `codex-switch.json` stores tool-level metadata such as `defaultCodexDir`.
+- `config.toml` remains the active runtime routing file in the target Codex directory.
+- `auth.json` remains the active auth projection file in the target Codex directory.
+- Direct providers rewrite `OPENAI_API_KEY` into the active runtime projection.
+- Copilot providers keep upstream GitHub authentication in the official Copilot runtime while `codex-switch` manages local bridge state and routing.
 
-## Automation
+Path controls:
 
-This CLI supports both human TTY use and non-interactive automation.
+- `--codex-dir <path>` targets a specific Codex runtime directory.
+- `CODEXS_CODEX_DIR` provides the default target runtime when `--codex-dir` is not passed.
+- `CODEXS_HOME` overrides the tool home location.
 
-Current exceptions:
-- `init` is automation-friendly and idempotent, but still returns a structured error in non-interactive or `--json` mode when the resolved target directory does not exist.
-- `migrate` remains intentionally TTY-only for adopt initialization. It requires interactive profile selection and provider detail collection, and non-interactive/`--json` runs fail fast with a structured error.
+## Automation Notes
 
-Recommended global flags:
+This CLI supports both human TTY usage and non-interactive automation.
+
+Global flags:
 
 ```bash
 --json
@@ -139,37 +152,31 @@ Recommended global flags:
 --version
 ```
 
-Recommendations:
-
-- use `--json` for stable machine-readable output
-- pass all required arguments explicitly in scripts or CI
-- use `--codex-dir <path>` for sandbox or test environments
+Operational limits:
 
-## Testing
+- `login copilot` requires a real TTY and does not support `--json`.
+- `migrate` still depends on interactive profile selection and provider-detail collection in this release.
+- Automation should pass explicit arguments and prefer `--json` for stable parsing.
 
-Build and test locally:
+## Local Development
 
 ```bash
 npm run build
 npm test
+npx tsc --noEmit
+node dist/cli.js --help
+npm pack --dry-run
 ```
 
-The repository includes a development fixture under `dev-codex/local-sandbox` plus dedicated test docs:
-
-- [Testing Guide](./docs/testing.md)
-- [Test Report for 0.0.5](./docs/test-report-0.0.5.md)
-
 ## Documentation
 
 - [Chinese README](./README.CN.md)
 - [AI README](./README.AI.md)
 - [Detailed CLI Usage](./docs/cli-usage.md)
-- [Testing Guide](./docs/testing.md)
-- [Test Report for 0.0.5](./docs/test-report-0.0.5.md)
+- [Testing Guide](./docs/Tests/testing.md)
 - [Product Overview](./docs/codex-switch-product-overview.md)
-- [Technical Architecture](./docs/codex-switch-technical-architecture.md)
-- [Design Doc 0.0.5](./docs/Design/codex-switch-v0.0.5-design.md)
-- [Design Doc 0.0.4](./docs/Design/codex-switch-v0.0.4-design.md)
+- [PRD 0.0.12](./docs/PRD/codex-switch-prd-v0.0.12.md)
+- [Release Gate PRD 0.1.0](./docs/PRD/codex-switch-prd-v0.1.0.md)
 
 ## License
 

package/dist/app/add-provider.js

@@ -41,12 +41,13 @@ const errors_1 = require("../domain/errors");
 const config_repo_1 = require("../storage/config-repo");
 const fs_utils_1 = require("../storage/fs-utils");
 const providers_repo_1 = require("../storage/providers-repo");
+const copilot_adapter_1 = require("../runtime/copilot-adapter");
 const copilot_installer_1 = require("../runtime/copilot-installer");
 const run_mutation_1 = require("./run-mutation");
 /**
  * Adds a new provider record to the managed providers registry.
  */
-function addProvider(args) {
+async function addProvider(args) {
     (0, fs_utils_1.ensureDir)(args.codexDir);
     const providers = (0, providers_repo_1.readProvidersFileIfExists)(args.providersPath);
     if (providers.providers[args.providerName]) {
@@ -67,17 +68,26 @@ function addProvider(args) {
         }
         : undefined;
     if (args.copilot) {
-        const installStatus = (0, copilot_installer_1.probeCopilotSdkInstall)();
+        const installStatus = (0, copilot_installer_1.probeCopilotSdkInstall)(args.runtimesDir);
         if (!installStatus.installed) {
-            if (!args.installCopilotSdk) {
-                throw (0, errors_1.cliError)(args.interactive ? "COPILOT_SDK_MISSING" : "COPILOT_SDK_INSTALL_REQUIRES_TTY", args.interactive
-                    ? "The optional Copilot SDK runtime is not installed. Re-run with --install-copilot-sdk or confirm installation interactively."
-                    : "The optional Copilot SDK runtime is not installed. Pass --install-copilot-sdk when running non-interactively.", {
-                    installDir: installStatus.installDir,
-                    packageName: installStatus.packageName,
+            throw (0, errors_1.cliError)("COPILOT_SDK_MISSING", "The optional Copilot SDK runtime is not installed. Run `codexs login copilot` first.", {
+                installDir: installStatus.installDir,
+                packageName: installStatus.packageName,
+                suggestion: "Run `codexs login copilot` to install the Copilot SDK and complete login.",
+            });
+        }
+        try {
+            await (0, copilot_adapter_1.readCopilotAuthState)(args.runtimesDir);
+        }
+        catch (error) {
+            const normalized = (0, errors_1.normalizeError)(error);
+            if (normalized.code === "COPILOT_AUTH_REQUIRED") {
+                throw (0, errors_1.cliError)("COPILOT_AUTH_REQUIRED", "Copilot authentication is required before a Copilot provider can be added.", {
+                    ...(normalized.details ?? {}),
+                    suggestion: "Run `codexs login copilot` to complete GitHub Copilot login.",
                 });
             }
-            (0, copilot_installer_1.installCopilotSdk)();
+            throw error;
         }
     }
     const document = (0, config_repo_1.readStructuredConfig)(args.configPath);
@@ -97,13 +107,17 @@ function addProvider(args) {
             }),
         }
         : undefined;
-    const upsertModelProviders = !existingModelProvider && args.createProfile
+    const upsertModelProviders = args.copilot
         ? {
-            [args.profile]: {
-                baseUrl: args.copilot ? (0, providers_1.buildCopilotBridgeBaseUrl)(runtime) : args.baseUrl ?? undefined,
-            },
+            [args.profile]: (0, providers_1.buildCopilotModelProviderProjection)(runtime),
         }
-        : undefined;
+        : !existingModelProvider && args.createProfile
+            ? {
+                [args.profile]: {
+                    baseUrl: args.baseUrl ?? undefined,
+                },
+            }
+            : undefined;
     if (existingProfile) {
         (0, config_repo_1.requireManagedProfileRuntime)(document, providers, args.profile);
     }
@@ -123,7 +137,7 @@ function addProvider(args) {
         },
     };
     return (0, run_mutation_1.runMutation)({
-        codexDir: args.codexDir,
+        lockPath: args.lockPath,
         backupsDir: args.backupsDir,
         latestBackupPath: args.latestBackupPath,
         operation: "add",

package/dist/app/bridge.js

@@ -22,13 +22,14 @@ async function startBridge(args) {
         requestedProviderName: args.providerName ?? null,
         providers,
         configPath: args.configPath,
+        runtimeDir: args.runtimeDir,
         runtime: args.runtime,
         json: args.json,
         commandName: "start",
         preferRuntimeState: false,
     });
-    await requireBridgeRuntimeReadiness();
-    const bridge = await (0, copilot_bridge_1.ensureCopilotBridge)(target.providerName, target.provider);
+    await requireBridgeRuntimeReadiness(args.runtimesDir);
+    const bridge = await (0, copilot_bridge_1.ensureCopilotBridge)(target.providerName, target.provider, args.runtimeDir);
     const nextProvider = bridge.portChanged ? rewriteBridgeProviderPort(target.provider, bridge.port) : target.provider;
     if (bridge.portChanged) {
         try {
@@ -43,7 +44,7 @@ async function startBridge(args) {
         }
         catch (error) {
             if (!bridge.reused) {
-                (0, copilot_bridge_1.stopCopilotBridge)();
+                (0, copilot_bridge_1.stopCopilotBridge)(args.runtimeDir);
             }
             throw error;
         }
@@ -66,7 +67,7 @@ async function startBridge(args) {
  */
 async function stopBridge(args) {
     const providers = (0, providers_repo_1.readProvidersFile)(args.providersPath);
-    const state = (0, runtime_state_repo_1.readCopilotBridgeState)();
+    const state = (0, runtime_state_repo_1.readCopilotBridgeState)(args.runtimeDir);
     if (!state && !args.providerName) {
         return {
             data: {
@@ -90,6 +91,7 @@ async function stopBridge(args) {
         requestedProviderName: args.providerName ?? null,
         providers,
         configPath: args.configPath,
+        runtimeDir: args.runtimeDir,
         runtime: args.runtime,
         json: args.json,
         commandName: "stop",
@@ -101,7 +103,7 @@ async function stopBridge(args) {
             requestedProvider: args.providerName,
         });
     }
-    (0, copilot_bridge_1.stopCopilotBridge)();
+    (0, copilot_bridge_1.stopCopilotBridge)(args.runtimeDir);
     return {
         data: {
             provider: target.providerName,
@@ -115,18 +117,19 @@ async function stopBridge(args) {
  */
 async function statusBridge(args) {
     const providers = (0, providers_repo_1.readProvidersFile)(args.providersPath);
-    const state = (0, runtime_state_repo_1.readCopilotBridgeState)();
+    const state = (0, runtime_state_repo_1.readCopilotBridgeState)(args.runtimeDir);
     const target = await resolveBridgeTarget({
         requestedProviderName: args.providerName ?? null,
         providers,
         configPath: args.configPath,
+        runtimeDir: args.runtimeDir,
         runtime: args.runtime,
         json: args.json,
         commandName: "status",
         preferRuntimeState: true,
     });
     const provider = target.provider;
-    const runtimeStatus = await (0, copilot_bridge_1.probeCopilotBridgeRuntime)(provider);
+    const runtimeStatus = await (0, copilot_bridge_1.probeCopilotBridgeRuntime)(provider, state, args.runtimeDir);
     const expectedBaseUrl = (0, providers_1.buildCopilotBridgeBaseUrl)(provider.runtime);
     if (args.providerName && state?.provider && state.provider !== args.providerName) {
         throw (0, errors_1.cliError)("BRIDGE_PROVIDER_MISMATCH", `Bridge runtime state belongs to "${state.provider}" not "${args.providerName}".`, {
@@ -154,7 +157,7 @@ async function resolveBridgeTarget(args) {
         return resolveNamedBridgeProvider(args.providers, args.requestedProviderName);
     }
     if (args.preferRuntimeState) {
-        const runtimeState = (0, runtime_state_repo_1.readCopilotBridgeState)();
+        const runtimeState = (0, runtime_state_repo_1.readCopilotBridgeState)(args.runtimeDir);
         if (runtimeState?.provider && args.providers.providers[runtimeState.provider]) {
             return resolveNamedBridgeProvider(args.providers, runtimeState.provider);
         }
@@ -238,15 +241,15 @@ async function promptForCopilotBridgeSelection(runtime, targets, commandName) {
 /**
  * Verifies that the local Copilot bridge prerequisites are available before startup.
  */
-async function requireBridgeRuntimeReadiness() {
-    const installStatus = (0, copilot_installer_1.probeCopilotSdkInstall)();
+async function requireBridgeRuntimeReadiness(runtimesDir) {
+    const installStatus = (0, copilot_installer_1.probeCopilotSdkInstall)(runtimesDir);
     if (!installStatus.installed) {
         throw (0, errors_1.cliError)("COPILOT_SDK_MISSING", "The optional Copilot SDK runtime is not installed.", {
             installDir: installStatus.installDir,
             packageName: installStatus.packageName,
         });
     }
-    await (0, copilot_adapter_1.readCopilotAuthState)();
+    await (0, copilot_adapter_1.readCopilotAuthState)(runtimesDir);
 }
 /**
  * Rewrites one Copilot bridge provider record with a recovered runtime port.
@@ -281,9 +284,7 @@ function persistRecoveredBridgePort(args) {
         const document = (0, config_repo_1.readStructuredConfig)(args.configPath);
         const configPlan = (0, config_repo_1.createConfigMutationPlan)(document, {
             upsertModelProviders: {
-                [args.provider.profile]: {
-                    baseUrl: (0, providers_1.buildCopilotBridgeBaseUrl)(args.provider.runtime),
-                },
+                [args.provider.profile]: (0, providers_1.buildCopilotModelProviderProjection)(args.provider.runtime),
             },
         });
         (0, config_repo_1.applyConfigMutation)(args.configPath, document, configPlan);

package/dist/app/edit-provider.js

@@ -109,7 +109,7 @@ function editProvider(args) {
         switchToProfile: args.switchToProfile ?? null,
     });
     return (0, run_mutation_1.runMutation)({
-        codexDir: args.codexDir,
+        lockPath: args.lockPath,
         backupsDir: args.backupsDir,
         latestBackupPath: args.latestBackupPath,
         operation: "edit",

package/dist/app/get-status.js

@@ -48,7 +48,7 @@ const runtime_state_repo_1 = require("../storage/runtime-state-repo");
 /**
  * Reports the current on-disk runtime state and how it maps back to managed providers.
  */
-async function getStatus(codexDir, configPath, providersPath, authPath) {
+async function getStatus(codexDir, configPath, providersPath, authPath, options) {
     const configExists = fs.existsSync(configPath);
     const providersExists = fs.existsSync(providersPath);
     let currentProfile = null;
@@ -67,10 +67,12 @@ async function getStatus(codexDir, configPath, providersPath, authPath) {
         }
     }
     const liveState = (0, runtime_state_1.inspectLiveStateDrift)(currentProfile, providers);
-    const activeProviderCandidates = currentProfile && providers ? (0, providers_1.findProvidersByProfile)(providers, currentProfile) : [];
-    const activeProvider = activeProviderCandidates.length === 1 && providers ? providers.providers[activeProviderCandidates[0]] : null;
-    const copilotInstall = (0, copilot_installer_1.probeCopilotSdkInstall)();
-    const runtimeStateInspection = (0, runtime_state_repo_1.inspectCopilotBridgeState)();
+    const activeProviderCandidates = liveState.mappedProviders;
+    const activeProvider = liveState.providerResolvable && providers && liveState.mappedProvider
+        ? providers.providers[liveState.mappedProvider]
+        : null;
+    const copilotInstall = (0, copilot_installer_1.probeCopilotSdkInstall)(options?.runtimesDir);
+    const runtimeStateInspection = (0, runtime_state_repo_1.inspectCopilotBridgeState)(options?.runtimeDir);
     const runtimeState = runtimeStateInspection.state;
     const runtimeStateProvider = runtimeState && providers ? providers.providers[runtimeState.provider] ?? null : null;
     const bridgeProbeTarget = activeProvider && (0, providers_1.isCopilotBridgeProvider)(activeProvider)
@@ -86,7 +88,7 @@ async function getStatus(codexDir, configPath, providersPath, authPath) {
             cause: runtimeStateInspection.parseError ?? "Failed to parse Copilot bridge runtime state.",
         }
         : bridgeProbeTarget
-            ? await (0, copilot_bridge_1.probeCopilotBridgeRuntime)(bridgeProbeTarget, runtimeState)
+            ? await (0, copilot_bridge_1.probeCopilotBridgeRuntime)(bridgeProbeTarget, runtimeState, options?.runtimeDir)
             : runtimeState
                 ? {
                     ok: false,
@@ -97,7 +99,7 @@ async function getStatus(codexDir, configPath, providersPath, authPath) {
                 }
                 : null;
     const copilotAuth = activeProvider && (0, providers_1.isCopilotBridgeProvider)(activeProvider)
-        ? await (0, copilot_adapter_1.readCopilotAuthState)().catch((error) => ({
+        ? await (0, copilot_adapter_1.readCopilotAuthState)(options?.runtimesDir).catch((error) => ({
             ready: false,
             source: "official-sdk",
             mode: "session",
@@ -108,6 +110,9 @@ async function getStatus(codexDir, configPath, providersPath, authPath) {
         // Surface unmanaged live state without mutating anything during a read-only status call.
         warnings.push("Current config profile is not mapped in providers.json. Backfill would be required before treating live state as managed.");
     }
+    if (liveState.reason === "shared-profile") {
+        warnings.push(`Current config profile "${currentProfile}" is shared by multiple providers in providers.json, so the active provider cannot be resolved uniquely.`);
+    }
     if (runtimeStateInspection.exists && !runtimeStateInspection.valid) {
         warnings.push(`Copilot bridge runtime state is unreadable: ${runtimeStateInspection.parseError ?? "unknown parse failure"}`);
     }
@@ -115,13 +120,20 @@ async function getStatus(codexDir, configPath, providersPath, authPath) {
         warnings,
         data: {
             codexDir,
-            storage: (0, runtime_state_1.getStorageRoles)(),
+            storage: (0, runtime_state_1.getStorageRoles)({
+                codexDir,
+                providersPath,
+                configPath,
+                authPath,
+                runtimeDir: options?.runtimeDir,
+                runtimesDir: options?.runtimesDir,
+            }),
             configExists,
             providersExists,
             currentProfile,
             currentProfileMapped: liveState.profileMapped,
             provider: liveState.mappedProvider,
-            activeProviderResolvable: activeProviderCandidates.length === 1,
+            activeProviderResolvable: liveState.providerResolvable,
             activeProviderCandidates,
             runtimeProvider: activeProvider && (0, providers_1.isCopilotBridgeProvider)(activeProvider) ? activeProvider.runtime?.kind ?? null : null,
             copilotSdk: {

package/dist/app/import-providers.js

@@ -62,7 +62,7 @@ function importProviders(args) {
     (0, fs_utils_1.ensureDir)(args.codexDir);
     const document = (0, config_repo_1.readStructuredConfig)(args.configPath);
     return (0, run_mutation_1.runMutation)({
-        codexDir: args.codexDir,
+        lockPath: args.lockPath,
         backupsDir: args.backupsDir,
         latestBackupPath: args.latestBackupPath,
         operation: "import",

package/dist/app/init-codex.js

@@ -35,34 +35,33 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.initCodex = initCodex;
 const fs = __importStar(require("node:fs"));
-const errors_1 = require("../domain/errors");
 const fs_utils_1 = require("../storage/fs-utils");
 const providers_repo_1 = require("../storage/providers-repo");
+const tool_config_repo_1 = require("../storage/tool-config-repo");
 /**
- * Initializes a Codex directory for managed providers.json usage without requiring live Codex state.
+ * Initializes the codex-switch tool home without requiring target Codex runtime files.
  */
 function initCodex(args) {
-    const codexDirExists = fs.existsSync(args.codexDir);
-    if (!codexDirExists && !args.createCodexDir) {
-        throw (0, errors_1.cliError)("CODEX_DIR_NOT_FOUND", "The requested Codex directory does not exist.", {
-            codexDir: args.codexDir,
-        });
-    }
-    if (!codexDirExists) {
-        (0, fs_utils_1.ensureDir)(args.codexDir);
+    const toolHomeExists = fs.existsSync(args.toolHomeDir);
+    if (!toolHomeExists) {
+        (0, fs_utils_1.ensureDir)(args.toolHomeDir);
     }
+    const toolConfigExists = fs.existsSync(args.toolConfigPath);
+    const ensuredConfig = (0, tool_config_repo_1.ensureToolConfig)(args.toolConfigPath, args.version, args.defaultCodexDir ?? "");
     const providersExists = fs.existsSync(args.providersPath);
     if (!providersExists) {
         (0, providers_repo_1.writeProvidersFile)(args.providersPath, { providers: {} });
     }
     return {
         data: {
-            codexDir: args.codexDir,
-            createdCodexDir: !codexDirExists,
+            toolHomeDir: args.toolHomeDir,
+            toolConfigPath: args.toolConfigPath,
+            providersPath: args.providersPath,
+            createdToolHomeDir: !toolHomeExists,
+            createdToolConfigFile: ensuredConfig.created && !toolConfigExists,
             createdProvidersFile: !providersExists,
+            toolConfigAlreadyExisted: toolConfigExists,
             providersAlreadyExisted: providersExists,
-            configExists: fs.existsSync(args.configPath),
-            authExists: fs.existsSync(args.authPath),
         },
     };
 }