@ellipsis-dev/sdk 0.35.0 → 0.37.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { c as components } from './types-BrLpRRde.js';
-export { A as AgentConfig, a as AgentIdentity, b as AttributionType, B as BudgetConfig, C as CheckRunAction, d as CheckSuiteAction, e as ClaudeAssistantEvent, f as ClaudeAssistantMessage, g as ClaudeConfig, h as ClaudeConversationResetEvent, i as ClaudeNativeEvent, j as ClaudeNativeSessionRecord, k as ClaudeNativeUsage, l as ClaudeRateLimitEvent, m as ClaudeRateLimitInfo, n as ClaudeResultEvent, o as ClaudeSessionRecord, p as ClaudeSystemEvent, q as ClaudeUserEvent, r as ClaudeUserMessage, s as CodexAgentMessage, t as CodexAgentMessageItem, u as CodexAppServerError, v as CodexAppServerEvent, w as CodexAppServerItem, x as CodexAppServerNotification, y as CodexAppServerSessionRecord, z as CodexCommandExecution, D as CodexCommandExecutionItem, E as CodexConfig, F as CodexContextCompaction, G as CodexEffortLevel, H as CodexErrorEvent, I as CodexErrorItem, J as CodexErrorParams, K as CodexEvent, L as CodexFileChange, M as CodexFileChangeItem, N as CodexFileUpdate, O as CodexItem, P as CodexItemCompleted, Q as CodexItemCompletedEvent, R as CodexItemParams, S as CodexItemStarted, T as CodexItemStartedEvent, U as CodexItemUpdatedEvent, V as CodexLocalImageInput, W as CodexMcpToolCall, X as CodexMcpToolCallAppContext, Y as CodexMcpToolCallError, Z as CodexMcpToolCallItem, _ as CodexMcpToolCallResult, $ as CodexPlan, a0 as CodexReasoning, a1 as CodexReasoningItem, a2 as CodexSessionRecord, a3 as CodexTextInput, a4 as CodexThread, a5 as CodexThreadStarted, a6 as CodexThreadStartedEvent, a7 as CodexThreadStartedParams, a8 as CodexThreadTokenUsage, a9 as CodexTodoListItem, aa as CodexTokenUsageBreakdown, ab as CodexTokenUsageParams, ac as CodexTokenUsageUpdated, ad as CodexTurn, ae as CodexTurnCompleted, af as CodexTurnCompletedEvent, ag as CodexTurnError, ah as CodexTurnFailedEvent, ai as CodexTurnParams, aj as CodexTurnStarted, ak as CodexTurnStartedEvent, al as CodexUsage, am as CodexUserInput, an as CodexUserMessage, ao as CodexWebSearch, ap as CodexWebSearchItem, aq as ComputeConfig, ar as ComputeConfig1, as as ConfigMetadata, at as Cost, au as Cost1, av as CronTrigger, aw as DeltaFrame, ax as DoneFrame, ay as Duration, az as EffortLevel, aA as EllipsisGrant, aB as EllipsisPermissions, aC as EnvironmentBaseBuild, aD as EnvironmentConfig, aE as EnvironmentHooks, aF as EnvironmentHooks1, aG as EnvironmentOutputPayload, aH as EnvironmentOutputRecord, aI as EnvironmentPhasePayload, aJ as EnvironmentPhaseRecord, aK as EnvironmentReadyPayload, aL as EnvironmentReadyRecord, aM as EnvironmentScript, aN as EnvironmentSource, aO as EnvironmentVariable, aP as ErrorFrame, aQ as GeminiConfig, aR as GeminiErrorEvent, aS as GeminiInitEvent, aT as GeminiMessageEvent, aU as GeminiModelStats, aV as GeminiResultEvent, aW as GeminiSessionRecord, aX as GeminiStreamEvent, aY as GeminiStreamStats, aZ as GeminiToolError, a_ as GeminiToolResultEvent, a$ as GeminiToolUseEvent, b0 as GithubAccountFilter, b1 as GithubAccountSelector, b2 as GithubAccountSnippet, b3 as GithubAccountType, b4 as GithubCheckRunEvent, b5 as GithubCheckSuiteEvent, b6 as GithubIssueEvent, b7 as GithubPermissions, b8 as GithubPullRequestEvent, b9 as GithubPushEvent, ba as GithubReleaseEvent, bb as GithubStatusEvent, bc as GithubWorkflowRunEvent, bd as HandlerService, be as HeartbeatFrame, bf as InputContract, bg as IssueAction, bh as LegacyAssistantPayload, bi as LegacyNativeUsage, bj as LegacyResultPayload, bk as Level, bl as LifecycleSessionRecord, bm as LinearIssueAction, bn as LinearIssueEvent, bo as LlmCost, bp as LlmCostSplit, bq as McpRemoteServer, br as McpServerRef, bs as McpStdioServer, bt as MemorySize, bu as MessageDeliveredPayload, bv as MessageDeliveredRecord, bw as MessageReceivedPayload, bx as MessageReceivedRecord, by as MessageRequeuedPayload, bz as MessageRequeuedRecord, bA as ModelLlmCostSplit, bB as ModelTokenCounts, bC as OutputConfig, bD as PermissionsConfig, bE as PermissionsConfig1, bF as PlatformSessionRecord, bG as PromptBlockedReason, bH as PullRequestAction, bI as ReactCheckRun, bJ as ReactCheckSuite, bK as ReactIssue, bL as ReactLinearIssue, bM as ReactPullRequest, bN as ReactPush, bO as ReactRelease, bP as ReactSentry, bQ as ReactSlackChannel, bR as ReactStatus, bS as ReactTrigger, bT as ReactWorkflowRun, bU as RecordsAppendFrame, bV as ReleaseAction, bW as RepositoryFilter, bX as RepositoryRef, bY as Review, bZ as ReviewComment, b_ as ReviewConfig, b$ as ReviewConfigsListResponse, c0 as ReviewPullRequest, c1 as ReviewPullRequestAuthor, c2 as ReviewReviewer, c3 as ReviewSummary, c4 as ReviewsListResponse, c5 as SdkAssistantRecord, c6 as SdkCacheCreation, c7 as SdkContentBlock, c8 as SdkRateLimitRecord, c9 as SdkRecord, ca as SdkResultRecord, cb as SdkServerToolResultBlock, cc as SdkServerToolUseBlock, cd as SdkSystemRecord, ce as SdkTextBlock, cf as SdkThinkingBlock, cg as SdkToolResultBlock, ch as SdkToolUseBlock, ci as SdkUserRecord, cj as SendSessionMessageRequest, ck as SentryAction, cl as SentryAlertEvent, cm as Session, cn as Session1, co as SessionAgent, cp as SessionArchived, cq as SessionAttribution, cr as SessionClosedPayload, cs as SessionClosedRecord, ct as SessionConfig, cu as SessionConversation, cv as SessionConversationConfig, cw as SessionEnvironment, cx as SessionEventActor, cy as SessionFrame, cz as SessionGit, cA as SessionGitCommit, cB as SessionGitFile, cC as SessionGitPr, cD as SessionGitRepo, cE as SessionHandler, cF as SessionMessage, cG as SessionMessageImage, cH as SessionMessageResponse, cI as SessionMessageStatus, cJ as SessionOutput, cK as SessionParent, cL as SessionPrompting, cM as SessionRecord, cN as SessionRecordsListResponse, cO as SessionResponse, cP as SessionSource, cQ as SessionState, cR as SessionStopped, cS as SessionStreamFrame, cT as SessionSummary, cU as SessionTurn, cV as SessionTurnResponse, cW as SessionTurnsListResponse, cX as SessionsListResponse, cY as SettingsRef, cZ as SkillRef, c_ as SlackChannelCreatedEvent, c$ as SlackMessageEvent, d0 as SnapshotFrame, d1 as StatusAction, d2 as StreamFrame, d3 as TokenCounts, d4 as Tokens, d5 as Tokens1, d6 as TokensInfo, d7 as TurnEndedPayload, d8 as TurnEndedRecord, d9 as TurnQueuedPayload, da as TurnQueuedRecord, db as TurnReason, dc as TurnStartedPayload, dd as TurnStartedRecord, de as TurnStatus, df as UnknownSessionRecord, dg as UpdateSessionRequest, dh as WorkflowRunAction, di as paths } from './types-BrLpRRde.js';
+import { c as components } from './types-BXbnHOQe.js';
+export { A as AgentConfig, a as AgentIdentity, b as AttributionType, B as BudgetConfig, C as CheckRunAction, d as CheckSuiteAction, e as ClaudeAssistantEvent, f as ClaudeAssistantMessage, g as ClaudeConfig, h as ClaudeConversationResetEvent, i as ClaudeNativeEvent, j as ClaudeNativeSessionRecord, k as ClaudeNativeUsage, l as ClaudeRateLimitEvent, m as ClaudeRateLimitInfo, n as ClaudeResultEvent, o as ClaudeSessionRecord, p as ClaudeSystemEvent, q as ClaudeUserEvent, r as ClaudeUserMessage, s as CodexAgentMessage, t as CodexAgentMessageItem, u as CodexAppServerError, v as CodexAppServerEvent, w as CodexAppServerItem, x as CodexAppServerNotification, y as CodexAppServerSessionRecord, z as CodexCollabAgentToolCall, D as CodexCommandExecution, E as CodexCommandExecutionItem, F as CodexConfig, G as CodexContextCompaction, H as CodexEffortLevel, I as CodexErrorEvent, J as CodexErrorItem, K as CodexErrorParams, L as CodexEvent, M as CodexFileChange, N as CodexFileChangeItem, O as CodexFileUpdate, P as CodexItem, Q as CodexItemCompleted, R as CodexItemCompletedEvent, S as CodexItemParams, T as CodexItemStarted, U as CodexItemStartedEvent, V as CodexItemUpdatedEvent, W as CodexLocalImageInput, X as CodexMcpToolCall, Y as CodexMcpToolCallAppContext, Z as CodexMcpToolCallError, _ as CodexMcpToolCallItem, $ as CodexMcpToolCallResult, a0 as CodexPlan, a1 as CodexReasoning, a2 as CodexReasoningItem, a3 as CodexSessionRecord, a4 as CodexSubAgentActivity, a5 as CodexTextInput, a6 as CodexThread, a7 as CodexThreadStarted, a8 as CodexThreadStartedEvent, a9 as CodexThreadStartedParams, aa as CodexThreadTokenUsage, ab as CodexTodoListItem, ac as CodexTokenUsageBreakdown, ad as CodexTokenUsageParams, ae as CodexTokenUsageUpdated, af as CodexTurn, ag as CodexTurnCompleted, ah as CodexTurnCompletedEvent, ai as CodexTurnError, aj as CodexTurnFailedEvent, ak as CodexTurnParams, al as CodexTurnStarted, am as CodexTurnStartedEvent, an as CodexUsage, ao as CodexUserInput, ap as CodexUserMessage, aq as CodexWebSearch, ar as CodexWebSearchItem, as as ComputeConfig, at as ComputeConfig1, au as ConfigMetadata, av as Cost, aw as Cost1, ax as CronTrigger, ay as DeltaFrame, az as Duration, aA as EffortLevel, aB as EllipsisGrant, aC as EllipsisPermissions, aD as EnvironmentBaseBuild, aE as EnvironmentConfig, aF as EnvironmentHooks, aG as EnvironmentHooks1, aH as EnvironmentOutputPayload, aI as EnvironmentOutputRecord, aJ as EnvironmentPhasePayload, aK as EnvironmentPhaseRecord, aL as EnvironmentReadyPayload, aM as EnvironmentReadyRecord, aN as EnvironmentScript, aO as EnvironmentSource, aP as EnvironmentVariable, aQ as ErrorFrame, aR as ErrorReason, aS as GeminiConfig, aT as GeminiErrorEvent, aU as GeminiInitEvent, aV as GeminiMessageEvent, aW as GeminiModelStats, aX as GeminiResultEvent, aY as GeminiSessionRecord, aZ as GeminiStreamEvent, a_ as GeminiStreamStats, a$ as GeminiToolError, b0 as GeminiToolResultEvent, b1 as GeminiToolUseEvent, b2 as GithubAccountFilter, b3 as GithubAccountSelector, b4 as GithubAccountSnippet, b5 as GithubAccountType, b6 as GithubCheckRunEvent, b7 as GithubCheckSuiteEvent, b8 as GithubIssueEvent, b9 as GithubPermissions, ba as GithubPullRequestEvent, bb as GithubPushEvent, bc as GithubReleaseEvent, bd as GithubStatusEvent, be as GithubWorkflowRunEvent, bf as HandlerService, bg as HeartbeatFrame, bh as InputContract, bi as IssueAction, bj as LegacyAssistantPayload, bk as LegacyNativeUsage, bl as LegacyResultPayload, bm as Level, bn as LifecycleSessionRecord, bo as LinearIssueAction, bp as LinearIssueEvent, bq as LlmCost, br as LlmCostSplit, bs as McpRemoteServer, bt as McpServerRef, bu as McpStdioServer, bv as MemorySize, bw as MessageEndedPayload, bx as MessageEndedRecord, by as MessageQueuedPayload, bz as MessageQueuedRecord, bA as MessageRecord, bB as MessageRequeuedPayload, bC as MessageRequeuedRecord, bD as MessageStartedPayload, bE as MessageStartedRecord, bF as ModelLlmCostSplit, bG as ModelTokenCounts, bH as OutputConfig, bI as PermissionsConfig, bJ as PermissionsConfig1, bK as PlatformSessionRecord, bL as PromptBlockedReason, bM as PullRequestAction, bN as ReactCheckRun, bO as ReactCheckSuite, bP as ReactIssue, bQ as ReactLinearIssue, bR as ReactPullRequest, bS as ReactPush, bT as ReactRelease, bU as ReactSentry, bV as ReactSlackChannel, bW as ReactStatus, bX as ReactTrigger, bY as ReactWorkflowRun, bZ as RecordsFrame, b_ as ReleaseAction, b$ as RepositoryFilter, c0 as RepositoryRef, c1 as Review, c2 as ReviewComment, c3 as ReviewConfig, c4 as ReviewConfigsListResponse, c5 as ReviewPullRequest, c6 as ReviewPullRequestAuthor, c7 as ReviewReviewer, c8 as ReviewSummary, c9 as ReviewsListResponse, ca as SdkAssistantRecord, cb as SdkCacheCreation, cc as SdkContentBlock, cd as SdkRateLimitRecord, ce as SdkRecord, cf as SdkResultRecord, cg as SdkServerToolResultBlock, ch as SdkServerToolUseBlock, ci as SdkSystemRecord, cj as SdkTextBlock, ck as SdkThinkingBlock, cl as SdkToolResultBlock, cm as SdkToolUseBlock, cn as SdkUserRecord, co as SendSessionMessageRequest, cp as SentryAction, cq as SentryAlertEvent, cr as Session, cs as SessionAgent, ct as SessionArchived, cu as SessionAttribution, cv as SessionClosedPayload, cw as SessionClosedRecord, cx as SessionConfig, cy as SessionConversation, cz as SessionConversationConfig, cA as SessionEnvironment, cB as SessionError, cC as SessionEventActor, cD as SessionFrame, cE as SessionGit, cF as SessionGitCommit, cG as SessionGitFile, cH as SessionGitPr, cI as SessionGitRepo, cJ as SessionHandler, cK as SessionMessage, cL as SessionMessageImage, cM as SessionMessageResponse, cN as SessionOutput, cO as SessionParent, cP as SessionPrompting, cQ as SessionRecord, cR as SessionRecordsListResponse, cS as SessionResponse, cT as SessionSource, cU as SessionStatus, cV as SessionStreamFrame, cW as SessionSummary, cX as SessionsListResponse, cY as SettingsRef, cZ as SkillRef, c_ as SlackChannelCreatedEvent, c$ as SlackMessageEvent, d0 as StatusAction, d1 as StreamFrame, d2 as TokenCounts, d3 as Tokens, d4 as Tokens1, d5 as TokensInfo, d6 as UnknownSessionRecord, d7 as UpdateSessionRequest, d8 as WorkflowRunAction, d9 as paths } from './types-BXbnHOQe.js';
 
 /**
  * Frames on /v1/sessions/stream, /v1/agents/stream and /v1/vm-executions/{id}/stream. Ignore unknown frame types.
@@ -8,7 +8,7 @@ type CollectionStreamFrame = SessionListStreamMessage | AgentListStreamMessage |
 /**
  * An agent session: one conversation with an agent. Returned by
  * `GET /v1/sessions/{id}` and carried by the session stream's
- * `session`/`snapshot` frames; REST and stream never disagree about what a
+ * `session` frames; REST and stream never disagree about what a
  * session looks like.
  */
 type Session = {
@@ -40,6 +40,10 @@ type Session = {
      */
     created_at: string;
     environment: SessionEnvironment;
+    /**
+     * Why the last message failed, was stopped, or was cancelled; null otherwise.
+     */
+    error: SessionError | null;
     /**
      * The typed external event that started the session; null for direct and scheduled starts.
      */
@@ -67,7 +71,7 @@ type Session = {
         [k: string]: string;
     };
     /**
-     * The session's structured output: the `json_schema` the agent must satisfy and, once a turn has submitted it, the `result`.
+     * The session's structured output: the `json_schema` the agent must satisfy and, once the agent has submitted it, the `result`.
      */
     output: SessionOutput | null;
     /**
@@ -80,15 +84,12 @@ type Session = {
      */
     skills: SkillRef[];
     source: SessionSource;
+    status: SessionStatus;
     /**
      * The latest live summary of the session's progress while it runs, and when it was generated.
      */
     summary: SessionSummary | null;
     tokens: Tokens;
-    /**
-     * The turn in progress, or the latest one when none is running. Null until the session has a message. Wait on it: the message you sent is answered when the turn with your message's `turn_id` reaches a final status.
-     */
-    turn: SessionTurn | null;
     /**
      * When the session was last updated.
      */
@@ -217,10 +218,6 @@ type AttributionType = 'github_user' | 'linear_user' | 'slack_user' | 'api_key';
  * Why direct prompting is refused. Absent when prompting is allowed.
  */
 type PromptBlockedReason = 'mention_surface' | 'non_interactive' | 'harness_single_turn' | 'budget_exhausted' | 'closed';
-/**
- * `open` while the session can take messages; `closed` is permanent.
- */
-type SessionState = 'open' | 'closed';
 /**
  * How a session's environment was chosen. None (the field is nullable)
  * when the config carried an inline environment block and no resolution ran —
@@ -230,6 +227,10 @@ type SessionState = 'open' | 'closed';
  * how it was chosen, and is null for the built-in basic environment.
  */
 type EnvironmentSource = 'request' | 'agent' | 'repo_default' | 'account_default' | 'platform_default';
+/**
+ * What went wrong.
+ */
+type ErrorReason = 'error' | 'tool_call_failed' | 'budget_hit' | 'payment_required' | 'blocked' | 'contact_email_required' | 'lifecycle_hook_failed' | 'missing_repo_access' | 'missing_token_permissions' | 'missing_environment_variables' | 'missing_github_integration' | 'agent_unavailable' | 'upstream_unavailable' | 'unsupported_configuration' | 'execution_disabled' | 'interrupted' | 'stopped';
 /**
  * The service the handler responds to.
  */
@@ -239,13 +240,9 @@ type HandlerService = 'slack' | 'github' | 'linear' | 'sentry';
  */
 type SessionSource = 'react' | 'code_review' | 'web' | 'api' | 'cli' | 'mention' | 'cron';
 /**
- * Why a turn failed or was cancelled. Null on every other outcome.
- */
-type TurnReason = 'error' | 'tool_call_failed' | 'budget_hit' | 'payment_required' | 'blocked' | 'contact_email_required' | 'lifecycle_hook_failed' | 'missing_repo_access' | 'missing_token_permissions' | 'missing_environment_variables' | 'missing_github_integration' | 'agent_unavailable' | 'upstream_unavailable' | 'unsupported_configuration' | 'execution_disabled' | 'interrupted';
-/**
- * Where the turn is.
+ * Where the session is. A message you sent is answered once the status is `idle` or `closed`; its `message_ended` record in GET /v1/sessions/{id}/records says how.
  */
-type TurnStatus = 'queued' | 'preparing' | 'running' | 'completed' | 'failed' | 'stopped' | 'cancelled';
+type SessionStatus = 'queued' | 'preparing' | 'running' | 'idle' | 'closed';
 /**
  * Which writer owns this agent. "github" agents are defined by a file in a repository and are changed by editing that file; "api" agents have no file and are changed through this API.
  */
@@ -374,7 +371,7 @@ interface ClaudeConfig {
      */
     model: string;
     /**
-     * The initial user message, passed verbatim. Omit to start an interactive session with no turn, waiting for a message.
+     * The initial user message, passed verbatim. Omit to start an interactive session with no message, waiting for one.
      */
     prompt: string | null;
     settings: SettingsRef | null;
@@ -399,7 +396,7 @@ interface RepositoryRef {
  */
 interface CodexConfig {
     /**
-     * Reasoning effort for every turn. Omit to use the model default.
+     * Reasoning effort for every message. Omit to use the model default.
      */
     effort: CodexEffortLevel | null;
     /**
@@ -407,7 +404,7 @@ interface CodexConfig {
      */
     model: string;
     /**
-     * The initial user message, passed verbatim. Omit to start an interactive session with no turn, waiting for a message.
+     * The initial user message, passed verbatim. Omit to start an interactive session with no message, waiting for one.
      */
     prompt: string | null;
 }
@@ -416,7 +413,7 @@ interface CodexConfig {
  */
 interface SessionConversationConfig {
     /**
-     * Whether the session stays open after its first turn. Defaults to true; false runs once and requires a prompt. Requires the model's interactive capability when true. Direct message acceptance is reported separately in conversation.prompting.
+     * Whether the session stays open after its first message is answered. Defaults to true; false runs once and requires a prompt. Requires the model's interactive capability when true. Direct message acceptance is reported separately in conversation.prompting.
      */
     interactive: boolean;
 }
@@ -610,7 +607,7 @@ interface GeminiConfig {
      */
     model: string;
     /**
-     * The initial user message, passed verbatim. Omit to start an interactive session with no turn, waiting for a message.
+     * The initial user message, passed verbatim. Omit to start an interactive session with no message, waiting for one.
      */
     prompt: string | null;
 }
@@ -887,11 +884,10 @@ interface SessionAttribution {
  */
 interface SessionConversation {
     /**
-     * Whether the session stays open after its first turn.
+     * Whether the session stays open after its first message is answered.
      */
     interactive: boolean;
     prompting: SessionPrompting;
-    state: SessionState;
     /**
      * Whether an agent is ready to answer the next message right away. When false, the next message first prepares an environment, which takes longer. A hint only; clients need no logic on it.
      */
@@ -1069,6 +1065,17 @@ interface EnvironmentHooks1 {
      */
     validate: EnvironmentScript | string | null;
 }
+/**
+ * Why the last message failed, was stopped, or was cancelled. Cleared
+ * when the next message starts.
+ */
+interface SessionError {
+    /**
+     * A human-readable explanation.
+     */
+    detail: string | null;
+    reason: ErrorReason;
+}
 interface GithubPullRequestEvent {
     action: PullRequestAction | 'review_commented';
     actor: SessionEventActor | null;
@@ -1274,9 +1281,9 @@ interface SessionHandler {
     sha: string;
 }
 /**
- * Structured output on the wire: the contract and, when a turn has
+ * Structured output on the wire: the contract and, when the agent has
  * submitted one, the payload. `result` is None while the session runs and
- * when no turn submitted anything; it is the agent's own JSON, in the
+ * when the agent submitted nothing; it is the agent's own JSON, in the
  * shape of `json_schema`.
  */
 interface SessionOutput {
@@ -1287,7 +1294,7 @@ interface SessionOutput {
         [k: string]: unknown;
     };
     /**
-     * The payload the agent submitted, or null until a turn submits one.
+     * The payload the agent submitted, or null until it submits one.
      */
     result: {
         [k: string]: unknown;
@@ -1387,98 +1394,6 @@ interface ModelTokenCounts {
      */
     total: number;
 }
-/**
- * One message and the agent's answer to it. A turn is `queued` from the
- * moment its message is received, `preparing` while its environment is set
- * up, `running` while the agent works, then `completed`, `failed`,
- * `stopped`, or `cancelled`.
- */
-interface SessionTurn {
-    cost: Cost1;
-    /**
-     * When the turn's message was received.
-     */
-    created_at: string;
-    /**
-     * A human-readable explanation of a failed, stopped, or cancelled turn, or of why a queued turn waits.
-     */
-    detail: string | null;
-    /**
-     * When the turn reached its final status.
-     */
-    ended_at: string | null;
-    /**
-     * Unique identifier of the turn.
-     */
-    id: string;
-    /**
-     * Position in the session, starting at 0.
-     */
-    index: number;
-    /**
-     * Why the turn failed or was cancelled; null on every other status.
-     */
-    reason: TurnReason | null;
-    /**
-     * When the agent started on the message.
-     */
-    started_at: string | null;
-    status: TurnStatus;
-    /**
-     * When and by whom a stop was requested; null when none was.
-     */
-    stopped: SessionStopped | null;
-    tokens: Tokens1;
-}
-/**
- * What the turn cost so far, in millicents, broken down by leg.
- */
-interface Cost1 {
-    /**
-     * What Ellipsis charged to credit, in millicents. It is everything except subscription tokens.
-     */
-    charged: number;
-    /**
-     * CPU spend in millicents.
-     */
-    cpu: number;
-    /**
-     * Platform fee in millicents.
-     */
-    fee: number;
-    llm: LlmCost;
-    /**
-     * Memory spend in millicents.
-     */
-    memory: number;
-    /**
-     * Everything it cost, whoever paid, in millicents. It is the sum of llm.all.total, cpu, memory, and fee, and it is what the budget caps.
-     */
-    total: number;
-}
-/**
- * When a stop was requested and the GitHub user who requested it.
- */
-interface SessionStopped {
-    /**
-     * When a stop was requested.
-     */
-    at: string;
-    /**
-     * The GitHub user who stopped the session, resolved at read time. Null if the user is unknown or unavailable.
-     */
-    by: GithubAccountSnippet | null;
-}
-/**
- * The tokens the turn spent and the model they went to.
- */
-interface Tokens1 {
-    all: TokenCounts;
-    /**
-     * Token counts for each model that used tokens.
-     */
-    by_model: ModelTokenCounts[];
-}
 interface AgentListStreamMessage {
     agents: Agent[];
     type: 'agents';
@@ -1684,7 +1599,8 @@ declare class Page<ItemT, ResponseT extends CursorResponse> implements AsyncIter
 }
 
 type S$1 = components['schemas'];
-declare function isTurnFinal(status: string): boolean;
+declare function isSessionSettled(status: string): boolean;
+type MessageEnded = S$1['MessageEndedPayload'];
 interface SessionsApi {
     get(sessionId: string): Promise<S$1['SessionResponse']>;
     stop(sessionId: string): Promise<S$1['SessionResponse']>;
@@ -1693,21 +1609,23 @@ interface SessionsApi {
         images?: S$1['ImageAttachment'][];
         idempotency_key?: string | null;
     }): Promise<S$1['SessionMessageResponse']>;
-    turns: {
-        get(sessionId: string, turnId: string): Promise<S$1['SessionTurnResponse']>;
-    };
+    records(sessionId: string, options?: {
+        cursor?: string | null;
+        limit?: number | null;
+        message_id?: string | null;
+    }): Promise<Page<S$1['SessionRecord'], S$1['SessionRecordsListResponse']>>;
 }
 declare class SessionHandle {
     private readonly sessions;
     readonly id: string;
     session: S$1['Session'];
-    turnId: string | null;
+    messageId: string | null;
     constructor(sessions: SessionsApi, session: S$1['Session']);
     refresh(): Promise<S$1['Session']>;
     wait(options?: {
         timeoutMs?: number;
         pollIntervalMs?: number;
-    }): Promise<S$1['SessionTurn'] | null>;
+    }): Promise<MessageEnded | null>;
     send(message: string, options?: {
         images?: S$1['ImageAttachment'][];
         idempotencyKey?: string;
@@ -2997,46 +2915,8 @@ declare class EllipsisSecrets {
         secrets: (S['SecretInput'])[];
     }): Promise<S['SecretsListResponse']>;
 }
-declare class EllipsisSessionsTurns {
-    private readonly transport;
-    constructor(transport: Transport);
-    /**
-     * Get Session Turn
-     *
-     * Return one turn.
-     *
-     * Poll this after sending a message: the message is answered when
-     * the turn's status is completed, failed, stopped, or cancelled.
-     *
-     * Required permissions: read:sessions.
-     * API key: Supported.
-     * CLI user token: Supported.
-     * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
-     * Higher permission levels include lower levels: read < write < delete.
-     * Grant match patterns can further restrict access to individual resources.
-     */
-    get(session_id: string, id: string): Promise<S['SessionTurnResponse']>;
-    /**
-     * Get Session Turns
-     *
-     * Return the session's turns and messages, oldest first.
-     *
-     * One turn per message: pending until the agent starts on it,
-     * running while it works, then completed, failed, stopped, or
-     * cancelled.
-     *
-     * Required permissions: read:sessions.
-     * API key: Supported.
-     * CLI user token: Supported.
-     * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
-     * Higher permission levels include lower levels: read < write < delete.
-     * Grant match patterns can further restrict access to individual resources.
-     */
-    list(id: string): Promise<S['SessionTurnsListResponse']>;
-}
 declare class EllipsisSessions {
     private readonly transport;
-    readonly turns: EllipsisSessionsTurns;
     constructor(transport: Transport);
     /**
      * Get Session Analytics
@@ -3164,8 +3044,7 @@ declare class EllipsisSessions {
      * List cloud agent sessions, newest first.
      *
      * Optionally filtered by agent (id or name), source, service, handler, time
-     * window, attributed author, repository, and whether the session is
-     * still going.
+     * window, attributed author, repository, and status.
      *
      * Required permissions: read:sessions.
      * API key: Supported.
@@ -3186,7 +3065,7 @@ declare class EllipsisSessions {
         cursor?: string | null;
         author_id?: number | null;
         repo?: string | null;
-        unfinished?: boolean;
+        status?: (S['SessionStatus'])[] | null;
     }): Promise<Page<S['Session'], S['SessionsListResponse']>>;
     /**
      * Get Session Metrics
@@ -3225,6 +3104,7 @@ declare class EllipsisSessions {
     records(id: string, options?: {
         cursor?: string | null;
         limit?: number | null;
+        message_id?: string | null;
     }): Promise<Page<S['SessionRecord'], S['SessionRecordsListResponse']>>;
     /**
      * Search Sessions
@@ -3246,7 +3126,7 @@ declare class EllipsisSessions {
         agent_id?: (string)[] | null;
         session_ids?: (string)[] | null;
         repo?: (string)[] | null;
-        status?: (S['TurnStatus'])[] | null;
+        status?: (S['SessionStatus'])[] | null;
         start?: string | null;
         end?: string | null;
         limit?: number;
@@ -3257,8 +3137,9 @@ declare class EllipsisSessions {
      * Send a message to a session.
      *
      * 409 for mention, non-interactive, closed, and out-of-budget
-     * sessions. Returns the created message and its turn; a retried send
-     * with the same idempotency_key returns the original ones.
+     * sessions. Returns the created message; a retried send with the
+     * same idempotency_key returns the original one. The message is
+     * answered once the session's status is `idle` or `closed`.
      *
      * Required permissions: write:sessions.
      * API key: Supported.
@@ -3325,11 +3206,11 @@ declare class EllipsisSessions {
     /**
      * Stop Session
      *
-     * Stop the turn in progress and return the session.
+     * Stop the session's work and return it.
      *
-     * The turn ends `stopped`; the conversation stays open. 409 when no
-     * turn is queued, preparing, or running. The stopping user is recorded only
-     * when the caller's credential maps to a GitHub account.
+     * The running message ends `stopped` and every queued message is
+     * cancelled, so the session goes `idle` (or `closed` when it was
+     * not interactive). 409 when the session is idle or closed already.
      *
      * Required permissions: write:sessions.
      * API key: Supported.
@@ -3781,4 +3662,4 @@ declare class RateLimitError extends APIError {
 declare class ServerError extends APIError {
 }
 
-export { APIError, type AgentListStreamMessage, AuthenticationError, type CollectionStreamFrame, type CollectionStreamHeartbeat, ConflictError, DEFAULT_BASE_URL, Ellipsis, EllipsisError, ForbiddenError, NotFoundError, Page, RateLimitError, type SandboxSnapshotFrame, type SandboxUpdateFrame, ServerError, SessionHandle, type SessionListStreamMessage, Transport, TransportError, type TransportOptions, UnprocessableError, components, isTurnFinal };
+export { APIError, type AgentListStreamMessage, AuthenticationError, type CollectionStreamFrame, type CollectionStreamHeartbeat, ConflictError, DEFAULT_BASE_URL, Ellipsis, EllipsisError, ForbiddenError, NotFoundError, Page, RateLimitError, type SandboxSnapshotFrame, type SandboxUpdateFrame, ServerError, SessionHandle, type SessionListStreamMessage, Transport, TransportError, type TransportOptions, UnprocessableError, components, isSessionSettled };