Building an Agent

my-summarizer/
├── aerostack.json     # OFS manifest
├── src/
│   └── index.ts       # Agent logic
└── package.json

{
  "name": "summarize-document",
  "version": "1.0.0",
  "description": "Summarize long-form text into bullets and key points",
  "runtime": "workers",
  "inputs": {
    "text": { "type": "string", "required": true },
    "maxBullets": { "type": "number", "default": 5 }
  },
  "outputs": {
    "summary": { "type": "string" },
    "bullets": { "type": "array", "items": { "type": "string" } }
  },
  "requires": ["ai"]
}

// src/index.ts
export default async function({ text, maxBullets }, { sdk }) {
  const result = await sdk.ai.complete({
    model: 'gpt-4o-mini',
    system: `Summarize documents. Return JSON with "summary" (1 sentence) and "bullets" (${maxBullets} key points).`,
    prompt: text,
    maxTokens: 512,
  })
 
  // Parse the JSON response
  const parsed = JSON.parse(result.text)
 
  return {
    summary: parsed.summary,
    bullets: parsed.bullets.slice(0, maxBullets),
  }
}

# Login
aerostack login
 
# Publish to the marketplace
aerostack agents publish
 
# Your agent is available as:
# sdk.agents.run('your-username/summarize-document', { text })

# Publish a specific version
aerostack agents publish --version 1.1.0
 
# Users can pin to a version
aerostack agents add [email protected]