@codeam/shared 2.75.4 → 2.75.5

package/dist/index.d.ts

@@ -142,14 +142,6 @@ declare function tryGetContextWindow(model: string | null): number | undefined;
 
 type AgentId = 'claude' | 'codex' | 'copilot' | 'coderabbit' | 'cursor' | 'aider' | 'gemini' | 'kimi' | 'opencode';
 type AgentAuthKind = 'oauth_token' | 'api_key' | 'setup_token';
-/**
- * The agent kinds Headroom (the token-compression proxy) can actually
- * wrap/route — the exact subcommands `headroom init --global <kind>`
- * accepts. NOT an alias of {@link AgentId}: cursor / gemini / aider run
- * native (Headroom disabled) because `headroom init` has no recipe that
- * routes them.
- */
-type HeadroomKind = 'claude' | 'codex' | 'copilot';
 interface AgentAuth {
     kind: AgentAuthKind;
     /** API key plain, or JSON serialized for oauth_token. Interpretation depends on the agent. */
@@ -201,20 +193,6 @@ interface AgentMetadata {
     enabled: boolean;
     supportedAuthKinds: AgentAuthKind[];
     preferredAuthKind: AgentAuthKind;
-    /**
-     * Whether Headroom can wrap/route this agent (claude / codex / copilot
-     * only). Canonical truth previously scattered across two prefix-matching
-     * predicates: `isHeadroomSupportedAgent` (CLI `host-agent.ts`) and
-     * `isHeadroomWrappableAgent` (api-v2 `codespaces/headroom.ts`). When
-     * false the agent MUST run native — wrapping an unsupported agent
-     * mislaunches it as Claude (the 2026-06 Cursor incident).
-     */
-    headroomWrappable: boolean;
-    /**
-     * The `headroom init --global <kind>` subcommand for this agent.
-     * Present iff {@link headroomWrappable} is true.
-     */
-    headroomKind?: HeadroomKind;
     /**
      * Whether the agent runs over ACP (Agent Client Protocol) in the CLI —
      * mirrors which agents have an entry in the CLI's ACP adapter registry
@@ -330,31 +308,6 @@ declare const TERMINAL_AGENT_PREFIX = "__terminal__:";
  *   - fall back to anything. Unknown in → `null` out.
  */
 declare function normalizeAgentId(raw: string): AgentId | null;
-/**
- * The `headroom init --global <kind>` subcommand for an agent id, derived
- * from the registry's `headroomKind` flags — or `null` for unknown or
- * non-wrappable agents (cursor / gemini / aider / anything else).
- *
- * ⚠️ NEVER falls back to `'claude'`. The historical CLI fallback is how
- * the 2026-06 Cursor incident happened: an unsupported agent slipped
- * through, defaulted to `claude`, and `headroom wrap claude` launched
- * Claude Code instead of the user's agent. Callers that genuinely need a
- * default (e.g. picking an init subcommand AFTER the wrappable gate has
- * already passed) apply it themselves — see the CLI's
- * `agentIdToHeadroomKind` wrapper.
- *
- * Matching mirrors the historical predicates on BOTH sides (CLI
- * `isHeadroomSupportedAgent`, api-v2 `isHeadroomWrappableAgent`):
- * case-insensitive, `_`/`-` tolerant, prefix match — so `claude_code`,
- * `Claude-Code`, `codex_cli`, `copilot-cli` all resolve.
- */
-declare function headroomKindFor(agentId: string): HeadroomKind | null;
-/**
- * Registry-derived replacement for the two scattered predicates
- * (`isHeadroomSupportedAgent` in the CLI, `isHeadroomWrappableAgent` in
- * api-v2). Accepts both id spaces (`claude_code` and `claude`).
- */
-declare function isHeadroomWrappable(agentId: string): boolean;
 
 /**
  * Canonical per-agent CLI **install** snippets.
@@ -1713,148 +1666,6 @@ interface BeadsActionRequest {
     projectKey?: string;
 }
 
-/**
- * Headroom budget configuration and command types.
- * Used by the CLI to enable/disable cost-saving Headroom token compression
- * and track spending against configured budgets.
- *
- * CANONICAL WIRE OWNER: this file (`@codeam/shared`) owns the wire
- * protocol, per the cross-repo rule. The backend repo keeps hand-synced
- * MIRRORS (`codeagent-mobile/packages/shared/src/types/headroom.ts` for
- * mobile/landing, `codeagent-mobile/apps/api-v2/src/common/types/headroom.ts`
- * for the backend); a drift-check script at
- * `codeagent-mobile/scripts/check-shared-drift` compares them.
- */
-type HeadroomBudgetPeriod = 'hourly' | 'daily' | 'monthly';
-/**
- * Install-progress milestone emitted on the `headroom_progress` SSE event while
- * a session is provisioning Headroom on-demand. Must stay byte-for-byte aligned
- * with the backend's `HEADROOM_STEPS` validator
- * (`apps/api-v2/src/headroom/headroom.controller.ts`) and the mobile store —
- * the backend 400s (`INVALID_STEP`) on any value outside this set. Note
- * `'provisioning'` is a `HeadroomStatus['state']`, NOT a step.
- */
-type HeadroomStep = 'pip' | 'model' | 'init' | 'proxy' | 'ready';
-/**
- * Command sent via relay to enable/disable/configure Headroom budget settings.
- * The `agentId` field is included because PairedSession has no agentId server-side,
- * so the relay command carries it for the CLI handler to guard on.
- */
-interface HeadroomBudgetCommand {
-    budgetEnabled: boolean;
-    budgetUsd?: number;
-    budgetPeriod?: HeadroomBudgetPeriod;
-    agentId?: string;
-}
-/**
- * Budget usage fields appended to the savings payload that the Headroom reporter
- * sends to the backend. Tracks spending in the current budget period.
- */
-interface HeadroomBudgetUsage {
-    periodSpendUsd?: number;
-    budgetUsd?: number;
-    budgetPeriod?: HeadroomBudgetPeriod;
-    /** True iff this turn pushed periodSpendUsd to or past budgetUsd. */
-    budgetReached?: boolean;
-}
-/**
- * Headroom cost-saving state for a session — carried on the `headroom_status`
- * SSE event and snapshotted by the backend into Redis `headroom:<sessionId>`.
- * Mirrored byte-for-byte in `apps/api-v2/src/common/types/headroom.ts`.
- */
-interface HeadroomStatus {
-    state: 'enabled' | 'disabled' | 'error' | 'provisioning';
-    running?: boolean;
-    agent?: string;
-    savings?: number;
-    error?: string;
-}
-/** One provider/model slice inside a rollup bucket. */
-interface HeadroomUsageSlice {
-    /** Tokens Headroom removed in this bucket (a DELTA, not cumulative). */
-    tokens_saved: number;
-    compression_savings_usd_delta: number;
-    total_input_tokens_delta: number;
-    total_input_cost_usd_delta: number;
-}
-/**
- * One rollup bucket. ⚠️ The `*_delta` fields (and `tokens_saved`) are
- * PER-BUCKET; the bare `total_*` fields are the CUMULATIVE value at the
- * bucket's end. Chart the deltas, show the totals as headline figures.
- */
-interface HeadroomUsageBucket {
-    /** Bucket start, UTC ISO-8601. */
-    timestamp: string;
-    tokens_saved: number;
-    compression_savings_usd_delta: number;
-    total_tokens_saved: number;
-    compression_savings_usd: number;
-    total_input_tokens_delta: number;
-    total_input_tokens: number;
-    total_input_cost_usd_delta: number;
-    total_input_cost_usd: number;
-    by_provider: Record<string, HeadroomUsageSlice>;
-    by_model: Record<string, HeadroomUsageSlice>;
-}
-type HeadroomUsageGranularity = 'hourly' | 'daily' | 'weekly' | 'monthly';
-/** Lifetime / current-window totals. */
-interface HeadroomUsageTotals {
-    requests: number;
-    tokens_saved: number;
-    compression_savings_usd: number;
-    total_input_tokens: number;
-    total_input_cost_usd: number;
-}
-/**
- * The token-usage report the CLI relays for the `headroom_usage` command — a
- * TRIMMED projection of the proxy's `GET /stats-history` (schema_version 3,
- * verified live against headroom 0.27.0).
- *
- * ⚠️ Trimmed ON THE BOX before it ever leaves, for three reasons:
- *  - the raw response is ~150 KB (and `history_mode=full` is ~1.1 MB) — too
- *    heavy for the command relay; dropping the raw `history[]` and capping the
- *    hourly series brings it to ~23 KB.
- *  - `history[]` carries CUMULATIVE counters that would have to be diffed,
- *    while `series[]` already provides per-bucket deltas AND the
- *    `by_model` / `by_provider` breakdown (richer than Headroom's own CSV
- *    export, which has no model column).
- *  - the proxy's `storage_path` leaks a local filesystem path (including the
- *    OS username) and is stripped.
- */
-interface HeadroomUsageReport {
-    /** Headroom's own payload schema version (3 at time of writing). */
-    schemaVersion: number;
-    /** When the proxy generated the snapshot (UTC ISO-8601). */
-    generatedAt: string;
-    /** Proxy version that produced it, when known. */
-    proxyVersion?: string;
-    /** Durable, all-time totals across proxy restarts. */
-    lifetime: HeadroomUsageTotals;
-    /** The proxy's current display session (rolls over after inactivity). */
-    currentSession?: HeadroomUsageTotals & {
-        savings_percent?: number;
-        started_at?: string | null;
-        last_activity_at?: string | null;
-    };
-    /** Rollups. `hourly` is capped to the most recent buckets to bound size. */
-    series: Partial<Record<HeadroomUsageGranularity, HeadroomUsageBucket[]>>;
-    /** The proxy's retention policy, so the UI can state the window honestly. */
-    retention?: {
-        max_history_points?: number;
-        max_history_age_days?: number;
-    };
-}
-/** Result of the `headroom_usage` relay command. */
-interface HeadroomUsageResult {
-    /** False when the proxy isn't reachable / Headroom isn't active here. */
-    available: boolean;
-    report?: HeadroomUsageReport;
-    /** Human-readable reason when `available` is false. */
-    error?: string;
-}
-/** 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.
@@ -2035,84 +1846,6 @@ interface SquadStatsResult {
 /** 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:
- *
- *   - codespace bootstrap (bash composer in the backend repo,
- *     `apps/api-v2/src/codespaces/github-ssh.service.ts` — adopts in PR-2),
- *   - self-hosted deploy (TS installer, CLI `commands/host-agent.ts`
- *     `setupHeadroomForSelfHosted`),
- *   - on-demand local sessions ("Session add-ons → Cost-saving", CLI
- *     `services/headroom/configure.ts`).
- *
- * Values are DATA-first (arrays/records, plus tiny pure renderers) so both
- * the TS installer and a bash composer can interpolate from them. Renderers
- * are byte-exact with the literals they replaced — guarded by
- * `packages/shared/__tests__/headroom-manifest.test.ts`.
- *
- * ⚠️ The extras matter: `[proxy,code]` pulls the ONNX compression engines
- * (Kompress + tree-sitter CodeCompressor). NEVER add `[ml]` — that's
- * multi-GB PyTorch, and a broken/cold torch wedges every prompt at
- * "Thinking…". The models are pre-downloaded at provision time because the
- * proxy eager-loads with `allow_download=False` and a cold cache defers the
- * ~840 MB download to the first prompt (blowing the agent's ~90 s idle
- * timeout).
- */
-/** Local proxy port the agent's config is routed to. */
-declare const HEADROOM_PROXY_PORT = 8787;
-/**
- * Env that pins the ONNX backend on the proxy process — never imports
- * torch. Spread into the proxy launch env on every surface.
- */
-declare const HEADROOM_BACKEND_ENV: {
-    readonly HEADROOM_KOMPRESS_BACKEND: "onnx_cpu";
-};
-/**
- * The proxy's HTTP/server companion packages, installed alongside the
- * `headroom-ai[...]` package. The COMPRESSION ENGINES come from the
- * headroom-ai extras — NOT this list.
- */
-declare const HEADROOM_PIP_COMPANIONS: readonly string[];
-/** The three provisioning surfaces (see module doc). */
-type HeadroomSurface = 'codespace' | 'selfHosted' | 'onDemand';
-/**
- * pip extras per surface. `onDemand` additionally ships `image`
- * (image-compression support, added with the Session add-ons path in
- * codeam-cli@2.49.0); the older codespace/self-hosted install strings
- * remain `[proxy,code]` byte-for-byte.
- */
-declare const HEADROOM_EXTRAS_BY_SURFACE: Readonly<Record<HeadroomSurface, readonly string[]>>;
-/** `headroom-ai[<extras>]` — the pip requirement string. */
-declare function headroomPipPackage(extras: readonly string[]): string;
-/** One HuggingFace repo to pre-warm into the HF cache at provision time. */
-interface HeadroomModelSpec {
-    repo: string;
-    /** `snapshot_download(..., allow_patterns=[…])` filter. */
-    allowPatterns: readonly string[];
-}
-/**
- * The two HF repos Kompress needs. kompress-v2-base is the ONNX model
- * (skip its .pt/.safetensors torch artifacts); ModernBERT-base is the
- * TOKENIZER ONLY (skip its model weights).
- */
-declare const HEADROOM_MODELS: readonly HeadroomModelSpec[];
-/** Formatting knob so each surface can stay byte-identical to its
- *  historical literal (the CLI joins patterns with `,`, the codespace
- *  bash composer with `, `). */
-interface HeadroomPythonRenderOpts {
-    /** Put a space after the commas between allow_patterns entries. */
-    spaceAfterComma?: boolean;
-}
-/** Render one `snapshot_download(...)` python line for a model. */
-declare function headroomSnapshotDownloadLine(model: HeadroomModelSpec, opts?: HeadroomPythonRenderOpts): string;
-/**
- * The full model pre-download python snippet (import + one
- * `snapshot_download` per model), newline-joined — what the surfaces pass
- * to `python -c` / a heredoc.
- */
-declare function headroomModelPredownloadScript(opts?: HeadroomPythonRenderOpts): string;
-
 /**
  * Canonical names of the per-user SSE bus events (`/api/users/me/stream`).
  *
@@ -2157,7 +1890,6 @@ declare const USER_EVENTS: {
     readonly CREDENTIAL_INVALID: "credential_invalid";
     readonly CODESPACE_WAKING: "codespace_waking";
     readonly CODESPACE_BILLING_BLOCKED: "codespace_billing_blocked";
-    readonly COST_SAVING_UPDATED: "cost_saving_updated";
     readonly COMMAND_COMPLETED: "command_completed";
     readonly AI_SUMMARY_PENDING: "ai_summary_pending";
     readonly AI_SUMMARY_READY: "ai_summary_ready";
@@ -2199,10 +1931,7 @@ declare const USER_EVENTS: {
      *  a box never creates. */
     readonly FLEET_BOX_READY: "fleet_box_ready";
     readonly REFERRAL_REWARD_EARNED: "referral_reward_earned";
-    readonly HEADROOM_PROGRESS: "headroom_progress";
-    readonly HEADROOM_STATUS: "headroom_status";
     readonly BEADS_STATUS: "beads_status";
-    readonly LINKED_AGENT_HEADROOM_BUDGET_UPDATED: "linked_agent_headroom_budget_updated";
     readonly CLI_UPDATE_AVAILABLE: "cli_update_available";
     readonly AGENT_INSTALL_PROGRESS: "agent_install_progress";
     readonly AGENT_INSTALL_FAILED: "agent_install_failed";
@@ -2237,6 +1966,14 @@ declare const USER_EVENTS: {
      *  debits: those are one per agent hop, and the client already walks its
      *  own balance down as metered usage streams in. */
     readonly CREDITS_CHANGED: "credits_changed";
+    /** La recarga automatica NO se hizo, y el motivo significa algo para el
+     *  usuario (enfriamiento, tope diario o mensual, pausada, apagada).
+     *  ⚠️ Existe porque antes el saldo llegaba a cero EN SILENCIO: la sesion se
+     *  paraba y no habia una sola pista de por que no se habia recargado sola
+     *  (2026-09-17). Los motivos internos —`duplicate_intent` y compañia— no se
+     *  publican: no dicen nada a quien los lee. El CLI no lo consume; vive aqui
+     *  porque este fichero es la fuente del espejo que valida `shared-type-drift`. */
+    readonly AUTO_RECHARGE_BLOCKED: "auto_recharge_blocked";
 };
 type UserEventName = (typeof USER_EVENTS)[keyof typeof USER_EVENTS];
 
@@ -2252,4 +1989,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 AwaitingAnswerOption, 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, MANAGED_AGENT_ENV, MANAGED_AGENT_SUBTITLE, MANAGED_PROVIDER_DISPLAY_NAMES, MANAGED_PROVIDER_IDS, MODEL_CONTEXT_WINDOW, MODEL_PRICING, type ManagedProviderId, type MissingService, 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 StartTaskFailedResult, 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, isManagedProviderId, isNoopInstallSnippet, 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 AwaitingAnswerOption, 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, HEARTBEAT_INTERVAL_MS_DEFAULT, HOUSE_AGENT_ID, HOUSE_AGENT_NAME, HOUSE_AGENT_PROVIDER, HOUSE_AGENT_SUBTITLE, HOUSE_AGENT_VENDOR, type HandoffProposal, type HandoffResolution, 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, MANAGED_AGENT_ENV, MANAGED_AGENT_SUBTITLE, MANAGED_PROVIDER_DISPLAY_NAMES, MANAGED_PROVIDER_IDS, MODEL_CONTEXT_WINDOW, MODEL_PRICING, type ManagedProviderId, type MissingService, 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 StartTaskFailedResult, 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, installableAgentIds, internalToPublic, isGuardrailDisposition, isKnownAgentId, isKnownIntegrationId, isKnownModel, isLinkedAgentId, isManagedProviderId, isNoopInstallSnippet, isPackId, isSkillId, normalizeAgentId, normalizeGuardrailPolicy, publicToInternal, recommendForDeps, renderToLines, resolveApiBaseUrl, skillHasRail, toRemoteCommand, tryGetContextWindow };

package/dist/index.js

@@ -34,12 +34,6 @@ __export(index_exports, {
   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,
-  HEADROOM_PIP_COMPANIONS: () => HEADROOM_PIP_COMPANIONS,
-  HEADROOM_PROXY_PORT: () => HEADROOM_PROXY_PORT,
-  HEADROOM_USAGE_COMMAND: () => HEADROOM_USAGE_COMMAND,
   HEARTBEAT_INTERVAL_MS_DEFAULT: () => HEARTBEAT_INTERVAL_MS_DEFAULT,
   HOUSE_AGENT_ID: () => HOUSE_AGENT_ID,
   HOUSE_AGENT_NAME: () => HOUSE_AGENT_NAME,
@@ -96,14 +90,9 @@ __export(index_exports, {
   getPackDefinition: () => getPackDefinition,
   getPricing: () => getPricing,
   getSkillDefinition: () => getSkillDefinition,
-  headroomKindFor: () => headroomKindFor,
-  headroomModelPredownloadScript: () => headroomModelPredownloadScript,
-  headroomPipPackage: () => headroomPipPackage,
-  headroomSnapshotDownloadLine: () => headroomSnapshotDownloadLine,
   installableAgentIds: () => installableAgentIds,
   internalToPublic: () => internalToPublic,
   isGuardrailDisposition: () => isGuardrailDisposition,
-  isHeadroomWrappable: () => isHeadroomWrappable,
   isKnownAgentId: () => isKnownAgentId,
   isKnownIntegrationId: () => isKnownIntegrationId,
   isKnownModel: () => isKnownModel,
@@ -356,8 +345,6 @@ var AGENT_REGISTRY = {
     // `claude setup-token` → delivered via CLAUDE_CODE_OAUTH_TOKEN.
     supportedAuthKinds: ["setup_token", "oauth_token", "api_key"],
     preferredAuthKind: "setup_token",
-    headroomWrappable: true,
-    headroomKind: "claude",
     // npm adapter `@agentclientprotocol/claude-agent-acp`.
     acp: true
   },
@@ -368,8 +355,6 @@ var AGENT_REGISTRY = {
     enabled: true,
     supportedAuthKinds: ["oauth_token", "api_key"],
     preferredAuthKind: "oauth_token",
-    headroomWrappable: true,
-    headroomKind: "codex",
     // npm adapter `@agentclientprotocol/codex-acp`.
     acp: true,
     // OAuth device-code flow; the user_code on the OpenAI page IS a real
@@ -384,10 +369,7 @@ var AGENT_REGISTRY = {
     enabled: false,
     supportedAuthKinds: ["oauth_token"],
     preferredAuthKind: "oauth_token",
-    // `headroom init --global copilot` exists even though the agent is
     // still disabled here (no runtime builder yet).
-    headroomWrappable: true,
-    headroomKind: "copilot",
     acp: false
   },
   coderabbit: {
@@ -403,7 +385,6 @@ var AGENT_REGISTRY = {
     // user's own machine, so linking is always CLI-mediated.
     supportedAuthKinds: ["oauth_token", "api_key"],
     preferredAuthKind: "oauth_token",
-    headroomWrappable: false,
     // Legacy PTY runtime — no ACP adapter registered.
     acp: false
   },
@@ -419,9 +400,7 @@ var AGENT_REGISTRY = {
     // no longer offers api_key.
     supportedAuthKinds: ["oauth_token"],
     preferredAuthKind: "oauth_token",
-    // `headroom wrap cursor` is "manual/print-only" (IDE settings; the
     // headless cursor-agent CLI has no base-URL override) — runs native.
-    headroomWrappable: false,
     // Native ACP server: `cursor-agent acp`.
     acp: true,
     // Reverse-engineered device/poll flow; `userCode` is the secret PKCE
@@ -439,7 +418,6 @@ var AGENT_REGISTRY = {
     // this via the existing --api-key escape hatch in commands/link.ts.
     supportedAuthKinds: ["api_key"],
     preferredAuthKind: "api_key",
-    headroomWrappable: false,
     // Legacy PTY runtime — no ACP adapter registered.
     acp: false
   },
@@ -476,8 +454,6 @@ var AGENT_REGISTRY = {
     // provider, where the ineligible-tier message already explains why.
     supportedAuthKinds: ["api_key"],
     preferredAuthKind: "api_key",
-    // Not listed by `headroom wrap --help` — runs native.
-    headroomWrappable: false,
     // Native ACP server: `gemini --skip-trust --acp`.
     acp: true
   },
@@ -493,8 +469,6 @@ var AGENT_REGISTRY = {
     // that blob server-side is a separate reverse-engineering spike (phase 2).
     supportedAuthKinds: ["api_key", "oauth_token"],
     preferredAuthKind: "api_key",
-    // Moonshot's `kimi` is not listed by `headroom wrap --help` — runs native.
-    headroomWrappable: false,
     // Native ACP server: `kimi acp` (stdio JSON-RPC, answers `initialize`).
     acp: true
   },
@@ -509,8 +483,6 @@ var AGENT_REGISTRY = {
     // the matching env var (detected by prefix) at deploy. api_key only.
     supportedAuthKinds: ["api_key"],
     preferredAuthKind: "api_key",
-    // Not listed by `headroom init --global` (claude/codex/copilot only) — native.
-    headroomWrappable: false,
     // Native ACP server: `opencode acp` (stdio JSON-RPC).
     acp: true
   }
@@ -642,19 +614,6 @@ function normalizeAgentId(raw) {
   if (isKnownAgentId(unprefixed)) return unprefixed;
   return AGENT_ID_ALIASES[unprefixed] ?? null;
 }
-function headroomKindFor(agentId) {
-  const normalized = (agentId ?? "").toLowerCase().replace(/[_-]/g, "");
-  if (!normalized) return null;
-  for (const meta of Object.values(AGENT_REGISTRY)) {
-    if (meta.headroomKind !== void 0 && normalized.startsWith(meta.id)) {
-      return meta.headroomKind;
-    }
-  }
-  return null;
-}
-function isHeadroomWrappable(agentId) {
-  return headroomKindFor(agentId) !== null;
-}
 
 // src/agents/install-snippets.ts
 var CODEX = `
@@ -2906,9 +2865,6 @@ function resolveApiBaseUrl() {
   return DEFAULT_API_BASE_URL;
 }
 
-// src/types/headroom.ts
-var HEADROOM_USAGE_COMMAND = "headroom_usage";
-
 // src/types/agent-switch.ts
 var SWITCH_AGENT_COMMAND = "switch_agent";
 
@@ -2932,48 +2888,6 @@ var SQUAD_SPECIALTIES = {
   opencode: "general implementation tasks"
 };
 
-// src/headroom/manifest.ts
-var HEADROOM_PROXY_PORT = 8787;
-var HEADROOM_BACKEND_ENV = {
-  HEADROOM_KOMPRESS_BACKEND: "onnx_cpu"
-};
-var HEADROOM_PIP_COMPANIONS = [
-  "fastapi",
-  "uvicorn",
-  "httpx[http2]",
-  "websockets",
-  "zstandard"
-];
-var HEADROOM_EXTRAS_BY_SURFACE = {
-  codespace: ["proxy", "code"],
-  selfHosted: ["proxy", "code"],
-  onDemand: ["proxy", "code", "image"]
-};
-function headroomPipPackage(extras) {
-  return `headroom-ai[${extras.join(",")}]`;
-}
-var HEADROOM_MODELS = [
-  {
-    repo: "chopratejas/kompress-v2-base",
-    allowPatterns: ["*.json", "onnx/*.onnx", "kompress-int8-wo.onnx"]
-  },
-  {
-    repo: "answerdotai/ModernBERT-base",
-    allowPatterns: ["*.json", "tokenizer*", "*.txt", "vocab*", "merges*"]
-  }
-];
-function headroomSnapshotDownloadLine(model, opts = {}) {
-  const sep = opts.spaceAfterComma ? ", " : ",";
-  const patterns = model.allowPatterns.map((p) => `"${p}"`).join(sep);
-  return `snapshot_download("${model.repo}", allow_patterns=[${patterns}])`;
-}
-function headroomModelPredownloadScript(opts = {}) {
-  return [
-    "from huggingface_hub import snapshot_download",
-    ...HEADROOM_MODELS.map((m) => headroomSnapshotDownloadLine(m, opts))
-  ].join("\n");
-}
-
 // src/types/events.ts
 var USER_EVENTS = {
   PAIRED_SESSION_STATUS: "paired_session_status",
@@ -3005,7 +2919,6 @@ var USER_EVENTS = {
   CREDENTIAL_INVALID: "credential_invalid",
   CODESPACE_WAKING: "codespace_waking",
   CODESPACE_BILLING_BLOCKED: "codespace_billing_blocked",
-  COST_SAVING_UPDATED: "cost_saving_updated",
   COMMAND_COMPLETED: "command_completed",
   AI_SUMMARY_PENDING: "ai_summary_pending",
   AI_SUMMARY_READY: "ai_summary_ready",
@@ -3047,10 +2960,7 @@ var USER_EVENTS = {
    *  a box never creates. */
   FLEET_BOX_READY: "fleet_box_ready",
   REFERRAL_REWARD_EARNED: "referral_reward_earned",
-  HEADROOM_PROGRESS: "headroom_progress",
-  HEADROOM_STATUS: "headroom_status",
   BEADS_STATUS: "beads_status",
-  LINKED_AGENT_HEADROOM_BUDGET_UPDATED: "linked_agent_headroom_budget_updated",
   CLI_UPDATE_AVAILABLE: "cli_update_available",
   AGENT_INSTALL_PROGRESS: "agent_install_progress",
   AGENT_INSTALL_FAILED: "agent_install_failed",
@@ -3100,7 +3010,15 @@ var USER_EVENTS = {
    *  balance, so nothing has to be fetched to render it. ⚠️ NOT published on
    *  debits: those are one per agent hop, and the client already walks its
    *  own balance down as metered usage streams in. */
-  CREDITS_CHANGED: "credits_changed"
+  CREDITS_CHANGED: "credits_changed",
+  /** La recarga automatica NO se hizo, y el motivo significa algo para el
+   *  usuario (enfriamiento, tope diario o mensual, pausada, apagada).
+   *  ⚠️ Existe porque antes el saldo llegaba a cero EN SILENCIO: la sesion se
+   *  paraba y no habia una sola pista de por que no se habia recargado sola
+   *  (2026-09-17). Los motivos internos —`duplicate_intent` y compañia— no se
+   *  publican: no dicen nada a quien los lee. El CLI no lo consume; vive aqui
+   *  porque este fichero es la fuente del espejo que valida `shared-type-drift`. */
+  AUTO_RECHARGE_BLOCKED: "auto_recharge_blocked"
 };
 
 // src/preview-prompts.ts
@@ -3165,12 +3083,6 @@ OUTPUT JSON ONLY. NO MARKDOWN. NO COMMENTARY.
   GUARDRAIL_CONFIGURE_COMMAND,
   GUARDRAIL_DISPOSITIONS,
   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,
@@ -3227,14 +3139,9 @@ OUTPUT JSON ONLY. NO MARKDOWN. NO COMMENTARY.
   getPackDefinition,
   getPricing,
   getSkillDefinition,
-  headroomKindFor,
-  headroomModelPredownloadScript,
-  headroomPipPackage,
-  headroomSnapshotDownloadLine,
   installableAgentIds,
   internalToPublic,
   isGuardrailDisposition,
-  isHeadroomWrappable,
   isKnownAgentId,
   isKnownIntegrationId,
   isKnownModel,