@deepraxis/sdk 0.1.0-dev.891e403 → 0.1.0-dev.8c50d77

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.
@@ -4677,10 +4677,9 @@ export type AgentManaged167 = {
4677
4677
  */
4678
4678
  mcp_servers?: Array<AgentManaged7>;
4679
4679
  /**
4680
- * Replacement model. Accepts the model string, e.g. `claude-opus-5`, or a
4681
- * `model_config` object. Omit to use the agent's model.
4680
+ * A model id from the Praxis model catalog (`praxis.model.models.list`), or a `model_config` object for additional configuration control. Unlike Anthropic, Claude model ids other than those in the catalog are rejected.
4682
4681
  */
4683
- model?: 'claude-opus-5-5' | 'claude-fable-5-1' | 'claude-sonnet-5' | 'claude-fable-5' | 'claude-opus-5' | 'claude-opus-4-8' | 'claude-opus-4-7' | 'claude-opus-4-6' | 'claude-sonnet-4-6' | 'claude-haiku-4-5' | 'claude-haiku-4-5-20251001' | 'claude-opus-4-5' | 'claude-opus-4-5-20251101' | 'claude-sonnet-4-5' | 'claude-sonnet-4-5-20250929' | string | AgentManaged1;
4682
+ model?: string | AgentManaged1;
4684
4683
  /**
4685
4684
  * Replacement skill attachment references stored and echoed unchanged. Not loaded by deployment resource operations.
4686
4685
  */
@@ -10644,7 +10643,7 @@ export type DatabaseDatabase = {
10644
10643
  purge_at: string | null;
10645
10644
  };
10646
10645
  export type DatabaseDatabaseError = {
10647
- code: 'SINGULAR_MISMATCH' | 'AMBIGUOUS_EMBED' | 'EMBED_NOT_FOUND' | 'INVALID_PREFERENCE' | 'QUERY_CANCELED' | 'RANGE_NOT_SATISFIABLE' | 'NOT_ACCEPTABLE' | 'OPERATOR_TYPE_MISMATCH' | 'DATABASE_NOT_FOUND' | 'TABLE_NOT_FOUND' | 'FIELD_NOT_FOUND' | 'VALIDATION_FAILED' | 'UNIQUE_VIOLATION' | 'REFERENCE_RESTRICT' | 'FIELD_TYPE_IMMUTABLE' | 'LIMIT_EXCEEDED' | 'UNSUPPORTED' | 'INVALID_PARAMS' | 'DATABASE_INVALID_STATE' | 'CAPACITY' | 'NOT_IMPLEMENTED';
10646
+ code: 'SINGULAR_MISMATCH' | 'AMBIGUOUS_EMBED' | 'EMBED_NOT_FOUND' | 'INVALID_PREFERENCE' | 'QUERY_CANCELED' | 'RANGE_NOT_SATISFIABLE' | 'NOT_ACCEPTABLE' | 'OPERATOR_TYPE_MISMATCH' | 'DATABASE_NOT_FOUND' | 'TABLE_NOT_FOUND' | 'FIELD_NOT_FOUND' | 'VALIDATION_FAILED' | 'UNIQUE_VIOLATION' | 'REFERENCE_RESTRICT' | 'FIELD_TYPE_IMMUTABLE' | 'LIMIT_EXCEEDED' | 'UNSUPPORTED' | 'INVALID_PARAMS' | 'DATABASE_INVALID_STATE' | 'CAPACITY' | 'NOT_IMPLEMENTED' | 'BINDING_READ_ONLY';
10648
10647
  message: string;
10649
10648
  details: string | null;
10650
10649
  hint: string | null;
@@ -18404,12 +18403,9 @@ export type AgentManaged28 = {
18404
18403
  };
18405
18404
  export type AgentManaged1 = {
18406
18405
  /**
18407
- * The model that will power your agent.
18408
- *
18409
- * See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
18410
- * details and options.
18406
+ * A model id from the Praxis model catalog (`praxis.model.models.list`). Unlike Anthropic, Claude model ids other than those in the catalog are rejected.
18411
18407
  */
18412
- id: 'claude-opus-5-5' | 'claude-fable-5-1' | 'claude-sonnet-5' | 'claude-fable-5' | 'claude-opus-5' | 'claude-opus-4-8' | 'claude-opus-4-7' | 'claude-opus-4-6' | 'claude-sonnet-4-6' | 'claude-haiku-4-5' | 'claude-haiku-4-5-20251001' | 'claude-opus-4-5' | 'claude-opus-4-5-20251101' | 'claude-sonnet-4-5' | 'claude-sonnet-4-5-20250929' | string;
18408
+ id: string;
18413
18409
  /**
18414
18410
  * How hard Claude works on each inference call. Accepts a bare level string
18415
18411
  * (`"high"`) or `{"type": "high"}`. On create, omitting it resolves the per-model
@@ -18768,12 +18764,9 @@ export type AgentManaged89 = {
18768
18764
  */
18769
18765
  export type AgentManaged38 = {
18770
18766
  /**
18771
- * The model that will power your agent.
18772
- *
18773
- * See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
18774
- * details and options.
18767
+ * A model id from the Praxis model catalog (`praxis.model.models.list`). Unlike Anthropic, Claude model ids other than those in the catalog are rejected.
18775
18768
  */
18776
- id: 'claude-opus-5-5' | 'claude-fable-5-1' | 'claude-sonnet-5' | 'claude-fable-5' | 'claude-opus-5' | 'claude-opus-4-8' | 'claude-opus-4-7' | 'claude-opus-4-6' | 'claude-sonnet-4-6' | 'claude-haiku-4-5' | 'claude-haiku-4-5-20251001' | 'claude-opus-4-5' | 'claude-opus-4-5-20251101' | 'claude-sonnet-4-5' | 'claude-sonnet-4-5-20250929' | string;
18769
+ id: string;
18777
18770
  /**
18778
18771
  * How hard Claude works on each turn. Sets `output_config.effort` on every
18779
18772
  * Messages call the session makes.
@@ -27448,12 +27441,9 @@ export type ApplyAgentVersionResponses = {
27448
27441
  */
27449
27442
  model: {
27450
27443
  /**
27451
- * The model that will power your agent.
27452
- *
27453
- * See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
27454
- * details and options.
27444
+ * A model id from the Praxis model catalog (`praxis.model.models.list`). Unlike Anthropic, Claude model ids other than those in the catalog are rejected.
27455
27445
  */
27456
- id: 'claude-opus-5-5' | 'claude-fable-5-1' | 'claude-sonnet-5' | 'claude-fable-5' | 'claude-opus-5' | 'claude-opus-4-8' | 'claude-opus-4-7' | 'claude-opus-4-6' | 'claude-sonnet-4-6' | 'claude-haiku-4-5' | 'claude-haiku-4-5-20251001' | 'claude-opus-4-5' | 'claude-opus-4-5-20251101' | 'claude-sonnet-4-5' | 'claude-sonnet-4-5-20250929' | string;
27446
+ id: string;
27457
27447
  /**
27458
27448
  * How hard Claude works on each turn. Sets `output_config.effort` on every
27459
27449
  * Messages call the session makes.
@@ -28069,7 +28059,7 @@ export type ApplyAgentVersionResponses = {
28069
28059
  */
28070
28060
  note: string | null;
28071
28061
  /**
28072
- * Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file_..., read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search or browser. At most 20 bindings per type, no repeated type and id, and each service type at most once. Newly added bindings apply only to new sessions; disabling or removing a binding immediately revokes access in running sessions. A resource that is not bound returns 404, a service that is not opened returns 403, and writes to read_only resources are refused. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings.
28062
+ * Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file- plus 24 letters or digits, as the File API returns it; read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search or browser. At most 20 bindings per type, no repeated type and id, and each service type at most once. A session is authorized by the agent version it runs: newly added bindings apply only to new sessions, and a version saved with apply=false changes no access until it is applied. Applying a version that disables, removes or downgrades a binding revokes it immediately in running sessions on older versions. A resource that is not bound returns 404, a service that is not opened returns 403, and a write to a resource bound read_only returns 403 BINDING_READ_ONLY. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings.
28073
28063
  */
28074
28064
  bindings: Array<{
28075
28065
  /**
@@ -28077,7 +28067,7 @@ export type ApplyAgentVersionResponses = {
28077
28067
  */
28078
28068
  type: 'database' | 'vector_store' | 'file' | 'media_library' | 'model' | 'workflow' | 'script';
28079
28069
  /**
28080
- * Resource id, never its name. database db_..., vector_store vs_..., file file_...; media_library and model ids must not contain ':' or whitespace; workflow and script use <namespace>/<name> with no '/', '@', ':' or whitespace inside a part.
28070
+ * Resource id, never its name. database db_..., vector_store vs_..., file file- plus 24 letters or digits; media_library and model ids must not contain ':' or whitespace; workflow and script use <namespace>/<name> with no '/', '@', ':' or whitespace inside a part.
28081
28071
  */
28082
28072
  id: string;
28083
28073
  /**
@@ -28466,6 +28456,14 @@ export type ApplyAgentVersionResponses = {
28466
28456
  * Avatar image URL of this agent version (absolute https), shown in agent lists, the agent detail, the chat header and as the default avatar of embedded chat; null when none is set. Follows the version like other configuration: a version saved with apply=false does not change the avatar in effect. /agent/v1 only.
28467
28457
  */
28468
28458
  avatar: string | null;
28459
+ /**
28460
+ * Channel the agent was created through (for example api or console); null for historical agents whose channel is unknown. Display only. /agent/v1 only; /anthropic neither returns it.
28461
+ */
28462
+ creation_source: string | null;
28463
+ /**
28464
+ * Platform-wide identity number of the agent (8 characters), usable wherever an agent is addressed by identity_number; null when the agent has none. /agent/v1 only; /anthropic neither returns it.
28465
+ */
28466
+ identity_number: string | null;
28469
28467
  /**
28470
28468
  * Default environment of this service agent version: the environment_id new sessions get when they name none; null means no environment. Present for service agents only. Follows the version like other configuration: a version saved with apply=false does not change the environment in effect. Versions saved before this field existed read as light. /agent/v1 only.
28471
28469
  */
@@ -28607,12 +28605,9 @@ export type UnarchiveAgentResponses = {
28607
28605
  */
28608
28606
  model: {
28609
28607
  /**
28610
- * The model that will power your agent.
28611
- *
28612
- * See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
28613
- * details and options.
28608
+ * A model id from the Praxis model catalog (`praxis.model.models.list`). Unlike Anthropic, Claude model ids other than those in the catalog are rejected.
28614
28609
  */
28615
- id: 'claude-opus-5-5' | 'claude-fable-5-1' | 'claude-sonnet-5' | 'claude-fable-5' | 'claude-opus-5' | 'claude-opus-4-8' | 'claude-opus-4-7' | 'claude-opus-4-6' | 'claude-sonnet-4-6' | 'claude-haiku-4-5' | 'claude-haiku-4-5-20251001' | 'claude-opus-4-5' | 'claude-opus-4-5-20251101' | 'claude-sonnet-4-5' | 'claude-sonnet-4-5-20250929' | string;
28610
+ id: string;
28616
28611
  /**
28617
28612
  * How hard Claude works on each turn. Sets `output_config.effort` on every
28618
28613
  * Messages call the session makes.
@@ -29228,7 +29223,7 @@ export type UnarchiveAgentResponses = {
29228
29223
  */
29229
29224
  note: string | null;
29230
29225
  /**
29231
- * Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file_..., read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search or browser. At most 20 bindings per type, no repeated type and id, and each service type at most once. Newly added bindings apply only to new sessions; disabling or removing a binding immediately revokes access in running sessions. A resource that is not bound returns 404, a service that is not opened returns 403, and writes to read_only resources are refused. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings.
29226
+ * Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file- plus 24 letters or digits, as the File API returns it; read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search or browser. At most 20 bindings per type, no repeated type and id, and each service type at most once. A session is authorized by the agent version it runs: newly added bindings apply only to new sessions, and a version saved with apply=false changes no access until it is applied. Applying a version that disables, removes or downgrades a binding revokes it immediately in running sessions on older versions. A resource that is not bound returns 404, a service that is not opened returns 403, and a write to a resource bound read_only returns 403 BINDING_READ_ONLY. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings.
29232
29227
  */
29233
29228
  bindings: Array<{
29234
29229
  /**
@@ -29236,7 +29231,7 @@ export type UnarchiveAgentResponses = {
29236
29231
  */
29237
29232
  type: 'database' | 'vector_store' | 'file' | 'media_library' | 'model' | 'workflow' | 'script';
29238
29233
  /**
29239
- * Resource id, never its name. database db_..., vector_store vs_..., file file_...; media_library and model ids must not contain ':' or whitespace; workflow and script use <namespace>/<name> with no '/', '@', ':' or whitespace inside a part.
29234
+ * Resource id, never its name. database db_..., vector_store vs_..., file file- plus 24 letters or digits; media_library and model ids must not contain ':' or whitespace; workflow and script use <namespace>/<name> with no '/', '@', ':' or whitespace inside a part.
29240
29235
  */
29241
29236
  id: string;
29242
29237
  /**
@@ -29625,6 +29620,14 @@ export type UnarchiveAgentResponses = {
29625
29620
  * Avatar image URL of this agent version (absolute https), shown in agent lists, the agent detail, the chat header and as the default avatar of embedded chat; null when none is set. Follows the version like other configuration: a version saved with apply=false does not change the avatar in effect. /agent/v1 only.
29626
29621
  */
29627
29622
  avatar: string | null;
29623
+ /**
29624
+ * Channel the agent was created through (for example api or console); null for historical agents whose channel is unknown. Display only. /agent/v1 only; /anthropic neither returns it.
29625
+ */
29626
+ creation_source: string | null;
29627
+ /**
29628
+ * Platform-wide identity number of the agent (8 characters), usable wherever an agent is addressed by identity_number; null when the agent has none. /agent/v1 only; /anthropic neither returns it.
29629
+ */
29630
+ identity_number: string | null;
29628
29631
  /**
29629
29632
  * Default environment of this service agent version: the environment_id new sessions get when they name none; null means no environment. Present for service agents only. Follows the version like other configuration: a version saved with apply=false does not change the environment in effect. Versions saved before this field existed read as light. /agent/v1 only.
29630
29633
  */
@@ -30230,6 +30233,303 @@ export type UnblockEndUserResponses = {
30230
30233
  };
30231
30234
  };
30232
30235
  export type UnblockEndUserResponse = UnblockEndUserResponses[keyof UnblockEndUserResponses];
30236
+ export type CreateCustomerGrantCodeData = {
30237
+ body: {
30238
+ /**
30239
+ * Your stable, opaque identifier for the signed-in customer, such as your database user id. Do not use an email address or phone number. "auth" is reserved, and ids starting with anon_ are reserved for anonymous customers.
30240
+ */
30241
+ customer_id: string;
30242
+ /**
30243
+ * Existing agent version that every token of this sign-in pins. Defaults to the agent's active_version when the code is issued.
30244
+ */
30245
+ version?: number;
30246
+ /**
30247
+ * Budget in cents for each session the customer starts. Defaults to the embed policy session budget and cannot exceed its maximum.
30248
+ */
30249
+ budget_cents?: number;
30250
+ /**
30251
+ * Optional context the agent receives at the start of each session, as text blocks, limited to 8192 UTF-8 bytes in total.
30252
+ */
30253
+ system_message?: Array<{
30254
+ /**
30255
+ * The text block kind; text is the only supported kind.
30256
+ */
30257
+ type: 'text';
30258
+ /**
30259
+ * Context text about this customer. All blocks together must fit within 8192 UTF-8 bytes.
30260
+ */
30261
+ text: string;
30262
+ }>;
30263
+ /**
30264
+ * Optional system prompt override, accepted only when the embed policy allows agent overrides.
30265
+ */
30266
+ agent_override?: {
30267
+ /**
30268
+ * Replacement system prompt, or null to clear it for this sign-in.
30269
+ */
30270
+ system: string | null;
30271
+ };
30272
+ /**
30273
+ * Up to 16 string pairs copied onto every session the customer starts. The playground key is reserved.
30274
+ */
30275
+ metadata?: {
30276
+ [key: string]: string;
30277
+ };
30278
+ /**
30279
+ * Page origin, such as https://shop.example.com, that must be one of the agent policy's allowed_origins (or localhost when the policy allows it). When set, every token of this sign-in works only from exactly this origin. Omit to accept any policy origin.
30280
+ */
30281
+ origin?: string;
30282
+ /**
30283
+ * Seconds the code stays redeemable, from 60 to 86400. Defaults to 900.
30284
+ */
30285
+ expires_in?: number;
30286
+ /**
30287
+ * Total lifetime of the sign-in in seconds, from 3600 to 604800 (7 days). Tokens renew within it; after it the customer signs in again. Defaults to 604800.
30288
+ */
30289
+ max_session_seconds?: number;
30290
+ /**
30291
+ * The current access token of the anonymous customer who used this agent before signing in. Their conversations become visible to the identified customer, and the anonymous sign-in ends at exchange.
30292
+ */
30293
+ anonymous_access_token?: string;
30294
+ };
30295
+ path: {
30296
+ /**
30297
+ * Service agent id (agent_…) or its short identity number, from agent creation or listing.
30298
+ */
30299
+ agent_id: string;
30300
+ };
30301
+ query?: never;
30302
+ url: '/agent/v1/agents/{agent_id}/customers/auth/grant_codes';
30303
+ };
30304
+ export type CreateCustomerGrantCodeErrors = {
30305
+ /**
30306
+ * INVALID_PARAMS: an unknown field, a reserved or malformed customer_id, an origin outside the policy, a value outside its range, or an anonymous_access_token that is not a live anonymous token of this agent. The message names the field to correct.
30307
+ */
30308
+ 400: unknown;
30309
+ /**
30310
+ * Authenticate with your backend API key or a console session.
30311
+ */
30312
+ 401: unknown;
30313
+ /**
30314
+ * CUSTOMER_BLOCKED: the customer is on the agent's blocked list; unblock them in the console first.
30315
+ */
30316
+ 403: unknown;
30317
+ /**
30318
+ * The agent is not an active service agent of your organization, or the caller is a customer access token.
30319
+ */
30320
+ 404: unknown;
30321
+ };
30322
+ export type CreateCustomerGrantCodeResponses = {
30323
+ /**
30324
+ * The one-time grant code and its expiry. Only its hash is stored; it cannot be read again.
30325
+ */
30326
+ 201: {
30327
+ /**
30328
+ * Object type, always customer_grant_code.
30329
+ */
30330
+ type: 'customer_grant_code';
30331
+ /**
30332
+ * One-time grant code (cgc_…). Hand it to Agent Kit in the browser, which exchanges it for an access token; it is never shown again.
30333
+ */
30334
+ code: string;
30335
+ /**
30336
+ * The customer_id that the code signs in.
30337
+ */
30338
+ customer_id: string;
30339
+ /**
30340
+ * RFC 3339 time after which the code can no longer be exchanged.
30341
+ */
30342
+ expires_at: string;
30343
+ };
30344
+ };
30345
+ export type CreateCustomerGrantCodeResponse = CreateCustomerGrantCodeResponses[keyof CreateCustomerGrantCodeResponses];
30346
+ export type CreateCustomerAccessTokenData = {
30347
+ /**
30348
+ * Exactly one of grant_code (a signed-in customer) or publishable_key (an anonymous visitor).
30349
+ */
30350
+ body: {
30351
+ /**
30352
+ * The grant code your backend received from grant_codes. It works once.
30353
+ */
30354
+ grant_code: string;
30355
+ } | {
30356
+ /**
30357
+ * The agent's publishable key, for a visitor who has not signed in. Creates a new anonymous customer.
30358
+ */
30359
+ publishable_key: string;
30360
+ };
30361
+ headers?: {
30362
+ /**
30363
+ * Browser page origin. Required for publishable_key and for a grant code bound to an origin; it must be in the agent's allowed_origins.
30364
+ */
30365
+ Origin?: string;
30366
+ };
30367
+ path: {
30368
+ /**
30369
+ * Service agent id (agent_…) or its short identity number, from agent creation or listing.
30370
+ */
30371
+ agent_id: string;
30372
+ };
30373
+ query?: never;
30374
+ url: '/agent/v1/agents/{agent_id}/customers/auth/access_tokens';
30375
+ };
30376
+ export type CreateCustomerAccessTokenErrors = {
30377
+ /**
30378
+ * INVALID_PARAMS: send exactly one of grant_code or publishable_key, nothing else.
30379
+ */
30380
+ 400: unknown;
30381
+ /**
30382
+ * GRANT_CODE_INVALID: the code is unknown, already used, expired or for another agent (one answer for all four); request a new grant code from your backend. UNAUTHENTICATED: the publishable key is unknown, disabled or for another agent.
30383
+ */
30384
+ 401: unknown;
30385
+ /**
30386
+ * EMBED_BUDGET_EXHAUSTED: the publishable key's daily spending cap is reached; wait for the UTC reset or ask the owner to raise it.
30387
+ */
30388
+ 402: unknown;
30389
+ /**
30390
+ * ORIGIN_NOT_ALLOWED or EMBED_ORIGIN_NOT_ALLOWED: call from the origin the code was issued for, or from one in the agent's allowed_origins. CUSTOMER_BLOCKED: the merchant blocked this customer.
30391
+ */
30392
+ 403: unknown;
30393
+ /**
30394
+ * EMBED_RATE_LIMITED: the per-IP minute limit or the key's daily session cap is reached; wait for Retry-After or the UTC reset.
30395
+ */
30396
+ 429: unknown;
30397
+ /**
30398
+ * Issuance or rate limiting is unavailable; retry later with a new grant code if this one expires.
30399
+ */
30400
+ 503: unknown;
30401
+ };
30402
+ export type CreateCustomerAccessTokenResponses = {
30403
+ /**
30404
+ * A customer access token, its expiry and the end of the sign-in.
30405
+ */
30406
+ 201: {
30407
+ /**
30408
+ * Object type, always customer_access_token.
30409
+ */
30410
+ type: 'customer_access_token';
30411
+ /**
30412
+ * Bearer credential for this agent's sessions on behalf of the customer. Renew it before expires_at.
30413
+ */
30414
+ access_token: string;
30415
+ /**
30416
+ * RFC 3339 expiry of this access token: at most two hours after issue and never after session_expires_at.
30417
+ */
30418
+ expires_at: string;
30419
+ /**
30420
+ * RFC 3339 end of the sign-in. Renewal stops working here; the customer signs in again with a new grant code.
30421
+ */
30422
+ session_expires_at: string;
30423
+ /**
30424
+ * The customer this token acts for.
30425
+ */
30426
+ customer: {
30427
+ /**
30428
+ * The customer id: your customer_id, or anon_ followed by 16 characters for an anonymous customer.
30429
+ */
30430
+ id: string;
30431
+ /**
30432
+ * identified: signed in through a grant code from your backend. anonymous: a visitor admitted with the publishable key.
30433
+ */
30434
+ type: 'identified' | 'anonymous';
30435
+ };
30436
+ };
30437
+ };
30438
+ export type CreateCustomerAccessTokenResponse = CreateCustomerAccessTokenResponses[keyof CreateCustomerAccessTokenResponses];
30439
+ export type RenewCustomerAccessTokenData = {
30440
+ body?: never;
30441
+ path: {
30442
+ /**
30443
+ * Service agent id (agent_…) or its short identity number, from agent creation or listing.
30444
+ */
30445
+ agent_id: string;
30446
+ };
30447
+ query?: never;
30448
+ url: '/agent/v1/agents/{agent_id}/customers/auth/access_tokens/renew';
30449
+ };
30450
+ export type RenewCustomerAccessTokenErrors = {
30451
+ /**
30452
+ * ACCESS_TOKEN_REVOKED: the token or its sign-in was revoked (logout, merge, or revocation by the merchant); sign the customer in again with a new grant code. Other 401 responses mean the Bearer token is missing, invalid or expired; renew before expires_at. CUSTOMER_SESSION_EXPIRED: less than 60 seconds of the sign-in remain; sign in again: request a new grant code from your backend.
30453
+ */
30454
+ 401: unknown;
30455
+ /**
30456
+ * CUSTOMER_BLOCKED: the merchant blocked this customer; unblock them before signing them in. ORIGIN_NOT_ALLOWED: the request Origin is not the origin this sign-in is bound to, or is not in the agent's allowed_origins; call from the page that signed in.
30457
+ */
30458
+ 403: unknown;
30459
+ /**
30460
+ * The token belongs to another agent, is not a customer access token, or the agent is archived or absent; use the agent_id the token was issued for.
30461
+ */
30462
+ 404: unknown;
30463
+ };
30464
+ export type RenewCustomerAccessTokenResponses = {
30465
+ /**
30466
+ * A new access token in the same sign-in. The presented token stays valid until its own expiry.
30467
+ */
30468
+ 201: {
30469
+ /**
30470
+ * Object type, always customer_access_token.
30471
+ */
30472
+ type: 'customer_access_token';
30473
+ /**
30474
+ * Bearer credential for this agent's sessions on behalf of the customer. Renew it before expires_at.
30475
+ */
30476
+ access_token: string;
30477
+ /**
30478
+ * RFC 3339 expiry of this access token: at most two hours after issue and never after session_expires_at.
30479
+ */
30480
+ expires_at: string;
30481
+ /**
30482
+ * RFC 3339 end of the sign-in. Renewal stops working here; the customer signs in again with a new grant code.
30483
+ */
30484
+ session_expires_at: string;
30485
+ /**
30486
+ * The customer this token acts for.
30487
+ */
30488
+ customer: {
30489
+ /**
30490
+ * The customer id: your customer_id, or anon_ followed by 16 characters for an anonymous customer.
30491
+ */
30492
+ id: string;
30493
+ /**
30494
+ * identified: signed in through a grant code from your backend. anonymous: a visitor admitted with the publishable key.
30495
+ */
30496
+ type: 'identified' | 'anonymous';
30497
+ };
30498
+ };
30499
+ };
30500
+ export type RenewCustomerAccessTokenResponse = RenewCustomerAccessTokenResponses[keyof RenewCustomerAccessTokenResponses];
30501
+ export type DeleteCurrentCustomerAccessTokenData = {
30502
+ body?: never;
30503
+ path: {
30504
+ /**
30505
+ * Service agent id (agent_…) or its short identity number, from agent creation or listing.
30506
+ */
30507
+ agent_id: string;
30508
+ };
30509
+ query?: never;
30510
+ url: '/agent/v1/agents/{agent_id}/customers/auth/access_tokens/current';
30511
+ };
30512
+ export type DeleteCurrentCustomerAccessTokenErrors = {
30513
+ /**
30514
+ * ACCESS_TOKEN_REVOKED: the token or its sign-in was revoked (logout, merge, or revocation by the merchant); sign the customer in again with a new grant code. Other 401 responses mean the Bearer token is missing, invalid or expired; renew before expires_at.
30515
+ */
30516
+ 401: unknown;
30517
+ /**
30518
+ * CUSTOMER_BLOCKED: the merchant blocked this customer; unblock them before signing them in. ORIGIN_NOT_ALLOWED: the request Origin is not the origin this sign-in is bound to, or is not in the agent's allowed_origins; call from the page that signed in.
30519
+ */
30520
+ 403: unknown;
30521
+ /**
30522
+ * The token belongs to another agent, is not a customer access token, or the agent is archived or absent; use the agent_id the token was issued for.
30523
+ */
30524
+ 404: unknown;
30525
+ };
30526
+ export type DeleteCurrentCustomerAccessTokenResponses = {
30527
+ /**
30528
+ * Logged out: the sign-in and every access token in it are revoked, and their live event streams close.
30529
+ */
30530
+ 204: void;
30531
+ };
30532
+ export type DeleteCurrentCustomerAccessTokenResponse = DeleteCurrentCustomerAccessTokenResponses[keyof DeleteCurrentCustomerAccessTokenResponses];
30233
30533
  export type ExchangeEmbedCodeData = {
30234
30534
  body: {
30235
30535
  /**
@@ -32882,12 +33182,9 @@ export type ForkSessionResponses = {
32882
33182
  */
32883
33183
  model: {
32884
33184
  /**
32885
- * The model that will power your agent.
32886
- *
32887
- * See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
32888
- * details and options.
33185
+ * A model id from the Praxis model catalog (`praxis.model.models.list`). Unlike Anthropic, Claude model ids other than those in the catalog are rejected.
32889
33186
  */
32890
- id: 'claude-opus-5-5' | 'claude-fable-5-1' | 'claude-sonnet-5' | 'claude-fable-5' | 'claude-opus-5' | 'claude-opus-4-8' | 'claude-opus-4-7' | 'claude-opus-4-6' | 'claude-sonnet-4-6' | 'claude-haiku-4-5' | 'claude-haiku-4-5-20251001' | 'claude-opus-4-5' | 'claude-opus-4-5-20251101' | 'claude-sonnet-4-5' | 'claude-sonnet-4-5-20250929' | string;
33187
+ id: string;
32891
33188
  /**
32892
33189
  * How hard Claude works on each turn. Sets `output_config.effort` on every
32893
33190
  * Messages call the session makes.
@@ -33047,12 +33344,9 @@ export type ForkSessionResponses = {
33047
33344
  */
33048
33345
  model: {
33049
33346
  /**
33050
- * The model that will power your agent.
33051
- *
33052
- * See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
33053
- * details and options.
33347
+ * A model id from the Praxis model catalog (`praxis.model.models.list`). Unlike Anthropic, Claude model ids other than those in the catalog are rejected.
33054
33348
  */
33055
- id: 'claude-opus-5-5' | 'claude-fable-5-1' | 'claude-sonnet-5' | 'claude-fable-5' | 'claude-opus-5' | 'claude-opus-4-8' | 'claude-opus-4-7' | 'claude-opus-4-6' | 'claude-sonnet-4-6' | 'claude-haiku-4-5' | 'claude-haiku-4-5-20251001' | 'claude-opus-4-5' | 'claude-opus-4-5-20251101' | 'claude-sonnet-4-5' | 'claude-sonnet-4-5-20250929' | string;
33349
+ id: string;
33056
33350
  /**
33057
33351
  * How hard Claude works on each turn. Sets `output_config.effort` on every
33058
33352
  * Messages call the session makes.
@@ -34990,13 +35284,63 @@ export type GetEmbedAppearanceResponses = {
34990
35284
  */
34991
35285
  launcher?: {
34992
35286
  /**
34993
- * Entry control: none hides the launcher, bubble shows a button, mascot shows the image.
35287
+ * Entry control: none hides the launcher, bubble shows a button, mascot shows a character that reacts while the visitor types and the agent thinks and answers. A mascot needs pack.
34994
35288
  */
34995
35289
  type: 'none' | 'bubble' | 'mascot';
34996
35290
  /**
34997
- * Optional HTTPS mascot image URL.
35291
+ * Mascot images: exactly one of preset or images. Send pack, not image.
35292
+ */
35293
+ pack?: {
35294
+ /**
35295
+ * Built-in character: mint (mint support girl), cat (cat-eared girl) or bot (small robot).
35296
+ */
35297
+ preset?: 'mint' | 'cat' | 'bot';
35298
+ /**
35299
+ * One HTTPS image per slot; only idle is required and a missing slot shows idle. Use 2:3 canvases with the feet bottom-centered on a transparent background; PNG or WebP stay still, GIF, WebP and APNG play as they are.
35300
+ */
35301
+ images?: {
35302
+ /**
35303
+ * Resting state.
35304
+ */
35305
+ idle: string;
35306
+ /**
35307
+ * Page open and while the greeting bubble shows.
35308
+ */
35309
+ greet?: string;
35310
+ /**
35311
+ * The visitor is typing in the composer.
35312
+ */
35313
+ listening?: string;
35314
+ /**
35315
+ * After the visitor sends, before the first reply text.
35316
+ */
35317
+ thinking?: string;
35318
+ /**
35319
+ * While the reply streams; alternates with talking-2 every 220 ms.
35320
+ */
35321
+ talking?: string;
35322
+ /**
35323
+ * Second mouth frame of talking, mouth closed; without it talking alternates with idle.
35324
+ */
35325
+ 'talking-2'?: string;
35326
+ /**
35327
+ * The last turn failed or was refused.
35328
+ */
35329
+ sorry?: string;
35330
+ /**
35331
+ * No interaction for 60 seconds; hover or click wakes the mascot.
35332
+ */
35333
+ sleep?: string;
35334
+ };
35335
+ };
35336
+ /**
35337
+ * Legacy single mascot image, read as pack.images.idle. When pack is present, pack wins.
34998
35338
  */
34999
35339
  image?: string;
35340
+ /**
35341
+ * float (default) gently floats the mascot, bounces on hover and waves with the greeting; none keeps it still. Reduced-motion settings always win.
35342
+ */
35343
+ motion?: 'float' | 'none';
35000
35344
  /**
35001
35345
  * Launcher corner: bottom-right is the default; bottom-left uses the opposite corner.
35002
35346
  */
@@ -42752,12 +43096,9 @@ export type SessionsRetrieveResponses = {
42752
43096
  */
42753
43097
  model: {
42754
43098
  /**
42755
- * The model that will power your agent.
42756
- *
42757
- * See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
42758
- * details and options.
43099
+ * A model id from the Praxis model catalog (`praxis.model.models.list`). Unlike Anthropic, Claude model ids other than those in the catalog are rejected.
42759
43100
  */
42760
- id: 'claude-opus-5-5' | 'claude-fable-5-1' | 'claude-sonnet-5' | 'claude-fable-5' | 'claude-opus-5' | 'claude-opus-4-8' | 'claude-opus-4-7' | 'claude-opus-4-6' | 'claude-sonnet-4-6' | 'claude-haiku-4-5' | 'claude-haiku-4-5-20251001' | 'claude-opus-4-5' | 'claude-opus-4-5-20251101' | 'claude-sonnet-4-5' | 'claude-sonnet-4-5-20250929' | string;
43101
+ id: string;
42761
43102
  /**
42762
43103
  * How hard Claude works on each turn. Sets `output_config.effort` on every
42763
43104
  * Messages call the session makes.
@@ -43030,12 +43371,9 @@ export type SessionsUpdateResponses = {
43030
43371
  */
43031
43372
  model: {
43032
43373
  /**
43033
- * The model that will power your agent.
43034
- *
43035
- * See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
43036
- * details and options.
43374
+ * A model id from the Praxis model catalog (`praxis.model.models.list`). Unlike Anthropic, Claude model ids other than those in the catalog are rejected.
43037
43375
  */
43038
- id: 'claude-opus-5-5' | 'claude-fable-5-1' | 'claude-sonnet-5' | 'claude-fable-5' | 'claude-opus-5' | 'claude-opus-4-8' | 'claude-opus-4-7' | 'claude-opus-4-6' | 'claude-sonnet-4-6' | 'claude-haiku-4-5' | 'claude-haiku-4-5-20251001' | 'claude-opus-4-5' | 'claude-opus-4-5-20251101' | 'claude-sonnet-4-5' | 'claude-sonnet-4-5-20250929' | string;
43376
+ id: string;
43039
43377
  /**
43040
43378
  * How hard Claude works on each turn. Sets `output_config.effort` on every
43041
43379
  * Messages call the session makes.
@@ -43289,12 +43627,9 @@ export type AgentsListResponses = {
43289
43627
  */
43290
43628
  model: {
43291
43629
  /**
43292
- * The model that will power your agent.
43293
- *
43294
- * See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
43295
- * details and options.
43630
+ * A model id from the Praxis model catalog (`praxis.model.models.list`). Unlike Anthropic, Claude model ids other than those in the catalog are rejected.
43296
43631
  */
43297
- id: 'claude-opus-5-5' | 'claude-fable-5-1' | 'claude-sonnet-5' | 'claude-fable-5' | 'claude-opus-5' | 'claude-opus-4-8' | 'claude-opus-4-7' | 'claude-opus-4-6' | 'claude-sonnet-4-6' | 'claude-haiku-4-5' | 'claude-haiku-4-5-20251001' | 'claude-opus-4-5' | 'claude-opus-4-5-20251101' | 'claude-sonnet-4-5' | 'claude-sonnet-4-5-20250929' | string;
43632
+ id: string;
43298
43633
  /**
43299
43634
  * How hard Claude works on each turn. Sets `output_config.effort` on every
43300
43635
  * Messages call the session makes.
@@ -43389,7 +43724,7 @@ export type AgentsListResponses = {
43389
43724
  */
43390
43725
  note: string | null;
43391
43726
  /**
43392
- * Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file_..., read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search or browser. At most 20 bindings per type, no repeated type and id, and each service type at most once. Newly added bindings apply only to new sessions; disabling or removing a binding immediately revokes access in running sessions. A resource that is not bound returns 404, a service that is not opened returns 403, and writes to read_only resources are refused. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings.
43727
+ * Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file- plus 24 letters or digits, as the File API returns it; read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search or browser. At most 20 bindings per type, no repeated type and id, and each service type at most once. A session is authorized by the agent version it runs: newly added bindings apply only to new sessions, and a version saved with apply=false changes no access until it is applied. Applying a version that disables, removes or downgrades a binding revokes it immediately in running sessions on older versions. A resource that is not bound returns 404, a service that is not opened returns 403, and a write to a resource bound read_only returns 403 BINDING_READ_ONLY. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings.
43393
43728
  */
43394
43729
  bindings: Array<{
43395
43730
  /**
@@ -43397,7 +43732,7 @@ export type AgentsListResponses = {
43397
43732
  */
43398
43733
  type: 'database' | 'vector_store' | 'file' | 'media_library' | 'model' | 'workflow' | 'script';
43399
43734
  /**
43400
- * Resource id, never its name. database db_..., vector_store vs_..., file file_...; media_library and model ids must not contain ':' or whitespace; workflow and script use <namespace>/<name> with no '/', '@', ':' or whitespace inside a part.
43735
+ * Resource id, never its name. database db_..., vector_store vs_..., file file- plus 24 letters or digits; media_library and model ids must not contain ':' or whitespace; workflow and script use <namespace>/<name> with no '/', '@', ':' or whitespace inside a part.
43401
43736
  */
43402
43737
  id: string;
43403
43738
  /**
@@ -43786,6 +44121,14 @@ export type AgentsListResponses = {
43786
44121
  * Avatar image URL of this agent version (absolute https), shown in agent lists, the agent detail, the chat header and as the default avatar of embedded chat; null when none is set. Follows the version like other configuration: a version saved with apply=false does not change the avatar in effect. /agent/v1 only.
43787
44122
  */
43788
44123
  avatar: string | null;
44124
+ /**
44125
+ * Channel the agent was created through (for example api or console); null for historical agents whose channel is unknown. Display only. /agent/v1 only; /anthropic neither returns it.
44126
+ */
44127
+ creation_source: string | null;
44128
+ /**
44129
+ * Platform-wide identity number of the agent (8 characters), usable wherever an agent is addressed by identity_number; null when the agent has none. /agent/v1 only; /anthropic neither returns it.
44130
+ */
44131
+ identity_number: string | null;
43789
44132
  /**
43790
44133
  * Default environment of this service agent version: the environment_id new sessions get when they name none; null means no environment. Present for service agents only. Follows the version like other configuration: a version saved with apply=false does not change the environment in effect. Versions saved before this field existed read as light. /agent/v1 only.
43791
44134
  */
@@ -43809,19 +44152,13 @@ export type AgentsListResponse = AgentsListResponses[keyof AgentsListResponses];
43809
44152
  export type AgentsCreateData = {
43810
44153
  body: {
43811
44154
  /**
43812
- * Model identifier. Accepts the
43813
- * [model string](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison),
43814
- * e.g. `claude-opus-5`, or a `model_config` object for additional configuration
43815
- * control
44155
+ * A model id from the Praxis model catalog (`praxis.model.models.list`), or a `model_config` object for additional configuration control. Unlike Anthropic, Claude model ids other than those in the catalog are rejected.
43816
44156
  */
43817
- model: 'claude-opus-5-5' | 'claude-fable-5-1' | 'claude-sonnet-5' | 'claude-fable-5' | 'claude-opus-5' | 'claude-opus-4-8' | 'claude-opus-4-7' | 'claude-opus-4-6' | 'claude-sonnet-4-6' | 'claude-haiku-4-5' | 'claude-haiku-4-5-20251001' | 'claude-opus-4-5' | 'claude-opus-4-5-20251101' | 'claude-sonnet-4-5' | 'claude-sonnet-4-5-20250929' | string | {
44157
+ model: string | {
43818
44158
  /**
43819
- * The model that will power your agent.
43820
- *
43821
- * See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
43822
- * details and options.
44159
+ * A model id from the Praxis model catalog (`praxis.model.models.list`). Unlike Anthropic, Claude model ids other than those in the catalog are rejected.
43823
44160
  */
43824
- id: 'claude-opus-5-5' | 'claude-fable-5-1' | 'claude-sonnet-5' | 'claude-fable-5' | 'claude-opus-5' | 'claude-opus-4-8' | 'claude-opus-4-7' | 'claude-opus-4-6' | 'claude-sonnet-4-6' | 'claude-haiku-4-5' | 'claude-haiku-4-5-20251001' | 'claude-opus-4-5' | 'claude-opus-4-5-20251101' | 'claude-sonnet-4-5' | 'claude-sonnet-4-5-20250929' | string;
44161
+ id: string;
43825
44162
  /**
43826
44163
  * How hard Claude works on each inference call. Accepts a bare level string
43827
44164
  * (`"high"`) or `{"type": "high"}`. On create, omitting it resolves the per-model
@@ -43887,7 +44224,7 @@ export type AgentsCreateData = {
43887
44224
  */
43888
44225
  tools?: Array<AgentManaged15 | AgentManaged29 | AgentManaged32>;
43889
44226
  /**
43890
- * Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file_..., read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search or browser. At most 20 bindings per type, no repeated type and id, and each service type at most once. Newly added bindings apply only to new sessions; disabling or removing a binding immediately revokes access in running sessions. A resource that is not bound returns 404, a service that is not opened returns 403, and writes to read_only resources are refused. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings.
44227
+ * Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file- plus 24 letters or digits, as the File API returns it; read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search or browser. At most 20 bindings per type, no repeated type and id, and each service type at most once. A session is authorized by the agent version it runs: newly added bindings apply only to new sessions, and a version saved with apply=false changes no access until it is applied. Applying a version that disables, removes or downgrades a binding revokes it immediately in running sessions on older versions. A resource that is not bound returns 404, a service that is not opened returns 403, and a write to a resource bound read_only returns 403 BINDING_READ_ONLY. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings.
43891
44228
  */
43892
44229
  bindings?: Array<{
43893
44230
  /**
@@ -43895,7 +44232,7 @@ export type AgentsCreateData = {
43895
44232
  */
43896
44233
  type: 'database' | 'vector_store' | 'file' | 'media_library' | 'model' | 'workflow' | 'script';
43897
44234
  /**
43898
- * Resource id, never its name. database db_..., vector_store vs_..., file file_...; media_library and model ids must not contain ':' or whitespace; workflow and script use <namespace>/<name> with no '/', '@', ':' or whitespace inside a part.
44235
+ * Resource id, never its name. database db_..., vector_store vs_..., file file- plus 24 letters or digits; media_library and model ids must not contain ':' or whitespace; workflow and script use <namespace>/<name> with no '/', '@', ':' or whitespace inside a part.
43899
44236
  */
43900
44237
  id: string;
43901
44238
  /**
@@ -44332,12 +44669,9 @@ export type AgentsCreateResponses = {
44332
44669
  */
44333
44670
  model: {
44334
44671
  /**
44335
- * The model that will power your agent.
44336
- *
44337
- * See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
44338
- * details and options.
44672
+ * A model id from the Praxis model catalog (`praxis.model.models.list`). Unlike Anthropic, Claude model ids other than those in the catalog are rejected.
44339
44673
  */
44340
- id: 'claude-opus-5-5' | 'claude-fable-5-1' | 'claude-sonnet-5' | 'claude-fable-5' | 'claude-opus-5' | 'claude-opus-4-8' | 'claude-opus-4-7' | 'claude-opus-4-6' | 'claude-sonnet-4-6' | 'claude-haiku-4-5' | 'claude-haiku-4-5-20251001' | 'claude-opus-4-5' | 'claude-opus-4-5-20251101' | 'claude-sonnet-4-5' | 'claude-sonnet-4-5-20250929' | string;
44674
+ id: string;
44341
44675
  /**
44342
44676
  * How hard Claude works on each turn. Sets `output_config.effort` on every
44343
44677
  * Messages call the session makes.
@@ -44432,7 +44766,7 @@ export type AgentsCreateResponses = {
44432
44766
  */
44433
44767
  note: string | null;
44434
44768
  /**
44435
- * Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file_..., read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search or browser. At most 20 bindings per type, no repeated type and id, and each service type at most once. Newly added bindings apply only to new sessions; disabling or removing a binding immediately revokes access in running sessions. A resource that is not bound returns 404, a service that is not opened returns 403, and writes to read_only resources are refused. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings.
44769
+ * Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file- plus 24 letters or digits, as the File API returns it; read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search or browser. At most 20 bindings per type, no repeated type and id, and each service type at most once. A session is authorized by the agent version it runs: newly added bindings apply only to new sessions, and a version saved with apply=false changes no access until it is applied. Applying a version that disables, removes or downgrades a binding revokes it immediately in running sessions on older versions. A resource that is not bound returns 404, a service that is not opened returns 403, and a write to a resource bound read_only returns 403 BINDING_READ_ONLY. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings.
44436
44770
  */
44437
44771
  bindings: Array<{
44438
44772
  /**
@@ -44440,7 +44774,7 @@ export type AgentsCreateResponses = {
44440
44774
  */
44441
44775
  type: 'database' | 'vector_store' | 'file' | 'media_library' | 'model' | 'workflow' | 'script';
44442
44776
  /**
44443
- * Resource id, never its name. database db_..., vector_store vs_..., file file_...; media_library and model ids must not contain ':' or whitespace; workflow and script use <namespace>/<name> with no '/', '@', ':' or whitespace inside a part.
44777
+ * Resource id, never its name. database db_..., vector_store vs_..., file file- plus 24 letters or digits; media_library and model ids must not contain ':' or whitespace; workflow and script use <namespace>/<name> with no '/', '@', ':' or whitespace inside a part.
44444
44778
  */
44445
44779
  id: string;
44446
44780
  /**
@@ -44829,6 +45163,14 @@ export type AgentsCreateResponses = {
44829
45163
  * Avatar image URL of this agent version (absolute https), shown in agent lists, the agent detail, the chat header and as the default avatar of embedded chat; null when none is set. Follows the version like other configuration: a version saved with apply=false does not change the avatar in effect. /agent/v1 only.
44830
45164
  */
44831
45165
  avatar: string | null;
45166
+ /**
45167
+ * Channel the agent was created through (for example api or console); null for historical agents whose channel is unknown. Display only. /agent/v1 only; /anthropic neither returns it.
45168
+ */
45169
+ creation_source: string | null;
45170
+ /**
45171
+ * Platform-wide identity number of the agent (8 characters), usable wherever an agent is addressed by identity_number; null when the agent has none. /agent/v1 only; /anthropic neither returns it.
45172
+ */
45173
+ identity_number: string | null;
44832
45174
  /**
44833
45175
  * Default environment of this service agent version: the environment_id new sessions get when they name none; null means no environment. Present for service agents only. Follows the version like other configuration: a version saved with apply=false does not change the environment in effect. Versions saved before this field existed read as light. /agent/v1 only.
44834
45176
  */
@@ -44892,12 +45234,9 @@ export type AgentsRetrieveResponses = {
44892
45234
  */
44893
45235
  model: {
44894
45236
  /**
44895
- * The model that will power your agent.
44896
- *
44897
- * See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
44898
- * details and options.
45237
+ * A model id from the Praxis model catalog (`praxis.model.models.list`). Unlike Anthropic, Claude model ids other than those in the catalog are rejected.
44899
45238
  */
44900
- id: 'claude-opus-5-5' | 'claude-fable-5-1' | 'claude-sonnet-5' | 'claude-fable-5' | 'claude-opus-5' | 'claude-opus-4-8' | 'claude-opus-4-7' | 'claude-opus-4-6' | 'claude-sonnet-4-6' | 'claude-haiku-4-5' | 'claude-haiku-4-5-20251001' | 'claude-opus-4-5' | 'claude-opus-4-5-20251101' | 'claude-sonnet-4-5' | 'claude-sonnet-4-5-20250929' | string;
45239
+ id: string;
44901
45240
  /**
44902
45241
  * How hard Claude works on each turn. Sets `output_config.effort` on every
44903
45242
  * Messages call the session makes.
@@ -44992,7 +45331,7 @@ export type AgentsRetrieveResponses = {
44992
45331
  */
44993
45332
  note: string | null;
44994
45333
  /**
44995
- * Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file_..., read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search or browser. At most 20 bindings per type, no repeated type and id, and each service type at most once. Newly added bindings apply only to new sessions; disabling or removing a binding immediately revokes access in running sessions. A resource that is not bound returns 404, a service that is not opened returns 403, and writes to read_only resources are refused. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings.
45334
+ * Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file- plus 24 letters or digits, as the File API returns it; read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search or browser. At most 20 bindings per type, no repeated type and id, and each service type at most once. A session is authorized by the agent version it runs: newly added bindings apply only to new sessions, and a version saved with apply=false changes no access until it is applied. Applying a version that disables, removes or downgrades a binding revokes it immediately in running sessions on older versions. A resource that is not bound returns 404, a service that is not opened returns 403, and a write to a resource bound read_only returns 403 BINDING_READ_ONLY. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings.
44996
45335
  */
44997
45336
  bindings: Array<{
44998
45337
  /**
@@ -45000,7 +45339,7 @@ export type AgentsRetrieveResponses = {
45000
45339
  */
45001
45340
  type: 'database' | 'vector_store' | 'file' | 'media_library' | 'model' | 'workflow' | 'script';
45002
45341
  /**
45003
- * Resource id, never its name. database db_..., vector_store vs_..., file file_...; media_library and model ids must not contain ':' or whitespace; workflow and script use <namespace>/<name> with no '/', '@', ':' or whitespace inside a part.
45342
+ * Resource id, never its name. database db_..., vector_store vs_..., file file- plus 24 letters or digits; media_library and model ids must not contain ':' or whitespace; workflow and script use <namespace>/<name> with no '/', '@', ':' or whitespace inside a part.
45004
45343
  */
45005
45344
  id: string;
45006
45345
  /**
@@ -45389,6 +45728,14 @@ export type AgentsRetrieveResponses = {
45389
45728
  * Avatar image URL of this agent version (absolute https), shown in agent lists, the agent detail, the chat header and as the default avatar of embedded chat; null when none is set. Follows the version like other configuration: a version saved with apply=false does not change the avatar in effect. /agent/v1 only.
45390
45729
  */
45391
45730
  avatar: string | null;
45731
+ /**
45732
+ * Channel the agent was created through (for example api or console); null for historical agents whose channel is unknown. Display only. /agent/v1 only; /anthropic neither returns it.
45733
+ */
45734
+ creation_source: string | null;
45735
+ /**
45736
+ * Platform-wide identity number of the agent (8 characters), usable wherever an agent is addressed by identity_number; null when the agent has none. /agent/v1 only; /anthropic neither returns it.
45737
+ */
45738
+ identity_number: string | null;
45392
45739
  /**
45393
45740
  * Default environment of this service agent version: the environment_id new sessions get when they name none; null means no environment. Present for service agents only. Follows the version like other configuration: a version saved with apply=false does not change the environment in effect. Versions saved before this field existed read as light. /agent/v1 only.
45394
45741
  */
@@ -45421,19 +45768,13 @@ export type AgentsUpdateData = {
45421
45768
  */
45422
45769
  metadata?: null | AgentManaged58Writable;
45423
45770
  /**
45424
- * Model identifier. Accepts the
45425
- * [model string](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison),
45426
- * e.g. `claude-opus-5`, or a `model_config` object for additional configuration
45427
- * control. Omit to preserve. Cannot be cleared.
45771
+ * A model id from the Praxis model catalog (`praxis.model.models.list`), or a `model_config` object for additional configuration control. Unlike Anthropic, Claude model ids other than those in the catalog are rejected.
45428
45772
  */
45429
- model?: 'claude-opus-5-5' | 'claude-fable-5-1' | 'claude-sonnet-5' | 'claude-fable-5' | 'claude-opus-5' | 'claude-opus-4-8' | 'claude-opus-4-7' | 'claude-opus-4-6' | 'claude-sonnet-4-6' | 'claude-haiku-4-5' | 'claude-haiku-4-5-20251001' | 'claude-opus-4-5' | 'claude-opus-4-5-20251101' | 'claude-sonnet-4-5' | 'claude-sonnet-4-5-20250929' | string | {
45773
+ model?: string | {
45430
45774
  /**
45431
- * The model that will power your agent.
45432
- *
45433
- * See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
45434
- * details and options.
45775
+ * A model id from the Praxis model catalog (`praxis.model.models.list`). Unlike Anthropic, Claude model ids other than those in the catalog are rejected.
45435
45776
  */
45436
- id: 'claude-opus-5-5' | 'claude-fable-5-1' | 'claude-sonnet-5' | 'claude-fable-5' | 'claude-opus-5' | 'claude-opus-4-8' | 'claude-opus-4-7' | 'claude-opus-4-6' | 'claude-sonnet-4-6' | 'claude-haiku-4-5' | 'claude-haiku-4-5-20251001' | 'claude-opus-4-5' | 'claude-opus-4-5-20251101' | 'claude-sonnet-4-5' | 'claude-sonnet-4-5-20250929' | string;
45777
+ id: string;
45437
45778
  /**
45438
45779
  * How hard Claude works on each inference call. Accepts a bare level string
45439
45780
  * (`"high"`) or `{"type": "high"}`. On create, omitting it resolves the per-model
@@ -45503,7 +45844,7 @@ export type AgentsUpdateData = {
45503
45844
  */
45504
45845
  version_note?: string;
45505
45846
  /**
45506
- * Replace the whole bindings list; omission preserves it, and null or [] clears it. Additions apply only to new sessions; disabling or removing a binding immediately revokes access in running sessions. Only service agents accept a nonempty list.
45847
+ * Replace the whole bindings list; omission preserves it, and null or [] clears it. Additions apply only to new sessions; once this version is applied, disabling, removing or downgrading a binding revokes it immediately in running sessions on older versions, while apply=false changes no access. Only service agents accept a nonempty list.
45507
45848
  */
45508
45849
  bindings?: Array<{
45509
45850
  /**
@@ -45511,7 +45852,7 @@ export type AgentsUpdateData = {
45511
45852
  */
45512
45853
  type: 'database' | 'vector_store' | 'file' | 'media_library' | 'model' | 'workflow' | 'script';
45513
45854
  /**
45514
- * Resource id, never its name. database db_..., vector_store vs_..., file file_...; media_library and model ids must not contain ':' or whitespace; workflow and script use <namespace>/<name> with no '/', '@', ':' or whitespace inside a part.
45855
+ * Resource id, never its name. database db_..., vector_store vs_..., file file- plus 24 letters or digits; media_library and model ids must not contain ':' or whitespace; workflow and script use <namespace>/<name> with no '/', '@', ':' or whitespace inside a part.
45515
45856
  */
45516
45857
  id: string;
45517
45858
  /**
@@ -45953,12 +46294,9 @@ export type AgentsUpdateResponses = {
45953
46294
  */
45954
46295
  model: {
45955
46296
  /**
45956
- * The model that will power your agent.
45957
- *
45958
- * See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
45959
- * details and options.
46297
+ * A model id from the Praxis model catalog (`praxis.model.models.list`). Unlike Anthropic, Claude model ids other than those in the catalog are rejected.
45960
46298
  */
45961
- id: 'claude-opus-5-5' | 'claude-fable-5-1' | 'claude-sonnet-5' | 'claude-fable-5' | 'claude-opus-5' | 'claude-opus-4-8' | 'claude-opus-4-7' | 'claude-opus-4-6' | 'claude-sonnet-4-6' | 'claude-haiku-4-5' | 'claude-haiku-4-5-20251001' | 'claude-opus-4-5' | 'claude-opus-4-5-20251101' | 'claude-sonnet-4-5' | 'claude-sonnet-4-5-20250929' | string;
46299
+ id: string;
45962
46300
  /**
45963
46301
  * How hard Claude works on each turn. Sets `output_config.effort` on every
45964
46302
  * Messages call the session makes.
@@ -46053,7 +46391,7 @@ export type AgentsUpdateResponses = {
46053
46391
  */
46054
46392
  note: string | null;
46055
46393
  /**
46056
- * Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file_..., read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search or browser. At most 20 bindings per type, no repeated type and id, and each service type at most once. Newly added bindings apply only to new sessions; disabling or removing a binding immediately revokes access in running sessions. A resource that is not bound returns 404, a service that is not opened returns 403, and writes to read_only resources are refused. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings.
46394
+ * Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file- plus 24 letters or digits, as the File API returns it; read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search or browser. At most 20 bindings per type, no repeated type and id, and each service type at most once. A session is authorized by the agent version it runs: newly added bindings apply only to new sessions, and a version saved with apply=false changes no access until it is applied. Applying a version that disables, removes or downgrades a binding revokes it immediately in running sessions on older versions. A resource that is not bound returns 404, a service that is not opened returns 403, and a write to a resource bound read_only returns 403 BINDING_READ_ONLY. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings.
46057
46395
  */
46058
46396
  bindings: Array<{
46059
46397
  /**
@@ -46061,7 +46399,7 @@ export type AgentsUpdateResponses = {
46061
46399
  */
46062
46400
  type: 'database' | 'vector_store' | 'file' | 'media_library' | 'model' | 'workflow' | 'script';
46063
46401
  /**
46064
- * Resource id, never its name. database db_..., vector_store vs_..., file file_...; media_library and model ids must not contain ':' or whitespace; workflow and script use <namespace>/<name> with no '/', '@', ':' or whitespace inside a part.
46402
+ * Resource id, never its name. database db_..., vector_store vs_..., file file- plus 24 letters or digits; media_library and model ids must not contain ':' or whitespace; workflow and script use <namespace>/<name> with no '/', '@', ':' or whitespace inside a part.
46065
46403
  */
46066
46404
  id: string;
46067
46405
  /**
@@ -46450,6 +46788,14 @@ export type AgentsUpdateResponses = {
46450
46788
  * Avatar image URL of this agent version (absolute https), shown in agent lists, the agent detail, the chat header and as the default avatar of embedded chat; null when none is set. Follows the version like other configuration: a version saved with apply=false does not change the avatar in effect. /agent/v1 only.
46451
46789
  */
46452
46790
  avatar: string | null;
46791
+ /**
46792
+ * Channel the agent was created through (for example api or console); null for historical agents whose channel is unknown. Display only. /agent/v1 only; /anthropic neither returns it.
46793
+ */
46794
+ creation_source: string | null;
46795
+ /**
46796
+ * Platform-wide identity number of the agent (8 characters), usable wherever an agent is addressed by identity_number; null when the agent has none. /agent/v1 only; /anthropic neither returns it.
46797
+ */
46798
+ identity_number: string | null;
46453
46799
  /**
46454
46800
  * Default environment of this service agent version: the environment_id new sessions get when they name none; null means no environment. Present for service agents only. Follows the version like other configuration: a version saved with apply=false does not change the environment in effect. Versions saved before this field existed read as light. /agent/v1 only.
46455
46801
  */
@@ -46507,12 +46853,9 @@ export type AgentsArchiveResponses = {
46507
46853
  */
46508
46854
  model: {
46509
46855
  /**
46510
- * The model that will power your agent.
46511
- *
46512
- * See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
46513
- * details and options.
46856
+ * A model id from the Praxis model catalog (`praxis.model.models.list`). Unlike Anthropic, Claude model ids other than those in the catalog are rejected.
46514
46857
  */
46515
- id: 'claude-opus-5-5' | 'claude-fable-5-1' | 'claude-sonnet-5' | 'claude-fable-5' | 'claude-opus-5' | 'claude-opus-4-8' | 'claude-opus-4-7' | 'claude-opus-4-6' | 'claude-sonnet-4-6' | 'claude-haiku-4-5' | 'claude-haiku-4-5-20251001' | 'claude-opus-4-5' | 'claude-opus-4-5-20251101' | 'claude-sonnet-4-5' | 'claude-sonnet-4-5-20250929' | string;
46858
+ id: string;
46516
46859
  /**
46517
46860
  * How hard Claude works on each turn. Sets `output_config.effort` on every
46518
46861
  * Messages call the session makes.
@@ -46607,7 +46950,7 @@ export type AgentsArchiveResponses = {
46607
46950
  */
46608
46951
  note: string | null;
46609
46952
  /**
46610
- * Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file_..., read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search or browser. At most 20 bindings per type, no repeated type and id, and each service type at most once. Newly added bindings apply only to new sessions; disabling or removing a binding immediately revokes access in running sessions. A resource that is not bound returns 404, a service that is not opened returns 403, and writes to read_only resources are refused. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings.
46953
+ * Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file- plus 24 letters or digits, as the File API returns it; read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search or browser. At most 20 bindings per type, no repeated type and id, and each service type at most once. A session is authorized by the agent version it runs: newly added bindings apply only to new sessions, and a version saved with apply=false changes no access until it is applied. Applying a version that disables, removes or downgrades a binding revokes it immediately in running sessions on older versions. A resource that is not bound returns 404, a service that is not opened returns 403, and a write to a resource bound read_only returns 403 BINDING_READ_ONLY. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings.
46611
46954
  */
46612
46955
  bindings: Array<{
46613
46956
  /**
@@ -46615,7 +46958,7 @@ export type AgentsArchiveResponses = {
46615
46958
  */
46616
46959
  type: 'database' | 'vector_store' | 'file' | 'media_library' | 'model' | 'workflow' | 'script';
46617
46960
  /**
46618
- * Resource id, never its name. database db_..., vector_store vs_..., file file_...; media_library and model ids must not contain ':' or whitespace; workflow and script use <namespace>/<name> with no '/', '@', ':' or whitespace inside a part.
46961
+ * Resource id, never its name. database db_..., vector_store vs_..., file file- plus 24 letters or digits; media_library and model ids must not contain ':' or whitespace; workflow and script use <namespace>/<name> with no '/', '@', ':' or whitespace inside a part.
46619
46962
  */
46620
46963
  id: string;
46621
46964
  /**
@@ -47004,6 +47347,14 @@ export type AgentsArchiveResponses = {
47004
47347
  * Avatar image URL of this agent version (absolute https), shown in agent lists, the agent detail, the chat header and as the default avatar of embedded chat; null when none is set. Follows the version like other configuration: a version saved with apply=false does not change the avatar in effect. /agent/v1 only.
47005
47348
  */
47006
47349
  avatar: string | null;
47350
+ /**
47351
+ * Channel the agent was created through (for example api or console); null for historical agents whose channel is unknown. Display only. /agent/v1 only; /anthropic neither returns it.
47352
+ */
47353
+ creation_source: string | null;
47354
+ /**
47355
+ * Platform-wide identity number of the agent (8 characters), usable wherever an agent is addressed by identity_number; null when the agent has none. /agent/v1 only; /anthropic neither returns it.
47356
+ */
47357
+ identity_number: string | null;
47007
47358
  /**
47008
47359
  * Default environment of this service agent version: the environment_id new sessions get when they name none; null means no environment. Present for service agents only. Follows the version like other configuration: a version saved with apply=false does not change the environment in effect. Versions saved before this field existed read as light. /agent/v1 only.
47009
47360
  */
@@ -47071,12 +47422,9 @@ export type AgentsVersionsListResponses = {
47071
47422
  */
47072
47423
  model: {
47073
47424
  /**
47074
- * The model that will power your agent.
47075
- *
47076
- * See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
47077
- * details and options.
47425
+ * A model id from the Praxis model catalog (`praxis.model.models.list`). Unlike Anthropic, Claude model ids other than those in the catalog are rejected.
47078
47426
  */
47079
- id: 'claude-opus-5-5' | 'claude-fable-5-1' | 'claude-sonnet-5' | 'claude-fable-5' | 'claude-opus-5' | 'claude-opus-4-8' | 'claude-opus-4-7' | 'claude-opus-4-6' | 'claude-sonnet-4-6' | 'claude-haiku-4-5' | 'claude-haiku-4-5-20251001' | 'claude-opus-4-5' | 'claude-opus-4-5-20251101' | 'claude-sonnet-4-5' | 'claude-sonnet-4-5-20250929' | string;
47427
+ id: string;
47080
47428
  /**
47081
47429
  * How hard Claude works on each turn. Sets `output_config.effort` on every
47082
47430
  * Messages call the session makes.
@@ -47171,7 +47519,7 @@ export type AgentsVersionsListResponses = {
47171
47519
  */
47172
47520
  note: string | null;
47173
47521
  /**
47174
- * Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file_..., read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search or browser. At most 20 bindings per type, no repeated type and id, and each service type at most once. Newly added bindings apply only to new sessions; disabling or removing a binding immediately revokes access in running sessions. A resource that is not bound returns 404, a service that is not opened returns 403, and writes to read_only resources are refused. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings.
47522
+ * Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file- plus 24 letters or digits, as the File API returns it; read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search or browser. At most 20 bindings per type, no repeated type and id, and each service type at most once. A session is authorized by the agent version it runs: newly added bindings apply only to new sessions, and a version saved with apply=false changes no access until it is applied. Applying a version that disables, removes or downgrades a binding revokes it immediately in running sessions on older versions. A resource that is not bound returns 404, a service that is not opened returns 403, and a write to a resource bound read_only returns 403 BINDING_READ_ONLY. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings.
47175
47523
  */
47176
47524
  bindings: Array<{
47177
47525
  /**
@@ -47179,7 +47527,7 @@ export type AgentsVersionsListResponses = {
47179
47527
  */
47180
47528
  type: 'database' | 'vector_store' | 'file' | 'media_library' | 'model' | 'workflow' | 'script';
47181
47529
  /**
47182
- * Resource id, never its name. database db_..., vector_store vs_..., file file_...; media_library and model ids must not contain ':' or whitespace; workflow and script use <namespace>/<name> with no '/', '@', ':' or whitespace inside a part.
47530
+ * Resource id, never its name. database db_..., vector_store vs_..., file file- plus 24 letters or digits; media_library and model ids must not contain ':' or whitespace; workflow and script use <namespace>/<name> with no '/', '@', ':' or whitespace inside a part.
47183
47531
  */
47184
47532
  id: string;
47185
47533
  /**
@@ -47568,6 +47916,14 @@ export type AgentsVersionsListResponses = {
47568
47916
  * Avatar image URL of this agent version (absolute https), shown in agent lists, the agent detail, the chat header and as the default avatar of embedded chat; null when none is set. Follows the version like other configuration: a version saved with apply=false does not change the avatar in effect. /agent/v1 only.
47569
47917
  */
47570
47918
  avatar: string | null;
47919
+ /**
47920
+ * Channel the agent was created through (for example api or console); null for historical agents whose channel is unknown. Display only. /agent/v1 only; /anthropic neither returns it.
47921
+ */
47922
+ creation_source: string | null;
47923
+ /**
47924
+ * Platform-wide identity number of the agent (8 characters), usable wherever an agent is addressed by identity_number; null when the agent has none. /agent/v1 only; /anthropic neither returns it.
47925
+ */
47926
+ identity_number: string | null;
47571
47927
  /**
47572
47928
  * Default environment of this service agent version: the environment_id new sessions get when they name none; null means no environment. Present for service agents only. Follows the version like other configuration: a version saved with apply=false does not change the environment in effect. Versions saved before this field existed read as light. /agent/v1 only.
47573
47929
  */
@@ -47691,12 +48047,9 @@ export type SessionsListResponses = {
47691
48047
  */
47692
48048
  model: {
47693
48049
  /**
47694
- * The model that will power your agent.
47695
- *
47696
- * See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
47697
- * details and options.
48050
+ * A model id from the Praxis model catalog (`praxis.model.models.list`). Unlike Anthropic, Claude model ids other than those in the catalog are rejected.
47698
48051
  */
47699
- id: 'claude-opus-5-5' | 'claude-fable-5-1' | 'claude-sonnet-5' | 'claude-fable-5' | 'claude-opus-5' | 'claude-opus-4-8' | 'claude-opus-4-7' | 'claude-opus-4-6' | 'claude-sonnet-4-6' | 'claude-haiku-4-5' | 'claude-haiku-4-5-20251001' | 'claude-opus-4-5' | 'claude-opus-4-5-20251101' | 'claude-sonnet-4-5' | 'claude-sonnet-4-5-20250929' | string;
48052
+ id: string;
47700
48053
  /**
47701
48054
  * How hard Claude works on each turn. Sets `output_config.effort` on every
47702
48055
  * Messages call the session makes.
@@ -47999,12 +48352,9 @@ export type SessionsCreateResponses = {
47999
48352
  */
48000
48353
  model: {
48001
48354
  /**
48002
- * The model that will power your agent.
48003
- *
48004
- * See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
48005
- * details and options.
48355
+ * A model id from the Praxis model catalog (`praxis.model.models.list`). Unlike Anthropic, Claude model ids other than those in the catalog are rejected.
48006
48356
  */
48007
- id: 'claude-opus-5-5' | 'claude-fable-5-1' | 'claude-sonnet-5' | 'claude-fable-5' | 'claude-opus-5' | 'claude-opus-4-8' | 'claude-opus-4-7' | 'claude-opus-4-6' | 'claude-sonnet-4-6' | 'claude-haiku-4-5' | 'claude-haiku-4-5-20251001' | 'claude-opus-4-5' | 'claude-opus-4-5-20251101' | 'claude-sonnet-4-5' | 'claude-sonnet-4-5-20250929' | string;
48357
+ id: string;
48008
48358
  /**
48009
48359
  * How hard Claude works on each turn. Sets `output_config.effort` on every
48010
48360
  * Messages call the session makes.
@@ -48237,12 +48587,9 @@ export type SessionsArchiveResponses = {
48237
48587
  */
48238
48588
  model: {
48239
48589
  /**
48240
- * The model that will power your agent.
48241
- *
48242
- * See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
48243
- * details and options.
48590
+ * A model id from the Praxis model catalog (`praxis.model.models.list`). Unlike Anthropic, Claude model ids other than those in the catalog are rejected.
48244
48591
  */
48245
- id: 'claude-opus-5-5' | 'claude-fable-5-1' | 'claude-sonnet-5' | 'claude-fable-5' | 'claude-opus-5' | 'claude-opus-4-8' | 'claude-opus-4-7' | 'claude-opus-4-6' | 'claude-sonnet-4-6' | 'claude-haiku-4-5' | 'claude-haiku-4-5-20251001' | 'claude-opus-4-5' | 'claude-opus-4-5-20251101' | 'claude-sonnet-4-5' | 'claude-sonnet-4-5-20250929' | string;
48592
+ id: string;
48246
48593
  /**
48247
48594
  * How hard Claude works on each turn. Sets `output_config.effort` on every
48248
48595
  * Messages call the session makes.