Slice 4: tyto open, brief, find, and action feedback

[rvegajr]

Stacked on #7. Spec sentences are in docs/IMPLEMENTATION.md §4 Slice 4.

What

Core (pure)

• assembleBrief / renderBrief. The brief covers:

  • failed Fetch/XHR requests, with a redacted response snippet;
  • uncaught errors, and console errors and warnings;
  • API calls;
  • cookie names and lifetimes (never values);
  • storage key counts;
  • page outline, up to 40 interactive refs, and the main text.

  It's scoped to the current page by log offsets, because agent-browser's errors --clear doesn't clear.

• findLines: whole-page text search.

• afterAction: what changed after an action.

• normalizeRefs: e12 → @e12.

• Mappers from agent-browser's JSON output.

• New LogMarks port, with a fake and a file adapter (~/.tyto/marks, 0600).

CLI

• tyto open <url>, tyto brief [--json], tyto find <words>.
• Action commands (click, fill, type, press, select, check, uncheck, hover, scroll, dblclick) that print an AFTER report.
• --session picks the agent's agent-browser session (default $AGENT_BROWSER_SESSION or default).

Found and fixed live

Passing a different AGENT_BROWSER_DEFAULT_TIMEOUT to a single command makes agent-browser restart that session's browser; Edge came back on its new-tab page. Browse commands now never pass env overrides, and a test pins that. Replays are unaffected: they always pass the same settings.

Tests

• npm run check: 10 files, 95 tests, typecheck clean, gitleaks clean.

• npm run test:live: 5 passed. The live brief tests use a throwaway agent-browser config, so they never touch saved logins.

• Manual end to end, through Edge:

  Command	Result	Time
  tyto open on the planted-bug page	Root cause shown (/api/items 500 database timeout plus the console error), 143 tokens	1.6 s cold / 0.35 s warm
  tyto click #save	Reported the uncaught TypeError with its source line	0.3 s
  tyto find on Wikipedia	"Conservation status ⏎ Vulnerable (IUCN 3.1)"	0.16 s

🤖 Generated with Claude Code