@cicctencent/agent-server 0.1.1 → 0.1.2

package/dist/cjs/spi/types.d.ts

@@ -0,0 +1,317 @@
+import type { Message, ToolRegistry, SkillManager } from '@cicctencent/agent-core';
+/** 线程实体基础接口 */
+export interface BaseThreadEntity {
+    id: number | string;
+    title?: string;
+    status?: 'active' | 'archived' | 'deleted';
+    createdAt?: Date | string | number;
+    updatedAt?: Date | string | number;
+}
+/** 消息实体基础接口 */
+export interface BaseMessageEntity {
+    id: number | string;
+    threadId: number | string;
+    role: 'user' | 'assistant' | 'system';
+    content: string;
+    createdAt?: Date | string | number;
+}
+/** 工作空间实体基础接口 */
+export interface BaseWorkspaceEntity {
+    id: number | string;
+    name: string;
+    createdAt?: Date | string | number;
+}
+/** Agent Profile 实体基础接口 */
+export interface BaseAgentProfileEntity {
+    id: number | string;
+    name: string;
+    isDefault?: boolean;
+}
+/** Settings 实体基础接口 */
+export interface BaseSettingsEntity {
+    [key: string]: unknown;
+}
+/**
+ * 键值存储抽象接口
+ * 应用层可实现：JsonFileStorage, TypeORMStorage, MongoDBStorage 等
+ */
+export interface KVStorageAdapter {
+    /** 获取值 */
+    get<T>(key: string): Promise<T | null>;
+    /** 设置值 */
+    set<T>(key: string, value: T): Promise<void>;
+    /** 删除 */
+    delete(key: string): Promise<void>;
+    /** 检查存在 */
+    exists(key: string): Promise<boolean>;
+    /** 列出所有键 */
+    keys?(prefix?: string): Promise<string[]>;
+}
+/**
+ * 列表存储抽象接口
+ * 支持 CRUD 操作的实体列表
+ */
+export interface ListStorageAdapter<T> {
+    /** 获取所有 */
+    list(): Promise<T[]>;
+    /** 根据 ID 获取 */
+    findById(id: number | string): Promise<T | null>;
+    /** 添加 */
+    add(entity: T): Promise<T>;
+    /** 更新 */
+    update(id: number | string, data: Partial<T>): Promise<T | null>;
+    /** 删除 */
+    remove(id: number | string): Promise<boolean>;
+    /** 批量操作 */
+    batch?(operations: Array<{
+        type: 'add' | 'update' | 'delete';
+        data: T | Partial<T>;
+        id?: number | string;
+    }>): Promise<void>;
+}
+/**
+ * 查询条件接口
+ */
+export interface QueryOptions {
+    limit?: number;
+    offset?: number;
+    orderBy?: string;
+    orderDirection?: 'asc' | 'desc';
+    filter?: Record<string, unknown>;
+}
+/**
+ * Settings 存储提供者
+ * 应用层可替换底层存储（JSON 文件 / 数据库）
+ */
+export interface SettingsProvider<TSettings extends BaseSettingsEntity = BaseSettingsEntity> {
+    /** 获取设置 */
+    getSettings(): TSettings;
+    /** 更新设置 */
+    updateSettings(updates: Partial<TSettings>): TSettings;
+    /** 重置设置 */
+    resetSettings?(): TSettings;
+    /** 获取底层存储（可选，用于高级场景） */
+    getStorage?(): KVStorageAdapter;
+}
+/**
+ * 对话存储提供者
+ * 应用层可替换底层存储，自定义实体结构
+ *
+ * 支持同步和异步两种模式：
+ * - JSON 文件存储：同步方法
+ * - 数据库存储（TypeORM）：异步方法
+ */
+export interface ChatStoreProvider<TThread extends BaseThreadEntity = BaseThreadEntity, TMessage extends BaseMessageEntity = BaseMessageEntity> {
+    /** 获取线程列表（支持异步） */
+    getThreads(workspaceId?: number | string): TThread[] | Promise<TThread[]>;
+    /** 获取单个线程（支持异步） */
+    getThread(id: number | string): TThread | undefined | Promise<TThread | undefined>;
+    /** 创建线程（支持异步） */
+    createThread(data: Partial<TThread>): TThread | Promise<TThread>;
+    /** 更新线程（支持异步） */
+    updateThread(id: number | string, data: Partial<TThread>): TThread | undefined | Promise<TThread | undefined>;
+    /** 删除线程（支持异步） */
+    deleteThread(id: number | string): boolean | Promise<boolean>;
+    /** 获取消息列表（支持异步） */
+    getMessages(threadId: number | string, options?: QueryOptions): {
+        items: TMessage[];
+        total: number;
+        hasMore: boolean;
+    } | Promise<{
+        items: TMessage[];
+        total: number;
+        hasMore: boolean;
+    }>;
+    /** 添加消息（支持异步） */
+    addMessage(data: Partial<TMessage> & {
+        threadId: number | string;
+        role: string;
+        content: string;
+    }): TMessage | Promise<TMessage>;
+    /** 更新消息（支持异步） */
+    updateMessage(threadId: number | string, id: number | string, data: Partial<TMessage>): TMessage | undefined | Promise<TMessage | undefined>;
+    /** 删除消息（支持异步） */
+    deleteMessage(threadId: number | string, id: number | string): boolean | Promise<boolean>;
+    /** 清空消息（支持异步） */
+    clearThreadMessages(threadId: number | string): void | Promise<void>;
+    /** 构建线程历史（用于 AgentEngine） */
+    buildThreadHistory(threadId: number | string, limit?: number): Message[] | Promise<Message[]>;
+    /** 搜索消息 */
+    searchMessages?(query: string, options?: {
+        workspaceId?: number | string;
+        limit?: number;
+    }): Array<TMessage & {
+        snippet: string;
+    }> | Promise<Array<TMessage & {
+        snippet: string;
+    }>>;
+    /** 导出线程 */
+    exportThread?(threadId: number | string, format: 'markdown' | 'json' | 'text'): string | Promise<string>;
+    /** 获取底层存储（可选） */
+    getStorage?(): {
+        threads: ListStorageAdapter<TThread>;
+        messages: (threadId: number | string) => ListStorageAdapter<TMessage>;
+    };
+}
+/**
+ * Agent Profile 存储提供者
+ */
+export interface AgentProfileProvider<TProfile extends BaseAgentProfileEntity = BaseAgentProfileEntity> {
+    listProfiles(): TProfile[];
+    getProfile(id: number | string): TProfile | undefined;
+    getDefaultProfile(): TProfile | undefined;
+    createProfile(data: Partial<TProfile>): TProfile;
+    updateProfile(id: number | string, data: Partial<TProfile>): TProfile | undefined;
+    deleteProfile(id: number | string): boolean;
+    /** 扩展：设置默认 Profile */
+    setDefaultProfile?(id: number | string): void;
+    /** 获取底层存储 */
+    getStorage?(): ListStorageAdapter<TProfile>;
+}
+/**
+ * Prompt 构建者
+ * 应用层可自定义 Prompt 构建逻辑
+ */
+export interface PromptBuilderProvider {
+    buildDefaultPrompt(profile: BaseAgentProfileEntity, tools: ToolRegistry, memory?: string, specialists?: BaseAgentProfileEntity[], specialistResourceMap?: Record<string, {
+        connectorNames: string[];
+        mcpServerNames: string[];
+    }>): string;
+    buildSpecialistPrompt(profile: BaseAgentProfileEntity, tools: ToolRegistry, skills: SkillManager, memory?: string): string;
+    resolveToolDisplayName(toolName: string, registry: ToolRegistry): string;
+}
+/**
+ * 模型配置解析者
+ * 应用层可自定义模型选择逻辑
+ */
+export interface ModelConfigResolver {
+    resolve(modelConfigId?: string): {
+        id: string;
+        provider: string;
+        model: string;
+        apiKey?: string;
+        baseUrl?: string;
+    };
+    createProvider(modelConfigId?: string, modelOverride?: string): unknown;
+}
+/**
+ * SSE 响应适配器接口
+ * 框架无关，支持 Express / Koa / Fastify 等
+ */
+export interface SSEResponseAdapter {
+    /** 写入数据 */
+    write(data: string): void;
+    /** 结束响应 */
+    end(): void;
+    /** 响应是否已结束 */
+    readonly writableEnded: boolean;
+    /** 设置响应头 */
+    setHeader(name: string, value: string | number): void;
+    /** 刷新响应头 */
+    flushHeaders?(): void;
+    /** 设置状态码（错误时使用） */
+    status?(code: number): void;
+    /** 返回 JSON（错误时使用） */
+    json?(data: unknown): void;
+}
+/**
+ * 请求上下文适配器
+ * 用于提取用户信息、权限等
+ */
+export interface RequestContextAdapter {
+    /** 获取用户 ID */
+    getUserId?(): string | number | undefined;
+    /** 获取工作空间 ID */
+    getWorkspaceId?(): number | string | undefined;
+    /** 获取请求头 */
+    getHeader(name: string): string | undefined;
+    /** 检查权限 */
+    hasPermission?(permission: string): boolean;
+    /** 获取原始请求对象 */
+    getRawRequest?(): unknown;
+    /** 获取原始响应对象 */
+    getRawResponse?(): unknown;
+}
+/**
+ * AgentServer 工厂配置
+ * 所有 SPI 组件都可替换
+ */
+export interface AgentServerSPIOptions<TSettings extends BaseSettingsEntity = BaseSettingsEntity, TThread extends BaseThreadEntity = BaseThreadEntity, TMessage extends BaseMessageEntity = BaseMessageEntity, TProfile extends BaseAgentProfileEntity = BaseAgentProfileEntity> {
+    settingsProvider?: SettingsProvider<TSettings>;
+    chatStoreProvider?: ChatStoreProvider<TThread, TMessage>;
+    agentProfileProvider?: AgentProfileProvider<TProfile>;
+    promptBuilder?: PromptBuilderProvider;
+    modelConfigResolver?: ModelConfigResolver;
+    /** SSE 响应适配器工厂 */
+    createSSEResponseAdapter?: (res: unknown) => SSEResponseAdapter;
+    /** 请求上下文适配器工厂 */
+    createRequestContextAdapter?: (req: unknown) => RequestContextAdapter;
+    /** 权限检查 */
+    permissionChecker?: (userId: string | number, action: string, resource: string) => Promise<boolean>;
+    /** 审计日志 */
+    auditLogger?: (event: string, data: Record<string, unknown>) => void | Promise<void>;
+    /** 自定义中间件 */
+    customMiddlewares?: Array<{
+        name: string;
+        priority?: number;
+        handler: (context: unknown) => Promise<void>;
+    }>;
+}
+export interface ThreadEntity extends BaseThreadEntity {
+    workspaceId?: number | string;
+    summary?: string;
+    messageCount: number;
+    agentProfileId?: number | string;
+    source?: 'local' | 'a2a';
+    automationRunId?: number | string;
+}
+export interface MessageEntity extends BaseMessageEntity {
+    type: 'text' | 'code' | 'tool_call' | 'reasoning' | 'image';
+    meta?: Record<string, unknown>;
+    updatedAt?: Date | string | number;
+}
+export interface WorkspaceEntity extends BaseWorkspaceEntity {
+    description?: string;
+    color?: string;
+    icon?: string;
+    status: 'active' | 'archived';
+    threadCount: number;
+    automationCount: number;
+}
+export interface AgentProfileEntity extends BaseAgentProfileEntity {
+    description?: string;
+    icon?: string;
+    color?: string;
+    basePrompt: string;
+    model?: string;
+    modelConfigId?: string;
+    maxIterations?: number;
+    maxMessages?: number;
+    toolTimeout?: number;
+    disabledTools?: string[];
+    mcpServers?: Array<number | string>;
+    selectedSkills?: string[];
+    alwaysInjectSkills?: string[];
+    connectorIds?: string[];
+    agentType?: 'default' | 'specialist' | 'remote';
+    remoteUrl?: string;
+    domain?: string;
+}
+export interface SettingsEntity extends BaseSettingsEntity {
+    theme?: 'dark' | 'light' | 'system';
+    language?: string;
+    apiKeys?: Record<string, string>;
+    notifications?: {
+        taskComplete?: boolean;
+    };
+    agentConfig?: Record<string, unknown>;
+    modelProviders?: Array<{
+        id: string;
+        provider: string;
+        model: string;
+        apiKey?: string;
+        baseUrl?: string;
+    }>;
+    defaultModelId?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/cjs/spi/types.d.ts.map

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

package/dist/cjs/spi/types.js

@@ -0,0 +1,6 @@
+"use strict";
+// ============================================================
+// SPI 类型定义 — 支持应用层自定制
+// ============================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/cjs/spi/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/spi/types.ts"],"names":[],"mappings":";AAAA,+DAA+D;AAC/D,sBAAsB;AACtB,+DAA+D"}

package/dist/esm/index.d.ts

@@ -53,4 +53,6 @@ export { getDataPath, getProjectDataPath, ensureDataDir, ensureProjectDataDir, e
 export { getSettings, updateSettings, resetSettings, getSettingsProvider } from './service/settings.service.js';
 export { getThreads, getThread, createThread, getMessages, addMessage, updateMessage, buildThreadHistory, getChatStoreProvider, } from './service/chat.service.js';
 export { listProfiles, getProfile, getDefaultProfile, createProfile, updateProfile, deleteProfile, getAgentProfileProvider, nextId, setIdCounter, getIdCounter, } from './service/agent-profile.service.js';
+export { JsonFileKVStorage, JsonFileListStorage, InMemoryKVStorage, InMemoryListStorage, DatabaseListStorage, createJsonFileStorage, createInMemoryStorage, ExpressSSEAdapter, KoaSSEAdapter, FastifySSEAdapter, NativeHttpSSEAdapter, adaptSSE, ExpressRequestAdapter, KoaRequestAdapter, adaptRequest, CustomSSEAdapter, } from './spi/index.js';
+export type { BaseThreadEntity, BaseMessageEntity, BaseWorkspaceEntity, BaseAgentProfileEntity, BaseSettingsEntity, KVStorageAdapter, ListStorageAdapter, QueryOptions, SettingsProvider as GenericSettingsProvider, ChatStoreProvider as GenericChatStoreProvider, AgentProfileProvider as GenericAgentProfileProvider, PromptBuilderProvider as GenericPromptBuilderProvider, ModelConfigResolver as GenericModelConfigResolver, SSEResponseAdapter, RequestContextAdapter, AgentServerSPIOptions, } from './spi/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

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

package/dist/esm/index.js

@@ -54,4 +54,12 @@ export { getDataPath, getProjectDataPath, ensureDataDir, ensureProjectDataDir, e
 export { getSettings, updateSettings, resetSettings, getSettingsProvider } from "./service/settings.service.js";
 export { getThreads, getThread, createThread, getMessages, addMessage, updateMessage, buildThreadHistory, getChatStoreProvider, } from "./service/chat.service.js";
 export { listProfiles, getProfile, getDefaultProfile, createProfile, updateProfile, deleteProfile, getAgentProfileProvider, nextId, setIdCounter, getIdCounter, } from "./service/agent-profile.service.js";
+// ============================================================
+// SPI 模块 — 应用层可定制存储、框架适配等
+// ============================================================
+export { 
+// ---- 存储适配器 ----
+JsonFileKVStorage, JsonFileListStorage, InMemoryKVStorage, InMemoryListStorage, DatabaseListStorage, createJsonFileStorage, createInMemoryStorage, 
+// ---- 框架适配器 ----
+ExpressSSEAdapter, KoaSSEAdapter, FastifySSEAdapter, NativeHttpSSEAdapter, adaptSSE, ExpressRequestAdapter, KoaRequestAdapter, adaptRequest, CustomSSEAdapter, } from "./spi/index.js";
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

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

package/dist/esm/spi/adapters.d.ts

@@ -0,0 +1,111 @@
+import type { SSEResponseAdapter, RequestContextAdapter } from './types.js';
+/**
+ * Express SSE 适配器
+ */
+export declare class ExpressSSEAdapter implements SSEResponseAdapter {
+    private res;
+    constructor(res: any);
+    write(data: string): void;
+    end(): void;
+    get writableEnded(): boolean;
+    setHeader(name: string, value: string | number): void;
+    flushHeaders(): void;
+    status(code: number): void;
+    json(data: unknown): void;
+}
+/**
+ * Koa/MidwayJS SSE 适配器
+ */
+export declare class KoaSSEAdapter implements SSEResponseAdapter {
+    private ctx;
+    constructor(ctx: any);
+    write(data: string): void;
+    end(): void;
+    get writableEnded(): boolean;
+    setHeader(name: string, value: string | number): void;
+    flushHeaders(): void;
+    status(code: number): void;
+    json(data: unknown): void;
+}
+/**
+ * Fastify SSE 适配器
+ */
+export declare class FastifySSEAdapter implements SSEResponseAdapter {
+    private reply;
+    constructor(reply: any);
+    write(data: string): void;
+    end(): void;
+    get writableEnded(): boolean;
+    setHeader(name: string, value: string | number): void;
+    flushHeaders(): void;
+    status(code: number): void;
+    json(data: unknown): void;
+}
+/**
+ * 原生 HTTP SSE 适配器
+ */
+export declare class NativeHttpSSEAdapter implements SSEResponseAdapter {
+    private res;
+    constructor(res: any);
+    write(data: string): void;
+    end(): void;
+    get writableEnded(): boolean;
+    setHeader(name: string, value: string | number): void;
+    flushHeaders(): void;
+    status(code: number): void;
+    json(data: unknown): void;
+}
+/**
+ * 自动检测框架类型并创建适配器
+ */
+export declare function adaptSSE(res: unknown): SSEResponseAdapter;
+/**
+ * Express 请求上下文适配器
+ */
+export declare class ExpressRequestAdapter implements RequestContextAdapter {
+    private req;
+    constructor(req: any);
+    getUserId(): string | number | undefined;
+    getWorkspaceId(): number | string | undefined;
+    getHeader(name: string): string | undefined;
+    hasPermission(permission: string): boolean;
+    getRawRequest(): unknown;
+    getRawResponse(): unknown;
+}
+/**
+ * Koa/MidwayJS 请求上下文适配器
+ */
+export declare class KoaRequestAdapter implements RequestContextAdapter {
+    private ctx;
+    constructor(ctx: any);
+    getUserId(): string | number | undefined;
+    getWorkspaceId(): number | string | undefined;
+    getHeader(name: string): string | undefined;
+    hasPermission(permission: string): boolean;
+    getRawRequest(): unknown;
+    getRawResponse(): unknown;
+}
+/**
+ * 自动检测框架类型并创建请求适配器
+ */
+export declare function adaptRequest(req: unknown): RequestContextAdapter;
+/**
+ * 自定义 SSE 适配器示例
+ * 应用层可参考此实现创建自己的适配器
+ */
+export declare class CustomSSEAdapter implements SSEResponseAdapter {
+    private onWrite;
+    private onEnd;
+    private onFlush?;
+    private _writableEnded;
+    private headers;
+    constructor(onWrite: (data: string) => void, onEnd: () => void, onFlush?: () => void);
+    write(data: string): void;
+    end(): void;
+    get writableEnded(): boolean;
+    setHeader(name: string, value: string | number): void;
+    flushHeaders(): void;
+    /** 获取已设置的响应头 */
+    getHeaders(): Record<string, string>;
+}
+//# sourceMappingURL=adapters.d.ts.map

package/dist/esm/spi/adapters.d.ts.map

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