@deepraxis/sdk 0.1.0-dev.722c0d4 → 0.1.0-dev.7ee6a7d

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.
@@ -743,7 +743,7 @@ export declare const sessionsList: <ThrowOnError extends boolean = false>(option
743
743
  /**
744
744
  * Create session
745
745
  *
746
- * Create a session: one conversation with an agent, running on a machine. Pass agent as an agent id (latest 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 environment_id for a sandbox recipe. 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.
746
+ * Create a session: one conversation with an agent, running on a machine. Pass agent as an agent id (latest 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 environment_id for a sandbox recipe. Optional model must be one of the agent's allowed models; optional thinking is {effort: low|medium|high|xhigh|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.
747
747
  */
748
748
  export declare const sessionsCreate: <ThrowOnError extends boolean = false>(options: Options<SessionsCreateData, ThrowOnError>) => RequestResult<SessionsCreateResponses, unknown, ThrowOnError>;
749
749
  /**
@@ -2108,7 +2108,7 @@ export const sessionsList = (options) => (options?.client ?? client).get({
2108
2108
  /**
2109
2109
  * Create session
2110
2110
  *
2111
- * Create a session: one conversation with an agent, running on a machine. Pass agent as an agent id (latest 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 environment_id for a sandbox recipe. 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.
2111
+ * Create a session: one conversation with an agent, running on a machine. Pass agent as an agent id (latest 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 environment_id for a sandbox recipe. Optional model must be one of the agent's allowed models; optional thinking is {effort: low|medium|high|xhigh|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.
2112
2112
  */
2113
2113
  export const sessionsCreate = (options) => (options.client ?? client).post({
2114
2114
  security: [{
@@ -3790,12 +3790,9 @@ export type SandboxSandboxDetail = {
3790
3790
  */
3791
3791
  volumeMounts?: Array<SandboxSandboxVolumeMount>;
3792
3792
  };
3793
- /**
3794
- * Praxis extension: Streamable HTTP, SSE or trusted stdio MCP servers, persisted with the agent version. Optional fields remain omitted when not supplied.
3795
- */
3796
3793
  export type AgentManaged36 = {
3797
3794
  /**
3798
- * Streamable HTTP transport.
3795
+ * Always `url`. An MCP server reached over a URL.
3799
3796
  */
3800
3797
  type: 'url';
3801
3798
  /**
@@ -3803,69 +3800,9 @@ export type AgentManaged36 = {
3803
3800
  */
3804
3801
  name: string;
3805
3802
  /**
3806
- * HTTP or HTTPS MCP server endpoint.
3807
- */
3808
- url: string;
3809
- /**
3810
- * Praxis extension: request headers. Platform identity headers take precedence, case-insensitively.
3811
- */
3812
- headers?: {
3813
- [key: string]: string;
3814
- };
3815
- /**
3816
- * Praxis extension: timeout in milliseconds. Applied to stdio; HTTP/SSE currently use the connection SDK default.
3817
- */
3818
- timeout_ms?: number;
3819
- } | {
3820
- /**
3821
- * Legacy SSE transport.
3822
- */
3823
- type: 'sse';
3824
- /**
3825
- * Name of the MCP server; the mcp_toolset entry that refers to it uses the same name in mcp_server_name.
3826
- */
3827
- name: string;
3828
- /**
3829
- * HTTP or HTTPS MCP server endpoint.
3803
+ * http(s) endpoint of the MCP server, at most 2048 characters.
3830
3804
  */
3831
3805
  url: string;
3832
- /**
3833
- * Praxis extension: request headers. Platform identity headers take precedence, case-insensitively.
3834
- */
3835
- headers?: {
3836
- [key: string]: string;
3837
- };
3838
- /**
3839
- * Praxis extension: timeout in milliseconds. Applied to stdio; HTTP/SSE currently use the connection SDK default.
3840
- */
3841
- timeout_ms?: number;
3842
- } | {
3843
- /**
3844
- * Run a command on the agent computer.
3845
- */
3846
- type: 'stdio';
3847
- /**
3848
- * Name of the MCP server; the mcp_toolset entry that refers to it uses the same name in mcp_server_name.
3849
- */
3850
- name: string;
3851
- /**
3852
- * Executable command on the agent computer.
3853
- */
3854
- command: string;
3855
- /**
3856
- * Command arguments; omitted means no arguments.
3857
- */
3858
- args?: Array<string>;
3859
- /**
3860
- * Praxis extension: environment variables for the command on the agent computer.
3861
- */
3862
- env?: {
3863
- [key: string]: string;
3864
- };
3865
- /**
3866
- * Praxis extension: timeout in milliseconds. Applied to stdio; HTTP/SSE currently use the connection SDK default.
3867
- */
3868
- timeout_ms?: number;
3869
3806
  };
3870
3807
  /**
3871
3808
  * Free-form string key/value pairs stored with the agent for your own bookkeeping.
@@ -3975,7 +3912,7 @@ export type AgentManaged44 = {
3975
3912
  type: 'agent_toolset_20260401';
3976
3913
  };
3977
3914
  /**
3978
- * Exactly one toolset per declared MCP server. Tools default to enabled and always_ask; per-tool overrides inherit omitted settings.
3915
+ * Exactly one toolset per declared MCP server. Tools default to enabled and always_ask; per-tool overrides inherit omitted settings. Credentials are not supported.
3979
3916
  */
3980
3917
  export type AgentManaged54 = {
3981
3918
  /**
@@ -4045,9 +3982,6 @@ export type AgentManaged57 = {
4045
3982
  */
4046
3983
  type: 'custom';
4047
3984
  };
4048
- /**
4049
- * Praxis extension: Streamable HTTP, SSE or trusted stdio MCP servers, persisted with the agent version. Optional fields remain omitted when not supplied.
4050
- */
4051
3985
  export type AgentManaged7 = {
4052
3986
  /**
4053
3987
  * URL transport for an MCP server declared on the agent.
@@ -4058,69 +3992,9 @@ export type AgentManaged7 = {
4058
3992
  */
4059
3993
  name: string;
4060
3994
  /**
4061
- * HTTP or HTTPS MCP server endpoint.
3995
+ * http(s) endpoint of the MCP server, at most 2048 characters.
4062
3996
  */
4063
3997
  url: string;
4064
- /**
4065
- * Praxis extension: request headers. Platform identity headers take precedence, case-insensitively.
4066
- */
4067
- headers?: {
4068
- [key: string]: string;
4069
- };
4070
- /**
4071
- * Praxis extension: timeout in milliseconds. Applied to stdio; HTTP/SSE currently use the connection SDK default.
4072
- */
4073
- timeout_ms?: number;
4074
- } | {
4075
- /**
4076
- * Legacy SSE transport.
4077
- */
4078
- type: 'sse';
4079
- /**
4080
- * Name of the MCP server; the mcp_toolset entry that refers to it uses the same name in mcp_server_name.
4081
- */
4082
- name: string;
4083
- /**
4084
- * HTTP or HTTPS MCP server endpoint.
4085
- */
4086
- url: string;
4087
- /**
4088
- * Praxis extension: request headers. Platform identity headers take precedence, case-insensitively.
4089
- */
4090
- headers?: {
4091
- [key: string]: string;
4092
- };
4093
- /**
4094
- * Praxis extension: timeout in milliseconds. Applied to stdio; HTTP/SSE currently use the connection SDK default.
4095
- */
4096
- timeout_ms?: number;
4097
- } | {
4098
- /**
4099
- * Run a command on the agent computer.
4100
- */
4101
- type: 'stdio';
4102
- /**
4103
- * Name of the MCP server; the mcp_toolset entry that refers to it uses the same name in mcp_server_name.
4104
- */
4105
- name: string;
4106
- /**
4107
- * Executable command on the agent computer.
4108
- */
4109
- command: string;
4110
- /**
4111
- * Command arguments; omitted means no arguments.
4112
- */
4113
- args?: Array<string>;
4114
- /**
4115
- * Praxis extension: environment variables for the command on the agent computer.
4116
- */
4117
- env?: {
4118
- [key: string]: string;
4119
- };
4120
- /**
4121
- * Praxis extension: timeout in milliseconds. Applied to stdio; HTTP/SSE currently use the connection SDK default.
4122
- */
4123
- timeout_ms?: number;
4124
3998
  };
4125
3999
  /**
4126
4000
  * Free-form string key/value pairs.
@@ -4204,7 +4078,7 @@ export type AgentManaged15 = {
4204
4078
  default_config?: null | AgentManaged28;
4205
4079
  };
4206
4080
  /**
4207
- * Exactly one toolset per declared MCP server. Tools default to enabled and always_ask; per-tool overrides inherit omitted settings.
4081
+ * Exactly one toolset per declared MCP server. Tools default to enabled and always_ask; per-tool overrides inherit omitted settings. Credentials are not supported.
4208
4082
  */
4209
4083
  export type AgentManaged29 = {
4210
4084
  /**
@@ -4509,7 +4383,8 @@ export type AgentManaged167 = {
4509
4383
  */
4510
4384
  type: 'agent_with_overrides';
4511
4385
  /**
4512
- * Praxis extension: HTTP, SSE or trusted stdio MCP servers paired with mcp_toolset entries and saved with the agent version.
4386
+ * Replacement MCP server list. Full replacement: the provided array becomes the
4387
+ * MCP servers. Send an empty array to clear; omit to preserve the agent's servers.
4513
4388
  */
4514
4389
  mcp_servers?: Array<AgentManaged7>;
4515
4390
  /**
@@ -4632,7 +4507,8 @@ export type AgentManaged83 = {
4632
4507
  */
4633
4508
  export type AgentManaged182 = {
4634
4509
  /**
4635
- * Praxis extension: HTTP, SSE or trusted stdio MCP servers paired with mcp_toolset entries and saved with the agent version.
4510
+ * Replacement MCP server list. Full replacement: the provided array becomes the
4511
+ * new value. Send an empty array to clear; omit to preserve.
4636
4512
  */
4637
4513
  mcp_servers?: Array<AgentManaged7>;
4638
4514
  /**
@@ -5343,7 +5219,7 @@ export type AgentManaged170 = {
5343
5219
  */
5344
5220
  description: null | string;
5345
5221
  /**
5346
- * Praxis extension: HTTP, SSE or trusted stdio MCP servers paired with mcp_toolset entries and saved with the agent version.
5222
+ * URL MCP servers the agent can call, paired one-to-one with mcp_toolset entries in tools and saved with the agent version. No credentials are stored here.
5347
5223
  */
5348
5224
  mcp_servers: Array<AgentManaged36>;
5349
5225
  /**
@@ -6238,16 +6114,6 @@ export type AgentSseEvent = ({
6238
6114
  * Praxis extension (MCP Apps, SEP-1865): present when `source` is `codemode`; the id of the codemode tool use whose program made this call. Absent otherwise.
6239
6115
  */
6240
6116
  parent_tool_use_id?: string;
6241
- /**
6242
- * Human-readable tool name from MCP 2025-06-18 Tool.title, falling back to annotations.title. Trimmed and truncated to 200 characters; omitted when blank or absent. Present only for model-initiated calls on /agent/v1; use name when absent.
6243
- */
6244
- title?: string;
6245
- /**
6246
- * Display labels keyed by top-level input property name, from MCP inputSchema.properties titles. Only nonempty string titles are included, trimmed and truncated to 100 characters each; omitted when none. Present only for model-initiated calls on /agent/v1; use the input key when a label is absent.
6247
- */
6248
- input_titles?: {
6249
- [key: string]: string;
6250
- };
6251
6117
  };
6252
6118
  } | {
6253
6119
  /**
@@ -17428,7 +17294,7 @@ export type AgentManaged172 = {
17428
17294
  */
17429
17295
  description: null | string;
17430
17296
  /**
17431
- * Praxis extension: HTTP, SSE or trusted stdio MCP servers paired with mcp_toolset entries and saved with the agent version.
17297
+ * URL MCP servers the agent can call, paired one-to-one with mcp_toolset entries in tools and saved with the agent version. No credentials are stored here.
17432
17298
  */
17433
17299
  mcp_servers: Array<AgentManaged36>;
17434
17300
  /**
@@ -18506,16 +18372,6 @@ export type AgentSseData = {
18506
18372
  * Praxis extension (MCP Apps, SEP-1865): present when `source` is `codemode`; the id of the codemode tool use whose program made this call. Absent otherwise.
18507
18373
  */
18508
18374
  parent_tool_use_id?: string;
18509
- /**
18510
- * Human-readable tool name from MCP 2025-06-18 Tool.title, falling back to annotations.title. Trimmed and truncated to 200 characters; omitted when blank or absent. Present only for model-initiated calls on /agent/v1; use name when absent.
18511
- */
18512
- title?: string;
18513
- /**
18514
- * Display labels keyed by top-level input property name, from MCP inputSchema.properties titles. Only nonempty string titles are included, trimmed and truncated to 100 characters each; omitted when none. Present only for model-initiated calls on /agent/v1; use the input key when a label is absent.
18515
- */
18516
- input_titles?: {
18517
- [key: string]: string;
18518
- };
18519
18375
  } | {
18520
18376
  /**
18521
18377
  * Unique identifier for this event.
@@ -28354,7 +28210,7 @@ export type GetSessionContextResponses = {
28354
28210
  /**
28355
28211
  * Thinking levels the model accepts as effort, in ascending order.
28356
28212
  */
28357
- efforts: Array<'low' | 'medium' | 'high' | 'xhigh' | 'max'>;
28213
+ efforts: Array<'low' | 'medium' | 'high' | 'xhigh'>;
28358
28214
  /**
28359
28215
  * Whether effort none (thinking off) is allowed for this model.
28360
28216
  */
@@ -28362,7 +28218,7 @@ export type GetSessionContextResponses = {
28362
28218
  /**
28363
28219
  * Thinking level used when neither the session nor the agent selects one; null when the model states no default.
28364
28220
  */
28365
- default_effort: 'low' | 'medium' | 'high' | 'xhigh' | 'max' | null;
28221
+ default_effort: 'low' | 'medium' | 'high' | 'xhigh' | null;
28366
28222
  } | null;
28367
28223
  };
28368
28224
  /**
@@ -28663,7 +28519,7 @@ export type ForkSessionResponses = {
28663
28519
  /**
28664
28520
  * Default thinking effort for sessions without an explicit selection. Unsupported defaults fall back to the selected model default.
28665
28521
  */
28666
- reasoning?: 'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'none';
28522
+ reasoning?: 'low' | 'medium' | 'high' | 'xhigh' | 'none';
28667
28523
  };
28668
28524
  };
28669
28525
  /**
@@ -30075,7 +29931,7 @@ export type ForkSessionResponses = {
30075
29931
  /**
30076
29932
  * Thinking levels the model accepts as effort, in ascending order.
30077
29933
  */
30078
- efforts: Array<'low' | 'medium' | 'high' | 'xhigh' | 'max'>;
29934
+ efforts: Array<'low' | 'medium' | 'high' | 'xhigh'>;
30079
29935
  /**
30080
29936
  * Whether effort none (thinking off) is allowed for this model.
30081
29937
  */
@@ -30083,7 +29939,7 @@ export type ForkSessionResponses = {
30083
29939
  /**
30084
29940
  * Thinking level used when neither the session nor the agent selects one; null when the model states no default.
30085
29941
  */
30086
- default_effort: 'low' | 'medium' | 'high' | 'xhigh' | 'max' | null;
29942
+ default_effort: 'low' | 'medium' | 'high' | 'xhigh' | null;
30087
29943
  } | null;
30088
29944
  };
30089
29945
  /**
@@ -30091,9 +29947,9 @@ export type ForkSessionResponses = {
30091
29947
  */
30092
29948
  thinking?: {
30093
29949
  /**
30094
- * Thinking level saved for this session: low, medium, high, xhigh, max, or none to turn thinking off. Null or absent means the session inherits the agent default and then the model default.
29950
+ * Thinking level saved for this session: low, medium, high, xhigh, or none to turn thinking off. Null or absent means the session inherits the agent default and then the model default.
30095
29951
  */
30096
- effort: 'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'none';
29952
+ effort: 'low' | 'medium' | 'high' | 'xhigh' | 'none';
30097
29953
  } | null;
30098
29954
  /**
30099
29955
  * Praxis extension: source of a forked session; null for other sessions. Available only on /agent/v1.
@@ -37461,7 +37317,7 @@ export type AgentsListResponses = {
37461
37317
  */
37462
37318
  description: null | string;
37463
37319
  /**
37464
- * Praxis extension: HTTP, SSE or trusted stdio MCP servers paired with mcp_toolset entries and saved with the agent version.
37320
+ * URL MCP servers the agent can call, paired one-to-one with mcp_toolset entries in tools and saved with the agent version. No credentials are stored here.
37465
37321
  */
37466
37322
  mcp_servers: Array<AgentManaged36>;
37467
37323
  metadata: AgentManaged37;
@@ -37499,7 +37355,7 @@ export type AgentsListResponses = {
37499
37355
  /**
37500
37356
  * Default thinking effort for sessions without an explicit selection. Unsupported defaults fall back to the selected model default.
37501
37357
  */
37502
- reasoning?: 'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'none';
37358
+ reasoning?: 'low' | 'medium' | 'high' | 'xhigh' | 'none';
37503
37359
  };
37504
37360
  };
37505
37361
  /**
@@ -37944,7 +37800,7 @@ export type AgentsCreateData = {
37944
37800
  /**
37945
37801
  * Default thinking level for this agent. A session selection takes precedence; an unsupported default falls back to the model default.
37946
37802
  */
37947
- reasoning?: 'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'none';
37803
+ reasoning?: 'low' | 'medium' | 'high' | 'xhigh' | 'none';
37948
37804
  };
