@ever-works/hermes-agent-plugin 1.0.13 → 1.0.15

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.
Files changed (3) hide show
  1. package/dist/index.cjs +995 -26
  2. package/dist/index.js +995 -26
  3. package/package.json +6 -6
package/dist/index.cjs CHANGED
@@ -497,6 +497,13 @@ var TASK_BOARD_STATUS_COLUMNS = TASK_BOARD_STATUSES.map((status) => ({
497
497
  terminal: TASK_BOARD_TERMINAL_STATUSES.includes(status),
498
498
  toggleOnly: false
499
499
  }));
500
+ var TASK_RESERVED_LABELS = Object.freeze([
501
+ "awaiting-owner",
502
+ "app-provision",
503
+ "release:promotion",
504
+ "release:revert"
505
+ ]);
506
+ var TASK_RESERVED_LABEL_PREFIXES = Object.freeze(["release:", "provision-attempt-", "fleet:"]);
500
507
  var PLATFORM_DEFAULT_MERGE_POLICY = Object.freeze({
501
508
  allowAgentMerge: false,
502
509
  requireGreenGate: true,
@@ -1127,26 +1134,10 @@ var FLEET_AGENT_CREDENTIAL_FAMILIES = [
1127
1134
  var FLEET_AGENT_CREDENTIAL_ENV_NAMES = FLEET_AGENT_CREDENTIAL_FAMILIES.flatMap(
1128
1135
  (family) => family.envNames
1129
1136
  );
1130
- var FLEET_RUN_ENV_FILE_MAX_CONTENT_BYTES = 32 * 1024;
1131
- var FLEET_RUN_ENV_FILES_MAX_TOTAL_BYTES = 256 * 1024;
1132
- var FLEET_JOB_MAX_PAYLOAD_BYTES = 256 * 1024;
1133
- var FLEET_JOB_MAX_RESULT_BYTES = 256 * 1024;
1134
- var FLEET_JOB_DEFAULT_QUEUED_MAX_AGE_SEC = Object.freeze({
1135
- "agent-task": 24 * 60 * 60,
1136
- "acceptance-checks": 2 * 60 * 60,
1137
- "browser-check": 2 * 60 * 60,
1138
- // A live view nobody claimed is abandoned by the session service after
1139
- // 40 seconds, which cancels its job there and then. The queue SLA is only
1140
- // the backstop behind that, so it deliberately does not undercut the
1141
- // shortest existing default (the fallback an unknown kind fails closed to).
1142
- "computer-session": 2 * 60 * 60
1143
- });
1144
- var FLEET_JOB_MAX_QUEUED_MAX_AGE_SEC = 7 * 24 * 60 * 60;
1145
- var FLEET_AGENT_EXECUTION_MAX_INSTRUCTIONS_BYTES = 160 * 1024;
1146
- var FLEET_AGENT_TASK_TIMELINE_MAX_BYTES = 48 * 1024;
1147
- var FLEET_AGENT_TASK_TRANSCRIPT_MAX_BYTES = 64 * 1024;
1148
- var FLEET_AGENT_TASK_QUESTION_MAX_FILE_BYTES = 64 * 1024;
1149
- var FLEET_AGENT_TASK_QUESTION_MAX_CONTEXT_BYTES = 6 * 1024;
1137
+ var FLEET_CHECKOUT_LISTED_REFRESH_MS = 5 * 6e4;
1138
+ var FLEET_CHECKOUT_RECONCILE_MS = 10 * 6e4;
1139
+ var FLEET_CHECKOUT_CREATING_STALE_MS = 10 * 6e4;
1140
+ var FLEET_CHECKOUT_BIN_PURGE_AFTER_MS = 30 * 24 * 60 * 6e4;
1150
1141
  var FLEET_LINK_MAX_FRAME_BYTES = 16 * 1024 * 1024;
1151
1142
  var FLEET_LINK_FRAME_HEADER_BYTES = 9;
1152
1143
  var FLEET_LINK_MAX_PAYLOAD_BYTES = FLEET_LINK_MAX_FRAME_BYTES - FLEET_LINK_FRAME_HEADER_BYTES;
@@ -1202,12 +1193,117 @@ var FLEET_LINK_CONTROL_TYPES = [
1202
1193
  "operation.done",
1203
1194
  "operation.cancel"
1204
1195
  ];
1196
+ var FLEET_FILES_LIMITS = {
1197
+ /** Largest `DATA` frame of a files stream. */
1198
+ chunkBytes: 64 * 1024,
1199
+ /** Unacknowledged bytes a sender may have in flight (the link's credit window). */
1200
+ windowBytes: 8 * 1024 * 1024,
1201
+ /** Bytes one operation may move. */
1202
+ maxOpBytes: 2 * 1024 * 1024 * 1024,
1203
+ /** Entries one operation may carry, and one listing may show. */
1204
+ maxEntries: 5e3,
1205
+ /** Transfers running at once on one computer. */
1206
+ maxConcurrentPerNode: 2,
1207
+ /** Transfers one person runs at once. */
1208
+ maxConcurrentPerUser: 4
1209
+ };
1210
+ var FLEET_FILES_MAX_BYTES_RECORD = FLEET_FILES_LIMITS.chunkBytes - 5;
1211
+ var FLEET_FILES_TRANSFER_RETENTION_MS = 10 * 6e4;
1212
+ var FLEET_FILES_LIST_AUDIT_WINDOW_MS = 15 * 6e4;
1213
+ var FLEET_CREDENTIAL_FILE_PATTERNS = [
1214
+ ".env",
1215
+ ".env.*",
1216
+ "*.pem",
1217
+ "*.key",
1218
+ "*.p12",
1219
+ "*.pfx",
1220
+ "*.jks",
1221
+ "*.keystore",
1222
+ "*.kdbx",
1223
+ "id_rsa*",
1224
+ "id_dsa*",
1225
+ "id_ecdsa*",
1226
+ "id_ed25519*",
1227
+ "*.ppk",
1228
+ ".netrc",
1229
+ ".npmrc",
1230
+ ".pypirc",
1231
+ "credentials",
1232
+ "credentials.json",
1233
+ "service-account*.json",
1234
+ ".aws/credentials",
1235
+ "*.gpg",
1236
+ "*.asc",
1237
+ ".docker/config.json",
1238
+ "kubeconfig",
1239
+ ".kube/config"
1240
+ ];
1241
+ function globToRegExp(glob) {
1242
+ const escaped = glob.replace(/[.+?^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*");
1243
+ return new RegExp(`^${escaped}$`, "i");
1244
+ }
1245
+ var CREDENTIAL_NAME_MATCHERS = FLEET_CREDENTIAL_FILE_PATTERNS.filter((pattern) => !pattern.includes("/")).map(
1246
+ globToRegExp
1247
+ );
1248
+ var CREDENTIAL_PATH_MATCHERS = FLEET_CREDENTIAL_FILE_PATTERNS.filter((pattern) => pattern.includes("/")).map(
1249
+ (pattern) => ({ segments: pattern.split("/").length, matcher: globToRegExp(pattern) })
1250
+ );
1251
+ var MAX_HEADER_JSON_BYTES = 16 * 1024;
1252
+ var FLEET_RUN_ENV_FILE_MAX_CONTENT_BYTES = 32 * 1024;
1253
+ var FLEET_RUN_ENV_FILES_MAX_TOTAL_BYTES = 256 * 1024;
1254
+ var FLEET_JOB_MAX_PAYLOAD_BYTES = 256 * 1024;
1255
+ var FLEET_JOB_MAX_RESULT_BYTES = 256 * 1024;
1256
+ var FLEET_JOB_DEFAULT_QUEUED_MAX_AGE_SEC = Object.freeze({
1257
+ "agent-task": 24 * 60 * 60,
1258
+ "acceptance-checks": 2 * 60 * 60,
1259
+ "browser-check": 2 * 60 * 60,
1260
+ // A live view nobody claimed is abandoned by the session service after
1261
+ // 40 seconds, which cancels its job there and then. The queue SLA is only
1262
+ // the backstop behind that, so it deliberately does not undercut the
1263
+ // shortest existing default (the fallback an unknown kind fails closed to).
1264
+ "computer-session": 2 * 60 * 60,
1265
+ // An Agent session (FL-04 P2). Like the live view it does not undercut the
1266
+ // shortest existing default (the fallback an unknown kind fails closed to):
1267
+ // the session sweeper ends one still waiting after ten minutes, and this
1268
+ // queue SLA is only the backstop behind it.
1269
+ "agent-session": 2 * 60 * 60,
1270
+ // Virtual computers (FL-16). The plan proposed an hour for a create and ten
1271
+ // minutes for a control; like the live view and the Agent session they do
1272
+ // NOT undercut the shortest existing default (the fallback an unknown kind
1273
+ // fails closed to), so an older reader's "unknown kind" answer is unchanged.
1274
+ // A control the owner no longer wants is cancelled with its child's row.
1275
+ "vm-create": 2 * 60 * 60,
1276
+ "vm-control": 2 * 60 * 60,
1277
+ // Usage scan (FL-20). The plan proposed 15 minutes (one scan interval); like
1278
+ // the kinds above it does NOT undercut the shortest existing default (the
1279
+ // fallback an unknown kind fails closed to). A scan nobody leased is simply
1280
+ // superseded: the dispatcher never enqueues a second while one is queued.
1281
+ "usage-scan": 2 * 60 * 60,
1282
+ // Actions runners on computers (FL-18). The plan proposed an hour for an
1283
+ // install and ten minutes for a control; like FL-16's kinds they do NOT
1284
+ // undercut the shortest existing default (the fallback an unknown kind fails
1285
+ // closed to), so an older reader's answer for an unknown kind is unchanged.
1286
+ "runner-install": 2 * 60 * 60,
1287
+ "runner-control": 2 * 60 * 60
1288
+ });
1289
+ var FLEET_JOB_MAX_QUEUED_MAX_AGE_SEC = 7 * 24 * 60 * 60;
1290
+ var FLEET_AGENT_EXECUTION_MAX_INSTRUCTIONS_BYTES = 160 * 1024;
1291
+ var FLEET_AGENT_TASK_TIMELINE_MAX_BYTES = 48 * 1024;
1292
+ var FLEET_AGENT_TASK_TRANSCRIPT_MAX_BYTES = 64 * 1024;
1293
+ var FLEET_AGENT_TASK_QUESTION_MAX_FILE_BYTES = 64 * 1024;
1294
+ var FLEET_AGENT_TASK_QUESTION_MAX_CONTEXT_BYTES = 6 * 1024;
1205
1295
  var CONTROL_TYPES = new Set(FLEET_LINK_CONTROL_TYPES);
1206
1296
  var KIND_JSON = FLEET_LINK_FRAME_KINDS.JSON;
1207
1297
  var utf8Encoder = new TextEncoder();
1208
1298
  var FLEET_LINK_VIEWER_SLOW_BUFFER_BYTES = 8 * 1024 * 1024;
1209
1299
  var FLEET_LINK_VIEWER_MAX_BUFFER_BYTES = 32 * 1024 * 1024;
1210
1300
  var FLEET_LINK_VIEWER_FRAME_KINDS = [FLEET_LINK_FRAME_KINDS.ACK];
1301
+ var FLEET_MACHINE_OPERATION_MAX_MS = 60 * 6e4;
1302
+ var FLEET_LOGS_FOLLOW_BYTES_PER_SEC = 1024 * 1024;
1303
+ var FLEET_LOGS_PENDING_MAX_BYTES = 1024 * 1024;
1304
+ var FLEET_LOGS_MAX_FRAME_BYTES = 64 * 1024;
1305
+ var FLEET_LOGS_MAX_LINE_CHARS = 16 * 1024;
1306
+ var FLEET_LOGS_FILE_SCAN_MAX_BYTES = 8 * 1024 * 1024;
1211
1307
  var FLEET_MODEL_USAGE_LIMIT_FALLBACK_MS = 60 * 60 * 1e3;
1212
1308
  var FLEET_MODEL_USAGE_LIMIT_MIN_MS = 60 * 1e3;
1213
1309
  var FLEET_MODEL_USAGE_LIMIT_MAX_MS = 8 * 24 * 60 * 60 * 1e3;
@@ -1226,6 +1322,51 @@ var FLEET_HEALTH_DISK_CRITICAL_MARGIN_BYTES = 1024 ** 3;
1226
1322
  var FLEET_HEALTH_MAX_MIB = 2 ** 40;
1227
1323
  var FLEET_HEALTH_MAX_UPTIME_SEC = 100 * 365 * 24 * 60 * 60;
1228
1324
  var FLEET_HEALTH_BYTES_PER_MIB = 1024 * 1024;
1325
+ var MINUTE_MS = 6e4;
1326
+ var HOUR_MS = 60 * MINUTE_MS;
1327
+ var DAY_MS2 = 24 * HOUR_MS;
1328
+ var FLEET_HEALTH_RANGE_MS = {
1329
+ "1h": HOUR_MS,
1330
+ "24h": DAY_MS2,
1331
+ "7d": 7 * DAY_MS2,
1332
+ "90d": 90 * DAY_MS2
1333
+ };
1334
+ var FLEET_WAKE_RATE_WINDOW_MS = 5 * 6e4;
1335
+ var FLEET_PORT_PROBE_BODY_CAP = 64 * 1024;
1336
+ var FLEET_PORT_PREVIEW_MAX_MS = 60 * 6e4;
1337
+ var FLEET_PORT_TUNNEL_IDLE_MS = 10 * 6e4;
1338
+ var FLEET_PORT_TUNNEL_HARD_MS = 60 * 6e4;
1339
+ var FLEET_PORT_TUNNEL_CHUNK_BYTES = 64 * 1024;
1340
+ var FLEET_PORT_TUNNEL_MAX_HEADER_BYTES = 64 * 1024;
1341
+ var FLEET_WELL_KNOWN_PORTS = Object.freeze({
1342
+ 21: "ftp",
1343
+ 22: "ssh",
1344
+ 25: "smtp",
1345
+ 53: "dns",
1346
+ 110: "pop3",
1347
+ 143: "imap",
1348
+ 389: "ldap",
1349
+ 1433: "mssql",
1350
+ 1521: "oracle",
1351
+ 2375: "docker",
1352
+ 2376: "docker",
1353
+ 2379: "etcd",
1354
+ 3306: "mysql",
1355
+ 3389: "rdp",
1356
+ 4222: "nats",
1357
+ 5432: "postgres",
1358
+ 5672: "amqp",
1359
+ 5900: "vnc",
1360
+ 6379: "redis",
1361
+ 6443: "kubernetes",
1362
+ 7687: "neo4j",
1363
+ 9042: "cassandra",
1364
+ 9092: "kafka",
1365
+ 9200: "elasticsearch",
1366
+ 11211: "memcached",
1367
+ 15672: "rabbitmq",
1368
+ 27017: "mongo"
1369
+ });
1229
1370
  var FLEET_RUN_TOKEN_ROUTES = Object.freeze([
1230
1371
  // Works — reads, plus the settings update (its merge / check / command
1231
1372
  // fields are refused for run tokens by the Works controller).
@@ -1309,6 +1450,12 @@ var FLEET_RUN_TOKEN_ROUTES = Object.freeze([
1309
1450
  { method: "GET", pathPattern: "/api/fleet/runner-status" },
1310
1451
  { method: "GET", pathPattern: "/api/fleet/execution-preferences" },
1311
1452
  { method: "GET", pathPattern: "/api/fleet/agents/{agentId}/node-affinity" },
1453
+ // Session git & actions (FL-06 FR-18): an Agent session asks the platform to
1454
+ // open or update the pull request of ITS OWN checkout. The route refuses a
1455
+ // checkout that is not the token's session's, and the Agent's "may open pull
1456
+ // requests" permission applies; it never merges anything.
1457
+ { method: "GET", pathPattern: "/api/fleet/checkouts/{id}/pull-request" },
1458
+ { method: "POST", pathPattern: "/api/fleet/checkouts/{id}/pull-request" },
1312
1459
  // Agents — reads, plus cancel and pause (the safe direction).
1313
1460
  { method: "GET", pathPattern: "/api/agents" },
1314
1461
  { method: "GET", pathPattern: "/api/agents/{id}" },
@@ -1331,6 +1478,809 @@ var FLEET_RUN_TOKEN_ROUTE_SHAPES = FLEET_RUN_TOKEN_ROUTES.map((route) => ({
1331
1478
  method: route.method.toUpperCase(),
1332
1479
  shape: splitSegments(route.pathPattern).map((part) => /^\{[^}]+\}$/.test(part) ? "*" : part.toLowerCase())
1333
1480
  }));
1481
+ var FLEET_SESSION_STATES = ["starting", "working", "needs_you", "done", "idle", "ended"];
1482
+ var FLEET_SESSION_LIVE_STATES = FLEET_SESSION_STATES.filter(
1483
+ (state) => state !== "ended"
1484
+ );
1485
+ var FLEET_SESSION_SLOW_VIEWER_BYTES = 1024 * 1024;
1486
+ var FLEET_SESSION_DAEMON_IDLE_EXIT_MS = 5 * 6e4;
1487
+ var FLEET_SESSION_LAST_SCREEN_MAX_CHARS = 256 * 1024;
1488
+ var FLEET_AGENT_SESSION_QUEUED_TIMEOUT_MS = 10 * 6e4;
1489
+ var FLEET_PR_ENRICHMENT_RECENT_MS = 7 * 24 * 60 * 6e4;
1490
+ var FLEET_GIT_LINE_STALE_MS = 5 * 6e4;
1491
+ var FLEET_SESSION_IDLE_AFTER_MS = 30 * 6e4;
1492
+ var FLEET_SESSION_DECISION_STALE_MS = 24 * 60 * 6e4;
1493
+ var FLEET_SESSION_HOOK_BODY_MAX_BYTES = 64 * 1024;
1494
+ var FLEET_SESSION_HOOK_SPOOL_MAX_BYTES = 5 * 1024 * 1024;
1495
+ var FLEET_SESSION_HOOK_SPOOL_MAX_AGE_MS = 7 * 24 * 60 * 6e4;
1496
+ var FLEET_COMMAND_MAX_OUTPUT_BYTES = 10 * 1024 * 1024;
1497
+ var FLEET_COMMAND_STORED_EDGE_BYTES = 64 * 1024;
1498
+ var FLEET_COMMAND_DATA_CHUNK_BYTES = 64 * 1024;
1499
+ var FLEET_COMMAND_MAX_LENGTH = 8 * 1024;
1500
+ var FLEET_SCHEDULE_PROMPT_MAX_BYTES = 16 * 1024;
1501
+ var FLEET_SCHEDULE_BREAKER_UNDO_MS = 15 * 6e4;
1502
+ var MAX_SEARCH_DAYS = 366 * 8 + 1;
1503
+ function row(input) {
1504
+ const rest = input.name.slice("fleet_".length);
1505
+ const cut = rest.indexOf("_");
1506
+ const family = cut === -1 ? rest : rest.slice(0, cut);
1507
+ const verb = cut === -1 ? "" : rest.slice(cut + 1);
1508
+ return Object.freeze({ ...input, family, verb });
1509
+ }
1510
+ function read(name, permissionFamily, owner, flag, status, extra = {}) {
1511
+ return row({
1512
+ name,
1513
+ readOnly: true,
1514
+ category: "read.internal",
1515
+ permissionFamily,
1516
+ owner,
1517
+ phase: "P1",
1518
+ flag,
1519
+ status,
1520
+ ...extra
1521
+ });
1522
+ }
1523
+ function act(name, permissionFamily, owner, flag, status, annotation, extra = {}) {
1524
+ return row({ name, permissionFamily, owner, phase: "P2", flag, status, ...annotation, ...extra });
1525
+ }
1526
+ var plain = (category, destructive = false) => ({
1527
+ destructive,
1528
+ confirmationClass: "plain",
1529
+ category
1530
+ });
1531
+ var confirm = (category, destructive = true) => ({
1532
+ destructive,
1533
+ confirmationClass: "confirm",
1534
+ category
1535
+ });
1536
+ var typed = (category) => ({
1537
+ destructive: true,
1538
+ confirmationClass: "confirm-destructive",
1539
+ category
1540
+ });
1541
+ var GET = (path3) => ({ method: "GET", path: path3 });
1542
+ var POST = (path3) => ({ method: "POST", path: path3 });
1543
+ var PATCH = (path3) => ({ method: "PATCH", path: path3 });
1544
+ var DELETE = (path3) => ({ method: "DELETE", path: path3 });
1545
+ var FLEET_TOOL_CATALOGUE = Object.freeze([
1546
+ // ── status (FL-19) ──
1547
+ read("fleet_status", "view", "FL-19", "FLEET_ENABLED", "live", {
1548
+ route: GET("/api/fleet/status"),
1549
+ cli: "fleet status"
1550
+ }),
1551
+ // ── nodes (FL-19, FL-03, FL-15) ──
1552
+ read("fleet_nodes_list", "view", "FL-19", "FLEET_ENABLED", "live", {
1553
+ route: GET("/api/fleet/nodes"),
1554
+ cli: "fleet nodes list"
1555
+ }),
1556
+ read("fleet_nodes_get", "view", "FL-19", "FLEET_ENABLED", "live", {
1557
+ route: GET("/api/fleet/nodes/{id}"),
1558
+ cli: "fleet nodes get"
1559
+ }),
1560
+ read("fleet_nodes_health", "view", "FL-03", "FLEET_ENABLED", "live", {
1561
+ route: GET("/api/fleet/nodes/{id}/health"),
1562
+ cli: "fleet nodes health"
1563
+ }),
1564
+ read("fleet_nodes_needs_a_look", "view", "FL-03", "FLEET_ENABLED", "live", {
1565
+ route: GET("/api/fleet/nodes/{id}/needs-a-look"),
1566
+ cli: "fleet nodes needs-a-look"
1567
+ }),
1568
+ read("fleet_nodes_git_identity_get", "view", "FL-15", "FLEET_CHECKOUTS_ENABLED", "live", {
1569
+ route: GET("/api/fleet/nodes/{id}/git/identity"),
1570
+ cli: "fleet nodes git-identity"
1571
+ }),
1572
+ act("fleet_nodes_wake", "machines", "FL-03", "FLEET_ENABLED", "live", plain("machine.admin"), {
1573
+ route: POST("/api/fleet/nodes/{id}/wake"),
1574
+ cli: "fleet nodes wake"
1575
+ }),
1576
+ act(
1577
+ "fleet_nodes_git_identity_set",
1578
+ "commands",
1579
+ "FL-15",
1580
+ "FLEET_CHECKOUTS_ENABLED",
1581
+ "live",
1582
+ confirm("machine.admin", false),
1583
+ { route: POST("/api/fleet/nodes/{id}/git/identity"), cli: "fleet nodes git-identity --set" }
1584
+ ),
1585
+ // ── sessions (FL-04, FL-05, FL-06) ──
1586
+ read("fleet_sessions_list", "sessions", "FL-04", "FLEET_SESSIONS_ENABLED", "live", {
1587
+ route: GET("/api/fleet/sessions"),
1588
+ cli: "fleet sessions list"
1589
+ }),
1590
+ read("fleet_sessions_read", "sessions", "FL-04", "FLEET_SESSIONS_ENABLED", "live", {
1591
+ route: GET("/api/fleet/sessions/{id}"),
1592
+ cli: "fleet sessions read"
1593
+ }),
1594
+ read("fleet_sessions_question", "sessions", "FL-05", "FLEET_SESSIONS_ENABLED", "live", {
1595
+ route: GET("/api/fleet/sessions/{id}"),
1596
+ cli: "fleet sessions question"
1597
+ }),
1598
+ read("fleet_sessions_actions_list", "sessions", "FL-06", "FLEET_SESSIONS_ENABLED", "planned", {
1599
+ route: GET("/api/fleet/sessions/{id}/actions"),
1600
+ cli: "fleet sessions actions"
1601
+ }),
1602
+ act("fleet_sessions_start", "sessions", "FL-04", "FLEET_SESSIONS_ENABLED", "live", plain("machine.run"), {
1603
+ route: POST("/api/fleet/nodes/{id}/sessions"),
1604
+ cli: "fleet sessions start"
1605
+ }),
1606
+ act("fleet_sessions_send", "sessions", "FL-04", "FLEET_SESSIONS_ENABLED", "live", plain("machine.run")),
1607
+ act("fleet_sessions_answer", "sessions", "FL-05", "FLEET_SESSIONS_ENABLED", "live", confirm("machine.run", false), {
1608
+ route: POST("/api/fleet/sessions/{id}/answer"),
1609
+ cli: "fleet sessions answer",
1610
+ confirmationNote: "questions only; a permission prompt is answered by a person (CONTRACTS R-32)"
1611
+ }),
1612
+ act("fleet_sessions_rename", "sessions", "FL-04", "FLEET_SESSIONS_ENABLED", "live", plain("write.internal"), {
1613
+ route: PATCH("/api/fleet/sessions/{id}"),
1614
+ cli: "fleet sessions rename"
1615
+ }),
1616
+ act("fleet_sessions_end", "sessions", "FL-04", "FLEET_SESSIONS_ENABLED", "live", confirm("machine.run"), {
1617
+ route: POST("/api/fleet/sessions/{id}/end"),
1618
+ cli: "fleet sessions end"
1619
+ }),
1620
+ act("fleet_sessions_action", "sessions", "FL-06", "FLEET_SESSIONS_ENABLED", "planned", plain("machine.run"), {
1621
+ route: POST("/api/fleet/sessions/{id}/actions"),
1622
+ cli: "fleet sessions action"
1623
+ }),
1624
+ // ── desktop (FL-07, FL-11 paste) ──
1625
+ read("fleet_desktop_screenshot", "desktop", "FL-07", "FLEET_DESKTOP_ENABLED", "planned", {
1626
+ route: GET("/api/fleet/nodes/{id}/desktop/screenshot"),
1627
+ cli: "fleet desktop screenshot"
1628
+ }),
1629
+ read("fleet_desktop_displays", "desktop", "FL-07", "FLEET_DESKTOP_ENABLED", "planned", {
1630
+ route: GET("/api/fleet/nodes/{id}/desktop/displays"),
1631
+ cli: "fleet desktop displays"
1632
+ }),
1633
+ read("fleet_desktop_recordings_list", "desktop", "FL-07", "FLEET_DESKTOP_ENABLED", "planned", {
1634
+ route: GET("/api/fleet/nodes/{id}/desktop/recordings"),
1635
+ cli: "fleet desktop recordings"
1636
+ }),
1637
+ act("fleet_desktop_input", "desktop", "FL-07", "FLEET_DESKTOP_ENABLED", "planned", plain("machine.admin", true), {
1638
+ route: POST("/api/fleet/nodes/{id}/desktop/input"),
1639
+ cli: "fleet desktop input"
1640
+ }),
1641
+ act("fleet_desktop_set_display", "desktop", "FL-07", "FLEET_DESKTOP_ENABLED", "planned", plain("machine.admin"), {
1642
+ route: POST("/api/fleet/nodes/{id}/desktop/displays"),
1643
+ cli: "fleet desktop set-display"
1644
+ }),
1645
+ act("fleet_desktop_display_add", "desktop", "FL-07", "FLEET_DESKTOP_ENABLED", "planned", confirm("machine.admin"), {
1646
+ phase: "P3",
1647
+ route: POST("/api/fleet/nodes/{id}/desktop/displays/virtual"),
1648
+ cli: "fleet desktop display-add"
1649
+ }),
1650
+ act(
1651
+ "fleet_desktop_display_remove",
1652
+ "desktop",
1653
+ "FL-07",
1654
+ "FLEET_DESKTOP_ENABLED",
1655
+ "planned",
1656
+ confirm("machine.admin"),
1657
+ {
1658
+ phase: "P3",
1659
+ route: DELETE("/api/fleet/nodes/{id}/desktop/displays/virtual/{displayId}"),
1660
+ cli: "fleet desktop display-remove"
1661
+ }
1662
+ ),
1663
+ act(
1664
+ "fleet_desktop_paste",
1665
+ "desktop",
1666
+ "FL-11",
1667
+ "FLEET_MACHINE_FACTS_ENABLED",
1668
+ "planned",
1669
+ plain("machine.admin", true),
1670
+ {
1671
+ route: POST("/api/fleet/nodes/{id}/desktop/paste"),
1672
+ cli: "fleet desktop paste",
1673
+ confirmationNote: "denied unless a tool grant allows it (AW-15)"
1674
+ }
1675
+ ),
1676
+ // ── logs (FL-08) ──
1677
+ read("fleet_logs_sources", "logs", "FL-08", "FLEET_MACHINE_FACTS_ENABLED", "live", {
1678
+ route: GET("/api/fleet/nodes/{id}/logs/sources"),
1679
+ cli: "fleet logs sources"
1680
+ }),
1681
+ read("fleet_logs_read", "logs", "FL-08", "FLEET_MACHINE_FACTS_ENABLED", "live", {
1682
+ route: POST("/api/fleet/nodes/{id}/logs/read"),
1683
+ cli: "fleet logs read"
1684
+ }),
1685
+ // ── services (FL-09) ──
1686
+ read("fleet_services_list", "services", "FL-09", "FLEET_MACHINE_FACTS_ENABLED", "live", {
1687
+ route: GET("/api/fleet/nodes/{id}/services"),
1688
+ cli: "fleet services list"
1689
+ }),
1690
+ act("fleet_services_action", "services", "FL-09", "FLEET_MACHINE_FACTS_ENABLED", "live", confirm("machine.admin"), {
1691
+ route: POST("/api/fleet/nodes/{id}/services/{name}/{action}"),
1692
+ cli: "fleet services action",
1693
+ waitable: true,
1694
+ confirmationNote: "confirm; blast-radius when the node warns it could cut the machine off"
1695
+ }),
1696
+ // ── processes (FL-09) ──
1697
+ read("fleet_processes_list", "processes", "FL-09", "FLEET_MACHINE_FACTS_ENABLED", "live", {
1698
+ route: GET("/api/fleet/nodes/{id}/processes"),
1699
+ cli: "fleet processes list"
1700
+ }),
1701
+ act(
1702
+ "fleet_processes_signal",
1703
+ "processes",
1704
+ "FL-09",
1705
+ "FLEET_MACHINE_FACTS_ENABLED",
1706
+ "live",
1707
+ confirm("machine.admin"),
1708
+ { route: POST("/api/fleet/nodes/{id}/processes/{pid}/signal"), cli: "fleet processes signal" }
1709
+ ),
1710
+ // ── docker (FL-09) ──
1711
+ read("fleet_docker_containers_list", "docker", "FL-09", "FLEET_MACHINE_FACTS_ENABLED", "live", {
1712
+ route: GET("/api/fleet/nodes/{id}/docker/containers"),
1713
+ cli: "fleet docker containers"
1714
+ }),
1715
+ read("fleet_docker_images_list", "docker", "FL-09", "FLEET_MACHINE_FACTS_ENABLED", "live", {
1716
+ route: GET("/api/fleet/nodes/{id}/docker/images"),
1717
+ cli: "fleet docker images"
1718
+ }),
1719
+ read("fleet_docker_compose_list", "docker", "FL-09", "FLEET_MACHINE_FACTS_ENABLED", "live", {
1720
+ route: GET("/api/fleet/nodes/{id}/docker/compose"),
1721
+ cli: "fleet docker compose"
1722
+ }),
1723
+ read("fleet_docker_compose_describe", "docker", "FL-09", "FLEET_MACHINE_FACTS_ENABLED", "live", {
1724
+ cli: "fleet docker compose-describe"
1725
+ }),
1726
+ act(
1727
+ "fleet_docker_container_action",
1728
+ "docker",
1729
+ "FL-09",
1730
+ "FLEET_MACHINE_FACTS_ENABLED",
1731
+ "live",
1732
+ confirm("machine.admin"),
1733
+ {
1734
+ route: POST("/api/fleet/nodes/{id}/docker/containers/{cid}/{action}"),
1735
+ cli: "fleet docker container",
1736
+ waitable: true,
1737
+ confirmationNote: "confirm; remove is confirm-destructive"
1738
+ }
1739
+ ),
1740
+ act("fleet_docker_run", "docker", "FL-09", "FLEET_MACHINE_FACTS_ENABLED", "live", confirm("machine.admin", false), {
1741
+ route: POST("/api/fleet/nodes/{id}/docker/containers"),
1742
+ cli: "fleet docker run",
1743
+ waitable: true,
1744
+ alwaysHeld: true,
1745
+ confirmationNote: "an Agent proposes a run; a person types any secret values"
1746
+ }),
1747
+ act(
1748
+ "fleet_docker_image_action",
1749
+ "docker",
1750
+ "FL-09",
1751
+ "FLEET_MACHINE_FACTS_ENABLED",
1752
+ "live",
1753
+ confirm("machine.admin"),
1754
+ {
1755
+ route: POST("/api/fleet/nodes/{id}/docker/images/{iid}/{action}"),
1756
+ cli: "fleet docker image",
1757
+ waitable: true,
1758
+ confirmationNote: "pull is plain and not destructive; remove and prune confirm"
1759
+ }
1760
+ ),
1761
+ act(
1762
+ "fleet_docker_compose_action",
1763
+ "docker",
1764
+ "FL-09",
1765
+ "FLEET_MACHINE_FACTS_ENABLED",
1766
+ "live",
1767
+ confirm("machine.admin"),
1768
+ {
1769
+ route: POST("/api/fleet/nodes/{id}/docker/compose/{project}/{action}"),
1770
+ cli: "fleet docker compose-action",
1771
+ waitable: true,
1772
+ confirmationNote: "destructive for down"
1773
+ }
1774
+ ),
1775
+ act("fleet_docker_exec", "docker", "FL-09", "FLEET_MACHINE_FACTS_ENABLED", "planned", plain("machine.run"), {
1776
+ phase: "P3",
1777
+ cli: "fleet docker exec"
1778
+ }),
1779
+ // ── ports (FL-10) ──
1780
+ read("fleet_ports_list", "view", "FL-10", "FLEET_MACHINE_FACTS_ENABLED", "live", {
1781
+ route: GET("/api/fleet/nodes/{id}/ports"),
1782
+ cli: "fleet ports list"
1783
+ }),
1784
+ act("fleet_ports_open", "ports", "FL-10", "FLEET_MACHINE_FACTS_ENABLED", "live", plain("machine.run"), {
1785
+ route: POST("/api/fleet/nodes/{id}/ports/{port}/open"),
1786
+ cli: "fleet ports open"
1787
+ }),
1788
+ act("fleet_ports_preview_open", "ports", "FL-10", "FLEET_PORT_TUNNEL_ENABLED", "live", plain("machine.run"), {
1789
+ route: POST("/api/fleet/nodes/{id}/ports/{port}/preview"),
1790
+ cli: "fleet ports preview"
1791
+ }),
1792
+ act("fleet_ports_preview_close", "ports", "FL-10", "FLEET_PORT_TUNNEL_ENABLED", "live", plain("machine.run"), {
1793
+ route: DELETE("/api/fleet/nodes/{id}/ports/{port}/preview"),
1794
+ cli: "fleet ports preview-close"
1795
+ }),
1796
+ // ── files (FL-11) ──
1797
+ // P1 (FL-11 lane log decision 15): the roots read joins the family, and the list's route is the
1798
+ // one FL-11 built (`…/files/list` — `…/files` is the family's prefix, not a route).
1799
+ read("fleet_files_roots", "files", "FL-11", "FLEET_MACHINE_FACTS_ENABLED", "live", {
1800
+ route: GET("/api/fleet/nodes/{id}/files/roots"),
1801
+ cli: "fleet files roots"
1802
+ }),
1803
+ read("fleet_files_list", "files", "FL-11", "FLEET_MACHINE_FACTS_ENABLED", "live", {
1804
+ route: GET("/api/fleet/nodes/{id}/files/list"),
1805
+ cli: "fleet files list"
1806
+ }),
1807
+ read("fleet_files_stat", "files", "FL-11", "FLEET_MACHINE_FACTS_ENABLED", "live", {
1808
+ route: GET("/api/fleet/nodes/{id}/files/stat"),
1809
+ cli: "fleet files stat"
1810
+ }),
1811
+ read("fleet_files_read", "files", "FL-11", "FLEET_MACHINE_FACTS_ENABLED", "planned", {
1812
+ route: GET("/api/fleet/nodes/{id}/files/download"),
1813
+ cli: "fleet files get"
1814
+ }),
1815
+ act("fleet_files_write", "files", "FL-11", "FLEET_MACHINE_FACTS_ENABLED", "planned", confirm("machine.admin"), {
1816
+ route: POST("/api/fleet/nodes/{id}/files/upload"),
1817
+ cli: "fleet files put"
1818
+ }),
1819
+ act("fleet_files_copy", "files", "FL-11", "FLEET_MACHINE_FACTS_ENABLED", "live", confirm("machine.admin"), {
1820
+ route: POST("/api/fleet/nodes/{id}/files/copy"),
1821
+ cli: "fleet files cp",
1822
+ // FL-11 P2 (lane log decision 18): an Agent's copy is held for a person, like its delete.
1823
+ alwaysHeld: true
1824
+ }),
1825
+ act("fleet_files_delete", "files", "FL-11", "FLEET_MACHINE_FACTS_ENABLED", "live", typed("write.destructive"), {
1826
+ route: POST("/api/fleet/nodes/{id}/files/delete"),
1827
+ cli: "fleet files rm",
1828
+ alwaysHeld: true
1829
+ }),
1830
+ // ── commands (FL-12) ──
1831
+ read("fleet_commands_list", "commands", "FL-12", "FLEET_COMMANDS_ENABLED", "live", {
1832
+ route: GET("/api/fleet/commands"),
1833
+ cli: "fleet commands list"
1834
+ }),
1835
+ read("fleet_commands_get", "commands", "FL-12", "FLEET_COMMANDS_ENABLED", "live", {
1836
+ route: GET("/api/fleet/commands/{id}"),
1837
+ cli: "fleet commands get"
1838
+ }),
1839
+ act("fleet_commands_run", "commands", "FL-12", "FLEET_COMMANDS_ENABLED", "live", confirm("machine.run"), {
1840
+ route: POST("/api/fleet/commands"),
1841
+ cli: "fleet commands run",
1842
+ alwaysHeld: true
1843
+ }),
1844
+ act("fleet_commands_cancel", "commands", "FL-12", "FLEET_COMMANDS_ENABLED", "live", plain("machine.run"), {
1845
+ route: POST("/api/fleet/commands/{id}/cancel"),
1846
+ cli: "fleet commands cancel"
1847
+ }),
1848
+ // ── schedules (FL-13 P2: live — `apps/api/src/fleet/schedules/fleet-schedules.controller.ts`) ──
1849
+ read("fleet_schedules_list", "schedules", "FL-13", "FLEET_COMMANDS_ENABLED", "live", {
1850
+ route: GET("/api/fleet/schedules"),
1851
+ cli: "fleet schedules list"
1852
+ }),
1853
+ read("fleet_schedules_get", "schedules", "FL-13", "FLEET_COMMANDS_ENABLED", "live", {
1854
+ route: GET("/api/fleet/schedules/{id}"),
1855
+ cli: "fleet schedules get"
1856
+ }),
1857
+ read("fleet_schedules_runs", "schedules", "FL-13", "FLEET_COMMANDS_ENABLED", "live", {
1858
+ route: GET("/api/fleet/schedules/{id}/runs"),
1859
+ cli: "fleet schedules runs"
1860
+ }),
1861
+ act("fleet_schedules_create", "schedules", "FL-13", "FLEET_COMMANDS_ENABLED", "live", confirm("agent.fanout"), {
1862
+ route: POST("/api/fleet/schedules"),
1863
+ cli: "fleet schedules create"
1864
+ }),
1865
+ act("fleet_schedules_update", "schedules", "FL-13", "FLEET_COMMANDS_ENABLED", "live", confirm("agent.fanout"), {
1866
+ route: PATCH("/api/fleet/schedules/{id}"),
1867
+ cli: "fleet schedules update"
1868
+ }),
1869
+ act(
1870
+ "fleet_schedules_delete",
1871
+ "schedules",
1872
+ "FL-13",
1873
+ "FLEET_COMMANDS_ENABLED",
1874
+ "live",
1875
+ confirm("write.destructive"),
1876
+ { route: DELETE("/api/fleet/schedules/{id}"), cli: "fleet schedules delete" }
1877
+ ),
1878
+ act("fleet_schedules_run", "schedules", "FL-13", "FLEET_COMMANDS_ENABLED", "live", confirm("machine.run"), {
1879
+ route: POST("/api/fleet/schedules/{id}/run"),
1880
+ cli: "fleet schedules run"
1881
+ }),
1882
+ act("fleet_schedules_pause", "schedules", "FL-13", "FLEET_COMMANDS_ENABLED", "live", plain("agent.fanout"), {
1883
+ route: POST("/api/fleet/schedules/{id}/pause"),
1884
+ cli: "fleet schedules pause"
1885
+ }),
1886
+ act("fleet_schedules_resume", "schedules", "FL-13", "FLEET_COMMANDS_ENABLED", "live", plain("agent.fanout"), {
1887
+ route: POST("/api/fleet/schedules/{id}/resume"),
1888
+ cli: "fleet schedules resume"
1889
+ }),
1890
+ // ── checkouts (FL-14, FL-06) ──
1891
+ read("fleet_checkouts_list", "checkouts", "FL-14", "FLEET_CHECKOUTS_ENABLED", "live", {
1892
+ route: GET("/api/fleet/checkouts"),
1893
+ cli: "fleet checkouts list"
1894
+ }),
1895
+ read("fleet_checkouts_get", "checkouts", "FL-14", "FLEET_CHECKOUTS_ENABLED", "live", {
1896
+ route: GET("/api/fleet/checkouts/{id}"),
1897
+ cli: "fleet checkouts get"
1898
+ }),
1899
+ read("fleet_checkouts_changes", "checkouts", "FL-06", "FLEET_CHECKOUTS_ENABLED", "planned", {
1900
+ route: GET("/api/fleet/checkouts/{id}/changes"),
1901
+ cli: "fleet checkouts changes"
1902
+ }),
1903
+ act("fleet_checkouts_create", "checkouts", "FL-14", "FLEET_CHECKOUTS_ENABLED", "live", plain("machine.run"), {
1904
+ route: POST("/api/fleet/checkouts"),
1905
+ cli: "fleet checkouts create",
1906
+ waitable: true
1907
+ }),
1908
+ act("fleet_checkouts_sync", "checkouts", "FL-14", "FLEET_CHECKOUTS_ENABLED", "live", plain("machine.run"), {
1909
+ route: POST("/api/fleet/checkouts/{id}/sync"),
1910
+ cli: "fleet checkouts sync",
1911
+ waitable: true,
1912
+ confirmationNote: "plain for fetch; confirm for pull and push"
1913
+ }),
1914
+ act(
1915
+ "fleet_checkouts_archive",
1916
+ "checkouts",
1917
+ "FL-14",
1918
+ "FLEET_CHECKOUTS_ENABLED",
1919
+ "live",
1920
+ confirm("machine.run", false),
1921
+ { route: POST("/api/fleet/checkouts/{id}/archive"), cli: "fleet checkouts archive" }
1922
+ ),
1923
+ act(
1924
+ "fleet_checkouts_delete",
1925
+ "checkouts",
1926
+ "FL-14",
1927
+ "FLEET_CHECKOUTS_ENABLED",
1928
+ "live",
1929
+ confirm("write.destructive"),
1930
+ {
1931
+ route: DELETE("/api/fleet/checkouts/{id}"),
1932
+ cli: "fleet checkouts delete",
1933
+ confirmationNote: "confirm; confirm-destructive when it has uncommitted changes"
1934
+ }
1935
+ ),
1936
+ act(
1937
+ "fleet_checkouts_open_pull_request",
1938
+ "checkouts",
1939
+ "FL-06",
1940
+ "FLEET_CHECKOUTS_ENABLED",
1941
+ "planned",
1942
+ plain("publish.external"),
1943
+ { route: POST("/api/fleet/checkouts/{id}/pull-request"), cli: "fleet checkouts pull-request" }
1944
+ ),
1945
+ // ── tasks (FL-15) ── the hand-off itself is `fleet_sessions_start` with `taskId`
1946
+ read("fleet_tasks_handoff_options", "sessions", "FL-15", "FLEET_CHECKOUTS_ENABLED", "live", {
1947
+ route: GET("/api/fleet/tasks/{taskId}/handoff-options"),
1948
+ cli: "fleet tasks handoff-options"
1949
+ }),
1950
+ // ── virtual (FL-16) ── P1 shipped: Containers. A create, a stop and a destroy are held for
1951
+ // the owner's approval by the Agent tools (`agent-fleet-virtual-tools.ts`).
1952
+ read("fleet_virtual_list", "view", "FL-16", "FLEET_VIRTUAL_ENABLED", "live", {
1953
+ phase: "P3",
1954
+ route: GET("/api/fleet/nodes/{id}/virtual"),
1955
+ cli: "fleet virtual list"
1956
+ }),
1957
+ read("fleet_virtual_options", "view", "FL-16", "FLEET_VIRTUAL_ENABLED", "live", {
1958
+ phase: "P3",
1959
+ route: GET("/api/fleet/nodes/{id}/virtual/options"),
1960
+ cli: "fleet virtual options"
1961
+ }),
1962
+ act("fleet_virtual_create", "machines", "FL-16", "FLEET_VIRTUAL_ENABLED", "live", confirm("machine.admin"), {
1963
+ phase: "P3",
1964
+ route: POST("/api/fleet/nodes/{id}/virtual"),
1965
+ cli: "fleet virtual create",
1966
+ waitable: true,
1967
+ alwaysHeld: true
1968
+ }),
1969
+ act("fleet_virtual_power", "machines", "FL-16", "FLEET_VIRTUAL_ENABLED", "live", confirm("machine.admin"), {
1970
+ phase: "P3",
1971
+ route: POST("/api/fleet/nodes/{id}/virtual/{childId}/power"),
1972
+ cli: "fleet virtual power",
1973
+ waitable: true,
1974
+ confirmationNote: "plain to start; confirm to stop (an Agent's stop is held for the owner)"
1975
+ }),
1976
+ act("fleet_virtual_destroy", "machines", "FL-16", "FLEET_VIRTUAL_ENABLED", "live", typed("write.destructive"), {
1977
+ phase: "P3",
1978
+ route: POST("/api/fleet/nodes/{id}/virtual/{childId}/destroy"),
1979
+ cli: "fleet virtual destroy",
1980
+ waitable: true,
1981
+ alwaysHeld: true
1982
+ }),
1983
+ // ── cloud (FL-17) ── P1 shipped providers, create, power, destroy, usage; P2 the idle policy
1984
+ // (`PUT` answers the same as `PATCH`). A create, a power change and a destroy are held for the
1985
+ // owner's approval by the Agent tools (`agent-fleet-cloud-tools.ts`).
1986
+ read("fleet_cloud_list", "view", "FL-17", "FLEET_CLOUD_ENABLED", "live", {
1987
+ phase: "P3",
1988
+ route: GET("/api/fleet/cloud"),
1989
+ cli: "fleet cloud list"
1990
+ }),
1991
+ read("fleet_cloud_options", "view", "FL-17", "FLEET_CLOUD_ENABLED", "live", {
1992
+ phase: "P3",
1993
+ route: GET("/api/fleet/providers/{plugin}/options"),
1994
+ cli: "fleet cloud options"
1995
+ }),
1996
+ read("fleet_cloud_usage", "view", "FL-17", "FLEET_CLOUD_ENABLED", "live", {
1997
+ phase: "P3",
1998
+ route: GET("/api/fleet/cloud/usage"),
1999
+ cli: "fleet cloud usage"
2000
+ }),
2001
+ act("fleet_cloud_create", "machines", "FL-17", "FLEET_CLOUD_ENABLED", "live", confirm("spend.metered"), {
2002
+ phase: "P3",
2003
+ route: POST("/api/fleet/cloud"),
2004
+ cli: "fleet cloud create",
2005
+ waitable: true,
2006
+ alwaysHeld: true,
2007
+ confirmationNote: "confirm with the price (acknowledgedPriceCents); also machine.admin"
2008
+ }),
2009
+ act("fleet_cloud_power", "machines", "FL-17", "FLEET_CLOUD_ENABLED", "live", confirm("machine.admin"), {
2010
+ phase: "P3",
2011
+ route: POST("/api/fleet/cloud/{id}/power"),
2012
+ cli: "fleet cloud power",
2013
+ waitable: true,
2014
+ alwaysHeld: true
2015
+ }),
2016
+ act("fleet_cloud_destroy", "machines", "FL-17", "FLEET_CLOUD_ENABLED", "live", typed("write.destructive"), {
2017
+ phase: "P3",
2018
+ // FL-17 plan §5 — `DELETE /api/fleet/cloud/{id}` answers the same (an alias).
2019
+ route: POST("/api/fleet/cloud/{id}/destroy"),
2020
+ cli: "fleet cloud destroy",
2021
+ waitable: true,
2022
+ alwaysHeld: true
2023
+ }),
2024
+ act("fleet_cloud_idle_policy", "machines", "FL-17", "FLEET_CLOUD_ENABLED", "live", plain("machine.admin"), {
2025
+ phase: "P3",
2026
+ route: PATCH("/api/fleet/cloud/{id}/idle-policy"),
2027
+ cli: "fleet cloud idle-policy"
2028
+ }),
2029
+ // ── runners (FL-18) ── P1 shipped: list, install, start / stop / restart, remove. An install, a
2030
+ // stop, a restart and a remove asked by an Agent are held for the owner's approval
2031
+ // (`agent-fleet-runners-tools.ts`). The Actions jobs read and Cancel workflow run arrive with P2.
2032
+ read("fleet_runners_list", "view", "FL-18", "FLEET_ACTIONS_RUNNERS_ENABLED", "live", {
2033
+ phase: "P3",
2034
+ route: GET("/api/fleet/nodes/{id}/runners"),
2035
+ cli: "fleet runners list"
2036
+ }),
2037
+ read("fleet_runners_jobs", "view", "FL-18", "FLEET_ACTIONS_RUNNERS_ENABLED", "planned", {
2038
+ phase: "P3",
2039
+ route: GET("/api/fleet/runners/jobs"),
2040
+ cli: "fleet runners jobs"
2041
+ }),
2042
+ act(
2043
+ "fleet_runners_install",
2044
+ "machines",
2045
+ "FL-18",
2046
+ "FLEET_ACTIONS_RUNNERS_ENABLED",
2047
+ "live",
2048
+ confirm("machine.admin"),
2049
+ {
2050
+ phase: "P3",
2051
+ route: POST("/api/fleet/nodes/{id}/runners"),
2052
+ cli: "fleet runners install",
2053
+ waitable: true,
2054
+ alwaysHeld: true
2055
+ }
2056
+ ),
2057
+ act(
2058
+ "fleet_runners_action",
2059
+ "machines",
2060
+ "FL-18",
2061
+ "FLEET_ACTIONS_RUNNERS_ENABLED",
2062
+ "live",
2063
+ confirm("machine.admin"),
2064
+ {
2065
+ phase: "P3",
2066
+ route: POST("/api/fleet/nodes/{id}/runners/{runnerId}/{action}"),
2067
+ cli: "fleet runners action",
2068
+ waitable: true,
2069
+ confirmationNote: "plain to start; confirm to stop and restart (an Agent's stop or restart is held for the owner)"
2070
+ }
2071
+ ),
2072
+ act(
2073
+ "fleet_runners_remove",
2074
+ "machines",
2075
+ "FL-18",
2076
+ "FLEET_ACTIONS_RUNNERS_ENABLED",
2077
+ "live",
2078
+ typed("write.destructive"),
2079
+ {
2080
+ phase: "P3",
2081
+ route: POST("/api/fleet/nodes/{id}/runners/{runnerId}/remove"),
2082
+ cli: "fleet runners remove",
2083
+ waitable: true,
2084
+ alwaysHeld: true
2085
+ }
2086
+ ),
2087
+ act(
2088
+ "fleet_runners_cancel_run",
2089
+ "machines",
2090
+ "FL-18",
2091
+ "FLEET_ACTIONS_RUNNERS_ENABLED",
2092
+ "planned",
2093
+ confirm("machine.admin"),
2094
+ { phase: "P3", route: POST("/api/fleet/runners/jobs/cancel"), cli: "fleet runners cancel-run" }
2095
+ ),
2096
+ // ── usage (FL-20) ── P1 shipped: the Usage object (totals, by model, by computer, busiest
2097
+ // checkouts, sessions) every surface renders, read-only, with the payer sentence in `note`.
2098
+ read("fleet_usage_get", "view", "FL-20", "FLEET_USAGE_SCAN_ENABLED", "live", {
2099
+ phase: "P3",
2100
+ route: GET("/api/fleet/usage"),
2101
+ cli: "fleet usage"
2102
+ }),
2103
+ // ── operations (FL-02, FL-19) ──
2104
+ read("fleet_operations_get", "view", "FL-02", "FLEET_NODE_LINK_ENABLED", "live", {
2105
+ route: GET("/api/fleet/operations/{id}"),
2106
+ cli: "fleet operations get"
2107
+ }),
2108
+ read("fleet_operations_list", "view", "FL-19", "FLEET_NODE_LINK_ENABLED", "live", {
2109
+ route: GET("/api/fleet/operations"),
2110
+ cli: "fleet operations list"
2111
+ }),
2112
+ act("fleet_operations_cancel", "view", "FL-02", "FLEET_NODE_LINK_ENABLED", "live", plain("machine.run"), {
2113
+ route: DELETE("/api/fleet/operations/{id}"),
2114
+ cli: "fleet operations cancel"
2115
+ })
2116
+ ]);
2117
+ var BY_NAME = new Map(
2118
+ FLEET_TOOL_CATALOGUE.map((entry) => [entry.name, entry])
2119
+ );
2120
+ var FLEET_TOOL_COPY = Object.freeze({
2121
+ noCredential: (agent) => `Tools never carry a credential. ${agent} acts through the platform; the platform asks the computer.`,
2122
+ rungOff: (category, agent) => `'${category}' is Off for ${agent} \u2014 raise it on ${agent}'s Safety tab`,
2123
+ grantDenied: (tool, scope) => `${tool} is denied by a tool grant at ${scope} scope`,
2124
+ audience: (computer, audience, family) => `ask the owner of ${computer} to allow ${audience}: ${family}`,
2125
+ confirm: () => "call again with confirm: true",
2126
+ confirmName: (name) => `type the exact name: ${name}`,
2127
+ acknowledge: () => "call again with confirm: true and acknowledgeBlastRadius: true",
2128
+ killSwitch: () => "clear it under Settings \u2192 Fleet",
2129
+ permissionPromptHuman: () => "permission prompts are answered by people"
2130
+ });
2131
+ var FLEET_TOOL_CATEGORY_LABELS = Object.freeze({
2132
+ "read.internal": "Read inside the workspace",
2133
+ "write.internal": "Change things inside the workspace",
2134
+ "write.destructive": "Delete things",
2135
+ "publish.external": "Publish outside the workspace",
2136
+ "spend.metered": "Spend credits",
2137
+ "machine.run": "Run commands on a computer",
2138
+ "machine.admin": "Change a computer",
2139
+ "agent.fanout": "Hire agents and set schedules"
2140
+ });
2141
+ var FLEET_HELD_ACTION_MAX_AGE_MS = 24 * 60 * 60 * 1e3;
2142
+ var FLEET_TOOL_FAMILY_CONSENT = Object.freeze({
2143
+ view: null,
2144
+ sessions: "work",
2145
+ desktop: "attend",
2146
+ logs: "manage",
2147
+ services: "manage",
2148
+ docker: "manage",
2149
+ processes: "manage",
2150
+ ports: "manage",
2151
+ files: "manage",
2152
+ commands: "manage",
2153
+ schedules: "manage",
2154
+ checkouts: "manage",
2155
+ machines: "manage"
2156
+ });
2157
+ var FLEET_CLI_EXIT = Object.freeze({ ok: 0, failed: 1, usage: 2, timeout: 124 });
2158
+ var FLEET_TOOL_FORBIDDEN_PATH_PREFIXES = Object.freeze([
2159
+ "/api/fleet/enroll",
2160
+ "/api/fleet/heartbeat",
2161
+ "/api/fleet/jobs",
2162
+ "/api/fleet/rotate-credential",
2163
+ "/api/fleet/link-token",
2164
+ "/api/fleet/nodes/enrollment-token",
2165
+ "/api/fleet/enrollment-tokens",
2166
+ "/api/internal/fleet"
2167
+ ]);
2168
+ var FLEET_TOOL_FORBIDDEN_PATH_FRAGMENTS = Object.freeze([
2169
+ "/attach-token",
2170
+ "/credential",
2171
+ "/rotate-credential"
2172
+ ]);
2173
+ var FLEET_VIRTUAL_SYSTEMS = [
2174
+ {
2175
+ id: "windows-11",
2176
+ kind: "vm",
2177
+ label: "Windows 11",
2178
+ family: "windows",
2179
+ arch: ["x64"],
2180
+ windowsEdition: "11",
2181
+ approxDiskGiB: 64,
2182
+ approxDownloadGiB: 6
2183
+ },
2184
+ {
2185
+ id: "windows-10",
2186
+ kind: "vm",
2187
+ label: "Windows 10",
2188
+ family: "windows",
2189
+ arch: ["x64"],
2190
+ windowsEdition: "10",
2191
+ approxDiskGiB: 64,
2192
+ approxDownloadGiB: 6
2193
+ },
2194
+ {
2195
+ id: "windows-server-2025",
2196
+ kind: "vm",
2197
+ label: "Windows Server 2025",
2198
+ family: "windows",
2199
+ arch: ["x64"],
2200
+ windowsEdition: "2025",
2201
+ approxDiskGiB: 64,
2202
+ approxDownloadGiB: 6
2203
+ },
2204
+ {
2205
+ id: "windows-server-2022",
2206
+ kind: "vm",
2207
+ label: "Windows Server 2022",
2208
+ family: "windows",
2209
+ arch: ["x64"],
2210
+ windowsEdition: "2022",
2211
+ approxDiskGiB: 64,
2212
+ approxDownloadGiB: 6
2213
+ },
2214
+ {
2215
+ id: "ubuntu-26.04",
2216
+ kind: "container",
2217
+ label: "Ubuntu 26.04",
2218
+ family: "ubuntu",
2219
+ arch: ["x64", "arm64"],
2220
+ approxDiskGiB: 3,
2221
+ approxDownloadGiB: 0.5
2222
+ },
2223
+ {
2224
+ id: "ubuntu-24.04",
2225
+ kind: "container",
2226
+ label: "Ubuntu 24.04",
2227
+ family: "ubuntu",
2228
+ arch: ["x64", "arm64"],
2229
+ approxDiskGiB: 3,
2230
+ approxDownloadGiB: 0.5
2231
+ },
2232
+ {
2233
+ id: "debian-13",
2234
+ kind: "container",
2235
+ label: "Debian 13",
2236
+ family: "debian",
2237
+ arch: ["x64", "arm64"],
2238
+ approxDiskGiB: 3,
2239
+ approxDownloadGiB: 0.5
2240
+ },
2241
+ {
2242
+ id: "fedora",
2243
+ kind: "container",
2244
+ label: "Fedora",
2245
+ family: "fedora",
2246
+ arch: ["x64", "arm64"],
2247
+ approxDiskGiB: 3,
2248
+ approxDownloadGiB: 0.6
2249
+ },
2250
+ {
2251
+ id: "alpine",
2252
+ kind: "container",
2253
+ label: "Alpine",
2254
+ family: "alpine",
2255
+ arch: ["x64", "arm64"],
2256
+ approxDiskGiB: 1,
2257
+ approxDownloadGiB: 0.2
2258
+ },
2259
+ {
2260
+ // Arch Linux publishes no official arm64 image (FR-6).
2261
+ id: "arch",
2262
+ kind: "container",
2263
+ label: "Arch Linux",
2264
+ family: "arch",
2265
+ arch: ["x64"],
2266
+ approxDiskGiB: 3,
2267
+ approxDownloadGiB: 0.7
2268
+ }
2269
+ ];
2270
+ var FLEET_VIRTUAL_SYSTEM_IDS = FLEET_VIRTUAL_SYSTEMS.map((system) => system.id);
2271
+ var FLEET_VIRTUAL_ENROLL_TIMEOUT_MS = 20 * 60 * 1e3;
2272
+ var FLEET_CLOUD_OPTIONS_CACHE_MS = 10 * 60 * 1e3;
2273
+ var HOUR_MS2 = 60 * 60 * 1e3;
2274
+ var FLEET_CLOUD_USAGE_FRESH_MS = 5 * 60 * 1e3;
2275
+ var FLEET_USAGE_SCAN_INTERVAL_MS = 15 * 60 * 1e3;
2276
+ var FLEET_USAGE_REPORT_MAX_BYTES = 192 * 1024;
2277
+ var FLEET_USAGE_ZERO_TOKENS = Object.freeze({
2278
+ in: 0,
2279
+ out: 0,
2280
+ cacheRead: 0,
2281
+ cacheWrite: 0
2282
+ });
2283
+ var FLEET_ACTIONS_RUNNERS_CLOSED_REFRESH_MS = 5 * 6e4;
1334
2284
  var EMAIL_INBOX_DEFAULT_DAILY_CAP = 100;
1335
2285
  var EMAIL_INBOX_BURST_SENDS = 10;
1336
2286
  var EMAIL_INBOX_BURST_RECIPIENTS = 20;
@@ -1359,7 +2309,7 @@ var EMAIL_SEND_CAP_FIELDS = [
1359
2309
  "workspaceMonthlySends"
1360
2310
  ];
1361
2311
  var INBOX_CAP_FIELD_SET = new Set(EMAIL_INBOX_CAP_FIELDS);
1362
- var DAY_MS2 = 24 * 60 * 60 * 1e3;
2312
+ var DAY_MS3 = 24 * 60 * 60 * 1e3;
1363
2313
  var PROMOTION_GATE_DECISION_GRACE_MS = 20 * 60 * 1e3;
1364
2314
  var RELEASE_VERIFY_ATTEMPT_INTERVAL_MS = 10 * 60 * 1e3;
1365
2315
  var RELEASE_VERIFY_BUDGET_MS = 8 * 60 * 60 * 1e3;
@@ -1565,8 +2515,8 @@ var BACKUP_DEFAULT_LIMITS = Object.freeze({
1565
2515
  /** Retries a storage write gets before the backup fails as `storage_unavailable`. */
1566
2516
  storageRetries: 3
1567
2517
  });
1568
- var HOUR_MS = 60 * 60 * 1e3;
1569
- var MINUTE_MS = 60 * 1e3;
2518
+ var HOUR_MS3 = 60 * 60 * 1e3;
2519
+ var MINUTE_MS2 = 60 * 1e3;
1570
2520
  var ACTION_CATEGORIES = Object.freeze([
1571
2521
  "read.internal",
1572
2522
  "read.external",
@@ -1873,13 +2823,16 @@ var INTEGRATION_SCOPES = [
1873
2823
  "events:read",
1874
2824
  "webhooks:manage",
1875
2825
  "links:write",
1876
- "merges:decide"
2826
+ "merges:decide",
2827
+ "decisions:individual"
1877
2828
  ];
1878
2829
  var INTEGRATION_MERGE_DECISION_SCOPE = "merges:decide";
2830
+ var INTEGRATION_INDIVIDUAL_DECISION_SCOPE = "decisions:individual";
1879
2831
  var INTEGRATION_OPT_IN_SCOPES = [
1880
2832
  "org:write",
1881
2833
  "email:write",
1882
- INTEGRATION_MERGE_DECISION_SCOPE
2834
+ INTEGRATION_MERGE_DECISION_SCOPE,
2835
+ INTEGRATION_INDIVIDUAL_DECISION_SCOPE
1883
2836
  ];
1884
2837
  var EVER_GAUZY_PRESET_SCOPES = INTEGRATION_SCOPES.filter(
1885
2838
  (scope) => !INTEGRATION_OPT_IN_SCOPES.includes(scope)
@@ -2698,7 +3651,23 @@ var PLUGIN_CAPABILITIES = {
2698
3651
  // `capabilities/domain-event-subscriber.interface.ts`. Appended last, so
2699
3652
  // every existing constant keeps its value and its position; no category is
2700
3653
  // added (a subscriber plugin keeps the category of what it otherwise is).
2701
- DOMAIN_EVENT_SUBSCRIBER: "domain-event-subscriber"
3654
+ DOMAIN_EVENT_SUBSCRIBER: "domain-event-subscriber",
3655
+ // Cloud computers (FL-17, CONTRACTS R-15) — plugins that create, power and
3656
+ // destroy machines at a cloud provider on the owner's own account and say
3657
+ // what they cost (`IMachineProviderPlugin`). The first plugin ships under
3658
+ // `packages/plugins/`. Consumed only through
3659
+ // `MachineProviderFacadeService`; see
3660
+ // `capabilities/machine-provider.interface.ts`. Appended **last**, so every
3661
+ // existing constant keeps its value and its position, and landed in the same
3662
+ // change as the `machine-provider` category in `plugin-manifest.types.ts`.
3663
+ MACHINE_PROVIDER: "machine-provider",
3664
+ // Actions runners on computers (FL-18, CONTRACTS R-14) — GitHub's self-hosted
3665
+ // runner API through the Ever Works GitHub App (`github-actions-runners`),
3666
+ // consumed only through `ActionsRunnersFacadeService`; see
3667
+ // `capabilities/actions-runners.interface.ts`. Appended last, so every
3668
+ // existing constant keeps its value and its position; no category is added
3669
+ // (the plugin is an `integration`, which exists).
3670
+ ACTIONS_RUNNERS: "actions-runners"
2702
3671
  };
2703
3672
  var ALL_PLUGIN_CAPABILITIES = Object.values(PLUGIN_CAPABILITIES);
2704
3673
  function validateRequiredItemFields(data) {