@thecorporation/server

Pre-built binaries for the governance kernel — the Rust backend that validates every corporate action, enforces policy gates, and produces atomic git commits. Wraps the server as a Node.js child process with automatic platform detection.

Part of TheCorporation — version-controlled governance, autonomous agents, and open-source corporate infrastructure.

Install

npm install @thecorporation/server

The correct binary for your platform is installed automatically via optionalDependencies.

Supported platforms: macOS (Apple Silicon, Intel), Linux (x64, arm64), Windows (x64).

Usage

import { startServer, isAvailable, getBinaryPath } from "@thecorporation/server";

// Check if a binary exists for this platform
if (isAvailable()) {
  const child = startServer({
    port: 8000,
    dataDir: "./data/repos",
  });
}

startServer(options?)

Spawns the server as a child process and returns a ChildProcess.

| Option | Env var | Default | |---|---|---| | port | PORT | 8000 | | dataDir | DATA_DIR | ./data/repos | | redisUrl | REDIS_URL | — | | jwtPrivateKeyPem | JWT_PRIVATE_KEY_PEM | — | | jwtPublicKeyPem | JWT_PUBLIC_KEY_PEM | — | | stripeSecretKey | STRIPE_SECRET_KEY | — | | stripeWebhookSecret | STRIPE_WEBHOOK_SECRET | — | | commitSigningKey | COMMIT_SIGNING_KEY | — | | stdio | — | "inherit" |

Oneshot mode (CLI)

The binary also supports a call subcommand for processing a single request without starting a server:

api-rs --skip-validation call GET /v1/health
api-rs --skip-validation call --data-dir ~/.corp/data POST /v1/workspaces/provision --stdin

The --data-dir flag sets the data directory for that request (overrides DATA_DIR env var, defaults to ./data/repos). This is used by the CLI's process:// transport for local-mode operation.

getBinaryPath()

Returns the resolved binary path, or null if unavailable. Resolution order:

1. CORP_SERVER_BIN environment variable
2. Platform-specific npm optional dependency
3. Local dev build at services/api-rs/target/release/api-rs

isAvailable()

Returns true if a binary exists for the current platform.

Links

• thecorporation.ai
• GitHub

License

MIT