@tickernelz/paperclip-pro-adapter-utils 2026.1001.1 → 2026.1002.0

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

@@ -711,8 +711,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
  */
@@ -720,54 +719,27 @@ export const zMcpServerAcpId = z.string();
 /**
  * **UNSTABLE**
  *
- * This capability is not part of the spec yet, and may be removed or changed at any point.
- *
- * Request parameters for `mcp/connect`.
- *
- * @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.
+ * Identifies an inner MCP request active against a server on this ACP connection.
+ * Generated by the caller and preserved unchanged by proxies, independently of
+ * the outer ACP JSON-RPC request ID.
  *
  * @experimental
  */
-export const zMcpConnectionId = z.string();
+export const zMcpRequestId = z.string();
 /**
  * **UNSTABLE**
  *
- * This capability is not part of the spec yet, and may be removed or changed at any point.
- *
- * Request parameters for `mcp/message`.
+ * Request parameters for `mcp/message`, sent from consumer to provider.
  *
  * @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
@@ -786,9 +758,7 @@ export const zAgentRequest = z.object({
         .union([
         zRequestPermissionRequest,
         zCreateElicitationRequest,
-        zConnectMcpRequest,
         zMessageMcpRequest,
-        zDisconnectMcpRequest,
         zExtRequest,
     ])
         .nullish(),
@@ -1415,6 +1385,37 @@ export const zSessionConfigOption = preserveCustomPayload(z.intersection(z.union
     category: defaultOnError(zSessionConfigOptionCategory.nullish(), () => undefined),
     _meta: defaultOnError(z.record(z.string(), z.unknown()).nullish(), () => undefined),
 })), "type", ["boolean", "select"]);
+/**
+ * All text that was typed after the command name is provided as input.
+ */
+export const zTextCommandInput = z.object({
+    hint: z.string(),
+    _meta: defaultOnError(z.record(z.string(), z.unknown()).nullish(), () => undefined),
+});
+/**
+ * The input specification for a command.
+ *
+ * Custom variants (unknown `type` values) keep their extra
+ * properties exactly as received; unlike known variants, those keys
+ * bypass lenient-field salvage and arrive unvalidated.
+ */
+export const zAvailableCommandInput = preserveCustomPayload(z.union([
+    zTextCommandInput.and(z.object({
+        type: z.literal("text"),
+    })),
+    excludeKnownTags(z.object({
+        type: z.string(),
+    }), "type", ["text"]),
+]), "type", ["text"]);
+/**
+ * Information about a command.
+ */
+export const zAvailableCommand = z.object({
+    name: z.string(),
+    description: z.string(),
+    input: defaultOnError(zAvailableCommandInput.nullish(), () => undefined),
+    _meta: defaultOnError(z.record(z.string(), z.unknown()).nullish(), () => undefined),
+});
 /**
  * Response from creating a new session.
  *
@@ -1423,6 +1424,7 @@ export const zSessionConfigOption = preserveCustomPayload(z.intersection(z.union
 export const zNewSessionResponse = z.object({
     sessionId: zSessionId,
     configOptions: defaultOnError(vecSkipError(zSessionConfigOption).optional(), () => []),
+    availableCommands: defaultOnError(vecSkipError(zAvailableCommand).optional(), () => []),
     _meta: defaultOnError(z.record(z.string(), z.unknown()).nullish(), () => undefined),
 });
 /**
@@ -1466,6 +1468,7 @@ export const zDeleteSessionResponse = z.object({
 export const zForkSessionResponse = z.object({
     sessionId: zSessionId,
     configOptions: defaultOnError(vecSkipError(zSessionConfigOption).optional(), () => []),
+    availableCommands: defaultOnError(vecSkipError(zAvailableCommand).optional(), () => []),
     _meta: defaultOnError(z.record(z.string(), z.unknown()).nullish(), () => undefined),
 });
 /**
@@ -1473,6 +1476,7 @@ export const zForkSessionResponse = z.object({
  */
 export const zResumeSessionResponse = z.object({
     configOptions: defaultOnError(vecSkipError(zSessionConfigOption).optional(), () => []),
+    availableCommands: defaultOnError(vecSkipError(zAvailableCommand).optional(), () => []),
     _meta: defaultOnError(z.record(z.string(), z.unknown()).nullish(), () => undefined),
 });
 /**
@@ -1638,18 +1642,6 @@ export const zCloseNesResponse = z.object({
  * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/draft/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.
  *
@@ -1712,7 +1704,6 @@ export const zAgentResponse = z.union([
             zSuggestNesResponse,
             zCloseNesResponse,
             zExtResponse,
-            zMessageMcpResponse,
         ]),
     }),
     z.object({
@@ -1839,6 +1830,26 @@ export const zIdleStateUpdate = z.object({
 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 session
+ * 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),
+});
 /**
  * The state of the agent's foreground work has changed.
  *
@@ -1859,10 +1870,13 @@ export const zStateUpdate = preserveCustomPayload(z.union([
     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"]),
-]), "state", ["idle", "requires_action", "running"]);
+    }), "state", ["idle", "requires_action", "running", "unknown"]),
+]), "state", ["idle", "requires_action", "running", "unknown"]);
 /**
  * A streamed item of tool-call content.
  *
@@ -2045,37 +2059,6 @@ export const zPlanRemoved = z.object({
     planId: zPlanId,
     _meta: defaultOnError(z.record(z.string(), z.unknown()).nullish(), () => undefined),
 });
-/**
- * All text that was typed after the command name is provided as input.
- */
-export const zTextCommandInput = z.object({
-    hint: z.string(),
-    _meta: defaultOnError(z.record(z.string(), z.unknown()).nullish(), () => undefined),
-});
-/**
- * The input specification for a command.
- *
- * Custom variants (unknown `type` values) keep their extra
- * properties exactly as received; unlike known variants, those keys
- * bypass lenient-field salvage and arrive unvalidated.
- */
-export const zAvailableCommandInput = preserveCustomPayload(z.union([
-    zTextCommandInput.and(z.object({
-        type: z.literal("text"),
-    })),
-    excludeKnownTags(z.object({
-        type: z.string(),
-    }), "type", ["text"]),
-]), "type", ["text"]);
-/**
- * Information about a command.
- */
-export const zAvailableCommand = z.object({
-    name: z.string(),
-    description: z.string(),
-    input: defaultOnError(zAvailableCommandInput.nullish(), () => undefined),
-    _meta: defaultOnError(z.record(z.string(), z.unknown()).nullish(), () => undefined),
-});
 /**
  * Available commands are ready or have changed
  */
