@wrongstack/core 0.284.0 → 0.285.0

package/dist/coordination/agent-subagent-runner.d.ts

@@ -0,0 +1,74 @@
+import type { Agent, AgentInput } from '../core/agent.js';
+import type { EventBus } from '../kernel/events.js';
+import type { SubagentConfig, SubagentRunner, TaskSpec } from '../types/multi-agent.js';
+import type { FleetBus } from './fleet-bus.js';
+/**
+ * Caller-supplied factory that builds an isolated `Agent` for a subagent.
+ * The factory MUST construct a fresh `Context` per call — sharing context
+ * between subagents defeats isolation. Each Agent should also use either
+ * its own `EventBus` or a forwarded view, so per-subagent metrics can be
+ * attributed correctly.
+ */
+export type AgentFactory = (config: SubagentConfig) => Promise<AgentFactoryResult>;
+/**
+ * Wrap a factory to automatically filter out disabled tools from subagent
+ * configurations. This provides mechanical enforcement of tool restrictions
+ * (e.g., preventing delegation) in addition to the baseline prompt constraint.
+ *
+ * The wrapper reads `config.disabledTools` and removes those tools from the
+ * agent's tool registry before returning.
+ *
+ * Usage:
+ *   const filteredFactory = withDisabledToolFiltering(originalFactory);
+ *   const runner = makeAgentSubagentRunner({ factory: filteredFactory });
+ */
+export declare function withDisabledToolFiltering(factory: AgentFactory): AgentFactory;
+export interface AgentFactoryResult {
+    agent: Agent;
+    /** Event bus the factory wired to this agent — required for budget hookup. */
+    events: EventBus;
+    /**
+     * Optional cleanup hook invoked in the runner's `finally` block once
+     * the task ends (success, failure, abort — same exit path). Factories
+     * that own resources scoped to a single task (per-subagent JSONL
+     * writers, transient providers, throwaway containers) implement this
+     * to close them deterministically instead of relying on GC. Errors
+     * thrown here are swallowed so a flaky cleanup can't mask the task's
+     * real result.
+     */
+    dispose?: ((() => Promise<void> | void)) | undefined;
+}
+export interface AgentRunnerOptions {
+    factory: AgentFactory;
+    /**
+     * Format a TaskSpec into the user input the agent will receive. Defaults
+     * to `task.description ?? ''`. Override when subagents expect structured
+     * input (e.g. JSON contracts, role-prefixed prompts).
+     */
+    formatTaskInput?: (task: TaskSpec, config: SubagentConfig) => AgentInput;
+    /**
+     * When set, the runner attaches the subagent's EventBus to this FleetBus
+     * on task start and detaches it when the task finishes. This is the
+     * injection seam that lets the TUI fleet panel observe subagent activity
+     * live — without it, FleetBus stays empty.
+     */
+    fleetBus?: FleetBus | undefined;
+}
+/**
+ * Builds a `SubagentRunner` that drives a real `Agent` per task while honoring
+ * the coordinator's budget and abort signal. This is the production adapter —
+ * the coordinator's `runner` option in CLI/TUI assemblies points here.
+ *
+ * Lifecycle per task:
+ *   1. factory(config) → fresh Agent + EventBus.
+ *   2. Subscribe to events to feed the budget (tool calls, token usage).
+ *   3. Call agent.run(input, { signal }) — the coordinator's signal cancels.
+ *   4. Map RunResult.status onto a `SubagentRunOutcome` or throw on failure.
+ *   5. Unsubscribe and let the factory's resources be GC'd.
+ *
+ * The budget is checked synchronously from event handlers — a runaway agent
+ * that crosses its tool-call limit triggers `BudgetExceededError`, which the
+ * coordinator surfaces as `status: 'failed'` on the task result.
+ */
+export declare function makeAgentSubagentRunner(opts: AgentRunnerOptions): SubagentRunner;
+//# sourceMappingURL=agent-subagent-runner.d.ts.map

