@nodetool-ai/agents 0.7.0-rc.23 → 0.8.1

package/dist/browser-gate.js

@@ -0,0 +1,34 @@
+/**
+ * Availability gate for the `browser_*` capabilities.
+ *
+ * Driving a browser is a single-tenant capability wearing a multi-tenant
+ * server's clothes. The session is a process singleton — one page, shared by
+ * every caller in the process — so on a managed server two tenants' agents
+ * drive the same tab, and whatever the first one signed into is what the
+ * second one's `browser_view` reads. The extension transport is worse still:
+ * `/ws/extension` is unauthenticated and single-connection, so one user's
+ * Chrome would be reachable by anybody's run.
+ *
+ * Neither is a defect to fix behind a flag; both are what the surface is for.
+ * It belongs on a machine its user owns — a desktop app, a local server, a
+ * self-hosted install — so under the cloud profile the capabilities are left
+ * off every belt and refuse when reached by name.
+ *
+ * Same switch that prunes the node catalog: `NODETOOL_NODE_PROFILE=cloud`, or
+ * `NODETOOL_ENV=production` with the profile unset. The node catalog already
+ * agrees — `lib.browser` is not in `CLOUD_NODE_NAMESPACES`, so the Screenshot
+ * node is gone from the cloud product too. A self-hosted install of the same
+ * image sets `NODETOOL_NODE_PROFILE=full` and keeps both, as does every local
+ * install.
+ */
+import { CLOUD_PROFILE_ENV, NODE_ENV_VAR, isCloudProfileActive } from "@nodetool-ai/protocol";
+/** Whether the `browser_*` capabilities should be offered on this deployment. */
+export function isBrowserEnabled() {
+    return !isCloudProfileActive(process.env[CLOUD_PROFILE_ENV], process.env[NODE_ENV_VAR]);
+}
+/** What a `browser_*` capability answers where this deployment offers none. */
+export const BROWSER_DISABLED_ERROR = "Browser control is not available on this deployment. It drives one shared " +
+    "browser session per server process, so it is offered only where the " +
+    "machine belongs to its user — the desktop app, a local server, or a " +
+    "self-hosted install.";
+//# sourceMappingURL=browser-gate.js.map

package/dist/browser-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-gate.js","sourceRoot":"","sources":["../src/browser-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,oBAAoB,EACrB,MAAM,uBAAuB,CAAC;AAE/B,iFAAiF;AACjF,MAAM,UAAU,gBAAgB;IAC9B,OAAO,CAAC,oBAAoB,CAC1B,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,EAC9B,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAC1B,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,MAAM,CAAC,MAAM,sBAAsB,GACjC,4EAA4E;IAC5E,sEAAsE;IACtE,sEAAsE;IACtE,sBAAsB,CAAC"}

package/dist/capabilities/adapters.d.ts

@@ -0,0 +1,36 @@
+/**
+ * The two adapters that let capabilities and `Tool` instances coexist.
+ *
+ * `toolFromCapability` wraps a spec+impl as a `Tool`, so every belt that
+ * consumes `Tool[]` — the runner, the MCP mount, the CLI, the evals —
+ * consumes a ported namespace unchanged. It is a thin wrapper over
+ * {@link toolFromLazyCapability}, which already carries the run/validate
+ * logic this used to duplicate as its own `CapabilityTool` class; the two
+ * differed only in where the implementation came from (`this.impl` here,
+ * `loadCapabilityImpl(name)` there), which `toolFromLazyCapability`'s
+ * optional `impl` parameter now covers. `capabilityFromTool` is the reverse,
+ * for the long tail that has not been ported yet.
+ */
+import type { ProcessingContext } from "@nodetool-ai/runtime";
+import type { Tool } from "../tools/base-tool.js";
+import type { CapabilityExport, CapabilityImpl, CapabilityRun, CapabilitySpec } from "./types.js";
+/**
+ * How a wrapped capability gets its run: either one run fixed for the tool's
+ * lifetime, or a factory the wrapper calls with the `ProcessingContext` the
+ * caller passed to `process()`.
+ */
+export type CapabilityRunSource = CapabilityRun | ((context: ProcessingContext) => CapabilityRun);
+/**
+ * Expose one capability as a `Tool`. The run is either supplied directly or
+ * built per call from the context the caller passes to `process()`.
+ */
+export declare function toolFromCapability(spec: CapabilitySpec, impl: CapabilityImpl, run: CapabilityRunSource): Tool;
+/**
+ * Wrap an existing `Tool` as a capability. The category is the registered
+ * spec's when the name is a capability, so `gateTools` decides exactly as
+ * `run.invoke` does for the same name; the classification map is consulted
+ * only for a `Tool` that is not a capability, where the map is the one place
+ * its class is declared.
+ */
+export declare function capabilityFromTool(tool: Tool): CapabilityExport;
+//# sourceMappingURL=adapters.d.ts.map

