Live Tables use TQL filter expressions, not SQL. Pass a table UUID (or resolveByName) and a single-line filter. queryAll paginates past the 500-row cap. Read Database docs.

runTurn or subscribe?

runTurn is for headless scripts: dispatch and wait for a sealed turn. subscribe and subscribeStreaming are for live composer UIs over the same SessionHandle. See Sessions docs.

@trickest/sdk

One typed client for the whole platform.

Runs, sessions, Live Tables, memory, and skills behind one TrickestClient. Native fetch, one Zod dependency, auto-pagination.

See the code SDK docs

Install, authenticate, first call

Token comes from the environment. The client fails fast when it is missing.

quickstart.ts · $ shell

1import { TrickestClient } from "@trickest/sdk"
2
3// Reads TRICKEST_TOKEN; throws if missing.
4const client = new TrickestClient()
5
6for await (const space of client.spaces.list()) {
7  console.log(space.name)
8}
9
10// One page at a time:
11const page = await client.spaces.listPage()

$ npm install @trickest/sdk
$ export TRICKEST_TOKEN=<token>
$ npx tsx quickstart.ts

Everything one client reaches

Runs, tables, agent turns, memory, skills. Typed methods, no REST plumbing.

new TrickestClient()

One client, the whole platform.

21 lazy namespaces behind one object. Native fetch, one Zod dependency.

client.skills

Install skill playbooks.

Filesystem SKILL.md files, not plugins.

client.runs.execute

Trigger a run, or one node.

Fleet and vault resolve from the workflow. Re-run a single node, memoized.

client.database.query

Query Live Tables in TQL.

A filter expression, not SQL. queryAll pages past the 500-row cap.

client.memory.search

Search what the agent remembers.

Hybrid vector and keyword recall over the session vault.

Delegate a turn, get structured output

runTurn sends a prompt to an agent session and waits for the turn to seal. Ask for JSON and the answer parses straight into your own shape.

delegate.tsrunTurn

agent delegation

1import { TrickestClient, runTurn } from "@trickest/sdk"2 3const client = new TrickestClient()4const handle = await client.sessions.handle(5  sessionId,6  vaultId,7)8 9// Ask the agent to answer as JSON.10const turn = await runTurn(handle, {11  prompt: "Summarize this changelog. Reply as JSON.",12})13 14// The answer parses into your own shape.15const result = JSON.parse(turn.answer)

structured output

{"title": "Analytics 2.4","released": "2026-07-14","highlights": ["Saved views on every report","Bulk CSV export","Faster cold starts"],"breaking": false}

Four examples

Runs, agent turns, live deltas, TQL. Copy one as a starting point.

$ npm install @trickest/sdk

Run a workflow, or re-run a single node.

Pass { node } and the SDK reads the workflow graph, finds the last completed run whose upstream subjobs succeeded, and memoizes from it. Fleet and vault resolve from the workflow when you leave them out.

execute.ts13 lines

1import { TrickestClient } from "@trickest/sdk"
2 
3const client = new TrickestClient() // reads TRICKEST_TOKEN
4 
5// Full run. Fleet + vault auto-resolve from the workflow.
6const run = await client.runs.execute(workflowId, {
7  inputs: { domain: "example.com" },
8})
9 
10// Single node. Upstream outputs memoized from a recent run.
11const partial = await client.runs.execute(workflowId, {
12  node: "httpx",
13})

TypeScript·native fetch·Zod runtime dep·MIT

questions

Frequently asked

Need the full reference? Open SDK docs.

@trickest/sdk targets Node 22+, ships ESM and CJS, uses native fetch, and carries one runtime dependency, Zod. Install it with npm. See Install guide.

Same engine, other surfaces

Pick the next cut of the stack.

See the code Read the docs

Get a personalized demo

See Trickest in Action

A 30-minute walkthrough. We map the platform to your stack and answer pricing and deployment questions for your environment.

Book a demo Explore the platform

import { TrickestClient } from "@trickest/sdk"

// Reads TRICKEST_TOKEN; throws if missing.

const client = new TrickestClient()

for await (const space of client.spaces.list()) {

console.log(space.name)

}

// One page at a time:

const page = await client.spaces.listPage()

1import { TrickestClient, runTurn } from "@trickest/sdk"2 3const client = new TrickestClient()4const handle = await client.sessions.handle(5 sessionId,6 vaultId,7)8 9// Ask the agent to answer as JSON.10const turn = await runTurn(handle, {11 prompt: "Summarize this changelog. Reply as JSON.",12})13 14// The answer parses into your own shape.15const result = JSON.parse(turn.answer)

import { TrickestClient } from "@trickest/sdk"

const client = new TrickestClient() // reads TRICKEST_TOKEN

// Full run. Fleet + vault auto-resolve from the workflow.

const run = await client.runs.execute(workflowId, {

inputs: { domain: "example.com" },

})

// Single node. Upstream outputs memoized from a recent run.

const partial = await client.runs.execute(workflowId, {

node: "httpx",

})