hiwork-core 0.0.35 → 0.0.38

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

@@ -1,4 +1,4 @@
-import type { InjectFace, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import type { InjectFace } from '@deepseek-ai/dsh-client-ui-slots';
 import { type AiRouterCardFace } from './controller.ts';
 import { type PluginUpdatesStore } from './plugin-updates.ts';
 /**
@@ -19,6 +19,11 @@ import { type PluginUpdatesStore } from './plugin-updates.ts';
 export interface PluginUpdatesFace {
     pluginUpdates: PluginUpdatesStore;
 }
-export type UserBadgeProps = PropsRuntime<'sidebar.footer.action'> & InjectFace<AiRouterCardFace & PluginUpdatesFace>;
+export type UserBadgeProps = InjectFace<AiRouterCardFace & PluginUpdatesFace> & {
+    /** `settings.launcher` 槽位的渲染参数（ui-settings-general 的 SettingsRoot 下发）。 */
+    readonly wide: boolean | undefined;
+    /** 打开设置弹窗（壳拥有 open 状态）；分区直达由 selectSettingsSection 补齐。 */
+    readonly openSettings: () => void;
+};
 /** 底部账号信息行（宽栏 / 折叠栏共用；插件更新提示卡片也由它渲染，见下）。 */
 export declare function UserBadge(props: UserBadgeProps): import("react").JSX.Element | null;

package/lib/types/identity-context.d.ts

@@ -0,0 +1,54 @@
+/**
+ * 登录身份的 runtime context 贡献（`hiwork:identity`）：把「当前登录人是谁」送进
+ * AI 上下文，供 skill / 会话按人表述与个性化使用（spec
+ * `docs/superpowers/specs/2026-10-09-identity-runtime-context-design.md`）。
+ *
+ * 设计要点（与 `src/identity.ts` 同构）：
+ *  - **cordis-free 纯模块**：注册走结构化的 {@link SystemPromptPort} 窄端口，调用方
+ *    （index.ts）传真实 `ctx.systemPrompt`；单测直接伪造。真实 PromptContext.text
+ *    接受 `(AssembleContext) => string`，本模块的 `() => string` 结构兼容（忽略入参）；
+ *  - **空串 = 不贡献**（DSH 原生语义）：未登录、bundle 层关闭（`identityContext: false`）、
+ *    读失败一律返回空串——零暴露，且绝不向组装层抛异常；
+ *  - **每次组装现读**：text 是每次求值的 provider，登录 / 登出 / 换号在下一步即时反映，
+ *    不缓存旧身份；
+ *  - **身份文本不是凭证**：上下文里的身份只作展示 / 个性化 / 按人表述用，鉴权一律在
+ *    通道层（loopback RPC 带网关会话、MCP 断言→mint）。文案末尾那句限定语是对模型的
+ *    引导，不是防线；
+ *  - **字段最小化**：只用 `username`（工号）与 `displayName`（姓名），归一化口径与
+ *    identity.ts 的 textOrUndefined 一致（裁空白、空白串视同缺省）。keys / subject /
+ *    团队一律不进上下文。
+ */
+import type { IdentityState } from './identity.ts';
+/** runtime context 贡献名（DSH 侧 snapshot 按名归并，改动即破坏对齐面）。 */
+export declare const IDENTITY_CONTEXT_NAME = "hiwork:identity";
+/** 排在 sandbox:policy(110) / approval:policy(115) 之前——身份是最外层的环境事实。 */
+export declare const IDENTITY_CONTEXT_ORDER = 105;
+/**
+ * 渲染身份上下文一行：已登录输出 `HiWork 登录身份：姓名（工号 工号）。<限定语>`，
+ * displayName 缺省回退 `工号 <工号>`；**未登录（username 缺省 / 空白 / 非字符串）或
+ * state 缺失一律空串**——半份身份（只有 displayName）也不输出，姓名不得单独泄漏。
+ */
+export declare function renderIdentityContextText(state: IdentityState | undefined): string;
+/** `ctx.systemPrompt.context` 的最小端口（结构兼容 DSH 的 SystemPrompt，便于单测伪造）。 */
+export interface SystemPromptPort {
+    /** 注册一条 runtime context 贡献；返回注销函数（或任何可注销值，见 registerIdentityContext）。 */
+    context(contribution: {
+        name: string;
+        order: number;
+        text: () => string;
+    }): unknown;
+}
+/** 注册侧依赖：登录态现读 + bundle 层开关 + 日志出口。 */
+export interface IdentityContextDeps {
+    /** 读一次当前登录态（与 hiworkIdentity 同一数据源；每次组装都会调用）。 */
+    current(): IdentityState;
+    /** bundle 层固定开关（缺省开）；关闭时贡献空文本。 */
+    enabled(): boolean;
+    /** Host 日志出口（只记错误类型，不记身份字段）。 */
+    log?(message: string): void;
+}
+/**
+ * 注册身份 runtime context 贡献；返回 disposer（交给 `ctx.effect` 管理生命周期）。
+ * 读失败收敛为空串并记一笔，绝不向组装层抛——身份上下文缺席只应意味着「未登录」。
+ */
+export declare function registerIdentityContext(systemPrompt: SystemPromptPort, deps: IdentityContextDeps): () => void;

package/lib/types/index.d.ts

@@ -19,7 +19,8 @@ export declare const name = "hiwork-core";
  * （`ctx.web.registerSearchProvider`，见 `src/web-search.ts`；dsh-base 基座先于本
  * 插件挂载 dsh-web）；`agents` 是根 Agent 注册表——`image_generate` 工具要挂在根 Agent
  * 上（`ctx.agents.roots()` / `agent/created`，见 `src/tools.ts`；与 knowledge 的
