New recipe: Browser Automation: Invoice Drafts and Web Research by arunt14 · Pull Request #119 · microsoft-foundry/forgebook

AKT_18 (arunt14) · 2026-10-22T12:18:47Z

Browser Automation: Invoice Drafts and Web Research

Add a notebook-first Forgebook recipe for validating a synthetic invoice form without submitting it and researching public sources with evidence-backed synthesis.

The contribution includes the notebook, a recipe-scoped Python companion and tests, synthetic fixtures/demo form, an architecture diagram, and registry/author metadata. The invoice workflow verifies all nine fields, a fresh page marker, zero submission attempts, and browser-session closure. The research workflow gathers bounded source-backed findings and date excerpts, records limitations, and synthesizes results without inventing evidence.

Review status

Nick Brady approved the PR; all inline review threads are resolved.
The recipe remains offline-first and does not include credentials, tenant-specific configuration, or real invoice data.
Nick identified these non-blocking fast-follow items: confirm the preview snapshot's observed-URL contract with a real response and fixture; support/correlate native GA remote_function_call evidence; preserve distinct session identity in redacted evidence; and attempt/report session closure after request or stream failures.

Validation

Recipe tests: 135 passed. Notebook schema and cleared-output checks passed.
GitHub CI passed registry validation, preview-token routing, site build, accessibility, and CodeQL checks for Actions, JavaScript/TypeScript, and Python.
No fresh live Foundry/MCP run was performed. In particular, the observed-URL metadata format in a real preview snapshot is not yet confirmed; live-path verification remains a follow-up.

Remaining confirmations

Confirm completion of the internal authoring workflow and any required Internal Recipe Proposal or maintainer waiver. The guidance was reviewed, but workflow completion has not been verified.
Confirm whether Nick's review satisfies the repository's Foundry PM, engineering, or DX product-review requirement.
Run the notebook end-to-end with live Foundry/MCP. Offline validation passed, but live execution remains unverified; Nick approved the PR with the technical follow-ups above.

Include an offline-first notebook, scoped companion and regression tests, synthetic fixtures, architecture diagram, and recipe/author metadata. Preserve synthetic PDF bytes with scoped binary attributes on Windows. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 7eb79d57-9712-4cd7-a653-cbb6979c0b92

github-actions · 2026-10-22T12:26:41Z

🔍 Preview

A live preview of this PR is available at:
https://microsoft-foundry.github.io/forgebook/preview/pr-119/

Copilot

🟡 Changes recommended

Evidence checks do not establish the inspected page’s identity, and cost estimates use unverified deployment pricing.

2 open issues

What changed in this PR

Adds a draft Forgebook recipe teaching evidence-verified browser automation with Microsoft Foundry and Playwright Workspaces MCP. It pairs an offline-first notebook with a recipe-scoped Python companion; publication approval and fresh cloud validation remain pending.

Changes:

Demonstrates synthetic invoice drafting and bounded three-source research.
Adds typed contracts, evidence checks, request budgeting, setup/cleanup helpers, and offline regression tests.
Registers the recipe and author, with a synthetic demo form and architecture diagram.

File	Description
`registry.yaml`	Registers the recipe and tags.
`notebooks/media/browser-automation-invoice-and-research/01-evidence-led-architecture.svg`	Illustrates workflows and verification gates.
`notebooks/data/browser-automation-invoice-and-research/tests/test_notebook.py`	Tests offline execution and live preflight checks.
`notebooks/data/browser-automation-invoice-and-research/tests/test_diagnostics.py`	Tests diagnostics, evidence, and session handling.
`notebooks/data/browser-automation-invoice-and-research/tests/test_contracts.py`	Tests contracts, scope restrictions, and budgets.
`notebooks/data/browser-automation-invoice-and-research/scripts/summarize_run.py`	Summarizes verification outcomes and usage.
`notebooks/data/browser-automation-invoice-and-research/scripts/render_demo.py`	Renders a fresh form marker.
`notebooks/data/browser-automation-invoice-and-research/scripts/host_demo.ps1`	Provisions synthetic-form hosting.
`notebooks/data/browser-automation-invoice-and-research/scripts/diagnose_bat.py`	Gates live validation behind a marker probe.
`notebooks/data/browser-automation-invoice-and-research/scripts/create_mcp_connection.ps1`	Creates a managed-identity MCP connection.
`notebooks/data/browser-automation-invoice-and-research/scripts/cleanup_demo.ps1`	Deletes inventoried demo resources.
`notebooks/data/browser-automation-invoice-and-research/scripts/__init__.py`	Defines the helper-script package.
`notebooks/data/browser-automation-invoice-and-research/requirements.txt`	Pins companion dependencies.
`notebooks/data/browser-automation-invoice-and-research/README.md`	Documents companion setup and operation.
`notebooks/data/browser-automation-invoice-and-research/instructions.md`	Defines draft-only and read-only agent instructions.
`notebooks/data/browser-automation-invoice-and-research/demo-form/invoice-entry.html`	Supplies nine-field readback and a submission counter.
`notebooks/data/browser-automation-invoice-and-research/bat_recipe/workflows.py`	Orchestrates invoice drafting and research synthesis.
`notebooks/data/browser-automation-invoice-and-research/bat_recipe/runner.py`	Manages agents, requests, budgets, and artifacts.
`notebooks/data/browser-automation-invoice-and-research/bat_recipe/paths.py`	Anchors assets and restricts artifact locations.
`notebooks/data/browser-automation-invoice-and-research/bat_recipe/evidence.py`	Checks page state, provenance, scope, and sessions.
`notebooks/data/browser-automation-invoice-and-research/bat_recipe/contracts.py`	Defines typed inputs, outputs, and validation rules.
`notebooks/data/browser-automation-invoice-and-research/bat_recipe/browser_evidence.py`	Normalizes and validates browser tool evidence.
`notebooks/data/browser-automation-invoice-and-research/bat_recipe/__init__.py`	Defines the companion package.
`notebooks/data/browser-automation-invoice-and-research/assets/expected_invoice_result.json`	Supplies expected synthetic invoice values.
`notebooks/data/browser-automation-invoice-and-research/.gitignore`	Excludes local configuration and caches.
`notebooks/data/browser-automation-invoice-and-research/.gitattributes`	Preserves PDF fixture bytes.
`notebooks/data/browser-automation-invoice-and-research/.env.example`	Provides placeholder live configuration.
`notebooks/browser-automation-invoice-and-research.ipynb`	Teaches the offline-first workflow and optional cloud run.
`authors.yaml`	Adds the recipe author profile.

