@codeam/shared 2.61.19 → 2.61.21

package/dist/index.d.mts

@@ -489,6 +489,126 @@ declare const INTEGRATION_BRANDING: Record<string, IntegrationBranding>;
 declare const UPCOMING_INTEGRATION_IDS: readonly ["gmail", "posthog", "clickup", "figma", "trello", "resend", "vercel", "supabase", "asana", "postman", "n8n", "stripe", "mixpanel", "pendo", "pagerduty", "amplitude", "datadog"];
 declare function getIntegrationBranding(id: string): IntegrationBranding | null;
 
+/**
+ * PR / MR Command Center — pull-request wire types (canonical home).
+ *
+ * Spec: docs/superpowers/specs/2026-07-18-pr-mr-command-center-design.md (§5, §6, §9, §10).
+ *
+ * These are the frozen shapes the backend `vcs` engine, the mobile PR panel,
+ * and the CLI agent-review handler all agree on byte-for-byte. Pure data — no
+ * platform imports. v1 is GitHub-only, but every shape is vendor-neutral so a
+ * future GitLab/Bitbucket provider reuses them with ZERO panel/type change.
+ */
+/** A stable, cross-vendor reference to one pull/merge request. */
+interface PrRef {
+    /** Repo owner / org (GitHub `owner`). */
+    owner: string;
+    /** Repo name (GitHub `repo`). */
+    repo: string;
+    /** PR number within the repo. */
+    number: number;
+    /** Canonical web URL, when known (e.g. `https://github.com/o/r/pull/12`). */
+    url?: string;
+}
+/** The three review actions a reviewer (human or agent) can submit. */
+type PrReviewVerdict = 'approve' | 'request_changes' | 'comment';
+/** One CI check / status on a PR head commit (GitHub Checks + commit statuses). */
+interface PrCheck {
+    name: string;
+    /** GitHub check-run status. */
+    status: 'queued' | 'in_progress' | 'completed';
+    /** Conclusion once `status === 'completed'`; null/absent while running. */
+    conclusion?: 'success' | 'failure' | 'neutral' | 'cancelled' | 'skipped' | 'timed_out' | 'action_required' | null;
+    /** Deep link to the check's details page. */
+    detailsUrl?: string;
+}
+/** One existing review already on the PR (shown in the detail screen). */
+interface PrReviewEntry {
+    /** Reviewer login. */
+    author: string;
+    state: 'approved' | 'changes_requested' | 'commented' | 'dismissed' | 'pending';
+    submittedAt?: string;
+    body?: string;
+}
+/**
+ * A row in the PR Command Center panel (Review Requested / Your Open PRs).
+ * Pulled on-open via the GitHub Search API — never polled.
+ */
+interface PullRequestSummary {
+    ref: PrRef;
+    title: string;
+    number: number;
+    /** Author login. */
+    author: string;
+    state: 'open' | 'closed' | 'merged';
+    isDraft?: boolean;
+    /** Head → base branch names. */
+    headBranch: string;
+    baseBranch: string;
+    updatedAt: string;
+    /** `owner/repo`. */
+    repoFullName: string;
+    /** Aggregate review decision (GitHub `reviewDecision`). */
+    reviewDecision?: 'approved' | 'changes_requested' | 'review_required' | null;
+    additions?: number;
+    deletions?: number;
+    changedFiles?: number;
+}
+/** The full PR detail screen payload — summary + body + checks + reviews. */
+interface PullRequestDetail extends PullRequestSummary {
+    body?: string;
+    checks?: PrCheck[];
+    reviews?: PrReviewEntry[];
+    /** GitHub mergeability; null while GitHub is still computing it. */
+    mergeable?: boolean | null;
+    /** Role flags the mobile UI uses to pick the action set (author vs reviewer). */
+    viewerIsAuthor?: boolean;
+    viewerIsRequestedReviewer?: boolean;
+}
+/** One finding an agent surfaced during a review (mirrors a CodeRabbit hunk). */
+interface AgentReviewFinding {
+    /** Repo-relative file path. */
+    path: string;
+    /** 1-based line the finding anchors to, when locatable. */
+    line?: number;
+    severity?: 'info' | 'warn' | 'error';
+    message: string;
+}
+/**
+ * Phase-2 agent-review LAUNCH plan — what the backend composes when the user
+ * taps "Ask an agent to review PR #X". Delivered to the review session so the
+ * agent (ACP via initial prompt, or CodeRabbit via the CLI handler) knows what
+ * to review and which toolkits it has.
+ */
+interface AgentReviewPlan {
+    prRef: PrRef;
+    /** Which linked agent performs the review (`coderabbit`, `claude`, …). */
+    agentId: string;
+    /** The composed "review PR #X" initial prompt (ACP agents consume this). */
+    prompt: string;
+    /** `owner/repo` (or a provider-specific project identifier). */
+    repoIdentifier: string;
+    /** The PR head branch the deploy checks out and the review runs against. */
+    branch: string;
+    /** Toolkit integrations the review box is provisioned with (includes `github`). */
+    integrationIds: string[];
+}
+/**
+ * Phase-2 agent-review RESULT — POSTed by the review session to
+ * `POST /api/vcs/agent-review/report` once the agent finishes posting to
+ * GitHub. Drives the completion push + Completion Result card.
+ */
+interface AgentReviewReport {
+    prRef: PrRef;
+    agentId: string;
+    /** The verdict the agent submitted to GitHub. */
+    verdict: PrReviewVerdict;
+    /** Number of inline comments the agent posted to GitHub. */
+    commentCount: number;
+    /** The findings behind the verdict (rendered in the Completion Result card). */
+    findings?: AgentReviewFinding[];
+}
+
 /**
  * Wire-shape types for the CLI / IDE-plugin → backend producer endpoints
  * that feed the mobile Files screen and the Pending Review Queue:
@@ -1299,6 +1419,7 @@ declare const USER_EVENTS: {
     readonly CODERABBIT_PROGRESS: "coderabbit_progress";
     readonly CODERABBIT_STATUS: "coderabbit_status";
     readonly CODERABBIT_REVIEW: "coderabbit_review";
+    readonly VCS_AGENT_REVIEW_COMPLETE: "vcs_agent_review_complete";
 };
 type UserEventName = (typeof USER_EVENTS)[keyof typeof USER_EVENTS];
 
@@ -1314,4 +1435,4 @@ type UserEventName = (typeof USER_EVENTS)[keyof typeof USER_EVENTS];
  */
 declare const PREVIEW_DETECT_PROMPT: string;
 
