@botiverse/raft-sdk 0.7.0 → 0.8.0

package/README.md

@@ -141,15 +141,21 @@ if (!signal.ok) return new Response(signal.message, { status: 401 });
   `idempotency_key_reused`.
 - `raft.tasks.claim({ target, taskNumbers })` — claim before work; refusals
   are rows, a hold is an interrupt whose resume is the identical claim.
-  Also `tasks.list` (a channel board or `mine: true`), `create`, `unclaim`,
-  `assign`, `updateStatus`, `amend`, `history`, `convert`, `delete`; a hold on
-  `updateStatus` / `amend` is an interrupt too.
+  Also `tasks.list` (a channel board or `mine: true`), `show` (one task's
+  current title and description, done and closed included), `create`,
+  `unclaim`, `assign`, `updateStatus`, `amend`, `history`, `convert`,
+  `delete`; a hold on `updateStatus` / `amend` is an interrupt too.
 - `raft.channels.join / leave / mute / unmute / members` and
   `raft.threads.list / unfollow` — your own attention state. `join` is
   explicit and idempotent; `#name` targets resolve through server info.
+  `raft.channels.info({ target })` — one regular channel's facts (visibility,
+  joined, your channel role, mute, description, member counts).
 - `raft.server.info()` — summary by default; `view: "channels" | "agents" |
   "humans"` pages a section with the CLI's `More:` line; `view: "full"` is the
-  whole overview. `raft.profile.show / update`.
+  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 /
+  update`.
 - `raft.messages.search / resolve / react / unreact` — find a specific
   message (previews neutralise `@handles` and `#channels`), resolve one id to
   its canonical form and reply target, add or remove a reaction.
@@ -284,8 +290,10 @@ whenever any field of any operation does.
 `$ref` / `$defs`, no `oneOf` / `anyOf` / `allOf`, no `const`. Richer request
 types are flattened so that every JSON-valid call is accepted by the runtime
 (zod stays the strict check): a nullable field is advertised as its non-null
-type and is optional (omitting it means null: `tasks.assign` without
-`assignee` clears it; the runtime still accepts an explicit null);
+type and is optional; omitting it never clears anything (for example
+`tasks.amend` without `description` leaves the description unchanged), and a
+value an operation cannot do without is required (`tasks.assign` requires
+`assignee`; clearing an assignee is `tasks.unassign`);
 `messages.read`'s `around` (seq or message id) is a `string` (a seq as
 `"12345"` reads the same window as `12345`);
 `actions.prepare`'s `action` is one object whose `type` enum picks the card and

package/dist/cjs/index.cjs

@@ -12079,6 +12079,22 @@ function formatAgentTaskHistory(data) {
 		return `seq=${event.seq} time=${event.createdAt} actor=${actor} type=${event.eventType}\n  ${JSON.stringify(event.payload)}`;
 	}).join("\n")}`;
 }
+/**
+* `raft task show`: one task's current title and description (moved verbatim
+* from the CLI's commands/task/show.ts). Labels match the agent delivery
+* surface (`Current title:` / `Current description:`). `description` has three
+* states that must not collapse: a string, an explicit null, and a field the
+* envelope omitted.
+*/
+function formatAgentTaskShow(target, task) {
+	const descriptionLine = typeof task.description === "string" ? `Current description: ${task.description}` : task.description === null ? "Current description: (none set)" : "Current description: (not returned by this surface)";
+	return [
+		`#${task.taskNumber} [${task.status ?? "unknown"}] in ${target}`,
+		`Current title: ${task.title ?? "(none set)"}`,
+		descriptionLine,
+		""
+	].join("\n");
+}
 //#endregion
 //#region ../shared/src/agentOps/tasks.ts
 const taskChannelSchema = string().describe("The channel the task board belongs to, for example `#proj-sdk`.");
@@ -12468,6 +12484,38 @@ async function taskHistory(client, request) {
 		text: formatAgentTaskHistory(result.data)
 	};
 }
