@deepraxis/sdk 0.1.0-dev.ff6425a → 0.1.1-dev.b176367

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -221,6 +221,85 @@ export const unblockEndUser = (options) => (options.client ?? client).post({
221
221
  url: '/agent/v1/agents/{agent_id}/end_users/{external_user_id}/unblock',
222
222
  ...options
223
223
  });
224
+ /**
225
+ * Create customer grant code
226
+ *
227
+ * Sign your logged-in customer in to a service agent from your backend with a one-time grant code that Agent Kit exchanges for a customer access token.
228
+ *
229
+ * Call this from your backend with your API key after your own login succeeds, then pass the returned code to Agent Kit in the browser; never call it from the browser. Customer authorization follows Shopify Storefront customer access tokens (Multipass-style sign-in, a short-lived token, renewal and logout), so that experience applies. customer_id is your own identifier for the customer: use an opaque id such as your database user id, not an email address or phone number. The value auth is reserved, and ids starting with anon_ are reserved for anonymous customers. The code works once and expires after expires_in seconds (default 900). The sign-in it starts lasts max_session_seconds (default 7 days); version, budget_cents, system_message, agent_override and metadata apply to every token of the sign-in. Unlike Shopify, origin binds the whole sign-in to one page origin, and anonymous_access_token merges the conversations of the anonymous visitor who chatted before signing in into this customer. Example body: {"customer_id":"cus_8f2a91","origin":"https://shop.example.com"}.
230
+ */
231
+ export const createCustomerGrantCode = (options) => (options.client ?? client).post({
232
+ security: [{
233
+ key: 'BearerAuth',
234
+ scheme: 'bearer',
235
+ type: 'http'
236
+ }, {
237
+ key: 'ApiKeyAuth',
238
+ name: 'X-API-Key',
239
+ type: 'apiKey'
240
+ }],
241
+ url: '/agent/v1/agents/{agent_id}/customers/auth/grant_codes',
242
+ ...options,
243
+ headers: {
244
+ 'Content-Type': 'application/json',
245
+ ...options.headers
246
+ }
247
+ });
248
+ /**
249
+ * Create customer access token
250
+ *
251
+ * Exchange a grant code, or the agent's publishable key for an anonymous visitor, for a customer access token that authorizes the agent's embedded sessions.
252
+ *
253
+ * No Authorization header is required: the grant code or the publishable key is the credential. Agent Kit calls this from the browser, so send the page Origin. With grant_code, the code is consumed atomically: concurrent attempts have exactly one winner, and unknown, used, expired and other-agent codes all return the same 401 GRANT_CODE_INVALID. The sign-in starts now and lasts the code's max_session_seconds. Unlike Shopify, a visitor without an account gets a token too: send publishable_key instead and a new anonymous customer (anon_…) is created, bound to the request Origin, for 7 days. The access token lasts at most two hours and never outlives the sign-in; renew it with access_tokens/renew before expires_at. Both forms share the per-IP minute limit of anonymous issuance (default 20). Example body: {"grant_code":"cgc_…"}.
254
+ */
255
+ export const createCustomerAccessToken = (options) => (options.client ?? client).post({
256
+ url: '/agent/v1/agents/{agent_id}/customers/auth/access_tokens',
257
+ ...options,
258
+ headers: {
259
+ 'Content-Type': 'application/json',
260
+ ...options.headers
261
+ }
262
+ });
263
+ /**
264
+ * Renew customer access token
265
+ *
266
+ * Get a fresh customer access token in the same sign-in, authenticated with the current one.
267
+ *
268
+ * Send the current customer access token as the Bearer credential, with no body, a few minutes before expires_at. The new token keeps the version, budget, context, metadata and origin binding of the sign-in and lasts at most two hours, never past session_expires_at. Unlike Shopify, renewal does not revoke the presented token: it stays valid until its own expiry, so a reply that is streaming on it is not cut off. When less than 60 seconds of the sign-in remain, renewal returns 401 CUSTOMER_SESSION_EXPIRED; sign the customer in again with a new grant code from your backend. A token that was logged out or merged returns 401 ACCESS_TOKEN_REVOKED.
269
+ */
270
+ export const renewCustomerAccessToken = (options) => (options.client ?? client).post({
271
+ security: [{
272
+ key: 'BearerAuth',
273
+ scheme: 'bearer',
274
+ type: 'http'
275
+ }, {
276
+ key: 'ApiKeyAuth',
277
+ name: 'X-API-Key',
278
+ type: 'apiKey'
279
+ }],
280
+ url: '/agent/v1/agents/{agent_id}/customers/auth/access_tokens/renew',
281
+ ...options
282
+ });
283
+ /**
284
+ * Log out customer
285
+ *
286
+ * Log the customer out by revoking the sign-in of the presented access token and every token issued in it.
287
+ *
288
+ * Send the current customer access token as the Bearer credential, with no body, when the customer logs out of your site. Every token of the sign-in, including renewed ones, stops working, and their live event streams close; the customer's conversations are kept. Returns 204. Calling it again with the same token returns 401 ACCESS_TOKEN_REVOKED, so treat that as already logged out.
289
+ */
290
+ export const deleteCurrentCustomerAccessToken = (options) => (options.client ?? client).delete({
291
+ security: [{
292
+ key: 'BearerAuth',
293
+ scheme: 'bearer',
294
+ type: 'http'
295
+ }, {
296
+ key: 'ApiKeyAuth',
297
+ name: 'X-API-Key',
298
+ type: 'apiKey'
299
+ }],
300
+ url: '/agent/v1/agents/{agent_id}/customers/auth/access_tokens/current',
301
+ ...options
302
+ });
224
303
  /**
225
304
  * Exchange Hosted Code
226
305
  *
@@ -316,9 +395,9 @@ export const revokeEmbedToken = (options) => (options.client ?? client).post({
316
395
  ...options
317
396
  });
318
397
  /**
319
- * ComputersList
398
+ * List Computers
320
399
  *
321
- * Tenant-owned durable computer resource.
400
+ * List the computers of your organization, archived ones included.
322
401
  *
323
402
  * Praxis extension: MA only has session-scoped temporary containers and memory_stores, not durable browsable computers. Archived files remain readable, but new sessions cannot bind them. environment_id is an optional recipe reference; computers start with a light sandbox and expose the public SDK sandbox_id. Lists include archived computers.
324
403
  */