package/dist/coordination/agent-subagent-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-subagent-runner.d.ts","sourceRoot":"","sources":["../../src/coordination/agent-subagent-runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAa,MAAM,kBAAkB,CAAC;AACrE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EACV,cAAc,EAGd,cAAc,EACd,QAAQ,EACT,MAAM,yBAAyB,CAAC;AAMjC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,cAAc,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;AAEnF;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY,CAe7E;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,KAAK,CAAC;IACb,8EAA8E;IAC9E,MAAM,EAAE,QAAQ,CAAC;IACjB;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,CAAC,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC;CACtD;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,YAAY,CAAC;IACtB;;;;OAIG;IACH,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,KAAK,UAAU,CAAC;IACzE;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;CACjC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,kBAAkB,GAAG,cAAc,CA8ThF"}

package/dist/coordination/agents/agent-prompts.d.ts

@@ -0,0 +1,2 @@
+export declare function agentPrompt(id: string): string;
+//# sourceMappingURL=agent-prompts.d.ts.map

package/dist/coordination/agents/agent-prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-prompts.d.ts","sourceRoot":"","sources":["../../../src/coordination/agents/agent-prompts.ts"],"names":[],"mappings":"AAsBA,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAkB9C"}

package/dist/coordination/agents/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Agent catalog aggregator.
+ *
+ * Collects every phase's `AgentDefinition[]` into:
+ *   - `ALL_AGENT_DEFINITIONS` — flat list, catalog order (phase 1 → 9)
+ *   - `AGENT_CATALOG`         — keyed by role for O(1) lookup
+ *   - `AGENTS_BY_PHASE`       — grouped for statusline / dispatcher tie-breaks
+ *
+ * `fleet.ts` derives `FLEET_ROSTER` + `FLEET_ROSTER_BUDGETS` from this, and the
+ * dispatcher routes free-form tasks against `capability` metadata here.
+ */
+import type { AgentDefinition, AgentPhase } from './types.js';
+import { DISCOVERY_AGENTS } from './phase1-discovery.js';
+import { PLANNING_AGENTS } from './phase2-planning.js';
+import { BUILD_AGENTS } from './phase3-build.js';
+import { VERIFY_AGENTS } from './phase4-verify.js';
+import { REVIEW_AGENTS } from './phase5-review.js';
+import { DOMAIN_AGENTS } from './phase6-domain.js';
+import { KNOWLEDGE_AGENTS } from './phase7-knowledge.js';
+import { DELIVERY_AGENTS } from './phase8-delivery.js';
+import { META_AGENTS } from './phase9-meta.js';
+export * from './types.js';
+export { DISCOVERY_AGENTS, PLANNING_AGENTS, BUILD_AGENTS, VERIFY_AGENTS, REVIEW_AGENTS, DOMAIN_AGENTS, KNOWLEDGE_AGENTS, DELIVERY_AGENTS, META_AGENTS, };
+/** Every catalog agent, in phase order. */
+export declare const ALL_AGENT_DEFINITIONS: AgentDefinition[];
+/** Phase → its agents, for grouped display and dispatcher fallbacks. */
+export declare const AGENTS_BY_PHASE: Record<AgentPhase, AgentDefinition[]>;
+/**
+ * Role → definition. Built once at module load. Throws on a duplicate role so
+ * a copy-paste collision fails loudly at startup instead of silently shadowing.
+ */
+export declare const AGENT_CATALOG: Record<string, AgentDefinition>;
+/** Role lookup helper. Returns undefined for unknown roles. */
+export declare function getAgentDefinition(role: string): AgentDefinition | undefined;
+//# sourceMappingURL=index.d.ts.map

