@gajae-code/coding-agent 0.10.1 → 0.11.0

package/src/modes/shared/agent-wire/deep-interview-gate.ts

@@ -7,12 +7,11 @@
  * back into the exact QuestionResult shape the human path produces, so ambiguity
  * scoring/state updates proceed identically whether a human or an agent answers.
  *
- * This is the pure mapping primitive. Routing the ask tool through it (instead of
- * the interactive select/editor UI) when an unattended controller + gate broker
- * are attached is wired with the transport in #321 and exercised by #323.
+ * This is the pure mapping primitive used by SDK-native workflow gate emitters.
  */
-import type { RpcJsonSchema, RpcWorkflowGateKind, RpcWorkflowStage } from "../../rpc/rpc-types";
+
 import type { OpenGateInput } from "./workflow-gate-broker";
+import type { JsonSchema, WorkflowGateKind, WorkflowStage } from "./workflow-gate-types";
 
 /** "Other (type your own)" sentinel, mirroring the interactive ask tool. */
 export const GATE_OTHER_OPTION = "Other (type your own)";
@@ -27,8 +26,8 @@ export interface AskGateDeepInterviewState {
 }
 
 export interface AskGateWorkflowGateMeta {
-	stage: RpcWorkflowStage;
-	kind: RpcWorkflowGateKind;
+	stage: WorkflowStage;
+	kind: WorkflowGateKind;
 }
 
 export interface AskGateQuestion {
@@ -115,16 +114,16 @@ function deepInterviewQuestionState(questionText: string): Record<string, unknow
 	return state;
 }
 
