Presswork

The agents don't call each other. They read and write a shared Supabase schema, and each owns one stage of the pipeline. Scout writes `trend_briefs`. Design picks up briefs in `pending` status and writes `design_packages`. Listing picks up packages and publishes to Etsy. Ledger watches Etsy receipts and writes `orders` with derived margins. Status transitions on shared rows are the whole API.

There's no central orchestrator, so each agent has its own runtime, deployment cadence, and retry behavior. Scout runs on a nightly cron, since trends don't change minute to minute. Design and Listing poll every 15 minutes, because image generation is slow and expensive. Ledger polls every 30 minutes, because Etsy receipts settle slowly. They scale and fail on their own: if fal.ai is unavailable, Design stalls at its own stage while the others keep working through the existing backlog, because none of them is waiting on a call it doesn't make itself.

Scout and Design are Python, using `httpx`, `pydantic`, and `structlog`. Listing and Ledger are TypeScript, using `Zod` for schemas and `Bottleneck` for rate-limited Etsy calls. The shared schema is the contract that lets them differ. Each language has its own client library in the monorepo, `packages/shared_py` for the Python agents and `packages/shared` for TypeScript, wrapping Supabase access, Etsy auth refresh, and Slack and email notifications.

The split is deliberate: Python's data and AI tooling for the LLM-heavy upstream stages, and TypeScript's type safety and async ergonomics for the money-touching downstream ones. The cost is doing everything twice: two dependency trees, two client libraries that have to stay in step with one schema, and a CI job that typechecks both stacks and runs an end-to-end test driving a single trend brief through all four agents against fixture data.

Three places in the pipeline can duplicate work that costs money, and each one has its own guard. The Design agent SHA-256 hashes the final image prompt before calling fal.ai, so an identical prompt reuses the earlier image instead of paying for a duplicate. Scout runs both exact-match and Claude-powered semantic dedup before writing a brief, so near-duplicate trends don't flood the pipeline. Ledger puts a unique constraint on `etsy_order_id`, so polling can run as often as it likes without counting a sale twice.

When something fails, `structlog` emits a structured line, and a Slack webhook fires on any low-margin order. A separate daily cron sends a revenue and margin digest over Slack and email.

Etsy returns receipts in the buyer's currency. Printify charges in USD. Etsy's fees depend on listing price, payment method, and shipping origin. True margin is `(USD sale − Etsy fees − print cost)`, and each of those three terms comes from a different source.

Ledger normalizes currencies from a daily rate snapshot, computes fees from Etsy's published rules, looks up print costs by SKU, and writes the final margin onto the row. That same row feeds both the daily digest and the low-margin Slack alert, so every dollar figure on the dashboard traces back to one place.