@ampcode/plugin 0.0.0-20260922001754-ga9ffbd3 → 0.0.0-20260923001649-g009f5d9

package/index.d.ts

@@ -1270,10 +1270,25 @@ declare module '@ampcode/plugin' {
 		steer?: boolean
 	}
 
+	/**
+	 * Options shared by the dialogs that wait for an answer (`ui.input`, `ui.confirm`, and
+	 * `ui.select`).
+	 */
+	export interface PluginDialogOptions {
+		/**
+		 * Mark this dialog as one only the thread owner may answer in person. Without it, an agent
+		 * acting for the owner, such as a Puck thread that created and supervises this thread, may
+		 * be allowed to answer on the owner's behalf. Set this when the dialog is a deterministic
+		 * gate, such as a permission or approval prompt, so that only a human can pass it. Agents
+		 * can still see what the dialog asks. Secret inputs (`secret: true`) always require a human.
+		 */
+		requireHuman?: boolean
+	}
+
 	/**
 	 * Options for the input dialog.
 	 */
-	export interface PluginInputOptions {
+	export interface PluginInputOptions extends PluginDialogOptions {
 		/** Dialog title */
 		title?: string
 
@@ -1306,7 +1321,7 @@ declare module '@ampcode/plugin' {
 	/**
 	 * Options for the confirm dialog.
 	 */
-	export interface PluginConfirmOptions {
+	export interface PluginConfirmOptions extends PluginDialogOptions {
 		/** Dialog title */
 		title: string
 
@@ -1317,21 +1332,27 @@ declare module '@ampcode/plugin' {
 		confirmButtonText?: string
 	}
 
-	/** An editable text field in a confirmation dialog. */
+	/** A field shown in a confirmation dialog. */
 	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`.
+		 */
+		type?: 'text' | 'image'
+
 		/** Stable key used in the returned record */
 		name: string
 
 		/** Label shown above the field */
 		label: string
 
-		/** Initial field value */
+		/** Initial text value or, for an image field, an HTTP(S) image URL */
 		value: string
 
-		/** Allow the field to span multiple lines */
+		/** Allow a text field to span multiple lines */
 		multiline?: boolean
 
-		/** Allow the field to be left empty. Fields are required unless this is set. */
+		/** Allow a text field to be left empty. Text fields are required unless this is set. */
 		optional?: boolean
 	}
 
@@ -1343,7 +1364,7 @@ declare module '@ampcode/plugin' {
 	/**
 	 * Options for the select dialog.
 	 */
-	export interface PluginSelectOptions {
+	export interface PluginSelectOptions extends PluginDialogOptions {
 		/** Dialog title */
 		title: string
 
@@ -1376,8 +1397,9 @@ declare module '@ampcode/plugin' {
 		input(options: PluginInputOptions): Promise<string | undefined>
 
 		/**
-		 * Show required editable fields in a confirmation dialog.
-		 * @returns The edited values by field name, or undefined if cancelled.
+		 * 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.
 		 */
 		confirm(options: PluginEditableConfirmOptions): Promise<Record<string, string> | undefined>
 		/**

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@ampcode/plugin",
-	"version": "0.0.0-20260922001754-ga9ffbd3",
+	"version": "0.0.0-20260923001649-g009f5d9",
 	"description": "Amp Plugin API",
 	"homepage": "https://ampcode.com/docs/plugin-api",
 	"author": {