@ampcode/plugin 0.0.0-20260802003111-g8467aa8 → 0.0.0-20260804003100-gf78500b

package/index.d.ts

@@ -288,6 +288,9 @@ declare module '@ampcode/plugin' {
 		| 'xhigh'
 		| 'max'
 
+	/** Features that plugin agents can enable on threads they create. */
+	export type AgentFeature = 'fast' | 'pro' | string
+
 	/**
 	 * Amp built-in agent modes available to plugins. The `smart`, `deep`, and
 	 * `rush` modes are deprecated: existing threads in those modes keep working,
@@ -331,6 +334,14 @@ declare module '@ampcode/plugin' {
 		tools?: AgentToolSelection
 		/** Optional reasoning effort override for models that support it. */
 		reasoningEffort?: AgentReasoningEffort
+		/**
+		 * Features required on threads created from this agent. Omit this field to inherit
+		 * the creating thread's features when the caller also omits
+		 * `Agent.createThread({ features })`. Set it to an empty array to use no inherited
+		 * features. A non-empty list becomes the required baseline. Callers can add features
+		 * to that baseline, but cannot remove them.
+		 */
+		features?: readonly AgentFeature[]
 		/**
 		 * Display shown for threads running this agent. Travels with the agent
 		 * definition, so threads created from it — including by other plugins via
@@ -393,10 +404,13 @@ declare module '@ampcode/plugin' {
 		/** Show the created thread and make it active in the client when supported. */
 		show?: boolean
 		/**
-		 * Features for the new thread. Omit to inherit the creating thread's features;
-		 * pass an empty array to clear them.
+		 * Additional features for the new thread. If a custom agent declares `features`,
+		 * that list is the required baseline, including an empty list meaning no inherited
+		 * features. Values supplied here are added to that baseline and cannot remove its
+		 * features. For a built-in agent or a custom agent that omits `features`, omit this
+		 * field to inherit the creating thread's features, or pass an empty array to clear them.
 		 */
-		features?: readonly string[]
+		features?: readonly AgentFeature[]
 		/**
 		 * Enable multiplayer for this many seconds. Multiplayer threads must run in an
 		 * Orb and belong to a workspace. Valid values range from 5 minutes to 7 days.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@ampcode/plugin",
-	"version": "0.0.0-20260802003111-g8467aa8",
+	"version": "0.0.0-20260804003100-gf78500b",
 	"description": "Amp Plugin API",
 	"homepage": "https://ampcode.com/manual/plugin-api",
 	"author": {