@soat/cli 0.69.0 → 0.70.0
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/index.mjs +381 -15
- package/package.json +2 -2
package/dist/index.mjs
CHANGED
|
@@ -13,7 +13,7 @@ import * as os from "node:os";
|
|
|
13
13
|
import { createHmac, timingSafeEqual } from "node:crypto";
|
|
14
14
|
|
|
15
15
|
//#region package.json
|
|
16
|
-
var version = "0.
|
|
16
|
+
var version = "0.70.0";
|
|
17
17
|
|
|
18
18
|
//#endregion
|
|
19
19
|
//#region src/cli-wrappers/wrappers/formations.ts
|
|
@@ -995,7 +995,7 @@ var routes = {
|
|
|
995
995
|
"get-agent": {
|
|
996
996
|
serviceClass: "Agents",
|
|
997
997
|
operationId: "getAgent",
|
|
998
|
-
description: "Returns a single agent by ID.",
|
|
998
|
+
description: "Returns a single agent by ID. A credential scoped to a project the agent is shared with, through an accepted share, reads its `id` and `name` only.",
|
|
999
999
|
moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/agents",
|
|
1000
1000
|
httpMethod: "get",
|
|
1001
1001
|
pathParams: ["agent_id"],
|
|
@@ -1337,7 +1337,7 @@ var routes = {
|
|
|
1337
1337
|
"delete-agent": {
|
|
1338
1338
|
serviceClass: "Agents",
|
|
1339
1339
|
operationId: "deleteAgent",
|
|
1340
|
-
description: "Deletes an agent by ID. Fails with `409` if the agent has dependent generations or traces, unless `force=true` is passed, in which case those generations and traces are deleted along with the agent.",
|
|
1340
|
+
description: "Deletes an agent by ID. Fails with `409` if the agent has dependent generations or traces, or another project has accepted a share of it, unless `force=true` is passed, in which case those generations and traces are deleted along with the agent and the shares are revoked. Every share of the agent is revoked when it is deleted.",
|
|
1341
1341
|
moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/agents",
|
|
1342
1342
|
httpMethod: "delete",
|
|
1343
1343
|
pathParams: ["agent_id"],
|
|
@@ -1352,7 +1352,7 @@ var routes = {
|
|
|
1352
1352
|
"in": "path"
|
|
1353
1353
|
}, {
|
|
1354
1354
|
"name": "force",
|
|
1355
|
-
"description": "When `true`, deletes the agent's dependent generations and traces instead of returning `409 AGENT_HAS_DEPENDENTS`.\n",
|
|
1355
|
+
"description": "When `true`, deletes the agent's dependent generations and traces, revokes its accepted shares and leaves its ingestion rules naming it instead of returning `409 AGENT_HAS_DEPENDENTS`.\n",
|
|
1356
1356
|
"required": false,
|
|
1357
1357
|
"type": "boolean",
|
|
1358
1358
|
"in": "query"
|
|
@@ -1361,7 +1361,7 @@ var routes = {
|
|
|
1361
1361
|
"create-agent-generation": {
|
|
1362
1362
|
serviceClass: "Agents",
|
|
1363
1363
|
operationId: "createAgentGeneration",
|
|
1364
|
-
description: "Sends messages to the agent, resolves its tools, and runs the AI model loop. Background by default: returns `202 Accepted` with a `generation_id` to poll via `GET /api/v1/generations/{generation_id}`. Pass `?wait=true` to block and receive the result inline, where client tools pause the generation and return `requires_action`. Streaming (`stream: true`) implies waiting. Pass `idempotency_key` to make a retry safe: a request whose key is already claimed runs nothing and answers `202` with the generation the key names.",
|
|
1364
|
+
description: "Sends messages to the agent, resolves its tools, and runs the AI model loop. Background by default: returns `202 Accepted` with a `generation_id` to poll via `GET /api/v1/generations/{generation_id}`. Pass `?wait=true` to block and receive the result inline, where client tools pause the generation and return `requires_action`. Streaming (`stream: true`) implies waiting. Pass `idempotency_key` to make a retry safe: a request whose key is already claimed runs nothing and answers `202` with the generation the key names. A credential scoped to a project the agent is shared with, through an accepted share, runs it in that project: on the publisher's configuration, recorded, metered and governed in the grantee project.",
|
|
1365
1365
|
moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/agents",
|
|
1366
1366
|
httpMethod: "post",
|
|
1367
1367
|
pathParams: ["agent_id"],
|
|
@@ -8618,7 +8618,7 @@ var routes = {
|
|
|
8618
8618
|
cookieParams: [],
|
|
8619
8619
|
flags: [{
|
|
8620
8620
|
"name": "agent_id",
|
|
8621
|
-
"description": "Agent this session belongs to",
|
|
8621
|
+
"description": "Agent this session belongs to. With a credential scoped to a project, it may also be an agent another project shares with that project; the session is then that project's.\n",
|
|
8622
8622
|
"required": true,
|
|
8623
8623
|
"type": "string",
|
|
8624
8624
|
"in": "body"
|
|
@@ -9002,6 +9002,354 @@ var routes = {
|
|
|
9002
9002
|
"in": "body-root"
|
|
9003
9003
|
}]
|
|
9004
9004
|
},
|
|
9005
|
+
"list-shares": {
|
|
9006
|
+
serviceClass: "Shares",
|
|
9007
|
+
operationId: "listShares",
|
|
9008
|
+
description: "With `role=publisher` (the default), the shares the project published. With `role=grantee`, the shares addressed to the project and the public shares it accepted, each with the project's own `acceptance`. A public share the project never accepted is not listed.",
|
|
9009
|
+
moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/shares",
|
|
9010
|
+
httpMethod: "get",
|
|
9011
|
+
pathParams: [],
|
|
9012
|
+
queryParams: ["project_id", "role", "resource", "limit", "offset"],
|
|
9013
|
+
headerParams: [],
|
|
9014
|
+
cookieParams: [],
|
|
9015
|
+
flags: [{
|
|
9016
|
+
"name": "project_id",
|
|
9017
|
+
"description": "Project ID (required if not using project key auth, and always for `role=grantee`)",
|
|
9018
|
+
"required": false,
|
|
9019
|
+
"type": "string",
|
|
9020
|
+
"in": "query"
|
|
9021
|
+
}, {
|
|
9022
|
+
"name": "role",
|
|
9023
|
+
"description": "Which side of the shares to list",
|
|
9024
|
+
"required": false,
|
|
9025
|
+
"type": "string",
|
|
9026
|
+
"in": "query"
|
|
9027
|
+
}, {
|
|
9028
|
+
"name": "resource",
|
|
9029
|
+
"description": "Only shares of this resource SRN (`role=publisher` only)",
|
|
9030
|
+
"required": false,
|
|
9031
|
+
"type": "string",
|
|
9032
|
+
"in": "query"
|
|
9033
|
+
}, {
|
|
9034
|
+
"name": "limit",
|
|
9035
|
+
"description": "Number of results per page",
|
|
9036
|
+
"required": false,
|
|
9037
|
+
"type": "integer",
|
|
9038
|
+
"in": "query"
|
|
9039
|
+
}, {
|
|
9040
|
+
"name": "offset",
|
|
9041
|
+
"description": "Number of results to skip",
|
|
9042
|
+
"required": false,
|
|
9043
|
+
"type": "integer",
|
|
9044
|
+
"in": "query"
|
|
9045
|
+
}]
|
|
9046
|
+
},
|
|
9047
|
+
"create-share": {
|
|
9048
|
+
serviceClass: "Shares",
|
|
9049
|
+
operationId: "createShare",
|
|
9050
|
+
description: "Offers one of the project's resources to another project — or, with `grantee: \"*\"`, to every project — with the listed actions. The share grants nothing until the grantee accepts it. `grantee: \"*\"` is refused with `403 PUBLIC_SHARES_DISABLED` unless the deployment sets `SHARES_ALLOW_PUBLIC=true`.",
|
|
9051
|
+
moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/shares",
|
|
9052
|
+
httpMethod: "post",
|
|
9053
|
+
pathParams: [],
|
|
9054
|
+
queryParams: [],
|
|
9055
|
+
headerParams: [],
|
|
9056
|
+
cookieParams: [],
|
|
9057
|
+
flags: [{
|
|
9058
|
+
"name": "project_id",
|
|
9059
|
+
"description": "The publishing project (required if not using project key auth)",
|
|
9060
|
+
"required": false,
|
|
9061
|
+
"type": "string",
|
|
9062
|
+
"in": "body"
|
|
9063
|
+
}, {
|
|
9064
|
+
"name": "resource",
|
|
9065
|
+
"description": "The SRN of one resource in the publishing project, `srn:<project_id>:<type>:<id>`. No wildcard.",
|
|
9066
|
+
"required": true,
|
|
9067
|
+
"type": "string",
|
|
9068
|
+
"in": "body"
|
|
9069
|
+
}, {
|
|
9070
|
+
"name": "actions",
|
|
9071
|
+
"description": "The actions granted: `tools:CallTool` for a `tool`, `agents:CreateAgentGeneration` for an `agent`. Any other action is `400 VALIDATION_FAILED`.",
|
|
9072
|
+
"required": true,
|
|
9073
|
+
"type": "array",
|
|
9074
|
+
"in": "body"
|
|
9075
|
+
}, {
|
|
9076
|
+
"name": "grantee",
|
|
9077
|
+
"description": "The project the share is offered to, or `*` for every project. Never the publishing project itself.",
|
|
9078
|
+
"required": true,
|
|
9079
|
+
"type": "string",
|
|
9080
|
+
"in": "body"
|
|
9081
|
+
}, {
|
|
9082
|
+
"name": "cap",
|
|
9083
|
+
"description": "The calls each accepting project may make through the share per fixed window; a call past it is `429 SHARE_CAP_EXCEEDED`. Omit or `null` for no cap.",
|
|
9084
|
+
"required": false,
|
|
9085
|
+
"type": "object",
|
|
9086
|
+
"in": "body"
|
|
9087
|
+
}]
|
|
9088
|
+
},
|
|
9089
|
+
"get-share": {
|
|
9090
|
+
serviceClass: "Shares",
|
|
9091
|
+
operationId: "getShare",
|
|
9092
|
+
description: "Returns a share with the grantee's view of the resource in `projection`. The publisher reads any of its shares; a grantee project, named by `project_id` or by its scoped credential, reads a share addressed to it or a public one, with its own `acceptance`.",
|
|
9093
|
+
moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/shares",
|
|
9094
|
+
httpMethod: "get",
|
|
9095
|
+
pathParams: ["share_id"],
|
|
9096
|
+
queryParams: ["project_id"],
|
|
9097
|
+
headerParams: [],
|
|
9098
|
+
cookieParams: [],
|
|
9099
|
+
flags: [{
|
|
9100
|
+
"name": "share_id",
|
|
9101
|
+
"description": "Share ID",
|
|
9102
|
+
"required": true,
|
|
9103
|
+
"type": "string",
|
|
9104
|
+
"in": "path"
|
|
9105
|
+
}, {
|
|
9106
|
+
"name": "project_id",
|
|
9107
|
+
"description": "The project the caller reads as. Omit, or name the publisher, for the publisher's view; name a grantee project for its view.",
|
|
9108
|
+
"required": false,
|
|
9109
|
+
"type": "string",
|
|
9110
|
+
"in": "query"
|
|
9111
|
+
}]
|
|
9112
|
+
},
|
|
9113
|
+
"update-share": {
|
|
9114
|
+
serviceClass: "Shares",
|
|
9115
|
+
operationId: "updateShare",
|
|
9116
|
+
description: "Changes a share's `cap`, as its publisher. The next call through the share reads the new cap; a changed `window` starts a fresh count.",
|
|
9117
|
+
moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/shares",
|
|
9118
|
+
httpMethod: "patch",
|
|
9119
|
+
pathParams: ["share_id"],
|
|
9120
|
+
queryParams: [],
|
|
9121
|
+
headerParams: [],
|
|
9122
|
+
cookieParams: [],
|
|
9123
|
+
flags: [{
|
|
9124
|
+
"name": "share_id",
|
|
9125
|
+
"description": "Share ID",
|
|
9126
|
+
"required": true,
|
|
9127
|
+
"type": "string",
|
|
9128
|
+
"in": "path"
|
|
9129
|
+
}, {
|
|
9130
|
+
"name": "cap",
|
|
9131
|
+
"description": "The calls each accepting project may make through the share per fixed window; a call past it is `429 SHARE_CAP_EXCEEDED`. `null` removes the cap.",
|
|
9132
|
+
"required": false,
|
|
9133
|
+
"type": "object",
|
|
9134
|
+
"in": "body"
|
|
9135
|
+
}]
|
|
9136
|
+
},
|
|
9137
|
+
"delete-share": {
|
|
9138
|
+
serviceClass: "Shares",
|
|
9139
|
+
operationId: "deleteShare",
|
|
9140
|
+
description: "Deletes a share and every acceptance of it. Each project whose acceptance was active gets a `share_revoked` activity entry.",
|
|
9141
|
+
moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/shares",
|
|
9142
|
+
httpMethod: "delete",
|
|
9143
|
+
pathParams: ["share_id"],
|
|
9144
|
+
queryParams: [],
|
|
9145
|
+
headerParams: [],
|
|
9146
|
+
cookieParams: [],
|
|
9147
|
+
flags: [{
|
|
9148
|
+
"name": "share_id",
|
|
9149
|
+
"description": "Share ID",
|
|
9150
|
+
"required": true,
|
|
9151
|
+
"type": "string",
|
|
9152
|
+
"in": "path"
|
|
9153
|
+
}]
|
|
9154
|
+
},
|
|
9155
|
+
"accept-share": {
|
|
9156
|
+
serviceClass: "Shares",
|
|
9157
|
+
operationId: "acceptShare",
|
|
9158
|
+
description: "Records the grantee project's acceptance, which is what makes the share grant anything. Idempotent. A project that revoked its own acceptance may accept again; one whose acceptance the publisher revoked answers `403 SHARE_REVOKED` until the publisher deletes that acceptance. A suspended share can be accepted and grants nothing until resumed.",
|
|
9159
|
+
moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/shares",
|
|
9160
|
+
httpMethod: "post",
|
|
9161
|
+
pathParams: ["share_id"],
|
|
9162
|
+
queryParams: [],
|
|
9163
|
+
headerParams: [],
|
|
9164
|
+
cookieParams: [],
|
|
9165
|
+
flags: [{
|
|
9166
|
+
"name": "share_id",
|
|
9167
|
+
"description": "Share ID",
|
|
9168
|
+
"required": true,
|
|
9169
|
+
"type": "string",
|
|
9170
|
+
"in": "path"
|
|
9171
|
+
}, {
|
|
9172
|
+
"name": "project_id",
|
|
9173
|
+
"description": "The accepting project (required if not using project key auth)",
|
|
9174
|
+
"required": false,
|
|
9175
|
+
"type": "string",
|
|
9176
|
+
"in": "body"
|
|
9177
|
+
}]
|
|
9178
|
+
},
|
|
9179
|
+
"suspend-share": {
|
|
9180
|
+
serviceClass: "Shares",
|
|
9181
|
+
operationId: "suspendShare",
|
|
9182
|
+
description: "Sets `suspended_at`, which denies every acceptance without removing any. Reversible with resume; nobody re-accepts. Each project with an active acceptance gets a `share_suspended` activity entry. Idempotent.",
|
|
9183
|
+
moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/shares",
|
|
9184
|
+
httpMethod: "post",
|
|
9185
|
+
pathParams: ["share_id"],
|
|
9186
|
+
queryParams: [],
|
|
9187
|
+
headerParams: [],
|
|
9188
|
+
cookieParams: [],
|
|
9189
|
+
flags: [{
|
|
9190
|
+
"name": "share_id",
|
|
9191
|
+
"description": "Share ID",
|
|
9192
|
+
"required": true,
|
|
9193
|
+
"type": "string",
|
|
9194
|
+
"in": "path"
|
|
9195
|
+
}]
|
|
9196
|
+
},
|
|
9197
|
+
"resume-share": {
|
|
9198
|
+
serviceClass: "Shares",
|
|
9199
|
+
operationId: "resumeShare",
|
|
9200
|
+
description: "Clears `suspended_at`. Each project with an active acceptance gets a `share_resumed` activity entry. Idempotent.",
|
|
9201
|
+
moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/shares",
|
|
9202
|
+
httpMethod: "post",
|
|
9203
|
+
pathParams: ["share_id"],
|
|
9204
|
+
queryParams: [],
|
|
9205
|
+
headerParams: [],
|
|
9206
|
+
cookieParams: [],
|
|
9207
|
+
flags: [{
|
|
9208
|
+
"name": "share_id",
|
|
9209
|
+
"description": "Share ID",
|
|
9210
|
+
"required": true,
|
|
9211
|
+
"type": "string",
|
|
9212
|
+
"in": "path"
|
|
9213
|
+
}]
|
|
9214
|
+
},
|
|
9215
|
+
"revoke-share": {
|
|
9216
|
+
serviceClass: "Shares",
|
|
9217
|
+
operationId: "revokeShare",
|
|
9218
|
+
description: "As the publisher, revokes the whole share and every acceptance of it; terminal. Each project whose acceptance was active gets a `share_revoked` activity entry. As a grantee (`project_id`, or a credential scoped to it), revokes that project's own acceptance, which it may accept again later; while the project's own resources still name the shared resource (see `GET /api/v1/shares/{share_id}/references`), that answers `409 SHARE_IN_USE` unless `force=true`. A publisher's revoke is never refused on that account. Idempotent.",
|
|
9219
|
+
moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/shares",
|
|
9220
|
+
httpMethod: "post",
|
|
9221
|
+
pathParams: ["share_id"],
|
|
9222
|
+
queryParams: ["force"],
|
|
9223
|
+
headerParams: [],
|
|
9224
|
+
cookieParams: [],
|
|
9225
|
+
flags: [{
|
|
9226
|
+
"name": "share_id",
|
|
9227
|
+
"description": "Share ID",
|
|
9228
|
+
"required": true,
|
|
9229
|
+
"type": "string",
|
|
9230
|
+
"in": "path"
|
|
9231
|
+
}, {
|
|
9232
|
+
"name": "force",
|
|
9233
|
+
"description": "As a grantee, revoke even while the project's resources name the shared resource; they degrade as for a revoked share.",
|
|
9234
|
+
"required": false,
|
|
9235
|
+
"type": "boolean",
|
|
9236
|
+
"in": "query"
|
|
9237
|
+
}, {
|
|
9238
|
+
"name": "project_id",
|
|
9239
|
+
"description": "The project the caller revokes for. Omit, or name the publisher, to revoke the share; name a grantee project to revoke its acceptance.",
|
|
9240
|
+
"required": false,
|
|
9241
|
+
"type": "string",
|
|
9242
|
+
"in": "body"
|
|
9243
|
+
}]
|
|
9244
|
+
},
|
|
9245
|
+
"list-share-references": {
|
|
9246
|
+
serviceClass: "Shares",
|
|
9247
|
+
operationId: "listShareReferences",
|
|
9248
|
+
description: "The grantee project's own resources that name the resource the share grants: agents binding a shared tool, pipelines stepping through it, ingestion rules converting with it, orchestrations, triggers and formations naming it. What degrades if the project revokes its acceptance, and what `409 SHARE_IN_USE` lists. The grantee is named by `project_id` or by its scoped credential; the publisher holds none of these and is answered `400`.",
|
|
9249
|
+
moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/shares",
|
|
9250
|
+
httpMethod: "get",
|
|
9251
|
+
pathParams: ["share_id"],
|
|
9252
|
+
queryParams: ["project_id"],
|
|
9253
|
+
headerParams: [],
|
|
9254
|
+
cookieParams: [],
|
|
9255
|
+
flags: [{
|
|
9256
|
+
"name": "share_id",
|
|
9257
|
+
"description": "Share ID",
|
|
9258
|
+
"required": true,
|
|
9259
|
+
"type": "string",
|
|
9260
|
+
"in": "path"
|
|
9261
|
+
}, {
|
|
9262
|
+
"name": "project_id",
|
|
9263
|
+
"description": "The grantee project whose references to list.",
|
|
9264
|
+
"required": false,
|
|
9265
|
+
"type": "string",
|
|
9266
|
+
"in": "query"
|
|
9267
|
+
}]
|
|
9268
|
+
},
|
|
9269
|
+
"list-share-acceptances": {
|
|
9270
|
+
serviceClass: "Shares",
|
|
9271
|
+
operationId: "listShareAcceptances",
|
|
9272
|
+
description: "The projects that accepted the share, for its publisher.",
|
|
9273
|
+
moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/shares",
|
|
9274
|
+
httpMethod: "get",
|
|
9275
|
+
pathParams: ["share_id"],
|
|
9276
|
+
queryParams: ["status", "limit", "offset"],
|
|
9277
|
+
headerParams: [],
|
|
9278
|
+
cookieParams: [],
|
|
9279
|
+
flags: [{
|
|
9280
|
+
"name": "share_id",
|
|
9281
|
+
"description": "Share ID",
|
|
9282
|
+
"required": true,
|
|
9283
|
+
"type": "string",
|
|
9284
|
+
"in": "path"
|
|
9285
|
+
}, {
|
|
9286
|
+
"name": "status",
|
|
9287
|
+
"description": "Only acceptances in this status",
|
|
9288
|
+
"required": false,
|
|
9289
|
+
"type": "string",
|
|
9290
|
+
"in": "query"
|
|
9291
|
+
}, {
|
|
9292
|
+
"name": "limit",
|
|
9293
|
+
"description": "Number of results per page",
|
|
9294
|
+
"required": false,
|
|
9295
|
+
"type": "integer",
|
|
9296
|
+
"in": "query"
|
|
9297
|
+
}, {
|
|
9298
|
+
"name": "offset",
|
|
9299
|
+
"description": "Number of results to skip",
|
|
9300
|
+
"required": false,
|
|
9301
|
+
"type": "integer",
|
|
9302
|
+
"in": "query"
|
|
9303
|
+
}]
|
|
9304
|
+
},
|
|
9305
|
+
"revoke-share-acceptance": {
|
|
9306
|
+
serviceClass: "Shares",
|
|
9307
|
+
operationId: "revokeShareAcceptance",
|
|
9308
|
+
description: "The publisher cutting one consumer. The acceptance is kept with `revoked_by: publisher`, and a new accept from that project answers `403 SHARE_REVOKED` until the publisher deletes it. The project gets a `share_revoked` activity entry if the acceptance was active.",
|
|
9309
|
+
moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/shares",
|
|
9310
|
+
httpMethod: "post",
|
|
9311
|
+
pathParams: ["share_id", "acceptance_id"],
|
|
9312
|
+
queryParams: [],
|
|
9313
|
+
headerParams: [],
|
|
9314
|
+
cookieParams: [],
|
|
9315
|
+
flags: [{
|
|
9316
|
+
"name": "share_id",
|
|
9317
|
+
"description": "Share ID",
|
|
9318
|
+
"required": true,
|
|
9319
|
+
"type": "string",
|
|
9320
|
+
"in": "path"
|
|
9321
|
+
}, {
|
|
9322
|
+
"name": "acceptance_id",
|
|
9323
|
+
"description": "Share acceptance ID",
|
|
9324
|
+
"required": true,
|
|
9325
|
+
"type": "string",
|
|
9326
|
+
"in": "path"
|
|
9327
|
+
}]
|
|
9328
|
+
},
|
|
9329
|
+
"delete-share-acceptance": {
|
|
9330
|
+
serviceClass: "Shares",
|
|
9331
|
+
operationId: "deleteShareAcceptance",
|
|
9332
|
+
description: "Removes one project's acceptance, which lets a project the publisher revoked accept again. The project gets a `share_revoked` activity entry if the acceptance was active.",
|
|
9333
|
+
moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/shares",
|
|
9334
|
+
httpMethod: "delete",
|
|
9335
|
+
pathParams: ["share_id", "acceptance_id"],
|
|
9336
|
+
queryParams: [],
|
|
9337
|
+
headerParams: [],
|
|
9338
|
+
cookieParams: [],
|
|
9339
|
+
flags: [{
|
|
9340
|
+
"name": "share_id",
|
|
9341
|
+
"description": "Share ID",
|
|
9342
|
+
"required": true,
|
|
9343
|
+
"type": "string",
|
|
9344
|
+
"in": "path"
|
|
9345
|
+
}, {
|
|
9346
|
+
"name": "acceptance_id",
|
|
9347
|
+
"description": "Share acceptance ID",
|
|
9348
|
+
"required": true,
|
|
9349
|
+
"type": "string",
|
|
9350
|
+
"in": "path"
|
|
9351
|
+
}]
|
|
9352
|
+
},
|
|
9005
9353
|
"list-tasks": {
|
|
9006
9354
|
serviceClass: "Tasks",
|
|
9007
9355
|
operationId: "listTasks",
|
|
@@ -9419,7 +9767,7 @@ var routes = {
|
|
|
9419
9767
|
"get-tool": {
|
|
9420
9768
|
serviceClass: "Tools",
|
|
9421
9769
|
operationId: "getTool",
|
|
9422
|
-
description: "Returns a single tool by ID.",
|
|
9770
|
+
description: "Returns a single tool by ID. A credential scoped to a project the tool is shared with, through an accepted share, reads its `id`, `name`, `description` and `parameters` only.",
|
|
9423
9771
|
moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/tools",
|
|
9424
9772
|
httpMethod: "get",
|
|
9425
9773
|
pathParams: ["tool_id"],
|
|
@@ -9533,11 +9881,11 @@ var routes = {
|
|
|
9533
9881
|
"delete-tool": {
|
|
9534
9882
|
serviceClass: "Tools",
|
|
9535
9883
|
operationId: "deleteTool",
|
|
9536
|
-
description: "Deletes a tool by ID. A tool that is a decider's backend is refused with `409 TOOL_HAS_DEPENDENTS`.",
|
|
9884
|
+
description: "Deletes a tool by ID. A tool that is a decider's backend is refused with `409 TOOL_HAS_DEPENDENTS`, and so is one another project has accepted a share of, or one of its own project's ingestion rules converts with, until `force=true`. Every share of the tool is revoked when it is deleted; an ingestion rule keeps its `tool_id` and fails the documents it matches with `CONVERTER_FAILED` until repointed.",
|
|
9537
9885
|
moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/tools",
|
|
9538
9886
|
httpMethod: "delete",
|
|
9539
9887
|
pathParams: ["tool_id"],
|
|
9540
|
-
queryParams: [],
|
|
9888
|
+
queryParams: ["force"],
|
|
9541
9889
|
headerParams: [],
|
|
9542
9890
|
cookieParams: [],
|
|
9543
9891
|
flags: [{
|
|
@@ -9546,12 +9894,18 @@ var routes = {
|
|
|
9546
9894
|
"required": true,
|
|
9547
9895
|
"type": "string",
|
|
9548
9896
|
"in": "path"
|
|
9897
|
+
}, {
|
|
9898
|
+
"name": "force",
|
|
9899
|
+
"description": "Delete the tool even when another project has accepted a share of it, revoking those shares, or an ingestion rule converts with it. A decider backend still refuses.",
|
|
9900
|
+
"required": false,
|
|
9901
|
+
"type": "boolean",
|
|
9902
|
+
"in": "query"
|
|
9549
9903
|
}]
|
|
9550
9904
|
},
|
|
9551
9905
|
"call-tool": {
|
|
9552
9906
|
serviceClass: "Tools",
|
|
9553
9907
|
operationId: "callTool",
|
|
9554
|
-
description: "Directly invokes a tool and returns its output. Supported for `http`, `builtin`, `mcp`, and `pipeline` tools. `client` tools cannot be invoked server-side and will return 422. A `pipeline` tool runs its declared steps in order and returns the mapped `output` (or the last step's output); `action` is ignored and `input` is the pipeline input. For `builtin` and `mcp` tools the `action` field is required and identifies which action (SOAT) or tool name (MCP) to invoke. For `http` tools `action` is ignored. When a `builtin` or `mcp` tool declares an `actions` allowlist, an action outside it is rejected with `400 VALIDATION_FAILED` (\"not available on this tool\") before any outbound request is made. `preset_parameters` stored on the tool are pinned over the caller-supplied `input` before execution: a key the tool presets keeps its preset value even when `input` sets it. Keys the presets do not name are taken from `input` as sent. Guardrails attached to the tool or to its project adjudicate the call before dispatch, composing project + tool scope. A call this route cannot await a decision on — class C (human sign-off), class D, or a class-B tripwire — is refused with `422 TOOL_DISPATCH_FAILED`, whose `meta` carries the `tool_id` and the `outcome`. A `pipeline` tool is adjudicated before its first step runs, and every step is adjudicated as the call of that tool it is.",
|
|
9908
|
+
description: "Directly invokes a tool and returns its output. Supported for `http`, `builtin`, `mcp`, and `pipeline` tools. `client` tools cannot be invoked server-side and will return 422. A `pipeline` tool runs its declared steps in order and returns the mapped `output` (or the last step's output); `action` is ignored and `input` is the pipeline input. For `builtin` and `mcp` tools the `action` field is required and identifies which action (SOAT) or tool name (MCP) to invoke. For `http` tools `action` is ignored. When a `builtin` or `mcp` tool declares an `actions` allowlist, an action outside it is rejected with `400 VALIDATION_FAILED` (\"not available on this tool\") before any outbound request is made. `preset_parameters` stored on the tool are pinned over the caller-supplied `input` before execution: a key the tool presets keeps its preset value even when `input` sets it. Keys the presets do not name are taken from `input` as sent. Guardrails attached to the tool or to its project adjudicate the call before dispatch, composing project + tool scope. A call this route cannot await a decision on — class C (human sign-off), class D, or a class-B tripwire — is refused with `422 TOOL_DISPATCH_FAILED`, whose `meta` carries the `tool_id` and the `outcome`. A `pipeline` tool is adjudicated before its first step runs, and every step is adjudicated as the call of that tool it is. A credential scoped to a project the tool is shared with, through an accepted share, calls it in that project: the calling project's guardrails adjudicate it, it is metered there with `publisher_project_id`, and the tool receives the calling project as the `calling_project_id` tool context key.",
|
|
9555
9909
|
moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/tools",
|
|
9556
9910
|
httpMethod: "post",
|
|
9557
9911
|
pathParams: ["tool_id"],
|
|
@@ -10047,7 +10401,7 @@ var routes = {
|
|
|
10047
10401
|
moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/usage",
|
|
10048
10402
|
httpMethod: "get",
|
|
10049
10403
|
pathParams: [],
|
|
10050
|
-
queryParams: ["agent_id", "generation_id", "trace_id", "actor_id", "session_id", "ai_provider_id", "orchestration_run_id", "orchestration_id", "model", "trigger_id", "action_id", "tool_id", "outcome", "meter_type", "source", "limit", "offset"],
|
|
10404
|
+
queryParams: ["agent_id", "generation_id", "trace_id", "actor_id", "session_id", "ai_provider_id", "orchestration_run_id", "orchestration_id", "model", "trigger_id", "action_id", "tool_id", "publisher_project_id", "outcome", "meter_type", "source", "limit", "offset"],
|
|
10051
10405
|
headerParams: [],
|
|
10052
10406
|
cookieParams: [],
|
|
10053
10407
|
flags: [{
|
|
@@ -10118,7 +10472,13 @@ var routes = {
|
|
|
10118
10472
|
"in": "query"
|
|
10119
10473
|
}, {
|
|
10120
10474
|
"name": "tool_id",
|
|
10121
|
-
"description": "Filter by the tool a `tool_execution` event metered. A tool that does not exist in scope yields an empty page.\n",
|
|
10475
|
+
"description": "Filter by the tool a `tool_execution` event metered, including a tool another project shares with one in scope. A tool that does not exist in scope yields an empty page.\n",
|
|
10476
|
+
"required": false,
|
|
10477
|
+
"type": "string",
|
|
10478
|
+
"in": "query"
|
|
10479
|
+
}, {
|
|
10480
|
+
"name": "publisher_project_id",
|
|
10481
|
+
"description": "Filter to the calls made through a share of a resource the named project owns. A project that does not exist yields an empty page.\n",
|
|
10122
10482
|
"required": false,
|
|
10123
10483
|
"type": "string",
|
|
10124
10484
|
"in": "query"
|
|
@@ -10157,11 +10517,11 @@ var routes = {
|
|
|
10157
10517
|
"get-usage-aggregate": {
|
|
10158
10518
|
serviceClass: "Usage",
|
|
10159
10519
|
operationId: "getUsageAggregate",
|
|
10160
|
-
description: "Returns a project's usage rolled up over an optional `[from, to]` time window, optionally bucketed by a single dimension and narrowed by any combination of
|
|
10520
|
+
description: "Returns a project's usage rolled up over an optional `[from, to]` time window, optionally bucketed by a single dimension and narrowed by any combination of sixteen filters — session, actor, agent, AI provider, orchestration run, orchestration, generation, trace, tool, publisher project, meter type, model, source, trigger, action and outcome. That is how \"what did this conversation cost\", \"what has this end user cost\" and \"what did this agent cost\" are answered. Each group and the grand total carry an `event_count`, summed token counts, a measured `quantity` per component (so infra meters report their real amount, not zeros), and `cost_usd` (null when no event in the bucket was priced). This is the per-project cost-by-range/by-category query — a monthly figure without scanning raw usage events client-side. Narrowings intersect and apply to the whole rollup — every bucket, `totals` and `totals.distinct` alike — so each composes with any `group_by`, and all sixteen are echoed back under `filters`. The ten naming a resource are resolved against the project (a tool also through an accepted share), and one naming nothing there empties the rollup rather than being dropped: a mistyped id must never read back as the project's whole spend. The other six are matched against the value the event recorded. `groups` is paginated. Its `total` is the number of distinct buckets in the window — bucket cardinality, including a null bucket for the events the dimension does not apply to, and never a count of entities. To count entities, send `include=distinct` and read `totals.distinct`. `totals` always describes the whole window — never the page above it, and never the bucketing: omit `group_by` and `totals` is unchanged while `groups` is empty.",
|
|
10161
10521
|
moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/usage",
|
|
10162
10522
|
httpMethod: "get",
|
|
10163
10523
|
pathParams: [],
|
|
10164
|
-
queryParams: ["project_id", "group_by", "include", "from", "to", "meter_type", "session_id", "actor_id", "agent_id", "ai_provider_id", "orchestration_run_id", "orchestration_id", "generation_id", "trace_id", "model", "source", "trigger_id", "action_id", "tool_id", "outcome", "limit", "offset"],
|
|
10524
|
+
queryParams: ["project_id", "group_by", "include", "from", "to", "meter_type", "session_id", "actor_id", "agent_id", "ai_provider_id", "orchestration_run_id", "orchestration_id", "generation_id", "trace_id", "model", "source", "trigger_id", "action_id", "tool_id", "publisher_project_id", "outcome", "limit", "offset"],
|
|
10165
10525
|
headerParams: [],
|
|
10166
10526
|
cookieParams: [],
|
|
10167
10527
|
flags: [{
|
|
@@ -10274,7 +10634,13 @@ var routes = {
|
|
|
10274
10634
|
"in": "query"
|
|
10275
10635
|
}, {
|
|
10276
10636
|
"name": "tool_id",
|
|
10277
|
-
"description": "Narrow to the executions of one tool. An id naming no tool in
|
|
10637
|
+
"description": "Narrow to the executions of one tool, including one another project shares with this one. An id naming no tool in reach yields an empty rollup.\n",
|
|
10638
|
+
"required": false,
|
|
10639
|
+
"type": "string",
|
|
10640
|
+
"in": "query"
|
|
10641
|
+
}, {
|
|
10642
|
+
"name": "publisher_project_id",
|
|
10643
|
+
"description": "Narrow to the calls made through a share of a resource the named project owns. A project that does not exist yields an empty rollup.\n",
|
|
10278
10644
|
"required": false,
|
|
10279
10645
|
"type": "string",
|
|
10280
10646
|
"in": "query"
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@soat/cli",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.70.0",
|
|
4
4
|
"description": "CLI for SOAT — open-source infrastructure for production-ready AI agents.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"ai-agents",
|
|
@@ -22,7 +22,7 @@
|
|
|
22
22
|
"dependencies": {
|
|
23
23
|
"@inquirer/input": "^5.1.6",
|
|
24
24
|
"@inquirer/password": "^5.2.2",
|
|
25
|
-
"@soat/sdk": "0.
|
|
25
|
+
"@soat/sdk": "0.70.0",
|
|
26
26
|
"@ttoss/logger": "^0.8.20",
|
|
27
27
|
"commander": "^15.0.0",
|
|
28
28
|
"js-yaml": "^5.4.2"
|