@tickernelz/paperclip-pro-adapter-utils 2026.1002.4 → 2026.1002.5

package/node_modules/@agentclientprotocol/sdk/dist/v2/schema/types.gen.d.ts

@@ -1,3 +1,19 @@
+declare const unknownVariant: unique symbol;
+/**
+ * A variant of an extensible union that this SDK does not know, as received
+ * from a peer, for example one added by a newer ACP version.
+ *
+ * Only received values have this type. A value you build is a known variant,
+ * checked field by field, or a custom variant whose tag starts with `_`, so
+ * a misspelled or missing field on a known variant is a compile error.
+ * Received values keep the type, so passing them on needs no conversion. The
+ * brand exists only in the types.
+ *
+ * @experimental
+ */
+export type UnknownVariant<T> = T & {
+    readonly [unknownVariant]: true;
+};
 /**
  * A JSON-RPC request object.
  */
@@ -92,7 +108,17 @@ export type RequestPermissionSubject = (ToolCallPermissionSubject & {
     type: "tool_call";
 }) | (CommandPermissionSubject & {
     type: "command";
-}) | {
+}) | ({
+    /**
+     * Custom or future permission subject type.
+     *
+     * Values beginning with `_` are reserved for implementation-specific
+     * extensions. Unknown values that do not begin with `_` are reserved for
+     * future ACP variants.
+     */
+    type: `_${string}`;
+    [key: string]: unknown;
+} | UnknownVariant<{
     /**
      * Custom or future permission subject type.
      *
@@ -102,7 +128,7 @@ export type RequestPermissionSubject = (ToolCallPermissionSubject & {
      */
     type: string;
     [key: string]: unknown;
-};
+}>);
 /**
  * Represents an upsert for a tool call that the language model has requested.
  *
@@ -208,7 +234,17 @@ export type ToolCallContent = (Content & {
     type: "diff";
 }) | (Terminal & {
     type: "terminal";
-}) | {
+}) | ({
+    /**
+     * Custom or future tool call content type.
+     *
+     * Values beginning with `_` are reserved for implementation-specific
+     * extensions. Unknown values that do not begin with `_` are reserved for
+     * future ACP variants.
+     */
+    type: `_${string}`;
+    [key: string]: unknown;
+} | UnknownVariant<{
     /**
      * Custom or future tool call content type.
      *
@@ -218,7 +254,7 @@ export type ToolCallContent = (Content & {
      */
     type: string;
     [key: string]: unknown;
-};
+}>);
 /**
  * Content blocks represent displayable information in the Agent Client Protocol.
  *
@@ -246,7 +282,17 @@ export type ContentBlock = (TextContent & {
     type: "resource_link";
 }) | (EmbeddedResource & {
     type: "resource";
-}) | {
+}) | ({
+    /**
+     * Custom or future content block type.
+     *
+     * Values beginning with `_` are reserved for implementation-specific
+     * extensions. Unknown values that do not begin with `_` are reserved for
+     * future ACP variants.
+     */
+    type: `_${string}`;
+    [key: string]: unknown;
+} | UnknownVariant<{
     /**
      * Custom or future content block type.
      *
@@ -256,7 +302,7 @@ export type ContentBlock = (TextContent & {
      */
     type: string;
     [key: string]: unknown;
-};
+}>);
 /**
  * Optional annotations for the client. The client can use annotations to inform how objects are used or displayed
  */
@@ -567,7 +613,17 @@ export type DiffChange = ((DiffPathChange & {
     operation: "move";
 }) | (DiffPathPairChange & {
     operation: "copy";
-}) | {
+}) | ({
+    /**
+     * Custom or future file operation.
+     *
+     * Values beginning with `_` are reserved for implementation-specific
+     * extensions. Unknown values that do not begin with `_` are reserved for
+     * future ACP variants.
+     */
+    operation: `_${string}`;
+    [key: string]: unknown;
+} | UnknownVariant<{
     /**
      * Custom or future file operation.
      *
@@ -577,7 +633,7 @@ export type DiffChange = ((DiffPathChange & {
      */
     operation: string;
     [key: string]: unknown;
-}) & {
+}>)) & {
     /**
      * File content kind.
      *
@@ -826,7 +882,17 @@ export type CreateElicitationRequest = ((ElicitationFormMode & {
     mode: "form";
 }) | (ElicitationUrlMode & {
     mode: "url";
-}) | ((ElicitationSessionScope | ElicitationRequestScope) & {
+}) | ((ElicitationSessionScope | ElicitationRequestScope) & ({
+    /**
+     * Custom or future elicitation mode.
+     *
+     * Values beginning with `_` are reserved for implementation-specific
+     * extensions. Unknown values that do not begin with `_` are reserved for
+     * future ACP variants.
+     */
+    mode: `_${string}`;
+    [key: string]: unknown;
+} | UnknownVariant<{
     /**
      * Custom or future elicitation mode.
      *
@@ -836,7 +902,7 @@ export type CreateElicitationRequest = ((ElicitationFormMode & {
      */
     mode: string;
     [key: string]: unknown;
-})) & {
+}>))) & {
     /**
      * A human-readable message describing what input is needed.
      */
@@ -953,7 +1019,17 @@ export type ElicitationPropertySchema = (StringPropertySchema & {
     type: "boolean";
 }) | (MultiSelectPropertySchema & {
     type: "array";
-}) | {
+}) | ({
+    /**
+     * Custom or future elicitation property schema type.
+     *
+     * Values beginning with `_` are reserved for implementation-specific
+     * extensions. Unknown values that do not begin with `_` are reserved for
+     * future ACP variants.
+     */
+    type: `_${string}`;
+    [key: string]: unknown;
+} | UnknownVariant<{
     /**
      * Custom or future elicitation property schema type.
      *
@@ -963,7 +1039,7 @@ export type ElicitationPropertySchema = (StringPropertySchema & {
      */
     type: string;
     [key: string]: unknown;
-};
+}>);
 /**
  * String format types for string properties in elicitation schemas.
  */
