Getting started
Sort incoming text into your categories, then act on it.
Siftline asks a model a fixed set of questions about each piece of text and gives you the answers as plain values: a label, a yes/no, a level. You write the questions once, measure how well they are answered on examples you label, then run them on real text and route each answer to a webhook, a Slack channel, or nowhere. There is no generated prose anywhere in the loop.
The toolkit is three npm packages, all ESM-only, all on Node 22.14 or newer.
@siftline/cli
siftline test and siftline label: run a Recipe from the terminal.
@siftline/core
The Engine: Recipes, the Judge, Rules, Fixtures and the Decision format.
@siftline/actions
Adapters that carry a Decision to a webhook or to Slack.
Install
The guide starts with the CLI, which needs no code:
npm install --save-dev @siftline/cliSet your TypeSafe API key in the environment. The CLI reads it from there and nowhere else:
export TYPESAFE_API_KEY=...
npx siftline --versionAdd @siftline/core when you want to do the same from TypeScript, and @siftline/actions
when a Decision has to go somewhere:
npm install @siftline/core @siftline/actions @typesafe-ai/sdk@typesafe-ai/sdk is the client the Engine talks through. The CLI bundles it; from code you
construct it, as The same from code shows.
Where to go next
- Concepts defines the eleven words the rest of the site uses.
- The guide builds one support inbox end to end, in the order you would work: write the questions, measure them, run them, route, send.
- Packages lists what each package exports and how it fails.
- The API reference is generated from the source and always matches the published types.
0.1.0
The first release with the Engine in it. Until 1.0 a breaking change is a minor bump, so pin exact versions.