@tangle-network/agent-interface 0.47.0 → 0.49.0

package/dist/agent-candidate-task-schema.d.ts

@@ -150,6 +150,7 @@ export declare const agentCandidateBenchmarkTaskMaterialSchema: z.ZodObject<{
         maxModelCalls: z.ZodNumber;
         maxInputTokens: z.ZodNumber;
         maxOutputTokens: z.ZodNumber;
+        maxTotalTokens: z.ZodOptional<z.ZodNumber>;
         maxCostUsd: z.ZodNumber;
     }, z.core.$strict>;
 }, z.core.$strict>;
@@ -304,6 +305,7 @@ export declare const agentCandidateBenchmarkTaskSchema: z.ZodObject<{
         maxModelCalls: z.ZodNumber;
         maxInputTokens: z.ZodNumber;
         maxOutputTokens: z.ZodNumber;
+        maxTotalTokens: z.ZodOptional<z.ZodNumber>;
         maxCostUsd: z.ZodNumber;
     }, z.core.$strict>;
     digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
@@ -482,6 +484,7 @@ export declare const agentCandidateBenchmarkSuiteInputsSchema: z.ZodObject<{
             maxModelCalls: z.ZodNumber;
             maxInputTokens: z.ZodNumber;
             maxOutputTokens: z.ZodNumber;
+            maxTotalTokens: z.ZodOptional<z.ZodNumber>;
             maxCostUsd: z.ZodNumber;
         }, z.core.$strict>;
         digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
@@ -635,6 +638,7 @@ export declare const agentCandidateBenchmarkSuiteInputsSchema: z.ZodObject<{
             maxModelCalls: z.ZodNumber;
             maxInputTokens: z.ZodNumber;
             maxOutputTokens: z.ZodNumber;
+            maxTotalTokens: z.ZodOptional<z.ZodNumber>;
             maxCostUsd: z.ZodNumber;
         }, z.core.$strict>;
         digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;

package/dist/agent-candidate.d.ts

@@ -402,6 +402,8 @@ export interface AgentCandidateExecutionLimits {
     maxModelCalls: number;
     maxInputTokens: number;
     maxOutputTokens: number;
+    /** Optional aggregate cap over accounted input and output tokens. */
+    maxTotalTokens?: number;
     /** Total agent plus grading spend for one complete arm. */
     maxCostUsd: number;
 }