- * `inject` 同源）；其余三项是既有登录 / 供给依赖。
+ * `inject` 同源）；`systemPrompt` 承载登录身份的 runtime context 贡献
+ * （`hiwork:identity`，见 `src/identity-context.ts`）；其余三项是既有登录 / 供给依赖。
  */
 export declare const inject: string[];
 /** 侧栏菜单偏好的解析值（client 侧 `MenuPreferences` 的同一份形状）。 */
@@ -44,6 +45,11 @@ export declare const MenuConfig: z<MenuConfigValue>;
 /** 插件配置 + 运行时状态字段（全部可选；写操作按此 schema 校验）。 */
 export interface Config {
     baseURL?: string;
+    /**
+     * 身份上下文开关（bundle 层固定配置，缺省开）：把当前登录人（工号 + 姓名）以
+     * runtime context 贡献暴露进 AI 上下文；关闭时贡献空文本（零暴露）。
+     */
+    identityContext?: boolean;
     keyId?: string;
     username?: string;
     displayName?: string;
@@ -114,12 +120,13 @@ export declare const Config: z<Config>;
 /**
  * apply 收到的运行时 config：volatile 字段是稳定引用（schemastery 解析期包装，值为
  * undefined 时引用依然存在），随 profile 变更被框架原地更新——持有引用、每次现取，
- * 绝不缓存 `.get()` 的结果。baseURL 仍是普通组合层配置。
+ * 绝不缓存 `.get()` 的结果。baseURL 与 identityContext 仍是普通组合层配置。
  */
 export type RuntimeConfig = {
     baseURL?: string;
+    identityContext?: boolean;
 } & {
-    [K in Exclude<keyof Config, 'baseURL'>]?: Volatile<Config[K]>;
+    [K in Exclude<keyof Config, 'baseURL' | 'identityContext'>]?: Volatile<Config[K]>;
 };
 /**
  * settings.mutate 的路径操作（rc.2 的 dsh-settings 不再导出 `SettingsPathOp` 类型，
@@ -133,6 +140,25 @@ export type SettingsPathOp = {
     op: 'unset';
     path: readonly string[];
 };
+/** 失败是否是「事务内写」——调用方据此判断轮询上下文已被 HMR 事务污染（见 apply）。 */
+export declare function isHmrNestedWriteError(error: unknown): boolean;
+/**
+ * 写一个命名空间（= profile entry id）。
+ *
+ * 每次尝试都重读 `describe()` 取最新 revision；可重试错误在截止时间前带退避重试，超时后
+ * 抛出**真实**错误——不降级成「conflicted repeatedly」，免得把根因从日志里抹掉。
+ * 退避上限 1s：命名空间注册与 HMR 事务都在秒级内收敛，重试代价可忽略。
+ *
+ * @param settings - settings 服务。
+ * @param ns - 命名空间（profile entry id）。
+ * @param ops - 路径操作。
+ * @param opts - 重试窗口与退避（单测用来把窗口压到毫秒级）。
+ */
+export declare function writeNamespace(settings: SettingsForms, ns: string, ops: SettingsPathOp[], opts?: {
+    deadlineMs?: number;
+    minBackoffMs?: number;
+    maxBackoffMs?: number;
+}): Promise<void>;
 /** 校正默认模型要用到的 llm 注册表部分（便于单测注入假实现）。 */
 export interface LlmRouteRegistry {
     listProviders(): readonly {

package/lib/types/provision-session.d.ts

@@ -37,6 +37,8 @@ export interface AiRouterStatePort {
 /** ai-router 命名空间解析后的值（相关字段）。 */
 export interface AiRouterNamespaceValue {
     baseURL?: string;
+    /** 身份上下文开关（bundle 层固定配置，缺省开）；关闭时 `hiwork:identity` 贡献空文本。 */
+    identityContext?: boolean;
     keyId?: string;
     username?: string;
     /** 登录账号的显示名（网关 LDAP displayName，如中文名）；缺省时 UI 回退 username。 */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hiwork-core",
-  "version": "0.0.35",
+  "version": "0.0.38",
   "type": "module",
   "description": "HiWork 企业统一登录与模型自动供给插件（ai-router 网关登录，Web 表单，无 CLI 认证）",
   "license": "UNLICENSED",
@@ -42,33 +42,34 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "~4.0.4",
-    "@deepseek-ai/dsh-client-ui-layout": ">=0.1.0-rc.5 <0.2.0"
+    "@deepseek-ai/dsh-client-ui-layout": ">=0.1.0-rc.5 <0.2.0 || >=0.2.0-rc.1 <0.3.0"
   },
   "devDependencies": {
     "@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/dsh-agent-default-model": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-api-remotes": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-app-boot": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-attachment": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-store": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-chat": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-conversation": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-session": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-settings": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-sidebar": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-config-editor": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-credentials": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-credentials-local": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-llm": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-llm-pi-ai": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-settings": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-system-prompt": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-tools": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-web": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-workspace": "0.2.0-rc.1",
     "@deepseek-ai/schemastery": "3.18.4",
     "@types/node": "^22",
     "@types/react": "^18",
@@ -81,7 +82,7 @@
     "typescript": "^5",
     "vitest": "^3",
     "yaml": "^2.8.1",
-    "@deepseek-ai/dsh-client-ui-layout": "0.1.7-rc.2"
+    "@deepseek-ai/dsh-client-ui-layout": "0.2.0-rc.1"
   },
   "scripts": {
     "typecheck": "tsc --noEmit",