@geminixiang/mikan 1.0.0-beta.3 → 1.0.0-beta.30

package/dist/tools/subagent-slots.js

@@ -0,0 +1,72 @@
+/**
+ * Process-wide subagent fan-out account. The per-conversation queues
+ * serialize agent runs, and each run's subagent tool bounds its own fan-out
+ * — but without a shared ceiling, N busy conversations hold N × per-run-cap
+ * live subagent sessions. Every subagent launch draws a slot from one shared
+ * pool; the per-run cap and this global ceiling are the two bounds, enforced
+ * where each concrete subagent session is launched.
+ */
+function abortError() {
+    return new DOMException("The operation was aborted", "AbortError");
+}
+/** Default process-wide ceiling on concurrently live subagent sessions. */
+export const DEFAULT_GLOBAL_SUBAGENT_SLOTS = 8;
+/** Async slot pool: at most `capacity` concurrent holders, FIFO waiters. */
+export class SubagentSlotPool {
+    constructor(capacity) {
+        this.capacity = capacity;
+        this.held = 0;
+        this.waiters = [];
+        if (!(capacity >= 1)) {
+            throw new Error(`SubagentSlotPool capacity must be >= 1, got ${capacity}`);
+        }
+    }
+    /** Currently held slots (for tests and capacity reporting). */
+    get inFlight() {
+        return this.held;
+    }
+    /**
+     * Resolve with a release function once a slot frees up. Call the release
+     * exactly once; releasing hands the slot to the oldest waiter.
+     */
+    async acquire(signal) {
+        if (signal?.aborted)
+            throw abortError();
+        if (this.held < this.capacity) {
+            this.held += 1;
+            return this.releaser();
+        }
+        return new Promise((resolve, reject) => {
+            const waiter = { resolve, signal };
+            waiter.onAbort = () => {
+                const index = this.waiters.indexOf(waiter);
+                if (index < 0)
+                    return;
+                this.waiters.splice(index, 1);
+                reject(abortError());
+            };
+            signal?.addEventListener("abort", waiter.onAbort, { once: true });
+            this.waiters.push(waiter);
+        });
+    }
+    releaser() {
+        let released = false;
+        return () => {
+            if (released)
+                return;
+            released = true;
+            const next = this.waiters.shift();
+            if (next) {
+                next.signal?.removeEventListener("abort", next.onAbort);
+                next.resolve(this.releaser());
+                return;
+            }
+            this.held -= 1;
+        };
+    }
+}
+/** A pool that never blocks — the default when no shared ceiling is wired. */
+export function unboundedSlotPool() {
+    return new SubagentSlotPool(Number.MAX_SAFE_INTEGER);
+}
+//# sourceMappingURL=subagent-slots.js.map

package/dist/tools/subagent-slots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-slots.js","sourceRoot":"","sources":["../../src/tools/subagent-slots.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,SAAS,UAAU;IACjB,OAAO,IAAI,YAAY,CAAC,2BAA2B,EAAE,YAAY,CAAC,CAAC;AACrE,CAAC;AAED,2EAA2E;AAC3E,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC;AAE/C,4EAA4E;AAC5E,MAAM,OAAO,gBAAgB;IAQ3B,YAAqB,QAAgB;QAAhB,aAAQ,GAAR,QAAQ,CAAQ;QAP7B,SAAI,GAAG,CAAC,CAAC;QACT,YAAO,GAIV,EAAE,CAAC;QAGN,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,+CAA+C,QAAQ,EAAE,CAAC,CAAC;QAC7E,CAAC;IACH,CAAC;IAED,+DAA+D;IAC/D,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,OAAO,CAAC,MAAoB;QAChC,IAAI,MAAM,EAAE,OAAO;YAAE,MAAM,UAAU,EAAE,CAAC;QACxC,IAAI,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC9B,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC;YACf,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;QACzB,CAAC;QACD,OAAO,IAAI,OAAO,CAAa,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACjD,MAAM,MAAM,GAAkC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;YAClE,MAAM,CAAC,OAAO,GAAG,GAAG,EAAE;gBACpB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;gBAC3C,IAAI,KAAK,GAAG,CAAC;oBAAE,OAAO;gBACtB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;gBAC9B,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;YACvB,CAAC,CAAC;YACF,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAClE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,QAAQ;QACd,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,OAAO,GAAG,EAAE;YACV,IAAI,QAAQ;gBAAE,OAAO;YACrB,QAAQ,GAAG,IAAI,CAAC;YAChB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YAClC,IAAI,IAAI,EAAE,CAAC;gBACT,IAAI,CAAC,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,IAAI,CAAC,OAAQ,CAAC,CAAC;gBACzD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;gBAC9B,OAAO;YACT,CAAC;YACD,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC;QACjB,CAAC,CAAC;IACJ,CAAC;CACF;AAED,8EAA8E;AAC9E,MAAM,UAAU,iBAAiB;IAC/B,OAAO,IAAI,gBAAgB,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;AACvD,CAAC","sourcesContent":["/**\n * Process-wide subagent fan-out account. The per-conversation queues\n * serialize agent runs, and each run's subagent tool bounds its own fan-out\n * — but without a shared ceiling, N busy conversations hold N × per-run-cap\n * live subagent sessions. Every subagent launch draws a slot from one shared\n * pool; the per-run cap and this global ceiling are the two bounds, enforced\n * where each concrete subagent session is launched.\n */\n\nfunction abortError(): Error {\n  return new DOMException(\"The operation was aborted\", \"AbortError\");\n}\n\n/** Default process-wide ceiling on concurrently live subagent sessions. */\nexport const DEFAULT_GLOBAL_SUBAGENT_SLOTS = 8;\n\n/** Async slot pool: at most `capacity` concurrent holders, FIFO waiters. */\nexport class SubagentSlotPool {\n  private held = 0;\n  private waiters: Array<{\n    resolve: (release: () => void) => void;\n    signal?: AbortSignal;\n    onAbort?: () => void;\n  }> = [];\n\n  constructor(readonly capacity: number) {\n    if (!(capacity >= 1)) {\n      throw new Error(`SubagentSlotPool capacity must be >= 1, got ${capacity}`);\n    }\n  }\n\n  /** Currently held slots (for tests and capacity reporting). */\n  get inFlight(): number {\n    return this.held;\n  }\n\n  /**\n   * Resolve with a release function once a slot frees up. Call the release\n   * exactly once; releasing hands the slot to the oldest waiter.\n   */\n  async acquire(signal?: AbortSignal): Promise<() => void> {\n    if (signal?.aborted) throw abortError();\n    if (this.held < this.capacity) {\n      this.held += 1;\n      return this.releaser();\n    }\n    return new Promise<() => void>((resolve, reject) => {\n      const waiter: (typeof this.waiters)[number] = { resolve, signal };\n      waiter.onAbort = () => {\n        const index = this.waiters.indexOf(waiter);\n        if (index < 0) return;\n        this.waiters.splice(index, 1);\n        reject(abortError());\n      };\n      signal?.addEventListener(\"abort\", waiter.onAbort, { once: true });\n      this.waiters.push(waiter);\n    });\n  }\n\n  private releaser(): () => void {\n    let released = false;\n    return () => {\n      if (released) return;\n      released = true;\n      const next = this.waiters.shift();\n      if (next) {\n        next.signal?.removeEventListener(\"abort\", next.onAbort!);\n        next.resolve(this.releaser());\n        return;\n      }\n      this.held -= 1;\n    };\n  }\n}\n\n/** A pool that never blocks — the default when no shared ceiling is wired. */\nexport function unboundedSlotPool(): SubagentSlotPool {\n  return new SubagentSlotPool(Number.MAX_SAFE_INTEGER);\n}\n"]}

package/dist/tools/subagent.d.ts

