very-happy-cli 0.2.165 → 0.2.166

package/dist/{index-DjtBengz.mjs → index-WGCT6SSV.mjs}

@@ -1,34 +1,34 @@
-import { D as DefaultTransport, A as AcpBackend } from './AcpBackend-C11FnVw5.mjs';
-export { a as DEFAULT_IDLE_TIMEOUT_MS, b as DEFAULT_TOOL_CALL_TIMEOUT_MS, e as extractErrorDetail, f as formatDuration, c as formatDurationMinutes, h as handleAgentMessageChunk, d as handleAgentThoughtChunk, g as handleLegacyMessageChunk, i as handlePlanUpdate, j as handleThinkingUpdate, k as handleToolCall, l as handleToolCallUpdate, p as parseArgsFromContent } from './AcpBackend-C11FnVw5.mjs';
-import { l as logger } from './logger-CknSVkIe.mjs';
-import { A as AcpSessionManager } from './AcpSessionManager-BQnDJvct.mjs';
-import { l as BUILTIN_TODO_DISCOVERY, P as PROMPT_QUEUE_CAPABILITY } from './index-vVWpCoTr.mjs';
+import { D as DefaultTransport, A as AcpBackend } from './AcpBackend-tRWk7yi7.mjs';
+export { a as DEFAULT_IDLE_TIMEOUT_MS, b as DEFAULT_TOOL_CALL_TIMEOUT_MS, e as extractErrorDetail, f as formatDuration, c as formatDurationMinutes, h as handleAgentMessageChunk, d as handleAgentThoughtChunk, g as handleLegacyMessageChunk, i as handlePlanUpdate, j as handleThinkingUpdate, k as handleToolCall, l as handleToolCallUpdate, p as parseArgsFromContent } from './AcpBackend-tRWk7yi7.mjs';
+import { l as logger } from './logger-BpQcwNnt.mjs';
+import { A as AcpSessionManager } from './AcpSessionManager-B7FIrsys.mjs';
+import { o as BUILTIN_TODO_DISCOVERY, P as PROMPT_QUEUE_CAPABILITY } from './index-B0HEEYGh.mjs';
 import { r as registerAgentAttachmentDownloads } from './agentAttachments-M_B5qEF2.mjs';
-import { c as configuration } from './configuration-L1qcGTFM.mjs';
-import { C as CLAUDE_ATTACHMENT_KINDS, a as stageClaudeAttachments, b as appendStagedAttachmentsToPrompt } from './attachmentContent-dzIs-wis.mjs';
-import { p as preparePiTeamsRuntime } from './piRuntime-DKFA8u8t.mjs';
+import { c as configuration } from './configuration-D2v3puap.mjs';
+import { C as CLAUDE_ATTACHMENT_KINDS, a as stageClaudeAttachments, b as appendStagedAttachmentsToPrompt } from './attachmentContent-CTXapi-_.mjs';
+import { p as preparePiTeamsRuntime } from './piRuntime-0qEK5AqE.mjs';
 import { randomUUID } from 'node:crypto';
 import { join } from 'node:path';
-import { c as connectionState, A as ApiClient } from './api-DTVPUE7g.mjs';
-import { M as MessageQueue2, r as registerKillSessionHandler } from './registerKillSessionHandler-Czz0tdki.mjs';
-import { h as hashObject, s as startHappyServer } from './deterministicJson-BBwG-Ase.mjs';
-import { readSettings } from './persistence-DujtUH94.mjs';
-import { g as getInitialMachineMetadata } from './machineMetadata-Cj1DoFot.mjs';
-import { c as createSessionMetadata } from './createSessionMetadata-CWR-AB2A.mjs';
-import { s as setupOfflineReconnection } from './setupOfflineReconnection-_MoZtsro.mjs';
-import { n as notifyDaemonSessionStarted, g as reportSessionEditToDaemon } from './controlClient-Ci7HTMII.mjs';
+import { c as connectionState, A as ApiClient } from './api-Cmz3XS4P.mjs';
+import { M as MessageQueue2, r as registerKillSessionHandler } from './registerKillSessionHandler-DboQlGcH.mjs';
+import { h as hashObject, s as startHappyServer } from './deterministicJson-D-WPUrZb.mjs';
+import { readSettings } from './persistence-B9LmhAE2.mjs';
+import { g as getInitialMachineMetadata } from './machineMetadata-CBdxABeI.mjs';
+import { c as createSessionMetadata } from './createSessionMetadata-DU0bCg2m.mjs';
+import { s as setupOfflineReconnection } from './setupOfflineReconnection-Byy8aeKT.mjs';
+import { n as notifyDaemonSessionStarted, h as reportSessionEditToDaemon } from './controlClient-BMUJfUeF.mjs';
 import { e as encodeBase64 } from './authRelay-DSAvg1uv.mjs';
