Flue & Eve Agent Frameworks Documentation

Pages

1. OverviewWhat Flue and Eve expose, how the workspace repos relate, runtime assumptions, and the shortest source-backed paths into each framework.
2. InstallationPrerequisites, package managers, Node engine requirements, and first-install commands for Flue and Eve projects.
3. Flue quickstartScaffold a Flue project, run `flue dev`, invoke a workflow with `flue run`, and connect to an agent instance with `flue connect`.
4. Eve quickstartRun `eve init`, start `eve dev`, inspect discovery with `eve info`, and send the first session message to the stable HTTP API.
5. Flue project layoutSource-root resolution (`.flue/` vs `src/`), agent and workflow modules, `app.ts` composition, and discovery boundaries.
6. Eve project layoutAuthored slots under `agent/`, path-derived naming, workspace seeding rules, and subagent package boundaries.
7. Runtime modelsCompare Flue sessions, workflow runs, and dispatch receipts with Eve sessions, turns, `continuationToken`, and `sessionId` contracts.
8. Build Flue agentsAuthor agents with `createAgent`, `defineAgentProfile`, tools, skills, sandboxes, providers, and HTTP route handlers.
9. Flue workflowsDefine workflow modules, initialize agents inside `run()`, invoke via CLI or HTTP, and inspect run events with `flue logs`.
10. Flue channelsDiscover channel modules, mount verified webhook routes under `/channels/:name`, and dispatch inbound events to agents.
11. Flue deployChoose Node or Cloudflare targets, register providers in `app.ts`, build artifacts with `flue build`, and apply blueprint-driven integrations.
12. Eve authoring surfacesConfigure `agent.ts`, write instructions, tools, skills, connections, sandbox overrides, subagents, and schedules from the filesystem contract.
13. Eve sessions and streamingStart sessions, stream NDJSON events, send follow-ups with `continuationToken`, and handle HITL, subagent, and compaction events.
14. Eve deploymentBuild `.eve/` artifacts, configure Vercel env and sandbox backends, prewarm templates, deploy, and verify production routes.
15. Flue CLI referenceCommands, flags, defaults, and exit behavior for `flue dev`, `run`, `connect`, `build`, `init`, `add`, `update`, `docs`, and `logs`.
16. Flue configuration reference`flue.config.*` keys (`target`, `root`, `output`), source-root precedence, env loading, and CLI override rules.
17. Flue HTTP API referenceMounted routes (`/agents`, `/workflows`, `/runs`, `/channels`, `/openapi.json`), admission semantics, stream reads, and error envelopes.
18. Flue persistence reference`PersistenceAdapter` contract, store interfaces, built-in database adapters, and `db.ts` discovery for durable execution.
19. Eve CLI referenceCommands and flags for `eve init`, `info`, `build`, `start`, `dev`, `link`, `deploy`, `eval`, and `channels` subcommands.
20. Eve HTTP protocol referenceSession routes, NDJSON event types, `continuationToken` follow-ups, stream reconnect rules, and client integration entry points.
21. Flue examplesCopy-pasteable fixtures for hello-world workflows, channel ingress, observability adapters, and target-specific integrations.
22. Eve weather fixtureWalk through the `weather-agent` fixture: instructions, tool schema, skill procedure, and local dev smoke paths.