37949
37805
  };
37950
37806
  /**
@@ -37956,7 +37812,10 @@ export type AgentsCreateData = {
37956
37812
  */
37957
37813
  description?: null | string;
37958
37814
  /**
37959
- * Praxis extension: HTTP, SSE or trusted stdio MCP servers paired with mcp_toolset entries and saved with the agent version.
37815
+ * MCP servers this agent connects to. Maximum 20. Names must be unique
37816
+ * within the array. Every server must be referenced by an `mcp_toolset` in
37817
+ * `tools`; unreferenced servers are rejected. See the
37818
+ * [MCP connector guide](https://platform.claude.com/docs/en/managed-agents/mcp-connector).
37960
37819
  */
37961
37820
  mcp_servers?: Array<AgentManaged7>;
37962
37821
  /**
@@ -38370,7 +38229,7 @@ export type AgentsCreateResponses = {
38370
38229
  */
38371
38230
  description: null | string;
38372
38231
  /**
38373
- * Praxis extension: HTTP, SSE or trusted stdio MCP servers paired with mcp_toolset entries and saved with the agent version.
38232
+ * URL MCP servers the agent can call, paired one-to-one with mcp_toolset entries in tools and saved with the agent version. No credentials are stored here.
38374
38233
  */
38375
38234
  mcp_servers: Array<AgentManaged36>;
