@nebutra/agent-runtime 0.2.1 → 0.2.2

package/dist/orchestration.d.ts

@@ -5,6 +5,32 @@ interface BudgetCap {
     readonly costUsd: number;
     readonly tokenLimit: number;
 }
+/** Thinking/reasoning effort for a node (maps to provider reasoning controls). */
+type ReasoningEffort = "low" | "medium" | "high" | "xhigh";
+/** Output modality a node produces. Mirrors @nebutra/ai-providers ModelModality. */
+type ModelModality = "text" | "image" | "video" | "audio" | "embedding";
+/**
+ * Per-node model selection — the full model meta-info a node can declare. ALL
+ * fields optional; an unset field inherits the run-level default
+ * (WorkflowDefinition.defaultModel / runTurn config). The executor resolves
+ * these HINTS against @nebutra/ai-providers/catalog (listModelsByModality /
+ * resolveFrontierModel) to a concrete model — so a node can either PIN one
+ * (`id`) or DESCRIBE what it needs ("the latest fast text model with vision").
+ */
+interface NodeModelSpec {
+    /** Explicit pin: preset alias (`flagship`/`reasoning`/`fast`) or `provider/model` id. */
+    readonly id?: string;
+    /** Thinking effort: `low` → cheap/quick, `xhigh` → deepest reasoning. */
+    readonly reasoningEffort?: ReasoningEffort;
+    /** Output modality — selects a model of this modality when `id` is unset. */
+    readonly modality?: ModelModality;
+    /** Capabilities the selected model MUST have (e.g. a node needing image input). */
+    readonly capabilities?: {
+        readonly vision?: boolean;
+        readonly toolCall?: boolean;
+        readonly reasoning?: boolean;
+    };
+}
 interface Brief {
     readonly id: string;
     readonly objective: string;
@@ -14,6 +40,8 @@ interface Brief {
     readonly boundaries: readonly string[];
     readonly budget: BudgetCap;
     readonly dependsOn?: readonly string[];
+    /** Per-node model meta-info (id/preset · thinking effort · modality · capabilities). */
+    readonly model?: NodeModelSpec;
 }
 type DispatchStrategy = "auto" | "sequential" | "fanout";
 interface DispatchPlan {
@@ -36,8 +64,21 @@ interface SubagentCostReport {
     readonly maxDurationMs: number;
     readonly subagents: number;
 }
+/**
+ * Dependency-resolved execution WAVES — the agent node-topology scheduler. Each
+ * wave is the set of briefs whose dependencies are satisfied by earlier waves;
+ * waves run in order, briefs within a wave run in parallel. Input order is
+ * preserved within a wave.
+ */
+declare function planWaves(briefs: readonly Brief[]): readonly (readonly Brief[])[];
 declare function planSubagentDispatch(briefs: readonly Brief[], options?: DispatchPlanOptions): DispatchPlan;
 declare function fanOutSubagents(briefs: readonly Brief[], run: (brief: Brief) => Promise<SubagentResult>): Promise<readonly SubagentResult[]>;
+/**
+ * Execute briefs as a dependency graph: each wave runs in parallel, waves run
+ * sequentially. The node-topology execution path — `fanOutSubagents` is the
+ * degenerate single-wave (all-independent) case of this.
+ */
+declare function runAgentWaves(briefs: readonly Brief[], run: (brief: Brief) => Promise<SubagentResult>): Promise<readonly SubagentResult[]>;
 declare function costReport(results: readonly SubagentResult[]): SubagentCostReport;
 
-export { type Brief, type BudgetCap, type DispatchPlan, type DispatchPlanOptions, type DispatchStrategy, type SubagentCostReport, type SubagentResult, costReport, fanOutSubagents, planSubagentDispatch };
+export { type Brief, type BudgetCap, type DispatchPlan, type DispatchPlanOptions, type DispatchStrategy, type ModelModality, type NodeModelSpec, type ReasoningEffort, type SubagentCostReport, type SubagentResult, costReport, fanOutSubagents, planSubagentDispatch, planWaves, runAgentWaves };

package/dist/orchestration.js

@@ -1,12 +1,16 @@
 import {
   costReport,
   fanOutSubagents,
-  planSubagentDispatch
-} from "./chunk-MX2WL43P.js";
+  planSubagentDispatch,
+  planWaves,
+  runAgentWaves
+} from "./chunk-Q62VKHIT.js";
 import "./chunk-424PT5DM.js";
 export {
   costReport,
   fanOutSubagents,
-  planSubagentDispatch
+  planSubagentDispatch,
+  planWaves,
+  runAgentWaves
 };
 //# sourceMappingURL=orchestration.js.map

package/dist/sandbox.js

@@ -4,7 +4,7 @@ import {
   SandboxDelegationError,
   assertSafePosture,
   createHttpSandbox
-} from "./chunk-MUF7ZZTO.js";
+} from "./chunk-R5HOSQUW.js";
 import "./chunk-424PT5DM.js";
 export {
   NoExecutorConfiguredError,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nebutra/agent-runtime",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "private": false,
   "license": "MIT",
   "type": "module",
@@ -22,43 +22,90 @@
     "surface": "agent-runtime",
     "summary": "Multi-tenant agent-runtime grammar: thread/turn/item model, approval+capability policy, tool/MCP abstraction, event-sourced rollout, external-sandbox delegation seam"
   },
