@fa-software/semi2-dsh 0.0.13 → 0.0.14-preview.20260922151653

package/lib/types/api/generated/schema.d.ts

@@ -26,12 +26,18 @@ export type Scalars = {
         input: string;
         output: string;
     };
-    /** 自由形状的脱敏数据：仅审查日志的 detail 使用（服务端写入前已脱敏，只读不参与计算）。 */
+    /** 自由形状 JSON：日志脱敏快照与技能 metadata 等领域数据使用。 */
     JSON: {
         input: unknown;
         output: unknown;
     };
 };
+/** 动作码选项：某本日志筛选下拉的选项来源（服务端注册表，前端不复制）。 */
+export type ActionOption = {
+    __typename?: 'ActionOption';
+    action: Scalars['String']['output'];
+    label: Scalars['String']['output'];
+};
 export type Activation = {
     __typename?: 'Activation';
     expiresAt: Scalars['DateTime']['output'];
@@ -41,13 +47,6 @@ export type AddCnbUsersInput = {
     /** 要预建账户的上游成员 CNB 用户 ID；本轮上游没返回的会被跳过。 */
     externalUserIds: Array<Scalars['String']['input']>;
 };
-/** 动作码选项：筛选下拉的选项来源（服务端注册表，前端不复制）。 */
-export type AuditActionOption = {
-    __typename?: 'AuditActionOption';
-    action: Scalars['String']['output'];
-    category: AuditCategory;
-    label: Scalars['String']['output'];
-};
 /** 身份来源：会话 / 用户密钥 / 接入密钥 / 匿名（登录失败、无效密钥）。 */
 export declare enum AuditActorKind {
     AccessKey = "ACCESS_KEY",
@@ -55,13 +54,6 @@ export declare enum AuditActorKind {
     Session = "SESSION",
     UserKey = "USER_KEY"
 }
-/** 审查类别：读 / 写 / 身份凭据 / 运行面生命周期。 */
-export declare enum AuditCategory {
-    Auth = "AUTH",
-    Read = "READ",
-    Runtime = "RUNTIME",
-    Write = "WRITE"
-}
 /** 来源面：控制台 / NPC / 云开发工作站 / 容器 Web / 宿主直跑 / 未标注。 */
 export declare enum AuditChannel {
     Console = "CONSOLE",
@@ -71,58 +63,103 @@ export declare enum AuditChannel {
     Unknown = "UNKNOWN",
     Workstation = "WORKSTATION"
 }
-export type AuditEvent = {
-    __typename?: 'AuditEvent';
-    /** 动作码，例 `write.project.delete`；闭集与中文文案由服务端的注册表给出。 */
+/** 结果：SUCCESS = 完成；DENIED = 身份 / 权限 / 来源被拒；ERROR = 领域校验或冲突失败。 */
+export declare enum AuditOutcome {
+    Denied = "DENIED",
+    Error = "ERROR",
+    Success = "SUCCESS"
+}
+/** 无会话事件筛选：被拒 / 失败的运行面读取与起会话之前的整体失败。 */
+export type ClientEventFilter = {
+    /** 精确匹配动作码；选项清单走 clientActionOptions。 */
+    action?: InputMaybe<Scalars['String']['input']>;
+    actorUserId?: InputMaybe<Scalars['ID']['input']>;
+    channel?: InputMaybe<AuditChannel>;
+    from?: InputMaybe<Scalars['DateTime']['input']>;
+    outcome?: InputMaybe<AuditOutcome>;
+    to?: InputMaybe<Scalars['DateTime']['input']>;
+};
+/**
+ * 客户端会话：一次运行面会话一行（dsh 会话创建时建行、销毁时回填结束）。
+ * NPC 的一次任务先按任务引用建行，会话创建后再把 dsh 会话 id 补上。
+ */
+export type ClientSession = {
+    __typename?: 'ClientSession';
+    actorDisplayName?: Maybe<Scalars['String']['output']>;
+    actorId?: Maybe<Scalars['ID']['output']>;
+    actorKind: AuditActorKind;
+    actorUsername?: Maybe<Scalars['String']['output']>;
+    channel: AuditChannel;
+    /** 运行面实例标识：同名 dsh 会话在不同容器里靠它分开。 */
+    clientId?: Maybe<Scalars['String']['output']>;
+    clientIp?: Maybe<Scalars['String']['output']>;
+    code?: Maybe<Scalars['String']['output']>;
+    /** 结束原因码（例 `dispose`）。 */
+    endReason?: Maybe<Scalars['String']['output']>;
+    /** 没有结束行（进程被强杀 / 容器停止）时为空。 */
+    endedAt?: Maybe<Scalars['DateTime']['output']>;
+    /** 本会话已记下的事件条数。 */
+    eventCount: Scalars['Int']['output'];
+    /** 行的稳定身份：优先任务引用，其次「客户端实例 + dsh 会话 id」。 */
+    key: Scalars['ID']['output'];
+    modelId?: Maybe<Scalars['String']['output']>;
+    /** 会话当下的结果：取最后一条事件的结果。 */
+    outcome: AuditOutcome;
+    /** 按工作区 / 任务引用解析出的项目；不可读时为空、只留展示名。 */
+    projectId?: Maybe<Scalars['ID']['output']>;
+    projectLabel?: Maybe<Scalars['String']['output']>;
+    reasoningLevel?: Maybe<Scalars['String']['output']>;
+    /** 任务引用 `<repo>#<issue|pr>#<iid>`。 */
+    runRef?: Maybe<Scalars['String']['output']>;
+    /** dsh 会话 id；会话尚未创建时为空（例：NPC 拒绝运行）。 */
+    sessionId?: Maybe<Scalars['String']['output']>;
+    startedAt: Scalars['DateTime']['output'];
+    workspacePath?: Maybe<Scalars['String']['output']>;
+    /** 会话 cwd 与命中的已登记工作区 slug。 */
+    workspaceSlug?: Maybe<Scalars['String']['output']>;
+};
+/** 会话时间线上的一条事件；`sessionKey` 为空 = 无会话归属的异常事实。 */
+export type ClientSessionEvent = {
+    __typename?: 'ClientSessionEvent';
     action: Scalars['String']['output'];
-    /** 动作码的中文文案（筛选下拉同样取自服务端，前端不复制这张表）。 */
     actionLabel: Scalars['String']['output'];
     actorDisplayName?: Maybe<Scalars['String']['output']>;
     actorId?: Maybe<Scalars['ID']['output']>;
     actorKind: AuditActorKind;
     actorUsername?: Maybe<Scalars['String']['output']>;
-    category: AuditCategory;
     channel: AuditChannel;
     clientIp?: Maybe<Scalars['String']['output']>;
-    /** 领域错误码或运行面原因码；成功（或被拒且无码）时为空。 */
     code?: Maybe<Scalars['String']['output']>;
-    /** 脱敏快照：before / after、请求元信息、原因文本等。 */
     detail: Scalars['JSON']['output'];
     durationMs?: Maybe<Scalars['Int']['output']>;
     id: Scalars['ID']['output'];
     occurredAt: Scalars['DateTime']['output'];
     outcome: AuditOutcome;
+    sessionKey?: Maybe<Scalars['ID']['output']>;
     targetId?: Maybe<Scalars['String']['output']>;
-    /** 目标当时的展示名（目标已删除时仍可读）。 */
     targetLabel?: Maybe<Scalars['String']['output']>;
-    /** 目标类型，例 user / project / model / connection / skill / access-key / run。 */
     targetType?: Maybe<Scalars['String']['output']>;
 };
-/** 筛选：各条件并列（AND）；from/to 为闭区间。 */
-export type AuditEventFilter = {
-    /** 精确匹配动作码；选项清单走 auditActionOptions。 */
-    action?: InputMaybe<Scalars['String']['input']>;
+export type ClientSessionEventPage = {
+    __typename?: 'ClientSessionEventPage';
+    items: Array<ClientSessionEvent>;
+    total: Scalars['Int']['output'];
+};
+/** 客户端会话筛选：各条件并列（AND）；from/to 为闭区间。 */
+export type ClientSessionFilter = {
     actorUserId?: InputMaybe<Scalars['ID']['input']>;
-    category?: InputMaybe<AuditCategory>;
     channel?: InputMaybe<AuditChannel>;
     from?: InputMaybe<Scalars['DateTime']['input']>;
     outcome?: InputMaybe<AuditOutcome>;
-    targetId?: InputMaybe<Scalars['String']['input']>;
-    targetType?: InputMaybe<Scalars['String']['input']>;
     to?: InputMaybe<Scalars['DateTime']['input']>;
+    /** 已登记工作区 slug（大小写不敏感，精确匹配）。 */
+    workspaceSlug?: InputMaybe<Scalars['String']['input']>;
 };
-export type AuditEventPage = {
-    __typename?: 'AuditEventPage';
-    items: Array<AuditEvent>;
-    /** 与本次 filter 同口径的记录总数。 */
+export type ClientSessionPage = {
+    __typename?: 'ClientSessionPage';
+    items: Array<ClientSession>;
     total: Scalars['Int']['output'];
 };
-/** 结果：SUCCESS = 完成；DENIED = 身份 / 权限 / 来源被拒；ERROR = 领域校验或冲突失败。 */
-export declare enum AuditOutcome {
-    Denied = "DENIED",
-    Error = "ERROR",
-    Success = "SUCCESS"
-}
 /** CNB 接入密钥（Hub 生成、经 secret import 注入 CNB 环境；服务端只存摘要）。 */
 export type CnbAccessKey = {
     __typename?: 'CnbAccessKey';
@@ -232,6 +269,8 @@ export type EffectiveModelDefaults = {
 export type GlobalConfiguration = {
     __typename?: 'GlobalConfiguration';
     preferences: Preferences;
+    /** 组织共用的 Redmine 实例地址；null = 未配置（运行面不挂 Redmine 只读工具）。 */
+    redmineBaseUrl?: Maybe<Scalars['String']['output']>;
     revision: Scalars['Int']['output'];
 };
 export type ImportBuiltinModelsInput = {
@@ -414,10 +453,10 @@ export type Mutation = {
     /** 吊销接入密钥。 */
     revokeCnbAccessKey: Scalars['ID']['output'];
     /**
-     * 回报一条运行面生命周期事实（会话启停 / 拒绝 / 交付分支与核对）。
+     * 回报一条运行面生命周期事实（会话起手 / 创建 / 销毁 / 拒绝 / 交付分支与核对）。
      * 上报失败不改变运行面行为：运行面按「只 warn 降级」处理，事件缺失不影响交付闭环。
      */
-    runtimeReportEvent: AuditEvent;
+    runtimeReportEvent: ClientSessionEvent;
     saveGlobalConfiguration: GlobalConfiguration;
     saveModel: Model;
     saveModelConnection: ModelConnection;
@@ -538,6 +577,48 @@ export type MutationUpdateMyConfigurationArgs = {
 export type MutationWriteSkillFilesArgs = {
     input: WriteSkillFilesInput;
 };
+/** 操作日志的一条事实：控制台的写操作与控制台敏感读。 */
+export type OperationEvent = {
+    __typename?: 'OperationEvent';
+    /** 动作码，例 `write.project.delete`；闭集与中文文案由服务端的注册表给出。 */
+    action: Scalars['String']['output'];
+    /** 动作码的中文文案（筛选下拉同样取自服务端，前端不复制这张表）。 */
+    actionLabel: Scalars['String']['output'];
+    actorDisplayName?: Maybe<Scalars['String']['output']>;
+    actorId?: Maybe<Scalars['ID']['output']>;
+    actorKind: AuditActorKind;
+    actorUsername?: Maybe<Scalars['String']['output']>;
+    /** 领域错误码；成功（或被拒且无码）时为空。 */
+    code?: Maybe<Scalars['String']['output']>;
+    /** 脱敏快照：before / after、请求元信息、原因文本等。 */
+    detail: Scalars['JSON']['output'];
+    durationMs?: Maybe<Scalars['Int']['output']>;
+    id: Scalars['ID']['output'];
+    occurredAt: Scalars['DateTime']['output'];
+    outcome: AuditOutcome;
+    targetId?: Maybe<Scalars['String']['output']>;
+    /** 目标当时的展示名（目标已删除时仍可读）。 */
+    targetLabel?: Maybe<Scalars['String']['output']>;
+    /** 目标类型，例 user / project / model / connection / skill / access-key / run。 */
+    targetType?: Maybe<Scalars['String']['output']>;
+};
+/** 操作日志筛选：各条件并列（AND）；from/to 为闭区间。 */
+export type OperationEventFilter = {
+    /** 精确匹配动作码；选项清单走 operationActionOptions。 */
+    action?: InputMaybe<Scalars['String']['input']>;
+    actorUserId?: InputMaybe<Scalars['ID']['input']>;
+    from?: InputMaybe<Scalars['DateTime']['input']>;
+    outcome?: InputMaybe<AuditOutcome>;
+    targetId?: InputMaybe<Scalars['String']['input']>;
+    targetType?: InputMaybe<Scalars['String']['input']>;
+    to?: InputMaybe<Scalars['DateTime']['input']>;
+};
+export type OperationEventPage = {
+    __typename?: 'OperationEventPage';
+    items: Array<OperationEvent>;
+    /** 与本次 filter 同口径的记录总数。 */
+    total: Scalars['Int']['output'];
+};
 export type Preferences = {
     __typename?: 'Preferences';
     defaultModelId?: Maybe<Scalars['ID']['output']>;
@@ -611,14 +692,16 @@ export type ProjectPage = {
 };
 export type Query = {
     __typename?: 'Query';
-    /** 审查动作码清单（管理员）：筛选下拉的选项来源。 */
-    auditActionOptions: Array<AuditActionOption>;
-    /** 审查日志（管理员）：读取 / 写操作 / 身份凭据 / 运行面生命周期四类事实。 */
-    auditEvents: AuditEventPage;
     /** 该用户可用模型（连接启用 + 模型启用 + 存在性 + 密钥齐备）。 */
     availableModels: Array<Model>;
     /** 该连接的内置目录模型清单；不需要密钥，上游读不到时的出路。 */
     builtinModelCatalog: Array<UpstreamModel>;
+    /** 客户端动作码清单（管理员）：筛选下拉的选项来源。 */
+    clientActionOptions: Array<ActionOption>;
+    /** 某个会话的时间线（管理员）：按时间正序的全部事件。 */
+    clientSessionTimeline: Array<ClientSessionEvent>;
+    /** 客户端会话（管理员）：运行面会话，一会话一行。 */
+    clientSessions: ClientSessionPage;
     /** 全部 CNB 环境接入密钥（明文不回读）。密钥不绑用户，属部署级环境凭据。 */
     cnbAccessKeys: Array<CnbAccessKey>;
     /** 当前登录账户自己的 CNB 连接。 */
@@ -631,6 +714,10 @@ export type Query = {
     models: ModelPage;
     /** 登录者本人可访问的项目。 */
     myProjects: ProjectPage;
+    /** 操作动作码清单（管理员）：筛选下拉的选项来源。 */
+    operationActionOptions: Array<ActionOption>;
+    /** 操作日志（管理员）：控制台写操作与控制台敏感读。 */
+    operationEvents: OperationEventPage;
     /** 单项目详情；无访问权即 ACCESS_DENIED。 */
     project: Project;
     /** 全部项目；成员视角用 myProjects。 */
@@ -652,23 +739,37 @@ export type Query = {
      * 工作区逐个项目要，不必把整个项目表拉回本地。
      */
     runtimeProjects?: Maybe<Array<RuntimeProject>>;
+    /**
+     * 本面可用的 Redmine 地址与本人密钥；块内任一 null = 权威未配置（运行面不挂 Redmine 工具），
+     * 本次读取失败为 null。
+     */
+    runtimeRedmine?: Maybe<RuntimeRedmine>;
     /**
      * 自画像正文（agent 会话开头注入的人设）；未配置为空串，本次读取失败为 null。
      * 全局一份，与读取者身份无关。
      */
     runtimeSelfPortrait?: Maybe<Scalars['String']['output']>;
+    /**
+     * 此刻对读取者生效的完整技能目录；至少一个调用面可用的未归档 head 都会返回。
+     * 调用策略由新 provider 原样交给 dsh，模型与用户目录在 dsh 边界分流。
+     */
+    runtimeSkillCatalog?: Maybe<Array<RuntimeSkill>>;
     /**
      * 某技能 head 版本的附件内容（运行面物化用）；读取者对该技能不可见时返回空数组。
      * 字节不回填进 boot 文档，只在真正加载技能时按需取。
      */
     runtimeSkillFiles?: Maybe<Array<RuntimeSkillFileContent>>;
     /**
-     * 此刻对读取者生效的技能目录（全局 + 可访问项目的未归档 head）；失败为 null。
+     * 旧 runtime 兼容目录（全局 + 可访问项目的未归档 head）；只含默认双开技能；失败为 null。
      * 「哪些目录算已登记工作区」是 client 侧事实，服务端只表达可访问性，不下发生效范围。
      */
     runtimeSkills?: Maybe<Array<RuntimeSkill>>;
     /** 本次读取者（服务器里当前用户）；失败为 null。 */
     runtimeViewer?: Maybe<RuntimeViewer>;
+    /** 身份动作码清单（管理员）：筛选下拉的选项来源。 */
+    securityActionOptions: Array<ActionOption>;
+    /** 身份安全（管理员）：控制台身份与凭据事件。 */
+    securityEvents: SecurityEventPage;
     /** 自画像的当前版本（全局一份 agent 人设）。 */
     selfPortrait: SelfPortrait;
     /** 自画像的历史快照（新在前，最多 50 条）。 */
@@ -681,6 +782,8 @@ export type Query = {
     skillVersions: Array<SkillVersion>;
     /** 技能头版本列表；filter 决定作用域与状态。 */
     skills: SkillPage;
+    /** 无会话事件（管理员）：被拒 / 失败的运行面读取与起会话之前的整体失败。 */
+    unassignedClientEvents: ClientSessionEventPage;
     /** 读令牌可见的 CNB 组织成员但不写库：返回列表供同步勾选；失败按 DomainError 码回。 */
     upstreamCnbMembers: Array<UpstreamCnbMember>;
     /** 读令牌可见的 CNB 仓库但不写库：返回列表供同步勾选；失败按 DomainError 码回。 */
@@ -696,17 +799,20 @@ export type Query = {
     users: UserPage;
     viewer: User;
 };
-export type QueryAuditEventsArgs = {
-    filter?: InputMaybe<AuditEventFilter>;
-    first?: InputMaybe<Scalars['Int']['input']>;
-    offset?: InputMaybe<Scalars['Int']['input']>;
-};
 export type QueryAvailableModelsArgs = {
     userId?: InputMaybe<Scalars['ID']['input']>;
 };
 export type QueryBuiltinModelCatalogArgs = {
     connectionId: Scalars['ID']['input'];
 };
+export type QueryClientSessionTimelineArgs = {
+    sessionKey: Scalars['ID']['input'];
+};
+export type QueryClientSessionsArgs = {
+    filter?: InputMaybe<ClientSessionFilter>;
+    first?: InputMaybe<Scalars['Int']['input']>;
+    offset?: InputMaybe<Scalars['Int']['input']>;
+};
 export type QueryEffectiveModelDefaultsArgs = {
     userId?: InputMaybe<Scalars['ID']['input']>;
 };
@@ -728,6 +834,11 @@ export type QueryMyProjectsArgs = {
     first?: InputMaybe<Scalars['Int']['input']>;
     offset?: InputMaybe<Scalars['Int']['input']>;
 };
+export type QueryOperationEventsArgs = {
+    filter?: InputMaybe<OperationEventFilter>;
+    first?: InputMaybe<Scalars['Int']['input']>;
+    offset?: InputMaybe<Scalars['Int']['input']>;
+};
 export type QueryProjectArgs = {
     id: Scalars['ID']['input'];
 };
@@ -745,6 +856,11 @@ export type QueryRuntimeProjectsArgs = {
 export type QueryRuntimeSkillFilesArgs = {
     skillId: Scalars['ID']['input'];
 };
+export type QuerySecurityEventsArgs = {
+    filter?: InputMaybe<SecurityEventFilter>;
+    first?: InputMaybe<Scalars['Int']['input']>;
+    offset?: InputMaybe<Scalars['Int']['input']>;
+};
 export type QuerySkillArgs = {
     id: Scalars['ID']['input'];
     version?: InputMaybe<Scalars['Int']['input']>;
@@ -761,6 +877,11 @@ export type QuerySkillsArgs = {
     first?: InputMaybe<Scalars['Int']['input']>;
     offset?: InputMaybe<Scalars['Int']['input']>;
 };
+export type QueryUnassignedClientEventsArgs = {
+    filter?: InputMaybe<ClientEventFilter>;
+    first?: InputMaybe<Scalars['Int']['input']>;
+    offset?: InputMaybe<Scalars['Int']['input']>;
+};
 export type QueryUpstreamModelCatalogArgs = {
     connectionId: Scalars['ID']['input'];
 };
@@ -822,25 +943,39 @@ export type RuntimeConnection = {
 export declare enum RuntimeEventAction {
     DeliveryReady = "DELIVERY_READY",
     DeliveryVerified = "DELIVERY_VERIFIED",
-    SessionEnd = "SESSION_END",
+    SessionCreated = "SESSION_CREATED",
+    SessionDisposed = "SESSION_DISPOSED",
     SessionFailed = "SESSION_FAILED",
     SessionRefused = "SESSION_REFUSED",
     SessionStart = "SESSION_START"
 }
 /**
  * 运行面上报：只接受用户密钥身份，动作码限闭集；detail 由服务端脱敏后落库。
- * 目标项目按 slug 解析：命中可读项目时 targetId 是项目 id，否则只留 slug 快照。
+ * 目标项目按 slug 解析：命中可读项目时挂项目 id，否则只留 slug 快照。
+ * 带会话身份（runRef 或 sessionId + clientId）的事件会折叠进同一行客户端会话。
  */
 export type RuntimeEventInput = {
     action: RuntimeEventAction;
-    /** 原因码 / 交付状态码（例 SETUP_FAILED、delivered）。 */
+    /** 运行面实例标识（插件进程内生成）：同名 dsh 会话在不同容器里靠它分开。 */
+    clientId?: InputMaybe<Scalars['String']['input']>;
+    /** 原因码 / 交付状态码（例 SETUP_FAILED、delivered、dispose）。 */
     code?: InputMaybe<Scalars['String']['input']>;
     detail?: InputMaybe<Scalars['JSON']['input']>;
+    /** 会话使用的模型与档位（拿不到留空）。 */
+    modelId?: InputMaybe<Scalars['String']['input']>;
     outcome: AuditOutcome;
-    /** 项目 slug（CNB 仓库 slug 或工作区目录名），用于把事件挂到项目上。 */
+    /** 项目 slug（CNB 仓库 slug 或已登记工作区 slug），用于把事件挂到项目上。 */
     projectSlug?: InputMaybe<Scalars['String']['input']>;
+    reasoningLevel?: InputMaybe<Scalars['String']['input']>;
+    /** 任务引用 `<repo>#<issue|pr>#<iid>`：NPC 一次任务的稳定身份，会话尚未创建也带。 */
+    runRef?: InputMaybe<Scalars['String']['input']>;
+    /** dsh 会话 id（会话创建 / 销毁事件给出）。 */
+    sessionId?: InputMaybe<Scalars['String']['input']>;
     /** 目标展示名（例 `issue-12` / `PR #34`）。 */
     targetLabel?: InputMaybe<Scalars['String']['input']>;
+    /** 本次会话的 cwd 与命中的已登记工作区 slug。 */
+    workspacePath?: InputMaybe<Scalars['String']['input']>;
+    workspaceSlug?: InputMaybe<Scalars['String']['input']>;
 };
 /** 全局 headless 角色默认（plan / execute）；读取失败时整个块为 null。 */
 export type RuntimeHeadlessModels = {
@@ -880,6 +1015,17 @@ export type RuntimeProject = {
     planReasoningLevel?: Maybe<ReasoningLevel>;
     slug: Scalars['String']['output'];
 };
+/**
+ * 运行面看到的 Redmine 事实：地址来自全局配置、密钥来自本人配置。
+ * 块内任一为 null 即权威「未配置」；整块为 null 表示本次读取失败。
+ */
+export type RuntimeRedmine = {
+    __typename?: 'RuntimeRedmine';
+    /** 本人 API Key；null = 本人还没配。运行面拿它起 Redmine 只读 MCP 服务。 */
+    apiKey?: Maybe<Scalars['String']['output']>;
+    /** 组织共用的 Redmine 地址；null = 管理员还没配。 */
+    baseUrl?: Maybe<Scalars['String']['output']>;
+};
 /** 运行面技能目录条目：此刻对读取者生效的未归档 head。 */
 export type RuntimeSkill = {
     __typename?: 'RuntimeSkill';
@@ -892,6 +1038,10 @@ export type RuntimeSkill = {
     filesBytes: Scalars['Int']['output'];
     /** 逻辑技能 id（provider 的 locator，跨版本稳定）。 */
     id: Scalars['ID']['output'];
+    /** 解析后的调用策略；provider 必须原样透传给 dsh。 */
+    invocation: SkillInvocationPolicy;
+    /** dsh 标准自由 metadata；null = frontmatter 未写键。 */
+    metadata?: Maybe<Scalars['JSON']['output']>;
     name: Scalars['String']['output'];
     /** null = 全局技能；是否对本 cwd 生效由 client 按已登记工作区裁定。 */
     projectId?: Maybe<Scalars['ID']['output']>;
@@ -926,6 +1076,8 @@ export type RuntimeViewer = {
 export type SaveGlobalInput = {
     expectedRevision: Scalars['Int']['input'];
     preferences?: InputMaybe<PreferencesInput>;
+    /** 组织共用的 Redmine 地址；省略 = 不改，null = 清除（必须是 https，development 下允许回环 http）。 */
+    redmineBaseUrl?: InputMaybe<Scalars['String']['input']>;
 };
 export type SaveModelConnectionInput = {
     apiKey?: InputMaybe<SecretInput>;
@@ -983,6 +1135,8 @@ export type SaveSkillInput = {
 export type SaveUserInput = {
     expectedRevision: Scalars['Int']['input'];
     modelCredentials?: InputMaybe<Array<ModelCredentialInput>>;
+    /** 本人 / 代设用户的 Redmine API Key：value 与 clear 二选一，省略 = 不改；设置时 hub 先验证。 */
+    redmineApiKey?: InputMaybe<SecretInput>;
     userId: Scalars['ID']['input'];
 };
 /** value / clear / reuse 严格三选一。reuse 仅连接密钥场景有意义。 */
@@ -991,6 +1145,38 @@ export type SecretInput = {
     reuse?: InputMaybe<Scalars['Boolean']['input']>;
     value?: InputMaybe<Scalars['String']['input']>;
 };
+/** 身份安全的一条事实：控制台的身份与凭据事件。 */
+export type SecurityEvent = {
+    __typename?: 'SecurityEvent';
+    action: Scalars['String']['output'];
+    actionLabel: Scalars['String']['output'];
+    actorDisplayName?: Maybe<Scalars['String']['output']>;
+    actorId?: Maybe<Scalars['ID']['output']>;
+    actorKind: AuditActorKind;
+    actorUsername?: Maybe<Scalars['String']['output']>;
+    clientIp?: Maybe<Scalars['String']['output']>;
+    /** 身份 / 权限 / 凭据错误码；成功时为空。 */
+    code?: Maybe<Scalars['String']['output']>;
+    detail: Scalars['JSON']['output'];
+    id: Scalars['ID']['output'];
+    occurredAt: Scalars['DateTime']['output'];
+    outcome: AuditOutcome;
+    userAgent?: Maybe<Scalars['String']['output']>;
+};
+/** 身份安全筛选：各条件并列（AND）；from/to 为闭区间。 */
+export type SecurityEventFilter = {
+    /** 精确匹配动作码；选项清单走 securityActionOptions。 */
+    action?: InputMaybe<Scalars['String']['input']>;
+    actorUserId?: InputMaybe<Scalars['ID']['input']>;
+    from?: InputMaybe<Scalars['DateTime']['input']>;
+    outcome?: InputMaybe<AuditOutcome>;
+    to?: InputMaybe<Scalars['DateTime']['input']>;
+};
+export type SecurityEventPage = {
+    __typename?: 'SecurityEventPage';
+    items: Array<SecurityEvent>;
+    total: Scalars['Int']['output'];
+};
 /** 自画像的当前版本；从未配置过时 version = 0、content 为空串。 */
 export type SelfPortrait = {
     __typename?: 'SelfPortrait';
@@ -1003,7 +1189,7 @@ export type SelfPortrait = {
     /** 当前版本号；保存时作为 CAS 令牌（0 = 从未配置过）。 */
     version: Scalars['Int']['output'];
 };
-/** 一个不可变历史快照；作者用扁平字段（同 AuditEvent 口径）。 */
+/** 一个不可变历史快照；作者用扁平字段（同日志事实口径）。 */
 export type SelfPortraitVersion = {
     __typename?: 'SelfPortraitVersion';
     content: Scalars['String']['output'];
@@ -1047,17 +1233,25 @@ export type Skill = {
     archived: Scalars['Boolean']['output'];
     content: Scalars['String']['output'];
     description: Scalars['String']['output'];
+    /** frontmatter 原始值；null = 未写键。 */
+    disableModelInvocation?: Maybe<Scalars['Boolean']['output']>;
     fileCount: Scalars['Int']['output'];
     /** 该版本的附件清单（随版本快照，由 skill_files 聚合）。 */
     files: Array<SkillFile>;
     filesBytes: Scalars['Int']['output'];
     /** 逻辑 id（跨版本稳定，即 skills.skill_id）。 */
     id: Scalars['ID']['output'];
+    /** 解析后的调用策略；未写调用键即双开。 */
+    invocation: SkillInvocationPolicy;
+    /** dsh 标准自由 metadata；null = frontmatter 未写键。 */
+    metadata?: Maybe<Scalars['JSON']['output']>;
     name: Scalars['String']['output'];
     /** null = 全局技能；文本工具与运行面按它分作用域。 */
     projectId?: Maybe<Scalars['ID']['output']>;
     /** head 行的 createdAt。 */
     updatedAt: Scalars['DateTime']['output'];
+    /** frontmatter 原始值；null = 未写键。 */
+    userInvocable?: Maybe<Scalars['Boolean']['output']>;
     /** 当前头版本号；保存时用 expectedVersion 做 CAS。 */
     version: Scalars['Int']['output'];
     whenToUse?: Maybe<Scalars['String']['output']>;
@@ -1101,13 +1295,19 @@ export type SkillFilter = {
     projectId?: InputMaybe<Scalars['ID']['input']>;
     search?: InputMaybe<Scalars['String']['input']>;
 };
+/** dsh 标准调用策略：模型工具与用户命令各自能否展示并加载该技能。 */
+export type SkillInvocationPolicy = {
+    __typename?: 'SkillInvocationPolicy';
+    modelInvocable: Scalars['Boolean']['output'];
+    userInvocable: Scalars['Boolean']['output'];
+};
 export type SkillPage = {
     __typename?: 'SkillPage';
     items: Array<Skill>;
     /** 与本次 filter 同口径的技能总数。 */
     total: Scalars['Int']['output'];
 };
-/** 一个不可变历史快照。作者用扁平字段（同 AuditEvent 口径），不构造完整 User。 */
+/** 一个不可变历史快照。作者用扁平字段（同日志事实口径），不构造完整 User。 */
 export type SkillVersion = {
     __typename?: 'SkillVersion';
     archived: Scalars['Boolean']['output'];
@@ -1136,6 +1336,8 @@ export type UpdateCnbTokenInput = {
 export type UpdateMyConfigurationInput = {
     expectedRevision: Scalars['Int']['input'];
     modelCredentials?: InputMaybe<Array<ModelCredentialInput>>;
+    /** 本人 Redmine API Key：value 与 clear 二选一，省略 = 不改；设置时 hub 先验证。 */
+    redmineApiKey?: InputMaybe<SecretInput>;
 };
 /** 令牌可见组织树里的一个成员：只读快照，不落库，供同步弹层勾选要添加的用户。 */
 export type UpstreamCnbMember = {
@@ -1183,7 +1385,8 @@ export type User = {
     createdAt: Scalars['DateTime']['output'];
     displayName: Scalars['String']['output'];
     id: Scalars['ID']['output'];
-    lastReadAt?: Maybe<Scalars['DateTime']['output']>;
+    /** 该用户最近一次客户端会话的开始时间；从没开过会话时为 null。 */
+    lastActivityAt?: Maybe<Scalars['DateTime']['output']>;
     /** users 行 revision；状态与角色集合修改都用它做 CAS。 */
     revision: Scalars['Int']['output'];
     /** 服务端聚合（计数 / 最近时间）；仅管理员查询有值。 */
@@ -1197,6 +1400,8 @@ export type User = {
 /** user_configuration 一行的领域读模型。 */
 export type UserConfiguration = {
     __typename?: 'UserConfiguration';
+    /** 本人是否已配置 Redmine API Key；明文永不回读。 */
+    redmineApiKeyConfigured: Scalars['Boolean']['output'];
     revision: Scalars['Int']['output'];
     userId: Scalars['ID']['output'];
 };

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

@@ -29,7 +29,7 @@ export interface Semi2Api {
     }>;
     /** 密码登录换无会话用户密钥（密码只在本次请求内存里）。 */
     loginToConsole(input: ConsoleLoginInput): Promise<ConsoleLoginOutcome>;
-    /** 运行面生命周期上报（会话启停 / 拒绝 / 交付）；失败不改变运行面行为。 */
+    /** 运行面生命周期上报（会话起手 / 创建 / 销毁 / 拒绝 / 交付）；失败不改变运行面行为。 */
     reportEvent(event: RuntimeEventReport): Promise<DomainOutcome<RuntimeReportedEvent>>;
 }
 /**
@@ -43,6 +43,18 @@ export interface RuntimeEventReport {
     projectSlug?: string;
     targetLabel?: string;
     detail?: Record<string, unknown>;
+    /** dsh 会话 id：会话创建 / 销毁事件给出，hub 按它折叠会话行。 */
+    sessionId?: string;
+    /** 运行面实例标识：同名 dsh 会话在不同容器里靠它分开。 */
+    clientId?: string;
+    /** 任务引用：NPC 一次任务的稳定身份（会话尚未创建的事件也带）。 */
+    runRef?: string;
+    /** 本面工作区：会话 cwd 与命中的已登记工作区 slug。 */
+    workspacePath?: string;
+    workspaceSlug?: string;
+    /** 会话使用的模型与档位。 */
+    modelId?: string;
+    reasoningLevel?: string;
 }
 export type RuntimeReportedEvent = RuntimeReportEventMutation['runtimeReportEvent'];
 export interface Semi2ApiOptions {

package/lib/types/contract.d.ts

@@ -9,6 +9,12 @@ export declare const SEMI2_SECTION_ORDERS: {
     readonly cnbWorkstation: 3;
 };
 export type Semi2SectionKey = keyof typeof SEMI2_SECTION_ORDERS;
+/**
+ * 插件自身设置段的条目 id：dsh 的设置命名空间就是 Profile 插件条目 id（bundle patch 里那一行的 id），
+ * 状态 / 健康 / 归属表 / 工作区映射都写在这一段里。host 与浏览器半边共用这一个常量
+ * （`cordis.patch.yml` 的插件行 id 必须与它一致，`test/dsh/unit/profile-patch.test.mjs` 对账）。
+ */
+export declare const SEMI2_SETTINGS_ENTRY = "semi2-dsh";
 /** 只读 systemPrompt 的号段解析面：老宿主没有 `getSectionOrder` 时回落本表偏移。 */
 export interface SectionOrderSource {
     getSectionOrder?(name: string): number | undefined;
@@ -31,6 +37,11 @@ export interface Semi2Runtime {
     face: Semi2Face;
     /** semi2-hub 连接凭据；缺省 = 回落 dsh credentials 登录存储。 */
     credentials?: Semi2Credentials;
+    /**
+     * 本次运行的稳定引用（NPC 面 = `<仓库>#<issue|pr>#<号>`），由适配器解析触发后填。
+     * 客户端的会话日志按它把「起手 → 交付 → 会话 → 核对」并成一条：会话尚未创建的事件也带得上。
+     */
+    taskRef?: string;
 }
 /** cordis 服务名（适配器 provide / 插件 get 共用同一常量）。 */
 export declare const SEMI2_RUNTIME_SERVICE = "semi2Runtime";

package/lib/types/domains/models/web-search.d.ts

@@ -0,0 +1,8 @@
+import type { CompiledDeepSeek } from '../../hub/compile.js';
+import type { DomainHost, LoadRun, RevertRun } from '../types.js';
+/**
+ * 官方搜索默认解析 `DEEPSEEK_API_KEY`，而 hub 下发的是连接级引用；这里只对齐引用，
+ * 搜索端点与其他搜索配置仍归本地配置的所有者。
+ */
+export declare function syncWebSearchKeyEnv(host: DomainHost, run: LoadRun, deepseek: CompiledDeepSeek | null): Promise<void>;
+export declare function reclaimWebSearchKeyEnv(host: DomainHost, run: RevertRun): Promise<void>;