Skip to content

Add openWorldHint #355

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

Draft
kenchris wants to merge 1 commit into
base: main
Choose a base branch
from
Draft

Add openWorldHint #355

Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
18 changes: 17 additions & 1 deletion index.bs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -264,6 +264,9 @@ An <dfn>annotations</dfn> is a [=struct=] with the following [=struct/items=]:
: <dfn>consequential hint</dfn>
:: a [=boolean=], initially false.

: <dfn>open world hint</dfn>
:: a [=boolean=], initially true.

: <dfn>debugging</dfn>
:: a [=boolean=], initially false.
</dl>
Expand Down Expand Up @@ -905,6 +908,9 @@ The <dfn method for=ModelContext>registerTool(<var>tool</var>, <var>options</var
: [=annotations/consequential hint=]
:: |tool|'s {{ModelContextTool/annotations}}'s {{ToolAnnotations/consequentialHint}}

: [=annotations/open world hint=]
:: |tool|'s {{ModelContextTool/annotations}}'s {{ToolAnnotations/openWorldHint}}

: [=annotations/debugging=]
:: |tool|'s {{ModelContextTool/annotations}}'s {{ToolAnnotations/debugging}}

Expand Down Expand Up @@ -1040,7 +1046,9 @@ The <dfn method for=ModelContext>getTools(<var>options</var>)</dfn> method steps
{{ToolAnnotations/untrustedContentHint}} is |tool definition|'s [=tool
definition/annotations=]'s [=annotations/untrusted content hint=],
{{ToolAnnotations/consequentialHint}} is |tool definition|'s [=tool
definition/annotations=]'s [=annotations/consequential hint=], and
definition/annotations=]'s [=annotations/consequential hint=],
{{ToolAnnotations/openWorldHint}} is |tool definition|'s [=tool
definition/annotations=]'s [=annotations/open world hint=], and
{{ToolAnnotations/debugging}} is |tool definition|'s [=tool
definition/annotations=]'s [=annotations/debugging=].

Expand Down Expand Up @@ -1240,6 +1248,7 @@ dictionary ToolAnnotations {
boolean readOnlyHint = false;
boolean untrustedContentHint = false;
boolean consequentialHint = false;
boolean openWorldHint = true;
boolean debugging = false;
};

Expand Down Expand Up @@ -1308,6 +1317,13 @@ The {{ToolAnnotations}} dictionary provides optional metadata about a tool:
: <code><var ignore>annotations</var>["{{ToolAnnotations/consequentialHint}}"]</code>
:: If true, indicates that executing the tool will result in consequential actions that are significant, real-world, or non-reversible, ex: booking a flight, transferring money.

: <code><var ignore>annotations</var>["{{ToolAnnotations/openWorldHint}}"]</code>
:: If true, indicates that the tool may send data to, or read data from, parties other than the
[=Document/origin=] of the page that registered it, for example through requests to other
origins. If false, indicates that the tool only uses the page and its own origin. Unlike the
other hints this one is true when it is not specified, so a tool that does not declare it is
treated as open to the world. The [=user agent=] does not enforce it.

: <code><var ignore>annotations</var>["{{ToolAnnotations/debugging}}"]</code>
:: If true, indicates that the tool is intended for debugging and developer tooling rather than end-user interactions.
</dl>
Expand Down