@aalis/core 0.1.0

package/dist/types/web-search.d.ts

@@ -0,0 +1,88 @@
+/** 单条搜索结果 */
+export interface WebSearchResult {
+    /** 条目标题 */
+    title: string;
+    /** 条目 URL */
+    url: string;
+    /** 摘要/片段（可能为空） */
+    snippet?: string;
+    /** 来源站点（可选，如 "wikipedia.org"） */
+    source?: string;
+    /** 发布或更新日期（可选，ISO 字符串） */
+    publishedAt?: string;
+}
+/** 搜索请求参数 */
+export interface WebSearchRequest {
+    /** 搜索关键词 */
+    query: string;
+    /** 期望返回的结果数（后端决定最大值） */
+    numResults?: number;
+    /** 语言偏好（如 'zh' / 'en'），后端可忽略 */
+    language?: string;
+    /** 搜索类型筛选（后端按 capability 声明的支持范围处理） */
+    kind?: 'web' | 'news' | 'images';
+}
+/** 搜索响应 */
+export interface WebSearchResponse {
+    /** 搜索关键词（回显） */
+    query: string;
+    /** 结果列表 */
+    results: WebSearchResult[];
+    /** 后端给出的摘要/答案框（如 Serper 的 answerBox） */
+    answer?: string;
+    /** 相关问题（若后端支持） */
+    relatedQuestions?: string[];
+    /** 后端元信息（如耗时、总条数等） */
+    raw?: Record<string, unknown>;
+}
+/**
+ * 网络搜索服务
+ *
+ * 实现者需至少提供 `search()`。`describeProvider()` 用于日志/WebUI 展示。
+ */
+export interface WebSearchService {
+    /** 执行一次搜索 */
+    search(request: WebSearchRequest): Promise<WebSearchResponse>;
+    /** 后端标识（供日志/排错用），如 'serper' */
+    readonly providerName: string;
+}
+/**
+ * 网络搜索服务能力注册表
+ *
+ * 第三方插件可通过 declaration merging 追加：
+ * ```ts
+ * declare module '@aalis/core' {
+ *   interface WebSearchCapabilityRegistry {
+ *     Scholar: 'scholar';
+ *   }
+ * }
+ * ```
+ */
+export interface WebSearchCapabilityRegistry {
+    /** 支持常规网页搜索（基本能力） */
+    Web: 'web';
+    /** 支持新闻搜索 */
+    News: 'news';
+    /** 支持图片搜索 */
+    Images: 'images';
+    /** 支持对结果进行 LLM 压缩/摘要 */
+    Compression: 'compression';
+    /** 返回关联问题 */
+    RelatedQuestions: 'related-questions';
+}
+/** 网络搜索能力字符串 union（自动包含第三方扩展） */
+export type WebSearchCapability = WebSearchCapabilityRegistry[keyof WebSearchCapabilityRegistry];
+/** 网络搜索内置能力常量 */
+export declare const WebSearchCapabilities: {
+    readonly Web: "web";
+    readonly News: "news";
+    readonly Images: "images";
+    readonly Compression: "compression";
+    readonly RelatedQuestions: "related-questions";
+};
+declare module './capabilities.js' {
+    interface ServiceCapabilityMap {
+        'web-search': WebSearchCapability;
+    }
+}
+//# sourceMappingURL=web-search.d.ts.map

