@downcity/agent 1.1.1

package/bin/shared/types/DowncityConfig.d.ts

@@ -0,0 +1,214 @@
+/**
+ * Downcity 配置类型定义。
+ *
+ * 关键点（中文）
+ * - 作为全局共享类型，不挂在 console 目录下。
+ * - 供 agent、services、console 宿主层多处复用，避免反向类型依赖。
+ */
+import type { LlmConfig } from "../../shared/types/LlmConfig.js";
+import type { ExecutionBindingConfig } from "../../shared/types/ExecutionBinding.js";
+import type { JsonObject } from "../../shared/types/Json.js";
+import type { SandboxProjectConfig } from "../../shared/types/Sandbox.js";
+export interface DowncityConfig {
+    $schema?: string;
+    name: string;
+    version: string;
+    description?: string;
+    /**
+     * Runtime startup configuration used by `downcity agent start`.
+     * CLI flags (if provided) take precedence over this config.
+     */
+    start?: {
+        port?: number;
+        host?: string;
+    };
+    /**
+     * services 配置。
+     *
+     * 关键点（中文）
+     * - 所有服务相关配置统一收敛到 `services` 下，避免顶层散落字段。
+     * - 例如：`services.chat.channels`、`services.chat.queue`。
+     */
+    services?: {
+        /**
+         * Chat service 配置。
+         */
+        chat?: {
+            /**
+             * Chat 调度队列（按 chatKey 分 lane）。
+             */
+            queue?: {
+                /**
+                 * 全局最大并发（不同 chatKey 之间）。
+                 * 默认：2
+                 */
+                maxConcurrency?: number;
+                /**
+                 * 入站消息合并的防抖窗口（毫秒）。
+                 *
+                 * 关键点（中文）
+                 * - 同一 chatKey 在该窗口内连续到达的多条消息，会在一次 run 前一起并入上下文。
+                 * - 典型场景：用户先发一句话，再紧接着转发链接/卡片。
+                 * - 设为 `0` 或负数可关闭该能力（立即执行首条消息）。
+                 *
+                 * 默认：600
+                 */
+                mergeDebounceMs?: number;
+                /**
+                 * 入站消息合并的最长等待时间（毫秒）。
+                 *
+                 * 关键点（中文）
+                 * - 即使用户持续发送新消息，也不会无限延期；达到该上限后会立刻启动 run。
+                 * - 用于平衡“尽量合并上下文”与“响应时延可控”。
+                 * - 当 `mergeDebounceMs <= 0` 时该字段不会生效。
+                 *
+                 * 默认：2000
+                 */
+                mergeMaxWaitMs?: number;
+            };
+            /**
+             * 出站（egress）控制：用于限制工具发送、避免重复与无限循环刷屏。
+             */
+            egress?: {
+                /**
+                 * 单次 agent run 内，`chat_send` 允许调用的最大次数。
+                 */
+                chatSendMaxCallsPerRun?: number;
+                /**
+                 * 是否启用 `chat_send` 幂等去重（基于 inbound messageId + 回复内容 hash）。
+                 */
+                chatSendIdempotency?: boolean;
+            };
+            /**
+             * 消息平台 channel 配置。
+             */
+            channels?: {
+                telegram?: {
+                    enabled: boolean;
+                    /**
+                     * 绑定的 channel account id（来源：console 全局 `~/.downcity/downcity.db`）。
+                     */
+                    channelAccountId?: string;
+                };
+                feishu?: {
+                    enabled: boolean;
+                    /**
+                     * 绑定的 channel account id（来源：console 全局 `~/.downcity/downcity.db`）。
+                     */
+                    channelAccountId?: string;
+                };
+                qq?: {
+                    enabled: boolean;
+                    /**
+                     * 绑定的 channel account id（来源：console 全局 `~/.downcity/downcity.db`）。
+                     */
+                    channelAccountId?: string;
+                };
+            };
+        };
+    };
+    /**
+     * plugins 配置。
+     *
+     * 关键点（中文）
+     * - 新插件体系的行为配置统一收敛到该字段。
+     * - plugin 私有配置（例如 `plugins.skill.paths`）也放在这里。
+     * - key 为 plugin 名称，value 为对应插件的结构化配置对象。
+     * - 当前阶段允许各 plugin 自定义字段，但必须保持 JSON 可序列化。
+     */
+    plugins?: {
+        /**
+         * 插件配置对象映射。
+         */
+        [pluginName: string]: JsonObject;
+    };
+    /**
+     * 项目执行绑定配置。
+     *
+     * 关键点（中文）
+     * - 项目只有一种执行模式：`api`。
+     * - 绑定 console 全局模型池中的模型 ID。
+     */
+    execution?: ExecutionBindingConfig;
+    /**
+     * shell / CLI 执行 sandbox 配置。
+     *
+     * 关键点（中文）
+     * - 当前只作用于 shell service 这条命令执行链。
+     * - 这里不表达审批、用户授权与复杂策略系统，只表达最小边界。
+     */
+    sandbox?: SandboxProjectConfig;
+    /**
+     * LLM 全量配置（通常来自 console 全局层合并结果）。
+     *
+     * 关键点（中文）
+     * - 运行时会读取该字段创建真实模型实例。
+     * - 对于项目内 `downcity.json`，通常不需要显式写该字段。
+     */
+    llm?: LlmConfig;
+    /**
+     * 上下文管理（工程向配置）。
+     *
+     * 说明
+     * - 对话消息以 UIMessage[] 为唯一事实源（`.downcity/session/<sessionId>/messages/messages.jsonl`）。
+     * - Agent 每次执行直接把 UIMessage[] 转成 ModelMessage[] 作为 messages 输入。
+     * - 超出上下文窗口时会自动 compact（更早段压缩为摘要 + 保留最近窗口）。
+     */
+    context?: {
+        /**
+         * messages（唯一上下文消息来源）的 compact 策略。
+         */
+        messages?: {
+            /**
+             * 历史兼容字段（保留）。
+             *
+             * 说明（中文）
+             * - 当前默认策略按 `compactRatio` 压缩前段消息。
+             * - 该字段仍会写入 compact 元信息，便于观测与旧配置兼容。
+             *
+             * 默认：30
+             */
+            keepLastMessages?: number;
+            /**
+             * 输入预算（近似 token 数）。
+             *
+             * 说明（中文）
+             * - 这里是近似值，用于在调用 provider 前提前触发 compact
+             * - 实际超窗仍会被 provider 拒绝并进入 retry（更激进 compact）
+             *
+             * 默认：128000
+             */
+            maxInputTokensApprox?: number;
+            /**
+             * compact 时是否归档被折叠的原始消息段（写入 messages/archive/）。
+             * 默认：true
+             */
+            archiveOnCompact?: boolean;
+            /**
+             * 前段压缩比例（0-1）。
+             *
+             * 说明（中文）
+             * - 触发 compact 后，优先压缩最早一段消息。
+             * - `0.5` 代表优先压缩“最早 50% 的 UIMessage”。
+             * - 实际切分会做边界保护（至少保留 1 条最近消息）。
+             *
+             * 默认：0.5
+             */
+            compactRatio?: number;
+        };
+        /**
+         * 记忆管理配置。
+         *
+         * 设计目标
+         * - 默认开启，开箱即用（零配置）
+         * - 仅保留总开关，避免复杂配置负担
+         */
+        memory?: {
+            /**
+             * 是否启用 memory service。
+             */
+            enabled?: boolean;
+        };
+    };
+}
+//# sourceMappingURL=DowncityConfig.d.ts.map

