@minniexcode/codex-switch 0.1.4 → 0.1.5

package/README.AI.md

@@ -6,7 +6,7 @@ This file summarizes the current operational contract for AI agents, automation
 
 - Package: `@minniexcode/codex-switch`
 - CLI name: `codexs`
-- Current repository version: `0.1.4`
+- Current repository version: `0.1.5`
 - Version status: development line
 - Runtime contract target: Codex `0.134.0+`
 
@@ -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,10 +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.4` line focuses on bridge stability, surfaced runtime log metadata, and stricter release-hygiene verification rather than command-surface expansion.
+- 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.4`
+当前包版本：`0.1.5`
 
-这是当前仓库开发线。`0.1.4` 聚焦于 bridge 稳定性与可观测性，包括 bridge 复用探测加固、运行态日志元数据外显，以及更严格的 release hygiene 门禁，同时不扩展 provider 命令面。
+这是当前仓库开发线。`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,8 +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.4](./docs/PRD/codex-switch-prd-v0.1.4.md)
-- [Design 0.1.4](./docs/Design/codex-switch-v0.1.4-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.4`
+Current package version: `0.1.5`
 
-This is the current repository development line. `0.1.4` is the bridge stability and observability line, focused on bridge reuse hardening, surfaced runtime log metadata, and a stricter release-hygiene gate while keeping the provider surface 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,10 +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.4](./docs/PRD/codex-switch-prd-v0.1.4.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.4](./docs/Design/codex-switch-v0.1.4-design.md)
+- [Design 0.1.5](./docs/Design/codex-switch-v0.1.5-design.md)
 
 ## License
 

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

@@ -43,6 +43,9 @@ 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);
                 }

package/dist/runtime/copilot-bridge.js

@@ -403,6 +403,9 @@ function createCopilotBridgeRequestHandler(context) {
                                 writeResponsesTextDelta(response, messageId, doneText);
                             }
                         },
+                        onRuntimeEvent: (event) => {
+                            writeResponsesRuntimeEvent(response, responseId, event);
+                        },
                     });
                     clearInterval(heartbeat);
                     const outputText = text || getChatCompletionText(payload);
@@ -790,6 +793,112 @@ function writeResponsesStreamDone(response, responseId, model, messageId, output
         },
     });
 }
