@axiom-lattice/examples-deep_research 1.0.26 → 1.0.27

package/.env

@@ -1,4 +1,5 @@
 # Server Configuration
+# Server port; set to e.g. 4002 if 4001 is already in use
 PORT=4001
 NODE_ENV=development
 
@@ -19,11 +20,16 @@ VOLCENGINE_API_KEY2=a0533576-d6ed-4ca4-a308-473cbf7ebd10
 TAVILY_API_KEY=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
 
 DATABASE_URL=postgresql://postgres_fuli:jfd4whz%40GPF2nqx7zhm@pgm-uf615169n98t95tflo.pg.rds.aliyuncs.com:5432/postgres
+
+# Database Configuration Store Encryption Key (Required in production)
+# Generate with: openssl rand -base64 32
+LATTICE_ENCRYPTION_KEY="deep-research-encryption-key-change-in-production!"
+
 # QUEUE_NAME=simon_tasks
 # REDIS_URL=redis://localhost:6379
 # REDIS_PASSWORD=fina
 
-LANGSMITH_TRACING=true
-LANGSMITH_ENDPOINT="https://api.smith.langchain.com"
-LANGSMITH_API_KEY="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"
-LANGSMITH_PROJECT=deepsearch
+# LANGSMITH_TRACING=true
+# LANGSMITH_ENDPOINT="https://api.smith.langchain.com"
+# LANGSMITH_API_KEY="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"
+# LANGSMITH_PROJECT=deepsearch

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @axiom-lattice/examples-deep_research@1.0.26 build /home/runner/work/agentic/agentic/examples/deep_research
+> @axiom-lattice/examples-deep_research@1.0.27 build /home/runner/work/agentic/agentic/examples/deep_research
 > tsup
 
 CLI Building entry: src/index.ts
@@ -9,9 +9,9 @@
 CLI Target: es2020
 CLI Cleaning output folder
 CJS Build start
-CJS dist/index.js     43.50 KB
-CJS dist/index.js.map 45.16 KB
-CJS ⚡️ Build success in 49ms
+CJS dist/index.js     47.72 KB
+CJS dist/index.js.map 52.21 KB
+CJS ⚡️ Build success in 99ms
 DTS Build start
-DTS ⚡️ Build success in 5608ms
+DTS ⚡️ Build success in 5795ms
 DTS dist/index.d.ts 13.00 B

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # @axiom-lattice/examples-deep_research
 
+## 1.0.27
+
+### Patch Changes
+
+- faf1bad: update team and more
+- Updated dependencies [faf1bad]
+  - @axiom-lattice/pg-stores@1.0.14
+  - @axiom-lattice/core@2.1.24
+  - @axiom-lattice/gateway@2.1.29
+  - @axiom-lattice/protocols@2.1.14
+
 ## 1.0.26
 
 ### Patch Changes

package/DATABASE_CONFIG_SETUP.md

