@ampcode/plugin 0.0.0-20260531003713-g5edca02 → 0.0.0-20260602004132-g778c3a1

package/index.d.ts

@@ -155,6 +155,9 @@ declare module '@ampcode/plugin' {
 		activeThread: Observable<{ id: ThreadID } | null> & {
 			readonly current: { id: ThreadID } | null
 		}
+
+		/** Thread lookup APIs. */
+		threads: PluginThreads
 	}
 
 	export type AgentReasoningEffort = 'none' | 'minimal' | 'low' | 'medium' | 'high'
@@ -543,6 +546,20 @@ declare module '@ampcode/plugin' {
 		 * Append a user message to the thread.
 		 */
 		append(messages: UserMessage[]): Promise<void>
+
+		/**
+		 * Append a single user message to the thread.
+		 *
+		 * When `steer` is true and the thread is busy, the message is queued as a
+		 * steering message and is preferred when the thread next dequeues work.
+		 */
+		appendUserMessage(message: UserMessage, options?: AppendUserMessageOptions): Promise<void>
+	}
+
+	/** APIs for accessing threads by ID. */
+	export interface PluginThreads {
+		/** Get a thread handle for the given thread ID. */
+		get(threadID: ThreadID): PluginThread
 	}
 
 	/**
@@ -554,6 +571,14 @@ declare module '@ampcode/plugin' {
 		content: string
 	}
 
+	/** Options for appending a single user message to a thread. */
+	export interface AppendUserMessageOptions {
+		/**
+		 * Prefer this message when it is queued behind in-progress work.
+		 */
+		steer?: boolean
+	}
+
 	/**
 	 * Options for the input dialog.
 	 */

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@ampcode/plugin",
-	"version": "0.0.0-20260531003713-g5edca02",
+	"version": "0.0.0-20260602004132-g778c3a1",
 	"description": "Amp Plugin API",
 	"homepage": "https://ampcode.com/manual/plugin-api",
 	"author": {