@prismatic-io/lux 0.0.2-preview.25 → 0.0.2-preview.26

package/lib/orchestrator/rubric-loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"rubric-loader.js","sourceRoot":"","sources":["../../src/orchestrator/rubric-loader.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"rubric-loader.js","sourceRoot":"","sources":["../../src/orchestrator/rubric-loader.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prismatic-io/lux",
-  "version": "0.0.2-preview.25",
+  "version": "0.0.2-preview.26",
   "description": "Coding-agent evaluation and improvement with deterministic assertions, optional LLM judges, and first-class human-in-the-loop runs.",
   "license": "MIT",
   "homepage": "https://github.com/prismatic-io/lux",

package/skills/lux-answerer/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: lux-answerer
-version: 0.0.2-preview.25
+version: 0.0.2-preview.26
 description: Play the persona for a running Lux orchestrator that uses the claude-code answerer. Read structured events on stdout, decide answers from persona + context, write JSON to its answer channel.
 user-invocable: false
 allowed-tools: Bash, Read
@@ -128,7 +128,7 @@ The persona is the single source of truth. When deciding an answer:
 ### Answer wait timed out (no event is emitted)
 
 If no reply lands on the answer channel within the answerer's wait budget
-(`maxAnswerWaitMs`, default 10 minutes), the pending answer is
+(`maxAnswerWait`, default 10 minutes), the pending answer is
 rejected and the run fails — there is no further stdout event to
 watch for. Separately, the driver can hit its own idle window if the
 agent stalls mid-LLM-call. Either way, inspect the run dir

package/src/answerers/claude-code/index.ts

@@ -13,6 +13,7 @@ import { join } from "node:path";
 import { createInterface } from "node:readline";
 import { temporaryDirectory } from "tempy";
 import { z } from "zod";
+import { DurationSchema, durationMs } from "../../core/duration.js";
 import {
   type Answer,
   type Answerer,
@@ -33,7 +34,7 @@ export const ClaudeCodeAnswererConfigSchema = z
     /** Where to put the FIFO. Defaults to a fresh tmp dir per run. */
     fifoDir: z.string().optional(),
     /** How long to wait for a single answer to come back, in ms. */
-    maxAnswerWaitMs: z.number().positive().default(600_000),
+    maxAnswerWait: DurationSchema.default("10 minutes"),
     /** Inject a custom emitter for tests; defaults to process.stdout. */
     emit: z.custom<AnswererEmitter>(isFunction).optional(),
     /**
@@ -118,7 +119,7 @@ class ClaudeCodeAnswererImpl implements Answerer {
     return await read(
       this.fifoPath,
       interrupt,
-      this.config.maxAnswerWaitMs,
+      durationMs(this.config.maxAnswerWait),
       this.pendingAborts,
       ctx.abortSignal,
     );

package/src/answerers/persona/index.ts

@@ -1,5 +1,6 @@
 import { randomUUID } from "node:crypto";
 import { z } from "zod";
+import { DurationSchema, durationMs } from "../../core/duration.js";
 import {
   type Answer,
   type Answerer,
@@ -35,7 +36,7 @@ export const PersonaAnswererConfigSchema = z
     /** Reasoning effort for providers that support it. Codex defaults to low. */
     reasoningEffort: ReasoningEffortSchema.optional(),
     /** Hard timeout per answer. Default 120s. */
-    timeoutMs: z.number().positive().default(120_000),
+    timeout: DurationSchema.default("2 minutes"),
     /** Replace the generated persona system prompt entirely. */
     systemPromptOverride: z.string().optional(),
   })
