Repository avatar
AI Tools
v2.0.0
active

stack

run.getstack/stack

One account for your AI agents: email, phone, payments, post and more. One bill, one off switch.

Documentation

STACK

STACK is one account that lets your AI agents email, call, pay, send post, hire people and get things made, with one bill and one off switch.

This repository holds the parts of STACK you can read, build on and run, in layers under different licences:

  • The written specifications, the conformance kit, the command line, the verifier for signed records and the examples are under the Apache License 2.0.
  • The TypeScript and Python SDKs are under the MIT License.
  • The engine, the software that runs STACK on your own servers (the API, the worker, the MCP server and the packaging to run them), is source-available under the Fair Core License. Each version turns into the Apache License 2.0 two years after it is published (see spec/LICENSING.md).

What is here

  • spec: The written specifications, their JSON Schemas, the conformance kit and its fixtures. Licence: Apache-2.0.
  • packages/sdk: The TypeScript SDK. Licence: MIT.
  • sdk-python: The Python SDK. Licence: MIT.
  • packages/cli: The command-line client. Licence: Apache-2.0.
  • packages/verifier: The offline verifier for signed records. Licence: Apache-2.0.
  • examples/control-socket: The example decision server. Licence: Apache-2.0.
  • tsconfig.base.json, turbo.json, .dockerignore, .prettierrc, tooling/build-stamp.mjs, tooling/build-stamp.d.mts, pnpm-workspace.yaml: The build scaffold the packages above share. Licence: Apache-2.0.
  • apps/api, apps/worker, apps/mcp-server, packages/shared, packages/vault, packages/dropoff, packages/mcp-server, deploy, docs/self-managed, .github/workflows/engine-images.yml, scripts/licence-dev.mjs: The engine, under the Fair Core License: the rail (passports, Missions, proxy, model gateway, MCP server, connections, drop-offs, agent-to-agent), the pattern detectors with their built-in rules, the controls (policy engine, limits, held actions, reviews, approvals, the control socket), the record, the worker, and the self-managed packaging. STACK's hosted business (accounts and their pieces, billing, the skills marketplace and the Console glue) is not part of this repository; the engine reaches none of it except through the seams it declares (see docs/self-managed/README.md). Memory (the knowledge graph and its engine) is hosted only: it is part of the account, and the engine app is not exported. The STACK network's server side (installs, countersignatures, cross-company revocation, the detection and classify services, licence revocation) is STACK's paid hosted layer and is not exported either: the engine keeps only the client that calls it with a licence key. Licence: FCL-1.0-ALv2.
  • scripts/generate-spec.mjs, scripts/generate-spec-identity.mjs, scripts/generate-spec-interfaces.mjs, scripts/generate-spec.test.mjs, scripts/lib/rest-api-spec.mjs, scripts/lib/route-scope-hook.mjs, scripts/rest-api-spec.test.mjs: Tooling that needs the engine to run: the generator of the specification's schemas and tool catalog. Licence: Apache-2.0.

Licences differ by folder. LICENSE at the root lists them and each folder carries its own LICENSE; the full texts are in LICENSES/. What each licence means for you is in spec/LICENSING.md.

Start here

  • Build an implementation of a specification. Read spec/: the Passport, the control socket protocol, the provider interface, the record format and the MCP tool catalog. Run the conformance kit against what you build.

  • Verify a signed record offline, without trusting STACK:

    npx @getstackrun/verify pack.json
    
  • Write your own control server, the server that decides what your agents may do: start from examples/control-socket.

  • Use the SDKs and the command line: packages/sdk, sdk-python, packages/cli.

Building

Node 22 or later and pnpm (the version pinned in package.json) are required.

pnpm install
pnpm build
pnpm test

Contributing and security

Read CONTRIBUTING.md first: contributions need a signed contributor licence agreement. Report a vulnerability as SECURITY.md describes, never in a public issue. Everyone taking part is expected to follow the code of conduct. The name and logo are covered by the trademark policy.

Repository: https://github.com/getstack-run/stack

No installation packages available.

Remote