@schovest/pi-coding-agent 0.7.3

package/dist/core/subagents/discovery.js

@@ -0,0 +1,97 @@
+import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
+import { basename, dirname, join } from "node:path";
+import { parseFrontmatter } from "../../utils/frontmatter.js";
+const VALID_THINKING = new Set(["off", "minimal", "low", "medium", "high", "xhigh"]);
+const BUILT_IN_SUBAGENTS = [
+    {
+        name: "explorer",
+        description: "Fast parallel search for discovery. Returns locations and summaries, not full content.",
+        prompt: "You are an explorer subagent. Run parallel searches to discover files, patterns, or facts. Return only locations and concise summaries — never full file contents. Use when the main agent needs to find something but doesn't know where. Cost-optimized: prefer lightweight queries, stop early when found. Delegate to this subagent when discovery is needed; handle known paths directly in the main agent.",
+        scope: "builtin",
+        thinking: "low",
+        includedTools: ["read", "grep", "find", "ls"],
+    },
+    {
+        name: "worker",
+        description: "Execute a unit-scoped task with full tool access. Independent execution sandbox.",
+        prompt: "You are a worker subagent. Execute the assigned unit-scoped task with full tool access. Work independently, keep changes focused, and report results with evidence. Suitable for any bounded task: file operations, shell commands, data processing, or multi-step workflows. Not limited to code — handle any concrete task the main agent delegates.",
+        scope: "builtin",
+        includedTools: ["read", "bash", "edit", "write", "grep", "find", "ls"],
+    },
+];
+function isThinkingLevel(value) {
+    return typeof value === "string" && VALID_THINKING.has(value);
+}
+function stringArray(value) {
+    if (!Array.isArray(value)) {
+        return undefined;
+    }
+    const strings = value.filter((item) => typeof item === "string" && item.trim().length > 0);
+    return strings;
+}
+function readAgentFile(path, scope) {
+    const content = readFileSync(path, "utf8");
+    const parsed = parseFrontmatter(content);
+    const name = basename(path, ".md");
+    return {
+        name,
+        description: typeof parsed.frontmatter.description === "string" ? parsed.frontmatter.description : name,
+        prompt: parsed.body,
+        scope,
+        sourcePath: path,
+        model: typeof parsed.frontmatter.model === "string" ? parsed.frontmatter.model : undefined,
+        thinking: isThinkingLevel(parsed.frontmatter.thinking) ? parsed.frontmatter.thinking : undefined,
+        includedTools: (() => {
+            const parsedIncluded = stringArray(parsed.frontmatter.includedTools);
+            const parsedLegacy = stringArray(parsed.frontmatter.tools);
+            return parsedIncluded !== undefined ? parsedIncluded : parsedLegacy;
+        })(),
+        excludedTools: stringArray(parsed.frontmatter.excludedTools),
+        skills: stringArray(parsed.frontmatter.skills),
+    };
+}
+function loadAgentDir(path, scope) {
+    if (!existsSync(path)) {
+        return [];
+    }
+    const entries = readdirSync(path, { withFileTypes: true });
+    return entries
+        .filter((entry) => entry.isFile() && entry.name.endsWith(".md"))
+        .map((entry) => readAgentFile(join(path, entry.name), scope));
+}
+function findNearestProjectSubagentsDir(cwd) {
+    let current = cwd;
+    for (;;) {
+        const candidate = join(current, ".pi", "subagents");
+        if (existsSync(candidate) && statSync(candidate).isDirectory()) {
+            return candidate;
+        }
+        const parent = dirname(current);
+        if (parent === current) {
+            return undefined;
+        }
+        current = parent;
+    }
+}
+function mergeAgents(groups) {
+    const merged = new Map();
+    for (const group of groups) {
+        for (const agent of group) {
+            merged.set(agent.name, agent);
+        }
+    }
+    return Array.from(merged.values()).sort((a, b) => a.name.localeCompare(b.name));
+}
+export function discoverSubagentsSync(options) {
+    const scope = options.scope ?? "user";
+    const builtIn = BUILT_IN_SUBAGENTS.map((agent) => ({ ...agent }));
+    const user = loadAgentDir(join(options.agentDir, "subagents"), "user");
+    const shouldLoadProject = scope === "project" || scope === "both";
+    const projectDir = shouldLoadProject ? findNearestProjectSubagentsDir(options.cwd) : undefined;
+    const project = projectDir ? loadAgentDir(projectDir, "project") : [];
+    return mergeAgents([builtIn, user, project]);
+}
+export async function discoverSubagents(options) {
+    return discoverSubagentsSync(options);
+}
+//# sourceMappingURL=discovery.js.map

package/dist/core/subagents/discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../../../src/core/subagents/discovery.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, readdirSync, readFileSync, statSync } from \"node:fs\";\nimport { basename, dirname, join } from \"node:path\";\nimport type { ThinkingLevel } from \"@schovest/pi-agent-core\";\nimport { parseFrontmatter } from \"../../utils/frontmatter.ts\";\nimport type { SubagentDefinition, SubagentDefinitionScope, SubagentScope } from \"./types.ts\";\n\ninterface AgentFrontmatter extends Record<string, unknown> {\n\tdescription?: unknown;\n\tmodel?: unknown;\n\tthinking?: unknown;\n\ttools?: unknown; // deprecated, mapped to includedTools\n\tincludedTools?: unknown;\n\texcludedTools?: unknown;\n\tskills?: unknown;\n}\n\nexport interface DiscoverSubagentsOptions {\n\tcwd: string;\n\tagentDir: string;\n\tscope?: SubagentScope;\n}\n\nconst VALID_THINKING = new Set<ThinkingLevel>([\"off\", \"minimal\", \"low\", \"medium\", \"high\", \"xhigh\"]);\n\nconst BUILT_IN_SUBAGENTS: SubagentDefinition[] = [\n\t{\n\t\tname: \"explorer\",\n\t\tdescription: \"Fast parallel search for discovery. Returns locations and summaries, not full content.\",\n\t\tprompt:\n\t\t\t\"You are an explorer subagent. Run parallel searches to discover files, patterns, or facts. Return only locations and concise summaries — never full file contents. Use when the main agent needs to find something but doesn't know where. Cost-optimized: prefer lightweight queries, stop early when found. Delegate to this subagent when discovery is needed; handle known paths directly in the main agent.\",\n\t\tscope: \"builtin\",\n\t\tthinking: \"low\",\n\t\tincludedTools: [\"read\", \"grep\", \"find\", \"ls\"],\n\t},\n\t{\n\t\tname: \"worker\",\n\t\tdescription: \"Execute a unit-scoped task with full tool access. Independent execution sandbox.\",\n\t\tprompt:\n\t\t\t\"You are a worker subagent. Execute the assigned unit-scoped task with full tool access. Work independently, keep changes focused, and report results with evidence. Suitable for any bounded task: file operations, shell commands, data processing, or multi-step workflows. Not limited to code — handle any concrete task the main agent delegates.\",\n\t\tscope: \"builtin\",\n\t\tincludedTools: [\"read\", \"bash\", \"edit\", \"write\", \"grep\", \"find\", \"ls\"],\n\t},\n];\n\nfunction isThinkingLevel(value: unknown): value is ThinkingLevel {\n\treturn typeof value === \"string\" && VALID_THINKING.has(value as ThinkingLevel);\n}\n\nfunction stringArray(value: unknown): string[] | undefined {\n\tif (!Array.isArray(value)) {\n\t\treturn undefined;\n\t}\n\tconst strings = value.filter((item): item is string => typeof item === \"string\" && item.trim().length > 0);\n\treturn strings;\n}\n\nfunction readAgentFile(path: string, scope: SubagentDefinitionScope): SubagentDefinition {\n\tconst content = readFileSync(path, \"utf8\");\n\tconst parsed = parseFrontmatter<AgentFrontmatter>(content);\n\tconst name = basename(path, \".md\");\n\treturn {\n\t\tname,\n\t\tdescription: typeof parsed.frontmatter.description === \"string\" ? parsed.frontmatter.description : name,\n\t\tprompt: parsed.body,\n\t\tscope,\n\t\tsourcePath: path,\n\t\tmodel: typeof parsed.frontmatter.model === \"string\" ? parsed.frontmatter.model : undefined,\n\t\tthinking: isThinkingLevel(parsed.frontmatter.thinking) ? parsed.frontmatter.thinking : undefined,\n\t\tincludedTools: (() => {\n\t\t\tconst parsedIncluded = stringArray(parsed.frontmatter.includedTools);\n\t\t\tconst parsedLegacy = stringArray(parsed.frontmatter.tools);\n\t\t\treturn parsedIncluded !== undefined ? parsedIncluded : parsedLegacy;\n\t\t})(),\n\t\texcludedTools: stringArray(parsed.frontmatter.excludedTools),\n\t\tskills: stringArray(parsed.frontmatter.skills),\n\t};\n}\n\nfunction loadAgentDir(path: string, scope: SubagentDefinitionScope): SubagentDefinition[] {\n\tif (!existsSync(path)) {\n\t\treturn [];\n\t}\n\tconst entries = readdirSync(path, { withFileTypes: true });\n\treturn entries\n\t\t.filter((entry) => entry.isFile() && entry.name.endsWith(\".md\"))\n\t\t.map((entry) => readAgentFile(join(path, entry.name), scope));\n}\n\nfunction findNearestProjectSubagentsDir(cwd: string): string | undefined {\n\tlet current = cwd;\n\tfor (;;) {\n\t\tconst candidate = join(current, \".pi\", \"subagents\");\n\t\tif (existsSync(candidate) && statSync(candidate).isDirectory()) {\n\t\t\treturn candidate;\n\t\t}\n\t\tconst parent = dirname(current);\n\t\tif (parent === current) {\n\t\t\treturn undefined;\n\t\t}\n\t\tcurrent = parent;\n\t}\n}\n\nfunction mergeAgents(groups: SubagentDefinition[][]): SubagentDefinition[] {\n\tconst merged = new Map<string, SubagentDefinition>();\n\tfor (const group of groups) {\n\t\tfor (const agent of group) {\n\t\t\tmerged.set(agent.name, agent);\n\t\t}\n\t}\n\treturn Array.from(merged.values()).sort((a, b) => a.name.localeCompare(b.name));\n}\n\nexport function discoverSubagentsSync(options: DiscoverSubagentsOptions): SubagentDefinition[] {\n\tconst scope = options.scope ?? \"user\";\n\tconst builtIn = BUILT_IN_SUBAGENTS.map((agent) => ({ ...agent }));\n\tconst user = loadAgentDir(join(options.agentDir, \"subagents\"), \"user\");\n\tconst shouldLoadProject = scope === \"project\" || scope === \"both\";\n\tconst projectDir = shouldLoadProject ? findNearestProjectSubagentsDir(options.cwd) : undefined;\n\tconst project = projectDir ? loadAgentDir(projectDir, \"project\") : [];\n\treturn mergeAgents([builtIn, user, project]);\n}\n\nexport async function discoverSubagents(options: DiscoverSubagentsOptions): Promise<SubagentDefinition[]> {\n\treturn discoverSubagentsSync(options);\n}\n"]}

package/dist/core/subagents/index.d.ts

@@ -0,0 +1,5 @@
+export { discoverSubagents, discoverSubagentsSync } from "./discovery.ts";
+export { runSubagents } from "./runner.ts";
+export { createSubagentToolDefinition } from "./tool.ts";
+export type { SubagentDefinition, SubagentDefinitionScope, SubagentRunEvent, SubagentRunMode, SubagentRunOptions, SubagentRunRequest, SubagentRunResult, SubagentRunStatus, SubagentScope, SubagentTask, SubagentTaskResult, } from "./types.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/subagents/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/subagents/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,4BAA4B,EAAE,MAAM,WAAW,CAAC;AACzD,YAAY,EACX,kBAAkB,EAClB,uBAAuB,EACvB,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,kBAAkB,GAClB,MAAM,YAAY,CAAC","sourcesContent":["export { discoverSubagents, discoverSubagentsSync } from \"./discovery.ts\";\nexport { runSubagents } from \"./runner.ts\";\nexport { createSubagentToolDefinition } from \"./tool.ts\";\nexport type {\n\tSubagentDefinition,\n\tSubagentDefinitionScope,\n\tSubagentRunEvent,\n\tSubagentRunMode,\n\tSubagentRunOptions,\n\tSubagentRunRequest,\n\tSubagentRunResult,\n\tSubagentRunStatus,\n\tSubagentScope,\n\tSubagentTask,\n\tSubagentTaskResult,\n} from \"./types.ts\";\n"]}

