@ellipsis-dev/sdk 0.1.0 → 0.2.1

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { A as AgentSessionWire, L as ListSessionRecordsResponse, a as ListSessionTurnsResponse, S as SessionMessageWire } from './types-BRE4NMnS.js';
-export { b as AgentSessionExitStatus, c as AgentSessionPr, d as AgentSessionSource, e as AgentSessionStatus, f as AgentTurn, g as AgentTurnStatus, h as AttributionType, B as BudgetSource, D as DefaultResolution, i as DeltaFrame, j as DoneFrame, E as ErrorFrame, G as GithubAccountSnippet, k as GithubAccountType, H as Harness, l as HeartbeatFrame, M as MessagesFrame, m as ModelTokensInfo, P as ParentKind, R as RecordsAppendFrame, n as SendSessionMessageRequest, o as SessionFrame, p as SessionLiveness, q as SessionMessageStatus, r as SessionRecordWire, s as SessionState, t as SessionStreamFrame, u as SessionSurface, v as SnapshotFrame, w as StreamFrame, T as TokensInfo, x as TurnTokensInfo, y as components, z as paths } from './types-BRE4NMnS.js';
+import { A as AgentSessionWire, L as ListSessionRecordsResponse, a as ListSessionTurnsResponse, b as ListSessionExecutionsResponse, S as SessionMessageWire } from './types-CtvSTnzA.js';
+export { c as AgentSessionExitStatus, d as AgentSessionPr, e as AgentSessionSource, f as AgentSessionStatus, g as AgentTurn, h as AgentTurnStatus, i as AttributionType, B as BudgetSource, D as DefaultResolution, j as DeltaFrame, k as DoneFrame, E as ErrorFrame, G as GithubAccountSnippet, l as GithubAccountType, H as Harness, m as HeartbeatFrame, M as ModelTokensInfo, P as ParentKind, R as RecordsAppendFrame, n as SendSessionMessageRequest, o as SessionExecutionWire, p as SessionFrame, q as SessionLiveness, r as SessionMessageStatus, s as SessionRecordWire, t as SessionState, u as SessionStreamFrame, v as SessionSurface, w as SnapshotFrame, x as StreamFrame, T as TokensInfo, y as TurnTokensInfo, z as components, C as paths } from './types-CtvSTnzA.js';
 
 type FetchJson = (path: string, init?: {
     method?: string;
@@ -14,9 +14,10 @@ declare class EllipsisClient {
         limit?: number;
     }): Promise<ListSessionRecordsResponse>;
     getSessionTurns(sessionId: string): Promise<ListSessionTurnsResponse>;
+    getSessionExecutions(sessionId: string): Promise<ListSessionExecutionsResponse>;
     sendSessionMessage(sessionId: string, message: string, options?: {
         idempotencyKey?: string;
     }): Promise<SessionMessageWire>;
 }
 
-export { AgentSessionWire, EllipsisClient, type FetchJson, ListSessionRecordsResponse, ListSessionTurnsResponse, SessionMessageWire };
+export { AgentSessionWire, EllipsisClient, type FetchJson, ListSessionExecutionsResponse, ListSessionRecordsResponse, ListSessionTurnsResponse, SessionMessageWire };

package/dist/index.js

@@ -30,6 +30,16 @@ var EllipsisClient = class {
       `/v1/sessions/${encodeURIComponent(sessionId)}/turns`
     );
   }
+  // The session's executions (initial start, cold wakes, infra retries) with
+  // their launch context: `system_prompt_append` is the text Ellipsis appends
+  // to Claude Code's default system prompt, alongside the initial query and
+  // model. Per execution because each cold wake persists its own launch
+  // config.
+  async getSessionExecutions(sessionId) {
+    return await this.fetchJson(
+      `/v1/sessions/${encodeURIComponent(sessionId)}/executions`
+    );
+  }
   // Send a message into the session's inbox (§4.2). Returns the created (or,
   // on an idempotent retry, the original) inbox row — clients key optimistic
   // echo chips on its id. `idempotencyKey` makes retries safe per

package/dist/store/index.d.ts