_{Review effort: Balanced}

AKT_18 (arunt14)

Please review

Updated cost estimation logic to handle deployment-specific pricing. Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Nick Brady (nicholasdbrady)

Request changes — 77/100. This recipe presents a useful evidence-led browser pattern with reusable contracts and careful safeguards. Before publishing, bind invoice and research claims to snapshots of the exact browser-observed URLs, require source evidence for empty research results, handle supported stream response shapes with useful redacted diagnostics, and clearly distinguish the GA Browser Automation Tool from the preview remote MCP integration. Preserve regression tests for unvisited pages, missing snapshots, and incorrect URLs.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>`nCopilot-Session: 053546bc-02a7-4710-be20-4c488b4c8d05

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 053546bc-02a7-4710-be20-4c488b4c8d05

Nick Brady (nicholasdbrady)

Thanks for the updates to stream parsing, URL-bound evidence checks, empty-result evidence, diagnostics, and GA/preview labeling. Approving this revision, with the remaining items recommended for a fast-follow PR rather than holding this PR:

Confirm the preview snapshot's observed-URL contract against a real response and add a representative fixture; the verifier currently requires metadata absent from a captured preview snapshot.
Support and correlate the native GA remote_function_call / remote_function_call_output evidence types before describing that route as verified. Keep the current unverified label until then.
Preserve session identity through redaction with stable, distinct aliases so persisted-evidence checks cannot confuse different sessions.
Explicitly attempt browser-session closure after stream/request failures, and report any session whose closure cannot be confirmed.

Please retain focused regression coverage for these cases. This approval does not mean the remaining live-path issues are resolved.

AKT_18 (arunt14) requested a review from Nick Brady (nicholasdbrady) October 22, 2026 12:18

AKT_18 (arunt14) requested a balanced review from Copilot October 22, 2026 12:54

Copilot started reviewing on behalf of AKT_18 (arunt14) October 22, 2026 12:54

View session

Copilot AI reviewed Oct 22, 2026

View reviewed changes

Comment thread notebooks/data/browser-automation-invoice-and-research/bat_recipe/evidence.py Resolved

Comment thread notebooks/data/browser-automation-invoice-and-research/scripts/summarize_run.py Resolved

AKT_18 (arunt14) commented Oct 23, 2026

View reviewed changes

AKT_18 (arunt14) marked this pull request as ready for review October 23, 2026 06:46

AKT_18 (arunt14) requested a review from a team as a code owner October 23, 2026 06:46

Modify known usage cost estimate to None

bc7a125

Updated cost estimation logic to handle deployment-specific pricing. Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Nick Brady (nicholasdbrady) requested changes Nov 7, 2026

View reviewed changes

AKT_18 (arunt14) and others added 2 commits November 9, 2026 12:47

Address BAT Forgebook review feedback

f7e44d4

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>`nCopilot-Session: 053546bc-02a7-4710-be20-4c488b4c8d05

Fix review wording and diagnostic redaction

343074a

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 053546bc-02a7-4710-be20-4c488b4c8d05

Nick Brady (nicholasdbrady) approved these changes Nov 11, 2026

View reviewed changes

Navigation Menu

Repository navigation

New recipe: Browser Automation: Invoice Drafts and Web Research - #119

New recipe: Browser Automation: Invoice Drafts and Web Research#119
AKT_18 (arunt14) wants to merge 4 commits into
mainfrom
recipe/browser-automation-invoice-and-research

AKT_18 (arunt14) commented Oct 22, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Oct 22, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

AKT_18 (arunt14) left a comment

Uh oh!

Nick Brady (nicholasdbrady) left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Nick Brady (nicholasdbrady) left a comment

Uh oh!

This branch has not been deployed

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

AKT_18 (arunt14) commented Oct 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Browser Automation: Invoice Drafts and Web Research

Review status

Validation

Remaining confirmations

Uh oh!

github-actions Bot commented Oct 22, 2026

🔍 Preview

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

🟡 Changes recommended

Uh oh!

Uh oh!

Uh oh!

AKT_18 (arunt14) left a comment

Choose a reason for hiding this comment

Uh oh!

Nick Brady (nicholasdbrady) left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Nick Brady (nicholasdbrady) left a comment

Choose a reason for hiding this comment

Uh oh!

This branch has not been deployed

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

AKT_18 (arunt14) commented Oct 22, 2026 •

edited

Loading