very-happy-cli 0.2.165 → 0.2.166

package/dist/{attachmentContent-dzIs-wis.mjs → attachmentContent-CTXapi-_.mjs}

@@ -1,8 +1,8 @@
 import { randomUUID } from 'node:crypto';
 import { writeFile, rename, unlink } from 'node:fs/promises';
 import { join, basename } from 'node:path';
-import { M as MAX_CHAT_ATTACHMENT_SOURCE_BYTES } from './attachmentLimits-B8nzhw-i.mjs';
-import { e as ensurePrivateDirectory, b as hardenPrivateFile } from './configuration-L1qcGTFM.mjs';
+import { M as MAX_CHAT_ATTACHMENT_SOURCE_BYTES } from './attachmentLimits-C1PCCM79.mjs';
+import { e as ensurePrivateDirectory, b as hardenPrivateFile } from './configuration-D2v3puap.mjs';
 
 const CLAUDE_ATTACHMENT_KINDS = [
   "image/jpeg",

package/dist/{attachmentContent-muDCe4Gy.cjs → attachmentContent-DPWxHgX4.cjs}

@@ -3,8 +3,8 @@
 var node_crypto = require('node:crypto');
 var promises = require('node:fs/promises');
 var path = require('node:path');
-var attachmentLimits = require('./attachmentLimits-eJZ4ZBjF.cjs');
-var configuration = require('./configuration-BE61XNsg.cjs');
+var attachmentLimits = require('./attachmentLimits-BfgKV5iE.cjs');
+var configuration = require('./configuration-B0cb3xA3.cjs');
 
 const CLAUDE_ATTACHMENT_KINDS = [
   "image/jpeg",

package/dist/{attachmentLimits-eJZ4ZBjF.cjs → attachmentLimits-BfgKV5iE.cjs}

@@ -1,7 +1,7 @@
 'use strict';
 
 var z = require('zod');
-var index = require('./index-DqlyNgt4.cjs');
+var index = require('./index-C9hI8a10.cjs');
 
 z.z.object({
   teamsVersion: z.z.number().int().positive().optional(),
@@ -115,6 +115,21 @@ const ClosedTerminalRecordSchema = z.z.object({
   attachTmux: z.z.string().optional(),
   closedAt: z.z.number()
 });
+const RateLimitsStateSchema = z.z.object({
+  v: z.z.literal(1),
+  updatedAt: z.z.number(),
+  providers: z.z.record(z.z.string(), z.z.object({
+    observedAt: z.z.number(),
+    status: z.z.string().optional(),
+    windows: z.z.array(z.z.object({
+      kind: z.z.string(),
+      usedPercent: z.z.number(),
+      resetsAt: z.z.number().nullable(),
+      windowMinutes: z.z.number().optional(),
+      observedAt: z.z.number()
+    }))
+  }))
+});
 z.z.object({
   agentVersions: index.AgentVersionsSchema.optional(),
   agentVersionEpoch: z.z.number().optional(),
@@ -198,6 +213,15 @@ z.z.object({
     rpcAvailable: z.z.boolean(),
     detectedAt: z.z.number()
   }).optional(),
+  /**
+   * B-549 capability flag: this daemon answers `history-search` (full-text
+   * search over the machine's Claude Code / Codex history, indexed locally).
+   * Same trust rule (`detectedAt >= startedAt`); old webs ignore it.
+   */
+  historySearch: z.z.object({
+    rpcAvailable: z.z.boolean(),
+    detectedAt: z.z.number()
+  }).optional(),
   /**
    * B-486: can web terminals on this machine be durable? `tmuxAvailable:
    * false` ⇒ every new terminal is a direct shell that dies with the daemon,
@@ -218,7 +242,9 @@ z.z.object({
    * restarts (the server returns the existing row and connect spreads it
    * forward), so a downgraded daemon carries this field along unchanged.
    */
-  claudeAuth: ClaudeAuthStateSchema.optional()
+  claudeAuth: ClaudeAuthStateSchema.optional(),
+  /** B-555: see RateLimitsStateSchema. Old webs ignore it; old daemons carry it forward unchanged. */
+  rateLimits: RateLimitsStateSchema.optional()
 });
 const MessageMetaSchema = z.z.object({
   sentFrom: z.z.string().optional(),

package/dist/{attachmentLimits-B8nzhw-i.mjs → attachmentLimits-C1PCCM79.mjs}

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { k as AgentVersionsSchema } from './index-vVWpCoTr.mjs';
+import { m as AgentVersionsSchema } from './index-B0HEEYGh.mjs';
 
 z.object({
   teamsVersion: z.number().int().positive().optional(),
@@ -113,6 +113,21 @@ const ClosedTerminalRecordSchema = z.object({
   attachTmux: z.string().optional(),
   closedAt: z.number()
 });
+const RateLimitsStateSchema = z.object({
+  v: z.literal(1),
+  updatedAt: z.number(),
+  providers: z.record(z.string(), z.object({
+    observedAt: z.number(),
+    status: z.string().optional(),
+    windows: z.array(z.object({
+      kind: z.string(),
+      usedPercent: z.number(),
+      resetsAt: z.number().nullable(),
+      windowMinutes: z.number().optional(),
+      observedAt: z.number()
+    }))
+  }))
+});
 z.object({
   agentVersions: AgentVersionsSchema.optional(),
   agentVersionEpoch: z.number().optional(),
@@ -196,6 +211,15 @@ z.object({
     rpcAvailable: z.boolean(),
     detectedAt: z.number()
   }).optional(),
+  /**
+   * B-549 capability flag: this daemon answers `history-search` (full-text
+   * search over the machine's Claude Code / Codex history, indexed locally).
+   * Same trust rule (`detectedAt >= startedAt`); old webs ignore it.
+   */
+  historySearch: z.object({
+    rpcAvailable: z.boolean(),
+    detectedAt: z.number()
+  }).optional(),
   /**
    * B-486: can web terminals on this machine be durable? `tmuxAvailable:
    * false` ⇒ every new terminal is a direct shell that dies with the daemon,
@@ -216,7 +240,9 @@ z.object({
    * restarts (the server returns the existing row and connect spreads it
    * forward), so a downgraded daemon carries this field along unchanged.
    */
-  claudeAuth: ClaudeAuthStateSchema.optional()
+  claudeAuth: ClaudeAuthStateSchema.optional(),
+  /** B-555: see RateLimitsStateSchema. Old webs ignore it; old daemons carry it forward unchanged. */
+  rateLimits: RateLimitsStateSchema.optional()
 });
 const MessageMetaSchema = z.object({
   sentFrom: z.string().optional(),

package/dist/{auth-Jtmvh1w4.mjs → auth-BMaBjRAj.mjs}

@@ -1,23 +1,23 @@
 import chalk from 'chalk';
-import { readCredentials, readSettings, clearCredentials, clearMachineId } from './persistence-DujtUH94.mjs';
-import { a as authAndSetupMachineIfNeeded } from './auth-BY5ujhGn.mjs';
-import { c as configuration } from './configuration-L1qcGTFM.mjs';
+import { readCredentials, readSettings, clearCredentials, clearMachineId } from './persistence-B9LmhAE2.mjs';
+import { a as authAndSetupMachineIfNeeded } from './auth-pzWIFdOD.mjs';
+import { c as configuration } from './configuration-D2v3puap.mjs';
 import { existsSync, rmSync } from 'node:fs';
 import { createInterface } from 'node:readline';
-import { c as checkIfDaemonRunningAndCleanupStaleState, a as stopDaemon } from './controlClient-Ci7HTMII.mjs';
-import { l as logger } from './logger-CknSVkIe.mjs';
+import { c as checkIfDaemonRunningAndCleanupStaleState, a as stopDaemon } from './controlClient-BMUJfUeF.mjs';
+import { l as logger } from './logger-BpQcwNnt.mjs';
 import os from 'node:os';
 import { c as credentialRelayProblem } from './authRelay-DSAvg1uv.mjs';
 import 'node:fs/promises';
 import 'zod';
 import 'node:path';
-import './package-VIUXrYZ1.mjs';
+import './package-BqwrPxL0.mjs';
 import 'node:crypto';
 import 'tweetnacl';
 import 'node:util';
 import 'axios';
-import './time-v1Y_qEJp.mjs';
-import './browser-mwzpOmcw.mjs';
+import './time-CfDKj6Bx.mjs';
+import './browser-DDFi1T8C.mjs';
 import 'open';
 
 function localMachineIdentityStatus(machineId) {

package/dist/{auth-DtP-B4gf.cjs → auth-D4-eQz85.cjs}

@@ -1,25 +1,25 @@
 'use strict';
 
 var chalk = require('chalk');
-var persistence = require('./persistence-C6ztVW1W.cjs');
-var auth = require('./auth-CfLd3phE.cjs');
-var configuration = require('./configuration-BE61XNsg.cjs');
+var persistence = require('./persistence-2Xp_o6x6.cjs');
+var auth = require('./auth-ietHtvwu.cjs');
+var configuration = require('./configuration-B0cb3xA3.cjs');
 var node_fs = require('node:fs');
 var node_readline = require('node:readline');
-var controlClient = require('./controlClient-RWTlQA4_.cjs');
-var logger = require('./logger-D0hkk7Vo.cjs');
+var controlClient = require('./controlClient-CmnHGcyl.cjs');
+var logger = require('./logger-JTcJU-uL.cjs');
 var os = require('node:os');
 var authRelay = require('./authRelay-BdYkC1Po.cjs');
 require('node:fs/promises');
 require('zod');
 require('node:path');
-require('./package-UkmvSFsg.cjs');
+require('./package-C1XvUQFy.cjs');
 require('node:crypto');
 require('tweetnacl');
 require('node:util');
 require('axios');
-require('./time-BbzJ7PJQ.cjs');
-require('./browser-_gV7tcPs.cjs');
+require('./time-T0YmeOhS.cjs');
+require('./browser-CcG8GLRV.cjs');
 require('open');
 
 function localMachineIdentityStatus(machineId) {

package/dist/{auth-CfLd3phE.cjs → auth-ietHtvwu.cjs}

@@ -1,14 +1,14 @@
 'use strict';
 
 var authRelay = require('./authRelay-BdYkC1Po.cjs');
-var configuration = require('./configuration-BE61XNsg.cjs');
+var configuration = require('./configuration-B0cb3xA3.cjs');
 var node_crypto = require('node:crypto');
 var tweetnacl = require('tweetnacl');
 var axios = require('axios');
-var time = require('./time-BbzJ7PJQ.cjs');
-var persistence = require('./persistence-C6ztVW1W.cjs');
-var browser = require('./browser-_gV7tcPs.cjs');
-var logger = require('./logger-D0hkk7Vo.cjs');
+var time = require('./time-T0YmeOhS.cjs');
+var persistence = require('./persistence-2Xp_o6x6.cjs');
+var browser = require('./browser-CcG8GLRV.cjs');
+var logger = require('./logger-JTcJU-uL.cjs');
 
 function generateWebAuthUrl(publicKey) {
   const publicKeyBase64 = authRelay.encodeBase64(publicKey, "base64url");

package/dist/{auth-BY5ujhGn.mjs → auth-pzWIFdOD.mjs}

@@ -1,12 +1,12 @@
 import { e as encodeBase64, c as credentialRelayProblem, f as encodeBase64Url, d as decodeBase64 } from './authRelay-DSAvg1uv.mjs';
-import { c as configuration } from './configuration-L1qcGTFM.mjs';
+import { c as configuration } from './configuration-D2v3puap.mjs';
 import { randomUUID, randomBytes } from 'node:crypto';
 import tweetnacl from 'tweetnacl';
 import axios from 'axios';
-import { d as delay } from './time-v1Y_qEJp.mjs';
-import { readCredentials, readSettingsOutcome, updateSettings, writeCredentialsLegacy, writeCredentialsDataKey } from './persistence-DujtUH94.mjs';
-import { o as openBrowser } from './browser-mwzpOmcw.mjs';
-import { l as logger } from './logger-CknSVkIe.mjs';
+import { d as delay } from './time-CfDKj6Bx.mjs';
+import { readCredentials, readSettingsOutcome, updateSettings, writeCredentialsLegacy, writeCredentialsDataKey } from './persistence-B9LmhAE2.mjs';
+import { o as openBrowser } from './browser-DDFi1T8C.mjs';
+import { l as logger } from './logger-BpQcwNnt.mjs';
 
 function generateWebAuthUrl(publicKey) {
   const publicKeyBase64 = encodeBase64(publicKey, "base64url");

package/dist/{auto-DjWfR1UB.mjs → auto-DL75Dx3I.mjs}

@@ -2,49 +2,51 @@ import chalk from 'chalk';
 import { homedir } from 'node:os';
 import { readFileSync } from 'node:fs';
 import { resolve } from 'node:path';
-import { A as AUTOMATION_NAME_PATTERN, i as isAutomationRunTerminal } from './index-vVWpCoTr.mjs';
-import { c as configuration } from './configuration-L1qcGTFM.mjs';
-import { a as authenticatedAutomationsClient, b as automationRunIdFromEnv, i as isAutomationsUnavailable, A as AUTOMATIONS_UNAVAILABLE_MESSAGE } from './client-CJZKBZCE.mjs';
+import { A as AUTOMATION_NAME_PATTERN, i as isAutomationRunTerminal, a as AUTOMATION_PRECHECK_MAX_TIMEOUT_MS, b as AutomationPrecheckSchema } from './index-B0HEEYGh.mjs';
+import { c as configuration } from './configuration-D2v3puap.mjs';
+import { a as authenticatedAutomationsClient, b as automationRunIdFromEnv, i as isAutomationsUnavailable, A as AUTOMATIONS_UNAVAILABLE_MESSAGE } from './client-GjTnsq6F.mjs';
 import { p as parseDuration, t as triggerFromFlags, d as describeTrigger, a as describeAction } from './template-CiOPa2rd.mjs';
-import { A as AUTOMATION_SKILL, i as installAutomationSkill } from './install-BO_W7VhL.mjs';
-import { s as sessionWebUrl } from './sessionOps-DG5MMEp_.mjs';
-import { parseEnvAssignment } from './spawn-BTOG4tTm.mjs';
-import { S as SPAWN_AGENTS, s as sanitizeSpawnPermissionMode, A as ALLOWED_SPAWN_PERMISSION_MODES } from './spawnAgents-Czi2VDzj.mjs';
-import { d as delay } from './time-v1Y_qEJp.mjs';
+import { A as AUTOMATION_SKILL, i as installAutomationSkill } from './install-BdvKiOQw.mjs';
+import { u as updateAutomationChecked, c as createAutomationChecked } from './precheckCompat-DeEbilbr.mjs';
+import { s as sessionWebUrl } from './sessionOps-BnaEaOKs.mjs';
+import { parseEnvAssignment } from './spawn-EZ2yrtWd.mjs';
+import { S as SPAWN_AGENTS, s as sanitizeSpawnPermissionMode, A as ALLOWED_SPAWN_PERMISSION_MODES } from './spawnAgents-HDaE3C0-.mjs';
+import { d as delay } from './time-CfDKj6Bx.mjs';
 import 'zod';
 import '@paralleldrive/cuid2';
-import './package-VIUXrYZ1.mjs';
+import './package-BqwrPxL0.mjs';
 import 'node:fs/promises';
-import './persistence-DujtUH94.mjs';
+import './persistence-B9LmhAE2.mjs';
 import './authRelay-DSAvg1uv.mjs';
 import 'node:crypto';
 import 'tweetnacl';
-import './logger-CknSVkIe.mjs';
+import './logger-BpQcwNnt.mjs';
 import 'node:util';
 import './resources-BdFBQi8r.mjs';
 import 'axios';
-import './controlClient-Ci7HTMII.mjs';
+import './controlClient-BMUJfUeF.mjs';
 import 'socket.io-client';
 import './backgroundTaskActivity-8PdPxrvy.mjs';
 import './path-D2wdaNSk.mjs';
-import './claudeSessionFork-CokUhS4r.mjs';
+import './claudeSessionFork-BdLnc2Hv.mjs';
 import 'node:readline';
-import './codexAppServerClient-B0QaMQsC.mjs';
+import './codexAppServerClient-CldXEojt.mjs';
 import 'node:child_process';
 import 'cross-spawn';
 import './contentLogMetadata-BlWI0egu.mjs';
 import './manager-BQ4flvQZ.mjs';
 import '@anthropic-ai/sandbox-runtime';
+import './rateLimitWindows-Dhfhbtqu.mjs';
 import './codexThreadFork-R76RU5H0.mjs';
-import './createSessionMetadata-CWR-AB2A.mjs';
+import './createSessionMetadata-DU0bCg2m.mjs';
 import './projectPath-BTBIMB57.mjs';
 import 'path';
 import 'url';
 import './forkBackfill-DYIjlN1Z.mjs';
 
 const AUTO_ACTIONS = ["list", "show", "create", "edit", "pause", "resume", "rm", "run", "fire", "runs", "cancel", "ack", "report", "skill", "install", "uninstall", "help"];
-const VALUE_FLAGS = ["--name", "--rename", "--description", "--machine", "--cron", "--tz", "--every", "--at", "--spawn-dir", "--prompt", "--prompt-file", "--agent", "--model", "--permission-mode", "--sticky-key", "--send-session", "--cwd", "--env", "--timeout", "--concurrency", "--max-runtime", "--payload", "--payload-json", "--payload-file", "--dedupe-key", "--status", "--limit", "--run", "--summary", "--error", "--attention", "--host", "--home"];
-const BOOL_FLAGS = ["--manual", "--script", "--worktree", "--paused", "--wait", "--json", "--apply", "--all-machines", "--all", "--attention", "--help", "-h"];
+const VALUE_FLAGS = ["--name", "--rename", "--description", "--machine", "--cron", "--tz", "--every", "--at", "--spawn-dir", "--prompt", "--prompt-file", "--agent", "--model", "--permission-mode", "--sticky-key", "--send-session", "--cwd", "--env", "--timeout", "--concurrency", "--max-runtime", "--payload", "--payload-json", "--payload-file", "--dedupe-key", "--status", "--limit", "--run", "--summary", "--error", "--attention", "--host", "--home", "--precheck-shell", "--precheck-argv", "--precheck-cwd", "--precheck-timeout"];
+const BOOL_FLAGS = ["--manual", "--script", "--worktree", "--paused", "--wait", "--json", "--apply", "--all-machines", "--all", "--attention", "--precheck-output", "--no-precheck", "--help", "-h"];
 function parseAutoArgs(args) {
   const command = { action: "help", flags: {}, env: [], bools: /* @__PURE__ */ new Set(), argv: [] };
   if (args.length === 0) return command;
@@ -139,6 +141,52 @@ function actionFromCommand(command, current) {
   }
   return { kind: "spawn", agent: flags["--agent"] ?? "claude", directory: resolve(flags["--spawn-dir"]), prompt, ...spawnDetails(command) };
 }
+function precheckFromCommand(command, current) {
+  const { flags, bools } = command;
+  const shell = flags["--precheck-shell"];
+  const argvJson = flags["--precheck-argv"];
+  const modifiers = ["--precheck-cwd", "--precheck-timeout"].filter((flag) => flags[flag] !== void 0).concat(bools.has("--precheck-output") ? ["--precheck-output"] : []);
+  if (bools.has("--no-precheck")) {
+    if (shell !== void 0 || argvJson !== void 0 || modifiers.length) throw new Error("--no-precheck cannot be combined with other --precheck-* options");
+    return null;
+  }
+  if (shell === void 0 && argvJson === void 0 && modifiers.length === 0) return void 0;
+  if (shell !== void 0 && argvJson !== void 0) throw new Error("Use only one of --precheck-shell and --precheck-argv");
+  let base;
+  if (shell !== void 0) base = { shell };
+  else if (argvJson !== void 0) {
+    let argv;
+    try {
+      argv = JSON.parse(argvJson);
+    } catch {
+      throw new Error(`--precheck-argv must be a JSON array of strings, e.g. '["./has-new.sh","--since","5m"]'`);
+    }
+    if (!Array.isArray(argv) || argv.length === 0 || !argv.every((part) => typeof part === "string" && part.length > 0)) throw new Error("--precheck-argv must be a non-empty JSON array of non-empty strings");
+    base = { command: argv };
+  } else {
+    if (!current) throw new Error(`${modifiers.join(", ")} need a precheck: give --precheck-shell <line> or --precheck-argv <json>`);
+    base = current;
+  }
+  let timeoutMs;
+  if (flags["--precheck-timeout"] !== void 0) {
+    timeoutMs = parseDuration(flags["--precheck-timeout"]);
+    if (timeoutMs < 1e3 || timeoutMs > AUTOMATION_PRECHECK_MAX_TIMEOUT_MS) throw new Error(`--precheck-timeout must be between 1s and ${AUTOMATION_PRECHECK_MAX_TIMEOUT_MS / 6e4}m`);
+  }
+  const precheck = {
+    ...base,
+    ...flags["--precheck-cwd"] !== void 0 ? { cwd: flags["--precheck-cwd"] } : {},
+    ...timeoutMs !== void 0 ? { timeoutMs } : {},
+    ...bools.has("--precheck-output") ? { includeOutput: true } : {}
+  };
+  const parsed = AutomationPrecheckSchema.safeParse(precheck);
+  if (!parsed.success) throw new Error(`Invalid precheck: ${parsed.error.issues[0]?.message ?? "check the --precheck-* options"}`);
+  return parsed.data;
+}
+function describePrecheck(precheck) {
+  const what = precheck.shell !== void 0 ? `sh: ${precheck.shell}` : `argv: ${JSON.stringify(precheck.command)}`;
+  const extras = [precheck.cwd ? `cwd ${precheck.cwd}` : null, precheck.timeoutMs ? `timeout ${Math.round(precheck.timeoutMs / 1e3)}s` : null, precheck.includeOutput ? "output \u2192 prompt" : null].filter(Boolean);
+  return extras.length ? `${what}  (${extras.join(", ")})` : what;
+}
 function spawnDetails(command) {
   const { flags, bools } = command;
   if (flags["--agent"] !== void 0 && !SPAWN_AGENTS.includes(flags["--agent"])) throw new Error(`--agent must be one of: ${SPAWN_AGENTS.join(", ")}`);
@@ -180,6 +228,14 @@ ${chalk.bold("Action (one):")}
   --send-session <id> --prompt <text>|--prompt-file <file>
   --script -- <argv\u2026> [--cwd <dir>] [--env K=V]... [--timeout <dur>]
 
+${chalk.bold("Precheck (optional, runs before the action; exit 0 runs it, anything else records a skip):")}
+  --precheck-shell '<command line>' | --precheck-argv '<json array>'
+      [--precheck-cwd <dir>] [--precheck-timeout <dur>] (default 60s, max 10m)
+      [--precheck-output]   append the precheck's stdout to the spawn/send prompt
+  --no-precheck           edit: remove the precheck
+  A shell line is not template-rendered; read the payload from $VH_AUTOMATION_PAYLOAD.
+  Consecutive scheduled skips for the same reason fold into one run shown as \xD7N.
+
 ${chalk.bold("Options:")}
   --machine <id>|this     Executing machine (default: this machine)
   --description <text>
@@ -204,12 +260,14 @@ function printAutomation(a) {
   if (a.description) console.log(`  ${a.description}`);
   console.log(`  trigger:   ${describeTrigger(a.trigger)}   next: ${fmtTime(a.nextRunAt)}`);
   console.log(`  action:    ${describeAction(a.action)}`);
+  if (a.precheck) console.log(`  precheck:  ${describePrecheck(a.precheck)}`);
   console.log(`  machine:   ${a.machineId}   concurrency: ${a.concurrency}   max runtime: ${Math.round(a.maxRuntimeMs / 6e4)}m`);
   console.log(`  last run:  ${fmtTime(a.lastRunAt)} ${a.lastRunStatus ?? ""}`);
 }
 function runLine(run) {
   const status = run.status === "done" ? chalk.green(run.status) : ["failed", "expired"].includes(run.status) ? chalk.red(run.status) : run.status === "running" ? chalk.cyan(run.status) : run.status;
-  return `${fmtTime(run.createdAt)}  ${status.padEnd(9)}  ${run.automationName.padEnd(20)}  ${run.source.padEnd(8)}  ${run.id}${run.needsAttention ? chalk.yellow(`  ! ${run.attentionReason ?? "attention"}`) : ""}`;
+  const folded = (run.occurrenceCount ?? 1) > 1 ? ` \xD7${run.occurrenceCount}` : "";
+  return `${fmtTime(run.createdAt)}  ${status.padEnd(9)}  ${run.automationName.padEnd(20)}  ${run.source.padEnd(8)}  ${run.id}${folded}${run.status === "skipped" && run.error ? chalk.dim(`  ${run.error}`) : ""}${run.needsAttention ? chalk.yellow(`  ! ${run.attentionReason ?? "attention"}`) : ""}`;
 }
 function printRun(run) {
   console.log(runLine(run));
@@ -311,7 +369,9 @@ async function handleAutoCommand(args) {
           ...command.flags["--max-runtime"] !== void 0 ? { maxRuntimeMs: parseDuration(command.flags["--max-runtime"]) } : {},
           ...command.bools.has("--paused") ? { status: "paused" } : {}
         };
-        const automation = await client.create(input);
+        const precheck = precheckFromCommand(command);
+        if (precheck) input.precheck = precheck;
+        const automation = await createAutomationChecked(client, input);
         if (json) {
           console.log(JSON.stringify({ automation }));
           return;
@@ -334,8 +394,10 @@ async function handleAutoCommand(args) {
           ...command.flags["--concurrency"] !== void 0 ? { concurrency: concurrency(command.flags["--concurrency"]) } : {},
           ...command.flags["--max-runtime"] !== void 0 ? { maxRuntimeMs: parseDuration(command.flags["--max-runtime"]) } : {}
         };
+        const precheck = precheckFromCommand(command, current.precheck);
+        if (precheck !== void 0) input.precheck = precheck;
         if (Object.keys(input).length === 1) throw new Error("Nothing to change");
-        const automation = await client.update(current.id, input);
+        const automation = await updateAutomationChecked(client, current.id, input);
         if (json) {
           console.log(JSON.stringify({ automation }));
           return;
@@ -465,4 +527,4 @@ function concurrency(value) {
   return value;
 }
 
-export { AUTO_ACTIONS, AUTO_HELP, actionFromCommand, handleAutoCommand, parseAutoArgs };
+export { AUTO_ACTIONS, AUTO_HELP, actionFromCommand, describePrecheck, handleAutoCommand, parseAutoArgs, precheckFromCommand };

package/dist/{auto-ClNnbSoF.cjs → auto-DOWTQDPa.cjs}

@@ -4,49 +4,51 @@ var chalk = require('chalk');
 var os = require('node:os');
 var node_fs = require('node:fs');
 var path = require('node:path');
-var index = require('./index-DqlyNgt4.cjs');
-var configuration = require('./configuration-BE61XNsg.cjs');
-var client = require('./client-uN9d6Git.cjs');
+var index = require('./index-C9hI8a10.cjs');
+var configuration = require('./configuration-B0cb3xA3.cjs');
+var client = require('./client-DJ0kX_8M.cjs');
 var template = require('./template-BaHAmH2K.cjs');
-var install = require('./install-Cs5qAPrB.cjs');
-var sessionOps = require('./sessionOps-JP64uJmc.cjs');
-var spawn = require('./spawn-CshERWbY.cjs');
-var spawnAgents = require('./spawnAgents-McixdtV1.cjs');
-var time = require('./time-BbzJ7PJQ.cjs');
+var install = require('./install-Cf6AFSWC.cjs');
+var precheckCompat = require('./precheckCompat-CWOi5c9L.cjs');
+var sessionOps = require('./sessionOps-DOyy4gkY.cjs');
+var spawn = require('./spawn-BS7LPmSm.cjs');
+var spawnAgents = require('./spawnAgents-vglexX9N.cjs');
+var time = require('./time-T0YmeOhS.cjs');
 require('zod');
 require('@paralleldrive/cuid2');
-require('./package-UkmvSFsg.cjs');
+require('./package-C1XvUQFy.cjs');
 require('node:fs/promises');
-require('./persistence-C6ztVW1W.cjs');
+require('./persistence-2Xp_o6x6.cjs');
 require('./authRelay-BdYkC1Po.cjs');
 require('node:crypto');
 require('tweetnacl');
-require('./logger-D0hkk7Vo.cjs');
+require('./logger-JTcJU-uL.cjs');
 require('node:util');
 require('./resources-JDPugcDq.cjs');
 require('axios');
-require('./controlClient-RWTlQA4_.cjs');
+require('./controlClient-CmnHGcyl.cjs');
 require('socket.io-client');
 require('./backgroundTaskActivity-CBvUdj39.cjs');
 require('./path-B7zW-WwE.cjs');
-require('./claudeSessionFork-CDJq_b9r.cjs');
+require('./claudeSessionFork-Cs0I3eGI.cjs');
 require('node:readline');
-require('./codexAppServerClient-BuSdeUxT.cjs');
+require('./codexAppServerClient-BTjn2ZCZ.cjs');
 require('node:child_process');
 require('cross-spawn');
 require('./contentLogMetadata-ZSFk_NjQ.cjs');
 require('./manager-Cly8xVIR.cjs');
 require('@anthropic-ai/sandbox-runtime');
+require('./rateLimitWindows-C2Jk3Ih7.cjs');
 require('./codexThreadFork-DNekT4nQ.cjs');
-require('./createSessionMetadata-CPGTztXP.cjs');
+require('./createSessionMetadata-DbfRBhRu.cjs');
 require('./projectPath-ChLhdOyt.cjs');
 require('path');
 require('url');
 require('./forkBackfill-8eLDeS73.cjs');
 
 const AUTO_ACTIONS = ["list", "show", "create", "edit", "pause", "resume", "rm", "run", "fire", "runs", "cancel", "ack", "report", "skill", "install", "uninstall", "help"];
-const VALUE_FLAGS = ["--name", "--rename", "--description", "--machine", "--cron", "--tz", "--every", "--at", "--spawn-dir", "--prompt", "--prompt-file", "--agent", "--model", "--permission-mode", "--sticky-key", "--send-session", "--cwd", "--env", "--timeout", "--concurrency", "--max-runtime", "--payload", "--payload-json", "--payload-file", "--dedupe-key", "--status", "--limit", "--run", "--summary", "--error", "--attention", "--host", "--home"];
-const BOOL_FLAGS = ["--manual", "--script", "--worktree", "--paused", "--wait", "--json", "--apply", "--all-machines", "--all", "--attention", "--help", "-h"];
+const VALUE_FLAGS = ["--name", "--rename", "--description", "--machine", "--cron", "--tz", "--every", "--at", "--spawn-dir", "--prompt", "--prompt-file", "--agent", "--model", "--permission-mode", "--sticky-key", "--send-session", "--cwd", "--env", "--timeout", "--concurrency", "--max-runtime", "--payload", "--payload-json", "--payload-file", "--dedupe-key", "--status", "--limit", "--run", "--summary", "--error", "--attention", "--host", "--home", "--precheck-shell", "--precheck-argv", "--precheck-cwd", "--precheck-timeout"];
+const BOOL_FLAGS = ["--manual", "--script", "--worktree", "--paused", "--wait", "--json", "--apply", "--all-machines", "--all", "--attention", "--precheck-output", "--no-precheck", "--help", "-h"];
 function parseAutoArgs(args) {
   const command = { action: "help", flags: {}, env: [], bools: /* @__PURE__ */ new Set(), argv: [] };
   if (args.length === 0) return command;
@@ -141,6 +143,52 @@ function actionFromCommand(command, current) {
   }
   return { kind: "spawn", agent: flags["--agent"] ?? "claude", directory: path.resolve(flags["--spawn-dir"]), prompt, ...spawnDetails(command) };
 }
+function precheckFromCommand(command, current) {
+  const { flags, bools } = command;
+  const shell = flags["--precheck-shell"];
+  const argvJson = flags["--precheck-argv"];
+  const modifiers = ["--precheck-cwd", "--precheck-timeout"].filter((flag) => flags[flag] !== void 0).concat(bools.has("--precheck-output") ? ["--precheck-output"] : []);
+  if (bools.has("--no-precheck")) {
+    if (shell !== void 0 || argvJson !== void 0 || modifiers.length) throw new Error("--no-precheck cannot be combined with other --precheck-* options");
+    return null;
+  }
+  if (shell === void 0 && argvJson === void 0 && modifiers.length === 0) return void 0;
+  if (shell !== void 0 && argvJson !== void 0) throw new Error("Use only one of --precheck-shell and --precheck-argv");
+  let base;
+  if (shell !== void 0) base = { shell };
+  else if (argvJson !== void 0) {
+    let argv;
+    try {
+      argv = JSON.parse(argvJson);
+    } catch {
+      throw new Error(`--precheck-argv must be a JSON array of strings, e.g. '["./has-new.sh","--since","5m"]'`);
+    }
+    if (!Array.isArray(argv) || argv.length === 0 || !argv.every((part) => typeof part === "string" && part.length > 0)) throw new Error("--precheck-argv must be a non-empty JSON array of non-empty strings");
+    base = { command: argv };
+  } else {
+    if (!current) throw new Error(`${modifiers.join(", ")} need a precheck: give --precheck-shell <line> or --precheck-argv <json>`);
+    base = current;
+  }
+  let timeoutMs;
+  if (flags["--precheck-timeout"] !== void 0) {
+    timeoutMs = template.parseDuration(flags["--precheck-timeout"]);
+    if (timeoutMs < 1e3 || timeoutMs > index.AUTOMATION_PRECHECK_MAX_TIMEOUT_MS) throw new Error(`--precheck-timeout must be between 1s and ${index.AUTOMATION_PRECHECK_MAX_TIMEOUT_MS / 6e4}m`);
+  }
+  const precheck = {
+    ...base,
+    ...flags["--precheck-cwd"] !== void 0 ? { cwd: flags["--precheck-cwd"] } : {},
+    ...timeoutMs !== void 0 ? { timeoutMs } : {},
+    ...bools.has("--precheck-output") ? { includeOutput: true } : {}
+  };
+  const parsed = index.AutomationPrecheckSchema.safeParse(precheck);
+  if (!parsed.success) throw new Error(`Invalid precheck: ${parsed.error.issues[0]?.message ?? "check the --precheck-* options"}`);
+  return parsed.data;
+}
+function describePrecheck(precheck) {
+  const what = precheck.shell !== void 0 ? `sh: ${precheck.shell}` : `argv: ${JSON.stringify(precheck.command)}`;
+  const extras = [precheck.cwd ? `cwd ${precheck.cwd}` : null, precheck.timeoutMs ? `timeout ${Math.round(precheck.timeoutMs / 1e3)}s` : null, precheck.includeOutput ? "output \u2192 prompt" : null].filter(Boolean);
+  return extras.length ? `${what}  (${extras.join(", ")})` : what;
+}
 function spawnDetails(command) {
   const { flags, bools } = command;
   if (flags["--agent"] !== void 0 && !spawnAgents.SPAWN_AGENTS.includes(flags["--agent"])) throw new Error(`--agent must be one of: ${spawnAgents.SPAWN_AGENTS.join(", ")}`);
@@ -182,6 +230,14 @@ ${chalk.bold("Action (one):")}
   --send-session <id> --prompt <text>|--prompt-file <file>
   --script -- <argv\u2026> [--cwd <dir>] [--env K=V]... [--timeout <dur>]
 
+${chalk.bold("Precheck (optional, runs before the action; exit 0 runs it, anything else records a skip):")}
+  --precheck-shell '<command line>' | --precheck-argv '<json array>'
+      [--precheck-cwd <dir>] [--precheck-timeout <dur>] (default 60s, max 10m)
+      [--precheck-output]   append the precheck's stdout to the spawn/send prompt
+  --no-precheck           edit: remove the precheck
+  A shell line is not template-rendered; read the payload from $VH_AUTOMATION_PAYLOAD.
+  Consecutive scheduled skips for the same reason fold into one run shown as \xD7N.
+
 ${chalk.bold("Options:")}
   --machine <id>|this     Executing machine (default: this machine)
   --description <text>
@@ -206,12 +262,14 @@ function printAutomation(a) {
   if (a.description) console.log(`  ${a.description}`);
   console.log(`  trigger:   ${template.describeTrigger(a.trigger)}   next: ${fmtTime(a.nextRunAt)}`);
   console.log(`  action:    ${template.describeAction(a.action)}`);
+  if (a.precheck) console.log(`  precheck:  ${describePrecheck(a.precheck)}`);
   console.log(`  machine:   ${a.machineId}   concurrency: ${a.concurrency}   max runtime: ${Math.round(a.maxRuntimeMs / 6e4)}m`);
   console.log(`  last run:  ${fmtTime(a.lastRunAt)} ${a.lastRunStatus ?? ""}`);
 }
 function runLine(run) {
   const status = run.status === "done" ? chalk.green(run.status) : ["failed", "expired"].includes(run.status) ? chalk.red(run.status) : run.status === "running" ? chalk.cyan(run.status) : run.status;
-  return `${fmtTime(run.createdAt)}  ${status.padEnd(9)}  ${run.automationName.padEnd(20)}  ${run.source.padEnd(8)}  ${run.id}${run.needsAttention ? chalk.yellow(`  ! ${run.attentionReason ?? "attention"}`) : ""}`;
+  const folded = (run.occurrenceCount ?? 1) > 1 ? ` \xD7${run.occurrenceCount}` : "";
+  return `${fmtTime(run.createdAt)}  ${status.padEnd(9)}  ${run.automationName.padEnd(20)}  ${run.source.padEnd(8)}  ${run.id}${folded}${run.status === "skipped" && run.error ? chalk.dim(`  ${run.error}`) : ""}${run.needsAttention ? chalk.yellow(`  ! ${run.attentionReason ?? "attention"}`) : ""}`;
 }
 function printRun(run) {
   console.log(runLine(run));
@@ -313,7 +371,9 @@ async function handleAutoCommand(args) {
           ...command.flags["--max-runtime"] !== void 0 ? { maxRuntimeMs: template.parseDuration(command.flags["--max-runtime"]) } : {},
           ...command.bools.has("--paused") ? { status: "paused" } : {}
         };
-        const automation = await client$1.create(input);
+        const precheck = precheckFromCommand(command);
+        if (precheck) input.precheck = precheck;
+        const automation = await precheckCompat.createAutomationChecked(client$1, input);
         if (json) {
           console.log(JSON.stringify({ automation }));
           return;
@@ -336,8 +396,10 @@ async function handleAutoCommand(args) {
           ...command.flags["--concurrency"] !== void 0 ? { concurrency: concurrency(command.flags["--concurrency"]) } : {},
           ...command.flags["--max-runtime"] !== void 0 ? { maxRuntimeMs: template.parseDuration(command.flags["--max-runtime"]) } : {}
         };
+        const precheck = precheckFromCommand(command, current.precheck);
+        if (precheck !== void 0) input.precheck = precheck;
         if (Object.keys(input).length === 1) throw new Error("Nothing to change");
-        const automation = await client$1.update(current.id, input);
+        const automation = await precheckCompat.updateAutomationChecked(client$1, current.id, input);
         if (json) {
           console.log(JSON.stringify({ automation }));
           return;
@@ -470,5 +532,7 @@ function concurrency(value) {
 exports.AUTO_ACTIONS = AUTO_ACTIONS;
 exports.AUTO_HELP = AUTO_HELP;
 exports.actionFromCommand = actionFromCommand;
+exports.describePrecheck = describePrecheck;
 exports.handleAutoCommand = handleAutoCommand;
 exports.parseAutoArgs = parseAutoArgs;
+exports.precheckFromCommand = precheckFromCommand;

package/dist/{bootstrap-B1dMZA-u.cjs → bootstrap-BpXIc2wn.cjs}

@@ -3,9 +3,9 @@
 var node_fs = require('node:fs');
 var promises = require('node:fs/promises');
 var path = require('node:path');
-var configuration = require('./configuration-BE61XNsg.cjs');
+var configuration = require('./configuration-B0cb3xA3.cjs');
 require('node:os');
-require('./package-UkmvSFsg.cjs');
+require('./package-C1XvUQFy.cjs');
 
 const ASSISTANT_CLAUDE_MD = `# very-happy \u8C03\u5EA6\u4E2D\u5FC3\uFF08\u8BED\u97F3\u52A9\u624B\uFF09
 

package/dist/{bootstrap-D_ExGrY2.mjs → bootstrap-XE8A7Ut2.mjs}

@@ -1,9 +1,9 @@
 import { existsSync } from 'node:fs';
 import { mkdir, writeFile } from 'node:fs/promises';
 import { join } from 'node:path';
-import { c as configuration } from './configuration-L1qcGTFM.mjs';
+import { c as configuration } from './configuration-D2v3puap.mjs';
 import 'node:os';
-import './package-VIUXrYZ1.mjs';
+import './package-BqwrPxL0.mjs';
 
 const ASSISTANT_CLAUDE_MD = `# very-happy \u8C03\u5EA6\u4E2D\u5FC3\uFF08\u8BED\u97F3\u52A9\u624B\uFF09