@thecorporation/corp-tools 26.3.13 → 26.3.17

package/dist/index.d.ts

@@ -112,6 +112,7 @@ type components = {
          */
         AccountType: "asset" | "liability" | "equity" | "revenue" | "expense";
         AddFounderRequest: {
+            address?: null | components["schemas"]["Address"];
             email?: string | null;
             is_incorporator?: boolean | null;
             name: string;
@@ -474,12 +475,10 @@ type components = {
             accounts: components["schemas"]["AccountResponse"][];
             entity_id: components["schemas"]["EntityId"];
         };
-        ChatSessionRequest: {
-            email: string;
-        };
-        ChatSessionResponse: {
-            expires_at: string;
-            ws_token: string;
+        ClaimWorkItemRequest: {
+            claimed_by: string;
+            /** Format: int64 */
+            ttl_seconds?: number | null;
         };
         /** Format: uuid */
         ClassificationId: string;
@@ -516,6 +515,10 @@ type components = {
             phase?: string | null;
             required_signers?: string[];
         };
+        CompleteWorkItemRequest: {
+            completed_by: string;
+            result?: string | null;
+        };
         /** Format: uuid */
         ComplianceEscalationId: string;
         ComplianceEscalationResponse: {
@@ -566,7 +569,9 @@ type components = {
             contact_id: components["schemas"]["ContactId"];
             email?: string | null;
             entities: components["schemas"]["EntityId"][];
+            mailing_address?: string | null;
             name: string;
+            notes?: string | null;
             phone?: string | null;
         };
         ContactResponse: {
@@ -577,6 +582,7 @@ type components = {
             created_at: string;
             email?: string | null;
             entity_id: components["schemas"]["EntityId"];
+            mailing_address?: string | null;
             name: string;
             notes?: string | null;
             phone?: string | null;
@@ -613,7 +619,7 @@ type components = {
          * @description Template type for generated contracts.
          * @enum {string}
          */
-        ContractTemplateType: "consulting_agreement" | "employment_offer" | "contractor_agreement" | "nda" | "custom";
+        ContractTemplateType: "consulting_agreement" | "employment_offer" | "contractor_agreement" | "nda" | "safe_agreement" | "custom";
         /** Format: uuid */
         ControlLinkId: string;
         ControlLinkResponse: {
@@ -682,6 +688,7 @@ type components = {
             total_new_units: number;
         };
         ConvertEntityRequest: {
+            jurisdiction?: null | components["schemas"]["Jurisdiction"];
             target_type: components["schemas"]["EntityType"];
         };
         CreateAccountRequest: {
@@ -735,7 +742,9 @@ type components = {
             contact_type: components["schemas"]["ContactType"];
             email?: string | null;
             entity_id: components["schemas"]["EntityId"];
+            mailing_address?: string | null;
             name: string;
+            notes?: string | null;
         };
         CreateControlLinkRequest: {
             child_legal_entity_id: components["schemas"]["LegalEntityId"];
@@ -869,6 +878,24 @@ type components = {
             entity_id: components["schemas"]["EntityId"];
             lines: components["schemas"]["LedgerLineRequest"][];
         };
+        CreateLegacyGrantRequest: {
+            entity_id: components["schemas"]["EntityId"];
+            grant_type: components["schemas"]["GrantType"];
+            recipient_name: string;
+            /** Format: int64 */
+            shares: number;
+        };
+        CreateLegacyShareTransferRequest: {
+            entity_id: components["schemas"]["EntityId"];
+            from_holder: string;
+            governing_doc_type?: null | components["schemas"]["GoverningDocType"];
+            share_class_id: components["schemas"]["ShareClassId"];
+            /** Format: int64 */
+            shares: number;
+            to_holder: string;
+            transfer_type: components["schemas"]["TransferType"];
+            transferee_rights?: null | components["schemas"]["TransfereeRights"];
+        };
         CreateLegalEntityRequest: {
             entity_id: components["schemas"]["EntityId"];
             linked_entity_id?: null | components["schemas"]["EntityId"];
@@ -907,9 +934,17 @@ type components = {
             pay_period_start: string;
         };
         CreatePendingFormationRequest: {
+            company_address?: null | components["schemas"]["Address"];
             entity_type: components["schemas"]["EntityType"];
+            fiscal_year_end?: string | null;
+            formation_date?: string | null;
             jurisdiction?: null | components["schemas"]["Jurisdiction"];
             legal_name: string;
+            registered_agent_address?: string | null;
+            registered_agent_name?: string | null;
+            right_of_first_refusal?: boolean | null;
+            s_corp_election?: boolean | null;
+            transfer_restrictions?: boolean | null;
         };
         CreateProxyRequest: {
             description?: string | null;
@@ -966,6 +1001,7 @@ type components = {
             transferee_rights: components["schemas"]["TransfereeRights"];
         };
         CreateValuationRequest: {
+            dlom?: string | null;
             /** Format: date */
             effective_date: string;
             /** Format: int64 */
@@ -977,9 +1013,20 @@ type components = {
             hurdle_amount_cents?: number | null;
             methodology: components["schemas"]["ValuationMethodology"];
             provider_contact_id?: null | components["schemas"]["ContactId"];
+            report_date?: string | null;
             report_document_id?: null | components["schemas"]["DocumentId"];
             valuation_type: components["schemas"]["ValuationType"];
         };
+        CreateWorkItemRequest: {
+            asap?: boolean;
+            category: string;
+            created_by?: string | null;
+            /** Format: date */
+            deadline?: string | null;
+            description?: string | null;
+            metadata?: unknown;
+            title: string;
+        };
         /**
          * @description A cron expression validated to have at least 5 whitespace-separated fields.
          *
@@ -1060,6 +1107,7 @@ type components = {
         };
         DigestTriggerResponse: {
             digest_count: number;
+            message: string;
             triggered: boolean;
         };
         DilutionPreviewQuery: {
@@ -1175,14 +1223,14 @@ type components = {
          * @description Type of legal document.
          * @enum {string}
          */
-        DocumentType: "articles_of_incorporation" | "articles_of_organization" | "bylaws" | "operating_agreement" | "ss4_application" | "meeting_notice" | "resolution" | "safe_agreement";
+        DocumentType: "articles_of_incorporation" | "articles_of_organization" | "bylaws" | "incorporator_action" | "initial_board_consent" | "operating_agreement" | "initial_written_consent" | "ss4_application" | "meeting_notice" | "resolution" | "consulting_agreement" | "employment_offer_letter" | "contractor_services_agreement" | "mutual_nondisclosure_agreement" | "safe_agreement" | "four_oh_nine_a_valuation_report" | "stock_transfer_agreement" | "transfer_board_consent" | "financing_board_consent" | "equity_issuance_approval" | "subscription_agreement" | "investor_rights_agreement" | "restricted_stock_purchase_agreement" | "ip_assignment_agreement" | "contract";
         /** Format: uuid */
         EntityId: string;
         /**
          * @description The legal structure of a business entity.
          * @enum {string}
          */
-        EntityType: "corporation" | "llc";
+        EntityType: "c_corp" | "llc";
         /** Format: uuid */
         EquityRoundId: string;
         /** @enum {string} */
@@ -1243,6 +1291,21 @@ type components = {
             entity_id: components["schemas"]["EntityId"];
             status: components["schemas"]["AgendaItemStatus"];
         };
+        FinalizePendingFormationRequest: {
+            /** Format: int64 */
+            authorized_shares?: number | null;
+            company_address?: null | components["schemas"]["Address"];
+            fiscal_year_end?: string | null;
+            formation_date?: string | null;
+            incorporator_address?: string | null;
+            incorporator_name?: string | null;
+            par_value?: string | null;
+            registered_agent_address?: string | null;
+            registered_agent_name?: string | null;
+            right_of_first_refusal?: boolean | null;
+            s_corp_election?: boolean | null;
+            transfer_restrictions?: boolean | null;
+        };
         FinalizeWorkflowRequest: {
             entity_id: components["schemas"]["EntityId"];
             phase?: string | null;
@@ -1331,6 +1394,7 @@ type components = {
             vesting?: null | components["schemas"]["VestingSchedule"];
         };
         FounderSummary: {
+            address?: null | components["schemas"]["Address"];
             email?: string | null;
             name: string;
             /** Format: double */
@@ -1596,6 +1660,11 @@ type components = {
          * @enum {string}
          */
         GoverningDocType: "bylaws" | "operating_agreement" | "shareholder_agreement" | "other";
+        /**
+         * @description The type of equity grant.
+         * @enum {string}
+         */
+        GrantType: "common_stock" | "preferred_stock" | "membership_unit" | "stock_option" | "iso" | "nso" | "rsa" | "svu";
         /** Format: uuid */
         HolderId: string;
         HolderResponse: {
@@ -1973,7 +2042,7 @@ type components = {
          * @description Officer title for a corporate officer.
          * @enum {string}
          */
-        OfficerTitle: "ceo" | "cfo" | "secretary" | "president" | "vp" | "other";
+        OfficerTitle: "ceo" | "cfo" | "cto" | "coo" | "secretary" | "treasurer" | "president" | "vp" | "other";
         /** Format: uuid */
         PacketId: string;
         PacketItem: {
@@ -2508,9 +2577,34 @@ type components = {
             obligation_id: components["schemas"]["ObligationId"];
             token: string;
         };
+        /** @description Contract details included in signing resolve response. */
+        SigningContractDetails: {
+            counterparty_name: string;
+            effective_date: string;
+            parameters: unknown;
+            rendered_text?: string | null;
+            template_label?: string | null;
+            template_type: string;
+        };
         SigningLinkResponse: {
             document_id: components["schemas"]["DocumentId"];
             signing_url: string;
+            token: string;
+        };
+        /** @description Response for the public resolve endpoint. */
+        SigningResolveResponse: {
+            contract?: null | components["schemas"]["SigningContractDetails"];
+            document_id: components["schemas"]["DocumentId"];
+            document_status: string;
+            document_title: string;
+            entity_id: components["schemas"]["EntityId"];
+            /** @description Entity legal name for display. */
+            entity_name?: string | null;
+            /** @description Public PDF preview URL for the signing page. */
+            pdf_url?: string | null;
+            /** @description Plain-text preview fallback when a PDF is unavailable. */
+            preview_text?: string | null;
+            signatures: components["schemas"]["SignatureSummary"][];
         };
         /** Format: uuid */
         SpendingLimitId: string;
@@ -2686,8 +2780,10 @@ type components = {
         };
         UpdateContactRequest: {
             cap_table_access?: null | components["schemas"]["CapTableAccess"];
+            category?: null | components["schemas"]["ContactCategory"];
             email?: string | null;
             entity_id: components["schemas"]["EntityId"];
+            mailing_address?: string | null;
             name?: string | null;
             notes?: string | null;
             phone?: string | null;
@@ -2696,8 +2792,13 @@ type components = {
             adopted_by: string;
             /** Format: int32 */
             board_size?: number | null;
+            company_address?: null | components["schemas"]["CompanyAddress"];
+            directors?: components["schemas"]["DirectorInfo"][] | null;
+            document_options?: null | components["schemas"]["DocumentOptions"];
             /** Format: date */
             effective_date: string;
+            fiscal_year_end?: null | components["schemas"]["FiscalYearEnd"];
+            founders?: components["schemas"]["FounderInfo"][] | null;
             incomplete_profile?: boolean | null;
             incorporator_address?: string | null;
             incorporator_name?: string | null;
@@ -2707,10 +2808,12 @@ type components = {
             legal_name: string;
             /** Format: date */
             next_mandatory_review: string;
+            officers?: components["schemas"]["OfficerInfo"][] | null;
             principal_name?: string | null;
             principal_title?: string | null;
             registered_agent_address?: string | null;
             registered_agent_name?: string | null;
+            stock_details?: null | components["schemas"]["StockDetails"];
         };
         UpdateNotificationPrefsRequest: {
             email_enabled?: boolean | null;
@@ -2798,6 +2901,32 @@ type components = {
          * @enum {string}
          */
         VotingMethod: "per_capita" | "per_unit";
+        /** Format: uuid */
+        WorkItemId: string;
+        WorkItemResponse: {
+            asap: boolean;
+            category: string;
+            /** Format: int64 */
+            claim_ttl_seconds?: number | null;
+            claimed_at?: string | null;
+            claimed_by?: string | null;
+            completed_at?: string | null;
+            completed_by?: string | null;
+            created_at: string;
+            created_by?: string | null;
+            /** Format: date */
+            deadline?: string | null;
+            description: string;
+            effective_status: components["schemas"]["WorkItemStatus"];
+            entity_id: components["schemas"]["EntityId"];
+            metadata: unknown;
+            result?: string | null;
+            status: components["schemas"]["WorkItemStatus"];
+            title: string;
+            work_item_id: components["schemas"]["WorkItemId"];
+        };
+        /** @enum {string} */
+        WorkItemStatus: "open" | "claimed" | "completed" | "cancelled";
         WorkerWorkspaceQuery: {
             workspace_id: components["schemas"]["WorkspaceId"];
         };
@@ -2970,6 +3099,7 @@ declare class CorpAPIClient {
     getValuations(entityId: string): Promise<ApiRecord[]>;
     getCurrent409a(entityId: string): Promise<ApiRecord>;
     createValuation(data: ApiRecord): Promise<ApiRecord>;
+    createInstrument(data: ApiRecord): Promise<ApiRecord>;
     submitValuationForApproval(valuationId: string, entityId: string): Promise<ApiRecord>;
     approveValuation(valuationId: string, entityId: string, resolutionId?: string): Promise<ApiRecord>;
     transferShares(data: ApiRecord): Promise<ApiRecord>;
@@ -3051,6 +3181,10 @@ declare class CorpAPIClient {
     listApiKeys(): Promise<ApiRecord[]>;
     assignObligation(obligationId: string, contactId: string): Promise<ApiRecord>;
     getConfig(): Promise<ApiRecord>;
+    submitFeedback(message: string, category?: string, email?: string): Promise<{
+        feedback_id: string;
+        submitted_at: string;
+    }>;
     createLink(externalId: string, provider: string): Promise<ApiRecord>;
 }
 
@@ -3058,6 +3192,13 @@ interface ToolContext {
     dataDir: string;
     onEntityFormed?: (entityId: string) => void;
 }
+type CapTableInstrument = {
+    instrument_id: string;
+    kind: string;
+    symbol: string;
+    status?: string;
+};
+declare function ensureSafeInstrument(client: CorpAPIClient, entityId: string): Promise<CapTableInstrument>;
 declare const TOOL_DEFINITIONS: Record<string, unknown>[];
 declare function isWriteTool(name: string, args?: Record<string, unknown>): boolean;
 declare function executeTool(name: string, args: Record<string, unknown>, client: CorpAPIClient, ctx: ToolContext): Promise<string>;
@@ -3128,7 +3269,7 @@ declare const ContactType: readonly ["individual", "organization"];
 type ContactType = (typeof ContactType)[number];
 declare const ContractStatus: readonly ["draft", "active", "expired", "terminated"];
 type ContractStatus = (typeof ContractStatus)[number];
-declare const ContractTemplateType: readonly ["consulting_agreement", "employment_offer", "contractor_agreement", "nda", "custom"];
+declare const ContractTemplateType: readonly ["consulting_agreement", "employment_offer", "contractor_agreement", "nda", "safe_agreement", "custom"];
 type ContractTemplateType = (typeof ContractTemplateType)[number];
 declare const ControlType: readonly ["voting", "board", "economic", "contractual"];
 type ControlType = (typeof ControlType)[number];
@@ -3146,9 +3287,9 @@ declare const DocumentRequestStatus: readonly ["requested", "provided", "not_app
 type DocumentRequestStatus = (typeof DocumentRequestStatus)[number];
 declare const DocumentStatus: readonly ["draft", "signed", "amended", "filed"];
 type DocumentStatus = (typeof DocumentStatus)[number];
-declare const DocumentType: readonly ["articles_of_incorporation", "articles_of_organization", "bylaws", "operating_agreement", "ss4_application", "meeting_notice", "resolution", "safe_agreement"];
+declare const DocumentType: readonly ["articles_of_incorporation", "articles_of_organization", "bylaws", "incorporator_action", "initial_board_consent", "operating_agreement", "initial_written_consent", "ss4_application", "meeting_notice", "resolution", "consulting_agreement", "employment_offer_letter", "contractor_services_agreement", "mutual_nondisclosure_agreement", "safe_agreement", "four_oh_nine_a_valuation_report", "stock_transfer_agreement", "transfer_board_consent", "financing_board_consent", "equity_issuance_approval", "subscription_agreement", "investor_rights_agreement", "restricted_stock_purchase_agreement", "ip_assignment_agreement", "contract"];
 type DocumentType = (typeof DocumentType)[number];
-declare const EntityType: readonly ["corporation", "llc"];
+declare const EntityType: readonly ["c_corp", "llc"];
 type EntityType = (typeof EntityType)[number];
 declare const EquityRoundStatus: readonly ["draft", "open", "board_approved", "accepted", "closed", "cancelled"];
 type EquityRoundStatus = (typeof EquityRoundStatus)[number];
@@ -3170,6 +3311,8 @@ declare const GovernanceTriggerType: readonly ["external_signal", "policy_eviden
 type GovernanceTriggerType = (typeof GovernanceTriggerType)[number];
 declare const GoverningDocType: readonly ["bylaws", "operating_agreement", "shareholder_agreement", "other"];
 type GoverningDocType = (typeof GoverningDocType)[number];
+declare const GrantType: readonly ["common_stock", "preferred_stock", "membership_unit", "stock_option", "iso", "nso", "rsa", "svu"];
+type GrantType = (typeof GrantType)[number];
 declare const HolderType: readonly ["individual", "organization", "fund", "nonprofit", "trust", "other"];
 type HolderType = (typeof HolderType)[number];
 declare const HttpMethod: readonly ["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"];
@@ -3202,7 +3345,7 @@ declare const NetworkEgress: readonly ["restricted", "open"];
 type NetworkEgress = (typeof NetworkEgress)[number];
 declare const ObligationStatus: readonly ["required", "in_progress", "fulfilled", "waived", "expired"];
 type ObligationStatus = (typeof ObligationStatus)[number];
-declare const OfficerTitle: readonly ["ceo", "cfo", "secretary", "president", "vp", "other"];
+declare const OfficerTitle: readonly ["ceo", "cfo", "cto", "coo", "secretary", "treasurer", "president", "vp", "other"];
 type OfficerTitle = (typeof OfficerTitle)[number];
 declare const PaymentMethod: readonly ["bank_transfer", "card", "check", "wire", "ach"];
 type PaymentMethod = (typeof PaymentMethod)[number];
@@ -3256,7 +3399,9 @@ declare const VoteValue: readonly ["for", "against", "abstain", "recusal"];
 type VoteValue = (typeof VoteValue)[number];
 declare const VotingMethod: readonly ["per_capita", "per_unit"];
 type VotingMethod = (typeof VotingMethod)[number];
+declare const WorkItemStatus: readonly ["open", "claimed", "completed", "cancelled"];
+type WorkItemStatus = (typeof WorkItemStatus)[number];
 declare const WorkflowType: readonly ["transfer", "fundraising"];
 type WorkflowType = (typeof WorkflowType)[number];
 
-export { type AcceptEquityRoundRequest, type AcceptRoundRequest, AccountType, type AddFounderRequest, type AddFounderResponse, type AddSecurityRequest, type AgendaItemResponse, AgendaItemStatus, AgendaItemType, type AgentResponse, AgentStatus, AntiDilutionMethod, type ApiRecord, type ApplyEquityRoundTermsRequest, type ApplyRoundTermsRequest, AssigneeType, type AttachResolutionDocumentRequest, AuthoritySource, AuthorityTier, BankAccountStatus, BankAccountType, type BoardApproveEquityRoundRequest, type BoardApproveRoundRequest, BodyStatus, BodyType, CapTableAccess, CapTableBasis, type CapTableHolderSummary, type CapTableInstrumentSummary, type CapTableResponse, type CastVoteRequest, ClassificationResult, type ComputeResolutionRequest, ContactCategory, type ContactProfileResponse, type ContactResponse, ContactStatus, ContactType, ContractStatus, ContractTemplateType, ControlType, type ConveneMeetingRequest, type ConvertEntityRequest, CorpAPIClient, type CorpConfig, type CreateAgentRequest, type CreateContactRequest, type CreateEquityRoundRequest, type CreateExecutionIntentRequest, type CreateFormationRequest, type CreatePendingFormationRequest, type CreateRoundRequest, Currency, DeadlineSeverity, DeadlineStatus, type DigestSummary, type DigestTriggerResponse, type DissolveEntityRequest, DistributionStatus, DistributionType, DocumentRequestStatus, type DocumentResponse, DocumentStatus, type DocumentSummary, DocumentType, EntityType, type EquityRoundResponse, EquityRoundStatus, EscalationStatus, type ExecuteRoundConversionRequest, type FinalizeAgendaItemRequest, type FormationGatesResponse, type FormationResponse, FormationState, FormationStatus, type FormationStatusResponse, type FormationWithCapTableResponse, GENERATED_TOOL_DEFINITIONS, GlAccountCode, GovernanceAuditEventType, type GovernanceBodyResponse, GovernanceMode, type GovernanceSeatResponse, GovernanceTriggerSource, GovernanceTriggerType, GoverningDocType, HolderType, HttpMethod, IncidentSeverity, IncidentStatus, InstrumentKind, InstrumentStatus, type IntentResponse, IntentStatus, InvestorType, type InvoiceResponse, InvoiceStatus, type IssueStagedRoundResponse, JournalEntryStatus, type LLMResponse, LegalEntityRole, type MeetingResponse, MeetingStatus, MeetingType, MemberRole, NetworkEgress, type ObligationResponse, ObligationStatus, type ObligationsSummaryResponse, OfficerTitle, PaymentMethod, PaymentStatus, PayrollStatus, type PendingFormationResponse, PositionStatus, type PreviewRoundConversionRequest, QuorumStatus, QuorumThreshold, READ_ONLY_TOOLS, ReceiptStatus, ReconciliationStatus, Recurrence, type ResolutionResponse, ResolutionType, RiskLevel, type RoundResponse, SYSTEM_PROMPT_BASE, type ScheduleMeetingRequest, Scope, SeatRole, SeatStatus, SessionExpiredError, Side, type StartStagedRoundRequest, TOOL_DEFINITIONS, TOOL_REGISTRY, TaxFilingStatus, type ToolCall, type ToolContext, TransactionPacketStatus, TransferStatus, TransferType, TransfereeRights, Transport, type UpdateAgentRequest, type UpdateContactRequest, ValuationMethodology, ValuationStatus, ValuationType, type VoteResponse, VoteValue, VotingMethod, WorkflowType, type WorkspaceContactSummary, type WorkspaceEntitySummary, type WorkspaceStatusResponse, type WrittenConsentRequest, type WrittenConsentResponse, describeToolCall, executeTool, formatConfigSection, isWriteTool, provisionWorkspace };
+export { type AcceptEquityRoundRequest, type AcceptRoundRequest, AccountType, type AddFounderRequest, type AddFounderResponse, type AddSecurityRequest, type AgendaItemResponse, AgendaItemStatus, AgendaItemType, type AgentResponse, AgentStatus, AntiDilutionMethod, type ApiRecord, type ApplyEquityRoundTermsRequest, type ApplyRoundTermsRequest, AssigneeType, type AttachResolutionDocumentRequest, AuthoritySource, AuthorityTier, BankAccountStatus, BankAccountType, type BoardApproveEquityRoundRequest, type BoardApproveRoundRequest, BodyStatus, BodyType, CapTableAccess, CapTableBasis, type CapTableHolderSummary, type CapTableInstrument, type CapTableInstrumentSummary, type CapTableResponse, type CastVoteRequest, ClassificationResult, type ComputeResolutionRequest, ContactCategory, type ContactProfileResponse, type ContactResponse, ContactStatus, ContactType, ContractStatus, ContractTemplateType, ControlType, type ConveneMeetingRequest, type ConvertEntityRequest, CorpAPIClient, type CorpConfig, type CreateAgentRequest, type CreateContactRequest, type CreateEquityRoundRequest, type CreateExecutionIntentRequest, type CreateFormationRequest, type CreatePendingFormationRequest, type CreateRoundRequest, Currency, DeadlineSeverity, DeadlineStatus, type DigestSummary, type DigestTriggerResponse, type DissolveEntityRequest, DistributionStatus, DistributionType, DocumentRequestStatus, type DocumentResponse, DocumentStatus, type DocumentSummary, DocumentType, EntityType, type EquityRoundResponse, EquityRoundStatus, EscalationStatus, type ExecuteRoundConversionRequest, type FinalizeAgendaItemRequest, type FormationGatesResponse, type FormationResponse, FormationState, FormationStatus, type FormationStatusResponse, type FormationWithCapTableResponse, GENERATED_TOOL_DEFINITIONS, GlAccountCode, GovernanceAuditEventType, type GovernanceBodyResponse, GovernanceMode, type GovernanceSeatResponse, GovernanceTriggerSource, GovernanceTriggerType, GoverningDocType, GrantType, HolderType, HttpMethod, IncidentSeverity, IncidentStatus, InstrumentKind, InstrumentStatus, type IntentResponse, IntentStatus, InvestorType, type InvoiceResponse, InvoiceStatus, type IssueStagedRoundResponse, JournalEntryStatus, type LLMResponse, LegalEntityRole, type MeetingResponse, MeetingStatus, MeetingType, MemberRole, NetworkEgress, type ObligationResponse, ObligationStatus, type ObligationsSummaryResponse, OfficerTitle, PaymentMethod, PaymentStatus, PayrollStatus, type PendingFormationResponse, PositionStatus, type PreviewRoundConversionRequest, QuorumStatus, QuorumThreshold, READ_ONLY_TOOLS, ReceiptStatus, ReconciliationStatus, Recurrence, type ResolutionResponse, ResolutionType, RiskLevel, type RoundResponse, SYSTEM_PROMPT_BASE, type ScheduleMeetingRequest, Scope, SeatRole, SeatStatus, SessionExpiredError, Side, type StartStagedRoundRequest, TOOL_DEFINITIONS, TOOL_REGISTRY, TaxFilingStatus, type ToolCall, type ToolContext, TransactionPacketStatus, TransferStatus, TransferType, TransfereeRights, Transport, type UpdateAgentRequest, type UpdateContactRequest, ValuationMethodology, ValuationStatus, ValuationType, type VoteResponse, VoteValue, VotingMethod, WorkItemStatus, WorkflowType, type WorkspaceContactSummary, type WorkspaceEntitySummary, type WorkspaceStatusResponse, type WrittenConsentRequest, type WrittenConsentResponse, describeToolCall, ensureSafeInstrument, executeTool, formatConfigSection, isWriteTool, provisionWorkspace };

package/dist/index.js

@@ -164,6 +164,9 @@ var CorpAPIClient = class {
   createValuation(data) {
     return this.post("/v1/valuations", data);
   }
+  createInstrument(data) {
+    return this.post("/v1/equity/instruments", data);
+  }
   submitValuationForApproval(valuationId, entityId) {
     return this.post(`/v1/valuations/${valuationId}/submit-for-approval`, { entity_id: entityId });
   }
@@ -277,7 +280,7 @@ var CorpAPIClient = class {
     return this.get(`/v1/sign/${documentId}`, { entity_id: entityId });
   }
   async validatePreviewPdf(entityId, documentId) {
-    const resp = await this.request("GET", "/v1/documents/preview/pdf", void 0, { entity_id: entityId, document_id: documentId });
+    const resp = await this.request("GET", "/v1/documents/preview/pdf/validate", void 0, { entity_id: entityId, document_id: documentId });
     await this.throwIfError(resp);
     return { entity_id: entityId, document_id: documentId };
   }
@@ -442,6 +445,10 @@ var CorpAPIClient = class {
   getConfig() {
     return this.get("/v1/config");
   }
+  // --- Feedback ---
+  submitFeedback(message, category, email) {
+    return this.post("/v1/feedback", { message, category, email });
+  }
   // --- Link/Claim ---
   async createLink(externalId, provider) {
     const resp = await this.request("POST", "/v1/workspaces/link", { external_id: externalId, provider });
@@ -509,6 +516,8 @@ var GENERATED_TOOL_DEFINITIONS = [
           "right_of_first_refusal": { "type": "boolean", "description": "create/finalize/form: include ROFR in bylaws (corp)" },
           "authorized_shares": { "type": "integer", "description": "finalize: authorized shares for corporations" },
           "par_value": { "type": "string", "description": "finalize: par value per share, e.g. 0.0001" },
+          "incorporator_name": { "type": "string", "description": "finalize: incorporator legal name (overrides founder)" },
+          "incorporator_address": { "type": "string", "description": "finalize: incorporator mailing address (overrides founder)" },
           "company_address": {
             "type": "object",
             "properties": {
@@ -536,7 +545,7 @@ var GENERATED_TOOL_DEFINITIONS = [
                 "share_count": { "type": "integer" },
                 "share_class": { "type": "string" },
                 "role": { "type": "string", "enum": ["director", "officer", "manager", "member", "chair"] },
-                "officer_title": { "type": "string", "enum": ["ceo", "cfo", "secretary", "president", "vp", "other"] },
+                "officer_title": { "type": "string", "enum": ["ceo", "cfo", "cto", "coo", "secretary", "treasurer", "president", "vp", "other"] },
                 "shares_purchased": { "type": "integer" },
                 "address": {
                   "type": "object",
@@ -566,7 +575,7 @@ var GENERATED_TOOL_DEFINITIONS = [
           "email": { "type": "string", "description": "add_founder: email address" },
           "role": { "type": "string", "enum": ["director", "officer", "manager", "member", "chair"], "description": "add_founder: role" },
           "ownership_pct": { "type": "number", "description": "add_founder: ownership percentage (e.g. 50 for 50%)" },
-          "officer_title": { "type": "string", "enum": ["ceo", "cfo", "secretary", "president", "vp", "other"], "description": "add_founder: officer title (corp only)" },
+          "officer_title": { "type": "string", "enum": ["ceo", "cfo", "cto", "coo", "secretary", "treasurer", "president", "vp", "other"], "description": "add_founder: officer title (corp only)" },
           "is_incorporator": { "type": "boolean", "description": "add_founder: is sole incorporator (corp only)" },
           "address": {
             "type": "object",
@@ -858,6 +867,22 @@ var GENERATED_TOOL_DEFINITIONS = [
         "required": ["action"]
       }
     }
+  },
+  {
+    "type": "function",
+    "function": {
+      "name": "feedback",
+      "description": "Submit feedback to TheCorporation. Logs the feedback and optionally emails a copy to the submitter.",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "message": { "type": "string", "description": "Feedback message" },
+          "category": { "type": "string", "description": "Category (e.g. bug, feature, general)" },
+          "email": { "type": "string", "description": "Submitter email to receive a copy" }
+        },
+        "required": ["message"]
+      }
+    }
   }
 ];
 
@@ -933,7 +958,9 @@ var entityActions = {
       s_corp_election: args.s_corp_election,
       transfer_restrictions: args.transfer_restrictions,
       right_of_first_refusal: args.right_of_first_refusal,
-      company_address: args.company_address
+      company_address: args.company_address,
+      incorporator_name: args.incorporator_name,
+      incorporator_address: args.incorporator_address
     });
     if (entityId && ctx.onEntityFormed) {
       ctx.onEntityFormed(entityId);
@@ -976,6 +1003,34 @@ var entityActions = {
   },
   dissolve: async (args, client) => client.dissolveEntity(requiredString(args, "entity_id"), args)
 };
+async function ensureSafeInstrument(client, entityId) {
+  const capTable = await client.getCapTable(entityId);
+  const issuerLegalEntityId = capTable.issuer_legal_entity_id;
+  if (!issuerLegalEntityId) {
+    throw new Error("No issuer legal entity found.");
+  }
+  const instruments = capTable.instruments ?? [];
+  const safeInstrument = instruments.find((instrument) => {
+    const status = String(instrument.status ?? "active").toLowerCase();
+    return instrument.kind.toLowerCase() === "safe" && status === "active";
+  });
+  if (safeInstrument) {
+    return safeInstrument;
+  }
+  const created = await client.createInstrument({
+    entity_id: entityId,
+    issuer_legal_entity_id: issuerLegalEntityId,
+    symbol: "SAFE",
+    kind: "safe",
+    terms: {}
+  });
+  return {
+    instrument_id: String(created.instrument_id ?? ""),
+    kind: String(created.kind ?? "safe"),
+    symbol: String(created.symbol ?? "SAFE"),
+    status: String(created.status ?? "active")
+  };
+}
 var equityActions = {
   start_round: async (args, client) => client.startEquityRound(args),
   add_security: async (args, client) => {
@@ -1023,9 +1078,7 @@ var equityActions = {
     const capTable = await client.getCapTable(entityId);
     const issuerLegalEntityId = capTable.issuer_legal_entity_id;
     if (!issuerLegalEntityId) return { error: "No issuer legal entity found." };
-    const instruments = capTable.instruments;
-    const safeInstrument = instruments?.find((i) => i.kind.toLowerCase() === "safe");
-    if (!safeInstrument) return { error: "No SAFE instrument found on cap table." };
+    const safeInstrument = await ensureSafeInstrument(client, entityId);
     const principalCents = args.principal_amount_cents ?? args.amount_cents ?? 0;
     const round = await client.startEquityRound({
       entity_id: entityId,
@@ -1042,7 +1095,6 @@ var equityActions = {
       grant_type: args.safe_type ?? "post_money"
     };
     if (args.email) securityData.email = args.email;
-    if (args.valuation_cap_cents) securityData.valuation_cap_cents = args.valuation_cap_cents;
     await client.addRoundSecurity(roundId, securityData);
     return client.issueRound(roundId, { entity_id: entityId });
   },
@@ -1338,6 +1390,18 @@ function isWriteTool(name, args) {
   return true;
 }
 async function executeTool(name, args, client, ctx) {
+  if (name === "feedback") {
+    try {
+      const result = await client.submitFeedback(
+        args.message,
+        args.category,
+        args.email
+      );
+      return JSON.stringify(result, null, 0);
+    } catch (err) {
+      return JSON.stringify({ error: String(err) });
+    }
+  }
   const dispatch = TOOL_DISPATCH[name];
   if (!dispatch) return JSON.stringify({ error: `Unknown tool: ${name}` });
   const action = args.action;
@@ -1659,7 +1723,7 @@ var ContactCategory = ["employee", "contractor", "board_member", "law_firm", "va
 var ContactStatus = ["active", "inactive"];
 var ContactType = ["individual", "organization"];
 var ContractStatus = ["draft", "active", "expired", "terminated"];
-var ContractTemplateType = ["consulting_agreement", "employment_offer", "contractor_agreement", "nda", "custom"];
+var ContractTemplateType = ["consulting_agreement", "employment_offer", "contractor_agreement", "nda", "safe_agreement", "custom"];
 var ControlType = ["voting", "board", "economic", "contractual"];
 var Currency = ["usd"];
 var DeadlineSeverity = ["low", "medium", "high", "critical"];
@@ -1668,8 +1732,8 @@ var DistributionStatus = ["pending", "approved", "distributed"];
 var DistributionType = ["dividend", "return", "liquidation"];
 var DocumentRequestStatus = ["requested", "provided", "not_applicable", "waived"];
 var DocumentStatus = ["draft", "signed", "amended", "filed"];
-var DocumentType = ["articles_of_incorporation", "articles_of_organization", "bylaws", "operating_agreement", "ss4_application", "meeting_notice", "resolution", "safe_agreement"];
-var EntityType = ["corporation", "llc"];
+var DocumentType = ["articles_of_incorporation", "articles_of_organization", "bylaws", "incorporator_action", "initial_board_consent", "operating_agreement", "initial_written_consent", "ss4_application", "meeting_notice", "resolution", "consulting_agreement", "employment_offer_letter", "contractor_services_agreement", "mutual_nondisclosure_agreement", "safe_agreement", "four_oh_nine_a_valuation_report", "stock_transfer_agreement", "transfer_board_consent", "financing_board_consent", "equity_issuance_approval", "subscription_agreement", "investor_rights_agreement", "restricted_stock_purchase_agreement", "ip_assignment_agreement", "contract"];
+var EntityType = ["c_corp", "llc"];
 var EquityRoundStatus = ["draft", "open", "board_approved", "accepted", "closed", "cancelled"];
 var EscalationStatus = ["open", "resolved"];
 var FormationState = ["forming", "active"];
@@ -1680,6 +1744,7 @@ var GovernanceMode = ["normal", "principal_unavailable", "incident_lockdown"];
 var GovernanceTriggerSource = ["compliance_scanner", "execution_gate", "external_ingestion"];
 var GovernanceTriggerType = ["external_signal", "policy_evidence_mismatch", "compliance_deadline_missed_d_plus_1", "audit_chain_verification_failed"];
 var GoverningDocType = ["bylaws", "operating_agreement", "shareholder_agreement", "other"];
+var GrantType = ["common_stock", "preferred_stock", "membership_unit", "stock_option", "iso", "nso", "rsa", "svu"];
 var HolderType = ["individual", "organization", "fund", "nonprofit", "trust", "other"];
 var HttpMethod = ["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"];
 var IncidentSeverity = ["low", "medium", "high", "critical"];
@@ -1696,7 +1761,7 @@ var MeetingType = ["board_meeting", "shareholder_meeting", "written_consent", "m
 var MemberRole = ["director", "officer", "manager", "member", "chair"];
 var NetworkEgress = ["restricted", "open"];
 var ObligationStatus = ["required", "in_progress", "fulfilled", "waived", "expired"];
-var OfficerTitle = ["ceo", "cfo", "secretary", "president", "vp", "other"];
+var OfficerTitle = ["ceo", "cfo", "cto", "coo", "secretary", "treasurer", "president", "vp", "other"];
 var PaymentMethod = ["bank_transfer", "card", "check", "wire", "ach"];
 var PaymentStatus = ["submitted", "processing", "completed", "failed"];
 var PayrollStatus = ["pending", "processing", "completed"];
@@ -1723,6 +1788,7 @@ var ValuationStatus = ["draft", "pending_approval", "approved", "expired", "supe
 var ValuationType = ["four_oh_nine_a", "llc_profits_interest", "fair_market_value", "gift", "estate", "other"];
 var VoteValue = ["for", "against", "abstain", "recusal"];
 var VotingMethod = ["per_capita", "per_unit"];
+var WorkItemStatus = ["open", "claimed", "completed", "cancelled"];
 var WorkflowType = ["transfer", "fundraising"];
 export {
   AccountType,
@@ -1767,6 +1833,7 @@ export {
   GovernanceTriggerSource,
   GovernanceTriggerType,
   GoverningDocType,
+  GrantType,
   HolderType,
   HttpMethod,
   IncidentSeverity,
@@ -1815,8 +1882,10 @@ export {
   ValuationType,
   VoteValue,
   VotingMethod,
+  WorkItemStatus,
   WorkflowType,
   describeToolCall,
+  ensureSafeInstrument,
   executeTool,
   formatConfigSection,
   isWriteTool,