@aalis/api-webui 0.9.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ace Nyan <ace@acenyan.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,25 @@
+# @aalis/api-webui
+
+类型/接口/能力声明包（只导出 `type` 与 `*Capabilities`，不含运行时逻辑）
+
+## 角色
+
+类型/接口/能力声明包（只导出 `type` 与 `*Capabilities`，不含运行时逻辑）
+
+## 安装
+
+```bash
+pnpm add @aalis/api-webui
+```
+
+## 使用
+
+```ts
+import type { /* ... */ } from '@aalis/api-webui';
+```
+
+本包为 *-api 类型包；实现见对应的运行时插件。
+
+## 许可
+
+见仓库根目录 LICENSE。

package/dist/index.d.ts

@@ -0,0 +1,309 @@
+import type { UserIdentity } from '@aalis/api-authority';
+import type { Context } from '@aalis/core';
+import type { ConfigSchema } from '@aalis/schema-config';
+/**
+ * WebUI 服务 —— Web 管理后台
+ *
+ * 负责启动 HTTP 服务器，提供 REST API（插件管理、配置、权限等）
+ * 和 WebSocket（消息/日志推送），同时托管前端静态文件。
+ *
+ * 核心要求此服务必须运行。
+ * 默认由 plugin-webui-server 提供，第三方可替换整个实现或仅替换前端部分。
+ */
+export interface WebUIService {
+    /** 获取 HTTP 服务监听端口 */
+    getPort(): number;
+    /** 获取 HTTP 服务监听地址 */
+    getHost(): string;
+    /**
+     * 设置前端静态文件目录
+     * 允许外部插件在运行时替换前端
+     */
+    setClientDir?(dir: string): void;
+    /** 注册一个 WebUI 页面；返回 dispose */
+    registerPage(page: WebuiPage, pluginName: string): () => void;
+    /** 列出当前所有已注册的页面（含插件归属） */
+    getPages(): Array<WebuiPage & {
+        pluginName: string;
+    }>;
+    /** 按插件名批量清除（供插件卸载时调用） */
+    unregisterByPlugin(pluginName: string): void;
+}
+/** 统计卡片 */
+export interface WebuiStatComponent {
+    type: 'stat';
+    label: string;
+    source: string;
+    icon?: string;
+}
+/** 数据表格 */
+export interface WebuiTableComponent {
+    type: 'table';
+    label?: string;
+    source: string;
+    columns: Array<{
+        key: string;
+        label: string;
+        render?: string;
+        nowrap?: boolean;
+        minWidth?: number;
+        maxWidth?: number;
+    }>;
+    actions?: Array<{
+        label: string;
+        method: string;
+        confirm?: string;
+        danger?: boolean;
+    }>;
+    refresh?: number;
+    /** 启用前端本地文本搜索（空格分隔多关键词，AND 语义，对所有列值做不区分大小写子串匹配） */
+    searchable?: boolean;
+    /** 搜索框 placeholder（searchable=true 时生效） */
+    searchPlaceholder?: string;
+}
+/** 配置表单（复用 ConfigSchema） */
+export interface WebuiFormComponent {
+    type: 'form';
+    label?: string;
+    source: string;
+    save: string;
+    schema: ConfigSchema;
+}
+/** 操作按钮组 */
+export interface WebuiActionsComponent {
+    type: 'actions';
+    label?: string;
+    items: Array<{
+        label: string;
+        method: string;
+        confirm?: string;
+        danger?: boolean;
+        variant?: string;
+    }>;
+}
+/** 键值信息面板 */
+export interface WebuiInfoComponent {
+    type: 'info';
+    label?: string;
+    source: string;
+}
+/** Markdown 内容 */
+export interface WebuiMarkdownComponent {
+    type: 'markdown';
+    label?: string;
+    source: string;
+}
+/** 子标签页容器 */
+export interface WebuiTabsComponent {
+    type: 'tabs';
+    label?: string;
+    items: Array<{
+        key: string;
+        label: string;
+        content: WebuiComponent[];
+    }>;
+}
+/**
+ * 交互式关系图组件（基于 Cytoscape）。
+ *
+ * `source` 后端方法签名: `(args: { focusId?: string; maxDepth?: number; maxBreadth?: number; filters?: Record<string, unknown> })`
+ * 返回 cytoscape 风格的 elements：
+ * ```ts
+ * {
+ *   nodes: Array<{ data: { id: string; label: string; kind: 'person' | 'event' | string; [k: string]: unknown } }>;
+ *   edges: Array<{ data: { id: string; source: string; target: string; label?: string; relationType?: string; [k: string]: unknown } }>;
+ *   focusId?: string;
+ *   stats?: Record<string, number | string>;
+ * }
+ * ```
+ *
+ * `detailSource` 可选：节点被点击时调用，签名 `(args: { nodeId: string; kind: string })`，返回任意键值对 → 右侧 Drawer 渲染。
+ */
+export interface WebuiGraphComponent {
+    type: 'graph';
+    label?: string;
+    source: string;
+    detailSource?: string;
+    /** 节点最大深度/宽度默认值（前端展示初值） */
+    defaultMaxDepth?: number;
+    defaultMaxBreadth?: number;
+    /** 自动刷新（毫秒），0 / undefined = 关闭 */
+    refresh?: number;
+    /** 顶部右上角额外按钮 */
+    actions?: Array<{
+        label: string;
+        method: string;
+        confirm?: string;
+        danger?: boolean;
+        variant?: string;
+    }>;
+    /**
+     * 自定义节点类别：节点 data.kind → 形状/颜色/图例文本。
+     * 声明后组件据此生成样式与底部图例，**不再使用人物关系图的内置三类**
+     * （person/event/entity）语义——非关系图场景（如权限图）必须声明，
+     * 避免冒用他人图例。
+     */
+    nodeKinds?: Array<{
+        kind: string;
+        label: string;
+        shape?: 'circle' | 'round-rect' | 'diamond';
+        color?: string;
+    }>;
+    /** 自定义边类别：边 data.kind → 颜色/虚线/图例文本。 */
+    edgeKinds?: Array<{
+        kind: string;
+        label: string;
+        color?: string;
+        dashed?: boolean;
+    }>;
+}
+/** 所有声明式页面组件的联合类型 */
+export type WebuiComponent = WebuiStatComponent | WebuiTableComponent | WebuiFormComponent | WebuiActionsComponent | WebuiInfoComponent | WebuiMarkdownComponent | WebuiTabsComponent | WebuiGraphComponent;
+/**
+ * 插件可声明的 WebUI 页面 —— 完整定义。
+ *
+ * 由本包直接导出（core 不再持有 WebuiPage 骨架）。
+ */
+export interface WebuiPage {
+    /** 页面唯一标识（对应前端路由/标签 key） */
+    key: string;
+    /** 页面显示名称 */
+    label: string;
+    /** 图标标识（命名标识或内联 SVG） */
+    icon?: string;
+    /** 排序权重（越小越靠前，默认 99） */
+    order?: number;
+    /** 自定义渲染器标识（非声明式 content 场景） */
+    renderer?: string;
+    /** 声明式页面内容（不提供则使用客户端内置页面） */
+    content?: WebuiComponent[];
+}
+/**
+ * 通过 declaration merging 向 core 的 PluginModule 注入
+ * 纯展示元数据字段（subsystem / extends）与 host-RPC 槽位（actions）。
+ *
+ * WebuiPage 注册路径为运行时 `useWebuiService(ctx).registerPage(...)`，
+ * 不作为静态 module 字段存在。
+ */
+declare module '@aalis/core' {
+    interface PluginModule {
+        /**
+         * 子系统归属，仅用于 WebUI 分组展示。
+         *
+         * 可用 id 与中文 label 由本包的 `DEFAULT_SUBSYSTEM_METADATA` 提供，
+         * 但允许使用任意自定义字符串（未匹配 metadata 时直接以 id 作为 label 显示）。
+         */
+        subsystem?: string;
+        /** 声明该插件对 core 的扩展（新增事件、钩子），仅用于前端展示。 */
+        extends?: ExtendDeclaration;
+        /**
+         * 插件 RPC 动作表 —— 供 host（webui-server 等）远程调用。
+         *
+         * core 不感知此字段；host 路由层（POST /api/page-action/:plugin/:method）
+         * 在权限闸门放行后以插件自身的 `entry.context` 调用 handler。
+         * 第三参 caller 为路由层解析出的调用者身份，handler 可用它做业务级
+         * 检查（如"不能委托超出自身持有的能力"）；忽略该参数即向后兼容。
+         */
+        actions?: Record<string, (ctx: Context, args: Record<string, unknown>, caller?: UserIdentity) => Promise<unknown>>;
+    }
+}
+declare module '@aalis/schema-config' {
+    /**
+     * WebUI 表单交互属性 —— 由本包注入（config-api 的 SchemaField 只声明各宿主共需字段）。
+     * 这些属性只被 WebUI 配置表单消费；其他宿主可以忽略。
+     */
+    interface SchemaField {
+        /** 标记为敏感字段，前端显示时自动遮蔽 */
+        secret?: boolean;
+        /** select / multiselect 动态选项来源：服务名（前端经 webui-server 调该服务的 listModels() 或等价方法获取选项） */
+        dynamicOptions?: string;
+        /** multiselect 是否允许用户手动输入自定义值（不限于选项列表） */
+        allowCustom?: boolean;
+    }
+}
+/**
+ * Scoped WebUI 服务：在插件 apply() 中注册页面，自动绑定到当前 ctx 生命周期。
+ */
+export interface ScopedWebuiService {
+    /** 注册页面；返回 dispose（与 ctx 生命周期绑定）。 */
+    registerPage(page: WebuiPage): () => void;
+    /** 获取底层 service（未就绪时为 undefined）。 */
+    readonly raw: WebUIService | undefined;
+}
+/**
+ * 获取 ScopedWebuiService。
+ *
+ * 实现委托给 `ctx.whenService('webui-server', ...)`：每次 webui-server
+ * 重新 provide（bounce/replace）都会重新调用 `registerPage`，让插件页面
+ * 自动重挂；上次注册的 cleanup 在 provider 下线时自动释放。
+ */
+export declare function useWebuiService(ctx: Context): ScopedWebuiService;
+/**
+ * 插件可以声明它对 core 做了哪些扩展，用于前端展示和文档生成。
+ *
+ * 仅是元数据描述，core 不会读取也不会校验，仅透传给 WebUI 展示。
+ *
+ * @example
+ * export const extends_: ExtendDeclaration = {
+ *   events: ['scheduler:tick', 'scheduler:error'],
+ *   hooks: ['schedule:before'],
+ * };
+ */
+export interface ExtendDeclaration {
+    /** 该插件新增的自定义事件名 */
+    events?: string[];
+    /** 该插件新增的自定义钩子名 */
+    hooks?: string[];
+    /** 该插件向哪些服务混入了方法（服务名 → 方法名列表），仅用于前端展示。 */
+    mixins?: Record<string, string[]>;
+}
+/**
+ * 子系统展示目录条目。
+ *
+ * **职责边界**：
+ * - 这是 **WebUI 展示层契约**，唯一消费者是 webui-server 的 `/api/service-groups` 路由。
+ * - `core` 完全不知道 subsystem 概念，仅在 PluginModule 上保留一个透传字段
+ *   `subsystem?: string`（不读不解释，纯粹搬运给 WebUI）。
+ * - 本表只描述 **展示元数据**（中文 label / 排序 / icon），**不再写死插件归属**。
+ *   归属由每个插件自己在 index.ts 中声明：`export const subsystem = 'llm';`
+ *
+ * 解耦收益：
+ *   - 新增插件不需要改 webui-api（只改插件自身）
+ *   - 新增子系统：只在本表加一行元数据即可（id 未匹配时回退为 id 直接展示）
+ *   - webui-api 不再反向耦合具体插件 npm 名
+ */
+export interface SubsystemMetadata {
+    /** subsystem id（与 PluginModule.subsystem 对应） */
+    id: string;
+    /** 显示名（中文 label） */
+    label: string;
+    /** 排序权重，越小越靠前 */
+    order: number;
+}
+/**
+ * 默认子系统元数据。
+ *
+ * 仅提供常用 id 的中文 label 与排序；插件可任意自定义 subsystem id，
+ * 未命中本表时 WebUI 会回退到「id 原样展示，order=9999」。
+ */
+export declare const DEFAULT_SUBSYSTEM_METADATA: readonly SubsystemMetadata[];
+/**
+ * 前端提供者（忒修斯之船「换前端」契约）：把一份已构建的前端静态目录交给
+ * webui-server 托管。第三方前端两条接入：
+ * - **纯静态包**：package.json 标 `aalis.client: true` + 含 `dist/index.html`，被
+ *   webui-server 自动发现挂载（无需 `apply`，runtime 不会把它当插件加载）。
+ * - **主动覆盖**：插件 `apply` 里 `ctx.provide('webui-client', impl)`，优先于自动发现。
+ */
+export interface WebuiClientProvider {
+    /** 返回含 index.html 的前端静态目录绝对路径 */
+    getClientDir(): string;
+    /** 可选展示名（多前端切换/选择时用） */
+    label?: string;
+}
+declare module '@aalis/core' {
+    interface ServiceTypeMap {
+        'webui-server': WebUIService;
+        'webui-client': WebuiClientProvider;
+    }
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,49 @@
+// ----- WebUI 服务接口与声明式页面组件 -----
+//
+// 此包提供 @aalis/core 中 WebuiPage skeleton 的完整扩展，
+// 以及所有声明式页面组件类型。
+// 任何需要声明 webuiPages 的插件应从本包导入相关类型。
+/**
+ * 获取 ScopedWebuiService。
+ *
+ * 实现委托给 `ctx.whenService('webui-server', ...)`：每次 webui-server
+ * 重新 provide（bounce/replace）都会重新调用 `registerPage`，让插件页面
+ * 自动重挂；上次注册的 cleanup 在 provider 下线时自动释放。
+ */
+export function useWebuiService(ctx) {
+    const pluginName = ctx.id || 'unknown';
+    return {
+        registerPage(page) {
+            return ctx.whenService('webui-server', svc => svc.registerPage(page, pluginName));
+        },
+        get raw() {
+            return ctx.getService('webui-server');
+        },
+    };
+}
+/**
+ * 默认子系统元数据。
+ *
+ * 仅提供常用 id 的中文 label 与排序；插件可任意自定义 subsystem id，
+ * 未命中本表时 WebUI 会回退到「id 原样展示，order=9999」。
+ */
+export const DEFAULT_SUBSYSTEM_METADATA = Object.freeze([
+    { id: 'system', label: '系统', order: 0 },
+    { id: 'core', label: '核心', order: 10 },
+    { id: 'platform', label: '平台', order: 20 },
+    { id: 'agent', label: 'Agent', order: 30 },
+    { id: 'llm', label: 'LLM', order: 40 },
+    { id: 'embedding', label: 'Embedding', order: 50 },
+    { id: 'memory', label: '记忆', order: 60 },
+    { id: 'persona', label: '人格', order: 70 },
+    { id: 'tools', label: '工具', order: 80 },
+    { id: 'storage', label: '存储', order: 85 },
+    { id: 'message', label: '消息', order: 90 },
+    { id: 'session', label: '会话', order: 100 },
+    { id: 'skills', label: '技能', order: 110 },
+    { id: 'scheduler', label: '调度', order: 120 },
+    { id: 'authority', label: '权限', order: 130 },
+    { id: 'user', label: '用户', order: 140 },
+    { id: 'external', label: '外部', order: 160 },
+]);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,EAAE;AACF,+CAA+C;AAC/C,iBAAiB;AACjB,mCAAmC;AAoOnC;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,GAAY;IAC1C,MAAM,UAAU,GAAG,GAAG,CAAC,EAAE,IAAI,SAAS,CAAC;IACvC,OAAO;QACL,YAAY,CAAC,IAAe;YAC1B,OAAO,GAAG,CAAC,WAAW,CAAe,cAAc,EAAE,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC;QAClG,CAAC;QACD,IAAI,GAAG;YACL,OAAO,GAAG,CAAC,UAAU,CAAe,cAAc,CAAC,CAAC;QACtD,CAAC;KACF,CAAC;AACJ,CAAC;AAgDD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAiC,MAAM,CAAC,MAAM,CAAC;IACpF,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE;IACvC,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE;IACtC,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE;IAC1C,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE;IAC1C,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE;IACtC,EAAE,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,EAAE,EAAE;IAClD,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE;IACxC,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE;IACzC,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE;IACvC,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE;IACzC,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE;IACzC,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE;IAC1C,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE;IACzC,EAAE,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE;IAC5C,EAAE,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE;IAC5C,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE;IACvC,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE;CAC5C,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@aalis/api-webui",
+  "version": "0.9.0",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AalisLabs/Aalis.git",
+    "directory": "packages/api-webui"
+  },
+  "author": "Ace Nyan <ace@acenyan.com>",
+  "bugs": {
+    "url": "https://github.com/AalisLabs/Aalis/issues"
+  },
+  "homepage": "https://github.com/AalisLabs/Aalis#readme",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@aalis/api-authority": ">=0.5.0 <1.0.0",
+    "@aalis/schema-config": ">=0.9.0 <1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0",
+    "@aalis/core": "0.10.0"
+  },
+  "aalis": {
+    "types": true
+  },
+  "peerDependencies": {
+    "@aalis/core": ">=0.2.0 <1.0.0"
+  },
+  "keywords": [
+    "aalis",
+    "aalis-api"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  }
+}