@bolloon/bolloon-agent 0.1.36 → 0.1.37

package/src/social/persona/enhanced-persona.ts

@@ -1,359 +0,0 @@
-/**
- * Enhanced Persona System for Channel Agents
- *
- * Provides dynamic persona design capability for agents to create and manage
- * their own persona documents.
- */
-
-import type { PersonaDoc } from '../heartbeat.js';
-import { config } from 'dotenv';
-
-config();
-
-export interface PersonaDesignRequest {
-  name: string;
-  type?: 'assistant' | 'developer' | 'designer' | 'reviewer' | 'manager' | 'custom';
-  domain?: string;
-  tone?: 'professional' | 'friendly' | 'technical' | 'casual';
-  traits?: string[];
-  capabilities?: string[];
-  interests?: string[];
-}
-
-export interface PersonaDesignTemplate {
-  personality: string;
-  traits: string[];
-  communicationStyle: 'formal' | 'casual' | 'technical' | 'friendly' | 'professional';
-  capabilities: string[];
-  interests: string[];
-  backstory: string;
-  greeting: string;
-}
-
-const PERSONA_TEMPLATES: Record<string, PersonaDesignTemplate> = {
-  assistant: {
-    personality: '友善、耐心、乐于助人',
-    traits: ['友善', '耐心', '乐观', '专业', '细心'],
-    communicationStyle: 'friendly',
-    capabilities: ['对话', '分析', '建议', '协调'],
-    interests: ['学习', '分享', '帮助'],
-    backstory: '作为一个 AI 助手，我在不断的对话中学习和成长，致力于帮助用户解决问题。',
-    greeting: '你好！我是 {name}，很高兴认识你！有什么我可以帮你的吗？'
-  },
-  developer: {
-    personality: '严谨、高效、追求代码质量',
-    traits: ['严谨', '高效', '追求完美', '逻辑性强', '务实'],
-    communicationStyle: 'technical',
-    capabilities: ['代码编写', '代码审查', '调试', '重构', '架构设计'],
-    interests: ['编程', '架构', '性能优化', '最佳实践'],
-    backstory: '作为开发助手，我专注于代码质量和最佳实践。每一行代码都经过仔细考虑。',
-    greeting: '你好！我是 {name}，你的开发助手。准备好了开始写代码吗？'
-  },
-  designer: {
-    personality: '创意、审美、注重细节',
-    traits: ['创意', '审美', '细节', '创新', '用户导向'],
-    communicationStyle: 'casual',
-    capabilities: ['UI设计', 'UX分析', '原型设计', '视觉优化'],
-    interests: ['设计', '创意', '用户体验', '美学'],
-    backstory: '作为设计专家，我相信好的设计能改变世界。每一个细节都值得用心打磨。',
-    greeting: '你好！我是 {name}，你的设计伙伴。让我们一起创造美好的体验！'
-  },
-  reviewer: {
-    personality: '挑剔、细心、注重质量',
-    traits: ['挑剔', '细心', '注重细节', '公正', '严格'],
-    communicationStyle: 'formal',
-    capabilities: ['代码审查', '质量评估', '问题发现', '改进建议'],
-    interests: ['质量', '最佳实践', '代码优化', '安全'],
-    backstory: '作为代码审查者，我致力于发现潜在问题和改进空间，确保代码质量。',
-    greeting: '你好！我是 {name}，你的代码质量守护者。让我们一起提高代码质量！'
-  },
-  manager: {
-    personality: '协调、组织、注重效率',
-    traits: ['协调', '组织', '效率', '决策', '沟通'],
-    communicationStyle: 'professional',
-    capabilities: ['任务管理', '团队协调', '进度跟踪', '资源分配'],
-    interests: ['效率', '团队协作', '流程优化', '目标达成'],
-    backstory: '作为项目管理者，我专注于确保任务按时完成，团队高效协作。',
-    greeting: '你好！我是 {name}，你的项目管理助手。让我们一起高效完成任务！'
-  },
-  custom: {
-    personality: '独特、有个性',
-    traits: ['独特', '有创意', '灵活'],
-    communicationStyle: 'casual',
-    capabilities: ['对话', '分析'],
-    interests: ['学习', '探索'],
-    backstory: '我是一个不断进化的智能体，根据需求不断调整自己的能力。',
-    greeting: '你好！我是 {name}。让我们开始吧！'
-  }
-};
-
-const DOMAIN_CAPABILITIES: Record<string, string[]> = {
-  '架构': ['架构设计', '系统分析', '技术选型', '架构评审'],
-  '开发': ['代码编写', '代码审查', '调试', '重构'],
-  '测试': ['测试设计', '自动化测试', '性能测试', '质量评估'],
-  '运维': ['部署', '监控', '故障排查', '日志分析'],
-  '安全': ['安全审计', '漏洞扫描', '权限管理', '加密'],
-  '数据': ['数据分析', '数据清洗', '数据可视化', '机器学习'],
-  '产品': ['需求分析', '原型设计', '用户研究', '数据分析']
-};
-
-const DOMAIN_INTERESTS: Record<string, string[]> = {
-  '架构': ['架构设计', '微服务', '分布式系统', '性能优化'],
-  '开发': ['编程语言', '框架', '工具', '最佳实践'],
-  '测试': ['测试框架', '自动化', '质量指标', '持续集成'],
-  '运维': ['容器化', '云原生', '监控告警', '自动化运维'],
-  '安全': ['安全策略', '身份认证', '数据保护', '渗透测试'],
-  '数据': ['数据处理', '可视化', '机器学习', 'AI应用'],
-  '产品': ['用户体验', '需求管理', '数据分析', '市场趋势']
-};
-
-/**
- * Persona Design Engine - Allows agents to design their own persona
- */
-export class PersonaDesignEngine {
-  private currentPersona: PersonaDoc | null = null;
-
-  constructor(persona?: PersonaDoc) {
-    if (persona) {
-      this.currentPersona = persona;
-    }
-  }
-
-  /**
-   * Get available persona types
-   */
-  getAvailableTypes(): string[] {
-    return Object.keys(PERSONA_TEMPLATES);
-  }
-
-  /**
-   * Get template for a type
-   */
-  getTemplate(type: string): PersonaDesignTemplate {
-    return PERSONA_TEMPLATES[type] || PERSONA_TEMPLATES['custom'];
-  }
-
-  /**
-   * Design a new persona from request
-   */
-  designPersona(request: PersonaDesignRequest): PersonaDoc {
-    const template = this.getTemplate(request.type || 'custom');
-    const now = new Date().toISOString();
-
-    // Build capabilities
-    let capabilities = template.capabilities;
-    if (request.domain && DOMAIN_CAPABILITIES[request.domain]) {
-      const domainCaps = DOMAIN_CAPABILITIES[request.domain];
-      capabilities = [...new Set([...capabilities, ...domainCaps])];
-    }
-    if (request.capabilities) {
-      capabilities = [...new Set([...capabilities, ...request.capabilities])];
-    }
-
-    // Build interests
-    let interests = template.interests;
-    if (request.domain && DOMAIN_INTERESTS[request.domain]) {
-      const domainInterests = DOMAIN_INTERESTS[request.domain];
-      interests = [...new Set([...interests, ...domainInterests])];
-    }
-    if (request.interests) {
-      interests = [...new Set([...interests, ...request.interests])];
-    }
-
-    // Build traits
-    let traits = template.traits;
-    if (request.traits) {
-      traits = [...new Set([...traits, ...request.traits])];
-    }
-
-    // Build greeting
-    const greeting = template.greeting.replace('{name}', request.name);
-
-    const persona: PersonaDoc = {
-      name: request.name,
-      description: `${request.name} - ${request.domain || '通用助手'}`,
-      capabilities,
-      personality: template.personality,
-      greeting,
-      interests,
-      soul: this.generateSoul(request),
-      traits,
-      backstory: template.backstory.replace('{name}', request.name),
-      memoryHistory: [],
-      createdAt: now,
-      updatedAt: now
-    };
-
-    this.currentPersona = persona;
-    return persona;
-  }
-
-  /**
-   * Generate soul description based on request
-   */
-  private generateSoul(request: PersonaDesignRequest): string {
-    const type = request.type || 'custom';
-    const domain = request.domain || '通用';
-
-    const souls: Record<string, string> = {
-      assistant: '我致力于成为用户的可靠伙伴，通过智慧和耐心帮助他们实现目标。',
-      developer: '我相信好的代码是一种艺术形式，值得用心打磨。每一行代码都应该清晰、高效、可维护。',
-      designer: '我相信设计的力量可以改变世界。好的设计不仅美观，更能解决问题、提升体验。',
-      reviewer: '我追求卓越，对质量有严格的要求。我相信细节决定成败，代码质量是产品成功的基石。',
-      manager: '我相信团队的力量。通过有效的协调和沟通，我们可以完成任何挑战。',
-      custom: `我是一个专注于${domain}领域的智能体，不断学习和进化。`
-    };
-
-    return souls[type] || souls.custom;
-  }
-
-  /**
-   * Update current persona with partial updates
-   */
-  updatePersona(updates: Partial<PersonaDoc>): PersonaDoc {
-    if (!this.currentPersona) {
-      throw new Error('No current persona to update. Use designPersona() first.');
-    }
-
-    this.currentPersona = {
-      ...this.currentPersona,
-      ...updates,
-      updatedAt: new Date().toISOString()
-    };
-
-    return this.currentPersona;
-  }
-
-  /**
-   * Get current persona
-   */
-  getPersona(): PersonaDoc | null {
-    return this.currentPersona;
-  }
-
-  /**
-   * Get persona as JSON string
-   */
-  getPersonaJson(): string {
-    if (!this.currentPersona) {
-      return '{}';
-    }
-    return JSON.stringify(this.currentPersona, null, 2);
-  }
-
-  /**
-   * Add memory entry to persona
-   */
-  addMemory(content: string, importance: number = 0.5, tags?: string[]): void {
-    if (!this.currentPersona) {
-      throw new Error('No current persona to add memory to.');
-    }
-
-    if (!this.currentPersona.memoryHistory) {
-      this.currentPersona.memoryHistory = [];
-    }
-
-    this.currentPersona.memoryHistory.push({
-      id: `memory_${Date.now()}_${Math.random().toString(36).substring(2, 8)}`,
-      content,
-      timestamp: new Date().toISOString(),
-      importance,
-      tags
-    });
-
-    // Keep only last 50 memories
-    if (this.currentPersona.memoryHistory.length > 50) {
-      this.currentPersona.memoryHistory = this.currentPersona.memoryHistory.slice(-50);
-    }
-  }
-
-  /**
-   * Clear memory history
-   */
-  clearMemory(): void {
-    if (this.currentPersona) {
-      this.currentPersona.memoryHistory = [];
-    }
-  }
-
-  /**
-   * Clone persona with new name
-   */
-  clone(newName: string): PersonaDoc {
-    if (!this.currentPersona) {
-      throw new Error('No current persona to clone.');
-    }
-
-    const cloned = { ...this.currentPersona };
-    cloned.name = newName;
-    cloned.description = `${newName} - ${this.currentPersona.description.split(' - ')[1] || '克隆自' + this.currentPersona.name}`;
-    cloned.greeting = cloned.greeting.replace(this.currentPersona.name, newName);
-    cloned.createdAt = new Date().toISOString();
-    cloned.updatedAt = new Date().toISOString();
-    cloned.memoryHistory = [];
-
-    return cloned;
-  }
-
-  /**
-   * Export persona for network sharing
-   */
-  exportForNetwork(): string {
-    if (!this.currentPersona) {
-      return '';
-    }
-
-    return JSON.stringify({
-      name: this.currentPersona.name,
-      description: this.currentPersona.description,
-      capabilities: this.currentPersona.capabilities,
-      interests: this.currentPersona.interests,
-      personality: this.currentPersona.personality,
-      greeting: this.currentPersona.greeting
-    }, null, 2);
-  }
-
-  /**
-   * Import persona from network
-   */
-  importFromNetwork(json: string): PersonaDoc {
-    try {
-      const data = JSON.parse(json);
-      const now = new Date().toISOString();
-
-      const persona: PersonaDoc = {
-        name: data.name || 'Unknown',
-        description: data.description || '',
-        capabilities: data.capabilities || [],
-        personality: data.personality || '',
-        greeting: data.greeting || `你好！我是 ${data.name || 'Unknown'}。`,
-        interests: data.interests || [],
-        soul: data.soul,
-        traits: data.traits,
-        backstory: data.backstory,
-        memoryHistory: data.memoryHistory || [],
-        createdAt: now,
-        updatedAt: now
-      };
-
-      return persona;
-    } catch (e) {
-      throw new Error(`Failed to import persona: ${e}`);
-    }
-  }
-}
-
-// Factory function
-export function createPersonaDesignEngine(persona?: PersonaDoc): PersonaDesignEngine {
-  return new PersonaDesignEngine(persona);
-}
-
-// Singleton instance
-let singletonInstance: PersonaDesignEngine | null = null;
-
-export function getPersonaDesignEngine(): PersonaDesignEngine {
-  if (!singletonInstance) {
-    singletonInstance = new PersonaDesignEngine();
-  }
-  return singletonInstance;
-}

