@ampcode/plugin 0.0.0-20261008001818-g5d841b4 → 0.0.0-20261010002032-ge25e839

package/index.d.ts

@@ -1489,13 +1489,23 @@ declare module '@ampcode/plugin' {
 		 * Require a human response rather than an agent response. The thread owner can answer these
 		 * dialogs. While multiplayer is active, human contributors can also answer interactive
 		 * selections, confirmations, and non-secret inputs, including dialogs with `requireHuman: true`.
-		 * Secret inputs (`secret: true`) remain owner-only and always require a human. Dialogs targeted
+		 * Secret inputs (`secret: true`) and confirmations with a secret field remain owner-only and
+		 * always require a human. Dialogs targeted
 		 * to a specific connection are not shared with contributors.
 		 *
 		 * Use this for approval and permission prompts. It does not grant agents access to dialogs
 		 * or enable them to answer on the owner's behalf.
 		 */
 		requireHuman?: boolean
+
+		/**
+		 * Do not show the dialog when nobody who can answer it has the thread open, for example in
+		 * a scheduled or Slack-started thread nobody is watching. The dialog then resolves at once
+		 * as dismissed (`undefined`) instead of waiting and marking the thread as needing action.
+		 * Use this for prompts that are useful only while someone is watching. In the terminal
+		 * app the user is always present, so the dialog is always shown.
+		 */
+		skipIfUnwatched?: boolean
 	}
 
 	/**
@@ -1514,6 +1524,9 @@ declare module '@ampcode/plugin' {
 		/** Text for the submit button (default: "Submit") */
 		submitButtonText?: string
 
+		/** Placeholder shown in the empty input field */
+		placeholder?: string
+
 		/**
 		 * Treat the entered text as a secret such as an API key or password. Clients present the
 		 * text as sensitive (the TUI masks it; the web dialog lets the user hide it), and the value
@@ -1553,6 +1566,9 @@ declare module '@ampcode/plugin' {
 		 * 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`.
+		 *
+		 * 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".
 		 */
 		type?: 'text' | 'image' | 'link'
 
@@ -1570,6 +1586,16 @@ declare module '@ampcode/plugin' {
 
 		/** Allow a text field to be left empty. Text fields are required unless this is set. */
 		optional?: boolean
+
+		/** Placeholder shown in an empty text field */
+		placeholder?: string
+
+		/**
+		 * Treat a text field's value as a secret, as `secret` does for `ui.input`: clients let the
+		 * user hide it, only the thread owner can answer the dialog, and the answer is returned only
+		 * to the requester. A secret field is single-line.
+		 */
+		secret?: boolean
 	}
 
 	/** Options for a confirmation dialog that returns edited field values. */

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@ampcode/plugin",
-	"version": "0.0.0-20261008001818-g5d841b4",
+	"version": "0.0.0-20261010002032-ge25e839",
 	"description": "Amp Plugin API",
 	"homepage": "https://ampcode.com/docs/plugin-api",
 	"author": {