@@ -336,9 +415,9 @@ export const computersList = (options) => (options?.client ?? client).get({
336
415
  ...options
337
416
  });
338
417
  /**
339
- * ComputersCreate
418
+ * Create Computer
340
419
  *
341
- * Tenant-owned durable computer resource.
420
+ * Create a durable computer: a named machine whose files outlive sessions, for personal agents.
342
421
  *
343
422
  * Praxis extension: MA only has session-scoped temporary containers and memory_stores, not durable browsable computers. Archived files remain readable, but new sessions cannot bind them. environment_id is an optional recipe reference; computers start with a light sandbox and expose the public SDK sandbox_id. Lists include archived computers.
344
423
  */
@@ -380,9 +459,9 @@ export const computersDelete = (options) => (options.client ?? client).delete({
380
459
  ...options
381
460
  });
382
461
  /**
383
- * ComputersRetrieve
462
+ * Get Computer
384
463
  *
385
- * Tenant-owned durable computer resource.
464
+ * Read one computer's status, storage use and sandbox id.
386
465
  *
387
466
  * Praxis extension: MA only has session-scoped temporary containers and memory_stores, not durable browsable computers. Archived files remain readable, but new sessions cannot bind them. environment_id is an optional recipe reference; computers start with a light sandbox and expose the public SDK sandbox_id. Lists include archived computers.
388
467
  */
@@ -400,9 +479,9 @@ export const computersRetrieve = (options) => (options.client ?? client).get({
400
479
  ...options
401
480
  });