+/**
+* `raft task show`: one task's current title and description. Reads the
+* channel's whole board (`status: "all"`, so done and closed tasks are found)
+* and picks the task; a miss says whether the Server asserted the list is
+* complete, exactly as the CLI does.
+*/
+async function showTask(client, request) {
+	const invalid = requireTaskRef(request);
+	if (invalid) return invalid;
+	const { target, taskNumber } = request;
+	const result = await client.tasks.list({
+		channel: target,
+		status: "all"
+	});
+	if (!result.ok) return failureFromClientResult(result);
+	const tasks = result.data.tasks ?? [];
+	const task = tasks.find((candidate) => candidate.taskNumber === taskNumber);
+	if (!task) return failureOutcome(opError("NOT_FOUND", {
+		message: result.data.pagination?.mode === "complete" && result.data.pagination.truncated === false ? `task #${taskNumber} not found in ${target} (searched ${tasks.length} task(s), status=all; server asserts this list is complete)` : tasks.length === 0 ? `task #${taskNumber} not found in ${target}: the server returned 0 tasks and did not assert the list is complete. That can mean the channel has no tasks, or that the server failed to read them (it currently reports some read errors as an empty list), and this command cannot tell which — so this is not evidence that task #${taskNumber} does not exist` : `task #${taskNumber} not found in ${target} (searched ${tasks.length} task(s), status=all; this surface does NOT assert completeness — so this is "absent from what was returned", not "does not exist")`,
+		nextAction: `Check the number with \`raft task list --target "${target}" --status all\`.`
+	}));
+	return {
+		ok: true,
+		state: "task",
+		data: {
+			target,
+			task
+		},
+		next: null,
+		text: formatAgentTaskShow(target, task)
+	};
+}
 const convertMessageToTaskRequestSchema = requestSchema()(object({
 	target: taskChannelSchema,
 	messageId: string().describe("Full or short id of a top-level message in that channel.")
@@ -12796,6 +12844,30 @@ function formatPageFooter(page) {
 	if (page.nextCommand && end < page.total) lines.push(`More: ${page.nextCommand}`);
 	return `${lines.join("\n")}\n`;
 }
+/** Single channel detail block. */
+function formatAgentChannelInfo(channel, memberCounts) {
+	const lines = ["## Channel", ""];
+	lines.push(`Channel: ${agentChannelRef(channel.name, channel.type)}`);
+	if (channel.id) lines.push(`ID: ${channel.id}`);
+	lines.push(`Visibility: ${channelVisibility(channel)}`);
+	lines.push(`Joined: ${channel.joined ? "yes" : "no"}`);
+	if (channel.channelRole) lines.push(`Channel role: ${channel.channelRole}`);
+	if (channel.channelAdminBasis) lines.push(`Channel admin basis: ${channel.channelAdminBasis}`);
+	const callableCapabilities = Object.entries(channel.channelCapabilities ?? {}).filter(([, allowed]) => allowed).map(([capability]) => capability);
+	if (callableCapabilities.length > 0) lines.push(`Channel capabilities: ${callableCapabilities.join(", ")}`);
+	const muted = channelMuted(channel);
+	if (muted !== void 0) lines.push(`Muted: ${muted ? "yes" : "no"}`);
+	if (typeof channel.archived === "boolean") lines.push(`Archived: ${channel.archived ? "yes" : "no"}`);
+	lines.push(`Description: ${channel.description?.trim() || "(none)"}`);
+	if (memberCounts) {
+		const agents = memberCounts.agents ?? 0;
+		const humans = memberCounts.humans ?? 0;
+		lines.push(`Members: ${agents + humans} (${agents} agents, ${humans} humans)`);
+	}
+	lines.push("");
+	lines.push(`More: raft channel members "${agentChannelRef(channel.name, channel.type)}"`);
+	return `${lines.join("\n")}\n`;
+}
 /** Compact server summary. */
 function formatAgentServerSummary(data) {
 	const channels = data.channels ?? [];
@@ -12862,6 +12934,23 @@ function formatAgentServerHumans(humans, page) {
 	}
 	return `${lines.join("\n")}${formatPageFooter(page)}`;
 }
+/** Narrow visible facts for one user/agent. */
+function formatAgentUserInfo(user, memberships, page, skippedChannels = 0) {
+	const name = user.value.name;
+	const role = roleLabel(user.value.role);
+	const lines = ["## User", ""];
+	lines.push(`User: @${name}`);
+	lines.push(`Kind: ${user.kind}`);
+	if (user.kind === "agent") lines.push(`Status: ${agentStatusLabel(user.value)}`);
+	if (role) lines.push(`Role: ${role.slice(2, -1)}`);
+	if (user.value.description) lines.push(`Description: ${user.value.description}`);
+	lines.push("");
+	lines.push("### Visible Channel Memberships");
+	if (memberships.length === 0) lines.push("(none found in inspected visible channels)");
+	else for (const channel of memberships) lines.push(`${agentChannelRef(channel.name, channel.type)} [${channelStatus(channel)}]`);
+	if (skippedChannels > 0) lines.push(`Skipped ${skippedChannels} visible channel roster checks because the server rejected them.`);
+	return `${lines.join("\n")}${formatPageFooter(page)}`;
+}
 /** Channel membership with server-role labels. */
 function formatAgentChannelMembers(data) {
 	let text = "## Channel Members\n\n";
@@ -13252,6 +13341,41 @@ async function unfollowThread(client, request) {
 		text: `Unfollowed ${request.target}. Ordinary delivery from this thread stops; a direct @mention reactivates the follow.`
 	};
 }
+const channelInfoRequestSchema = requestSchema()(object({ target: string().describe("A regular channel, `#channel-name` (the `#` may be omitted). DMs and threads are not accepted.") }));
+/**
+* `raft channel info <target>`: the channel's facts from `server.info`, plus
+* member counts from its roster when the Server shows it.
+*/
+async function channelInfo(client, request) {
+	const invalid = validateOpRequest(channelInfoRequestSchema, request);
+	if (invalid) return invalid;
+	const trimmed = request.target.trim();
+	const input = trimmed.startsWith("#") ? trimmed : `#${trimmed}`;
+	const name = parseRaftRegularChannelTarget$1(input);
+	if (!name) return failureOutcome(opError("INVALID_REQUEST", { message: "Target must be a regular channel name, e.g. '#engineering' or 'engineering'. DMs and thread targets are not supported." }));
+	const info = await client.server.info();
+	if (!info.ok) return failureFromClientResult(info);
+	const channel = info.data.channels.find((candidate) => candidate.name === name);
+	if (!channel) return failureOutcome(opError("NOT_FOUND", {
+		message: `Channel not found or not visible: ${input}`,
+		nextAction: "Run `raft server info --channels --query <name>` to inspect visible channels, or ask a channel member to add you if this is private."
+	}));
+	const members = await client.channels.members({ channel: `#${name}` });
+	const memberCounts = members.ok ? {
+		agents: members.data.agents?.length ?? 0,
+		humans: members.data.humans?.length ?? 0
+	} : null;
+	return {
+		ok: true,
+		state: "info",
+		data: {
+			channel,
+			memberCounts
+		},
+		next: null,
+		text: formatAgentChannelInfo(channel, memberCounts)
+	};
+}
 //#endregion
 //#region ../shared/src/agentOps/server.ts
 const serverInfoRequestSchema = requestSchema()(object({
@@ -13375,6 +13499,85 @@ async function updateProfile(client, request, options = {}) {
 		text: formatAgentProfile(result.data, 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).")
+}));
+/**
+* `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).
+*/
+async function userInfo(client, request) {
+	const invalid = validateOpRequest(userInfoRequestSchema, request);
+	if (invalid) return invalid;
+	const trimmed = request.name.trim();
+	const name = trimmed.startsWith("@") ? trimmed.slice(1) : trimmed;
+	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", {
+		message: `User not found or not visible: @${name}`,
+		nextAction: "Run `raft server info --agents --query <name>` or `raft server info --humans --query <name>` 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({
+			...channel,
+			joined: true,
+			muted: void 0,
+			activityMuted: void 0
+		});
+	}
+	const nextOffset = offset + limit;
+	const page = {
+		total: visibleChannels.length,
+		offset,
+		limit,
+		nextCommand: nextOffset < visibleChannels.length ? `raft user info @${name} --offset ${nextOffset} --limit ${limit}` : void 0
+	};
+	const next = page.nextCommand ? {
+		kind: "next_page",
+		command: page.nextCommand,
+		args: {
+			name: `@${name}`,
+			offset: nextOffset,
+			limit
+		},
+		why: "Only one page of visible channels was inspected for memberships."
+	} : null;
+	return {
+		ok: true,
+		state: "info",
+		data: {
+			user,
+			memberships,
+			skippedChannels,
+			page
+		},
+		next,
+		text: formatAgentUserInfo(user, memberships, page, skippedChannels)
+	};
+}
 //#endregion
 //#region ../shared/src/agentText/attachments.ts
 /** Upload receipt with attachment id and send-usage hint. */
@@ -15055,6 +15258,17 @@ const OPERATION_DEFS = [
 			boundBy: []
 		}
 	},
