Brain Surface

// { workspaceId: string, apiKeyId: string }

interface AgentMetadata {
  id: string; slug: string; name: string;
  brand: { id?: string; slug?: string; name?: string } | string | null;
  activeWorkflowId: string | null;
}

interface AgentFileEntry {
  key: string; size?: number; mimeType?: string | null;
}

interface AgentItem {
  id: string; name: string; kind: string; origin?: string | null;
  r2Key: string;              // agent-scoped (relative to storagePrefix)
  mimeType: string | null; size: number | null;
  folder: string | null; order: number | null; updatedAt: string;
}

interface FeedQuery {
  channel?: string; category?: string;
}

interface FeedPost {
  id: string;
  key: string;                 // agent-scoped cover/primary media r2 key
  kind: 'still' | 'reel' | 'carousel' | 'story' | 'deck' | string;
  mediaType: string | null;    // legacy 'image'|'video'; prefer kind
  title: string | null; sub: string | null; caption: string | null;
  hashtags: string[]; channels: string[]; category: string | null;
  width: number | null; height: number | null;
  createdAt: string;
  pages: FeedPage[];           // carousel / story pages
  poster: string;              // video poster frame key
  playable: string;            // mp4/webm key when a transcode exists
  isVideo: boolean;
}

interface FeedPage {
  key: string; mediaType: string | null;
  width: number | null; height: number | null; order: number | null;
}

const res = await brain.streamR2File('config/design-tokens.json');
const tokens = JSON.parse(await res.text());

interface ChatRequest {
  prompt: string;
  client?: string;    // salted visitor hash → per-visitor rate limiting
  threadKey?: string; // resume a thread
  history?: { role: 'user' | 'assistant'; content: string }[];
  section?: string;   // scope to a page/section
  brandSlug?: string;
}

interface ChatStreamEvent {
  type: 'token' | 'delta' | 'done' | 'error' | string;
  text?: string; content?: string; message?: string;
}

let reply = '';
for await (const ev of brain.chat(agentId, {
  prompt: 'Tell me about your work.',
})) {
  if (ev.type === 'error') throw new Error(ev.message);
  if (ev.text) reply += ev.text;
}