package/dist/coordination/agents/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/coordination/agents/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,cAAc,YAAY,CAAC;AAC3B,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,aAAa,EACb,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,WAAW,GACZ,CAAC;AAEF,2CAA2C;AAC3C,eAAO,MAAM,qBAAqB,EAAE,eAAe,EAUlD,CAAC;AAEF,wEAAwE;AACxE,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,UAAU,EAAE,eAAe,EAAE,CAUjE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAatD,CAAC;AAEL,+DAA+D;AAC/D,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAE5E"}

package/dist/coordination/agents/phase1-discovery.d.ts

@@ -0,0 +1,4 @@
+import { type AgentDefinition } from './types.js';
+/** Phase 1 · Discovery — map the territory before any work begins. */
+export declare const DISCOVERY_AGENTS: AgentDefinition[];
+//# sourceMappingURL=phase1-discovery.d.ts.map

package/dist/coordination/agents/phase1-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase1-discovery.d.ts","sourceRoot":"","sources":["../../../src/coordination/agents/phase1-discovery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAsC,MAAM,YAAY,CAAC;AAGtF,sEAAsE;AACtE,eAAO,MAAM,gBAAgB,EAAE,eAAe,EAkF7C,CAAC"}

package/dist/coordination/agents/phase2-planning.d.ts

@@ -0,0 +1,4 @@
+import { type AgentDefinition } from './types.js';
+/** Phase 2 · Planning — turn intent into requirements, plans, and architecture. */
+export declare const PLANNING_AGENTS: AgentDefinition[];
+//# sourceMappingURL=phase2-planning.d.ts.map

package/dist/coordination/agents/phase2-planning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase2-planning.d.ts","sourceRoot":"","sources":["../../../src/coordination/agents/phase2-planning.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAqC,MAAM,YAAY,CAAC;AAKrF,mFAAmF;AACnF,eAAO,MAAM,eAAe,EAAE,eAAe,EAkI5C,CAAC"}

package/dist/coordination/agents/phase3-build.d.ts

@@ -0,0 +1,4 @@
+import { type AgentDefinition } from './types.js';
+/** Phase 3 · Build — write, refactor, migrate, and fix code. */
+export declare const BUILD_AGENTS: AgentDefinition[];
+//# sourceMappingURL=phase3-build.d.ts.map

package/dist/coordination/agents/phase3-build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase3-build.d.ts","sourceRoot":"","sources":["../../../src/coordination/agents/phase3-build.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAsC,MAAM,YAAY,CAAC;AAGtF,gEAAgE;AAChE,eAAO,MAAM,YAAY,EAAE,eAAe,EAkLzC,CAAC"}

package/dist/coordination/agents/phase3-techstack.d.ts

@@ -0,0 +1,13 @@
+import { type AgentDefinition } from './types.js';
+/**
+ * Phase 3 · Tech Stack — dependency version watchdog.
+ *
+ * Automatically triggered when package manifests (package.json, go.mod, etc.)
+ * are created or edited. Detects the ecosystem, looks up latest versions from
+ * registries, and sends warning messages to the agent that last touched the
+ * file (or broadcasts if unknown).
+ *
+ * Tools: read (manifests), fetch (registry APIs), mailbox (send warnings).
+ */
+export declare const TECHSTACK_AGENTS: AgentDefinition[];
+//# sourceMappingURL=phase3-techstack.d.ts.map

package/dist/coordination/agents/phase3-techstack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase3-techstack.d.ts","sourceRoot":"","sources":["../../../src/coordination/agents/phase3-techstack.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAuB,MAAM,YAAY,CAAC;AAGvE;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,EAAE,eAAe,EA4B7C,CAAC"}

package/dist/coordination/agents/phase4-verify.d.ts

@@ -0,0 +1,4 @@
+import { type AgentDefinition } from './types.js';
+/** Phase 4 · Verify — prove the code works under normal, end-to-end, and adverse conditions. */
+export declare const VERIFY_AGENTS: AgentDefinition[];
+//# sourceMappingURL=phase4-verify.d.ts.map

