Skip to content

docs: publish the Context Packet Protocol as a first-class spec page#359

Merged
vamgan merged 1 commit into
mainfrom
claude/context-packet-protocol
Jul 1, 2026
Merged

docs: publish the Context Packet Protocol as a first-class spec page#359
vamgan merged 1 commit into
mainfrom
claude/context-packet-protocol

Conversation

@vamgan

@vamgan vamgan commented Jul 1, 2026

Copy link
Copy Markdown
Collaborator

Summary

Part 1 of the vision work: elevate askable.context/0.1 from an implementation detail to an open protocol with askable-ui as the reference implementation. Specs travel further than SDKs — this page is the linkable, citable artifact for "an open format for telling LLMs what's on screen."

What's included

  • New site/docs/guide/protocol.md — "The Context Packet Protocol":
    • Status/version banner, design goals (structured-not-screenshots, capture-agnostic, privacy-in-the-envelope, boring-to-parse)
    • A complete annotated example packet
    • Normative field tables for the envelope, capture (mode/gesture enums), target, surrounding, privacy (redaction/consent semantics + the requireRedacted consumer contract), and provenance
    • Schema & validation section (webContextPacketSchema, createWebContextPacket, isWebContextPacket — noting the guard's enums are read from the schema so they cannot drift, per fix: Tier-1 verified bug sweep (create-app, svelte, react/vue, mcp, context) #347)
    • Versioning policy and producer/consumer guidance, including the MCP surface (askable://current, get_current_context, list_context_sources)
  • Sidebar entry (Concepts, after "Context Packets") + homepage start-list link.

Notes

  • Every field, enum, and semantic was verified against packages/context/src/index.ts. Docs-only; no code changes; complements (does not duplicate) the usage-oriented /guide/context.

Test plan

  • vitepress build clean (no dead links)
  • CI preview green

🤖 Generated with Claude Code


Generated by Claude Code

Frames askable.context/0.1 as an open, versioned wire format with askable-ui
as the reference implementation: design goals, full field/enum tables, privacy
and provenance semantics, schema + guard usage, versioning policy, and
producer/consumer guidance. Linked from the Concepts sidebar and homepage.
@vercel

vercel Bot commented Jul 1, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
askable Ready Ready Preview, Comment Jul 1, 2026 9:17pm

@vamgan vamgan merged commit 870dbb1 into main Jul 1, 2026
3 checks passed
@vamgan vamgan deleted the claude/context-packet-protocol branch July 1, 2026 21:23
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