package/dist/core/subagents/index.js

@@ -0,0 +1,4 @@
+export { discoverSubagents, discoverSubagentsSync } from "./discovery.js";
+export { runSubagents } from "./runner.js";
+export { createSubagentToolDefinition } from "./tool.js";
+//# sourceMappingURL=index.js.map

package/dist/core/subagents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/subagents/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,4BAA4B,EAAE,MAAM,WAAW,CAAC","sourcesContent":["export { discoverSubagents, discoverSubagentsSync } from \"./discovery.ts\";\nexport { runSubagents } from \"./runner.ts\";\nexport { createSubagentToolDefinition } from \"./tool.ts\";\nexport type {\n\tSubagentDefinition,\n\tSubagentDefinitionScope,\n\tSubagentRunEvent,\n\tSubagentRunMode,\n\tSubagentRunOptions,\n\tSubagentRunRequest,\n\tSubagentRunResult,\n\tSubagentRunStatus,\n\tSubagentScope,\n\tSubagentTask,\n\tSubagentTaskResult,\n} from \"./types.ts\";\n"]}

package/dist/core/subagents/runner.d.ts

@@ -0,0 +1,6 @@
+import type { Model } from "@schovest/pi-ai";
+import type { AgentSession } from "../agent-session.ts";
+import type { SubagentRunOptions, SubagentRunRequest, SubagentRunResult } from "./types.ts";
+export declare function runSubagents(session: AgentSession, request: SubagentRunRequest, options?: SubagentRunOptions): Promise<SubagentRunResult>;
+export declare function modelMatches(a: Model<any> | undefined, b: Model<any> | undefined): boolean;
+//# sourceMappingURL=runner.d.ts.map

