agl 43.2.0 → 43.3.1
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 +29 -0
- package/dist_serve/bundle.js +2845 -2638
- package/dist_serve/bundle.js.map +2 -2
- package/dist_serve/bundle.js.third-party-notices.json +1 -1
- package/dist_serve/bundle.js.third-party-notices.txt +1 -1
- package/dist_ts/00_commitinfo_data.js +1 -1
- package/dist_ts/aglapi/aglapisurface.document.js +197 -17
- package/dist_ts/classes.accountsactions.d.ts +3 -1
- package/dist_ts/classes.accountsactions.js +21 -3
- package/dist_ts/classes.authstore.d.ts +7 -0
- package/dist_ts/classes.authstore.js +9 -1
- package/dist_ts/classes.claudeharness.d.ts +29 -2
- package/dist_ts/classes.claudeharness.js +35 -6
- package/dist_ts/classes.codexclientadapter.d.ts +11 -0
- package/dist_ts/classes.codexclientadapter.js +14 -2
- package/dist_ts/classes.controller.d.ts +187 -12
- package/dist_ts/classes.controller.js +1208 -186
- package/dist_ts/classes.controllerdevices.d.ts +2 -0
- package/dist_ts/classes.controllerdevices.js +6 -1
- package/dist_ts/classes.inbox.d.ts +72 -0
- package/dist_ts/classes.inbox.js +231 -0
- package/dist_ts/classes.inferencerouter.d.ts +10 -0
- package/dist_ts/classes.inferencerouter.js +5 -3
- package/dist_ts/classes.inferenceservice.js +2 -2
- package/dist_ts/classes.mcpclient.d.ts +1 -1
- package/dist_ts/classes.mcpclient.js +24 -6
- package/dist_ts/classes.mcpcontrollerhost.js +6 -1
- package/dist_ts/classes.mcptools.js +18 -8
- package/dist_ts/classes.mcpvalidation.d.ts +5 -0
- package/dist_ts/classes.mcpvalidation.js +32 -2
- package/dist_ts/classes.nativesessions.d.ts +29 -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.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.workercallers.js +4 -2
- package/dist_ts/driver/classes.directreports.d.ts +14 -4
- package/dist_ts/driver/classes.directreports.js +42 -23
- package/dist_ts/driver/classes.directreportstore.d.ts +8 -1
- package/dist_ts/driver/classes.directreportstore.js +20 -10
- 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 +21 -1
- package/dist_ts/fleet/classes.workers.js +80 -40
- package/dist_ts/fleet/classes.workerstore.js +14 -8
- package/dist_ts/fleet/functions.unbounddrivers.js +2 -2
- package/dist_ts/fleet/functions.workervalidation.js +11 -4
- package/dist_ts/fleet/interfaces.workers.d.ts +27 -5
- package/dist_ts/fleet/interfaces.workers.js +8 -4
- package/dist_ts/functions.agentmessage.d.ts +3 -0
- package/dist_ts/functions.agentmessage.js +4 -1
- package/dist_ts/functions.deviceapi.d.ts +198 -4
- package/dist_ts/functions.deviceapi.js +1060 -38
- package/dist_ts/functions.exactpersistence.d.ts +3 -0
- package/dist_ts/functions.exactpersistence.js +4 -0
- package/dist_ts/functions.fleetworkercli.d.ts +1 -1
- package/dist_ts/functions.fleetworkercli.js +11 -8
- package/dist_ts/functions.inferencecli.js +3 -1
- package/dist_ts/functions.mcpfleetworkertools.js +3 -3
- package/dist_ts/functions.ticketactor.d.ts +17 -1
- package/dist_ts/functions.ticketactor.js +55 -15
- package/dist_ts/functions.ticketvalidation.js +11 -2
- package/dist_ts/interfaces.auth.d.ts +1 -1
- package/dist_ts/interfaces.auth.js +9 -1
- package/dist_ts/plugins.d.ts +3 -1
- package/dist_ts/plugins.js +7 -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 +17 -10
- package/dist_ts_authswitch/authority-renewal.d.ts +34 -0
- package/dist_ts_authswitch/authority-renewal.js +56 -0
- 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 +1027 -7
- package/dist_ts_interfaces/devices.js +68 -2
- package/dist_ts_interfaces/fleetworkers.d.ts +37 -10
- package/dist_ts_interfaces/fleetworkers.js +19 -8
- package/dist_ts_interfaces/inbox.d.ts +234 -0
- package/dist_ts_interfaces/inbox.js +101 -0
- package/dist_ts_interfaces/index.d.ts +1 -0
- package/dist_ts_interfaces/index.js +2 -1
- package/dist_ts_interfaces/interfaces.d.ts +10 -3
- package/dist_ts_interfaces/interfaces.js +4 -2
- package/dist_ts_interfaces/mcprequests.d.ts +34 -4
- package/dist_ts_interfaces/mcprequests.js +11 -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/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/dist_ts_interfaces/workercallers.d.ts +2 -0
- package/dist_ts_migration/classes.documentmigrationrunner.d.ts +14 -0
- package/dist_ts_migration/classes.documentmigrationrunner.js +20 -1
- package/dist_ts_migration/index.d.ts +1 -0
- package/dist_ts_migration/index.js +2 -1
- package/dist_ts_migration/v43_ticketactornames.d.ts +32 -0
- package/dist_ts_migration/v43_ticketactornames.js +236 -0
- package/docs/authswitch.md +20 -1
- package/package.json +3 -3
- package/readme.md +144 -27
- package/ts/00_commitinfo_data.ts +1 -1
- package/ts/aglapi/aglapisurface.document.ts +196 -16
- package/ts/classes.accountsactions.ts +30 -3
- package/ts/classes.authstore.ts +10 -0
- package/ts/classes.claudeharness.ts +45 -5
- package/ts/classes.codexclientadapter.ts +14 -1
- package/ts/classes.controller.ts +1412 -262
- package/ts/classes.controllerdevices.ts +6 -0
- package/ts/classes.inbox.ts +239 -0
- package/ts/classes.inferencerouter.ts +15 -2
- package/ts/classes.inferenceservice.ts +1 -1
- package/ts/classes.mcpclient.ts +24 -3
- package/ts/classes.mcpcontrollerhost.ts +5 -0
- package/ts/classes.mcptools.ts +17 -7
- package/ts/classes.mcpvalidation.ts +27 -1
- package/ts/classes.nativesessions.ts +63 -12
- package/ts/classes.opencodeclient.ts +55 -4
- 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.workercallers.ts +3 -1
- package/ts/driver/classes.directreports.ts +42 -23
- package/ts/driver/classes.directreportstore.ts +20 -9
- 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 +75 -41
- package/ts/fleet/classes.workerstore.ts +11 -7
- package/ts/fleet/functions.unbounddrivers.ts +1 -1
- package/ts/fleet/functions.workervalidation.ts +8 -3
- package/ts/fleet/interfaces.workers.ts +26 -7
- package/ts/functions.agentmessage.ts +3 -0
- package/ts/functions.deviceapi.ts +1292 -34
- package/ts/functions.exactpersistence.ts +5 -0
- package/ts/functions.fleetworkercli.ts +10 -7
- package/ts/functions.inferencecli.ts +2 -0
- package/ts/functions.mcpfleetworkertools.ts +2 -2
- package/ts/functions.ticketactor.ts +58 -14
- package/ts/functions.ticketvalidation.ts +11 -1
- package/ts/interfaces.auth.ts +8 -0
- package/ts/plugins.ts +7 -0
- package/ts_authswitch/authority-contract.ts +20 -0
- package/ts_authswitch/authority-overview.ts +28 -6
- package/ts_authswitch/authority-placement.ts +25 -17
- package/ts_authswitch/authority-renewal.ts +64 -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 +3576 -603
- package/ts_interfaces/devices.ts +1111 -6
- package/ts_interfaces/fleetworkers.ts +38 -10
- package/ts_interfaces/inbox.ts +287 -0
- package/ts_interfaces/index.ts +1 -0
- package/ts_interfaces/interfaces.ts +9 -2
- package/ts_interfaces/mcprequests.ts +43 -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/requests.accounts.ts +20 -0
- package/ts_interfaces/requests.ts +4 -0
- package/ts_interfaces/workercallers.ts +2 -0
- package/ts_migration/classes.documentmigrationrunner.ts +21 -0
- package/ts_migration/index.ts +1 -0
- package/ts_migration/v43_ticketactornames.ts +225 -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 +10 -5
- package/ts_web/classes.inboxfeed.ts +329 -0
- package/ts_web/classes.nativesessionstate.ts +9 -23
- package/ts_web/elements.accounts.ts +81 -0
- package/ts_web/elements.deployments.ts +66 -2
- package/ts_web/elements.fleetworker.ts +4 -2
- package/ts_web/elements.harnesscontrollerapp.ts +107 -37
- 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
|
@@ -1,7 +1,113 @@
|
|
|
1
|
-
import
|
|
2
|
-
import { type
|
|
1
|
+
import * as plugins from './plugins.js';
|
|
2
|
+
import { controllerOperationFailedErrorCode, type IControllerAuthorityProjection, type IControllerDevice, type IControllerDriverStatus, type IControllerEvent, type IControllerFleetWorkerView, type IControllerGatewayStatus, type IControllerInboxSnapshot, type IControllerMessageBundle, type IControllerPermission, type IControllerQuestion, type IControllerSessionFeedRow, type IDirectReportView, type IFleetDeployStatus, type IFleetDeployTicketPlacement, type IProxyCapacityAnswer, type ITicket, type ITicketBoard, type ITicketComment, type ITicketPerson, type ITicketQuestion, type TControllerAccountsAnswer, type TControllerAccountUsage, type TControllerElicitation, type TControllerEventType, type TControllerInboxDelta, type TControllerInboxItem, type TControllerSessionFeedDelta, type IFleetWorkerJob } from '../dist_ts_interfaces/index.js';
|
|
3
|
+
import { type IDeviceDirectReport, type IDeviceDriverStatus, type IDeviceHostAgl, type IDeviceHostDevice, type IDeviceHostUnavailable, type IDeviceInboxDelta, type IDeviceMessage, type IDevicePermission, type IDeviceTicketQuestion, type IReq_DeviceInboxList, type IReq_DeviceTicketAnswer, type TDeviceInboxItem, type IDeviceQuestion, type IDeviceSessionFeedDelta, type IDeviceSessionRow, type IDeviceTicket, type IDeviceTicketCard, type IDeviceTicketComment, type IDeviceTicketPerson, type IDeviceTicketPlacement, type IDeviceTicketPlans, type IReq_DeviceAuthChallenge, type IReq_DeviceAuthProve, type IReq_DeviceBoardList, type IReq_DeviceDirectReportMessage, type IReq_DeviceDriverRead, type IReq_DeviceDriverSend, type IReq_DeviceElicitationReply, type IReq_DeviceHostGet, type IReq_DevicePair, type IReq_DevicePermissionReply, type IReq_DeviceQuestionReply, type IReq_DeviceSessionRead, type IReq_DeviceSessionSend, type IReq_DeviceTicketAsk, type IReq_DeviceTicketComment, type IReq_DeviceTicketGet, type IReq_DeviceTicketMove, type TDeviceEvent, type TDeviceElicitation, type TDeviceRefusalCode } from '../dist_ts_interfaces/devices.js';
|
|
4
|
+
import { type DriverService, type IDriverNeedsInput } from './driver/classes.driverservice.js';
|
|
5
|
+
import type { TAuthErrorCode } from './interfaces.auth.js';
|
|
6
|
+
import { type TConfigurationErrorCode } from './configuration/classes.configurationerror.js';
|
|
7
|
+
import type { ControllerElicitationReplyError } from './functions.elicitation.js';
|
|
8
|
+
import type { FleetNativeTurnError } from './fleet/interfaces.workers.js';
|
|
3
9
|
/** The controller events a device receives, each projected by `deviceEvent`; every other event never reaches one. */
|
|
4
10
|
export declare const deviceRelayedEventTypes: ReadonlySet<TControllerEventType>;
|
|
11
|
+
/** Every refusal code of the device contract, once: what a device request may be refused with as it is. */
|
|
12
|
+
export declare const deviceRefusalCodes: ReadonlySet<string>;
|
|
13
|
+
/**
|
|
14
|
+
* Every code the controller refuses a device's request with before the device error translation: the codes of the
|
|
15
|
+
* typed errors `asTypedResponseError` passes on as their own (the auth store's, the configuration authority's, an
|
|
16
|
+
* elicitation reply's, a native Codex turn's), the codes it gives the others (`controller_operation_failed` for a fault
|
|
17
|
+
* under a failure journal reference), and the codes the browser's shared functions a device runs refuse with (session
|
|
18
|
+
* reads and sends, native sessions, answers, direct children).
|
|
19
|
+
*/
|
|
20
|
+
export type TControllerRefusalCode = TAuthErrorCode | TConfigurationErrorCode | ControllerElicitationReplyError['code'] | FleetNativeTurnError['code'] | typeof controllerOperationFailedErrorCode | 'concurrent_change' | 'operation_limit' | 'session_not_found' | 'outcome_unknown' | 'flex_not_ready' | 'flex_operation_failed' | 'flex_projection_not_found' | 'flex_projection_cursor_invalid' | 'flex_projection_invalid' | 'controller_unavailable' | 'invalid_request' | 'rate_limited' | 'session_read_only' | 'project_not_found' | 'harness_unavailable' | 'native_session_failed' | 'not_found' | 'child_scope_invalid' | 'model_not_found' | 'model_harness_mismatch' | 'attachments_unsupported' | 'message_rate_limited';
|
|
21
|
+
/** A controller refusal's device code, by its code alone or, where its data says more, by its data. */
|
|
22
|
+
type TDeviceRefusalOf = TDeviceRefusalCode | ((errorDataArg: Readonly<Record<string, unknown>>) => TDeviceRefusalCode);
|
|
23
|
+
/**
|
|
24
|
+
* How every controller code outside the device contract reaches a device: the one table the device error translation
|
|
25
|
+
* reads, so the compiler names every code a new controller refusal adds before a device can meet it. A state of the
|
|
26
|
+
* controller is `controller_unavailable`; a race AGL lost before it acted `concurrent_change`; a dispatch that may have
|
|
27
|
+
* happened `outcome_unknown`; a session the device can no longer reach `session_not_found`; a refusal the owner resolves
|
|
28
|
+
* in the browser `session_read_only`; and a fault, or a refusal of a request no device makes, `controller_failed` with
|
|
29
|
+
* the failure journal's reference.
|
|
30
|
+
*/
|
|
31
|
+
export declare const deviceControllerRefusals: Readonly<Record<Exclude<TControllerRefusalCode, TDeviceRefusalCode>, TDeviceRefusalOf>>;
|
|
32
|
+
/**
|
|
33
|
+
* The device error translation: the refusal a device receives for the typed refusal `typedArg` the controller answers
|
|
34
|
+
* `causeArg` with, always a code of the device contract. A contract code passes as it is; every other code maps through
|
|
35
|
+
* `deviceControllerRefusals`, with the controller's message, or the device code's own sentence where that message may
|
|
36
|
+
* carry a raw cause (`deviceRawTextCodes`). A fault, and a code the table does not know, is `controller_failed` with one
|
|
37
|
+
* fixed sentence and the failure journal's reference: the controller's own when it kept the cause, else one recorded
|
|
38
|
+
* here for `methodArg`.
|
|
39
|
+
*/
|
|
40
|
+
export declare const deviceContractError: (typedArg: plugins.typedrequest.TypedResponseError, causeArg: unknown, methodArg: string) => plugins.typedrequest.TypedResponseError;
|
|
41
|
+
/**
|
|
42
|
+
* Runs a device's driver request and answers its failures in the device contract: a driver error by its device code,
|
|
43
|
+
* and a driver project or session that went away after the status named it as `driver_absent`. Every other failure is
|
|
44
|
+
* the session read's or send's own, as `device.session.read` and `device.session.send` answer it.
|
|
45
|
+
*/
|
|
46
|
+
export declare const serveDeviceDriver: <T>(operationArg: () => Promise<T>) => Promise<T>;
|
|
47
|
+
/**
|
|
48
|
+
* A failure of the owner's message to a direct report, in the device contract: another Codex client's turn is
|
|
49
|
+
* `direct_report_busy` (a device reads no turn to name), the agent message rate `rate_limited` (final, as for every
|
|
50
|
+
* device request), and every other refusal outside the contract `direct_report_failed` with its text and the failure
|
|
51
|
+
* journal's reference, where AGL kept the cause; a refusal whose message may carry a raw cause (`deviceRawTextCodes`)
|
|
52
|
+
* reads `deviceRefusalSentences.direct_report_failed` instead, its message kept in the failure journal. Other failures
|
|
53
|
+
* are answered as `serveDirectReport` answers them.
|
|
54
|
+
*/
|
|
55
|
+
export declare const deviceDirectReportMessageRefusal: (errorArg: unknown) => unknown;
|
|
56
|
+
/**
|
|
57
|
+
* A device's refusal of its message to a direct report whose fleet job failed. A job that may have delivered the
|
|
58
|
+
* message (`IFleetWorkerJob.errorOutcome` other than `refused`: the steer failed after its dispatch, or nothing proves
|
|
59
|
+
* it did not) is `outcome_unknown`, which a client never sends again on its own, never `direct_report_failed`, which
|
|
60
|
+
* says the report took no message. A job that sent nothing is `direct_report_failed`: a refusal the fleet wrote itself
|
|
61
|
+
* (`errorCode`) with its text, any other with the controller's generic sentence. Where the device does not read the
|
|
62
|
+
* job's error, the failure journal keeps it under the reference the message ends with, as the Driver view shows it.
|
|
63
|
+
*/
|
|
64
|
+
export declare const deviceDirectReportJobRefusal: (jobArg: IFleetWorkerJob) => plugins.typedrequest.TypedResponseError;
|
|
65
|
+
/**
|
|
66
|
+
* A refusal of a device's ticket request in the device contract, whether the store's own (`TicketError`) or as the
|
|
67
|
+
* browser's ticket functions answer it: the store's codes `deviceTicketRefusalCodes` lists as they are, with the
|
|
68
|
+
* store's reason, and its other codes by `deviceTicketStoreRefusals`. Every other failure is answered as any device
|
|
69
|
+
* request's.
|
|
70
|
+
*/
|
|
71
|
+
export declare const deviceTicketRefusal: (errorArg: unknown) => unknown;
|
|
72
|
+
/** What a device event reads of the driver as it is sent: the controller's `DriverService`. */
|
|
73
|
+
export type TDeviceDriverSource = Pick<DriverService, 'isSessionChange' | 'current' | 'needsInput'>;
|
|
74
|
+
/**
|
|
75
|
+
* The driver's status as a device sees it: no project, no session, no failure or limit text. The `needs input:` line
|
|
76
|
+
* only while it is what the status's `needs_input` stands for.
|
|
77
|
+
*/
|
|
78
|
+
export declare const deviceDriverStatus: (statusArg: IControllerDriverStatus, needsInputArg: IDriverNeedsInput | undefined) => IDeviceDriverStatus;
|
|
79
|
+
/**
|
|
80
|
+
* A direct report as a device sees it, with the fleet workers that report to it: named, never by the report's stored
|
|
81
|
+
* id (which holds the configuration authority's id); the workers without their directories or profiles.
|
|
82
|
+
*/
|
|
83
|
+
export declare const deviceDirectReport: (viewArg: IDirectReportView, workersArg: readonly IControllerFleetWorkerView[]) => IDeviceDirectReport;
|
|
84
|
+
/**
|
|
85
|
+
* The AGL that runs, as a device sees it: its release, its start, its public origin, and how a device reaches it --
|
|
86
|
+
* through the gateway AGL keeps its route on, with where that route's sync stands (never the gateway's address, the
|
|
87
|
+
* client AGL is there or the route's target), or through the owner's own reverse proxy while AGL is enrolled with no
|
|
88
|
+
* gateway.
|
|
89
|
+
*/
|
|
90
|
+
export declare const deviceHostAgl: (aglArg: {
|
|
91
|
+
version: string;
|
|
92
|
+
startedAt: number;
|
|
93
|
+
origin: string;
|
|
94
|
+
gateway: IControllerGatewayStatus | undefined;
|
|
95
|
+
}) => IDeviceHostAgl;
|
|
96
|
+
/** A device's own record as it reads it: no id, key or fingerprint, and nothing it could change. */
|
|
97
|
+
export declare const deviceHostDevice: (deviceArg: IControllerDevice) => IDeviceHostDevice;
|
|
98
|
+
/** What `device.host.get` reads besides the AGL and the device, each section from its owner. */
|
|
99
|
+
export interface IDeviceHostSources {
|
|
100
|
+
/** The deploy monitor's status of every target, as the Deployments view reads it; never a probe. */
|
|
101
|
+
deployStatus: () => Promise<IFleetDeployStatus>;
|
|
102
|
+
/** The inference proxy's pools; absent while no proxy runs here. */
|
|
103
|
+
capacity: ((signalArg: AbortSignal) => Promise<IProxyCapacityAnswer>) | undefined;
|
|
104
|
+
/** The accounts service as the controller holds it. */
|
|
105
|
+
authority: () => IControllerAuthorityProjection;
|
|
106
|
+
/** The usage the accounts service holds for one login; it reads no provider for it. */
|
|
107
|
+
usage: (accountIdArg: string, loginIdArg: string, signalArg: AbortSignal) => Promise<TControllerAccountsAnswer<TControllerAccountUsage>>;
|
|
108
|
+
}
|
|
109
|
+
/** The host's deploy targets, account pools and API keys, read at once and each on its own. */
|
|
110
|
+
export declare const readDeviceHostSections: (sourcesArg: IDeviceHostSources, nowArg: number, signalArg: AbortSignal) => Promise<Pick<IReq_DeviceHostGet['response'], 'deploys' | 'pools' | 'apiKeys'>>;
|
|
5
111
|
/** A feed row as a device sees it; none for a terminal row, which a device does not open. */
|
|
6
112
|
export declare const deviceSessionRow: (rowArg: IControllerSessionFeedRow) => IDeviceSessionRow | undefined;
|
|
7
113
|
export declare const deviceSessionRows: (rowsArg: readonly IControllerSessionFeedRow[]) => IDeviceSessionRow[];
|
|
@@ -12,19 +118,107 @@ export declare const deviceMessages: (bundlesArg: readonly IControllerMessageBun
|
|
|
12
118
|
export declare const devicePermissions: (permissionsArg: readonly IControllerPermission[]) => IDevicePermission[];
|
|
13
119
|
export declare const deviceQuestions: (questionsArg: readonly IControllerQuestion[]) => IDeviceQuestion[];
|
|
14
120
|
export declare const deviceElicitations: (elicitationsArg: readonly TControllerElicitation[]) => TDeviceElicitation[];
|
|
15
|
-
/** A
|
|
16
|
-
export declare const
|
|
121
|
+
/** A ticket question as a device answers it: its options by id, and who asked and answered by name. */
|
|
122
|
+
export declare const deviceTicketQuestion: (questionArg: ITicketQuestion) => IDeviceTicketQuestion;
|
|
123
|
+
/**
|
|
124
|
+
* What a device's ticket views read besides the tickets: the owner's principal id (`owner:<webauthnUserId>`), which
|
|
125
|
+
* names the owner's account and never reaches a device, and the session feed's published rows.
|
|
126
|
+
*/
|
|
127
|
+
export interface IDeviceTicketViewer {
|
|
128
|
+
ownerId: string;
|
|
129
|
+
rowOf: (rowIdArg: string) => IControllerSessionFeedRow | undefined;
|
|
130
|
+
}
|
|
131
|
+
/**
|
|
132
|
+
* A person on a ticket as a device sees it: by name and kind, the owner as `kind` `owner` (never the owner's principal
|
|
133
|
+
* id), and a session only as the session feed names it while the feed lists it for devices, so never the driver's own
|
|
134
|
+
* session or one the feed does not list. A person's id never reaches a device.
|
|
135
|
+
*/
|
|
136
|
+
export declare const deviceTicketPerson: (personArg: ITicketPerson, viewerArg: IDeviceTicketViewer) => IDeviceTicketPerson;
|
|
137
|
+
/** A ticket as a device's card shows it; `parentArg` is the ticket its `parentId` names, when read. */
|
|
138
|
+
export declare const deviceTicketCard: (ticketArg: ITicket, parentArg: ITicket | undefined, viewerArg: IDeviceTicketViewer) => IDeviceTicketCard;
|
|
139
|
+
/**
|
|
140
|
+
* A ticket as a device's detail shows it: its card, description, source words, evidence and parent; never its source
|
|
141
|
+
* attachments, its plans' questions, who created or last changed it, or its permissions.
|
|
142
|
+
*/
|
|
143
|
+
export declare const deviceTicket: (ticketArg: ITicket, parentArg: ITicket | undefined, viewerArg: IDeviceTicketViewer) => IDeviceTicket;
|
|
144
|
+
export declare const deviceTicketComment: (commentArg: ITicketComment, viewerArg: IDeviceTicketViewer) => IDeviceTicketComment;
|
|
145
|
+
/**
|
|
146
|
+
* One column of the board as `device.board.list` answers it, from one read of the whole board (`board`): the tasks the
|
|
147
|
+
* store's own filters (`ticketFilter`: text and project) and the board's narrowing (`ticketBoardNarrows`: epic,
|
|
148
|
+
* assignee, AutoLabel) let through, as the browser's board shows its cards, counted per column, and the page of the
|
|
149
|
+
* requested column in the column's order; the projects and the epics a filter may choose, as the browser's board
|
|
150
|
+
* offers them (the epics in the chosen project, their own or one of their tasks', and the chosen epic).
|
|
151
|
+
*/
|
|
152
|
+
export declare const deviceBoardPage: (boardArg: ITicketBoard, requestArg: IReq_DeviceBoardList['request'], viewerArg: IDeviceTicketViewer) => IReq_DeviceBoardList['response'];
|
|
153
|
+
/**
|
|
154
|
+
* One page of a ticket's discussion, its comments and questions together in the order they were written: those
|
|
155
|
+
* before the entry `before` names (`c:<comment id>` or `q:<question id>`, as a page returned it), or the newest, at
|
|
156
|
+
* most `limit` and `deviceTicketDiscussionPage.bytes` of them as JSON but at least one, each list oldest first, and the
|
|
157
|
+
* cursor of the next older page, `null` at the first entry. A `before` that names no entry is refused.
|
|
158
|
+
*/
|
|
159
|
+
export declare const deviceTicketDiscussion: (commentsArg: readonly ITicketComment[], questionsArg: readonly ITicketQuestion[], pageArg: {
|
|
160
|
+
before?: string;
|
|
161
|
+
limit?: number;
|
|
162
|
+
}, viewerArg: IDeviceTicketViewer) => Pick<IReq_DeviceTicketGet['response'], 'comments' | 'questions' | 'before'>;
|
|
163
|
+
/** Where a ticket's work runs as a device sees it: the deploy monitor's placement, the targets by id and name. */
|
|
164
|
+
export declare const deviceTicketPlacement: (placementArg: IFleetDeployTicketPlacement) => IDeviceTicketPlacement;
|
|
165
|
+
/**
|
|
166
|
+
* What a ticket plans, from the ticket itself: its release plan, its maintenance window and its deploy plan; while the
|
|
167
|
+
* deploy monitor answered (`placementArg`), where the window stands and the owner's go on it and on the deploy. Never a
|
|
168
|
+
* plan's question or who deploys it.
|
|
169
|
+
*/
|
|
170
|
+
export declare const deviceTicketPlans: (ticketArg: ITicket, placementArg: IFleetDeployTicketPlacement | undefined) => IDeviceTicketPlans;
|
|
171
|
+
/** A ticket's placement for `device.ticket.get`, read on its own as a section of `device.host.get` is. */
|
|
172
|
+
export declare const readDeviceTicketPlacement: (readArg: () => Promise<IFleetDeployTicketPlacement>, signalArg: AbortSignal) => Promise<{
|
|
173
|
+
placement: IDeviceTicketPlacement | IDeviceHostUnavailable;
|
|
174
|
+
observed: IFleetDeployTicketPlacement | undefined;
|
|
175
|
+
}>;
|
|
176
|
+
/** An Inbox item as a device sees it: the same item without host paths, in the device protocol's shapes. */
|
|
177
|
+
export declare const deviceInboxItem: (itemArg: TControllerInboxItem, rowOfArg: (rowIdArg: string) => IControllerSessionFeedRow | undefined) => TDeviceInboxItem;
|
|
178
|
+
/** The Inbox as `device.inbox.list` answers it. */
|
|
179
|
+
export declare const deviceInboxList: (snapshotArg: IControllerInboxSnapshot, rowOfArg: (rowIdArg: string) => IControllerSessionFeedRow | undefined) => IReq_DeviceInboxList['response'];
|
|
180
|
+
/** An Inbox change as a device applies it: the same epoch, revision and order. */
|
|
181
|
+
export declare const deviceInboxDelta: (deltaArg: TControllerInboxDelta, rowOfArg: (rowIdArg: string) => IControllerSessionFeedRow | undefined) => IDeviceInboxDelta;
|
|
182
|
+
/**
|
|
183
|
+
* A controller event as a device receives it: none, one, or several in the order they are sent (a ticket change is
|
|
184
|
+
* the board's, the direct reports' and the host's). `rowOfArg` answers the feed's published rows; `driverArg` the driver as it
|
|
185
|
+
* is now, whose own session changes reach a device as `driver.changed` (never its streamed content).
|
|
186
|
+
*/
|
|
187
|
+
export declare const deviceEvent: (eventArg: IControllerEvent, rowOfArg: (rowIdArg: string) => IControllerSessionFeedRow | undefined, driverArg: TDeviceDriverSource | undefined) => readonly TDeviceEvent[];
|
|
17
188
|
export declare const assertDevicePairRequest: (valueArg: unknown) => IReq_DevicePair['request'];
|
|
18
189
|
export declare const assertDeviceAuthChallengeRequest: (valueArg: unknown) => IReq_DeviceAuthChallenge['request'];
|
|
19
190
|
export declare const assertDeviceAuthProveRequest: (valueArg: unknown) => IReq_DeviceAuthProve['request'];
|
|
20
191
|
export declare const assertDeviceSessionReadRequest: (valueArg: unknown) => IReq_DeviceSessionRead['request'];
|
|
21
192
|
export declare const assertDeviceSessionSendRequest: (valueArg: unknown) => IReq_DeviceSessionSend['request'];
|
|
193
|
+
export declare const assertDeviceDriverReadRequest: (valueArg: unknown) => IReq_DeviceDriverRead['request'];
|
|
194
|
+
export declare const assertDeviceDriverSendRequest: (valueArg: unknown) => IReq_DeviceDriverSend['request'];
|
|
195
|
+
/** A device's message to a direct report, in shape; the Driver view's own rules check the name and the text. */
|
|
196
|
+
export declare const assertDeviceDirectReportMessageRequest: (valueArg: unknown) => IReq_DeviceDirectReportMessage['request'];
|
|
22
197
|
export declare const assertDevicePermissionReplyRequest: (valueArg: unknown) => IReq_DevicePermissionReply['request'];
|
|
23
198
|
export declare const assertDeviceQuestionReplyRequest: (valueArg: unknown) => IReq_DeviceQuestionReply['request'];
|
|
24
199
|
export declare const assertDeviceElicitationReplyRequest: (valueArg: unknown) => IReq_DeviceElicitationReply['request'];
|
|
200
|
+
/**
|
|
201
|
+
* A ticket answer of a device, in shape: the ticket by key, the question, option ids and text. The ticket store's own
|
|
202
|
+
* rules (`assertTicketRequest`) check the values as for the browser.
|
|
203
|
+
*/
|
|
204
|
+
export declare const assertDeviceTicketAnswerRequest: (valueArg: unknown) => IReq_DeviceTicketAnswer['request'];
|
|
205
|
+
/**
|
|
206
|
+
* A page of the board a device asks for: a column, the board's filters (text 1 to 200 characters, a project, an epic, an
|
|
207
|
+
* assignee, an AutoLabel) and `limit` (1 to 100) tickets from `offset`. The store's own rules check the text and the
|
|
208
|
+
* project as for every listing (`assertTicketRequest('board')`).
|
|
209
|
+
*/
|
|
210
|
+
export declare const assertDeviceBoardListRequest: (valueArg: unknown) => IReq_DeviceBoardList['request'];
|
|
211
|
+
/** A ticket a device opens, and the page of its discussion: the `before` of a newer page, and 1 to 50 entries. */
|
|
212
|
+
export declare const assertDeviceTicketGetRequest: (valueArg: unknown) => IReq_DeviceTicketGet['request'];
|
|
213
|
+
/** A device's comment: 1 to 64 KiB of UTF-8, not blank. The store's own rules check it as the browser's. */
|
|
214
|
+
export declare const assertDeviceTicketCommentRequest: (valueArg: unknown) => IReq_DeviceTicketComment['request'];
|
|
215
|
+
/** A device's question: text alone, 1 to 16 KiB of UTF-8, not blank. The store's own rules check it as the browser's. */
|
|
216
|
+
export declare const assertDeviceTicketAskRequest: (valueArg: unknown) => IReq_DeviceTicketAsk['request'];
|
|
217
|
+
export declare const assertDeviceTicketMoveRequest: (valueArg: unknown) => IReq_DeviceTicketMove['request'];
|
|
25
218
|
export declare const assertDevicePairingCancelRequest: (valueArg: unknown) => {
|
|
26
219
|
pairingId: string;
|
|
27
220
|
};
|
|
28
221
|
export declare const assertDeviceRevokeRequest: (valueArg: unknown) => {
|
|
29
222
|
deviceId: string;
|
|
30
223
|
};
|
|
224
|
+
export {};
|