package/dist/coordination/agents/phase4-verify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase4-verify.d.ts","sourceRoot":"","sources":["../../../src/coordination/agents/phase4-verify.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,eAAe,EAAsC,MAAM,YAAY,CAAC;AAEtF,gGAAgG;AAChG,eAAO,MAAM,aAAa,EAAE,eAAe,EA4S1C,CAAC"}

package/dist/coordination/agents/phase5-review.d.ts

@@ -0,0 +1,4 @@
+import { type AgentDefinition } from './types.js';
+/** Phase 5 · Review — read-only quality, security, a11y, and compliance gates. */
+export declare const REVIEW_AGENTS: AgentDefinition[];
+//# sourceMappingURL=phase5-review.d.ts.map

package/dist/coordination/agents/phase5-review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase5-review.d.ts","sourceRoot":"","sources":["../../../src/coordination/agents/phase5-review.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,eAAe,EAAwB,MAAM,YAAY,CAAC;AAExE,kFAAkF;AAClF,eAAO,MAAM,aAAa,EAAE,eAAe,EA4I1C,CAAC"}

package/dist/coordination/agents/phase6-domain.d.ts

@@ -0,0 +1,4 @@
+import { type AgentDefinition } from './types.js';
+/** Phase 6 · Domain — specialists for the major slices of a system. */
+export declare const DOMAIN_AGENTS: AgentDefinition[];
+//# sourceMappingURL=phase6-domain.d.ts.map

package/dist/coordination/agents/phase6-domain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase6-domain.d.ts","sourceRoot":"","sources":["../../../src/coordination/agents/phase6-domain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAsC,MAAM,YAAY,CAAC;AAGtF,uEAAuE;AACvE,eAAO,MAAM,aAAa,EAAE,eAAe,EA8L1C,CAAC"}

package/dist/coordination/agents/phase7-knowledge.d.ts

@@ -0,0 +1,4 @@
+import { type AgentDefinition } from './types.js';
+/** Phase 7 · Knowledge — documentation, diagrams, localization, and prompts. */
+export declare const KNOWLEDGE_AGENTS: AgentDefinition[];
+//# sourceMappingURL=phase7-knowledge.d.ts.map

package/dist/coordination/agents/phase7-knowledge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase7-knowledge.d.ts","sourceRoot":"","sources":["../../../src/coordination/agents/phase7-knowledge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAsC,MAAM,YAAY,CAAC;AAGtF,gFAAgF;AAChF,eAAO,MAAM,gBAAgB,EAAE,eAAe,EAuG7C,CAAC"}

package/dist/coordination/agents/phase8-delivery.d.ts

@@ -0,0 +1,4 @@
+import { type AgentDefinition } from './types.js';
+/** Phase 8 · Delivery & Ops — ship it, run it, keep it healthy. */
+export declare const DELIVERY_AGENTS: AgentDefinition[];
+//# sourceMappingURL=phase8-delivery.d.ts.map

package/dist/coordination/agents/phase8-delivery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase8-delivery.d.ts","sourceRoot":"","sources":["../../../src/coordination/agents/phase8-delivery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAwB,MAAM,YAAY,CAAC;AAGxE,mEAAmE;AACnE,eAAO,MAAM,eAAe,EAAE,eAAe,EAqK5C,CAAC"}

package/dist/coordination/agents/phase9-meta.d.ts

@@ -0,0 +1,4 @@
+import { type AgentDefinition } from './types.js';
+/** Phase 9 · Meta — agents that improve the agent system itself. */
+export declare const META_AGENTS: AgentDefinition[];
+//# sourceMappingURL=phase9-meta.d.ts.map

package/dist/coordination/agents/phase9-meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase9-meta.d.ts","sourceRoot":"","sources":["../../../src/coordination/agents/phase9-meta.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAsC,MAAM,YAAY,CAAC;AAGtF,oEAAoE;AACpE,eAAO,MAAM,WAAW,EAAE,eAAe,EAgJxC,CAAC"}

