hiwork-core 0.0.1

package/lib/types/client/hero-greeting.d.ts

@@ -0,0 +1,27 @@
+/**
+ * hero 问候语轮换（每日卡片的同页组件，自 hiwork-dsh-ui 静态版演化）：
+ * 官方口号「探索未至之境 / Into the Unknown」替换为「HiWork，+ 候选池随机一条」，
+ * 前缀固定保留，候选每次进入 hero 页时随机切换（排除上一条，不重复）；
+ * 同时隐藏鱼形品牌标记与「预览版」徽标。
+ *
+ * 实现：宿主 headlineText 用 CSS 归零隐藏，问候语是插件自有（data-hiwork-hero-greeting
+ * 标记）的相邻 span，由观察器幂等插入——不搬移/不改写宿主节点，宿主重建 hero 时自动
+ * 重挂并换下一条，非 hero 阶段自动清残留。样式 id 改用 hiwork 前缀：本模块已是
+ * dsh-ui 静态 ::after 版的超集，两版并存会双份文案。
+ */
+/** 问候候选池（前缀 HiWork，之后的部分），措辞逐字保留产品定稿。 */
+export declare const HERO_GREETINGS: readonly string[];
+/** 固定前缀：所有候选共用，轮换的只是后半句。 */
+export declare const HERO_GREETING_PREFIX = "HiWork\uFF0C";
+export declare const HERO_STYLE_ID = "hiwork-conversation-hero-style";
+export declare const HERO_STYLE = "\n[class*=\"_fishHitbox\"],\n[class*=\"_previewBadge\"]{display:none}\n[class*=\"_headline\"]:not([class*=\"_headlineText\"]){display:flex;justify-content:center;align-items:center;column-gap:0}\n[class*=\"_headlineText\"]{font-size:0}\n[data-hiwork-hero-greeting]{font-size:26px;line-height:32px;font-weight:500}\n";
+export declare function ensureHeroStyle(doc?: Document): void;
+/** 随机取一条候选；命中上一条时顺移一位，保证连续两次不重复。 */
+export declare function pickHeroGreeting(): string;
+/**
+ * 幂等装饰：hero / headlineText 缺失 → 只清残留；问候 span 已紧邻 headlineText →
+ * 不动（观察循环不得反复重掷）；否则清掉旧 span 后在 headlineText 之后插入新随机一条。
+ */
+export declare function decorateHeroGreeting(doc: Document): void;
+/** 清理非 hero / 槽位变化后残留的问候节点。 */
+export declare function removeStaleHeroGreeting(doc: Document): void;

package/lib/types/client/index.d.ts

@@ -0,0 +1,5 @@
+import type { Context as ClientContext } from '@deepseek-ai/cordis';
+/** 浏览器插件契约（dsh client module system）。connection 随 IApiClient 移除后不再依赖。 */
+export declare const inject: string[];
+/** 挂载网关模型设置 section（一级 tab）与未登录弹窗。 */
+export declare function apply(ctx: ClientContext): void;

package/lib/types/client/login-gate.d.ts

@@ -0,0 +1,13 @@
+import type { SettingsScope } from '@deepseek-ai/dsh-client-ui-settings/client';
+import type { CredentialStorePort } from './controller.ts';
+import { type AiRouterCardSettings } from './controller.ts';
+export declare function loginGateVisible(snapshot: {
+    status: string;
+    value?: {
+        lastLogin?: unknown;
+        lastError?: {
+            code?: string;
+        };
+    } | undefined;
+} | undefined): boolean;
+export declare function mountLoginGate(scope: SettingsScope<AiRouterCardSettings>, storeCredential: CredentialStorePort): () => void;

package/lib/types/client/logo.d.ts