package/dist/core/subagents/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../src/core/subagents/runner.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAS,MAAM,iBAAiB,CAAC;AAEpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAIxD,OAAO,KAAK,EAGX,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EAGjB,MAAM,YAAY,CAAC;AA4ZpB,wBAAsB,YAAY,CACjC,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,kBAAkB,EAC3B,OAAO,GAAE,kBAAuB,GAC9B,OAAO,CAAC,iBAAiB,CAAC,CAyD5B;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,EAAE,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,GAAG,OAAO,CAE1F","sourcesContent":["import type { AgentMessage, ThinkingLevel } from \"@schovest/pi-agent-core\";\nimport type { Model, Usage } from \"@schovest/pi-ai\";\nimport { clampThinkingLevel, modelsAreEqual } from \"@schovest/pi-ai\";\nimport type { AgentSession } from \"../agent-session.ts\";\nimport { DEFAULT_THINKING_LEVEL } from \"../defaults.ts\";\nimport { resolveActiveSkills, resolveActiveTools } from \"../tool-matcher.ts\";\nimport { discoverSubagents } from \"./discovery.ts\";\nimport type {\n\tSubagentDefinition,\n\tSubagentRunEvent,\n\tSubagentRunOptions,\n\tSubagentRunRequest,\n\tSubagentRunResult,\n\tSubagentTask,\n\tSubagentTaskResult,\n} from \"./types.ts\";\n\nconst MAX_PARALLEL_TASKS = 8;\nconst PARALLEL_CONCURRENCY = 4;\n\ninterface ResolvedTask {\n\tindex: number;\n\tdefinition: SubagentDefinition;\n\ttask: SubagentTask;\n\ttitle: string;\n\tmodel: Model<any>;\n\tthinking: ThinkingLevel;\n\ttools: string[];\n\tskills: string[];\n\tprompt: string;\n}\n\nfunction textFromMessage(message: AgentMessage): string {\n\tif (message.role !== \"assistant\") {\n\t\treturn \"\";\n\t}\n\treturn message.content\n\t\t.filter((part) => part.type === \"text\")\n\t\t.map((part) => part.text)\n\t\t.join(\"\");\n}\n\nfunction lastAssistantText(messages: AgentMessage[]): string {\n\tfor (let index = messages.length - 1; index >= 0; index--) {\n\t\tconst text = textFromMessage(messages[index]);\n\t\tif (text) {\n\t\t\treturn text;\n\t\t}\n\t}\n\treturn \"\";\n}\n\nfunction lastAssistantError(messages: AgentMessage[]): string | undefined {\n\tfor (let index = messages.length - 1; index >= 0; index--) {\n\t\tconst message = messages[index];\n\t\tif (message.role === \"assistant\" && message.errorMessage) {\n\t\t\treturn message.errorMessage;\n\t\t}\n\t}\n\treturn undefined;\n}\n\nfunction usageFromMessages(messages: AgentMessage[]): Usage | undefined {\n\tlet aggregate: Usage | undefined;\n\tfor (const message of messages) {\n\t\tif (message.role !== \"assistant\") continue;\n\t\tconst usage = message.usage;\n\t\tif (!usage) continue;\n\t\tif (!aggregate) {\n\t\t\taggregate = {\n\t\t\t\tinput: 0,\n\t\t\t\toutput: 0,\n\t\t\t\tcacheRead: 0,\n\t\t\t\tcacheWrite: 0,\n\t\t\t\ttotalTokens: 0,\n\t\t\t\tcost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },\n\t\t\t};\n\t\t}\n\t\taggregate.input += usage.input;\n\t\taggregate.output += usage.output;\n\t\taggregate.cacheRead += usage.cacheRead;\n\t\taggregate.cacheWrite += usage.cacheWrite;\n\t\taggregate.totalTokens += usage.totalTokens;\n\t\taggregate.cost.input += usage.cost.input;\n\t\taggregate.cost.output += usage.cost.output;\n\t\taggregate.cost.cacheRead += usage.cost.cacheRead;\n\t\taggregate.cost.cacheWrite += usage.cost.cacheWrite;\n\t\taggregate.cost.total += usage.cost.total;\n\t}\n\treturn aggregate;\n}\n\nfunction formatModel(model: Model<any>): string {\n\treturn `${model.provider}/${model.id}`;\n}\n\nfunction resolveModel(session: AgentSession, requested: string | undefined): Model<any> {\n\tif (requested) {\n\t\tconst slashIndex = requested.indexOf(\"/\");\n\t\tconst model =\n\t\t\tslashIndex === -1\n\t\t\t\t? session.modelRegistry.getAll().find((candidate) => candidate.id === requested)\n\t\t\t\t: session.modelRegistry.find(requested.slice(0, slashIndex), requested.slice(slashIndex + 1));\n\t\tif (!model) {\n\t\t\tthrow new Error(`Unknown subagent model: ${requested}`);\n\t\t}\n\t\treturn model;\n\t}\n\n\tconst defaultProvider = session.settingsManager.getDefaultProvider();\n\tconst defaultModel = session.settingsManager.getDefaultModel();\n\tif (defaultProvider && defaultModel) {\n\t\tconst model = session.modelRegistry.find(defaultProvider, defaultModel);\n\t\tif (model && session.modelRegistry.hasConfiguredAuth(model)) {\n\t\t\treturn model;\n\t\t}\n\t}\n\n\tif (!session.model) {\n\t\tthrow new Error(\"No model selected for subagent run\");\n\t}\n\treturn session.model;\n}\n\nfunction resolveThinking(\n\tsession: AgentSession,\n\tmodel: Model<any>,\n\ttask: SubagentTask,\n\tdefinition: SubagentDefinition,\n): ThinkingLevel {\n\tconst requested =\n\t\ttask.thinking ??\n\t\tdefinition.thinking ??\n\t\tsession.settingsManager.getDefaultThinkingLevel() ??\n\t\tDEFAULT_THINKING_LEVEL;\n\treturn clampThinkingLevel(model, requested) as ThinkingLevel;\n}\n\nfunction buildPrompt(definition: SubagentDefinition, task: string): string {\n\treturn [`You are the \"${definition.name}\" subagent.`, definition.prompt, `Task:\\n${task}`].join(\"\\n\\n\");\n}\n\nasync function resolveTask(\n\tsession: AgentSession,\n\tdefinitions: Map<string, SubagentDefinition>,\n\ttask: SubagentTask,\n\tindex: number,\n\tallToolNames: string[],\n): Promise<ResolvedTask | SubagentTaskResult> {\n\tconst definition = definitions.get(task.agent);\n\tif (!definition) {\n\t\tconst available = [...definitions.keys()].join(\", \");\n\t\treturn {\n\t\t\tindex,\n\t\t\tagent: task.agent,\n\t\t\ttask: task.task,\n\t\t\ttitle: task.title,\n\t\t\tstatus: \"failed\",\n\t\t\toutput: \"\",\n\t\t\terror: `Unknown subagent: ${task.agent}. Available: ${available}`,\n\t\t\tmessages: [],\n\t\t\tevents: [],\n\t\t};\n\t}\n\ttry {\n\t\tconst model = resolveModel(session, task.model ?? definition.model);\n\t\tconst thinking = resolveThinking(session, model, task, definition);\n\t\tconst includedTools = task.includedTools ?? definition.includedTools;\n\t\tconst excludedTools = task.excludedTools ?? definition.excludedTools;\n\t\tconst skillsPatterns = task.skills ?? definition.skills;\n\t\tconst resolvedTools = resolveActiveTools(allToolNames, includedTools, excludedTools, [\n\t\t\t\"read\",\n\t\t\t\"bash\",\n\t\t\t\"edit\",\n\t\t\t\"write\",\n\t\t]);\n\t\treturn {\n\t\t\tindex,\n\t\t\tdefinition,\n\t\t\ttask,\n\t\t\ttitle: task.title,\n\t\t\tmodel,\n\t\t\tthinking,\n\t\t\ttools: resolvedTools,\n\t\t\tskills: skillsPatterns ?? [],\n\t\t\tprompt: buildPrompt(definition, task.task),\n\t\t};\n\t} catch (error) {\n\t\treturn {\n\t\t\tindex,\n\t\t\tagent: definition.name,\n\t\t\ttask: task.task,\n\t\t\ttitle: task.title,\n\t\t\tstatus: \"failed\",\n\t\t\toutput: \"\",\n\t\t\terror: error instanceof Error ? error.message : String(error),\n\t\t\tmessages: [],\n\t\t\tevents: [],\n\t\t};\n\t}\n}\n\nfunction createEvent(\n\trunId: string,\n\tresolved: ResolvedTask,\n\tstatus: SubagentRunEvent[\"status\"],\n\toverrides: Partial<SubagentRunEvent> = {},\n): SubagentRunEvent {\n\treturn {\n\t\trunId,\n\t\tindex: resolved.index,\n\t\tagent: resolved.definition.name,\n\t\ttask: resolved.task.task,\n\t\ttitle: resolved.title,\n\t\tstatus,\n\t\tmodel: formatModel(resolved.model),\n\t\tthinking: resolved.thinking,\n\t\ttimestamp: Date.now(),\n\t\t...overrides,\n\t};\n}\n\nfunction summarizeUnknown(value: unknown, maxLength = 240): string | undefined {\n\tif (value === undefined) {\n\t\treturn undefined;\n\t}\n\ttry {\n\t\tconst text = typeof value === \"string\" ? value : JSON.stringify(value);\n\t\treturn text.length > maxLength ? `${text.slice(0, maxLength - 1)}…` : text;\n\t} catch {\n\t\treturn String(value);\n\t}\n}\n\nfunction textFromToolResult(result: unknown): string | undefined {\n\tif (!result || typeof result !== \"object\" || !(\"content\" in result)) {\n\t\treturn undefined;\n\t}\n\tconst content = (result as { content?: unknown }).content;\n\tif (!Array.isArray(content)) {\n\t\treturn undefined;\n\t}\n\tconst text = content\n\t\t.flatMap((part) => {\n\t\t\tif (!part || typeof part !== \"object\") {\n\t\t\t\treturn [];\n\t\t\t}\n\t\t\tconst candidate = part as { type?: unknown; text?: unknown };\n\t\t\treturn candidate.type === \"text\" && typeof candidate.text === \"string\" ? [candidate.text] : [];\n\t\t})\n\t\t.join(\"\\n\");\n\treturn summarizeUnknown(text);\n}\n\nfunction countToolCalls(events: SubagentRunEvent[]): number {\n\treturn events.filter((e) => e.currentTool && e.currentToolArgs).length;\n}\n\nasync function runOne(\n\tsession: AgentSession,\n\trunId: string,\n\tresolved: ResolvedTask,\n\toptions: SubagentRunOptions,\n): Promise<SubagentTaskResult> {\n\tconst events: SubagentRunEvent[] = [];\n\tconst emit = (event: SubagentRunEvent): void => {\n\t\tevents.push(event);\n\t\tsession.recordSubagentRunEvent(event);\n\t\toptions.onEvent?.(event, child);\n\t};\n\n\tconst allSkills = session.resourceLoader.getSkills().skills;\n\tconst resolvedSkills = resolveActiveSkills(allSkills, resolved.skills.length > 0 ? resolved.skills : undefined);\n\n\tconst child = session.createSubagentChildSession({\n\t\tmodel: resolved.model,\n\t\tthinkingLevel: resolved.thinking,\n\t\ttools: resolved.tools,\n\t\tskills: resolvedSkills,\n\t});\n\tconst unsubscribe = child.subscribe((event) => {\n\t\tif (event.type === \"tool_execution_start\" || event.type === \"tool_execution_update\") {\n\t\t\temit(\n\t\t\t\tcreateEvent(runId, resolved, \"running\", {\n\t\t\t\t\tcurrentTool: event.toolName,\n\t\t\t\t\tcurrentToolArgs: summarizeUnknown(event.args),\n\t\t\t\t}),\n\t\t\t);\n\t\t} else if (event.type === \"tool_execution_end\") {\n\t\t\temit(\n\t\t\t\tcreateEvent(runId, resolved, \"running\", {\n\t\t\t\t\tcurrentTool: event.toolName,\n\t\t\t\t\ttoolResultSummary: textFromToolResult(event.result),\n\t\t\t\t\terror: event.isError ? textFromToolResult(event.result) : undefined,\n\t\t\t\t}),\n\t\t\t);\n\t\t} else if (event.type === \"message_update\" && event.message.role === \"assistant\") {\n\t\t\tconst outputSummary = textFromMessage(event.message).slice(0, 240);\n\t\t\tif (outputSummary) {\n\t\t\t\temit(createEvent(runId, resolved, \"running\", { outputSummary }));\n\t\t\t}\n\t\t} else if (event.type === \"message_end\" && event.message.role === \"assistant\") {\n\t\t\tconst outputSummary = textFromMessage(event.message).slice(0, 240);\n\t\t\temit(\n\t\t\t\tcreateEvent(runId, resolved, \"running\", {\n\t\t\t\t\toutputSummary: outputSummary || undefined,\n\t\t\t\t\tusage: event.message.usage,\n\t\t\t\t}),\n\t\t\t);\n\t\t}\n\t});\n\tconst abortChild = (): void => {\n\t\tvoid child.abort();\n\t};\n\toptions.signal?.addEventListener(\"abort\", abortChild, { once: true });\n\n\temit(createEvent(runId, resolved, \"running\"));\n\ttry {\n\t\tif (options.signal?.aborted) {\n\t\t\tawait child.abort();\n\t\t} else {\n\t\t\tawait child.prompt(resolved.prompt, { expandPromptTemplates: false });\n\t\t}\n\n\t\tconst messages = [...child.messages];\n\t\tconst usage = usageFromMessages(messages);\n\t\tconst error = lastAssistantError(messages);\n\t\tconst output = lastAssistantText(messages);\n\t\tconst status = options.signal?.aborted ? \"aborted\" : error ? \"failed\" : \"success\";\n\t\temit(\n\t\t\tcreateEvent(runId, resolved, status, {\n\t\t\t\tusage,\n\t\t\t\terror,\n\t\t\t\toutputSummary: output.slice(0, 240),\n\t\t\t}),\n\t\t);\n\n\t\t// Write a reference entry in the parent session, then inline the messages\n\t\tconst subagentEntryId = session.sessionManager.appendSubagentRunEntry({\n\t\t\trunId,\n\t\t\tindex: resolved.index,\n\t\t\tagent: resolved.definition.name,\n\t\t\ttask: resolved.task.task,\n\t\t\ttitle: resolved.title,\n\t\t\tstatus,\n\t\t\tmodel: formatModel(resolved.model),\n\t\t\tthinking: resolved.thinking,\n\t\t\ttotalTokens: usage?.totalTokens,\n\t\t\ttoolCount: countToolCalls(events),\n\t\t\toutputSummary: output.slice(0, 240) || undefined,\n\t\t\terror,\n\t\t});\n\t\tsession.sessionManager.appendSubagentMessages(subagentEntryId, messages);\n\n\t\treturn {\n\t\t\tindex: resolved.index,\n\t\t\tagent: resolved.definition.name,\n\t\t\ttask: resolved.task.task,\n\t\t\ttitle: resolved.title,\n\t\t\tstatus,\n\t\t\toutput,\n\t\t\tmodel: formatModel(resolved.model),\n\t\t\tthinking: resolved.thinking,\n\t\t\tusage,\n\t\t\terror,\n\t\t\tmessages,\n\t\t\tevents,\n\t\t};\n\t} catch (error) {\n\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\tconst status = options.signal?.aborted ? \"aborted\" : \"failed\";\n\t\temit(createEvent(runId, resolved, status, { error: message }));\n\n\t\t// Write a reference entry in the parent session for failed/aborted runs, then inline the messages\n\t\tconst subagentEntryId = session.sessionManager.appendSubagentRunEntry({\n\t\t\trunId,\n\t\t\tindex: resolved.index,\n\t\t\tagent: resolved.definition.name,\n\t\t\ttask: resolved.task.task,\n\t\t\ttitle: resolved.title,\n\t\t\tstatus,\n\t\t\tmodel: formatModel(resolved.model),\n\t\t\tthinking: resolved.thinking,\n\t\t\ttoolCount: countToolCalls(events),\n\t\t\terror: message,\n\t\t});\n\t\tsession.sessionManager.appendSubagentMessages(subagentEntryId, [...child.messages]);\n\n\t\treturn {\n\t\t\tindex: resolved.index,\n\t\t\tagent: resolved.definition.name,\n\t\t\ttask: resolved.task.task,\n\t\t\ttitle: resolved.title,\n\t\t\tstatus,\n\t\t\toutput: \"\",\n\t\t\tmodel: formatModel(resolved.model),\n\t\t\tthinking: resolved.thinking,\n\t\t\terror: message,\n\t\t\tmessages: [...child.messages],\n\t\t\tevents,\n\t\t};\n\t} finally {\n\t\toptions.signal?.removeEventListener(\"abort\", abortChild);\n\t\tunsubscribe();\n\t\tchild.dispose();\n\t}\n}\n\nasync function runWithConcurrency<T>(items: T[], concurrency: number, run: (item: T) => Promise<void>): Promise<void> {\n\tlet nextIndex = 0;\n\tconst workers = Array.from({ length: Math.min(concurrency, items.length) }, async () => {\n\t\tfor (;;) {\n\t\t\tconst item = items[nextIndex];\n\t\t\tnextIndex++;\n\t\t\tif (!item) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tawait run(item);\n\t\t}\n\t});\n\tawait Promise.all(workers);\n}\n\nfunction aggregateResultUsage(results: SubagentTaskResult[]): Usage | undefined {\n\treturn usageFromMessages(results.flatMap((result) => result.messages));\n}\n\nexport async function runSubagents(\n\tsession: AgentSession,\n\trequest: SubagentRunRequest,\n\toptions: SubagentRunOptions = {},\n): Promise<SubagentRunResult> {\n\tconst mode: \"parallel\" | \"chain\" = \"chain\" in request ? \"chain\" : \"parallel\";\n\tconst tasks = \"chain\" in request ? request.chain : request.tasks;\n\n\tif (tasks.length > MAX_PARALLEL_TASKS) {\n\t\tthrow new Error(`subagent runs support at most ${MAX_PARALLEL_TASKS} tasks`);\n\t}\n\n\tconst definitions = new Map(\n\t\t(\n\t\t\tawait discoverSubagents({\n\t\t\t\tcwd: session.cwd,\n\t\t\t\tagentDir: options.agentDir ?? session.agentDir,\n\t\t\t\tscope: request.subagentScope ?? \"both\",\n\t\t\t})\n\t\t).map((definition) => [definition.name, definition]),\n\t);\n\n\tconst allToolNames = session.getAllToolNames();\n\tconst runId = `subagent:${Date.now()}:${Math.random().toString(36).slice(2)}`;\n\tlet results: SubagentTaskResult[];\n\n\tif (mode === \"chain\") {\n\t\tresults = [];\n\t\tfor (let index = 0; index < tasks.length; index++) {\n\t\t\tconst previous = results.at(-1)?.output ?? \"\";\n\t\t\tconst task = { ...tasks[index], task: tasks[index].task.replaceAll(\"{previous}\", previous) };\n\t\t\tconst resolved = await resolveTask(session, definitions, task, index, allToolNames);\n\t\t\tif (\"status\" in resolved) {\n\t\t\t\tresults.push(resolved);\n\t\t\t\tbreak;\n\t\t\t}\n\t\t\tconst result = await runOne(session, runId, resolved, options);\n\t\t\tresults.push(result);\n\t\t\tif (result.status !== \"success\") {\n\t\t\t\tbreak;\n\t\t\t}\n\t\t}\n\t} else {\n\t\tconst resolvedTasks = await Promise.all(\n\t\t\ttasks.map((task, index) => resolveTask(session, definitions, task, index, allToolNames)),\n\t\t);\n\t\tresults = new Array<SubagentTaskResult>(resolvedTasks.length);\n\t\tawait runWithConcurrency(resolvedTasks, PARALLEL_CONCURRENCY, async (resolved) => {\n\t\t\tif (\"status\" in resolved) {\n\t\t\t\tresults[resolved.index] = resolved;\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tresults[resolved.index] = await runOne(session, runId, resolved, options);\n\t\t});\n\t}\n\n\treturn {\n\t\tmode,\n\t\tresults,\n\t\tusage: aggregateResultUsage(results),\n\t};\n}\n\nexport function modelMatches(a: Model<any> | undefined, b: Model<any> | undefined): boolean {\n\treturn !!a && !!b && modelsAreEqual(a, b);\n}\n"]}

