agl 43.1.0 → 43.3.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/changelog.md +32 -0
- package/dist_serve/bundle.js +5950 -5530
- package/dist_serve/bundle.js.map +2 -2
- package/dist_serve/bundle.js.third-party-notices.json +31 -31
- package/dist_serve/bundle.js.third-party-notices.txt +31 -31
- package/dist_ts/00_commitinfo_data.js +1 -1
- package/dist_ts/aglapi/aglapisurface.document.js +521 -17
- package/dist_ts/aglapi/interfaces.d.ts +3 -0
- package/dist_ts/aglapi/interfaces.js +2 -1
- package/dist_ts/classes.accountsactions.d.ts +3 -1
- package/dist_ts/classes.accountsactions.js +21 -3
- package/dist_ts/classes.authmodels.js +17 -4
- package/dist_ts/classes.authstore.js +16 -2
- package/dist_ts/classes.claudeharness.d.ts +16 -0
- package/dist_ts/classes.claudeharness.js +24 -2
- package/dist_ts/classes.cli.d.ts +4 -2
- package/dist_ts/classes.cli.js +6 -3
- package/dist_ts/classes.codexclientadapter.d.ts +11 -0
- package/dist_ts/classes.codexclientadapter.js +14 -2
- package/dist_ts/classes.controller.d.ts +175 -11
- package/dist_ts/classes.controller.js +1213 -173
- package/dist_ts/classes.controllerdevices.d.ts +2 -0
- package/dist_ts/classes.controllerdevices.js +6 -1
- package/dist_ts/classes.controllermanagement.d.ts +14 -4
- package/dist_ts/classes.controllermanagement.js +20 -2
- package/dist_ts/classes.gatewayclient.d.ts +115 -0
- package/dist_ts/classes.gatewayclient.js +336 -0
- package/dist_ts/classes.gatewayclientstore.d.ts +97 -0
- package/dist_ts/classes.gatewayclientstore.js +261 -0
- package/dist_ts/classes.inbox.d.ts +72 -0
- package/dist_ts/classes.inbox.js +231 -0
- package/dist_ts/classes.inferencerouter.d.ts +19 -0
- package/dist_ts/classes.inferencerouter.js +15 -3
- package/dist_ts/classes.inferenceservice.d.ts +9 -0
- package/dist_ts/classes.inferenceservice.js +28 -2
- package/dist_ts/classes.mcpclient.d.ts +4 -1
- package/dist_ts/classes.mcpclient.js +42 -6
- package/dist_ts/classes.mcpcontrollerhost.d.ts +3 -1
- package/dist_ts/classes.mcpcontrollerhost.js +11 -1
- package/dist_ts/classes.mcptools.d.ts +3 -3
- package/dist_ts/classes.mcptools.js +38 -8
- package/dist_ts/classes.mcpvalidation.d.ts +5 -0
- package/dist_ts/classes.mcpvalidation.js +38 -2
- package/dist_ts/classes.nativesessions.d.ts +17 -4
- package/dist_ts/classes.nativesessions.js +41 -9
- package/dist_ts/classes.opencodeclient.d.ts +23 -2
- package/dist_ts/classes.opencodeclient.js +47 -3
- package/dist_ts/classes.proxycontrol.d.ts +11 -0
- package/dist_ts/classes.proxycontrol.js +7 -1
- package/dist_ts/classes.proxycontrolclient.d.ts +17 -0
- package/dist_ts/classes.proxycontrolclient.js +35 -1
- package/dist_ts/classes.proxydaemon.js +8 -1
- package/dist_ts/classes.proxymonitor.d.ts +7 -0
- package/dist_ts/classes.proxymonitor.js +13 -1
- package/dist_ts/classes.publishedset.d.ts +38 -0
- package/dist_ts/classes.publishedset.js +50 -0
- package/dist_ts/classes.sessionfeed.d.ts +3 -3
- package/dist_ts/classes.sessionfeed.js +18 -26
- package/dist_ts/classes.systemmetricssampler.d.ts +6 -0
- package/dist_ts/classes.systemmetricssampler.js +15 -3
- package/dist_ts/classes.ticketstore.d.ts +50 -3
- package/dist_ts/classes.ticketstore.js +45 -8
- package/dist_ts/classes.trustedproxysecrets.d.ts +2 -0
- package/dist_ts/classes.trustedproxysecrets.js +5 -1
- package/dist_ts/driver/classes.directreports.d.ts +14 -4
- package/dist_ts/driver/classes.directreports.js +25 -6
- package/dist_ts/driver/classes.driverservice.d.ts +44 -3
- package/dist_ts/driver/classes.driverservice.js +50 -16
- package/dist_ts/fleet/classes.claudeworkers.d.ts +21 -5
- package/dist_ts/fleet/classes.claudeworkers.js +142 -46
- package/dist_ts/fleet/classes.codexworkers.d.ts +16 -4
- package/dist_ts/fleet/classes.codexworkers.js +22 -5
- package/dist_ts/fleet/classes.workercommand.d.ts +6 -1
- package/dist_ts/fleet/classes.workercommand.js +15 -4
- package/dist_ts/fleet/classes.workers.d.ts +5 -1
- package/dist_ts/fleet/classes.workers.js +8 -2
- package/dist_ts/fleet/functions.unbounddrivers.js +2 -2
- package/dist_ts/fleet/functions.workervalidation.js +2 -2
- package/dist_ts/fleet/interfaces.workers.d.ts +21 -3
- package/dist_ts/fleet/interfaces.workers.js +1 -1
- package/dist_ts/functions.agentmessage.d.ts +3 -0
- package/dist_ts/functions.agentmessage.js +4 -1
- package/dist_ts/functions.controllermanagementsurface.d.ts +4 -0
- package/dist_ts/functions.controllermanagementsurface.js +15 -1
- package/dist_ts/functions.deviceapi.d.ts +151 -4
- package/dist_ts/functions.deviceapi.js +893 -38
- package/dist_ts/functions.fleetworkercli.d.ts +1 -1
- package/dist_ts/functions.fleetworkercli.js +11 -8
- package/dist_ts/functions.gatewaycli.d.ts +24 -0
- package/dist_ts/functions.gatewaycli.js +395 -0
- package/dist_ts/functions.gatewayroute.d.ts +135 -0
- package/dist_ts/functions.gatewayroute.js +366 -0
- package/dist_ts/functions.inferencecli.js +32 -1
- package/dist_ts/functions.inferencecliarguments.d.ts +8 -2
- package/dist_ts/functions.inferencecliarguments.js +31 -3
- package/dist_ts/functions.mcpfleetworkertools.js +2 -2
- package/dist_ts/functions.proxycapacity.d.ts +50 -0
- package/dist_ts/functions.proxycapacity.js +142 -0
- package/dist_ts/functions.proxycapacitycli.d.ts +30 -0
- package/dist_ts/functions.proxycapacitycli.js +65 -0
- package/dist_ts/functions.remotecli.d.ts +30 -3
- package/dist_ts/functions.remotecli.js +44 -18
- package/dist_ts/functions.ticketvalidation.js +11 -2
- package/dist_ts/interfaces.auth.d.ts +25 -4
- package/dist_ts/interfaces.auth.js +15 -1
- package/dist_ts/plugins.d.ts +5 -1
- package/dist_ts/plugins.js +10 -2
- package/dist_ts_authswitch/authority-contract.d.ts +25 -0
- package/dist_ts_authswitch/authority-contract.js +1 -1
- package/dist_ts_authswitch/authority-overview.d.ts +8 -0
- package/dist_ts_authswitch/authority-overview.js +17 -6
- package/dist_ts_authswitch/authority-placement.d.ts +20 -16
- package/dist_ts_authswitch/authority-placement.js +19 -26
- package/dist_ts_authswitch/authority-renewal.d.ts +34 -0
- package/dist_ts_authswitch/authority-renewal.js +56 -0
- package/dist_ts_authswitch/authority-usagelimit.d.ts +29 -0
- package/dist_ts_authswitch/authority-usagelimit.js +66 -2
- package/dist_ts_authswitch/authority-usagewindows.d.ts +6 -0
- package/dist_ts_authswitch/authority-usagewindows.js +15 -1
- package/dist_ts_authswitch/classes.authoritybroker.d.ts +8 -0
- package/dist_ts_authswitch/classes.authoritybroker.js +35 -2
- package/dist_ts_authswitch/classes.authoritycli.d.ts +1 -0
- package/dist_ts_authswitch/classes.authoritycli.js +44 -3
- package/dist_ts_authswitch/classes.authorityclient.d.ts +6 -1
- package/dist_ts_authswitch/classes.authorityclient.js +12 -4
- package/dist_ts_authswitch/classes.authoritydaemon.js +8 -1
- package/dist_ts_authswitch/classes.authoritydatabase.js +6 -2
- package/dist_ts_authswitch/classes.authoritymodels.d.ts +7 -0
- package/dist_ts_authswitch/classes.authoritymodels.js +21 -5
- package/dist_ts_interfaces/devices.d.ts +1012 -5
- package/dist_ts_interfaces/devices.js +68 -2
- package/dist_ts_interfaces/fleetworkers.d.ts +5 -3
- package/dist_ts_interfaces/gateway.d.ts +151 -0
- package/dist_ts_interfaces/gateway.js +66 -0
- package/dist_ts_interfaces/inbox.d.ts +234 -0
- package/dist_ts_interfaces/inbox.js +101 -0
- package/dist_ts_interfaces/index.d.ts +3 -0
- package/dist_ts_interfaces/index.js +4 -1
- package/dist_ts_interfaces/interfaces.d.ts +10 -3
- package/dist_ts_interfaces/interfaces.js +4 -2
- package/dist_ts_interfaces/management.d.ts +4 -4
- package/dist_ts_interfaces/management.js +3 -2
- package/dist_ts_interfaces/mcprequests.d.ts +48 -6
- package/dist_ts_interfaces/mcprequests.js +12 -1
- package/dist_ts_interfaces/mcpworkspacerequests.d.ts +4 -1
- package/dist_ts_interfaces/mcpworkspacerequests.js +1 -1
- package/dist_ts_interfaces/nativesessions.d.ts +16 -3
- package/dist_ts_interfaces/plugins.d.ts +2 -1
- package/dist_ts_interfaces/plugins.js +4 -2
- package/dist_ts_interfaces/proxycapacity.d.ts +99 -0
- package/dist_ts_interfaces/proxycapacity.js +74 -0
- package/dist_ts_interfaces/requests.accounts.d.ts +21 -0
- package/dist_ts_interfaces/requests.accounts.js +3 -1
- package/dist_ts_interfaces/requests.d.ts +3 -2
- package/dist_ts_interfaces/requests.js +1 -1
- package/docs/authswitch.md +20 -1
- package/package.json +6 -5
- package/readme.md +191 -31
- package/ts/00_commitinfo_data.ts +1 -1
- package/ts/aglapi/aglapisurface.document.ts +520 -16
- package/ts/aglapi/interfaces.ts +1 -0
- package/ts/classes.accountsactions.ts +30 -3
- package/ts/classes.authmodels.ts +22 -3
- package/ts/classes.authstore.ts +15 -1
- package/ts/classes.claudeharness.ts +27 -1
- package/ts/classes.cli.ts +7 -3
- package/ts/classes.codexclientadapter.ts +14 -1
- package/ts/classes.controller.ts +1428 -249
- package/ts/classes.controllerdevices.ts +6 -0
- package/ts/classes.controllermanagement.ts +40 -7
- package/ts/classes.gatewayclient.ts +401 -0
- package/ts/classes.gatewayclientstore.ts +272 -0
- package/ts/classes.inbox.ts +239 -0
- package/ts/classes.inferencerouter.ts +27 -2
- package/ts/classes.inferenceservice.ts +28 -1
- package/ts/classes.mcpclient.ts +42 -3
- package/ts/classes.mcpcontrollerhost.ts +15 -0
- package/ts/classes.mcptools.ts +42 -9
- package/ts/classes.mcpvalidation.ts +32 -1
- package/ts/classes.nativesessions.ts +50 -12
- package/ts/classes.opencodeclient.ts +55 -4
- package/ts/classes.proxycontrol.ts +16 -0
- package/ts/classes.proxycontrolclient.ts +30 -0
- package/ts/classes.proxydaemon.ts +8 -0
- package/ts/classes.proxymonitor.ts +12 -0
- package/ts/classes.publishedset.ts +56 -0
- package/ts/classes.sessionfeed.ts +17 -20
- package/ts/classes.systemmetricssampler.ts +13 -2
- package/ts/classes.ticketstore.ts +73 -12
- package/ts/classes.trustedproxysecrets.ts +5 -0
- package/ts/driver/classes.directreports.ts +25 -6
- package/ts/driver/classes.driverservice.ts +75 -14
- package/ts/fleet/classes.claudeworkers.ts +112 -39
- package/ts/fleet/classes.codexworkers.ts +21 -6
- package/ts/fleet/classes.workercommand.ts +14 -4
- package/ts/fleet/classes.workers.ts +9 -2
- package/ts/fleet/functions.unbounddrivers.ts +1 -1
- package/ts/fleet/functions.workervalidation.ts +1 -1
- package/ts/fleet/interfaces.workers.ts +20 -5
- package/ts/functions.agentmessage.ts +3 -0
- package/ts/functions.controllermanagementsurface.ts +15 -0
- package/ts/functions.deviceapi.ts +1071 -34
- package/ts/functions.fleetworkercli.ts +10 -7
- package/ts/functions.gatewaycli.ts +436 -0
- package/ts/functions.gatewayroute.ts +429 -0
- package/ts/functions.inferencecli.ts +26 -0
- package/ts/functions.inferencecliarguments.ts +30 -4
- package/ts/functions.mcpfleetworkertools.ts +1 -1
- package/ts/functions.proxycapacity.ts +191 -0
- package/ts/functions.proxycapacitycli.ts +104 -0
- package/ts/functions.remotecli.ts +56 -20
- package/ts/functions.ticketvalidation.ts +11 -1
- package/ts/interfaces.auth.ts +36 -4
- package/ts/plugins.ts +12 -0
- package/ts_authswitch/authority-contract.ts +20 -0
- package/ts_authswitch/authority-overview.ts +28 -6
- package/ts_authswitch/authority-placement.ts +27 -32
- package/ts_authswitch/authority-renewal.ts +64 -0
- package/ts_authswitch/authority-usagelimit.ts +84 -1
- package/ts_authswitch/authority-usagewindows.ts +13 -0
- package/ts_authswitch/classes.authoritybroker.ts +34 -1
- package/ts_authswitch/classes.authoritycli.ts +49 -2
- package/ts_authswitch/classes.authorityclient.ts +14 -4
- package/ts_authswitch/classes.authoritydaemon.ts +9 -1
- package/ts_authswitch/classes.authoritydatabase.ts +5 -1
- package/ts_authswitch/classes.authoritymodels.ts +23 -3
- package/ts_authswitch/native-contracts.md +21 -0
- package/ts_authswitch/readme.md +1 -1
- package/ts_interfaces/devices.schema.json +3573 -603
- package/ts_interfaces/devices.ts +1093 -4
- package/ts_interfaces/fleetworkers.ts +5 -3
- package/ts_interfaces/gateway.ts +242 -0
- package/ts_interfaces/inbox.ts +287 -0
- package/ts_interfaces/index.ts +3 -0
- package/ts_interfaces/interfaces.ts +9 -2
- package/ts_interfaces/management.ts +6 -4
- package/ts_interfaces/mcprequests.ts +61 -4
- package/ts_interfaces/mcpworkspacerequests.ts +4 -2
- package/ts_interfaces/nativesessions.ts +17 -3
- package/ts_interfaces/plugins.ts +3 -1
- package/ts_interfaces/proxycapacity.ts +162 -0
- package/ts_interfaces/requests.accounts.ts +20 -0
- package/ts_interfaces/requests.ts +4 -0
- package/ts_web/00_commitinfo_data.ts +1 -1
- package/ts_web/accounts.plugins.ts +4 -2
- package/ts_web/classes.accountsreadmodel.ts +33 -0
- package/ts_web/classes.browserpresentation.ts +19 -6
- package/ts_web/classes.inboxfeed.ts +329 -0
- package/ts_web/classes.nativesessionstate.ts +9 -23
- package/ts_web/elements.accounts.ts +121 -113
- package/ts_web/elements.configurationpane.ts +24 -37
- package/ts_web/elements.deployments.ts +66 -2
- package/ts_web/elements.devices.ts +4 -17
- package/ts_web/elements.flexlimitstrip.ts +21 -70
- package/ts_web/elements.harnesscontrollerapp.ts +198 -222
- package/ts_web/elements.inbox.ts +808 -0
- package/ts_web/functions.inbox.ts +95 -0
- package/ts_web/functions.sessioncards.ts +40 -0
- package/ts_web/plugins.ts +2 -0
|
@@ -7,7 +7,7 @@ export const AGL_API_SURFACE: plugins.flexTypedRequest.IFlexTypedRequestSurface
|
|
|
7
7
|
"method": "agl.mcp.context.resolve",
|
|
8
8
|
"path": "agl.agl_mcp_context_resolve",
|
|
9
9
|
"summary": "Resolves an absolute project directory and, optionally, one of its existing native tasks to AGL's project and qualified…",
|
|
10
|
-
"description": "Resolves an absolute project directory and, optionally, one of its existing native tasks to AGL's\nproject and qualified session. It does not take over a running task.",
|
|
10
|
+
"description": "Resolves an absolute project directory and, optionally, one of its existing native tasks to AGL's\nproject and qualified session. It does not take over a running task. A Claude Code session outside\nAGL (`sessions_list`'s `nativeSessions`) answers as `nativeSession` and is recorded nowhere.",
|
|
11
11
|
"omitted": [],
|
|
12
12
|
"inputSchema": {
|
|
13
13
|
"type": "object",
|
|
@@ -32,6 +32,9 @@ export const AGL_API_SURFACE: plugins.flexTypedRequest.IFlexTypedRequestSurface
|
|
|
32
32
|
},
|
|
33
33
|
"session": {
|
|
34
34
|
"$ref": "#/$defs/IControllerSession"
|
|
35
|
+
},
|
|
36
|
+
"nativeSession": {
|
|
37
|
+
"$ref": "#/$defs/IControllerNativeSession"
|
|
35
38
|
}
|
|
36
39
|
},
|
|
37
40
|
"required": [
|
|
@@ -39,7 +42,7 @@ export const AGL_API_SURFACE: plugins.flexTypedRequest.IFlexTypedRequestSurface
|
|
|
39
42
|
],
|
|
40
43
|
"additionalProperties": false
|
|
41
44
|
},
|
|
42
|
-
"declaration": "/**\n * Resolves an absolute project directory and, optionally, one of its existing native tasks to AGL's\n * project and qualified session. It does not take over a running task.\n */\nfunction agl_mcp_context_resolve(params: { directory: string; sessionId?: TControllerSessionId }): Promise<{ project: IControllerProject; session?: IControllerSession }>;"
|
|
45
|
+
"declaration": "/**\n * Resolves an absolute project directory and, optionally, one of its existing native tasks to AGL's\n * project and qualified session. It does not take over a running task. A Claude Code session outside\n * AGL (`sessions_list`'s `nativeSessions`) answers as `nativeSession` and is recorded nowhere.\n */\nfunction agl_mcp_context_resolve(params: { directory: string; sessionId?: TControllerSessionId }): Promise<{ project: IControllerProject; session?: IControllerSession; nativeSession?: IControllerNativeSession }>;"
|
|
43
46
|
},
|
|
44
47
|
{
|
|
45
48
|
"method": "agl.mcp.controller.settings.get",
|
|
@@ -478,6 +481,20 @@ export const AGL_API_SURFACE: plugins.flexTypedRequest.IFlexTypedRequestSurface
|
|
|
478
481
|
},
|
|
479
482
|
"declaration": "/**\n * Lists the projects registered with the running AGL controller.\n */\nfunction agl_mcp_projects_list(params?: Record<string, never>): Promise<{ projects: IControllerProject[] }>;"
|
|
480
483
|
},
|
|
484
|
+
{
|
|
485
|
+
"method": "agl.mcp.proxy.capacity",
|
|
486
|
+
"path": "agl.agl_mcp_proxy_capacity",
|
|
487
|
+
"summary": "A pool's room for new work in AGL's inference proxy, or both pools' when `provider` is absent: each counted account by …",
|
|
488
|
+
"description": "A pool's room for new work in AGL's inference proxy, or both pools' when `provider` is absent: each counted account by\nits id with its plan, state, headroom, binding window and when its headroom next grows, the newest provider 429 on\nthe pool, and an `open` or `wait` verdict against `minHeadroom` (15 unless given). The controller asks the proxy; the\nanswer names no account by label or email.",
|
|
489
|
+
"omitted": [],
|
|
490
|
+
"inputSchema": {
|
|
491
|
+
"$ref": "#/$defs/IProxyCapacityRequest"
|
|
492
|
+
},
|
|
493
|
+
"outputSchema": {
|
|
494
|
+
"$ref": "#/$defs/IProxyCapacityAnswer"
|
|
495
|
+
},
|
|
496
|
+
"declaration": "/**\n * A pool's room for new work in AGL's inference proxy, or both pools' when `provider` is absent: each counted account by\n * its id with its plan, state, headroom, binding window and when its headroom next grows, the newest provider 429 on\n * the pool, and an `open` or `wait` verdict against `minHeadroom` (15 unless given). The controller asks the proxy; the\n * answer names no account by label or email.\n */\nfunction agl_mcp_proxy_capacity(params?: IProxyCapacityRequest): Promise<IProxyCapacityAnswer>;"
|
|
497
|
+
},
|
|
481
498
|
{
|
|
482
499
|
"method": "agl.mcp.resource.attach",
|
|
483
500
|
"path": "agl.agl_mcp_resource_attach",
|
|
@@ -910,6 +927,10 @@ export const AGL_API_SURFACE: plugins.flexTypedRequest.IFlexTypedRequestSurface
|
|
|
910
927
|
"turnId": {
|
|
911
928
|
"type": "string",
|
|
912
929
|
"description": "The Codex or Claude Code turn a steer went into."
|
|
930
|
+
},
|
|
931
|
+
"native": {
|
|
932
|
+
"$ref": "#/$defs/TControllerNativeJobDelivery",
|
|
933
|
+
"description": "For a Claude Code background job outside AGL: how it took the message; `delivery` is then `controllerMcpNativeDeliveries[native]`."
|
|
913
934
|
}
|
|
914
935
|
},
|
|
915
936
|
"required": [
|
|
@@ -918,7 +939,7 @@ export const AGL_API_SURFACE: plugins.flexTypedRequest.IFlexTypedRequestSurface
|
|
|
918
939
|
],
|
|
919
940
|
"additionalProperties": false
|
|
920
941
|
},
|
|
921
|
-
"declaration": "/**\n * Delivers an attributed message from one agent to another task of the same project. Any caller\n * holding the descriptor token may send one, identified or not; the controller prefixes the text\n * with a header naming the declared sender and the caller it proved, so the task knows it is not\n * from its user, and the project's owner can refuse agent messages altogether. `steer` puts it into\n * the running turn, `next-turn` makes it the next turn's input and `queue` runs it after every\n * earlier message; each starts a turn when nothing runs. OpenCode cannot be steered.\n */\nfunction agl_mcp_session_message(params: {\n projectId: string;\n sessionId: IControllerRuntimeId;\n /** At most `controllerAgentMessageMaxTextBytes` of UTF-8. */\n text: string;\n /** Self-declared, see `isControllerAgentMessageSender`. */\n sender: string;\n delivery: TControllerPromptDelivery;\n /**\n * The turn a steer is for: a Codex turn as `session_read` reports it in\n * `codexActivity.turnId`, or a Claude Code turn an earlier steer's `turnId` named. A message\n * for another turn, or for one that no longer runs, is refused before dispatch. Required to\n * steer a turn another Codex client runs.\n */\n expectedTurnId?: string;\n}): Promise<{\n accepted: true;\n /**\n * How the message was delivered: `steer` only when a running turn took it, `next-turn` for a\n * steer no turn could take any more, otherwise the requested delivery.\n */\n delivery: TControllerPromptDelivery;\n /** The Codex or Claude Code turn a steer went into. */\n turnId?: string;\n}>;"
|
|
942
|
+
"declaration": "/**\n * Delivers an attributed message from one agent to another task of the same project. Any caller\n * holding the descriptor token may send one, identified or not; the controller prefixes the text\n * with a header naming the declared sender and the caller it proved, so the task knows it is not\n * from its user, and the project's owner can refuse agent messages altogether. `steer` puts it into\n * the running turn, `next-turn` makes it the next turn's input and `queue` runs it after every\n * earlier message; each starts a turn when nothing runs. OpenCode cannot be steered.\n */\nfunction agl_mcp_session_message(params: {\n projectId: string;\n sessionId: IControllerRuntimeId;\n /** At most `controllerAgentMessageMaxTextBytes` of UTF-8. */\n text: string;\n /** Self-declared, see `isControllerAgentMessageSender`. */\n sender: string;\n delivery: TControllerPromptDelivery;\n /**\n * The turn a steer is for: a Codex turn as `session_read` reports it in\n * `codexActivity.turnId`, or a Claude Code turn an earlier steer's `turnId` named. A message\n * for another turn, or for one that no longer runs, is refused before dispatch. Required to\n * steer a turn another Codex client runs.\n */\n expectedTurnId?: string;\n}): Promise<{\n accepted: true;\n /**\n * How the message was delivered: `steer` only when a running turn took it, `next-turn` for a\n * steer no turn could take any more, otherwise the requested delivery.\n */\n delivery: TControllerPromptDelivery;\n /** The Codex or Claude Code turn a steer went into. */\n turnId?: string;\n /**\n * For a Claude Code background job outside AGL: how it took the message; `delivery` is then\n * `controllerMcpNativeDeliveries[native]`.\n */\n native?: TControllerNativeJobDelivery;\n}>;"
|
|
922
943
|
},
|
|
923
944
|
{
|
|
924
945
|
"method": "agl.mcp.session.model.update",
|
|
@@ -991,9 +1012,16 @@ export const AGL_API_SURFACE: plugins.flexTypedRequest.IFlexTypedRequestSurface
|
|
|
991
1012
|
"additionalProperties": false
|
|
992
1013
|
},
|
|
993
1014
|
"outputSchema": {
|
|
994
|
-
"
|
|
1015
|
+
"anyOf": [
|
|
1016
|
+
{
|
|
1017
|
+
"$ref": "#/$defs/TControllerMcpSessionDetail"
|
|
1018
|
+
},
|
|
1019
|
+
{
|
|
1020
|
+
"$ref": "#/$defs/IControllerMcpNativeSessionDetail"
|
|
1021
|
+
}
|
|
1022
|
+
]
|
|
995
1023
|
},
|
|
996
|
-
"declaration": "/**\n * Reads the bounded current detail of one task: its newest messages, pending prompts, permissions,\n * questions, todos, scratchpad, model and, for Codex, the running turn. Read it again to follow the\n * task; each read answers its state at that moment.\n */\nfunction agl_mcp_session_read(params: {\n projectId: string;\n sessionId: IControllerRuntimeId;\n}): Promise<TControllerMcpSessionDetail>;"
|
|
1024
|
+
"declaration": "/**\n * Reads the bounded current detail of one task: its newest messages, pending prompts, permissions,\n * questions, todos, scratchpad, model and, for Codex, the running turn. Read it again to follow the\n * task; each read answers its state at that moment.\n */\nfunction agl_mcp_session_read(params: {\n projectId: string;\n sessionId: IControllerRuntimeId;\n}): Promise<TControllerMcpSessionDetail | IControllerMcpNativeSessionDetail>;"
|
|
997
1025
|
},
|
|
998
1026
|
{
|
|
999
1027
|
"method": "agl.mcp.session.rename",
|
|
@@ -1118,8 +1146,8 @@ export const AGL_API_SURFACE: plugins.flexTypedRequest.IFlexTypedRequestSurface
|
|
|
1118
1146
|
{
|
|
1119
1147
|
"method": "agl.mcp.sessions.list",
|
|
1120
1148
|
"path": "agl.agl_mcp_sessions_list",
|
|
1121
|
-
"summary": "Discovers a project's OpenCode, Flex and Codex tasks
|
|
1122
|
-
"description": "Discovers a project's OpenCode, Flex and Codex tasks from its folder and
|
|
1149
|
+
"summary": "Discovers a project's OpenCode, Flex and Codex tasks and AGL's own Claude Code conversations from its folder and config…",
|
|
1150
|
+
"description": "Discovers a project's OpenCode, Flex and Codex tasks and AGL's own Claude Code conversations from its folder and\nconfigured connections, tasks created outside AGL included (`sessions`), and, apart from them, the Claude Code\nsessions of the host's own Claude Code home whose directory is the project folder itself (`nativeSessions`): running\nones first, all of them, then at most `controllerMcpNativeSessionSettledLimit` settled ones, newest first\n(`nativeSessionsTruncated` when more may exist). `nativeSessionsError` names why the Claude Code inventory could not\nbe read; `nativeSessions` is then empty.",
|
|
1123
1151
|
"omitted": [],
|
|
1124
1152
|
"inputSchema": {
|
|
1125
1153
|
"type": "object",
|
|
@@ -1141,14 +1169,28 @@ export const AGL_API_SURFACE: plugins.flexTypedRequest.IFlexTypedRequestSurface
|
|
|
1141
1169
|
"items": {
|
|
1142
1170
|
"$ref": "#/$defs/IControllerSession"
|
|
1143
1171
|
}
|
|
1172
|
+
},
|
|
1173
|
+
"nativeSessions": {
|
|
1174
|
+
"type": "array",
|
|
1175
|
+
"items": {
|
|
1176
|
+
"$ref": "#/$defs/IControllerNativeSession"
|
|
1177
|
+
}
|
|
1178
|
+
},
|
|
1179
|
+
"nativeSessionsTruncated": {
|
|
1180
|
+
"type": "boolean",
|
|
1181
|
+
"const": true
|
|
1182
|
+
},
|
|
1183
|
+
"nativeSessionsError": {
|
|
1184
|
+
"type": "string"
|
|
1144
1185
|
}
|
|
1145
1186
|
},
|
|
1146
1187
|
"required": [
|
|
1147
|
-
"sessions"
|
|
1188
|
+
"sessions",
|
|
1189
|
+
"nativeSessions"
|
|
1148
1190
|
],
|
|
1149
1191
|
"additionalProperties": false
|
|
1150
1192
|
},
|
|
1151
|
-
"declaration": "/**\n * Discovers a project's OpenCode, Flex and Codex tasks from its folder and configured connections
|
|
1193
|
+
"declaration": "/**\n * Discovers a project's OpenCode, Flex and Codex tasks and AGL's own Claude Code conversations from its folder and\n * configured connections, tasks created outside AGL included (`sessions`), and, apart from them, the Claude Code\n * sessions of the host's own Claude Code home whose directory is the project folder itself (`nativeSessions`): running\n * ones first, all of them, then at most `controllerMcpNativeSessionSettledLimit` settled ones, newest first\n * (`nativeSessionsTruncated` when more may exist). `nativeSessionsError` names why the Claude Code inventory could not\n * be read; `nativeSessions` is then empty.\n */\nfunction agl_mcp_sessions_list(params: { projectId: string }): Promise<{\n sessions: IControllerSession[];\n nativeSessions: IControllerNativeSession[];\n nativeSessionsTruncated?: true;\n nativeSessionsError?: string;\n}>;"
|
|
1152
1194
|
},
|
|
1153
1195
|
{
|
|
1154
1196
|
"method": "agl.mcp.ticket.ask",
|
|
@@ -3115,6 +3157,36 @@ export const AGL_API_SURFACE: plugins.flexTypedRequest.IFlexTypedRequestSurface
|
|
|
3115
3157
|
},
|
|
3116
3158
|
"declaration": "/** What a conversation does once the limit that holds its prompts resets. Both default to off. */\ninterface IControllerLimitResumeOptions {\n /** Start the held prompts on their own once the limit has reset. */\n startAtReset: boolean;\n /** Compact the conversation before the held prompts start; applies with `startAtReset` only. */\n compactFirst: boolean;\n}"
|
|
3117
3159
|
},
|
|
3160
|
+
{
|
|
3161
|
+
"name": "IControllerMcpNativeSessionDetail",
|
|
3162
|
+
"schema": {
|
|
3163
|
+
"type": "object",
|
|
3164
|
+
"properties": {
|
|
3165
|
+
"kind": {
|
|
3166
|
+
"type": "string",
|
|
3167
|
+
"const": "native"
|
|
3168
|
+
},
|
|
3169
|
+
"session": {
|
|
3170
|
+
"$ref": "#/$defs/IControllerNativeSession"
|
|
3171
|
+
},
|
|
3172
|
+
"messagePage": {
|
|
3173
|
+
"$ref": "#/$defs/IControllerMessagePage"
|
|
3174
|
+
},
|
|
3175
|
+
"scratchpad": {
|
|
3176
|
+
"$ref": "#/$defs/IControllerSessionScratchpad"
|
|
3177
|
+
}
|
|
3178
|
+
},
|
|
3179
|
+
"required": [
|
|
3180
|
+
"kind",
|
|
3181
|
+
"session",
|
|
3182
|
+
"messagePage",
|
|
3183
|
+
"scratchpad"
|
|
3184
|
+
],
|
|
3185
|
+
"additionalProperties": false,
|
|
3186
|
+
"description": "A Claude Code session outside AGL as `agl.mcp.session.read` answers it: the session with why it takes no message (`readOnly`) or how it takes one (`jobDelivery`), its newest transcript page and its scratchpad."
|
|
3187
|
+
},
|
|
3188
|
+
"declaration": "/**\n * A Claude Code session outside AGL as `agl.mcp.session.read` answers it: the session with why it takes no message\n * (`readOnly`) or how it takes one (`jobDelivery`), its newest transcript page and its scratchpad.\n */\ninterface IControllerMcpNativeSessionDetail {\n kind: 'native';\n session: IControllerNativeSession;\n messagePage: IControllerMessagePage;\n scratchpad: IControllerSessionScratchpad;\n}"
|
|
3189
|
+
},
|
|
3118
3190
|
{
|
|
3119
3191
|
"name": "IControllerMcpStatusResponse",
|
|
3120
3192
|
"schema": {
|
|
@@ -3323,6 +3395,90 @@ export const AGL_API_SURFACE: plugins.flexTypedRequest.IFlexTypedRequestSurface
|
|
|
3323
3395
|
},
|
|
3324
3396
|
"declaration": "/**\n * A usage or rate limit a model provider reported. `usage_limit` means the account's quota is\n * spent until it resets; `rate_limit` is a throttle. `usage_reserve` is AGL's own: the account\n * reached its usage threshold (`maxUsagePercent`), so the rest of its quota is kept for use\n * outside AGL until the window resets. Times are Unix milliseconds.\n */\ninterface IControllerModelLimit {\n kind: TControllerModelLimitKind;\n /** The provider that reported the limit, for example `openai`. */\n provider: string;\n resetsAt?: number;\n /** The delay the provider asked for before the next request, in milliseconds. */\n retryAfterMs?: number;\n planType?: string;\n /** The exhausted limit window, for example `5h` or `7d`. */\n window?: string;\n}"
|
|
3325
3397
|
},
|
|
3398
|
+
{
|
|
3399
|
+
"name": "IControllerNativeSession",
|
|
3400
|
+
"schema": {
|
|
3401
|
+
"type": "object",
|
|
3402
|
+
"properties": {
|
|
3403
|
+
"harness": {
|
|
3404
|
+
"type": "string",
|
|
3405
|
+
"enum": [
|
|
3406
|
+
"claude",
|
|
3407
|
+
"codex"
|
|
3408
|
+
]
|
|
3409
|
+
},
|
|
3410
|
+
"nativeId": {
|
|
3411
|
+
"type": "string"
|
|
3412
|
+
},
|
|
3413
|
+
"profileId": {
|
|
3414
|
+
"type": "string",
|
|
3415
|
+
"description": "The fleet worker profile whose Claude Code home holds the session; absent for the host's own home and for Codex."
|
|
3416
|
+
},
|
|
3417
|
+
"cwd": {
|
|
3418
|
+
"type": "string"
|
|
3419
|
+
},
|
|
3420
|
+
"title": {
|
|
3421
|
+
"type": "string"
|
|
3422
|
+
},
|
|
3423
|
+
"status": {
|
|
3424
|
+
"type": "string",
|
|
3425
|
+
"enum": [
|
|
3426
|
+
"busy",
|
|
3427
|
+
"idle",
|
|
3428
|
+
"error"
|
|
3429
|
+
]
|
|
3430
|
+
},
|
|
3431
|
+
"updatedAt": {
|
|
3432
|
+
"type": "number",
|
|
3433
|
+
"description": "Unix milliseconds of the session's last activity, when its source reports it."
|
|
3434
|
+
},
|
|
3435
|
+
"workerName": {
|
|
3436
|
+
"type": "string",
|
|
3437
|
+
"description": "The fleet worker bound to the session."
|
|
3438
|
+
},
|
|
3439
|
+
"model": {
|
|
3440
|
+
"type": "string"
|
|
3441
|
+
},
|
|
3442
|
+
"effort": {
|
|
3443
|
+
"type": "string"
|
|
3444
|
+
},
|
|
3445
|
+
"readOnly": {
|
|
3446
|
+
"type": "object",
|
|
3447
|
+
"properties": {
|
|
3448
|
+
"reason": {
|
|
3449
|
+
"$ref": "#/$defs/TControllerNativeSessionReadOnlyReason"
|
|
3450
|
+
},
|
|
3451
|
+
"message": {
|
|
3452
|
+
"type": "string"
|
|
3453
|
+
}
|
|
3454
|
+
},
|
|
3455
|
+
"required": [
|
|
3456
|
+
"reason",
|
|
3457
|
+
"message"
|
|
3458
|
+
],
|
|
3459
|
+
"additionalProperties": false,
|
|
3460
|
+
"description": "Present while AGL does not write to the session; `message` is the reason the owner sees."
|
|
3461
|
+
},
|
|
3462
|
+
"jobDelivery": {
|
|
3463
|
+
"$ref": "#/$defs/TControllerNativeJobDelivery",
|
|
3464
|
+
"description": "How a message reaches the session, present exactly while it is a Claude Code background job that takes one."
|
|
3465
|
+
}
|
|
3466
|
+
},
|
|
3467
|
+
"required": [
|
|
3468
|
+
"cwd",
|
|
3469
|
+
"harness",
|
|
3470
|
+
"nativeId",
|
|
3471
|
+
"status",
|
|
3472
|
+
"title"
|
|
3473
|
+
],
|
|
3474
|
+
"additionalProperties": false
|
|
3475
|
+
},
|
|
3476
|
+
"declaration": "interface IControllerNativeSession extends IControllerNativeSessionRef {\n cwd: string;\n title: string;\n status: 'busy' | 'idle' | 'error';\n /** Unix milliseconds of the session's last activity, when its source reports it. */\n updatedAt?: number;\n /** The fleet worker bound to the session. */\n workerName?: string;\n model?: string;\n effort?: string;\n /** Present while AGL does not write to the session; `message` is the reason the owner sees. */\n readOnly?: { reason: TControllerNativeSessionReadOnlyReason; message: string };\n /** How a message reaches the session, present exactly while it is a Claude Code background job that takes one. */\n jobDelivery?: TControllerNativeJobDelivery;\n}"
|
|
3477
|
+
},
|
|
3478
|
+
{
|
|
3479
|
+
"name": "IControllerNativeSessionRef",
|
|
3480
|
+
"declaration": "/**\n * A session AGL lists but does not host: a Claude Code session of the host's own or a fleet profile's home, or a\n * thread on the host's shared Codex app-server. The project matters only for new sessions: such a session opens\n * wherever it runs. The controller resolves a reference only through the sources the session feed lists, so it never\n * reads a session by an arbitrary path.\n */\ninterface IControllerNativeSessionRef {\n harness: 'claude' | 'codex';\n nativeId: string;\n /** The fleet worker profile whose Claude Code home holds the session; absent for the host's own home and for Codex. */\n profileId?: string;\n}"
|
|
3481
|
+
},
|
|
3326
3482
|
{
|
|
3327
3483
|
"name": "IControllerNativeWait",
|
|
3328
3484
|
"schema": {
|
|
@@ -3524,7 +3680,8 @@ export const AGL_API_SURFACE: plugins.flexTypedRequest.IFlexTypedRequestSurface
|
|
|
3524
3680
|
"additionalProperties": {}
|
|
3525
3681
|
},
|
|
3526
3682
|
"createdAt": {
|
|
3527
|
-
"type": "number"
|
|
3683
|
+
"type": "number",
|
|
3684
|
+
"description": "Unix milliseconds when the request entered its harness's pending requests: the harness's own time where it has one."
|
|
3528
3685
|
}
|
|
3529
3686
|
},
|
|
3530
3687
|
"required": [
|
|
@@ -3533,11 +3690,12 @@ export const AGL_API_SURFACE: plugins.flexTypedRequest.IFlexTypedRequestSurface
|
|
|
3533
3690
|
"title",
|
|
3534
3691
|
"type",
|
|
3535
3692
|
"patterns",
|
|
3536
|
-
"metadata"
|
|
3693
|
+
"metadata",
|
|
3694
|
+
"createdAt"
|
|
3537
3695
|
],
|
|
3538
3696
|
"additionalProperties": false
|
|
3539
3697
|
},
|
|
3540
|
-
"declaration": "interface IControllerPermission {\n id: IControllerRuntimeId;\n sessionId: IControllerRuntimeId;\n title: string;\n type: string;\n patterns: string[];\n metadata: Record<string, unknown>;\n createdAt
|
|
3698
|
+
"declaration": "interface IControllerPermission {\n id: IControllerRuntimeId;\n sessionId: IControllerRuntimeId;\n title: string;\n type: string;\n patterns: string[];\n metadata: Record<string, unknown>;\n /** Unix milliseconds when the request entered its harness's pending requests: the harness's own time where it has one. */\n createdAt: number;\n}"
|
|
3541
3699
|
},
|
|
3542
3700
|
{
|
|
3543
3701
|
"name": "IControllerProject",
|
|
@@ -3778,16 +3936,21 @@ export const AGL_API_SURFACE: plugins.flexTypedRequest.IFlexTypedRequestSurface
|
|
|
3778
3936
|
"toolCallId": {
|
|
3779
3937
|
"$ref": "#/$defs/IControllerRuntimeId",
|
|
3780
3938
|
"description": "Tool call that raised the ask; links the request to its transcript entry."
|
|
3939
|
+
},
|
|
3940
|
+
"createdAt": {
|
|
3941
|
+
"type": "number",
|
|
3942
|
+
"description": "Unix milliseconds when the question entered its harness's pending requests."
|
|
3781
3943
|
}
|
|
3782
3944
|
},
|
|
3783
3945
|
"required": [
|
|
3784
3946
|
"id",
|
|
3785
3947
|
"sessionId",
|
|
3786
|
-
"questions"
|
|
3948
|
+
"questions",
|
|
3949
|
+
"createdAt"
|
|
3787
3950
|
],
|
|
3788
3951
|
"additionalProperties": false
|
|
3789
3952
|
},
|
|
3790
|
-
"declaration": "interface IControllerQuestion {\n id: IControllerRuntimeId;\n sessionId: IControllerRuntimeId;\n questions: IControllerQuestionItem[];\n /** Tool call that raised the ask; links the request to its transcript entry. */\n toolCallId?: IControllerRuntimeId;\n}"
|
|
3953
|
+
"declaration": "interface IControllerQuestion {\n id: IControllerRuntimeId;\n sessionId: IControllerRuntimeId;\n questions: IControllerQuestionItem[];\n /** Tool call that raised the ask; links the request to its transcript entry. */\n toolCallId?: IControllerRuntimeId;\n /** Unix milliseconds when the question entered its harness's pending requests. */\n createdAt: number;\n}"
|
|
3791
3954
|
},
|
|
3792
3955
|
{
|
|
3793
3956
|
"name": "IControllerQuestionItem",
|
|
@@ -4241,7 +4404,7 @@ export const AGL_API_SURFACE: plugins.flexTypedRequest.IFlexTypedRequestSurface
|
|
|
4241
4404
|
},
|
|
4242
4405
|
"protocolVersion": {
|
|
4243
4406
|
"type": "number",
|
|
4244
|
-
"const":
|
|
4407
|
+
"const": 53
|
|
4245
4408
|
},
|
|
4246
4409
|
"upgradeManagementVersion": {
|
|
4247
4410
|
"type": "number"
|
|
@@ -4367,7 +4530,7 @@ export const AGL_API_SURFACE: plugins.flexTypedRequest.IFlexTypedRequestSurface
|
|
|
4367
4530
|
],
|
|
4368
4531
|
"additionalProperties": false
|
|
4369
4532
|
},
|
|
4370
|
-
"declaration": "interface IControllerStatus {\n packageName: string;\n packageVersion: string;\n protocolVersion:
|
|
4533
|
+
"declaration": "interface IControllerStatus {\n packageName: string;\n packageVersion: string;\n protocolVersion: 53;\n upgradeManagementVersion: number;\n /**\n * The protocol of the controller's loopback management endpoint (`controllerManagementProtocolVersion`); absent\n * from a controller older than the endpoint, which this release refuses to manage.\n */\n managementProtocolVersion?: number;\n controllerPid: number;\n processGroupId: number;\n processFingerprint: string;\n processMode: TControllerProcessMode;\n lifecycleState: TControllerLifecycleState;\n startedAt: number;\n setupRequired: boolean;\n /** Present when the controller runs as the systemd user unit (`agl service install`); absent for a detached or foreground one. */\n serviceUnit?: \"agl-controller.service\";\n /** The TLS mode of the runtime configuration the controller runs with; absent until it is resolved. */\n tlsMode?: TControllerTlsMode;\n upgrade?: IControllerUpgradeStatus;\n /** AGL's inference proxy, by state only; details need a signed-in owner (`controller.proxy.status.get`). */\n proxy?: { state: TControllerProxyState };\n harnesses: Array<{\n harnessId: TControllerSessionHarnessId;\n pid?: number;\n state: TControllerHarnessLifecycleState;\n healthy: boolean;\n version?: string;\n supportsLocalAttachments?: boolean;\n connectionMode?: 'local' | 'shared' | 'remote';\n diagnostic?: IControllerCodexDiagnostic;\n /** Codex only: automatic reconnection of this entry's profile to the local shared app-server. */\n rejoin?: IControllerCodexRejoinStatus;\n /**\n * Codex only, on the controller status: every connected or required profile. The entry's\n * `healthy` is then true only when each of them is, apart from a profile on an account Codex\n * cannot run on now, listed `stopped` with an `account_unavailable` diagnostic that says why;\n * its other members describe the default profile.\n */\n profiles?: IControllerCodexProfileStatus[];\n }>;\n}"
|
|
4371
4534
|
},
|
|
4372
4535
|
{
|
|
4373
4536
|
"name": "IControllerTerminalResource",
|
|
@@ -4767,6 +4930,204 @@ export const AGL_API_SURFACE: plugins.flexTypedRequest.IFlexTypedRequestSurface
|
|
|
4767
4930
|
},
|
|
4768
4931
|
"declaration": "/**\n * A view of one project's working tree for the human: files, an editor and changes on disk. It owns\n * no process; the controller serves the tree on request, confined to the project directory.\n */\ninterface IControllerWorkspaceResource extends IControllerResourceBase {\n kind: 'workspace';\n /** Project-relative directory the workspace's tree starts at; the empty string is the project. */\n baseDir: string;\n /** Advanced by every base-directory switch; a switch names the revision it was based on. */\n baseRevision: number;\n}"
|
|
4769
4932
|
},
|
|
4933
|
+
{
|
|
4934
|
+
"name": "IProxyCapacityAnswer",
|
|
4935
|
+
"schema": {
|
|
4936
|
+
"type": "object",
|
|
4937
|
+
"properties": {
|
|
4938
|
+
"at": {
|
|
4939
|
+
"type": "string",
|
|
4940
|
+
"description": "When the proxy judged it, by its own clock."
|
|
4941
|
+
},
|
|
4942
|
+
"observedSince": {
|
|
4943
|
+
"type": "string",
|
|
4944
|
+
"description": "Since when the proxy observes its pools' provider 429s: its start."
|
|
4945
|
+
},
|
|
4946
|
+
"pools": {
|
|
4947
|
+
"type": "array",
|
|
4948
|
+
"items": {
|
|
4949
|
+
"$ref": "#/$defs/IProxyCapacityPool"
|
|
4950
|
+
}
|
|
4951
|
+
}
|
|
4952
|
+
},
|
|
4953
|
+
"required": [
|
|
4954
|
+
"at",
|
|
4955
|
+
"observedSince",
|
|
4956
|
+
"pools"
|
|
4957
|
+
],
|
|
4958
|
+
"additionalProperties": false
|
|
4959
|
+
},
|
|
4960
|
+
"declaration": "interface IProxyCapacityAnswer {\n /** When the proxy judged it, by its own clock. */\n at: string;\n /** Since when the proxy observes its pools' provider 429s: its start. */\n observedSince: string;\n pools: IProxyCapacityPool[];\n}"
|
|
4961
|
+
},
|
|
4962
|
+
{
|
|
4963
|
+
"name": "IProxyCapacityMember",
|
|
4964
|
+
"schema": {
|
|
4965
|
+
"type": "object",
|
|
4966
|
+
"properties": {
|
|
4967
|
+
"accountId": {
|
|
4968
|
+
"type": "string",
|
|
4969
|
+
"description": "The account's id (64 hex characters)."
|
|
4970
|
+
},
|
|
4971
|
+
"plan": {
|
|
4972
|
+
"type": "string",
|
|
4973
|
+
"description": "Its plan as its held reading states it, one the pool counts."
|
|
4974
|
+
},
|
|
4975
|
+
"state": {
|
|
4976
|
+
"$ref": "#/$defs/TProxyCapacityMemberState"
|
|
4977
|
+
},
|
|
4978
|
+
"headroom": {
|
|
4979
|
+
"type": "number",
|
|
4980
|
+
"description": "The headroom it adds to the room now: its headroom below its threshold while it takes new work, else 0."
|
|
4981
|
+
},
|
|
4982
|
+
"binding": {
|
|
4983
|
+
"anyOf": [
|
|
4984
|
+
{
|
|
4985
|
+
"$ref": "#/$defs/IProxyCapacityWindow"
|
|
4986
|
+
},
|
|
4987
|
+
{
|
|
4988
|
+
"type": "null"
|
|
4989
|
+
}
|
|
4990
|
+
],
|
|
4991
|
+
"description": "The window its headroom is bound by; `null` without a usable reading with a counted window."
|
|
4992
|
+
},
|
|
4993
|
+
"growsAt": {
|
|
4994
|
+
"type": [
|
|
4995
|
+
"string",
|
|
4996
|
+
"null"
|
|
4997
|
+
],
|
|
4998
|
+
"description": "When the headroom it adds next grows, from its reading alone: the binding window's reset, or the moment it takes work again (a provider 429's rest, a provider refusal, its windows' resets); `null` when it cannot grow or that moment is unknown (a stale reading, a sign-in or payment problem)."
|
|
4999
|
+
},
|
|
5000
|
+
"growsTo": {
|
|
5001
|
+
"type": [
|
|
5002
|
+
"number",
|
|
5003
|
+
"null"
|
|
5004
|
+
],
|
|
5005
|
+
"description": "The headroom it adds from `growsAt` on, at most; `null` with it."
|
|
5006
|
+
},
|
|
5007
|
+
"recheckAt": {
|
|
5008
|
+
"type": [
|
|
5009
|
+
"string",
|
|
5010
|
+
"null"
|
|
5011
|
+
],
|
|
5012
|
+
"description": "When the account service reads an account it cannot judge now again, when it says; `null` otherwise."
|
|
5013
|
+
}
|
|
5014
|
+
},
|
|
5015
|
+
"required": [
|
|
5016
|
+
"accountId",
|
|
5017
|
+
"plan",
|
|
5018
|
+
"state",
|
|
5019
|
+
"headroom",
|
|
5020
|
+
"binding",
|
|
5021
|
+
"growsAt",
|
|
5022
|
+
"growsTo",
|
|
5023
|
+
"recheckAt"
|
|
5024
|
+
],
|
|
5025
|
+
"additionalProperties": false,
|
|
5026
|
+
"description": "An account the pool counts: a subscription sign-in of a counted plan that has not lapsed."
|
|
5027
|
+
},
|
|
5028
|
+
"declaration": "/** An account the pool counts: a subscription sign-in of a counted plan that has not lapsed. */\ninterface IProxyCapacityMember {\n /** The account's id (64 hex characters). */\n accountId: string;\n /** Its plan as its held reading states it, one the pool counts. */\n plan: string;\n state: TProxyCapacityMemberState;\n /** The headroom it adds to the room now: its headroom below its threshold while it takes new work, else 0. */\n headroom: number;\n /** The window its headroom is bound by; `null` without a usable reading with a counted window. */\n binding: IProxyCapacityWindow | null;\n /**\n * When the headroom it adds next grows, from its reading alone: the binding window's reset, or the moment it takes\n * work again (a provider 429's rest, a provider refusal, its windows' resets); `null` when it cannot grow or that\n * moment is unknown (a stale reading, a sign-in or payment problem).\n */\n growsAt: string | null;\n /** The headroom it adds from `growsAt` on, at most; `null` with it. */\n growsTo: number | null;\n /** When the account service reads an account it cannot judge now again, when it says; `null` otherwise. */\n recheckAt: string | null;\n}"
|
|
5029
|
+
},
|
|
5030
|
+
{
|
|
5031
|
+
"name": "IProxyCapacityPool",
|
|
5032
|
+
"schema": {
|
|
5033
|
+
"type": "object",
|
|
5034
|
+
"properties": {
|
|
5035
|
+
"provider": {
|
|
5036
|
+
"$ref": "#/$defs/TProxyCapacityProvider"
|
|
5037
|
+
},
|
|
5038
|
+
"minHeadroom": {
|
|
5039
|
+
"type": "number"
|
|
5040
|
+
},
|
|
5041
|
+
"room": {
|
|
5042
|
+
"type": "number",
|
|
5043
|
+
"description": "The members' headroom summed, in percent."
|
|
5044
|
+
},
|
|
5045
|
+
"members": {
|
|
5046
|
+
"type": "array",
|
|
5047
|
+
"items": {
|
|
5048
|
+
"$ref": "#/$defs/IProxyCapacityMember"
|
|
5049
|
+
}
|
|
5050
|
+
},
|
|
5051
|
+
"last429At": {
|
|
5052
|
+
"type": [
|
|
5053
|
+
"string",
|
|
5054
|
+
"null"
|
|
5055
|
+
],
|
|
5056
|
+
"description": "The newest provider 429 on a member the proxy saw since `observedSince`, or `null`."
|
|
5057
|
+
},
|
|
5058
|
+
"verdict": {
|
|
5059
|
+
"$ref": "#/$defs/TProxyCapacityVerdict"
|
|
5060
|
+
}
|
|
5061
|
+
},
|
|
5062
|
+
"required": [
|
|
5063
|
+
"provider",
|
|
5064
|
+
"minHeadroom",
|
|
5065
|
+
"room",
|
|
5066
|
+
"members",
|
|
5067
|
+
"last429At",
|
|
5068
|
+
"verdict"
|
|
5069
|
+
],
|
|
5070
|
+
"additionalProperties": false
|
|
5071
|
+
},
|
|
5072
|
+
"declaration": "interface IProxyCapacityPool {\n provider: TProxyCapacityProvider;\n minHeadroom: number;\n /** The members' headroom summed, in percent. */\n room: number;\n members: IProxyCapacityMember[];\n /** The newest provider 429 on a member the proxy saw since `observedSince`, or `null`. */\n last429At: string | null;\n verdict: TProxyCapacityVerdict;\n}"
|
|
5073
|
+
},
|
|
5074
|
+
{
|
|
5075
|
+
"name": "IProxyCapacityRequest",
|
|
5076
|
+
"schema": {
|
|
5077
|
+
"type": "object",
|
|
5078
|
+
"properties": {
|
|
5079
|
+
"provider": {
|
|
5080
|
+
"$ref": "#/$defs/TProxyCapacityProvider"
|
|
5081
|
+
},
|
|
5082
|
+
"minHeadroom": {
|
|
5083
|
+
"type": "number"
|
|
5084
|
+
}
|
|
5085
|
+
},
|
|
5086
|
+
"additionalProperties": false,
|
|
5087
|
+
"description": "What is asked: one pool, or both when `provider` is absent, against `minHeadroom` (a non-negative integer)."
|
|
5088
|
+
},
|
|
5089
|
+
"declaration": "/** What is asked: one pool, or both when `provider` is absent, against `minHeadroom` (a non-negative integer). */\ninterface IProxyCapacityRequest {\n provider?: TProxyCapacityProvider;\n minHeadroom?: number;\n}"
|
|
5090
|
+
},
|
|
5091
|
+
{
|
|
5092
|
+
"name": "IProxyCapacityWindow",
|
|
5093
|
+
"schema": {
|
|
5094
|
+
"type": "object",
|
|
5095
|
+
"properties": {
|
|
5096
|
+
"name": {
|
|
5097
|
+
"type": "string",
|
|
5098
|
+
"description": "The provider's name for the window, or its length (`5h`, `7d`) for one without a name."
|
|
5099
|
+
},
|
|
5100
|
+
"durationSeconds": {
|
|
5101
|
+
"type": "number"
|
|
5102
|
+
},
|
|
5103
|
+
"usedPercent": {
|
|
5104
|
+
"type": "number",
|
|
5105
|
+
"description": "The percent its limit decides by: the account service's estimate between reads where it has one."
|
|
5106
|
+
},
|
|
5107
|
+
"estimated": {
|
|
5108
|
+
"type": "boolean",
|
|
5109
|
+
"description": "Whether `usedPercent` is that estimate."
|
|
5110
|
+
},
|
|
5111
|
+
"resetAt": {
|
|
5112
|
+
"type": [
|
|
5113
|
+
"string",
|
|
5114
|
+
"null"
|
|
5115
|
+
],
|
|
5116
|
+
"description": "When its current period ends, as the reading states it; `null` when it states none."
|
|
5117
|
+
}
|
|
5118
|
+
},
|
|
5119
|
+
"required": [
|
|
5120
|
+
"name",
|
|
5121
|
+
"durationSeconds",
|
|
5122
|
+
"usedPercent",
|
|
5123
|
+
"estimated",
|
|
5124
|
+
"resetAt"
|
|
5125
|
+
],
|
|
5126
|
+
"additionalProperties": false,
|
|
5127
|
+
"description": "A member's window, as its reading states it."
|
|
5128
|
+
},
|
|
5129
|
+
"declaration": "/** A member's window, as its reading states it. */\ninterface IProxyCapacityWindow {\n /** The provider's name for the window, or its length (`5h`, `7d`) for one without a name. */\n name: string;\n durationSeconds: number;\n /** The percent its limit decides by: the account service's estimate between reads where it has one. */\n usedPercent: number;\n /** Whether `usedPercent` is that estimate. */\n estimated: boolean;\n /** When its current period ends, as the reading states it; `null` when it states none. */\n resetAt: string | null;\n}"
|
|
5130
|
+
},
|
|
4770
5131
|
{
|
|
4771
5132
|
"name": "IReq_ControllerModelList",
|
|
4772
5133
|
"declaration": "interface IReq_ControllerModelList extends implementsTR<\n ITypedRequest,\n IReq_ControllerModelList\n> {\n method: 'controller.model.list';\n request: { projectId?: string; sessionId?: TControllerSessionId };\n response: {\n models: TControllerModelOption[];\n /**\n * Per harness, the model a new conversation runs on when none is chosen: what the controller\n * sends for it. A harness without one is absent; it then runs its own default unnamed.\n */\n defaults: IControllerDefaultModel[];\n /**\n * The usable Flex accounts in the order AGL's account placement takes a new conversation now:\n * a model chosen without an account runs on the first of them that offers it.\n */\n flexAccountPlacement: string[];\n codexContext?: IControllerCodexContext;\n };\n}"
|
|
@@ -6172,6 +6533,37 @@ export const AGL_API_SURFACE: plugins.flexTypedRequest.IFlexTypedRequestSurface
|
|
|
6172
6533
|
},
|
|
6173
6534
|
"declaration": "type TControllerModelRetryReason = 'rate_limit' | 'overloaded' | 'unavailable';"
|
|
6174
6535
|
},
|
|
6536
|
+
{
|
|
6537
|
+
"name": "TControllerNativeJobDelivery",
|
|
6538
|
+
"schema": {
|
|
6539
|
+
"type": "string",
|
|
6540
|
+
"enum": [
|
|
6541
|
+
"wake",
|
|
6542
|
+
"inbox"
|
|
6543
|
+
],
|
|
6544
|
+
"description": "How a message reaches a Claude Code background job (`claude --bg`) that AGL does not run: `wake` continues a settled (done, blocked or stopped) job through Claude Code's own `claude --bg --resume`, `inbox` puts it into a running job's inbox through Claude Code's own SendMessage, accepted and queued there, not yet read."
|
|
6545
|
+
},
|
|
6546
|
+
"declaration": "/**\n * How a message reaches a Claude Code background job (`claude --bg`) that AGL does not run: `wake` continues a settled\n * (done, blocked or stopped) job through Claude Code's own `claude --bg --resume`, `inbox` puts it into a running job's\n * inbox through Claude Code's own SendMessage, accepted and queued there, not yet read.\n */\ntype TControllerNativeJobDelivery = 'wake' | 'inbox';"
|
|
6547
|
+
},
|
|
6548
|
+
{
|
|
6549
|
+
"name": "TControllerNativeSessionReadOnlyReason",
|
|
6550
|
+
"schema": {
|
|
6551
|
+
"type": "string",
|
|
6552
|
+
"enum": [
|
|
6553
|
+
"running",
|
|
6554
|
+
"unaddressable",
|
|
6555
|
+
"notBackgroundJob",
|
|
6556
|
+
"profileHome",
|
|
6557
|
+
"directoryMissing",
|
|
6558
|
+
"projectConversation",
|
|
6559
|
+
"fleetWorker",
|
|
6560
|
+
"jobFailed",
|
|
6561
|
+
"jobHeld"
|
|
6562
|
+
],
|
|
6563
|
+
"description": "Why AGL does not write to a native session: `running`: another process runs it, and AGL never becomes its second writer; `unaddressable`: a running background job takes a message only by a session name no other running session shares, and it has none or shares it; `notBackgroundJob`: an agent reaches only a background job (MCP `session_message`); the owner's own native session view resumes another settled session; `profileHome`: it lives in a fleet profile's Claude Code home, which AGL's own Claude Code does not resume; `directoryMissing`: its directory is gone, so nothing resumes it; `projectConversation`: an AGL project conversation records it, and that project sends to it; `fleetWorker`: a fleet worker owns it, and the worker's view steers it; `jobFailed`: a Claude Code background job holds it and failed, and AGL wakes only a settled job; `jobHeld`: AGL's own Claude Code still holds a background job's conversation, so Claude Code would wake a copy."
|
|
6564
|
+
},
|
|
6565
|
+
"declaration": "/**\n * Why AGL does not write to a native session:\n * `running`: another process runs it, and AGL never becomes its second writer;\n * `unaddressable`: a running background job takes a message only by a session name no other running session shares, and\n * it has none or shares it;\n * `notBackgroundJob`: an agent reaches only a background job (MCP `session_message`); the owner's own native session view\n * resumes another settled session;\n * `profileHome`: it lives in a fleet profile's Claude Code home, which AGL's own Claude Code does not resume;\n * `directoryMissing`: its directory is gone, so nothing resumes it;\n * `projectConversation`: an AGL project conversation records it, and that project sends to it;\n * `fleetWorker`: a fleet worker owns it, and the worker's view steers it;\n * `jobFailed`: a Claude Code background job holds it and failed, and AGL wakes only a settled job;\n * `jobHeld`: AGL's own Claude Code still holds a background job's conversation, so Claude Code would wake a copy.\n */\ntype TControllerNativeSessionReadOnlyReason =\n 'running' | 'unaddressable' | 'notBackgroundJob' | 'profileHome' | 'directoryMissing' | 'projectConversation' | 'fleetWorker' | 'jobFailed' | 'jobHeld';"
|
|
6566
|
+
},
|
|
6175
6567
|
{
|
|
6176
6568
|
"name": "TControllerNativeWaitReason",
|
|
6177
6569
|
"schema": {
|
|
@@ -6494,6 +6886,118 @@ export const AGL_API_SURFACE: plugins.flexTypedRequest.IFlexTypedRequestSurface
|
|
|
6494
6886
|
},
|
|
6495
6887
|
"declaration": "/** Why Paint is unavailable for an incarnation or for the runtime. */\ntype TPaintUnavailableReason = 'not-selected' | 'sandbox' | 'sandbox-helper' | 'artifact-download' | 'artifact-integrity' | 'capture';"
|
|
6496
6888
|
},
|
|
6889
|
+
{
|
|
6890
|
+
"name": "TProxyCapacityMemberState",
|
|
6891
|
+
"schema": {
|
|
6892
|
+
"type": "string",
|
|
6893
|
+
"enum": [
|
|
6894
|
+
"available",
|
|
6895
|
+
"reserved",
|
|
6896
|
+
"exhausted",
|
|
6897
|
+
"cooling",
|
|
6898
|
+
"unavailable"
|
|
6899
|
+
],
|
|
6900
|
+
"description": "Whether a member takes new work now, as `agl proxy status` judges it, or why not."
|
|
6901
|
+
},
|
|
6902
|
+
"declaration": "/** Whether a member takes new work now, as `agl proxy status` judges it, or why not. */\ntype TProxyCapacityMemberState = 'available' | 'reserved' | 'exhausted' | 'cooling' | 'unavailable';"
|
|
6903
|
+
},
|
|
6904
|
+
{
|
|
6905
|
+
"name": "TProxyCapacityProvider",
|
|
6906
|
+
"schema": {
|
|
6907
|
+
"type": "string",
|
|
6908
|
+
"enum": [
|
|
6909
|
+
"anthropic",
|
|
6910
|
+
"openai"
|
|
6911
|
+
],
|
|
6912
|
+
"description": "A pool: Claude accounts (`anthropic`) or ChatGPT accounts (`openai`)."
|
|
6913
|
+
},
|
|
6914
|
+
"declaration": "/** A pool: Claude accounts (`anthropic`) or ChatGPT accounts (`openai`). */\ntype TProxyCapacityProvider = 'anthropic' | 'openai';"
|
|
6915
|
+
},
|
|
6916
|
+
{
|
|
6917
|
+
"name": "TProxyCapacityVerdict",
|
|
6918
|
+
"schema": {
|
|
6919
|
+
"anyOf": [
|
|
6920
|
+
{
|
|
6921
|
+
"type": "object",
|
|
6922
|
+
"properties": {
|
|
6923
|
+
"state": {
|
|
6924
|
+
"type": "string",
|
|
6925
|
+
"const": "open"
|
|
6926
|
+
}
|
|
6927
|
+
},
|
|
6928
|
+
"required": [
|
|
6929
|
+
"state"
|
|
6930
|
+
],
|
|
6931
|
+
"additionalProperties": false
|
|
6932
|
+
},
|
|
6933
|
+
{
|
|
6934
|
+
"type": "object",
|
|
6935
|
+
"properties": {
|
|
6936
|
+
"state": {
|
|
6937
|
+
"type": "string",
|
|
6938
|
+
"const": "wait"
|
|
6939
|
+
},
|
|
6940
|
+
"reason": {
|
|
6941
|
+
"$ref": "#/$defs/TProxyCapacityWaitReason"
|
|
6942
|
+
},
|
|
6943
|
+
"until": {
|
|
6944
|
+
"type": "string"
|
|
6945
|
+
},
|
|
6946
|
+
"seconds": {
|
|
6947
|
+
"type": "number"
|
|
6948
|
+
}
|
|
6949
|
+
},
|
|
6950
|
+
"required": [
|
|
6951
|
+
"state",
|
|
6952
|
+
"reason",
|
|
6953
|
+
"until",
|
|
6954
|
+
"seconds"
|
|
6955
|
+
],
|
|
6956
|
+
"additionalProperties": false
|
|
6957
|
+
},
|
|
6958
|
+
{
|
|
6959
|
+
"type": "object",
|
|
6960
|
+
"properties": {
|
|
6961
|
+
"state": {
|
|
6962
|
+
"type": "string",
|
|
6963
|
+
"const": "wait"
|
|
6964
|
+
},
|
|
6965
|
+
"reason": {
|
|
6966
|
+
"$ref": "#/$defs/TProxyCapacityWaitReason"
|
|
6967
|
+
},
|
|
6968
|
+
"until": {
|
|
6969
|
+
"type": "null"
|
|
6970
|
+
},
|
|
6971
|
+
"seconds": {
|
|
6972
|
+
"type": "null"
|
|
6973
|
+
}
|
|
6974
|
+
},
|
|
6975
|
+
"required": [
|
|
6976
|
+
"state",
|
|
6977
|
+
"reason",
|
|
6978
|
+
"until",
|
|
6979
|
+
"seconds"
|
|
6980
|
+
],
|
|
6981
|
+
"additionalProperties": false
|
|
6982
|
+
}
|
|
6983
|
+
],
|
|
6984
|
+
"description": "`open`: the pool takes new work now. `wait`: not before `until`, `seconds` from the answer's `at`; both `null` when the members' readings foresee no moment the room reaches the minimum."
|
|
6985
|
+
},
|
|
6986
|
+
"declaration": "/**\n * `open`: the pool takes new work now. `wait`: not before `until`, `seconds` from the answer's `at`; both `null` when\n * the members' readings foresee no moment the room reaches the minimum.\n */\ntype TProxyCapacityVerdict =\n | { state: 'open' }\n | { state: 'wait'; reason: TProxyCapacityWaitReason; until: string; seconds: number }\n | { state: 'wait'; reason: TProxyCapacityWaitReason; until: null; seconds: null };"
|
|
6987
|
+
},
|
|
6988
|
+
{
|
|
6989
|
+
"name": "TProxyCapacityWaitReason",
|
|
6990
|
+
"schema": {
|
|
6991
|
+
"type": "string",
|
|
6992
|
+
"enum": [
|
|
6993
|
+
"room",
|
|
6994
|
+
"provider-429",
|
|
6995
|
+
"quiet-unobserved"
|
|
6996
|
+
],
|
|
6997
|
+
"description": "Why a pool waits: too little room, a provider 429 within the quiet period, or a proxy that has not observed it long enough."
|
|
6998
|
+
},
|
|
6999
|
+
"declaration": "/** Why a pool waits: too little room, a provider 429 within the quiet period, or a proxy that has not observed it long enough. */\ntype TProxyCapacityWaitReason = 'room' | 'provider-429' | 'quiet-unobserved';"
|
|
7000
|
+
},
|
|
6497
7001
|
{
|
|
6498
7002
|
"name": "TTicketAutoLabel",
|
|
6499
7003
|
"schema": {
|