1. What Was Built (For Humans)

In two days, we built a centralized API worksuite that competes with SkillBoss.co — one API key that gives developers access to language models, image/video generation, social media scraping, email, SMS, document processing, and multi-agent orchestration.

The Customer Experience

What Makes AaaS Different From SkillBoss

SkillBoss wraps 679 APIs behind one key. We do the same AND add multi-agent orchestration — 7 foundry chains that compose 63 skills into autonomous workflows. DevOps incident response, revenue pipeline, customer success, HR, finance, legal. No competitor offers agent composition as a public API.

2. All 31 Gateway Routes

Category	Method	Path	Description	Status
SYSTEM (no auth)
	GET	/v1/status	Health check	Live
	POST	/v1/billing/webhook	Stripe payment confirmation	Live
ONBOARDING (Firebase ID token)
	POST	/v1/onboard/reveal-key	Reveal auto-provisioned API key	Live
	GET	/v1/onboard/status	Check onboard status (keys, credits)	Live
LLM (Bearer auth)
	GET	/v1/models	List 20 available models	Live
	POST	/v1/chat/completions	Multi-provider LLM routing (OpenAI format)	Code ready
MEDIA (Bearer auth)
	POST	/v1/images/generations	FLUX, SD, Ideogram, Recraft via Replicate	Code ready
	POST	/v1/videos/generations	Kling, Sora, Runway via Replicate	Code ready
	POST	/v1/audio/speech	ElevenLabs, OpenAI TTS, Google TTS	Code ready
	POST	/v1/audio/transcriptions	Whisper STT	Code ready
	POST	/v1/audio/music	MusicGen, Lyria, Stable Audio	Code ready
	POST	/v1/audio/sfx	ElevenLabs sound effects	Code ready
	POST	/v1/embeddings	OpenAI text-embedding-3	Code ready
	GET	/v1/media/models	List all media models	Live
COMPOSE (Bearer auth) — AaaS EXCLUSIVE
	GET	/v1/compose/chains	List 7 foundry chains	Live
	GET	/v1/compose/foundries	List 6 foundries with slot counts	Live
	GET	/v1/compose/skills	List 63 composable skills	Live
	POST	/v1/compose/mega-grind	Execute full foundry pipeline	Live
INTELLIGENCE (Bearer auth)
	POST	/v1/scrape/company	Extract company data from domain	Live
	POST	/v1/scrape/classify	Classify industry (Vertex AI)	Live
	POST	/v1/skills/match	Match skills to classification	Live
	POST	/v1/agents/suggest	Suggest agents for business	Live
UNIVERSAL RUN (Bearer auth) — routes to 118 sub-endpoints
	POST	/v1/run	Universal endpoint: Apify(30), Scrapecreators(48), EnsembleData(13), Firecrawl(3), Linkup(3), Prelude(3), Reducto(2), Replicate(16)	Code ready
	GET	/v1/run/models	List all available run models	Live
BILLING (Bearer auth)
	GET	/v1/billing/balance	Current credit balance	Live
	GET	/v1/billing/packages	Top-up packages ($5/$25/$50/$100)	Live
	GET	/v1/billing/usage	Usage history with cost breakdown	Live
	POST	/v1/billing/checkout	Stripe checkout session	Needs Stripe
KEYS (Bearer auth)
	GET	/v1/keys	List user's API keys	Live
	POST	/v1/keys/create	Create new key (max 5)	Live
	POST	/v1/keys/revoke	Revoke key by ID	Live

Live Functional now   Code ready Deployed, needs upstream API key   Needs Stripe Awaiting Stripe account

3. Upstream Provider Integrations (15 vendors)

Provider	Category	Models/Endpoints	Key Status	Code
Google Vertex AI	LLM + Classification	2 models + classifier	Live (ADC)	google.ts
Anthropic	LLM	3 models	Needs key	anthropic.ts
OpenAI	LLM + Audio + Embeddings	5 LLM + TTS + Whisper + Embeddings	Needs key	openai.ts, openai-audio.ts
OpenRouter	LLM (multi-vendor)	5 models (DeepSeek, Llama, Mistral, Qwen)	Needs key	openrouter.ts
Perplexity	Search-augmented LLM	2 models	Needs key	perplexity.ts
Replicate	Image + Video + Audio	16 models	Needs key	replicate.ts
ElevenLabs	TTS + Music + SFX	3 endpoints	Needs key	elevenlabs.ts
Apify	Social automation	30 actors	Needs key	apify.ts
Scrapecreators	Social data	48 endpoints	Needs key	scrapecreators.ts
EnsembleData	Social analytics	13 endpoints	Needs key	ensembledata.ts
Firecrawl	Web scraping	3 endpoints	Needs key	firecrawl.ts
Linkup	Search	3 endpoints	Needs key	linkup.ts
Prelude	SMS	3 endpoints	Needs key	prelude.ts
Reducto	Documents	2 endpoints	Needs key	reducto.ts
Resend	Email	Email system (10 templates)	Needs key	email-sender.ts

4. Foundry Composition Engine

6 foundries, 27/27 slots filled, all chains READY. This is the AaaS-exclusive feature that no competitor offers.

Foundry	Agents	Slots	Status	Avg Score	Top Champion
F1 DevOps	5	6/6	Ready	49	Rollback Execution (91)
F3 Revenue	5	5/5	Ready	51	Brand Guideline Enforcement (71)
F4 Customer Success	3	3/3	Ready	31	Usage Trend Analysis (31)
F7 People	5	5/5	Ready	37	Calendar Negotiation (60)
F6 Finance	4	4/4	Ready	32	Monte Carlo Simulation (32)
F5 Legal	4	4/4	Ready	39	Clause Analysis (61)

