@zhin.js/agent 0.0.0

package/lib/session.js

@@ -0,0 +1,443 @@
+/**
+ * @zhin.js/ai - Session Manager
+ * 会话管理器，支持上下文记忆和数据库持久化
+ *
+ * 特性：
+ * - 数据库持久化存储（使用 Zhin 的数据库服务）
+ * - 内存缓存加速读取
+ * - 自动过期清理
+ * - 更长的上下文记忆能力
+ */
+import { Logger } from '@zhin.js/logger';
+const logger = new Logger(null, 'AI-Session');
+/**
+ * 数据库模型定义
+ */
+export const AI_SESSION_MODEL = {
+    session_id: { type: 'text', nullable: false },
+    messages: { type: 'json', default: [] },
+    config: { type: 'json', default: {} },
+    created_at: { type: 'integer', default: 0 },
+    updated_at: { type: 'integer', default: 0 },
+};
+/**
+ * 内存会话管理器（回退方案）
+ */
+export class MemorySessionManager {
+    sessions = new Map();
+    config;
+    cleanupTimer;
+    constructor(config = {}) {
+        this.config = {
+            maxHistory: config.maxHistory ?? 100,
+            expireMs: config.expireMs ?? 24 * 60 * 60 * 1000, // 24 小时
+        };
+        // 定期清理过期会话
+        this.cleanupTimer = setInterval(() => this.cleanup(), 5 * 60 * 1000);
+    }
+    get(sessionId, config) {
+        let session = this.sessions.get(sessionId);
+        if (!session) {
+            session = {
+                id: sessionId,
+                config: config || { provider: 'openai' },
+                messages: [],
+                createdAt: Date.now(),
+                updatedAt: Date.now(),
+            };
+            this.sessions.set(sessionId, session);
+        }
+        else {
+            session.updatedAt = Date.now();
+        }
+        return session;
+    }
+    has(sessionId) {
+        return this.sessions.has(sessionId);
+    }
+    addMessage(sessionId, message) {
+        const session = this.get(sessionId);
+        session.messages.push(message);
+        session.updatedAt = Date.now();
+        this.trimMessages(session);
+    }
+    trimMessages(session) {
+        const maxHistory = session.config.maxHistory ?? this.config.maxHistory;
+        if (session.messages.length > maxHistory) {
+            const systemMessages = session.messages.filter((m) => m.role === 'system');
+            const otherMessages = session.messages.filter((m) => m.role !== 'system');
+            const keepCount = maxHistory - systemMessages.length;
+            session.messages = [...systemMessages, ...otherMessages.slice(-keepCount)];
+        }
+    }
+    getMessages(sessionId) {
+        return this.sessions.get(sessionId)?.messages || [];
+    }
+    setSystemPrompt(sessionId, prompt) {
+        const session = this.get(sessionId);
+        session.messages = session.messages.filter((m) => m.role !== 'system');
+        session.messages.unshift({ role: 'system', content: prompt });
+        session.updatedAt = Date.now();
+    }
+    clear(sessionId) {
+        return this.sessions.delete(sessionId);
+    }
+    reset(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (session) {
+            const systemMessages = session.messages.filter((m) => m.role === 'system');
+            session.messages = systemMessages;
+            session.updatedAt = Date.now();
+        }
+    }
+    listSessions() {
+        return Array.from(this.sessions.keys());
+    }
+    getStats() {
+        const now = Date.now();
+        let active = 0;
+        let expired = 0;
+        for (const session of this.sessions.values()) {
+            if (now - session.updatedAt > this.config.expireMs) {
+                expired++;
+            }
+            else {
+                active++;
+            }
+        }
+        return { total: this.sessions.size, active, expired };
+    }
+    cleanup() {
+        const now = Date.now();
+        let cleaned = 0;
+        for (const [id, session] of this.sessions) {
+            const expireMs = session.config.expireMs ?? this.config.expireMs;
+            if (now - session.updatedAt > expireMs) {
+                this.sessions.delete(id);
+                cleaned++;
+            }
+        }
+        return cleaned;
+    }
+    dispose() {
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = undefined;
+        }
+        this.sessions.clear();
+    }
+}
+/**
+ * 数据库会话管理器
+ * 使用 Zhin 的数据库服务进行持久化存储
+ */
+export class DatabaseSessionManager {
+    cache = new Map();
+    config;
+    cleanupTimer;
+    saveQueue = new Map();
+    saveTimer;
+    model; // 数据库模型
+    constructor(model, config = {}) {
+        this.model = model;
+        this.config = {
+            maxHistory: config.maxHistory ?? 200, // 数据库支持更长的历史
+            expireMs: config.expireMs ?? 7 * 24 * 60 * 60 * 1000, // 7 天过期
+        };
+        // 定期清理过期会话（每小时）
+        this.cleanupTimer = setInterval(() => this.cleanup(), 60 * 60 * 1000);
+    }
+    /**
+     * 从数据库加载会话
+     */
+    async loadSession(sessionId) {
+        try {
+            const records = await this.model.select().where({ session_id: sessionId });
+            if (records && records.length > 0) {
+                const record = records[0];
+                // SQLite 中 json 类型存储为 TEXT，读回时需要解析
+                const messages = typeof record.messages === 'string'
+                    ? JSON.parse(record.messages)
+                    : (record.messages || []);
+                const config = typeof record.config === 'string'
+                    ? JSON.parse(record.config)
+                    : (record.config || { provider: 'openai' });
+                return {
+                    id: record.session_id,
+                    config: Array.isArray(config) ? { provider: 'openai' } : config,
+                    messages: Array.isArray(messages) ? messages : [],
+                    createdAt: record.created_at,
+                    updatedAt: record.updated_at,
+                };
+            }
+        }
+        catch (error) {
+            logger.debug('加载会话失败:', error);
+        }
+        return null;
+    }
+    /**
+     * 保存会话到数据库（防抖）
+     */
+    schedulesSave(session) {
+        this.saveQueue.set(session.id, session);
+        if (!this.saveTimer) {
+            this.saveTimer = setTimeout(() => this.flushSaveQueue(), 1000);
+        }
+    }
+    /**
+     * 批量保存队列中的会话
+     */
+    async flushSaveQueue() {
+        this.saveTimer = undefined;
+        const sessions = Array.from(this.saveQueue.values());
+        this.saveQueue.clear();
+        for (const session of sessions) {
+            try {
+                const existing = await this.model.select().where({ session_id: session.id });
+                const record = {
+                    session_id: session.id,
+                    messages: session.messages,
+                    config: session.config,
+                    updated_at: session.updatedAt,
+                };
+                if (existing && existing.length > 0) {
+                    await this.model.update(record).where({ session_id: session.id });
+                }
+                else {
+                    record.created_at = session.createdAt;
+                    await this.model.create(record);
+                }
+            }
+            catch (error) {
+                logger.debug(`保存会话 ${session.id} 失败:`, error);
+            }
+        }
+    }
+    async get(sessionId, config) {
+        // 先检查缓存
+        let session = this.cache.get(sessionId);
+        if (!session) {
+            // 从数据库加载
+            session = await this.loadSession(sessionId) ?? undefined;
+            if (!session) {
+                // 创建新会话
+                session = {
+                    id: sessionId,
+                    config: config || { provider: 'openai' },
+                    messages: [],
+                    createdAt: Date.now(),
+                    updatedAt: Date.now(),
+                };
+            }
+            this.cache.set(sessionId, session);
+        }
+        session.updatedAt = Date.now();
+        this.schedulesSave(session);
+        return session;
+    }
+    async has(sessionId) {
+        if (this.cache.has(sessionId)) {
+            return true;
+        }
+        try {
+            const records = await this.model.select().where({ session_id: sessionId });
+            return records && records.length > 0;
+        }
+        catch {
+            return false;
+        }
+    }
+    async addMessage(sessionId, message) {
+        const session = await this.get(sessionId);
+        session.messages.push(message);
+        session.updatedAt = Date.now();
+        this.trimMessages(session);
+        this.schedulesSave(session);
+    }
+    trimMessages(session) {
+        const maxHistory = session.config.maxHistory ?? this.config.maxHistory;
+        if (session.messages.length > maxHistory) {
+            const systemMessages = session.messages.filter((m) => m.role === 'system');
+            const otherMessages = session.messages.filter((m) => m.role !== 'system');
+            const keepCount = maxHistory - systemMessages.length;
+            session.messages = [...systemMessages, ...otherMessages.slice(-keepCount)];
+        }
+    }
+    async getMessages(sessionId) {
+        const session = await this.get(sessionId);
+        return session.messages;
+    }
+    async setSystemPrompt(sessionId, prompt) {
+        const session = await this.get(sessionId);
+        session.messages = session.messages.filter((m) => m.role !== 'system');
+        session.messages.unshift({ role: 'system', content: prompt });
+        session.updatedAt = Date.now();
+        this.schedulesSave(session);
+    }
+    async clear(sessionId) {
+        this.cache.delete(sessionId);
+        this.saveQueue.delete(sessionId);
+        try {
+            await this.model.delete({ session_id: sessionId });
+            return true;
+        }
+        catch (error) {
+            logger.debug(`删除会话 ${sessionId} 失败:`, error);
+            return false;
+        }
+    }
+    async reset(sessionId) {
+        const session = await this.get(sessionId);
+        const systemMessages = session.messages.filter((m) => m.role === 'system');
+        session.messages = systemMessages;
+        session.updatedAt = Date.now();
+        this.schedulesSave(session);
+    }
+    async listSessions() {
+        try {
+            const records = await this.model.select();
+            return records.map(r => r.session_id);
+        }
+        catch (error) {
+            logger.debug('列出会话失败:', error);
+            return Array.from(this.cache.keys());
+        }
+    }
+    async getStats() {
+        const now = Date.now();
+        let total = 0;
+        let active = 0;
+        let expired = 0;
+        try {
+            const records = await this.model.select();
+            total = records.length;
+            for (const record of records) {
+                const expireMs = record.config?.expireMs ?? this.config.expireMs;
+                if (now - record.updated_at > expireMs) {
+                    expired++;
+                }
+                else {
+                    active++;
+                }
+            }
+        }
+        catch (error) {
+            logger.debug('获取统计失败:', error);
+            // 回退到缓存统计
+            total = this.cache.size;
+            for (const session of this.cache.values()) {
+                if (now - session.updatedAt > this.config.expireMs) {
+                    expired++;
+                }
+                else {
+                    active++;
+                }
+            }
+        }
+        return { total, active, expired };
+    }
+    async cleanup() {
+        const now = Date.now();
+        let cleaned = 0;
+        try {
+            const records = await this.model.select();
+            for (const record of records) {
+                const expireMs = record.config?.expireMs ?? this.config.expireMs;
+                if (now - record.updated_at > expireMs) {
+                    await this.model.delete({ session_id: record.session_id });
+                    this.cache.delete(record.session_id);
+                    cleaned++;
+                }
+            }
+        }
+        catch (error) {
+            logger.debug('清理会话失败:', error);
+        }
+        return cleaned;
+    }
+    async dispose() {
+        // 保存所有待保存的会话
+        if (this.saveTimer) {
+            clearTimeout(this.saveTimer);
+            this.saveTimer = undefined;
+        }
+        await this.flushSaveQueue();
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = undefined;
+        }
+        this.cache.clear();
+    }
+}
+/**
+ * 会话管理器包装器
+ * 支持同步和异步接口的统一使用
+ */
+export class SessionManager {
+    manager;
+    constructor(manager) {
+        this.manager = manager;
+    }
+    /**
+     * 生成会话 ID
+     */
+    static generateId(platform, userId, channelId) {
+        return channelId
+            ? `${platform}:${channelId}:${userId}`
+            : `${platform}:${userId}`;
+    }
+    get(sessionId, config) {
+        return this.manager.get(sessionId, config);
+    }
+    has(sessionId) {
+        return this.manager.has(sessionId);
+    }
+    addMessage(sessionId, message) {
+        return this.manager.addMessage(sessionId, message);
+    }
+    getMessages(sessionId) {
+        return this.manager.getMessages(sessionId);
+    }
+    setSystemPrompt(sessionId, prompt) {
+        return this.manager.setSystemPrompt(sessionId, prompt);
+    }
+    clear(sessionId) {
+        return this.manager.clear(sessionId);
+    }
+    reset(sessionId) {
+        return this.manager.reset(sessionId);
+    }
+    listSessions() {
+        return this.manager.listSessions();
+    }
+    getStats() {
+        return this.manager.getStats();
+    }
+    cleanup() {
+        return this.manager.cleanup();
+    }
+    dispose() {
+        return this.manager.dispose();
+    }
+}
+/**
+ * 创建内存会话管理器（回退方案）
+ */
+export function createMemorySessionManager(config) {
+    return new SessionManager(new MemorySessionManager(config));
+}
+/**
+ * 创建数据库会话管理器
+ */
+export function createDatabaseSessionManager(model, config) {
+    return new SessionManager(new DatabaseSessionManager(model, config));
+}
+/**
+ * 创建会话管理器（向后兼容）
+ * @deprecated 使用 createMemorySessionManager 或 createDatabaseSessionManager
+ */
+export function createSessionManager(config) {
+    return createMemorySessionManager(config);
+}
+//# sourceMappingURL=session.js.map

