@minniexcode/codex-switch 0.0.7 → 0.0.8

package/README.md

@@ -18,7 +18,7 @@ What it does:
 - Run diagnostics and detect local drift
 - List backups and roll back to a previous managed state
 
-Current version: `0.0.7`
+Current version: `0.0.8`
 
 ## Install
 

package/dist/app/add-provider.js

@@ -1,6 +1,40 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.addProvider = addProvider;
+const crypto = __importStar(require("node:crypto"));
 const config_1 = require("../domain/config");
 const providers_1 = require("../domain/providers");
 const errors_1 = require("../domain/errors");
@@ -8,6 +42,7 @@ 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 auth_repo_1 = require("../storage/auth-repo");
+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.
@@ -18,6 +53,34 @@ function addProvider(args) {
     if (providers.providers[args.providerName]) {
         throw (0, errors_1.cliError)("INVALID_IMPORT_FILE", `Provider "${args.providerName}" already exists.`);
     }
+    const bridgeHost = args.bridgeHost ?? "127.0.0.1";
+    const bridgePort = args.bridgePort ?? 4141;
+    const runtime = args.copilot
+        ? {
+            kind: "copilot-sdk-bridge",
+            upstream: "github-copilot",
+            bridgeHost,
+            bridgePort,
+            bridgePath: "/v1",
+            premiumRequests: true,
+            authSource: "official-sdk",
+            sdkInstallMode: "lazy",
+        }
+        : undefined;
+    if (args.copilot) {
+        const installStatus = (0, copilot_installer_1.probeCopilotSdkInstall)();
+        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,
+                });
+            }
+            (0, copilot_installer_1.installCopilotSdk)();
+        }
+    }
     const document = (0, config_repo_1.readStructuredConfig)(args.configPath);
     const existingProfile = document.profiles.find((profile) => profile.name === args.profile);
     const existingModelProvider = document.modelProviders.find((entry) => entry.name === args.profile);