@@ -1209,7 +1285,17 @@ export type BooleanPropertySchema = {
  */
 export type MultiSelectItems = (StringMultiSelectItems & {
     type: "string";
-}) | {
+}) | ({
+    /**
+     * Custom or future multi-select item type.
+     *
+     * Values beginning with `_` are reserved for implementation-specific
+     * extensions. Unknown values that do not begin with `_` are reserved for
+     * future ACP variants.
+     */
+    type: `_${string}`;
+    [key: string]: unknown;
+} | UnknownVariant<{
     /**
      * Custom or future multi-select item type.
      *
@@ -1219,7 +1305,7 @@ export type MultiSelectItems = (StringMultiSelectItems & {
      */
     type: string;
     [key: string]: unknown;
-} | TitledMultiSelectItems;
+}>) | TitledMultiSelectItems;
 /**
  * String item schema for multi-select enum properties.
  */
@@ -2274,7 +2360,39 @@ export type AuthMethod = (AuthMethodTerminal & {
     type: "terminal";
 }) | (AuthMethodAgent & {
     type: "agent";
-}) | {
+}) | ({
+    /**
+     * Custom or future authentication method type.
+     *
+     * Values beginning with `_` are reserved for implementation-specific
+     * extensions. Unknown values that do not begin with `_` are reserved for
+     * future ACP variants.
+     */
+    type: `_${string}`;
+    /**
+     * Unique identifier for this authentication method.
+     */
+    methodId: AuthMethodId;
+    /**
+     * Human-readable name of the authentication method.
+     */
+    name: string;
+    /**
+     * Optional description providing more details about this authentication method.
+     */
+    description?: string | null;
+    /**
+     * The _meta property is reserved by ACP to allow clients and agents to attach additional
+     * metadata to their interactions. Implementations MUST NOT make assumptions about values at
+     * these keys.
+     *
+     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/draft/extensibility)
+     */
+    _meta?: {
+        [key: string]: unknown;
+    } | null;
+    [key: string]: unknown;
+} | UnknownVariant<{
     /**
      * Custom or future authentication method type.
      *
@@ -2306,7 +2424,7 @@ export type AuthMethod = (AuthMethodTerminal & {
         [key: string]: unknown;
     } | null;
     [key: string]: unknown;
-};
+}>);
 /**
  * Typed identifier used for auth method values on the wire.
  */
@@ -2638,7 +2756,17 @@ export type SessionConfigOption = ((SessionConfigSelect & {
     type: "select";
 }) | (SessionConfigBoolean & {
     type: "boolean";
-}) | {
+}) | ({
+    /**
+     * Custom or future session configuration option type.
+     *
+     * Values beginning with `_` are reserved for implementation-specific
+     * extensions. Unknown values that do not begin with `_` are reserved for
+     * future ACP variants.
+     */
+    type: `_${string}`;
+    [key: string]: unknown;
+} | UnknownVariant<{
     /**
      * Custom or future session configuration option type.
      *
@@ -2648,7 +2776,7 @@ export type SessionConfigOption = ((SessionConfigSelect & {
      */
     type: string;
     [key: string]: unknown;
-}) & {
+}>)) & {
     /**
      * Unique identifier for the configuration option.
      */
@@ -2812,7 +2940,17 @@ export type AvailableCommand = {
  */
 export type AvailableCommandInput = (TextCommandInput & {
     type: "text";
-}) | {
+}) | ({
+    /**
+     * Custom or future command input type.
+     *
+     * Values beginning with `_` are reserved for implementation-specific
+     * extensions. Unknown values that do not begin with `_` are reserved for
+     * future ACP variants.
+     */
+    type: `_${string}`;
+    [key: string]: unknown;
+} | UnknownVariant<{
     /**
      * Custom or future command input type.
      *
@@ -2822,7 +2960,7 @@ export type AvailableCommandInput = (TextCommandInput & {
      */
     type: string;
     [key: string]: unknown;
-};
+}>);
 /**
  * All text that was typed after the command name is provided as input.
  */