+	{
+		name: "tasks.show",
+		description: "One task's current status, title, and description. Finds done and closed tasks too.",
+		schema: taskRefSchema,
+		routes: ["taskList"],
+		consumes: nothing,
+		output: {
+			mayBeLarge: true,
+			boundBy: []
+		}
+	},
 	{
 		name: "tasks.convert",
 		description: "Turn a top-level message into an unassigned task.",
@@ -15114,6 +15328,14 @@ const OPERATION_DEFS = [
 			boundBy: []
 		}
 	},
+	{
+		name: "channels.info",
+		description: "A regular channel's facts: visibility, whether you joined it, your role and mute state, description, and member counts.",
+		schema: channelInfoRequestSchema,
+		routes: ["serverInfo", "channelMembers"],
+		consumes: nothing,
+		output: small
+	},
 	{
 		name: "threads.list",
 		description: "The threads you follow.",
@@ -15148,6 +15370,17 @@ 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"],
+		consumes: nothing,
+		output: {
+			mayBeLarge: true,
+			boundBy: ["offset", "limit"]
+		}
+	},
 	{
 		name: "profile.show",
 		description: "Show your profile, or someone else's by @handle.",
@@ -15393,6 +15626,7 @@ function createRaft(options) {
 			updateStatus: (request) => updateTaskStatus(api, request),
 			amend: (request) => amendTask(api, request),
 			history: (request) => taskHistory(api, request),
+			show: (request) => showTask(api, request),
 			convert: (request) => convertMessageToTask(api, request),
 			delete: (request) => deleteTask(api, request)
 		},
@@ -15401,13 +15635,15 @@ function createRaft(options) {
 			leave: (request) => leaveChannel(api, request),
 			mute: (request) => muteChannel(api, request),
 			unmute: (request) => unmuteChannel(api, request),
-			members: (request) => channelMembers(api, request)
+			members: (request) => channelMembers(api, request),
+			info: (request) => channelInfo(api, request)
 		},
 		threads: {
 			list: () => listThreads(api),
 			unfollow: (request) => unfollowThread(api, request)
 		},
 		server: { info: (request) => serverInfo(api, request) },
+		users: { info: (request) => userInfo(api, request) },
 		profile: {
 			show: (request) => showProfile(api, request),
 			update: (request) => updateProfile(api, request)
@@ -15475,6 +15711,7 @@ function createRaft(options) {
 		"tasks.updateStatus": (args) => raft.tasks.updateStatus(args),
 		"tasks.amend": (args) => raft.tasks.amend(args),
 		"tasks.history": (args) => raft.tasks.history(args),
+		"tasks.show": (args) => raft.tasks.show(args),
 		"tasks.convert": (args) => raft.tasks.convert(args),
 		"tasks.delete": (args) => raft.tasks.delete(args),
 		"channels.join": (args) => raft.channels.join(args),
@@ -15482,9 +15719,11 @@ function createRaft(options) {
 		"channels.mute": (args) => raft.channels.mute(args),
 		"channels.unmute": (args) => raft.channels.unmute(args),
 		"channels.members": (args) => raft.channels.members(args),
+		"channels.info": (args) => raft.channels.info(args),
 		"threads.list": () => raft.threads.list(),
 		"threads.unfollow": (args) => raft.threads.unfollow(args),
 		"server.info": (args) => raft.server.info(args),
+		"users.info": (args) => raft.users.info(args),
 		"profile.show": (args) => raft.profile.show(args),
 		"profile.update": (args) => raft.profile.update(args)
 	};
@@ -15545,6 +15784,7 @@ exports.amendTaskRequestSchema = amendTaskRequestSchema;
 exports.assignTaskRequestSchema = assignTaskRequestSchema;
 exports.attachmentCommentsRequestSchema = attachmentCommentsRequestSchema;
 exports.bootstrapRaftCredential = bootstrapRaftCredential;
+exports.channelInfoRequestSchema = channelInfoRequestSchema;
 exports.channelMembersRequestSchema = channelMembersRequestSchema;
 exports.channelTargetRequestSchema = channelTargetRequestSchema;
 exports.checkInboxRequestSchema = checkInboxRequestSchema;
@@ -15592,5 +15832,6 @@ exports.taskRefSchema = taskRefSchema;
 exports.unfollowThreadRequestSchema = unfollowThreadRequestSchema;
 exports.updateProfileRequestSchema = updateProfileRequestSchema;
 exports.updateTaskStatusRequestSchema = updateTaskStatusRequestSchema;
+exports.userInfoRequestSchema = userInfoRequestSchema;
 exports.verifyInboxNotice = verifyInboxNotice;
 exports.whoamiRequestSchema = whoamiRequestSchema;

package/dist/esm/index.js

@@ -12078,6 +12078,22 @@ function formatAgentTaskHistory(data) {
 		return `seq=${event.seq} time=${event.createdAt} actor=${actor} type=${event.eventType}\n  ${JSON.stringify(event.payload)}`;
 	}).join("\n")}`;
 }
+/**
+* `raft task show`: one task's current title and description (moved verbatim
+* from the CLI's commands/task/show.ts). Labels match the agent delivery
+* surface (`Current title:` / `Current description:`). `description` has three
+* states that must not collapse: a string, an explicit null, and a field the
+* envelope omitted.
+*/
+function formatAgentTaskShow(target, task) {
+	const descriptionLine = typeof task.description === "string" ? `Current description: ${task.description}` : task.description === null ? "Current description: (none set)" : "Current description: (not returned by this surface)";
+	return [
+		`#${task.taskNumber} [${task.status ?? "unknown"}] in ${target}`,
+		`Current title: ${task.title ?? "(none set)"}`,
+		descriptionLine,
+		""
+	].join("\n");
+}
 //#endregion
 //#region ../shared/src/agentOps/tasks.ts
 const taskChannelSchema = string().describe("The channel the task board belongs to, for example `#proj-sdk`.");
