@ellipsis-dev/sdk 0.20.0 → 0.22.0

package/dist/{types-D2YZTvgg.d.ts → types-BKAbWcLN.d.ts}

@@ -528,7 +528,7 @@ interface paths {
          * @description List the GitHub organization roster.
          *
          *     (Or the account itself for a personal workspace) — the universe of author_id values for
-         *     /sessions and /sessions/search.
+         *     /sessions.
          *
          *     Members carry their linked Slack identity when a Slack-GitHub
          *     link exists, and /slack/members carries the reverse link.
@@ -928,34 +928,6 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    '/v1/sessions/search': {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Search Agent Sessions
-         * @description Search sessions over steps, recaps, and pull requests.
-         *
-         *     Grouped by session, over everything a session left behind: step text, recap text, created
-         *     PRs, and recap-embedding similarity.
-         *
-         *     This is how an agent answers "did Tony look into X?": resolve
-         *     the author via /github/members, search, then read the winning
-         *     session via /sessions/{id} (recap) and /sessions/{id}/records
-         *     (transcript).
-         */
-        get: operations['search_sessions'];
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
     '/v1/sessions/{session_id}': {
         parameters: {
             query?: never;
@@ -983,33 +955,6 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    '/v1/sessions/{session_id}/executions': {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Get Agent Session Executions
-         * @description Return the session's executions and launch context.
-         *
-         *     Most notably system_prompt_append, the text Ellipsis appends to
-         *     Claude Code's default system prompt (platform section + response
-         *     instructions + the config's own instructions).
-         *
-         *     Per execution because each cold wake persists its own launch
-         *     config (a config edit between wakes changes it).
-         */
-        get: operations['get_agent_session_executions'];
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
     '/v1/sessions/{session_id}/export': {
         parameters: {
             query?: never;
@@ -1103,9 +1048,9 @@ interface paths {
          *
          *     Pagination is opt-in (cursor/limit); a bare call returns the
          *     full retained transcript. Available to sandbox tokens too: an
-         *     agent answering "did X look into Y?" needs to read the session
-         *     it found via /sessions/search, and any org member sees the same
-         *     transcript in the dashboard.
+         *     agent answering "did X look into Y?" needs to read the sessions
+         *     it finds, and any org member sees the same transcript in the
+         *     dashboard.
          */
         get: operations['get_agent_session_records'];
         put?: never;
@@ -3304,14 +3249,6 @@ interface components {
         ErrorResponse: {
             error: components['schemas']['ErrorInfo'];
         };
-        /**
-         * ExecutionStatus
-         * @description Per-execution status ladder (was AgentProcessStatus). Distinct from the
-         *     session's durable `session_state` and from `agent_sessions.status`, which
-         *     remains the atomic claim/dispatch guard.
-         * @enum {string}
-         */
-        ExecutionStatus: 'running' | 'failed' | 'done';
         /**
          * File
          * @description A file's metadata — the file itself is fetched via a separate
@@ -4797,68 +4734,6 @@ interface components {
              */
             user_login: string;
         };
-        /**
-         * RecordHit
-         * @description One session-log record matching a search query, denormalized with just
-         *     enough session context to render a result row and deep-link to the
-         *     session.
-         */
-        RecordHit: {
-            /**
-             * Attribution Id
-             * @description The actor the session is attributed to; the key into the response's attributed_users map for github_user attributions.
-             */
-            attribution_id?: string | null;
-            /** @description What kind of actor the session is attributed to. Only github_user attributions appear in the response's attributed_users map. */
-            attribution_type?: components['schemas']['AttributionType'] | null;
-            /**
-             * Config Id
-             * @description The agent config the session ran from, when it ran from a stored config.
-             */
-            config_id?: string | null;
-            /**
-             * Created At
-             * Format: date-time
-             * @description When the record was written.
-             */
-            created_at: string;
-            /**
-             * Execution Id
-             * @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;
-            /**
-             * Record Type
-             * @description The record's event type.
-             */
-            record_type: string;
-            /**
-             * Session Id
-             * @description The session the record belongs to.
-             */
-            session_id: string;
-            /** @description Where the matching session came from. */
-            session_source?: components['schemas']['SessionSource'] | null;
-            /** @description The matching session's status. */
-            session_status?: components['schemas']['SessionStatus'] | null;
-            /**
-             * Snippet
-             * @description A short window of the indexed text around the first match.
-             */
-            snippet: string;
-            /**
-             * Stream Seq
-             * @description The record's position within its execution's stream.
-             */
-            stream_seq: number;
-        };
         /**
          * RecordSource
          * @description `session_records.source` — the client render switch. `lifecycle` rows are
@@ -6200,8 +6075,8 @@ interface components {
             stopped?: components['schemas']['SessionStopped'];
             /** @description The latest live summary of the session's progress while it runs, and when it was generated. */
             summary?: components['schemas']['SessionSummary'] | null;
-            /** @description The public status projection; null on list/search responses, which do not derive it. */
-            surface?: components['schemas']['SessionSurface'] | null;
+            /** @description The public status projection: the durable conversation (`session`), the current execution (`run`), and the one derived `status` word. */
+            surface: components['schemas']['SessionSurface'];
             /** @description The tokens the session spent and the model they went to. `total` includes the prompt-cache lanes. */
             tokens?: components['schemas']['SessionTokens'];
             /**
@@ -6330,83 +6205,6 @@ interface components {
             /** @description How the environment was chosen (request, agent_config, repo_default, account_default, platform_default). Null when the config carried its own inline environment. */
             source?: components['schemas']['EnvironmentSource'] | null;
         };
-        /**
-         * SessionExecution
-         * @description One runtime attempt of a session — the initial start, a cold wake of a
-         *     durable conversation, or an infrastructure retry — including the launch
-         *     context the model was actually given.
-         */
-        SessionExecution: {
-            /**
-             * Attempt Index
-             * @description Infrastructure-retry counter within one wake.
-             */
-            attempt_index: number;
-            /**
-             * Created At
-             * Format: date-time
-             * @description When the execution was created.
-             */
-            created_at: string;
-            /**
-             * Execution Index
-             * @description Monotonic position of this execution within the session, across all starts, wakes, and retries.
-             */
-            execution_index: number;
-            /**
-             * Exit Status
-             * @description Finer terminal reason, mirroring the session's exit_status vocabulary; null until the execution is terminal.
-             */
-            exit_status?: string | null;
-            /**
-             * Id
-             * @description Unique identifier of the execution.
-             */
-            id: string;
-            /**
-             * Model
-             * @description The model the harness was launched with, when a launch config exists.
-             */
-            model?: string | null;
-            /**
-             * Query
-             * @description The initial query delivered to the harness, when the trigger carried one.
-             */
-            query?: string | null;
-            /**
-             * Resumed
-             * @description Whether this execution resumed a prior conversation (a cold wake with the previous state restored).
-             */
-            resumed: boolean;
-            /**
-             * Session Id
-             * @description Identifier of the session this execution belongs to.
-             */
-            session_id: string;
-            /** @description Execution status. */
-            status: components['schemas']['ExecutionStatus'];
-            /**
-             * System Prompt Append
-             * @description The system-prompt text Ellipsis appends to the harness's default system prompt (the platform section, run-type instructions, and the config's own instructions) — the platform-added portion, not the complete prompt the model saw. Null when no launch config was persisted (the execution failed before provisioning finished).
-             */
-            system_prompt_append?: string | null;
-            /**
-             * Wake Index
-             * @description 0 on the session's fresh start; increments once per cold wake of a durable conversation.
-             */
-            wake_index: number;
-        };
-        /**
-         * SessionExecutionsListResponse
-         * @description A session's executions with the launch context each was given.
-         */
-        SessionExecutionsListResponse: {
-            /**
-             * Executions
-             * @description The session's executions (initial start, cold wakes, infra retries), ordered by execution_index. Each carries the launch context the harness was given: system_prompt_append (the text appended to Claude Code's default system prompt), the initial query, and the model.
-             */
-            executions: components['schemas']['SessionExecution'][];
-        };
         /**
          * SessionExitStatus
          * @description Why a terminal agent session ended — a finer-grained reason than `status`.
@@ -6523,7 +6321,7 @@ interface components {
          * @description The durable conversation axis (backs the surfaced `session` field).
          * @enum {string}
          */
-        SessionLiveness: 'alive' | 'sleeping' | 'closed';
+        SessionLiveness: 'alive' | 'idle' | 'closed';
         /**
          * SessionLogSegment
          * @description One immutable archived segment of the session log: its feed_seq range
@@ -6710,61 +6508,6 @@ interface components {
             /** @description The session. */
             session: components['schemas']['Session'];
         };
-        /**
-         * SessionSearchResponse
-         * @description A page of session search results.
-         */
-        SessionSearchResponse: {
-            /**
-             * Attributed Users
-             * @description GitHub account snippets for the user attributions among the results, keyed by attribution_id, so callers can render author logins and avatars.
-             */
-            attributed_users: {
-                [key: string]: components['schemas']['GithubAccountSnippet'];
-            };
-            /**
-             * Results
-             * @description The matching sessions, newest first.
-             */
-            results: components['schemas']['SessionSearchResult'][];
-        };
-        /**
-         * SessionSearchResult
-         * @description One search hit: a session plus how and where the query matched it.
-         */
-        SessionSearchResult: {
-            /**
-             * Matched
-             * @description Which search arms matched this session: "records", "recap", "pr", and/or "similar".
-             */
-            matched: string[];
-            /**
-             * Recap Snippet
-             * @description A short window of the session's recap text around the first term match; null unless the recap arm matched.
-             */
-            recap_snippet?: string | null;
-            /**
-             * Record Hit Count
-             * @description Total record hits found for this session within the search window; may exceed the number of record_hits returned.
-             * @default 0
-             */
-            record_hit_count: number;
-            /**
-             * Record Hits
-             * @description Matching session-log entries, capped per session.
-             * @default []
-             */
-            record_hits: components['schemas']['RecordHit'][];
-            /** @description The matching session. */
-            session: components['schemas']['Session'];
-        };
-        /**
-         * SessionSearchScope
-         * @description What text a search query is matched against: the session log's record
-         *     text, the session recaps (summaries), or both.
-         * @enum {string}
-         */
-        SessionSearchScope: 'records' | 'recaps' | 'both';
         /**
          * SessionSource
          * @enum {string}
@@ -10182,9 +9925,9 @@ interface operations {
                 cursor?: string | null;
                 /** @description A GitHub account id (see GET /v1/integrations/github/members); scopes the list to sessions attributed to that developer. */
                 author_id?: number | null;
-                /** @description "owner/name" (exact) or a bare repo name, matched the same way as on GET /v1/sessions/search. Sessions whose repository is named only inside their agent config — dashboard starts, cron — do not match. */
+                /** @description "owner/name" (exact) or a bare repo name. Sessions whose repository is named only inside their agent config — dashboard starts, cron — do not match. */
                 repo?: string | null;
-                /** @description Keep only sessions whose conversation is still going — live or sleeping — dropping the ones that completed, errored, or were stopped or cancelled. A session parked between turns counts as unfinished. */
+                /** @description Keep only sessions whose conversation is still going — live or idle — dropping the ones that completed, errored, or were stopped or cancelled. A session parked between turns counts as unfinished. */
                 unfinished?: boolean;
             };
             header?: {
@@ -10304,79 +10047,6 @@ interface operations {
             };
         };
     };
-    search_sessions: {
-        parameters: {
-            query: {
-                q: string;
-                scope?: components['schemas']['SessionSearchScope'];
-                source?: components['schemas']['SessionSource'][] | null;
-                /** @description Attributed GitHub user account ids. */
-                author_id?: number[] | null;
-                /** @description Saved agent config ids (ORed with author_id). */
-                config_id?: string[] | null;
-                session_ids?: string[] | null;
-                /** @description "owner/name" (exact) or a bare repo name. */
-                repo?: string | null;
-                status?: components['schemas']['SessionStatus'][] | null;
-                start?: string | null;
-                end?: string | null;
-                limit?: number;
-            };
-            header?: {
-                'user-agent'?: string | null;
-            };
-            path?: never;
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description Successful Response */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    'application/json': components['schemas']['SessionSearchResponse'];
-                };
-            };
-            /** @description The search query is too short. */
-            400: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    'application/json': components['schemas']['ErrorResponse'];
-                };
-            };
-            /** @description The bearer token is missing, invalid, or revoked. */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    'application/json': components['schemas']['ErrorResponse'];
-                };
-            };
-            /** @description The credential may not perform this action, or the account is blocked. */
-            403: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    'application/json': components['schemas']['ErrorResponse'];
-                };
-            };
-            /** @description Validation Error */
-            422: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    'application/json': components['schemas']['HTTPValidationError'];
-                };
-            };
-        };
-    };
     get_agent_session: {
         parameters: {
             query?: never;
@@ -10437,66 +10107,6 @@ interface operations {
             };
         };
     };
