Skip to content

docs: document Attention API and shared chat policy - #43

Merged
wolfy-j merged 7 commits into
mainfrom
codex/ee2-2563-release62
Oct 31, 2026
Merged

wolfy-j merged 7 commits into
mainfrom
codex/ee2-2563-release62

Conversation

@AndrewKirkovski

@AndrewKirkovski AndrewKirkovski commented Oct 8, 2026 •

Copy link
Copy Markdown
Contributor

Document the Attention inspection API, its agent trait and 14 tools, Session context controls, immutable action targets, approved capture drafts, delivery and privacy. Add a quickstart in eight locales and document shared chat policy.

The guidance targets published Host 1.0.67, proxy/shared 0.0.67, Facade 0.6.49, Session 0.6.17 and Agent 0.5.9. Current schema 2.2, import-map bootstrap ordering, Iconify and self-hosting guidance are preserved. The fixture checker validates structured JSON rather than freezing prose wording.

Validation:

  • All three maintained documentation checks pass: 6,863 local Markdown links across 1,469 pages.
  • Nine TypeScript examples compile against published proxy/shared 0.0.67.
  • Towers Chromium: 12/12 checks across compat/iframe and managed/Web Fragment for fresh reads, Session context control, privacy, highlighting, approved capture/upload/model delivery and persisted context.
  • Real runtime restart: seed and verification both pass, with unchanged persisted attachment/answer, restored Session setting and a successful follow-up after explicit opt-out.
  • All 50 maintained Attention helper tests pass. The restart verifier uses its existing strict decoder for compact v4 and explicitly controls the restored automatic-context setting; test-only correction is tracked separately in wippyai/app.

Browser proof uses current app source 31287ff, official Runtime v0.3.56a, and published modules only (also LLM 0.5.12, Relay 0.3.20, Views 0.5.13). No local Host assets or module replacements. This is focused Chromium qualification, not a full platform suite or Firefox/WebKit claim. Deployment-specific capture, privacy and authorization checks remain documented.

AndrewKirkovski and others added 7 commits October 6, 2026 21:57
…very

- Action tools take a `targets` array whose items are the `action_ref` or
  `target_ref` objects copied verbatim; list all nine read tools,
  `attention_context_set` and the four action tools with their arguments,
  including the visual capture options.
- State that `attention_inspect` was removed.
- Document every terminal action status, the envelope limits for
  wippy.attention v1 to v4 and wippy.attention.visual v1, and the
  GET /api/v1/sessions/capabilities descriptor.
- Describe plain-message delivery with the tab binding, read withdrawal,
  guard refusals, per-Session automatic context, upload listing, approved
  image delivery, composer exclusion, turn errors, and the PNG/WebP upload
  type requirement for visual capture.
- Replace the debugging note with checks for Host config, Session
  capabilities and the agent trait, and remove internal process text.
- check-attention-context-docs.mjs now requires the `targets` array
  wording, the removed `attention_inspect` wording, the complete tool list,
  every terminal status, per-version envelope limits and the capability
  descriptor fields, and rejects the old `target_ref` wording and internal
  process text.
- Add a Documentation checks workflow that runs the frontend, Attention and
  Markdown link checkers on pull requests and pushes to main.
- Document the Attention checker in the README.
The pages said the agent can turn automatic pointing context on or off
without asking the user. That is true of the tool, but the Attention trait
tells the model to use it only when the user asks. State both, so readers
do not assume the agent changes the setting on its own initiative.
@wolfy-j wolfy-j changed the title docs: document Attention API and shared chat policy for Host 1.0.62 docs: document Attention API and shared chat policy Oct 31, 2026
@wolfy-j
wolfy-j marked this pull request as ready for review October 31, 2026 13:35
@wolfy-j
wolfy-j merged commit 255a602 into main Oct 31, 2026
1 check passed
@wolfy-j
wolfy-j deleted the codex/ee2-2563-release62 branch October 31, 2026 13:35
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