402
481
  /**
403
- * ComputersUpdate
482
+ * Update Computer
404
483
  *
405
- * Tenant-owned durable computer resource.
484
+ * Rename a computer.
406
485
  *
407
486
  * Praxis extension: MA only has session-scoped temporary containers and memory_stores, not durable browsable computers. Archived files remain readable, but new sessions cannot bind them. environment_id is an optional recipe reference; computers start with a light sandbox and expose the public SDK sandbox_id. Lists include archived computers.
408
487
  */
@@ -424,9 +503,9 @@ export const computersUpdate = (options) => (options.client ?? client).post({
424
503
  }
425
504
  });
426
505
  /**
427
- * ComputersArchive
506
+ * Archive Computer
428
507
  *
429
- * Tenant-owned durable computer resource.
508
+ * Archive a computer: its files stay readable but new sessions cannot use it.
430
509
  *
431
510
  * Praxis extension: MA only has session-scoped temporary containers and memory_stores, not durable browsable computers. Archived files remain readable, but new sessions cannot bind them. environment_id is an optional recipe reference; computers start with a light sandbox and expose the public SDK sandbox_id. Lists include archived computers.
432
511
  */
@@ -469,9 +548,9 @@ export const computersAttachmentsCreate = (options) => (options.client ?? client
469
548
  }
470
549
  });
471
550
  /**
472
- * ComputersFilesList
551
+ * List Computer Files
473
552
  *
474
- * Tenant-owned durable computer resource.
553
+ * List the entries of one directory on a computer.
475
554
  *
476
555
  * Praxis extension: MA only has session-scoped temporary containers and memory_stores, not durable browsable computers. Archived files remain readable, but new sessions cannot bind them. environment_id is an optional recipe reference; computers start with a light sandbox and expose the public SDK sandbox_id. Lists include archived computers.
477
556
  */
@@ -489,9 +568,9 @@ export const computersFilesList = (options) => (options.client ?? client).get({
489
568
  ...options
490
569
  });
491
570
  /**
492
- * ComputersFilesContent
571
+ * Get Computer File Content
493
572
  *
494
- * Tenant-owned durable computer resource.
573
+ * Download the bytes of one file on a computer, up to 16 MiB, with single-range support.
495
574
  *
496
575
  * Praxis extension: MA only has session-scoped temporary containers and memory_stores, not durable browsable computers. Archived files remain readable, but new sessions cannot bind them. environment_id is an optional recipe reference; computers start with a light sandbox and expose the public SDK sandbox_id. Lists include archived computers.
497
576
  */
@@ -2479,7 +2558,7 @@ export const agentsList = (options) => (options?.client ?? client).get({
2479
2558
  /**
2480
2559
  * Create agent
2481
2560
  *
2482
- * Create a reusable agent definition, then pass its returned id to sessions.create to start a conversation. The definition includes model, system prompt, tools, MCP servers and an optional multiagent roster. It is saved as version 1; real updates create new versions. Unlike Anthropic Managed Agents, nonempty skills attachments return 400; the native skill tool is separate from the skills field. Use tools: [{type: "agent_toolset_20260401"}] for built-in tools including codemode, skill and agent; inspect toolsets.list for names and schemas, and keep bash enabled for native additions. To offer only some tools, set default_config: {enabled: false} and list the tools to keep in configs, e.g. tools: [{type: "agent_toolset_20260401", default_config: {enabled: false}, configs: [{name: "codemode", enabled: true}, {name: "bash", enabled: true, permission_policy: {type: "always_ask"}}]}]; every tool not listed, including todo_write, enter_plan_mode, ask_user_question and goal_read, follows default_config, and the response echoes it. codemode runs through bash, so enabling codemode while bash is disabled returns 400. Optional mcp_toolset entries pair with mcp_servers. model accepts platform model IDs such as deepseek-flash, not only the Claude IDs in the protocol examples. model.settings.reasoning sets default thinking; other extra model controls return 400. Example: {"name":"helper","model":{"id":"deepseek-flash"},"tools":[{"type":"agent_toolset_20260401"}]}.
2561
+ * Create a reusable agent definition, then pass its returned id to sessions.create to start a conversation. The definition includes model, system prompt, tools, MCP servers and an optional multiagent roster. It is saved as version 1; real updates create new versions. skills attaches uploaded custom skills as [{type: "custom", skill_id, version?}] (skill_id from skills.create or skills.list; at most 20, no repeated skill_id). Omit version, or send "latest", to use the skill's newest version when a session starts. type anthropic returns 400. Use tools: [{type: "agent_toolset_20260401"}] for built-in tools including codemode, skill and agent; inspect toolsets.list for names and schemas, and keep bash enabled for native additions. To offer only some tools, set default_config: {enabled: false} and list the tools to keep in configs, e.g. tools: [{type: "agent_toolset_20260401", default_config: {enabled: false}, configs: [{name: "codemode", enabled: true}, {name: "bash", enabled: true, permission_policy: {type: "always_ask"}}]}]; every tool not listed, including todo_write, enter_plan_mode, ask_user_question and goal_read, follows default_config, and the response echoes it. codemode runs through bash, so enabling codemode while bash is disabled returns 400. Optional mcp_toolset entries pair with mcp_servers. model accepts platform model IDs such as deepseek-flash, not only the Claude IDs in the protocol examples. model.settings.reasoning sets default thinking; other extra model controls return 400. model and every models.allowed entry must be a catalog model that can run an agent: an unknown id returns 400 "model <id> is not in the model catalog" and an embedding, image or speech model returns 400 "model <id> cannot run an agent". name is a label, not a unique key: 1 to 256 characters after trimming, no NUL or line breaks. avatar is trimmed, must not contain spaces or point at a loopback, private or internal host, and its scheme is stored in lowercase. script and workflow binding ids are stored in lowercase, the form automation matches; bindings together with environment_id null return 400 because bindings need a machine. Example: {"name":"helper","model":{"id":"deepseek-flash"},"tools":[{"type":"agent_toolset_20260401"}]}.
2483
2562
  */
2484
2563
  export const agentsCreate = (options) => (options.client ?? client).post({
2485
2564
  security: [{
@@ -2501,7 +2580,7 @@ export const agentsCreate = (options) => (options.client ?? client).post({
2501
2580
  /**
2502
2581
  * Get agent
2503
2582
  *
2504
- * Read one agent by id, at its latest version or, with version, at a specific earlier version. The response lists every native tool with its resolved configuration in one agent_toolset_20260401 entry, so it can be sent back unchanged to agents.update. Use agents.versions.list to enumerate versions.
2583
+ * Read one agent by id. The top level is the latest saved version, the editable head whose version you send back for optimistic concurrency; after a save with apply false it differs from active_version, and new sessions use active_version, which you read with version=active. With version, read a specific saved version. The response lists every native tool with its resolved configuration in one agent_toolset_20260401 entry, so it can be sent back unchanged to agents.update. Use agents.versions.list to enumerate versions.
2505
2584
  */
2506
2585
  export const agentsRetrieve = (options) => (options.client ?? client).get({
2507
2586
  security: [{
@@ -2519,7 +2598,7 @@ export const agentsRetrieve = (options) => (options.client ?? client).get({
2519
2598
  /**
2520
2599
  * Update agent
2521
2600
  *
2522
- * Update an agent. Send the current version in the body for optimistic concurrency: a stale version returns 409, and an update that changes nothing keeps the version number. Any real change saves a new version. apply defaults to true and moves active_version to the new version, or to the latest when configuration is unchanged; apply false saves without applying. version_note optionally records up to 280 characters on a newly created version. Existing sessions and tokens keep their version. Omitted fields keep their value. multiagent takes null or a coordinator roster; subagent_model keeps its value when omitted and is cleared by null. Archived agents cannot be updated. Unlike Anthropic Managed Agents, nonempty skills attachments return 400; use the native skill tool for available runtime skills.
2601
+ * Update an agent. Send the current version in the body for optimistic concurrency: a stale version returns 409, and an update that changes nothing keeps the version number. Any real change saves a new version. apply defaults to true and moves active_version to the new version, or to the latest when configuration is unchanged; apply false saves without applying. version_note optionally records up to 280 characters on a newly created version; null means no note, and a note sent when the request changes nothing else returns 400 because a note is stored only with a new version. Existing sessions and tokens keep their version. Omitted fields keep their value. multiagent takes null or a coordinator roster; subagent_model keeps its value when omitted and is cleared by null. Archived agents cannot be updated. tools: [] removes every tool, while tools: null returns 400 (tools cannot be null; send [] to remove every tool). On update, omit skills to keep them, send an array to replace them, or send [] or null to clear them. skills attaches uploaded custom skills as [{type: "custom", skill_id, version?}] (skill_id from skills.create or skills.list; at most 20, no repeated skill_id). Omit version, or send "latest", to use the skill's newest version when a session starts. type anthropic returns 400.
2523
2602
  */
2524
2603
  export const agentsUpdate = (options) => (options.client ?? client).post({
2525
2604
  security: [{
@@ -2559,7 +2638,7 @@ export const agentsArchive = (options) => (options.client ?? client).post({
2559
2638
  /**
2560
2639
  * List agent versions
2561
2640
  *
2562
- * List the saved versions of one agent, in pages of at most 100 (default 20). Each item is the full agent definition at that version, so you can compare what changed between versions. Use agents.retrieve with version to read a single one; agent_id comes from agents.list or agents.create.
2641
+ * List the saved versions of one agent, in pages of at most 100 (default 20). Each item is the full agent definition at that version, so you can compare what changed between versions. active is true only for the item that new sessions use; active_version on each item is the agent-level value, kept for compatibility. Use agents.retrieve with version to read a single one; agent_id comes from agents.list or agents.create.
2563
2642
  */
2564
2643
  export const agentsVersionsList = (options) => (options.client ?? client).get({
2565
2644
  security: [{
@@ -2577,7 +2656,7 @@ export const agentsVersionsList = (options) => (options.client ?? client).get({
2577
2656
  /**
2578
2657
  * List sessions
2579
2658
  *
2580
- * List sessions of the workspace behind your API key, newest first, in pages of at most 100 (default 20). Unlike Anthropic Managed Agents, only limit, page, agent_id and deployment_id are honored; the other filters declared here (agent_version, created_at ranges, memory_store_id, include_archived, order, statuses) are not supported and return 400. Use the returned id with sessions.retrieve or sessions.events.list; pass next_page as page for the next page.
2659
+ * List sessions of the workspace behind your API key, newest first, in pages of at most 100 (default 20). Archived sessions are hidden unless include_archived is true. Unlike Anthropic Managed Agents, only limit, page, agent_id, deployment_id and include_archived are honored; the other filters declared here (agent_version, created_at ranges, memory_store_id, order, statuses) are not supported and return 400. Use the returned id with sessions.retrieve or sessions.events.list; pass next_page as page for the next page.
2581
2660
  */
2582
2661
  export const sessionsList = (options) => (options?.client ?? client).get({
2583
2662
  security: [{
@@ -2595,7 +2674,7 @@ export const sessionsList = (options) => (options?.client ?? client).get({
2595
2674
  /**
2596
2675
  * Create session
2597
2676
  *
2598
- * Create a session: one conversation with an agent. Pass agent as an agent id (active_version) or {id, version, type:"agent"}. Unlike Anthropic Managed Agents, omit environment_id to get a light machine, unless computer_id (explicit, or the agent's default) selects a Computer; pass an environment id for a sandbox recipe. For service agents, omission returns environment_id=light; explicit null allocates no machine, so codemode, bash and other machine tools are unavailable. Optional model must be one of the agent's allowed models; optional thinking is {effort: low|medium|high|xhigh|max|none} or null, where null inherits the agent default and then the model default (none requires the model to allow disabling thinking). Selections are saved before initial_events run; invalid ones return 400 invalid_request_error. Inline agent overrides are not supported. Supports vault_ids, up to 50, owned by the current organization and not archived; credential injection is deferred to a later version. Omitted budget defaults to USD 20; null removes the limit, and a limit object uses a positive integer string of USD cents. Up to 500 file resources can be attached. Use initial_events to send a first user.message in this request, or send messages afterwards with sessions.events.send. The returned status can still be idle before initial events run; read agent.message and the subsequent session.status_idle event to confirm completion.
2677
+ * Create a session: one conversation with an agent. Pass agent as an agent id or {type:"agent", id, version?}; an id alone, or an object without version, pins the agent's active_version (the version chosen with agents.versions.apply, not necessarily the newest saved one). Unlike Anthropic Managed Agents, omit environment_id to use the default environment saved in the agent version (light for a new agent), unless computer_id (explicit, or the agent's default) selects a Computer; pass an environment id for a sandbox recipe. For service agents, explicit null allocates no machine, so codemode, bash and other machine tools are unavailable. Optional model must be one of the agent's allowed models; optional thinking is {effort: low|medium|high|xhigh|max|none} or null, where null inherits the agent default and then the model default (none requires the model to allow disabling thinking). Selections are saved before initial_events run; invalid ones return 400 invalid_request_error. Unlike Anthropic Managed Agents, the only inline agent override is system ({type:"agent_with_overrides", id, system}); to change the model, tools, MCP servers or skills, save a version instead. Supports vault_ids, up to 50, owned by the current organization and not archived; credential injection is deferred to a later version. budget is {type:"limit", max_list_cost:{amount, currency:"USD"}} where amount is a positive integer string of US cents ("2000" is USD 20.00); omitted budget defaults to "2000" and null removes the limit. Up to 500 file resources can be attached. Use initial_events to send a first user.message in this request, or send messages afterwards with sessions.events.send. The returned status can still be idle before initial events run; read agent.message and the subsequent session.status_idle event to confirm completion.
2599
2678
  */
2600
2679
  export const sessionsCreate = (options) => (options.client ?? client).post({
2601
2680
  security: [{
@@ -2801,7 +2880,7 @@ export const environmentsRetrieve = (options) => (options.client ?? client).get(
2801
2880
  /**
2802
2881
  * Update environment
2803
2882
  *
2804
- * Update the configuration of a tenant-owned cloud environment. Built-in environments are read-only. Package installation and limited networking are applied when a session's sandbox is created. Omitted fields keep their value.
2883
+ * Update the configuration of a tenant-owned cloud environment. Built-in environments are read-only. Package installation and limited networking are applied when a session's sandbox is created. Omitted fields keep their value. A changed config.template must name an available sandbox template, otherwise 400 lists the available ones.
2805
2884
  */
2806
2885
  export const environmentsUpdate = (options) => (options.client ?? client).post({
2807
2886
  security: [{
@@ -2823,7 +2902,7 @@ export const environmentsUpdate = (options) => (options.client ?? client).post({
2823
2902
  /**
2824
2903
  * Archive environment
2825
2904
  *
2826
- * Soft-archive a tenant-owned cloud environment so it can no longer be used to create new sessions. Built-in environments are read-only and cannot be archived.
2905
+ * Soft-archive a tenant-owned cloud environment so it can no longer be used to create new sessions. Built-in environments are read-only and cannot be archived. An environment that the active version of a non-archived agent uses as environment_id returns 409 RESOURCE_IN_USE naming the agents; point them at another environment first.
2827
2906
  */
2828
2907
  export const environmentsArchive = (options) => (options.client ?? client).post({
2829
2908
  security: [{
@@ -2859,7 +2938,7 @@ export const environmentsList = (options) => (options?.client ?? client).get({
2859
2938
  /**
2860
2939
  * Create environment
2861
2940
  *
2862
- * Create a tenant-owned cloud environment: a sandbox recipe (packages to install and networking policy) that sessions can select through environment_id. Package installation happens when the session's sandbox is created; a failed install terminates that session with ENVIRONMENT_PACKAGE_INSTALL_FAILED. Limited networking is applied at sandbox creation. Unlike Anthropic Managed Agents, self_hosted environments, scope and cross-session package caching are not supported.
2941
+ * Create a tenant-owned cloud environment: a sandbox recipe (packages to install and networking policy) that sessions can select through environment_id. Package installation happens when the session's sandbox is created; a failed install terminates that session with ENVIRONMENT_PACKAGE_INSTALL_FAILED. Limited networking is applied at sandbox creation. Unlike Anthropic Managed Agents, self_hosted environments, scope and cross-session package caching are not supported. config.template must name an available sandbox template, otherwise 400 lists the available ones.
2863
2942
  */
2864
2943
  export const environmentsCreate = (options) => (options.client ?? client).post({
2865
2944
  security: [{
@@ -3163,7 +3242,7 @@ export const skillsList = (options) => (options?.client ?? client).get({
3163
3242
  /**
3164
3243
  * Create skill
3165
3244
  *
3166
- * Upload a skill: a directory that contains SKILL.md, which the agent reads when it needs the skill. Send multipart/form-data with one files part per file, each file name being its path under one top-level directory (pdf/SKILL.md, pdf/scripts/run.py), and an optional display_name. SKILL.md frontmatter needs a description; name defaults to the directory name. Limits: 8 MB in total, at most 200 files, no .. segments, absolute paths or empty names; a violation returns 400 naming the path or field. The upload creates the skill and its first version, and versions are immutable. Attach the skill to an agent with `skills` on the agent.
3245
+ * Upload a skill: a directory that contains SKILL.md, which the agent reads when it needs the skill. Send multipart/form-data with one files part per file, each file name being its path under one top-level directory (pdf/SKILL.md, pdf/scripts/run.py), and an optional display_name. SKILL.md frontmatter needs a description; name defaults to the directory name and must be one folder name (1-255 characters, no "/", backslash or NUL, not "." or ".."), otherwise the upload returns 400 stating the allowed form. Limits: 8 MB in total, at most 200 files, no .. segments, absolute paths or empty names; a violation returns 400 naming the path or field. The upload creates the skill and its first version, and versions are immutable. Attach the skill to an agent with `skills` on the agent.
3167
3246
  */
3168
3247
  export const skillsCreate = (options) => (options.client ?? client).post({
3169
3248
  ...formDataBodySerializer,
@@ -3186,7 +3265,7 @@ export const skillsCreate = (options) => (options.client ?? client).post({
3186
3265
  /**
3187
3266
  * Delete skill
3188
3267
  *
3189
- * Delete a skill that has no live versions. A skill that still has versions returns 409 Delete all versions first; remove each with skills.versions.delete, then call this. Returns {id, type: skill_deleted}. skill_id comes from skills.create or skills.list.
3268
+ * Delete a skill together with all of its versions. A skill that is still attached to an agent returns 409 RESOURCE_IN_USE naming up to 10 agent ids (the active or latest version of a non-archived agent counts); remove it from those agents first. Returns {id, type: skill_deleted}. skill_id comes from skills.create or skills.list.
3190
3269
  */
3191
3270
  export const skillsDelete = (options) => (options.client ?? client).delete({
3192
3271
  security: [{
@@ -3263,7 +3342,7 @@ export const skillsVersionsCreate = (options) => (options.client ?? client).post
3263
3342
  /**
3264
3343
  * Delete skill version
3265
3344
  *
3266
- * Soft-delete one version of a skill so it can no longer be read or downloaded; latest_version_id of the skill falls back to the newest remaining version. Returns {id, type: skill_version_deleted}. A skill can be deleted only after all of its versions are deleted.
3345
+ * Soft-delete one version of a skill so it can no longer be read or downloaded; latest_version_id of the skill falls back to the newest remaining version. Returns {id, type: skill_version_deleted}. A skill keeps at least one version: deleting the last remaining version returns 409 SKILL_LAST_VERSION (delete the skill instead), so latest_version_id is never null. A version that a non-archived agent pins returns 409 RESOURCE_IN_USE naming the agents.
3267
3346
  */
3268
3347
  export const skillsVersionsDelete = (options) => (options.client ?? client).delete({
3269
3348
  security: [{