package/bin/shared/types/DowncityConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DowncityConfig.d.ts","sourceRoot":"","sources":["../../../src/shared/types/DowncityConfig.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AACjF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,KAAK,CAAC,EAAE;QACN,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE;QACT;;WAEG;QACH,IAAI,CAAC,EAAE;YACL;;eAEG;YACH,KAAK,CAAC,EAAE;gBACN;;;mBAGG;gBACH,cAAc,CAAC,EAAE,MAAM,CAAC;gBACxB;;;;;;;;;mBASG;gBACH,eAAe,CAAC,EAAE,MAAM,CAAC;gBACzB;;;;;;;;;mBASG;gBACH,cAAc,CAAC,EAAE,MAAM,CAAC;aACzB,CAAC;YACF;;eAEG;YACH,MAAM,CAAC,EAAE;gBACP;;mBAEG;gBACH,sBAAsB,CAAC,EAAE,MAAM,CAAC;gBAChC;;mBAEG;gBACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;aAC/B,CAAC;YACF;;eAEG;YACH,QAAQ,CAAC,EAAE;gBACT,QAAQ,CAAC,EAAE;oBACT,OAAO,EAAE,OAAO,CAAC;oBACjB;;uBAEG;oBACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;iBAC3B,CAAC;gBACF,MAAM,CAAC,EAAE;oBACP,OAAO,EAAE,OAAO,CAAC;oBACjB;;uBAEG;oBACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;iBAC3B,CAAC;gBACF,EAAE,CAAC,EAAE;oBACH,OAAO,EAAE,OAAO,CAAC;oBACjB;;uBAEG;oBACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;iBAC3B,CAAC;aACH,CAAC;SACH,CAAC;KACH,CAAC;IACF;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE;QACR;;WAEG;QACH,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,CAAC;KAClC,CAAC;IACF;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,sBAAsB,CAAC;IACnC;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAC/B;;;;;;OAMG;IACH,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE;QACR;;WAEG;QACH,QAAQ,CAAC,EAAE;YACT;;;;;;;;eAQG;YACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;YAC1B;;;;;;;;eAQG;YACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;YAC9B;;;eAGG;YACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;YAE3B;;;;;;;;;eASG;YACH,YAAY,CAAC,EAAE,MAAM,CAAC;SACvB,CAAC;QACF;;;;;;WAMG;QACH,MAAM,CAAC,EAAE;YACP;;eAEG;YACH,OAAO,CAAC,EAAE,OAAO,CAAC;SACnB,CAAC;KACH,CAAC;CACH"}