-import { S as StreamRelay } from './streamRelay-BzMEEvJU.mjs';
+import { S as StreamRelay } from './streamRelay-Iogsh51a.mjs';
 import { p as projectPath } from './projectPath-BTBIMB57.mjs';
-import { B as BasePermissionHandler } from './BasePermissionHandler-CwJ48yiB.mjs';
-import { T as TitleGenerator } from './titleGenerator-BhoblAQY.mjs';
-import { w as writeSessionModeFile, n as normalizeAcpPermissionMode, r as removeSessionModeFile } from './sessionModeFile-CuNAWCKL.mjs';
+import { B as BasePermissionHandler } from './BasePermissionHandler-CDCLIrZJ.mjs';
+import { T as TitleGenerator } from './titleGenerator-ChImQ4q-.mjs';
+import { w as writeSessionModeFile, n as normalizeAcpPermissionMode, r as removeSessionModeFile } from './sessionModeFile-M4OpiyrF.mjs';
 import { E as EditReportThrottle, e as extractAcpEditPaths } from './editPaths-BVfS_FFL.mjs';
 import 'node:child_process';
 import '@agentclientprotocol/sdk';
-import './time-v1Y_qEJp.mjs';
+import './time-CfDKj6Bx.mjs';
 import './contentLogMetadata-BlWI0egu.mjs';
-import './package-VIUXrYZ1.mjs';
+import './package-BqwrPxL0.mjs';
 import 'chalk';
 import 'node:util';
 import 'node:fs';
@@ -36,48 +36,49 @@ import '@paralleldrive/cuid2';
 import 'zod';
 import 'node:os';
 import 'node:fs/promises';
-import './attachmentLimits-B8nzhw-i.mjs';
+import './attachmentLimits-C1PCCM79.mjs';
 import './resources-BdFBQi8r.mjs';
 import 'axios';
-import './lidState-BLHLmhwd.mjs';
+import './lidState-BfximpjX.mjs';
 import 'os';
 import 'child_process';
 import 'node:events';
 import 'socket.io-client';
 import './limits-DIo7rEBR.mjs';
-import './registerCommonHandlers-BR0J4g64.mjs';
+import './registerCommonHandlers-DdfGsFbM.mjs';
 import 'util';
 import 'fs/promises';
 import 'crypto';
 import 'path';
 import 'cross-spawn';
-import './sync-Dfm6K2te.mjs';
+import './sync-BLpH13Kb.mjs';
 import './backgroundTaskActivity-8PdPxrvy.mjs';
 import 'tweetnacl';
 import './types-CkqAACXx.mjs';
-import './client-BwaWdlCm.mjs';
-import './context-DaCCB4cm.mjs';
-import './sessionOps-DG5MMEp_.mjs';
-import './tools-jof0Bu54.mjs';
-import './tools-BVRoGcQH.mjs';
-import './client-CJZKBZCE.mjs';
-import './peerTools-SWITnkqz.mjs';
+import './client-CbK33y_s.mjs';
+import './context-DjfqLWzE.mjs';
+import './sessionOps-BnaEaOKs.mjs';
+import './tools-3X2z3YDe.mjs';
+import './reportProgressTool-DnAD8wOa.mjs';
+import './client-GjTnsq6F.mjs';
+import './precheckCompat-DeEbilbr.mjs';
+import './agentGuidance-BDYt2Qy2.mjs';
+import './trimIdent-BAjmv_TG.mjs';
+import './peerTools-CeCe-3lk.mjs';
 import './ids-DU6sLx4C.mjs';
-import './remoteSessionClient-DCAUHgPz.mjs';
+import './remoteSessionClient-B2DtWuNP.mjs';
 import '@modelcontextprotocol/sdk/server/mcp.js';
 import 'node:http';
 import '@modelcontextprotocol/sdk/server/streamableHttp.js';
-import './assistantTools-DPGga5lM.mjs';
+import './downloadTarget-DjSwMHun.mjs';
 import './terminals-Dlg0x3nY.mjs';
 import './terminalTitleSuggest-CeKsX_V6.mjs';
 import './tmuxSocket-B8Yx20sT.mjs';
