@ampcode/plugin 0.0.0-20260819001142-g296cfc0 → 0.0.0-20260821001110-g72798b8

package/index.d.ts

@@ -413,6 +413,19 @@ declare module '@ampcode/plugin' {
 		 * When omitted, the thread is created without a parent.
 		 */
 		parentThreadID?: ThreadID
+		/**
+		 * Set the new thread's visibility. A child thread inherits its parent's visibility when
+		 * omitted, so set this explicitly to opt out. Workspace visibility requires the new thread
+		 * to belong to a workspace.
+		 */
+		visibility?: 'private' | 'workspace'
+		/**
+		 * Enable multiplayer for this many seconds, or set `null` to create the thread closed. A
+		 * child thread inherits its parent's remaining multiplayer window when omitted, so set this
+		 * explicitly to opt out. This option requires an Orb executor. Multiplayer threads must
+		 * belong to a workspace. Valid numeric values range from 5 minutes to 7 days.
+		 */
+		multiplayerTTLSeconds?: number | null
 		/**
 		 * Where the thread should execute. Defaults to `local`, which uses the current
 		 * client as the executor. Use `orb` for Amp's cloud sandbox or a runner target
@@ -438,10 +451,18 @@ declare module '@ampcode/plugin' {
 		 */
 		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.
+		 * Set the new thread's visibility. A child thread inherits its parent's visibility when
+		 * omitted, so set this explicitly to opt out. Workspace visibility requires the new thread
+		 * to belong to a workspace.
 		 */
-		multiplayerTTLSeconds?: number
+		visibility?: 'private' | 'workspace'
+		/**
+		 * Enable multiplayer for this many seconds, or set `null` to create the thread closed. A
+		 * child thread inherits its parent's remaining multiplayer window when omitted, so set this
+		 * explicitly to opt out. This option requires an Orb executor. Multiplayer threads must
+		 * belong to a workspace. Valid numeric values range from 5 minutes to 7 days.
+		 */
+		multiplayerTTLSeconds?: number | null
 		/**
 		 * Where the thread should execute. Defaults to `local`, which uses the current
 		 * client as the executor. Use `orb` for Amp's cloud sandbox or a runner target
@@ -1054,6 +1075,15 @@ declare module '@ampcode/plugin' {
 		/** Agent currently used by this thread, suitable for creating related threads. */
 		agent(): Promise<Agent>
 
+		/**
+		 * ID of this thread's direct parent thread, or `null` when it has none.
+		 * The parent is recorded when a thread is created with a `parentThreadID`
+		 * (for example a subagent or child thread) and can become `null` later if
+		 * the parent thread is deleted. Only supported for the plugin's current
+		 * thread.
+		 */
+		parentThreadID(): Promise<ThreadID | null>
+
 		/** Current thread title stream, or `null` when no title has been set yet. */
 		readonly title: Observable<string | null> & { get(): Promise<string | null> }
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@ampcode/plugin",
-	"version": "0.0.0-20260819001142-g296cfc0",
+	"version": "0.0.0-20260821001110-g72798b8",
 	"description": "Amp Plugin API",
 	"homepage": "https://ampcode.com/manual/plugin-api",
 	"author": {