@simulacra-ai/orchestration 0.0.1

package/dist/orchestrator.js

@@ -0,0 +1,124 @@
+import { Workflow, WorkflowManager } from "@simulacra-ai/core";
+const ORCHESTRATION_TOOL_NAMES = new Set(["subagent", "background", "parallel"]);
+/**
+ * Remove orchestration tools from a toolkit to prevent child agents from nesting.
+ *
+ * @param toolkit - The toolkit to filter.
+ */
+function strip_orchestration_tools(toolkit) {
+    return toolkit.filter((t) => !ORCHESTRATION_TOOL_NAMES.has(t.get_definition().name));
+}
+/**
+ * Base class for orchestration patterns.
+ *
+ * Accepts a `WorkflowManager` (for programmatic use) or a `Workflow`
+ * (for tool integration). Provides the shared child-spawning logic
+ * that all orchestration patterns build on.
+ *
+ * By default, orchestration tools are stripped from child agents to
+ * prevent nesting. Pass `strip_tools: false` to allow it.
+ */
+export class Orchestrator {
+    #manager;
+    #workflow;
+    #strip_tools;
+    /**
+     * @param source - A `WorkflowManager` or `Workflow` to spawn children from.
+     * @param options.strip_tools - Remove orchestration tools from child agents. Defaults to `true`.
+     */
+    constructor(source, { strip_tools = true } = {}) {
+        if (source instanceof WorkflowManager) {
+            this.#manager = source;
+        }
+        else {
+            this.#workflow = source;
+        }
+        this.#strip_tools = strip_tools;
+    }
+    /**
+     * The conversation associated with the orchestrator.
+     */
+    get conversation() {
+        if (this.#manager) {
+            return this.#manager.conversation;
+        }
+        if (this.#workflow) {
+            return this.#workflow.conversation;
+        }
+        throw new Error("no source");
+    }
+    /**
+     * The parent workflow, if available. Used to establish parent-child workflow relationships.
+     */
+    get parent_workflow() {
+        if (this.#manager) {
+            return this.#manager.current_workflow;
+        }
+        return this.#workflow;
+    }
+    /**
+     * Spawn a child agent with its own conversation and workflow.
+     *
+     * Creates a child conversation, assigns tools (stripping orchestration
+     * tools unless disabled), and starts the workflow. Returns a handle
+     * for awaiting, inspecting, or cancelling the child.
+     *
+     * @param prompt - The instruction to send to the child agent.
+     * @param options - Configuration for the child agent (system prompt, tools, session forking, custom ID).
+     */
+    spawn(prompt, options) {
+        const conversation = this.conversation;
+        const child = conversation.spawn_child(options?.fork_session, options?.id, options?.system ?? conversation.system);
+        const toolkit = options?.toolkit ?? [...conversation.toolkit];
+        child.toolkit = this.#strip_tools ? strip_orchestration_tools(toolkit) : toolkit;
+        const parent = this.parent_workflow;
+        const child_workflow = parent && parent.state !== "disposed"
+            ? parent.spawn_child(child, options?.id)
+            : new Workflow(child);
+        let settled = false;
+        const promise = new Promise((resolve) => {
+            child_workflow.once("workflow_end", (event) => {
+                settled = true;
+                resolve({
+                    id: child_workflow.id,
+                    messages: child_workflow.messages,
+                    end_reason: event.reason,
+                });
+                if (child.state !== "disposed") {
+                    child[Symbol.dispose]();
+                }
+            });
+            try {
+                child_workflow.start();
+                child.prompt(prompt);
+            }
+            catch {
+                if (!settled) {
+                    settled = true;
+                    resolve({
+                        id: child_workflow.id,
+                        messages: child_workflow.messages,
+                        end_reason: "cancel",
+                    });
+                    if (child.state !== "disposed") {
+                        child[Symbol.dispose]();
+                    }
+                }
+            }
+        });
+        return {
+            get id() {
+                return child_workflow.id;
+            },
+            get workflow() {
+                return child_workflow;
+            },
+            promise,
+            get done() {
+                return settled;
+            },
+            cancel: () => child_workflow.cancel(),
+        };
+    }
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/orchestrator.js.map

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

package/dist/parallel-agent.d.ts

@@ -0,0 +1,17 @@
+import { Orchestrator } from "./orchestrator.ts";
+import type { SubagentOptions, SubagentResult } from "./types.ts";
+/**
+ * Runs multiple prompts concurrently, each as an independent child agent.
+ * Returns when all complete.
+ */
+export declare class ParallelOrchestrator extends Orchestrator {
+    /**
+     * Run all tasks concurrently and return when every child agent has completed.
+     *
+     * @param tasks - Array of task configs, each with a `prompt` and optional `SubagentOptions`.
+     */
+    execute(tasks: Array<{
+        prompt: string;
+    } & SubagentOptions>): Promise<SubagentResult[]>;
+}
+//# sourceMappingURL=parallel-agent.d.ts.map

package/dist/parallel-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parallel-agent.d.ts","sourceRoot":"","sources":["../src/parallel-agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAoB,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEpF;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,YAAY;IACpD;;;;OAIG;IACG,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,eAAe,CAAC,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;CAkB7F"}

package/dist/parallel-agent.js

@@ -0,0 +1,33 @@
+import { Orchestrator } from "./orchestrator.js";
+/**
+ * Runs multiple prompts concurrently, each as an independent child agent.
+ * Returns when all complete.
+ */
+export class ParallelOrchestrator extends Orchestrator {
+    /**
+     * Run all tasks concurrently and return when every child agent has completed.
+     *
+     * @param tasks - Array of task configs, each with a `prompt` and optional `SubagentOptions`.
+     */
+    async execute(tasks) {
+        const handles = [];
+        try {
+            for (const { prompt, ...options } of tasks) {
+                handles.push(this.spawn(prompt, options));
+            }
+        }
+        catch (error) {
+            for (const handle of handles) {
+                try {
+                    handle.cancel();
+                }
+                catch {
+                    /* ignore */
+                }
+            }
+            throw error;
+        }
+        return Promise.all(handles.map((h) => h.promise));
+    }
+}
+//# sourceMappingURL=parallel-agent.js.map

package/dist/parallel-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parallel-agent.js","sourceRoot":"","sources":["../src/parallel-agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD;;;GAGG;AACH,MAAM,OAAO,oBAAqB,SAAQ,YAAY;IACpD;;;;OAIG;IACH,KAAK,CAAC,OAAO,CAAC,KAAkD;QAC9D,MAAM,OAAO,GAAuB,EAAE,CAAC;QACvC,IAAI,CAAC;YACH,KAAK,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,IAAI,KAAK,EAAE,CAAC;gBAC3C,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;YAC5C,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC7B,IAAI,CAAC;oBACH,MAAM,CAAC,MAAM,EAAE,CAAC;gBAClB,CAAC;gBAAC,MAAM,CAAC;oBACP,YAAY;gBACd,CAAC;YACH,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;QACD,OAAO,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACpD,CAAC;CACF"}

package/dist/subagent.d.ts

@@ -0,0 +1,18 @@
+import { Orchestrator } from "./orchestrator.ts";
+import type { SubagentOptions, SubagentResult } from "./types.ts";
+/**
+ * Spawns a child agent and blocks until it completes.
+ *
+ * The child runs its own agentic loop with access to the parent's tools
+ * (minus orchestration tools).
+ */
+export declare class SubagentOrchestrator extends Orchestrator {
+    /**
+     * Run a prompt as an autonomous child agent and return when it completes.
+     *
+     * @param prompt - The instruction for the child agent.
+     * @param options - Configuration for the child agent (system prompt, tools, session forking, custom ID).
+     */
+    execute(prompt: string, options?: SubagentOptions): Promise<SubagentResult>;
+}
+//# sourceMappingURL=subagent.d.ts.map

package/dist/subagent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent.d.ts","sourceRoot":"","sources":["../src/subagent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAElE;;;;;GAKG;AACH,qBAAa,oBAAqB,SAAQ,YAAY;IACpD;;;;;OAKG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;CAGlF"}

package/dist/subagent.js

@@ -0,0 +1,19 @@
+import { Orchestrator } from "./orchestrator.js";
+/**
+ * Spawns a child agent and blocks until it completes.
+ *
+ * The child runs its own agentic loop with access to the parent's tools
+ * (minus orchestration tools).
+ */
+export class SubagentOrchestrator extends Orchestrator {
+    /**
+     * Run a prompt as an autonomous child agent and return when it completes.
+     *
+     * @param prompt - The instruction for the child agent.
+     * @param options - Configuration for the child agent (system prompt, tools, session forking, custom ID).
+     */
+    async execute(prompt, options) {
+        return this.spawn(prompt, options).promise;
+    }
+}
+//# sourceMappingURL=subagent.js.map

package/dist/subagent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent.js","sourceRoot":"","sources":["../src/subagent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD;;;;;GAKG;AACH,MAAM,OAAO,oBAAqB,SAAQ,YAAY;IACpD;;;;;OAKG;IACH,KAAK,CAAC,OAAO,CAAC,MAAc,EAAE,OAAyB;QACrD,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC;IAC7C,CAAC;CACF"}

package/dist/tools/background-worker-pool.d.ts

@@ -0,0 +1,16 @@
+import type { ToolClass, ToolSuccessResult } from "@simulacra-ai/core";
+import type { WorkerState } from "../types.ts";
+type BackgroundParams = {
+    action: "start" | "list" | "state" | "cancel" | "ack";
+    prompts?: string[];
+    system?: string;
+    fork_session?: boolean;
+    ids?: string[];
+};
+type BackgroundToolSuccess = ToolSuccessResult & {
+    ids?: string[];
+    workers?: WorkerState[];
+};
+export declare const BackgroundWorkerPool: ToolClass<BackgroundParams, BackgroundToolSuccess>;
+export {};
+//# sourceMappingURL=background-worker-pool.d.ts.map

package/dist/tools/background-worker-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-worker-pool.d.ts","sourceRoot":"","sources":["../../src/tools/background-worker-pool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,SAAS,EAIT,iBAAiB,EAClB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,KAAK,gBAAgB,GAAG;IACtB,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;IACtD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;CAChB,CAAC;AAEF,KAAK,qBAAqB,GAAG,iBAAiB,GAAG;IAC/C,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;CACzB,CAAC;AAiIF,eAAO,MAAM,oBAAoB,EAAE,SAAS,CAAC,gBAAgB,EAAE,qBAAqB,CAC1D,CAAC"}

package/dist/tools/background-worker-pool.js

@@ -0,0 +1,126 @@
+import { BackgroundAgentPool } from "../background-agent-pool.js";
+class BackgroundWorkerPoolImpl {
+    #pool;
+    constructor(context) {
+        const POOL_KEY = "__background_agent_pool";
+        if (!context[POOL_KEY]) {
+            context[POOL_KEY] = new BackgroundAgentPool(context.workflow);
+        }
+        const pool = context[POOL_KEY];
+        pool.update_source(context.workflow);
+        this.#pool = pool;
+    }
+    async execute({ action, prompts, system, fork_session, ids }) {
+        try {
+            switch (action) {
+                case "start": {
+                    if (!prompts?.length) {
+                        return {
+                            result: false,
+                            message: "prompts is required for start",
+                        };
+                    }
+                    const started_ids = prompts.map((p) => this.#pool.start(p, { system, fork_session }));
+                    return { result: true, ids: started_ids };
+                }
+                case "list": {
+                    const worker_ids = this.#pool.list();
+                    return { result: true, ids: worker_ids };
+                }
+                case "state": {
+                    const workers = ids?.length ? this.#pool.state(...ids) : this.#pool.state();
+                    return { result: true, workers };
+                }
+                case "cancel": {
+                    if (!ids?.length) {
+                        return {
+                            result: false,
+                            message: "ids is required for cancel",
+                        };
+                    }
+                    const errors = [];
+                    for (const id of ids) {
+                        try {
+                            this.#pool.cancel(id);
+                        }
+                        catch (e) {
+                            errors.push(`${id}: ${e instanceof Error ? e.message : String(e)}`);
+                        }
+                    }
+                    if (errors.length) {
+                        return {
+                            result: false,
+                            message: `some cancels failed: ${errors.join("; ")}`,
+                        };
+                    }
+                    return { result: true, ids };
+                }
+                case "ack": {
+                    const workers = ids?.length ? this.#pool.ack(...ids) : this.#pool.ack();
+                    return { result: true, workers };
+                }
+                default: {
+                    return {
+                        result: false,
+                        message: `unknown action: ${action}`,
+                    };
+                }
+            }
+        }
+        catch (error) {
+            return {
+                result: false,
+                message: error instanceof Error ? error.message : String(error),
+                error,
+            };
+        }
+    }
+    static get_definition() {
+        return {
+            name: "background",
+            description: "Manage background worker agents. Workers run independently with their own " +
+                "conversations and tools. Use 'start' to launch workers, 'list' to see all " +
+                "worker IDs, 'state' to check progress (rounds, tool calls, latest message), " +
+                "'cancel' to stop workers, 'ack' to collect results from completed workers " +
+                "and remove them from the pool.",
+            parameters: [
+                {
+                    name: "action",
+                    description: "The operation to perform",
+                    type: "string",
+                    required: true,
+                    enum: ["start", "list", "state", "cancel", "ack"],
+                },
+                {
+                    name: "prompts",
+                    description: "Instructions for workers to start, one per worker. Required and must not be empty when action is 'start'.",
+                    type: "array",
+                    required: false,
+                    items: { type: "string", required: true },
+                },
+                {
+                    name: "system",
+                    description: "Override the system prompt (only for 'start')",
+                    type: "string",
+                    required: false,
+                },
+                {
+                    name: "fork_session",
+                    description: "Start with current conversation history (only for 'start')",
+                    type: "boolean",
+                    required: false,
+                },
+                {
+                    name: "ids",
+                    description: "Worker IDs to operate on (for 'state', 'cancel', 'ack'). Omit for all.",
+                    type: "array",
+                    required: false,
+                    items: { type: "string", required: true },
+                },
+            ],
+            parallelizable: false,
+        };
+    }
+}
+export const BackgroundWorkerPool = BackgroundWorkerPoolImpl;
+//# sourceMappingURL=background-worker-pool.js.map

package/dist/tools/background-worker-pool.js.map

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

package/dist/tools/index.d.ts

@@ -0,0 +1,9 @@
+import type { ToolClass } from "@simulacra-ai/core";
+export { SubagentTask } from "./subagent-task.ts";
+export { BackgroundWorkerPool } from "./background-worker-pool.ts";
+export { ParallelAgentTask } from "./parallel-agent-task.ts";
+/**
+ * All orchestration tools (`SubagentTask`, `BackgroundWorkerPool`, `ParallelAgentTask`) as a ready-to-use toolkit.
+ */
+export declare const OrchestrationToolkit: ToolClass[];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAM7D;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS,EAI3C,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,15 @@
+export { SubagentTask } from "./subagent-task.js";
+export { BackgroundWorkerPool } from "./background-worker-pool.js";
+export { ParallelAgentTask } from "./parallel-agent-task.js";
+import { SubagentTask } from "./subagent-task.js";
+import { BackgroundWorkerPool } from "./background-worker-pool.js";
+import { ParallelAgentTask } from "./parallel-agent-task.js";
+/**
+ * All orchestration tools (`SubagentTask`, `BackgroundWorkerPool`, `ParallelAgentTask`) as a ready-to-use toolkit.
+ */
+export const OrchestrationToolkit = [
+    SubagentTask,
+    BackgroundWorkerPool,
+    ParallelAgentTask,
+];
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAgB;IAC/C,YAAY;IACZ,oBAAoB;IACpB,iBAAiB;CAClB,CAAC"}

package/dist/tools/parallel-agent-task.d.ts

@@ -0,0 +1,16 @@
+import type { ToolClass, ToolSuccessResult } from "@simulacra-ai/core";
+type ParallelParams = {
+    prompts: string[];
+    system?: string;
+    fork_session?: boolean;
+};
+type ParallelToolSuccess = ToolSuccessResult & {
+    responses: Array<{
+        id: string;
+        response: string;
+        end_reason: string;
+    }>;
+};
+export declare const ParallelAgentTask: ToolClass<ParallelParams, ParallelToolSuccess>;
+export {};
+//# sourceMappingURL=parallel-agent-task.d.ts.map

package/dist/tools/parallel-agent-task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parallel-agent-task.d.ts","sourceRoot":"","sources":["../../src/tools/parallel-agent-task.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,SAAS,EAIT,iBAAiB,EAClB,MAAM,oBAAoB,CAAC;AAI5B,KAAK,cAAc,GAAG;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,KAAK,mBAAmB,GAAG,iBAAiB,GAAG;IAC7C,SAAS,EAAE,KAAK,CAAC;QACf,EAAE,EAAE,MAAM,CAAC;QACX,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;CACJ,CAAC;AAsEF,eAAO,MAAM,iBAAiB,EAAE,SAAS,CAAC,cAAc,EAAE,mBAAmB,CACtD,CAAC"}

package/dist/tools/parallel-agent-task.js

@@ -0,0 +1,68 @@
+import { ParallelOrchestrator } from "../parallel-agent.js";
+import { extract_response } from "./utils.js";
+class ParallelAgentTaskImpl {
+    #agent;
+    constructor(context) {
+        this.#agent = new ParallelOrchestrator(context.workflow);
+    }
+    async execute({ prompts, system, fork_session }) {
+        try {
+            if (!prompts?.length) {
+                return {
+                    result: false,
+                    message: "prompts is required and must not be empty",
+                };
+            }
+            const tasks = prompts.map((prompt) => ({ prompt, system, fork_session }));
+            const results = await this.#agent.execute(tasks);
+            return {
+                result: true,
+                responses: results.map((r) => ({
+                    id: r.id,
+                    response: extract_response(r),
+                    end_reason: r.end_reason,
+                })),
+            };
+        }
+        catch (error) {
+            return {
+                result: false,
+                message: error instanceof Error ? error.message : String(error),
+                error,
+            };
+        }
+    }
+    static get_definition() {
+        return {
+            name: "parallel",
+            description: "Run multiple prompts as concurrent sub-agents. All agents start immediately " +
+                "and the tool returns when every agent has completed. Each sub-agent has its " +
+                "own conversation and access to the same tools. Use when tasks are independent " +
+                "and can benefit from concurrent execution.",
+            parameters: [
+                {
+                    name: "prompts",
+                    description: "Array of instructions, one per sub-agent",
+                    type: "array",
+                    required: true,
+                    items: { type: "string", required: true },
+                },
+                {
+                    name: "system",
+                    description: "Override the system prompt for all sub-agents",
+                    type: "string",
+                    required: false,
+                },
+                {
+                    name: "fork_session",
+                    description: "If true, each sub-agent starts with the current conversation history",
+                    type: "boolean",
+                    required: false,
+                },
+            ],
+            parallelizable: false,
+        };
+    }
+}
+export const ParallelAgentTask = ParallelAgentTaskImpl;
+//# sourceMappingURL=parallel-agent-task.js.map

package/dist/tools/parallel-agent-task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parallel-agent-task.js","sourceRoot":"","sources":["../../src/tools/parallel-agent-task.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAgB9C,MAAM,qBAAqB;IAChB,MAAM,CAAuB;IAEtC,YAAY,OAAoB;QAC9B,IAAI,CAAC,MAAM,GAAG,IAAI,oBAAoB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC3D,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAkB;QAC7D,IAAI,CAAC;YACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;gBACrB,OAAO;oBACL,MAAM,EAAE,KAAc;oBACtB,OAAO,EAAE,2CAA2C;iBAClC,CAAC;YACvB,CAAC;YACD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC;YAC1E,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YACjD,OAAO;gBACL,MAAM,EAAE,IAAa;gBACrB,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBAC7B,EAAE,EAAE,CAAC,CAAC,EAAE;oBACR,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC;oBAC7B,UAAU,EAAE,CAAC,CAAC,UAAU;iBACzB,CAAC,CAAC;aACJ,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,MAAM,EAAE,KAAc;gBACtB,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;gBAC/D,KAAK;aACa,CAAC;QACvB,CAAC;IACH,CAAC;IAED,MAAM,CAAC,cAAc;QACnB,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,WAAW,EACT,8EAA8E;gBAC9E,8EAA8E;gBAC9E,gFAAgF;gBAChF,4CAA4C;YAC9C,UAAU,EAAE;gBACV;oBACE,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,0CAA0C;oBACvD,IAAI,EAAE,OAAO;oBACb,QAAQ,EAAE,IAAI;oBACd,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;iBAC1C;gBACD;oBACE,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,+CAA+C;oBAC5D,IAAI,EAAE,QAAQ;oBACd,QAAQ,EAAE,KAAK;iBAChB;gBACD;oBACE,IAAI,EAAE,cAAc;oBACpB,WAAW,EAAE,sEAAsE;oBACnF,IAAI,EAAE,SAAS;oBACf,QAAQ,EAAE,KAAK;iBAChB;aACF;YACD,cAAc,EAAE,KAAK;SACtB,CAAC;IACJ,CAAC;CACF;AAED,MAAM,CAAC,MAAM,iBAAiB,GAC5B,qBAAqB,CAAC"}

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

@@ -0,0 +1,14 @@
+import type { ToolClass, ToolSuccessResult } from "@simulacra-ai/core";
+type SubagentParams = {
+    prompt: string;
+    system?: string;
+    fork_session?: boolean;
+};
+type SubagentToolSuccess = ToolSuccessResult & {
+    id: string;
+    response: string;
+    end_reason: string;
+};
+export declare const SubagentTask: ToolClass<SubagentParams, SubagentToolSuccess>;
+export {};
+//# sourceMappingURL=subagent-task.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-task.d.ts","sourceRoot":"","sources":["../../src/tools/subagent-task.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,SAAS,EAIT,iBAAiB,EAClB,MAAM,oBAAoB,CAAC;AAI5B,KAAK,cAAc,GAAG;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,KAAK,mBAAmB,GAAG,iBAAiB,GAAG;IAC7C,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AA6DF,eAAO,MAAM,YAAY,EAAE,SAAS,CAAC,cAAc,EAAE,mBAAmB,CAAoB,CAAC"}

package/dist/tools/subagent-task.js

@@ -0,0 +1,58 @@
+import { SubagentOrchestrator } from "../subagent.js";
+import { extract_response } from "./utils.js";
+class SubagentTaskImpl {
+    #agent;
+    constructor(context) {
+        this.#agent = new SubagentOrchestrator(context.workflow);
+    }
+    async execute({ prompt, system, fork_session }) {
+        try {
+            const result = await this.#agent.execute(prompt, { system, fork_session });
+            return {
+                result: true,
+                id: result.id,
+                response: extract_response(result),
+                end_reason: result.end_reason,
+            };
+        }
+        catch (error) {
+            return {
+                result: false,
+                message: error instanceof Error ? error.message : String(error),
+                error,
+            };
+        }
+    }
+    static get_definition() {
+        return {
+            name: "subagent",
+            description: "Run a prompt as an autonomous sub-agent with its own conversation. " +
+                "The sub-agent has access to the same tools and runs to completion, " +
+                "returning its final response. Use for tasks that require independent " +
+                "multi-step reasoning or tool use.",
+            parameters: [
+                {
+                    name: "prompt",
+                    description: "The instruction for the sub-agent",
+                    type: "string",
+                    required: true,
+                },
+                {
+                    name: "system",
+                    description: "Override the system prompt for this sub-agent",
+                    type: "string",
+                    required: false,
+                },
+                {
+                    name: "fork_session",
+                    description: "If true, the sub-agent starts with a copy of the current conversation history",
+                    type: "boolean",
+                    required: false,
+                },
+            ],
+            parallelizable: true,
+        };
+    }
+}
+export const SubagentTask = SubagentTaskImpl;
+//# sourceMappingURL=subagent-task.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-task.js","sourceRoot":"","sources":["../../src/tools/subagent-task.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAc9C,MAAM,gBAAgB;IACX,MAAM,CAAuB;IAEtC,YAAY,OAAoB;QAC9B,IAAI,CAAC,MAAM,GAAG,IAAI,oBAAoB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC3D,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAkB;QAC5D,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;YAC3E,OAAO;gBACL,MAAM,EAAE,IAAa;gBACrB,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,QAAQ,EAAE,gBAAgB,CAAC,MAAM,CAAC;gBAClC,UAAU,EAAE,MAAM,CAAC,UAAU;aAC9B,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,MAAM,EAAE,KAAc;gBACtB,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;gBAC/D,KAAK;aACa,CAAC;QACvB,CAAC;IACH,CAAC;IAED,MAAM,CAAC,cAAc;QACnB,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,WAAW,EACT,qEAAqE;gBACrE,qEAAqE;gBACrE,uEAAuE;gBACvE,mCAAmC;YACrC,UAAU,EAAE;gBACV;oBACE,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,mCAAmC;oBAChD,IAAI,EAAE,QAAQ;oBACd,QAAQ,EAAE,IAAI;iBACf;gBACD;oBACE,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,+CAA+C;oBAC5D,IAAI,EAAE,QAAQ;oBACd,QAAQ,EAAE,KAAK;iBAChB;gBACD;oBACE,IAAI,EAAE,cAAc;oBACpB,WAAW,EACT,+EAA+E;oBACjF,IAAI,EAAE,SAAS;oBACf,QAAQ,EAAE,KAAK;iBAChB;aACF;YACD,cAAc,EAAE,IAAI;SACrB,CAAC;IACJ,CAAC;CACF;AAED,MAAM,CAAC,MAAM,YAAY,GAAmD,gBAAgB,CAAC"}

package/dist/tools/utils.d.ts

@@ -0,0 +1,8 @@
+import type { SubagentResult } from "../types.ts";
+/**
+ * Extract the final text response from a subagent result.
+ *
+ * @param result - The completed subagent result.
+ */
+export declare function extract_response(result: SubagentResult): string;
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/tools/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAkB/D"}

package/dist/tools/utils.js

@@ -0,0 +1,25 @@
+/**
+ * Extract the final text response from a subagent result.
+ *
+ * @param result - The completed subagent result.
+ */
+export function extract_response(result) {
+    for (let i = result.messages.length - 1; i >= 0; i--) {
+        const message = result.messages[i];
+        if (message.role !== "assistant") {
+            continue;
+        }
+        const content = message.content;
+        if (!content) {
+            continue;
+        }
+        for (let j = content.length - 1; j >= 0; j--) {
+            const block = content[j];
+            if (block.type === "text" && block.text) {
+                return block.text;
+            }
+        }
+    }
+    return "(no text response)";
+}
+//# sourceMappingURL=utils.js.map