@ampcode/plugin 0.0.0-20260425002358-g58772b5 → 0.0.0-20260425184610-g2a0cd88

package/index.d.ts

@@ -289,7 +289,7 @@ declare module '@ampcode/plugin' {
 	export interface ThreadToolResultBlock {
 		type: 'tool_result'
 		toolUseID: string
-		output?: string
+		output?: PluginToolResult
 		status: 'done' | 'error' | 'cancelled' | 'running' | 'pending'
 	}
 
@@ -491,6 +491,29 @@ declare module '@ampcode/plugin' {
 		output?: unknown
 	}
 
+	/**
+	 * A structured content block returned from a plugin tool.
+	 */
+	export type PluginToolResultContentBlock =
+		| { type: 'text'; text: string }
+		| {
+				type: 'image'
+
+				/** MIME type, e.g. 'image/png', 'image/jpeg', or 'image/webp'. */
+				mimeType: string
+
+				/** Base64-encoded payload with no data: prefix. */
+				data: string
+		  }
+
+	/**
+	 * Result returned from a plugin tool.
+	 *
+	 * Returning a bare string keeps the existing text-only behavior. Returning an array
+	 * of content blocks lets a tool mix text and inline base64 image blocks.
+	 */
+	export type PluginToolResult = string | PluginToolResultContentBlock[]
+
 	/**
 	 * Event payload for tool.result event.
 	 */
@@ -506,17 +529,17 @@ declare module '@ampcode/plugin' {
 	export type ToolResultResult =
 		| {
 				status: 'done'
-				output?: unknown
+				output?: PluginToolResult
 		  }
 		| {
 				status: 'error'
 				error?: string
-				output?: unknown
+				output?: PluginToolResult
 		  }
 		| {
 				status: 'cancelled'
 				error?: string
-				output?: unknown
+				output?: PluginToolResult
 		  }
 		| undefined
 		| void
@@ -736,6 +759,9 @@ declare module '@ampcode/plugin' {
 		}
 
 		/** Execute the tool with the given input and return a result */
-		execute: (input: Record<string, unknown>, ctx: PluginToolContext) => Promise<unknown>
+		execute: (
+			input: Record<string, unknown>,
+			ctx: PluginToolContext,
+		) => Promise<PluginToolResult | void>
 	}
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@ampcode/plugin",
-	"version": "0.0.0-20260425002358-g58772b5",
+	"version": "0.0.0-20260425184610-g2a0cd88",
 	"description": "Amp Plugin API",
 	"homepage": "https://ampcode.com/manual/plugin-api",
 	"author": {