@@ -12467,6 +12483,38 @@ async function taskHistory(client, request) {
 		text: formatAgentTaskHistory(result.data)
 	};
 }
+/**
+* `raft task show`: one task's current title and description. Reads the
+* channel's whole board (`status: "all"`, so done and closed tasks are found)
+* and picks the task; a miss says whether the Server asserted the list is
+* complete, exactly as the CLI does.
+*/
+async function showTask(client, request) {
+	const invalid = requireTaskRef(request);
+	if (invalid) return invalid;
+	const { target, taskNumber } = request;
+	const result = await client.tasks.list({
+		channel: target,
+		status: "all"
+	});
+	if (!result.ok) return failureFromClientResult(result);
+	const tasks = result.data.tasks ?? [];
+	const task = tasks.find((candidate) => candidate.taskNumber === taskNumber);
+	if (!task) return failureOutcome(opError("NOT_FOUND", {
+		message: result.data.pagination?.mode === "complete" && result.data.pagination.truncated === false ? `task #${taskNumber} not found in ${target} (searched ${tasks.length} task(s), status=all; server asserts this list is complete)` : tasks.length === 0 ? `task #${taskNumber} not found in ${target}: the server returned 0 tasks and did not assert the list is complete. That can mean the channel has no tasks, or that the server failed to read them (it currently reports some read errors as an empty list), and this command cannot tell which — so this is not evidence that task #${taskNumber} does not exist` : `task #${taskNumber} not found in ${target} (searched ${tasks.length} task(s), status=all; this surface does NOT assert completeness — so this is "absent from what was returned", not "does not exist")`,
+		nextAction: `Check the number with \`raft task list --target "${target}" --status all\`.`
+	}));
+	return {
+		ok: true,
+		state: "task",
+		data: {
+			target,
+			task
+		},
+		next: null,
+		text: formatAgentTaskShow(target, task)
+	};
+}
 const convertMessageToTaskRequestSchema = requestSchema()(object({
 	target: taskChannelSchema,
 	messageId: string().describe("Full or short id of a top-level message in that channel.")
@@ -12795,6 +12843,30 @@ function formatPageFooter(page) {
 	if (page.nextCommand && end < page.total) lines.push(`More: ${page.nextCommand}`);
 	return `${lines.join("\n")}\n`;
 }
+/** Single channel detail block. */
+function formatAgentChannelInfo(channel, memberCounts) {
+	const lines = ["## Channel", ""];
+	lines.push(`Channel: ${agentChannelRef(channel.name, channel.type)}`);
+	if (channel.id) lines.push(`ID: ${channel.id}`);
+	lines.push(`Visibility: ${channelVisibility(channel)}`);
+	lines.push(`Joined: ${channel.joined ? "yes" : "no"}`);
+	if (channel.channelRole) lines.push(`Channel role: ${channel.channelRole}`);
+	if (channel.channelAdminBasis) lines.push(`Channel admin basis: ${channel.channelAdminBasis}`);
+	const callableCapabilities = Object.entries(channel.channelCapabilities ?? {}).filter(([, allowed]) => allowed).map(([capability]) => capability);
+	if (callableCapabilities.length > 0) lines.push(`Channel capabilities: ${callableCapabilities.join(", ")}`);
+	const muted = channelMuted(channel);
+	if (muted !== void 0) lines.push(`Muted: ${muted ? "yes" : "no"}`);
+	if (typeof channel.archived === "boolean") lines.push(`Archived: ${channel.archived ? "yes" : "no"}`);
+	lines.push(`Description: ${channel.description?.trim() || "(none)"}`);
+	if (memberCounts) {
+		const agents = memberCounts.agents ?? 0;
+		const humans = memberCounts.humans ?? 0;
+		lines.push(`Members: ${agents + humans} (${agents} agents, ${humans} humans)`);
+	}
+	lines.push("");
+	lines.push(`More: raft channel members "${agentChannelRef(channel.name, channel.type)}"`);
+	return `${lines.join("\n")}\n`;
+}
 /** Compact server summary. */
 function formatAgentServerSummary(data) {
 	const channels = data.channels ?? [];
@@ -12861,6 +12933,23 @@ function formatAgentServerHumans(humans, page) {
 	}
 	return `${lines.join("\n")}${formatPageFooter(page)}`;
 }
+/** Narrow visible facts for one user/agent. */
+function formatAgentUserInfo(user, memberships, page, skippedChannels = 0) {
+	const name = user.value.name;
+	const role = roleLabel(user.value.role);
+	const lines = ["## User", ""];
+	lines.push(`User: @${name}`);
+	lines.push(`Kind: ${user.kind}`);
+	if (user.kind === "agent") lines.push(`Status: ${agentStatusLabel(user.value)}`);
+	if (role) lines.push(`Role: ${role.slice(2, -1)}`);
+	if (user.value.description) lines.push(`Description: ${user.value.description}`);
+	lines.push("");
+	lines.push("### Visible Channel Memberships");
+	if (memberships.length === 0) lines.push("(none found in inspected visible channels)");
+	else for (const channel of memberships) lines.push(`${agentChannelRef(channel.name, channel.type)} [${channelStatus(channel)}]`);
+	if (skippedChannels > 0) lines.push(`Skipped ${skippedChannels} visible channel roster checks because the server rejected them.`);
+	return `${lines.join("\n")}${formatPageFooter(page)}`;
+}
 /** Channel membership with server-role labels. */
 function formatAgentChannelMembers(data) {
 	let text = "## Channel Members\n\n";
@@ -13251,6 +13340,41 @@ async function unfollowThread(client, request) {
 		text: `Unfollowed ${request.target}. Ordinary delivery from this thread stops; a direct @mention reactivates the follow.`
 	};
 }
+const channelInfoRequestSchema = requestSchema()(object({ target: string().describe("A regular channel, `#channel-name` (the `#` may be omitted). DMs and threads are not accepted.") }));
+/**
+* `raft channel info <target>`: the channel's facts from `server.info`, plus
+* member counts from its roster when the Server shows it.
+*/
+async function channelInfo(client, request) {
+	const invalid = validateOpRequest(channelInfoRequestSchema, request);
+	if (invalid) return invalid;
+	const trimmed = request.target.trim();
+	const input = trimmed.startsWith("#") ? trimmed : `#${trimmed}`;
+	const name = parseRaftRegularChannelTarget$1(input);
+	if (!name) return failureOutcome(opError("INVALID_REQUEST", { message: "Target must be a regular channel name, e.g. '#engineering' or 'engineering'. DMs and thread targets are not supported." }));
+	const info = await client.server.info();
+	if (!info.ok) return failureFromClientResult(info);
+	const channel = info.data.channels.find((candidate) => candidate.name === name);
+	if (!channel) return failureOutcome(opError("NOT_FOUND", {
+		message: `Channel not found or not visible: ${input}`,
+		nextAction: "Run `raft server info --channels --query <name>` to inspect visible channels, or ask a channel member to add you if this is private."
+	}));
+	const members = await client.channels.members({ channel: `#${name}` });
+	const memberCounts = members.ok ? {
+		agents: members.data.agents?.length ?? 0,
+		humans: members.data.humans?.length ?? 0
+	} : null;
+	return {
+		ok: true,
+		state: "info",
+		data: {
+			channel,
+			memberCounts
+		},
+		next: null,
+		text: formatAgentChannelInfo(channel, memberCounts)
+	};
+}
 //#endregion
 //#region ../shared/src/agentOps/server.ts
 const serverInfoRequestSchema = requestSchema()(object({
@@ -13374,6 +13498,85 @@ async function updateProfile(client, request, options = {}) {
 		text: formatAgentProfile(result.data, 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).")
+}));
+/**
+* `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).
+*/
+async function userInfo(client, request) {
+	const invalid = validateOpRequest(userInfoRequestSchema, request);
+	if (invalid) return invalid;
+	const trimmed = request.name.trim();
+	const name = trimmed.startsWith("@") ? trimmed.slice(1) : trimmed;
+	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", {
+		message: `User not found or not visible: @${name}`,
+		nextAction: "Run `raft server info --agents --query <name>` or `raft server info --humans --query <name>` 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({
+			...channel,
+			joined: true,
+			muted: void 0,
+			activityMuted: void 0
+		});
+	}
+	const nextOffset = offset + limit;
+	const page = {
+		total: visibleChannels.length,
+		offset,
+		limit,
+		nextCommand: nextOffset < visibleChannels.length ? `raft user info @${name} --offset ${nextOffset} --limit ${limit}` : void 0
+	};
+	const next = page.nextCommand ? {
+		kind: "next_page",
+		command: page.nextCommand,
+		args: {
+			name: `@${name}`,
+			offset: nextOffset,
+			limit
+		},
+		why: "Only one page of visible channels was inspected for memberships."
+	} : null;
+	return {
+		ok: true,
+		state: "info",
+		data: {
+			user,
+			memberships,
+			skippedChannels,
+			page
+		},
+		next,
+		text: formatAgentUserInfo(user, memberships, page, skippedChannels)
+	};
+}
 //#endregion
 //#region ../shared/src/agentText/attachments.ts
 /** Upload receipt with attachment id and send-usage hint. */
@@ -15054,6 +15257,17 @@ const OPERATION_DEFS = [
 			boundBy: []
 		}
 	},
