@smithers-orchestrator/components 0.24.0 → 0.24.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smithers-orchestrator/components",
-  "version": "0.24.0",
+  "version": "0.24.2",
   "description": "React components for Smithers workflows",
   "type": "module",
   "sideEffects": false,
@@ -24,15 +24,15 @@
     "react": "^19.2.5",
     "react-dom": "^19.2.5",
     "zod": "^4.3.6",
-    "@smithers-orchestrator/agents": "0.24.0",
-    "@smithers-orchestrator/db": "0.24.0",
-    "@smithers-orchestrator/driver": "0.24.0",
-    "@smithers-orchestrator/errors": "0.24.0",
-    "@smithers-orchestrator/graph": "0.24.0",
-    "@smithers-orchestrator/memory": "0.24.0",
-    "@smithers-orchestrator/scheduler": "0.24.0",
-    "@smithers-orchestrator/react-reconciler": "0.24.0",
-    "@smithers-orchestrator/observability": "0.24.0"
+    "@smithers-orchestrator/agents": "0.24.2",
+    "@smithers-orchestrator/db": "0.24.2",
+    "@smithers-orchestrator/graph": "0.24.2",
+    "@smithers-orchestrator/errors": "0.24.2",
+    "@smithers-orchestrator/driver": "0.24.2",
+    "@smithers-orchestrator/observability": "0.24.2",
+    "@smithers-orchestrator/react-reconciler": "0.24.2",
+    "@smithers-orchestrator/scheduler": "0.24.2",
+    "@smithers-orchestrator/memory": "0.24.2"
   },
   "devDependencies": {
     "@tanstack/react-query": "^5.99.1",

package/src/aspects/AspectAccumulator.ts

@@ -4,6 +4,5 @@
 export type AspectAccumulator = {
 	totalTokens: number;
 	totalLatencyMs: number;
-	totalCostUsd: number;
 	taskCount: number;
 };

package/src/aspects/AspectContext.js

@@ -1,7 +1,6 @@
 // @smithers-type-exports-begin
 /** @typedef {import("./AspectAccumulator.ts").AspectAccumulator} AspectAccumulator */
 /** @typedef {import("./AspectContextValue.ts").AspectContextValue} AspectContextValue */
-/** @typedef {import("./CostBudgetConfig.ts").CostBudgetConfig} CostBudgetConfig */
 /** @typedef {import("./LatencySloConfig.ts").LatencySloConfig} LatencySloConfig */
 /** @typedef {import("./TokenBudgetConfig.ts").TokenBudgetConfig} TokenBudgetConfig */
 /** @typedef {import("./TrackingConfig.ts").TrackingConfig} TrackingConfig */
@@ -10,7 +9,8 @@
 import React from "react";
 /**
  * React context that propagates Aspects configuration down the component tree.
- * Budget configuration is declarative metadata and is not enforced yet.
+ * Tasks read from this context to attach budgets the engine enforces and to
+ * track metrics.
  * @type {React.Context<AspectContextValue | null>}
  */
 export const AspectContext = React.createContext(/** @type {AspectContextValue | null} */ (null));
@@ -23,7 +23,6 @@ export function createAccumulator() {
     return {
         totalTokens: 0,
         totalLatencyMs: 0,
-        totalCostUsd: 0,
         taskCount: 0,
     };
 }

package/src/aspects/AspectContextValue.ts

@@ -1,6 +1,5 @@
 import type { TokenBudgetConfig } from "./TokenBudgetConfig.ts";
 import type { LatencySloConfig } from "./LatencySloConfig.ts";
-import type { CostBudgetConfig } from "./CostBudgetConfig.ts";
 import type { TrackingConfig } from "./TrackingConfig.ts";
 import type { AspectAccumulator } from "./AspectAccumulator.ts";
 
@@ -10,7 +9,6 @@ import type { AspectAccumulator } from "./AspectAccumulator.ts";
 export type AspectContextValue = {
 	tokenBudget?: TokenBudgetConfig;
 	latencySlo?: LatencySloConfig;
-	costBudget?: CostBudgetConfig;
 	tracking: TrackingConfig;
 	accumulator: AspectAccumulator;
 };

package/src/aspects/LatencySloConfig.ts

@@ -1,13 +1,14 @@
 /**
  * Latency SLO configuration for Aspects.
  *
- * Runtime enforcement is not implemented yet; this is declarative metadata.
+ * The engine enforces the scope-wide `maxMs` wall-clock SLO at task-dispatch
+ * time, measured from the run's start.
  */
 export type LatencySloConfig = {
-	/** Maximum total latency in milliseconds across all tasks. */
+	/** Maximum total wall-clock latency in milliseconds across all tasks. */
 	maxMs: number;
-	/** Optional per-task latency limit in milliseconds. */
+	/** Optional per-task latency limit in milliseconds. Not enforced yet. */
 	perTask?: number;
-	/** Requested future behavior when the SLO is exceeded. Default: "fail". */
+	/** Behavior when the SLO is exceeded. Default: "fail". */
 	onExceeded?: "fail" | "warn";
 };

package/src/aspects/TokenBudgetConfig.ts

@@ -1,13 +1,14 @@
 /**
  * Token budget configuration for Aspects.
  *
- * Runtime enforcement is not implemented yet; this is declarative metadata.
+ * The engine accumulates per-run token usage and enforces `max` at
+ * task-dispatch time.
  */
 export type TokenBudgetConfig = {
 	/** Maximum total tokens across all tasks within the Aspects scope. */
 	max: number;
-	/** Optional per-task token limit. */
+	/** Optional per-task token limit. Not enforced yet. */
 	perTask?: number;
-	/** Requested future behavior when the budget is exceeded. Default: "fail". */
+	/** Behavior when the budget is exceeded. Default: "fail". */
 	onExceeded?: "fail" | "warn" | "skip-remaining";
 };

package/src/aspects/TrackingConfig.ts

@@ -6,6 +6,4 @@ export type TrackingConfig = {
 	tokens?: boolean;
 	/** Track latency. Default: true. */
 	latency?: boolean;
-	/** Track cost. Default: true. */
-	cost?: boolean;
 };

package/src/aspects/index.js

@@ -1,7 +1,6 @@
 // @smithers-type-exports-begin
 /** @typedef {import("./AspectAccumulator.ts").AspectAccumulator} AspectAccumulator */
 /** @typedef {import("./AspectContextValue.ts").AspectContextValue} AspectContextValue */
-/** @typedef {import("./CostBudgetConfig.ts").CostBudgetConfig} CostBudgetConfig */
 /** @typedef {import("./LatencySloConfig.ts").LatencySloConfig} LatencySloConfig */
 /** @typedef {import("./TokenBudgetConfig.ts").TokenBudgetConfig} TokenBudgetConfig */
 /** @typedef {import("./TrackingConfig.ts").TrackingConfig} TrackingConfig */

package/src/components/Aspects.js

@@ -9,8 +9,8 @@ import { AspectContext, createAccumulator, } from "../aspects/AspectContext.js";
  *
  * Wraps a section of the workflow tree and propagates token budgets,
  * latency SLOs, and cost budgets to all descendant Task components
- * without modifying individual tasks. Runtime budget enforcement is not
- * implemented yet.
+ * without modifying individual tasks. The engine enforces the scope-wide
+ * budgets at task-dispatch time.
  *
  * ```tsx
  * <Aspects tokenBudget={{ max: 100_000, perTask: 20_000, onExceeded: "warn" }}>
@@ -21,18 +21,16 @@ import { AspectContext, createAccumulator, } from "../aspects/AspectContext.js";
  * @param {AspectsProps} props
  */
 export function Aspects(props) {
-    const { tokenBudget, latencySlo, costBudget, tracking, children } = props;
+    const { tokenBudget, latencySlo, tracking, children } = props;
     // Merge with parent context if nested
     const parentCtx = React.useContext(AspectContext);
     const resolvedTracking = {
         tokens: tracking?.tokens ?? parentCtx?.tracking?.tokens ?? true,
         latency: tracking?.latency ?? parentCtx?.tracking?.latency ?? true,
-        cost: tracking?.cost ?? parentCtx?.tracking?.cost ?? true,
     };
     const value = {
         tokenBudget: tokenBudget ?? parentCtx?.tokenBudget,
         latencySlo: latencySlo ?? parentCtx?.latencySlo,
-        costBudget: costBudget ?? parentCtx?.costBudget,
         tracking: resolvedTracking,
         accumulator: parentCtx?.accumulator ?? createAccumulator(),
     };

package/src/components/AspectsProps.ts

@@ -1,16 +1,13 @@
 import type React from "react";
 import type { TokenBudgetConfig } from "../aspects/TokenBudgetConfig.ts";
 import type { LatencySloConfig } from "../aspects/LatencySloConfig.ts";
-import type { CostBudgetConfig } from "../aspects/CostBudgetConfig.ts";
 import type { TrackingConfig } from "../aspects/TrackingConfig.ts";
 
 export type AspectsProps = {
-	/** Token budget metadata. Runtime enforcement is not implemented yet. */
+	/** Token budget — max total tokens, optional per-task limit, and exceeded behavior. */
 	tokenBudget?: TokenBudgetConfig;
-	/** Latency SLO metadata. Runtime enforcement is not implemented yet. */
+	/** Latency SLO — max total wall-clock latency and exceeded behavior. */
 	latencySlo?: LatencySloConfig;
-	/** Cost budget metadata. Runtime enforcement is not implemented yet. */
-	costBudget?: CostBudgetConfig;
 	/** Which metrics to track. Defaults to all enabled. */
 	tracking?: TrackingConfig;
 	/** Workflow content these aspects apply to. */

package/src/components/Task.js

@@ -223,8 +223,8 @@ export function Task(props) {
         ctx?.recordDeferredDep?.(props.id, depNodeIds ?? []);
         return null;
     }
-    // Build aspect metadata to attach to the task element. Budget metadata is
-    // declarative only until runtime enforcement is implemented.
+    // Build aspect metadata to attach to the task element so the engine can
+    // enforce budgets and track metrics at execution time.
     const aspectMeta = aspectCtx ? buildAspectMeta(aspectCtx) : undefined;
     const agentChain = Array.isArray(agent)
         ? fallbackAgent
@@ -287,12 +287,11 @@ export function Task(props) {
 }
 /**
  * Build the __aspects metadata object from the current AspectContext.
- * This is attached to the smithers:task element props. Budget metadata is not
- * enforced by the runtime yet.
+ * This is attached to the smithers:task element props so the engine can read
+ * budgets and tracking config at execution time.
  * @param {{
  *     tokenBudget?: unknown;
  *     latencySlo?: unknown;
- *     costBudget?: unknown;
  *     tracking?: unknown;
  *     accumulator?: unknown;
  * }} aspectCtx
@@ -303,7 +302,6 @@ function buildAspectMeta(aspectCtx) {
         __aspects: {
             tokenBudget: aspectCtx.tokenBudget,
             latencySlo: aspectCtx.latencySlo,
-            costBudget: aspectCtx.costBudget,
             tracking: aspectCtx.tracking,
             accumulator: aspectCtx.accumulator,
         },

package/src/index.d.ts

@@ -800,43 +800,33 @@ type BranchProps$2 = {
 /**
  * Token budget configuration for Aspects.
  *
- * Runtime enforcement is not implemented yet; this is declarative metadata.
+ * The engine accumulates per-run token usage and enforces `max` at
+ * task-dispatch time.
  */
 type TokenBudgetConfig = {
     /** Maximum total tokens across all tasks within the Aspects scope. */
     max: number;
-    /** Optional per-task token limit. */
+    /** Optional per-task token limit. Not enforced yet. */
     perTask?: number;
-    /** Requested future behavior when the budget is exceeded. Default: "fail". */
+    /** Behavior when the budget is exceeded. Default: "fail". */
     onExceeded?: "fail" | "warn" | "skip-remaining";
 };
 
 /**
  * Latency SLO configuration for Aspects.
  *
- * Runtime enforcement is not implemented yet; this is declarative metadata.
+ * The engine enforces the scope-wide `maxMs` wall-clock SLO at task-dispatch
+ * time, measured from the run's start.
  */
 type LatencySloConfig = {
-    /** Maximum total latency in milliseconds across all tasks. */
+    /** Maximum total wall-clock latency in milliseconds across all tasks. */
     maxMs: number;
-    /** Optional per-task latency limit in milliseconds. */
+    /** Optional per-task latency limit in milliseconds. Not enforced yet. */
     perTask?: number;
-    /** Requested future behavior when the SLO is exceeded. Default: "fail". */
+    /** Behavior when the SLO is exceeded. Default: "fail". */
     onExceeded?: "fail" | "warn";
 };
 
-/**
- * Cost budget configuration for Aspects.
- *
- * Runtime enforcement is not implemented yet; this is declarative metadata.
- */
-type CostBudgetConfig = {
-    /** Maximum total cost in USD across all tasks within the Aspects scope. */
-    maxUsd: number;
-    /** Requested future behavior when the budget is exceeded. Default: "fail". */
-    onExceeded?: "fail" | "warn" | "skip-remaining";
-};
-
 /**
  * Tracking configuration — which metrics to track.
  */
@@ -845,17 +835,13 @@ type TrackingConfig = {
     tokens?: boolean;
     /** Track latency. Default: true. */
     latency?: boolean;
-    /** Track cost. Default: true. */
-    cost?: boolean;
 };
 
 type AspectsProps$2 = {
-    /** Token budget metadata. Runtime enforcement is not implemented yet. */
+    /** Token budget — max total tokens, optional per-task limit, and exceeded behavior. */
     tokenBudget?: TokenBudgetConfig;
-    /** Latency SLO metadata. Runtime enforcement is not implemented yet. */
+    /** Latency SLO — max total wall-clock latency and exceeded behavior. */
     latencySlo?: LatencySloConfig;
-    /** Cost budget metadata. Runtime enforcement is not implemented yet. */
-    costBudget?: CostBudgetConfig;
     /** Which metrics to track. Defaults to all enabled. */
     tracking?: TrackingConfig;
     /** Workflow content these aspects apply to. */
@@ -1400,7 +1386,6 @@ type TryCatchFinallyProps$1 = TryCatchFinallyProps$2;
 type AspectAccumulator = {
     totalTokens: number;
     totalLatencyMs: number;
-    totalCostUsd: number;
     taskCount: number;
 };
 
@@ -1410,7 +1395,6 @@ type AspectAccumulator = {
 type AspectContextValue = {
     tokenBudget?: TokenBudgetConfig;
     latencySlo?: LatencySloConfig;
-    costBudget?: CostBudgetConfig;
     tracking: TrackingConfig;
     accumulator: AspectAccumulator;
 };

package/src/aspects/CostBudgetConfig.ts

@@ -1,11 +0,0 @@
-/**
- * Cost budget configuration for Aspects.
- *
- * Runtime enforcement is not implemented yet; this is declarative metadata.
- */
-export type CostBudgetConfig = {
-	/** Maximum total cost in USD across all tasks within the Aspects scope. */
-	maxUsd: number;
-	/** Requested future behavior when the budget is exceeded. Default: "fail". */
-	onExceeded?: "fail" | "warn" | "skip-remaining";
-};