package/dist/capabilities/adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../../src/capabilities/adapters.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAGlD,OAAO,KAAK,EACV,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAC3B,aAAa,GACb,CAAC,CAAC,OAAO,EAAE,iBAAiB,KAAK,aAAa,CAAC,CAAC;AAEpD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,cAAc,EACpB,IAAI,EAAE,cAAc,EACpB,GAAG,EAAE,mBAAmB,GACvB,IAAI,CAEN;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,gBAAgB,CAa/D"}

package/dist/capabilities/adapters.js

@@ -0,0 +1,44 @@
+/**
+ * The two adapters that let capabilities and `Tool` instances coexist.
+ *
+ * `toolFromCapability` wraps a spec+impl as a `Tool`, so every belt that
+ * consumes `Tool[]` — the runner, the MCP mount, the CLI, the evals —
+ * consumes a ported namespace unchanged. It is a thin wrapper over
+ * {@link toolFromLazyCapability}, which already carries the run/validate
+ * logic this used to duplicate as its own `CapabilityTool` class; the two
+ * differed only in where the implementation came from (`this.impl` here,
+ * `loadCapabilityImpl(name)` there), which `toolFromLazyCapability`'s
+ * optional `impl` parameter now covers. `capabilityFromTool` is the reverse,
+ * for the long tail that has not been ported yet.
+ */
+import { capabilityCategoryFor } from "./registry.js";
+import { toolFromLazyCapability } from "./lazy-tool.js";
+/**
+ * Expose one capability as a `Tool`. The run is either supplied directly or
+ * built per call from the context the caller passes to `process()`.
+ */
+export function toolFromCapability(spec, impl, run) {
+    return toolFromLazyCapability(spec, run, impl);
+}
+/**
+ * Wrap an existing `Tool` as a capability. The category is the registered
+ * spec's when the name is a capability, so `gateTools` decides exactly as
+ * `run.invoke` does for the same name; the classification map is consulted
+ * only for a `Tool` that is not a capability, where the map is the one place
+ * its class is declared.
+ */
+export function capabilityFromTool(tool) {
+    const spec = {
+        name: tool.name,
+        description: tool.description,
+        inputSchema: tool.inputSchema,
+        category: capabilityCategoryFor(tool.name),
+        needsToolCallId: tool.needsToolCallId,
+        userMessage: (args) => tool.userMessage(args)
+    };
+    return {
+        spec,
+        impl: (run, args) => tool.process(run.context, args)
+    };
+}
+//# sourceMappingURL=adapters.js.map

package/dist/capabilities/adapters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.js","sourceRoot":"","sources":["../../src/capabilities/adapters.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAiBxD;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAoB,EACpB,IAAoB,EACpB,GAAwB;IAExB,OAAO,sBAAsB,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;AACjD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAU;IAC3C,MAAM,IAAI,GAAmB;QAC3B,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,QAAQ,EAAE,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC;QAC1C,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;KAC9C,CAAC;IACF,OAAO;QACL,IAAI;QACJ,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC;KACrD,CAAC;AACJ,CAAC"}

