@ellipsis-dev/sdk 0.15.1 → 0.16.0

package/dist/stream/index.d.ts

@@ -1,4 +1,4 @@
-import { a7 as StreamFrame, K as Session } from '../types-D9g-eZui.js';
+import { a7 as StreamFrame, K as Session } from '../types-DB1hOyQE.js';
 
 declare const SESSION_STREAM_PROTOCOL_VERSION = 3;
 declare const WS_CLOSE_NORMAL = 1000;

package/dist/stream/index.js

@@ -1,192 +1,21 @@
-// src/stream/index.ts
-var SESSION_STREAM_PROTOCOL_VERSION = 3;
-var WS_CLOSE_NORMAL = 1e3;
-var WS_CLOSE_GOING_AWAY = 1001;
-var WS_CLOSE_UNSUPPORTED_PROTOCOL_VERSION = 1002;
-var WS_CLOSE_NO_PROTOCOL = 1003;
-var WS_CLOSE_AUTH_FAILED = 1008;
-var WS_CLOSE_SERVER_ERROR = 1011;
-var WS_CLOSE_OVER_CAPACITY = 1013;
-function sessionStatusWord(session) {
-  return session.surface?.status ?? session.status;
-}
-var StreamUnavailableError = class extends Error {
-  constructor(message) {
-    super(message);
-    this.name = "StreamUnavailableError";
-  }
-};
-var StreamAuthError = class extends Error {
-  constructor(message) {
-    super(message);
-    this.name = "StreamAuthError";
-  }
-};
-function streamQuery(afterSeq) {
-  const base = `protocol=${SESSION_STREAM_PROTOCOL_VERSION}`;
-  return afterSeq > 0 ? `${base}&after_seq=${afterSeq}` : base;
-}
-var HEARTBEAT_TIMEOUT_MS = 45e3;
-var DEFAULT_MAX_RECONNECTS = 5;
-function classifyCloseCode(code) {
-  switch (code) {
-    case WS_CLOSE_NORMAL:
-      return "normal";
-    case WS_CLOSE_AUTH_FAILED:
-    case 4401:
-    // dashboard ticket door: bad/expired ticket
-    case 4403:
-      return "auth";
-    case WS_CLOSE_UNSUPPORTED_PROTOCOL_VERSION:
-    case WS_CLOSE_NO_PROTOCOL:
-      return "unsupported";
-    default:
-      return "retry";
-  }
-}
-function nextReconnectDelayMs(attempt) {
-  const base = 500;
-  const max = 8e3;
-  return Math.min(max, base * 2 ** Math.max(0, attempt - 1));
-}
-function decideReconnect(params) {
-  const { closeKind, everReceivedFrame, attempt, maxReconnects } = params;
-  if (closeKind === "auth") return { action: "fail-auth" };
-  if (closeKind === "unsupported") return { action: "fallback" };
-  const cap = everReceivedFrame ? maxReconnects : Math.min(2, maxReconnects);
-  if (attempt >= cap) return { action: "fallback" };
-  return { action: "reconnect", delayMs: nextReconnectDelayMs(attempt) };
-}
-function connectOnce(sock, emit, signal) {
-  return new Promise((resolve) => {
-    let settled = false;
-    let heartbeat;
-    const finish = (result) => {
-      if (settled) return;
-      settled = true;
-      if (heartbeat) clearTimeout(heartbeat);
-      if (signal) signal.removeEventListener("abort", onAbort);
-      sock.close();
-      resolve(result);
-    };
-    const onAbort = () => finish({ kind: "aborted" });
-    const bumpHeartbeat = () => {
-      if (heartbeat) clearTimeout(heartbeat);
-      heartbeat = setTimeout(
-        () => finish({ kind: "error", err: new Error("heartbeat timeout") }),
-        HEARTBEAT_TIMEOUT_MS
-      );
-    };
-    if (signal) {
-      if (signal.aborted) {
-        finish({ kind: "aborted" });
-        return;
-      }
-      signal.addEventListener("abort", onAbort);
-    }
-    sock.onOpen(() => bumpHeartbeat());
-    sock.onMessage((data) => {
-      bumpHeartbeat();
-      let frame;
-      try {
-        frame = JSON.parse(data);
-      } catch {
-        return;
-      }
-      emit(frame);
-      if (frame.type === "done") {
-        finish({ kind: "done" });
-      } else if (frame.type === "error") {
-        finish({
-          kind: "frameError",
-          message: frame.message ?? "stream error"
-        });
-      }
-    });
-    sock.onClose((code) => finish({ kind: "closed", code }));
-    sock.onError((err) => finish({ kind: "error", err }));
-  });
-}
-function sleep(ms, signal) {
-  return new Promise((resolve) => {
-    const timer = setTimeout(resolve, ms);
-    signal?.addEventListener(
-      "abort",
-      () => {
-        clearTimeout(timer);
-        resolve();
-      },
-      { once: true }
-    );
-  });
-}
-async function streamSession(opts) {
-  const maxReconnects = opts.maxReconnects ?? DEFAULT_MAX_RECONNECTS;
-  let afterSeq = opts.afterSeq ?? 0;
-  let everReceivedFrame = false;
-  let attempt = 0;
-  let lastStatusWord = "";
-  let lastExitStatus = null;
-  const emit = (frame) => {
-    everReceivedFrame = true;
-    attempt = 0;
-    if (frame.type === "records_append") {
-      const records = frame.records;
-      for (const record of records) {
-        if (typeof record.feed_seq === "number") {
-          afterSeq = Math.max(afterSeq, record.feed_seq);
-        }
-      }
-    } else if (frame.type === "snapshot" || frame.type === "session") {
-      const session = frame.session;
-      lastStatusWord = sessionStatusWord(session);
-      lastExitStatus = session.exit_status ?? null;
-    }
-    opts.onFrame(frame);
-  };
-  for (; ; ) {
-    if (opts.signal?.aborted) return { type: "aborted" };
-    let res;
-    try {
-      const sock = await opts.openSocket({
-        sessionId: opts.sessionId,
-        afterSeq,
-        query: streamQuery(afterSeq)
-      });
-      res = await connectOnce(sock, emit, opts.signal);
-    } catch (err) {
-      res = {
-        kind: "error",
-        err: err instanceof Error ? err : new Error(String(err))
-      };
-    }
-    if (res.kind === "done") {
-      return {
-        type: "done",
-        status: lastStatusWord,
-        exitStatus: lastExitStatus
-      };
-    }
-    if (res.kind === "frameError")
-      return { type: "error", message: res.message };
-    if (res.kind === "aborted") return { type: "aborted" };
-    attempt++;
-    const decision = decideReconnect({
-      closeKind: res.kind === "closed" ? classifyCloseCode(res.code) : void 0,
-      everReceivedFrame,
-      attempt,
-      maxReconnects
-    });
-    if (decision.action === "fail-auth") {
-      throw new StreamAuthError("not authorized to stream this session");
-    }
-    if (decision.action === "fallback") {
-      const why = res.kind === "error" ? res.err.message : `stream closed (code ${res.code})`;
-      throw new StreamUnavailableError(why);
-    }
-    await sleep(decision.delayMs ?? 0, opts.signal);
-  }
-}
+import {
+  SESSION_STREAM_PROTOCOL_VERSION,
+  StreamAuthError,
+  StreamUnavailableError,
+  WS_CLOSE_AUTH_FAILED,
+  WS_CLOSE_GOING_AWAY,
+  WS_CLOSE_NORMAL,
+  WS_CLOSE_NO_PROTOCOL,
+  WS_CLOSE_OVER_CAPACITY,
+  WS_CLOSE_SERVER_ERROR,
+  WS_CLOSE_UNSUPPORTED_PROTOCOL_VERSION,
+  classifyCloseCode,
+  decideReconnect,
+  nextReconnectDelayMs,
+  sessionStatusWord,
+  streamQuery,
+  streamSession
+} from "../chunk-RMPAMUAE.js";
 export {
   SESSION_STREAM_PROTOCOL_VERSION,
   StreamAuthError,

package/dist/{types-D9g-eZui.d.ts → types-DB1hOyQE.d.ts}

@@ -4625,16 +4625,13 @@ interface components {
              * @description The session execution that produced the record, or null for session-scoped lifecycle records.
              */
             execution_id?: string | null;
+            /** @description What the session did to git, per repository, so a result row can show what it shipped without fetching the session. */
+            git?: components['schemas']['SessionGit'] | null;
             /**
              * Id
              * @description The matching record's unique identifier.
              */
             id: string;
-            /**
-             * Output Prs
-             * @description Pull requests the session created, so a result row can show what it shipped without fetching the session.
-             */
-            output_prs?: components['schemas']['SessionPr'][] | null;
             /**
              * Record Type
              * @description The record's event type.
@@ -5977,6 +5974,8 @@ interface components {
             created_at: string;
             /** @description How the session ended; null until it is terminal. */
             exit_status?: components['schemas']['SessionExitStatus'] | null;
+            /** @description What the session did to git, one entry per repository in its workspace: the commit and branch it sits on, per-file line counts for its uncommitted changes, and the pull requests it opened. Null if nothing was ever captured. */
+            git?: components['schemas']['SessionGit'] | null;
             /** @description The coding-agent harness the session runs on. */
             harness: components['schemas']['Harness'];
             /**
@@ -6002,13 +6001,6 @@ interface components {
             metadata: {
                 [key: string]: string;
             };
-            /** @description Per-file line counts for the uncommitted changes in the session's workspace. Work the session committed is not included here — see output_prs. Null if no diff was ever captured. */
-            output_diff?: components['schemas']['SessionDiff'] | null;
-            /**
-             * Output Prs
-             * @description Pull requests the session created or updated.
-             */
-            output_prs?: components['schemas']['SessionPr'][] | null;
             /** @description What preceded this session, if anything. */
             parent?: components['schemas']['SessionParent'];
             /**
@@ -6147,37 +6139,6 @@ interface components {
              */
             total: number;
         };
-        /**
-         * SessionDiff
-         * @description The counts half of a session's working-tree diff, small enough to ride on
-         *     agent_sessions and be returned by every session read. The patch text lives
-         *     in `agent_session_diffs` and is fetched on demand.
-         *
-         *     Scope is UNCOMMITTED work only (`git diff HEAD`), so this answers "is there
-         *     unlanded work in this sandbox?" — a session that committed and pushed shows
-         *     no files here and its created PR instead.
-         */
-        SessionDiff: {
-            /** Files */
-            files: components['schemas']['SessionDiffFile'][];
-        };
-        /**
-         * SessionDiffFile
-         * @description One file's uncommitted change in a session's sandbox, as `git diff HEAD`
-         *     --numstat reports it (with intent-to-add so new files count).
-         */
-        SessionDiffFile: {
-            /** Additions */
-            additions: number;
-            /** Deletions */
-            deletions: number;
-            /** Path */
-            path: string;
-            /** Repo */
-            repo: string;
-            /** Status */
-            status: string;
-        };
         /**
          * SessionExecution
          * @description One runtime attempt of a session — the initial start, a cold wake of a
@@ -6266,6 +6227,75 @@ interface components {
          * @enum {string}
          */
         SessionExitStatus: 'completed' | 'budget_hit' | 'payment_required' | 'tool_call_failed' | 'lifecycle_hook_failed' | 'missing_repo_access' | 'missing_token_permissions' | 'missing_sandbox_variables' | 'blocked' | 'contact_email_required' | 'cancelled' | 'interrupted' | 'error' | 'stopped';
+        /**
+         * SessionGit
+         * @description Every repo the session touched. Small enough to ride on `agent_sessions`
+         *     and be returned by every session read.
+         */
+        SessionGit: {
+            /**
+             * Repos
+             * @default []
+             */
+            repos: components['schemas']['SessionGitRepo'][];
+        };
+        /**
+         * SessionGitFile
+         * @description One file's uncommitted change, as `git diff HEAD --numstat` reports it
+         *     (with intent-to-add, so a brand-new file still counts).
+         */
+        SessionGitFile: {
+            /** Additions */
+            additions: number;
+            /** Deletions */
+            deletions: number;
+            /** Path */
+            path: string;
+            /** Status */
+            status: string;
+        };
+        /**
+         * SessionGitPr
+         * @description A pull request the session opened in this repo, denormalized at capture
+         *     time so a surface renders a labeled link without joining gh_prs. Live PR
+         *     state (open/merged/closed) is not stored — read gh_prs where a view needs
+         *     it. The repo is the parent object, so it is not repeated here.
+         */
+        SessionGitPr: {
+            /** Gh Pr Id */
+            gh_pr_id?: number | null;
+            /** Number */
+            number: number;
+            /** Title */
+            title?: string | null;
+            /** Url */
+            url: string;
+        };
+        /**
+         * SessionGitRepo
+         * @description One checkout in the session's sandbox and everything the session did to
+         *     it, split by whether it survived the sandbox.
+         */
+        SessionGitRepo: {
+            /** Full Name */
+            full_name: string;
+            /** Local Commit */
+            local_commit?: string | null;
+            /**
+             * Local Uncommitted Files
+             * @default []
+             */
+            local_uncommitted_files: components['schemas']['SessionGitFile'][];
+            /**
+             * Prs
+             * @default []
+             */
+            prs: components['schemas']['SessionGitPr'][];
+            /** Remote Branch */
+            remote_branch?: string | null;
+            /** Remote Commit */
+            remote_commit?: string | null;
+        };
         /**
          * SessionLiveness
          * @description The durable conversation axis (backs the surfaced `session` field).
@@ -6400,25 +6430,6 @@ interface components {
              */
             session_id?: string | null;
         };