-function questionAnswerSchema(question: AskGateQuestion, labels: string[]): RpcJsonSchema {
+function questionAnswerSchema(question: AskGateQuestion, labels: string[]): JsonSchema {
 	const multi = question.multi ?? false;
-	const selectedItems: RpcJsonSchema = { type: "string", enum: labels };
-	const selectedBase: RpcJsonSchema = { type: "array", items: selectedItems, uniqueItems: true };
-	const selectedOnly: RpcJsonSchema = {
+	const selectedItems: JsonSchema = { type: "string", enum: labels };
+	const selectedBase: JsonSchema = { type: "array", items: selectedItems, uniqueItems: true };
+	const selectedOnly: JsonSchema = {
 		...selectedBase,
 		minItems: question.allowEmpty ? 0 : 1,
 		...(multi ? {} : { maxItems: 1 }),
 	};
-	const selectedWithOther: RpcJsonSchema = {
+	const selectedWithOther: JsonSchema = {
 		...selectedBase,
 		...(multi ? {} : { maxItems: 0 }),
 	};

package/src/modes/shared/agent-wire/event-contract.ts

@@ -3,8 +3,8 @@
  * for AgentSession events and bounded owner observations.
  *
  * Two distinct consumer-facing shapes, deliberately NOT collapsed into one:
- * - `AgentWireEventPayload`: rich, full `AgentSessionEvent` for renderers
- *   (ACP SDK notifications, RPC/Bridge event frames).
+ * - `AgentWireEventPayload`: rich, full `AgentSessionEvent` for event
+ *   consumers on any agent-wire transport.
  * - `AgentWireOwnerObservation`: bounded/redacted owner evidence for control
  *   planes (Harness). Never carries assistant text, message deltas, raw tool
  *   args, raw command output, raw tool results, answers, or oversize strings.
@@ -45,14 +45,13 @@ const AGENT_SESSION_EVENT_TYPE_REGISTRY: Record<AgentWireEventType, true> = {
 	auto_compaction_end: true,
 	auto_retry_start: true,
 	auto_retry_end: true,
-	retry_fallback_applied: true,
-	retry_fallback_succeeded: true,
 	ttsr_triggered: true,
 	todo_reminder: true,
 	todo_auto_clear: true,
 	irc_message: true,
 	subagent_steer_message: true,
 	notice: true,
+	model_fallback_switched: true,
 	thinking_level_changed: true,
 	goal_updated: true,
 };
@@ -63,8 +62,8 @@ export const AGENT_WIRE_EVENT_TYPES: readonly AgentWireEventType[] = Object.keys
 ) as AgentWireEventType[];
 
 /**
- * Rich event payload. Carries the full `AgentSessionEvent` so renderers (ACP,
- * RPC, Bridge) can present message content, tool args/results, todo state, etc.
+ * Rich event payload. Carries the full `AgentSessionEvent` so event consumers
+ * can present message content, tool args/results, todo state, and related data.
  */
 export interface AgentWireEventPayload {
 	event_type: AgentWireEventType;
@@ -78,7 +77,7 @@ export type AgentWireCompactAssistantMessageEvent = AssistantMessageEvent extend
 
 export interface AgentWireCompactMessageUpdatePayload {
 	event_type: "message_update";
-	/** Compact RPC opt-in payload: delta-only update plus minimal routing metadata. */
+	/** Compact opt-in payload: delta-only update plus minimal routing metadata. */
 	compact: true;
 	message_id: string | null;
 	content_index: number | null;
@@ -120,7 +119,7 @@ export interface AgentWireOwnerObservation {
 	eventType?: AgentWireEventType;
 	/** Set when this observation derives from a non-event wire frame. */
 	frameType?: string;
-	/** Owner event kind (e.g. `rpc_tool_started`). */
+	/** Owner event kind (for example, a tool-started observation). */
 	kind: string;
 	/** Bounded observed signal, or null when the frame carries no signal. */
 	signal: AgentWireObservedSignal | null;

package/src/modes/shared/agent-wire/event-envelope.ts

@@ -5,8 +5,8 @@
  * every variant of the event union and calls `assertNever` in the default arm,
  * so a newly added event variant fails to compile until it is handled here.
  *
- * The canonical sequencer + frame builders live here; the historical `Bridge*`
- * names are retained as thin aliases for callers that have not yet migrated.
+ * The canonical sequencer + frame builders live here under `AgentWire*` names;
+ * this is the only event-frame surface (the historical `Bridge*` aliases were removed).
  */
 import { randomUUID } from "node:crypto";
 import type { AgentSessionEvent } from "../../../session/agent-session";
@@ -67,14 +67,13 @@ export function agentSessionEventType(event: AgentSessionEvent): AgentWireEventT
 		case "auto_compaction_end":
 		case "auto_retry_start":
 		case "auto_retry_end":
-		case "retry_fallback_applied":
-		case "retry_fallback_succeeded":
 		case "ttsr_triggered":
 		case "todo_reminder":
 		case "todo_auto_clear":
 		case "irc_message":
 		case "subagent_steer_message":
 		case "notice":
+		case "model_fallback_switched":
 		case "thinking_level_changed":
 		case "goal_updated":
 			return event.type;
@@ -127,10 +126,6 @@ export class AgentWireFrameSequencer {
 	}
 }
 
-/** Back-compat alias for {@link AgentWireFrameSequencer}. */
-export const BridgeFrameSequencer = AgentWireFrameSequencer;
-export type BridgeFrameSequencer = AgentWireFrameSequencer;
-
 /** Serialize a single `AgentSessionEvent` into a canonical `event` wire frame. */
 export function toAgentWireEventFrame(
 	event: AgentSessionEvent,
@@ -163,13 +158,13 @@ export interface AgentWireCompactMessageUpdateOptions {
 }
 
 /**
- * Stateful compact event serializer for opt-in RPC clients.
+ * Stateful compact event serializer for opt-in wire clients (e.g. the SDK).
  *
  * Only `message_update` changes shape: it carries the immutable provider delta
  * plus message/content identifiers, with periodic full-message checkpoints that
  * are cloned synchronously before the caller returns to the event loop. All other
- * event variants remain canonical full event frames so legacy bridge/RPC behavior
- * and terminal `message_end` reconstruction are unchanged.
+ * event variants remain canonical full event frames so downstream consumers and
+ * terminal `message_end` reconstruction are unchanged.
  */
 export class AgentWireCompactEventEncoder {
 	readonly #sequencer: AgentWireFrameSequencer;
@@ -206,18 +201,15 @@ export function toAgentWireCompactEventFrame(
 	return encoder.frame(event);
 }
 
-/** Back-compat alias for {@link toAgentWireEventFrame}. */
-export const toBridgeEventFrame = toAgentWireEventFrame;
-
 /**
  * Serialize a `workflow_gate` event into a sequenced wire frame (#321). The
  * gate_id is stamped as the correlation id so the answer (posted to the
  * ui-responses endpoint) can be matched, and the monotonic `seq` gives replay
  * while `frame_id` + gate_id give idempotency.
  */
-export function toBridgeWorkflowGateFrame(
-	gate: import("../../rpc/rpc-types").RpcWorkflowGate,
+export function toAgentWireWorkflowGateFrame(
+	gate: import("./workflow-gate-types").WorkflowGate,
 	sequencer: AgentWireFrameSequencer,
-): import("./protocol").BridgeWorkflowGateFrame {
+): AgentWireFrameEnvelope<"workflow_gate", import("./workflow-gate-types").WorkflowGate> {
 	return sequencer.next("workflow_gate", gate, gate.gate_id);
 }

package/src/modes/shared/agent-wire/event-observation.ts

@@ -197,14 +197,23 @@ export function observeAgentSessionEvent(event: AgentSessionEvent): AgentWireOwn
 				semantic: false,
 				coalesceKey: null,
 			});
-		case "retry_fallback_applied":
-		case "retry_fallback_succeeded":
+		case "model_fallback_switched":
 			return obs(event, {
-				kind: "rpc_retry_fallback",
+				kind: "rpc_model_fallback_switched",
 				signal: null,
-				evidence: { phase: event.type, role: str(event.role) ?? null },
-				severity: "warn",
-				semantic: false,
+				evidence: {
+					eventId: str(event.eventId) ?? null,
+					from: str(event.from) ?? null,
+					to: str(event.to) ?? null,
+					reason: str(event.reason) ?? null,
+					role: str(event.role) ?? null,
+					scope: str(event.scope) ?? null,
+					activeIndex: num(event.activeIndex) ?? null,
+					chainLength: num(event.chainLength) ?? null,
+					attemptsUsed: num(event.attemptsUsed) ?? null,
+				},
+				severity: "info",
+				semantic: true,
 				coalesceKey: null,
 			});
 		case "ttsr_triggered":
@@ -320,7 +329,7 @@ function ownerFrame(
  * frames delegate to {@link observeAgentWireEventPayload}; non-event frames are
  * mapped here so owners never re-parse protocol semantics privately.
  */
-export function observeRpcOutboundFrame(frame: Record<string, unknown>): AgentWireOwnerObservation | null {
+export function observeAgentWireFrame(frame: Record<string, unknown>): AgentWireOwnerObservation | null {
 	const type = str(frame.type);
 	if (!type || type === "ready") return null;