@ever-works/mailchimp-transactional-plugin 1.0.7 → 1.0.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.cjs CHANGED
@@ -719,8 +719,855 @@ var FLEET_LINK_CONTROL_TYPES = [
719
719
  "operation.done",
720
720
  "operation.cancel"
721
721
  ];
722
+ var FLEET_CREDENTIAL_FILE_PATTERNS = [
723
+ ".env",
724
+ ".env.*",
725
+ "*.pem",
726
+ "*.key",
727
+ "*.p12",
728
+ "*.pfx",
729
+ "*.jks",
730
+ "*.keystore",
731
+ "*.kdbx",
732
+ "id_rsa*",
733
+ "id_dsa*",
734
+ "id_ecdsa*",
735
+ "id_ed25519*",
736
+ "*.ppk",
737
+ ".netrc",
738
+ ".npmrc",
739
+ ".pypirc",
740
+ "credentials",
741
+ "credentials.json",
742
+ "service-account*.json",
743
+ ".aws/credentials",
744
+ "*.gpg",
745
+ "*.asc",
746
+ ".docker/config.json",
747
+ "kubeconfig",
748
+ ".kube/config"
749
+ ];
750
+ function globToRegExp(glob) {
751
+ const escaped = glob.replace(/[.+?^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*");
752
+ return new RegExp(`^${escaped}$`, "i");
753
+ }
754
+ FLEET_CREDENTIAL_FILE_PATTERNS.filter((pattern) => !pattern.includes("/")).map(
755
+ globToRegExp
756
+ );
757
+ FLEET_CREDENTIAL_FILE_PATTERNS.filter((pattern) => pattern.includes("/")).map(
758
+ (pattern) => ({ segments: pattern.split("/").length, matcher: globToRegExp(pattern) })
759
+ );
722
760
  new Set(FLEET_LINK_CONTROL_TYPES);
723
761
  new TextEncoder();
762
+ var FLEET_RUN_TOKEN_ROUTES = Object.freeze([
763
+ // Works — reads, plus the settings update (its merge / check / command
764
+ // fields are refused for run tokens by the Works controller).
765
+ { method: "GET", pathPattern: "/api/works" },
766
+ { method: "GET", pathPattern: "/api/works/{id}" },
767
+ { method: "PUT", pathPattern: "/api/works/{id}" },
768
+ { method: "GET", pathPattern: "/api/works/{id}/config" },
769
+ { method: "GET", pathPattern: "/api/works/{id}/items" },
770
+ { method: "GET", pathPattern: "/api/works/{id}/categories-tags" },
771
+ { method: "GET", pathPattern: "/api/works/{id}/history" },
772
+ { method: "GET", pathPattern: "/api/works/{id}/generator-form" },
773
+ { method: "GET", pathPattern: "/api/works/{id}/schedule" },
774
+ { method: "GET", pathPattern: "/api/works/{id}/comparisons" },
775
+ { method: "GET", pathPattern: "/api/works/{id}/comparisons/{slug}" },
776
+ // Knowledge Base (`apps/mcp/src/tools/kb`). A document a run token writes
777
+ // lands `proposed` (review-gated), see the KB controller. No unlock.
778
+ { method: "GET", pathPattern: "/api/works/{id}/kb/documents" },
779
+ { method: "POST", pathPattern: "/api/works/{id}/kb/documents" },
780
+ { method: "GET", pathPattern: "/api/works/{id}/kb/documents/{docIdOrPath}" },
781
+ { method: "PATCH", pathPattern: "/api/works/{id}/kb/documents/{docId}" },
782
+ { method: "POST", pathPattern: "/api/works/{id}/kb/documents/{docId}/lock" },
783
+ // Deploy — reads and the capability check only.
784
+ { method: "GET", pathPattern: "/api/deploy/works/{id}/domains" },
785
+ { method: "GET", pathPattern: "/api/deploy/providers" },
786
+ { method: "POST", pathPattern: "/api/deploy/works/{id}/check" },
787
+ // Plugins — read only.
788
+ { method: "GET", pathPattern: "/api/plugins" },
789
+ { method: "GET", pathPattern: "/api/plugins/{pluginId}" },
790
+ // Missions — reads, plus pause (the safe direction).
791
+ { method: "GET", pathPattern: "/api/me/missions" },
792
+ { method: "GET", pathPattern: "/api/me/missions/{id}" },
793
+ { method: "GET", pathPattern: "/api/me/missions/{id}/budget" },
794
+ { method: "GET", pathPattern: "/api/me/missions/{id}/works" },
795
+ { method: "POST", pathPattern: "/api/me/missions/{id}/pause" },
796
+ // Ideas — reads, plus filing a new Idea (a proposal a person builds).
797
+ { method: "POST", pathPattern: "/api/me/work-proposals" },
798
+ { method: "GET", pathPattern: "/api/me/work-proposals" },
799
+ { method: "GET", pathPattern: "/api/me/work-proposals/status" },
800
+ { method: "GET", pathPattern: "/api/me/work-proposals/preferences" },
801
+ { method: "GET", pathPattern: "/api/me/work-proposals/{id}" },
802
+ { method: "GET", pathPattern: "/api/me/work-proposals/{id}/budget" },
803
+ // Account-wide usage.
804
+ { method: "GET", pathPattern: "/api/me/usage/account-wide" },
805
+ // Tasks — reads and collaboration writes. Create / update / transition /
806
+ // assign / chat carry body refusals for run tokens in the Tasks
807
+ // controller (no checks, no schedule, no force, no dispatch, no @agent).
808
+ { method: "GET", pathPattern: "/api/tasks" },
809
+ { method: "POST", pathPattern: "/api/tasks" },
810
+ { method: "GET", pathPattern: "/api/tasks/{id}" },
811
+ { method: "PATCH", pathPattern: "/api/tasks/{id}" },
812
+ { method: "GET", pathPattern: "/api/tasks/{id}/subtasks" },
813
+ { method: "GET", pathPattern: "/api/tasks/{id}/activity" },
814
+ { method: "POST", pathPattern: "/api/tasks/{id}/transition" },
815
+ { method: "GET", pathPattern: "/api/tasks/{id}/run-candidates" },
816
+ { method: "GET", pathPattern: "/api/tasks/{id}/pr-status" },
817
+ { method: "GET", pathPattern: "/api/tasks/{id}/diff" },
818
+ { method: "POST", pathPattern: "/api/tasks/{id}/assignees" },
819
+ { method: "POST", pathPattern: "/api/tasks/{id}/reviewers" },
820
+ { method: "POST", pathPattern: "/api/tasks/{id}/approvers" },
821
+ { method: "POST", pathPattern: "/api/tasks/{id}/relations" },
822
+ { method: "GET", pathPattern: "/api/tasks/{id}/escalations" },
823
+ { method: "GET", pathPattern: "/api/tasks/{id}/chat" },
824
+ { method: "POST", pathPattern: "/api/tasks/{id}/chat" },
825
+ { method: "GET", pathPattern: "/api/tasks/{id}/spend" },
826
+ // Inbox — read only (no reply, no archive / delete / mark-read).
827
+ { method: "GET", pathPattern: "/api/inbox" },
828
+ { method: "GET", pathPattern: "/api/inbox/unread-count" },
829
+ { method: "GET", pathPattern: "/api/inbox/{id}" },
830
+ // Goals — reads, a draft create, field-limited update, pause, and the
831
+ // ASKING side of the definition of done (propose, never approve).
832
+ { method: "GET", pathPattern: "/api/me/goals" },
833
+ { method: "POST", pathPattern: "/api/me/goals" },
834
+ { method: "GET", pathPattern: "/api/me/goals/{id}" },
835
+ { method: "PATCH", pathPattern: "/api/me/goals/{id}" },
836
+ { method: "GET", pathPattern: "/api/me/goals/{id}/samples" },
837
+ { method: "POST", pathPattern: "/api/me/goals/{id}/pause" },
838
+ { method: "POST", pathPattern: "/api/me/goals/{id}/dod/propose" },
839
+ // Fleet — reads only.
840
+ { method: "GET", pathPattern: "/api/fleet/nodes" },
841
+ { method: "GET", pathPattern: "/api/fleet/nodes/{id}" },
842
+ { method: "GET", pathPattern: "/api/fleet/runner-status" },
843
+ { method: "GET", pathPattern: "/api/fleet/execution-preferences" },
844
+ { method: "GET", pathPattern: "/api/fleet/agents/{agentId}/node-affinity" },
845
+ // Session git & actions (FL-06 FR-18): an Agent session asks the platform to
846
+ // open or update the pull request of ITS OWN checkout. The route refuses a
847
+ // checkout that is not the token's session's, and the Agent's "may open pull
848
+ // requests" permission applies; it never merges anything.
849
+ { method: "GET", pathPattern: "/api/fleet/checkouts/{id}/pull-request" },
850
+ { method: "POST", pathPattern: "/api/fleet/checkouts/{id}/pull-request" },
851
+ // Agents — reads, plus cancel and pause (the safe direction).
852
+ { method: "GET", pathPattern: "/api/agents" },
853
+ { method: "GET", pathPattern: "/api/agents/{id}" },
854
+ { method: "GET", pathPattern: "/api/agents/{id}/runs" },
855
+ { method: "GET", pathPattern: "/api/agents/{id}/runs/{runId}" },
856
+ { method: "POST", pathPattern: "/api/agents/{id}/runs/{runId}/cancel" },
857
+ { method: "POST", pathPattern: "/api/agents/{id}/pause" },
858
+ { method: "GET", pathPattern: "/api/agents/{id}/budget" },
859
+ // Agent Plugins — read only (installing a package installs instructions).
860
+ { method: "GET", pathPattern: "/api/agent-plugins" },
861
+ { method: "GET", pathPattern: "/api/agent-plugins/findings" },
862
+ { method: "GET", pathPattern: "/api/agent-plugins/catalog" },
863
+ { method: "GET", pathPattern: "/api/agent-plugins/updates" }
864
+ ]);
865
+ function splitSegments(normalizedPath) {
866
+ return normalizedPath.split("/").filter((segment) => segment.length > 0);
867
+ }
868
+ FLEET_RUN_TOKEN_ROUTES.map((route) => ({
869
+ method: route.method.toUpperCase(),
870
+ shape: splitSegments(route.pathPattern).map((part) => /^\{[^}]+\}$/.test(part) ? "*" : part.toLowerCase())
871
+ }));
872
+ function row(input) {
873
+ const rest = input.name.slice("fleet_".length);
874
+ const cut = rest.indexOf("_");
875
+ const family = cut === -1 ? rest : rest.slice(0, cut);
876
+ const verb = cut === -1 ? "" : rest.slice(cut + 1);
877
+ return Object.freeze({ ...input, family, verb });
878
+ }
879
+ function read(name, permissionFamily, owner, flag, status, extra = {}) {
880
+ return row({
881
+ name,
882
+ readOnly: true,
883
+ category: "read.internal",
884
+ permissionFamily,
885
+ owner,
886
+ phase: "P1",
887
+ flag,
888
+ status,
889
+ ...extra
890
+ });
891
+ }
892
+ function act(name, permissionFamily, owner, flag, status, annotation, extra = {}) {
893
+ return row({ name, permissionFamily, owner, phase: "P2", flag, status, ...annotation, ...extra });
894
+ }
895
+ var plain = (category, destructive = false) => ({
896
+ destructive,
897
+ confirmationClass: "plain",
898
+ category
899
+ });
900
+ var confirm = (category, destructive = true) => ({
901
+ destructive,
902
+ confirmationClass: "confirm",
903
+ category
904
+ });
905
+ var typed = (category) => ({
906
+ destructive: true,
907
+ confirmationClass: "confirm-destructive",
908
+ category
909
+ });
910
+ var GET = (path) => ({ method: "GET", path });
911
+ var POST = (path) => ({ method: "POST", path });
912
+ var PATCH = (path) => ({ method: "PATCH", path });
913
+ var DELETE = (path) => ({ method: "DELETE", path });
914
+ var FLEET_TOOL_CATALOGUE = Object.freeze([
915
+ // ── status (FL-19) ──
916
+ read("fleet_status", "view", "FL-19", "FLEET_ENABLED", "live", {
917
+ route: GET("/api/fleet/status"),
918
+ cli: "fleet status"
919
+ }),
920
+ // ── nodes (FL-19, FL-03, FL-15) ──
921
+ read("fleet_nodes_list", "view", "FL-19", "FLEET_ENABLED", "live", {
922
+ route: GET("/api/fleet/nodes"),
923
+ cli: "fleet nodes list"
924
+ }),
925
+ read("fleet_nodes_get", "view", "FL-19", "FLEET_ENABLED", "live", {
926
+ route: GET("/api/fleet/nodes/{id}"),
927
+ cli: "fleet nodes get"
928
+ }),
929
+ read("fleet_nodes_health", "view", "FL-03", "FLEET_ENABLED", "live", {
930
+ route: GET("/api/fleet/nodes/{id}/health"),
931
+ cli: "fleet nodes health"
932
+ }),
933
+ read("fleet_nodes_needs_a_look", "view", "FL-03", "FLEET_ENABLED", "live", {
934
+ route: GET("/api/fleet/nodes/{id}/needs-a-look"),
935
+ cli: "fleet nodes needs-a-look"
936
+ }),
937
+ read("fleet_nodes_git_identity_get", "view", "FL-15", "FLEET_CHECKOUTS_ENABLED", "live", {
938
+ route: GET("/api/fleet/nodes/{id}/git/identity"),
939
+ cli: "fleet nodes git-identity"
940
+ }),
941
+ act("fleet_nodes_wake", "machines", "FL-03", "FLEET_ENABLED", "live", plain("machine.admin"), {
942
+ route: POST("/api/fleet/nodes/{id}/wake"),
943
+ cli: "fleet nodes wake"
944
+ }),
945
+ act(
946
+ "fleet_nodes_git_identity_set",
947
+ "commands",
948
+ "FL-15",
949
+ "FLEET_CHECKOUTS_ENABLED",
950
+ "live",
951
+ confirm("machine.admin", false),
952
+ { route: POST("/api/fleet/nodes/{id}/git/identity"), cli: "fleet nodes git-identity --set" }
953
+ ),
954
+ // ── sessions (FL-04, FL-05, FL-06) ──
955
+ read("fleet_sessions_list", "sessions", "FL-04", "FLEET_SESSIONS_ENABLED", "live", {
956
+ route: GET("/api/fleet/sessions"),
957
+ cli: "fleet sessions list"
958
+ }),
959
+ read("fleet_sessions_read", "sessions", "FL-04", "FLEET_SESSIONS_ENABLED", "live", {
960
+ route: GET("/api/fleet/sessions/{id}"),
961
+ cli: "fleet sessions read"
962
+ }),
963
+ read("fleet_sessions_question", "sessions", "FL-05", "FLEET_SESSIONS_ENABLED", "live", {
964
+ route: GET("/api/fleet/sessions/{id}"),
965
+ cli: "fleet sessions question"
966
+ }),
967
+ read("fleet_sessions_actions_list", "sessions", "FL-06", "FLEET_SESSIONS_ENABLED", "planned", {
968
+ route: GET("/api/fleet/sessions/{id}/actions"),
969
+ cli: "fleet sessions actions"
970
+ }),
971
+ act("fleet_sessions_start", "sessions", "FL-04", "FLEET_SESSIONS_ENABLED", "live", plain("machine.run"), {
972
+ route: POST("/api/fleet/nodes/{id}/sessions"),
973
+ cli: "fleet sessions start"
974
+ }),
975
+ act("fleet_sessions_send", "sessions", "FL-04", "FLEET_SESSIONS_ENABLED", "live", plain("machine.run")),
976
+ act("fleet_sessions_answer", "sessions", "FL-05", "FLEET_SESSIONS_ENABLED", "live", confirm("machine.run", false), {
977
+ route: POST("/api/fleet/sessions/{id}/answer"),
978
+ cli: "fleet sessions answer",
979
+ confirmationNote: "questions only; a permission prompt is answered by a person (CONTRACTS R-32)"
980
+ }),
981
+ act("fleet_sessions_rename", "sessions", "FL-04", "FLEET_SESSIONS_ENABLED", "live", plain("write.internal"), {
982
+ route: PATCH("/api/fleet/sessions/{id}"),
983
+ cli: "fleet sessions rename"
984
+ }),
985
+ act("fleet_sessions_end", "sessions", "FL-04", "FLEET_SESSIONS_ENABLED", "live", confirm("machine.run"), {
986
+ route: POST("/api/fleet/sessions/{id}/end"),
987
+ cli: "fleet sessions end"
988
+ }),
989
+ act("fleet_sessions_action", "sessions", "FL-06", "FLEET_SESSIONS_ENABLED", "planned", plain("machine.run"), {
990
+ route: POST("/api/fleet/sessions/{id}/actions"),
991
+ cli: "fleet sessions action"
992
+ }),
993
+ // ── desktop (FL-07, FL-11 paste) ──
994
+ read("fleet_desktop_screenshot", "desktop", "FL-07", "FLEET_DESKTOP_ENABLED", "planned", {
995
+ route: GET("/api/fleet/nodes/{id}/desktop/screenshot"),
996
+ cli: "fleet desktop screenshot"
997
+ }),
998
+ read("fleet_desktop_displays", "desktop", "FL-07", "FLEET_DESKTOP_ENABLED", "planned", {
999
+ route: GET("/api/fleet/nodes/{id}/desktop/displays"),
1000
+ cli: "fleet desktop displays"
1001
+ }),
1002
+ read("fleet_desktop_recordings_list", "desktop", "FL-07", "FLEET_DESKTOP_ENABLED", "planned", {
1003
+ route: GET("/api/fleet/nodes/{id}/desktop/recordings"),
1004
+ cli: "fleet desktop recordings"
1005
+ }),
1006
+ act("fleet_desktop_input", "desktop", "FL-07", "FLEET_DESKTOP_ENABLED", "planned", plain("machine.admin", true), {
1007
+ route: POST("/api/fleet/nodes/{id}/desktop/input"),
1008
+ cli: "fleet desktop input"
1009
+ }),
1010
+ act("fleet_desktop_set_display", "desktop", "FL-07", "FLEET_DESKTOP_ENABLED", "planned", plain("machine.admin"), {
1011
+ route: POST("/api/fleet/nodes/{id}/desktop/displays"),
1012
+ cli: "fleet desktop set-display"
1013
+ }),
1014
+ act("fleet_desktop_display_add", "desktop", "FL-07", "FLEET_DESKTOP_ENABLED", "planned", confirm("machine.admin"), {
1015
+ phase: "P3",
1016
+ route: POST("/api/fleet/nodes/{id}/desktop/displays/virtual"),
1017
+ cli: "fleet desktop display-add"
1018
+ }),
1019
+ act(
1020
+ "fleet_desktop_display_remove",
1021
+ "desktop",
1022
+ "FL-07",
1023
+ "FLEET_DESKTOP_ENABLED",
1024
+ "planned",
1025
+ confirm("machine.admin"),
1026
+ {
1027
+ phase: "P3",
1028
+ route: DELETE("/api/fleet/nodes/{id}/desktop/displays/virtual/{displayId}"),
1029
+ cli: "fleet desktop display-remove"
1030
+ }
1031
+ ),
1032
+ act(
1033
+ "fleet_desktop_paste",
1034
+ "desktop",
1035
+ "FL-11",
1036
+ "FLEET_MACHINE_FACTS_ENABLED",
1037
+ "planned",
1038
+ plain("machine.admin", true),
1039
+ {
1040
+ route: POST("/api/fleet/nodes/{id}/desktop/paste"),
1041
+ cli: "fleet desktop paste",
1042
+ confirmationNote: "denied unless a tool grant allows it (AW-15)"
1043
+ }
1044
+ ),
1045
+ // ── logs (FL-08) ──
1046
+ read("fleet_logs_sources", "logs", "FL-08", "FLEET_MACHINE_FACTS_ENABLED", "live", {
1047
+ route: GET("/api/fleet/nodes/{id}/logs/sources"),
1048
+ cli: "fleet logs sources"
1049
+ }),
1050
+ read("fleet_logs_read", "logs", "FL-08", "FLEET_MACHINE_FACTS_ENABLED", "live", {
1051
+ route: POST("/api/fleet/nodes/{id}/logs/read"),
1052
+ cli: "fleet logs read"
1053
+ }),
1054
+ // ── services (FL-09) ──
1055
+ read("fleet_services_list", "services", "FL-09", "FLEET_MACHINE_FACTS_ENABLED", "live", {
1056
+ route: GET("/api/fleet/nodes/{id}/services"),
1057
+ cli: "fleet services list"
1058
+ }),
1059
+ act("fleet_services_action", "services", "FL-09", "FLEET_MACHINE_FACTS_ENABLED", "live", confirm("machine.admin"), {
1060
+ route: POST("/api/fleet/nodes/{id}/services/{name}/{action}"),
1061
+ cli: "fleet services action",
1062
+ waitable: true,
1063
+ confirmationNote: "confirm; blast-radius when the node warns it could cut the machine off"
1064
+ }),
1065
+ // ── processes (FL-09) ──
1066
+ read("fleet_processes_list", "processes", "FL-09", "FLEET_MACHINE_FACTS_ENABLED", "live", {
1067
+ route: GET("/api/fleet/nodes/{id}/processes"),
1068
+ cli: "fleet processes list"
1069
+ }),
1070
+ act(
1071
+ "fleet_processes_signal",
1072
+ "processes",
1073
+ "FL-09",
1074
+ "FLEET_MACHINE_FACTS_ENABLED",
1075
+ "live",
1076
+ confirm("machine.admin"),
1077
+ { route: POST("/api/fleet/nodes/{id}/processes/{pid}/signal"), cli: "fleet processes signal" }
1078
+ ),
1079
+ // ── docker (FL-09) ──
1080
+ read("fleet_docker_containers_list", "docker", "FL-09", "FLEET_MACHINE_FACTS_ENABLED", "live", {
1081
+ route: GET("/api/fleet/nodes/{id}/docker/containers"),
1082
+ cli: "fleet docker containers"
1083
+ }),
1084
+ read("fleet_docker_images_list", "docker", "FL-09", "FLEET_MACHINE_FACTS_ENABLED", "live", {
1085
+ route: GET("/api/fleet/nodes/{id}/docker/images"),
1086
+ cli: "fleet docker images"
1087
+ }),
1088
+ read("fleet_docker_compose_list", "docker", "FL-09", "FLEET_MACHINE_FACTS_ENABLED", "live", {
1089
+ route: GET("/api/fleet/nodes/{id}/docker/compose"),
1090
+ cli: "fleet docker compose"
1091
+ }),
1092
+ read("fleet_docker_compose_describe", "docker", "FL-09", "FLEET_MACHINE_FACTS_ENABLED", "live", {
1093
+ cli: "fleet docker compose-describe"
1094
+ }),
1095
+ act(
1096
+ "fleet_docker_container_action",
1097
+ "docker",
1098
+ "FL-09",
1099
+ "FLEET_MACHINE_FACTS_ENABLED",
1100
+ "live",
1101
+ confirm("machine.admin"),
1102
+ {
1103
+ route: POST("/api/fleet/nodes/{id}/docker/containers/{cid}/{action}"),
1104
+ cli: "fleet docker container",
1105
+ waitable: true,
1106
+ confirmationNote: "confirm; remove is confirm-destructive"
1107
+ }
1108
+ ),
1109
+ act("fleet_docker_run", "docker", "FL-09", "FLEET_MACHINE_FACTS_ENABLED", "live", confirm("machine.admin", false), {
1110
+ route: POST("/api/fleet/nodes/{id}/docker/containers"),
1111
+ cli: "fleet docker run",
1112
+ waitable: true,
1113
+ alwaysHeld: true,
1114
+ confirmationNote: "an Agent proposes a run; a person types any secret values"
1115
+ }),
1116
+ act(
1117
+ "fleet_docker_image_action",
1118
+ "docker",
1119
+ "FL-09",
1120
+ "FLEET_MACHINE_FACTS_ENABLED",
1121
+ "live",
1122
+ confirm("machine.admin"),
1123
+ {
1124
+ route: POST("/api/fleet/nodes/{id}/docker/images/{iid}/{action}"),
1125
+ cli: "fleet docker image",
1126
+ waitable: true,
1127
+ confirmationNote: "pull is plain and not destructive; remove and prune confirm"
1128
+ }
1129
+ ),
1130
+ act(
1131
+ "fleet_docker_compose_action",
1132
+ "docker",
1133
+ "FL-09",
1134
+ "FLEET_MACHINE_FACTS_ENABLED",
1135
+ "live",
1136
+ confirm("machine.admin"),
1137
+ {
1138
+ route: POST("/api/fleet/nodes/{id}/docker/compose/{project}/{action}"),
1139
+ cli: "fleet docker compose-action",
1140
+ waitable: true,
1141
+ confirmationNote: "destructive for down"
1142
+ }
1143
+ ),
1144
+ act("fleet_docker_exec", "docker", "FL-09", "FLEET_MACHINE_FACTS_ENABLED", "planned", plain("machine.run"), {
1145
+ phase: "P3",
1146
+ cli: "fleet docker exec"
1147
+ }),
1148
+ // ── ports (FL-10) ──
1149
+ read("fleet_ports_list", "view", "FL-10", "FLEET_MACHINE_FACTS_ENABLED", "live", {
1150
+ route: GET("/api/fleet/nodes/{id}/ports"),
1151
+ cli: "fleet ports list"
1152
+ }),
1153
+ act("fleet_ports_open", "ports", "FL-10", "FLEET_MACHINE_FACTS_ENABLED", "live", plain("machine.run"), {
1154
+ route: POST("/api/fleet/nodes/{id}/ports/{port}/open"),
1155
+ cli: "fleet ports open"
1156
+ }),
1157
+ act("fleet_ports_preview_open", "ports", "FL-10", "FLEET_PORT_TUNNEL_ENABLED", "live", plain("machine.run"), {
1158
+ route: POST("/api/fleet/nodes/{id}/ports/{port}/preview"),
1159
+ cli: "fleet ports preview"
1160
+ }),
1161
+ act("fleet_ports_preview_close", "ports", "FL-10", "FLEET_PORT_TUNNEL_ENABLED", "live", plain("machine.run"), {
1162
+ route: DELETE("/api/fleet/nodes/{id}/ports/{port}/preview"),
1163
+ cli: "fleet ports preview-close"
1164
+ }),
1165
+ // ── files (FL-11) ──
1166
+ // P1 (FL-11 lane log decision 15): the roots read joins the family, and the list's route is the
1167
+ // one FL-11 built (`…/files/list` — `…/files` is the family's prefix, not a route).
1168
+ read("fleet_files_roots", "files", "FL-11", "FLEET_MACHINE_FACTS_ENABLED", "live", {
1169
+ route: GET("/api/fleet/nodes/{id}/files/roots"),
1170
+ cli: "fleet files roots"
1171
+ }),
1172
+ read("fleet_files_list", "files", "FL-11", "FLEET_MACHINE_FACTS_ENABLED", "live", {
1173
+ route: GET("/api/fleet/nodes/{id}/files/list"),
1174
+ cli: "fleet files list"
1175
+ }),
1176
+ read("fleet_files_stat", "files", "FL-11", "FLEET_MACHINE_FACTS_ENABLED", "live", {
1177
+ route: GET("/api/fleet/nodes/{id}/files/stat"),
1178
+ cli: "fleet files stat"
1179
+ }),
1180
+ read("fleet_files_read", "files", "FL-11", "FLEET_MACHINE_FACTS_ENABLED", "planned", {
1181
+ route: GET("/api/fleet/nodes/{id}/files/download"),
1182
+ cli: "fleet files get"
1183
+ }),
1184
+ act("fleet_files_write", "files", "FL-11", "FLEET_MACHINE_FACTS_ENABLED", "planned", confirm("machine.admin"), {
1185
+ route: POST("/api/fleet/nodes/{id}/files/upload"),
1186
+ cli: "fleet files put"
1187
+ }),
1188
+ act("fleet_files_copy", "files", "FL-11", "FLEET_MACHINE_FACTS_ENABLED", "live", confirm("machine.admin"), {
1189
+ route: POST("/api/fleet/nodes/{id}/files/copy"),
1190
+ cli: "fleet files cp",
1191
+ // FL-11 P2 (lane log decision 18): an Agent's copy is held for a person, like its delete.
1192
+ alwaysHeld: true
1193
+ }),
1194
+ act("fleet_files_delete", "files", "FL-11", "FLEET_MACHINE_FACTS_ENABLED", "live", typed("write.destructive"), {
1195
+ route: POST("/api/fleet/nodes/{id}/files/delete"),
1196
+ cli: "fleet files rm",
1197
+ alwaysHeld: true
1198
+ }),
1199
+ // ── commands (FL-12) ──
1200
+ read("fleet_commands_list", "commands", "FL-12", "FLEET_COMMANDS_ENABLED", "live", {
1201
+ route: GET("/api/fleet/commands"),
1202
+ cli: "fleet commands list"
1203
+ }),
1204
+ read("fleet_commands_get", "commands", "FL-12", "FLEET_COMMANDS_ENABLED", "live", {
1205
+ route: GET("/api/fleet/commands/{id}"),
1206
+ cli: "fleet commands get"
1207
+ }),
1208
+ act("fleet_commands_run", "commands", "FL-12", "FLEET_COMMANDS_ENABLED", "live", confirm("machine.run"), {
1209
+ route: POST("/api/fleet/commands"),
1210
+ cli: "fleet commands run",
1211
+ alwaysHeld: true
1212
+ }),
1213
+ act("fleet_commands_cancel", "commands", "FL-12", "FLEET_COMMANDS_ENABLED", "live", plain("machine.run"), {
1214
+ route: POST("/api/fleet/commands/{id}/cancel"),
1215
+ cli: "fleet commands cancel"
1216
+ }),
1217
+ // ── schedules (FL-13 P2: live — `apps/api/src/fleet/schedules/fleet-schedules.controller.ts`) ──
1218
+ read("fleet_schedules_list", "schedules", "FL-13", "FLEET_COMMANDS_ENABLED", "live", {
1219
+ route: GET("/api/fleet/schedules"),
1220
+ cli: "fleet schedules list"
1221
+ }),
1222
+ read("fleet_schedules_get", "schedules", "FL-13", "FLEET_COMMANDS_ENABLED", "live", {
1223
+ route: GET("/api/fleet/schedules/{id}"),
1224
+ cli: "fleet schedules get"
1225
+ }),
1226
+ read("fleet_schedules_runs", "schedules", "FL-13", "FLEET_COMMANDS_ENABLED", "live", {
1227
+ route: GET("/api/fleet/schedules/{id}/runs"),
1228
+ cli: "fleet schedules runs"
1229
+ }),
1230
+ act("fleet_schedules_create", "schedules", "FL-13", "FLEET_COMMANDS_ENABLED", "live", confirm("agent.fanout"), {
1231
+ route: POST("/api/fleet/schedules"),
1232
+ cli: "fleet schedules create"
1233
+ }),
1234
+ act("fleet_schedules_update", "schedules", "FL-13", "FLEET_COMMANDS_ENABLED", "live", confirm("agent.fanout"), {
1235
+ route: PATCH("/api/fleet/schedules/{id}"),
1236
+ cli: "fleet schedules update"
1237
+ }),
1238
+ act(
1239
+ "fleet_schedules_delete",
1240
+ "schedules",
1241
+ "FL-13",
1242
+ "FLEET_COMMANDS_ENABLED",
1243
+ "live",
1244
+ confirm("write.destructive"),
1245
+ { route: DELETE("/api/fleet/schedules/{id}"), cli: "fleet schedules delete" }
1246
+ ),
1247
+ act("fleet_schedules_run", "schedules", "FL-13", "FLEET_COMMANDS_ENABLED", "live", confirm("machine.run"), {
1248
+ route: POST("/api/fleet/schedules/{id}/run"),
1249
+ cli: "fleet schedules run"
1250
+ }),
1251
+ act("fleet_schedules_pause", "schedules", "FL-13", "FLEET_COMMANDS_ENABLED", "live", plain("agent.fanout"), {
1252
+ route: POST("/api/fleet/schedules/{id}/pause"),
1253
+ cli: "fleet schedules pause"
1254
+ }),
1255
+ act("fleet_schedules_resume", "schedules", "FL-13", "FLEET_COMMANDS_ENABLED", "live", plain("agent.fanout"), {
1256
+ route: POST("/api/fleet/schedules/{id}/resume"),
1257
+ cli: "fleet schedules resume"
1258
+ }),
1259
+ // ── checkouts (FL-14, FL-06) ──
1260
+ read("fleet_checkouts_list", "checkouts", "FL-14", "FLEET_CHECKOUTS_ENABLED", "live", {
1261
+ route: GET("/api/fleet/checkouts"),
1262
+ cli: "fleet checkouts list"
1263
+ }),
1264
+ read("fleet_checkouts_get", "checkouts", "FL-14", "FLEET_CHECKOUTS_ENABLED", "live", {
1265
+ route: GET("/api/fleet/checkouts/{id}"),
1266
+ cli: "fleet checkouts get"
1267
+ }),
1268
+ read("fleet_checkouts_changes", "checkouts", "FL-06", "FLEET_CHECKOUTS_ENABLED", "planned", {
1269
+ route: GET("/api/fleet/checkouts/{id}/changes"),
1270
+ cli: "fleet checkouts changes"
1271
+ }),
1272
+ act("fleet_checkouts_create", "checkouts", "FL-14", "FLEET_CHECKOUTS_ENABLED", "live", plain("machine.run"), {
1273
+ route: POST("/api/fleet/checkouts"),
1274
+ cli: "fleet checkouts create",
1275
+ waitable: true
1276
+ }),
1277
+ act("fleet_checkouts_sync", "checkouts", "FL-14", "FLEET_CHECKOUTS_ENABLED", "live", plain("machine.run"), {
1278
+ route: POST("/api/fleet/checkouts/{id}/sync"),
1279
+ cli: "fleet checkouts sync",
1280
+ waitable: true,
1281
+ confirmationNote: "plain for fetch; confirm for pull and push"
1282
+ }),
1283
+ act(
1284
+ "fleet_checkouts_archive",
1285
+ "checkouts",
1286
+ "FL-14",
1287
+ "FLEET_CHECKOUTS_ENABLED",
1288
+ "live",
1289
+ confirm("machine.run", false),
1290
+ { route: POST("/api/fleet/checkouts/{id}/archive"), cli: "fleet checkouts archive" }
1291
+ ),
1292
+ act(
1293
+ "fleet_checkouts_delete",
1294
+ "checkouts",
1295
+ "FL-14",
1296
+ "FLEET_CHECKOUTS_ENABLED",
1297
+ "live",
1298
+ confirm("write.destructive"),
1299
+ {
1300
+ route: DELETE("/api/fleet/checkouts/{id}"),
1301
+ cli: "fleet checkouts delete",
1302
+ confirmationNote: "confirm; confirm-destructive when it has uncommitted changes"
1303
+ }
1304
+ ),
1305
+ act(
1306
+ "fleet_checkouts_open_pull_request",
1307
+ "checkouts",
1308
+ "FL-06",
1309
+ "FLEET_CHECKOUTS_ENABLED",
1310
+ "planned",
1311
+ plain("publish.external"),
1312
+ { route: POST("/api/fleet/checkouts/{id}/pull-request"), cli: "fleet checkouts pull-request" }
1313
+ ),
1314
+ // ── tasks (FL-15) ── the hand-off itself is `fleet_sessions_start` with `taskId`
1315
+ read("fleet_tasks_handoff_options", "sessions", "FL-15", "FLEET_CHECKOUTS_ENABLED", "live", {
1316
+ route: GET("/api/fleet/tasks/{taskId}/handoff-options"),
1317
+ cli: "fleet tasks handoff-options"
1318
+ }),
1319
+ // ── virtual (FL-16) ── P1 shipped: Containers. A create, a stop and a destroy are held for
1320
+ // the owner's approval by the Agent tools (`agent-fleet-virtual-tools.ts`).
1321
+ read("fleet_virtual_list", "view", "FL-16", "FLEET_VIRTUAL_ENABLED", "live", {
1322
+ phase: "P3",
1323
+ route: GET("/api/fleet/nodes/{id}/virtual"),
1324
+ cli: "fleet virtual list"
1325
+ }),
1326
+ read("fleet_virtual_options", "view", "FL-16", "FLEET_VIRTUAL_ENABLED", "live", {
1327
+ phase: "P3",
1328
+ route: GET("/api/fleet/nodes/{id}/virtual/options"),
1329
+ cli: "fleet virtual options"
1330
+ }),
1331
+ act("fleet_virtual_create", "machines", "FL-16", "FLEET_VIRTUAL_ENABLED", "live", confirm("machine.admin"), {
1332
+ phase: "P3",
1333
+ route: POST("/api/fleet/nodes/{id}/virtual"),
1334
+ cli: "fleet virtual create",
1335
+ waitable: true,
1336
+ alwaysHeld: true
1337
+ }),
1338
+ act("fleet_virtual_power", "machines", "FL-16", "FLEET_VIRTUAL_ENABLED", "live", confirm("machine.admin"), {
1339
+ phase: "P3",
1340
+ route: POST("/api/fleet/nodes/{id}/virtual/{childId}/power"),
1341
+ cli: "fleet virtual power",
1342
+ waitable: true,
1343
+ confirmationNote: "plain to start; confirm to stop (an Agent's stop is held for the owner)"
1344
+ }),
1345
+ act("fleet_virtual_destroy", "machines", "FL-16", "FLEET_VIRTUAL_ENABLED", "live", typed("write.destructive"), {
1346
+ phase: "P3",
1347
+ route: POST("/api/fleet/nodes/{id}/virtual/{childId}/destroy"),
1348
+ cli: "fleet virtual destroy",
1349
+ waitable: true,
1350
+ alwaysHeld: true
1351
+ }),
1352
+ // ── cloud (FL-17) ── P1 shipped: providers, create, power, destroy, usage. A create, a power
1353
+ // change and a destroy are held for the owner's approval by the Agent tools
1354
+ // (`agent-fleet-cloud-tools.ts`); the idle policy arrives with P2.
1355
+ read("fleet_cloud_list", "view", "FL-17", "FLEET_CLOUD_ENABLED", "live", {
1356
+ phase: "P3",
1357
+ route: GET("/api/fleet/cloud"),
1358
+ cli: "fleet cloud list"
1359
+ }),
1360
+ read("fleet_cloud_options", "view", "FL-17", "FLEET_CLOUD_ENABLED", "live", {
1361
+ phase: "P3",
1362
+ route: GET("/api/fleet/providers/{plugin}/options"),
1363
+ cli: "fleet cloud options"
1364
+ }),
1365
+ read("fleet_cloud_usage", "view", "FL-17", "FLEET_CLOUD_ENABLED", "live", {
1366
+ phase: "P3",
1367
+ route: GET("/api/fleet/cloud/usage"),
1368
+ cli: "fleet cloud usage"
1369
+ }),
1370
+ act("fleet_cloud_create", "machines", "FL-17", "FLEET_CLOUD_ENABLED", "live", confirm("spend.metered"), {
1371
+ phase: "P3",
1372
+ route: POST("/api/fleet/cloud"),
1373
+ cli: "fleet cloud create",
1374
+ waitable: true,
1375
+ alwaysHeld: true,
1376
+ confirmationNote: "confirm with the price (acknowledgedPriceCents); also machine.admin"
1377
+ }),
1378
+ act("fleet_cloud_power", "machines", "FL-17", "FLEET_CLOUD_ENABLED", "live", confirm("machine.admin"), {
1379
+ phase: "P3",
1380
+ route: POST("/api/fleet/cloud/{id}/power"),
1381
+ cli: "fleet cloud power",
1382
+ waitable: true,
1383
+ alwaysHeld: true
1384
+ }),
1385
+ act("fleet_cloud_destroy", "machines", "FL-17", "FLEET_CLOUD_ENABLED", "live", typed("write.destructive"), {
1386
+ phase: "P3",
1387
+ // FL-17 plan §5 — `DELETE /api/fleet/cloud/{id}` answers the same (an alias).
1388
+ route: POST("/api/fleet/cloud/{id}/destroy"),
1389
+ cli: "fleet cloud destroy",
1390
+ waitable: true,
1391
+ alwaysHeld: true
1392
+ }),
1393
+ act("fleet_cloud_idle_policy", "machines", "FL-17", "FLEET_CLOUD_ENABLED", "planned", plain("machine.admin"), {
1394
+ phase: "P3",
1395
+ route: PATCH("/api/fleet/cloud/{id}/idle-policy"),
1396
+ cli: "fleet cloud idle-policy"
1397
+ }),
1398
+ // ── runners (FL-18) ──
1399
+ read("fleet_runners_list", "view", "FL-18", "FLEET_ACTIONS_RUNNERS_ENABLED", "planned", {
1400
+ phase: "P3",
1401
+ route: GET("/api/fleet/nodes/{id}/runners"),
1402
+ cli: "fleet runners list"
1403
+ }),
1404
+ read("fleet_runners_jobs", "view", "FL-18", "FLEET_ACTIONS_RUNNERS_ENABLED", "planned", {
1405
+ phase: "P3",
1406
+ route: GET("/api/fleet/runners/jobs"),
1407
+ cli: "fleet runners jobs"
1408
+ }),
1409
+ act(
1410
+ "fleet_runners_install",
1411
+ "machines",
1412
+ "FL-18",
1413
+ "FLEET_ACTIONS_RUNNERS_ENABLED",
1414
+ "planned",
1415
+ confirm("machine.admin"),
1416
+ { phase: "P3", route: POST("/api/fleet/nodes/{id}/runners"), cli: "fleet runners install", waitable: true }
1417
+ ),
1418
+ act(
1419
+ "fleet_runners_action",
1420
+ "machines",
1421
+ "FL-18",
1422
+ "FLEET_ACTIONS_RUNNERS_ENABLED",
1423
+ "planned",
1424
+ confirm("machine.admin"),
1425
+ {
1426
+ phase: "P3",
1427
+ route: POST("/api/fleet/nodes/{id}/runners/{runnerId}/{action}"),
1428
+ cli: "fleet runners action",
1429
+ waitable: true,
1430
+ confirmationNote: "plain to start; confirm to stop and restart"
1431
+ }
1432
+ ),
1433
+ act(
1434
+ "fleet_runners_remove",
1435
+ "machines",
1436
+ "FL-18",
1437
+ "FLEET_ACTIONS_RUNNERS_ENABLED",
1438
+ "planned",
1439
+ typed("write.destructive"),
1440
+ { phase: "P3", route: DELETE("/api/fleet/nodes/{id}/runners/{runnerId}"), cli: "fleet runners remove" }
1441
+ ),
1442
+ act(
1443
+ "fleet_runners_cancel_run",
1444
+ "machines",
1445
+ "FL-18",
1446
+ "FLEET_ACTIONS_RUNNERS_ENABLED",
1447
+ "planned",
1448
+ confirm("machine.admin"),
1449
+ { phase: "P3", route: POST("/api/fleet/runners/jobs/{jobId}/cancel"), cli: "fleet runners cancel-run" }
1450
+ ),
1451
+ // ── usage (FL-20) ──
1452
+ read("fleet_usage_get", "view", "FL-20", "FLEET_USAGE_SCAN_ENABLED", "planned", {
1453
+ route: GET("/api/fleet/usage"),
1454
+ cli: "fleet usage"
1455
+ }),
1456
+ // ── operations (FL-02, FL-19) ──
1457
+ read("fleet_operations_get", "view", "FL-02", "FLEET_NODE_LINK_ENABLED", "live", {
1458
+ route: GET("/api/fleet/operations/{id}"),
1459
+ cli: "fleet operations get"
1460
+ }),
1461
+ read("fleet_operations_list", "view", "FL-19", "FLEET_NODE_LINK_ENABLED", "live", {
1462
+ route: GET("/api/fleet/operations"),
1463
+ cli: "fleet operations list"
1464
+ }),
1465
+ act("fleet_operations_cancel", "view", "FL-02", "FLEET_NODE_LINK_ENABLED", "live", plain("machine.run"), {
1466
+ route: DELETE("/api/fleet/operations/{id}"),
1467
+ cli: "fleet operations cancel"
1468
+ })
1469
+ ]);
1470
+ new Map(
1471
+ FLEET_TOOL_CATALOGUE.map((entry) => [entry.name, entry])
1472
+ );
1473
+ var FLEET_VIRTUAL_SYSTEMS = [
1474
+ {
1475
+ id: "windows-11",
1476
+ kind: "vm",
1477
+ label: "Windows 11",
1478
+ family: "windows",
1479
+ arch: ["x64"],
1480
+ windowsEdition: "11",
1481
+ approxDiskGiB: 64,
1482
+ approxDownloadGiB: 6
1483
+ },
1484
+ {
1485
+ id: "windows-10",
1486
+ kind: "vm",
1487
+ label: "Windows 10",
1488
+ family: "windows",
1489
+ arch: ["x64"],
1490
+ windowsEdition: "10",
1491
+ approxDiskGiB: 64,
1492
+ approxDownloadGiB: 6
1493
+ },
1494
+ {
1495
+ id: "windows-server-2025",
1496
+ kind: "vm",
1497
+ label: "Windows Server 2025",
1498
+ family: "windows",
1499
+ arch: ["x64"],
1500
+ windowsEdition: "2025",
1501
+ approxDiskGiB: 64,
1502
+ approxDownloadGiB: 6
1503
+ },
1504
+ {
1505
+ id: "windows-server-2022",
1506
+ kind: "vm",
1507
+ label: "Windows Server 2022",
1508
+ family: "windows",
1509
+ arch: ["x64"],
1510
+ windowsEdition: "2022",
1511
+ approxDiskGiB: 64,
1512
+ approxDownloadGiB: 6
1513
+ },
1514
+ {
1515
+ id: "ubuntu-26.04",
1516
+ kind: "container",
1517
+ label: "Ubuntu 26.04",
1518
+ family: "ubuntu",
1519
+ arch: ["x64", "arm64"],
1520
+ approxDiskGiB: 3,
1521
+ approxDownloadGiB: 0.5
1522
+ },
1523
+ {
1524
+ id: "ubuntu-24.04",
1525
+ kind: "container",
1526
+ label: "Ubuntu 24.04",
1527
+ family: "ubuntu",
1528
+ arch: ["x64", "arm64"],
1529
+ approxDiskGiB: 3,
1530
+ approxDownloadGiB: 0.5
1531
+ },
1532
+ {
1533
+ id: "debian-13",
1534
+ kind: "container",
1535
+ label: "Debian 13",
1536
+ family: "debian",
1537
+ arch: ["x64", "arm64"],
1538
+ approxDiskGiB: 3,
1539
+ approxDownloadGiB: 0.5
1540
+ },
1541
+ {
1542
+ id: "fedora",
1543
+ kind: "container",
1544
+ label: "Fedora",
1545
+ family: "fedora",
1546
+ arch: ["x64", "arm64"],
1547
+ approxDiskGiB: 3,
1548
+ approxDownloadGiB: 0.6
1549
+ },
1550
+ {
1551
+ id: "alpine",
1552
+ kind: "container",
1553
+ label: "Alpine",
1554
+ family: "alpine",
1555
+ arch: ["x64", "arm64"],
1556
+ approxDiskGiB: 1,
1557
+ approxDownloadGiB: 0.2
1558
+ },
1559
+ {
1560
+ // Arch Linux publishes no official arm64 image (FR-6).
1561
+ id: "arch",
1562
+ kind: "container",
1563
+ label: "Arch Linux",
1564
+ family: "arch",
1565
+ arch: ["x64"],
1566
+ approxDiskGiB: 3,
1567
+ approxDownloadGiB: 0.7
1568
+ }
1569
+ ];
1570
+ FLEET_VIRTUAL_SYSTEMS.map((system) => system.id);
724
1571
  var EMAIL_INBOX_CAP_FIELDS = [
725
1572
  "inboxDailySends",
726
1573
  "inboxBurstSends",