feat(m3.8): browser workflow nodes

[ralyodio]

Implements M3.8 — workflow-engine integration (PRD §21.1), the final M3 milestone. Base main.

import { runWorkflow, browserHandlers, sdkBrowser, exportWorkflowJson } from '@tronbrowser/workflow-engine';

const workflow = { id:'leads', name:'Scrape', entry:'open', nodes: {
  open:  { id:'open',  type:'browser', next:['links'], config:{ action:'open', url:'https://example.com' } },
  links: { id:'links', type:'browser', next:[],        config:{ action:'extract', mode:'links' } },
}};
const result = await runWorkflow(workflow, { variables: {} }, browserHandlers(sdkBrowser({ headless: true })));
console.log(exportWorkflowJson(result));

What's here

• nodes/browser.ts — one BrowserNode handler dispatching config.action → open/snapshot/click/fill/type/extract/screenshot/analyze/runTask on a shared SDK page (same primitives as CLI/MCP). Mutating actions output a fresh snapshot; screenshot writes the file and outputs its path. Missing config throws a BrowserNodeError with recovery guidance. sdkBrowser() is the default managed-session backing.
• runner.ts — runWorkflow walks the graph from entry, threads each output into ctx.variables[nodeId], and closes the browser on completion. exportWorkflowJson serializes results; a failed node reports { nodeId, error, recovery: { recoverable, suggestion } } (e.g. a stale ref → "insert a snapshot node").
• index.ts — richer BrowserNodeConfig.

Acceptance criteria (PRD §22)

• ✅ Workflow nodes use the same SDK primitives as CLI and MCP.
• ✅ Workflow outputs export as JSON.
• ✅ Failed browser nodes include recovery details (and trace links where a trace is active).

Verification — +10 tests

• Every browser action against a fake page (open/click/fill/extract/screenshot/analyze, missing-field error).
• The runner: graph execution + output threading + browser close, JSON export, failure with recovery (STALE_REF → snapshot suggestion), missing-handler.
• Full workspace suite green in CI order (build → typecheck → test) from clean.

Scope

Library milestone — no CLI/dispatcher wiring. Runner is linear-first (next[0]); branching builds on the same NodeHandler contract. See docs/workflow-nodes.md.

This completes M3.1–M3.8. 🎉

🤖 Generated with Claude Code

[github-actions]

vu1nz Security Review

0 finding(s) in PR #?

No security issues found.