@ampcode/plugin 0.0.0-20261021001728-gcc084cc → 0.0.0-20261023001716-ge290a2a

package/index.d.ts

@@ -1578,6 +1578,36 @@ declare module '@ampcode/plugin' {
 
 		/** Text for the confirm button (default: "Yes") */
 		confirmButtonText?: string
+
+		/**
+		 * Start the dialog collapsed to its title and message with a button of this text, such as
+		 * `'Set Up'`, that expands it to the fields and the confirm and cancel buttons. Use it for a
+		 * dialog the user may want to read before taking on, such as connecting a service with
+		 * several fields. Clients with no collapsed state show the whole dialog at once.
+		 */
+		expandButtonText?: string
+
+		/**
+		 * Markdown shown instead of `message` while the dialog is collapsed, such as a short pitch for
+		 * why the user should go ahead; `message` then holds the details shown with the fields. Only
+		 * used with `expandButtonText`.
+		 */
+		collapsedMessage?: string
+
+		/**
+		 * HTTP or HTTPS URL of a small square image, such as a service's logo, shown before the
+		 * title. Clients without images ignore it.
+		 */
+		iconURL?: string
+
+		/**
+		 * When the user declines this dialog while your tool's `execute` runs, end the agent's turn
+		 * once every tool call in the same batch has finished, instead of letting the agent
+		 * continue. Other calls and their dialogs are not cancelled. Ignored in hooks and commands.
+		 * Use this for approvals the agent must not work around, such as sending an email; do not
+		 * call `ctx.thread.cancel()` on decline, which stops every other call in the turn.
+		 */
+		endTurnOnDecline?: boolean
 	}
 
 	/** A field shown in a confirmation dialog. */
@@ -1589,10 +1619,25 @@ declare module '@ampcode/plugin' {
 		 * can still confirm or cancel afterwards. Image and link fields are omitted from the
 		 * returned values. Defaults to `text`.
 		 *
-		 * When a link field comes before a text field, clients show the fields as numbered steps:
-		 * for example "open the sign-in page", then "paste the URL it ends on".
+		 * File fields take a small text file, such as a key or certificate, and return its text
+		 * in place of a typed value. The web client shows a drop zone that also opens the file
+		 * picker, with an option to paste the text instead; the CLI takes a path on this computer
+		 * or the pasted text. Files larger than 64 KiB or not valid UTF-8 are refused. A file
+		 * field is editable like a text field: it is required unless `optional`, and `secret`
+		 * applies to it.
+		 *
+		 * When a link field comes before an editable field, clients show the fields as numbered
+		 * steps: for example "open the sign-in page", then "paste the URL it ends on". When the
+		 * only field is one link, the user must open it before they can confirm: the primary
+		 * button opens the link, then becomes the confirm button.
+		 */
+		type?: 'text' | 'image' | 'link' | 'file'
+
+		/**
+		 * File extensions a file field's picker offers, such as `['.p8']`. Advisory: the user can
+		 * still drop or paste any text.
 		 */
-		type?: 'text' | 'image' | 'link'
+		accept?: string[]
 
 		/** Stable key used in the returned record */
 		name: string
@@ -2182,6 +2227,14 @@ declare module '@ampcode/plugin' {
 
 		/** Current thread context for this tool invocation */
 		thread: PluginThread
+
+		/**
+		 * Aborted when the tool call is cancelled, for example when the user presses Stop. The
+		 * tool's result is discarded after that, but the plugin keeps running, so check it before
+		 * starting an effect that cannot be undone, such as sending a message, and pass it to
+		 * APIs that accept an `AbortSignal`.
+		 */
+		signal: AbortSignal
 	}
 
 	/** A provider-neutral webhook event delivered to a plugin handler. */

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@ampcode/plugin",
-	"version": "0.0.0-20261021001728-gcc084cc",
+	"version": "0.0.0-20261023001716-ge290a2a",
 	"description": "Amp Plugin API",
 	"license": "Amp Commercial License",
 	"homepage": "https://ampcode.com/docs/plugin-api",