package/dist/types/web-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-search.d.ts","sourceRoot":"","sources":["../../src/types/web-search.ts"],"names":[],"mappings":"AAUA,aAAa;AACb,MAAM,WAAW,eAAe;IAC9B,WAAW;IACX,KAAK,EAAE,MAAM,CAAC;IACd,aAAa;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,kBAAkB;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,aAAa;AACb,MAAM,WAAW,gBAAgB;IAC/B,YAAY;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,IAAI,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;CAClC;AAED,WAAW;AACX,MAAM,WAAW,iBAAiB;IAChC,gBAAgB;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW;IACX,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kBAAkB;IAClB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,sBAAsB;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,aAAa;IACb,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC9D,+BAA+B;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAID;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,2BAA2B;IAC1C,qBAAqB;IACrB,GAAG,EAAE,KAAK,CAAC;IACX,aAAa;IACb,IAAI,EAAE,MAAM,CAAC;IACb,aAAa;IACb,MAAM,EAAE,QAAQ,CAAC;IACjB,wBAAwB;IACxB,WAAW,EAAE,aAAa,CAAC;IAC3B,aAAa;IACb,gBAAgB,EAAE,mBAAmB,CAAC;CACvC;AAED,iCAAiC;AACjC,MAAM,MAAM,mBAAmB,GAAG,2BAA2B,CAAC,MAAM,2BAA2B,CAAC,CAAC;AAEjG,iBAAiB;AACjB,eAAO,MAAM,qBAAqB;;;;;;CAMc,CAAC;AAEjD,OAAO,QAAQ,mBAAmB,CAAC;IACjC,UAAU,oBAAoB;QAC5B,YAAY,EAAE,mBAAmB,CAAC;KACnC;CACF"}

package/dist/types/web-search.js

@@ -0,0 +1,23 @@
+// ----- 网络搜索服务接口 -----
+//
+// 由 plugin-websearch-serper 等插件实现。Agent 或其他插件可通过
+// `ctx.getService<WebSearchService>('web-search')` 获得该服务来执行搜索，
+// 而无需关心具体后端（Serper / DuckDuckGo / Bing 等）。
+//
+// 多个搜索后端可同时注册，框架按 priority 选择默认实现；
+// 若需指定特定后端（如只使用带新闻能力的后端），可通过 capability 过滤：
+//   `ctx.getService<WebSearchService>('web-search', ['news'])`
+/** 网络搜索内置能力常量 */
+export const WebSearchCapabilities = {
+    Web: 'web',
+    News: 'news',
+    Images: 'images',
+    Compression: 'compression',
+    RelatedQuestions: 'related-questions',
+};
+import { registerCapabilityProbe } from './capabilities.js';
+registerCapabilityProbe('web-search', WebSearchCapabilities.Web, inst => typeof inst.search === 'function'
+    ? true
+    : 'WebSearchService.search() is required for capability "web"');
+// News / Images / Compression / RelatedQuestions 均由请求参数/实现内决定，不做方法探测。
+//# sourceMappingURL=web-search.js.map

package/dist/types/web-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-search.js","sourceRoot":"","sources":["../../src/types/web-search.ts"],"names":[],"mappings":"AAAA,uBAAuB;AACvB,EAAE;AACF,iDAAiD;AACjD,+DAA+D;AAC/D,2CAA2C;AAC3C,EAAE;AACF,mCAAmC;AACnC,4CAA4C;AAC5C,+DAA+D;AAoF/D,iBAAiB;AACjB,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,GAAG,EAAE,KAAK;IACV,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,QAAQ;IAChB,WAAW,EAAE,aAAa;IAC1B,gBAAgB,EAAE,mBAAmB;CACS,CAAC;AAQjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,uBAAuB,CAAC,YAAY,EAAE,qBAAqB,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CACtE,OAAQ,IAA6B,CAAC,MAAM,KAAK,UAAU;IACzD,CAAC,CAAC,IAAI;IACN,CAAC,CAAC,4DAA4D,CAAC,CAAC;AAEpE,sEAAsE"}

package/dist/types/webui.d.ts

