Using Standalone Packages

import { KeyValueClient } from '@agentuity/keyvalue';
 
const kv = new KeyValueClient();
await kv.set('cache', 'user:123', { name: 'Alice', role: 'admin' });
const result = await kv.get('cache', 'user:123');

bun add @agentuity/keyvalue

import { KeyValueClient } from '@agentuity/keyvalue';
 
const kv = new KeyValueClient();
 
// Store with optional TTL (in seconds)
await kv.set('cache', 'session:abc', { userId: '123' }, { ttl: 3600 });
 
// Retrieve
const result = await kv.get('cache', 'session:abc');
if (result.exists) {
  console.log(result.data);
}
 
// Search keys by keyword
const matches = await kv.search('cache', 'session');
 
// Delete
await kv.delete('cache', 'session:abc');

bun add @agentuity/vector

import { VectorClient } from '@agentuity/vector';
 
const vector = new VectorClient();
 
// Upsert documents (embeddings are generated automatically)
await vector.upsert('docs', {
  key: 'doc-1',
  document: 'Agentuity provides cloud-native agent hosting',
  metadata: { source: 'readme' },
});
 
// Search by natural language query
const results = await vector.search('docs', {
  query: 'how to deploy agents',
  limit: 5,
});

bun add @agentuity/sandbox

import { SandboxClient } from '@agentuity/sandbox';
 
const client = new SandboxClient();
 
// One-shot execution (creates, runs, destroys automatically)
const result = await client.run(
  { command: { exec: ['echo', 'hello world'] } },
  { stdout: process.stdout, stderr: process.stderr }
);
console.log('Exit code:', result.exitCode);
 
// Interactive sandbox (long-lived)
const sandbox = await client.create({ runtime: 'bun:1' });
await sandbox.execute({ command: ['bun', 'install'] });
await sandbox.writeFiles([{ path: 'index.ts', content: Buffer.from('console.log("hi")') }]);
await sandbox.destroy();

bun add @agentuity/queue

import { QueueClient } from '@agentuity/queue';
 
const queue = new QueueClient();
 
// Create a queue
await queue.createQueue('notifications');
 
// Publish a message
await queue.publish('notifications', {
  type: 'welcome',
  userId: '123',
});
 
// Delete a queue
await queue.deleteQueue('notifications');

bun add @agentuity/db

import { DBClient } from '@agentuity/db';
 
const db = new DBClient({
  database: 'my-database',
  orgId: 'org_abc123',
});
 
// Execute a query
const result = await db.query('SELECT * FROM users LIMIT 10');
console.log(result.columns, result.rows);
 
// List tables
const tables = await db.tables();
 
// Get query logs
const logs = await db.logs({ limit: 50 });

bun add @agentuity/email

import { EmailClient } from '@agentuity/email';
 
const email = new EmailClient();
 
// Create a managed email address
const address = await email.createAddress('support');
 
// Send an email
await email.send({
  from: address.address,
  to: 'user@example.com',
  subject: 'Welcome!',
  text: 'Thanks for signing up.',
});
 
// List inbound emails
const inbound = await email.listInbound(address.id);

bun add @agentuity/webhook

import { WebhookClient } from '@agentuity/webhook';
 
const webhooks = new WebhookClient();
 
// Create a webhook endpoint
const result = await webhooks.create({ name: 'stripe-events' });
 
// Add a destination
await webhooks.createDestination(result.webhook.id, {
  type: 'url',
  config: { url: 'https://myapp.com/api/stripe' },
});
 
// List receipts
const receipts = await webhooks.listReceipts(result.webhook.id);

bun add @agentuity/schedule

import { ScheduleClient } from '@agentuity/schedule';
 
const schedules = new ScheduleClient();
 
// Create a schedule (runs every hour)
const result = await schedules.create({
  name: 'hourly-sync',
  cron: '0 * * * *',
});
 
// List all schedules
const list = await schedules.list();
 
// Get a specific schedule
const details = await schedules.get(result.schedule.id);

bun add @agentuity/task

import { TaskClient } from '@agentuity/task';
 
const tasks = new TaskClient();
 
// Create a task
const task = await tasks.create({
  title: 'Fix login bug',
  type: 'bug',
  priority: 'high',
});
 
// Add a comment
await tasks.createComment(task.id, 'Reproduced on Chrome 120', 'user_abc');
 
// Tag it
const tag = await tasks.createTag('urgent', '#ff0000');
await tasks.addTagToTask(task.id, tag.id);
 
// List all tasks
const list = await tasks.list({ status: 'open' });

import { KeyValueClient } from '@agentuity/keyvalue';
 
// Minimal: uses env vars for everything
const kv = new KeyValueClient();
 
// Explicit: override specific options
const kvCustom = new KeyValueClient({
  apiKey: 'agentuity_sk_...',
  orgId: 'org_abc123',
});