hiwork-core 0.0.30 → 0.0.37

package/lib/types/tools.d.ts

@@ -0,0 +1,80 @@
+import { type GenerateOutcome } from './imagegen.ts';
+import { IMAGE_TOOL_NAMES } from './tool-names.ts';
+export { IMAGE_TOOL_NAMES };
+/**
+ * 生图工具的单次预算（**工具层护栏**，不是业务判据）。
+ *
+ * 它必须**大于**客户端真正会等的时间，否则工具会先掐断客户端请求，把一次本可成功的
+ * 生图变成工具超时。客户端等待上限 = 网关预算 + 15s（见 `imageGenerateTimeoutMs`），
+ * 而网关预算的合法上界是 600s、读不到配置时走 900s 兜底 ⇒ 工具预算取 960s（16 分钟），
+ * 比两者都高。真正的超时语义由网关的 504 / `IMAGE_TIMEOUT` 表达。
+ *
+ * 实测背景：原值 330s 是按「网关默认 180s」估的，而网关上界 600s、实测单张已到 415s
+ * —— 按那条估算会在合法的慢生图上误报。
+ */
+export declare const IMAGE_TOOL_TIMEOUT_MS = 960000;
+/**
+ * 注册工具所需的最小 Agent 结构端口（不 import DSH agent 运行时）。
+ * 与 knowledge 的 `KnowledgeAgent` 同形：`id` 用于身份判定，`ctx.tools.register` 是落点。
+ */
+export type ImageAgent = {
+    readonly id: string;
+    readonly ctx: {
+        readonly tools: {
+            register(definition: unknown): () => void;
+        };
+    };
+};
+/**
+ * 工具执行期读到的会话/取消面（结构端口，便于单测直接伪造：
+ * `{ agent: { session: { header: { cwd } } }, signal }`）。
+ */
+export interface ImageToolExec {
+    readonly agent?: {
+        readonly session?: {
+            readonly header?: {
+                readonly cwd?: string;
+            };
+        };
+    } | undefined;
+    readonly signal: AbortSignal;
+}
+/** 工具对 Host 生图服务的全部要求（生产由 `src/imagegen.ts` 的 `generateImageFile` 满足）。 */
+export interface ImageToolService {
+    generate(request: {
+        prompt: string;
+        size?: string | undefined;
+        workspaceRoot?: string | undefined;
+    }): Promise<GenerateOutcome>;
+}
+/** 工具的模型可见描述（设计 §6.3 逐字冻结）。 */
+export declare const IMAGE_GENERATE_DESCRIPTION: string;
+/** 卡片数据源（JSON 形态）：与 `GenerateOutcome` 同形，外加给模型读的 `text`。 */
+export interface ImageToolValue {
+    ok: boolean;
+    /** 给模型读的那段话（见 {@link formatImageGenerateText}）。 */
+    text: string;
+    files: Array<{
+        path: string;
+        mimeType: string;
+        byteSize: number;
+        revisedPrompt?: string;
+    }>;
+    prompt?: string;
+    model?: string;
+    size?: string;
+    generationMs?: number;
+    code?: string;
+    message?: string;
+}
+/** 模型可见的那段话（成功：路径 + 尺寸/模型/耗时 + 落盘说明；失败：原因 + 可执行提示）。 */
+export declare function formatImageGenerateText(outcome: GenerateOutcome): string;
+/** `GenerateOutcome` → 工具结果（卡片与模型共用同一份 JSON）。 */
+export declare function toImageToolValue(outcome: GenerateOutcome): ImageToolValue;
+/**
+ * 给一个根 Agent 注册生图工具。
+ * @param service - Host 侧生图服务（生产是 `src/imagegen.ts` 的 `generateImageFile`）。
+ * @param agent - 目标根 Agent。
+ * @returns 注销器（注销全部已注册工具）。
+ */
+export declare function registerImageTools(service: ImageToolService, agent: ImageAgent): () => void;