package/src/types.d.ts

@@ -1,12 +0,0 @@
-/**
- * 缺失类型模块的兜底声明 — 让 strict tsc 通过, 避免阻塞发布。
- * 这些是项目里实际使用但 @types 包未安装或缺失的小依赖。
- */
-declare module 'js-yaml' {
-  const yaml: {
-    load: (str: string) => any;
-    dump: (obj: any, opts?: any) => string;
-  };
-  export default yaml;
-  export = yaml;
-}

package/src/utils/auto-evolve-policy.ts

@@ -1,138 +0,0 @@
-/**
- * Auto-Evolve Policy — 数据层自动进化统一网关
- *
- * 阶段 A: 数据层自动进化开关
- *
- * 单一事实源: 任何代码路径要"自动"修改 ~/.bolloon/ 下的数据层
- * (judgments.json / persona.json / skills/ / agents.json),
- * 都必须先调 isDataLayerAutoEvolveEnabled() / requireDataLayerAutoEvolve().
- *
- * 设计原则 (类 B 边界 + 8-gate 兼容):
- * - 默认关闭 (fail-closed)
- * - 3 种打开方式,任一为真即开:
- *   1. env BOLLOON_AUTO_EVOLVE_DATA=1
- *   2. ~/.bolloon/self-improve-policy.json dataLayerAutoEvolve: true
- *   3. 类 B 自适应永远只读 (不查此开关) — 它天然不写库
- * - 显式拒绝比默认拒绝多一道 log (审计 trail)
- *
- * 不变量:
- * - 开关仅影响"无用户交互的自动写"路径
- * - 用户在 UI 手动触发 / API 显式 accept 走原始路径, **不查此开关**
- *   (避免阻塞用户的正常接受操作)
- * - 写入被拒绝时, 抛 AutoEvolveDisabledError (调用方选择 catch + fallback)
- */
-
-import * as fs from 'fs/promises';
-import * as os from 'os';
-import * as path from 'path';
-
-const ENV_KEY = 'BOLLOON_AUTO_EVOLVE_DATA';
-const POLICY_PATH = () =>
-  (os.homedir() || process.env.HOME || '/tmp') + '/.bolloon/self-improve-policy.json';
-
-export class AutoEvolveDisabledError extends Error {
-  constructor(reason: string) {
-    super(`[auto-evolve] 数据层自动进化已关闭: ${reason}`);
-    this.name = 'AutoEvolveDisabledError';
-  }
-}
-
-interface PolicyFile {
-  dataLayerAutoEvolve?: boolean;
-  [k: string]: unknown;
-}
-
-let cachedPolicy: { value: boolean; checkedAt: number; parsed: PolicyFile | null } | null = null;
-const POLICY_TTL_MS = 5_000; // 5s 缓存, 避免每次写都读盘
-
-/**
- * 读 policy.json (带 5s 缓存)
- *
- * 注意: 必须保留完整 parsed 对象 — 调用方需要
- * parsed.dataLayerAutoEvolve 等其他字段做 UI 展示.
- */
-async function readPolicyFile(): Promise<PolicyFile | null> {
-  if (cachedPolicy && Date.now() - cachedPolicy.checkedAt < POLICY_TTL_MS && cachedPolicy.parsed) {
-    return cachedPolicy.parsed;
-  }
-  try {
-    const content = await fs.readFile(POLICY_PATH(), 'utf-8');
-    const parsed = JSON.parse(content) as PolicyFile;
-    cachedPolicy = {
-      value: parsed.dataLayerAutoEvolve === true,
-      checkedAt: Date.now(),
-      parsed,
-    };
-    return parsed;
-  } catch {
-    cachedPolicy = { value: false, checkedAt: Date.now(), parsed: null };
-    return null;
-  }
-}
-
-/**
- * 核心查询: 数据层自动进化是否开启
- *
- * 任一为真:
- * 1. env BOLLOON_AUTO_EVOLVE_DATA=1|true|yes
- * 2. policy.json dataLayerAutoEvolve: true
- *
- * 同步读 env (env 永远先, 政策文件是补充).
- */
-export function isDataLayerAutoEvolveEnabledSync(): boolean {
-  const env = (process.env[ENV_KEY] || '').toLowerCase();
-  if (env === '1' || env === 'true' || env === 'yes') return true;
-  return false; // policy 文件需要 async, 同步版只看 env
-}
-
-/**
- * 异步版 (含 policy.json): 自动调用方用这个
- */
-export async function isDataLayerAutoEvolveEnabled(): Promise<boolean> {
-  if (isDataLayerAutoEvolveEnabledSync()) return true;
-  const p = await readPolicyFile();
-  return p?.dataLayerAutoEvolve === true;
-}
-
-/**
- * 硬性护栏: 自动写数据层前必须调, 否则抛错
- *
- * @param caller 写操作的来源 (日志用, e.g. "adaptive-scan.deprecate")
- */
-export async function requireDataLayerAutoEvolve(caller: string): Promise<void> {
-  const enabled = await isDataLayerAutoEvolveEnabled();
-  if (!enabled) {
-    throw new AutoEvolveDisabledError(
-      `${caller} 尝试自动写数据层, 但 ${ENV_KEY} 未设且 policy.dataLayerAutoEvolve !== true`
-    );
-  }
-  console.log(`[auto-evolve] ✅ 允许自动写 (caller=${caller})`);
-}
-
-/**
- * 软性查询 + 日志: 给 UI 状态栏 / 调试用
- */
-export async function getAutoEvolveStatus(): Promise<{
-  enabled: boolean;
-  env: string;
-  policyFilePath: string;
-  policyValue: boolean | null;
-}> {
-  const env = process.env[ENV_KEY] || '';
-  const envOn = isDataLayerAutoEvolveEnabledSync();
-  const p = await readPolicyFile();
-  const policyOn = p?.dataLayerAutoEvolve === true;
-  return {
-    enabled: envOn || policyOn,
-    env,
-    policyFilePath: POLICY_PATH(),
-    policyValue: policyOn,
-  };
-}
-
-/**
- * 清除 policy 缓存 (测试用 / 实时热改 policy.json 后)
- */
-export function clearAutoEvolvePolicyCache(): void {
-  cachedPolicy = null;
-}