package/dist/capabilities/agents.d.ts

@@ -0,0 +1,78 @@
+/**
+ * The `agents` capability module — delegation to a child agent loop, and the
+ * chat's plan mode.
+ *
+ * Four delegation capabilities: `run_subtask` (blocking), `run_search`
+ * (read-only child), `start_subtask` (background spawn) and `wait_subtasks`
+ * (collect). Two plan capabilities: `create_plan` builds a task DAG and runs
+ * none of it, `execute_plan` takes that DAG back and runs it.
+ * Unlike every other ported namespace their classes stay exactly as they
+ * are. `SubAgentTool` is not a schema plus a function: it owns the depth gate, the child context, the
+ * streamed events, the tagging, and the settlement, and the runner constructs
+ * one per turn over that turn's provider, model, toolbelt snapshot, and
+ * forwarder. Reimplementing that here would be a second copy of the machinery
+ * the sub-agent core exists to hold once.
+ *
+ * So the capability is the registry-visible face: the spec is the class's own
+ * wire identity, and the implementation lazily constructs the class over
+ * `run.subAgent` — which *is* `SubAgentToolRuntime` — and calls it through
+ * `Tool.executeTool`. A run with no `subAgent` cannot delegate, and says so
+ * naming the field rather than failing somewhere inside the child loop.
+ *
+ * The delegation capabilities are classified `read`: the call itself has no
+ * side effects, and the child's own tools are gated in the child loop. So is
+ * `create_plan`, which is what keeps it callable in plan mode. `execute_plan`
+ * is `external` — it is the one call here that acts.
+ *
+ * Design: docs/tool-class-retirement-design.md § "PRs 4–9 — remaining
+ * namespaces" (`/agents`).
+ */
+import type { CapabilityExport, CapabilityModule } from "./types.js";
+declare const runSubtask: CapabilityExport;
+declare const runSearch: CapabilityExport;
+declare const startSubtask: CapabilityExport;
+declare const waitSubtasks: CapabilityExport;
+/**
+ * Plan an objective without running any of it.
+ *
+ * This is what the chat's **plan mode** reaches for: every mutating capability
+ * is blocked there, so a multi-step request used to come back as prose the
+ * user had to read and re-derive. `TaskPlanner` already produces the structured
+ * thing — a DAG of tasks and steps, with the independent ones visible as
+ * such — and the chat already renders the `planning_update` / `task_update`
+ * events it streams. Nothing here executes the plan: `planMultiTask` returns
+ * one, and the turn ends with it on screen.
+ *
+ * The planner sees the parent's toolbelt so it can route steps to real tool
+ * names, minus this capability itself — a plan whose step says "call
+ * create_plan" is a loop, not a plan.
+ */
+declare const createPlan: CapabilityExport;
+/**
+ * Run a plan the user has already seen.
+ *
+ * The other half of plan mode. `create_plan` produces a DAG and stops; this
+ * takes that DAG back — inline, as the object the user watched arrive — and
+ * hands it to `ParallelTaskExecutor`, the same machinery `Agent` runs a plan
+ * on. Passing the plan itself rather than an id is what makes it survive the
+ * mode switch with no store behind it, keeps what runs identical to what is
+ * on screen, and lets "drop task 3" be expressible.
+ *
+ * The plan is checked before anything runs, by `PlanBuilder` — the same rules
+ * that governed the plan when the planner built it, so a plan that came out of
+ * `create_plan` unedited cannot be rejected here.
+ *
+ * The executor's own messages are forwarded verbatim: the `task_update` events
+ * are what the thread and the sidebar render, and re-summarizing them into a
+ * final blob would leave the user watching nothing until the end. The call
+ * returns how each task settled plus its result; the step results also stay in
+ * shared memory under `task:<id>`, which the description points at. A task
+ * that completed and left nothing under that key comes back with
+ * `result_missing`, so the model is not sent to a key that is not there.
+ */
+declare const executePlan: CapabilityExport;
+/** Every capability this module declares. */
+export declare const AGENT_CAPABILITIES: readonly CapabilityExport[];
+export declare const module: CapabilityModule;
+export { runSubtask, runSearch, startSubtask, waitSubtasks, createPlan, executePlan };
+//# sourceMappingURL=agents.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/capabilities/agents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAOH,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAEjB,MAAM,YAAY,CAAC;AAqEpB,QAAA,MAAM,UAAU,EAAE,gBAOjB,CAAC;AAEF,QAAA,MAAM,SAAS,EAAE,gBAOhB,CAAC;AAEF,QAAA,MAAM,YAAY,EAAE,gBAOnB,CAAC;AAEF,QAAA,MAAM,YAAY,EAAE,gBAWnB,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,QAAA,MAAM,UAAU,EAAE,gBAyEjB,CAAC;AA2BF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,QAAA,MAAM,WAAW,EAAE,gBAmJlB,CAAC;AAEF,6CAA6C;AAC7C,eAAO,MAAM,kBAAkB,EAAE,SAAS,gBAAgB,EAOzD,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,gBAGpB,CAAC;AAEF,OAAO,EACL,UAAU,EACV,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,WAAW,EACZ,CAAC"}

