// Verifies transcript repair pairs tool calls/results and sanitizes tool inputs.

import type { AgentMessage } from "openclaw/plugin-sdk/agent-core";

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

import {

]);

function getAssistantToolCallBlocks(messages: AgentMessage[]) {

// Helper inspects all legacy/current tool-call block spellings in assistant content.

const assistant = messages[0] as Extract<AgentMessage, { role: "assistant" }> | undefined;

if (!assistant || !Array.isArray(assistant.content)) {

return [] as Array<{ type?: unknown; id?: unknown; name?: unknown }>;

});

it("keeps parallel tool results when code-mode display turns arrive first", () => {

// Display-only assistant turns must not cause synthetic results before real results arrive.

const input = castAgentMessages([

{

role: "assistant",

// Verifies session write locks handle reentrancy, stale locks, and symlinked paths.

import { spawn } from "node:child_process";

import fsSync from "node:fs";

import fs from "node:fs/promises";

firstLock: { release: () => Promise<void> };

secondLock: { release: () => Promise<void> };

}) {

// Reentrant locks share one file; only the final release removes it.

await expect(fs.access(params.lockPath)).resolves.toBeUndefined();

await params.firstLock.release();

await expect(fs.access(params.lockPath)).resolves.toBeUndefined();

linkLockPath: string;

}) => Promise<void>,

) {

// Symlinked session paths must resolve to the same lock ownership boundary.

if (process.platform === "win32") {

return;

}

// Verifies sessions_spawn lifecycle hooks, binding cleanup, and gateway calls.

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

import {

createSubagentSpawnTestConfig,

let spawnSubagentDirect: typeof import("./subagent-spawn.js").spawnSubagentDirect;

function getGatewayRequests(): GatewayRequest[] {

// Gateway call list is the observable side effect for spawn orchestration.

return hoisted.callGatewayMock.mock.calls.map((call) => call[0] as GatewayRequest);

}

result: { childSessionKey?: string; error?: string },

pattern: RegExp,

): void {

// Failed child-thread binding must delete the child before agent startup.

expect(result.error).toMatch(pattern);

expect(hookRunnerMocks.runSubagentSpawned).not.toHaveBeenCalled();

expectSessionsDeleteWithoutAgentStart();

// Verifies exec shell snapshots capture safe startup state without leaking secrets.

import { spawnSync } from "node:child_process";

import fs from "node:fs";

import os from "node:os";

stateDir: string,

options: { home?: string; zdotdir?: string } = {},

): void {

// Snapshot tests mutate trusted process env, not per-command untrusted env.

process.env.OPENCLAW_STATE_DIR = stateDir;

if (options.home) {

process.env.HOME = options.home;

});

it("does not honor per-call env for selecting the snapshot state dir", async () => {

// Per-call env may be model/tool-controlled, so snapshot roots come from process env.

const trustedStateDir = fs.mkdtempSync(

path.join(os.tmpdir(), "openclaw-snapshot-trusted-state-"),

);

// Verifies shell selection, PATH lookup, and platform-specific shell helpers.

import fs from "node:fs";

import os from "node:os";

import path from "node:path";

tempDirs: string[],

files: Array<{ name: string; executable?: boolean }>,

): string {

// Temporary PATH entries model available shell binaries and permissions.

const dir = fs.mkdtempSync(path.join(os.tmpdir(), "openclaw-shell-"));

tempDirs.push(dir);

for (const file of files) {

// Verifies simple-completion model selection preserves provider, model, and profile refs.

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

import type { OpenClawConfig } from "../config/config.js";

import { resolveSimpleCompletionSelectionForAgent } from "./simple-completion-runtime.js";

function requireSelection(selection: ReturnType<typeof resolveSimpleCompletionSelectionForAgent>) {

// Narrows absent selections so each case can assert parsed provider/model fields.

if (!selection) {

throw new Error("expected simple completion selection");

}