@geminixiang/mikan 1.0.0-beta.4 → 1.0.0-beta.40

package/dist/tools/sandbox.js.map

@@ -1 +1 @@
-{"version":3,"file":"sandbox.js","sourceRoot":"","sources":["../../src/tools/sandbox.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentTool } from \"@earendil-works/pi-agent-core\";\nimport { Type } from \"@sinclair/typebox\";\nimport type { DockerContainerManager, ResourceLimits } from \"../provisioner.js\";\nimport type { SandboxConfig } from \"../sandbox/index.js\";\nimport { resolveActorVaultKey } from \"../vault/routing.js\";\n\nconst sandboxSchema = Type.Object({\n  action: Type.Union([Type.Literal(\"status\"), Type.Literal(\"set\")], {\n    description: \"Use status to inspect current limits, or set to apply temporary limits.\",\n  }),\n  cpus: Type.Optional(\n    Type.String({\n      description: \"Docker CPU limit for action=set, for example '0.5', '1', or '2'.\",\n    }),\n  ),\n  memory: Type.Optional(\n    Type.String({\n      description: \"Docker memory limit for action=set, for example '512m', '1g', or '4g'.\",\n    }),\n  ),\n});\n\ntype SandboxToolParams = {\n  action: \"status\" | \"set\";\n  cpus?: string;\n  memory?: string;\n};\n\ninterface SandboxToolContext {\n  userId: string;\n  conversationId: string;\n}\n\ninterface SandboxToolController {\n  sandbox: SandboxConfig;\n  provisioner?: Pick<DockerContainerManager, \"getLimitStatus\" | \"setLimits\">;\n}\n\nexport function createSandboxTool(controller: SandboxToolController): {\n  tool: AgentTool<typeof sandboxSchema>;\n  setSandboxContext: (context: SandboxToolContext) => void;\n} {\n  let sandboxContext: SandboxToolContext | null = null;\n\n  const tool: AgentTool<typeof sandboxSchema> = {\n    name: \"sandbox\",\n    label: \"sandbox\",\n    description:\n      \"Inspect or temporarily set CPU/memory limits for the current managed image sandbox. Limits apply to this conversation's sandbox container and are cleared when the container stops.\",\n    parameters: sandboxSchema,\n    execute: async (_toolCallId: string, params: SandboxToolParams, signal?: AbortSignal) => {\n      if (signal?.aborted) {\n        throw new Error(\"Operation aborted\");\n      }\n      if (!sandboxContext) {\n        throw new Error(\"Sandbox context not configured\");\n      }\n      if (controller.sandbox.type !== \"image\" || !controller.provisioner) {\n        throw new Error(\"The sandbox tool only supports image:* managed sandboxes\");\n      }\n\n      const containerKey = resolveActorVaultKey(\n        controller.sandbox,\n        sandboxContext.userId,\n        sandboxContext.conversationId,\n      );\n\n      if (params.action === \"set\") {\n        const limits = normalizeLimits(params);\n        const status = await controller.provisioner.setLimits(containerKey, limits);\n        return textResult(\n          `Updated sandbox limits for ${containerKey}: ${formatLimits(status.limits)}. These temporary limits are cleared when the sandbox container stops.`,\n        );\n      }\n\n      const status = controller.provisioner.getLimitStatus(containerKey);\n      return textResult(\n        `Sandbox limits for ${containerKey}: ${formatLimits(status.limits)}${status.boosted ? \" (boosted)\" : \"\"}.`,\n      );\n    },\n  };\n\n  return {\n    tool,\n    setSandboxContext: (context: SandboxToolContext) => {\n      sandboxContext = context;\n    },\n  };\n}\n\nfunction normalizeLimits(params: SandboxToolParams): ResourceLimits {\n  const cpus = normalizeLimitValue(\"cpus\", params.cpus);\n  const memory = normalizeLimitValue(\"memory\", params.memory);\n  if (!cpus && !memory) {\n    throw new Error(\"action=set requires cpus and/or memory\");\n  }\n  return { ...(cpus ? { cpus } : {}), ...(memory ? { memory } : {}) };\n}\n\nfunction normalizeLimitValue(name: string, value: string | undefined): string | undefined {\n  if (value === undefined) return undefined;\n  const trimmed = value.trim();\n  if (!trimmed) return undefined;\n  if (!/^[A-Za-z0-9_.-]+$/.test(trimmed)) {\n    throw new Error(`${name} must not contain whitespace or shell metacharacters`);\n  }\n  return trimmed;\n}\n\nfunction formatLimits(limits: ResourceLimits | undefined): string {\n  return `CPU ${limits?.cpus ?? \"unlimited\"} / Memory ${limits?.memory ?? \"unlimited\"}`;\n}\n\nfunction textResult(text: string): {\n  content: Array<{ type: \"text\"; text: string }>;\n  details: undefined;\n} {\n  return { content: [{ type: \"text\", text }], details: undefined };\n}\n"]}
+{"version":3,"file":"sandbox.js","sourceRoot":"","sources":["../../src/tools/sandbox.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentTool } from \"@earendil-works/pi-agent-core\";\nimport { Type } from \"@sinclair/typebox\";\nimport type { SandboxConfig } from \"../sandbox/index.js\";\nimport type { ResourceLimits, SandboxResourceController } from \"../types.js\";\nimport { runtimeResourceKey } from \"../sandbox/identity.js\";\n\nconst sandboxSchema = Type.Object({\n  action: Type.Union([Type.Literal(\"status\"), Type.Literal(\"set\")], {\n    description: \"Use status to inspect current limits, or set to apply temporary limits.\",\n  }),\n  cpus: Type.Optional(\n    Type.String({\n      description: \"CPU limit for action=set, for example '0.5', '1', or '2'.\",\n    }),\n  ),\n  memory: Type.Optional(\n    Type.String({\n      description: \"Docker memory limit for action=set, for example '512m', '1g', or '4g'.\",\n    }),\n  ),\n});\n\ntype SandboxToolParams = {\n  action: \"status\" | \"set\";\n  cpus?: string;\n  memory?: string;\n};\n\ninterface SandboxToolContext {\n  userId: string;\n  conversationId: string;\n}\n\ninterface SandboxToolController {\n  sandbox: SandboxConfig;\n  resourceController?: Pick<SandboxResourceController, \"getLimitStatus\" | \"setLimits\">;\n}\n\nexport function createSandboxTool(controller: SandboxToolController): {\n  tool: AgentTool<typeof sandboxSchema>;\n  setSandboxContext: (context: SandboxToolContext) => void;\n} {\n  let sandboxContext: SandboxToolContext | null = null;\n\n  const tool: AgentTool<typeof sandboxSchema> = {\n    name: \"sandbox\",\n    label: \"sandbox\",\n    executionMode: \"sequential\",\n    description:\n      \"Inspect or temporarily set CPU/memory limits for the current managed sandbox. Limits apply to this conversation's runtime and are cleared when it stops.\",\n    parameters: sandboxSchema,\n    execute: async (_toolCallId: string, params: SandboxToolParams, signal?: AbortSignal) => {\n      if (signal?.aborted) {\n        throw new Error(\"Operation aborted\");\n      }\n      if (!sandboxContext) {\n        throw new Error(\"Sandbox context not configured\");\n      }\n      if (\n        (controller.sandbox.type !== \"image\" && controller.sandbox.type !== \"gondolin\") ||\n        !controller.resourceController\n      ) {\n        throw new Error(\"The sandbox tool only supports image:* and gondolin:* managed sandboxes\");\n      }\n\n      const containerKey = runtimeResourceKey(controller.sandbox, {\n        userId: sandboxContext.userId,\n        conversationId: sandboxContext.conversationId,\n      });\n\n      if (params.action === \"set\") {\n        const limits = normalizeLimits(params);\n        const status = await controller.resourceController.setLimits(containerKey, limits);\n        return textResult(\n          `Updated sandbox limits for ${containerKey}: ${formatLimits(status.limits)}. These temporary limits are cleared when the sandbox runtime stops.`,\n        );\n      }\n\n      const status = controller.resourceController.getLimitStatus(containerKey);\n      return textResult(\n        `Sandbox limits for ${containerKey}: ${formatLimits(status.limits)}${status.boosted ? \" (boosted)\" : \"\"}.`,\n      );\n    },\n  };\n\n  return {\n    tool,\n    setSandboxContext: (context: SandboxToolContext) => {\n      sandboxContext = context;\n    },\n  };\n}\n\nfunction normalizeLimits(params: SandboxToolParams): ResourceLimits {\n  const cpus = normalizeLimitValue(\"cpus\", params.cpus);\n  const memory = normalizeLimitValue(\"memory\", params.memory);\n  if (!cpus && !memory) {\n    throw new Error(\"action=set requires cpus and/or memory\");\n  }\n  return { ...(cpus ? { cpus } : {}), ...(memory ? { memory } : {}) };\n}\n\nfunction normalizeLimitValue(name: string, value: string | undefined): string | undefined {\n  if (value === undefined) return undefined;\n  const trimmed = value.trim();\n  if (!trimmed) return undefined;\n  if (!/^[A-Za-z0-9_.-]+$/.test(trimmed)) {\n    throw new Error(`${name} must not contain whitespace or shell metacharacters`);\n  }\n  return trimmed;\n}\n\nfunction formatLimits(limits: ResourceLimits | undefined): string {\n  return `CPU ${limits?.cpus ?? \"unlimited\"} / Memory ${limits?.memory ?? \"unlimited\"}`;\n}\n\nfunction textResult(text: string): {\n  content: Array<{ type: \"text\"; text: string }>;\n  details: undefined;\n} {\n  return { content: [{ type: \"text\", text }], details: undefined };\n}\n"]}