package/lib/session.js.map

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

package/lib/subagent.d.ts

@@ -0,0 +1,50 @@
+/**
+ * SubagentManager — 后台子任务执行管理器
+ *
+ * 职责：
+ *   1. 接收主 agent 发起的 spawn 请求，创建后台子 agent
+ *   2. 为子 agent 配备受限工具集（文件/Shell/网络，不含消息/spawn/技能）
+ *   3. 管理子 agent 生命周期（运行跟踪、完成/失败回告）
+ *   4. 完成后将结果投递回主流程，由主 agent 摘要后发送到原始频道
+ */
+import type { AIProvider, AgentTool } from '@zhin.js/core';
+import type { ZhinAgentConfig } from './zhin-agent/config.js';
+export interface SubagentOrigin {
+    platform: string;
+    botId: string;
+    sceneId: string;
+    senderId: string;
+    sceneType: string;
+}
+export interface SpawnOptions {
+    task: string;
+    label?: string;
+    origin: SubagentOrigin;
+}
+export type SubagentResultSender = (origin: SubagentOrigin, content: string) => Promise<void>;
+export interface SubagentManagerOptions {
+    provider: AIProvider;
+    workspace: string;
+    createTools: () => AgentTool[];
+    maxIterations?: number;
+    /** Exec policy config to enforce on subagent bash tools */
+    execPolicyConfig?: Required<ZhinAgentConfig>;
+}
+export declare class SubagentManager {
+    private provider;
+    private workspace;
+    private createTools;
+    private maxIterations;
+    private execPolicyConfig;
+    private runningTasks;
+    private resultSender;
+    constructor(options: SubagentManagerOptions);
+    setSender(sender: SubagentResultSender): void;
+    spawn(options: SpawnOptions): Promise<string>;
+    getRunningCount(): number;
+    private runSubagent;
+    private announceResult;
+    private buildSubagentPrompt;
+    dispose(): void;
+}
+//# sourceMappingURL=subagent.d.ts.map

