@ampcode/plugin 0.0.0-20260710003335-gaf98d42 → 0.0.0-20260712002807-g6f54f0d

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/index.d.ts +21 -0
  2. package/package.json +1 -1
package/index.d.ts CHANGED
@@ -309,6 +309,15 @@ declare module '@ampcode/plugin' {
309
309
  reasoningEffort?: AgentReasoningEffort
310
310
  }
311
311
 
312
+ export type AgentThreadExecutor =
313
+ | 'local'
314
+ | 'orb'
315
+ | {
316
+ type: 'runner'
317
+ /** Stable ID of a live Amp runner process. */
318
+ id: string
319
+ }
320
+
312
321
  export interface RunAgentOptions {
313
322
  /** Maximum time to wait for the agent run to finish, in milliseconds (default 10 minutes). */
314
323
  timeoutMs?: number
@@ -317,6 +326,12 @@ declare module '@ampcode/plugin' {
317
326
  * When omitted, the thread is created without a parent.
318
327
  */
319
328
  parentThreadID?: ThreadID
329
+ /**
330
+ * Where the thread should execute. Defaults to `local`, which uses the current
331
+ * client as the executor. Use `orb` for Amp's cloud sandbox or a runner target
332
+ * for a live Amp runner process such as `amp --no-tui`.
333
+ */
334
+ executor?: AgentThreadExecutor
320
335
  }
321
336
 
322
337
  export interface CreateAgentThreadOptions {
@@ -327,6 +342,12 @@ declare module '@ampcode/plugin' {
327
342
  parentThreadID?: ThreadID
328
343
  /** Show the created thread and make it active in the client when supported. */
329
344
  show?: boolean
345
+ /**
346
+ * Where the thread should execute. Defaults to `local`, which uses the current
347
+ * client as the executor. Use `orb` for Amp's cloud sandbox or a runner target
348
+ * for a live Amp runner process such as `amp --no-tui`.
349
+ */
350
+ executor?: AgentThreadExecutor
330
351
  }
331
352
 
332
353
  /** Thread handle returned by {@link Agent.createThread}. */
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ampcode/plugin",
3
- "version": "0.0.0-20260710003335-gaf98d42",
3
+ "version": "0.0.0-20260712002807-g6f54f0d",
4
4
  "description": "Amp Plugin API",
5
5
  "homepage": "https://ampcode.com/manual/plugin-api",
6
6
  "author": {