@ampcode/plugin 0.0.0-20260930001919-g9299b2d → 0.0.0-20261001002205-g9c84ae8

package/index.d.ts

@@ -407,6 +407,11 @@ declare module '@ampcode/plugin' {
 		 * even though plugin tools are registered under their bare names). Include such an entry
 		 * in explicit lists so the user's plugin and MCP tools stay available.
 		 *
+		 * MCP tools are not sent to the model as individual tools. Every agent gets `tool_search`
+		 * and `code_exec` (unless `exclude` names them) and reaches all MCP servers through them as
+		 * deferred code-mode modules, so a large MCP catalog does not fill the context window.
+		 * Exclude both to send the MCP tools the list selects directly instead.
+		 *
 		 * Run `amp plugins show-agent-options --json` for built-in tool names intended for
 		 * plugin agents.
 		 */
@@ -1344,17 +1349,20 @@ declare module '@ampcode/plugin' {
 	export interface PluginConfirmField {
 		/**
 		 * How to show the field. Text fields are editable. Image fields show a read-only preview
-		 * of an HTTP(S) image URL and are omitted from the returned values. Defaults to `text`.
+		 * of an HTTP(S) image URL. Link fields show a button that opens an HTTP(S) URL in the
+		 * browser, for example an approval page in another app; the dialog stays open so the user
+		 * can still confirm or cancel afterwards. Image and link fields are omitted from the
+		 * returned values. Defaults to `text`.
 		 */
-		type?: 'text' | 'image'
+		type?: 'text' | 'image' | 'link'
 
 		/** Stable key used in the returned record */
 		name: string
 
-		/** Label shown above the field */
+		/** Label shown above a text or image field, or the button text of a link field */
 		label: string
 
-		/** Initial text value or, for an image field, an HTTP(S) image URL */
+		/** Initial text value or, for an image or link field, an HTTP(S) URL */
 		value: string
 
 		/** Allow a text field to span multiple lines */
@@ -1405,9 +1413,10 @@ declare module '@ampcode/plugin' {
 		input(options: PluginInputOptions): Promise<string | undefined>
 
 		/**
-		 * Show editable text fields and read-only image previews in a confirmation dialog.
-		 * @returns The edited text values by field name, or undefined if cancelled. Image fields
-		 * are omitted.
+		 * Show editable text fields, read-only image previews, and link buttons in a confirmation
+		 * dialog.
+		 * @returns The edited text values by field name, or undefined if cancelled. Image and link
+		 * fields are omitted.
 		 */
 		confirm(options: PluginEditableConfirmOptions): Promise<Record<string, string> | undefined>
 		/**
@@ -2055,7 +2064,8 @@ declare module '@ampcode/plugin' {
 		 * list (`add` unions extra tools into it; `exclude` removes tools). Use `add` with
 		 * `extends` to add tools on top of the built-in mode's tool list. `mcp__*` matches all
 		 * MCP tools and `plugin__*` matches all plugin tools (also matched as
-		 * `plugin__<pluginName>__<toolName>`).
+		 * `plugin__<pluginName>__<toolName>`). MCP servers are reached through `tool_search` and
+		 * `code_exec`, which every agent gets unless `exclude` names them.
 		 */
 		tools?:
 			| 'all'

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@ampcode/plugin",
-	"version": "0.0.0-20260930001919-g9299b2d",
+	"version": "0.0.0-20261001002205-g9c84ae8",
 	"description": "Amp Plugin API",
 	"homepage": "https://ampcode.com/docs/plugin-api",
 	"author": {