@ampcode/plugin 0.0.0-20260720025147-ge982146 → 0.0.0-20260722002806-g52a0c4a

package/index.d.ts

@@ -360,6 +360,11 @@ declare module '@ampcode/plugin' {
 		parentThreadID?: ThreadID
 		/** Show the created thread and make it active in the client when supported. */
 		show?: boolean
+		/**
+		 * 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.
+		 */
+		multiplayerTTLSeconds?: number
 		/**
 		 * 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
@@ -1446,10 +1451,16 @@ declare module '@ampcode/plugin' {
 		/** Stable server-owned event ID. Use this to make handler effects idempotent. */
 		id: string
 
-		/** JSON-compatible request payload accepted by the generic webhook endpoint. */
+		/** Exact bytes received in the HTTP request body. */
+		body: Uint8Array
+
+		/** Requested HTTP headers, with lowercase names. */
+		headers: Readonly<Record<string, string>>
+
+		/** @deprecated Use `body` instead. Internal JSON-compatible transport payload. */
 		payload: unknown
 
-		/** Bounded string metadata recorded by the webhook ingress. */
+		/** @deprecated Transport metadata retained for compatibility. */
 		metadata: Readonly<Record<string, string>>
 
 		/** ISO 8601 timestamp recorded when the server accepted the webhook. */
@@ -1470,13 +1481,24 @@ declare module '@ampcode/plugin' {
 		/** Stable, non-whitespace-padded key within this plugin and thread (1-128 characters). */
 		key: string
 
+		/**
+		 * HTTP headers to preserve. Names are case-insensitive, and delivered names are lowercase.
+		 * Defaults to an empty list; no request headers are preserved implicitly.
+		 */
+		headers?: readonly string[]
+
 		/** At-least-once handler for matching durable webhook events. */
 		handler: (event: WebhookEvent, ctx: WebhookHandlerContext) => void | Promise<void>
 	}
 
 	/** Safe registration information returned to the plugin. */
 	export interface WebhookRegistration {
-		/** Capability URL for webhook POST requests. Treat this URL as a credential. */
+		/**
+		 * Capability URL for webhook POST requests. Treat this URL as a credential. Each webhook
+		 * accepts a burst of 10 new events and refills at 10 events per minute. A rate-limited
+		 * request returns HTTP 429 with a `Retry-After` header; a retry matching an event still
+		 * pending delivery by `Idempotency-Key` does not consume rate capacity.
+		 */
 		url: string
 	}
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@ampcode/plugin",
-	"version": "0.0.0-20260720025147-ge982146",
+	"version": "0.0.0-20260722002806-g52a0c4a",
 	"description": "Amp Plugin API",
 	"homepage": "https://ampcode.com/manual/plugin-api",
 	"author": {