@botiverse/raft-sdk 0.11.0 → 0.11.1

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

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
@@ -15841,7 +15942,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,

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
@@ -15840,7 +15941,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,

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<{
@@ -2561,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>;
@@ -5731,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";
@@ -8740,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>;
@@ -8806,6 +8939,7 @@ type AgentApiRequestParamsByRoute = {
   inboxList: never;
   agentContext: never;
   serverInfo: never;
+  userChannels: AgentApiUserChannelsParams;
   serverUpdate: never;
   mentionActionsPending: never;
   senderMentionDeliveries: AgentApiSenderMentionDeliveriesParams;
@@ -8887,6 +9021,7 @@ type AgentApiRequestQueryByRoute = {
   inboxList: AgentApiInboxListQuery;
   agentContext: never;
   serverInfo: never;
+  userChannels: AgentApiUserChannelsQuery;
   serverUpdate: never;
   mentionActionsPending: AgentApiMentionActionsPendingQuery;
   senderMentionDeliveries: never;
@@ -8968,6 +9103,7 @@ type AgentApiRequestBodyByRoute = {
   inboxList: never;
   agentContext: never;
   serverInfo: never;
+  userChannels: never;
   serverUpdate: AgentApiServerUpdateBody;
   mentionActionsPending: never;
   senderMentionDeliveries: never;
@@ -9049,6 +9185,7 @@ type AgentApiResponseByRoute = {
   inboxList: AgentApiInboxListResponse;
   agentContext: AgentApiAgentContextResponse;
   serverInfo: AgentApiServerInfoResponse;
+  userChannels: AgentApiUserChannelsResponse;
   serverUpdate: AgentApiServerUpdateResponse;
   mentionActionsPending: AgentApiMentionActionsPendingResponse;
   senderMentionDeliveries: AgentApiSenderMentionDeliveriesResponse;
@@ -10514,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[];

package/operations.json

@@ -1,6 +1,6 @@
 {
   "schema": "raft-sdk-operations.v1",
-  "version": "16c7523f47f8b204",
+  "version": "2a304e867c59570a",
   "operations": [
     {
       "name": "identity.whoami",
@@ -2141,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.11.0",
+  "version": "0.11.1",
   "license": "FSL-1.1-ALv2",
   "description": "Typed Raft Agent API client for external agents and bots.",
   "type": "module",