Commands

1
const { data: result } = await r.commands.execute({
2
  prompt: 'Create a new project called "analytics-dashboard" and set up a database.',
3
  current_screen: '/dashboard/projects',
4
  org_slug: 'my-org',
5
  model: 'anthropic/claude-sonnet-4',
6
  locale: 'en',
7
});
8
9
console.log(result.text);    // Natural language response
10
console.log(result.actions); // Structured actions the AI wants to perform

1
interface Attachment {
2
  url: string;       // URL to the file
3
  mime?: string;     // MIME type (e.g., 'image/png')
4
  filename?: string; // Original filename
5
}

1
interface ExecutePromptResult {
2
  text: string;                       // AI's natural language response
3
  actions: Record<string, unknown>[]; // Structured actions to perform
4
}

1
const { data: result } = await r.commands.execute({
2
  prompt: 'Analyze this screenshot and suggest UI improvements.',
3
  attachments: [
4
    {
5
      url: 'https://storage.example.com/screenshot.png',
6
      mime: 'image/png',
7
      filename: 'dashboard-screenshot.png',
8
    },
9
  ],
10
});
11
12
console.log(result.text);

1
const { data: result } = await r.commands.execute({
2
  prompt: 'What can I do from this screen?',
3
  current_screen: '/projects/proj_123/deployments',
4
  org_slug: 'acme-corp',
5
  locale: 'en',
6
});
7
8
console.log(result.text);
9
// "From the deployments screen, you can: 1. Trigger a new deployment..."

1
const { data: result } = await r.commands.gatePrompt({
2
  messages: [
3
    { role: 'user', content: 'Help me write a Python script to analyze CSV data.' },
4
  ],
5
  model: 'anthropic/claude-sonnet-4',
6
});
7
8
console.log(result.approved); // true or false
9
console.log(result.reply);    // AI's explanation of the decision

1
interface GatePromptMessage {
2
  role: 'user' | 'assistant';
3
  content: string;
4
}

1
interface GatePromptResult {
2
  reply: string;     // The AI's response/explanation
3
  approved: boolean; // Whether the prompt is approved
4
}

1
async function moderateMessage(userMessage: string): Promise<boolean> {
2
  const { data: gate } = await r.commands.gatePrompt({
3
    messages: [
4
      { role: 'user', content: userMessage },
5
    ],
6
  });
7
8
  if (!gate.approved) {
9
    console.log('Message blocked:', gate.reply);
10
    return false;
11
  }
12
13
  return true;
14
}
15
16
// Usage
17
const allowed = await moderateMessage('Help me build a REST API');
18
if (allowed) {
19
  // Proceed with the command
20
  const { data: result } = await r.commands.execute({
21
    prompt: 'Help me build a REST API',
22
  });
23
  console.log(result.text);
24
}

1
const conversation = [
2
  { role: 'user' as const, content: 'I want to deploy my app.' },
3
  { role: 'assistant' as const, content: 'Sure! Which project would you like to deploy?' },
4
  { role: 'user' as const, content: 'The analytics dashboard, to production.' },
5
];
6
7
const { data: gate } = await r.commands.gatePrompt({
8
  messages: conversation,
9
});
10
11
if (gate.approved) {
12
  const { data: result } = await r.commands.execute({
13
    prompt: conversation[conversation.length - 1].content,
14
    current_screen: '/projects/analytics-dashboard',
15
  });
16
  console.log(result.text);
17
  console.log(result.actions);
18
}