@ampcode/plugin 0.0.0-20260818001058-gcb0a91a → 0.0.0-20260818221056-gdf9ae7e

package/index.d.ts

@@ -354,6 +354,12 @@ declare module '@ampcode/plugin' {
 		tools?: AgentToolSelection
 		/** Optional reasoning effort override for models that support it. */
 		reasoningEffort?: AgentReasoningEffort
+		/**
+		 * Estimated input-token count at which Amp automatically compacts the thread.
+		 * Must be a positive safe integer. When omitted, Amp uses the configured
+		 * percentage threshold, which defaults to 90%.
+		 */
+		compactionThresholdTokens?: number
 		/**
 		 * Features required on threads created from this agent. Omit this field to inherit
 		 * the creating thread's features when the caller also omits
@@ -491,7 +497,10 @@ declare module '@ampcode/plugin' {
 		 * agent has no display.
 		 */
 		label?: string
-		/** Optional longer description shown in command palettes and pickers. */
+		/**
+		 * Optional longer description shown in command palettes and pickers. State both what the
+		 * mode does and when to use it.
+		 */
 		description?: string
 		/**
 		 * Optional label color as a hex RGB string, for example "#d97706".
@@ -1067,6 +1076,20 @@ declare module '@ampcode/plugin' {
 		 */
 		cancel(): Promise<void>
 
+		/**
+		 * Make this thread private or visible to every member of its workspace.
+		 * Making a thread private closes multiplayer. The authenticated user must
+		 * own the thread.
+		 */
+		setVisibility(visibility: 'private' | 'workspace'): Promise<void>
+
+		/**
+		 * Open multiplayer for the given number of seconds, or close it with `null`.
+		 * Opening multiplayer requires an Orb thread that is already shared. Valid
+		 * durations range from 5 minutes to 7 days.
+		 */
+		setMultiplayer(options: { ttlSeconds: number | null }): Promise<void>
+
 		/**
 		 * Read messages from the thread in a stable plugin-facing schema.
 		 *
@@ -1710,7 +1733,10 @@ declare module '@ampcode/plugin' {
 	export interface AgentConfig {
 		/** Label shown in mode pickers and thread headers, 24 characters or less. Defaults to the agent's directory name. */
 		label?: string
-		/** Description shown in agent listings, 500 characters or less. */
+		/**
+		 * Description shown in agent listings, 500 characters or less. State both what the agent
+		 * does and when to use it.
+		 */
 		description?: string
 		/** Label color as a hex RGB string, for example "#d97706". */
 		color?: string
@@ -1739,7 +1765,7 @@ declare module '@ampcode/plugin' {
 	 * import { defineAgent } from '@ampcode/plugin'
 	 *
 	 * export default defineAgent({
-	 *   description: 'Researches requests and cites primary sources',
+	 *   description: 'Researches requests and cites primary sources. Use for evidence-backed research.',
 	 *   model: 'openai/gpt-5-mini',
 	 *   tools: ['web_search', 'read_web_page'],
 	 *   reasoningEffort: 'medium',

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@ampcode/plugin",
-	"version": "0.0.0-20260818001058-gcb0a91a",
+	"version": "0.0.0-20260818221056-gdf9ae7e",
 	"description": "Amp Plugin API",
 	"homepage": "https://ampcode.com/manual/plugin-api",
 	"author": {