@ellipsis-dev/sdk 0.10.0 → 0.11.0

package/dist/{types-BME-7Lbt.d.ts → types-DDQQ1Yfh.d.ts}

@@ -14,10 +14,13 @@ interface paths {
         put?: never;
         /**
          * Create Agent Config
-         * @description Create an agent config via pull request.
+         * @description Create an agent config.
          *
-         *     The PR adds the config file to agents/ on the target
-         *     repository; the agent goes live when it merges.
+         *     Name a repository and Ellipsis opens a pull request adding the
+         *     config file to agents/ there; the agent goes live when it
+         *     merges. Omit it and the agent is created here, with no file,
+         *     live immediately — and every file reference in it must name the
+         *     repository it lives in.
          *
          *     Accepts an inline config or a gallery template slug. 409 when
          *     another live agent already holds the name.
@@ -41,8 +44,75 @@ interface paths {
          * @description Return one saved agent config, by id or by the agent's name.
          */
         get: operations['get_agent_config'];
-        put?: never;
+        /**
+         * Update Agent Config
+         * @description 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.
+         */
+        put: operations['update_agent_config'];
         post?: never;
+        /**
+         * Delete Agent Config
+         * @description 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: operations['delete_agent_config'];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    '/agents/configs/{config_id}/link': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Link Agent Config
+         * @description 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.
+         */
+        post: operations['link_agent_config'];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    '/agents/configs/{config_id}/unlink': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Unlink Agent Config
+         * @description 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.
+         */
+        post: operations['unlink_agent_config'];
         delete?: never;
         options?: never;
         head?: never;
@@ -1807,6 +1877,7 @@ interface components {
         AgentConfigSystemFileRef: {
             /** File */
             file: string;
+            repository?: components['schemas']['AgentConfigRepository'] | null;
         };
         /**
          * AgentConfigsListResponse
@@ -2397,6 +2468,8 @@ interface components {
              * @description The last commit the config was synced from.
              */
             last_synced_commit_sha?: string | null;
+            /** @description 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. */
+            managed_by: components['schemas']['ConfigManagedBy'];
             /**
              * Name
              * @description The agent's customer-unique addressable name (a slug of its display name); usable anywhere an agent is referenced, interchangeably with the id.
@@ -2419,6 +2492,14 @@ interface components {
              */
             updated_at: string;
         };
+        /**
+         * ConfigManagedBy
+         * @description Which writer owns an agent: the repository file it is defined in, or
+         *     this API. Every agent has exactly one owner, fixed when it is created and
+         *     changed only by linking or unlinking it.
+         * @enum {string}
+         */
+        ConfigManagedBy: 'github' | 'api';
         /**
          * ContributorUsage
          * @description An author who merged a pull request in the window. The pull-request and
@@ -2464,22 +2545,22 @@ interface components {
         };
         /**
          * CreateAgentConfigRequest
-         * @description Parameters for creating an agent config via a pull request. Exactly
-         *     one of config or template_id must be set.
+         * @description Parameters for creating an agent config. Exactly one of config or
+         *     template_id must be set.
          */
         CreateAgentConfigRequest: {
             /** @description An inline agent config. */
             config?: components['schemas']['AgentConfig'] | null;
             /**
              * Path
-             * @description File path within the repo. Omit for the default agents/<slug>.yaml; if set it must be a location the config sync scans (a .yaml/.yml file under agents/, .agents/, ellipsis/, or .ellipsis/ at any depth).
+             * @description File path within the repo, when a repository is named. Omit for the default agents/<slug>.yaml; if set it must be a location the config sync scans (a .yaml/.yml file under agents/, .agents/, ellipsis/, or .ellipsis/ at any depth).
              */
             path?: string | null;
             /**
              * Repository
-             * @description Target repository name within the caller's account; the owner is always the account, so pass a bare name (e.g. "my-service"), not "owner/my-service".
+             * @description Define the agent as a file in this repository: Ellipsis opens a pull request adding it, and the agent goes live when that merges. Repository name within the caller's account; the owner is always the account, so pass a bare name (e.g. "my-service"), not "owner/my-service". Omit to create the agent through the API alone, with no file and live immediately.
              */
-            repository: string;
+            repository?: string | null;
             /**
              * Template Id
              * @description A gallery template slug (see GET /agents/templates).
@@ -2488,21 +2569,22 @@ interface components {
         };
         /**
          * CreateAgentConfigResponse
-         * @description The created agent config and the pull request that adds its file.
+         * @description The created agent config, plus the pull request that adds its file when
+         *     one was opened.
          */
         CreateAgentConfigResponse: {
             /** @description The created agent config. */
             config: components['schemas']['Config'];
             /**
              * Path
-             * @description The file path the config was written to.
+             * @description The file path the config was written to, or null when the agent has no file.
              */
-            path: string;
+            path?: string | null;
             /**
              * Pull Request Url
-             * @description The pull request that adds the config file. The agent becomes live once it merges and syncs.
+             * @description The pull request that adds the config file. The agent becomes live once it merges and syncs. Null when no repository was named: the agent is already live.
              */
-            pull_request_url: string;
+            pull_request_url?: string | null;
         };
         /**
          * CreateFileRequest
@@ -3438,6 +3520,40 @@ interface components {
              */
             teams: components['schemas']['LinearTeam'][];
         };
+        /**
+         * LinkAgentConfigRequest
+         * @description Where to put the config file of an agent being moved into a repository.
+         */
+        LinkAgentConfigRequest: {
+            /**
+             * Path
+             * @description File path within the repo. Omit for the default agents/<slug>.yaml; if set it must be a location the config sync scans (a .yaml/.yml file under agents/, .agents/, ellipsis/, or .ellipsis/ at any depth).
+             */
+            path?: string | null;
+            /**
+             * Repository
+             * @description Repository name within the caller's account; the owner is always the account, so pass a bare name (e.g. "my-service"), not "owner/my-service".
+             */
+            repository: string;
+        };
+        /**
+         * LinkAgentConfigResponse
+         * @description The agent and the pull request that would put it in a repository.
+         */
+        LinkAgentConfigResponse: {
+            /** @description The agent, still managed through the API until the pull request merges. */
+            config: components['schemas']['Config'];
+            /**
+             * Path
+             * @description The file path the config will be written to.
+             */
+            path: string;
+            /**
+             * Pull Request Url
+             * @description The pull request that adds the config file. The agent becomes managed by that file once it merges.
+             */
+            pull_request_url: string;
+        };
         /**
          * LinkedGithubIdentity
          * @description The GitHub identity linked to a Slack member.
@@ -6377,6 +6493,14 @@ interface components {
             /** Skipped */
             skipped: number;
         };