+function writeResponsesRuntimeEvent(response, responseId, event) {
+    if (event.type === "assistant.message_delta") {
+        return;
+    }
+    if (event.type === "assistant.reasoning_delta") {
+        writeResponsesReasoningDelta(response, responseId, formatRuntimeEventText(event));
+        return;
+    }
+    if (event.type === "session.unknown") {
+        process.stderr.write(`[${new Date().toISOString()}] bridge runtime event ignored type=${event.sdkType} summary=${truncateBridgeText(event.summary, 240)}\n`);
+        return;
+    }
+    const text = formatRuntimeEventText(event);
+    if (text.length === 0) {
+        return;
+    }
+    writeResponsesCommentaryItem(response, responseId, text);
+    process.stderr.write(`[${new Date().toISOString()}] bridge runtime event type=${event.type} summary=${truncateBridgeText(text, 240)}\n`);
+}
+function writeResponsesReasoningDelta(response, responseId, text) {
+    const reasoningId = `${responseId}_rs_0`;
+    writeSseEvent(response, "response.reasoning_summary_part.added", {
+        type: "response.reasoning_summary_part.added",
+        item_id: reasoningId,
+        output_index: 0,
+        summary_index: 0,
+        part: {
+            type: "summary_text",
+            text: "",
+        },
+    });
+    writeSseEvent(response, "response.reasoning_summary_text.delta", {
+        type: "response.reasoning_summary_text.delta",
+        item_id: reasoningId,
+        output_index: 0,
+        summary_index: 0,
+        delta: text,
+    });
+}
+function writeResponsesCommentaryItem(response, responseId, text) {
+    const itemId = `${responseId}_commentary_${Date.now()}_${Math.floor(Math.random() * 100000)}`;
+    writeSseEvent(response, "response.output_item.done", {
+        type: "response.output_item.done",
+        output_index: 0,
+        item: {
+            id: itemId,
+            type: "message",
+            status: "completed",
+            role: "assistant",
+            phase: "commentary",
+            content: [
+                {
+                    type: "output_text",
+                    text,
+                    annotations: [],
+                },
+            ],
+        },
+    });
+}
+function formatRuntimeEventText(event) {
+    switch (event.type) {
+        case "assistant.intent":
+            return truncateBridgeText(event.text, 600);
+        case "assistant.reasoning_delta":
+            return truncateBridgeText(event.text, 600);
+        case "tool.execution_start":
+            return truncateBridgeText(`Copilot started ${formatToolName(event.name)}${formatRequestId(event.requestId)}${formatSummarySuffix(event.summary)}`, 600);
+        case "tool.execution_progress":
+            return truncateBridgeText(`Copilot progress ${formatToolName(event.name)}${formatRequestId(event.requestId)}${formatSummarySuffix(event.summary)}`, 600);
+        case "tool.execution_partial_result":
+            return truncateBridgeText(`Copilot partial result ${formatToolName(event.name)}${formatRequestId(event.requestId)}${formatSummarySuffix(event.summary)}`, 600);
+        case "tool.execution_complete":
+            return truncateBridgeText(`Copilot ${event.success === false ? "failed" : "completed"} ${formatToolName(event.name)}${formatRequestId(event.requestId)}${formatSummarySuffix(event.summary)}`, 600);
+        case "permission.requested":
+            return truncateBridgeText(`Copilot requested permission${event.kind ? `: ${event.kind}` : ""}${formatRequestId(event.requestId)}${formatSummarySuffix(event.summary)}`, 600);
+        case "permission.completed":
+            return truncateBridgeText(`Copilot permission ${event.approved === false ? "denied" : "approved"}${event.kind ? `: ${event.kind}` : ""}${formatRequestId(event.requestId)}${formatSummarySuffix(event.summary)}`, 600);
+        case "user_input.requested":
+            return truncateBridgeText(`Copilot requested user input${formatRequestId(event.requestId)}${formatSummarySuffix(event.summary)}`, 600);
+        case "exit_plan_mode.requested":
+            return truncateBridgeText(`Copilot requested to exit plan mode${formatRequestId(event.requestId)}${formatSummarySuffix(event.summary)}`, 600);
+        case "session.error":
+            return truncateBridgeText(`Copilot session error${formatSummarySuffix(event.summary)}`, 600);
+        case "session.idle":
+            return truncateBridgeText(event.summary, 600);
+        case "assistant.message_delta":
+        case "session.unknown":
+            return "";
+    }
+}
+function formatToolName(name) {
+    return name ? `tool ${name}` : "tool";
+}
+function formatRequestId(requestId) {
+    return requestId ? ` (${requestId})` : "";
+}
+function formatSummarySuffix(summary) {
+    return summary.length > 0 ? `: ${summary}` : "";
+}
+function truncateBridgeText(value, maxLength) {
+    if (value.length <= maxLength) {
+        return value;
+    }
+    return `${value.slice(0, maxLength)}... [truncated]`;
+}
 function startSseHeartbeat(response) {
     return setInterval(() => {
         response.write(": keep-alive\n\n");

package/docs/Design/codex-switch-v0.1.5-design.md

@@ -0,0 +1,17 @@
+# codex-switch v0.1.5 Design
+
+`0.1.5` is a Copilot Bridge process-visibility and redaction patch release.
+
+## Design Notes
+
+- `CopilotBridgeRuntimeEvent` is the stable internal boundary between Copilot SDK session events and the OpenAI-compatible bridge surface.
+- Copilot sessions are created with `streaming: true` and register the generic `session.on("event", handler)` listener alongside the existing `data`, `message`, and `delta` text compatibility listeners.
+- The adapter maps known SDK event names into bridge runtime events for assistant intent, assistant message deltas, assistant reasoning deltas, tool lifecycle, permission lifecycle, user-input requests, exit-plan-mode requests, session idle, and session errors.
+- `assistant.message_delta` is also forwarded as a normal text delta so final response streaming remains compatible with existing Chat Completions and Responses text paths.
+- The bridge worker forwards adapter runtime events through `onRuntimeEvent`, separate from `onTextDelta` and `onTextDone`.
+- Responses streaming projects non-text runtime process events as completed assistant message items with `phase: "commentary"`.
+- Reasoning deltas project as `response.reasoning_summary_part.added` followed by `response.reasoning_summary_text.delta`.
+- Unknown SDK events become `session.unknown`, are omitted from the UI projection path, and are logged with bounded summaries.
+- Unknown summaries redact sensitive key names and obvious token/API-key-like values before truncation.
+- Chat Completions streaming only wires text deltas, so Responses-only commentary events stay out of Chat Completions streams.
+- Internal Copilot tool lifecycle events remain process visibility signals only; they are not emitted as Codex/OpenAI function calls or tool calls.

package/docs/PRD/codex-switch-prd-v0.1.5.md

@@ -0,0 +1,42 @@
+# codex-switch v0.1.5 PRD
+
+## Version
+
+- Version line: `0.1.5`
+- Target repository package version: `0.1.5`
+
+## Summary
+
+`0.1.5` is a Copilot Bridge process-visibility and redaction patch release. It surfaces assistant progress, reasoning summaries, tool lifecycle, permission, user-input, and exit-plan-mode signals through the existing bridge stream while keeping the provider command surface unchanged.
+
+## Required Outcome
+
+- Copilot SDK streaming sessions must subscribe to the generic session event channel and preserve existing text-delta compatibility listeners.
+- Known SDK process events must map into a stable bridge runtime-event contract instead of leaking SDK-specific shapes.
+- Responses streaming must surface process/status updates as commentary items and reasoning/progress updates as reasoning summary events.
+- Chat Completions streaming must continue to receive text only and must not receive Responses-only commentary events.
+- Unknown SDK events must be ignored by the UI projection path while logging bounded, redacted summaries for diagnostics.
+- Adapter-level tests must cover raw SDK session event normalization, not only bridge-server projection of already-normalized events.
+
+## Release Scope
+
+- Copilot adapter runtime event contract and SDK event normalization.
+- Bridge worker forwarding of adapter runtime events into request handlers.
+- Responses streaming projection for commentary and reasoning summary events.
+- Unknown-event truncation and redaction hardening.
+- Focused regression coverage for raw SDK event mapping and bridge stream projection.
+
+## Non-Goals
+
+- No new provider families.
+- No migration or backward-compatibility shims.
+- No expansion of direct-provider workflows.
+- No conversion of internal Copilot tool lifecycle events into Codex/OpenAI function-call or tool-call payloads.
+
+## Release Acceptance
+
+- `npm test` passes with adapter-level raw event normalization coverage.
+- Responses streaming includes commentary and reasoning summary process events.
+- Final assistant text still streams normally.
+- Unknown events are redacted, truncated, logged for diagnostics, and ignored by the UI projection path.
+- Chat Completions streaming does not emit Responses-only commentary events.

package/docs/Tests/testing.md

@@ -2,7 +2,7 @@
 
 This guide records the current `0.1.x` verification contract for release and review work.
 
-The current repository line is `0.1.4` and remains an unreleased development line until an explicit release task says otherwise.
+The current repository line is `0.1.5` and remains an unreleased development line until an explicit release task says otherwise.
 
 ## Required checks
 
@@ -25,7 +25,7 @@ node dist/cli.js --version
 - `--json` envelope: top-level `ok`, `command`, `data`, `warnings`, and `error` must remain stable
 - `migrate`: advanced adopt helper only
 - `setup`: deprecated entry only
-- Release hygiene: `package.json`, `package-lock.json`, current-line docs, changelog top entry, and current PRD/Design fact sources must agree on the `0.1.4` development line
+- Release hygiene: `package.json`, `package-lock.json`, current-line docs, changelog top entry, and current PRD/Design fact sources must agree on the `0.1.5` development line
 
 ## Fixture guidance
 

package/docs/cli-usage.md

@@ -1,6 +1,6 @@
 # codex-switch CLI Usage
 
-This document describes the current `0.1.4` repository development-line CLI contract for `@minniexcode/codex-switch`, including the bridge stability and observability boundary.
+This document describes the current `0.1.5` repository development-line CLI contract for `@minniexcode/codex-switch`, including the Copilot Bridge process-visibility boundary.
 
 Executable command name:
 
@@ -10,9 +10,9 @@ codexs
 
 ## 1. Version Context
 
-The current package version in this repository is `0.1.4`.
+The current package version in this repository is `0.1.5`.
 
-This release line targets Codex `0.134.0+`. The public contract assumes runtime routing is selected by top-level `model` plus `model_provider`, while legacy `profile` and `[profiles.*]` remain inspect-and-adopt inputs instead of the recommended runtime path. The current `0.1.4` development line tightens bridge reliability and release-hygiene verification without expanding the provider command surface.
+This release line targets Codex `0.134.0+`. The public contract assumes runtime routing is selected by top-level `model` plus `model_provider`, while legacy `profile` and `[profiles.*]` remain inspect-and-adopt inputs instead of the recommended runtime path. The current `0.1.5` development line adds Copilot Bridge process visibility, defensive SDK-event normalization, and unknown-event redaction hardening without expanding the provider command surface.
 
 ## 2. Primary Workflows
 
@@ -20,7 +20,7 @@ This release line targets Codex `0.134.0+`. The public contract assumes runtime
 
 ```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
@@ -30,6 +30,7 @@ Intent:
 
 - `init` prepares the `codex-switch` tool home.
 - `add` creates a managed provider record with a target model and provider route identity.
+- Non-interactive runs should pass `--profile` explicitly; TTY mode can prompt for missing required fields.
 - `switch` projects the selected provider into the target Codex runtime.
 - `status` summarizes tool-home, runtime, provider, and health state.
 - `doctor` gives deeper repair-oriented diagnostics.
@@ -39,7 +40,7 @@ Intent:
 ```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
@@ -51,6 +52,7 @@ Important notes:
 - The current implementation prefers the bundled Copilot CLI from the managed runtime and falls back to `PATH` when needed.
 - `login copilot` succeeds only after auth readiness is rechecked.
 - `add --copilot` does not install or log in to Copilot for you.
+- Non-interactive Copilot adds should also pass `--profile` explicitly; TTY mode can still collect missing required fields.
 - Copilot runtime paths require Node.js `>=20`; direct providers remain supported on Node.js `>=18`.
 - The Copilot bridge is experimental and targets simple text-oriented turns through the local OpenAI-compatible bridge.
 
@@ -82,6 +84,7 @@ Copilot bridge projection also writes:
 Compatibility notes:
 
 - `--profile` is accepted as an alias for the managed `model_provider` id.
+- automation should still pass `--profile` explicitly instead of relying on prompts
 - legacy top-level `profile` and `[profiles.*]` may still appear in existing runtime state
 - `migrate`, `config show`, `config list-profiles`, and `doctor` can still inspect those legacy structures
 - new managed runtime projection should be described as route-first, not profile-first
@@ -262,6 +265,7 @@ codexs rollback [backup-id]
 
 - Create or update managed provider records rather than editing runtime files directly.
 - Treat `--profile` only as an alias for the managed `model_provider` id.
+- Require explicit `--profile` in non-interactive usage; allow TTY prompts to fill it when omitted.
 - Clean old `env_key` and `env_key_instructions` fields from managed projection during subsequent switching.
 
 ### `migrate`
@@ -288,7 +292,7 @@ codexs rollback [backup-id]
 - [PRD 0.1.1](./PRD/codex-switch-prd-v0.1.1.md)
 - [PRD 0.1.2](./PRD/codex-switch-prd-v0.1.2.md)
 - [PRD 0.1.3](./PRD/codex-switch-prd-v0.1.3.md)
-- [PRD 0.1.4](./PRD/codex-switch-prd-v0.1.4.md)
+- [PRD 0.1.5](./PRD/codex-switch-prd-v0.1.5.md)
 - [Design 0.1.2](./Design/codex-switch-v0.1.2-design.md)
 - [Design 0.1.3](./Design/codex-switch-v0.1.3-design.md)
-- [Design 0.1.4](./Design/codex-switch-v0.1.4-design.md)
+- [Design 0.1.5](./Design/codex-switch-v0.1.5-design.md)

package/docs/codex-switch-product-overview.md

@@ -4,21 +4,21 @@
 
 这份文档介绍当前活跃产品事实源下的 `codex-switch` 产品定位。
 
-当前仓库开发线 fact source 以这些文档为准：
-
-- [`cli-usage.md`](./cli-usage.md)
-- [`PRD/codex-switch-prd-v0.1.0.md`](./PRD/codex-switch-prd-v0.1.0.md)
-- [`PRD/codex-switch-prd-v0.1.1.md`](./PRD/codex-switch-prd-v0.1.1.md)
-- [`PRD/codex-switch-prd-v0.1.2.md`](./PRD/codex-switch-prd-v0.1.2.md)
-- [`PRD/codex-switch-prd-v0.1.3.md`](./PRD/codex-switch-prd-v0.1.3.md)
-- [`PRD/codex-switch-prd-v0.1.4.md`](./PRD/codex-switch-prd-v0.1.4.md)
-- [`Design/codex-switch-v0.1.2-design.md`](./Design/codex-switch-v0.1.2-design.md)
-- [`Design/codex-switch-v0.1.3-design.md`](./Design/codex-switch-v0.1.3-design.md)
-- [`Design/codex-switch-v0.1.4-design.md`](./Design/codex-switch-v0.1.4-design.md)
+当前仓库开发线 fact source 以这些文档为准：
+
+- [`cli-usage.md`](./cli-usage.md)
+- [`PRD/codex-switch-prd-v0.1.0.md`](./PRD/codex-switch-prd-v0.1.0.md)
+- [`PRD/codex-switch-prd-v0.1.1.md`](./PRD/codex-switch-prd-v0.1.1.md)
+- [`PRD/codex-switch-prd-v0.1.2.md`](./PRD/codex-switch-prd-v0.1.2.md)
+- [`PRD/codex-switch-prd-v0.1.3.md`](./PRD/codex-switch-prd-v0.1.3.md)
+- [`PRD/codex-switch-prd-v0.1.5.md`](./PRD/codex-switch-prd-v0.1.5.md)
+- [`Design/codex-switch-v0.1.2-design.md`](./Design/codex-switch-v0.1.2-design.md)
+- [`Design/codex-switch-v0.1.3-design.md`](./Design/codex-switch-v0.1.3-design.md)
+- [`Design/codex-switch-v0.1.5-design.md`](./Design/codex-switch-v0.1.5-design.md)
 
 ## 产品概述
 
-`codex-switch` 是一个本地 provider 管理 CLI，用于管理和切换目标 Codex runtime 的 provider/model-provider 路由配置，同时把工具自己的管理态保存在独立 tool home 下。
+`codex-switch` 是一个本地 provider 管理 CLI，用于管理和切换目标 Codex runtime 的 provider/model-provider 路由配置，同时把工具自己的管理态保存在独立 tool home 下。
 
 它不是旧 `setup` 小工具，也不是围绕单目录 `~/.codex` 组织全部状态的脚本集合。
 
@@ -54,11 +54,11 @@ target Codex runtime：
 
 ## 核心使用流程
 
-Direct 主路径：
+Direct 主路径：
 
 ```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
@@ -69,7 +69,7 @@ Copilot 主路径：
 ```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
@@ -84,12 +84,13 @@ codexs migrate
 
 ## 当前产品判断
 
-`0.1.1` 的重点不是再加新命令，而是让用户在 README、help 和输出第一屏就能理解：
+`0.1.1` 的重点不是再加新命令，而是让用户在 README、help 和输出第一屏就能理解：
 
-- fresh install 应先走什么
-- Copilot 路径和 direct 路径有什么区别
-- `migrate` 何时才该使用
-- `status` / `doctor` 如何帮助定位下一步
-- 当前运行态是用顶层 `model` 与 `model_provider` 选择活动路由
-
-`0.1.4` 是当前仓库开发线，重点不是扩展 provider 面，而是把已有 Copilot bridge 实验路径变得更稳、更可诊断，并把 release hygiene 拉进真实门禁。当前实现边界仍然是：Copilot 路径要求 Node.js `>=20`，受管安装默认固定到 `@github/copilot-sdk@1.0.2`，本地 bridge 仍然只是面向 simple text-oriented turns 的 experimental bridge；Direct provider 路径继续支持 Node.js `>=18`。
+- fresh install 应先走什么
+- Copilot 路径和 direct 路径有什么区别
+- 非交互命令为什么应显式传 `--profile`，以及 TTY 模式下哪些缺失项可以补问
+- `migrate` 何时才该使用
+- `status` / `doctor` 如何帮助定位下一步
+- 当前运行态是用顶层 `model` 与 `model_provider` 选择活动路由
+
+`0.1.5` 是当前仓库开发线，重点不是扩展 provider 面，而是让已有 Copilot bridge 实验路径具备过程可见性：SDK 事件被归一化为稳定运行态事件，Responses 流可以显示 commentary/reasoning 信号，未知事件摘要会被脱敏和截断。当前实现边界仍然是：Copilot 路径要求 Node.js `>=20`，受管安装默认固定到 `@github/copilot-sdk@1.0.2`，本地 bridge 仍然只是面向 simple text-oriented turns 的 experimental bridge；Direct provider 路径继续支持 Node.js `>=18`。

package/docs/codex-switch-technical-architecture.md

@@ -7,12 +7,12 @@
 - [`PRD/codex-switch-prd-v0.1.1.md`](./PRD/codex-switch-prd-v0.1.1.md)
 - [`PRD/codex-switch-prd-v0.1.2.md`](./PRD/codex-switch-prd-v0.1.2.md)
 - [`PRD/codex-switch-prd-v0.1.3.md`](./PRD/codex-switch-prd-v0.1.3.md)
-- [`PRD/codex-switch-prd-v0.1.4.md`](./PRD/codex-switch-prd-v0.1.4.md)
+- [`PRD/codex-switch-prd-v0.1.5.md`](./PRD/codex-switch-prd-v0.1.5.md)
 - [`Design/codex-switch-v0.1.0-design.md`](./Design/codex-switch-v0.1.0-design.md)
 - [`Design/codex-switch-v0.1.1-design.md`](./Design/codex-switch-v0.1.1-design.md)
 - [`Design/codex-switch-v0.1.2-design.md`](./Design/codex-switch-v0.1.2-design.md)
 - [`Design/codex-switch-v0.1.3-design.md`](./Design/codex-switch-v0.1.3-design.md)
-- [`Design/codex-switch-v0.1.4-design.md`](./Design/codex-switch-v0.1.4-design.md)
+- [`Design/codex-switch-v0.1.5-design.md`](./Design/codex-switch-v0.1.5-design.md)
 
 ## Layers
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@minniexcode/codex-switch",
-  "version": "0.1.4",
-  "description": "Local-first CLI for managing and switching Codex provider/model-provider routing.",
+  "version": "0.1.5",
+  "description": "Local-first CLI for managing and switching Codex provider/model-provider routing.",
   "license": "MIT",
   "type": "commonjs",
   "bin": {