@prodedify/sdk

Durable AI engineers, as an API. Official TypeScript SDK for the Prodedify Platform.

Create an agent once — it keeps its own machine (hibernates when idle, resumes in ~1–2 seconds), its own memory (it remembers every prior run), and its own work history.

Prodedify is a Claude partner. The Platform runs on Claude.

Install

npm install @prodedify/sdk

Quickstart

import { Prodedify } from '@prodedify/sdk';

const prodedify = new Prodedify({ apiKey: process.env.PRODEDIFY_API_KEY! });

// Create a durable agent
const agent = await prodedify.agents.create({
  name: 'Docs Engineer',
  instructions: 'You are a careful engineer. Keep replies brief.',
});

// Put it to work
const run = await prodedify.runs.create(agent.id, {
  input: 'Create /home/user/demo/hello.txt containing: hello platform',
  idempotencyKey: 'my-first-run', // retries are safe
});

// Watch it work (auto-reconnects with cursor resume)
for await (const event of prodedify.runs.stream(run.id)) {
  if (event.type === 'token') process.stdout.write(String(event.data.text ?? ''));
  if (event.type === 'done') console.log('\n✓ done');
}

// Tomorrow: it remembers.
const followUp = await prodedify.runs.create(agent.id, {
  input: 'What does the file you created earlier contain? Verify from disk.',
});

Memory

await prodedify.memory.seedFact(agent.id, {
  summary: 'Authentication uses Better Auth',
  category: 'architecture',
});

const { hits } = await prodedify.memory.query(agent.id, 'how do we handle auth?');

The machine

await prodedify.agents.machine(agent.id);   // { status: 'hibernated', ... }
await prodedify.agents.wake(agent.id);      // resumes in ~1-2s
await prodedify.agents.readFile(agent.id, '/home/user/demo/hello.txt');

Webhooks & usage

const endpoint = await prodedify.webhooks.create('https://example.com/hooks', [
  'run.completed',
  'run.failed',
]);
// Verify deliveries: X-Prodedify-Signature: t=...,v1=HMAC_SHA256(secret, `${t}.${body}`)

const usage = await prodedify.usage(); // credits, request budget, agent counts

Partner badge

Building on the Platform? Carry the badge:

import { BADGE_MARKDOWN, badgeHtml } from '@prodedify/sdk';

Reference

Machine-readable OpenAPI: https://api.prodedify.com/api/v1/public/platform/openapi.json · Docs: docs.prodedify.com

MIT © Prodedify