-import './bootstrap-D_ExGrY2.mjs';
-import './agentGuidance-CQuNlNx8.mjs';
-import './trimIdent-BAjmv_TG.mjs';
+import './bootstrap-XE8A7Ut2.mjs';
 import './previewPath-CXN4Vag0.mjs';
 import './detectCLI-CSGMlV51.mjs';
 import 'fs';
-import './localHappyAgentAuth-BWvmc_Hg.mjs';
+import './localHappyAgentAuth-Ct1aXwqd.mjs';
 import 'url';
 import 'node:module';
 import './oneShotPrompts-DT4p6RNd.mjs';

package/dist/index.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
-require('./package-UkmvSFsg.cjs');
-require('./index-BzIxE0Eu.cjs');
+require('./package-C1XvUQFy.cjs');
+require('./index-CaFCAlX8.cjs');
 require('node:module');
 require('node:fs');
 require('node:fs/promises');

package/dist/index.mjs

@@ -1,5 +1,5 @@
-import './package-VIUXrYZ1.mjs';
-import './index-BgzjPv07.mjs';
+import './package-BqwrPxL0.mjs';
+import './index-HQsigW_J.mjs';
 import 'node:module';
 import 'node:fs';
 import 'node:fs/promises';

package/dist/{install-BO_W7VhL.mjs → install-BdvKiOQw.mjs}