@@ -3106,7 +3244,21 @@ export type NesSuggestion = (NesEditSuggestion & {
     kind: "rename";
 }) | (NesSearchAndReplaceSuggestion & {
     kind: "searchAndReplace";
-}) | {
+}) | ({
+    /**
+     * Custom or future NES suggestion kind.
+     *
+     * Values beginning with `_` are reserved for implementation-specific
+     * extensions. Unknown values that do not begin with `_` are reserved for
+     * future ACP variants.
+     */
+    kind: `_${string}`;
+    /**
+     * Unique identifier for accept/reject tracking.
+     */
+    suggestionId: NesSuggestionId;
+    [key: string]: unknown;
+} | UnknownVariant<{
     /**
      * Custom or future NES suggestion kind.
      *
@@ -3120,7 +3272,7 @@ export type NesSuggestion = (NesEditSuggestion & {
      */
     suggestionId: NesSuggestionId;
     [key: string]: unknown;
-};
+}>);
 /**
  * **UNSTABLE**
  *
@@ -3474,7 +3626,17 @@ export type SessionUpdate = (ContentChunk & {
     sessionUpdate: "session_message";
 }) | (SessionMessageChunk & {
     sessionUpdate: "session_message_chunk";
-}) | {
+}) | ({
+    /**
+     * Custom or future session update type.
+     *
+     * Values beginning with `_` are reserved for implementation-specific
+     * extensions. Unknown values that do not begin with `_` are reserved for
+     * future ACP variants.
+     */
+    sessionUpdate: `_${string}`;
+    [key: string]: unknown;
+} | UnknownVariant<{
     /**
      * Custom or future session update type.
      *
@@ -3484,7 +3646,7 @@ export type SessionUpdate = (ContentChunk & {
      */
     sessionUpdate: string;
     [key: string]: unknown;
-};
+}>);
 /**
  * A streamed item of message content.
  */
@@ -3773,7 +3935,17 @@ export type StateUpdate = (RunningStateUpdate & {
     state: "requires_action";
 }) | (UnknownStateUpdate & {
     state: "unknown";
-}) | {
+}) | ({
+    /**
+     * Custom or future session state.
+     *
+     * Values beginning with `_` are reserved for implementation-specific
+     * extensions. Unknown values that do not begin with `_` are reserved for
+     * future ACP variants.
+     */
+    state: `_${string}`;
+    [key: string]: unknown;
+} | UnknownVariant<{
     /**
      * Custom or future session state.
      *
@@ -3783,7 +3955,7 @@ export type StateUpdate = (RunningStateUpdate & {
      */
     state: string;
     [key: string]: unknown;
-};
+}>);
 /**
  * A streamed item of tool-call content.
  *
@@ -3936,7 +4108,21 @@ export type PlanUpdateContent = (PlanItems & {
     type: "file";
 }) | (PlanMarkdown & {
     type: "markdown";
-}) | {
+}) | ({
+    /**
+     * Custom or future plan update content type.
+     *
+     * Values beginning with `_` are reserved for implementation-specific
+     * extensions. Unknown values that do not begin with `_` are reserved for
+     * future ACP variants.
+     */
+    type: `_${string}`;
+    /**
+     * The plan ID to update.
+     */
+    planId: PlanId;
+    [key: string]: unknown;
+} | UnknownVariant<{
     /**
      * Custom or future plan update content type.
      *
@@ -3950,7 +4136,7 @@ export type PlanUpdateContent = (PlanItems & {
      */
     planId: PlanId;
     [key: string]: unknown;
-};
+}>);
 /**
  * Unique identifier for a plan within a session.
  */
@@ -5093,7 +5279,17 @@ export type McpServer = (McpServerHttp & {
     type: "acp";
 }) | (McpServerStdio & {
     type: "stdio";
-}) | {
+}) | ({
+    /**
+     * Custom or future MCP server transport type.
+     *
+     * Values beginning with `_` are reserved for implementation-specific
+     * extensions. Unknown values that do not begin with `_` are reserved for
+     * future ACP variants.
+     */
+    type: `_${string}`;
+    [key: string]: unknown;
+} | UnknownVariant<{
     /**
      * Custom or future MCP server transport type.
      *
@@ -5103,7 +5299,7 @@ export type McpServer = (McpServerHttp & {
      */
     type: string;
     [key: string]: unknown;
-};
+}>);
 /**
  * An HTTP header to set when making requests to the MCP server.
  */