38376
38235
  metadata: AgentManaged37;
@@ -38408,7 +38267,7 @@ export type AgentsCreateResponses = {
38408
38267
  /**
38409
38268
  * Default thinking effort for sessions without an explicit selection. Unsupported defaults fall back to the selected model default.
38410
38269
  */
38411
- reasoning?: 'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'none';
38270
+ reasoning?: 'low' | 'medium' | 'high' | 'xhigh' | 'none';
38412
38271
  };
38413
38272
  };
38414
38273
  /**
@@ -38846,7 +38705,7 @@ export type AgentsRetrieveResponses = {
38846
38705
  */
38847
38706
  description: null | string;
38848
38707
  /**
38849
- * Praxis extension: HTTP, SSE or trusted stdio MCP servers paired with mcp_toolset entries and saved with the agent version.
38708
+ * URL MCP servers the agent can call, paired one-to-one with mcp_toolset entries in tools and saved with the agent version. No credentials are stored here.
38850
38709
  */
38851
38710
  mcp_servers: Array<AgentManaged36>;
38852
38711
  metadata: AgentManaged37;
@@ -38884,7 +38743,7 @@ export type AgentsRetrieveResponses = {
38884
38743
  /**
38885
38744
  * Default thinking effort for sessions without an explicit selection. Unsupported defaults fall back to the selected model default.
38886
38745
  */
38887
- reasoning?: 'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'none';
38746
+ reasoning?: 'low' | 'medium' | 'high' | 'xhigh' | 'none';
38888
38747
  };
38889
38748
  };
38890
38749
  /**
@@ -39290,7 +39149,11 @@ export type AgentsUpdateData = {
39290
39149
  */
39291
39150
  description?: null | string;
39292
39151
  /**
39293
- * Praxis extension: HTTP, SSE or trusted stdio MCP servers paired with mcp_toolset entries and saved with the agent version.
39152
+ * MCP servers. Full replacement. Omit to preserve; send empty array or
39153
+ * `null` to clear. Names must be unique. Maximum 20. Every server must be
39154
+ * referenced by an `mcp_toolset` in the agent's resulting `tools`; unreferenced
39155
+ * servers are rejected. See the
39156
+ * [MCP connector guide](https://platform.claude.com/docs/en/managed-agents/mcp-connector).
39294
39157
  */
39295
39158
  mcp_servers?: null | Array<AgentManaged7>;
39296
39159
  /**
@@ -39338,7 +39201,7 @@ export type AgentsUpdateData = {
39338
39201
  /**
39339
39202
  * Default thinking level for this agent. A session selection takes precedence; an unsupported default falls back to the model default.
39340
39203
  */
39341
- reasoning?: 'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'none';
39204
+ reasoning?: 'low' | 'medium' | 'high' | 'xhigh' | 'none';
39342
39205
  };
39343
39206
  };
39344
39207
  /**
@@ -39765,7 +39628,7 @@ export type AgentsUpdateResponses = {
39765
39628
  */
39766
39629
  description: null | string;
39767
39630
  /**
39768
- * Praxis extension: HTTP, SSE or trusted stdio MCP servers paired with mcp_toolset entries and saved with the agent version.
39631
+ * URL MCP servers the agent can call, paired one-to-one with mcp_toolset entries in tools and saved with the agent version. No credentials are stored here.
39769
39632
  */
