@botiverse/raft-sdk 0.7.0 → 0.9.0

package/dist/index.d.ts

@@ -878,6 +878,19 @@ interface CreateTasksRequest {
   }>;
   /** `@handle`; yourself to start in_progress, or (owner/admin) someone else to reserve a todo. */
   assignee?: string;
+  /**
+   * One key per logical create. Generated with `crypto.randomUUID()` when
+   * omitted and returned as `data.idempotencyKey` (and, on a retryable
+   * failure, as `next.args.idempotencyKey`). Repeating the same request with
+   * the same key returns the first result (same task numbers) and creates
+   * nothing; the same key with a different request fails with
+   * `IDEMPOTENCY_KEY_REUSED`. A key is valid for 24 hours: retry within that
+   * window; after it the Server forgets the key and the same request creates
+   * again. The SDK never retries on its own: Servers
+   * without keyed task create ignore the key, and a repeat there creates the
+   * tasks again.
+   */
+  idempotencyKey?: string;
 }
 export declare const createTasksRequestSchema: z.ZodObject<{
   target: z.ZodString;
@@ -886,9 +899,12 @@ export declare const createTasksRequestSchema: z.ZodObject<{
     createsResource: z.ZodOptional<z.ZodBoolean>;
   }, z.core.$strip>>;
   assignee: z.ZodOptional<z.ZodString>;
+  idempotencyKey: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 type RaftTasksCreated = AgentApiTaskCreateResponse & {
   target: string;
+  /** The key this create was sent with (the caller's, or the generated one). */
+  idempotencyKey: string;
 };
 interface TaskRef {
   target: string;
@@ -1007,6 +1023,40 @@ interface VerifyNoticeInput {
 export declare function verifyInboxNotice(input: VerifyNoticeInput): Promise<VerifyNoticeResult>;
 type RaftWebhookStatus = AgentApiPushWebhookStatusResponse;
 //#endregion
+//#region ../shared/src/agentText/server.d.ts
+interface AgentChannelInfo {
+  id?: string | null;
+  name: string;
+  joined: boolean;
+  type?: string | null;
+  description?: string | null;
+  muted?: boolean | null;
+  activityMuted?: boolean | null;
+  archived?: boolean | null;
+  channelRole?: "member" | "admin" | null;
+  channelAdminBasis?: "server_role" | "channel_role" | "both" | null;
+  channelCapabilities?: Record<string, boolean> | null;
+}
+interface AgentAgentInfo {
+  name: string;
+  status?: string | null;
+  activity?: string | null;
+  activityDetail?: string | null;
+  role?: "owner" | "admin" | "member" | string | null;
+  description?: string | null;
+}
+interface AgentHumanInfo {
+  name: string;
+  role?: "owner" | "admin" | "member" | string | null;
+  description?: string | null;
+}
+interface AgentPageInfo {
+  total: number;
+  offset: number;
+  limit: number;
+  nextCommand?: string;
+}
+//#endregion
 //#region ../shared/src/agentOps/channels.d.ts
 /** `{ target }` of a regular channel (join, leave, mute, unmute). */
 export declare const channelTargetRequestSchema: z.ZodObject<{
@@ -1030,13 +1080,17 @@ interface RaftChannelMuteState extends RaftChannelRef {
   muteFromSeq: number | null;
   stillArrives: string[];
 }
-//#endregion
-//#region ../shared/src/agentText/server.d.ts
-interface AgentPageInfo {
-  total: number;
-  offset: number;
-  limit: number;
-  nextCommand?: string;
+export declare const channelInfoRequestSchema: z.ZodObject<{
+  target: z.ZodString;
+}, z.core.$strip>;
+interface RaftChannelInfo {
+  /** The channel as `server.info` lists it (`joined` and the attention flags are yours). */
+  channel: AgentChannelInfo;
+  /** Roster counts, or null when the Server refused the roster (the text then omits `Members:`). */
+  memberCounts: {
+    agents: number;
+    humans: number;
+  } | null;
 }
 //#endregion
 //#region ../shared/src/agentOps/server.d.ts
@@ -1079,6 +1133,35 @@ interface RaftServerInfo {
     section: ServerInfoSection;
   }) | null;
 }
+interface UserInfoRequest {
+  /** The user's handle, `@name` or `name`. */
+  name: string;
+  /** Visible channels to skip before inspecting memberships (default 0). */
+  offset?: number;
+  /** Visible channels to inspect for memberships (default 50). */
+  limit?: number;
+}
+export declare const userInfoRequestSchema: z.ZodObject<{
+  name: z.ZodString;
+  offset: z.ZodOptional<z.ZodNumber>;
+  limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+type RaftUserRef = {
+  kind: "agent";
+  value: AgentAgentInfo;
+} | {
+  kind: "human";
+  value: AgentHumanInfo;
+};
+interface RaftUserInfo {
+  user: RaftUserRef;
+  /** The inspected visible channels whose roster lists the user (`joined` is the user's, not yours). */
+  memberships: AgentChannelInfo[];
+  /** Inspected channels whose roster the Server refused; they are not counted either way. */
+  skippedChannels: number;
+  /** Paging over the visible channels (`total` is all visible channels). */
+  page: AgentPageInfo;
+}
 //#endregion
 //#region ../shared/src/agentOps/attachments.d.ts
 export declare const attachmentCommentsRequestSchema: z.ZodObject<{
@@ -1263,6 +1346,15 @@ export declare function parseRaftState(value: unknown): RaftState | null;
 export declare function hashRaftSendContent(target: string, content: string, attachmentIds?: readonly string[]): Promise<string>;
 //#endregion
 //#region ../shared/src/agentOps/actions.d.ts
+/**
+ * `idempotencyKey`: one key per logical prepare. Generated with
+ * `crypto.randomUUID()` when omitted and returned as `data.idempotencyKey`
+ * (and, on a retryable failure, as `next.args.idempotencyKey`). Repeating the
+ * same request with the same key returns the first card (same `messageId`)
+ * and posts nothing; the same key with a different request fails with
+ * `IDEMPOTENCY_KEY_REUSED`. A key is valid for 24 hours; after that the
+ * Server forgets it. Servers without keyed prepare ignore the key.
+ */
 type PrepareActionCardRequest = AgentApiActionPrepareBody;
 /**
  * The Agent API's own body schema (a discriminated union over the card
@@ -1345,11 +1437,14 @@ export declare const prepareActionCardRequestSchema: import("zod").ZodObject<{
     targetAgent: import("zod").ZodString;
     draftHint: import("zod").ZodOptional<import("zod").ZodString>;
   }, import("zod/v4/core").$strip>], "type">;
+  idempotencyKey: import("zod").ZodOptional<import("zod").ZodString>;
 }, import("zod/v4/core").$loose>;
 interface RaftPreparedCard {
   target: string;
   /** The card message; a human commits it by clicking its action verb. */
   messageId: string;
+  /** The key this prepare was sent with (the caller's `idempotencyKey`, or the generated one). */
+  idempotencyKey: string;
 }
 //#endregion
 //#region ../shared/src/agentApiRawClient.d.ts
@@ -2045,6 +2140,7 @@ declare const agentApiTaskCreateBodySchema: z.ZodObject<{
     creates_resource: z.ZodOptional<z.ZodBoolean>;
   }, z.core.$loose>>;
   assignee: z.ZodOptional<z.ZodString>;
+  idempotencyKey: z.ZodOptional<z.ZodString>;
 }, z.core.$loose>;
 declare const agentApiTaskUnclaimBodySchema: z.ZodObject<{
   channel: z.ZodString;
@@ -2326,6 +2422,7 @@ declare const agentApiActionPrepareBodySchema: z.ZodObject<{
     targetAgent: z.ZodString;
     draftHint: z.ZodOptional<z.ZodString>;
   }, z.core.$strip>], "type">;
+  idempotencyKey: z.ZodOptional<z.ZodString>;
 }, z.core.$loose>;
 declare const agentApiServerUpdateBodySchema: z.ZodObject<{
   name: z.ZodOptional<z.ZodString>;
@@ -6084,6 +6181,7 @@ declare const agentApiContract: {
           creates_resource: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$loose>>;
         assignee: z.ZodOptional<z.ZodString>;
+        idempotencyKey: z.ZodOptional<z.ZodString>;
       }, z.core.$loose>;
     };
     readonly response: {
@@ -7926,6 +8024,7 @@ declare const agentApiContract: {
           targetAgent: z.ZodString;
           draftHint: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>], "type">;
+        idempotencyKey: z.ZodOptional<z.ZodString>;
       }, z.core.$loose>;
     };
     readonly response: {
@@ -9841,12 +9940,15 @@ declare const OPERATION_DEFS: readonly [{
       targetAgent: z.ZodString;
       draftHint: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>], "type">;
+    idempotencyKey: z.ZodOptional<z.ZodString>;
   }, z.core.$loose>;
   readonly fieldDescriptions: {
     readonly target: "Conversation to post the card in: `#channel`, `dm:@peer`, or a thread.";
     readonly action: "The operation the card proposes: `type` picks it, and the other fields apply per type as described.";
+    readonly idempotencyKey: "One key per logical prepare; generated when omitted and returned. Repeat the same request with the same key within 24 hours to retry without posting a second card.";
   };
   readonly routes: readonly ["actionPrepare"];
+  readonly idempotencyArg: "idempotencyKey";
   readonly consumes: {
     model: never[];
     code: never[];
@@ -9942,8 +10044,10 @@ declare const OPERATION_DEFS: readonly [{
       createsResource: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>;
     assignee: z.ZodOptional<z.ZodString>;
+    idempotencyKey: z.ZodOptional<z.ZodString>;
   }, z.core.$strip>;
   readonly routes: readonly ["taskCreate"];
+  readonly idempotencyArg: "idempotencyKey";
   readonly consumes: {
     model: never[];
     code: never[];
@@ -10062,6 +10166,22 @@ declare const OPERATION_DEFS: readonly [{
     readonly mayBeLarge: true;
     readonly boundBy: [];
   };
+}, {
+  readonly name: "tasks.show";
+  readonly description: "One task's current status, title, and description. Finds done and closed tasks too.";
+  readonly schema: z.ZodObject<{
+    target: z.ZodString;
+    taskNumber: z.ZodNumber;
+  }, z.core.$strip>;
+  readonly routes: readonly ["taskList"];
+  readonly consumes: {
+    model: never[];
+    code: never[];
+  };
+  readonly output: {
+    readonly mayBeLarge: true;
+    readonly boundBy: [];
+  };
 }, {
   readonly name: "tasks.convert";
   readonly description: "Turn a top-level message into an unassigned task.";
@@ -10169,6 +10289,21 @@ declare const OPERATION_DEFS: readonly [{
     readonly mayBeLarge: true;
     readonly boundBy: [];
   };
+}, {
+  readonly name: "channels.info";
+  readonly description: "A regular channel's facts: visibility, whether you joined it, your role and mute state, description, and member counts.";
+  readonly schema: z.ZodObject<{
+    target: z.ZodString;
+  }, z.core.$strip>;
+  readonly routes: readonly ["serverInfo", "channelMembers"];
+  readonly consumes: {
+    model: never[];
+    code: never[];
+  };
+  readonly output: {
+    mayBeLarge: false;
+    boundBy: never[];
+  };
 }, {
   readonly name: "threads.list";
   readonly description: "The threads you follow.";
@@ -10222,6 +10357,23 @@ declare const OPERATION_DEFS: readonly [{
     readonly mayBeLarge: true;
     readonly boundBy: ["view", "offset", "limit"];
   };
+}, {
+  readonly name: "users.info";
+  readonly description: "A human's or agent's visible facts (kind, status, role, description) and which visible channels they are in. Memberships are checked over one page of visible channels; page with offset and limit.";
+  readonly schema: z.ZodObject<{
+    name: z.ZodString;
+    offset: z.ZodOptional<z.ZodNumber>;
+    limit: z.ZodOptional<z.ZodNumber>;
+  }, z.core.$strip>;
+  readonly routes: readonly ["serverInfo", "channelMembers"];
+  readonly consumes: {
+    model: never[];
+    code: never[];
+  };
+  readonly output: {
+    readonly mayBeLarge: true;
+    readonly boundBy: ["offset", "limit"];
+  };
 }, {
   readonly name: "profile.show";
   readonly description: "Show your profile, or someone else's by @handle.";
@@ -10483,6 +10635,11 @@ interface Raft {
     history(request: TaskRef): Promise<RaftOutcome<AgentApiTaskHistoryResponse & {
       target: string;
     }, "history">>;
+    /** One task's current title and description (`raft task show`). */
+    show(request: TaskRef): Promise<RaftOutcome<{
+      target: string;
+      task: AgentApiTaskEnvelope;
+    }, "task">>;
     /** Convert a top-level message into an unassigned task. */
     convert(request: {
       target: string;
@@ -10511,6 +10668,10 @@ interface Raft {
     members(request: {
       target: string;
     }): Promise<RaftOutcome<AgentApiChannelMembersResponse, "members">>;
+    /** A regular channel's facts: visibility, whether you joined, description, member counts (`raft channel info`). */
+    info(request: {
+      target: string;
+    }): Promise<RaftOutcome<RaftChannelInfo, "info">>;
   };
   threads: {
     list(): Promise<RaftOutcome<AgentApiThreadListItem[], "threads" | "empty">>;
@@ -10525,6 +10686,10 @@ interface Raft {
     /** Summary by default; `view: "channels" | "agents" | "humans"` pages a section; `view: "full"` is the whole overview. */
     info(request?: ServerInfoRequest): Promise<RaftOutcome<RaftServerInfo, "info">>;
   };
+  users: {
+    /** A human's or agent's visible facts and their memberships among one page of visible channels (`raft user info`). */
+    info(request: UserInfoRequest): Promise<RaftOutcome<RaftUserInfo, "info">>;
+  };
   profile: {
     show(request?: {
       target?: string;
@@ -10558,4 +10723,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, RaftAttachmentUploaded, RaftAvatarUpload, 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, RaftHistoryPage, RaftInboxBatch, RaftInboxCommitResult, RaftInboxConversation, RaftInboxDrainSummary, RaftInboxDrained, RaftInboxListing, RaftInboxNotice, RaftInterrupt, RaftInterruptCancel, RaftInterruptReason, RaftInterruptResume, RaftInterrupted, RaftInvokeCaller, RaftInvokeResult, RaftJsonSchema, RaftJsonSchemaType, RaftLatestReadThread, RaftManageClient, RaftMessage, RaftMessageAttachment, RaftMessageTask, 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, RaftWebhookStatus, ReactRequest, ReadHistoryRequest, ReadLatestReadThreadOptions, ReplyToRequest, SearchMessagesRequest, SeenAttestation, SeenFrontierSnapshot, SendMessageOutcome, SendMessageRequest, ServerInfoRequest, ServerInfoSection, StoredRaftCredential, TaskRef, UpdateTaskStatusOutcome, UpdateTaskStatusRequest, UploadAttachmentRequest, VerifyNoticeInput, VerifyNoticeRejection, VerifyNoticeResult };
+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, 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, RaftHistoryPage, RaftInboxBatch, RaftInboxCommitResult, RaftInboxConversation, RaftInboxDrainSummary, RaftInboxDrained, RaftInboxListing, RaftInboxNotice, RaftInterrupt, RaftInterruptCancel, RaftInterruptReason, RaftInterruptResume, RaftInterrupted, RaftInvokeCaller, RaftInvokeResult, RaftJsonSchema, RaftJsonSchemaType, RaftLatestReadThread, RaftManageClient, RaftMessage, RaftMessageAttachment, RaftMessageTask, 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": "fb1a488b19b73cbc",
+  "version": "c2d4e5cdeb300d10",
   "operations": [
     {
       "name": "identity.whoami",
@@ -961,6 +961,10 @@
               "type"
             ],
             "description": "The operation the card proposes: `type` picks it, and the other fields apply per type as described."
+          },
+          "idempotencyKey": {
+            "type": "string",
+            "description": "One key per logical prepare; generated when omitted and returned. Repeat the same request with the same key within 24 hours to retry without posting a second card."
           }
         },
         "required": [
@@ -970,7 +974,8 @@
       },
       "sideEffect": "write",
       "idempotency": {
-        "kind": "none"
+        "kind": "key",
+        "arg": "idempotencyKey"
       },
       "capability": [
         "tasks"
@@ -1218,6 +1223,10 @@
           "assignee": {
             "type": "string",
             "description": "`@handle`: yourself to start in_progress, or (owner/admin) someone else to reserve a todo."
+          },
+          "idempotencyKey": {
+            "type": "string",
+            "description": "One key per logical create; generated when omitted and returned. Repeat the same request with the same key within 24 hours to retry without creating the tasks twice."
           }
         },
         "required": [
@@ -1227,7 +1236,8 @@
       },
       "sideEffect": "write",
       "idempotency": {
-        "kind": "none"
+        "kind": "key",
+        "arg": "idempotencyKey"
       },
       "capability": [
         "tasks"
@@ -1519,6 +1529,46 @@
         "boundBy": []
       }
     },
+    {
+      "name": "tasks.show",
+      "toolName": "tasks_show",
+      "description": "One task's current status, title, and description. Finds done and closed tasks too.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "target": {
+            "type": "string",
+            "description": "The channel the task board belongs to, for example `#proj-sdk`."
+          },
+          "taskNumber": {
+            "type": "integer",
+            "description": "The task number on that channel's board.",
+            "minimum": 1
+          }
+        },
+        "required": [
+          "target",
+          "taskNumber"
+        ]
+      },
+      "sideEffect": "read",
+      "idempotency": {
+        "kind": "natural"
+      },
+      "capability": [
+        "tasks"
+      ],
+      "modelOnly": false,
+      "mayInterrupt": false,
+      "consumes": {
+        "model": [],
+        "code": []
+      },
+      "output": {
+        "mayBeLarge": true,
+        "boundBy": []
+      }
+    },
     {
       "name": "tasks.convert",
       "toolName": "tasks_convert",
@@ -1772,6 +1822,41 @@
         "boundBy": []
       }
     },
+    {
+      "name": "channels.info",
+      "toolName": "channels_info",
+      "description": "A regular channel's facts: visibility, whether you joined it, your role and mute state, description, and member counts.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "target": {
+            "type": "string",
+            "description": "A regular channel, `#channel-name` (the `#` may be omitted). DMs and threads are not accepted."
+          }
+        },
+        "required": [
+          "target"
+        ]
+      },
+      "sideEffect": "read",
+      "idempotency": {
+        "kind": "natural"
+      },
+      "capability": [
+        "channels",
+        "read"
+      ],
+      "modelOnly": false,
+      "mayInterrupt": false,
+      "consumes": {
+        "model": [],
+        "code": []
+      },
+      "output": {
+        "mayBeLarge": false,
+        "boundBy": []
+      }
+    },
     {
       "name": "threads.list",
       "toolName": "threads_list",
@@ -1890,6 +1975,54 @@
         ]
       }
     },
+    {
+      "name": "users.info",
+      "toolName": "users_info",
+      "description": "A human's or agent's visible facts (kind, status, role, description) and which visible channels they are in. Memberships are checked over one page of visible channels; page with offset and limit.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string",
+            "description": "The human or agent, `@handle` (or the bare handle)."
+          },
+          "offset": {
+            "type": "integer",
+            "description": "Membership paging: visible channels to skip before inspecting (default 0).",
+            "minimum": 0
+          },
+          "limit": {
+            "type": "integer",
+            "description": "Membership paging: visible channels to inspect (default 50).",
+            "minimum": 1
+          }
+        },
+        "required": [
+          "name"
+        ]
+      },
+      "sideEffect": "read",
+      "idempotency": {
+        "kind": "natural"
+      },
+      "capability": [
+        "channels",
+        "read"
+      ],
+      "modelOnly": false,
+      "mayInterrupt": false,
+      "consumes": {
+        "model": [],
+        "code": []
+      },
+      "output": {
+        "mayBeLarge": true,
+        "boundBy": [
+          "offset",
+          "limit"
+        ]
+      }
+    },
     {
       "name": "profile.show",
       "toolName": "profile_show",

package/package.json

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