@feastalytics/cli 0.1.2 → 0.1.4

package/dist/cli.js

@@ -8656,146 +8656,6 @@ function errorMessage(error) {
 // src/main.ts
 import fs2 from "fs";
 
-// src/browserLogin.ts
-import { spawn } from "child_process";
-import { createHash, randomBytes } from "crypto";
-import http from "http";
-var CALLBACK_TIMEOUT_MS = 5 * 60 * 1e3;
-function base64url(buffer) {
-  return buffer.toString("base64url");
-}
-function tabHtml(title, body) {
-  return `<!doctype html><html><head><meta charset="utf-8"><title>${title}</title>
-<style>body{font-family:-apple-system,system-ui,sans-serif;background:#0f0f0f;color:#f5f5f5;
-display:flex;min-height:100vh;align-items:center;justify-content:center;margin:0}
-.card{text-align:center;padding:2rem 3rem}.t{font-size:1.4rem;font-weight:600;margin-bottom:.5rem}
-.b{color:#a1a1a1}</style></head><body><div class="card">
-<div class="t">${title}</div><div class="b">${body}</div></div></body></html>`;
-}
-function openBrowser(url) {
-  let command;
-  let args;
-  if (process.platform === "darwin") {
-    command = "open";
-    args = [url];
-  } else if (process.platform === "win32") {
-    command = "cmd";
-    args = ["/c", "start", "", url];
-  } else {
-    command = "xdg-open";
-    args = [url];
-  }
-  try {
-    const child = spawn(command, args, { stdio: "ignore", detached: true });
-    child.on("error", () => {
-    });
-    child.unref();
-  } catch {
-  }
-}
-function startLoopback(expectedState) {
-  return new Promise((resolveOuter, rejectOuter) => {
-    let resolveCode = () => {
-    };
-    let rejectCode = () => {
-    };
-    const waitForCode = new Promise((resolve, reject) => {
-      resolveCode = resolve;
-      rejectCode = reject;
-    });
-    waitForCode.catch(() => {
-    });
-    const server = http.createServer((req, res) => {
-      const url = new URL(req.url ?? "/", "http://127.0.0.1");
-      if (url.pathname !== "/callback") {
-        res.writeHead(404);
-        res.end();
-        return;
-      }
-      const error = url.searchParams.get("error");
-      if (error != null) {
-        res.writeHead(200, { "Content-Type": "text/html" });
-        res.end(tabHtml("Authorization declined", "You can close this tab."));
-        rejectCode(new Error(`Authorization declined: ${error}`));
-        return;
-      }
-      if (url.searchParams.get("state") !== expectedState) {
-        res.writeHead(400, { "Content-Type": "text/html" });
-        res.end(
-          tabHtml("Invalid request", "State mismatch \u2014 retry from the CLI.")
-        );
-        rejectCode(new Error("State mismatch \u2014 aborting (possible CSRF)"));
-        return;
-      }
-      const code = url.searchParams.get("code");
-      if (code == null || code.length === 0) {
-        res.writeHead(400);
-        res.end();
-        rejectCode(new Error("Authorization callback did not include a code"));
-        return;
-      }
-      res.writeHead(200, {
-        "Content-Type": "text/html",
-        Connection: "close"
-      });
-      res.end(
-        tabHtml(
-          "You're all set \u2713",
-          "The feast CLI is authorized. Close this tab and return to your terminal."
-        )
-      );
-      resolveCode(code);
-    });
-    const timeout = setTimeout(() => {
-      rejectCode(
-        new Error("Timed out waiting for browser authorization (5 minutes)")
-      );
-    }, CALLBACK_TIMEOUT_MS);
-    const close = () => {
-      clearTimeout(timeout);
-      server.closeAllConnections?.();
-      server.close();
-    };
-    server.on("error", rejectOuter);
-    server.listen(0, "127.0.0.1", () => {
-      server.unref();
-      const address = server.address();
-      const port = typeof address === "object" && address != null ? address.port : 0;
-      resolveOuter({ port, waitForCode, close });
-    });
-  });
-}
-async function browserLogin() {
-  const codeVerifier = base64url(randomBytes(32));
-  const codeChallenge = base64url(
-    createHash("sha256").update(codeVerifier).digest()
-  );
-  const state = base64url(randomBytes(16));
-  const { port, waitForCode, close } = await startLoopback(state);
-  try {
-    const authUrl = `${getWebBaseUrl()}/oauth?port=${port}&state=${encodeURIComponent(state)}&challenge=${encodeURIComponent(codeChallenge)}`;
-    console.error("Opening your browser to authorize the feast CLI...");
-    console.error(`If it doesn't open, visit:
-  ${authUrl}
-`);
-    openBrowser(authUrl);
-    const code = await waitForCode;
-    const client = createHttpCaller({});
-    const response = await client.api.auth.exchangeAuthCode.mutate({
-      code,
-      codeVerifier
-    });
-    const tokens = response?.tokens;
-    if (tokens?.accessToken?.jwtToken == null) {
-      throw new Error("Authorization failed: empty token response");
-    }
-    saveTokens(tokens);
-    return tokens;
-  } finally {
-    close();
-  }
-}
-
 // src/generated/manifest.ts
 var CLI_MANIFEST = {
   "awsAccountId": "891817334910",
@@ -10807,6 +10667,37 @@ var CLI_MANIFEST = {
         "$schema": "http://json-schema.org/draft-07/schema#"
       }
     },
+    {
+      "id": "createMembersProgramReward",
+      "domain": "membersProgram",
+      "description": "Create a members program reward. The name is matched against the organization's catalog items: an exact match is reused (and its staff instructions updated when you pass staffInstructions), otherwise a new catalog item is created. Pass pointsCost to make the reward redeemable by guests spending points; omit it for a reward that is granted by an automation instead. A reward with no awardReward automation and no pointsCost can never reach a guest, so pair it with an automation via createAutomation.",
+      "needsApproval": false,
+      "type": "mutation",
+      "path": [
+        "api",
+        "membersProgram",
+        "createReward"
+      ],
+      "inputJsonSchema": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string"
+          },
+          "staffInstructions": {
+            "type": "string"
+          },
+          "pointsCost": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "name"
+        ],
+        "additionalProperties": false,
+        "$schema": "http://json-schema.org/draft-07/schema#"
+      }
+    },
     {
       "id": "deleteAutomationFlow",
       "domain": "automations",
@@ -10879,7 +10770,8 @@ var CLI_MANIFEST = {
               "funnel",
               "organizationFilePublic",
               "organizationFilePrivate",
-              "creativeLibrary"
+              "creativeLibrary",
+              "creativeLibraryBroll"
             ]
           },
           "key": {
@@ -11360,7 +11252,7 @@ var CLI_MANIFEST = {
     {
       "id": "getMediaUploadUrl",
       "domain": "core",
-      "description": "Get a presigned S3 upload URL for a media file in a given scope (passBuilder, funnel, organizationFilePublic, organizationFilePrivate, creativeLibrary). Set cropped to store a cropped variant under the scope's cropped/ subfolder. PUT the file bytes to the returned presignedUrl, then reference the returned url/key.",
+      "description": "Get a presigned S3 upload URL for a media file in a given scope (passBuilder, funnel, organizationFilePublic, organizationFilePrivate, creativeLibrary, creativeLibraryBroll). Set cropped to store a cropped variant under the scope's cropped/ subfolder. PUT the file bytes to the returned presignedUrl, then reference the returned url/key.",
       "needsApproval": false,
       "type": "mutation",
       "path": [
@@ -11378,7 +11270,8 @@ var CLI_MANIFEST = {
               "funnel",
               "organizationFilePublic",
               "organizationFilePrivate",
-              "creativeLibrary"
+              "creativeLibrary",
+              "creativeLibraryBroll"
             ]
           },
           "fileName": {
@@ -11581,7 +11474,7 @@ var CLI_MANIFEST = {
     {
       "id": "listMedia",
       "domain": "core",
-      "description": "List uploaded media files for the organization across one or more scopes (passBuilder, funnel, organizationFilePublic, organizationFilePrivate, creativeLibrary). Each file is tagged with its scope and a canDelete flag. Set mediaOnly to return only image/video files. Set cropped to list the cropped variants (each scope's cropped/ subfolder) instead of the base files.",
+      "description": "List uploaded media files for the organization across one or more scopes (passBuilder, funnel, organizationFilePublic, organizationFilePrivate, creativeLibrary, creativeLibraryBroll). Each file is tagged with its scope and a canDelete flag. Set mediaOnly to return only image/video files. Set cropped to list the cropped variants (each scope's cropped/ subfolder) instead of the base files.",
       "needsApproval": false,
       "type": "query",
       "path": [
@@ -11601,7 +11494,8 @@ var CLI_MANIFEST = {
                 "funnel",
                 "organizationFilePublic",
                 "organizationFilePrivate",
-                "creativeLibrary"
+                "creativeLibrary",
+                "creativeLibraryBroll"
               ]
             },
             "minItems": 1
@@ -11620,6 +11514,25 @@ var CLI_MANIFEST = {
         "$schema": "http://json-schema.org/draft-07/schema#"
       }
     },
+    {
+      "id": "listMembersProgramRewards",
+      "domain": "membersProgram",
+      "description": "List the organization's members program rewards, each with its catalog item name, staff instructions, and points cost. A reward with a pointsCost is redeemable by guests spending points; one without is granted by an automation. To find orphaned rewards \u2014 rewards nothing ever awards \u2014 call listAutomations and check which itemIds appear in an awardReward action.",
+      "needsApproval": false,
+      "type": "query",
+      "path": [
+        "api",
+        "membersProgram",
+        "listRewards"
+      ],
+      "inputJsonSchema": {
+        "type": "object",
+        "properties": {},
+        "additionalProperties": false,
+        "default": {},
+        "$schema": "http://json-schema.org/draft-07/schema#"
+      }
+    },
     {
       "id": "loadCurrentOrganization",
       "domain": "core",
@@ -11734,6 +11647,32 @@ var CLI_MANIFEST = {
         "$schema": "http://json-schema.org/draft-07/schema#"
       }
     },
+    {
+      "id": "previewFunnelDraft",
+      "domain": "funnel",
+      "description": "Render every screen of a funnel draft to a PDF (one screen per page, mobile viewport) and return a short-lived download URL. Open drafts render with their staged edits applied; promoted drafts render the live funnel. Fetch the returned URL with web_fetch to visually inspect the screens.",
+      "needsApproval": false,
+      "type": "mutation",
+      "path": [
+        "api",
+        "layoutEngine",
+        "drafts",
+        "preview"
+      ],
+      "inputJsonSchema": {
+        "type": "object",
+        "properties": {
+          "draftId": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "draftId"
+        ],
+        "additionalProperties": false,
+        "$schema": "http://json-schema.org/draft-07/schema#"
+      }
+    },
     {
       "id": "queryData",
       "domain": "data",
@@ -11912,10 +11851,29 @@ Filter leaves are one column each, written as the column name prefixed with $, c
         "$schema": "http://json-schema.org/draft-07/schema#"
       }
     },
+    {
+      "id": "readPassConfiguration",
+      "domain": "passBuilder",
+      "description": "Read the organization's live wallet pass configuration: sections (the pass content fields), features, locations, metadata, and the current version number. Returns null when the organization has never saved a pass configuration. Read this before changing the pass \u2014 savePassConfiguration is a full-document save, so the returned document is the starting point you modify.",
+      "needsApproval": false,
+      "type": "query",
+      "path": [
+        "api",
+        "passBuilder",
+        "get"
+      ],
+      "inputJsonSchema": {
+        "type": "object",
+        "properties": {},
+        "additionalProperties": false,
+        "default": {},
+        "$schema": "http://json-schema.org/draft-07/schema#"
+      }
+    },
     {
       "id": "saveFunnelEdits",
       "domain": "funnel",
-      "description": "Apply funnel edits to production and save. Accepts either a draftId (applies the draft's staged edits, then marks it promoted) or an inline edits array. This writes to the live funnel.",
+      "description": "Apply funnel edits to production and save. Accepts either a draftId (applies the draft's staged edits, creates any screens staged with stageFunnelScreen, then marks it promoted) or an inline edits array. This writes to the live funnel.",
       "needsApproval": true,
       "type": "mutation",
       "path": [
@@ -13683,52 +13641,1473 @@ Filter leaves are one column each, written as the column name prefixed with $, c
       }
     },
     {
-      "id": "searchUsers",
-      "domain": "membersProgram",
-      "description": "Search and explore members (loyalty guests) and their activity. Returns a page of the most recent user events, one per member, each carrying the member's serialNumber plus event details (type, time, and related object). Filters: query (free-text name search), eventTypes (e.g. sentText, receivedText, scan, order, rewardAwarded, rewardRedeemed, checkout, and the *Attribution types), progressMinBound/progressMaxBound (visit-count range), isUnread=true (members with unanswered inbound texts), orderBy (ASC|DESC by event time). Paginate with limit (default 100) and cursor (the `cursor` returned by the previous call; undefined cursor means no more pages).",
-      "needsApproval": false,
-      "type": "query",
+      "id": "savePassConfiguration",
+      "domain": "passBuilder",
+      "description": "Save the organization's wallet pass configuration. This is a full-document save, not a patch: send the complete configuration, so the normal flow is readPassConfiguration, modify the returned document, then save it back. Anything you omit is dropped. Each save appends a new version rather than editing the current one, and when the sections, features, or locations differ from the previous version every pass already in a guest's wallet is re-pushed with the new design.",
+      "needsApproval": true,
+      "type": "mutation",
       "path": [
         "api",
-        "loyalty",
-        "app",
-        "searchUsersV3"
+        "passBuilder",
+        "create"
       ],
       "inputJsonSchema": {
         "type": "object",
         "properties": {
-          "cursor": {
-            "type": "number"
-          },
-          "eventTypes": {
-            "type": "array",
-            "items": {
-              "type": "string",
-              "enum": [
-                "sentText",
-                "receivedText",
-                "scan",
-                "order",
-                "passCreated",
-                "passUpdated",
-                "passRegistered",
-                "passDeleted",
-                "rewardAwarded",
-                "rewardRedeemed",
-                "rewardExpiration",
-                "fbAttribution",
-                "influencerAttribution",
-                "tiktokAttribution",
-                "googleAttribution",
-                "miscAttribution",
-                "referralAttribution",
-                "checkout",
-                "customerInference",
-                "reservationCreated"
-              ]
-            }
-          },
-          "limit": {
+          "sections": {
+            "type": "object",
+            "properties": {
+              "headerFields": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "key": {
+                      "type": "string"
+                    },
+                    "label": {
+                      "type": "string"
+                    },
+                    "valueRules": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "ruleId": {
+                            "type": "string"
+                          },
+                          "conditions": {
+                            "type": "array",
+                            "items": {
+                              "anyOf": [
+                                {
+                                  "type": "object",
+                                  "properties": {
+                                    "type": {
+                                      "type": "string",
+                                      "const": "event"
+                                    },
+                                    "event": {
+                                      "type": "object",
+                                      "properties": {
+                                        "event": {
+                                          "anyOf": [
+                                            {
+                                              "type": "object",
+                                              "properties": {
+                                                "type": {
+                                                  "type": "string",
+                                                  "const": "receiveAutomation"
+                                                },
+                                                "receiveAutomation": {
+                                                  "type": "object",
+                                                  "properties": {
+                                                    "automationId": {
+                                                      "type": "string"
+                                                    }
+                                                  },
+                                                  "additionalProperties": false
+                                                }
+                                              },
+                                              "required": [
+                                                "type",
+                                                "receiveAutomation"
+                                              ],
+                                              "additionalProperties": false
+                                            },
+                                            {
+                                              "type": "object",
+                                              "properties": {
+                                                "type": {
+                                                  "type": "string",
+                                                  "const": "reply"
+                                                },
+                                                "reply": {
+                                                  "type": "object",
+                                                  "properties": {
+                                                    "automationId": {
+                                                      "type": "string"
+                                                    },
+                                                    "keywords": {
+                                                      "type": "array",
+                                                      "items": {
+                                                        "type": "string"
+                                                      }
+                                                    }
+                                                  },
+                                                  "additionalProperties": false
+                                                }
+                                              },
+                                              "required": [
+                                                "type",
+                                                "reply"
+                                              ],
+                                              "additionalProperties": false
+                                            },
+                                            {
+                                              "type": "object",
+                                              "properties": {
+                                                "type": {
+                                                  "type": "string",
+                                                  "const": "signUp"
+                                                }
+                                              },
+                                              "required": [
+                                                "type"
+                                              ],
+                                              "additionalProperties": false
+                                            },
+                                            {
+                                              "type": "object",
+                                              "properties": {
+                                                "type": {
+                                                  "type": "string",
+                                                  "const": "importedCustomer"
+                                                }
+                                              },
+                                              "required": [
+                                                "type"
+                                              ],
+                                              "additionalProperties": false
+                                            },
+                                            {
+                                              "type": "object",
+                                              "properties": {
+                                                "type": {
+                                                  "type": "string",
+                                                  "const": "addPass"
+                                                }
+                                              },
+                                              "required": [
+                                                "type"
+                                              ],
+                                              "additionalProperties": false
+                                            },
+                                            {
+                                              "type": "object",
+                                              "properties": {
+                                                "type": {
+                                                  "type": "string",
+                                                  "const": "visit"
+                                                },
+                                                "visit": {
+                                                  "type": "object",
+                                                  "properties": {
+                                                    "locationId": {
+                                                      "type": "string"
+                                                    }
+                                                  },
+                                                  "additionalProperties": false
+                                                }
+                                              },
+                                              "required": [
+                                                "type"
+                                              ],
+                                              "additionalProperties": false
+                                            },
+                                            {
+                                              "type": "object",
+                                              "properties": {
+                                                "type": {
+                                                  "type": "string",
+                                                  "const": "viewCampaign"
+                                                },
+                                                "viewCampaign": {
+                                                  "type": "object",
+                                                  "properties": {
+                                                    "campaignId": {
+                                                      "type": "string"
+                                                    }
+                                                  },
+                                                  "additionalProperties": false
+                                                }
+                                              },
+                                              "required": [
+                                                "type",
+                                                "viewCampaign"
+                                              ],
+                                              "additionalProperties": false
+                                            },
+                                            {
+                                              "type": "object",
+                                              "properties": {
+                                                "type": {
+                                                  "type": "string",
+                                                  "const": "offerRedemption"
+                                                },
+                                                "offerRedemption": {
+                                                  "type": "object",
+                                                  "properties": {
+                                                    "campaignId": {
+                                                      "type": "string"
+                                                    },
+                                                    "promoId": {
+                                                      "type": "string"
+                                                    },
+                                                    "offerId": {
+                                                      "type": "string"
+                                                    }
+                                                  },
+                                                  "additionalProperties": false
+                                                }
+                                              },
+                                              "required": [
+                                                "type"
+                                              ],
+                                              "additionalProperties": false
+                                            },
+                                            {
+                                              "type": "object",
+                                              "properties": {
+                                                "type": {
+                                                  "type": "string",
+                                                  "const": "offerExpiration"
+                                                },
+                                                "offerExpiration": {
+                                                  "type": "object",
+                                                  "properties": {
+                                                    "campaignId": {
+                                                      "type": "string"
+                                                    },
+                                                    "promoId": {
+                                                      "type": "string"
+                                                    },
+                                                    "offerId": {
+                                                      "type": "string"
+                                                    }
+                                                  },
+                                                  "additionalProperties": false
+                                                }
+                                              },
+                                              "required": [
+                                                "type",
+                                                "offerExpiration"
+                                              ],
+                                              "additionalProperties": false
+                                            },
+                                            {
+                                              "type": "object",
+                                              "properties": {
+                                                "type": {
+                                                  "type": "string",
+                                                  "const": "checkout"
+                                                },
+                                                "checkout": {
+                                                  "type": "object",
+                                                  "properties": {
+                                                    "promoId": {
+                                                      "type": "string"
+                                                    },
+                                                    "campaignId": {
+                                                      "type": "string"
+                                                    }
+                                                  },
+                                                  "additionalProperties": false
+                                                }
+                                              },
+                                              "required": [
+                                                "type",
+                                                "checkout"
+                                              ],
+                                              "additionalProperties": false
+                                            },
+                                            {
+                                              "type": "object",
+                                              "properties": {
+                                                "type": {
+                                                  "type": "string",
+                                                  "const": "buttonClick"
+                                                },
+                                                "buttonClick": {
+                                                  "type": "object",
+                                                  "properties": {
+                                                    "buttonId": {
+                                                      "type": "string"
+                                                    },
+                                                    "eventName": {
+                                                      "type": "string"
+                                                    }
+                                                  },
+                                                  "required": [
+                                                    "buttonId",
+                                                    "eventName"
+                                                  ],
+                                                  "additionalProperties": false
+                                                }
+                                              },
+                                              "required": [
+                                                "type",
+                                                "buttonClick"
+                                              ],
+                                              "additionalProperties": false
+                                            },
+                                            {
+                                              "type": "object",
+                                              "properties": {
+                                                "type": {
+                                                  "type": "string",
+                                                  "const": "formSubmission"
+                                                }
+                                              },
+                                              "required": [
+                                                "type"
+                                              ],
+                                              "additionalProperties": false
+                                            },
+                                            {
+                                              "type": "object",
+                                              "properties": {
+                                                "type": {
+                                                  "type": "string",
+                                                  "const": "invalidScan"
+                                                }
+                                              },
+                                              "required": [
+                                                "type"
+                                              ],
+                                              "additionalProperties": false
+                                            },
+                                            {
+                                              "type": "object",
+                                              "properties": {
+                                                "type": {
+                                                  "type": "string",
+                                                  "const": "gotReferred"
+                                                }
+                                              },
+                                              "required": [
+                                                "type"
+                                              ],
+                                              "additionalProperties": false
+                                            },
+                                            {
+                                              "type": "object",
+                                              "properties": {
+                                                "type": {
+                                                  "type": "string",
+                                                  "const": "referred"
+                                                }
+                                              },
+                                              "required": [
+                                                "type"
+                                              ],
+                                              "additionalProperties": false
+                                            },
+                                            {
+                                              "type": "object",
+                                              "properties": {
+                                                "type": {
+                                                  "type": "string",
+                                                  "const": "subscriptionRenewal"
+                                                },
+                                                "subscriptionRenewal": {
+                                                  "type": "object",
+                                                  "properties": {
+                                                    "campaignId": {
+                                                      "type": "string"
+                                                    }
+                                                  },
+                                                  "additionalProperties": false
+                                                }
+                                              },
+                                              "required": [
+                                                "type"
+                                              ],
+                                              "additionalProperties": false
+                                            },
+                                            {
+                                              "type": "object",
+                                              "properties": {
+                                                "type": {
+                                                  "type": "string",
+                                                  "const": "pickupDate"
+                                                },
+                                                "pickupDate": {
+                                                  "type": "object",
+                                                  "properties": {
+                                                    "campaignId": {
+                                                      "type": "string"
+                                                    }
+                                                  },
+                                                  "additionalProperties": false
+                                                }
+                                              },
+                                              "required": [
+                                                "type"
+                                              ],
+                                              "additionalProperties": false
+                                            }
+                                          ]
+                                        },
+                                        "occur": {
+                                          "anyOf": [
+                                            {
+                                              "type": "object",
+                                              "properties": {
+                                                "match": {
+                                                  "type": "string",
+                                                  "enum": [
+                                                    "GTE",
+                                                    "LTE",
+                                                    "EQ"
+                                                  ]
+                                                },
+                                                "duration": {
+                                                  "type": "number",
+                                                  "description": "Duration in milliseconds"
+                                                }
+                                              },
+                                              "required": [
+                                                "match",
+                                                "duration"
+                                              ],
+                                              "additionalProperties": false,
+                                              "description": "Time-based occur. Use match (GTE/LTE/EQ) and duration (ms). No 'relative' type."
+                                            },
+                                            {
+                                              "type": "object",
+                                              "properties": {
+                                                "type": {
+                                                  "type": "string",
+                                                  "const": "today"
+                                                }
+                                              },
+                                              "required": [
+                                                "type"
+                                              ],
+                                              "additionalProperties": false
+                                            }
+                                          ]
+                                        }
+                                      },
+                                      "required": [
+                                        "event"
+                                      ],
+                                      "additionalProperties": false,
+                                      "description": "Nested: event.event is the AutomationEvent, event.occur is optional. NOT flat event/occur at top level."
+                                    }
+                                  },
+                                  "required": [
+                                    "type",
+                                    "event"
+                                  ],
+                                  "additionalProperties": false
+                                },
+                                {
+                                  "type": "object",
+                                  "properties": {
+                                    "type": {
+                                      "type": "string",
+                                      "const": "operatingSystem"
+                                    },
+                                    "operatingSystem": {
+                                      "type": "object",
+                                      "properties": {
+                                        "os": {
+                                          "type": "string",
+                                          "enum": [
+                                            "ios",
+                                            "android"
+                                          ]
+                                        }
+                                      },
+                                      "required": [
+                                        "os"
+                                      ],
+                                      "additionalProperties": false
+                                    }
+                                  },
+                                  "required": [
+                                    "type",
+                                    "operatingSystem"
+                                  ],
+                                  "additionalProperties": false
+                                },
+                                {
+                                  "type": "object",
+                                  "properties": {
+                                    "type": {
+                                      "type": "string",
+                                      "const": "and"
+                                    },
+                                    "conditions": {
+                                      "type": "array",
+                                      "items": {
+                                        "$ref": "#/properties/sections/properties/headerFields/items/properties/valueRules/items/properties/conditions/items"
+                                      }
+                                    }
+                                  },
+                                  "required": [
+                                    "type",
+                                    "conditions"
+                                  ],
+                                  "additionalProperties": false
+                                },
+                                {
+                                  "type": "object",
+                                  "properties": {
+                                    "type": {
+                                      "type": "string",
+                                      "const": "or"
+                                    },
+                                    "conditions": {
+                                      "type": "array",
+                                      "items": {
+                                        "$ref": "#/properties/sections/properties/headerFields/items/properties/valueRules/items/properties/conditions/items"
+                                      }
+                                    }
+                                  },
+                                  "required": [
+                                    "type",
+                                    "conditions"
+                                  ],
+                                  "additionalProperties": false
+                                },
+                                {
+                                  "type": "object",
+                                  "properties": {
+                                    "type": {
+                                      "type": "string",
+                                      "const": "not"
+                                    },
+                                    "condition": {
+                                      "$ref": "#/properties/sections/properties/headerFields/items/properties/valueRules/items/properties/conditions/items"
+                                    }
+                                  },
+                                  "required": [
+                                    "type",
+                                    "condition"
+                                  ],
+                                  "additionalProperties": false
+                                },
+                                {
+                                  "type": "object",
+                                  "properties": {
+                                    "type": {
+                                      "type": "string",
+                                      "const": "progress"
+                                    },
+                                    "progress": {
+                                      "anyOf": [
+                                        {
+                                          "type": "object",
+                                          "properties": {
+                                            "type": {
+                                              "type": "string",
+                                              "const": "divisible"
+                                            },
+                                            "divisible": {
+                                              "type": "object",
+                                              "properties": {
+                                                "offset": {
+                                                  "type": "number"
+                                                },
+                                                "step": {
+                                                  "type": "number"
+                                                }
+                                              },
+                                              "required": [
+                                                "offset",
+                                                "step"
+                                              ],
+                                              "additionalProperties": false
+                                            }
+                                          },
+                                          "required": [
+                                            "type",
+                                            "divisible"
+                                          ],
+                                          "additionalProperties": false
+                                        },
+                                        {
+                                          "type": "object",
+                                          "properties": {
+                                            "type": {
+                                              "type": "string",
+                                              "const": "match"
+                                            },
+                                            "match": {
+                                              "type": "object",
+                                              "properties": {
+                                                "match": {
+                                                  "type": "string",
+                                                  "enum": [
+                                                    "GTE",
+                                                    "LTE",
+                                                    "EQ"
+                                                  ]
+                                                },
+                                                "value": {
+                                                  "type": "number"
+                                                }
+                                              },
+                                              "required": [
+                                                "match",
+                                                "value"
+                                              ],
+                                              "additionalProperties": false
+                                            }
+                                          },
+                                          "required": [
+                                            "type",
+                                            "match"
+                                          ],
+                                          "additionalProperties": false
+                                        }
+                                      ]
+                                    }
+                                  },
+                                  "required": [
+                                    "type",
+                                    "progress"
+                                  ],
+                                  "additionalProperties": false
+                                },
+                                {
+                                  "type": "object",
+                                  "properties": {
+                                    "type": {
+                                      "type": "string",
+                                      "const": "passSubType"
+                                    },
+                                    "passSubType": {
+                                      "type": "object",
+                                      "properties": {
+                                        "identifier": {
+                                          "type": "string"
+                                        }
+                                      },
+                                      "required": [
+                                        "identifier"
+                                      ],
+                                      "additionalProperties": false
+                                    }
+                                  },
+                                  "required": [
+                                    "type",
+                                    "passSubType"
+                                  ],
+                                  "additionalProperties": false
+                                },
+                                {
+                                  "type": "object",
+                                  "properties": {
+                                    "type": {
+                                      "type": "string",
+                                      "const": "cohort"
+                                    },
+                                    "cohort": {
+                                      "anyOf": [
+                                        {
+                                          "type": "object",
+                                          "properties": {
+                                            "type": {
+                                              "type": "string",
+                                              "const": "specific"
+                                            },
+                                            "specific": {
+                                              "type": "object",
+                                              "properties": {
+                                                "cohort": {
+                                                  "type": "string"
+                                                },
+                                                "step": {
+                                                  "type": "string"
+                                                }
+                                              },
+                                              "required": [
+                                                "cohort",
+                                                "step"
+                                              ],
+                                              "additionalProperties": false
+                                            }
+                                          },
+                                          "required": [
+                                            "type",
+                                            "specific"
+                                          ],
+                                          "additionalProperties": false
+                                        },
+                                        {
+                                          "type": "object",
+                                          "properties": {
+                                            "type": {
+                                              "type": "string",
+                                              "const": "none"
+                                            }
+                                          },
+                                          "required": [
+                                            "type"
+                                          ],
+                                          "additionalProperties": false
+                                        }
+                                      ]
+                                    }
+                                  },
+                                  "required": [
+                                    "type",
+                                    "cohort"
+                                  ],
+                                  "additionalProperties": false
+                                },
+                                {
+                                  "type": "object",
+                                  "properties": {
+                                    "type": {
+                                      "type": "string",
+                                      "const": "dayOfWeek"
+                                    },
+                                    "dayOfWeek": {
+                                      "type": "object",
+                                      "properties": {
+                                        "localDayOfWeek": {
+                                          "type": "number",
+                                          "minimum": 0,
+                                          "maximum": 6
+                                        }
+                                      },
+                                      "required": [
+                                        "localDayOfWeek"
+                                      ],
+                                      "additionalProperties": false
+                                    }
+                                  },
+                                  "required": [
+                                    "type",
+                                    "dayOfWeek"
+                                  ],
+                                  "additionalProperties": false
+                                },
+                                {
+                                  "type": "object",
+                                  "properties": {
+                                    "type": {
+                                      "type": "string",
+                                      "const": "hasActiveSubscription"
+                                    }
+                                  },
+                                  "required": [
+                                    "type"
+                                  ],
+                                  "additionalProperties": false
+                                },
+                                {
+                                  "type": "object",
+                                  "properties": {
+                                    "type": {
+                                      "type": "string",
+                                      "const": "customProperty"
+                                    },
+                                    "customProperty": {
+                                      "anyOf": [
+                                        {
+                                          "type": "object",
+                                          "properties": {
+                                            "propertyId": {
+                                              "type": "string"
+                                            },
+                                            "propertyType": {
+                                              "type": "string",
+                                              "const": "number"
+                                            },
+                                            "number": {
+                                              "type": "object",
+                                              "properties": {
+                                                "operator": {
+                                                  "type": "string",
+                                                  "enum": [
+                                                    "GTE",
+                                                    "LTE",
+                                                    "EQ",
+                                                    "GT",
+                                                    "LT"
+                                                  ]
+                                                },
+                                                "value": {
+                                                  "type": "number"
+                                                }
+                                              },
+                                              "required": [
+                                                "operator",
+                                                "value"
+                                              ],
+                                              "additionalProperties": false
+                                            }
+                                          },
+                                          "required": [
+                                            "propertyId",
+                                            "propertyType",
+                                            "number"
+                                          ],
+                                          "additionalProperties": false
+                                        },
+                                        {
+                                          "type": "object",
+                                          "properties": {
+                                            "propertyId": {
+                                              "type": "string"
+                                            },
+                                            "propertyType": {
+                                              "type": "string",
+                                              "const": "dayOfYear"
+                                            },
+                                            "dayOfYear": {
+                                              "anyOf": [
+                                                {
+                                                  "type": "object",
+                                                  "properties": {
+                                                    "type": {
+                                                      "type": "string",
+                                                      "const": "relative"
+                                                    },
+                                                    "relative": {
+                                                      "type": "object",
+                                                      "properties": {
+                                                        "direction": {
+                                                          "type": "string",
+                                                          "enum": [
+                                                            "since",
+                                                            "until"
+                                                          ]
+                                                        },
+                                                        "operator": {
+                                                          "type": "string",
+                                                          "enum": [
+                                                            "GTE",
+                                                            "LTE",
+                                                            "EQ",
+                                                            "GT",
+                                                            "LT"
+                                                          ]
+                                                        },
+                                                        "durationMs": {
+                                                          "type": "number"
+                                                        }
+                                                      },
+                                                      "required": [
+                                                        "direction",
+                                                        "operator",
+                                                        "durationMs"
+                                                      ],
+                                                      "additionalProperties": false
+                                                    }
+                                                  },
+                                                  "required": [
+                                                    "type",
+                                                    "relative"
+                                                  ],
+                                                  "additionalProperties": false
+                                                }
+                                              ]
+                                            }
+                                          },
+                                          "required": [
+                                            "propertyId",
+                                            "propertyType",
+                                            "dayOfYear"
+                                          ],
+                                          "additionalProperties": false
+                                        },
+                                        {
+                                          "type": "object",
+                                          "properties": {
+                                            "propertyId": {
+                                              "type": "string"
+                                            },
+                                            "propertyType": {
+                                              "type": "string",
+                                              "const": "date"
+                                            },
+                                            "date": {
+                                              "$ref": "#/properties/sections/properties/headerFields/items/properties/valueRules/items/properties/conditions/items/anyOf/10/properties/customProperty/anyOf/1/properties/dayOfYear"
+                                            }
+                                          },
+                                          "required": [
+                                            "propertyId",
+                                            "propertyType",
+                                            "date"
+                                          ],
+                                          "additionalProperties": false
+                                        },
+                                        {
+                                          "type": "object",
+                                          "properties": {
+                                            "propertyId": {
+                                              "type": "string"
+                                            },
+                                            "propertyType": {
+                                              "type": "string",
+                                              "const": "boolean"
+                                            },
+                                            "boolean": {
+                                              "type": "object",
+                                              "properties": {
+                                                "value": {
+                                                  "type": "boolean"
+                                                }
+                                              },
+                                              "required": [
+                                                "value"
+                                              ],
+                                              "additionalProperties": false
+                                            }
+                                          },
+                                          "required": [
+                                            "propertyId",
+                                            "propertyType",
+                                            "boolean"
+                                          ],
+                                          "additionalProperties": false
+                                        },
+                                        {
+                                          "type": "object",
+                                          "properties": {
+                                            "propertyId": {
+                                              "type": "string"
+                                            },
+                                            "propertyType": {
+                                              "type": "string",
+                                              "const": "string"
+                                            },
+                                            "string": {
+                                              "type": "object",
+                                              "properties": {
+                                                "operator": {
+                                                  "type": "string",
+                                                  "enum": [
+                                                    "EQ",
+                                                    "NEQ",
+                                                    "CONTAINS",
+                                                    "STARTS_WITH",
+                                                    "ENDS_WITH"
+                                                  ]
+                                                },
+                                                "value": {
+                                                  "type": "string"
+                                                }
+                                              },
+                                              "required": [
+                                                "operator",
+                                                "value"
+                                              ],
+                                              "additionalProperties": false
+                                            }
+                                          },
+                                          "required": [
+                                            "propertyId",
+                                            "propertyType",
+                                            "string"
+                                          ],
+                                          "additionalProperties": false
+                                        }
+                                      ]
+                                    }
+                                  },
+                                  "required": [
+                                    "type",
+                                    "customProperty"
+                                  ],
+                                  "additionalProperties": false
+                                }
+                              ]
+                            }
+                          },
+                          "value": {
+                            "anyOf": [
+                              {
+                                "type": "object",
+                                "properties": {
+                                  "type": {
+                                    "type": "string",
+                                    "const": "property"
+                                  },
+                                  "property": {
+                                    "anyOf": [
+                                      {
+                                        "type": "object",
+                                        "properties": {
+                                          "type": {
+                                            "type": "string",
+                                            "const": "name"
+                                          },
+                                          "name": {
+                                            "type": "object",
+                                            "properties": {},
+                                            "additionalProperties": false
+                                          }
+                                        },
+                                        "required": [
+                                          "type",
+                                          "name"
+                                        ],
+                                        "additionalProperties": false
+                                      },
+                                      {
+                                        "type": "object",
+                                        "properties": {
+                                          "type": {
+                                            "type": "string",
+                                            "const": "phoneNumber"
+                                          },
+                                          "phoneNumber": {
+                                            "type": "object",
+                                            "properties": {},
+                                            "additionalProperties": false
+                                          }
+                                        },
+                                        "required": [
+                                          "type",
+                                          "phoneNumber"
+                                        ],
+                                        "additionalProperties": false
+                                      },
+                                      {
+                                        "type": "object",
+                                        "properties": {
+                                          "type": {
+                                            "type": "string",
+                                            "const": "progress"
+                                          },
+                                          "progress": {
+                                            "type": "object",
+                                            "properties": {},
+                                            "additionalProperties": false
+                                          }
+                                        },
+                                        "required": [
+                                          "type",
+                                          "progress"
+                                        ],
+                                        "additionalProperties": false
+                                      },
+                                      {
+                                        "type": "object",
+                                        "properties": {
+                                          "type": {
+                                            "type": "string",
+                                            "const": "memberNumber"
+                                          },
+                                          "memberNumber": {
+                                            "type": "object",
+                                            "properties": {},
+                                            "additionalProperties": false
+                                          }
+                                        },
+                                        "required": [
+                                          "type",
+                                          "memberNumber"
+                                        ],
+                                        "additionalProperties": false
+                                      },
+                                      {
+                                        "type": "object",
+                                        "properties": {
+                                          "type": {
+                                            "type": "string",
+                                            "const": "lastVisit"
+                                          },
+                                          "lastVisit": {
+                                            "type": "object",
+                                            "properties": {},
+                                            "additionalProperties": false
+                                          }
+                                        },
+                                        "required": [
+                                          "type",
+                                          "lastVisit"
+                                        ],
+                                        "additionalProperties": false
+                                      }
+                                    ]
+                                  }
+                                },
+                                "required": [
+                                  "type",
+                                  "property"
+                                ],
+                                "additionalProperties": false
+                              },
+                              {
+                                "type": "object",
+                                "properties": {
+                                  "type": {
+                                    "type": "string",
+                                    "const": "expression"
+                                  },
+                                  "expression": {
+                                    "anyOf": [
+                                      {
+                                        "type": "object",
+                                        "properties": {
+                                          "type": {
+                                            "type": "string",
+                                            "const": "string"
+                                          },
+                                          "string": {
+                                            "type": "object",
+                                            "properties": {
+                                              "text": {
+                                                "type": "string"
+                                              }
+                                            },
+                                            "required": [
+                                              "text"
+                                            ],
+                                            "additionalProperties": false
+                                          }
+                                        },
+                                        "required": [
+                                          "type",
+                                          "string"
+                                        ],
+                                        "additionalProperties": false
+                                      }
+                                    ]
+                                  }
+                                },
+                                "required": [
+                                  "type",
+                                  "expression"
+                                ],
+                                "additionalProperties": false
+                              }
+                            ]
+                          }
+                        },
+                        "required": [
+                          "ruleId",
+                          "conditions",
+                          "value"
+                        ],
+                        "additionalProperties": false
+                      }
+                    },
+                    "alignment": {
+                      "type": "string",
+                      "enum": [
+                        "left",
+                        "center",
+                        "right"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "key",
+                    "label",
+                    "valueRules"
+                  ],
+                  "additionalProperties": false
+                }
+              },
+              "auxiliaryFields": {
+                "type": "array",
+                "items": {
+                  "$ref": "#/properties/sections/properties/headerFields/items"
+                }
+              },
+              "secondaryFields": {
+                "type": "array",
+                "items": {
+                  "$ref": "#/properties/sections/properties/headerFields/items"
+                }
+              },
+              "logoFile": {
+                "type": "object",
+                "properties": {
+                  "conditionalRules": {
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "ruleId": {
+                          "type": "string"
+                        },
+                        "conditions": {
+                          "type": "array",
+                          "items": {
+                            "$ref": "#/properties/sections/properties/headerFields/items/properties/valueRules/items/properties/conditions/items"
+                          }
+                        },
+                        "file": {
+                          "type": "string"
+                        },
+                        "originalFile": {
+                          "type": "string"
+                        },
+                        "crop": {
+                          "type": "object",
+                          "properties": {
+                            "cropPosition": {
+                              "type": "object",
+                              "properties": {
+                                "x": {
+                                  "type": "number"
+                                },
+                                "y": {
+                                  "type": "number"
+                                }
+                              },
+                              "required": [
+                                "x",
+                                "y"
+                              ],
+                              "additionalProperties": false
+                            },
+                            "zoom": {
+                              "type": "number"
+                            },
+                            "croppedAreaPixels": {
+                              "type": "object",
+                              "properties": {
+                                "x": {
+                                  "type": "number"
+                                },
+                                "y": {
+                                  "type": "number"
+                                },
+                                "width": {
+                                  "type": "number"
+                                },
+                                "height": {
+                                  "type": "number"
+                                }
+                              },
+                              "required": [
+                                "x",
+                                "y",
+                                "width",
+                                "height"
+                              ],
+                              "additionalProperties": false
+                            }
+                          },
+                          "required": [
+                            "cropPosition",
+                            "zoom",
+                            "croppedAreaPixels"
+                          ],
+                          "additionalProperties": false
+                        }
+                      },
+                      "required": [
+                        "ruleId",
+                        "conditions",
+                        "file"
+                      ],
+                      "additionalProperties": false
+                    }
+                  }
+                },
+                "required": [
+                  "conditionalRules"
+                ],
+                "additionalProperties": false
+              },
+              "stripFile": {
+                "$ref": "#/properties/sections/properties/logoFile"
+              },
+              "backgroundColor": {
+                "type": "object",
+                "properties": {
+                  "conditionalRules": {
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "ruleId": {
+                          "type": "string"
+                        },
+                        "conditions": {
+                          "type": "array",
+                          "items": {
+                            "$ref": "#/properties/sections/properties/headerFields/items/properties/valueRules/items/properties/conditions/items"
+                          }
+                        },
+                        "color": {
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "ruleId",
+                        "conditions",
+                        "color"
+                      ],
+                      "additionalProperties": false
+                    }
+                  }
+                },
+                "required": [
+                  "conditionalRules"
+                ],
+                "additionalProperties": false
+              },
+              "labelColor": {
+                "$ref": "#/properties/sections/properties/backgroundColor"
+              }
+            },
+            "required": [
+              "headerFields",
+              "auxiliaryFields",
+              "secondaryFields",
+              "logoFile",
+              "stripFile",
+              "backgroundColor",
+              "labelColor"
+            ],
+            "additionalProperties": false
+          },
+          "features": {
+            "type": "object",
+            "properties": {
+              "renderRewards": {
+                "type": "boolean"
+              },
+              "campaignTakeover": {
+                "type": "boolean"
+              },
+              "rewardLabelRules": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "ruleId": {
+                      "type": "string"
+                    },
+                    "conditions": {
+                      "type": "array",
+                      "items": {
+                        "$ref": "#/properties/sections/properties/headerFields/items/properties/valueRules/items/properties/conditions/items"
+                      }
+                    },
+                    "label": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "ruleId",
+                    "conditions",
+                    "label"
+                  ],
+                  "additionalProperties": false
+                }
+              }
+            },
+            "required": [
+              "renderRewards",
+              "campaignTakeover"
+            ],
+            "additionalProperties": false
+          },
+          "locations": {
+            "type": "object",
+            "properties": {
+              "locations": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "locationId": {
+                      "type": "string"
+                    },
+                    "latitude": {
+                      "type": "number"
+                    },
+                    "longitude": {
+                      "type": "number"
+                    },
+                    "altitude": {
+                      "type": "number"
+                    },
+                    "relevantText": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "latitude",
+                    "longitude"
+                  ],
+                  "additionalProperties": false
+                }
+              }
+            },
+            "required": [
+              "locations"
+            ],
+            "additionalProperties": false
+          },
+          "metadata": {
+            "type": "object",
+            "properties": {
+              "name": {
+                "type": "string"
+              },
+              "description": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "name",
+              "description"
+            ],
+            "additionalProperties": false
+          }
+        },
+        "required": [
+          "sections",
+          "features",
+          "metadata"
+        ],
+        "additionalProperties": false,
+        "$schema": "http://json-schema.org/draft-07/schema#"
+      }
+    },
+    {
+      "id": "searchUsers",
+      "domain": "membersProgram",
+      "description": "Search and explore members (loyalty guests) and their activity. Returns a page of the most recent user events, one per member, each carrying the member's serialNumber plus event details (type, time, and related object). Filters: query (free-text name search), eventTypes (e.g. sentText, receivedText, scan, order, rewardAwarded, rewardRedeemed, checkout, and the *Attribution types), progressMinBound/progressMaxBound (visit-count range), isUnread=true (members with unanswered inbound texts), orderBy (ASC|DESC by event time). Paginate with limit (default 100) and cursor (the `cursor` returned by the previous call; undefined cursor means no more pages).",
+      "needsApproval": false,
+      "type": "query",
+      "path": [
+        "api",
+        "loyalty",
+        "app",
+        "searchUsersV3"
+      ],
+      "inputJsonSchema": {
+        "type": "object",
+        "properties": {
+          "cursor": {
+            "type": "number"
+          },
+          "eventTypes": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "enum": [
+                "sentText",
+                "receivedText",
+                "scan",
+                "order",
+                "passCreated",
+                "passUpdated",
+                "passRegistered",
+                "passDeleted",
+                "rewardAwarded",
+                "rewardRedeemed",
+                "rewardExpiration",
+                "fbAttribution",
+                "influencerAttribution",
+                "tiktokAttribution",
+                "googleAttribution",
+                "miscAttribution",
+                "referralAttribution",
+                "checkout",
+                "customerInference",
+                "reservationCreated"
+              ]
+            }
+          },
+          "limit": {
             "type": "number"
           },
           "query": {
@@ -17292,6 +18671,45 @@ Filter leaves are one column each, written as the column name prefixed with $, c
         "$schema": "http://json-schema.org/draft-07/schema#"
       }
     },
