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

import { createSubagentsTool } from "./subagents-tool.js";

describe("subagents tool", () => {

it("does not advertise sessions_yield as unconditionally available", () => {

const tool = createSubagentsTool();

expect(tool.description).toContain("If sessions_yield is available");

expect(tool.description).not.toContain("Use sessions_yield to wait");

});

});

label: "Subagents",

name: "subagents",

description:

"On-demand list, kill, or steer spawned sub-agents for this requester session. Use sessions_yield to wait for completion events; do not poll this tool in wait loops.",

"On-demand list, kill, or steer spawned sub-agents for this requester session. If sessions_yield is available, use it to wait for completion events; do not poll this tool in wait loops.",

parameters: SubagentsToolSchema,

execute: async (_toolCallId, args) => {

const params = args as Record<string, unknown>;

expectResolvedRunId(runs, "copy_", "run-review-2");

});

it("preserves exact label targets before taskName prefix aliases", () => {

const runs = [

makeRun({ runId: "run-review-label", label: "review" }),

makeRun({ runId: "run-review-docs", label: "docs", taskName: "review_docs" }),

];

expectResolvedRunId(runs, "review", "run-review-label");

expectResolvedRunId(runs, "review_", "run-review-docs");

});

it("ignores stale duplicate taskName aliases when a current run reuses the handle", () => {

vi.spyOn(Date, "now").mockReturnValue(NOW_MS);

const runs = [

if (byExactAlias.length > 1) {

return { error: params.errors.ambiguousLabel(trimmed) };

}

const byAliasPrefix = numericOrder.filter((entry) =>

aliases(entry).some((alias) => normalizeLowercaseStringOrEmpty(alias).startsWith(lowered)),

);

if (byAliasPrefix.length === 1) {

return { entry: byAliasPrefix[0] };

}

if (byAliasPrefix.length > 1) {

return { error: params.errors.ambiguousLabelPrefix(trimmed) };

}

const byExactLabel = deduped.filter(

(entry) => normalizeLowercaseStringOrEmpty(params.label(entry)) === lowered,

);

if (byExactLabel.length > 1) {

return { error: params.errors.ambiguousLabel(trimmed) };

}

const byAliasPrefix = numericOrder.filter((entry) =>

aliases(entry).some((alias) => normalizeLowercaseStringOrEmpty(alias).startsWith(lowered)),

);

if (byAliasPrefix.length === 1) {

return { entry: byAliasPrefix[0] };

}

if (byAliasPrefix.length > 1) {

return { error: params.errors.ambiguousLabelPrefix(trimmed) };

}

const byLabelPrefix = deduped.filter((entry) =>

normalizeLowercaseStringOrEmpty(params.label(entry)).startsWith(lowered),

);