@nekro-nxt/contracts 0.3.0 → 0.5.0

package/dist/index.mjs

@@ -1,5 +1,28 @@
 import { z } from "zod";
 //#region src/domain.ts
+/** Rendered send-tool result consumed by both the agent and the product detail view. */
+const MessageDeliverySummarySchema = z.object({
+	status: z.enum([
+		"sent",
+		"partially-sent",
+		"failed",
+		"unknown"
+	]),
+	issues: z.array(z.object({
+		status: z.enum(["failed", "unknown"]),
+		message: z.string().max(1e3),
+		kind: z.enum([
+			"transient",
+			"permanent",
+			"rate-limited",
+			"authentication",
+			"invalid"
+		]).optional(),
+		action: z.string().max(120).optional(),
+		retcode: z.number().int().safe().optional()
+	}).strict()).max(20),
+	omittedIssues: z.number().int().nonnegative().optional()
+}).strict();
 const brandedId = (prefix, brand) => z.string().regex(new RegExp(`^${prefix}_[0-9A-Za-z]+$`), `${brand} has an invalid format.`).brand(brand);
 const AgentIdSchema = brandedId("agt", "AgentId");
 const AgentRevisionIdSchema = brandedId("arev", "AgentRevisionId");
@@ -23,6 +46,7 @@ const DshPluginEntryIdSchema = brandedId("dse", "DshPluginEntryId");
 const HostUiPageInstanceIdSchema = brandedId("hup", "HostUiPageInstanceId");
 const AuthoringTaskIdSchema = brandedId("aut", "AuthoringTaskId");
 const AuthoringAttemptIdSchema = brandedId("aua", "AuthoringAttemptId");