+        /**
+         * UpdateAgentConfigRequest
+         * @description A replacement definition for an agent managed through the API.
+         */
+        UpdateAgentConfigRequest: {
+            /** @description The agent's new definition. Replaces the previous one wholesale — this is not a partial update. */
+            config: components['schemas']['AgentConfig'];
+        };
         /**
          * UsageDailyPoint
          * @description One day's usage: tokens split by type, and cost split into the four
@@ -6622,7 +6746,7 @@ interface operations {
                     'application/json': components['schemas']['ErrorResponse'];
                 };
             };
-            /** @description The agent's name contains no usable characters. */
+            /** @description The agent's name contains no usable characters, or a file reference names no repository. */
             422: {
                 headers: {
                     [name: string]: unknown;
@@ -6693,6 +6817,306 @@ interface operations {
             };
         };
     };
+    update_agent_config: {
+        parameters: {
+            query?: never;
+            header?: {
+                'user-agent'?: string | null;
+            };
+            path: {
+                config_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                'application/json': components['schemas']['UpdateAgentConfigRequest'];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['AgentConfigResponse'];
+                };
+            };
+            /** @description The config is invalid (for example an unschedulable cron expression). */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['ErrorResponse'];
+                };
+            };
+            /** @description The bearer token is missing, invalid, or revoked. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['ErrorResponse'];
+                };
+            };
+            /** @description The credential may not perform this action, or the account is blocked. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['ErrorResponse'];
+                };
+            };
+            /** @description No such config in your account. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['ErrorResponse'];
+                };
+            };
+            /** @description The agent is defined by a file in a repository, or another live agent already holds the new name. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['ErrorResponse'];
+                };
+            };
+            /** @description The agent's name is missing or malformed, or a file reference names no repository. */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['ErrorResponse'];
+                };
+            };
+        };
+    };
+    delete_agent_config: {
+        parameters: {
+            query?: never;
+            header?: {
+                'user-agent'?: string | null;
+            };
+            path: {
+                config_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description The bearer token is missing, invalid, or revoked. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['ErrorResponse'];
+                };
+            };
+            /** @description The credential may not perform this action, or the account is blocked. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['ErrorResponse'];
+                };
+            };
+            /** @description No such config in your account. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['ErrorResponse'];
+                };
+            };
+            /** @description The agent is defined by a file in a repository; delete that file instead. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['ErrorResponse'];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['HTTPValidationError'];
+                };
+            };
+        };
+    };
+    link_agent_config: {
+        parameters: {
+            query?: never;
+            header?: {
+                'user-agent'?: string | null;
+            };
+            path: {
+                config_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                'application/json': components['schemas']['LinkAgentConfigRequest'];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['LinkAgentConfigResponse'];
+                };
+            };
+            /** @description The path is not a synced config location, or the repository has no commits. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['ErrorResponse'];
+                };
+            };
+            /** @description The bearer token is missing, invalid, or revoked. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['ErrorResponse'];
+                };
+            };
+            /** @description The credential may not perform this action, or the account is blocked. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['ErrorResponse'];
+                };
+            };
+            /** @description The config or repository was not found in your account. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['ErrorResponse'];
+                };
+            };
+            /** @description The agent is already defined by a file, a link is already open for it, a file already exists at that path, or another agent syncs from it. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['ErrorResponse'];
+                };
+            };
+            /** @description GitHub rejected the pull request. */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['ErrorResponse'];
+                };
+            };
+        };
+    };
+    unlink_agent_config: {
+        parameters: {
+            query?: never;
+            header?: {
+                'user-agent'?: string | null;
+            };
+            path: {
+                config_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['AgentConfigResponse'];
+                };
+            };
+            /** @description The bearer token is missing, invalid, or revoked. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['ErrorResponse'];
+                };
+            };
+            /** @description The credential may not perform this action, or the account is blocked. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['ErrorResponse'];
+                };
+            };
+            /** @description No such config in your account. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['ErrorResponse'];
+                };
+            };
+            /** @description The agent is already managed through the API. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['ErrorResponse'];
+                };
+            };
+            /** @description The config has a file reference that names no repository, so it cannot resolve without its source repository. */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['ErrorResponse'];
+                };
+            };
+        };
+    };
     list_agent_defaults: {
         parameters: {
             query?: never;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ellipsis-dev/sdk",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "TypeScript SDK for the Ellipsis agents platform: /v1 REST types + client, the session stream WebSocket client, and the session transcript store.",
   "license": "MIT",
   "type": "module",