very-happy-cli 0.2.179 → 0.2.181

package/dist/lib.d.cts

@@ -200,12 +200,22 @@ declare const sessionStreamFrameSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
 }, z.core.$strip>], "t">;
 type SessionStreamFrame = z.infer<typeof sessionStreamFrameSchema>;
 
-/** Runtime context occupancy, never cumulative billing. null after compaction is unknown. */
+/**
+ * Runtime context occupancy, never cumulative billing. null after compaction is unknown.
+ *
+ * B-727 (specs/2026-10-pi-context-usage.md): `contextWindow` stays required so
+ * older webs keep rendering; `windowSource` says whether it may be used as a
+ * denominator. Free strings + read whitelist (iron rule 14): an unknown value
+ * must not make the whole agentState fail to parse.
+ */
 declare const ContextUsageSchema: z$1.ZodObject<{
     source: z$1.ZodLiteral<"pi">;
     tokens: z$1.ZodNullable<z$1.ZodNumber>;
     contextWindow: z$1.ZodNumber;
     updatedAt: z$1.ZodNumber;
+    windowSource: z$1.ZodOptional<z$1.ZodNullable<z$1.ZodString>>;
+    model: z$1.ZodOptional<z$1.ZodNullable<z$1.ZodString>>;
+    compactedAt: z$1.ZodOptional<z$1.ZodNullable<z$1.ZodNumber>>;
 }, z$1.core.$strip>;
 type ContextUsage = z$1.infer<typeof ContextUsageSchema>;
 
