sim 2.1.3-preview.50.1 → 2.1.3-preview.52.1

package/dist/index.js

@@ -2866,6 +2866,10 @@ function traceRequest(method, url, status, startedAt) {
   process.stderr.write(`${source_default.dim(`[sim] ${method} ${url} → ${status} ${Math.round(performance.now() - startedAt)}ms`)}
 `);
 }
+function withoutLeadingLabel(message, label) {
+  const prefix = `${label}: `;
+  return message.startsWith(prefix) ? message.slice(prefix.length) : message;
+}
 function formatApiErrorDetails(details) {
   const issues = [];
   const seen = new Set;
@@ -2903,7 +2907,10 @@ function formatApiErrorDetails(details) {
   const visible = kept.slice(0, 8);
   const lines = [
     "  details:",
-    ...visible.map((issue) => `    ${issue.path.length > 0 ? issue.path.join(".") : "request"}: ${issue.message}`)
+    ...visible.map((issue) => {
+      const label = issue.path.length > 0 ? issue.path.join(".") : "request";
+      return `    ${label}: ${withoutLeadingLabel(issue.message, label)}`;
+    })
   ];
   if (kept.length > visible.length)
     lines.push(`    … ${kept.length - visible.length} more issues`);
@@ -3041,10 +3048,13 @@ function pageProgress() {
   };
 }
 async function requestAllPages(client, path, options) {
+  return (await requestPages(client, path, options)).items;
+}
+async function requestPages(client, path, options) {
   const { query, pageSize, limit: requestedLimit, ...requestOptions } = options;
   const limit = requestedLimit ?? Number.POSITIVE_INFINITY;
   if (limit <= 0)
-    return [];
+    return { items: [], truncated: false };
   const items = [];
   const progress = pageProgress();
   let cursor = null;
@@ -3066,7 +3076,7 @@ async function requestAllPages(client, path, options) {
   } finally {
     progress.finish();
   }
-  return items.slice(0, limit);
+  return { items: items.slice(0, limit), truncated: cursor !== null || items.length > limit };
 }
 function resolvePath(template, params = {}) {
   return template.replace(/\[([^\]]+)\]/g, (_match, key) => {
@@ -9198,7 +9208,7 @@ var V2_OPERATIONS = {
       },
       parentPath: {
         kind: "string",
-        describe: "Restrict results to direct children of this parent path."
+        describe: "Restrict results to direct children of this parent path. A path that names no folder narrows the result to nothing, so the response is an empty page rather than an error."
       },
       search: {
         kind: "string",
@@ -9531,7 +9541,7 @@ var V2_OPERATIONS = {
       },
       parentPath: {
         kind: "string",
-        describe: "Restrict results to direct children of this parent path."
+        describe: "Restrict results to direct children of this parent path. A path that names no folder narrows the result to nothing, so the response is an empty page rather than an error."
       },
       search: {
         kind: "string",
@@ -9884,7 +9894,7 @@ var V2_OPERATIONS = {
       },
       parentPath: {
         kind: "string",
-        describe: "Restrict results to direct children of this parent path."
+        describe: "Restrict results to direct children of this parent path. A path that names no folder narrows the result to nothing, so the response is an empty page rather than an error."
       },
       search: {
         kind: "string",
@@ -10050,7 +10060,7 @@ var V2_OPERATIONS = {
       },
       parentPath: {
         kind: "string",
-        describe: "Restrict results to direct children of this parent path."
+        describe: "Restrict results to direct children of this parent path. A path that names no folder narrows the result to nothing, so the response is an empty page rather than an error."
       },
       search: {
         kind: "string",
@@ -11902,14 +11912,22 @@ function requireValue(value, flag, key) {
     throw new SimApiError(`${flag} requires a value. To remove it, run: sim configure --unset ${key}`, 0);
   }
 }
+function quoteProfileArgument(name) {
+  const redacted = redact(name);
+  if (PROFILE_NAME_PATTERN.test(redacted))
+    return redacted;
+  return `'${redacted.replaceAll("'", "'\\''")}'`;
+}
 function configureCommand() {
   return new Command("configure").description("Set a profile's endpoint, default workspace, or output format").option("--set-endpoint <url>", "Sim deployment to talk to").option("--set-workspace <id>", "Default workspace for workspace-scoped commands").option("--set-output <format>", `Default output format (${OUTPUT_FORMATS.join(" | ")})`).option("--unset <key...>", "Remove settings (endpoint, workspace, output)").action((options, command) => {
     const globals = globalsOf(command);
+    const selectedProfile = globals.profile || process.env.SIM_PROFILE;
+    const profileArg = selectedProfile ? ` --profile ${quoteProfileArgument(selectedProfile)}` : "";
     for (const { option, flag, setFlag } of GLOBAL_FLAG_TWINS) {
       const value = globals[option];
       if (value === undefined)
         continue;
-      throw new SimApiError(`${flag} applies to a single command and is not stored. To save it, run: sim configure ${setFlag} ${value}`, 0);
+      throw new SimApiError(`${flag} applies to a single command and is not stored. To save it, run: sim configure${profileArg} ${setFlag} ${redact(value)}`, 0);
     }
     const profile = profileFrom(command, { allowUnknownProfile: true });
     const authProfile = resolveAuthenticationProfileName(profile.name);
@@ -11970,7 +11988,7 @@ var TABLE_SORT_HELP = 'Ordered sort keys: [{"field":"createdAt","direction":"des
 var KNOWLEDGE_TAG_DEFINITIONS_HELP = 'Tag definitions: [{"tagSlot":"tag1","displayName":"category","fieldType":"text"}]';
 var CUSTOM_TOOL_SCHEMA_HELP = 'OpenAI function schema: {"type":"function","function":{"name":"...","parameters":{"type":"object","properties":{}}}}';
 var DISPATCH_ROW_LIMIT_HELP = "Stop after this many eligible rows have run (1-1,000,000). Omit for an unbounded run";
-var WORKFLOW_OPERATIONS_HELP = 'Edits to apply, in a single batch, keyed by operation_type: [{"operation_type":"add","block_id":"my-fn","params":{"type":"function","name":"My Fn","inputs":{"code":"return {ok:true}"}}},{"operation_type":"edit","block_id":"<uuid>","params":{"name":"Renamed","connections":{"success":"my-fn"}}},{"operation_type":"delete","block_id":"<uuid>"}]. Also insert_into_subflow and extract_from_subflow, whose params carry {"subflowId":"<loop-id>"}';
+var WORKFLOW_OPERATIONS_HELP = 'Edits to apply, in a single batch, keyed by operation_type: [{"operation_type":"add","block_id":"my-fn","params":{"type":"function","name":"My Fn","inputs":{"code":"return {ok:true}"}}},{"operation_type":"edit","block_id":"<uuid>","params":{"name":"Renamed","connections":{"success":"my-fn"}}},{"operation_type":"delete","block_id":"<uuid>"}]. Also extract_from_subflow, whose params carry {"subflowId":"<loop-id>"}, and insert_into_subflow, which creates a block and so takes an add’s params plus that subflowId';
 var WORKFLOW_SET_BLOCK_ENABLED_HELP = 'Blocks to enable or disable, applied after --operations: [{"block_id":"<uuid>","enabled":false}]. Disabling a loop or parallel cascades to its unlocked descendants; enabling a block whose container is disabled is declined';
 var WORKFLOW_VARIABLE_OPERATIONS_HELP = 'Variable changes to apply in order, keyed by operation: [{"operation":"add","name":"my_var","type":"string","value":"hello"},{"operation":"edit","name":"my_var","value":"updated"},{"operation":"delete","name":"my_var"}]';
 var MCP_PARAMETER_DESCRIPTIONS_HELP = 'Per-field description overrides applied to the schema generated from the deployed workflow inputs, as [{"name":"email","description":"Customer email address"}]. A name matching no input field is ignored';
@@ -12046,7 +12064,7 @@ var CLI_CONTRACT = {
   listBillingLogs: {
     command: "billing logs",
     allWorkspaces: true,
-    describe: "List credit usage events (a personal API key reports only your own events; a workspace API key reports every member's)",
+    describe: "List credit usage events (a personal API key reports only your own events; a workspace API key reports every member's in aggregate, unattributed)",
     flags: {
       source: { describe: "Filter by usage source; sim-chat combines Copilot and workspace chat" },
       period: { describe: "Billing period" },
@@ -12239,7 +12257,7 @@ var CLI_CONTRACT = {
   },
   getLogStats: {
     command: "logs stats",
-    describe: "Summarize run counts, failures, and cost over a window",
+    describe: "Summarize run counts, failures and latency over a window",
     flags: LOG_LIST_FILTER_FLAGS,
     fields: [
       { header: "runs", path: "totalRuns" },
@@ -12316,6 +12334,9 @@ var CLI_CONTRACT = {
   rollbackWorkflow: {
     confirm: "This changes which deployed version runs in production for every API and chat consumer."
   },
+  activateWorkflowVersion: {
+    confirm: "This changes which deployed version runs in production for every API and chat consumer."
+  },
   moveWorkflows: {
     command: "workflows move",
     flags: {
@@ -12567,7 +12588,7 @@ var CLI_CONTRACT = {
   listCustomTools: {
     columns: [
       { header: "id" },
-      { header: "name", path: "title" },
+      { header: "title", path: "title" },
       { header: "description", path: "schema.function.description" },
       { header: "updated", path: "updatedAt", format: "timestamp" }
     ]
@@ -12799,6 +12820,7 @@ var CLI_CONTRACT = {
     ]
   },
   listFileFolders: {
+    describe: "List folders",
     aliases: ["ls"],
     flags: {
       parentPath: { ...FOLDER_PATH_INPUT, name: "parent", describe: "Direct parent folder path" }
@@ -12806,6 +12828,7 @@ var CLI_CONTRACT = {
     columns: FOLDER_LIST_COLUMNS
   },
   listKnowledgeFolders: {
+    describe: "List knowledge folders",
     aliases: ["ls"],
     flags: {
       parentPath: { ...FOLDER_PATH_INPUT, name: "parent", describe: "Direct parent folder path" }
@@ -12813,6 +12836,7 @@ var CLI_CONTRACT = {
     columns: FOLDER_LIST_COLUMNS
   },
   listTableFolders: {
+    describe: "List table folders",
     aliases: ["ls"],
     flags: {
       parentPath: { ...FOLDER_PATH_INPUT, name: "parent", describe: "Direct parent folder path" }
@@ -12820,6 +12844,7 @@ var CLI_CONTRACT = {
     columns: FOLDER_LIST_COLUMNS
   },
   listWorkflowFolders: {
+    describe: "List workflow folders",
     aliases: ["ls"],
     flags: {
       parentPath: { ...FOLDER_PATH_INPUT, name: "parent", describe: "Direct parent folder path" }
@@ -13298,6 +13323,7 @@ function encodeFolderPath(value) {
     }
   }).join("/");
 }
+var FRACTIONAL_DIGITS = /\.\d*[1-9]/;
 function pathHint(raw) {
   if (raw.startsWith("@") || /^\s*[[{"\-\d]|^\s*(true|false|null)/.test(raw))
     return "";
@@ -13326,6 +13352,12 @@ function coerce(raw, field, flag, flagName) {
     const value = Number(raw);
     if (Number.isNaN(value))
       throw new SimApiError(`--${flagName} must be a number`, 0);
+    if (field.kind === "integer" && (!Number.isInteger(value) || FRACTIONAL_DIGITS.test(String(raw)))) {
+      throw new SimApiError(`--${flagName} must be a whole number`, 0);
+    }
+    if (field.kind === "integer" && !Number.isSafeInteger(value)) {
+      throw new SimApiError(`--${flagName} is outside the whole-number range the API accepts (±${Number.MAX_SAFE_INTEGER})`, 0);
+    }
     return value;
   }
   if (field.kind === "boolean" || flag.boolean)
@@ -13385,6 +13417,9 @@ function buildRequest(operation, positional, flags, workspaceId) {
         throw new SimApiError(`--${flagName} cannot be empty`, 0);
       }
       const value = coerce(raw ?? undefined, descriptor, flag, flagName);
+      if (field === "limit" && !paginatedLimit && NUMERIC_KINDS.has(descriptor.kind) && typeof value === "number" && value < 1) {
+        throw new SimApiError(`--${flagName} must be 1 or more`, 0);
+      }
       if (value === undefined) {
         if (descriptor.required) {
           throw new SimApiError(field === PROFILE_INJECTED_FIELD ? NO_WORKSPACE_FALLBACK : `--${flagName} is required`, 0);
@@ -13533,7 +13568,7 @@ function addOperationOptions(command, operation, commandSpec, operationSpec) {
   }
   if (commandSpec.confirm) {
     const exemptedByDryRun = operationSpec.query?.dryRun !== undefined || operationSpec.body?.dryRun !== undefined;
-    command.option("-y, --yes", exemptedByDryRun ? "Confirm this destructive operation (required unless --dry-run)" : "Confirm this destructive operation (required)");
+    command.option("-y, --yes", exemptedByDryRun ? "Confirm this operation (required unless --dry-run)" : "Confirm this operation (required)");
   }
 }
 
@@ -13959,6 +13994,14 @@ var BULK_OUTCOME_CHECKS = {
     const reported2 = payload.errors?.[0];
     return typeof reported2 === "string" && reported2 ? safeOneLine(reported2) : `Updated nothing: none of the ${requested} requested ${requested === 1 ? "chunk" : "chunks"} matched.`;
   },
+  deleteTableRows: (payload) => {
+    if (countOf(payload.deletedCount) > 0)
+      return null;
+    const requested = countOf(payload.requestedCount);
+    if (requested === 0)
+      return null;
+    return `Deleted nothing: none of the ${requested} requested ${requested === 1 ? "row was" : "rows were"} deleted.`;
+  },
   moveTables: (payload) => {
     if (lengthOf(payload.moved) > 0)
       return null;
@@ -13993,6 +14036,14 @@ function bulkFailureMessage(operation, payload, body) {
 var EXCLUSIVE_CAP_FIELDS = {
   deleteTableRows: { cap: "limit", ids: "rowIds" }
 };
+function readPagedLimit(raw) {
+  const text2 = String(raw ?? DEFAULT_LIMIT).trim();
+  const value = text2 === "" ? Number.NaN : Number(text2);
+  if (!Number.isInteger(value) || value < 0) {
+    throw new SimApiError("--limit must be a whole number of 0 or more (0 for everything)", 0);
+  }
+  return value;
+}
 function assertCapIsUsable(operation, flags) {
   const exclusive = EXCLUSIVE_CAP_FIELDS[operation];
   if (!exclusive)
@@ -14003,6 +14054,19 @@ function assertCapIsUsable(operation, flags) {
     return;
   throw new SimApiError(`--${cap} caps a --filter match and does nothing to an explicit --${ids} list; pass one, not both`, 0);
 }
+var REQUIRED_SELECTORS = {
+  deleteTableRows: { fields: ["filter", "rowIds"], noun: "rows to delete" }
+};
+function assertSelectorIsUsable(operation, flags) {
+  const selector = REQUIRED_SELECTORS[operation];
+  if (!selector)
+    return;
+  const [first, second] = selector.fields.map((field) => flagNameFor(operation, field));
+  const given = [first, second].filter((name) => flags[camel(name)] !== undefined);
+  if (given.length === 1)
+    return;
+  throw new SimApiError(given.length === 0 ? `--${first} or --${second} is required to choose the ${selector.noun}` : `--${first} and --${second} choose the ${selector.noun} two different ways; pass one, not both`, 0);
+}
 function foldRenamedFlags(operation, commandSpec, flags) {
   for (const [field, flag] of Object.entries(commandSpec.flags ?? {})) {
     if (!flag.renamedFrom?.length)
@@ -14036,6 +14100,7 @@ async function executeOperation(operation, commandSpec, operationSpec, invocatio
   }
   foldRenamedFlags(operation, commandSpec, requestFlags);
   assertCapIsUsable(operation, requestFlags);
+  assertSelectorIsUsable(operation, requestFlags);
   if (commandSpec.confirm && !requestFlags.yes && requestFlags.dryRun !== true) {
     throw new SimApiError(`${commandSpec.confirm} Re-run with --yes to confirm.`, 0);
   }
@@ -14046,15 +14111,11 @@ async function executeOperation(operation, commandSpec, operationSpec, invocatio
   const hasWorkspaceField = Boolean(operationSpec.query && PROFILE_INJECTED_FIELD in operationSpec.query || operationSpec.body && PROFILE_INJECTED_FIELD in operationSpec.body);
   const omitsWorkspace = commandSpec.allWorkspaces && requestFlags.allWorkspaces === true;
   const needsWorkspace = (hasWorkspaceField || commandSpec.profileWorkspacePath === true) && !omitsWorkspace;
-  const request = buildRequest(operation, positional, requestFlags, needsWorkspace ? client.requireWorkspace() : profile.workspaceId);
   const paging = cursorSlot(operationSpec);
+  const pagedLimit = paging ? readPagedLimit(requestFlags.limit) : 0;
+  const request = buildRequest(operation, positional, requestFlags, needsWorkspace ? client.requireWorkspace() : profile.workspaceId);
   if (paging) {
-    const limitText = String(requestFlags.limit ?? DEFAULT_LIMIT).trim();
-    const rawLimit = limitText === "" ? Number.NaN : Number(limitText);
-    if (!Number.isInteger(rawLimit) || rawLimit < 0) {
-      throw new SimApiError("--limit must be a whole number of 0 or more (0 for everything)", 0);
-    }
-    const limit = rawLimit === 0 ? Number.POSITIVE_INFINITY : rawLimit;
+    const limit = pagedLimit === 0 ? Number.POSITIVE_INFINITY : pagedLimit;
     const pageSize = Math.min(Number.isFinite(limit) ? limit : DEFAULT_LIMIT, DEFAULT_LIMIT);
     const pageLimit = "limit" in (operationSpec[paging] ?? {}) ? { limit: pageSize } : {};
     const rows = [];
@@ -14139,6 +14200,14 @@ function retypeMessage(message, spellings) {
       continue;
     retyped = retyped.replaceAll(new RegExp(`\\b${field}\\b`, "g"), spelling);
   }
+  if (retyped === message)
+    return message;
+  for (const field of spellings.keys()) {
+    if (WIRE_IDENTIFIER.test(field))
+      continue;
+    if (new RegExp(`\\b${field}\\b`).test(message))
+      return message;
+  }
   return retyped;
 }
 function retypeDetails(details, spellings) {
@@ -14204,18 +14273,30 @@ function commandPath(command) {
   }
   return names.join(" ");
 }
-function addMissingArgumentExample(command) {
+var UNKNOWN_OPTION_TOKEN = /^error: unknown option '(.+?)'/;
+function looksLikeAnId(token2) {
+  return token2.length > 2 && !token2.startsWith("--") && /^-[A-Za-z0-9_-]*[A-Z0-9][A-Za-z0-9_-]*$/.test(token2);
+}
+function addArgumentExamples(command) {
   const outputError = command.configureOutput().outputError;
   if (!outputError)
     throw new Error("Commander output formatter is not configured");
   command.configureOutput({
     outputError: (message, write) => {
       outputError(message, write);
-      if (!message.startsWith("error: missing required argument "))
+      if (message.startsWith("error: missing required argument ")) {
+        const syntax = argumentSyntax(command);
+        const example = syntax ? `${commandPath(command)} ${syntax}` : commandPath(command);
+        write(`Example: ${example}
+`);
+        return;
+      }
+      if (command.registeredArguments.length === 0)
+        return;
+      const token2 = UNKNOWN_OPTION_TOKEN.exec(message)?.[1];
+      if (!token2 || !looksLikeAnId(token2))
         return;
-      const syntax = argumentSyntax(command);
-      const example = syntax ? `${commandPath(command)} ${syntax}` : commandPath(command);
-      write(`Example: ${example}
+      write(`Example: ${commandPath(command)} -- ${token2}
 `);
     }
   });
@@ -14342,7 +14423,7 @@ function configureOperation(command, operation, spec) {
   return command;
 }
 function buildLeaf(operation, spec, leafName) {
-  return addMissingArgumentExample(configureOperation(new Command(leafName), operation, spec));
+  return addArgumentExamples(configureOperation(new Command(leafName), operation, spec));
 }
 function addRenamedCommand(groups, operation, spec, from, to) {
   const segments = from.split(" ");
@@ -14662,6 +14743,12 @@ Examples:
   $ sim chat -c 3f2a… "Which of those run on a schedule?"
   $ sim --output json chat "Summarize yesterday's failed runs" | jq -r '.content'
 `).action(async (message, options, command) => {
+    if (message.trim() === "") {
+      throw new SimApiError("<message> cannot be empty", 0);
+    }
+    if (options.conversation !== undefined && options.conversation.trim() === "") {
+      throw new SimApiError("-c/--conversation cannot be empty — pass the conversation id printed on stderr after each turn", 0);
+    }
     const { client, profile } = clientFrom(command);
     const workspaceId = client.requireWorkspace();
     const response = await client.requestRaw(V2_OPERATIONS.chat.path, {
@@ -15070,8 +15157,15 @@ function uploadMetadata(options) {
   }
   return metadata;
 }
+var UPLOAD_RECIPES = [
+  "default",
+  "plain",
+  "markdown",
+  "code"
+];
+var LANGUAGE_TAG_HELP = "Document language tag: hyphen-separated letter and digit subtags, for example en or en-US";
 function attachKnowledgeDocumentUpload(documents) {
-  documents.command("upload").argument("<knowledgeBaseId>", "Knowledge base to upload into").argument("<path>", "Local file to upload").allowExcessArguments(false).description("Upload a document to a knowledge base").option("--name <name>", "Store it under a different name").option("--tag <value...>", "Document tags, in tag1 through tag7 order").option("--recipe <name>", "Document processing recipe").option("--lang <code>", "Document language code").action(async (knowledgeBaseId, path, options, command) => {
+  documents.command("upload").argument("<knowledgeBaseId>", "Knowledge base to upload into").argument("<path>", "Local file to upload").allowExcessArguments(false).description("Upload a document to a knowledge base").option("--name <name>", "Store it under a different name").option("--tag <value...>", "Document tags, in tag1 through tag7 order").addOption(new Option("--recipe <name>", "Document processing recipe").choices(UPLOAD_RECIPES)).option("--lang <code>", LANGUAGE_TAG_HELP).action(async (knowledgeBaseId, path, options, command) => {
     const { client, profile } = clientFrom(command);
     const workspaceId = client.requireWorkspace();
     const { name, size } = await localFile(path, options.name);
@@ -15290,7 +15384,7 @@ function isTransient(error) {
 function nonNegativeInteger(raw, flag) {
   const value = Number(raw);
   if (!Number.isSafeInteger(value) || value < 0) {
-    throw new SimApiError(`${flag} must be a non-negative integer`, 0);
+    throw new SimApiError(`${flag} must be a whole number of 0 or more`, 0);
   }
   return value;
 }
@@ -15317,7 +15411,7 @@ follow.
 
 Examples:
   $ sim logs follow --level error
-  $ sim logs follow --workflow wf_123 -n 0
+  $ sim logs follow --workflow 00000000-0000-4000-8000-000000000000 -n 0
   $ sim --output json logs follow | jq -r '.runId'
 `).action(async (options, command) => {
     const lines = nonNegativeInteger(options.lines, "--lines");
@@ -15399,9 +15493,9 @@ async function listResources(client, config, workspaceId, folderPath, search, li
   const paginated = "cursor" in V2_OPERATIONS[config.resources].query;
   if (!paginated) {
     const page = await client.request(path, { query });
-    return page.data.slice(0, limit);
+    return { items: page.data.slice(0, limit), truncated: page.data.length > limit };
   }
-  return requestAllPages(client, path, {
+  return requestPages(client, path, {
     query,
     pageSize: DEFAULT_LIMIT,
     limit
@@ -15436,7 +15530,7 @@ function attachResourceDirectoryCommands(group, config) {
   group.command("ls").argument("[path]", "Folder path to list; defaults to the root folder").allowExcessArguments(false).description(`List ${config.kind} resources and child folders together`).option("--search <text>", "Filter folders and resources by name").addOption(new Option("--limit <n>", "Maximum combined items to return (0 for everything)").default(String(DEFAULT_LIMIT))).action(async (path, options, command) => {
     const rawLimit = Number(options.limit);
     if (!Number.isSafeInteger(rawLimit) || rawLimit < 0) {
-      throw new SimApiError("--limit must be a non-negative integer", 0);
+      throw new SimApiError("--limit must be a whole number of 0 or more (0 for everything)", 0);
     }
     const limit = rawLimit === 0 ? Number.POSITIVE_INFINITY : rawLimit;
     const folderPath = encodeFolderPath(path ?? "/");
@@ -15446,8 +15540,10 @@ function attachResourceDirectoryCommands(group, config) {
       listFolders(client, config.folders, workspaceId, folderPath, options.search),
       listResources(client, config, workspaceId, folderPath, options.search, limit)
     ]);
-    const entries = entriesFor(config, folders, resources);
-    printList(profile.output, entries.slice(0, limit), COLUMNS2);
+    const entries = entriesFor(config, folders, resources.items);
+    const shown = entries.slice(0, limit);
+    writeCursorTruncation(shown.length, resources.truncated || entries.length > limit);
+    printList(profile.output, shown, COLUMNS2);
   });
   group.command("mkdir").argument("<path>", "Folder path to create; the leading / is optional").allowExcessArguments(false).description(`Create a ${config.kind} directory at a path`).action(async (path, _options, command) => {
     const { client, profile } = clientFrom(command);
@@ -16194,7 +16290,9 @@ Profiles work like the AWS CLI: settings live in ~/.sim/config, keys in
 with -P, --profile, or SIM_PROFILE.
 
 Workflow, knowledge-base and workspace IDs are bare UUIDs. Table IDs carry a
-tbl_ prefix and file IDs a wf_ one, so wf_ never names a workflow.
+tbl_ prefix and file IDs a wf_ one, so wf_ never names a workflow. An audit-log
+or custom-tool ID can open with a dash, which reads as a flag; put -- in front
+of it, as in sim audit-logs get -- -HlDcD1z76nK6R4crsUp0.
 
 Examples:
   $ sim login                          Authorize the default profile

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sim",
-  "version": "2.1.3-preview.50.1",
+  "version": "2.1.3-preview.52.1",
   "description": "Sim CLI - talk to the Sim API from your terminal",
   "type": "module",
   "bin": {