@tickernelz/paperclip-pro-adapter-utils 2026.1001.2 → 2026.1002.1

package/node_modules/@agentclientprotocol/sdk/dist/schema/zod.gen.js

@@ -636,8 +636,7 @@ export const zCreateElicitationRequest = preserveCustomPayload(z.intersection(z.
  * Unique identifier for an MCP server using the ACP transport.
  *
  * The value is opaque and generated by the ACP component providing the MCP server. It is
- * used by `mcp/connect` to route connection requests back to the component that declared the
- * server.
+ * used by `mcp/message` to route requests to the component that declared the server.
  *
  * @experimental
  */
@@ -647,24 +646,14 @@ export const zMcpServerAcpId = z.string();
  *
  * This capability is not part of the spec yet, and may be removed or changed at any point.
  *
- * Request parameters for `mcp/connect`.
+ * Identifies an inner MCP request active against a server on this ACP connection.
  *
- * @experimental
- */
-export const zConnectMcpRequest = z.object({
-    serverId: zMcpServerAcpId,
-    _meta: defaultOnError(z.record(z.string(), z.unknown()).nullish(), () => undefined),
-});
-/**
- * **UNSTABLE**
- *
- * This capability is not part of the spec yet, and may be removed or changed at any point.
- *
- * A unique identifier for an active MCP-over-ACP connection.
+ * Generated by the caller and preserved unchanged by proxies. This is distinct
+ * from the outer ACP JSON-RPC request ID.
  *
  * @experimental
  */
-export const zMcpConnectionId = z.string();
+export const zMcpRequestId = z.string();
 /**
  * **UNSTABLE**
  *
@@ -675,24 +664,12 @@ export const zMcpConnectionId = z.string();
  * @experimental
  */
 export const zMessageMcpRequest = z.object({
-    connectionId: zMcpConnectionId,
+    serverId: zMcpServerAcpId,
+    requestId: zMcpRequestId,
     method: z.string(),
     params: z.record(z.string(), z.unknown()).nullish(),
     _meta: defaultOnError(z.record(z.string(), z.unknown()).nullish(), () => undefined),
 });
-/**
- * **UNSTABLE**
- *
- * This capability is not part of the spec yet, and may be removed or changed at any point.
- *
- * Request parameters for `mcp/disconnect`.
- *
- * @experimental
- */
-export const zDisconnectMcpRequest = z.object({
-    connectionId: zMcpConnectionId,
-    _meta: defaultOnError(z.record(z.string(), z.unknown()).nullish(), () => undefined),
-});
 /**
  * Allows for sending an arbitrary request that is not part of the ACP spec.
  * Extension methods provide a way to add custom functionality while maintaining
@@ -718,9 +695,7 @@ export const zAgentRequest = z.object({
         zWaitForTerminalExitRequest,
         zKillTerminalRequest,
         zCreateElicitationRequest,
-        zConnectMcpRequest,
         zMessageMcpRequest,
-        zDisconnectMcpRequest,
         zExtRequest,
     ])
         .nullish(),
@@ -1606,18 +1581,6 @@ export const zCloseNesResponse = z.object({
  * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
  */
 export const zExtResponse = z.unknown();
-/**
- * **UNSTABLE**
- *
- * This capability is not part of the spec yet, and may be removed or changed at any point.
- *
- * Response to `mcp/message`.
- *
- * This is the inner MCP response result payload. Any JSON value is valid.
- *
- * @experimental
- */
-export const zMessageMcpResponse = z.unknown();
 /**
  * Predefined error codes for common JSON-RPC and ACP-specific errors.
  *
@@ -1682,7 +1645,6 @@ export const zAgentResponse = z.union([
             zSuggestNesResponse,
             zCloseNesResponse,
             zExtResponse,
-            zMessageMcpResponse,
         ]),
     }),
     z.object({
@@ -2047,6 +2009,177 @@ export const zCompactionSummaryChunk = z.object({
     content: zContentBlock,
     _meta: defaultOnError(z.record(z.string(), z.unknown()).nullish(), () => undefined),
 });
+/**
+ * **UNSTABLE**
+ *
+ * This capability is not part of the spec yet, and may be removed or changed at any point.
+ *
+ * Capability to cancel work in a subagent session without ending that session.
+ *
+ * Supplying `{}` advertises support; an omitted or `null` `cancel` does not.
+ *
+ * @experimental
+ */
+export const zSessionCancelCapabilities = z.object({
+    _meta: defaultOnError(z.record(z.string(), z.unknown()).nullish(), () => undefined),
+});
+/**
+ * **UNSTABLE**
+ *
+ * This capability is not part of the spec yet, and may be removed or changed at any point.
+ *
+ * Client-initiated session mutations permitted for a specific subagent session.
+ *
+ * A mutation requires an explicit per-child capability; support for the method
+ * on ordinary sessions does not grant support on a child.
+ *
+ * @experimental
+ */
+export const zSubagentSessionCapabilities = z.object({
+    cancel: defaultOnError(zSessionCancelCapabilities.nullish(), () => undefined),
+    _meta: defaultOnError(z.record(z.string(), z.unknown()).nullish(), () => undefined),
+});
+/**
+ * Foreground work is in progress.
+ */
+export const zRunningStateUpdate = z.object({
+    _meta: defaultOnError(z.record(z.string(), z.unknown()).nullish(), () => undefined),
+});
+/**
+ * The child is ready to process another prompt.
+ */
+export const zIdleStateUpdate = z.object({
+    stopReason: defaultOnError(zStopReason.nullish(), () => undefined),
+    usage: defaultOnError(zUsage.nullish(), () => undefined),
+    _meta: defaultOnError(z.record(z.string(), z.unknown()).nullish(), () => undefined),
+});
+/**
+ * Foreground work is blocked on user action.
+ */
+export const zRequiresActionStateUpdate = z.object({
+    _meta: defaultOnError(z.record(z.string(), z.unknown()).nullish(), () => undefined),
+});
+/**
+ * **UNSTABLE**
+ *
+ * This capability is not part of the spec yet, and may be removed or changed at any point.
+ *
+ * The Agent cannot currently determine foreground activity.
+ *
+ * Report this when activity becomes unobservable, not merely because the child
+ * has been quiet. The Client MUST stop presenting the previous state as confirmed
+ * current activity, but may retain it as last known. A later state replaces this
+ * snapshot normally.
+ *
+ * This is not a task outcome or session closure. It does not cancel work, resolve
+ * pending requests, or revoke capabilities; capabilities are updated separately.
+ *
+ * @experimental
+ */
+export const zUnknownStateUpdate = z.object({
+    _meta: defaultOnError(z.record(z.string(), z.unknown()).nullish(), () => undefined),
+});
+/**
+ * **UNSTABLE**
+ *
+ * This capability is not part of the spec yet, and may be removed or changed at any point.
+ *
+ * Current foreground-work state of a reusable child session.
+ *
+ * Each update is a whole-object snapshot. Idle does not terminate the child;
+ * the parent can message it again, transitioning it back to running.
+ * Background activity may still emit other session updates while idle.
+ *
+ * @experimental
+ *
+ * Custom variants (unknown `state` values) keep their extra
+ * properties exactly as received; unlike known variants, those keys
+ * bypass lenient-field salvage and arrive unvalidated.
+ */
+export const zStateUpdate = preserveCustomPayload(z.union([
+    zRunningStateUpdate.and(z.object({
+        state: z.literal("running"),
+    })),
+    zIdleStateUpdate.and(z.object({
+        state: z.literal("idle"),
+    })),
+    zRequiresActionStateUpdate.and(z.object({
+        state: z.literal("requires_action"),
+    })),
+    zUnknownStateUpdate.and(z.object({
+        state: z.literal("unknown"),
+    })),
+    excludeKnownTags(z.object({
+        state: z.string(),
+    }), "state", ["idle", "requires_action", "running", "unknown"]),
+]), "state", ["idle", "requires_action", "running", "unknown"]);
+/**
+ * **UNSTABLE**
+ *
+ * This capability is not part of the spec yet, and may be removed or changed at any point.
+ *
+ * Notification that the enclosing parent session created and owns a child session.
+ *
+ * Later updates modify the existing association's metadata, not its ownership.
+ *
+ * Sent on the immediate parent session. The first update for an unknown
+ * [`SubagentUpdate::session_id`] announces the child and MUST be sent
+ * before any live child traffic or live message naming the child as sender
+ * or recipient. Parents may message and reuse an announced child across
+ * multiple operations.
+ * Child events are delivered automatically on the same connection; no child
+ * load, resume, or subscription is needed.
+ *
+ * Only the subagent session ID is required. Omitted patch fields keep their
+ * previous values; `null` clears them. Clearing capabilities disables child
+ * mutations. Clearing state leaves current activity unset/unconfirmed: it does
+ * not imply idle, stop work, or create an `unknown` state snapshot. A concrete
+ * state replaces the entire previous state object, not the session.
+ * The title and description provide the parent's display metadata for the
+ * child. They do not replace the content of individual messages or operations.
+ *
+ * @experimental
+ */
+export const zSubagentUpdate = z.object({
+    sessionId: zSessionId,
+    title: defaultOnError(z.string().nullish(), () => undefined),
+    description: defaultOnError(z.string().nullish(), () => undefined),
+    capabilities: defaultOnError(zSubagentSessionCapabilities.nullish(), () => undefined),
+    state: defaultOnError(zStateUpdate.nullish(), () => undefined),
+    _meta: defaultOnError(z.record(z.string(), z.unknown()).nullish(), () => undefined),
+});
+/**
+ * **UNSTABLE**
+ *
+ * This capability is not part of the spec yet, and may be removed or changed at any point.
+ *
+ * An upsert for an inter-session message.
+ *
+ * @experimental
+ */
+export const zSessionMessage = z.object({
+    messageId: zMessageId,
+    senderSessionId: defaultOnError(zSessionId.nullish(), () => undefined),
+    recipientSessionId: defaultOnError(zSessionId.nullish(), () => undefined),
+    content: defaultOnError(vecSkipError(zContentBlock).nullish(), () => undefined),
+    _meta: defaultOnError(z.record(z.string(), z.unknown()).nullish(), () => undefined),
+});
+/**
+ * **UNSTABLE**
+ *
+ * This capability is not part of the spec yet, and may be removed or changed at any point.
+ *
+ * A streamed content block of an inter-session message.
+ *
+ * @experimental
+ */
+export const zSessionMessageChunk = z.object({
+    messageId: zMessageId,
+    senderSessionId: defaultOnError(zSessionId.nullish(), () => undefined),
+    recipientSessionId: defaultOnError(zSessionId.nullish(), () => undefined),
+    content: zContentBlock,
+    _meta: defaultOnError(z.record(z.string(), z.unknown()).nullish(), () => undefined),
+});
 /**
  * Different types of updates that can be sent during session processing.
  *
@@ -2103,6 +2236,15 @@ export const zSessionUpdate = z.union([
     zCompactionSummaryChunk.and(z.object({
         sessionUpdate: z.literal("compaction_summary_chunk"),
     })),
+    zSubagentUpdate.and(z.object({
+        sessionUpdate: z.literal("subagent_update"),
+    })),
+    zSessionMessage.and(z.object({
+        sessionUpdate: z.literal("session_message"),
+    })),
+    zSessionMessageChunk.and(z.object({
+        sessionUpdate: z.literal("session_message_chunk"),
+    })),
 ]);
 /**
  * Notification containing a session update from the agent.
@@ -2123,24 +2265,6 @@ export const zCompleteElicitationNotification = z.object({
     elicitationId: zElicitationId,
     _meta: defaultOnError(z.record(z.string(), z.unknown()).nullish(), () => undefined),
 });
-/**
- * **UNSTABLE**
- *
- * This capability is not part of the spec yet, and may be removed or changed at any point.
- *
- * Notification parameters for `mcp/message`.
- *
- * This is used when the wrapped MCP message is a notification and the outer JSON-RPC
- * envelope has no `id`.
- *
- * @experimental
- */
-export const zMessageMcpNotification = z.object({
-    connectionId: zMcpConnectionId,
-    method: z.string(),
-    params: defaultOnError(z.record(z.string(), z.unknown()).nullish(), () => undefined),
-    _meta: defaultOnError(z.record(z.string(), z.unknown()).nullish(), () => undefined),
-});
 /**
  * Allows the Agent to send an arbitrary notification that is not part of the ACP spec.
  * Extension notifications provide a way to send one-way messages for custom functionality
@@ -2158,7 +2282,6 @@ export const zAgentNotification = z.object({
         .union([
         zSessionNotification,
         zCompleteElicitationNotification,
-        zMessageMcpNotification,
         zExtNotification,
     ])
         .nullish(),
@@ -2217,6 +2340,23 @@ export const zClientSessionCapabilities = z.object({
     notices: defaultOnError(zNoticeCapabilities.nullish(), () => undefined),
     _meta: defaultOnError(z.record(z.string(), z.unknown()).nullish(), () => undefined),
 });
+/**
+ * **UNSTABLE**
+ *
+ * This capability is not part of the spec yet, and may be removed or changed at any point.
+ *
+ * Capability marker for exposing reusable child sessions as restricted ACP sessions.
+ *
+ * Supplying `{}` advertises support for child association and state updates,
+ * session-directed messages, and restricted-session semantics. The client
+ * must advertise this capability before the agent sends subagent updates or
+ * session-directed messages.
+ *
+ * @experimental
+ */
+export const zSubagentCapabilities = z.object({
+    _meta: defaultOnError(z.record(z.string(), z.unknown()).nullish(), () => undefined),
+});
 /**
  * **UNSTABLE**
  *
@@ -2305,6 +2445,7 @@ export const zClientCapabilities = z.object({
         .default({ readTextFile: false, writeTextFile: false }), () => ({ readTextFile: false, writeTextFile: false })),
     terminal: defaultOnError(z.boolean().optional().default(false), () => false),
     session: defaultOnError(zClientSessionCapabilities.nullish(), () => undefined),
+    subagents: defaultOnError(zSubagentCapabilities.nullish(), () => undefined),
     plan: defaultOnError(zPlanCapabilities.nullish(), () => undefined),
     auth: defaultOnError(zAuthCapabilities.optional().default({ terminal: false }), () => ({ terminal: false })),
     elicitation: defaultOnError(zElicitationCapabilities.nullish(), () => undefined),
@@ -2427,7 +2568,7 @@ export const zMcpServerSse = z.object({
  * ACP transport configuration for MCP.
  *
  * The MCP server is provided by an ACP component and communicates over the ACP channel
- * using `mcp/connect`, `mcp/message`, and `mcp/disconnect`.
+ * using `mcp/message`.
  *
  * @experimental
  */
@@ -2768,7 +2909,6 @@ export const zClientRequest = z.object({
         zStartNesRequest,
         zSuggestNesRequest,
         zCloseNesRequest,
-        zMessageMcpRequest,
         zExtRequest,
     ])
         .nullish(),
@@ -2909,28 +3049,49 @@ export const zCreateElicitationResponse = preserveCustomPayload(z.intersection(z
 /**
  * **UNSTABLE**
  *
- * This capability is not part of the spec yet, and may be removed or changed at any point.
+ * An inner MCP error, distinct from an outer ACP binding or runtime error.
  *
- * Response to `mcp/connect`.
+ * `code` and `message` are required and non-null. `data` is optional;
+ * explicit `null` is preserved separately from an omitted key.
  *
  * @experimental
  */
-export const zConnectMcpResponse = z.object({
-    connectionId: zMcpConnectionId,
-    _meta: defaultOnError(z.record(z.string(), z.unknown()).nullish(), () => undefined),
+export const zMcpError = z.looseObject({
+    code: z
+        .int()
+        .min(-2147483648, {
+        error: "Invalid value: Expected int32 to be >= -2147483648",
+    })
+        .max(2147483647, {
+        error: "Invalid value: Expected int32 to be <= 2147483647",
+    }),
+    message: z.string(),
+    data: z.unknown().optional(),
 });
 /**
  * **UNSTABLE**
  *
- * This capability is not part of the spec yet, and may be removed or changed at any point.
+ * The successful outer ACP `mcp/message` response carries exactly one
+ * inner MCP outcome: an opaque result (including JSON null), or an MCP error.
+ * Outer ACP errors are reserved for binding and runtime failures.
  *
- * Response to `mcp/disconnect`.
+ * Both branches require their carrier key. An error must be a non-null object.
+ * Unknown outer fields are ignored; inner result and error fields are preserved.
+ * Carrier `_meta` is optional; null or invalid values are treated as absent.
+ * Senders must include exactly one outcome; receivers prefer `result` if both are present.
  *
  * @experimental
  */
-export const zDisconnectMcpResponse = z.object({
-    _meta: defaultOnError(z.record(z.string(), z.unknown()).nullish(), () => undefined),
-});
+export const zMessageMcpResponse = z.union([
+    z.object({
+        result: z.unknown(),
+        _meta: defaultOnError(z.record(z.string(), z.unknown()).nullish(), () => undefined),
+    }),
+    z.object({
+        error: zMcpError,
+        _meta: defaultOnError(z.record(z.string(), z.unknown()).nullish(), () => undefined),
+    }),
+]);
 /**
  * A JSON-RPC response object.
  */
@@ -2947,8 +3108,6 @@ export const zClientResponse = z.union([
             zWaitForTerminalExitResponse,
             zKillTerminalResponse,
             zCreateElicitationResponse,
-            zConnectMcpResponse,
-            zDisconnectMcpResponse,
             zMessageMcpResponse,
             zExtResponse,
         ]),
@@ -3052,6 +3211,25 @@ export const zRejectNesNotification = z.object({
     reason: defaultOnError(zNesRejectReason.nullish(), () => undefined),
     _meta: defaultOnError(z.record(z.string(), z.unknown()).nullish(), () => undefined),
 });
+/**
+ * **UNSTABLE**
+ *
+ * This capability is not part of the spec yet, and may be removed or changed at any point.
+ *
+ * Notification parameters for `mcp/message`.
+ *
+ * Sent by the provider to the consumer for an active request (including
+ * subscription acknowledgements and updates); the outer envelope has no `id`.
+ *
+ * @experimental
+ */
+export const zMessageMcpNotification = z.object({
+    serverId: zMcpServerAcpId,
+    requestId: zMcpRequestId,
+    method: z.string(),
+    params: z.record(z.string(), z.unknown()).nullish(),
+    _meta: defaultOnError(z.record(z.string(), z.unknown()).nullish(), () => undefined),
+});
 /**
  * A JSON-RPC notification object.
  */