+	{
+		name: "tasks.show",
+		description: "One task's current status, title, and description. Finds done and closed tasks too.",
+		schema: taskRefSchema,
+		routes: ["taskList"],
+		consumes: nothing,
+		output: {
+			mayBeLarge: true,
+			boundBy: []
+		}
+	},
 	{
 		name: "tasks.convert",
 		description: "Turn a top-level message into an unassigned task.",
@@ -15113,6 +15327,14 @@ const OPERATION_DEFS = [
 			boundBy: []
 		}
 	},
+	{
+		name: "channels.info",
+		description: "A regular channel's facts: visibility, whether you joined it, your role and mute state, description, and member counts.",
+		schema: channelInfoRequestSchema,
+		routes: ["serverInfo", "channelMembers"],
+		consumes: nothing,
+		output: small
+	},
 	{
 		name: "threads.list",
 		description: "The threads you follow.",
@@ -15147,6 +15369,17 @@ 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"],
+		consumes: nothing,
+		output: {
+			mayBeLarge: true,
+			boundBy: ["offset", "limit"]
+		}
+	},
 	{
 		name: "profile.show",
 		description: "Show your profile, or someone else's by @handle.",
@@ -15392,6 +15625,7 @@ function createRaft(options) {
 			updateStatus: (request) => updateTaskStatus(api, request),
 			amend: (request) => amendTask(api, request),
 			history: (request) => taskHistory(api, request),
+			show: (request) => showTask(api, request),
 			convert: (request) => convertMessageToTask(api, request),
 			delete: (request) => deleteTask(api, request)
 		},
@@ -15400,13 +15634,15 @@ function createRaft(options) {
 			leave: (request) => leaveChannel(api, request),
 			mute: (request) => muteChannel(api, request),
 			unmute: (request) => unmuteChannel(api, request),
-			members: (request) => channelMembers(api, request)
+			members: (request) => channelMembers(api, request),
+			info: (request) => channelInfo(api, request)
 		},
 		threads: {
 			list: () => listThreads(api),
 			unfollow: (request) => unfollowThread(api, request)
 		},
 		server: { info: (request) => serverInfo(api, request) },
+		users: { info: (request) => userInfo(api, request) },
 		profile: {
 			show: (request) => showProfile(api, request),
 			update: (request) => updateProfile(api, request)
@@ -15474,6 +15710,7 @@ function createRaft(options) {
 		"tasks.updateStatus": (args) => raft.tasks.updateStatus(args),
 		"tasks.amend": (args) => raft.tasks.amend(args),
 		"tasks.history": (args) => raft.tasks.history(args),
+		"tasks.show": (args) => raft.tasks.show(args),
 		"tasks.convert": (args) => raft.tasks.convert(args),
 		"tasks.delete": (args) => raft.tasks.delete(args),
 		"channels.join": (args) => raft.channels.join(args),
@@ -15481,9 +15718,11 @@ function createRaft(options) {
 		"channels.mute": (args) => raft.channels.mute(args),
 		"channels.unmute": (args) => raft.channels.unmute(args),
 		"channels.members": (args) => raft.channels.members(args),
+		"channels.info": (args) => raft.channels.info(args),
 		"threads.list": () => raft.threads.list(),
 		"threads.unfollow": (args) => raft.threads.unfollow(args),
 		"server.info": (args) => raft.server.info(args),
+		"users.info": (args) => raft.users.info(args),
 		"profile.show": (args) => raft.profile.show(args),
 		"profile.update": (args) => raft.profile.update(args)
 	};
@@ -15527,4 +15766,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, channelMembersRequestSchema, channelTargetRequestSchema, checkInboxRequestSchema, claimTasksRequestSchema, commitInboxRequestSchema, convertMessageToTaskRequestSchema, createFileCredentialStore, createRaft, createRaftClient, createRaftClientFromStore, createRaftRoutes, createTasksRequestSchema, describeRaftRoute, drainInboxRequestSchema, executeMentionActionRequestSchema, getManualTopicRequestSchema, hasAgentMessageIdentity, hashRaftSendContent, inferAttachmentMimeType, isInterrupted, joinRaftChannelByTarget, listInboxRequestSchema, listRaftRoutes, listTasksRequestSchema, listThreadsRequestSchema, parseRaftRegularChannelTarget, parseRaftState, pendingMentionActionsRequestSchema, prepareActionCardRequestSchema, projectRaftMessage, projectRaftMessages, raftToolNameFor, reactRequestSchema, readHistoryRequestSchema, readLatestReadThread, replyToRequestSchema, resolveMessageRequestSchema, searchManualRequestSchema, searchMessagesRequestSchema, sendMessageRequestSchema, senderMentionDeliveriesRequestSchema, serverInfoRequestSchema, showProfileRequestSchema, taskRefSchema, unfollowThreadRequestSchema, updateProfileRequestSchema, updateTaskStatusRequestSchema, 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, drainInboxRequestSchema, executeMentionActionRequestSchema, getManualTopicRequestSchema, hasAgentMessageIdentity, hashRaftSendContent, inferAttachmentMimeType, isInterrupted, joinRaftChannelByTarget, listInboxRequestSchema, listRaftRoutes, listTasksRequestSchema, listThreadsRequestSchema, 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

@@ -1007,6 +1007,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 +1064,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 +1117,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<{
@@ -10062,6 +10129,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 +10252,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 +10320,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 +10598,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 +10631,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 +10649,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 +10686,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": "90a77ae0a9067bc0",
   "operations": [
     {
       "name": "identity.whoami",
@@ -1519,6 +1519,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 +1812,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 +1965,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.8.0",
   "license": "FSL-1.1-ALv2",
   "description": "Typed Raft Agent API client for external agents and bots.",
   "type": "module",