@noetic-tools/core 5.6.0 → 5.7.0

package/dist/harness/agent-harness.d.ts

@@ -279,6 +279,8 @@ export declare class AgentHarness<TParams extends Record<string, unknown> = Reco
     detachedSpawn<I, O>(s: Step<ContextData, I, O>, input: I, parentCtx: Context, overrides?: DetachedSpawnOverrides): DetachedHandle<O>;
     createContext(opts?: {
         parent?: Context;
+        /** Charge this context's usage to `parent` as it is spent. Default `true`. */
+        rollUpUsage?: boolean;
         items?: Item[];
         state?: unknown;
         threadId?: string;

package/dist/index.d.ts

@@ -82,7 +82,7 @@ export type { DecisionsHistoryConfig, DecisionsHistoryLayer, DecisionsHistorySta
 /** @public */
 export { DECISION_PROJECTION, decisionsHistoryLayer, filesystem, findFunctionCall, history, instructions, observations, PlanPhase, PlanStyle, plan, scratchpad, steering, storageGetMany, stripUnresolvedToolCalls, taskState, temporal, toolCalls, } from '@noetic-tools/context';
 /** @public */
-export { createMessage, estimateTokens } from '@noetic-tools/types';
+export { createMessage, estimateTokens, recordUsage } from '@noetic-tools/types';
 /** @public */
 export { GenAI, NoeticAttr, ToolAttr } from './observability/genai-attributes.js';
 /** @public */
@@ -113,7 +113,7 @@ export { MergeStrategySchema, UntilPredicateSchema, validateWorkflow, WorkflowDo
 export type { Channel, ChannelHandle, ExternalChannel } from '@noetic-tools/types';
 /** @public */
 /** @public */
-export type { InferSchemaInput, InferSchemaOutput, InputSchemaConfig, LLMResponse, LlmProviderConfig, ModelParams, RetryPolicy, RoundUsage, SchemaValidationFailure, SchemaValidationResult, SchemaValidationSuccess, ServerToolSpec, StandardJSONSchemaV1, StandardSchemaV1, StepMeta, TokenUsage, Tool, ToolContextDeclaration, } from '@noetic-tools/types';
+export type { InferSchemaInput, InferSchemaOutput, InputSchemaConfig, LLMResponse, LlmProviderConfig, ModelParams, RetryPolicy, RoundUsage, SchemaValidationFailure, SchemaValidationResult, SchemaValidationSuccess, ServerToolSpec, StandardJSONSchemaV1, StandardSchemaV1, StepMeta, TokenUsage, Tool, ToolContextDeclaration, UsageCharge, } from '@noetic-tools/types';
 /** @public */
 export { isServerToolSpec, isStandardJsonSchema, isZodSchema, standardIssuesToZodError, validateSchema, } from '@noetic-tools/types';
 /** @public */

package/dist/index.js

@@ -66,7 +66,7 @@ export { DECISION_PROJECTION, decisionsHistoryLayer, filesystem, findFunctionCal
 //#endregion
 //#region Message Utilities
 /** @public */
-export { createMessage, estimateTokens } from '@noetic-tools/types';
+export { createMessage, estimateTokens, recordUsage } from '@noetic-tools/types';
 //#endregion
 //#region Observability
 /** @public */

package/dist/interpreter/execute-action.js

@@ -656,19 +656,6 @@ async function collectSpawnItems({ layers, parentExecutionCtx, childExecutionCtx
     });
     return spawnResults.flatMap((r) => r.items);
 }
-/** Adds a spawned child's accumulated token/cost usage to its parent. */
-function rollUpSpawnUsage(parent, child) {
-    if (!isMutableContext(parent)) {
-        return;
-    }
-    parent.tokens.input += child.tokens.input;
-    parent.tokens.output += child.tokens.output;
-    parent.tokens.total += child.tokens.total;
-    if (child.tokens.cached !== undefined) {
-        parent.tokens.cached = (parent.tokens.cached ?? 0) + child.tokens.cached;
-    }
-    parent.cost += child.cost;
-}
 export async function executeSpawn(step, input, ctx, executeStep, opts) {
     const baseCtx = frameworkCast(ctx);
     const layers = resolveLayersForSpawn(step, opts?.parentLayers);
@@ -736,14 +723,10 @@ export async function executeSpawn(step, input, ctx, executeStep, opts) {
         ledger: baseCtx instanceof ContextImpl ? baseCtx.ledger : undefined,
     });
     try {
-        // Execute the child step
+        // Execute the child step. Its token/cost usage needs no merge here: every
+        // charge recorded on `childCtx` is also charged up its `usageParent`
+        // chain as it is spent, so a child that throws still bills the parent.
         const childOutput = await executeStep(step.child, input, frameworkCast(childCtx));
-        // Roll the child's token/cost usage up into the parent. A sub-agent's
-        // spend is the parent's spend; without this it would be stranded on the
-        // child context and invisible to `ctx.tokens` / `ctx.cost` / until.maxCost.
-        // Because every spawn boundary rolls up, nested sub-agents propagate to the
-        // root recursively.
-        rollUpSpawnUsage(baseCtx, childCtx);
         // Pipeline result through layer onReturn hooks
         if (!hasLayers || !parentExecutionCtx) {
             return childOutput;

package/dist/runtime/context-impl.d.ts

@@ -14,6 +14,7 @@ export declare class ContextImpl implements Context<ContextData> {
     cost: number;
     state: unknown;
     readonly parent: Context<ContextData> | null;
+    readonly usageParent: Context<ContextData> | null;
     readonly depth: number;
     readonly span: Span;
     readonly threadId: string;
@@ -98,6 +99,8 @@ export declare class ContextImpl implements Context<ContextData> {
     constructor(opts: {
         harness: AgentHarnessContract;
         parent?: Context;
+        /** Charge this context's usage to `parent` as it is spent. Default `true`. */
+        rollUpUsage?: boolean;
         items?: Item[];
         state?: unknown;
         threadId?: string;

package/dist/runtime/context-impl.js

@@ -38,6 +38,7 @@ export class ContextImpl {
     cost = 0;
     state;
     parent;
+    usageParent;
     depth;
     span;
     threadId;
@@ -125,6 +126,7 @@ export class ContextImpl {
         this.harness = opts.harness;
         this.state = opts.state ?? {};
         this.parent = opts.parent ?? null;
+        this.usageParent = opts.rollUpUsage === false ? null : this.parent;
         this.depth = this.parent ? this.parent.depth + 1 : 0;
         this.span = opts.span ?? new NoopSpan();
         this.threadId = opts.threadId ?? crypto.randomUUID();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noetic-tools/core",
-  "version": "5.6.0",
+  "version": "5.7.0",
   "type": "module",
   "description": "Step primitives, interpreter, runtime, and context layer contract for Noetic agents.",
   "license": "Apache-2.0",
@@ -69,7 +69,7 @@
   },
   "dependencies": {
     "@noetic-tools/context": "^1.4.0",
-    "@noetic-tools/types": "^3.4.0",
+    "@noetic-tools/types": "^3.5.0",
     "@openrouter/agent": "^0.11.0",
     "@openrouter/sdk": "1.4.25",
     "zod": "^4.0.0"