package/dist/capabilities/agents.js

@@ -0,0 +1,366 @@
+/**
+ * The `agents` capability module — delegation to a child agent loop, and the
+ * chat's plan mode.
+ *
+ * Four delegation capabilities: `run_subtask` (blocking), `run_search`
+ * (read-only child), `start_subtask` (background spawn) and `wait_subtasks`
+ * (collect). Two plan capabilities: `create_plan` builds a task DAG and runs
+ * none of it, `execute_plan` takes that DAG back and runs it.
+ * Unlike every other ported namespace their classes stay exactly as they
+ * are. `SubAgentTool` is not a schema plus a function: it owns the depth gate, the child context, the
+ * streamed events, the tagging, and the settlement, and the runner constructs
+ * one per turn over that turn's provider, model, toolbelt snapshot, and
+ * forwarder. Reimplementing that here would be a second copy of the machinery
+ * the sub-agent core exists to hold once.
+ *
+ * So the capability is the registry-visible face: the spec is the class's own
+ * wire identity, and the implementation lazily constructs the class over
+ * `run.subAgent` — which *is* `SubAgentToolRuntime` — and calls it through
+ * `Tool.executeTool`. A run with no `subAgent` cannot delegate, and says so
+ * naming the field rather than failing somewhere inside the child loop.
+ *
+ * The delegation capabilities are classified `read`: the call itself has no
+ * side effects, and the child's own tools are gated in the child loop. So is
+ * `create_plan`, which is what keeps it callable in plan mode. `execute_plan`
+ * is `external` — it is the one call here that acts.
+ *
+ * Design: docs/tool-class-retirement-design.md § "PRs 4–9 — remaining
+ * namespaces" (`/agents`).
+ */
+import { budgetFromContext } from "@nodetool-ai/runtime";
+import { createLogger } from "@nodetool-ai/config";
+import { Tool } from "../tools/base-tool.js";
+import { TOOL_CALL_ID_FIELD } from "../tools/subtask-fields.js";
+import { runSubtaskSpec, runSearchSpec, startSubtaskSpec, waitSubtasksSpec, createPlanSpec, executePlanSpec } from "./agents.specs.js";
+import { isNonEmptyString, isObjectLike, isString } from "../utils/type-guards.js";
+const log = createLogger("nodetool.agents.capabilities.agents");
+/**
+ * The sub-agent runtime this run carries, or an error naming what is missing.
+ * A headless run (an eval, an MCP mount, a CLI invocation with no forwarder)
+ * has no runtime, and no child loop can be spawned without one.
+ *
+ * Every delegation capability goes through here, so this is also where the
+ * run's budget joins the runtime: a host that put one on the `CapabilityRun`
+ * (or on the context) has it reach `run_subtask`, `run_search`,
+ * `start_subtask` and `execute_plan` without naming it six times.
+ */
+function subAgentRuntime(run, name) {
+    const runtime = run.subAgent;
+    if (!runtime) {
+        throw new Error(`\`${name}\` needs a sub-agent runtime, but this run carries no ` +
+            "`subAgent` (provider, model, parentTools, forwardMessage). The host " +
+            "that builds the CapabilityRun must supply it.");
+    }
+    if (runtime.budget)
+        return runtime;
+    const budget = run.budget ?? budgetFromContext(run.context);
+    return budget ? { ...runtime, budget } : runtime;
+}
+/**
+ * Run one sub-agent tool over this run.
+ *
+ * The tool-call id reaches the class through `options.toolCallId` today
+ * (`StepExecutor` and the CodeAct tool API pass it), and a capability
+ * implementation only ever sees args — so the id travels in the args under
+ * `_tool_call_id`, and is handed back to `Tool.executeTool` as the option.
+ * `executeTool` re-stamps the same field on a `needsToolCallId` tool, so both
+ * routes leave identical args and the child's events keep nesting under the
+ * parent card.
+ */
+async function runSubAgentTool(tool, run, args) {
+    const toolCallId = args[TOOL_CALL_ID_FIELD];
+    return Tool.executeTool(tool, run.context, args, isString(toolCallId) ? { toolCallId } : {});
+}
+const runSubtask = {
+    spec: runSubtaskSpec,
+    impl: async (run, args) => {
+        const { RunSubtaskTool } = await import("../tools/run-subtask-tool.js");
+        const tool = new RunSubtaskTool(subAgentRuntime(run, "run_subtask"));
+        return runSubAgentTool(tool, run, args);
+    }
+};
+const runSearch = {
+    spec: runSearchSpec,
+    impl: async (run, args) => {
+        const { RunSearchTool } = await import("../tools/run-search-tool.js");
+        const tool = new RunSearchTool(subAgentRuntime(run, "run_search"));
+        return runSubAgentTool(tool, run, args);
+    }
+};
+const startSubtask = {
+    spec: startSubtaskSpec,
+    impl: async (run, args) => {
+        const { StartSubtaskTool } = await import("../tools/start-subtask-tool.js");
+        const tool = new StartSubtaskTool(subAgentRuntime(run, "start_subtask"));
+        return runSubAgentTool(tool, run, args);
+    }
+};
+const waitSubtasks = {
+    spec: waitSubtasksSpec,
+    impl: async (run, args) => {
+        const { WaitSubtasksTool } = await import("../tools/wait-subtasks-tool.js");
+        const runtime = subAgentRuntime(run, "wait_subtasks");
+        return Tool.executeTool(new WaitSubtasksTool({ background: runtime.background }), run.context, args);
+    }
+};
+/**
+ * Plan an objective without running any of it.
+ *
+ * This is what the chat's **plan mode** reaches for: every mutating capability
+ * is blocked there, so a multi-step request used to come back as prose the
+ * user had to read and re-derive. `TaskPlanner` already produces the structured
+ * thing — a DAG of tasks and steps, with the independent ones visible as
+ * such — and the chat already renders the `planning_update` / `task_update`
+ * events it streams. Nothing here executes the plan: `planMultiTask` returns
+ * one, and the turn ends with it on screen.
+ *
+ * The planner sees the parent's toolbelt so it can route steps to real tool
+ * names, minus this capability itself — a plan whose step says "call
+ * create_plan" is a loop, not a plan.
+ */
+const createPlan = {
+    spec: createPlanSpec,
+    impl: async (run, args) => {
+        const runtime = subAgentRuntime(run, "create_plan");
+        const objective = isString(args["objective"]) ? args["objective"].trim() : "";
+        if (!objective) {
+            return {
+                error: "invalid_objective",
+                message: "`create_plan` needs a non-empty `objective`."
+            };
+        }
+        const { TaskPlanner } = await import("../task-planner.js");
+        const planner = new TaskPlanner({
+            provider: runtime.provider,
+            model: runtime.model,
+            tools: runtime.parentTools().filter((t) => t.name !== createPlanSpec.name),
+            // The run's budget: planning turns spend the same cap as the steps.
+            budget: runtime.budget,
+            signal: run.context.signal
+        });
+        const generator = planner.planMultiTask(objective, run.context);
+        // The planner says why it stopped only through its final failed
+        // `planning_update`, so keep that for the model rather than guessing.
+        let failure = null;
+        let next = await generator.next();
+        while (!next.done) {
+            const message = next.value;
+            if (message.type === "planning_update" &&
+                message.status === "failed" &&
+                isNonEmptyString(message.content)) {
+                failure = message.content;
+            }
+            // The plan is the deliverable, so it goes to the user as it is built
+            // rather than being summarized back by the model afterwards.
+            await runtime.forwardMessage(message);
+            next = await generator.next();
+        }
+        const plan = next.value;
+        if (!plan) {
+            return {
+                error: "plan_failed",
+                message: failure ??
+                    "The planner did not commit a plan. The objective may be too vague to decompose — restate it with the concrete outcome and try again."
+            };
+        }
+        return {
+            title: plan.title,
+            tasks: plan.tasks.map((task) => ({
+                id: task.id,
+                title: task.title,
+                depends_on: task.dependsOn ?? [],
+                steps: task.steps.map((step) => ({
+                    id: step.id,
+                    instructions: step.instructions,
+                    depends_on: step.dependsOn
+                }))
+            })),
+            // What a reader of the plan wants to know first, and what the model
+            // should not have to count for itself.
+            task_count: plan.tasks.length,
+            step_count: plan.tasks.reduce((n, t) => n + t.steps.length, 0),
+            parallelizable: plan.tasks.filter((t) => (t.dependsOn?.length ?? 0) === 0)
+                .length,
+            executed: false
+        };
+    }
+};
+/** A rejected plan, shaped so the model can fix the offending task. */
+function invalidPlan(issues) {
+    return {
+        error: "invalid_plan",
+        issues,
+        message: `The plan cannot run as given. ${issues.join(" ")}`,
+        executed: false
+    };
+}
+/**
+ * Run a plan the user has already seen.
+ *
+ * The other half of plan mode. `create_plan` produces a DAG and stops; this
+ * takes that DAG back — inline, as the object the user watched arrive — and
+ * hands it to `ParallelTaskExecutor`, the same machinery `Agent` runs a plan
+ * on. Passing the plan itself rather than an id is what makes it survive the
+ * mode switch with no store behind it, keeps what runs identical to what is
+ * on screen, and lets "drop task 3" be expressible.
+ *
+ * The plan is checked before anything runs, by `PlanBuilder` — the same rules
+ * that governed the plan when the planner built it, so a plan that came out of
+ * `create_plan` unedited cannot be rejected here.
+ *
+ * The executor's own messages are forwarded verbatim: the `task_update` events
+ * are what the thread and the sidebar render, and re-summarizing them into a
+ * final blob would leave the user watching nothing until the end. The call
+ * returns how each task settled plus its result; the step results also stay in
+ * shared memory under `task:<id>`, which the description points at. A task
+ * that completed and left nothing under that key comes back with
+ * `result_missing`, so the model is not sent to a key that is not there.
+ */
+const executePlan = {
+    spec: executePlanSpec,
+    impl: async (run, args) => {
+        const runtime = subAgentRuntime(run, "execute_plan");
+        const rawTasks = args["tasks"];
+        if (!Array.isArray(rawTasks)) {
+            return invalidPlan([
+                "`execute_plan` needs a `tasks` array — pass the plan `create_plan` returned, verbatim."
+            ]);
+        }
+        const shapeIssues = [];
+        const taskObjects = [];
+        rawTasks.forEach((raw, index) => {
+            if (!isObjectLike(raw)) {
+                shapeIssues.push(`Task #${index + 1} is not an object.`);
+                return;
+            }
+            const task = raw;
+            if (!isNonEmptyString(task["id"])) {
+                shapeIssues.push(`Task #${index + 1} has no \`id\`.`);
+            }
+            taskObjects.push(task);
+        });
+        if (shapeIssues.length > 0)
+            return invalidPlan(shapeIssues);
+        const title = isString(args["title"]) ? args["title"].trim() : "";
+        const { buildPlanFromTasks } = await import("../tools/plan-builder-tools.js");
+        const built = buildPlanFromTasks(title || "Plan", taskObjects);
+        if (!built.ok)
+            return invalidPlan(built.errors);
+        const plan = built.plan;
+        const { ParallelTaskExecutor } = await import("../parallel-task-executor.js");
+        const { TaskUpdateEvent } = await import("@nodetool-ai/protocol");
+        const { memoryKeys } = await import("@nodetool-ai/runtime");
+        const executor = new ParallelTaskExecutor({
+            provider: runtime.provider,
+            model: runtime.model,
+            context: run.context,
+            // Every step gets the parent belt, minus the two plan capabilities: a
+            // step that re-plans or re-runs the plan it is part of is a loop.
+            tools: runtime
+                .parentTools()
+                .filter((t) => t.name !== executePlanSpec.name && t.name !== createPlanSpec.name),
+            taskPlan: plan,
+            // The run's budget and the parent's per-step iteration cap: every step
+            // this plan runs is a loop of the same run, so it reserves against the
+            // same cap and gets the same bound as a `run_subtask` child would.
+            budget: runtime.budget,
+            maxStepIterations: runtime.maxIterations,
+            // The thread's own signal: cancelling the turn cancels every task.
+            signal: run.context.signal
+        });
+        // The executor reports a task's failure reason only through the terminal
+        // `task_update` it emits, so read it off the stream on the way past.
+        const failureReasons = new Map();
+        for await (const message of executor.execute()) {
+            if (message.type === "task_update" &&
+                message.event === TaskUpdateEvent.TaskFailed &&
+                isNonEmptyString(message.task.id)) {
+                failureReasons.set(message.task.id, isNonEmptyString(message.task.error)
+                    ? message.task.error
+                    : "unknown error");
+            }
+            await runtime.forwardMessage(message);
+        }
+        const failed = new Set(executor.getFailedTaskIds());
+        const results = {};
+        // Every completed step's own result, keyed by step id. A task's result is
+        // its last step's, so what the siblings produced would otherwise reach the
+        // model only through `read_shared`. A failed step's `{ error }` payload is
+        // reported through its task, not here.
+        const steps = {};
+        for (const task of plan.tasks) {
+            for (const step of task.steps) {
+                if (!step.completed)
+                    continue;
+                const value = run.context.memory.getValue(memoryKeys.step(step.id));
+                if (value !== undefined)
+                    steps[step.id] = value;
+            }
+        }
+        const tasks = plan.tasks.map((task) => {
+            if (failed.has(task.id)) {
+                return {
+                    id: task.id,
+                    title: task.title,
+                    status: "failed",
+                    error: failureReasons.get(task.id) ?? "unknown error"
+                };
+            }
+            const value = run.context.memory.getValue(memoryKeys.task(task.id));
+            if (value === undefined) {
+                log.warn("Task completed with no result in shared memory", {
+                    taskId: task.id,
+                    title: task.title,
+                    key: memoryKeys.task(task.id)
+                });
+                return {
+                    id: task.id,
+                    title: task.title,
+                    status: "completed",
+                    result_missing: true
+                };
+            }
+            results[task.id] = value;
+            return { id: task.id, title: task.title, status: "completed" };
+        });
+        const completedCount = tasks.filter((t) => t.status === "completed").length;
+        const failedCount = tasks.filter((t) => t.status === "failed").length;
+        const report = {
+            title: plan.title,
+            executed: true,
+            task_count: tasks.length,
+            completed_count: completedCount,
+            failed_count: failedCount,
+            tasks,
+            results,
+            steps
+        };
+        // Nothing succeeded: an error the model cannot read as a deliverable,
+        // rather than a success-shaped object with empty results.
+        if (completedCount === 0 && failedCount > 0) {
+            return {
+                error: "plan_failed",
+                message: `Every task of "${plan.title}" failed: ${tasks
+                    .map((t) => `${t.id}: ${t.error ?? "unknown error"}`)
+                    .join("; ")}`,
+                ...report
+            };
+        }
+        return report;
+    }
+};
+/** Every capability this module declares. */
+export const AGENT_CAPABILITIES = [
+    runSubtask,
+    runSearch,
+    startSubtask,
+    waitSubtasks,
+    createPlan,
+    executePlan
+];
+export const module = {
+    module: "agents",
+    exports: AGENT_CAPABILITIES
+};
+export { runSubtask, runSearch, startSubtask, waitSubtasks, createPlan, executePlan };
+//# sourceMappingURL=agents.js.map

