@fairmint/captable-ai 0.1.11 → 0.1.13

package/dist/index.js

@@ -16483,6 +16483,204 @@ function assembleEngineOcfDump(objects) {
   };
 }
 
+// ../captable-ai-core/dist/onboarding.js
+var ONBOARDING_COMPANY_TYPES = {
+  US_C_CORPORATION: "us_c_corporation",
+  US_LLC: "us_llc",
+  FOREIGN_ENTITY: "foreign_entity",
+  NOT_INCORPORATED: "not_incorporated"
+};
+var ONBOARDING_COMPANY_TYPE_VALUES = Object.values(ONBOARDING_COMPANY_TYPES);
+var ONBOARDING_COMPANY_TYPE_TO_PERSISTED_VALUE = {
+  [ONBOARDING_COMPANY_TYPES.US_C_CORPORATION]: "Corporation",
+  [ONBOARDING_COMPANY_TYPES.US_LLC]: "Limited liability company (LLC)",
+  [ONBOARDING_COMPANY_TYPES.FOREIGN_ENTITY]: "Foreign company",
+  [ONBOARDING_COMPANY_TYPES.NOT_INCORPORATED]: "Not-incorporated yet"
+};
+var ONBOARDING_ROLES = [
+  "CEO",
+  "COO",
+  "CMO",
+  "CFO",
+  "CTO",
+  "CRO",
+  "Director",
+  "Founder",
+  "co-founder",
+  "co-CEO"
+];
+var ONBOARDING_OTHER_ROLE = "other";
+var ONBOARDING_CAP_TABLE_SOURCES = {
+  NONE: "none",
+  SPREADSHEET: "spreadsheet",
+  CARTA: "carta",
+  PULLEY: "pulley",
+  ANGELLIST: "angellist",
+  OTHER: "other"
+};
+var ONBOARDING_CAP_TABLE_SOURCE_VALUES = Object.values(ONBOARDING_CAP_TABLE_SOURCES);
+var ONBOARDING_STAKEHOLDER_COUNT_BUCKETS = [
+  "1_10",
+  "11_25",
+  "26_50",
+  "50_100",
+  "100_plus"
+];
+var ONBOARDING_WORKSPACE_STATES = {
+  NEEDS_WORKSPACE: "needs_workspace",
+  WORKSPACE_READY: "workspace_ready"
+};
+var ONBOARDING_STATES = {
+  NEEDS_COMPANY_SETUP: "needs_company_setup",
+  NEEDS_COMPANY_SELECTION: "needs_company_selection",
+  READY_TO_IMPORT: "ready_to_import",
+  PROCESSING: "processing",
+  NEEDS_REVIEW: "needs_review",
+  BLOCKED: "blocked",
+  READY_TO_COMMIT: "ready_to_commit"
+};
+var ONBOARDING_STATE_VALUES = Object.values(ONBOARDING_STATES);
+var onboardingNextActionSchema = external_exports.object({
+  id: external_exports.string().trim().min(1),
+  label: external_exports.string().trim().min(1),
+  required: external_exports.boolean(),
+  tool: external_exports.string().trim().min(1).optional(),
+  command: external_exports.string().trim().min(1).optional(),
+  href: external_exports.string().url().optional(),
+  arguments: external_exports.record(external_exports.string(), external_exports.unknown()).optional()
+});
+var onboardingStateBaseSchema = external_exports.object({
+  nextActions: external_exports.array(onboardingNextActionSchema)
+});
+var onboardingStateSchema = external_exports.discriminatedUnion("state", [
+  onboardingStateBaseSchema.extend({ state: external_exports.literal(ONBOARDING_STATES.NEEDS_COMPANY_SETUP) }),
+  onboardingStateBaseSchema.extend({
+    state: external_exports.literal(ONBOARDING_STATES.NEEDS_COMPANY_SELECTION),
+    companies: external_exports.array(external_exports.object({ id: external_exports.string().uuid(), name: external_exports.string().nullable() })).min(1)
+  }),
+  onboardingStateBaseSchema.extend({
+    state: external_exports.literal(ONBOARDING_STATES.READY_TO_IMPORT),
+    portalId: external_exports.string().uuid()
+  }),
+  onboardingStateBaseSchema.extend({
+    state: external_exports.literal(ONBOARDING_STATES.PROCESSING),
+    portalId: external_exports.string().uuid(),
+    importSessionId: external_exports.string().uuid()
+  }),
+  onboardingStateBaseSchema.extend({
+    state: external_exports.literal(ONBOARDING_STATES.NEEDS_REVIEW),
+    portalId: external_exports.string().uuid(),
+    importSessionId: external_exports.string().uuid(),
+    blockerCount: external_exports.number().int().nonnegative()
+  }),
+  onboardingStateBaseSchema.extend({
+    state: external_exports.literal(ONBOARDING_STATES.BLOCKED),
+    portalId: external_exports.string().uuid().optional(),
+    importSessionId: external_exports.string().uuid().optional(),
+    code: external_exports.string().trim().min(1),
+    message: external_exports.string().trim().min(1)
+  }),
+  onboardingStateBaseSchema.extend({
+    state: external_exports.literal(ONBOARDING_STATES.READY_TO_COMMIT),
+    portalId: external_exports.string().uuid(),
+    importSessionId: external_exports.string().uuid()
+  })
+]);
+var ONBOARDING_SESSION_ACTIONS = {
+  NONE: "none",
+  REFRESH: "refresh",
+  REEXCHANGE: "reexchange"
+};
+var shortTextSchema = (max) => external_exports.string().trim().min(1).max(max);
+var hasControlCharacter = (value) => Array.from(value).some((character) => {
+  const codePoint = character.codePointAt(0);
+  return codePoint !== void 0 && (codePoint <= 31 || codePoint >= 127 && codePoint <= 159);
+});
+var legalNameSchema = shortTextSchema(255).refine((value) => !hasControlCharacter(value), "Legal name cannot contain control characters").describe("Confirmed legal name of the company.");
+var countryCodeSchema = external_exports.string().trim().transform((value) => value.toUpperCase()).pipe(external_exports.string().regex(/^[A-Z]{2}$/, "Must be an ISO 3166-1 alpha-2 country code")).describe("ISO 3166-1 alpha-2 country of incorporation. Required for foreign entities.");
+var roleSchema = external_exports.discriminatedUnion("role", [
+  external_exports.object({
+    role: external_exports.enum(ONBOARDING_ROLES).describe("Founder's role at the company."),
+    otherRole: external_exports.never().optional().describe("Omit unless role is other.")
+  }),
+  external_exports.object({
+    role: external_exports.literal(ONBOARDING_OTHER_ROLE).describe("Founder's role at the company."),
+    otherRole: shortTextSchema(100).describe("Free-text role when role is other.")
+  })
+]);
+var capTableSourceSchema = external_exports.discriminatedUnion("capTableSource", [
+  external_exports.object({
+    capTableSource: external_exports.enum([
+      ONBOARDING_CAP_TABLE_SOURCES.NONE,
+      ONBOARDING_CAP_TABLE_SOURCES.SPREADSHEET,
+      ONBOARDING_CAP_TABLE_SOURCES.CARTA,
+      ONBOARDING_CAP_TABLE_SOURCES.PULLEY,
+      ONBOARDING_CAP_TABLE_SOURCES.ANGELLIST
+    ]).describe("Where the current cap table is maintained."),
+    otherCapTableSource: external_exports.never().optional().describe("Omit unless capTableSource is other.")
+  }),
+  external_exports.object({
+    capTableSource: external_exports.literal(ONBOARDING_CAP_TABLE_SOURCES.OTHER).describe("Where the current cap table is maintained."),
+    otherCapTableSource: shortTextSchema(100).describe("Free-text cap table tool when capTableSource is other.")
+  })
+]);
+var commonSetupSchema = external_exports.object({
+  legalName: legalNameSchema,
+  stakeholderCount: external_exports.enum(ONBOARDING_STAKEHOLDER_COUNT_BUCKETS).describe("Approximate number of stakeholders on the cap table."),
+  termsAccepted: external_exports.literal(true).describe("Whether the user accepted Fairmint's Terms of Service; must be true.")
+}).and(roleSchema).and(capTableSourceSchema);
+var companySchema = external_exports.discriminatedUnion("companyType", [
+  external_exports.object({
+    companyType: external_exports.enum([ONBOARDING_COMPANY_TYPES.US_C_CORPORATION, ONBOARDING_COMPANY_TYPES.US_LLC]).describe("Confirmed company type."),
+    country: external_exports.never().optional().describe("Omit for US companies.")
+  }),
+  external_exports.object({
+    companyType: external_exports.literal(ONBOARDING_COMPANY_TYPES.FOREIGN_ENTITY).describe("Confirmed company type."),
+    country: countryCodeSchema.refine((country) => country !== "US", {
+      message: "Foreign entities must use a non-US country"
+    }).describe("ISO 3166-1 alpha-2 country of incorporation. Required for foreign entities.")
+  }),
+  external_exports.object({
+    companyType: external_exports.literal(ONBOARDING_COMPANY_TYPES.NOT_INCORPORATED).describe("Confirmed company type."),
+    country: external_exports.never().optional().describe("Omit until the company is incorporated.")
+  })
+]);
+var onboardingWorkspaceSetupInputSchema = commonSetupSchema.and(companySchema);
+var onboardingWorkspaceSetupResultSchema = external_exports.object({
+  portalId: external_exports.uuid().describe("ID of the user's first production workspace."),
+  state: external_exports.literal(ONBOARDING_WORKSPACE_STATES.WORKSPACE_READY).describe("Workspace is created or reused and ready for import."),
+  created: external_exports.boolean().describe("True when this request inserted a new portal."),
+  commitReady: external_exports.boolean().describe("True when the draft issuer has formation date and country of formation."),
+  commitBlockers: external_exports.array(external_exports.enum(["formation_date", "country_of_formation"])).describe("Issuer fields that still block a live commit."),
+  session: external_exports.object({
+    action: external_exports.enum([
+      ONBOARDING_SESSION_ACTIONS.NONE,
+      ONBOARDING_SESSION_ACTIONS.REFRESH,
+      ONBOARDING_SESSION_ACTIONS.REEXCHANGE
+    ]).describe("How the client should obtain a full-access token."),
+    accessTokenCanAccessWorkspace: external_exports.boolean().describe("False until the client refreshes or re-exchanges the onboarding token."),
+    refreshPreservesOnboardingScope: external_exports.boolean().describe("True when refresh still mints onboarding-only scopes.")
+  }).describe("Client session upgrade instructions after workspace setup.")
+});
+var ONBOARDING_COMPANY_TYPE_TO_ISSUER = {
+  [ONBOARDING_COMPANY_TYPES.US_C_CORPORATION]: {
+    countryOfFormation: "US",
+    incorporated: true
+  },
+  [ONBOARDING_COMPANY_TYPES.US_LLC]: {
+    countryOfFormation: "US",
+    incorporated: true
+  },
+  [ONBOARDING_COMPANY_TYPES.FOREIGN_ENTITY]: {
+    countryOfFormation: null,
+    incorporated: true
+  },
+  [ONBOARDING_COMPANY_TYPES.NOT_INCORPORATED]: {
+    countryOfFormation: null,
+    incorporated: false
+  }
+};
+
 // ../captable-ai-core/dist/scopes.js
 var CAPTABLE_AI_SCOPES = {
   READ: "read",
@@ -16490,12 +16688,14 @@ var CAPTABLE_AI_SCOPES = {
   WRITE_OBJECTS: "write:objects",
   WRITE_COMMIT: "write:commit",
   WRITE_DOCUMENTS: "write:documents",
-  ADMIN_PORTAL: "admin:portal"
+  ADMIN_PORTAL: "admin:portal",
+  ONBOARDING_WORKSPACE: "onboarding:workspace"
 };
 var DEFAULT_SCOPES = [
   CAPTABLE_AI_SCOPES.READ,
   CAPTABLE_AI_SCOPES.WRITE
 ];
+var ONBOARDING_SCOPES = [CAPTABLE_AI_SCOPES.ONBOARDING_WORKSPACE];
 
 // ../captable-ai-core/dist/securityholder-file.js
 var securityholderFileInputSchema = external_exports.object({
@@ -16591,7 +16791,10 @@ var warrantResolutionItemSchema = external_exports.object({
     amount: external_exports.string(),
     currency: external_exports.string()
   }).nullable(),
-  relatedSecurityId: external_exports.string().nullable()
+  relatedSecurityId: external_exports.string().nullable(),
+  // Present only on warrants whose deferred percentage exercise could not be replayed. They
+  // are listed but excluded from the counts below, since they contribute no diluted shares.
+  replayFailed: external_exports.boolean().optional()
 });
 var warrantsSnapshotSchema = external_exports.object({
   numberOfSecurities: external_exports.number().int().nonnegative(),

package/package.json

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