@@ -24,6 +24,8 @@ Pick the trigger, then the action. \`spawn\` takes an agent (claude / codex / pi
 
 Use \`sticky: { key }\` on a spawn action when repeated events about the same subject should continue one conversation: the key is a template (for example \`{{payload.conversationId}}\`). A run whose rendered key matches a live session sends the prompt into that session; otherwise it spawns a new one and remembers it. A dead or archived session is replaced on the next run.
 
+Add a \`precheck\` when the action should only run if there is something to do (for example "new messages since the last run"): exactly one of \`command\` (argv) or \`shell\` (one command line, not template-rendered \u2014 read the payload from \`$VH_AUTOMATION_PAYLOAD\`), optional \`cwd\` (defaults to the action directory), \`timeoutMs\` (default 60s, max 10m) and \`includeOutput\` (append its stdout to the spawn/send prompt as context). Exit 0 runs the action; any other exit records the run as skipped (\`precheck_failed\`), a timeout or launch error as \`precheck_timeout\` / \`precheck_error\` with attention. Consecutive scheduled skips for the same reason fold into one run with an \`occurrenceCount\` (fired and manual runs keep one run each). A machine whose CLI is too old to run prechecks never executes the action; its runs are skipped as \`precheck_unsupported_cli\`.
+
 \`concurrency: skip\` (default) records a run as skipped while the previous one is still running; \`queue\` waits. \`maxRuntimeMs\` bounds a run (default 6h; scripts 30m).
 
 ## Event triggers

package/dist/{install-DrUQk2DJ.cjs → install-CejEiRGW.cjs}

@@ -1,17 +1,17 @@
 'use strict';
 
-var logger = require('./logger-D0hkk7Vo.cjs');
+var logger = require('./logger-JTcJU-uL.cjs');
 var fs = require('fs');
 var child_process = require('child_process');
 var trimIdent = require('./trimIdent-4gvk9Wk6.cjs');
 var os = require('os');
 require('chalk');
 require('node:util');
-require('./configuration-BE61XNsg.cjs');
+require('./configuration-B0cb3xA3.cjs');
 require('node:fs');
 require('node:os');
 require('node:path');
-require('./package-UkmvSFsg.cjs');
+require('./package-C1XvUQFy.cjs');
 require('node:fs/promises');
 
 const PLIST_LABEL = "com.happy-cli.daemon";

package/dist/{install-Cs5qAPrB.cjs → install-Cf6AFSWC.cjs}

@@ -26,6 +26,8 @@ Pick the trigger, then the action. \`spawn\` takes an agent (claude / codex / pi
 
 Use \`sticky: { key }\` on a spawn action when repeated events about the same subject should continue one conversation: the key is a template (for example \`{{payload.conversationId}}\`). A run whose rendered key matches a live session sends the prompt into that session; otherwise it spawns a new one and remembers it. A dead or archived session is replaced on the next run.
 
+Add a \`precheck\` when the action should only run if there is something to do (for example "new messages since the last run"): exactly one of \`command\` (argv) or \`shell\` (one command line, not template-rendered \u2014 read the payload from \`$VH_AUTOMATION_PAYLOAD\`), optional \`cwd\` (defaults to the action directory), \`timeoutMs\` (default 60s, max 10m) and \`includeOutput\` (append its stdout to the spawn/send prompt as context). Exit 0 runs the action; any other exit records the run as skipped (\`precheck_failed\`), a timeout or launch error as \`precheck_timeout\` / \`precheck_error\` with attention. Consecutive scheduled skips for the same reason fold into one run with an \`occurrenceCount\` (fired and manual runs keep one run each). A machine whose CLI is too old to run prechecks never executes the action; its runs are skipped as \`precheck_unsupported_cli\`.
+
 \`concurrency: skip\` (default) records a run as skipped while the previous one is still running; \`queue\` waits. \`maxRuntimeMs\` bounds a run (default 6h; scripts 30m).
 
 ## Event triggers

package/dist/{install-Cp_aB-NQ.mjs → install-oJUvsFu9.mjs}

@@ -1,15 +1,15 @@
-import { l as logger } from './logger-CknSVkIe.mjs';
+import { l as logger } from './logger-BpQcwNnt.mjs';
 import { existsSync, writeFileSync, chmodSync } from 'fs';
 import { execSync } from 'child_process';
 import { t as trimIdent } from './trimIdent-BAjmv_TG.mjs';
 import os from 'os';
 import 'chalk';
 import 'node:util';
-import './configuration-L1qcGTFM.mjs';
+import './configuration-D2v3puap.mjs';
 import 'node:fs';
 import 'node:os';
 import 'node:path';
-import './package-VIUXrYZ1.mjs';
+import './package-BqwrPxL0.mjs';
 import 'node:fs/promises';
 
 const PLIST_LABEL = "com.happy-cli.daemon";

package/dist/lib.cjs

@@ -1,11 +1,11 @@
 'use strict';
 
-var api = require('./api-AzdzTKFs.cjs');
-var logger = require('./logger-D0hkk7Vo.cjs');
-var configuration = require('./configuration-BE61XNsg.cjs');
+var api = require('./api-DnNL5fLw.cjs');
+var logger = require('./logger-JTcJU-uL.cjs');
+var configuration = require('./configuration-B0cb3xA3.cjs');
 var types = require('./types-CRS-srZK.cjs');
 require('axios');
-require('./lidState-z9ekRpZu.cjs');
+require('./lidState-D8BmnJV1.cjs');
 require('./authRelay-BdYkC1Po.cjs');
 require('node:crypto');
 require('tweetnacl');
@@ -13,13 +13,13 @@ require('os');
 require('child_process');
 require('node:events');
 require('socket.io-client');
-require('./attachmentLimits-eJZ4ZBjF.cjs');
+require('./attachmentLimits-BfgKV5iE.cjs');
 require('zod');
-require('./index-DqlyNgt4.cjs');
+require('./index-C9hI8a10.cjs');
 require('@paralleldrive/cuid2');
 require('./limits-C-a7gr04.cjs');
-require('./time-BbzJ7PJQ.cjs');
-require('./registerCommonHandlers--8ds2auE.cjs');
+require('./time-T0YmeOhS.cjs');
+require('./registerCommonHandlers-Aha_KfM3.cjs');
 require('util');
 require('fs/promises');
 require('crypto');
@@ -27,10 +27,10 @@ require('path');
 require('cross-spawn');
 require('./projectPath-ChLhdOyt.cjs');
 require('url');
-require('./sync-DwUUGGFz.cjs');
+require('./sync-x_lI_3j_.cjs');
 require('./backgroundTaskActivity-CBvUdj39.cjs');
-require('./controlClient-RWTlQA4_.cjs');
-require('./persistence-C6ztVW1W.cjs');
+require('./controlClient-CmnHGcyl.cjs');
+require('./persistence-2Xp_o6x6.cjs');
 require('node:fs/promises');
 require('node:fs');
 require('./contentLogMetadata-ZSFk_NjQ.cjs');
@@ -38,7 +38,7 @@ require('chalk');
 require('node:util');
 require('node:path');
 require('node:os');
-require('./package-UkmvSFsg.cjs');
+require('./package-C1XvUQFy.cjs');
 
 
 

package/dist/lib.d.cts

@@ -506,6 +506,10 @@ declare const DaemonStateSchema: z$1.ZodObject<{
         rpcAvailable: z$1.ZodBoolean;
         detectedAt: z$1.ZodNumber;
     }, z$1.core.$strip>>;
+    historySearch: z$1.ZodOptional<z$1.ZodObject<{
+        rpcAvailable: z$1.ZodBoolean;
+        detectedAt: z$1.ZodNumber;
+    }, z$1.core.$strip>>;
     terminalHost: z$1.ZodOptional<z$1.ZodObject<{
         tmuxAvailable: z$1.ZodBoolean;
         tmuxVersion: z$1.ZodOptional<z$1.ZodString>;
@@ -563,6 +567,21 @@ declare const DaemonStateSchema: z$1.ZodObject<{
         }, z$1.core.$strip>;
         checkedAt: z$1.ZodNumber;
     }, z$1.core.$strip>>;
+    rateLimits: z$1.ZodOptional<z$1.ZodObject<{
+        v: z$1.ZodLiteral<1>;
+        updatedAt: z$1.ZodNumber;
+        providers: z$1.ZodRecord<z$1.ZodString, z$1.ZodObject<{
+            observedAt: z$1.ZodNumber;
+            status: z$1.ZodOptional<z$1.ZodString>;
+            windows: z$1.ZodArray<z$1.ZodObject<{
+                kind: z$1.ZodString;
+                usedPercent: z$1.ZodNumber;
+                resetsAt: z$1.ZodNullable<z$1.ZodNumber>;
+                windowMinutes: z$1.ZodOptional<z$1.ZodNumber>;
+                observedAt: z$1.ZodNumber;
+            }, z$1.core.$strip>>;
+        }, z$1.core.$strip>>;
+    }, z$1.core.$strip>>;
 }, z$1.core.$strip>;
 type DaemonState = z$1.infer<typeof DaemonStateSchema>;
 type ClaudeAuthState = ClaudeAuthState$1;
@@ -787,6 +806,8 @@ type Metadata = {
         attention?: 'none' | 'review' | 'blocked';
         /** one-line Chinese progress note */
         progress?: string;
+        /** B-556: optional phase from report_progress (self-report only) */
+        phase?: string;
         analyzedAt: number;
     };
 };
@@ -1321,7 +1342,7 @@ declare class ApiSessionClient extends EventEmitter {
      * payload on this channel is (clipboard, fs RPC) — and a path leaks
      * project/client names and directory structure.
      */
-    pushFilePreview(path: string, mode?: 'file' | 'diff'): {
+    pushFilePreview(path: string, mode?: 'file' | 'diff', intent?: 'download'): {
         delivered: boolean;
         error?: string;
     };
@@ -1545,6 +1566,26 @@ interface CLIAvailability {
     detectedAt: number;
 }
 
+type RateLimitProvider = 'claude' | 'codex';
+type RateLimitWindow = {
+    /** five_hour | seven_day | seven_day_opus | seven_day_sonnet | seven_day_overage_included | window_<mins>m */
+    kind: string;
+    /** 0–100, may exceed 100 when usage legitimately runs past the cap. */
+    usedPercent: number;
+    /** ms epoch, null when unknown. */
+    resetsAt: number | null;
+    windowMinutes?: number;
+    /** ms epoch of the observation that produced this value. */
+    observedAt: number;
+};
+/** One provider's observation as sent wrapper → daemon. */
+type RateLimitReport = {
+    provider: RateLimitProvider;
+    observedAt: number;
+    status?: string;
+    windows: RateLimitWindow[];
+};
+
 /**
  * WebSocket client for machine/daemon communication with Happy server
  * Similar to ApiSessionClient but for machine-scoped connections
@@ -1576,6 +1617,8 @@ declare class ApiMachineClient {
     private keepAliveInterval;
     private lastKnownCLIAvailability;
     private lastKnownResumeSupport;
+    /** B-549: created on the first `history-search` call. */
+    private historySearch;
     /** Wall-clock of the last CLI availability probe. Initialised as "already
      *  stale" so the FIRST keep-alive tick always probes and populates the
      *  machine metadata that a connecting/reconnecting web client reads. */
@@ -1585,6 +1628,8 @@ declare class ApiMachineClient {
     private cliUpdateState;
     private cliUpdatePushChain;
     private claudeAuthState;
+    private rateLimitPushChain;
+    private readonly rateLimitPublisher;
     private rpcHandlerManager;
     private resumeSessionHandler;
     private restartSessionHandler;
@@ -1609,6 +1654,9 @@ declare class ApiMachineClient {
      * `set-terminal-title` RPC.
      */
     setTerminalTitle(terminalId: string, title: string, ifAbsent: boolean): boolean;
+    /** B-547: a status hook forwarded from a daemon-launched claude inside a
+     *  web terminal (control server /terminal-agent-hook → here). */
+    ingestTerminalAgentHook(body: unknown): void;
     /**
      * Push text to the clipboard of every web client the user has open
      * (terminal-path claude → `very-happy mcp` → daemon /clipboard → here).
@@ -1621,7 +1669,7 @@ declare class ApiMachineClient {
         error?: string;
     };
     /** Queue a terminal preview with the machine key. Delivery does not prove a browser opened it. */
-    pushFilePreview(terminalId: string, path: string, mode?: 'file' | 'diff'): {
+    pushFilePreview(terminalId: string, path: string, mode?: 'file' | 'diff', intent?: 'download'): {
         delivered: boolean;
         error?: string;
     };
@@ -1643,6 +1691,9 @@ declare class ApiMachineClient {
     /** Cache the latest relay policy locally and publish it now or on the next
      * socket connect. This makes startup/offline races harmless. */
     setCliUpdateState(state: CliUpdateState | null): void;
+    /** B-555: a wrapper's rate-limit observation; written throttled by the publisher. */
+    reportRateLimits(report: RateLimitReport): void;
+    private writeRateLimits;
     /**
      * B-276: publish the daemon-context Claude auth preflight into daemonState
      * (same serialized push chain as the CLI update policy). Resolves true when
@@ -1728,6 +1779,8 @@ declare class ApiMachineClient {
     private refreshRelayConnection;
     private startSmartReconnect;
     private stopKeepAlive;
+    /** B-550: final terminal scrollback checkpoint; resolves within ~300ms, never rejects. */
+    flushTerminalScrollback(): Promise<void>;
     shutdown(): void;
 }
 

package/dist/lib.d.mts

@@ -506,6 +506,10 @@ declare const DaemonStateSchema: z$1.ZodObject<{
         rpcAvailable: z$1.ZodBoolean;
         detectedAt: z$1.ZodNumber;
     }, z$1.core.$strip>>;
+    historySearch: z$1.ZodOptional<z$1.ZodObject<{
+        rpcAvailable: z$1.ZodBoolean;
+        detectedAt: z$1.ZodNumber;
+    }, z$1.core.$strip>>;
     terminalHost: z$1.ZodOptional<z$1.ZodObject<{
         tmuxAvailable: z$1.ZodBoolean;
         tmuxVersion: z$1.ZodOptional<z$1.ZodString>;
@@ -563,6 +567,21 @@ declare const DaemonStateSchema: z$1.ZodObject<{
         }, z$1.core.$strip>;
         checkedAt: z$1.ZodNumber;
     }, z$1.core.$strip>>;
+    rateLimits: z$1.ZodOptional<z$1.ZodObject<{
+        v: z$1.ZodLiteral<1>;
+        updatedAt: z$1.ZodNumber;
+        providers: z$1.ZodRecord<z$1.ZodString, z$1.ZodObject<{
+            observedAt: z$1.ZodNumber;
+            status: z$1.ZodOptional<z$1.ZodString>;
+            windows: z$1.ZodArray<z$1.ZodObject<{
+                kind: z$1.ZodString;
+                usedPercent: z$1.ZodNumber;
+                resetsAt: z$1.ZodNullable<z$1.ZodNumber>;
+                windowMinutes: z$1.ZodOptional<z$1.ZodNumber>;
+                observedAt: z$1.ZodNumber;
+            }, z$1.core.$strip>>;
+        }, z$1.core.$strip>>;
+    }, z$1.core.$strip>>;
 }, z$1.core.$strip>;
 type DaemonState = z$1.infer<typeof DaemonStateSchema>;
 type ClaudeAuthState = ClaudeAuthState$1;
@@ -787,6 +806,8 @@ type Metadata = {
         attention?: 'none' | 'review' | 'blocked';
         /** one-line Chinese progress note */
         progress?: string;
+        /** B-556: optional phase from report_progress (self-report only) */
+        phase?: string;
         analyzedAt: number;
     };
 };
@@ -1321,7 +1342,7 @@ declare class ApiSessionClient extends EventEmitter {
      * payload on this channel is (clipboard, fs RPC) — and a path leaks
      * project/client names and directory structure.
      */
-    pushFilePreview(path: string, mode?: 'file' | 'diff'): {
+    pushFilePreview(path: string, mode?: 'file' | 'diff', intent?: 'download'): {
         delivered: boolean;
         error?: string;
     };
@@ -1545,6 +1566,26 @@ interface CLIAvailability {
     detectedAt: number;
 }
 
+type RateLimitProvider = 'claude' | 'codex';
+type RateLimitWindow = {
+    /** five_hour | seven_day | seven_day_opus | seven_day_sonnet | seven_day_overage_included | window_<mins>m */
+    kind: string;
+    /** 0–100, may exceed 100 when usage legitimately runs past the cap. */
+    usedPercent: number;
+    /** ms epoch, null when unknown. */
+    resetsAt: number | null;
+    windowMinutes?: number;
+    /** ms epoch of the observation that produced this value. */
+    observedAt: number;
+};
+/** One provider's observation as sent wrapper → daemon. */
+type RateLimitReport = {
+    provider: RateLimitProvider;
+    observedAt: number;
+    status?: string;
+    windows: RateLimitWindow[];
+};
+
 /**
  * WebSocket client for machine/daemon communication with Happy server
  * Similar to ApiSessionClient but for machine-scoped connections
@@ -1576,6 +1617,8 @@ declare class ApiMachineClient {
     private keepAliveInterval;
     private lastKnownCLIAvailability;
     private lastKnownResumeSupport;
+    /** B-549: created on the first `history-search` call. */
+    private historySearch;
     /** Wall-clock of the last CLI availability probe. Initialised as "already
      *  stale" so the FIRST keep-alive tick always probes and populates the
      *  machine metadata that a connecting/reconnecting web client reads. */
@@ -1585,6 +1628,8 @@ declare class ApiMachineClient {
     private cliUpdateState;
     private cliUpdatePushChain;
     private claudeAuthState;
+    private rateLimitPushChain;
+    private readonly rateLimitPublisher;
     private rpcHandlerManager;
     private resumeSessionHandler;
     private restartSessionHandler;
@@ -1609,6 +1654,9 @@ declare class ApiMachineClient {
      * `set-terminal-title` RPC.
      */
     setTerminalTitle(terminalId: string, title: string, ifAbsent: boolean): boolean;
+    /** B-547: a status hook forwarded from a daemon-launched claude inside a
+     *  web terminal (control server /terminal-agent-hook → here). */
+    ingestTerminalAgentHook(body: unknown): void;
     /**
      * Push text to the clipboard of every web client the user has open
      * (terminal-path claude → `very-happy mcp` → daemon /clipboard → here).
@@ -1621,7 +1669,7 @@ declare class ApiMachineClient {
         error?: string;
     };
     /** Queue a terminal preview with the machine key. Delivery does not prove a browser opened it. */
-    pushFilePreview(terminalId: string, path: string, mode?: 'file' | 'diff'): {
+    pushFilePreview(terminalId: string, path: string, mode?: 'file' | 'diff', intent?: 'download'): {
         delivered: boolean;
         error?: string;
     };
@@ -1643,6 +1691,9 @@ declare class ApiMachineClient {
     /** Cache the latest relay policy locally and publish it now or on the next
      * socket connect. This makes startup/offline races harmless. */
     setCliUpdateState(state: CliUpdateState | null): void;
+    /** B-555: a wrapper's rate-limit observation; written throttled by the publisher. */
+    reportRateLimits(report: RateLimitReport): void;
+    private writeRateLimits;
     /**
      * B-276: publish the daemon-context Claude auth preflight into daemonState
      * (same serialized push chain as the CLI update policy). Resolves true when
@@ -1728,6 +1779,8 @@ declare class ApiMachineClient {
     private refreshRelayConnection;
     private startSmartReconnect;
     private stopKeepAlive;
+    /** B-550: final terminal scrollback checkpoint; resolves within ~300ms, never rejects. */
+    flushTerminalScrollback(): Promise<void>;
     shutdown(): void;
 }
 

package/dist/lib.mjs

@@ -1,9 +1,9 @@
-export { A as ApiClient, a as ApiSessionClient } from './api-DTVPUE7g.mjs';
-export { l as logger } from './logger-CknSVkIe.mjs';
-export { c as configuration } from './configuration-L1qcGTFM.mjs';
+export { A as ApiClient, a as ApiSessionClient } from './api-Cmz3XS4P.mjs';
+export { l as logger } from './logger-BpQcwNnt.mjs';
+export { c as configuration } from './configuration-D2v3puap.mjs';
 export { R as RawJSONLinesSchema } from './types-CkqAACXx.mjs';
 import 'axios';
-import './lidState-BLHLmhwd.mjs';
+import './lidState-BfximpjX.mjs';
 import './authRelay-DSAvg1uv.mjs';
 import 'node:crypto';
 import 'tweetnacl';
@@ -11,13 +11,13 @@ import 'os';
 import 'child_process';
 import 'node:events';
 import 'socket.io-client';
-import './attachmentLimits-B8nzhw-i.mjs';
+import './attachmentLimits-C1PCCM79.mjs';
 import 'zod';
-import './index-vVWpCoTr.mjs';
+import './index-B0HEEYGh.mjs';
 import '@paralleldrive/cuid2';
 import './limits-DIo7rEBR.mjs';
-import './time-v1Y_qEJp.mjs';
-import './registerCommonHandlers-BR0J4g64.mjs';
+import './time-CfDKj6Bx.mjs';
+import './registerCommonHandlers-DdfGsFbM.mjs';
 import 'util';
 import 'fs/promises';
 import 'crypto';
@@ -25,10 +25,10 @@ import 'path';
 import 'cross-spawn';
 import './projectPath-BTBIMB57.mjs';
 import 'url';
-import './sync-Dfm6K2te.mjs';
+import './sync-BLpH13Kb.mjs';
 import './backgroundTaskActivity-8PdPxrvy.mjs';
-import './controlClient-Ci7HTMII.mjs';
-import './persistence-DujtUH94.mjs';
+import './controlClient-BMUJfUeF.mjs';
+import './persistence-B9LmhAE2.mjs';
 import 'node:fs/promises';
 import 'node:fs';
 import './contentLogMetadata-BlWI0egu.mjs';
@@ -36,4 +36,4 @@ import 'chalk';
 import 'node:util';
 import 'node:path';
 import 'node:os';
-import './package-VIUXrYZ1.mjs';
+import './package-BqwrPxL0.mjs';

package/dist/{lidState-BLHLmhwd.mjs → lidState-BfximpjX.mjs}

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

package/dist/{lidState-z9ekRpZu.cjs → lidState-D8BmnJV1.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var logger = require('./logger-D0hkk7Vo.cjs');
+var logger = require('./logger-JTcJU-uL.cjs');
 var authRelay = require('./authRelay-BdYkC1Po.cjs');
 var os = require('os');
 var child_process = require('child_process');

package/dist/{localHappyAgentAuth-BWvmc_Hg.mjs → localHappyAgentAuth-Ct1aXwqd.mjs}

@@ -4,7 +4,7 @@ import { join } from 'node:path';
 import tweetnacl from 'tweetnacl';
 import { z } from 'zod';
 import { c as credentialRelayProblem, d as decodeBase64 } from './authRelay-DSAvg1uv.mjs';
-import { c as configuration } from './configuration-L1qcGTFM.mjs';
+import { c as configuration } from './configuration-D2v3puap.mjs';
 
 const AgentCredentialsSchema = z.object({
   token: z.string().min(1),

package/dist/{localHappyAgentAuth-BCx0y1qW.cjs → localHappyAgentAuth-d7B6S_o7.cjs}

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

package/dist/{logger-CknSVkIe.mjs → logger-BpQcwNnt.mjs}

@@ -1,6 +1,6 @@
 import chalk from 'chalk';
 import { inspect } from 'node:util';
-import { d as appendPrivateFileSync, c as configuration } from './configuration-L1qcGTFM.mjs';
+import { d as appendPrivateFileSync, c as configuration } from './configuration-D2v3puap.mjs';
 import { existsSync, readdirSync, statSync } from 'node:fs';
 import { join, basename } from 'node:path';
 
@@ -236,7 +236,7 @@ async function listDaemonLogFiles(limit = 50) {
       return { file, path: fullPath, modified: stats.mtime };
     }).sort((a, b) => b.modified.getTime() - a.modified.getTime());
     try {
-      const { readDaemonState } = await import('./persistence-DujtUH94.mjs');
+      const { readDaemonState } = await import('./persistence-B9LmhAE2.mjs');
       const state = await readDaemonState();
       if (!state) {
         return logs;