package/bin/shared/types/DowncityConfig.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=DowncityConfig.js.map

package/bin/shared/types/DowncityConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DowncityConfig.js","sourceRoot":"","sources":["../../../src/shared/types/DowncityConfig.ts"],"names":[],"mappings":""}

package/bin/shared/types/ExecutionBinding.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 项目执行绑定类型定义（api 模式）。
+ *
+ * 关键点（中文）
+ * - 项目运行入口只有一种执行模式：`api`。
+ * - 绑定 console 全局模型池中的模型 ID。
+ * - 该类型是项目 `downcity.json` 中唯一的执行配置。
+ */
+/**
+ * 项目执行绑定配置（api 模式）。
+ */
+export interface ExecutionBindingConfig {
+    /**
+     * 执行模式类型，固定为 `api`。
+     */
+    type: "api";
+    /**
+     * console 全局模型池中的模型 ID。
+     *
+     * 说明（中文）
+     * - 必须能在 `~/.downcity/downcity.db` 的模型池中解析到。
+     * - 例如：`default`、`fast`、`quality`。
+     */
+    modelId: string;
+}
+//# sourceMappingURL=ExecutionBinding.d.ts.map

package/bin/shared/types/ExecutionBinding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExecutionBinding.d.ts","sourceRoot":"","sources":["../../../src/shared/types/ExecutionBinding.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,IAAI,EAAE,KAAK,CAAC;IAEZ;;;;;;OAMG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/bin/shared/types/ExecutionBinding.js

@@ -0,0 +1,10 @@
+/**
+ * 项目执行绑定类型定义（api 模式）。
+ *
+ * 关键点（中文）
+ * - 项目运行入口只有一种执行模式：`api`。
+ * - 绑定 console 全局模型池中的模型 ID。
+ * - 该类型是项目 `downcity.json` 中唯一的执行配置。
+ */
+export {};
+//# sourceMappingURL=ExecutionBinding.js.map