@@ -367,7 +377,10 @@ type Session = {
 declare const MachineMetadataSchema: z$1.ZodObject<{
     teamsVersion: z$1.ZodOptional<z$1.ZodNumber>;
     teamLaunchVersion: z$1.ZodOptional<z$1.ZodNumber>;
+    teamRetryVersion: z$1.ZodOptional<z$1.ZodNumber>;
     worktreeVersion: z$1.ZodOptional<z$1.ZodNumber>;
+    modelConfigVersion: z$1.ZodOptional<z$1.ZodNumber>;
+    harnessInstallVersion: z$1.ZodOptional<z$1.ZodNumber>;
     host: z$1.ZodString;
     platform: z$1.ZodString;
     happyCliVersion: z$1.ZodString;
@@ -420,6 +433,13 @@ declare const CliUpdateStateSchema: z$1.ZodObject<{
         detail: z$1.ZodOptional<z$1.ZodString>;
         at: z$1.ZodNumber;
     }, z$1.core.$strip>>>;
+    autoUpdateEnabled: z$1.ZodOptional<z$1.ZodBoolean>;
+    lastInstall: z$1.ZodOptional<z$1.ZodNullable<z$1.ZodObject<{
+        from: z$1.ZodString;
+        to: z$1.ZodString;
+        at: z$1.ZodNumber;
+        source: z$1.ZodString;
+    }, z$1.core.$strip>>>;
 }, z$1.core.$strip>;
 type CliUpdateState = z$1.infer<typeof CliUpdateStateSchema>;
 /**
@@ -545,6 +565,13 @@ declare const DaemonStateSchema: z$1.ZodObject<{
             detail: z$1.ZodOptional<z$1.ZodString>;
             at: z$1.ZodNumber;
         }, z$1.core.$strip>>>;
+        autoUpdateEnabled: z$1.ZodOptional<z$1.ZodBoolean>;
+        lastInstall: z$1.ZodOptional<z$1.ZodNullable<z$1.ZodObject<{
+            from: z$1.ZodString;
+            to: z$1.ZodString;
+            at: z$1.ZodNumber;
+            source: z$1.ZodString;
+        }, z$1.core.$strip>>>;
     }, z$1.core.$strip>>;
     claudeAuth: z$1.ZodOptional<z$1.ZodObject<{
         probeVersion: z$1.ZodNumber;
@@ -757,6 +784,18 @@ type Metadata = {
         idleMs: number;
         v: 1;
     };
+    /**
+     * B-679: written by a wrapper that went OFFLINE (SIGTERM / SIGINT: `sessions
+     * stop`, daemon stop / upgrade, shutdown); cleared by the next wrapper on
+     * reconnect. `seq` = its message cursor — user input stored above it (sent
+     * to the offline session) was never routed and is replayed on resume. Old
+     * clients ignore it.
+     */
+    exitCursor?: {
+        at: number;
+        seq: number;
+        v: 1;
+    };
     /** B-587: user opted this session out of idle hibernation (web ⋯ menu). */
     keepAwake?: boolean;
     flavor?: string;
@@ -1283,7 +1322,9 @@ declare class ApiSessionClient extends EventEmitter {
      * session down. Needs no socket; POSTs through the same session-message
      * channel so the web receives it identically to a cancel-button tombstone.
      */
-    cancelUndeliveredQueuedInputs(): Promise<void>;
+    cancelUndeliveredQueuedInputs(opts?: {
+        maxSeq?: number;
+    }): Promise<void>;
     /**
      * Send a message to session
      * @param body - Message body (can be MessageContent or raw content for agent messages)
@@ -1488,6 +1529,24 @@ interface WebPanel {
     embed: boolean;
 }
 
+/**
+ * B-689: why a daemon-spawned wrapper died before it reported its session.
+ *
+ * The wrapper runs with `stdio: 'ignore'`, so the daemon cannot read its
+ * stderr; the wrapper's own log file is the record (utils/exitReason.ts writes
+ * an `[EXIT] …` line on every non-zero exit). Older wrappers have no `[EXIT]`
+ * line — fall back to the last logged error.
+ */
+type StartupExit = {
+    /** The process is confirmed gone (exited, or stopped after the timeout). */
+    exited: boolean;
+    code: number | null;
+    signal: string | null;
+    /** No session report within the spawn window; the daemon stopped it. */
+    timedOut?: boolean;
+    reason?: string;
+};
+
 /**
  * The backends the daemon can spawn as a remote session.
  *
@@ -1584,8 +1643,150 @@ type SpawnSessionResult = {
 } | {
     type: 'error';
     errorMessage: string;
+    startupExit?: StartupExit;
 };
 
+/**
+ * B-688 wire shapes for the `model-config-*` machine RPCs
+ * (spec specs/2026-10-custom-models.md). Mirrored by the web in
+ * packages/happy-web-v2/src/sync/modelConfigTypes.ts — keep both in step.
+ *
+ * Patch convention: a field left `undefined` keeps the file's value; `null`
+ * or '' removes the key Very Happy manages. Secrets never come back: reads
+ * return `SecretView`, never the value.
+ */
+
+declare const MODEL_CONFIG_CAPABILITY_VERSION = 1;
+type HarnessId = 'claude' | 'codex' | 'gemini' | 'pi';
+interface SecretView {
+    /** none: nothing configured; command: a helper/command the user wrote (not shown). */
+    mode: 'none' | 'literal' | 'env' | 'command';
+    /** `sk-a…9f3c` / `••••` for literal; never the value. */
+    masked?: string;
+    envName?: string;
+    /** Whether the daemon's environment (inherited by sessions) defines envName. */
+    envPresent?: boolean;
+}
+interface ConfigWarning {
+    code: string;
+    message: string;
+}
+interface FileView {
+    role: string;
+    path: string;
+    exists: boolean;
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+interface BackupView {
+    id: string;
+    createdAt: number;
+    reason: string;
+    files: string[];
+}
+/** Per-harness current values, already masked. Shape depends on the harness. */
+interface HarnessCurrent {
+    baseUrl?: string | null;
+    apiKey?: SecretView;
+    authHeader?: 'bearer' | 'x-api-key';
+    model?: string | null;
+    opusModel?: string | null;
+    sonnetModel?: string | null;
+    haikuModel?: string | null;
+    pickerModels?: string[];
+    providerId?: string | null;
+    providerName?: string | null;
+    api?: string | null;
+    models?: string[];
+    /** pi: explicit `contextWindow` per model of the selected provider (B-727; absent on older daemons). */
+    contextWindows?: Record<string, number>;
+    defaultModel?: string | null;
+    /** codex/pi: provider currently selected by the harness. */
+    activeProvider?: string | null;
+    active?: boolean;
+}
+interface HarnessConfigView {
+    harness: HarnessId;
+    /** Harness binary found on the daemon's PATH. */
+    installed: boolean;
+    files: FileView[];
+    /** sha256 over all files; `apply`/`restore` refuse when the disk moved on. */
+    baseHash: string;
+    current: HarnessCurrent;
+    /** codex/pi: user-defined provider ids in the file. */
+    providers?: string[];
+    /** Model keys the web should offer in this harness's composer picker. */
+    pickerModels: string[];
+    backups: BackupView[];
+    warnings: ConfigWarning[];
+}
+interface ModelConfigReadResult {
+    version: typeof MODEL_CONFIG_CAPABILITY_VERSION;
+    harnesses: HarnessConfigView[];
+}
+interface FileDiff {
+    path: string;
+    /** Unified diff with secrets masked; '' when unchanged. */
+    diff: string;
+    created: boolean;
+    deleted: boolean;
+}
+interface ModelConfigApplyResult {
+    harness: HarnessId;
+    dryRun: boolean;
+    changed: boolean;
+    baseHash: string;
+    files: FileDiff[];
+    warnings: ConfigWarning[];
+    backup?: BackupView;
+    /** Fresh view after a real write. */
+    config?: HarnessConfigView;
+}
+
+interface ModelConfigServiceOptions {
+    /** The home the harnesses resolve `~` against (the daemon user's). */
+    home: string;
+    /** The daemon's environment: harness dir overrides + env-reference presence. */
+    env: NodeJS.ProcessEnv;
+    /** Very Happy home; backups and the audit log live under it. */
+    happyHomeDir: string;
+    isInstalled?: (binary: string) => boolean;
+    /** Called after a successful write (e.g. re-run the Claude auth preflight). */
+    onChanged?: (harness: HarnessId) => void;
+    now?: () => number;
+}
+declare class ModelConfigService {
+    private readonly opts;
+    private readonly backups;
+    private readonly auditPath;
+    private chain;
+    constructor(opts: ModelConfigServiceOptions);
+    private get ctx();
+    private serialize;
+    private loadFiles;
+    readOne(harness: HarnessId, providerId?: string): Promise<HarnessConfigView>;
+    read(params?: {
+        harness?: unknown;
+        providerId?: unknown;
+    }): Promise<ModelConfigReadResult>;
+    private diffs;
+    private write;
+    private audit;
+    apply(params: {
+        patch?: unknown;
+        baseHash?: unknown;
+        dryRun?: unknown;
+    }): Promise<ModelConfigApplyResult>;
+    restore(params: {
+        harness?: unknown;
+        backupId?: unknown;
+        baseHash?: unknown;
+        dryRun?: unknown;
+    }): Promise<ModelConfigApplyResult>;
+}
+
 /** Agent-specific visible-screen adapters. Unknown is deliberately not idle. */
 type CodingAgentKind = 'claude' | 'codex' | 'pi';
 
@@ -1784,6 +1985,8 @@ declare class ApiMachineClient {
     } | {
         error: string;
     }>): void;
+    /** B-719: `harness-install` — the owner asked this machine to install one harness id. */
+    setHarnessInstallHandler(handler: (params: unknown) => Promise<unknown>): void;
     setCliUpdateRetryHandler(handler: (version: unknown) => Promise<{
         accepted: true;
     } | {
@@ -1827,6 +2030,8 @@ declare class ApiMachineClient {
         }>;
         setStore: (store: 'auto' | 'file') => Promise<ClaudeAuthState>;
     }): void;
+    /** B-688 machine RPCs `model-config-*` (modules/modelConfig/modelConfigRpc.ts). */
+    setModelConfigService(service: ModelConfigService): void;
     /**
      * B-506: the five `sessions.*` methods a CLI on ANOTHER machine of this
      * account calls to read / message sessions this daemon spawned. Plaintext
@@ -1879,12 +2084,21 @@ declare class ApiMachineClient {
     private createControlSocket;
     private activateControlSocket;
     private bindControlDataHandlers;
+    private cliUpdatePolicyHandler;
+    /** B-718: the daemon decides what a policy announcement means (update/policyAnnouncement.ts). */
+    setCliUpdatePolicyHandler(handler: ((payload: unknown) => void) | null): void;
     private serverMigrateHandler;
     /** B-635: the daemon decides what to do with a relay-migration notice (daemon/serverMigration.ts). */
     setServerMigrateHandler(handler: ((notice: unknown) => void) | null): void;
     private startReleaseHandover;
     private releaseHandover;
     private startKeepAlive;
+    /**
+     * Re-detect CLI availability and publish it when it changed. Called on the
+     * throttled keep-alive and, B-719, right after the owner installed a
+     * harness so the launcher enables it without waiting up to five minutes.
+     */
+    recheckCliAvailability(): void;
     private bindRpcRequestHandler;
     private bindMachineCommandHandlers;
     private unbindMachineCommandHandlers;

package/dist/lib.d.mts

@@ -200,12 +200,22 @@ declare const sessionStreamFrameSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
 }, z.core.$strip>], "t">;
 type SessionStreamFrame = z.infer<typeof sessionStreamFrameSchema>;
 