+    {
+      "id": "stageFunnelScreen",
+      "domain": "funnel",
+      "description": "Stage a new, empty funnel screen onto a funnel draft. The screen only exists on the draft until saveFunnelEdits promotes it, and can be filled in with stageFunnelEdit using the returned screenId. On a campaign draft the screen is campaign-scoped unless campaignScoped is false.",
+      "needsApproval": false,
+      "type": "mutation",
+      "path": [
+        "api",
+        "layoutEngine",
+        "drafts",
+        "stageScreenCreate"
+      ],
+      "inputJsonSchema": {
+        "type": "object",
+        "properties": {
+          "draftId": {
+            "type": "string"
+          },
+          "title": {
+            "type": "string"
+          },
+          "description": {
+            "type": "string"
+          },
+          "screenId": {
+            "type": "string"
+          },
+          "campaignScoped": {
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "draftId",
+          "title"
+        ],
+        "additionalProperties": false,
+        "$schema": "http://json-schema.org/draft-07/schema#"
+      }
+    },
     {
       "id": "updateAutomationFlow",
       "domain": "automations",
@@ -18265,6 +19683,234 @@ ${available}`
   };
 }
 
+// src/actingContext.ts
+function environmentAccessToken() {
+  const token = process.env.FEAST_ACCESS_TOKEN;
+  return token != null && token.length > 0 ? token : void 0;
+}
+function firstNonEmpty(...values) {
+  for (const value of values) {
+    if (value != null && value.length > 0) {
+      return value;
+    }
+  }
+  return void 0;
+}
+function roleLabelFromArn(arn) {
+  return arn.split("/").pop()?.split(".").pop() ?? arn;
+}
+function buildPreferredRole(organizationId, role) {
+  if (role.startsWith("arn:")) {
+    return role;
+  }
+  if (!CLI_MANIFEST.organizationRoles.includes(role)) {
+    throw new Error(
+      `Unknown role "${role}". Expected one of ${CLI_MANIFEST.organizationRoles.join(", ")}, or a full role ARN.`
+    );
+  }
+  return formRoleArn(organizationId, role);
+}
+function resolvePinned(pinned, flag, variableName, flagName) {
+  if (pinned == null) {
+    return flag;
+  }
+  if (flag != null && flag !== pinned) {
+    throw new Error(
+      `${variableName} pins this session to ${pinned}, so ${flagName} ${flag} is not allowed.`
+    );
+  }
+  return pinned;
+}
+function resolveFromEnvironment(accessToken, orgFlag, roleFlag) {
+  const organizationId = resolvePinned(
+    firstNonEmpty(process.env.FEAST_ORGANIZATION_ID),
+    orgFlag,
+    "FEAST_ORGANIZATION_ID",
+    "--org"
+  );
+  if (organizationId == null) {
+    throw new Error(
+      "FEAST_ACCESS_TOKEN is set, so the organization cannot be read from the token. Pass --org <organizationId> or set FEAST_ORGANIZATION_ID."
+    );
+  }
+  const role = resolvePinned(
+    firstNonEmpty(process.env.FEAST_PREFERRED_ROLE),
+    roleFlag,
+    "FEAST_PREFERRED_ROLE",
+    "--role"
+  );
+  if (role == null) {
+    throw new Error(
+      "FEAST_ACCESS_TOKEN is set, so the role cannot be read from the token. Pass --role <role> or set FEAST_PREFERRED_ROLE."
+    );
+  }
+  const preferredRole = buildPreferredRole(organizationId, role);
+  return {
+    accessToken,
+    organizationId,
+    preferredRole,
+    roleLabel: roleLabelFromArn(preferredRole),
+    source: "environment"
+  };
+}
+async function resolveActingContext(orgFlag, roleFlag) {
+  const environmentToken = environmentAccessToken();
+  if (environmentToken != null) {
+    return resolveFromEnvironment(environmentToken, orgFlag, roleFlag);
+  }
+  const tokens = await ensureFreshTokens();
+  const accessToken = tokens.accessToken.jwtToken;
+  const organizationId = resolveOrganizationId(accessToken, orgFlag);
+  const resolved = resolvePreferredRole(accessToken, organizationId);
+  return {
+    accessToken,
+    organizationId,
+    preferredRole: resolved.arn,
+    roleLabel: resolved.orgRole.role,
+    source: "credentials"
+  };
+}
+
+// src/browserLogin.ts
+import { spawn } from "child_process";
+import { createHash, randomBytes } from "crypto";
+import http from "http";
+var CALLBACK_TIMEOUT_MS = 5 * 60 * 1e3;
+function base64url(buffer) {
+  return buffer.toString("base64url");
+}
+function tabHtml(title, body) {
+  return `<!doctype html><html><head><meta charset="utf-8"><title>${title}</title>
+<style>body{font-family:-apple-system,system-ui,sans-serif;background:#0f0f0f;color:#f5f5f5;
+display:flex;min-height:100vh;align-items:center;justify-content:center;margin:0}
+.card{text-align:center;padding:2rem 3rem}.t{font-size:1.4rem;font-weight:600;margin-bottom:.5rem}
+.b{color:#a1a1a1}</style></head><body><div class="card">
+<div class="t">${title}</div><div class="b">${body}</div></div></body></html>`;
+}
+function openBrowser(url) {
+  let command;
+  let args;
+  if (process.platform === "darwin") {
+    command = "open";
+    args = [url];
+  } else if (process.platform === "win32") {
+    command = "cmd";
+    args = ["/c", "start", "", url];
+  } else {
+    command = "xdg-open";
+    args = [url];
+  }
+  try {
+    const child = spawn(command, args, { stdio: "ignore", detached: true });
+    child.on("error", () => {
+    });
+    child.unref();
+  } catch {
+  }
+}
+function startLoopback(expectedState) {
+  return new Promise((resolveOuter, rejectOuter) => {
+    let resolveCode = () => {
+    };
+    let rejectCode = () => {
+    };
+    const waitForCode = new Promise((resolve, reject) => {
+      resolveCode = resolve;
+      rejectCode = reject;
+    });
+    waitForCode.catch(() => {
+    });
+    const server = http.createServer((req, res) => {
+      const url = new URL(req.url ?? "/", "http://127.0.0.1");
+      if (url.pathname !== "/callback") {
+        res.writeHead(404);
+        res.end();
+        return;
+      }
+      const error = url.searchParams.get("error");
+      if (error != null) {
+        res.writeHead(200, { "Content-Type": "text/html" });
+        res.end(tabHtml("Authorization declined", "You can close this tab."));
+        rejectCode(new Error(`Authorization declined: ${error}`));
+        return;
+      }
+      if (url.searchParams.get("state") !== expectedState) {
+        res.writeHead(400, { "Content-Type": "text/html" });
+        res.end(
+          tabHtml("Invalid request", "State mismatch \u2014 retry from the CLI.")
+        );
+        rejectCode(new Error("State mismatch \u2014 aborting (possible CSRF)"));
+        return;
+      }
+      const code = url.searchParams.get("code");
+      if (code == null || code.length === 0) {
+        res.writeHead(400);
+        res.end();
+        rejectCode(new Error("Authorization callback did not include a code"));
+        return;
+      }
+      res.writeHead(200, {
+        "Content-Type": "text/html",
+        Connection: "close"
+      });
+      res.end(
+        tabHtml(
+          "You're all set \u2713",
+          "The feast CLI is authorized. Close this tab and return to your terminal."
+        )
+      );
+      resolveCode(code);
+    });
+    const timeout = setTimeout(() => {
+      rejectCode(
+        new Error("Timed out waiting for browser authorization (5 minutes)")
+      );
+    }, CALLBACK_TIMEOUT_MS);
+    const close = () => {
+      clearTimeout(timeout);
+      server.closeAllConnections?.();
+      server.close();
+    };
+    server.on("error", rejectOuter);
+    server.listen(0, "127.0.0.1", () => {
+      server.unref();
+      const address = server.address();
+      const port = typeof address === "object" && address != null ? address.port : 0;
+      resolveOuter({ port, waitForCode, close });
+    });
+  });
+}
+async function browserLogin() {
+  const codeVerifier = base64url(randomBytes(32));
+  const codeChallenge = base64url(
+    createHash("sha256").update(codeVerifier).digest()
+  );
+  const state = base64url(randomBytes(16));
+  const { port, waitForCode, close } = await startLoopback(state);
+  try {
+    const authUrl = `${getWebBaseUrl()}/oauth?port=${port}&state=${encodeURIComponent(state)}&challenge=${encodeURIComponent(codeChallenge)}`;
+    console.error("Opening your browser to authorize the feast CLI...");
+    console.error(`If it doesn't open, visit:
+  ${authUrl}
+`);
+    openBrowser(authUrl);
+    const code = await waitForCode;
+    const client = createHttpCaller({});
+    const response = await client.api.auth.exchangeAuthCode.mutate({
+      code,
+      codeVerifier
+    });
+    const tokens = response?.tokens;
+    if (tokens?.accessToken?.jwtToken == null) {
+      throw new Error("Authorization failed: empty token response");
+    }
+    saveTokens(tokens);
+    return tokens;
+  } finally {
+    close();
+  }
+}
+
 // src/prompt.ts
 import readline from "readline";
 function promptText(question) {
@@ -18349,6 +19995,7 @@ Commands:
 
 Call options:
   --org <organizationId>    Organization to act on (required unless you belong to exactly one)
+  --role <role|roleArn>     Role to act as, e.g. OWNER (required when FEAST_ACCESS_TOKEN is set)
   --input <json>            Tool input as a JSON string (default: {})
   --input-file <path>       Tool input from a JSON file
   --yes                     Skip the confirmation prompt for mutations
@@ -18356,11 +20003,18 @@ Call options:
 Environment:
   FEAST_API_URL             Override the API base URL (default: production)
   FEAST_WEB_URL             Override the web app base URL for browser login (default: production)
-  FEAST_NO_UPDATE_CHECK     Disable the daily check for a newer published version`;
+  FEAST_NO_UPDATE_CHECK     Disable the daily check for a newer published version
+
+Non-interactive credentials (for sandboxed agents):
+  FEAST_ACCESS_TOKEN        Access token to send verbatim. When set, no token is read
+                            from disk and none is refreshed, and the token is never
+                            decoded \u2014 so the organization and role must be supplied too.
+  FEAST_ORGANIZATION_ID     Pins the organization. --org must match it or be omitted.
+  FEAST_PREFERRED_ROLE      Pins the role. --role must match it or be omitted.`;
 function parseArgs(argv) {
   const positional = [];
   const flags = {};
-  const valueFlags = /* @__PURE__ */ new Set(["org", "input", "input-file", "domain"]);
+  const valueFlags = /* @__PURE__ */ new Set(["org", "role", "input", "input-file", "domain"]);
   for (let i = 0; i < argv.length; i++) {
     const arg = argv[i];
     if (!arg.startsWith("--")) {
@@ -18382,6 +20036,11 @@ function parseArgs(argv) {
   return { positional, flags };
 }
 async function commandLogin(args) {
+  if (environmentAccessToken() != null) {
+    throw new Error(
+      "FEAST_ACCESS_TOKEN is set, so this CLI is using credentials from the environment. Unset it to log in and store tokens on disk."
+    );
+  }
   if (args.flags["password"] === true) {
     const username = args.positional[0] ?? await promptText("Username: ");
     if (username.length === 0) {
@@ -18402,7 +20061,20 @@ async function commandLogin(args) {
   console.info(`Logged in as ${payload.username ?? payload.sub}`);
   console.info(`Tokens stored in ${getCredentialsPath()}`);
 }
-async function commandWhoami() {
+async function commandWhoami(args) {
+  if (environmentAccessToken() != null) {
+    const acting = await resolveActingContext(
+      args.flags["org"],
+      args.flags["role"]
+    );
+    console.info("Credentials: FEAST_ACCESS_TOKEN (environment)");
+    console.info(`Organization: ${acting.organizationId}`);
+    console.info(`Role: ${acting.roleLabel}`);
+    console.info(
+      "The token is opaque to this CLI, so the user and their other organizations cannot be listed."
+    );
+    return;
+  }
   const tokens = await ensureFreshTokens();
   const payload = decodeJwtPayload(tokens.accessToken.jwtToken);
   const orgRoles = listOrgRoles(tokens.accessToken.jwtToken);
@@ -18544,25 +20216,20 @@ ${issues.join("\n")}
 Run: feast describe ${tool.id}`
     );
   }
-  const tokens = await ensureFreshTokens();
-  const isWrite = tool.type === "mutation" || tool.needsApproval;
-  const organizationId = resolveOrganizationId(
-    tokens.accessToken.jwtToken,
-    args.flags["org"]
-  );
-  const resolved = resolvePreferredRole(
-    tokens.accessToken.jwtToken,
-    organizationId
+  const acting = await resolveActingContext(
+    args.flags["org"],
+    args.flags["role"]
   );
+  const isWrite = tool.type === "mutation" || tool.needsApproval;
   console.error(
-    `Acting on organization ${organizationId} as ${resolved.orgRole.role}`
+    `Acting on organization ${acting.organizationId} as ${acting.roleLabel}`
   );
   const client = createHttpCaller({
-    accessToken: tokens.accessToken.jwtToken,
-    preferredRole: resolved.arn
+    accessToken: acting.accessToken,
+    preferredRole: acting.preferredRole
   });
   if (isWrite) {
-    const organization = await verifyOrganization(client, organizationId);
+    const organization = await verifyOrganization(client, acting.organizationId);
     if (args.flags["yes"] !== true) {
       const orgLabel = organization.name != null ? `"${organization.name}" (${organization.id})` : organization.id;
       const approved = await promptConfirm(
@@ -18590,7 +20257,7 @@ async function runCli(argv) {
       console.info("Logged out");
       break;
     case "whoami":
-      await commandWhoami();
+      await commandWhoami(args);
       break;
     case "tools":
       commandTools(args);