@ampcode/plugin 0.0.0-20260923001649-g009f5d9 → 0.0.0-20260925001753-g49e7366

package/index.d.ts

@@ -510,7 +510,7 @@ declare module '@ampcode/plugin' {
 		/**
 		 * Enable multiplayer for this many seconds, or set `null` to create it disabled. A
 		 * child thread inherits its parent's remaining multiplayer window when omitted, so set this
-		 * explicitly to opt out. This option requires an Orb executor. Multiplayer threads must
+		 * explicitly to opt out. This option requires an Orb or shared runner executor. Multiplayer threads must
 		 * belong to a workspace. Valid numeric values range from 5 minutes to 7 days.
 		 */
 		multiplayerTTLSeconds?: number | null
@@ -547,7 +547,7 @@ declare module '@ampcode/plugin' {
 		/**
 		 * Enable multiplayer for this many seconds, or set `null` to create it disabled. A
 		 * child thread inherits its parent's remaining multiplayer window when omitted, so set this
-		 * explicitly to opt out. This option requires an Orb executor. Multiplayer threads must
+		 * explicitly to opt out. This option requires an Orb or shared runner executor. Multiplayer threads must
 		 * belong to a workspace. Valid numeric values range from 5 minutes to 7 days.
 		 */
 		multiplayerTTLSeconds?: number | null
@@ -1215,7 +1215,7 @@ declare module '@ampcode/plugin' {
 
 		/**
 		 * Enable multiplayer for the given number of seconds, or disable it with `null`.
-		 * Enabling multiplayer requires an Orb thread that is already shared. Valid
+		 * Enabling multiplayer requires an Orb or shared runner thread that is already shared. Valid
 		 * durations range from 5 minutes to 7 days.
 		 */
 		setMultiplayer(options: { ttlSeconds: number | null }): Promise<void>
@@ -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-20260925001753-g49e7366",
 	"description": "Amp Plugin API",
 	"homepage": "https://ampcode.com/docs/plugin-api",
 	"author": {