@safebrowse/daemon
v0.1.5
Published
Localhost SafeBrowse daemon for browser-use agent enforcement
Maintainers
Readme
@safebrowse/daemon
Localhost SafeBrowse daemon with bundled runtime assets for policy, verified registry, and KB loading.
Install
npm install @safebrowse/daemonRun
npx @safebrowse/daemon \
--host 127.0.0.1 \
--port 8787 \
--deployment-profile secure_v6 \
--approval-broker-public-key-path ./knowledge_base/signing/safebrowse_vf_ed25519_public.pemWhen secure_v6 is selected, the daemon forces:
- approval broker mode
external_service - parser isolation mode
node_permission_process
Model Guard
The daemon supports a model-guard sidecar protocol for compatible private runtimes. The SDK does not publish model weights or runtime bundles.
npx @safebrowse/daemon \
--model-guard-url http://127.0.0.1:8788 \
--model-guard-enforcement-mode shadowSupported modes:
off: default; no scoring, even when a URL is configuredshadow: recordscompiledObservation.modelAssessmentfor deterministicALLOWobservations without changing verdicts or authoritiestighten: only applies stricter outcomes such as approval, read-only replan, or block
GET /health reports model-guard readiness, bundle/schema metadata, and digest metadata when the sidecar provides it. secure_v6 claim readiness does not require model availability.
Routes
GET /healthPOST /v6/session/startPOST /v6/observePOST /v6/action/evaluatePOST /v6/approval/issuePOST /v6/tool/preparePOST /v6/tool/callback/verifyPOST /v6/artifact/ingestPOST /v6/artifact/extractPOST /v6/memory/stagePOST /v6/memory/promotePOST /v6/memory/rollbackPOST /v6/replay/bundle
Secure Surface Notes
The daemon now accepts both pre-extracted structured captures and direct raw binary inputs for:
- MIME email via
rawMimeBase64 - DOCX, XLSX, and PPTX via
contentBase64
Those raw inputs are materialized into secure typed captures before normal policy and authority evaluation.
Environment Variables
SAFEBROWSE_HOSTSAFEBROWSE_PORTSAFEBROWSE_ROOT_DIRSAFEBROWSE_DEPLOYMENT_PROFILESAFEBROWSE_APPROVAL_BROKER_PUBLIC_KEY_PATHSAFEBROWSE_APPROVAL_BROKER_MODESAFEBROWSE_PARSER_ISOLATION_MODESAFEBROWSE_MODEL_GUARD_URLSAFEBROWSE_MODEL_GUARD_TIMEOUT_MSSAFEBROWSE_MODEL_GUARD_ENFORCEMENT_MODE(off,shadow, ortighten)
See the repository README for release and security guidance:
