Skip to content

Commit 07f2ce8

Browse files
authored
docs: refresh browserbase action policy packet
1 parent 2a0d363 commit 07f2ce8

4 files changed

Lines changed: 314 additions & 112 deletions

File tree

packages/integration/examples/browserbase-stagehand/browserbase-stagehand-packet-smoke.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -215,7 +215,7 @@ This proof signs a Browserbase MCP shaped browser session through \`@atrib/mcp-w
215215
## What ran
216216
217217
- Upstream surface: ${upstreamLine}
218-
- Atrib path: ${atribPath}
218+
- atrib path: ${atribPath}
219219
- Control path: ${result.action_policy ? `\`${BROWSERBASE_ACTION_POLICY_VERSION}\` signs the \`act\` decision and outcome before the Browserbase action runs.` : 'not enabled for this artifact.'}
220220
- Record policy: public records keep tool names plus \`args_hash\` and \`result_hash\`.
221221
- Verification: \`@atrib/mcp\` verifies each Ed25519 record signature after the wrapper writes its mirror.

proof-packets/browserbase-stagehand/README.md

Lines changed: 34 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,7 @@ This proof signs a Browserbase MCP shaped browser session through `@atrib/mcp-wr
1010

1111
- Upstream surface: Browserbase hosted Streamable HTTP MCP endpoint.
1212
- atrib path: `@atrib/mcp-wrap` around a hosted Streamable HTTP MCP upstream.
13+
- Control path: `browserbase-action-gate-v0` signs the `act` decision and outcome before the Browserbase action runs.
1314
- Record policy: public records keep tool names plus `args_hash` and `result_hash`.
1415
- Verification: `@atrib/mcp` verifies each Ed25519 record signature after the wrapper writes its mirror.
1516
- Log proof: accepted records were submitted to `https://log.atrib.dev/v1/entries` after full-flow verification; inclusion was verified.
@@ -19,25 +20,48 @@ This proof signs a Browserbase MCP shaped browser session through `@atrib/mcp-wr
1920

2021
| Tool | Record hash | Public log index |
2122
| -------- | ----------------------------------------------------------------------- | ---------------- |
22-
| start | sha256:535201b60e3660f1b2f5babcfdd85f09f3a1503f4ad73cfc419528285c696aae | 65792 |
23-
| navigate | sha256:1f92f466f3bcbab058f9dc2fec99c5536a6d2f9f71fd21aa6b1b48417f1ad19d | 65793 |
24-
| observe | sha256:4fd3e736c98b2652fda30963ff5d379db210b4dff71db401c39805936a1361d4 | 65794 |
25-
| act | sha256:9295f755361578f90242fe7e5d3d59c99a76e36942dfd2f7b34277dcf70cb65c | 65795 |
26-
| extract | sha256:8910a05fcfc243096e9238c311218304af569c1cc7e71774ccd834531d2ec028 | 65796 |
27-
| end | sha256:a78400352f4daab9d03ae606854c36565bbd911dba736ece22535f8a8ffec4a6 | 65797 |
23+
| start | sha256:3fec4c4fe89b52120116e10df30738e735305622a5d11b5e6a58044bd79c8a35 | 69802 |
24+
| navigate | sha256:310c9186053fc9aca97c18535634862e1698d29e94f10e611ededca406a349fd | 69803 |
25+
| observe | sha256:afb2d48ba555b06efd1ea7feaf052a0e630f8bb57167990782d0ade5c383030a | 69804 |
26+
| act | sha256:3afb35ced45576a91d7b870520adfeab16a8e20503eef8527c0b313cd2eea5c3 | 69805 |
27+
| extract | sha256:4dd3490d3eaed99cd2abc4ea112cf8d87970d9f591e5c73c0366c5cf270ccb85 | 69806 |
28+
| end | sha256:9a9a4833f9df89deb95742d8a61781695fe2435e514b688fd7b9efcc033dbf8c | 69807 |
2829

2930
Representative public links:
3031

31-
- Explorer: <https://explore.atrib.dev/action/sha256:535201b60e3660f1b2f5babcfdd85f09f3a1503f4ad73cfc419528285c696aae>
32-
- Log proof: <https://log.atrib.dev/v1/proof/535201b60e3660f1b2f5babcfdd85f09f3a1503f4ad73cfc419528285c696aae>
32+
- Explorer: <https://explore.atrib.dev/action/sha256:3fec4c4fe89b52120116e10df30738e735305622a5d11b5e6a58044bd79c8a35>
33+
- Log proof: <https://log.atrib.dev/v1/proof/3fec4c4fe89b52120116e10df30738e735305622a5d11b5e6a58044bd79c8a35>
34+
35+
## Action policy gate
36+
37+
The runner evaluates `browserbase-action-gate-v0` before `act`. The decision
38+
record is signed before the Browserbase tool call. If the decision is `block`
39+
or `escalate`, the runner stops before `act` and closes the session with
40+
`end` when possible.
41+
42+
| Tool | Decision | Decision record | Decision index | Outcome record | Outcome index |
43+
| ---- | -------- | ----------------------------------------------------------------------- | -------------- | ----------------------------------------------------------------------- | ------------- |
44+
| act | allow | sha256:f69c1470d23ffc99eff13b53b9b623770db6671a72596683dfe925e1af16c113 | 69808 | sha256:d5ea20d9ef67977ba3d37dc1c1579fbc2c121d8ee160e9fa8a17b3bfd0874c0a | 69809 |
45+
46+
- Policy event type: `https://browserbase-action-gate.atrib.dev/v1/decision`
47+
- Stopped before: none
48+
- Blocked tool executed: false
3349

