@ampcode/plugin 0.0.0-20260925001753-g49e7366 → 0.0.0-20260927002031-g6742dbd

package/index.d.ts

@@ -184,6 +184,11 @@ declare module '@ampcode/plugin' {
 		 * idempotency key because an executor can stop after the handler succeeds but
 		 * before durable consumption is recorded. Handlers have 30 seconds to complete;
 		 * `ctx.signal` is aborted when that deadline elapses, and the event is retried.
+		 * A request to an unarchived owner wakes or resumes its Orb. Archiving the owning
+		 * thread makes the URL unavailable and pauses queued delivery until the thread is
+		 * restored. Handler failures retry after 5 seconds with exponential backoff capped
+		 * at 5 minutes. Amp drops an event after 1 hour of handler failures, and later events
+		 * can run while an earlier event is waiting to retry.
 		 *
 		 * @example
 		 * ```ts
@@ -2038,6 +2043,12 @@ declare module '@ampcode/plugin' {
 		model?: PluginAIModel
 		/** Run entirely on Amp's thread actor without creating or attaching an executor. */
 		serverOnly?: boolean
+		/**
+		 * Marks a work-in-progress agent. Drafts are hidden from agent pickers but still start
+		 * threads by key, so the author can try them. The agent builder sets this while an agent
+		 * is being shaped and clears it when the author is done.
+		 */
+		draft?: boolean
 		/**
 		 * Built-in tools available to this agent: 'all' for all tools available in its runtime,
 		 * a list of tool names with `*` suffix wildcards, or an object that adjusts the default
@@ -2071,6 +2082,13 @@ declare module '@ampcode/plugin' {
 		subagents?: AgentSubagentPin
 		/** Features required on threads created from this agent. */
 		features?: readonly AgentFeature[]
+		/**
+		 * IDs (slugs) of the remote MCP servers this agent works with, as shown in Settings →
+		 * MCP Servers. They are named in the agent's rendered instructions so the model knows to
+		 * reach them through code mode (`tool_search`/`code_exec`). They do not restrict which
+		 * servers the thread can reach.
+		 */
+		mcpServers?: readonly string[]
 	}
 
 	/**

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@ampcode/plugin",
-	"version": "0.0.0-20260925001753-g49e7366",
+	"version": "0.0.0-20260927002031-g6742dbd",
 	"description": "Amp Plugin API",
 	"homepage": "https://ampcode.com/docs/plugin-api",
 	"author": {