// agents_list tests cover subagent discovery, runtime metadata, and legacy

// runtime override handling.

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

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

import { createAgentsListTool } from "./agents-list-tool.js";

});

it("does not advertise stale allowlist-only targets as spawnable agents", async () => {

// Allowlist entries are permissions, not agent definitions; stale ids should

// not be presented as runnable subagents.

loadConfigMock.mockReturnValue({

agents: {

list: [

});

it("ignores legacy env-forced plugin runtime selections", async () => {

// Runtime selection now comes from config/model routing, not a process-wide

// legacy env override.

vi.stubEnv("OPENCLAW_AGENT_RUNTIME", "codex");

loadConfigMock.mockReturnValue({

agents: {

// Common tool helper tests cover shared parsing and media result shapes used by

// multiple agent tools.

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

import { imageResult, parseAvailableTags } from "./common.js";

});

describe("imageResult", () => {

test("stores media delivery in details.media instead of MEDIA text", async () => {

// Binary media should travel through typed content/details, not a textual

// MEDIA sentinel that providers can display or reinterpret.

const result = await imageResult({

label: "test:image",

path: "/tmp/test.png",

// Embedded gateway stub tests cover in-process gateway methods used by agent

// tools when no external gateway transport is available.

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

import { createEmbeddedCallGateway } from "./embedded-gateway-stub.js";

});

it("projects embedded chat history through the shared display projector", async () => {

// Embedded history must use the same projection path as gateway history so

// byte/message limits and display filtering stay aligned.

const rawMessages = [

{ role: "user", content: "hello" },

{ role: "assistant", content: "hi" },

});

it("infers embedded global chat history scope from agent-prefixed aliases", async () => {

// Agent-prefixed global aliases carry the target agent id even when the

// caller does not pass agentId separately.

const callGateway = createEmbeddedCallGateway();

await callGateway<{ messages: unknown[] }>({

method: "chat.history",

// Node utility tests cover node selection defaults and gateway fallback between

// current and legacy node list methods.

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

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

});

it("uses stable nodeId ordering when connectedAtMs is unavailable", () => {

// Deterministic tie-breaking keeps repeated tool calls from bouncing

// between connected nodes.

const nodes: NodeListNode[] = [

node({ nodeId: "z-node", platform: "ios", connectedAtMs: undefined }),

node({ nodeId: "a-node", platform: "android", connectedAtMs: undefined }),

describe("listNodes", () => {

it("falls back to node.pair.list only when node.list is unavailable", async () => {

// Old gateways only expose node.pair.list; newer authorization failures

// must still surface instead of being hidden by fallback.

gatewayMocks.callGatewayTool

.mockRejectedValueOnce(new Error("unknown method: node.list"))

.mockResolvedValueOnce({