+const SubConversationIdSchema = brandedId("cnv", "SubConversationId");
 const AdapterActivityKeySchema = z.string().trim().min(1).max(128).regex(/^[a-z][a-z0-9]*(?:[.-][a-z0-9]+)*$/u, "Adapter activity key has an invalid format.");
 const PromptTextSegmentSchema = z.object({
 	type: z.literal("text"),
@@ -119,7 +143,12 @@ const MessagePartSchema = z.discriminatedUnion("type", [
 	z.object({
 		type: z.literal("image"),
 		assetId: AssetIdSchema,
-		alt: z.string().optional()
+		alt: z.string().optional(),
+		/**
+		* The platform reported the picture as a sticker. A hint only: a sticker dragged in from a desktop client and
+		* pictures from platforms without this signal arrive unmarked.
+		*/
+		sticker: z.literal(true).optional()
 	}).strict(),
 	z.object({
 		type: z.literal("file"),
@@ -151,17 +180,17 @@ const NonEmptyMessagePartsSchema = MessagePartsSchema.min(1);
 function parseMessageParts(input) {
 	return MessagePartsSchema.parse(input);
 }
-const collectRichAssetIds = (value, into) => {
+const collectRichAssetIds = (value, into, imagesOnly = false) => {
 	if (value === null || value === void 0 || typeof value === "boolean" || typeof value === "number") return;
 	if (typeof value === "string") return;
 	if (Array.isArray(value)) {
-		for (const item of value) collectRichAssetIds(item, into);
+		for (const item of value) collectRichAssetIds(item, into, imagesOnly);
 		return;
 	}
-	for (const [key, child] of Object.entries(value)) if ((key === "imageAssetId" || key === "previewAssetId") && typeof child === "string") {
+	for (const [key, child] of Object.entries(value)) if ((key === "imageAssetId" || key === "previewAssetId" || !imagesOnly && (key === "audioAssetId" || key === "fileAssetId")) && typeof child === "string") {
 		const parsed = AssetIdSchema.safeParse(child);
 		if (parsed.success) into.push(parsed.data);
-	} else collectRichAssetIds(child, into);
+	} else collectRichAssetIds(child, into, imagesOnly);
 };
 const messagePartAssetIds = (part) => {
 	if (part.type === "image" || part.type === "file" || part.type === "audio") return [part.assetId];
@@ -172,6 +201,14 @@ const messagePartAssetIds = (part) => {
 	return ids;
 };
 const messagePartAssetId = (part) => messagePartAssetIds(part)[0];
+/** Only actual pictures enter visual context; forwarded files and recordings retain their own media kind. */
+const messagePartImageAssetIds = (part) => {
+	if (part.type === "image") return [part.assetId];
+	if (part.type !== "rich") return [];
+	const ids = part.previewAssetId ? [part.previewAssetId] : [];
+	collectRichAssetIds(part.extension, ids, true);
+	return ids;
+};
 const asJsonRecord = (value) => value !== null && typeof value === "object" && !Array.isArray(value) ? value : void 0;
 const richItemLine = (value) => {
 	const item = asJsonRecord(value);
@@ -182,10 +219,14 @@ const richItemLine = (value) => {
 	const cardSummary = typeof card?.["summary"] === "string" ? card["summary"] : typeof card?.["title"] === "string" ? card["title"] : void 0;
 	const imageName = typeof item["imageName"] === "string" ? item["imageName"] : void 0;
 	const imageText = typeof item["imageAssetId"] === "string" ? `[图片${imageName ? ` ${imageName}` : ""}]` : void 0;
+	const audioText = typeof item["audioAssetId"] === "string" ? `[语音 ${item["audioAssetId"]}]` : void 0;
+	const fileText = typeof item["fileAssetId"] === "string" ? `[${typeof item["fileMediaType"] === "string" && item["fileMediaType"].startsWith("video/") ? "视频" : "文件"} ${item["fileAssetId"]}${typeof item["fileName"] === "string" ? `：${item["fileName"]}` : ""}]` : void 0;
 	const body = [
 		text,
 		cardSummary ? `[卡片] ${cardSummary}` : void 0,
-		imageText
+		imageText,
+		audioText,
+		fileText
 	].filter((part) => Boolean(part && part.length > 0)).join(" ");
 	if (!sender && !body) return void 0;
 	return sender ? `${sender}：${body}` : body;
@@ -524,9 +565,47 @@ const configSchema = {
 /**
 * Host capability level this build implements. A Revision that declares `requires.sdk` above it is rejected at
 * import with an "upgrade NekroNXT" message instead of an opaque schema error. Bump when a Manifest capability
-* ships; never reuse a level for a different meaning. Level 7 is Manifest V7 (host instance + agent attachments).
+* ships; never reuse a level for a different meaning. Level 7 is Manifest V7 (host instance + agent attachments); level 8 adds the asset library, image info, tool result
+* images, the search index and host-layer model calls. Level 9 adds the structured logger and explicit chat commands. Level 10 adds version lineage, the data version with its
+* migration hook and administrator-only commands. Level 11 lists the pictures of an inbound message to inbound hooks.
+*/
+const EXTENSION_SDK_LEVEL = 11;
+/** Lineage, `dataVersion` and administrator-only commands need this level; packages that carry them declare it. */
+const EXTENSION_GOVERNANCE_SDK_LEVEL = 10;
+/**
+* The first NekroNXT version of each capability level, so users read "needs NekroNXT 0.5.0" rather than a level
+* number. Add the row for a new level in the change that raises EXTENSION_SDK_LEVEL; a test keeps the two in step.
 */
-const EXTENSION_SDK_LEVEL = 7;
+const EXTENSION_SDK_RELEASES = [
+	{
+		level: 6,
+		version: "0.3.0"
+	},
+	{
+		level: 7,
+		version: "0.4.0"
+	},
+	{
+		level: 8,
+		version: "0.5.0"
+	},
+	{
+		level: 9,
+		version: "0.6.0"
+	},
+	{
+		level: 10,
+		version: "0.6.0"
+	},
+	{
+		level: 11,
+		version: "0.6.0"
+	}
+];
+/** The oldest NekroNXT version that supports `level`; undefined for a level no release supports yet. */
+const extensionSdkVersion = (level) => EXTENSION_SDK_RELEASES.find((release) => release.level >= level)?.version;
+/** Manifest V7 itself; extensions that use nothing newer need this level. */
+const EXTENSION_SDK_BASE_LEVEL = 7;
 const ExtensionRequiresSchema = z.object({ sdk: z.number().int().min(1).max(1e3) }).strict();
 /** `api.example.com` or `*.example.com` (subdomains only); lower-case DNS labels, no scheme, port or path. */
 const ExtensionNetworkDomainSchema = z.string().trim().toLowerCase().max(253).regex(/^(\*\.)?(?=.{1,253}$)([a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?)(\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?)+$/u, { message: "网络域名必须是 api.example.com 或 *.example.com 形式，不含协议、端口和路径。" });
@@ -603,6 +682,45 @@ const ExtensionPlatformCapabilitySchema = z.object({
 	/** Adapters whose raw API passthrough the extension may call. */
 	raw: z.array(AdapterKeySchema).max(8).default([])
 }).strict();
+const EXTENSION_ASSET_LIBRARY_DEFAULT_QUOTA_BYTES = 2 * 1024 * 1024 * 1024;
+const EXTENSION_ASSET_LIBRARY_MAX_QUOTA_BYTES = 32 * 1024 * 1024 * 1024;
+const ExtensionAssetLibraryCapabilitySchema = z.object({ quotaBytes: z.number().int().min(1024 * 1024).max(EXTENSION_ASSET_LIBRARY_MAX_QUOTA_BYTES).optional() }).strict();
+/**
+* `write` creates Assets in the current channel; `library` keeps Assets in the extension's own library so they can be
+* used in any channel later.
+*/
+const ExtensionAssetsCapabilitySchema = z.object({
+	write: z.literal(true).optional(),
+	library: ExtensionAssetLibraryCapabilitySchema.optional()
+}).strict().refine((value) => value.write !== void 0 || value.library !== void 0, "assets 至少声明 write 或 library。");
+const IndexNameSchema = z.string().trim().regex(/^[a-z][a-z0-9_]{0,31}$/u, "索引、字段和过滤项名称只能使用小写字母、数字和下划线，以字母开头。");
+const EXTENSION_INDEX_MAX_TEXT_FIELDS = 4;
+const EXTENSION_INDEX_MAX_FILTERS = 4;
+/**
+* One searchable collection. Text fields are matched by keywords (and vectors when the Host has them enabled); weights
+* rank keyword matches. Filter fields hold short keyword values, possibly several per document.
+*/
+const ExtensionIndexCollectionSchema = z.object({
+	name: IndexNameSchema,
+	fields: z.array(z.object({
+		name: IndexNameSchema,
+		weight: z.number().min(.1).max(10).default(1)
+	}).strict()).min(1).max(4),
+	filters: z.array(IndexNameSchema).max(4).default([])
+}).strict().superRefine((value, context) => {
+	const names = [...value.fields.map(({ name }) => name), ...value.filters];
+	if (new Set(names).size !== names.length) context.addIssue({
+		code: "custom",
+		message: "同一索引里的字段与过滤项不能重名。"
+	});
+});
+const ExtensionIndexCapabilitySchema = z.object({ collections: z.array(ExtensionIndexCollectionSchema).min(1).max(4).refine((value) => new Set(value.map(({ name }) => name)).size === value.length, "索引名称不能重复。") }).strict();
+const EXTENSION_MODEL_MAX_CALLS_PER_MINUTE = 120;
+/** Calls to a model the user picks from the Host's configured models, with images allowed; host layer only. */
+const ExtensionModelsCapabilitySchema = z.object({
+	maxCallsPerMinute: z.number().int().min(1).max(120),
+	maxOutputTokens: z.number().int().min(64).max(EXTENSION_LLM_MAX_OUTPUT_TOKENS)
+}).strict();
 /** A header or environment value: literal text, or the current value of a `meta.role: 'secret'` config field. */
 const ExtensionMcpValueSchema = z.union([z.string().max(4096), z.object({ secret: z.string().trim().min(1).max(64) }).strict()]);
 /** Becomes the model-facing tool prefix `mcp__<name>__`. */
@@ -663,7 +781,10 @@ const mcpTarget = (server) => server.transport === "stdio" ? JSON.stringify([
 const ExtensionCapabilitiesSchema = z.object({
 	network: ExtensionNetworkCapabilitySchema.optional(),
 	storage: ExtensionStorageCapabilitySchema.optional(),
-	assets: z.object({ write: z.literal(true) }).strict().optional(),
+	assets: ExtensionAssetsCapabilitySchema.optional(),
+	index: ExtensionIndexCapabilitySchema.optional(),
+	/** Host layer only; the agent layer uses `llm`, which runs on the agent's own model. */
+	models: ExtensionModelsCapabilitySchema.optional(),
 	history: z.object({ read: z.literal(true) }).strict().optional(),
 	inboundHook: ExtensionInboundHookCapabilitySchema.optional(),
 	jobs: ExtensionJobsCapabilitySchema.optional(),
@@ -678,7 +799,12 @@ const ExtensionCapabilitiesSchema = z.object({
 */
 const HostLayerCapabilitiesSchema = z.object({
 	network: ExtensionNetworkCapabilitySchema.optional(),
-	storage: z.object({ quotaBytes: z.number().int().min(1024).max(EXTENSION_STORAGE_MAX_QUOTA_BYTES).optional() }).strict().optional()
+	storage: z.object({ quotaBytes: z.number().int().min(1024).max(EXTENSION_STORAGE_MAX_QUOTA_BYTES).optional() }).strict().optional(),
+	/** The same library agent attachments use; the host instance lists and imports into it. */
+	assets: z.object({ library: ExtensionAssetLibraryCapabilitySchema }).strict().optional(),
+	/** The same collections agent attachments declare; pages search and maintain them. */
+	index: ExtensionIndexCapabilitySchema.optional(),
+	models: ExtensionModelsCapabilitySchema.optional()
 }).strict();
 /** Host-layer capabilities in the agent-capability shape, so digests, expansion and summaries share one implementation. */
 const hostLayerAsCapabilities = (host) => host === void 0 || Object.keys(host).length === 0 ? void 0 : {
@@ -686,7 +812,10 @@ const hostLayerAsCapabilities = (host) => host === void 0 || Object.keys(host).l
 	...host.storage === void 0 ? {} : { storage: {
 		scopes: ["shared"],
 		...host.storage.quotaBytes === void 0 ? {} : { quotaBytes: host.storage.quotaBytes }
-	} }
+	} },
+	...host.assets === void 0 ? {} : { assets: { library: host.assets.library } },
+	...host.index === void 0 ? {} : { index: host.index },
+	...host.models === void 0 ? {} : { models: host.models }
 };
 const NETWORK_MODE_RANK = {
 	domains: 0,
@@ -710,7 +839,9 @@ const extensionCapabilitiesExpand = (previous, next) => {
 	if (next === void 0) return false;
 	if (networkExpands(previous?.network, next.network)) return true;
 	if (next.storage?.scopes.some((scope) => !(previous?.storage?.scopes ?? []).includes(scope))) return true;
-	if (next.assets !== void 0 && previous?.assets === void 0) return true;
+	if (next.assets?.write !== void 0 && previous?.assets?.write === void 0) return true;
+	if (next.assets?.library !== void 0 && previous?.assets?.library === void 0) return true;
+	if (next.models !== void 0 && (previous?.models === void 0 || next.models.maxCallsPerMinute > previous.models.maxCallsPerMinute || next.models.maxOutputTokens > previous.models.maxOutputTokens)) return true;
 	if (next.history !== void 0 && previous?.history === void 0) return true;
 	const platformKey = ({ adapter, action }) => `${adapter}:${action}`;
 	const previousActions = new Set((previous?.platform?.actions ?? []).map(platformKey));
@@ -725,6 +856,7 @@ const extensionCapabilitiesExpand = (previous, next) => {
 	if (next.llm !== void 0 && (previous?.llm === void 0 || next.llm.maxCallsPerTurn > previous.llm.maxCallsPerTurn || next.llm.maxOutputTokens > previous.llm.maxOutputTokens)) return true;
 	return false;
 };
+const formatLibraryQuota = (bytes) => bytes >= 1024 * 1024 * 1024 ? `${+(bytes / 1024 / 1024 / 1024).toFixed(1)} GB` : `${Math.round(bytes / 1024 / 1024)} MB`;
 /**
 * User-facing summary of declared capabilities, in a stable order, for approval and inspection pages. `layer: 'host'`
 * phrases host-layer capabilities (passed through {@link hostLayerAsCapabilities}) for the host instance.
@@ -764,11 +896,29 @@ const summarizeExtensionCapabilities = (capabilities, options = {}) => {
 			label: shared ? "保存数据，并在启用它的智能体之间共享" : "为这个智能体保存数据"
 		});
 	}
-	if (capabilities.assets !== void 0) items.push({
+	if (capabilities.assets?.write !== void 0) items.push({
 		key: "assets",
 		risk: "normal",
 		label: "在当前频道生成图片或文件"
 	});
+	if (capabilities.assets?.library !== void 0) items.push({
+		key: "assets.library",
+		risk: "sensitive",
+		label: "把频道里的图片收进扩展资源库，之后可以在其他频道使用",
+		detail: `最多 ${formatLibraryQuota(capabilities.assets.library.quotaBytes ?? 2147483648)}`
+	});
+	if (capabilities.index !== void 0) items.push({
+		key: "index",
+		risk: "normal",
+		label: "建立可搜索的索引",
+		detail: capabilities.index.collections.map(({ name }) => name).join("、")
+	});
+	if (capabilities.models !== void 0) items.push({
+		key: "models",
+		risk: "sensitive",
+		label: "使用本机已配置的模型，可以发送图片",
+		detail: `每分钟最多 ${capabilities.models.maxCallsPerMinute} 次，计入所选模型的用量`
+	});
 	if (capabilities.history !== void 0) items.push({
 		key: "history",
 		risk: "normal",
@@ -1014,7 +1164,21 @@ const ExtensionPermissionsSchema = z.object({
 	networkOrigins: z.array(HostUiNetworkOriginSchema).max(32).default([]),
 	host: HostLayerCapabilitiesSchema.optional(),
 	agent: ExtensionCapabilitiesSchema.optional()
-}).strict().superRefine(checkBrowserPermissions);
+}).strict().superRefine(checkBrowserPermissions).superRefine((value, context) => {
+	if (value.agent?.models !== void 0) context.addIssue({
+		code: "custom",
+		path: ["agent", "models"],
+		message: "models 只能在 permissions.host 中声明；智能体层使用 llm 调用智能体自己的模型。"
+	});
+	for (const collection of value.agent?.index?.collections ?? []) {
+		const host = value.host?.index?.collections.find(({ name }) => name === collection.name);
+		if (host !== void 0 && JSON.stringify(host) !== JSON.stringify(collection)) context.addIssue({
+			code: "custom",
+			path: ["agent", "index"],
+			message: `索引 ${collection.name} 在 permissions.host 与 permissions.agent 中的定义不一致。`
+		});
+	}
+});
 const EMPTY_EXTENSION_PERMISSIONS = {
 	permissions: [],
 	networkOrigins: []
@@ -1206,6 +1370,447 @@ const EXTENSION_DATA_HOOK_PERMISSIONS = {
 	useConnection: "connections.read",
 	useChannelRuntime: "runtime.read"
 };
+/**
+* The capability level a set of permissions needs: Manifest V7 itself, or the level that introduced the newest
+* capability it declares. Packaging and import compare it with `requires.sdk`, so an extension cannot claim a level
+* too old for what it uses.
+*/
+const requiredExtensionSdkLevel = (permissions) => {
+	const level8 = [
+		permissions?.host?.assets === void 0 ? void 0 : "扩展资源库",
+		permissions?.agent?.assets?.library === void 0 ? void 0 : "扩展资源库",
+		permissions?.host?.index === void 0 && permissions?.agent?.index === void 0 ? void 0 : "检索索引",
+		permissions?.host?.models === void 0 ? void 0 : "本机层模型调用"
+	].filter((name) => name !== void 0);
+	return level8.length > 0 ? {
+		level: 8,
+		capabilities: [...new Set(level8)]
+	} : {
+		level: 7,
+		capabilities: []
+	};
+};
+//#endregion
+//#region src/commands.ts
+const COMMAND_DEFAULT_TIMEOUT_SECONDS = 60;
+const COMMAND_MAX_TIMEOUT_SECONDS = 600;
+/**
+* Who may run a command. `channel-admin` is granted per channel; `admin` is an instance administrator (the signed-in
+* console or a platform account listed in Settings → Administrators) and also holds every channel's `channel-admin`.
+*/
+const CommandPermissionSchema = z.enum([
+	"public",
+	"channel-admin",
+	"admin"
+]);
+const nameSchema = z.string().min(1).max(64).regex(/^[\p{L}\p{N}_-]+$/u);
+const scalarSchema = z.union([
+	z.string(),
+	z.number().finite(),
+	z.boolean()
+]);
+const CommandParameterSchema = z.object({
+	name: nameSchema,
+	description: z.string().max(500).optional(),
+	kind: z.enum(["positional", "option"]),
+	type: z.enum([
+		"string",
+		"number",
+		"integer",
+		"boolean"
+	]),
+	required: z.boolean().optional(),
+	default: scalarSchema.optional(),
+	choices: z.array(scalarSchema).min(1).max(100).optional(),
+	min: z.number().finite().optional(),
+	max: z.number().finite().optional()
+}).strict();
+const CommandDefinitionSchema = z.object({
+	name: nameSchema,
+	aliases: z.array(nameSchema).max(16).default([]),
+	description: z.string().min(1).max(1e3),
+	parameters: z.array(CommandParameterSchema).max(32).default([]),
+	examples: z.array(z.string().max(2e3)).max(16).default([]),
+	minimumPermission: CommandPermissionSchema.default("public"),
+	enabledByDefault: z.boolean().default(true),
+	/**
+	* Where the result goes when an administrator runs the command from the console (Web or Desktop) in an external
+	* channel. `local` (default) shows it in the console only; `channel` also sends it through the bot account, and
+	* the console labels the command accordingly. Platform-originated commands always reply in their conversation.
+	*/
+	consoleReply: z.enum(["local", "channel"]).default("local"),
+	/**
+	* How long an extension handler may run before it is cancelled and recorded as timed out, so a stuck handler
+	* cannot hold the channel's command queue. Built-in commands ignore it.
+	*/
+	timeoutSeconds: z.number().int().min(1).max(600).default(60)
+}).strict().superRefine((definition, ctx) => {
+	const names = [definition.name, ...definition.aliases];
+	if (new Set(names).size !== names.length) ctx.addIssue({
+		code: "custom",
+		message: "命令名称和别名不能重复。"
+	});
+	if (new Set(definition.parameters.map((p) => p.name)).size !== definition.parameters.length) ctx.addIssue({
+		code: "custom",
+		message: "参数名称不能重复。"
+	});
+	let optional = false;
+	for (const p of definition.parameters) {
+		if (p.min !== void 0 && p.max !== void 0 && p.min > p.max) ctx.addIssue({
+			code: "custom",
+			message: `参数 ${p.name} 的范围无效。`
+		});
+		if (p.kind === "positional") {
+			if (optional && p.required) ctx.addIssue({
+				code: "custom",
+				message: "必填位置参数必须在可选参数之前。"
+			});
+			if (!p.required || p.default !== void 0) optional = true;
+		}
+		if (p.default !== void 0) try {
+			if (validateValue(p, String(p.default)) !== p.default) throw new Error("默认值类型不匹配。");
+		} catch {
+			ctx.addIssue({
+				code: "custom",
+				message: `参数 ${p.name} 的默认值无效。`
+			});
+		}
+	}
+});
+const CommandPolicySchema = z.object({
+	enabled: z.boolean().optional(),
+	permission: CommandPermissionSchema.optional()
+}).strict();
+const CommandExecutionIdentitySchema = z.object({
+	source: z.enum(["web", "platform"]),
+	connectionId: ConnectionIdSchema.optional(),
+	platformUserId: z.string().optional(),
+	displayName: z.string(),
+	viewerId: z.string().optional()
+}).strict();
+const CommandResultSchema = z.object({
+	parts: z.array(MessagePartSchema).min(1).max(32).refine((parts) => parts.every((p) => [
+		"text",
+		"image",
+		"file"
+	].includes(p.type)), "命令结果仅支持文本、图片和文件。"),
+	summary: z.string().max(2e3).optional()
+}).strict();
+/** An execution may send a few progress replies before its final result. */
+const COMMAND_MAX_PROGRESS_REPLIES = 5;
+const CommandReplySchema = z.object({
+	/** Position within the execution; the final result always has the highest ordinal. */
+	ordinal: z.number().int().nonnegative(),
+	kind: z.enum(["progress", "final"]),
+	parts: CommandResultSchema.shape.parts,
+	/** Set once the reply has an Outbound; absent with `error` means planning failed. */
+	intentId: OutboundIntentIdSchema.optional(),
+	error: z.string().optional()
+}).strict();
+const CommandExecutionRecordSchema = z.object({
+	id: z.string().min(1),
+	channelId: ChannelIdSchema,
+	source: z.enum(["web", "platform"]),
+	requestId: z.string().min(1).max(200),
+	eventId: ChannelEventIdSchema.optional(),
+	rawText: z.string(),
+	identity: CommandExecutionIdentitySchema,
+	commandName: z.string().optional(),
+	commandVersion: z.string().optional(),
+	extensionRevisionId: ExtensionRevisionIdSchema.optional(),
+	agentId: AgentIdSchema.optional(),
+	agentRevisionId: AgentRevisionIdSchema.optional(),
+	status: z.enum([
+		"pending",
+		"running",
+		"succeeded",
+		"failed",
+		"uncertain"
+	]),
+	result: CommandResultSchema.optional(),
+	error: z.string().optional(),
+	/** Replies in send order. A platform command's replies go to its conversation; see `replyLocal`. */
+	replies: z.array(CommandReplySchema).max(6).default([]),
+	/** No reply is sent on purpose (unauthorized or unknown platform command, or console-local result). */
+	replySuppressed: z.boolean().optional(),
+	/** The result was kept in the console on purpose and never sent to the platform. */
+	replyLocal: z.boolean().optional(),
+	createdAt: z.number().int().nonnegative(),
+	completedAt: z.number().int().nonnegative().optional()
+}).strict();
+/** Replies that still need an Outbound or a recorded failure. */
+const undeliveredCommandReplies = (record) => record.replySuppressed === true ? [] : record.replies.filter((reply) => reply.intentId === void 0 && reply.error === void 0);
+const CommandCatalogEntrySchema = z.object({
+	definition: CommandDefinitionSchema,
+	fullName: z.string(),
+	source: z.string(),
+	extensionRevisionId: ExtensionRevisionIdSchema.optional(),
+	enabled: z.boolean(),
+	permission: CommandPermissionSchema,
+	usage: z.string(),
+	available: z.boolean(),
+	unavailableReason: z.string().optional(),
+	globalPolicy: CommandPolicySchema.optional(),
+	channelPolicy: CommandPolicySchema.optional()
+}).strict();
+/** Shell-like quoting without evaluation or interpolation. */
+function tokenizeCommand(text) {
+	const tokens = [];
+	let value = "", quote = "", escaped = false, started = false;
+	for (const char of text) {
+		if (escaped) {
+			value += char;
+			escaped = false;
+			started = true;
+			continue;
+		}
+		if (char === "\\") {
+			escaped = true;
+			started = true;
+			continue;
+		}
+		if (quote) {
+			if (char === quote) quote = "";
+			else value += char;
+			continue;
+		}
+		if (char === "\"" || char === "'") {
+			quote = char;
+			started = true;
+			continue;
+		}
+		if (/\s/u.test(char)) {
+			if (started) tokens.push(value);
+			value = "";
+			started = false;
+			continue;
+		}
+		value += char;
+		started = true;
+	}
+	if (escaped || quote) throw new Error("引号或转义未闭合。");
+	if (started) tokens.push(value);
+	return tokens;
+}
+function validateValue(p, raw) {
+	let value = raw;
+	if (p.type === "boolean") {
+		if (!["true", "false"].includes(raw)) throw new Error(`参数 ${p.name} 必须为 true 或 false。`);
+		value = raw === "true";
+	} else if (p.type !== "string") {
+		value = Number(raw);
+		if (raw.trim() === "" || !Number.isFinite(value) || p.type === "integer" && !Number.isSafeInteger(value)) throw new Error(`参数 ${p.name} 必须为${p.type === "integer" ? "整数" : "数字"}。`);
+	}
+	const size = typeof value === "string" ? [...value].length : typeof value === "number" ? value : void 0;
+	if (size !== void 0 && (p.min !== void 0 && size < p.min || p.max !== void 0 && size > p.max)) throw new Error(`参数 ${p.name} 超出允许范围。`);
+	if (p.choices !== void 0 && !p.choices.includes(value)) throw new Error(`参数 ${p.name} 必须为：${p.choices.join("、")}。`);
+	return value;
+}
+function parseCommandArguments(definition, tokens) {
+	const args = /* @__PURE__ */ new Map();
+	const positions = definition.parameters.filter((p) => p.kind === "positional");
+	let index = 0, options = true;
+	for (let i = 0; i < tokens.length; i++) {
+		const token = tokens[i];
+		if (options && token === "--") {
+			options = false;
+			continue;
+		}
+		let p, raw = token;
+		if (options && token.startsWith("--")) {
+			const equal = token.indexOf("=");
+			const key = token.slice(2, equal < 0 ? void 0 : equal);
+			p = definition.parameters.find((p) => p.kind === "option" && p.name === key);
+			if (!p) throw new Error(`未知选项：--${key}`);
+			if (equal >= 0) raw = token.slice(equal + 1);
+			else if (p.type === "boolean" && (tokens[i + 1] === void 0 || !["true", "false"].includes(tokens[i + 1]))) raw = "true";
+			else {
+				const next = tokens[++i];
+				if (next === void 0 || next.startsWith("--")) throw new Error(`选项 --${key} 缺少值。`);
+				raw = next;
+			}
+		} else {
+			p = positions[index++];
+			if (!p) throw new Error(`多余参数：${token}`);
+		}
+		if (args.has(p.name)) throw new Error(`重复参数：${p.name}`);
+		args.set(p.name, validateValue(p, raw));
+	}
+	for (const p of definition.parameters) {
+		if (args.has(p.name)) continue;
+		if (p.default !== void 0) args.set(p.name, p.default);
+		else if (p.required) throw new Error(`缺少参数：${p.kind === "option" ? "--" : ""}${p.name}`);
+	}
+	return Object.fromEntries(args);
+}
+function commandUsage(definition, name = definition.name) {
+	return "/" + name + definition.parameters.map((p) => {
+		const value = p.kind === "option" ? `--${p.name} ${p.type === "boolean" ? "[true|false]" : `<${p.name}>`}` : `<${p.name}>`;
+		return " " + (p.required ? value : `[${value}]`);
+	}).join("");
+}
+function recognizeCommand(parts, botMemberId, options = {}) {
+	let input = parts;
+	while (input.length > 1 && input[0]?.type === "text" && input[0].text.trim() === "") input = input.slice(1);
+	let addressed = options.addressed === true;
+	let mentionPart = false;
+	if (input[0]?.type === "mention") {
+		if (botMemberId === void 0 || input[0].memberId !== botMemberId) return { kind: "chat" };
+		input = input.slice(1);
+		addressed = true;
+		mentionPart = true;
+	}
+	if (options.requireMention === true && !addressed) return { kind: "chat" };
+	if (input.length === 0 || input.some((p) => p.type !== "text")) return { kind: "chat" };
+	let text = input.map((p) => p.type === "text" ? p.text : "").join("").trimStart();
+	if (options.addressed === true && !mentionPart) text = text.replace(/^@\S+\s+/u, "");
+	if (text.startsWith("//")) return {
+		kind: "escaped",
+		parts: [{
+			type: "text",
+			text: text.slice(1)
+		}]
+	};
+	if (!text.startsWith("/")) return { kind: "chat" };
+	return {
+		kind: "command",
+		text
+	};
+}
+/** The command name a recognized text invokes (`/name args` → `name`). */
+const commandNameOf = (text) => /^\/(\S*)/u.exec(text.trimStart())?.[1] ?? "";
+//#endregion
+//#region src/logs.ts
+/** Log summaries are labels; leave structured diagnostics and stacks untouched. */
+function formatLogMessage(message) {
+	return message.trimEnd().replace(/[。.]$/u, "");
+}
+const hostLogLevelSchema = z.enum([
+	"debug",
+	"info",
+	"warn",
+	"error"
+]);
+const hostLogSourceKindSchema = z.enum([
+	"system",
+	"dsh-plugin",
+	"extension",
+	"connection",
+	"unknown"
+]);
+const hostLogSourceSchema = z.object({
+	kind: hostLogSourceKindSchema,
+	id: z.string().min(1).max(512),
+	name: z.string().min(1).max(512),
+	version: z.string().max(512).optional(),
+	component: z.string().max(512).optional()
+}).strict();
+const hostLogScopeSchema = z.object({
+	extensionId: z.string().max(512).optional(),
+	revisionId: z.string().max(512).optional(),
+	connectionId: z.string().max(512).optional(),
+	agentId: z.string().max(512).optional(),
+	channelId: z.string().max(512).optional(),
+	sessionId: z.string().max(512).optional(),
+	episodeId: z.string().max(512).optional(),
+	operationId: z.string().max(512).optional()
+}).strict();
+const hostLogEntrySchema = z.object({
+	id: z.string(),
+	sequence: z.number().int().nonnegative(),
+	timestamp: z.iso.datetime(),
+	runId: z.string(),
+	level: hostLogLevelSchema,
+	message: z.string(),
+	source: hostLogSourceSchema,
+	scope: hostLogScopeSchema.optional(),
+	details: z.json().optional(),
+	code: z.string().optional(),
+	redacted: z.boolean(),
+	truncated: z.boolean()
+}).strict();
+const hostLogQuerySchema = z.object({
+	levels: z.array(hostLogLevelSchema).max(4).optional(),
+	sourceKinds: z.array(hostLogSourceKindSchema).max(5).optional(),
+	sourceIds: z.array(z.string().max(512)).max(100).optional(),
+	sources: z.array(hostLogSourceSchema.pick({
+		kind: true,
+		id: true
+	})).max(100).optional(),
+	scope: hostLogScopeSchema.optional(),
+	keyword: z.string().max(1e3).optional(),
+	from: z.iso.datetime().optional(),
+	to: z.iso.datetime().optional(),
+	olderCursor: z.string().max(128).optional(),
+	afterCursor: z.string().max(128).optional(),
+	headCursor: z.string().max(128).optional(),
+	limit: z.number().int().min(1).max(500).optional()
+}).strict();
+const hostLogPageSchema = z.object({
+	entries: z.array(hostLogEntrySchema),
+	olderCursor: z.string().nullable(),
+	headCursor: z.string(),
+	hasMore: z.boolean(),
+	gap: z.enum(["expired", "reset"]).optional()
+}).strict();
+const hostLogSettingsSchema = z.object({
+	retentionDays: z.number().int().min(1).max(30),
+	maxSizeMiB: z.number().int().min(64).max(2048),
+	revision: z.number().int().nonnegative()
+}).strict();
+const hostLogSettingsUpdateSchema = hostLogSettingsSchema;
+const hostLogDebugRequestSchema = z.object({
+	source: hostLogSourceSchema.pick({
+		kind: true,
+		id: true
+	}).optional(),
+	durationMinutes: z.union([
+		z.literal(5),
+		z.literal(15),
+		z.literal(30)
+	]).default(15)
+}).strict();
+const hostLogDebugLeaseSchema = hostLogDebugRequestSchema.extend({
+	id: z.string(),
+	expiresAt: z.iso.datetime()
+});
+const hostLogStatusSchema = z.object({
+	state: z.enum([
+		"ready",
+		"degraded",
+		"closed"
+	]),
+	runId: z.string(),
+	headCursor: z.string(),
+	bytes: z.number().nonnegative(),
+	count: z.number().int().nonnegative(),
+	oldestTimestamp: z.iso.datetime().nullable(),
+	newestTimestamp: z.iso.datetime().nullable(),
+	queuedBytes: z.number().nonnegative(),
+	droppedCount: z.number().int().nonnegative(),
+	debugLeases: z.array(hostLogDebugLeaseSchema),
+	error: z.string().optional()
+}).strict();
+const hostLogStreamEventSchema = z.discriminatedUnion("type", [
+	z.object({
+		type: z.literal("entries"),
+		entries: z.array(hostLogEntrySchema),
+		cursor: z.string()
+	}),
+	z.object({
+		type: z.literal("gap"),
+		reason: z.enum([
+			"expired",
+			"reset",
+			"overflow"
+		]),
+		cursor: z.string()
+	}),
+	z.object({
+		type: z.literal("status"),
+		status: hostLogStatusSchema
+	})
+]);
 //#endregion
 //#region src/runtime-compatibility.ts
 const RuntimeCompatibilityDiagnosticSchema = z.object({
@@ -1330,7 +1935,7 @@ const ClientNotificationSchema = z.object({
 	title: z.string().trim().min(1).max(80),
 	body: z.string().trim().min(1).max(240),
 	occurredAt: z.number().int().nonnegative(),
-	route: z.string().regex(/^\/(?:(?:live|channels|agents|workshop|wiring|settings|apps|work|connections|users|extensions)(?:\/[^?#]*)?)?$/u).optional()
+	route: z.string().regex(/^\/(?:(?:live|channels|agents|workshop|wiring|settings|community|apps|work|connections|users|extensions)(?:\/[^?#]*)?)?$/u).optional()
 }).strict();
 const MANAGEMENT_PAIR_PROOF_PREFIX = "nxt-management-pair-v1";
 const managementPairProofMessage = (input) => [
@@ -1470,6 +2075,8 @@ const CommunityExtensionSortSchema = z.enum([
 ]);
 const CommunityReleaseIdSchema = z.string().regex(/^rel_[0-9A-Za-z]+$/u);
 const CommunityAccountSchema = z.object({
+	/** Immutable community identity; absent when connected to a community predating feedback support. */
+	id: z.string().min(1).max(100).optional(),
 	handle: z.string().min(1).max(80),
 	displayName: z.string().max(200),
 	avatarUrl: z.string().url().nullable()
@@ -1480,6 +2087,7 @@ const CommunityEnvironmentSchema = z.enum([
 	"development"
 ]);
 const CommunityStatusSchema = z.object({
+	features: z.array(z.string()).optional(),
 	communityUrl: z.string().url(),
 	/** 社区自我声明的环境；连不上或旧版社区时为 null。 */
 	environment: CommunityEnvironmentSchema.nullable(),
@@ -1509,7 +2117,13 @@ const CommunityReleaseSchema = z.object({
 	packageSize: z.number().int().nonnegative(),
 	requiresSdk: z.number().int().positive().nullable(),
 	notes: z.string().max(2e3),
-	createdAt: z.number().int()
+	createdAt: z.number().int(),
+	/** Release number on the community line; absent from older communities. */
+	number: z.number().int().positive().optional(),
+	/** Revision the release contains and its lineage, so NekroNXT can tell fast-forward from divergence. */
+	revisionId: ExtensionRevisionIdSchema.optional(),
+	parentRevisionId: ExtensionRevisionIdSchema.nullable().optional(),
+	ancestry: z.array(ExtensionRevisionIdSchema).max(256).optional()
 });
 /** 社区为官方扩展保留的发布者标识：官方扩展由多位官方成员维护，对外不显示个人账号。 */
 const COMMUNITY_OFFICIAL_HANDLE = "nekro-nxt";
@@ -1530,7 +2144,18 @@ const CommunityExtensionSummarySchema = z.object({
 	latest: CommunityReleaseSchema.nullable(),
 	downloads: z.number().int().nonnegative(),
 	updatedAt: z.number().int(),
-	pageUrl: z.string().url()
+	pageUrl: z.string().url(),
+	/**
+	* The extension and version this one is a branch of; null for an original line or an older community. Without a
+	* displayName the origin is not public on the community.
+	*/
+	branchOf: z.object({
+		extensionId: ExtensionIdSchema,
+		revisionId: ExtensionRevisionIdSchema.nullable(),
+		displayName: z.string().max(200).nullable()
+	}).nullable().optional(),
+	/** Public branches made from this extension. */
+	branchCount: z.number().int().nonnegative().optional()
 });
 const CommunityExtensionDetailSchema = CommunityExtensionSummarySchema.extend({
 	description: z.string().max(2e4),
@@ -1590,6 +2215,45 @@ const CommunitySourceSchema = z.object({
 	publisherHandle: z.string().min(1).max(80),
 	installedAt: z.number().int().nonnegative()
 });
+/**
+* How this machine's current version of one extension relates to the community's newest public release, with the
+* action that relation calls for. `role` says whether this machine may publish the line or only follows it.
+*/
+const CommunitySyncItemSchema = z.object({
+	extensionId: ExtensionIdSchema,
+	displayName: z.string(),
+	communityUrl: z.string().url(),
+	role: z.enum(["owner", "subscriber"]),
+	currentRevisionId: ExtensionRevisionIdSchema,
+	currentVersionLabel: z.string(),
+	/** Release the current version is, when it is one. */
+	currentRelease: z.object({
+		id: CommunityReleaseIdSchema,
+		number: z.number().int().positive().nullable()
+	}).nullable(),
+	/** `remote-ahead`: update; `local-ahead`: publish (owner) or local changes (subscriber); `diverged`: merge first. */
+	status: z.enum([
+		"same",
+		"remote-ahead",
+		"local-ahead",
+		"diverged",
+		"unrelated",
+		"unknown"
+	]),
+	found: z.boolean(),
+	delisted: z.boolean(),
+	delistedReason: z.string().nullable(),
+	/** The release the current version came from was withdrawn by its author. */
+	releaseWithdrawn: z.boolean(),
+	latest: CommunityReleaseSchema.nullable(),
+	/** The user chose to keep local changes over `latest`; it is not offered again. */
+	dismissed: z.boolean(),
+	addedPermissions: z.array(CommunityPermissionItemSchema)
+});
+const CommunitySyncSchema = z.object({
+	checkedAt: z.number().int().nullable(),
+	items: z.array(CommunitySyncItemSchema)
+});
 const CommunityInstalledItemSchema = z.object({
 	extensionId: ExtensionIdSchema,
 	displayName: z.string(),
@@ -1801,6 +2465,371 @@ const communityPersonaReviewLabel = (status) => {
 	}
 };
 //#endregion
+//#region src/community-feedback.ts
+const COMMUNITY_FEEDBACK_STATUSES = [
+	"new",
+	"needs_info",
+	"triaged",
+	"planned",
+	"fixed",
+	"duplicate",
+	"wontfix",
+	"withdrawn"
+];
+const CommunityFeedbackStatusSchema = z.enum(COMMUNITY_FEEDBACK_STATUSES);
+const COMMUNITY_FEEDBACK_STATUS_LABELS = {
+	new: "新反馈",
+	needs_info: "需要补充",
+	triaged: "已确认",
+	planned: "已计划",
+	fixed: "已修复",
+	duplicate: "重复",
+	wontfix: "不处理",
+	withdrawn: "已撤回"
+};
+const CommunityFeedbackKindSchema = z.enum([
+	"bug",
+	"suggestion",
+	"question"
+]);
+const CommunityFeedbackIdSchema = z.string().regex(/^fbk_[0-9a-z]{26}$/u).brand();
+const CommunityFeedbackRefSchema = z.string().regex(/^FB-[1-9][0-9]*$/u);
+const CommunityFeedbackTargetSchema = z.union([z.literal("nxt"), z.object({
+	extensionId: z.string().regex(/^ext_[0-9A-Za-z]+$/u),
+	version: z.string().max(120).optional()
+}).strict()]);
+const version = z.string().trim().min(1).max(120);
+const timestamp = z.number().int().nonnegative();
+const CommunityFeedbackExtensionDiagnosticSchema = z.object({
+	extensionId: z.string().max(100),
+	version,
+	accessLevel: z.string().max(80).optional(),
+	activation: z.enum(["host", "agent"]).optional()
+}).strict();
+const CommunityFeedbackDiagnosticEntrySchema = z.object({
+	kind: z.enum([
+		"compatibility",
+		"extension",
+		"connection"
+	]),
+	summary: z.string().max(2e3),
+	extensionId: z.string().max(100).optional()
+}).strict();
+/** An explicit allowlist: credentials, account grants and arbitrary host configuration never cross this boundary. */
+const CommunityFeedbackDiagnosticsSchema = z.object({
+	nxtVersion: version.optional(),
+	releaseChannel: z.enum([
+		"stable",
+		"preview",
+		"development"
+	]).optional(),
+	hostKind: z.enum(["desktop", "server"]).optional(),
+	platform: z.string().max(80).optional(),
+	arch: z.string().max(40).optional(),
+	dshVersion: version.optional(),
+	adapters: z.array(z.string().max(100)).max(64).optional(),
+	agent: z.object({
+		accessLevel: z.string().max(80),
+		subagents: z.boolean(),
+		fileTools: z.boolean(),
+		webSearch: z.boolean(),
+		dynamicCreation: z.boolean(),
+		developmentShell: z.boolean(),
+		unrestrictedFileAccess: z.boolean(),
+		scheduledTasks: z.boolean(),
+		codeRun: z.boolean(),
+		commandNetwork: z.boolean(),
+		communityFeedbackAuto: z.boolean()
+	}).strict().optional(),
+	extensions: z.array(CommunityFeedbackExtensionDiagnosticSchema).max(256).optional(),
+	entries: z.array(CommunityFeedbackDiagnosticEntrySchema).max(32).optional(),
+	instanceId: z.string().min(1).max(100).optional()
+}).strict();
+const CommunityFeedbackExcerptSchema = z.array(z.object({
+	speaker: z.string().max(80),
+	text: z.string().max(6e3)
+}).strict()).max(8);
+const CommunityFeedbackCreateSchema = z.object({
+	clientRequestId: z.string().min(1).max(160),
+	kind: CommunityFeedbackKindSchema,
+	target: CommunityFeedbackTargetSchema,
+	title: z.string().trim().min(1).max(120),
+	body: z.string().trim().min(1).max(8e3),
+	diagnostics: CommunityFeedbackDiagnosticsSchema.default({}),
+	excerpt: CommunityFeedbackExcerptSchema.optional(),
+	excerptSharedWithAuthor: z.boolean().default(false),
+	source: z.enum([
+		"assistant",
+		"assistant_auto",
+		"form",
+		"web"
+	]),
+	instanceId: z.string().min(1).max(100).optional()
+}).strict();
+const CommunityFeedbackMessageInputSchema = z.object({
+	body: z.string().trim().min(1).max(4e3),
+	audience: z.enum(["everyone", "staff"]).default("everyone")
+}).strict();
+const CommunityFeedbackSupplementSchema = z.object({
+	diagnostics: CommunityFeedbackDiagnosticsSchema.optional(),
+	excerpt: CommunityFeedbackExcerptSchema.optional(),
+	excerptSharedWithAuthor: z.boolean().optional()
+}).strict();
+const CommunityFeedbackWithdrawSchema = z.object({ deleteText: z.boolean().default(false) }).strict();
+const CommunityFeedbackConfirmSchema = z.object({ clientVersion: version }).strict();
+const CommunityFeedbackReopenSchema = z.object({ note: z.string().trim().min(1).max(2e3) }).strict();
+const CommunityFeedbackAffectedSchema = z.object({
+	diagnostics: CommunityFeedbackDiagnosticsSchema.optional(),
+	nxtVersion: version.optional()
+}).strict();
+const CommunityFeedbackTransitionSchema = z.object({
+	status: CommunityFeedbackStatusSchema,
+	fixedIn: version.optional(),
+	duplicateOf: CommunityFeedbackRefSchema.optional(),
+	note: z.string().trim().max(2e3).optional()
+}).strict();
+const CommunityFeedbackLabelsSchema = z.object({
+	labels: z.array(z.string().trim().min(1).max(40)).max(20),
+	priority: z.enum([
+		"low",
+		"normal",
+		"high"
+	]).nullable()
+}).strict();
+const CommunityFeedbackLinkSchema = z.object({ githubUrl: z.string().url().max(1e3).refine((value) => /^https:\/\/github\.com\/[^/]+\/[^/]+\/issues\/[1-9][0-9]*$/u.test(value)).nullable() }).strict();
+const CommunityFeedbackVisibilitySchema = z.object({ visibility: z.enum(["private", "public"]) }).strict();
+const CommunityFeedbackEventDataSchema = z.object({
+	from: CommunityFeedbackStatusSchema.optional(),
+	to: CommunityFeedbackStatusSchema.optional(),
+	fixedIn: version.nullable().optional(),
+	duplicateOf: CommunityFeedbackRefSchema.nullable().optional(),
+	note: z.string().max(2e3).optional(),
+	labels: z.array(z.string()).optional(),
+	priority: z.enum([
+		"low",
+		"normal",
+		"high"
+	]).nullable().optional(),
+	visibility: z.enum(["private", "public"]).optional(),
+	clientVersion: version.optional(),
+	messageId: z.string().optional(),
+	audience: z.enum(["everyone", "staff"]).optional(),
+	deleteText: z.boolean().optional(),
+	affected: z.boolean().optional()
+}).strict();
+const CommunityFeedbackEventSchema = z.object({
+	seq: z.number().int().positive(),
+	ref: CommunityFeedbackRefSchema,
+	type: z.enum([
+		"created",
+		"message",
+		"status_changed",
+		"labeled",
+		"priority_changed",
+		"linked_issue",
+		"duplicate_marked",
+		"fixed_in_set",
+		"visibility_changed",
+		"affected_added",
+		"withdrawn",
+		"reopened",
+		"supplemented",
+		"fix_confirmed"
+	]),
+	actorKind: z.enum([
+		"user",
+		"admin",
+		"author",
+		"token",
+		"system"
+	]).optional(),
+	actor: z.string().optional(),
+	tokenId: z.string().optional(),
+	data: CommunityFeedbackEventDataSchema,
+	createdAt: timestamp,
+	title: z.string().optional(),
+	status: CommunityFeedbackStatusSchema.optional()
+});
+const CommunityFeedbackMessageSchema = z.object({
+	id: z.string(),
+	authorKind: z.enum([
+		"user",
+		"admin",
+		"author",
+		"system"
+	]),
+	author: z.string().nullable(),
+	audience: z.enum(["everyone", "staff"]),
+	body: z.string(),
+	createdAt: timestamp
+});
+const CommunityFeedbackSummarySchema = z.object({
+	id: CommunityFeedbackIdSchema,
+	ref: CommunityFeedbackRefSchema,
+	title: z.string(),
+	kind: CommunityFeedbackKindSchema.optional(),
+	target: CommunityFeedbackTargetSchema.optional(),
+	status: CommunityFeedbackStatusSchema,
+	fixedIn: version.nullable(),
+	affectedCount: z.number().int().nonnegative(),
+	source: CommunityFeedbackCreateSchema.shape.source.optional(),
+	confirmedCount: z.number().int().nonnegative().optional(),
+	createdAt: timestamp.optional(),
+	updatedAt: timestamp.optional()
+});
+/** Optional private fields are emitted only by the server's role-specific projection. */
+const CommunityFeedbackSchema = CommunityFeedbackSummarySchema.extend({
+	access: z.enum([
+		"owner",
+		"admin",
+		"author",
+		"subscriber",
+		"public"
+	]),
+	body: z.string().optional(),
+	diagnostics: CommunityFeedbackDiagnosticsSchema.optional(),
+	excerpt: CommunityFeedbackExcerptSchema.nullable().optional(),
+	excerptSharedWithAuthor: z.boolean().optional(),
+	messages: z.array(CommunityFeedbackMessageSchema).optional(),
+	events: z.array(CommunityFeedbackEventSchema).optional(),
+	submitter: z.string().optional(),
+	instanceId: z.string().nullable().optional(),
+	priority: z.enum([
+		"low",
+		"normal",
+		"high"
+	]).nullable().optional(),
+	labels: z.array(z.string()).optional(),
+	visibility: z.enum(["private", "public"]).optional(),
+	duplicateOf: CommunityFeedbackRefSchema.nullable().optional(),
+	githubUrl: z.string().nullable().optional(),
+	closedAt: timestamp.nullable().optional(),
+	purgedAt: timestamp.nullable().optional(),
+	confirmed: z.boolean().default(false),
+	affected: z.boolean().default(false),
+	affectedDiagnostics: z.array(z.object({
+		user: z.string(),
+		diagnostics: CommunityFeedbackDiagnosticsSchema.nullable(),
+		nxtVersion: version.nullable(),
+		createdAt: timestamp
+	})).optional()
+});
+const CommunityFeedbackListSchema = z.object({
+	items: z.array(CommunityFeedbackSummarySchema),
+	cursor: z.string().nullable()
+});
+const CommunityFeedbackChangesSchema = z.object({
+	events: z.array(CommunityFeedbackEventSchema),
+	cursor: z.number().int().nonnegative(),
+	hasMore: z.boolean()
+});
+const CommunityFeedbackDigestSchema = z.object({
+	since: timestamp,
+	counts: z.object({
+		status: z.record(CommunityFeedbackStatusSchema, z.number().int().nonnegative()),
+		kind: z.record(CommunityFeedbackKindSchema, z.number().int().nonnegative()),
+		target: z.record(z.enum(["nxt", "extension"]), z.number().int().nonnegative()),
+		extensions: z.record(z.string(), z.number().int().nonnegative())
+	}),
+	newItems: z.array(CommunityFeedbackSummarySchema),
+	awaitingReply: z.array(CommunityFeedbackSummarySchema),
+	mostAffected: z.array(CommunityFeedbackSummarySchema),
+	unconfirmedFixes: z.array(CommunityFeedbackSummarySchema),
+	fixedCount: z.number().int().nonnegative()
+});
+//#endregion
+//#region src/community-feedback-host.ts
+const CommunityFeedbackDraftIdSchema = z.string().regex(/^fbd_[0-9A-Za-z]+$/u).brand();
+const CommunityFeedbackDraftStateSchema = z.enum([
+	"awaiting",
+	"sending",
+	"sent",
+	"failed",
+	"discarded"
+]);
+const CommunityFeedbackDraftSchema = z.object({
+	id: CommunityFeedbackDraftIdSchema,
+	communityUrl: z.string().url(),
+	communityUserId: z.string().min(1).nullable(),
+	agentId: AgentIdSchema.nullable(),
+	channelId: ChannelIdSchema.nullable(),
+	kind: CommunityFeedbackKindSchema,
+	target: CommunityFeedbackTargetSchema,
+	title: z.string().max(120),
+	body: z.string().max(8e3),
+	excerpt: CommunityFeedbackExcerptSchema.nullable(),
+	excerptSharedWithAuthor: z.boolean(),
+	diagnostics: CommunityFeedbackDiagnosticsSchema,
+	state: CommunityFeedbackDraftStateSchema,
+	requestedBy: z.string(),
+	auto: z.boolean(),
+	error: z.string().nullable(),
+	createdAt: z.number().int().nonnegative(),
+	updatedAt: z.number().int().nonnegative()
+}).strict();
+const CommunityFeedbackItemSchema = z.object({
+	ref: CommunityFeedbackRefSchema,
+	communityUrl: z.string().url(),
+	communityUserId: z.string().min(1),
+	channelId: ChannelIdSchema.nullable(),
+	draftId: CommunityFeedbackDraftIdSchema.nullable(),
+	title: z.string(),
+	kind: CommunityFeedbackKindSchema.nullable(),
+	target: CommunityFeedbackTargetSchema.nullable(),
+	status: CommunityFeedbackStatusSchema,
+	fixedIn: z.string().nullable(),
+	unread: z.boolean(),
+	lastEventSeq: z.number().int().nonnegative(),
+	createdAt: z.number().int().nonnegative(),
+	updatedAt: z.number().int().nonnegative()
+}).strict();
+const CommunityFeedbackDraftInputSchema = z.object({
+	kind: CommunityFeedbackKindSchema,
+	target: CommunityFeedbackTargetSchema,
+	title: z.string().trim().min(1).max(120),
+	body: z.string().trim().min(1).max(8e3),
+	conversationRefs: z.array(LogicalMessageIdSchema).max(8).optional()
+}).strict();
+const CommunityFeedbackDraftUpdateSchema = z.object({
+	title: z.string().trim().min(1).max(120),
+	body: z.string().trim().min(1).max(8e3),
+	includeExcerpt: z.boolean(),
+	excerptSharedWithAuthor: z.boolean().default(false),
+	expectedUpdatedAt: z.number().int().nonnegative()
+}).strict();
+const CommunityFeedbackSettingsSchema = z.object({
+	enabled: z.boolean(),
+	supported: z.boolean(),
+	signedIn: z.boolean(),
+	communityUrl: z.string().url(),
+	communityUserId: z.string().nullable(),
+	consentedAt: z.number().int().nonnegative().nullable()
+}).strict();
+const CommunityFeedbackSettingsUpdateSchema = z.object({
+	enabled: z.boolean(),
+	consent: z.boolean().default(false)
+}).strict();
+const CommunityFeedbackSnapshotSchema = z.object({
+	enabled: z.boolean(),
+	signedIn: z.boolean(),
+	pendingDrafts: z.number().int().nonnegative(),
+	unread: z.number().int().nonnegative()
+}).strict();
+const CommunityFeedbackLocalListSchema = z.object({
+	drafts: z.array(CommunityFeedbackDraftSchema),
+	items: z.array(CommunityFeedbackItemSchema),
+	syncError: z.string().optional()
+}).strict();
+const CommunityFeedbackPayloadSchema = z.object({
+	payload: CommunityFeedbackCreateSchema,
+	redactions: z.array(z.string())
+}).strict();
+const CommunityFeedbackLastPayloadSchema = z.object({
+	ref: CommunityFeedbackRefSchema,
+	sentAt: z.number().int().nonnegative(),
+	payload: CommunityFeedbackCreateSchema
+}).strict().nullable();
+//#endregion
 //#region src/host-api.ts
 const EmptyParamsSchema = z.object({}).strict();
 const NoRequestBodySchema = z.undefined();
@@ -1840,6 +2869,9 @@ const DynamicAttemptErrorSchema = z.object({
 	]),
 	message: z.string(),
 	stack: z.string().optional(),
+	/** A render failure also names the contribution slot that failed and whether its frame gave up. */
+	slot: NonEmptyStringSchema.optional(),
+	abdicated: z.boolean().optional(),
 	pluginId: DynamicIdSchema,
 	packageId: DynamicIdSchema,
 	pluginRunId: DynamicIdSchema
@@ -1864,7 +2896,8 @@ const AuthoringTaskStatusSchema = z.enum([
 	"failed",
 	"interrupted",
 	"stopped",
-	"completed"
+	"completed",
+	"paused"
 ]);
 const AuthoringAttemptStateSchema = z.enum([
 	"drafting",
@@ -1903,6 +2936,8 @@ const AuthoringAttemptSummarySchema = z.object({
 		message: z.string(),
 		repairable: z.boolean()
 	}).strict().optional(),
+	/** Verified without loading its interface, because no browser was available; the interface itself is unchecked. */
+	uiUnverified: z.boolean().optional(),
 	createdAt: z.number().int().nonnegative(),
 	settledAt: z.number().int().nonnegative().optional()
 }).strict();
@@ -1914,6 +2949,15 @@ const AuthoringTaskSummarySchema = z.object({
 	title: z.string(),
 	requirementSummary: z.string(),
 	status: AuthoringTaskStatusSchema,
+	/** `create` builds a new extension; `revise` changes `targetExtensionId` starting from `baseRevisionId`. */
+	kind: z.enum(["create", "revise"]).default("create"),
+	targetExtensionId: ExtensionIdSchema.optional(),
+	baseRevisionId: ExtensionRevisionIdSchema.optional(),
+	referenceRevisionId: ExtensionRevisionIdSchema.optional(),
+	/** Why the task is paused; it continues when the agent picks it up in a later conversation. */
+	pausedReason: z.string().optional(),
+	/** The conversation the task runs in is live, so its candidate can be previewed directly. */
+	live: z.boolean().default(false),
 	approvalPolicy: z.enum(["risk-stable", "fully-automatic"]),
 	approvedRiskDigest: z.string().regex(/^[a-f0-9]{64}$/u).optional(),
 	revision: z.number().int().positive(),
@@ -1972,6 +3016,19 @@ const ImageUnderstandingPolicyApiSchema = z.object({
 		maxTokens: z.number().int().min(256).max(8192)
 	}).strict()])
 }).strict();
+const CommandAccountServiceSchema = z.enum(["github"]);
+const CommandAccountUsageSchema = z.enum([
+	"read",
+	"issues",
+	"pull-requests",
+	"push"
+]);
+const CommandAccountGrantSchema = z.object({
+	service: CommandAccountServiceSchema,
+	accountId: NonEmptyStringSchema.max(64),
+	/** Told to the agent as guidance, not enforced; empty gives no hint. */
+	usage: z.array(CommandAccountUsageSchema).max(4).default([])
+}).strict();
 const AgentCapabilitiesSchema = z.object({
 	subagents: z.boolean(),
 	fileTools: z.boolean(),
@@ -1980,10 +3037,28 @@ const AgentCapabilitiesSchema = z.object({
 	developmentShell: z.boolean(),
 	unrestrictedFileAccess: z.boolean(),
 	/** Absent in older clients means on. */
-	scheduledTasks: z.boolean().default(true)
+	scheduledTasks: z.boolean().default(true),
+	/** Tools are called from one TypeScript program (`run_code`); takes effect only with `developmentShell`. */
+	codeRun: z.boolean().default(false),
+	/** Network for commands; absent in older clients means on. */
+	commandNetwork: z.boolean().default(true),
+	communityFeedbackAuto: z.boolean().default(false),
+	/** Accounts this agent's commands may act as; absent in older clients means none. */
+	commandAccounts: z.array(CommandAccountGrantSchema).max(8).default([]),
+	/**
+	* What the agent may do with extensions without the console: `manual` only develops and test-runs, `confirm` asks
+	* an administrator in the channel for every step, `autonomous` takes ordinary steps that only affect itself.
+	*/
+	extensionAutonomy: z.enum([
+		"manual",
+		"confirm",
+		"autonomous"
+	]).default("manual"),
+	/** Whose requests make the agent develop or change extensions: anyone in the channel, or administrators only. */
+	extensionRequesters: z.enum(["everyone", "admins"]).default("everyone")
 }).strict();
 const DynamicClientApprovalPolicySchema = z.enum(["manual", "automatic"]);
-const NotificationEventKeySchema = z.enum(["dynamic-client-approval-requested"]);
+const NotificationEventKeySchema = z.enum(["dynamic-client-approval-requested", "community-feedback-update"]);
 const NotificationSettingsViewSchema = z.object({
 	revision: z.number().int().positive().optional(),
 	system: z.object({ enabled: z.boolean() }).strict(),
@@ -1992,7 +3067,10 @@ const NotificationSettingsViewSchema = z.object({
 		serverUrl: z.url(),
 		deviceKeyConfigured: z.boolean()
 	}).strict(),
-	events: z.record(NotificationEventKeySchema, z.boolean())
+	events: z.object({
+		"dynamic-client-approval-requested": z.boolean(),
+		"community-feedback-update": z.boolean().default(true)
+	}).strict()
 }).strict();
 const UpdateNotificationSettingsRequestSchema = z.object({
 	expectedRevision: z.number().int().positive().optional(),
@@ -2003,7 +3081,10 @@ const UpdateNotificationSettingsRequestSchema = z.object({
 		deviceKey: z.string().trim().min(1).max(2048).optional(),
 		clearDeviceKey: z.boolean().optional()
 	}).strict(),
-	events: z.record(NotificationEventKeySchema, z.boolean())
+	events: z.object({
+		"dynamic-client-approval-requested": z.boolean(),
+		"community-feedback-update": z.boolean().optional()
+	}).strict()
 }).strict().refine((value) => !(value.bark.deviceKey !== void 0 && value.bark.clearDeviceKey === true), {
 	message: "不能同时更新并清除 Bark Device Key。",
 	path: ["bark"]
@@ -2038,7 +3119,19 @@ const CreateAgentRequestSchema = AgentRevisionRequestContentSchema.extend({ capa
 const ReviseAgentRequestSchema = AgentRevisionRequestContentSchema.extend({ expectedCurrentRevisionId: AgentRevisionIdSchema }).superRefine((value, context) => {
 	validatePersonaDocumentProjection(value, context);
 });
-const UpdateAgentCapabilitiesRequestSchema = AgentCapabilitiesSchema.partial().extend({ scheduledTasks: z.boolean().optional() }).strict().refine((value) => Object.values(value).some((entry) => entry !== void 0), "至少提供一个能力。");
+const UpdateAgentCapabilitiesRequestSchema = AgentCapabilitiesSchema.partial().extend({
+	scheduledTasks: z.boolean().optional(),
+	codeRun: z.boolean().optional(),
+	commandNetwork: z.boolean().optional(),
+	communityFeedbackAuto: z.boolean().optional(),
+	commandAccounts: z.array(CommandAccountGrantSchema).max(8).optional(),
+	extensionAutonomy: z.enum([
+		"manual",
+		"confirm",
+		"autonomous"
+	]).optional(),
+	extensionRequesters: z.enum(["everyone", "admins"]).optional()
+}).strict().refine((value) => Object.values(value).some((entry) => entry !== void 0), "至少提供一个能力。");
 const TriggerPolicySchema = z.enum([
 	"always",
 	"mentioned-or-replied",
@@ -2063,7 +3156,8 @@ const SnapshotMessagePartSchema = z.discriminatedUnion("type", [
 	z.object({
 		type: z.literal("image"),
 		assetId: AssetIdSchema,
-		alt: z.string().optional()
+		alt: z.string().optional(),
+		sticker: z.literal(true).optional()
 	}).strict(),
 	z.object({
 		type: z.literal("file"),
@@ -2122,7 +3216,14 @@ const HostSnapshotMessageSchema = z.object({
 		action: z.enum(["retry", "confirm-delivered"]),
 		resolvedAt: z.number().int().safe().nonnegative()
 	}).strict().optional(),
-	origin: z.enum(["admin-console"]).optional(),
+	origin: z.enum([
+		"admin-console",
+		"command",
+		"extension-notice"
+	]).optional(),
+	command: CommandExecutionRecordSchema.optional(),
+	/** A host notice about extension work: a request an administrator must confirm, or what an action did. */
+	extensionNotice: z.object({ requestNumber: z.number().int().positive().optional() }).strict().optional(),
 	/** What the agent's inbound hooks decided for this message, when anything differs from the default. */
 	inboundHook: z.object({
 		trigger: z.enum([
@@ -2192,7 +3293,9 @@ const PlatformUserListResponseSchema = z.object({
 		}).strict(),
 		activeChannelCount: z.number().int().nonnegative(),
 		channelPreview: z.array(PlatformUserChannelPreviewSchema).max(3),
-		historicalOnly: z.boolean()
+		historicalOnly: z.boolean(),
+		/** Listed in Settings → Administrators. */
+		administrator: z.boolean().default(false)
 	}).strict()),
 	facets: z.object({
 		adapters: z.array(PlatformUserFacetAdapterSchema),
@@ -2225,7 +3328,7 @@ const ChannelRuntimeUsageSchema = z.object({
 	cacheWriteTokens: z.number().int().nonnegative().optional(),
 	reasoningTokens: z.number().int().nonnegative().optional()
 }).strict();
-const ChannelRuntimeToolSchema = z.object({
+const channelRuntimeToolFields = {
 	callId: NonEmptyStringSchema,
 	name: NonEmptyStringSchema,
 	displayName: NonEmptyStringSchema,
@@ -2244,7 +3347,14 @@ const ChannelRuntimeToolSchema = z.object({
 		"unknown"
 	]).optional(),
 	durationMs: z.number().int().nonnegative().optional()
-}).strict();
+};
+const ChannelRuntimeToolSchema = z.object({
+	...channelRuntimeToolFields,
+	/** Source of a `run_code` program. */
+	code: z.string().optional(),
+	/** Tools a `run_code` program called, in the order they started. */
+	children: z.array(z.object(channelRuntimeToolFields).strict()).optional()
+}).strict();
 const ChannelRuntimeStepSchema = z.object({
 	step: z.number().int().nonnegative(),
 	tools: z.array(ChannelRuntimeToolSchema),
@@ -2309,7 +3419,9 @@ const ChannelRuntimeOccupancySchema = z.object({
 		systemTokens: z.number().int().nonnegative(),
 		toolsTokens: z.number().int().nonnegative(),
 		messageTokens: z.number().int().nonnegative()
-	}).strict().optional()
+	}).strict().optional(),
+	/** Pictures in the conversation; their tokens are not in the breakdown, so they make up most of the rest. */
+	imageCount: z.number().int().nonnegative().optional()
 }).strict();
 const ChannelRuntimeCacheSampleSchema = z.object({
 	turn: z.number().int().nonnegative(),
@@ -2363,6 +3475,41 @@ const ChannelRuntimePerformanceSchema = z.object({
 		samples: z.array(ChannelRuntimePerformanceSampleSchema)
 	}).strict()
 }).strict();
+/** What the agent remembered or looked up, newest first; the admin sees it, the model does not. */
+const ChannelMemoryActivitySchema = z.discriminatedUnion("kind", [
+	z.object({
+		kind: z.literal("backlog-folded"),
+		at: z.number().nonnegative().optional(),
+		foldedCount: z.number().int().nonnegative(),
+		shownCount: z.number().int().nonnegative(),
+		foldedImageCount: z.number().int().nonnegative()
+	}).strict(),
+	z.object({
+		kind: z.literal("history-search"),
+		at: z.number().nonnegative().optional(),
+		query: z.string(),
+		hits: z.number().int().nonnegative(),
+		sender: z.string().optional()
+	}).strict(),
+	z.object({
+		kind: z.literal("notes-updated"),
+		at: z.number().nonnegative().optional(),
+		revision: z.number().int().nonnegative(),
+		chars: z.number().int().nonnegative()
+	}).strict(),
+	z.object({
+		kind: z.literal("member-notes-updated"),
+		at: z.number().nonnegative().optional(),
+		memberId: z.string(),
+		name: z.string().optional(),
+		chars: z.number().int().nonnegative()
+	}).strict(),
+	z.object({
+		kind: z.literal("idle-review"),
+		at: z.number().nonnegative().optional(),
+		quietMinutes: z.number().int().nonnegative()
+	}).strict()
+]);
 const ChannelRuntimeProjectionSchema = z.object({
 	channelId: ChannelIdSchema,
 	agentId: AgentIdSchema.optional(),
@@ -2373,6 +3520,7 @@ const ChannelRuntimeProjectionSchema = z.object({
 	occupancy: ChannelRuntimeOccupancySchema.optional(),
 	cache: ChannelRuntimeCacheSchema.optional(),
 	performance: ChannelRuntimePerformanceSchema.optional(),
+	memory: z.array(ChannelMemoryActivitySchema).optional(),
 	turns: z.array(ChannelRuntimeTurnSchema)
 }).strict();
 const ChannelRuntimeSseDataSchema = ChannelRuntimeProjectionSchema.extend({
@@ -2410,10 +3558,9 @@ const ChannelRuntimeContextSchema = z.object({
 		toolCount: z.number().int().nonnegative()
 	}).strict())
 }).strict();
-/** A channel's own instructions for whoever answers it, with recent earlier versions to restore. */
-const ChannelPromptViewSchema = z.object({
+const ChannelPromptPartSchema = z.object({
 	document: PromptDocumentV1Schema,
-	/** The agent may not rewrite a locked prompt. */
+	/** Notes only: the agent may not rewrite them. */
 	locked: z.boolean(),
 	/** 0 before the first save; send it back as `expectedRevision`. */
 	revision: z.number().int().nonnegative(),
@@ -2427,6 +3574,178 @@ const ChannelPromptViewSchema = z.object({
 		updatedAt: z.number().int().nonnegative()
 	}).strict())
 }).strict();
+/**
+* What the agent answering a channel reads about it, each part with recent earlier versions to restore: the admin's
+* instructions (system prompt) and the agent's own notes (runtime context).
+*/
+const ChannelPromptViewSchema = z.object({
+	instructions: ChannelPromptPartSchema,
+	notes: ChannelPromptPartSchema
+}).strict();
+/**
+* How much of a channel's unread backlog reaches the agent at once, and when it looks back on its own. Uncertain
+* trade-offs stay per channel: a busy meme group and a long tabletop session want different budgets.
+*/
+const ChannelContextPolicySchema = z.object({
+	/** Text characters of a backlog read message by message; older messages collapse into one line. 0: no limit. */
+	backlogTextChars: z.number().int().nonnegative().max(1e6),
+	/** Backlog images shown as pictures, newest first; the rest stay references the agent can open. */
+	backlogImages: z.number().int().nonnegative().max(20),
+	/** Quiet minutes after which the agent reviews the conversation and updates its notes. 0: off. */
+	idleReviewMinutes: z.number().int().nonnegative().max(1440)
+}).strict();
+const DEFAULT_CHANNEL_CONTEXT_POLICY = Object.freeze({
+	backlogTextChars: 4e4,
+	backlogImages: 6,
+	idleReviewMinutes: 45
+});
+const ChannelContextPolicyViewSchema = z.object({
+	policy: ChannelContextPolicySchema,
+	defaults: ChannelContextPolicySchema,
+	/** False while the channel follows the defaults. */
+	custom: z.boolean()
+}).strict();
+/** Whether a newer release exists on the build's own channel; development builds are never compared. */
+const ProductUpdateStatusSchema = z.object({
+	channel: z.enum([
+		"stable",
+		"preview",
+		"development"
+	]),
+	currentVersion: z.string(),
+	/** Short commit of a release build. */
+	currentCommit: z.string().optional(),
+	state: z.enum([
+		"unknown",
+		"up-to-date",
+		"available",
+		"failed",
+		"unsupported"
+	]),
+	latest: z.object({
+		version: z.string(),
+		commit: z.string().optional(),
+		url: z.string().url(),
+		publishedAt: z.number().int().nonnegative().optional()
+	}).strict().optional(),
+	checkedAt: z.number().int().nonnegative().optional(),
+	error: z.string().optional(),
+	autoCheck: z.boolean()
+}).strict();
+/** Pause between consecutive messages an agent sends to one channel; longer messages wait a little longer. */
+const MessagePacingSchema = z.enum([
+	"off",
+	"fast",
+	"normal",
+	"slow"
+]);
+const DEFAULT_MESSAGE_PACING = "normal";
+const MessagePacingSettingsSchema = z.object({ pacing: MessagePacingSchema }).strict();
+/**
+* A conversation of its own under a channel's conversation (docs/NekroNxt界面交互模型.md §5.6): the agent opens one
+* for a separate piece of work, and the host opens scripted ones to check creation candidates. It has its own log
+* and context, and is shown under its channel.
+*/
+const SubConversationSchema = z.object({
+	id: SubConversationIdSchema,
+	channelId: ChannelIdSchema,
+	episodeId: EpisodeIdSchema,
+	agentId: AgentIdSchema,
+	title: z.string().min(1).max(200),
+	/** `agent`: the agent opened it with a tool; `host`: NekroNXT opened it, such as to check a candidate. */
+	openedBy: z.enum(["agent", "host"]),
+	/** `model`: the agent's model talks in it; `script`: the host plays fixed tool calls. */
+	driver: z.enum(["model", "script"]),
+	status: z.enum(["open", "closed"]),
+	closeReason: z.enum([
+		"completed",
+		"closed-by-agent",
+		"closed-by-admin",
+		"failed",
+		"conversation-ended"
+	]).optional(),
+	/** What it handed back to the channel's conversation when it ended. */
+	summary: z.string().max(4e3).optional(),
+	authoringTaskId: AuthoringTaskIdSchema.optional(),
+	createdAt: z.number().int().nonnegative(),
+	closedAt: z.number().int().nonnegative().optional()
+}).strict();
+/** How long ended sub-conversations are kept before they are cleaned up. */
+const SubConversationRetentionSchema = z.enum([
+	"1d",
+	"3d",
+	"7d",
+	"30d",
+	"never"
+]);
+const DEFAULT_SUB_CONVERSATION_RETENTION = "7d";
+const SubConversationSettingsSchema = z.object({ retention: SubConversationRetentionSchema }).strict();
+/** `keyword`: SQLite keyword search only; `builtin`: keywords fused with the built-in semantic model. */
+const RetrievalModeSchema = z.enum(["keyword", "builtin"]);
+/** Search used by extension indexes (表情包与扩展素材能力 §6.4). */
+const RetrievalStatusSchema = z.object({
+	mode: RetrievalModeSchema,
+	builtin: z.object({
+		model: z.string(),
+		/** False where no inference runtime is published for this system and processor. */
+		supported: z.boolean(),
+		downloadBytes: z.number().int().nonnegative(),
+		install: z.discriminatedUnion("state", [
+			z.object({ state: z.literal("not-installed") }).strict(),
+			z.object({
+				state: z.literal("downloading"),
+				receivedBytes: z.number().int().nonnegative(),
+				totalBytes: z.number().int().nonnegative()
+			}).strict(),
+			z.object({ state: z.literal("installed") }).strict(),
+			z.object({
+				state: z.literal("failed"),
+				error: z.string()
+			}).strict()
+		])
+	}).strict(),
+	vectors: z.object({
+		documents: z.number().int().nonnegative(),
+		embedded: z.number().int().nonnegative(),
+		state: z.enum([
+			"idle",
+			"running",
+			"ready"
+		]),
+		error: z.string().optional()
+	}).strict()
+}).strict();
+/** Where the Host keeps restore points it takes before an upgrade, or none. */
+const UpgradeBackupModeSchema = z.enum([
+	"data",
+	"directory",
+	"off"
+]);
+const UpgradeBackupSettingsSchema = z.object({
+	mode: UpgradeBackupModeSchema,
+	/** The chosen directory when `mode` is `directory`. */
+	directory: z.string().nullable(),
+	/** Set through the server's environment; the settings page cannot change it. */
+	locked: z.boolean(),
+	/** Restore points kept; older ones are removed after an upgrade succeeds. */
+	keep: z.number().int().positive(),
+	/** Restore points currently in the chosen place. */
+	usage: z.object({
+		count: z.number().int().nonnegative(),
+		bytes: z.number().int().nonnegative()
+	}).strict()
+}).strict();
+/** What the agent keeps about individual members of one channel; each note comes with that member's messages. */
+const ChannelMemberNotesViewSchema = z.object({
+	notes: z.array(z.object({
+		memberId: ChannelMemberIdSchema,
+		displayName: z.string().optional(),
+		text: z.string(),
+		updatedBy: z.enum(["admin", "agent"]),
+		updatedAt: z.number().int().nonnegative()
+	}).strict()),
+	maxChars: z.number().int().positive()
+}).strict();
 const AdapterConnectionCreationSchema = z.object({
 	mode: z.enum(["schema-form", "qr-login"]),
 	actionLabel: z.string().trim().min(1).optional(),
@@ -2455,7 +3774,8 @@ const AdapterConnectionDescriptorSchema = z.object({
 			"internal",
 			"direct",
 			"group"
-		])).optional()
+		])).optional(),
+		directedAt: z.enum(["member", "message"]).optional()
 	}).strict()),
 	features: z.object({ processingFeedback: z.object({ channelKinds: z.array(z.enum(["direct", "group"])).min(1) }).strict().optional() }).strict(),
 	diagnostics: z.object({
@@ -2526,7 +3846,9 @@ const AttentionItemSchema = z.object({
 		"authoring-approval",
 		"connection-unhealthy",
 		"agent-model-unavailable",
-		"agent-vision-unavailable"
+		"agent-vision-unavailable",
+		"logs-unavailable",
+		"community-feedback"
 	]),
 	severity: z.enum([
 		"critical",
@@ -2539,7 +3861,9 @@ const AttentionItemSchema = z.object({
 			"channel",
 			"authoring-task",
 			"connection",
-			"agent"
+			"agent",
+			"logs",
+			"community-feedback"
 		]),
 		id: NonEmptyStringSchema
 	}).strict(),
@@ -2558,7 +3882,9 @@ const AttentionItemSchema = z.object({
 			"resolve-delivery",
 			"open-authoring-task",
 			"open-connection",
-			"open-agent"
+			"open-agent",
+			"open-logs",
+			"open-community-feedback"
 		]),
 		label: z.string().min(1).max(40)
 	}).strict(),
@@ -2665,7 +3991,90 @@ const ScheduledTaskSchema = z.object({
 	lastFiredAt: z.number().int().safe().optional(),
 	createdAt: z.number().int().safe()
 }).strict();
+/** The Node that runs `run_code` programs, and the download the desktop app offers when there is none. */
+const CodeRunAvailabilitySchema = z.object({
+	available: z.boolean(),
+	source: z.enum([
+		"host",
+		"system",
+		"downloaded"
+	]).optional(),
+	version: z.string().optional(),
+	download: z.object({
+		version: z.string(),
+		state: z.enum([
+			"idle",
+			"downloading",
+			"failed"
+		]),
+		receivedBytes: z.number().int().nonnegative().optional(),
+		totalBytes: z.number().int().nonnegative().optional(),
+		error: z.string().optional()
+	}).strict().optional()
+}).strict();
+/** The GitHub CLI commands call: found on this machine, or downloaded by NekroNXT where it can. */
+const GithubCliAvailabilitySchema = CodeRunAvailabilitySchema;
+/** The optional headless Chromium that loads and checks creation candidates when no page is open. */
+const VerificationBrowserAvailabilitySchema = CodeRunAvailabilitySchema;
+/**
+* One account in the host's library. The library only keeps accounts; an account takes effect only for the agents
+* whose capabilities grant it, which `usedBy` lists.
+*/
+const CommandAccountSchema = z.object({
+	id: NonEmptyStringSchema.max(64),
+	service: CommandAccountServiceSchema,
+	/** The account name on the service. */
+	login: NonEmptyStringSchema,
+	source: z.enum(["token", "gh-login"]),
+	/** Token scopes where the service reports them (classic tokens); absent for fine-grained tokens. */
+	scopes: z.array(z.string()).optional(),
+	createdAt: z.number().int().nonnegative(),
+	usedBy: z.array(AgentIdSchema)
+}).strict();
+/** A login the local `gh` holds, offered as a quick way to add an account. */
+const LocalGithubLoginSchema = z.object({
+	login: NonEmptyStringSchema,
+	active: z.boolean()
+}).strict();
+const CommandAccountsViewSchema = z.object({
+	accounts: z.array(CommandAccountSchema),
+	/** Logins found in the local GitHub CLI; empty when it is missing or not logged in. */
+	localLogins: z.array(LocalGithubLoginSchema)
+}).strict();
+const AddCommandAccountRequestSchema = z.discriminatedUnion("source", [z.object({
+	source: z.literal("token"),
+	service: CommandAccountServiceSchema,
+	token: NonEmptyStringSchema.max(512)
+}).strict(), z.object({
+	source: z.literal("gh-login"),
+	service: CommandAccountServiceSchema,
+	login: NonEmptyStringSchema.max(128)
+}).strict()]);
+/** An extension action an agent asked an administrator to confirm, or one it took on its own. */
+const ExtensionRequestSchema = z.object({
+	number: z.number().int().positive(),
+	kind: z.string(),
+	agentId: AgentIdSchema,
+	channelId: ChannelIdSchema.nullable(),
+	extensionId: ExtensionIdSchema.nullable(),
+	summary: z.string(),
+	status: z.enum([
+		"pending",
+		"approved",
+		"rejected",
+		"expired",
+		"completed",
+		"failed"
+	]),
+	autonomous: z.boolean(),
+	resultMessage: z.string().nullable(),
+	decidedBy: z.string().nullable(),
+	createdAt: z.number().int().nonnegative(),
+	expiresAt: z.number().int().nonnegative(),
+	decidedAt: z.number().int().nonnegative().nullable()
+}).strict();
 const HostSnapshotSchema = z.object({
+	communityFeedback: CommunityFeedbackSnapshotSchema.optional(),
 	upgrade: HostUpgradeSummarySchema.optional(),
 	cursor: HostSyncCursorSchema,
 	diagnosticsSampledAt: z.number().int().nonnegative(),
@@ -2688,7 +4097,19 @@ const HostSnapshotSchema = z.object({
 	}).strict()),
 	capabilityAvailability: z.object({
 		subagents: z.object({ available: z.boolean() }).strict(),
+		/** Optional in older hosts, which never offer `run_code`. */
+		codeRun: CodeRunAvailabilitySchema.optional(),
+		/** Optional in older hosts, which never offer command accounts. */
+		githubCli: GithubCliAvailabilitySchema.optional(),
+		/** Optional in older hosts, which check candidates only in an open page. */
+		verificationBrowser: VerificationBrowserAvailabilitySchema.optional(),
+		/** What this host can confine for commands beyond file writes; optional in older hosts. */
+		commandConfinement: z.object({
+			readScope: z.boolean(),
+			networkControl: z.boolean()
+		}).strict().optional(),
 		webSearch: z.object({
+			unavailableReason: z.string().optional(),
 			provider: z.literal("deepseek-official"),
 			available: z.boolean(),
 			credentialConfigured: z.boolean(),
@@ -2700,6 +4121,8 @@ const HostSnapshotSchema = z.object({
 	}).strict(),
 	connectionAdapters: z.array(AdapterConnectionDescriptorSchema),
 	notificationSettings: NotificationSettingsViewSchema,
+	/** Optional in older hosts, which have no account library. */
+	commandAccounts: z.array(CommandAccountSchema).optional(),
 	agents: z.array(z.object({
 		id: AgentIdSchema,
 		displayName: z.string(),
@@ -2757,6 +4180,8 @@ const HostSnapshotSchema = z.object({
 			"direct"
 		]),
 		displayName: z.string().optional(),
+		localDisplayName: z.string().optional(),
+		platformDisplayName: z.string().optional(),
 		boundAgentId: AgentIdSchema.optional(),
 		runtimePhase: ChannelRuntimePhaseSchema.default("idle"),
 		activity: ChannelActivitySummarySchema.default({
@@ -2769,6 +4194,8 @@ const HostSnapshotSchema = z.object({
 			channelId: ChannelIdSchema,
 			agentId: AgentIdSchema,
 			triggerPolicy: TriggerPolicySchema,
+			/** Channel pause, independent of the response rule. */
+			paused: z.boolean().default(false),
 			processingFeedback: z.enum(["auto", "off"]).default("auto"),
 			/** Absent means `observe`. */
 			localAgentMessages: z.enum(["observe", "trigger"]).optional(),
@@ -2787,6 +4214,7 @@ const HostSnapshotSchema = z.object({
 		adapterKey: NonEmptyStringSchema,
 		alias: ConnectionAliasOutputSchema.optional(),
 		activityTriggerDefaults: z.array(AdapterActivityKeySchema).default([]),
+		configuredSecrets: z.array(z.string()).optional(),
 		status: z.object({
 			state: z.enum([
 				"stopped",
@@ -2856,9 +4284,45 @@ const HostSnapshotSchema = z.object({
 		displayName: z.string(),
 		description: z.string(),
 		createdByAgentId: AgentIdSchema.optional(),
+		/** The Revision of another extension this one was branched from. */
+		branchOf: z.object({
+			extensionId: ExtensionIdSchema,
+			revisionId: ExtensionRevisionIdSchema,
+			/** Present while the original is on this machine. */
+			displayName: z.string().optional()
+		}).strict().optional(),
+		/** Shape version of the data stored on this machine. */
+		dataVersion: z.number().int().positive().default(1),
+		/** The unfinished revise task of this extension, if any. */
+		openRevisionTaskId: AuthoringTaskIdSchema.optional(),
+		/** Whether this machine publishes (`owner`) or follows the line on each community. */
+		communityLinks: z.array(z.object({
+			communityUrl: z.string(),
+			role: z.enum(["owner", "subscriber"])
+		}).strict()).default([]),
 		revisions: z.array(z.object({
 			id: ExtensionRevisionIdSchema,
 			revisionNumber: z.number().int().positive(),
+			/** Version number from the lineage, `v3` (or `v3·2` for a second Revision of the same generation). */
+			versionLabel: z.string(),
+			parentRevisionId: ExtensionRevisionIdSchema.optional(),
+			origin: z.enum([
+				"authored",
+				"file",
+				"community",
+				"branch"
+			]),
+			authoringTaskId: AuthoringTaskIdSchema.optional(),
+			dataVersion: z.number().int().positive(),
+			/** Community releases this Revision is; installs and publishes from here both record one. */
+			releases: z.array(z.object({
+				communityUrl: z.string(),
+				releaseId: CommunityReleaseIdSchema,
+				number: z.number().int().positive().nullable(),
+				publisherHandle: z.string(),
+				via: z.enum(["install", "publish"]),
+				recordedAt: z.number().int().nonnegative()
+			}).strict()).default([]),
 			format: z.enum(["current", "unavailable"]).optional(),
 			ui: ExtensionUiContributionsSchema.default(EMPTY_EXTENSION_UI_CONTRIBUTIONS),
 			/** The host instance's configuration form (`config.host`). */
@@ -2868,8 +4332,6 @@ const HostSnapshotSchema = z.object({
 			/** 扩展包自带图标的读取路径（同源、按摘要寻址、可长期缓存）；没有图标时缺省。 */
 			iconUrl: z.string().regex(/^\/api\/extensions\/[^/]+\/revisions\/[^/]+\/icon\/[a-f0-9]{64}\.(?:svg|png|webp)$/u).optional(),
 			createdAt: z.number().int().safe().nonnegative(),
-			/** 从社区安装的保存记录的来源；本机保存与文件导入没有来源。 */
-			source: CommunitySourceSchema.optional(),
 			provides: z.array(ExtensionProvideSchema),
 			/** Whether this Revision can be enabled for agents (agent-layer contributions or capabilities). */
 			agentLayer: z.boolean(),
@@ -3013,17 +4475,36 @@ const HostSnapshotSchema = z.object({
 		}).strict()
 	}).strict()),
 	authoringTasks: z.array(AuthoringTaskSummarySchema).default([]),
-	scheduledTasks: z.array(ScheduledTaskSchema).default([])
+	/** Open sub-conversations, and the most recently ended ones of each channel. */
+	subConversations: z.array(SubConversationSchema).default([]),
+	scheduledTasks: z.array(ScheduledTaskSchema).default([]),
+	/** Extension requests waiting for an administrator. */
+	extensionRequests: z.array(ExtensionRequestSchema).default([])
 }).strict();
-const MessageInputPartSchema = z.discriminatedUnion("type", [z.object({
-	type: z.literal("text"),
-	text: z.string().trim().min(1)
-}).strict(), z.object({
-	type: z.literal("mention"),
-	memberId: ChannelMemberIdSchema
-}).strict()]);
+const CHANNEL_COMPOSER_MAX_ATTACHMENTS = 20;
+const CHANNEL_COMPOSER_MAX_BYTES = 64 * 1024 * 1024;
+const MessageInputPartSchema = z.discriminatedUnion("type", [
+	z.object({
+		type: z.literal("text"),
+		text: z.string().trim().min(1)
+	}).strict(),
+	z.object({
+		type: z.literal("mention"),
+		memberId: ChannelMemberIdSchema
+	}).strict(),
+	z.object({
+		type: z.literal("image"),
+		assetId: AssetIdSchema,
+		alt: z.string().trim().max(500).optional()
+	}).strict(),
+	z.object({
+		type: z.literal("file"),
+		assetId: AssetIdSchema,
+		name: z.string().trim().max(255).optional()
+	}).strict()
+]);
 const SendChannelMessageRequestSchema = z.object({
-	parts: z.array(MessageInputPartSchema).min(1),
+	parts: z.array(MessageInputPartSchema).min(1).max(256).refine((parts) => parts.filter((part) => part.type === "image" || part.type === "file").length <= 20, "每条消息最多添加 20 个附件。"),
 	clientEventId: NonEmptyStringSchema.optional(),
 	senderMemberId: ChannelMemberIdSchema.optional()
 }).strict().refine((body) => body.parts.every((part) => part.type !== "text" || [...part.text].length <= 64 * 1024), "Message text must not exceed 64 KiB.");
@@ -3438,6 +4919,125 @@ const agentExtensionParam = z.object({
 	extensionId: ExtensionIdSchema
 }).strict();
 const PermissionApprovalSchema = z.object({ permissionDigest: z.string().regex(/^[a-f0-9]{64}$/u) }).strict();
+/** One version of one line in the lineage view of an extension family. */
+const ExtensionLineageNodeSchema = z.object({
+	revisionId: ExtensionRevisionIdSchema,
+	extensionId: ExtensionIdSchema,
+	label: z.string(),
+	parentRevisionId: ExtensionRevisionIdSchema.optional(),
+	origin: z.enum([
+		"authored",
+		"file",
+		"community",
+		"branch"
+	]),
+	createdAt: z.number().int().nonnegative(),
+	current: z.boolean(),
+	releaseNumbers: z.array(z.number().int().positive())
+}).strict();
+/** Every line of the family an extension belongs to: the original and every branch of a branch on this machine. */
+const ExtensionLineageSchema = z.object({ lines: z.array(z.object({
+	extensionId: ExtensionIdSchema,
+	displayName: z.string(),
+	branchOf: z.object({
+		extensionId: ExtensionIdSchema,
+		revisionId: ExtensionRevisionIdSchema
+	}).strict().optional(),
+	nodes: z.array(ExtensionLineageNodeSchema)
+}).strict()) }).strict();
+const DataChangeCountSchema = z.object({
+	added: z.number().int().nonnegative(),
+	overwritten: z.number().int().nonnegative(),
+	removed: z.number().int().nonnegative(),
+	unchanged: z.number().int().nonnegative()
+}).strict();
+/** Where a data migration takes data from. */
+const ExtensionDataSourceSchema = z.discriminatedUnion("kind", [
+	z.object({
+		kind: z.literal("extension"),
+		extensionId: ExtensionIdSchema
+	}).strict(),
+	z.object({
+		kind: z.literal("snapshot"),
+		snapshotId: z.string().min(1).max(80)
+	}).strict(),
+	z.object({
+		kind: z.literal("package"),
+		token: z.string().min(1).max(80)
+	}).strict()
+]);
+const ExtensionDataMigrationInputSchema = z.object({
+	source: ExtensionDataSourceSchema,
+	mode: z.enum(["overwrite", "replace"]),
+	/** Storage of a source agent goes to the mapped agent here; unmapped agents are skipped. */
+	agentMap: z.record(z.string(), AgentIdSchema).optional(),
+	/** Also move the host and agent configuration (never credentials) the same way. */
+	includeConfig: z.boolean().optional()
+}).strict();
+const ExtensionDataPreviewSchema = z.object({
+	diff: z.object({
+		storage: DataChangeCountSchema,
+		index: DataChangeCountSchema,
+		library: DataChangeCountSchema
+	}).strict(),
+	destructive: z.boolean(),
+	sourceDataVersion: z.number().int().positive(),
+	targetDataVersion: z.number().int().positive(),
+	needsMigration: z.boolean(),
+	/** Configuration fields that would change, when configuration moves too. */
+	config: z.object({
+		hostFields: z.array(z.string()),
+		agents: z.array(z.object({
+			agentId: AgentIdSchema,
+			fields: z.array(z.string())
+		}).strict())
+	}).strict().optional()
+}).strict();
+const ExtensionDataStateSchema = z.object({
+	dataVersion: z.number().int().positive(),
+	counts: z.object({
+		storage: z.number().int().nonnegative(),
+		index: z.number().int().nonnegative(),
+		library: z.number().int().nonnegative()
+	}).strict(),
+	snapshots: z.array(z.object({
+		id: z.string(),
+		reason: z.enum([
+			"switch",
+			"migration",
+			"manual"
+		]),
+		label: z.string(),
+		dataVersion: z.number().int().positive(),
+		byteSize: z.number().int().nonnegative(),
+		createdAt: z.number().int().nonnegative()
+	}).strict())
+}).strict();
+const ExtensionDataPackageInspectionSchema = z.object({
+	token: z.string(),
+	extensionId: z.string(),
+	displayName: z.string(),
+	dataVersion: z.number().int().positive(),
+	exportedAt: z.number().int().nonnegative(),
+	agents: z.array(z.object({
+		id: z.string(),
+		name: z.string()
+	}).strict()),
+	counts: z.object({
+		storage: z.number().int().nonnegative(),
+		index: z.number().int().nonnegative(),
+		library: z.number().int().nonnegative()
+	}).strict()
+}).strict();
+const AdministratorSchema = z.object({
+	connectionId: ConnectionIdSchema,
+	connectionName: z.string(),
+	platformUserId: z.string(),
+	identityId: PlatformIdentityIdSchema.optional(),
+	displayName: z.string(),
+	addedVia: z.enum(["console", "claim"]),
+	addedAt: z.number().int().nonnegative()
+}).strict();
 const extensionParam = z.object({ extensionId: ExtensionIdSchema }).strict();
 const dshPluginPackageParam = z.object({ packageId: DshPluginPackageIdSchema }).strict();
 const dshPluginEntryParam = z.object({ entryId: DshPluginEntryIdSchema }).strict();
@@ -3449,6 +5049,7 @@ const dshSettingsParam = z.object({ namespace: NonEmptyStringSchema }).strict();
 const dshCredentialParam = z.object({ ref: DshCredentialRefSchema }).strict();
 const llmProviderParam = z.object({ provider: NonEmptyStringSchema }).strict();
 const authoringTaskParam = z.object({ taskId: AuthoringTaskIdSchema }).strict();
+const subConversationParam = z.object({ conversationId: SubConversationIdSchema }).strict();
 const scheduledTaskParam = z.object({ taskId: ScheduledTaskIdSchema }).strict();
 const authoringAttemptParam = z.object({
 	taskId: AuthoringTaskIdSchema,
@@ -3484,6 +5085,174 @@ const encodeBinaryUpload = (input) => ({
 	}
 });
 const HostApiContracts = {
+	listCommands: defineContract({
+		method: "GET",
+		path: "/api/commands",
+		params: z.object({ channelId: ChannelIdSchema.optional() }).strict(),
+		request: NoRequestBodySchema,
+		response: z.object({
+			commands: z.array(CommandCatalogEntrySchema),
+			problems: z.array(z.string()),
+			/** Host-wide behavior: whether platform members without a grant are told so. */
+			settings: z.object({ unauthorizedFeedback: z.boolean() }).strict(),
+			/** Present when a channel was requested. */
+			channel: z.object({
+				kind: z.enum([
+					"internal",
+					"direct",
+					"group"
+				]),
+				/** The channel is an external group where commands must address the account. */
+				requiresMention: z.boolean(),
+				bareCommands: z.boolean()
+			}).strict().optional()
+		}).strict(),
+		error: HostApiErrorSchema
+	}),
+	executeCommand: defineContract({
+		method: "POST",
+		path: "/api/commands/execute",
+		params: EmptyParamsSchema,
+		request: z.object({
+			channelId: ChannelIdSchema,
+			text: z.string().min(1).max(16e3),
+			requestId: z.string().min(1).max(200)
+		}).strict(),
+		response: CommandExecutionRecordSchema,
+		error: HostApiErrorSchema,
+		invalidatesSnapshot: true
+	}),
+	getCommandExecution: defineContract({
+		method: "GET",
+		path: "/api/commands/executions/:executionId",
+		params: z.object({ executionId: z.string().min(1) }).strict(),
+		request: NoRequestBodySchema,
+		response: CommandExecutionRecordSchema,
+		error: HostApiErrorSchema
+	}),
+	setCommandPolicy: defineContract({
+		method: "PUT",
+		path: "/api/commands/policy",
+		params: EmptyParamsSchema,
+		request: z.object({
+			scope: z.union([z.literal("global"), ChannelIdSchema]),
+			name: z.string().min(1),
+			policy: CommandPolicySchema
+		}).strict(),
+		response: z.object({ saved: z.literal(true) }).strict(),
+		error: HostApiErrorSchema,
+		invalidatesSnapshot: true
+	}),
+	listCommandMembers: defineContract({
+		method: "GET",
+		path: "/api/commands/members/:channelId",
+		params: z.object({ channelId: ChannelIdSchema }).strict(),
+		request: NoRequestBodySchema,
+		response: z.object({ members: z.array(z.object({
+			identityId: PlatformIdentityIdSchema,
+			displayName: z.string(),
+			platformUserId: z.string(),
+			authorized: z.boolean()
+		}).strict()) }).strict(),
+		error: HostApiErrorSchema
+	}),
+	setCommandSettings: defineContract({
+		method: "PUT",
+		path: "/api/commands/settings",
+		params: EmptyParamsSchema,
+		request: z.object({ unauthorizedFeedback: z.boolean() }).strict(),
+		response: z.object({ saved: z.literal(true) }).strict(),
+		error: HostApiErrorSchema
+	}),
+	setCommandChannelSettings: defineContract({
+		method: "PUT",
+		path: "/api/commands/channel-settings",
+		params: EmptyParamsSchema,
+		request: z.object({
+			channelId: ChannelIdSchema,
+			bareCommands: z.boolean()
+		}).strict(),
+		response: z.object({ saved: z.literal(true) }).strict(),
+		error: HostApiErrorSchema,
+		invalidatesSnapshot: true
+	}),
+	setCommandGrant: defineContract({
+		method: "PUT",
+		path: "/api/commands/grants",
+		params: EmptyParamsSchema,
+		request: z.object({
+			channelId: ChannelIdSchema,
+			identityId: PlatformIdentityIdSchema,
+			enabled: z.boolean()
+		}).strict(),
+		response: z.object({ saved: z.literal(true) }).strict(),
+		error: HostApiErrorSchema,
+		invalidatesSnapshot: true
+	}),
+	queryLogs: defineContract({
+		method: "GET",
+		path: "/api/logs",
+		params: z.object({ query: z.string().max(32768).optional() }).strict(),
+		request: NoRequestBodySchema,
+		response: hostLogPageSchema,
+		error: HostApiErrorSchema
+	}),
+	getLog: defineContract({
+		method: "GET",
+		path: "/api/logs/:id",
+		params: z.object({ id: z.string().min(1).max(256) }).strict(),
+		request: NoRequestBodySchema,
+		response: z.object({ entry: hostLogEntrySchema }).strict(),
+		error: HostApiErrorSchema
+	}),
+	logSources: defineContract({
+		method: "GET",
+		path: "/api/logs/sources",
+		params: EmptyParamsSchema,
+		request: NoRequestBodySchema,
+		response: z.object({ sources: z.array(hostLogSourceSchema) }).strict(),
+		error: HostApiErrorSchema
+	}),
+	logStatus: defineContract({
+		method: "GET",
+		path: "/api/logs/status",
+		params: EmptyParamsSchema,
+		request: NoRequestBodySchema,
+		response: hostLogStatusSchema,
+		error: HostApiErrorSchema
+	}),
+	logSettings: defineContract({
+		method: "GET",
+		path: "/api/logs/settings",
+		params: EmptyParamsSchema,
+		request: NoRequestBodySchema,
+		response: hostLogSettingsSchema,
+		error: HostApiErrorSchema
+	}),
+	updateLogSettings: defineContract({
+		method: "PUT",
+		path: "/api/logs/settings",
+		params: EmptyParamsSchema,
+		request: hostLogSettingsSchema,
+		response: hostLogSettingsSchema,
+		error: HostApiErrorSchema
+	}),
+	startLogDebug: defineContract({
+		method: "POST",
+		path: "/api/logs/debug",
+		params: EmptyParamsSchema,
+		request: hostLogDebugRequestSchema,
+		response: z.object({ lease: hostLogDebugLeaseSchema }).strict(),
+		error: HostApiErrorSchema
+	}),
+	stopLogDebug: defineContract({
+		method: "DELETE",
+		path: "/api/logs/debug/:id",
+		params: z.object({ id: z.string().min(1).max(256) }).strict(),
+		request: NoRequestBodySchema,
+		response: z.object({ stopped: z.literal(true) }).strict(),
+		error: HostApiErrorSchema
+	}),
 	retryRuntimeCompatibility: defineContract({
 		method: "POST",
 		path: "/api/runtime/compatibility/retry",
@@ -3781,6 +5550,7 @@ const HostApiContracts = {
 			channelId: ChannelIdSchema,
 			agentId: AgentIdSchema,
 			triggerPolicy: TriggerPolicySchema,
+			paused: z.boolean().default(false),
 			processingFeedback: z.enum(["auto", "off"]).default("auto"),
 			localAgentMessages: z.enum(["observe", "trigger"]).optional(),
 			activityTriggerOverrides: ActivityTriggerOverridesSchema.default({}),
@@ -3838,20 +5608,56 @@ const HostApiContracts = {
 		}).strict(),
 		error: HostApiErrorSchema
 	}),
-	renameChannel: defineContract({
-		invalidatesSnapshot: true,
+	uploadChannelAsset: defineContract({
 		method: "POST",
-		path: "/api/channels/:channelId/display-name",
+		path: "/api/channels/:channelId/assets",
 		params: channelParam,
-		request: z.object({ displayName: z.string().trim().min(1).max(120) }).strict(),
+		request: BinaryUploadRequestSchema,
+		encodeRequest: (input) => ({
+			body: input.bytes,
+			headers: {
+				"content-type": "application/octet-stream",
+				"x-file-name": encodeURIComponent(input.fileName ?? "附件")
+			}
+		}),
 		response: z.object({
-			channelId: ChannelIdSchema,
-			displayName: z.string().trim().min(1).max(120)
+			assetId: AssetIdSchema,
+			mediaType: z.string().min(1),
+			byteSize: z.number().int().nonnegative(),
+			fileName: z.string().min(1).max(255),
+			partType: z.enum(["image", "file"])
 		}).strict(),
 		error: HostApiErrorSchema
 	}),
-	getChannelRuntime: defineContract({
-		method: "GET",
+	deleteChannelAsset: defineContract({
+		method: "DELETE",
+		path: "/api/channels/:channelId/assets/:assetId",
+		params: z.object({
+			channelId: ChannelIdSchema,
+			assetId: AssetIdSchema
+		}).strict(),
+		request: NoRequestBodySchema,
+		response: z.object({
+			assetId: AssetIdSchema,
+			revoked: z.literal(true)
+		}).strict(),
+		error: HostApiErrorSchema
+	}),
+	renameChannel: defineContract({
+		invalidatesSnapshot: true,
+		method: "POST",
+		path: "/api/channels/:channelId/display-name",
+		params: channelParam,
+		/** Empty selects the known platform name for an external channel. */
+		request: z.object({ displayName: z.string().trim().max(120) }).strict(),
+		response: z.object({
+			channelId: ChannelIdSchema,
+			displayName: z.string().trim().min(1).max(120)
+		}).strict(),
+		error: HostApiErrorSchema
+	}),
+	getChannelRuntime: defineContract({
+		method: "GET",
 		path: "/api/channels/:channelId/runtime",
 		params: channelParam,
 		request: NoRequestBodySchema,
@@ -3885,6 +5691,59 @@ const HostApiContracts = {
 		response: ChannelRuntimeContextSchema,
 		error: HostApiErrorSchema
 	}),
+	listSubConversations: defineContract({
+		method: "GET",
+		path: "/api/sub-conversations/channels/:channelId",
+		params: channelParam,
+		request: NoRequestBodySchema,
+		response: z.object({ items: z.array(SubConversationSchema) }).strict(),
+		error: HostApiErrorSchema
+	}),
+	getSubConversationRuntime: defineContract({
+		method: "GET",
+		path: "/api/sub-conversations/:conversationId/runtime",
+		params: subConversationParam,
+		request: NoRequestBodySchema,
+		response: z.object({
+			conversation: SubConversationSchema,
+			runtime: ChannelRuntimeProjectionSchema
+		}).strict(),
+		error: HostApiErrorSchema
+	}),
+	closeSubConversation: defineContract({
+		invalidatesSnapshot: true,
+		method: "POST",
+		path: "/api/sub-conversations/:conversationId/close",
+		params: subConversationParam,
+		request: z.object({}).strict(),
+		response: SubConversationSchema,
+		error: HostApiErrorSchema
+	}),
+	deleteSubConversation: defineContract({
+		invalidatesSnapshot: true,
+		method: "DELETE",
+		path: "/api/sub-conversations/:conversationId",
+		params: subConversationParam,
+		request: NoRequestBodySchema,
+		response: z.object({ deleted: z.literal(true) }).strict(),
+		error: HostApiErrorSchema
+	}),
+	getSubConversationSettings: defineContract({
+		method: "GET",
+		path: "/api/settings/sub-conversations",
+		params: EmptyParamsSchema,
+		request: NoRequestBodySchema,
+		response: SubConversationSettingsSchema,
+		error: HostApiErrorSchema
+	}),
+	updateSubConversationSettings: defineContract({
+		method: "PUT",
+		path: "/api/settings/sub-conversations",
+		params: EmptyParamsSchema,
+		request: SubConversationSettingsSchema,
+		response: SubConversationSettingsSchema,
+		error: HostApiErrorSchema
+	}),
 	getChannelRuntimeInput: defineContract({
 		method: "GET",
 		path: "/api/channels/:channelId/runtime/inputs/:messageId",
@@ -3915,7 +5774,9 @@ const HostApiContracts = {
 		path: "/api/channels/:channelId/prompt",
 		params: channelParam,
 		request: z.object({
+			kind: z.enum(["instructions", "notes"]),
 			document: PromptDocumentV1Schema,
+			/** Notes only; ignored for instructions. */
 			locked: z.boolean(),
 			/** The revision the edit started from; a newer stored revision rejects the save. */
 			expectedRevision: z.number().int().nonnegative()
@@ -3923,6 +5784,223 @@ const HostApiContracts = {
 		response: ChannelPromptViewSchema,
 		error: HostApiErrorSchema
 	}),
+	getProductUpdates: defineContract({
+		method: "GET",
+		path: "/api/product/updates",
+		params: EmptyParamsSchema,
+		request: NoRequestBodySchema,
+		response: ProductUpdateStatusSchema,
+		error: HostApiErrorSchema
+	}),
+	checkProductUpdates: defineContract({
+		method: "POST",
+		path: "/api/product/updates/check",
+		params: EmptyParamsSchema,
+		request: NoRequestBodySchema,
+		response: ProductUpdateStatusSchema,
+		error: HostApiErrorSchema
+	}),
+	updateProductUpdateSettings: defineContract({
+		method: "PUT",
+		path: "/api/product/updates/settings",
+		params: EmptyParamsSchema,
+		request: z.object({ autoCheck: z.boolean() }).strict(),
+		response: ProductUpdateStatusSchema,
+		error: HostApiErrorSchema
+	}),
+	getMessagePacingSettings: defineContract({
+		method: "GET",
+		path: "/api/settings/message-pacing",
+		params: EmptyParamsSchema,
+		request: NoRequestBodySchema,
+		response: MessagePacingSettingsSchema,
+		error: HostApiErrorSchema
+	}),
+	updateMessagePacingSettings: defineContract({
+		method: "PUT",
+		path: "/api/settings/message-pacing",
+		params: EmptyParamsSchema,
+		request: MessagePacingSettingsSchema,
+		response: MessagePacingSettingsSchema,
+		error: HostApiErrorSchema
+	}),
+	getUpgradeBackupSettings: defineContract({
+		method: "GET",
+		path: "/api/settings/upgrade-backup",
+		params: EmptyParamsSchema,
+		request: NoRequestBodySchema,
+		response: UpgradeBackupSettingsSchema,
+		error: HostApiErrorSchema
+	}),
+	updateUpgradeBackupSettings: defineContract({
+		method: "PUT",
+		path: "/api/settings/upgrade-backup",
+		params: EmptyParamsSchema,
+		request: z.object({
+			mode: UpgradeBackupModeSchema,
+			directory: z.string().trim().min(1).max(1024).optional()
+		}).strict(),
+		response: UpgradeBackupSettingsSchema,
+		error: HostApiErrorSchema
+	}),
+	getRetrievalStatus: defineContract({
+		method: "GET",
+		path: "/api/settings/retrieval",
+		params: EmptyParamsSchema,
+		request: NoRequestBodySchema,
+		response: RetrievalStatusSchema,
+		error: HostApiErrorSchema
+	}),
+	updateRetrievalMode: defineContract({
+		method: "PUT",
+		path: "/api/settings/retrieval",
+		params: EmptyParamsSchema,
+		request: z.object({ mode: RetrievalModeSchema }).strict(),
+		response: RetrievalStatusSchema,
+		error: HostApiErrorSchema
+	}),
+	downloadRetrievalModel: defineContract({
+		method: "POST",
+		path: "/api/settings/retrieval/model/download",
+		params: EmptyParamsSchema,
+		request: NoRequestBodySchema,
+		response: RetrievalStatusSchema,
+		error: HostApiErrorSchema
+	}),
+	removeRetrievalModel: defineContract({
+		method: "DELETE",
+		path: "/api/settings/retrieval/model",
+		params: EmptyParamsSchema,
+		request: NoRequestBodySchema,
+		response: RetrievalStatusSchema,
+		error: HostApiErrorSchema
+	}),
+	downloadCodeRunNode: defineContract({
+		invalidatesSnapshot: true,
+		method: "POST",
+		path: "/api/runtimes/code-run-node/download",
+		params: EmptyParamsSchema,
+		request: NoRequestBodySchema,
+		response: CodeRunAvailabilitySchema,
+		error: HostApiErrorSchema
+	}),
+	removeCodeRunNode: defineContract({
+		invalidatesSnapshot: true,
+		method: "DELETE",
+		path: "/api/runtimes/code-run-node",
+		params: EmptyParamsSchema,
+		request: NoRequestBodySchema,
+		response: CodeRunAvailabilitySchema,
+		error: HostApiErrorSchema
+	}),
+	downloadGithubCli: defineContract({
+		invalidatesSnapshot: true,
+		method: "POST",
+		path: "/api/runtimes/github-cli/download",
+		params: EmptyParamsSchema,
+		request: NoRequestBodySchema,
+		response: GithubCliAvailabilitySchema,
+		error: HostApiErrorSchema
+	}),
+	removeGithubCli: defineContract({
+		invalidatesSnapshot: true,
+		method: "DELETE",
+		path: "/api/runtimes/github-cli",
+		params: EmptyParamsSchema,
+		request: NoRequestBodySchema,
+		response: GithubCliAvailabilitySchema,
+		error: HostApiErrorSchema
+	}),
+	downloadVerificationBrowser: defineContract({
+		invalidatesSnapshot: true,
+		method: "POST",
+		path: "/api/runtimes/verification-browser/download",
+		params: EmptyParamsSchema,
+		request: NoRequestBodySchema,
+		response: VerificationBrowserAvailabilitySchema,
+		error: HostApiErrorSchema
+	}),
+	removeVerificationBrowser: defineContract({
+		invalidatesSnapshot: true,
+		method: "DELETE",
+		path: "/api/runtimes/verification-browser",
+		params: EmptyParamsSchema,
+		request: NoRequestBodySchema,
+		response: VerificationBrowserAvailabilitySchema,
+		error: HostApiErrorSchema
+	}),
+	getCommandAccounts: defineContract({
+		method: "GET",
+		path: "/api/settings/command-accounts",
+		params: EmptyParamsSchema,
+		request: NoRequestBodySchema,
+		response: CommandAccountsViewSchema,
+		error: HostApiErrorSchema
+	}),
+	addCommandAccount: defineContract({
+		invalidatesSnapshot: true,
+		method: "POST",
+		path: "/api/settings/command-accounts",
+		params: EmptyParamsSchema,
+		request: AddCommandAccountRequestSchema,
+		response: CommandAccountsViewSchema,
+		error: HostApiErrorSchema
+	}),
+	replaceCommandAccountToken: defineContract({
+		invalidatesSnapshot: true,
+		method: "PUT",
+		path: "/api/settings/command-accounts/:accountId",
+		params: z.object({ accountId: NonEmptyStringSchema.max(64) }).strict(),
+		request: AddCommandAccountRequestSchema,
+		response: CommandAccountsViewSchema,
+		error: HostApiErrorSchema
+	}),
+	removeCommandAccount: defineContract({
+		invalidatesSnapshot: true,
+		method: "DELETE",
+		path: "/api/settings/command-accounts/:accountId",
+		params: z.object({ accountId: NonEmptyStringSchema.max(64) }).strict(),
+		request: NoRequestBodySchema,
+		response: CommandAccountsViewSchema,
+		error: HostApiErrorSchema
+	}),
+	getChannelMemberNotes: defineContract({
+		method: "GET",
+		path: "/api/channels/:channelId/member-notes",
+		params: channelParam,
+		request: NoRequestBodySchema,
+		response: ChannelMemberNotesViewSchema,
+		error: HostApiErrorSchema
+	}),
+	updateChannelMemberNote: defineContract({
+		method: "PUT",
+		path: "/api/channels/:channelId/member-notes/:memberId",
+		params: z.object({
+			channelId: ChannelIdSchema,
+			memberId: ChannelMemberIdSchema
+		}).strict(),
+		/** An empty text forgets the member. */
+		request: z.object({ text: z.string().max(2e3) }).strict(),
+		response: ChannelMemberNotesViewSchema,
+		error: HostApiErrorSchema
+	}),
+	getChannelContextPolicy: defineContract({
+		method: "GET",
+		path: "/api/channels/:channelId/context-policy",
+		params: channelParam,
+		request: NoRequestBodySchema,
+		response: ChannelContextPolicyViewSchema,
+		error: HostApiErrorSchema
+	}),
+	updateChannelContextPolicy: defineContract({
+		method: "PUT",
+		path: "/api/channels/:channelId/context-policy",
+		params: channelParam,
+		/** `null` returns the channel to the defaults. */
+		request: z.object({ policy: ChannelContextPolicySchema.nullable() }).strict(),
+		response: ChannelContextPolicyViewSchema,
+		error: HostApiErrorSchema
+	}),
 	resetChannelContext: defineContract({
 		invalidatesSnapshot: true,
 		method: "POST",
@@ -4043,11 +6121,15 @@ const HostApiContracts = {
 		method: "POST",
 		path: "/api/connections/:connectionId/configuration",
 		params: connectionParam,
-		request: z.object({ configuration: z.record(z.string(), z.union([
-			z.string(),
-			z.number(),
-			z.boolean()
-		])) }).strict(),
+		request: z.object({
+			configuration: z.record(z.string(), z.union([
+				z.string(),
+				z.number(),
+				z.boolean()
+			])),
+			/** Omitted keys keep their value; null explicitly clears an optional credential. */
+			credentials: z.record(z.string().min(1), z.string().min(1).max(16384).nullable()).optional()
+		}).strict(),
 		response: z.object({
 			connectionId: ConnectionIdSchema,
 			configuration: z.record(z.string(), z.union([
@@ -4233,6 +6315,142 @@ const HostApiContracts = {
 		response: CommunityStatusSchema,
 		error: HostApiErrorSchema
 	}),
+	getCommunityFeedbackSettings: defineContract({
+		method: "GET",
+		path: "/api/community/feedback/settings",
+		params: EmptyParamsSchema,
+		request: NoRequestBodySchema,
+		response: CommunityFeedbackSettingsSchema,
+		error: HostApiErrorSchema
+	}),
+	updateCommunityFeedbackSettings: defineContract({
+		method: "PUT",
+		path: "/api/community/feedback/settings",
+		params: EmptyParamsSchema,
+		request: CommunityFeedbackSettingsUpdateSchema,
+		response: CommunityFeedbackSettingsSchema,
+		error: HostApiErrorSchema,
+		invalidatesSnapshot: true
+	}),
+	listCommunityFeedback: defineContract({
+		timeoutMs: 6e4,
+		method: "GET",
+		path: "/api/community/feedback",
+		params: z.object({ refresh: z.literal("1").optional() }).strict(),
+		request: NoRequestBodySchema,
+		response: CommunityFeedbackLocalListSchema,
+		error: HostApiErrorSchema
+	}),
+	getCommunityFeedback: defineContract({
+		timeoutMs: 6e4,
+		method: "GET",
+		path: "/api/community/feedback/items/:ref",
+		params: z.object({ ref: CommunityFeedbackRefSchema }).strict(),
+		request: NoRequestBodySchema,
+		response: CommunityFeedbackSchema,
+		error: HostApiErrorSchema
+	}),
+	createCommunityFeedbackDraft: defineContract({
+		method: "POST",
+		path: "/api/community/feedback/drafts",
+		params: EmptyParamsSchema,
+		request: CommunityFeedbackDraftInputSchema,
+		response: CommunityFeedbackDraftSchema,
+		error: HostApiErrorSchema,
+		invalidatesSnapshot: true
+	}),
+	updateCommunityFeedbackDraft: defineContract({
+		method: "PUT",
+		path: "/api/community/feedback/drafts/:draftId",
+		params: z.object({ draftId: CommunityFeedbackDraftIdSchema }).strict(),
+		request: CommunityFeedbackDraftUpdateSchema,
+		response: CommunityFeedbackDraftSchema,
+		error: HostApiErrorSchema,
+		invalidatesSnapshot: true
+	}),
+	sendCommunityFeedbackDraft: defineContract({
+		timeoutMs: 6e4,
+		method: "POST",
+		path: "/api/community/feedback/drafts/:draftId/send",
+		params: z.object({ draftId: CommunityFeedbackDraftIdSchema }).strict(),
+		request: z.object({ consent: z.boolean().default(false) }).strict(),
+		response: CommunityFeedbackDraftSchema,
+		error: HostApiErrorSchema,
+		invalidatesSnapshot: true
+	}),
+	discardCommunityFeedbackDraft: defineContract({
+		method: "DELETE",
+		path: "/api/community/feedback/drafts/:draftId",
+		params: z.object({ draftId: CommunityFeedbackDraftIdSchema }).strict(),
+		request: NoRequestBodySchema,
+		response: CommunityFeedbackDraftSchema,
+		error: HostApiErrorSchema,
+		invalidatesSnapshot: true
+	}),
+	previewCommunityFeedbackPayload: defineContract({
+		method: "GET",
+		path: "/api/community/feedback/drafts/:draftId/preview",
+		params: z.object({ draftId: CommunityFeedbackDraftIdSchema }).strict(),
+		request: NoRequestBodySchema,
+		response: CommunityFeedbackPayloadSchema,
+		error: HostApiErrorSchema
+	}),
+	getLastSentCommunityFeedbackPayload: defineContract({
+		method: "GET",
+		path: "/api/community/feedback/last-sent",
+		params: EmptyParamsSchema,
+		request: NoRequestBodySchema,
+		response: CommunityFeedbackLastPayloadSchema,
+		error: HostApiErrorSchema
+	}),
+	replyCommunityFeedback: defineContract({
+		method: "POST",
+		path: "/api/community/feedback/items/:ref/messages",
+		params: z.object({ ref: CommunityFeedbackRefSchema }).strict(),
+		request: z.object({ body: z.string().trim().min(1).max(4e3) }).strict(),
+		response: CommunityFeedbackSchema,
+		error: HostApiErrorSchema,
+		invalidatesSnapshot: true
+	}),
+	withdrawCommunityFeedback: defineContract({
+		method: "POST",
+		path: "/api/community/feedback/items/:ref/withdraw",
+		params: z.object({ ref: CommunityFeedbackRefSchema }).strict(),
+		request: CommunityFeedbackWithdrawSchema,
+		response: CommunityFeedbackSchema,
+		error: HostApiErrorSchema,
+		invalidatesSnapshot: true
+	}),
+	reopenCommunityFeedback: defineContract({
+		method: "POST",
+		path: "/api/community/feedback/items/:ref/reopen",
+		params: z.object({ ref: CommunityFeedbackRefSchema }).strict(),
+		request: CommunityFeedbackReopenSchema,
+		response: CommunityFeedbackSchema,
+		error: HostApiErrorSchema,
+		invalidatesSnapshot: true
+	}),
+	markCommunityFeedbackAffected: defineContract({
+		method: "POST",
+		path: "/api/community/feedback/items/:ref/affected",
+		params: z.object({ ref: CommunityFeedbackRefSchema }).strict(),
+		request: z.object({
+			affected: z.boolean().default(true),
+			consent: z.boolean().default(false)
+		}).strict(),
+		response: CommunityFeedbackSchema,
+		error: HostApiErrorSchema,
+		invalidatesSnapshot: true
+	}),
+	confirmCommunityFeedbackFixed: defineContract({
+		method: "POST",
+		path: "/api/community/feedback/items/:ref/confirm-fixed",
+		params: z.object({ ref: CommunityFeedbackRefSchema }).strict(),
+		request: z.object({}).strict(),
+		response: CommunityFeedbackSchema,
+		error: HostApiErrorSchema,
+		invalidatesSnapshot: true
+	}),
 	startCommunityLogin: defineContract({
 		method: "POST",
 		path: "/api/community/login",
@@ -4321,13 +6539,13 @@ const HostApiContracts = {
 		}).strict(),
 		error: HostApiErrorSchema
 	}),
-	listCommunityInstalled: defineContract({
-		timeoutMs: 3e4,
+	listCommunitySync: defineContract({
+		timeoutMs: 6e4,
 		method: "GET",
-		path: "/api/community/installed",
+		path: "/api/community/sync",
 		params: z.object({ refresh: z.enum(["1"]).optional() }).strict(),
 		request: NoRequestBodySchema,
-		response: CommunityInstalledSchema,
+		response: CommunitySyncSchema,
 		error: HostApiErrorSchema
 	}),
 	listCommunityMine: defineContract({
@@ -4389,6 +6607,7 @@ const HostApiContracts = {
 		}).strict(),
 		response: z.object({
 			releaseId: CommunityReleaseIdSchema,
+			releaseNumber: z.number().int().positive(),
 			reviewStatus: CommunityReviewStatusSchema,
 			pageUrl: z.string().url(),
 			reportUrl: z.string().url(),
@@ -4732,7 +6951,19 @@ const HostApiContracts = {
 		request: z.object({
 			episodeId: EpisodeIdSchema,
 			requestId: DynamicIdSchema,
-			pluginRunId: DynamicIdSchema.optional()
+			pluginRunId: DynamicIdSchema.optional(),
+			/**
+			* Why the run did not go ahead: the user declined it, or the page could not start one of its halves. A failed
+			* half is settled as a failed attempt (its Host is retracted and the agent hears about it), not as a decline.
+			*/
+			reason: z.enum([
+				"rejected",
+				"host-half-failed",
+				"client-half-failed"
+			]).optional(),
+			startedHere: z.boolean().optional(),
+			message: z.string().max(4e3).optional(),
+			stack: z.string().max(16e3).optional()
 		}).strict(),
 		response: z.object({ accepted: z.boolean() }).strict(),
 		error: HostApiErrorSchema
@@ -4867,23 +7098,15 @@ const HostApiContracts = {
 		method: "POST",
 		path: "/api/extensions/save-from-dynamic",
 		params: EmptyParamsSchema,
-		request: z.union([z.object({
+		request: z.object({
 			taskId: AuthoringTaskIdSchema,
+			/** The candidate the user saw; saving refuses when a newer one appeared since. */
 			attemptId: AuthoringAttemptIdSchema,
 			displayName: z.string().trim().min(1).max(80),
 			slug: z.string().trim().regex(/^[a-z0-9][a-z0-9-]{1,62}[a-z0-9]$/u),
 			description: z.string().max(500).default(""),
 			targetExtensionId: ExtensionIdSchema.optional()
-		}).strict(), z.object({
-			agentId: AgentIdSchema,
-			episodeId: EpisodeIdSchema,
-			pluginId: DynamicIdSchema,
-			packageId: DynamicIdSchema,
-			displayName: z.string().trim().min(1).max(80),
-			slug: z.string().trim().regex(/^[a-z0-9][a-z0-9-]{1,62}[a-z0-9]$/u),
-			description: z.string().max(500).default(""),
-			targetExtensionId: ExtensionIdSchema.optional()
-		}).strict()]),
+		}).strict(),
 		response: z.object({
 			extensionId: ExtensionIdSchema,
 			revisionId: ExtensionRevisionIdSchema,
@@ -5023,7 +7246,9 @@ const HostApiContracts = {
 			/** Approval of the host layer (browser permissions and `permissions.host`). */
 			permissionApproval: PermissionApprovalSchema.optional(),
 			/** Approval of expanded agent-layer capabilities for the agents that move to this Revision. */
-			agentPermissionApproval: PermissionApprovalSchema.optional()
+			agentPermissionApproval: PermissionApprovalSchema.optional(),
+			/** Data copy to put back first, when the target Revision only reads an older data version. */
+			restoreDataSnapshotId: z.string().min(1).max(80).optional()
 		}).strict(),
 		response: z.object({ installation: z.object({
 			extensionId: ExtensionIdSchema,
@@ -5141,6 +7366,19 @@ upTo: z.object({
 		}).strict(),
 		error: HostApiErrorSchema
 	}),
+	setChannelPaused: defineContract({
+		method: "POST",
+		path: "/api/channels/:channelId/pause",
+		params: channelParam,
+		request: z.object({ paused: z.boolean() }).strict(),
+		response: z.object({
+			paused: z.boolean(),
+			changed: z.boolean(),
+			stopped: z.boolean()
+		}).strict(),
+		error: HostApiErrorSchema,
+		invalidatesSnapshot: true
+	}),
 	resolveOutbound: defineContract({
 		method: "POST",
 		path: "/api/outbound/:outboundId/resolve",
@@ -5223,6 +7461,202 @@ upTo: z.object({
 		request: NoRequestBodySchema,
 		response: z.object({ deleted: z.literal(true) }).strict(),
 		error: HostApiErrorSchema
+	}),
+	getExtensionLineage: defineContract({
+		method: "GET",
+		path: "/api/extensions/:extensionId/lineage",
+		params: extensionParam,
+		request: NoRequestBodySchema,
+		response: ExtensionLineageSchema,
+		error: HostApiErrorSchema
+	}),
+	branchExtension: defineContract({
+		invalidatesSnapshot: true,
+		timeoutMs: 3e5,
+		method: "POST",
+		path: "/api/extensions/:extensionId/branch",
+		params: extensionParam,
+		request: z.object({
+			revisionId: ExtensionRevisionIdSchema,
+			name: z.string().trim().min(1).max(80),
+			slug: z.string().trim().regex(/^[a-z0-9][a-z0-9-]{1,62}[a-z0-9]$/u).optional(),
+			copyData: z.boolean()
+		}).strict(),
+		response: z.object({
+			extensionId: ExtensionIdSchema,
+			revisionId: ExtensionRevisionIdSchema
+		}).strict(),
+		error: HostApiErrorSchema
+	}),
+	rollbackExtension: defineContract({
+		invalidatesSnapshot: true,
+		timeoutMs: 3e5,
+		method: "POST",
+		path: "/api/extensions/:extensionId/revert",
+		params: extensionParam,
+		request: NoRequestBodySchema,
+		response: z.object({ message: z.string() }).strict(),
+		error: HostApiErrorSchema
+	}),
+	getExtensionData: defineContract({
+		method: "GET",
+		path: "/api/extensions/:extensionId/data",
+		params: extensionParam,
+		request: NoRequestBodySchema,
+		response: ExtensionDataStateSchema,
+		error: HostApiErrorSchema
+	}),
+	previewExtensionDataMigration: defineContract({
+		timeoutMs: 6e4,
+		method: "POST",
+		path: "/api/extensions/:extensionId/data/preview",
+		params: extensionParam,
+		request: ExtensionDataMigrationInputSchema,
+		response: ExtensionDataPreviewSchema,
+		error: HostApiErrorSchema
+	}),
+	migrateExtensionData: defineContract({
+		invalidatesSnapshot: true,
+		timeoutMs: 3e5,
+		method: "POST",
+		path: "/api/extensions/:extensionId/data/migrate",
+		params: extensionParam,
+		request: ExtensionDataMigrationInputSchema,
+		response: z.object({
+			snapshotId: z.string(),
+			preview: ExtensionDataPreviewSchema
+		}).strict(),
+		error: HostApiErrorSchema
+	}),
+	exportExtensionData: defineContract({
+		method: "GET",
+		timeoutMs: 3e5,
+		path: "/api/extensions/:extensionId/data/export",
+		params: extensionParam,
+		request: NoRequestBodySchema,
+		responseFormat: "bytes",
+		response: z.instanceof(Uint8Array),
+		error: HostApiErrorSchema
+	}),
+	/** The same package with the host and agent configuration; secrets are left out. */
+	exportExtensionDataWithConfig: defineContract({
+		method: "GET",
+		timeoutMs: 3e5,
+		path: "/api/extensions/:extensionId/data/export-config",
+		params: extensionParam,
+		request: NoRequestBodySchema,
+		responseFormat: "bytes",
+		response: z.instanceof(Uint8Array),
+		error: HostApiErrorSchema
+	}),
+	createExtensionDataSnapshot: defineContract({
+		method: "POST",
+		path: "/api/extensions/:extensionId/data/snapshots",
+		params: extensionParam,
+		request: z.object({ label: z.string().trim().min(1).max(80) }).strict(),
+		response: z.object({ snapshotId: z.string() }).strict(),
+		error: HostApiErrorSchema
+	}),
+	inspectExtensionDataPackage: defineContract({
+		timeoutMs: 3e5,
+		method: "POST",
+		path: "/api/extensions/data/inspect",
+		params: EmptyParamsSchema,
+		request: BinaryUploadRequestSchema,
+		encodeRequest: encodeBinaryUpload,
+		response: ExtensionDataPackageInspectionSchema,
+		error: HostApiErrorSchema
+	}),
+	listExtensionRequests: defineContract({
+		method: "GET",
+		path: "/api/extension-requests",
+		params: EmptyParamsSchema,
+		request: NoRequestBodySchema,
+		response: z.object({ requests: z.array(ExtensionRequestSchema) }).strict(),
+		error: HostApiErrorSchema
+	}),
+	approveExtensionRequest: defineContract({
+		invalidatesSnapshot: true,
+		timeoutMs: 3e5,
+		method: "POST",
+		path: "/api/extension-requests/:number/approve",
+		params: z.object({ number: z.coerce.number().int().positive() }).strict(),
+		request: NoRequestBodySchema,
+		response: z.object({ message: z.string() }).strict(),
+		error: HostApiErrorSchema
+	}),
+	rejectExtensionRequest: defineContract({
+		method: "POST",
+		path: "/api/extension-requests/:number/reject",
+		params: z.object({ number: z.coerce.number().int().positive() }).strict(),
+		request: z.object({ reason: z.string().trim().max(500).optional() }).strict(),
+		response: z.object({ ok: z.literal(true) }).strict(),
+		error: HostApiErrorSchema
+	}),
+	listAdministrators: defineContract({
+		method: "GET",
+		path: "/api/administrators",
+		params: EmptyParamsSchema,
+		request: NoRequestBodySchema,
+		response: z.object({ administrators: z.array(AdministratorSchema) }).strict(),
+		error: HostApiErrorSchema
+	}),
+	addAdministrator: defineContract({
+		method: "POST",
+		path: "/api/administrators",
+		params: EmptyParamsSchema,
+		request: z.object({ identityId: PlatformIdentityIdSchema }).strict(),
+		response: AdministratorSchema,
+		error: HostApiErrorSchema
+	}),
+	removeAdministrator: defineContract({
+		method: "POST",
+		path: "/api/administrators/remove",
+		params: EmptyParamsSchema,
+		request: z.object({
+			connectionId: ConnectionIdSchema,
+			platformUserId: z.string().min(1)
+		}).strict(),
+		response: z.object({ ok: z.literal(true) }).strict(),
+		error: HostApiErrorSchema
+	}),
+	createAdministratorClaimCode: defineContract({
+		method: "POST",
+		path: "/api/administrators/claim-code",
+		params: EmptyParamsSchema,
+		request: NoRequestBodySchema,
+		response: z.object({
+			code: z.string(),
+			expiresAt: z.number().int().nonnegative()
+		}).strict(),
+		error: HostApiErrorSchema
+	}),
+	dismissCommunityRelease: defineContract({
+		method: "POST",
+		path: "/api/community/sync/:extensionId/dismiss",
+		params: extensionParam,
+		request: z.object({ releaseId: CommunityReleaseIdSchema.nullable() }).strict(),
+		response: z.object({ ok: z.literal(true) }).strict(),
+		error: HostApiErrorSchema
+	}),
+	updateFromCommunity: defineContract({
+		invalidatesSnapshot: true,
+		timeoutMs: 3e5,
+		method: "POST",
+		path: "/api/community/sync/:extensionId/update",
+		params: extensionParam,
+		request: NoRequestBodySchema,
+		response: z.object({ message: z.string() }).strict(),
+		error: HostApiErrorSchema
+	}),
+	archiveAuthoringTask: defineContract({
+		invalidatesSnapshot: true,
+		method: "POST",
+		path: "/api/authoring/tasks/:taskId/archive",
+		params: z.object({ taskId: AuthoringTaskIdSchema }).strict(),
+		request: NoRequestBodySchema,
+		response: z.object({ ok: z.literal(true) }).strict(),
+		error: HostApiErrorSchema
 	})
 };
 const pathParameterPattern = /:([A-Za-z][A-Za-z0-9]*)/gu;
@@ -5252,6 +7686,6 @@ function buildHostApiPath(name, input) {
 	return buildValidatedHostApiPath(HostApiContracts[name], input);
 }
 //#endregion
-export { ACTIVITY_MAX_BUCKETS, ACTIVITY_MAX_WINDOW_MS, ACTIVITY_MIN_BUCKET_MS, ActivityQuerySchema, AdapterActivityKeySchema, AdmissionIdSchema, AgentAppearanceSchema, AgentIdSchema, AgentRevisionChangedFieldSchema, AgentRevisionHistorySchema, AgentRevisionIdSchema, AssetIdSchema, AttentionItemSchema, AttentionListSchema, AuthoringAttemptIdSchema, AuthoringTaskIdSchema, CHANNEL_UNREAD_COUNT_CAP, COMMUNITY_EXTENSION_SORTS, COMMUNITY_LISTING_LIMITS, COMMUNITY_OFFICIAL_HANDLE, COMMUNITY_PERSONA_AVATAR_MAX_BYTES, COMMUNITY_PERSONA_AVATAR_TYPES, COMMUNITY_PERSONA_MAX_LENGTH, COMMUNITY_RATING_BADGES, COMMUNITY_RATING_BADGE_LIMIT, COMMUNITY_RATING_DIMENSIONS, COMMUNITY_RATING_DIMENSION_LABELS, COMMUNITY_REVIEWER_NAME, COMMUNITY_REVIEW_DIMENSION_LABELS, COMMUNITY_REVIEW_STATUSES, CONFIG_SCHEMA_MAX_BYTES, ChannelActivitySeriesSchema, ChannelActivitySummarySchema, ChannelEventIdSchema, ChannelFactSseDataSchema, ChannelFactSseItemSchema, ChannelIdSchema, ChannelMemberIdSchema, ChannelPendingContextSchema, ChannelPromptViewSchema, ChannelRuntimeCacheSampleSchema, ChannelRuntimeCacheSchema, ChannelRuntimeContextSchema, ChannelRuntimeInputSchema, ChannelRuntimeOccupancySchema, ChannelRuntimePerformanceSampleSchema, ChannelRuntimePerformanceSchema, ChannelRuntimePhaseSchema, ChannelRuntimeProjectionSchema, ChannelRuntimeSseDataSchema, ChannelRuntimeStepSchema, ChannelRuntimeToolSchema, ChannelRuntimeTurnSchema, ChannelRuntimeUsageSchema, ClientNotificationFeedResponseSchema, ClientNotificationSchema, CommunityAccountSchema, CommunityEndpointSchema, CommunityEnvironmentSchema, CommunityExtensionDetailSchema, CommunityExtensionSortSchema, CommunityExtensionSummarySchema, CommunityInstalledItemSchema, CommunityInstalledSchema, CommunityListingInputSchema, CommunityMyExtensionSchema, CommunityMyPersonaSchema, CommunityMyPersonasSchema, CommunityPermissionItemSchema, CommunityPersonaDetailSchema, CommunityPersonaIdSchema, CommunityPersonaReviewStatusSchema, CommunityPersonaRevisionIdSchema, CommunityPersonaSummarySchema, CommunityRatingSchema, CommunityReleaseIdSchema, CommunityReleaseSchema, CommunityReviewReportSchema, CommunityReviewStatusSchema, CommunitySourceSchema, CommunityStatusSchema, ConfigSchemaDocumentSchema, ConfigSchemaMetaSchema, ConfigSchemaNodeSchema, ConnectionEventIdSchema, ConnectionIdSchema, ConnectionPanelRoleSchema, ConnectionTestResultSchema, DshCredentialRefSchema, DshCredentialViewSchema, DshCredentialsChangedSseDataSchema, DshNxtHostUiSchema, DshPluginCatalogEntrySchema, DshPluginEntryIdSchema, DshPluginOperationSseDataSchema, DshPluginPackageIdSchema, DshSettingsChangedSseDataSchema, DshSettingsMutationRequestSchema, DshSettingsNamespaceSchema, DshSettingsPathOperationSchema, DshSettingsPathSchema, DynamicChangedSseDataSchema, DynamicClientApprovalPolicySchema, EMPTY_CONFIG_SCHEMA, EMPTY_EXTENSION_PERMISSIONS, EMPTY_EXTENSION_UI_CONTRIBUTIONS, EXTENSION_CONTEXT_DYNAMIC_MAX_CHARS, EXTENSION_CONTEXT_STATIC_MAX_CHARS, EXTENSION_DATA_HOOK_PERMISSIONS, EXTENSION_INBOUND_HOOK_MAX_TIMEOUT_MS, EXTENSION_JOB_MAX_RUNTIME, EXTENSION_LLM_MAX_CALLS_PER_TURN, EXTENSION_LLM_MAX_OUTPUT_TOKENS, EXTENSION_PROVIDES, EXTENSION_SDK_LEVEL, EXTENSION_STORAGE_DEFAULT_QUOTA_BYTES, EXTENSION_STORAGE_MAX_QUOTA_BYTES, EXTENSION_STORAGE_SCOPES, EpisodeHandoffIdSchema, EpisodeIdSchema, ExtensionActivationTransitionSchema, ExtensionCapabilitiesSchema, ExtensionConfigDeclarationSchema, ExtensionContextContributionSchema, ExtensionDeclaredJobSchema, ExtensionIdSchema, ExtensionImportInspectionSchema, ExtensionInboundHookCapabilitySchema, ExtensionJobsCapabilitySchema, ExtensionLayeredConfigSchema, ExtensionLlmCapabilitySchema, ExtensionMcpCapabilitySchema, ExtensionMcpServerNameSchema, ExtensionMcpServerSchema, ExtensionMcpValueSchema, ExtensionNetworkCapabilitySchema, ExtensionNetworkDomainSchema, ExtensionPanelAnchorSchema, ExtensionPanelDeclarationSchema, ExtensionPermissionRequirementSchema, ExtensionPermissionsSchema, ExtensionPlatformCapabilitySchema, ExtensionProvideSchema, ExtensionRequiresSchema, ExtensionRevisionIdSchema, ExtensionStorageCapabilitySchema, ExtensionStorageScopeSchema, ExtensionUiContributionsSchema, HOST_PAGE_DEFAULT_RAIL_ORDER, HOST_UI_KIT_COMPONENT_NAMES, HostApiContracts, HostApiErrorSchema, HostConnectionEventSchema, HostIconNameSchema, HostLayerCapabilitiesSchema, HostPageContributionSchema, HostPageIconSchema, HostSnapshotMessageSchema, HostSnapshotSchema, HostSseEventSchema, HostSseStatusDataSchema, HostSyncCursorSchema, HostUiKitComponentNameSchema, HostUiNavigationGroupSchema, HostUiNavigationItemSchema, HostUiNavigationModelSchema, HostUiNetworkOriginSchema, HostUiOwnerSchema, HostUiPageEntrySchema, HostUiPageGeometryEvidenceSchema, HostUiPageInstanceIdSchema, HostUiPagePreferencesSchema, HostUiPermissionDeclarationSchema, HostUiPermissionSchema, HostUpgradeSummarySchema, INSECURE_HTTP_MANAGEMENT_PAIR_PROOF_PREFIX, ImageUnderstandingPolicyApiSchema, InsecureHttpManagementChallengeResponseSchema, InstanceDescriptorSchema, InstanceDescriptorWireSchema, JsonValueSchema, LlmDiscoveredModelSchema, LlmModelInputModalitiesSchema, LlmProviderCredentialSchema, LlmProviderModelSchema, LlmProviderSettingsSchema, LlmProviderTestResultSchema, LlmProviderViewSchema, LogicalMessageIdSchema, MANAGEMENT_PAIR_PROOF_PREFIX, ManagementChallengeResponseSchema, ManagementDeviceEnrollmentRequestSchema, ManagementDeviceEnrollmentResponseSchema, ManagementDeviceIdSchema, ManagementDeviceViewSchema, ManagementSessionRequestSchema, ManagementSessionResponseSchema, McpServerFormSchema, MessagePartSchema, MessagePartsSchema, MessageRendererContributionSchema, NonEmptyMessagePartsSchema, NotificationEventKeySchema, NotificationSettingsViewSchema, OutboundIntentIdSchema, PANEL_ANCHOR_LAYER, PROMPT_DOCUMENT_MAX_PLAIN_TEXT_LENGTH, PROMPT_DOCUMENT_MAX_REFERENCES, PanelContributionSchema, PanelDensitySchema, PhysicalDeliveryIdSchema, PlatformIdentityIdSchema, PlatformUserListResponseSchema, PromptDocumentV1Schema, PromptSegmentSchema, RICH_EXTENSION_MAX_BYTES, RichExtensionSchema, RichKindSchema, RichTargetUrlSchema, RuntimeCompatibilityDiagnosticSchema, ScheduledTaskIdSchema, ScheduledTaskSchema, ServerInstanceIdSchema, TestBarkNotificationRequestSchema, ToolViewContributionSchema, ToolViewDensitySchema, UpdateNotificationSettingsRequestSchema, WorkTreeOrderSchema, activityDurationMs, agentPermissionDeclaration, buildHostApiContractPath, buildHostApiPath, communityPersonaReviewLabel, communityPublisherLabel, communityReviewLabel, configDescription, configFieldKind, configFields, configSchema, configSecretKeys, extensionCapabilitiesExpand, hostLayerAsCapabilities, hostPageRailOrder, hostPermissionDeclaration, insecureHttpManagementPairProofMessage, managementPairProofMessage, mcpSecretFields, messagePartAssetId, messagePartAssetIds, messagePartsSearchText, normalizePromptDocument, parseConfigValue, parseJsonValue, parseMessageParts, promptDocumentFromText, promptDocumentPlainText, richPartContextText, summarizeExtensionCapabilities, validateConfigValue };
+export { ACTIVITY_MAX_BUCKETS, ACTIVITY_MAX_WINDOW_MS, ACTIVITY_MIN_BUCKET_MS, ActivityQuerySchema, AdapterActivityKeySchema, AddCommandAccountRequestSchema, AdministratorSchema, AdmissionIdSchema, AgentAppearanceSchema, AgentIdSchema, AgentRevisionChangedFieldSchema, AgentRevisionHistorySchema, AgentRevisionIdSchema, AssetIdSchema, AttentionItemSchema, AttentionListSchema, AuthoringAttemptIdSchema, AuthoringTaskIdSchema, CHANNEL_COMPOSER_MAX_ATTACHMENTS, CHANNEL_COMPOSER_MAX_BYTES, CHANNEL_UNREAD_COUNT_CAP, COMMAND_DEFAULT_TIMEOUT_SECONDS, COMMAND_MAX_PROGRESS_REPLIES, COMMAND_MAX_TIMEOUT_SECONDS, COMMUNITY_EXTENSION_SORTS, COMMUNITY_FEEDBACK_STATUSES, COMMUNITY_FEEDBACK_STATUS_LABELS, COMMUNITY_LISTING_LIMITS, COMMUNITY_OFFICIAL_HANDLE, COMMUNITY_PERSONA_AVATAR_MAX_BYTES, COMMUNITY_PERSONA_AVATAR_TYPES, COMMUNITY_PERSONA_MAX_LENGTH, COMMUNITY_RATING_BADGES, COMMUNITY_RATING_BADGE_LIMIT, COMMUNITY_RATING_DIMENSIONS, COMMUNITY_RATING_DIMENSION_LABELS, COMMUNITY_REVIEWER_NAME, COMMUNITY_REVIEW_DIMENSION_LABELS, COMMUNITY_REVIEW_STATUSES, CONFIG_SCHEMA_MAX_BYTES, ChannelActivitySeriesSchema, ChannelActivitySummarySchema, ChannelContextPolicySchema, ChannelContextPolicyViewSchema, ChannelEventIdSchema, ChannelFactSseDataSchema, ChannelFactSseItemSchema, ChannelIdSchema, ChannelMemberIdSchema, ChannelMemberNotesViewSchema, ChannelMemoryActivitySchema, ChannelPendingContextSchema, ChannelPromptViewSchema, ChannelRuntimeCacheSampleSchema, ChannelRuntimeCacheSchema, ChannelRuntimeContextSchema, ChannelRuntimeInputSchema, ChannelRuntimeOccupancySchema, ChannelRuntimePerformanceSampleSchema, ChannelRuntimePerformanceSchema, ChannelRuntimePhaseSchema, ChannelRuntimeProjectionSchema, ChannelRuntimeSseDataSchema, ChannelRuntimeStepSchema, ChannelRuntimeToolSchema, ChannelRuntimeTurnSchema, ChannelRuntimeUsageSchema, ClientNotificationFeedResponseSchema, ClientNotificationSchema, CodeRunAvailabilitySchema, CommandAccountSchema, CommandAccountServiceSchema, CommandAccountUsageSchema, CommandAccountsViewSchema, CommandCatalogEntrySchema, CommandDefinitionSchema, CommandExecutionIdentitySchema, CommandExecutionRecordSchema, CommandParameterSchema, CommandPermissionSchema, CommandPolicySchema, CommandReplySchema, CommandResultSchema, CommunityAccountSchema, CommunityEndpointSchema, CommunityEnvironmentSchema, CommunityExtensionDetailSchema, CommunityExtensionSortSchema, CommunityExtensionSummarySchema, CommunityFeedbackAffectedSchema, CommunityFeedbackChangesSchema, CommunityFeedbackConfirmSchema, CommunityFeedbackCreateSchema, CommunityFeedbackDiagnosticEntrySchema, CommunityFeedbackDiagnosticsSchema, CommunityFeedbackDigestSchema, CommunityFeedbackDraftIdSchema, CommunityFeedbackDraftInputSchema, CommunityFeedbackDraftSchema, CommunityFeedbackDraftStateSchema, CommunityFeedbackDraftUpdateSchema, CommunityFeedbackEventDataSchema, CommunityFeedbackEventSchema, CommunityFeedbackExcerptSchema, CommunityFeedbackExtensionDiagnosticSchema, CommunityFeedbackIdSchema, CommunityFeedbackItemSchema, CommunityFeedbackKindSchema, CommunityFeedbackLabelsSchema, CommunityFeedbackLastPayloadSchema, CommunityFeedbackLinkSchema, CommunityFeedbackListSchema, CommunityFeedbackLocalListSchema, CommunityFeedbackMessageInputSchema, CommunityFeedbackMessageSchema, CommunityFeedbackPayloadSchema, CommunityFeedbackRefSchema, CommunityFeedbackReopenSchema, CommunityFeedbackSchema, CommunityFeedbackSettingsSchema, CommunityFeedbackSettingsUpdateSchema, CommunityFeedbackSnapshotSchema, CommunityFeedbackStatusSchema, CommunityFeedbackSummarySchema, CommunityFeedbackSupplementSchema, CommunityFeedbackTargetSchema, CommunityFeedbackTransitionSchema, CommunityFeedbackVisibilitySchema, CommunityFeedbackWithdrawSchema, CommunityInstalledItemSchema, CommunityInstalledSchema, CommunityListingInputSchema, CommunityMyExtensionSchema, CommunityMyPersonaSchema, CommunityMyPersonasSchema, CommunityPermissionItemSchema, CommunityPersonaDetailSchema, CommunityPersonaIdSchema, CommunityPersonaReviewStatusSchema, CommunityPersonaRevisionIdSchema, CommunityPersonaSummarySchema, CommunityRatingSchema, CommunityReleaseIdSchema, CommunityReleaseSchema, CommunityReviewReportSchema, CommunityReviewStatusSchema, CommunitySourceSchema, CommunityStatusSchema, CommunitySyncItemSchema, CommunitySyncSchema, ConfigSchemaDocumentSchema, ConfigSchemaMetaSchema, ConfigSchemaNodeSchema, ConnectionEventIdSchema, ConnectionIdSchema, ConnectionPanelRoleSchema, ConnectionTestResultSchema, DEFAULT_CHANNEL_CONTEXT_POLICY, DEFAULT_MESSAGE_PACING, DEFAULT_SUB_CONVERSATION_RETENTION, DshCredentialRefSchema, DshCredentialViewSchema, DshCredentialsChangedSseDataSchema, DshNxtHostUiSchema, DshPluginCatalogEntrySchema, DshPluginEntryIdSchema, DshPluginOperationSseDataSchema, DshPluginPackageIdSchema, DshSettingsChangedSseDataSchema, DshSettingsMutationRequestSchema, DshSettingsNamespaceSchema, DshSettingsPathOperationSchema, DshSettingsPathSchema, DynamicChangedSseDataSchema, DynamicClientApprovalPolicySchema, EMPTY_CONFIG_SCHEMA, EMPTY_EXTENSION_PERMISSIONS, EMPTY_EXTENSION_UI_CONTRIBUTIONS, EXTENSION_ASSET_LIBRARY_DEFAULT_QUOTA_BYTES, EXTENSION_ASSET_LIBRARY_MAX_QUOTA_BYTES, EXTENSION_CONTEXT_DYNAMIC_MAX_CHARS, EXTENSION_CONTEXT_STATIC_MAX_CHARS, EXTENSION_DATA_HOOK_PERMISSIONS, EXTENSION_GOVERNANCE_SDK_LEVEL, EXTENSION_INBOUND_HOOK_MAX_TIMEOUT_MS, EXTENSION_INDEX_MAX_FILTERS, EXTENSION_INDEX_MAX_TEXT_FIELDS, EXTENSION_JOB_MAX_RUNTIME, EXTENSION_LLM_MAX_CALLS_PER_TURN, EXTENSION_LLM_MAX_OUTPUT_TOKENS, EXTENSION_MODEL_MAX_CALLS_PER_MINUTE, EXTENSION_PROVIDES, EXTENSION_SDK_BASE_LEVEL, EXTENSION_SDK_LEVEL, EXTENSION_SDK_RELEASES, EXTENSION_STORAGE_DEFAULT_QUOTA_BYTES, EXTENSION_STORAGE_MAX_QUOTA_BYTES, EXTENSION_STORAGE_SCOPES, EpisodeHandoffIdSchema, EpisodeIdSchema, ExtensionActivationTransitionSchema, ExtensionAssetLibraryCapabilitySchema, ExtensionAssetsCapabilitySchema, ExtensionCapabilitiesSchema, ExtensionConfigDeclarationSchema, ExtensionContextContributionSchema, ExtensionDataMigrationInputSchema, ExtensionDataPackageInspectionSchema, ExtensionDataPreviewSchema, ExtensionDataSourceSchema, ExtensionDataStateSchema, ExtensionDeclaredJobSchema, ExtensionIdSchema, ExtensionImportInspectionSchema, ExtensionInboundHookCapabilitySchema, ExtensionIndexCapabilitySchema, ExtensionIndexCollectionSchema, ExtensionJobsCapabilitySchema, ExtensionLayeredConfigSchema, ExtensionLineageNodeSchema, ExtensionLineageSchema, ExtensionLlmCapabilitySchema, ExtensionMcpCapabilitySchema, ExtensionMcpServerNameSchema, ExtensionMcpServerSchema, ExtensionMcpValueSchema, ExtensionModelsCapabilitySchema, ExtensionNetworkCapabilitySchema, ExtensionNetworkDomainSchema, ExtensionPanelAnchorSchema, ExtensionPanelDeclarationSchema, ExtensionPermissionRequirementSchema, ExtensionPermissionsSchema, ExtensionPlatformCapabilitySchema, ExtensionProvideSchema, ExtensionRequestSchema, ExtensionRequiresSchema, ExtensionRevisionIdSchema, ExtensionStorageCapabilitySchema, ExtensionStorageScopeSchema, ExtensionUiContributionsSchema, GithubCliAvailabilitySchema, HOST_PAGE_DEFAULT_RAIL_ORDER, HOST_UI_KIT_COMPONENT_NAMES, HostApiContracts, HostApiErrorSchema, HostConnectionEventSchema, HostIconNameSchema, HostLayerCapabilitiesSchema, HostPageContributionSchema, HostPageIconSchema, HostSnapshotMessageSchema, HostSnapshotSchema, HostSseEventSchema, HostSseStatusDataSchema, HostSyncCursorSchema, HostUiKitComponentNameSchema, HostUiNavigationGroupSchema, HostUiNavigationItemSchema, HostUiNavigationModelSchema, HostUiNetworkOriginSchema, HostUiOwnerSchema, HostUiPageEntrySchema, HostUiPageGeometryEvidenceSchema, HostUiPageInstanceIdSchema, HostUiPagePreferencesSchema, HostUiPermissionDeclarationSchema, HostUiPermissionSchema, HostUpgradeSummarySchema, INSECURE_HTTP_MANAGEMENT_PAIR_PROOF_PREFIX, ImageUnderstandingPolicyApiSchema, InsecureHttpManagementChallengeResponseSchema, InstanceDescriptorSchema, InstanceDescriptorWireSchema, JsonValueSchema, LlmDiscoveredModelSchema, LlmModelInputModalitiesSchema, LlmProviderCredentialSchema, LlmProviderModelSchema, LlmProviderSettingsSchema, LlmProviderTestResultSchema, LlmProviderViewSchema, LocalGithubLoginSchema, LogicalMessageIdSchema, MANAGEMENT_PAIR_PROOF_PREFIX, ManagementChallengeResponseSchema, ManagementDeviceEnrollmentRequestSchema, ManagementDeviceEnrollmentResponseSchema, ManagementDeviceIdSchema, ManagementDeviceViewSchema, ManagementSessionRequestSchema, ManagementSessionResponseSchema, McpServerFormSchema, MessageDeliverySummarySchema, MessagePacingSchema, MessagePacingSettingsSchema, MessagePartSchema, MessagePartsSchema, MessageRendererContributionSchema, NonEmptyMessagePartsSchema, NotificationEventKeySchema, NotificationSettingsViewSchema, OutboundIntentIdSchema, PANEL_ANCHOR_LAYER, PROMPT_DOCUMENT_MAX_PLAIN_TEXT_LENGTH, PROMPT_DOCUMENT_MAX_REFERENCES, PanelContributionSchema, PanelDensitySchema, PhysicalDeliveryIdSchema, PlatformIdentityIdSchema, PlatformUserListResponseSchema, ProductUpdateStatusSchema, PromptDocumentV1Schema, PromptSegmentSchema, RICH_EXTENSION_MAX_BYTES, RetrievalModeSchema, RetrievalStatusSchema, RichExtensionSchema, RichKindSchema, RichTargetUrlSchema, RuntimeCompatibilityDiagnosticSchema, ScheduledTaskIdSchema, ScheduledTaskSchema, ServerInstanceIdSchema, SubConversationIdSchema, SubConversationRetentionSchema, SubConversationSchema, SubConversationSettingsSchema, TestBarkNotificationRequestSchema, ToolViewContributionSchema, ToolViewDensitySchema, UpdateNotificationSettingsRequestSchema, UpgradeBackupModeSchema, UpgradeBackupSettingsSchema, VerificationBrowserAvailabilitySchema, WorkTreeOrderSchema, activityDurationMs, agentPermissionDeclaration, buildHostApiContractPath, buildHostApiPath, commandNameOf, commandUsage, communityPersonaReviewLabel, communityPublisherLabel, communityReviewLabel, configDescription, configFieldKind, configFields, configSchema, configSecretKeys, extensionCapabilitiesExpand, extensionSdkVersion, formatLogMessage, hostLayerAsCapabilities, hostLogDebugLeaseSchema, hostLogDebugRequestSchema, hostLogEntrySchema, hostLogLevelSchema, hostLogPageSchema, hostLogQuerySchema, hostLogScopeSchema, hostLogSettingsSchema, hostLogSettingsUpdateSchema, hostLogSourceKindSchema, hostLogSourceSchema, hostLogStatusSchema, hostLogStreamEventSchema, hostPageRailOrder, hostPermissionDeclaration, insecureHttpManagementPairProofMessage, managementPairProofMessage, mcpSecretFields, messagePartAssetId, messagePartAssetIds, messagePartImageAssetIds, messagePartsSearchText, normalizePromptDocument, parseCommandArguments, parseConfigValue, parseJsonValue, parseMessageParts, promptDocumentFromText, promptDocumentPlainText, recognizeCommand, requiredExtensionSdkLevel, richPartContextText, summarizeExtensionCapabilities, tokenizeCommand, undeliveredCommandReplies, validateConfigValue };
 
 //# sourceMappingURL=index.mjs.map