agent-shim 11.27.0 → 11.28.0

package/dist/index.mjs

@@ -263,7 +263,11 @@ var init_schema = __esm({
       headroom: z.boolean().optional(),
       trackUsage: z.boolean().optional(),
       /** The exact Claude Code version to run, as it is named in Claude Code's versions directory (`2.1.220`). A pin that is not installed fails the launch; it never falls back to the highest version. */
-      claudeVersion: z.string().regex(NUMERIC_DOTTED_VERSION_RE, "must be an exact dotted-numeric Claude Code version such as 2.1.220").optional()
+      claudeVersion: z.string().regex(NUMERIC_DOTTED_VERSION_RE, "must be an exact dotted-numeric Claude Code version such as 2.1.220").optional(),
+      /** How long the launcher waits after its own output before it starts claude, so that output can be read before Claude Code takes over the terminal (`5s`, `500ms`). Applies only when a terminal is watching. */
+      delay: z.string().regex(DURATION_RE, "must be a duration such as 5s or 500ms").optional(),
+      /** Whether the launcher waits for a key press after its own output before it starts claude. Takes the place of `delay` when both are set. Applies only when a terminal is watching. */
+      pause: z.boolean().optional()
     });
     CREDENTIAL_TARGETS = ["bearer", "apiKey", "oauthToken"];
     PROVIDER_CREDENTIAL_TARGETS = ["bearer", "apiKey"];
