mergestorm 0.3.9 → 0.3.15

package/dist/api.js

@@ -1,9 +1,42 @@
 import { apiBase, loadConfig, resolveApiKey } from "./config.js";
-import { CommandError } from "./errors.js";
+import { CommandError, REVIEW_EXIT, rateLimitedMessage } from "./errors.js";
 /** Default per-request timeout so a hung API cannot stall the shell/CI forever. */
 export const DEFAULT_API_TIMEOUT_MS = 30_000;
 /** Message prefix of the CommandError thrown when a request exceeds its timeout. */
 export const API_TIMEOUT_PREFIX = "Request timed out after";
+function asPositiveSeconds(value) {
+    if (typeof value === "number" && Number.isFinite(value) && value >= 0) {
+        return value;
+    }
+    if (typeof value === "string" && /^\d+(\.\d+)?$/.test(value.trim())) {
+        return Number(value.trim());
+    }
+    return undefined;
+}
+function parseRetryAfterHeader(header) {
+    if (!header)
+        return undefined;
+    const trimmed = header.trim();
+    const asNumber = asPositiveSeconds(trimmed);
+    if (asNumber !== undefined)
+        return asNumber;
+    const when = Date.parse(trimmed);
+    if (!Number.isFinite(when))
+        return undefined;
+    return Math.max(0, (when - Date.now()) / 1000);
+}
+/** Prefer the larger of `Retry-After` and JSON `retry_after_seconds`. */
+export function parseRetryAfterSeconds(input) {
+    const fromBody = input.body && typeof input.body === "object"
+        ? asPositiveSeconds(input.body.retry_after_seconds)
+        : undefined;
+    const fromHeader = parseRetryAfterHeader(input.header);
+    if (fromBody === undefined)
+        return fromHeader;
+    if (fromHeader === undefined)
+        return fromBody;
+    return Math.max(fromBody, fromHeader);
+}
 function isAbortLike(err) {
     return (err instanceof Error &&
         (err.name === "AbortError" || err.name === "TimeoutError"));
@@ -82,7 +115,15 @@ export async function apiFetch(cfg, route, init = {}) {
     if (res.status === 401) {
         throw new CommandError("API key invalid or revoked. Run `mergestorm login`.", 1, "auth_invalid");
     }
-    return { status: res.status, body: parsed };
+    const retryAfterSeconds = parseRetryAfterSeconds({
+        header: res.headers.get("retry-after"),
+        body: parsed,
+    });
+    return {
+        status: res.status,
+        body: parsed,
+        ...(retryAfterSeconds !== undefined ? { retryAfterSeconds } : {}),
+    };
 }
 export async function devicePost(base, route, json, opts = {}) {
     const timeoutMs = opts.timeoutMs ?? DEFAULT_API_TIMEOUT_MS;
@@ -113,6 +154,71 @@ export async function devicePost(base, route, json, opts = {}) {
     }
     return { status: res.status, body: parsed };
 }
+/**
+ * Bearer-writable settings keys, mirroring the `/api/v1/settings` allowlist.
+ * The connected flags are read-only there and deliberately absent here.
+ */
+export const SETTINGS_WRITABLE_KEYS = [
+    "auto_review_enabled",
+    "auto_patch_enabled",
+    "vortex_show_thinking_traces",
+    "repo_overview_enabled",
+    "review_unit_land_prs_enabled",
+    "cyclone_review_unit_land_prs_enabled",
+    "vortex_seam_specialist_enabled",
+];
+/**
+ * Fetch Bearer /api/v1/settings; null on 404/network/timeouts so panels can
+ * degrade (same contract as {@link getMe}), while 401 still surfaces.
+ */
+export async function getSettings(cfg, opts) {
+    const resolved = cfg ?? (await loadConfig());
+    try {
+        const { status, body } = await apiFetch(resolved, "/api/v1/settings", {
+            timeoutMs: opts?.timeoutMs,
+        });
+        if (status !== 200)
+            return null;
+        return body;
+    }
+    catch (err) {
+        if (err instanceof CommandError) {
+            if (err.code === "api_timeout")
+                return null;
+            throw err;
+        }
+        return null;
+    }
+}
+/**
+ * PATCH Bearer /api/v1/settings and return the stored result. Rejections
+ * (unknown key, cyclone_not_connected, …) surface the API's own `message`
+ * so the CLI never invents a reason.
+ */
+export async function patchSettings(patch, cfg, opts) {
+    const resolved = cfg ?? (await loadConfig());
+    if (Object.keys(patch).length === 0) {
+        throw new CommandError("No settings to update.", 2, "usage");
+    }
+    const { status, body, retryAfterSeconds } = await apiFetch(resolved, "/api/v1/settings", {
+        method: "PATCH",
+        json: patch,
+        timeoutMs: opts?.timeoutMs,
+    });
+    if (status === 404) {
+        throw new CommandError("Settings API is not available on this server yet. Deploy the API update or use the dashboard.");
+    }
+    if (status === 429) {
+        throw new CommandError(rateLimitedMessage(retryAfterSeconds), REVIEW_EXIT.rate_limited, "rate_limited", { retryAfterSeconds });
+    }
+    if (status !== 200) {
+        const message = body?.message;
+        throw new CommandError(typeof message === "string" && message.trim()
+            ? message
+            : `Failed to update settings (HTTP ${status}): ${JSON.stringify(body)}`);
+    }
+    return body;
+}
 /** Fetch /api/v1/me; returns null on 404/network so callers can degrade. */
 export async function getMe(cfg, opts) {
     const resolved = cfg ?? (await loadConfig());
@@ -137,10 +243,12 @@ export async function getMe(cfg, opts) {
         return null;
     }
 }
-export async function listJobs(limit = 10, cfg) {
+export async function listJobs(limit = 10, cfg, opts) {
     const resolved = cfg ?? (await loadConfig());
     const capped = Math.min(Math.max(limit, 1), 50);
-    const { status, body } = await apiFetch(resolved, `/api/v1/reviews?limit=${capped}`);
+    const { status, body } = await apiFetch(resolved, `/api/v1/reviews?limit=${capped}`, {
+        timeoutMs: opts?.timeoutMs,
+    });
     if (status === 404) {
         throw new CommandError("Job list is not available on this server yet. Update the API or use the dashboard.");
     }
@@ -150,19 +258,91 @@ export async function listJobs(limit = 10, cfg) {
     const items = body.items;
     return Array.isArray(items) ? items : [];
 }
+/** Fetch one review job (Bearer GET /api/v1/reviews/:id). */
+export async function getReview(jobId, cfg, opts) {
+    const resolved = cfg ?? (await loadConfig());
+    const id = jobId.trim();
+    if (!id) {
+        throw new CommandError("job_id is required", 2, "usage");
+    }
+    const { status, body, retryAfterSeconds } = await apiFetch(resolved, `/api/v1/reviews/${encodeURIComponent(id)}`, { signal: opts?.signal, timeoutMs: opts?.timeoutMs });
+    if (status === 404) {
+        throw new CommandError(`Review not found: ${id}`);
+    }
+    if (status === 429) {
+        throw new CommandError(rateLimitedMessage(retryAfterSeconds), REVIEW_EXIT.rate_limited, "rate_limited", { retryAfterSeconds });
+    }
+    if (status !== 200) {
+        throw new CommandError(`Failed to get review (HTTP ${status}): ${JSON.stringify(body)}`);
+    }
+    return body;
+}
+/** Fetch the latest Vortex pass for one GitHub PR. */
+export async function getPrVortexReview(owner, repo, prNumber, cfg, opts) {
+    const resolved = cfg ?? (await loadConfig());
+    const cleanOwner = owner.trim();
+    const cleanRepo = repo.trim();
+    if (!cleanOwner || !cleanRepo || !Number.isInteger(prNumber) || prNumber <= 0) {
+        throw new CommandError("owner, repo, and a positive pr_number are required", 2, "usage");
+    }
+    const query = new URLSearchParams({
+        owner: cleanOwner,
+        repo: cleanRepo,
+        pr_number: String(prNumber),
+    });
+    const { status, body, retryAfterSeconds } = await apiFetch(resolved, `/api/v1/stacks/pr-review?${query.toString()}`, { signal: opts?.signal, timeoutMs: opts?.timeoutMs });
+    if (status === 404) {
+        throw new CommandError(`Vortex review not found: ${cleanOwner}/${cleanRepo}#${prNumber}`, REVIEW_EXIT.failed, "not_found");
+    }
+    if (status === 429) {
+        throw new CommandError(rateLimitedMessage(retryAfterSeconds), REVIEW_EXIT.rate_limited, "rate_limited", { retryAfterSeconds });
+    }
+    if (status !== 200) {
+        throw new CommandError(`Failed to get PR review (HTTP ${status}): ${JSON.stringify(body)}`, REVIEW_EXIT.failed, "review_failed");
+    }
+    return body;
+}
 /** List stacks (Bearer GET /api/v1/stacks). */
-export async function listStacks(cfg) {
+export async function listStacks(cfg, opts) {
     const resolved = cfg ?? (await loadConfig());
-    const { status, body } = await apiFetch(resolved, "/api/v1/stacks");
+    const { status, body, retryAfterSeconds } = await apiFetch(resolved, "/api/v1/stacks", {
+        timeoutMs: opts?.timeoutMs,
+    });
     if (status === 404) {
         throw new CommandError("Stacks API is not available on this server yet. Deploy the API update or use the dashboard.");
     }
+    if (status === 429) {
+        throw new CommandError(rateLimitedMessage(retryAfterSeconds), REVIEW_EXIT.rate_limited, "rate_limited", { retryAfterSeconds });
+    }
     if (status !== 200) {
         throw new CommandError(`Failed to list stacks (HTTP ${status}): ${JSON.stringify(body)}`);
     }
     const stacks = body.stacks;
     return Array.isArray(stacks) ? stacks : [];
 }
+/** Fetch one owned stack with enriched GitHub checks and agent state. */
+export async function getEnrichedStack(stackId, cfg, opts) {
+    const resolved = cfg ?? (await loadConfig());
+    const id = stackId.trim();
+    if (!id) {
+        throw new CommandError("stack_id is required", 2, "usage");
+    }
+    const { status, body, retryAfterSeconds } = await apiFetch(resolved, `/api/v1/stacks/enrich?stackId=${encodeURIComponent(id)}`, { timeoutMs: opts?.timeoutMs });
+    if (status === 404) {
+        throw new CommandError("Stack enrichment is not available on this server yet. Deploy the API update or use the dashboard.");
+    }
+    if (status === 429) {
+        throw new CommandError(rateLimitedMessage(retryAfterSeconds), REVIEW_EXIT.rate_limited, "rate_limited", { retryAfterSeconds });
+    }
+    if (status !== 200) {
+        throw new CommandError(`Failed to get stack status (HTTP ${status}): ${JSON.stringify(body)}`);
+    }
+    const stacks = body.stacks;
+    if (!Array.isArray(stacks)) {
+        throw new CommandError(`Failed to get stack status (HTTP 200): ${JSON.stringify(body)}`);
+    }
+    return stacks.find((stack) => stack?.id === id) ?? null;
+}
 /** Adopt an open PR chain (Bearer POST /api/v1/stacks/adopt). */
 export async function adoptStack(owner, repo, prNumber, cfg) {
     const resolved = cfg ?? (await loadConfig());
@@ -178,6 +358,21 @@ export async function adoptStack(owner, repo, prNumber, cfg) {
     }
     return body;
 }
+/** Mint or reuse the PR3+ park freeze (Bearer POST /api/v1/stacks/:id/ensure-upper-park). */
+export async function ensureUpperPark(stackId, cfg) {
+    const body = await stackMutation(stackId, "/ensure-upper-park", "POST", {}, "Failed to ensure upper-park freeze", cfg);
+    if (typeof body !== "object" || body === null) {
+        throw new CommandError("Unexpected response shape from ensure-upper-park");
+    }
+    const freezeBranch = body.freezeBranch;
+    if (typeof freezeBranch !== "string" || !freezeBranch.trim()) {
+        throw new CommandError("ensure-upper-park did not return a freezeBranch");
+    }
+    return {
+        freezeBranch: freezeBranch.trim(),
+        created: body.created === true,
+    };
+}
 async function stackMutation(stackId, pathSuffix, method, json, failLabel, cfg) {
     const resolved = cfg ?? (await loadConfig());
     const { status, body } = await apiFetch(resolved, `/api/v1/stacks/${encodeURIComponent(stackId)}${pathSuffix}`, method === "PATCH"
@@ -206,9 +401,50 @@ export async function landNextStack(stackId, cfg, opts) {
         : {};
     return stackMutation(stackId, "/land-next", "POST", json, "Failed to land next", cfg);
 }
-/** Toggle auto-promote when green (Bearer PATCH /api/v1/stacks/:id). */
-export async function setStackAutoPromote(stackId, autoPromoteWhenGreen, cfg) {
-    return stackMutation(stackId, "", "PATCH", { autoPromoteWhenGreen }, "Failed to update auto-promote", cfg);
+/** List the authenticated user's live merge-queue entries. */
+export async function listMergeQueueEntries(cfg) {
+    const resolved = cfg ?? (await loadConfig());
+    const { status, body } = await apiFetch(resolved, "/api/v1/stacks/queue");
+    if (status === 404) {
+        throw new CommandError("Merge queue API is not available on this server yet. Deploy the API update or use the dashboard.");
+    }
+    if (status !== 200) {
+        throw new CommandError(`Failed to list merge queue (HTTP ${status}): ${JSON.stringify(body)}`);
+    }
+    const entries = body.entries;
+    if (!Array.isArray(entries)) {
+        throw new CommandError(`Failed to list merge queue (HTTP 200): ${JSON.stringify(body)}`);
+    }
+    return entries;
+}
+async function queueMutation(route, failLabel, cfg) {
+    const resolved = cfg ?? (await loadConfig());
+    const { status, body } = await apiFetch(resolved, route, {
+        method: "POST",
+        json: {},
+    });
+    if (status === 404) {
+        const error = body?.error;
+        if (error === "stack_not_found") {
+            throw new CommandError("Stack not found");
+        }
+        if (error === "entry_not_found") {
+            throw new CommandError("Merge queue entry not found");
+        }
+        throw new CommandError("Merge queue API is not available on this server yet. Deploy the API update or use the dashboard.");
+    }
+    if (status < 200 || status >= 300) {
+        throw new CommandError(`${failLabel} (HTTP ${status}): ${JSON.stringify(body)}`);
+    }
+    return body;
+}
+/** Enqueue a stack for verified landing. */
+export async function enqueueStack(stackId, cfg) {
+    return queueMutation(`/api/v1/stacks/${encodeURIComponent(stackId)}/enqueue`, "Failed to add stack to merge queue", cfg);
+}
+/** Cancel a live merge-queue entry by entry id. */
+export async function cancelMergeQueueEntry(entryId, cfg) {
+    return queueMutation(`/api/v1/stacks/queue/${encodeURIComponent(entryId)}/cancel`, "Failed to remove merge queue entry", cfg);
 }
 /** Recently reviewed branches/threads (Bearer GET /api/v1/threads). */
 export async function listThreads(limit = 20, cfg) {

package/dist/client/index.d.ts

@@ -0,0 +1,5 @@
+export { DEFAULT_API, apiBase, clearConfig, configPath, keyDisplay, loadConfig, mergestormHome, resolveApiKey, saveConfig, type Config, } from "../config.js";
+export { API_TIMEOUT_PREFIX, DEFAULT_API_TIMEOUT_MS, SETTINGS_WRITABLE_KEYS, adoptStack, apiFetch, cancelMergeQueueEntry, devicePost, enqueueStack, ensureUpperPark, getEnrichedStack, getMe, getPrVortexReview, getReview, getSettings, landNextStack, listJobs, listMergeQueueEntries, listStacks, listThreads, parseRetryAfterSeconds, patchSettings, restackStack, type ApiFetchInit, type ApiFetchResult, type JobListItem, type MeResponse, type MergeQueueBounceDetail, type MergeQueueBounceKind, type MergeQueueEnqueuedBy, type MergeQueueEnqueuedVia, type MergeQueueEntryDto, type MergeQueueEntryState, type PrReviewFinding, type PrReviewFindings, type PrVortexReview, type SettingsPatch, type SettingsResponse, type SettingsWritableKey, type StackDto, type ThreadDetail, type ThreadListItem, } from "../api.js";
+export { CommandError, DetachedError, RATE_LIMITED_HINT, REVIEW_EXIT, isCommandErrorCode, rateLimitedMessage, type CommandErrorCode, type CommandErrorExtras, } from "../errors.js";
+export { REVIEW_POLL_BACKOFF_MS, REVIEW_POLL_DEFAULT_TIMEOUT_MS, REVIEW_POLL_INTERVAL_MS, REVIEW_POLL_MAX_INTERVAL_MS, REVIEW_POLL_MAX_TRANSIENT_RETRIES, REVIEW_POLL_STRETCH_AFTER_MS, REVIEW_POLL_STRETCH_SPAN_MS, REVIEW_THREAD_SLUG_RE, PrReviewPollTimeoutError, ReviewPollTimeoutError, collectReviewInput, isTransientReviewPollError, isTransientReviewPollStatus, loadReviewContext, pollPrVortexReview, pollReview, stretchedPollIntervalMs, submitReview, transientRetryWaitMs, type PollReviewOptions, type PollPrVortexReviewOptions, type ReviewInput, type SubmitReviewOptions, } from "../commands/review-client.js";
+export { REVIEW_JOB_ENVELOPE_SCHEMA, toReviewJobEnvelope, type ReviewEnvelopeFallbacks, type ReviewJobEnvelope, type ReviewJobRow, } from "../ui/job-envelope.js";

package/dist/client/index.js

@@ -0,0 +1,5 @@
+export { DEFAULT_API, apiBase, clearConfig, configPath, keyDisplay, loadConfig, mergestormHome, resolveApiKey, saveConfig, } from "../config.js";
+export { API_TIMEOUT_PREFIX, DEFAULT_API_TIMEOUT_MS, SETTINGS_WRITABLE_KEYS, adoptStack, apiFetch, cancelMergeQueueEntry, devicePost, enqueueStack, ensureUpperPark, getEnrichedStack, getMe, getPrVortexReview, getReview, getSettings, landNextStack, listJobs, listMergeQueueEntries, listStacks, listThreads, parseRetryAfterSeconds, patchSettings, restackStack, } from "../api.js";
+export { CommandError, DetachedError, RATE_LIMITED_HINT, REVIEW_EXIT, isCommandErrorCode, rateLimitedMessage, } from "../errors.js";
+export { REVIEW_POLL_BACKOFF_MS, REVIEW_POLL_DEFAULT_TIMEOUT_MS, REVIEW_POLL_INTERVAL_MS, REVIEW_POLL_MAX_INTERVAL_MS, REVIEW_POLL_MAX_TRANSIENT_RETRIES, REVIEW_POLL_STRETCH_AFTER_MS, REVIEW_POLL_STRETCH_SPAN_MS, REVIEW_THREAD_SLUG_RE, PrReviewPollTimeoutError, ReviewPollTimeoutError, collectReviewInput, isTransientReviewPollError, isTransientReviewPollStatus, loadReviewContext, pollPrVortexReview, pollReview, stretchedPollIntervalMs, submitReview, transientRetryWaitMs, } from "../commands/review-client.js";
+export { REVIEW_JOB_ENVELOPE_SCHEMA, toReviewJobEnvelope, } from "../ui/job-envelope.js";

package/dist/commands/branches.d.ts

@@ -2,9 +2,13 @@ import { type ThreadListItem } from "../api.js";
 /** One-line label for a branch/thread row (also used by tests). */
 export declare function formatBranchRow(item: ThreadListItem): string;
 /** Interactive list of recently reviewed branches → open chain on select. */
-export declare function cmdBranches(args?: string[]): Promise<void>;
+export declare function cmdBranches(args?: string[], opts?: {
+    mode?: "oneshot" | "shell";
+}): Promise<void>;
 /**
  * Show the review-chain timeline for a branch/thread.
  * Defaults to `local/<current-git-branch>` when no slug is given.
  */
-export declare function cmdChain(args?: string[]): Promise<void>;
+export declare function cmdChain(args?: string[], opts?: {
+    mode?: "oneshot" | "shell";
+}): Promise<void>;

package/dist/commands/branches.js

@@ -4,8 +4,10 @@ import { loadConfig } from "../config.js";
 import { CommandError } from "../errors.js";
 import { git } from "../git.js";
 import { ansi } from "../ui/ansi.js";
+import { present } from "../ui/present.js";
 import { selectFromList } from "../ui/select.js";
-import { cmdThread, relativeWhen } from "./jobs.js";
+import { buildChainHelpLines, cmdThread, relativeWhen } from "./jobs.js";
+import { showLinePanel } from "../ui/line-tabs.js";
 /** One-line label for a branch/thread row (also used by tests). */
 export function formatBranchRow(item) {
     const name = (item.branch?.trim() || item.slug).slice(0, 36);
@@ -18,7 +20,7 @@ export function formatBranchRow(item) {
     const closed = item.status === "closed" ? "  closed" : "";
     return `${name.padEnd(36)}  ${jobs.padEnd(8)}  ${verdict.padEnd(12)}  ${when}${pr}${closed}`;
 }
-function printBranchTable(items) {
+function formatBranchTableLines(items) {
     const header = ["BRANCH / SLUG", "JOBS", "VERDICT", "WHEN", "PR"];
     const rows = items.map((t) => [
         (t.branch?.trim() || t.slug).slice(0, 36),
@@ -29,28 +31,38 @@ function printBranchTable(items) {
     ]);
     const widths = header.map((h, i) => Math.max(h.length, ...rows.map((r) => r[i]?.length ?? 0)));
     const fmt = (cols) => "  " + cols.map((c, i) => c.padEnd(widths[i])).join("  ");
-    console.log(ansi.dim(fmt(header)));
-    for (const r of rows)
-        console.log(fmt(r));
-    console.log(ansi.dim("  open a chain:  chain <slug>   ·   or re-run on a TTY to pick"));
+    return [
+        ansi.dim(fmt(header)),
+        ...rows.map((r) => fmt(r)),
+        ansi.dim("  open a chain:  chain <slug>   ·   or re-run on a TTY to pick"),
+    ];
 }
 /** Interactive list of recently reviewed branches → open chain on select. */
-export async function cmdBranches(args = []) {
+export async function cmdBranches(args = [], opts = {}) {
     const asJson = args.includes("--json");
     const nArg = args.find((a) => /^\d+$/.test(a));
     const limit = nArg ? Number.parseInt(nArg, 10) : 20;
     const cfg = await loadConfig();
     const items = await listThreads(limit, cfg);
     if (asJson) {
-        console.log(JSON.stringify({ items }, null, 2));
+        const text = JSON.stringify({ items }, null, 2);
+        if (opts.mode === "shell") {
+            await present("Branches", text.split("\n"));
+            return;
+        }
+        console.log(text);
         return;
     }
     if (items.length === 0) {
-        console.log(ansi.dim("  No reviewed branches yet. Run `review` on a branch first."));
+        await present("Branches", [
+            `  ${ansi.bold("No reviewed branches yet")}`,
+            "",
+            `  ${ansi.brightGreen("review")}  submit a diff on this branch`,
+        ]);
         return;
     }
     if (!input.isTTY || !output.isTTY) {
-        printBranchTable(items);
+        await present("Branches", formatBranchTableLines(items));
         return;
     }
     const picked = await selectFromList({
@@ -59,7 +71,6 @@ export async function cmdBranches(args = []) {
         render: (item) => formatBranchRow(item),
     });
     if (!picked) {
-        console.log(ansi.dim("  cancelled"));
         return;
     }
     await cmdThread(picked.slug, []);
@@ -68,7 +79,7 @@ export async function cmdBranches(args = []) {
  * Show the review-chain timeline for a branch/thread.
  * Defaults to `local/<current-git-branch>` when no slug is given.
  */
-export async function cmdChain(args = []) {
+export async function cmdChain(args = [], opts = {}) {
     const asJson = args.includes("--json");
     const positional = args.filter((a) => a !== "--json");
     let slug = positional[0]?.trim() ?? "";
@@ -78,8 +89,12 @@ export async function cmdChain(args = []) {
             slug = `local/${branch}`.replace(/[^a-zA-Z0-9._/-]/g, "-").slice(0, 120);
         }
         catch {
-            throw new CommandError("usage: chain <slug>   (or run inside a git repo to use the current branch)");
+            if (asJson || !process.stdin.isTTY || !process.stdout.isTTY) {
+                throw new CommandError("usage: chain <slug>   (or run inside a git repo to use the current branch)");
+            }
+            await showLinePanel("Chain", buildChainHelpLines({ reason: "no-repo" }));
+            return;
         }
     }
-    await cmdThread(slug, asJson ? ["--json"] : []);
+    await cmdThread(slug, asJson ? ["--json"] : [], opts);
 }

package/dist/commands/browse.d.ts

@@ -0,0 +1,39 @@
+import { type JobListItem, type SettingsResponse, type SettingsWritableKey } from "../api.js";
+import { type ReviewJobRow } from "../ui/job-envelope.js";
+import { type TabId, type TabsConfigRow } from "../ui/tabs.js";
+import { type UsagePanelJob } from "../ui/usage.js";
+/** The tabbed browser needs a real terminal on both ends. */
+export declare function canBrowse(): boolean;
+/** Shared job row mapper for the Usage tab and the static `credits` panel. */
+export declare function toPanelJob(job: JobListItem): UsagePanelJob;
+export type StatusTabInput = {
+    keyPrefix: string;
+    keyName: string | null;
+    plan: string | null;
+    apiBase: string;
+    reachable: boolean;
+    /** getMe surfaced a 401: the key is invalid/revoked, not the API down. */
+    keyInvalid: boolean;
+    used?: number;
+    limit?: number | null;
+    remaining?: number | null;
+    resetsAt?: string | null;
+    now?: Date;
+};
+/** Short chrome note — lives on the hint row, not in the Status body. */
+export declare function statusReachabilityNote(input: Pick<StatusTabInput, "reachable" | "keyInvalid">): string;
+/** Status tab body: whoami + credits from `/me`. Reachability is the footer. */
+export declare function buildStatusTabLines(input: StatusTabInput): string[];
+/** In-place job detail for the Jobs tab (same envelope as `status <id>`). */
+export declare function formatJobDetailLines(row: ReviewJobRow): string[];
+/** Human labels for the Config tab and the static `settings` printout. */
+export declare const SETTINGS_LABELS: Record<SettingsWritableKey, string>;
+/** Config rows in a stable order: writable toggles, then connected flags. */
+export declare function buildConfigRows(settings: SettingsResponse): TabsConfigRow[];
+/**
+ * Data + entry for the tabbed Status / Usage / Jobs / Config browser (F-9).
+ * Degrades honestly: a null `/me` marks the API unreachable and the Usage
+ * tab says so, and a failed settings GET leaves the Config tab reporting
+ * itself unavailable instead of drawing toggles we do not have.
+ */
+export declare function openTabsBrowser(initial: TabId): Promise<void>;