@icen.ai/ui 0.8.1 → 0.9.0

package/dist/behaviors/events.d.mts

@@ -2,6 +2,7 @@ import { ChartEventDetail } from './charts.js';
 import { AiUsage } from './ai-core.js';
 import { AiDoneEventDetail } from './ai-provider.js';
 import { AiComposerRefSource } from './ai-composer.js';
+import { KbCitation, KbSegmentConfig, KbRetrievalQuery, KbFilterNode, KbCheckpointScope, KbSandboxMessage, KbChainStep, KbAclEntry, KbIdentity, KbAclDecision, KbAccessRequest, KbRole, KbAuditChannel, KbHygieneIssue } from './kb-core.js';
 import './popover.js';
 import './ai-panel.js';
 
@@ -284,6 +285,198 @@ interface IcenEventMap {
     };
     'icen:ai-usage': AiUsage;
     'icen:ai-done': AiDoneEventDetail;
+    'icen:ai-thread-select': {
+        key: string;
+    };
+    'icen:ai-thread-action': {
+        action: 'rename' | 'pin' | 'archive' | 'delete' | 'move';
+        key: string;
+    };
+    'icen:ai-feedback': {
+        value: 1 | -1 | 0;
+        reason?: string;
+        el?: HTMLElement;
+    };
+    'icen:ai-branch-change': {
+        index: number;
+        count: number;
+    };
+    'icen:kb-citation-open': {
+        citation: KbCitation;
+    };
+    'icen:kb-source-open': {
+        source: KbCitation;
+    };
+    'icen:kb-passage-jump': {
+        citation: KbCitation;
+    };
+    'icen:kb-passage-close': Record<string, never>;
+    'icen:kb-pipeline-toggle': {
+        el: HTMLElement;
+        open: boolean;
+    };
+    'icen:kb-pipeline-rerun': {
+        documentId: string;
+    };
+    'icen:kb-chunk-toggle': {
+        chunkId: string;
+        available: boolean;
+    };
+    'icen:kb-chunk-edit': {
+        chunkId: string;
+    };
+    'icen:kb-chunk-remove': {
+        chunkId: string;
+    };
+    'icen:kb-chunk-add': {
+        documentId: string;
+    };
+    'icen:kb-chunk-search': {
+        mode: 'text' | 'vector';
+        query: string;
+    };
+    'icen:kb-segment-change': {
+        config: KbSegmentConfig;
+    };
+    'icen:kb-connector-sync': {
+        connectorId: string;
+    };
+    'icen:kb-connector-reauth': {
+        connectorId: string;
+    };
+    'icen:kb-connector-schedule': {
+        connectorId: string;
+        schedule: string;
+    };
+    'icen:kb-metadata-change': {
+        action: 'define' | 'bind' | 'remove';
+        key: string;
+    };
+    'icen:kb-qa-change': {
+        op: 'add' | 'edit' | 'remove';
+        index: number;
+    };
+    'icen:kb-qa-import': {
+        source: string;
+    };
+    'icen:kb-retrieval-run': {
+        query: KbRetrievalQuery;
+    };
+    'icen:kb-filter-change': {
+        node: KbFilterNode | null;
+        valid: boolean;
+    };
+    'icen:kb-rerank-toggle': {
+        enabled: boolean;
+        model?: string;
+    };
+    'icen:kb-hittest-add': {
+        question: string;
+    };
+    'icen:kb-hittest-run': Record<string, never>;
+    'icen:kb-sql-edit': {
+        sql: string;
+    };
+    'icen:kb-sql-rerun': {
+        sql: string;
+    };
+    'icen:kb-clarify-answer': {
+        id?: string;
+        value: string;
+        label: string;
+    };
+    'icen:kb-verified-open': {
+        assetId: string;
+    };
+    'icen:kb-explain-toggle': {
+        el: HTMLElement;
+        open: boolean;
+    };
+    'icen:kb-trace-select': {
+        spanId: string;
+    };
+    'icen:kb-trace-toggle': {
+        spanId: string;
+        open: boolean;
+    };
+    'icen:kb-review-assign': {
+        taskId: string;
+        assignee: string;
+    };
+    'icen:kb-review-score': {
+        taskId: string;
+        name: string;
+        value: string | number;
+    };
+    'icen:kb-review-submit': {
+        taskId: string;
+    };
+    'icen:kb-gap-action': {
+        query: string;
+        action: 'create-doc' | 'add-synonym';
+    };
+    'icen:kb-eval-compare': {
+        runA: string;
+        runB: string;
+    };
+    'icen:kb-canvas-ai': {
+        instruction: string;
+        selection?: {
+            text: string;
+        };
+    };
+    'icen:kb-canvas-version': {
+        versionId: string;
+    };
+    'icen:kb-checkpoint-restore': {
+        checkpointId: string;
+        scope: KbCheckpointScope;
+    };
+    'icen:kb-sandbox-message': {
+        channel: 'in' | 'out';
+        payload: KbSandboxMessage;
+    };
+    'icen:kb-chain-step': {
+        index: number;
+        step: KbChainStep;
+    };
+    'icen:kb-acl-grant': {};
+    'icen:kb-acl-remove': {
+        subject: KbAclEntry['subject'];
+    };
+    'icen:kb-acl-inherit': {
+        action: 'break' | 'restore';
+    };
+    'icen:kb-whocan-check': {
+        identity: KbIdentity;
+        decision: KbAclDecision;
+    };
+    'icen:kb-access-request': {
+        request: KbAccessRequest;
+    };
+    'icen:kb-access-decide': {
+        id: string;
+        decision: 'approve' | 'deny';
+        role?: KbRole;
+    };
+    'icen:kb-access-expire': {
+        id: string;
+    };
+    'icen:kb-audit-filter': {
+        channel: KbAuditChannel | 'all';
+    };
+    'icen:kb-audit-export': {
+        channel: KbAuditChannel | 'all';
+    };
+    'icen:kb-hygiene-action': {
+        issue: KbHygieneIssue;
+    };
+    'icen:kb-visibility-identity': {
+        identity: KbIdentity;
+    };
+    'icen:kb-visibility-layer': {
+        layer: 'pre' | 'post' | 'none';
+    };
     [key: `icen:${string}`]: unknown;
 }
 interface IcenListenOptions {

package/dist/behaviors/kb-access.d.mts

@@ -0,0 +1,34 @@
+import { KbAccessRequest, KbAccessState, KbRole } from './kb-core.js';
+import './ai-core.js';
+
+/** createKbAccess 入参（spec §9.3；request 宽进——素对象经 normalizeAccessRequest 归一） */
+interface KbAccessOpts {
+    /** 当前访问请求（内部持有副本，不打脏调用方数据） */
+    request: KbAccessRequest | Record<string, unknown>;
+    /** requester = 申请人视角（被拒五件套 + 表单）；approver = 审批人视角（队列卡）。缺省 requester */
+    mode?: 'requester' | 'approver';
+    /** 表单提交回调（与 icen:kb-access-request 双通道） */
+    onRequest?: (r: KbAccessRequest) => void;
+    /** 审批决定回调（与 icen:kb-access-decide 双通道；approve 时 role = 批准档位） */
+    onDecide?: (id: string, decision: 'approve' | 'deny', role?: KbRole) => void;
+    /** 被拒原因文案（缺省固定模板「此内容仅对授权者开放」——不给受限侧任何更多信息，§9.0.3） */
+    deniedHint?: string;
+    /** 切换身份回调（宿主关注：切换固定身份集重查权限；不派库事件） */
+    onSwitchIdentity?: () => void;
+}
+/** createKbAccess 句柄（函数名冻结于 spec §9.3） */
+interface KbAccessHandle {
+    /** 合并更新请求字段（Partial）或整体切状态（单字符串）；带过期时间的 granted 会即时派生 expired */
+    setState(next: Partial<KbAccessRequest> | KbAccessState): void;
+    /** 当前请求（normalize 后的副本；外部修改不影响内部） */
+    getState(): KbAccessRequest;
+    /** 清空 DOM 与标记（幂等；同一 el 重复 create 会先销毁旧实例） */
+    destroy(): void;
+}
+/**
+ * 创建访问申请流（requester：被拒五件套 + 表单 + 状态徽章族；approver：审批队列卡）。
+ * 快照渲染：setState / 表单交互后整树重建（重建前回填用户已输入的理由/时长，不打断打字）。
+ */
+declare function createKbAccess(el: HTMLElement, opts: KbAccessOpts): KbAccessHandle;
+
+export { type KbAccessHandle, type KbAccessOpts, createKbAccess };