@theokit/sdk 2.2.0 → 2.4.0

package/dist/types/run.d.ts

@@ -19,7 +19,7 @@ export type RunStatus = "running" | "finished" | "error" | "cancelled";
  *
  * @public
  */
-export type RunOperation = "stream" | "wait" | "cancel" | "conversation" | "listArtifacts" | "downloadArtifact" | "runUntil" | "fork" | "usePersonality" | "workflow";
+export type RunOperation = "stream" | "wait" | "cancel" | "conversation" | "listArtifacts" | "downloadArtifact" | "runUntil" | "runToCompletion" | "fork" | "usePersonality" | "workflow";
 /**
  * Git metadata attached to cloud runs.
  *
@@ -82,6 +82,59 @@ export interface RunResult {
      */
     stoppedAtIterationLimit?: boolean;
 }
+/**
+ * Options for {@link SDKAgent.runToCompletion} (M1 Phase 3 — continuation driver).
+ *
+ * @public
+ */
+export interface RunToCompletionOptions {
+    /**
+     * Maximum number of continuation rounds (re-sends) before giving up with
+     * `terminal: "step_limit"`. Default 5. A hard ceiling that prevents a
+     * runaway loop when the model keeps truncating.
+     */
+    maxRounds?: number;
+    /**
+     * The short prompt re-sent after a truncated round to make the (stateful)
+     * agent resume. Defaults to a generic "continue" instruction. The original
+     * conversation is preserved by the agent's session, so this need not repeat
+     * the task.
+     */
+    continuationPrompt?: string;
+    /** Called once per truncated round that triggers a re-send (for metrics/logging). */
+    onTruncated?: (event: {
+        round: number;
+    }) => void | Promise<void>;
+    /** Abort signal; checked between rounds — once aborted, no further round starts. */
+    signal?: AbortSignal;
+    /** Per-send options forwarded to each underlying `send()` (e.g. `maxIterations`). */
+    sendOptions?: SendOptions;
+}
+/**
+ * Result of {@link SDKAgent.runToCompletion}.
+ *
+ * @public
+ */
+export interface RunToCompletionResult {
+    /**
+     * Why the driver stopped:
+     * - `"done"` — a round finished without truncating (the model is done).
+     * - `"step_limit"` — `maxRounds` exhausted (or aborted) while still truncating.
+     * - `"no_progress"` — two consecutive rounds produced empty output.
+     */
+    terminal: "done" | "step_limit" | "no_progress";
+    /**
+     * Index of the final round. Round 0 is the initial `send`; rounds ≥ 1 are
+     * continuation re-sends. So `terminal: "done"` with `rounds: 0` means the
+     * first send finished without truncating; `rounds: N` means N continuation
+     * re-sends happened. For `step_limit`, `rounds` equals `maxRounds`.
+     */
+    rounds: number;
+    /** The `RunResult` of the final round. */
+    lastResult: RunResult;
+    /** Token usage summed across all rounds; `undefined` when no round reported usage. */
+    usage?: TokenUsage;
+}
 /**
  * Structured error attached to a {@link RunResult} when the underlying run
  * transitioned to `"error"` status. `message` is always present; `code` is

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theokit/sdk",
-  "version": "2.2.0",
+  "version": "2.4.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",
@@ -48,6 +48,66 @@
         "default": "./dist/errors.cjs"
       }
     },
+    "./compaction": {
+      "import": {
+        "types": "./dist/compaction.d.ts",
+        "default": "./dist/compaction.js"
+      },
+      "require": {
+        "types": "./dist/compaction.d.cts",
+        "default": "./dist/compaction.cjs"
+      }
+    },
+    "./messages": {
+      "import": {
+        "types": "./dist/messages.d.ts",
+        "default": "./dist/messages.js"
+      },
+      "require": {
+        "types": "./dist/messages.d.cts",
+        "default": "./dist/messages.cjs"
+      }
+    },
+    "./models": {
+      "import": {
+        "types": "./dist/models.d.ts",
+        "default": "./dist/models.js"
+      },
+      "require": {
+        "types": "./dist/models.d.cts",
+        "default": "./dist/models.cjs"
+      }
+    },
+    "./skills": {
+      "import": {
+        "types": "./dist/skills.d.ts",
+        "default": "./dist/skills.js"
+      },
+      "require": {
+        "types": "./dist/skills.d.cts",
+        "default": "./dist/skills.cjs"
+      }
+    },
+    "./project": {
+      "import": {
+        "types": "./dist/project.d.ts",
+        "default": "./dist/project.js"
+      },
+      "require": {
+        "types": "./dist/project.d.cts",
+        "default": "./dist/project.cjs"
+      }
+    },
+    "./subagents": {
+      "import": {
+        "types": "./dist/subagents.d.ts",
+        "default": "./dist/subagents.js"
+      },
+      "require": {
+        "types": "./dist/subagents.d.cts",
+        "default": "./dist/subagents.cjs"
+      }
+    },
     "./path-safety": {
       "import": {
         "types": "./dist/path-safety.d.ts",
@@ -295,7 +355,7 @@
     "ws": "^8.18.0",
     "zod": "^4.0.0",
     "@theokit/sdk-handoff": "0.1.0",
-    "@theokit/sdk-memory": "0.1.0"
+    "@theokit/sdk-memory": "0.2.0"
   },
   "scripts": {
     "build": "tsup && cp src/internal/providers/provider-catalog.json dist/provider-catalog.json",