@sweny-ai/core 0.1.157 → 0.1.158

package/dist/types.d.ts

@@ -3,6 +3,7 @@ export type { WorkflowInputs, WorkflowInputField, WorkflowInputType, InputValida
 export { WORKFLOW_INPUT_TYPES } from "./inputs.js";
 import type { Source as _Source, ResolvedSource as _ResolvedSource } from "./sources.js";
 import type { ToolClass } from "./harness/types.js";
+import type { Budget, BudgetOverrun } from "./budget.js";
 export type JSONSchema = Record<string, unknown>;
 /** Context passed to tool handlers at execution time */
 export interface ToolContext {
@@ -294,6 +295,12 @@ export interface Node {
     output?: JSONSchema;
     /** Max AI model turns for this node. When absent, the executor's default applies. */
     max_turns?: number;
+    /**
+     * Spend ceiling for one visit to this node (all retry attempts included),
+     * in input + output tokens and/or reported USD. Never above the workflow's
+     * `budget`. A crossing stops the agent and fails the node (see `budget.ts`).
+     */
+    budget?: Budget;
     /** Per-node directives. Additive by default; set `{ only: true, sources: [...] }` to block cascade. */
     rules?: NodeSources;
     /** Per-node background knowledge. Additive by default; set `{ only: true, sources: [...] }` to block cascade. */
@@ -523,6 +530,11 @@ export interface Workflow {
     model?: string;
     /** Soft cap on expected judge calls per workflow run. Warning at load time when exceeded. */
     judge_budget?: number;
+    /**
+     * Spend ceiling for the whole run and for every node (#449). A node's own
+     * `budget` may only narrow it. The CLI's `--max-tokens` / `--max-cost` tighten it.
+     */
+    budget?: Budget;
     /**
      * What prior results a node's prompt receives (#337). `bounded` (default):
      * only nodes it can depend on (graph ancestors, nodes named by `requires`
@@ -612,6 +624,12 @@ export interface NodeResult {
     degraded?: string[];
     /** Safe outputs (#365): what the write stage did with each intent. Absent when the node declares none. */
     outputs?: SafeOutputReceipt[];
+    /**
+     * Set when this node's spend crossed a token or cost budget (#449), or when
+     * the run's budget was already spent before it could start. The node is
+     * `failed`, `fail_soft` and `on_fail: continue` do not apply, and the run halts.
+     */
+    budget?: BudgetOverrun;
 }
 export interface ToolCall {
     tool: string;
@@ -780,6 +798,13 @@ export interface Claude {
          * carry the same read-only and native-deny intent.
          */
         policy?: import("./harness/types.js").NodePolicy;
+        /**
+         * Live spend (#449): a harness that declares `capabilities.usage.live`
+         * calls this with the run's cumulative usage as it grows. The executor
+         * aborts `signal` when a budget is crossed. Harnesses that report usage
+         * only at the end never call it.
+         */
+        onUsage?: (usage: NodeUsage) => void;
     }): Promise<NodeResult>;
     /**
      * Evaluate a routing condition — pick one of N choices.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sweny-ai/core",
-  "version": "0.1.157",
+  "version": "0.1.158",
   "type": "module",
   "bin": {
     "sweny": "./dist/cli/main.js"