-        /**
-         * SessionPr
-         * @description A pull request this session created, denormalized at capture time so
-         *     session surfaces render a labeled link without joining gh_prs. Live PR
-         *     state (open/merged/closed) is not stored here — read it from gh_prs where
-         *     a view needs it.
-         */
-        SessionPr: {
-            /** Gh Pr Id */
-            gh_pr_id?: number | null;
-            /** Number */
-            number: number;
-            /** Repo Full Name */
-            repo_full_name: string;
-            /** Title */
-            title?: string | null;
-            /** Url */
-            url: string;
-        };
         /**
          * SessionPrompting
          * @description The prompt-affordance projection. `enabled` answers "would a send work",
@@ -10844,6 +10855,10 @@ interface Session {
      * How the session ended; null until it is terminal.
      */
     exit_status: SessionExitStatus | null;
+    /**
+     * What the session did to git, one entry per repository in its workspace: the commit and branch it sits on, per-file line counts for its uncommitted changes, and the pull requests it opened. Null if nothing was ever captured.
+     */
+    git: SessionGit | null;
     harness: Harness;
     /**
      * Unique identifier of the session.
@@ -10863,14 +10878,6 @@ interface Session {
     metadata: {
         [k: string]: string;
     };
-    /**
-     * Per-file line counts for the uncommitted changes in the session's workspace. Work the session committed is not included here — see output_prs. Null if no diff was ever captured.
-     */
-    output_diff: SessionDiff | null;
-    /**
-     * Pull requests the session created or updated.
-     */
-    output_prs: SessionPr[] | null;
     parent: SessionParent;
     /**
      * The per-session prompt the session was started with.
@@ -11380,38 +11387,43 @@ interface SessionCost {
     total: number;
 }
 /**
- * The counts half of a session's working-tree diff, small enough to ride on
- * agent_sessions and be returned by every session read. The patch text lives
- * in `agent_session_diffs` and is fetched on demand.
- *
- * Scope is UNCOMMITTED work only (`git diff HEAD`), so this answers "is there
- * unlanded work in this sandbox?" — a session that committed and pushed shows
- * no files here and its created PR instead.
+ * Every repo the session touched. Small enough to ride on `agent_sessions`
+ * and be returned by every session read.
+ */
+interface SessionGit {
+    repos: SessionGitRepo[];
+}
+/**
+ * One checkout in the session's sandbox and everything the session did to
+ * it, split by whether it survived the sandbox.
  */
