// Subagent spawn test helpers install mocked runtime seams so sessions_spawn

// tests can exercise orchestration without real gateway/session-store effects.

import os from "node:os";

import { normalizeOptionalString } from "@openclaw/normalization-core/string-coerce";

import { expect, vi } from "vitest";

import type { SubagentLifecycleHookRunner } from "../plugins/hooks.js";

// Test helpers for sessions_spawn. They install a mocked runtime barrel so

// spawn tests can exercise orchestration without touching the real gateway or

// session stores.

type MockFn = (...args: unknown[]) => unknown;

type MockImplementationTarget = {

mockImplementation: (implementation: (opts: { method?: string }) => Promise<unknown>) => unknown;

resetModules?: boolean;

}): Promise<SubagentSpawnModuleForTest> {

if (params.resetModules ?? true) {

// The helper rewires module imports with vi.doMock, so each test starts from

// a fresh module graph unless explicitly sharing mocks.

// The helper rewires imports with vi.doMock, so each test starts from a

// fresh module graph unless explicitly sharing mocks.

vi.resetModules();

}

// Tool allowlist guard tests cover fail-closed behavior when explicit

// allowlists leave no callable tools for the selected runtime/model.

import { describe, expect, it } from "vitest";

import {

buildEmptyExplicitToolAllowlistError,

});

it("allows inherited config allowlists when a run intentionally disables tools", () => {

// Explicit runtime allowlists are command-time intent, while inherited

// config allowlists should not block a deliberately text-only run.

expect(

buildEmptyExplicitToolAllowlistError({

sources: [{ label: "tools.allow", entries: ["lobster", "llm-task"] }],

// Tool loop detection tests cover repeated-call hashing, ping-pong detection,

// unknown-tool thresholds, and circuit-breaker escalation.

import { describe, expect, it } from "vitest";

import type { ToolLoopDetectionConfig } from "../config/types.tools.js";

import type { SessionState } from "../logging/diagnostic-session-state.js";

count: number;

textAtIndex: (toolName: "read" | "list", index: number) => string;

}) {

// Alternating successful calls with unchanged output exercise the ping-pong

// detector independently from same-tool repetition.

for (let i = 0; i < params.count; i += 1) {

if (i % 2 === 0) {

recordSuccessfulCall(

// sessions_spawn tool tests cover model-visible schema gating, ACP/subagent

// dispatch, and result details for spawned child sessions.

import { beforeAll, beforeEach, describe, expect, it, vi } from "vitest";

const hoisted = vi.hoisted(() => {

}

it("hides ACP runtime affordances when no ACP backend is loaded", () => {

// The tool schema is generated from live runtime availability; stale ACP

// fields should not be advertised when no backend can handle them.

const tool = createSessionsSpawnTool();

const schema = tool.parameters as {

properties?: {