@thecorporation/corp-tools 26.3.22 → 26.3.23

package/dist/index.d.ts

@@ -3213,7 +3213,7 @@ type DigestTriggerResponse = components["schemas"]["DigestTriggerResponse"];
 type InvoiceResponse = components["schemas"]["InvoiceResponse"];
 
 declare class SessionExpiredError extends Error {
-    constructor();
+    constructor(detail?: string);
 }
 declare function provisionWorkspace(apiUrl: string, name?: string): Promise<ApiRecord>;
 declare class CorpAPIClient {
@@ -3289,6 +3289,13 @@ declare class CorpAPIClient {
     computeResolution(meetingId: string, itemId: string, entityId: string, data: ApiRecord): Promise<ResolutionResponse>;
     attachResolutionDocument(meetingId: string, resolutionId: string, data: ApiRecord): Promise<ResolutionResponse>;
     writtenConsent(data: ApiRecord): Promise<WrittenConsentResponse>;
+    getGovernanceMode(entityId: string): Promise<ApiRecord>;
+    setGovernanceMode(data: ApiRecord): Promise<ApiRecord>;
+    resignSeat(seatId: string, entityId: string): Promise<ApiRecord>;
+    createGovernanceIncident(data: ApiRecord): Promise<ApiRecord>;
+    listGovernanceIncidents(entityId: string): Promise<ApiRecord[]>;
+    resolveGovernanceIncident(incidentId: string, data: ApiRecord): Promise<ApiRecord>;
+    getGovernanceProfile(entityId: string): Promise<ApiRecord>;
     listAgendaItems(meetingId: string, entityId: string): Promise<AgendaItemResponse[]>;
     listVotes(meetingId: string, itemId: string, entityId: string): Promise<VoteResponse[]>;
     getEntityDocuments(entityId: string): Promise<DocumentResponse[]>;
@@ -3308,8 +3315,12 @@ declare class CorpAPIClient {
     runPayroll(data: ApiRecord): Promise<ApiRecord>;
     submitPayment(data: ApiRecord): Promise<ApiRecord>;
     openBankAccount(data: ApiRecord): Promise<ApiRecord>;
+    activateBankAccount(bankAccountId: string, entityId: string): Promise<ApiRecord>;
     classifyContractor(data: ApiRecord): Promise<ApiRecord>;
     reconcileLedger(data: ApiRecord): Promise<ApiRecord>;
+    getFinancialStatements(entityId: string, params?: Record<string, string>): Promise<ApiRecord>;
+    getDilutionPreview(entityId: string, roundId: string): Promise<ApiRecord>;
+    getControlMap(entityId: string, rootEntityId: string): Promise<ApiRecord>;
     listTaxFilings(entityId: string): Promise<ApiRecord[]>;
     listDeadlines(entityId: string): Promise<ApiRecord[]>;
     listContractorClassifications(entityId: string): Promise<ApiRecord[]>;
@@ -3347,6 +3358,10 @@ declare class CorpAPIClient {
     sendAgentMessage(id: string, message: string): Promise<ApiRecord>;
     addAgentSkill(id: string, data: ApiRecord): Promise<ApiRecord>;
     listSupportedModels(): Promise<ApiRecord[]>;
+    getAgentExecution(agentId: string, executionId: string): Promise<ApiRecord>;
+    getAgentExecutionResult(agentId: string, executionId: string): Promise<ApiRecord>;
+    getAgentExecutionLogs(agentId: string, executionId: string): Promise<ApiRecord>;
+    killAgentExecution(agentId: string, executionId: string): Promise<ApiRecord>;
     createGovernanceBody(data: ApiRecord): Promise<ApiRecord>;
     createGovernanceSeat(bodyId: string, entityId: string, data: ApiRecord): Promise<ApiRecord>;
     listWorkItems(entityId: string, params?: Record<string, string>): Promise<ApiRecord[]>;
@@ -3357,6 +3372,9 @@ declare class CorpAPIClient {
     releaseWorkItem(entityId: string, workItemId: string): Promise<ApiRecord>;
     cancelWorkItem(entityId: string, workItemId: string): Promise<ApiRecord>;
     listApiKeys(): Promise<ApiRecord[]>;
+    createApiKey(data: ApiRecord): Promise<ApiRecord>;
+    revokeApiKey(keyId: string): Promise<void>;
+    rotateApiKey(keyId: string): Promise<ApiRecord>;
     assignObligation(obligationId: string, contactId: string): Promise<ApiRecord>;
     getConfig(): Promise<ApiRecord>;
     listServiceCatalog(): Promise<ApiRecord[]>;

package/dist/index.js

@@ -232,8 +232,8 @@ function resetCache() {
 
 // src/api-client.ts
 var SessionExpiredError = class extends Error {
-  constructor() {
-    super("Your API key is no longer valid. Run 'corp setup' to re-authenticate.");
+  constructor(detail) {
+    super(detail || "Your API key is no longer valid. Run 'corp setup' to re-authenticate.");
     this.name = "SessionExpiredError";
   }
 };
@@ -274,7 +274,8 @@ async function provisionWorkspace(apiUrl, name) {
   });
   if (!resp.ok) {
     const detail = await extractErrorMessage(resp);
-    throw new Error(`Provision failed: ${resp.status} ${resp.statusText} \u2014 ${detail}`);
+    const prefix = resp.status >= 500 ? "Server error" : resp.status === 404 ? "Not found" : resp.status === 422 ? "Validation error" : `HTTP ${resp.status}`;
+    throw new Error(`Provision failed (${prefix}): ${detail}`);
   }
   return resp.json();
 }
@@ -311,10 +312,11 @@ var CorpAPIClient = class {
     return fetch(url, opts);
   }
   async throwIfError(resp) {
-    if (resp.status === 401) throw new SessionExpiredError();
     if (!resp.ok) {
       const detail = await extractErrorMessage(resp);
-      throw new Error(`${resp.status} ${resp.statusText} \u2014 ${detail}`);
+      if (resp.status === 401) throw new SessionExpiredError(detail);
+      const prefix = resp.status >= 500 ? "Server error" : resp.status === 404 ? "Not found" : resp.status === 422 ? "Validation error" : `HTTP ${resp.status}`;
+      throw new Error(`${prefix}: ${detail}`);
     }
   }
   async get(path, params) {
@@ -523,6 +525,27 @@ var CorpAPIClient = class {
   writtenConsent(data) {
     return this.post("/v1/meetings/written-consent", data);
   }
+  getGovernanceMode(entityId) {
+    return this.get("/v1/governance/mode", { entity_id: entityId });
+  }
+  setGovernanceMode(data) {
+    return this.post("/v1/governance/mode", data);
+  }
+  resignSeat(seatId, entityId) {
+    return this.post(`/v1/governance-seats/${pathSegment(seatId)}/resign`, { entity_id: entityId });
+  }
+  createGovernanceIncident(data) {
+    return this.post("/v1/governance/incidents", data);
+  }
+  listGovernanceIncidents(entityId) {
+    return this.get(`/v1/entities/${pathSegment(entityId)}/governance/incidents`);
+  }
+  resolveGovernanceIncident(incidentId, data) {
+    return this.post(`/v1/governance/incidents/${pathSegment(incidentId)}/resolve`, data);
+  }
+  getGovernanceProfile(entityId) {
+    return this.get(`/v1/entities/${pathSegment(entityId)}/governance/profile`);
+  }
   listAgendaItems(meetingId, entityId) {
     return this.get(`/v1/meetings/${pathSegment(meetingId)}/agenda-items`, { entity_id: entityId });
   }
@@ -552,7 +575,9 @@ var CorpAPIClient = class {
   }
   getPreviewPdfUrl(entityId, documentId) {
     if (this.apiUrl.startsWith("process://")) {
-      throw new Error("getPreviewPdfUrl is not available in process transport mode \u2014 use validatePreviewPdf() and fetch the PDF via the API instead");
+      throw new Error(
+        "PDF preview is not available in local process transport mode.\n  Use cloud mode (npx corp setup) or start a local HTTP server (npx corp serve) instead."
+      );
     }
     const qs = new URLSearchParams({ entity_id: entityId, document_id: documentId }).toString();
     return `${this.apiUrl}/v1/documents/preview/pdf?${qs}`;
@@ -588,12 +613,25 @@ var CorpAPIClient = class {
   openBankAccount(data) {
     return this.post("/v1/treasury/bank-accounts", data);
   }
+  activateBankAccount(bankAccountId, entityId) {
+    return this.postWithParams(`/v1/bank-accounts/${pathSegment(bankAccountId)}/activate`, {}, { entity_id: entityId });
+  }
   classifyContractor(data) {
     return this.post("/v1/contractors/classify", data);
   }
   reconcileLedger(data) {
     return this.post("/v1/ledger/reconcile", data);
   }
+  getFinancialStatements(entityId, params) {
+    return this.get("/v1/treasury/financial-statements", { entity_id: entityId, ...params ?? {} });
+  }
+  // --- Equity analytics ---
+  getDilutionPreview(entityId, roundId) {
+    return this.get("/v1/equity/dilution/preview", { entity_id: entityId, round_id: roundId });
+  }
+  getControlMap(entityId, rootEntityId) {
+    return this.get("/v1/equity/control-map", { entity_id: entityId, root_entity_id: rootEntityId });
+  }
   // --- Tax ---
   listTaxFilings(entityId) {
     return this.get(`/v1/entities/${pathSegment(entityId)}/tax-filings`);
@@ -724,6 +762,18 @@ var CorpAPIClient = class {
   listSupportedModels() {
     return this.get("/v1/models");
   }
+  async getAgentExecution(agentId, executionId) {
+    return this.get(`/v1/agents/${pathSegment(agentId)}/executions/${pathSegment(executionId)}`);
+  }
+  async getAgentExecutionResult(agentId, executionId) {
+    return this.get(`/v1/agents/${pathSegment(agentId)}/executions/${pathSegment(executionId)}/result`);
+  }
+  async getAgentExecutionLogs(agentId, executionId) {
+    return this.get(`/v1/agents/${pathSegment(agentId)}/executions/${pathSegment(executionId)}/logs`);
+  }
+  async killAgentExecution(agentId, executionId) {
+    return this.post(`/v1/agents/${pathSegment(agentId)}/executions/${pathSegment(executionId)}/kill`, {});
+  }
   // --- Governance bodies ---
   createGovernanceBody(data) {
     return this.post("/v1/governance-bodies", data);
@@ -757,6 +807,15 @@ var CorpAPIClient = class {
   listApiKeys() {
     return this.get("/v1/api-keys", { workspace_id: this.workspaceId });
   }
+  async createApiKey(data) {
+    return this.post("/v1/api-keys", data);
+  }
+  async revokeApiKey(keyId) {
+    return this.del(`/v1/api-keys/${pathSegment(keyId)}`);
+  }
+  async rotateApiKey(keyId) {
+    return this.post(`/v1/api-keys/${pathSegment(keyId)}/rotate`, {});
+  }
   // --- Obligations ---
   assignObligation(obligationId, contactId) {
     return this.patch(`/v1/obligations/${pathSegment(obligationId)}/assign`, { contact_id: contactId });
@@ -796,7 +855,9 @@ var CorpAPIClient = class {
     const resp = await this.request("POST", "/v1/workspaces/link", { external_id: externalId, provider });
     if (!resp.ok) {
       const detail = await extractErrorMessage(resp);
-      throw new Error(`${resp.status} ${resp.statusText} \u2014 ${detail}`);
+      if (resp.status === 401) throw new SessionExpiredError(detail);
+      const prefix = resp.status >= 500 ? "Server error" : resp.status === 404 ? "Not found" : resp.status === 422 ? "Validation error" : `HTTP ${resp.status}`;
+      throw new Error(`${prefix}: ${detail}`);
     }
     return resp.json();
   }