@breign/client 1.0.148 → 1.0.149
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.
- package/dist/models/AgentSandboxConfigurationUio.d.ts +8 -2
- package/dist/models/AgentSandboxConfigurationUio.js +2 -0
- package/dist/models/ConversationMessageApprovalUio.d.ts +1 -1
- package/dist/models/ToolApprovalUio.d.ts +1 -1
- package/dist/models/ToolCallResultRequestUio.d.ts +2 -2
- package/dist/models/ToolCallUio.d.ts +1 -1
- package/dist/openapi.json +11 -7
- package/package.json +1 -1
|
@@ -11,7 +11,7 @@
|
|
|
11
11
|
*/
|
|
12
12
|
import type { AgentSandboxNetworkConfigurationUio } from './AgentSandboxNetworkConfigurationUio';
|
|
13
13
|
/**
|
|
14
|
-
* Per-agent activation of the bash sandbox and of its
|
|
14
|
+
* Per-agent activation of the bash sandbox and of its three risky capabilities. Separate switches because the risk surfaces are unrelated. The server configuration can only narrow this: an agent may enable, never widen.
|
|
15
15
|
* @export
|
|
16
16
|
* @interface AgentSandboxConfigurationUio
|
|
17
17
|
*/
|
|
@@ -23,11 +23,17 @@ export interface AgentSandboxConfigurationUio {
|
|
|
23
23
|
*/
|
|
24
24
|
enabled?: boolean;
|
|
25
25
|
/**
|
|
26
|
-
* Enables python3 inside the sandbox. Also requires the server-side lock; the cost is arbitrary code execution.
|
|
26
|
+
* Enables python3 inside the sandbox. Also requires the server-side lock; the cost is arbitrary code execution, so every python command is approved by the user before it runs.
|
|
27
27
|
* @type {boolean}
|
|
28
28
|
* @memberof AgentSandboxConfigurationUio
|
|
29
29
|
*/
|
|
30
30
|
pythonEnabled?: boolean;
|
|
31
|
+
/**
|
|
32
|
+
* Enables js-exec (JavaScript and TypeScript, in QuickJS) inside the sandbox. Same two extra locks as pythonEnabled, and the same per-command approval: running code IS the effect, so there is nothing to refuse afterwards.
|
|
33
|
+
* @type {boolean}
|
|
34
|
+
* @memberof AgentSandboxConfigurationUio
|
|
35
|
+
*/
|
|
36
|
+
javascriptEnabled?: boolean;
|
|
31
37
|
/**
|
|
32
38
|
*
|
|
33
39
|
* @type {AgentSandboxNetworkConfigurationUio}
|
|
@@ -42,6 +42,7 @@ function AgentSandboxConfigurationUioFromJSONTyped(json, ignoreDiscriminator) {
|
|
|
42
42
|
return {
|
|
43
43
|
'enabled': json['enabled'] == null ? undefined : json['enabled'],
|
|
44
44
|
'pythonEnabled': json['pythonEnabled'] == null ? undefined : json['pythonEnabled'],
|
|
45
|
+
'javascriptEnabled': json['javascriptEnabled'] == null ? undefined : json['javascriptEnabled'],
|
|
45
46
|
'network': json['network'] == null ? undefined : (0, AgentSandboxNetworkConfigurationUio_1.AgentSandboxNetworkConfigurationUioFromJSON)(json['network']),
|
|
46
47
|
'workspaceScope': json['workspaceScope'] == null ? undefined : json['workspaceScope'],
|
|
47
48
|
};
|
|
@@ -56,6 +57,7 @@ function AgentSandboxConfigurationUioToJSONTyped(value, ignoreDiscriminator = fa
|
|
|
56
57
|
return {
|
|
57
58
|
'enabled': value['enabled'],
|
|
58
59
|
'pythonEnabled': value['pythonEnabled'],
|
|
60
|
+
'javascriptEnabled': value['javascriptEnabled'],
|
|
59
61
|
'network': (0, AgentSandboxNetworkConfigurationUio_1.AgentSandboxNetworkConfigurationUioToJSON)(value['network']),
|
|
60
62
|
'workspaceScope': value['workspaceScope'],
|
|
61
63
|
};
|
|
@@ -16,7 +16,7 @@
|
|
|
16
16
|
*/
|
|
17
17
|
export interface ConversationMessageApprovalUio {
|
|
18
18
|
/**
|
|
19
|
-
* The tool whose use was submitted for approval. It also says which family the decision belongs to: bash_network_approval an address,
|
|
19
|
+
* The tool whose use was submitted for approval. It also says which family the decision belongs to: bash_network_approval an address, bash_command_approval a command (and bash_python_approval, its former name, on decisions taken before the rename).
|
|
20
20
|
* @type {string}
|
|
21
21
|
* @memberof ConversationMessageApprovalUio
|
|
22
22
|
*/
|
|
@@ -10,7 +10,7 @@
|
|
|
10
10
|
* Do not edit the class manually.
|
|
11
11
|
*/
|
|
12
12
|
/**
|
|
13
|
-
* One operation the user has authorised an agent to perform. Two families share this shape: an address the agent sandbox may reach, and a
|
|
13
|
+
* One operation the user has authorised an agent to perform. Two families share this shape: an address the agent sandbox may reach, and a command it may run through one of its interpreters — python3 or js-exec. An address is stored normalised — query string, fragment and credentials removed — so a token carried by the URL the user saw is not kept here; a command is stored as it was approved, since the command itself is what was judged.
|
|
14
14
|
* @export
|
|
15
15
|
* @interface ToolApprovalUio
|
|
16
16
|
*/
|
|
@@ -41,13 +41,13 @@ export interface ToolCallResultRequestUio {
|
|
|
41
41
|
*/
|
|
42
42
|
error?: string;
|
|
43
43
|
/**
|
|
44
|
-
* Only read when resolving a bash_network_approval or
|
|
44
|
+
* Only read when resolving a bash_network_approval or bash_command_approval call with status completed: how far the approval reaches. once — the suspended reply and nothing after it, so the same request is asked about again next time — is the default, and nothing is stored. agentUser covers this agent, for this user, across all of their conversations, and is kept until revoked. Any other value is refused with a 400. Never widens what the agent is allowed to do: the server-side lock and the per-agent switch remain prerequisites. Only the user the question was asked of may answer it: an approval is a personal consent, so another caller — an admin included — gets a 403.
|
|
45
45
|
* @type {string}
|
|
46
46
|
* @memberof ToolCallResultRequestUio
|
|
47
47
|
*/
|
|
48
48
|
approvalScope?: ToolCallResultRequestUioApprovalScopeEnum;
|
|
49
49
|
/**
|
|
50
|
-
* Only read when resolving a bash_network_approval call with status completed: how wide the approval is. prefix (the default) grants the prefix shown in the request — origin plus first path segment; origin grants the whole domain. Nothing narrower is offered: nobody can predict the paths an API will serve, and an approval that is too fine is paid for in repeated questions. The server recomputes both from the URL it recorded, so a client cannot submit a prefix of its own. Ignored on a
|
|
50
|
+
* Only read when resolving a bash_network_approval call with status completed: how wide the approval is. prefix (the default) grants the prefix shown in the request — origin plus first path segment; origin grants the whole domain. Nothing narrower is offered: nobody can predict the paths an API will serve, and an approval that is too fine is paid for in repeated questions. The server recomputes both from the URL it recorded, so a client cannot submit a prefix of its own. Ignored on a bash_command_approval call, which has a single width: the exact command the server already recorded.
|
|
51
51
|
* @type {string}
|
|
52
52
|
* @memberof ToolCallResultRequestUio
|
|
53
53
|
*/
|
|
@@ -22,7 +22,7 @@ export interface ToolCallUio {
|
|
|
22
22
|
*/
|
|
23
23
|
callId: string;
|
|
24
24
|
/**
|
|
25
|
-
* Name of the tool the model called. Three values are produced by the server today. take_screenshot asks the client to capture the screen. bash_network_approval is an agent sandbox asking permission to reach an address: arguments carries url (the full address, to be shown as-is), urlPrefix (what a yes actually grants), origin, host and method.
|
|
25
|
+
* Name of the tool the model called. Three values are produced by the server today. take_screenshot asks the client to capture the screen. bash_network_approval is an agent sandbox asking permission to reach an address: arguments carries url (the full address, to be shown as-is), urlPrefix (what a yes actually grants), origin, host and method. bash_command_approval is an agent sandbox asking permission to run a command through one of its interpreters — python3 or js-exec: arguments carries command, which is both what has to be shown in full and exactly what a yes grants — nothing ran, so a refusal leaves the sandbox untouched. Calls named bash_python_approval, the name this last one carried while python was the only interpreter, may still be waiting in older conversations and resolve exactly the same way.
|
|
26
26
|
* @type {string}
|
|
27
27
|
* @memberof ToolCallUio
|
|
28
28
|
*/
|
package/dist/openapi.json
CHANGED
|
@@ -16033,14 +16033,18 @@
|
|
|
16033
16033
|
"type" : "object"
|
|
16034
16034
|
},
|
|
16035
16035
|
"AgentSandboxConfiguration" : {
|
|
16036
|
-
"description" : "Per-agent activation of the bash sandbox and of its
|
|
16036
|
+
"description" : "Per-agent activation of the bash sandbox and of its three risky capabilities. Separate switches because the risk surfaces are unrelated. The server configuration can only narrow this: an agent may enable, never widen.",
|
|
16037
16037
|
"properties" : {
|
|
16038
16038
|
"enabled" : {
|
|
16039
16039
|
"description" : "Enables the Bash_exec tool for this agent.",
|
|
16040
16040
|
"type" : "boolean"
|
|
16041
16041
|
},
|
|
16042
16042
|
"pythonEnabled" : {
|
|
16043
|
-
"description" : "Enables python3 inside the sandbox. Also requires the server-side lock; the cost is arbitrary code execution.",
|
|
16043
|
+
"description" : "Enables python3 inside the sandbox. Also requires the server-side lock; the cost is arbitrary code execution, so every python command is approved by the user before it runs.",
|
|
16044
|
+
"type" : "boolean"
|
|
16045
|
+
},
|
|
16046
|
+
"javascriptEnabled" : {
|
|
16047
|
+
"description" : "Enables js-exec (JavaScript and TypeScript, in QuickJS) inside the sandbox. Same two extra locks as pythonEnabled, and the same per-command approval: running code IS the effect, so there is nothing to refuse afterwards.",
|
|
16044
16048
|
"type" : "boolean"
|
|
16045
16049
|
},
|
|
16046
16050
|
"network" : {
|
|
@@ -17422,7 +17426,7 @@
|
|
|
17422
17426
|
"description" : "One authorisation decision taken during this message: which tool, over what, by whom, when. Carried by the message so the history reads as it stands, with no extra request. For a decision granted once it is the only lasting trace there is — a one-off creates no standing approval. Deliberately beside toolResults rather than inside it: toolResults is replayed to the model every turn, and a one-off appearing there would later suggest a right that has expired.",
|
|
17423
17427
|
"properties" : {
|
|
17424
17428
|
"tool" : {
|
|
17425
|
-
"description" : "The tool whose use was submitted for approval. It also says which family the decision belongs to: bash_network_approval an address,
|
|
17429
|
+
"description" : "The tool whose use was submitted for approval. It also says which family the decision belongs to: bash_network_approval an address, bash_command_approval a command (and bash_python_approval, its former name, on decisions taken before the rename).",
|
|
17426
17430
|
"type" : "string"
|
|
17427
17431
|
},
|
|
17428
17432
|
"granted" : {
|
|
@@ -20246,7 +20250,7 @@
|
|
|
20246
20250
|
},
|
|
20247
20251
|
"ToolApproval" : {
|
|
20248
20252
|
"additionalProperties" : false,
|
|
20249
|
-
"description" : "One operation the user has authorised an agent to perform. Two families share this shape: an address the agent sandbox may reach, and a
|
|
20253
|
+
"description" : "One operation the user has authorised an agent to perform. Two families share this shape: an address the agent sandbox may reach, and a command it may run through one of its interpreters — python3 or js-exec. An address is stored normalised — query string, fragment and credentials removed — so a token carried by the URL the user saw is not kept here; a command is stored as it was approved, since the command itself is what was judged.",
|
|
20250
20254
|
"properties" : {
|
|
20251
20255
|
"id" : {
|
|
20252
20256
|
"description" : "Identifier to revoke the approval with.",
|
|
@@ -22085,7 +22089,7 @@
|
|
|
22085
22089
|
"type" : "string"
|
|
22086
22090
|
},
|
|
22087
22091
|
"tool" : {
|
|
22088
|
-
"description" : "Name of the tool the model called. Three values are produced by the server today. take_screenshot asks the client to capture the screen. bash_network_approval is an agent sandbox asking permission to reach an address: arguments carries url (the full address, to be shown as-is), urlPrefix (what a yes actually grants), origin, host and method.
|
|
22092
|
+
"description" : "Name of the tool the model called. Three values are produced by the server today. take_screenshot asks the client to capture the screen. bash_network_approval is an agent sandbox asking permission to reach an address: arguments carries url (the full address, to be shown as-is), urlPrefix (what a yes actually grants), origin, host and method. bash_command_approval is an agent sandbox asking permission to run a command through one of its interpreters — python3 or js-exec: arguments carries command, which is both what has to be shown in full and exactly what a yes grants — nothing ran, so a refusal leaves the sandbox untouched. Calls named bash_python_approval, the name this last one carried while python was the only interpreter, may still be waiting in older conversations and resolve exactly the same way.",
|
|
22089
22093
|
"type" : "string"
|
|
22090
22094
|
},
|
|
22091
22095
|
"status" : {
|
|
@@ -22148,12 +22152,12 @@
|
|
|
22148
22152
|
"type" : "string"
|
|
22149
22153
|
},
|
|
22150
22154
|
"approvalScope" : {
|
|
22151
|
-
"description" : "Only read when resolving a bash_network_approval or
|
|
22155
|
+
"description" : "Only read when resolving a bash_network_approval or bash_command_approval call with status completed: how far the approval reaches. once — the suspended reply and nothing after it, so the same request is asked about again next time — is the default, and nothing is stored. agentUser covers this agent, for this user, across all of their conversations, and is kept until revoked. Any other value is refused with a 400. Never widens what the agent is allowed to do: the server-side lock and the per-agent switch remain prerequisites. Only the user the question was asked of may answer it: an approval is a personal consent, so another caller — an admin included — gets a 403.",
|
|
22152
22156
|
"enum" : [ "once", "agentUser" ],
|
|
22153
22157
|
"type" : "string"
|
|
22154
22158
|
},
|
|
22155
22159
|
"approvalWidth" : {
|
|
22156
|
-
"description" : "Only read when resolving a bash_network_approval call with status completed: how wide the approval is. prefix (the default) grants the prefix shown in the request — origin plus first path segment; origin grants the whole domain. Nothing narrower is offered: nobody can predict the paths an API will serve, and an approval that is too fine is paid for in repeated questions. The server recomputes both from the URL it recorded, so a client cannot submit a prefix of its own. Ignored on a
|
|
22160
|
+
"description" : "Only read when resolving a bash_network_approval call with status completed: how wide the approval is. prefix (the default) grants the prefix shown in the request — origin plus first path segment; origin grants the whole domain. Nothing narrower is offered: nobody can predict the paths an API will serve, and an approval that is too fine is paid for in repeated questions. The server recomputes both from the URL it recorded, so a client cannot submit a prefix of its own. Ignored on a bash_command_approval call, which has a single width: the exact command the server already recorded.",
|
|
22157
22161
|
"enum" : [ "prefix", "origin" ],
|
|
22158
22162
|
"type" : "string"
|
|
22159
22163
|
}
|