Skip to content

Commit fa5e0a6

Browse files
johnmatthewtennantPoppyclaude
committed
docs(attention): document canOpen, deferred opens and sealed watches
The tab contract now passes canOpen beside open, and open can return false while the host asks whether to discard unsaved edits, then open the link afterwards. Watches of an active Interest with a title or summary are now saved in the same envelope as a paused Interest's, so older readers skip them; say so in the parity notes. Signed-off-by: John Tennant <[email protected]> Co-authored-by: Poppy <ace4dfe51b23bb4244ab9117dfd5e13b8239445e333225608c352e68cb3fe2b5@buzz.block.builderlab.xyz> Co-Authored-By: Claude Opus 5.5 <[email protected]>
1 parent 7ff20b3 commit fa5e0a6

2 files changed

Lines changed: 8 additions & 4 deletions

File tree

‎docs/attention-janet-parity.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ Terms:
3737

3838
## Configuration compatibility
3939

40-
These extensions retain the `agent-attention/v1` schema name. Older readers reject fields and watch types they do not support, retain the objects for repair, and do not execute them. Janet does not support conversation delivery addresses or plugin source watches. Watches saved under a paused Interest carry a storage-only `interest_paused` envelope that also preserves timer progress, completed-source state, and wake history across older-reader rewrites. Older readers reject and retain those watches too; supported readers remove the marker only after validating the paused parent. Active Interests omit the pause field on disk so older readers retain their instructions. Conversion to Janet must reject unsupported objects rather than silently dropping a source or its destination. Converter enforcement of this requirement remains unverified.
40+
These extensions retain the `agent-attention/v1` schema name. Older readers reject fields and watch types they do not support, retain the objects for repair, and do not execute them. Janet does not support conversation delivery addresses or plugin source watches. Watches saved under an Interest an older reader cannot apply, because it is paused or has a `title` or `summary`, carry a storage-only `interest_paused` envelope that also preserves timer progress, completed-source state, and wake history across older-reader rewrites. Older readers reject and retain those watches too, so they never run them without their instructions; supported readers remove the marker only after validating the parent. Active Interests omit the pause field on disk so older readers retain their instructions. Conversion to Janet must reject unsupported objects rather than silently dropping a source or its destination. Converter enforcement of this requirement remains unverified.
4141

4242
## Known limit
4343

‎docs/plugin-architecture.md‎

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -580,11 +580,15 @@ which uploads of local files use. The kit grants nothing `ctx.agents` and
580580
A plugin, bundled or installed, can add a tab to the settings of agents
581581
running here or hosted, whatever their type, with
582582
`ctx.agents.registerTab({ id, title, component, when, subscribe })`. The component receives
583-
`{ agent, open }`; it reads and saves through the plugin's own `ctx.agents`.
583+
`{ agent, open, canOpen }`; it reads and saves through the plugin's own `ctx.agents`.
584584
`open(target)` opens a link, such as a `nostr:npub…` profile, where the tab is
585585
shown: the profile panel opens it beside the conversation and the Agents page
586-
selects that agent. It returns false when it can't, and is absent where the tab
587-
can open nothing. An
586+
selects that agent. `canOpen(target)` says whether `open` can open that link
587+
there, so the tab can show it as plain text when it can't. `open` returns true
588+
once it has opened the link, and false otherwise: either it can't, or the host
589+
first asks whether to discard unsaved edits and opens the link only if the
590+
person agrees. So false is not an error. Both are absent where the tab can open
591+
nothing. An
588592
optional `when(agent)` limits the tab to the agents it returns true for, and an
589593
optional `subscribe(listener)` tells the host when `when` may answer
590594
differently, so the tab appears or goes without a reload. A `when` that throws

0 commit comments

Comments
 (0)