package/dist/coordination/agents/types.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Catalog types for the WrongStack agent fleet.
+ *
+ * An `AgentDefinition` bundles the runtime `SubagentConfig` (id/name/role/
+ * prompt/tools) with two things the bare config lacks:
+ *   - a per-role `budget` tier (consumed by FLEET_ROSTER_BUDGETS), and
+ *   - dispatcher `capability` metadata (keywords + summary + phase) used by
+ *     the smart dispatcher to route a free-form task to the best agent.
+ *
+ * Phase files (`phase1-discovery.ts` … `phase9-meta.ts`) each export an
+ * `AgentDefinition[]`; `index.ts` aggregates them into `AGENT_CATALOG`.
+ * `fleet.ts` derives `FLEET_ROSTER` + `FLEET_ROSTER_BUDGETS` from the catalog.
+ */
+import type { SubagentConfig } from '../../types/multi-agent.js';
+/** Lifecycle phase grouping. Drives statusline labels + dispatcher tie-breaks. */
+export type AgentPhase = 'discovery' | 'planning' | 'build' | 'verify' | 'review' | 'domain' | 'knowledge' | 'delivery' | 'meta';
+/** Per-role budget tier. Same shape as fleet.ts `FleetRosterBudget`. */
+export interface AgentBudgetTier {
+    timeoutMs?: number | undefined;
+    maxIterations?: number | undefined;
+    maxToolCalls?: number | undefined;
+    maxTokens?: number | undefined;
+    maxCostUsd?: number | undefined;
+}
+/** Dispatcher routing metadata. */
+export interface AgentCapability {
+    phase: AgentPhase;
+    /**
+     * One-line capability summary. Fed to the LLM dispatcher classifier as the
+     * candidate's description, and shown to the user when explaining a routing
+     * decision. Keep it concrete and distinct from sibling agents.
+     */
+    summary: string;
+    /**
+     * Lowercased signal words/phrases for the heuristic dispatcher. A task whose
+     * description contains these scores toward this agent. Order doesn't matter;
+     * prefer specific terms ("graphql", "wcag") over generic ones ("code").
+     */
+    keywords: string[];
+}
+/** A single catalog entry: runtime config + budget tier + routing metadata. */
+export interface AgentDefinition {
+    config: SubagentConfig;
+    budget: AgentBudgetTier;
+    capability: AgentCapability;
+}
+/**
+ * Budget tiers by workload weight. Deliberately generous — the project's
+ * existing roster uses multi-hour ceilings to avoid spurious timeouts on
+ * monorepo-scale work, and the auto-extend handshake raises them further when
+ * a subagent is still making progress.
+ */
+export declare const LIGHT_BUDGET: AgentBudgetTier;
+export declare const MEDIUM_BUDGET: AgentBudgetTier;
+export declare const HEAVY_BUDGET: AgentBudgetTier;
+/**
+ * Tool allowlist presets. Agents pass the smallest set that covers their job —
+ * a planning agent should not hold `write`/`bash`, a reviewer should be
+ * read-only. Spread + extend per-agent where a role needs one extra tool.
+ */
+export declare const TOOLS: {
+    /** Pure read/inspect — safe for analysis and review agents. */
+    readonly read: readonly ["read", "grep", "glob", "search", "tree", "mailbox"];
+    /** Read + structured inspection (logs, diffs, json, dependency audit). */
+    readonly inspect: readonly ["read", "grep", "glob", "search", "tree", "json", "diff", "logs", "audit", "mailbox"];
+    /** Read + edit (no shell). For agents that write code/docs but don't run it. */
+    readonly write: readonly ["read", "grep", "glob", "search", "tree", "write", "edit", "replace", "patch", "mailbox"];
+    /** Full build loop: edit + run (lint/format/typecheck/test/bash). */
+    readonly build: readonly ["read", "grep", "glob", "search", "tree", "write", "edit", "replace", "patch", "bash", "exec", "lint", "format", "typecheck", "test", "mailbox"];
+    /** Version control. */
+    readonly vcs: readonly ["read", "grep", "glob", "git", "diff"];
+    /** Dependency management + CVE audit. */
+    readonly deps: readonly ["read", "grep", "glob", "install", "outdated", "audit", "json", "mailbox"];
+    /** Documentation authoring. */
+    readonly docs: readonly ["read", "grep", "glob", "search", "tree", "write", "edit", "document", "mailbox"];
+    /** Web research. */
+    readonly research: readonly ["read", "grep", "glob", "search", "fetch", "mailbox"];
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/coordination/agents/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/coordination/agents/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,kFAAkF;AAClF,MAAM,MAAM,UAAU,GAClB,WAAW,GACX,UAAU,GACV,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,WAAW,GACX,UAAU,GACV,MAAM,CAAC;AAEX,wEAAwE;AACxE,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAED,mCAAmC;AACnC,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,UAAU,CAAC;IAClB;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,+EAA+E;AAC/E,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,eAAe,CAAC;IACxB,UAAU,EAAE,eAAe,CAAC;CAC7B;AAID;;;;;GAKG;AACH,eAAO,MAAM,YAAY,EAAE,eAI1B,CAAC;AACF,eAAO,MAAM,aAAa,EAAE,eAI3B,CAAC;AACF,eAAO,MAAM,YAAY,EAAE,eAI1B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,KAAK;IAChB,+DAA+D;;IAE/D,0EAA0E;;IAE1E,gFAAgF;;IAEhF,qEAAqE;;IAmBrE,uBAAuB;;IAEvB,yCAAyC;;IAEzC,+BAA+B;;IAE/B,oBAAoB;;CAEgC,CAAC"}

package/dist/coordination/agents.d.ts

@@ -0,0 +1,8 @@
+export { InMemoryAgentBridge, InMemoryBridgeTransport, createMessage, } from './agent-bridge.js';
+export { AUDIT_LOG_AGENT, BUG_HUNTER_AGENT, REFACTOR_PLANNER_AGENT, SECURITY_SCANNER_AGENT, 
+/**
+ * Public fleet role registry consumed by CLI director/delegate wiring and
+ * plugin API consumers. Keep exported from this barrel for compatibility.
+ */
+FLEET_ROSTER, ALL_FLEET_AGENTS, } from './fleet.js';
+//# sourceMappingURL=agents.d.ts.map

package/dist/coordination/agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/coordination/agents.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,aAAa,GACd,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,sBAAsB,EACtB,sBAAsB;AACtB;;;GAGG;AACH,YAAY,EACZ,gBAAgB,GACjB,MAAM,YAAY,CAAC"}

package/dist/coordination/auto-extend.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Default auto-extend policy for subagent budgets.
+ *
+ * The budget's soft-limit path (`SubagentBudget` → `budget.threshold_reached`)
+ * only negotiates an extension when SOMETHING listens on the EventBus. Under a
+ * `Director`, that listener is the director's own auto-extend handler. On the
+ * plain coordinator path (e.g. a bare `/spawn` with no director) nothing
+ * listens, so the budget falls back to a hard stop and the subagent dies the
+ * moment it crosses a soft limit.
+ *
+ * `attachAutoExtend` is the additive fix: wire it to a subagent's EventBus and
+ * budget overruns are auto-granted headroom instead of killing the run. It is
+ * heartbeat-aware for the timeout kind — wall-clock time always advances, so a
+ * naive "extend timeout forever" would let a wedged agent run indefinitely.
+ * Instead, a timeout extension is granted only when the agent has executed a
+ * new tool call or started a new iteration since the last timeout extension.
+ * No progress since last time ⇒ the agent is genuinely stuck ⇒ deny and let it
+ * fail. The non-timeout kinds (iterations/tool_calls/tokens/cost) extend up to
+ * a per-kind cap, then deny — those ceilings are the real runaway guard.
+ */
+import type { EventBus } from '../kernel/events.js';
+export interface AutoExtendCeiling {
+    maxIterations?: number | undefined;
+    maxToolCalls?: number | undefined;
+    maxTokens?: number | undefined;
+    maxCostUsd?: number | undefined;
+    timeoutMs?: number | undefined;
+}
+export interface AutoExtendPolicy {
+    /** Multiplier applied to the tripped limit when extending. Default 0.5 (+50%). */
+    factor?: number | undefined;
+    /**
+     * Max extensions per NON-timeout kind before denying. Timeout is governed by
+     * the heartbeat check, not this cap, so it can extend indefinitely while the
+     * agent makes progress. Default 8.
+     */
+    maxExtensionsPerKind?: number | undefined;
+    /** Absolute ceilings — an extension never pushes a limit past these. */
+    ceiling?: AutoExtendCeiling | undefined;
+}
+/**
+ * Attach an auto-extend policy to a subagent's EventBus. Returns an unsubscribe
+ * function that detaches all listeners — call it when the subagent task ends.
+ */
+export declare function attachAutoExtend(events: EventBus, policy?: AutoExtendPolicy): () => void;
+//# sourceMappingURL=auto-extend.d.ts.map

package/dist/coordination/auto-extend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-extend.d.ts","sourceRoot":"","sources":["../../src/coordination/auto-extend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,WAAW,iBAAiB;IAChC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B,kFAAkF;IAClF,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,wEAAwE;IACxE,OAAO,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;CACzC;AAqBD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAE,gBAAqB,GAAG,MAAM,IAAI,CAiE5F"}

package/dist/coordination/autonomous-brain.d.ts

@@ -0,0 +1,154 @@
+import type { BrainArbiter, BrainDecision, BrainDecisionOption, BrainDecisionRequest, BrainDecisionSource, BrainRisk } from './brain.js';
+import type { DecisionNode, GoalNode, FactNode, ChangeNode } from './knowledge-graph.js';
+import type { KnowledgeGraph } from './knowledge-graph.js';
+import type { FleetBus } from './fleet-bus.js';
+export type { BrainRisk };
+export type AutonomousDecisionType = 'spawn' | 'approve_change' | 'reject_change' | 'prioritize_goals' | 'escalate_task' | 'rollback_change' | 'retry_task' | 'merge_results' | 'decompose_goal' | 'assign_task';
+export interface AutonomousDecisionRequest {
+    id: string;
+    source: BrainDecisionSource;
+    decisionType: AutonomousDecisionType;
+    question: string;
+    context: {
+        /** Relevant facts from the knowledge graph */
+        facts?: FactNode[];
+        /** Goals relevant to this decision */
+        goals?: GoalNode[];
+        /** Change being reviewed (for approval decisions) */
+        change?: ChangeNode;
+        /** Current fleet status */
+        fleetStatus?: {
+            running: number;
+            idle: number;
+            total: number;
+            costSoFar: number;
+        };
+        /** Task that triggered this decision */
+        taskDescription?: string;
+        /** Error that triggered escalation, if any */
+        error?: string;
+        /** Number of times this task has been attempted */
+        attempts?: number;
+    };
+    options: BrainDecisionOption[];
+    risk: BrainRisk;
+    /** Whether this decision requires consensus */
+    requiresConsensus: boolean;
+}
+export interface SpawnDecision {
+    role: string;
+    budget: {
+        timeoutMs?: number;
+        maxIterations?: number;
+        maxToolCalls?: number;
+        maxCostUsd?: number;
+    };
+    rationale: string;
+}
+export interface ApprovalDecision {
+    approved: boolean;
+    rationale: string;
+    waivers?: string[];
+    conditions?: string[];
+}
+export interface PrioritizationDecision {
+    orderedGoals: string[];
+    rationale: string;
+}
+export interface EscalationDecision {
+    action: 'retry' | 'delegate' | 'mark_failed' | 'ask_for_help';
+    rationale: string;
+    budgetAdjustment?: {
+        increaseFactor?: number;
+        newTimeoutMs?: number;
+        addModel?: string;
+    };
+}
+export interface AutonomousBrainOptions {
+    /** The LLM provider for making decisions */
+    llmProvider: LLMProvider;
+    graph: KnowledgeGraph;
+    fleet?: FleetBus | undefined;
+    /** Maximum retries before a task is marked failed. Default: 3. */
+    maxRetries?: number | undefined;
+    /** Risk threshold above which consensus is required. Default: 'high'. */
+    consensusRiskThreshold?: BrainRisk | undefined;
+    /** Self-improve: track decision history for learning. Default: true. */
+    selfImprove?: boolean | undefined;
+}
+export interface LLMProvider {
+    /**
+     * Generate a decision. Receives the full context as a structured prompt.
+     * Returns the chosen option id and rationale.
+     */
+    decide(prompt: DecisionPrompt): Promise<{
+        optionId: string;
+        rationale: string;
+    }>;
+}
+export interface DecisionPrompt {
+    decisionType: AutonomousDecisionType;
+    question: string;
+    context: string;
+    options: BrainDecisionOption[];
+    risk: BrainRisk;
+    decisionHistory: DecisionNode[];
+    /** Hints derived from self-improvement data */
+    selfImproveHints?: string[];
+}
+export declare class AutonomousBrain implements BrainArbiter {
+    private readonly graph;
+    private readonly fleetBus?;
+    private readonly llmProvider;
+    private readonly maxRetries;
+    private readonly consensusRiskThreshold;
+    private readonly selfImprove;
+    /** Decision history for self-improvement and audit. */
+    private decisionHistory;
+    /** Tracks failure patterns for self-improvement. */
+    private failurePatterns;
+    private readonly RISK_ORDER;
+    private _emit;
+    constructor(opts: AutonomousBrainOptions);
+    /** Implements BrainArbiter — bridges standard brain.ts interface to autonomous engine. */
+    decide(request: BrainDecisionRequest): Promise<BrainDecision>;
+    /**
+     * Primary autonomous decision engine — receives AutonomousDecisionRequest,
+     * queries the LLM, records the decision, and returns a BrainDecision.
+     *
+     * Specialized methods (decideSpawn, decideApproval, etc.) should call this
+     * directly with a pre-built AutonomousDecisionRequest.
+     */
+    decideAuto(request: AutonomousDecisionRequest): Promise<BrainDecision>;
+    /**
+     * Decide whether to spawn a subagent, which role to use, and what budget.
+     */
+    decideSpawn(source: BrainDecisionSource, taskDescription: string, availableFacts: FactNode[], fleetStatus: {
+        running: number;
+        idle: number;
+        total: number;
+        costSoFar: number;
+    }): Promise<BrainDecision>;
+    /**
+     * Decide whether to approve a proposed change.
+     */
+    decideApproval(source: BrainDecisionSource, change: ChangeNode, relevantFacts: FactNode[]): Promise<BrainDecision>;
+    /**
+     * Decide how to handle a failed task.
+     */
+    decideEscalation(source: BrainDecisionSource, taskId: string, error: string, attempts: number): Promise<BrainDecision>;
+    /**
+     * Record the outcome of a decision for self-improvement.
+     * Call this after a spawned agent completes or a change is applied.
+     */
+    recordOutcome(decisionId: string, outcome: 'success' | 'failure', _detail?: string): void;
+    private _getSelfImproveHints;
+    private _toAutonomous;
+    private _inferDecisionType;
+    private _serializeContext;
+    private _loadHistory;
+    private _recordDecision;
+    private _inferRoles;
+    private _changeRisk;
+}
+//# sourceMappingURL=autonomous-brain.d.ts.map

package/dist/coordination/autonomous-brain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autonomous-brain.d.ts","sourceRoot":"","sources":["../../src/coordination/autonomous-brain.ts"],"names":[],"mappings":"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"}