TypeScript SDK
Use @stacklok-oss/mecatl-sdk to create sessions, run agents, handle approvals,
follow durable activity, and call the rest of the Mecatl API from TypeScript.
The package supports Node.js, Bun, Deno, and browser applications.
The Deno integration described here is unreleased and excluded from SDK v0.1.0. Its first supported SDK release has not been assigned.
Start with Use the TypeScript SDK to run one prompt against a private offline daemon.
Choose a workflow
- Connect an application to use an operator-owned daemon from Node.js, Bun, Deno, or a browser.
- Run a private local daemon when a Node.js, Bun, or Deno
process should own
mecated, or when a script needs onequery()call. - Work with sessions and runs to stream events, receive a terminal result, send controls, or include media in a prompt.
- Handle permissions and plans to resolve asks in application code and continue an approved plan.
- Resume durable activity to follow one run or a session's cross-run timeline from an application-owned cursor.
- Register callback tools to expose local Node.js or Bun handlers to sessions created by a private daemon.
- Inspect a server before creating a session to check compatibility, deployment capabilities, and safe build identity.
The SDK also exposes typed namespaces for models, agents, skills, teams, schedules, learning, MCP inventory, and storage operations. See the TypeScript SDK API reference for the complete public surface.
Package entry points
| Import | Use it for |
|---|---|
@stacklok-oss/mecatl-sdk | Deno and browser HTTP and SSE connections, injected transports, and transport-neutral types. |
@stacklok-oss/mecatl-sdk/node | Node.js and Bun gRPC connections, local daemons, one-shot queries, filesystem media helpers, and callback tools. |
@stacklok-oss/mecatl-sdk/deno | Deno gRPC connections, Deno.Command local daemons, and one-shot queries. |
@stacklok-oss/mecatl-sdk/gen | Generated protobuf-es messages and service descriptors for low-level calls and typed namespace requests. |