package/lib/subagent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent.d.ts","sourceRoot":"","sources":["../src/subagent.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAS9D,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,MAAM,MAAM,oBAAoB,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAE9F,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,UAAU,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,SAAS,EAAE,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2DAA2D;IAC3D,gBAAgB,CAAC,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC;CAC9C;AAsBD,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAoB;IACvC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,gBAAgB,CAAmC;IAC3D,OAAO,CAAC,YAAY,CAA2C;IAC/D,OAAO,CAAC,YAAY,CAAqC;gBAE7C,OAAO,EAAE,sBAAsB;IAQ3C,SAAS,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI;IAIvC,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAqBnD,eAAe,IAAI,MAAM;YAMX,WAAW;YAkCX,cAAc;IAwB5B,OAAO,CAAC,mBAAmB;IA+B3B,OAAO,IAAI,IAAI;CAGhB"}

package/lib/subagent.js

@@ -0,0 +1,144 @@
+/**
+ * SubagentManager — 后台子任务执行管理器
+ *
+ * 职责：
+ *   1. 接收主 agent 发起的 spawn 请求，创建后台子 agent
+ *   2. 为子 agent 配备受限工具集（文件/Shell/网络，不含消息/spawn/技能）
+ *   3. 管理子 agent 生命周期（运行跟踪、完成/失败回告）
+ *   4. 完成后将结果投递回主流程，由主 agent 摘要后发送到原始频道
+ */
+import { randomUUID } from 'crypto';
+import { Logger } from '@zhin.js/logger';
+import { createAgent } from './agent.js';
+import { applyExecPolicyToTools } from './zhin-agent/exec-policy.js';
+const logger = new Logger(null, 'Subagent');
+// ============================================================================
+// 子 agent 允许使用的工具名单
+// ============================================================================
+const SUBAGENT_ALLOWED_TOOLS = new Set([
+    'read_file',
+    'write_file',
+    'edit_file',
+    'list_dir',
+    'glob',
+    'grep',
+    'bash',
+    'web_search',
+    'web_fetch',
+]);
+// ============================================================================
+// SubagentManager
+// ============================================================================
+export class SubagentManager {
+    provider;
+    workspace;
+    createTools;
+    maxIterations;
+    execPolicyConfig;
+    runningTasks = new Map();
+    resultSender = null;
+    constructor(options) {
+        this.provider = options.provider;
+        this.workspace = options.workspace;
+        this.createTools = options.createTools;
+        this.maxIterations = options.maxIterations ?? 15;
+        this.execPolicyConfig = options.execPolicyConfig ?? null;
+    }
+    setSender(sender) {
+        this.resultSender = sender;
+    }
+    async spawn(options) {
+        const taskId = randomUUID().slice(0, 8);
+        const displayLabel = options.label ||
+            options.task.slice(0, 30) + (options.task.length > 30 ? '...' : '');
+        const abortController = new AbortController();
+        this.runningTasks.set(taskId, abortController);
+        this.runSubagent(taskId, options.task, displayLabel, options.origin)
+            .catch((error) => {
+            logger.error({ error, taskId }, 'Subagent failed');
+        })
+            .finally(() => {
+            this.runningTasks.delete(taskId);
+        });
+        logger.info({ taskId, label: displayLabel }, 'Spawned subagent');
+        return `子任务 [${displayLabel}] 已启动 (id: ${taskId})，完成后会自动通知你。`;
+    }
+    getRunningCount() {
+        return this.runningTasks.size;
+    }
+    // ── 内部方法 ──────────────────────────────────────────────────────
+    async runSubagent(taskId, task, label, origin) {
+        logger.info({ taskId, label }, 'Subagent starting task');
+        try {
+            const allTools = this.createTools();
+            let tools = allTools.filter(t => SUBAGENT_ALLOWED_TOOLS.has(t.name));
+            if (this.execPolicyConfig) {
+                tools = applyExecPolicyToTools(this.execPolicyConfig, tools);
+            }
+            const systemPrompt = this.buildSubagentPrompt(task);
+            const agent = createAgent(this.provider, {
+                systemPrompt,
+                tools,
+                maxIterations: this.maxIterations,
+            });
+            const result = await agent.run(task);
+            const finalResult = result.content || '任务已完成，但未生成最终响应。';
+            logger.info({ taskId }, 'Subagent completed successfully');
+            await this.announceResult(taskId, label, task, finalResult, origin, 'ok');
+        }
+        catch (error) {
+            const errorMsg = `Error: ${error}`;
+            logger.error({ taskId, error }, 'Subagent failed');
+            await this.announceResult(taskId, label, task, errorMsg, origin, 'error');
+        }
+    }
+    async announceResult(taskId, label, task, result, origin, status) {
+        if (!this.resultSender) {
+            logger.warn({ taskId }, 'No result sender configured, discarding subagent result');
+            return;
+        }
+        const statusText = status === 'ok' ? '已完成' : '执行失败';
+        const announceContent = `[后台任务 '${label}' ${statusText}]\n\n任务: ${task}\n\n结果:\n${result}`;
+        try {
+            await this.resultSender(origin, announceContent);
+            logger.debug({ taskId, origin }, 'Subagent announced result');
+        }
+        catch (e) {
+            logger.error({ taskId, error: e }, 'Failed to announce subagent result');
+        }
+    }
+    buildSubagentPrompt(task) {
+        return `# 子任务 Agent
+
+你是一个被主 agent 派生出来执行特定任务的子 agent。
+
+## 你的任务
+${task}
+
+## 规则
+1. 专注完成分配的任务，不做其他事情
+2. 你的最终回复会被报告给主 agent，并转达给用户
+3. 不要发起对话或承担额外任务
+4. 回复要简洁但信息充分
+
+## 你可以做的
+- 读写工作区内的文件
+- 执行 Shell 命令
+- 搜索和抓取网页
+- 彻底完成任务
+
+## 你不能做的
+- 直接向用户发送消息
+- 派生其他子任务
+- 访问主 agent 的对话历史
+
+## 工作区
+你的工作区路径: ${this.workspace}
+
+完成任务后，请提供清晰的发现或操作摘要。`;
+    }
+    dispose() {
+        this.runningTasks.clear();
+    }
+}
+//# sourceMappingURL=subagent.js.map

package/lib/subagent.js.map

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