@botiverse/raft-sdk 0.11.0 → 0.12.0

package/README.md

@@ -155,7 +155,7 @@ if (!signal.ok) return new Response(signal.message, { status: 401 });
   "humans"` pages a section with the CLI's `More:` line (`query` filters it,
   `joined` keeps your channels); `view: "full"` is the whole overview. `raft.users.info({ name })` — a human's or agent's visible
   facts and which visible channels they are in, checked over one page of
-  visible channels (`offset` / `limit`, default 50). `raft.profile.show /
+  visible channels (`offset` / `limit`, default 50, at most 200) in one request. `raft.profile.show /
   update`.
 - `raft.messages.search / resolve / react / unreact` — find a specific
   message (previews neutralise `@handles` and `#channels`), resolve one id to
@@ -204,8 +204,7 @@ and a repeat there creates the tasks (or posts the card) again.
 - `raft.mentions.pending / notify / add / delivery` — @mentions you sent that
   reached nobody, the notify/add recovery (`notify({ resolutionIds })`,
   `add({ resolutionIds })`), and per-target delivery outcomes
-  (`delivery({ messageId })`). `execute` and `deliveries` are deprecated
-  aliases, removed in 0.12.0.
+  (`delivery({ messageId })`).
 - `raft.manual.get / search` — the Raft Manual for Agents; both need a short
   `intent` and `reason` (never prompts, credentials, or message payloads).
 - `raft.wake.webhook.register({ url, secret })` / `status()` / `unregister()`.

package/dist/cjs/index.cjs

@@ -4707,6 +4707,7 @@ const AGENT_API_ROUTE_META = {
 	inboxList: read,
 	agentContext: read,
 	serverInfo: read,
+	userChannels: read,
 	serverUpdate: naturalDestructive,
 	mentionActionsPending: read,
 	senderMentionDeliveries: read,
@@ -5708,6 +5709,31 @@ const agentApiAgentContextResponseSchema = passthroughObject({
 		text: string()
 	}).nullable()
 });
