@codeam/shared 2.63.1 → 2.65.0

package/dist/index.d.mts

@@ -1774,6 +1774,110 @@ interface SwitchAgentResult {
     error?: string;
 }
 
+/**
+ * Agent Squad wire types — @-mention routing, roster, and agent-proposed
+ * handoffs. Canonical owner (api-v2 + mobile consume the published npm
+ * package; the cm-repo packages/shared mirror re-exports).
+ * Spec: docs/superpowers/specs/2026-08-13-agent-squad-mentions-handoffs-design.md
+ */
+
+/** start_task payload — makes the previously-dead agentId field a real wire contract. */
+interface StartTaskPayload {
+    prompt?: string;
+    files?: Array<{
+        filename: string;
+        base64?: string;
+        mimeType?: string;
+    }>;
+    /** Internal runtime id. Present + ≠ active agent → the runner swaps before running. */
+    agentId?: string;
+}
+interface SquadRosterAgent {
+    agentId: string;
+    displayName: string;
+}
+/** Response data of POST /api/plugin/agents/roster. */
+interface SquadRosterData {
+    agents: SquadRosterAgent[];
+    handoffsEnabled: boolean;
+}
+/** The fence tag the active agent uses to propose a handoff (PRO). */
+declare const HANDOFF_FENCE_TAG = "codeam-handoff";
+interface HandoffProposal {
+    proposalId: string;
+    fromAgentId: string;
+    toAgentId: string;
+    reason: string;
+    prompt: string;
+    /**
+     * Autonomous mode (P2-2): the CLI accepted this proposal ITSELF instead of
+     * emitting the tap-to-accept card. Mobile renders a passive timeline notice
+     * for `auto: true`, never the accept card. Absent = the v1 card flow.
+     */
+    auto?: boolean;
+    /**
+     * Hops left in the chain AFTER this one (`auto` only) — the hop is already
+     * spent when this is emitted, so `0` means "this is the last auto hop; any
+     * further proposal falls back to the card". Mobile renders it verbatim as
+     * "<n> hops left".
+     */
+    hopsRemaining?: number;
+}
+/** `handoff_resolved` event payload. `auto` mirrors {@link HandoffProposal}. */
+interface HandoffResolution {
+    proposalId: string;
+    accepted: boolean;
+    auto?: boolean;
+}
+/** Relay command: read/write the session's autonomous-handoff mode. */
+declare const SQUAD_CONFIGURE_COMMAND = "squad_configure";
+/** Relay command: per-member activity for the "Squad activity" screen. */
+declare const SQUAD_STATS_COMMAND = "squad_stats";
+declare const SQUAD_HOP_BUDGET_DEFAULT = 3;
+declare const SQUAD_HOP_BUDGET_MIN = 1;
+declare const SQUAD_HOP_BUDGET_MAX = 10;
+/**
+ * Clamp a caller-supplied hop budget into the supported range, falling back to
+ * the default for a missing / non-finite value. The ONE place the bound lives —
+ * the CLI's config mutator and its `squad_configure` handler both call it.
+ */
+declare function clampHopBudget(value: unknown): number;
+/** Persisted per-session autonomous-handoff mode. Default OFF. */
+interface SquadAutoConfig {
+    enabled: boolean;
+    hopBudget: number;
+}
+type SquadConfigurePayload = {
+    action: 'set';
+    autoHandoffs: boolean;
+    hopBudget?: number;
+} | {
+    action: 'status';
+};
+/** Ack of {@link SQUAD_CONFIGURE_COMMAND} — the state AFTER the command. */
+interface SquadConfigureResult extends SquadAutoConfig {
+    /** Hops left in the current chain (resets on every user prompt). */
+    hopsRemaining: number;
+}
+interface SquadMemberActivity {
+    agentId: string;
+    turns: number;
+    /** DISTINCT paths this member touched across its journaled turns. */
+    filesTouched: number;
+}
+/** Ack of {@link SQUAD_STATS_COMMAND}. No cost attribution in v1. */
+interface SquadStatsResult {
+    members: SquadMemberActivity[];
+    handoffs: {
+        proposed: number;
+        accepted: number;
+        auto: number;
+    };
+    sinceTurn: number;
+}
+/** Per-agent specialty blurbs for the team preamble. Copy, not routing. */
+declare const SQUAD_SPECIALTIES: Readonly<Partial<Record<AgentId, string>>>;
+
 /**
  * Headroom provisioning manifest — the SINGLE source of truth for what a
  * Headroom install consists of, rendered by every provisioning surface:
@@ -1946,6 +2050,8 @@ declare const USER_EVENTS: {
     readonly CODERABBIT_REVIEW: "coderabbit_review";
     readonly SWITCH_AGENT_PROGRESS: "switch_agent_progress";
     readonly SWITCH_AGENT_STATUS: "switch_agent_status";
+    readonly HANDOFF_PROPOSED: "handoff_proposed";
+    readonly HANDOFF_RESOLVED: "handoff_resolved";
     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,
@@ -1972,4 +2078,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, 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 };
+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 };

package/dist/index.d.ts

@@ -1774,6 +1774,110 @@ interface SwitchAgentResult {
     error?: string;
 }
 
+/**
+ * Agent Squad wire types — @-mention routing, roster, and agent-proposed
+ * handoffs. Canonical owner (api-v2 + mobile consume the published npm
+ * package; the cm-repo packages/shared mirror re-exports).
+ * Spec: docs/superpowers/specs/2026-08-13-agent-squad-mentions-handoffs-design.md
+ */
+
+/** start_task payload — makes the previously-dead agentId field a real wire contract. */
+interface StartTaskPayload {
+    prompt?: string;
+    files?: Array<{
+        filename: string;
+        base64?: string;
+        mimeType?: string;
+    }>;
+    /** Internal runtime id. Present + ≠ active agent → the runner swaps before running. */
+    agentId?: string;
+}
+interface SquadRosterAgent {
+    agentId: string;
+    displayName: string;
+}
+/** Response data of POST /api/plugin/agents/roster. */
+interface SquadRosterData {
+    agents: SquadRosterAgent[];
+    handoffsEnabled: boolean;
+}
+/** The fence tag the active agent uses to propose a handoff (PRO). */
+declare const HANDOFF_FENCE_TAG = "codeam-handoff";
+interface HandoffProposal {
+    proposalId: string;
+    fromAgentId: string;
+    toAgentId: string;
+    reason: string;
+    prompt: string;
+    /**
+     * Autonomous mode (P2-2): the CLI accepted this proposal ITSELF instead of
+     * emitting the tap-to-accept card. Mobile renders a passive timeline notice
+     * for `auto: true`, never the accept card. Absent = the v1 card flow.
+     */
+    auto?: boolean;
+    /**
+     * Hops left in the chain AFTER this one (`auto` only) — the hop is already
+     * spent when this is emitted, so `0` means "this is the last auto hop; any
+     * further proposal falls back to the card". Mobile renders it verbatim as
+     * "<n> hops left".
+     */
+    hopsRemaining?: number;
+}
+/** `handoff_resolved` event payload. `auto` mirrors {@link HandoffProposal}. */
+interface HandoffResolution {
+    proposalId: string;
+    accepted: boolean;
+    auto?: boolean;
+}
+/** Relay command: read/write the session's autonomous-handoff mode. */
+declare const SQUAD_CONFIGURE_COMMAND = "squad_configure";
+/** Relay command: per-member activity for the "Squad activity" screen. */
+declare const SQUAD_STATS_COMMAND = "squad_stats";
+declare const SQUAD_HOP_BUDGET_DEFAULT = 3;
+declare const SQUAD_HOP_BUDGET_MIN = 1;
+declare const SQUAD_HOP_BUDGET_MAX = 10;
+/**
+ * Clamp a caller-supplied hop budget into the supported range, falling back to
+ * the default for a missing / non-finite value. The ONE place the bound lives —
+ * the CLI's config mutator and its `squad_configure` handler both call it.
+ */
+declare function clampHopBudget(value: unknown): number;
+/** Persisted per-session autonomous-handoff mode. Default OFF. */
+interface SquadAutoConfig {
+    enabled: boolean;
+    hopBudget: number;
+}
+type SquadConfigurePayload = {
+    action: 'set';
+    autoHandoffs: boolean;
+    hopBudget?: number;
+} | {
+    action: 'status';
+};
+/** Ack of {@link SQUAD_CONFIGURE_COMMAND} — the state AFTER the command. */
+interface SquadConfigureResult extends SquadAutoConfig {
+    /** Hops left in the current chain (resets on every user prompt). */
+    hopsRemaining: number;
+}
+interface SquadMemberActivity {
+    agentId: string;
+    turns: number;
+    /** DISTINCT paths this member touched across its journaled turns. */
+    filesTouched: number;
+}
+/** Ack of {@link SQUAD_STATS_COMMAND}. No cost attribution in v1. */
+interface SquadStatsResult {
+    members: SquadMemberActivity[];
+    handoffs: {
+        proposed: number;
+        accepted: number;
+        auto: number;
+    };
+    sinceTurn: number;
+}
+/** Per-agent specialty blurbs for the team preamble. Copy, not routing. */
+declare const SQUAD_SPECIALTIES: Readonly<Partial<Record<AgentId, string>>>;
+
 /**
  * Headroom provisioning manifest — the SINGLE source of truth for what a
  * Headroom install consists of, rendered by every provisioning surface:
@@ -1946,6 +2050,8 @@ declare const USER_EVENTS: {
     readonly CODERABBIT_REVIEW: "coderabbit_review";
     readonly SWITCH_AGENT_PROGRESS: "switch_agent_progress";
     readonly SWITCH_AGENT_STATUS: "switch_agent_status";
+    readonly HANDOFF_PROPOSED: "handoff_proposed";
+    readonly HANDOFF_RESOLVED: "handoff_resolved";
     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,
@@ -1972,4 +2078,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, 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 };
+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 };

package/dist/index.js

@@ -33,6 +33,7 @@ __export(index_exports, {
   GUARDRAIL_CATEGORY_META: () => GUARDRAIL_CATEGORY_META,
   GUARDRAIL_CONFIGURE_COMMAND: () => GUARDRAIL_CONFIGURE_COMMAND,
   GUARDRAIL_DISPOSITIONS: () => GUARDRAIL_DISPOSITIONS,
+  HANDOFF_FENCE_TAG: () => HANDOFF_FENCE_TAG,
   HEADROOM_BACKEND_ENV: () => HEADROOM_BACKEND_ENV,
   HEADROOM_EXTRAS_BY_SURFACE: () => HEADROOM_EXTRAS_BY_SURFACE,
   HEADROOM_MODELS: () => HEADROOM_MODELS,
@@ -64,6 +65,12 @@ __export(index_exports, {
   REVIEWER_PROMPT: () => REVIEWER_PROMPT,
   SKILL_REGISTRY: () => SKILL_REGISTRY,
   SPECIFIER_PROMPT: () => SPECIFIER_PROMPT,
+  SQUAD_CONFIGURE_COMMAND: () => SQUAD_CONFIGURE_COMMAND,
+  SQUAD_HOP_BUDGET_DEFAULT: () => SQUAD_HOP_BUDGET_DEFAULT,
+  SQUAD_HOP_BUDGET_MAX: () => SQUAD_HOP_BUDGET_MAX,
+  SQUAD_HOP_BUDGET_MIN: () => SQUAD_HOP_BUDGET_MIN,
+  SQUAD_SPECIALTIES: () => SQUAD_SPECIALTIES,
+  SQUAD_STATS_COMMAND: () => SQUAD_STATS_COMMAND,
   SSE_SOCKET_TIMEOUT_MS: () => SSE_SOCKET_TIMEOUT_MS,
   STACK_TO_RECOMMENDED: () => STACK_TO_RECOMMENDED,
   SWITCH_AGENT_COMMAND: () => SWITCH_AGENT_COMMAND,
@@ -71,6 +78,7 @@ __export(index_exports, {
   UNKNOWN_MODEL_PRICING: () => UNKNOWN_MODEL_PRICING,
   UPCOMING_INTEGRATION_IDS: () => UPCOMING_INTEGRATION_IDS,
   USER_EVENTS: () => USER_EVENTS,
+  clampHopBudget: () => clampHopBudget,
   classifyStack: () => classifyStack,
   detectedIntegrationsFromDeps: () => detectedIntegrationsFromDeps,
   getAgent: () => getAgent,
@@ -2700,6 +2708,26 @@ var HEADROOM_USAGE_COMMAND = "headroom_usage";
 // src/types/agent-switch.ts
 var SWITCH_AGENT_COMMAND = "switch_agent";
 
+// src/types/agent-squad.ts
+var HANDOFF_FENCE_TAG = "codeam-handoff";
+var SQUAD_CONFIGURE_COMMAND = "squad_configure";
+var SQUAD_STATS_COMMAND = "squad_stats";
+var SQUAD_HOP_BUDGET_DEFAULT = 3;
+var SQUAD_HOP_BUDGET_MIN = 1;
+var SQUAD_HOP_BUDGET_MAX = 10;
+function clampHopBudget(value) {
+  if (typeof value !== "number" || !Number.isFinite(value)) return SQUAD_HOP_BUDGET_DEFAULT;
+  return Math.min(SQUAD_HOP_BUDGET_MAX, Math.max(SQUAD_HOP_BUDGET_MIN, Math.round(value)));
+}
+var SQUAD_SPECIALTIES = {
+  claude: "deep reasoning, refactors, and multi-step architecture work",
+  codex: "fast, focused implementation and test fixing",
+  cursor: "multi-file edits and codebase-wide changes",
+  gemini: "large-context analysis across big files and logs",
+  kimi: "long-context code reading and summarization",
+  opencode: "general implementation tasks"
+};
+
 // src/headroom/manifest.ts
 var HEADROOM_PROXY_PORT = 8787;
 var HEADROOM_BACKEND_ENV = {
@@ -2835,6 +2863,9 @@ var USER_EVENTS = {
   // 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",
+  // Agent Squad — the CLI posts these to /api/agent-switch/events; PRO-gated.
+  HANDOFF_PROPOSED: "handoff_proposed",
+  HANDOFF_RESOLVED: "handoff_resolved",
   // 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.
@@ -2912,6 +2943,7 @@ OUTPUT JSON ONLY. NO MARKDOWN. NO COMMENTARY.
   GUARDRAIL_CATEGORY_META,
   GUARDRAIL_CONFIGURE_COMMAND,
   GUARDRAIL_DISPOSITIONS,
+  HANDOFF_FENCE_TAG,
   HEADROOM_BACKEND_ENV,
   HEADROOM_EXTRAS_BY_SURFACE,
   HEADROOM_MODELS,
@@ -2943,6 +2975,12 @@ OUTPUT JSON ONLY. NO MARKDOWN. NO COMMENTARY.
   REVIEWER_PROMPT,
   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,
@@ -2950,6 +2988,7 @@ OUTPUT JSON ONLY. NO MARKDOWN. NO COMMENTARY.
   UNKNOWN_MODEL_PRICING,
   UPCOMING_INTEGRATION_IDS,
   USER_EVENTS,
+  clampHopBudget,
   classifyStack,
   detectedIntegrationsFromDeps,
   getAgent,