package/bin/shared/types/ExecutionBinding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExecutionBinding.js","sourceRoot":"","sources":["../../../src/shared/types/ExecutionBinding.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/bin/shared/types/FeishuChannel.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Feishu 渠道共享类型。
+ *
+ * 关键点（中文）
+ * - 集中声明 Feishu 渠道的配置、事件、消息体与上传下载中间结构。
+ * - `services/chat/channels/feishu/*` 统一依赖这里，避免实现文件内联大量局部类型。
+ */
+/**
+ * 飞书适配器配置。
+ */
+export interface FeishuConfig {
+    /**
+     * 飞书应用 AppId。
+     */
+    appId: string;
+    /**
+     * 飞书应用 AppSecret。
+     */
+    appSecret: string;
+    /**
+     * 是否启用飞书渠道。
+     */
+    enabled: boolean;
+    /**
+     * 可选的飞书 Open API 域名。
+     */
+    domain?: string;
+}
+/**
+ * 飞书消息事件。
+ */
+export interface FeishuMessageEvent {
+    /**
+     * 发送者信息。
+     */
+    sender?: {
+        /**
+         * 发送者 ID 集合。
+         */
+        sender_id?: {
+            /**
+             * 用户 user_id。
+             */
+            user_id?: string;
+            /**
+             * 用户 open_id。
+             */
+            open_id?: string;
+            /**
+             * 用户 union_id。
+             */
+            union_id?: string;
+            /**
+             * 兼容 chat_id 字段。
+             */
+            chat_id?: string;
+        };
+    };
+    /**
+     * 消息主体。
+     */
+    message?: {
+        /**
+         * 会话 chat_id。
+         */
+        chat_id: string;
+        /**
+         * 原始内容 JSON。
+         */
+        content: string;
+        /**
+         * 消息类型。
+         */
+        message_type: string;
+        /**
+         * 会话类型。
+         */
+        chat_type: string;
+        /**
+         * 消息 ID。
+         */
+        message_id: string;
+        /**
+         * 根消息 ID。
+         */
+        root_id?: string;
+        /**
+         * 父消息 ID。
+         */
+        parent_id?: string;
+    };
+}
+/**
+ * 飞书消息发送类型。
+ */
+export type FeishuMessagePayloadType = "text" | "file" | "image" | "post";
+/**
+ * 飞书发送者归一化结果。
+ */
+export interface FeishuSenderIdentity {
+    /**
+     * 归一化后的发送者 ID。
+     */
+    senderId?: string;
+    /**
+     * 发送者 ID 的类型。
+     */
+    idType?: "open_id" | "user_id" | "union_id";
+}
+/**
+ * 飞书下载后的本地附件结构。
+ */
+export interface FeishuDownloadedAttachment {
+    /**
+     * 统一附件类型。
+     */
+    type: "document" | "photo" | "voice" | "audio" | "video";
+    /**
+     * 本地绝对路径。
+     */
+    path: string;
+    /**
+     * 可选说明文本。
+     */
+    desc?: string;
+}
+//# sourceMappingURL=FeishuChannel.d.ts.map

package/bin/shared/types/FeishuChannel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeishuChannel.d.ts","sourceRoot":"","sources":["../../../src/shared/types/FeishuChannel.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,MAAM,CAAC,EAAE;QACP;;WAEG;QACH,SAAS,CAAC,EAAE;YACV;;eAEG;YACH,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB;;eAEG;YACH,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB;;eAEG;YACH,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB;;eAEG;YACH,OAAO,CAAC,EAAE,MAAM,CAAC;SAClB,CAAC;KACH,CAAC;IACF;;OAEG;IACH,OAAO,CAAC,EAAE;QACR;;WAEG;QACH,OAAO,EAAE,MAAM,CAAC;QAChB;;WAEG;QACH,OAAO,EAAE,MAAM,CAAC;QAChB;;WAEG;QACH,YAAY,EAAE,MAAM,CAAC;QACrB;;WAEG;QACH,SAAS,EAAE,MAAM,CAAC;QAClB;;WAEG;QACH,UAAU,EAAE,MAAM,CAAC;QACnB;;WAEG;QACH,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB;;WAEG;QACH,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,IAAI,EAAE,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;IACzD;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}

package/bin/shared/types/FeishuChannel.js

@@ -0,0 +1,9 @@
+/**
+ * Feishu 渠道共享类型。
+ *
+ * 关键点（中文）
+ * - 集中声明 Feishu 渠道的配置、事件、消息体与上传下载中间结构。
+ * - `services/chat/channels/feishu/*` 统一依赖这里，避免实现文件内联大量局部类型。
+ */
+export {};
+//# sourceMappingURL=FeishuChannel.js.map

