@botiverse/raft-sdk 0.10.0 → 0.11.1

package/dist/index.d.ts

@@ -1164,7 +1164,7 @@ interface UserInfoRequest {
   name: string;
   /** Visible channels to skip before inspecting memberships (default 0). */
   offset?: number;
-  /** Visible channels to inspect for memberships (default 50). */
+  /** Visible channels to inspect for memberships (default 50, at most 200). */
   limit?: number;
 }
 export declare const userInfoRequestSchema: z.ZodObject<{
@@ -1295,6 +1295,10 @@ interface AgentMentionActionResult {
 export declare const pendingMentionActionsRequestSchema: z.ZodObject<{
   limit: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
+export declare const mentionResolutionIdsRequestSchema: z.ZodObject<{
+  resolutionIds: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+/** @deprecated The request of the deprecated `mentions.execute`; use `mentionResolutionIdsRequestSchema` (`mentions.notify` / `mentions.add`). */
 export declare const executeMentionActionRequestSchema: z.ZodObject<{
   action: z.ZodEnum<{
     notify: "notify";
@@ -1311,6 +1315,14 @@ interface RaftPendingMentions {
   hasMore: boolean | null;
   limit: number | undefined;
 }
+interface MentionResolutionIdsRequest {
+  resolutionIds: string[];
+}
+type RaftMentionActionOutcome = RaftOutcome<{
+  action: AgentMentionActionKind;
+  results: AgentMentionActionResult[];
+}, "executed">;
+/** @deprecated The request of the deprecated `mentions.execute`; use `MentionResolutionIdsRequest`. */
 interface ExecuteMentionActionRequest {
   action: AgentMentionActionKind;
   resolutionIds: string[];
@@ -2549,6 +2561,65 @@ declare const agentApiServerInfoResponseSchema: z.ZodObject<{
     }>>>;
   }, z.core.$loose>>;
 }, z.core.$loose>;
+declare const agentApiUserChannelsParamsSchema: z.ZodObject<{
+  name: z.ZodString;
+}, z.core.$loose>;
+declare const agentApiUserChannelsQuerySchema: z.ZodObject<{
+  offset: z.ZodOptional<z.ZodString>;
+  limit: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+/**
+ * One user's visible facts and their memberships among one window of the
+ * caller's visible channels (`GET /users/:name/channels`). `user` is the
+ * user's `serverInfo` agents / humans entry, unchanged.
+ */
+declare const agentApiUserChannelsResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+  memberships: z.ZodArray<z.ZodObject<{
+    id: z.ZodPipe<z.ZodString, z.ZodTransform<ChannelId, string>>;
+    name: z.ZodString;
+    joined: z.ZodBoolean;
+  }, z.core.$loose>>;
+  uncheckedCount: z.ZodNumber;
+  page: z.ZodObject<{
+    total: z.ZodNumber;
+    offset: z.ZodNumber;
+    limit: z.ZodNumber;
+  }, z.core.$loose>;
+  user: z.ZodObject<{
+    name: z.ZodString;
+    status: z.ZodOptional<z.ZodString>;
+    activity: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    activityDetail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    role: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+      owner: "owner";
+      admin: "admin";
+      member: "member";
+    }>>>;
+  }, z.core.$loose>;
+  kind: z.ZodLiteral<"agent">;
+}, z.core.$loose>, z.ZodObject<{
+  memberships: z.ZodArray<z.ZodObject<{
+    id: z.ZodPipe<z.ZodString, z.ZodTransform<ChannelId, string>>;
+    name: z.ZodString;
+    joined: z.ZodBoolean;
+  }, z.core.$loose>>;
+  uncheckedCount: z.ZodNumber;
+  page: z.ZodObject<{
+    total: z.ZodNumber;
+    offset: z.ZodNumber;
+    limit: z.ZodNumber;
+  }, z.core.$loose>;
+  user: z.ZodObject<{
+    name: z.ZodString;
+    role: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+      guest: "guest";
+      owner: "owner";
+      admin: "admin";
+      member: "member";
+    }>>>;
+  }, z.core.$loose>;
+  kind: z.ZodLiteral<"human">;
+}, z.core.$loose>], "kind">;
 declare const agentApiMentionActionsPendingQuerySchema: z.ZodObject<{
   limit: z.ZodOptional<z.ZodString>;
 }, z.core.$loose>;
@@ -5719,6 +5790,77 @@ declare const agentApiContract: {
   } & {
     fullPath: string;
   };
+  readonly userChannels: {
+    readonly key: "userChannels";
+    readonly method: "GET";
+    readonly path: "/users/:name/channels";
+    readonly client: {
+      readonly resource: "users";
+      readonly method: "channels";
+    };
+    readonly capability: "channels";
+    readonly description: "One visible agent or human (exact name, agents first; the serverInfo entry) and which of one window of your visible channels (serverInfo order, offset/limit, limit at most 200) list them as a member, in one request. Needs the read capability as well. 404 user_not_found when no visible user has that name.";
+    readonly request: {
+      readonly params: z.ZodObject<{
+        name: z.ZodString;
+      }, z.core.$loose>;
+      readonly query: z.ZodObject<{
+        offset: z.ZodOptional<z.ZodString>;
+        limit: z.ZodOptional<z.ZodString>;
+      }, z.core.$loose>;
+    };
+    readonly response: {
+      readonly body: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        memberships: z.ZodArray<z.ZodObject<{
+          id: z.ZodPipe<z.ZodString, z.ZodTransform<ChannelId, string>>;
+          name: z.ZodString;
+          joined: z.ZodBoolean;
+        }, z.core.$loose>>;
+        uncheckedCount: z.ZodNumber;
+        page: z.ZodObject<{
+          total: z.ZodNumber;
+          offset: z.ZodNumber;
+          limit: z.ZodNumber;
+        }, z.core.$loose>;
+        user: z.ZodObject<{
+          name: z.ZodString;
+          status: z.ZodOptional<z.ZodString>;
+          activity: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+          activityDetail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+          role: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            owner: "owner";
+            admin: "admin";
+            member: "member";
+          }>>>;
+        }, z.core.$loose>;
+        kind: z.ZodLiteral<"agent">;
+      }, z.core.$loose>, z.ZodObject<{
+        memberships: z.ZodArray<z.ZodObject<{
+          id: z.ZodPipe<z.ZodString, z.ZodTransform<ChannelId, string>>;
+          name: z.ZodString;
+          joined: z.ZodBoolean;
+        }, z.core.$loose>>;
+        uncheckedCount: z.ZodNumber;
+        page: z.ZodObject<{
+          total: z.ZodNumber;
+          offset: z.ZodNumber;
+          limit: z.ZodNumber;
+        }, z.core.$loose>;
+        user: z.ZodObject<{
+          name: z.ZodString;
+          role: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            guest: "guest";
+            owner: "owner";
+            admin: "admin";
+            member: "member";
+          }>>>;
+        }, z.core.$loose>;
+        kind: z.ZodLiteral<"human">;
+      }, z.core.$loose>], "kind">;
+    };
+  } & {
+    fullPath: string;
+  };
   readonly serverUpdate: {
     readonly key: "serverUpdate";
     readonly method: "PATCH";
@@ -8728,6 +8870,9 @@ type AgentApiOkResponse = z.infer<typeof agentApiOkResponseSchema>;
 type AgentApiActionPrepareResponse = z.infer<typeof agentApiActionPrepareResponseSchema>;
 type AgentApiAgentContextResponse = z.infer<typeof agentApiAgentContextResponseSchema>;
 type AgentApiServerInfoResponse = z.infer<typeof agentApiServerInfoResponseSchema>;
+type AgentApiUserChannelsParams = z.infer<typeof agentApiUserChannelsParamsSchema>;
+type AgentApiUserChannelsQuery = z.infer<typeof agentApiUserChannelsQuerySchema>;
+type AgentApiUserChannelsResponse = z.infer<typeof agentApiUserChannelsResponseSchema>;
 type AgentApiServerUpdateBody = z.infer<typeof agentApiServerUpdateBodySchema>;
 type AgentApiServerUpdateResponse = z.infer<typeof agentApiServerUpdateResponseSchema>;
 type AgentApiMentionActionsPendingQuery = z.infer<typeof agentApiMentionActionsPendingQuerySchema>;
@@ -8794,6 +8939,7 @@ type AgentApiRequestParamsByRoute = {
   inboxList: never;
   agentContext: never;
   serverInfo: never;
+  userChannels: AgentApiUserChannelsParams;
   serverUpdate: never;
   mentionActionsPending: never;
   senderMentionDeliveries: AgentApiSenderMentionDeliveriesParams;
@@ -8875,6 +9021,7 @@ type AgentApiRequestQueryByRoute = {
   inboxList: AgentApiInboxListQuery;
   agentContext: never;
   serverInfo: never;
+  userChannels: AgentApiUserChannelsQuery;
   serverUpdate: never;
   mentionActionsPending: AgentApiMentionActionsPendingQuery;
   senderMentionDeliveries: never;
@@ -8956,6 +9103,7 @@ type AgentApiRequestBodyByRoute = {
   inboxList: never;
   agentContext: never;
   serverInfo: never;
+  userChannels: never;
   serverUpdate: AgentApiServerUpdateBody;
   mentionActionsPending: never;
   senderMentionDeliveries: never;
@@ -9037,6 +9185,7 @@ type AgentApiResponseByRoute = {
   inboxList: AgentApiInboxListResponse;
   agentContext: AgentApiAgentContextResponse;
   serverInfo: AgentApiServerInfoResponse;
+  userChannels: AgentApiUserChannelsResponse;
   serverUpdate: AgentApiServerUpdateResponse;
   mentionActionsPending: AgentApiMentionActionsPendingResponse;
   senderMentionDeliveries: AgentApiSenderMentionDeliveriesResponse;
@@ -9916,9 +10065,54 @@ declare const OPERATION_DEFS: readonly [{
     readonly mayBeLarge: true;
     readonly boundBy: ["limit"];
   };
+}, {
+  readonly name: "mentions.notify";
+  readonly description: "Deliver unreached @mentions by notifying each mentioned target about the message, without adding them to the conversation. Takes resolutionId values from mentions.pending.";
+  readonly schema: z.ZodObject<{
+    resolutionIds: z.ZodArray<z.ZodString>;
+  }, z.core.$strip>;
+  readonly routes: readonly ["mentionActionsExecute"];
+  readonly consumes: {
+    model: never[];
+    code: never[];
+  };
+  readonly output: {
+    mayBeLarge: false;
+    boundBy: never[];
+  };
+}, {
+  readonly name: "mentions.add";
+  readonly description: "Deliver unreached @mentions by adding each mentioned target to the conversation, so they see the message and what follows. Takes resolutionId values from mentions.pending.";
+  readonly schema: z.ZodObject<{
+    resolutionIds: z.ZodArray<z.ZodString>;
+  }, z.core.$strip>;
+  readonly routes: readonly ["mentionActionsExecute"];
+  readonly consumes: {
+    model: never[];
+    code: never[];
+  };
+  readonly output: {
+    mayBeLarge: false;
+    boundBy: never[];
+  };
+}, {
+  readonly name: "mentions.delivery";
+  readonly description: "Whether each @mention in a message you sent reached its target.";
+  readonly schema: z.ZodObject<{
+    messageId: z.ZodString;
+  }, z.core.$strip>;
+  readonly routes: readonly ["senderMentionDeliveries"];
+  readonly consumes: {
+    model: never[];
+    code: never[];
+  };
+  readonly output: {
+    mayBeLarge: false;
+    boundBy: never[];
+  };
 }, {
   readonly name: "mentions.execute";
-  readonly description: "Deliver unreached @mentions: notify the mentioned target, or add them to the conversation.";
+  readonly description: "Deprecated: use mentions.notify / mentions.add. Removed in the next minor release. Deliver unreached @mentions: notify the mentioned target, or add them to the conversation.";
   readonly schema: z.ZodObject<{
     action: z.ZodEnum<{
       notify: "notify";
@@ -9935,9 +10129,10 @@ declare const OPERATION_DEFS: readonly [{
     mayBeLarge: false;
     boundBy: never[];
   };
+  readonly deprecated: true;
 }, {
   readonly name: "mentions.deliveries";
-  readonly description: "Whether each @mention in a message you sent reached its target.";
+  readonly description: "Deprecated: use mentions.delivery. Removed in the next minor release. Whether each @mention in a message you sent reached its target.";
   readonly schema: z.ZodObject<{
     messageId: z.ZodString;
   }, z.core.$strip>;
@@ -9950,6 +10145,7 @@ declare const OPERATION_DEFS: readonly [{
     mayBeLarge: false;
     boundBy: never[];
   };
+  readonly deprecated: true;
 }, {
   readonly name: "actions.prepare";
   readonly description: "Post an action card (create a channel, add members, create an agent, or an integration step) for a human to confirm; the human who clicks it carries it out as themselves. When it is executed (or fails), the outcome arrives as a reply that @mentions you in the card's thread (or in the thread the card was posted in).";
@@ -10455,7 +10651,7 @@ declare const OPERATION_DEFS: readonly [{
     offset: z.ZodOptional<z.ZodNumber>;
     limit: z.ZodOptional<z.ZodNumber>;
   }, z.core.$strip>;
-  readonly routes: readonly ["serverInfo", "channelMembers"];
+  readonly routes: readonly ["userChannels", "serverInfo"];
   readonly consumes: {
     model: never[];
     code: never[];
@@ -10686,12 +10882,17 @@ interface Raft {
     pending(request?: {
       limit?: number;
     }): Promise<RaftOutcome<RaftPendingMentions, "pending" | "empty">>;
-    /** `notify` the target of an unreached mention, or `add` them to the conversation. */
-    execute(request: ExecuteMentionActionRequest): Promise<RaftOutcome<{
-      action: AgentMentionActionKind;
-      results: AgentMentionActionResult[];
-    }, "executed">>;
-    /** Per-target delivery outcome for a message you sent. */
+    /** Notify the targets of unreached mentions about the message (`raft mention notify`). */
+    notify(request: MentionResolutionIdsRequest): Promise<RaftMentionActionOutcome>;
+    /** Add the targets of unreached mentions to the conversation (`raft mention add`). */
+    add(request: MentionResolutionIdsRequest): Promise<RaftMentionActionOutcome>;
+    /** Per-target delivery outcome for a message you sent (`raft mention delivery`). */
+    delivery(request: {
+      messageId: string;
+    }): Promise<RaftOutcome<AgentApiSenderMentionDeliveriesResponse, "deliveries" | "empty">>;
+    /** @deprecated Use `mentions.notify` / `mentions.add`; removed in 0.12.0. */
+    execute(request: ExecuteMentionActionRequest): Promise<RaftMentionActionOutcome>;
+    /** @deprecated Use `mentions.delivery`; removed in 0.12.0. */
     deliveries(request: {
       messageId: string;
     }): Promise<RaftOutcome<AgentApiSenderMentionDeliveriesResponse, "deliveries" | "empty">>;
@@ -10829,4 +11030,4 @@ export declare const commitInboxRequestSchema: z.ZodObject<{
   cursor: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
 }, z.core.$strip>;
 //#endregion
-export type { AmendTaskOutcome, AmendTaskRequest, AssignTaskRequest, BootstrapRaftCredentialOptions, CheckInboxOutcome, CheckInboxRequest, ClaimTasksOutcome, ClaimTasksRequest, ConvertMessageToTaskRequest, CreateRaftClientFromStoreOptions, CreateRaftClientOptions, CreateRaftOptions, CreateRaftRoutesOptions, CreateTasksRequest, DrainInboxRequest, ExecuteMentionActionRequest, ListInboxRequest, ListTasksRequest, ManualContext, PrepareActionCardRequest, Raft, RaftAckMode, RaftActionPrepareRequest, RaftActionPrepared, RaftApiError, RaftApiResult, RaftAppConfig, RaftAppConfigPatch, RaftAttachmentBytes, RaftAttachmentDownloadUrl, RaftAttachmentUploaded, RaftAvatarUpload, RaftChannelInfo, RaftChannelJoinClient, RaftChannelJoinClientResult, RaftChannelJoinError, RaftChannelJoinFailure, RaftChannelJoinOperation, RaftChannelJoinRequest, RaftChannelJoinResult, RaftChannelJoinSuccess, RaftChannelJoinTransportError, RaftChannelMuteState, RaftChannelRef, RaftClaimResult, RaftClaimRow, RaftClaimRowState, RaftClient, RaftClientError, RaftClientFailure, RaftClientResult, RaftClientSuccess, RaftClientThrottleOptions, RaftClientTransportRequest, RaftConsumption, RaftContextAgent, RaftContextData, RaftContextError, RaftContextResult, RaftContextServer, RaftCredentialErrorCode, RaftCredentialIdentity, RaftCredentialStore, RaftEvent, RaftEventAttachment, RaftEventExternalMessage, RaftEventsReceiveData, RaftEventsReceiveError, RaftEventsReceiveRequest, RaftEventsReceiveResult, RaftFailure, RaftHintStyle, RaftHistoryPage, RaftInboxBatch, RaftInboxCommitResult, RaftInboxConversation, RaftInboxDrainSummary, RaftInboxDrained, RaftInboxListing, RaftInboxNotice, RaftInterrupt, RaftInterruptCancel, RaftInterruptReason, RaftInterruptResume, RaftInterrupted, RaftInvokeCaller, RaftInvokeResult, RaftJsonSchema, RaftJsonSchemaType, RaftLatestReadThread, RaftManageClient, RaftMessage, RaftMessageAttachment, RaftMessageTask, RaftNextOperation, RaftNextStep, RaftNoticeFlag, RaftNoticeTarget, RaftOpError, RaftOpErrorCode, RaftOperationIdempotency, RaftOperationName, RaftOperationSpec, RaftOperationsDocument, RaftOutcome, RaftPendingMentions, RaftPreparedCard, RaftProfile, RaftProfileUpdate, RaftRouteAnnotations, RaftRouteInfo, RaftRouteKey, RaftRouteMeta, RaftRouteResult, RaftRouteRetryPolicy, RaftRoutes, RaftSdkConfigurationErrorCode, RaftSearchPage, RaftSenderType, RaftSent, RaftServerInfo, RaftServerProfile, RaftServerUpdate, RaftState, RaftStateContinuation, RaftStateSaveErrorHandler, RaftStateStore, RaftTaskBoard, RaftTaskStatus, RaftTasksCreated, RaftUserInfo, RaftUserRef, RaftWebhookStatus, ReactRequest, ReadHistoryRequest, ReadLatestReadThreadOptions, ReplyToRequest, SearchMessagesRequest, SeenAttestation, SeenFrontierSnapshot, SendMessageOutcome, SendMessageRequest, ServerInfoRequest, ServerInfoSection, StoredRaftCredential, TaskRef, UpdateTaskStatusOutcome, UpdateTaskStatusRequest, UploadAttachmentRequest, UserInfoRequest, VerifyNoticeInput, VerifyNoticeRejection, VerifyNoticeResult };
+export type { AmendTaskOutcome, AmendTaskRequest, AssignTaskRequest, BootstrapRaftCredentialOptions, CheckInboxOutcome, CheckInboxRequest, ClaimTasksOutcome, ClaimTasksRequest, ConvertMessageToTaskRequest, CreateRaftClientFromStoreOptions, CreateRaftClientOptions, CreateRaftOptions, CreateRaftRoutesOptions, CreateTasksRequest, DrainInboxRequest, ExecuteMentionActionRequest, ListInboxRequest, ListTasksRequest, ManualContext, MentionResolutionIdsRequest, PrepareActionCardRequest, Raft, RaftAckMode, RaftActionPrepareRequest, RaftActionPrepared, RaftApiError, RaftApiResult, RaftAppConfig, RaftAppConfigPatch, RaftAttachmentBytes, RaftAttachmentDownloadUrl, RaftAttachmentUploaded, RaftAvatarUpload, RaftChannelInfo, RaftChannelJoinClient, RaftChannelJoinClientResult, RaftChannelJoinError, RaftChannelJoinFailure, RaftChannelJoinOperation, RaftChannelJoinRequest, RaftChannelJoinResult, RaftChannelJoinSuccess, RaftChannelJoinTransportError, RaftChannelMuteState, RaftChannelRef, RaftClaimResult, RaftClaimRow, RaftClaimRowState, RaftClient, RaftClientError, RaftClientFailure, RaftClientResult, RaftClientSuccess, RaftClientThrottleOptions, RaftClientTransportRequest, RaftConsumption, RaftContextAgent, RaftContextData, RaftContextError, RaftContextResult, RaftContextServer, RaftCredentialErrorCode, RaftCredentialIdentity, RaftCredentialStore, RaftEvent, RaftEventAttachment, RaftEventExternalMessage, RaftEventsReceiveData, RaftEventsReceiveError, RaftEventsReceiveRequest, RaftEventsReceiveResult, RaftFailure, RaftHintStyle, RaftHistoryPage, RaftInboxBatch, RaftInboxCommitResult, RaftInboxConversation, RaftInboxDrainSummary, RaftInboxDrained, RaftInboxListing, RaftInboxNotice, RaftInterrupt, RaftInterruptCancel, RaftInterruptReason, RaftInterruptResume, RaftInterrupted, RaftInvokeCaller, RaftInvokeResult, RaftJsonSchema, RaftJsonSchemaType, RaftLatestReadThread, RaftManageClient, RaftMentionActionOutcome, RaftMessage, RaftMessageAttachment, RaftMessageTask, RaftNextOperation, RaftNextStep, RaftNoticeFlag, RaftNoticeTarget, RaftOpError, RaftOpErrorCode, RaftOperationIdempotency, RaftOperationName, RaftOperationSpec, RaftOperationsDocument, RaftOutcome, RaftPendingMentions, RaftPreparedCard, RaftProfile, RaftProfileUpdate, RaftRouteAnnotations, RaftRouteInfo, RaftRouteKey, RaftRouteMeta, RaftRouteResult, RaftRouteRetryPolicy, RaftRoutes, RaftSdkConfigurationErrorCode, RaftSearchPage, RaftSenderType, RaftSent, RaftServerInfo, RaftServerProfile, RaftServerUpdate, RaftState, RaftStateContinuation, RaftStateSaveErrorHandler, RaftStateStore, RaftTaskBoard, RaftTaskStatus, RaftTasksCreated, RaftUserInfo, RaftUserRef, RaftWebhookStatus, ReactRequest, ReadHistoryRequest, ReadLatestReadThreadOptions, ReplyToRequest, SearchMessagesRequest, SeenAttestation, SeenFrontierSnapshot, SendMessageOutcome, SendMessageRequest, ServerInfoRequest, ServerInfoSection, StoredRaftCredential, TaskRef, UpdateTaskStatusOutcome, UpdateTaskStatusRequest, UploadAttachmentRequest, UserInfoRequest, VerifyNoticeInput, VerifyNoticeRejection, VerifyNoticeResult };

package/operations.json

@@ -1,6 +1,6 @@
 {
   "schema": "raft-sdk-operations.v1",
-  "version": "4e70c891e417cd51",
+  "version": "2a304e867c59570a",
   "operations": [
     {
       "name": "identity.whoami",
@@ -729,10 +729,118 @@
         ]
       }
     },
+    {
+      "name": "mentions.notify",
+      "toolName": "mentions_notify",
+      "description": "Deliver unreached @mentions by notifying each mentioned target about the message, without adding them to the conversation. Takes resolutionId values from mentions.pending.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "resolutionIds": {
+            "type": "array",
+            "description": "resolutionId values from mentions.pending.",
+            "items": {
+              "type": "string"
+            }
+          }
+        },
+        "required": [
+          "resolutionIds"
+        ]
+      },
+      "sideEffect": "write",
+      "idempotency": {
+        "kind": "none"
+      },
+      "capability": [
+        "mentions"
+      ],
+      "modelOnly": false,
+      "mayInterrupt": false,
+      "consumes": {
+        "model": [],
+        "code": []
+      },
+      "output": {
+        "mayBeLarge": false,
+        "boundBy": []
+      }
+    },
+    {
+      "name": "mentions.add",
+      "toolName": "mentions_add",
+      "description": "Deliver unreached @mentions by adding each mentioned target to the conversation, so they see the message and what follows. Takes resolutionId values from mentions.pending.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "resolutionIds": {
+            "type": "array",
+            "description": "resolutionId values from mentions.pending.",
+            "items": {
+              "type": "string"
+            }
+          }
+        },
+        "required": [
+          "resolutionIds"
+        ]
+      },
+      "sideEffect": "write",
+      "idempotency": {
+        "kind": "none"
+      },
+      "capability": [
+        "mentions"
+      ],
+      "modelOnly": false,
+      "mayInterrupt": false,
+      "consumes": {
+        "model": [],
+        "code": []
+      },
+      "output": {
+        "mayBeLarge": false,
+        "boundBy": []
+      }
+    },
+    {
+      "name": "mentions.delivery",
+      "toolName": "mentions_delivery",
+      "description": "Whether each @mention in a message you sent reached its target.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "messageId": {
+            "type": "string",
+            "description": "Id of a message you sent."
+          }
+        },
+        "required": [
+          "messageId"
+        ]
+      },
+      "sideEffect": "read",
+      "idempotency": {
+        "kind": "natural"
+      },
+      "capability": [
+        "mentions"
+      ],
+      "modelOnly": false,
+      "mayInterrupt": false,
+      "consumes": {
+        "model": [],
+        "code": []
+      },
+      "output": {
+        "mayBeLarge": false,
+        "boundBy": []
+      }
+    },
     {
       "name": "mentions.execute",
       "toolName": "mentions_execute",
-      "description": "Deliver unreached @mentions: notify the mentioned target, or add them to the conversation.",
+      "description": "Deprecated: use mentions.notify / mentions.add. Removed in the next minor release. Deliver unreached @mentions: notify the mentioned target, or add them to the conversation.",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -773,12 +881,13 @@
       "output": {
         "mayBeLarge": false,
         "boundBy": []
-      }
+      },
+      "deprecated": true
     },
     {
       "name": "mentions.deliveries",
       "toolName": "mentions_deliveries",
-      "description": "Whether each @mention in a message you sent reached its target.",
+      "description": "Deprecated: use mentions.delivery. Removed in the next minor release. Whether each @mention in a message you sent reached its target.",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -807,7 +916,8 @@
       "output": {
         "mayBeLarge": false,
         "boundBy": []
-      }
+      },
+      "deprecated": true
     },
     {
       "name": "actions.prepare",
@@ -2031,8 +2141,9 @@
           },
           "limit": {
             "type": "integer",
-            "description": "Membership paging: visible channels to inspect (default 50).",
-            "minimum": 1
+            "description": "Membership paging: visible channels to inspect (default 50, at most 200).",
+            "minimum": 1,
+            "maximum": 200
           }
         },
         "required": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botiverse/raft-sdk",
-  "version": "0.10.0",
+  "version": "0.11.1",
   "license": "FSL-1.1-ALv2",
   "description": "Typed Raft Agent API client for external agents and bots.",
   "type": "module",