@toren-run/client 0.1.2 → 0.1.3

package/dist/index.d.ts

@@ -87,6 +87,19 @@ export declare class TorenClient {
     listRuns(): Promise<RunSummary[]>;
     getRun(runId: string): Promise<RunDetail>;
     getEvents(runId: string): Promise<RunEvents>;
+    /**
+     * Follow a run's events live over SSE until it settles. Calls onEvent per
+     * event; resolves when the run is terminal or the server closes the stream.
+     */
+    tailRun(runId: string, onEvent: (e: {
+        streamId: string;
+        seq: number;
+        type: string;
+        payload: Record<string, unknown>;
+        recordedAt: string;
+    }) => void): Promise<void>;
+    /** Retire a run: retries stop and queued work for it becomes a no-op. */
+    cancelRun(runId: string): Promise<void>;
     approve(runId: string, req: {
         taskId: string;
         stepId: string;

package/dist/index.js

@@ -63,6 +63,40 @@ export class TorenClient {
     async getEvents(runId) {
         return this.request("GET", `/runs/${encodeURIComponent(runId)}/events`);
     }
+    /**
+     * Follow a run's events live over SSE until it settles. Calls onEvent per
+     * event; resolves when the run is terminal or the server closes the stream.
+     */
+    async tailRun(runId, onEvent) {
+        const res = await this.fetchImpl(`${this.base}/runs/${encodeURIComponent(runId)}/events/stream`, {
+            headers: { authorization: `Bearer ${this.cfg.token}` },
+        });
+        if (!res.ok || !res.body)
+            throw new TorenApiError(res.status, `tail failed: HTTP ${res.status}`);
+        const reader = res.body.getReader();
+        const decoder = new TextDecoder();
+        let buf = "";
+        for (;;) {
+            const { value, done } = await reader.read();
+            if (done)
+                return;
+            buf += decoder.decode(value, { stream: true });
+            let i;
+            while ((i = buf.indexOf("\n\n")) >= 0) {
+                const frame = buf.slice(0, i);
+                buf = buf.slice(i + 2);
+                if (frame.includes("event: done"))
+                    return;
+                const data = frame.split("\n").find((l) => l.startsWith("data: "));
+                if (data)
+                    onEvent(JSON.parse(data.slice(6)));
+            }
+        }
+    }
+    /** Retire a run: retries stop and queued work for it becomes a no-op. */
+    async cancelRun(runId) {
+        await this.request("POST", `/runs/${encodeURIComponent(runId)}/cancel`);
+    }
     async approve(runId, req) {
         await this.request("POST", `/runs/${encodeURIComponent(runId)}/approvals`, req);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toren-run/client",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "type": "module",
   "exports": {
     ".": {
@@ -10,8 +10,8 @@
   },
   "devDependencies": {
     "zod": "^3.23.0",
-    "toren-run": "^0.1.2",
-    "@toren-run/core": "^0.1.2"
+    "@toren-run/core": "^0.1.3",
+    "toren-run": "^0.1.3"
   },
   "description": "TypeScript client SDK for the Toren HTTP API.",
   "license": "Apache-2.0",