package/bin/shared/types/FeishuChannel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeishuChannel.js","sourceRoot":"","sources":["../../../src/shared/types/FeishuChannel.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/bin/shared/types/InlineInstant.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Inline 即时执行类型定义。
+ *
+ * 关键点（中文）
+ * - 统一描述 Chrome Extension Inline Composer 的“即时模式”请求与返回。
+ * - 即时模式始终走临时 session，执行完成后立即返回文本结果。
+ * - executor 只是即时模式的内部执行实现，不再暴露独立产品路径。
+ */
+/**
+ * Inline 即时执行器类型。
+ */
+export type InlineInstantExecutorType = "model" | "acp";
+/**
+ * Inline 即时执行请求输入。
+ */
+export interface ConsoleInlineInstantRunInput {
+    /**
+     * 本次即时执行选用的 executor 类型。
+     */
+    executorType: InlineInstantExecutorType;
+    /**
+     * 用户当前输入的问题或指令。
+     */
+    prompt: string;
+    /**
+     * 可选附加 system prompt。
+     */
+    system?: string;
+    /**
+     * 可选页面上下文文本。
+     *
+     * 说明（中文）
+     * - 通常由扩展侧把选区或整页快照整理成 Markdown 后传入。
+     */
+    pageContext?: string;
+    /**
+     * `model` executor 对应的模型池 modelId。
+     */
+    modelId?: string;
+    /**
+     * `acp` executor 对应的 agent 项目 id。
+     *
+     * 说明（中文）
+     * - 当前实现中等同于 agent 项目根目录绝对路径。
+     */
+    agentId?: string;
+}
+/**
+ * Inline 即时执行结果。
+ */
+export interface ConsoleInlineInstantRunResult {
+    /**
+     * 本次即时执行内部使用的临时 sessionId。
+     */
+    sessionId: string;
+    /**
+     * 实际执行使用的 executor 类型。
+     */
+    executorType: InlineInstantExecutorType;
+    /**
+     * 最终返回给前端展示的文本结果。
+     */
+    text: string;
+    /**
+     * 若为 `model` executor，则回传本次命中的 modelId。
+     */
+    modelId?: string;
+    /**
+     * 若为 `acp` executor，则回传本次命中的 agentId。
+     */
+    agentId?: string;
+}
+/**
+ * Inline 即时执行服务端口。
+ */
+export interface ConsoleInlineInstantService {
+    /**
+     * 运行一次即时执行请求。
+     */
+    run(input: ConsoleInlineInstantRunInput): Promise<ConsoleInlineInstantRunResult>;
+}
+//# sourceMappingURL=InlineInstant.d.ts.map

package/bin/shared/types/InlineInstant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InlineInstant.d.ts","sourceRoot":"","sources":["../../../src/shared/types/InlineInstant.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,OAAO,GAAG,KAAK,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,YAAY,EAAE,yBAAyB,CAAC;IAExC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,YAAY,EAAE,yBAAyB,CAAC;IAExC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;OAEG;IACH,GAAG,CACD,KAAK,EAAE,4BAA4B,GAClC,OAAO,CAAC,6BAA6B,CAAC,CAAC;CAC3C"}

package/bin/shared/types/InlineInstant.js

@@ -0,0 +1,10 @@
+/**
+ * Inline 即时执行类型定义。
+ *
+ * 关键点（中文）
+ * - 统一描述 Chrome Extension Inline Composer 的“即时模式”请求与返回。
+ * - 即时模式始终走临时 session，执行完成后立即返回文本结果。
+ * - executor 只是即时模式的内部执行实现，不再暴露独立产品路径。
+ */
+export {};
+//# sourceMappingURL=InlineInstant.js.map

package/bin/shared/types/InlineInstant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InlineInstant.js","sourceRoot":"","sources":["../../../src/shared/types/InlineInstant.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/bin/shared/types/Json.d.ts

@@ -0,0 +1,32 @@
+/**
+ * JSON 通用类型定义。
+ *
+ * 关键点（中文）
+ * - 用于约束跨模块传递的可序列化数据结构。
+ * - 避免在业务代码中使用宽泛断言，统一采用明确 JSON 类型。
+ */
+/**
+ * JSON 原子值。
+ *
+ * 说明（中文）
+ * - 对应 JSON 规范里的不可再展开标量值。
+ */
+export type JsonPrimitive = string | number | boolean | null;
+/**
+ * 任意 JSON 值。
+ *
+ * 说明（中文）
+ * - 可为标量、对象或数组。
+ */
+export type JsonValue = JsonPrimitive | JsonObject | JsonValue[];
+/**
+ * JSON 对象。
+ *
+ * 说明（中文）
+ * - key 固定为字符串。
+ * - value 继续递归约束为 `JsonValue`。
+ */
+export type JsonObject = {
+    [key: string]: JsonValue;
+};
+//# sourceMappingURL=Json.d.ts.map

package/bin/shared/types/Json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Json.d.ts","sourceRoot":"","sources":["../../../src/shared/types/Json.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAE7D;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,UAAU,GAAG,SAAS,EAAE,CAAC;AAEjE;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B,CAAC"}

package/bin/shared/types/Json.js

@@ -0,0 +1,9 @@
+/**
+ * JSON 通用类型定义。
+ *
+ * 关键点（中文）
+ * - 用于约束跨模块传递的可序列化数据结构。
+ * - 避免在业务代码中使用宽泛断言，统一采用明确 JSON 类型。
+ */
+export {};
+//# sourceMappingURL=Json.js.map

