@oni.bot/core 0.8.0 → 1.0.0

package/dist/oni-code/tools/plan.js

@@ -0,0 +1,48 @@
+/**
+ * Plan Mode Tools — switch between build (full access) and plan (read-only) agents.
+ *
+ * plan_enter: Switch to plan mode for read-only exploration and planning.
+ * plan_exit: Switch back to build mode for implementation.
+ *
+ * The switch takes effect on the next chat() invocation. The current turn
+ * completes normally, and subsequent turns use the new agent's system prompt
+ * and tool scoping. Write tools are also blocked in plan mode via the
+ * Conductor's PreToolUse hook for double enforcement.
+ */
+import { defineTool } from "../../tools/define.js";
+export function makePlanTools(host) {
+    const planEnter = defineTool({
+        name: "plan_enter",
+        description: "Switch to plan mode — read-only exploration and planning. Use when you need to analyze the codebase and create a structured plan before implementing. Write tools are disabled in plan mode.",
+        schema: {
+            type: "object",
+            properties: {},
+        },
+        execute: () => {
+            host.switchAgent("plan");
+            return {
+                switched: true,
+                agent: "plan",
+                message: "Switched to plan mode. You can read files, search code, and browse directories, but cannot write, edit, or run destructive commands. Use plan_exit when planning is complete.",
+            };
+        },
+    });
+    const planExit = defineTool({
+        name: "plan_exit",
+        description: "Exit plan mode and switch back to build mode for implementation. Use when your plan is complete and ready for implementation.",
+        schema: {
+            type: "object",
+            properties: {},
+        },
+        execute: () => {
+            host.switchAgent("build");
+            return {
+                switched: true,
+                agent: "build",
+                message: "Switched to build mode. Full tool access restored — you can now implement the plan.",
+            };
+        },
+    });
+    return [planEnter, planExit];
+}
+//# sourceMappingURL=plan.js.map

package/dist/oni-code/tools/plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../../src/oni-code/tools/plan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAOnD,MAAM,UAAU,aAAa,CAAC,IAAkB;IAC9C,MAAM,SAAS,GAAG,UAAU,CAAC;QAC3B,IAAI,EAAE,YAAY;QAClB,WAAW,EACT,8LAA8L;QAChM,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;SACf;QACD,OAAO,EAAE,GAAG,EAAE;YACZ,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YACzB,OAAO;gBACL,QAAQ,EAAE,IAAI;gBACd,KAAK,EAAE,MAAM;gBACb,OAAO,EACL,+KAA+K;aAClL,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,UAAU,CAAC;QAC1B,IAAI,EAAE,WAAW;QACjB,WAAW,EACT,+HAA+H;QACjI,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;SACf;QACD,OAAO,EAAE,GAAG,EAAE;YACZ,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YAC1B,OAAO;gBACL,QAAQ,EAAE,IAAI;gBACd,KAAK,EAAE,OAAO;gBACd,OAAO,EACL,qFAAqF;aACxF,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;IAEH,OAAO,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AAC/B,CAAC"}

package/dist/oni-code/tools/question.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Question Tool — pause agent execution to ask the user a question.
+ *
+ * Uses the Promise-based pause/resume pattern: the tool calls ctx.askUser(),
+ * which blocks until the UI resolves with the user's answer.
+ *
+ * The Conductor wires a questionListener that:
+ * 1. Yields a "question" LoopMessage for the UI to render
+ * 2. Waits for the user's response
+ * 3. Resolves the Promise, resuming tool execution
+ *
+ * If no questionListener is configured (auto mode, subagents), the tool
+ * returns a message indicating the question was skipped.
+ */
+import type { ToolDefinition } from "../../tools/types.js";
+export declare function makeQuestionTool(): ToolDefinition;
+//# sourceMappingURL=question.d.ts.map