@@ -2221,6 +2204,113 @@ 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),
+});
+/**
+ * **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 request or notification bearing the child's session ID,
+ * including messages naming it as sender or recipient. Child events are
+ * delivered automatically; no separate child load, resume, or subscription is needed.
+ * Understanding this update, registering child sessions, and applying their
+ * operation restrictions are baseline v2 requirements; no Client capability
+ * is required.
+ *
+ * Only [`SubagentUpdate::session_id`] is required. Other fields have
+ * patch semantics: omitted fields leave the stored value unchanged, `null`
+ * clears or unsets the value, and concrete values replace it. For `state`,
+ * `null` removes the current state report and leaves activity unconfirmed;
+ * it does not report idle or cancellation. A child whose capabilities are
+ * unset permits no Client-initiated session mutations.
+ *
+ * The title and description provide the parent's display metadata for the
+ * child. Agents SHOULD mirror known child state changes in the parent's
+ * [`SubagentUpdate::state`] using the same [`StateUpdate`] snapshot as the
+ * ordinary `state_update` notification on the child session. This reports
+ * child state, not a separate parent-owned lifecycle. Consumers should
+ * treat duplicate reports idempotently.
+ * Completing or cancelling work does not end the association: the parent may
+ * message the same child again. Individual messages and their outcomes do not
+ * change this association.
+ *
+ * @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 while a session exists.
  *
@@ -2293,6 +2383,15 @@ export const zSessionUpdate = preserveCustomPayload(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"),
+    })),
     excludeKnownTags(z.object({
         sessionUpdate: z.string(),
     }), "sessionUpdate", [
@@ -2308,7 +2407,10 @@ export const zSessionUpdate = preserveCustomPayload(z.union([
         "plan_removed",
         "plan_update",
         "session_info_update",
+        "session_message",
+        "session_message_chunk",
         "state_update",
+        "subagent_update",
         "terminal_output_chunk",
         "terminal_update",
         "tool_call_content_chunk",
@@ -2330,7 +2432,10 @@ export const zSessionUpdate = preserveCustomPayload(z.union([
     "plan_removed",
     "plan_update",
     "session_info_update",
+    "session_message",
+    "session_message_chunk",
     "state_update",
+    "subagent_update",
     "terminal_output_chunk",
     "terminal_update",
     "tool_call_content_chunk",
@@ -2358,24 +2463,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
@@ -2393,7 +2480,6 @@ export const zAgentNotification = z.object({
         .union([
         zUpdateSessionNotification,
         zCompleteElicitationNotification,
-        zMessageMcpNotification,
         zExtNotification,
     ])
         .nullish(),
@@ -2591,7 +2677,7 @@ export const zMcpServerHttp = 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
  */
@@ -2944,7 +3030,6 @@ export const zClientRequest = z.object({
         zStartNesRequest,
         zSuggestNesRequest,
         zCloseNesRequest,
-        zMessageMcpRequest,
         zExtRequest,
     ])
         .nullish(),
@@ -3023,28 +3108,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.
  */
@@ -3054,8 +3160,6 @@ export const zClientResponse = z.union([
         result: z.union([
             zRequestPermissionResponse,
             zCreateElicitationResponse,
-            zConnectMcpResponse,
-            zDisconnectMcpResponse,
             zMessageMcpResponse,
             zExtResponse,
         ]),
@@ -3160,6 +3264,21 @@ export const zRejectNesNotification = z.object({
     reason: defaultOnError(zNesRejectReason.nullish(), () => undefined),
     _meta: defaultOnError(z.record(z.string(), z.unknown()).nullish(), () => undefined),
 });
+/**
+ * **UNSTABLE**
+ *
+ * Notification for an active request, sent from provider to consumer.
+ * Includes subscription acknowledgements and updates.
+ *
+ * @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.
  */