-export { AGENT_REGISTRY, type AgentAuth, type AgentAuthKind, type AgentId, type AgentMetadata, type AgentMode, type AgentModel, 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, type ChromeStep, type ChromeToolType, type CommitEntryWire, DEFAULT_API_BASE_URL, DEV_API_BASE_URL, type EnvVar, type FileBlameEvent, type FileChangeStatus, type FileChangedEvent, type FileHistoryEvent, type FileReviewStatus, HEADROOM_BACKEND_ENV, HEADROOM_EXTRAS_BY_SURFACE, HEADROOM_MODELS, HEADROOM_PIP_COMPANIONS, HEADROOM_PROXY_PORT, 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 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, PREVIEW_DETECT_PROMPT, PROTOCOL_VERSION, PUBLIC_TO_INTERNAL, type PendingReviewHunkEvent, type PendingReviewHunkLine, type PreviewDetection, type PreviewErrorStage, type PreviewState, type PreviewStatus, type RemoteCommand, SSE_SOCKET_TIMEOUT_MS, type SelectPrompt, type StreamingChunkEvent, type StreamingChunkKind, TERMINAL_AGENT_PREFIX, UNKNOWN_MODEL_PRICING, UPCOMING_INTEGRATION_IDS, USER_EVENTS, type UserEventName, getAgent, getContextWindow, getEnabledAgents, getEnabledIntegrations, getIntegration, getIntegrationBranding, getIntegrationsByCategory, getPricing, headroomKindFor, headroomModelPredownloadScript, headroomPipPackage, headroomSnapshotDownloadLine, internalToPublic, isHeadroomWrappable, isKnownAgentId, isKnownIntegrationId, isKnownModel, isLinkedAgentId, normalizeAgentId, publicToInternal, renderToLines, resolveApiBaseUrl, toRemoteCommand, tryGetContextWindow };
+export { AGENT_REGISTRY, 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, type ChromeStep, type ChromeToolType, type CommitEntryWire, DEFAULT_API_BASE_URL, DEV_API_BASE_URL, type EnvVar, type FileBlameEvent, type FileChangeStatus, type FileChangedEvent, type FileHistoryEvent, type FileReviewStatus, HEADROOM_BACKEND_ENV, HEADROOM_EXTRAS_BY_SURFACE, HEADROOM_MODELS, HEADROOM_PIP_COMPANIONS, HEADROOM_PROXY_PORT, 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 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, PREVIEW_DETECT_PROMPT, PROTOCOL_VERSION, PUBLIC_TO_INTERNAL, type PendingReviewHunkEvent, type PendingReviewHunkLine, type PrCheck, type PrRef, type PrReviewEntry, type PrReviewVerdict, type PreviewDetection, type PreviewErrorStage, type PreviewState, type PreviewStatus, type PullRequestDetail, type PullRequestSummary, type RemoteCommand, SSE_SOCKET_TIMEOUT_MS, type SelectPrompt, type StreamingChunkEvent, type StreamingChunkKind, TERMINAL_AGENT_PREFIX, UNKNOWN_MODEL_PRICING, UPCOMING_INTEGRATION_IDS, USER_EVENTS, type UserEventName, getAgent, getContextWindow, getEnabledAgents, getEnabledIntegrations, getIntegration, getIntegrationBranding, getIntegrationsByCategory, getPricing, headroomKindFor, headroomModelPredownloadScript, headroomPipPackage, headroomSnapshotDownloadLine, internalToPublic, isHeadroomWrappable, isKnownAgentId, isKnownIntegrationId, isKnownModel, isLinkedAgentId, normalizeAgentId, publicToInternal, renderToLines, resolveApiBaseUrl, toRemoteCommand, tryGetContextWindow };

