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

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

@@ -26,12 +26,18 @@ export type Scalars = {
         input: string;
         output: string;
     };
-    /** 自由形状的脱敏数据：仅审查日志的 detail 使用（服务端写入前已脱敏，只读不参与计算）。 */
+    /** 自由形状的脱敏数据：仅日志事实的 detail 使用（服务端写入前已脱敏，只读不参与计算）。 */
     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,6 +739,11 @@ export type Query = {
      * 工作区逐个项目要，不必把整个项目表拉回本地。
      */
     runtimeProjects?: Maybe<Array<RuntimeProject>>;
+    /**
+     * 本面可用的 Redmine 地址与本人密钥；块内任一 null = 权威未配置（运行面不挂 Redmine 工具），
+     * 本次读取失败为 null。
+     */
+    runtimeRedmine?: Maybe<RuntimeRedmine>;
     /**
      * 自画像正文（agent 会话开头注入的人设）；未配置为空串，本次读取失败为 null。
      * 全局一份，与读取者身份无关。
@@ -669,6 +761,10 @@ export type Query = {
     runtimeSkills?: Maybe<Array<RuntimeSkill>>;
     /** 本次读取者（服务器里当前用户）；失败为 null。 */
     runtimeViewer?: Maybe<RuntimeViewer>;
+    /** 身份动作码清单（管理员）：筛选下拉的选项来源。 */
+    securityActionOptions: Array<ActionOption>;
+    /** 身份安全（管理员）：控制台身份与凭据事件。 */
+    securityEvents: SecurityEventPage;
     /** 自画像的当前版本（全局一份 agent 人设）。 */
     selfPortrait: SelfPortrait;
     /** 自画像的历史快照（新在前，最多 50 条）。 */
@@ -681,6 +777,8 @@ export type Query = {
     skillVersions: Array<SkillVersion>;
     /** 技能头版本列表；filter 决定作用域与状态。 */
     skills: SkillPage;
+    /** 无会话事件（管理员）：被拒 / 失败的运行面读取与起会话之前的整体失败。 */
+    unassignedClientEvents: ClientSessionEventPage;
     /** 读令牌可见的 CNB 组织成员但不写库：返回列表供同步勾选；失败按 DomainError 码回。 */
     upstreamCnbMembers: Array<UpstreamCnbMember>;
     /** 读令牌可见的 CNB 仓库但不写库：返回列表供同步勾选；失败按 DomainError 码回。 */
@@ -696,17 +794,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 +829,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 +851,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 +872,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 +938,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 +1010,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';
@@ -926,6 +1067,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 +1126,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 +1136,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 +1180,7 @@ export type SelfPortrait = {
     /** 当前版本号；保存时作为 CAS 令牌（0 = 从未配置过）。 */
     version: Scalars['Int']['output'];
 };
-/** 一个不可变历史快照；作者用扁平字段（同 AuditEvent 口径）。 */
+/** 一个不可变历史快照；作者用扁平字段（同日志事实口径）。 */
 export type SelfPortraitVersion = {
     __typename?: 'SelfPortraitVersion';
     content: Scalars['String']['output'];
@@ -1107,7 +1284,7 @@ export type SkillPage = {
     /** 与本次 filter 同口径的技能总数。 */
     total: Scalars['Int']['output'];
 };
-/** 一个不可变历史快照。作者用扁平字段（同 AuditEvent 口径），不构造完整 User。 */
+/** 一个不可变历史快照。作者用扁平字段（同日志事实口径），不构造完整 User。 */
 export type SkillVersion = {
     __typename?: 'SkillVersion';
     archived: Scalars['Boolean']['output'];
@@ -1136,6 +1313,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 +1362,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 +1377,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

@@ -31,6 +31,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/redmine/domain.d.ts

@@ -0,0 +1,59 @@
+import type { DomainHost, DomainService, LoadRun, RevertRun } from '../types.js';
+import type { Semi2ConfigState } from '../../hub/facts.js';
+/** MCP 服务的命名空间（工具名 = `mcp__redmine__<tool>`）。 */
+export declare const REDMINE_SERVER_NAME = "redmine";
+/** 一次挂载的完整配置（形状由官方 mcp-client 的 Config 决定，这里逐字段收口）。 */
+export interface RedmineMcpConfig {
+    transport: 'stdio';
+    serverName: string;
+    command: string;
+    args: string[];
+    env: Record<string, string>;
+    cwd: string;
+    toolCallTimeoutMs: number;
+    failOnStartupError: boolean;
+}
+/** 挂载句柄：就绪面（激活 + 首次连接与工具发现）+ 官方 fiber 的卸载面。 */
+export interface MountedServer {
+    /** true = 工具已注册；false = 到上限仍未就绪或激活失败（光纤留着，官方那边会自己重连）。 */
+    ready: Promise<boolean>;
+    dispose(): Promise<void>;
+}
+/** 领域依赖的运行面能力（插件上下文与 process.env 都在 index.ts 里收口，领域自己不认识 cordis）。 */
+export interface RedmineFaces {
+    /** 挂一根官方 mcp-client 光纤；缺闭包 / 配置不合法时 reject（只 warn 降级）。 */
+    mount(config: RedmineMcpConfig): Promise<MountedServer>;
+    /** 起进程的命令与工作目录（env 覆盖、已登记工作区）。 */
+    command(): string;
+    cwd(): string;
+}
+/** boot 事实 → 挂载配置；密钥只进子进程 env，不落盘、不进日志。 */
+export declare function redmineMcpConfig(baseUrl: string, apiKey: string, faces: Pick<RedmineFaces, 'command' | 'cwd'>): RedmineMcpConfig;
+export declare class RedmineDomain implements DomainService {
+    private readonly host;
+    private readonly faces;
+    readonly id: "redmine";
+    private mounted;
+    private degraded;
+    private pending;
+    constructor(host: DomainHost, faces: RedmineFaces);
+    /**
+     * boot 事实落地：
+     * - 块缺失 / null（读取失败）→ 只 warn，保持现状（不动已挂的服务）；
+     * - 两项齐备 → 配置没变就不重挂，变了先卸再挂；
+     * - 任一项 null（权威未配置）→ 卸载。
+     */
+    applyBoot(run: LoadRun): Promise<void>;
+    /** 登出 / 服务端整体撤下：Redmine 工具随身份一起收走。 */
+    revert(_run: RevertRun): Promise<void>;
+    private unmount;
+    statusFields(state: Semi2ConfigState): Record<string, string>;
+    summary(state: Semi2ConfigState): string | null;
+    health(): {
+        state: "ok";
+        note: string;
+    } | {
+        state: "degraded";
+        note: string;
+    };
+}

package/lib/types/domains/redmine/index.d.ts

@@ -0,0 +1,10 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { DomainPlugin } from '../types.js';
+import { type RedmineFaces } from './domain.js';
+/** 起进程的命令：镜像里在 PATH 上；npm 消费者可用 `SEMI2_REDMINE_MCP_BIN` 指到别处（同 CodeGraph 口径）。 */
+export declare function redmineMcpCommand(env: NodeJS.ProcessEnv): string;
+/** 子进程工作目录 = 本面工作目录（同 CodeGraph 挂载行）。 */
+export declare function redmineMcpCwd(env: NodeJS.ProcessEnv): string;
+/** 运行面能力：动态 import 官方包 + 在本领域的 ctx 上挂一根光纤（dispose 由领域持有）。 */
+export declare function createRedmineFaces(ctx: Context): RedmineFaces;
+export declare const redmineDomain: DomainPlugin;