Developer docs

Build governed agent integrations inside the customer boundary.

These docs cover the developer platform surfaces that exist now: signed agent activity, JS/TS connector helpers, portal approvals, portable hook packs, private capability registry metadata, and portal provenance.

Validated path

AWS Cloud + Amazon Bedrock

Data boundary

Customer-owned BYOC install

Capture model

Ingested events, not an LLM proxy

Start here

Use the dry-run path before wiring a live portal. It validates payload shape, provenance, redaction, and approval evidence without requiring secrets.

bash

npm install
npm run platform:golden-path

npm -w packages/verifier run build
node packages/verifier/dist/cli.js platform registry
node packages/verifier/dist/cli.js platform golden-path

What this proves

The golden path emits a governed connector transcript with session.started, tool.started, approval.requested, hook.blocked, agent_run_audit.source_snapshot, and session.finished events. Live mode posts the same shape through portal ingest.

Docs map

The public docs are organized around builder jobs instead of internal package names.

Golden path

Run the governed capability proof in dry-run or live portal mode.

Open

JS/TS connectors

Emit signed agent activity from internal agents and custom tools.

Open

Event schema

Canonical agent_activity.v1 examples and compatibility rules.

Open

Approval bridge

Request and poll portal approval for sensitive custom actions.

Open

Hook packs

Install provider-native lifecycle telemetry and enforced PreToolUse hooks.

Open

Private registry

Customer-owned registry for connectors, capabilities, policies, analyzers, and exporters.

Open

Plugins and manifests

Trust levels, permission manifests, and reviewable governed plugins.

Open

Provenance

How connector and capability metadata lands in sessions, approvals, audit, and exports.

Open

Commands and env

CLI commands, environment variables, and validation gates.

Open

Implementation truth

The docs should sell what is real without hiding roadmap gaps.

Surface	Current status	Developer path
Signed event ingest	Implemented for legacy verifier telemetry and generic `agent_activity.v1` events through the portal ingest endpoint.	Read the event schema
JS/TS connector helper	Implemented in `@autodevops/verifier-portal-client` with dry-run validation, signed posting, idempotency, redaction, and provenance.	Build a connector
Portal approval bridge	Implemented for signed approval request/status polling. Governed actions fail closed when approval cannot be reached.	Wire approvals
Hook packs	Implemented for Claude Code, Cursor, and Codex lifecycle telemetry with opt-in enforced PreToolUse guards. Live walkthrough remains pending.	Install hook packs
Cloud deployment	AWS + Bedrock is the validated path. Azure and GCP adapters/providers exist as roadmap tracks, not validated customer paths.	See reference