@gravity-rail/cli 0.4.0 → 0.5.1

package/dist/lib.js

@@ -1,8 +1,6 @@
 import {
   AGUIClient,
   CredentialsManager,
-  __export,
-  __reExport,
   clearScreen,
   formatTimestamp,
   getEnvironmentConfig,
@@ -13,48 +11,16 @@ import {
   printTable,
   refreshAccessToken,
   selectFromList
-} from "./chunk-C6D4FO6A.js";
-
-// src/lib/errors.ts
-var CLIError = class extends Error {
-  constructor(message, exitCode = 1) {
-    super(message);
-    this.exitCode = exitCode;
-    this.name = "CLIError";
-  }
-};
-var AuthRequiredError = class extends CLIError {
-  constructor(message = "Not authenticated. Run `gr login` or set GRAVITY_RAIL_API_KEY.") {
-    super(message, 2);
-    this.name = "AuthRequiredError";
-  }
-};
-function handleError(err) {
-  if (err instanceof CLIError) {
-    process.stderr.write(`Error: ${err.message}
-`);
-    process.exit(err.exitCode);
-  }
-  if (err instanceof Error) {
-    process.stderr.write(`Error: ${err.message}
-`);
-    if ("errors" in err && Array.isArray(err.errors)) {
-      for (const e of err.errors) {
-        process.stderr.write(`  - ${e}
-`);
-      }
-    }
-    if ("statusCode" in err && err.statusCode === 401) {
-      process.stderr.write(`
-Hint: Run "yarn gr login" or use "--realm <name>" (dev only)
-`);
-    }
-    process.exit(1);
-  }
-  process.stderr.write(`Error: ${String(err)}
-`);
-  process.exit(1);
-}
+} from "./chunk-H62EC2CF.js";
+import {
+  AuthRequiredError,
+  CLIError,
+  handleError
+} from "./chunk-OPWCTOHP.js";
+import {
+  __export,
+  __reExport
+} from "./chunk-424PT5DM.js";
 
 // src/lib/pagination.ts
 function isListResult(data) {
@@ -204,7 +170,7 @@ var COMMON_ARGS = [
   { name: "uuid", description: "Entity UUID" }
 ];
 function parseArgs(defs, argv) {
-  const allDefs = [...COMMON_ARGS, ...defs];
+  const allDefs = [...defs, ...COMMON_ARGS];
   const result = {};
   for (const def of allDefs) {
     if (def.default !== void 0) {
@@ -231,8 +197,7 @@ function parseArgs(defs, argv) {
     const def = findDef(allDefs, flagPart);
     if (!def) {
       if ((flagPart.startsWith("--") || flagPart.startsWith("-")) && !KNOWN_GLOBAL_FLAGS.has(flagPart)) {
-        process.stderr.write(`Warning: unknown flag "${flagPart}" (ignored)
-`);
+        throw new CLIError(`Unknown flag "${flagPart}"`);
       }
       continue;
     }
@@ -247,9 +212,11 @@ function parseArgs(defs, argv) {
     }
   }
   for (const def of allDefs) {
-    if (def.required && result[def.name] === void 0) {
-      throw new CLIError(`Missing required argument: --${def.name}`);
-    }
+    if (!def.required) continue;
+    if (result[def.name] !== void 0) continue;
+    const aliasNames = [def.alias, ...def.aliases ?? []].filter(Boolean);
+    if (aliasNames.some((a) => result[a] !== void 0)) continue;
+    throw new CLIError(`Missing required argument: --${def.name}`);
   }
   return result;
 }
@@ -277,7 +244,67 @@ __reExport(dist_exports, internal_star);
 import * as internal_star from "@gravity-rail/sdk/internal";
 import { BaseApiClient } from "@gravity-rail/sdk/internal";
 import { GravityRailClient } from "@gravity-rail/sdk";
+function supportRequestParams(params) {
+  const searchParams = new URLSearchParams();
+  if (params?.page) searchParams.append("page", params.page.toString());
+  if (params?.pageSize) searchParams.append("pageSize", params.pageSize.toString());
+  if (params?.status) searchParams.append("status", params.status);
+  if (params?.supportRequestType) {
+    searchParams.append("supportRequestType", params.supportRequestType);
+  }
+  if (params?.severity) searchParams.append("severity", params.severity);
+  if (params?.source) searchParams.append("source", params.source);
+  if (params?.organizationId !== void 0) {
+    searchParams.append("organizationId", params.organizationId.toString());
+  }
+  if (params?.workspaceId !== void 0) {
+    searchParams.append("workspaceId", params.workspaceId.toString());
+  }
+  if (params?.linearLinked !== void 0) {
+    searchParams.append("linearLinked", params.linearLinked.toString());
+  }
+  const query = searchParams.toString();
+  return query ? `?${query}` : "";
+}
 var AdminApi = class extends BaseApiClient {
+  // Support Requests API
+  async listSupportRequestsAsAdmin(params) {
+    return this.fetch(
+      `admin/support-requests${supportRequestParams(params)}`
+    );
+  }
+  async getSupportRequestAsAdmin(uuid) {
+    return this.fetch(`admin/support-requests/${uuid}`);
+  }
+  async commentOnSupportRequestAsAdmin(uuid, data) {
+    return this.fetch(`admin/support-requests/${uuid}/comments`, {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async noteOnSupportRequestAsAdmin(uuid, data) {
+    return this.fetch(`admin/support-requests/${uuid}/notes`, {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async updateSupportRequestStatusAsAdmin(uuid, data) {
+    return this.fetch(`admin/support-requests/${uuid}/status`, {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async updateSupportRequestAttributesAsAdmin(uuid, data) {
+    return this.fetch(`admin/support-requests/${uuid}/attributes`, {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async createSupportRequestLinearIssueAsAdmin(uuid) {
+    return this.fetch(`admin/support-requests/${uuid}/linear-issue`, {
+      method: "POST"
+    });
+  }
   // Admin Accounts API
   async getAccounts(options) {
     const params = new URLSearchParams();
@@ -416,11 +443,11 @@ var AdminApi = class extends BaseApiClient {
     return this.fetch(`o/${idOrUuid}`);
   }
   /**
-   * Get organization by numeric ID via admin endpoint.
+   * Get organization by numeric ID or UUID via admin endpoint.
    * Does NOT require organization membership — superuser-only.
    */
-  async getOrganizationAsAdmin(id) {
-    return this.fetch(`admin/organizations/${id}`);
+  async getOrganizationAsAdmin(idOrUuid) {
+    return this.fetch(`admin/organizations/${idOrUuid}`);
   }
   async getOrganizationMembersAsAdmin(organizationId, options) {
     const params = new URLSearchParams();
@@ -597,6 +624,26 @@ var AdminApi = class extends BaseApiClient {
       body: JSON.stringify(request || {})
     });
   }
+  /**
+   * Switch a workspace's plan product on its active SubscriptionItem.
+   *
+   * Superuser only. Re-syncs ``workspace.features`` from the new product
+   * and emits a ``WORKSPACE_PRODUCT_CHANGED`` audit event identifying the
+   * actor, target workspace, prior and new product, and feature diff.
+   *
+   * Stripe is not touched here; price-id changes belong to the dedicated
+   * Stripe sync surface (``syncProductToStripe``).
+   */
+  async changeWorkspaceProduct(workspaceUuid, productId) {
+    const body = { productId };
+    return this.fetch(
+      `admin/workspaces/${workspaceUuid}/product`,
+      {
+        method: "POST",
+        body: JSON.stringify(body)
+      }
+    );
+  }
   // ===== Workflow Access Validation =====
   async validateWorkflowAccessAsAdmin(workspaceUuid) {
     const params = new URLSearchParams();
@@ -629,6 +676,11 @@ var AdminApi = class extends BaseApiClient {
       body: JSON.stringify(data)
     });
   }
+  async unarchiveAdminWorkspaceMember(wid) {
+    return this.fetch(`admin/workspaces/${wid}/me/unarchive`, {
+      method: "POST"
+    });
+  }
   async getAdminWorkspaceMemberRoles(wid) {
     return this.fetch(`admin/workspaces/${wid}/member-roles`);
   }
@@ -640,8 +692,8 @@ var AdminApi = class extends BaseApiClient {
       `admin/phone-numbers/workspace/${workspaceId}/unmapped`
     );
   }
-  async getWorkspacePhoneNumbersAsAdmin(workspaceId) {
-    return this.fetch(`admin/workspace/${workspaceId}/phone-numbers`);
+  async getWorkspacePhoneNumbersAsAdmin(workspaceRef) {
+    return this.fetch(`admin/workspaces/${workspaceRef}/phone-numbers`);
   }
   // Phone Numbers API (Provider phone numbers from Twilio, AWS, etc.)
   async getProviderPhoneNumbers(options = {}) {
@@ -750,6 +802,11 @@ var AdminApi = class extends BaseApiClient {
       method: "DELETE"
     });
   }
+  async getWorkspaceInboxesAsAdmin(workspaceUuid) {
+    return this.fetch(
+      `admin/workspaces/${workspaceUuid}/inboxes`
+    );
+  }
   // Admin Inbox Mappings API
   async getInboxMappings(options = {}) {
     const params = new URLSearchParams();
@@ -794,21 +851,30 @@ var AdminApi = class extends BaseApiClient {
       })
     });
   }
-  // Admin Themes API
-  async listAllThemes() {
-    return this.fetch("admin/themes/list");
-  }
-  // One-off Redis cadence-key migration (periodiq_* → routine_*). See
-  // lib/routes/admin/admin_routine_cadence_api.py for context.
-  async migrateRoutineCadenceKeys(options) {
-    return this.fetch("admin/redis/routine-cadence/migrate", {
+  /**
+   * Resolve a Langfuse trace UI URL from a trace ID, chat ID, or message ID.
+   *
+   * URL-only: never fetches Langfuse payloads, Message content, or
+   * tool arguments. Exactly one of ``traceId``, ``chatId``, or
+   * ``messageId`` must be set; chat/message forms require a
+   * workspaceUuid. See
+   * docs/development/observability/llm-call-investigation.md.
+   */
+  async getTraceUrl(options) {
+    return this.fetch("admin/trace/url", {
       method: "POST",
       body: JSON.stringify({
-        dryRun: options.dryRun ?? true,
-        deleteLegacy: options.deleteLegacy ?? false
+        trace_id: options.traceId,
+        chat_id: options.chatId,
+        message_id: options.messageId,
+        workspace_uuid: options.workspaceUuid
       })
     });
   }
+  // Admin Themes API
+  async listAllThemes() {
+    return this.fetch("admin/themes/list");
+  }
   // Missing Memberships API
   async getMissingMemberships(workspaceId) {
     return this.fetch(
@@ -1381,6 +1447,13 @@ function appendTemporalWorkspaceParams(params, options) {
   push(options.workspaceUuid);
 }
 function bindAdminMethods(target, admin) {
+  target.listSupportRequestsAsAdmin = admin.listSupportRequestsAsAdmin.bind(admin);
+  target.getSupportRequestAsAdmin = admin.getSupportRequestAsAdmin.bind(admin);
+  target.commentOnSupportRequestAsAdmin = admin.commentOnSupportRequestAsAdmin.bind(admin);
+  target.noteOnSupportRequestAsAdmin = admin.noteOnSupportRequestAsAdmin.bind(admin);
+  target.updateSupportRequestStatusAsAdmin = admin.updateSupportRequestStatusAsAdmin.bind(admin);
+  target.updateSupportRequestAttributesAsAdmin = admin.updateSupportRequestAttributesAsAdmin.bind(admin);
+  target.createSupportRequestLinearIssueAsAdmin = admin.createSupportRequestLinearIssueAsAdmin.bind(admin);
   target.getAccounts = admin.getAccounts.bind(admin);
   target.getAccountDetails = admin.getAccountDetails.bind(admin);
   target.getAccountByUuid = admin.getAccountByUuid.bind(admin);
@@ -1429,11 +1502,13 @@ function bindAdminMethods(target, admin) {
   target.disableMaintenanceMode = admin.disableMaintenanceMode.bind(admin);
   target.getWorkspaceHealth = admin.getWorkspaceHealth.bind(admin);
   target.provisionPlanFeatures = admin.provisionPlanFeatures.bind(admin);
+  target.changeWorkspaceProduct = admin.changeWorkspaceProduct.bind(admin);
   target.validateWorkflowAccessAsAdmin = admin.validateWorkflowAccessAsAdmin.bind(admin);
   target.mergeMembers = admin.mergeMembers.bind(admin);
   target.getAdminWorkspaceMember = admin.getAdminWorkspaceMember.bind(admin);
   target.createAdminWorkspaceMember = admin.createAdminWorkspaceMember.bind(admin);
   target.updateAdminWorkspaceMember = admin.updateAdminWorkspaceMember.bind(admin);
+  target.unarchiveAdminWorkspaceMember = admin.unarchiveAdminWorkspaceMember.bind(admin);
   target.getAdminWorkspaceMemberRoles = admin.getAdminWorkspaceMemberRoles.bind(admin);
   target.getMissingMemberships = admin.getMissingMemberships.bind(admin);
   target.linkMissingMembership = admin.linkMissingMembership.bind(admin);
@@ -1464,8 +1539,8 @@ function bindAdminMethods(target, admin) {
   target.deleteAdminInboxMapping = admin.deleteAdminInboxMapping.bind(admin);
   target.generateChatSummaries = admin.generateChatSummaries.bind(admin);
   target.executeQuery = admin.executeQuery.bind(admin);
+  target.getTraceUrl = admin.getTraceUrl.bind(admin);
   target.listAllThemes = admin.listAllThemes.bind(admin);
-  target.migrateRoutineCadenceKeys = admin.migrateRoutineCadenceKeys.bind(admin);
   target.startBulkTOSAcceptance = admin.startBulkTOSAcceptance.bind(admin);
   target.startTokenUsageBackfill = admin.startTokenUsageBackfill.bind(admin);
   target.updateChatMessage = admin.updateChatMessage.bind(admin);
@@ -1525,6 +1600,7 @@ function bindAdminMethods(target, admin) {
   target.getVoiceMetrics = admin.getVoiceMetrics.bind(admin);
   target.getHealthMetrics = admin.getHealthMetrics.bind(admin);
   target.getHealthDetail = admin.getHealthDetail.bind(admin);
+  target.getWorkspaceInboxesAsAdmin = admin.getWorkspaceInboxesAsAdmin.bind(admin);
   target.listWorkspaceChats = admin.listWorkspaceChats.bind(admin);
   target.getWorkspaceChat = admin.getWorkspaceChat.bind(admin);
   target.rateWorkspaceChatMessage = admin.rateWorkspaceChatMessage.bind(admin);
@@ -1543,6 +1619,13 @@ function bindAdminMethods(target, admin) {
 }
 var ApiClient = class extends GravityRailClient {
   // Admin API
+  listSupportRequestsAsAdmin;
+  getSupportRequestAsAdmin;
+  commentOnSupportRequestAsAdmin;
+  noteOnSupportRequestAsAdmin;
+  updateSupportRequestStatusAsAdmin;
+  updateSupportRequestAttributesAsAdmin;
+  createSupportRequestLinearIssueAsAdmin;
   getAccounts;
   getAccountDetails;
   getAccountByUuid;
@@ -1591,11 +1674,13 @@ var ApiClient = class extends GravityRailClient {
   disableMaintenanceMode;
   getWorkspaceHealth;
   provisionPlanFeatures;
+  changeWorkspaceProduct;
   validateWorkflowAccessAsAdmin;
   mergeMembers;
   getAdminWorkspaceMember;
   createAdminWorkspaceMember;
   updateAdminWorkspaceMember;
+  unarchiveAdminWorkspaceMember;
   getAdminWorkspaceMemberRoles;
   getMissingMemberships;
   linkMissingMembership;
@@ -1626,8 +1711,8 @@ var ApiClient = class extends GravityRailClient {
   deleteAdminInboxMapping;
   generateChatSummaries;
   executeQuery;
+  getTraceUrl;
   listAllThemes;
-  migrateRoutineCadenceKeys;
   startBulkTOSAcceptance;
   startTokenUsageBackfill;
   updateChatMessage;
@@ -1681,6 +1766,7 @@ var ApiClient = class extends GravityRailClient {
   getVoiceMetrics;
   getHealthMetrics;
   getHealthDetail;
+  getWorkspaceInboxesAsAdmin;
   listWorkspaceChats;
   getWorkspaceChat;
   rateWorkspaceChatMessage;
@@ -1717,6 +1803,10 @@ var ApiClient = class extends GravityRailClient {
       this.adminApi.setActingMember(memberUuid);
     }
   }
+  // setOrgToken is intentionally NOT overridden here. Admin routes
+  // (/api/v2/admin/*) are protected by the bearer token's superuser claim and
+  // ignore X-Org-Token entirely, so propagating an org token to adminApi is
+  // dead code that would only obscure auth flow if admin route logic changes.
 };
 
 // src/lib/context.ts
@@ -1892,7 +1982,131 @@ function loadRealmCredentials(realm, devRealmsPath) {
   }
 }
 
+// src/lib/org-auth.ts
+import { execFile } from "child_process";
+var ORG_AUTH_TIMEOUT_MS = 5 * 60 * 1e3;
+function extractOrgTokenFromSetCookies(setCookieValues, preferredCookieName) {
+  let fallback;
+  for (const value of setCookieValues) {
+    const nameValue = value.split(";")[0]?.trim() ?? "";
+    const eqIdx = nameValue.indexOf("=");
+    if (eqIdx === -1) continue;
+    const name = nameValue.slice(0, eqIdx).trim();
+    const tokenValue = nameValue.slice(eqIdx + 1).trim() || void 0;
+    if (!tokenValue) continue;
+    if (name === preferredCookieName) return tokenValue;
+    if (!fallback && (name.startsWith("orgToken") || name.startsWith("orgSession"))) {
+      fallback = tokenValue;
+    }
+  }
+  return fallback;
+}
+async function tryDirectJoin(apiUrl, accessToken, orgAuthInfo) {
+  const response = await fetch(`${apiUrl}/api/v2/o/${orgAuthInfo.orgUuid}/join`, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${accessToken}`
+    },
+    body: "{}"
+  });
+  if (response.status === 400) {
+    return null;
+  }
+  if (!response.ok) {
+    throw new Error(`Org join failed (HTTP ${response.status})`);
+  }
+  const rawHeaders = response.headers;
+  const setCookies = rawHeaders.getSetCookie?.() ?? (rawHeaders.get("set-cookie") ? [rawHeaders.get("set-cookie")] : []);
+  if (setCookies.length === 0) {
+    throw new Error("Org join succeeded but no Set-Cookie header returned");
+  }
+  const orgToken = extractOrgTokenFromSetCookies(setCookies, orgAuthInfo.cookieName);
+  if (!orgToken) {
+    throw new Error("Org join succeeded but org token cookie not found in Set-Cookie");
+  }
+  return orgToken;
+}
+function isAllowedAuthUrl(url, apiUrl) {
+  try {
+    const parsed = new URL(url);
+    const api = new URL(apiUrl);
+    if (parsed.protocol !== "https:" && parsed.protocol !== "http:") return false;
+    if (parsed.hostname === api.hostname) return true;
+    const lastTwo = (host) => {
+      const parts = host.split(".").filter(Boolean);
+      return parts.length >= 2 ? parts.slice(-2).join(".") : host;
+    };
+    const isIp = /^[0-9.]+$|^\[.*\]$/.test(parsed.hostname);
+    if (isIp) return false;
+    return lastTwo(parsed.hostname) === lastTwo(api.hostname);
+  } catch {
+    return false;
+  }
+}
+function openBrowser(url) {
+  let command;
+  let args;
+  if (process.platform === "darwin") {
+    command = "open";
+    args = [url];
+  } else if (process.platform === "win32") {
+    command = "cmd.exe";
+    args = ["/c", "start", "", url];
+  } else {
+    command = "xdg-open";
+    args = [url];
+  }
+  execFile(command, args, (_err) => {
+  });
+}
+function registerOrgAuthHandler(apiClient, apiUrl, accessToken) {
+  apiClient.setOrgAuthHandler(async (orgAuthInfo) => {
+    try {
+      const orgToken = await tryDirectJoin(apiUrl, accessToken, orgAuthInfo);
+      if (orgToken !== null) {
+        apiClient.setOrgToken(orgToken, orgAuthInfo.orgUuid);
+        return;
+      }
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      stderr(`Warning: org direct-join failed (${msg}); trying browser auth`);
+    }
+    if (!isAllowedAuthUrl(orgAuthInfo.authUrl, apiUrl)) {
+      throw new Error(
+        `Refusing to open organization auth URL: scheme/host does not match the configured API host. Re-run with the expected --api-url, or contact support.`
+      );
+    }
+    stderr(`
+This workspace requires organization SSO authentication.`);
+    stderr(`Opening browser to complete authentication...`);
+    stderr(`  ${orgAuthInfo.authUrl}
+`);
+    stderr(`If the browser does not open, visit the URL above manually.`);
+    stderr(
+      `After signing in, re-run the command \u2014 the CLI cannot receive the SSO token directly.`
+    );
+    openBrowser(orgAuthInfo.authUrl);
+    await new Promise((_, reject) => {
+      const t = setTimeout(
+        () => reject(
+          new Error(
+            "Organization authentication timed out.\nPlease complete authentication in the browser, then re-run the command."
+          )
+        ),
+        ORG_AUTH_TIMEOUT_MS
+      );
+      t.unref?.();
+    });
+  });
+}
+
 // src/lib/context.ts
+function makeApiClient(accessToken, apiUrl) {
+  const apiClient = new ApiClient(accessToken, apiUrl);
+  registerOrgAuthHandler(apiClient, apiUrl, accessToken);
+  return apiClient;
+}
 async function tryTokenRefresh(ctx, creds) {
   if (!creds.refreshToken) return null;
   const refreshed = await refreshAccessToken(
@@ -1902,7 +2116,7 @@ async function tryTokenRefresh(ctx, creds) {
     ctx.env
   );
   if (!refreshed?.accessToken) return null;
-  const apiClient = new ApiClient(refreshed.accessToken, ctx.envConfig.apiUrl);
+  const apiClient = makeApiClient(refreshed.accessToken, ctx.envConfig.apiUrl);
   return { ...ctx, accessToken: refreshed.accessToken, apiClient };
 }
 function createContext(opts) {
@@ -1926,12 +2140,12 @@ async function createAuthenticatedContext(opts) {
       devRealmsPath = loadDevCloudRealmFile(namespace);
     }
     const { token, workspaceUuid } = loadRealmCredentials(opts.realm, devRealmsPath);
-    const apiClient = new ApiClient(token, ctx.envConfig.apiUrl);
+    const apiClient = makeApiClient(token, ctx.envConfig.apiUrl);
     return { ...ctx, accessToken: token, apiClient, realmWorkspace: workspaceUuid };
   }
   const apiKey = process.env.GRAVITY_RAIL_API_KEY;
   if (apiKey) {
-    const apiClient = new ApiClient(apiKey, ctx.envConfig.apiUrl);
+    const apiClient = makeApiClient(apiKey, ctx.envConfig.apiUrl);
     return { ...ctx, accessToken: apiKey, apiClient };
   }
   const creds = ctx.credentialsManager.load(ctx.env);
@@ -1939,7 +2153,7 @@ async function createAuthenticatedContext(opts) {
     const buffer = 5 * 60 * 1e3;
     const notExpired = !creds.expiresAt || new Date(creds.expiresAt) > new Date(Date.now() + buffer);
     if (notExpired) {
-      const apiClient = new ApiClient(creds.accessToken, ctx.envConfig.apiUrl);
+      const apiClient = makeApiClient(creds.accessToken, ctx.envConfig.apiUrl);
       return { ...ctx, accessToken: creds.accessToken, apiClient };
     }
     const refreshed = await tryTokenRefresh(ctx, creds);
@@ -1954,12 +2168,14 @@ function requireAuth(ctx) {
   return ctx;
 }
 function createPublicContext(opts) {
-  const apiUrl = opts.apiUrl || process.env.GRAVITY_RAIL_API_URL || "https://api.gravityrail.com";
-  const frontendUrl = opts.frontendUrl || process.env.GRAVITY_RAIL_FRONTEND_URL || "https://app.gravityrail.com";
-  const envConfig = { apiUrl, frontendUrl };
-  const credentialsManager = new CredentialsManager(homedir(), apiUrl);
+  const env = opts.env ?? "prod";
+  const envConfig = opts.apiUrl ? {
+    apiUrl: opts.apiUrl,
+    frontendUrl: opts.frontendUrl || process.env.GRAVITY_RAIL_FRONTEND_URL || "https://app.gravityrail.com"
+  } : getEnvironmentConfig(env);
+  const credentialsManager = new CredentialsManager(homedir(), envConfig.apiUrl);
   return {
-    env: "prod",
+    env,
     envConfig,
     outputFormat: detectOutputFormat(opts.outputFormat),
     verbose: opts.verbose ?? false,
@@ -1971,7 +2187,7 @@ async function createPublicAuthenticatedContext(opts) {
   const ctx = createPublicContext(opts);
   const apiKey = process.env.GRAVITY_RAIL_API_KEY;
   if (apiKey) {
-    const apiClient = new ApiClient(apiKey, ctx.envConfig.apiUrl);
+    const apiClient = makeApiClient(apiKey, ctx.envConfig.apiUrl);
     return { ...ctx, accessToken: apiKey, apiClient };
   }
   const creds = ctx.credentialsManager.load(ctx.env);
@@ -1979,7 +2195,7 @@ async function createPublicAuthenticatedContext(opts) {
     const buffer = 5 * 60 * 1e3;
     const notExpired = !creds.expiresAt || new Date(creds.expiresAt) > new Date(Date.now() + buffer);
     if (notExpired) {
-      const apiClient = new ApiClient(creds.accessToken, ctx.envConfig.apiUrl);
+      const apiClient = makeApiClient(creds.accessToken, ctx.envConfig.apiUrl);
       return { ...ctx, accessToken: creds.accessToken, apiClient };
     }
     const refreshed = await tryTokenRefresh(ctx, creds);
@@ -2011,32 +2227,48 @@ async function readJsonInput(args) {
       throw new CLIError(`Cannot read file: ${filePath}`);
     }
   }
-  if (!process.stdin.isTTY) {
-    return readStdin();
+  if (process.stdin.isTTY === true) {
+    return void 0;
   }
-  return void 0;
+  return readStdinIfPiped();
 }
-function readStdin() {
+function readStdinIfPiped() {
   return new Promise((resolve, reject) => {
     let data = "";
-    process.stdin.setEncoding("utf-8");
-    process.stdin.on("data", (chunk) => {
-      data += chunk;
-    });
-    process.stdin.on("end", () => {
+    let settled = false;
+    const finish = (value) => {
+      if (settled) return;
+      settled = true;
+      resolve(value);
+    };
+    const flush = () => {
       if (!data.trim()) {
-        resolve(void 0);
+        finish(void 0);
         return;
       }
       try {
-        resolve(JSON.parse(data));
+        finish(JSON.parse(data));
       } catch {
         reject(new CLIError("Invalid JSON from stdin"));
       }
+    };
+    process.stdin.setEncoding("utf-8");
+    process.stdin.on("data", (chunk) => {
+      data += chunk;
     });
+    process.stdin.on("end", flush);
     process.stdin.on("error", (err) => {
       reject(new CLIError(`Error reading stdin: ${err.message}`));
     });
+    process.stdin.resume();
+    setImmediate(() => {
+      if (data) return;
+      if (process.stdin.readableEnded) {
+        flush();
+        return;
+      }
+      finish(void 0);
+    });
   });
 }
 
@@ -2632,6 +2864,17 @@ function requireNumber(args, key) {
   if (isNaN(num)) throw new Error(`Argument --${key} must be a number`);
   return num;
 }
+function requireNumberFrom(args, ...keys) {
+  for (const key of keys) {
+    const val = args[key];
+    if (typeof val === "string") {
+      const num = Number(val);
+      if (!isNaN(num)) return num;
+    }
+  }
+  const hint = keys.map((k) => `--${k}`).join(" or ");
+  throw new Error(`Missing required argument: ${hint}`);
+}
 
 // src/domains/agent-tasks.ts
 var LIST_COLUMNS = [
@@ -2792,6 +3035,7 @@ var agentsDomain = {
 var COLUMNS2 = [
   COL.id(),
   COL.uuid(),
+  { header: "TYPE", getValue: (item) => item.chatType ?? item.chat_type ?? "" },
   { header: "MEMBER", getValue: (item) => item.member_name ?? String(item.member_id ?? "") },
   COL.status(),
   { header: "CHANNEL", getValue: (item) => item.channel ?? "" },
@@ -2843,7 +3087,11 @@ var chatsDomain = {
           isFlag: true
         },
         { name: "is-test", description: "Show only test chats", isFlag: true },
-        { name: "member-id", description: "Filter by member ID" }
+        { name: "member-id", description: "Filter by member ID" },
+        {
+          name: "chat-type",
+          description: "Filter by chat type (assignment, manager, developer, member, contributor). Default: assignment"
+        }
       ]
     }),
     // Messages
@@ -2852,7 +3100,7 @@ var chatsDomain = {
       description: "List messages for a chat. Use --limit/--offset to page; the API caps a single request at 100. Tool-call shell rows that the API filter excludes (parent_message_id IS NOT NULL or parent_call_id IS NOT NULL) are still hidden \u2014 use `gr chats inspect --id <chat>` for the full debug view.",
       requiresWorkspace: true,
       args: [
-        { name: "chat-id", description: "Chat ID", required: true },
+        { name: "chat-id", aliases: ["id"], description: "Chat ID", required: true },
         {
           name: "limit",
           description: "Max messages to return (1-100, default 100)"
@@ -2875,7 +3123,7 @@ var chatsDomain = {
         }
         const result = await requireAuth(ctx).apiClient.getChatMessages(
           workspace,
-          requireNumber(args, "chat-id"),
+          requireNumberFrom(args, "chat-id", "id"),
           limit,
           offset
         );
@@ -2888,7 +3136,7 @@ var chatsDomain = {
       mutates: true,
       requiresWorkspace: true,
       args: [
-        { name: "chat-id", description: "Chat ID", required: true },
+        { name: "chat-id", aliases: ["id"], description: "Chat ID", required: true },
         { name: "stream", description: "Stream the AI response via AG-UI", isFlag: true }
       ],
       handler: async ({ ctx, workspace, args, data }) => {
@@ -2897,7 +3145,7 @@ var chatsDomain = {
           throw new Error(
             `Message content is required (pass --data '"your message"' or --data '{"content":"your message"}')`
           );
-        const chatId = requireNumber(args, "chat-id");
+        const chatId = requireNumberFrom(args, "chat-id", "id");
         if (args.stream) {
           const aguiClient = new AGUIClient({
             baseUrl: ctx.envConfig.apiUrl,
@@ -2930,11 +3178,11 @@ var chatsDomain = {
       description: "Send an assistant message to a chat (does not trigger AI inference)",
       mutates: true,
       requiresWorkspace: true,
-      args: [{ name: "chat-id", description: "Chat ID", required: true }],
+      args: [{ name: "chat-id", aliases: ["id"], description: "Chat ID", required: true }],
       handler: async ({ ctx, workspace, args, data }) => {
         const result = await requireAuth(ctx).apiClient.sendAssistantMessage(
           workspace,
-          requireNumber(args, "chat-id"),
+          requireNumberFrom(args, "chat-id", "id"),
           data
         );
         outputSingle(result, ctx, MESSAGE_COLUMNS2);
@@ -4975,8 +5223,8 @@ var dataTypesDomain = {
 var RULE_COLUMNS = [
   COL.id(),
   COL.name(),
-  { header: "EVENT", getValue: (item) => item.event_type ?? "" },
-  COL.enabled()
+  { header: "EVENT", getValue: (item) => item.eventType ?? "" },
+  { header: "ACTIVE", getValue: (item) => String(item.active ?? "") }
 ];
 var EVENT_COLUMNS2 = [
   COL.id(),
@@ -4984,29 +5232,33 @@ var EVENT_COLUMNS2 = [
   { header: "SLUG", getValue: (item) => item.slug ?? "" },
   COL.status()
 ];
-var eventRulesCrud = crudCommands({
+var eventRulesCrudNoList = crudCommands({
   prefix: ["events", "rules"],
   entityName: "event rule",
-  listMethod: "getEventRules",
   getMethod: "getEventRule",
   createMethod: "createEventRule",
   updateMethod: "updateEventRule",
   deleteMethod: "deleteEventRule",
-  // The endpoint is paginated and excludes nothing by object_type. Without
-  // 'full', the CLI silently returned only page 1 (default 25 rules), which
-  // hid routine/journey/calendar-scoped rules in workspaces with many
-  // task-scoped rules. 'full' wires up --page/--page-size and --all.
-  paginationSupport: "full",
   columns: RULE_COLUMNS,
   createExamples: [
     `gr events rules create -w $WID --data '{"name":"Label on step","objectType":"journey",`,
     '  "eventType":"journey_step:execute","actionType":"member:label",',
     `  "actionParams":{"addLabelIds":["<label-uuid>"]},"journeyStepId":<step-id>}'`,
     "",
+    "Scheduled outbound (routine \u2192 chat \u2192 voice/SMS):",
+    `gr events rules create -w $WID --allow-write --data '{"name":"AM voice check-in",`,
+    '  "objectType":"routine","eventType":"routine:triggered","actionType":"chat:create",',
+    '  "routineId":<routine-id>,',
+    '  "actionParams":{"workflowId":<workflow-id>,"channel":"phone-voice",',
+    `  "phoneNumberId":<workspace-phone-id>}}'`,
+    "",
+    '  PM SMS variant: use "channel":"phone-sms" and a second rule on the same routineId.',
+    "  Prereq: org phone assigned + gr phone-numbers link; workflow published with start task.",
+    "",
     "Required: objectType, eventType, actionType",
-    "Optional: name, actionParams, conditions (CEL), journeyStepId, delay (sec), order",
+    "Optional: name, actionParams, conditions (CEL), journeyStepId, routineId, delay (sec), order",
     "",
-    "Common eventTypes: journey_step:execute, journey:enrolled, journey:completed,",
+    "Common eventTypes: journey_step:execute, journey:enrolled, routine:triggered,",
     "  task:created, chat:created, data_record:created, member:created",
     "",
     "Common actionTypes: member:label, member:notify, webhook:send, email:send,",
@@ -5015,6 +5267,57 @@ var eventRulesCrud = crudCommands({
     'member:label actionParams: {"addLabelIds":["uuid"],"removeLabelIds":["uuid"]}'
   ]
 });
+var eventRulesListCmd = {
+  path: ["events", "rules", "list"],
+  description: "List event rules (use --journey-step-id or --event-type to filter)",
+  requiresWorkspace: true,
+  columns: RULE_COLUMNS,
+  args: [
+    { name: "journey-step-id", description: "Filter by journey step ID" },
+    { name: "event-type", description: "Filter by event type (e.g. journey_step:execute)" },
+    { name: "object-type", description: "Filter by object type (e.g. journey, task)" },
+    { name: "include-disabled", description: "Include inactive rules", isFlag: true },
+    { name: "page", description: "Page number (without filters)" },
+    { name: "page-size", description: "Page size (without filters)" },
+    {
+      name: "all",
+      description: "Fetch all pages (without filters)",
+      isFlag: true
+    }
+  ],
+  handler: async ({ ctx, workspace, args }) => {
+    const client = requireAuth(ctx).apiClient;
+    const journeyStepId = args["journey-step-id"] ? requireNumber(args, "journey-step-id") : void 0;
+    const eventType = args["event-type"];
+    const objectType = args["object-type"];
+    const includeDisabled = args["include-disabled"] === true;
+    if (journeyStepId !== void 0 || eventType !== void 0 || objectType !== void 0 || includeDisabled) {
+      const result2 = await client.searchEventRules(workspace, {
+        ...journeyStepId !== void 0 ? { journeyStepId } : {},
+        ...eventType ? { eventType } : {},
+        ...objectType ? { objectType } : {},
+        ...includeDisabled ? { includeDisabled: true } : {}
+      });
+      outputData(listResult(result2, false), ctx, RULE_COLUMNS);
+      return;
+    }
+    if (args["all"]) {
+      const allItems = await fetchAllPages(
+        async ({ page: page2, pageSize: pageSize2 }) => client.getEventRules(workspace, { page: page2, pageSize: pageSize2 })
+      );
+      outputData(allItems, ctx, RULE_COLUMNS);
+      return;
+    }
+    const page = args["page"] ? requireNumber(args, "page") : void 0;
+    const pageSize = args["page-size"] ? requireNumber(args, "page-size") : void 0;
+    const result = await client.getEventRules(workspace, {
+      ...page !== void 0 ? { page } : {},
+      ...pageSize !== void 0 ? { pageSize } : {}
+    });
+    outputData(listResult(result, true), ctx, RULE_COLUMNS);
+  }
+};
+var eventRulesCrud = [eventRulesListCmd, ...eventRulesCrudNoList];
 var eventRulesAliases = eventRulesCrud.filter((cmd) => {
   const verb = cmd.path[cmd.path.length - 1];
   return verb === "list" || verb === "get";
@@ -5224,6 +5527,7 @@ var filesDomain = {
 };
 
 // src/domains/journeys.ts
+import { EventRuleEventType } from "@gravity-rail/sdk";
 var JOURNEY_COLUMNS = [
   COL.id(),
   { header: "UUID", getValue: (item) => (item.uuid ?? "").slice(0, 8) },
@@ -5287,6 +5591,15 @@ var NOTE_COLUMNS2 = [
   { header: "CONTENT", getValue: (item) => (item.contents ?? "").slice(0, 60) },
   { header: "CREATED", getValue: (item) => item.createdAt ?? "" }
 ];
+var ACTION_COLUMNS = [
+  COL.id(),
+  { header: "UUID", getValue: (item) => (item.uuid ?? "").slice(0, 8) },
+  COL.name(),
+  { header: "EVENT", getValue: (item) => item.eventType ?? "" },
+  { header: "ACTION", getValue: (item) => item.actionType ?? "" },
+  { header: "ACTIVE", getValue: (item) => String(item.active ?? "") },
+  { header: "CONDITIONS", getValue: (item) => (item.conditions ?? "").slice(0, 40) }
+];
 function baseUrl(ctx, wid) {
   return `${ctx.envConfig.apiUrl}/api/v2/w/${wid}/journeys`;
 }
@@ -6001,6 +6314,70 @@ var journeysDomain = {
         process.stdout.write(`Deleted note ${noteId}
 `);
       }
+    },
+    // ── Step execute actions (event rules scoped to a step) ────────
+    {
+      path: ["journeys", "steps", "actions", "list"],
+      description: "List event rules (actions) attached to a journey step",
+      requiresWorkspace: true,
+      args: [
+        { name: "step-id", description: "Journey step ID (numeric)", required: true },
+        {
+          name: "include-disabled",
+          description: "Include inactive/disabled rules",
+          isFlag: true
+        }
+      ],
+      examples: [
+        "gr journeys steps actions list -w $WID --step-id <step-id>",
+        "gr journeys steps actions list -w $WID --step-id <step-id> --include-disabled"
+      ],
+      handler: async ({ ctx, workspace, args }) => {
+        const stepId = requireNumber(args, "step-id");
+        const includeDisabled = args["include-disabled"] === true;
+        const result = await requireAuth(ctx).apiClient.searchEventRules(workspace, {
+          eventType: EventRuleEventType.JOURNEY_STEP_EXECUTE,
+          journeyStepId: stepId,
+          ...includeDisabled ? { includeDisabled: true } : {}
+        });
+        outputData(listResult(result, false), ctx, ACTION_COLUMNS);
+      }
+    },
+    {
+      path: ["journeys", "steps", "actions", "get"],
+      description: "Get a journey step action (event rule) by ID",
+      requiresWorkspace: true,
+      args: [{ name: "id", description: "Event rule ID", required: true }],
+      examples: ["gr journeys steps actions get -w $WID --id <rule-id>"],
+      handler: async ({ ctx, workspace, args }) => {
+        const id = requireNumber(args, "id");
+        const result = await requireAuth(ctx).apiClient.getEventRule(workspace, id);
+        outputSingle(result, ctx, ACTION_COLUMNS);
+      }
+    },
+    {
+      path: ["journeys", "steps", "actions", "update"],
+      description: "Update a journey step action \u2014 modify template, conditions, or active state",
+      mutates: true,
+      requiresWorkspace: true,
+      args: [{ name: "id", description: "Event rule ID", required: true }],
+      examples: [
+        "gr journeys steps actions update -w $WID --id <rule-id> \\",
+        `  --data '{"actionParams":{"messageTemplate":"Hello {{member.name}}"}}' --allow-write`,
+        "",
+        "Updatable fields: name, conditions (CEL), actionParams, active, delay, order",
+        "Non-updatable: objectType, eventType, actionType, journeyStepId"
+      ],
+      handler: async ({ ctx, workspace, args, data }) => {
+        if (!data) throw new CLIError("JSON data required (--data, --file, or stdin)");
+        const id = requireNumber(args, "id");
+        const result = await requireAuth(ctx).apiClient.updateEventRule(
+          workspace,
+          id,
+          data
+        );
+        outputSingle(result, ctx, ACTION_COLUMNS);
+      }
     }
   ]
 };
@@ -6626,6 +7003,13 @@ var COLUMNS16 = [
   { header: "PREFIX", getValue: (item) => item.prefix ?? "" },
   COL.created()
 ];
+var CREATE_COLUMNS = [
+  COL.id(),
+  COL.name(),
+  { header: "KEY", getValue: (item) => item.key ?? "" },
+  { header: "PREFIX", getValue: (item) => item.prefix ?? "" },
+  COL.created()
+];
 var apiKeysDomain = {
   name: "api-keys",
   description: "Manage API keys",
@@ -6646,7 +7030,10 @@ var apiKeysDomain = {
       requiresWorkspace: true,
       handler: async ({ ctx, workspace, data }) => {
         const result = await requireAuth(ctx).apiClient.createApiKey(workspace, data);
-        outputSingle(result, ctx, COLUMNS16);
+        outputSingle(result, ctx, CREATE_COLUMNS);
+        if (ctx.outputFormat === "table") {
+          process.stdout.write("\n\u26A0  This key will not be shown again. Copy it now.\n");
+        }
       }
     },
     {
@@ -6678,7 +7065,10 @@ var apiKeysDomain = {
       requiresWorkspace: false,
       handler: async ({ ctx, data }) => {
         const result = await requireAuth(ctx).apiClient.createGlobalApiKey(data);
-        outputSingle(result, ctx, COLUMNS16);
+        outputSingle(result, ctx, CREATE_COLUMNS);
+        if (ctx.outputFormat === "table") {
+          process.stdout.write("\n\u26A0  This key will not be shown again. Copy it now.\n");
+        }
       }
     },
     {
@@ -7152,7 +7542,7 @@ var conciergeDomain = {
       path: ["concierge", "messages"],
       description: "Show messages for a concierge chat",
       requiresWorkspace: false,
-      args: [{ name: "id", description: "Chat ID", required: true }],
+      args: [{ name: "id", aliases: ["chat-id"], description: "Chat ID", required: true }],
       handler: async ({ ctx, args }) => {
         const auth = requireAuth(ctx);
         const chatId = Number(args.id);
@@ -7584,7 +7974,7 @@ var milestonesDomain = {
 var COLUMNS23 = [
   COL.id(),
   COL.name(),
-  { header: "TYPE", getValue: (item) => item.type ?? "" },
+  { header: "TYPE", getValue: (item) => item.noticeType ?? "" },
   COL.enabled()
 ];
 var notificationRulesDomain = {
@@ -7785,15 +8175,15 @@ var DOMAIN_UUID_ARG = {
 function pluralize(count, singular, plural = `${singular}s`) {
   return count === 1 ? singular : plural;
 }
-function emailVerifyCommand(path, description) {
+function emailVerifyCommand(path4, description) {
   return {
-    path,
+    path: path4,
     description,
     mutates: true,
     requiresWorkspace: false,
     args: [ORG_UUID_ARG, DOMAIN_UUID_ARG],
     examples: [
-      `yarn gr ${path.join(" ")} --org-uuid $ORG_UUID --domain-uuid $DOMAIN_UUID --allow-write`
+      `yarn gr ${path4.join(" ")} --org-uuid $ORG_UUID --domain-uuid $DOMAIN_UUID --allow-write`
     ],
     handler: async (hctx) => {
       const result = await requireAuth(hctx.ctx).apiClient.verifyOrgDomainEmail(
@@ -7804,15 +8194,15 @@ function emailVerifyCommand(path, description) {
     }
   };
 }
-function siteVerifyCommand(path, description) {
+function siteVerifyCommand(path4, description) {
   return {
-    path,
+    path: path4,
     description,
     mutates: true,
     requiresWorkspace: false,
     args: [ORG_UUID_ARG, DOMAIN_UUID_ARG],
     examples: [
-      `yarn gr ${path.join(" ")} --org-uuid $ORG_UUID --domain-uuid $DOMAIN_UUID --allow-write`
+      `yarn gr ${path4.join(" ")} --org-uuid $ORG_UUID --domain-uuid $DOMAIN_UUID --allow-write`
     ],
     handler: async (hctx) => {
       const result = await requireAuth(hctx.ctx).apiClient.verifyOrgDomainSite(
@@ -7823,9 +8213,9 @@ function siteVerifyCommand(path, description) {
     }
   };
 }
-function registerDomainCommand(path) {
+function registerDomainCommand(path4) {
   return {
-    path,
+    path: path4,
     description: "Register an organization domain and return ownership TXT instructions",
     mutates: true,
     requiresWorkspace: false,
@@ -7834,7 +8224,7 @@ function registerDomainCommand(path) {
       { name: "domain", description: "Domain to register, e.g. example.com", required: true }
     ],
     examples: [
-      `yarn gr ${path.join(" ")} --org-uuid $ORG_UUID --domain example.com --allow-write`
+      `yarn gr ${path4.join(" ")} --org-uuid $ORG_UUID --domain example.com --allow-write`
     ],
     handler: async (hctx) => {
       const result = await requireAuth(hctx.ctx).apiClient.registerOrgDomain(
@@ -8189,6 +8579,12 @@ var commands2 = [
         workspaceUuid
       );
       outputSingle(result, hctx.ctx, PROVIDER_PHONE_COLUMNS);
+      process.stdout.write(
+        `
+If workspace phone list is still empty, create a workspace phone record then:
+  gr phone-numbers link -w ${workspaceUuid} --id <workspace-phone-id> --provider-phone-uuid ${providerPhoneUuid} --allow-write
+`
+      );
     }
   },
   {
@@ -8292,6 +8688,31 @@ var phoneNumbersDomain = {
         outputData(result, ctx, COLUMNS25);
       }
     },
+    {
+      path: ["phone-numbers", "link"],
+      description: "Link a workspace phone number to a provider (org) phone",
+      mutates: true,
+      requiresWorkspace: true,
+      args: [
+        {
+          name: "phone-number-id",
+          aliases: ["id"],
+          description: "Workspace phone number ID",
+          required: true
+        },
+        { name: "provider-phone-uuid", description: "Provider phone UUID", required: true }
+      ],
+      examples: [
+        "gr phone-numbers link -w $WID --id 1 --provider-phone-uuid <uuid> --allow-write"
+      ],
+      handler: async ({ ctx, workspace, args }) => {
+        const auth = requireAuth(ctx);
+        const id = requireNumberFrom(args, "phone-number-id", "id");
+        const providerPhoneUuid = requireString(args, "provider-phone-uuid");
+        const result = await auth.apiClient.linkPhoneNumber(workspace, id, providerPhoneUuid);
+        outputData([result], auth, COLUMNS25);
+      }
+    },
     {
       path: ["phone-numbers", "request"],
       description: "Request a phone number",
@@ -8310,7 +8731,12 @@ var phoneNumbersDomain = {
       description: "List calls for a phone number",
       requiresWorkspace: true,
       args: [
-        { name: "phone-number-id", description: "Phone number ID", required: true },
+        {
+          name: "phone-number-id",
+          aliases: ["id"],
+          description: "Phone number ID",
+          required: true
+        },
         { name: "page", description: "Page number" },
         { name: "page-size", description: "Page size" },
         { name: "status", description: "Filter by status" }
@@ -8319,7 +8745,7 @@ var phoneNumbersDomain = {
         const status = args.status;
         const result = await requireAuth(ctx).apiClient.getPhoneNumberCalls(
           workspace,
-          requireNumber(args, "phone-number-id"),
+          requireNumberFrom(args, "phone-number-id", "id"),
           args.page ? Number(args.page) : void 0,
           args["page-size"] ? Number(args["page-size"]) : void 0,
           status ? { status } : void 0
@@ -8332,14 +8758,19 @@ var phoneNumbersDomain = {
       description: "List messages for a phone number",
       requiresWorkspace: true,
       args: [
-        { name: "phone-number-id", description: "Phone number ID", required: true },
+        {
+          name: "phone-number-id",
+          aliases: ["id"],
+          description: "Phone number ID",
+          required: true
+        },
         { name: "page", description: "Page number" },
         { name: "page-size", description: "Page size" }
       ],
       handler: async ({ ctx, workspace, args }) => {
         const result = await requireAuth(ctx).apiClient.getPhoneNumberMessages(
           workspace,
-          requireNumber(args, "phone-number-id"),
+          requireNumberFrom(args, "phone-number-id", "id"),
           args.page ? Number(args.page) : void 0,
           args["page-size"] ? Number(args["page-size"]) : void 0
         );
@@ -8349,36 +8780,85 @@ var phoneNumbersDomain = {
   ]
 };
 
+// src/lib/resolve-org.ts
+async function resolveOrgUuidFromWorkspace(apiClient, workspaceUuid) {
+  const workspace = await apiClient.getWorkspace(workspaceUuid);
+  const orgUuid = workspace.organizationUuid;
+  if (!orgUuid) {
+    throw new CLIError(
+      "Workspace has no organization; pass --org-uuid for organization-scoped commands"
+    );
+  }
+  return orgUuid;
+}
+function normalizePronunciationCreatePayload(data) {
+  if (!data || typeof data !== "object" || Array.isArray(data)) {
+    throw new CLIError("JSON body required with term and respelling (--data or --file)");
+  }
+  const raw = data;
+  const term = raw.term ?? raw.word;
+  const respelling = raw.respelling ?? raw.pronunciation;
+  if (typeof term !== "string" || !term) {
+    throw new CLIError("Payload requires term (alias: word)");
+  }
+  if (typeof respelling !== "string" || !respelling) {
+    throw new CLIError("Payload requires respelling (alias: pronunciation)");
+  }
+  const payload = { term, respelling };
+  if (raw.accountId !== void 0 && raw.accountId !== null) {
+    payload.accountId = Number(raw.accountId);
+  }
+  return payload;
+}
+function normalizePronunciationUpdatePayload(data) {
+  if (!data || typeof data !== "object" || Array.isArray(data)) {
+    throw new CLIError("JSON body required (--data or --file)");
+  }
+  const raw = data;
+  const respelling = raw.respelling ?? raw.pronunciation;
+  if (typeof respelling !== "string" || !respelling) {
+    throw new CLIError("Payload requires respelling (alias: pronunciation)");
+  }
+  return { respelling };
+}
+
 // src/domains/pronunciations.ts
 var COLUMNS26 = [
   COL.id(),
-  { header: "WORD", getValue: (item) => item.word ?? "" },
-  { header: "PRONUNCIATION", getValue: (item) => item.pronunciation ?? "" },
-  { header: "TYPE", getValue: (item) => item.type ?? "" }
+  { header: "TERM", getValue: (item) => item.term ?? "" },
+  { header: "RESPELLING", getValue: (item) => item.respelling ?? "" },
+  { header: "SCOPE", getValue: (item) => item.scope ?? "" }
+];
+var CREATE_EXAMPLES = [
+  `gr pronunciations create -w $WID --data '{"term":"Jeeves","respelling":"JEEVZ"}' --allow-write`,
+  "  (aliases: word \u2192 term, pronunciation \u2192 respelling)"
 ];
 var pronunciationsDomain = {
   name: "pronunciations",
-  description: "Manage pronunciation entries",
+  description: "Manage pronunciation entries (org-scoped; -w resolves organization)",
   commands: [
     {
       path: ["pronunciations", "list"],
-      description: "List pronunciation entries",
+      description: "List pronunciation entries for the workspace organization",
       requiresWorkspace: true,
       handler: async ({ ctx, workspace }) => {
-        const result = await requireAuth(ctx).apiClient.getPronunciationEntries(workspace);
+        const auth = requireAuth(ctx);
+        const orgUuid = await resolveOrgUuidFromWorkspace(auth.apiClient, workspace);
+        const result = await auth.apiClient.getPronunciationEntries(orgUuid);
         outputData(result, ctx, COLUMNS26);
       }
     },
     {
       path: ["pronunciations", "create"],
-      description: "Create a pronunciation entry",
+      description: "Create a pronunciation entry (term + respelling)",
       mutates: true,
       requiresWorkspace: true,
+      examples: CREATE_EXAMPLES,
       handler: async ({ ctx, workspace, data }) => {
-        const result = await requireAuth(ctx).apiClient.createPronunciationEntry(
-          workspace,
-          data
-        );
+        const auth = requireAuth(ctx);
+        const orgUuid = await resolveOrgUuidFromWorkspace(auth.apiClient, workspace);
+        const payload = normalizePronunciationCreatePayload(data);
+        const result = await auth.apiClient.createPronunciationEntry(orgUuid, payload);
         outputSingle(result, ctx, COLUMNS26);
       }
     },
@@ -8389,10 +8869,13 @@ var pronunciationsDomain = {
       requiresWorkspace: true,
       args: [{ name: "id", description: "Pronunciation entry ID", required: true }],
       handler: async ({ ctx, workspace, args, data }) => {
-        const result = await requireAuth(ctx).apiClient.updatePronunciationEntry(
-          workspace,
+        const auth = requireAuth(ctx);
+        const orgUuid = await resolveOrgUuidFromWorkspace(auth.apiClient, workspace);
+        const payload = normalizePronunciationUpdatePayload(data);
+        const result = await auth.apiClient.updatePronunciationEntry(
+          orgUuid,
           requireNumber(args, "id"),
-          data
+          payload
         );
         outputSingle(result, ctx, COLUMNS26);
       }
@@ -8404,8 +8887,10 @@ var pronunciationsDomain = {
       requiresWorkspace: true,
       args: [{ name: "id", description: "Pronunciation entry ID", required: true }],
       handler: async ({ ctx, workspace, args }) => {
+        const auth = requireAuth(ctx);
+        const orgUuid = await resolveOrgUuidFromWorkspace(auth.apiClient, workspace);
         const id = requireNumber(args, "id");
-        await requireAuth(ctx).apiClient.deletePronunciationEntry(workspace, id);
+        await auth.apiClient.deletePronunciationEntry(orgUuid, id);
         process.stdout.write(`Deleted pronunciation entry ${id}
 `);
       }
@@ -8425,7 +8910,8 @@ var pronunciationsDomain = {
       mutates: true,
       requiresWorkspace: true,
       handler: async ({ ctx, data }) => {
-        const result = await requireAuth(ctx).apiClient.createMyPronunciation(data);
+        const payload = normalizePronunciationCreatePayload(data);
+        const result = await requireAuth(ctx).apiClient.createMyPronunciation(payload);
         outputSingle(result, ctx, COLUMNS26);
       }
     },
@@ -8433,11 +8919,17 @@ var pronunciationsDomain = {
       path: ["pronunciations", "suggest"],
       description: "Get pronunciation suggestions for a word",
       requiresWorkspace: true,
-      args: [{ name: "word", description: "Word to get suggestions for", required: true }],
+      args: [
+        {
+          name: "word",
+          aliases: ["term"],
+          description: "Word to get suggestions for",
+          required: true
+        }
+      ],
       handler: async ({ ctx, args }) => {
-        const result = await requireAuth(ctx).apiClient.suggestPronunciations(
-          requireString(args, "word")
-        );
+        const word = typeof args.word === "string" ? args.word : typeof args.term === "string" ? args.term : requireString(args, "word");
+        const result = await requireAuth(ctx).apiClient.suggestPronunciations(word);
         outputData(result, ctx);
       }
     },
@@ -8603,20 +9095,20 @@ var promptsDomain = {
         "gr prompts inspect --chat-id 789 --turn 3"
       ],
       handler: async ({ ctx, workspace, args }) => {
-        const taskId = args["task-id"] ? requireNumber(args, "task-id") : void 0;
-        const chatId = args["chat-id"] ? requireNumber(args, "chat-id") : void 0;
-        if (!taskId && !chatId) {
+        const taskId = args["task-id"] !== void 0 ? requireNumber(args, "task-id") : void 0;
+        const chatId = args["chat-id"] !== void 0 ? requireNumber(args, "chat-id") : void 0;
+        if (taskId === void 0 && chatId === void 0) {
           throw new Error("Provide --task-id or --chat-id");
         }
-        if (taskId && chatId) {
+        if (taskId !== void 0 && chatId !== void 0) {
           throw new Error("Provide --task-id or --chat-id, not both");
         }
         const channel = args.channel || void 0;
-        const turn = args.turn ? requireNumber(args, "turn") : void 0;
-        const result = await requireAuth(ctx).apiClient.inspectPrompt(workspace, taskId ?? 0, {
-          channel,
-          ...chatId ? { chatId } : {},
-          ...turn ? { turn } : {}
+        const turn = args.turn !== void 0 ? requireNumber(args, "turn") : void 0;
+        const result = await requireAuth(ctx).apiClient.inspectPrompt(workspace, {
+          ...taskId !== void 0 ? { taskId } : { chatId },
+          ...channel ? { channel } : {},
+          ...turn !== void 0 ? { turn } : {}
         });
         outputSingle(result, ctx);
       }
@@ -8624,6 +9116,128 @@ var promptsDomain = {
   ]
 };
 
+// src/domains/support.ts
+var SUPPORT_COLUMNS = [
+  COL.uuid(),
+  { header: "STATUS", getValue: (item) => item.status ?? "" },
+  { header: "TYPE", getValue: (item) => item.supportRequestType ?? "" },
+  { header: "SEVERITY", getValue: (item) => item.severity ?? "" },
+  { header: "SOURCE", getValue: (item) => item.source ?? "" },
+  { header: "CREATED", getValue: (item) => (item.createdAt ?? "").slice(0, 19) },
+  { header: "TITLE", getValue: (item) => item.title ?? "" }
+];
+var CONTEXT_ARGS = [
+  { name: "workspace", aliases: ["w"], description: "Workspace UUID" },
+  { name: "org-uuid", description: "Organization UUID" }
+];
+function listParams(args) {
+  return {
+    page: args.page ? Number(args.page) : void 0,
+    pageSize: args["page-size"] ? Number(args["page-size"]) : void 0,
+    status: args.status,
+    supportRequestType: args.type,
+    severity: args.severity,
+    source: args.source
+  };
+}
+function requestPayload(data, args) {
+  const input = data ?? {};
+  return {
+    supportRequestType: input.supportRequestType ?? input.support_request_type ?? args.type ?? "question",
+    title: input.title ?? requireString(args, "title"),
+    description: input.description ?? requireString(args, "description"),
+    severity: input.severity ?? args.severity
+  };
+}
+function commentPayload(data, args) {
+  const input = data ?? {};
+  return {
+    body: input.body ?? requireString(args, "body")
+  };
+}
+var supportDomain = {
+  name: "support",
+  description: "Manage support requests",
+  commands: [
+    {
+      path: ["support", "list"],
+      description: "List support requests",
+      args: [
+        ...CONTEXT_ARGS,
+        { name: "status", description: "Filter by status" },
+        { name: "type", description: "Filter by type: bug, feature_request, question" },
+        { name: "severity", description: "Filter by severity" },
+        { name: "source", description: "Filter by source" },
+        { name: "page", description: "Page number" },
+        { name: "page-size", description: "Page size" }
+      ],
+      columns: SUPPORT_COLUMNS,
+      handler: async ({ ctx, args, workspace }) => {
+        const client = requireAuth(ctx).apiClient;
+        const wid = args.workspace ?? workspace;
+        const orgUuid = args["org-uuid"];
+        const result = wid ? await client.listWorkspaceSupportRequests(wid, listParams(args)) : orgUuid ? await client.listOrgSupportRequests(orgUuid, listParams(args)) : await client.listSupportRequests(listParams(args));
+        outputData(result, ctx, SUPPORT_COLUMNS);
+      }
+    },
+    {
+      path: ["support", "get"],
+      description: "Get a support request",
+      args: [
+        ...CONTEXT_ARGS,
+        { name: "id", aliases: ["uuid"], description: "Support request UUID", required: true }
+      ],
+      handler: async ({ ctx, args, workspace }) => {
+        const client = requireAuth(ctx).apiClient;
+        const id = requireString(args, "id");
+        const wid = args.workspace ?? workspace;
+        const orgUuid = args["org-uuid"];
+        const result = wid ? await client.getWorkspaceSupportRequest(wid, id) : orgUuid ? await client.getOrgSupportRequest(orgUuid, id) : await client.getSupportRequest(id);
+        outputSingle(result, ctx, SUPPORT_COLUMNS);
+      }
+    },
+    {
+      path: ["support", "create"],
+      description: "Create a support request",
+      mutates: true,
+      args: [
+        ...CONTEXT_ARGS,
+        { name: "type", description: "Request type: bug, feature_request, question" },
+        { name: "title", description: "Support request title" },
+        { name: "description", description: "Support request description" },
+        { name: "severity", description: "Optional severity" }
+      ],
+      handler: async ({ ctx, args, workspace, data }) => {
+        const client = requireAuth(ctx).apiClient;
+        const wid = args.workspace ?? workspace;
+        const orgUuid = args["org-uuid"];
+        const payload = requestPayload(data, args);
+        const result = wid ? await client.createWorkspaceSupportRequest(wid, payload) : orgUuid ? await client.createOrgSupportRequest(orgUuid, payload) : await client.createSupportRequest(payload);
+        outputSingle(result, ctx, SUPPORT_COLUMNS);
+      }
+    },
+    {
+      path: ["support", "comment"],
+      description: "Add a customer comment to a support request",
+      mutates: true,
+      args: [
+        ...CONTEXT_ARGS,
+        { name: "id", aliases: ["uuid"], description: "Support request UUID", required: true },
+        { name: "body", description: "Comment body" }
+      ],
+      handler: async ({ ctx, args, workspace, data }) => {
+        const client = requireAuth(ctx).apiClient;
+        const id = requireString(args, "id");
+        const wid = args.workspace ?? workspace;
+        const orgUuid = args["org-uuid"];
+        const payload = commentPayload(data, args);
+        const result = wid ? await client.commentOnWorkspaceSupportRequest(wid, id, payload) : orgUuid ? await client.commentOnOrgSupportRequest(orgUuid, id, payload) : await client.commentOnSupportRequest(id, payload);
+        outputSingle(result, ctx, SUPPORT_COLUMNS);
+      }
+    }
+  ]
+};
+
 // src/domains/supervisors.ts
 var COLUMNS28 = [
   COL.id(),
@@ -8740,6 +9354,10 @@ var syncDomain = {
         {
           name: "board-id",
           description: "Scope to a single board mapping (requires --entity-type)"
+        },
+        {
+          name: "record-limit",
+          description: "Cap the run to a preview sample (1..200). Requires --dry-run and --entity-type."
         }
       ],
       examples: [
@@ -8748,7 +9366,8 @@ var syncDomain = {
         "sync run --connection-id 6 --full-resync",
         "sync run --connection-id 6 --quiet",
         "sync run --connection-id 6 --entity-type member",
-        "sync run --connection-id 6 --entity-type member --board-id 18406694561"
+        "sync run --connection-id 6 --entity-type member --board-id 18406694561",
+        "sync run --connection-id 6 --dry-run --entity-type member --record-limit 20"
       ],
       mutates: true,
       handler: async ({ ctx, args, workspace }) => {
@@ -8768,12 +9387,39 @@ var syncDomain = {
           entityType = rawEntityType;
         }
         const boardId = args["board-id"];
+        const rawRecordLimit = args["record-limit"];
+        let recordLimit;
+        if (rawRecordLimit !== void 0 && rawRecordLimit !== "") {
+          const parsed = Number(rawRecordLimit);
+          if (!Number.isInteger(parsed) || parsed < 1 || parsed > 200) {
+            throw new CLIError(
+              `Invalid --record-limit "${rawRecordLimit}". Must be an integer between 1 and 200.`
+            );
+          }
+          if (!dryRun) {
+            throw new CLIError(
+              "--record-limit requires --dry-run: capped runs are preview-only."
+            );
+          }
+          if (entityType === void 0) {
+            throw new CLIError(
+              "--record-limit requires --entity-type: capped previews must target a single entity type."
+            );
+          }
+          recordLimit = parsed;
+        }
+        if (fullResync && (dryRun || recordLimit !== void 0)) {
+          throw new CLIError(
+            "--full-resync is incompatible with --dry-run / --record-limit: checkpoint reset must happen on a non-preview run."
+          );
+        }
         if (!quiet) {
           const flags = [
             dryRun && "(dry run)",
             fullResync && "(full re-sync)",
             entityType && `(${entityType} only)`,
-            boardId && `(board ${boardId})`
+            boardId && `(board ${boardId})`,
+            recordLimit !== void 0 && `(limit ${recordLimit})`
           ].filter(Boolean).join(" ");
           console.error(
             `Starting sync for connection ${connectionId}${flags ? ` ${flags}` : ""}...`
@@ -8786,7 +9432,8 @@ var syncDomain = {
             dryRun,
             resetCheckpoints: fullResync,
             entityType,
-            boardId
+            boardId,
+            recordLimit
           }
         );
         if (!response.ok) {
@@ -8980,6 +9627,31 @@ var appConnectionsDomain = {
         );
         outputSingle(result, ctx);
       }
+    },
+    {
+      path: ["app-connections", "relink-member"],
+      description: "Re-enable sync for a previously unlinked member by clearing the manual-unlink exclusion on this connection. Idempotent: returns cleared=false when no exclusion exists.",
+      mutates: true,
+      requiresWorkspace: true,
+      args: [
+        { name: "id", description: "Connection ID (numeric)", required: true },
+        { name: "member-id", description: "Member ID (numeric)", required: true },
+        {
+          name: "board-id",
+          description: "Optional Monday board ID. Required for Monday connections where exclusions are board-scoped; omit for single-scope connectors."
+        }
+      ],
+      handler: async ({ ctx, workspace, args }) => {
+        const boardIdRaw = args["board-id"];
+        const options = boardIdRaw !== void 0 && boardIdRaw !== "" ? { boardId: String(boardIdRaw) } : void 0;
+        const result = await requireAuth(ctx).apiClient.clearConnectionMemberExclusion(
+          workspace,
+          requireNumber(args, "id"),
+          requireNumber(args, "member-id"),
+          options
+        );
+        outputSingle(result, ctx);
+      }
     }
   ]
 };
@@ -9672,49 +10344,6 @@ var mondayDomain = {
         outputData(result, ctx);
       }
     },
-    {
-      path: ["monday", "webhook-get"],
-      description: "Get a Monday.com webhook",
-      requiresWorkspace: true,
-      args: [
-        { name: "board-id", description: "Board ID", required: true },
-        { name: "id", description: "Webhook ID", required: true }
-      ],
-      handler: async ({ ctx, args, workspace }) => {
-        const result = await requireAuth(ctx).apiClient.getMondayWebhook(
-          workspace,
-          requireString(args, "board-id"),
-          requireString(args, "id")
-        );
-        outputSingle(result, ctx);
-      }
-    },
-    {
-      path: ["monday", "webhook-create"],
-      description: "Create a Monday.com webhook",
-      mutates: true,
-      requiresWorkspace: true,
-      handler: async ({ ctx, data, workspace }) => {
-        const result = await requireAuth(ctx).apiClient.createMondayWebhook(
-          workspace,
-          data
-        );
-        outputSingle(result, ctx);
-      }
-    },
-    {
-      path: ["monday", "webhook-delete"],
-      description: "Delete a Monday.com webhook",
-      mutates: true,
-      requiresWorkspace: true,
-      args: [{ name: "id", description: "Webhook ID", required: true }],
-      handler: async ({ ctx, args, workspace }) => {
-        const id = requireString(args, "id");
-        await requireAuth(ctx).apiClient.deleteMondayWebhook(workspace, id);
-        process.stdout.write(`Deleted Monday webhook ${id}
-`);
-      }
-    },
     {
       path: ["monday", "user-info"],
       description: "Get current Monday.com user info",
@@ -10054,6 +10683,113 @@ var slackAppsDomain = {
   ]
 };
 
+// src/domains/integrations/teams-apps.ts
+var COLUMNS33 = [COL.id(), COL.name(), COL.status()];
+function addTeamsUrls(data, apiUrl, workspaceUuid) {
+  const base = `${apiUrl}/api/v2/w/${workspaceUuid}/app-connections/teams`;
+  return {
+    ...data,
+    _urls: {
+      eventsEndpoint: `${base}/events`,
+      oauthUserAuthorize: `${base}/oauth/user/authorize?app_id=${data.id ?? ""}`,
+      oauthUserCallback: `${base}/oauth/user/callback`
+    }
+  };
+}
+var teamsAppsDomain = {
+  name: "teams-apps",
+  description: "Manage Microsoft Teams app integrations",
+  commands: [
+    ...crudCommands({
+      prefix: ["teams-apps"],
+      entityName: "Teams app",
+      listMethod: "getTeamsApps",
+      deleteMethod: "deleteTeamsApp",
+      columns: COLUMNS33,
+      paginationSupport: "full"
+    }),
+    {
+      path: ["teams-apps", "get"],
+      description: "Get a Teams app by ID",
+      args: [{ name: "id", description: "Teams app ID", required: true }],
+      requiresWorkspace: true,
+      handler: async ({ ctx, workspace, args }) => {
+        const result = await requireAuth(ctx).apiClient.getTeamsApp(
+          workspace,
+          requireNumber(args, "id")
+        );
+        outputSingle(addTeamsUrls(result, ctx.envConfig.apiUrl, workspace), ctx);
+      }
+    },
+    {
+      path: ["teams-apps", "create"],
+      description: "Create a Teams app",
+      mutates: true,
+      requiresWorkspace: true,
+      handler: async ({ ctx, workspace, data }) => {
+        if (!data) throw new CLIError("JSON data required (--data, --file, or stdin)");
+        const result = await requireAuth(ctx).apiClient.createTeamsApp(workspace, data);
+        outputSingle(addTeamsUrls(result, ctx.envConfig.apiUrl, workspace), ctx);
+      }
+    },
+    {
+      path: ["teams-apps", "update"],
+      description: "Update a Teams app",
+      mutates: true,
+      args: [{ name: "id", description: "Teams app ID", required: true }],
+      requiresWorkspace: true,
+      handler: async ({ ctx, workspace, args, data }) => {
+        if (!data) throw new CLIError("JSON data required (--data, --file, or stdin)");
+        const result = await requireAuth(ctx).apiClient.updateTeamsApp(
+          workspace,
+          requireNumber(args, "id"),
+          data
+        );
+        outputSingle(addTeamsUrls(result, ctx.envConfig.apiUrl, workspace), ctx);
+      }
+    },
+    {
+      path: ["teams-apps", "conversations"],
+      description: "List Teams conversations linked to chats",
+      requiresWorkspace: true,
+      args: [{ name: "id", description: "Teams app ID", required: true }],
+      handler: async ({ ctx, workspace, args }) => {
+        const result = await requireAuth(ctx).apiClient.getTeamsConversations(
+          workspace,
+          requireNumber(args, "id")
+        );
+        outputData(result, ctx);
+      }
+    },
+    {
+      path: ["teams-apps", "installations"],
+      description: "List per-tenant Teams installations",
+      requiresWorkspace: true,
+      args: [{ name: "id", description: "Teams app ID", required: true }],
+      handler: async ({ ctx, workspace, args }) => {
+        const result = await requireAuth(ctx).apiClient.getTeamsInstallations(
+          workspace,
+          requireNumber(args, "id")
+        );
+        outputData(result, ctx);
+      }
+    },
+    {
+      path: ["teams-apps", "accounts"],
+      description: "List linked Teams (Entra) accounts for this app",
+      requiresWorkspace: true,
+      args: [{ name: "id", description: "Teams app ID", required: true }],
+      handler: async ({ ctx, workspace, args }) => {
+        const result = await requireAuth(ctx).apiClient.getTeamsAppAccounts(
+          workspace,
+          requireNumber(args, "id")
+        );
+        outputData(result, ctx);
+      }
+    }
+  ]
+};
+
 // src/domains/index.ts
 function registerPublicDomains(registry) {
   registry.register(tasksDomain);
@@ -10085,6 +10821,7 @@ function registerPublicDomains(registry) {
   registry.register(mcpServersDomain);
   registry.register(apiKeysDomain);
   registry.register(subscriptionsDomain);
+  registry.register(supportDomain);
   registry.register(reportsDomain);
   registry.register(aiModelsDomain);
   registry.register(featuresDomain);
@@ -10100,6 +10837,7 @@ function registerPublicDomains(registry) {
   registry.register(confluenceDomain);
   registry.register(discordBotsDomain);
   registry.register(slackAppsDomain);
+  registry.register(teamsAppsDomain);
   registry.register(fhirConnectionsDomain);
   registry.register(appConnectionsDomain);
   registry.register(hubspotDomain);
@@ -10109,7 +10847,7 @@ function registerPublicDomains(registry) {
 }
 
 // src/commands/auth-browser.ts
-import { execFile } from "child_process";
+import { execFile as execFile2 } from "child_process";
 async function authBrowserCommand(ctx, args) {
   const noOpen = Boolean(args["no-open"]);
   const account = await ctx.apiClient.getUserAccount();
@@ -10145,15 +10883,363 @@ function openUrl(url) {
     command = "xdg-open";
     args = [url];
   }
-  execFile(command, args, (err) => {
+  execFile2(command, args, (err) => {
     if (err) {
       process.stderr.write("Warning: Could not open browser automatically\n");
     }
   });
 }
 
+// src/lib/cli-client-context.ts
+import path from "path";
+function buildCliConciergeAppContext() {
+  const shell = process.env.SHELL ? path.basename(process.env.SHELL) : void 0;
+  return {
+    clientSurface: "cli",
+    channel: "text",
+    cliContext: {
+      shell,
+      os: process.platform,
+      cwdBasename: path.basename(process.cwd())
+    }
+  };
+}
+
+// src/lib/cli-hitl.ts
+import readline2 from "readline";
+
+// src/lib/local-files.ts
+import fs from "fs";
+import path2 from "path";
+var DEFAULT_MAX_READ_BYTES = 5e4;
+var ABSOLUTE_MAX_READ_BYTES = 1e6;
+function resolveSafePath(root, relativePath) {
+  const rootResolved = path2.resolve(root);
+  const target = path2.resolve(rootResolved, relativePath || ".");
+  if (target !== rootResolved && !target.startsWith(rootResolved + path2.sep)) {
+    return null;
+  }
+  let cursor = rootResolved;
+  const rest = path2.relative(rootResolved, target);
+  if (rest && rest !== ".") {
+    for (const segment of rest.split(path2.sep)) {
+      cursor = path2.join(cursor, segment);
+      try {
+        const lstat = fs.lstatSync(cursor);
+        if (lstat.isSymbolicLink()) {
+          return null;
+        }
+      } catch {
+        break;
+      }
+    }
+  }
+  return target;
+}
+function executeCliLocalFileAction(root, interrupt, opts) {
+  const safe = resolveSafePath(root, interrupt.path);
+  if (!safe) {
+    return { ok: false, error: "Path escapes trusted directory" };
+  }
+  try {
+    switch (interrupt.action) {
+      case "read_file": {
+        if (!fs.existsSync(safe)) {
+          return { ok: false, error: "File not found" };
+        }
+        const stat = fs.lstatSync(safe);
+        if (stat.isSymbolicLink()) {
+          return { ok: false, error: "Path escapes trusted directory" };
+        }
+        if (!stat.isFile()) {
+          return { ok: false, error: "Not a file" };
+        }
+        const requested = Number.isFinite(interrupt.max_bytes) ? Math.max(1, Math.min(Number(interrupt.max_bytes), ABSOLUTE_MAX_READ_BYTES)) : DEFAULT_MAX_READ_BYTES;
+        if (stat.size > requested) {
+          const buf = fs.readFileSync(safe, { encoding: "utf8" });
+          return {
+            ok: true,
+            content: buf.slice(0, requested) + `
+
+[truncated at ${requested} bytes]`
+          };
+        }
+        return { ok: true, content: fs.readFileSync(safe, "utf8") };
+      }
+      case "list_dir": {
+        if (!fs.existsSync(safe)) {
+          return { ok: false, error: "Directory not found" };
+        }
+        const entries = fs.readdirSync(safe, { withFileTypes: true });
+        const lines = entries.slice(0, 200).map((e) => e.isDirectory() ? `${e.name}/` : e.name);
+        if (entries.length > 200) {
+          lines.push(`... and ${entries.length - 200} more`);
+        }
+        return { ok: true, content: lines.join("\n") };
+      }
+      case "write_file": {
+        if (!opts.allowWrite) {
+          return { ok: false, error: "Write requires --allow-write" };
+        }
+        if (interrupt.content === void 0) {
+          return { ok: false, error: "Missing content for write_file" };
+        }
+        fs.mkdirSync(path2.dirname(safe), { recursive: true });
+        fs.writeFileSync(safe, interrupt.content, "utf8");
+        return { ok: true, content: "written" };
+      }
+      default:
+        return { ok: false, error: `Unknown action: ${interrupt.action}` };
+    }
+  } catch (e) {
+    return { ok: false, error: sanitizeLocalFileError(e) };
+  }
+}
+function sanitizeLocalFileError(e) {
+  if (e && typeof e === "object" && "code" in e) {
+    const code = e.code;
+    if (code === "ENOENT") return "File or directory not found";
+    if (code === "EACCES" || code === "EPERM") return "Permission denied";
+    if (code === "EISDIR") return "Not a file";
+    if (code === "ENOTDIR") return "Not a directory";
+  }
+  return "Local file operation failed";
+}
+function isCliLocalFileInterrupt(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const v = value;
+  return v.type === "cli_local_file" && typeof v.action === "string" && typeof v.path === "string";
+}
+
+// src/lib/trusted-dirs.ts
+import fs2 from "fs";
+import os from "os";
+import path3 from "path";
+import readline from "readline";
+var STORE_VERSION = 1;
+function storePath() {
+  const base = process.env.XDG_CONFIG_HOME ?? (process.platform === "win32" ? path3.join(process.env.APPDATA ?? os.homedir(), "gravityrail") : path3.join(os.homedir(), ".config", "gravityrail"));
+  return path3.join(base, "trusted-dirs.json");
+}
+function loadTrustedDirsStore() {
+  const file = storePath();
+  try {
+    const raw = JSON.parse(fs2.readFileSync(file, "utf8"));
+    if (raw?.version === STORE_VERSION && Array.isArray(raw.always)) {
+      return { version: STORE_VERSION, always: raw.always.map((p) => path3.resolve(p)) };
+    }
+  } catch {
+  }
+  return { version: STORE_VERSION, always: [] };
+}
+function saveTrustedDirsStore(store) {
+  const file = storePath();
+  const dir = path3.dirname(file);
+  fs2.mkdirSync(dir, { recursive: true, mode: 448 });
+  fs2.writeFileSync(file, JSON.stringify(store, null, 2) + "\n", { mode: 384 });
+}
+function isDirectoryTrusted(dirPath, opts) {
+  if (opts?.trustCwdFlag) return true;
+  const resolved = path3.resolve(dirPath);
+  const store = loadTrustedDirsStore();
+  return store.always.includes(resolved);
+}
+async function promptTrustInteractive(dirPath) {
+  const rl = readline.createInterface({ input: process.stdin, output: process.stderr });
+  const question = (q) => new Promise((resolve) => rl.question(q, resolve));
+  process.stderr.write(
+    `
+Gravity Rail may read files in:
+  ${dirPath}
+
+File contents can influence the assistant. Do you trust the files in this directory?
+  [1] Trust once (this session)
+  [2] Trust always (remember for this path)
+  [3] No \u2014 do not read local files
+
+Choice [1/2/3] (default 3): `
+  );
+  const answer = (await question("")).trim() || "3";
+  rl.close();
+  if (answer === "1") return "once";
+  if (answer === "2") return "always";
+  return "denied";
+}
+var sessionTrusted = /* @__PURE__ */ new Set();
+async function resolveDirectoryTrust(opts) {
+  const dir = path3.resolve(opts.trustDir ?? opts.cwd ?? process.cwd());
+  if (isDirectoryTrusted(dir, { trustCwdFlag: opts.trustCwd })) return "trusted";
+  if (sessionTrusted.has(dir)) return "trusted";
+  if (opts.trustDir && path3.resolve(opts.trustDir) === dir) {
+    sessionTrusted.add(dir);
+    return "trusted";
+  }
+  if (opts.trustCwd) {
+    sessionTrusted.add(dir);
+    return "trusted";
+  }
+  if (!process.stdin.isTTY || opts.nonInteractive) {
+    return "denied";
+  }
+  const decision = await promptTrustInteractive(dir);
+  if (decision === "denied") {
+    return "denied";
+  }
+  if (decision === "always") {
+    const store = loadTrustedDirsStore();
+    if (!store.always.includes(dir)) {
+      store.always.push(dir);
+      saveTrustedDirsStore(store);
+    }
+  }
+  sessionTrusted.add(dir);
+  return "trusted";
+}
+async function requireDirectoryTrust(opts) {
+  const { CLIError: CLIError2 } = await import("./errors-4MAJGD3C.js");
+  const dir = path3.resolve(opts.trustDir ?? opts.cwd ?? process.cwd());
+  const status = await resolveDirectoryTrust(opts);
+  if (status === "trusted") return;
+  throw new CLIError2(
+    `Directory not trusted: ${dir}
+
+Re-run with --trust-cwd (or --trust-dir <path>) after reviewing files in that directory, or run interactively to approve trust when a local file tool is first used.`
+  );
+}
+
+// src/lib/cli-hitl.ts
+function extractHumanInputRequest(event) {
+  const type = String(event.type ?? "").toUpperCase();
+  if (type === "CUSTOM" && event.name === "human_input_request") {
+    return event.value;
+  }
+  if (event.name === "human_input_request") {
+    return event.value;
+  }
+  return null;
+}
+async function handleCliHitlInterrupt(value, opts) {
+  if (!value || typeof value !== "object") return null;
+  const payload = value;
+  if (isCliLocalFileInterrupt(payload)) {
+    const interrupt = payload;
+    if (typeof payload.interrupt_id === "string") {
+      interrupt.interrupt_id = payload.interrupt_id;
+    }
+    return handleCliLocalFile(interrupt, opts);
+  }
+  if (payload.type === "present_choice") {
+    return handlePresentChoiceTerminal(payload);
+  }
+  return null;
+}
+async function handleCliLocalFile(interrupt, opts) {
+  const trust = await resolveDirectoryTrust({
+    cwd: process.cwd(),
+    trustCwd: opts.trustCwd,
+    trustDir: opts.trustDir,
+    // Interactive sessions: prompt on first local-file use (review feedback).
+    nonInteractive: opts.nonInteractive ?? process.stdin.isTTY !== true
+  });
+  if (trust !== "trusted") {
+    return {
+      resumeValue: JSON.stringify({
+        ok: false,
+        error: "Directory not trusted for local file access. Re-run with --trust-cwd or --trust-dir <path>, or approve trust interactively when prompted."
+      }),
+      resumeInterruptId: interrupt.interrupt_id
+    };
+  }
+  process.stderr.write(`
+[local ${interrupt.action}] ${interrupt.path}
+`);
+  const result = executeCliLocalFileAction(process.cwd(), interrupt, {
+    allowWrite: opts.allowWrite
+  });
+  return {
+    resumeValue: JSON.stringify(result),
+    resumeInterruptId: interrupt.interrupt_id
+  };
+}
+async function handlePresentChoiceTerminal(payload) {
+  const prompt = typeof payload.user_prompt === "string" && payload.user_prompt || typeof payload.description === "string" && payload.description || "Choose an option";
+  const markup = typeof payload.openui_markup === "string" ? payload.openui_markup : "";
+  process.stderr.write(`
+${prompt}
+`);
+  if (markup) {
+    process.stderr.write(`${markup.slice(0, 2e3)}
+`);
+  }
+  if (!process.stdin.isTTY) {
+    return {
+      resumeValue: "",
+      resumeInterruptId: typeof payload.interrupt_id === "string" ? payload.interrupt_id : void 0
+    };
+  }
+  const rl = readline2.createInterface({ input: process.stdin, output: process.stderr });
+  const answer = await new Promise((resolve) => {
+    rl.question("Your choice (value): ", resolve);
+  });
+  rl.close();
+  return {
+    resumeValue: answer.trim(),
+    resumeInterruptId: typeof payload.interrupt_id === "string" ? payload.interrupt_id : void 0
+  };
+}
+
+// src/lib/concierge-agui-loop.ts
+var MAX_HITL_ROUNDS = 25;
+async function runConciergeAguiLoop(client, initialMessages, onEvent, opts) {
+  let streamText = "";
+  let hasToolCalls = false;
+  let resume;
+  for (let round = 0; round < MAX_HITL_ROUNDS; round++) {
+    let hitlPayload = null;
+    await client.streamRequest(
+      resume ? {
+        messages: [],
+        resumeValue: resume.resumeValue,
+        resumeInterruptId: resume.resumeInterruptId
+      } : { messages: initialMessages },
+      (event) => {
+        onEvent(event);
+        const delta = getTextDelta(event);
+        if (delta) streamText += delta;
+        const type = event.type?.toLowerCase() ?? "";
+        if (type === "tool_call_start") hasToolCalls = true;
+        const errorMsg = getErrorMessage(event);
+        if (errorMsg) process.stderr.write(`\x1B[31mError: ${errorMsg}\x1B[0m
+`);
+        const hitl = extractHumanInputRequest(event);
+        if (hitl) hitlPayload = hitl;
+      },
+      { autoApprove: opts.autoApprove }
+    );
+    if (!hitlPayload) {
+      break;
+    }
+    const next = await handleCliHitlInterrupt(hitlPayload, {
+      allowWrite: opts.allowWrite,
+      autoApprove: opts.autoApprove,
+      trustCwd: opts.trustCwd,
+      trustDir: opts.trustDir,
+      nonInteractive: opts.nonInteractive
+    });
+    if (!next) {
+      process.stderr.write(
+        "  [HITL] Unsupported interrupt in CLI \u2014 open app.gravityrail.com/setup to continue.\n"
+      );
+      break;
+    }
+    resume = next;
+    streamText = "";
+  }
+  return { streamText, hasToolCalls };
+}
+
 // src/lib/chat-session.ts
-import * as readline2 from "readline";
+import * as readline4 from "readline";
 
 // src/lib/realtime-client.ts
 import { EventEmitter } from "events";
@@ -11186,7 +12272,7 @@ function buildDebugSummary(_direction, msg) {
 // src/lib/audio.ts
 import { spawn, execSync as execSync2, spawnSync } from "child_process";
 import { EventEmitter as EventEmitter2 } from "events";
-import * as readline from "readline";
+import * as readline3 from "readline";
 var SAMPLE_RATE = 24e3;
 var MIC_CHUNK_BYTES = 4800;
 function checkSoxAvailable() {
@@ -11238,7 +12324,7 @@ async function selectDevice(devices, label) {
   if (devices.length <= 1) {
     return devices[0];
   }
-  const rl = readline.createInterface({
+  const rl = readline3.createInterface({
     input: process.stdin,
     output: process.stderr,
     terminal: true
@@ -11517,56 +12603,52 @@ async function runChatSession(session, args) {
       "Interactive mode requires a TTY. Use --message for non-interactive mode."
     );
   }
+  const allowWrite = !!args["allow-write"] || !!session.allowWrite;
   if (message) {
-    await singleTurnChatSession(session, message, debug, autoApprove);
+    await singleTurnChatSession(session, message, debug, autoApprove, allowWrite);
   } else if (isVoice) {
     await voiceChatSession(session, vadMode(args), args, debug);
   } else if (isRealtime) {
     await realtimeChatSession(session, vadMode(args), debug);
   } else {
-    await interactiveChatSession(session, debug);
+    await interactiveChatSession(session, debug, autoApprove, allowWrite);
   }
 }
 function vadMode(args) {
   return typeof args.vad === "string" ? args.vad : "server";
 }
-async function singleTurnChatSession(session, message, debug, autoApprove = false) {
+async function singleTurnChatSession(session, message, debug, autoApprove = false, allowWrite = false) {
   const aguiClient = new AGUIClient({
     baseUrl: session.ctx.envConfig.apiUrl,
+    workspaceUuid: session.workspaceUuid,
+    chatId: session.chatId,
     endpointUrl: session.aguiEndpointUrl,
     accessToken: session.ctx.accessToken,
     debug,
-    model: session.model
+    model: session.model,
+    appContext: session.appContext
   });
-  let streamText = "";
-  let hasToolCalls = false;
-  let eventCount = 0;
-  const logFile = process.env.GR_SSE_LOG;
-  const fs = logFile ? await import("fs") : null;
-  const logStream = logFile && fs ? fs.createWriteStream(logFile, { flags: "a" }) : null;
-  await aguiClient.sendMessage(
-    [{ role: "user", content: message }],
-    (event) => {
-      eventCount++;
-      if (logStream) logStream.write(JSON.stringify(event) + "\n");
-      const delta = getTextDelta(event);
-      if (delta) streamText += delta;
-      const type = event.type?.toLowerCase() ?? "";
-      if (type === "tool_call_start") {
-        hasToolCalls = true;
-        const name = event.name ?? "";
-        process.stderr.write(`  [${name}]
+  const onEvent = (event) => {
+    const type = event.type?.toLowerCase() ?? "";
+    if (type === "tool_call_start") {
+      const name = event.toolCallName ?? event.name ?? "";
+      process.stderr.write(`  [${name}]
 `);
-      }
-      const errorMsg = getErrorMessage(event);
-      if (errorMsg) process.stderr.write(`\x1B[31mError: ${errorMsg}\x1B[0m
-`);
-    },
-    { autoApprove }
+    }
+  };
+  const { streamText, hasToolCalls } = await runConciergeAguiLoop(
+    aguiClient,
+    [{ role: "user", content: message }],
+    onEvent,
+    {
+      autoApprove,
+      allowWrite: allowWrite || !!session.allowWrite,
+      debug,
+      trustCwd: session.trustCwd,
+      trustDir: session.trustDir,
+      nonInteractive: true
+    }
   );
-  if (logStream) logStream.end();
-  if (debug) process.stderr.write(`  (${eventCount} SSE events)
-`);
   if (streamText) {
     process.stdout.write(`\x1B[32mAssistant:\x1B[0m ${streamText}
 `);
@@ -11600,13 +12682,16 @@ async function singleTurnChatSession(session, message, debug, autoApprove = fals
 `);
   }
 }
-async function interactiveChatSession(session, debug) {
+async function interactiveChatSession(session, debug, autoApprove, allowWrite) {
   const aguiClient = new AGUIClient({
     baseUrl: session.ctx.envConfig.apiUrl,
+    workspaceUuid: session.workspaceUuid,
+    chatId: session.chatId,
     endpointUrl: session.aguiEndpointUrl,
     accessToken: session.ctx.accessToken,
     debug,
-    model: session.model
+    model: session.model,
+    appContext: session.appContext
   });
   clearScreen();
   console.log("=".repeat(60));
@@ -11634,7 +12719,7 @@ async function interactiveChatSession(session, debug) {
       conversationMessages.push({ role: msg.role, content: text });
     }
   }
-  const rl = readline2.createInterface({ input: process.stdin, output: process.stdout });
+  const rl = readline4.createInterface({ input: process.stdin, output: process.stdout });
   return new Promise((resolve) => {
     const prompt = () => {
       rl.question("\x1B[34mYou:\x1B[0m ", async (input) => {
@@ -11652,18 +12737,34 @@ async function interactiveChatSession(session, debug) {
         process.stdout.write("\n\x1B[32mAssistant:\x1B[0m ");
         let assistantContent = "";
         try {
-          await aguiClient.sendMessage(conversationMessages, (event) => {
-            const delta = getTextDelta(event);
-            if (delta) {
-              process.stdout.write(delta);
-              assistantContent += delta;
-            }
-            const errorMsg = getErrorMessage(event);
-            if (errorMsg) console.log(`
+          const { streamText } = await runConciergeAguiLoop(
+            aguiClient,
+            conversationMessages,
+            (event) => {
+              const delta = getTextDelta(event);
+              if (delta) {
+                process.stdout.write(delta);
+                assistantContent += delta;
+              }
+              const errorMsg = getErrorMessage(event);
+              if (errorMsg) console.log(`
 \x1B[31mError: ${errorMsg}\x1B[0m`);
-          });
-          if (assistantContent)
+            },
+            {
+              autoApprove,
+              allowWrite: allowWrite || !!session.allowWrite,
+              debug,
+              trustCwd: session.trustCwd,
+              trustDir: session.trustDir
+            }
+          );
+          if (streamText && !assistantContent) {
+            assistantContent = streamText;
+            process.stdout.write(streamText);
+          }
+          if (assistantContent) {
             conversationMessages.push({ role: "assistant", content: assistantContent });
+          }
           console.log("\n");
         } catch (error) {
           console.log(
@@ -11923,13 +13024,14 @@ async function conciergeCommand(hctx) {
   const chatIdArg = typeof args["chat-id"] === "string" ? args["chat-id"] : void 0;
   const message = typeof args.message === "string" ? args.message : void 0;
   const chat = await getOrCreateConciergeChat(ctx, chatIdArg, !!message);
-  const session = buildConciergeSession(ctx, chat);
+  const session = buildConciergeSession(ctx, chat, args);
   await runChatSession(session, args);
 }
-function buildConciergeSession(ctx, chat) {
+function buildConciergeSession(ctx, chat, args) {
   const wsBase = ctx.envConfig.apiUrl.replace(/^https:/, "wss:").replace(/^http:/, "ws:");
   return {
     ctx,
+    workspaceUuid: "",
     chatId: chat.id,
     chatUuid: chat.uuid,
     chatTitle: chat.title || chat.uuid,
@@ -11937,8 +13039,12 @@ function buildConciergeSession(ctx, chat) {
     wsUrl: `${wsBase}/api/v2/concierge/voice/stream-ws`,
     loadMessages: () => getConciergeChatMessages(ctx, chat.id).catch(() => []),
     label: "Concierge",
-    model: void 0
+    model: void 0,
     // concierge doesn't send model field
+    appContext: buildCliConciergeAppContext(),
+    allowWrite: true,
+    trustCwd: !!args["trust-cwd"],
+    trustDir: typeof args["trust-dir"] === "string" ? args["trust-dir"] : void 0
   };
 }
 async function getOrCreateConciergeChat(ctx, chatIdArg, skipSelection) {
@@ -11974,6 +13080,95 @@ async function getOrCreateConciergeChat(ctx, chatIdArg, skipSelection) {
   return selectedChat;
 }
 
+// src/commands/get-started.ts
+var WEB_SETUP = "https://app.gravityrail.com/setup";
+var WEB_GET_STARTED = "https://app.gravityrail.com/get-started";
+var HUMAN_GUIDE = `Gravity Rail \u2014 getting started
+
+1. Authenticate:  gr login --env prod
+   Confirm:       gr whoami
+
+2. Recommended path \u2014 concierge (no workspace required):
+   gr concierge chat --allow-write
+   The concierge can create your org (auto-created on first login), list products,
+   start Stripe checkout, and create your first workspace.
+
+3. Verify workspaces:  gr workspaces list
+
+4. Web wizards (human-friendly):  ${WEB_SETUP}  and  ${WEB_GET_STARTED}
+
+Headless boundary: Stripe checkout needs a human in a browser \u2014 the concierge returns
+a checkout URL; an agent should hand that link to the user, not loop on payment.
+
+Agent-readable steps:  gr get-started --format llm
+`;
+var LLM_GUIDE = `# Gravity Rail CLI bootstrap (agent instructions)
+
+## Preconditions
+- Install: \`npm install -g @gravity-rail/cli\` or \`npx @gravity-rail/cli\`
+- Authenticate: \`gr login --env prod\` (interactive OAuth). Verify with \`gr whoami\`.
+- **Monorepo dev:** from gravity-team with Docker dev up, use \`yarn gr <cmd> --realm superadmin\` (reads \`dev-realms.json\`; no browser). Rebuild: \`yarn workspace @gravity-rail/gr-cli build\`.
+
+## Important facts
+- **Agents/CI:** do not leave stdin open on read-only commands; use \`GRAVITY_RAIL_API_KEY\` or redirect stdin from /dev/null. Commands only read stdin when \`--data\`/\`--file\` is passed.
+- Use \`--env dev|staging|prod\` (default prod) so credentials match the target; \`gr whoami\` shows the active env.
+- After login, an **organization is created automatically** \u2014 do not create a duplicate org unless \`gr organizations list\` is empty.
+- **Workspace is required** for workflow/agent/task commands (\`-w <workspace-uuid>\`).
+- **Concierge does not require \`-w\`** \u2014 use it for first-run setup.
+
+## Recommended path (concierge-driven)
+\`\`\`bash
+gr concierge chat --allow-write --message "Help me set up my first Gravity Rail workspace"
+\`\`\`
+Flags for unattended turns:
+- \`--message\` / \`-m\`: single-turn (non-interactive)
+- \`--auto-approve\`: skip HITL tool approval where policy allows
+- \`--allow-write\`: required for create/update tools
+
+The concierge can: list/create orgs, list org/workspace products, create Stripe checkout sessions, create workspace specs, and \`create_workspace\`.
+
+## Manual CLI path (if not using concierge)
+1. \`gr whoami\` \u2014 confirm account
+2. \`gr organizations list\` \u2014 note org slug/UUID
+3. \`gr concierge chat\` OR web: ${WEB_GET_STARTED}
+4. Product purchase: concierge returns Stripe checkout URL \u2192 **human must complete in browser**
+5. \`gr workspaces list\` \u2014 pick workspace UUID for \`-w\`
+
+## Support (account-level, no workspace)
+\`\`\`bash
+gr support create --type question --title "..." --description "..." --allow-write
+gr support list
+\`\`\`
+
+## Web fallbacks
+- Concierge / setup: ${WEB_SETUP}
+- Wizard: ${WEB_GET_STARTED}
+
+## Headless limits (do not retry forever)
+- Stripe payment / checkout: requires human browser
+- OAuth login: requires human browser
+- Directory trust for future local-file tools: use \`--trust-cwd\` only after user confirms files are safe
+
+## Local project files (CLI only)
+After directory trust + \`--allow-write\`, the concierge can use \`read_local_file\`, \`list_local_dir\`, \`write_local_file\` (client-executed via HITL).
+
+## Verify success
+\`gr workspaces list\` then \`gr workflows list -w <uuid>\` or \`gr agents list -w <uuid>\`
+`;
+async function getStartedCommand(hctx) {
+  const format = hctx.args.format ?? hctx.args.agent;
+  const isLlm = format === "llm" || format === "agent" || hctx.args["format"] === "llm" || !!hctx.args.agent;
+  if (!isLlm) {
+    try {
+      requireAuth(hctx.ctx);
+    } catch {
+    }
+    process.stdout.write(HUMAN_GUIDE);
+    return;
+  }
+  process.stdout.write(LLM_GUIDE);
+}
+
 // src/commands/dev.ts
 import { existsSync as existsSync2, mkdirSync as mkdirSync2, writeFileSync as writeFileSync2, readFileSync as readFileSync3 } from "fs";
 import { execSync as execSync3 } from "child_process";
@@ -12057,8 +13252,17 @@ async function manageCommand(hctx) {
   const chatIdArg = typeof args["chat-id"] === "string" ? args["chat-id"] : void 0;
   const message = typeof args.message === "string" ? args.message : void 0;
   const chat = await getOrCreateChat(ctx, workspace, chatIdArg, asMember, "manager", !!message);
-  const session = buildWorkspaceSession(ctx, workspace, chat, "Workspace Manager");
+  const session = buildWorkspaceSession(ctx, workspace, chat, "Workspace Manager", {
+    appContext: buildCliConciergeAppContext(),
+    allowWrite: true,
+    trustCwd: !!args["trust-cwd"],
+    trustDir: typeof args["trust-dir"] === "string" ? args["trust-dir"] : void 0
+  });
+  process.stderr.write(`Chat #${session.chatId}
+`);
   await runChatSession(session, args);
+  process.stderr.write(`Chat #${session.chatId}
+`);
 }
 async function chatCommand(hctx) {
   const ctx = requireAuth(hctx.ctx);
@@ -12083,10 +13287,11 @@ async function chatCommand(hctx) {
   const session = buildWorkspaceSession(ctx, workspace, chat, "Chat");
   await runChatSession(session, args);
 }
-function buildWorkspaceSession(ctx, workspace, chat, label) {
+function buildWorkspaceSession(ctx, workspace, chat, label, extra) {
   const wsBase = ctx.envConfig.apiUrl.replace(/^https:/, "wss:").replace(/^http:/, "ws:");
   return {
     ctx,
+    workspaceUuid: workspace,
     chatId: chat.id,
     chatUuid: chat.uuid,
     chatTitle: chat.title || chat.uuid,
@@ -12094,7 +13299,8 @@ function buildWorkspaceSession(ctx, workspace, chat, label) {
     wsUrl: `${wsBase}/api/v2/w/${workspace}/realtime/stream-ws`,
     loadMessages: () => ctx.apiClient.getChatMessages(workspace, chat.id, 50).catch(() => []),
     label,
-    model: "manager"
+    model: "manager",
+    ...extra
   };
 }
 async function getOrCreateChat(ctx, workspace, chatIdArg, asMemberId, chatType, skipSelection = false) {
@@ -12176,7 +13382,7 @@ async function createMemberChat(apiClient, workspace, memberId) {
 }
 
 // src/commands/organizations.ts
-var COLUMNS33 = [
+var COLUMNS34 = [
   { header: "NAME", getValue: (o) => o.organizationName || "", maxWidth: 35 },
   { header: "SLUG", getValue: (o) => o.organizationSlug || "", maxWidth: 25 },
   { header: "UUID", getValue: (o) => o.organizationUuid },
@@ -12184,19 +13390,23 @@ var COLUMNS33 = [
 ];
 async function organizationsListCommand(ctx) {
   const organizations = await ctx.apiClient.getMyOrganizations();
-  outputData(organizations, ctx, COLUMNS33);
+  outputData(organizations, ctx, COLUMNS34);
 }
 
 // src/commands/whoami.ts
-var COLUMNS34 = [
+var COLUMNS35 = [
   { header: "NAME", getValue: (a) => a.name || "", maxWidth: 30 },
   { header: "EMAIL", getValue: (a) => a.email || "", maxWidth: 40 },
   { header: "UUID", getValue: (a) => a.uuid },
+  { header: "ENV", getValue: () => "" },
   { header: "SUPERUSER", getValue: (a) => a.isSuperuser ? "yes" : "no" }
 ];
 async function whoamiCommand(ctx) {
   const account = await ctx.apiClient.getUserAccount();
-  outputSingle(account, ctx, COLUMNS34);
+  const columns = COLUMNS35.map(
+    (col) => col.header === "ENV" ? { ...col, getValue: () => ctx.env } : col
+  );
+  outputSingle(account, ctx, columns);
 }
 export {
   AuthRequiredError,
@@ -12206,6 +13416,7 @@ export {
   LIST_PAGINATION_ARGS,
   PAGINATION_ARGS,
   authBrowserCommand,
+  buildCliConciergeAppContext,
   chatCommand,
   conciergeCommand,
   createAuthenticatedContext,
@@ -12222,8 +13433,10 @@ export {
   formatPaginationWarning,
   getConciergeChat,
   getConciergeChatMessages,
+  getStartedCommand,
   handleError,
   isCursorPaginatedResponse,
+  isDirectoryTrusted,
   isListResult,
   isPagePaginatedResponse,
   isPaginatedResponse,
@@ -12240,6 +13453,7 @@ export {
   readJsonInput,
   registerPublicDomains,
   requireAuth,
+  requireDirectoryTrust,
   requireNumber,
   requireString,
   simpleCrudCommands,