very-happy-cli 0.2.166 → 0.2.168

package/dist/lib.d.cts

@@ -367,6 +367,7 @@ type Session = {
 declare const MachineMetadataSchema: z$1.ZodObject<{
     teamsVersion: z$1.ZodOptional<z$1.ZodNumber>;
     teamLaunchVersion: z$1.ZodOptional<z$1.ZodNumber>;
+    worktreeVersion: z$1.ZodOptional<z$1.ZodNumber>;
     host: z$1.ZodString;
     platform: z$1.ZodString;
     happyCliVersion: z$1.ZodString;
@@ -582,6 +583,11 @@ declare const DaemonStateSchema: z$1.ZodObject<{
             }, z$1.core.$strip>>;
         }, z$1.core.$strip>>;
     }, z$1.core.$strip>>;
+    agentHibernation: z$1.ZodOptional<z$1.ZodObject<{
+        idleMs: z$1.ZodNumber;
+        rpcAvailable: z$1.ZodBoolean;
+        detectedAt: z$1.ZodNumber;
+    }, z$1.core.$loose>>;
 }, z$1.core.$strip>;
 type DaemonState = z$1.infer<typeof DaemonStateSchema>;
 type ClaudeAuthState = ClaudeAuthState$1;
@@ -714,6 +720,11 @@ type Metadata = {
     queueCancellation?: boolean;
     /** Explicit feature negotiation; old CLIs omit this field. */
     capabilities?: string[];
+    /** B-586: session started inside a linked git worktree (snapshot at start). Old clients ignore it. */
+    worktree?: {
+        branch: string | null;
+        root: string;
+    } | null;
     homeDir: string;
     happyHomeDir: string;
     happyLibDir: string;
@@ -725,6 +736,19 @@ type Metadata = {
     lifecycleStateSince?: number;
     archivedBy?: string;
     archiveReason?: string;
+    /**
+     * B-587: written by a wrapper that exited by idle hibernation (offline, not
+     * archived); cleared by the next wrapper on reconnect. `seq` = its message
+     * cursor — records above it are replayed on wake. Old clients ignore it.
+     */
+    hibernation?: {
+        at: number;
+        seq: number;
+        idleMs: number;
+        v: 1;
+    };
+    /** B-587: user opted this session out of idle hibernation (web ⋯ menu). */
+    keepAwake?: boolean;
     flavor?: string;
     sandbox?: SandboxConfig | null;
     dangerouslySkipPermissions?: boolean | null;
@@ -1286,6 +1310,28 @@ declare class ApiSessionClient extends EventEmitter {
     } | {
         type: 'ready';
     }, id?: string): void;
+    /** Last user/agent activity this wrapper saw (spec §2.1). */
+    private lastActivity;
+    private inboundFrozen;
+    private frozenInbound;
+    private heartbeatsMuted;
+    private lastHeartbeat;
+    get lastHeartbeatAt(): number;
+    muteHeartbeats(): void;
+    unmuteHeartbeats(): void;
+    private inboundRoutedDuringCommit;
+    noteActivity(now?: number): void;
+    get lastActivityAt(): number;
+    /** The message cursor (highest seq this wrapper has seen). */
+    get messageCursor(): number;
+    /** Start watching for inbound routed during the hibernation commit window. */
+    beginHibernationCommit(): void;
+    /** Was any inbound message routed since beginHibernationCommit()? */
+    inboundRoutedSinceCommit(): boolean;
+    /** Stop routing inbound messages; the next wrapper replays them (spec §3/§4). */
+    freezeInbound(): void;
+    /** An aborted hibernation: route whatever arrived while frozen, in order. */
+    unfreezeInbound(): void;
     /**
      * Send a ping message to keep the connection alive
      */
@@ -1379,6 +1425,13 @@ declare class ApiSessionClient extends EventEmitter {
         body: unknown;
     }>>;
     updateMetadata(handler: (metadata: Metadata) => Metadata): void;
+    /**
+     * B-587: the same write, awaitable with a ceiling — the hibernation stamp
+     * must land before `session-end`. Resolves false on timeout (the write
+     * itself keeps retrying in the background, exactly like updateMetadata).
+     */
+    updateMetadataAndWait(handler: (metadata: Metadata) => Metadata, timeoutMs?: number): Promise<boolean>;
+    private writeMetadata;
     /**
      * Update session agent state
      * @param handler - Handler function that returns the updated agent state
@@ -1628,6 +1681,8 @@ declare class ApiMachineClient {
     private cliUpdateState;
     private cliUpdatePushChain;
     private claudeAuthState;
+    /** B-587: the machine's hibernation threshold, published as a capability. */
+    private agentHibernationIdleMs;
     private rateLimitPushChain;
     private readonly rateLimitPublisher;
     private rpcHandlerManager;
@@ -1702,6 +1757,12 @@ declare class ApiMachineClient {
      * caller checks the echoed state and re-sends on the next probe).
      */
     setClaudeAuthState(state: ClaudeAuthState): Promise<boolean>;
+    /**
+     * B-587: `agent-hibernation-set {idleMs}` (0 = off) and the
+     * `daemonState.agentHibernation` capability. Call before connect().
+     */
+    setAgentHibernationHandlers(initialIdleMs: number, set: (idleMs: number) => Promise<number>): void;
+    private publishAgentHibernation;
     /** B-276 machine RPCs. Responses always carry `claudeAuth` so the web can refresh in place. */
     setClaudeAuthHandlers(handlers: {
         probe: () => Promise<ClaudeAuthState>;

package/dist/lib.d.mts

@@ -367,6 +367,7 @@ type Session = {
 declare const MachineMetadataSchema: z$1.ZodObject<{
     teamsVersion: z$1.ZodOptional<z$1.ZodNumber>;
     teamLaunchVersion: z$1.ZodOptional<z$1.ZodNumber>;
+    worktreeVersion: z$1.ZodOptional<z$1.ZodNumber>;
     host: z$1.ZodString;
     platform: z$1.ZodString;
     happyCliVersion: z$1.ZodString;
@@ -582,6 +583,11 @@ declare const DaemonStateSchema: z$1.ZodObject<{
             }, z$1.core.$strip>>;
         }, z$1.core.$strip>>;
     }, z$1.core.$strip>>;
+    agentHibernation: z$1.ZodOptional<z$1.ZodObject<{
+        idleMs: z$1.ZodNumber;
+        rpcAvailable: z$1.ZodBoolean;
+        detectedAt: z$1.ZodNumber;
+    }, z$1.core.$loose>>;
 }, z$1.core.$strip>;
 type DaemonState = z$1.infer<typeof DaemonStateSchema>;
 type ClaudeAuthState = ClaudeAuthState$1;
@@ -714,6 +720,11 @@ type Metadata = {
     queueCancellation?: boolean;
     /** Explicit feature negotiation; old CLIs omit this field. */
     capabilities?: string[];
+    /** B-586: session started inside a linked git worktree (snapshot at start). Old clients ignore it. */
+    worktree?: {
+        branch: string | null;
+        root: string;
+    } | null;
     homeDir: string;
     happyHomeDir: string;
     happyLibDir: string;
@@ -725,6 +736,19 @@ type Metadata = {
     lifecycleStateSince?: number;
     archivedBy?: string;
     archiveReason?: string;
+    /**
+     * B-587: written by a wrapper that exited by idle hibernation (offline, not
+     * archived); cleared by the next wrapper on reconnect. `seq` = its message
+     * cursor — records above it are replayed on wake. Old clients ignore it.
+     */
+    hibernation?: {
+        at: number;
+        seq: number;
+        idleMs: number;
+        v: 1;
+    };
+    /** B-587: user opted this session out of idle hibernation (web ⋯ menu). */
+    keepAwake?: boolean;
     flavor?: string;
     sandbox?: SandboxConfig | null;
     dangerouslySkipPermissions?: boolean | null;
@@ -1286,6 +1310,28 @@ declare class ApiSessionClient extends EventEmitter {
     } | {
         type: 'ready';
     }, id?: string): void;
+    /** Last user/agent activity this wrapper saw (spec §2.1). */
+    private lastActivity;
+    private inboundFrozen;
+    private frozenInbound;
+    private heartbeatsMuted;
+    private lastHeartbeat;
+    get lastHeartbeatAt(): number;
+    muteHeartbeats(): void;
+    unmuteHeartbeats(): void;
+    private inboundRoutedDuringCommit;
+    noteActivity(now?: number): void;
+    get lastActivityAt(): number;
+    /** The message cursor (highest seq this wrapper has seen). */
+    get messageCursor(): number;
+    /** Start watching for inbound routed during the hibernation commit window. */
+    beginHibernationCommit(): void;
+    /** Was any inbound message routed since beginHibernationCommit()? */
+    inboundRoutedSinceCommit(): boolean;
+    /** Stop routing inbound messages; the next wrapper replays them (spec §3/§4). */
+    freezeInbound(): void;
+    /** An aborted hibernation: route whatever arrived while frozen, in order. */
+    unfreezeInbound(): void;
     /**
      * Send a ping message to keep the connection alive
      */
@@ -1379,6 +1425,13 @@ declare class ApiSessionClient extends EventEmitter {
         body: unknown;
     }>>;
     updateMetadata(handler: (metadata: Metadata) => Metadata): void;
+    /**
+     * B-587: the same write, awaitable with a ceiling — the hibernation stamp
+     * must land before `session-end`. Resolves false on timeout (the write
+     * itself keeps retrying in the background, exactly like updateMetadata).
+     */
+    updateMetadataAndWait(handler: (metadata: Metadata) => Metadata, timeoutMs?: number): Promise<boolean>;
+    private writeMetadata;
     /**
      * Update session agent state
      * @param handler - Handler function that returns the updated agent state
@@ -1628,6 +1681,8 @@ declare class ApiMachineClient {
     private cliUpdateState;
     private cliUpdatePushChain;
     private claudeAuthState;
+    /** B-587: the machine's hibernation threshold, published as a capability. */
+    private agentHibernationIdleMs;
     private rateLimitPushChain;
     private readonly rateLimitPublisher;
     private rpcHandlerManager;
@@ -1702,6 +1757,12 @@ declare class ApiMachineClient {
      * caller checks the echoed state and re-sends on the next probe).
      */
     setClaudeAuthState(state: ClaudeAuthState): Promise<boolean>;
+    /**
+     * B-587: `agent-hibernation-set {idleMs}` (0 = off) and the
+     * `daemonState.agentHibernation` capability. Call before connect().
+     */
+    setAgentHibernationHandlers(initialIdleMs: number, set: (idleMs: number) => Promise<number>): void;
+    private publishAgentHibernation;
     /** B-276 machine RPCs. Responses always carry `claudeAuth` so the web can refresh in place. */
     setClaudeAuthHandlers(handlers: {
         probe: () => Promise<ClaudeAuthState>;

package/dist/lib.mjs

@@ -1,9 +1,9 @@
-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 { A as ApiClient, a as ApiSessionClient } from './api-hXLwtgMi.mjs';
+export { l as logger } from './logger-C6zzu57a.mjs';
+export { c as configuration } from './configuration-BZo1JWNV.mjs';
 export { R as RawJSONLinesSchema } from './types-CkqAACXx.mjs';
 import 'axios';
-import './lidState-BfximpjX.mjs';
+import './lidState-CJ3XkJRn.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-C1PCCM79.mjs';
+import './attachmentLimits-CxG3T18E.mjs';
 import 'zod';
 import './index-B0HEEYGh.mjs';
 import '@paralleldrive/cuid2';
 import './limits-DIo7rEBR.mjs';
-import './time-CfDKj6Bx.mjs';
-import './registerCommonHandlers-DdfGsFbM.mjs';
+import './time-CN0jVVir.mjs';
+import './registerCommonHandlers-BLHKlk5Z.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-BLpH13Kb.mjs';
+import './sync-CHOB3Org.mjs';
 import './backgroundTaskActivity-8PdPxrvy.mjs';
-import './controlClient-BMUJfUeF.mjs';
-import './persistence-B9LmhAE2.mjs';
+import './controlClient-CXD-Xdny.mjs';
+import './persistence-B6M_W5iC.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-BqwrPxL0.mjs';
+import './package-5xAdq5fu.mjs';

package/dist/{lidState-D8BmnJV1.cjs → lidState-2IT0tas7.cjs}

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

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

@@ -1,4 +1,4 @@
-import { l as logger } from './logger-BpQcwNnt.mjs';
+import { l as logger } from './logger-C6zzu57a.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/{localHappyAgentAuth-d7B6S_o7.cjs → localHappyAgentAuth-CPMh61Su.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-B0cb3xA3.cjs');
+var configuration = require('./configuration-DeuGrnej.cjs');
 
 const AgentCredentialsSchema = z.z.object({
   token: z.z.string().min(1),

package/dist/{localHappyAgentAuth-Ct1aXwqd.mjs → localHappyAgentAuth-DkLbntlf.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-D2v3puap.mjs';
+import { c as configuration } from './configuration-BZo1JWNV.mjs';
 
 const AgentCredentialsSchema = z.object({
   token: z.string().min(1),

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

@@ -1,6 +1,6 @@
 import chalk from 'chalk';
 import { inspect } from 'node:util';
-import { d as appendPrivateFileSync, c as configuration } from './configuration-D2v3puap.mjs';
+import { d as appendPrivateFileSync, c as configuration } from './configuration-BZo1JWNV.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-B9LmhAE2.mjs');
+      const { readDaemonState } = await import('./persistence-B6M_W5iC.mjs').then(function (n) { return n.E; });
       const state = await readDaemonState();
       if (!state) {
         return logs;

package/dist/{logger-JTcJU-uL.cjs → logger-Ockf1cjN.cjs}

@@ -2,7 +2,7 @@
 
 var chalk = require('chalk');
 var node_util = require('node:util');
-var configuration = require('./configuration-B0cb3xA3.cjs');
+var configuration = require('./configuration-DeuGrnej.cjs');
 var node_fs = require('node:fs');
 var path = require('node:path');
 
@@ -238,7 +238,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 Promise.resolve().then(function () { return require('./persistence-2Xp_o6x6.cjs'); });
+      const { readDaemonState } = await Promise.resolve().then(function () { return require('./persistence-B5oT6oQ9.cjs'); }).then(function (n) { return n.persistence; });
       const state = await readDaemonState();
       if (!state) {
         return logs;

package/dist/{machineMetadata-BBg_Njw3.cjs → machineMetadata-CoMYwSlG.cjs}

@@ -1,17 +1,18 @@
 'use strict';
 
 var os = require('node:os');
-var _package = require('./package-C1XvUQFy.cjs');
-var configuration = require('./configuration-B0cb3xA3.cjs');
+var _package = require('./package-DfoyJe1O.cjs');
+var configuration = require('./configuration-DeuGrnej.cjs');
 var projectPath = require('./projectPath-ChLhdOyt.cjs');
 var detectCLI = require('./detectCLI-DR9ZaN6B.cjs');
-var localHappyAgentAuth = require('./localHappyAgentAuth-d7B6S_o7.cjs');
+var localHappyAgentAuth = require('./localHappyAgentAuth-CPMh61Su.cjs');
 
 function buildInitialMachineMetadata(cliAvailability) {
   const hostSuffix = process.env.HAPPY_VARIANT === "dev" ? "-dev" : "";
   return {
     teamsVersion: 1,
     teamLaunchVersion: 1,
+    worktreeVersion: 1,
     host: os.hostname() + hostSuffix,
     platform: os.platform(),
     happyCliVersion: _package.packageJson.version,

package/dist/{machineMetadata-CBdxABeI.mjs → machineMetadata-DmTGIZAV.mjs}

@@ -1,15 +1,16 @@
 import os from 'node:os';
-import { p as packageJson } from './package-BqwrPxL0.mjs';
-import { c as configuration } from './configuration-D2v3puap.mjs';
+import { p as packageJson } from './package-5xAdq5fu.mjs';
+import { c as configuration } from './configuration-BZo1JWNV.mjs';
 import { p as projectPath } from './projectPath-BTBIMB57.mjs';
 import { d as detectCLIAvailability } from './detectCLI-CSGMlV51.mjs';
-import { d as detectResumeSupport } from './localHappyAgentAuth-Ct1aXwqd.mjs';
+import { d as detectResumeSupport } from './localHappyAgentAuth-DkLbntlf.mjs';
 
 function buildInitialMachineMetadata(cliAvailability) {
   const hostSuffix = process.env.HAPPY_VARIANT === "dev" ? "-dev" : "";
   return {
     teamsVersion: 1,
     teamLaunchVersion: 1,
+    worktreeVersion: 1,
     host: os.hostname() + hostSuffix,
     platform: os.platform(),
     happyCliVersion: packageJson.version,