@fairmint/captable-ai 0.1.33 → 0.1.35

package/dist/index.js

@@ -15355,10 +15355,82 @@ function planImportStatus({ documents, sessionState, scopeUnknown = false }) {
     }
   }
 }
-function applyDraftCount(plan, draftCount) {
-  if (plan.phase !== "complete" || draftCount !== 0)
+var IMPORT_REVIEW_MAX_IDS = 50;
+function reviewIsCut(action) {
+  return action.reviewObjectIds !== void 0 && action.s3AssetIds?.length !== 1 && action.reviewObjectIds.length > IMPORT_REVIEW_MAX_IDS;
+}
+function isFileRecordRow(draft) {
+  return draft.type === "DOCUMENT" || draft.subtype === "DOCUMENT";
+}
+function partitionImportDrafts(drafts, documentIds) {
+  if (documentIds.length === 0)
+    return null;
+  const documents = new Set(documentIds.map((id) => id.toLowerCase()));
+  const importDraftIds = [];
+  const importReviewableIds = [];
+  const portalIssuerDraftIds = [];
+  let otherDrafts = false;
+  for (const draft of drafts) {
+    if (typeof draft.id !== "string" || draft.id.length === 0)
+      return null;
+    if (!("documentId" in draft))
+      return null;
+    const ours = typeof draft.documentId === "string" && documents.has(draft.documentId.toLowerCase());
+    const selectable = !draft.id.includes(",") && draft.id === draft.id.trim();
+    if (!ours) {
+      if (draft.type === "ISSUER" && draft.documentId === null) {
+        if (!selectable)
+          return null;
+        portalIssuerDraftIds.push(draft.id);
+      } else {
+        otherDrafts = true;
+      }
+      continue;
+    }
+    if (!selectable)
+      return null;
+    importDraftIds.push(draft.id);
+    if (!isFileRecordRow(draft))
+      importReviewableIds.push(draft.id);
+  }
+  return { importDraftIds, importReviewableIds, portalIssuerDraftIds, otherDrafts };
+}
+function applyImportDrafts(plan, scope, documentIds) {
+  if (plan.phase !== "complete" || scope === null)
+    return plan;
+  if (scope.importReviewableIds.length === 0) {
+    return {
+      ...plan,
+      state: "complete",
+      actions: [],
+      ...scope.otherDrafts ? { unrelatedDrafts: true } : {}
+    };
+  }
+  if (!scope.otherDrafts)
     return plan;
-  return { ...plan, state: "complete", actions: [] };
+  const selection = [...scope.importDraftIds, ...scope.portalIssuerDraftIds];
+  const scoped = (action) => {
+    const base = { ...action, objectIds: selection };
+    switch (action.id) {
+      case "review_drafts":
+        return {
+          ...base,
+          label: "Review the drafts from this import's documents",
+          s3AssetIds: [...documentIds],
+          reviewObjectIds: scope.importReviewableIds
+        };
+      case "preview_commit":
+        return { ...base, label: "Preview committing this import's drafts" };
+      case "confirm_commit":
+        return {
+          ...base,
+          label: "Commit this import's drafts with the preview's final IDs as objectIds. Not allDrafts: the portal also has pending drafts from other sources"
+        };
+      default:
+        return action;
+    }
+  };
+  return { ...plan, actions: plan.actions.map(scoped) };
 }
 var EXTRACTION_NOT_READY_REASONS = [
   "pending_upload",
@@ -15730,7 +15802,13 @@ var draftOperationDependencyIssueSchema = external_exports.object({
   expectedType: external_exports.string().describe("Expected OCF object category for the reference.")
 });
 var draftOperationPlanIssueSchema = external_exports.object({
-  code: external_exports.enum(["NO_DRAFTS", "REVERT_LIMIT_EXCEEDED", "ISSUER_REQUIRED", "ISSUER_INCOMPLETE"]).describe("Plan-level validation code."),
+  code: external_exports.enum([
+    "NO_DRAFTS",
+    "REVERT_LIMIT_EXCEEDED",
+    "ISSUER_REQUIRED",
+    "ISSUER_INCOMPLETE",
+    "DOCUMENT_INTEGRITY_FAILED"
+  ]).describe("Plan-level validation code."),
   message: external_exports.string().describe("Human-readable plan validation message.")
 });
 var draftOperationPreviewInputSchema = external_exports.object({
@@ -23025,7 +23103,16 @@ 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) {
+    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.`,
+      required: action.required
+    };
+  }
   const command = (() => {
     switch (action.id) {
       case "upload_documents":
@@ -23042,12 +23129,19 @@ function importStatusCommand(action, sessionId) {
         return "captable-ai documents list";
       case "review_failures":
         return action.statusFilter ? `captable-ai documents list --status ${action.statusFilter}` : "captable-ai documents list";
-      case "review_drafts":
-        return "captable-ai objects list --status draft --all";
+      case "review_drafts": {
+        if (!action.objectIds) return "captable-ai objects list --status draft --all";
+        const [onlyDocument, ...moreDocuments] = action.s3AssetIds ?? [];
+        if (onlyDocument !== void 0 && moreDocuments.length === 0) {
+          return `captable-ai objects list --status draft --document ${shellQuote(onlyDocument)} --all`;
+        }
+        const reviewable = (action.reviewObjectIds ?? []).slice(0, IMPORT_REVIEW_MAX_IDS);
+        return `captable-ai objects list --status draft --ids=${shellQuote(reviewable.join(","))}`;
+      }
       case "preview_commit":
-        return "captable-ai commit --dry-run";
+        return action.objectIds ? `captable-ai commit --dry-run --objects=${shellQuote(action.objectIds.join(","))}` : "captable-ai commit --dry-run";
       case "confirm_commit":
-        return "captable-ai commit --all";
+        return action.objectIds ? "captable-ai commit --objects <final IDs from the dry run>" : "captable-ai commit --all";
       default: {
         const unhandled = action.id;
         throw new Error(`Unhandled import status action: ${String(unhandled)}`);
@@ -23057,35 +23151,40 @@ function importStatusCommand(action, sessionId) {
   const id = action.id === "upload_documents" ? "upload_cli" : action.id;
   return {
     id,
-    label: action.label,
+    label: action.id === "review_drafts" && reviewIsCut(action) ? `${action.label} (first ${IMPORT_REVIEW_MAX_IDS} of ${action.reviewObjectIds?.length ?? 0})` : action.label,
     required: action.required,
     command,
     ...action.id === "review_failures" && action.s3AssetIds && { s3AssetIds: action.s3AssetIds }
   };
 }
-var DRAFT_COUNT_MAX_PAGES = 100;
-async function readDraftCount(portalId) {
+var DRAFT_SCOPE_MAX_PAGES = 100;
+async function readImportDraftScope(portalId, documentIds) {
   if (!portalId) return null;
   try {
-    let count = 0;
+    const drafts = [];
     let cursor;
-    for (let page = 0; page < DRAFT_COUNT_MAX_PAGES; page += 1) {
+    for (let page = 0; page < DRAFT_SCOPE_MAX_PAGES; page += 1) {
       const res = await apiRequest(
         `/${encodeURIComponent(portalId)}/objects`,
         {
-          query: { status: "draft", ...cursor ? { cursor } : {} },
+          query: { status: "draft", limit: 250, ...cursor ? { cursor } : {} },
           // Optional read: throw (caught below) instead of exiting the process on a failure.
           softFail: true
         }
       );
       const objects = res.data?.objects;
       if (!Array.isArray(objects)) return null;
-      count += objects.filter(
-        (obj) => obj.type !== "DOCUMENT" && obj.subtype !== "DOCUMENT"
-      ).length;
-      if (count > 0) return count;
+      for (const obj of objects) {
+        if (typeof obj !== "object" || obj === null || Array.isArray(obj)) return null;
+        drafts.push({
+          id: Reflect.get(obj, "id"),
+          type: Reflect.get(obj, "type"),
+          subtype: Reflect.get(obj, "subtype"),
+          ..."documentId" in obj ? { documentId: Reflect.get(obj, "documentId") } : {}
+        });
+      }
+      if (!res.meta?.hasMore) return partitionImportDrafts(drafts, documentIds);
       const next = res.meta?.cursor;
-      if (!res.meta?.hasMore) return count;
       if (!next || next === cursor) return null;
       cursor = next;
     }
@@ -23108,12 +23207,19 @@ async function runImportStatus(args) {
   );
   const portalDocuments = response.data?.processing?.documents ?? [];
   const documents = documentsForImportSession(portalDocuments, response.data?.session?.createdAt);
+  const documentIds = documents.flatMap(
+    (document) => typeof document.s3AssetId === "string" ? [document.s3AssetId] : []
+  );
   const documentPlan = planImportStatus({
     documents,
     sessionState: response.data?.session?.state,
     scopeUnknown: importSessionScopeUnknown(portalDocuments)
   });
-  const plan = documentPlan.phase === "complete" ? applyDraftCount(documentPlan, await readDraftCount(response.data?.session?.portalId)) : documentPlan;
+  const plan = documentPlan.phase === "complete" ? applyImportDrafts(
+    documentPlan,
+    await readImportDraftScope(response.data?.session?.portalId, documentIds),
+    documentIds
+  ) : documentPlan;
   const { summary } = plan;
   if (plan.shouldComplete) {
     const completed = await apiRequest(
@@ -23135,6 +23241,7 @@ async function runImportStatus(args) {
     phase: plan.phase,
     summary,
     nextActions,
+    ...plan.unrelatedDrafts && { unrelatedDrafts: true },
     ...suggestMonitoring && { monitoringHint: BACKGROUND_MONITORING_SUGGESTION }
   };
   if (isJsonMode()) {
@@ -23159,12 +23266,28 @@ async function runImportStatus(args) {
       "  Some uploads never finished. Re-upload them; checking status again will not complete them."
     );
   }
+  if (plan.unrelatedDrafts) {
+    printLine(
+      "  The portal has other pending drafts that this import did not produce; leave them alone unless asked."
+    );
+  }
+  const scopedCommit = plan.actions.some(
+    (planned) => planned.id === "confirm_commit" && planned.objectIds !== void 0
+  );
   for (const action of nextActions) {
+    if (action.command === void 0) {
+      printLine(`  Note: ${action.label}`);
+      continue;
+    }
     printLine(`  Next: ${action.command}`);
     if (action.id === "resolve_extraction_scope") printLine(`    Note: ${action.label}`);
     if (action.id === "check_status" && plan.phase === "empty") {
       printLine(`    Note: ${action.label}`);
     }
+    if (action.id === "confirm_commit" && scopedCommit) printLine(`    Note: ${action.label}`);
+    if (action.id === "review_drafts" && action.label.includes("(first ")) {
+      printLine(`    Note: ${action.label}`);
+    }
     if (action.id === "review_failures" && action.s3AssetIds) {
       printLine(`    Documents: ${action.s3AssetIds.join(", ")}`);
     }

package/package.json

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