@ampcode/plugin 0.0.0-20260923001649-g009f5d9 → 0.0.0-20260924001720-g7fda6e0

package/index.d.ts

@@ -1276,11 +1276,14 @@ declare module '@ampcode/plugin' {
 	 */
 	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.
+		 * 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
+		 * 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
 	}
@@ -1983,7 +1986,13 @@ declare module '@ampcode/plugin' {
 			[key: string]: unknown
 		}
 
-		/** Execute the tool with the given input and return a result */
+		/**
+		 * Execute the tool with the given input and return a result.
+		 *
+		 * Returning nothing is allowed and is shown to the model as `(no tool output)`. Throw an
+		 * error to report a failure; the model then sees a tool error instead of a successful
+		 * empty result.
+		 */
 		execute: (
 			input: Record<string, unknown>,
 			ctx: PluginToolContext,

package/package.json

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