@ellipsis-dev/sdk 0.17.0 → 0.19.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { c as components } from './types--VF0yCc1.js';
-export { A as AgentConfigSource, a as AttributionType, B as BudgetSource, C as ClaudeSessionRecord, b as CodexEvent, d as CodexItem, e as CodexSessionRecord, f as CreateReviewRequest, D as DeltaFrame, g as DoneFrame, E as ErrorFrame, F as Finding, G as GithubAccountSnippet, h as GithubAccountType, H as Harness, i as HeartbeatFrame, L as LifecycleSessionRecord, 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 SdkAssistantRecord, v as SdkContentBlock, w as SdkRateLimitRecord, x as SdkRecord, y as SdkResultRecord, z as SdkSystemRecord, I as SdkUserRecord, J as SendSessionMessageRequest, K as Session, M as SessionExecution, N as SessionExecutionsListResponse, O as SessionExitStatus, Q as SessionFrame, T as SessionGit, U as SessionLiveness, V as SessionMessage, W as SessionMessageResponse, X as SessionMessageStatus, Y as SessionPrompting, Z as SessionRecord, _ as SessionRecordsListResponse, $ as SessionResponse, a0 as SessionSource, a1 as SessionState, a2 as SessionStatus, a3 as SessionStreamFrame, a4 as SessionSurface, a5 as SessionsListResponse, a6 as SnapshotFrame, a7 as StreamFrame, a8 as TokensInfo, a9 as paths } from './types--VF0yCc1.js';
+import { c as components } from './types-D2YZTvgg.js';
+export { A as AgentConfigSource, a as AttributionType, B as BudgetSource, C as ClaudeSessionRecord, b as CodexEvent, d as CodexItem, e as CodexSessionRecord, f as CreateReviewRequest, D as DeltaFrame, g as DoneFrame, E as ErrorFrame, F as Finding, G as GithubAccountSnippet, h as GithubAccountType, H as Harness, i as HeartbeatFrame, L as LifecycleSessionRecord, 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 SdkAssistantRecord, v as SdkContentBlock, w as SdkRateLimitRecord, x as SdkRecord, y as SdkResultRecord, z as SdkSystemRecord, I as SdkUserRecord, J as SendSessionMessageRequest, K as Session, M as SessionExecution, N as SessionExecutionsListResponse, O as SessionExitStatus, Q as SessionFrame, T as SessionGit, U as SessionLiveness, V as SessionMessage, W as SessionMessageResponse, X as SessionMessageStatus, Y as SessionPrompting, Z as SessionRecord, _ as SessionRecordsListResponse, $ as SessionResponse, a0 as SessionSource, a1 as SessionState, a2 as SessionStatus, a3 as SessionStreamFrame, a4 as SessionSurface, a5 as SessionsListResponse, a6 as SnapshotFrame, a7 as StreamFrame, a8 as TokensInfo, a9 as paths } from './types-D2YZTvgg.js';
 
 interface CursorResponse {
     has_more: boolean;
@@ -69,152 +69,6 @@ declare class Transport {
 }
 
 type S = components['schemas'];
-declare class EllipsisAgentsConfigs {
-    private readonly transport;
-    constructor(transport: Transport);
-    /**
-     * Create Agent Config
-     *
-     * Create an agent config, managed through the API: no file, live
-     * immediately. To put its definition in a repository instead, create
-     * it here and then POST /v1/agents/configs/{config_id}/link.
-     *
-     * 409 when another live agent already holds the name.
-     */
-    create(options: {
-        config: S['AgentConfig'];
-    }): Promise<S['AgentConfigResponse']>;
-    /**
-     * Delete Agent Config
-     *
-     * Delete an agent, by id or by the agent's name.
-     *
-     * The agent stops running and its name is freed immediately; its
-     * past sessions remain readable. Only for agents managed through
-     * this API — delete the file to remove one defined by a
-     * repository.
-     */
-    delete(config_id: string): Promise<void>;
-    /**
-     * Get Agent Config
-     *
-     * Return one saved agent config, by id or by the agent's name.
-     */
-    get(config_id: string): Promise<S['AgentConfigResponse']>;
-    /**
-     * Link Agent Config
-     *
-     * Move an agent into a repository, by id or by the agent's name.
-     *
-     * Opens a pull request adding the agent's config file. The agent
-     * keeps running unchanged meanwhile; merging hands it over to the
-     * file, after which the file is what changes it. Nothing happens
-     * if the pull request is never merged.
-     */
-    link(config_id: string, options: {
-        path?: string | null;
-        repository: string;
-    }): Promise<S['LinkAgentConfigResponse']>;
-    /**
-     * List Agent Configs
-     *
-     * List saved agent configs.
-     */
-    list(): Promise<S['AgentConfigsListResponse']>;
-    /**
-     * Unlink Agent Config
-     *
-     * Take over an agent from its file, by id or by the agent's name.
-     *
-     * The file stops governing the agent immediately and further
-     * changes go through this API. The file is left in place, inert —
-     * delete it whenever you like.
-     */
-    unlink(config_id: string): Promise<S['AgentConfigResponse']>;
-    /**
-     * Update Agent Config
-     *
-     * Replace an agent's definition, by id or by the agent's name.
-     *
-     * The whole definition is replaced, and the change is live at
-     * once. Only for agents managed through this API: one defined by a
-     * repository file is a 409, since the next push to that file would
-     * revert the change — unlink it first to take ownership.
-     */
-    update(config_id: string, options: {
-        config: S['AgentConfig'];
-    }): Promise<S['AgentConfigResponse']>;
-}
-declare class EllipsisAgentsDefaults {
-    private readonly transport;
-    constructor(transport: Transport);
-    /**
-     * Delete Agent Default
-     *
-     * Clear a default agent config.
-     *
-     * Addressed by rung: the account rung (repository omitted) or a
-     * repository rung.
-     *
-     * Refused for sandbox tokens.
-     */
-    delete(options?: {
-        repository?: string | null;
-    }): Promise<void>;
-    /**
-     * List Agent Defaults
-     *
-     * Get the default agent configs.
-     *
-     * The account-wide default and the per-repository defaults, as config
-     * ids. Repo rungs are keyed "owner/name"; a repository this
-     * installation can no longer see is omitted.
-     */
-    list(): Promise<S['AgentDefaults']>;
-    /**
-     * Put Agent Default
-     *
-     * Set a default agent config.
-     *
-     * Addressed by rung: the account rung (repository omitted) or a
-     * repository rung ("owner/name"); the config by id or by the
-     * agent's name. Returns the full resulting ladder.
-     *
-     * Refused for sandbox tokens (potentially prompt-injected code
-     * must not repoint the account's ambient default); an unknown or
-     * foreign repository is a 404.
-     */
-    set(options: {
-        config_id: string;
-        repository?: string | null;
-    }): Promise<S['AgentDefaults']>;
-}
-declare class EllipsisAgentsTemplates {
-    private readonly transport;
-    constructor(transport: Transport);
-    /**
-     * Get Agent Template
-     *
-     * Return one built-in agent template by slug.
-     */
-    get(template_id: string): Promise<S['AgentTemplate']>;
-    /**
-     * List Agent Templates
-     *
-     * List the built-in starter agent templates.
-     *
-     * Behind auth but not account-scoped — the data is static
-     * product content shared by the dashboard, landing site, and CLI.
-     */
-    list(): Promise<S['AgentTemplatesListResponse']>;
-}
-declare class EllipsisAgents {
-    private readonly transport;
-    readonly configs: EllipsisAgentsConfigs;
-    readonly defaults: EllipsisAgentsDefaults;
-    readonly templates: EllipsisAgentsTemplates;
-    constructor(transport: Transport);
-}
 declare class EllipsisAlerts {
     private readonly transport;
     constructor(transport: Transport);
@@ -282,15 +136,15 @@ declare class EllipsisAnalytics {
      * Return pull-request analytics.
      *
      * Windowing: pass explicit start/end, or days (default: the last
-     * 30 days).
+     * 30 days). account_type in all|user|bot scopes the authors.
      */
     pullRequests(options?: {
         days?: number | null;
         start?: string | null;
         end?: string | null;
-        account_type?: (string)[] | null;
-        repository_id?: (number)[] | null;
-        author_id?: (number)[] | null;
+        repo?: (string)[] | null;
+        author?: (string)[] | null;
+        account_type?: string;
         status?: (string)[] | null;
     }): Promise<S['GetAnalyticsPullRequestsResponse']>;
     /**
@@ -342,46 +196,100 @@ declare class EllipsisAuth {
     readonly cli: EllipsisAuthCli;
     constructor(transport: Transport);
 }
-declare class EllipsisEnvironmentsDefaults {
+declare class EllipsisAutomations {
     private readonly transport;
     constructor(transport: Transport);
     /**
-     * Delete Environment Default
+     * Create Automation
      *
-     * Clear a default environment.
+     * Create an automation, managed through the API: no file, live
+     * immediately. To put its definition in a repository instead, create
+     * it here and then POST /v1/automations/{automation_id}/link.
      *
-     * Addressed by rung: the account rung (repository omitted) or a
-     * repository rung. Refused for sandbox tokens.
+     * 409 when another live automation already holds the name.
      */
-    delete(options?: {
-        repository?: string | null;
-    }): Promise<void>;
+    create(options: {
+        automation: S['AgentConfig'];
+    }): Promise<S['AutomationResponse']>;
     /**
-     * List Environment Defaults
+     * Delete Automation
      *
-     * Get the default environments.
+     * Delete an automation, by id or by name.
      *
-     * The account-wide default and the per-repository defaults, as
-     * environment ids. Repo rungs are keyed "owner/name".
+     * It stops running and its name is freed immediately; its past
+     * sessions remain readable. Only for automations managed through
+     * this API — delete the file to remove one defined by a repository.
      */
-    list(): Promise<S['EnvironmentDefaults']>;
+    delete(automation_id: string): Promise<void>;
     /**
-     * Put Environment Default
+     * Get Automation
      *
-     * Set a default environment.
+     * Return one automation, by id or by name.
+     */
+    get(automation_id: string): Promise<S['AutomationResponse']>;
+    /**
+     * Link Automation
      *
-     * Addressed by rung: the account rung (repository omitted) or a
-     * repository rung ("owner/name"); the environment by id or name.
-     * Returns the full resulting ladder. Refused for sandbox tokens.
+     * Move an automation into a repository, by id or by name.
+     *
+     * Opens a pull request adding its definition file. The automation
+     * keeps running unchanged meanwhile; merging hands it over to the
+     * file, after which the file is what changes it. Nothing happens
+     * if the pull request is never merged.
      */
-    set(options: {
-        environment: string;
-        repository?: string | null;
-    }): Promise<S['EnvironmentDefaults']>;
+    link(automation_id: string, options: {
+        path?: string | null;
+        repository: string;
+    }): Promise<S['LinkAutomationResponse']>;
+    /**
+     * List Automations
+     *
+     * List automations.
+     */
+    list(): Promise<S['AutomationsListResponse']>;
+    /**
+     * Start Automation Session
+     *
+     * Invoke an automation.
+     *
+     * Runs the automation exactly as defined — its persona, model,
+     * environment, permissions, skills, and budget bind — and returns
+     * the session it started. The body carries only what a caller may
+     * supply: the typed `input` its schema demands, an optional tighter
+     * `budget`, and `metadata`. For a different persona or environment,
+     * start a raw session with POST /v1/sessions instead.
+     */
+    run(automation_id: string, options?: {
+        budget?: number | null;
+        input?: Record<string, unknown> | null;
+        metadata?: Record<string, string>;
+    }): Promise<S['SessionResponse']>;
+    /**
+     * Unlink Automation
+     *
+     * Take over an automation from its file, by id or by name.
+     *
+     * The file stops governing it immediately and further changes go
+     * through this API. The file is left in place, inert — delete it
+     * whenever you like.
+     */
+    unlink(automation_id: string): Promise<S['AutomationResponse']>;
+    /**
+     * Update Automation
+     *
+     * Replace an automation's definition, by id or by name.
+     *
+     * The whole definition is replaced, and the change is live at
+     * once. Only for automations managed through this API: one defined
+     * by a repository file is a 409, since the next push to that file
+     * would revert the change — unlink it first to take ownership.
+     */
+    update(automation_id: string, options: {
+        automation: S['AgentConfig'];
+    }): Promise<S['AutomationResponse']>;
 }
 declare class EllipsisEnvironments {
     private readonly transport;
-    readonly defaults: EllipsisEnvironmentsDefaults;
     constructor(transport: Transport);
     /**
      * Create Environment
@@ -560,13 +468,13 @@ declare class EllipsisIntegrations {
     readonly slack: EllipsisIntegrationsSlack;
     constructor(transport: Transport);
     /**
-     * Get Integrations
+     * List Integrations
      *
      * List connected integrations.
      *
      * A read-only view, so an agent authoring another agent's
      * config can learn which repositories, channels, teams, and
-     * organizations it may name before POST /agents/configs.
+     * organizations it may name before POST /automations.
      *
      * Available to all credential types including sandbox tokens: the
      * responses never include OAuth tokens or any other secret.
@@ -741,7 +649,7 @@ declare class EllipsisSecrets {
      */
     list(): Promise<S['SecretsListResponse']>;
     /**
-     * Put Secrets
+     * Set Secrets
      *
      * Upsert secrets.
      *
@@ -767,8 +675,7 @@ declare class EllipsisSessions {
      * instructions + the config's own instructions).
      *
      * Per execution because each cold wake persists its own launch
-     * config (a config edit or replay override between wakes changes
-     * it).
+     * config (a config edit between wakes changes it).
      */
     executions(session_id: string): Promise<S['SessionExecutionsListResponse']>;
     /**
@@ -818,12 +725,12 @@ declare class EllipsisSessions {
      *
      * List cloud agent sessions, newest first.
      *
-     * Optionally filtered by config (id or `ellipsis.name`), source, time
+     * Optionally filtered by automation (id or name), source, time
      * window, attributed author, repository, and whether the session is
      * still going.
      */
     list(options?: {
-        config_id?: string | null;
+        automation?: string | null;
         source?: (S['SessionSource'])[] | null;
         days?: number | null;
         start?: string | null;
@@ -862,22 +769,7 @@ declare class EllipsisSessions {
         limit?: number | null;
     }): Promise<Page<S['ClaudeSessionRecord'] | S['CodexSessionRecord'] | S['LifecycleSessionRecord'], S['SessionRecordsListResponse']>>;
     /**
-     * Replay Agent Session
-     *
-     * Replay a session as a new session.
-     *
-     * Reuses the original config snapshot unless config_id is given,
-     * and accepts the same config_override as session start — e.g.
-     * {"claude": {"model": ...}} to replay the same input on a
-     * different model.
-     */
-    replay(session_id: string, options?: {
-        config_id?: string | null;
-        override?: Record<string, unknown> | null;
-        prompt?: string | null;
-    }): Promise<S['SessionResponse']>;
-    /**
-     * Search Sessions
+     * Search Agent Sessions
      *
      * Search sessions over steps, recaps, and pull requests.
      *
@@ -921,25 +813,28 @@ declare class EllipsisSessions {
      *
      * Start a cloud agent session.
      *
-     * Provide at most one of config_id (an id or an agent name) or
-     * config; with neither, the account's default-config ladder
-     * resolves the config. `prompt` is the first message; omit it and
-     * the session starts idle, waiting for one. 400 when
-     * interactive=false and there is no prompt or input. 422 when the
-     * agent declares an input schema and the request's input is absent
-     * or invalid.
+     * The daily driver: a prompt, optionally where to run it
+     * (`environment`) and the run's own settings, in the AgentConfig
+     * vocabulary. Anything omitted comes from the organization's
+     * settings — default model, default environment, budget — so
+     * `{"prompt": "..."}` alone is a complete request. `prompt` is the
+     * first message; omit it and the session starts idle, waiting for
+     * one. 400 when `interactive` is false and there is no prompt, or
+     * when `budget` exceeds the organization's per-session ceiling. To
+     * run a saved automation, use POST /v1/automations/{automation_id}/sessions.
      */
     start(options?: {
-        config?: S['AgentConfig'] | null;
-        config_id?: string | null;
-        environment?: string | null;
+        budget?: number | null;
+        claude?: S['AgentConfigClaude'] | null;
+        codex?: S['AgentConfigCodex'] | null;
+        environment?: string | S['AgentConfigEnvironment'] | null;
         force_rebuild?: boolean;
-        input?: Record<string, unknown> | null;
         interactive?: boolean;
         metadata?: Record<string, string>;
-        override?: Record<string, unknown> | null;
+        output?: S['AgentConfigOutput'] | null;
+        permissions?: S['AgentConfigPermissions'] | null;
         prompt?: string | null;
-        repository?: string | null;
+        skills?: (S['AgentConfigSkill'])[] | null;
     }): Promise<S['SessionResponse']>;
     /**
      * Stop Agent Session
@@ -955,12 +850,67 @@ declare class EllipsisSessions {
     /** A handle over an existing session. */
     handle(sessionId: string): Promise<SessionHandle>;
 }
+declare class EllipsisSettingsOrganization {
+    private readonly transport;
+    constructor(transport: Transport);
+    /**
+     * Get Organization Settings
+     *
+     * Get the organization settings.
+     *
+     * The default model and default environment every session falls
+     * back to when neither its request nor its automation names one,
+     * and the per-session budget ceiling no session may exceed.
+     */
+    get(): Promise<S['OrganizationSettings']>;
+    /**
+     * Set Organization Settings
+     *
+     * Set the organization settings.
+     *
+     * Replaces all three: `default_model` accepts an alias or canonical
+     * id and is stored canonical; `default_environment` accepts a name
+     * or `env_` id and is stored as the id; `budget_ceiling.session` is
+     * in US dollars, at most the platform ceiling. Null clears each.
+     * Refused for sandbox tokens (potentially prompt-injected code must
+     * not repoint the organization's defaults).
+     */
+    set(options?: {
+        budget_ceiling?: S['BudgetCeiling'];
+        default_environment?: string | null;
+        default_model?: string | null;
+    }): Promise<S['OrganizationSettings']>;
+}
+declare class EllipsisSettings {
+    private readonly transport;
+    readonly organization: EllipsisSettingsOrganization;
+    constructor(transport: Transport);
+}
+declare class EllipsisTemplates {
+    private readonly transport;
+    constructor(transport: Transport);
+    /**
+     * Get Agent Template
+     *
+     * Return one built-in agent template by slug.
+     */
+    get(template_id: string): Promise<S['AgentTemplate']>;
+    /**
+     * List Agent Templates
+     *
+     * List the built-in starter agent templates.
+     *
+     * Behind auth but not account-scoped — the data is static
+     * product content shared by the dashboard, landing site, and CLI.
+     */
+    list(): Promise<S['AgentTemplatesListResponse']>;
+}
 declare class Ellipsis {
     private readonly transport;
-    readonly agents: EllipsisAgents;
     readonly alerts: EllipsisAlerts;
     readonly analytics: EllipsisAnalytics;
     readonly auth: EllipsisAuth;
+    readonly automations: EllipsisAutomations;
     readonly environments: EllipsisEnvironments;
     readonly files: EllipsisFiles;
     readonly integrations: EllipsisIntegrations;
@@ -969,6 +919,8 @@ declare class Ellipsis {
     readonly reviews: EllipsisReviews;
     readonly secrets: EllipsisSecrets;
     readonly sessions: EllipsisSessions;
+    readonly settings: EllipsisSettings;
+    readonly templates: EllipsisTemplates;
     constructor(options: TransportOptions);
     /**
      * Get Budget
@@ -977,13 +929,13 @@ declare class Ellipsis {
      */
     budget(): Promise<S['BudgetSummary']>;
     /**
-     * Whoami
+     * Current Identity
      *
      * Return the identity behind the caller's credential.
      */
     me(): Promise<S['WhoAmIResponse']>;
     /**
-     * Get Usage Endpoint
+     * Get Usage
      *
      * Return the caller's usage dashboard data.
      */