{"_id":"@dvcol/cdb-broker","_rev":"3-6aeee84eea574d2999759ac8a7c95069","name":"@dvcol/cdb-broker","dist-tags":{"bootstrap":"0.0.0","latest":"0.3.0"},"versions":{"0.0.0":{"name":"@dvcol/cdb-broker","version":"0.0.0","keywords":["chrome","chrome-debugger","cdp","browser-automation","mcp","agent"],"author":"dvcol","license":"MIT","_id":"@dvcol/cdb-broker@0.0.0","maintainers":[{"name":"dvcol","email":"dinh.van.colomban@gmail.com"}],"homepage":"https://github.com/dvcol/chrome-debugger-bridge#readme","bugs":{"url":"https://github.com/dvcol/chrome-debugger-bridge/issues"},"dist":{"shasum":"a552641619ffea80ef2c5b0aeffbeabb690b30bf","tarball":"https://registry.npmjs.org/@dvcol/cdb-broker/-/cdb-broker-0.0.0.tgz","fileCount":10,"integrity":"sha512-N60H7vxlatAFdA1cpflLi8rC52LGc6/7s5ko9wpK5/pCSc65HUYUMXfJ8+oMbSqXIRDkEewwHBKm8RU8hnvhOg==","signatures":[{"sig":"MEUCIEgfrFqlVyhWblfaZ8FqIw1Ynl5iaeCFgdyj8hUQfmDiAiEA2zZK2WO1VYrDBjhCAoi7dVcfqFKQVbkNaQ6BA5ZPFPY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@dvcol%2fcdb-broker@0.0.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":166182},"type":"module","engines":{"node":">=24.0.0"},"exports":{".":{"types":"./dist/index.d.mts","import":"./dist/index.mjs"},"./contract":{"types":"./dist/contract.d.mts","import":"./dist/contract.mjs"}},"scripts":{"pack":"pnpm pack --out artifacts/package.tgz","test":"vitest run","build":"tsdown","typecheck":"tsc --noEmit --project tsconfig.json","check:package":"publint"},"_npmUser":{"name":"dvcol","email":"dinh.van.colomban@gmail.com"},"repository":{"url":"git+https://github.com/dvcol/chrome-debugger-bridge.git","type":"git","directory":"packages/broker"},"description":"Composed CDB broker, authenticated provider lifecycle, and agent tool sessions.","directories":{},"sideEffects":false,"_nodeVersion":"24.20.0","dependencies":{"@dvcol/cdb":"^0.1.0","@dvcol/cdb-mcp":"^0.1.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsdown":"0.22.14","vitest":"4.1.10"},"_npmOperationalInternal":{"tmp":"tmp/cdb-broker_0.0.0_1789227347550_0.4875925663313827","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@dvcol/cdb-broker","version":"0.2.0","keywords":["chrome","chrome-debugger","cdp","browser-automation","mcp","agent"],"author":"dvcol","license":"MIT","_id":"@dvcol/cdb-broker@0.2.0","maintainers":[{"name":"dvcol","email":"dinh.van.colomban@gmail.com"}],"homepage":"https://github.com/dvcol/chrome-debugger-bridge#readme","bugs":{"url":"https://github.com/dvcol/chrome-debugger-bridge/issues"},"dist":{"shasum":"948b86d334eb0f3131d9109b6e5d9789bc083e13","tarball":"https://registry.npmjs.org/@dvcol/cdb-broker/-/cdb-broker-0.2.0.tgz","fileCount":13,"integrity":"sha512-m30CNxfU3NJmN6wvAkruWlzSC90Q2Tt7MzY1Hd/qaDss1xcj729zXt78lTe49+vY9tJsuR4HOpy1UkPfdTtq2g==","signatures":[{"sig":"MEUCIQDXBfHYQndNVjvwTP/2DfASaPVKc5vp6rPJvcSlXVXefQIgAidlfkOZO6iM9HjYymLNHDlgPUC/UX2zGu9v1eEiNUo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@dvcol%2fcdb-broker@0.2.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":175311},"type":"module","engines":{"node":">=24.0.0"},"exports":{".":{"types":"./dist/index.d.mts","import":"./dist/index.mjs"},"./contract":{"types":"./dist/contract.d.mts","import":"./dist/contract.mjs"}},"scripts":{"pack":"pnpm pack --out artifacts/package.tgz","test":"vitest run","build":"tsdown","typecheck":"tsc --noEmit --project tsconfig.json","check:package":"publint"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:ee4f0346-e6ea-4b2c-89e5-84a95597e0b6"}},"repository":{"url":"git+https://github.com/dvcol/chrome-debugger-bridge.git","type":"git","directory":"packages/broker"},"description":"Composed CDB broker, authenticated provider lifecycle, and agent tool sessions.","directories":{},"sideEffects":false,"_nodeVersion":"24.20.0","dependencies":{"@dvcol/cdb":"^0.2.0","@dvcol/cdb-mcp":"^0.2.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsdown":"0.22.14","vitest":"4.1.10"},"_npmOperationalInternal":{"tmp":"tmp/cdb-broker_0.2.0_1789314265717_0.10216012499967064","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@dvcol/cdb-broker","type":"module","version":"0.3.0","description":"Composed CDB broker, authenticated provider lifecycle, and agent tool sessions.","author":"dvcol","license":"MIT","homepage":"https://github.com/dvcol/chrome-debugger-bridge#readme","repository":{"type":"git","url":"git+https://github.com/dvcol/chrome-debugger-bridge.git","directory":"packages/broker"},"bugs":{"url":"https://github.com/dvcol/chrome-debugger-bridge/issues"},"keywords":["chrome","chrome-debugger","cdp","browser-automation","mcp","agent"],"sideEffects":false,"exports":{".":{"types":"./dist/index.d.mts","import":"./dist/index.mjs"},"./contract":{"types":"./dist/contract.d.mts","import":"./dist/contract.mjs"}},"engines":{"node":">=24.0.0"},"dependencies":{"@dvcol/cdb":"^0.3.0","@dvcol/cdb-mcp":"^0.3.0"},"devDependencies":{"tsdown":"0.22.14","vitest":"4.1.10"},"publishConfig":{"access":"public"},"scripts":{"build":"tsdown","check:package":"publint","pack":"pnpm pack --out artifacts/package.tgz","test":"vitest run","typecheck":"tsc --noEmit --project tsconfig.json"},"_nodeVersion":"24.20.0","_id":"@dvcol/cdb-broker@0.3.0","dist":{"integrity":"sha512-KNGMJGyxuaxhzpy/9x/NMsiIcmrRxEkawgVQd/xJ42kxgo4ojm+Wkeqqwr3epdqXvh8QuWOzD84ageWBLSRAYw==","shasum":"b3372d519cbfc46b74432ce7c9e34cc49621397d","tarball":"https://registry.npmjs.org/@dvcol/cdb-broker/-/cdb-broker-0.3.0.tgz","fileCount":13,"unpackedSize":182448,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@dvcol%2fcdb-broker@0.3.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDDKo56pVxJZ1eWK+vHoiJVqvEG1FhKMa8Qf8NTwDzgbQIgO14c8Ywcjo5ae58NmPX8cXDkicjzdPOHHZ6UzFaOdYg="}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:ee4f0346-e6ea-4b2c-89e5-84a95597e0b6"}},"directories":{},"maintainers":[{"name":"dvcol","email":"dinh.van.colomban@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/cdb-broker_0.3.0_1789637070849_0.17995144888606762"},"_hasShrinkwrap":false}},"time":{"created":"2026-09-12T15:35:47.353Z","modified":"2026-09-17T09:24:31.295Z","0.0.0":"2026-09-12T15:35:47.695Z","0.2.0":"2026-09-13T15:44:25.864Z","0.3.0":"2026-09-17T09:24:30.950Z"},"bugs":{"url":"https://github.com/dvcol/chrome-debugger-bridge/issues"},"author":"dvcol","license":"MIT","homepage":"https://github.com/dvcol/chrome-debugger-bridge#readme","keywords":["chrome","chrome-debugger","cdp","browser-automation","mcp","agent"],"repository":{"type":"git","url":"git+https://github.com/dvcol/chrome-debugger-bridge.git","directory":"packages/broker"},"description":"Composed CDB broker, authenticated provider lifecycle, and agent tool sessions.","maintainers":[{"name":"dvcol","email":"dinh.van.colomban@gmail.com"}],"readme":"# @dvcol/cdb-broker\n\nBrowser-control orchestration for an embedding host. Requires Node 24. The host owns its processes, authenticated client identities, tool catalogue and MCP server.\n\n```ts\nimport { createBroker, createFileBrokerIdentityStore, defineBroker } from '@dvcol/cdb-broker';\n\nconst definition = defineBroker({\n  identityStore: await createFileBrokerIdentityStore('/host/chosen/identity-directory'),\n  navigation: { default: 'same-origin', allowed: ['same-origin', 'follow-tab'] },\n});\nconst broker = await createBroker(definition);\n\n// Register these contributions in the host's existing catalogue.\nconst tools = broker.tools;\nconst result = await broker.invoke(authenticatedPeer, toolName, arguments_, { signal });\n\nawait broker.disconnectPeer(authenticatedPeer.id);\nawait broker.dispose();\n```\n\n`defineBroker` validates configuration without opening connections or starting processes. `createBroker` composes CDB authority stores, logical sessions, grant coordination, pairing and per-principal semantic tool sessions. `snapshot()` and `subscribe()` derive management state from those stores. The management interface must be restricted to the host's trusted operators and providers; it is not an agent tool.\n\nUse `@dvcol/cdb-devframe` to carry providers on an existing Devframe connection. Other transports can use the runtime's registration, authentication, provider connection and claim methods directly.\n\nKeep an existing identity directory when adopting this package. The file store reads the version-1 `identity.json` format and preserves broker IDs and pairing credentials. The host also preserves each extension's installation ID and pairing-store key. Resume credentials belong to the host, never to model-visible arguments.\n\nNavigation requests must match a configured preset; disallowed requests fail without downgrading. Each grant binds its selected preset to the requesting principal and exact target. `same-origin` retains the approved origin; `follow-tab` permits subsequent HTTP(S) origins. An optional `navigation.authorize` callback adds host restrictions. Navigation renews target generations and invalidates document-bound element references.\n\nNative automation is the default. To select the experimental Playwright provider, supply a lazy `automationProvider` factory that imports `@dvcol/cdb-automation-playwright` explicitly. It is not a dependency of this package.\n\nSee the [public Devframe example](../../examples/devframe/README.md) and [architecture](../../ARCHITECTURE.md).\n","readmeFilename":""}