@claypi/cli 0.1.0 → 0.1.1

package/dist/index.js

@@ -61387,6 +61387,31 @@ function clearDefaultProfile() {
   writeConfig({ ...existing, profiles: rest });
 }
 
+// src/auth/credentials-file.ts
+var import_node_fs4 = require("fs");
+var CREDENTIALS_FILE_PATH = "/mnt/session/uploads/.clay-credentials";
+function parseDotenv(content) {
+  const out = {};
+  for (const line of content.split("\n")) {
+    const trimmed = line.trim();
+    if (trimmed === "" || trimmed.startsWith("#")) continue;
+    const eq = trimmed.indexOf("=");
+    if (eq <= 0) continue;
+    out[trimmed.slice(0, eq).trim()] = trimmed.slice(eq + 1).trim();
+  }
+  return out;
+}
+function credentialFromFile(key) {
+  let content;
+  try {
+    content = (0, import_node_fs4.readFileSync)(CREDENTIALS_FILE_PATH, "utf-8");
+  } catch {
+    return void 0;
+  }
+  const value = parseDotenv(content)[key]?.trim();
+  return value === void 0 || value === "" ? void 0 : value;
+}
+
 // src/auth/api-key-provider.ts
 var ApiKeyProvider = class {
   getApiKey() {
@@ -61398,6 +61423,10 @@ var ApiKeyProvider = class {
     if (fromEnv !== void 0 && fromEnv !== "") {
       return Promise.resolve(fromEnv);
     }
+    const fromFile = credentialFromFile("CLAY_API_KEY");
+    if (fromFile !== void 0) {
+      return Promise.resolve(fromFile);
+    }
     return Promise.reject(new MissingApiKeyError());
   }
 };
@@ -61418,11 +61447,18 @@ function normalizeBaseUrl(raw) {
   }
   return trimmed.replace(/\/+$/, "");
 }
+function resolveBaseUrl() {
+  const fromEnv = process.env.CLAY_API_URL?.trim();
+  if (fromEnv !== void 0 && fromEnv !== "") {
+    return normalizeBaseUrl(fromEnv);
+  }
+  return normalizeBaseUrl(credentialFromFile("CLAY_API_URL"));
+}
 
 // src/version.ts
-var import_node_fs4 = require("fs");
+var import_node_fs5 = require("fs");
 var import_node_path3 = require("path");
-var pkg = JSON.parse((0, import_node_fs4.readFileSync)((0, import_node_path3.join)(__dirname, "..", "package.json"), "utf8"));
+var pkg = JSON.parse((0, import_node_fs5.readFileSync)((0, import_node_path3.join)(__dirname, "..", "package.json"), "utf8"));
 var CLI_VERSION = pkg.version;
 
 // src/clients/cli-attribution-headers.ts
