openclaw/src/agents/subagent-run-timeout.test.ts

// Subagent run timeout tests keep semantic deadlines separate from the maximum
// delay that Node timers can safely schedule.
import { describe, expect, it } from "vitest";
import { MAX_TIMER_TIMEOUT_MS } from "../shared/number-coercion.js";
import {
  resolveSubagentRunDeadlineMs,
  resolveSubagentRunDurationMs,
  resolveSubagentRunEffectiveEndedAt,
  resolveSubagentRunTimerDelayMs,
} from "./subagent-run-timeout.js";

describe("subagent run timeout helpers", () => {
  it("preserves semantic deadlines longer than the timer cap", () => {
    const thirtyDaysSeconds = 30 * 24 * 60 * 60;

    expect(resolveSubagentRunDurationMs(thirtyDaysSeconds)).toBe(2_592_000_000);
    expect(
      resolveSubagentRunDeadlineMs({
        createdAt: 1_000,
        runTimeoutSeconds: thirtyDaysSeconds,
      }),
    ).toBe(2_592_001_000);
  });

  it("caps actual timer delays without shortening semantic durations", () => {
    // Long-lived subagent runs retain their requested deadline even though the
    // watchdog timer must be scheduled in bounded chunks.
    const thirtyDaysSeconds = 30 * 24 * 60 * 60;

    expect(resolveSubagentRunTimerDelayMs(thirtyDaysSeconds)).toBe(MAX_TIMER_TIMEOUT_MS);
    expect(resolveSubagentRunDurationMs(thirtyDaysSeconds)).toBeGreaterThan(MAX_TIMER_TIMEOUT_MS);
  });

  it("clamps delayed terminal observations to the explicit deadline", () => {
    expect(
      resolveSubagentRunEffectiveEndedAt(
        { createdAt: 1_000, startedAt: 2_000, runTimeoutSeconds: 3 },
        6_000,
      ),
    ).toBe(5_000);
  });

  it("ignores invalid timeout seconds and invalid start timestamps", () => {
    expect(resolveSubagentRunDurationMs(Number.NaN)).toBeUndefined();
    expect(resolveSubagentRunDurationMs(0)).toBeUndefined();
    expect(
      resolveSubagentRunDeadlineMs({
        createdAt: Number.POSITIVE_INFINITY,
        runTimeoutSeconds: 60,
      }),
    ).toBeUndefined();
  });
});