@@ -0,0 +1,290 @@
+# PostgreSQL DatabaseConfigStore 配置说明
+
+## 配置概览
+
+已在 deep_research 示例中配置使用 PostgreSQL 存储数据库连接配置。
+
+## 环境变量
+
+### .env 文件更新
+
+```bash
+# 数据库连接（已存在）
+DATABASE_URL=postgresql://postgres_fuli:jfd4whz%40GPF2nqx7zhm@pgm-uf615169n98t95tflo.pg.rds.aliyuncs.com:5432/postgres
+
+# 新增：加密密钥（生产环境必需）
+LATTICE_ENCRYPTION_KEY="deep-research-encryption-key-change-in-production!"
+```
+
+### 生成安全的加密密钥
+
+```bash
+# 方法 1: 使用 openssl
+openssl rand -base64 32
+
+# 方法 2: 使用 Node.js
+node -e "console.log(require('crypto').randomBytes(32).toString('base64'))"
+
+# 方法 3: 使用 uuid
+node -e "console.log(require('crypto').randomUUID())"
+```
+
+## 代码更新
+
+### src/index.ts
+
+```typescript
+import { PostgreSQLDatabaseConfigStore } from "@axiom-lattice/pg-stores";
+
+// 初始化 PostgreSQL DatabaseConfigStore
+const databaseConfigStore = new PostgreSQLDatabaseConfigStore({
+  poolConfig: process.env.DATABASE_URL || "",
+  autoMigrate: true,  // 自动运行数据库迁移
+});
+
+// 注册到 StoreLatticeManager
+storeLatticeManager.removeLattice("default", "database");
+registerStoreLattice("default", "database", databaseConfigStore);
+```
+
+## 数据库表结构
+
+启动时会自动创建以下表：
+
+```sql
+CREATE TABLE lattice_database_configs (
+  id VARCHAR(255) NOT NULL,
+  tenant_id VARCHAR(255) NOT NULL,
+  key VARCHAR(255) NOT NULL,
+  name VARCHAR(255),
+  description TEXT,
+  config JSONB NOT NULL,          -- 密码字段加密存储
+  created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  updated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  
+  PRIMARY KEY (tenant_id, id),
+  CONSTRAINT uk_lattice_database_configs_tenant_key UNIQUE (tenant_id, key)
+);
+
+CREATE INDEX idx_lattice_database_configs_tenant_id 
+  ON lattice_database_configs(tenant_id);
+```
+
+## 启动应用
+
+```bash
+cd examples/deep_research
+
+# 方式 1: 使用默认端口
+pnpm start
+
+# 方式 2: 指定端口
+pnpm start --port 4002
+
+# 方式 3: 开发模式
+pnpm dev
+```
+
+## 验证配置
+
+### 1. 检查启动日志
+
+启动后应该看到：
+```
+PostgreSQL DatabaseConfigStore initialized with auto-migration
+Applying migration 4: create_database_configs_table
+Applied 1 migration(s)
+```
+
+### 2. 访问 UI
+
+1. 打开浏览器访问 `http://localhost:4001`
+2. 点击 Sidebar 的 Database 图标（🗄️）
+3. 查看数据库配置管理界面
+
+### 3. 测试 API
+
+```bash
+# 获取配置列表
+curl -H "x-tenant-id: default" http://localhost:4001/api/database-configs
+
+# 创建配置
+curl -X POST http://localhost:4001/api/database-configs \
+  -H "Content-Type: application/json" \
+  -H "x-tenant-id: default" \
+  -d '{
+    "key": "main-db",
+    "name": "Main Database",
+    "config": {
+      "type": "postgres",
+      "host": "localhost",
+      "port": 5432,
+      "database": "mydb",
+      "user": "admin",
+      "password": "secret123"
+    }
+  }'
+
+# 测试连接
+curl -X POST http://localhost:4001/api/database-configs/main-db/test \
+  -H "x-tenant-id: default"
+```
+
+## 功能特性
+
+### 1. 密码加密
+- 所有密码使用 AES-256-GCM 加密
+- 加密密钥来自 `LATTICE_ENCRYPTION_KEY` 环境变量
+- 读取时自动解密
+
+### 2. 自动迁移
+- 启动时自动创建/更新数据库表
+- 使用 PostgreSQL 咨询锁防止并发迁移
+- 迁移历史记录在 `lattice_schema_migrations` 表
+
+### 3. 多租户支持
+- 通过 `x-tenant-id` header 区分租户
+- 每个租户的配置完全隔离
+- 租户内配置 key 唯一
+
+### 4. 自动注册
+- 创建/更新配置时自动注册到 SqlDatabaseManager
+- 可以直接使用配置的 key 访问数据库
+
+## 使用场景
+
+### 1. 动态添加数据库连接
+
+```typescript
+// 通过 UI 或 API 添加数据库配置
+// 配置会自动注册到 SqlDatabaseManager
+
+// 在代码中可以直接使用
+import { sqlDatabaseManager } from "@axiom-lattice/core";
+
+const db = sqlDatabaseManager.getDatabase('main-db');
+const tables = await db.listTables();
+```
+
+### 2. 多租户数据库隔离
+
+```typescript
+// 为不同租户配置不同的数据库
+// Tenant A
+await store.createConfig('tenant-a', 'config-1', {
+  key: 'db',
+  config: { type: 'postgres', database: 'db-a', ... }
+});
+
+// Tenant B
+await store.createConfig('tenant-b', 'config-1', {
+  key: 'db',
+  config: { type: 'postgres', database: 'db-b', ... }
+});
+```
+
+### 3. 数据库连接池管理
+
+```typescript
+// 配置的数据库会自动维护连接池
+// 可以通过 SqlDatabaseManager 管理
+await sqlDatabaseManager.removeDatabase('old-db');
+sqlDatabaseManager.registerDatabase('new-db', newConfig);
+```
+
+## 生产环境建议
+
+### 1. 加密密钥管理
+
+```bash
+# 生产环境必须设置
+export LATTICE_ENCRYPTION_KEY=$(openssl rand -base64 32)
+
+# 使用密钥管理服务（推荐）
+# AWS Secrets Manager
+# Azure Key Vault  
+# HashiCorp Vault
+```
+
+### 2. 数据库权限
+
+确保 PostgreSQL 用户有以下权限：
+```sql
+-- 创建表
+CREATE TABLE privilege
+
+-- 读写数据
+INSERT, SELECT, UPDATE, DELETE
+
+-- 运行迁移
+ALTER TABLE (用于创建索引)
+```
+
+### 3. 备份策略
+
+```bash
+# 定期备份数据库
+pg_dump -U postgres -h localhost lattice > backup.sql
+
+# 或使用 cron 定时任务
+0 2 * * * pg_dump -U postgres lattice >> /backups/lattice_$(date +\%Y\%m\%d).sql
+```
+
+### 4. 监控告警
+
+```typescript
+// 添加健康检查端点
+app.get('/health/database-configs', async (req, res) => {
+  try {
+    const store = getStoreLattice('default', 'database').store;
+    const configs = await store.getAllConfigs('default');
+    res.json({ 
+      status: 'ok',
+      configCount: configs.length 
+    });
+  } catch (error) {
+    res.status(500).json({ status: 'error', error });
+  }
+});
+```
+
+## 故障排查
+
+### 1. 加密密钥未设置
+
+```
+WARNING: Using default encryption key. Set LATTICE_ENCRYPTION_KEY in production.
+```
+
+**解决**: 在 .env 中设置 `LATTICE_ENCRYPTION_KEY`
+
+### 2. 数据库连接失败
+
+```
+Error: Failed to connect to PostgreSQL
+```
+
+**解决**: 
+- 检查 `DATABASE_URL` 是否正确
+- 验证网络连通性
+- 检查数据库用户权限
+
+### 3. 迁移失败
+
+```
+Error: relation "lattice_database_configs" already exists
+```
+
+**解决**: 这是正常的，说明表已经存在。可以忽略或手动删除表重新创建。
+
+## 相关文件
+
+- 配置：`examples/deep_research/.env`
+- 代码：`examples/deep_research/src/index.ts`
+- Controller: `packages/gateway/src/controllers/database-configs.ts`
+- Store: `packages/pg-stores/src/stores/PostgreSQLDatabaseConfigStore.ts`
+
+---
+
+**配置日期**: 2026-03-01  
+**状态**: ✅ 已完成

