@minniexcode/codex-switch 0.1.3 → 0.1.5

package/README.AI.md

@@ -6,8 +6,8 @@ This file summarizes the current operational contract for AI agents, automation
 
 - Package: `@minniexcode/codex-switch`
 - CLI name: `codexs`
-- Current repository version: `0.1.1`
-- Version status: stable release line
+- Current repository version: `0.1.5`
+- Version status: development line
 - Runtime contract target: Codex `0.134.0+`
 
 ## Product Role
@@ -22,7 +22,7 @@ Direct provider workflow:
 
 ```bash
 codexs init
-codexs add <provider> --model <model> --api-key <key> [--base-url <url>]
+codexs add <provider> --profile <model-provider-id> --model <model> --api-key <key> [--base-url <url>]
 codexs switch <provider>
 codexs status
 codexs doctor
@@ -33,7 +33,7 @@ GitHub Copilot workflow:
 ```bash
 codexs init
 codexs login copilot
-codexs add <provider> --copilot --model <model>
+codexs add <provider> --copilot --profile <model-provider-id> --model <model>
 codexs switch <provider>
 codexs status
 codexs doctor
@@ -130,9 +130,11 @@ Important behavioral constraints:
 - `login copilot` requires a real TTY and does not support `--json`.
 - `login copilot` currently installs the local Copilot SDK when needed, tries the bundled runtime CLI first, falls back to `PATH` when necessary, and rechecks auth readiness before reporting success.
 - `add --copilot` assumes SDK install and upstream Copilot auth are already ready.
+- Non-interactive automation should pass `--profile` explicitly. In TTY mode, `add` and `edit` can prompt for missing required fields.
 - `migrate` remains interactive when provider adoption requires human input.
 - `status` is the main dual-path summary command.
 - `doctor` is the deeper repair-oriented diagnostic command.
+- The current `0.1.5` line focuses on Copilot Bridge process visibility, Responses commentary/reasoning stream events, defensive SDK-event normalization, and unknown-event redaction hardening rather than command-surface expansion.
 
 ## Safety Notes
 

package/README.CN.md

@@ -6,9 +6,9 @@
 
 ## 版本定位
 
-当前包版本：`0.1.2`
+当前包版本：`0.1.5`
 
-这是当前稳定发布线。`0.1.2` 是 Copilot runtime 修复版本，包含受管 SDK 固定版本与 Copilot 专用的 `stream_idle_timeout_ms = 300000` 投影，用于避免长 prompt 的空闲超时。
+这是当前仓库开发线。`0.1.5` 是 Copilot Bridge 过程可见性补丁，聚焦于 commentary/reasoning 流式信号、SDK 事件防御性归一化，以及未知运行态事件的更安全脱敏，同时不扩展 provider 命令面。
 
 ## 安装
 
@@ -34,7 +34,7 @@ Direct provider 主路径：
 
 ```bash
 codexs init
-codexs add my-provider --model gpt-5.5 --base-url https://gateway.example.com/v1 --api-key sk-xxx
+codexs add my-provider --profile my-provider --model gpt-5.5 --base-url https://gateway.example.com/v1 --api-key sk-xxx
 codexs switch my-provider
 codexs status
 codexs doctor
@@ -45,7 +45,7 @@ GitHub Copilot 主路径：
 ```bash
 codexs init
 codexs login copilot
-codexs add copilot-main --copilot --model gpt-4.1
+codexs add copilot-main --copilot --profile copilot-main --model gpt-4.1
 codexs switch copilot-main
 codexs status
 codexs doctor
@@ -56,6 +56,7 @@ codexs doctor
 - `init` 负责初始化 `codex-switch` 的 tool home 与受管状态文件。
 - `login copilot` 负责上游 Copilot onboarding 和登录可用性检查。
 - `add --copilot` 不负责替你登录，它假设上游 Copilot 已经 ready。