@@ -0,0 +1,54 @@
+import type { AgentTool } from "@earendil-works/pi-agent-core";
+import { type TSchema } from "@sinclair/typebox";
+import type { SubagentRunOutput, SubagentRunRequest, SubagentRunResult } from "../harness/types.js";
+declare const subagentSchema: import("@sinclair/typebox").TObject<{
+    parentContext: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+        mode: import("@sinclair/typebox").TLiteral<"normalized">;
+        recentTurns: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+    }>>;
+    outputSchema: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+    budget: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+        maxTurns: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+        maxTokens: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+        maxCostUsd: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+        maxDurationMs: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+    }>>;
+    task: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    profile: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    label: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    input: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnknown>;
+    tasks: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+        task: import("@sinclair/typebox").TString;
+        profile: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        label: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        input: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnknown>;
+    }>>>;
+    dag: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+        nodes: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+            task: import("@sinclair/typebox").TString;
+            profile: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+            label: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+            input: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnknown>;
+            id: import("@sinclair/typebox").TString;
+            dependsOn: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+        }>>;
+        maxConcurrency: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+    }>>;
+}>;
+type RunSubagent = <TOutputSchema extends TSchema | undefined = undefined>(request: SubagentRunRequest<TOutputSchema>) => Promise<SubagentRunResult<SubagentRunOutput<TOutputSchema>>>;
+/** What the model needs to choose a profile: what it is, and what it can do. */
+interface SubagentProfileMenuEntry {
+    description: string;
+    tools?: string[];
+}
+/**
+ * Create the normal agent's bounded subagent delegation and DAG tool.
+ * `globalSlots` is the process-wide fan-out account shared across every
+ * conversation's tool instance; omitted, fan-out is bounded per run only.
+ *
+ * `profiles` must be non-empty: it is both the model-facing menu and the only
+ * way to grant a subagent any capability at all.
+ */
+export declare function createSubagentTool(runSubagent: RunSubagent, profiles: ReadonlyMap<string, SubagentProfileMenuEntry>): AgentTool<typeof subagentSchema>;
+export {};
+//# sourceMappingURL=subagent.d.ts.map

package/dist/tools/subagent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent.d.ts","sourceRoot":"","sources":["../../src/tools/subagent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAA2B,MAAM,+BAA+B,CAAC;AACxF,OAAO,EAAqB,KAAK,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAuHpG,QAAA,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAA0B,CAAC;AAM/C,KAAK,WAAW,GAAG,CAAC,aAAa,SAAS,OAAO,GAAG,SAAS,GAAG,SAAS,EACvE,OAAO,EAAE,kBAAkB,CAAC,aAAa,CAAC,KACvC,OAAO,CAAC,iBAAiB,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;AAoSlE,gFAAgF;AAChF,UAAU,wBAAwB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAyBD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,wBAAwB,CAAC,GACtD,SAAS,CAAC,OAAO,cAAc,CAAC,CA0ElC"}

package/dist/tools/subagent.js