package/dist/capabilities/agents.js.map

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

package/dist/capabilities/agents.specs.d.ts

@@ -0,0 +1,27 @@
+/**
+ * The `agents` module's specs — data only, no implementation.
+ *
+ * Split out so a belt can be assembled synchronously: the registry's eager
+ * spec table imports this file, never `agents.ts`, so nothing the
+ * implementations pull in reaches the entry graph. `agents.ts` imports these
+ * back and attaches each to its implementation, so there is one spec object
+ * behind both halves.
+ */
+import type { CapabilitySpec } from "./types.js";
+import type { JsonSchema } from "@nodetool-ai/runtime";
+export declare const RUN_SUBTASK_DESCRIPTION: string;
+export declare const RUN_SUBTASK_SCHEMA: JsonSchema;
+export declare const RUN_SEARCH_SCHEMA: JsonSchema;
+export declare const runSubtaskSpec: CapabilitySpec;
+export declare const runSearchSpec: CapabilitySpec;
+export declare const startSubtaskSpec: CapabilitySpec;
+export declare const waitSubtasksSpec: CapabilitySpec;
+export declare const CREATE_PLAN_DESCRIPTION: string;
+export declare const CREATE_PLAN_SCHEMA: JsonSchema;
+export declare const createPlanSpec: CapabilitySpec;
+export declare const EXECUTE_PLAN_DESCRIPTION: string;
+export declare const EXECUTE_PLAN_SCHEMA: JsonSchema;
+export declare const executePlanSpec: CapabilitySpec;
+/** Every spec this module declares, in declaration order. */
+export declare const agentsSpecs: readonly CapabilitySpec[];
+//# sourceMappingURL=agents.specs.d.ts.map

package/dist/capabilities/agents.specs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.specs.d.ts","sourceRoot":"","sources":["../../src/capabilities/agents.specs.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAUvD,eAAO,MAAM,uBAAuB,QAcxB,CAAC;AAEb,eAAO,MAAM,kBAAkB,EAAE,UAgBhC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,UAkB/B,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,cAiB5B,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,cAe3B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,cAiB9B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,cAK9B,CAAC;AAEF,eAAO,MAAM,uBAAuB,QAYxB,CAAC;AAEb,eAAO,MAAM,kBAAkB,EAAE,UAWhC,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,cAa5B,CAAC;AAEF,eAAO,MAAM,wBAAwB,QAczB,CAAC;AAuBb,eAAO,MAAM,mBAAmB,EAAE,UAiCjC,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,cAe7B,CAAC;AAEF,6DAA6D;AAC7D,eAAO,MAAM,WAAW,EAAE,SAAS,cAAc,EAOhD,CAAC"}