@fairmint/captable-ai 0.1.35 → 0.1.37

package/dist/index.js

@@ -15113,22 +15113,27 @@ function deriveExtractionReadinessPhase(summary) {
   return "complete";
 }
 var IMPORT_SESSION_CLOCK_SKEW_MS = 5e3;
-function documentsForImportSession(documents, sessionCreatedAt) {
-  if (typeof sessionCreatedAt !== "string")
-    return [];
-  const sessionMs = parseTimestampMs(sessionCreatedAt);
-  if (sessionMs === null)
-    return [];
-  const cutoffMs = sessionMs - IMPORT_SESSION_CLOCK_SKEW_MS;
+function sameUuid(a, b) {
+  return typeof b === "string" && a.toLowerCase() === b.toLowerCase();
+}
+function documentsForImportSession(documents, sessionCreatedAt, sessionId) {
+  const sessionMs = typeof sessionCreatedAt === "string" ? parseTimestampMs(sessionCreatedAt) : null;
+  const cutoffMs = sessionMs === null ? null : sessionMs - IMPORT_SESSION_CLOCK_SKEW_MS;
   return documents.filter((document) => {
-    if (typeof document.createdAt !== "string")
+    if (typeof document.importSessionId === "string") {
+      return sameUuid(document.importSessionId, sessionId);
+    }
+    if (cutoffMs === null || typeof document.createdAt !== "string")
       return false;
     const createdMs = parseTimestampMs(document.createdAt);
     return createdMs !== null && createdMs >= cutoffMs;
   });
 }
 function importSessionScopeUnknown(documents) {
-  return documents.length > 0 && documents.every((document) => typeof document.createdAt !== "string" || parseTimestampMs(document.createdAt) === null);
+  return documents.length > 0 && documents.every((document) => (
+    // A stamped document is attributable without a creation time.
+    typeof document.importSessionId !== "string" && (typeof document.createdAt !== "string" || parseTimestampMs(document.createdAt) === null)
+  ));
 }
 var HAS_ZONE = /(?:Z|[+-]\d{2}(?::?\d{2})?)$/i;
 function parseTimestampMs(value) {
@@ -15608,6 +15613,7 @@ var documentProcessingStatusItemSchema = external_exports.object({
   name: external_exports.string().nullable().optional().describe("Original file name; absent on older servers."),
   status: external_exports.string().describe("Document processing status."),
   createdAt: external_exports.string().nullable().optional().describe("Immutable document creation timestamp; absent on older servers."),
+  importSessionId: external_exports.string().nullable().optional().describe("Import session the upload named (set when the document is uploaded or re-uploaded into that session); null for older uploads and uploads that named none; absent on older servers."),
   lastActivityAt: external_exports.string().nullable().describe("Last backend activity timestamp (updated_at / heartbeat); null if unknown."),
   queuePosition: external_exports.number().int().min(0).nullable().describe("0 = at the head (processing); >0 = waiting behind others; null = not in pipeline."),
   health: external_exports.enum(DOCUMENT_HEALTH_VALUES).describe("Derived health from backend heartbeat + queue position.")
@@ -18569,8 +18575,8 @@ var COMMAND_REGISTRY = [
   {
     name: "objects revert",
     group: "captable",
-    description: "Preview or revert draft objects using backend dependency closure. Execution requires explicit final IDs (<object-id> or --objects) or --all.",
-    usage: "captable-ai objects revert --dry-run [<object-id> | --objects id1,id2,... | --all] [--json]\ncaptable-ai objects revert (<object-id> | --objects id1,id2,... | --all) [--yes] [--json]",
+    description: "Preview or revert draft objects using backend dependency closure. Execution requires explicit final IDs (<object-id>, --objects or --objects-file) or --all.",
+    usage: "captable-ai objects revert --dry-run [<object-id> | --objects id1,id2,... | --objects-file <path|-> | --all] [--json]\ncaptable-ai objects revert (<object-id> | --objects id1,id2,... | --objects-file <path|-> | --all) [--yes] [--json]",
     requiresAuth: true,
     requiresPortal: true,
     flags: [
@@ -18584,6 +18590,11 @@ var COMMAND_REGISTRY = [
         description: "Comma-separated final object IDs to revert selectively.",
         type: "string"
       },
+      {
+        name: "objects-file",
+        description: "File of final object IDs to revert, one per line (- for stdin).",
+        type: "string"
+      },
       {
         name: "all",
         description: "Revert all pending drafts for the active company.",
@@ -18693,8 +18704,8 @@ var COMMAND_REGISTRY = [
   {
     name: "commit",
     group: "captable",
-    description: "Commit pending draft objects to the cap table. Use --dry-run to preview selected/final IDs without writing. Execution requires --objects with final IDs from preview, or --all. Exits with NOTHING_TO_COMMIT if no drafts exist.",
-    usage: "captable-ai commit --dry-run [--objects id1,id2,...] [--json]\ncaptable-ai commit (--objects id1,id2,... | --all) [--json]",
+    description: "Commit pending draft objects to the cap table. Use --dry-run to preview selected/final IDs without writing. Execution requires --objects or --objects-file with final IDs from preview, or --all. Exits with NOTHING_TO_COMMIT if no drafts exist.",
+    usage: "captable-ai commit --dry-run [--objects id1,id2,... | --objects-file <path|->] [--json]\ncaptable-ai commit (--objects id1,id2,... | --objects-file <path|-> | --all) [--json]",
     requiresAuth: true,
     requiresPortal: true,
     flags: [
@@ -18712,6 +18723,11 @@ var COMMAND_REGISTRY = [
         name: "objects",
         description: "Comma-separated final object IDs to commit selectively. Use preview.applyObjectIds.",
         type: "string"
+      },
+      {
+        name: "objects-file",
+        description: "File of final object IDs to commit, one per line (- for stdin).",
+        type: "string"
       }
     ]
   },
@@ -19291,22 +19307,24 @@ Examples:
 var HELP_OBJECTS_REVERT = `objects revert \u2014 Preview or revert draft objects
 
 Usage:
-  captable-ai objects revert --dry-run [<object-id> | --objects id1,id2,... | --all] [--json]
+  captable-ai objects revert --dry-run [<object-id> | --objects id1,id2,... | --objects-file <path|-> | --all] [--json]
   captable-ai objects revert <object-id> [--yes] [--json]
   captable-ai objects revert --objects id1,id2,... [--yes] [--json]
+  captable-ai objects revert --objects-file <path|-> [--yes] [--json]
   captable-ai objects revert --all [--yes] [--json]
 
 Previews or reverts draft objects using the backend dependency closure. Preview
 returns selected IDs, final IDs, auto-included IDs, invalid IDs, dependency
 reasons, blockers, and the applyObjectIds value to use for execution.
 
-Execution requires explicit final IDs (<object-id> or --objects) or --all.
+Execution requires explicit final IDs (<object-id>, --objects or --objects-file) or --all.
 Use IDs from preview.applyObjectIds when applyObjectIds is not null. Revert-all
 prompts for confirmation unless --yes or --json is set.
 
 Options:
   --dry-run         Preview mode \u2014 no write
   --objects IDS     Revert specific final object IDs (comma-separated)
+  --objects-file F  Read the IDs from a file, one per line (- for stdin); for long lists
   --all             Revert all pending drafts for the active company
   --yes             Skip the confirmation prompt (for scripts)
 
@@ -19368,14 +19386,14 @@ ${HELP_SCHEMAS_GET}`;
 var HELP_COMMIT = `commit \u2014 Commit pending drafts to the cap table
 
 Usage:
-  captable-ai commit --dry-run [--objects id1,id2,...] [--json]
-  captable-ai commit (--objects id1,id2,... | --all) [--json]
+  captable-ai commit --dry-run [--objects id1,id2,... | --objects-file <path|->] [--json]
+  captable-ai commit (--objects id1,id2,... | --objects-file <path|-> | --all) [--json]
 
 Previews or commits pending draft objects using the backend dependency closure.
 Preview returns selected IDs, final IDs, auto-included IDs, invalid IDs,
 dependency reasons, blockers, and the applyObjectIds value to use for execution.
 
-Execution requires explicit final IDs (--objects) or --all. Use IDs from
+Execution requires explicit final IDs (--objects or --objects-file) or --all. Use IDs from
 preview.applyObjectIds when applyObjectIds is not null. Exits with
 NOTHING_TO_COMMIT if no drafts exist.
 
@@ -19385,6 +19403,8 @@ Options:
   --objects id1,id2,...   Commit only specific object IDs (comma-separated). The server
                          validates that all transitive dependencies are satisfied.
                          Note: IDs containing commas are not supported.
+  --objects-file F        Read the IDs from a file, one per line (- for stdin), for lists too
+                         long for one command line. The dry run writes one when it must.
 
 Global:
   --json                 Machine-readable JSON output
@@ -19609,6 +19629,89 @@ Environment:
 Global:
   --json    Machine-readable JSON output`;
 
+// src/selection-input.ts
+import { createHash, randomBytes } from "crypto";
+import { chmod, mkdir as mkdir2, readFile as readFile2, rename, rm as rm2, writeFile as writeFile2 } from "fs/promises";
+import { homedir as homedir2 } from "os";
+import { join as join2 } from "path";
+var CLI_SELECTION_MAX_BYTES = 1e5;
+function isPlainId(id) {
+  return id.length > 0 && id === id.trim();
+}
+function canSelectInline(objectIds) {
+  if (!objectIds.every((id) => isPlainId(id) && !id.includes(","))) return false;
+  const joined = objectIds.join(",");
+  const quotes = joined.split("'").length - 1;
+  return Buffer.byteLength(`--objects=${joined}`, "utf8") + 2 + quotes * 3 <= CLI_SELECTION_MAX_BYTES;
+}
+function canSelectFromFile(objectIds) {
+  return objectIds.every((id) => isPlainId(id) && !/[\r\n]/.test(id));
+}
+function parseObjectIdLines(text) {
+  return text.split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0);
+}
+var processSelectionReader = {
+  readFile: (path) => readFile2(path, "utf8"),
+  stdinIsTerminal: () => process.stdin.isTTY === true,
+  // Reads to end of input, like any `-` filter: a pipe that never closes waits, as `cat -` does.
+  readStdin: async () => {
+    const chunks = [];
+    for await (const chunk of process.stdin) {
+      chunks.push(typeof chunk === "string" ? Buffer.from(chunk) : chunk);
+    }
+    return Buffer.concat(chunks).toString("utf8");
+  }
+};
+async function readSelectionIds(source, reader = processSelectionReader) {
+  let text;
+  try {
+    if (source === "-") {
+      if (reader.stdinIsTerminal()) {
+        return {
+          ok: false,
+          message: "--objects-file - reads ids from stdin, but nothing is piped in."
+        };
+      }
+      text = await reader.readStdin();
+    } else {
+      text = await reader.readFile(source);
+    }
+  } catch (error51) {
+    const reason = error51 instanceof Error ? error51.message : String(error51);
+    return { ok: false, message: `Could not read --objects-file ${source}: ${reason}` };
+  }
+  const objectIds = parseObjectIdLines(text);
+  if (objectIds.length === 0) {
+    return {
+      ok: false,
+      message: `The --objects-file ${source === "-" ? "input" : source} must include at least one object ID.`
+    };
+  }
+  return { ok: true, objectIds };
+}
+function selectionsDir() {
+  return join2(homedir2(), ".captable-ai", "selections");
+}
+async function writeSelectionFile(name, objectIds) {
+  if (!canSelectFromFile(objectIds)) return null;
+  const dir = selectionsDir();
+  const digest = createHash("sha256").update(JSON.stringify(objectIds)).digest("hex").slice(0, 32);
+  const path = join2(dir, `${name.replace(/[^A-Za-z0-9._-]/g, "_")}-${digest}.txt`);
+  const temp = `${path}.${process.pid}.${randomBytes(6).toString("hex")}.tmp`;
+  try {
+    await mkdir2(dir, { recursive: true, mode: 448 });
+    await chmod(dir, 448);
+    await writeFile2(temp, `${objectIds.join("\n")}
+`, { mode: 384, flag: "wx" });
+    await chmod(temp, 384);
+    await rename(temp, path);
+    return path;
+  } catch {
+    await rm2(temp, { force: true }).catch(() => void 0);
+    return null;
+  }
+}
+
 // src/commands/draft-operations.ts
 function parseObjectIdsList(raw) {
   if (raw === void 0) return void 0;
@@ -19617,6 +19720,23 @@ function parseObjectIdsList(raw) {
 function hasObjectIds(raw, objectIds) {
   return raw !== void 0 && (objectIds?.length ?? 0) > 0;
 }
+async function resolveObjectsInput(args, otherSelectorMessage = null, reader = processSelectionReader) {
+  const objectsRaw = getFlagValue(args, "objects");
+  const fileSource = getFlagValue(args, "objects-file");
+  if (objectsRaw !== void 0 && fileSource !== void 0) {
+    return { kind: "invalid", message: "Specify either --objects or --objects-file, not both." };
+  }
+  if (fileSource !== void 0) {
+    if (otherSelectorMessage !== null) return { kind: "invalid", message: otherSelectorMessage };
+    const read = await readSelectionIds(fileSource, reader);
+    return read.ok ? { kind: "ids", objectIds: read.objectIds } : { kind: "invalid", message: read.message };
+  }
+  const objectIds = parseObjectIdsList(objectsRaw);
+  if (objectsRaw !== void 0 && !hasObjectIds(objectsRaw, objectIds)) {
+    return { kind: "invalid", message: "The --objects flag must include at least one object ID." };
+  }
+  return objectIds === void 0 ? { kind: "none" } : { kind: "ids", objectIds };
+}
 function operationPastTense(operation) {
   return operation === "commit" ? "committed" : "reverted";
 }
@@ -19667,7 +19787,7 @@ function canApplyRevertAllFallback(data, operation) {
 function shellQuote(value) {
   return `'${value.replaceAll("'", "'\\''")}'`;
 }
-function printDraftOperationPreview(data, options) {
+async function printDraftOperationPreview(data, options) {
   const applied = operationPastTense(options.operation);
   const objectCount = data.finalIds.length;
   if (objectCount === 0) {
@@ -19702,10 +19822,29 @@ Run \`${options.command} --all\` to revert all pending drafts.
     printLine("\nResolve the reported issues before applying this preview.\n");
     return;
   }
-  const applyCommand = data.applyObjectIds === null ? `${options.command} --all` : `${options.command} --objects=${shellQuote(data.applyObjectIds.join(","))}`;
-  printLine(`
-Run \`${applyCommand}\` to apply this preview.
+  if (data.applyObjectIds === null) {
+    printLine(`
+Run \`${options.command} --all\` to apply this preview.
 `);
+    return;
+  }
+  if (canSelectInline(data.applyObjectIds)) {
+    printLine(
+      `
+Run \`${options.command} --objects=${shellQuote(data.applyObjectIds.join(","))}\` to apply this preview.
+`
+    );
+    return;
+  }
+  const file2 = await writeSelectionFile(`${options.operation}-apply`, data.applyObjectIds);
+  printLine(
+    file2 ? `
+These ${data.applyObjectIds.length} IDs cannot be given inline (too many for one command line, or an ID with a comma). They are in ${file2}.
+Run \`${options.command} --objects-file ${shellQuote(file2)}\` to apply this preview.
+` : `
+These ${data.applyObjectIds.length} IDs cannot be put on one command line or in a file as they are (too many, or an ID with surrounding spaces or a line break). Apply this preview from the Studio timeline or the MCP.
+`
+  );
 }
 
 // src/commands/commit.ts
@@ -19715,8 +19854,8 @@ async function runCommit(args, rawArgv) {
 `);
     process.exit(0);
   }
-  validateFlags(args, { flags: ["objects"], booleans: ["all", "dry-run"] });
-  const USAGE2 = "captable-ai commit --dry-run [--objects id1,id2,...] [--json]\ncaptable-ai commit (--objects id1,id2,... | --all) [--json]";
+  validateFlags(args, { flags: ["objects", "objects-file"], booleans: ["all", "dry-run"] });
+  const USAGE2 = "captable-ai commit --dry-run [--objects id1,id2,... | --objects-file <path|->] [--json]\ncaptable-ai commit (--objects id1,id2,... | --objects-file <path|-> | --all) [--json]";
   if (args.positional.length > 0) {
     exitWithUsage(
       `Unexpected argument: ${args.positional[0]}. This command takes no positional arguments.`,
@@ -19725,14 +19864,14 @@ async function runCommit(args, rawArgv) {
   }
   const dryRun = hasFlag(args, "dry-run");
   const all = hasFlag(args, "all");
-  const objectIdsRaw = getFlagValue(args, "objects");
-  const objectIds = parseObjectIdsList(objectIdsRaw);
-  const hasExplicitObjectIds = hasObjectIds(objectIdsRaw, objectIds);
-  if (objectIdsRaw !== void 0 && !hasExplicitObjectIds) {
-    exitWithUsage("The --objects flag must include at least one object ID.", USAGE2);
-  }
+  const objectsInput = await resolveObjectsInput(
+    args,
+    all ? "Specify either --objects (or --objects-file) or --all, not both." : null
+  );
+  if (objectsInput.kind === "invalid") exitWithUsage(objectsInput.message, USAGE2);
+  const objectIds = objectsInput.kind === "ids" ? objectsInput.objectIds : void 0;
   if (all && objectIds) {
-    exitWithUsage("Specify either --objects or --all, not both.", USAGE2);
+    exitWithUsage("Specify either --objects (or --objects-file) or --all, not both.", USAGE2);
   }
   if (dryRun) {
     const portalId2 = await getActivePortalId();
@@ -19751,7 +19890,7 @@ async function runCommit(args, rawArgv) {
       printJson({ data: data2 });
       return;
     }
-    printDraftOperationPreview(data2, { command: "captable-ai commit", operation: "commit" });
+    await printDraftOperationPreview(data2, { command: "captable-ai commit", operation: "commit" });
     return;
   }
   const selection = resolveDraftOperationSelection(
@@ -20476,12 +20615,12 @@ async function runDocumentsRestartExtraction(args, rawArgv) {
 
 // src/jobs/tracker.ts
 import { randomUUID } from "crypto";
-import { appendFile, mkdir as mkdir2, readFile as readFile2, rename, rm as rm2, writeFile as writeFile2 } from "fs/promises";
-import { homedir as homedir2 } from "os";
-import { join as join2 } from "path";
-var CONFIG_DIR2 = join2(homedir2(), ".captable-ai");
-var JOBS_FILE = join2(CONFIG_DIR2, "jobs.jsonl");
-var LOCK_DIR = join2(CONFIG_DIR2, "jobs.lock");
+import { appendFile, mkdir as mkdir3, readFile as readFile3, rename as rename2, rm as rm3, writeFile as writeFile3 } from "fs/promises";
+import { homedir as homedir3 } from "os";
+import { join as join3 } from "path";
+var CONFIG_DIR2 = join3(homedir3(), ".captable-ai");
+var JOBS_FILE = join3(CONFIG_DIR2, "jobs.jsonl");
+var LOCK_DIR = join3(CONFIG_DIR2, "jobs.lock");
 var VALID_JOB_STATUSES = /* @__PURE__ */ new Set(["submitted", "running", "complete", "failed"]);
 var VALID_JOB_KINDS = /* @__PURE__ */ new Set(["extraction"]);
 function isRecord3(v) {
@@ -20492,7 +20631,7 @@ function isJobEntry(value) {
   return typeof value.id === "string" && typeof value.kind === "string" && VALID_JOB_KINDS.has(value.kind) && typeof value.portalId === "string" && typeof value.submittedAt === "string" && typeof value.status === "string" && VALID_JOB_STATUSES.has(value.status);
 }
 async function ensureDir() {
-  await mkdir2(CONFIG_DIR2, { recursive: true, mode: 448 });
+  await mkdir3(CONFIG_DIR2, { recursive: true, mode: 448 });
 }
 function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
@@ -20509,7 +20648,7 @@ async function withJobsLock(fn) {
   const startedAt = Date.now();
   for (; ; ) {
     try {
-      await mkdir2(LOCK_DIR, { mode: 448 });
+      await mkdir3(LOCK_DIR, { mode: 448 });
       break;
     } catch (err) {
       if (!isErrno(err, "EEXIST")) throw err;
@@ -20522,7 +20661,7 @@ async function withJobsLock(fn) {
   try {
     return await fn();
   } finally {
-    await rm2(LOCK_DIR, { recursive: true, force: true });
+    await rm3(LOCK_DIR, { recursive: true, force: true });
   }
 }
 function generateJobId() {
@@ -20537,7 +20676,7 @@ async function appendJob(entry) {
 async function listJobs(filter) {
   let raw;
   try {
-    raw = await readFile2(JOBS_FILE, "utf8");
+    raw = await readFile3(JOBS_FILE, "utf8");
   } catch (err) {
     if (!isErrno(err, "ENOENT")) throw err;
     return [];
@@ -20598,10 +20737,10 @@ async function pruneJobs(before) {
 async function atomicWriteJobs(content) {
   const tmp = `${JOBS_FILE}.${process.pid}.${Date.now()}.tmp`;
   try {
-    await writeFile2(tmp, content, { mode: 384 });
-    await rename(tmp, JOBS_FILE);
+    await writeFile3(tmp, content, { mode: 384 });
+    await rename2(tmp, JOBS_FILE);
   } catch (err) {
-    await rm2(tmp, { force: true });
+    await rm3(tmp, { force: true });
     throw err;
   }
 }
@@ -20778,12 +20917,12 @@ function flagMissingIds(missingIds) {
 }
 
 // src/commands/documents-upload.ts
-import { createHash } from "crypto";
-import { readFile as readFile3, stat } from "fs/promises";
+import { createHash as createHash2 } from "crypto";
+import { readFile as readFile4, stat } from "fs/promises";
 import { basename } from "path";
 async function hashFile(path) {
-  const data = await readFile3(path);
-  return createHash("sha256").update(data).digest("hex");
+  const data = await readFile4(path);
+  return createHash2("sha256").update(data).digest("hex");
 }
 async function runDocumentsUpload(args, rawArgv) {
   if (rawArgv.includes("--help") || rawArgv.includes("-h")) {
@@ -20839,7 +20978,7 @@ async function runDocumentsUpload(args, rawArgv) {
   }
   for (const { doc, filePath } of toUpload) {
     if (!isJsonMode()) printLine(`  \u2191 Uploading ${doc.name}...`);
-    const fileData = await readFile3(filePath);
+    const fileData = await readFile4(filePath);
     const putRes = await fetch(doc.presignedUrl, {
       method: "PUT",
       headers: { "Content-Type": doc.contentType },
@@ -20890,11 +21029,11 @@ ${successCount}/${results.length} document(s) confirmed.`);
 }
 
 // src/commands/feedback.ts
-import { appendFile as appendFile2, mkdir as mkdir3, readFile as readFile4, rename as rename2, rm as rm3, writeFile as writeFile3 } from "fs/promises";
-import { homedir as homedir3 } from "os";
-import { join as join3 } from "path";
-var CONFIG_DIR3 = join3(homedir3(), ".captable-ai");
-var FEEDBACK_FILE = join3(CONFIG_DIR3, "feedback.jsonl");
+import { appendFile as appendFile2, mkdir as mkdir4, readFile as readFile5, rename as rename3, rm as rm4, writeFile as writeFile4 } from "fs/promises";
+import { homedir as homedir4 } from "os";
+import { join as join4 } from "path";
+var CONFIG_DIR3 = join4(homedir4(), ".captable-ai");
+var FEEDBACK_FILE = join4(CONFIG_DIR3, "feedback.jsonl");
 function isErrno2(err, code) {
   return typeof err === "object" && err !== null && "code" in err && err.code === code;
 }
@@ -20963,7 +21102,7 @@ async function runFeedback(args, rawArgv) {
   if (!text.trim()) {
     exitWithUsage("Feedback text cannot be empty.", 'Usage: captable-ai feedback "<message>"');
   }
-  await mkdir3(CONFIG_DIR3, { recursive: true, mode: 448 });
+  await mkdir4(CONFIG_DIR3, { recursive: true, mode: 448 });
   const entry = { ts: (/* @__PURE__ */ new Date()).toISOString(), text: text.trim(), sent: false };
   await appendFile2(FEEDBACK_FILE, `${JSON.stringify(entry)}
 `, { mode: 384 });
@@ -21046,14 +21185,14 @@ async function runFeedbackSend() {
     );
   }
   const updated = entries.map((e) => e.sent ? e : { ...e, sent: true });
-  await mkdir3(CONFIG_DIR3, { recursive: true, mode: 448 });
+  await mkdir4(CONFIG_DIR3, { recursive: true, mode: 448 });
   const tmp = `${FEEDBACK_FILE}.${process.pid}.${Date.now()}.tmp`;
   try {
-    await writeFile3(tmp, updated.map((e) => `${JSON.stringify(e)}
+    await writeFile4(tmp, updated.map((e) => `${JSON.stringify(e)}
 `).join(""), { mode: 384 });
-    await rename2(tmp, FEEDBACK_FILE);
+    await rename3(tmp, FEEDBACK_FILE);
   } catch (err) {
-    await rm3(tmp, { force: true });
+    await rm4(tmp, { force: true });
     throw err;
   }
   if (isJsonMode()) {
@@ -21065,7 +21204,7 @@ async function runFeedbackSend() {
 async function readEntries() {
   let raw;
   try {
-    raw = await readFile4(FEEDBACK_FILE, "utf8");
+    raw = await readFile5(FEEDBACK_FILE, "utf8");
   } catch (err) {
     if (!isErrno2(err, "ENOENT")) {
       exitWithError(
@@ -21283,7 +21422,7 @@ async function fetchTrackedDocuments(portalId, assetIds) {
 
 // src/commands/login.ts
 import { execFile } from "child_process";
-import { randomBytes, timingSafeEqual } from "crypto";
+import { randomBytes as randomBytes2, timingSafeEqual } from "crypto";
 import { createServer } from "http";
 import { platform } from "os";
 import { createInterface } from "readline";
@@ -21396,7 +21535,7 @@ function tryParseLoginPaste(line, expectedState) {
 async function runLogin(args) {
   validateFlags(args, { flags: [], booleans: [] });
   const jsonMode2 = isJsonMode();
-  const state = randomBytes(16).toString("hex");
+  const state = randomBytes2(16).toString("hex");
   let settled = false;
   let timeoutId;
   let rl;
@@ -22407,16 +22546,19 @@ async function runObjectsRevert(args, rawArgv) {
 `);
     process.exit(0);
   }
-  validateFlags(args, { flags: ["objects"], booleans: ["all", "dry-run", "yes"] });
+  validateFlags(args, { flags: ["objects", "objects-file"], booleans: ["all", "dry-run", "yes"] });
   const objectIdRaw = args.positional[0];
   const objectId = objectIdRaw?.trim();
   const all = hasFlag(args, "all");
   const dryRun = hasFlag(args, "dry-run");
   const yes = hasFlag(args, "yes");
-  const objectIdsRaw = getFlagValue(args, "objects");
-  const objectIdsFromFlag = parseObjectIdsList(objectIdsRaw);
-  const hasExplicitObjectIds = hasObjectIds(objectIdsRaw, objectIdsFromFlag);
-  const USAGE2 = "captable-ai objects revert --dry-run [<object-id> | --objects id1,id2,... | --all] [--json]\ncaptable-ai objects revert (<object-id> | --objects id1,id2,... | --all) [--yes] [--json]";
+  const USAGE2 = "captable-ai objects revert --dry-run [<object-id> | --objects id1,id2,... | --objects-file <path|-> | --all] [--json]\ncaptable-ai objects revert (<object-id> | --objects id1,id2,... | --objects-file <path|-> | --all) [--yes] [--json]";
+  const objectsInput = await resolveObjectsInput(
+    args,
+    objectIdRaw !== void 0 || all ? "Specify only one of an object ID, --objects (or --objects-file), or --all." : null
+  );
+  if (objectsInput.kind === "invalid") exitWithUsage(objectsInput.message, USAGE2);
+  const objectIdsFromFlag = objectsInput.kind === "ids" ? objectsInput.objectIds : void 0;
   if (args.positional.length > 1) {
     exitWithUsage(
       `Too many arguments: expected one object ID, got ${args.positional.length}.`,
@@ -22426,12 +22568,12 @@ async function runObjectsRevert(args, rawArgv) {
   if (objectIdRaw !== void 0 && !objectId) {
     exitWithUsage("Object ID must be a non-empty string.", USAGE2);
   }
-  if (objectIdsRaw !== void 0 && !hasExplicitObjectIds) {
-    exitWithUsage("The --objects flag must include at least one object ID.", USAGE2);
-  }
   const selectionSources = [Boolean(objectId), Boolean(objectIdsFromFlag), all].filter(Boolean);
   if (selectionSources.length > 1) {
-    exitWithUsage("Specify only one of an object ID, --objects, or --all.", USAGE2);
+    exitWithUsage(
+      "Specify only one of an object ID, --objects (or --objects-file), or --all.",
+      USAGE2
+    );
   }
   const objectIds = objectId ? [objectId] : objectIdsFromFlag;
   if (dryRun) {
@@ -22450,7 +22592,7 @@ async function runObjectsRevert(args, rawArgv) {
       printJson({ data: res2.data });
       return;
     }
-    printDraftOperationPreview(res2.data, {
+    await printDraftOperationPreview(res2.data, {
       command: "captable-ai objects revert",
       operation: "revert"
     });
@@ -23103,13 +23245,14 @@ async function runImportStart(args) {
 function scopeFlag(ids) {
   return ids && ids.length > 0 ? ` --s3-asset-ids ${ids.join(",")}` : "";
 }
-var CLI_SELECTION_MAX_BYTES = 1e5;
-function importStatusCommand(action, sessionId) {
-  const tooManyToSelect = (action.id === "preview_commit" || action.id === "confirm_commit") && action.objectIds !== void 0 && Buffer.byteLength(`--objects=${action.objectIds.join(",")}`, "utf8") > CLI_SELECTION_MAX_BYTES;
-  if (tooManyToSelect) {
+function selectionTooLong(action) {
+  return (action.id === "preview_commit" || action.id === "confirm_commit") && action.objectIds !== void 0 && !canSelectInline(action.objectIds);
+}
+function importStatusCommand(action, sessionId, selectionFile) {
+  if (selectionTooLong(action) && selectionFile === null) {
     return {
       id: action.id,
-      label: `This import has ${action.objectIds?.length ?? 0} drafts, too many to select on one command line. Commit them from the Studio timeline, or with the MCP. Not --all: the portal also has pending drafts from other sources.`,
+      label: `This import has ${action.objectIds?.length ?? 0} drafts, too many to select on one command line, and they could not be written to a file. Commit them from the Studio timeline, or with the MCP. Not --all: the portal also has pending drafts from other sources.`,
       required: action.required
     };
   }
@@ -23139,7 +23282,8 @@ function importStatusCommand(action, sessionId) {
         return `captable-ai objects list --status draft --ids=${shellQuote(reviewable.join(","))}`;
       }
       case "preview_commit":
-        return action.objectIds ? `captable-ai commit --dry-run --objects=${shellQuote(action.objectIds.join(","))}` : "captable-ai commit --dry-run";
+        if (!action.objectIds) return "captable-ai commit --dry-run";
+        return selectionTooLong(action) && selectionFile !== null ? `captable-ai commit --dry-run --objects-file ${shellQuote(selectionFile)}` : `captable-ai commit --dry-run --objects=${shellQuote(action.objectIds.join(","))}`;
       case "confirm_commit":
         return action.objectIds ? "captable-ai commit --objects <final IDs from the dry run>" : "captable-ai commit --all";
       default: {
@@ -23206,7 +23350,11 @@ async function runImportStatus(args) {
     `/import-sessions/${encodeURIComponent(sessionId)}/status`
   );
   const portalDocuments = response.data?.processing?.documents ?? [];
-  const documents = documentsForImportSession(portalDocuments, response.data?.session?.createdAt);
+  const documents = documentsForImportSession(
+    portalDocuments,
+    response.data?.session?.createdAt,
+    sessionId
+  );
   const documentIds = documents.flatMap(
     (document) => typeof document.s3AssetId === "string" ? [document.s3AssetId] : []
   );
@@ -23233,7 +23381,11 @@ async function runImportStatus(args) {
       response.data.session = { ...response.data.session, ...completed.data.session };
     }
   }
-  const nextActions = plan.actions.map((action) => importStatusCommand(action, sessionId));
+  const longSelection = plan.actions.find(selectionTooLong)?.objectIds;
+  const selectionFile = longSelection ? await writeSelectionFile(`import-${sessionId}`, longSelection) : null;
+  const nextActions = plan.actions.map(
+    (action) => importStatusCommand(action, sessionId, selectionFile)
+  );
   const suggestMonitoring = shouldSuggestBackgroundMonitoring(plan.phase);
   const data = {
     ...response.data,
@@ -23457,11 +23609,11 @@ function formatNumber(n) {
 }
 
 // src/profiles.ts
-import { mkdir as mkdir4, readFile as readFile5, rename as rename3, rm as rm4, writeFile as writeFile4 } from "fs/promises";
-import { homedir as homedir4 } from "os";
-import { join as join4 } from "path";
-var CONFIG_DIR4 = join4(homedir4(), ".captable-ai");
-var PROFILES_FILE = join4(CONFIG_DIR4, "profiles.json");
+import { mkdir as mkdir5, readFile as readFile6, rename as rename4, rm as rm5, writeFile as writeFile5 } from "fs/promises";
+import { homedir as homedir5 } from "os";
+import { join as join5 } from "path";
+var CONFIG_DIR4 = join5(homedir5(), ".captable-ai");
+var PROFILES_FILE = join5(CONFIG_DIR4, "profiles.json");
 function isRecord9(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -23489,7 +23641,7 @@ function parseProfiles(raw) {
 }
 async function readProfiles() {
   try {
-    const raw = await readFile5(PROFILES_FILE, "utf8");
+    const raw = await readFile6(PROFILES_FILE, "utf8");
     return parseProfiles(raw);
   } catch (err) {
     if (isErrno3(err, "ENOENT")) return { profiles: {}, default: null };
@@ -23503,13 +23655,13 @@ async function readProfiles() {
 }
 async function writeProfiles(data) {
   try {
-    await mkdir4(CONFIG_DIR4, { recursive: true, mode: 448 });
+    await mkdir5(CONFIG_DIR4, { recursive: true, mode: 448 });
     const tmp = `${PROFILES_FILE}.${process.pid}.${Date.now()}.tmp`;
     try {
-      await writeFile4(tmp, JSON.stringify(data, null, 2), { mode: 384 });
-      await rename3(tmp, PROFILES_FILE);
+      await writeFile5(tmp, JSON.stringify(data, null, 2), { mode: 384 });
+      await rename4(tmp, PROFILES_FILE);
     } catch (err) {
-      await rm4(tmp, { force: true });
+      await rm5(tmp, { force: true });
       throw err;
     }
   } catch (err) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fairmint/captable-ai",
-  "version": "0.1.35",
+  "version": "0.1.37",
   "description": "Agent-native CLI for Captable AI — manage companies, upload documents, run OCF extraction, and commit cap tables from the terminal.",
   "keywords": [
     "captable",