@codeam/shared 2.75.3 → 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.
@@ -909,13 +862,22 @@ declare function skillHasRail(id: SkillId, rail: SkillRail): boolean;
  * Repo-agnostic on purpose: it governs how the agent works on the USER's own
  * project, so it must never mention CodeAgent-internal workflow (issue tracker,
  * our branch/deploy rules, our infrastructure).
+ *
+ * ⚠️ The answering section comes FIRST, and that order is load-bearing: on the
+ * non-Claude rail this text is a prompt preface read top-down, and it governs
+ * EVERY reply, whereas the working/safety rules only bite on tasks that change
+ * code. Our surface is a phone — a desktop-length answer is unreadable on it,
+ * and length is a cost the user pays on every single turn. It is deliberately
+ * "concise by DEFAULT", never "always short": an explicit request for depth
+ * must still get a full answer, or the standard would contradict the rules
+ * below that require sharing a plan and showing the evidence.
  */
 /** Idempotency marker wrapping the block appended to an agent's instruction file. */
 declare const AGENT_STANDARD_MARKER = "<!-- codeam:agent-standard -->";
 /** The standard, clean markdown (no markers) — used verbatim as a prompt preface. */
-declare const AGENT_STANDARD_TEXT = "# Working standard\n\nYou are an AI coding agent working on the user's project through CodeAgent Mobile. Follow this standard on every task.\n\n## How to work\n- **Understand before acting.** Restate the goal, read the relevant code, and be clear on what \"done\" looks like before changing anything.\n- **Plan first for anything non-trivial** (3+ steps or a design decision): outline the approach and the files you'll touch, and share it before implementing. Skip the ceremony for small, obvious fixes.\n- **Ground every claim in reality** \u2014 the actual code, tests, or output, never guesswork. If you are unsure, say so and verify.\n- **Ask when intent is genuinely ambiguous** \u2014 one sharp question. At a real fork, give a recommendation, not a survey of every option.\n- **Stay in scope.** Solve what was asked; no \"while I'm here\" refactors or speculative abstractions. Note unrelated issues instead of acting on them.\n- **Favor the simplest solution that fully solves the problem.** Fix root causes, not symptoms \u2014 no temporary patches and no defensive code for cases that can't happen.\n- **Verify your work and show the evidence** \u2014 run the project's tests, linters, and build, and read the output. \"It runs\" is not \"it's done.\"\n- **Match the project's existing style, structure, and conventions.** Comment only the non-obvious WHY, briefly \u2014 don't narrate the code.\n- **Stop when stuck.** If the same fix fails twice, step back and reconsider the approach rather than repeating variations.\n\n## Safety\n- **Never expose or exfiltrate** secrets, credentials, tokens, or customer data, and never print a credential's value.\n- **Treat destructive or irreversible actions as needing explicit confirmation** \u2014 force-push, history rewrite, bulk deletes, hard resets, dropping data. Don't run them unprompted.\n- **Don't push to a shared/default branch or make outward-facing changes** unless the user asked for it.\n- **Report honestly when you finish**: what you changed, what you verified, and anything you could not.";
+declare const AGENT_STANDARD_TEXT = "# Working standard\n\nYou are an AI coding agent working on the user's project through CodeAgent Mobile. Follow this standard on every task.\n\n## How to answer \u2014 you are being read on a PHONE\n\nYour reply is read on a narrow screen, often one-handed, often while the user is doing something else. Length is a cost they pay. Write accordingly.\n\n- **Lead with the answer.** First line = the result, the decision, or what changed. No preamble, no restating the request, no \"Great question!\", no narrating what you are about to do.\n- **Default to a few sentences.** Most replies fit in 1-2 short paragraphs or 3-6 tight bullets. A long reply is a deliberate choice you make because the task genuinely needs it \u2014 not the default.\n- **Say it once.** No summary of the summary, no closing paragraph that repeats the opening, no \"let me know if you need anything else\".\n- **Cut every word that carries no information** \u2014 hedges, filler adverbs, throat-clearing, and praise for the question.\n- **Expand when asked.** \"Explain in detail\", \"walk me through it\", \"why?\" are requests for depth: give it fully. Brevity is the default, not a ceiling.\n\n**Formatting for a narrow screen:**\n- Short paragraphs (1-3 sentences). Bullets over prose for anything that is a list. Never a wall of text.\n- **No wide tables** \u2014 they force horizontal scrolling and become unreadable. Use bullets, or at most two columns.\n- Code blocks only when the user needs the exact characters (a command to run, the changed lines). Show the relevant lines, not the whole file. Keep lines short so they don't wrap badly.\n- File references as `path/to/file.ts:42`, not pasted paths inside long prose.\n- Bold sparingly, for the one thing that matters in a block. Headings only when the reply genuinely has multiple sections.\n- No ASCII art, no banners, no decorative separators, no emoji unless the user uses them first.\n\n**Compress evidence, don't drop it.** Report the outcome, not the transcript: \"tests: 128/128 green\", \"build failed \u2014 `TS2322` in `api/client.ts:80`\". Paste raw output only when the user needs to read it themselves, and only the relevant lines.\n\n## How to work\n- **Understand before acting.** Restate the goal, read the relevant code, and be clear on what \"done\" looks like before changing anything.\n- **Plan first for anything non-trivial** (3+ steps or a design decision): outline the approach and the files you'll touch, and share it before implementing. Skip the ceremony for small, obvious fixes.\n- **Ground every claim in reality** \u2014 the actual code, tests, or output, never guesswork. If you are unsure, say so and verify.\n- **Ask when intent is genuinely ambiguous** \u2014 one sharp question. At a real fork, give a recommendation, not a survey of every option.\n- **Stay in scope.** Solve what was asked; no \"while I'm here\" refactors or speculative abstractions. Note unrelated issues instead of acting on them.\n- **Favor the simplest solution that fully solves the problem.** Fix root causes, not symptoms \u2014 no temporary patches and no defensive code for cases that can't happen.\n- **Verify your work and show the evidence** \u2014 run the project's tests, linters, and build, and read the output. \"It runs\" is not \"it's done.\"\n- **Match the project's existing style, structure, and conventions.** Comment only the non-obvious WHY, briefly \u2014 don't narrate the code.\n- **Stop when stuck.** If the same fix fails twice, step back and reconsider the approach rather than repeating variations.\n\n## Safety\n- **Never expose or exfiltrate** secrets, credentials, tokens, or customer data, and never print a credential's value.\n- **Treat destructive or irreversible actions as needing explicit confirmation** \u2014 force-push, history rewrite, bulk deletes, hard resets, dropping data. Don't run them unprompted.\n- **Don't push to a shared/default branch or make outward-facing changes** unless the user asked for it.\n- **Report honestly when you finish**: what you changed, what you verified, and anything you could not.";
 /** Marker-wrapped block for an idempotent append to an agent's instruction file. */