@@ -0,0 +1,401 @@
+import { Type } from "@sinclair/typebox";
+import { boundSubagentProgressNode, clampSubagentLabel } from "../subagent-progress.js";
+const MAX_DAG_NODES = 8;
+const MAX_DAG_EDGES = 16;
+const MAX_DAG_DEPTH = 4;
+const MAX_CONCURRENT_SUBAGENTS = 4;
+const MAX_DEPENDENCY_OUTPUT_CHARS = 4000;
+/**
+ * Every subagent runs under a named profile: the profile owns the prompt,
+ * tool grant, model and budget defaults. Letting the model assemble those
+ * per call proved unstable, so the schema deliberately exposes no
+ * `systemPrompt`, `tools` or `model` escape hatch — narrowing what the model
+ * can get wrong is the point. `budget` survives because it can only tighten
+ * the profile's defaults, never widen them.
+ *
+ * `profileNames` is baked into the schema as an enum to steer the model's
+ * choice. TypeBox does not check `enum` on a string, so an unknown name still
+ * reaches `validatePlanProfiles`, which names the available profiles.
+ */
+function buildTaskProperties(profileNames) {
+    return {
+        task: Type.String({ minLength: 1, description: "Self-contained task for a fresh subagent." }),
+        profile: Type.Optional(Type.String({
+            enum: profileNames,
+            description: "Profile this subagent runs under. Required, but a top-level profile covers every task and DAG node that does not set its own.",
+        })),
+        // No length bound: a label is a display string, and `taskLabel` clamps it.
+        // Bounding it in the schema only lets a cosmetic field reject a whole DAG,
+        // and validation reports that failure by echoing every node back.
+        label: Type.Optional(Type.String({ description: "Short progress label for this subagent." })),
+        input: Type.Optional(Type.Unknown({ description: "Optional JSON-serializable structured input for the task." })),
+    };
+}
+const sharedProperties = {
+    parentContext: Type.Optional(Type.Object({
+        mode: Type.Literal("normalized"),
+        recentTurns: Type.Optional(Type.Integer({ minimum: 1, maximum: 8, default: 3 })),
+    })),
+    outputSchema: Type.Optional(Type.Record(Type.String(), Type.Unknown(), {
+        description: "Optional TypeBox/JSON Schema applied to every subagent result.",
+    })),
+    budget: Type.Optional(Type.Object({
+        maxTurns: Type.Optional(Type.Integer({ minimum: 1 })),
+        maxTokens: Type.Optional(Type.Integer({ minimum: 1 })),
+        maxCostUsd: Type.Optional(Type.Number({ minimum: 0 })),
+        maxDurationMs: Type.Optional(Type.Integer({ minimum: 1 })),
+    }, { description: "Tightens the profile's budget defaults; cannot raise them." })),
+};
+/**
+ * The runtime schema varies only in the `profile` enum, so every instance
+ * shares one static type and `subagentSchema` below can stand in for it.
+ */
+function buildSubagentSchema(profileNames) {
+    const taskProperties = buildTaskProperties(profileNames);
+    return Type.Object({
+        task: Type.Optional(taskProperties.task),
+        profile: taskProperties.profile,
+        label: taskProperties.label,
+        input: taskProperties.input,
+        tasks: Type.Optional(Type.Array(Type.Object(taskProperties), {
+            minItems: 1,
+            maxItems: MAX_DAG_NODES,
+            description: "Independent subagent tasks executed concurrently; results preserve input order.",
+        })),
+        dag: Type.Optional(Type.Object({
+            nodes: Type.Array(Type.Object({
+                id: Type.String({
+                    pattern: "^[A-Za-z0-9_-]+$",
+                    maxLength: 64,
+                    description: "Unique stable node id used by dependsOn.",
+                }),
+                ...taskProperties,
+                dependsOn: Type.Optional(Type.Array(Type.String(), { maxItems: MAX_DAG_NODES })),
+            }), { minItems: 1, maxItems: MAX_DAG_NODES }),
+            maxConcurrency: Type.Optional(Type.Integer({
+                minimum: 1,
+                maximum: MAX_CONCURRENT_SUBAGENTS,
+                default: MAX_CONCURRENT_SUBAGENTS,
+            })),
+        })),
+        ...sharedProperties,
+    }, { description: "Provide task, tasks, or dag." });
+}
+const subagentSchema = buildSubagentSchema([]);
+class SubagentProgressTracker {
+    constructor(mode, items, onUpdate) {
+        this.mode = mode;
+        this.items = items;
+        this.onUpdate = onUpdate;
+        this.states = new Map();
+        this.metrics = new Map();
+        for (const item of items)
+            this.states.set(item.id, "pending");
+    }
+    update(id, status, metrics) {
+        this.states.set(id, status);
+        if (metrics)
+            this.metrics.set(id, metrics);
+        this.emit();
+    }
+    emit() {
+        if (!this.onUpdate)
+            return;
+        const nodes = this.items.map((item) => boundSubagentProgressNode({
+            ...item,
+            status: this.states.get(item.id) ?? "pending",
+            ...this.metrics.get(item.id),
+        }));
+        this.onUpdate({
+            content: [],
+            details: { progress: { mode: this.mode, nodes } },
+        });
+    }
+}
+function taskLabel(task, fallback) {
+    return clampSubagentLabel(task.label?.trim() || task.task.trim().slice(0, 48) || fallback);
+}
+function formatOutcome(outcome) {
+    if (outcome.status === "budget_exceeded") {
+        return `Subagent stopped: budget limit exceeded${outcome.error ? ` (${outcome.error})` : ""}`;
+    }
+    if (outcome.status !== "completed") {
+        return `Subagent ${outcome.status}${outcome.error ? `: ${outcome.error}` : ""}`;
+    }
+    return typeof outcome.output === "string"
+        ? outcome.output
+        : JSON.stringify(outcome.output, null, 2);
+}
+function buildRequest(task, shared, signal) {
+    const outputSchema = shared.outputSchema;
+    return {
+        task: task.task,
+        ...(task.profile ? { profile: task.profile } : {}),
+        ...(task.input !== undefined ? { input: task.input } : {}),
+        ...(shared.parentContext ? { parentContext: shared.parentContext } : {}),
+        ...(outputSchema ? { outputSchema } : {}),
+        ...(shared.budget ? { budget: shared.budget } : {}),
+        ...(signal ? { signal } : {}),
+    };
+}
+function buildDagWaves(nodes) {
+    if (nodes.length === 0 || nodes.length > MAX_DAG_NODES) {
+        throw new Error(`Subagent DAG must contain 1-${MAX_DAG_NODES} nodes`);
+    }
+    const byId = new Map();
+    let edgeCount = 0;
+    for (const node of nodes) {
+        if (!/^[A-Za-z0-9_-]{1,64}$/.test(node.id)) {
+            throw new Error(`Invalid subagent DAG node id: ${node.id}`);
+        }
+        if (byId.has(node.id))
+            throw new Error(`Duplicate subagent DAG node id: ${node.id}`);
+        byId.set(node.id, node);
+        const dependencies = new Set(node.dependsOn ?? []);
+        if (dependencies.size !== (node.dependsOn?.length ?? 0)) {
+            throw new Error(`Duplicate dependency on subagent DAG node: ${node.id}`);
+        }
+        edgeCount += dependencies.size;
+    }
+    if (edgeCount > MAX_DAG_EDGES) {
+        throw new Error(`Subagent DAG exceeds ${MAX_DAG_EDGES} dependency edges`);
+    }
+    for (const node of nodes) {
+        for (const dependency of node.dependsOn ?? []) {
+            if (!byId.has(dependency)) {
+                throw new Error(`Unknown subagent DAG dependency ${dependency} for node ${node.id}`);
+            }
+            if (dependency === node.id)
+                throw new Error(`Subagent DAG node ${node.id} depends on itself`);
+        }
+    }
+    const remaining = new Set(nodes.map((node) => node.id));
+    const completed = new Set();
+    const waves = [];
+    while (remaining.size > 0) {
+        const wave = nodes.filter((node) => remaining.has(node.id) && (node.dependsOn ?? []).every((id) => completed.has(id)));
+        if (wave.length === 0)
+            throw new Error("Subagent DAG contains a cycle");
+        waves.push(wave);
+        if (waves.length > MAX_DAG_DEPTH) {
+            throw new Error(`Subagent DAG exceeds maximum depth ${MAX_DAG_DEPTH}`);
+        }
+        for (const node of wave) {
+            remaining.delete(node.id);
+            completed.add(node.id);
+        }
+    }
+    return waves;
+}
+/**
+ * A top-level `profile` is the default for every task and DAG node, like the
+ * other shared params. A fan-out that runs entirely under one profile then
+ * names it once instead of repeating it per node.
+ */
+function withDefaultProfile(task, fallback) {
+    return task.profile || !fallback ? task : { ...task, profile: fallback };
+}
+function itemForNode(node, defaultProfile) {
+    return {
+        id: node.id,
+        label: clampSubagentLabel(node.label?.trim() || node.id),
+        task: withDefaultProfile(node, defaultProfile),
+        dependsOn: node.dependsOn ?? [],
+    };
+}
+/** Normalize every tool mode into one plan: nodes, waves, concurrency. */
+function buildPlan(params) {
+    const modeCount = [params.task, params.tasks, params.dag].filter((mode) => mode !== undefined).length;
+    if (modeCount !== 1) {
+        throw new Error("Subagent requires exactly one of task, tasks, or dag");
+    }
+    if (params.dag !== undefined) {
+        const toItem = (node) => itemForNode(node, params.profile);
+        const waves = buildDagWaves(params.dag.nodes).map((wave) => wave.map(toItem));
+        const requested = params.dag.maxConcurrency ?? MAX_CONCURRENT_SUBAGENTS;
+        return {
+            mode: "dag",
+            items: params.dag.nodes.map(toItem),
+            waves,
+            concurrency: Math.max(1, Math.min(MAX_CONCURRENT_SUBAGENTS, Math.floor(requested))),
+        };
+    }
+    if (params.tasks !== undefined) {
+        const items = params.tasks.map((task, index) => ({
+            id: String(index),
+            label: taskLabel(task, String(index + 1)),
+            task: withDefaultProfile(task, params.profile),
+            dependsOn: [],
+        }));
+        return { mode: "parallel", items, waves: [items], concurrency: MAX_CONCURRENT_SUBAGENTS };
+    }
+    if (!params.task)
+        throw new Error("Subagent requires task, tasks, or dag");
+    const task = { ...params, task: params.task };
+    const item = { id: "0", label: taskLabel(task, "subagent"), task, dependsOn: [] };
+    return { mode: "single", items: [item], waves: [[item]], concurrency: 1 };
+}
+/** Run `worker` over every item with at most `limit` in flight. */
+async function forEachConcurrent(items, limit, worker) {
+    let cursor = 0;
+    await Promise.all(Array.from({ length: Math.min(limit, items.length) }, async () => {
+        while (cursor < items.length) {
+            const index = cursor++;
+            await worker(items[index], index);
+        }
+    }));
+}
+function dependencyOutput(outcome) {
+    if (outcome.status !== "completed")
+        return undefined;
+    const value = outcome.output;
+    const serialized = typeof value === "string" ? value : JSON.stringify(value);
+    if (serialized === undefined)
+        return null;
+    if (serialized.length <= MAX_DEPENDENCY_OUTPUT_CHARS)
+        return value;
+    // Oversized structured output becomes a marked string — the shape is lost,
+    // which the tool description warns downstream consumers about.
+    return `${serialized.slice(0, MAX_DEPENDENCY_OUTPUT_CHARS)}\n[truncated]`;
+}
+function planRequest(item, shared, outcomes, signal) {
+    if (item.dependsOn.length === 0)
+        return buildRequest(item.task, shared, signal);
+    const dependencies = Object.fromEntries(item.dependsOn.map((id) => [id, dependencyOutput(outcomes.get(id))]));
+    const input = {
+        ...(item.task.input !== undefined ? { input: item.task.input } : {}),
+        dependencies,
+    };
+    return buildRequest({ ...item.task, input }, shared, signal);
+}
+/**
+ * One executor for every mode: wave barriers and a per-invocation concurrency
+ * bound. Process-wide slots are acquired by the shared runner seam.
+ */
+async function runWaves(plan, shared, runSubagent, progress, signal) {
+    const outcomes = new Map();
+    for (const wave of plan.waves) {
+        await forEachConcurrent(wave, plan.concurrency, async (item) => {
+            const failedDependency = item.dependsOn.find((id) => outcomes.get(id)?.status !== "completed");
+            if (failedDependency) {
+                outcomes.set(item.id, {
+                    id: item.id,
+                    status: "skipped",
+                    error: `Dependency ${failedDependency} did not complete`,
+                });
+                progress.update(item.id, "skipped", {
+                    reason: `Dependency ${failedDependency} did not complete`,
+                });
+                return;
+            }
+            let result;
+            progress.update(item.id, "running");
+            result = await runSubagent(planRequest(item, shared, outcomes, signal));
+            outcomes.set(item.id, { id: item.id, ...result });
+            progress.update(item.id, result.status, {
+                turns: result.turns,
+                toolCalls: result.toolCalls,
+                toolCallCounts: result.toolCallCounts,
+                tokens: result.tokens,
+                costUsd: result.costUsd,
+                durationMs: result.durationMs,
+                ...(result.error ? { reason: result.error } : {}),
+                ...(result.cleanupPending ? { cleanupPending: true } : {}),
+            });
+        });
+    }
+    return plan.items.map((item) => outcomes.get(item.id));
+}
+/**
+ * The tool grant belongs in the menu. A description alone reads as a stylistic
+ * constraint, so a model will pick a no-tool profile for work that needs tools
+ * and then narrate the tool call it could not make.
+ */
+function formatToolGrant(tools) {
+    if (!tools)
+        return "tools unknown";
+    return tools.length === 0 ? "no tools" : `tools: ${tools.join(", ")}`;
+}
+function validatePlanProfiles(plan, availableProfiles) {
+    const known = [...availableProfiles].join(", ");
+    for (const item of plan.items) {
+        const profile = item.task.profile;
+        if (!profile) {
+            throw new Error(`Subagent ${item.label} must specify a profile (available: ${known})`);
+        }
+        if (!availableProfiles.has(profile)) {
+            throw new Error(`Unknown subagent profile: ${profile} (available: ${known})`);
+        }
+    }
+}
+/**
+ * Create the normal agent's bounded subagent delegation and DAG tool.
+ * `globalSlots` is the process-wide fan-out account shared across every
+ * conversation's tool instance; omitted, fan-out is bounded per run only.
+ *
+ * `profiles` must be non-empty: it is both the model-facing menu and the only
+ * way to grant a subagent any capability at all.
+ */
+export function createSubagentTool(runSubagent, profiles) {
+    if (profiles.size === 0) {
+        throw new Error("createSubagentTool requires at least one subagent profile");
+    }
+    const profileDescription = [...profiles.entries()]
+        .map(([name, profile]) => `${name} [${formatToolGrant(profile.tools)}] — ${profile.description}`)
+        .join("; ");
+    return {
+        name: "subagent",
+        label: "Subagent",
+        description: `Run fresh isolated subagents. Use task for one subagent, tasks for independent concurrent work, or dag.nodes for a bounded dependency graph. At most ${MAX_CONCURRENT_SUBAGENTS} subagents run concurrently. DAG limits: ${MAX_DAG_NODES} nodes, ${MAX_DAG_EDGES} edges, depth ${MAX_DAG_DEPTH}; failed dependencies skip descendants, and dependency outputs larger than ${MAX_DEPENDENCY_OUTPUT_CHARS} characters reach downstream nodes as a truncated string. ` +
+            "Subagents are fresh by default; parentContext.mode=normalized can include a sanitized reference snapshot of the active parent run. Nested subagents are not allowed. " +
+            `Every task and DAG node must set profile; the profile supplies the prompt, tools, model and budget. Available profiles: ${profileDescription}.`,
+        parameters: buildSubagentSchema([...profiles.keys()]),
+        execute: async (_toolCallId, params, signal, onUpdate) => {
+            const plan = buildPlan(params);
+            validatePlanProfiles(plan, new Set(profiles.keys()));
+            const progress = new SubagentProgressTracker(plan.mode, plan.items.map(({ id, label, task }) => ({ id, label, profile: task.profile })), onUpdate);
+            progress.emit();
+            const ordered = await runWaves(plan, params, runSubagent, progress, signal);
+            switch (plan.mode) {
+                case "dag":
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: ordered
+                                    .map((outcome) => `[${outcome.id}] ${formatOutcome(outcome)}`)
+                                    .join("\n\n"),
+                            },
+                        ],
+                        details: {
+                            mode: "dag",
+                            waves: plan.waves.map((wave) => wave.map((item) => item.id)),
+                            results: ordered,
+                        },
+                    };
+                case "parallel": {
+                    const results = ordered.map(({ id: _id, ...result }) => result);
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: results
+                                    .map((result, index) => `[${index + 1}] ${formatOutcome(result)}`)
+                                    .join("\n\n"),
+                            },
+                        ],
+                        details: { mode: "parallel", results },
+                    };
+                }
+                case "single": {
+                    const { id: _id, ...result } = ordered[0];
+                    return {
+                        content: [{ type: "text", text: formatOutcome(result) }],
+                        details: result,
+                    };
+                }
+            }
+        },
+    };
+}
+//# sourceMappingURL=subagent.js.map

