@ellipsis-dev/sdk 0.18.0 → 0.19.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { c as components } from './types-BLSh1Px1.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-BLSh1Px1.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,107 +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 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 templates: EllipsisAgentsTemplates;
-    constructor(transport: Transport);
-}
 declare class EllipsisAlerts {
     private readonly transport;
     constructor(transport: Transport);
@@ -237,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']>;
     /**
@@ -297,6 +196,98 @@ declare class EllipsisAuth {
     readonly cli: EllipsisAuthCli;
     constructor(transport: Transport);
 }
+declare class EllipsisAutomations {
+    private readonly transport;
+    constructor(transport: Transport);
+    /**
+     * Create Automation
+     *
+     * 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.
+     *
+     * 409 when another live automation already holds the name.
+     */
+    create(options: {
+        automation: S['AgentConfig'];
+    }): Promise<S['AutomationResponse']>;
+    /**
+     * Delete Automation
+     *
+     * Delete an automation, by id or by 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.
+     */
+    delete(automation_id: string): Promise<void>;
+    /**
+     * Get Automation
+     *
+     * Return one automation, by id or by name.
+     */
+    get(automation_id: string): Promise<S['AutomationResponse']>;
+    /**
+     * Link Automation
+     *
+     * 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.
+     */
+    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;
     constructor(transport: Transport);
@@ -483,7 +474,7 @@ declare class EllipsisIntegrations {
      *
      * 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.
@@ -734,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;
@@ -822,23 +813,24 @@ declare class EllipsisSessions {
      *
      * Start a cloud agent session.
      *
-     * The base is `from_config_id` (an id or an agent name) or, omitted,
-     * the bare ad-hoc config; every AgentConfig key on the request
-     * deep-merges on top, so the body is both the pointer and the
-     * per-session override. `prompt` is the first message; omit it and
-     * the session starts idle, waiting for one. 400 when
-     * ellipsis.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?: {
-        budget?: S['AgentConfigBudget'] | null;
+        budget?: number | null;
         claude?: S['AgentConfigClaude'] | null;
         codex?: S['AgentConfigCodex'] | null;
-        ellipsis?: S['StartSessionEllipsis'];
         environment?: string | S['AgentConfigEnvironment'] | null;
-        from_config_id?: string | null;
-        input?: Record<string, unknown> | null;
+        force_rebuild?: boolean;
+        interactive?: boolean;
+        metadata?: Record<string, string>;
         output?: S['AgentConfigOutput'] | null;
         permissions?: S['AgentConfigPermissions'] | null;
         prompt?: string | null;
@@ -858,43 +850,67 @@ declare class EllipsisSessions {
     /** A handle over an existing session. */
     handle(sessionId: string): Promise<SessionHandle>;
 }
-declare class EllipsisSettingsSessions {
+declare class EllipsisSettingsOrganization {
     private readonly transport;
     constructor(transport: Transport);
     /**
-     * Get Session Defaults
+     * Get Organization Settings
      *
-     * Get the account-wide session defaults.
+     * Get the organization settings.
      *
-     * Today one setting: the default model every session falls back to
-     * when neither its request nor its agent config names one.
+     * 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.
      */
-    getDefaults(): Promise<S['SessionDefaults']>;
+    get(): Promise<S['OrganizationSettings']>;
     /**
-     * Set Session Defaults
+     * Set Organization Settings
      *
-     * Set the account-wide session defaults.
+     * Set the organization settings.
      *
-     * `model` accepts an alias or canonical id and is stored canonical;
-     * null clears it (sessions then fall back to the platform default).
+     * 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 account's default model).
+     * not repoint the organization's defaults).
      */
-    setDefaults(options?: {
-        model?: string | null;
-    }): Promise<S['SessionDefaults']>;
+    set(options?: {
+        budget_ceiling?: S['BudgetCeiling'];
+        default_environment?: string | null;
+        default_model?: string | null;
+    }): Promise<S['OrganizationSettings']>;
 }
 declare class EllipsisSettings {
     private readonly transport;
-    readonly sessions: EllipsisSettingsSessions;
+    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;
@@ -904,6 +920,7 @@ declare class Ellipsis {
     readonly secrets: EllipsisSecrets;
     readonly sessions: EllipsisSessions;
     readonly settings: EllipsisSettings;
+    readonly templates: EllipsisTemplates;
     constructor(options: TransportOptions);
     /**
      * Get Budget