@ellipsis-dev/sdk 0.38.0 → 0.44.0

package/README.md

@@ -40,8 +40,8 @@ types and unknown `source`/`record_type`/`kind` values**.
 ## Shared chat work sections
 
 Web and CLI renderers can use `splitLedger(groupRecordsToChatTurns(records))`
-and `entryBody(entry, { live, now, liveText, liveSummary })` from `@ellipsis-dev/sdk/store`.
-`now` is epoch milliseconds. The returned `items` are the collapsed view:
+and `entryBody(entry, { live, now, liveText, liveSummary, harness })` from `@ellipsis-dev/sdk/store`.
+`now` is epoch milliseconds, and `harness` is `harnessName(session)`. The returned `items` are the collapsed view:
 one `isWorkFold(item)` section for progress, thinking and tools, with final
 replies, turn outcome and closing notices kept visible.
 `members.get(item.key)` contains
@@ -49,7 +49,8 @@ that section's rows; nested tool folds use the same map and `isToolFold`.
 Renderers own expansion state and can recursively display the members.
 
 The work key stays stable as records stream in and after replay. The live
-label advances from `Preparing environment` to `Starting agent` to `Working`
+label advances from `Preparing environment` to `Starting Claude Code` (the
+harness's name, or `Starting agent` without one) to `Working`
 as the platform and native turn events arrive. While the agent works, the heading
 from `store.getSnapshot().liveSummary` replaces `Working` when available.
 Pass the summary only to the entry being answered (`loading: true`, add a loading

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { c as components } from './types-D4cLMGUn.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 LinearIssueChanged, bq as LinearIssueEvent, br as LinearLabelsChange, bs as LinearValueChange, bt as LinearValueFilter, bu as LlmCost, bv as LlmCostSplit, bw as McpRemoteServer, bx as McpServerRef, by as McpStdioServer, bz as MemorySize, bA as MessageEndedPayload, bB as MessageEndedRecord, bC as MessageQueuedPayload, bD as MessageQueuedRecord, bE as MessageRecord, bF as MessageRequeuedPayload, bG as MessageRequeuedRecord, bH as MessageStartedPayload, bI as MessageStartedRecord, bJ as ModelLlmCostSplit, bK as ModelTokenCounts, bL as OutputConfig, bM as PermissionsConfig, bN as PermissionsConfig1, bO as PlatformSessionRecord, bP as PromptBlockedReason, bQ as PullRequest, bR as PullRequestAction, bS as ReactCheckRun, bT as ReactCheckSuite, bU as ReactIssue, bV as ReactLinearIssue, bW as ReactPullRequest, bX as ReactPush, bY as ReactRelease, bZ as ReactSentry, b_ as ReactSlackChannel, b$ as ReactStatus, c0 as ReactTrigger, c1 as ReactWorkflowRun, c2 as RecordsFrame, c3 as ReleaseAction, c4 as RepositoryFilter, c5 as RepositoryRef, c6 as Review, c7 as ReviewComment, c8 as ReviewConfig, c9 as ReviewConfigsListResponse, ca as ReviewReviewer, cb as ReviewSummary, cc as ReviewsListResponse, cd as SdkAssistantRecord, ce as SdkCacheCreation, cf as SdkContentBlock, cg as SdkRateLimitRecord, ch as SdkRecord, ci as SdkResultRecord, cj as SdkServerToolResultBlock, ck as SdkServerToolUseBlock, cl as SdkSystemRecord, cm as SdkTextBlock, cn as SdkThinkingBlock, co as SdkToolResultBlock, cp as SdkToolUseBlock, cq as SdkUserRecord, cr as SendSessionMessageRequest, cs as SentryAction, ct as SentryAlertEvent, cu as Session, cv as SessionAgent, cw as SessionArchived, cx as SessionAttribution, cy as SessionClosedPayload, cz as SessionClosedRecord, cA as SessionConfig, cB as SessionConversation, cC as SessionConversationConfig, cD as SessionEnvironment, cE as SessionError, cF as SessionEventActor, cG as SessionFrame, cH as SessionGit, cI as SessionGitCommit, cJ as SessionGitFile, cK as SessionGitPr, cL as SessionGitRepo, cM as SessionHandler, cN as SessionMessage, cO as SessionMessageImage, cP as SessionMessageResponse, cQ as SessionOutput, cR as SessionParent, cS as SessionPrompting, cT as SessionRecord, cU as SessionRecordsListResponse, cV as SessionResponse, cW as SessionReview, cX as SessionSource, cY as SessionStatus, cZ as SessionStreamFrame, c_ as SessionSummary, c$ as SessionSummarySource, d0 as SessionsListResponse, d1 as SettingsRef, d2 as SkillRef, d3 as SlackChannelCreatedEvent, d4 as SlackMessageEvent, d5 as StatusAction, d6 as StreamFrame, d7 as TokenCounts, d8 as Tokens, d9 as Tokens1, da as TokensInfo, db as UnknownSessionRecord, dc as UpdateSessionRequest, dd as WorkflowRunAction, de as paths } from './types-D4cLMGUn.js';
+import { c as components } from './types-Dwyd1Aud.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 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 ErrorReason, aR as GeminiConfig, aS as GeminiErrorEvent, aT as GeminiInitEvent, aU as GeminiMessageEvent, aV as GeminiModelStats, aW as GeminiResultEvent, aX as GeminiSessionRecord, aY as GeminiStreamEvent, aZ as GeminiStreamStats, a_ as GeminiToolError, a$ as GeminiToolResultEvent, b0 as GeminiToolUseEvent, b1 as GithubAccountFilter, b2 as GithubAccountSelector, b3 as GithubAccountSnippet, b4 as GithubAccountType, b5 as GithubCheckRunEvent, b6 as GithubCheckSuiteEvent, b7 as GithubIssueEvent, b8 as GithubPermissions, b9 as GithubPullRequestEvent, ba as GithubPushEvent, bb as GithubReleaseEvent, bc as GithubStatusEvent, bd as GithubWorkflowRunEvent, be as HandlerService, bf as HeartbeatFrame, bg as InputContract, bh as IssueAction, bi as LegacyAssistantPayload, bj as LegacyNativeUsage, bk as LegacyResultPayload, bl as Level, bm as LifecycleSessionRecord, bn as LinearIssueAction, bo as LinearIssueChanged, bp as LinearIssueEvent, bq as LinearLabelsChange, br as LinearValueChange, bs as LinearValueFilter, bt as LlmCost, bu as LlmCostSplit, bv as McpRemoteServer, bw as McpServerRef, bx as McpStdioServer, by as MemorySize, bz as MessageEndedPayload, bA as MessageEndedRecord, bB as MessageQueuedPayload, bC as MessageQueuedRecord, bD as MessageRecord, bE as MessageRequeuedPayload, bF as MessageRequeuedRecord, bG as MessageStartedPayload, bH as MessageStartedRecord, bI as ModelLlmCostSplit, bJ as ModelTokenCounts, bK as OutputConfig, bL as PermissionsConfig, bM as PermissionsConfig1, bN as PlatformSessionRecord, bO as PromptBlockedReason, bP as PullRequest, bQ as PullRequestAction, bR as ReactCheckRun, bS as ReactCheckSuite, bT as ReactIssue, bU as ReactLinearIssue, bV as ReactPullRequest, bW as ReactPush, bX as ReactRelease, bY as ReactSentry, bZ as ReactSlackChannel, b_ as ReactStatus, b$ as ReactTrigger, c0 as ReactWorkflowRun, c1 as RecordsFrame, c2 as ReleaseAction, c3 as RepositoryFilter, c4 as RepositoryRef, c5 as Review, c6 as ReviewComment, c7 as ReviewConfig, c8 as ReviewConfigsListResponse, c9 as ReviewReviewer, ca as ReviewSummary, cb as ReviewsListResponse, cc as SdkAssistantRecord, cd as SdkCacheCreation, ce as SdkContentBlock, cf as SdkRateLimitRecord, cg as SdkRecord, ch as SdkResultRecord, ci as SdkServerToolResultBlock, cj as SdkServerToolUseBlock, ck as SdkSystemRecord, cl as SdkTextBlock, cm as SdkThinkingBlock, cn as SdkToolResultBlock, co as SdkToolUseBlock, cp as SdkUserRecord, cq as SendSessionMessageRequest, cr as SentryAction, cs as SentryAlertEvent, ct as Session, cu as SessionAgent, cv as SessionArchived, cw as SessionAttribution, cx as SessionClosedPayload, cy as SessionClosedRecord, cz as SessionConfig, cA as SessionConversation, cB as SessionConversationConfig, cC as SessionEnvironment, cD as SessionError, cE as SessionEventActor, cF as SessionFrame, cG as SessionGit, cH as SessionGitCommit, cI as SessionGitFile, cJ as SessionGitPr, cK as SessionGitRepo, cL as SessionHandler, cM as SessionMessage, cN as SessionMessageImage, cO as SessionMessageResponse, cP as SessionOutput, cQ as SessionParent, cR as SessionPrompting, cS as SessionRecord, cT as SessionRecordsListResponse, cU as SessionResponse, cV as SessionReview, cW as SessionSource, cX as SessionStatus, cY as SessionStreamFrame, cZ as SessionSummary, c_ as SessionSummarySource, c$ as SessionsListResponse, d0 as SettingsRef, d1 as SkillRef, d2 as SlackChannelCreatedEvent, d3 as SlackMessageEvent, d4 as StatusAction, d5 as StreamFrame, d6 as TokenCounts, d7 as Tokens, d8 as Tokens1, d9 as TokensInfo, da as UnknownSessionRecord, db as UpdateSessionRequest, dc as WorkflowRunAction, dd as paths } from './types-Dwyd1Aud.js';
 
 /**
  * Frames on /v1/sessions/stream, /v1/agents/stream and /v1/vm-executions/{id}/stream. Ignore unknown frame types.
@@ -246,7 +246,7 @@ type EnvironmentSource = 'request' | 'agent' | 'repo_default' | 'account_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';
+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' | 'timeout';
 /**
  * The service the handler responds to.
  */
@@ -458,29 +458,27 @@ interface EnvironmentConfig {
     variables: EnvironmentVariable[];
 }
 /**
- * Environment compute sizing. Every field is optional; an omitted field
- * inherits the platform default (2 vCPU / 4096 MiB / 3600s). A resolved value
- * outside the platform bounds fails validation loudly (a sync error on the
- * config) rather than being clamped silently.
+ * The size and lifetime of the environment. Every field is optional. An
+ * omitted field takes the platform default (2 vCPUs, 4096 MiB, a 4h timeout,
+ * 10m idle). A value outside the platform bounds fails validation.
  *
- * `memory` and `timeout` each accept a shorthand string ("8GB", "30m") or an
- * explicit units object ({gb: 8}, {minutes: 30}); the `memory_mib` /
- * `timeout_seconds` properties resolve either form to the canonical integer
- * the environment is sized with.
+ * `memory` accepts a string such as `8GB` or an object such as `{gb: 8}`.
+ * `timeout` and `idle` accept a duration string such as `30m`, `8h`, or
+ * `1h30m`.
  *
- * `timeout` is the max wall-clock the agent may run in one environment before
- * it is stopped, capped at 1h (equal to the default, so today the knob only
- * shortens a session; the cap matches the 1-hour validity of the session's
- * GitHub token).
+ * `timeout` is the longest one message's work may run before it is stopped,
+ * 1m to 22h, default 4h. The message ends `stopped` with reason `timeout`.
  *
- * Compute currently uses a temporary flat one-cent amount each time an
- * environment is started for a session, subject to the account's existing
- * free-compute exemptions.
+ * `idle` is how long the environment stays awake after the agent finishes
+ * with no message waiting, 10s to 1h, default 10m. Then it pauses, and the
+ * next message resumes it. Only an interactive session pauses. A session
+ * that runs once ends when its message ends.
  */
 interface ComputeConfig {
     cpu: number | null;
+    idle: string | null;
     memory: string | MemorySize | null;
-    timeout: string | Duration | null;
+    timeout: string | null;
 }
 /**
  * A memory size as explicit units, summed (binary: 1GB = 1024MB = 1024MiB).
@@ -491,16 +489,6 @@ interface MemorySize {
     gb: number | null;
     mb: number | null;
 }
-/**
- * A duration as explicit units, summed. Set any of `hours`/`minutes`/
- * `seconds` (at least one). The alternative to the `30m`-style shorthand
- * string wherever a duration is accepted.
- */
-interface Duration {
-    hours: number | null;
-    minutes: number | null;
-    seconds: number | null;
-}
 /**
  * Environment lifecycle scripts, in order: build_base, after_checkout,
  * before_start, validate. The first two produce reusable snapshots;
@@ -1071,29 +1059,27 @@ interface SessionEnvironment {
     variables: EnvironmentVariable[];
 }
 /**
- * Environment compute sizing. Every field is optional; an omitted field
- * inherits the platform default (2 vCPU / 4096 MiB / 3600s). A resolved value
- * outside the platform bounds fails validation loudly (a sync error on the
- * config) rather than being clamped silently.
+ * The size and lifetime of the environment. Every field is optional. An
+ * omitted field takes the platform default (2 vCPUs, 4096 MiB, a 4h timeout,
+ * 10m idle). A value outside the platform bounds fails validation.
  *
- * `memory` and `timeout` each accept a shorthand string ("8GB", "30m") or an
- * explicit units object ({gb: 8}, {minutes: 30}); the `memory_mib` /
- * `timeout_seconds` properties resolve either form to the canonical integer
- * the environment is sized with.
+ * `memory` accepts a string such as `8GB` or an object such as `{gb: 8}`.
+ * `timeout` and `idle` accept a duration string such as `30m`, `8h`, or
+ * `1h30m`.
  *
- * `timeout` is the max wall-clock the agent may run in one environment before
- * it is stopped, capped at 1h (equal to the default, so today the knob only
- * shortens a session; the cap matches the 1-hour validity of the session's
- * GitHub token).
+ * `timeout` is the longest one message's work may run before it is stopped,
+ * 1m to 22h, default 4h. The message ends `stopped` with reason `timeout`.
  *
- * Compute currently uses a temporary flat one-cent amount each time an
- * environment is started for a session, subject to the account's existing
- * free-compute exemptions.
+ * `idle` is how long the environment stays awake after the agent finishes
+ * with no message waiting, 10s to 1h, default 10m. Then it pauses, and the
+ * next message resumes it. Only an interactive session pauses. A session
+ * that runs once ends when its message ends.
  */
 interface ComputeConfig1 {
     cpu: number | null;
+    idle: string | null;
     memory: string | MemorySize | null;
-    timeout: string | Duration | null;
+    timeout: string | null;
 }
 /**
  * Environment lifecycle scripts, in order: build_base, after_checkout,
@@ -2895,6 +2881,21 @@ declare class EllipsisSessions {
      * Grant match patterns can further restrict access to individual resources.
      */
     git(id: string): Promise<S['SessionGitResponse']>;
+    /**
+     * Get Session Image
+     *
+     * Return an image sent with a message to the session.
+     *
+     * Each message lists its images, with their IDs, in `images`.
+     *
+     * 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.
+     */
+    image(session_id: string, id: string): Promise<S['ImageAttachment']>;
     /**
      * List Sessions
      *
@@ -2940,6 +2941,23 @@ declare class EllipsisSessions {
      * Grant match patterns can further restrict access to individual resources.
      */
     metrics(id: string): Promise<S['VMMetricsResponse']>;
+    /**
+     * Get Session Proxy
+     *
+     * The requests the session's environment sent to GitHub through
+     * Ellipsis, newest first. Each is one `proxy_requests` row as stored.
+     *
+     * 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. Only the token's own session.
+     * Higher permission levels include lower levels: read < write < delete.
+     * Grant match patterns can further restrict access to individual resources.
+     */
+    proxy(id: string, options?: {
+        limit?: number;
+        cursor?: string | null;
+    }): Promise<Page<S['ProxyRequest'], S['SessionProxyResponse']>>;
     /**
      * Get Session Records
      *
@@ -3066,7 +3084,7 @@ declare class EllipsisSessions {
     /**
      * Update Session
      *
-     * Archive or unarchive a session and return it.
+     * Archive or unarchive a session, or set its summary, and return it.
      *
      * Set archived to true to record the current server time and the
      * authenticated GitHub user. API-key requests record no user.
@@ -3084,6 +3102,11 @@ declare class EllipsisSessions {
      * take messages again. 409 `session_superseded` when a newer session
      * now answers the same thread.
      *
+     * Set summary to name the session. The summary's source becomes
+     * `user`, and Ellipsis never replaces it with a generated one. With
+     * both fields, the archive change applies first, and a refused
+     * archive change leaves the summary as it was.
+     *
      * Changes are delivered to session and session-list streams.
      *
      * Required permissions: write:sessions.
@@ -3093,14 +3116,47 @@ declare class EllipsisSessions {
      * Higher permission levels include lower levels: read < write < delete.
      * Grant match patterns can further restrict access to individual resources.
      */
-    update(id: string, options: {
-        archived: boolean;
+    update(id: string, options?: {
+        archived?: boolean | null;
+        summary?: string | null;
     }): Promise<S['SessionResponse']>;
     /** Start a session and return a handle over it. */
     run(options: Parameters<EllipsisSessions['start']>[0]): Promise<SessionHandle>;
     /** A handle over an existing session. */
     handle(sessionId: string): Promise<SessionHandle>;
 }
+declare class EllipsisUserSettings {
+    private readonly transport;
+    constructor(transport: Transport);
+    /**
+     * Get User Settings
+     *
+     * Get the signed in user's own settings.
+     *
+     * Required permissions: read:user.
+     * API key: Requires a CLI user token.
+     * CLI user token: Supported.
+     * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
+     * Higher permission levels include lower levels: read < write < delete.
+     */
+    get(): Promise<S['UserSettings']>;
+    /**
+     * Patch User Settings
+     *
+     * Change the signed in user's own settings.
+     *
+     * Only the keys sent change, and the response is every setting.
+     *
+     * Required permissions: write:user.
+     * API key: Requires a CLI user token.
+     * CLI user token: Supported.
+     * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
+     * Higher permission levels include lower levels: read < write < delete.
+     */
+    update(options?: {
+        web?: S['PatchUserSettingsWeb'] | null;
+    }): Promise<S['UserSettings']>;
+}
 declare class EllipsisUserTokens {
     private readonly transport;
     constructor(transport: Transport);
@@ -3127,6 +3183,7 @@ declare class EllipsisUserTokens {
 }
 declare class EllipsisUser {
     private readonly transport;
+    readonly settings: EllipsisUserSettings;
     readonly tokens: EllipsisUserTokens;
     constructor(transport: Transport);
 }

package/dist/index.js

@@ -1626,6 +1626,24 @@ var EllipsisSessions = class {
     const path = `/v1/sessions/${enc(id)}/git`;
     return await this.transport.request("GET", path);
   }
+  /**
+   * Get Session Image
+   *
+   * Return an image sent with a message to the session.
+   *
+   * Each message lists its images, with their IDs, in `images`.
+   *
+   * 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.
+   */
+  async image(session_id, id) {
+    const path = `/v1/sessions/${enc(session_id)}/images/${enc(id)}`;
+    return await this.transport.request("GET", path);
+  }
   /**
    * List Sessions
    *
@@ -1670,6 +1688,29 @@ var EllipsisSessions = class {
     const path = `/v1/sessions/${enc(id)}/metrics`;
     return await this.transport.request("GET", path);
   }
+  /**
+   * Get Session Proxy
+   *
+   * The requests the session's environment sent to GitHub through
+   * Ellipsis, newest first. Each is one `proxy_requests` row as stored.
+   *
+   * 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. Only the token's own session.
+   * Higher permission levels include lower levels: read < write < delete.
+   * Grant match patterns can further restrict access to individual resources.
+   */
+  async proxy(id, options = {}) {
+    const path = `/v1/sessions/${enc(id)}/proxy`;
+    const query = buildQuery({ limit: options.limit, cursor: options.cursor });
+    const response = await this.transport.request("GET", path, { query });
+    return new Page(
+      response,
+      "proxy_requests",
+      (cursor) => this.proxy(id, { ...options, cursor })
+    );
+  }
   /**
    * Get Session Records
    *
@@ -1801,7 +1842,7 @@ var EllipsisSessions = class {
   /**
    * Update Session
    *
-   * Archive or unarchive a session and return it.
+   * Archive or unarchive a session, or set its summary, and return it.
    *
    * Set archived to true to record the current server time and the
    * authenticated GitHub user. API-key requests record no user.
@@ -1819,6 +1860,11 @@ var EllipsisSessions = class {
    * take messages again. 409 `session_superseded` when a newer session
    * now answers the same thread.
    *
+   * Set summary to name the session. The summary's source becomes
+   * `user`, and Ellipsis never replaces it with a generated one. With
+   * both fields, the archive change applies first, and a refused
+   * archive change leaves the summary as it was.
+   *
    * Changes are delivered to session and session-list streams.
    *
    * Required permissions: write:sessions.
@@ -1828,9 +1874,9 @@ var EllipsisSessions = class {
    * Higher permission levels include lower levels: read < write < delete.
    * Grant match patterns can further restrict access to individual resources.
    */
-  async update(id, options) {
+  async update(id, options = {}) {
     const path = `/v1/sessions/${enc(id)}`;
-    const body = buildBody({ archived: options.archived });
+    const body = buildBody({ archived: options.archived, summary: options.summary });
     return await this.transport.request("PUT", path, { body });
   }
   // ---- lifecycle sugar (hand-written layer over the generated core) ----
@@ -1845,6 +1891,45 @@ var EllipsisSessions = class {
     return new SessionHandle(this, response.session);
   }
 };
+var EllipsisUserSettings = class {
+  constructor(transport) {
+    this.transport = transport;
+  }
+  transport;
+  /**
+   * Get User Settings
+   *
+   * Get the signed in user's own settings.
+   *
+   * Required permissions: read:user.
+   * API key: Requires a CLI user token.
+   * CLI user token: Supported.
+   * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
+   * Higher permission levels include lower levels: read < write < delete.
+   */
+  async get() {
+    const path = "/v1/user/settings";
+    return await this.transport.request("GET", path);
+  }
+  /**
+   * Patch User Settings
+   *
+   * Change the signed in user's own settings.
+   *
+   * Only the keys sent change, and the response is every setting.
+   *
+   * Required permissions: write:user.
+   * API key: Requires a CLI user token.
+   * CLI user token: Supported.
+   * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
+   * Higher permission levels include lower levels: read < write < delete.
+   */
+  async update(options = {}) {
+    const path = "/v1/user/settings";
+    const body = buildBody({ web: options.web });
+    return await this.transport.request("PATCH", path, { body });
+  }
+};
 var EllipsisUserTokens = class {
   constructor(transport) {
     this.transport = transport;
@@ -1880,9 +1965,11 @@ var EllipsisUserTokens = class {
 var EllipsisUser = class {
   constructor(transport) {
     this.transport = transport;
+    this.settings = new EllipsisUserSettings(transport);
     this.tokens = new EllipsisUserTokens(transport);
   }
   transport;
+  settings;
   tokens;
 };
 var EllipsisVmExecutions = class {

package/dist/store/index.d.ts

@@ -1,4 +1,4 @@
-import { s as CodexAgentMessage, cT as SessionRecord, N as CodexFileChangeItem, L as CodexEvent, _ as CodexMcpToolCallItem, ch as SdkRecord, cu as Session, d6 as StreamFrame } from '../types-D4cLMGUn.js';
+import { s as CodexAgentMessage, cS as SessionRecord, N as CodexFileChangeItem, L as CodexEvent, _ as CodexMcpToolCallItem, cg as SdkRecord, ct as Session, d5 as StreamFrame } from '../types-Dwyd1Aud.js';
 
 type WorkPhase = 'queued' | 'preparing' | 'starting' | 'working';
 interface MessageTiming {
@@ -192,11 +192,17 @@ type EntryBody = {
 };
 declare function isWorkFold(item: TranscriptItem): boolean;
 declare function reasoningSummaryTitle(summary: string): string;
-declare function entryBody(entry: LedgerEntry, { live, now, liveText, liveSummary, }: {
+declare function harnessName(session: {
+    claude_code?: unknown;
+    codex?: unknown;
+    gemini?: unknown;
+}): string | null;
+declare function entryBody(entry: LedgerEntry, { live, now, liveText, liveSummary, harness, }: {
     live: boolean;
     now: number;
     liveText?: string;
     liveSummary?: string;
+    harness?: string | null;
 }): EntryBody;
 
 interface ToolActivity {
@@ -252,4 +258,4 @@ declare class SessionTranscriptStore {
     ingest: (rawFrame: StreamFrame) => void;
 }
 
-export { BRANCH_GLYPH, type ChatNode, type ChatToolNode, type ChatTurn, type EntryBody, type EnvironmentLogKind, type EnvironmentLogLine, type EnvironmentState, type EventToItemsOptions, type ItemKind, LIVE_GLYPH, type LedgerEntry, type MessageProgress, type MessageTiming, type PlacedItem, type RecordSlice, type SessionTranscriptSnapshot, SessionTranscriptStore, StreamFrame, type ToolActivity, type TranscriptItem, USER_BAR, type WorkPhase, activitySummary, awaitingAgentPhase, cacheTierLabel, chatTurnsToItems, clampLines, claudePayload, codexChangedPaths, codexEventToItems, codexMcpToolName, codexSubagentThreads, collapseToolRuns, deliveredUnechoedSends, deriveEnvironmentState, emptySessionTranscriptSnapshot, entryBody, entrySeconds, environmentOutputLine, environmentOutputLines, environmentOutputStep, environmentPhaseLabel, environmentSummary, eventToItems, foldCosts, foldGutter, foldRun, formatDuration, groupRecordsToChatTurns, gutterFor, hookPhrase, humanDuration, isCodexSubagentRecord, isConnectVisibleRecord, isConversationOver, isFoldable, isToolActivity, isToolFold, isWorkFold, lastLines, layOutItems, lifecycleText, messageEndedText, oneLine, pendingToolCalls, reasoningSummaryTitle, recordSlice, recordToItems, resultCostUsd, seedTranscriptStore, sessionLogText, splitLedger, startupHeadline, startupSettled, statusActivityText, summarizeToolInput, tailLines, toolActivities, toolResultText, toolRunMembers };
+export { BRANCH_GLYPH, type ChatNode, type ChatToolNode, type ChatTurn, type EntryBody, type EnvironmentLogKind, type EnvironmentLogLine, type EnvironmentState, type EventToItemsOptions, type ItemKind, LIVE_GLYPH, type LedgerEntry, type MessageProgress, type MessageTiming, type PlacedItem, type RecordSlice, type SessionTranscriptSnapshot, SessionTranscriptStore, StreamFrame, type ToolActivity, type TranscriptItem, USER_BAR, type WorkPhase, activitySummary, awaitingAgentPhase, cacheTierLabel, chatTurnsToItems, clampLines, claudePayload, codexChangedPaths, codexEventToItems, codexMcpToolName, codexSubagentThreads, collapseToolRuns, deliveredUnechoedSends, deriveEnvironmentState, emptySessionTranscriptSnapshot, entryBody, entrySeconds, environmentOutputLine, environmentOutputLines, environmentOutputStep, environmentPhaseLabel, environmentSummary, eventToItems, foldCosts, foldGutter, foldRun, formatDuration, groupRecordsToChatTurns, gutterFor, harnessName, hookPhrase, humanDuration, isCodexSubagentRecord, isConnectVisibleRecord, isConversationOver, isFoldable, isToolActivity, isToolFold, isWorkFold, lastLines, layOutItems, lifecycleText, messageEndedText, oneLine, pendingToolCalls, reasoningSummaryTitle, recordSlice, recordToItems, resultCostUsd, seedTranscriptStore, sessionLogText, splitLedger, startupHeadline, startupSettled, statusActivityText, summarizeToolInput, tailLines, toolActivities, toolResultText, toolRunMembers };

package/dist/store/index.js

@@ -1829,11 +1829,18 @@ function reasoningSummaryTitle(summary) {
   const title = line.replace(/^#{1,6}\s+/, "").replace(/^[*_`]+|[*_`]+$/g, "").replace(/\[([^\]]+)\]\([^)]+\)/g, "$1").trim();
   return title.length > 120 ? `${title.slice(0, 119).trimEnd()}\u2026` : title;
 }
+function harnessName(session) {
+  if (session.claude_code) return "Claude Code";
+  if (session.codex) return "Codex";
+  if (session.gemini) return "Gemini CLI";
+  return null;
+}
 function entryBody(entry, {
   live,
   now,
   liveText = "",
-  liveSummary = ""
+  liveSummary = "",
+  harness = null
 }) {
   live = live && (entry.progress === void 0 || entry.progress.phase !== null);
   const raw = chatTurnsToItems(entry.turns);
@@ -1847,7 +1854,7 @@ function entryBody(entry, {
   const header = {
     key,
     kind: "summary",
-    text: live ? phase === "preparing" ? "Preparing environment" : phase === "starting" ? "Starting agent" : phase === "queued" ? "Queued" : reasoningSummaryTitle(liveSummary) || "Working" : seconds == null ? "Session startup" : `Worked for ${humanDuration(seconds)}`,
+    text: live ? phase === "preparing" ? "Preparing environment" : phase === "starting" ? `Starting ${harness ?? "agent"}` : phase === "queued" ? "Queued" : reasoningSummaryTitle(liveSummary) || "Working" : seconds == null ? "Session startup" : `Worked for ${humanDuration(seconds)}`,
     spaceBefore: true,
     ...entry.cancelled || entry.turns.some((turn) => turn.isError) ? { isError: true } : {},
     ...live ? { loading: true } : {}
@@ -2173,6 +2180,7 @@ export {
   formatDuration,
   groupRecordsToChatTurns,
   gutterFor,
+  harnessName,
   hookPhrase,
   humanDuration,
   isCodexSubagentRecord,

package/dist/stream/index.d.ts

@@ -1,4 +1,4 @@
-import { cu as Session, d6 as StreamFrame } from '../types-D4cLMGUn.js';
+import { ct as Session, d5 as StreamFrame } from '../types-Dwyd1Aud.js';
 
 declare const WS_CLOSE_NORMAL = 1000;
 declare const WS_CLOSE_GOING_AWAY = 1001;