package/dist/tools/subagent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent.js","sourceRoot":"","sources":["../../src/tools/subagent.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAA6B,MAAM,mBAAmB,CAAC;AAMpE,OAAO,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAExF,MAAM,aAAa,GAAG,CAAC,CAAC;AACxB,MAAM,aAAa,GAAG,EAAE,CAAC;AACzB,MAAM,aAAa,GAAG,CAAC,CAAC;AACxB,MAAM,wBAAwB,GAAG,CAAC,CAAC;AACnC,MAAM,2BAA2B,GAAG,IAAI,CAAC;AAEzC;;;;;;;;;;;GAWG;AACH,SAAS,mBAAmB,CAAC,YAAsB;IACjD,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,WAAW,EAAE,2CAA2C,EAAE,CAAC;QAC7F,OAAO,EAAE,IAAI,CAAC,QAAQ,CACpB,IAAI,CAAC,MAAM,CAAC;YACV,IAAI,EAAE,YAAY;YAClB,WAAW,EACT,+HAA+H;SAClI,CAAC,CACH;QACD,2EAA2E;QAC3E,2EAA2E;QAC3E,kEAAkE;QAClE,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,yCAAyC,EAAE,CAAC,CAAC;QAC7F,KAAK,EAAE,IAAI,CAAC,QAAQ,CAClB,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,2DAA2D,EAAE,CAAC,CAC3F;KACF,CAAC;AACJ,CAAC;AAED,MAAM,gBAAgB,GAAG;IACvB,aAAa,EAAE,IAAI,CAAC,QAAQ,CAC1B,IAAI,CAAC,MAAM,CAAC;QACV,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC;QAChC,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;KACjF,CAAC,CACH;IACD,YAAY,EAAE,IAAI,CAAC,QAAQ,CACzB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE;QACzC,WAAW,EAAE,gEAAgE;KAC9E,CAAC,CACH;IACD,MAAM,EAAE,IAAI,CAAC,QAAQ,CACnB,IAAI,CAAC,MAAM,CACT;QACE,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;QACrD,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;QACtD,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;QACtD,aAAa,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;KAC3D,EACD,EAAE,WAAW,EAAE,4DAA4D,EAAE,CAC9E,CACF;CACF,CAAC;AAEF;;;GAGG;AACH,SAAS,mBAAmB,CAAC,YAAsB;IACjD,MAAM,cAAc,GAAG,mBAAmB,CAAC,YAAY,CAAC,CAAC;IACzD,OAAO,IAAI,CAAC,MAAM,CAChB;QACE,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,CAAC;QACxC,OAAO,EAAE,cAAc,CAAC,OAAO;QAC/B,KAAK,EAAE,cAAc,CAAC,KAAK;QAC3B,KAAK,EAAE,cAAc,CAAC,KAAK;QAC3B,KAAK,EAAE,IAAI,CAAC,QAAQ,CAClB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,EAAE;YACtC,QAAQ,EAAE,CAAC;YACX,QAAQ,EAAE,aAAa;YACvB,WAAW,EACT,iFAAiF;SACpF,CAAC,CACH;QACD,GAAG,EAAE,IAAI,CAAC,QAAQ,CAChB,IAAI,CAAC,MAAM,CAAC;YACV,KAAK,EAAE,IAAI,CAAC,KAAK,CACf,IAAI,CAAC,MAAM,CAAC;gBACV,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC;oBACd,OAAO,EAAE,kBAAkB;oBAC3B,SAAS,EAAE,EAAE;oBACb,WAAW,EAAE,0CAA0C;iBACxD,CAAC;gBACF,GAAG,cAAc;gBACjB,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAC,CAAC;aACjF,CAAC,EACF,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,aAAa,EAAE,CACzC;YACD,cAAc,EAAE,IAAI,CAAC,QAAQ,CAC3B,IAAI,CAAC,OAAO,CAAC;gBACX,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,wBAAwB;gBACjC,OAAO,EAAE,wBAAwB;aAClC,CAAC,CACH;SACF,CAAC,CACH;QACD,GAAG,gBAAgB;KACpB,EACD,EAAE,WAAW,EAAE,8BAA8B,EAAE,CAChD,CAAC;AACJ,CAAC;AAED,MAAM,cAAc,GAAG,mBAAmB,CAAC,EAAE,CAAC,CAAC;AAkC/C,MAAM,uBAAuB;IAI3B,YACmB,IAAc,EACd,KAA6D,EAC7D,QAAkC;QAFlC,SAAI,GAAJ,IAAI,CAAU;QACd,UAAK,GAAL,KAAK,CAAwD;QAC7D,aAAQ,GAAR,QAAQ,CAA0B;QANpC,WAAM,GAAG,IAAI,GAAG,EAAkC,CAAC;QACnD,YAAO,GAAG,IAAI,GAAG,EAAmC,CAAC;QAOpE,KAAK,MAAM,IAAI,IAAI,KAAK;YAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,CAAC,EAAU,EAAE,MAA8B,EAAE,OAAiC;QAClF,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAC5B,IAAI,OAAO;YAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QAC3C,IAAI,CAAC,IAAI,EAAE,CAAC;IACd,CAAC;IAED,IAAI;QACF,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACpC,yBAAyB,CAAC;YACxB,GAAG,IAAI;YACP,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAK,SAAoC;YACzE,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;SAC7B,CAAC,CACH,CAAC;QACF,IAAI,CAAC,QAAQ,CAAC;YACZ,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;SAClD,CAAC,CAAC;IACL,CAAC;CACF;AAED,SAAS,SAAS,CAAC,IAAkB,EAAE,QAAgB;IACrD,OAAO,kBAAkB,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,QAAQ,CAAC,CAAC;AAC7F,CAAC;AAED,SAAS,aAAa,CAAC,OAItB;IACC,IAAI,OAAO,CAAC,MAAM,KAAK,iBAAiB,EAAE,CAAC;QACzC,OAAO,0CAA0C,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAChG,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QACnC,OAAO,YAAY,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAClF,CAAC;IACD,OAAO,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ;QACvC,CAAC,CAAC,OAAO,CAAC,MAAM;QAChB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,YAAY,CACnB,IAAkB,EAClB,MAAoB,EACpB,MAAoB;IAEpB,MAAM,YAAY,GAAG,MAAM,CAAC,YAAmC,CAAC;IAChE,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClD,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1D,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxE,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnD,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC9B,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,KAAgB;IACrC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,aAAa,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CAAC,+BAA+B,aAAa,QAAQ,CAAC,CAAC;IACxE,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAmB,CAAC;IACxC,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YAC3C,MAAM,IAAI,KAAK,CAAC,iCAAiC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QAC9D,CAAC;QACD,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QACrF,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QACxB,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;QACnD,IAAI,YAAY,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC,CAAC,EAAE,CAAC;YACxD,MAAM,IAAI,KAAK,CAAC,8CAA8C,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QAC3E,CAAC;QACD,SAAS,IAAI,YAAY,CAAC,IAAI,CAAC;IACjC,CAAC;IACD,IAAI,SAAS,GAAG,aAAa,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,wBAAwB,aAAa,mBAAmB,CAAC,CAAC;IAC5E,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,SAAS,IAAI,EAAE,EAAE,CAAC;YAC9C,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC1B,MAAM,IAAI,KAAK,CAAC,mCAAmC,UAAU,aAAa,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;YACvF,CAAC;YACD,IAAI,UAAU,KAAK,IAAI,CAAC,EAAE;gBAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,CAAC,EAAE,oBAAoB,CAAC,CAAC;QAChG,CAAC;IACH,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IACxD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IACpC,MAAM,KAAK,GAAgB,EAAE,CAAC;IAC9B,OAAO,SAAS,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CACvB,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAC5F,CAAC;QACF,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACxE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjB,IAAI,KAAK,CAAC,MAAM,GAAG,aAAa,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,sCAAsC,aAAa,EAAE,CAAC,CAAC;QACzE,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;YACxB,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC1B,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,SAAS,kBAAkB,CAAiC,IAAO,EAAE,QAAiB;IACpF,OAAO,IAAI,CAAC,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AAC3E,CAAC;AAED,SAAS,WAAW,CAAC,IAAa,EAAE,cAAuB;IACzD,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,KAAK,EAAE,kBAAkB,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC;QACxD,IAAI,EAAE,kBAAkB,CAAC,IAAI,EAAE,cAAc,CAAC;QAC9C,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,EAAE;KAChC,CAAC;AACJ,CAAC;AAED,0EAA0E;AAC1E,SAAS,SAAS,CAAC,MAAsB;IACvC,MAAM,SAAS,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAC9D,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,SAAS,CAC7B,CAAC,MAAM,CAAC;IACT,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAC1E,CAAC;IAED,IAAI,MAAM,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,CAAC,IAAa,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QACpE,MAAM,KAAK,GAAG,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;QAC9E,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,cAAc,IAAI,wBAAwB,CAAC;QACxE,OAAO;YACL,IAAI,EAAE,KAAK;YACX,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC;YACnC,KAAK;YACL,WAAW,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,wBAAwB,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;SACpF,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;YAC/C,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC;YACjB,KAAK,EAAE,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;YACzC,IAAI,EAAE,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC;YAC9C,SAAS,EAAE,EAAE;SACd,CAAC,CAAC,CAAC;QACJ,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,EAAE,WAAW,EAAE,wBAAwB,EAAE,CAAC;IAC5F,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3E,MAAM,IAAI,GAAG,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;IAC9C,MAAM,IAAI,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IAClF,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC;AAC5E,CAAC;AAED,mEAAmE;AACnE,KAAK,UAAU,iBAAiB,CAC9B,KAAmB,EACnB,KAAa,EACb,MAAiD;IAEjD,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,MAAM,OAAO,CAAC,GAAG,CACf,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,IAAI,EAAE;QAC/D,OAAO,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC;YACvB,MAAM,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;QACpC,CAAC;IACH,CAAC,CAAC,CACH,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAoB;IAC5C,IAAI,OAAO,CAAC,MAAM,KAAK,WAAW;QAAE,OAAO,SAAS,CAAC;IACrD,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC;IAC7B,MAAM,UAAU,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC7E,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAC1C,IAAI,UAAU,CAAC,MAAM,IAAI,2BAA2B;QAAE,OAAO,KAAK,CAAC;IACnE,2EAA2E;IAC3E,+DAA+D;IAC/D,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,2BAA2B,CAAC,eAAe,CAAC;AAC5E,CAAC;AAED,SAAS,WAAW,CAClB,IAAc,EACd,MAAoB,EACpB,QAAkC,EAClC,MAAoB;IAEpB,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAChF,MAAM,YAAY,GAAG,MAAM,CAAC,WAAW,CACrC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,gBAAgB,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAE,CAAC,CAAC,CAAC,CACtE,CAAC;IACF,MAAM,KAAK,GAAG;QACZ,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpE,YAAY;KACb,CAAC;IACF,OAAO,YAAY,CAAC,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAC/D,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,QAAQ,CACrB,IAAU,EACV,MAAoB,EACpB,WAAwB,EACxB,QAAiC,EACjC,MAAoB;IAEpB,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAuB,CAAC;IAChD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC9B,MAAM,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YAC7D,MAAM,gBAAgB,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAC1C,CAAC,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,MAAM,KAAK,WAAW,CACjD,CAAC;YACF,IAAI,gBAAgB,EAAE,CAAC;gBACrB,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE;oBACpB,EAAE,EAAE,IAAI,CAAC,EAAE;oBACX,MAAM,EAAE,SAAS;oBACjB,KAAK,EAAE,cAAc,gBAAgB,mBAAmB;iBACzD,CAAC,CAAC;gBACH,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE;oBAClC,MAAM,EAAE,cAAc,gBAAgB,mBAAmB;iBAC1D,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;YACD,IAAI,MAAkC,CAAC;YACvC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;YACpC,MAAM,GAAG,MAAM,WAAW,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;YACxE,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;YAClD,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE;gBACtC,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,cAAc,EAAE,MAAM,CAAC,cAAc;gBACrC,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACjD,GAAG,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC3D,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAE,CAAC,CAAC;AAC1D,CAAC;AAQD;;;;GAIG;AACH,SAAS,eAAe,CAAC,KAA2B;IAClD,IAAI,CAAC,KAAK;QAAE,OAAO,eAAe,CAAC;IACnC,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AACxE,CAAC;AAED,SAAS,oBAAoB,CAAC,IAAU,EAAE,iBAAsC;IAC9E,MAAM,KAAK,GAAG,CAAC,GAAG,iBAAiB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;QAClC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,YAAY,IAAI,CAAC,KAAK,uCAAuC,KAAK,GAAG,CAAC,CAAC;QACzF,CAAC;QACD,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,6BAA6B,OAAO,gBAAgB,KAAK,GAAG,CAAC,CAAC;QAChF,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAChC,WAAwB,EACxB,QAAuD;IAEvD,IAAI,QAAQ,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC/E,CAAC;IACD,MAAM,kBAAkB,GAAG,CAAC,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC;SAC/C,GAAG,CACF,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,KAAK,eAAe,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,OAAO,CAAC,WAAW,EAAE,CAC5F;SACA,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,UAAU;QACjB,WAAW,EACT,wJAAwJ,wBAAwB,4CAA4C,aAAa,WAAW,aAAa,iBAAiB,aAAa,8EAA8E,2BAA2B,4DAA4D;YACpc,uKAAuK;YACvK,2HAA2H,kBAAkB,GAAG;QAClJ,UAAU,EAAE,mBAAmB,CAAC,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QACrD,OAAO,EAAE,KAAK,EACZ,WAAmB,EACnB,MAAsB,EACtB,MAAoB,EACpB,QAAkC,EAClC,EAAE;YACF,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;YAC/B,oBAAoB,CAAC,IAAI,EAAE,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YACrD,MAAM,QAAQ,GAAG,IAAI,uBAAuB,CAC1C,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,EAC/E,QAAQ,CACT,CAAC;YACF,QAAQ,CAAC,IAAI,EAAE,CAAC;YAChB,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;YAE5E,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;gBAClB,KAAK,KAAK;oBACR,OAAO;wBACL,OAAO,EAAE;4BACP;gCACE,IAAI,EAAE,MAAM;gCACZ,IAAI,EAAE,OAAO;qCACV,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,OAAO,CAAC,EAAE,KAAK,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;qCAC7D,IAAI,CAAC,MAAM,CAAC;6BAChB;yBACF;wBACD,OAAO,EAAE;4BACP,IAAI,EAAE,KAAK;4BACX,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;4BAC5D,OAAO,EAAE,OAAO;yBACjB;qBACF,CAAC;gBACJ,KAAK,UAAU,EAAE,CAAC;oBAChB,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC;oBAChE,OAAO;wBACL,OAAO,EAAE;4BACP;gCACE,IAAI,EAAE,MAAM;gCACZ,IAAI,EAAE,OAAO;qCACV,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,KAAK,GAAG,CAAC,KAAK,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;qCACjE,IAAI,CAAC,MAAM,CAAC;6BAChB;yBACF;wBACD,OAAO,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE;qBACvC,CAAC;gBACJ,CAAC;gBACD,KAAK,QAAQ,EAAE,CAAC;oBACd,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;oBAC1C,OAAO;wBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;wBACxD,OAAO,EAAE,MAAM;qBAChB,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["import type { AgentTool, AgentToolUpdateCallback } from \"@earendil-works/pi-agent-core\";\nimport { Type, type Static, type TSchema } from \"@sinclair/typebox\";\nimport type { SubagentRunOutput, SubagentRunRequest, SubagentRunResult } from \"../harness/types.js\";\n// Progress statuses extend run statuses with the pre- and non-run states. The\n// dashboard renders the same union, so it is defined once alongside the\n// snapshot the tool emits rather than restated here.\nimport type { SubagentProgressNode, SubagentProgressStatus } from \"../types.js\";\nimport { boundSubagentProgressNode, clampSubagentLabel } from \"../subagent-progress.js\";\n\nconst MAX_DAG_NODES = 8;\nconst MAX_DAG_EDGES = 16;\nconst MAX_DAG_DEPTH = 4;\nconst MAX_CONCURRENT_SUBAGENTS = 4;\nconst MAX_DEPENDENCY_OUTPUT_CHARS = 4000;\n\n/**\n * Every subagent runs under a named profile: the profile owns the prompt,\n * tool grant, model and budget defaults. Letting the model assemble those\n * per call proved unstable, so the schema deliberately exposes no\n * `systemPrompt`, `tools` or `model` escape hatch — narrowing what the model\n * can get wrong is the point. `budget` survives because it can only tighten\n * the profile's defaults, never widen them.\n *\n * `profileNames` is baked into the schema as an enum to steer the model's\n * choice. TypeBox does not check `enum` on a string, so an unknown name still\n * reaches `validatePlanProfiles`, which names the available profiles.\n */\nfunction buildTaskProperties(profileNames: string[]) {\n  return {\n    task: Type.String({ minLength: 1, description: \"Self-contained task for a fresh subagent.\" }),\n    profile: Type.Optional(\n      Type.String({\n        enum: profileNames,\n        description:\n          \"Profile this subagent runs under. Required, but a top-level profile covers every task and DAG node that does not set its own.\",\n      }),\n    ),\n    // No length bound: a label is a display string, and `taskLabel` clamps it.\n    // Bounding it in the schema only lets a cosmetic field reject a whole DAG,\n    // and validation reports that failure by echoing every node back.\n    label: Type.Optional(Type.String({ description: \"Short progress label for this subagent.\" })),\n    input: Type.Optional(\n      Type.Unknown({ description: \"Optional JSON-serializable structured input for the task.\" }),\n    ),\n  };\n}\n\nconst sharedProperties = {\n  parentContext: Type.Optional(\n    Type.Object({\n      mode: Type.Literal(\"normalized\"),\n      recentTurns: Type.Optional(Type.Integer({ minimum: 1, maximum: 8, default: 3 })),\n    }),\n  ),\n  outputSchema: Type.Optional(\n    Type.Record(Type.String(), Type.Unknown(), {\n      description: \"Optional TypeBox/JSON Schema applied to every subagent result.\",\n    }),\n  ),\n  budget: Type.Optional(\n    Type.Object(\n      {\n        maxTurns: Type.Optional(Type.Integer({ minimum: 1 })),\n        maxTokens: Type.Optional(Type.Integer({ minimum: 1 })),\n        maxCostUsd: Type.Optional(Type.Number({ minimum: 0 })),\n        maxDurationMs: Type.Optional(Type.Integer({ minimum: 1 })),\n      },\n      { description: \"Tightens the profile's budget defaults; cannot raise them.\" },\n    ),\n  ),\n};\n\n/**\n * The runtime schema varies only in the `profile` enum, so every instance\n * shares one static type and `subagentSchema` below can stand in for it.\n */\nfunction buildSubagentSchema(profileNames: string[]) {\n  const taskProperties = buildTaskProperties(profileNames);\n  return Type.Object(\n    {\n      task: Type.Optional(taskProperties.task),\n      profile: taskProperties.profile,\n      label: taskProperties.label,\n      input: taskProperties.input,\n      tasks: Type.Optional(\n        Type.Array(Type.Object(taskProperties), {\n          minItems: 1,\n          maxItems: MAX_DAG_NODES,\n          description:\n            \"Independent subagent tasks executed concurrently; results preserve input order.\",\n        }),\n      ),\n      dag: Type.Optional(\n        Type.Object({\n          nodes: Type.Array(\n            Type.Object({\n              id: Type.String({\n                pattern: \"^[A-Za-z0-9_-]+$\",\n                maxLength: 64,\n                description: \"Unique stable node id used by dependsOn.\",\n              }),\n              ...taskProperties,\n              dependsOn: Type.Optional(Type.Array(Type.String(), { maxItems: MAX_DAG_NODES })),\n            }),\n            { minItems: 1, maxItems: MAX_DAG_NODES },\n          ),\n          maxConcurrency: Type.Optional(\n            Type.Integer({\n              minimum: 1,\n              maximum: MAX_CONCURRENT_SUBAGENTS,\n              default: MAX_CONCURRENT_SUBAGENTS,\n            }),\n          ),\n        }),\n      ),\n      ...sharedProperties,\n    },\n    { description: \"Provide task, tasks, or dag.\" },\n  );\n}\n\nconst subagentSchema = buildSubagentSchema([]);\n\ntype SubagentParams = Static<typeof subagentSchema>;\ntype SubagentTask = NonNullable<SubagentParams[\"tasks\"]>[number];\ntype DagNode = NonNullable<SubagentParams[\"dag\"]>[\"nodes\"][number];\ntype SharedParams = Pick<SubagentParams, \"parentContext\" | \"outputSchema\" | \"budget\">;\ntype RunSubagent = <TOutputSchema extends TSchema | undefined = undefined>(\n  request: SubagentRunRequest<TOutputSchema>,\n) => Promise<SubagentRunResult<SubagentRunOutput<TOutputSchema>>>;\n\ntype PlanMode = \"single\" | \"parallel\" | \"dag\";\n\n/** One planned subagent run; single and tasks modes are plans with no edges. */\ninterface PlanItem {\n  id: string;\n  label: string;\n  task: SubagentTask;\n  dependsOn: string[];\n}\n\ninterface Plan {\n  mode: PlanMode;\n  items: PlanItem[];\n  waves: PlanItem[][];\n  concurrency: number;\n}\n\ntype PlanOutcome =\n  | ({ id: string } & SubagentRunResult<unknown>)\n  | { id: string; status: \"skipped\"; error: string };\n\n/** The metrics half of a progress node — derived, not restated. */\ntype SubagentProgressMetrics = Omit<SubagentProgressNode, \"id\" | \"label\" | \"status\" | \"profile\">;\n\nclass SubagentProgressTracker {\n  private readonly states = new Map<string, SubagentProgressStatus>();\n  private readonly metrics = new Map<string, SubagentProgressMetrics>();\n\n  constructor(\n    private readonly mode: PlanMode,\n    private readonly items: Array<{ id: string; label: string; profile?: string }>,\n    private readonly onUpdate?: AgentToolUpdateCallback,\n  ) {\n    for (const item of items) this.states.set(item.id, \"pending\");\n  }\n\n  update(id: string, status: SubagentProgressStatus, metrics?: SubagentProgressMetrics): void {\n    this.states.set(id, status);\n    if (metrics) this.metrics.set(id, metrics);\n    this.emit();\n  }\n\n  emit(): void {\n    if (!this.onUpdate) return;\n    const nodes = this.items.map((item) =>\n      boundSubagentProgressNode({\n        ...item,\n        status: this.states.get(item.id) ?? (\"pending\" as SubagentProgressStatus),\n        ...this.metrics.get(item.id),\n      }),\n    );\n    this.onUpdate({\n      content: [],\n      details: { progress: { mode: this.mode, nodes } },\n    });\n  }\n}\n\nfunction taskLabel(task: SubagentTask, fallback: string): string {\n  return clampSubagentLabel(task.label?.trim() || task.task.trim().slice(0, 48) || fallback);\n}\n\nfunction formatOutcome(outcome: {\n  status: SubagentProgressStatus;\n  output?: unknown;\n  error?: string;\n}): string {\n  if (outcome.status === \"budget_exceeded\") {\n    return `Subagent stopped: budget limit exceeded${outcome.error ? ` (${outcome.error})` : \"\"}`;\n  }\n  if (outcome.status !== \"completed\") {\n    return `Subagent ${outcome.status}${outcome.error ? `: ${outcome.error}` : \"\"}`;\n  }\n  return typeof outcome.output === \"string\"\n    ? outcome.output\n    : JSON.stringify(outcome.output, null, 2);\n}\n\nfunction buildRequest(\n  task: SubagentTask,\n  shared: SharedParams,\n  signal?: AbortSignal,\n): SubagentRunRequest<TSchema | undefined> {\n  const outputSchema = shared.outputSchema as TSchema | undefined;\n  return {\n    task: task.task,\n    ...(task.profile ? { profile: task.profile } : {}),\n    ...(task.input !== undefined ? { input: task.input } : {}),\n    ...(shared.parentContext ? { parentContext: shared.parentContext } : {}),\n    ...(outputSchema ? { outputSchema } : {}),\n    ...(shared.budget ? { budget: shared.budget } : {}),\n    ...(signal ? { signal } : {}),\n  };\n}\n\nfunction buildDagWaves(nodes: DagNode[]): DagNode[][] {\n  if (nodes.length === 0 || nodes.length > MAX_DAG_NODES) {\n    throw new Error(`Subagent DAG must contain 1-${MAX_DAG_NODES} nodes`);\n  }\n  const byId = new Map<string, DagNode>();\n  let edgeCount = 0;\n  for (const node of nodes) {\n    if (!/^[A-Za-z0-9_-]{1,64}$/.test(node.id)) {\n      throw new Error(`Invalid subagent DAG node id: ${node.id}`);\n    }\n    if (byId.has(node.id)) throw new Error(`Duplicate subagent DAG node id: ${node.id}`);\n    byId.set(node.id, node);\n    const dependencies = new Set(node.dependsOn ?? []);\n    if (dependencies.size !== (node.dependsOn?.length ?? 0)) {\n      throw new Error(`Duplicate dependency on subagent DAG node: ${node.id}`);\n    }\n    edgeCount += dependencies.size;\n  }\n  if (edgeCount > MAX_DAG_EDGES) {\n    throw new Error(`Subagent DAG exceeds ${MAX_DAG_EDGES} dependency edges`);\n  }\n  for (const node of nodes) {\n    for (const dependency of node.dependsOn ?? []) {\n      if (!byId.has(dependency)) {\n        throw new Error(`Unknown subagent DAG dependency ${dependency} for node ${node.id}`);\n      }\n      if (dependency === node.id) throw new Error(`Subagent DAG node ${node.id} depends on itself`);\n    }\n  }\n\n  const remaining = new Set(nodes.map((node) => node.id));\n  const completed = new Set<string>();\n  const waves: DagNode[][] = [];\n  while (remaining.size > 0) {\n    const wave = nodes.filter(\n      (node) => remaining.has(node.id) && (node.dependsOn ?? []).every((id) => completed.has(id)),\n    );\n    if (wave.length === 0) throw new Error(\"Subagent DAG contains a cycle\");\n    waves.push(wave);\n    if (waves.length > MAX_DAG_DEPTH) {\n      throw new Error(`Subagent DAG exceeds maximum depth ${MAX_DAG_DEPTH}`);\n    }\n    for (const node of wave) {\n      remaining.delete(node.id);\n      completed.add(node.id);\n    }\n  }\n  return waves;\n}\n\n/**\n * A top-level `profile` is the default for every task and DAG node, like the\n * other shared params. A fan-out that runs entirely under one profile then\n * names it once instead of repeating it per node.\n */\nfunction withDefaultProfile<T extends { profile?: string }>(task: T, fallback?: string): T {\n  return task.profile || !fallback ? task : { ...task, profile: fallback };\n}\n\nfunction itemForNode(node: DagNode, defaultProfile?: string): PlanItem {\n  return {\n    id: node.id,\n    label: clampSubagentLabel(node.label?.trim() || node.id),\n    task: withDefaultProfile(node, defaultProfile),\n    dependsOn: node.dependsOn ?? [],\n  };\n}\n\n/** Normalize every tool mode into one plan: nodes, waves, concurrency. */\nfunction buildPlan(params: SubagentParams): Plan {\n  const modeCount = [params.task, params.tasks, params.dag].filter(\n    (mode) => mode !== undefined,\n  ).length;\n  if (modeCount !== 1) {\n    throw new Error(\"Subagent requires exactly one of task, tasks, or dag\");\n  }\n\n  if (params.dag !== undefined) {\n    const toItem = (node: DagNode) => itemForNode(node, params.profile);\n    const waves = buildDagWaves(params.dag.nodes).map((wave) => wave.map(toItem));\n    const requested = params.dag.maxConcurrency ?? MAX_CONCURRENT_SUBAGENTS;\n    return {\n      mode: \"dag\",\n      items: params.dag.nodes.map(toItem),\n      waves,\n      concurrency: Math.max(1, Math.min(MAX_CONCURRENT_SUBAGENTS, Math.floor(requested))),\n    };\n  }\n  if (params.tasks !== undefined) {\n    const items = params.tasks.map((task, index) => ({\n      id: String(index),\n      label: taskLabel(task, String(index + 1)),\n      task: withDefaultProfile(task, params.profile),\n      dependsOn: [],\n    }));\n    return { mode: \"parallel\", items, waves: [items], concurrency: MAX_CONCURRENT_SUBAGENTS };\n  }\n  if (!params.task) throw new Error(\"Subagent requires task, tasks, or dag\");\n  const task = { ...params, task: params.task };\n  const item = { id: \"0\", label: taskLabel(task, \"subagent\"), task, dependsOn: [] };\n  return { mode: \"single\", items: [item], waves: [[item]], concurrency: 1 };\n}\n\n/** Run `worker` over every item with at most `limit` in flight. */\nasync function forEachConcurrent<T>(\n  items: readonly T[],\n  limit: number,\n  worker: (item: T, index: number) => Promise<void>,\n): Promise<void> {\n  let cursor = 0;\n  await Promise.all(\n    Array.from({ length: Math.min(limit, items.length) }, async () => {\n      while (cursor < items.length) {\n        const index = cursor++;\n        await worker(items[index], index);\n      }\n    }),\n  );\n}\n\nfunction dependencyOutput(outcome: PlanOutcome): unknown {\n  if (outcome.status !== \"completed\") return undefined;\n  const value = outcome.output;\n  const serialized = typeof value === \"string\" ? value : JSON.stringify(value);\n  if (serialized === undefined) return null;\n  if (serialized.length <= MAX_DEPENDENCY_OUTPUT_CHARS) return value;\n  // Oversized structured output becomes a marked string — the shape is lost,\n  // which the tool description warns downstream consumers about.\n  return `${serialized.slice(0, MAX_DEPENDENCY_OUTPUT_CHARS)}\\n[truncated]`;\n}\n\nfunction planRequest(\n  item: PlanItem,\n  shared: SharedParams,\n  outcomes: Map<string, PlanOutcome>,\n  signal?: AbortSignal,\n): SubagentRunRequest<TSchema | undefined> {\n  if (item.dependsOn.length === 0) return buildRequest(item.task, shared, signal);\n  const dependencies = Object.fromEntries(\n    item.dependsOn.map((id) => [id, dependencyOutput(outcomes.get(id)!)]),\n  );\n  const input = {\n    ...(item.task.input !== undefined ? { input: item.task.input } : {}),\n    dependencies,\n  };\n  return buildRequest({ ...item.task, input }, shared, signal);\n}\n\n/**\n * One executor for every mode: wave barriers and a per-invocation concurrency\n * bound. Process-wide slots are acquired by the shared runner seam.\n */\nasync function runWaves(\n  plan: Plan,\n  shared: SharedParams,\n  runSubagent: RunSubagent,\n  progress: SubagentProgressTracker,\n  signal?: AbortSignal,\n): Promise<PlanOutcome[]> {\n  const outcomes = new Map<string, PlanOutcome>();\n  for (const wave of plan.waves) {\n    await forEachConcurrent(wave, plan.concurrency, async (item) => {\n      const failedDependency = item.dependsOn.find(\n        (id) => outcomes.get(id)?.status !== \"completed\",\n      );\n      if (failedDependency) {\n        outcomes.set(item.id, {\n          id: item.id,\n          status: \"skipped\",\n          error: `Dependency ${failedDependency} did not complete`,\n        });\n        progress.update(item.id, \"skipped\", {\n          reason: `Dependency ${failedDependency} did not complete`,\n        });\n        return;\n      }\n      let result: SubagentRunResult<unknown>;\n      progress.update(item.id, \"running\");\n      result = await runSubagent(planRequest(item, shared, outcomes, signal));\n      outcomes.set(item.id, { id: item.id, ...result });\n      progress.update(item.id, result.status, {\n        turns: result.turns,\n        toolCalls: result.toolCalls,\n        toolCallCounts: result.toolCallCounts,\n        tokens: result.tokens,\n        costUsd: result.costUsd,\n        durationMs: result.durationMs,\n        ...(result.error ? { reason: result.error } : {}),\n        ...(result.cleanupPending ? { cleanupPending: true } : {}),\n      });\n    });\n  }\n  return plan.items.map((item) => outcomes.get(item.id)!);\n}\n\n/** What the model needs to choose a profile: what it is, and what it can do. */\ninterface SubagentProfileMenuEntry {\n  description: string;\n  tools?: string[];\n}\n\n/**\n * The tool grant belongs in the menu. A description alone reads as a stylistic\n * constraint, so a model will pick a no-tool profile for work that needs tools\n * and then narrate the tool call it could not make.\n */\nfunction formatToolGrant(tools: string[] | undefined): string {\n  if (!tools) return \"tools unknown\";\n  return tools.length === 0 ? \"no tools\" : `tools: ${tools.join(\", \")}`;\n}\n\nfunction validatePlanProfiles(plan: Plan, availableProfiles: ReadonlySet<string>): void {\n  const known = [...availableProfiles].join(\", \");\n  for (const item of plan.items) {\n    const profile = item.task.profile;\n    if (!profile) {\n      throw new Error(`Subagent ${item.label} must specify a profile (available: ${known})`);\n    }\n    if (!availableProfiles.has(profile)) {\n      throw new Error(`Unknown subagent profile: ${profile} (available: ${known})`);\n    }\n  }\n}\n\n/**\n * Create the normal agent's bounded subagent delegation and DAG tool.\n * `globalSlots` is the process-wide fan-out account shared across every\n * conversation's tool instance; omitted, fan-out is bounded per run only.\n *\n * `profiles` must be non-empty: it is both the model-facing menu and the only\n * way to grant a subagent any capability at all.\n */\nexport function createSubagentTool(\n  runSubagent: RunSubagent,\n  profiles: ReadonlyMap<string, SubagentProfileMenuEntry>,\n): AgentTool<typeof subagentSchema> {\n  if (profiles.size === 0) {\n    throw new Error(\"createSubagentTool requires at least one subagent profile\");\n  }\n  const profileDescription = [...profiles.entries()]\n    .map(\n      ([name, profile]) => `${name} [${formatToolGrant(profile.tools)}] — ${profile.description}`,\n    )\n    .join(\"; \");\n  return {\n    name: \"subagent\",\n    label: \"Subagent\",\n    description:\n      `Run fresh isolated subagents. Use task for one subagent, tasks for independent concurrent work, or dag.nodes for a bounded dependency graph. At most ${MAX_CONCURRENT_SUBAGENTS} subagents run concurrently. DAG limits: ${MAX_DAG_NODES} nodes, ${MAX_DAG_EDGES} edges, depth ${MAX_DAG_DEPTH}; failed dependencies skip descendants, and dependency outputs larger than ${MAX_DEPENDENCY_OUTPUT_CHARS} characters reach downstream nodes as a truncated string. ` +\n      \"Subagents are fresh by default; parentContext.mode=normalized can include a sanitized reference snapshot of the active parent run. Nested subagents are not allowed. \" +\n      `Every task and DAG node must set profile; the profile supplies the prompt, tools, model and budget. Available profiles: ${profileDescription}.`,\n    parameters: buildSubagentSchema([...profiles.keys()]),\n    execute: async (\n      _toolCallId: string,\n      params: SubagentParams,\n      signal?: AbortSignal,\n      onUpdate?: AgentToolUpdateCallback,\n    ) => {\n      const plan = buildPlan(params);\n      validatePlanProfiles(plan, new Set(profiles.keys()));\n      const progress = new SubagentProgressTracker(\n        plan.mode,\n        plan.items.map(({ id, label, task }) => ({ id, label, profile: task.profile })),\n        onUpdate,\n      );\n      progress.emit();\n      const ordered = await runWaves(plan, params, runSubagent, progress, signal);\n\n      switch (plan.mode) {\n        case \"dag\":\n          return {\n            content: [\n              {\n                type: \"text\",\n                text: ordered\n                  .map((outcome) => `[${outcome.id}] ${formatOutcome(outcome)}`)\n                  .join(\"\\n\\n\"),\n              },\n            ],\n            details: {\n              mode: \"dag\",\n              waves: plan.waves.map((wave) => wave.map((item) => item.id)),\n              results: ordered,\n            },\n          };\n        case \"parallel\": {\n          const results = ordered.map(({ id: _id, ...result }) => result);\n          return {\n            content: [\n              {\n                type: \"text\",\n                text: results\n                  .map((result, index) => `[${index + 1}] ${formatOutcome(result)}`)\n                  .join(\"\\n\\n\"),\n              },\n            ],\n            details: { mode: \"parallel\", results },\n          };\n        }\n        case \"single\": {\n          const { id: _id, ...result } = ordered[0];\n          return {\n            content: [{ type: \"text\", text: formatOutcome(result) }],\n            details: result,\n          };\n        }\n      }\n    },\n  };\n}\n"]}