myshell-tools 2.15.0 → 3.2.0

package/dist/interface/menu.d.ts

@@ -24,6 +24,9 @@ import type { Provider, ProviderId, SandboxLevel } from '../providers/port.js';
 import type { OutputSink } from './render.js';
 import type { LoginMethod } from '../commands/login.js';
 import type { UpdateCheckResult } from '../infra/update-check.js';
+import type { ClaudeTokenStatus } from '../infra/credentials.js';
+import { claudeTokenStatus } from '../infra/credentials.js';
+import type { HealthIssue } from '../infra/health.js';
 export interface MenuContext {
     readonly version: string;
     readonly clock: Clock;
@@ -92,6 +95,30 @@ export interface MenuContext {
      * Used only for the opt-in auto-update path.
      */
     readonly relaunch?: () => Promise<number>;
+    /**
+     * Optional pre-computed Claude token lifetime status for testing. When provided,
+     * `startMenu` uses this instead of loading from disk, allowing tests to drive
+     * the token-expiry header warning without touching the filesystem.
+     *
+     * Pass `null` explicitly to suppress any token warning; omit (undefined) to
+     * trigger the real disk read via `loadClaudeTokenCapturedAt`.
+     */
+    readonly claudeTokenInfo?: ClaudeTokenStatus | null;
+    /**
+     * Optional override for npx-context detection (testing). When provided,
+     * `startMenu` uses this instead of inspecting `process.argv[1]`, so tests can
+     * drive the "running under npx" warning + auto-update suppression without a
+     * real npx cache path. Omit (undefined) to trigger the real detection.
+     */
+    readonly runningUnderNpx?: boolean;
+    /**
+     * Pre-computed environment health issues (Node version, state-dir writable,
+     * pricing staleness) surfaced automatically below the header — only when a
+     * problem exists. Computed once at startup by cli.ts (the diagnostics don't
+     * change in-session) so the user never has to run a separate health command.
+     * Omit/empty → nothing is shown.
+     */
+    readonly healthIssues?: readonly HealthIssue[];
 }
 /**
  * Parse a yes/no answer from a raw input line, with a configurable default.
@@ -150,6 +177,35 @@ export declare function defaultAliasHint(shell: string | undefined, platform: st
  * All arithmetic is pure — no Date, no Math.random.
  */
 export declare function relativeTime(thenMs: number, nowMs: number): string;
+/**
+ * Build the short version-status suffix shown next to the version number in the
+ * header title — so the user always knows, at a glance, whether they are current.
+ *
+ * Pure — no I/O. Returns a leading-space string ready to append to the title:
+ *   - update available + known latest → ` → 3.1.0 available`
+ *   - up to date (latest known, no update) → ` (latest)`
+ *   - check failed / offline (latest unknown) → `` (claim nothing)
+ *
+ * @param updateInfo - Result of the update check, or undefined when not run.
+ */
+export declare function versionStatusLabel(updateInfo?: UpdateCheckResult): string;
+/**
+ * Detect whether myshell-tools is running via `npx` rather than a global install.
+ *
+ * Pure — takes the running script path (process.argv[1]) and the environment.
+ * npx executes packages from a cache directory containing a `_npx` segment
+ * (e.g. ~/.npm/_npx/<hash>/node_modules/myshell-tools/dist/cli.js), so the
+ * presence of that segment in the script path is the reliable signal. Handles
+ * both POSIX and Windows separators. Never throws.
+ *
+ * Why it matters: self-update runs `npm install -g`, which an npx invocation
+ * will ignore on the next run (npx re-serves its own cache). So under npx we
+ * skip silent auto-update and instead tell the user to install globally.
+ *
+ * @param scriptPath - The running script path (typically process.argv[1]).
+ * @param env        - Environment to read npm_* hints from.
+ */
+export declare function isRunningUnderNpx(scriptPath: string | undefined, env: NodeJS.ProcessEnv): boolean;
 /**
  * Build the header box lines (provider status) from real EnvironmentStatus.
  * Returns string[] safe to pass as the `lines` arg to box().
@@ -159,14 +215,23 @@ export declare function relativeTime(thenMs: number, nowMs: number): string;
  *   ⚠️  when ps.installed && !ps.authenticated  (append " not signed in")
  *   ❌  when !ps.installed                       (append install command)
  * Plan label appended when ps.plan is non-null (e.g. " (Max x5)").
+ *
+ * @param claudeToken - Optional pre-computed token lifetime status. When the token
+ *   is near expiry or expired, ONE concise warning line is appended. Computed by
+ *   the caller (startMenu) so this function stays pure and I/O-free.
  */
-export declare function renderHeaderLines(env: EnvironmentStatus, _version: string): string[];
+export declare function renderHeaderLines(env: EnvironmentStatus, _version: string, claudeToken?: ReturnType<typeof claudeTokenStatus>): string[];
 /**
- * Render the budget/spend status line shown beneath the provider header.
+ * Render the activity status line shown beneath the provider header.
+ *
+ * This is a SUBSCRIPTION tool, not an API-key tool — per-token dollar figures
+ * don't map to flat subscription billing and read as misleading bloat, so the
+ * always-on line shows REAL, measured signals only: task count and tokens. The
+ * estimated-dollar view lives on-demand in `myshell-tools cost`, clearly
+ * captioned there as an API-equivalent (not your actual bill).
  *
- * Uses real numbers only — all values come from the SpendSummary which is
- * derived from `readLedger`. No digit-% literals appear in this function; it
- * shows dollar amounts only.
+ * Uses real numbers only — all values come from the SpendSummary derived from
+ * `readLedger`. No digit-% literals appear here.
  *
  * @param spend - Output of summarizeSpend() over real ledger entries.
  * @param color - When false, no ANSI escape codes are emitted.