@ellipsis-dev/sdk 0.19.0 → 0.20.0

package/dist/store/index.d.ts

@@ -82,13 +82,6 @@ declare function deriveSandboxState(records: readonly RecordSlice[], minFeedSeq:
 declare function sandboxSummary(sandbox: SandboxState | null): string;
 declare function lastLines(log: readonly SandboxLogLine[], max: number): SandboxLogLine[];
 
-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;
-
 type ItemKind = 'assistant' | 'thinking' | 'tool' | 'tool_result' | 'summary' | 'system' | 'user' | 'notice' | 'error';
 interface TranscriptItem {
     key: string;
@@ -129,6 +122,34 @@ declare function foldCosts(events: SdkRecord[]): {
 };
 declare function statusActivityText(status: string): string | null;
 
+declare const LIVE_GLYPH = "\u23FA";
+declare const USER_BAR = "\u2503";
+declare const BRANCH_GLYPH = "\u23BF";
+declare function gutterFor(item: TranscriptItem): string;
+declare function chatTurnsToItems(turns: readonly ChatTurn[]): TranscriptItem[];
+declare function isToolFold(item: TranscriptItem): boolean;
+declare function isToolActivity(item: TranscriptItem): boolean;
+declare function isAgentSpeech(item: TranscriptItem): boolean;
+type PlacedItem = {
+    item: TranscriptItem;
+    nested: boolean;
+    attach: boolean;
+};
+declare function layOutItems(items: readonly TranscriptItem[]): PlacedItem[];
+declare function foldGutter(nested: boolean): string;
+declare function tailLines(text: string, maxLines: number): {
+    body: string;
+    hidden: number;
+};
+declare function toolRunMembers(items: readonly TranscriptItem[]): Map<string, TranscriptItem[]>;
+
+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;
+
 declare function isConversationOver(session: Session): boolean;
 interface SessionTranscriptSnapshot {
     session: Session | null;
@@ -165,4 +186,4 @@ declare class SessionTranscriptStore {
     ingest: (rawFrame: StreamFrame) => void;
 }
 
-export { type ChatNode, type ChatToolNode, type ChatTurn, type EventToItemsOptions, type ItemKind, type RecordSlice, type SandboxLogKind, type SandboxLogLine, type SandboxState, type SessionTranscriptSnapshot, SessionTranscriptStore, StreamFrame, type TranscriptItem, awaitingAgentPhase, cacheTierLabel, clampLines, codexChangedPaths, codexEventToItems, codexMcpToolName, collapseToolRuns, deliveredUnechoedSends, deriveSandboxState, emptySessionTranscriptSnapshot, eventToItems, foldCosts, formatDuration, groupRecordsToChatTurns, hookPhrase, humanDuration, isConnectVisibleRecord, isConversationOver, lastLines, lifecycleText, oneLine, pendingToolCalls, recordSlice, recordToItems, resultCostUsd, sandboxOutputLine, sandboxOutputLines, sandboxOutputStep, sandboxPhaseLabel, sandboxSummary, seedTranscriptStore, sessionLogText, statusActivityText, summarizeToolInput, toolResultText };
+export { BRANCH_GLYPH, type ChatNode, type ChatToolNode, type ChatTurn, type EventToItemsOptions, type ItemKind, LIVE_GLYPH, type PlacedItem, type RecordSlice, type SandboxLogKind, type SandboxLogLine, type SandboxState, type SessionTranscriptSnapshot, SessionTranscriptStore, StreamFrame, type TranscriptItem, USER_BAR, awaitingAgentPhase, cacheTierLabel, chatTurnsToItems, clampLines, codexChangedPaths, codexEventToItems, codexMcpToolName, collapseToolRuns, deliveredUnechoedSends, deriveSandboxState, emptySessionTranscriptSnapshot, eventToItems, foldCosts, foldGutter, formatDuration, groupRecordsToChatTurns, gutterFor, hookPhrase, humanDuration, isAgentSpeech, isConnectVisibleRecord, isConversationOver, isToolActivity, isToolFold, lastLines, layOutItems, lifecycleText, oneLine, pendingToolCalls, recordSlice, recordToItems, resultCostUsd, sandboxOutputLine, sandboxOutputLines, sandboxOutputStep, sandboxPhaseLabel, sandboxSummary, seedTranscriptStore, sessionLogText, statusActivityText, summarizeToolInput, tailLines, toolResultText, toolRunMembers };

package/dist/store/index.js

@@ -1062,6 +1062,156 @@ function lastLines(log, max) {
   return log.length <= max ? [...log] : log.slice(log.length - max);
 }
 
+// src/store/layout.ts
+var LIVE_GLYPH = "\u23FA";
+var USER_BAR = "\u2503";
+var BRANCH_GLYPH = "\u23BF";
+function gutterFor(item) {
+  if (item.kind === "user") return USER_BAR;
+  if (item.kind === "assistant") return "\u25CF";
+  if (item.kind === "system" || item.kind === "notice") return "\u2726";
+  return item.gutter ?? "";
+}
+var SANDBOX_RECORD_TYPES2 = /* @__PURE__ */ new Set([
+  "sandbox_starting",
+  "sandbox_phase",
+  "sandbox_output",
+  "sandbox_ready"
+]);
+function chatTurnsToItems(turns) {
+  const items = [];
+  let wakeAt = -1;
+  for (const turn of turns) {
+    if (turn.role === "lifecycle") {
+      for (const node of turn.nodes) {
+        if (node.kind !== "lifecycle") continue;
+        if (SANDBOX_RECORD_TYPES2.has(node.recordType)) continue;
+        if (node.recordType === "session_resumed" && wakeAt >= 0) {
+          items[wakeAt] = { ...items[wakeAt], text: "Session awake" };
+          wakeAt = -1;
+          continue;
+        }
+        const text = sessionLogText(node.recordType, node.payload ?? {});
+        if (!text) continue;
+        items.push({ key: node.key, kind: "notice", text, spaceBefore: true });
+        wakeAt = text === "Waking the session\u2026" ? items.length - 1 : -1;
+      }
+      continue;
+    }
+    if (turn.role === "user") {
+      for (const node of turn.nodes) {
+        if (node.kind === "user") {
+          items.push({
+            key: node.key,
+            kind: "user",
+            text: node.text,
+            spaceBefore: true
+          });
+        }
+      }
+      continue;
+    }
+    for (const node of turn.nodes) {
+      if (node.kind === "assistant") {
+        items.push({
+          key: node.key,
+          kind: "assistant",
+          text: node.text,
+          spaceBefore: true
+        });
+      } else if (node.kind === "thinking") {
+        items.push({
+          key: node.key,
+          kind: "thinking",
+          gutter: "\u273B",
+          text: node.text,
+          spaceBefore: true
+        });
+      } else if (node.kind === "tool") {
+        const orphan = node.name === "tool" && node.input === null && node.startedAt === null;
+        if (!orphan) {
+          items.push({
+            key: node.key,
+            kind: "tool",
+            gutter: "\u25CF",
+            text: node.name,
+            detail: node.summary ? `(${node.summary})` : void 0,
+            spaceBefore: true,
+            tool: { name: node.name, input: node.input ?? void 0 }
+          });
+        }
+        if (node.result !== null) {
+          items.push({
+            key: `${node.key}:r`,
+            kind: "tool_result",
+            gutter: BRANCH_GLYPH,
+            text: node.result || "(no output)",
+            spaceBefore: false,
+            isError: node.isError || void 0
+          });
+        }
+      }
+    }
+    if (turn.isError) {
+      items.push({
+        key: `${turn.key}:err`,
+        kind: "summary",
+        text: "turn ended with an error",
+        spaceBefore: true,
+        isError: true
+      });
+    }
+  }
+  return items;
+}
+function isToolFold(item) {
+  return item.key.startsWith("grp:");
+}
+function isToolActivity(item) {
+  return item.kind === "tool" || item.kind === "tool_result" || isToolFold(item);
+}
+function isAgentSpeech(item) {
+  return item.kind === "assistant" || item.kind === "thinking";
+}
+function layOutItems(items) {
+  const out = [];
+  let nestUnder = false;
+  for (const item of items) {
+    if (!isToolActivity(item)) {
+      out.push({ item, nested: false, attach: false });
+      nestUnder = isAgentSpeech(item);
+      continue;
+    }
+    out.push({ item, nested: nestUnder, attach: nestUnder });
+  }
+  return out;
+}
+function foldGutter(nested) {
+  return nested ? BRANCH_GLYPH : "\u25CF";
+}
+function tailLines(text, maxLines) {
+  const lines = text.split("\n");
+  if (lines.length <= maxLines) return { body: text, hidden: 0 };
+  return {
+    body: lines.slice(lines.length - maxLines).join("\n"),
+    hidden: lines.length - maxLines
+  };
+}
+function toolRunMembers(items) {
+  const out = /* @__PURE__ */ new Map();
+  let group = [];
+  const flush = () => {
+    if (group.length > 0) out.set(`grp:${group[0].key}`, group);
+    group = [];
+  };
+  for (const item of items) {
+    if (item.kind === "tool" || item.kind === "tool_result") group.push(item);
+    else flush();
+  }
+  flush();
+  return out;
+}
+
 // src/store/index.ts
 var TERMINAL_SESSION_STATUSES = /* @__PURE__ */ new Set([
   "completed",
@@ -1266,9 +1416,13 @@ var SessionTranscriptStore = class {
   };
 };
 export {
+  BRANCH_GLYPH,
+  LIVE_GLYPH,
   SessionTranscriptStore,
+  USER_BAR,
   awaitingAgentPhase,
   cacheTierLabel,
+  chatTurnsToItems,
   clampLines,
   codexChangedPaths,
   codexEventToItems,
@@ -1279,13 +1433,19 @@ export {
   emptySessionTranscriptSnapshot,
   eventToItems,
   foldCosts,
+  foldGutter,
   formatDuration,
   groupRecordsToChatTurns,
+  gutterFor,
   hookPhrase,
   humanDuration,
+  isAgentSpeech,
   isConnectVisibleRecord,
   isConversationOver,
+  isToolActivity,
+  isToolFold,
   lastLines,
+  layOutItems,
   lifecycleText,
   oneLine,
   pendingToolCalls,
@@ -1301,5 +1461,7 @@ export {
   sessionLogText,
   statusActivityText,
   summarizeToolInput,
-  toolResultText
+  tailLines,
+  toolResultText,
+  toolRunMembers
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ellipsis-dev/sdk",
-  "version": "0.19.0",
+  "version": "0.20.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",