@@ -924,6 +926,8 @@ export interface AgentCandidateModelSettlementCall {
     startedAtMs: number;
     endedAtMs: number;
     inputTokens: number;
+    /** Input plus cache units charged against the frozen input cap. */
+    accountedInputTokens: number;
     outputTokens: number;
     cachedInputTokens: number;
     reasoningTokens: number;
@@ -937,8 +941,11 @@ export interface AgentCandidateModelSettlementMaterial {
     preparationId: string;
     grantDigest: Sha256Digest;
     closed: true;
+    /** Router's terminal check over the frozen model limits. */
+    usageWithinLimits: boolean;
     resolved: AgentCandidateResolvedModel;
     calls: AgentCandidateModelSettlementCall[];
+    /** `inputTokens` is the sum of each call's accounted input tokens. */
     usage: AgentCandidateFixedSpend;
 }
 export interface AgentCandidateModelSettlementEvidence {

package/dist/agent-execution-limits.js

@@ -66,6 +66,16 @@ function executionLimitViolations(limits, observation) {
             actual: observation.usage.outputTokens,
             maximum: limits.maxOutputTokens,
         },
+        ...(limits.maxTotalTokens === undefined
+            ? []
+            : [
+                {
+                    path: ["usage", "totalTokens"],
+                    label: "totalTokens",
+                    actual: observation.usage.inputTokens + observation.usage.outputTokens,
+                    maximum: limits.maxTotalTokens,
+                },
+            ]),
         {
             path: ["usage", "costUsdNanos"],
             label: "costUsd",

package/dist/agent-profile-improvement-schema.d.ts

@@ -49,6 +49,7 @@ export declare const agentProfileImprovementTaskSchema: z.ZodObject<{
         maxModelCalls: z.ZodNumber;
         maxInputTokens: z.ZodNumber;
         maxOutputTokens: z.ZodNumber;
+        maxTotalTokens: z.ZodOptional<z.ZodNumber>;
         maxCostUsd: z.ZodNumber;
     }, z.core.$strict>;
     digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
@@ -120,6 +121,7 @@ export declare const agentProfileImprovementSuiteInputsSchema: z.ZodObject<{
             maxModelCalls: z.ZodNumber;
             maxInputTokens: z.ZodNumber;
             maxOutputTokens: z.ZodNumber;
+            maxTotalTokens: z.ZodOptional<z.ZodNumber>;
             maxCostUsd: z.ZodNumber;
         }, z.core.$strict>;
         digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
@@ -171,6 +173,7 @@ export declare const agentProfileImprovementSuiteInputsSchema: z.ZodObject<{
             maxModelCalls: z.ZodNumber;
             maxInputTokens: z.ZodNumber;
             maxOutputTokens: z.ZodNumber;
+            maxTotalTokens: z.ZodOptional<z.ZodNumber>;
             maxCostUsd: z.ZodNumber;
         }, z.core.$strict>;
         digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
@@ -301,6 +304,7 @@ export declare const agentProfileImprovementExperimentSchema: z.ZodObject<{
                 maxModelCalls: z.ZodNumber;
                 maxInputTokens: z.ZodNumber;
                 maxOutputTokens: z.ZodNumber;
+                maxTotalTokens: z.ZodOptional<z.ZodNumber>;
                 maxCostUsd: z.ZodNumber;
             }, z.core.$strict>;
             digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
@@ -352,6 +356,7 @@ export declare const agentProfileImprovementExperimentSchema: z.ZodObject<{
                 maxModelCalls: z.ZodNumber;
                 maxInputTokens: z.ZodNumber;
                 maxOutputTokens: z.ZodNumber;
+                maxTotalTokens: z.ZodOptional<z.ZodNumber>;
                 maxCostUsd: z.ZodNumber;
             }, z.core.$strict>;
             digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
@@ -451,6 +456,7 @@ export declare const agentProfileImprovementRunReceiptSchema: z.ZodObject<{
         maxModelCalls: z.ZodNumber;
         maxInputTokens: z.ZodNumber;
         maxOutputTokens: z.ZodNumber;
+        maxTotalTokens: z.ZodOptional<z.ZodNumber>;
         maxCostUsd: z.ZodNumber;
     }, z.core.$strict>;
     usage: z.ZodObject<{
@@ -830,6 +836,7 @@ export declare const agentProfileImprovementMeasuredComparisonSchema: z.ZodObjec
                     maxModelCalls: z.ZodNumber;
                     maxInputTokens: z.ZodNumber;
                     maxOutputTokens: z.ZodNumber;
+                    maxTotalTokens: z.ZodOptional<z.ZodNumber>;
                     maxCostUsd: z.ZodNumber;
                 }, z.core.$strict>;
                 digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
@@ -881,6 +888,7 @@ export declare const agentProfileImprovementMeasuredComparisonSchema: z.ZodObjec
                     maxModelCalls: z.ZodNumber;
                     maxInputTokens: z.ZodNumber;
                     maxOutputTokens: z.ZodNumber;
+                    maxTotalTokens: z.ZodOptional<z.ZodNumber>;
                     maxCostUsd: z.ZodNumber;
                 }, z.core.$strict>;
                 digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
@@ -965,6 +973,7 @@ export declare const agentProfileImprovementMeasuredComparisonSchema: z.ZodObjec
                 maxModelCalls: z.ZodNumber;
                 maxInputTokens: z.ZodNumber;
                 maxOutputTokens: z.ZodNumber;
+                maxTotalTokens: z.ZodOptional<z.ZodNumber>;
                 maxCostUsd: z.ZodNumber;
             }, z.core.$strict>;
             usage: z.ZodObject<{
@@ -1117,6 +1126,7 @@ export declare const agentProfileImprovementMeasuredComparisonSchema: z.ZodObjec
                 maxModelCalls: z.ZodNumber;
                 maxInputTokens: z.ZodNumber;
                 maxOutputTokens: z.ZodNumber;
+                maxTotalTokens: z.ZodOptional<z.ZodNumber>;
                 maxCostUsd: z.ZodNumber;
             }, z.core.$strict>;
             usage: z.ZodObject<{

package/dist/agent-profile.d.ts

@@ -122,8 +122,26 @@ export interface AgentProfileModelHints {
     /**
      * Reasoning/thinking effort hint — a first-class, portable model dimension (not buried in
      * `extensions`). Backends map it to their native control at materialization.
+     *
+     * This is a quality dial, not a spend limit. It never bounds token count.
      */
     reasoningEffort?: ReasoningEffort;
+    /**
+     * Maximum visible answer tokens a backend may bill for one completion.
+     * A positive integer. Independent of the reasoning and total ceilings.
+     */
+    maxVisibleOutputTokens?: number;
+    /**
+     * Maximum hidden reasoning tokens a backend may bill for one completion.
+     * A positive integer, separate from visible answer tokens.
+     */
+    maxReasoningTokens?: number;
+    /**
+     * Maximum total billed completion tokens for visible answer and hidden
+     * reasoning tokens together. A positive integer. When it is set with either
+     * single ceiling, that single ceiling must not exceed it.
+     */
+    maxTotalOutputTokens?: number;
     /**
      * Backend-agnostic model metadata/hints.
      */