package/lib/types/user-agent.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 发往网关的 `User-Agent`：`hiwork/<桌面端版本>`。
+ *
+ * 「客户端」在网关侧就是这一条头（请求日志的客户端列、排障时的流量归属），所以它必须报
+ * **产品 + 版本**，而不是插件内部包名。版本号取桌面端版本：这是运维真正关心的维度
+ * （哪一版客户端），插件版本对同一台机器上的所有请求都相同，报它区分不出客户端版本。
+ *
+ * 版本来源的优先级（高 → 低）：
+ *  1. 环境变量 `HIWORK_APP_VERSION`——桌面端拉起 DSH 时注入，**宿主进程一启动就有**；
+ *  2. 桌面端经 IPC 推来的设备信息里的 `appVersion`（见 `src/browser-login.ts`）——
+ *     推送发生在宿主就绪之后，早于它的请求拿不到，所以只作兜底；
+ *  3. 两者都没有（纯 `dsh web` / CLI 场景）——回报插件自身的 `hiwork-core/<插件版本>`，
+ *     不拿插件版本冒充桌面端版本。
+ *
+ * 值一律经 {@link headerSafeVersion} 过滤后再进 header：环境变量与 IPC 都可能带来空串、
+ * 前后空白或换行，而 fetch 遇到非法 header 值会直接抛错——那会让每一次网关请求都失败。
+ */
+/** 桌面端注入自身版本用的环境变量名；两侧契约，改这里必须同步 `hiwork-desktop/src/main.ts`。 */
+export declare const DESKTOP_APP_VERSION_ENV = "HIWORK_APP_VERSION";
+/**
+ * 桌面端版本号。
+ * @param env - 环境变量表；缺省 `process.env`（测试可注入）。
+ * @returns 版本号；环境变量与 IPC 都没有时 undefined。
+ */
+export declare function desktopAppVersion(env?: NodeJS.ProcessEnv): string | undefined;
+/**
+ * 网关请求的 User-Agent。
+ * @param version - 桌面端版本；缺省按 {@link desktopAppVersion} 解析（测试可注入）。
+ * @returns `hiwork/<桌面端版本>`；拿不到桌面端版本时 `hiwork-core/<插件版本>`。
+ */
+export declare function gatewayUserAgent(version?: string | undefined): string;

package/lib/user-agent.js

@@ -0,0 +1,54 @@
+/**
+ * 发往网关的 `User-Agent`：`hiwork/<桌面端版本>`。
+ *
+ * 「客户端」在网关侧就是这一条头（请求日志的客户端列、排障时的流量归属），所以它必须报
+ * **产品 + 版本**，而不是插件内部包名。版本号取桌面端版本：这是运维真正关心的维度
+ * （哪一版客户端），插件版本对同一台机器上的所有请求都相同，报它区分不出客户端版本。
+ *
+ * 版本来源的优先级（高 → 低）：
+ *  1. 环境变量 `HIWORK_APP_VERSION`——桌面端拉起 DSH 时注入，**宿主进程一启动就有**；
+ *  2. 桌面端经 IPC 推来的设备信息里的 `appVersion`（见 `src/browser-login.ts`）——
+ *     推送发生在宿主就绪之后，早于它的请求拿不到，所以只作兜底；
+ *  3. 两者都没有（纯 `dsh web` / CLI 场景）——回报插件自身的 `hiwork-core/<插件版本>`，
+ *     不拿插件版本冒充桌面端版本。
+ *
+ * 值一律经 {@link headerSafeVersion} 过滤后再进 header：环境变量与 IPC 都可能带来空串、
+ * 前后空白或换行，而 fetch 遇到非法 header 值会直接抛错——那会让每一次网关请求都失败。
+ */
+import { PKG_VERSION } from "./version.js";
+import { pushedAppVersion } from "./browser-login.js";
+/** 桌面端注入自身版本用的环境变量名；两侧契约，改这里必须同步 `hiwork-desktop/src/main.ts`。 */
+export const DESKTOP_APP_VERSION_ENV = 'HIWORK_APP_VERSION';
+/**
+ * 版本号允许的形态：以字母或数字开头，其后只允许 semver 常见字符（`0-9 A-Z a-z . + - _`）。
+ *
+ * **必须是白名单，不能只过滤控制字符**：换成「删掉 `\n` 就放行」的写法时，
+ * `"1.0.7\nX-Injected: evil"` 会被拼成 `hiwork/1.0.7X-Injected: evil` —— 换行没了，
+ * 但被注入的文本原样进了 header，运维在网关看到的是一串看不懂的客户端名。
+ * 版本号本来就不该含空格/冒号，所以「不像版本号就当作没拿到」比「尽量修好它」正确。
+ */
+const versionPattern = /^[0-9A-Za-z][0-9A-Za-z.+_-]*$/;
+/** 版本号安全化：只接受白名单形态；空串、含空白/控制字符/其他标点一律视为「没拿到版本」。 */
+function headerSafeVersion(value) {
+    if (value === undefined)
+        return undefined;
+    const trimmed = value.trim();
+    return versionPattern.test(trimmed) ? trimmed : undefined;
+}
+/**
+ * 桌面端版本号。
+ * @param env - 环境变量表；缺省 `process.env`（测试可注入）。
+ * @returns 版本号；环境变量与 IPC 都没有时 undefined。
+ */
+export function desktopAppVersion(env = process.env) {
+    return headerSafeVersion(env[DESKTOP_APP_VERSION_ENV]) ?? headerSafeVersion(pushedAppVersion());
+}
+/**
+ * 网关请求的 User-Agent。
+ * @param version - 桌面端版本；缺省按 {@link desktopAppVersion} 解析（测试可注入）。
+ * @returns `hiwork/<桌面端版本>`；拿不到桌面端版本时 `hiwork-core/<插件版本>`。
+ */
+export function gatewayUserAgent(version = desktopAppVersion()) {
+    const safe = headerSafeVersion(version);
+    return safe === undefined ? `hiwork-core/${PKG_VERSION}` : `hiwork/${safe}`;
+}