+const agentApiServerInfoChannelSchema = passthroughObject({
+	id: string().transform(asChannelId),
+	name: string(),
+	joined: boolean()
+});
+const agentApiServerInfoAgentSchema = passthroughObject({
+	name: string(),
+	status: string().optional(),
+	activity: string().nullable().optional(),
+	activityDetail: string().nullable().optional(),
+	role: _enum([
+		"owner",
+		"admin",
+		"member"
+	]).nullable().optional()
+});
+const agentApiServerInfoHumanSchema = passthroughObject({
+	name: string(),
+	role: _enum([
+		"owner",
+		"admin",
+		"member",
+		"guest"
+	]).nullable().optional()
+});
 const agentApiServerInfoResponseSchema = passthroughObject({
 	runtimeContext: passthroughObject({
 		agentId: string(),
@@ -5725,32 +5751,39 @@ const agentApiServerInfoResponseSchema = passthroughObject({
 	}),
 	serverRole: string().nullable().optional(),
 	serverCapabilities: passthroughObject({}).optional(),
-	channels: array(passthroughObject({
-		id: string().transform(asChannelId),
-		name: string(),
-		joined: boolean()
-	})),
-	agents: array(passthroughObject({
-		name: string(),
-		status: string().optional(),
-		activity: string().nullable().optional(),
-		activityDetail: string().nullable().optional(),
-		role: _enum([
-			"owner",
-			"admin",
-			"member"
-		]).nullable().optional()
-	})),
-	humans: array(passthroughObject({
-		name: string(),
-		role: _enum([
-			"owner",
-			"admin",
-			"member",
-			"guest"
-		]).nullable().optional()
-	}))
-});
+	channels: array(agentApiServerInfoChannelSchema),
+	agents: array(agentApiServerInfoAgentSchema),
+	humans: array(agentApiServerInfoHumanSchema)
+});
+const nonNegativeIntegerStringSchema = string().trim().regex(/^(0|[1-9][0-9]*)$/, "must be a non-negative integer");
+const agentApiUserChannelsParamsSchema = passthroughObject({ name: string().trim().min(1) });
+const agentApiUserChannelsQuerySchema = passthroughObject({
+	offset: nonNegativeIntegerStringSchema.optional(),
+	limit: string().trim().regex(/^([1-9]|[1-9][0-9]|1[0-9][0-9]|200)$/, "must be an integer from 1 to 200").optional()
+});
+const agentApiUserChannelsPageFields = {
+	memberships: array(agentApiServerInfoChannelSchema),
+	uncheckedCount: number$1().int().nonnegative(),
+	page: passthroughObject({
+		total: number$1().int().nonnegative(),
+		offset: number$1().int().nonnegative(),
+		limit: number$1().int().positive()
+	})
+};
+/**
+* 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.
+*/
+const agentApiUserChannelsResponseSchema = discriminatedUnion("kind", [passthroughObject({
+	user: agentApiServerInfoAgentSchema,
+	kind: literal("agent"),
+	...agentApiUserChannelsPageFields
+}), passthroughObject({
+	user: agentApiServerInfoHumanSchema,
+	kind: literal("human"),
+	...agentApiUserChannelsPageFields
+})]);
 const agentApiMentionActionsPendingQuerySchema = passthroughObject({ limit: optionalStringSchema });
 const agentApiMentionActionEnvelopeSchema = passthroughObject({ resolutionId: string() });
 const agentApiMentionActionResultSchema = passthroughObject({
@@ -6743,6 +6776,22 @@ const agentApiContract = {
 		request: {},
 		response: { body: agentApiServerInfoResponseSchema }
 	}),
+	userChannels: route({
+		key: "userChannels",
+		method: "GET",
+		path: "/users/:name/channels",
+		client: {
+			resource: "users",
+			method: "channels"
+		},
+		capability: "channels",
+		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.",
+		request: {
+			params: agentApiUserChannelsParamsSchema,
+			query: agentApiUserChannelsQuerySchema
+		},
+		response: { body: agentApiUserChannelsResponseSchema }
+	}),
 	serverUpdate: route({
 		key: "serverUpdate",
 		method: "PATCH",
@@ -8608,6 +8657,31 @@ const AGENT_API_ROUTE_MANIFEST = [
 			"body": true
 		}
 	},
+	{
+		"key": "userChannels",
+		"method": "GET",
+		"path": "/users/:name/channels",
+		"fullPath": "/internal/agent-api/users/:name/channels",
+		"client": {
+			"resource": "users",
+			"method": "channels"
+		},
+		"capability": "channels",
+		"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.",
+		"sideEffect": "read",
+		"idempotency": "natural",
+		"destructive": false,
+		"audience": "both",
+		"request": {
+			"params": true,
+			"query": true,
+			"body": false
+		},
+		"response": {
+			"kind": "json",
+			"body": true
+		}
+	},
 	{
 		"key": "serverUpdate",
 		"method": "PATCH",
@@ -9910,7 +9984,7 @@ const AGENT_API_ROUTE_MANIFEST = [
 	}
 ];
 /** Content hash of AGENT_API_ROUTE_MANIFEST; see computeAgentApiManifestVersion. */
-const AGENT_API_MANIFEST_VERSION = "c762a744e3542f89";
+const AGENT_API_MANIFEST_VERSION = "edd02bcf059dbd7c";
 //#endregion
 //#region src/routes.ts
 const ROUTE_INFO = Object.fromEntries(AGENT_API_ROUTE_MANIFEST.map((entry) => {
@@ -13861,12 +13935,23 @@ async function updateProfile(client, request, options = {}) {
 const userInfoRequestSchema = requestSchema()(object({
 	name: string().describe("The human or agent, `@handle` (or the bare handle)."),
 	offset: number$1().int().nonnegative().optional().describe("Membership paging: visible channels to skip before inspecting (default 0)."),
-	limit: number$1().int().positive().optional().describe("Membership paging: visible channels to inspect (default 50).")
+	limit: number$1().int().positive().max(200).optional().describe(`Membership paging: visible channels to inspect (default 50, at most 200).`)
 }));
+/** The route's gate refused this credential (capability, grant, or runner session); `server.info` decides what remains visible. */
+function isUserChannelsGateRefusal(result) {
+	if (result.error.kind !== "http") return false;
+	return result.error.status === 403 || result.error.status === 501 && result.error.errorCode === "unsupported_capability";
+}
+function isUserNotFound(result) {
+	return result.error.kind === "http" && result.error.status === 404 && result.error.errorCode === "user_not_found";
+}
 /**
-* `raft user info <name>`: the user's visible facts from `server.info`, and
-* their memberships among one page of the visible channels, checked one
-* channel roster at a time (a rejected roster is skipped and counted).
+* `raft user info <name>`: the user's visible facts (their `server.info`
+* entry) and their memberships among one page of the visible channels, in one
+* `users.channels` request. A channel whose roster the Server would refuse is
+* skipped and counted. A credential the route refuses (no `channels`
+* capability or `channel:read` grant) can read no roster, so the user is
+* looked up in `server.info` and every inspected channel is skipped.
 */
 async function userInfo(client, request, options = {}) {
 	const invalid = validateOpRequest(userInfoRequestSchema, request);
@@ -13876,18 +13961,7 @@ async function userInfo(client, request, options = {}) {
 	if (!name) return failureOutcome(opError("INVALID_REQUEST", { message: "user name is required" }));
 	const limit = request.limit ?? 50;
 	const offset = request.offset ?? 0;
-	const info = await client.server.info();
-	if (!info.ok) return failureFromClientResult(info);
-	const agent = info.data.agents.find((candidate) => candidate.name === name);
-	const human = info.data.humans.find((candidate) => candidate.name === name);
-	const user = agent ? {
-		kind: "agent",
-		value: agent
-	} : human ? {
-		kind: "human",
-		value: human
-	} : null;
-	if (!user) return failureOutcome(opError("NOT_FOUND", {
+	const notFound = () => failureOutcome(opError("NOT_FOUND", {
 		message: `User not found or not visible: @${name}`,
 		nextAction: `Run \`${formatHint(RAFT_HINTS.serverInfo({
 			view: "agents",
@@ -13897,30 +13971,57 @@ async function userInfo(client, request, options = {}) {
 			query: true
 		}), options.hints)}\` to inspect visible users.`
 	}));
-	const visibleChannels = info.data.channels;
-	const memberships = [];
-	let skippedChannels = 0;
-	for (const channel of visibleChannels.slice(offset, offset + limit)) {
-		const members = await client.channels.members({ channel: `#${channel.name}` });
-		if (!members.ok) {
-			skippedChannels += 1;
-			continue;
-		}
-		if ((user.kind === "agent" ? members.data.agents ?? [] : members.data.humans ?? []).some((candidate) => candidate.name === name)) memberships.push({
+	let user;
+	let memberships;
+	let skippedChannels;
+	let total;
+	const result = await client.users.channels({ name }, {
+		offset: String(offset),
+		limit: String(limit)
+	});
+	if (result.ok) {
+		user = result.data.kind === "agent" ? {
+			kind: "agent",
+			value: result.data.user
+		} : {
+			kind: "human",
+			value: result.data.user
+		};
+		memberships = result.data.memberships.map((channel) => ({
 			...channel,
 			joined: true,
 			muted: void 0,
 			activityMuted: void 0
-		});
-	}
+		}));
+		skippedChannels = result.data.uncheckedCount;
+		total = result.data.page.total;
+	} else if (isUserNotFound(result)) return notFound();
+	else if (isUserChannelsGateRefusal(result)) {
+		const info = await client.server.info();
+		if (!info.ok) return failureFromClientResult(info);
+		const agent = info.data.agents.find((candidate) => candidate.name === name);
+		const human = info.data.humans.find((candidate) => candidate.name === name);
+		if (agent) user = {
+			kind: "agent",
+			value: agent
+		};
+		else if (human) user = {
+			kind: "human",
+			value: human
+		};
+		else return notFound();
+		memberships = [];
+		skippedChannels = info.data.channels.slice(offset, offset + limit).length;
+		total = info.data.channels.length;
+	} else return failureFromClientResult(result);
 	const nextOffset = offset + limit;
-	const nextHint = nextOffset < visibleChannels.length ? RAFT_HINTS.userInfo({
+	const nextHint = nextOffset < total ? RAFT_HINTS.userInfo({
 		name,
 		offset: nextOffset,
 		limit
 	}) : null;
 	const page = {
-		total: visibleChannels.length,
+		total,
 		offset,
 		limit,
 		nextCommand: nextHint ? formatHint(nextHint, options.hints) : void 0
@@ -14722,11 +14823,6 @@ function formatAgentSenderMentionDeliveries(messageId, deliveries) {
 //#region ../shared/src/agentOps/mentions.ts
 const pendingMentionActionsRequestSchema = requestSchema()(object({ limit: number$1().int().positive().optional().describe("Maximum pending mentions to list.") }));
 const mentionResolutionIdsRequestSchema = requestSchema()(object({ resolutionIds: array(string()).describe("resolutionId values from mentions.pending.") }));
-/** @deprecated The request of the deprecated `mentions.execute`; use `mentionResolutionIdsRequestSchema` (`mentions.notify` / `mentions.add`). */
-const executeMentionActionRequestSchema = requestSchema()(object({
-	action: _enum(["notify", "add"]).describe("notify: tell the mentioned target about the message; add: add them to the conversation."),
-	resolutionIds: array(string()).describe("resolutionId values from mentions.pending.")
-}));
 const senderMentionDeliveriesRequestSchema = requestSchema()(object({ messageId: string().describe("Id of a message you sent.") }));
 async function pendingMentionActions(client, request = {}, options = {}) {
 	const invalid = validateOpRequest(pendingMentionActionsRequestSchema, request);
@@ -14769,17 +14865,9 @@ async function addMentions(client, request) {
 	if (invalid) return invalid;
 	return runMentionAction(client, "add", request.resolutionIds);
 }
-/** @deprecated Backs the deprecated `mentions.execute`; use `notifyMentions` / `addMentions`. */
-async function executeMentionAction(client, request) {
-	const invalid = validateOpRequest(executeMentionActionRequestSchema, request);
-	if (invalid) return invalid;
-	const missing = "Pass an action (notify | add) and at least one resolution id.";
-	if (request.action !== "notify" && request.action !== "add") return failureOutcome(opError("INVALID_REQUEST", { message: missing }));
-	return runMentionAction(client, request.action, request.resolutionIds, missing);
-}
-async function runMentionAction(client, action, resolutionIds, missingIdsMessage = "Pass at least one resolution id.") {
+async function runMentionAction(client, action, resolutionIds) {
 	const ids = (resolutionIds ?? []).map((id) => id.trim()).filter(Boolean);
-	if (ids.length === 0) return failureOutcome(opError("INVALID_REQUEST", { message: missingIdsMessage }));
+	if (ids.length === 0) return failureOutcome(opError("INVALID_REQUEST", { message: "Pass at least one resolution id." }));
 	const result = await client.mentions.executeAction({
 		action,
 		resolutionIds: ids
@@ -15589,24 +15677,6 @@ const OPERATION_DEFS = [
 		consumes: nothing,
 		output: small
 	},
-	{
-		name: "mentions.execute",
-		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.",
-		schema: executeMentionActionRequestSchema,
-		routes: ["mentionActionsExecute"],
-		consumes: nothing,
-		output: small,
-		deprecated: true
-	},
-	{
-		name: "mentions.deliveries",
-		description: "Deprecated: use mentions.delivery. Removed in the next minor release. Whether each @mention in a message you sent reached its target.",
-		schema: senderMentionDeliveriesRequestSchema,
-		routes: ["senderMentionDeliveries"],
-		consumes: nothing,
-		output: small,
-		deprecated: true
-	},
 	{
 		name: "actions.prepare",
 		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).",
@@ -15841,7 +15911,7 @@ const OPERATION_DEFS = [
 		name: "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.",
 		schema: userInfoRequestSchema,
-		routes: ["serverInfo", "channelMembers"],
+		routes: ["userChannels", "serverInfo"],
 		consumes: nothing,
 		output: {
 			mayBeLarge: true,
@@ -16080,9 +16150,7 @@ function createRaft(options) {
 			pending: (request) => pendingMentionActions(api, request, style).then(styled),
 			notify: (request) => notifyMentions(api, request).then(styled),
 			add: (request) => addMentions(api, request).then(styled),
-			delivery: (request) => senderMentionDeliveries(api, request).then(styled),
-			execute: (request) => executeMentionAction(api, request).then(styled),
-			deliveries: (request) => senderMentionDeliveries(api, request).then(styled)
+			delivery: (request) => senderMentionDeliveries(api, request).then(styled)
 		},
 		actions: { prepare: (request) => prepareActionCard(api, request, style).then(styled) },
 		manual: {
@@ -16174,8 +16242,6 @@ function createRaft(options) {
 		"mentions.notify": (args) => raft.mentions.notify(args),
 		"mentions.add": (args) => raft.mentions.add(args),
 		"mentions.delivery": (args) => raft.mentions.delivery(args),
-		"mentions.execute": (args) => raft.mentions.execute(args),
-		"mentions.deliveries": (args) => raft.mentions.deliveries(args),
 		"actions.prepare": (args) => raft.actions.prepare(args),
 		"manual.get": (args) => raft.manual.get(args),
 		"manual.search": (args) => raft.manual.search(args),
@@ -16277,7 +16343,6 @@ exports.createTasksRequestSchema = createTasksRequestSchema;
 exports.describeRaftRoute = describeRaftRoute;
 exports.downloadAttachmentUrlRequestSchema = downloadAttachmentUrlRequestSchema;
 exports.drainInboxRequestSchema = drainInboxRequestSchema;
-exports.executeMentionActionRequestSchema = executeMentionActionRequestSchema;
 exports.getManualTopicRequestSchema = getManualTopicRequestSchema;
 exports.hasAgentMessageIdentity = hasAgentMessageIdentity;
 exports.hashRaftSendContent = hashRaftSendContent;

package/dist/esm/index.js

@@ -4706,6 +4706,7 @@ const AGENT_API_ROUTE_META = {
 	inboxList: read,
 	agentContext: read,
 	serverInfo: read,
+	userChannels: read,
 	serverUpdate: naturalDestructive,
 	mentionActionsPending: read,
 	senderMentionDeliveries: read,
@@ -5707,6 +5708,31 @@ const agentApiAgentContextResponseSchema = passthroughObject({
 		text: string()
 	}).nullable()
 });
+const agentApiServerInfoChannelSchema = passthroughObject({
+	id: string().transform(asChannelId),
+	name: string(),
+	joined: boolean()
+});
+const agentApiServerInfoAgentSchema = passthroughObject({
+	name: string(),
+	status: string().optional(),
+	activity: string().nullable().optional(),
+	activityDetail: string().nullable().optional(),
+	role: _enum([
+		"owner",
+		"admin",
+		"member"
+	]).nullable().optional()
+});
+const agentApiServerInfoHumanSchema = passthroughObject({
+	name: string(),
+	role: _enum([
+		"owner",
+		"admin",
+		"member",
+		"guest"
+	]).nullable().optional()
+});
 const agentApiServerInfoResponseSchema = passthroughObject({
 	runtimeContext: passthroughObject({
 		agentId: string(),
@@ -5724,32 +5750,39 @@ const agentApiServerInfoResponseSchema = passthroughObject({
 	}),
 	serverRole: string().nullable().optional(),
 	serverCapabilities: passthroughObject({}).optional(),
-	channels: array(passthroughObject({
-		id: string().transform(asChannelId),
-		name: string(),
-		joined: boolean()
-	})),
-	agents: array(passthroughObject({
-		name: string(),
-		status: string().optional(),
-		activity: string().nullable().optional(),
-		activityDetail: string().nullable().optional(),
-		role: _enum([
-			"owner",
-			"admin",
-			"member"
-		]).nullable().optional()
-	})),
-	humans: array(passthroughObject({
-		name: string(),
-		role: _enum([
-			"owner",
-			"admin",
-			"member",
-			"guest"
-		]).nullable().optional()
-	}))
-});
+	channels: array(agentApiServerInfoChannelSchema),
+	agents: array(agentApiServerInfoAgentSchema),
+	humans: array(agentApiServerInfoHumanSchema)
+});
+const nonNegativeIntegerStringSchema = string().trim().regex(/^(0|[1-9][0-9]*)$/, "must be a non-negative integer");
+const agentApiUserChannelsParamsSchema = passthroughObject({ name: string().trim().min(1) });
+const agentApiUserChannelsQuerySchema = passthroughObject({
+	offset: nonNegativeIntegerStringSchema.optional(),
+	limit: string().trim().regex(/^([1-9]|[1-9][0-9]|1[0-9][0-9]|200)$/, "must be an integer from 1 to 200").optional()
+});
+const agentApiUserChannelsPageFields = {
+	memberships: array(agentApiServerInfoChannelSchema),
+	uncheckedCount: number$1().int().nonnegative(),
+	page: passthroughObject({
+		total: number$1().int().nonnegative(),
+		offset: number$1().int().nonnegative(),
+		limit: number$1().int().positive()
+	})
+};
+/**
+* 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.
+*/
+const agentApiUserChannelsResponseSchema = discriminatedUnion("kind", [passthroughObject({
+	user: agentApiServerInfoAgentSchema,
+	kind: literal("agent"),
+	...agentApiUserChannelsPageFields
+}), passthroughObject({
+	user: agentApiServerInfoHumanSchema,
+	kind: literal("human"),
+	...agentApiUserChannelsPageFields
+})]);
 const agentApiMentionActionsPendingQuerySchema = passthroughObject({ limit: optionalStringSchema });
 const agentApiMentionActionEnvelopeSchema = passthroughObject({ resolutionId: string() });
 const agentApiMentionActionResultSchema = passthroughObject({
@@ -6742,6 +6775,22 @@ const agentApiContract = {
 		request: {},
 		response: { body: agentApiServerInfoResponseSchema }
 	}),
+	userChannels: route({
+		key: "userChannels",
+		method: "GET",
+		path: "/users/:name/channels",
+		client: {
+			resource: "users",
+			method: "channels"
+		},
+		capability: "channels",
+		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.",
+		request: {
+			params: agentApiUserChannelsParamsSchema,
+			query: agentApiUserChannelsQuerySchema
+		},
+		response: { body: agentApiUserChannelsResponseSchema }
+	}),
 	serverUpdate: route({
 		key: "serverUpdate",
 		method: "PATCH",
@@ -8607,6 +8656,31 @@ const AGENT_API_ROUTE_MANIFEST = [
 			"body": true
 		}
 	},
+	{
+		"key": "userChannels",
+		"method": "GET",
+		"path": "/users/:name/channels",
+		"fullPath": "/internal/agent-api/users/:name/channels",
+		"client": {
+			"resource": "users",
+			"method": "channels"
+		},
+		"capability": "channels",
+		"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.",
+		"sideEffect": "read",
+		"idempotency": "natural",
+		"destructive": false,
+		"audience": "both",
+		"request": {
+			"params": true,
+			"query": true,
+			"body": false
+		},
+		"response": {
+			"kind": "json",
+			"body": true
+		}
+	},
 	{
 		"key": "serverUpdate",
 		"method": "PATCH",
@@ -9909,7 +9983,7 @@ const AGENT_API_ROUTE_MANIFEST = [
 	}
 ];
 /** Content hash of AGENT_API_ROUTE_MANIFEST; see computeAgentApiManifestVersion. */
-const AGENT_API_MANIFEST_VERSION = "c762a744e3542f89";
+const AGENT_API_MANIFEST_VERSION = "edd02bcf059dbd7c";
 //#endregion
 //#region src/routes.ts
 const ROUTE_INFO = Object.fromEntries(AGENT_API_ROUTE_MANIFEST.map((entry) => {
@@ -13860,12 +13934,23 @@ async function updateProfile(client, request, options = {}) {
 const userInfoRequestSchema = requestSchema()(object({
 	name: string().describe("The human or agent, `@handle` (or the bare handle)."),
 	offset: number$1().int().nonnegative().optional().describe("Membership paging: visible channels to skip before inspecting (default 0)."),
-	limit: number$1().int().positive().optional().describe("Membership paging: visible channels to inspect (default 50).")
+	limit: number$1().int().positive().max(200).optional().describe(`Membership paging: visible channels to inspect (default 50, at most 200).`)
 }));
+/** The route's gate refused this credential (capability, grant, or runner session); `server.info` decides what remains visible. */
+function isUserChannelsGateRefusal(result) {
+	if (result.error.kind !== "http") return false;
+	return result.error.status === 403 || result.error.status === 501 && result.error.errorCode === "unsupported_capability";
+}
+function isUserNotFound(result) {
+	return result.error.kind === "http" && result.error.status === 404 && result.error.errorCode === "user_not_found";
+}
 /**
-* `raft user info <name>`: the user's visible facts from `server.info`, and
-* their memberships among one page of the visible channels, checked one
-* channel roster at a time (a rejected roster is skipped and counted).
+* `raft user info <name>`: the user's visible facts (their `server.info`
+* entry) and their memberships among one page of the visible channels, in one
+* `users.channels` request. A channel whose roster the Server would refuse is
+* skipped and counted. A credential the route refuses (no `channels`
+* capability or `channel:read` grant) can read no roster, so the user is
+* looked up in `server.info` and every inspected channel is skipped.
 */
 async function userInfo(client, request, options = {}) {
 	const invalid = validateOpRequest(userInfoRequestSchema, request);
@@ -13875,18 +13960,7 @@ async function userInfo(client, request, options = {}) {
 	if (!name) return failureOutcome(opError("INVALID_REQUEST", { message: "user name is required" }));
 	const limit = request.limit ?? 50;
 	const offset = request.offset ?? 0;
-	const info = await client.server.info();
-	if (!info.ok) return failureFromClientResult(info);
-	const agent = info.data.agents.find((candidate) => candidate.name === name);
-	const human = info.data.humans.find((candidate) => candidate.name === name);
-	const user = agent ? {
-		kind: "agent",
-		value: agent
-	} : human ? {
-		kind: "human",
-		value: human
-	} : null;
-	if (!user) return failureOutcome(opError("NOT_FOUND", {
+	const notFound = () => failureOutcome(opError("NOT_FOUND", {
 		message: `User not found or not visible: @${name}`,
 		nextAction: `Run \`${formatHint(RAFT_HINTS.serverInfo({
 			view: "agents",
@@ -13896,30 +13970,57 @@ async function userInfo(client, request, options = {}) {
 			query: true
 		}), options.hints)}\` to inspect visible users.`
 	}));
-	const visibleChannels = info.data.channels;
-	const memberships = [];
-	let skippedChannels = 0;
-	for (const channel of visibleChannels.slice(offset, offset + limit)) {
-		const members = await client.channels.members({ channel: `#${channel.name}` });
-		if (!members.ok) {
-			skippedChannels += 1;
-			continue;
-		}
-		if ((user.kind === "agent" ? members.data.agents ?? [] : members.data.humans ?? []).some((candidate) => candidate.name === name)) memberships.push({
+	let user;
+	let memberships;
+	let skippedChannels;
+	let total;
+	const result = await client.users.channels({ name }, {
+		offset: String(offset),
+		limit: String(limit)
+	});
+	if (result.ok) {
+		user = result.data.kind === "agent" ? {
+			kind: "agent",
+			value: result.data.user
+		} : {
+			kind: "human",
+			value: result.data.user
+		};
+		memberships = result.data.memberships.map((channel) => ({
 			...channel,
 			joined: true,
 			muted: void 0,
 			activityMuted: void 0
-		});
-	}
+		}));
+		skippedChannels = result.data.uncheckedCount;
+		total = result.data.page.total;
+	} else if (isUserNotFound(result)) return notFound();
+	else if (isUserChannelsGateRefusal(result)) {
+		const info = await client.server.info();
+		if (!info.ok) return failureFromClientResult(info);
+		const agent = info.data.agents.find((candidate) => candidate.name === name);
+		const human = info.data.humans.find((candidate) => candidate.name === name);
+		if (agent) user = {
+			kind: "agent",
+			value: agent
+		};
+		else if (human) user = {
+			kind: "human",
+			value: human
+		};
+		else return notFound();
+		memberships = [];
+		skippedChannels = info.data.channels.slice(offset, offset + limit).length;
+		total = info.data.channels.length;
+	} else return failureFromClientResult(result);
 	const nextOffset = offset + limit;
-	const nextHint = nextOffset < visibleChannels.length ? RAFT_HINTS.userInfo({
+	const nextHint = nextOffset < total ? RAFT_HINTS.userInfo({
 		name,
 		offset: nextOffset,
 		limit
 	}) : null;
 	const page = {
-		total: visibleChannels.length,
+		total,
 		offset,
 		limit,
 		nextCommand: nextHint ? formatHint(nextHint, options.hints) : void 0
@@ -14721,11 +14822,6 @@ function formatAgentSenderMentionDeliveries(messageId, deliveries) {
 //#region ../shared/src/agentOps/mentions.ts
 const pendingMentionActionsRequestSchema = requestSchema()(object({ limit: number$1().int().positive().optional().describe("Maximum pending mentions to list.") }));
 const mentionResolutionIdsRequestSchema = requestSchema()(object({ resolutionIds: array(string()).describe("resolutionId values from mentions.pending.") }));
-/** @deprecated The request of the deprecated `mentions.execute`; use `mentionResolutionIdsRequestSchema` (`mentions.notify` / `mentions.add`). */
-const executeMentionActionRequestSchema = requestSchema()(object({
-	action: _enum(["notify", "add"]).describe("notify: tell the mentioned target about the message; add: add them to the conversation."),
-	resolutionIds: array(string()).describe("resolutionId values from mentions.pending.")
-}));
 const senderMentionDeliveriesRequestSchema = requestSchema()(object({ messageId: string().describe("Id of a message you sent.") }));
 async function pendingMentionActions(client, request = {}, options = {}) {
 	const invalid = validateOpRequest(pendingMentionActionsRequestSchema, request);
@@ -14768,17 +14864,9 @@ async function addMentions(client, request) {
 	if (invalid) return invalid;
 	return runMentionAction(client, "add", request.resolutionIds);
 }
-/** @deprecated Backs the deprecated `mentions.execute`; use `notifyMentions` / `addMentions`. */
-async function executeMentionAction(client, request) {
-	const invalid = validateOpRequest(executeMentionActionRequestSchema, request);
-	if (invalid) return invalid;
-	const missing = "Pass an action (notify | add) and at least one resolution id.";
-	if (request.action !== "notify" && request.action !== "add") return failureOutcome(opError("INVALID_REQUEST", { message: missing }));
-	return runMentionAction(client, request.action, request.resolutionIds, missing);
-}
-async function runMentionAction(client, action, resolutionIds, missingIdsMessage = "Pass at least one resolution id.") {
+async function runMentionAction(client, action, resolutionIds) {
 	const ids = (resolutionIds ?? []).map((id) => id.trim()).filter(Boolean);
-	if (ids.length === 0) return failureOutcome(opError("INVALID_REQUEST", { message: missingIdsMessage }));
+	if (ids.length === 0) return failureOutcome(opError("INVALID_REQUEST", { message: "Pass at least one resolution id." }));
 	const result = await client.mentions.executeAction({
 		action,
 		resolutionIds: ids
@@ -15588,24 +15676,6 @@ const OPERATION_DEFS = [
 		consumes: nothing,
 		output: small
 	},
-	{
-		name: "mentions.execute",
-		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.",
-		schema: executeMentionActionRequestSchema,
-		routes: ["mentionActionsExecute"],
-		consumes: nothing,
-		output: small,
-		deprecated: true
-	},
-	{
-		name: "mentions.deliveries",
-		description: "Deprecated: use mentions.delivery. Removed in the next minor release. Whether each @mention in a message you sent reached its target.",
-		schema: senderMentionDeliveriesRequestSchema,
-		routes: ["senderMentionDeliveries"],
-		consumes: nothing,
-		output: small,
-		deprecated: true
-	},
 	{
 		name: "actions.prepare",
 		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).",
@@ -15840,7 +15910,7 @@ const OPERATION_DEFS = [
 		name: "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.",
 		schema: userInfoRequestSchema,
-		routes: ["serverInfo", "channelMembers"],
+		routes: ["userChannels", "serverInfo"],
 		consumes: nothing,
 		output: {
 			mayBeLarge: true,
@@ -16079,9 +16149,7 @@ function createRaft(options) {
 			pending: (request) => pendingMentionActions(api, request, style).then(styled),
 			notify: (request) => notifyMentions(api, request).then(styled),
 			add: (request) => addMentions(api, request).then(styled),
-			delivery: (request) => senderMentionDeliveries(api, request).then(styled),
-			execute: (request) => executeMentionAction(api, request).then(styled),
-			deliveries: (request) => senderMentionDeliveries(api, request).then(styled)
+			delivery: (request) => senderMentionDeliveries(api, request).then(styled)
 		},
 		actions: { prepare: (request) => prepareActionCard(api, request, style).then(styled) },
 		manual: {
@@ -16173,8 +16241,6 @@ function createRaft(options) {
 		"mentions.notify": (args) => raft.mentions.notify(args),
 		"mentions.add": (args) => raft.mentions.add(args),
 		"mentions.delivery": (args) => raft.mentions.delivery(args),
-		"mentions.execute": (args) => raft.mentions.execute(args),
-		"mentions.deliveries": (args) => raft.mentions.deliveries(args),
 		"actions.prepare": (args) => raft.actions.prepare(args),
 		"manual.get": (args) => raft.manual.get(args),
 		"manual.search": (args) => raft.manual.search(args),
@@ -16243,4 +16309,4 @@ function whoamiOutcome(result) {
 	};
 }
 //#endregion
-export { RAFT_INBOX_NOTICE_SCHEMA, RAFT_JSON_SCHEMA_KEYWORDS, RAFT_NOTICE_DELIVERY_ID_HEADER, RAFT_NOTICE_SIGNATURE_HEADER, RAFT_OPERATIONS, RAFT_OPERATIONS_SCHEMA, RAFT_OPERATIONS_VERSION, RAFT_STATE_CONTINUATIONS_PER_TARGET, RAFT_STATE_CONTINUATIONS_TOTAL, RAFT_STATE_SCHEMA, RaftCredentialError, RaftSdkConfigurationError, SeenFrontier, amendTaskRequestSchema, assignTaskRequestSchema, attachmentCommentsRequestSchema, bootstrapRaftCredential, channelInfoRequestSchema, channelMembersRequestSchema, channelTargetRequestSchema, checkInboxRequestSchema, claimTasksRequestSchema, commitInboxRequestSchema, convertMessageToTaskRequestSchema, createFileCredentialStore, createRaft, createRaftClient, createRaftClientFromStore, createRaftRoutes, createTasksRequestSchema, describeRaftRoute, downloadAttachmentUrlRequestSchema, drainInboxRequestSchema, executeMentionActionRequestSchema, getManualTopicRequestSchema, hasAgentMessageIdentity, hashRaftSendContent, inferAttachmentMimeType, isInterrupted, joinRaftChannelByTarget, listInboxRequestSchema, listRaftRoutes, listTasksRequestSchema, listThreadsRequestSchema, mentionResolutionIdsRequestSchema, parseRaftRegularChannelTarget, parseRaftState, pendingMentionActionsRequestSchema, prepareActionCardRequestSchema, projectRaftMessage, projectRaftMessages, raftToolNameFor, reactRequestSchema, readHistoryRequestSchema, readLatestReadThread, replyToRequestSchema, resolveMessageRequestSchema, searchManualRequestSchema, searchMessagesRequestSchema, sendMessageRequestSchema, senderMentionDeliveriesRequestSchema, serverInfoRequestSchema, showProfileRequestSchema, taskRefSchema, unfollowThreadRequestSchema, updateProfileRequestSchema, updateTaskStatusRequestSchema, userInfoRequestSchema, verifyInboxNotice, whoamiRequestSchema };
+export { RAFT_INBOX_NOTICE_SCHEMA, RAFT_JSON_SCHEMA_KEYWORDS, RAFT_NOTICE_DELIVERY_ID_HEADER, RAFT_NOTICE_SIGNATURE_HEADER, RAFT_OPERATIONS, RAFT_OPERATIONS_SCHEMA, RAFT_OPERATIONS_VERSION, RAFT_STATE_CONTINUATIONS_PER_TARGET, RAFT_STATE_CONTINUATIONS_TOTAL, RAFT_STATE_SCHEMA, RaftCredentialError, RaftSdkConfigurationError, SeenFrontier, amendTaskRequestSchema, assignTaskRequestSchema, attachmentCommentsRequestSchema, bootstrapRaftCredential, channelInfoRequestSchema, channelMembersRequestSchema, channelTargetRequestSchema, checkInboxRequestSchema, claimTasksRequestSchema, commitInboxRequestSchema, convertMessageToTaskRequestSchema, createFileCredentialStore, createRaft, createRaftClient, createRaftClientFromStore, createRaftRoutes, createTasksRequestSchema, describeRaftRoute, downloadAttachmentUrlRequestSchema, drainInboxRequestSchema, getManualTopicRequestSchema, hasAgentMessageIdentity, hashRaftSendContent, inferAttachmentMimeType, isInterrupted, joinRaftChannelByTarget, listInboxRequestSchema, listRaftRoutes, listTasksRequestSchema, listThreadsRequestSchema, mentionResolutionIdsRequestSchema, parseRaftRegularChannelTarget, parseRaftState, pendingMentionActionsRequestSchema, prepareActionCardRequestSchema, projectRaftMessage, projectRaftMessages, raftToolNameFor, reactRequestSchema, readHistoryRequestSchema, readLatestReadThread, replyToRequestSchema, resolveMessageRequestSchema, searchManualRequestSchema, searchMessagesRequestSchema, sendMessageRequestSchema, senderMentionDeliveriesRequestSchema, serverInfoRequestSchema, showProfileRequestSchema, taskRefSchema, unfollowThreadRequestSchema, updateProfileRequestSchema, updateTaskStatusRequestSchema, userInfoRequestSchema, verifyInboxNotice, whoamiRequestSchema };

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<{
@@ -1298,14 +1298,6 @@ export declare const pendingMentionActionsRequestSchema: z.ZodObject<{
 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";
-    add: "add";
-  }>;
-  resolutionIds: z.ZodArray<z.ZodString>;
-}, z.core.$strip>;
 export declare const senderMentionDeliveriesRequestSchema: z.ZodObject<{
   messageId: z.ZodString;
 }, z.core.$strip>;
@@ -1322,11 +1314,6 @@ type RaftMentionActionOutcome = RaftOutcome<{
   action: AgentMentionActionKind;
   results: AgentMentionActionResult[];
 }, "executed">;
-/** @deprecated The request of the deprecated `mentions.execute`; use `MentionResolutionIdsRequest`. */
-interface ExecuteMentionActionRequest {
-  action: AgentMentionActionKind;
-  resolutionIds: string[];
-}
 //#endregion
 //#region ../shared/src/agentOps/manual.d.ts
 interface ManualContext {
@@ -2561,6 +2548,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>;
@@ -5731,6 +5777,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";
@@ -8740,6 +8857,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>;
@@ -8806,6 +8926,7 @@ type AgentApiRequestParamsByRoute = {
   inboxList: never;
   agentContext: never;
   serverInfo: never;
+  userChannels: AgentApiUserChannelsParams;
   serverUpdate: never;
   mentionActionsPending: never;
   senderMentionDeliveries: AgentApiSenderMentionDeliveriesParams;
@@ -8887,6 +9008,7 @@ type AgentApiRequestQueryByRoute = {
   inboxList: AgentApiInboxListQuery;
   agentContext: never;
   serverInfo: never;
+  userChannels: AgentApiUserChannelsQuery;
   serverUpdate: never;
   mentionActionsPending: AgentApiMentionActionsPendingQuery;
   senderMentionDeliveries: never;
@@ -8968,6 +9090,7 @@ type AgentApiRequestBodyByRoute = {
   inboxList: never;
   agentContext: never;
   serverInfo: never;
+  userChannels: never;
   serverUpdate: AgentApiServerUpdateBody;
   mentionActionsPending: never;
   senderMentionDeliveries: never;
@@ -9049,6 +9172,7 @@ type AgentApiResponseByRoute = {
   inboxList: AgentApiInboxListResponse;
   agentContext: AgentApiAgentContextResponse;
   serverInfo: AgentApiServerInfoResponse;
+  userChannels: AgentApiUserChannelsResponse;
   serverUpdate: AgentApiServerUpdateResponse;
   mentionActionsPending: AgentApiMentionActionsPendingResponse;
   senderMentionDeliveries: AgentApiSenderMentionDeliveriesResponse;
@@ -9973,42 +10097,6 @@ declare const OPERATION_DEFS: readonly [{
     mayBeLarge: false;
     boundBy: never[];
   };
-}, {
-  readonly name: "mentions.execute";
-  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";
-      add: "add";
-    }>;
-    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 deprecated: true;
-}, {
-  readonly name: "mentions.deliveries";
-  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>;
-  readonly routes: readonly ["senderMentionDeliveries"];
-  readonly consumes: {
-    model: never[];
-    code: never[];
-  };
-  readonly output: {
-    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).";
@@ -10514,7 +10602,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[];
@@ -10753,12 +10841,6 @@ interface Raft {
     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">>;
   };
   actions: {
     /**
@@ -10893,4 +10975,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, 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 };
+export type { AmendTaskOutcome, AmendTaskRequest, AssignTaskRequest, BootstrapRaftCredentialOptions, CheckInboxOutcome, CheckInboxRequest, ClaimTasksOutcome, ClaimTasksRequest, ConvertMessageToTaskRequest, CreateRaftClientFromStoreOptions, CreateRaftClientOptions, CreateRaftOptions, CreateRaftRoutesOptions, CreateTasksRequest, DrainInboxRequest, 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": "16c7523f47f8b204",
+  "version": "24580df5e6c5b3bc",
   "operations": [
     {
       "name": "identity.whoami",
@@ -837,88 +837,6 @@
         "boundBy": []
       }
     },
-    {
-      "name": "mentions.execute",
-      "toolName": "mentions_execute",
-      "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": {
-          "action": {
-            "type": "string",
-            "description": "notify: tell the mentioned target about the message; add: add them to the conversation.",
-            "enum": [
-              "notify",
-              "add"
-            ]
-          },
-          "resolutionIds": {
-            "type": "array",
-            "description": "resolutionId values from mentions.pending.",
-            "items": {
-              "type": "string"
-            }
-          }
-        },
-        "required": [
-          "action",
-          "resolutionIds"
-        ]
-      },
-      "sideEffect": "write",
-      "idempotency": {
-        "kind": "none"
-      },
-      "capability": [
-        "mentions"
-      ],
-      "modelOnly": false,
-      "mayInterrupt": false,
-      "consumes": {
-        "model": [],
-        "code": []
-      },
-      "output": {
-        "mayBeLarge": false,
-        "boundBy": []
-      },
-      "deprecated": true
-    },
-    {
-      "name": "mentions.deliveries",
-      "toolName": "mentions_deliveries",
-      "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": {
-          "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": []
-      },
-      "deprecated": true
-    },
     {
       "name": "actions.prepare",
       "toolName": "actions_prepare",
@@ -2141,8 +2059,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.11.0",
+  "version": "0.12.0",
   "license": "FSL-1.1-ALv2",
   "description": "Typed Raft Agent API client for external agents and bots.",
   "type": "module",