@@ -5366,7 +5562,27 @@ export type ResumeSessionRequest = {
  */
 export type ReplayFrom = (ReplayFromStart & {
     type: "start";
-}) | {
+}) | ({
+    /**
+     * Custom or future replay cursor type.
+     *
+     * Values beginning with `_` are reserved for implementation-specific
+     * extensions. Unknown values that do not begin with `_` are reserved for
+     * future ACP variants.
+     */
+    type: `_${string}`;
+    /**
+     * The _meta property is reserved by ACP to allow clients and agents to attach additional
+     * metadata to their interactions. Implementations MUST NOT make assumptions about values at
+     * these keys.
+     *
+     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/v2/draft/extensibility)
+     */
+    _meta?: {
+        [key: string]: unknown;
+    } | null;
+    [key: string]: unknown;
+} | UnknownVariant<{
     /**
      * Custom or future replay cursor type.
      *
@@ -5386,7 +5602,7 @@ export type ReplayFrom = (ReplayFromStart & {
         [key: string]: unknown;
     } | null;
     [key: string]: unknown;
-};
+}>);
 /**
  * Inclusive replay cursor requesting replay from the start of retained conversation history.
  */
@@ -5440,7 +5656,21 @@ export type SetSessionConfigOptionRequest = ({
      */
     value: boolean;
     type: "boolean";
-} | {
+} | ({
+    /**
+     * Custom or future session configuration option value type.
+     *
+     * Values beginning with `_` are reserved for implementation-specific
+     * extensions. Unknown values that do not begin with `_` are reserved for
+     * future ACP variants.
+     */
+    type: `_${string}`;
+    /**
+     * Raw value payload for the custom or future value type.
+     */
+    value: unknown;
+    [key: string]: unknown;
+} | UnknownVariant<{
     /**
      * Custom or future session configuration option value type.
      *
@@ -5454,7 +5684,7 @@ export type SetSessionConfigOptionRequest = ({
      */
     value: unknown;
     [key: string]: unknown;
-}) & {
+}>)) & {
     /**
      * The ID of the session to set the configuration option for.
      */
@@ -5943,7 +6173,17 @@ export type RequestPermissionOutcome = {
     outcome: "cancelled";
 } | (SelectedPermissionOutcome & {
     outcome: "selected";
-}) | {
+}) | ({
+    /**
+     * Custom or future permission outcome.
+     *
+     * Values beginning with `_` are reserved for implementation-specific
+     * extensions. Unknown values that do not begin with `_` are reserved for
+     * future ACP variants.
+     */
+    outcome: `_${string}`;
+    [key: string]: unknown;
+} | UnknownVariant<{
     /**
      * Custom or future permission outcome.
      *
@@ -5953,7 +6193,7 @@ export type RequestPermissionOutcome = {
      */
     outcome: string;
     [key: string]: unknown;
-};
+}>);
 /**
  * The user selected one of the provided options.
  */
@@ -5982,7 +6222,17 @@ export type CreateElicitationResponse = ((ElicitationAcceptAction & {
     action: "decline";
 } | {
     action: "cancel";
-} | {
+} | ({
+    /**
+     * Custom or future elicitation action.
+     *
+     * Values beginning with `_` are reserved for implementation-specific
+     * extensions. Unknown values that do not begin with `_` are reserved for
+     * future ACP variants.
+     */
+    action: `_${string}`;
+    [key: string]: unknown;
+} | UnknownVariant<{
     /**
      * Custom or future elicitation action.
      *
@@ -5992,7 +6242,7 @@ export type CreateElicitationResponse = ((ElicitationAcceptAction & {
      */
     action: string;
     [key: string]: unknown;
-}) & {
+}>)) & {
     /**
      * The _meta property is reserved by ACP to allow clients and agents to attach additional
      * metadata to their interactions. Implementations MUST NOT make assumptions about values at
@@ -6412,3 +6662,4 @@ export type CancelRequestNotification = {
         [key: string]: unknown;
     } | null;
 };
+export {};

package/node_modules/@agentclientprotocol/sdk/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentclientprotocol/sdk",
-  "version": "1.6.1",
+  "version": "1.7.0",
   "publishConfig": {
     "access": "public"
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tickernelz/paperclip-pro-adapter-utils",
-  "version": "2026.1002.4",
+  "version": "2026.1002.5",
   "license": "MIT",
   "homepage": "https://github.com/tickernelz/paperclip-pro",
   "bugs": {
@@ -34,7 +34,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@tickernelz/paperclip-pro-shared": "2026.1002.4",
+    "@tickernelz/paperclip-pro-shared": "2026.1002.5",
     "acpx": "0.12.0",
     "picocolors": "^1.1.1"
   },