Skip to content

docs(arcjet): teach Capture and OTLP HTTP collector keys - #53

Draft
davidmytton wants to merge 1 commit into
mainfrom
david/cursor/teach-collector-keys-capture-otlp-522a
Draft

docs(arcjet): teach Capture and OTLP HTTP collector keys#53
davidmytton wants to merge 1 commit into
mainfrom
david/cursor/teach-collector-keys-capture-otlp-522a

Conversation

@davidmytton

Copy link
Copy Markdown
Contributor

Teaches the credential change from arcjet#8942 (merge 0b49efff694ba343696573620a2c444283ef2f45) so an agent following the skill does not treat every key as ajkey_.

What the skill now teaches

  • Two credential kinds: site SDK key (ajkey_) and project collector key (aj_prj_key_).
  • Capture and OTLP HTTP accept either. Site keys keep working for those ingest paths.
  • Collector keys are ingest-only. Guard and Decide in production return 404 on a collector key.
  • ARCJET_KEY for protect() / guard() stays a site key (sites get-key / get-site-key).
  • OTLP ingest is HTTP only. gRPC OTLP is unsupported.

Files

  • arcjet/SKILL.md — Step 2 key kinds, capture breadcrumb, gotcha, description trigger phrases.
  • arcjet/references/cli.md and mcp.md — bootstrap still writes a site key to ARCJET_KEY.
  • Guard Capture sections (JS / Python / Go) and request ARCJET_KEY notes.

Left unchanged: no new skill file, no arcjet-plugin vendoring, no unpublished adapter branches (Strands, Python OpenAI Agents), and no teaching of actor / inputs / policyInput / remote policies.

Open in Web Open in Cursor 

Capture and OTLP HTTP accept a site SDK key or a project collector
key. Collector keys are ingest-only; ARCJET_KEY for protect/guard
stays a site key.

Co-authored-by: David Mytton <davidmytton@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants