@codeam/shared 2.65.0 → 2.65.2

package/dist/index.d.mts

@@ -343,6 +343,77 @@ declare function headroomKindFor(agentId: string): HeadroomKind | null;
  */
 declare function isHeadroomWrappable(agentId: string): boolean;
 
+/**
+ * Canonical per-agent CLI **install** snippets.
+ *
+ * ─── Why this file exists ────────────────────────────────────────────────────
+ * Until now the only copy of these shell recipes lived inside the backend's
+ * codespace provisioning strategies — one `getInstallSnippet()` per
+ * `…ProvisioningStrategy` in
+ * `codeagent-mobile/apps/api-v2/src/codespaces/agent.ts`. That made them
+ * unreachable from the clients repo, so the CLI could never be tested against
+ * the REAL command a box actually runs: the `switch_agent` install path only
+ * ever saw a snippet handed to it over the wire at runtime.
+ *
+ * That gap is exactly how the **stale-PATH / half-finished-install** failure
+ * class (fleet-1, 2026-08-14) reached production: `npm install -g @openai/codex`
+ * succeeded, but the long-running CLI daemon's PATH predated the npm
+ * global-prefix bin dir, so the post-install probe reported "installed but its
+ * binary never appeared on PATH" — forever. No CI test could have caught it,
+ * because no CI test could run the real install.
+ *
+ * These strings are now **canonical HERE**. `apps/cli/__tests__/integration/
+ * agent-install.int.test.ts` runs each one for real, inside a container with a
+ * deliberately minimal (systemd-like) PATH, and then drives the REAL adapter
+ * probe from a single long-running node process.
+ *
+ * ─── api-v2 migration (deliberate follow-up, NOT done yet) ───────────────────
+ * The backend still owns its own copies. At the next `@codeam/shared` pin bump
+ * in api-v2, change exactly ONE file —
+ *
+ *     codeagent-mobile/apps/api-v2/src/codespaces/agent.ts
+ *
+ * — so every `…ProvisioningStrategy.getInstallSnippet()` returns
+ * `INSTALL_SNIPPETS[<agentId>]` imported from `@codeam/shared` instead of an
+ * inline template literal. The `getAuthSnippet()` half stays in api-v2: it is
+ * credential-bearing and must never be mirrored into a package the clients
+ * bundle.
+ *
+ * ─── Invariants ──────────────────────────────────────────────────────────────
+ * • **Install ONLY.** Every credential/auth line from the backend strategies is
+ *   deliberately excluded — no token, key, or secret substitution variable may
+ *   ever appear here (asserted by `__tests__/agents-install-snippets.test.ts`).
+ * • **Idempotent.** Each snippet is `command -v`-guarded, so re-running it is
+ *   always safe — that is what makes the `switch-agent.ts` retry-once recovery
+ *   for the half-finished-bin-link class legitimate.
+ * • **Verbatim.** These are byte-for-byte ports of the api-v2 snippets. Do not
+ *   "clean them up" independently — a divergence means a codespace and a
+ *   self-hosted switch install different things.
+ * • `claude` is absent ON PURPOSE: its binary ships as an optional platform
+ *   dependency of `@anthropic-ai/claude-agent-sdk` (installed with the CLI
+ *   itself), so there is no separate install recipe to run.
+ */
+
+/**
+ * The canonical install recipe per agent. `Partial` because not every agent has
+ * one: `claude` ships its binary with the SDK, and `copilot` has no
+ * provisioning strategy yet.
+ */
+declare const INSTALL_SNIPPETS: Readonly<Partial<Record<AgentId, string>>>;
+/**
+ * Agents whose canonical snippet actually installs something. Excludes
+ * `coderabbit` (credential-only no-op — see {@link INSTALL_SNIPPETS}).
+ *
+ * This is the list the real-install integration gate iterates.
+ */
+declare function installableAgentIds(): AgentId[];
+/**
+ * True when a snippet performs no installation at all (a bare marker `echo`).
+ * Callers that need a real binary must fall back to the agent's own CLI-side
+ * installer instead of running the snippet.
+ */
+declare function isNoopInstallSnippet(snippet: string | undefined): boolean;
+
 /**
  * Agent Toolkits — integration wire types.
  * Spec: docs/superpowers/specs/2026-07-10-agent-toolkits-integrations-design.md
@@ -2078,4 +2149,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, HANDOFF_FENCE_TAG, 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 HandoffProposal, type HandoffResolution, 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, SQUAD_CONFIGURE_COMMAND, SQUAD_HOP_BUDGET_DEFAULT, SQUAD_HOP_BUDGET_MAX, SQUAD_HOP_BUDGET_MIN, SQUAD_SPECIALTIES, SQUAD_STATS_COMMAND, 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 SquadAutoConfig, type SquadConfigurePayload, type SquadConfigureResult, type SquadMemberActivity, type SquadRosterAgent, type SquadRosterData, type SquadStatsResult, type StartTaskPayload, 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, clampHopBudget, 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, HANDOFF_FENCE_TAG, 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 HandoffProposal, type HandoffResolution, 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, INSTALL_SNIPPETS, 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, SQUAD_CONFIGURE_COMMAND, SQUAD_HOP_BUDGET_DEFAULT, SQUAD_HOP_BUDGET_MAX, SQUAD_HOP_BUDGET_MIN, SQUAD_SPECIALTIES, SQUAD_STATS_COMMAND, 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 SquadAutoConfig, type SquadConfigurePayload, type SquadConfigureResult, type SquadMemberActivity, type SquadRosterAgent, type SquadRosterData, type SquadStatsResult, type StartTaskPayload, 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, clampHopBudget, classifyStack, detectedIntegrationsFromDeps, getAgent, getContextWindow, getEnabledAgents, getEnabledIntegrations, getIntegration, getIntegrationBranding, getIntegrationsByCategory, getPackDefinition, getPricing, getSkillDefinition, headroomKindFor, headroomModelPredownloadScript, headroomPipPackage, headroomSnapshotDownloadLine, installableAgentIds, internalToPublic, isGuardrailDisposition, isHeadroomWrappable, isKnownAgentId, isKnownIntegrationId, isKnownModel, isLinkedAgentId, isNoopInstallSnippet, isPackId, isSkillId, normalizeAgentId, normalizeGuardrailPolicy, publicToInternal, recommendForDeps, renderToLines, resolveApiBaseUrl, skillHasRail, toRemoteCommand, tryGetContextWindow };

package/dist/index.d.ts

@@ -343,6 +343,77 @@ declare function headroomKindFor(agentId: string): HeadroomKind | null;
  */
 declare function isHeadroomWrappable(agentId: string): boolean;
 
+/**
+ * Canonical per-agent CLI **install** snippets.
+ *
+ * ─── Why this file exists ────────────────────────────────────────────────────
+ * Until now the only copy of these shell recipes lived inside the backend's
+ * codespace provisioning strategies — one `getInstallSnippet()` per
+ * `…ProvisioningStrategy` in
+ * `codeagent-mobile/apps/api-v2/src/codespaces/agent.ts`. That made them
+ * unreachable from the clients repo, so the CLI could never be tested against
+ * the REAL command a box actually runs: the `switch_agent` install path only
+ * ever saw a snippet handed to it over the wire at runtime.
+ *
+ * That gap is exactly how the **stale-PATH / half-finished-install** failure
+ * class (fleet-1, 2026-08-14) reached production: `npm install -g @openai/codex`
+ * succeeded, but the long-running CLI daemon's PATH predated the npm
+ * global-prefix bin dir, so the post-install probe reported "installed but its
+ * binary never appeared on PATH" — forever. No CI test could have caught it,
+ * because no CI test could run the real install.
+ *
+ * These strings are now **canonical HERE**. `apps/cli/__tests__/integration/
+ * agent-install.int.test.ts` runs each one for real, inside a container with a
+ * deliberately minimal (systemd-like) PATH, and then drives the REAL adapter
+ * probe from a single long-running node process.
+ *
+ * ─── api-v2 migration (deliberate follow-up, NOT done yet) ───────────────────
+ * The backend still owns its own copies. At the next `@codeam/shared` pin bump
+ * in api-v2, change exactly ONE file —
+ *
+ *     codeagent-mobile/apps/api-v2/src/codespaces/agent.ts
+ *
+ * — so every `…ProvisioningStrategy.getInstallSnippet()` returns
+ * `INSTALL_SNIPPETS[<agentId>]` imported from `@codeam/shared` instead of an
+ * inline template literal. The `getAuthSnippet()` half stays in api-v2: it is
+ * credential-bearing and must never be mirrored into a package the clients
+ * bundle.
+ *
+ * ─── Invariants ──────────────────────────────────────────────────────────────
+ * • **Install ONLY.** Every credential/auth line from the backend strategies is
+ *   deliberately excluded — no token, key, or secret substitution variable may
+ *   ever appear here (asserted by `__tests__/agents-install-snippets.test.ts`).
+ * • **Idempotent.** Each snippet is `command -v`-guarded, so re-running it is
+ *   always safe — that is what makes the `switch-agent.ts` retry-once recovery
+ *   for the half-finished-bin-link class legitimate.
+ * • **Verbatim.** These are byte-for-byte ports of the api-v2 snippets. Do not
+ *   "clean them up" independently — a divergence means a codespace and a
+ *   self-hosted switch install different things.
+ * • `claude` is absent ON PURPOSE: its binary ships as an optional platform
+ *   dependency of `@anthropic-ai/claude-agent-sdk` (installed with the CLI
+ *   itself), so there is no separate install recipe to run.
+ */
+
+/**
+ * The canonical install recipe per agent. `Partial` because not every agent has
+ * one: `claude` ships its binary with the SDK, and `copilot` has no
+ * provisioning strategy yet.
+ */
+declare const INSTALL_SNIPPETS: Readonly<Partial<Record<AgentId, string>>>;
+/**
+ * Agents whose canonical snippet actually installs something. Excludes
+ * `coderabbit` (credential-only no-op — see {@link INSTALL_SNIPPETS}).
+ *
+ * This is the list the real-install integration gate iterates.
+ */
+declare function installableAgentIds(): AgentId[];
+/**
+ * True when a snippet performs no installation at all (a bare marker `echo`).
+ * Callers that need a real binary must fall back to the agent's own CLI-side
+ * installer instead of running the snippet.
+ */
+declare function isNoopInstallSnippet(snippet: string | undefined): boolean;
+
 /**
  * Agent Toolkits — integration wire types.
  * Spec: docs/superpowers/specs/2026-07-10-agent-toolkits-integrations-design.md
@@ -2078,4 +2149,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, HANDOFF_FENCE_TAG, 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 HandoffProposal, type HandoffResolution, 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, SQUAD_CONFIGURE_COMMAND, SQUAD_HOP_BUDGET_DEFAULT, SQUAD_HOP_BUDGET_MAX, SQUAD_HOP_BUDGET_MIN, SQUAD_SPECIALTIES, SQUAD_STATS_COMMAND, 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 SquadAutoConfig, type SquadConfigurePayload, type SquadConfigureResult, type SquadMemberActivity, type SquadRosterAgent, type SquadRosterData, type SquadStatsResult, type StartTaskPayload, 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, clampHopBudget, 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, HANDOFF_FENCE_TAG, 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 HandoffProposal, type HandoffResolution, 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, INSTALL_SNIPPETS, 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, SQUAD_CONFIGURE_COMMAND, SQUAD_HOP_BUDGET_DEFAULT, SQUAD_HOP_BUDGET_MAX, SQUAD_HOP_BUDGET_MIN, SQUAD_SPECIALTIES, SQUAD_STATS_COMMAND, 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 SquadAutoConfig, type SquadConfigurePayload, type SquadConfigureResult, type SquadMemberActivity, type SquadRosterAgent, type SquadRosterData, type SquadStatsResult, type StartTaskPayload, 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, clampHopBudget, classifyStack, detectedIntegrationsFromDeps, getAgent, getContextWindow, getEnabledAgents, getEnabledIntegrations, getIntegration, getIntegrationBranding, getIntegrationsByCategory, getPackDefinition, getPricing, getSkillDefinition, headroomKindFor, headroomModelPredownloadScript, headroomPipPackage, headroomSnapshotDownloadLine, installableAgentIds, internalToPublic, isGuardrailDisposition, isHeadroomWrappable, isKnownAgentId, isKnownIntegrationId, isKnownModel, isLinkedAgentId, isNoopInstallSnippet, isPackId, isSkillId, normalizeAgentId, normalizeGuardrailPolicy, publicToInternal, recommendForDeps, renderToLines, resolveApiBaseUrl, skillHasRail, toRemoteCommand, tryGetContextWindow };

package/dist/index.js

@@ -46,6 +46,7 @@ __export(index_exports, {
   HOUSE_AGENT_PROVIDER: () => HOUSE_AGENT_PROVIDER,
   HOUSE_AGENT_SUBTITLE: () => HOUSE_AGENT_SUBTITLE,
   HOUSE_AGENT_VENDOR: () => HOUSE_AGENT_VENDOR,
+  INSTALL_SNIPPETS: () => INSTALL_SNIPPETS,
   INTEGRATION_BRANDING: () => INTEGRATION_BRANDING,
   INTEGRATION_REGISTRY: () => INTEGRATION_REGISTRY,
   INTERNAL_TO_PUBLIC: () => INTERNAL_TO_PUBLIC,
@@ -95,6 +96,7 @@ __export(index_exports, {
   headroomModelPredownloadScript: () => headroomModelPredownloadScript,
   headroomPipPackage: () => headroomPipPackage,
   headroomSnapshotDownloadLine: () => headroomSnapshotDownloadLine,
+  installableAgentIds: () => installableAgentIds,
   internalToPublic: () => internalToPublic,
   isGuardrailDisposition: () => isGuardrailDisposition,
   isHeadroomWrappable: () => isHeadroomWrappable,
@@ -102,6 +104,7 @@ __export(index_exports, {
   isKnownIntegrationId: () => isKnownIntegrationId,
   isKnownModel: () => isKnownModel,
   isLinkedAgentId: () => isLinkedAgentId,
+  isNoopInstallSnippet: () => isNoopInstallSnippet,
   isPackId: () => isPackId,
   isSkillId: () => isSkillId,
   normalizeAgentId: () => normalizeAgentId,
@@ -600,6 +603,79 @@ function isHeadroomWrappable(agentId) {
   return headroomKindFor(agentId) !== null;
 }
 
+// src/agents/install-snippets.ts
+var CODEX = `
+if ! command -v codex >/dev/null 2>&1; then
+  npm install -g @openai/codex >/dev/null
+fi`;
+var GEMINI = `
+if ! command -v gemini >/dev/null 2>&1; then
+  npm install -g @google/gemini-cli >/dev/null
+fi`;
+var KIMI = `
+if ! command -v kimi >/dev/null 2>&1; then
+  curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash \\
+    || { echo '[codeam:step] kimi_install_retry' >&2; sleep 2; curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash; } \\
+    || { echo '[ERROR] Kimi Code install failed (code.kimi.com/kimi-code/install.sh)' >&2; exit 1; }
+  echo 'export PATH="$HOME/.kimi-code/bin:$PATH"' >> ~/.bashrc
+  export PATH="$HOME/.kimi-code/bin:$PATH"
+fi
+# Integrity guard: the installer can leave a TRUNCATED binary (SIGSEGV on run)
+# when the ~157MB download is interrupted mid-bootstrap \u2014 the ELF ends up
+# missing its section headers and every \`kimi\` invocation segfaults, so the ACP
+# adapter dies. Verify \`kimi\` actually runs; re-install once if it doesn't.
+if ! kimi --version >/dev/null 2>&1; then
+  echo '[codeam:step] kimi_binary_broken_reinstall' >&2
+  curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash || true
+  export PATH="$HOME/.kimi-code/bin:$PATH"
+fi`;
+var CURSOR = `
+if ! command -v cursor-agent >/dev/null 2>&1; then
+  # Retry the installer once \u2014 under the bootstrap's \`set -euo pipefail\`
+  # a single transient failure of this unguarded network pipe would
+  # otherwise abort the whole bootstrap with a bare exit 1. The
+  # \`[ERROR]\` prefix on final failure is picked up by the stderr
+  # error-detector and the captured summary.
+  curl https://cursor.com/install -fsS | bash \\
+    || { echo '[codeam:step] cursor_install_retry' >&2; sleep 2; curl https://cursor.com/install -fsS | bash; } \\
+    || { echo '[ERROR] cursor-agent install failed (cursor.com/install)' >&2; exit 1; }
+  echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
+  export PATH="$HOME/.local/bin:$PATH"
+fi`;
+var OPENCODE = `
+if ! command -v opencode >/dev/null 2>&1; then
+  curl -fsSL https://opencode.ai/install | bash \\
+    || { echo '[codeam:step] opencode_install_retry' >&2; sleep 2; curl -fsSL https://opencode.ai/install | bash; } \\
+    || { echo '[ERROR] opencode install failed (opencode.ai/install)' >&2; exit 1; }
+  echo 'export PATH="$HOME/.opencode/bin:$PATH"' >> ~/.bashrc
+  export PATH="$HOME/.opencode/bin:$PATH"
+fi`;
+var AIDER = `
+if ! command -v aider >/dev/null 2>&1; then
+  pip install --no-cache-dir --break-system-packages aider-chat \\
+    || { echo '[codeam:step] aider_install_retry' >&2; sleep 2; pip install --no-cache-dir --break-system-packages aider-chat; } \\
+    || { echo '[ERROR] aider install failed (pip aider-chat)' >&2; exit 1; }
+fi`;
+var CODERABBIT = `echo '[codeam:step] coderabbit_reviewer_credential_only'`;
+var INSTALL_SNIPPETS = Object.freeze({
+  codex: CODEX,
+  gemini: GEMINI,
+  kimi: KIMI,
+  cursor: CURSOR,
+  opencode: OPENCODE,
+  aider: AIDER,
+  coderabbit: CODERABBIT
+});
+function installableAgentIds() {
+  return Object.keys(INSTALL_SNIPPETS).filter(
+    (id) => !isNoopInstallSnippet(INSTALL_SNIPPETS[id])
+  );
+}
+function isNoopInstallSnippet(snippet) {
+  if (!snippet) return true;
+  return /^\s*echo\s/.test(snippet) && !/\n/.test(snippet.trim());
+}
+
 // src/integrations/registry.ts
 var INTEGRATION_REGISTRY = {
   jira: {
@@ -2956,6 +3032,7 @@ OUTPUT JSON ONLY. NO MARKDOWN. NO COMMENTARY.
   HOUSE_AGENT_PROVIDER,
   HOUSE_AGENT_SUBTITLE,
   HOUSE_AGENT_VENDOR,
+  INSTALL_SNIPPETS,
   INTEGRATION_BRANDING,
   INTEGRATION_REGISTRY,
   INTERNAL_TO_PUBLIC,
@@ -3005,6 +3082,7 @@ OUTPUT JSON ONLY. NO MARKDOWN. NO COMMENTARY.
   headroomModelPredownloadScript,
   headroomPipPackage,
   headroomSnapshotDownloadLine,
+  installableAgentIds,
   internalToPublic,
   isGuardrailDisposition,
   isHeadroomWrappable,
@@ -3012,6 +3090,7 @@ OUTPUT JSON ONLY. NO MARKDOWN. NO COMMENTARY.
   isKnownIntegrationId,
   isKnownModel,
   isLinkedAgentId,
+  isNoopInstallSnippet,
   isPackId,
   isSkillId,
   normalizeAgentId,