package/dist/oni-code/tools/question.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"question.d.ts","sourceRoot":"","sources":["../../../src/oni-code/tools/question.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,sBAAsB,CAAC;AAGxE,wBAAgB,gBAAgB,IAAI,cAAc,CAoCjD"}

package/dist/oni-code/tools/question.js

@@ -0,0 +1,46 @@
+/**
+ * Question Tool — pause agent execution to ask the user a question.
+ *
+ * Uses the Promise-based pause/resume pattern: the tool calls ctx.askUser(),
+ * which blocks until the UI resolves with the user's answer.
+ *
+ * The Conductor wires a questionListener that:
+ * 1. Yields a "question" LoopMessage for the UI to render
+ * 2. Waits for the user's response
+ * 3. Resolves the Promise, resuming tool execution
+ *
+ * If no questionListener is configured (auto mode, subagents), the tool
+ * returns a message indicating the question was skipped.
+ */
+import { defineTool } from "../../tools/define.js";
+export function makeQuestionTool() {
+    return defineTool({
+        name: "question",
+        description: "Ask the user a question and wait for their answer. Use when you need clarification, confirmation, or user input to proceed. The agent pauses until the user responds.",
+        schema: {
+            type: "object",
+            properties: {
+                question: {
+                    type: "string",
+                    description: "The question to ask the user",
+                },
+            },
+            required: ["question"],
+        },
+        execute: async (input, ctx) => {
+            const harnessCtx = ctx;
+            if (typeof harnessCtx.askUser !== "function") {
+                return {
+                    answer: null,
+                    answered: false,
+                };
+            }
+            const answer = await harnessCtx.askUser(input.question);
+            return {
+                answer,
+                answered: answer !== null,
+            };
+        },
+    });
+}
+//# sourceMappingURL=question.js.map

