What Flows just did
Based on your request to build Observability for Agent Runs, Flows created 4 implementation stages and 12 checks.
You asked for: Instrument the agent with structured tracing (OpenTelemetry-compatible), build session replay, track cost per session, and run failure analysis on real data.. Flows generated 4 stages because the application requires Every run traced: model calls, tool executions, decisions as spans with attributes; Session replay: reconstruct any run step-by-step from stored events; Cost and token metrics per call, aggregated per session and per task class. Each stage tells your AI builder what to do, tests whether it actually worked, and gives a repair instruction when it fails. These checks are designed to catch: Unstructured print-logging that cannot reconstruct a run; Traces without token/cost attributes, blinding the economics; Secrets in span payloads, turning observability into a breach.
Example failure
The form reported success, but no database record was created.
What Flows does
Flows detects the failure, generates a repair instruction, reruns the test, and stores the passing evidence.
Stages — Plan → Build → Test → Fix → Prove → Ship
4 stages · 12 checks · progressive disclosure — open a stage for details
Copy to external builder
Copies a prompt for Claude/Cursor/etc. Records prompt_copied only — not execution, commits, or checks.
Execute through Oort
Requires Sign in with Oort + a provider connection (BYOK). Keys stay on Oort. A model name in the dropdown is not the same as a live connection.
Next
Check off: Hierarchy covers all loop operations
Add a proof note on each check — a checkbox alone is weak proof.
Probes & advanced tools are under “More verification tools”. Experience level: Settings.
Project (saved with proof)
Project binding: Unbound — complete project binding before trusting this run · missing repositoryUrl, repositoryStartCommit, environment, stack
More verification tools (probes, timeline, adapters)Show
App persistence (create → read → assert token)
Body template: {"probe":"{{token}}","title":"flows-probe-{{token}}"}. Needs CORS-readable public create/list endpoints (or inconclusive). Badge only when create→read→refresh finds the token (detects false success).
Two-account authorization (User B cannot see/change User A)
Authorization evidence source: Cross-account ownership test (trust level 5/6). These are not equivalent. Unauthenticated probe alone is weaker (source: unauthenticated API probe). Tokens stay in this browser session only — not uploaded to Flows servers.
Generated edge-case tests (review / approve)
- api_probe Logged-out users cannot open protected pages
- api_probe Protected API rejects requests without credentials
- api_probe Expired session cannot mutate data
- browser_automation Logout in one tab invalidates mutations from another
- cross_account_probe User B cannot see or change User A’s data
- cross_account_probe Participant cannot call coach/admin endpoints
- cross_account_probe URL/body ID tampering cannot cross tenant boundary
Generated from this route’s signals — you approve; you do not invent security tests.
Content probe (GET body contains text)
In-product content probe reads response text when CORS allows — not full DOM/click automation. Playwright script is optional and external.
Proof strength
thin · 0/100
Heuristic from notes + probes + gates — not a production certification.
Verification adapters
- ● Deploy URL probe · idle
- ● API path probe · idle
- ● Authz probe (unauth → 401/403) · idle
- ● Browser persistence · idle
- ● App persistence (create→read) · idle
- ● Content / body text probe · idle
- ○ In-product Playwright DOM · not embedded (download external script)
Filled circles = available here. Empty = not shipped. Probes are not a production audit. Adapter docs
Step 1 of 4
Not startedInstrument spans across the loop
The trace tree is the run's skeleton - build it first.
Flows keeps plan, checks, failures, and next steps connected
Your AI tool writes or changes the code
Repository grounds the plan only after inspect
Checks always carry a validation tier
How this plan was created
Plan from project details
Flows creates steps using the goal, requirements, stack, platform, and details you provide.
- Project description
- Selected template / route
- User-entered stack
- Constraints and notes
- Observability for Agent Runs
No repository inspection implied. Connect and inspect a codebase to ground steps in real files.
Codebase access
Checking GitHub…
Or paste a repository URL manually
Use these instructions in Claude, ChatGPT, Cursor, Emergent, or another builder.
Add structured tracing to the agent. Span hierarchy: session -> task -> turn -> {model_call, tool_execution, hook_check, compaction, memory_op}. Attributes per span type: model calls get model, tier, tokens in/out, cost, latency, stop reason; tool spans get tool name, argument digest, result size, verdict; hook spans get rule and verdict. Use OpenTelemetry SDK conventions (GenAI semantic conventions where they fit) so exporters and existing backends work. Export to your available backend (an OTLP collector, or a local trace store if self-contained). Add a scrubber on attribute capture: known secret patterns and configured sensitive fields are redacted before export. Verify one session renders as a correct, complete tree.
Project context
Copies the project goal, technical details, current step, previous progress, and checks so your AI tool understands what it is working on.
Expected after this step
A complete scrubbed trace tree for a real session.
Should not happen
- ✕Unstructured print-logging that cannot reconstruct a run
- ✕Traces without token/cost attributes, blinding the economics
- ✕Secrets in span payloads, turning observability into a breach
- ✕Dashboards built, never used - observability without a debugging workflow
Verify gate — prove this step works before continuing
Do not move on until every check is true. Add proof notes — a checked box alone is weak proof. Checks are manual by default; deploy/API probes live under “More verification tools” and do not auto-check boxes.
Do not continue if…
- !Unstructured print-logging that cannot reconstruct a run
- !Traces without token/cost attributes, blinding the economics
- !Secrets in span payloads, turning observability into a breach
- !Dashboards built, never used - observability without a debugging workflow
Repair path — if this step fails
Use the Repair Prompt when a verify gate fails. Loop: Detected → Diagnosed → Repair issued → Changed → Retested → Resolved
Show repair prompt textShow
The tree has gaps (orphan spans, missing turns). Check context propagation - every operation must open its span inside its parent's context; async boundaries are the usual leak point.
Your notes for this step
Definition of Done
Final route-level requirements. Manual checks — separate from per-step verify gates. Completing step gates does not auto-check these. Route completion is not a production-ready claim.