39770
39633
  mcp_servers: Array<AgentManaged36>;
39771
39634
  metadata: AgentManaged37;
@@ -39803,7 +39666,7 @@ export type AgentsUpdateResponses = {
39803
39666
  /**
39804
39667
  * Default thinking effort for sessions without an explicit selection. Unsupported defaults fall back to the selected model default.
39805
39668
  */
39806
- reasoning?: 'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'none';
39669
+ reasoning?: 'low' | 'medium' | 'high' | 'xhigh' | 'none';
39807
39670
  };
39808
39671
  };
39809
39672
  /**
@@ -40235,7 +40098,7 @@ export type AgentsArchiveResponses = {
40235
40098
  */
40236
40099
  description: null | string;
40237
40100
  /**
40238
- * Praxis extension: HTTP, SSE or trusted stdio MCP servers paired with mcp_toolset entries and saved with the agent version.
40101
+ * URL MCP servers the agent can call, paired one-to-one with mcp_toolset entries in tools and saved with the agent version. No credentials are stored here.
40239
40102
  */
40240
40103
  mcp_servers: Array<AgentManaged36>;
40241
40104
  metadata: AgentManaged37;
@@ -40273,7 +40136,7 @@ export type AgentsArchiveResponses = {
40273
40136
  /**
40274
40137
  * Default thinking effort for sessions without an explicit selection. Unsupported defaults fall back to the selected model default.
40275
40138
  */
40276
- reasoning?: 'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'none';
40139
+ reasoning?: 'low' | 'medium' | 'high' | 'xhigh' | 'none';
40277
40140
  };
40278
40141
  };
40279
40142
  /**
@@ -40715,7 +40578,7 @@ export type AgentsVersionsListResponses = {
40715
40578
  */
40716
40579
  description: null | string;
40717
40580
  /**
40718
- * Praxis extension: HTTP, SSE or trusted stdio MCP servers paired with mcp_toolset entries and saved with the agent version.
40581
+ * URL MCP servers the agent can call, paired one-to-one with mcp_toolset entries in tools and saved with the agent version. No credentials are stored here.
40719
40582
  */
40720
40583
  mcp_servers: Array<AgentManaged36>;
40721
40584
  metadata: AgentManaged37;
@@ -40753,7 +40616,7 @@ export type AgentsVersionsListResponses = {
40753
40616
  /**
40754
40617
  * Default thinking effort for sessions without an explicit selection. Unsupported defaults fall back to the selected model default.
40755
40618
  */
40756
- reasoning?: 'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'none';
40619
+ reasoning?: 'low' | 'medium' | 'high' | 'xhigh' | 'none';
40757
40620
  };
40758
40621
  };
40759
40622
  /**
@@ -41244,7 +41107,7 @@ export type SessionsListResponses = {
41244
41107
  */
41245
41108
  description: null | string;
41246
41109
  /**
41247
- * Praxis extension: HTTP, SSE or trusted stdio MCP servers paired with mcp_toolset entries and saved with the agent version.
41110
+ * URL MCP servers the agent can call, paired one-to-one with mcp_toolset entries in tools and saved with the agent version. No credentials are stored here.
41248
41111
  */
41249
41112
  mcp_servers: Array<AgentManaged36>;
41250
41113
  /**
@@ -41281,7 +41144,7 @@ export type SessionsListResponses = {
41281
41144
  /**
41282
41145
  * Default thinking effort for sessions without an explicit selection. Unsupported defaults fall back to the selected model default.
41283
41146
  */
41284
- reasoning?: 'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'none';
41147
+ reasoning?: 'low' | 'medium' | 'high' | 'xhigh' | 'none';
41285
41148
  };
41286
41149
  };
41287
41150
  /**
@@ -41404,7 +41267,7 @@ export type SessionsListResponses = {
41404
41267
  /**
41405
41268
  * Thinking levels the model accepts as effort, in ascending order.
41406
41269
  */
41407
- efforts: Array<'low' | 'medium' | 'high' | 'xhigh' | 'max'>;
41270
+ efforts: Array<'low' | 'medium' | 'high' | 'xhigh'>;
41408
41271
  /**
41409
41272
  * Whether effort none (thinking off) is allowed for this model.
41410
41273
  */
@@ -41412,7 +41275,7 @@ export type SessionsListResponses = {
41412
41275
  /**
41413
41276
  * Thinking level used when neither the session nor the agent selects one; null when the model states no default.
41414
41277
  */
41415
- default_effort: 'low' | 'medium' | 'high' | 'xhigh' | 'max' | null;
41278
+ default_effort: 'low' | 'medium' | 'high' | 'xhigh' | null;
41416
41279
  } | null;
41417
41280
  };
41418
41281
  /**
@@ -41420,9 +41283,9 @@ export type SessionsListResponses = {
41420
41283
  */
41421
41284
  thinking?: {
41422
41285
  /**
41423
- * Thinking level saved for this session: low, medium, high, xhigh, max, or none to turn thinking off. Null or absent means the session inherits the agent default and then the model default.
41286
+ * Thinking level saved for this session: low, medium, high, xhigh, or none to turn thinking off. Null or absent means the session inherits the agent default and then the model default.
41424
41287
  */
41425
- effort: 'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'none';
41288
+ effort: 'low' | 'medium' | 'high' | 'xhigh' | 'none';
41426
41289
  } | null;
41427
41290
  /**
41428
41291
  * Praxis extension: source of a forked session; null for other sessions. Available only on /agent/v1.
@@ -41515,7 +41378,7 @@ export type SessionsCreateData = {
41515
41378
  /**
41516
41379
  * Thinking level for this session. The model must support the chosen effort; none requires can_disable. Null on thinking restores inheritance from the agent and model.
41517
41380
  */
41518
- effort: 'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'none';
41381
+ effort: 'low' | 'medium' | 'high' | 'xhigh' | 'none';
41519
41382
  } | null;
41520
41383
  };
41521
41384
  path?: never;
@@ -41545,7 +41408,7 @@ export type SessionsCreateResponses = {
41545
41408
  */
41546
41409
  description: null | string;
41547
41410
  /**
41548
- * Praxis extension: HTTP, SSE or trusted stdio MCP servers paired with mcp_toolset entries and saved with the agent version.
41411
+ * URL MCP servers the agent can call, paired one-to-one with mcp_toolset entries in tools and saved with the agent version. No credentials are stored here.
41549
41412
  */
41550
41413
  mcp_servers: Array<AgentManaged36>;
41551
41414
  /**
@@ -41582,7 +41445,7 @@ export type SessionsCreateResponses = {
41582
41445
  /**
41583
41446
  * Default thinking effort for sessions without an explicit selection. Unsupported defaults fall back to the selected model default.
41584
41447
  */
41585
- reasoning?: 'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'none';
41448
+ reasoning?: 'low' | 'medium' | 'high' | 'xhigh' | 'none';
41586
41449
  };
41587
41450
  };
41588
41451
  /**
@@ -41705,7 +41568,7 @@ export type SessionsCreateResponses = {
41705
41568
  /**
41706
41569
  * Thinking levels the model accepts as effort, in ascending order.
41707
41570
  */
41708
- efforts: Array<'low' | 'medium' | 'high' | 'xhigh' | 'max'>;
41571
+ efforts: Array<'low' | 'medium' | 'high' | 'xhigh'>;
41709
41572
  /**
41710
41573
  * Whether effort none (thinking off) is allowed for this model.
41711
41574
  */