package/dist/index.d.ts

@@ -489,6 +489,126 @@ declare const INTEGRATION_BRANDING: Record<string, IntegrationBranding>;
 declare const UPCOMING_INTEGRATION_IDS: readonly ["gmail", "posthog", "clickup", "figma", "trello", "resend", "vercel", "supabase", "asana", "postman", "n8n", "stripe", "mixpanel", "pendo", "pagerduty", "amplitude", "datadog"];
 declare function getIntegrationBranding(id: string): IntegrationBranding | null;
 
+/**
+ * PR / MR Command Center — pull-request wire types (canonical home).
+ *
+ * Spec: docs/superpowers/specs/2026-07-18-pr-mr-command-center-design.md (§5, §6, §9, §10).
+ *
+ * These are the frozen shapes the backend `vcs` engine, the mobile PR panel,
+ * and the CLI agent-review handler all agree on byte-for-byte. Pure data — no
+ * platform imports. v1 is GitHub-only, but every shape is vendor-neutral so a
+ * future GitLab/Bitbucket provider reuses them with ZERO panel/type change.
+ */
+/** A stable, cross-vendor reference to one pull/merge request. */
+interface PrRef {
+    /** Repo owner / org (GitHub `owner`). */
+    owner: string;
+    /** Repo name (GitHub `repo`). */
+    repo: string;
+    /** PR number within the repo. */
+    number: number;
+    /** Canonical web URL, when known (e.g. `https://github.com/o/r/pull/12`). */
+    url?: string;
+}
+/** The three review actions a reviewer (human or agent) can submit. */
+type PrReviewVerdict = 'approve' | 'request_changes' | 'comment';
+/** One CI check / status on a PR head commit (GitHub Checks + commit statuses). */
+interface PrCheck {
+    name: string;
+    /** GitHub check-run status. */
+    status: 'queued' | 'in_progress' | 'completed';
+    /** Conclusion once `status === 'completed'`; null/absent while running. */
+    conclusion?: 'success' | 'failure' | 'neutral' | 'cancelled' | 'skipped' | 'timed_out' | 'action_required' | null;
+    /** Deep link to the check's details page. */
+    detailsUrl?: string;
+}
+/** One existing review already on the PR (shown in the detail screen). */
+interface PrReviewEntry {
+    /** Reviewer login. */
+    author: string;
+    state: 'approved' | 'changes_requested' | 'commented' | 'dismissed' | 'pending';
+    submittedAt?: string;
+    body?: string;
+}
+/**
+ * A row in the PR Command Center panel (Review Requested / Your Open PRs).
+ * Pulled on-open via the GitHub Search API — never polled.
+ */
+interface PullRequestSummary {
+    ref: PrRef;
+    title: string;
+    number: number;
+    /** Author login. */
+    author: string;
+    state: 'open' | 'closed' | 'merged';
+    isDraft?: boolean;
+    /** Head → base branch names. */
+    headBranch: string;
+    baseBranch: string;
+    updatedAt: string;
+    /** `owner/repo`. */
+    repoFullName: string;
+    /** Aggregate review decision (GitHub `reviewDecision`). */
+    reviewDecision?: 'approved' | 'changes_requested' | 'review_required' | null;
+    additions?: number;
+    deletions?: number;
+    changedFiles?: number;
+}
+/** The full PR detail screen payload — summary + body + checks + reviews. */
+interface PullRequestDetail extends PullRequestSummary {
+    body?: string;
+    checks?: PrCheck[];
+    reviews?: PrReviewEntry[];
+    /** GitHub mergeability; null while GitHub is still computing it. */
+    mergeable?: boolean | null;
+    /** Role flags the mobile UI uses to pick the action set (author vs reviewer). */
+    viewerIsAuthor?: boolean;
+    viewerIsRequestedReviewer?: boolean;
+}
+/** One finding an agent surfaced during a review (mirrors a CodeRabbit hunk). */
+interface AgentReviewFinding {
+    /** Repo-relative file path. */
+    path: string;
+    /** 1-based line the finding anchors to, when locatable. */
+    line?: number;
+    severity?: 'info' | 'warn' | 'error';
+    message: string;
+}
+/**
+ * Phase-2 agent-review LAUNCH plan — what the backend composes when the user
+ * taps "Ask an agent to review PR #X". Delivered to the review session so the
+ * agent (ACP via initial prompt, or CodeRabbit via the CLI handler) knows what
+ * to review and which toolkits it has.
+ */
+interface AgentReviewPlan {
+    prRef: PrRef;
+    /** Which linked agent performs the review (`coderabbit`, `claude`, …). */
+    agentId: string;
+    /** The composed "review PR #X" initial prompt (ACP agents consume this). */
+    prompt: string;
+    /** `owner/repo` (or a provider-specific project identifier). */
+    repoIdentifier: string;
+    /** The PR head branch the deploy checks out and the review runs against. */
+    branch: string;
+    /** Toolkit integrations the review box is provisioned with (includes `github`). */
+    integrationIds: string[];
+}
+/**
+ * Phase-2 agent-review RESULT — POSTed by the review session to
+ * `POST /api/vcs/agent-review/report` once the agent finishes posting to
+ * GitHub. Drives the completion push + Completion Result card.
+ */
+interface AgentReviewReport {
+    prRef: PrRef;
+    agentId: string;
+    /** The verdict the agent submitted to GitHub. */
+    verdict: PrReviewVerdict;
+    /** Number of inline comments the agent posted to GitHub. */
+    commentCount: number;
+    /** The findings behind the verdict (rendered in the Completion Result card). */
+    findings?: AgentReviewFinding[];
+}
+
 /**
  * Wire-shape types for the CLI / IDE-plugin → backend producer endpoints
  * that feed the mobile Files screen and the Pending Review Queue:
@@ -1299,6 +1419,7 @@ declare const USER_EVENTS: {
     readonly CODERABBIT_PROGRESS: "coderabbit_progress";
     readonly CODERABBIT_STATUS: "coderabbit_status";
     readonly CODERABBIT_REVIEW: "coderabbit_review";
+    readonly VCS_AGENT_REVIEW_COMPLETE: "vcs_agent_review_complete";
 };
 type UserEventName = (typeof USER_EVENTS)[keyof typeof USER_EVENTS];
 
@@ -1314,4 +1435,4 @@ type UserEventName = (typeof USER_EVENTS)[keyof typeof USER_EVENTS];
  */
 declare const PREVIEW_DETECT_PROMPT: string;
 
