honeydo 0.1.3 → 0.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "honeydo",
-  "version": "0.1.3",
+  "version": "0.2.0",
   "description": "One CLI for every AI capability — chat, vision, image, video, audio. Built for AI agents.",
   "license": "MIT",
   "keywords": [

package/packages/gcli/dist/cli.d.ts

@@ -99,10 +99,26 @@ export type PickerKeyAction = {
 } | {
     type: "noop";
 };
-/** One selectable row of the arrow-key picker: a cc-switch provider. */
+/**
+ * One selectable row of the arrow-key picker: a cc-switch provider.
+ * `sessions` = attributable live claude sessions for this provider (0 included);
+ * absent when the scan is unavailable (degraded — no session column, like an
+ * absent quota).
+ *
+ * `unattributed` is frame-level, not per-entry: the bare-claude process count
+ * attached (same value) to every entry by the claude menu path so ANY
+ * deps.pickProvider implementation still renders the footer hint — including
+ * two-arg wrappers that forward only `(entries, initialIndex)` to the
+ * production picker and would otherwise drop the positional third argument.
+ * Consumers must resolve it via `pickProviderInteractive` (positional arg
+ * wins, entries-borne value is the fallback), never read it per entry.
+ */
 export type PickerEntry = {
     name: string;
     quota?: string;
+    tag?: string;
+    sessions?: number;
+    unattributed?: number;
 };
 /** Result of the arrow-key picker (C-P1): a picked provider, or a skip. */
 export type PickerOutcome = {
@@ -216,15 +232,23 @@ export type RunDeps = {
     isInteractive: () => boolean;
     /**
      * TTY-only arrow-key provider picker (C-P1/C-P3): present the cc-switch
-     * provider entries (the production impl appends its own trailing 不切换
+     * provider entries (the production impl renders a dim Esc 不切换 footer;
      * row — `entries` holds providers only) and resolve the confirmed entry,
-     * or {kind:"skip"} on Esc / the 不切换 row. `initialIndex` is the caller-
+     * or {kind:"skip"} on Esc/C-g (= 退出，不启动后端). `initialIndex` is the caller-
      * computed row to highlight (memory hit or 0); implementations clamp it.
      * Only ever invoked on the claude path in a TTY with no --provider —
      * non-interactive callers (skills/CI/pipes) must see zero prompts and
      * zero extra cc-switch DB reads.
      */
-    pickProvider: (entries: PickerEntry[], initialIndex: number) => Promise<PickerOutcome>;
+    pickProvider: (entries: PickerEntry[], initialIndex: number, 
+    /**
+     * Count of live bare-claude processes (no --settings) shown as a dim
+     * footer hint on the menu. 0 / omitted → plain Esc footer. Only forwarded
+     * by the claude TTY menu path. Redundantly carried on the entries
+     * themselves (`PickerEntry.unattributed`), so implementations that drop
+     * this positional argument still render the hint.
+     */
+    unattributedCount?: number) => Promise<PickerOutcome>;
     /**
      * Quota subtitles (revise-3, C-Q4): given every menu provider's {name, env},
      * resolve name → formatted quota text (only providers with usable data are
@@ -235,6 +259,17 @@ export type RunDeps = {
         name: string;
         env: Record<string, string>;
     }[]) => Promise<Map<string, string>>;
+    /**
+     * One joined-argv line per live claude process (`ps -ww -o command=`), for
+     * TTY-picker session attribution (revise: picker 会话列). Default impl is a
+     * read-only `pgrep -x claude` + `ps -ww` pair. `pgrep` exit 1 (no match)
+     * resolves to []; pgrep exit >1 / ps failure / spawn error REJECTS — the
+     * caller degrades to no session column. Optional: when absent the scan
+     * capability is missing and the picker renders without session counts.
+     * Only ever invoked on the claude TTY menu path — never non-TTY, never
+     * `--provider`, never silent reuse (zero spawn discipline preserved).
+     */
+    listClaudeProcessArgs?: () => Promise<string[]>;
     /**
      * Read the remembered provider name (D2): trimmed first line of
      * LAST_PROVIDER_PATH, or undefined when missing/empty/unreadable. Only
@@ -347,7 +382,7 @@ export type PickerKeyInput = {
  * - "return" / "enter" → confirm the current row (the physical Enter key
  *   emits "return" in raw mode; "enter" is the LF byte, which a tty may
  *   substitute for CR in input buffered before raw mode was enabled)
- * - "escape"     → skip (不切换)
+ * - "escape"     → skip (退出，不启动后端)
  * - Emacs (revise-2): ctrl+"n" ≡ down, ctrl+"p" ≡ up (same wrap); ctrl+"g"
  *   ≡ escape → skip; meta+"<" → first row (absolute), meta+">" → last row
  *   (absolute). Horizontal Emacs keys (C-f/C-b/C-a/C-e) and paging (C-v/M-v)
@@ -356,7 +391,7 @@ export type PickerKeyInput = {
  *   exit 130)
  *
  * `index` is the highlighted row, `count` the total rendered rows INCLUDING
- * the trailing 不切换 row. Movement wraps with `(index±1+count)%count`; with
+ * the footer row. Movement wraps with `(index±1+count)%count`; with
  * count <= 0 moves are a noop (nothing is rendered).
  */
 export declare function applyPickerKey(k: PickerKeyInput, index: number, count: number): PickerKeyAction;
@@ -395,16 +430,35 @@ export declare function buildQuotaRequest(env: {
 export declare function parseKimiUsages(body: unknown): QuotaWindows;
 /**
  * Parse GLM `/api/monitor/usage/quota/limit` (C-Q2): data.limits[] entries
- * with type == "TOKENS_LIMIT"; sorted by nextResetTime ascending — first is
+ * with type "TOKENS_LIMIT" (coding-plan 订阅) or "CREDIT_LIMIT" (credit 资源
+ * 包) — billing type is per-account, fields are identical, same rendering
+ * (parity with statusline-sage); sorted by nextResetTime ascending — first is
  * the short (5h) window, last the weekly one.
  */
 export declare function parseGlmQuota(body: unknown): QuotaWindows;
 /**
- * Format quota windows as the menu subtitle (C-Q3): `5h:P% wk:P% ↻<rel>`
- * (short reset preferred for the ↻ segment); missing windows degrade; a
- * missing/expired reset omits the ↻ segment entirely; no windows → "".
+ * Format quota windows as the menu subtitle (C-Q3, 2026-09 双窗重置):
+ * `5h:P% ↻<rel> wk:P% ↻<rel>` — each window carries its own reset time.
+ * Missing windows degrade; a missing/expired reset omits that window's ↻;
+ * no windows → "". Byte-exact contract with downstream consumers — the
+ * plain-text output is locked by unit tests; colors live in `colorQuota`,
+ * never here.
  */
 export declare function formatQuota(q: QuotaWindows, nowMs: number): string;
+export declare const QUOTA_HIGH = 85;
+export declare const QUOTA_MID = 60;
+/**
+ * Limit 用量 → 段颜色：≥85 朱红、≥60 琥珀、其余（含非有限数）回退苔绿
+ * （阈值语义照搬 statusline-sage `_level_color`）。
+ */
+export declare function levelColor(pct: number): string;
+/**
+ * `formatQuota` 的染色版（picker 用）：`5h:P% ↻rel`/`wk:P% ↻rel` 每个窗口段
+ * 按各自 pct 独立选色，各自的重置时间恒 dim，不参与染色。结构与降级规则和
+ * `formatQuota` 一致（无窗口 → ""）。行内使用 `\x1b[39m`/`\x1b[22m` 收尾而
+ * 非全复位，以免抹掉选中行背景。
+ */
+export declare function colorQuota(q: QuotaWindows, nowMs: number): string;
 export interface ClaudeOptions {
     /** Omit for interactive mode (no -p emitted). */
     prompt?: string;
@@ -667,6 +721,20 @@ export declare function runAgy(args: string[], timeoutMs: number, cwd?: string):
  * through. SIGTERM enforces the timeout deterministically.
  */
 export declare function runClaude(args: string[], timeoutMs: number, cwd?: string): Promise<SpawnResult>;
+/**
+ * Spawn a backend with stdio fully inherited (interactive TUI mode).
+ *
+ * Unlike runAgy/runClaude: no timeout, no stdout/stderr capture —
+ * the child owns the terminal. The child's exit code is passed
+ * through unchanged (SIGINT→130, SIGTERM→143 per shell convention).
+ *
+ * An inherited CLAUDE_CODE_CHILD_SESSION=1 is stripped: claude reads it as
+ * "spawned sub-worker" and silently turns transcript saving off, so the
+ * session never shows up in `claude --resume`. An attended TUI is a
+ * top-level session, never a sub-worker. agy never reads the var, so the
+ * strip is a no-op there; print mode keeps the env verbatim.
+ */
+export declare function spawnInteractive(bin: string, args: string[], cwd?: string): Promise<InteractiveSpawnResult>;
 /** Spawn agy in interactive TUI mode (no -p, inherited stdio). */
 export declare function runAgyInteractive(args: string[], cwd?: string): Promise<InteractiveSpawnResult>;
 /** Spawn claude in interactive TUI mode (no -p, inherited stdio). */
@@ -713,6 +781,68 @@ export declare function readCcSwitchProvider(dbPath: string): Promise<ProviderLo
 export declare function validateProviderName(name: string): string | {
     error: string;
 };
+/**
+ * The full picker frame as plain lines: 标题 2 行 + dim 分隔线 + 条目 N 行 +
+ * dim 末行提示 (non-selectable — skip 只经 Esc/C-g). With `unattributedCount >
+ * 0` the footer reads `另有 N 个裸 claude 会话未归属 · Esc 不切换` (bare claude
+ * processes carry no --settings and cannot be attributed to a provider);
+ * otherwise it is plain `Esc 不切换`. Pure: no I/O; with `noColor` (NO_COLOR
+ * downgrade) zero ANSI escapes — 仅纯文本排版，❯ 缩进 + 列对齐保留。Redraw
+ * cursor-up height = `entries.length + 4` regardless (footer merges into the
+ * one hint row).
+ */
+export declare function renderPickerRows(entries: PickerEntry[], selectedIndex: number, noColor: boolean, unattributedCount?: number): string[];
+/**
+ * Production deps.pickProvider: arrow-key menu rendered entirely on stderr
+ * (stdout stays pipe-clean). ↑↓/j/k move with wrap, Enter confirms, Esc
+ * skips, ctrl-c restores the terminal then exits 130; any other key is a
+ * noop (C-P1). Frame = 标题 2 行 + 分隔线 + 条目 N 行 + dim `Esc 不切换`
+ * 末行提示——旧的可选中「不切换」行已退化为提示（skip 走 Esc/C-g），移动
+ * 只覆盖条目行。
+ *
+ * Zero deps: `readline.emitKeypressEvents` + raw-mode stdin + hand-written
+ * ANSI (16-color structure + truecolor Sage Limit 染色; `NO_COLOR` 非空 →
+ * 全无色纯文本). Rows are redrawn in place (cursor-up + `\r` + clear-to-EOL
+ * per line) so navigation leaves no ghosting (C-P3).
+ *
+ * Raw-mode lifecycle: `process.stdin.isRaw` is saved before
+ * `setRawMode(true)` and restored on EVERY exit path (confirm / Esc / ctrl-c
+ * / stream end / error) before the promise settles, and the keypress (and
+ * its lazily-attached internal `data`) listeners are removed — so the
+ * spawned claude TUI takes stdin over cleanly. The picker always completes
+ * before any backend spawn.
+ *
+ * `unattributedCount` (optional) drives the bare-claude footer hint; 0 or
+ * omitted renders the plain `Esc 不切换` footer. When the positional arg is
+ * absent, the count is recovered from the entries themselves
+ * (`PickerEntry.unattributed`, attached by the claude menu path) so two-arg
+ * pickProvider wrappers still render the hint.
+ */
+export declare function pickProviderInteractive(entries: PickerEntry[], initialIndex: number, unattributedCount?: number): Promise<PickerOutcome>;
+/**
+ * One provider's attribution facts, mapped from `extractProviderEnv()` output
+ * in the caller. Tokens live only in memory for comparison — they are never
+ * printed, logged, persisted, or embedded in any error message.
+ */
+export type SessionAttributionProvider = {
+    name: string;
+    baseUrl?: string;
+    authToken?: string;
+    apiKey?: string;
+};
+/** Per-provider live session counts + the bare-claude (unattributable) count. */
+export type SessionAttribution = {
+    counts: Record<string, number>;
+    unattributed: number;
+};
+/**
+ * Attribute joined ps argv lines to providers (pure, total — never throws).
+ * Lines with a parseable `--settings` env matching a provider increment that
+ * provider's count; providers with identical URL+token each count the same
+ * line (accepted edge). Bare claude lines, unparseable JSON, and settings
+ * matching no provider all count as `unattributed`.
+ */
+export declare function parseSessionAttribution(lines: string[], providers: SessionAttributionProvider[]): SessionAttribution;
 /**
  * Route argv to the agy / claude / api backend via injectable deps (C1/C2).
  * Returns a {exitCode, stdout, stderr} outcome; main() owns process.exit.