humanish 0.115.0 → 0.117.0

package/dist/tui/contract.d.ts

@@ -14,6 +14,13 @@ import type { CommsRecoveryEntry } from "../comms/lease-store.js";
 interface TuiVersionInfo {
     cli: string;
 }
+/** One provider key as `humanish keys` lists it. Never its value. */
+export interface TuiKeyStatus {
+    name: string;
+    set: boolean;
+    /** The line `humanish keys` prints for this key: what it is for, and its source or how to add it. */
+    line: string;
+}
 /**
  * What the surface may do to the project. Deliberately a small, explicit list rather than a handle
  * to the whole library: the set of verbs a stakeholder surface can perform should be readable in
@@ -36,6 +43,10 @@ export interface TuiCapabilities {
             message: string;
         }>;
     };
+    /** The provider keys `humanish keys` lists, in its order. A key is entered through the host. */
+    keys?: {
+        status(): Promise<TuiKeyStatus[]>;
+    };
     /** Read every run in the project, cheapest source first. */
     readRunIndex(cwd: string, options?: ReadRunIndexOptions): Promise<RunIndexResult>;
     /**
@@ -82,8 +93,11 @@ export interface TuiCapabilities {
     initProject(cwd: string): Promise<TuiActionResult>;
 }
 export interface TuiOptions {
-    /** Return to setup after the host-owned hidden prompt has finished. */
-    initialScreen?: "connections";
+    /**
+     * Return to the keys list or the email connection after the host-owned hidden prompt has
+     * finished, showing `connectionNotice`.
+     */
+    initialScreen?: "keys" | "connections";
     connectionNotice?: string;
     /** The project the surface is reading. Already resolved by the CLI. */
     cwd: string;
@@ -100,18 +114,29 @@ export interface TuiOptions {
     exitAfterFirstFrame?: boolean;
 }
 /**
- * Start the surface. Resolves with the process exit code when the operator quits; the TUI owns the
- * screen until then, so the CLI must not write to stdout while this is pending.
+ * A key the person asked to enter. The surface unmounts, the host asks for the value with hidden
+ * input and stores it, then mounts the surface again on `initialScreen`.
  */
 export type TuiHandoff = {
     action: "agentmail-key";
+} | {
+    action: "provider-key";
+    name: string;
 };
+/**
+ * Start the surface. Resolves with the process exit code when the operator quits, or with a key
+ * handoff; the TUI owns the screen until then, so the CLI must not write to stdout while this is
+ * pending.
+ */
 export type StartTui = (options: TuiOptions) => Promise<number | TuiHandoff>;
 /** The shape `dist/tui-app.js` exports. Asserted at the load boundary in cli/commands/tui.ts. */
 export interface TuiModule {
     startTui: StartTui;
 }
-/** Node version the Ink runtime requires (ink@7 declares `engines.node >= 22`). */
+/**
+ * Node version the Ink runtime requires: ink 8.0.0, which tui/package.json pins, declares
+ * `engines.node` `>=22`.
+ */
 export declare const TUI_MIN_NODE_MAJOR = 22;
 /**
  * Whether this runtime can host the surface. Kept here, beside the reason, so the CLI's refusal and

package/dist/tui/contract.js

@@ -13,7 +13,10 @@
 // It also makes the UI testable without a terminal: a test hands `startTui` a fake index and reads
 // the frames back.
 import { cli } from "../cli/invocation.js";
-/** Node version the Ink runtime requires (ink@7 declares `engines.node >= 22`). */
+/**
+ * Node version the Ink runtime requires: ink 8.0.0, which tui/package.json pins, declares
+ * `engines.node` `>=22`.
+ */
 export const TUI_MIN_NODE_MAJOR = 22;
 /**
  * Whether this runtime can host the surface. Kept here, beside the reason, so the CLI's refusal and