Architect

interface ArchitectMessageOptions {
  messages: ChatMessageInput[];   // { role: 'user' | 'assistant', content: string }[]
  resume?: ChatResume;            // answers a pending interrupt from a previous run
  signal?: AbortSignal;           // aborts the underlying request/stream
}

const result = await persona.architect.sendMessage({
  messages: [{ role: 'user', content: 'Build me an agent that summarizes PDFs.' }],
});

if (result.interrupt) {
  const resume = await persona.architect.sendMessage({
    messages: [],
    resume: { decisions: [{ action: 'upsert_agent', decision: 'approve' }] },
  });
  console.log(resume.text);
}

import { PersonaClient } from '@personaai/sdk';

// Control-plane: builds Project-owned Agents.
const persona = new PersonaClient({
  baseUrl: process.env.PERSONA_BASE_URL!,
  credential: process.env.PERSONA_CREDENTIAL!,
});

const result = await persona.architect.sendMessage({
  messages: [
    {
      role: 'user',
      content:
        'Create an agent named "PDF Summarizer" that summarizes uploaded PDFs. Use provider ' +
        '"OpenAI (prod)" and make it unlisted.',
    },
  ],
});

if (result.interrupt) {
  // Approve the agent creation the Architect proposed.
  const approved = await persona.architect.sendMessage({
    messages: [],
    resume: { decisions: [{ action: 'upsert_agent', decision: 'approve' }] },
  });
  console.log(approved.text);
} else if (result.error) {
  console.error(result.error.code, result.error.message);
} else {
  console.log(result.text);
}