+- 非交互调用请显式传入 `--profile`；在 TTY 模式下，`add` 和 `edit` 可以补问缺失的必填项。
 - `switch` 会把选中的 provider 投影到目标 Codex runtime 的顶层 `model` 与 `model_provider`。
 - `status` 是切换后的主读取命令。
 - `doctor` 是主诊断命令，用于解释问题和下一步修复动作。
@@ -116,8 +117,8 @@ codexs current
 codexs status
 codexs config show [profile]
 codexs config list-profiles
-codexs add <provider> --model <model> --api-key <key> [--base-url <url>]
-codexs add <provider> --copilot --model <model>
+codexs add <provider> --profile <model-provider-id> --model <model> --api-key <key> [--base-url <url>]
+codexs add <provider> --copilot --profile <model-provider-id> --model <model>
 codexs edit <provider>
 codexs switch <provider>
 codexs remove <provider> [--force] [--switch-to <provider>]
@@ -209,6 +210,8 @@ npm pack --dry-run
 - [Design 0.1.1](./docs/Design/codex-switch-v0.1.1-design.md)
 - [PRD 0.1.2](./docs/PRD/codex-switch-prd-v0.1.2.md)
 - [Design 0.1.2](./docs/Design/codex-switch-v0.1.2-design.md)
+- [PRD 0.1.5](./docs/PRD/codex-switch-prd-v0.1.5.md)
+- [Design 0.1.5](./docs/Design/codex-switch-v0.1.5-design.md)
 
 ## License
 

package/README.md

@@ -8,9 +8,9 @@ Chinese version: [README.CN.md](./README.CN.md)
 
 ## Version
 
-Current package version: `0.1.3`
+Current package version: `0.1.5`
 
-This is the current stable documentation line. `0.1.3` is the Copilot login hotfix release, repairing the managed SDK client construction against the current official Copilot SDK runtime while keeping the `stream_idle_timeout_ms = 300000` Copilot projection unchanged.
+This is the current repository development line. `0.1.5` is a Copilot Bridge process-visibility patch, focused on streaming commentary/reasoning signals, defensive SDK-event normalization, and safer redaction for unknown runtime events while keeping the provider surface unchanged.
 
 ## Install
 
@@ -36,7 +36,7 @@ Direct provider workflow:
 
 ```bash
 codexs init
-codexs add my-provider --model gpt-5.5 --base-url https://gateway.example.com/v1 --api-key sk-xxx
+codexs add my-provider --profile my-provider --model gpt-5.5 --base-url https://gateway.example.com/v1 --api-key sk-xxx
 codexs switch my-provider
 codexs status
 codexs doctor
@@ -47,7 +47,7 @@ GitHub Copilot workflow:
 ```bash
 codexs init
 codexs login copilot
-codexs add copilot-main --copilot --model gpt-4.1
+codexs add copilot-main --copilot --profile copilot-main --model gpt-4.1
 codexs switch copilot-main
 codexs status
 codexs doctor