-  "main": "./src/index.ts",
-  "types": "./src/index.ts",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
-    ".": "./src/index.ts",
-    "./model": "./src/model.ts",
-    "./protocol": "./src/protocol.ts",
-    "./pulsar": "./src/pulsar.ts",
-    "./orchestration": "./src/orchestration.ts",
-    "./policy": "./src/policy.ts",
-    "./tools": "./src/tools.ts",
-    "./rollout": "./src/rollout.ts",
-    "./sandbox": "./src/sandbox.ts",
-    "./adapters": "./src/adapters/index.ts",
-    "./adapters/mcp-catalog": "./src/adapters/mcp-catalog.ts",
-    "./adapters/dispatcher-sse": "./src/adapters/dispatcher-sse.ts",
-    "./adapters/prisma-rollout": "./src/adapters/prisma-rollout.ts"
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./model": {
+      "types": "./dist/model.d.ts",
+      "import": "./dist/model.js",
+      "default": "./dist/model.js"
+    },
+    "./protocol": {
+      "types": "./dist/protocol.d.ts",
+      "import": "./dist/protocol.js",
+      "default": "./dist/protocol.js"
+    },
+    "./pulsar": {
+      "types": "./dist/pulsar.d.ts",
+      "import": "./dist/pulsar.js",
+      "default": "./dist/pulsar.js"
+    },
+    "./orchestration": {
+      "types": "./dist/orchestration.d.ts",
+      "import": "./dist/orchestration.js",
+      "default": "./dist/orchestration.js"
+    },
+    "./policy": {
+      "types": "./dist/policy.d.ts",
+      "import": "./dist/policy.js",
+      "default": "./dist/policy.js"
+    },
+    "./tools": {
+      "types": "./dist/tools.d.ts",
+      "import": "./dist/tools.js",
+      "default": "./dist/tools.js"
+    },
+    "./rollout": {
+      "types": "./dist/rollout.d.ts",
+      "import": "./dist/rollout.js",
+      "default": "./dist/rollout.js"
+    },
+    "./sandbox": {
+      "types": "./dist/sandbox.d.ts",
+      "import": "./dist/sandbox.js",
+      "default": "./dist/sandbox.js"
+    },
+    "./adapters": {
+      "types": "./dist/adapters/index.d.ts",
+      "import": "./dist/adapters/index.js",
+      "default": "./dist/adapters/index.js"
+    },
+    "./adapters/mcp-catalog": {
+      "types": "./dist/adapters/mcp-catalog.d.ts",
+      "import": "./dist/adapters/mcp-catalog.js",
+      "default": "./dist/adapters/mcp-catalog.js"
+    },
+    "./adapters/dispatcher-sse": {
+      "types": "./dist/adapters/dispatcher-sse.d.ts",
+      "import": "./dist/adapters/dispatcher-sse.js",
+      "default": "./dist/adapters/dispatcher-sse.js"
+    },
+    "./adapters/prisma-rollout": {
+      "types": "./dist/adapters/prisma-rollout.d.ts",
+      "import": "./dist/adapters/prisma-rollout.js",
+      "default": "./dist/adapters/prisma-rollout.js"
+    }
   },
   "dependencies": {
+    "p-limit": "^7.3.0",
     "zod": "^4.3.6",
-    "@nebutra/ai-primitives": "0.1.1",
-    "@nebutra/capability-kit": "0.2.1",
-    "@nebutra/execution-policy": "0.1.1"
-  },
-  "peerDependencies": {
-    "@nebutra/mcp": "0.1.2"
-  },
-  "peerDependenciesMeta": {
-    "@nebutra/mcp": {
-      "optional": true
-    }
+    "@nebutra/agents": "1.1.2",
+    "@nebutra/ai-primitives": "0.1.2",
+    "@nebutra/graph-model": "0.2.2",
+    "@nebutra/mcp": "0.1.3",
+    "@nebutra/capability-kit": "0.2.2",
+    "@nebutra/execution-policy": "0.1.2"
   },
   "devDependencies": {
-    "@types/node": "^22.19.15",
+    "@types/node": "^25.9.1",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
-    "vitest": "^4.0.18",
-    "@nebutra/mcp": "0.1.2"
+    "vitest": "^4.0.18"
   },
   "homepage": "https://github.com/Nebutra/Nebutra-Sailor/tree/main/packages/ai/agent-runtime#readme",
   "repository": {
@@ -72,6 +119,9 @@
   "publishConfig": {
     "access": "public"
   },
+  "files": [
+    "dist"
+  ],
   "scripts": {
     "build": "tsup",
     "dev": "tsup --watch",

package/.turbo/turbo-build.log

@@ -1,130 +0,0 @@
-
-> @nebutra/agent-runtime@0.2.1 build /home/runner/work/Nebutra-Sailor/Nebutra-Sailor/packages/ai/agent-runtime
-> tsup
-
-CLI Building entry: {"index":"src/index.ts","adapters/index":"src/adapters/index.ts","adapters/dispatcher-sse":"src/adapters/dispatcher-sse.ts","adapters/mcp-catalog":"src/adapters/mcp-catalog.ts","adapters/prisma-rollout":"src/adapters/prisma-rollout.ts","commands":"src/commands.ts","cli":"src/cli.ts","definitions":"src/definitions.ts","dispatcher":"src/dispatcher.ts","durable-turn":"src/durable-turn.ts","hook-pipeline":"src/hook-pipeline.ts","loop":"src/loop.ts","mcp-bridge":"src/mcp-bridge.ts","model":"src/model.ts","orchestration":"src/orchestration.ts","policy":"src/policy.ts","protocol":"src/protocol.ts","pulsar":"src/pulsar.ts","rollout":"src/rollout.ts","rollout-store-persistent":"src/rollout-store-persistent.ts","sandbox":"src/sandbox.ts","skills":"src/skills.ts","subagents":"src/subagents.ts","tools":"src/tools.ts"}
-CLI Using tsconfig: tsconfig.json
-CLI tsup v8.5.1
-CLI Using tsup config: /home/runner/work/Nebutra-Sailor/Nebutra-Sailor/packages/ai/agent-runtime/tsup.config.ts
-CLI Target: es2022
-CLI Cleaning output folder
-ESM Build start
-ESM dist/protocol.js                     293.00 B
-ESM dist/adapters/index.js               480.00 B
-ESM dist/pulsar.js                       349.00 B
-ESM dist/rollout.js                      316.00 B
-ESM dist/rollout-store-persistent.js     219.00 B
-ESM dist/sandbox.js                      348.00 B
-ESM dist/skills.js                       215.00 B
-ESM dist/subagents.js                    404.00 B
-ESM dist/tools.js                        229.00 B
-ESM dist/dispatcher.js                   191.00 B
-ESM dist/durable-turn.js                 221.00 B
-ESM dist/hook-pipeline.js                244.00 B
-ESM dist/loop.js                         193.00 B
-ESM dist/mcp-bridge.js                   187.00 B
-ESM dist/model.js                        186.00 B
-ESM dist/orchestration.js                234.00 B
-ESM dist/policy.js                       527.00 B
-ESM dist/index.js                        100.03 KB
-ESM dist/chunk-KCNN4QUQ.js               6.91 KB
-ESM dist/chunk-2DA6Q6TN.js               3.42 KB
-ESM dist/chunk-MUF7ZZTO.js               1.62 KB
-ESM dist/chunk-GQZKYWFT.js               4.41 KB
-ESM dist/chunk-5YS7WAPS.js               5.67 KB
-ESM dist/chunk-RDKYDMXT.js               4.08 KB
-ESM dist/chunk-FUG5DT2C.js               2.45 KB
-ESM dist/chunk-SD2ZJ7XG.js               1.92 KB
-ESM dist/chunk-LO24VOA3.js               6.31 KB
-ESM dist/chunk-D4YAPLOW.js               4.19 KB
-ESM dist/chunk-37BBB2P2.js               2.19 KB
-ESM dist/chunk-NI4EDT4T.js               1.00 KB
-ESM dist/chunk-4Y25ZTKI.js               1.40 KB
-ESM dist/chunk-6EGG2OZC.js               324.00 B
-ESM dist/chunk-MX2WL43P.js               3.28 KB
-ESM dist/chunk-CGRCUKGT.js               2.38 KB
-ESM dist/adapters/dispatcher-sse.js      245.00 B
-ESM dist/chunk-ZTSKS42I.js               3.65 KB
-ESM dist/adapters/mcp-catalog.js         218.00 B
-ESM dist/chunk-24ZXP7FI.js               2.47 KB
-ESM dist/adapters/prisma-rollout.js      191.00 B
-ESM dist/chunk-57W3AR43.js               1.55 KB
-ESM dist/commands.js                     217.00 B
-ESM dist/chunk-YYFPDBJG.js               1.86 KB
-ESM dist/cli.js                          1.30 KB
-ESM dist/definitions.js                  322.00 B
-ESM dist/chunk-7BUOF367.js               4.13 KB
-ESM dist/chunk-424PT5DM.js               919.00 B
-ESM dist/protocol.js.map                 71.00 B
-ESM dist/adapters/index.js.map           71.00 B
-ESM dist/pulsar.js.map                   71.00 B
-ESM dist/rollout.js.map                  71.00 B
-ESM dist/rollout-store-persistent.js.map 71.00 B
-ESM dist/sandbox.js.map                  71.00 B
-ESM dist/skills.js.map                   71.00 B
-ESM dist/subagents.js.map                71.00 B
-ESM dist/tools.js.map                    71.00 B
-ESM dist/dispatcher.js.map               71.00 B
-ESM dist/durable-turn.js.map             71.00 B
-ESM dist/hook-pipeline.js.map            71.00 B
-ESM dist/loop.js.map                     71.00 B
-ESM dist/mcp-bridge.js.map               71.00 B
-ESM dist/model.js.map                    71.00 B
-ESM dist/orchestration.js.map            71.00 B
-ESM dist/policy.js.map                   71.00 B
-ESM dist/index.js.map                    246.22 KB
-ESM dist/chunk-KCNN4QUQ.js.map           14.41 KB
-ESM dist/chunk-2DA6Q6TN.js.map           8.01 KB
-ESM dist/chunk-MUF7ZZTO.js.map           4.91 KB
-ESM dist/chunk-GQZKYWFT.js.map           13.03 KB
-ESM dist/chunk-5YS7WAPS.js.map           15.75 KB
-ESM dist/chunk-RDKYDMXT.js.map           8.81 KB
-ESM dist/chunk-FUG5DT2C.js.map           7.87 KB
-ESM dist/chunk-SD2ZJ7XG.js.map           6.73 KB
-ESM dist/chunk-LO24VOA3.js.map           17.32 KB
-ESM dist/chunk-D4YAPLOW.js.map           10.82 KB
-ESM dist/chunk-37BBB2P2.js.map           6.88 KB
-ESM dist/chunk-NI4EDT4T.js.map           3.53 KB
-ESM dist/chunk-4Y25ZTKI.js.map           5.46 KB
-ESM dist/chunk-6EGG2OZC.js.map           5.96 KB
-ESM dist/chunk-MX2WL43P.js.map           6.96 KB
-ESM dist/chunk-CGRCUKGT.js.map           7.65 KB
-ESM dist/adapters/dispatcher-sse.js.map  71.00 B
-ESM dist/chunk-ZTSKS42I.js.map           10.83 KB
-ESM dist/adapters/mcp-catalog.js.map     71.00 B
-ESM dist/chunk-24ZXP7FI.js.map           8.26 KB
-ESM dist/adapters/prisma-rollout.js.map  71.00 B
-ESM dist/chunk-57W3AR43.js.map           4.88 KB
-ESM dist/commands.js.map                 71.00 B
-ESM dist/chunk-YYFPDBJG.js.map           6.97 KB
-ESM dist/cli.js.map                      2.29 KB
-ESM dist/definitions.js.map              71.00 B
-ESM dist/chunk-7BUOF367.js.map           10.17 KB
-ESM dist/chunk-424PT5DM.js.map           71.00 B
-ESM ⚡️ Build success in 361ms
-DTS Build start
-DTS ⚡️ Build success in 13376ms
-DTS dist/adapters/index.d.ts           581.00 B
-DTS dist/cli.d.ts                      13.00 B
-DTS dist/adapters/dispatcher-sse.d.ts  3.18 KB
-DTS dist/adapters/mcp-catalog.d.ts     2.77 KB
-DTS dist/adapters/prisma-rollout.d.ts  2.10 KB
-DTS dist/commands.d.ts                 3.64 KB
-DTS dist/dispatcher.d.ts               1.91 KB
-DTS dist/durable-turn.d.ts             2.55 KB
-DTS dist/hook-pipeline.d.ts            5.33 KB
-DTS dist/mcp-bridge.d.ts               1.91 KB
-DTS dist/orchestration.d.ts            1.64 KB
-DTS dist/pulsar.d.ts                   2.71 KB
-DTS dist/loop.d.ts                     3.16 KB
-DTS dist/protocol.d.ts                 5.32 KB
-DTS dist/rollout-store-persistent.d.ts 1.77 KB
-DTS dist/rollout.d.ts                  3.28 KB
-DTS dist/sandbox.d.ts                  2.80 KB
-DTS dist/policy.d.ts                   5.59 KB
-DTS dist/skills.d.ts                   4.40 KB
-DTS dist/subagents.d.ts                5.74 KB
-DTS dist/model.d.ts                    5.79 KB
-DTS dist/definitions.d.ts              3.96 KB
-DTS dist/tools.d.ts                    3.01 KB
-DTS dist/index.d.ts                    83.11 KB

package/.turbo/turbo-test.log

@@ -1,47 +0,0 @@
-
-> @nebutra/agent-runtime@0.2.1 test /home/runner/work/Nebutra-Sailor/Nebutra-Sailor/packages/ai/agent-runtime
-> vitest run
-
-
- RUN  v4.1.4 /home/runner/work/Nebutra-Sailor/Nebutra-Sailor/packages/ai/agent-runtime
-
- ✓ src/context-compaction.test.ts (38 tests) 131ms
- ✓ src/channel-gateway.test.ts (32 tests) 237ms
- ✓ src/code-review.test.ts (43 tests) 240ms
- ✓ src/inbound-admission.test.ts (45 tests) 214ms
- ✓ src/fuzzy-match.test.ts (36 tests) 138ms
- ✓ src/permission-ruleset.test.ts (41 tests) 245ms
- ✓ src/session-share.test.ts (29 tests) 136ms
- ✓ src/artifact-stream.test.ts (27 tests) 193ms
- ✓ src/skills.test.ts (16 tests) 198ms
- ✓ src/command-suggestions.test.ts (25 tests) 157ms
- ✓ src/commit-message.test.ts (29 tests) 173ms
- ✓ src/subagents.test.ts (20 tests) 74ms
- ✓ src/hook-pipeline.test.ts (18 tests) 289ms
- ✓ src/memory-provider.test.ts (18 tests) 139ms
- ✓ src/project-repo.test.ts (13 tests) 112ms
- ✓ src/adapters/dispatcher-sse.test.ts (11 tests) 282ms
- ✓ src/dispatcher.test.ts (16 tests) 213ms
- ✓ src/commands.test.ts (16 tests) 69ms
- ✓ src/workbench.test.ts (19 tests) 113ms
- ✓ src/adapters/mcp-catalog.test.ts (9 tests) 126ms
- ✓ src/rollout-store-persistent.test.ts (12 tests) 148ms
- ✓ src/edit-planner.test.ts (21 tests) 146ms
- ✓ src/deployment-status.test.ts (20 tests) 69ms
- ✓ src/durable-turn.test.ts (5 tests) 54ms
- ✓ src/skill-distillation.test.ts (18 tests) 40ms
- ✓ src/design-context.test.ts (17 tests) 49ms
- ✓ src/mcp-bridge.test.ts (7 tests) 49ms
- ✓ src/agent-runtime.test.ts (15 tests) 98ms
- ✓ src/adapters/prisma-rollout.test.ts (6 tests) 41ms
- ✓ src/loop.test.ts (4 tests) 40ms
- ✓ src/pulsar.test.ts (4 tests) 44ms
- ✓ src/definitions.test.ts (6 tests) 13ms
- ✓ src/orchestration.test.ts (4 tests) 9ms
- ✓ src/tools.test.ts (1 test) 15ms
-
- Test Files  34 passed (34)
-      Tests  641 passed (641)
-   Start at  08:15:22
-   Duration  15.08s (transform 4.12s, setup 0ms, import 15.30s, tests 4.29s, environment 6ms)
-

package/.turbo/turbo-typecheck.log

@@ -1,4 +0,0 @@
-
-> @nebutra/agent-runtime@0.2.1 typecheck /home/runner/work/Nebutra-Sailor/Nebutra-Sailor/packages/ai/agent-runtime
-> tsc --noEmit
-