@@ -0,0 +1,6 @@
+/** HiWork 品牌资产（与 hiwork-dsh-ui 同源）：方标 / 词标 / 横版组合标（登录页用）。 */
+export declare const HIWORK_LOGO: string;
+export declare const HIWORK_LOGO_TEXT: string;
+export declare const HIWORK_LOGO_WITH_TEXT: string;
+/** HiWork 产品版本：品牌展示元素，与 hiwork-dsh-ui 的 HIWORK_VERSION 保持一致。 */
+export declare const HIWORK_VERSION = "1.0.2";

package/lib/types/client/section.d.ts

@@ -0,0 +1,9 @@
+import type { InjectFace, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import { type AiRouterCardFace } from './controller.ts';
+/**
+ * 设置页一级 section（tab）：网关模型 —— 与「通用设置」同级的独立页面，
+ * 展示网关下发的模型额度与虚拟 KEY；未登录时由登录门禁接管，本 section 不渲染。
+ */
+export type AiRouterSectionProps = PropsRuntime<'settings.section'> & InjectFace<AiRouterCardFace>;
+/** 网关模型设置 section。 */
+export declare function AiRouterSection(props: AiRouterSectionProps): import("react").JSX.Element | null;

package/lib/types/client/settings-nav-icon.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 设置导航「关于」分区图标：官方设置壳只给少数自带分区画专用图标，自定义分区
+ * 回退齿轮。这里按导航可见文案把「关于」的图标换成官方问号圆环（路径取自
+ * ui-primitives 的 IconQuestionOutline14，与官方图标同源），机制与 hiwork-dsh-ui
+ * 的 settings-nav-icons 同款：MutationObserver + rAF 按帧合并，data 标记幂等。
+ */
+export declare const ABOUT_NAV_ICON_ID = "hiwork-about-nav";
+export declare const ABOUT_NAV_ICON_PATHS = "<path fill=\"currentColor\" d=\"M12.5757 7.00012C12.5757 3.92085 10.0794 1.42463 7.00012 1.42456C3.9208 1.42456 1.42456 3.9208 1.42456 7.00012C1.42463 10.0794 3.92085 12.5757 7.00012 12.5757C10.0793 12.5756 12.5756 10.0793 12.5757 7.00012ZM13.8002 7.00012C13.8001 10.7559 10.7559 13.8001 7.00012 13.8002C3.2443 13.8002 0.199291 10.7559 0.199219 7.00012C0.199219 3.24426 3.24426 0.199219 7.00012 0.199219C10.7559 0.199291 13.8002 3.2443 13.8002 7.00012Z\"/><path fill=\"currentColor\" d=\"M6.18042 8.68184C6.18043 8.09153 6.32893 7.34655 6.92127 6.8481C7.28566 6.54148 7.76104 6.27318 8.0022 6.10811C8.28964 5.91137 8.42234 5.76562 8.48328 5.58944C8.57774 5.31609 8.53121 5.00904 8.34912 4.76741C8.17409 4.53522 7.83879 4.32222 7.28186 4.32222C5.99668 4.32225 5.46969 5.11832 5.46949 5.78939H4.24414C4.24436 4.39942 5.36327 3.09691 7.28186 3.09688C8.17773 3.09688 8.89489 3.45606 9.32752 4.02999C9.75287 4.59438 9.86938 5.32775 9.64026 5.99019C9.44847 6.5444 9.04722 6.87743 8.69434 7.11898C8.29506 7.39226 8.02318 7.52192 7.70996 7.78548C7.51943 7.94582 7.40577 8.24899 7.40577 8.68184V8.75533H6.18042V8.68184Z\"/><path fill=\"currentColor\" d=\"M7.39455 9.44026V10.8109H6.16921V9.44026H7.39455Z\"/>";
+/** 给「关于」导航钮换官方问号圆环图标；已打标（幂等）或无 svg 时不动。 */
+export declare function applyAboutNavIcon(button: HTMLButtonElement): boolean;
+export declare function applyAboutNavIcons(root: ParentNode): number;
+/** 观察设置导航，宿主重渲染重建按钮后自动补换图标；返回卸载清理函数。 */
+export declare function observeAboutNavIcon(doc?: Document): () => void;

package/lib/types/client/settings-navigation.d.ts

@@ -0,0 +1,11 @@
+/**
+ * DSH 设置壳暂未提供按 section id 打开的公开 API。该兼容层移植自 hiwork-dsh-ui，
+ * 从本插件渲染的设置入口触发：先打开设置弹窗，再按壳的可访问名称选择分区页；
+ * 宿主升级时可集中替换。
+ */
+export declare function pickSettingsSectionButton<T extends {
+    textContent: string | null;
+}>(buttons: readonly T[], labels: readonly string[]): T | undefined;
+/** 取消在途跳转（测试隔离用；生产生命周期里看门狗超时自会清理）。 */
+export declare function resetSettingsNavigationForTests(): void;
+export declare function openSettingsSection(root: HTMLElement | null, label: string | readonly string[], onMissing?: () => void): void;

package/lib/types/client/styles.d.ts

@@ -0,0 +1,79 @@
+/**
+ * hiwork-core client 共享样式：全面跟随 dsh 主题 token（--dsw-alias-*、--dsw-static-*）。
+ * 亮色/暗色（body[data-ds-dark-theme]）由 dsh 在 body 上定义的两套 CSS 变量自动切换，
+ * 因此这里全部走变量引用 + 浏览器降级 fallback，插件无需感知主题状态。
+ *
+ * 内联样式无法表达 :hover/:focus，主/次按钮以实心/描边区分视觉层级；
+ * 输入框聚焦态、按钮 hover、placeholder 由 interactionCss 的数据属性选择器补充
+ *（client 入口 apply() 时注入一次，见 index.ts）。
+ */
+import type { CSSProperties } from 'react';
+/** DSH 品牌蓝：业务主色（亮色 deepseek-500 #4176e6 / 暗色 deepseek-400 #679efe）。 */
+export declare const brandAccent = "var(--dsw-alias-state-business-primary, #4176e6)";
+/** 主按钮填充：dsh 原生主按钮 = brand-primary（亮色近黑 #0f1115 / 暗色近白 #f9fafb）。 */
+export declare const primaryFill = "var(--dsw-alias-button-primary-fill, #0f1115)";
+/** 主按钮 hover 填充（由 interactionCss 应用）。 */
+export declare const primaryHover = "var(--dsw-alias-button-primary-hover, #43454a)";
+/** 主按钮文字：inverted 层级（亮色白 / 暗色深，与主按钮填充相反）。 */
+export declare const onPrimary = "var(--dsw-alias-label-primary-inverted, #ffffff)";
+export declare const textPrimary = "var(--dsw-alias-label-primary, #0f1115)";
+export declare const textSecondary = "var(--dsw-alias-label-secondary, #61666b)";
+export declare const textTertiary = "var(--dsw-alias-label-tertiary, #81858c)";
+export declare const textCaption = "var(--dsw-alias-label-caption, #adb2b8)";
+export declare const borderL2 = "var(--dsw-alias-border-l2, rgba(15,17,21,0.1))";
+export declare const bgLayer1 = "var(--dsw-alias-bg-layer-1, #ffffff)";
+export declare const bgLayer2 = "var(--dsw-alias-bg-layer-2, #f1f3f5)";
+/** dsh 登录输入框专用底（亮色 bluish-50 / 暗色 bluish-900），兼顾一般表单输入。 */
+export declare const inputFill = "var(--dsw-specific-login-input, var(--dsw-alias-bg-layer-2, #f1f3f5))";
+export declare const interactiveHover = "var(--dsw-alias-interactive-bg-hover, rgba(15,17,21,0.06))";
+export declare const errorText = "var(--dsw-alias-state-error-primary, #ec1313)";
+export declare const warnText = "var(--dsw-alias-state-warn-label, #dd8629)";
+export declare const warnFill = "var(--dsw-alias-state-warn-tertiary, #fef5e7)";
+/** 主按钮（登录）。数据属性 data-hiwork-core-primary 挂 hover。 */
+export declare const primaryButton: CSSProperties;
+/** 次按钮（刷新/退出/暂不登录/我已分配 KEY）：透明描边 ghost 风格。 */
+export declare const secondaryButton: CSSProperties;
+/** 禁用态（叠加到主/次按钮样式上）。 */
+export declare const disabledButton: CSSProperties;
+/** 文本输入框：dsh 登录输入框底 + 描边，聚焦光晕由 interactionCss 提供。 */
+export declare const textInput: CSSProperties;
+/**
+ * 主框架外观（对齐 Codex/WorkBuddy）：
+ * - 框架底色改侧栏灰，内容区仅左上角圆角（16px），缺口露出侧栏色；
+ *   其余三角直角、贴边不悬浮——与 Codex/WorkBuddy 桌面端一致。
+ * - 不再画任何分隔描边/边框线，层次靠背景色差区分。
+ * - 左上角圆角仅 Windows 生效：宿主 preload（dsh-view-preload.cts）在 <html> 注入
+ *   data-dsh-shell=process.platform；Windows 顶栏与侧栏同色，圆角呼应顶栏，
+ *   其余平台（含无该属性的纯浏览器预览）默认关闭，回到直角。
+ * 内容区根节点类名是 CSS module 哈希前缀（如 wSkVaW_root），语义后缀稳定；
+ * 用直接子链 `[class*="_centerCol"] > div > [class*="_root"]` 恰好命中会话区
+ * 根节点（实测唯一），避免误伤内容区里 10 个嵌套组件的 _root。
+ * 圆角裁切天然成立：会话区根节点自带 overflow:hidden，头部页签/气泡/输入框
+ * 都会被裁切；颜色全部走主题变量，亮暗自动切换。
+ * 侧栏右缘 0.5px 原生分界线一并归零（与内容区无边框保持一致）。
+ */
+export declare const frameCss: string;
+/**
+ * 隐藏宿主动作入口：
+ * - 会话头部右上角「Session 日志」下载按钮（产品要求不暴露会话日志导出）；
+ * - 侧栏底部官方「设置」触发钮：账号行（sidebar.footer.action）自带设置入口。
+ *   注意官方设置弹窗面板 portal 在 settingsArea 容器内部渲染，只能隐藏触发钮
+ *   本身（settingsArea 整区 display:none 会连弹窗一起藏掉）；触发钮留在 DOM 里
+ *   供 openSettingsSection 程序化点击（display:none 不影响 .click() 派发，
+ *   dsh-ui 同款做法），弹窗照常打开。
+ * 均按 CSS module 语义后缀命中（hash 前缀无关；运行版实测
+ * nL4_yW_sessionLogButton / hHd-Xa_settingsArea）。display:none 同时移出
+ * 无障碍树与 Tab 焦点链。后续要隐藏其他宿主入口，规则追加到这里。
+ */
+export declare const hostHideCss: string;
+/**
+ * 品牌区样式：词标资产只有深色版，暗色主题下整体反白（纯色 logo 反转无损；
+ * body[data-ds-dark-theme] 为 dsh 暗色选择器，与 hiwork-dsh-ui 同款）。
+ * 由 client 入口 apply() 与 interactionCss 一起注入一次（见 index.ts）。
+ */
+export declare const brandCss: string;
+/**
+ * 补充交互样式：挂在 input/button 的 data 属性上，跟随主题变量。
+ * 由 client 入口 apply() 注入一次（带 id 防重）。
+ */
+export declare const interactionCss: string;

package/lib/types/client/types.d.ts

@@ -0,0 +1,7 @@
+/** 稳定错误码，供 settings card 分支渲染。 */
+export type LoginErrorCode = 'AUTH_FAILED' | 'RATE_LIMITED' | 'GATEWAY_UNREACHABLE' | 'NO_KEY_ASSIGNED' | 'SESSION_EXPIRED' | 'KEY_DISABLED' | 'KEY_INVALID';
+/** 一个稳定的、可安全展示的登录/刷新错误。 */
+export interface LoginError {
+    code: LoginErrorCode;
+    message: string;
+}

package/lib/types/client/user-badge.d.ts

@@ -0,0 +1,14 @@
+import type { InjectFace, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import { type AiRouterCardFace } from './controller.ts';
+/**
+ * 侧边栏底部「设置」上方的账号信息行：显示当前登录网关的显示名（网关 LDAP
+ * 中文名，缺省回退登录账号）。「头像 + 用户名」是一个合并钮，hover 高亮与点击
+ * 直达设置弹窗「网关模型」分区覆盖整块（避免只点头像无响应）；行尾紧跟「设置」
+ * 「退出账号」两个独立图标钮（退出带二次确认）。
+ * 宽侧栏（wide）显示头像 + 用户名 + 图标钮；窄栏（rail）只显示头像，头像本身即
+ * 设置入口。行几何（高度/留白/字号/图标尺寸）与 ui-settings-general 的设置触发
+ * 行完全一致。
+ */
+export type UserBadgeProps = PropsRuntime<'sidebar.footer.action'> & InjectFace<AiRouterCardFace>;
+/** 底部账号信息行。 */
+export declare function UserBadge(props: UserBadgeProps): import("react").JSX.Element | null;

package/lib/types/default-workspace.d.ts

@@ -0,0 +1,6 @@
+import type { WorkspaceRegistry } from '@deepseek-ai/dsh-workspace';
+export declare const DEFAULT_WORKSPACE_DIR: string;
+export declare const DEFAULT_WORKSPACE_TITLE = "\u9ED8\u8BA4\u5DE5\u4F5C\u533A";
+/** 结构化最小契约：单测 stub 不必实现整个 WorkspaceRegistry。 */
+export type WorkspaceRegistryPort = Pick<WorkspaceRegistry, 'list' | 'create'>;
+export declare function ensureDefaultWorkspace(registry: WorkspaceRegistryPort, warn: (message: string) => void, dir?: string): Promise<void>;

package/lib/types/index.d.ts

@@ -0,0 +1,53 @@
+/**
+ * hiwork-core：企业 ai-router 网关登录 + 模型自动加载插件（Host 半边）。
+ * 注册 `ai-router` settings 命名空间；卡片写入的请求字段（pendingLogin /
+ * refreshRequest / logoutRequest）经 settings.installSection 的 onChange 触发
+ * 编排，编排结果回写该命名空间的状态字段（lastLogin / lastError）。
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import z from '@deepseek-ai/schemastery';
+export declare const name = "hiwork-core";
+export declare const inject: string[];
+/** 插件配置 + 运行时状态字段（全部可选；写操作按此 schema 校验）。 */
+export interface Config {
+    baseURL?: string;
+    keyId?: string;
+    username?: string;
+    displayName?: string;
+    lastLogin?: {
+        at: string;
+        modelCount: number;
+        gatewayName: string;
+    };
+    lastError?: {
+        code: string;
+        message: string;
+    };
+    pendingLogin?: {
+        username: string;
+        passwordRef: string;
+    };
+    rememberPassword?: boolean;
+    refreshRequest?: {
+        at: string;
+    };
+    logoutRequest?: {
+        at: string;
+    };
+    budgets?: Array<{
+        model_name: string;
+        total_budget?: number | null;
+        consumed_budget?: number | null;
+        remaining_budget?: number | null;
+    }>;
+    keys?: Array<{
+        id: string;
+        employee_name?: string;
+        team_name?: string;
+        enabled?: boolean;
+        max_concurrency?: number;
+        key_masked?: string;
+    }>;
+}
+export declare const Config: z<Config>;
+export declare function apply(ctx: Context, config: Config): void;

package/lib/types/orchestration.d.ts

@@ -0,0 +1,91 @@
+import { type GatewayBudget, type GatewayClient, type GatewayKey } from './ai-router-client.ts';
+import type { LoginError } from './types.ts';
+/** 凭据端口：对 ctx.credentials 的抽象，便于测试。 */
+export interface CredentialsPort {
+    resolve(ref: string): Promise<{
+        value: string;
+    } | undefined>;
+    set(ref: string, value: string): Promise<void>;
+    unset(ref: string): Promise<void>;
+}
+/** pi-ai 配置端口：写/清协议路由集合（多路由按协议拆分）。 */
+export interface PiAiPort {
+    applyAiRouterProfiles(profiles: Record<string, Record<string, unknown>> | null): Promise<void>;
+}
+/** 对 ai-router 状态段的一次补丁。 */
+export interface AiRouterStatePatch {
+    set?: Record<string, unknown>;
+    unset?: readonly string[];
+}
+/** ai-router 状态端口：Host 的唯一写者。 */
+export interface AiRouterStatePort {
+    patch(patch: AiRouterStatePatch): Promise<void>;
+}
+/** ai-router 命名空间解析后的值（相关字段）。 */
+export interface AiRouterNamespaceValue {
+    baseURL?: string;
+    keyId?: string;
+    username?: string;
+    /** 登录账号的显示名（网关 LDAP displayName，如中文名）；缺省时 UI 回退 username。 */
+    displayName?: string;
+    pendingLogin?: {
+        username: string;
+        passwordRef: string;
+    };
+    rememberPassword?: boolean;
+    refreshRequest?: {
+        at?: string;
+    };
+    logoutRequest?: {
+        at?: string;
+    };
+    /** 最近一次拉取到的各模型额度（登录/刷新时写入）。 */
+    budgets?: readonly GatewayBudget[];
+    /** 最近一次拉取到的当前用户全部虚拟 Key（多 Key 选择器数据源）。 */
+    keys?: readonly GatewayKey[];
+}
+/**
+ * 归一化 budgets：过滤空模型名与已下架模型（model_status === 'inactive'，已不可调用，
+ * 不进入额度展示），保留额度字段。状态缺省（旧网关）视同 active，正常保留。
+ */
+export declare function computeBudgets(budgets: readonly GatewayBudget[]): GatewayBudget[];
+/** 归一化 keys：过滤无 id 项，只保留选择器需要的字段。 */
+export declare function computeKeys(keys: readonly GatewayKey[]): GatewayKey[];
+/** 任意抛错 → 稳定 LoginError；GatewayError 原样，其余归为 GATEWAY_UNREACHABLE。 */
+export declare function toLoginError(error: unknown, fallback: string): LoginError;
+/** 执行一次登录：拉 Key + budgets → 写凭据 → 写 pi-ai 配置 → 写状态。 */
+export declare function runLogin(opts: {
+    gateway: GatewayClient;
+    credentials: CredentialsPort;
+    piAi: PiAiPort;
+    state: AiRouterStatePort;
+    /** 登录成功尾部触发（默认工作区 ensure 等）；可选以便既有测试直接构造 opts。 */
+    ensureWorkspace?: () => Promise<void>;
+    value: AiRouterNamespaceValue;
+}): Promise<LoginError | null>;
+/** 用已存会话刷新模型列表。 */
+export declare function runRefresh(opts: {
+    gateway: GatewayClient;
+    credentials: CredentialsPort;
+    piAi: PiAiPort;
+    state: AiRouterStatePort;
+    /** 透传给重登路径 runLogin 的可选端口。 */
+    ensureWorkspace?: () => Promise<void>;
+    value: AiRouterNamespaceValue;
+}): Promise<LoginError | null>;
+/** 退出登录：best-effort 登出 + 清凭据与 pi-ai 配置。 */
+export declare function runLogout(opts: {
+    gateway: GatewayClient;
+    credentials: CredentialsPort;
+    piAi: PiAiPort;
+    state: AiRouterStatePort;
+}): Promise<void>;
+/** 分发一次 ai-router 命名空间变更：三个请求字段至多存在一个。 */
+export declare function handleAiRouterSectionChange(opts: {
+    gateway: GatewayClient;
+    credentials: CredentialsPort;
+    piAi: PiAiPort;
+    state: AiRouterStatePort;
+    ensureWorkspace?: () => Promise<void>;
+    value: AiRouterNamespaceValue;
+}): Promise<LoginError | null>;

package/lib/types/provision.d.ts

@@ -0,0 +1,84 @@
+import type { GatewayModelMapping } from './ai-router-client.ts';
+/** ai-router 路由的凭据 ref 名（dsh Models 页 deriveKeyRef 惯例）。 */
+export declare const API_KEY_REF = "AI_ROUTER_API_KEY";
+/** 网关会话 cookie 的凭据 ref 名。 */
+export declare const SESSION_REF = "AI_ROUTER_SESSION";
+/** 登录中的临时密码 ref 名（用完即清）。 */
+export declare const PENDING_PASSWORD_REF = "AI_ROUTER_PENDING_PASSWORD";
+/** 勾选“记住密码”后保存的凭据 ref（由 credentials provider 加密存储）。 */
+export declare const REMEMBERED_PASSWORD_REF = "AI_ROUTER_REMEMBERED_PASSWORD";
+/**
+ * 注册到 llm-pi-ai 的协议路由表：路由名 → pi-ai 协议。
+ * 网关按「入站协议 + 模型」匹配模型映射（internal/service/provider_service.go），
+ * 而 pi-ai 的 `api` 是路由级的 —— 因此每个协议一条路由，模型按映射归属到对应路由，
+ * 切模型时 dsh 自动落到讲该协议的路由，协议随模型走。
+ * 主路由固定用 Responses 协议（/v1/responses），OpenAI 兼容模型统一落到它。
+ */
+export declare const PROVIDER_ROUTES: {
+    readonly 'ai-router': "openai-responses";
+    readonly 'ai-router-anthropic': "anthropic-messages";
+};
+export type ProviderRouteName = keyof typeof PROVIDER_ROUTES;
+/** 预算项的只读视图：模型名 + 可选目录状态（inactive = 已下架，不可调用）。 */
+export interface BudgetItem {
+    model_name: string;
+    model_status?: 'active' | 'inactive';
+    /** 模型接受的输入模态（网关 CSV，如 'text,image'）；缺省视同 'text'。 */
+    input_modalities?: string;
+}
+/**
+ * DSH 面向的输入模态字面量。对应 llm-pi-ai 当前 `MODALITIES`（catalog.ts
+ * MODALITY_GATE 仅 text/image）；DSH 扩模态时同步扩展此并集与
+ * {@link DSH_SUPPORTED_MODALITIES} 即可解锁，无需改网关。
+ */
+export type PiAiModality = 'text' | 'image';
+/** DSH 当前能接受的模态集。网关可声明 video/audio，但 DSH 尚不能接，故输入前求交过滤。 */
+export declare const DSH_SUPPORTED_MODALITIES: readonly PiAiModality[];
+/** 每模型描述符：id + 注入 DSH 的 input 模态（已过滤到 DSH 支持集）。 */
+export interface ModelDescriptor {
+    id: string;
+    input: readonly PiAiModality[];
+}
+/** 固定写入顺序：先主路由（兼容 agent-default-model 的 provider: ai-router）。 */
+export declare const PROVIDER_ROUTE_NAMES: readonly ProviderRouteName[];
+/** 旧版独立 responses 路由（现已并入主路由）；仅用于升级时清理残留 provider。 */
+export declare const LEGACY_PROVIDER_ROUTE_NAMES: readonly string[];
+/**
+ * 从 budgets 归一化出去重、非空的模型 id 列表。已下架模型（model_status === 'inactive'，
+ * 网关 PreCheck 直接 402）不在「能成功调用」集合内，剔除；状态缺省（旧网关）视同 active。
+ */
+export declare function computeModelIds(budgets: readonly BudgetItem[]): string[];
+/**
+ * 解析网关模态 CSV 为 DSH 可接受的模态集，并保证 text 在前、去重、过滤未知项。
+ *
+ * 缺省/空/未声明 → `['text']`（与旧网关语义一致）。网关声明的 video/audio 在 DSH 支持前
+ * 自动过滤：`'text,video,audio'` 目前落到 `['text']`，永不向 DSH 注入它不接受的模态
+ * （否则整个 profile 被 llm-pi-ai 拒绝）。
+ */
+export declare function parseModalities(raw: string | undefined): PiAiModality[];
+/** 由 budgets 构造每模型描述符（已剔除下架模型；模态按 budget 的 input_modalities 解析）。 */
+export declare function computeModelDescriptors(budgets: readonly BudgetItem[]): ModelDescriptor[];
+/**
+ * 按网关模型映射把预算内模型拆到各协议路由：
+ * 每个模型归属「优先级最高且映射命中（精确或通配）的协议」；
+ * 无任何映射命中的模型落到主路由（默认 responses，网关侧仍有 `*` 兜底，保持预算内模型均可选）。
+ * 返回每模型描述符（含 DSH 可接受的 input 模态），供 profile 注入。
+ */
+export declare function computeRouteModels(budgets: readonly BudgetItem[], mapping: readonly GatewayModelMapping[]): Partial<Record<ProviderRouteName, ModelDescriptor[]>>;
+/**
+ * 各协议的 pi-ai baseURL：OpenAI 系 SDK 把 baseURL 视为根（追加 chat/completions、
+ * responses），补 `/v1`；Anthropic SDK 自带 `v1/` 前缀，必须传裸 base，
+ * 否则会拼出 `/v1/v1/messages` 404。
+ */
+export declare function protocolBaseURL(baseURL: string, protocol: string): string;
+/** 构造一条 llm-pi-ai 手写声明的路由 profile（协议与 baseURL 由路由决定）。 */
+export declare function buildPiAiProviderProfile(opts: {
+    baseURL: string;
+    route: ProviderRouteName;
+    models: readonly ModelDescriptor[];
+}): Record<string, unknown>;
+/** 构造全部非空协议路由的 profile 字典（空路由不产出，由写入侧清理旧路由）。 */
+export declare function buildPiAiProviderProfiles(opts: {
+    baseURL: string;
+    routeModels: Partial<Record<ProviderRouteName, readonly ModelDescriptor[]>>;
+}): Record<string, Record<string, unknown>>;

package/lib/types/types.d.ts

@@ -0,0 +1,4 @@
+/** 稳定错误码/错误类型的定义在 src/client/types.ts（client 半边声明构建的 rootDir 内）。
+ *  此处仅为 Host 半边（orchestration / ai-router-client）提供同源的类型再导出，
+ *  避免两份定义漂移；声明构建时各自 emit 到 lib/types 对应位置。 */
+export type { LoginError, LoginErrorCode } from './client/types.ts';

package/lib/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "hiwork-core",
+  "version": "0.0.1",
+  "type": "module",
+  "description": "HiWork 企业统一登录与模型自动供给插件（ai-router 网关登录，Web 表单，无 CLI 认证）",
+  "license": "UNLICENSED",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-store",
+        "@deepseek-ai/dsh-client-ui-slots",
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-api-remotes",
+        "@deepseek-ai/dsh-client-ui-primitives"
+      ]
+    }
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "4.0.2"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "4.0.2",
+    "@deepseek-ai/dsh-api-remotes": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-store": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-settings": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-sidebar": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-credentials": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-credentials-local": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-llm": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-llm-pi-ai": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-settings": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-settings-file": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-workspace": "0.1.2-rc.1",
+    "@deepseek-ai/schemastery": "3.18.2",
+    "@types/node": "^22",
+    "@types/react": "^18",
+    "@types/react-dom": "^18",
+    "esbuild": "^0.24",
+    "jsdom": "^30.0.1",
+    "react": "^18",
+    "react-dom": "^18",
+    "tsx": "^4.23.12",
+    "typescript": "^5",
+    "vitest": "^3"
+  },
+  "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"
+  }
+}