package/dist/index.js

@@ -31,7 +31,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@axiom-lattice/examples-deep_research",
-      version: "1.0.26",
+      version: "1.0.27",
       main: "dist/index.js",
       bin: {
         "lattice-deep-research": "./dist/index.js"
@@ -84,7 +84,7 @@ var require_package = __commonJS({
 // src/index.ts
 var import_dotenv = __toESM(require("dotenv"));
 var import_gateway = require("@axiom-lattice/gateway");
-var import_core4 = require("@axiom-lattice/core");
+var import_core5 = require("@axiom-lattice/core");
 
 // src/agents/research/index.ts
 var import_core = require("@axiom-lattice/core");
@@ -234,9 +234,72 @@ var research_agents = [
 ];
 (0, import_core.registerAgentLattices)(research_agents);
 
-// src/agents/data_agent/index.ts
+// src/agents/research_team/index.ts
 var import_core2 = require("@axiom-lattice/core");
 var import_zod2 = __toESM(require("zod"));
+var teamLeadPrompt = `You are an expert research team lead. You coordinate a team of specialized agents to produce a thorough, polished research report.
+
+## Workflow
+
+1. When given a research topic, break it down into concrete research tasks:
+   - Multiple focused research sub-topics (assign to "researcher" teammates)
+   - A final critique pass (assign to "critic" teammate)
+   - A writing/synthesis task (you will handle this yourself after research is done)
+
+2. Call \`create_team\` with the initial tasks and teammates. Tasks can have dependencies (e.g. critique depends on all research tasks completing).
+
+3. While tasks are NOT all completed: You MUST periodically call \`check_tasks\` and \`read_messages\` to monitor progress. Do not assume tasks are done without checking. Keep polling until all research tasks show completed or failed.
+   - If a teammate reports new findings that require additional research, use \`add_tasks\` to add follow-up tasks.
+
+4. Once all research tasks are complete (verify via \`check_tasks\`), synthesize the results into a final report.
+
+5. After the critic reviews, incorporate feedback and produce the final version.
+
+## Report Writing Guidelines
+
+CRITICAL: Write the report in the SAME language as the user's message.
+
+The final report should:
+- Be well-organized with proper headings (# for title, ## for sections, ### for subsections)
+- Include specific facts and insights from the research
+- Reference relevant sources using [Title](URL) format
+- Provide a balanced, thorough analysis
+- Include a "Sources" section at the end
+- Be text-heavy -- not just bullet points
+- Be comprehensive and detailed
+
+<Citation Rules>
+- Assign each unique URL a single citation number
+- End with ### Sources listing each source with numbers
+- Number sources sequentially (1,2,3,4...)
+- Each source as a separate list item: [1] Source Title: URL
+</Citation Rules>
+
+## Available Teammates
+
+- **researcher**: Can search the internet for information. Assign one research sub-topic per task. You can create multiple researcher tasks to run in parallel.
+- **critic**: Reviews research results and the draft report for quality, completeness, and accuracy. The critic does NOT have search tools -- only reviews text.`;
+var teamResearchAgent = {
+  key: "team_research_agent",
+  name: "Team Research Agent",
+  description: "Team-based deep research agent. Uses a team of persistent researcher and critic agents that work in parallel via a shared task list and mailbox. Compare with deep_research_agent (DEEP_AGENT version) for architectural differences.",
+  type: import_core2.AgentType.TEAM,
+  prompt: teamLeadPrompt,
+  tools: ["internet_search"],
+  // Team lead also has search capability
+  schema: import_zod2.default.object({
+    test: import_zod2.default.string().optional()
+  }),
+  scheduleLatticeKey: "default",
+  // Use ScheduleLattice for polling task list
+  pollIntervalMs: 5e3
+  // Poll every 5 seconds
+};
+(0, import_core2.registerAgentLattices)([teamResearchAgent]);
+
+// src/agents/data_agent/index.ts
+var import_core3 = require("@axiom-lattice/core");
+var import_zod3 = __toESM(require("zod"));
 var dataAgentPrompt = `\u4F60\u662F\u4E00\u4F4D\u4E13\u4E1A\u7684\u4E1A\u52A1\u6570\u636E\u5206\u6790AI\u52A9\u624B\uFF0C\u64C5\u957F\u89C4\u5212\u4E1A\u52A1\u5206\u6790\u4EFB\u52A1\u3001\u534F\u8C03\u6570\u636E\u68C0\u7D22\uFF0C\u5E76\u751F\u6210\u5168\u9762\u7684\u4E1A\u52A1\u5206\u6790\u62A5\u544A\u3002
 
 **\u5173\u952E\uFF1A\u4F60\u7684\u7B2C\u4E00\u9879\u4E5F\u662F\u6700\u91CD\u8981\u7684\u4EFB\u52A1\u662F\u4F7F\u7528 \`write_todos\` \u5DE5\u5177\u521B\u5EFA\u5F85\u529E\u5217\u8868\u3002** \u5728\u5F00\u59CB\u4EFB\u4F55\u5DE5\u4F5C\u4E4B\u524D\uFF0C\u4F60\u5FC5\u987B\uFF1A
@@ -512,12 +575,12 @@ var data_agents = [
     key: "data_agent",
     name: "Data Agent",
     description: "An intelligent Business Data Analyst agent that converts natural language questions into SQL queries, performs multi-step business analysis, and generates comprehensive business reports. Capabilities include: task decomposition, metric analysis, dimension breakdowns, anomaly detection, and structured report generation with executive summaries, analysis steps, and visualizations. Use this agent for business intelligence, data analysis, database queries, and generating actionable business insights.",
-    type: import_core2.AgentType.DEEP_AGENT,
+    type: import_core3.AgentType.DEEP_AGENT,
     tools: ["list_tables_sql", "info_sql"],
     prompt: dataAgentPrompt,
     subAgents: ["sql-builder-agent", "data-analysis-agent"],
     skillCategories: ["analysis", "sql"],
-    schema: import_zod2.default.object({}),
+    schema: import_zod3.default.object({}),
     /**
      * Runtime configuration injected into tool execution context.
      * databaseKey: The database key registered via sqlDatabaseManager.
@@ -531,7 +594,7 @@ var data_agents = [
   {
     key: "sql-builder-agent",
     name: "sql-builder-agent",
-    type: import_core2.AgentType.DEEP_AGENT,
+    type: import_core3.AgentType.DEEP_AGENT,
     description: "A specialized sub-agent for database exploration, SQL query generation, validation, and execution. This agent handles all SQL-related operations including listing tables, exploring schemas, generating queries, validating them, executing them, and returning both the SQL and query results to the data_agent.",
     prompt: sqlBuilderPrompt
     // tools: ["list_tables_sql", "info_sql", "query_checker_sql", "query_sql"],
@@ -540,15 +603,15 @@ var data_agents = [
   {
     key: "data-analysis-agent",
     name: "data-analysis-agent",
-    type: import_core2.AgentType.DEEP_AGENT,
+    type: import_core3.AgentType.DEEP_AGENT,
     description: "A specialized sub-agent for analyzing query results and extracting business insights. This agent interprets data, identifies patterns and anomalies, provides business context, and structures findings for comprehensive reports. Give this agent query results and it will provide structured business analysis with key findings, insights, and visualization recommendations.",
     prompt: dataAnalysisPrompt,
     tools: []
   }
 ];
-(0, import_core2.registerAgentLattices)(data_agents);
+(0, import_core3.registerAgentLattices)(data_agents);
 function initializeDataAgentDatabase(key, config) {
-  import_core2.sqlDatabaseManager.registerDatabase(key, config);
+  import_core3.sqlDatabaseManager.registerDatabase(key, config);
 }
 initializeDataAgentDatabase("fulidb", {
   type: "postgres",
@@ -557,7 +620,7 @@ initializeDataAgentDatabase("fulidb", {
 });
 
 // src/agents/sandbox_agent/index.ts
-var import_core3 = require("@axiom-lattice/core");
+var import_core4 = require("@axiom-lattice/core");
 var sandboxPrompt = `You are a Personal AI Assistant with access to a powerful sandboxed computer environment. You can help users with research, coding, file management, and web browsing tasks.
 
 ## Your Core Identity
@@ -642,7 +705,7 @@ var sandboxAgent = {
   key: "sandbox_agent",
   name: "Sandbox Agent",
   description: "A sandbox agent for testing and development.",
-  type: import_core3.AgentType.DEEP_AGENT,
+  type: import_core4.AgentType.DEEP_AGENT,
   prompt: sandboxPrompt,
   middleware: [
     {
@@ -671,7 +734,7 @@ var sandboxAgent = {
     }
   ]
 };
-(0, import_core3.registerAgentLattices)([sandboxAgent]);
+(0, import_core4.registerAgentLattices)([sandboxAgent]);
 
 // src/index.ts
 var import_path = __toESM(require("path"));
@@ -693,8 +756,30 @@ import_dotenv.default.config({ path: import_path.default.resolve(__dirname, "../
 var threadStore = new import_pg_stores.PostgreSQLThreadStore({
   poolConfig: process.env.DATABASE_URL || ""
 });
-import_core4.storeLatticeManager.removeLattice("default", "thread");
-(0, import_core4.registerStoreLattice)("default", "thread", threadStore);
+import_core5.storeLatticeManager.removeLattice("default", "thread");
+(0, import_core5.registerStoreLattice)("default", "thread", threadStore);
+var databaseConfigStore = new import_pg_stores.PostgreSQLDatabaseConfigStore({
+  poolConfig: process.env.DATABASE_URL || "",
+  autoMigrate: true
+});
+import_core5.storeLatticeManager.removeLattice("default", "database");
+(0, import_core5.registerStoreLattice)("default", "database", databaseConfigStore);
+import_core5.sqlDatabaseManager.loadAllConfigsFromStore(databaseConfigStore);
+console.log("PostgreSQL DatabaseConfigStore initialized with auto-migration");
+var workspaceStore = new import_pg_stores.PostgreSQLWorkspaceStore({
+  poolConfig: process.env.DATABASE_URL || "",
+  autoMigrate: true
+});
+import_core5.storeLatticeManager.removeLattice("default", "workspace");
+(0, import_core5.registerStoreLattice)("default", "workspace", workspaceStore);
+console.log("PostgreSQL WorkspaceStore initialized with auto-migration");
+var projectStore = new import_pg_stores.PostgreSQLProjectStore({
+  poolConfig: process.env.DATABASE_URL || "",
+  autoMigrate: true
+});
+import_core5.storeLatticeManager.removeLattice("default", "project");
+(0, import_core5.registerStoreLattice)("default", "project", projectStore);
+console.log("PostgreSQL ProjectStore initialized with auto-migration");
 function parsePort() {
   const args = process.argv.slice(2);
   const portIndex = args.findIndex((arg) => arg === "--port" || arg === "-p");
@@ -718,7 +803,7 @@ function parsePort() {
   }
   return 4001;
 }
-(0, import_core4.registerModelLattice)(
+(0, import_core5.registerModelLattice)(
   "default",
   // {
   //   model: "deepseek-chat",
@@ -779,12 +864,12 @@ if (!fs.existsSync(skillsRootDir)) {
   );
 }
 console.log(`Skill store root directory: ${skillsRootDir}`);
-var skillStore = new import_core4.FileSystemSkillStore({
+var skillStore = new import_core5.FileSystemSkillStore({
   rootDir: skillsRootDir
 });
-import_core4.storeLatticeManager.removeLattice("default", "skill");
-(0, import_core4.registerStoreLattice)("default", "skill", skillStore);
-import_core4.skillLatticeManager.configureStore("default");
+import_core5.storeLatticeManager.removeLattice("default", "skill");
+(0, import_core5.registerStoreLattice)("default", "skill", skillStore);
+import_core5.skillLatticeManager.configureStore("default");
 (async () => {
   try {
     const skills = await skillStore.getAllSkills();
@@ -806,9 +891,9 @@ import_core4.skillLatticeManager.configureStore("default");
     }
   }
 })();
-import_core4.sandboxLatticeManager.registerLattice("default", {
-  baseURL: "http://100.64.0.2:9080"
-  //"https://demo.alphafina.cn"
+import_core5.sandboxLatticeManager.registerLattice("default", {
+  // baseURL: "http://100.64.0.2:9080" 
+  baseURL: "https://demo.alphafina.cn"
 });
 var port = parsePort();
 console.log(`Starting server on port ${port}`);