Skip to content

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

Draft
AndrewKirkovski wants to merge 6 commits into
mainfrom
codex/ee2-2563-release62
Draft

AndrewKirkovski wants to merge 6 commits into
mainfrom
codex/ee2-2563-release62

Conversation

@AndrewKirkovski

Copy link
Copy Markdown
Contributor

What was changed

Document the Attention API, agent tools, browser action targets, delivery and lifecycle rules, and debugging. Add the V1 quickstart in English and seven locales. Update shared chat policy guidance for Host 1.0.62 across bootstrap, proxy, managed layout, casing, and chat web component guides. The policy remains compatible with existing host overrides and child package overrides. Documentation checks run in CI.

Verification

All three documentation checks pass, including 6,696 Markdown links across 1,459 pages. The release 62 config update changes 48 guides; this PR also includes the existing Attention documentation commits, for 74 files in total.

Release status

Host 1.0.62 and all 14 public npm packages at 0.0.62 are released. The facade integration remains in draft at wippyai/framework#168. Published Session 0.6.6 lacks the Attention capability/context endpoints; the local Session receiver implementation passes the local matrix, but the published backend smoke is blocked. Keep the coordinated release documentation in draft until the backend prerequisite and downstream release gates are complete.

…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.

This branch has not been deployed

No deployments
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.

1 participant