@fairmint/captable-ai 0.1.36 → 0.1.38

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.")
@@ -20918,6 +20924,20 @@ async function hashFile(path) {
   const data = await readFile4(path);
   return createHash2("sha256").update(data).digest("hex");
 }
+async function openImportSession(portalId) {
+  try {
+    const res = await apiRequest("/import-sessions", {
+      method: "POST",
+      body: { portalId },
+      // Optional: a failure must throw to the catch below, not exit the process.
+      softFail: true
+    });
+    const id = res.data?.session?.id;
+    return typeof id === "string" ? id : null;
+  } catch {
+    return null;
+  }
+}
 async function runDocumentsUpload(args, rawArgv) {
   if (rawArgv.includes("--help") || rawArgv.includes("-h")) {
     process.stdout.write(
@@ -20947,11 +20967,15 @@ async function runDocumentsUpload(args, rawArgv) {
     });
   }
   if (!isJsonMode()) printLine(`Preparing ${files.length} file(s)...`);
+  const importSessionId = await openImportSession(portalId);
   const prepareRes = await apiRequest(
     `/${portalId}/documents/prepare`,
     {
       method: "POST",
-      body: { files: files.map(({ path: _, ...f }) => f) }
+      body: {
+        files: files.map(({ path: _, ...f }) => f),
+        ...importSessionId === null ? {} : { importSessionId }
+      }
     }
   );
   const documents = prepareRes.data?.documents ?? [];
@@ -23344,7 +23368,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] : []
   );

package/package.json

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