3450
## Redaction line
3551

36-
The wrapper saw private Browserbase-shaped payloads: session id, replay URL, page snapshot, selector, form value, and extracted page text. The public artifact stores only hashes for those fields. See `redaction-manifest.json`.
52+
The wrapper saw private Browserbase-shaped payloads: session id, replay URL,
53+
page snapshot, selector, form value, and extracted page text. The action policy
54+
also saw target, action, and observed-state inputs. The public artifact stores
55+
only hashes or public fixed instructions for those fields. See
56+
`redaction-manifest.json`.
3757

3858
## Weakness
3959

40-
This proof run signs the wrapper path, record chain, hash-only disclosure, public log inclusion, verifier path, and real Browserbase MCP command path. It still keeps Browserbase replay material private. Hosted Browserbase MCP can return temporary model-capacity errors; public publication starts only after the full six-step flow verifies.
60+
This proof run signs the wrapper path, record chain, hash-only disclosure,
61+
public log inclusion, verifier path, real Browserbase MCP command path, and
62+
signed action-policy records. It still keeps Browserbase Live View and replay
63+
material private. Hosted Browserbase MCP can return temporary model-capacity
64+
errors; public publication starts only after the full six-step flow verifies.
4165

4266
## Demo boundary
4367

proof-packets/browserbase-stagehand/redaction-manifest.json

Lines changed: 29 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,26 +1,49 @@
11
{
22
"schema": "atrib.proof_packet.redaction_manifest.v1",
33
"packet": "browserbase-stagehand",
4+
"action_policy": {
5+
"event_type": "https://browserbase-action-gate.atrib.dev/v1/decision",
6+
"decisions": [
7+
{
8+
"decision": "allow",
9+
"record_hash": "sha256:f69c1470d23ffc99eff13b53b9b623770db6671a72596683dfe925e1af16c113",
10+
"reason_codes": ["policy_allow"],
11+
"observed_record_hash": "sha256:afb2d48ba555b06efd1ea7feaf052a0e630f8bb57167990782d0ade5c383030a"
12+
}
13+
],
14+
"outcomes": [
15+
{
16+
"decision": "allow",
17+
"executed": true,
18+
"record_hash": "sha256:d5ea20d9ef67977ba3d37dc1c1579fbc2c121d8ee160e9fa8a17b3bfd0874c0a"
19+
}
20+
],
21+
"stopped_before": null,
22+
"blocked_tool_executed": false
23+
},
424
"private_fields": [
525
{
626
"field": "target_url",
727
"disclosure": "hash-only",
8-
"hash": "sha256:100680ad546ce6a577f42f52df33b4cfdca756859e664b8d7de329b150d09ce9"
28+
"hash": "sha256:7ff155fa92253f1e49f79487c507bb8d9d0f3e6d388ba410889dbdc64495b7cb"
929
},
1030
{
1131
"field": "observe_instruction",
12-
"disclosure": "hash-only",
13-
"hash": "sha256:5e8f823187ba1e71ad6eb66fd488c1140134e58cfdf5ed695537310ad0774264"
32+
"disclosure": "public-fixed"
1433
},
1534
{
1635
"field": "act_action",
17-
"disclosure": "hash-only",
18-
"hash": "sha256:e92427736ac5cb1394c3ca3e9b436facfbcd493cca64eb188e5c4011f97eecab"
36+
"disclosure": "public-fixed",
37+
"hash": "sha256:d929ca76215e074a44d023f0bc0aa8b1f25638c45e70e2d6497edbad3a89bda7"
1938
},
2039
{
2140
"field": "extract_instruction",
41+
"disclosure": "public-fixed"
42+
},
43+
{
44+
"field": "observed_state",
2245
"disclosure": "hash-only",
23-
"hash": "sha256:10e12442c832ffc07d391f13e2842fe6c06e49765e9f27fa12e6d3e49901221e"
46+
"hash": "sha256:0cc101ae51f1f16dc0e917e6672f48eae44b31a1193d429f146ac3f6baeeb382"
2447
},
2548
{
2649
"field": "browserbase_session_or_replay_url",

0 commit comments

Comments
 (0)