@@ -61483,7 +61519,7 @@ var PUBLIC_API_V0_PREFIX = "/public/v0";
 var cache = /* @__PURE__ */ new Map();
 function createPublicApiClient(contract, apiKey) {
   return initClient(contract, {
-    baseUrl: `${normalizeBaseUrl(process.env.CLAY_API_URL)}${PUBLIC_API_V0_PREFIX}`,
+    baseUrl: `${resolveBaseUrl()}${PUBLIC_API_V0_PREFIX}`,
     baseHeaders: {
       [CLAY_API_KEY_HEADER]: apiKey,
       ...cliAttributionHeaders()
@@ -61518,7 +61554,7 @@ async function v3Client(contract, options = {}) {
   }
   const apiKey = await tokenProvider.getApiKey();
   const client = initClient(contract, {
-    baseUrl: `${normalizeBaseUrl(process.env.CLAY_API_URL)}/v3`,
+    baseUrl: `${resolveBaseUrl()}/v3`,
     baseHeaders: {
       [CLAY_API_KEY_HEADER]: apiKey,
       ...cliAttributionHeaders()
@@ -75861,12 +75897,12 @@ function captureWorkerThreadEvents(worker, options) {
 
 // ../../node_modules/@sentry/node/node_modules/@sentry/node-core/build/esm/integrations/context.js
 var import_node_child_process = require("child_process");
-var import_node_fs5 = require("fs");
+var import_node_fs6 = require("fs");
 var os = __toESM(require("os"), 1);
 var import_node_path4 = require("path");
 var import_node_util = require("util");
-var readFileAsync = (0, import_node_util.promisify)(import_node_fs5.readFile);
-var readDirAsync = (0, import_node_util.promisify)(import_node_fs5.readdir);
+var readFileAsync = (0, import_node_util.promisify)(import_node_fs6.readFile);
+var readDirAsync = (0, import_node_util.promisify)(import_node_fs6.readdir);
 var INTEGRATION_NAME12 = "Context";
 var _nodeContextIntegration = ((options = {}) => {
   let cachedContext;
@@ -76149,7 +76185,7 @@ function getCloudResourceContext() {
 }
 
 // ../../node_modules/@sentry/node/node_modules/@sentry/node-core/build/esm/integrations/contextlines.js
-var import_node_fs6 = require("fs");
+var import_node_fs7 = require("fs");
 var import_node_readline = require("readline");
 var LRU_FILE_CONTENTS_CACHE = new LRUMap(10);
 var LRU_FILE_CONTENTS_FS_READ_FAILED = new LRUMap(20);
@@ -76220,7 +76256,7 @@ function makeLineReaderRanges(lines, linecontext) {
 }
 function getContextLinesFromFile(path7, ranges, output) {
   return new Promise((resolve2, _reject) => {
-    const stream = (0, import_node_fs6.createReadStream)(path7);
+    const stream = (0, import_node_fs7.createReadStream)(path7);
     const lineReaded = (0, import_node_readline.createInterface)({
       input: stream
     });
@@ -76824,7 +76860,7 @@ var localVariablesIntegration = (options = {}) => {
 };
 
 // ../../node_modules/@sentry/node/node_modules/@sentry/node-core/build/esm/integrations/modules.js
-var import_node_fs7 = require("fs");
+var import_node_fs8 = require("fs");
 var import_node_path5 = require("path");
 
 // ../../node_modules/@sentry/node/node_modules/@sentry/node-core/build/esm/utils/detection.js
@@ -76904,11 +76940,11 @@ function collectRequireModules() {
       }
       const pkgfile = (0, import_node_path5.join)(orig, "package.json");
       seen.add(orig);
-      if (!(0, import_node_fs7.existsSync)(pkgfile)) {
+      if (!(0, import_node_fs8.existsSync)(pkgfile)) {
         return updir();
       }
       try {
-        const info = JSON.parse((0, import_node_fs7.readFileSync)(pkgfile, "utf8"));
+        const info = JSON.parse((0, import_node_fs8.readFileSync)(pkgfile, "utf8"));
         infos[info.name] = info.version;
       } catch {
       }
@@ -76926,7 +76962,7 @@ function _getModules() {
 function getPackageJson() {
   try {
     const filePath = (0, import_node_path5.join)(process.cwd(), "package.json");
-    const packageJson = JSON.parse((0, import_node_fs7.readFileSync)(filePath, "utf8"));
+    const packageJson = JSON.parse((0, import_node_fs8.readFileSync)(filePath, "utf8"));
     return packageJson;
   } catch {
     return {};
@@ -82756,6 +82792,25 @@ function applyClaySettings(cmd) {
   return cmd;
 }
 
+// ../../libs/api-contract/src/public-api-v0/pagination.ts
+var DEFAULT_PAGE_LIMIT = 20;
+var MAX_PAGE_LIMIT = 100;
+function paginatedQuerySchema({
+  defaultLimit = DEFAULT_PAGE_LIMIT,
+  maxLimit = MAX_PAGE_LIMIT
+} = {}) {
+  return external_exports.object({
+    cursor: external_exports.string().optional(),
+    limit: external_exports.coerce.number().int().min(1).max(maxLimit).default(defaultLimit)
+  });
+}
+function paginatedResponse(itemSchema) {
+  return external_exports.object({
+    data: external_exports.array(itemSchema),
+    cursor: external_exports.string().optional()
+  });
+}
+
 // ../../libs/api-contract/src/common/interfaces.ts
 var SerializedTimestamp = external_exports.object({
   createdAt: external_exports.string(),
@@ -82862,58 +82917,60 @@ var tablesSummaryContract = {
   }
 };
 
-// src/commands/pagination.ts
-var MAX_AUTO_PAGINATE_ITEMS = 1e4;
-var MAX_AUTO_PAGINATE_PAGES = 500;
-var CursorPager = class {
-  currentCursor;
-  itemsFetched = 0;
-  pagesFetched = 1;
-  get cursor() {
-    return this.currentCursor;
-  }
-  advance(nextCursor, pageItemCount) {
-    if (nextCursor === this.currentCursor) {
-      throw new IncompatibleApiServerError(
-        "Clay API returned the same pagination cursor twice in a row; aborting auto-pagination."
-      );
-    }
-    this.itemsFetched += pageItemCount;
-    this.pagesFetched += 1;
-    if (this.itemsFetched >= MAX_AUTO_PAGINATE_ITEMS) {
-      throw new IncompatibleApiServerError(
-        `Auto-pagination stopped after ${MAX_AUTO_PAGINATE_ITEMS} items without reaching the end of the result set; narrow the request to fetch fewer rows.`
-      );
+// src/commands/flag-parsers.ts
+var import_node_fs9 = require("fs");
+function parsePositiveIntegerFlag(flagName, max) {
+  return (value) => {
+    const n = Number.parseInt(value, 10);
+    if (!Number.isInteger(n) || n < 1 || String(n) !== value.trim()) {
+      throw new InvalidArgumentError(`${flagName} must be a positive integer`);
     }
-    if (this.pagesFetched >= MAX_AUTO_PAGINATE_PAGES) {
-      throw new IncompatibleApiServerError(
-        `Clay API returned ${MAX_AUTO_PAGINATE_PAGES} pages without reaching the end of the result set; aborting auto-pagination.`
-      );
+    if (max && n > max) {
+      throw new InvalidArgumentError(`${flagName} must be less than or equal to ${max}`);
     }
-    this.currentCursor = nextCursor;
+    return n;
+  };
+}
+var parseLimitFlag = parsePositiveIntegerFlag("--limit");
+function parseLimitFlagWithMax(max) {
+  return parsePositiveIntegerFlag("--limit", max);
+}
+function parseBooleanFlag(flagName) {
+  return (value) => {
+    if (value === "true") return true;
+    if (value === "false") return false;
+    throw new InvalidArgumentError(`${flagName} must be true or false`);
+  };
+}
+function readJsonFlag(flagName, source) {
+  const display = source === "-" ? "stdin" : source;
+  let raw;
+  try {
+    raw = source === "-" ? (0, import_node_fs9.readFileSync)(0, "utf8") : (0, import_node_fs9.readFileSync)(source, "utf8");
+  } catch (err) {
+    throw new InvalidArgumentError(`${flagName}: could not read ${display} (${err.message})`);
   }
-};
-
-// src/commands/tables/list.ts
-var DEFAULT_LIMIT2 = 100;
-var SERVER_PAGE_MAX = 100;
-function parseLimit(raw) {
-  const n = Number.parseInt(raw, 10);
-  if (!Number.isInteger(n) || n < 1 || String(n) !== raw.trim()) {
-    throw new InvalidArgumentError("must be a positive integer");
+  const trimmed = raw.trim();
+  if (trimmed === "") {
+    throw new InvalidArgumentError(`${flagName}: ${display} is empty`);
+  }
+  try {
+    return JSON.parse(trimmed);
+  } catch (err) {
+    throw new InvalidArgumentError(`${flagName}: not valid JSON (${err.message})`);
   }
-  return n;
 }
+
+// src/commands/tables/list.ts
 function buildListCommand() {
   const cmd = new Command("list");
   cmd.description(
     "List tables in the workspace pinned to your API key. Each row carries an `apiEnabled` flag for whether the table is enabled for public-API sync."
   ).option(
     "--limit <n>",
-    `Maximum number of tables to return (default ${DEFAULT_LIMIT2}). Workspaces with more tables are silently truncated \u2014 raise --limit to see more.`,
-    parseLimit,
-    DEFAULT_LIMIT2
-  ).option("--api-enabled", "Only return tables enabled for the public API.").addHelpText(
+    `Max tables to return per page. Defaults to ${DEFAULT_PAGE_LIMIT}.`,
+    parseLimitFlagWithMax(MAX_PAGE_LIMIT)
+  ).option("--cursor <token>", "Resume from a previous response's `cursor` to fetch the next page.").option("--api-enabled", "Only return tables enabled for the public API.").addHelpText(
     "after",
     `
 Output (success, exit 0):
@@ -82926,49 +82983,48 @@ Output (success, exit 0):
         "workbook": { "id": <string>, "name": <string> } | null,
         "apiEnabled": <boolean>
       }
-    ]
+    ],
+    "cursor": <string|undefined>
   }
 
+Pagination:
+  --limit <n>       max tables per call. Defaults to ${DEFAULT_PAGE_LIMIT}.
+  --cursor <token>  resume from a previous response's \`cursor\`
+  When more results exist, the response includes a top-level \`cursor\`; pass it back via
+  --cursor to fetch the next page.
+
 Common errors:
-  validation_error (exit 2)  --limit is not a positive integer.
+  validation_error (exit 2)  --limit is not a positive integer or exceeds ${MAX_PAGE_LIMIT}.
   auth_forbidden   (exit 3)  Key lacks the cli:all scope, or the workspace is not in the public-API beta.
 
 Examples:
   $ clay tables list
   $ clay tables list --api-enabled | jq -r '.data[].id'
-  $ clay tables list --limit 500 | jq -r '.data[] | select(.apiEnabled) | .name'
+  $ clay tables list --limit 50 --cursor "$CURSOR"
+  $ clay tables list --api-enabled | jq -r '.data[] | select(.apiEnabled) | .name'
 `
   ).action(async (opts) => {
     const workspaceId = await currentWorkspaceId();
     const client = await v3Client(tablesSummaryContract);
-    const accumulated = [];
-    const pager = new CursorPager();
-    while (accumulated.length < opts.limit) {
-      const remaining = opts.limit - accumulated.length;
-      const pageSize = Math.min(remaining, SERVER_PAGE_MAX);
-      const page = await unwrap(
-        client.listTablesSummary({
-          params: { workspaceId },
-          query: {
-            limit: pageSize,
-            ...pager.cursor === void 0 ? {} : { cursor: pager.cursor },
-            ...opts.apiEnabled === true ? { apiEnabled: "true" } : {}
-          }
-        })
-      );
-      accumulated.push(...page.data);
-      if (page.cursor === void 0) break;
-      if (accumulated.length >= opts.limit) break;
-      pager.advance(page.cursor, page.data.length);
-    }
+    const page = await unwrap(
+      client.listTablesSummary({
+        params: { workspaceId },
+        query: {
+          cursor: opts.cursor,
+          limit: opts.limit ?? DEFAULT_PAGE_LIMIT,
+          apiEnabled: opts.apiEnabled === true ? "true" : void 0
+        }
+      })
+    );
     writeJson({
-      data: accumulated.slice(0, opts.limit).map((t) => ({
+      data: page.data.map((t) => ({
         id: t.id,
         name: t.name,
         description: t.description,
         workbook: t.workbook,
         apiEnabled: t.apiEnabled
-      }))
+      })),
+      cursor: page.cursor
     });
   });
   return cmd;
@@ -83105,25 +83161,6 @@ var StructuredQueryRequest = external_exports.preprocess((raw, ctx) => {
   return raw;
 }, StructuredQueryRequestShape);
 
-// ../../libs/api-contract/src/public-api-v0/pagination.ts
-var DEFAULT_PAGE_LIMIT = 20;
-var MAX_PAGE_LIMIT = 100;
-function paginatedQuerySchema({
-  defaultLimit = DEFAULT_PAGE_LIMIT,
-  maxLimit = MAX_PAGE_LIMIT
-} = {}) {
-  return external_exports.object({
-    cursor: external_exports.string().optional(),
-    limit: external_exports.coerce.number().int().min(1).max(maxLimit).default(defaultLimit)
-  });
-}
-function paginatedResponse(itemSchema) {
-  return external_exports.object({
-    data: external_exports.array(itemSchema),
-    cursor: external_exports.string().optional()
-  });
-}
-
 // ../../libs/api-contract/src/public-api-v0/tables-contract.ts
 var c = initContract();
 var CellSuccessSchema = external_exports.object({
@@ -83175,44 +83212,6 @@ var publicApiTablesContract = c.router({
   }
 });
 
-// src/commands/flag-parsers.ts
-var import_node_fs8 = require("fs");
-function parsePositiveIntegerFlag(flagName) {
-  return (value) => {
-    const n = Number.parseInt(value, 10);
-    if (!Number.isInteger(n) || n < 1 || String(n) !== value.trim()) {
-      throw new InvalidArgumentError(`${flagName} must be a positive integer`);
-    }
-    return n;
-  };
-}
-var parseLimitFlag = parsePositiveIntegerFlag("--limit");
-function parseBooleanFlag(flagName) {
-  return (value) => {
-    if (value === "true") return true;
-    if (value === "false") return false;
-    throw new InvalidArgumentError(`${flagName} must be true or false`);
-  };
-}
-function readJsonFlag(flagName, source) {
-  const display = source === "-" ? "stdin" : source;
-  let raw;
-  try {
-    raw = source === "-" ? (0, import_node_fs8.readFileSync)(0, "utf8") : (0, import_node_fs8.readFileSync)(source, "utf8");
-  } catch (err) {
-    throw new InvalidArgumentError(`${flagName}: could not read ${display} (${err.message})`);
-  }
-  const trimmed = raw.trim();
-  if (trimmed === "") {
-    throw new InvalidArgumentError(`${flagName}: ${display} is empty`);
-  }
-  try {
-    return JSON.parse(trimmed);
-  } catch (err) {
-    throw new InvalidArgumentError(`${flagName}: not valid JSON (${err.message})`);
-  }
-}
-
 // src/commands/tables/projection.ts
 function projectCell(cell) {
   if (cell.status === "success") {
@@ -83254,7 +83253,7 @@ function projectQueryResponse(response) {
 }
 
 // src/commands/tables/query.ts
-function parseLimit2(raw) {
+function parseLimit(raw) {
   const n = Number.parseInt(raw, 10);
   if (!Number.isInteger(n) || String(n) !== raw.trim()) {
     throw new InvalidArgumentError("must be an integer");
@@ -83283,7 +83282,7 @@ function buildQueryCommand() {
   ).requiredOption(
     "--query <file|->",
     "Path to a JSON file containing the structured query. Use - to read from stdin."
-  ).option("--limit <n>", "Max rows to return (1-100, default 50).", parseLimit2).option("--cursor <token>", "Resume from a previous response's `cursor` to fetch the next page.").addHelpText(
+  ).option("--limit <n>", "Max rows to return (1-100, default 50).", parseLimit).option("--cursor <token>", "Resume from a previous response's `cursor` to fetch the next page.").addHelpText(
     "after",
     `
 Output (success, exit 0):
@@ -84036,6 +84035,8 @@ var MutateSmartleadMasterInboxForwardEmailRequest = external_exports.object({
     message_id: external_exports.string(),
     stats_id: external_exports.string(),
     to_emails: external_exports.string(),
+    cc_emails: external_exports.string().optional(),
+    bcc_emails: external_exports.string().optional(),
     forward_email_subject: external_exports.string().optional(),
     forward_email_body: external_exports.string().optional()
   })
@@ -84424,7 +84425,9 @@ var ImageDataTypeSettings = external_exports.object({
   lowercaseUrl: external_exports.boolean().optional()
 });
 var DateDataTypeSettings = external_exports.object({
-  type: external_exports.literal("date" /* DATE */)
+  type: external_exports.literal("date" /* DATE */),
+  // 'date' stores a timezone-less calendar day (YYYY-MM-DD); 'datetime' (default) stores a UTC instant.
+  precision: external_exports.enum(["date", "datetime"]).optional()
 });
 var SelectDataTypeSettings = external_exports.object({
   type: external_exports.literal("select" /* SELECT */),
@@ -85007,6 +85010,8 @@ var ActionFieldSettings = external_exports.object({
   customRateLimitRules: RateLimitRulesV1.nullish(),
   batchRunSettings: BatchRunSettings.optional(),
   delaySettings: DelaySettings.nullish(),
+  // `JAVASCRIPT_V1` is deprecated: its raw-JS evaluation path has been removed and no live cells use
+  // it. The value is kept in the enum so stored field settings carrying it remain parseable
   formulaEvaluationType: external_exports.enum(["JAVASCRIPT_V1", "LEGACY_CLAYSCRIPT"]).optional(),
   inputsBinding: external_exports.array(InputsBinding).optional(),
   optionalPathsInInputs: external_exports.record(external_exports.string(), external_exports.array(external_exports.union([external_exports.string(), external_exports.number()])).array()).optional(),
@@ -86371,64 +86376,95 @@ function buildListCommand2() {
     ])
   ).option(
     "--limit <n>",
-    "Cap the number of tools returned. By default the command auto-paginates and returns all tools.",
-    parseLimitFlag
-  ).addHelpText(
+    `Max tools to return per page. Defaults to ${DEFAULT_PAGE_LIMIT}.`,
+    parseLimitFlagWithMax(MAX_PAGE_LIMIT)
+  ).option("--cursor <token>", "Resume from a previous response's `cursor` to fetch the next page.").addHelpText(
     "after",
     `
 Output (success, exit 0):
   {
     "data": [
       { "id": "function:tbl_abc", "name": <string>, "description": <string|null> }
-    ]
+    ],
+    "cursor": <string|undefined>
   }
 
 ${TOOL_INTEGRATION_VALUES_HELP}
 
+Pagination:
+  --limit <n>       max tools per call. Defaults to ${DEFAULT_PAGE_LIMIT}.
+  --cursor <token>  resume from a previous response's \`cursor\`
+  When more results exist, the response includes a top-level \`cursor\`; pass it back via
+  --cursor to fetch the next page.
+
 Common errors:
-  auth_forbidden (exit 3)  Key lacks the cli:all scope (or 'all').
+  validation_error (exit 2)  --limit is not a positive integer or exceeds ${MAX_PAGE_LIMIT}.
+  auth_forbidden   (exit 3)  Key lacks the cli:all scope (or 'all').
 
 Examples:
   $ clay tools list
   $ clay tools list --integration api
   $ clay tools list --integration mcp
   $ clay tools list --limit 10 | jq -r '.data[].id'
+  $ clay tools list --limit 10 --cursor "$CURSOR"
 `
   ).action(async (opts) => {
     const workspaceId = await currentWorkspaceId();
     const client = await v3Client(toolsContract);
-    const accumulated = [];
-    const pager = new CursorPager();
-    for (; ; ) {
-      const remaining = opts.limit === void 0 ? MAX_PAGE_LIMIT : opts.limit - accumulated.length;
-      const pageSize = Math.min(MAX_PAGE_LIMIT, remaining);
-      const result = await unwrap(
-        client.listTools({
-          params: { workspaceId },
-          query: {
-            ...opts.integration ? { integration: opts.integration } : {},
-            ...pager.cursor !== void 0 ? { cursor: pager.cursor } : {},
-            limit: pageSize
-          }
-        })
-      );
-      accumulated.push(...result.data);
-      if (result.cursor === void 0) break;
-      if (opts.limit !== void 0 && accumulated.length >= opts.limit) break;
-      pager.advance(result.cursor, result.data.length);
-    }
-    const trimmed = opts.limit === void 0 ? accumulated : accumulated.slice(0, opts.limit);
+    const result = await unwrap(
+      client.listTools({
+        params: { workspaceId },
+        query: {
+          integration: opts.integration,
+          cursor: opts.cursor,
+          limit: opts.limit ?? DEFAULT_PAGE_LIMIT
+        }
+      })
+    );
     writeJson({
-      data: trimmed.map((tool) => ({
+      data: result.data.map((tool) => ({
         id: tool.id,
         name: tool.name,
         description: tool.description
-      }))
+      })),
+      cursor: result.cursor
     });
   });
   return cmd;
 }
 
+// src/commands/pagination.ts
+var MAX_AUTO_PAGINATE_ITEMS = 1e4;
+var MAX_AUTO_PAGINATE_PAGES = 500;
+var CursorPager = class {
+  currentCursor;
+  itemsFetched = 0;
+  pagesFetched = 1;
+  get cursor() {
+    return this.currentCursor;
+  }
+  advance(nextCursor, pageItemCount) {
+    if (nextCursor === this.currentCursor) {
+      throw new IncompatibleApiServerError(
+        "Clay API returned the same pagination cursor twice in a row; aborting auto-pagination."
+      );
+    }
+    this.itemsFetched += pageItemCount;
+    this.pagesFetched += 1;
+    if (this.itemsFetched >= MAX_AUTO_PAGINATE_ITEMS) {
+      throw new IncompatibleApiServerError(
+        `Auto-pagination stopped after ${MAX_AUTO_PAGINATE_ITEMS} items without reaching the end of the result set; narrow the request to fetch fewer rows.`
+      );
+    }
+    if (this.pagesFetched >= MAX_AUTO_PAGINATE_PAGES) {
+      throw new IncompatibleApiServerError(
+        `Clay API returned ${MAX_AUTO_PAGINATE_PAGES} pages without reaching the end of the result set; aborting auto-pagination.`
+      );
+    }
+    this.currentCursor = nextCursor;
+  }
+};
+
 // src/commands/tools/runs/projection.ts
 function projectInlineStart(response) {
   return {
@@ -86608,9 +86644,9 @@ function buildListCommand3() {
   const cmd = new Command("list");
   cmd.description("List recent async tool runs and their statuses.").option(
     "--limit <n>",
-    "Cap the number of runs returned. By default the command auto-paginates and returns all recent runs.",
-    parseLimitFlag
-  ).addHelpText(
+    `Max runs to return per page. Defaults to ${DEFAULT_PAGE_LIMIT}.`,
+    parseLimitFlagWithMax(MAX_PAGE_LIMIT)
+  ).option("--cursor <token>", "Resume from a previous response's `cursor` to fetch the next page.").addHelpText(
     "after",
     `
 Output (success, exit 0):
@@ -86623,49 +86659,48 @@ Output (success, exit 0):
         "total": <number>,
         "finished": <number>
       }
-    ]
+    ],
+    "cursor": <string|undefined>
   }
 
+Pagination:
+  --limit <n>       max runs per call. Defaults to ${DEFAULT_PAGE_LIMIT}.
+  --cursor <token>  resume from a previous response's \`cursor\`
+  When more results exist, the response includes a top-level \`cursor\`; pass it back via
+  --cursor to fetch the next page.
+
 Common errors:
-  auth_forbidden (exit 3)  Key lacks the cli:all scope (or 'all').
+  validation_error (exit 2)  --limit is not a positive integer or exceeds ${MAX_PAGE_LIMIT}.
+  auth_forbidden   (exit 3)  Key lacks the cli:all scope (or 'all').
 
 Examples:
   $ clay tools runs list
   $ clay tools runs list --limit 10 | jq -r '.data[].toolRunId'
+  $ clay tools runs list --limit 10 --cursor "$CURSOR"
   $ clay tools runs list | jq '.data[] | select(.status == "in_progress")'
 `
   ).action(async (opts) => {
     const workspaceId = await currentWorkspaceId();
     const client = await v3Client(toolsContract);
-    const accumulated = [];
-    const pager = new CursorPager();
-    for (; ; ) {
-      const remaining = opts.limit === void 0 ? MAX_PAGE_LIMIT : opts.limit - accumulated.length;
-      const pageSize = Math.min(MAX_PAGE_LIMIT, remaining);
-      const result = await unwrap(
-        client.listToolRuns({
-          params: { workspaceId },
-          query: {
-            ...pager.cursor !== void 0 ? { cursor: pager.cursor } : {},
-            limit: pageSize
-          }
-        })
-      );
-      accumulated.push(...result.data);
-      if (result.cursor === void 0) break;
-      if (opts.limit !== void 0 && accumulated.length >= opts.limit) break;
-      pager.advance(result.cursor, result.data.length);
-    }
-    const trimmed = opts.limit === void 0 ? accumulated : accumulated.slice(0, opts.limit);
+    const result = await unwrap(
+      client.listToolRuns({
+        params: { workspaceId },
+        query: {
+          cursor: opts.cursor,
+          limit: opts.limit ?? DEFAULT_PAGE_LIMIT
+        }
+      })
+    );
     writeJson({
-      data: trimmed.map(projectRunListItem)
+      data: result.data.map(projectRunListItem),
+      cursor: result.cursor
     });
   });
   return cmd;
 }
 
 // src/commands/tools/runs/input.ts
-var import_node_fs9 = require("fs");
+var import_node_fs10 = require("fs");
 function readRunToolRequest(source) {
   const raw = readUtf8Source("--input", source);
   let parsed;
@@ -86688,7 +86723,7 @@ function readRunToolRequest(source) {
 function readJsonlFile(source) {
   let buf;
   try {
-    buf = (0, import_node_fs9.readFileSync)(source);
+    buf = (0, import_node_fs10.readFileSync)(source);
   } catch (err) {
     throw new InvalidArgumentError(`--bulk: could not read ${source} (${err.message})`);
   }
@@ -86729,7 +86764,7 @@ function validateJsonl(buf) {
 function readUtf8Source(flagName, source) {
   const display = source === "-" ? "stdin" : source;
   try {
-    return source === "-" ? (0, import_node_fs9.readFileSync)(0, "utf8") : (0, import_node_fs9.readFileSync)(source, "utf8");
+    return source === "-" ? (0, import_node_fs10.readFileSync)(0, "utf8") : (0, import_node_fs10.readFileSync)(source, "utf8");
   } catch (err) {
     throw new InvalidArgumentError(`${flagName}: could not read ${display} (${err.message})`);
   }
@@ -87903,7 +87938,8 @@ var TCNodeConfig = external_exports.discriminatedUnion("nodeType", [
     ...TCNodeConfigShared,
     modelId: external_exports.string().optional(),
     claygentId: external_exports.string().optional(),
-    claygentVersionId: external_exports.string().optional()
+    claygentVersionId: external_exports.string().optional(),
+    authAccountId: external_exports.string().nullable().optional()
   }),
   TCForkNodeConfig.unwrap().extend({
     nodeType: external_exports.literal("fork"),
@@ -87935,7 +87971,8 @@ var TCNodeConfig = external_exports.discriminatedUnion("nodeType", [
     // When mode is 'agent', either mapConfig.agentConfig or claygentId must be present.
     // This invariant is enforced at runtime in claygent-node-execution.service.ts.
     claygentId: external_exports.string().optional(),
-    claygentVersionId: external_exports.string().optional()
+    claygentVersionId: external_exports.string().optional(),
+    authAccountId: external_exports.string().nullable().optional()
   }),
   external_exports.object({
     nodeType: external_exports.literal("reduce"),
@@ -88421,6 +88458,117 @@ var TCWorkflowSnapshotContent = external_exports.object({
   containsCycles: external_exports.boolean()
 });
 
+// ../../libs/terracotta/src/step-outputs.ts
+var ModelAwareUsageSchema = external_exports.custom();
+var ConditionalEvaluationSchema = external_exports.object({
+  mode: external_exports.enum(["rules", "code", "agentic"]).optional(),
+  matchedRuleIndex: external_exports.number().nullable(),
+  matchedRuleName: external_exports.string().nullable(),
+  usedDefault: external_exports.boolean(),
+  targetNodeId: external_exports.string(),
+  targetNodeName: external_exports.string(),
+  reasoning: external_exports.string().optional(),
+  modelId: external_exports.string().optional()
+});
+var ToolResultSchema = external_exports.object({
+  success: external_exports.boolean(),
+  result: external_exports.unknown().optional(),
+  metadata: external_exports.unknown().optional()
+});
+var ToolCallErrorSchema = external_exports.object({
+  toolName: external_exports.string(),
+  toolCallId: external_exports.string(),
+  errorMessage: external_exports.string(),
+  failureCount: external_exports.number()
+});
+var StepOutputsBaseSchema = external_exports.object({
+  usage: ModelAwareUsageSchema.optional(),
+  error: external_exports.string().optional(),
+  isTerminal: external_exports.boolean().optional()
+});
+var AgentStepOutputsSchema = StepOutputsBaseSchema.extend({
+  structuredOutputs: external_exports.record(external_exports.unknown()).optional(),
+  reasoning: external_exports.string().optional(),
+  stepsTaken: external_exports.array(external_exports.string()).optional(),
+  toolResult: ToolResultSchema.optional(),
+  summarizedToolResults: external_exports.string().optional(),
+  nodeId: external_exports.string().optional(),
+  nodeName: external_exports.string().optional(),
+  nextNodeId: external_exports.string().optional(),
+  toolCallError: ToolCallErrorSchema.optional(),
+  entryOutput: external_exports.record(external_exports.unknown()).optional(),
+  executedAt: external_exports.string().optional(),
+  failedToolName: external_exports.string().optional()
+}).catchall(external_exports.unknown());
+var CodeStepOutputsSchema = StepOutputsBaseSchema.extend({
+  structuredOutputs: external_exports.record(external_exports.unknown()).optional(),
+  capturedStdout: external_exports.string().optional(),
+  explicitTransition: CodeTransition.optional(),
+  executedAt: external_exports.string().optional()
+}).catchall(external_exports.unknown());
+var ConditionalStepOutputsSchema = StepOutputsBaseSchema.extend({
+  conditionalEvaluation: ConditionalEvaluationSchema.optional(),
+  resolvedVariables: external_exports.record(external_exports.unknown()).optional(),
+  matchedRuleIndex: external_exports.number().nullable().optional(),
+  usedDefault: external_exports.boolean().optional(),
+  mode: external_exports.enum(["rules", "code", "agentic"]).optional(),
+  modelId: external_exports.string().optional(),
+  reasoning: external_exports.string().optional()
+}).catchall(external_exports.unknown());
+var ToolStepOutputsSchema = StepOutputsBaseSchema.extend({
+  toolResult: ToolResultSchema.optional()
+}).catchall(external_exports.unknown());
+var MapStepOutputsSchema = StepOutputsBaseSchema.extend({
+  dataListId: external_exports.string().optional(),
+  totalEntries: external_exports.number().optional(),
+  totalChunks: external_exports.number().optional(),
+  successCount: external_exports.number().optional(),
+  failedCount: external_exports.number().optional(),
+  tokensUsed: external_exports.number().optional(),
+  creditsUsed: external_exports.number().optional(),
+  results: external_exports.array(external_exports.unknown()).optional(),
+  errors: external_exports.unknown().optional(),
+  autoGathered: external_exports.boolean().optional(),
+  entryOutput: external_exports.record(external_exports.unknown()).optional()
+}).catchall(external_exports.unknown());
+var ReduceStepOutputsSchema = StepOutputsBaseSchema.extend({
+  dataListId: external_exports.string().optional(),
+  reduceInitiated: external_exports.boolean().optional(),
+  sourceDataListId: external_exports.string().optional(),
+  outputDataListId: external_exports.string().optional(),
+  keyCount: external_exports.number().optional(),
+  totalKeys: external_exports.number().optional(),
+  successCount: external_exports.number().optional(),
+  failedCount: external_exports.number().optional(),
+  tokensUsed: external_exports.number().optional(),
+  creditsUsed: external_exports.number().optional(),
+  results: external_exports.array(external_exports.unknown()).optional(),
+  autoGathered: external_exports.boolean().optional(),
+  errors: external_exports.unknown().optional()
+}).catchall(external_exports.unknown());
+var CollectStepOutputsSchema = StepOutputsBaseSchema.extend({
+  dataListId: external_exports.string().optional(),
+  results: external_exports.array(external_exports.unknown()).optional(),
+  totalCount: external_exports.number().optional(),
+  successCount: external_exports.number().optional(),
+  failedCount: external_exports.number().optional(),
+  tokensUsed: external_exports.number().optional(),
+  creditsUsed: external_exports.number().optional(),
+  errors: external_exports.unknown().optional(),
+  rawErrors: external_exports.array(external_exports.unknown()).optional()
+}).catchall(external_exports.unknown());
+var ForkJoinStepOutputsSchema = StepOutputsBaseSchema.catchall(external_exports.unknown());
+var TCWorkflowRunStepOutputsSchema = external_exports.union([
+  AgentStepOutputsSchema,
+  CodeStepOutputsSchema,
+  ConditionalStepOutputsSchema,
+  ToolStepOutputsSchema,
+  MapStepOutputsSchema,
+  ReduceStepOutputsSchema,
+  CollectStepOutputsSchema,
+  ForkJoinStepOutputsSchema
+]);
+
 // ../../libs/terracotta/src/types.ts
 var TCContextDropletContentType = /* @__PURE__ */ ((TCContextDropletContentType2) => {
   TCContextDropletContentType2["tool_result"] = "tool_result";
@@ -88781,6 +88929,8 @@ var SerializedWorkflowRun = external_exports.object({
   workflowSnapshotId: external_exports.string(),
   batchId: external_exports.string().nullable(),
   streamId: external_exports.string().nullable(),
+  triggerId: external_exports.string().nullish(),
+  trigger: SerializedTrigger.nullish(),
   runStatus: TCWorkflowRunStatus2,
   runState: TCWorkflowRunState,
   maxUninterruptedSteps: external_exports.number(),
@@ -88833,7 +88983,7 @@ var BaseWorkflowRunStepFields = {
   data: TCWorkflowRunStepData,
   functionExecutionMetadata: TCWorkflowRunStepFunctionExecutionMetadata.nullable().optional(),
   stepInputs: external_exports.record(external_exports.unknown()).nullable(),
-  stepOutputs: external_exports.record(external_exports.unknown()).nullable(),
+  stepOutputs: TCWorkflowRunStepOutputsSchema.nullable(),
   creditUsageMetadata: WorkflowCreditUsageMetadata.nullable(),
   status: TCWorkflowRunStepStatus,
   inCurrentStatusSince: external_exports.number(),
@@ -88844,6 +88994,7 @@ var BaseWorkflowRunStepFields = {
   nodeName: external_exports.string().nullable(),
   // Enriched fields (present when API computes them)
   stepType: WorkflowRunStepType.optional(),
+  nodeType: TCWorkflowNodeType.optional(),
   statusDetail: StepStatusDetail.nullable().optional(),
   statusDetailLabel: external_exports.string().nullable().optional()
 };
@@ -88904,6 +89055,7 @@ var SerializedWorkflow = external_exports.object({
 var SerializedWorkflows = external_exports.object({
   workflows: external_exports.array(SerializedWorkflow)
 });
+var WORKFLOW_LIST_DEFAULT_PAGE_SIZE = 50;
 var WORKFLOW_LIST_MAX_PAGE_SIZE = 200;
 var ListWorkflowsQuerySchema = external_exports.object({
   cursor: external_exports.string().optional(),
@@ -89206,9 +89358,9 @@ function buildListCommand6() {
   const cmd = new Command("list");
   cmd.description("List workflows in the workspace.").option(
     "--limit <n>",
-    "Cap the number of workflows returned. By default the command returns all workflows.",
-    parseLimitFlag
-  ).addHelpText(
+    `The number of workflows returned (1 - ${WORKFLOW_LIST_MAX_PAGE_SIZE}). Defaults to ${WORKFLOW_LIST_DEFAULT_PAGE_SIZE}`,
+    parseLimitFlagWithMax(WORKFLOW_LIST_MAX_PAGE_SIZE)
+  ).option("--cursor <string>", "Resume from a previous response's `cursor` to fetch the next page.").addHelpText(
     "after",
     `
 Output (success, exit 0):
@@ -89219,11 +89371,18 @@ Output (success, exit 0):
         "name": <string>,
         "url": <string>
       }
-    ]
+    ],
+    "cursor": <string|undefined>
   }
 
+Pagination:
+  --limit <n>       max workflows per call. Defaults to ${WORKFLOW_LIST_DEFAULT_PAGE_SIZE}.
+  --cursor <token>  resume from a previous response's \`cursor\`
+  When more results exist, the response includes a top-level \`cursor\`; pass it back via
+  --cursor to fetch the next page.
+
 Common errors:
-  validation_error (exit 2)  --limit is not a positive integer.
+  validation_error (exit 2)  --limit is not a positive integer or exceeds ${WORKFLOW_LIST_MAX_PAGE_SIZE}.
   auth_forbidden   (exit 3)  Key lacks the terracotta:cli scope.
 
 Examples:
@@ -89234,15 +89393,22 @@ Examples:
   ).action(async (opts) => {
     const workspaceId = await currentWorkspaceId();
     const client = await v3Client(terracottaWorkflowsContract);
-    const result = await unwrap(client.getWorkflows({ params: { workspaceId } }));
-    const workflows = opts.limit === void 0 ? result.workflows : result.workflows.slice(0, opts.limit);
-    writeJson({ data: workflows.map((workflow) => projectWorkflow(workflow, workspaceId)) });
+    const result = await unwrap(
+      client.listWorkflows({
+        params: { workspaceId },
+        query: { limit: opts.limit ?? WORKFLOW_LIST_DEFAULT_PAGE_SIZE, cursor: opts.cursor ?? void 0 }
+      })
+    );
+    writeJson({
+      data: result.workflows.map((workflow) => projectWorkflow(workflow, workspaceId)),
+      cursor: result.nextCursor ?? void 0
+    });
   });
   return cmd;
 }
 
 // src/commands/workflows/runs/download-file.ts
-var import_node_fs10 = require("fs");
+var import_node_fs11 = require("fs");
 var import_node_path7 = require("path");
 
 // ../../libs/api-contract/src/terracotta/code-tool/interfaces.ts
@@ -89354,7 +89520,7 @@ Examples:
     const outputPath = opts.output ?? (0, import_node_path7.basename)(opts.path);
     const bytes = Buffer.from(result.fileData, "base64");
     try {
-      (0, import_node_fs10.writeFileSync)(outputPath, bytes);
+      (0, import_node_fs11.writeFileSync)(outputPath, bytes);
     } catch (err) {
       throw new FileWriteError(
         `Could not write to ${outputPath}: ${err instanceof Error ? err.message : String(err)}`