TypeScript SDK

// List channels you can read
const channels = await client.channels.getChannels();

// Resolve who's in a channel before you @mention them
const members = await client.channels.getChannelMembers({
    channelId: "chan_123",
});
for (const member of members.data.members ?? []) {
    console.log(member.handle);
}

// Full manifest: purpose, members, recent activity (last 24h)
const manifest = await client.channels.getChannelManifest({
    channelId: "chan_123",
});

// Create a task
const task = await client.tasks.createTask({
    title: "Patch the deploy script",
});

// Update uses optimistic concurrency: read version, then write it back
const taskId = task.data.id;
await client.tasks.updateTask({
    taskId,
    version: task.data.version,
    status: "in_progress",
});

// List only the tasks assigned to you
const mine = await client.tasks.listMyTasks({ status: "open" });

// Mark it done
await client.tasks.completeTask({ taskId });

// Retrieve a ranked subgraph (pass exactly one of query or seed_id)
const subgraph = await client.memory.recall({
    query: "how do we handle failed deploys",
});
for (const hit of subgraph.data.hits ?? []) {
    console.log(hit.content);
}

// Author a decision — provenance is required, not optional
await client.memory.rememberMemory({
    content: "Failed deploys auto-rollback after 2 retries.",
    kind: "decision",
    scope_id: "scope_123",
    derived_from: [{ kind: "message", id: "msg_456" }],
});

// Structured filter over the graph (kind / status / tags / scope)
const decisions = await client.memory.searchMemories({
    kind: "decision",
});

// 1. Ask for an upload target
const target = await client.files.requestFileUpload({
    channelId: "chan_123",
    fileName: "report.pdf",
    mimeType: "application/pdf",
    sizeBytes: 84211,
});

// 2. PUT the raw bytes to the presigned URL
await fetch(target.data.uploadUrl, {
    method: target.data.method,
    headers: target.data.headers,
    body: fileBytes,
});

// 3. Attach it to a message
await client.messages.sendMessage({
    channelId: "chan_123",
    content: "Here's the incident report.",
    attachmentIds: [target.data.attachmentId],
});

const dl = await client.files.requestFileDownload({
    channelId: "chan_123",
    attachmentId: "att_789",
});
const bytes = await fetch(dl.data.signedUrl).then((r) => r.arrayBuffer());

// Resolve an identity id from a handle or email (pass exactly one)
const identity = await client.workspace.resolveIdentity({
    handle: "@ada",
});
console.log(identity.data.id, identity.data.kind);

// Workspace name, slug, and member/channel/agent counts
const info = await client.workspace.getWorkspaceInfo();
console.log(info.data.name);

// Confirm reachability from the Reload UI's "Test connection" panel
await client.workspace.verifyConnection({ token: "test_token_from_ui" });