@@ -41713,7 +41576,7 @@ export type SessionsCreateResponses = {
41713
41576
  /**
41714
41577
  * Thinking level used when neither the session nor the agent selects one; null when the model states no default.
41715
41578
  */
41716
- default_effort: 'low' | 'medium' | 'high' | 'xhigh' | 'max' | null;
41579
+ default_effort: 'low' | 'medium' | 'high' | 'xhigh' | null;
41717
41580
  } | null;
41718
41581
  };
41719
41582
  /**
@@ -41721,9 +41584,9 @@ export type SessionsCreateResponses = {
41721
41584
  */
41722
41585
  thinking?: {
41723
41586
  /**
41724
- * Thinking level saved for this session: low, medium, high, xhigh, max, or none to turn thinking off. Null or absent means the session inherits the agent default and then the model default.
41587
+ * Thinking level saved for this session: low, medium, high, xhigh, or none to turn thinking off. Null or absent means the session inherits the agent default and then the model default.
41725
41588
  */
41726
- effort: 'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'none';
41589
+ effort: 'low' | 'medium' | 'high' | 'xhigh' | 'none';
41727
41590
  } | null;
41728
41591
  /**
41729
41592
  * Praxis extension: source of a forked session; null for other sessions. Available only on /agent/v1.
@@ -41775,7 +41638,7 @@ export type SessionsRetrieveResponses = {
41775
41638
  */
41776
41639
  description: null | string;
41777
41640
  /**
41778
- * Praxis extension: HTTP, SSE or trusted stdio MCP servers paired with mcp_toolset entries and saved with the agent version.
41641
+ * URL MCP servers the agent can call, paired one-to-one with mcp_toolset entries in tools and saved with the agent version. No credentials are stored here.
41779
41642
  */
41780
41643
  mcp_servers: Array<AgentManaged36>;
41781
41644
  /**
@@ -41812,7 +41675,7 @@ export type SessionsRetrieveResponses = {
41812
41675
  /**
41813
41676
  * Default thinking effort for sessions without an explicit selection. Unsupported defaults fall back to the selected model default.
41814
41677
  */
41815
- reasoning?: 'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'none';
41678
+ reasoning?: 'low' | 'medium' | 'high' | 'xhigh' | 'none';
41816
41679
  };
41817
41680
  };
41818
41681
  /**
@@ -41935,7 +41798,7 @@ export type SessionsRetrieveResponses = {
41935
41798
  /**
41936
41799
  * Thinking levels the model accepts as effort, in ascending order.
41937
41800
  */
41938
- efforts: Array<'low' | 'medium' | 'high' | 'xhigh' | 'max'>;
41801
+ efforts: Array<'low' | 'medium' | 'high' | 'xhigh'>;
41939
41802
  /**
41940
41803
  * Whether effort none (thinking off) is allowed for this model.
41941
41804
  */
@@ -41943,7 +41806,7 @@ export type SessionsRetrieveResponses = {
41943
41806
  /**
41944
41807
  * Thinking level used when neither the session nor the agent selects one; null when the model states no default.
41945
41808
  */
41946
- default_effort: 'low' | 'medium' | 'high' | 'xhigh' | 'max' | null;
41809
+ default_effort: 'low' | 'medium' | 'high' | 'xhigh' | null;
41947
41810
  } | null;
41948
41811
  };
41949
41812
  /**
@@ -41951,9 +41814,9 @@ export type SessionsRetrieveResponses = {
41951
41814
  */
41952
41815
  thinking?: {
41953
41816
  /**
41954
- * Thinking level saved for this session: low, medium, high, xhigh, max, or none to turn thinking off. Null or absent means the session inherits the agent default and then the model default.
41817
+ * Thinking level saved for this session: low, medium, high, xhigh, or none to turn thinking off. Null or absent means the session inherits the agent default and then the model default.
41955
41818
  */
41956
- effort: 'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'none';
41819
+ effort: 'low' | 'medium' | 'high' | 'xhigh' | 'none';
41957
41820
  } | null;
41958
41821
  /**
41959
41822
  * Praxis extension: source of a forked session; null for other sessions. Available only on /agent/v1.
@@ -42010,7 +41873,7 @@ export type SessionsUpdateData = {
42010
41873
  /**
42011
41874
  * Thinking level for this session. The model must support the chosen effort; none requires can_disable. Null on thinking restores inheritance from the agent and model.
42012
41875
  */
42013
- effort: 'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'none';
41876
+ effort: 'low' | 'medium' | 'high' | 'xhigh' | 'none';
42014
41877
  } | null;
42015
41878
  };
42016
41879
  path: {
@@ -42045,7 +41908,7 @@ export type SessionsUpdateResponses = {
42045
41908
  */
42046
41909
  description: null | string;
42047
41910
  /**
42048
- * Praxis extension: HTTP, SSE or trusted stdio MCP servers paired with mcp_toolset entries and saved with the agent version.
41911
+ * URL MCP servers the agent can call, paired one-to-one with mcp_toolset entries in tools and saved with the agent version. No credentials are stored here.
42049
41912
  */
42050
41913
  mcp_servers: Array<AgentManaged36>;
42051
41914
  /**
@@ -42082,7 +41945,7 @@ export type SessionsUpdateResponses = {
42082
41945
  /**
42083
41946
  * Default thinking effort for sessions without an explicit selection. Unsupported defaults fall back to the selected model default.
42084
41947
  */
42085
- reasoning?: 'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'none';
41948
+ reasoning?: 'low' | 'medium' | 'high' | 'xhigh' | 'none';
42086
41949
  };
42087
41950
  };
42088
41951
  /**
@@ -42205,7 +42068,7 @@ export type SessionsUpdateResponses = {
42205
42068
  /**
42206
42069
  * Thinking levels the model accepts as effort, in ascending order.
42207
42070
  */
42208
- efforts: Array<'low' | 'medium' | 'high' | 'xhigh' | 'max'>;
42071
+ efforts: Array<'low' | 'medium' | 'high' | 'xhigh'>;
42209
42072
  /**
42210
42073
  * Whether effort none (thinking off) is allowed for this model.
42211
42074
  */
@@ -42213,7 +42076,7 @@ export type SessionsUpdateResponses = {
42213
42076
  /**
42214
42077
  * Thinking level used when neither the session nor the agent selects one; null when the model states no default.
42215
42078
  */
42216
- default_effort: 'low' | 'medium' | 'high' | 'xhigh' | 'max' | null;
42079
+ default_effort: 'low' | 'medium' | 'high' | 'xhigh' | null;
42217
42080
  } | null;
42218
42081
  };
42219
42082
  /**
@@ -42221,9 +42084,9 @@ export type SessionsUpdateResponses = {
42221
42084
  */
42222
42085
  thinking?: {
42223
42086
  /**
42224
- * Thinking level saved for this session: low, medium, high, xhigh, max, or none to turn thinking off. Null or absent means the session inherits the agent default and then the model default.
42087
+ * Thinking level saved for this session: low, medium, high, xhigh, or none to turn thinking off. Null or absent means the session inherits the agent default and then the model default.
42225
42088
  */
42226
- effort: 'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'none';
42089
+ effort: 'low' | 'medium' | 'high' | 'xhigh' | 'none';
42227
42090
  } | null;
42228
42091
  /**
42229
42092
  * Praxis extension: source of a forked session; null for other sessions. Available only on /agent/v1.
@@ -42275,7 +42138,7 @@ export type SessionsArchiveResponses = {
42275
42138
  */