package/dist/oni-code/tools/question.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"question.js","sourceRoot":"","sources":["../../../src/oni-code/tools/question.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAInD,MAAM,UAAU,gBAAgB;IAC9B,OAAO,UAAU,CAAC;QAChB,IAAI,EAAE,UAAU;QAChB,WAAW,EACT,uKAAuK;QACzK,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,8BAA8B;iBAC5C;aACF;YACD,QAAQ,EAAE,CAAC,UAAU,CAAC;SACvB;QACD,OAAO,EAAE,KAAK,EACZ,KAA2B,EAC3B,GAAgB,EACuC,EAAE;YACzD,MAAM,UAAU,GAAG,GAAyB,CAAC;YAE7C,IAAI,OAAO,UAAU,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;gBAC7C,OAAO;oBACL,MAAM,EAAE,IAAI;oBACZ,QAAQ,EAAE,KAAK;iBAChB,CAAC;YACJ,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YAExD,OAAO;gBACL,MAAM;gBACN,QAAQ,EAAE,MAAM,KAAK,IAAI;aAC1B,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/oni-code/tools/skill.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Skill Creation Tool — allows the agent to create new SKILL.md files at runtime.
+ *
+ * Writes to ~/.oni/skills/<name>/SKILL.md so skills persist across sessions.
+ * After writing, hot-reloads the SkillLoader so the new skill is immediately available.
+ *
+ * Validation (moderate):
+ * - Name must be kebab-case (lowercase alphanumeric + hyphens)
+ * - Description required, <= 1024 chars
+ * - Duplicate name detection across all loaded skills
+ * - Warning (non-blocking) if body has no ## headings
+ */
+import type { ToolDefinition } from "../../tools/types.js";
+import type { SkillLoader } from "../../harness/skill-loader.js";
+export interface CreateSkillInput {
+    name: string;
+    description: string;
+    content: string;
+    allowedTools?: string;
+    argumentHint?: string;
+    disableModelInvocation?: boolean;
+}
+export interface CreateSkillResult {
+    status: "created";
+    path: string;
+    name: string;
+    warnings?: string[];
+}
+export interface CreateSkillToolOptions {
+    /** Override base directory for skill storage (default: ~/.oni/skills) */
+    baseDir?: string;
+}
+export declare function makeCreateSkillTool(skillLoader: SkillLoader, options?: CreateSkillToolOptions): ToolDefinition<CreateSkillInput, CreateSkillResult | {
+    error: string;
+}>;
+//# sourceMappingURL=skill.d.ts.map

package/dist/oni-code/tools/skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../../src/oni-code/tools/skill.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAUjE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,SAAS,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAyCD,MAAM,WAAW,sBAAsB;IACrC,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,WAAW,EACxB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,cAAc,CAAC,gBAAgB,EAAE,iBAAiB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CA+FzE"}

package/dist/oni-code/tools/skill.js

@@ -0,0 +1,132 @@
+/**
+ * Skill Creation Tool — allows the agent to create new SKILL.md files at runtime.
+ *
+ * Writes to ~/.oni/skills/<name>/SKILL.md so skills persist across sessions.
+ * After writing, hot-reloads the SkillLoader so the new skill is immediately available.
+ *
+ * Validation (moderate):
+ * - Name must be kebab-case (lowercase alphanumeric + hyphens)
+ * - Description required, <= 1024 chars
+ * - Duplicate name detection across all loaded skills
+ * - Warning (non-blocking) if body has no ## headings
+ */
+import { defineTool } from "../../tools/define.js";
+import { mkdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+// ── Validation ─────────────────────────────────────────────────────────
+const KEBAB_CASE = /^[a-z0-9]+(-[a-z0-9]+)*$/;
+const MAX_DESCRIPTION_LENGTH = 1024;
+function validateName(name) {
+    if (!name)
+        return "name is required";
+    if (!KEBAB_CASE.test(name)) {
+        return `name must be kebab-case (lowercase letters, numbers, hyphens). Got: "${name}"`;
+    }
+    return null;
+}
+function validateDescription(description) {
+    if (!description)
+        return "description is required";
+    if (description.length > MAX_DESCRIPTION_LENGTH) {
+        return `description must be <= ${MAX_DESCRIPTION_LENGTH} characters. Got: ${description.length}`;
+    }
+    return null;
+}
+// ── Frontmatter Builder ────────────────────────────────────────────────
+function buildFrontmatter(input) {
+    const lines = ["---"];
+    lines.push(`name: ${input.name}`);
+    lines.push(`description: ${input.description}`);
+    if (input.allowedTools) {
+        lines.push(`allowed-tools: ${input.allowedTools}`);
+    }
+    if (input.argumentHint) {
+        lines.push(`argument-hint: ${input.argumentHint}`);
+    }
+    if (input.disableModelInvocation) {
+        lines.push(`disable-model-invocation: true`);
+    }
+    lines.push("---");
+    return lines.join("\n");
+}
+export function makeCreateSkillTool(skillLoader, options) {
+    const baseDir = options?.baseDir ?? join(homedir(), ".oni", "skills");
+    return defineTool({
+        name: "create_skill",
+        description: "Create a new reusable SKILL.md file that persists across sessions. " +
+            "Skills are saved to ~/.oni/skills/<name>/SKILL.md and become immediately available. " +
+            "Use when the user asks to save a technique, pattern, or workflow as a skill.",
+        schema: {
+            type: "object",
+            properties: {
+                name: {
+                    type: "string",
+                    description: "Skill identifier in kebab-case (e.g. 'code-review', 'deploy-staging')",
+                },
+                description: {
+                    type: "string",
+                    description: 'One-line description starting with "Use when..." — triggers for when this skill should be invoked',
+                },
+                content: {
+                    type: "string",
+                    description: "Markdown body of the skill (everything after the frontmatter). Should include ## Overview, instructions, examples, etc.",
+                },
+                allowedTools: {
+                    type: "string",
+                    description: 'Optional comma-separated tool patterns pre-approved during skill execution (e.g. "Bash(git *), Read")',
+                },
+                argumentHint: {
+                    type: "string",
+                    description: 'Optional hint for arguments (e.g. "[file-path]", "[environment]")',
+                },
+                disableModelInvocation: {
+                    type: "boolean",
+                    description: "If true, agent cannot auto-invoke this skill — user only via /name",
+                },
+            },
+            required: ["name", "description", "content"],
+            additionalProperties: false,
+        },
+        execute: async (input) => {
+            // ── Validate ──
+            const nameErr = validateName(input.name);
+            if (nameErr)
+                return { error: nameErr };
+            const descErr = validateDescription(input.description);
+            if (descErr)
+                return { error: descErr };
+            // Duplicate check
+            const existing = skillLoader.get(input.name);
+            if (existing) {
+                return {
+                    error: `Skill "${input.name}" already exists at ${existing.sourcePath}. Choose a different name or edit the existing skill.`,
+                };
+            }
+            // ── Build SKILL.md content ──
+            const frontmatter = buildFrontmatter(input);
+            const fullContent = `${frontmatter}\n\n${input.content}\n`;
+            // ── Write to disk ──
+            const skillDir = join(baseDir, input.name);
+            const skillPath = join(skillDir, "SKILL.md");
+            mkdirSync(skillDir, { recursive: true });
+            writeFileSync(skillPath, fullContent, "utf-8");
+            // ── Hot-reload ──
+            skillLoader.loadSkillFromFile(skillPath);
+            // ── Warnings ──
+            const warnings = [];
+            if (!input.content.includes("## ")) {
+                warnings.push("Skill body has no ## headings. Consider adding ## Overview, ## When to Use, etc.");
+            }
+            const result = {
+                status: "created",
+                path: skillPath,
+                name: input.name,
+            };
+            if (warnings.length > 0)
+                result.warnings = warnings;
+            return result;
+        },
+    });
+}
+//# sourceMappingURL=skill.js.map

package/dist/oni-code/tools/skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.js","sourceRoot":"","sources":["../../../src/oni-code/tools/skill.ts"],"names":[],"mappings":"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"}

package/dist/oni-code/tools/spawn-agents.d.ts

@@ -0,0 +1,37 @@
+/**
+ * spawn_agents — Dispatch parallel (or sequential) subagents for independent
+ * tasks. Each agent runs in its own context and results are compressed into
+ * summaries via the output summarizer.
+ */
+import type { ToolDefinition } from "../../tools/types.js";
+export interface AgentTask {
+    task: string;
+    tools?: string[];
+}
+interface AgentRunResult {
+    result: string;
+    filesModified: string[];
+    errors: string[];
+}
+export interface SpawnAgentsConfig {
+    runAgent: (task: string, index: number, agentName?: string) => Promise<AgentRunResult>;
+}
+interface SpawnAgentsInput {
+    agents: AgentTask[];
+    mode?: "parallel" | "sequential";
+}
+interface AgentResultEntry {
+    task: string;
+    summary: string;
+    filesModified: string[];
+    error?: string;
+}
+interface SpawnAgentsOutput {
+    agentCount: number;
+    mode: "parallel" | "sequential";
+    results: AgentResultEntry[];
+    totalDuration: number;
+}
+export declare function makeSpawnAgentsTool(config: SpawnAgentsConfig): ToolDefinition<SpawnAgentsInput, SpawnAgentsOutput>;
+export {};
+//# sourceMappingURL=spawn-agents.d.ts.map

package/dist/oni-code/tools/spawn-agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn-agents.d.ts","sourceRoot":"","sources":["../../../src/oni-code/tools/spawn-agents.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAK3D,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,UAAU,cAAc;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;CACxF;AAID,UAAU,gBAAgB;IACxB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,IAAI,CAAC,EAAE,UAAU,GAAG,YAAY,CAAC;CAClC;AAED,UAAU,gBAAgB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,iBAAiB;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,UAAU,GAAG,YAAY,CAAC;IAChC,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;CACvB;AAID,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,iBAAiB,GACxB,cAAc,CAAC,gBAAgB,EAAE,iBAAiB,CAAC,CA2FrD"}

package/dist/oni-code/tools/spawn-agents.js

@@ -0,0 +1,91 @@
+/**
+ * spawn_agents — Dispatch parallel (or sequential) subagents for independent
+ * tasks. Each agent runs in its own context and results are compressed into
+ * summaries via the output summarizer.
+ */
+import { defineTool } from "../../tools/define.js";
+import { summarizeAgentResult } from "../summarizer.js";
+// ── Factory ─────────────────────────────────────────────────
+export function makeSpawnAgentsTool(config) {
+    async function runOne(agent, index, startTime) {
+        try {
+            const res = await config.runAgent(agent.task, index);
+            const duration = (Date.now() - startTime) / 1000;
+            const summary = summarizeAgentResult({
+                task: agent.task,
+                result: res.result,
+                filesModified: res.filesModified,
+                errors: res.errors,
+                duration,
+            });
+            return {
+                task: agent.task,
+                summary,
+                filesModified: res.filesModified,
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                task: agent.task,
+                summary: "",
+                filesModified: [],
+                error: message,
+            };
+        }
+    }
+    return defineTool({
+        name: "spawn_agents",
+        description: "Dispatch parallel subagents for independent tasks. Each agent runs in its own context. Returns summaries.",
+        schema: {
+            type: "object",
+            properties: {
+                agents: {
+                    type: "array",
+                    items: {
+                        type: "object",
+                        properties: {
+                            task: { type: "string", description: "Task description for the subagent" },
+                            tools: {
+                                type: "array",
+                                items: { type: "string" },
+                                description: "Optional list of tool names available to the agent",
+                            },
+                        },
+                        required: ["task"],
+                    },
+                    description: "Array of agent tasks to dispatch",
+                },
+                mode: {
+                    type: "string",
+                    enum: ["parallel", "sequential"],
+                    description: "Execution mode (default: parallel)",
+                },
+            },
+            required: ["agents"],
+        },
+        execute: async (input) => {
+            const mode = input.mode ?? "parallel";
+            const startTime = Date.now();
+            let results;
+            if (mode === "sequential") {
+                results = [];
+                for (let i = 0; i < input.agents.length; i++) {
+                    const entry = await runOne(input.agents[i], i, startTime);
+                    results.push(entry);
+                }
+            }
+            else {
+                results = await Promise.all(input.agents.map((agent, i) => runOne(agent, i, startTime)));
+            }
+            const totalDuration = (Date.now() - startTime) / 1000;
+            return {
+                agentCount: input.agents.length,
+                mode,
+                results,
+                totalDuration,
+            };
+        },
+    });
+}
+//# sourceMappingURL=spawn-agents.js.map

package/dist/oni-code/tools/spawn-agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn-agents.js","sourceRoot":"","sources":["../../../src/oni-code/tools/spawn-agents.ts"],"names":[],"mappings":"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"}

package/dist/oni-code/tools/spawn-swarm.d.ts

@@ -0,0 +1,70 @@
+/**
+ * spawn_swarm tool — dispatches topology-aware swarms.
+ *
+ * Supports all 7 ONI swarm topologies: debate, fanOut, pipeline,
+ * mapReduce, hierarchical, peerNetwork, hierarchicalMesh.
+ */
+import type { ToolDefinition } from "../../tools/types.js";
+export declare const TOPOLOGY_DESCRIPTIONS: Record<string, string>;
+export type Topology = keyof typeof TOPOLOGY_DESCRIPTIONS;
+export interface SwarmAgentInput {
+    id: string;
+    role: string;
+    model?: string;
+    systemPrompt: string;
+    tools?: string[];
+}
+export interface SpawnSwarmInput {
+    topology: Topology;
+    task: string;
+    agents: SwarmAgentInput[];
+    judge?: {
+        model?: string;
+        maxRounds?: number;
+        consensusKeyword?: string;
+    };
+    tools?: string[];
+    maxTurns?: number;
+    mode?: "interactive" | "auto";
+}
+export interface SwarmConfig {
+    topology: Topology;
+    task: string;
+    agents: SwarmAgentInput[];
+    judge?: {
+        model?: string;
+        maxRounds?: number;
+        consensusKeyword?: string;
+    };
+    tools: string[];
+    maxTurns: number;
+}
+export interface SwarmRunner {
+    run: (config: SwarmConfig, perCallProgress?: SwarmProgressCallback, opts?: SwarmRunnerOpts) => Promise<{
+        outcome: string;
+        agentSummaries: Array<{
+            id: string;
+            summary: string;
+        }>;
+        filesModified: string[];
+        duration: number;
+    }>;
+}
+/** Callback for swarm progress reporting. */
+export type SwarmProgressCallback = (event: {
+    type: string;
+    agentId?: string;
+    message?: string;
+    timestamp: number;
+}) => void;
+/** Options for a swarm run call. */
+export interface SwarmRunnerOpts {
+    signal?: AbortSignal;
+    model?: import("../../models/types.js").ONIModel;
+    rootDir?: string;
+    tools?: import("../../tools/types.js").ToolDefinition[];
+    onProgress?: SwarmProgressCallback;
+}
+export declare function buildSwarmConfig(input: SpawnSwarmInput): SwarmConfig;
+export declare function makeSpawnSwarmTool(runner: SwarmRunner): ToolDefinition;
+//# sourceMappingURL=spawn-swarm.d.ts.map

package/dist/oni-code/tools/spawn-swarm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn-swarm.d.ts","sourceRoot":"","sources":["../../../src/oni-code/tools/spawn-swarm.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAK3D,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAexD,CAAC;AAIF,MAAM,MAAM,QAAQ,GAAG,MAAM,OAAO,qBAAqB,CAAC;AAE1D,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1E,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,aAAa,GAAG,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1E,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,eAAe,CAAC,EAAE,qBAAqB,EAAE,IAAI,CAAC,EAAE,eAAe,KAAK,OAAO,CAAC;QACrG,OAAO,EAAE,MAAM,CAAC;QAChB,cAAc,EAAE,KAAK,CAAC;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACvD,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;CACJ;AAED,6CAA6C;AAC7C,MAAM,MAAM,qBAAqB,GAAG,CAAC,KAAK,EAAE;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB,KAAK,IAAI,CAAC;AAEX,oCAAoC;AACpC,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,uBAAuB,EAAE,QAAQ,CAAC;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,sBAAsB,EAAE,cAAc,EAAE,CAAC;IACxD,UAAU,CAAC,EAAE,qBAAqB,CAAC;CACpC;AAkBD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,WAAW,CASpE;AAWD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG,cAAc,CAoFtE"}

package/dist/oni-code/tools/spawn-swarm.js

@@ -0,0 +1,129 @@
+/**
+ * spawn_swarm tool — dispatches topology-aware swarms.
+ *
+ * Supports all 7 ONI swarm topologies: debate, fanOut, pipeline,
+ * mapReduce, hierarchical, peerNetwork, hierarchicalMesh.
+ */
+import { defineTool } from "../../tools/define.js";
+import { summarizeSwarmResult } from "../summarizer.js";
+// ── Topology Descriptions ─────────────────────────────────────
+export const TOPOLOGY_DESCRIPTIONS = {
+    debate: "Multi-round debate with judge — for architecture decisions, trade-off analysis, code review with multiple perspectives",
+    fanOut: "Parallel independent agents with synthesis — for parallel independent work that gets combined",
+    pipeline: "Sequential multi-stage — for sequential work where each stage feeds the next",
+    mapReduce: "Analyze many inputs then synthesize — for analyzing many files or inputs and producing a combined conclusion",
+    hierarchical: "Manager delegates to specialists — for complex tasks needing a manager who delegates to specialist agents",
+    peerNetwork: "Agents collaborate and hand off freely — for open-ended collaboration where agents decide who works next",
+    hierarchicalMesh: "Multi-team with sub-topologies — for multi-team projects where each team has its own internal topology",
+};
+// ── Defaults ──────────────────────────────────────────────────
+const DEFAULT_TOOLS = [
+    "read_file",
+    "edit_file",
+    "write_file",
+    "bash",
+    "grep",
+    "glob",
+    "git",
+];
+const DEFAULT_MAX_TURNS = 30;
+// ── buildSwarmConfig ──────────────────────────────────────────
+export function buildSwarmConfig(input) {
+    return {
+        topology: input.topology,
+        task: input.task,
+        agents: input.agents,
+        ...(input.judge !== undefined ? { judge: input.judge } : {}),
+        tools: input.tools ?? DEFAULT_TOOLS,
+        maxTurns: input.maxTurns ?? DEFAULT_MAX_TURNS,
+    };
+}
+// ── makeSpawnSwarmTool ────────────────────────────────────────
+function buildTopologyEnumDescription() {
+    const lines = Object.entries(TOPOLOGY_DESCRIPTIONS).map(([key, desc]) => `  - ${key}: ${desc}`);
+    return lines.join("\n");
+}
+export function makeSpawnSwarmTool(runner) {
+    return defineTool({
+        name: "spawn_swarm",
+        description: [
+            "Spawn a multi-agent swarm with a specific topology.",
+            "",
+            "Available topologies:",
+            buildTopologyEnumDescription(),
+        ].join("\n"),
+        schema: {
+            type: "object",
+            properties: {
+                topology: {
+                    type: "string",
+                    enum: Object.keys(TOPOLOGY_DESCRIPTIONS),
+                    description: "The swarm topology to use",
+                },
+                task: {
+                    type: "string",
+                    description: "The task for the swarm to accomplish",
+                },
+                agents: {
+                    type: "array",
+                    items: {
+                        type: "object",
+                        properties: {
+                            id: { type: "string", description: "Unique agent identifier" },
+                            role: { type: "string", description: "Agent role description" },
+                            model: { type: "string", description: "Model to use (optional)" },
+                            systemPrompt: { type: "string", description: "System prompt for the agent" },
+                        },
+                        required: ["id", "role", "systemPrompt"],
+                    },
+                    description: "Array of agent definitions",
+                },
+                judge: {
+                    type: "object",
+                    properties: {
+                        model: { type: "string", description: "Model for the judge (optional)" },
+                        maxRounds: { type: "number", description: "Max debate rounds (optional)" },
+                        consensusKeyword: { type: "string", description: "Keyword to signal consensus (optional)" },
+                    },
+                    description: "Judge configuration (for debate topology)",
+                },
+                tools: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Tool names available to agents (defaults to standard coding tools)",
+                },
+                maxTurns: {
+                    type: "number",
+                    description: "Maximum turns for the swarm (default 30)",
+                },
+                mode: {
+                    type: "string",
+                    enum: ["interactive", "auto"],
+                    description: "Execution mode (default auto)",
+                },
+            },
+            required: ["topology", "task", "agents"],
+        },
+        execute: async (input, ctx) => {
+            const config = buildSwarmConfig(input);
+            const signal = "signal" in ctx ? ctx.signal : undefined;
+            const result = await runner.run(config, undefined, { signal });
+            const summary = summarizeSwarmResult({
+                topology: config.topology,
+                task: config.task,
+                outcome: result.outcome,
+                agentSummaries: result.agentSummaries,
+                filesModified: result.filesModified,
+                duration: result.duration,
+            });
+            return {
+                outcome: result.outcome,
+                agentSummaries: result.agentSummaries,
+                filesModified: result.filesModified,
+                duration: result.duration,
+                summary,
+            };
+        },
+    });
+}
+//# sourceMappingURL=spawn-swarm.js.map