@@ -284,7 +285,7 @@ class PersonaAnswererImpl implements Answerer {
         command: this.config.command,
         model: this.config.model,
         reasoningEffort: this.config.reasoningEffort,
-        timeoutMs: this.config.timeoutMs,
+        timeoutMs: durationMs(this.config.timeout),
         system,
         prompt,
         signal: ctx.abortSignal,

package/src/answerers/terminal/index.ts

@@ -2,12 +2,13 @@ import { stdin, stdout } from "node:process";
 import { createInterface, type Interface } from "node:readline/promises";
 import { z } from "zod";
 import { defineAnswerer } from "../../core/answerer.js";
+import { DurationSchema, durationMs } from "../../core/duration.js";
 import type { Answer, Answerer, AnswererContext, Interrupt } from "../../core/index.js";
 import { approveAnswer } from "../shared.js";
 
 export const TerminalAnswererConfigSchema = z
   .object({
-    maxAnswerWaitMs: z.number().positive().default(600_000),
+    maxAnswerWait: DurationSchema.default("10 minutes"),
   })
   .strict();
 
@@ -58,7 +59,7 @@ class TerminalAnswererImpl implements Answerer {
   private readonly maxAnswerWaitMs: number;
 
   constructor(config: TerminalAnswererConfig) {
-    this.maxAnswerWaitMs = config.maxAnswerWaitMs;
+    this.maxAnswerWaitMs = durationMs(config.maxAnswerWait);
   }
 
   async prepare(): Promise<void> {

package/src/assertions/core/command-exits-zero.ts

@@ -1,5 +1,6 @@
 import { resolve } from "node:path";
 import { z } from "zod";
+import { DurationSchema, durationMs } from "../../core/duration.js";
 import { type AssertionImpl, exec, hasRunArtifactEvidenceBoundary } from "../../core/index.js";
 import {
   baseAssertionFields,
@@ -22,7 +23,7 @@ export const CommandExitsZeroConfigSchema = z
      * environment, including credentials.
      */
     inheritEnv: z.union([z.array(z.string().min(1)), z.literal(true)]).default([]),
-    timeoutMs: z.number().positive().default(120_000),
+    timeout: DurationSchema.default("2 minutes"),
     ...baseAssertionFields,
   })
   .strict();
@@ -57,7 +58,7 @@ export const commandExitsZeroAssertion: AssertionImpl<CommandExitsZeroConfig> =
         cwd: root,
         env: { ...parentEnv, ...config.env },
         shell: true,
-        timeoutMs: config.timeoutMs,
+        timeoutMs: durationMs(config.timeout),
         maxBuffer: 4_000,
         ...(ctx?.abortSignal ? { signal: ctx.abortSignal } : {}),
       });
@@ -73,7 +74,7 @@ export const commandExitsZeroAssertion: AssertionImpl<CommandExitsZeroConfig> =
     }
     const passed = result.exitCode === 0 && !result.timedOut;
     const comment = result.timedOut