42276
42139
  description: null | string;
42277
42140
  /**
42278
- * Praxis extension: HTTP, SSE or trusted stdio MCP servers paired with mcp_toolset entries and saved with the agent version.
42141
+ * URL MCP servers the agent can call, paired one-to-one with mcp_toolset entries in tools and saved with the agent version. No credentials are stored here.
42279
42142
  */
42280
42143
  mcp_servers: Array<AgentManaged36>;
42281
42144
  /**
@@ -42312,7 +42175,7 @@ export type SessionsArchiveResponses = {
42312
42175
  /**
42313
42176
  * Default thinking effort for sessions without an explicit selection. Unsupported defaults fall back to the selected model default.
42314
42177
  */
42315
- reasoning?: 'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'none';
42178
+ reasoning?: 'low' | 'medium' | 'high' | 'xhigh' | 'none';
42316
42179
  };
42317
42180
  };
42318
42181
  /**
@@ -42435,7 +42298,7 @@ export type SessionsArchiveResponses = {
42435
42298
  /**
42436
42299
  * Thinking levels the model accepts as effort, in ascending order.
42437
42300
  */
42438
- efforts: Array<'low' | 'medium' | 'high' | 'xhigh' | 'max'>;
42301
+ efforts: Array<'low' | 'medium' | 'high' | 'xhigh'>;
42439
42302
  /**
42440
42303
  * Whether effort none (thinking off) is allowed for this model.
42441
42304
  */
@@ -42443,7 +42306,7 @@ export type SessionsArchiveResponses = {
42443
42306
  /**
42444
42307
  * Thinking level used when neither the session nor the agent selects one; null when the model states no default.
42445
42308
  */
42446
- default_effort: 'low' | 'medium' | 'high' | 'xhigh' | 'max' | null;
42309
+ default_effort: 'low' | 'medium' | 'high' | 'xhigh' | null;
42447
42310
  } | null;
42448
42311
  };
42449
42312
  /**
@@ -42451,9 +42314,9 @@ export type SessionsArchiveResponses = {
42451
42314
  */
42452
42315
  thinking?: {
42453
42316
  /**
42454
- * Thinking level saved for this session: low, medium, high, xhigh, max, or none to turn thinking off. Null or absent means the session inherits the agent default and then the model default.
42317
+ * Thinking level saved for this session: low, medium, high, xhigh, or none to turn thinking off. Null or absent means the session inherits the agent default and then the model default.
42455
42318
  */
42456
- effort: 'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'none';
42319
+ effort: 'low' | 'medium' | 'high' | 'xhigh' | 'none';
42457
42320
  } | null;
42458
42321
  /**
42459
42322
  * Praxis extension: source of a forked session; null for other sessions. Available only on /agent/v1.
@@ -42719,16 +42582,6 @@ export type SessionsEventsListResponses = {
42719
42582
  * Praxis extension (MCP Apps, SEP-1865): present when `source` is `codemode`; the id of the codemode tool use whose program made this call. Absent otherwise.
42720
42583
  */
42721
42584
  parent_tool_use_id?: string;