5. Codebase Architecture

functions/src/
├── api/                            ← API Gateway (2,748 lines)
│   ├── gateway.ts                  — 31 routes, main HTTP handler
│   ├── types.ts                    — All type definitions
│   ├── errors.ts                   — OpenAI-compatible errors
│   ├── model-registry.ts           — 20 LLM models with pricing
│   ├── middleware/                  — Auth, rate limit, credits, usage (303 lines)
│   ├── routers/                    — LLM, billing, media, scrape (522 lines)
│   └── providers/                  — 15 upstream vendor integrations (1,098 lines)
│
├── lib/foundry/                    ← Composition Engine (1,446 lines)
│   ├── slot-registry.ts            — 27 slots across 6 foundries
│   ├── vault-scanner.ts            — Skill matching (category-filtered)
│   ├── tournament-engine.ts        — Karpathy-style competition
│   ├── chain-composer.ts           — Champion assembly
│   ├── chain-executor.ts           — Chain execution (dry-run + live)
│   ├── mega-grind.ts               — Full pipeline orchestrator
│   └── use-case-registry.ts        — 7 registered use cases
│
├── lib/                            ← Supporting modules
│   ├── email-sender.ts             — Resend integration
│   ├── email-composer.ts           — Template routing
│   ├── email-templates/ (10)       — Welcome → weekly digest pipeline
│   ├── scraper.ts                  — Zero-cost HTML scraping
│   ├── classifier.ts              — Vertex AI industry classification
│   ├── skill-matcher.ts            — Skill matching engine
│   └── agent-suggester.ts          — Agent recommendation
│
├── apiKeyProvisioner.ts            ← Auto-provision on signup
├── contextPipeline.ts              ← 5-step context generation
├── foundryFunctions.ts             ← Mega-grind + status endpoints
└── index.ts                        ← 13 exported Cloud Functions

apps/blog/src/seed/                 ← 147 Entity Seeds
├── seed-use-cases-devops.ts        — 5 DevOps agents
├── seed-use-cases-revenue.ts       — 5 Revenue agents
├── seed-use-cases-customer-success.ts — 3 CS agents
├── seed-use-cases-people.ts        — 5 People agents
├── seed-use-cases-finance.ts       — 4 Finance agents
├── seed-use-cases-legal.ts         — 4 Legal agents
├── seed-skills-devops.ts           — 18 DevOps skills
├── seed-skills-revenue.ts          — 11 Revenue skills
├── seed-skills-customer-success.ts — 8 CS skills
├── seed-skills-people.ts           — 10 People skills
├── seed-skills-finance.ts          — 8 Finance skills
└── seed-skills-legal.ts            — 8 Legal skills

6. Security & Credit Guard

Security Feature	Implementation
API key storage	SHA-256 hashed before Firestore write. Raw key never stored.
Rate limiting	Sliding window per key: 60 RPM, 10,000 RPD. Stored server-side.
Stripe webhook	Signature verification via stripe.webhooks.constructEvent()
Key reveal	One-time display. Stored in api_key_reveals/{userId}, marked after read.
Firebase Auth	Google OAuth + email/password. ID tokens verified server-side.
Firestore rules	api_keys, credits, rate_limits — no client read/write access.

7. Build History (Last 15 Commits)

8. Human Action Required

16 API keys need to be created at upstream providers and stored in GCP Secret Manager. Most are free signup, pay-as-you-go. Full details with signup URLs at open-issues (items 8-10).

Priority	Provider	Unlocks	Free Tier?
Critical	Stripe	Self-serve credit top-ups	Yes
Critical	OpenRouter	DeepSeek, Llama, Mistral, Qwen (30+ models)	Pay-as-you-go
Critical	Anthropic	Claude 4.5 Sonnet, Claude 4 Sonnet, Haiku	$5 free
Critical	OpenAI	GPT-5, TTS, Whisper, Embeddings	$5 free
High	Replicate	76+ media models (FLUX, Kling, Sora, MusicGen)	Pay-as-you-go
High	ElevenLabs	Premium TTS, music, sound FX	10K chars/mo
High	Perplexity	Search-augmented Sonar models	Free tier
Medium	Apify	130 social media actors	100 runs/mo
Medium	Scrapecreators	108 social data endpoints	Pay-as-you-go
Medium	Firecrawl	JS-rendered web scraping	500 pages/mo
Medium	4 others	EnsembleData, Linkup, Prelude, Reducto	Varies

9. Live URLs

What	URL
Platform	agents-as-a-service.com
Gateway docs	agents-as-a-service.com/gateway
Pricing	agents-as-a-service.com/pricing
API base URL	https://apigateway-q66ryynraa-uc.a.run.app
Knowledge Index	aaas.blog
Foundry dashboard	aaas-design.web.app/foundry
Deliveries hub	aaas-design.web.app/deliveries
This report	aaas-design.web.app/full-report
Open issues	aaas-design.web.app/open-issues
GitHub	github.com/ibossyNr1/aaas.blog

10. Planning Documents

Document	Path	Content
Master plan	docs/superpowers/plans/2026-03-28-aaas-api-gateway-plan.md	8 components, 12-week build sequence
Readiness matrix	docs/superpowers/plans/2026-03-28-component-readiness-matrix.md	What exists vs what to build per component
Category plans	docs/superpowers/plans/2026-03-28-api-category-buildplans.md	Per-category vendor mapping + effort estimates
Foundry backlog	tasks/foundry-backlog.md	6 foundries with agent specs + acceptance criteria
Testing backlog	tasks/testing-backlog.md	71 tests across 13 systems
Use-case index	context/use-case-entity-index.md	50 use cases mapped to 10 foundries
Open issues	tasks/open-issues.md	10 items requiring human action