@codeam/shared 2.62.1 → 2.63.0

package/dist/index.d.mts

@@ -1713,6 +1713,67 @@ interface HeadroomUsageResult {
 /** Relay command type for pulling the token-usage report. */
 declare const HEADROOM_USAGE_COMMAND = "headroom_usage";
 
+/**
+ * Session agent switch — wire types for the `switch_agent` relay command and
+ * its progress/status SSE events.
+ *
+ * A live session can swap its coding agent (e.g. claude → codex) in-process:
+ * mobile sends `switch_agent { agentId }` over the command relay; the CLI
+ * pulls the vaulted credential (+ install script when the binary is missing),
+ * restarts the ACP client on the new adapter, and reports progress via
+ * `POST /api/agent-switch/events` → the per-user SSE bus
+ * (`switch_agent_progress` / `switch_agent_status`).
+ *
+ * CANONICAL WIRE OWNER: this file (`@codeam/shared`), per the cross-repo
+ * rule. The backend/mobile repo consumes it through the published package.
+ *
+ * Continuity contract: the conversation does NOT resume cross-agent (ACP
+ * `session/load` ids are per-agent). Instead the CLI captures a bounded tail
+ * of the prior conversation and prefixes it to the first post-switch prompt
+ * (the "context handoff"), so the new agent continues with the session's
+ * context in a fresh conversation.
+ */
+/** Relay command type mobile sends to switch the session's agent. */
+declare const SWITCH_AGENT_COMMAND = "switch_agent";
+/** Payload of the `switch_agent` relay command. */
+interface SwitchAgentCommand {
+    /** Public agent id to switch to (catalog id, e.g. 'codex'). */
+    agentId: string;
+}
+/**
+ * Install-progress milestone emitted on the `switch_agent_progress` SSE event
+ * while a switch is running. Must stay aligned with the backend's validator
+ * (`apps/api-v2/src/agent-switch/agent-switch.controller.ts`) and the mobile
+ * store — the backend 400s on any value outside this set.
+ *
+ * - `credential` — fetching + writing the vaulted credential for the target.
+ * - `install`    — target binary missing; running its install script.
+ * - `restart`    — old client stopped; new adapter starting (`session/new`).
+ */
+type SwitchAgentStep = 'credential' | 'install' | 'restart';
+/**
+ * Terminal/steady switch state — carried on `switch_agent_status` and used by
+ * mobile to flip the session's agent chip (`ready`) or render an actionable
+ * error (`error`). `switching` is published once up-front so other paired
+ * devices see the transition too.
+ */
+interface SwitchAgentStatus {
+    state: 'switching' | 'ready' | 'error';
+    /** Target public agent id of the switch. */
+    agentId: string;
+    /** Public agent id that was running before the switch was attempted. */
+    fromAgentId?: string;
+    /** Human-readable reason when `state === 'error'`. */
+    error?: string;
+}
+/** Result payload the CLI acks the `switch_agent` command with. */
+interface SwitchAgentResult {
+    ok: boolean;
+    agentId: string;
+    /** Set when `ok === false`. */
+    error?: string;
+}
+
 /**
  * Headroom provisioning manifest — the SINGLE source of truth for what a
  * Headroom install consists of, rendered by every provisioning surface:
@@ -1883,6 +1944,8 @@ declare const USER_EVENTS: {
     readonly CODERABBIT_PROGRESS: "coderabbit_progress";
     readonly CODERABBIT_STATUS: "coderabbit_status";
     readonly CODERABBIT_REVIEW: "coderabbit_review";
+    readonly SWITCH_AGENT_PROGRESS: "switch_agent_progress";
+    readonly SWITCH_AGENT_STATUS: "switch_agent_status";
     readonly VCS_AGENT_REVIEW_COMPLETE: "vcs_agent_review_complete";
     /** PR-review launch progress toast — the "Review with an agent" flow shows a
      *  toast when the review runs server-side (Inngest). Mobile-only surface,
@@ -1909,4 +1972,4 @@ type UserEventName = (typeof USER_EVENTS)[keyof typeof USER_EVENTS];
  */
 declare const PREVIEW_DETECT_PROMPT: string;
 
-export { AGENT_REGISTRY, AGENT_STANDARD_BLOCK, AGENT_STANDARD_MARKER, AGENT_STANDARD_TEXT, type AgentAuth, type AgentAuthKind, type AgentId, type AgentMetadata, type AgentMode, type AgentModel, type AgentReviewFinding, type AgentReviewPlan, type AgentReviewReport, type AnswerResolvedEvent, type AwaitingAnswerEvent, type BeadsActionCommand, type BeadsActionKind, type BeadsActionPayload, type BeadsActionRequest, type BeadsActionType, type BeadsConfigureAction, type BeadsDependencyDto, type BeadsDependencyKind, type BeadsIngestPayload, type BeadsIssueDto, type BeadsIssueStatus, type BeadsMemoryDto, type BeadsProjectDto, type BeadsProvisioningPayload, type BeadsProvisioningStatus, type BeadsSnapshotDto, type BeadsStatus, type BeadsStatusState, type BeadsStatusSummary, type BlameLineWire, type BrokeredIntegrationToken, CODER_PROMPT, type ChromeStep, type ChromeToolType, type CommitEntryWire, DEFAULT_API_BASE_URL, DEFAULT_GUARDRAIL_POLICY, DEP_TO_INTEGRATION, DEV_API_BASE_URL, type DerivedCredentialSource, type EnvVar, type FileBlameEvent, type FileChangeStatus, type FileChangedEvent, type FileHistoryEvent, type FileReviewStatus, GUARDRAIL_CATEGORIES, GUARDRAIL_CATEGORY_META, GUARDRAIL_CONFIGURE_COMMAND, GUARDRAIL_DISPOSITIONS, type GuardrailCategory, type GuardrailCategoryMeta, type GuardrailDisposition, type GuardrailPolicy, HEADROOM_BACKEND_ENV, HEADROOM_EXTRAS_BY_SURFACE, HEADROOM_MODELS, HEADROOM_PIP_COMPANIONS, HEADROOM_PROXY_PORT, HEADROOM_USAGE_COMMAND, HEARTBEAT_INTERVAL_MS_DEFAULT, HOUSE_AGENT_ID, HOUSE_AGENT_NAME, HOUSE_AGENT_PROVIDER, HOUSE_AGENT_SUBTITLE, HOUSE_AGENT_VENDOR, type HeadroomBudgetCommand, type HeadroomBudgetPeriod, type HeadroomBudgetUsage, type HeadroomKind, type HeadroomModelSpec, type HeadroomPythonRenderOpts, type HeadroomStatus, type HeadroomStep, type HeadroomSurface, type HeadroomUsageBucket, type HeadroomUsageGranularity, type HeadroomUsageReport, type HeadroomUsageResult, type HeadroomUsageSlice, type HeadroomUsageTotals, type HunkLineType, INTEGRATION_BRANDING, INTEGRATION_REGISTRY, INTERNAL_TO_PUBLIC, type InputSuggestionChunk, type IntegrationApiKeyField, type IntegrationAuthKind, type IntegrationBranding, type IntegrationCategory, type IntegrationDefinition, type IntegrationDelivery, type IntegrationHealth, type IntegrationId, type IntegrationMcpDelivery, type IntegrationStatus, type IntegrationsManifest, type IntegrationsManifestEntry, LINKED_AGENT_IDS, type LinkedAgentId, MODEL_CONTEXT_WINDOW, MODEL_PRICING, type ModelPricing, type NormalizedMessage, OBSERVER_BRIDGE_PORT, PACK_ACTION_COMMAND, PACK_REGISTRY, PACK_START_COMMAND, PACK_STATUS_COMMAND, PACK_WORKFLOW_ARTICLE, PREVIEW_DETECT_PROMPT, PROTOCOL_VERSION, PUBLIC_TO_INTERNAL, type PackActionKind, type PackActionPayload, type PackDefinition, type PackHandoffRecord, type PackId, type PackRunState, type PackRunStatus, type PackStageDef, type PackStageState, type PackStageStatus, type PackStartPayload, type PendingReviewHunkEvent, type PendingReviewHunkLine, type PrCheck, type PrRef, type PrReviewEntry, type PrReviewVerdict, type PreviewDetection, type PreviewErrorStage, type PreviewState, type PreviewStatus, type PullRequestDetail, type PullRequestSummary, QA_PROMPT, REVIEWER_PROMPT, type RemoteCommand, type RepoStack, type RepoStackDetection, SKILL_REGISTRY, SPECIFIER_PROMPT, SSE_SOCKET_TIMEOUT_MS, STACK_TO_RECOMMENDED, type SelectPrompt, type SkillDefinition, type SkillDelivery, type SkillFileDelivery, type SkillId, type SkillRail, type SkillsManifest, type SkillsManifestEntry, type StreamingChunkEvent, type StreamingChunkKind, TERMINAL_AGENT_PREFIX, UNKNOWN_MODEL_PRICING, UPCOMING_INTEGRATION_IDS, USER_EVENTS, type UserEventName, classifyStack, detectedIntegrationsFromDeps, getAgent, getContextWindow, getEnabledAgents, getEnabledIntegrations, getIntegration, getIntegrationBranding, getIntegrationsByCategory, getPackDefinition, getPricing, getSkillDefinition, headroomKindFor, headroomModelPredownloadScript, headroomPipPackage, headroomSnapshotDownloadLine, internalToPublic, isGuardrailDisposition, isHeadroomWrappable, isKnownAgentId, isKnownIntegrationId, isKnownModel, isLinkedAgentId, isPackId, isSkillId, normalizeAgentId, normalizeGuardrailPolicy, publicToInternal, recommendForDeps, renderToLines, resolveApiBaseUrl, skillHasRail, toRemoteCommand, tryGetContextWindow };
+export { AGENT_REGISTRY, AGENT_STANDARD_BLOCK, AGENT_STANDARD_MARKER, AGENT_STANDARD_TEXT, type AgentAuth, type AgentAuthKind, type AgentId, type AgentMetadata, type AgentMode, type AgentModel, type AgentReviewFinding, type AgentReviewPlan, type AgentReviewReport, type AnswerResolvedEvent, type AwaitingAnswerEvent, type BeadsActionCommand, type BeadsActionKind, type BeadsActionPayload, type BeadsActionRequest, type BeadsActionType, type BeadsConfigureAction, type BeadsDependencyDto, type BeadsDependencyKind, type BeadsIngestPayload, type BeadsIssueDto, type BeadsIssueStatus, type BeadsMemoryDto, type BeadsProjectDto, type BeadsProvisioningPayload, type BeadsProvisioningStatus, type BeadsSnapshotDto, type BeadsStatus, type BeadsStatusState, type BeadsStatusSummary, type BlameLineWire, type BrokeredIntegrationToken, CODER_PROMPT, type ChromeStep, type ChromeToolType, type CommitEntryWire, DEFAULT_API_BASE_URL, DEFAULT_GUARDRAIL_POLICY, DEP_TO_INTEGRATION, DEV_API_BASE_URL, type DerivedCredentialSource, type EnvVar, type FileBlameEvent, type FileChangeStatus, type FileChangedEvent, type FileHistoryEvent, type FileReviewStatus, GUARDRAIL_CATEGORIES, GUARDRAIL_CATEGORY_META, GUARDRAIL_CONFIGURE_COMMAND, GUARDRAIL_DISPOSITIONS, type GuardrailCategory, type GuardrailCategoryMeta, type GuardrailDisposition, type GuardrailPolicy, HEADROOM_BACKEND_ENV, HEADROOM_EXTRAS_BY_SURFACE, HEADROOM_MODELS, HEADROOM_PIP_COMPANIONS, HEADROOM_PROXY_PORT, HEADROOM_USAGE_COMMAND, HEARTBEAT_INTERVAL_MS_DEFAULT, HOUSE_AGENT_ID, HOUSE_AGENT_NAME, HOUSE_AGENT_PROVIDER, HOUSE_AGENT_SUBTITLE, HOUSE_AGENT_VENDOR, type HeadroomBudgetCommand, type HeadroomBudgetPeriod, type HeadroomBudgetUsage, type HeadroomKind, type HeadroomModelSpec, type HeadroomPythonRenderOpts, type HeadroomStatus, type HeadroomStep, type HeadroomSurface, type HeadroomUsageBucket, type HeadroomUsageGranularity, type HeadroomUsageReport, type HeadroomUsageResult, type HeadroomUsageSlice, type HeadroomUsageTotals, type HunkLineType, INTEGRATION_BRANDING, INTEGRATION_REGISTRY, INTERNAL_TO_PUBLIC, type InputSuggestionChunk, type IntegrationApiKeyField, type IntegrationAuthKind, type IntegrationBranding, type IntegrationCategory, type IntegrationDefinition, type IntegrationDelivery, type IntegrationHealth, type IntegrationId, type IntegrationMcpDelivery, type IntegrationStatus, type IntegrationsManifest, type IntegrationsManifestEntry, LINKED_AGENT_IDS, type LinkedAgentId, MODEL_CONTEXT_WINDOW, MODEL_PRICING, type ModelPricing, type NormalizedMessage, OBSERVER_BRIDGE_PORT, PACK_ACTION_COMMAND, PACK_REGISTRY, PACK_START_COMMAND, PACK_STATUS_COMMAND, PACK_WORKFLOW_ARTICLE, PREVIEW_DETECT_PROMPT, PROTOCOL_VERSION, PUBLIC_TO_INTERNAL, type PackActionKind, type PackActionPayload, type PackDefinition, type PackHandoffRecord, type PackId, type PackRunState, type PackRunStatus, type PackStageDef, type PackStageState, type PackStageStatus, type PackStartPayload, type PendingReviewHunkEvent, type PendingReviewHunkLine, type PrCheck, type PrRef, type PrReviewEntry, type PrReviewVerdict, type PreviewDetection, type PreviewErrorStage, type PreviewState, type PreviewStatus, type PullRequestDetail, type PullRequestSummary, QA_PROMPT, REVIEWER_PROMPT, type RemoteCommand, type RepoStack, type RepoStackDetection, SKILL_REGISTRY, SPECIFIER_PROMPT, SSE_SOCKET_TIMEOUT_MS, STACK_TO_RECOMMENDED, SWITCH_AGENT_COMMAND, type SelectPrompt, type SkillDefinition, type SkillDelivery, type SkillFileDelivery, type SkillId, type SkillRail, type SkillsManifest, type SkillsManifestEntry, type StreamingChunkEvent, type StreamingChunkKind, type SwitchAgentCommand, type SwitchAgentResult, type SwitchAgentStatus, type SwitchAgentStep, TERMINAL_AGENT_PREFIX, UNKNOWN_MODEL_PRICING, UPCOMING_INTEGRATION_IDS, USER_EVENTS, type UserEventName, classifyStack, detectedIntegrationsFromDeps, getAgent, getContextWindow, getEnabledAgents, getEnabledIntegrations, getIntegration, getIntegrationBranding, getIntegrationsByCategory, getPackDefinition, getPricing, getSkillDefinition, headroomKindFor, headroomModelPredownloadScript, headroomPipPackage, headroomSnapshotDownloadLine, internalToPublic, isGuardrailDisposition, isHeadroomWrappable, isKnownAgentId, isKnownIntegrationId, isKnownModel, isLinkedAgentId, isPackId, isSkillId, normalizeAgentId, normalizeGuardrailPolicy, publicToInternal, recommendForDeps, renderToLines, resolveApiBaseUrl, skillHasRail, toRemoteCommand, tryGetContextWindow };

package/dist/index.d.ts

@@ -1713,6 +1713,67 @@ interface HeadroomUsageResult {
 /** Relay command type for pulling the token-usage report. */
 declare const HEADROOM_USAGE_COMMAND = "headroom_usage";
 
+/**
+ * Session agent switch — wire types for the `switch_agent` relay command and
+ * its progress/status SSE events.
+ *
+ * A live session can swap its coding agent (e.g. claude → codex) in-process:
+ * mobile sends `switch_agent { agentId }` over the command relay; the CLI
+ * pulls the vaulted credential (+ install script when the binary is missing),
+ * restarts the ACP client on the new adapter, and reports progress via
+ * `POST /api/agent-switch/events` → the per-user SSE bus
+ * (`switch_agent_progress` / `switch_agent_status`).
+ *
+ * CANONICAL WIRE OWNER: this file (`@codeam/shared`), per the cross-repo
+ * rule. The backend/mobile repo consumes it through the published package.
+ *
+ * Continuity contract: the conversation does NOT resume cross-agent (ACP
+ * `session/load` ids are per-agent). Instead the CLI captures a bounded tail
+ * of the prior conversation and prefixes it to the first post-switch prompt
+ * (the "context handoff"), so the new agent continues with the session's
+ * context in a fresh conversation.
+ */
+/** Relay command type mobile sends to switch the session's agent. */
+declare const SWITCH_AGENT_COMMAND = "switch_agent";
+/** Payload of the `switch_agent` relay command. */
+interface SwitchAgentCommand {
+    /** Public agent id to switch to (catalog id, e.g. 'codex'). */
+    agentId: string;
+}
+/**
+ * Install-progress milestone emitted on the `switch_agent_progress` SSE event
+ * while a switch is running. Must stay aligned with the backend's validator
+ * (`apps/api-v2/src/agent-switch/agent-switch.controller.ts`) and the mobile
+ * store — the backend 400s on any value outside this set.
+ *
+ * - `credential` — fetching + writing the vaulted credential for the target.
+ * - `install`    — target binary missing; running its install script.
+ * - `restart`    — old client stopped; new adapter starting (`session/new`).
+ */
+type SwitchAgentStep = 'credential' | 'install' | 'restart';
+/**
+ * Terminal/steady switch state — carried on `switch_agent_status` and used by
+ * mobile to flip the session's agent chip (`ready`) or render an actionable
+ * error (`error`). `switching` is published once up-front so other paired
+ * devices see the transition too.
+ */
+interface SwitchAgentStatus {
+    state: 'switching' | 'ready' | 'error';
+    /** Target public agent id of the switch. */
+    agentId: string;
+    /** Public agent id that was running before the switch was attempted. */
+    fromAgentId?: string;
+    /** Human-readable reason when `state === 'error'`. */
+    error?: string;
+}
+/** Result payload the CLI acks the `switch_agent` command with. */
+interface SwitchAgentResult {
+    ok: boolean;
+    agentId: string;
+    /** Set when `ok === false`. */
+    error?: string;
+}
+
 /**
  * Headroom provisioning manifest — the SINGLE source of truth for what a
  * Headroom install consists of, rendered by every provisioning surface:
@@ -1883,6 +1944,8 @@ declare const USER_EVENTS: {
     readonly CODERABBIT_PROGRESS: "coderabbit_progress";
     readonly CODERABBIT_STATUS: "coderabbit_status";
     readonly CODERABBIT_REVIEW: "coderabbit_review";
+    readonly SWITCH_AGENT_PROGRESS: "switch_agent_progress";
+    readonly SWITCH_AGENT_STATUS: "switch_agent_status";
     readonly VCS_AGENT_REVIEW_COMPLETE: "vcs_agent_review_complete";
     /** PR-review launch progress toast — the "Review with an agent" flow shows a
      *  toast when the review runs server-side (Inngest). Mobile-only surface,
@@ -1909,4 +1972,4 @@ type UserEventName = (typeof USER_EVENTS)[keyof typeof USER_EVENTS];
  */
 declare const PREVIEW_DETECT_PROMPT: string;
 
-export { AGENT_REGISTRY, AGENT_STANDARD_BLOCK, AGENT_STANDARD_MARKER, AGENT_STANDARD_TEXT, type AgentAuth, type AgentAuthKind, type AgentId, type AgentMetadata, type AgentMode, type AgentModel, type AgentReviewFinding, type AgentReviewPlan, type AgentReviewReport, type AnswerResolvedEvent, type AwaitingAnswerEvent, type BeadsActionCommand, type BeadsActionKind, type BeadsActionPayload, type BeadsActionRequest, type BeadsActionType, type BeadsConfigureAction, type BeadsDependencyDto, type BeadsDependencyKind, type BeadsIngestPayload, type BeadsIssueDto, type BeadsIssueStatus, type BeadsMemoryDto, type BeadsProjectDto, type BeadsProvisioningPayload, type BeadsProvisioningStatus, type BeadsSnapshotDto, type BeadsStatus, type BeadsStatusState, type BeadsStatusSummary, type BlameLineWire, type BrokeredIntegrationToken, CODER_PROMPT, type ChromeStep, type ChromeToolType, type CommitEntryWire, DEFAULT_API_BASE_URL, DEFAULT_GUARDRAIL_POLICY, DEP_TO_INTEGRATION, DEV_API_BASE_URL, type DerivedCredentialSource, type EnvVar, type FileBlameEvent, type FileChangeStatus, type FileChangedEvent, type FileHistoryEvent, type FileReviewStatus, GUARDRAIL_CATEGORIES, GUARDRAIL_CATEGORY_META, GUARDRAIL_CONFIGURE_COMMAND, GUARDRAIL_DISPOSITIONS, type GuardrailCategory, type GuardrailCategoryMeta, type GuardrailDisposition, type GuardrailPolicy, HEADROOM_BACKEND_ENV, HEADROOM_EXTRAS_BY_SURFACE, HEADROOM_MODELS, HEADROOM_PIP_COMPANIONS, HEADROOM_PROXY_PORT, HEADROOM_USAGE_COMMAND, HEARTBEAT_INTERVAL_MS_DEFAULT, HOUSE_AGENT_ID, HOUSE_AGENT_NAME, HOUSE_AGENT_PROVIDER, HOUSE_AGENT_SUBTITLE, HOUSE_AGENT_VENDOR, type HeadroomBudgetCommand, type HeadroomBudgetPeriod, type HeadroomBudgetUsage, type HeadroomKind, type HeadroomModelSpec, type HeadroomPythonRenderOpts, type HeadroomStatus, type HeadroomStep, type HeadroomSurface, type HeadroomUsageBucket, type HeadroomUsageGranularity, type HeadroomUsageReport, type HeadroomUsageResult, type HeadroomUsageSlice, type HeadroomUsageTotals, type HunkLineType, INTEGRATION_BRANDING, INTEGRATION_REGISTRY, INTERNAL_TO_PUBLIC, type InputSuggestionChunk, type IntegrationApiKeyField, type IntegrationAuthKind, type IntegrationBranding, type IntegrationCategory, type IntegrationDefinition, type IntegrationDelivery, type IntegrationHealth, type IntegrationId, type IntegrationMcpDelivery, type IntegrationStatus, type IntegrationsManifest, type IntegrationsManifestEntry, LINKED_AGENT_IDS, type LinkedAgentId, MODEL_CONTEXT_WINDOW, MODEL_PRICING, type ModelPricing, type NormalizedMessage, OBSERVER_BRIDGE_PORT, PACK_ACTION_COMMAND, PACK_REGISTRY, PACK_START_COMMAND, PACK_STATUS_COMMAND, PACK_WORKFLOW_ARTICLE, PREVIEW_DETECT_PROMPT, PROTOCOL_VERSION, PUBLIC_TO_INTERNAL, type PackActionKind, type PackActionPayload, type PackDefinition, type PackHandoffRecord, type PackId, type PackRunState, type PackRunStatus, type PackStageDef, type PackStageState, type PackStageStatus, type PackStartPayload, type PendingReviewHunkEvent, type PendingReviewHunkLine, type PrCheck, type PrRef, type PrReviewEntry, type PrReviewVerdict, type PreviewDetection, type PreviewErrorStage, type PreviewState, type PreviewStatus, type PullRequestDetail, type PullRequestSummary, QA_PROMPT, REVIEWER_PROMPT, type RemoteCommand, type RepoStack, type RepoStackDetection, SKILL_REGISTRY, SPECIFIER_PROMPT, SSE_SOCKET_TIMEOUT_MS, STACK_TO_RECOMMENDED, type SelectPrompt, type SkillDefinition, type SkillDelivery, type SkillFileDelivery, type SkillId, type SkillRail, type SkillsManifest, type SkillsManifestEntry, type StreamingChunkEvent, type StreamingChunkKind, TERMINAL_AGENT_PREFIX, UNKNOWN_MODEL_PRICING, UPCOMING_INTEGRATION_IDS, USER_EVENTS, type UserEventName, classifyStack, detectedIntegrationsFromDeps, getAgent, getContextWindow, getEnabledAgents, getEnabledIntegrations, getIntegration, getIntegrationBranding, getIntegrationsByCategory, getPackDefinition, getPricing, getSkillDefinition, headroomKindFor, headroomModelPredownloadScript, headroomPipPackage, headroomSnapshotDownloadLine, internalToPublic, isGuardrailDisposition, isHeadroomWrappable, isKnownAgentId, isKnownIntegrationId, isKnownModel, isLinkedAgentId, isPackId, isSkillId, normalizeAgentId, normalizeGuardrailPolicy, publicToInternal, recommendForDeps, renderToLines, resolveApiBaseUrl, skillHasRail, toRemoteCommand, tryGetContextWindow };
+export { AGENT_REGISTRY, AGENT_STANDARD_BLOCK, AGENT_STANDARD_MARKER, AGENT_STANDARD_TEXT, type AgentAuth, type AgentAuthKind, type AgentId, type AgentMetadata, type AgentMode, type AgentModel, type AgentReviewFinding, type AgentReviewPlan, type AgentReviewReport, type AnswerResolvedEvent, type AwaitingAnswerEvent, type BeadsActionCommand, type BeadsActionKind, type BeadsActionPayload, type BeadsActionRequest, type BeadsActionType, type BeadsConfigureAction, type BeadsDependencyDto, type BeadsDependencyKind, type BeadsIngestPayload, type BeadsIssueDto, type BeadsIssueStatus, type BeadsMemoryDto, type BeadsProjectDto, type BeadsProvisioningPayload, type BeadsProvisioningStatus, type BeadsSnapshotDto, type BeadsStatus, type BeadsStatusState, type BeadsStatusSummary, type BlameLineWire, type BrokeredIntegrationToken, CODER_PROMPT, type ChromeStep, type ChromeToolType, type CommitEntryWire, DEFAULT_API_BASE_URL, DEFAULT_GUARDRAIL_POLICY, DEP_TO_INTEGRATION, DEV_API_BASE_URL, type DerivedCredentialSource, type EnvVar, type FileBlameEvent, type FileChangeStatus, type FileChangedEvent, type FileHistoryEvent, type FileReviewStatus, GUARDRAIL_CATEGORIES, GUARDRAIL_CATEGORY_META, GUARDRAIL_CONFIGURE_COMMAND, GUARDRAIL_DISPOSITIONS, type GuardrailCategory, type GuardrailCategoryMeta, type GuardrailDisposition, type GuardrailPolicy, HEADROOM_BACKEND_ENV, HEADROOM_EXTRAS_BY_SURFACE, HEADROOM_MODELS, HEADROOM_PIP_COMPANIONS, HEADROOM_PROXY_PORT, HEADROOM_USAGE_COMMAND, HEARTBEAT_INTERVAL_MS_DEFAULT, HOUSE_AGENT_ID, HOUSE_AGENT_NAME, HOUSE_AGENT_PROVIDER, HOUSE_AGENT_SUBTITLE, HOUSE_AGENT_VENDOR, type HeadroomBudgetCommand, type HeadroomBudgetPeriod, type HeadroomBudgetUsage, type HeadroomKind, type HeadroomModelSpec, type HeadroomPythonRenderOpts, type HeadroomStatus, type HeadroomStep, type HeadroomSurface, type HeadroomUsageBucket, type HeadroomUsageGranularity, type HeadroomUsageReport, type HeadroomUsageResult, type HeadroomUsageSlice, type HeadroomUsageTotals, type HunkLineType, INTEGRATION_BRANDING, INTEGRATION_REGISTRY, INTERNAL_TO_PUBLIC, type InputSuggestionChunk, type IntegrationApiKeyField, type IntegrationAuthKind, type IntegrationBranding, type IntegrationCategory, type IntegrationDefinition, type IntegrationDelivery, type IntegrationHealth, type IntegrationId, type IntegrationMcpDelivery, type IntegrationStatus, type IntegrationsManifest, type IntegrationsManifestEntry, LINKED_AGENT_IDS, type LinkedAgentId, MODEL_CONTEXT_WINDOW, MODEL_PRICING, type ModelPricing, type NormalizedMessage, OBSERVER_BRIDGE_PORT, PACK_ACTION_COMMAND, PACK_REGISTRY, PACK_START_COMMAND, PACK_STATUS_COMMAND, PACK_WORKFLOW_ARTICLE, PREVIEW_DETECT_PROMPT, PROTOCOL_VERSION, PUBLIC_TO_INTERNAL, type PackActionKind, type PackActionPayload, type PackDefinition, type PackHandoffRecord, type PackId, type PackRunState, type PackRunStatus, type PackStageDef, type PackStageState, type PackStageStatus, type PackStartPayload, type PendingReviewHunkEvent, type PendingReviewHunkLine, type PrCheck, type PrRef, type PrReviewEntry, type PrReviewVerdict, type PreviewDetection, type PreviewErrorStage, type PreviewState, type PreviewStatus, type PullRequestDetail, type PullRequestSummary, QA_PROMPT, REVIEWER_PROMPT, type RemoteCommand, type RepoStack, type RepoStackDetection, SKILL_REGISTRY, SPECIFIER_PROMPT, SSE_SOCKET_TIMEOUT_MS, STACK_TO_RECOMMENDED, SWITCH_AGENT_COMMAND, type SelectPrompt, type SkillDefinition, type SkillDelivery, type SkillFileDelivery, type SkillId, type SkillRail, type SkillsManifest, type SkillsManifestEntry, type StreamingChunkEvent, type StreamingChunkKind, type SwitchAgentCommand, type SwitchAgentResult, type SwitchAgentStatus, type SwitchAgentStep, TERMINAL_AGENT_PREFIX, UNKNOWN_MODEL_PRICING, UPCOMING_INTEGRATION_IDS, USER_EVENTS, type UserEventName, classifyStack, detectedIntegrationsFromDeps, getAgent, getContextWindow, getEnabledAgents, getEnabledIntegrations, getIntegration, getIntegrationBranding, getIntegrationsByCategory, getPackDefinition, getPricing, getSkillDefinition, headroomKindFor, headroomModelPredownloadScript, headroomPipPackage, headroomSnapshotDownloadLine, internalToPublic, isGuardrailDisposition, isHeadroomWrappable, isKnownAgentId, isKnownIntegrationId, isKnownModel, isLinkedAgentId, isPackId, isSkillId, normalizeAgentId, normalizeGuardrailPolicy, publicToInternal, recommendForDeps, renderToLines, resolveApiBaseUrl, skillHasRail, toRemoteCommand, tryGetContextWindow };

package/dist/index.js

@@ -66,6 +66,7 @@ __export(index_exports, {
   SPECIFIER_PROMPT: () => SPECIFIER_PROMPT,
   SSE_SOCKET_TIMEOUT_MS: () => SSE_SOCKET_TIMEOUT_MS,
   STACK_TO_RECOMMENDED: () => STACK_TO_RECOMMENDED,
+  SWITCH_AGENT_COMMAND: () => SWITCH_AGENT_COMMAND,
   TERMINAL_AGENT_PREFIX: () => TERMINAL_AGENT_PREFIX,
   UNKNOWN_MODEL_PRICING: () => UNKNOWN_MODEL_PRICING,
   UPCOMING_INTEGRATION_IDS: () => UPCOMING_INTEGRATION_IDS,
@@ -2696,6 +2697,9 @@ function resolveApiBaseUrl() {
 // src/types/headroom.ts
 var HEADROOM_USAGE_COMMAND = "headroom_usage";
 
+// src/types/agent-switch.ts
+var SWITCH_AGENT_COMMAND = "switch_agent";
+
 // src/headroom/manifest.ts
 var HEADROOM_PROXY_PORT = 8787;
 var HEADROOM_BACKEND_ENV = {
@@ -2826,6 +2830,11 @@ var USER_EVENTS = {
   CODERABBIT_PROGRESS: "coderabbit_progress",
   CODERABBIT_STATUS: "coderabbit_status",
   CODERABBIT_REVIEW: "coderabbit_review",
+  // Session agent switch — the CLI posts these to /api/agent-switch/events
+  // while a `switch_agent` relay command swaps the session's agent in-process;
+  // the backend re-publishes them on the per-user SSE bus (mirrored in repo A).
+  SWITCH_AGENT_PROGRESS: "switch_agent_progress",
+  SWITCH_AGENT_STATUS: "switch_agent_status",
   // VCS / PR Command Center — the backend publishes this after an agent finishes
   // reviewing a PR (verdict + comment count + findings), driving the mobile
   // completion screen + push. Mirrored in repo A's app-shared events.ts.
@@ -2936,6 +2945,7 @@ OUTPUT JSON ONLY. NO MARKDOWN. NO COMMENTARY.
   SPECIFIER_PROMPT,
   SSE_SOCKET_TIMEOUT_MS,
   STACK_TO_RECOMMENDED,
+  SWITCH_AGENT_COMMAND,
   TERMINAL_AGENT_PREFIX,
   UNKNOWN_MODEL_PRICING,
   UPCOMING_INTEGRATION_IDS,