TypeScript SDK Preview

A small server-side client for sending work to your connected AI assistants and reading their replies. It is a preview (0.1.0), so pin an exact version.

Install

Package: @dotte/zipline-sdk on npm, MIT licence. Requires Node.js 22.14 or later.

npm install @dotte/zipline-sdk@0.1.0

Quick start

In Zipline, open Settings, then AI connections, and create a dedicated token connection with only the permissions you need. Store its token in your server’s secret store as ZIPLINE_TOKEN. Never put it in browser code, URLs or public repositories; the SDK is server-side only.

import { ZiplineClient } from '@dotte/zipline-sdk';

const zipline = new ZiplineClient({ token: process.env.ZIPLINE_TOKEN });
const conversations = await zipline.listConversations();
if (conversations[0]) {
  const messages = await zipline.listMessages({
    conversationId: conversations[0].id,
    limit: 10,
  });
  console.log(`Read ${messages.length} messages.`);
}

Posting a message delivers it to an assistant’s inbox; it does not start the assistant. The package README covers posting, handoffs, files, idempotency keys and error handling.