Blekline
v0.3.0GitHub

Reference

Telemetry specification

Formal event metadata schema for fleet sensors (whitepaper §7.4.3 alignment).

View as Markdown

Metadata-only events — no prompt bodies in default ingest.

HTTP headers

HeaderValuesRequired
x-blekline-workspace-tokenblw_*Yes (API token path)
x-blekline-client-surfacecursor, claude-desktop, codex, continue, github-copilot, openhands, sourcegraph-cody, sdk, extension, unknownRecommended
x-blekline-model-provideranthropic, openai, google, xai, cursor, unknownOptional
x-blekline-model-idstring ≤80Optional
x-request-idUUIDAuto if omitted

POST /api/events body

{
  "kind": "tool_call_enforcement",
  "platform": "MCP-Proxy",
  "entitiesMasked": 2,
  "riskTier": "high",
  "action": "block",
  "clientSurface": "cursor",
  "modelProvider": "anthropic",
  "modelId": "claude-sonnet-4",
  "mcpToolName": "run_shell",
  "downstreamServer": "daytona"
}

downstreamServer identifies the L1 sandbox MCP behind the proxy. Set via BLEKLINE_DOWNSTREAM_SERVER:

ValueProvider
daytonaDaytona
modalModal
vercelVercel Sandbox
cloudflareCloudflare Containers / Sandbox SDK
e2bE2B
mockBLEKLINE_MCP_PROXY_MOCK=1
unknownDefault when unset

Stored under `sensorMetadata` on workspace events.

## Policy stream

`GET /api/workspace/policy-stream` (SSE):

```text
event: policy
data: {"revision":"abc123","mcpToolPolicy":{...},"redactionProfile":{...}}
blekline.ingress.action=mask|block|allow
blekline.client.surface=cursor
blekline.model.provider=openai
blekline.entities.masked=3
blekline.request.id=<uuid>

Export from sidecar or agent runtime; correlate with Blekline audit rows via requestId.


Next steps: AI Enablement Stack · Enterprise telemetry · Open workspace · Report issue