package/lib/web-search.js

@@ -34,7 +34,7 @@
  * 端口，接线方（index.ts）传真实 ctx 侧依赖；单测直接伪造。
  */
 import { WebError } from '@deepseek-ai/dsh-web';
-import { PKG_VERSION } from "./version.js";
+import { gatewayUserAgent } from "./user-agent.js";
 /** 本 provider 注册进 `ctx.web` 用的稳定 id（cordis.patch.yml 的 searchProvider pin 与它逐字一致）。 */
 export const HIWORK_SEARCH_PROVIDER_ID = 'hiwork-managed-search';
 /** 网关侧端点（跨仓冻结；会话鉴权与 `/api/me/memory-config` 同一条）。 */
@@ -208,7 +208,7 @@ export function createWebSearchGateway(baseURL, opts = {}) {
                 res = await doFetch(`${root}${ME_WEB_SEARCH_PATH}`, {
                     method: 'POST',
                     headers: {
-                        'user-agent': `hiwork-core/${PKG_VERSION}`,
+                        'user-agent': gatewayUserAgent(),
                         cookie: sessionCookie,
                         'content-type': 'application/json',
                     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hiwork-core",
-  "version": "0.0.30",
+  "version": "0.0.37",
   "type": "module",
   "description": "HiWork 企业统一登录与模型自动供给插件（ai-router 网关登录，Web 表单，无 CLI 认证）",
   "license": "UNLICENSED",
@@ -32,6 +32,7 @@
         "@deepseek-ai/dsh-client-store",
         "@deepseek-ai/dsh-client-ui-slots",
         "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-ui-layout",
         "@deepseek-ai/dsh-api-remotes",
         "@deepseek-ai/dsh-client-ui-primitives",
         "@deepseek-ai/dsh-client-ui-chat",
@@ -40,29 +41,35 @@
     }
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis": "4.0.2"
+    "@deepseek-ai/cordis": "~4.0.4",
+    "@deepseek-ai/dsh-client-ui-layout": ">=0.1.0-rc.5 <0.2.0"
   },
   "devDependencies": {
-    "@deepseek-ai/cordis": "4.0.2",
-    "@deepseek-ai/dsh-api-remotes": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-store": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-ui-chat": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-ui-conversation": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-ui-primitives": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-ui-renderer": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-ui-session": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-ui-settings": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-ui-sidebar": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-ui-slots": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-credentials": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-credentials-local": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-llm": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-llm-pi-ai": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-settings": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-settings-file": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-web": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-workspace": "0.1.5-rc.1",
-    "@deepseek-ai/schemastery": "3.18.2",
+    "@deepseek-ai/cordis": "4.0.4",
+    "@deepseek-ai/cordis-plugin-loader": "1.0.5",
+    "@deepseek-ai/dsh-agent-default-model": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-api-remotes": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-app-boot": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-attachment": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-store": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-chat": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-conversation": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-session": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-settings": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-sidebar": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-config-editor": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-credentials": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-credentials-local": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-llm": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-llm-pi-ai": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-settings": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-tools": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-web": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-workspace": "0.1.7-rc.2",
+    "@deepseek-ai/schemastery": "3.18.4",
     "@types/node": "^22",
     "@types/react": "^18",
     "@types/react-dom": "^18",
@@ -72,13 +79,16 @@
     "react-dom": "^18",
     "tsx": "^4.23.12",
     "typescript": "^5",
-    "vitest": "^3"
+    "vitest": "^3",
+    "yaml": "^2.8.1",
+    "@deepseek-ai/dsh-client-ui-layout": "0.1.7-rc.2"
   },
   "scripts": {
     "typecheck": "tsc --noEmit",
     "build:host": "tsc -p tsconfig.build.json && node scripts/host-build.mjs",
     "build:client": "tsc -p tsconfig.client-build.json && node scripts/client-build.mjs",
     "build": "npm run build:host && npm run build:client",
-    "test": "vitest run"
+    "test": "vitest run",
+    "smoke": "tsx scripts/smoke/smoke.ts"
   }
 }