Skip to content

Move the modelContext getter to Document #184

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
domfarolino merged 2 commits into from
May 27, 2026
+16 −46
Merged

Move the modelContext getter to Document #184

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
64ac660
Move modelContext to Document
domfarolino May 26, 2026
a33b7cb
Remove more
domfarolino May 27, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
62 changes: 16 additions & 46 deletions index.bs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -94,13 +94,6 @@ spec:html; type:dfn;
text:unique internal value
</pre>
<pre class="anchors">
spec: html; type: dfn; urlPrefix: https://html.spec.whatwg.org/C
text: create and initialize a Document object; url: initialise-the-document-object
# Because `text` and `url` are the same (modulo slashes), we should be able to
# exclude `url`. But the colon breaks the URL in `text`, forcing us to include
# `url`.
text:is initial about:blank; url: is-initial-about:blank
text: associated Navigator
spec: SECURE-CONTEXTS; urlPrefix: https://w3c.github.io/webappsec-secure-contexts/
type: abstract-op
text: is origin potentially trustworthy?; url: is-origin-trustworthy
Expand Down Expand Up @@ -204,8 +197,7 @@ To <dfn>notify documents of a tool change</dfn> given a {{Document}} |tool owner
1. If [=tool is visible to an origin=] given |tool owner|'s [=Document/origin=], |exposed
origins|, and |targetDocument|'s [=Document/origin=], then [=queue a global task=] on the
[=webmcp task source=] given |targetDocument|'s [=relevant global object=] to [=fire an
event=] named {{ModelContext/toolchange}} at |targetDocument|'s [=relevant global object=]'s
[=associated Navigator|associated <code>Navigator</code>=]'s [=Navigator/associated
event=] named {{ModelContext/toolchange}} at |targetDocument|'s [=Document/associated
ModelContext|associated <code>ModelContext</code>=].

<div class=example id=notify-task-ordering>
Expand All @@ -214,11 +206,11 @@ To <dfn>notify documents of a tool change</dfn> given a {{Document}} |tool owner
upon. For example:</p>

<xmp class=language-js>
navigator.modelContext.ontoolchange = e => console.log('Parent toolchange');
iframe.contentWindow.navigator.modelContext.ontoolchange = e => console.log('Child toolchange');
document.modelContext.ontoolchange = e => console.log('Parent toolchange');
iframe.contentDocument.modelContext.ontoolchange = e => console.log('Child toolchange');

// Queues a task to fire `toolchange`, on the `webmcp task source`.
navigator.modelContext.registerTool({
document.modelContext.registerTool({
name: "tool_name",
description: "tool_desc",
execute: async () => {}
Expand Down Expand Up @@ -278,47 +270,27 @@ https://github.com/webmachinelearning/webmcp/blob/main/docs/proposal.md#api
https://dlaliberte.github.io/bikeshed-intro/#a-strategy-for-incremental-development
-->

<h3 id="navigator-extension">Extensions to the {{Navigator}} Interface</h3>
<h3 id="document-extension">Extensions to {{Document}}</h3>

Each {{Navigator}} object has an <dfn for=Navigator>associated {{ModelContext}}</dfn>, which is a
Each {{Document}} object has an <dfn for=Document>associated {{ModelContext}}</dfn>, which is a
{{ModelContext}} object.

Upon creation of the {{Navigator}} object, its [=Navigator/associated ModelContext|associated
Upon creation of the {{Document}} object, its [=Document/associated ModelContext|associated
<code>ModelContext</code>=] must be set to a [=new=] {{ModelContext}} object created in the
{{Navigator}}'s [=relevant realm=]. It only ever changes from one `{{ModelContext}}` instance to
another the first time the {{Navigator/modelContext}} getter is accessed after a navigation away
from the [=is initial about:blank|initial <code>about:blank</code>=],

Note: The reason a {{Navigator}}'s [=Navigator/associated ModelContext|associated
<code>ModelContext</code>=] changes is as follows: {{ModelContext}} is a {{Document}}-scoped
registry of tools, but because it is accessed from an object that is shared between two {{Document}}
objects, it gets updated when the {{Navigator}}'s [=relevant global object=]'s
[=associated Document|associated <code>Document</code>=] gets updated, to ensure that tools registered within the [=is
initial about:blank|initial <code>about:blank</code>=] {{Document}} do not mix with tools in the
subsequent [=same origin=] {{Document}} See step 6.1 in [=create and initialize a Document
object|create and initialize a <code>Document</code> object=].

Each {{ModelContext}} object has a <dfn for=ModelContext>creation {{Document}}</dfn>, which is its
[=relevant global object=]s [=associated Document|associated <code>Document</code>=] at the time of creation.
{{Document}}'s [=relevant realm=].

<hr>

<xmp class="idl">
partial interface Navigator {
[SecureContext] readonly attribute ModelContext modelContext;
partial interface Document {
[SecureContext, SameObject] readonly attribute ModelContext modelContext;
};
</xmp>

<div algorithm>
The <dfn attribute for=Navigator>modelContext</dfn> getter steps are:
The <dfn attribute for=Document>modelContext</dfn> getter steps are:

1. If [=this=]'s [=Navigator/associated ModelContext|associated <code>ModelContext</code>=]'s
[=ModelContext/creation Document| creation <code>Document</code>=] does not equal [=this=]'s
[=relevant global object=]'s [=associated Document|associated <code>Document</code>=], then set
[=this=]'s [=Navigator/associated ModelContext|associated <code>ModelContext</code>=] to a
[=new=] {{ModelContext}} object.

1. Return [=this=]'s [=Navigator/associated ModelContext|associated <code>ModelContext</code>=]
1. Return [=this=]'s [=Document/associated ModelContext|associated <code>ModelContext</code>=]
object.

</div>
Expand All @@ -341,7 +313,7 @@ is a [=model context=] [=struct=] created alongside the {{ModelContext}}.


<dl class="domintro">
<dt><code><var ignore>navigator</var>.{{Navigator/modelContext}}.{{ModelContext/registerTool(tool, options)}}</code></dt>
<dt><code><var ignore>document</var>.{{Document/modelContext}}.{{ModelContext/registerTool(tool, options)}}</code></dt>
<dd>
<p>Registers a tool that [=agents=] can invoke. Throws an exception if a tool with the same name
is already registered, if the given {{ModelContextTool/name}} or
Expand Down Expand Up @@ -699,11 +671,9 @@ steps:

1. Let |id| be |document|'s [=Document/unique ID=].

1. Set |observation|'s [=observation/tool map=][|id|] = |document|'s [=relevant global
object=]'s [=associated Navigator|associated <code>Navigator</code>=]'s
[=Navigator/associated ModelContext|associated <code>ModelContext</code>=]'s
[=ModelContext/internal context=]'s [=model context/tool map=]'s [=map/values=], which are
[=tool definitions=].
1. Set |observation|'s [=observation/tool map=][|id|] = |document|'s [=Document/associated
ModelContext|associated <code>ModelContext</code>=]'s [=ModelContext/internal context=]'s
[=model context/tool map=]'s [=map/values=], which are [=tool definitions=].

1. Perform any [=implementation-defined=] steps to add anything to |observation| that the [=user
agent=] might deem useful or necessary, besides just populating the [=observation/tool map=].
Expand Down
Loading