@@ -1366,6 +1370,12 @@ function flattenLayers(layers, options) {
       if (layer.launch.claudeVersion !== void 0) {
         launch.claudeVersion = layer.launch.claudeVersion;
       }
+      if (layer.launch.delay !== void 0) {
+        launch.delay = layer.launch.delay;
+      }
+      if (layer.launch.pause !== void 0) {
+        launch.pause = layer.launch.pause;
+      }
     }
     if (layer.entries === void 0) {
       continue;
@@ -2940,7 +2950,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "agent-shim",
-      version: "11.27.0",
+      version: "11.28.0",
       description: "A profile manager and launcher for Claude Code that lets one person run multiple logins from one machine while controlling what gets shared between them.",
       license: "MIT",
       author: "Joseph Mearman <joseph@mearman.co.uk>",
@@ -4383,7 +4393,7 @@ function realResolveClaudeBinary(isOwnBinary) {
 function realInstalledClaudeVersions() {
   return installedVersions(listVersionsDir(defaultVersionsDir()));
 }
-var realFsPort, OWNER_ONLY_DIR_MODE, OWNER_ONLY_FILE_MODE, PERMISSION_BITS, realFarmFs, INT32_BYTE_LENGTH, PS_TIMEOUT_MS, realRunPort, MACOS_GUI_SESSION_MANAGER, realCredentialPort, SOCKET_PERMISSION_BITS, realHeadroomSocketTrust, realSpawnPort, realProcPort, realLogPort, EXECUTE_BITS_MASK, WINDOWS_DEFAULT_PATHEXT;
+var realFsPort, OWNER_ONLY_DIR_MODE, OWNER_ONLY_FILE_MODE, PERMISSION_BITS, realFarmFs, INT32_BYTE_LENGTH, KEY_POLL_MS, CTRL_C_BYTE, realHoldPort, PS_TIMEOUT_MS, realRunPort, MACOS_GUI_SESSION_MANAGER, realCredentialPort, SOCKET_PERMISSION_BITS, realHeadroomSocketTrust, realSpawnPort, realProcPort, realLogPort, EXECUTE_BITS_MASK, WINDOWS_DEFAULT_PATHEXT;
 var init_realPorts = __esm({
   "src/realPorts.ts"() {
     "use strict";
@@ -4526,6 +4536,31 @@ var init_realPorts = __esm({
       }
     };
     INT32_BYTE_LENGTH = 4;
+    KEY_POLL_MS = 25;
+    CTRL_C_BYTE = 3;
+    realHoldPort = {
+      attended: () => process.stdin.isTTY && process.stdout.isTTY,
+      sleep: realSleepSync,
+      waitForKey: () => {
+        process.stdin.setRawMode(true);
+        try {
+          const buffer = Buffer.alloc(1);
+          for (; ; ) {
+            try {
+              const read = fs3.readSync(process.stdin.fd, buffer, 0, buffer.length, null);
+              return read > 0 && buffer[0] === CTRL_C_BYTE ? "interrupt" : "key";
+            } catch (error) {
+              if (!(error instanceof Error && "code" in error && error.code === "EAGAIN")) {
+                throw error;
+              }
+              realSleepSync(KEY_POLL_MS);
+            }
+          }
+        } finally {
+          process.stdin.setRawMode(false);
+        }
+      }
+    };
     PS_TIMEOUT_MS = 2e3;
     realRunPort = {
       run(command, args) {
@@ -7364,6 +7399,7 @@ function parseLauncherArgv(argv) {
   let configProfile;
   let provider;
   let claudeVersion;
+  let delay;
   const booleans = {};
   const categoryFlags = [];
   const shareFlags = [];
@@ -7421,6 +7457,9 @@ function parseLauncherArgv(argv) {
       case "--claude-version":
         claudeVersion = value;
         break;
+      case "--delay":
+        delay = value;
+        break;
       case "--category":
         categoryFlags.push(value);
         break;
@@ -7443,6 +7482,7 @@ function parseLauncherArgv(argv) {
     ...configProfile === void 0 ? {} : { configProfile },
     ...provider === void 0 ? {} : { provider },
     ...claudeVersion === void 0 ? {} : { claudeVersion },
+    ...delay === void 0 ? {} : { delay },
     ...native ? { native: true } : {},
     ...booleans,
     categoryFlags,
@@ -7466,13 +7506,14 @@ var init_argv = __esm({
       positional;
       flag;
     };
-    VALUED_FLAGS = ["--identity", "--config-profile", "--provider", "--claude-version", "--category", "--share", "--hide"];
+    VALUED_FLAGS = ["--identity", "--config-profile", "--provider", "--claude-version", "--delay", "--category", "--share", "--hide"];
     BOOLEAN_FLAGS = [
       { flag: "--headroom", key: "headroom" },
       { flag: "--track-usage", key: "trackUsage" },
       { flag: "--skip-permissions", key: "skipPermissions" },
       { flag: "--remote-control", key: "remoteControl" },
-      { flag: "--wait", key: "wait" }
+      { flag: "--wait", key: "wait" },
+      { flag: "--pause", key: "pause" }
     ];
     LAUNCHER_FLAG_NAMES = [
       ...VALUED_FLAGS,
@@ -7660,9 +7701,23 @@ function resolveLaunchFlags(params) {
     skipPermissions: params.flags?.skipPermissions ?? parseEnvBool("AGENT_SHIM_SKIP_PERMISSIONS", params.env.AGENT_SHIM_SKIP_PERMISSIONS) ?? params.cascade?.skipPermissions ?? false,
     remoteControl: params.flags?.remoteControl ?? parseEnvBool("AGENT_SHIM_REMOTE_CONTROL", params.env.AGENT_SHIM_REMOTE_CONTROL) ?? params.cascade?.remoteControl ?? false,
     headroom: params.flags?.headroom ?? parseEnvBool("AGENT_SHIM_HEADROOM", params.env.AGENT_SHIM_HEADROOM) ?? params.cascade?.headroom ?? false,
-    trackUsage: params.flags?.trackUsage ?? parseEnvBool("AGENT_SHIM_TRACK_USAGE", params.env.AGENT_SHIM_TRACK_USAGE) ?? params.cascade?.trackUsage ?? true
+    trackUsage: params.flags?.trackUsage ?? parseEnvBool("AGENT_SHIM_TRACK_USAGE", params.env.AGENT_SHIM_TRACK_USAGE) ?? params.cascade?.trackUsage ?? true,
+    pause: params.flags?.pause ?? parseEnvBool("AGENT_SHIM_PAUSE", params.env.AGENT_SHIM_PAUSE) ?? params.cascade?.pause ?? false,
+    delayMs: resolveDelayMs(params)
   };
 }
+function resolveDelayMs(params) {
+  const fromEnv = params.env.AGENT_SHIM_DELAY === "" ? void 0 : params.env.AGENT_SHIM_DELAY;
+  const [literal, source] = params.flags?.delay !== void 0 ? [params.flags.delay, "--delay"] : fromEnv !== void 0 ? [fromEnv, "AGENT_SHIM_DELAY"] : [params.cascade?.delay, "launch.delay"];
+  if (literal === void 0) {
+    return 0;
+  }
+  try {
+    return parseDuration(literal);
+  } catch (error) {
+    throw new UsageError(`${source}: ${error instanceof Error ? error.message : String(error)}`);
+  }
+}
 function buildFlagArgs(flags) {
   const args = [];
   if (flags.skipPermissions) {
@@ -7734,6 +7789,8 @@ var init_flags = __esm({
   "src/launcher/flags.ts"() {
     "use strict";
     init_envBool();
+    init_cliError();
+    init_conditions();
     init_credential();
     init_headers();
     init_capability();
@@ -7953,6 +8010,31 @@ var init_diagnostics = __esm({
   }
 });
 
+// src/launcher/hold.ts
+function describeDelay(ms) {
+  return ms % MS_PER_SECOND7 === 0 ? `${String(ms / MS_PER_SECOND7)}s` : `${String(ms)}ms`;
+}
+function holdBeforeLaunch(hold, port, log) {
+  if (port === void 0 || !port.attended() || !hold.pause && hold.delayMs <= 0) {
+    return "go";
+  }
+  if (hold.pause) {
+    log.info("agent-shim: paused before launch; press any key to start, or Ctrl-C to cancel");
+    return port.waitForKey() === "interrupt" ? "cancelled" : "go";
+  }
+  log.info(`agent-shim: starting in ${describeDelay(hold.delayMs)}`);
+  port.sleep(hold.delayMs);
+  return "go";
+}
+var LAUNCH_CANCELLED_EXIT, MS_PER_SECOND7;
+var init_hold = __esm({
+  "src/launcher/hold.ts"() {
+    "use strict";
+    LAUNCH_CANCELLED_EXIT = 130;
+    MS_PER_SECOND7 = 1e3;
+  }
+});
+
 // src/antigravity/cloudUpstream.ts
 var init_cloudUpstream = __esm({
   "src/antigravity/cloudUpstream.ts"() {
@@ -8136,20 +8218,20 @@ function filterCatalogue(models, catalogue) {
   const excluded = catalogue.exclude === void 0 ? void 0 : picomatch4(catalogue.exclude, { dot: true });
   return models.filter((model) => included?.(model.id) !== false && excluded?.(model.id) !== true);
 }
-var DEFAULT_CANDIDATE_URLS, MS_PER_SECOND7, SECONDS_PER_HOUR2, HOURS_PER_DAY5, MS_PER_HOUR5, HOURS_BETWEEN_RETRIES, CATALOGUE_MAX_AGE_MS, CATALOGUE_RETRY_MS, CATALOGUE_REQUEST_SECONDS, CATALOGUE_REQUEST_TIMEOUT_MS, CATALOGUE_REFRESH_TIMEOUT_MS, CatalogueModelSchema, CatalogueCacheSchema;
+var DEFAULT_CANDIDATE_URLS, MS_PER_SECOND8, SECONDS_PER_HOUR2, HOURS_PER_DAY5, MS_PER_HOUR5, HOURS_BETWEEN_RETRIES, CATALOGUE_MAX_AGE_MS, CATALOGUE_RETRY_MS, CATALOGUE_REQUEST_SECONDS, CATALOGUE_REQUEST_TIMEOUT_MS, CATALOGUE_REFRESH_TIMEOUT_MS, CatalogueModelSchema, CatalogueCacheSchema;
 var init_providerCatalogue = __esm({
   "src/providerCatalogue.ts"() {
     "use strict";
     DEFAULT_CANDIDATE_URLS = 2;
-    MS_PER_SECOND7 = 1e3;
+    MS_PER_SECOND8 = 1e3;
     SECONDS_PER_HOUR2 = 3600;
     HOURS_PER_DAY5 = 24;
-    MS_PER_HOUR5 = SECONDS_PER_HOUR2 * MS_PER_SECOND7;
+    MS_PER_HOUR5 = SECONDS_PER_HOUR2 * MS_PER_SECOND8;
     HOURS_BETWEEN_RETRIES = 1;
     CATALOGUE_MAX_AGE_MS = HOURS_PER_DAY5 * MS_PER_HOUR5;
     CATALOGUE_RETRY_MS = HOURS_BETWEEN_RETRIES * MS_PER_HOUR5;
     CATALOGUE_REQUEST_SECONDS = 10;
-    CATALOGUE_REQUEST_TIMEOUT_MS = CATALOGUE_REQUEST_SECONDS * MS_PER_SECOND7;
+    CATALOGUE_REQUEST_TIMEOUT_MS = CATALOGUE_REQUEST_SECONDS * MS_PER_SECOND8;
     CATALOGUE_REFRESH_TIMEOUT_MS = DEFAULT_CANDIDATE_URLS * CATALOGUE_REQUEST_TIMEOUT_MS;
     CatalogueModelSchema = z30.strictObject({ id: z30.string().min(1), name: z30.string().min(1).optional() });
     CatalogueCacheSchema = z30.strictObject({ fetchedAt: z30.number(), url: z30.string().min(1), models: z30.array(CatalogueModelSchema) });
@@ -8673,7 +8755,9 @@ function decideLaunch(params, readOnly) {
       ...parsedArgv.skipPermissions === void 0 ? {} : { skipPermissions: parsedArgv.skipPermissions },
       ...parsedArgv.remoteControl === void 0 ? {} : { remoteControl: parsedArgv.remoteControl },
       ...parsedArgv.headroom === void 0 ? {} : { headroom: parsedArgv.headroom },
-      ...parsedArgv.trackUsage === void 0 ? {} : { trackUsage: parsedArgv.trackUsage }
+      ...parsedArgv.trackUsage === void 0 ? {} : { trackUsage: parsedArgv.trackUsage },
+      ...parsedArgv.pause === void 0 ? {} : { pause: parsedArgv.pause },
+      ...parsedArgv.delay === void 0 ? {} : { delay: parsedArgv.delay }
     }
   });
   const loginlessProvider = requestedFlags.remoteControl && selectedProvider !== void 0 && farmIdentity !== void 0 && params.hasStoredLogin?.(farmIdentity) === false ? { identity: farmIdentity, provider: selectedProvider.name } : void 0;
@@ -8818,7 +8902,8 @@ function prepareLaunch(params) {
       registered();
     }
   };
-  return { bin: decided.bin, args: finalArgv, env: finalEnv, sessionId, release, markChildStarted: updateCheck.markChildStarted, decision };
+  const hold = () => holdBeforeLaunch({ delayMs: resolvedFlags.delayMs, pause: resolvedFlags.pause }, params.hold, log);
+  return { bin: decided.bin, args: finalArgv, env: finalEnv, sessionId, release, markChildStarted: updateCheck.markChildStarted, hold, decision };
 }
 function resolveLaunch(params) {
   const decided = decideLaunch(params, true);
@@ -8851,6 +8936,9 @@ function resolveLaunch(params) {
 }
 function runLaunchPlan(plan, spawn3) {
   try {
+    if (plan.hold() === "cancelled") {
+      return LAUNCH_CANCELLED_EXIT;
+    }
     plan.markChildStarted();
     const result = spawn3.spawnSync(plan.bin, plan.args, { stdio: "inherit", env: plan.env });
     if (result.error !== void 0) {
@@ -8878,6 +8966,7 @@ var init_launcher = __esm({
     init_extraFlags();
     init_claudeSession();
     init_diagnostics();
+    init_hold();
     init_modelPicker();
     init_providerCatalogue();
     init_pool();
@@ -9086,6 +9175,7 @@ function realPrepareLaunchParams(paths, options) {
     headroom: realHeadroomPort(paths, { spawnDaemon: options.spawnDaemon, cwd: farm.runtime.cwd }),
     frontdoor: realFrontDoorPort(paths, options.spawnDaemon),
     credentials: { ...realCredentialPort, cache: realCredentialCacheEnv(paths) },
+    hold: realHoldPort,
     hasStoredLogin: (identity) => identitySignIn(realFarmFs, { platform: process.platform, run: realRunPort }, { farmRoot: path42.join(paths.identitiesDir, identity), hasCredentialBlock: false }).state !== "signed-out",
     ...farm.directoryIdentity === void 0 ? {} : { directoryPinnedIdentity: farm.directoryIdentity },
     ...farm.directoryConfigProfile === void 0 ? {} : { directoryRuleConfigProfile: farm.directoryConfigProfile },
@@ -9362,13 +9452,13 @@ var init_identityClaude = __esm({
 
 // src/usage/providerQuota.ts
 import { z as z31 } from "zod";
-var MS_PER_SECOND8, SECONDS_PER_HOUR3, HOURS_PER_DAY6, DAYS_PER_MONTH, ZAI_HOST, ZAI_QUOTA_URL, ZAI_UNIT_HOURS, ZAI_UNIT_MONTHS, ZAI_UNIT_MS, ZaiLimitSchema, ZaiResponseSchema, OPENROUTER_HOST, OPENROUTER_KEY_URL, OPENROUTER_CREDITS_URL, MS_PER_DAY3, OpenRouterKeySchema, OpenRouterCreditsSchema, ANTIGRAVITY_HOST, ANTIGRAVITY_QUOTA_URL, ANTIGRAVITY_USER_URL, FIVE_HOURS2, DAYS_PER_WEEK2, FIVE_HOURS_MS, WEEK_MS, AntigravityBucketSchema, AntigravitySummarySchema, GoogleTokenInfoSchema, AntigravityUserSchema;
+var MS_PER_SECOND9, SECONDS_PER_HOUR3, HOURS_PER_DAY6, DAYS_PER_MONTH, ZAI_HOST, ZAI_QUOTA_URL, ZAI_UNIT_HOURS, ZAI_UNIT_MONTHS, ZAI_UNIT_MS, ZaiLimitSchema, ZaiResponseSchema, OPENROUTER_HOST, OPENROUTER_KEY_URL, OPENROUTER_CREDITS_URL, MS_PER_DAY3, OpenRouterKeySchema, OpenRouterCreditsSchema, ANTIGRAVITY_HOST, ANTIGRAVITY_QUOTA_URL, ANTIGRAVITY_USER_URL, FIVE_HOURS2, DAYS_PER_WEEK2, FIVE_HOURS_MS, WEEK_MS, AntigravityBucketSchema, AntigravitySummarySchema, GoogleTokenInfoSchema, AntigravityUserSchema;
 var init_providerQuota = __esm({
   "src/usage/providerQuota.ts"() {
     "use strict";
     init_cloudUpstream();
     init_schema2();
-    MS_PER_SECOND8 = 1e3;
+    MS_PER_SECOND9 = 1e3;
     SECONDS_PER_HOUR3 = 3600;
     HOURS_PER_DAY6 = 24;
     DAYS_PER_MONTH = 30;
@@ -9377,8 +9467,8 @@ var init_providerQuota = __esm({
     ZAI_UNIT_HOURS = 3;
     ZAI_UNIT_MONTHS = 5;
     ZAI_UNIT_MS = /* @__PURE__ */ new Map([
-      [ZAI_UNIT_HOURS, SECONDS_PER_HOUR3 * MS_PER_SECOND8],
-      [ZAI_UNIT_MONTHS, DAYS_PER_MONTH * HOURS_PER_DAY6 * SECONDS_PER_HOUR3 * MS_PER_SECOND8]
+      [ZAI_UNIT_HOURS, SECONDS_PER_HOUR3 * MS_PER_SECOND9],
+      [ZAI_UNIT_MONTHS, DAYS_PER_MONTH * HOURS_PER_DAY6 * SECONDS_PER_HOUR3 * MS_PER_SECOND9]
     ]);
     ZaiLimitSchema = z31.object({
       type: z31.string(),
@@ -9398,7 +9488,7 @@ var init_providerQuota = __esm({
     OPENROUTER_HOST = "openrouter.ai";
     OPENROUTER_KEY_URL = `https://${OPENROUTER_HOST}/api/v1/key`;
     OPENROUTER_CREDITS_URL = `https://${OPENROUTER_HOST}/api/v1/credits`;
-    MS_PER_DAY3 = HOURS_PER_DAY6 * SECONDS_PER_HOUR3 * MS_PER_SECOND8;
+    MS_PER_DAY3 = HOURS_PER_DAY6 * SECONDS_PER_HOUR3 * MS_PER_SECOND9;
     OpenRouterKeySchema = z31.object({
       data: z31.object({
         limit: z31.number().nonnegative().nullable(),
@@ -9414,8 +9504,8 @@ var init_providerQuota = __esm({
     ANTIGRAVITY_USER_URL = `https://${ANTIGRAVITY_HOST}/v1internal:loadCodeAssist`;
     FIVE_HOURS2 = 5;
     DAYS_PER_WEEK2 = 7;
-    FIVE_HOURS_MS = FIVE_HOURS2 * SECONDS_PER_HOUR3 * MS_PER_SECOND8;
-    WEEK_MS = DAYS_PER_WEEK2 * HOURS_PER_DAY6 * SECONDS_PER_HOUR3 * MS_PER_SECOND8;
+    FIVE_HOURS_MS = FIVE_HOURS2 * SECONDS_PER_HOUR3 * MS_PER_SECOND9;
+    WEEK_MS = DAYS_PER_WEEK2 * HOURS_PER_DAY6 * SECONDS_PER_HOUR3 * MS_PER_SECOND9;
     AntigravityBucketSchema = z31.object({
       bucketId: z31.string(),
       remainingFraction: z31.number().optional(),
@@ -13334,6 +13424,12 @@ function applyProfileChange(paths, name, change) {
   if (change.launchClaudeVersion !== void 0) {
     launchPatch.claudeVersion = change.launchClaudeVersion === false ? void 0 : change.launchClaudeVersion;
   }
+  if (change.launchDelay !== void 0) {
+    launchPatch.delay = change.launchDelay === false ? void 0 : change.launchDelay;
+  }
+  if (change.launchPause !== void 0) {
+    launchPatch.pause = change.launchPause;
+  }
   if (Object.keys(launchPatch).length > 0) {
     setProfileLaunchFlags(paths, name, launchPatch);
     touched = true;
@@ -15549,7 +15645,9 @@ var ConfigProfileSetInputSchema = z24.strictObject({
     headroom: z24.boolean().optional(),
     trackUsage: z24.boolean().optional(),
     provider: z24.union([z24.string().min(1), z24.literal(false)]).optional(),
-    claudeVersion: z24.union([z24.string().min(1), z24.literal(false)]).optional()
+    claudeVersion: z24.union([z24.string().min(1), z24.literal(false)]).optional(),
+    delay: z24.union([z24.string().regex(DURATION_RE), z24.literal(false)]).optional(),
+    pause: z24.boolean().optional()
   }).optional()
 });
 var ConfigProfileSetOutputSchema = storedMutationOutput("profile", "updated", ProfileValueSchema);
@@ -15759,7 +15857,9 @@ function createConfigApiRouter(deps) {
               ...launch?.headroom === void 0 ? {} : { launchHeadroom: launch.headroom },
               ...launch?.trackUsage === void 0 ? {} : { launchTrackUsage: launch.trackUsage },
               ...launch?.provider === void 0 ? {} : { launchProvider: launch.provider },
-              ...launch?.claudeVersion === void 0 ? {} : { launchClaudeVersion: launch.claudeVersion }
+              ...launch?.claudeVersion === void 0 ? {} : { launchClaudeVersion: launch.claudeVersion },
+              ...launch?.delay === void 0 ? {} : { launchDelay: launch.delay },
+              ...launch?.pause === void 0 ? {} : { launchPause: launch.pause }
             });
             return { action: "updated", kind: "profile", name: input.name, value: profileValue(input.name, paths) };
           })
@@ -16067,7 +16167,10 @@ var LaunchFlagsSchema = z26.strictObject({
   skipPermissions: z26.boolean(),
   remoteControl: z26.boolean(),
   headroom: z26.boolean(),
-  trackUsage: z26.boolean()
+  trackUsage: z26.boolean(),
+  pause: z26.boolean(),
+  /** How long the launch waits after its own output before it starts claude, in milliseconds. */
+  delayMs: z26.number()
 });
 var LaunchResolveOutputSchema = z26.strictObject({
   decision: LaunchDecisionSchema,

package/dist/types/index.d.ts

@@ -276,6 +276,8 @@ declare const LaunchSchema: z.ZodObject<{
     headroom: z.ZodOptional<z.ZodBoolean>;
     trackUsage: z.ZodOptional<z.ZodBoolean>;
     claudeVersion: z.ZodOptional<z.ZodString>;
+    delay: z.ZodOptional<z.ZodString>;
+    pause: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strict>;
 type LaunchFlags = z.infer<typeof LaunchSchema>;
 /**
@@ -857,6 +859,8 @@ declare const ConfigProfileSchema: z.ZodObject<{
         headroom: z.ZodOptional<z.ZodBoolean>;
         trackUsage: z.ZodOptional<z.ZodBoolean>;
         claudeVersion: z.ZodOptional<z.ZodString>;
+        delay: z.ZodOptional<z.ZodString>;
+        pause: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strict>>;
 }, z.core.$strict>;
 type ConfigProfile = z.infer<typeof ConfigProfileSchema>;
@@ -1063,6 +1067,8 @@ declare const DirectoryRuleSchema: z.ZodObject<{
         headroom: z.ZodOptional<z.ZodBoolean>;
         trackUsage: z.ZodOptional<z.ZodBoolean>;
         claudeVersion: z.ZodOptional<z.ZodString>;
+        delay: z.ZodOptional<z.ZodString>;
+        pause: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strict>>;
     path: z.ZodString;
     configProfile: z.ZodOptional<z.ZodString>;
@@ -1242,6 +1248,8 @@ declare const DirectoryRulesSchema: z.ZodObject<{
             headroom: z.ZodOptional<z.ZodBoolean>;
             trackUsage: z.ZodOptional<z.ZodBoolean>;
             claudeVersion: z.ZodOptional<z.ZodString>;
+            delay: z.ZodOptional<z.ZodString>;
+            pause: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict>>;
         path: z.ZodString;
         configProfile: z.ZodOptional<z.ZodString>;
@@ -1422,6 +1430,8 @@ declare const PortableConfigSchema: z.ZodObject<{
         headroom: z.ZodOptional<z.ZodBoolean>;
         trackUsage: z.ZodOptional<z.ZodBoolean>;
         claudeVersion: z.ZodOptional<z.ZodString>;
+        delay: z.ZodOptional<z.ZodString>;
+        pause: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strict>>;
     configProfile: z.ZodOptional<z.ZodString>;
     identity: z.ZodOptional<z.ZodString>;
@@ -1626,6 +1636,8 @@ declare const GlobalConfigSchema: z.ZodObject<{
         headroom: z.ZodOptional<z.ZodBoolean>;
         trackUsage: z.ZodOptional<z.ZodBoolean>;
         claudeVersion: z.ZodOptional<z.ZodString>;
+        delay: z.ZodOptional<z.ZodString>;
+        pause: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strict>>;
     headroom: z.ZodOptional<z.ZodObject<{
         source: z.ZodOptional<z.ZodString>;
@@ -5963,6 +5975,8 @@ declare function createConfigApiRouter(deps: ConfigApiDeps): {
                         headroom: zod.ZodOptional<zod.ZodBoolean>;
                         trackUsage: zod.ZodOptional<zod.ZodBoolean>;
                         claudeVersion: zod.ZodOptional<zod.ZodString>;
+                        delay: zod.ZodOptional<zod.ZodString>;
+                        pause: zod.ZodOptional<zod.ZodBoolean>;
                     }, zod_v4_core.$strict>>;
                 }, zod_v4_core.$strict>;
             }, zod_v4_core.$strict>, MergedErrorMap<$ErrorMap, TErrorMap>>;
@@ -5979,6 +5993,8 @@ declare function createConfigApiRouter(deps: ConfigApiDeps): {
                     trackUsage: zod.ZodOptional<zod.ZodBoolean>;
                     provider: zod.ZodOptional<zod.ZodUnion<readonly [zod.ZodString, zod.ZodLiteral<false>]>>;
                     claudeVersion: zod.ZodOptional<zod.ZodUnion<readonly [zod.ZodString, zod.ZodLiteral<false>]>>;
+                    delay: zod.ZodOptional<zod.ZodUnion<readonly [zod.ZodString, zod.ZodLiteral<false>]>>;
+                    pause: zod.ZodOptional<zod.ZodBoolean>;
                 }, zod_v4_core.$strict>>;
             }, zod_v4_core.$strict>, zod.ZodObject<{
                 action: zod.ZodLiteral<"updated">;
@@ -6082,6 +6098,8 @@ declare function createConfigApiRouter(deps: ConfigApiDeps): {
                         headroom: zod.ZodOptional<zod.ZodBoolean>;
                         trackUsage: zod.ZodOptional<zod.ZodBoolean>;
                         claudeVersion: zod.ZodOptional<zod.ZodString>;
+                        delay: zod.ZodOptional<zod.ZodString>;
+                        pause: zod.ZodOptional<zod.ZodBoolean>;
                     }, zod_v4_core.$strict>>;
                 }, zod_v4_core.$strict>;
             }, zod_v4_core.$strict>, MergedErrorMap<$ErrorMap, TErrorMap>>;
@@ -6682,6 +6700,8 @@ declare function createConfigApiRouter(deps: ConfigApiDeps): {
                         headroom: zod.ZodOptional<zod.ZodBoolean>;
                         trackUsage: zod.ZodOptional<zod.ZodBoolean>;
                         claudeVersion: zod.ZodOptional<zod.ZodString>;
+                        delay: zod.ZodOptional<zod.ZodString>;
+                        pause: zod.ZodOptional<zod.ZodBoolean>;
                     }, zod_v4_core.$strict>>;
                     path: zod.ZodString;
                     configProfile: zod.ZodOptional<zod.ZodString>;
@@ -6866,6 +6886,8 @@ declare function createConfigApiRouter(deps: ConfigApiDeps): {
                         headroom: zod.ZodOptional<zod.ZodBoolean>;
                         trackUsage: zod.ZodOptional<zod.ZodBoolean>;
                         claudeVersion: zod.ZodOptional<zod.ZodString>;
+                        delay: zod.ZodOptional<zod.ZodString>;
+                        pause: zod.ZodOptional<zod.ZodBoolean>;
                     }, zod_v4_core.$strict>>;
                     path: zod.ZodString;
                     configProfile: zod.ZodOptional<zod.ZodString>;
@@ -7195,6 +7217,10 @@ interface ResolvedLaunchFlags {
     readonly headroom: boolean;
     /** Whether the launch routes through the front door so its requests are recorded, even with no provider and no headroom. */
     readonly trackUsage: boolean;
+    /** Whether the launcher waits for a key press after its own output before it starts claude. */
+    readonly pause: boolean;
+    /** How long the launcher waits after its own output before it starts claude, in milliseconds; zero for no wait. */
+    readonly delayMs: number;
 }
 
 /** How a supervised launch names its conversation to claude: `start` begins one under the launch's id, `resume` continues the one with that id, `as-given` leaves the caller's own `--resume <id>` as written. */
@@ -7210,6 +7236,18 @@ interface SupervisedLaunch {
     readonly settings?: string;
 }
 
+/** The effects a hold needs, so it runs against fakes in tests. */
+interface HoldPort {
+    /** Whether a person is watching: standard input and standard output are both terminals. A launch nobody watches is never held. */
+    readonly attended: () => boolean;
+    /** Blocks for `ms` milliseconds. */
+    readonly sleep: (ms: number) => void;
+    /** Blocks until one key is pressed, and says whether it was the interrupt key (Ctrl-C), which a terminal in the mode this reads in delivers as a byte and not as a signal. */
+    readonly waitForKey: () => "key" | "interrupt";
+}
+/** What a hold decided: carry on with the launch, or the person cancelled it. */
+type HoldOutcome = "go" | "cancelled";
+
 /**
  * Everything the launch-time update check needs from its host, injected so tests run it against scripted answers and no launch ever reaches GitHub by accident. Deliberately narrower than `UpdatePorts`: the launch path never downloads anything (the detached `agent-shim update` does), so only the release check, the cooldown stamp, the clock, the background spawn and the terminal are wired.
  */
@@ -7294,6 +7332,8 @@ interface PrepareLaunchParams {
     readonly supervised?: SupervisedLaunch;
     /** Wires the launch-time update check behind `update.mode`. Omitted by a caller that cannot resolve releases, re-invoke this binary, or write to the terminal; a mode of `notify` or `auto` with no port wired simply checks nothing. */
     readonly update?: UpdateLaunchPort;
+    /** Waits for the person where the launch's `delay` and `pause` settings ask. Omitted by a caller that has no terminal to wait on, and then the launch is never held. */
+    readonly hold?: HoldPort;
     /** Whether an identity has a stored login Claude Code can use (a Keychain item or a credentials file). Absent when the caller cannot ask, in which case a launch assumes it does. */
     readonly hasStoredLogin?: (identity: string) => boolean;
 }
@@ -7349,6 +7389,8 @@ interface LaunchPlan {
     readonly decision: LaunchDecision;
     /** Marks the moment this plan's child is spawned: the launch-time update check suppresses its notify line from then on, since a line printed after the child took over the terminal would land mid-session. Call it immediately before spawning; it is safe to call more than once. */
     readonly markChildStarted: () => void;
+    /** Holds the launch as its `delay` and `pause` settings say, once the launcher has printed everything it will: call it just before spawning the child. `cancelled` means the person pressed Ctrl-C at the pause, and the child must not start. A launch with no hold port, or nobody watching, goes at once. */
+    readonly hold: () => HoldOutcome;
 }
 /**
  * Prepares one `claude` launch, in order:
@@ -7468,6 +7510,8 @@ declare function createLaunchApiRouter(deps: LaunchApiDeps): {
                 remoteControl: zod.ZodBoolean;
                 headroom: zod.ZodBoolean;
                 trackUsage: zod.ZodBoolean;
+                pause: zod.ZodBoolean;
+                delayMs: zod.ZodNumber;
             }, zod_v4_core.$strict>;
             claudeVersion: zod.ZodOptional<zod.ZodObject<{
                 version: zod.ZodString;
@@ -8584,6 +8628,8 @@ declare function createDoorApiRouter(deps: DoorApiDeps): {
                 remoteControl: zod.ZodBoolean;
                 headroom: zod.ZodBoolean;
                 trackUsage: zod.ZodBoolean;
+                pause: zod.ZodBoolean;
+                delayMs: zod.ZodNumber;
             }, zod_v4_core.$strict>;
             claudeVersion: zod.ZodOptional<zod.ZodObject<{
                 version: zod.ZodString;
@@ -8951,6 +8997,8 @@ declare function createDoorApiRouter(deps: DoorApiDeps): {
                         headroom: zod.ZodOptional<zod.ZodBoolean>;
                         trackUsage: zod.ZodOptional<zod.ZodBoolean>;
                         claudeVersion: zod.ZodOptional<zod.ZodString>;
+                        delay: zod.ZodOptional<zod.ZodString>;
+                        pause: zod.ZodOptional<zod.ZodBoolean>;
                     }, zod_v4_core.$strict>>;
                 }, zod_v4_core.$strict>;
             }, zod_v4_core.$strict>, MergedErrorMap<$ErrorMap, TErrorMap>>;
@@ -8967,6 +9015,8 @@ declare function createDoorApiRouter(deps: DoorApiDeps): {
                     trackUsage: zod.ZodOptional<zod.ZodBoolean>;
                     provider: zod.ZodOptional<zod.ZodUnion<readonly [zod.ZodString, zod.ZodLiteral<false>]>>;
                     claudeVersion: zod.ZodOptional<zod.ZodUnion<readonly [zod.ZodString, zod.ZodLiteral<false>]>>;
+                    delay: zod.ZodOptional<zod.ZodUnion<readonly [zod.ZodString, zod.ZodLiteral<false>]>>;
+                    pause: zod.ZodOptional<zod.ZodBoolean>;
                 }, zod_v4_core.$strict>>;
             }, zod_v4_core.$strict>, zod.ZodObject<{
                 action: zod.ZodLiteral<"updated">;
@@ -9070,6 +9120,8 @@ declare function createDoorApiRouter(deps: DoorApiDeps): {
                         headroom: zod.ZodOptional<zod.ZodBoolean>;
                         trackUsage: zod.ZodOptional<zod.ZodBoolean>;
                         claudeVersion: zod.ZodOptional<zod.ZodString>;
+                        delay: zod.ZodOptional<zod.ZodString>;
+                        pause: zod.ZodOptional<zod.ZodBoolean>;
                     }, zod_v4_core.$strict>>;
                 }, zod_v4_core.$strict>;
             }, zod_v4_core.$strict>, MergedErrorMap<$ErrorMap, TErrorMap>>;
@@ -9670,6 +9722,8 @@ declare function createDoorApiRouter(deps: DoorApiDeps): {
                         headroom: zod.ZodOptional<zod.ZodBoolean>;
                         trackUsage: zod.ZodOptional<zod.ZodBoolean>;
                         claudeVersion: zod.ZodOptional<zod.ZodString>;
+                        delay: zod.ZodOptional<zod.ZodString>;
+                        pause: zod.ZodOptional<zod.ZodBoolean>;
                     }, zod_v4_core.$strict>>;
                     path: zod.ZodString;
                     configProfile: zod.ZodOptional<zod.ZodString>;
@@ -9854,6 +9908,8 @@ declare function createDoorApiRouter(deps: DoorApiDeps): {
                         headroom: zod.ZodOptional<zod.ZodBoolean>;
                         trackUsage: zod.ZodOptional<zod.ZodBoolean>;
                         claudeVersion: zod.ZodOptional<zod.ZodString>;
+                        delay: zod.ZodOptional<zod.ZodString>;
+                        pause: zod.ZodOptional<zod.ZodBoolean>;
                     }, zod_v4_core.$strict>>;
                     path: zod.ZodString;
                     configProfile: zod.ZodOptional<zod.ZodString>;
@@ -11078,6 +11134,8 @@ declare const ConfigProfileAddOutputSchema: z.ZodObject<{
             headroom: z.ZodOptional<z.ZodBoolean>;
             trackUsage: z.ZodOptional<z.ZodBoolean>;
             claudeVersion: z.ZodOptional<z.ZodString>;
+            delay: z.ZodOptional<z.ZodString>;
+            pause: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict>>;
     }, z.core.$strict>;
 }, z.core.$strict>;
@@ -11095,6 +11153,8 @@ declare const ConfigProfileSetInputSchema: z.ZodObject<{
         trackUsage: z.ZodOptional<z.ZodBoolean>;
         provider: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<false>]>>;
         claudeVersion: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<false>]>>;
+        delay: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<false>]>>;
+        pause: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strict>>;
 }, z.core.$strict>;
 declare const ConfigProfileSetOutputSchema: z.ZodObject<{
@@ -11199,6 +11259,8 @@ declare const ConfigProfileSetOutputSchema: z.ZodObject<{
             headroom: z.ZodOptional<z.ZodBoolean>;
             trackUsage: z.ZodOptional<z.ZodBoolean>;
             claudeVersion: z.ZodOptional<z.ZodString>;
+            delay: z.ZodOptional<z.ZodString>;
+            pause: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict>>;
     }, z.core.$strict>;
 }, z.core.$strict>;
@@ -11801,6 +11863,8 @@ declare const ConfigRuleAddOutputSchema: z.ZodObject<{
             headroom: z.ZodOptional<z.ZodBoolean>;
             trackUsage: z.ZodOptional<z.ZodBoolean>;
             claudeVersion: z.ZodOptional<z.ZodString>;
+            delay: z.ZodOptional<z.ZodString>;
+            pause: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict>>;
         path: z.ZodString;
         configProfile: z.ZodOptional<z.ZodString>;
@@ -11987,6 +12051,8 @@ declare const ConfigRuleSetOutputSchema: z.ZodObject<{
             headroom: z.ZodOptional<z.ZodBoolean>;
             trackUsage: z.ZodOptional<z.ZodBoolean>;
             claudeVersion: z.ZodOptional<z.ZodString>;
+            delay: z.ZodOptional<z.ZodString>;
+            pause: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict>>;
         path: z.ZodString;
         configProfile: z.ZodOptional<z.ZodString>;
@@ -12473,6 +12539,8 @@ declare const LaunchResolveOutputSchema: z.ZodObject<{
         remoteControl: z.ZodBoolean;
         headroom: z.ZodBoolean;
         trackUsage: z.ZodBoolean;
+        pause: z.ZodBoolean;
+        delayMs: z.ZodNumber;
     }, z.core.$strict>;
     claudeVersion: z.ZodOptional<z.ZodObject<{
         version: z.ZodString;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-shim",
-  "version": "11.27.0",
+  "version": "11.28.0",
   "description": "A profile manager and launcher for Claude Code that lets one person run multiple logins from one machine while controlling what gets shared between them.",
   "license": "MIT",
   "author": "Joseph Mearman <joseph@mearman.co.uk>",