@wrongstack/core 0.1.7 → 0.1.8

package/dist/index.js

@@ -1383,11 +1383,11 @@ function validateAgainstSchema(value, schema) {
   walk(value, schema, "", errors);
   return { ok: errors.length === 0, errors };
 }
-function walk(value, schema, path15, errors) {
+function walk(value, schema, path17, errors) {
   if (schema.enum !== void 0) {
     if (!schema.enum.some((e) => deepEqual(e, value))) {
       errors.push({
-        path: path15 || "<root>",
+        path: path17 || "<root>",
         message: `expected one of ${JSON.stringify(schema.enum)}, got ${JSON.stringify(value)}`
       });
       return;
@@ -1396,7 +1396,7 @@ function walk(value, schema, path15, errors) {
   if (typeof schema.type === "string") {
     if (!checkType(value, schema.type)) {
       errors.push({
-        path: path15 || "<root>",
+        path: path17 || "<root>",
         message: `expected ${schema.type}, got ${describeType(value)}`
       });
       return;
@@ -1406,19 +1406,19 @@ function walk(value, schema, path15, errors) {
     const obj = value;
     for (const req of schema.required ?? []) {
       if (!(req in obj)) {
-        errors.push({ path: joinPath(path15, req), message: "required property missing" });
+        errors.push({ path: joinPath(path17, req), message: "required property missing" });
       }
     }
     if (schema.properties) {
       for (const [key, subSchema] of Object.entries(schema.properties)) {
         if (key in obj) {
-          walk(obj[key], subSchema, joinPath(path15, key), errors);
+          walk(obj[key], subSchema, joinPath(path17, key), errors);
         }
       }
     }
   }
   if (schema.type === "array" && Array.isArray(value) && schema.items) {
-    value.forEach((item, i) => walk(item, schema.items, `${path15}[${i}]`, errors));
+    value.forEach((item, i) => walk(item, schema.items, `${path17}[${i}]`, errors));
   }
 }
 function checkType(value, type) {
@@ -4710,6 +4710,182 @@ function defaultFormatTaskInput(task) {
   return task.description ?? "";
 }
 
+// src/defaults/fleet-bus.ts
+var FleetBus = class {
+  byId = /* @__PURE__ */ new Map();
+  byType = /* @__PURE__ */ new Map();
+  any = /* @__PURE__ */ new Set();
+  /**
+   * Hook a subagent's EventBus into the fleet. EventBus is strongly
+   * typed and doesn't expose an `onAny` hook, so we subscribe to the
+   * canonical set of event types a subagent emits during a run. New
+   * event types added to the kernel must be added here too — but the
+   * cost is a tiny single line per type, and the explicit list keeps
+   * the wire format clear.
+   *
+   * Returns a disposer that detaches every subscription; call on
+   * subagent teardown so the listeners don't outlive the run.
+   */
+  attach(subagentId, bus, taskId) {
+    const FORWARDED_TYPES = [
+      "tool.started",
+      "tool.executed",
+      "tool.progress",
+      "tool.confirm_needed",
+      "iteration.started",
+      "iteration.completed",
+      "provider.text_delta",
+      "provider.response",
+      "provider.retry",
+      "provider.error",
+      "session.started",
+      "session.ended",
+      "token.threshold"
+    ];
+    const offs = [];
+    for (const t2 of FORWARDED_TYPES) {
+      offs.push(
+        bus.on(t2, (payload) => {
+          this.emit({ subagentId, taskId, ts: Date.now(), type: t2, payload });
+        })
+      );
+    }
+    return () => {
+      for (const off of offs) off();
+    };
+  }
+  /** Subscribe to every event from one subagent. */
+  subscribe(subagentId, handler) {
+    let set = this.byId.get(subagentId);
+    if (!set) {
+      set = /* @__PURE__ */ new Set();
+      this.byId.set(subagentId, set);
+    }
+    set.add(handler);
+    return () => {
+      set.delete(handler);
+    };
+  }
+  /** Subscribe to one event type across all subagents. */
+  filter(type, handler) {
+    let set = this.byType.get(type);
+    if (!set) {
+      set = /* @__PURE__ */ new Set();
+      this.byType.set(type, set);
+    }
+    set.add(handler);
+    return () => {
+      set.delete(handler);
+    };
+  }
+  /** Subscribe to literally everything. The fleet roll-up uses this. */
+  onAny(handler) {
+    this.any.add(handler);
+    return () => {
+      this.any.delete(handler);
+    };
+  }
+  emit(event) {
+    const byId = this.byId.get(event.subagentId);
+    if (byId) for (const h of byId) {
+      try {
+        h(event);
+      } catch {
+      }
+    }
+    const byType = this.byType.get(event.type);
+    if (byType) for (const h of byType) {
+      try {
+        h(event);
+      } catch {
+      }
+    }
+    for (const h of this.any) {
+      try {
+        h(event);
+      } catch {
+      }
+    }
+  }
+};
+var FleetUsageAggregator = class {
+  constructor(bus, priceLookup, metaLookup) {
+    this.bus = bus;
+    this.priceLookup = priceLookup;
+    this.metaLookup = metaLookup;
+    bus.filter("provider.response", (e) => this.onProviderResponse(e));
+    bus.filter("tool.executed", (e) => this.onToolExecuted(e));
+    bus.filter("iteration.started", (e) => this.onIterationStarted(e));
+  }
+  bus;
+  priceLookup;
+  metaLookup;
+  perSubagent = /* @__PURE__ */ new Map();
+  total = { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, cost: 0 };
+  /** Live snapshot — safe to call from a tool's execute() body. */
+  snapshot() {
+    return {
+      total: { ...this.total },
+      perSubagent: Object.fromEntries(
+        Array.from(this.perSubagent.entries()).map(([k, v]) => [k, { ...v }])
+      )
+    };
+  }
+  ensure(subagentId) {
+    let snap = this.perSubagent.get(subagentId);
+    if (!snap) {
+      const meta = this.metaLookup?.(subagentId);
+      snap = {
+        subagentId,
+        provider: meta?.provider,
+        model: meta?.model,
+        input: 0,
+        output: 0,
+        cacheRead: 0,
+        cacheWrite: 0,
+        cost: 0,
+        toolCalls: 0,
+        iterations: 0,
+        startedAt: Date.now(),
+        lastEventAt: Date.now()
+      };
+      this.perSubagent.set(subagentId, snap);
+    }
+    return snap;
+  }
+  onProviderResponse(e) {
+    const snap = this.ensure(e.subagentId);
+    const p = e.payload;
+    const usage = p?.usage;
+    if (!usage) return;
+    snap.input += usage.input ?? 0;
+    snap.output += usage.output ?? 0;
+    snap.cacheRead += usage.cacheRead ?? 0;
+    snap.cacheWrite += usage.cacheWrite ?? 0;
+    this.total.input += usage.input ?? 0;
+    this.total.output += usage.output ?? 0;
+    this.total.cacheRead += usage.cacheRead ?? 0;
+    this.total.cacheWrite += usage.cacheWrite ?? 0;
+    const price = this.priceLookup?.(e.subagentId);
+    if (price) {
+      const delta = (usage.input ?? 0) / 1e6 * (price.input ?? 0) + (usage.output ?? 0) / 1e6 * (price.output ?? 0) + (usage.cacheRead ?? 0) / 1e6 * (price.cacheRead ?? 0) + (usage.cacheWrite ?? 0) / 1e6 * (price.cacheWrite ?? 0);
+      snap.cost += delta;
+      this.total.cost += delta;
+    }
+    snap.lastEventAt = e.ts;
+  }
+  onToolExecuted(e) {
+    const snap = this.ensure(e.subagentId);
+    snap.toolCalls += 1;
+    snap.lastEventAt = e.ts;
+  }
+  onIterationStarted(e) {
+    const snap = this.ensure(e.subagentId);
+    snap.iterations += 1;
+    snap.lastEventAt = e.ts;
+  }
+};
+
 // src/defaults/transport/in-memory-transport.ts
 var InMemoryBridgeTransport = class {
   subs = /* @__PURE__ */ new Map();
@@ -4837,6 +5013,678 @@ function createMessage(type, from, payload, to) {
   };
 }
 
+// src/defaults/director-prompts.ts
+var DEFAULT_DIRECTOR_PREAMBLE = `You are the Director of a multi-agent fleet. You orchestrate worker
+subagents by spawning them, assigning tasks, awaiting completions, and
+rolling up their outputs into your next decision.
+
+Core fleet tools available to you:
+  - spawn_subagent       \u2014 create a worker with a chosen provider / model / role
+  - assign_task          \u2014 hand a piece of work to a specific subagent
+  - await_tasks          \u2014 block until named task ids complete (parallel-safe)
+  - ask_subagent         \u2014 synchronously query a running subagent via the bridge
+  - roll_up              \u2014 aggregate finished tasks into a markdown/json summary
+  - terminate_subagent   \u2014 abort a stuck worker (use sparingly)
+  - fleet_status         \u2014 snapshot of all subagents and pending tasks
+  - fleet_usage          \u2014 token + cost breakdown per subagent and total
+
+Working rules:
+  1. Decompose first. Before spawning, decide which sub-tasks are
+     independent and can run in parallel. Sequential work doesn't need a
+     subagent \u2014 do it yourself.
+  2. Match worker to job. Cheap/fast model for triage, capable model for
+     synthesis. Different providers per sibling is allowed and encouraged.
+  3. Always pair an assign with an await. Don't fire-and-forget; you owe
+     the user a single coherent answer at the end.
+  4. Roll up before deciding. After await_tasks resolves, call roll_up so
+     the results are folded back into your context in a compact form.
+  5. Budget is real. Check fleet_usage periodically. If a subagent is
+     thrashing, terminate it rather than letting cost climb silently.
+  6. Never claim a subagent's work as your own without verifying it. If a
+     result looks wrong, ask_subagent for clarification before passing it
+     to the user.`;
+var DEFAULT_SUBAGENT_BASELINE = `You are a subagent operating under a Director. You were spawned to handle
+a specific slice of a larger plan \u2014 do that slice well and report back.
+
+Bridge contract:
+  - You have a parent (the Director). You may call \`request\` on the
+    parent bridge to ask a clarifying question. Use this sparingly; the
+    parent is also working.
+  - You MAY NOT request the parent's system prompt, tool list, or other
+    subagents' context. Those are not yours to read.
+  - Your final task output is what the Director sees. Be concise,
+    structured, and self-contained \u2014 assume the Director will paste your
+    output into its own context.`;
+function composeDirectorPrompt(parts = {}) {
+  const sections = [];
+  const preamble = parts.directorPreamble ?? DEFAULT_DIRECTOR_PREAMBLE;
+  if (preamble && preamble.trim().length > 0) sections.push(preamble.trim());
+  if (parts.rosterSummary && parts.rosterSummary.trim().length > 0) {
+    sections.push(`Available roles you can spawn:
+${parts.rosterSummary.trim()}`);
+  }
+  if (parts.basePrompt && parts.basePrompt.trim().length > 0) {
+    sections.push(parts.basePrompt.trim());
+  }
+  return sections.join("\n\n");
+}
+function composeSubagentPrompt(parts = {}) {
+  const sections = [];
+  const baseline = parts.baseline ?? DEFAULT_SUBAGENT_BASELINE;
+  if (baseline && baseline.trim().length > 0) sections.push(baseline.trim());
+  if (parts.role && parts.role.trim().length > 0) {
+    sections.push(`Role:
+${parts.role.trim()}`);
+  }
+  if (parts.task && parts.task.trim().length > 0) {
+    sections.push(`Task:
+${parts.task.trim()}`);
+  }
+  if (parts.override && parts.override.trim().length > 0) {
+    sections.push(parts.override.trim());
+  }
+  return sections.join("\n\n");
+}
+function rosterSummaryFromConfigs(roster) {
+  const lines = [];
+  for (const [roleId, cfg] of Object.entries(roster)) {
+    const tag = cfg.provider && cfg.model ? ` (${cfg.provider}/${cfg.model})` : "";
+    const headline = cfg.prompt ? (cfg.prompt.split("\n").find((l) => l.trim().length > 0) ?? "").trim().slice(0, 80) : "";
+    const tail = headline ? ` \u2014 ${headline}` : "";
+    lines.push(`- ${roleId}: ${cfg.name}${tag}${tail}`);
+  }
+  return lines.join("\n");
+}
+
+// src/defaults/director.ts
+var Director = class {
+  id;
+  fleet;
+  usage;
+  /**
+   * Director-side bridge endpoint. Subagents are wired to the same
+   * in-memory transport so the director can `ask()` them synchronously
+   * and they can `send()` progress back. Exposed so external code (e.g.
+   * the TUI) can subscribe to inbound messages.
+   */
+  bridge;
+  transport;
+  coordinator;
+  /** Resolves with the matching `TaskResult` the first time the
+   *  coordinator emits `task.completed` for a given task id. Each entry
+   *  is created lazily on first poll/await and cleared once consumed. */
+  taskWaiters = /* @__PURE__ */ new Map();
+  /** Cache of completed results in case the consumer asks AFTER the
+   *  coordinator already fired the event — `awaitTasks(['t-1'])` after
+   *  t-1 finished should resolve immediately, not hang. */
+  completed = /* @__PURE__ */ new Map();
+  /** Per-subagent provider/model metadata, captured at spawn time so the
+   *  FleetUsageAggregator's metaLookup can surface readable rows. */
+  subagentMeta = /* @__PURE__ */ new Map();
+  priceLookups = /* @__PURE__ */ new Map();
+  /** Bridge endpoints we created per subagent (so we can `stop()` them
+   *  on shutdown and free transport subscriptions). */
+  subagentBridges = /* @__PURE__ */ new Map();
+  /** Tracks per-spawn config + assigned task ids for manifest writing. */
+  manifestEntries = /* @__PURE__ */ new Map();
+  manifestPath;
+  roster;
+  directorPreamble;
+  subagentBaseline;
+  constructor(opts) {
+    this.id = opts.config.coordinatorId || randomUUID();
+    this.manifestPath = opts.manifestPath;
+    this.roster = opts.roster;
+    this.directorPreamble = opts.directorPreamble ?? DEFAULT_DIRECTOR_PREAMBLE;
+    this.subagentBaseline = opts.subagentBaseline ?? DEFAULT_SUBAGENT_BASELINE;
+    this.transport = new InMemoryBridgeTransport();
+    this.bridge = new InMemoryAgentBridge(
+      { agentId: this.id, coordinatorId: this.id },
+      this.transport
+    );
+    this.fleet = new FleetBus();
+    this.usage = new FleetUsageAggregator(
+      this.fleet,
+      (id) => this.priceLookups.get(id),
+      (id) => this.subagentMeta.get(id)
+    );
+    this.coordinator = new DefaultMultiAgentCoordinator(
+      { ...opts.config, coordinatorId: this.id },
+      { runner: opts.runner }
+    );
+    this.coordinator.on("task.completed", (payload) => {
+      const r = payload.result;
+      this.completed.set(r.taskId, r);
+      const waiter = this.taskWaiters.get(r.taskId);
+      if (waiter) {
+        waiter.resolve(r);
+        this.taskWaiters.delete(r.taskId);
+      }
+    });
+  }
+  /**
+   * Spawn a subagent. Identical to the coordinator's `spawn()` but
+   * captures provider/model metadata for the usage aggregator and
+   * lets the FleetBus attach to the runner's EventBus when the task
+   * actually runs (see `attachSubagentBus`).
+   *
+   * Caller-supplied `priceLookup` is optional but recommended — without
+   * it the `cost` column in `usage.snapshot()` stays at 0.
+   */
+  async spawn(config, priceLookup) {
+    const result = await this.coordinator.spawn(config);
+    this.subagentMeta.set(result.subagentId, {
+      provider: config.provider,
+      model: config.model
+    });
+    if (priceLookup) this.priceLookups.set(result.subagentId, priceLookup);
+    const subagentBridge = new InMemoryAgentBridge(
+      { agentId: result.subagentId, coordinatorId: this.id },
+      this.transport
+    );
+    this.coordinator.setSubagentBridge(result.subagentId, subagentBridge);
+    this.subagentBridges.set(result.subagentId, subagentBridge);
+    this.manifestEntries.set(result.subagentId, {
+      subagentId: result.subagentId,
+      name: config.name,
+      role: config.role,
+      provider: config.provider,
+      model: config.model,
+      taskIds: []
+    });
+    return result.subagentId;
+  }
+  /**
+   * Synchronously ask a subagent something via the bridge. Sends a
+   * `task` message addressed to the subagent and awaits a matching
+   * reply (matched by message id). Subagent runners that handle these
+   * requests subscribe to `ctx.bridge` and reply with a message whose
+   * `id` equals the incoming request's id (see `InMemoryAgentBridge`'s
+   * `request<T>` implementation).
+   *
+   * Returns the response payload directly (the bridge wrapper is
+   * unwrapped for ergonomics). Times out after `timeoutMs` (default
+   * matches the bridge's own default of 30s) — surface those rejections
+   * to the caller as actionable errors instead of letting tools hang.
+   */
+  async ask(subagentId, payload, timeoutMs) {
+    if (!this.subagentBridges.has(subagentId)) {
+      throw new Error(
+        `ask: unknown subagent "${subagentId}" (spawn() it first; current fleet: ${Array.from(this.subagentBridges.keys()).join(", ") || "(empty)"})`
+      );
+    }
+    const msg = {
+      id: randomUUID(),
+      type: "task",
+      from: this.id,
+      to: subagentId,
+      payload,
+      timestamp: Date.now(),
+      priority: "normal"
+    };
+    const reply = await this.bridge.request(msg, timeoutMs);
+    return reply.payload;
+  }
+  /**
+   * Read completed task results and format them as a structured text
+   * block the director's LLM can paste into its own context. The
+   * Director keeps every completed `TaskResult` in `completed` so this
+   * is a pure read — no bridge round-trip, cheap to call.
+   *
+   * The returned string is intentionally markdown-flavored: headers per
+   * subagent, a one-line meta row (iter / tools / ms), and the task's
+   * result text. Pass `style: 'json'` for a programmatic shape instead
+   * (useful when the director model is doing structured-output work).
+   */
+  rollUp(taskIds, style = "markdown") {
+    const rows = taskIds.map((id) => this.completed.get(id)).filter(
+      (r) => !!r
+    );
+    if (style === "json") {
+      return JSON.stringify(
+        rows.map((r) => ({
+          taskId: r.taskId,
+          subagentId: r.subagentId,
+          status: r.status,
+          iterations: r.iterations,
+          toolCalls: r.toolCalls,
+          durationMs: r.durationMs,
+          result: r.result,
+          error: r.error
+        })),
+        null,
+        2
+      );
+    }
+    if (rows.length === 0) {
+      return "_No completed tasks for the requested ids \u2014 try waiting first._";
+    }
+    const lines = [];
+    for (const r of rows) {
+      const meta = this.subagentMeta.get(r.subagentId);
+      const tag = meta?.provider && meta?.model ? ` \xB7 ${meta.provider}/${meta.model}` : "";
+      lines.push(`### ${r.subagentId}${tag}`);
+      lines.push(
+        `_${r.status} \u2014 ${r.iterations} iter \xB7 ${r.toolCalls} tools \xB7 ${r.durationMs}ms_`
+      );
+      lines.push("");
+      if (r.error) lines.push(`**Error:** ${r.error}`);
+      else if (typeof r.result === "string") lines.push(r.result);
+      else if (r.result !== void 0) lines.push("```json\n" + JSON.stringify(r.result, null, 2) + "\n```");
+      else lines.push("_(no output)_");
+      lines.push("");
+    }
+    return lines.join("\n").trimEnd();
+  }
+  /**
+   * Write the fleet manifest to `manifestPath`. Returns the path written
+   * or null when no path was configured. Captures every spawn + its
+   * assigned tasks — paired with per-subagent JSONLs, this is enough to
+   * replay an entire director run.
+   */
+  async writeManifest() {
+    if (!this.manifestPath) return null;
+    const manifest = {
+      directorRunId: this.id,
+      writtenAt: (/* @__PURE__ */ new Date()).toISOString(),
+      children: Array.from(this.manifestEntries.values()).map((e) => ({
+        ...e,
+        // Surface final status from `completed` when available — manifest
+        // becomes much more useful for replay when it carries the
+        // success/failure state.
+        results: e.taskIds.map((tid) => {
+          const r = this.completed.get(tid);
+          return r ? {
+            taskId: tid,
+            status: r.status,
+            iterations: r.iterations,
+            toolCalls: r.toolCalls,
+            durationMs: r.durationMs
+          } : { taskId: tid, status: "pending" };
+        })
+      })),
+      usage: this.usage.snapshot()
+    };
+    await fsp.mkdir(path2.dirname(this.manifestPath), { recursive: true });
+    await fsp.writeFile(this.manifestPath, JSON.stringify(manifest, null, 2), { mode: 384 });
+    return this.manifestPath;
+  }
+  /**
+   * Tear down the director: stop every subagent, close every bridge
+   * endpoint, and (when configured) write the final manifest. Idempotent
+   * — calling shutdown twice is a no-op on the second invocation.
+   */
+  async shutdown() {
+    await this.coordinator.stopAll();
+    for (const b of this.subagentBridges.values()) {
+      await b.stop().catch(() => void 0);
+    }
+    this.subagentBridges.clear();
+    await this.bridge.stop().catch(() => void 0);
+    if (this.manifestPath) await this.writeManifest().catch(() => void 0);
+  }
+  /**
+   * Hand a task to the coordinator. Returns the assigned task id so
+   * callers can wait on it via `awaitTasks([id])`. The coordinator's
+   * concurrency limit applies — the task may queue before running.
+   */
+  async assign(task) {
+    const taskWithId = task.id ? task : { ...task, id: randomUUID() };
+    if (task.subagentId) {
+      const entry = this.manifestEntries.get(task.subagentId);
+      if (entry) entry.taskIds.push(taskWithId.id);
+    }
+    await this.coordinator.assign(taskWithId);
+    return taskWithId.id;
+  }
+  /**
+   * Block until every task id resolves. Returns results in the same
+   * order as the input. If any task hasn't completed by the time this
+   * is called, the promise hangs until it does — pair with a timeout
+   * at the caller if that's a concern. Resolves immediately for ids
+   * whose results were already cached.
+   */
+  awaitTasks(taskIds) {
+    return Promise.all(taskIds.map((id) => {
+      const cached = this.completed.get(id);
+      if (cached) return cached;
+      const existing = this.taskWaiters.get(id);
+      if (existing) return existing.promise;
+      let resolve4;
+      const promise = new Promise((res) => {
+        resolve4 = res;
+      });
+      this.taskWaiters.set(id, { promise, resolve: resolve4 });
+      return promise;
+    }));
+  }
+  async terminate(subagentId) {
+    await this.coordinator.stop(subagentId);
+  }
+  async terminateAll() {
+    await this.coordinator.stopAll();
+  }
+  status() {
+    return this.coordinator.getStatus();
+  }
+  /**
+   * Subscribe to coordinator events. Currently only `task.completed` is
+   * exposed (the others are internal lifecycle). Returns an unsubscribe
+   * function. External callers (e.g. the CLI's `MultiAgentHost`) use this
+   * to drive their own pending/results tracking without poking the
+   * coordinator directly.
+   */
+  on(event, handler) {
+    this.coordinator.on(event, handler);
+    return () => {
+      this.coordinator.off(event, handler);
+    };
+  }
+  /**
+   * Snapshot of every task that has resolved (success, failed, timeout,
+   * stopped) since the director started. Returned in completion order
+   * via the internal map's iteration order. Used by `/fleet status` to
+   * paint the completed table without reaching into private state.
+   */
+  completedResults() {
+    return Array.from(this.completed.values());
+  }
+  snapshot() {
+    return this.usage.snapshot();
+  }
+  /**
+   * Compose the leader/director-agent system prompt: fleet preamble +
+   * (optional) roster summary + user base prompt. Pass the result to your
+   * leader Agent's `ctx.systemPrompt` when constructing it.
+   *
+   * `basePrompt` defaults to `config.leaderSystemPrompt` so callers can
+   * use the no-arg form when the multi-agent config already carries it.
+   */
+  leaderSystemPrompt(basePrompt) {
+    return composeDirectorPrompt({
+      basePrompt: basePrompt ?? this.coordinator.config.leaderSystemPrompt,
+      directorPreamble: this.directorPreamble,
+      rosterSummary: this.roster ? rosterSummaryFromConfigs(this.roster) : void 0
+    });
+  }
+  /**
+   * Compose a subagent's system prompt for a given `SubagentConfig`:
+   * baseline + role + task + per-spawn override. Returned by value — does
+   * not mutate the config. Factories (the user-supplied `AgentFactory`)
+   * should call this when building each subagent's Agent so the bridge
+   * contract, role context, and override are all surfaced.
+   *
+   * When `taskBrief` is omitted the Task section is dropped. Pass the
+   * actual task description here to reinforce it in the system prompt
+   * (the runner already passes it as user input — duplicating in the
+   * system prompt is optional but improves anchoring on small models).
+   */
+  subagentSystemPrompt(config, taskBrief) {
+    return composeSubagentPrompt({
+      baseline: this.subagentBaseline,
+      role: config.prompt,
+      task: taskBrief,
+      override: config.systemPromptOverride
+    });
+  }
+  /**
+   * Build the tool set the LLM-driven director uses to orchestrate.
+   * Returns an array of `Tool` definitions; register these on the
+   * director's `Agent` to expose `spawn_subagent`, `assign_task`, etc.
+   * Each tool's `execute()` delegates straight to the matching method
+   * above.
+   *
+   * Tools all carry `permission: 'auto'` — the *user* has already
+   * approved running the director when they kicked off the run, so
+   * gating individual orchestration calls behind a confirm prompt
+   * would just be noise. The actual subagent tools they spawn are
+   * still permission-checked normally.
+   */
+  tools(roster) {
+    const t2 = [
+      makeSpawnTool(this, roster),
+      makeAssignTool(this),
+      makeAwaitTasksTool(this),
+      makeAskTool(this),
+      makeRollUpTool(this),
+      makeTerminateTool(this),
+      makeFleetStatusTool(this),
+      makeFleetUsageTool(this)
+    ];
+    return t2;
+  }
+};
+function makeSpawnTool(director, roster) {
+  const inputSchema = {
+    type: "object",
+    properties: {
+      role: { type: "string", description: "Roster role id (preferred). When set, the spawn uses the matching config from the roster and ignores other fields." },
+      name: { type: "string", description: "Display name for the subagent. Required when not using roster." },
+      provider: { type: "string", description: 'Provider id (e.g. "anthropic", "openai"). Defaults to the leader provider when omitted.' },
+      model: { type: "string", description: "Model id within the provider. Defaults to the leader model when omitted." },
+      systemPromptOverride: { type: "string", description: "Extra prompt text appended after the role-base prompt." },
+      maxIterations: { type: "number" },
+      maxToolCalls: { type: "number" },
+      maxCostUsd: { type: "number" }
+    },
+    required: []
+  };
+  return {
+    name: "spawn_subagent",
+    description: "Create a new subagent under this director. Returns the subagent id. Use this when you need a worker with a specific provider, model, or role to handle a piece of the plan.",
+    usageHint: "Either pass `role` (matches the roster) OR pass `name` + optional `provider`/`model`. Returns `{ subagentId }`.",
+    permission: "auto",
+    mutating: false,
+    inputSchema,
+    async execute(input) {
+      const i = input ?? {};
+      const role = typeof i.role === "string" ? i.role : void 0;
+      const base = role && roster ? roster[role] : void 0;
+      if (role && !base) {
+        return { error: `unknown role "${role}". roster has: ${roster ? Object.keys(roster).join(", ") : "(empty)"}` };
+      }
+      const cfg = {
+        ...base ?? { name: i.name ?? "subagent" }
+      };
+      if (typeof i.name === "string") cfg.name = i.name;
+      if (typeof i.provider === "string") cfg.provider = i.provider;
+      if (typeof i.model === "string") cfg.model = i.model;
+      if (typeof i.systemPromptOverride === "string") cfg.systemPromptOverride = i.systemPromptOverride;
+      if (typeof i.maxIterations === "number") cfg.maxIterations = i.maxIterations;
+      if (typeof i.maxToolCalls === "number") cfg.maxToolCalls = i.maxToolCalls;
+      if (typeof i.maxCostUsd === "number") cfg.maxCostUsd = i.maxCostUsd;
+      const subagentId = await director.spawn(cfg);
+      return { subagentId, provider: cfg.provider, model: cfg.model, name: cfg.name };
+    }
+  };
+}
+function makeAssignTool(director) {
+  const inputSchema = {
+    type: "object",
+    properties: {
+      subagentId: { type: "string", description: "Target subagent id. Required." },
+      description: { type: "string", description: "The task in natural language \u2014 what you want this subagent to do." },
+      maxToolCalls: { type: "number", description: "Optional per-task tool-call budget override." },
+      timeoutMs: { type: "number", description: "Optional per-task timeout in ms." }
+    },
+    required: ["subagentId", "description"]
+  };
+  return {
+    name: "assign_task",
+    description: "Hand a task to a previously spawned subagent. Returns the task id \u2014 pass it to `await_tasks` to block on completion.",
+    permission: "auto",
+    mutating: false,
+    inputSchema,
+    async execute(input) {
+      const i = input;
+      const task = {
+        id: randomUUID(),
+        description: i.description,
+        subagentId: i.subagentId,
+        maxToolCalls: i.maxToolCalls,
+        timeoutMs: i.timeoutMs
+      };
+      const taskId = await director.assign(task);
+      return { taskId, subagentId: i.subagentId };
+    }
+  };
+}
+function makeAwaitTasksTool(director) {
+  const inputSchema = {
+    type: "object",
+    properties: {
+      taskIds: {
+        type: "array",
+        items: { type: "string" },
+        description: "One or more task ids returned by `assign_task`. The call blocks until every id resolves."
+      }
+    },
+    required: ["taskIds"]
+  };
+  return {
+    name: "await_tasks",
+    description: "Block until every named task completes. Returns the array of TaskResult \u2014 use this to gather subagent output before deciding the next step.",
+    permission: "auto",
+    mutating: false,
+    inputSchema,
+    async execute(input) {
+      const i = input;
+      const results = await director.awaitTasks(i.taskIds);
+      return { results };
+    }
+  };
+}
+function makeAskTool(director) {
+  const inputSchema = {
+    type: "object",
+    properties: {
+      subagentId: { type: "string", description: "Subagent to ask. Must be a previously spawned id." },
+      question: { type: "string", description: "The question or instruction. Sent as the bridge message payload." },
+      timeoutMs: { type: "number", description: "Optional timeout in ms (default 30s)." }
+    },
+    required: ["subagentId", "question"]
+  };
+  return {
+    name: "ask_subagent",
+    description: "Synchronously ask a subagent a question. Blocks until the subagent replies via the bridge (or the timeout fires). Use this when you need a one-shot answer without spawning a fresh task.",
+    permission: "auto",
+    mutating: false,
+    inputSchema,
+    async execute(input) {
+      const i = input;
+      try {
+        const answer = await director.ask(i.subagentId, { question: i.question }, i.timeoutMs);
+        return { ok: true, answer };
+      } catch (err) {
+        return { ok: false, error: err instanceof Error ? err.message : String(err) };
+      }
+    }
+  };
+}
+function makeRollUpTool(director) {
+  const inputSchema = {
+    type: "object",
+    properties: {
+      taskIds: {
+        type: "array",
+        items: { type: "string" },
+        description: "Completed task ids to aggregate. Pass the ids returned by previous `assign_task` calls."
+      },
+      style: {
+        type: "string",
+        enum: ["markdown", "json"],
+        description: "Output flavor \u2014 markdown (default) for in-prompt summarization, json for structured downstream processing."
+      }
+    },
+    required: ["taskIds"]
+  };
+  return {
+    name: "roll_up",
+    description: "Aggregate completed task results into a single formatted summary. Use this after `await_tasks` to fold subagent outputs back into the director's context before deciding the next step.",
+    permission: "auto",
+    mutating: false,
+    inputSchema,
+    async execute(input) {
+      const i = input;
+      const summary = director.rollUp(i.taskIds, i.style ?? "markdown");
+      return { summary, count: i.taskIds.length };
+    }
+  };
+}
+function makeTerminateTool(director) {
+  const inputSchema = {
+    type: "object",
+    properties: {
+      subagentId: { type: "string", description: "Subagent to abort." }
+    },
+    required: ["subagentId"]
+  };
+  return {
+    name: "terminate_subagent",
+    description: 'Forcibly abort a subagent. Use sparingly \u2014 prefer waiting on the natural budget to expire. The current task (if any) ends with status "stopped".',
+    permission: "auto",
+    mutating: true,
+    inputSchema,
+    async execute(input) {
+      const i = input;
+      await director.terminate(i.subagentId);
+      return { ok: true };
+    }
+  };
+}
+function makeFleetStatusTool(director) {
+  return {
+    name: "fleet_status",
+    description: "Snapshot of the fleet \u2014 every subagent's current status, pending vs. completed task counts, and the running total iteration count. Cheap; call freely.",
+    permission: "auto",
+    mutating: false,
+    inputSchema: { type: "object", properties: {}, required: [] },
+    async execute() {
+      return director.status();
+    }
+  };
+}
+function makeFleetUsageTool(director) {
+  return {
+    name: "fleet_usage",
+    description: "Token + cost breakdown across the fleet, per-subagent and totals. Use this to reason about which workers to assign costly tasks to or when to wrap up to stay within budget.",
+    permission: "auto",
+    mutating: false,
+    inputSchema: { type: "object", properties: {}, required: [] },
+    async execute() {
+      return director.snapshot();
+    }
+  };
+}
+function makeDirectorSessionFactory(opts) {
+  const runId = opts.directorRunId ?? `${(/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-")}-director`;
+  let store;
+  let dir;
+  if (opts.store) {
+    store = opts.store;
+    dir = opts.sessionsRoot ? path2.join(opts.sessionsRoot, runId) : "(caller-managed)";
+  } else if (opts.sessionsRoot) {
+    dir = path2.join(opts.sessionsRoot, runId);
+    store = new DefaultSessionStore({ dir });
+  } else {
+    throw new Error(
+      "makeDirectorSessionFactory requires either `store` or `sessionsRoot`"
+    );
+  }
+  return {
+    dir,
+    directorRunId: runId,
+    async createSubagentSession({ subagentId, provider, model, title }) {
+      return store.create({
+        id: subagentId,
+        title: title ?? subagentId,
+        provider: provider ?? "unknown",
+        model: model ?? "unknown"
+      });
+    }
+  };
+}
+
 // src/defaults/autonomous-runner.ts
 var DoneConditionChecker = class {
   constructor(condition) {
@@ -4878,6 +5726,16 @@ var AutonomousRunner = class {
   stopped = false;
   doneChecker;
   async run() {
+    const offToolExecuted = this.opts.agent.events?.on?.("tool.executed", () => {
+      this.toolCalls++;
+    });
+    try {
+      return await this.runLoop();
+    } finally {
+      offToolExecuted?.();
+    }
+  }
+  async runLoop() {
     while (!this.stopped) {
       const check = this.doneChecker.check({
         iterations: this.iterations,
@@ -4904,7 +5762,6 @@ var AutonomousRunner = class {
         );
         this.iterations++;
         this.lastOutput = result.finalText;
-        this.toolCalls++;
         if (result.status === "failed" || result.status === "aborted") {
           const failedResult = {
             status: result.status,
@@ -6711,7 +7568,7 @@ var PROMETHEUS_CONTENT_TYPE = "text/plain; version=0.0.4; charset=utf-8";
 async function startMetricsServer(opts) {
   const { createServer } = await import('http');
   const host = opts.host ?? "127.0.0.1";
-  const path15 = opts.path ?? "/metrics";
+  const path17 = opts.path ?? "/metrics";
   const healthPath = opts.healthPath ?? "/healthz";
   const healthRegistry = opts.healthRegistry;
   const server = createServer((req, res) => {
@@ -6721,7 +7578,7 @@ async function startMetricsServer(opts) {
       return;
     }
     const url = req.url.split("?")[0];
-    if (url === path15) {
+    if (url === path17) {
       let body;
       try {
         body = renderPrometheus(opts.sink.snapshot());
@@ -6772,7 +7629,7 @@ async function startMetricsServer(opts) {
   const boundPort = typeof addr === "object" && addr ? addr.port : opts.port;
   return {
     port: boundPort,
-    url: `http://${host}:${boundPort}${path15}`,
+    url: `http://${host}:${boundPort}${path17}`,
     close: () => new Promise((resolve4, reject) => {
       server.close((err) => err ? reject(err) : resolve4());
     })
@@ -8810,7 +9667,7 @@ var noopSlashCommands = {
 };
 
 // src/plugin/loader.ts
-var KERNEL_API_VERSION = "0.1.1";
+var KERNEL_API_VERSION = "0.1.8";
 function parseSemver(v) {
   const parts = v.replace(/^[^0-9]*/, "").split(".").map((s) => Number.parseInt(s, 10) || 0);
   return [parts[0] ?? 0, parts[1] ?? 0, parts[2] ?? 0];
@@ -9042,6 +9899,6 @@ function wrapApiForCapabilityCheck(plugin, api, log) {
   });
 }
 
-export { Agent, AgentError, AutoCompactionMiddleware, AutonomousRunner, BudgetExceededError, ConfigError, ConfigMigrationError, Container, Context, ConversationState, DEFAULT_CONFIG_MIGRATIONS, DEFAULT_MAX_ITERATIONS, DEFAULT_MODES, DEFAULT_SPEC_TEMPLATE, DefaultAttachmentStore, DefaultConfigLoader, DefaultConfigStore, DefaultErrorHandler, DefaultHealthRegistry, DefaultLogger, DefaultMemoryStore, DefaultModeStore, DefaultModelsRegistry, DefaultMultiAgentCoordinator, DefaultPathResolver, DefaultPermissionPolicy, DefaultPluginAPI, DefaultRetryPolicy, DefaultSecretScrubber, DefaultSecretVault, DefaultSessionReader, DefaultSessionStore, DefaultSkillLoader, DefaultSystemPromptBuilder, DefaultTaskStore, DefaultTokenCounter, DoneConditionChecker, ENCRYPTED_PREFIX, EventBus, HybridCompactor, InMemoryAgentBridge, InMemoryBridgeTransport, InMemoryMetricsSink, InputBuilder, IntelligentCompactor, KERNEL_API_VERSION, LAYER_1_IDENTITY, LLMSelector, NoopMetricsSink, NoopTracer, OTelTracer, PROMETHEUS_CONTENT_TYPE, Pipeline, PluginError, ProviderError, ProviderRegistry, QueueStore, RecoveryLock, RunController, SelectiveCompactor, SessionError, SlashCommandRegistry, SpecDrivenDev, SpecParser, SubagentBudget, TOKENS, TaskFlow, TaskGenerator, TaskTracker, ToolError, ToolExecutor, ToolRegistry, WrongStackError, allServers, asBlocks, asText, atomicWrite, awsServer, blockServer, braveSearchServer, buildOtlpMetricsRequest, buildOtlpTracesRequest, classifyFamily, color, compileGlob, computeTaskProgress, context7Server, contextManagerTool, createContextManagerTool, createDefaultPipelines, createMessage, createToolOutputSerializer, decryptConfigSecrets, detectNewlineStyle, encryptConfigSecrets, ensureDir, estimateTextTokens, estimateToolInputTokens, estimateToolResultTokens, everArtServer, extractRunEnv, filesystemServer, findCriticalPath, githubServer, googleMapsServer, isAgentError, isConfigError, isImageBlock, isPluginError, isSessionError, isTextBlock, isToolError, isToolResultBlock, isToolUseBlock, isWrongStackError, loadPlugins, loadProjectModes, loadUserModes, makeAgentSubagentRunner, matchAny, matchGlob, migratePlaintextSecrets, normalizeToLf, projectHash, renderPrometheus, resolveWstackPaths, rewriteConfigEncrypted, runConfigMigrations, safeParse, safeStringify, sanitizeJsonString, sentinelServer, slackServer, startMetricsServer, startOtlpMetricsExporter, startOtlpTraceExporter, stripAnsi, toStyle, toWrongStackError, topologicalSort, unifiedDiff, unloadPlugins, validateAgainstSchema, wireMetricsToEvents, wrapAsState };
+export { Agent, AgentError, AutoCompactionMiddleware, AutonomousRunner, BudgetExceededError, ConfigError, ConfigMigrationError, Container, Context, ConversationState, DEFAULT_CONFIG_MIGRATIONS, DEFAULT_DIRECTOR_PREAMBLE, DEFAULT_MAX_ITERATIONS, DEFAULT_MODES, DEFAULT_SPEC_TEMPLATE, DEFAULT_SUBAGENT_BASELINE, DefaultAttachmentStore, DefaultConfigLoader, DefaultConfigStore, DefaultErrorHandler, DefaultHealthRegistry, DefaultLogger, DefaultMemoryStore, DefaultModeStore, DefaultModelsRegistry, DefaultMultiAgentCoordinator, DefaultPathResolver, DefaultPermissionPolicy, DefaultPluginAPI, DefaultRetryPolicy, DefaultSecretScrubber, DefaultSecretVault, DefaultSessionReader, DefaultSessionStore, DefaultSkillLoader, DefaultSystemPromptBuilder, DefaultTaskStore, DefaultTokenCounter, Director, DoneConditionChecker, ENCRYPTED_PREFIX, EventBus, FleetBus, FleetUsageAggregator, HybridCompactor, InMemoryAgentBridge, InMemoryBridgeTransport, InMemoryMetricsSink, InputBuilder, IntelligentCompactor, KERNEL_API_VERSION, LAYER_1_IDENTITY, LLMSelector, NoopMetricsSink, NoopTracer, OTelTracer, PROMETHEUS_CONTENT_TYPE, Pipeline, PluginError, ProviderError, ProviderRegistry, QueueStore, RecoveryLock, RunController, SelectiveCompactor, SessionError, SlashCommandRegistry, SpecDrivenDev, SpecParser, SubagentBudget, TOKENS, TaskFlow, TaskGenerator, TaskTracker, ToolError, ToolExecutor, ToolRegistry, WrongStackError, allServers, asBlocks, asText, atomicWrite, awsServer, blockServer, braveSearchServer, buildOtlpMetricsRequest, buildOtlpTracesRequest, classifyFamily, color, compileGlob, composeDirectorPrompt, composeSubagentPrompt, computeTaskProgress, context7Server, contextManagerTool, createContextManagerTool, createDefaultPipelines, createMessage, createToolOutputSerializer, decryptConfigSecrets, detectNewlineStyle, encryptConfigSecrets, ensureDir, estimateTextTokens, estimateToolInputTokens, estimateToolResultTokens, everArtServer, extractRunEnv, filesystemServer, findCriticalPath, githubServer, googleMapsServer, isAgentError, isConfigError, isImageBlock, isPluginError, isSessionError, isTextBlock, isToolError, isToolResultBlock, isToolUseBlock, isWrongStackError, loadPlugins, loadProjectModes, loadUserModes, makeAgentSubagentRunner, makeDirectorSessionFactory, matchAny, matchGlob, migratePlaintextSecrets, normalizeToLf, projectHash, renderPrometheus, resolveWstackPaths, rewriteConfigEncrypted, rosterSummaryFromConfigs, runConfigMigrations, safeParse, safeStringify, sanitizeJsonString, sentinelServer, slackServer, startMetricsServer, startOtlpMetricsExporter, startOtlpTraceExporter, stripAnsi, toStyle, toWrongStackError, topologicalSort, unifiedDiff, unloadPlugins, validateAgainstSchema, wireMetricsToEvents, wrapAsState };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map