@@ -58,6 +58,7 @@ Notes:
 - `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.
+- For non-interactive use, pass `--profile` explicitly. In TTY mode, `add` and `edit` can prompt for missing required fields.
 - Copilot support is an experimental local bridge. The managed installer defaults to `@github/copilot-sdk@1.0.2`, Copilot runtime paths require Node.js `>=20`, and runtime checks separately reject older or prerelease SDK installs while validating API shape when the client or session is used.
 - `switch` projects the selected provider into the target Codex runtime as top-level `model` plus `model_provider`.
 - `status` is the main read command after switching.
@@ -125,8 +126,8 @@ codexs current
 codexs status
 codexs config show [profile]
 codexs config list-profiles
-codexs add <provider> --model <model> --api-key <key> [--base-url <url>]
-codexs add <provider> --copilot --model <model>
+codexs add <provider> --profile <model-provider-id> --model <model> --api-key <key> [--base-url <url>]
+codexs add <provider> --copilot --profile <model-provider-id> --model <model>
 codexs edit <provider>
 codexs switch <provider>
 codexs remove <provider> [--force] [--switch-to <provider>]
@@ -218,8 +219,10 @@ npm pack --dry-run
 - [PRD 0.1.1](./docs/PRD/codex-switch-prd-v0.1.1.md)
 - [PRD 0.1.2](./docs/PRD/codex-switch-prd-v0.1.2.md)
 - [PRD 0.1.3](./docs/PRD/codex-switch-prd-v0.1.3.md)
+- [PRD 0.1.5](./docs/PRD/codex-switch-prd-v0.1.5.md)
 - [Design 0.1.2](./docs/Design/codex-switch-v0.1.2-design.md)
 - [Design 0.1.3](./docs/Design/codex-switch-v0.1.3-design.md)
+- [Design 0.1.5](./docs/Design/codex-switch-v0.1.5-design.md)
 
 ## License
 

package/dist/app/bridge.js

@@ -58,6 +58,9 @@ async function startBridge(args) {
             port: bridge.port,
             reused: bridge.reused,
             portChanged: bridge.portChanged,
+            replaced: bridge.replaced,
+            restartReason: bridge.restartReason ?? null,
+            logPath: bridge.logPath,
             defaultPort: DEFAULT_BRIDGE_PORT,
         },
     };
@@ -74,6 +77,8 @@ async function stopBridge(args) {
                 provider: null,
                 stopped: true,
                 hadRuntimeState: false,
+                logPath: null,
+                lastRestartReason: null,
             },
         };
     }
@@ -84,6 +89,8 @@ async function stopBridge(args) {
                 provider: args.providerName,
                 stopped: true,
                 hadRuntimeState: false,
+                logPath: null,
+                lastRestartReason: null,
             },
         };
     }
@@ -109,6 +116,8 @@ async function stopBridge(args) {
             provider: target.providerName,
             stopped: true,
             hadRuntimeState: Boolean(state),
+            logPath: state?.logPath ?? null,
+            lastRestartReason: state?.lastRestartReason ?? null,
         },
     };
 }
@@ -146,6 +155,8 @@ async function statusBridge(args) {
             matches: Boolean(state && state.provider === target.providerName && state.baseUrl === expectedBaseUrl),
             active: runtimeStatus.ok,
             health: runtimeStatus,
+            logPath: state?.logPath ?? null,
+            lastRestartReason: state?.lastRestartReason ?? null,
         },
     };
 }

package/dist/app/get-status.js

@@ -88,6 +88,9 @@ async function getStatus(codexDir, configPath, providersPath, authPath, options)
             runtime: "copilot-bridge",
             reason: "failed",
             cause: runtimeStateInspection.parseError ?? "Failed to parse Copilot bridge runtime state.",
+            details: {
+                logPath: runtimeState?.logPath ?? null,
+            },
         }
         : bridgeProbeTarget
             ? await (0, copilot_bridge_1.probeCopilotBridgeRuntime)(bridgeProbeTarget, runtimeState, options?.runtimeDir)
@@ -97,7 +100,10 @@ async function getStatus(codexDir, configPath, providersPath, authPath, options)
                     runtime: "copilot-bridge",
                     reason: "failed",
                     cause: "Copilot bridge runtime state exists but no matching managed Copilot provider is active.",
-                    details: runtimeState,
+                    details: {
+                        ...runtimeState,
+                        logPath: runtimeState.logPath ?? null,
+                    },
                 }
                 : null;
     const copilotAuth = activeProvider && (0, providers_1.isCopilotBridgeProvider)(activeProvider)
@@ -148,6 +154,8 @@ async function getStatus(codexDir, configPath, providersPath, authPath, options)
             copilotAuth,
             copilotBridge,
             copilotRuntimeState: runtimeState,
+            copilotBridgeLogPath: runtimeState?.logPath ?? null,
+            copilotBridgeRestartReason: runtimeState?.lastRestartReason ?? null,
             liveState,
             auth: authState,
             configProfiles: configViews,

package/dist/app/run-doctor.js

@@ -117,6 +117,7 @@ async function runDoctor(args) {
         issues.push({
             code: "BRIDGE_STATE_STALE",
             message: `Copilot bridge runtime state is unreadable: ${runtimeStateInspection.parseError ?? "unknown parse failure"}`,
+            logPath: runtimeState?.logPath ?? null,
         });
     }
     if (document?.currentModelProvider && providers) {
@@ -209,6 +210,7 @@ async function runDoctor(args) {
             }),
             liveState: drift,
             auth: authState,
+            copilotRuntimeState: runtimeState,
         },
         warnings: issues.length === 0 ? [] : [`doctor found ${issues.length} issue(s)`],
     };

package/dist/app/switch-provider.js

@@ -22,7 +22,9 @@ async function switchProvider(args) {
         });
     }
     const document = (0, config_repo_1.readStructuredConfig)(args.configPath);
-    const resolvedModel = provider.model ?? document.currentModel;
+    const providerProfileSection = document.profiles.find((entry) => entry.name === provider.profile) ?? null;
+    const providerModelProviderSection = document.modelProviders.find((entry) => entry.name === provider.profile) ?? null;
+    const resolvedModel = provider.model ?? providerProfileSection?.model ?? document.currentModel;
     if (!resolvedModel) {
         throw (0, errors_1.cliError)("MANAGED_PROFILE_FIELDS_MISSING", `Provider "${args.providerName}" has no model to switch with.`, {
             provider: args.providerName,
@@ -90,6 +92,10 @@ async function switchProvider(args) {
                         profile: nextProvider.profile,
                         portChanged: bridge.portChanged,
                         bridgePort: bridge.port,
+                        bridgeReused: bridge.reused,
+                        bridgeReplaced: bridge.replaced,
+                        bridgeRestartReason: bridge.restartReason ?? null,
+                        bridgeLogPath: bridge.logPath,
                     };
                 },
             });
@@ -112,7 +118,8 @@ async function switchProvider(args) {
         ],
         mutate: () => {
             const directBaseUrl = provider.baseUrl?.trim() ?? "";
-            if (!directBaseUrl) {
+            const resolvedBaseUrl = directBaseUrl || providerModelProviderSection?.baseUrl?.trim() || "";
+            if (!resolvedBaseUrl) {
                 throw (0, errors_1.cliError)("MANAGED_PROFILE_FIELDS_MISSING", `Provider "${args.providerName}" requires base_url before switching.`, {
                     provider: args.providerName,
                     modelProvider: provider.profile,
@@ -123,7 +130,7 @@ async function switchProvider(args) {
                 setCurrentModel: resolvedModel,
                 setCurrentModelProvider: provider.profile,
                 upsertModelProviders: {
-                    [provider.profile]: (0, providers_1.buildDirectModelProviderProjection)(provider.profile, directBaseUrl),
+                    [provider.profile]: (0, providers_1.buildDirectModelProviderProjection)(provider.profile, resolvedBaseUrl),
                 },
                 deleteLegacyProfile: true,
                 deleteLegacyProfilesByName: [provider.profile],

package/dist/cli/output.js

@@ -144,6 +144,12 @@ function renderHumanSuccess(command, data, warnings) {
             lines.push(`  mapped provider: ${renderStatusMappedProvider(data)}`);
             lines.push(`  provider path: ${renderStatusProviderPath(data)}`);
             lines.push(`  runtime health: ${renderStatusHealth(data)}`);
+            if (data?.copilotBridgeLogPath) {
+                lines.push(`  bridge log: ${String(data.copilotBridgeLogPath)}`);
+            }
+            if (data?.copilotBridgeRestartReason) {
+                lines.push(`  bridge restart reason: ${String(data.copilotBridgeRestartReason)}`);
+            }
             lines.push(`  warnings: ${warnings.length}`);
             lines.push(`  next step: ${renderStatusNextStep(data, warnings)}`);
             break;
@@ -167,6 +173,15 @@ function renderHumanSuccess(command, data, warnings) {
         case "switch":
             lines.push(`Switched to provider ${String(data?.provider ?? "")} using model provider ${String(data?.modelProvider ?? data?.profile ?? "")}.`);
             lines.push(`Model: ${String(data?.model ?? "")}`);
+            if (data?.bridgeReplaced) {
+                lines.push(`Bridge replaced: true`);
+            }
+            if (data?.bridgeRestartReason) {
+                lines.push(`Bridge restart reason: ${String(data?.bridgeRestartReason)}`);
+            }
+            if (data?.bridgeLogPath) {
+                lines.push(`Bridge log: ${String(data?.bridgeLogPath)}`);
+            }
             lines.push(`Backup: ${String(data?.backupPath ?? "")}`);
             break;
         case "import":
@@ -227,12 +242,49 @@ function renderHumanSuccess(command, data, warnings) {
             const issues = data?.issues ?? [];
             lines.push(healthy ? "Doctor summary: healthy. No action required." : `Doctor summary: ${issues.length} issue(s) need attention.`);
             lines.push(`target runtime: ${String(data?.codexDir ?? "")}`);
+            if (data?.copilotRuntimeState && data.copilotRuntimeState.logPath) {
+                lines.push(`bridge log: ${String(data.copilotRuntimeState.logPath)}`);
+            }
             for (const issue of issues) {
                 lines.push(`- ${String(issue.code)}: ${String(issue.message)}`);
                 lines.push(`  next step: ${renderDoctorIssueNextStep(issue)}`);
             }
             break;
         }
+        case "bridge-start":
+            lines.push(`Bridge ready for provider ${String(data?.provider ?? "")}.`);
+            lines.push(`Endpoint: ${String(data?.baseUrl ?? "")}`);
+            lines.push(`Reused: ${String(data?.reused ?? false)}`);
+            lines.push(`Replaced existing: ${String(data?.replaced ?? false)}`);
+            if (data?.restartReason) {
+                lines.push(`Restart reason: ${String(data?.restartReason)}`);
+            }
+            if (data?.logPath) {
+                lines.push(`Bridge log: ${String(data?.logPath)}`);
+            }
+            break;
+        case "bridge-status":
+            lines.push(`Bridge provider: ${String(data?.provider ?? "")}`);
+            lines.push(`Active: ${String(data?.active ?? false)}`);
+            lines.push(`Expected base URL: ${String(data?.expectedBaseUrl ?? "")}`);
+            lines.push(`Matches runtime state: ${String(data?.matches ?? false)}`);
+            if (data?.lastRestartReason) {
+                lines.push(`Last restart reason: ${String(data?.lastRestartReason)}`);
+            }
+            if (data?.logPath) {
+                lines.push(`Bridge log: ${String(data?.logPath)}`);
+            }
+            break;
+        case "bridge-stop":
+            lines.push(`Bridge stopped for provider ${String(data?.provider ?? "(none)")}.`);
+            lines.push(`Had runtime state: ${String(data?.hadRuntimeState ?? false)}`);
+            if (data?.lastRestartReason) {
+                lines.push(`Last restart reason: ${String(data?.lastRestartReason)}`);
+            }
+            if (data?.logPath) {
+                lines.push(`Bridge log: ${String(data?.logPath)}`);
+            }
+            break;
         case "backups-list": {
             const backups = data?.backups ?? [];
             for (const backup of backups) {
@@ -344,7 +396,7 @@ function renderDoctorIssueNextStep(issue) {
         case "BRIDGE_STATE_STALE":
         case "BRIDGE_STATE_MISSING":
         case "BRIDGE_HEALTHCHECK_FAILED":
-            return "reselect the provider with `codexs switch <provider>` or inspect bridge state";
+            return "reselect the provider with `codexs switch <provider>` or inspect the bridge log/state";
         case "UNMANAGED_ACTIVE_PROFILE":
             return "switch to a managed provider or adopt the active route with `codexs migrate`";
         case "LEGACY_PROFILE_SELECTOR":

package/dist/interaction/interactive.js

@@ -70,18 +70,25 @@ function canPrompt(runtime, jsonMode) {
  */
 async function promptForProviderSelection(runtime, providersPath, configPath, message) {
     const providers = (0, providers_repo_1.readProvidersFile)(providersPath);
-    const currentModelProvider = fs.existsSync(configPath) ? (0, config_repo_1.readStructuredConfig)(configPath).currentModelProvider : null;
+    const document = fs.existsSync(configPath) ? (0, config_repo_1.readStructuredConfig)(configPath) : null;
+    const currentModelProvider = document?.currentModelProvider ?? null;
     const liveState = (0, runtime_state_1.inspectLiveStateDrift)(currentModelProvider, providers);
+    const legacyCurrentProvider = !liveState.providerResolvable &&
+        document?.legacyProfile &&
+        providers.providers[document.legacyProfile]
+        ? document.legacyProfile
+        : null;
     const choices = Object.entries(providers.providers)
         .sort(([left], [right]) => left.localeCompare(right))
         .map(([providerName, provider]) => {
         const providerType = (0, providers_1.isCopilotBridgeProvider)(provider) ? "copilot" : "direct";
         const currentMarker = liveState.providerResolvable && liveState.mappedProvider === providerName ? " | current" : "";
+        const legacyMarker = !currentMarker && legacyCurrentProvider === providerName ? " | current" : "";
         const ambiguousMarker = !liveState.providerResolvable && liveState.mappedProviders.includes(providerName) ? " | current=ambiguous" : "";
         return {
             value: providerName,
             label: providerName,
-            hint: `profile=${provider.profile} | type=${providerType}${currentMarker}${ambiguousMarker}`,
+            hint: `profile=${provider.profile} | type=${providerType}${currentMarker}${legacyMarker}${ambiguousMarker}`,
         };
     });
     if (choices.length === 0) {

package/dist/runtime/copilot-adapter.js

@@ -174,6 +174,7 @@ async function createCopilotSession(runtimeClient, payload) {
     try {
         const session = await Promise.resolve(createSession({
             model: typeof payload.model === "string" ? payload.model : undefined,
+            streaming: true,
             ...createSessionOptions(runtimeClient.sdk),
         }));
         if (!session || typeof session !== "object") {
@@ -208,7 +209,16 @@ async function sendSessionRequest(session, prompt, timeoutMs, onStreamEvent) {
             onStreamEvent?.({ type: "delta", delta });
         }
     };
+    const runtimeHandler = (event) => {
+        for (const runtimeEvent of mapCopilotRuntimeEvent(event)) {
+            onStreamEvent?.({ type: "runtime", event: runtimeEvent });
+            if (runtimeEvent.type === "assistant.message_delta" && runtimeEvent.text.length > 0) {
+                onStreamEvent?.({ type: "delta", delta: runtimeEvent.text });
+            }
+        }
+    };
     if (onStreamEvent && session.on) {
+        session.on("event", runtimeHandler);
         session.on("data", deltaHandler);
         session.on("message", deltaHandler);
         session.on("delta", deltaHandler);
@@ -225,6 +235,7 @@ async function sendSessionRequest(session, prompt, timeoutMs, onStreamEvent) {
     }
     finally {
         if (onStreamEvent && session.off) {
+            session.off("event", runtimeHandler);
             session.off("data", deltaHandler);
             session.off("message", deltaHandler);
             session.off("delta", deltaHandler);
@@ -395,6 +406,115 @@ function extractDelta(event) {
     }
     return null;
 }
+/**
+ * Maps SDK session events into the bridge's stable process-event contract.
+ */
+function mapCopilotRuntimeEvent(event) {
+    if (!event || typeof event !== "object") {
+        return [];
+    }
+    const record = event;
+    const sdkType = readString(record, ["type", "event", "name", "eventName"]) ?? "unknown";
+    const normalizedType = sdkType.replace(/_/g, ".").toLowerCase();
+    const text = readString(record, ["text", "delta", "content", "message", "summary", "description"]);
+    const name = readString(record, ["toolName", "tool", "name"]);
+    const requestId = readString(record, ["requestId", "id", "callId"]);
+    const kind = readString(record, ["kind", "permission", "permissionKind"]);
+    const success = readBoolean(record, ["success", "ok"]);
+    const approved = readBoolean(record, ["approved", "allowed", "accepted"]);
+    const summary = truncateForBridgeLog(text ?? summarizeUnknownObject(record), 600);
+    if (normalizedType === "assistant.intent") {
+        return [{ type: "assistant.intent", text: summary }];
+    }
+    if (normalizedType === "assistant.message.delta" || normalizedType === "assistant.message_delta") {
+        return [{ type: "assistant.message_delta", text: text ?? "" }];
+    }
+    if (normalizedType === "assistant.reasoning.delta" || normalizedType === "assistant.reasoning_delta" || normalizedType === "reasoning.delta") {
+        return [{ type: "assistant.reasoning_delta", text: summary }];
+    }
+    if (normalizedType === "tool.execution.start" || normalizedType === "tool.execution_start") {
+        return [{ type: "tool.execution_start", name, requestId, summary: summary || `Tool started: ${name ?? "unknown"}` }];
+    }
+    if (normalizedType === "tool.execution.progress" || normalizedType === "tool.execution_progress") {
+        return [{ type: "tool.execution_progress", name, requestId, summary }];
+    }
+    if (normalizedType === "tool.execution.partial.result" || normalizedType === "tool.execution.partial_result") {
+        return [{ type: "tool.execution_partial_result", name, requestId, summary }];
+    }
+    if (normalizedType === "tool.execution.complete" || normalizedType === "tool.execution_complete") {
+        return [{ type: "tool.execution_complete", name, requestId, success, summary: summary || `Tool completed: ${name ?? "unknown"}` }];
+    }
+    if (normalizedType === "permission.requested" || normalizedType === "permission.request") {
+        return [{ type: "permission.requested", kind, requestId, summary: summary || `Copilot requested permission: ${kind ?? "unknown"}` }];
+    }
+    if (normalizedType === "permission.completed" || normalizedType === "permission.complete") {
+        return [{ type: "permission.completed", kind, requestId, approved, summary }];
+    }
+    if (normalizedType === "user.input.requested" || normalizedType === "user.input_request" || normalizedType === "user_input.requested") {
+        return [{ type: "user_input.requested", requestId, summary }];
+    }
+    if (normalizedType === "exit.plan.mode.requested" || normalizedType === "exit_plan_mode.requested") {
+        return [{ type: "exit_plan_mode.requested", requestId, summary }];
+    }
+    if (normalizedType === "session.error" || normalizedType === "error") {
+        return [{ type: "session.error", summary }];
+    }
+    if (normalizedType === "session.idle" || normalizedType === "idle") {
+        return [{ type: "session.idle", summary: summary || "Copilot session is idle." }];
+    }
+    return [{ type: "session.unknown", sdkType, summary }];
+}
+function readString(record, keys) {
+    for (const key of keys) {
+        const value = record[key];
+        if (typeof value === "string" && value.length > 0) {
+            return value;
+        }
+        if (value && typeof value === "object") {
+            const nested = value;
+            for (const nestedKey of ["name", "id", "text", "content", "message", "summary"]) {
+                if (typeof nested[nestedKey] === "string" && nested[nestedKey].length > 0) {
+                    return nested[nestedKey];
+                }
+            }
+        }
+    }
+    return undefined;
+}
+function readBoolean(record, keys) {
+    for (const key of keys) {
+        if (typeof record[key] === "boolean") {
+            return record[key];
+        }
+    }
+    return undefined;
+}
+function summarizeUnknownObject(record) {
+    return JSON.stringify(record, (key, value) => {
+        if (isSensitiveKey(key)) {
+            return "[redacted]";
+        }
+        if (typeof value === "string") {
+            return redactSensitiveText(value);
+        }
+        return value;
+    });
+}
+function redactSensitiveText(value) {
+    if (/api[_-]?key|token|authorization|bearer\s+|sk-[a-z0-9_-]+/i.test(value)) {
+        return "[redacted]";
+    }
+    return value;
+}
+function isSensitiveKey(key) {
+    return /^(api[_-]?key|token|access[_-]?token|refresh[_-]?token|authorization|secret|password)$/i.test(key);
+}
+function truncateForBridgeLog(value, maxLength) {
+    if (value.length <= maxLength) {
+        return value;
+    }
+    return `${value.slice(0, maxLength)}... [truncated]`;
+}
 function isAuthReady(status) {
     if (status === true) {
         return true;

package/dist/runtime/copilot-bridge-worker.js

@@ -3,6 +3,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const copilot_bridge_1 = require("./copilot-bridge");
 const copilot_adapter_1 = require("./copilot-adapter");
 let requestQueue = Promise.resolve();
+/**
+ * Writes one worker lifecycle entry to stderr so the detached parent log capture persists it.
+ */
+function logWorkerEvent(message) {
+    process.stderr.write(`[${new Date().toISOString()}] ${message}\n`);
+}
 function enqueueRequest(task) {
     const run = requestQueue.then(task, task);
     requestQueue = run.catch(() => undefined);
@@ -14,9 +20,11 @@ async function main() {
     const port = Number(process.env.CODEX_SWITCH_BRIDGE_PORT ?? "41415");
     const apiKey = process.env.CODEX_SWITCH_BRIDGE_API_KEY ?? "";
     const runtimesDir = process.env.CODEX_SWITCH_RUNTIMES_DIR || undefined;
+    logWorkerEvent(`worker startup provider=${provider} host=${host} port=${String(port)}`);
     const runtimeClient = await (0, copilot_adapter_1.createCopilotRuntimeClient)(runtimesDir);
     await (0, copilot_adapter_1.startCopilotRuntimeClient)(runtimeClient);
     const stopRuntime = () => {
+        logWorkerEvent(`worker shutdown provider=${provider}`);
         void (0, copilot_adapter_1.stopCopilotRuntimeClient)(runtimeClient).finally(() => process.exit(0));
     };
     process.once("SIGINT", stopRuntime);
@@ -35,15 +43,26 @@ async function main() {
                 if (event.type === "delta") {
                     options?.onTextDelta?.(event.delta);
                 }
+                else if (event.type === "runtime") {
+                    options?.onRuntimeEvent?.(event.event);
+                }
                 else {
                     options?.onTextDone?.(event.text);
                 }
             },
         })),
     });
+    logWorkerEvent(`worker ready provider=${provider} host=${host} port=${String(port)}`);
 }
 if (require.main === module) {
+    process.on("uncaughtException", (error) => {
+        logWorkerEvent(`worker uncaught exception: ${error.message}`);
+    });
+    process.on("unhandledRejection", (reason) => {
+        logWorkerEvent(`worker unhandled rejection: ${reason instanceof Error ? reason.message : String(reason)}`);
+    });
     void main().catch((error) => {
+        logWorkerEvent(`worker startup failure: ${error instanceof Error ? error.message : String(error)}`);
         process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
         process.exit(1);
     });