zinkee 0.1.12 → 0.1.17

package/dist/index.js

@@ -660,6 +660,13 @@ var commandRegistry = {
     supportsRaw: false,
     output: writeOutput
   },
+  "records clear": {
+    command: "records clear",
+    accessLevel: "destructive",
+    supportsExample: true,
+    supportsRaw: false,
+    output: writeOutput
+  },
   "comments list": {
     command: "comments list",
     accessLevel: "read",
@@ -1231,574 +1238,27 @@ function formatCliErrorJson(error, meta = {}) {
   return JSON.stringify(buildJsonCliError(error, meta));
 }
 
-// src/api/automations.ts
-function jsonOptions(body, method) {
-  return {
-    method,
-    headers: {
-      "content-type": "application/json"
-    },
-    body: JSON.stringify(body)
-  };
-}
-function selectorValue(selector2) {
-  return encodeURIComponent(selector2.value);
+// src/utils/schema-fields.ts
+function isJsonObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-function segment(value) {
-  return encodeURIComponent(value);
+function toJsonObject(value) {
+  return isJsonObject(value) ? value : void 0;
 }
-function appendQuery(path, query) {
-  const queryString = query.toString();
-  return queryString.length > 0 ? `${path}?${queryString}` : path;
+function toStringValue(value) {
+  return typeof value === "string" && value.trim().length > 0 ? value : void 0;
 }
-var AutomationsApi = class {
-  constructor(client) {
-    this.client = client;
-  }
-  listFolders() {
-    return this.client.getJson("/api/v2/automation-folders");
-  }
-  createFolder(body) {
-    return this.client.requestJson(
-      "/api/v2/automation-folders",
-      jsonOptions(body, "POST")
-    );
-  }
-  updateFolder(folder, body) {
-    return this.client.requestJson(
-      `/api/v2/automation-folders/${selectorValue(folder)}`,
-      jsonOptions(body, "PATCH")
-    );
-  }
-  deleteFolder(folder) {
-    return this.client.requestJson(
-      `/api/v2/automation-folders/${selectorValue(folder)}`,
-      { method: "DELETE" }
-    );
-  }
-  moveAutomation(input) {
-    return this.client.requestJson(
-      `/api/v2/automation-folders/${segment(input.targetFolderId)}/automations:move`,
-      jsonOptions(input, "POST")
-    );
+function toNumberValue(value) {
+  if (typeof value === "number" && Number.isFinite(value)) {
+    return value;
   }
-  listAutomations(query = {}) {
-    const params = new URLSearchParams();
-    if (query.folderId) {
-      params.set("folderId", query.folderId);
-    }
-    if (query.status) {
-      params.set("status", query.status);
-    }
-    if (query.triggerType) {
-      params.set("triggerType", query.triggerType);
-    }
-    if (query.actionType) {
-      params.set("actionType", query.actionType);
-    }
-    if (query.pluginId) {
-      params.set("pluginId", query.pluginId);
-    }
-    if (query.search) {
-      params.set("search", query.search);
+  if (typeof value === "string" && value.trim().length > 0) {
+    const parsed = Number(value);
+    if (Number.isFinite(parsed)) {
+      return parsed;
     }
-    return this.client.getJson(
-      appendQuery("/api/v2/automations", params)
-    );
-  }
-  getAutomation(automation) {
-    return this.client.getJson(
-      `/api/v2/automations/${selectorValue(automation)}`
-    );
-  }
-  createAutomation(input) {
-    return this.client.requestJson(
-      "/api/v2/automations",
-      jsonOptions(input, "POST")
-    );
-  }
-  updateAutomation(automation, input) {
-    return this.client.requestJson(
-      `/api/v2/automations/${selectorValue(automation)}`,
-      jsonOptions(input, "PATCH")
-    );
-  }
-  deleteAutomation(automation) {
-    return this.client.requestJson(
-      `/api/v2/automations/${selectorValue(automation)}`,
-      { method: "DELETE" }
-    );
-  }
-  activateAutomation(automation) {
-    return this.client.requestJson(
-      `/api/v2/automations/${selectorValue(automation)}:activate`,
-      { method: "POST" }
-    );
-  }
-  deactivateAutomation(automation) {
-    return this.client.requestJson(
-      `/api/v2/automations/${selectorValue(automation)}:deactivate`,
-      { method: "POST" }
-    );
-  }
-  getTrigger(automation) {
-    return this.client.getJson(
-      `/api/v2/automations/${selectorValue(automation)}/trigger`
-    );
-  }
-  setTrigger(automation, input) {
-    return this.client.requestJson(
-      `/api/v2/automations/${selectorValue(automation)}/trigger`,
-      jsonOptions(input, "PUT")
-    );
-  }
-  listActions(automation) {
-    return this.client.getJson(
-      `/api/v2/automations/${selectorValue(automation)}/actions`
-    );
-  }
-  addAction(automation, input) {
-    return this.client.requestJson(
-      `/api/v2/automations/${selectorValue(automation)}/actions`,
-      jsonOptions(input, "POST")
-    );
-  }
-  updateAction(automation, actionId, input) {
-    return this.client.requestJson(
-      `/api/v2/automations/${selectorValue(automation)}/actions/${segment(actionId)}`,
-      jsonOptions(input, "PATCH")
-    );
-  }
-  deleteAction(automation, actionId) {
-    return this.client.requestJson(
-      `/api/v2/automations/${selectorValue(automation)}/actions/${segment(actionId)}`,
-      { method: "DELETE" }
-    );
-  }
-  getFlow(automation) {
-    return this.client.getJson(
-      `/api/v2/automations/${selectorValue(automation)}/flow`
-    );
-  }
-  setFlow(automation, input) {
-    return this.client.requestJson(
-      `/api/v2/automations/${selectorValue(automation)}/flow`,
-      jsonOptions(input, "PUT")
-    );
-  }
-  getWebhook(automation) {
-    return this.client.getJson(
-      `/api/v2/automations/${selectorValue(automation)}/webhook-endpoint`
-    );
-  }
-  setWebhook(automation, input) {
-    return this.client.requestJson(
-      `/api/v2/automations/${selectorValue(automation)}/webhook-endpoint`,
-      jsonOptions(input, "PUT")
-    );
-  }
-  deleteWebhook(automation) {
-    return this.client.requestJson(
-      `/api/v2/automations/${selectorValue(automation)}/webhook-endpoint`,
-      { method: "DELETE" }
-    );
-  }
-  listPlugins() {
-    return this.client.getJson("/api/v2/automation-plugins");
-  }
-  getPlugin(pluginId) {
-    return this.client.getJson(
-      `/api/v2/automation-plugins/${segment(pluginId)}`
-    );
-  }
-  listConnections() {
-    return this.client.getJson(
-      "/api/v2/automation-connections"
-    );
-  }
-  getConnection(connection) {
-    return this.client.getJson(
-      `/api/v2/automation-connections/${selectorValue(connection)}`
-    );
-  }
-  createConnection(input) {
-    return this.client.requestJson(
-      "/api/v2/automation-connections",
-      jsonOptions(input, "POST")
-    );
-  }
-  updateConnection(connection, input) {
-    return this.client.requestJson(
-      `/api/v2/automation-connections/${selectorValue(connection)}`,
-      jsonOptions(input, "PATCH")
-    );
-  }
-  deleteConnection(connection) {
-    return this.client.requestJson(
-      `/api/v2/automation-connections/${selectorValue(connection)}`,
-      { method: "DELETE" }
-    );
   }
-};
-
-// src/api/schemas.ts
-function jsonOptions2(body, method) {
-  return {
-    method,
-    headers: {
-      "content-type": "application/json"
-    },
-    body: JSON.stringify(body)
-  };
-}
-function selectorValue2(selector2) {
-  return selector2.value;
-}
-var SchemasApi = class {
-  constructor(client) {
-    this.client = client;
-  }
-  listSchemas() {
-    return this.client.getJson("/api/v2/schemas");
-  }
-  getSchema(schema) {
-    return this.client.getJson(`/api/v2/schemas/${selectorValue2(schema)}`);
-  }
-  createSchema(input) {
-    return this.client.requestJson("/api/v2/schemas", jsonOptions2(input, "POST"));
-  }
-  updateSchema(schema, input) {
-    return this.client.requestJson(
-      `/api/v2/schemas/${selectorValue2(schema)}`,
-      jsonOptions2(input, "PATCH")
-    );
-  }
-  deleteSchema(schema) {
-    return this.client.requestJson(
-      `/api/v2/schemas/${selectorValue2(schema)}`,
-      { method: "DELETE" }
-    );
-  }
-  async listFields(schema) {
-    const result = await this.getSchema(schema);
-    return Array.isArray(result.fields) ? result.fields : [];
-  }
-  getField(schema, field) {
-    return this.client.getJson(
-      `/api/v2/schemas/${selectorValue2(schema)}/fields/${selectorValue2(field)}`
-    );
-  }
-  createField(schema, input) {
-    return this.client.requestJson(
-      `/api/v2/schemas/${selectorValue2(schema)}/fields`,
-      jsonOptions2(input, "POST")
-    );
-  }
-  updateField(schema, field, input) {
-    return this.client.requestJson(
-      `/api/v2/schemas/${selectorValue2(schema)}/fields/${selectorValue2(field)}`,
-      jsonOptions2(input, "PATCH")
-    );
-  }
-  deleteField(schema, field) {
-    return this.client.requestJson(
-      `/api/v2/schemas/${selectorValue2(schema)}/fields/${selectorValue2(field)}`,
-      { method: "DELETE" }
-    );
-  }
-};
-
-// src/config.ts
-import { mkdirSync, readFileSync, writeFileSync } from "fs";
-import { homedir } from "os";
-import { dirname, join } from "path";
-import { parseTOML, stringifyTOML } from "confbox/toml";
-var defaultConfigPath = join(homedir(), ".config", "zinkee", "config.toml");
-var redactedSecretMask = "********";
-var ENV_API_KEY = "ZINKEE_API_KEY";
-var ENV_BASE_URL = "ZINKEE_API_BASE_URL";
-var ENV_PROFILE = "ZINKEE_PROFILE";
-var DEFAULT_PRODUCTION_BASE_URL = "https://api-z2.zinkee.com";
-var ProfileResolutionError = class extends Error {
-  name = "ProfileResolutionError";
-  constructor(message) {
-    super(message);
-  }
-};
-function isRecord2(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function toStringValue(value) {
-  return typeof value === "string" ? value : void 0;
-}
-function toNonEmptyString(value) {
-  const normalized = value?.trim();
-  return normalized ? normalized : void 0;
-}
-function parseProfileConfig(value) {
-  const profile = {};
-  if (!isRecord2(value)) {
-    return profile;
-  }
-  for (const [key, rawValue] of Object.entries(value)) {
-    if (key === "api_key") {
-      profile.apiKey = toStringValue(rawValue);
-      continue;
-    }
-    if (key === "base_url") {
-      profile.baseUrl = toStringValue(rawValue);
-      continue;
-    }
-    profile[key] = rawValue;
-  }
-  return profile;
-}
-function parseConfig(toml) {
-  const parsed = parseTOML(toml);
-  const config = { profiles: {} };
-  if (!isRecord2(parsed)) {
-    return config;
-  }
-  for (const [key, value] of Object.entries(parsed)) {
-    if (key === "default_profile") {
-      config.defaultProfile = toStringValue(value);
-      continue;
-    }
-    if (key === "profiles") {
-      if (!isRecord2(value)) {
-        continue;
-      }
-      for (const [profileName, profileValue] of Object.entries(value)) {
-        config.profiles[profileName] = parseProfileConfig(profileValue);
-      }
-      continue;
-    }
-    config[key] = value;
-  }
-  return config;
-}
-function readConfig(filePath = defaultConfigPath) {
-  return parseConfig(readFileSync(filePath, "utf8"));
-}
-function readConfigIfExists(filePath = defaultConfigPath) {
-  try {
-    return readConfig(filePath);
-  } catch (error) {
-    if (typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT") {
-      return void 0;
-    }
-    throw error;
-  }
-}
-function readRuntimeConfig(filePath = defaultConfigPath) {
-  return readConfigIfExists(filePath) ?? { profiles: {} };
-}
-function serializeProfileConfig(profile) {
-  const serialized = {};
-  for (const [key, value] of Object.entries(profile)) {
-    if (value === void 0) {
-      continue;
-    }
-    if (key === "apiKey") {
-      serialized.api_key = value;
-      continue;
-    }
-    if (key === "baseUrl") {
-      serialized.base_url = value;
-      continue;
-    }
-    serialized[key] = value;
-  }
-  return serialized;
-}
-function serializeConfig(config) {
-  const serialized = {};
-  if (config.defaultProfile !== void 0) {
-    serialized.default_profile = config.defaultProfile;
-  }
-  for (const [key, value] of Object.entries(config)) {
-    if (key === "defaultProfile" || key === "profiles" || value === void 0) {
-      continue;
-    }
-    serialized[key] = value;
-  }
-  const serializedProfiles = Object.fromEntries(
-    Object.entries(config.profiles).map(([name, profile]) => [name, serializeProfileConfig(profile)])
-  );
-  if (Object.keys(serializedProfiles).length > 0) {
-    serialized.profiles = serializedProfiles;
-  }
-  return stringifyTOML(serialized).trimEnd().concat("\n");
-}
-function writeConfig(config, filePath = defaultConfigPath) {
-  mkdirSync(dirname(filePath), { recursive: true });
-  writeFileSync(filePath, serializeConfig(config), "utf8");
-}
-function setProfileConfig(config, profileName, updates) {
-  return {
-    ...config,
-    profiles: {
-      ...config.profiles,
-      [profileName]: {
-        ...config.profiles[profileName],
-        ...updates
-      }
-    }
-  };
-}
-function removeProfileConfig(config, profileName) {
-  const nextProfiles = { ...config.profiles };
-  delete nextProfiles[profileName];
-  return {
-    ...config,
-    defaultProfile: config.defaultProfile === profileName ? void 0 : config.defaultProfile,
-    profiles: nextProfiles
-  };
-}
-function setDefaultProfile(config, profileName) {
-  return {
-    ...config,
-    defaultProfile: profileName
-  };
-}
-function redactSecret(value) {
-  if (value === void 0) {
-    return void 0;
-  }
-  if (value.length <= 4) {
-    return redactedSecretMask;
-  }
-  return `${redactedSecretMask}${value.slice(-4)}`;
-}
-function redactProfile(profile) {
-  return {
-    ...profile,
-    apiKey: redactSecret(profile.apiKey)
-  };
-}
-function redactConfig(config) {
-  return {
-    ...config,
-    profiles: Object.fromEntries(
-      Object.entries(config.profiles).map(([name, profile]) => [name, redactProfile(profile)])
-    )
-  };
-}
-function resolveProfile(config, overrides = {}) {
-  const profileName = overrides.profile ?? config.defaultProfile;
-  if (profileName) {
-    const profile = config.profiles[profileName];
-    if (!profile) {
-      const label = overrides.profile ? "Profile" : "Default profile";
-      throw new ProfileResolutionError(`${label} "${profileName}" not found in config.`);
-    }
-    return {
-      ...profile,
-      name: profileName,
-      baseUrl: overrides.baseUrl ?? profile.baseUrl,
-      apiKey: overrides.apiKey ?? profile.apiKey
-    };
-  }
-  throw new ProfileResolutionError("No profile could be resolved from config.");
-}
-function validateBaseUrl(value) {
-  let parsed;
-  try {
-    parsed = new URL(value);
-  } catch {
-    throw new ProfileResolutionError(
-      `Environment variable ${ENV_BASE_URL} must be an absolute http(s) URL.`
-    );
-  }
-  if (!["http:", "https:"].includes(parsed.protocol) || !parsed.host) {
-    throw new ProfileResolutionError(
-      `Environment variable ${ENV_BASE_URL} must be an absolute http(s) URL.`
-    );
-  }
-  return value.replace(/\/+$/, "");
-}
-function readEnvApiKey(env = process.env) {
-  return toNonEmptyString(env[ENV_API_KEY]);
-}
-function readEnvBaseUrl(env = process.env) {
-  const baseUrl = toNonEmptyString(env[ENV_BASE_URL]);
-  if (!baseUrl) {
-    return void 0;
-  }
-  return validateBaseUrl(baseUrl);
-}
-function readEnvProfile(env = process.env) {
-  return toNonEmptyString(env[ENV_PROFILE]);
-}
-
-// src/runtime-context.ts
-function resolveRuntimeContext(config, overrides = {}) {
-  const envProfile = readEnvProfile();
-  const envApiKey = readEnvApiKey();
-  const envBaseUrl = readEnvBaseUrl();
-  const profileOverride = overrides.profile ?? envProfile;
-  const apiKeyOverride = overrides.apiKey ?? envApiKey;
-  const baseUrlOverride = overrides.baseUrl ?? envBaseUrl;
-  if (apiKeyOverride && !baseUrlOverride) {
-    throw new ProfileResolutionError(
-      `Runtime API key was provided, but ${ENV_BASE_URL} or --base-url is missing.`
-    );
-  }
-  if (baseUrlOverride && !apiKeyOverride) {
-    throw new ProfileResolutionError(
-      `Runtime base URL was provided, but ${ENV_API_KEY} or --api-key is missing.`
-    );
-  }
-  if (apiKeyOverride && baseUrlOverride) {
-    return {
-      profile: profileOverride ?? "runtime",
-      baseUrl: baseUrlOverride,
-      apiKey: apiKeyOverride,
-      readOnly: overrides.readOnly ?? false,
-      json: overrides.json ?? false,
-      profileSource: overrides.profile !== void 0 ? "flag" : envProfile !== void 0 ? "env" : void 0,
-      baseUrlSource: overrides.baseUrl !== void 0 ? "flag" : envBaseUrl !== void 0 ? "env" : void 0,
-      apiKeySource: overrides.apiKey !== void 0 ? "flag" : envApiKey !== void 0 ? "env" : void 0
-    };
-  }
-  const profile = resolveProfile(config, {
-    profile: profileOverride,
-    baseUrl: baseUrlOverride,
-    apiKey: apiKeyOverride
-  });
-  return {
-    profile: profile.name,
-    baseUrl: baseUrlOverride ?? profile.baseUrl ?? DEFAULT_PRODUCTION_BASE_URL,
-    apiKey: apiKeyOverride ?? profile.apiKey,
-    readOnly: overrides.readOnly ?? false,
-    json: overrides.json ?? false,
-    profileSource: overrides.profile !== void 0 ? "flag" : envProfile !== void 0 ? "env" : "config",
-    baseUrlSource: overrides.baseUrl !== void 0 ? "flag" : envBaseUrl !== void 0 ? "env" : "config",
-    apiKeySource: overrides.apiKey !== void 0 ? "flag" : envApiKey !== void 0 ? "env" : "config"
-  };
-}
-
-// src/utils/schema-fields.ts
-function isJsonObject(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function toJsonObject(value) {
-  return isJsonObject(value) ? value : void 0;
-}
-function toStringValue2(value) {
-  return typeof value === "string" && value.trim().length > 0 ? value : void 0;
-}
-function toNumberValue(value) {
-  if (typeof value === "number" && Number.isFinite(value)) {
-    return value;
-  }
-  if (typeof value === "string" && value.trim().length > 0) {
-    const parsed = Number(value);
-    if (Number.isFinite(parsed)) {
-      return parsed;
-    }
-  }
-  return void 0;
+  return void 0;
 }
 var fieldTypeDefinitions = [
   {
@@ -2161,7 +1621,7 @@ var fieldTypeDefinitions = [
             targetSchema: "5223cbc8-8c6c-4694-93bc-dd176364df9b",
             targetDisplayField: "c60b8526-5835-4c9f-aecd-9a16c7704a34",
             deleteBehavior: "RESTRICT",
-            defaultValue: "8ad602a1-f6e3-43f6-9ab2-f1c5afc99621::Ref A",
+            defaultValue: "CUST-12",
             filterFields: [
               {
                 fatherField: "c60b8526-5835-4c9f-aecd-9a16c7704a34",
@@ -2189,17 +1649,17 @@ var fieldTypeDefinitions = [
     className: "FormulaField",
     aliases: ["formula", "FormulaField"],
     description: "Calculated field from a formula.",
-    rawShape: `{"type":"FormulaField","slug":"formula-summary","label":"Formula Summary","config":{"formulaText":"concat(firstName, ' ', lastName)","uiFormatKind":"none"}}`,
+    rawShape: '{"type":"FormulaField","slug":"formula-code","label":"Formula Code","config":{"formulaText":"concat(\\"CUST-\\", f1e1d000-0000-0000-0000-000000000005)","uiFormatKind":"none"}}',
     examplePayloads: [
       {
         name: "Formula field (none)",
         payload: {
           type: "FormulaField",
-          slug: "formula-summary",
-          label: "Formula Summary",
+          slug: "formula-code",
+          label: "Formula Code",
           required: false,
           config: {
-            formulaText: "concat(firstName, ' ', lastName)",
+            formulaText: 'concat("CUST-", f1e1d000-0000-0000-0000-000000000005)',
             uiFormatKind: "none",
             status: "ACTIVE",
             conditionalFormatting: []
@@ -2214,7 +1674,7 @@ var fieldTypeDefinitions = [
           label: "Formula Total",
           required: false,
           config: {
-            formulaText: "amount * 1.21",
+            formulaText: "c52efe3f-2825-4c60-a7e3-34dd4c1ce043 * 1.21",
             uiFormatKind: "number",
             status: "ACTIVE",
             numberFormatOptions: {
@@ -2230,11 +1690,11 @@ var fieldTypeDefinitions = [
         name: "Formula field (date)",
         payload: {
           type: "FormulaField",
-          slug: "formula-deadline",
-          label: "Computed Deadline",
+          slug: "formula-period",
+          label: "Formula Period",
           required: false,
           config: {
-            formulaText: "addDays(startDate, 7)",
+            formulaText: 'date_format(d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90, "AAAA-MM")',
             uiFormatKind: "date",
             status: "ACTIVE",
             dateFormatOptions: {
@@ -2254,7 +1714,7 @@ var fieldTypeDefinitions = [
           label: "Computed Assignee",
           required: false,
           config: {
-            formulaText: "manager",
+            formulaText: "a7b8c9d0-e1f2-3a4b-5c6d-7e8f90123456",
             uiFormatKind: "member",
             status: "ACTIVE",
             conditionalFormatting: []
@@ -2419,8 +1879,8 @@ function normalizeOptionEntries(entries) {
       return [];
     }
     const id = toNumberValue(entry.id);
-    const name = toStringValue2(entry.name) ?? toStringValue2(entry.label);
-    const color = toStringValue2(entry.color) ?? "default";
+    const name = toStringValue(entry.name) ?? toStringValue(entry.label);
+    const color = toStringValue(entry.color) ?? "default";
     if (id === void 0 || !name) {
       return [];
     }
@@ -2477,7 +1937,7 @@ function normalizeReferencePayload(input) {
     ...conditionalFormatting !== void 0 ? { conditionalFormatting } : {}
   };
   const normalizedConfig = toJsonObject(normalized.config) ?? {};
-  if (!toStringValue2(normalizedConfig.targetSchema) || !toStringValue2(normalizedConfig.targetDisplayField)) {
+  if (!toStringValue(normalizedConfig.targetSchema) || !toStringValue(normalizedConfig.targetDisplayField)) {
     const definition = resolveSchemaFieldType("reference");
     throw new CliError(
       "invalid_cli_usage",
@@ -2514,13 +1974,13 @@ function normalizeSchedulePayload(input) {
   };
   const normalizedConfig = toJsonObject(normalized.config) ?? {};
   const definition = resolveSchemaFieldType("schedule");
-  if (!toStringValue2(normalizedConfig.referenceField) || !toStringValue2(normalizedConfig.beginningPeriodField) || !toStringValue2(normalizedConfig.endingPeriodField) || !toStringValue2(normalizedConfig.frequency)) {
+  if (!toStringValue(normalizedConfig.referenceField) || !toStringValue(normalizedConfig.beginningPeriodField) || !toStringValue(normalizedConfig.endingPeriodField) || !toStringValue(normalizedConfig.frequency)) {
     throw new CliError(
       "invalid_cli_usage",
       `Schedule fields require "referenceField", "beginningPeriodField", "endingPeriodField" and "frequency". Expected raw shape: ${definition.rawShape}`
     );
   }
-  const frequencyValue = toStringValue2(normalizedConfig.frequency);
+  const frequencyValue = toStringValue(normalizedConfig.frequency);
   if (!scheduleAllowedFrequencies.has(frequencyValue)) {
     throw new CliError(
       "invalid_cli_usage",
@@ -2549,7 +2009,7 @@ function normalizeFormulaPayload(input) {
     ...config.conditionalFormatting !== void 0 ? { conditionalFormatting: config.conditionalFormatting } : {}
   };
   const normalizedConfig = toJsonObject(normalized.config) ?? {};
-  if (!toStringValue2(normalizedConfig.formulaText)) {
+  if (!toStringValue(normalizedConfig.formulaText)) {
     const definition = resolveSchemaFieldType("formula");
     throw new CliError(
       "invalid_cli_usage",
@@ -2559,7 +2019,7 @@ function normalizeFormulaPayload(input) {
   return normalized;
 }
 function normalizeSchemaFieldCreatePayload(input) {
-  const rawType = toStringValue2(input.type);
+  const rawType = toStringValue(input.type);
   const normalizedType = rawType ? normalizeSchemaFieldType(rawType) : void 0;
   const definition = resolveSchemaFieldTypeByClassName(normalizedType);
   if (!definition) {
@@ -2991,11 +2451,11 @@ var specificExamples = {
     },
     {
       description: "Patch formula field (formula text).",
-      command: `zinkee --json schemas fields update contacts formula-total --raw '{"type":"FormulaField","config":{"formulaText":"amount * 1.10","uiFormatKind":"number","status":"ACTIVE","numberFormatOptions":{"format":"number","decimals":2,"thousandsSeparator":true},"conditionalFormatting":[]}}'`,
+      command: `zinkee --json schemas fields update contacts formula-total --raw '{"type":"FormulaField","config":{"formulaText":"c52efe3f-2825-4c60-a7e3-34dd4c1ce043 * 1.10","uiFormatKind":"number","status":"ACTIVE","numberFormatOptions":{"format":"number","decimals":2,"thousandsSeparator":true},"conditionalFormatting":[]}}'`,
       raw: `{
   "type": "FormulaField",
   "config": {
-    "formulaText": "amount * 1.10",
+    "formulaText": "c52efe3f-2825-4c60-a7e3-34dd4c1ce043 * 1.10",
     "uiFormatKind": "number",
     "status": "ACTIVE",
     "numberFormatOptions": {
@@ -3188,8 +2648,8 @@ var specificExamples = {
 }`
     },
     {
-      description: "Create a record mixing text, option, number, date and reference fields. Structured values go through --set-json.",
-      command: `zinkee --json records create contacts --set contact-name="Grace Hopper" --set contact-email=grace@example.com --set-json status=2 --set-json amount=1999.99 --set due-date=2026-06-01T09:00:00Z --set customer-ref=8ad602a1-f6e3-43f6-9ab2-f1c5afc99621 --set owner=6c8a3e0d-4e5f-4a1b-9c2d-3e4f5a6b7c8d`,
+      description: "Create a record mixing text, option, number, date, reference and member fields. ReferenceField values must match the target's current targetDisplayField (read it from the target record before writing).",
+      command: `zinkee --json records create contacts --set contact-name="Grace Hopper" --set contact-email=grace@example.com --set status=2 --set amount=1999.99 --set due-date=2026-06-01T09:00:00Z --set customer-ref="CUST-12" --set owner=6c8a3e0d-4e5f-4a1b-9c2d-3e4f5a6b7c8d`,
       raw: `{
   "values": {
     "contact-name": "Grace Hopper",
@@ -3197,7 +2657,7 @@ var specificExamples = {
     "status": 2,
     "amount": 1999.99,
     "due-date": "2026-06-01T09:00:00Z",
-    "customer-ref": "8ad602a1-f6e3-43f6-9ab2-f1c5afc99621",
+    "customer-ref": "CUST-12",
     "owner": "6c8a3e0d-4e5f-4a1b-9c2d-3e4f5a6b7c8d"
   }
 }`
@@ -3226,7 +2686,7 @@ var specificExamples = {
     },
     {
       description: "Patch multiple typed values at once.",
-      command: "zinkee --json records update contacts 550e8400-e29b-41d4-a716-446655440000 --set-json status=3 --set-json amount=2500.00 --set due-date=2026-07-01T09:00:00Z --set owner=6c8a3e0d-4e5f-4a1b-9c2d-3e4f5a6b7c8d",
+      command: "zinkee --json records update contacts 550e8400-e29b-41d4-a716-446655440000 --set status=3 --set amount=2500.00 --set due-date=2026-07-01T09:00:00Z --set owner=6c8a3e0d-4e5f-4a1b-9c2d-3e4f5a6b7c8d",
       raw: `{
   "set": {
     "status": 3,
@@ -3906,8 +3366,8 @@ var specificExamples = {
 }`
     },
     {
-      description: "Create a bar CHART widget with a time-serie x-axis and two y-axis series.",
-      command: `zinkee --json displays widgets create 0f6f062f-1478-4df2-96a1-c495d037d260 --type CHART --name "Revenue by month" --origin-resource 2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e --layout '{"x":0,"y":0,"w":8,"h":6}' --chart-type bar --x-axis-field due-date --x-axis-date-format MONTH --x-axis-time-series --y-axis-serie '{"typeCalc":"SUM","fieldCalc":"amount","color":"#4B9CD3","axisType":"BAR"}' --y-axis-serie '{"typeCalc":"COUNT","fieldCalc":"id","color":"#E57373","axisType":"LINE"}' --legend '{"position":"bottom"}'`,
+      description: "Create a bars CHART widget with a time-serie x-axis and two y-axis series.",
+      command: `zinkee --json displays widgets create 0f6f062f-1478-4df2-96a1-c495d037d260 --type CHART --name "Revenue by month" --origin-resource 2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e --layout '{"x":0,"y":0,"w":8,"h":6}' --chart-type bars --x-axis-field due-date --x-axis-date-format MONTH --x-axis-time-series --y-axis-serie '{"typeCalc":"SUM","fieldCalc":"amount","color":"#4B9CD3","axisType":"PRIMARY"}' --y-axis-serie '{"typeCalc":"COUNT","fieldCalc":"id","color":"#E57373","axisType":"SECONDARY"}' --legend '{"position":"bottom"}'`,
       raw: `{
   "type": "CHART",
   "source": {
@@ -3919,7 +3379,7 @@ var specificExamples = {
   },
   "presentation": { "name": "Revenue by month" },
   "chart": {
-    "chartType": "bar",
+    "chartType": "bars",
     "xAxisFieldId": "due-date",
     "xAxisDateFormat": "MONTH",
     "xAxisAsTimeSerie": true,
@@ -3928,13 +3388,13 @@ var specificExamples = {
         "typeCalc": "SUM",
         "fieldCalc": "amount",
         "color": "#4B9CD3",
-        "axisType": "BAR"
+        "axisType": "PRIMARY"
       },
       {
         "typeCalc": "COUNT",
         "fieldCalc": "id",
         "color": "#E57373",
-        "axisType": "LINE"
+        "axisType": "SECONDARY"
       }
     ],
     "legend": { "position": "bottom" }
@@ -4080,11 +3540,11 @@ var specificExamples = {
 }`
     },
     {
-      description: "Replace the chart series with a weekly line.",
-      command: `zinkee --json displays widgets update 0f6f062f-1478-4df2-96a1-c495d037d260 22222222-2222-4222-a222-222222222222 --chart-type line --x-axis-field due-date --x-axis-date-format WEEK --x-axis-time-series --y-axis-serie '{"typeCalc":"SUM","fieldCalc":"amount","color":"#2E7D32","axisType":"LINE"}'`,
+      description: "Replace the chart series with weekly lines.",
+      command: `zinkee --json displays widgets update 0f6f062f-1478-4df2-96a1-c495d037d260 22222222-2222-4222-a222-222222222222 --chart-type lines --x-axis-field due-date --x-axis-date-format WEEK --x-axis-time-series --y-axis-serie '{"typeCalc":"SUM","fieldCalc":"amount","color":"#2E7D32","axisType":"PRIMARY"}'`,
       raw: `{
   "chart": {
-    "chartType": "line",
+    "chartType": "lines",
     "xAxisFieldId": "due-date",
     "xAxisDateFormat": "WEEK",
     "xAxisAsTimeSerie": true,
@@ -4093,7 +3553,7 @@ var specificExamples = {
         "typeCalc": "SUM",
         "fieldCalc": "amount",
         "color": "#2E7D32",
-        "axisType": "LINE"
+        "axisType": "PRIMARY"
       }
     ]
   }
@@ -4421,7 +3881,7 @@ var specificExamples = {
       "required": false,
       "system": false,
       "config": {
-        "formulaText": "amount * 1.21",
+        "formulaText": "c52efe3f-2825-4c60-a7e3-34dd4c1ce043 * 1.21",
         "uiFormatKind": "number",
         "status": "ACTIVE",
         "defaultValue": null,
@@ -4436,12 +3896,12 @@ var specificExamples = {
     {
       "id": "6d7e8f90-1234-5678-9abc-def012345678",
       "type": "FormulaField",
-      "slug": "formula-deadline",
-      "label": "Computed Deadline",
+      "slug": "formula-period",
+      "label": "Formula Period",
       "required": false,
       "system": false,
       "config": {
-        "formulaText": "addDays(startDate, 7)",
+        "formulaText": "date_format(d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90, "AAAA-MM")",
         "uiFormatKind": "date",
         "status": "ACTIVE",
         "defaultValue": null,
@@ -4723,6 +4183,16 @@ var specificExamples = {
       response: `{
   "recordId": "550e8400-e29b-41d4-a716-446655440000",
   "deleted": true
+}`
+    }
+  ]),
+  "records clear": buildCommandExamples([
+    {
+      description: "Delete every record from a schema's table. Heritage rules (CASCADE / SET NULL) propagate to child schemas asynchronously via the CDC pipeline.",
+      command: "zinkee --json records clear contacts",
+      response: `{
+  "schemaId": "2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e",
+  "cleared": true
 }`
     }
   ]),
@@ -5804,7 +5274,7 @@ var specificExamples = {
     },
     {
       description: "Add a search-records action whose condition pulls its value from the trigger payload using --condition-json.",
-      command: `zinkee --json automations actions add automation-1 --type search_records --name "Find duplicates" --target-schema followups --condition-json '{"field":"email","comparator":"eq","values":[{"rawValue":null,"source":{"type":"TRIGGER","id":"payload_value"}}]}'`,
+      command: `zinkee --json automations actions add automation-1 --type search_records --name "Find duplicates" --target-schema followups --condition-json '{"field":"email","comparator":"eq","values":[{"rawValue":null,"source":{"type":"TRIGGER","id":"f1e1d000-0000-0000-0000-000000000005"}}]}'`,
       raw: `{
   "type": "search_records",
   "name": "Find duplicates",
@@ -5819,7 +5289,7 @@ var specificExamples = {
             "rawValue": null,
             "source": {
               "type": "TRIGGER",
-              "id": "payload_value"
+              "id": "f1e1d000-0000-0000-0000-000000000005"
             }
           }
         ]
@@ -6026,744 +5496,689 @@ var specificExamples = {
   "updatedBy": "developer@zinkee.com"
 }`
     }
-  ]),
-  "automations folders create": buildCommandExamples([
-    {
-      description: "Create one flat automation folder.",
-      command: 'zinkee --json automations folders create --name "Codex Frontend Demo"',
-      raw: `{
-  "name": "Codex Frontend Demo"
-}`,
-      response: `{
-  "id": "cdfc14e3-3169-4ffb-8d9b-b11858a9240f",
-  "name": "Codex Frontend Demo",
-  "isRoot": false,
-  "automationCount": 0
-}`
+  ]),
+  "automations folders create": buildCommandExamples([
+    {
+      description: "Create one flat automation folder.",
+      command: 'zinkee --json automations folders create --name "Codex Frontend Demo"',
+      raw: `{
+  "name": "Codex Frontend Demo"
+}`,
+      response: `{
+  "id": "cdfc14e3-3169-4ffb-8d9b-b11858a9240f",
+  "name": "Codex Frontend Demo",
+  "isRoot": false,
+  "automationCount": 0
+}`
+    }
+  ]),
+  "automations folders update": buildCommandExamples([
+    {
+      description: "Rename a non-root automation folder. The folder argument accepts a UUID or an exact name.",
+      command: 'zinkee --json automations folders update "Codex Frontend Demo" --name "Codex Frontend Demo Updated"',
+      raw: `{
+  "name": "Codex Frontend Demo Updated"
+}`,
+      response: `{
+  "id": "cdfc14e3-3169-4ffb-8d9b-b11858a9240f",
+  "name": "Codex Frontend Demo Updated",
+  "isRoot": false,
+  "automationCount": 2
+}`
+    }
+  ]),
+  "automations folders move": buildCommandExamples([
+    {
+      description: "Move one automation into a target folder by exact folder name.",
+      command: 'zinkee --json automations folders move automation-1 --to "Codex Frontend Demo"',
+      raw: `{
+  "automationId": "automation-1"
+}`,
+      response: `{
+  "id": "cdfc14e3-3169-4ffb-8d9b-b11858a9240f",
+  "name": "Codex Frontend Demo",
+  "isRoot": false
+}`
+    }
+  ])
+};
+function fallbackExamples(commandName) {
+  switch (commandName) {
+    default:
+      return [];
+  }
+}
+function buildSchemaFieldCreateExamples(type) {
+  const definitions = getSchemaFieldTypeDefinitions();
+  const selectedDefinition = resolveSchemaFieldType(type);
+  const filteredDefinitions = selectedDefinition ? definitions.filter((definition) => definition.key === selectedDefinition.key) : definitions;
+  const flat = filteredDefinitions.flatMap(
+    (definition) => definition.examplePayloads.map((example) => ({ definition, example }))
+  );
+  return buildCommandExamples(
+    flat.map(({ example }, index) => {
+      const slug = typeof example.payload.slug === "string" ? example.payload.slug : "field";
+      const command = `zinkee --json schemas fields create contacts --raw '${JSON.stringify(example.payload)}'`;
+      if (index === 0) {
+        return {
+          description: example.name,
+          command,
+          response: `{
+  "schemaId": "2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e",
+  "fieldId": "a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890",
+  "slug": "${slug}"
+}`
+        };
+      }
+      return {
+        description: example.name,
+        command
+      };
+    })
+  );
+}
+function getCommandExamples(commandName, filters = {}) {
+  if (commandName === "schemas fields create") {
+    return buildSchemaFieldCreateExamples(filters.type);
+  }
+  return specificExamples[commandName] ?? fallbackExamples(commandName);
+}
+function getResolvedCommandExamples(commandName, filters = {}) {
+  return getCommandExamples(commandName, filters);
+}
+
+// src/cli-examples.ts
+function getStdout(stdout) {
+  return stdout ?? process.stdout;
+}
+function extractExampleFilters(tokens) {
+  const filters = {};
+  for (let index = 0; index < tokens.length; index += 1) {
+    const token = tokens[index];
+    if (token === "--type") {
+      const value = tokens[index + 1];
+      if (value && !value.startsWith("-")) {
+        filters.type = value;
+        index += 1;
+      }
+    }
+  }
+  return filters;
+}
+function extractExampleRequest(argv, optionMeta = createDefaultOptionMetadata()) {
+  if (!argv.includes("--example")) {
+    return null;
+  }
+  const userArgs = argv.slice(2);
+  const operands = collectOperandTokens(userArgs, optionMeta, { skipFlag: "--example" });
+  const cmdPath = findCommandPath(operands, commandRegistry);
+  if (!cmdPath) {
+    throw new CliError("invalid_cli_usage", 'Provide a command after "--example".');
+  }
+  const remainingTokens = userArgs.slice(cmdPath.lastArgvIndex + 1);
+  return {
+    commandName: cmdPath.commandName,
+    filters: extractExampleFilters(remainingTokens),
+    json: argv.includes("--json")
+  };
+}
+function showExamples(commandName, json, stdout, filters = {}) {
+  const examples = getResolvedCommandExamples(commandName, filters);
+  if (examples.length === 0) {
+    throw new CliError("invalid_cli_usage", `No examples registered for "${commandName}".`);
+  }
+  const writer = getStdout(stdout);
+  if (json) {
+    writer.write(`${JSON.stringify(buildJsonSuccess({ examples }, { command: commandName }))}
+`);
+    return;
+  }
+  writer.write("Examples:\n");
+  for (const [index, example] of examples.entries()) {
+    writer.write(`
+${index + 1}. ${example.description}
+`);
+    writer.write(`   ${example.command}
+`);
+    if (example.raw) {
+      writer.write("   Equivalent JSON payload:\n");
+      for (const line of example.raw.split("\n")) {
+        writer.write(`     ${line}
+`);
+      }
+    }
+    if (example.response) {
+      writer.write("   Example response:\n");
+      for (const line of example.response.split("\n")) {
+        writer.write(`     ${line}
+`);
+      }
+    }
+  }
+}
+
+// src/program.ts
+import { createRequire } from "module";
+import { Command as Command10 } from "commander";
+
+// src/config.ts
+import { mkdirSync, readFileSync, writeFileSync } from "fs";
+import { homedir } from "os";
+import { dirname, join } from "path";
+import { parseTOML, stringifyTOML } from "confbox/toml";
+var defaultConfigPath = join(homedir(), ".config", "zinkee", "config.toml");
+var redactedSecretMask = "********";
+var ENV_API_KEY = "ZINKEE_API_KEY";
+var ENV_BASE_URL = "ZINKEE_API_BASE_URL";
+var ENV_PROFILE = "ZINKEE_PROFILE";
+var DEFAULT_PRODUCTION_BASE_URL = "https://api-z2.zinkee.com";
+var ProfileResolutionError = class extends Error {
+  name = "ProfileResolutionError";
+  constructor(message) {
+    super(message);
+  }
+};
+function isRecord2(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function toStringValue2(value) {
+  return typeof value === "string" ? value : void 0;
+}
+function toNonEmptyString(value) {
+  const normalized = value?.trim();
+  return normalized ? normalized : void 0;
+}
+function parseProfileConfig(value) {
+  const profile = {};
+  if (!isRecord2(value)) {
+    return profile;
+  }
+  for (const [key, rawValue] of Object.entries(value)) {
+    if (key === "api_key") {
+      profile.apiKey = toStringValue2(rawValue);
+      continue;
+    }
+    if (key === "base_url") {
+      profile.baseUrl = toStringValue2(rawValue);
+      continue;
+    }
+    profile[key] = rawValue;
+  }
+  return profile;
+}
+function parseConfig(toml) {
+  const parsed = parseTOML(toml);
+  const config = { profiles: {} };
+  if (!isRecord2(parsed)) {
+    return config;
+  }
+  for (const [key, value] of Object.entries(parsed)) {
+    if (key === "default_profile") {
+      config.defaultProfile = toStringValue2(value);
+      continue;
+    }
+    if (key === "profiles") {
+      if (!isRecord2(value)) {
+        continue;
+      }
+      for (const [profileName, profileValue] of Object.entries(value)) {
+        config.profiles[profileName] = parseProfileConfig(profileValue);
+      }
+      continue;
+    }
+    config[key] = value;
+  }
+  return config;
+}
+function readConfig(filePath = defaultConfigPath) {
+  return parseConfig(readFileSync(filePath, "utf8"));
+}
+function readConfigIfExists(filePath = defaultConfigPath) {
+  try {
+    return readConfig(filePath);
+  } catch (error) {
+    if (typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT") {
+      return void 0;
+    }
+    throw error;
+  }
+}
+function readRuntimeConfig(filePath = defaultConfigPath) {
+  return readConfigIfExists(filePath) ?? { profiles: {} };
+}
+function serializeProfileConfig(profile) {
+  const serialized = {};
+  for (const [key, value] of Object.entries(profile)) {
+    if (value === void 0) {
+      continue;
+    }
+    if (key === "apiKey") {
+      serialized.api_key = value;
+      continue;
     }
-  ]),
-  "automations folders update": buildCommandExamples([
-    {
-      description: "Rename a non-root automation folder. The folder argument accepts a UUID or an exact name.",
-      command: 'zinkee --json automations folders update "Codex Frontend Demo" --name "Codex Frontend Demo Updated"',
-      raw: `{
-  "name": "Codex Frontend Demo Updated"
-}`,
-      response: `{
-  "id": "cdfc14e3-3169-4ffb-8d9b-b11858a9240f",
-  "name": "Codex Frontend Demo Updated",
-  "isRoot": false,
-  "automationCount": 2
-}`
+    if (key === "baseUrl") {
+      serialized.base_url = value;
+      continue;
     }
-  ]),
-  "automations folders move": buildCommandExamples([
-    {
-      description: "Move one automation into a target folder by exact folder name.",
-      command: 'zinkee --json automations folders move automation-1 --to "Codex Frontend Demo"',
-      raw: `{
-  "automationId": "automation-1"
-}`,
-      response: `{
-  "id": "cdfc14e3-3169-4ffb-8d9b-b11858a9240f",
-  "name": "Codex Frontend Demo",
-  "isRoot": false
-}`
+    serialized[key] = value;
+  }
+  return serialized;
+}
+function serializeConfig(config) {
+  const serialized = {};
+  if (config.defaultProfile !== void 0) {
+    serialized.default_profile = config.defaultProfile;
+  }
+  for (const [key, value] of Object.entries(config)) {
+    if (key === "defaultProfile" || key === "profiles" || value === void 0) {
+      continue;
     }
-  ])
-};
-function fallbackExamples(commandName) {
-  switch (commandName) {
-    default:
-      return [];
+    serialized[key] = value;
+  }
+  const serializedProfiles = Object.fromEntries(
+    Object.entries(config.profiles).map(([name, profile]) => [name, serializeProfileConfig(profile)])
+  );
+  if (Object.keys(serializedProfiles).length > 0) {
+    serialized.profiles = serializedProfiles;
   }
+  return stringifyTOML(serialized).trimEnd().concat("\n");
 }
-function buildSchemaFieldCreateExamples(type) {
-  const definitions = getSchemaFieldTypeDefinitions();
-  const selectedDefinition = resolveSchemaFieldType(type);
-  const filteredDefinitions = selectedDefinition ? definitions.filter((definition) => definition.key === selectedDefinition.key) : definitions;
-  const flat = filteredDefinitions.flatMap(
-    (definition) => definition.examplePayloads.map((example) => ({ definition, example }))
+function writeConfig(config, filePath = defaultConfigPath) {
+  mkdirSync(dirname(filePath), { recursive: true });
+  writeFileSync(filePath, serializeConfig(config), "utf8");
+}
+function setProfileConfig(config, profileName, updates) {
+  return {
+    ...config,
+    profiles: {
+      ...config.profiles,
+      [profileName]: {
+        ...config.profiles[profileName],
+        ...updates
+      }
+    }
+  };
+}
+function removeProfileConfig(config, profileName) {
+  const nextProfiles = { ...config.profiles };
+  delete nextProfiles[profileName];
+  return {
+    ...config,
+    defaultProfile: config.defaultProfile === profileName ? void 0 : config.defaultProfile,
+    profiles: nextProfiles
+  };
+}
+function setDefaultProfile(config, profileName) {
+  return {
+    ...config,
+    defaultProfile: profileName
+  };
+}
+function redactSecret(value) {
+  if (value === void 0) {
+    return void 0;
+  }
+  if (value.length <= 4) {
+    return redactedSecretMask;
+  }
+  return `${redactedSecretMask}${value.slice(-4)}`;
+}
+function redactProfile(profile) {
+  return {
+    ...profile,
+    apiKey: redactSecret(profile.apiKey)
+  };
+}
+function redactConfig(config) {
+  return {
+    ...config,
+    profiles: Object.fromEntries(
+      Object.entries(config.profiles).map(([name, profile]) => [name, redactProfile(profile)])
+    )
+  };
+}
+function resolveProfile(config, overrides = {}) {
+  const profileName = overrides.profile ?? config.defaultProfile;
+  if (profileName) {
+    const profile = config.profiles[profileName];
+    if (!profile) {
+      const label = overrides.profile ? "Profile" : "Default profile";
+      throw new ProfileResolutionError(`${label} "${profileName}" not found in config.`);
+    }
+    return {
+      ...profile,
+      name: profileName,
+      baseUrl: overrides.baseUrl ?? profile.baseUrl,
+      apiKey: overrides.apiKey ?? profile.apiKey
+    };
+  }
+  throw new ProfileResolutionError("No profile could be resolved from config.");
+}
+function validateBaseUrl(value) {
+  let parsed;
+  try {
+    parsed = new URL(value);
+  } catch {
+    throw new ProfileResolutionError(
+      `Environment variable ${ENV_BASE_URL} must be an absolute http(s) URL.`
+    );
+  }
+  if (!["http:", "https:"].includes(parsed.protocol) || !parsed.host) {
+    throw new ProfileResolutionError(
+      `Environment variable ${ENV_BASE_URL} must be an absolute http(s) URL.`
+    );
+  }
+  return value.replace(/\/+$/, "");
+}
+function readEnvApiKey(env = process.env) {
+  return toNonEmptyString(env[ENV_API_KEY]);
+}
+function readEnvBaseUrl(env = process.env) {
+  const baseUrl = toNonEmptyString(env[ENV_BASE_URL]);
+  if (!baseUrl) {
+    return void 0;
+  }
+  return validateBaseUrl(baseUrl);
+}
+function readEnvProfile(env = process.env) {
+  return toNonEmptyString(env[ENV_PROFILE]);
+}
+
+// src/commands/config.ts
+function getCommandIo(stdout) {
+  return stdout ?? process.stdout;
+}
+function writeLine(stdout, value) {
+  stdout.write(`${value}
+`);
+}
+function getGlobalOptions(command) {
+  return command.optsWithGlobals();
+}
+function emitJson(stdout, commandName, data, configPath) {
+  writeLine(
+    stdout,
+    JSON.stringify(buildJsonSuccess(data, { command: commandName, configPath }))
   );
-  return buildCommandExamples(
-    flat.map(({ example }, index) => {
-      const slug = typeof example.payload.slug === "string" ? example.payload.slug : "field";
-      const command = `zinkee --json schemas fields create contacts --raw '${JSON.stringify(example.payload)}'`;
-      if (index === 0) {
-        return {
-          description: example.name,
-          command,
-          response: `{
-  "schemaId": "2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e",
-  "fieldId": "a8f1d7e3-2b5c-4d9e-8a1b-3c4d5e6f7890",
-  "slug": "${slug}"
-}`
-        };
+}
+function toConfigurationError(filePath, error) {
+  if (error instanceof CliError) {
+    throw error;
+  }
+  if (typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT") {
+    throw new CliError("configuration_error", `Config file not found at ${filePath}.`);
+  }
+  if (error instanceof Error) {
+    throw new CliError("configuration_error", error.message);
+  }
+  throw error;
+}
+function registerConfigCommands(program, options = {}) {
+  const filePath = options.configPath ?? defaultConfigPath;
+  const stdout = getCommandIo(options.stdout);
+  const config = program.command("config").description("Inspect local CLI config");
+  config.command("path").description("Show the effective config file path").action(function action() {
+    const data = { path: filePath };
+    if (getGlobalOptions(this).json) {
+      emitJson(stdout, "config path", data, filePath);
+      return;
+    }
+    writeLine(stdout, filePath);
+  });
+  config.command("show").description("Show the local config with secrets redacted").action(function action() {
+    try {
+      const data = redactConfig(readConfig(filePath));
+      if (getGlobalOptions(this).json) {
+        emitJson(stdout, "config show", data, filePath);
+        return;
       }
-      return {
-        description: example.name,
-        command
+      writeLine(stdout, `Default profile: ${data.defaultProfile ?? "(none)"}`);
+      printTable(
+        Object.entries(data.profiles).map(([name, profile]) => ({
+          name,
+          default: data.defaultProfile === name ? "yes" : "",
+          baseUrl: typeof profile.baseUrl === "string" ? profile.baseUrl : "",
+          apiKey: typeof profile.apiKey === "string" ? profile.apiKey : ""
+        })),
+        ["name", "default", "baseUrl", "apiKey"],
+        stdout
+      );
+    } catch (error) {
+      toConfigurationError(filePath, error);
+    }
+  });
+  config.command("validate").description("Validate that the local config can resolve a profile").action(function action() {
+    try {
+      const parsed = readConfig(filePath);
+      const profile = resolveProfile(parsed);
+      const data = {
+        valid: true,
+        profile: profile.name
       };
-    })
-  );
-}
-function getCommandExamples(commandName, filters = {}) {
-  if (commandName === "schemas fields create") {
-    return buildSchemaFieldCreateExamples(filters.type);
-  }
-  return specificExamples[commandName] ?? fallbackExamples(commandName);
+      if (getGlobalOptions(this).json) {
+        emitJson(stdout, "config validate", data, filePath);
+        return;
+      }
+      writeLine(stdout, `Config is valid. Resolved profile "${profile.name}".`);
+    } catch (error) {
+      toConfigurationError(filePath, error);
+    }
+  });
 }
-function selector(value) {
+
+// src/commands/automations.ts
+import { readFileSync as readFileSync2 } from "fs";
+import { InvalidArgumentError } from "commander";
+
+// src/api/automations.ts
+function jsonOptions(body, method) {
   return {
-    kind: "uuid",
-    value
+    method,
+    headers: {
+      "content-type": "application/json"
+    },
+    body: JSON.stringify(body)
   };
 }
-async function createExampleAutomationContext(options = {}) {
-  if (options.enabled !== true) {
-    return null;
-  }
-  try {
-    const config = readRuntimeConfig(options.configPath ?? defaultConfigPath);
-    const runtime = resolveRuntimeContext(config, options.overrides);
-    if (!runtime.baseUrl) {
-      return null;
-    }
-    const client = new ApiClient({
-      baseUrl: runtime.baseUrl,
-      apiKey: runtime.apiKey
-    });
-    return {
-      automationsApi: new AutomationsApi(client),
-      schemasApi: new SchemasApi(client)
-    };
-  } catch {
-    return null;
-  }
+function selectorValue(selector) {
+  return encodeURIComponent(selector.value);
 }
-function referenceValue(value) {
-  return value.slug ?? value.id;
+function segment(value) {
+  return encodeURIComponent(value);
 }
-function pickExampleField(fields) {
-  return fields.find((field) => !field.required || field.slug || field.id) ?? fields[0];
+function appendQuery(path, query) {
+  const queryString = query.toString();
+  return queryString.length > 0 ? `${path}?${queryString}` : path;
 }
-async function findSchemaFieldReference(context) {
-  const schemas = await context.schemasApi.listSchemas();
-  for (const schema of schemas) {
-    if (typeof schema.id !== "string") {
-      continue;
-    }
-    const fullSchema = await context.schemasApi.getSchema(selector(schema.id));
-    const fields = Array.isArray(fullSchema.fields) ? fullSchema.fields : [];
-    const field = pickExampleField(fields);
-    const schemaRef = referenceValue(schema);
-    const fieldRef = field ? referenceValue(field) : void 0;
-    const fieldId = typeof field?.id === "string" ? field.id : void 0;
-    if (!schemaRef || !fieldRef || !fieldId) {
-      continue;
-    }
-    return {
-      schemaId: schema.id,
-      schemaRef,
-      fieldId,
-      fieldRef
-    };
+var AutomationsApi = class {
+  constructor(client) {
+    this.client = client;
   }
-  return null;
-}
-async function findAutomationId(context) {
-  const automations = await context.automationsApi.listAutomations();
-  const first = automations.find((automation) => typeof automation.id === "string");
-  return typeof first?.id === "string" ? first.id : null;
-}
-async function findAutomationWithAction(context) {
-  const automations = await context.automationsApi.listAutomations();
-  for (const automation of automations) {
-    if (typeof automation.id !== "string") {
-      continue;
-    }
-    const actions = await context.automationsApi.listActions(selector(automation.id));
-    const firstAction = actions.find((action) => typeof action.id === "string");
-    if (typeof firstAction?.id === "string") {
-      return {
-        automationId: automation.id,
-        actionId: firstAction.id
-      };
-    }
+  listFolders() {
+    return this.client.getJson("/api/v2/automation-folders");
   }
-  return null;
-}
-async function buildDynamicAutomationExamples(commandName, options = {}) {
-  const context = await createExampleAutomationContext(options);
-  if (!context) {
-    return [];
+  createFolder(body) {
+    return this.client.requestJson(
+      "/api/v2/automation-folders",
+      jsonOptions(body, "POST")
+    );
   }
-  const schemaField = await findSchemaFieldReference(context);
-  const automationId = await findAutomationId(context);
-  const automationWithAction = await findAutomationWithAction(context);
-  const plugins = await context.automationsApi.listPlugins();
-  const pluginId = typeof plugins[0]?.id === "string" ? plugins[0].id : void 0;
-  const connections = await context.automationsApi.listConnections();
-  const connectionId = typeof connections[0]?.id === "string" ? connections[0].id : void 0;
-  switch (commandName) {
-    case "automations create":
-      if (!schemaField) {
-        return [];
-      }
-      return buildCommandExamples([
-        {
-          description: "Create a scheduled automation with a six-field cron expression. This is the safest first example because it does not depend on workspace schemas.",
-          command: 'zinkee --json automations create --name "Nightly invoice sync" --trigger-type scheduled --cron "0 15 10 * * 1"',
-          raw: `{
-  "name": "Nightly invoice sync",
-  "trigger": {
-    "type": "scheduled",
-    "config": {
-      "cronExpression": "0 15 10 * * 1"
-    }
+  updateFolder(folder, body) {
+    return this.client.requestJson(
+      `/api/v2/automation-folders/${selectorValue(folder)}`,
+      jsonOptions(body, "PATCH")
+    );
   }
-}`,
-          response: `{
-  "automationId": "d2df2478-2513-4ecb-a2aa-2cea8c3d614a",
-  "webhookEndpoint": null
-}`
-        },
-        {
-          description: `Create a record-created automation using a real schema reference from this workspace (${schemaField.schemaRef}), with an 'is not empty' condition on ${schemaField.fieldRef}.`,
-          command: `zinkee --json automations create --name "Record created demo" --trigger-type record_created --trigger-schema ${schemaField.schemaRef} --condition-json '{"field":"${schemaField.fieldRef}","comparator":"ine","values":[{"rawValue":"","source":null}]}'`,
-          raw: `{
-  "name": "Record created demo",
-  "trigger": {
-    "type": "record_created",
-    "config": {
-      "schemaId": "${schemaField.schemaRef}",
-      "conditions": [
-        {
-          "field": "${schemaField.fieldRef}",
-          "comparator": "ine",
-          "values": [{"rawValue": "", "source": null}]
-        }
-      ]
-    }
+  deleteFolder(folder) {
+    return this.client.requestJson(
+      `/api/v2/automation-folders/${selectorValue(folder)}`,
+      { method: "DELETE" }
+    );
   }
-}`
-        },
-        {
-          description: `Create a record-changed automation watching ${schemaField.fieldRef} on ${schemaField.schemaRef}, with an 'is not empty' condition on that field.`,
-          command: `zinkee --json automations create --name "Record changed demo" --trigger-type record_changed --trigger-schema ${schemaField.schemaRef} --trigger-field ${schemaField.fieldRef} --condition-json '{"field":"${schemaField.fieldRef}","comparator":"ine","values":[{"rawValue":"","source":null}]}'`,
-          raw: `{
-  "name": "Record changed demo",
-  "trigger": {
-    "type": "record_changed",
-    "config": {
-      "schemaId": "${schemaField.schemaRef}",
-      "fieldIds": ["${schemaField.fieldRef}"],
-      "conditions": [
-        {
-          "field": "${schemaField.fieldRef}",
-          "comparator": "ine",
-          "values": [{"rawValue": "", "source": null}]
-        }
-      ]
-    }
+  moveAutomation(input) {
+    return this.client.requestJson(
+      `/api/v2/automation-folders/${segment(input.targetFolderId)}/automations:move`,
+      jsonOptions(input, "POST")
+    );
   }
-}`
-        }
-      ]);
-    case "automations trigger set":
-      if (!automationId || !schemaField) {
-        return [];
-      }
-      return buildCommandExamples([
-        {
-          description: "Replace the trigger with a scheduled trigger on a real automation from this workspace.",
-          command: `zinkee --json automations trigger set ${automationId} --trigger-type scheduled --cron "0 15 10 * * 1"`,
-          raw: `{
-  "type": "scheduled",
-  "config": {
-    "cronExpression": "0 15 10 * * 1"
+  listAutomations(query = {}) {
+    const params = new URLSearchParams();
+    if (query.folderId) {
+      params.set("folderId", query.folderId);
+    }
+    if (query.status) {
+      params.set("status", query.status);
+    }
+    if (query.triggerType) {
+      params.set("triggerType", query.triggerType);
+    }
+    if (query.actionType) {
+      params.set("actionType", query.actionType);
+    }
+    if (query.pluginId) {
+      params.set("pluginId", query.pluginId);
+    }
+    if (query.search) {
+      params.set("search", query.search);
+    }
+    return this.client.getJson(
+      appendQuery("/api/v2/automations", params)
+    );
   }
-}`
-        },
-        {
-          description: `Replace the trigger with a record-created trigger on ${schemaField.schemaRef}, with an 'is not empty' condition on ${schemaField.fieldRef}.`,
-          command: `zinkee --json automations trigger set ${automationId} --trigger-type record_created --trigger-schema ${schemaField.schemaRef} --condition-json '{"field":"${schemaField.fieldRef}","comparator":"ine","values":[{"rawValue":"","source":null}]}'`,
-          raw: `{
-  "type": "record_created",
-  "config": {
-    "schemaId": "${schemaField.schemaRef}",
-    "conditions": [
-      {
-        "field": "${schemaField.fieldRef}",
-        "comparator": "ine",
-        "values": [{"rawValue": "", "source": null}]
-      }
-    ]
+  getAutomation(automation) {
+    return this.client.getJson(
+      `/api/v2/automations/${selectorValue(automation)}`
+    );
   }
-}`
-        },
-        {
-          description: `Replace the trigger with a record-changed trigger watching ${schemaField.fieldRef} on ${schemaField.schemaRef}.`,
-          command: `zinkee --json automations trigger set ${automationId} --trigger-type record_changed --trigger-schema ${schemaField.schemaRef} --trigger-field ${schemaField.fieldRef} --condition-json '{"field":"${schemaField.fieldRef}","comparator":"ine","values":[{"rawValue":"","source":null}]}'`,
-          raw: `{
-  "type": "record_changed",
-  "config": {
-    "schemaId": "${schemaField.schemaRef}",
-    "fieldIds": ["${schemaField.fieldRef}"],
-    "conditions": [
-      {
-        "field": "${schemaField.fieldRef}",
-        "comparator": "ine",
-        "values": [{"rawValue": "", "source": null}]
-      }
-    ]
+  createAutomation(input) {
+    return this.client.requestJson(
+      "/api/v2/automations",
+      jsonOptions(input, "POST")
+    );
   }
-}`
-        }
-      ]);
-    case "automations actions add":
-      if (!automationId || !schemaField) {
-        return [];
-      }
-      return buildCommandExamples([
-        {
-          description: `Add a create-record action with literal and trigger-based mappings targeting ${schemaField.schemaRef}.`,
-          command: `zinkee --json automations actions add ${automationId} --type create_record --name "Create follow-up order" --target-schema ${schemaField.schemaRef} --map ${schemaField.fieldRef}=pending --map-json owner='{"rawValue":null,"source":{"type":"TRIGGER","id":"payload_value"}}'`,
-          raw: `{
-  "type": "create_record",
-  "name": "Create follow-up order",
-  "config": {
-    "targetSchemaId": "${schemaField.schemaRef}",
-    "fieldMapping": {
-      "${schemaField.fieldRef}": {
-        "rawValue": "pending",
-        "source": null
-      },
-      "owner": {
-        "rawValue": null,
-        "source": {
-          "type": "TRIGGER",
-          "id": "payload_value"
-        }
-      }
-    }
+  updateAutomation(automation, input) {
+    return this.client.requestJson(
+      `/api/v2/automations/${selectorValue(automation)}`,
+      jsonOptions(input, "PATCH")
+    );
   }
-}`
-        },
-        {
-          description: `Add an update-record action that targets the trigger record on ${schemaField.schemaRef}.`,
-          command: `zinkee --json automations actions add ${automationId} --type update_record --name "Mark record as processed" --target-schema ${schemaField.schemaRef} --use-trigger-record --map ${schemaField.fieldRef}=processed`,
-          raw: `{
-  "type": "update_record",
-  "name": "Mark record as processed",
-  "config": {
-    "targetSchemaId": "${schemaField.schemaRef}",
-    "fieldMapping": {
-      "${schemaField.fieldRef}": {
-        "rawValue": "processed",
-        "source": null
-      }
-    },
-    "useTriggerRecord": true
+  deleteAutomation(automation) {
+    return this.client.requestJson(
+      `/api/v2/automations/${selectorValue(automation)}`,
+      { method: "DELETE" }
+    );
   }
-}`
-        },
-        {
-          description: `Add a search-records action with a trigger-based condition on ${schemaField.schemaRef}.`,
-          command: `zinkee --json automations actions add ${automationId} --type search_records --name "Find duplicates" --target-schema ${schemaField.schemaRef} --condition-json '{"field":"${schemaField.fieldRef}","comparator":"eq","values":[{"rawValue":null,"source":{"type":"TRIGGER","id":"payload_value"}}]}'`,
-          raw: `{
-  "type": "search_records",
-  "name": "Find duplicates",
-  "config": {
-    "targetSchemaId": "${schemaField.schemaRef}",
-    "conditions": [
-      {
-        "field": "${schemaField.fieldRef}",
-        "comparator": "eq",
-        "values": [
-          {
-            "rawValue": null,
-            "source": {
-              "type": "TRIGGER",
-              "id": "payload_value"
-            }
-          }
-        ]
-      }
-    ]
+  activateAutomation(automation) {
+    return this.client.requestJson(
+      `/api/v2/automations/${selectorValue(automation)}:activate`,
+      { method: "POST" }
+    );
   }
-}`
-        },
-        ...connectionId ? buildCommandExamples([
-          {
-            description: `Add an HTTP request action authenticated through a stored connection (${connectionId}).`,
-            command: `zinkee --json automations actions add ${automationId} --type http_request --name "Notify external ERP" --method POST --url https://example.com/integrations/order-status --header X-Demo=codex --content-type application/json --timeout-ms 5000 --auth-mode STORED --connection ${connectionId}`,
-            raw: `{
-  "type": "http_request",
-  "name": "Notify external ERP",
-  "config": {
-    "method": "POST",
-    "url": "https://example.com/integrations/order-status",
-    "headers": {
-      "X-Demo": "codex"
-    },
-    "contentType": "application/json",
-    "timeoutMs": 5000,
-    "authMode": "STORED",
-    "connectionId": "${connectionId}"
+  deactivateAutomation(automation) {
+    return this.client.requestJson(
+      `/api/v2/automations/${selectorValue(automation)}:deactivate`,
+      { method: "POST" }
+    );
   }
-}`
-          }
-        ]) : buildCommandExamples([
-          {
-            description: "Add an HTTP request action through the generic --type path.",
-            command: `zinkee --json automations actions add ${automationId} --type http_request --name "Notify external ERP" --method POST --url https://example.com/integrations/order-status --content-type application/json`,
-            raw: `{
-  "type": "http_request",
-  "name": "Notify external ERP",
-  "config": {
-    "method": "POST",
-    "url": "https://example.com/integrations/order-status",
-    "contentType": "application/json"
+  getTrigger(automation) {
+    return this.client.getJson(
+      `/api/v2/automations/${selectorValue(automation)}/trigger`
+    );
   }
-}`
-          }
-        ]),
-        ...pluginId ? buildCommandExamples([
-          {
-            description: `Add an execute-plugin action using an active plugin from this workspace (${pluginId}).`,
-            command: `zinkee --json automations actions add ${automationId} --type execute_plugin --name "Run billing plugin" --plugin ${pluginId} --arg mode=safe --arg-json steps='["one","two"]'`,
-            raw: `{
-  "type": "execute_plugin",
-  "name": "Run billing plugin",
-  "config": {
-    "pluginId": "${pluginId}",
-    "pluginArgs": {
-      "mode": "safe",
-      "steps": ["one", "two"]
-    }
+  setTrigger(automation, input) {
+    return this.client.requestJson(
+      `/api/v2/automations/${selectorValue(automation)}/trigger`,
+      jsonOptions(input, "PUT")
+    );
   }
-}`
-          }
-        ]) : []
-      ]);
-    case "automations actions update":
-      if (!automationWithAction || !schemaField) {
-        return [];
-      }
-      return buildCommandExamples([
-        {
-          description: "Update a record action on a real automation/action pair using the trigger record.",
-          command: `zinkee --json automations actions update ${automationWithAction.automationId} ${automationWithAction.actionId} --type update_record --name "Update trigger record" --target-schema ${schemaField.schemaRef} --map ${schemaField.fieldRef}=ready --use-trigger-record`,
-          raw: `{
-  "type": "update_record",
-  "name": "Update trigger record",
-  "config": {
-    "targetSchemaId": "${schemaField.schemaRef}",
-    "fieldMapping": {
-      "${schemaField.fieldRef}": {
-        "rawValue": "ready",
-        "source": null
-      }
-    },
-    "useTriggerRecord": true
+  listActions(automation) {
+    return this.client.getJson(
+      `/api/v2/automations/${selectorValue(automation)}/actions`
+    );
   }
-}`,
-          response: `{
-  "id": "${automationWithAction.actionId}",
-  "type": "update_record",
-  "name": "Update trigger record",
-  "config": {
-    "targetSchemaId": "${schemaField.schemaRef}",
-    "fieldMapping": {
-      "${schemaField.fieldRef}": {
-        "rawValue": "ready",
-        "source": null
-      }
-    },
-    "useTriggerRecord": true
+  addAction(automation, input) {
+    return this.client.requestJson(
+      `/api/v2/automations/${selectorValue(automation)}/actions`,
+      jsonOptions(input, "POST")
+    );
   }
-}`
-        }
-      ]);
-    case "automations flow set":
-      if (!automationWithAction) {
-        return [];
-      }
-      return buildCommandExamples([
-        {
-          description: "Set flow entry actions using a real automation/action pair from this workspace.",
-          command: `zinkee --json automations flow set ${automationWithAction.automationId} --entry ${automationWithAction.actionId}`,
-          raw: `{
-  "entryActionIds": ["${automationWithAction.actionId}"],
-  "transitions": []
-}`
-        }
-      ]);
-    case "automations connections create":
-      return buildCommandExamples([
-        {
-          description: "Create a stored workspace connection for HTTP request actions.",
-          command: `zinkee --json automations connections create --name "ERP API Key" --type api_key --scope workspace --config '{"headerName":"Authorization"}' --secret apiKey=super-secret --active`,
-          raw: `{
-  "name": "ERP API Key",
-  "type": "api_key",
-  "scope": "workspace",
-  "config": {
-    "headerName": "Authorization"
-  },
-  "secret": {
-    "apiKey": "super-secret"
-  },
-  "active": true
-}`,
-          response: `{
-  "id": "4fc20b5c-9353-4991-b68e-1027cb674ed4",
-  "name": "ERP API Key",
-  "type": "api_key",
-  "scope": "workspace",
-  "ownerMemberId": "6c8a3e0d-7b1f-4c98-a2e9-8b9a2e3f5b14",
-  "active": true,
-  "config": {
-    "headerName": "Authorization"
-  },
-  "createdAt": "2026-04-21T09:00:00Z",
-  "updatedAt": "2026-04-21T09:00:00Z",
-  "createdBy": "developer@zinkee.com",
-  "updatedBy": "developer@zinkee.com"
-}`
-        }
-      ]);
-    case "automations connections update":
-      if (!connectionId) {
-        return [];
-      }
-      return buildCommandExamples([
-        {
-          description: "Patch an existing stored connection from this workspace.",
-          command: `zinkee --json automations connections update ${connectionId} --raw '{"set":{"name":"ERP API Key Updated","config":{"headerName":"Authorization"}}}'`,
-          raw: `{
-  "set": {
-    "name": "ERP API Key Updated",
-    "config": {
-      "headerName": "Authorization"
-    }
+  updateAction(automation, actionId, input) {
+    return this.client.requestJson(
+      `/api/v2/automations/${selectorValue(automation)}/actions/${segment(actionId)}`,
+      jsonOptions(input, "PATCH")
+    );
   }
-}`,
-          response: `{
-  "id": "${connectionId}",
-  "name": "ERP API Key Updated",
-  "type": "api_key",
-  "scope": "workspace",
-  "ownerMemberId": "6c8a3e0d-7b1f-4c98-a2e9-8b9a2e3f5b14",
-  "active": true,
-  "config": {
-    "headerName": "Authorization"
-  },
-  "createdAt": "2026-04-21T09:00:00Z",
-  "updatedAt": "2026-04-21T10:15:00Z",
-  "createdBy": "developer@zinkee.com",
-  "updatedBy": "developer@zinkee.com"
-}`
-        }
-      ]);
-    default:
-      return [];
+  deleteAction(automation, actionId) {
+    return this.client.requestJson(
+      `/api/v2/automations/${selectorValue(automation)}/actions/${segment(actionId)}`,
+      { method: "DELETE" }
+    );
   }
-}
-async function getResolvedCommandExamples(commandName, filters = {}, options = {}) {
-  const dynamicExamples = commandName.startsWith("automations") ? await buildDynamicAutomationExamples(commandName, options) : [];
-  if (dynamicExamples.length > 0) {
-    return dynamicExamples;
+  getFlow(automation) {
+    return this.client.getJson(
+      `/api/v2/automations/${selectorValue(automation)}/flow`
+    );
   }
-  return getCommandExamples(commandName, filters);
-}
-
-// src/cli-examples.ts
-function getStdout(stdout) {
-  return stdout ?? process.stdout;
-}
-function extractExampleFilters(tokens) {
-  const filters = {};
-  for (let index = 0; index < tokens.length; index += 1) {
-    const token = tokens[index];
-    if (token === "--type") {
-      const value = tokens[index + 1];
-      if (value && !value.startsWith("-")) {
-        filters.type = value;
-        index += 1;
-      }
-    }
+  setFlow(automation, input) {
+    return this.client.requestJson(
+      `/api/v2/automations/${selectorValue(automation)}/flow`,
+      jsonOptions(input, "PUT")
+    );
   }
-  return filters;
-}
-function extractExampleOverrides(tokens) {
-  const overrides = {};
-  for (let index = 0; index < tokens.length; index += 1) {
-    const token = tokens[index];
-    const value = tokens[index + 1];
-    if (!value || value.startsWith("-")) {
-      continue;
-    }
-    if (token === "--profile") {
-      overrides.profile = value;
-      index += 1;
-      continue;
-    }
-    if (token === "--base-url") {
-      overrides.baseUrl = value;
-      index += 1;
-      continue;
-    }
-    if (token === "--api-key") {
-      overrides.apiKey = value;
-      index += 1;
-    }
+  getWebhook(automation) {
+    return this.client.getJson(
+      `/api/v2/automations/${selectorValue(automation)}/webhook-endpoint`
+    );
   }
-  return overrides;
-}
-function extractExampleRequest(argv, optionMeta = createDefaultOptionMetadata()) {
-  if (!argv.includes("--example")) {
-    return null;
+  setWebhook(automation, input) {
+    return this.client.requestJson(
+      `/api/v2/automations/${selectorValue(automation)}/webhook-endpoint`,
+      jsonOptions(input, "PUT")
+    );
   }
-  const userArgs = argv.slice(2);
-  const operands = collectOperandTokens(userArgs, optionMeta, { skipFlag: "--example" });
-  const cmdPath = findCommandPath(operands, commandRegistry);
-  if (!cmdPath) {
-    throw new CliError("invalid_cli_usage", 'Provide a command after "--example".');
+  deleteWebhook(automation) {
+    return this.client.requestJson(
+      `/api/v2/automations/${selectorValue(automation)}/webhook-endpoint`,
+      { method: "DELETE" }
+    );
   }
-  const remainingTokens = userArgs.slice(cmdPath.lastArgvIndex + 1);
-  return {
-    commandName: cmdPath.commandName,
-    filters: extractExampleFilters(remainingTokens),
-    overrides: extractExampleOverrides(argv),
-    json: argv.includes("--json")
-  };
-}
-async function showExamples(commandName, json, stdout, filters = {}, options = {}) {
-  const examples = await getResolvedCommandExamples(commandName, filters, options);
-  if (examples.length === 0) {
-    throw new CliError("invalid_cli_usage", `No examples registered for "${commandName}".`);
+  listPlugins() {
+    return this.client.getJson("/api/v2/automation-plugins");
   }
-  const writer = getStdout(stdout);
-  if (json) {
-    writer.write(`${JSON.stringify(buildJsonSuccess({ examples }, { command: commandName }))}
-`);
-    return;
+  getPlugin(pluginId) {
+    return this.client.getJson(
+      `/api/v2/automation-plugins/${segment(pluginId)}`
+    );
   }
-  writer.write("Examples:\n");
-  for (const [index, example] of examples.entries()) {
-    writer.write(`
-${index + 1}. ${example.description}
-`);
-    writer.write(`   ${example.command}
-`);
-    if (example.raw) {
-      writer.write("   Equivalent JSON payload:\n");
-      for (const line of example.raw.split("\n")) {
-        writer.write(`     ${line}
-`);
-      }
-    }
-    if (example.response) {
-      writer.write("   Example response:\n");
-      for (const line of example.response.split("\n")) {
-        writer.write(`     ${line}
-`);
-      }
-    }
+  listConnections() {
+    return this.client.getJson(
+      "/api/v2/automation-connections"
+    );
   }
-}
-
-// src/program.ts
-import { createRequire } from "module";
-import { Command as Command10 } from "commander";
-
-// src/commands/config.ts
-function getCommandIo(stdout) {
-  return stdout ?? process.stdout;
-}
-function writeLine(stdout, value) {
-  stdout.write(`${value}
-`);
-}
-function getGlobalOptions(command) {
-  return command.optsWithGlobals();
-}
-function emitJson(stdout, commandName, data, configPath) {
-  writeLine(
-    stdout,
-    JSON.stringify(buildJsonSuccess(data, { command: commandName, configPath }))
-  );
-}
-function toConfigurationError(filePath, error) {
-  if (error instanceof CliError) {
-    throw error;
+  getConnection(connection) {
+    return this.client.getJson(
+      `/api/v2/automation-connections/${selectorValue(connection)}`
+    );
   }
-  if (typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT") {
-    throw new CliError("configuration_error", `Config file not found at ${filePath}.`);
+  createConnection(input) {
+    return this.client.requestJson(
+      "/api/v2/automation-connections",
+      jsonOptions(input, "POST")
+    );
   }
-  if (error instanceof Error) {
-    throw new CliError("configuration_error", error.message);
+  updateConnection(connection, input) {
+    return this.client.requestJson(
+      `/api/v2/automation-connections/${selectorValue(connection)}`,
+      jsonOptions(input, "PATCH")
+    );
   }
-  throw error;
-}
-function registerConfigCommands(program, options = {}) {
-  const filePath = options.configPath ?? defaultConfigPath;
-  const stdout = getCommandIo(options.stdout);
-  const config = program.command("config").description("Inspect local CLI config");
-  config.command("path").description("Show the effective config file path").action(function action() {
-    const data = { path: filePath };
-    if (getGlobalOptions(this).json) {
-      emitJson(stdout, "config path", data, filePath);
-      return;
-    }
-    writeLine(stdout, filePath);
-  });
-  config.command("show").description("Show the local config with secrets redacted").action(function action() {
-    try {
-      const data = redactConfig(readConfig(filePath));
-      if (getGlobalOptions(this).json) {
-        emitJson(stdout, "config show", data, filePath);
-        return;
-      }
-      writeLine(stdout, `Default profile: ${data.defaultProfile ?? "(none)"}`);
-      printTable(
-        Object.entries(data.profiles).map(([name, profile]) => ({
-          name,
-          default: data.defaultProfile === name ? "yes" : "",
-          baseUrl: typeof profile.baseUrl === "string" ? profile.baseUrl : "",
-          apiKey: typeof profile.apiKey === "string" ? profile.apiKey : ""
-        })),
-        ["name", "default", "baseUrl", "apiKey"],
-        stdout
-      );
-    } catch (error) {
-      toConfigurationError(filePath, error);
-    }
-  });
-  config.command("validate").description("Validate that the local config can resolve a profile").action(function action() {
-    try {
-      const parsed = readConfig(filePath);
-      const profile = resolveProfile(parsed);
-      const data = {
-        valid: true,
-        profile: profile.name
-      };
-      if (getGlobalOptions(this).json) {
-        emitJson(stdout, "config validate", data, filePath);
-        return;
-      }
-      writeLine(stdout, `Config is valid. Resolved profile "${profile.name}".`);
-    } catch (error) {
-      toConfigurationError(filePath, error);
-    }
-  });
-}
-
-// src/commands/automations.ts
-import { readFileSync as readFileSync2 } from "fs";
-import { InvalidArgumentError } from "commander";
+  deleteConnection(connection) {
+    return this.client.requestJson(
+      `/api/v2/automation-connections/${selectorValue(connection)}`,
+      { method: "DELETE" }
+    );
+  }
+};
 
 // src/parsers/kv.ts
 function splitAssignment(input) {
@@ -6813,6 +6228,53 @@ function normalizeUuidOrSlug(input) {
   };
 }
 
+// src/runtime-context.ts
+function resolveRuntimeContext(config, overrides = {}) {
+  const envProfile = readEnvProfile();
+  const envApiKey = readEnvApiKey();
+  const envBaseUrl = readEnvBaseUrl();
+  const profileOverride = overrides.profile ?? envProfile;
+  const apiKeyOverride = overrides.apiKey ?? envApiKey;
+  const baseUrlOverride = overrides.baseUrl ?? envBaseUrl;
+  if (apiKeyOverride && !baseUrlOverride) {
+    throw new ProfileResolutionError(
+      `Runtime API key was provided, but ${ENV_BASE_URL} or --base-url is missing.`
+    );
+  }
+  if (baseUrlOverride && !apiKeyOverride) {
+    throw new ProfileResolutionError(
+      `Runtime base URL was provided, but ${ENV_API_KEY} or --api-key is missing.`
+    );
+  }
+  if (apiKeyOverride && baseUrlOverride) {
+    return {
+      profile: profileOverride ?? "runtime",
+      baseUrl: baseUrlOverride,
+      apiKey: apiKeyOverride,
+      readOnly: overrides.readOnly ?? false,
+      json: overrides.json ?? false,
+      profileSource: overrides.profile !== void 0 ? "flag" : envProfile !== void 0 ? "env" : void 0,
+      baseUrlSource: overrides.baseUrl !== void 0 ? "flag" : envBaseUrl !== void 0 ? "env" : void 0,
+      apiKeySource: overrides.apiKey !== void 0 ? "flag" : envApiKey !== void 0 ? "env" : void 0
+    };
+  }
+  const profile = resolveProfile(config, {
+    profile: profileOverride,
+    baseUrl: baseUrlOverride,
+    apiKey: apiKeyOverride
+  });
+  return {
+    profile: profile.name,
+    baseUrl: baseUrlOverride ?? profile.baseUrl ?? DEFAULT_PRODUCTION_BASE_URL,
+    apiKey: apiKeyOverride ?? profile.apiKey,
+    readOnly: overrides.readOnly ?? false,
+    json: overrides.json ?? false,
+    profileSource: overrides.profile !== void 0 ? "flag" : envProfile !== void 0 ? "env" : "config",
+    baseUrlSource: overrides.baseUrl !== void 0 ? "flag" : envBaseUrl !== void 0 ? "env" : "config",
+    apiKeySource: overrides.apiKey !== void 0 ? "flag" : envApiKey !== void 0 ? "env" : "config"
+  };
+}
+
 // src/commands/automations.ts
 function getCommandIo2(stdout) {
   return stdout ?? process.stdout;
@@ -7210,38 +6672,38 @@ function readConditions(literalConditions, jsonConditions, label) {
     )
   ];
 }
-function resolveFolder(folders, selector2) {
-  if (selector2.kind === "uuid") {
-    const match = folders.find((folder) => folder.id === selector2.value);
+function resolveFolder(folders, selector) {
+  if (selector.kind === "uuid") {
+    const match = folders.find((folder) => folder.id === selector.value);
     if (match) {
       return match;
     }
   }
-  const matches = folders.filter((folder) => folder.name === selector2.value);
+  const matches = folders.filter((folder) => folder.name === selector.value);
   if (matches.length === 1) {
     return matches[0];
   }
   if (matches.length > 1) {
     throw new CliError(
       "invalid_cli_usage",
-      `Folder "${selector2.value}" is ambiguous. Found ${matches.length} matches.`
+      `Folder "${selector.value}" is ambiguous. Found ${matches.length} matches.`
     );
   }
-  throw new CliError("invalid_cli_usage", `Folder "${selector2.value}" was not found.`);
+  throw new CliError("invalid_cli_usage", `Folder "${selector.value}" was not found.`);
 }
-async function resolveFolderSelector(api, selector2) {
-  if (!selector2) {
+async function resolveFolderSelector(api, selector) {
+  if (!selector) {
     return void 0;
   }
-  if (selector2.kind === "uuid") {
-    return selector2;
+  if (selector.kind === "uuid") {
+    return selector;
   }
   const folders = await api.listFolders();
-  const resolved = resolveFolder(folders, selector2);
+  const resolved = resolveFolder(folders, selector);
   if (typeof resolved.id !== "string" || resolved.id.length === 0) {
     throw new CliError(
       "invalid_cli_usage",
-      `Folder "${selector2.value}" is missing an id in the API response.`
+      `Folder "${selector.value}" is missing an id in the API response.`
     );
   }
   return { kind: "uuid", value: resolved.id };
@@ -8021,7 +7483,7 @@ import { readFileSync as readFileSync3 } from "fs";
 import { InvalidArgumentError as InvalidArgumentError2 } from "commander";
 
 // src/api/comments.ts
-function jsonOptions3(body, method) {
+function jsonOptions2(body, method) {
   return {
     method,
     headers: {
@@ -8030,8 +7492,8 @@ function jsonOptions3(body, method) {
     body: JSON.stringify(body)
   };
 }
-function selectorValue3(selector2) {
-  return selector2.value;
+function selectorValue2(selector) {
+  return selector.value;
 }
 var CommentsApi = class {
   constructor(client) {
@@ -8039,13 +7501,13 @@ var CommentsApi = class {
   }
   listComments(schema, recordId) {
     return this.client.getJson(
-      `/api/v2/schemas/${selectorValue3(schema)}/records/${recordId}/comments`
+      `/api/v2/schemas/${selectorValue2(schema)}/records/${recordId}/comments`
     );
   }
   createComment(schema, recordId, input) {
     return this.client.requestJson(
-      `/api/v2/schemas/${selectorValue3(schema)}/records/${recordId}/comments`,
-      jsonOptions3(input, "POST")
+      `/api/v2/schemas/${selectorValue2(schema)}/records/${recordId}/comments`,
+      jsonOptions2(input, "POST")
     );
   }
 };
@@ -8239,7 +7701,7 @@ import { readFileSync as readFileSync4 } from "fs";
 import { InvalidArgumentError as InvalidArgumentError3 } from "commander";
 
 // src/api/displays.ts
-function jsonOptions4(body, method) {
+function jsonOptions3(body, method) {
   return {
     method,
     headers: {
@@ -8248,8 +7710,8 @@ function jsonOptions4(body, method) {
     body: JSON.stringify(body)
   };
 }
-function selectorValue4(selector2) {
-  return encodeURIComponent(selector2.value);
+function selectorValue3(selector) {
+  return encodeURIComponent(selector.value);
 }
 function segment2(value) {
   return encodeURIComponent(value);
@@ -8262,145 +7724,145 @@ var DisplaysApi = class {
     return this.client.getJson("/api/v2/displays");
   }
   getDisplay(display) {
-    return this.client.getJson(`/api/v2/displays/${selectorValue4(display)}`);
+    return this.client.getJson(`/api/v2/displays/${selectorValue3(display)}`);
   }
   createDisplay(body) {
-    return this.client.requestJson("/api/v2/displays", jsonOptions4(body, "POST"));
+    return this.client.requestJson("/api/v2/displays", jsonOptions3(body, "POST"));
   }
   updateDisplay(display, body) {
     return this.client.requestJson(
-      `/api/v2/displays/${selectorValue4(display)}`,
-      jsonOptions4(body, "PATCH")
+      `/api/v2/displays/${selectorValue3(display)}`,
+      jsonOptions3(body, "PATCH")
     );
   }
   deleteDisplay(display) {
     return this.client.requestJson(
-      `/api/v2/displays/${selectorValue4(display)}`,
+      `/api/v2/displays/${selectorValue3(display)}`,
       { method: "DELETE" }
     );
   }
   getLayout(display) {
     return this.client.getJson(
-      `/api/v2/displays/${selectorValue4(display)}/layout`
+      `/api/v2/displays/${selectorValue3(display)}/layout`
     );
   }
   patchLayout(display, body) {
     return this.client.requestJson(
-      `/api/v2/displays/${selectorValue4(display)}/layout`,
-      jsonOptions4(body, "PATCH")
+      `/api/v2/displays/${selectorValue3(display)}/layout`,
+      jsonOptions3(body, "PATCH")
     );
   }
   listTabs(display) {
     return this.client.getJson(
-      `/api/v2/displays/${selectorValue4(display)}/tabs`
+      `/api/v2/displays/${selectorValue3(display)}/tabs`
     );
   }
   createTab(display, body) {
     return this.client.requestJson(
-      `/api/v2/displays/${selectorValue4(display)}/tabs`,
-      jsonOptions4(body, "POST")
+      `/api/v2/displays/${selectorValue3(display)}/tabs`,
+      jsonOptions3(body, "POST")
     );
   }
   updateTab(display, tabId, body) {
     return this.client.requestJson(
-      `/api/v2/displays/${selectorValue4(display)}/tabs/${segment2(tabId)}`,
-      jsonOptions4(body, "PATCH")
+      `/api/v2/displays/${selectorValue3(display)}/tabs/${segment2(tabId)}`,
+      jsonOptions3(body, "PATCH")
     );
   }
   deleteTab(display, tabId) {
     return this.client.requestJson(
-      `/api/v2/displays/${selectorValue4(display)}/tabs/${segment2(tabId)}`,
+      `/api/v2/displays/${selectorValue3(display)}/tabs/${segment2(tabId)}`,
       { method: "DELETE" }
     );
   }
   listVariables(display) {
     return this.client.getJson(
-      `/api/v2/displays/${selectorValue4(display)}/variables`
+      `/api/v2/displays/${selectorValue3(display)}/variables`
     );
   }
   getVariable(display, variableId) {
     return this.client.getJson(
-      `/api/v2/displays/${selectorValue4(display)}/variables/${segment2(variableId)}`
+      `/api/v2/displays/${selectorValue3(display)}/variables/${segment2(variableId)}`
     );
   }
   createVariable(display, body) {
     return this.client.requestJson(
-      `/api/v2/displays/${selectorValue4(display)}/variables`,
-      jsonOptions4(body, "POST")
+      `/api/v2/displays/${selectorValue3(display)}/variables`,
+      jsonOptions3(body, "POST")
     );
   }
   updateVariable(display, variableId, body) {
     return this.client.requestJson(
-      `/api/v2/displays/${selectorValue4(display)}/variables/${segment2(variableId)}`,
-      jsonOptions4(body, "PATCH")
+      `/api/v2/displays/${selectorValue3(display)}/variables/${segment2(variableId)}`,
+      jsonOptions3(body, "PATCH")
     );
   }
   deleteVariable(display, variableId) {
     return this.client.requestJson(
-      `/api/v2/displays/${selectorValue4(display)}/variables/${segment2(variableId)}`,
+      `/api/v2/displays/${selectorValue3(display)}/variables/${segment2(variableId)}`,
       { method: "DELETE" }
     );
   }
   listWidgets(display) {
     return this.client.getJson(
-      `/api/v2/displays/${selectorValue4(display)}/widgets`
+      `/api/v2/displays/${selectorValue3(display)}/widgets`
     );
   }
   getWidget(display, widgetId) {
     return this.client.getJson(
-      `/api/v2/displays/${selectorValue4(display)}/widgets/${segment2(widgetId)}`
+      `/api/v2/displays/${selectorValue3(display)}/widgets/${segment2(widgetId)}`
     );
   }
   createWidget(display, body) {
     return this.client.requestJson(
-      `/api/v2/displays/${selectorValue4(display)}/widgets`,
-      jsonOptions4(body, "POST")
+      `/api/v2/displays/${selectorValue3(display)}/widgets`,
+      jsonOptions3(body, "POST")
     );
   }
   updateWidget(display, widgetId, body) {
     return this.client.requestJson(
-      `/api/v2/displays/${selectorValue4(display)}/widgets/${segment2(widgetId)}`,
-      jsonOptions4(body, "PATCH")
+      `/api/v2/displays/${selectorValue3(display)}/widgets/${segment2(widgetId)}`,
+      jsonOptions3(body, "PATCH")
     );
   }
   deleteWidget(display, widgetId) {
     return this.client.requestJson(
-      `/api/v2/displays/${selectorValue4(display)}/widgets/${segment2(widgetId)}`,
+      `/api/v2/displays/${selectorValue3(display)}/widgets/${segment2(widgetId)}`,
       { method: "DELETE" }
     );
   }
   createNavigationTarget(display, body) {
     return this.client.requestJson(
-      `/api/v2/displays/${selectorValue4(display)}/navigation-targets`,
-      jsonOptions4(body, "POST")
+      `/api/v2/displays/${selectorValue3(display)}/navigation-targets`,
+      jsonOptions3(body, "POST")
     );
   }
   updateNavigationTarget(display, targetId, body) {
     return this.client.requestJson(
-      `/api/v2/displays/${selectorValue4(display)}/navigation-targets/${segment2(targetId)}`,
-      jsonOptions4(body, "PATCH")
+      `/api/v2/displays/${selectorValue3(display)}/navigation-targets/${segment2(targetId)}`,
+      jsonOptions3(body, "PATCH")
     );
   }
   deleteNavigationTarget(display, targetId) {
     return this.client.requestJson(
-      `/api/v2/displays/${selectorValue4(display)}/navigation-targets/${segment2(targetId)}`,
+      `/api/v2/displays/${selectorValue3(display)}/navigation-targets/${segment2(targetId)}`,
       { method: "DELETE" }
     );
   }
   getCrossWidgetFilter(display) {
     return this.client.getJson(
-      `/api/v2/displays/${selectorValue4(display)}/cross-widget-filter`
+      `/api/v2/displays/${selectorValue3(display)}/cross-widget-filter`
     );
   }
   setCrossWidgetFilter(display, body) {
     return this.client.requestJson(
-      `/api/v2/displays/${selectorValue4(display)}/cross-widget-filter`,
-      jsonOptions4(body, "PUT")
+      `/api/v2/displays/${selectorValue3(display)}/cross-widget-filter`,
+      jsonOptions3(body, "PUT")
     );
   }
   deleteCrossWidgetFilter(display) {
     return this.client.requestJson(
-      `/api/v2/displays/${selectorValue4(display)}/cross-widget-filter`,
+      `/api/v2/displays/${selectorValue3(display)}/cross-widget-filter`,
       { method: "DELETE" }
     );
   }
@@ -8968,8 +8430,8 @@ import { basename } from "path";
 import { InvalidArgumentError as InvalidArgumentError4 } from "commander";
 
 // src/api/files.ts
-function selectorValue5(selector2) {
-  return selector2.value;
+function selectorValue4(selector) {
+  return selector.value;
 }
 var FilesApi = class {
   constructor(client) {
@@ -8982,11 +8444,11 @@ var FilesApi = class {
     });
   }
   downloadFile(file) {
-    return this.client.requestBinary(`/api/v2/files/${selectorValue5(file)}`);
+    return this.client.requestBinary(`/api/v2/files/${selectorValue4(file)}`);
   }
   deleteFile(file) {
     return this.client.requestJson(
-      `/api/v2/files/${selectorValue5(file)}`,
+      `/api/v2/files/${selectorValue4(file)}`,
       { method: "DELETE" }
     );
   }
@@ -9174,8 +8636,8 @@ function registerFilesCommands(program, options = {}) {
 import { InvalidArgumentError as InvalidArgumentError5 } from "commander";
 
 // src/api/logs.ts
-function selectorValue6(selector2) {
-  return selector2.value;
+function selectorValue5(selector) {
+  return selector.value;
 }
 var LogsApi = class {
   constructor(client) {
@@ -9183,7 +8645,7 @@ var LogsApi = class {
   }
   listLogs(schema, recordId) {
     return this.client.getJson(
-      `/api/v2/schemas/${selectorValue6(schema)}/records/${recordId}/logs`
+      `/api/v2/schemas/${selectorValue5(schema)}/records/${recordId}/logs`
     );
   }
 };
@@ -9283,7 +8745,7 @@ import { readFileSync as readFileSync6 } from "fs";
 import { InvalidArgumentError as InvalidArgumentError6 } from "commander";
 
 // src/api/navigation.ts
-function jsonOptions5(body, method) {
+function jsonOptions4(body, method) {
   return {
     method,
     headers: {
@@ -9292,8 +8754,8 @@ function jsonOptions5(body, method) {
     body: JSON.stringify(body)
   };
 }
-function selectorValue7(selector2) {
-  return selector2.value;
+function selectorValue6(selector) {
+  return selector.value;
 }
 var NavigationApi = class {
   constructor(client) {
@@ -9305,25 +8767,25 @@ var NavigationApi = class {
   createFolder(body) {
     return this.client.requestJson(
       "/api/v2/navigation/folders",
-      jsonOptions5(body, "POST")
+      jsonOptions4(body, "POST")
     );
   }
   updateFolder(folder, body) {
     return this.client.requestJson(
-      `/api/v2/navigation/folders/${selectorValue7(folder)}`,
-      jsonOptions5(body, "PATCH")
+      `/api/v2/navigation/folders/${selectorValue6(folder)}`,
+      jsonOptions4(body, "PATCH")
     );
   }
   deleteFolder(folder) {
     return this.client.requestJson(
-      `/api/v2/navigation/folders/${selectorValue7(folder)}`,
+      `/api/v2/navigation/folders/${selectorValue6(folder)}`,
       { method: "DELETE" }
     );
   }
   moveResource(body) {
     return this.client.requestJson(
       "/api/v2/navigation/resources:move",
-      jsonOptions5(body, "POST")
+      jsonOptions4(body, "POST")
     );
   }
 };
@@ -9438,25 +8900,25 @@ function buildFolderBody(options) {
   }
   return body;
 }
-function resolveFolder2(folders, selector2) {
-  if (selector2.kind === "uuid") {
-    const match = folders.find((folder) => folder.id === selector2.value);
+function resolveFolder2(folders, selector) {
+  if (selector.kind === "uuid") {
+    const match = folders.find((folder) => folder.id === selector.value);
     if (!match) {
-      throw new CliError("invalid_cli_usage", `Folder "${selector2.value}" was not found.`);
+      throw new CliError("invalid_cli_usage", `Folder "${selector.value}" was not found.`);
     }
     return match;
   }
-  const matches = folders.filter((folder) => folder.name === selector2.value);
+  const matches = folders.filter((folder) => folder.name === selector.value);
   if (matches.length === 1) {
     return matches[0];
   }
   if (matches.length > 1) {
     throw new CliError(
       "invalid_cli_usage",
-      `Folder "${selector2.value}" is ambiguous. Found ${matches.length} matches.`
+      `Folder "${selector.value}" is ambiguous. Found ${matches.length} matches.`
     );
   }
-  throw new CliError("invalid_cli_usage", `Folder "${selector2.value}" was not found.`);
+  throw new CliError("invalid_cli_usage", `Folder "${selector.value}" was not found.`);
 }
 function folderRows2(folders) {
   return folders.map((folder) => ({
@@ -9713,7 +9175,7 @@ import { readFileSync as readFileSync7 } from "fs";
 import { InvalidArgumentError as InvalidArgumentError7 } from "commander";
 
 // src/api/records.ts
-function jsonOptions6(body, method) {
+function jsonOptions5(body, method) {
   return {
     method,
     headers: {
@@ -9722,8 +9184,8 @@ function jsonOptions6(body, method) {
     body: JSON.stringify(body)
   };
 }
-function selectorValue8(selector2) {
-  return selector2.value;
+function selectorValue7(selector) {
+  return selector.value;
 }
 var RecordsApi = class {
   constructor(client) {
@@ -9737,7 +9199,7 @@ var RecordsApi = class {
     if (query.offset !== void 0) {
       params.set("offset", String(query.offset));
     }
-    const path = `/api/v2/schemas/${selectorValue8(schema)}/records`;
+    const path = `/api/v2/schemas/${selectorValue7(schema)}/records`;
     const queryString = params.toString();
     return this.client.getJson(
       queryString ? `${path}?${queryString}` : path
@@ -9746,30 +9208,36 @@ var RecordsApi = class {
   queryRecords(schema, query) {
     const body = this.normalizeQueryInput(query);
     return this.client.requestJson(
-      `/api/v2/schemas/${selectorValue8(schema)}/records:query`,
-      jsonOptions6(body, "POST")
+      `/api/v2/schemas/${selectorValue7(schema)}/records:query`,
+      jsonOptions5(body, "POST")
     );
   }
   getRecord(schema, record) {
     return this.client.getJson(
-      `/api/v2/schemas/${selectorValue8(schema)}/records/${selectorValue8(record)}`
+      `/api/v2/schemas/${selectorValue7(schema)}/records/${selectorValue7(record)}`
     );
   }
   createRecord(schema, input) {
     return this.client.requestJson(
-      `/api/v2/schemas/${selectorValue8(schema)}/records`,
-      jsonOptions6(input, "POST")
+      `/api/v2/schemas/${selectorValue7(schema)}/records`,
+      jsonOptions5(input, "POST")
     );
   }
   updateRecord(schema, record, input) {
     return this.client.requestJson(
-      `/api/v2/schemas/${selectorValue8(schema)}/records/${selectorValue8(record)}`,
-      jsonOptions6(input, "PATCH")
+      `/api/v2/schemas/${selectorValue7(schema)}/records/${selectorValue7(record)}`,
+      jsonOptions5(input, "PATCH")
     );
   }
   deleteRecord(schema, record) {
     return this.client.requestJson(
-      `/api/v2/schemas/${selectorValue8(schema)}/records/${selectorValue8(record)}`,
+      `/api/v2/schemas/${selectorValue7(schema)}/records/${selectorValue7(record)}`,
+      { method: "DELETE" }
+    );
+  }
+  clearRecords(schema) {
+    return this.client.requestJson(
+      `/api/v2/schemas/${selectorValue7(schema)}/records:clear`,
       { method: "DELETE" }
     );
   }
@@ -9801,6 +9269,73 @@ var RecordsApi = class {
   }
 };
 
+// src/api/schemas.ts
+function jsonOptions6(body, method) {
+  return {
+    method,
+    headers: {
+      "content-type": "application/json"
+    },
+    body: JSON.stringify(body)
+  };
+}
+function selectorValue8(selector) {
+  return selector.value;
+}
+var SchemasApi = class {
+  constructor(client) {
+    this.client = client;
+  }
+  listSchemas() {
+    return this.client.getJson("/api/v2/schemas");
+  }
+  getSchema(schema) {
+    return this.client.getJson(`/api/v2/schemas/${selectorValue8(schema)}`);
+  }
+  createSchema(input) {
+    return this.client.requestJson("/api/v2/schemas", jsonOptions6(input, "POST"));
+  }
+  updateSchema(schema, input) {
+    return this.client.requestJson(
+      `/api/v2/schemas/${selectorValue8(schema)}`,
+      jsonOptions6(input, "PATCH")
+    );
+  }
+  deleteSchema(schema) {
+    return this.client.requestJson(
+      `/api/v2/schemas/${selectorValue8(schema)}`,
+      { method: "DELETE" }
+    );
+  }
+  async listFields(schema) {
+    const result = await this.getSchema(schema);
+    return Array.isArray(result.fields) ? result.fields : [];
+  }
+  getField(schema, field) {
+    return this.client.getJson(
+      `/api/v2/schemas/${selectorValue8(schema)}/fields/${selectorValue8(field)}`
+    );
+  }
+  createField(schema, input) {
+    return this.client.requestJson(
+      `/api/v2/schemas/${selectorValue8(schema)}/fields`,
+      jsonOptions6(input, "POST")
+    );
+  }
+  updateField(schema, field, input) {
+    return this.client.requestJson(
+      `/api/v2/schemas/${selectorValue8(schema)}/fields/${selectorValue8(field)}`,
+      jsonOptions6(input, "PATCH")
+    );
+  }
+  deleteField(schema, field) {
+    return this.client.requestJson(
+      `/api/v2/schemas/${selectorValue8(schema)}/fields/${selectorValue8(field)}`,
+      { method: "DELETE" }
+    );
+  }
+};
+
 // src/parsers/expressions.ts
 var supportedComparators = /* @__PURE__ */ new Set([
   "eq",
@@ -10186,14 +9721,14 @@ function getQueryRecords(result) {
 function getRecordIdentifier(record) {
   return typeof record.recordId === "string" ? record.recordId : "unknown";
 }
-async function resolveSchemaSelector(api, selector2) {
-  if (selector2.kind === "uuid") {
-    return selector2;
+async function resolveSchemaSelector(api, selector) {
+  if (selector.kind === "uuid") {
+    return selector;
   }
   const schemas = await api.listSchemas();
-  const match = schemas.find((entry) => entry.slug === selector2.value);
+  const match = schemas.find((entry) => entry.slug === selector.value);
   if (!match || typeof match.id !== "string") {
-    throw new CliError("invalid_cli_usage", `Schema "${selector2.value}" not found.`);
+    throw new CliError("invalid_cli_usage", `Schema "${selector.value}" not found.`);
   }
   return {
     kind: "uuid",
@@ -10299,6 +9834,17 @@ function registerRecordsCommands(program, options = {}) {
     }
     writeLine9(stdout, `Deleted record "${record.value}" from schema "${schema.value}".`);
   });
+  records.command("clear").description("Delete all records from a schema's table").argument("<schema>", "schema uuid or slug", parseUuidOrSlugSelector7).action(async function action(schema) {
+    const { api, schemasApi, json, readOnly } = createRecordsApi(this, filePath);
+    ensureWritable6("records clear", readOnly, "destructive");
+    const resolvedSchema = await resolveSchemaSelector(schemasApi, schema);
+    const data = await api.clearRecords(resolvedSchema);
+    if (json) {
+      emitJson9(stdout, "records clear", data, filePath);
+      return;
+    }
+    writeLine9(stdout, `Cleared all records from schema "${schema.value}".`);
+  });
 }
 
 // src/commands/schemas.ts
@@ -10566,28 +10112,28 @@ function buildFieldUpdateInput(currentType, options) {
   applyFieldDefaultValue(input, options.default);
   return input;
 }
-async function resolveSchemaSelector2(api, selector2) {
-  if (selector2.kind === "uuid") {
-    return selector2;
+async function resolveSchemaSelector2(api, selector) {
+  if (selector.kind === "uuid") {
+    return selector;
   }
   const schemas = await api.listSchemas();
-  const match = schemas.find((schema) => schema.slug === selector2.value);
+  const match = schemas.find((schema) => schema.slug === selector.value);
   if (!match || typeof match.id !== "string") {
-    throw new CliError("invalid_cli_usage", `Schema "${selector2.value}" not found.`);
+    throw new CliError("invalid_cli_usage", `Schema "${selector.value}" not found.`);
   }
   return {
     kind: "uuid",
     value: match.id
   };
 }
-async function resolveFieldSelector(api, schema, selector2) {
-  if (selector2.kind === "uuid") {
-    return selector2;
+async function resolveFieldSelector(api, schema, selector) {
+  if (selector.kind === "uuid") {
+    return selector;
   }
   const fields = await api.listFields(schema);
-  const match = fields.find((field) => field.slug === selector2.value);
+  const match = fields.find((field) => field.slug === selector.value);
   if (!match || typeof match.id !== "string") {
-    throw new CliError("invalid_cli_usage", `Field "${selector2.value}" not found.`);
+    throw new CliError("invalid_cli_usage", `Field "${selector.value}" not found.`);
   }
   return {
     kind: "uuid",
@@ -10765,8 +10311,8 @@ function jsonOptions7(body, method) {
     body: JSON.stringify(body)
   };
 }
-function selectorValue9(selector2) {
-  return selector2.value;
+function selectorValue9(selector) {
+  return selector.value;
 }
 var TeamspaceApi = class {
   constructor(client) {
@@ -10995,11 +10541,11 @@ function emitTable5(stdout, data) {
 function getFolderIdentifier(folder) {
   return typeof folder.id === "string" ? folder.id : typeof folder.name === "string" ? folder.name : "unknown";
 }
-function buildFolderLookup(folders, selector2) {
-  if (selector2.kind === "uuid") {
-    return selector2;
+function buildFolderLookup(folders, selector) {
+  if (selector.kind === "uuid") {
+    return selector;
   }
-  const matches = folders.filter((folder) => folder.name === selector2.value);
+  const matches = folders.filter((folder) => folder.name === selector.value);
   if (matches.length === 1) {
     const folderId = matches[0]?.id;
     if (typeof folderId === "string" && folderId.length > 0) {
@@ -11012,37 +10558,37 @@ function buildFolderLookup(folders, selector2) {
   if (matches.length > 1) {
     throw new CliError(
       "invalid_cli_usage",
-      `Folder "${selector2.value}" is ambiguous. Found ${matches.length} matches.`
+      `Folder "${selector.value}" is ambiguous. Found ${matches.length} matches.`
     );
   }
-  throw new CliError("invalid_cli_usage", `Folder "${selector2.value}" was not found.`);
+  throw new CliError("invalid_cli_usage", `Folder "${selector.value}" was not found.`);
 }
-function findFolderEntity(folders, selector2) {
-  if (selector2.kind === "uuid") {
-    const match = folders.find((folder) => folder.id === selector2.value);
+function findFolderEntity(folders, selector) {
+  if (selector.kind === "uuid") {
+    const match = folders.find((folder) => folder.id === selector.value);
     if (match) {
       return match;
     }
-    throw new CliError("invalid_cli_usage", `Folder "${selector2.value}" was not found.`);
+    throw new CliError("invalid_cli_usage", `Folder "${selector.value}" was not found.`);
   }
-  const matches = folders.filter((folder) => folder.name === selector2.value);
+  const matches = folders.filter((folder) => folder.name === selector.value);
   if (matches.length === 1) {
     return matches[0];
   }
   if (matches.length > 1) {
     throw new CliError(
       "invalid_cli_usage",
-      `Folder "${selector2.value}" is ambiguous. Found ${matches.length} matches.`
+      `Folder "${selector.value}" is ambiguous. Found ${matches.length} matches.`
     );
   }
-  throw new CliError("invalid_cli_usage", `Folder "${selector2.value}" was not found.`);
+  throw new CliError("invalid_cli_usage", `Folder "${selector.value}" was not found.`);
 }
-async function resolveFolderSelector2(api, selector2) {
-  if (selector2.kind === "uuid") {
-    return selector2;
+async function resolveFolderSelector2(api, selector) {
+  if (selector.kind === "uuid") {
+    return selector;
   }
   const folders = await api.listFolders(false);
-  return buildFolderLookup(folders, selector2);
+  return buildFolderLookup(folders, selector);
 }
 function registerTeamspaceCommands(program, options = {}) {
   const filePath = options.configPath ?? defaultConfigPath;
@@ -11717,15 +11263,11 @@ async function runCli(argv) {
     const optionMeta = buildOptionMetadata(program);
     const exampleRequest = extractExampleRequest(argv, optionMeta);
     if (exampleRequest) {
-      await showExamples(
+      showExamples(
         exampleRequest.commandName,
         exampleRequest.json,
         void 0,
-        exampleRequest.filters,
-        {
-          enabled: true,
-          overrides: exampleRequest.overrides
-        }
+        exampleRequest.filters
       );
       throw new ExampleDisplayed();
     }