-export { AGENT_REGISTRY, type AgentAuth, type AgentAuthKind, type AgentId, type AgentMetadata, type AgentMode, type AgentModel, 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, type ChromeStep, type ChromeToolType, type CommitEntryWire, DEFAULT_API_BASE_URL, DEV_API_BASE_URL, type EnvVar, type FileBlameEvent, type FileChangeStatus, type FileChangedEvent, type FileHistoryEvent, type FileReviewStatus, HEADROOM_BACKEND_ENV, HEADROOM_EXTRAS_BY_SURFACE, HEADROOM_MODELS, HEADROOM_PIP_COMPANIONS, HEADROOM_PROXY_PORT, 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 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, PREVIEW_DETECT_PROMPT, PROTOCOL_VERSION, PUBLIC_TO_INTERNAL, type PendingReviewHunkEvent, type PendingReviewHunkLine, type PreviewDetection, type PreviewErrorStage, type PreviewState, type PreviewStatus, type RemoteCommand, SSE_SOCKET_TIMEOUT_MS, type SelectPrompt, type StreamingChunkEvent, type StreamingChunkKind, TERMINAL_AGENT_PREFIX, UNKNOWN_MODEL_PRICING, UPCOMING_INTEGRATION_IDS, USER_EVENTS, type UserEventName, getAgent, getContextWindow, getEnabledAgents, getEnabledIntegrations, getIntegration, getIntegrationBranding, getIntegrationsByCategory, getPricing, headroomKindFor, headroomModelPredownloadScript, headroomPipPackage, headroomSnapshotDownloadLine, internalToPublic, isHeadroomWrappable, isKnownAgentId, isKnownIntegrationId, isKnownModel, isLinkedAgentId, normalizeAgentId, publicToInternal, renderToLines, resolveApiBaseUrl, toRemoteCommand, tryGetContextWindow };
+export { AGENT_REGISTRY, 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, type ChromeStep, type ChromeToolType, type CommitEntryWire, DEFAULT_API_BASE_URL, DEV_API_BASE_URL, type EnvVar, type FileBlameEvent, type FileChangeStatus, type FileChangedEvent, type FileHistoryEvent, type FileReviewStatus, HEADROOM_BACKEND_ENV, HEADROOM_EXTRAS_BY_SURFACE, HEADROOM_MODELS, HEADROOM_PIP_COMPANIONS, HEADROOM_PROXY_PORT, 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 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, PREVIEW_DETECT_PROMPT, PROTOCOL_VERSION, PUBLIC_TO_INTERNAL, type PendingReviewHunkEvent, type PendingReviewHunkLine, type PrCheck, type PrRef, type PrReviewEntry, type PrReviewVerdict, type PreviewDetection, type PreviewErrorStage, type PreviewState, type PreviewStatus, type PullRequestDetail, type PullRequestSummary, type RemoteCommand, SSE_SOCKET_TIMEOUT_MS, type SelectPrompt, type StreamingChunkEvent, type StreamingChunkKind, TERMINAL_AGENT_PREFIX, UNKNOWN_MODEL_PRICING, UPCOMING_INTEGRATION_IDS, USER_EVENTS, type UserEventName, getAgent, getContextWindow, getEnabledAgents, getEnabledIntegrations, getIntegration, getIntegrationBranding, getIntegrationsByCategory, getPricing, headroomKindFor, headroomModelPredownloadScript, headroomPipPackage, headroomSnapshotDownloadLine, internalToPublic, isHeadroomWrappable, isKnownAgentId, isKnownIntegrationId, isKnownModel, isLinkedAgentId, normalizeAgentId, publicToInternal, renderToLines, resolveApiBaseUrl, toRemoteCommand, tryGetContextWindow };