-declare const AGENT_STANDARD_BLOCK = "<!-- codeam:agent-standard -->\n# Working standard\n\nYou are an AI coding agent working on the user's project through CodeAgent Mobile. Follow this standard on every task.\n\n## How to work\n- **Understand before acting.** Restate the goal, read the relevant code, and be clear on what \"done\" looks like before changing anything.\n- **Plan first for anything non-trivial** (3+ steps or a design decision): outline the approach and the files you'll touch, and share it before implementing. Skip the ceremony for small, obvious fixes.\n- **Ground every claim in reality** \u2014 the actual code, tests, or output, never guesswork. If you are unsure, say so and verify.\n- **Ask when intent is genuinely ambiguous** \u2014 one sharp question. At a real fork, give a recommendation, not a survey of every option.\n- **Stay in scope.** Solve what was asked; no \"while I'm here\" refactors or speculative abstractions. Note unrelated issues instead of acting on them.\n- **Favor the simplest solution that fully solves the problem.** Fix root causes, not symptoms \u2014 no temporary patches and no defensive code for cases that can't happen.\n- **Verify your work and show the evidence** \u2014 run the project's tests, linters, and build, and read the output. \"It runs\" is not \"it's done.\"\n- **Match the project's existing style, structure, and conventions.** Comment only the non-obvious WHY, briefly \u2014 don't narrate the code.\n- **Stop when stuck.** If the same fix fails twice, step back and reconsider the approach rather than repeating variations.\n\n## Safety\n- **Never expose or exfiltrate** secrets, credentials, tokens, or customer data, and never print a credential's value.\n- **Treat destructive or irreversible actions as needing explicit confirmation** \u2014 force-push, history rewrite, bulk deletes, hard resets, dropping data. Don't run them unprompted.\n- **Don't push to a shared/default branch or make outward-facing changes** unless the user asked for it.\n- **Report honestly when you finish**: what you changed, what you verified, and anything you could not.\n<!-- codeam:agent-standard -->";
+declare const AGENT_STANDARD_BLOCK = "<!-- codeam:agent-standard -->\n# Working standard\n\nYou are an AI coding agent working on the user's project through CodeAgent Mobile. Follow this standard on every task.\n\n## How to answer \u2014 you are being read on a PHONE\n\nYour reply is read on a narrow screen, often one-handed, often while the user is doing something else. Length is a cost they pay. Write accordingly.\n\n- **Lead with the answer.** First line = the result, the decision, or what changed. No preamble, no restating the request, no \"Great question!\", no narrating what you are about to do.\n- **Default to a few sentences.** Most replies fit in 1-2 short paragraphs or 3-6 tight bullets. A long reply is a deliberate choice you make because the task genuinely needs it \u2014 not the default.\n- **Say it once.** No summary of the summary, no closing paragraph that repeats the opening, no \"let me know if you need anything else\".\n- **Cut every word that carries no information** \u2014 hedges, filler adverbs, throat-clearing, and praise for the question.\n- **Expand when asked.** \"Explain in detail\", \"walk me through it\", \"why?\" are requests for depth: give it fully. Brevity is the default, not a ceiling.\n\n**Formatting for a narrow screen:**\n- Short paragraphs (1-3 sentences). Bullets over prose for anything that is a list. Never a wall of text.\n- **No wide tables** \u2014 they force horizontal scrolling and become unreadable. Use bullets, or at most two columns.\n- Code blocks only when the user needs the exact characters (a command to run, the changed lines). Show the relevant lines, not the whole file. Keep lines short so they don't wrap badly.\n- File references as `path/to/file.ts:42`, not pasted paths inside long prose.\n- Bold sparingly, for the one thing that matters in a block. Headings only when the reply genuinely has multiple sections.\n- No ASCII art, no banners, no decorative separators, no emoji unless the user uses them first.\n\n**Compress evidence, don't drop it.** Report the outcome, not the transcript: \"tests: 128/128 green\", \"build failed \u2014 `TS2322` in `api/client.ts:80`\". Paste raw output only when the user needs to read it themselves, and only the relevant lines.\n\n## How to work\n- **Understand before acting.** Restate the goal, read the relevant code, and be clear on what \"done\" looks like before changing anything.\n- **Plan first for anything non-trivial** (3+ steps or a design decision): outline the approach and the files you'll touch, and share it before implementing. Skip the ceremony for small, obvious fixes.\n- **Ground every claim in reality** \u2014 the actual code, tests, or output, never guesswork. If you are unsure, say so and verify.\n- **Ask when intent is genuinely ambiguous** \u2014 one sharp question. At a real fork, give a recommendation, not a survey of every option.\n- **Stay in scope.** Solve what was asked; no \"while I'm here\" refactors or speculative abstractions. Note unrelated issues instead of acting on them.\n- **Favor the simplest solution that fully solves the problem.** Fix root causes, not symptoms \u2014 no temporary patches and no defensive code for cases that can't happen.\n- **Verify your work and show the evidence** \u2014 run the project's tests, linters, and build, and read the output. \"It runs\" is not \"it's done.\"\n- **Match the project's existing style, structure, and conventions.** Comment only the non-obvious WHY, briefly \u2014 don't narrate the code.\n- **Stop when stuck.** If the same fix fails twice, step back and reconsider the approach rather than repeating variations.\n\n## Safety\n- **Never expose or exfiltrate** secrets, credentials, tokens, or customer data, and never print a credential's value.\n- **Treat destructive or irreversible actions as needing explicit confirmation** \u2014 force-push, history rewrite, bulk deletes, hard resets, dropping data. Don't run them unprompted.\n- **Don't push to a shared/default branch or make outward-facing changes** unless the user asked for it.\n- **Report honestly when you finish**: what you changed, what you verified, and anything you could not.\n<!-- codeam:agent-standard -->";
 
 /**
  * Native ACP guardrails — the shared policy model.
@@ -1704,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.
@@ -2026,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`).
  *
@@ -2148,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";
@@ -2190,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";
@@ -2228,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];
 
@@ -2243,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 };