Public beta. APIs may change before general availability.

For the full reference, see the root README and docs.md.

Capability map

New here? The Theo Harness Capability Map is the discovery front-door — every harness primitive with its import path, signature, and a one-line example (find compactTranscript, buildRepoMap, isTransientError, @theokit/sdk/persistence, ... without reading source). The exhaustive contract is docs.md.

Install

npm install @theokit/sdk

Quick start

import { Agent } from "@theokit/sdk";

const agent = await Agent.create({
  apiKey: process.env.THEOKIT_API_KEY!,
  model: { id: "composer-2" },
  local: { cwd: process.cwd() },
});

const run = await agent.send("Summarize what this repository does");

for await (const event of run.stream()) {
  console.log(event);
}

Schedule with cron

import { Cron } from "@theokit/sdk";

await Cron.create({
  cron: "0 9 * * *",
  timezone: "America/Sao_Paulo",
  message: "Summarize yesterday's commits",
  agent: {
    apiKey: process.env.THEOKIT_API_KEY!,
    model: { id: "composer-2" },
    local: { cwd: process.cwd() },
  },
});

await Cron.start();   // required for local jobs to fire

Two runtimes: local (in-process scheduler — fires while the host process is alive) and cloud (Theo PaaS schedules server-side). See docs.md for the full Cron contract.

Status

This package is a scaffold. The contract is defined in docs.md. Implementation lands incrementally — see CHANGELOG.md.

License

MIT — see LICENSE.