@downcity/agent 1.1.8 → 1.1.10

package/bin/host/http/control/ExecuteInput.js

@@ -0,0 +1,201 @@
+/**
+ * Control execute 输入拼装 helper。
+ *
+ * 关键点（中文）
+ * - 负责把 API 传入的附件规范化并落盘。
+ * - 最终统一转成 `<file>` 标签注入到 user message。
+ */
+import fs from "fs-extra";
+import path from "node:path";
+import { getCacheDirPath } from "../../../config/Paths.js";
+import { renderChatMessageFileTag } from "../../../service/builtins/chat/runtime/ChatMessageMarkup.js";
+const EXECUTE_ATTACHMENT_MAX_COUNT = 8;
+const EXECUTE_ATTACHMENT_MAX_BYTES = 2 * 1024 * 1024;
+const EXECUTE_ATTACHMENT_CONTENT_MAX_CHARS = 1_500_000;
+const EXECUTE_ATTACHMENT_FALLBACK_TEXT = "请查看以上附件并按用户要求处理。";
+function normalizeExecuteAttachmentType(value) {
+    const raw = String(value || "")
+        .trim()
+        .toLowerCase();
+    if (raw === "photo" ||
+        raw === "voice" ||
+        raw === "audio" ||
+        raw === "video") {
+        return raw;
+    }
+    return "document";
+}
+function normalizeAttachmentCaption(value) {
+    const text = String(value || "")
+        .replace(/\r?\n+/g, " ")
+        .replace(/\s+/g, " ")
+        .replace(/\|/g, "/")
+        .trim();
+    if (!text)
+        return undefined;
+    return text.slice(0, 180);
+}
+function toProjectRelativePath(projectRoot, absPath) {
+    const relative = path.relative(projectRoot, absPath);
+    if (!relative)
+        return null;
+    if (relative.startsWith(".."))
+        return null;
+    if (path.isAbsolute(relative))
+        return null;
+    return relative.split(path.sep).join("/");
+}
+function normalizeAttachmentFileName(params) {
+    const raw = String(params.fileName || "").trim();
+    const base = (raw || "attachment")
+        .replace(/[\\/:*?"<>|]/g, "-")
+        .replace(/\s+/g, "-")
+        .replace(/-+/g, "-")
+        .replace(/^\.+/, "")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 72);
+    const safeBase = base || "attachment";
+    const fallbackExt = params.fallbackExt.startsWith(".")
+        ? params.fallbackExt
+        : `.${params.fallbackExt}`;
+    const hasExt = /\.[A-Za-z0-9]+$/.test(safeBase);
+    return hasExt ? safeBase : `${safeBase}${fallbackExt}`;
+}
+function inferAttachmentExt(params) {
+    const fromFileName = path.extname(String(params.fileName || "").trim())
+        .toLowerCase()
+        .trim();
+    if (fromFileName)
+        return fromFileName;
+    const contentType = String(params.contentType || "").toLowerCase();
+    if (contentType.includes("markdown"))
+        return ".md";
+    if (contentType.includes("json"))
+        return ".json";
+    if (contentType.includes("html"))
+        return ".html";
+    if (contentType.includes("plain"))
+        return ".txt";
+    if (params.type === "photo")
+        return ".jpg";
+    if (params.type === "voice" || params.type === "audio")
+        return ".mp3";
+    if (params.type === "video")
+        return ".mp4";
+    return ".md";
+}
+async function resolveAttachmentPathFromInput(params) {
+    const rawPath = String(params.attachment.path || "").trim();
+    if (!rawPath)
+        return null;
+    const abs = path.isAbsolute(rawPath)
+        ? path.normalize(rawPath)
+        : path.resolve(params.projectRoot, rawPath);
+    const relative = toProjectRelativePath(params.projectRoot, abs);
+    if (!relative)
+        return null;
+    const stat = await fs
+        .stat(abs)
+        .then((value) => value)
+        .catch(() => null);
+    if (!stat?.isFile())
+        return null;
+    return relative;
+}
+function resolveAttachmentBytes(attachment) {
+    const textContent = typeof attachment.content === "string" ? attachment.content : "";
+    if (textContent) {
+        const clipped = textContent.slice(0, EXECUTE_ATTACHMENT_CONTENT_MAX_CHARS);
+        return Buffer.from(clipped, "utf8");
+    }
+    const base64 = String(attachment.contentBase64 || "").trim();
+    if (!base64)
+        return null;
+    try {
+        return Buffer.from(base64, "base64");
+    }
+    catch {
+        return null;
+    }
+}
+async function materializeAttachmentContent(params) {
+    const bytes = resolveAttachmentBytes(params.attachment);
+    if (!bytes || bytes.length <= 0)
+        return null;
+    if (bytes.length > EXECUTE_ATTACHMENT_MAX_BYTES) {
+        throw new Error(`Attachment too large (>${EXECUTE_ATTACHMENT_MAX_BYTES} bytes)`);
+    }
+    const type = normalizeExecuteAttachmentType(params.attachment.type);
+    const ext = inferAttachmentExt({
+        type,
+        fileName: params.attachment.fileName,
+        contentType: params.attachment.contentType,
+    });
+    const safeName = normalizeAttachmentFileName({
+        fileName: params.attachment.fileName,
+        fallbackExt: ext,
+    });
+    const safeContext = String(params.sessionId || "session")
+        .replace(/[^A-Za-z0-9_-]+/g, "-")
+        .replace(/-+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 32);
+    const prefix = safeContext || "context";
+    const fileName = `${Date.now()}-${prefix}-${String(params.index + 1).padStart(2, "0")}-${safeName}`;
+    const cacheDir = path.join(getCacheDirPath(params.projectRoot), "chrome-extension");
+    await fs.ensureDir(cacheDir);
+    const absPath = path.join(cacheDir, fileName);
+    await fs.writeFile(absPath, bytes);
+    return toProjectRelativePath(params.projectRoot, absPath);
+}
+function toAttachmentLine(params) {
+    return renderChatMessageFileTag({
+        type: params.type,
+        path: params.relativePath,
+        ...(params.caption ? { caption: params.caption } : {}),
+    });
+}
+/**
+ * 构造 execute 入站文本。
+ */
+export async function buildExecuteInputText(params) {
+    const instructions = String(params.instructions || "").trim();
+    const inputAttachments = Array.isArray(params.attachments)
+        ? params.attachments.slice(0, EXECUTE_ATTACHMENT_MAX_COUNT)
+        : [];
+    if (inputAttachments.length === 0)
+        return instructions;
+    const lines = [];
+    for (let index = 0; index < inputAttachments.length; index += 1) {
+        const attachment = inputAttachments[index];
+        if (!attachment || typeof attachment !== "object")
+            continue;
+        const type = normalizeExecuteAttachmentType(attachment.type);
+        const caption = normalizeAttachmentCaption(attachment.caption);
+        const reusePath = await resolveAttachmentPathFromInput({
+            projectRoot: params.projectRoot,
+            attachment,
+        });
+        const relativePath = reusePath ||
+            (await materializeAttachmentContent({
+                projectRoot: params.projectRoot,
+                sessionId: params.sessionId,
+                attachment,
+                index,
+            }));
+        if (!relativePath)
+            continue;
+        lines.push(toAttachmentLine({
+            type,
+            relativePath,
+            ...(caption ? { caption } : {}),
+        }));
+    }
+    if (lines.length === 0)
+        return instructions;
+    return [lines.join("\n"), instructions || EXECUTE_ATTACHMENT_FALLBACK_TEXT]
+        .filter(Boolean)
+        .join("\n\n")
+        .trim();
+}
+//# sourceMappingURL=ExecuteInput.js.map

package/bin/host/http/control/ExecuteInput.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExecuteInput.js","sourceRoot":"","sources":["../../../../src/host/http/control/ExecuteInput.ts"],"names":[],"mappings":"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"}

package/bin/host/http/control/Helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Helpers.d.ts","sourceRoot":"","sources":["../../../../src/host/http/control/Helpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EACL,2BAA2B,EAC3B,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,cAAc,EACd,iBAAiB,GAClB,MAAM,gBAAgB,CAAC"}

package/bin/host/http/control/Helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Helpers.js","sourceRoot":"","sources":["../../../../src/host/http/control/Helpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EACL,2BAA2B,EAC3B,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,cAAc,EACd,iBAAiB,GAClB,MAAM,gBAAgB,CAAC"}

package/bin/host/http/control/MessageTimeline.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Control 消息时间线 helper。
+ *
+ * 关键点（中文）
+ * - 负责把上下文消息映射成 control UI 可视时间线。
+ * - 同时提供消息文件读取能力。
+ */
+import type { SessionMessageV1 } from "../../../session/types/SessionMessages.js";
+import type { ControlTimelineEvent } from "../../../host/http/control/types/ControlViewData.js";
+/**
+ * 转成 control 时间线。
+ */
+export declare function toUiMessageTimeline(message: SessionMessageV1): ControlTimelineEvent[];
+/**
+ * 读取 session 消息文件。
+ */
+export declare function loadSessionMessagesFromFile(filePath: string): Promise<SessionMessageV1[]>;
+/**
+ * 读取适合摘要展示的消息预览文本。
+ */
+export declare function resolveUiMessagePreview(message: SessionMessageV1): string;
+//# sourceMappingURL=MessageTimeline.d.ts.map

package/bin/host/http/control/MessageTimeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageTimeline.d.ts","sourceRoot":"","sources":["../../../../src/host/http/control/MessageTimeline.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,OAAO,KAAK,EACV,gBAAgB,EAEjB,MAAM,oCAAoC,CAAC;AAG5C,OAAO,KAAK,EAAE,oBAAoB,EAAuB,MAAM,8CAA8C,CAAC;AAmI9G;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,gBAAgB,GACxB,oBAAoB,EAAE,CAiFxB;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAC/C,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAgB7B;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAEzE"}

package/bin/host/http/control/MessageTimeline.js

@@ -0,0 +1,226 @@
+/**
+ * Control 消息时间线 helper。
+ *
+ * 关键点（中文）
+ * - 负责把上下文消息映射成 control UI 可视时间线。
+ * - 同时提供消息文件读取能力。
+ */
+import fs from "fs-extra";
+import { getToolName, isTextUIPart, isToolUIPart, } from "ai";
+import { pickLastSuccessfulChatSendText } from "../../../service/builtins/chat/runtime/UserVisibleText.js";
+import { extractToolCallsFromUiMessage } from "../../../service/builtins/chat/runtime/UIMessageTransformer.js";
+import { truncateText } from "./CommonHelpers.js";
+function stringifyForDisplay(input, maxChars = 2400) {
+    if (input === undefined)
+        return "";
+    if (input === null)
+        return "null";
+    if (typeof input === "string") {
+        const value = input.trim();
+        if (!value)
+            return "";
+        try {
+            const parsed = JSON.parse(value);
+            return truncateText(JSON.stringify(parsed, null, 2), maxChars);
+        }
+        catch {
+            return truncateText(value, maxChars);
+        }
+    }
+    if (typeof input === "number" || typeof input === "boolean") {
+        return truncateText(String(input), maxChars);
+    }
+    try {
+        return truncateText(JSON.stringify(input, null, 2), maxChars);
+    }
+    catch {
+        return truncateText(String(input), maxChars);
+    }
+}
+function extractMessageText(parts) {
+    if (!Array.isArray(parts))
+        return "";
+    const texts = [];
+    for (const part of parts) {
+        if (!part || typeof part !== "object")
+            continue;
+        const p = part;
+        if (p.type !== "text")
+            continue;
+        if (typeof p.text !== "string")
+            continue;
+        const value = p.text.trim();
+        if (!value)
+            continue;
+        texts.push(value);
+    }
+    return texts.join("\n").trim();
+}
+function extractAssistantToolSummary(message) {
+    const toolCalls = extractToolCallsFromUiMessage(message);
+    if (!Array.isArray(toolCalls) || toolCalls.length === 0)
+        return "";
+    const toolNames = Array.from(new Set(toolCalls.map((item) => String(item.tool || "").trim()).filter(Boolean)));
+    if (toolNames.length === 0)
+        return "";
+    return `[tool] ${toolNames.join(", ")}`;
+}
+function resolveToolName(part, aiToolName) {
+    const fromAi = String(aiToolName || "").trim();
+    if (fromAi)
+        return fromAi;
+    const rawType = typeof part.type === "string" ? part.type.trim() : "";
+    if (rawType.startsWith("tool-"))
+        return rawType.slice("tool-".length);
+    return "unknown_tool";
+}
+function extractToolCallInput(part) {
+    return part.input ?? undefined;
+}
+function extractToolResultOutput(part) {
+    const state = typeof part.state === "string" ? part.state.trim() : "";
+    if (state === "output-available")
+        return part.output;
+    if (state === "output-error") {
+        return { error: part.errorText ?? part.error ?? "tool_error" };
+    }
+    if (state === "output-denied") {
+        return {
+            error: "tool_denied",
+            reason: part.approval?.reason ?? "",
+        };
+    }
+    if (state === "input-available" ||
+        state === "input-streaming" ||
+        state === "output-streaming") {
+        return undefined;
+    }
+    return undefined;
+}
+function toUiMessageEvent(params) {
+    const { message, role, text, sequence, toolName } = params;
+    const metadata = (message.metadata || null);
+    return {
+        id: `${String(message.id || "")}:${sequence}`,
+        role,
+        ...(typeof metadata?.ts === "number" ? { ts: metadata.ts } : {}),
+        ...(typeof metadata?.kind === "string" ? { kind: metadata.kind } : {}),
+        ...(typeof metadata?.source === "string" ? { source: metadata.source } : {}),
+        text,
+        ...(toolName ? { toolName } : {}),
+    };
+}
+function resolveUiMessageText(message) {
+    const plainText = extractMessageText(message.parts);
+    if (plainText)
+        return plainText;
+    if (message.role !== "assistant")
+        return "";
+    const userVisible = pickLastSuccessfulChatSendText(message).trim();
+    if (userVisible)
+        return userVisible;
+    return extractAssistantToolSummary(message);
+}
+/**
+ * 转成 control 时间线。
+ */
+export function toUiMessageTimeline(message) {
+    if (message.role !== "assistant") {
+        return [
+            toUiMessageEvent({
+                message,
+                role: message.role,
+                text: resolveUiMessageText(message),
+                sequence: 0,
+            }),
+        ];
+    }
+    const parts = Array.isArray(message.parts)
+        ? message.parts
+        : [];
+    const events = [];
+    let sequence = 0;
+    for (const part of parts) {
+        if (!part || typeof part !== "object")
+            continue;
+        const partObject = part;
+        if (isTextUIPart(part)) {
+            const text = String(part.text || "").trim();
+            if (!text)
+                continue;
+            events.push(toUiMessageEvent({
+                message,
+                role: "assistant",
+                text,
+                sequence,
+            }));
+            sequence += 1;
+            continue;
+        }
+        if (isToolUIPart(part)) {
+            const toolName = resolveToolName(partObject, String(getToolName(part) || ""));
+            const inputText = stringifyForDisplay(extractToolCallInput(partObject));
+            events.push(toUiMessageEvent({
+                message,
+                role: "tool-call",
+                text: inputText || "(empty)",
+                sequence,
+                toolName,
+            }));
+            sequence += 1;
+            const output = extractToolResultOutput(partObject);
+            if (output !== undefined) {
+                events.push(toUiMessageEvent({
+                    message,
+                    role: "tool-result",
+                    text: stringifyForDisplay(output) || "(empty)",
+                    sequence,
+                    toolName,
+                }));
+                sequence += 1;
+            }
+            continue;
+        }
+    }
+    // 关键点（中文）：assistant 若没有文本 part，也要保留一条可见事件，避免 control UI 空白。
+    if (events.length === 0) {
+        events.push(toUiMessageEvent({
+            message,
+            role: "assistant",
+            text: resolveUiMessageText(message),
+            sequence: 0,
+        }));
+    }
+    return events;
+}
+/**
+ * 读取 session 消息文件。
+ */
+export async function loadSessionMessagesFromFile(filePath) {
+    if (!(await fs.pathExists(filePath)))
+        return [];
+    const raw = await fs.readFile(filePath, "utf-8");
+    const lines = raw.split("\n").filter(Boolean);
+    const out = [];
+    for (const line of lines) {
+        try {
+            const item = JSON.parse(line);
+            if (!item || typeof item !== "object")
+                continue;
+            if (item.role !== "user" && item.role !== "assistant")
+                continue;
+            out.push(item);
+        }
+        catch {
+            // 关键点（中文）：单行损坏不应影响整体可读性。
+        }
+    }
+    return out;
+}
+/**
+ * 读取适合摘要展示的消息预览文本。
+ */
+export function resolveUiMessagePreview(message) {
+    return resolveUiMessageText(message);
+}
+//# sourceMappingURL=MessageTimeline.js.map

package/bin/host/http/control/MessageTimeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageTimeline.js","sourceRoot":"","sources":["../../../../src/host/http/control/MessageTimeline.ts"],"names":[],"mappings":"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"}

package/bin/host/http/control/ModelRoutes.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Control 模型路由。
+ *
+ * 关键点（中文）
+ * - 仅承接当前 agent 视角下的模型展示与切换。
+ * - 控制面全局模型池管理仍由 `/api/ui/model*` 处理。
+ */
+import type { ControlRouteRegistrationParams } from "../../../host/http/control/types/ControlRoutes.js";
+/**
+ * 注册模型相关路由。
+ */
+export declare function registerControlModelRoutes(params: ControlRouteRegistrationParams): void;
+//# sourceMappingURL=ModelRoutes.d.ts.map

package/bin/host/http/control/ModelRoutes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModelRoutes.d.ts","sourceRoot":"","sources":["../../../../src/host/http/control/ModelRoutes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,4CAA4C,CAAC;AAGjG;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,8BAA8B,GACrC,IAAI,CAkFN"}

package/bin/host/http/control/ModelRoutes.js

@@ -0,0 +1,87 @@
+/**
+ * Control 模型路由。
+ *
+ * 关键点（中文）
+ * - 仅承接当前 agent 视角下的模型展示与切换。
+ * - 控制面全局模型池管理仍由 `/api/ui/model*` 处理。
+ */
+import fs from "fs-extra";
+import { getDowncityJsonPath } from "../../../config/Paths.js";
+import { buildControlRouteAliases } from "../../../host/http/control/CommonHelpers.js";
+/**
+ * 注册模型相关路由。
+ */
+export function registerControlModelRoutes(params) {
+    const { app } = params;
+    for (const routePath of buildControlRouteAliases("/model")) {
+        app.get(routePath, async (c) => {
+            try {
+                const agentState = params.getAgentRuntime();
+                const agentPrimaryModelId = String(agentState.config.execution?.type === "api" ? agentState.config.execution.modelId || "" : "").trim();
+                const models = agentState.platform.listModels();
+                const providers = await agentState.platform.listProviders();
+                const providerMap = new Map(providers.map((x) => [x.id, x]));
+                const activeModel = agentPrimaryModelId
+                    ? models.find((x) => x.id === agentPrimaryModelId)
+                    : undefined;
+                const providerKey = String(activeModel?.providerId || "").trim();
+                const provider = providerKey ? providerMap.get(providerKey) : undefined;
+                const availableModels = models.map((model) => {
+                    const providerConfig = providerMap.get(model.providerId);
+                    return {
+                        id: model.id,
+                        name: model.name,
+                        providerKey: model.providerId,
+                        providerType: String(providerConfig?.type || "").trim(),
+                    };
+                });
+                return c.json({
+                    success: true,
+                    model: {
+                        primaryModelId: agentPrimaryModelId,
+                        primaryModelName: String(activeModel?.name || "").trim(),
+                        providerKey,
+                        providerType: String(provider?.type || "").trim(),
+                        baseUrl: String(provider?.baseUrl || "").trim(),
+                        agentPrimaryModelId,
+                        availableModels,
+                    },
+                });
+            }
+            catch (error) {
+                return c.json({ success: false, error: String(error) }, 500);
+            }
+        });
+    }
+    for (const routePath of buildControlRouteAliases("/model/switch")) {
+        app.post(routePath, async (c) => {
+            try {
+                const agentState = params.getAgentRuntime();
+                const body = (await c.req.json().catch(() => ({})));
+                const nextPrimaryModelId = String(body.primaryModelId || "").trim();
+                if (!nextPrimaryModelId) {
+                    return c.json({ success: false, error: "Missing primaryModelId" }, 400);
+                }
+                const targetModel = agentState.platform.getModel(nextPrimaryModelId);
+                if (!targetModel) {
+                    return c.json({ success: false, error: `Model not found: ${nextPrimaryModelId}` }, 400);
+                }
+                const shipJsonPath = getDowncityJsonPath(agentState.rootPath);
+                const agentShip = (await fs.readJson(shipJsonPath));
+                agentShip.execution = { type: "api", modelId: nextPrimaryModelId };
+                await fs.writeJson(shipJsonPath, agentShip, { spaces: 2 });
+                agentState.config.execution = { type: "api", modelId: nextPrimaryModelId };
+                return c.json({
+                    success: true,
+                    primaryModelId: nextPrimaryModelId,
+                    restartRequired: true,
+                    message: "Agent primary model updated. Restart agent to fully apply the new model instance.",
+                });
+            }
+            catch (error) {
+                return c.json({ success: false, error: String(error) }, 500);
+            }
+        });
+    }
+}
+//# sourceMappingURL=ModelRoutes.js.map

package/bin/host/http/control/ModelRoutes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModelRoutes.js","sourceRoot":"","sources":["../../../../src/host/http/control/ModelRoutes.ts"],"names":[],"mappings":"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"}

package/bin/host/http/control/OverviewRoutes.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Control 概览路由。
+ *
+ * 关键点（中文）
+ * - 聚合 overview 与 services 两块轻量只读接口。
+ * - 只负责路由层拼装，不承载复杂业务状态机。
+ */
+import type { ControlRouteRegistrationParams } from "../../../host/http/control/types/ControlRoutes.js";
+/**
+ * 注册概览与服务路由。
+ */
+export declare function registerControlOverviewRoutes(params: ControlRouteRegistrationParams): void;
+//# sourceMappingURL=OverviewRoutes.d.ts.map

package/bin/host/http/control/OverviewRoutes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OverviewRoutes.d.ts","sourceRoot":"","sources":["../../../../src/host/http/control/OverviewRoutes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,4CAA4C,CAAC;AAoBjG;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,8BAA8B,GACrC,IAAI,CAiEN"}