@ellipsis-dev/sdk 0.8.1 → 0.9.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { c as components } from './types-Dx0e0Qs_.js';
-export { A as AgentSessionExitStatus, a as AgentSessionPr, b as AgentSessionSource, d as AgentSessionStatus, e as AttributionType, B as BudgetSource, C as CreateReviewRequest, D as DefaultResolution, f as DeltaFrame, g as DoneFrame, E as ErrorFrame, F as Finding, G as GithubAccountSnippet, h as GithubAccountType, H as Harness, i as HeartbeatFrame, P as ParentKind, j as PromptBlockedReason, R as RecordsAppendFrame, k as ResolvedReviewScope, l as Review, m as ReviewConfiguration, n as ReviewCounters, o as ReviewFinding, p as ReviewRequester, q as ReviewScope, r as ReviewScopeKind, s as ReviewStage, t as ReviewedCommit, u as ReviewsListResponse, S as SendSessionMessageRequest, v as Session, w as SessionExecution, x as SessionExecutionsListResponse, y as SessionFrame, z as SessionLiveness, I as SessionMessage, J as SessionMessageResponse, K as SessionMessageStatus, L as SessionPrompting, M as SessionRecord, N as SessionRecordsListResponse, O as SessionResponse, Q as SessionState, T as SessionStreamFrame, U as SessionSurface, V as SessionsListResponse, W as SnapshotFrame, X as StreamFrame, Y as TokensInfo, Z as paths } from './types-Dx0e0Qs_.js';
+import { c as components } from './types-CStmnKVu.js';
+export { A as AttributionType, B as BudgetSource, C as CreateReviewRequest, D as DefaultResolution, a as DeltaFrame, b as DoneFrame, E as ErrorFrame, F as Finding, G as GithubAccountSnippet, d as GithubAccountType, H as Harness, e as HeartbeatFrame, P as ParentKind, f as PromptBlockedReason, R as RecordsAppendFrame, g as ResolvedReviewScope, h as Review, i as ReviewConfiguration, j as ReviewCounters, k as ReviewFinding, l as ReviewRequester, m as ReviewScope, n as ReviewScopeKind, o as ReviewStage, p as ReviewedCommit, q as ReviewsListResponse, S as SendSessionMessageRequest, r as Session, s as SessionExecution, t as SessionExecutionsListResponse, u as SessionExitStatus, v as SessionFrame, w as SessionLiveness, x as SessionMessage, y as SessionMessageResponse, z as SessionMessageStatus, I as SessionPr, J as SessionPrompting, K as SessionRecord, L as SessionRecordsListResponse, M as SessionResponse, N as SessionSource, O as SessionState, Q as SessionStatus, T as SessionStreamFrame, U as SessionSurface, V as SessionsListResponse, W as SnapshotFrame, X as StreamFrame, Y as TokensInfo, Z as paths } from './types-CStmnKVu.js';
 
 interface CursorResponse {
     has_more: boolean;
@@ -78,9 +78,10 @@ declare class EllipsisAgentsConfigs {
      * Create an agent config via pull request.
      *
      * The PR adds the config file to agents/ on the target
-     * repository.
+     * repository; the agent goes live when it merges.
      *
-     * Accepts an inline config or a gallery template slug.
+     * Accepts an inline config or a gallery template slug. 409 when
+     * another live agent already holds the name.
      */
     create(options: {
         config?: S['AgentConfig'] | null;
@@ -91,7 +92,7 @@ declare class EllipsisAgentsConfigs {
     /**
      * Get Agent Config
      *
-     * Return one saved agent config by id.
+     * Return one saved agent config, by id or by the agent's name.
      */
     get(config_id: string): Promise<S['AgentConfigResponse']>;
     /**
@@ -134,7 +135,8 @@ declare class EllipsisAgentsDefaults {
      * Set a default agent config.
      *
      * Addressed by rung: the account rung (repository omitted) or a
-     * repository rung ("owner/name").
+     * repository rung ("owner/name"); the config by id or by the
+     * agent's name.
      *
      * Refused for sandbox tokens (potentially prompt-injected code
      * must not repoint the account's ambient default); an unknown or
@@ -636,6 +638,21 @@ declare class EllipsisSessions {
      * it).
      */
     executions(session_id: string): Promise<S['SessionExecutionsListResponse']>;
+    /**
+     * Export Agent Session
+     *
+     * Export the complete session history.
+     *
+     * The complete, ordered history of the session (agent output, tool calls, thinking,
+     * lifecycle events, sandbox output, message events) as an ordered
+     * manifest of presigned segment URLs.
+     *
+     * Segments are gzip members: download in order and concatenate
+     * for one file. The JSON API never carries the bytes (same
+     * two-step as files). /records is the paged live view of the
+     * same data.
+     */
+    export(session_id: string): Promise<S['GetSessionLogResponse']>;
     /**
      * Get Agent Session
      *
@@ -682,12 +699,13 @@ declare class EllipsisSessions {
      *
      * List cloud agent sessions, newest first.
      *
-     * Optionally filtered by config, source, time window, attributed
-     * author, repository, and whether the session is still going.
+     * Optionally filtered by config (id or `ellipsis.name`), source, time
+     * window, attributed author, repository, and whether the session is
+     * still going.
      */
     list(options?: {
         config_id?: string | null;
-        source?: (S['AgentSessionSource'])[] | null;
+        source?: (S['SessionSource'])[] | null;
         days?: number | null;
         start?: string | null;
         end?: string | null;
@@ -698,20 +716,17 @@ declare class EllipsisSessions {
         unfinished?: boolean;
     }): Promise<Page<S['Session'], S['SessionsListResponse']>>;
     /**
-     * Get Agent Session Log
-     *
-     * Download the complete session log.
+     * Get Agent Session Output
      *
-     * The complete, ordered history of the session (agent output, tool calls, thinking,
-     * lifecycle events, sandbox output, message events) as an ordered
-     * manifest of presigned segment URLs.
+     * Return the session's typed output.
      *
-     * Segments are gzip members: download in order and concatenate
-     * for one file. The JSON API never carries the bytes (same
-     * two-step as files). /records is the paged live view of the
-     * same data.
+     * The payload the agent submitted through its config-declared
+     * output.json_schema, as the raw JSON body with no envelope. 404
+     * while the session is still running (poll GET /sessions/{id}),
+     * when the agent declares no output block, or when no execution
+     * produced output.
      */
-    log(session_id: string): Promise<S['GetSessionLogResponse']>;
+    output(session_id: string): Promise<void>;
     /**
      * Get Agent Session Port
      *
@@ -771,12 +786,12 @@ declare class EllipsisSessions {
     search(options?: {
         q?: string;
         scope?: S['SessionSearchScope'];
-        source?: (S['AgentSessionSource'])[] | null;
+        source?: (S['SessionSource'])[] | null;
         author_id?: (number)[] | null;
         config_id?: (string)[] | null;
         session_ids?: (string)[] | null;
         repo?: string | null;
-        status?: (S['AgentSessionStatus'])[] | null;
+        status?: (S['SessionStatus'])[] | null;
         start?: string | null;
         end?: string | null;
         limit?: number;
@@ -800,10 +815,13 @@ declare class EllipsisSessions {
      *
      * Start a cloud agent session.
      *
-     * Provide at most one of config_id, config, or template_id; with
-     * none, the account's default-config ladder resolves the config.
-     * 400 when idle_start is combined with prompt or handoff, or when
-     * a handoff is combined with any config source or override.
+     * Provide at most one of config_id (an id or an agent name),
+     * config, or
+     * template_id; with none, the account's default-config ladder
+     * resolves the config. 400 when idle_start is combined with
+     * prompt, input, or handoff, or when a handoff is combined with
+     * any config source or override. 422 when the agent declares an
+     * input schema and the request's input is absent or invalid.
      */
     start(options?: {
         config?: S['AgentConfig'] | null;
@@ -813,6 +831,7 @@ declare class EllipsisSessions {
         force_rebuild?: boolean;
         handoff?: S['HandoffAgentSessionParams'] | null;
         idle_start?: boolean;
+        input?: Record<string, unknown> | null;
         metadata?: Record<string, string>;
         prompt?: string | null;
         repository?: string | null;

package/dist/index.js

@@ -252,9 +252,10 @@ var EllipsisAgentsConfigs = class {
    * Create an agent config via pull request.
    *
    * The PR adds the config file to agents/ on the target
-   * repository.
+   * repository; the agent goes live when it merges.
    *
-   * Accepts an inline config or a gallery template slug.
+   * Accepts an inline config or a gallery template slug. 409 when
+   * another live agent already holds the name.
    */
   async create(options) {
     const path = "/agents/configs";
@@ -264,7 +265,7 @@ var EllipsisAgentsConfigs = class {
   /**
    * Get Agent Config
    *
-   * Return one saved agent config by id.
+   * Return one saved agent config, by id or by the agent's name.
    */
   async get(config_id) {
     const path = `/agents/configs/${enc(config_id)}`;
@@ -320,7 +321,8 @@ var EllipsisAgentsDefaults = class {
    * Set a default agent config.
    *
    * Addressed by rung: the account rung (repository omitted) or a
-   * repository rung ("owner/name").
+   * repository rung ("owner/name"); the config by id or by the
+   * agent's name.
    *
    * Refused for sandbox tokens (potentially prompt-injected code
    * must not repoint the account's ambient default); an unknown or
@@ -930,6 +932,24 @@ var EllipsisSessions = class {
     const path = `/sessions/${enc(session_id)}/executions`;
     return await this.transport.request("GET", path);
   }
+  /**
+   * Export Agent Session
+   *
+   * Export the complete session history.
+   *
+   * The complete, ordered history of the session (agent output, tool calls, thinking,
+   * lifecycle events, sandbox output, message events) as an ordered
+   * manifest of presigned segment URLs.
+   *
+   * Segments are gzip members: download in order and concatenate
+   * for one file. The JSON API never carries the bytes (same
+   * two-step as files). /records is the paged live view of the
+   * same data.
+   */
+  async export(session_id) {
+    const path = `/sessions/${enc(session_id)}/export`;
+    return await this.transport.request("GET", path);
+  }
   /**
    * Get Agent Session
    *
@@ -983,8 +1003,9 @@ var EllipsisSessions = class {
    *
    * List cloud agent sessions, newest first.
    *
-   * Optionally filtered by config, source, time window, attributed
-   * author, repository, and whether the session is still going.
+   * Optionally filtered by config (id or `ellipsis.name`), source, time
+   * window, attributed author, repository, and whether the session is
+   * still going.
    */
   async list(options = {}) {
     const path = "/sessions";
@@ -997,22 +1018,19 @@ var EllipsisSessions = class {
     );
   }
   /**
-   * Get Agent Session Log
-   *
-   * Download the complete session log.
+   * Get Agent Session Output
    *
-   * The complete, ordered history of the session (agent output, tool calls, thinking,
-   * lifecycle events, sandbox output, message events) as an ordered
-   * manifest of presigned segment URLs.
+   * Return the session's typed output.
    *
-   * Segments are gzip members: download in order and concatenate
-   * for one file. The JSON API never carries the bytes (same
-   * two-step as files). /records is the paged live view of the
-   * same data.
+   * The payload the agent submitted through its config-declared
+   * output.json_schema, as the raw JSON body with no envelope. 404
+   * while the session is still running (poll GET /sessions/{id}),
+   * when the agent declares no output block, or when no execution
+   * produced output.
    */
-  async log(session_id) {
-    const path = `/sessions/${enc(session_id)}/log`;
-    return await this.transport.request("GET", path);
+  async output(session_id) {
+    const path = `/sessions/${enc(session_id)}/output`;
+    await this.transport.request("GET", path);
   }
   /**
    * Get Agent Session Port
@@ -1103,14 +1121,17 @@ var EllipsisSessions = class {
    *
    * Start a cloud agent session.
    *
-   * Provide at most one of config_id, config, or template_id; with
-   * none, the account's default-config ladder resolves the config.
-   * 400 when idle_start is combined with prompt or handoff, or when
-   * a handoff is combined with any config source or override.
+   * Provide at most one of config_id (an id or an agent name),
+   * config, or
+   * template_id; with none, the account's default-config ladder
+   * resolves the config. 400 when idle_start is combined with
+   * prompt, input, or handoff, or when a handoff is combined with
+   * any config source or override. 422 when the agent declares an
+   * input schema and the request's input is absent or invalid.
    */
   async start(options = {}) {
     const path = "/sessions";
-    const body = buildBody({ config: options.config, config_id: options.config_id, config_override: options.config_override, config_override_yaml: options.config_override_yaml, force_rebuild: options.force_rebuild, handoff: options.handoff, idle_start: options.idle_start, metadata: options.metadata, prompt: options.prompt, repository: options.repository, template_id: options.template_id });
+    const body = buildBody({ config: options.config, config_id: options.config_id, config_override: options.config_override, config_override_yaml: options.config_override_yaml, force_rebuild: options.force_rebuild, handoff: options.handoff, idle_start: options.idle_start, input: options.input, metadata: options.metadata, prompt: options.prompt, repository: options.repository, template_id: options.template_id });
     return await this.transport.request("POST", path, { body });
   }
   /**

package/dist/store/index.d.ts

@@ -1,4 +1,4 @@
-import { M as SessionRecord, v as Session, I as SessionMessage, X as StreamFrame } from '../types-Dx0e0Qs_.js';
+import { K as SessionRecord, r as Session, x as SessionMessage, X as StreamFrame } from '../types-CStmnKVu.js';
 
 interface ChatToolNode {
     key: string;

package/dist/stream/index.d.ts

@@ -1,4 +1,4 @@
-import { X as StreamFrame, v as Session } from '../types-Dx0e0Qs_.js';
+import { X as StreamFrame, r as Session } from '../types-CStmnKVu.js';
 
 declare const SESSION_STREAM_PROTOCOL_VERSION = 3;
 declare const WS_CLOSE_NORMAL = 1000;