@thecorporation/agent 0.1.0

package/README.md

@@ -0,0 +1,47 @@
+# @thecorporation/agent
+
+Corporate governance agent powered by [Pi](https://github.com/nicholasgasior/pi-coding-agent). Adds 35 tools for entity formation, equity management, payroll, compliance, and more.
+
+## Install
+
+```bash
+npm i -g @mariozechner/pi-coding-agent @thecorporation/agent
+```
+
+## Usage
+
+```bash
+corp                        # interactive mode — launches Pi with corporate tools
+corp -p "list entities"     # one-shot mode
+corp -p "form an LLC"       # guided entity formation
+```
+
+The `corp` command:
+
+1. Copies the corporate tools extension into your project's `.pi/extensions/`
+2. Seeds `.pi/AGENT.md` with corporate context (only if not already present)
+3. Launches `pi` with all arguments forwarded
+
+## Configuration
+
+Create `~/.corp/config.json`:
+
+```json
+{
+  "api_url": "https://api.thecorporation.ai",
+  "api_key": "your-api-key",
+  "workspace_id": "your-workspace-id"
+}
+```
+
+Or use environment variables: `CORP_API_URL`, `CORP_CONFIG_DIR`.
+
+## What's Included
+
+- **30 corporate tools** — entities, equity, documents, finance, compliance, agents
+- **5 slash commands** — `/corp-status`, `/corp-login`, `/corp-switch`, `/corp-entities`, `/corp-agents`
+- **Write-tool confirmation gating** — destructive operations require user approval
+
+## License
+
+MIT

package/bin/corp.mjs

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+import { existsSync, mkdirSync, copyFileSync } from "node:fs";
+import { execFileSync } from "node:child_process";
+
+const pkgDir = dirname(dirname(fileURLToPath(import.meta.url)));
+const extDir = join(pkgDir, "extension");
+
+// Ensure .pi/extensions/ exists in cwd
+const targetExtDir = join(process.cwd(), ".pi", "extensions");
+mkdirSync(targetExtDir, { recursive: true });
+
+// Always copy corp.ts (keep current with installed package version)
+copyFileSync(join(extDir, "corp.ts"), join(targetExtDir, "corp.ts"));
+
+// Copy AGENT.md only if not present (don't overwrite user customizations)
+const targetAgent = join(process.cwd(), ".pi", "AGENT.md");
+if (!existsSync(targetAgent)) {
+  copyFileSync(join(extDir, "AGENT.md"), targetAgent);
+}
+
+// Launch pi, forwarding all arguments
+try {
+  execFileSync("pi", process.argv.slice(2), { stdio: "inherit" });
+} catch (err) {
+  if (err.code === "ENOENT") {
+    console.error(
+      "Error: 'pi' not found. Install the Pi coding agent first:\n\n" +
+        "  npm i -g @mariozechner/pi-coding-agent\n"
+    );
+    process.exit(1);
+  }
+  // pi exited with non-zero — propagate the exit code
+  process.exit(err.status ?? 1);
+}

package/extension/AGENT.md

@@ -0,0 +1,30 @@
+# TheCorporation — Pi Agent Context
+
+You are a corporate governance assistant for TheCorporation, an agentic corporate governance platform.
+
+## Tool Categories
+
+**Read tools** (auto-approved): 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
+
+**Entity lifecycle**: form_entity, convert_entity, dissolve_entity
+**Equity**: issue_equity, transfer_shares, issue_safe, calculate_distribution
+**Finance**: create_invoice, run_payroll, submit_payment, open_bank_account, reconcile_ledger
+**Documents & compliance**: generate_contract, file_tax_document, track_deadline, classify_contractor, get_signing_link
+**Governance**: convene_meeting, cast_vote, schedule_meeting
+**Agents**: create_agent, send_agent_message, update_agent, add_agent_skill
+**Workspace**: update_checklist
+
+## Key Rules
+
+- All monetary values are in **integer cents** ($1,000 = 100000).
+- Write tools require user confirmation — a dialog will appear automatically.
+- Documents can ONLY be signed through signing links. You CANNOT sign on behalf of users.
+- Use `get_signing_link` to generate a URL; present it to the user.
+- Before calling `form_entity`, always collect member names, emails, roles, and ownership allocations.
+- For LLCs, ownership percentages must total 100% (1.0). Default jurisdiction: US-WY.
+- For Corporations, default jurisdiction: US-DE.
+- After major actions, suggest logical next steps. Never just say "done."
+- After entity formation: suggest signing documents, then EIN, bank account, equity.
+- After document generation: present signing links immediately.
+- NEVER create an agent to answer a question you can answer yourself.
+- Agents are for delegating recurring tasks the user explicitly requests.