@@ -1,4 +1,4 @@
-import { r as SessionRecordWire, A as AgentSessionWire, S as SessionMessageWire, w as StreamFrame } from '../types-BRE4NMnS.js';
+import { s as SessionRecordWire, A as AgentSessionWire, S as SessionMessageWire, x as StreamFrame } from '../types-CtvSTnzA.js';
 
 interface ChatToolNode {
     key: string;
@@ -8,6 +8,8 @@ interface ChatToolNode {
     summary: string;
     result: string | null;
     isError: boolean;
+    startedAt: string | null;
+    completedAt: string | null;
 }
 type ChatNode = {
     key: string;
@@ -26,7 +28,9 @@ type ChatNode = {
     kind: 'lifecycle';
     text: string;
     recordType: string;
-    hook?: string;
+    step?: string;
+    lines?: string[];
+    payload?: Record<string, unknown>;
 } | ChatToolNode;
 interface ChatTurn {
     key: string;
@@ -41,8 +45,11 @@ interface ChatTurn {
 }
 declare function groupRecordsToChatTurns(records: readonly SessionRecordWire[]): ChatTurn[];
 
-declare function setupOutputHook(payload: Record<string, unknown>): string;
-declare function setupOutputLine(payload: Record<string, unknown>): string | null;
+declare function sandboxOutputStep(payload: Record<string, unknown>): string;
+declare function sandboxOutputLines(payload: Record<string, unknown>): string[];
+declare function sandboxOutputLine(payload: Record<string, unknown>): string | null;
+declare function cacheTierLabel(tier: unknown): string | null;
+declare function sandboxPhaseLabel(phase: unknown): string;
 declare function lifecycleText(recordType: string, payload: Record<string, unknown>): string | null;
 
 interface CCContentBlock {
@@ -132,6 +139,7 @@ declare class SessionTranscriptStore {
     private snapshot;
     private listeners;
     private acknowledged;
+    private inbox;
     private cursorSeq;
     private turnsFor;
     private turnsCache;
@@ -139,7 +147,9 @@ declare class SessionTranscriptStore {
     subscribe: (listener: () => void) => (() => void);
     getSnapshot: () => SessionTranscriptSnapshot;
     chatTurns: () => ChatTurn[];
+    private pendingMessages;
+    private applyMessageRecord;
     ingest: (rawFrame: StreamFrame) => void;
 }
 
-export { type CCContentBlock, type CCEvent, type ChatNode, type ChatToolNode, type ChatTurn, type EventToItemsOptions, type ItemKind, LineBuffer, type SessionTranscriptSnapshot, SessionTranscriptStore, StreamFrame, type TranscriptItem, clampLines, collapseToolRuns, emptySessionTranscriptSnapshot, eventToItems, foldCosts, formatDuration, groupRecordsToChatTurns, isConnectVisibleRecord, isConversationOver, lifecycleText, oneLine, parseEventLine, pendingToolCalls, recordToItems, resultCostUsd, setupOutputHook, setupOutputLine, statusActivityText, summarizeToolInput };
+export { type CCContentBlock, type CCEvent, type ChatNode, type ChatToolNode, type ChatTurn, type EventToItemsOptions, type ItemKind, LineBuffer, type SessionTranscriptSnapshot, SessionTranscriptStore, StreamFrame, type TranscriptItem, cacheTierLabel, clampLines, collapseToolRuns, emptySessionTranscriptSnapshot, eventToItems, foldCosts, formatDuration, groupRecordsToChatTurns, isConnectVisibleRecord, isConversationOver, lifecycleText, oneLine, parseEventLine, pendingToolCalls, recordToItems, resultCostUsd, sandboxOutputLine, sandboxOutputLines, sandboxOutputStep, sandboxPhaseLabel, statusActivityText, summarizeToolInput };

package/dist/store/index.js

@@ -1,11 +1,15 @@
 // src/store/lifecycle.ts
-function setupOutputHook(payload) {
-  return typeof payload.hook === "string" ? payload.hook : "setup";
+function sandboxOutputStep(payload) {
+  if (typeof payload.step === "string" && payload.step) return payload.step;
+  return typeof payload.phase === "string" ? payload.phase : "setup";
 }
-function setupOutputLine(payload) {
-  const lines = Array.isArray(payload.lines) ? payload.lines.filter(
+function sandboxOutputLines(payload) {
+  return Array.isArray(payload.lines) ? payload.lines.filter(
     (l) => typeof l === "string" && l.trim().length > 0
   ) : [];
+}
+function sandboxOutputLine(payload) {
+  const lines = sandboxOutputLines(payload);
   return lines.length ? lines[lines.length - 1].trim() : null;
 }
 function cacheTierLabel(tier) {
@@ -20,13 +24,71 @@ function cacheTierLabel(tier) {
       return null;
   }
 }
+function sandboxPhaseLabel(phase) {
+  switch (phase) {
+    case "image":
+      return "Preparing image";
+    case "clone":
+      return "Fetching repositories";
+    case "setup":
+      return "Running setup";
+    case "snapshot":
+      return "Snapshotting";
+    case "hooks":
+      return "Running hooks";
+    case "restore":
+      return "Restoring workspace";
+    default:
+      return typeof phase === "string" && phase ? phase.charAt(0).toUpperCase() + phase.slice(1) : "Working";
+  }
+}
+function durationLabel(ms) {
+  if (typeof ms !== "number" || !isFinite(ms) || ms < 0) return null;
+  return ms >= 1e3 ? `${(ms / 1e3).toFixed(1)}s` : `${Math.round(ms)}ms`;
+}
+function sandboxPhaseText(payload) {
+  const label = sandboxPhaseLabel(payload.phase);
+  const detail = payload.detail && typeof payload.detail === "object" ? payload.detail : {};
+  switch (payload.status) {
+    case "started":
+      return `${label}\u2026`;
+    case "completed": {
+      const parts = [label];
+      const tier = cacheTierLabel(detail.cache_tier);
+      if (tier) parts.push(tier);
+      const duration = durationLabel(payload.duration_ms);
+      if (duration) parts.push(duration);
+      return parts.join(" \xB7 ");
+    }
+    case "failed": {
+      const duration = durationLabel(payload.duration_ms);
+      return duration ? `${label} failed \xB7 ${duration}` : `${label} failed`;
+    }
+    default:
+      return label;
+  }
+}
 function lifecycleText(recordType, payload) {
   switch (recordType) {
+    case "session_scheduled": {
+      const config = typeof payload.config_name === "string" ? payload.config_name : null;
+      return config ? `Session scheduled \xB7 ${config}` : "Session scheduled";
+    }
+    case "session_starting": {
+      const attempt = typeof payload.attempt === "number" ? payload.attempt : 0;
+      if (attempt > 0) return "Retrying\u2026";
+      const wakeIndex = typeof payload.wake_index === "number" ? payload.wake_index : 0;
+      return wakeIndex > 0 ? "Waking the session\u2026" : "Session starting\u2026";
+    }
+    case "session_retrying":
+      return typeof payload.reason === "string" && payload.reason ? `Retrying \xB7 ${payload.reason}` : "Retrying after a transient error\u2026";
     case "sandbox_starting":
       return "Starting sandbox\u2026";
-    case "sandbox_setup_output": {
-      const last = setupOutputLine(payload);
-      return last ? `${setupOutputHook(payload)} \xB7 ${last}` : null;
+    case "sandbox_phase":
+      return sandboxPhaseText(payload);
+    case "sandbox_output": {
+      const last = sandboxOutputLine(payload);
+      return last ? `${sandboxOutputStep(payload)} \xB7 ${last}` : null;
     }
     case "sandbox_ready": {
       const repos = Array.isArray(payload.repositories) ? payload.repositories.filter(
@@ -40,8 +102,8 @@ function lifecycleText(recordType, payload) {
     }
     case "session_resumed":
       return "Resumed the conversation";
-    case "session_paused":
-      return "Sleeping \u2014 your next message wakes it";
+    case "session_idle":
+      return "Idle \u2014 your next message wakes it";
     case "session_closed":
       return "Conversation closed";
     case "session_cancelled": {
@@ -314,6 +376,12 @@ var TOOL_USE_BLOCK_TYPES = /* @__PURE__ */ new Set([
   "server_tool_use",
   "mcp_tool_use"
 ]);
+var SANDBOX_RECORD_TYPES = /* @__PURE__ */ new Set([
+  "sandbox_starting",
+  "sandbox_phase",
+  "sandbox_output",
+  "sandbox_ready"
+]);
 function toolResultText2(block) {
   const c = block.content;
   if (typeof c === "string") return c.trim();
@@ -331,6 +399,7 @@ function groupRecordsToChatTurns(records) {
   let seq = 0;
   const nextKey = (base) => `${base}:${seq++}`;
   let openIdx = -1;
+  let prevCumulativeCostUsd = 0;
   let initCount = 0;
   let pendingResume = false;
   const openAgentTurn = (record) => {
@@ -354,36 +423,64 @@ function groupRecordsToChatTurns(records) {
   for (const record of records) {
     if (record.source === "lifecycle") {
       const text = lifecycleText(record.record_type, record.payload);
-      if (text) {
-        const isSetupOutput = record.record_type === "sandbox_setup_output";
-        const hook = isSetupOutput ? setupOutputHook(record.payload) : void 0;
-        const prev = turns.length > 0 ? turns[turns.length - 1] : null;
-        const prevNode = prev?.nodes[0];
-        if (isSetupOutput && prev && prevNode && prevNode.kind === "lifecycle" && prevNode.hook === hook) {
-          prevNode.text = text;
-          prev.completedAt = record.created_at;
-          continue;
+      if (!text) continue;
+      const isSandbox = SANDBOX_RECORD_TYPES.has(record.record_type);
+      const isSandboxOutput = record.record_type === "sandbox_output";
+      const step = isSandboxOutput ? sandboxOutputStep(record.payload) : void 0;
+      const lines = isSandboxOutput ? sandboxOutputLines(record.payload) : void 0;
+      let foldTarget = null;
+      if (isSandbox && record.record_type !== "sandbox_starting") {
+        for (let i = turns.length - 1; i >= 0; i--) {
+          const candidate = turns[i];
+          if (candidate.role !== "lifecycle") break;
+          if (candidate.nodes.some(
+            (n) => n.kind === "lifecycle" && SANDBOX_RECORD_TYPES.has(n.recordType)
+          )) {
+            foldTarget = candidate;
+            break;
+          }
         }
-        turns.push({
-          key: nextKey(record.id),
-          role: "lifecycle",
-          nodes: [
-            {
-              key: nextKey(record.id),
-              kind: "lifecycle",
-              text,
-              recordType: record.record_type,
-              hook
-            }
-          ],
-          startedAt: record.created_at,
-          completedAt: record.created_at,
-          durationMs: null,
-          costUsd: null,
-          tokens: null,
-          resumed: false
-        });
       }
+      if (foldTarget) {
+        const last = foldTarget.nodes[foldTarget.nodes.length - 1];
+        if (isSandboxOutput && last && last.kind === "lifecycle" && last.recordType === "sandbox_output" && last.step === step) {
+          last.text = text;
+          last.lines = [...last.lines ?? [], ...lines ?? []];
+        } else {
+          foldTarget.nodes.push({
+            key: nextKey(record.id),
+            kind: "lifecycle",
+            text,
+            recordType: record.record_type,
+            step,
+            lines,
+            payload: record.payload
+          });
+        }
+        foldTarget.completedAt = record.created_at;
+        continue;
+      }
+      turns.push({
+        key: nextKey(record.id),
+        role: "lifecycle",
+        nodes: [
+          {
+            key: nextKey(record.id),
+            kind: "lifecycle",
+            text,
+            recordType: record.record_type,
+            step,
+            lines,
+            payload: record.payload
+          }
+        ],
+        startedAt: record.created_at,
+        completedAt: record.created_at,
+        durationMs: null,
+        costUsd: null,
+        tokens: null,
+        resumed: false
+      });
       continue;
     }
     if (record.source !== "claude_code") continue;
@@ -399,8 +496,13 @@ function groupRecordsToChatTurns(records) {
       if (openIdx >= 0) {
         turns[openIdx].completedAt = record.created_at;
         turns[openIdx].durationMs = typeof data.duration_ms === "number" ? data.duration_ms : null;
-        if (typeof data.total_cost_usd === "number")
-          turns[openIdx].costUsd = data.total_cost_usd;
+        if (typeof data.total_cost_usd === "number") {
+          turns[openIdx].costUsd = Math.max(
+            0,
+            data.total_cost_usd - prevCumulativeCostUsd
+          );
+          prevCumulativeCostUsd = data.total_cost_usd;
+        }
         openIdx = -1;
       }
       continue;
@@ -437,6 +539,7 @@ function groupRecordsToChatTurns(records) {
         if (node) {
           node.result = body;
           node.isError = !!block.is_error;
+          node.completedAt = record.created_at;
         } else {
           const orphan = {
             key: nextKey(record.id),
@@ -445,7 +548,9 @@ function groupRecordsToChatTurns(records) {
             input: null,
             summary: "",
             result: body,
-            isError: !!block.is_error
+            isError: !!block.is_error,
+            startedAt: null,
+            completedAt: record.created_at
           };
           openAgentTurn(record).nodes.push(orphan);
           if (useId != null) toolNodeByUseId.set(useId, orphan);
@@ -476,7 +581,9 @@ function groupRecordsToChatTurns(records) {
           input: block.input ?? null,
           summary: summarizeToolInput(name, block.input ?? void 0),
           result: null,
-          isError: false
+          isError: false,
+          startedAt: record.created_at,
+          completedAt: null
         };
         turn.nodes.push(node);
         if (block.id) toolNodeByUseId.set(block.id, node);
@@ -523,6 +630,11 @@ var SessionTranscriptStore = class {
   snapshot = EMPTY_SNAPSHOT;
   listeners = /* @__PURE__ */ new Set();
   acknowledged = /* @__PURE__ */ new Set();
+  // The inbox projection (protocol v3): message_received/delivered/requeued
+  // RECORDS drive it; the snapshot seeds the pending set at connect. Keyed by
+  // message id so a requeue can restore a message the delivered record
+  // removed from the pending view.
+  inbox = /* @__PURE__ */ new Map();
   // The resume cursor: the highest feed_seq received via records_append. Only
   // records advance it (§3.4) — never messages/session frames. streamSession
   // tracks its own copy; this one seeds a NEW streamSession call (e.g. a
@@ -551,6 +663,57 @@ var SessionTranscriptStore = class {
     }
     return this.turnsCache;
   };
+  // The current pending set, in feed order — what queued chips render.
+  pendingMessages = () => [...this.inbox.values()].filter((m) => m.status === "pending").sort((a, b) => (a.feed_seq ?? 0) - (b.feed_seq ?? 0));
+  // Fold one lifecycle record into the inbox projection; returns whether the
+  // pending view changed. Unknown fields/types are ignored (§3.6).
+  applyMessageRecord = (record) => {
+    const payload = record.payload;
+    const messageId = typeof payload.message_id === "string" ? payload.message_id : null;
+    switch (record.record_type) {
+      case "message_received": {
+        if (messageId == null || this.inbox.has(messageId)) return false;
+        this.inbox.set(messageId, {
+          id: messageId,
+          agent_session_id: record.agent_session_id,
+          feed_seq: record.feed_seq,
+          status: "pending",
+          body: typeof payload.body === "string" ? payload.body : "",
+          author: typeof payload.author === "string" ? payload.author : null,
+          sender_attribution_type: typeof payload.sender_attribution_type === "string" ? payload.sender_attribution_type : null,
+          sender_attribution_id: typeof payload.sender_attribution_id === "string" ? payload.sender_attribution_id : null,
+          created_at: record.created_at,
+          delivered_at: null,
+          delivered_turn_id: null
+        });
+        return true;
+      }
+      case "message_delivered": {
+        const existing = messageId != null ? this.inbox.get(messageId) : null;
+        if (!existing || existing.status !== "pending") return false;
+        this.inbox.set(messageId, {
+          ...existing,
+          status: "delivered",
+          delivered_at: record.created_at,
+          delivered_turn_id: typeof payload.turn_id === "string" ? payload.turn_id : null
+        });
+        return true;
+      }
+      case "message_requeued": {
+        const existing = messageId != null ? this.inbox.get(messageId) : null;
+        if (!existing || existing.status === "pending") return false;
+        this.inbox.set(messageId, {
+          ...existing,
+          status: "pending",
+          delivered_at: null,
+          delivered_turn_id: null
+        });
+        return true;
+      }
+      default:
+        return false;
+    }
+  };
   // Ingest one frame from the stream client. Unknown frame types stamp
   // liveness and change nothing else (§3.6).
   ingest = (rawFrame) => {
@@ -563,8 +726,11 @@ var SessionTranscriptStore = class {
     switch (frame.type) {
       case "snapshot": {
         next.session = frame.session;
-        next.messages = frame.messages;
-        for (const message of frame.messages) this.acknowledged.add(message.id);
+        for (const message of frame.messages) {
+          this.inbox.set(message.id, message);
+          this.acknowledged.add(message.id);
+        }
+        next.messages = this.pendingMessages();
         next.acknowledgedMessageIds = new Set(this.acknowledged);
         next.conversationOver = isConversationOver(frame.session);
         next.historyTruncated = frame.earliest_feed_seq != null && this.cursorSeq < frame.earliest_feed_seq - 1;
@@ -576,12 +742,24 @@ var SessionTranscriptStore = class {
         this.cursorSeq = fresh[fresh.length - 1].feed_seq;
         next.records = [...prev.records, ...fresh];
         let acknowledgedNew = false;
+        let inboxChanged = false;
         for (const record of fresh) {
           if (record.session_message_id != null) {
             this.acknowledged.add(record.session_message_id);
             acknowledgedNew = true;
           }
+          if (record.source === "lifecycle") {
+            inboxChanged = this.applyMessageRecord(record) || inboxChanged;
+            if (record.record_type === "message_received" || record.record_type === "message_delivered") {
+              const payload = record.payload;
+              if (typeof payload.message_id === "string") {
+                this.acknowledged.add(payload.message_id);
+                acknowledgedNew = true;
+              }
+            }
+          }
         }
+        if (inboxChanged) next.messages = this.pendingMessages();
         if (acknowledgedNew) {
           next.acknowledgedMessageIds = new Set(this.acknowledged);
         }
@@ -589,12 +767,6 @@ var SessionTranscriptStore = class {
         next.liveOutputTokens = null;
         break;
       }
-      case "messages": {
-        next.messages = frame.messages;
-        for (const message of frame.messages) this.acknowledged.add(message.id);
-        next.acknowledgedMessageIds = new Set(this.acknowledged);
-        break;
-      }
       case "session": {
         next.session = frame.session;
         next.conversationOver = isConversationOver(frame.session);
@@ -621,6 +793,7 @@ var SessionTranscriptStore = class {
 export {
   LineBuffer,
   SessionTranscriptStore,
+  cacheTierLabel,
   clampLines,
   collapseToolRuns,
   emptySessionTranscriptSnapshot,
@@ -636,8 +809,10 @@ export {
   pendingToolCalls,
   recordToItems,
   resultCostUsd,
-  setupOutputHook,
-  setupOutputLine,
+  sandboxOutputLine,
+  sandboxOutputLines,
+  sandboxOutputStep,
+  sandboxPhaseLabel,
   statusActivityText,
   summarizeToolInput
 };

package/dist/stream/index.d.ts

@@ -1,6 +1,6 @@
-import { w as StreamFrame, A as AgentSessionWire } from '../types-BRE4NMnS.js';
+import { x as StreamFrame, A as AgentSessionWire } from '../types-CtvSTnzA.js';
 
-declare const SESSION_STREAM_PROTOCOL_VERSION = 2;
+declare const SESSION_STREAM_PROTOCOL_VERSION = 3;
 declare const WS_CLOSE_NORMAL = 1000;
 declare const WS_CLOSE_GOING_AWAY = 1001;
 declare const WS_CLOSE_UNSUPPORTED_PROTOCOL_VERSION = 1002;

package/dist/stream/index.js

@@ -1,5 +1,5 @@
 // src/stream/index.ts
-var SESSION_STREAM_PROTOCOL_VERSION = 2;
+var SESSION_STREAM_PROTOCOL_VERSION = 3;
 var WS_CLOSE_NORMAL = 1e3;
 var WS_CLOSE_GOING_AWAY = 1001;
 var WS_CLOSE_UNSUPPORTED_PROTOCOL_VERSION = 1002;