@womp/openai-plugin 0.9.1 → 0.10.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +4 -1
- package/dist/index.js +28 -28
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -93,7 +93,7 @@ changes an earlier one.
|
|
|
93
93
|
- **Tool metadata states facts.** Descriptions, input schemas and server instructions say what a tool does, never how the model should behave. Behaviour lives in `prompts/` and reaches the model in `load_scene_skill`'s result.
|
|
94
94
|
- **Every tool** declares `ui.visibility`, explicit annotation hints, and `securitySchemes: oauth2` with the `mcp:generate` scope. Tools only a card calls are `ui.visibility: ["app"]`.
|
|
95
95
|
- **Card data** is the tool result's `structuredContent`, typed by the card's `data.ts`. Tools map backend types to it; a card never receives backend types. What only the card may see is in the result's `_meta`, typed by the same `data.ts`: a link that is a credential, and a quote or an order, which the model would otherwise draw as a card of its own.
|
|
96
|
-
- **Cards** are MCP Apps resources (`text/html;profile=mcp-app`): one self-contained HTML file each, loading no script, style or font from outside,
|
|
96
|
+
- **Cards** are MCP Apps resources (`text/html;profile=mcp-app`): one self-contained HTML file each, loading no script, style or font from outside, at a fixed URI, `ui://womp/<card>.html`. A ChatGPT app added while card URIs were content hashes keeps the URI of its time, `ui://womp/<card>-<hash>.html`; every such URI reads as the current card. Only the design card frames a page: the live view, on `liveViewOrigin`.
|
|
97
97
|
|
|
98
98
|
### Tools
|
|
99
99
|
|
|
@@ -116,6 +116,9 @@ changes an earlier one.
|
|
|
116
116
|
`data.ts`, and a description in `text.ts` (`CARD_DESCRIPTIONS`). The build
|
|
117
117
|
picks it up as `CARDS.<name>`; the tool that shows it sets `ui.resourceUri:
|
|
118
118
|
CARDS.<name>.uri` and returns its `data.ts` shape as `structuredContent`.
|
|
119
|
+
ChatGPT caches a card for a few hours, so just after a release it can show the
|
|
120
|
+
previous card with the new data: a change to a card's data keeps the previous
|
|
121
|
+
card working.
|
|
119
122
|
|
|
120
123
|
**A tool group.** `src/tools/<group>.ts` exporting `register<Group>Tools(server,
|
|
121
124
|
backend, run)`, called from `registerTools` in `server.ts`. Its text goes in
|