@ellipsis-dev/sdk 0.27.0 → 0.30.0

package/README.md

@@ -38,3 +38,28 @@ contract) is documented at https://www.ellipsis.dev/docs. The compatibility
 rule clients must follow: **ignore unknown frame types and unknown
 `source`/`record_type`/`kind` values** — additive server changes are not a
 protocol break.
+
+## Shared chat work sections
+
+Web and CLI renderers can use `splitLedger(groupRecordsToChatTurns(records))`
+and `entryBody(entry, { live, now, liveText, liveSummary })` from `@ellipsis-dev/sdk/store`.
+`now` is epoch milliseconds. The returned `items` are the collapsed view:
+one `isWorkFold(item)` section for progress, thinking and tools, with final
+replies, sleep and cancellation notices kept visible. Wake milestones stay
+inside the work section. `members.get(item.key)` contains
+that section's rows; nested tool folds use the same map and `isToolFold`.
+Renderers own expansion state and can recursively display the members.
+
+The work key stays stable as records stream in and after replay. The live
+label advances from `Waking session` to `Starting agent` to `Working` as
+the platform and native turn events arrive. While the agent works, the heading
+from `store.getSnapshot().liveSummary` replaces `Working` when available.
+Pass the summary only to the entry being answered (`loading: true`, add a loading
+indicator in the renderer). The returned `seconds` uses platform turn start
+and completion timestamps, even before the first content item arrives. It is
+null before a turn starts; omit the clock then. `entry.progress.phase` identifies
+each message's activity independently of the latest message or session status.
+The settled label is `Worked for 4m 43s`. Only the work header is loading; partial
+text stays inside it. Codex message phases identify final answers; for records
+without phases, the final message of a settled turn stays outside the fold.
+No DOM, React, or terminal dependencies are required.

package/dist/{chunk-RMPAMUAE.js → chunk-K252XHLI.js}

@@ -1,5 +1,5 @@
 // src/stream/index.ts
-var SESSION_STREAM_PROTOCOL_VERSION = 3;
+var SESSION_STREAM_PROTOCOL_VERSION = 6;
 var WS_CLOSE_NORMAL = 1e3;
 var WS_CLOSE_GOING_AWAY = 1001;
 var WS_CLOSE_UNSUPPORTED_PROTOCOL_VERSION = 1002;
@@ -8,7 +8,7 @@ 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;
+  return session.lifecycle.status;
 }
 var StreamUnavailableError = class extends Error {
   constructor(message) {
@@ -93,6 +93,16 @@ function connectOnce(sock, emit, signal) {
       } catch {
         return;
       }
+      if (!frame || ![
+        "snapshot",
+        "records_append",
+        "session",
+        "delta",
+        "heartbeat",
+        "done",
+        "error"
+      ].includes(frame.type))
+        return;
       emit(frame);
       if (frame.type === "done") {
         finish({ kind: "done" });
@@ -140,7 +150,7 @@ async function streamSession(opts) {
     } else if (frame.type === "snapshot" || frame.type === "session") {
       const session = frame.session;
       lastStatusWord = sessionStatusWord(session);
-      lastExitStatus = session.exit_status ?? null;
+      lastExitStatus = session.lifecycle.last_execution_result?.completion_reason ?? null;
     }
     opts.onFrame(frame);
   };