package/dist/tools/subagent-slots.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 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.
+ */
+/** Default process-wide ceiling on concurrently live subagent sessions. */
+export declare const DEFAULT_GLOBAL_SUBAGENT_SLOTS = 8;
+/** Async slot pool: at most `capacity` concurrent holders, FIFO waiters. */
+export declare class SubagentSlotPool {
+    readonly capacity: number;
+    private held;
+    private waiters;
+    constructor(capacity: number);
+    /** Currently held slots (for tests and capacity reporting). */
+    get inFlight(): number;
+    /**
+     * Resolve with a release function once a slot frees up. Call the release
+     * exactly once; releasing hands the slot to the oldest waiter.
+     */
+    acquire(signal?: AbortSignal): Promise<() => void>;
+    private releaser;
+}
+/** A pool that never blocks — the default when no shared ceiling is wired. */
+export declare function unboundedSlotPool(): SubagentSlotPool;
+//# sourceMappingURL=subagent-slots.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-slots.d.ts","sourceRoot":"","sources":["../../src/tools/subagent-slots.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,2EAA2E;AAC3E,eAAO,MAAM,6BAA6B,IAAI,CAAC;AAE/C,4EAA4E;AAC5E,qBAAa,gBAAgB;IAQf,QAAQ,CAAC,QAAQ,EAAE,MAAM;IAPrC,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,OAAO,CAIP;IAER,YAAqB,QAAQ,EAAE,MAAM,EAIpC;IAED,+DAA+D;IAC/D,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED;;;OAGG;IACG,OAAO,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAiBvD;IAED,OAAO,CAAC,QAAQ;CAcjB;AAED,8EAA8E;AAC9E,wBAAgB,iBAAiB,IAAI,gBAAgB,CAEpD"}

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;AA2HpG,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;AAsSlE,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,CA8ElC"}

package/dist/tools/subagent.js

@@ -0,0 +1,411 @@
+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 so the model can propose
+ * limits. Token requests may raise the profile allowance; the other fields can
+ * only tighten profile defaults.
+ *
+ * `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: "Sets run budget preferences. maxTokens may raise the profile allowance; other fields can only tighten profile defaults.",
+    })),
+};
+/**
+ * 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++;
+            const item = items[index];
+            if (item === undefined)
+                continue;
+            await worker(item, 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 single = ordered[0];
+                    if (single === undefined) {
+                        throw new Error("Subagent plan produced no outcome");
+                    }
+                    const { id: _id, ...result } = single;
+                    return {
+                        content: [{ type: "text", text: formatOutcome(result) }],
+                        details: result,
+                    };
+                }
+            }
+        },
+    };
+}
+//# sourceMappingURL=subagent.js.map