@@ -38,7 +101,7 @@ function addProvider(args) {
     const upsertModelProviders = !existingModelProvider && args.createProfile
         ? {
             [args.profile]: {
-                baseUrl: args.baseUrl ?? undefined,
+                baseUrl: args.copilot ? (0, providers_1.buildCopilotBridgeBaseUrl)(runtime) : args.baseUrl ?? undefined,
                 envKey: (0, config_1.buildManagedProfileEnvKey)(args.profile),
             },
         }
@@ -47,16 +110,19 @@ function addProvider(args) {
         (0, config_repo_1.requireManagedProfileRuntime)(document, providers, args.profile);
     }
     const envKey = existingModelProvider?.envKey ?? (0, config_1.buildManagedProfileEnvKey)(args.profile);
+    const apiKey = args.copilot ? args.bridgeApiKey ?? crypto.randomBytes(24).toString("hex") : args.apiKey;
+    const baseUrl = args.copilot ? (0, providers_1.buildCopilotBridgeBaseUrl)(runtime) : args.baseUrl ?? undefined;
     const next = {
         providers: {
             ...providers.providers,
             [args.providerName]: (0, providers_1.cleanProviderRecord)({
                 profile: args.profile,
-                apiKey: args.apiKey,
+                apiKey,
                 envKey,
-                baseUrl: args.baseUrl ?? undefined,
+                baseUrl,
                 note: args.note ?? undefined,
                 tags: args.tags,
+                runtime,
             }),
         },
     };
@@ -87,6 +153,7 @@ function addProvider(args) {
                 provider: args.providerName,
                 profile: args.profile,
                 envKey,
+                runtimeKind: runtime?.kind ?? null,
                 createdProfileSections: configPlan.createdProfileSections,
                 createdModelProviderSections: configPlan.createdModelProviderSections,
                 deletedProfileSections: configPlan.deletedProfileSections,

package/dist/app/get-status.js

@@ -41,10 +41,13 @@ const providers_1 = require("../domain/providers");
 const config_repo_1 = require("../storage/config-repo");
 const providers_repo_1 = require("../storage/providers-repo");
 const auth_repo_1 = require("../storage/auth-repo");
+const copilot_installer_1 = require("../runtime/copilot-installer");
+const copilot_bridge_1 = require("../runtime/copilot-bridge");
+const copilot_adapter_1 = require("../runtime/copilot-adapter");
 /**
  * Reports the current on-disk runtime state and how it maps back to managed providers.
  */
-function getStatus(codexDir, configPath, providersPath, authPath) {
+async function getStatus(codexDir, configPath, providersPath, authPath) {
     const configExists = fs.existsSync(configPath);
     const providersExists = fs.existsSync(providersPath);
     let currentProfile = null;
@@ -64,6 +67,17 @@ 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 copilotBridge = activeProvider && (0, providers_1.isCopilotBridgeProvider)(activeProvider) ? await (0, copilot_bridge_1.probeCopilotBridgeRuntime)(activeProvider) : null;
+    const copilotAuth = activeProvider && (0, providers_1.isCopilotBridgeProvider)(activeProvider)
+        ? await (0, copilot_adapter_1.readCopilotAuthState)().catch((error) => ({
+            ready: false,
+            source: "official-sdk",
+            mode: "session",
+            error: error instanceof Error ? error.message : String(error),
+        }))
+        : null;
     if (liveState.canBackfillActiveProvider) {
         // 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.");
@@ -80,6 +94,15 @@ function getStatus(codexDir, configPath, providersPath, authPath) {
             provider: liveState.mappedProvider,
             activeProviderResolvable: activeProviderCandidates.length === 1,
             activeProviderCandidates,
+            runtimeProvider: activeProvider && (0, providers_1.isCopilotBridgeProvider)(activeProvider) ? activeProvider.runtime?.kind ?? null : null,
+            copilotSdk: {
+                installed: copilotInstall.installed,
+                installDir: copilotInstall.installDir,
+                packageName: copilotInstall.packageName,
+                packageVersion: copilotInstall.packageVersion ?? null,
+            },
+            copilotAuth,
+            copilotBridge,
             liveState,
             auth: authState,
             configProfiles: configViews,

package/dist/app/run-doctor.js

@@ -43,10 +43,13 @@ const errors_1 = require("../domain/errors");
 const codex_probe_1 = require("../runtime/codex-probe");
 const auth_repo_1 = require("../storage/auth-repo");
 const providers_1 = require("../domain/providers");
+const copilot_installer_1 = require("../runtime/copilot-installer");
+const copilot_bridge_1 = require("../runtime/copilot-bridge");
+const copilot_adapter_1 = require("../runtime/copilot-adapter");
 /**
  * Performs consistency checks across config.toml, providers.json, and the local Codex CLI.
  */
-function runDoctor(args) {
+async function runDoctor(args) {
     const issues = [];
     let currentProfile = null;
     let providers = null;
@@ -134,6 +137,38 @@ function runDoctor(args) {
                     provider: matches[0],
                 });
             }
+            if ((0, providers_1.isCopilotBridgeProvider)(activeProvider)) {
+                const installStatus = (0, copilot_installer_1.probeCopilotSdkInstall)();
+                if (!installStatus.installed) {
+                    issues.push({
+                        code: "COPILOT_SDK_MISSING",
+                        message: "The optional Copilot SDK runtime is not installed.",
+                        installDir: installStatus.installDir,
+                        packageName: installStatus.packageName,
+                    });
+                }
+                try {
+                    await (0, copilot_adapter_1.readCopilotAuthState)();
+                }
+                catch (error) {
+                    const normalized = (0, errors_1.normalizeError)(error);
+                    issues.push({
+                        code: normalized.code,
+                        message: normalized.message,
+                        ...(normalized.details ?? {}),
+                    });
+                }
+                const bridge = await (0, copilot_bridge_1.probeCopilotBridgeRuntime)(activeProvider);
+                if (!bridge.ok) {
+                    issues.push({
+                        code: bridge.cause === "Copilot bridge state base URL does not match the provider runtime configuration."
+                            ? "PROVIDER_BASE_URL_MISMATCH"
+                            : "BRIDGE_HEALTHCHECK_FAILED",
+                        message: bridge.cause,
+                        ...(bridge.details ?? {}),
+                    });
+                }
+            }
         }
     }
     // Drift inspection still runs when files are missing so status output can explain partial state.

package/dist/app/setup-codex.js

@@ -49,7 +49,7 @@ const MIN_CODEX_VERSION = "0.0.1";
 /**
  * Migrates unmanaged Codex config profiles into a managed providers.json registry.
  */
-function migrateCodex(args) {
+async function migrateCodex(args) {
     const available = (0, codex_cli_1.checkCodexAvailable)();
     if (!available.ok) {
         throw (0, errors_1.cliError)("CODEX_NOT_INSTALLED", "codex CLI is not available.", {
@@ -148,7 +148,7 @@ function migrateCodex(args) {
         },
     });
     // Re-run doctor on the final state so migrate returns immediate post-migration diagnostics.
-    const doctor = (0, run_doctor_1.runDoctor)({
+    const doctor = await (0, run_doctor_1.runDoctor)({
         codexDir: args.codexDir,
         configPath: args.configPath,
         providersPath: args.providersPath,

package/dist/app/switch-provider.js

@@ -2,14 +2,18 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.switchProvider = switchProvider;
 const errors_1 = require("../domain/errors");
+const providers_1 = require("../domain/providers");
 const config_repo_1 = require("../storage/config-repo");
 const providers_repo_1 = require("../storage/providers-repo");
 const auth_repo_1 = require("../storage/auth-repo");
+const copilot_bridge_1 = require("../runtime/copilot-bridge");
+const copilot_installer_1 = require("../runtime/copilot-installer");
+const copilot_adapter_1 = require("../runtime/copilot-adapter");
 const run_mutation_1 = require("./run-mutation");
 /**
  * Switches the active Codex profile and rewrites auth.json for the target provider.
  */
-function switchProvider(args) {
+async function switchProvider(args) {
     const providers = (0, providers_repo_1.readProvidersFile)(args.providersPath);
     const provider = providers.providers[args.providerName];
     if (!provider) {
@@ -27,6 +31,48 @@ function switchProvider(args) {
             runtimeEnvKey: envKey,
         });
     }
+    if ((0, providers_1.isCopilotBridgeProvider)(provider)) {
+        const installStatus = (0, copilot_installer_1.probeCopilotSdkInstall)();
+        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)();
+        const bridge = await (0, copilot_bridge_1.ensureCopilotBridge)(args.providerName, provider);
+        try {
+            return (0, run_mutation_1.runMutation)({
+                codexDir: args.codexDir,
+                backupsDir: args.backupsDir,
+                latestBackupPath: args.latestBackupPath,
+                operation: "switch",
+                files: [
+                    { absolutePath: args.configPath, relativePath: "config.toml" },
+                    { absolutePath: args.authPath, relativePath: "auth.json" },
+                ],
+                mutate: () => {
+                    const configPlan = (0, config_repo_1.createConfigMutationPlan)(document, {
+                        setActiveProfile: provider.profile,
+                    });
+                    (0, config_repo_1.applyConfigMutation)(args.configPath, document, configPlan);
+                    const existingAuth = (0, auth_repo_1.readAuthFileIfExists)(args.authPath);
+                    (0, auth_repo_1.writeAuthFile)(args.authPath, provider, existingAuth ?? undefined);
+                    return {
+                        provider: args.providerName,
+                        profile: provider.profile,
+                        envKey: provider.envKey,
+                    };
+                },
+            });
+        }
+        catch (error) {
+            if (!bridge.reused) {
+                (0, copilot_bridge_1.stopCopilotBridge)();
+            }
+            throw error;
+        }
+    }
     return (0, run_mutation_1.runMutation)({
         codexDir: args.codexDir,
         backupsDir: args.backupsDir,

package/dist/cli.js

@@ -9,7 +9,7 @@ const args_1 = require("./commands/args");
 const help_1 = require("./commands/help");
 const errors_1 = require("./domain/errors");
 const output_1 = require("./cli/output");
-const VERSION = "0.0.7";
+const VERSION = "0.0.8";
 /**
  * Prints the command help text to stdout.
  */

package/dist/commands/handlers.js

@@ -58,6 +58,7 @@ const providers_1 = require("../domain/providers");
 const add_interactive_1 = require("../interaction/add-interactive");
 const interactive_1 = require("../interaction/interactive");
 const prompt_1 = require("../interaction/prompt");
+const copilot_installer_1 = require("../runtime/copilot-installer");
 const config_repo_1 = require("../storage/config-repo");
 const codex_paths_1 = require("../storage/codex-paths");
 const providers_repo_1 = require("../storage/providers-repo");
@@ -155,6 +156,9 @@ async function handleRegisteredCommand(ctx, parsed, runtime = (0, prompt_1.creat
             if (!providerName) {
                 throw (0, errors_1.cliError)("PROVIDER_NOT_FOUND", "Missing provider name for switch command.");
             }
+            if ((0, args_1.hasFlag)(parsed.commandOptions, "--install-copilot-sdk")) {
+                throw (0, errors_1.cliError)("INVALID_ARGUMENT", "--install-copilot-sdk is only supported with add --copilot.");
+            }
             return (0, switch_provider_1.switchProvider)({
                 codexDir: paths.codexDir,
                 backupsDir: paths.backupsDir,
@@ -221,7 +225,22 @@ async function handleRegisteredCommand(ctx, parsed, runtime = (0, prompt_1.creat
             let note = (0, args_1.getSingleOption)(parsed.commandOptions, "--note", false);
             let tags = parsed.commandOptions.get("--tag") ?? [];
             let createProfile = (0, args_1.hasFlag)(parsed.commandOptions, "--create-profile");
-            if (!providerName || !profile || !apiKey) {
+            const copilot = (0, args_1.hasFlag)(parsed.commandOptions, "--copilot");
+            const bridgeHost = (0, args_1.getSingleOption)(parsed.commandOptions, "--bridge-host", false);
+            const bridgePortValue = (0, args_1.getSingleOption)(parsed.commandOptions, "--bridge-port", false);
+            const bridgeApiKey = (0, args_1.getSingleOption)(parsed.commandOptions, "--bridge-api-key", false);
+            let installCopilotSdk = (0, args_1.hasFlag)(parsed.commandOptions, "--install-copilot-sdk");
+            const bridgePort = bridgePortValue ? Number(bridgePortValue) : null;
+            if (copilot && apiKey) {
+                throw (0, errors_1.cliError)("INVALID_ARGUMENT", "--copilot does not allow --api-key. Use --bridge-api-key for the local bridge secret.");
+            }
+            if (bridgePortValue && (!Number.isInteger(bridgePort) || bridgePort === null || bridgePort <= 0)) {
+                throw (0, errors_1.cliError)("INVALID_ARGUMENT", "--bridge-port must be a positive integer.");
+            }
+            if (copilot && !installCopilotSdk && (0, interactive_1.canPrompt)(runtime, ctx.options.json) && !(0, copilot_installer_1.probeCopilotSdkInstall)().installed) {
+                installCopilotSdk = await runtime.confirmAction("The optional Copilot SDK runtime is not installed. Install it now?");
+            }
+            if (!providerName || !profile || (!apiKey && !copilot)) {
                 if (ctx.options.json || !runtime.isInteractive()) {
                     throw (0, add_interactive_1.createNonInteractiveAddError)();
                 }
@@ -251,12 +270,18 @@ async function handleRegisteredCommand(ctx, parsed, runtime = (0, prompt_1.creat
                 authPath: paths.authPath,
                 providerName,
                 profile,
-                apiKey,
+                apiKey: apiKey ?? "",
                 baseUrl,
                 model,
                 note,
                 tags,
                 createProfile,
+                copilot,
+                bridgeHost,
+                bridgePort,
+                bridgeApiKey,
+                installCopilotSdk,
+                interactive: (0, interactive_1.canPrompt)(runtime, ctx.options.json),
             });
         }
         case "edit": {

package/dist/commands/registry.js

@@ -128,6 +128,7 @@ exports.COMMANDS = [
         usage: ["codexs status [--json] [--codex-dir <path>]"],
         details: [
             "Reports file presence, current profile, and whether the live profile is mapped.",
+            "When the active provider uses a local runtime bridge, status also reports bridge and SDK state.",
             "Surfaces config consistency signals without mutating any files.",
             "Use doctor for deeper diagnostics.",
         ],
@@ -160,6 +161,7 @@ exports.COMMANDS = [
         summary: "Add a provider with explicit flags or progressive TTY prompts.",
         usage: [
             "codexs add <provider> --profile <name> --api-key <key> [--base-url <url>] [--note <text>] [--tag <tag> ...]",
+            "codexs add <provider> --copilot --profile <name> [--bridge-host <host>] [--bridge-port <port>] [--bridge-api-key <secret>] [--install-copilot-sdk]",
             "codexs add <provider> --profile <name> --api-key <key> --create-profile --model <name> --base-url <url>",
             "codexs add [--profile <name>] [--api-key <key>] [--base-url <url>] [--note <text>] [--tag <tag> ...]",
         ],
@@ -170,8 +172,13 @@ exports.COMMANDS = [
             "Interactive tags use preset multi-select only.",
             "Automation and non-TTY environments must pass all required values explicitly.",
             "Creating a missing profile section requires --create-profile together with --model and --base-url.",
+            "Use --copilot to create a GitHub Copilot bridge provider backed by the official SDK.",
+        ],
+        examples: [
+            "codexs add packycode --profile packycode --api-key sk-xxx",
+            "codexs add copilot-main --copilot --profile copilot-main --install-copilot-sdk",
+            "codexs add",
         ],
-        examples: ["codexs add packycode --profile packycode --api-key sk-xxx", "codexs add packycode --profile packycode", "codexs add"],
     },
     {
         id: "switch",
@@ -184,6 +191,7 @@ exports.COMMANDS = [
             "When <provider> is omitted in a TTY, an interactive provider selector is shown.",
             "When <provider> is passed explicitly, switch proceeds directly without extra confirmation.",
             "Switch updates the active config profile and rewrites auth.json from the provider envKey/apiKey pair.",
+            "Copilot bridge providers probe the optional official SDK before switching and fail fast if it is missing.",
             "Backs up config.toml and auth.json, then rolls back on failure.",
         ],
         examples: ["codexs switch freemodel", "codexs switch packycode --json"],
@@ -252,7 +260,11 @@ exports.COMMANDS = [
         group: "recovery",
         summary: "Run configuration and environment diagnostics.",
         usage: ["codexs doctor [--json] [--codex-dir <path>]"],
-        details: ["Checks the expected config files, provider/profile consistency, and Codex CLI availability.", "Returns structured issues so users and AI agents can act on them."],
+        details: [
+            "Checks the expected config files, provider/profile consistency, and Codex CLI availability.",
+            "Copilot bridge providers add runtime dependency, auth, and bridge health diagnostics.",
+            "Returns structured issues so users and AI agents can act on them.",
+        ],
         examples: ["codexs doctor", "codexs doctor --json"],
     },
     {

package/dist/domain/providers.js

@@ -6,6 +6,9 @@ exports.sortProviders = sortProviders;
 exports.findProviderByProfile = findProviderByProfile;
 exports.findProvidersByProfile = findProvidersByProfile;
 exports.maskSecret = maskSecret;
+exports.isRuntimeBackedProvider = isRuntimeBackedProvider;
+exports.isCopilotBridgeProvider = isCopilotBridgeProvider;
+exports.buildCopilotBridgeBaseUrl = buildCopilotBridgeBaseUrl;
 /**
  * Validates and normalizes unknown JSON into the providers.json domain model.
  */
@@ -42,6 +45,13 @@ function validateProvidersShape(input) {
             (!Array.isArray(provider.tags) || provider.tags.some((tag) => typeof tag !== "string"))) {
             throw new Error(`Provider "${name}" has invalid tags.`);
         }
+        if (provider.runtime !== undefined) {
+            validateProviderRuntime(name, provider.runtime);
+            const expectedBaseUrl = buildCopilotBridgeBaseUrl(provider.runtime);
+            if (typeof provider.baseUrl !== "string" || provider.baseUrl.trim() !== expectedBaseUrl) {
+                throw new Error(`Provider "${name}" baseUrl must match runtime bridge base URL "${expectedBaseUrl}".`);
+            }
+        }
         // Normalize provider fields during validation so the persisted format stays clean.
         providers[name] = cleanProviderRecord({
             profile: provider.profile,
@@ -50,6 +60,7 @@ function validateProvidersShape(input) {
             baseUrl: provider.baseUrl,
             note: provider.note,
             tags: provider.tags,
+            runtime: provider.runtime,
         });
     }
     return { providers };
@@ -72,6 +83,18 @@ function cleanProviderRecord(record) {
     if (record.tags && record.tags.length > 0) {
         next.tags = record.tags.map((tag) => tag.trim()).filter((tag) => tag.length > 0);
     }
+    if (record.runtime) {
+        next.runtime = {
+            kind: record.runtime.kind,
+            upstream: record.runtime.upstream,
+            bridgeHost: record.runtime.bridgeHost.trim(),
+            bridgePort: record.runtime.bridgePort,
+            bridgePath: record.runtime.bridgePath,
+            premiumRequests: record.runtime.premiumRequests,
+            authSource: record.runtime.authSource,
+            sdkInstallMode: record.runtime.sdkInstallMode,
+        };
+    }
     return next;
 }
 /**
@@ -114,3 +137,54 @@ function maskSecret(value) {
     }
     return `${value.slice(0, 3)}***${value.slice(-2)}`;
 }
+/**
+ * Returns whether one provider record relies on an auxiliary runtime component.
+ */
+function isRuntimeBackedProvider(provider) {
+    return Boolean(provider.runtime);
+}
+/**
+ * Returns whether one provider uses the GitHub Copilot SDK bridge runtime.
+ */
+function isCopilotBridgeProvider(provider) {
+    return provider.runtime?.kind === "copilot-sdk-bridge";
+}
+/**
+ * Builds the canonical local bridge URL for one Copilot runtime provider.
+ */
+function buildCopilotBridgeBaseUrl(runtime) {
+    return `http://${runtime.bridgeHost}:${runtime.bridgePort}${runtime.bridgePath}`;
+}
+/**
+ * Validates one runtime-backed provider block.
+ */
+function validateProviderRuntime(name, runtime) {
+    if (!runtime || typeof runtime !== "object" || Array.isArray(runtime)) {
+        throw new Error(`Provider "${name}" has an invalid runtime block.`);
+    }
+    const record = runtime;
+    if (record.kind !== "copilot-sdk-bridge") {
+        throw new Error(`Provider "${name}" has an unsupported runtime kind.`);
+    }
+    if (record.upstream !== "github-copilot") {
+        throw new Error(`Provider "${name}" has an invalid runtime upstream.`);
+    }
+    if (typeof record.bridgeHost !== "string" || record.bridgeHost.trim() === "") {
+        throw new Error(`Provider "${name}" has an invalid runtime bridgeHost.`);
+    }
+    if (typeof record.bridgePort !== "number" || !Number.isInteger(record.bridgePort) || record.bridgePort <= 0) {
+        throw new Error(`Provider "${name}" has an invalid runtime bridgePort.`);
+    }
+    if (record.bridgePath !== "/v1") {
+        throw new Error(`Provider "${name}" has an invalid runtime bridgePath.`);
+    }
+    if (record.premiumRequests !== true) {
+        throw new Error(`Provider "${name}" must enable runtime premiumRequests.`);
+    }
+    if (record.authSource !== "official-sdk") {
+        throw new Error(`Provider "${name}" has an invalid runtime authSource.`);
+    }
+    if (record.sdkInstallMode !== "lazy") {
+        throw new Error(`Provider "${name}" has an invalid runtime sdkInstallMode.`);
+    }
+}