@thecorporation/corp-tools 26.3.24 → 26.3.32

package/dist/browser.js

@@ -0,0 +1,1518 @@
+// src/process-transport.ts
+import { execFileSync } from "child_process";
+import { existsSync as existsSync2, readFileSync as readFileSync2 } from "fs";
+import { resolve, join } from "path";
+import { homedir } from "os";
+import { createRequire } from "module";
+
+// src/env.ts
+import { readFileSync, writeFileSync, existsSync } from "fs";
+import { randomBytes } from "crypto";
+var ENV_TEMPLATE = `# Corporation API server configuration
+# Generated by: corp serve
+
+# Required \u2014 secret for signing JWTs
+JWT_SECRET={{JWT_SECRET}}
+
+# Required \u2014 Fernet key for encrypting secrets at rest (base64url, 32 bytes)
+SECRETS_MASTER_KEY={{SECRETS_MASTER_KEY}}
+
+# Required \u2014 bearer token for internal worker-to-server auth
+INTERNAL_WORKER_TOKEN={{INTERNAL_WORKER_TOKEN}}
+
+# Server port (default: 8000)
+# PORT=8000
+
+# Data directory for git repos (default: ./data/repos)
+# DATA_DIR=./data/repos
+
+# Redis URL for agent job queue (optional)
+# REDIS_URL=redis://localhost:6379/0
+
+# LLM proxy upstream (default: https://openrouter.ai/api/v1)
+# LLM_UPSTREAM_URL=https://openrouter.ai/api/v1
+
+# PEM-encoded Ed25519 key for signing git commits (optional)
+# COMMIT_SIGNING_KEY=
+
+# Max agent queue depth (default: 1000)
+# MAX_QUEUE_DEPTH=1000
+`;
+function generateFernetKey() {
+  return randomBytes(32).toString("base64url") + "=";
+}
+function generateSecret(length = 32) {
+  return randomBytes(length).toString("hex");
+}
+function loadEnvFile(path) {
+  if (!existsSync(path)) return;
+  const content = readFileSync(path, "utf-8");
+  for (const line of content.split("\n")) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith("#")) continue;
+    const eqIdx = trimmed.indexOf("=");
+    if (eqIdx === -1) continue;
+    const key = trimmed.slice(0, eqIdx).trim();
+    const value = trimmed.slice(eqIdx + 1).trim().replace(/^["']|["']$/g, "");
+    if (!process.env[key]) {
+      process.env[key] = value;
+    }
+  }
+}
+function ensureEnvFile(envPath) {
+  if (existsSync(envPath)) return;
+  console.log("No .env file found. Generating one with dev defaults...\n");
+  const content = ENV_TEMPLATE.replace("{{JWT_SECRET}}", generateSecret()).replace("{{SECRETS_MASTER_KEY}}", generateFernetKey()).replace("{{INTERNAL_WORKER_TOKEN}}", generateSecret());
+  writeFileSync(envPath, content, "utf-8");
+  console.log(`  Created ${envPath}
+`);
+}
+
+// src/process-transport.ts
+var require2 = createRequire(import.meta.url);
+var cachedBinaryPath;
+function resolveBinaryPath(processUrl) {
+  if (cachedBinaryPath !== void 0) return cachedBinaryPath;
+  const parsed = new URL(processUrl);
+  if (parsed.pathname && parsed.pathname !== "/") {
+    cachedBinaryPath = parsed.pathname;
+    return cachedBinaryPath;
+  }
+  const envBin = process.env.CORP_SERVER_BIN;
+  if (envBin && existsSync2(envBin)) {
+    cachedBinaryPath = envBin;
+    return cachedBinaryPath;
+  }
+  try {
+    const server = require2("@thecorporation/server");
+    const pkgPath = server.getBinaryPath?.();
+    if (pkgPath) {
+      cachedBinaryPath = pkgPath;
+      return pkgPath;
+    }
+  } catch {
+  }
+  cachedBinaryPath = resolve("services/api-rs/target/release/api-rs");
+  return cachedBinaryPath;
+}
+function parseStatusFromStderr(stderr) {
+  const lines = stderr.split("\n");
+  for (let i = lines.length - 1; i >= 0; i--) {
+    const match = lines[i].match(/^HTTP (\d+)$/);
+    if (match) return parseInt(match[1], 10);
+  }
+  return null;
+}
+var STATUS_TEXT = {
+  200: "OK",
+  201: "Created",
+  204: "No Content",
+  400: "Bad Request",
+  401: "Unauthorized",
+  403: "Forbidden",
+  404: "Not Found",
+  409: "Conflict",
+  422: "Unprocessable Entity",
+  500: "Internal Server Error"
+};
+function buildProcessResponse(status, body) {
+  return {
+    status,
+    ok: status >= 200 && status < 300,
+    statusText: STATUS_TEXT[status] ?? String(status),
+    headers: new Headers({ "content-type": "application/json" }),
+    json: async () => JSON.parse(body),
+    text: async () => body,
+    body: null,
+    bodyUsed: false,
+    redirected: false,
+    type: "basic",
+    url: "",
+    clone: () => buildProcessResponse(status, body),
+    arrayBuffer: async () => new TextEncoder().encode(body).buffer,
+    blob: async () => new Blob([body]),
+    formData: async () => {
+      throw new Error("not supported");
+    },
+    bytes: async () => new TextEncoder().encode(body)
+  };
+}
+var CORP_CONFIG_DIR = process.env.CORP_CONFIG_DIR || join(homedir(), ".corp");
+function readJsonFileSafe(path) {
+  try {
+    if (!existsSync2(path)) return null;
+    return JSON.parse(readFileSync2(path, "utf-8"));
+  } catch {
+    return null;
+  }
+}
+function loadServerSecretsFromAuth() {
+  const auth = readJsonFileSafe(join(CORP_CONFIG_DIR, "auth.json"));
+  if (!auth) return null;
+  const ss = auth.server_secrets;
+  if (!ss || typeof ss !== "object") return null;
+  const s = ss;
+  if (typeof s.jwt_secret === "string" && typeof s.secrets_master_key === "string" && typeof s.internal_worker_token === "string") {
+    return { jwt_secret: s.jwt_secret, secrets_master_key: s.secrets_master_key, internal_worker_token: s.internal_worker_token };
+  }
+  return null;
+}
+function loadDataDirFromConfig() {
+  const cfg = readJsonFileSafe(join(CORP_CONFIG_DIR, "config.json"));
+  if (!cfg) return void 0;
+  const dataDir = typeof cfg.data_dir === "string" ? cfg.data_dir : void 0;
+  return dataDir || void 0;
+}
+var envLoaded = false;
+function ensureEnv() {
+  if (envLoaded) return;
+  const secrets = loadServerSecretsFromAuth();
+  if (secrets) {
+    if (!process.env.JWT_SECRET) process.env.JWT_SECRET = secrets.jwt_secret;
+    if (!process.env.SECRETS_MASTER_KEY) process.env.SECRETS_MASTER_KEY = secrets.secrets_master_key;
+    if (!process.env.INTERNAL_WORKER_TOKEN) process.env.INTERNAL_WORKER_TOKEN = secrets.internal_worker_token;
+    envLoaded = true;
+    return;
+  }
+  const envPath = resolve(process.cwd(), ".env");
+  ensureEnvFile(envPath);
+  loadEnvFile(envPath);
+  envLoaded = true;
+}
+function processRequest(processUrl, method, pathWithQuery, headers, body, options) {
+  ensureEnv();
+  const binPath = resolveBinaryPath(processUrl);
+  const args = ["--skip-validation", "call"];
+  const dataDir = options?.dataDir ?? loadDataDirFromConfig();
+  if (dataDir) {
+    args.push("--data-dir", dataDir);
+  }
+  args.push(method, pathWithQuery);
+  for (const [key, value] of Object.entries(headers)) {
+    args.push("-H", `${key}: ${value}`);
+  }
+  if (body) {
+    args.push("--stdin");
+  }
+  try {
+    const stdout = execFileSync(binPath, args, {
+      input: body ?? void 0,
+      stdio: ["pipe", "pipe", "pipe"],
+      maxBuffer: 10 * 1024 * 1024,
+      env: process.env
+    });
+    return buildProcessResponse(200, stdout.toString("utf-8"));
+  } catch (err) {
+    const execErr = err;
+    if (execErr.stdout === void 0 && execErr.stderr === void 0) {
+      throw new Error(
+        `No api-rs binary found. Install @thecorporation/server or set CORP_SERVER_BIN.
+Attempted: ${binPath}
+Error: ${execErr.message ?? String(err)}`
+      );
+    }
+    const stderr = execErr.stderr?.toString("utf-8") ?? "";
+    const stdout = execErr.stdout?.toString("utf-8") ?? "";
+    const status = parseStatusFromStderr(stderr);
+    if (status !== null) {
+      return buildProcessResponse(status, stdout);
+    }
+    const isConfigError = stderr.includes("panic") || stderr.includes("INTERNAL_WORKER_TOKEN") || stderr.includes("JWT_SECRET") || stderr.includes("SECRETS_MASTER_KEY");
+    if (isConfigError) {
+      throw new Error("Server configuration incomplete. Run 'corp setup' to configure local mode.");
+    }
+    throw new Error(`api-rs process failed:
+${stderr || stdout || String(err)}`);
+  }
+}
+
+// src/api-client.ts
+var SessionExpiredError = class extends Error {
+  constructor(detail) {
+    super(detail || "Your API key is no longer valid. Run 'corp setup' to re-authenticate.");
+    this.name = "SessionExpiredError";
+  }
+};
+var MAX_ERROR_DETAIL_LEN = 500;
+function sanitizeErrorDetail(value) {
+  const sanitized = value.replace(/[\u0000-\u001f\u007f-\u009f\u001b]/g, " ").replace(/\s+/g, " ").trim();
+  if (!sanitized) {
+    return "request failed";
+  }
+  return sanitized.length > MAX_ERROR_DETAIL_LEN ? `${sanitized.slice(0, MAX_ERROR_DETAIL_LEN)}...` : sanitized;
+}
+function pathSegment(value) {
+  return encodeURIComponent(String(value));
+}
+async function extractErrorMessage(resp) {
+  try {
+    const text = await resp.text();
+    try {
+      const json = JSON.parse(text);
+      const val = json.error || json.message || json.detail;
+      if (val == null) return sanitizeErrorDetail(text);
+      return sanitizeErrorDetail(typeof val === "string" ? val : JSON.stringify(val));
+    } catch {
+      return sanitizeErrorDetail(text);
+    }
+  } catch {
+    return sanitizeErrorDetail(resp.statusText);
+  }
+}
+var CorpAPIClient = class {
+  apiUrl;
+  apiKey;
+  workspaceId;
+  constructor(apiUrl, apiKey, workspaceId) {
+    this.apiUrl = apiUrl.startsWith("process://") ? 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 fullPath = path;
+    if (params) {
+      const qs = new URLSearchParams(params).toString();
+      if (qs) fullPath += `?${qs}`;
+    }
+    if (this.apiUrl.startsWith("process://")) {
+      const hdrs = this.headers();
+      const bodyStr = body !== void 0 ? JSON.stringify(body) : void 0;
+      return processRequest(this.apiUrl, method, fullPath, hdrs, bodyStr);
+    }
+    const url = `${this.apiUrl}${fullPath}`;
+    const opts = { method, headers: this.headers() };
+    if (body !== void 0) opts.body = JSON.stringify(body);
+    return fetch(url, opts);
+  }
+  async throwIfError(resp) {
+    if (!resp.ok) {
+      const detail = await extractErrorMessage(resp);
+      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) {
+    const resp = await this.request("GET", path, void 0, params);
+    await this.throwIfError(resp);
+    return resp.json();
+  }
+  async post(path, body) {
+    const resp = await this.request("POST", path, body);
+    await this.throwIfError(resp);
+    return resp.json();
+  }
+  async postWithParams(path, body, params) {
+    const resp = await this.request("POST", path, body, params);
+    await this.throwIfError(resp);
+    return resp.json();
+  }
+  async patch(path, body) {
+    const resp = await this.request("PATCH", path, body);
+    await this.throwIfError(resp);
+    return resp.json();
+  }
+  async del(path) {
+    const resp = await this.request("DELETE", path);
+    await this.throwIfError(resp);
+  }
+  /** Public generic GET for declarative/registry-driven commands. */
+  async fetchJSON(path, params) {
+    return this.get(path, params);
+  }
+  /** Public generic request for declarative/registry-driven write commands. */
+  async submitJSON(method, path, body) {
+    const resp = await this.request(method, path, body);
+    await this.throwIfError(resp);
+    const text = await resp.text();
+    if (!text) return {};
+    return JSON.parse(text);
+  }
+  // --- Workspace ---
+  getStatus() {
+    return this.get(`/v1/workspaces/${pathSegment(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/${pathSegment(key)}`);
+  }
+  // --- References ---
+  syncReferences(kind, items, entityId) {
+    const body = { kind, items };
+    if (entityId) body.entity_id = entityId;
+    return this.post("/v1/references/sync", body);
+  }
+  // --- Entities ---
+  listEntities() {
+    return this.get("/v1/entities");
+  }
+  // --- Contacts ---
+  listContacts(entityId) {
+    return this.get(`/v1/entities/${pathSegment(entityId)}/contacts`);
+  }
+  getContact(id, entityId) {
+    return this.get(`/v1/contacts/${pathSegment(id)}`, { entity_id: entityId });
+  }
+  getContactProfile(id, entityId) {
+    return this.get(`/v1/contacts/${pathSegment(id)}/profile`, { entity_id: entityId });
+  }
+  createContact(data) {
+    return this.post("/v1/contacts", data);
+  }
+  updateContact(id, data) {
+    return this.patch(`/v1/contacts/${pathSegment(id)}`, data);
+  }
+  getNotificationPrefs(contactId) {
+    return this.get(`/v1/contacts/${pathSegment(contactId)}/notification-prefs`);
+  }
+  updateNotificationPrefs(contactId, prefs) {
+    return this.patch(`/v1/contacts/${pathSegment(contactId)}/notification-prefs`, prefs);
+  }
+  // --- Cap Table ---
+  getCapTable(entityId) {
+    return this.get(`/v1/entities/${pathSegment(entityId)}/cap-table`);
+  }
+  async getSafeNotes(entityId) {
+    return this.get(`/v1/entities/${pathSegment(entityId)}/safe-notes`);
+  }
+  createSafeNote(data) {
+    return this.post("/v1/safe-notes", data);
+  }
+  listShareTransfers(entityId) {
+    return this.get(`/v1/entities/${pathSegment(entityId)}/share-transfers`);
+  }
+  getShareTransfers(entityId) {
+    return this.listShareTransfers(entityId);
+  }
+  getValuations(entityId) {
+    return this.get(`/v1/entities/${pathSegment(entityId)}/valuations`);
+  }
+  getCurrent409a(entityId) {
+    return this.get(`/v1/entities/${pathSegment(entityId)}/current-409a`);
+  }
+  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/${pathSegment(valuationId)}/submit-for-approval`, { entity_id: entityId });
+  }
+  approveValuation(valuationId, entityId, resolutionId) {
+    const body = { entity_id: entityId };
+    if (resolutionId) body.resolution_id = resolutionId;
+    return this.post(`/v1/valuations/${pathSegment(valuationId)}/approve`, body);
+  }
+  transferShares(data) {
+    return this.post("/v1/equity/transfer-workflows", data);
+  }
+  calculateDistribution(data) {
+    return this.post("/v1/distributions", data);
+  }
+  // --- Equity rounds (v1) ---
+  createEquityRound(data) {
+    return this.post("/v1/equity/rounds", data);
+  }
+  applyEquityRoundTerms(roundId, data) {
+    return this.post(`/v1/equity/rounds/${pathSegment(roundId)}/apply-terms`, data);
+  }
+  boardApproveEquityRound(roundId, data) {
+    return this.post(`/v1/equity/rounds/${pathSegment(roundId)}/board-approve`, data);
+  }
+  acceptEquityRound(roundId, data) {
+    return this.post(`/v1/equity/rounds/${pathSegment(roundId)}/accept`, data);
+  }
+  previewRoundConversion(data) {
+    return this.post("/v1/equity/conversions/preview", data);
+  }
+  executeRoundConversion(data) {
+    return this.post("/v1/equity/conversions/execute", data);
+  }
+  // --- Staged equity rounds ---
+  listEquityRounds(entityId) {
+    return this.get(`/v1/entities/${pathSegment(entityId)}/equity-rounds`);
+  }
+  startEquityRound(data) {
+    return this.post("/v1/equity/rounds/staged", data);
+  }
+  addRoundSecurity(roundId, data) {
+    return this.post(`/v1/equity/rounds/${pathSegment(roundId)}/securities`, data);
+  }
+  issueRound(roundId, data) {
+    return this.post(`/v1/equity/rounds/${pathSegment(roundId)}/issue`, data);
+  }
+  // --- Intent lifecycle helpers ---
+  createExecutionIntent(data) {
+    return this.post("/v1/execution/intents", data);
+  }
+  evaluateIntent(intentId, entityId) {
+    return this.postWithParams(`/v1/intents/${pathSegment(intentId)}/evaluate`, {}, { entity_id: entityId });
+  }
+  authorizeIntent(intentId, entityId) {
+    return this.postWithParams(`/v1/intents/${pathSegment(intentId)}/authorize`, {}, { entity_id: entityId });
+  }
+  // --- Governance ---
+  listGovernanceBodies(entityId) {
+    return this.get(`/v1/entities/${pathSegment(entityId)}/governance-bodies`);
+  }
+  getGovernanceSeats(bodyId, entityId) {
+    return this.get(`/v1/governance-bodies/${pathSegment(bodyId)}/seats`, { entity_id: entityId });
+  }
+  listMeetings(bodyId, entityId) {
+    return this.get(`/v1/governance-bodies/${pathSegment(bodyId)}/meetings`, { entity_id: entityId });
+  }
+  getMeetingResolutions(meetingId, entityId) {
+    return this.get(`/v1/meetings/${pathSegment(meetingId)}/resolutions`, { entity_id: entityId });
+  }
+  scheduleMeeting(data) {
+    return this.post("/v1/meetings", data);
+  }
+  conveneMeeting(meetingId, entityId, data) {
+    return this.postWithParams(`/v1/meetings/${pathSegment(meetingId)}/convene`, data, { entity_id: entityId });
+  }
+  castVote(entityId, meetingId, itemId, data) {
+    return this.postWithParams(`/v1/meetings/${pathSegment(meetingId)}/agenda-items/${pathSegment(itemId)}/vote`, data, { entity_id: entityId });
+  }
+  sendNotice(meetingId, entityId) {
+    return this.postWithParams(`/v1/meetings/${pathSegment(meetingId)}/notice`, {}, { entity_id: entityId });
+  }
+  adjournMeeting(meetingId, entityId) {
+    return this.postWithParams(`/v1/meetings/${pathSegment(meetingId)}/adjourn`, {}, { entity_id: entityId });
+  }
+  reopenMeeting(meetingId, entityId) {
+    return this.postWithParams(`/v1/meetings/${pathSegment(meetingId)}/reopen`, {}, { entity_id: entityId });
+  }
+  cancelMeeting(meetingId, entityId) {
+    return this.postWithParams(`/v1/meetings/${pathSegment(meetingId)}/cancel`, {}, { entity_id: entityId });
+  }
+  finalizeAgendaItem(meetingId, itemId, data) {
+    return this.post(`/v1/meetings/${pathSegment(meetingId)}/agenda-items/${pathSegment(itemId)}/finalize`, data);
+  }
+  computeResolution(meetingId, itemId, entityId, data) {
+    return this.postWithParams(`/v1/meetings/${pathSegment(meetingId)}/agenda-items/${pathSegment(itemId)}/resolution`, data, { entity_id: entityId });
+  }
+  attachResolutionDocument(meetingId, resolutionId, data) {
+    return this.post(`/v1/meetings/${pathSegment(meetingId)}/resolutions/${pathSegment(resolutionId)}/attach-document`, data);
+  }
+  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 });
+  }
+  listVotes(meetingId, itemId, entityId) {
+    return this.get(`/v1/meetings/${pathSegment(meetingId)}/agenda-items/${pathSegment(itemId)}/votes`, { entity_id: entityId });
+  }
+  // --- Documents ---
+  getEntityDocuments(entityId) {
+    return this.get(`/v1/formations/${pathSegment(entityId)}/documents`);
+  }
+  getDocument(documentId, entityId) {
+    return this.get(`/v1/documents/${pathSegment(documentId)}`, { entity_id: entityId });
+  }
+  signDocument(documentId, entityId, data) {
+    return this.postWithParams(`/v1/documents/${pathSegment(documentId)}/sign`, data, { entity_id: entityId });
+  }
+  generateContract(data) {
+    return this.post("/v1/contracts", data);
+  }
+  getSigningLink(documentId, entityId) {
+    return this.get(`/v1/sign/${pathSegment(documentId)}`, { entity_id: entityId });
+  }
+  async validatePreviewPdf(entityId, 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 };
+  }
+  getPreviewPdfUrl(entityId, documentId) {
+    if (this.apiUrl.startsWith("process://")) {
+      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}`;
+  }
+  // --- Finance ---
+  listInvoices(entityId) {
+    return this.get(`/v1/entities/${pathSegment(entityId)}/invoices`);
+  }
+  listBankAccounts(entityId) {
+    return this.get(`/v1/entities/${pathSegment(entityId)}/bank-accounts`);
+  }
+  listPayments(entityId) {
+    return this.get(`/v1/entities/${pathSegment(entityId)}/payments`);
+  }
+  listPayrollRuns(entityId) {
+    return this.get(`/v1/entities/${pathSegment(entityId)}/payroll-runs`);
+  }
+  listDistributions(entityId) {
+    return this.get(`/v1/entities/${pathSegment(entityId)}/distributions`);
+  }
+  listReconciliations(entityId) {
+    return this.get(`/v1/entities/${pathSegment(entityId)}/reconciliations`);
+  }
+  createInvoice(data) {
+    return this.post("/v1/treasury/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/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`);
+  }
+  listDeadlines(entityId) {
+    return this.get(`/v1/entities/${pathSegment(entityId)}/deadlines`);
+  }
+  listContractorClassifications(entityId) {
+    return this.get(`/v1/entities/${pathSegment(entityId)}/contractor-classifications`);
+  }
+  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(planId, entityId) {
+    const body = { plan_id: planId };
+    if (entityId) body.entity_id = entityId;
+    return this.post("/v1/billing/checkout", body);
+  }
+  // --- Formations ---
+  getFormation(id) {
+    return this.get(`/v1/formations/${pathSegment(id)}`);
+  }
+  getFormationDocuments(id) {
+    return this.get(`/v1/formations/${pathSegment(id)}/documents`);
+  }
+  createFormation(data) {
+    return this.post("/v1/formations", data);
+  }
+  createFormationWithCapTable(data) {
+    return this.post("/v1/formations/with-cap-table", data);
+  }
+  createPendingEntity(data) {
+    return this.post("/v1/formations/pending", data);
+  }
+  addFounder(entityId, data) {
+    return this.post(`/v1/formations/${pathSegment(entityId)}/founders`, data);
+  }
+  finalizeFormation(entityId, data = {}) {
+    return this.post(`/v1/formations/${pathSegment(entityId)}/finalize`, data);
+  }
+  markFormationDocumentsSigned(entityId) {
+    return this.post(`/v1/formations/${pathSegment(entityId)}/mark-documents-signed`);
+  }
+  getFormationGates(entityId) {
+    return this.get(`/v1/formations/${pathSegment(entityId)}/gates`);
+  }
+  recordFilingAttestation(entityId, data) {
+    return this.post(`/v1/formations/${pathSegment(entityId)}/filing-attestation`, data);
+  }
+  addRegisteredAgentConsentEvidence(entityId, data) {
+    return this.post(`/v1/formations/${pathSegment(entityId)}/registered-agent-consent-evidence`, data);
+  }
+  submitFiling(entityId) {
+    return this.post(`/v1/formations/${pathSegment(entityId)}/submit-filing`);
+  }
+  confirmFiling(entityId, data) {
+    return this.post(`/v1/formations/${pathSegment(entityId)}/filing-confirmation`, data);
+  }
+  applyEin(entityId) {
+    return this.post(`/v1/formations/${pathSegment(entityId)}/apply-ein`);
+  }
+  confirmEin(entityId, data) {
+    return this.post(`/v1/formations/${pathSegment(entityId)}/ein-confirmation`, data);
+  }
+  // --- Human obligations ---
+  getHumanObligations() {
+    return this.get(`/v1/workspaces/${pathSegment(this.workspaceId)}/human-obligations`);
+  }
+  getSignerToken(obligationId) {
+    return this.post(`/v1/human-obligations/${pathSegment(obligationId)}/signer-token`);
+  }
+  // --- Next Steps ---
+  getEntityNextSteps(entityId) {
+    return this.get(`/v1/entities/${pathSegment(entityId)}/next-steps`);
+  }
+  getWorkspaceNextSteps() {
+    return this.get(`/v1/workspaces/${pathSegment(this.workspaceId)}/next-steps`);
+  }
+  // --- Demo ---
+  seedDemo(data) {
+    return this.post("/v1/demo/seed", data);
+  }
+  // --- Entities writes ---
+  convertEntity(entityId, data) {
+    const body = {
+      target_type: data.target_type ?? data.new_entity_type
+    };
+    const jurisdiction = data.jurisdiction ?? data.new_jurisdiction;
+    if (jurisdiction) body.jurisdiction = jurisdiction;
+    return this.post(`/v1/entities/${pathSegment(entityId)}/convert`, body);
+  }
+  dissolveEntity(entityId, data) {
+    return this.post(`/v1/entities/${pathSegment(entityId)}/dissolve`, data);
+  }
+  // --- Agents ---
+  listAgents() {
+    return this.get("/v1/agents");
+  }
+  getAgent(id) {
+    return this.get(`/v1/agents/${pathSegment(id)}/resolved`);
+  }
+  createAgent(data) {
+    return this.post("/v1/agents", data);
+  }
+  updateAgent(id, data) {
+    return this.patch(`/v1/agents/${pathSegment(id)}`, data);
+  }
+  deleteAgent(id) {
+    return this.patch(`/v1/agents/${pathSegment(id)}`, { status: "disabled" });
+  }
+  sendAgentMessage(id, message) {
+    return this.post(`/v1/agents/${pathSegment(id)}/messages`, { message });
+  }
+  addAgentSkill(id, data) {
+    return this.post(`/v1/agents/${pathSegment(id)}/skills`, data);
+  }
+  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);
+  }
+  createGovernanceSeat(bodyId, entityId, data) {
+    return this.postWithParams(`/v1/governance-bodies/${pathSegment(bodyId)}/seats`, data, { entity_id: entityId });
+  }
+  // --- Work Items ---
+  listWorkItems(entityId, params) {
+    return this.get(`/v1/entities/${pathSegment(entityId)}/work-items`, params);
+  }
+  getWorkItem(entityId, workItemId) {
+    return this.get(`/v1/entities/${pathSegment(entityId)}/work-items/${pathSegment(workItemId)}`);
+  }
+  createWorkItem(entityId, data) {
+    return this.post(`/v1/entities/${pathSegment(entityId)}/work-items`, data);
+  }
+  claimWorkItem(entityId, workItemId, data) {
+    return this.post(`/v1/entities/${pathSegment(entityId)}/work-items/${pathSegment(workItemId)}/claim`, data);
+  }
+  completeWorkItem(entityId, workItemId, data) {
+    return this.post(`/v1/entities/${pathSegment(entityId)}/work-items/${pathSegment(workItemId)}/complete`, data);
+  }
+  releaseWorkItem(entityId, workItemId) {
+    return this.post(`/v1/entities/${pathSegment(entityId)}/work-items/${pathSegment(workItemId)}/release`, {});
+  }
+  cancelWorkItem(entityId, workItemId) {
+    return this.post(`/v1/entities/${pathSegment(entityId)}/work-items/${pathSegment(workItemId)}/cancel`, {});
+  }
+  // --- API Keys ---
+  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 });
+  }
+  // --- Config ---
+  getConfig() {
+    return this.get("/v1/config");
+  }
+  // --- Services ---
+  listServiceCatalog() {
+    return this.get("/v1/services/catalog");
+  }
+  createServiceRequest(data) {
+    return this.post("/v1/services/requests", data);
+  }
+  getServiceRequest(id, entityId) {
+    return this.get(`/v1/services/requests/${pathSegment(id)}`, { entity_id: entityId });
+  }
+  listServiceRequests(entityId) {
+    return this.get(`/v1/entities/${pathSegment(entityId)}/service-requests`);
+  }
+  beginServiceCheckout(id, data) {
+    return this.post(`/v1/services/requests/${pathSegment(id)}/checkout`, data);
+  }
+  fulfillServiceRequest(id, data) {
+    return this.post(`/v1/services/requests/${pathSegment(id)}/fulfill`, data);
+  }
+  cancelServiceRequest(id, data) {
+    return this.post(`/v1/services/requests/${pathSegment(id)}/cancel`, data);
+  }
+  // --- 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 });
+    if (!resp.ok) {
+      const detail = await extractErrorMessage(resp);
+      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();
+  }
+};
+
+// src/reference-tracker.ts
+var RESOURCE_KINDS = [
+  "entity",
+  "contact",
+  "share_transfer",
+  "invoice",
+  "bank_account",
+  "payment",
+  "payroll_run",
+  "distribution",
+  "reconciliation",
+  "tax_filing",
+  "deadline",
+  "classification",
+  "body",
+  "meeting",
+  "seat",
+  "agenda_item",
+  "resolution",
+  "document",
+  "work_item",
+  "agent",
+  "valuation",
+  "safe_note",
+  "instrument",
+  "share_class",
+  "round",
+  "service_request"
+];
+var VALID_RESOURCE_KINDS = new Set(RESOURCE_KINDS);
+var MAX_REFERENCE_INPUT_LEN = 256;
+function normalize(value) {
+  return value.trim().toLowerCase();
+}
+function validateReferenceInput(value, field, options = {}) {
+  const trimmed = value.trim();
+  if (!options.allowEmpty && trimmed.length === 0) {
+    throw new Error(`${field} cannot be empty.`);
+  }
+  if (trimmed.length > MAX_REFERENCE_INPUT_LEN) {
+    throw new Error(`${field} must be at most ${MAX_REFERENCE_INPUT_LEN} characters.`);
+  }
+  return trimmed;
+}
+function shortId(value) {
+  return String(value ?? "").slice(0, 8);
+}
+function slugify(value) {
+  return String(value ?? "").toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+}
+function parseLastReference(value) {
+  const trimmed = validateReferenceInput(value, "reference", { allowEmpty: false }).toLowerCase();
+  if (trimmed === "_" || trimmed === "@last") {
+    return { isLast: true };
+  }
+  if (trimmed.startsWith("@last:")) {
+    const kind = trimmed.slice(6);
+    if (!VALID_RESOURCE_KINDS.has(kind)) {
+      throw new Error(`Unknown reference kind: ${kind}`);
+    }
+    return { isLast: true, kind };
+  }
+  return { isLast: false };
+}
+function uniqueStrings(values) {
+  const out = /* @__PURE__ */ new Set();
+  for (const value of values) {
+    if (!value) continue;
+    const trimmed = value.trim();
+    if (!trimmed) continue;
+    out.add(normalize(trimmed));
+    const slug = slugify(trimmed);
+    if (slug) out.add(slug);
+  }
+  return out;
+}
+function kindLabel(kind) {
+  return kind.replaceAll("_", " ");
+}
+function extractId(record, fields) {
+  for (const field of fields) {
+    const value = record[field];
+    if (typeof value === "string" && value.trim()) {
+      return value.trim();
+    }
+  }
+  return void 0;
+}
+function isValidResourceKind(kind) {
+  return VALID_RESOURCE_KINDS.has(kind);
+}
+function describeReferenceRecord(kind, record) {
+  const specs = {
+    entity: { idFields: ["entity_id", "id"], labelFields: ["legal_name", "name"] },
+    contact: { idFields: ["contact_id", "id"], labelFields: ["name", "email"] },
+    share_transfer: {
+      idFields: ["transfer_id", "id"],
+      labelFields: ["from_holder", "to_holder", "transfer_type", "status"]
+    },
+    invoice: {
+      idFields: ["invoice_id", "id"],
+      labelFields: ["customer_name", "description", "due_date"]
+    },
+    bank_account: {
+      idFields: ["bank_account_id", "account_id", "id"],
+      labelFields: ["bank_name", "account_type"]
+    },
+    payment: {
+      idFields: ["payment_id", "id"],
+      labelFields: ["recipient", "description", "payment_method"]
+    },
+    payroll_run: {
+      idFields: ["payroll_run_id", "id"],
+      labelFields: ["pay_period_start", "pay_period_end"]
+    },
+    distribution: {
+      idFields: ["distribution_id", "id"],
+      labelFields: ["description", "distribution_type"]
+    },
+    reconciliation: {
+      idFields: ["reconciliation_id", "id"],
+      labelFields: ["as_of_date", "status"]
+    },
+    tax_filing: {
+      idFields: ["filing_id", "id"],
+      labelFields: ["document_type", "tax_year"]
+    },
+    deadline: {
+      idFields: ["deadline_id", "id"],
+      labelFields: ["deadline_type", "description", "due_date"]
+    },
+    classification: {
+      idFields: ["classification_id", "id"],
+      labelFields: ["contractor_name", "state", "risk_level"]
+    },
+    body: { idFields: ["body_id", "id"], labelFields: ["name"] },
+    meeting: { idFields: ["meeting_id", "id"], labelFields: ["title", "name"] },
+    seat: {
+      idFields: ["seat_id", "id"],
+      labelFields: ["seat_name", "title", "holder_name", "holder", "holder_email"]
+    },
+    agenda_item: { idFields: ["agenda_item_id", "item_id", "id"], labelFields: ["title"] },
+    resolution: { idFields: ["resolution_id", "id"], labelFields: ["title"] },
+    document: { idFields: ["document_id", "id"], labelFields: ["title", "name"] },
+    work_item: { idFields: ["work_item_id", "id"], labelFields: ["title"] },
+    agent: { idFields: ["agent_id", "id"], labelFields: ["name"] },
+    valuation: {
+      idFields: ["valuation_id", "id"],
+      labelFields: ["valuation_type", "effective_date", "date"]
+    },
+    safe_note: {
+      idFields: ["safe_note_id", "safe_id", "id"],
+      labelFields: ["investor_name", "investor", "safe_type"]
+    },
+    instrument: { idFields: ["instrument_id", "id"], labelFields: ["symbol", "kind", "name"] },
+    share_class: {
+      idFields: ["share_class_id", "id"],
+      labelFields: ["class_code", "name", "share_class"]
+    },
+    round: { idFields: ["round_id", "equity_round_id", "id"], labelFields: ["name"] },
+    service_request: {
+      idFields: ["request_id", "service_request_id", "id"],
+      labelFields: ["service_slug", "status"]
+    }
+  };
+  const spec = specs[kind];
+  const id = extractId(record, spec.idFields);
+  if (!id) {
+    return null;
+  }
+  const labels = spec.labelFields.map((field) => record[field]).filter((value) => typeof value === "string" && value.trim().length > 0);
+  const persistedHandle = typeof record.handle === "string" && record.handle.trim().length > 0 ? record.handle.trim() : void 0;
+  let label = labels[0] ?? id;
+  if (kind === "share_transfer") {
+    const fromHolder = typeof record.from_holder === "string" ? record.from_holder.trim() : "";
+    const toHolder = typeof record.to_holder === "string" ? record.to_holder.trim() : "";
+    const transferType = typeof record.transfer_type === "string" ? record.transfer_type.trim() : "";
+    const composite = [
+      fromHolder && toHolder ? `${fromHolder}-to-${toHolder}` : "",
+      transferType
+    ].filter(Boolean).join("-");
+    if (composite) {
+      label = composite;
+    }
+  }
+  return {
+    id,
+    label,
+    tokens: uniqueStrings([id, persistedHandle, ...labels]),
+    raw: record
+  };
+}
+function getReferenceId(kind, record) {
+  return describeReferenceRecord(kind, record)?.id;
+}
+function getReferenceLabel(kind, record) {
+  return describeReferenceRecord(kind, record)?.label;
+}
+function getReferenceAlias(kind, record) {
+  if (typeof record.handle === "string" && record.handle.trim().length > 0) {
+    return record.handle.trim();
+  }
+  const described = describeReferenceRecord(kind, record);
+  if (!described) return void 0;
+  const alias = slugify(described.label);
+  return alias || shortId(described.id);
+}
+function matchRank(record, normalizedQuery) {
+  if (!normalizedQuery || normalizedQuery === "*") {
+    return 5;
+  }
+  if (normalize(record.id) === normalizedQuery) {
+    return 0;
+  }
+  if (record.tokens.has(normalizedQuery)) {
+    return 1;
+  }
+  if (normalize(record.id).startsWith(normalizedQuery)) {
+    return 2;
+  }
+  if (Array.from(record.tokens).some((token) => token.startsWith(normalizedQuery))) {
+    return 3;
+  }
+  return 4;
+}
+var ReferenceTracker = class {
+  constructor(storage) {
+    this.storage = storage;
+  }
+  /** Remember a reference for @last reuse. */
+  remember(kind, id, entityId) {
+    this.storage.setLastReference(kind, id, entityId);
+  }
+  /** Resolve @last / @last:kind references. */
+  resolveLastReference(ref, kind, entityId) {
+    const parsed = parseLastReference(ref);
+    if (!parsed.isLast) return parsed;
+    const lastKind = parsed.kind ?? kind;
+    if (lastKind !== kind) {
+      throw new Error(
+        `@last:${lastKind} cannot be used where a ${kindLabel(kind)} reference is required.`
+      );
+    }
+    const id = this.storage.getLastReference(lastKind, entityId);
+    return { ...parsed, id };
+  }
+  /** Find the single best match for a query against a list of records. */
+  findBestMatch(kind, query, records) {
+    const matches = this.findMatches(kind, query, records);
+    return matches.length > 0 ? matches[0] : null;
+  }
+  /** Find all matching records ranked by relevance. */
+  findMatches(kind, query, records) {
+    const trimmedQuery = validateReferenceInput(query, "query", { allowEmpty: true });
+    const described = records.map((record) => describeReferenceRecord(kind, record)).filter((record) => record !== null);
+    const normalizedQuery = normalize(trimmedQuery);
+    const matches = described.filter((record) => {
+      if (!normalizedQuery || normalizedQuery === "*") {
+        return true;
+      }
+      if (normalize(record.id).startsWith(normalizedQuery)) {
+        return true;
+      }
+      if (record.tokens.has(normalizedQuery)) {
+        return true;
+      }
+      return Array.from(record.tokens).some((token) => token.includes(normalizedQuery));
+    }).sort(
+      (left, right) => matchRank(left, normalizedQuery) - matchRank(right, normalizedQuery) || left.label.localeCompare(right.label) || left.id.localeCompare(right.id)
+    );
+    return matches.map((record) => ({
+      kind,
+      id: record.id,
+      short_id: shortId(record.id),
+      label: record.label,
+      alias: getReferenceAlias(kind, record.raw),
+      raw: record.raw
+    }));
+  }
+};
+
+// src/workflows/equity-helpers.ts
+function normalizedGrantType(grantType) {
+  return grantType.trim().toLowerCase().replaceAll("-", "_").replaceAll(" ", "_");
+}
+function expectedInstrumentKinds(grantType) {
+  switch (normalizedGrantType(grantType)) {
+    case "common":
+    case "common_stock":
+      return ["common_equity"];
+    case "preferred":
+    case "preferred_stock":
+      return ["preferred_equity"];
+    case "unit":
+    case "membership_unit":
+      return ["membership_unit"];
+    case "option":
+    case "options":
+    case "stock_option":
+    case "iso":
+    case "nso":
+      return ["option_grant"];
+    case "rsa":
+      return ["common_equity", "preferred_equity"];
+    default:
+      return [];
+  }
+}
+function grantRequiresCurrent409a(grantType, instrumentKind) {
+  return instrumentKind?.toLowerCase() === "option_grant" || expectedInstrumentKinds(grantType).includes("option_grant");
+}
+function buildInstrumentCreationHint(grantType) {
+  const normalized = normalizedGrantType(grantType);
+  switch (normalized) {
+    case "preferred":
+    case "preferred_stock":
+      return "Create one with: corp cap-table create-instrument --kind preferred_equity --symbol SERIES-A --authorized-units <shares>";
+    case "option":
+    case "options":
+    case "stock_option":
+    case "iso":
+    case "nso":
+      return "Create one with: corp cap-table create-instrument --kind option_grant --symbol OPTION-PLAN --authorized-units <shares>";
+    case "membership_unit":
+    case "unit":
+      return "Create one with: corp cap-table create-instrument --kind membership_unit --symbol UNIT --authorized-units <units>";
+    case "common":
+    case "common_stock":
+      return "Create one with: corp cap-table create-instrument --kind common_equity --symbol COMMON --authorized-units <shares>";
+    default:
+      return "Create a matching instrument first, then pass --instrument-id explicitly.";
+  }
+}
+function resolveInstrumentForGrant(instruments, grantType, explicitInstrumentId) {
+  if (explicitInstrumentId) {
+    const explicit = instruments.find(
+      (instrument) => instrument.instrument_id === explicitInstrumentId
+    );
+    if (!explicit) {
+      throw new Error(
+        `Instrument ${explicitInstrumentId} was not found on the cap table.`
+      );
+    }
+    return explicit;
+  }
+  const kinds = expectedInstrumentKinds(grantType);
+  if (kinds.length === 0) {
+    throw new Error(
+      `No default instrument mapping exists for grant type "${grantType}". ${buildInstrumentCreationHint(grantType)}`
+    );
+  }
+  const match = instruments.find(
+    (instrument) => kinds.includes(String(instrument.kind).toLowerCase())
+  );
+  if (!match) {
+    throw new Error(
+      `No instrument found for grant type "${grantType}". Expected one of: ${kinds.join(", ")}. ${buildInstrumentCreationHint(grantType)}`
+    );
+  }
+  return match;
+}
+async function entityHasActiveBoard(client, entityId) {
+  const bodies = await client.listGovernanceBodies(entityId);
+  return bodies.some(
+    (body) => String(body.body_type ?? "").toLowerCase() === "board_of_directors" && String(body.status ?? "active").toLowerCase() === "active"
+  );
+}
+async function ensureIssuancePreflight(client, entityId, grantType, instrument, meetingId, resolutionId, operationLabel) {
+  if (!meetingId || !resolutionId) {
+    if (await entityHasActiveBoard(client, entityId)) {
+      const label = operationLabel ?? "this issuance";
+      throw new Error(
+        `Board approval is required for ${label}. Pass --meeting-id and --resolution-id from a passed board vote.
+  Tip: Use 'corp governance quick-approve --text "RESOLVED: authorize ${label}"' for one-step approval.`
+      );
+    }
+  }
+  if (!grantRequiresCurrent409a(grantType, instrument?.kind)) {
+    return;
+  }
+  try {
+    await client.getCurrent409a(entityId);
+  } catch (err) {
+    const msg = String(err);
+    if (msg.includes("404") || msg.includes("Not found") || msg.includes("not found")) {
+      throw new Error(
+        "Stock option issuances require a current approved 409A valuation. Create and approve one first with: corp cap-table create-valuation --type four_oh_nine_a --date YYYY-MM-DD --methodology <method>; corp cap-table submit-valuation <valuation-ref>; corp cap-table approve-valuation <valuation-ref> --resolution-id <resolution-ref>"
+      );
+    }
+    throw err;
+  }
+}
+
+// src/workflows/issue-equity.ts
+async function issueEquity(client, args) {
+  const steps = [];
+  try {
+    const capTable = await client.getCapTable(args.entityId);
+    const issuerLegalEntityId = capTable.issuer_legal_entity_id;
+    if (!issuerLegalEntityId) {
+      return {
+        success: false,
+        error: "No issuer legal entity found. Has this entity been formed with a cap table?",
+        steps
+      };
+    }
+    const instruments = capTable.instruments ?? [];
+    if (!instruments.length) {
+      return {
+        success: false,
+        error: "No instruments found on cap table. Create one with: corp cap-table create-instrument --kind common_equity --symbol COMMON --authorized-units <shares>",
+        steps
+      };
+    }
+    const instrument = resolveInstrumentForGrant(
+      instruments,
+      args.grantType,
+      args.instrumentId
+    );
+    const instrumentId = instrument.instrument_id;
+    steps.push({
+      name: "resolve_instrument",
+      status: "ok",
+      data: {
+        instrument_id: instrumentId,
+        symbol: instrument.symbol,
+        kind: instrument.kind
+      },
+      detail: `Using instrument: ${instrument.symbol} (${instrument.kind})`
+    });
+    await ensureIssuancePreflight(
+      client,
+      args.entityId,
+      args.grantType,
+      instrument,
+      args.meetingId,
+      args.resolutionId,
+      "equity issuance"
+    );
+    steps.push({ name: "preflight", status: "ok" });
+    const round = await client.startEquityRound({
+      entity_id: args.entityId,
+      name: `${args.grantType} grant \u2014 ${args.recipientName}`,
+      issuer_legal_entity_id: issuerLegalEntityId
+    });
+    const roundId = round.round_id ?? round.equity_round_id;
+    steps.push({
+      name: "start_round",
+      status: "ok",
+      data: { round_id: roundId }
+    });
+    const securityData = {
+      entity_id: args.entityId,
+      instrument_id: instrumentId,
+      quantity: args.shares,
+      recipient_name: args.recipientName,
+      grant_type: args.grantType
+    };
+    if (args.recipientEmail) securityData.email = args.recipientEmail;
+    const existingHolders = capTable.holders ?? [];
+    const matchingHolder = existingHolders.find((h) => {
+      const nameMatch = String(h.name ?? "").toLowerCase() === args.recipientName.toLowerCase();
+      const emailMatch = args.recipientEmail && String(h.email ?? "").toLowerCase() === args.recipientEmail.toLowerCase();
+      return nameMatch || emailMatch;
+    });
+    if (matchingHolder) {
+      const holderId = matchingHolder.holder_id ?? matchingHolder.contact_id ?? matchingHolder.id;
+      if (holderId) securityData.holder_id = holderId;
+    }
+    await client.addRoundSecurity(roundId, securityData);
+    steps.push({ name: "add_security", status: "ok" });
+    const issuePayload = {
+      entity_id: args.entityId
+    };
+    if (args.meetingId) issuePayload.meeting_id = args.meetingId;
+    if (args.resolutionId) issuePayload.resolution_id = args.resolutionId;
+    const result = await client.issueRound(roundId, issuePayload);
+    steps.push({ name: "issue_round", status: "ok" });
+    return {
+      success: true,
+      data: {
+        ...result,
+        round_id: roundId,
+        round,
+        shares: args.shares,
+        grant_type: args.grantType,
+        recipient: args.recipientName
+      },
+      steps
+    };
+  } catch (err) {
+    steps.push({
+      name: "error",
+      status: "failed",
+      detail: String(err)
+    });
+    return {
+      success: false,
+      error: err instanceof Error ? err.message : String(err),
+      steps
+    };
+  }
+}
+
+// src/workflows/issue-safe.ts
+async function issueSafe(client, args) {
+  const steps = [];
+  const safeType = args.safeType ?? "post_money";
+  try {
+    await ensureIssuancePreflight(
+      client,
+      args.entityId,
+      safeType,
+      void 0,
+      args.meetingId,
+      args.resolutionId,
+      "SAFE issuance"
+    );
+    steps.push({ name: "preflight", status: "ok" });
+    const body = {
+      entity_id: args.entityId,
+      investor_name: args.investorName,
+      principal_amount_cents: args.amountCents,
+      valuation_cap_cents: args.valuationCapCents,
+      safe_type: safeType
+    };
+    if (args.email) body.email = args.email;
+    if (args.meetingId) body.meeting_id = args.meetingId;
+    if (args.resolutionId) body.resolution_id = args.resolutionId;
+    const result = await client.createSafeNote(body);
+    steps.push({ name: "create_safe", status: "ok" });
+    return {
+      success: true,
+      data: {
+        ...result,
+        investor_name: args.investorName,
+        amount_cents: args.amountCents,
+        valuation_cap_cents: args.valuationCapCents
+      },
+      steps
+    };
+  } catch (err) {
+    steps.push({
+      name: "error",
+      status: "failed",
+      detail: String(err)
+    });
+    return {
+      success: false,
+      error: err instanceof Error ? err.message : String(err),
+      steps
+    };
+  }
+}
+
+// src/workflows/written-consent.ts
+async function writtenConsent(client, args) {
+  const steps = [];
+  try {
+    const payload = {
+      entity_id: args.entityId,
+      body_id: args.bodyId,
+      title: args.title,
+      description: args.description
+    };
+    const result = await client.writtenConsent(payload);
+    const meetingId = String(result.meeting_id ?? "");
+    steps.push({
+      name: "create_written_consent",
+      status: "ok",
+      data: { meeting_id: meetingId || void 0 }
+    });
+    if (meetingId) {
+      try {
+        const seats = await client.getGovernanceSeats(
+          args.bodyId,
+          args.entityId
+        );
+        const seatIds = seats.map(
+          (s) => String(
+            s.seat_id ?? s.id ?? ""
+          )
+        ).filter((id) => id.length > 0);
+        if (seatIds.length > 0) {
+          await client.conveneMeeting(meetingId, args.entityId, {
+            present_seat_ids: seatIds
+          });
+          steps.push({
+            name: "auto_open",
+            status: "ok",
+            data: { seat_count: seatIds.length },
+            detail: `Opened with ${seatIds.length} seat(s) present`
+          });
+        } else {
+          steps.push({
+            name: "auto_open",
+            status: "skipped",
+            detail: "No seats found on body"
+          });
+        }
+      } catch {
+        steps.push({
+          name: "auto_open",
+          status: "skipped",
+          detail: "Failed to auto-open meeting (non-fatal)"
+        });
+      }
+    } else {
+      steps.push({
+        name: "auto_open",
+        status: "skipped",
+        detail: "No meeting_id returned"
+      });
+    }
+    return {
+      success: true,
+      data: { ...result, meeting_id: meetingId || void 0 },
+      steps
+    };
+  } catch (err) {
+    steps.push({
+      name: "error",
+      status: "failed",
+      detail: String(err)
+    });
+    return {
+      success: false,
+      error: err instanceof Error ? err.message : String(err),
+      steps
+    };
+  }
+}
+export {
+  CorpAPIClient,
+  RESOURCE_KINDS,
+  ReferenceTracker,
+  describeReferenceRecord,
+  ensureIssuancePreflight,
+  entityHasActiveBoard,
+  expectedInstrumentKinds,
+  getReferenceAlias,
+  getReferenceId,
+  getReferenceLabel,
+  grantRequiresCurrent409a,
+  isValidResourceKind,
+  issueEquity,
+  issueSafe,
+  matchRank,
+  normalizedGrantType,
+  shortId,
+  slugify,
+  writtenConsent
+};
+//# sourceMappingURL=browser.js.map