@ampcode/plugin 0.0.0-20260623023715-g6a0df08 → 0.0.0-20260625023905-g22f8e42

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.
Files changed (2) hide show
  1. package/index.d.ts +18 -2
  2. package/package.json +1 -1
package/index.d.ts CHANGED
@@ -126,7 +126,15 @@ declare module '@ampcode/plugin' {
126
126
  */
127
127
  getBuiltinAgent(mode: BuiltinAgentMode, options?: GetBuiltinAgentOptions): Agent
128
128
 
129
- /** Register a custom agent mode that clients may show alongside built-in modes. */
129
+ /**
130
+ * Register a custom agent mode that clients may show alongside built-in modes.
131
+ *
132
+ * External plugins must include a matching `// @amp-agent-mode ...` metadata
133
+ * comment with the mode `key` and `label` for each registered mode. Clients
134
+ * use this static metadata to avoid silent drift between runtime registration
135
+ * and discovery, and warn when they are out of sync.
136
+ * Multiple mode comments in one plugin file are supported.
137
+ */
130
138
  registerAgentMode(definition: PluginAgentModeDefinition): Subscription
131
139
 
132
140
  /**
@@ -177,7 +185,15 @@ declare module '@ampcode/plugin' {
177
185
  */
178
186
  getBuiltinAgent(mode: BuiltinAgentMode, options?: GetBuiltinAgentOptions): Agent
179
187
 
180
- /** Register a custom agent mode that clients may show alongside built-in modes. */
188
+ /**
189
+ * Register a custom agent mode that clients may show alongside built-in modes.
190
+ *
191
+ * External plugins must include a matching `// @amp-agent-mode ...` metadata
192
+ * comment with the mode `key` and `label` for each registered mode. Clients
193
+ * use this static metadata to avoid silent drift between runtime registration
194
+ * and discovery, and warn when they are out of sync.
195
+ * Multiple mode comments in one plugin file are supported.
196
+ */
181
197
  registerAgentMode(definition: PluginAgentModeDefinition): Subscription
182
198
 
183
199
  /**
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ampcode/plugin",
3
- "version": "0.0.0-20260623023715-g6a0df08",
3
+ "version": "0.0.0-20260625023905-g22f8e42",
4
4
  "description": "Amp Plugin API",
5
5
  "homepage": "https://ampcode.com/manual/plugin-api",
6
6
  "author": {