Blueprints API

// List all blueprints and group by domain
const blueprints: Blueprint[] = await fetch('/api/blueprints').then(r => r.json());

const work = blueprints.filter(bp => bp.domain === 'work');
const personal = blueprints.filter(bp => bp.domain === 'personal');

console.log(`${work.length} work blueprints, ${personal.length} personal`);
work.forEach(bp => console.log(`  ${bp.name} [${bp.pattern}] — ${bp.tags.join(', ')}`));

// Register a blueprint from YAML content
const yaml: string = `
id: daily-standup-report
name: Daily Standup Report
description: Generate a daily standup summary from project tasks
version: 1.0.0
domain: work
tags: [standup, reporting]
pattern: sequence
variables:
- id: project_name
  type: text
  label: Project Name
  required: true
steps:
- name: Gather Status
  profileId: project-manager
  promptTemplate: "List all tasks updated in the last 24 hours for {{project_name}}"
  requiresApproval: false
- name: Write Summary
  profileId: technical-writer
  promptTemplate: "Write a standup summary from the task status data"
  requiresApproval: false
`.trim();

const blueprint: Blueprint = await fetch('/api/blueprints', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ yaml }),
}).then(r => r.json());

console.log(`Registered: ${blueprint.id}`);

// Import a blueprint from GitHub — validates and registers automatically
const { id, name }: { id: string; name: string } = await fetch('/api/blueprints/import', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
  url: 'https://github.com/acme/stagent-blueprints/blob/main/blueprints/code-review.yaml',
}),
}).then(r => r.json());

console.log(`Imported "${name}" as ${id}`);

// Fetch a blueprint to build a dynamic form for its variables
const bp: Blueprint = await fetch('/api/blueprints/code-review-pipeline')
.then(r => r.json());

// Build a form from the variable schema
bp.variables.forEach(v => {
console.log(`${v.label} (${v.type})${v.required ? ' *' : ''}`);
if (v.default) console.log(`  default: ${v.default}`);
});

// Instantiate — variables are substituted into step prompts
const workflow: Workflow = await fetch('/api/blueprints/code-review-pipeline/instantiate', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
  variables: {
    repo_url: 'https://github.com/acme/payments-service',
    branch: 'feature/stripe-v3',
    focus_areas: 'security, error handling, input validation',
  },
  projectId: 'proj-8f3a-4b2c',
}),
}).then(r => r.json());

console.log(`Created workflow: ${workflow.id}`);
console.log(`Status: ${workflow.status}`); // "draft" — execute to start

// Delete a user-created blueprint — built-ins are protected
const res: Response = await fetch('/api/blueprints/daily-standup-report', {
method: 'DELETE',
});

if (res.status === 403) {
console.log('Cannot delete built-in blueprints');
}