@thecorporation/corp-tools 0.1.0

package/dist/index.js

@@ -0,0 +1,1626 @@
+// src/api-client.ts
+var SessionExpiredError = class extends Error {
+  constructor() {
+    super("Your API key is no longer valid. Run 'corp setup' to re-authenticate.");
+    this.name = "SessionExpiredError";
+  }
+};
+async function provisionWorkspace(apiUrl, name) {
+  const url = `${apiUrl.replace(/\/+$/, "")}/v1/workspaces/provision`;
+  const body = {};
+  if (name) body.name = name;
+  const resp = await fetch(url, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(body)
+  });
+  if (!resp.ok) throw new Error(`Provision failed: ${resp.status} ${resp.statusText}`);
+  return resp.json();
+}
+var CorpAPIClient = class {
+  apiUrl;
+  apiKey;
+  workspaceId;
+  constructor(apiUrl, apiKey, workspaceId) {
+    this.apiUrl = apiUrl.replace(/\/+$/, "");
+    this.apiKey = apiKey;
+    this.workspaceId = workspaceId;
+  }
+  headers() {
+    return {
+      Authorization: `Bearer ${this.apiKey}`,
+      "Content-Type": "application/json",
+      Accept: "application/json"
+    };
+  }
+  async request(method, path, body, params) {
+    let url = `${this.apiUrl}${path}`;
+    if (params) {
+      const qs = new URLSearchParams(params).toString();
+      if (qs) url += `?${qs}`;
+    }
+    const opts = { method, headers: this.headers() };
+    if (body !== void 0) opts.body = JSON.stringify(body);
+    return fetch(url, opts);
+  }
+  async get(path, params) {
+    const resp = await this.request("GET", path, void 0, params);
+    if (resp.status === 401) throw new SessionExpiredError();
+    if (!resp.ok) throw new Error(`${resp.status} ${resp.statusText}`);
+    return resp.json();
+  }
+  async post(path, body) {
+    const resp = await this.request("POST", path, body);
+    if (resp.status === 401) throw new SessionExpiredError();
+    if (!resp.ok) throw new Error(`${resp.status} ${resp.statusText}`);
+    return resp.json();
+  }
+  async patch(path, body) {
+    const resp = await this.request("PATCH", path, body);
+    if (resp.status === 401) throw new SessionExpiredError();
+    if (!resp.ok) throw new Error(`${resp.status} ${resp.statusText}`);
+    return resp.json();
+  }
+  async del(path) {
+    const resp = await this.request("DELETE", path);
+    if (resp.status === 401) throw new SessionExpiredError();
+    if (!resp.ok) throw new Error(`${resp.status} ${resp.statusText}`);
+  }
+  // --- Workspace ---
+  getStatus() {
+    return this.get(`/v1/workspaces/${this.workspaceId}/status`);
+  }
+  // --- Obligations ---
+  getObligations(tier) {
+    const params = {};
+    if (tier) params.tier = tier;
+    return this.get("/v1/obligations/summary", params);
+  }
+  // --- Digests ---
+  listDigests() {
+    return this.get("/v1/digests");
+  }
+  triggerDigest() {
+    return this.post("/v1/digests/trigger");
+  }
+  getDigest(key) {
+    return this.get(`/v1/digests/${key}`);
+  }
+  // --- Entities ---
+  listEntities() {
+    return this.get(`/v1/workspaces/${this.workspaceId}/entities`);
+  }
+  // --- Contacts ---
+  listContacts() {
+    return this.get(`/v1/workspaces/${this.workspaceId}/contacts`);
+  }
+  getContact(id) {
+    return this.get(`/v1/contacts/${id}`);
+  }
+  getContactProfile(id) {
+    return this.get(`/v1/contacts/${id}/profile`);
+  }
+  createContact(data) {
+    return this.post(`/v1/workspaces/${this.workspaceId}/contacts`, data);
+  }
+  updateContact(id, data) {
+    return this.patch(`/v1/contacts/${id}`, data);
+  }
+  getNotificationPrefs(contactId) {
+    return this.get(`/v1/contacts/${contactId}/notification-prefs`);
+  }
+  updateNotificationPrefs(contactId, prefs) {
+    return this.patch(`/v1/contacts/${contactId}/notification-prefs`, prefs);
+  }
+  // --- Cap Table ---
+  getCapTable(entityId) {
+    return this.get(`/v1/entities/${entityId}/cap-table`);
+  }
+  getSafeNotes(entityId) {
+    return this.get(`/v1/entities/${entityId}/safe-notes`);
+  }
+  getShareTransfers(entityId) {
+    return this.get(`/v1/entities/${entityId}/share-transfers`);
+  }
+  getValuations(entityId) {
+    return this.get(`/v1/entities/${entityId}/valuations`);
+  }
+  getCurrent409a(entityId) {
+    return this.get(`/v1/entities/${entityId}/current-409a`);
+  }
+  issueEquity(data) {
+    return this.post("/v1/equity/grants", data);
+  }
+  issueSafe(data) {
+    return this.post("/v1/safe-notes", data);
+  }
+  transferShares(data) {
+    return this.post("/v1/share-transfers", data);
+  }
+  calculateDistribution(data) {
+    return this.post("/v1/distributions", data);
+  }
+  // --- Governance ---
+  listGovernanceBodies(entityId) {
+    return this.get(`/v1/entities/${entityId}/governance-bodies`);
+  }
+  getGovernanceSeats(bodyId) {
+    return this.get(`/v1/governance-bodies/${bodyId}/seats`);
+  }
+  listMeetings(bodyId) {
+    return this.get(`/v1/governance-bodies/${bodyId}/meetings`);
+  }
+  getMeetingResolutions(meetingId) {
+    return this.get(`/v1/meetings/${meetingId}/resolutions`);
+  }
+  conveneMeeting(data) {
+    return this.post("/v1/meetings", data);
+  }
+  castVote(meetingId, itemId, data) {
+    return this.post(`/v1/meetings/${meetingId}/agenda-items/${itemId}/vote`, data);
+  }
+  // --- Documents ---
+  getEntityDocuments(entityId) {
+    return this.get(`/v1/formations/${entityId}/documents`);
+  }
+  generateContract(data) {
+    return this.post("/v1/contracts", data);
+  }
+  getSigningLink(documentId) {
+    return {
+      document_id: documentId,
+      signing_url: `https://humans.thecorporation.ai/sign/${documentId}`
+    };
+  }
+  // --- Finance ---
+  createInvoice(data) {
+    return this.post("/v1/invoices", data);
+  }
+  runPayroll(data) {
+    return this.post("/v1/payroll/runs", data);
+  }
+  submitPayment(data) {
+    return this.post("/v1/payments", data);
+  }
+  openBankAccount(data) {
+    return this.post("/v1/bank-accounts", data);
+  }
+  classifyContractor(data) {
+    return this.post("/v1/contractors/classify", data);
+  }
+  reconcileLedger(data) {
+    return this.post("/v1/ledger/reconcile", data);
+  }
+  // --- Tax ---
+  fileTaxDocument(data) {
+    return this.post("/v1/tax/filings", data);
+  }
+  trackDeadline(data) {
+    return this.post("/v1/deadlines", data);
+  }
+  // --- Billing ---
+  getBillingStatus() {
+    return this.get("/v1/billing/status", { workspace_id: this.workspaceId });
+  }
+  getBillingPlans() {
+    return this.get("/v1/billing/plans").then((data) => {
+      if (typeof data === "object" && data !== null && "plans" in data) {
+        return data.plans;
+      }
+      return data;
+    });
+  }
+  createBillingPortal() {
+    return this.post("/v1/billing/portal", { workspace_id: this.workspaceId });
+  }
+  createBillingCheckout(tier, entityId) {
+    const body = { tier };
+    if (entityId) body.entity_id = entityId;
+    return this.post("/v1/billing/checkout", body);
+  }
+  // --- Formations ---
+  getFormation(id) {
+    return this.get(`/v1/formations/${id}`);
+  }
+  getFormationDocuments(id) {
+    return this.get(`/v1/formations/${id}/documents`);
+  }
+  createFormation(data) {
+    return this.post("/v1/formations", data);
+  }
+  // --- Human obligations ---
+  getHumanObligations() {
+    return this.get(`/v1/workspaces/${this.workspaceId}/human-obligations`);
+  }
+  getSignerToken(obligationId) {
+    return this.post(`/v1/human-obligations/${obligationId}/signer-token`);
+  }
+  // --- Demo ---
+  seedDemo(name) {
+    return this.post("/v1/demo/seed", { name, workspace_id: this.workspaceId });
+  }
+  // --- Entities writes ---
+  convertEntity(entityId, data) {
+    return this.post(`/v1/entities/${entityId}/convert`, data);
+  }
+  dissolveEntity(entityId, data) {
+    return this.post(`/v1/entities/${entityId}/dissolve`, data);
+  }
+  // --- Agents ---
+  listAgents() {
+    return this.get("/v1/agents");
+  }
+  getAgent(id) {
+    return this.get(`/v1/agents/${id}`);
+  }
+  createAgent(data) {
+    return this.post("/v1/agents", data);
+  }
+  updateAgent(id, data) {
+    return this.patch(`/v1/agents/${id}`, data);
+  }
+  deleteAgent(id) {
+    return this.del(`/v1/agents/${id}`);
+  }
+  sendAgentMessage(id, body) {
+    return this.post(`/v1/agents/${id}/messages`, { body });
+  }
+  listAgentExecutions(id) {
+    return this.get(`/v1/agents/${id}/executions`);
+  }
+  getAgentUsage(id) {
+    return this.get(`/v1/agents/${id}/usage`);
+  }
+  addAgentSkill(id, data) {
+    return this.post(`/v1/agents/${id}/skills`, data);
+  }
+  listSupportedModels() {
+    return this.get("/v1/models");
+  }
+  // --- Approvals ---
+  listPendingApprovals() {
+    return this.get("/v1/approvals/pending");
+  }
+  respondApproval(id, decision, message = "") {
+    return this.patch(`/v1/approvals/${id}`, { decision, message });
+  }
+  // --- API Keys ---
+  listApiKeys() {
+    return this.get("/v1/api-keys", { workspace_id: this.workspaceId });
+  }
+  // --- Obligations ---
+  assignObligation(obligationId, contactId) {
+    return this.patch(`/v1/obligations/${obligationId}/assign`, { contact_id: contactId });
+  }
+  // --- Config ---
+  getConfig() {
+    return this.get("/v1/config");
+  }
+  // --- Link/Claim ---
+  async createLink() {
+    const resp = await this.request("POST", "/v1/workspaces/link");
+    if (!resp.ok) throw new Error(`${resp.status} ${resp.statusText}`);
+    return resp.json();
+  }
+};
+
+// src/tools.ts
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from "fs";
+import { join } from "path";
+
+// src/tool-defs.generated.ts
+var GENERATED_TOOL_DEFINITIONS = [
+  {
+    "type": "function",
+    "function": {
+      "name": "get_workspace_status",
+      "description": "Get workspace status summary",
+      "parameters": {
+        "type": "object",
+        "properties": {},
+        "required": []
+      }
+    }
+  },
+  {
+    "type": "function",
+    "function": {
+      "name": "list_entities",
+      "description": "List all entities in the workspace",
+      "parameters": {
+        "type": "object",
+        "properties": {},
+        "required": []
+      }
+    }
+  },
+  {
+    "type": "function",
+    "function": {
+      "name": "get_cap_table",
+      "description": "Get cap table for an entity",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "entity_id": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "entity_id"
+        ]
+      }
+    }
+  },
+  {
+    "type": "function",
+    "function": {
+      "name": "list_documents",
+      "description": "List documents for an entity",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "entity_id": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "entity_id"
+        ]
+      }
+    }
+  },
+  {
+    "type": "function",
+    "function": {
+      "name": "list_safe_notes",
+      "description": "List SAFE notes for an entity",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "entity_id": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "entity_id"
+        ]
+      }
+    }
+  },
+  {
+    "type": "function",
+    "function": {
+      "name": "list_agents",
+      "description": "List all agents in the workspace",
+      "parameters": {
+        "type": "object",
+        "properties": {},
+        "required": []
+      }
+    }
+  },
+  {
+    "type": "function",
+    "function": {
+      "name": "list_obligations",
+      "description": "List obligations with urgency tiers",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "tier": {
+            "type": "string"
+          }
+        },
+        "required": []
+      }
+    }
+  },
+  {
+    "type": "function",
+    "function": {
+      "name": "get_billing_status",
+      "description": "Get billing status and plans",
+      "parameters": {
+        "type": "object",
+        "properties": {},
+        "required": []
+      }
+    }
+  },
+  {
+    "type": "function",
+    "function": {
+      "name": "form_entity",
+      "description": "Form a new business entity (LLC or corporation)",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "entity_type": {
+            "type": "string",
+            "enum": [
+              "llc",
+              "corporation"
+            ]
+          },
+          "entity_name": {
+            "type": "string"
+          },
+          "jurisdiction": {
+            "type": "string"
+          },
+          "members": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "name": {
+                  "type": "string"
+                },
+                "investor_type": {
+                  "type": "string",
+                  "enum": [
+                    "natural_person",
+                    "agent",
+                    "entity"
+                  ]
+                },
+                "email": {
+                  "type": "string"
+                },
+                "agent_id": {
+                  "type": "string"
+                },
+                "entity_id": {
+                  "type": "string"
+                },
+                "ownership_pct": {
+                  "type": "number"
+                },
+                "membership_units": {
+                  "type": "integer"
+                },
+                "share_count": {
+                  "type": "integer"
+                },
+                "share_class": {
+                  "type": "string"
+                },
+                "role": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "name",
+                "investor_type"
+              ]
+            }
+          }
+        },
+        "required": [
+          "entity_type",
+          "entity_name",
+          "jurisdiction",
+          "members"
+        ]
+      }
+    }
+  },
+  {
+    "type": "function",
+    "function": {
+      "name": "issue_equity",
+      "description": "Issue an equity grant",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "entity_id": {
+            "type": "string"
+          },
+          "grant_type": {
+            "type": "string"
+          },
+          "shares": {
+            "type": "integer"
+          },
+          "recipient_name": {
+            "type": "string"
+          },
+          "vesting_schedule": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "entity_id",
+          "grant_type",
+          "shares",
+          "recipient_name"
+        ]
+      }
+    }
+  },
+  {
+    "type": "function",
+    "function": {
+      "name": "issue_safe",
+      "description": "Issue a SAFE note",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "entity_id": {
+            "type": "string"
+          },
+          "investor_name": {
+            "type": "string"
+          },
+          "principal_amount_cents": {
+            "type": "integer"
+          },
+          "safe_type": {
+            "type": "string"
+          },
+          "valuation_cap_cents": {
+            "type": "integer"
+          }
+        },
+        "required": [
+          "entity_id",
+          "investor_name",
+          "principal_amount_cents",
+          "safe_type",
+          "valuation_cap_cents"
+        ]
+      }
+    }
+  },
+  {
+    "type": "function",
+    "function": {
+      "name": "transfer_shares",
+      "description": "Transfer shares between holders",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "entity_id": {
+            "type": "string"
+          },
+          "share_class_id": {
+            "type": "string"
+          },
+          "from_holder": {
+            "type": "string"
+          },
+          "to_holder": {
+            "type": "string"
+          },
+          "transfer_type": {
+            "type": "string"
+          },
+          "shares": {
+            "type": "integer"
+          }
+        },
+        "required": [
+          "entity_id",
+          "from_holder",
+          "to_holder",
+          "shares"
+        ]
+      }
+    }
+  },
+  {
+    "type": "function",
+    "function": {
+      "name": "calculate_distribution",
+      "description": "Calculate a distribution",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "entity_id": {
+            "type": "string"
+          },
+          "total_amount_cents": {
+            "type": "integer"
+          },
+          "distribution_type": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "entity_id",
+          "total_amount_cents"
+        ]
+      }
+    }
+  },
+  {
+    "type": "function",
+    "function": {
+      "name": "create_invoice",
+      "description": "Create an invoice",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "entity_id": {
+            "type": "string"
+          },
+          "customer_name": {
+            "type": "string"
+          },
+          "amount_cents": {
+            "type": "integer"
+          },
+          "description": {
+            "type": "string"
+          },
+          "due_date": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "entity_id",
+          "customer_name",
+          "amount_cents",
+          "due_date"
+        ]
+      }
+    }
+  },
+  {
+    "type": "function",
+    "function": {
+      "name": "run_payroll",
+      "description": "Run payroll",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "entity_id": {
+            "type": "string"
+          },
+          "pay_period_start": {
+            "type": "string"
+          },
+          "pay_period_end": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "entity_id",
+          "pay_period_start",
+          "pay_period_end"
+        ]
+      }
+    }
+  },
+  {
+    "type": "function",
+    "function": {
+      "name": "submit_payment",
+      "description": "Submit a payment",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "entity_id": {
+            "type": "string"
+          },
+          "amount_cents": {
+            "type": "integer"
+          },
+          "recipient": {
+            "type": "string"
+          },
+          "description": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "entity_id",
+          "amount_cents",
+          "recipient"
+        ]
+      }
+    }
+  },
+  {
+    "type": "function",
+    "function": {
+      "name": "open_bank_account",
+      "description": "Open a business bank account",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "entity_id": {
+            "type": "string"
+          },
+          "institution_name": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "entity_id"
+        ]
+      }
+    }
+  },
+  {
+    "type": "function",
+    "function": {
+      "name": "generate_contract",
+      "description": "Generate a contract from a template",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "entity_id": {
+            "type": "string"
+          },
+          "template_type": {
+            "type": "string"
+          },
+          "parameters": {
+            "type": "object"
+          }
+        },
+        "required": [
+          "entity_id",
+          "template_type"
+        ]
+      }
+    }
+  },
+  {
+    "type": "function",
+    "function": {
+      "name": "file_tax_document",
+      "description": "File a tax document",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "entity_id": {
+            "type": "string"
+          },
+          "document_type": {
+            "type": "string"
+          },
+          "tax_year": {
+            "type": "integer"
+          }
+        },
+        "required": [
+          "entity_id",
+          "document_type",
+          "tax_year"
+        ]
+      }
+    }
+  },
+  {
+    "type": "function",
+    "function": {
+      "name": "track_deadline",
+      "description": "Track a compliance deadline",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "entity_id": {
+            "type": "string"
+          },
+          "deadline_type": {
+            "type": "string"
+          },
+          "due_date": {
+            "type": "string"
+          },
+          "description": {
+            "type": "string"
+          },
+          "recurrence": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "entity_id",
+          "deadline_type",
+          "due_date",
+          "description"
+        ]
+      }
+    }
+  },
+  {
+    "type": "function",
+    "function": {
+      "name": "classify_contractor",
+      "description": "Classify contractor risk",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "entity_id": {
+            "type": "string"
+          },
+          "contractor_name": {
+            "type": "string"
+          },
+          "state": {
+            "type": "string"
+          },
+          "hours_per_week": {
+            "type": "integer"
+          },
+          "exclusive_client": {
+            "type": "boolean"
+          },
+          "duration_months": {
+            "type": "integer"
+          },
+          "provides_tools": {
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "entity_id",
+          "contractor_name",
+          "state",
+          "hours_per_week"
+        ]
+      }
+    }
+  },
+  {
+    "type": "function",
+    "function": {
+      "name": "reconcile_ledger",
+      "description": "Reconcile an entity's ledger",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "entity_id": {
+            "type": "string"
+          },
+          "start_date": {
+            "type": "string"
+          },
+          "end_date": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "entity_id",
+          "start_date",
+          "end_date"
+        ]
+      }
+    }
+  },
+  {
+    "type": "function",
+    "function": {
+      "name": "convene_meeting",
+      "description": "Convene a governance meeting",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "meeting_type": {
+            "type": "string"
+          },
+          "title": {
+            "type": "string"
+          },
+          "agenda_item_titles": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "entity_id": {
+            "type": "string"
+          },
+          "governance_body_id": {
+            "type": "string"
+          },
+          "scheduled_date": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "entity_id",
+          "governance_body_id",
+          "meeting_type",
+          "title",
+          "scheduled_date"
+        ]
+      }
+    }
+  },
+  {
+    "type": "function",
+    "function": {
+      "name": "cast_vote",
+      "description": "Cast a vote on an agenda item",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "meeting_id": {
+            "type": "string"
+          },
+          "agenda_item_id": {
+            "type": "string"
+          },
+          "voter_id": {
+            "type": "string"
+          },
+          "vote": {
+            "type": "string",
+            "description": "for, against, abstain, or recusal"
+          }
+        },
+        "required": [
+          "meeting_id",
+          "agenda_item_id",
+          "voter_id",
+          "vote"
+        ]
+      }
+    }
+  },
+  {
+    "type": "function",
+    "function": {
+      "name": "schedule_meeting",
+      "description": "Schedule a board or member meeting",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "body_id": {
+            "type": "string"
+          },
+          "meeting_type": {
+            "type": "string"
+          },
+          "title": {
+            "type": "string"
+          },
+          "proposed_date": {
+            "type": "string"
+          },
+          "agenda_items": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
+        },
+        "required": [
+          "body_id",
+          "meeting_type",
+          "title",
+          "proposed_date"
+        ]
+      }
+    }
+  },
+  {
+    "type": "function",
+    "function": {
+      "name": "get_signer_link",
+      "description": "Generate a signing link for a human obligation",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "obligation_id": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "obligation_id"
+        ]
+      }
+    }
+  },
+  {
+    "type": "function",
+    "function": {
+      "name": "get_document_link",
+      "description": "Get a download link for a document",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "document_id": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "document_id"
+        ]
+      }
+    }
+  },
+  {
+    "type": "function",
+    "function": {
+      "name": "convert_entity",
+      "description": "Convert entity type",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "entity_id": {
+            "type": "string"
+          },
+          "new_entity_type": {
+            "type": "string"
+          },
+          "new_jurisdiction": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "entity_id",
+          "new_entity_type"
+        ]
+      }
+    }
+  },
+  {
+    "type": "function",
+    "function": {
+      "name": "dissolve_entity",
+      "description": "Dissolve an entity",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "entity_id": {
+            "type": "string"
+          },
+          "reason": {
+            "type": "string"
+          },
+          "effective_date": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "entity_id",
+          "reason"
+        ]
+      }
+    }
+  },
+  {
+    "type": "function",
+    "function": {
+      "name": "add_agent_skill",
+      "description": "Add a skill to an agent",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "agent_id": {
+            "type": "string"
+          },
+          "skill_name": {
+            "type": "string"
+          },
+          "description": {
+            "type": "string"
+          },
+          "instructions": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "agent_id",
+          "skill_name",
+          "description"
+        ]
+      }
+    }
+  },
+  {
+    "type": "function",
+    "function": {
+      "name": "get_checklist",
+      "description": "Get the user's onboarding checklist",
+      "parameters": {
+        "type": "object",
+        "properties": {},
+        "required": []
+      }
+    }
+  },
+  {
+    "type": "function",
+    "function": {
+      "name": "update_checklist",
+      "description": "Update the user's onboarding checklist",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "checklist": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "checklist"
+        ]
+      }
+    }
+  },
+  {
+    "type": "function",
+    "function": {
+      "name": "get_signing_link",
+      "description": "Get a signing link for a document",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "document_id": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "document_id"
+        ]
+      }
+    }
+  },
+  {
+    "type": "function",
+    "function": {
+      "name": "create_agent",
+      "description": "Create a new agent",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string"
+          },
+          "system_prompt": {
+            "type": "string"
+          },
+          "model": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "name",
+          "system_prompt"
+        ]
+      }
+    }
+  },
+  {
+    "type": "function",
+    "function": {
+      "name": "send_agent_message",
+      "description": "Send a message to an agent",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "agent_id": {
+            "type": "string"
+          },
+          "body": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "agent_id",
+          "body"
+        ]
+      }
+    }
+  },
+  {
+    "type": "function",
+    "function": {
+      "name": "update_agent",
+      "description": "Update an agent",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "agent_id": {
+            "type": "string"
+          },
+          "status": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "agent_id"
+        ]
+      }
+    }
+  }
+];
+
+// src/tools.ts
+var TOOL_HANDLERS = {
+  get_workspace_status: async (_args, client) => client.getStatus(),
+  list_obligations: async (args, client) => client.getObligations(args.tier),
+  list_entities: async (_args, client) => client.listEntities(),
+  get_cap_table: async (args, client) => client.getCapTable(args.entity_id),
+  list_documents: async (args, client) => client.getEntityDocuments(args.entity_id),
+  list_safe_notes: async (args, client) => client.getSafeNotes(args.entity_id),
+  list_agents: async (_args, client) => client.listAgents(),
+  get_billing_status: async (_args, client) => {
+    const [status, plans] = await Promise.all([client.getBillingStatus(), client.getBillingPlans()]);
+    return { status, plans };
+  },
+  form_entity: async (args, client, ctx) => {
+    const entityType = args.entity_type;
+    let jurisdiction = args.jurisdiction || "";
+    if (!jurisdiction || jurisdiction.length === 2) {
+      jurisdiction = entityType === "llc" ? "US-WY" : "US-DE";
+    }
+    const members = args.members ?? [];
+    if (!members.length) return { error: "Members are required." };
+    for (const m of members) {
+      if (!m.investor_type) m.investor_type = "natural_person";
+      if (typeof m.ownership_pct === "number" && m.ownership_pct > 1) {
+        m.ownership_pct = m.ownership_pct / 100;
+      }
+    }
+    const result = await client.createFormation({
+      entity_type: entityType,
+      legal_name: args.entity_name,
+      jurisdiction,
+      members,
+      workspace_id: client.workspaceId
+    });
+    const entityId = result.entity_id;
+    if (entityId && ctx.onEntityFormed) {
+      ctx.onEntityFormed(entityId);
+    }
+    return result;
+  },
+  issue_equity: async (args, client) => client.issueEquity(args),
+  issue_safe: async (args, client) => client.issueSafe(args),
+  create_invoice: async (args, client) => {
+    if (!("amount_cents" in args) && Array.isArray(args.line_items)) {
+      args.amount_cents = args.line_items.reduce((sum, item) => sum + (item.amount_cents ?? 0), 0);
+    }
+    if (!("amount_cents" in args)) args.amount_cents = 0;
+    return client.createInvoice(args);
+  },
+  run_payroll: async (args, client) => client.runPayroll(args),
+  submit_payment: async (args, client) => client.submitPayment(args),
+  open_bank_account: async (args, client) => {
+    const body = { entity_id: args.entity_id };
+    if (args.institution_name) body.institution_name = args.institution_name;
+    return client.openBankAccount(body);
+  },
+  generate_contract: async (args, client) => client.generateContract(args),
+  file_tax_document: async (args, client) => client.fileTaxDocument(args),
+  get_signer_link: async (args, client) => {
+    const result = await client.getSignerToken(args.obligation_id);
+    const token = result.token ?? "";
+    const obligationId = args.obligation_id;
+    const humansBase = client.apiUrl.replace("://api.", "://humans.");
+    return {
+      signer_url: `${humansBase}/human/${obligationId}?token=${token}`,
+      obligation_id: obligationId,
+      expires_in_seconds: result.expires_in ?? 900,
+      message: "Share this link with the signer. Link expires in 15 minutes."
+    };
+  },
+  schedule_meeting: async (args, client) => {
+    const body = {
+      body_id: args.body_id,
+      meeting_type: args.meeting_type,
+      title: args.title,
+      proposed_date: args.proposed_date
+    };
+    if (args.agenda_items) body.agenda_item_titles = args.agenda_items;
+    return client.conveneMeeting(body);
+  },
+  cast_vote: async (args, client) => client.castVote(args.meeting_id, args.agenda_item_id, {
+    voter_id: args.voter_id,
+    vote_value: args.vote
+  }),
+  update_checklist: async (args, _client, ctx) => {
+    const path = join(ctx.dataDir, "checklist.md");
+    mkdirSync(ctx.dataDir, { recursive: true });
+    writeFileSync(path, args.checklist);
+    return { status: "updated", checklist: args.checklist };
+  },
+  get_checklist: async (_args, _client, ctx) => {
+    const path = join(ctx.dataDir, "checklist.md");
+    if (existsSync(path)) return { checklist: readFileSync(path, "utf-8") };
+    return { checklist: null, message: "No checklist yet." };
+  },
+  get_document_link: async (args, client) => {
+    const docId = args.document_id;
+    try {
+      const resp = await fetch(`${client.apiUrl}/v1/documents/${docId}/request-copy`, {
+        method: "POST",
+        headers: { Authorization: `Bearer ${client.apiKey}`, "Content-Type": "application/json" },
+        body: JSON.stringify({ email: "owner@workspace" })
+      });
+      if (!resp.ok) throw new Error("request-copy failed");
+      const result = await resp.json();
+      let downloadUrl = result.download_url ?? "";
+      if (downloadUrl.startsWith("/")) downloadUrl = client.apiUrl + downloadUrl;
+      return { document_id: docId, download_url: downloadUrl, expires_in: "24 hours" };
+    } catch {
+      return {
+        document_id: docId,
+        download_url: `${client.apiUrl}/v1/documents/${docId}/pdf`,
+        note: "Use your API key to authenticate the download."
+      };
+    }
+  },
+  get_signing_link: async (args, client) => client.getSigningLink(args.document_id),
+  convert_entity: async (args, client) => client.convertEntity(args.entity_id, args),
+  dissolve_entity: async (args, client) => client.dissolveEntity(args.entity_id, args),
+  transfer_shares: async (args, client) => client.transferShares(args),
+  calculate_distribution: async (args, client) => client.calculateDistribution(args),
+  classify_contractor: async (args, client) => client.classifyContractor(args),
+  reconcile_ledger: async (args, client) => client.reconcileLedger(args),
+  track_deadline: async (args, client) => client.trackDeadline(args),
+  convene_meeting: async (args, client) => client.conveneMeeting(args),
+  create_agent: async (args, client) => client.createAgent(args),
+  send_agent_message: async (args, client) => client.sendAgentMessage(args.agent_id, args.body),
+  update_agent: async (args, client) => client.updateAgent(args.agent_id, args),
+  add_agent_skill: async (args, client) => client.addAgentSkill(args.agent_id, args)
+};
+var TOOL_DEFINITIONS = GENERATED_TOOL_DEFINITIONS;
+var READ_ONLY_TOOLS = /* @__PURE__ */ new Set([
+  "get_workspace_status",
+  "list_entities",
+  "get_cap_table",
+  "list_documents",
+  "list_safe_notes",
+  "list_agents",
+  "get_checklist",
+  "get_document_link",
+  "get_signing_link",
+  "list_obligations",
+  "get_billing_status"
+]);
+function isWriteTool(name) {
+  return !READ_ONLY_TOOLS.has(name);
+}
+async function executeTool(name, args, client, ctx) {
+  const handler = TOOL_HANDLERS[name];
+  if (!handler) return JSON.stringify({ error: `Unknown tool: ${name}` });
+  try {
+    const result = await handler(args, client, ctx);
+    return JSON.stringify(result, null, 0);
+  } catch (err) {
+    return JSON.stringify({ error: String(err) });
+  }
+}
+
+// src/tool-descriptions.ts
+function centsToUsd(cents) {
+  return "$" + (cents / 100).toLocaleString("en-US", { minimumFractionDigits: 0, maximumFractionDigits: 0 });
+}
+function describeToolCall(name, args) {
+  const a = { ...args };
+  for (const k of ["amount_cents", "principal_amount_cents", "total_amount_cents", "valuation_cap_cents"]) {
+    if (k in a) {
+      try {
+        a._amount = centsToUsd(Number(a[k]));
+      } catch {
+        a._amount = String(a[k]);
+      }
+    }
+  }
+  a._amount ??= "?";
+  a.institution_name ??= "Mercury";
+  a.payment_method ??= "ach";
+  const fmts = {
+    form_entity: 'Form a new {entity_type} named "{entity_name}" in {jurisdiction}',
+    convert_entity: "Convert entity to {new_entity_type}",
+    dissolve_entity: "Dissolve entity \u2014 {dissolution_reason}",
+    issue_equity: "Issue {shares} {grant_type} shares to {recipient_name}",
+    transfer_shares: "Transfer {shares} shares to {to_recipient_name}",
+    issue_safe: "Issue SAFE note to {investor_name} for {_amount}",
+    calculate_distribution: "Calculate {distribution_type} distribution of {_amount}",
+    create_invoice: "Create invoice for {customer_name} \u2014 {_amount}",
+    run_payroll: "Run payroll for {pay_period_start} to {pay_period_end}",
+    submit_payment: "Submit {_amount} payment to {recipient} via {payment_method}",
+    open_bank_account: "Open bank account at {institution_name}",
+    reconcile_ledger: "Reconcile ledger from {start_date} to {end_date}",
+    generate_contract: "Generate {template_type} contract for {counterparty_name}",
+    file_tax_document: "File {document_type} for tax year {tax_year}",
+    track_deadline: "Track {deadline_type} deadline \u2014 {description}",
+    classify_contractor: "Classify contractor {contractor_name} in {state}",
+    convene_meeting: "Convene {meeting_type} meeting",
+    cast_vote: "Cast {vote} vote",
+    schedule_meeting: "Schedule {meeting_type} meeting: {title}",
+    update_checklist: "Update workspace checklist",
+    create_agent: 'Create agent "{name}"',
+    send_agent_message: "Send message to agent",
+    update_agent: "Update agent configuration",
+    add_agent_skill: 'Add skill "{skill_name}" to agent'
+  };
+  const fmt = fmts[name];
+  if (fmt) {
+    try {
+      return fmt.replace(/\{(\w+)\}/g, (_, k) => String(a[k] ?? "?"));
+    } catch {
+    }
+  }
+  return name.replace(/_/g, " ");
+}
+
+// src/system-prompt.ts
+var SYSTEM_PROMPT_BASE = `You are a corporate governance assistant for TheCorporation, an agentic corporate governance platform.
+
+## Context
+{context}
+
+## Capabilities
+You can perform the full range of corporate operations:
+
+**Read operations:**
+- View workspace status, entities, cap tables, documents
+- List SAFE notes, equity grants, agents
+- Check deadlines and compliance status
+
+**Write operations:**
+- Form new LLCs and corporations in any US jurisdiction
+- Issue equity (common, preferred, options, units)
+- Issue SAFE notes to investors
+- Transfer shares between holders
+- Convert entities (LLC <> Corporation)
+- Create invoices, run payroll, submit payments
+- Open bank accounts, reconcile ledgers
+- Generate contracts (NDAs, employment offers, consulting agreements)
+- File tax documents (1099-NEC, K-1, 941, W-2, estimated tax)
+- Generate signing links for documents (human-only signing)
+- Track compliance deadlines
+- Classify contractor risk (employee vs 1099)
+- Convene governance meetings and cast votes
+- Dissolve entities with full wind-down workflow
+
+## Rules
+- All monetary values are in integer cents ($1,000 = 100000).
+- Be concise and helpful.
+- **You MUST confirm with the user before calling ANY write tool.** Describe what you are about to do and wait for explicit approval. Never execute tools speculatively or "on behalf of" the user without their go-ahead.
+- Don't ask for info available in platform config \u2014 use the correct values automatically.
+- If only one option exists for a field, use it without asking.
+- Don't make up data \u2014 only present what the tools return.
+- If a tool returns an error, explain it simply without exposing raw error details.
+- NEVER create an agent to answer a question you can answer yourself. You are the assistant \u2014 answer questions directly using your knowledge and the read tools.
+
+## Agent Rules
+- Agents are for **delegating recurring corporate operations tasks** that the user explicitly requests \u2014 e.g. "process incoming invoices", "monitor compliance deadlines", "handle payroll every two weeks".
+- Agents are NOT for research, answering questions, or one-off lookups. If the user asks a question, YOU answer it.
+- NEVER proactively suggest or create an agent unless the user specifically asks for one.
+- Agent tools require a paid plan.
+
+## Entity Formation Rules
+- When forming an entity, you MUST ask about all founding members and their ownership allocations BEFORE calling the form_entity tool.
+- For LLCs, ownership percentages must total 100%.
+
+## Document Signing Rules
+- You CANNOT sign documents on behalf of users. Signing is a human action.
+- Use \`get_signing_link\` to generate a signing URL for a document.
+- Present the signing link so users can open it and sign themselves.
+- NEVER attempt to sign, execute, or complete signature actions automatically.
+- The \`get_signing_link\` tool does NOT sign anything \u2014 it only returns a URL.
+
+## User Journey
+After completing any action, ALWAYS present the logical next step(s) as a
+numbered list. The user should never wonder "what now?" \u2014 guide them forward.
+
+After entity formation:
+1. The \`form_entity\` response includes a \`documents\` array with document IDs. These documents are created immediately \u2014 they are NEVER "still being generated" or delayed.
+2. Immediately call \`get_signing_link\` for each document ID in the response to get signing URLs.
+3. Present the signing links to the user right away. Do NOT tell the user to "check back later" or that documents are "being prepared" \u2014 they already exist.
+4. Then: "Documents signed! Next: apply for an EIN, open a bank account, or issue equity."
+
+After document generation:
+1. Present signing links immediately \u2014 don't wait for the user to ask.
+2. Use the document IDs from the tool response \u2014 do NOT call \`list_documents\` to re-fetch them.
+
+After signing:
+1. "Documents are signed! Next: file for EIN, open a bank account, or add team members."
+
+After equity issuance:
+1. "Equity issued! Next: generate the stock certificate for signing, or issue more grants."
+
+General pattern:
+- Always end with 1-2 concrete next actions the user can take.
+- Phrase them as questions or suggestions: "Would you like to [next step]?"
+- If there are signing obligations, proactively generate and present the signing links.
+- Never just say "done" \u2014 always show what comes next.
+
+After major actions, use update_checklist to track progress. Use markdown checkbox
+format (- [x] / - [ ]). Call get_checklist first to see current state, then
+update_checklist with checked-off items. This helps users see where they are.
+
+{extra_sections}`;
+function formatConfigSection(cfgData) {
+  const lines = [];
+  const entityTypes = cfgData.entity_types;
+  if (entityTypes?.length) {
+    const vals = entityTypes.map((t) => `"${t.value}"`).join(", ");
+    lines.push(`Entity types: ${vals}`);
+  }
+  const jurisdictions = cfgData.jurisdictions;
+  if (jurisdictions) {
+    for (const [etype, jurs] of Object.entries(jurisdictions)) {
+      const jurVals = jurs.map((j) => `${j.label} (${j.value})`).join(", ");
+      lines.push(`Jurisdictions for ${etype}: ${jurVals}`);
+    }
+  }
+  const invTypes = cfgData.investor_types;
+  if (invTypes?.length) {
+    const vals = invTypes.map((t) => `"${t.value}"`).join(", ");
+    lines.push(`Investor types: ${vals}`);
+  }
+  const workers = cfgData.worker_classifications;
+  if (workers?.length) {
+    const vals = workers.map((t) => `"${t.value}"`).join(", ");
+    lines.push(`Worker classifications: ${vals}`);
+  }
+  const vesting = cfgData.vesting_schedules;
+  if (vesting?.length) {
+    const vals = vesting.map((t) => `${t.label} (${t.value})`).join(", ");
+    lines.push(`Vesting schedules: ${vals}`);
+  }
+  const safeTypes = cfgData.safe_types;
+  if (safeTypes?.length) {
+    const vals = safeTypes.map((t) => `"${t.value}"`).join(", ");
+    lines.push(`SAFE types: ${vals}`);
+  }
+  const compTypes = cfgData.compensation_types;
+  if (compTypes?.length) {
+    const vals = compTypes.map((t) => `${t.label} (${t.value})`).join(", ");
+    lines.push(`Compensation types: ${vals}`);
+  }
+  const bodyTypes = cfgData.governance_body_types;
+  if (bodyTypes?.length) {
+    const vals = bodyTypes.map((t) => `"${t.value}"`).join(", ");
+    lines.push(`Governance body types: ${vals}`);
+  }
+  const quorum = cfgData.quorum_rules;
+  if (quorum?.length) {
+    const vals = quorum.map((t) => `"${t.value}"`).join(", ");
+    lines.push(`Quorum rules: ${vals}`);
+  }
+  const voting = cfgData.voting_methods;
+  if (voting?.length) {
+    const vals = voting.map((t) => `${t.label} (${t.value})`).join(", ");
+    lines.push(`Voting methods: ${vals}`);
+  }
+  if (!lines.length) return "";
+  const configYaml = lines.map((line) => `- ${line}`).join("\n");
+  return "\n## Platform Configuration\nThe following are the ONLY valid values supported by this platform. Do not offer or accept values outside these lists.\n\n" + configYaml + "\n";
+}
+
+// src/definitions.ts
+var TOOL_REGISTRY = {};
+for (const td of GENERATED_TOOL_DEFINITIONS) {
+  TOOL_REGISTRY[td.function.name] = td.function;
+}
+var READ_ONLY_TOOLS2 = /* @__PURE__ */ new Set([
+  "get_workspace_status",
+  "list_entities",
+  "get_cap_table",
+  "list_documents",
+  "list_safe_notes",
+  "list_agents",
+  "get_checklist",
+  "get_document_link",
+  "get_signing_link",
+  "list_obligations",
+  "get_billing_status"
+]);
+export {
+  CorpAPIClient,
+  GENERATED_TOOL_DEFINITIONS,
+  READ_ONLY_TOOLS2 as READ_ONLY_TOOLS,
+  SYSTEM_PROMPT_BASE,
+  SessionExpiredError,
+  TOOL_DEFINITIONS,
+  TOOL_REGISTRY,
+  describeToolCall,
+  executeTool,
+  formatConfigSection,
+  isWriteTool,
+  provisionWorkspace
+};
+//# sourceMappingURL=index.js.map