-      ? `command timed out after ${config.timeoutMs}ms`
+      ? `command timed out after ${durationMs(config.timeout)}ms`
       : `'${config.command}' exited ${result.exitCode}${result.signal ? ` (signal ${result.signal})` : ""}`;
     return {
       passed,

package/src/assertions/rubric/index.ts

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { DurationSchema, durationMs } from "../../core/duration.js";
 import {
   type AssertionImpl,
   type AssertionResult,
@@ -72,7 +73,7 @@ export const RubricConfigSchema = z
     /** Reasoning effort for providers that support it. Codex defaults to low. */
     reasoningEffort: ReasoningEffortSchema.optional(),
     /** Hard timeout for the judge call. Default 120s. */
-    timeoutMs: z.number().positive().default(120_000),
+    timeout: DurationSchema.default("2 minutes"),
     /** Override the default judge prompt template. */
     promptOverride: z.string().max(120_000).optional(),
     /** Cap on file content included in the judge prompt. Default 4000. */
@@ -232,7 +233,7 @@ const judgeRubric = async (
         command: runtime.command,
         model: runtime.model,
         reasoningEffort: runtime.reasoningEffort,
-        timeoutMs: config.timeoutMs,
+        timeoutMs: durationMs(config.timeout),
         system: SYSTEM_PROMPT,
         prompt,
         signal: context?.abortSignal,
@@ -255,7 +256,7 @@ export const createRubricAssertion = (
   evaluate: async (rawConfig, run, ctx) => {
     // Grading passes a validated copy, but direct programmatic callers may
     // hand evaluate() a raw config — re-parse so the schema defaults
-    // (model, command, timeoutMs, ...) apply either way.
+    // (model, command, timeout, ...) apply either way.
     const config = RubricConfigSchema.parse(rawConfig);
     const prompt = await buildJudgePrompt(config, run);
     return judgeRubric(config, prompt, rubricRuntime(config, harness), ctx);

package/src/authoring.ts

@@ -133,6 +133,7 @@ export {
   type ReportedDriverMetrics,
   ReportedDriverMetricsSchema,
 } from "./core/driver-metrics.js";
+export { DurationSchema, durationMs } from "./core/duration.js";
 export { type EventHandler, TypedEmitter } from "./core/emitter.js";
 export { type EnvironmentDeclaration, EnvironmentDeclarationSchema } from "./core/environment.js";
 export {

package/src/core/duration.ts

@@ -0,0 +1,52 @@
+import { z } from "zod";
+
+const UNITS: Record<string, number> = {
+  ms: 1,
+  millisecond: 1,
+  milliseconds: 1,
+  s: 1000,
+  second: 1000,
+  seconds: 1000,
+  m: 60_000,
+  minute: 60_000,
+  minutes: 60_000,
+  h: 3_600_000,
+  hour: 3_600_000,
+  hours: 3_600_000,
+  d: 86_400_000,
+  day: 86_400_000,
+  days: 86_400_000,
+};
+const MAX_TIMER_MS = 2_147_483_647;
+const INVALID_DURATION =
+  'Expected a positive duration such as "20 minutes", "1.5 hours", or "500 ms", up to 2147483647 milliseconds';
+
+/** Explicit units prevent ambiguous numeric configuration and Node timer overflow. */
+export const durationMs = (value: string): number => {
+  if (value.length > 80) throw new Error(INVALID_DURATION);
+  const match =
+    /^(\d+(?:\.\d+)?)\s*(ms|milliseconds?|s|seconds?|m|minutes?|h|hours?|d|days?)$/i.exec(
+      value.trim(),
+    );
+  const amount = match?.[1];
+  const multiplier = match?.[2] ? UNITS[match[2].toLowerCase()] : undefined;
+  if (!amount || !multiplier) throw new Error(INVALID_DURATION);
+  const [whole, fraction = ""] = amount.split(".");
+  const scale = 10n ** BigInt(fraction.length);
+  const numerator = BigInt(`${whole}${fraction}`) * BigInt(multiplier);
+  const milliseconds = numerator / scale;
+  if (numerator % scale !== 0n || milliseconds <= 0n || milliseconds > BigInt(MAX_TIMER_MS)) {
+    throw new Error(INVALID_DURATION);
+  }
+  return Number(milliseconds);
+};
+
+// Keep strings in validated configs: schema validation may run again during
+// experiment preparation or replay. Conversion belongs at the timer boundary.
+export const DurationSchema = z.string().superRefine((value, ctx) => {
+  try {
+    durationMs(value);
+  } catch {
+    ctx.addIssue({ code: "custom", message: INVALID_DURATION });
+  }
+});

package/src/core/experiment.ts

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { DriverMetricDescriptorSchema } from "./driver-metrics.js";
+import { DurationSchema } from "./duration.js";
 import { ConfidenceConfigSchema } from "./statistics.js";
 import { TokenUsageSchema } from "./usage.js";
 import { formatZodIssues } from "./zod.js";
@@ -46,7 +47,7 @@ export const FileSetSubjectSchema = z
              * External paths and URLs are rejected by experiment preflight.
              */
             args: z.array(z.string()).default([]),
-            timeoutMs: z.number().int().positive().default(120_000),
+            timeout: DurationSchema.default("2 minutes"),
             /**
              * Validation launches a host process against model-generated source.
              * Authors must explicitly acknowledge that trust boundary. Commands

package/src/core/index.ts

@@ -10,6 +10,7 @@ export * from "./case.js";
 export * from "./conversation-turn.js";
 export * from "./driver.js";
 export * from "./driver-metrics.js";
+export * from "./duration.js";
 export * from "./emitter.js";
 export * from "./environment.js";
 export * from "./events.js";

package/src/drivers/antigravity/config.ts

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { DurationSchema } from "../../core/duration.js";
 import { antigravityCatalog, applyCatalogEffort } from "../../core/index.js";
 
 export const AntigravityDriverConfigSchema = z
@@ -23,7 +24,7 @@ export const AntigravityDriverConfigSchema = z
     cwd: z.string().optional(),
     env: z.record(z.string(), z.string()).optional(),
     extraArgs: z.array(z.string()).optional(),
-    idleTimeoutMs: z.number().positive().default(600_000),
+    idleTimeout: DurationSchema.default("10 minutes"),
     maxLineBytes: z.number().positive().default(10_000_000),
   })
   .strict()

package/src/drivers/antigravity/index.ts

@@ -58,7 +58,7 @@ class AntigravityDriver implements AgentDriver {
           `The task workspace is ${JSON.stringify(this.cwd)}. Treat that directory as the current directory for this task and create task artifacts there.\n\n${prompt}`,
         ),
       closeStdinAfterPrompt: true,
-      idleTimeoutMs: this.config.idleTimeoutMs,
+      idleTimeout: this.config.idleTimeout,
       maxLineBytes: this.config.maxLineBytes,
       maxInterrupts: 1,
     });

package/src/drivers/claude-code/index.ts

@@ -3,6 +3,7 @@ import { homedir } from "node:os";
 import { dirname, join, resolve, sep } from "node:path";
 import { temporaryDirectory } from "tempy";
 import { z } from "zod";
+import { DurationSchema, durationMs } from "../../core/duration.js";
 import {
   type AgentDriver,
   type Answer,
@@ -108,19 +109,19 @@ export const ClaudeCodeDriverConfigSchema = z
      */
     textQuestionFallback: z.boolean().default(false),
     /** Maximum silence between recognized protocol events; excludes answerer wait time. */
-    idleTimeoutMs: z.number().positive().default(600_000),
+    idleTimeout: DurationSchema.default("10 minutes"),
     /** Optional elapsed-time cap per defer-resume CLI invocation, regardless of activity. */
-    turnTimeoutMs: z.number().positive().optional(),
+    turnTimeout: DurationSchema.optional(),
     /** Cap on outstanding interrupts before the driver aborts. */
     maxInterrupts: z.number().positive().default(20),
   })
   .strict()
   .superRefine((config, ctx) => {
-    if (config.turnTimeoutMs !== undefined && config.interactionMode !== "defer-resume") {
+    if (config.turnTimeout !== undefined && config.interactionMode !== "defer-resume") {
       ctx.addIssue({
         code: "custom",
-        path: ["turnTimeoutMs"],
-        message: "turnTimeoutMs requires defer-resume mode",
+        path: ["turnTimeout"],
+        message: "turnTimeout requires defer-resume mode",
       });
     }
     if (config.interactionMode === "defer-resume") {
@@ -596,7 +597,7 @@ class ClaudeCodeDriverImpl implements AgentDriver {
       parseEvent: makeParseEvent(this.config, cliVersion),
       formatAnswer,
       formatPrompt,
-      idleTimeoutMs: this.config.idleTimeoutMs,
+      idleTimeout: this.config.idleTimeout,
       maxInterrupts: this.config.maxInterrupts,
     });
     for (const queued of this.pendingAttach) queued.attach(inner);
@@ -752,10 +753,10 @@ class ClaudeCodeDriverImpl implements AgentDriver {
         ...(answer ? { LUX_CLAUDE_DEFERRED_ANSWER: JSON.stringify(answer) } : {}),
       },
       ...input,
-      idleTimeoutMs: this.config.idleTimeoutMs,
-      ...(this.config.turnTimeoutMs === undefined
+      idleTimeoutMs: durationMs(this.config.idleTimeout),
+      ...(this.config.turnTimeout === undefined
         ? {}
-        : { turnTimeoutMs: this.config.turnTimeoutMs }),
+        : { turnTimeoutMs: durationMs(this.config.turnTimeout) }),
       signal: AbortSignal.any([ctx.abortSignal, this.deferredAbort.signal]),
       parse: (line) => {
         try {

package/src/drivers/codex/config.ts

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { DurationSchema } from "../../core/duration.js";
 import { applyCatalogEffort, codexCatalog, DEFAULT_CODEX_MODEL } from "../../core/index.js";
 
 export type CodexConfigValue =
@@ -51,7 +52,7 @@ export const CodexDriverConfigSchema = z
     isolation: IsolationSchema.optional(),
     maxInterrupts: z.number().positive().default(20),
     maxLineBytes: z.number().positive().default(10_000_000),
-    idleTimeoutMs: z.number().positive().default(600_000),
+    idleTimeout: DurationSchema.default("10 minutes"),
   })
   .strict()
   .superRefine((config, ctx) => {

package/src/drivers/codex/index.ts

@@ -3,6 +3,7 @@ import { homedir } from "node:os";
 import { dirname, join } from "node:path";
 import { createInterface } from "node:readline";
 import { temporaryDirectory } from "tempy";
+import { durationMs } from "../../core/duration.js";
 import {
   type AgentDriver,
   type Answer,
@@ -654,8 +655,8 @@ class CodexAppServerDriverImpl implements AgentDriver {
     this.idleTimer = setTimeout(() => {
       this.idleTimer = null;
       if (this.interrupts.size > 0) return;
-      this.fail(`no event for ${this.config.idleTimeoutMs}ms`, "idle-timeout");
-    }, this.config.idleTimeoutMs);
+      this.fail(`no event for ${durationMs(this.config.idleTimeout)}ms`, "idle-timeout");
+    }, durationMs(this.config.idleTimeout));
   }
 
   private clearIdleTimer(): void {
@@ -718,7 +719,7 @@ class CodexExecDriverImpl implements AgentDriver {
       parseEvent: makeParseEvent(this.config, cliVersion),
       formatPrompt: (prompt) => prompt,
       closeStdinAfterPrompt: true,
-      idleTimeoutMs: this.config.idleTimeoutMs,
+      idleTimeout: this.config.idleTimeout,
       maxLineBytes: this.config.maxLineBytes,
       maxInterrupts: 1,
     });

package/src/drivers/copilot/config.ts

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { DurationSchema } from "../../core/duration.js";
 import { applyCatalogEffort, copilotCatalog } from "../../core/index.js";
 
 export const CopilotDriverConfigSchema = z
@@ -23,8 +24,8 @@ export const CopilotDriverConfigSchema = z
     extraArgs: z.array(z.string()).optional(),
     cwd: z.string().optional(),
     env: z.record(z.string(), z.string()).optional(),
-    startupTimeoutMs: z.number().int().positive().default(30_000),
-    idleTimeoutMs: z.number().int().positive().default(600_000),
+    startupTimeout: DurationSchema.default("30 seconds"),
+    idleTimeout: DurationSchema.default("10 minutes"),
     maxInterrupts: z.number().int().positive().default(20),
     maxLineBytes: z.number().int().positive().default(10_000_000),
     maxQueuedBytes: z.number().int().positive().default(20_000_000),

package/src/drivers/copilot/index.ts

@@ -1,4 +1,5 @@
 import { realpath } from "node:fs/promises";
+import { durationMs } from "../../core/duration.js";
 import {
   type AgentDriver,
   type Answer,
@@ -130,7 +131,7 @@ class CopilotDriver implements AgentDriver {
 
   private request(method: string, params: RpcRecord): Promise<RpcRecord> {
     if (!this.transport) throw new Error("Copilot ACP has not started");
-    return this.transport.request(method, params, this.config.startupTimeoutMs);
+    return this.transport.request(method, params, durationMs(this.config.startupTimeout));
   }
 
   private async run(prompt: string): Promise<void> {
@@ -209,10 +210,10 @@ class CopilotDriver implements AgentDriver {
     this.idleTimer = setTimeout(
       () =>
         this.fail(
-          new Error(`Copilot emitted no event for ${this.config.idleTimeoutMs}ms`),
+          new Error(`Copilot emitted no event for ${durationMs(this.config.idleTimeout)}ms`),
           "idle-timeout",
         ),
-      this.config.idleTimeoutMs,
+      durationMs(this.config.idleTimeout),
     );
   }
 

package/src/drivers/cursor/config.ts

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { DurationSchema } from "../../core/duration.js";
 import { cursorCatalog } from "../../core/index.js";
 
 export const CursorDriverConfigSchema = z
@@ -9,8 +10,8 @@ export const CursorDriverConfigSchema = z
     mode: z.enum(["agent", "plan", "ask"]).default("agent"),
     cwd: z.string().optional(),
     env: z.record(z.string(), z.string()).optional(),
-    startupTimeoutMs: z.number().int().positive().default(30_000),
-    idleTimeoutMs: z.number().int().positive().default(600_000),
+    startupTimeout: DurationSchema.default("30 seconds"),
+    idleTimeout: DurationSchema.default("10 minutes"),
     maxInterrupts: z.number().int().positive().default(20),
     maxLineBytes: z.number().int().positive().default(10_000_000),
     maxQueuedBytes: z.number().int().positive().default(20_000_000),

package/src/drivers/cursor/index.ts

@@ -1,4 +1,5 @@
 import { realpath } from "node:fs/promises";
+import { durationMs } from "../../core/duration.js";
 import {
   type AgentDriver,
   type Answer,
@@ -136,7 +137,7 @@ class CursorDriver implements AgentDriver {
 
   private request(method: string, params: RpcRecord): Promise<RpcRecord> {
     if (!this.transport) throw new Error("Cursor ACP has not started");
-    return this.transport.request(method, params, this.config.startupTimeoutMs);
+    return this.transport.request(method, params, durationMs(this.config.startupTimeout));
   }
 
   private async run(prompt: string): Promise<void> {
@@ -237,10 +238,10 @@ class CursorDriver implements AgentDriver {
     this.idleTimer = setTimeout(
       () =>
         this.fail(
-          new Error(`Cursor emitted no event for ${this.config.idleTimeoutMs}ms`),
+          new Error(`Cursor emitted no event for ${durationMs(this.config.idleTimeout)}ms`),
           "idle-timeout",
         ),
-      this.config.idleTimeoutMs,
+      durationMs(this.config.idleTimeout),
     );
   }
 

package/src/drivers/grok-build/README.md

@@ -64,8 +64,8 @@ text and invalid fields still deny the operation. If the agent offers no matchin
 one-operation option, Lux cancels and reports an error rather than widening the
 grant. Native auto decisions are handled inside Grok and are not Lux interrupts.
 
-Permission reviews have a separate `permissionTimeoutMs` (150 seconds by
-default), while ordinary inactivity uses `idleTimeoutMs` (10 minutes). Startup
+Permission reviews have a separate `permissionTimeout` (150 seconds by
+default), while ordinary inactivity uses `idleTimeout` (10 minutes). Startup
 RPCs time out after 30 seconds. Cancelled turns, process failures, unanswered
 reviews, and turns ending with pending approvals cannot count as successful runs.
 A completed turn can still contain denied tool calls: assert the expected files

package/src/drivers/grok-build/config.ts

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { DurationSchema } from "../../core/duration.js";
 import { applyCatalogEffort, grokBuildCatalog } from "../../core/index.js";
 
 export const GrokBuildDriverConfigSchema = z
@@ -11,9 +12,9 @@ export const GrokBuildDriverConfigSchema = z
     sandbox: z.enum(["workspace", "read-only", "strict"]).default("workspace"),
     cwd: z.string().optional(),
     env: z.record(z.string(), z.string()).optional(),
-    startupTimeoutMs: z.number().int().positive().default(30_000),
-    idleTimeoutMs: z.number().int().positive().default(600_000),
-    permissionTimeoutMs: z.number().int().positive().default(150_000),
+    startupTimeout: DurationSchema.default("30 seconds"),
+    idleTimeout: DurationSchema.default("10 minutes"),
+    permissionTimeout: DurationSchema.default("150 seconds"),
     maxInterrupts: z.number().int().positive().default(20),
     maxLineBytes: z.number().int().positive().default(10_000_000),
     maxQueuedBytes: z.number().int().positive().default(20_000_000),

package/src/drivers/grok-build/index.ts

@@ -1,4 +1,5 @@
 import { realpath } from "node:fs/promises";
+import { durationMs } from "../../core/duration.js";
 import {
   type AgentDriver,
   type Answer,
@@ -143,7 +144,7 @@ class GrokBuildDriver implements AgentDriver {
 
   private request(method: string, params: RpcRecord): Promise<RpcRecord> {
     if (!this.transport) throw new Error("Grok.build ACP has not started");
-    return this.transport.request(method, params, this.config.startupTimeoutMs);
+    return this.transport.request(method, params, durationMs(this.config.startupTimeout));
   }
 
   private async run(prompt: string): Promise<void> {
@@ -198,10 +199,10 @@ class GrokBuildDriver implements AgentDriver {
         this.interrupts.delete(interruptId);
         this.fail(
           new Error(
-            `Grok.build permission review timed out after ${this.config.permissionTimeoutMs}ms`,
+            `Grok.build permission review timed out after ${durationMs(this.config.permissionTimeout)}ms`,
           ),
         );
-      }, this.config.permissionTimeoutMs);
+      }, durationMs(this.config.permissionTimeout));
       this.interrupts.set(interruptId, { id, params, timer });
       clearTimeout(this.idleTimer);
       void this.emitter
@@ -243,10 +244,10 @@ class GrokBuildDriver implements AgentDriver {
     this.idleTimer = setTimeout(
       () =>
         this.fail(
-          new Error(`Grok.build emitted no event for ${this.config.idleTimeoutMs}ms`),
+          new Error(`Grok.build emitted no event for ${durationMs(this.config.idleTimeout)}ms`),
           "idle-timeout",
         ),
-      this.config.idleTimeoutMs,
+      durationMs(this.config.idleTimeout),
     );
   }
 

package/src/drivers/mcp/index.ts

@@ -1,6 +1,7 @@
 import { Client } from "@modelcontextprotocol/sdk/client/index.js";
 import { getDefaultEnvironment } from "@modelcontextprotocol/sdk/client/stdio.js";
 import { z } from "zod";
+import { DurationSchema, durationMs as parseDuration } from "../../core/duration.js";
 import {
   type AgentDriver,
   type Answer,
@@ -72,9 +73,9 @@ export const McpProbeDriverConfigSchema = z
     /** The steps to run. Defaults to a single `tools/list` capture. */
     probe: z.array(ProbeStepSchema).default([{ op: "list-tools" }]),
     /** Timeout for the initialize handshake. */
-    startupTimeoutMs: z.number().positive().default(30_000),
+    startupTimeout: DurationSchema.default("30 seconds"),
     /** Timeout for each `tools/list` / `tools/call` request. */
-    stepTimeoutMs: z.number().positive().default(60_000),
+    stepTimeout: DurationSchema.default("1 minute"),
     /** Safety cap for a paginated `tools/list` operation. */
     maxListPages: z.number().int().positive().default(100),
   })
@@ -211,8 +212,8 @@ class McpProbeDriverImpl implements AgentDriver {
 
     try {
       await client.connect(transport, {
-        timeout: this.config.startupTimeoutMs,
-        maxTotalTimeout: this.config.startupTimeoutMs,
+        timeout: parseDuration(this.config.startupTimeout),
+        maxTotalTimeout: parseDuration(this.config.startupTimeout),
         signal: ctx.abortSignal,
       });
     } catch (err) {
@@ -261,8 +262,8 @@ class McpProbeDriverImpl implements AgentDriver {
               throw new Error(`tools/list exceeded ${this.config.maxListPages} pages`);
             }
             const result = await client.listTools(cursor ? { cursor } : undefined, {
-              timeout: this.config.stepTimeoutMs,
-              maxTotalTimeout: this.config.stepTimeoutMs,
+              timeout: parseDuration(this.config.stepTimeout),
+              maxTotalTimeout: parseDuration(this.config.stepTimeout),
               ...(this.abortSignal ? { signal: this.abortSignal } : {}),
             });
             tools.push(...(result.tools as ListedTool[]));
@@ -285,8 +286,8 @@ class McpProbeDriverImpl implements AgentDriver {
             { name: step.tool, arguments: step.args },
             undefined,
             {
-              timeout: this.config.stepTimeoutMs,
-              maxTotalTimeout: this.config.stepTimeoutMs,
+              timeout: parseDuration(this.config.stepTimeout),
+              maxTotalTimeout: parseDuration(this.config.stepTimeout),
               ...(this.abortSignal ? { signal: this.abortSignal } : {}),
             },
           );