42722
- /**
42723
- * Human-readable tool name from MCP 2025-06-18 Tool.title, falling back to annotations.title. Trimmed and truncated to 200 characters; omitted when blank or absent. Present only for model-initiated calls on /agent/v1; use name when absent.
42724
- */
42725
- title?: string;
42726
- /**
42727
- * Display labels keyed by top-level input property name, from MCP inputSchema.properties titles. Only nonempty string titles are included, trimmed and truncated to 100 characters each; omitted when none. Present only for model-initiated calls on /agent/v1; use the input key when a label is absent.
42728
- */
42729
- input_titles?: {
42730
- [key: string]: string;
42731
- };
42732
42585
  } | {
42733
42586
  /**
42734
42587
  * Unique identifier for this event.
@@ -43646,16 +43499,6 @@ export type SessionsThreadsEventsListResponses = {
43646
43499
  * Praxis extension (MCP Apps, SEP-1865): `app` when the call was made by an MCP Apps view, `codemode` when a program run by the codemode tool called an MCP tool that declares a view (the event pair exists so a client can render that view; the model already has the result in the codemode tool result); absent for the model's own calls.
43647
43500
  */
43648
43501
  source?: 'app' | 'codemode';
43649
- /**
43650
- * Human-readable tool name from MCP 2025-06-18 Tool.title, falling back to annotations.title. Trimmed and truncated to 200 characters; omitted when blank or absent. Present only for model-initiated calls on /agent/v1; use name when absent.
43651
- */
43652
- title?: string;
43653
- /**
43654
- * Display labels keyed by top-level input property name, from MCP inputSchema.properties titles. Only nonempty string titles are included, trimmed and truncated to 100 characters each; omitted when none. Present only for model-initiated calls on /agent/v1; use the input key when a label is absent.
43655
- */
43656
- input_titles?: {
43657
- [key: string]: string;
43658
- };
43659
43502
  } | {
43660
43503
  /**
43661
43504
  * Unique identifier for this event.
@@ -74,7 +74,7 @@ export declare const operations: readonly [{
74
74
  readonly type: "array";
75
75
  readonly itemType: "object";
76
76
  readonly required: false;
77
- readonly description: "Praxis extension: HTTP, SSE or trusted stdio MCP servers paired with mcp_toolset entries and saved with the agent version.";
77
+ readonly description: "MCP servers this agent connects to. Maximum 20. Names must be unique\nwithin the array. Every server must be referenced by an `mcp_toolset` in\n`tools`; unreferenced servers are rejected. See the\n[MCP connector guide](https://platform.claude.com/docs/en/managed-agents/mcp-connector).";
78
78
  }, {
79
79
  readonly name: "metadata";
80
80
  readonly type: "object";
@@ -187,7 +187,7 @@ export declare const operations: readonly [{
187
187
  readonly type: "array";
188
188
  readonly itemType: "object";
189
189
  readonly required: false;
190
- readonly description: "Praxis extension: HTTP, SSE or trusted stdio MCP servers paired with mcp_toolset entries and saved with the agent version.";
190
+ readonly description: "MCP servers. Full replacement. Omit to preserve; send empty array or\n`null` to clear. Names must be unique. Maximum 20. Every server must be\nreferenced by an `mcp_toolset` in the agent's resulting `tools`; unreferenced\nservers are rejected. See the\n[MCP connector guide](https://platform.claude.com/docs/en/managed-agents/mcp-connector).";
191
191
  }, {
192
192
  readonly name: "metadata";
193
193
  readonly type: "object";
@@ -1164,7 +1164,7 @@ export declare const operations: readonly [{
1164
1164
  readonly resource: "agent.sessions";
1165
1165
  readonly method: "create";
1166
1166
  readonly summary: "Create session";
1167
- readonly description: "Create a session: one conversation with an agent, running on a machine. Pass agent as an agent id (latest 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 environment_id for a sandbox recipe. 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.";
1167
+ readonly description: "Create a session: one conversation with an agent, running on a machine. Pass agent as an agent id (latest 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 environment_id for a sandbox recipe. Optional model must be one of the agent's allowed models; optional thinking is {effort: low|medium|high|xhigh|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.";
1168
1168
  readonly http: "POST";
1169
1169
  readonly path: "/agent/v1/sessions";
1170
1170
  readonly streaming: "no";
@@ -94,7 +94,7 @@ export const operations = [
94
94
  "type": "array",
95
95
  "itemType": "object",
96
96
  "required": false,
97
- "description": "Praxis extension: HTTP, SSE or trusted stdio MCP servers paired with mcp_toolset entries and saved with the agent version."
97
+ "description": "MCP servers this agent connects to. Maximum 20. Names must be unique\nwithin the array. Every server must be referenced by an `mcp_toolset` in\n`tools`; unreferenced servers are rejected. See the\n[MCP connector guide](https://platform.claude.com/docs/en/managed-agents/mcp-connector)."
98
98
  },
99
99
  {
100
100
  "name": "metadata",
@@ -233,7 +233,7 @@ export const operations = [
233
233
  "type": "array",
234
234
  "itemType": "object",
235
235
  "required": false,
236
- "description": "Praxis extension: HTTP, SSE or trusted stdio MCP servers paired with mcp_toolset entries and saved with the agent version."
236
+ "description": "MCP servers. Full replacement. Omit to preserve; send empty array or\n`null` to clear. Names must be unique. Maximum 20. Every server must be\nreferenced by an `mcp_toolset` in the agent's resulting `tools`; unreferenced\nservers are rejected. See the\n[MCP connector guide](https://platform.claude.com/docs/en/managed-agents/mcp-connector)."
237
237
  },
238
238
  {
239
239
  "name": "metadata",
@@ -1439,7 +1439,7 @@ export const operations = [
1439
1439
  "resource": "agent.sessions",
1440
1440
  "method": "create",
1441
1441
  "summary": "Create session",
1442
- "description": "Create a session: one conversation with an agent, running on a machine. Pass agent as an agent id (latest 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 environment_id for a sandbox recipe. 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.",
1442
+ "description": "Create a session: one conversation with an agent, running on a machine. Pass agent as an agent id (latest 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 environment_id for a sandbox recipe. Optional model must be one of the agent's allowed models; optional thinking is {effort: low|medium|high|xhigh|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.",
1443
1443
  "http": "POST",
1444
1444
  "path": "/agent/v1/sessions",
1445
1445
  "streaming": "no",
@@ -16,7 +16,7 @@ export declare function createAgent(transport: Transport): {
16
16
  inference_geo?: string;
17
17
  speed?: "standard" | "fast";
18
18
  settings?: {
19
- reasoning?: "low" | "medium" | "high" | "xhigh" | "max" | "none";
19
+ reasoning?: "low" | "medium" | "high" | "xhigh" | "none";
20
20
  };
21
21
  };
22
22
  multiagent: null | Types.AgentManaged39;
@@ -146,7 +146,7 @@ export declare function createAgent(transport: Transport): {
146
146
  inference_geo?: string;
147
147
  speed?: "standard" | "fast";
148
148
  settings?: {
149
- reasoning?: "low" | "medium" | "high" | "xhigh" | "max" | "none";
149
+ reasoning?: "low" | "medium" | "high" | "xhigh" | "none";
150
150
  };
151
151
  };
152
152
  multiagent: null | Types.AgentManaged39;
@@ -277,7 +277,7 @@ export declare function createAgent(transport: Transport): {
277
277
  inference_geo?: string;
278
278
  speed?: "standard" | "fast";
279
279
  settings?: {
280
- reasoning?: "low" | "medium" | "high" | "xhigh" | "max" | "none";
280
+ reasoning?: "low" | "medium" | "high" | "xhigh" | "none";
281
281
  };
282
282
  };
283
283
  multiagent: null | Types.AgentManaged39;
@@ -409,7 +409,7 @@ export declare function createAgent(transport: Transport): {
409
409
  inference_geo?: string;
410
410
  speed?: "standard" | "fast";
411
411
  settings?: {
412
- reasoning?: "low" | "medium" | "high" | "xhigh" | "max" | "none";
412
+ reasoning?: "low" | "medium" | "high" | "xhigh" | "none";
413
413
  };
414
414
  };
415
415
  multiagent: null | Types.AgentManaged39;
@@ -539,7 +539,7 @@ export declare function createAgent(transport: Transport): {
539
539
  inference_geo?: string;
540
540
  speed?: "standard" | "fast";
541
541
  settings?: {
542
- reasoning?: "low" | "medium" | "high" | "xhigh" | "max" | "none";
542
+ reasoning?: "low" | "medium" | "high" | "xhigh" | "none";
543
543
  };
544
544
  };
545
545
  multiagent: null | Types.AgentManaged39;
@@ -671,7 +671,7 @@ export declare function createAgent(transport: Transport): {
671
671
  inference_geo?: string;
672
672
  speed?: "standard" | "fast";
673
673
  settings?: {
674
- reasoning?: "low" | "medium" | "high" | "xhigh" | "max" | "none";
674
+ reasoning?: "low" | "medium" | "high" | "xhigh" | "none";
675
675
  };
676
676
  };
677
677
  multiagent: null | Types.AgentManaged39;
@@ -1234,7 +1234,7 @@ export declare function createAgent(transport: Transport): {
1234
1234
  inference_geo?: string;
1235
1235
  speed?: "standard" | "fast";
1236
1236
  settings?: {
1237
- reasoning?: "low" | "medium" | "high" | "xhigh" | "max" | "none";
1237
+ reasoning?: "low" | "medium" | "high" | "xhigh" | "none";
1238
1238
  };
1239
1239
  };
1240
1240
  multiagent: null | Types.AgentManaged171;
@@ -1265,13 +1265,13 @@ export declare function createAgent(transport: Transport): {
1265
1265
  model?: {
1266
1266
  id: string;
1267
1267
  thinking: {
1268
- efforts: Array<"low" | "medium" | "high" | "xhigh" | "max">;
1268
+ efforts: Array<"low" | "medium" | "high" | "xhigh">;
1269
1269
  can_disable: boolean;
1270
- default_effort: "low" | "medium" | "high" | "xhigh" | "max" | null;
1270
+ default_effort: "low" | "medium" | "high" | "xhigh" | null;
1271
1271
  } | null;
1272
1272
  };
1273
1273
  thinking?: {
1274
- effort: "low" | "medium" | "high" | "xhigh" | "max" | "none";
1274
+ effort: "low" | "medium" | "high" | "xhigh" | "none";
1275
1275
  } | null;
1276
1276
  forked_from?: {
1277
1277
  session_id: string;
@@ -1353,7 +1353,7 @@ export declare function createAgent(transport: Transport): {
1353
1353
  inference_geo?: string;
1354
1354
  speed?: "standard" | "fast";
1355
1355
  settings?: {
1356
- reasoning?: "low" | "medium" | "high" | "xhigh" | "max" | "none";
1356
+ reasoning?: "low" | "medium" | "high" | "xhigh" | "none";
1357
1357
  };
1358
1358
  };
1359
1359
  multiagent: null | Types.AgentManaged171;
@@ -1384,13 +1384,13 @@ export declare function createAgent(transport: Transport): {
1384
1384
  model?: {
1385
1385
  id: string;
1386
1386
  thinking: {
1387
- efforts: Array<"low" | "medium" | "high" | "xhigh" | "max">;
1387
+ efforts: Array<"low" | "medium" | "high" | "xhigh">;
1388
1388
  can_disable: boolean;
1389
- default_effort: "low" | "medium" | "high" | "xhigh" | "max" | null;
1389
+ default_effort: "low" | "medium" | "high" | "xhigh" | null;
1390
1390
  } | null;
1391
1391
  };
1392
1392
  thinking?: {
1393
- effort: "low" | "medium" | "high" | "xhigh" | "max" | "none";
1393
+ effort: "low" | "medium" | "high" | "xhigh" | "none";
1394
1394
  } | null;
1395
1395
  forked_from?: {
1396
1396
  session_id: string;
@@ -1453,10 +1453,6 @@ export declare function createAgent(transport: Transport): {
1453
1453
  };
1454
1454
  source?: "app" | "codemode";
1455
1455
  parent_tool_use_id?: string;
1456
- title?: string;
1457
- input_titles?: {
1458
- [key: string]: string;
1459
- };
1460
1456
  } | {
1461
1457
  id: string;
1462
1458
  mcp_tool_use_id: string;
@@ -1634,7 +1630,7 @@ export declare function createAgent(transport: Transport): {
1634
1630
  inference_geo?: string;
1635
1631
  speed?: "standard" | "fast";
1636
1632
  settings?: {
1637
- reasoning?: "low" | "medium" | "high" | "xhigh" | "max" | "none";
1633
+ reasoning?: "low" | "medium" | "high" | "xhigh" | "none";
1638
1634
  };
1639
1635
  };
1640
1636
  multiagent: null | {
@@ -2076,13 +2072,13 @@ export declare function createAgent(transport: Transport): {
2076
2072
  model?: {
2077
2073
  id: string;
2078
2074
  thinking: {
2079
- efforts: Array<"low" | "medium" | "high" | "xhigh" | "max">;
2075
+ efforts: Array<"low" | "medium" | "high" | "xhigh">;
2080
2076
  can_disable: boolean;
2081
- default_effort: "low" | "medium" | "high" | "xhigh" | "max" | null;
2077
+ default_effort: "low" | "medium" | "high" | "xhigh" | null;
2082
2078
  } | null;
2083
2079
  };
2084
2080
  thinking?: {
2085
- effort: "low" | "medium" | "high" | "xhigh" | "max" | "none";
2081
+ effort: "low" | "medium" | "high" | "xhigh" | "none";
2086
2082
  } | null;
2087
2083
  forked_from?: {
2088
2084
  session_id: string;
@@ -2102,7 +2098,7 @@ export declare function createAgent(transport: Transport): {
2102
2098
  inference_geo?: string;
2103
2099
  speed?: "standard" | "fast";
2104
2100
  settings?: {
2105
- reasoning?: "low" | "medium" | "high" | "xhigh" | "max" | "none";
2101
+ reasoning?: "low" | "medium" | "high" | "xhigh" | "none";
2106
2102
  };
2107
2103
  };
2108
2104
  multiagent: null | Types.AgentManaged171;
@@ -2133,13 +2129,13 @@ export declare function createAgent(transport: Transport): {
2133
2129
  model?: {
2134
2130
  id: string;
2135
2131
  thinking: {
2136
- efforts: Array<"low" | "medium" | "high" | "xhigh" | "max">;
2132
+ efforts: Array<"low" | "medium" | "high" | "xhigh">;
2137
2133
  can_disable: boolean;
2138
- default_effort: "low" | "medium" | "high" | "xhigh" | "max" | null;
2134
+ default_effort: "low" | "medium" | "high" | "xhigh" | null;
2139
2135
  } | null;
2140
2136
  };
2141
2137
  thinking?: {
2142
- effort: "low" | "medium" | "high" | "xhigh" | "max" | "none";
2138
+ effort: "low" | "medium" | "high" | "xhigh" | "none";
2143
2139
  } | null;
2144
2140
  forked_from?: {
2145
2141
  session_id: string;
@@ -2177,7 +2173,7 @@ export declare function createAgent(transport: Transport): {
2177
2173
  inference_geo?: string;
2178
2174
  speed?: "standard" | "fast";
2179
2175
  settings?: {
2180
- reasoning?: "low" | "medium" | "high" | "xhigh" | "max" | "none";
2176
+ reasoning?: "low" | "medium" | "high" | "xhigh" | "none";
2181
2177
  };
2182
2178
  };
2183
2179
  multiagent: null | Types.AgentManaged171;
@@ -2208,13 +2204,13 @@ export declare function createAgent(transport: Transport): {
2208
2204
  model?: {
2209
2205
  id: string;
2210
2206
  thinking: {
2211
- efforts: Array<"low" | "medium" | "high" | "xhigh" | "max">;
2207
+ efforts: Array<"low" | "medium" | "high" | "xhigh">;
2212
2208
  can_disable: boolean;
2213
- default_effort: "low" | "medium" | "high" | "xhigh" | "max" | null;
2209
+ default_effort: "low" | "medium" | "high" | "xhigh" | null;
2214
2210
  } | null;
2215
2211
  };
2216
2212
  thinking?: {
2217
- effort: "low" | "medium" | "high" | "xhigh" | "max" | "none";
2213
+ effort: "low" | "medium" | "high" | "xhigh" | "none";
2218
2214
  } | null;
2219
2215
  forked_from?: {
2220
2216
  session_id: string;
@@ -2234,9 +2230,9 @@ export declare function createAgent(transport: Transport): {
2234
2230
  id: string;
2235
2231
  display_name: string;
2236
2232
  thinking: {
2237
- efforts: Array<"low" | "medium" | "high" | "xhigh" | "max">;
2233
+ efforts: Array<"low" | "medium" | "high" | "xhigh">;
2238
2234
  can_disable: boolean;
2239
- default_effort: "low" | "medium" | "high" | "xhigh" | "max" | null;
2235
+ default_effort: "low" | "medium" | "high" | "xhigh" | null;
2240
2236
  } | null;
2241
2237
  };
2242
2238
  total_tokens: number | null;
@@ -2364,10 +2360,6 @@ export declare function createAgent(transport: Transport): {
2364
2360
  };
2365
2361
  };
2366
2362
  source?: "app" | "codemode";
2367
- title?: string;
2368
- input_titles?: {
2369
- [key: string]: string;
2370
- };
2371
2363
  } | {
2372
2364
  id: string;
2373
2365
  mcp_tool_use_id: string;
@@ -2507,7 +2499,7 @@ export declare function createAgent(transport: Transport): {
2507
2499
  inference_geo?: string;
2508
2500
  speed?: "standard" | "fast";
2509
2501
  settings?: {
2510
- reasoning?: "low" | "medium" | "high" | "xhigh" | "max" | "none";
2502
+ reasoning?: "low" | "medium" | "high" | "xhigh" | "none";
2511
2503
  };
2512
2504
  };
2513
2505
  multiagent: null | Types.AgentManaged171;
@@ -2538,13 +2530,13 @@ export declare function createAgent(transport: Transport): {
2538
2530
  model?: {
2539
2531
  id: string;
2540
2532
  thinking: {
2541
- efforts: Array<"low" | "medium" | "high" | "xhigh" | "max">;
2533
+ efforts: Array<"low" | "medium" | "high" | "xhigh">;
2542
2534
  can_disable: boolean;
2543
- default_effort: "low" | "medium" | "high" | "xhigh" | "max" | null;
2535
+ default_effort: "low" | "medium" | "high" | "xhigh" | null;
2544
2536
  } | null;
2545
2537
  };
2546
2538
  thinking?: {
2547
- effort: "low" | "medium" | "high" | "xhigh" | "max" | "none";
2539
+ effort: "low" | "medium" | "high" | "xhigh" | "none";
2548
2540
  } | null;
2549
2541
  forked_from?: {
2550
2542
  session_id: string;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@deepraxis/sdk",
3
- "version": "0.1.0-dev.722c0d4",
3
+ "version": "0.1.0-dev.7ee6a7d",
4
4
  "type": "module",
5
5
  "sideEffects": false,
6
6
  "exports": {