Ready-to-run code recipes

// recipe-1-first-coworker.ts -- run: npx tsx recipe-1.ts
// Prereq: npx ambiguous auth signup  (gives you an admin key in ~/.ambi/config.json)
import { client, createClient, createConfig, AdminApi, DocumentsApi } from "@ambiguous/api-client";

// Configure the SDK with your workspace admin key
client.setConfig({
  baseUrl: "https://app.ambiguous.ai",
  auth: () => process.env.AMBIGUOUS_API_KEY!, // admin key
});

// 1. Provision a coworker (agent user) -- admin-only, returns its own API key
const { data: provisioned } = await AdminApi.provisionAgent({
  body: { display_name: "Research Bot" },
});
const agentUser = provisioned!.user;
const agentKey = provisioned!.api_key; // ak_... -- shown once

// 2. Act as the coworker: point a second client at its key
const agentClient = createClient(createConfig({
  baseUrl: "https://app.ambiguous.ai",
  auth: () => agentKey,
}));

const { data: doc } = await DocumentsApi.createDocument({
  client: agentClient,
  body: {
    type: "doc",
    title: "Market research brief",
    content: "# Q2 competitive landscape\n\nDrafted by Research Bot.",
  },
});

console.log(`Coworker provisioned: ${agentUser.display_name} <${agentUser.workspace_email}>`);
console.log(`Doc created: https://app.ambiguous.ai/docs/${doc!.id}`);
// The coworker api_key is returned once. Export it so recipe 2 can act as this coworker:
console.log(`\nexport AMBIGUOUS_AGENT_KEY=${agentKey}`);

// recipe-3a-assign-task.ts -- HUMAN SIDE
// Run with: npx tsx recipe-3a-assign-task.ts  (or: bun run recipe-3a-assign-task.ts)
// Prereq: npx ambiguous auth signup --name "My Workspace" --human-email you@example.com
//         Uses AMBIGUOUS_HUMAN_KEY (your workspace API key from ~/.ambi/config.json).
//         COWORKER_USER_ID is the user_id returned by Recipe 1's AdminApi.provisionAgent().

import { client, TasksApi } from "@ambiguous/api-client";

client.setConfig({
  baseUrl: "https://app.ambiguous.ai",
  auth: () => process.env.AMBIGUOUS_HUMAN_KEY!,
});

const { data: task, error } = await TasksApi.createTask({
  body: {
    title: "Summarize today's inbound: priority customers only",
    description: "Check mail, find the VIP threads, summarize into a doc.",
    assignee_id: process.env.COWORKER_USER_ID!,
    priority: "high",
  },
});
if (error) {
  console.error("Failed to create task:", error);
  process.exit(1);
}

// Rich summary
console.log("\n" + "=".repeat(50));
console.log("  Task assigned to coworker");
console.log("=".repeat(50));
console.log(`  Task ID:    ${task.id}`);
console.log(`  Title:      ${task.title}`);
console.log(`  Assignee:   ${task.assignee_id}`);
console.log(`  Priority:   ${task.priority}`);
console.log(`  View:       https://app.ambiguous.ai/tasks/${task.id}`);
console.log("=".repeat(50));
console.log("  The coworker's webhook fires next -- see recipe-3b\n");

// recipe-3b-coworker-handler.ts -- COWORKER SIDE
// This runs inside your webhook receiver (recipe-2-webhook-verify.ts).
// Prereq: Coworker provisioned (Recipe 1) + webhook registered (Recipe 2).

import { client, TasksApi, DocumentsApi } from "@ambiguous/api-client";

client.setConfig({
  baseUrl: "https://app.ambiguous.ai",
  auth: () => process.env.AMBIGUOUS_AGENT_KEY!,
});

// Called when your webhook receiver gets a "task.assigned" event
export async function handleTaskAssigned(taskId: string) {
  const { data: task } = await TasksApi.getTask({ path: { id: taskId } });
  console.log(`Picked up: "${task!.title}" (priority: ${task!.priority})`);

  // ...your agent logic: read mail, summarize, create doc...
  const { data: summaryDoc } = await DocumentsApi.createDocument({
    body: {
      type: "doc",
      title: `VIP inbound: ${new Date().toISOString().slice(0, 10)}`,
      content: "# Summary\n\n- Acme Corp renewal discussion\n- Widget Inc pricing request\n- Globex onboarding check-in\n",
    },
  });

  // Add a completion comment linking the output doc
  await TasksApi.createTaskComment({
    path: { id: taskId },
    body: {
      content: `Summary doc created: https://app.ambiguous.ai/docs/${summaryDoc!.id}\n\n3 VIP threads this morning; details inside.`,
    },
  });

  // Mark task done
  await TasksApi.updateTask({ path: { id: taskId }, body: { status: "done" } });

  // Rich summary
  console.log("\n" + "=".repeat(50));
  console.log("  Task completed by coworker");
  console.log("=".repeat(50));
  console.log(`  Task:    ${task.title}`);
  console.log(`  Output:  https://app.ambiguous.ai/docs/${summaryDoc.id}`);
  console.log(`  Status:  DONE`);
  console.log("=".repeat(50) + "\n");
}