package/dist/core/subagents/runner.js

@@ -0,0 +1,406 @@
+import { clampThinkingLevel, modelsAreEqual } from "@schovest/pi-ai";
+import { DEFAULT_THINKING_LEVEL } from "../defaults.js";
+import { resolveActiveSkills, resolveActiveTools } from "../tool-matcher.js";
+import { discoverSubagents } from "./discovery.js";
+const MAX_PARALLEL_TASKS = 8;
+const PARALLEL_CONCURRENCY = 4;
+function textFromMessage(message) {
+    if (message.role !== "assistant") {
+        return "";
+    }
+    return message.content
+        .filter((part) => part.type === "text")
+        .map((part) => part.text)
+        .join("");
+}
+function lastAssistantText(messages) {
+    for (let index = messages.length - 1; index >= 0; index--) {
+        const text = textFromMessage(messages[index]);
+        if (text) {
+            return text;
+        }
+    }
+    return "";
+}
+function lastAssistantError(messages) {
+    for (let index = messages.length - 1; index >= 0; index--) {
+        const message = messages[index];
+        if (message.role === "assistant" && message.errorMessage) {
+            return message.errorMessage;
+        }
+    }
+    return undefined;
+}
+function usageFromMessages(messages) {
+    let aggregate;
+    for (const message of messages) {
+        if (message.role !== "assistant")
+            continue;
+        const usage = message.usage;
+        if (!usage)
+            continue;
+        if (!aggregate) {
+            aggregate = {
+                input: 0,
+                output: 0,
+                cacheRead: 0,
+                cacheWrite: 0,
+                totalTokens: 0,
+                cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },
+            };
+        }
+        aggregate.input += usage.input;
+        aggregate.output += usage.output;
+        aggregate.cacheRead += usage.cacheRead;
+        aggregate.cacheWrite += usage.cacheWrite;
+        aggregate.totalTokens += usage.totalTokens;
+        aggregate.cost.input += usage.cost.input;
+        aggregate.cost.output += usage.cost.output;
+        aggregate.cost.cacheRead += usage.cost.cacheRead;
+        aggregate.cost.cacheWrite += usage.cost.cacheWrite;
+        aggregate.cost.total += usage.cost.total;
+    }
+    return aggregate;
+}
+function formatModel(model) {
+    return `${model.provider}/${model.id}`;
+}
+function resolveModel(session, requested) {
+    if (requested) {
+        const slashIndex = requested.indexOf("/");
+        const model = slashIndex === -1
+            ? session.modelRegistry.getAll().find((candidate) => candidate.id === requested)
+            : session.modelRegistry.find(requested.slice(0, slashIndex), requested.slice(slashIndex + 1));
+        if (!model) {
+            throw new Error(`Unknown subagent model: ${requested}`);
+        }
+        return model;
+    }
+    const defaultProvider = session.settingsManager.getDefaultProvider();
+    const defaultModel = session.settingsManager.getDefaultModel();
+    if (defaultProvider && defaultModel) {
+        const model = session.modelRegistry.find(defaultProvider, defaultModel);
+        if (model && session.modelRegistry.hasConfiguredAuth(model)) {
+            return model;
+        }
+    }
+    if (!session.model) {
+        throw new Error("No model selected for subagent run");
+    }
+    return session.model;
+}
+function resolveThinking(session, model, task, definition) {
+    const requested = task.thinking ??
+        definition.thinking ??
+        session.settingsManager.getDefaultThinkingLevel() ??
+        DEFAULT_THINKING_LEVEL;
+    return clampThinkingLevel(model, requested);
+}
+function buildPrompt(definition, task) {
+    return [`You are the "${definition.name}" subagent.`, definition.prompt, `Task:\n${task}`].join("\n\n");
+}
+async function resolveTask(session, definitions, task, index, allToolNames) {
+    const definition = definitions.get(task.agent);
+    if (!definition) {
+        const available = [...definitions.keys()].join(", ");
+        return {
+            index,
+            agent: task.agent,
+            task: task.task,
+            title: task.title,
+            status: "failed",
+            output: "",
+            error: `Unknown subagent: ${task.agent}. Available: ${available}`,
+            messages: [],
+            events: [],
+        };
+    }
+    try {
+        const model = resolveModel(session, task.model ?? definition.model);
+        const thinking = resolveThinking(session, model, task, definition);
+        const includedTools = task.includedTools ?? definition.includedTools;
+        const excludedTools = task.excludedTools ?? definition.excludedTools;
+        const skillsPatterns = task.skills ?? definition.skills;
+        const resolvedTools = resolveActiveTools(allToolNames, includedTools, excludedTools, [
+            "read",
+            "bash",
+            "edit",
+            "write",
+        ]);
+        return {
+            index,
+            definition,
+            task,
+            title: task.title,
+            model,
+            thinking,
+            tools: resolvedTools,
+            skills: skillsPatterns ?? [],
+            prompt: buildPrompt(definition, task.task),
+        };
+    }
+    catch (error) {
+        return {
+            index,
+            agent: definition.name,
+            task: task.task,
+            title: task.title,
+            status: "failed",
+            output: "",
+            error: error instanceof Error ? error.message : String(error),
+            messages: [],
+            events: [],
+        };
+    }
+}
+function createEvent(runId, resolved, status, overrides = {}) {
+    return {
+        runId,
+        index: resolved.index,
+        agent: resolved.definition.name,
+        task: resolved.task.task,
+        title: resolved.title,
+        status,
+        model: formatModel(resolved.model),
+        thinking: resolved.thinking,
+        timestamp: Date.now(),
+        ...overrides,
+    };
+}
+function summarizeUnknown(value, maxLength = 240) {
+    if (value === undefined) {
+        return undefined;
+    }
+    try {
+        const text = typeof value === "string" ? value : JSON.stringify(value);
+        return text.length > maxLength ? `${text.slice(0, maxLength - 1)}…` : text;
+    }
+    catch {
+        return String(value);
+    }
+}
+function textFromToolResult(result) {
+    if (!result || typeof result !== "object" || !("content" in result)) {
+        return undefined;
+    }
+    const content = result.content;
+    if (!Array.isArray(content)) {
+        return undefined;
+    }
+    const text = content
+        .flatMap((part) => {
+        if (!part || typeof part !== "object") {
+            return [];
+        }
+        const candidate = part;
+        return candidate.type === "text" && typeof candidate.text === "string" ? [candidate.text] : [];
+    })
+        .join("\n");
+    return summarizeUnknown(text);
+}
+function countToolCalls(events) {
+    return events.filter((e) => e.currentTool && e.currentToolArgs).length;
+}
+async function runOne(session, runId, resolved, options) {
+    const events = [];
+    const emit = (event) => {
+        events.push(event);
+        session.recordSubagentRunEvent(event);
+        options.onEvent?.(event, child);
+    };
+    const allSkills = session.resourceLoader.getSkills().skills;
+    const resolvedSkills = resolveActiveSkills(allSkills, resolved.skills.length > 0 ? resolved.skills : undefined);
+    const child = session.createSubagentChildSession({
+        model: resolved.model,
+        thinkingLevel: resolved.thinking,
+        tools: resolved.tools,
+        skills: resolvedSkills,
+    });
+    const unsubscribe = child.subscribe((event) => {
+        if (event.type === "tool_execution_start" || event.type === "tool_execution_update") {
+            emit(createEvent(runId, resolved, "running", {
+                currentTool: event.toolName,
+                currentToolArgs: summarizeUnknown(event.args),
+            }));
+        }
+        else if (event.type === "tool_execution_end") {
+            emit(createEvent(runId, resolved, "running", {
+                currentTool: event.toolName,
+                toolResultSummary: textFromToolResult(event.result),
+                error: event.isError ? textFromToolResult(event.result) : undefined,
+            }));
+        }
+        else if (event.type === "message_update" && event.message.role === "assistant") {
+            const outputSummary = textFromMessage(event.message).slice(0, 240);
+            if (outputSummary) {
+                emit(createEvent(runId, resolved, "running", { outputSummary }));
+            }
+        }
+        else if (event.type === "message_end" && event.message.role === "assistant") {
+            const outputSummary = textFromMessage(event.message).slice(0, 240);
+            emit(createEvent(runId, resolved, "running", {
+                outputSummary: outputSummary || undefined,
+                usage: event.message.usage,
+            }));
+        }
+    });
+    const abortChild = () => {
+        void child.abort();
+    };
+    options.signal?.addEventListener("abort", abortChild, { once: true });
+    emit(createEvent(runId, resolved, "running"));
+    try {
+        if (options.signal?.aborted) {
+            await child.abort();
+        }
+        else {
+            await child.prompt(resolved.prompt, { expandPromptTemplates: false });
+        }
+        const messages = [...child.messages];
+        const usage = usageFromMessages(messages);
+        const error = lastAssistantError(messages);
+        const output = lastAssistantText(messages);
+        const status = options.signal?.aborted ? "aborted" : error ? "failed" : "success";
+        emit(createEvent(runId, resolved, status, {
+            usage,
+            error,
+            outputSummary: output.slice(0, 240),
+        }));
+        // Write a reference entry in the parent session, then inline the messages
+        const subagentEntryId = session.sessionManager.appendSubagentRunEntry({
+            runId,
+            index: resolved.index,
+            agent: resolved.definition.name,
+            task: resolved.task.task,
+            title: resolved.title,
+            status,
+            model: formatModel(resolved.model),
+            thinking: resolved.thinking,
+            totalTokens: usage?.totalTokens,
+            toolCount: countToolCalls(events),
+            outputSummary: output.slice(0, 240) || undefined,
+            error,
+        });
+        session.sessionManager.appendSubagentMessages(subagentEntryId, messages);
+        return {
+            index: resolved.index,
+            agent: resolved.definition.name,
+            task: resolved.task.task,
+            title: resolved.title,
+            status,
+            output,
+            model: formatModel(resolved.model),
+            thinking: resolved.thinking,
+            usage,
+            error,
+            messages,
+            events,
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        const status = options.signal?.aborted ? "aborted" : "failed";
+        emit(createEvent(runId, resolved, status, { error: message }));
+        // Write a reference entry in the parent session for failed/aborted runs, then inline the messages
+        const subagentEntryId = session.sessionManager.appendSubagentRunEntry({
+            runId,
+            index: resolved.index,
+            agent: resolved.definition.name,
+            task: resolved.task.task,
+            title: resolved.title,
+            status,
+            model: formatModel(resolved.model),
+            thinking: resolved.thinking,
+            toolCount: countToolCalls(events),
+            error: message,
+        });
+        session.sessionManager.appendSubagentMessages(subagentEntryId, [...child.messages]);
+        return {
+            index: resolved.index,
+            agent: resolved.definition.name,
+            task: resolved.task.task,
+            title: resolved.title,
+            status,
+            output: "",
+            model: formatModel(resolved.model),
+            thinking: resolved.thinking,
+            error: message,
+            messages: [...child.messages],
+            events,
+        };
+    }
+    finally {
+        options.signal?.removeEventListener("abort", abortChild);
+        unsubscribe();
+        child.dispose();
+    }
+}
+async function runWithConcurrency(items, concurrency, run) {
+    let nextIndex = 0;
+    const workers = Array.from({ length: Math.min(concurrency, items.length) }, async () => {
+        for (;;) {
+            const item = items[nextIndex];
+            nextIndex++;
+            if (!item) {
+                return;
+            }
+            await run(item);
+        }
+    });
+    await Promise.all(workers);
+}
+function aggregateResultUsage(results) {
+    return usageFromMessages(results.flatMap((result) => result.messages));
+}
+export async function runSubagents(session, request, options = {}) {
+    const mode = "chain" in request ? "chain" : "parallel";
+    const tasks = "chain" in request ? request.chain : request.tasks;
+    if (tasks.length > MAX_PARALLEL_TASKS) {
+        throw new Error(`subagent runs support at most ${MAX_PARALLEL_TASKS} tasks`);
+    }
+    const definitions = new Map((await discoverSubagents({
+        cwd: session.cwd,
+        agentDir: options.agentDir ?? session.agentDir,
+        scope: request.subagentScope ?? "both",
+    })).map((definition) => [definition.name, definition]));
+    const allToolNames = session.getAllToolNames();
+    const runId = `subagent:${Date.now()}:${Math.random().toString(36).slice(2)}`;
+    let results;
+    if (mode === "chain") {
+        results = [];
+        for (let index = 0; index < tasks.length; index++) {
+            const previous = results.at(-1)?.output ?? "";
+            const task = { ...tasks[index], task: tasks[index].task.replaceAll("{previous}", previous) };
+            const resolved = await resolveTask(session, definitions, task, index, allToolNames);
+            if ("status" in resolved) {
+                results.push(resolved);
+                break;
+            }
+            const result = await runOne(session, runId, resolved, options);
+            results.push(result);
+            if (result.status !== "success") {
+                break;
+            }
+        }
+    }
+    else {
+        const resolvedTasks = await Promise.all(tasks.map((task, index) => resolveTask(session, definitions, task, index, allToolNames)));
+        results = new Array(resolvedTasks.length);
+        await runWithConcurrency(resolvedTasks, PARALLEL_CONCURRENCY, async (resolved) => {
+            if ("status" in resolved) {
+                results[resolved.index] = resolved;
+                return;
+            }
+            results[resolved.index] = await runOne(session, runId, resolved, options);
+        });
+    }
+    return {
+        mode,
+        results,
+        usage: aggregateResultUsage(results),
+    };
+}
+export function modelMatches(a, b) {
+    return !!a && !!b && modelsAreEqual(a, b);
+}
+//# sourceMappingURL=runner.js.map