@theokit/sdk 2.1.0 → 2.2.0

package/dist/internal/agent-loop/loop-types.d.ts

@@ -26,4 +26,10 @@ export interface AgentLoopOutput {
      * message (the previous bug — sdk-error-packaging-fix-plan).
      */
     error?: AgentLoopErrorDetail;
+    /**
+     * M1-2 (T2.2): true when the loop stopped at its iteration ceiling with the
+     * model still wanting to call tools (silent truncation). Copied verbatim onto
+     * `RunResult.stoppedAtIterationLimit`.
+     */
+    stoppedAtIterationLimit?: boolean;
 }

package/dist/internal/runtime/budget/budget-tracker.d.ts

@@ -70,4 +70,12 @@ export interface BudgetTracker {
     check(): BudgetCheck;
     /** Snapshot of accumulated totals (for telemetry / final reporting). */
     getTotal(): BudgetTotal;
+    /**
+     * Advance the iteration counter by one. Called by the agent loop ONCE per
+     * completed turn (M1-1) so that trackers which gate on `maxIterations`
+     * (e.g. `createCounterBudgetTracker`) actually halt. OPTIONAL: trackers that
+     * only gate on tokens/USD omit it and the loop no-ops via optional chaining.
+     * MUST be synchronous and non-throwing.
+     */
+    nextIteration?(): void;
 }

package/dist/{run-DrwUpFxZ.d.cts → run-ekGKZlmg.d.cts}

@@ -677,6 +677,16 @@ interface RunResult {
      * @public
      */
     cost?: CostBreakdown;
+    /**
+     * M1-2: `true` when the run stopped because the agent loop hit its iteration
+     * ceiling (`SendOptions.maxIterations` or the default of 8) while the model
+     * still wanted to call tools — i.e. the work was silently truncated rather
+     * than finished. `undefined`/absent on a clean finish. A continuation driver
+     * (or a careful caller) inspects this to decide whether to send again.
+     *
+     * @public
+     */
+    stoppedAtIterationLimit?: boolean;
 }
 /**
  * Structured error attached to a {@link RunResult} when the underlying run
@@ -789,6 +799,16 @@ interface SendOptions {
         id?: string;
         meta?: Record<string, unknown>;
     };
+    /**
+     * Per-send ceiling on the agent loop's tool-calling turns (M1-2). Raises (or
+     * lowers) the default cap of 8 for this single send — useful when one heavy
+     * task needs more rounds than the agent's default. Must be a positive
+     * integer; invalid values throw `ConfigurationError` at the boundary. When
+     * unset, the loop uses the default of 8.
+     *
+     * @public
+     */
+    maxIterations?: number;
 }
 /**
  * Handle to a single prompt submission.

package/dist/{run-DrwUpFxZ.d.ts → run-ekGKZlmg.d.ts}

@@ -677,6 +677,16 @@ interface RunResult {
      * @public
      */
     cost?: CostBreakdown;
+    /**
+     * M1-2: `true` when the run stopped because the agent loop hit its iteration
+     * ceiling (`SendOptions.maxIterations` or the default of 8) while the model
+     * still wanted to call tools — i.e. the work was silently truncated rather
+     * than finished. `undefined`/absent on a clean finish. A continuation driver
+     * (or a careful caller) inspects this to decide whether to send again.
+     *
+     * @public
+     */
+    stoppedAtIterationLimit?: boolean;
 }
 /**
  * Structured error attached to a {@link RunResult} when the underlying run
@@ -789,6 +799,16 @@ interface SendOptions {
         id?: string;
         meta?: Record<string, unknown>;
     };
+    /**
+     * Per-send ceiling on the agent loop's tool-calling turns (M1-2). Raises (or
+     * lowers) the default cap of 8 for this single send — useful when one heavy
+     * task needs more rounds than the agent's default. Must be a positive
+     * integer; invalid values throw `ConfigurationError` at the boundary. When
+     * unset, the loop uses the default of 8.
+     *
+     * @public
+     */
+    maxIterations?: number;
 }
 /**
  * Handle to a single prompt submission.

package/dist/types/run.d.ts

@@ -71,6 +71,16 @@ export interface RunResult {
      * @public
      */
     cost?: CostBreakdown;
+    /**
+     * M1-2: `true` when the run stopped because the agent loop hit its iteration
+     * ceiling (`SendOptions.maxIterations` or the default of 8) while the model
+     * still wanted to call tools — i.e. the work was silently truncated rather
+     * than finished. `undefined`/absent on a clean finish. A continuation driver
+     * (or a careful caller) inspects this to decide whether to send again.
+     *
+     * @public
+     */
+    stoppedAtIterationLimit?: boolean;
 }
 /**
  * Structured error attached to a {@link RunResult} when the underlying run
@@ -183,6 +193,16 @@ export interface SendOptions {
         id?: string;
         meta?: Record<string, unknown>;
     };
+    /**
+     * Per-send ceiling on the agent loop's tool-calling turns (M1-2). Raises (or
+     * lowers) the default cap of 8 for this single send — useful when one heavy
+     * task needs more rounds than the agent's default. Must be a positive
+     * integer; invalid values throw `ConfigurationError` at the boundary. When
+     * unset, the loop uses the default of 8.
+     *
+     * @public
+     */
+    maxIterations?: number;
 }
 /**
  * Handle to a single prompt submission.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theokit/sdk",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "TypeScript SDK for the Theo agent harness — same surface, local or cloud.",
   "license": "Apache-2.0",
   "homepage": "https://github.com/usetheo/theokit-sdk#readme",