package/dist/index.js

@@ -867,6 +867,18 @@ function getIntegrationsByCategory(category) {
 
 // src/integrations/branding.ts
 var INTEGRATION_BRANDING = {
+  // GitHub — a brand-only entry (NOT an `IntegrationId`; v1 reuses the
+  // codespaces OAuth token rather than exposing GitHub as a linkable toolkit).
+  // Present so the PR/MR Command Center surfaces (the review-launch toast, etc.)
+  // render the official GitHub mark from the ONE shared catalog.
+  github: {
+    id: "github",
+    name: "GitHub",
+    vendor: "GitHub",
+    tagline: "Pull requests, reviews & merges",
+    brandColor: "#FFFFFF",
+    logoSvg: '<svg role="img" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><title>GitHub</title><path fill="#FFFFFF" d="M12 .297c-6.63 0-12 5.373-12 12 0 5.303 3.438 9.8 8.205 11.385.6.113.82-.258.82-.577 0-.285-.01-1.04-.015-2.04-3.338.724-4.042-1.61-4.042-1.61C4.422 18.07 3.633 17.7 3.633 17.7c-1.087-.744.084-.729.084-.729 1.205.084 1.838 1.236 1.838 1.236 1.07 1.835 2.809 1.305 3.495.998.108-.776.417-1.305.76-1.605-2.665-.3-5.466-1.332-5.466-5.93 0-1.31.465-2.38 1.235-3.22-.135-.303-.54-1.523.105-3.176 0 0 1.005-.322 3.3 1.23.96-.267 1.98-.399 3-.405 1.02.006 2.04.138 3 .405 2.28-1.552 3.285-1.23 3.285-1.23.645 1.653.24 2.873.12 3.176.765.84 1.23 1.91 1.23 3.22 0 4.61-2.805 5.625-5.475 5.92.42.36.81 1.096.81 2.22 0 1.606-.015 2.896-.015 3.286 0 .315.21.69.825.57C20.565 22.092 24 17.592 24 12.297c0-6.627-5.373-12-12-12"/></svg>'
+  },
   jira: {
     // Branding key kept 'jira' for id-stability; DISPLAY rebranded to Atlassian
     // (the one integration fronts both Jira + Confluence via mcp-atlassian).
@@ -1210,7 +1222,11 @@ var USER_EVENTS = {
   // backend re-publishes them on the per-user SSE bus (mirrored in repo A).
   CODERABBIT_PROGRESS: "coderabbit_progress",
   CODERABBIT_STATUS: "coderabbit_status",
-  CODERABBIT_REVIEW: "coderabbit_review"
+  CODERABBIT_REVIEW: "coderabbit_review",
+  // 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.
+  VCS_AGENT_REVIEW_COMPLETE: "vcs_agent_review_complete"
 };
 
 // src/preview-prompts.ts