@@ -0,0 +1,137 @@
+import type { ConfigSchema } from './core.js';
+/**
+ * WebUI 服务 —— Web 管理后台
+ *
+ * 负责启动 HTTP 服务器，提供 REST API（插件管理、配置、权限等）
+ * 和 WebSocket（消息/日志推送），同时托管前端静态文件。
+ *
+ * 核心要求此服务必须运行。
+ * 默认由 plugin-webui 提供，第三方可替换整个实现或仅替换前端部分。
+ */
+export interface WebUIService {
+    /** 获取 HTTP 服务监听端口 */
+    getPort(): number;
+    /** 获取 HTTP 服务监听地址 */
+    getHost(): string;
+    /**
+     * 设置前端静态文件目录
+     * 允许外部插件在运行时替换前端
+     */
+    setClientDir?(dir: string): void;
+}
+/** 统计卡片 */
+export interface WebuiStatComponent {
+    type: 'stat';
+    /** 卡片标题 */
+    label: string;
+    /** 获取数据的后端 handler 方法名，返回 { value: string | number } */
+    source: string;
+    /** 图标标识 */
+    icon?: string;
+}
+/** 数据表格 */
+export interface WebuiTableComponent {
+    type: 'table';
+    /** 表格标题 */
+    label?: string;
+    /** 获取数据的后端 handler 方法名，返回数组 */
+    source: string;
+    /** 列定义 */
+    columns: Array<{
+        key: string;
+        label: string;
+        render?: string;
+    }>;
+    /** 行操作按钮 */
+    actions?: Array<{
+        label: string;
+        method: string;
+        confirm?: string;
+        danger?: boolean;
+    }>;
+    /** 自动刷新间隔（秒），0 或不填则不自动刷新 */
+    refresh?: number;
+}
+/** 配置表单（复用 ConfigSchema） */
+export interface WebuiFormComponent {
+    type: 'form';
+    /** 表单标题 */
+    label?: string;
+    /** 加载初始值的 handler 方法名 */
+    source: string;
+    /** 保存时调用的 handler 方法名 */
+    save: string;
+    /** 表单字段定义，复用 ConfigSchema */
+    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;
+    /** 获取数据的 handler 方法名，返回 Record<string, unknown> */
+    source: string;
+}
+/** Markdown 内容 */
+export interface WebuiMarkdownComponent {
+    type: 'markdown';
+    /** 标题 */
+    label?: string;
+    /** 获取 markdown 文本的 handler 方法名，返回 { content: string } */
+    source: string;
+}
+/** 子标签页容器 */
+export interface WebuiTabsComponent {
+    type: 'tabs';
+    /** 容器标题 */
+    label?: string;
+    /** 子标签页定义 */
+    items: Array<{
+        key: string;
+        label: string;
+        content: WebuiComponent[];
+    }>;
+}
+/** 所有声明式页面组件的联合类型 */
+export type WebuiComponent = WebuiStatComponent | WebuiTableComponent | WebuiFormComponent | WebuiActionsComponent | WebuiInfoComponent | WebuiMarkdownComponent | WebuiTabsComponent;
+/** 插件可声明的 WebUI 页面 */
+export interface WebuiPage {
+    /** 页面唯一标识（对应前端路由/标签 key） */
+    key: string;
+    /** 页面显示名称 */
+    label: string;
+    /**
+     * 图标标识。支持两种格式：
+     * - 命名标识（如 'dashboard'）：前端映射到内置图标组件
+     * - 内联 SVG（以 '<svg' 开头）：前端直接渲染为图标
+     */
+    icon?: string;
+    /** 排序权重（越小越靠前，默认 99） */
+    order?: number;
+    /**
+     * 自定义渲染器标识。
+     * 当页面需要客户端的专用组件（而非声明式 content）时，插件声明此字段。
+     * 客户端根据此标识在自身的渲染器注册表中查找对应组件：
+     * - 找到 → 使用自定义组件渲染
+     * - 未找到 → 显示「此客户端不支持该页面」的提示
+     * 这样不同 webui 客户端可独立决定支持哪些自定义页面。
+     */
+    renderer?: string;
+    /** 声明式页面内容（不提供则使用客户端内置页面） */
+    content?: WebuiComponent[];
+}
+//# sourceMappingURL=webui.d.ts.map

package/dist/types/webui.d.ts.map

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

package/dist/types/webui.js

@@ -0,0 +1,3 @@
+// ----- WebUI 服务接口与声明式页面组件 -----
+export {};
+//# sourceMappingURL=webui.js.map

package/dist/types/webui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webui.js","sourceRoot":"","sources":["../../src/types/webui.ts"],"names":[],"mappings":"AAAA,iCAAiC"}

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@aalis/core",
+  "version": "0.1.0",
+  "type": "module",
+  "aalis": {
+    "core": true
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {},
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "@types/node": "^22.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  }
+}