Feature request: Support user-invocable-only canvases
- Langage dominant
- Aucune donnée de langage
- Étoiles
- 2.1k
- Forks
- 153
- Métriques de merge des PR
- Aucune PR mergée en 30 j
Description
### Summary
Add a canvas visibility/invocation setting that allows extension authors to expose a canvas to users without making it discoverable or invocable by the agent.
### Problem
User-scoped canvases are registered with every applicable session. Their declarations become available to the agent, which:
- Allows the agent to open the canvas without an explicit user request.
- Adds canvas metadata to the model's input context.
- Prevents authors from building strictly user-initiated utilities.
- Creates unnecessary token overhead for canvases that are rarely used.
Omitting `actions` prevents action invocation but does not prevent agent discovery or opening.
### Proposed API
```js
createCanvas({
id: "example",
displayName: "Example",
description: "An explicitly opened utility.",
invocation: {
user: true,
agent: false,
},
open: async (context) => {
// ...
},
});
```
A simpler alternative:
```js
agentInvocable: false
```
### Expected behavior
When `agentInvocable` is `false`:
- The canvas remains visible in user-facing canvas discovery and commands.
- Users can open it explicitly.
- Its declaration and action schemas are excluded from model context.
- `open_canvas` and `invoke_canvas_action` cannot target it.
- Canvas-internal, app-only tools continue to work.
- The default remains agent-invocable for backward compatibility.
### Acceptance criteria
- Extension authors can independently configure user and agent invocation.
- User-only canvases consume no model-context tokens before explicit use.
- Agent attempts to invoke user-only canvases fail with a clear authorization error.
- Invocation restrictions are enforced by the host, not only through instructions.
- The setting works for user-, project-, and session-scoped extensions.
- Existing canvas extensions retain their current behavior.
### Motivation
This would enable dashboards, editors, configuration panels, and other interactive utilities that should be available on demand without permanently expanding every agent session's tool surface.
Guide de contribution
Ouvrir le guide de contribution
Piste de recherche
L’issue mentionne createCanvas, open_canvas et invoke_canvas_action, mais aucun fichier ni test. Commencez par localiser ces points d’entrée et suivre la manière dont les déclarations de canvas atteignent le contexte du modèle et dont les invocations de l’hôte sont autorisées. Le travail est terminé lorsque les canvas réservés à l’utilisateur restent découvrables par celui-ci, sont exclus du contexte du modèle, rejettent clairement les appels des agents et préservent les valeurs par défaut existantes.
Rédigé par le modèle d'indexation à partir du texte de l'issue.
Évaluation
- Stack technique
- javascript
- Domaine
- api
- Type d'issue
- Fonctionnalité
- Difficulté
- 5/5
- Temps estimé
- Plus d'une semaine
- Activité
- Calme
- Clarté
- Plutôt claire
- Accessibilité débutants
- 35/100