-    get_agent_session_executions: {
-        parameters: {
-            query?: never;
-            header?: {
-                'user-agent'?: string | null;
-            };
-            path: {
-                session_id: string;
-            };
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description Successful Response */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    'application/json': components['schemas']['SessionExecutionsListResponse'];
-                };
-            };
-            /** @description The bearer token is missing, invalid, or revoked. */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    'application/json': components['schemas']['ErrorResponse'];
-                };
-            };
-            /** @description The credential may not perform this action, or the account is blocked. */
-            403: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    'application/json': components['schemas']['ErrorResponse'];
-                };
-            };
-            /** @description No such session in your account. */
-            404: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    'application/json': components['schemas']['ErrorResponse'];
-                };
-            };
-            /** @description Validation Error */
-            422: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    'application/json': components['schemas']['HTTPValidationError'];
-                };
-            };
-        };
-    };
     export_agent_session: {
         parameters: {
             query?: never;
@@ -11290,7 +10900,7 @@ type RunStatus = 'scheduled' | 'starting' | 'working' | 'waiting' | 'done' | 'fa
 /**
  * The durable conversation axis (backs the surfaced `session` field).
  */
-type SessionLiveness = 'alive' | 'sleeping' | 'closed';
+type SessionLiveness = 'alive' | 'idle' | 'closed';
 /**
  * The first frame after the stream connects: the session plus its open
  * inbox. Records always arrive separately via records_append frames.
@@ -11423,10 +11033,7 @@ interface Session {
      * The latest live summary of the session's progress while it runs, and when it was generated.
      */
     summary: SessionSummary | null;
-    /**
-     * The public status projection; null on list/search responses, which do not derive it.
-     */
-    surface: SessionSurface | null;
+    surface: SessionSurface;
     tokens: SessionTokens;
     /**
      * When the session was last updated.
@@ -12065,11 +11672,7 @@ interface SessionSummary {
     description: string;
 }
 /**
- * The three fields we expose.
- *
- * `use_enum_values=True` (from CustomBaseModel) stores the members as their
- * string values, so this serializes to `{"session": "alive", "run": "waiting",
- * "status": "waiting"}` — a plain object, not enum names.
+ * The public status projection: the durable conversation (`session`), the current execution (`run`), and the one derived `status` word.
  */
 interface SessionSurface {
     run: RunStatus | null;
@@ -12666,10 +12269,7 @@ interface Session1 {
      * The latest live summary of the session's progress while it runs, and when it was generated.
      */
     summary: SessionSummary | null;
-    /**
-     * The public status projection; null on list/search responses, which do not derive it.
-     */
-    surface: SessionSurface | null;
+    surface: SessionSurface;
     tokens: SessionTokens;
     /**
      * When the session was last updated.
@@ -12758,8 +12358,6 @@ type StreamFrame = SessionStreamFrame | {
 };
 type SendSessionMessageRequest = components['schemas']['SendSessionMessageRequest'];
 type SessionRecordsListResponse = components['schemas']['SessionRecordsListResponse'];
-type SessionExecutionsListResponse = components['schemas']['SessionExecutionsListResponse'];
-type SessionExecution = components['schemas']['SessionExecution'];
 type SessionResponse = components['schemas']['SessionResponse'];
 type SessionMessageResponse = components['schemas']['SessionMessageResponse'];
 type SessionsListResponse = components['schemas']['SessionsListResponse'];
@@ -12777,4 +12375,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, 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 };
+export type { SessionState 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, SessionExitStatus as M, SessionFrame as N, SessionGit as O, ParentKind as P, SessionLiveness as Q, RecordsAppendFrame as R, SdkAssistantRecord as S, SessionMessage as T, SessionMessageResponse as U, SessionMessageStatus as V, SessionPrompting as W, SessionRecord as X, SessionRecordsListResponse as Y, SessionResponse as Z, SessionSource as _, AttributionType as a, SessionStatus as a0, SessionStreamFrame as a1, SessionSurface as a2, SessionsListResponse as a3, SnapshotFrame as a4, StreamFrame as a5, TokensInfo as a6, paths as a7, CodexFileChangeItem as a8, CodexMcpToolCallItem as a9, 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.20.0",
+  "version": "0.22.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",

package/schema/frames.schema.json

@@ -4263,16 +4263,8 @@
           "description": "The latest live summary of the session's progress while it runs, and when it was generated."
         },
         "surface": {
-          "anyOf": [
-            {
-              "$ref": "#/$defs/SessionSurface"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "The public status projection; null on list/search responses, which do not derive it."
+          "$ref": "#/$defs/SessionSurface",
+          "description": "The public status projection: the durable conversation (`session`), the current execution (`run`), and the one derived `status` word."
         },
         "tokens": {
           "$ref": "#/$defs/SessionTokens",
@@ -4769,7 +4761,7 @@
       "description": "The durable conversation axis (backs the surfaced `session` field).",
       "enum": [
         "alive",
-        "sleeping",
+        "idle",
         "closed"
       ],
       "title": "SessionLiveness",