package/bin/shared/types/Json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Json.js","sourceRoot":"","sources":["../../../src/shared/types/Json.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/bin/shared/types/LlmConfig.d.ts

@@ -0,0 +1,100 @@
+/**
+ * LLM 配置类型定义。
+ *
+ * 设计目标（中文）
+ * - 将“provider 连接信息”与“model 选择/采样参数”解耦。
+ * - 支持在 console 全局层配置多个 provider 与多个 model。
+ * - 避免在每个 model 上重复填写 apiKey/baseUrl。
+ */
+/**
+ * Provider 类型枚举。
+ *
+ * 说明（中文）
+ * - `open-compatible` 表示 OpenAI 兼容（Chat Completions）网关。
+ * - `open-responses` 表示 OpenAI Responses 兼容网关。
+ * - `moonshot-cn` 表示 Moonshot(Kimi) 中国站 OpenAI 兼容网关。
+ * - `moonshot-ai` 表示 Moonshot(Kimi) 国际站 OpenAI 兼容网关。
+ * - `kimi-code` 表示 Kimi Code 的 OpenAI 兼容 coding 网关。
+ */
+export type LlmProviderType = "anthropic" | "openai" | "deepseek" | "gemini" | "open-compatible" | "open-responses" | "moonshot-cn" | "moonshot-ai" | "kimi-code" | "xai" | "huggingface" | "openrouter";
+/**
+ * 单个 provider 连接配置。
+ */
+export interface LlmProviderConfig {
+    /**
+     * Provider 类型。
+     * 决定运行时使用哪个 SDK 分支和默认 baseUrl。
+     */
+    type: LlmProviderType;
+    /**
+     * Provider API 基础地址。
+     * 可选；留空时按 `type` 使用内置默认地址。
+     */
+    baseUrl?: string;
+    /**
+     * Provider API 密钥。
+     * 建议使用 `${ENV_VAR}` 形式，启动时会自动解析环境变量。
+     */
+    apiKey?: string;
+}
+/**
+ * 单个模型配置。
+ */
+export interface LlmModelConfig {
+    /**
+     * 引用 `llm.providers` 的 key。
+     * 运行时会通过该 key 找到 provider 连接信息。
+     */
+    provider: string;
+    /**
+     * 上游模型名称。
+     * 例如：`claude-sonnet-4-5`、`gpt-4o`、`gemini-2.5-pro`。
+     */
+    name: string;
+    /**
+     * 采样温度。
+     * 值越高随机性越强。
+     */
+    temperature?: number;
+    /**
+     * 最大输出 token 数。
+     */
+    maxTokens?: number;
+    /**
+     * nucleus sampling 参数。
+     */
+    topP?: number;
+    /**
+     * 频率惩罚参数。
+     */
+    frequencyPenalty?: number;
+    /**
+     * 存在惩罚参数。
+     */
+    presencePenalty?: number;
+    /**
+     * Anthropic 专用版本字段（可选）。
+     */
+    anthropicVersion?: string;
+}
+/**
+ * Ship 主配置中的 llm 节点结构。
+ */
+export interface LlmConfig {
+    /**
+     * Provider 配置集合。
+     * key 由用户自定义（例如：`openai_main`、`google`）。
+     */
+    providers: Record<string, LlmProviderConfig>;
+    /**
+     * 模型配置集合。
+     * key 由用户自定义（例如：`fast`、`quality`、`coding`）。
+     */
+    models: Record<string, LlmModelConfig>;
+    /**
+     * 是否记录发给 LLM 的请求 payload。
+     * 默认启用；设为 false 可关闭。
+     */
+    logMessages?: boolean;
+}
+//# sourceMappingURL=LlmConfig.d.ts.map

package/bin/shared/types/LlmConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LlmConfig.d.ts","sourceRoot":"","sources":["../../../src/shared/types/LlmConfig.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;;GASG;AACH,MAAM,MAAM,eAAe,GACvB,WAAW,GACX,QAAQ,GACR,UAAU,GACV,QAAQ,GACR,iBAAiB,GACjB,gBAAgB,GAChB,aAAa,GACb,aAAa,GACb,WAAW,GACX,KAAK,GACL,aAAa,GACb,YAAY,CAAC;AAEjB;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,IAAI,EAAE,eAAe,CAAC;IACtB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAC7C;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACvC;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB"}