-/** Runtime context occupancy, never cumulative billing. null after compaction is unknown. */
+/**
+ * Runtime context occupancy, never cumulative billing. null after compaction is unknown.
+ *
+ * B-727 (specs/2026-10-pi-context-usage.md): `contextWindow` stays required so
+ * older webs keep rendering; `windowSource` says whether it may be used as a
+ * denominator. Free strings + read whitelist (iron rule 14): an unknown value
+ * must not make the whole agentState fail to parse.
+ */
 declare const ContextUsageSchema: z$1.ZodObject<{
     source: z$1.ZodLiteral<"pi">;
     tokens: z$1.ZodNullable<z$1.ZodNumber>;
     contextWindow: z$1.ZodNumber;
     updatedAt: z$1.ZodNumber;
+    windowSource: z$1.ZodOptional<z$1.ZodNullable<z$1.ZodString>>;
+    model: z$1.ZodOptional<z$1.ZodNullable<z$1.ZodString>>;
+    compactedAt: z$1.ZodOptional<z$1.ZodNullable<z$1.ZodNumber>>;
 }, z$1.core.$strip>;
 type ContextUsage = z$1.infer<typeof ContextUsageSchema>;
 
@@ -367,7 +377,10 @@ type Session = {
 declare const MachineMetadataSchema: z$1.ZodObject<{
     teamsVersion: z$1.ZodOptional<z$1.ZodNumber>;
     teamLaunchVersion: z$1.ZodOptional<z$1.ZodNumber>;
+    teamRetryVersion: z$1.ZodOptional<z$1.ZodNumber>;
     worktreeVersion: z$1.ZodOptional<z$1.ZodNumber>;
+    modelConfigVersion: z$1.ZodOptional<z$1.ZodNumber>;
+    harnessInstallVersion: z$1.ZodOptional<z$1.ZodNumber>;
     host: z$1.ZodString;
     platform: z$1.ZodString;
     happyCliVersion: z$1.ZodString;
@@ -420,6 +433,13 @@ declare const CliUpdateStateSchema: z$1.ZodObject<{
         detail: z$1.ZodOptional<z$1.ZodString>;
         at: z$1.ZodNumber;
     }, z$1.core.$strip>>>;
+    autoUpdateEnabled: z$1.ZodOptional<z$1.ZodBoolean>;
+    lastInstall: z$1.ZodOptional<z$1.ZodNullable<z$1.ZodObject<{
+        from: z$1.ZodString;
+        to: z$1.ZodString;
+        at: z$1.ZodNumber;
+        source: z$1.ZodString;
+    }, z$1.core.$strip>>>;
 }, z$1.core.$strip>;
 type CliUpdateState = z$1.infer<typeof CliUpdateStateSchema>;
 /**
@@ -545,6 +565,13 @@ declare const DaemonStateSchema: z$1.ZodObject<{
             detail: z$1.ZodOptional<z$1.ZodString>;
             at: z$1.ZodNumber;
         }, z$1.core.$strip>>>;
+        autoUpdateEnabled: z$1.ZodOptional<z$1.ZodBoolean>;
+        lastInstall: z$1.ZodOptional<z$1.ZodNullable<z$1.ZodObject<{
+            from: z$1.ZodString;
+            to: z$1.ZodString;
+            at: z$1.ZodNumber;
+            source: z$1.ZodString;
+        }, z$1.core.$strip>>>;
     }, z$1.core.$strip>>;
     claudeAuth: z$1.ZodOptional<z$1.ZodObject<{
         probeVersion: z$1.ZodNumber;
@@ -757,6 +784,18 @@ type Metadata = {
         idleMs: number;
         v: 1;
     };
+    /**
+     * B-679: written by a wrapper that went OFFLINE (SIGTERM / SIGINT: `sessions
+     * stop`, daemon stop / upgrade, shutdown); cleared by the next wrapper on
+     * reconnect. `seq` = its message cursor — user input stored above it (sent
+     * to the offline session) was never routed and is replayed on resume. Old
+     * clients ignore it.
+     */
+    exitCursor?: {
+        at: number;
+        seq: number;
+        v: 1;
+    };
     /** B-587: user opted this session out of idle hibernation (web ⋯ menu). */
     keepAwake?: boolean;
     flavor?: string;
@@ -1283,7 +1322,9 @@ declare class ApiSessionClient extends EventEmitter {
      * session down. Needs no socket; POSTs through the same session-message
      * channel so the web receives it identically to a cancel-button tombstone.
      */
-    cancelUndeliveredQueuedInputs(): Promise<void>;
+    cancelUndeliveredQueuedInputs(opts?: {
+        maxSeq?: number;
+    }): Promise<void>;
     /**
      * Send a message to session
      * @param body - Message body (can be MessageContent or raw content for agent messages)
@@ -1488,6 +1529,24 @@ interface WebPanel {
     embed: boolean;
 }
 
+/**
+ * B-689: why a daemon-spawned wrapper died before it reported its session.
+ *
+ * The wrapper runs with `stdio: 'ignore'`, so the daemon cannot read its
+ * stderr; the wrapper's own log file is the record (utils/exitReason.ts writes
+ * an `[EXIT] …` line on every non-zero exit). Older wrappers have no `[EXIT]`
+ * line — fall back to the last logged error.
+ */
+type StartupExit = {
+    /** The process is confirmed gone (exited, or stopped after the timeout). */
+    exited: boolean;
+    code: number | null;
+    signal: string | null;
+    /** No session report within the spawn window; the daemon stopped it. */
+    timedOut?: boolean;
+    reason?: string;
+};
+
 /**
  * The backends the daemon can spawn as a remote session.
  *
@@ -1584,8 +1643,150 @@ type SpawnSessionResult = {
 } | {
     type: 'error';
     errorMessage: string;
+    startupExit?: StartupExit;
 };
 
+/**
+ * B-688 wire shapes for the `model-config-*` machine RPCs
+ * (spec specs/2026-10-custom-models.md). Mirrored by the web in
+ * packages/happy-web-v2/src/sync/modelConfigTypes.ts — keep both in step.
+ *
+ * Patch convention: a field left `undefined` keeps the file's value; `null`
+ * or '' removes the key Very Happy manages. Secrets never come back: reads
+ * return `SecretView`, never the value.
+ */
+
+declare const MODEL_CONFIG_CAPABILITY_VERSION = 1;
+type HarnessId = 'claude' | 'codex' | 'gemini' | 'pi';
+interface SecretView {
+    /** none: nothing configured; command: a helper/command the user wrote (not shown). */
+    mode: 'none' | 'literal' | 'env' | 'command';
+    /** `sk-a…9f3c` / `••••` for literal; never the value. */
+    masked?: string;
+    envName?: string;
+    /** Whether the daemon's environment (inherited by sessions) defines envName. */
+    envPresent?: boolean;
+}
+interface ConfigWarning {
+    code: string;
+    message: string;
+}
+interface FileView {
+    role: string;
+    path: string;
+    exists: boolean;
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+interface BackupView {
+    id: string;
+    createdAt: number;
+    reason: string;
+    files: string[];
+}
+/** Per-harness current values, already masked. Shape depends on the harness. */
+interface HarnessCurrent {
+    baseUrl?: string | null;
+    apiKey?: SecretView;
+    authHeader?: 'bearer' | 'x-api-key';
+    model?: string | null;
+    opusModel?: string | null;
+    sonnetModel?: string | null;
+    haikuModel?: string | null;
+    pickerModels?: string[];
+    providerId?: string | null;
+    providerName?: string | null;
+    api?: string | null;
+    models?: string[];
+    /** pi: explicit `contextWindow` per model of the selected provider (B-727; absent on older daemons). */
+    contextWindows?: Record<string, number>;
+    defaultModel?: string | null;
+    /** codex/pi: provider currently selected by the harness. */
+    activeProvider?: string | null;
+    active?: boolean;
+}
+interface HarnessConfigView {
+    harness: HarnessId;
+    /** Harness binary found on the daemon's PATH. */
+    installed: boolean;
+    files: FileView[];
+    /** sha256 over all files; `apply`/`restore` refuse when the disk moved on. */
+    baseHash: string;
+    current: HarnessCurrent;
+    /** codex/pi: user-defined provider ids in the file. */
+    providers?: string[];
+    /** Model keys the web should offer in this harness's composer picker. */
+    pickerModels: string[];
+    backups: BackupView[];
+    warnings: ConfigWarning[];
+}
+interface ModelConfigReadResult {
+    version: typeof MODEL_CONFIG_CAPABILITY_VERSION;
+    harnesses: HarnessConfigView[];
+}
+interface FileDiff {
+    path: string;
+    /** Unified diff with secrets masked; '' when unchanged. */
+    diff: string;
+    created: boolean;
+    deleted: boolean;
+}
+interface ModelConfigApplyResult {
+    harness: HarnessId;
+    dryRun: boolean;
+    changed: boolean;
+    baseHash: string;
+    files: FileDiff[];
+    warnings: ConfigWarning[];
+    backup?: BackupView;
+    /** Fresh view after a real write. */
+    config?: HarnessConfigView;
+}
+
+interface ModelConfigServiceOptions {
+    /** The home the harnesses resolve `~` against (the daemon user's). */
+    home: string;
+    /** The daemon's environment: harness dir overrides + env-reference presence. */
+    env: NodeJS.ProcessEnv;
+    /** Very Happy home; backups and the audit log live under it. */
+    happyHomeDir: string;
+    isInstalled?: (binary: string) => boolean;
+    /** Called after a successful write (e.g. re-run the Claude auth preflight). */
+    onChanged?: (harness: HarnessId) => void;
+    now?: () => number;
+}
+declare class ModelConfigService {
+    private readonly opts;
+    private readonly backups;
+    private readonly auditPath;
+    private chain;
+    constructor(opts: ModelConfigServiceOptions);
+    private get ctx();
+    private serialize;
+    private loadFiles;
+    readOne(harness: HarnessId, providerId?: string): Promise<HarnessConfigView>;
+    read(params?: {
+        harness?: unknown;
+        providerId?: unknown;
+    }): Promise<ModelConfigReadResult>;
+    private diffs;
+    private write;
+    private audit;
+    apply(params: {
+        patch?: unknown;
+        baseHash?: unknown;
+        dryRun?: unknown;
+    }): Promise<ModelConfigApplyResult>;
+    restore(params: {
+        harness?: unknown;
+        backupId?: unknown;
+        baseHash?: unknown;
+        dryRun?: unknown;
+    }): Promise<ModelConfigApplyResult>;
+}
+
 /** Agent-specific visible-screen adapters. Unknown is deliberately not idle. */
 type CodingAgentKind = 'claude' | 'codex' | 'pi';
 
@@ -1784,6 +1985,8 @@ declare class ApiMachineClient {
     } | {
         error: string;
     }>): void;
+    /** B-719: `harness-install` — the owner asked this machine to install one harness id. */
+    setHarnessInstallHandler(handler: (params: unknown) => Promise<unknown>): void;
     setCliUpdateRetryHandler(handler: (version: unknown) => Promise<{
         accepted: true;
     } | {
@@ -1827,6 +2030,8 @@ declare class ApiMachineClient {
         }>;
         setStore: (store: 'auto' | 'file') => Promise<ClaudeAuthState>;
     }): void;
+    /** B-688 machine RPCs `model-config-*` (modules/modelConfig/modelConfigRpc.ts). */
+    setModelConfigService(service: ModelConfigService): void;
     /**
      * B-506: the five `sessions.*` methods a CLI on ANOTHER machine of this
      * account calls to read / message sessions this daemon spawned. Plaintext
@@ -1879,12 +2084,21 @@ declare class ApiMachineClient {
     private createControlSocket;
     private activateControlSocket;
     private bindControlDataHandlers;
+    private cliUpdatePolicyHandler;
+    /** B-718: the daemon decides what a policy announcement means (update/policyAnnouncement.ts). */
+    setCliUpdatePolicyHandler(handler: ((payload: unknown) => void) | null): void;
     private serverMigrateHandler;
     /** B-635: the daemon decides what to do with a relay-migration notice (daemon/serverMigration.ts). */
     setServerMigrateHandler(handler: ((notice: unknown) => void) | null): void;
     private startReleaseHandover;
     private releaseHandover;
     private startKeepAlive;
+    /**
+     * Re-detect CLI availability and publish it when it changed. Called on the
+     * throttled keep-alive and, B-719, right after the owner installed a
+     * harness so the launcher enables it without waiting up to five minutes.
+     */
+    recheckCliAvailability(): void;
     private bindRpcRequestHandler;
     private bindMachineCommandHandlers;
     private unbindMachineCommandHandlers;

package/dist/lib.mjs

@@ -1,9 +1,9 @@
-export { A as ApiClient, a as ApiSessionClient } from './api-CzwFpJQc.mjs';
-export { l as logger } from './logger-BtVhHnD8.mjs';
-export { c as configuration } from './configuration-WMi4idBB.mjs';
+export { A as ApiClient, a as ApiSessionClient } from './api-Dr3wXL_7.mjs';
+export { l as logger } from './logger-LFr8iPgl.mjs';
+export { c as configuration } from './configuration-BPrfb17M.mjs';
 export { R as RawJSONLinesSchema } from './types-CkqAACXx.mjs';
 import 'axios';
-import './lidState-Bb8fgXg3.mjs';
+import './lidState-DghbfRbr.mjs';
 import './authRelay-DhQhkBvX.mjs';
 import 'node:crypto';
 import 'tweetnacl';
@@ -11,14 +11,14 @@ import 'os';
 import 'child_process';
 import 'node:events';
 import 'socket.io-client';
-import './pushNotifications-BdFjDjQe.mjs';
+import './pushNotifications-DXGIhE-A.mjs';
 import 'zod';
-import './index-DPOa4NhL.mjs';
+import './index-CeRXrGnH.mjs';
 import '@paralleldrive/cuid2';
 import './contentLogMetadata-BlWI0egu.mjs';
 import './limits-DIo7rEBR.mjs';
-import './time-65DcU6Jx.mjs';
-import './registerCommonHandlers-BAlP7SGc.mjs';
+import './time-BcoJaG8E.mjs';
+import './registerCommonHandlers-DF6bdDtd.mjs';
 import 'util';
 import 'fs/promises';
 import 'crypto';
@@ -26,14 +26,14 @@ import 'path';
 import 'cross-spawn';
 import './projectPath-BTBIMB57.mjs';
 import 'url';
-import './sync-CSe0Rf45.mjs';
-import './backgroundTaskActivity-BVwJBl02.mjs';
-import './controlClient-BWUJrj3t.mjs';
-import './persistence-Cr-wutZ4.mjs';
+import './sync-DO-2PU45.mjs';
+import './backgroundTaskActivity-8PdPxrvy.mjs';
+import './controlClient-CkNpT5zS.mjs';
+import './persistence-D2Djrf7t.mjs';
 import 'node:fs/promises';
 import 'node:fs';
 import 'chalk';
 import 'node:util';
 import 'node:path';
 import 'node:os';
-import './package-BPPebGQF.mjs';
+import './package-DYGwlmXl.mjs';

package/dist/{lidState-Bb8fgXg3.mjs → lidState-DghbfRbr.mjs}

@@ -1,4 +1,4 @@
-import { l as logger } from './logger-BtVhHnD8.mjs';
+import { l as logger } from './logger-LFr8iPgl.mjs';
 import { e as encodeBase64, g as encrypt, h as decrypt, d as decodeBase64 } from './authRelay-DhQhkBvX.mjs';
 import os from 'os';
 import { execSync } from 'child_process';

package/dist/{lidState-Dv2wwFTj.cjs → lidState-x8cJ8J_9.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var logger = require('./logger-C1GWx3gi.cjs');
+var logger = require('./logger-DgBwUSgS.cjs');
 var authRelay = require('./authRelay-Dy1qU9td.cjs');
 var os = require('os');
 var child_process = require('child_process');

package/dist/{localHappyAgentAuth-DjYvkXvV.cjs → localHappyAgentAuth-DZ2kb9uq.cjs}

@@ -6,7 +6,7 @@ var path = require('node:path');
 var tweetnacl = require('tweetnacl');
 var z = require('zod');
 var authRelay = require('./authRelay-Dy1qU9td.cjs');
-var configuration = require('./configuration-CMHZnp6G.cjs');
+var configuration = require('./configuration-C8JgseHy.cjs');
 
 const AgentCredentialsSchema = z.z.object({
   token: z.z.string().min(1),