@senguoyun/dsh-arkme 0.1.82 → 0.1.83

package/lib/{persistent-runtime-DV9Hme-U.js → persistent-runtime-B6vPAaiG.js}

@@ -389,7 +389,7 @@ function object$8(value) {
 function keys(value, allowed) {
 	if (Object.keys(value).some((key) => !allowed.includes(key))) fail$1();
 }
-function text$11(value, max) {
+function text$12(value, max) {
 	if (typeof value !== "string" || value.length > max) fail$1();
 }
 function integer$6(value) {
@@ -415,7 +415,7 @@ function parseArrangementBoardCachePages(value) {
 			const board = object$8(page.board);
 			keys(board, ["supported", "version"]);
 			if (typeof board.supported !== "boolean") fail$1();
-			text$11(board.version, 1024);
+			text$12(board.version, 1024);
 		}
 		const refs = /* @__PURE__ */ new Set();
 		for (const rawItem of page.items) {
@@ -436,13 +436,13 @@ function parseArrangementBoardCachePages(value) {
 			]);
 			if (item.status !== column || typeof item.reminderEnabled !== "boolean" || typeof item.arrangementRef !== "string" || !/^arkme-arrangement-v1\.[A-Za-z0-9_-]{43}$/.test(item.arrangementRef) || refs.has(item.arrangementRef)) fail$1();
 			refs.add(item.arrangementRef);
-			text$11(item.title, 2e4);
-			text$11(item.description, 2e5);
-			text$11(item.reminderState, 256);
+			text$12(item.title, 2e4);
+			text$12(item.description, 2e5);
+			text$12(item.reminderState, 256);
 			integer$6(item.createdAtMillis);
 			integer$6(item.updatedAtMillis);
 			for (const key of ["dueAtMillis", "remindAtMillis"]) if (item[key] !== void 0) integer$6(item[key]);
-			if (item.recognitionState !== void 0) text$11(item.recognitionState, 256);
+			if (item.recognitionState !== void 0) text$12(item.recognitionState, 256);
 			if (item.creationSource !== void 0) {
 				const source = object$8(item.creationSource);
 				keys(source, [
@@ -459,7 +459,7 @@ function parseArrangementBoardCachePages(value) {
 				for (const rawSource of source.items) {
 					const entry = object$8(rawSource);
 					keys(entry, ["text", "createdAtMillis"]);
-					text$11(entry.text, 2e5);
+					text$12(entry.text, 2e5);
 					if (entry.createdAtMillis !== void 0) integer$6(entry.createdAtMillis);
 				}
 			}
@@ -2024,7 +2024,11 @@ var ServiceRuntime = class {
 		try {
 			return await this.post(this.config.intelligentBaseUrl, path, body, session.accessToken, [200], signal, true, requestOptions());
 		} catch (error) {
-			if (!(error instanceof ArkmePluginError) || !["auth-http-401", "auth-http-403"].includes(error.code)) throw error;
+			if (!(error instanceof ArkmePluginError) || ![
+				"auth-http-401",
+				"auth-http-403",
+				"invalid_access_token"
+			].includes(error.code)) throw error;
 			session = await this.refreshAccessToken(session);
 			return await this.post(this.config.intelligentBaseUrl, path, body, session.accessToken, [200], signal, true, requestOptions());
 		}
@@ -2049,6 +2053,180 @@ var ServiceRuntime = class {
 	}
 };
 //#endregion
+//#region src/ai-points.ts
+function pointsUnits(value) {
+	if (!/^(?:0|[1-9]\d*)(?:\.\d{1,7})?$/.test(value)) throw new TypeError("Invalid exact AI points");
+	const [whole = "0", fraction = ""] = value.split(".");
+	const units = BigInt(whole) * 10000000n + BigInt(fraction.padEnd(7, "0"));
+	if (units > 9223372036854775807n) throw new TypeError("AI points exceed accounting range");
+	return units;
+}
+/** Existing recharge values retain their nano-CNY meaning: ¥1 = 100 points. */
+function nanoCnyToPoints(value) {
+	if (!/^(?:0|[1-9]\d*)$/.test(value)) throw new TypeError("Invalid nano-CNY");
+	const units = BigInt(value);
+	const whole = units / 10000000n;
+	const fraction = (units % 10000000n).toString().padStart(7, "0").replace(/0+$/, "");
+	return fraction ? `${whole}.${fraction}` : whole.toString();
+}
+/** The server pages whole operations. Call-level charges remain the only facts. */
+function groupPointsConsumption(items) {
+	const groups = /* @__PURE__ */ new Map();
+	for (const item of items) {
+		const key = item.businessCode === "agent" && item.operationUid ? `agent:${item.operationUid}` : `request:${item.requestUid}`;
+		const calls = groups.get(key) ?? [];
+		calls.push(item);
+		groups.set(key, calls);
+	}
+	return [...groups].map(([key, calls]) => ({
+		key,
+		calls,
+		chargedPoints: nanoCnyToPoints(calls.reduce((sum, call) => sum + pointsUnits(call.chargedPoints), 0n).toString())
+	}));
+}
+//#endregion
+//#region src/services/ai-points-service.ts
+function invalid$12() {
+	throw new ArkmePluginError("ai-points-contract-invalid", "积分数据暂时无法确认，请重试", true, 502);
+}
+function points(value) {
+	if (typeof value !== "string") return invalid$12();
+	try {
+		pointsUnits(value);
+	} catch {
+		return invalid$12();
+	}
+	return value;
+}
+function timestamp$1(value) {
+	if (typeof value !== "number" || !Number.isSafeInteger(value) || value < 0) return invalid$12();
+	return value;
+}
+function text$11(value) {
+	if (typeof value !== "string" || !value.trim()) return invalid$12();
+	return value;
+}
+function integerString(value) {
+	if (typeof value !== "string" || !/^(?:0|[1-9]\d*)$/.test(value)) return invalid$12();
+	return value;
+}
+function unit(raw) {
+	if (raw.unit !== "ai_points") invalid$12();
+}
+function parseAiPointsAccount(raw, accountScope) {
+	unit(raw);
+	if (raw.points_per_cny !== 100 || !Array.isArray(raw.grants)) return invalid$12();
+	const result = {
+		accountScope,
+		unit: "ai_points",
+		availablePoints: points(raw.available_points),
+		reservedPoints: points(raw.reserved_points),
+		grantedPoints: points(raw.granted_points),
+		purchasedPoints: points(raw.purchased_points),
+		observedAt: timestamp$1(raw.observed_at),
+		grants: raw.grants.map((value) => {
+			const row = objectValue$2(value);
+			return {
+				source: text$11(row.source),
+				availablePoints: points(row.available_points),
+				expiresAt: timestamp$1(row.expires_at)
+			};
+		})
+	};
+	if (pointsUnits(result.availablePoints) !== pointsUnits(result.grantedPoints) + pointsUnits(result.purchasedPoints) || result.grants.reduce((total, grant) => total + pointsUnits(grant.availablePoints), 0n) !== pointsUnits(result.grantedPoints)) return invalid$12();
+	return result;
+}
+function parseAiPointsPage(raw, accountScope, month) {
+	unit(raw);
+	if (raw.month !== month || !Array.isArray(raw.items)) return invalid$12();
+	const nextBeforeId = raw.next_before_id === "" ? "" : integerString(raw.next_before_id);
+	const result = {
+		accountScope,
+		unit: "ai_points",
+		month,
+		chargedPoints: points(raw.charged_points),
+		nextBeforeId,
+		items: raw.items.map((value) => {
+			const row = objectValue$2(value), tokens = objectValue$2(row.tokens);
+			const chargedPoints = points(row.charged_points), grantedPoints = points(row.granted_points), purchasedPoints = points(row.purchased_points);
+			if (pointsUnits(chargedPoints) <= 0n || pointsUnits(chargedPoints) !== pointsUnits(grantedPoints) + pointsUnits(purchasedPoints)) return invalid$12();
+			const modelPoints = points(row.model_points);
+			if (!Array.isArray(row.services) || row.services.length > 16) return invalid$12();
+			const services = row.services.map((value) => {
+				const service = objectValue$2(value);
+				const quantity = integerString(service.quantity), chargedPoints = points(service.charged_points);
+				if (quantity === "0" || pointsUnits(chargedPoints) === 0n) return invalid$12();
+				return {
+					code: text$11(service.code),
+					quantity,
+					chargedPoints
+				};
+			});
+			if (new Set(services.map((service) => service.code)).size !== services.length || pointsUnits(modelPoints) + services.reduce((sum, service) => sum + pointsUnits(service.chargedPoints), 0n) !== pointsUnits(chargedPoints)) return invalid$12();
+			if (typeof row.business_code !== "string") return invalid$12();
+			return {
+				operationUid: typeof row.operation_uid === "string" ? row.operation_uid : "",
+				requestUid: text$11(row.request_uid),
+				businessCode: row.business_code,
+				model: text$11(row.model),
+				chargedPoints,
+				modelPoints,
+				services,
+				grantedPoints,
+				purchasedPoints,
+				createdAt: timestamp$1(row.created_at),
+				completedAt: timestamp$1(row.completed_at),
+				tokens: {
+					cacheHitInput: integerString(tokens.cache_hit_input),
+					cacheMissInput: integerString(tokens.cache_miss_input),
+					output: integerString(tokens.output)
+				}
+			};
+		})
+	};
+	if (new Set(result.items.map((item) => item.requestUid)).size !== result.items.length || groupPointsConsumption(result.items).length > 20) return invalid$12();
+	return result;
+}
+/** One owner for UI, SDK and Tools. It never reads raw usage telemetry. */
+var AiPointsService = class {
+	runtime;
+	constructor(runtime) {
+		this.runtime = runtime;
+	}
+	async session(expectedScope) {
+		const session = await this.runtime.requireSession();
+		const scope = `${this.runtime.config.environment}:${session.userId}`;
+		if (expectedScope !== void 0 && expectedScope !== scope) throw new ArkmePluginError("ai-points-account-changed", "账号已切换，请重新读取积分", false, 409);
+		return {
+			session,
+			scope
+		};
+	}
+	async account(expectedScope, signal) {
+		const { session, scope } = await this.session(expectedScope);
+		const raw = await this.runtime.authenticatedIntelligentPost("/api/v1/managed-ai/points/query", {}, session, signal, {
+			lane: "interactive-read",
+			bypassCache: true
+		});
+		await this.session(scope);
+		return parseAiPointsAccount(raw, scope);
+	}
+	async consumption(query, expectedScope, signal) {
+		if (!/^\d{4}-(?:0[1-9]|1[0-2])$/.test(query.month) || query.beforeId !== void 0 && !/^[1-9]\d*$/.test(query.beforeId)) throw new ArkmePluginError("ai-points-query-invalid", "请选择有效月份", false, 400);
+		const { session, scope } = await this.session(expectedScope);
+		const raw = await this.runtime.authenticatedIntelligentPost("/api/v1/managed-ai/points/consumption/query", {
+			month: query.month,
+			before_id: query.beforeId ?? "",
+			limit: 20
+		}, session, signal, {
+			lane: "interactive-read",
+			bypassCache: true
+		});
+		await this.session(scope);
+		return parseAiPointsPage(raw, scope, query.month);
+	}
+};
+//#endregion
 //#region src/self-role-avatar-store.ts
 const MAX_SELF_ROLE_AVATAR_BYTES = 8 * 1024 * 1024;
 const PREFIX = "arkme-self-role-image-v1.";
@@ -3147,6 +3325,13 @@ function errorCode$1(status, body) {
 	const providerCode = typeof providerError?.code === "string" ? providerError.code.toLowerCase() : "";
 	if (status === 401 || status === 403) return "AUTH";
 	if (status === 402 || providerCode.includes("balance") || providerCode.includes("quota")) return "QUOTA";
+	if (status === 409 && [
+		"operation_closed",
+		"operation_limit",
+		"operation_conflict"
+	].includes(providerCode)) return "OPERATION_ENDED";
+	if (providerCode === "unsupported_model") return "UNKNOWN_MODEL";
+	if (status === 409 && providerCode === "request_in_progress") return "REQUEST_IN_PROGRESS";
 	if (status === 408 || status === 504) return "TIMEOUT";
 	if (status === 429) return "RATE_LIMIT";
 	if (status === 400 || status === 413 || status === 422) return "INVALID_REQUEST";
@@ -3618,6 +3803,7 @@ var ManagedAiTransport = class {
 			const imageAttachments = requestImageAttachments(request);
 			assertImageRequestWithinCapability(imageAttachments, capability);
 			const bearer = await this.options.resolveBearer();
+			const operationUid = this.options.prepareOperation?.(request, bearer);
 			const imageCapability = capability.image;
 			for (let dispatchAttempt = 0;; dispatchAttempt++) {
 				let resolvedImageBytes = 0;
@@ -3634,6 +3820,7 @@ var ManagedAiTransport = class {
 					method: "POST",
 					headers: {
 						Authorization: `Bearer ${bearer}`,
+						...operationUid === void 0 ? {} : { "X-Arkme-Turn-ID": operationUid },
 						Accept: "text/event-stream",
 						"Content-Type": "application/json",
 						...attributionHeaders(),
@@ -3893,7 +4080,7 @@ const ARKME_MANAGED_CATALOG_MAX_STALE_MS = 5 * ARKME_MANAGED_CATALOG_TTL_MS;
 const ARKME_MANAGED_CATALOG_TIMEOUT_MS = 1e4;
 const ARKME_MANAGED_MAXIMUM_IMAGE_PIXELS = 4e7;
 const ARKME_MANAGED_MAXIMUM_REQUEST_IMAGE_BYTES = 1 << 30;
-const ARKME_INSUFFICIENT_BALANCE_MESSAGE = "Arkme AI 余额不足，请前往 Arkme 设置中的余额充值后重试";
+const ARKME_INSUFFICIENT_BALANCE_MESSAGE = "AI 额度不足，请充值后继续";
 const ARKME_LOGIN_MESSAGE = "请先登录或重新登录 Arkme 后再使用托管模型";
 const ARKME_AUTH_FAILURE_CODES = /* @__PURE__ */ new Set([
 	"login-required",
@@ -3928,6 +4115,14 @@ function managedAiFailureFacts(error) {
 	};
 }
 function managedAiLocalizedFailure(facts) {
+	if (facts.code === "OPERATION_ENDED") return {
+		code: facts.code,
+		message: "本轮任务已结束，请发送新消息继续"
+	};
+	if (facts.code === "REQUEST_IN_PROGRESS") return {
+		code: facts.code,
+		message: "已有 AI 请求正在完成，请等待结果后重试"
+	};
 	if (facts.status === 402 || ["QUOTA", "INSUFFICIENT_BALANCE"].includes(facts.code)) return {
 		code: "INSUFFICIENT_BALANCE",
 		message: ARKME_INSUFFICIENT_BALANCE_MESSAGE
@@ -4271,6 +4466,21 @@ function parseReasoning(value) {
 		defaultEffort: ReasoningEffortId(defaultEffort)
 	};
 }
+function modelPointPriceDescription(value) {
+	const price = asRecord(value);
+	if (!price) return "计费信息暂时无法读取，实际按用量扣积分";
+	const read = (key) => {
+		const v = price[key];
+		if (typeof v !== "string") throw new LlmError("模型积分报价无效", "MALFORMED_RESPONSE");
+		try {
+			pointsUnits(v);
+		} catch {
+			throw new LlmError("模型积分报价无效", "MALFORMED_RESPONSE");
+		}
+		return v;
+	};
+	return `每 1,000 Token：输入 ${read("cache_miss_input_per_thousand")} 积分，缓存输入 ${read("cache_hit_input_per_thousand")} 积分，输出 ${read("output_per_thousand")} 积分。已含服务费，实际按用量扣分。`;
+}
 function parseManagedCatalog(payload) {
 	const envelope = asRecord(payload);
 	if (envelope?.code !== 200) {
@@ -4298,6 +4508,7 @@ function parseManagedCatalog(payload) {
 			return {
 				id,
 				name: requiredCatalogText(item, "display_name", "显示名称"),
+				description: modelPointPriceDescription(item.point_pricing),
 				contextWindow,
 				maxTokens: defaultMaxTokens
 			};
@@ -4358,7 +4569,7 @@ var ManagedModelCatalog = class {
 	canUseLastGood() {
 		return this.hasRemoteSnapshot && Date.now() - this.refreshedAt < ARKME_MANAGED_CATALOG_MAX_STALE_MS;
 	}
-	async fetchCatalog(signal) {
+	async fetchCatalog(signal, resolveModel) {
 		const controller = new AbortController();
 		let timedOut = false;
 		const abortFromCaller = () => {
@@ -4380,7 +4591,7 @@ var ManagedModelCatalog = class {
 					Authorization: `Bearer ${bearer}`,
 					"Content-Type": "application/json"
 				},
-				body: "{}",
+				body: JSON.stringify(resolveModel === void 0 ? {} : { resolve_model: resolveModel }),
 				signal: controller.signal
 			});
 			if (!response.ok) {
@@ -4398,12 +4609,19 @@ var ManagedModelCatalog = class {
 				throw new LlmError("Arkme 模型目录返回异常", "MALFORMED_RESPONSE", { cause: error });
 			}
 			const snapshot = parseManagedCatalog(payload);
-			this.connectionSnapshot = managedConnection(this.baseUrl, snapshot.models);
-			this.modelIds = new Set(snapshot.models.map((model) => model.id));
-			this.capabilitySnapshot = snapshot.capabilities;
-			this.reasoningSnapshot = snapshot.reasoning;
-			this.hasRemoteSnapshot = true;
-			this.refreshedAt = Date.now();
+			if (resolveModel !== void 0) {
+				if (snapshot.models.length !== 1 || snapshot.models[0]?.id !== resolveModel) throw new LlmError("原回合模型信息无效", "UNKNOWN_MODEL");
+				this.connectionSnapshot = managedConnection(this.baseUrl, [...this.connectionSnapshot.models.filter((item) => item.id !== resolveModel), ...snapshot.models]);
+				for (const [key, value] of snapshot.capabilities) this.capabilitySnapshot.set(key, value);
+				for (const [key, value] of snapshot.reasoning) this.reasoningSnapshot.set(key, value);
+			} else {
+				this.connectionSnapshot = managedConnection(this.baseUrl, snapshot.models);
+				this.modelIds = new Set(snapshot.models.map((model) => model.id));
+				this.capabilitySnapshot = snapshot.capabilities;
+				this.reasoningSnapshot = snapshot.reasoning;
+				this.hasRemoteSnapshot = true;
+				this.refreshedAt = Date.now();
+			}
 		} catch (error) {
 			if (signal?.aborted === true) throw localizeManagedAiError(new LlmError("Arkme 模型目录请求已取消", "ABORTED", { cause: error }));
 			if (timedOut) throw localizeManagedAiError(new LlmError("Arkme 模型目录请求超时", "TIMEOUT", { cause: error }));
@@ -4433,15 +4651,29 @@ var ManagedModelCatalog = class {
 	}
 	async ensureModel(model, signal) {
 		const known = this.modelIds.has(model);
-		if (this.isFresh()) return;
-		try {
+		if (!this.isFresh()) try {
 			await this.refresh(signal);
 		} catch (error) {
 			if (signal?.aborted === true || !this.canUseLastGood() || !known) throw error;
 		}
+		if (!this.modelIds.has(model)) try {
+			await this.fetchCatalog(signal, model);
+		} catch (error) {
+			if (signal?.aborted === true) throw error;
+			const facts = managedAiFailureFacts(error);
+			if ((facts.status ?? 0) >= 500 || [
+				"TRANSPORT",
+				"TIMEOUT",
+				"AUTH"
+			].includes(facts.code)) throw error;
+			throw new LlmError("原回合模型已不可用，请重新选择模型", "UNKNOWN_MODEL", { cause: error });
+		}
+	}
+	isListed(model) {
+		return this.modelIds.has(model);
 	}
 	assertModel(model) {
-		if (!this.modelIds.has(model)) throw new LlmError(`当前 Arkme 托管服务不支持模型“${model}”，请重新选择模型`, "UNKNOWN_MODEL");
+		if (!this.capabilitySnapshot.has(model)) throw new LlmError(`当前 Arkme 托管服务不支持模型“${model}”，请重新选择模型`, "UNKNOWN_MODEL");
 	}
 };
 var ManagedAiLlmAdapter = class extends LlmAdapter {
@@ -4466,7 +4698,7 @@ var ManagedAiLlmAdapter = class extends LlmAdapter {
 	async listModels(provider) {
 		assertManagedProvider(provider);
 		await this.catalog.refreshForListing();
-		return (await this.delegate.listModels(provider)).map((model) => ({
+		return (await this.delegate.listModels(provider)).filter((model) => this.catalog.isListed(model.id)).map((model) => ({
 			...model,
 			inputModalities: this.catalog.capability(model.id).inputModalities
 		}));
@@ -4511,7 +4743,8 @@ function createManagedAiLlmAdapter(options) {
 		resolveAttachmentReader: options.resolveAttachmentReader ?? (() => void 0),
 		fetchImpl,
 		resolveBearer: async () => await resolveBearer(options.credentialOwner),
-		resolveAnonymousUserId
+		resolveAnonymousUserId,
+		...options.prepareOperation === void 0 ? {} : { prepareOperation: options.prepareOperation }
 	}));
 }
 function registerManagedAiProvider(ctx, options) {
@@ -36218,18 +36451,14 @@ var HttpArkmeBillingGateway = class {
 		return new ArkmePluginError(error.code, error.message, retryable, error.httpStatus, { cause: error });
 	}
 	async quota(signal) {
-		const data = objectValue$2(await this.post("intelligent", "/api/v1/managed-ai/balance/query", {}, "interactive-read", signal));
-		const currency = stringValue$2(data.currency).trim();
-		if (currency !== "CNY") throw new ArkmePluginError("billing-contract-invalid", "余额接口币种无效", true, 502);
-		const availableNanoCny = nanoCny(data.available_nano_cny, "available_nano_cny");
-		const totalNanoCny = nanoCny(data.total_nano_cny, "total_nano_cny");
-		const reservedNanoCny = nanoCny(data.reserved_nano_cny, "reserved_nano_cny");
-		if (BigInt(availableNanoCny) + BigInt(reservedNanoCny) !== BigInt(totalNanoCny)) throw new ArkmePluginError("billing-contract-invalid", "余额接口金额不一致", true, 502);
+		const account = parseAiPointsAccount(objectValue$2(await this.post("intelligent", "/api/v1/managed-ai/points/query", {}, "interactive-read", signal)), "");
+		const availableNanoCny = pointsUnits(account.availablePoints);
+		const reservedNanoCny = pointsUnits(account.reservedPoints);
 		return {
-			availableNanoCny,
-			totalNanoCny,
-			reservedNanoCny,
-			currency
+			availableNanoCny: String(availableNanoCny),
+			totalNanoCny: String(availableNanoCny + reservedNanoCny),
+			reservedNanoCny: String(reservedNanoCny),
+			currency: "CNY"
 		};
 	}
 	async products(signal) {
@@ -36855,6 +37084,7 @@ function arkoModelOptionFromData(value) {
 		displayName,
 		provider,
 		description,
+		costDescription: stringValue$2(data.cost_description),
 		recommended: booleanValue$14(data.recommended),
 		selected: booleanValue$14(data.selected)
 	};
@@ -36866,7 +37096,7 @@ function arkoModelCatalogFromData(data) {
 	const options = listValue$26(data.items).map(arkoModelOptionFromData);
 	const routeKeys = new Set(options.map((option) => option.routeKey));
 	const selected = options.filter((option) => option.selected);
-	if (selectionSource !== "default" && selectionSource !== "personal" || options.length === 0 || options.length > 16 || routeKeys.size !== options.length || !routeKeys.has(defaultRouteKey) || !routeKeys.has(effectiveRouteKey) || selected.length !== 1 || selected[0]?.routeKey !== effectiveRouteKey) throw new ArkmePluginError("arko-model-contract-invalid", "Arko 模型目录响应无效", true, 502);
+	if (selectionSource !== "default" && selectionSource !== "personal" && selectionSource !== "unavailable" || options.length === 0 || options.length > 256 || routeKeys.size !== options.length || !routeKeys.has(defaultRouteKey) || (selectionSource === "unavailable" ? routeKeys.has(effectiveRouteKey) || selected.length !== 0 : !routeKeys.has(effectiveRouteKey) || selected.length !== 1 || selected[0]?.routeKey !== effectiveRouteKey)) throw new ArkmePluginError("arko-model-contract-invalid", "Arko 模型目录响应无效", true, 502);
 	return {
 		defaultRouteKey,
 		effectiveRouteKey,
@@ -37053,8 +37283,7 @@ var ArkoService = class {
 		let modelRouteKey = options.modelRouteKey?.trim() ?? "";
 		if (hasContinuationRun && modelRouteKey !== "") throw new ArkmePluginError("arko-continuation-model-invalid", "继续 Arko 任务时不能切换模型", false);
 		if (!hasContinuationRun && modelRouteKey === "") try {
-			const catalog = await this.arkoModelCatalog(options.signal);
-			if (catalog.options.length > 1) modelRouteKey = catalog.effectiveRouteKey;
+			modelRouteKey = (await this.arkoModelCatalog(options.signal)).effectiveRouteKey;
 		} catch {}
 		if (modelRouteKey !== "" && (modelRouteKey.length > 128 || !ARKO_MODEL_ROUTE_PATTERN.test(modelRouteKey))) throw new ArkmePluginError("arko-model-route-invalid", "请选择有效的 Arko 模型", false);
 		const body = {
@@ -47108,6 +47337,23 @@ function integer$1(value) {
 	const parsed = typeof value === "number" ? value : Number(value);
 	return Number.isSafeInteger(parsed) ? parsed : 0;
 }
+/** The tree can be centered on the child while its parent lives outside the topic. */
+function projectOwnedRecordParent(response, openedRecordUid) {
+	const data = object$3(response);
+	if (openedRecordUid === "" || text$2(data.record_uid) !== openedRecordUid || text$2(data.root_record_uid) === "") throw new Error("记录延展树与当前快记不匹配");
+	let parentUid = text$2(data.parent_record_uid);
+	if (data.parent_record_uid === void 0) parentUid = text$2((Array.isArray(data.edges) ? data.edges : []).map(object$3).find((edge) => text$2(edge.child_record_uid) === openedRecordUid && (edge.status === void 0 || integer$1(edge.status) === 1))?.parent_record_uid);
+	if (parentUid === "" || parentUid === openedRecordUid) return void 0;
+	const record = (Array.isArray(data.records) ? data.records : []).map(object$3).find((record) => text$2(record.record_uid) === parentUid);
+	return {
+		recordUid: parentUid,
+		parentRecordUid: "",
+		level: 0,
+		record: record ?? {},
+		createdAtMillis: 0,
+		protectedContent: record === void 0 || integer$1(record.content_access_state) !== 1 || record.status !== void 0 && integer$1(record.status) !== 1
+	};
+}
 function parseNode(value, visiting, budget) {
 	const raw = object$3(value);
 	const recordUid = text$2(raw.record_uid);
@@ -51779,12 +52025,66 @@ var ChatService = class {
 		};
 	}
 	/** Personal and topic notes share the record-owned tree, including replies outside the original topic. */
+	async ownedRecordParentFromTree(data, recordUid, session, signal) {
+		const parent = projectOwnedRecordParent(data, recordUid);
+		if (parent === void 0) return void 0;
+		const owner = recordOwnerId(parent.record.owner_user_id);
+		if (parent.protectedContent || owner !== 0 && owner !== session.userId || arkmePrivacyLockedRecord(parent.record) || this.privacy !== void 0 && (await this.privacy.lockedRecordUids(session, signal)).has(parent.recordUid)) return {
+			itemUid: parent.recordUid,
+			senderName: "",
+			title: "",
+			textContent: "该延展源暂不可用"
+		};
+		const hydration = await this.media.hydrateRecordMediaPage([parent.record], session, signal);
+		const item = this.record.recordTimelineItemFromRaw(parent.record, session.userId, {
+			displayItems: hydration.displayItemsByRecordUid.get(parent.recordUid) ?? [],
+			mediaUnavailable: hydration.unavailableRecordUids.has(parent.recordUid)
+		});
+		return {
+			itemUid: parent.recordUid,
+			senderName: item.senderName,
+			title: item.title,
+			textContent: item.textContent,
+			textFormat: item.textFormat ?? "plain",
+			sendAtMillis: item.sendAtMillis,
+			...owner === 0 ? {} : { recordOwnerUserId: owner },
+			...item.contentBlocks === void 0 ? {} : { contentBlocks: item.contentBlocks }
+		};
+	}
+	/** Lightweight visible-row enrichment; never reads an entire topic before showing it. */
+	async sourceMessageExtensionParent(sourceRef, actionRef, options = {}) {
+		const session = await this.runtime.requireSession();
+		const source = await this.source.openSourceRef(sourceRef.trim(), session.userId);
+		const reference = await this.openMessageActionRef(actionRef, session.userId, source);
+		if (reference.sourceKind !== "record" || ![
+			"send_to_self",
+			"default_category",
+			"topic"
+		].includes(source.kind)) throw new ArkmePluginError("record-extension-source-invalid", "当前来源不支持读取个人延展源", false, 403);
+		const data = await this.runtime.authenticatedPost("/api/v1/records/extensions/tree", { record_uid: reference.recordUid }, session, options.signal, {
+			lane: "background-read",
+			key: `record-extension-parent:${reference.recordUid}`,
+			cacheMs: 5e3,
+			failureCooldownMs: 2e3
+		});
+		const extensionParent = await this.ownedRecordParentFromTree(data, reference.recordUid, session, options.signal);
+		return {
+			recordUid: reference.recordUid,
+			...extensionParent === void 0 ? {} : { extensionParent }
+		};
+	}
 	async loadOwnedRecordExtensions(recordUid, session, signal) {
-		const nodes = projectOwnedRecordExtensions(await this.runtime.authenticatedPost("/api/v1/records/extensions/tree", { record_uid: recordUid }, session, signal, {
+		const data = await this.runtime.authenticatedPost("/api/v1/records/extensions/tree", { record_uid: recordUid }, session, signal, {
 			lane: "interactive-read",
 			bypassCache: true
-		}), recordUid);
-		if (nodes.length === 0) return void 0;
+		});
+		const nodes = projectOwnedRecordExtensions(data, recordUid);
+		const extensionParent = await this.ownedRecordParentFromTree(data, recordUid, session, signal);
+		if (nodes.length === 0) return extensionParent === void 0 ? void 0 : {
+			extensionCount: 0,
+			extensions: [],
+			extensionParent
+		};
 		const readable = nodes.filter((node) => !node.protectedContent);
 		const hydration = await this.media.hydrateRecordMediaPage(readable.map((node) => node.record), session, signal);
 		const extensions = nodes.map((node) => {
@@ -51838,7 +52138,8 @@ var ChatService = class {
 		extensions.sort((left, right) => right.sendAtMillis - left.sendAtMillis);
 		return {
 			extensionCount: extensions.length,
-			extensions
+			extensions,
+			...extensionParent === void 0 ? {} : { extensionParent }
 		};
 	}
 	async recordEditHistoryTarget(sourceRef, messageActionRef) {
@@ -51911,7 +52212,8 @@ var ChatService = class {
 		return {
 			parentRecordUid: reference.recordUid,
 			extensionCount: recordContext?.extensionCount ?? 0,
-			extensions: recordContext?.extensions ?? []
+			extensions: recordContext?.extensions ?? [],
+			...recordContext !== void 0 && "extensionParent" in recordContext ? { extensionParent: recordContext.extensionParent } : {}
 		};
 	}
 	async extendSourceMessage(sourceRef, messageActionRef, textContent, recordUid, assets = [], options = {}) {
@@ -86468,6 +86770,7 @@ var InterwovenService = class {
 					summary: stringValue$2(renderPayload.content ?? item.summary).trim().slice(0, 1e3),
 					degraded: booleanValue$4(item.is_degraded),
 					sourceChatSessionUid,
+					...stringValue$2(jumpTarget.subject_uid).trim() === "" ? {} : { legacyGroupUid: stringValue$2(jumpTarget.subject_uid).trim() },
 					recordOwnerUserId,
 					recordUid,
 					relationUid,
@@ -86492,6 +86795,7 @@ var InterwovenService = class {
 				userId: session.userId,
 				sourceOwnerRef: source.ownerRef,
 				sourceChatSessionUid: descriptor.sourceChatSessionUid,
+				...descriptor.legacyGroupUid === void 0 ? {} : { legacyGroupUid: descriptor.legacyGroupUid },
 				recordOwnerUserId: descriptor.recordOwnerUserId,
 				recordUid: descriptor.recordUid,
 				relationUid: descriptor.relationUid,
@@ -86536,6 +86840,154 @@ var InterwovenService = class {
 			...partial ? { message: "部分交织瞬间暂时不可用，可稍后重试" } : {}
 		};
 	}
+	async interwovenReadReceipts(sourceRef, momentRefs, signal) {
+		const epoch = this.interactionEpoch;
+		const session = await this.runtime.requireSession();
+		const source = await this.source.openSourceRef(sourceRef, session.userId);
+		if (source.kind !== "private_chat" || momentRefs.length < 1 || momentRefs.length > 20 || momentRefs.some((ref) => typeof ref !== "string" || !ref.trim() || ref.length > 4096) || new Set(momentRefs).size !== momentRefs.length) throw new ArkmePluginError("interwoven-param-invalid", "群互动已读查询参数无效", false, 400);
+		const references = await Promise.all(momentRefs.map((ref) => this.openInterwovenMomentRef(ref, session.userId, source.ownerRef)));
+		const peerId = await this.assertInterwovenOperationAllowed(source, session, signal);
+		await this.resolveReceiptBridgeReferences(sourceRef, source.ownerRef, references, signal);
+		const groupReads = /* @__PURE__ */ new Map();
+		const read = (path, body) => this.runtime.authenticatedChatPost(path, body, session, signal, {
+			lane: "interactive-read",
+			bypassCache: true
+		});
+		const groupDetail = (uid) => {
+			let pending = groupReads.get(uid);
+			if (!pending) {
+				pending = read("/api/v1/chats/detail", { chat_session_uid: uid });
+				groupReads.set(uid, pending);
+			}
+			return pending;
+		};
+		const items = new Array(references.length);
+		let next = 0;
+		const worker = async () => {
+			while (next < references.length) {
+				signal?.throwIfAborted();
+				const index = next++;
+				const ref = references[index];
+				const reader = ref.senderUserId === session.userId ? "peer" : "self";
+				const unknown = {
+					momentId: ref.momentId,
+					reader,
+					status: "unknown"
+				};
+				items[index] = unknown;
+				const groupUid = ref.sourceChatSessionUid || ref.legacyGroupUid || "";
+				if (!groupUid || reader === "self" && ref.senderUserId !== peerId) continue;
+				try {
+					const group = await groupDetail(groupUid);
+					const groupSession = objectValue$2(group.session);
+					if (groupSession.chat_session_uid !== groupUid || groupSession.session_kind !== 2 || groupSession.status !== 1) continue;
+					let sequence = ref.sequence || ref.receiptSequence || 0;
+					const receiptRecordUid = ref.receiptRecordUid || ref.recordUid;
+					if (sequence <= 0) {
+						if (ref.recordUid.startsWith("chat_legacy_receive_")) continue;
+						const around = await read("/api/v1/chat/timeline/around", {
+							chat_session_uid: groupUid,
+							record_uid: ref.recordUid,
+							record_owner_user_id: ref.recordOwnerUserId,
+							before_limit: 1,
+							after_limit: 1
+						});
+						if (around.chat_session_uid !== groupUid) continue;
+						const candidates = [...listValue$11(around.items), around.anchor].map(objectValue$2).filter((item) => {
+							const relation = objectValue$2(item.relation ?? item);
+							return relation.chat_session_uid === groupUid && relation.record_uid === ref.recordUid && relation.record_owner_user_id === ref.recordOwnerUserId && relation.sender_user_id === ref.senderUserId && Number.isSafeInteger(relation.seq) && numberValue$13(relation.seq) > 0 && objectValue$2(item.record).status === 1;
+						});
+						const sequences = new Set(candidates.map((item) => numberValue$13(objectValue$2(item.relation ?? item).seq)));
+						if (sequences.size !== 1) continue;
+						sequence = [...sequences][0];
+						ref.receiptSequence = sequence;
+					}
+					if (reader === "self") {
+						const cursor = objectValue$2(group.current_cursor);
+						const snapshot = objectValue$2(group.unread_snapshot);
+						if (cursor.user_id !== session.userId || cursor.chat_session_uid !== groupUid || cursor.status !== 1) continue;
+						const readSeq = snapshot.read_seq ?? cursor.read_seq;
+						const lastSeq = snapshot.session_last_seq ?? groupSession.last_seq;
+						if (typeof readSeq !== "number" || !Number.isSafeInteger(readSeq) || readSeq < 0 || typeof lastSeq !== "number" || !Number.isSafeInteger(lastSeq) || lastSeq < sequence) continue;
+						items[index] = {
+							...unknown,
+							status: readSeq >= sequence ? "read" : "unread"
+						};
+					} else {
+						const detail = await read("/api/v1/chats/read-receipts/detail", {
+							chat_session_uid: groupUid,
+							record_uid: receiptRecordUid,
+							seq: sequence
+						});
+						if (detail.chat_session_uid !== groupUid || detail.record_uid !== receiptRecordUid || detail.seq !== sequence || !Array.isArray(detail.items)) continue;
+						const peers = detail.items.map(objectValue$2).filter((member) => member.user_id === peerId);
+						if (peers.length !== 1) continue;
+						const peer = peers[0];
+						if (peer.read_status !== "read" && peer.read_status !== "unread" || typeof peer.read_at !== "number" || !Number.isSafeInteger(peer.read_at) || peer.read_at < 0 || peer.read_status === "unread" && peer.read_at !== 0) continue;
+						items[index] = {
+							...unknown,
+							status: peer.read_status,
+							...peer.read_status === "read" && peer.read_at > 0 ? { readAtMillis: peer.read_at } : {}
+						};
+					}
+				} catch {
+					signal?.throwIfAborted();
+				}
+			}
+		};
+		await Promise.all(Array.from({ length: Math.min(3, references.length) }, worker));
+		await this.assertInteractionAccount(session.userId, epoch, signal);
+		return { items };
+	}
+	async resolveReceiptBridgeReferences(sourceRef, privateUid, references, signal) {
+		const pending = references.filter((ref) => !ref.sequence && !ref.receiptSequence && /^chat_legacy_receive_[a-f0-9]{32}$/.test(ref.recordUid));
+		if (!pending.length) return;
+		const matches = /* @__PURE__ */ new Map();
+		let cursor;
+		let expectedVersion;
+		try {
+			for (let page = 0; page < 3; page++) {
+				const { data, userId } = await this.readPrivateInteractions("occurrences/query", {
+					sourceRef,
+					limit: 50,
+					...cursor === void 0 ? {} : { cursor },
+					...expectedVersion === void 0 ? {} : { expectedVersion },
+					...signal === void 0 ? {} : { signal }
+				});
+				const coverage = this.interactionCoverage(data);
+				if (expectedVersion && coverage.version !== expectedVersion) return;
+				expectedVersion = coverage.version;
+				if (!Array.isArray(data.items) || data.items.length > 50 || typeof data.has_more !== "boolean") return;
+				for (const raw of data.items) {
+					const item = objectValue$2(raw);
+					if (this.interactionCount(item.seq) === 0) return;
+					const groupUid = stringValue$2(item.source_chat_session_uid).trim();
+					const relationUid = stringValue$2(item.rel_uid).trim();
+					const recordUid = stringValue$2(item.record_uid).trim();
+					if (!relationUid || !recordUid || item.private_chat_session_uid !== privateUid) continue;
+					const alias = `chat_legacy_receive_${createHash("sha256").update(`${groupUid}:${relationUid}`).digest("hex").slice(0, 32)}`;
+					for (const ref of pending) {
+						if (ref.recordUid !== alias || (ref.sourceChatSessionUid || ref.legacyGroupUid) !== groupUid || ref.recordOwnerUserId !== item.record_owner_user_id || ref.senderUserId !== item.sender_user_id || item.sender_is_me !== (ref.senderUserId === userId)) continue;
+						const next = {
+							recordUid,
+							sequence: item.seq
+						};
+						const previous = matches.get(ref);
+						matches.set(ref, previous === null || previous && (previous.recordUid !== recordUid || previous.sequence !== next.sequence) ? null : next);
+					}
+				}
+				if (!data.has_more || pending.every((ref) => matches.has(ref))) break;
+				if (typeof data.next_cursor !== "string" || !data.next_cursor || data.next_cursor.length > 2048) return;
+				cursor = data.next_cursor;
+			}
+			for (const [ref, match] of matches) if (match) {
+				ref.receiptRecordUid = match.recordUid;
+				ref.receiptSequence = match.sequence;
+			}
+		} catch {
+			signal?.throwIfAborted();
+		}
+	}
 	async interwovenMomentDetail(sourceRef, momentRef, signal) {
 		const session = await this.runtime.requireSession();
 		const source = await this.source.openSourceRef(sourceRef, session.userId);
@@ -86603,7 +87055,7 @@ var InterwovenService = class {
 		if (source.kind !== "private_chat") throw new ArkmePluginError("interwoven-source-invalid", "交织瞬间仅支持普通私聊", false, 400);
 		if (!this.runtime.config.interwovenMomentsEnabled) throw new ArkmePluginError("interwoven-disabled", "交织瞬间能力当前未开启", false, 403);
 		if (!booleanValue$4((await this.runtime.authenticatedAuthPost("/api/v1/auth/able-func", { func_type: 12 }, session, signal)).able)) throw new ArkmePluginError("interwoven-disabled", "交织瞬间能力当前未开放", false, 403);
-		await this.assertHumanPrivateSource(source, session, signal);
+		return await this.assertHumanPrivateSource(source, session, signal);
 	}
 	async assertHumanPrivateSource(source, session, signal) {
 		const detail = await this.runtime.authenticatedChatPost("/api/v1/chats/detail", { chat_session_uid: source.ownerRef }, session, signal);
@@ -98026,6 +98478,12 @@ var ArkmeService = class {
 	async membershipCatalog(expectedUserId) {
 		return await this.membershipOwner.catalog(expectedUserId);
 	}
+	async aiPointsAccount(expectedScope, signal) {
+		return await new AiPointsService(this.runtime).account(expectedScope, signal);
+	}
+	async aiPointsConsumption(query, expectedScope, signal) {
+		return await new AiPointsService(this.runtime).consumption(query, expectedScope, signal);
+	}
 	async accountTokenUsage(expectedScope) {
 		return await new AccountUsageService(this.runtime).tokens(expectedScope);
 	}
@@ -98260,6 +98718,7 @@ var ArkmeService = class {
 				revisionPolling: true,
 				userProfile: true,
 				accountSettings: true,
+				aiPoints: true,
 				imageRead: true,
 				recordCalendar: true,
 				imageLibrary: true,
@@ -98775,6 +99234,9 @@ var ArkmeService = class {
 	async interwovenMomentDetail(sourceRef, momentRef, signal) {
 		return await this.interwoven.interwovenMomentDetail(sourceRef, momentRef, signal);
 	}
+	async interwovenReadReceipts(sourceRef, momentRefs, signal) {
+		return await this.interwoven.interwovenReadReceipts(sourceRef, momentRefs, signal);
+	}
 	async recordEditHistoryPage(sourceRef, messageActionRef, cursorEditAt = 0, signal) {
 		return await this.recordEditHistory.page(await this.chat.recordEditHistoryTarget(sourceRef, messageActionRef), cursorEditAt, signal);
 	}
@@ -99212,6 +99674,9 @@ var ArkmeService = class {
 			})
 		};
 	}
+	async sourceMessageExtensionParent(sourceRef, messageActionRef, options = {}) {
+		return this.chat.sourceMessageExtensionParent(sourceRef, messageActionRef, options);
+	}
 	async extendSourceMessage(sourceRef, messageActionRef, textContent, recordUid, fileRefs = [], options = {}) {
 		if (options.textFormat === "markdown" && this.config.markdownQuickNotesEnabled !== true) throw new ArkmePluginError("markdown-send-disabled", "Markdown 发送尚未开放，请稍后重试", false, 403);
 		const context = await this.chat.sourceMessageExtensionContext(sourceRef, messageActionRef, options);