-interface SessionDiff {
-    files: SessionDiffFile[];
+interface SessionGitRepo {
+    full_name: string;
+    local_commit: string | null;
+    local_uncommitted_files: SessionGitFile[];
+    prs: SessionGitPr[];
+    remote_branch: string | null;
+    remote_commit: string | null;
 }
 /**
- * One file's uncommitted change in a session's sandbox, as `git diff HEAD`
- * --numstat reports it (with intent-to-add so new files count).
+ * One file's uncommitted change, as `git diff HEAD --numstat` reports it
+ * (with intent-to-add, so a brand-new file still counts).
  */
-interface SessionDiffFile {
+interface SessionGitFile {
     additions: number;
     deletions: number;
     path: string;
-    repo: string;
     status: string;
 }
 /**
- * A pull request this session created, denormalized at capture time so
- * session surfaces render a labeled link without joining gh_prs. Live PR
- * state (open/merged/closed) is not stored here — read it from gh_prs where
- * a view needs it.
+ * A pull request the session opened in this repo, denormalized at capture
+ * time so a surface renders a labeled link without joining gh_prs. Live PR
+ * state (open/merged/closed) is not stored — read gh_prs where a view needs
+ * it. The repo is the parent object, so it is not repeated here.
  */
-interface SessionPr {
+interface SessionGitPr {
     gh_pr_id: number | null;
     number: number;
-    repo_full_name: string;
     url: string;
 }
 /**
@@ -12028,6 +12040,10 @@ interface Session1 {
      * How the session ended; null until it is terminal.
      */
     exit_status: SessionExitStatus | null;
+    /**
+     * What the session did to git, one entry per repository in its workspace: the commit and branch it sits on, per-file line counts for its uncommitted changes, and the pull requests it opened. Null if nothing was ever captured.
+     */
+    git: SessionGit | null;
     harness: Harness;
     /**
      * Unique identifier of the session.
@@ -12047,14 +12063,6 @@ interface Session1 {
     metadata: {
         [k: string]: string;
     };
-    /**
-     * Per-file line counts for the uncommitted changes in the session's workspace. Work the session committed is not included here — see output_prs. Null if no diff was ever captured.
-     */
-    output_diff: SessionDiff | null;
-    /**
-     * Pull requests the session created or updated.
-     */
-    output_prs: SessionPr[] | null;
     parent: SessionParent;
     /**
      * The per-session prompt the session was started with.
@@ -12187,4 +12195,4 @@ type ReviewRequester = components['schemas']['ReviewRequester'];
 type ReviewFinding = components['schemas']['ReviewFinding'];
 type Finding = ReviewFinding;
 
-export type { SessionResponse as $, AgentConfigSource as A, BudgetSource as B, ClaudeSessionRecord as C, DeltaFrame as D, ErrorFrame as E, Finding as F, GithubAccountSnippet as G, Harness as H, SdkUserRecord as I, SendSessionMessageRequest as J, Session as K, LifecycleSessionRecord as L, SessionExecution as M, SessionExecutionsListResponse as N, SessionExitStatus as O, ParentKind as P, SessionFrame as Q, RecordsAppendFrame as R, SdkAssistantRecord as S, SessionLiveness as T, SessionMessage as U, SessionMessageResponse as V, SessionMessageStatus as W, SessionPr as X, SessionPrompting as Y, SessionRecord as Z, SessionRecordsListResponse as _, AttributionType as a, SessionSource as a0, SessionState as a1, SessionStatus as a2, SessionStreamFrame as a3, SessionSurface as a4, SessionsListResponse as a5, SnapshotFrame as a6, StreamFrame as a7, TokensInfo as a8, paths as a9, CodexFileChangeItem as aa, CodexMcpToolCallItem as ab, CodexEvent as b, components as c, CodexItem as d, CodexSessionRecord as e, CreateReviewRequest as f, DoneFrame as g, GithubAccountType as h, HeartbeatFrame as i, PromptBlockedReason as j, ResolvedReviewScope as k, Review as l, ReviewConfiguration as m, ReviewCounters as n, ReviewFinding as o, ReviewRequester as p, ReviewScope as q, ReviewScopeKind as r, ReviewStage as s, ReviewedCommit as t, ReviewsListResponse as u, SdkContentBlock as v, SdkRateLimitRecord as w, SdkRecord as x, SdkResultRecord as y, SdkSystemRecord as z };
+export type { SessionResponse as $, AgentConfigSource as A, BudgetSource as B, ClaudeSessionRecord as C, DeltaFrame as D, ErrorFrame as E, Finding as F, GithubAccountSnippet as G, Harness as H, SdkUserRecord as I, SendSessionMessageRequest as J, Session as K, LifecycleSessionRecord as L, SessionExecution as M, SessionExecutionsListResponse as N, SessionExitStatus as O, ParentKind as P, SessionFrame as Q, RecordsAppendFrame as R, SdkAssistantRecord as S, SessionGit as T, SessionLiveness as U, SessionMessage as V, SessionMessageResponse as W, SessionMessageStatus as X, SessionPrompting as Y, SessionRecord as Z, SessionRecordsListResponse as _, AttributionType as a, SessionSource as a0, SessionState as a1, SessionStatus as a2, SessionStreamFrame as a3, SessionSurface as a4, SessionsListResponse as a5, SnapshotFrame as a6, StreamFrame as a7, TokensInfo as a8, paths as a9, CodexFileChangeItem as aa, CodexMcpToolCallItem as ab, CodexEvent as b, components as c, CodexItem as d, CodexSessionRecord as e, CreateReviewRequest as f, DoneFrame as g, GithubAccountType as h, HeartbeatFrame as i, PromptBlockedReason as j, ResolvedReviewScope as k, Review as l, ReviewConfiguration as m, ReviewCounters as n, ReviewFinding as o, ReviewRequester as p, ReviewScope as q, ReviewScopeKind as r, ReviewStage as s, ReviewedCommit as t, ReviewsListResponse as u, SdkContentBlock as v, SdkRateLimitRecord as w, SdkRecord as x, SdkResultRecord as y, SdkSystemRecord as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ellipsis-dev/sdk",
-  "version": "0.15.1",
+  "version": "0.16.0",
   "description": "TypeScript SDK for the Ellipsis agents platform: /v1 REST types + client, the session stream WebSocket client, and the session transcript store.",
   "license": "MIT",
   "type": "module",