@ellipsis-dev/sdk 0.28.0 → 0.31.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, turn outcome and closing notices kept visible.
+`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 `Preparing environment` 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-YJC53TA7.js → chunk-G2AEYZW2.js}

@@ -1,5 +1,5 @@
 // src/stream/index.ts
-var SESSION_STREAM_PROTOCOL_VERSION = 4;
+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.turn?.status ?? "none";
 }
 var StreamUnavailableError = class extends Error {
   constructor(message) {
@@ -136,7 +136,7 @@ async function streamSession(opts) {
   let everReceivedFrame = false;
   let attempt = 0;
   let lastStatusWord = "";
-  let lastExitStatus = null;
+  let lastReason = null;
   const emit = (frame) => {
     everReceivedFrame = true;
     attempt = 0;
@@ -150,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;
+      lastReason = session.turn?.reason ?? null;
     }
     opts.onFrame(frame);
   };
@@ -171,11 +171,7 @@ async function streamSession(opts) {
       };
     }
     if (res.kind === "done") {
-      return {
-        type: "done",
-        status: lastStatusWord,
-        exitStatus: lastExitStatus
-      };
+      return { type: "done", status: lastStatusWord, reason: lastReason };
     }
     if (res.kind === "frameError")
       return { type: "error", message: res.message };