@agents-uni/core 0.1.1 → 0.1.2

package/README.en.md

@@ -21,6 +21,7 @@
   <a href="#openclaw-bridge">OpenClaw Bridge</a> &bull;
   <a href="#dashboard">Dashboard</a> &bull;
   <a href="#multi-uni-management">Multi-Uni</a> &bull;
+  <a href="#agency-agents-bridge">Agency-Agents</a> &bull;
   <a href="./DESIGN.md">Design Doc</a>
 </p>
 
@@ -247,20 +248,30 @@ uni deploy universe.yaml --dir ./workspaces --lang zh
 # Interactive project initialization
 uni init
 
-# 🆕 Start the Dashboard web UI
+# Start the Dashboard web UI
 uni dashboard [--port 8089]
 
-# 🆕 List all registered universes
+# List all registered universes
 uni list
 
-# 🆕 Overview of deployed unis and agents
+# Overview of deployed unis and agents
 uni status
 
-# 🆕 Remove a universe and all its files
+# Remove a universe and all its files
 uni cleanup <id>
 
-# 🆕 Reset runtime data, keep configuration
+# Reset runtime data, keep configuration
 uni reset <id>
+
+# 🆕 Agency-agents bridge
+uni agency init                           # Download agency-agents repo
+uni agency list                           # List available categories
+uni agency update                         # Pull latest updates
+uni agency import engineering design      # Import by category
+uni agency import all --name full-team    # Import all agents
+
+# Import from raw directory paths (advanced)
+uni import ./path/to/agents/ --name my-team
 ```
 
 | Command | Description |
@@ -275,6 +286,11 @@ uni reset <id>
 | `uni status` | Overview of deployed unis and agents |
 | `uni cleanup <id>` | Remove a universe and all its files |
 | `uni reset <id>` | Reset runtime data, keep SOUL.md config |
+| `uni agency init` | Download agency-agents repo locally |
+| `uni agency list` | List available categories and agent counts |
+| `uni agency update` | Pull latest agency-agents updates |
+| `uni agency import` | Import agents by category name to universe.yaml |
+| `uni import` | Import from raw directory paths (advanced) |
 
 ## OpenClaw Bridge
 
@@ -456,6 +472,115 @@ import {
 | Update | `updateUni()` | Re-deploy SOUL.md, handle added/removed agents |
 | Cleanup | `uni cleanup <id>` | Delete workspace + agent dirs + remove from openclaw.json + registry |
 
+## Agency-Agents Bridge
+
+agents-uni-core has built-in bridge support for [agency-agents](https://github.com/msitarzewski/agency-agents), a high-quality agent persona library with 140+ agents covering 14 domains (engineering, design, marketing, sales, product, testing, etc.).
+
+With the bridge, you can **import these agents into agents-uni with one command**, auto-convert them to `universe.yaml`, and deploy to OpenClaw.
+
+### Initialize
+
+```bash
+# Download agency-agents to ~/.agents-uni/agency-agents/ (one-time)
+uni agency init
+
+# List available categories
+uni agency list
+
+# Pull latest updates
+uni agency update
+```
+
+### Import by Category
+
+```bash
+# Import the engineering team (23 agents)
+uni agency import engineering
+
+# Import multiple categories
+uni agency import engineering design marketing
+
+# Import all 140+ agents
+uni agency import all --name full-team --type hybrid
+
+# Import and deploy SOUL.md to OpenClaw
+uni agency import engineering --name my-eng --deploy --deploy-dir ~/.openclaw
+```
+
+### Programmatic Usage
+
+```typescript
+import {
+  agencyInit,
+  agencyUpdate,
+  agencyListCategories,
+  resolveAgencyCategories,
+  importAgencyAgents,
+  toSoulMd,
+} from '@agents-uni/core';
+
+// 1. Initialize (first time only)
+agencyInit();
+
+// 2. List categories
+const categories = agencyListCategories();
+// [{ name: 'engineering', agentCount: 23, path: '...' }, ...]
+
+// 3. Import by category
+const dirs = resolveAgencyCategories(['engineering', 'design']);
+const result = importAgencyAgents(dirs, {
+  name: 'my-team',
+  type: 'competitive',
+  relationships: 'peer',
+});
+
+// result.config → UniverseConfig (ready to deploy)
+// result.agents → parsed agent data (with original personality)
+console.log(`Imported ${result.agents.length} agents`);
+
+// 4. Generate SOUL.md preserving original personality
+for (const agent of result.agents) {
+  const soul = toSoulMd(agent, { universe: result.config, language: 'en' });
+  // soul contains agency-agents original personality + agents-uni org context
+}
+
+// 5. Periodic updates
+const updateResult = agencyUpdate();
+if (updateResult.updated) {
+  console.log(`Updated: ${updateResult.oldCommit} → ${updateResult.newCommit}`);
+}
+```
+
+### Data Storage
+
+```
+~/.agents-uni/
+├── agency-agents/          ← agency-agents repo (git clone)
+│   ├── engineering/        ← 23 engineering agents
+│   ├── design/             ← 8 design agents
+│   ├── marketing/          ← 27 marketing agents
+│   └── ...                 ← 14 categories total
+└── agency-meta.json        ← install and update metadata
+```
+
+### Available Categories
+
+| Category | Agents | Includes |
+|----------|--------|----------|
+| engineering | 23 | Backend Architect, Frontend Developer, DevOps, SRE, Security Engineer... |
+| marketing | 27 | SEO Specialist, TikTok/Douyin Strategist, Growth Hacker, Content Creator... |
+| specialized | 27 | Blockchain Auditor, Compliance Auditor, MCP Builder, Salesforce Architect... |
+| design | 8 | UI Designer, UX Architect, Brand Guardian, Visual Storyteller... |
+| sales | 8 | Deal Strategist, Outbound Strategist, Pipeline Analyst, Sales Coach... |
+| testing | 8 | API Tester, Performance Benchmarker, Accessibility Auditor... |
+| paid-media | 7 | PPC Strategist, Paid Social, Programmatic Buyer, Ad Creative... |
+| support | 6 | Analytics Reporter, Finance Tracker, Legal Compliance... |
+| spatial-computing | 6 | visionOS Engineer, XR Developer, Terminal Integration... |
+| project-management | 6 | Jira Steward, Project Shepherd, Studio Producer... |
+| academic | 5 | Anthropologist, Historian, Psychologist, Narratologist... |
+| product | 5 | Product Manager, Sprint Prioritizer, Feedback Synthesizer... |
+| game-development | 5 | Game Designer, Level Designer, Narrative Designer, Audio Engineer... |
+
 ## Architecture
 
 ```
@@ -547,6 +672,14 @@ import {
   TaskDispatcher,      // Dispatch TASK.md → collect SUBMISSION.md
   FileWorkspaceIO,     // File-system I/O backend
   MemoryWorkspaceIO,   // In-memory I/O backend (for testing)
+
+  // 🆕 Agency-agents bridge
+  agencyInit,              // Download agency-agents repo
+  agencyUpdate,            // Pull latest updates
+  agencyListCategories,    // List available categories
+  resolveAgencyCategories, // Category names → directory paths
+  importAgencyAgents,      // Batch import and generate UniverseConfig
+  toSoulMd,                // Generate SOUL.md preserving original personality
 } from '@agents-uni/core';
 ```
 
@@ -571,11 +704,11 @@ agents-uni-core/
     core/           # Runtime engine (Universe, Registry, Graph, StateMachine, ...)
     evolution/      # Self-optimization (Performance, Promotion, Memory, ...)
     spec/           # YAML parsing, validation, compilation
-    bridge/         # OpenClaw bridge (SOUL.md, task dispatch, workspace I/O, uni registry)
+    bridge/         # OpenClaw bridge (SOUL.md, task dispatch, workspace I/O, uni registry, agency-agents bridge)
     dashboard/      # 🆕 Dashboard (Hono server, HTML templates, API routes, extension system)
     schema/         # JSON Schema for spec validation
     templates/      # 5 built-in organizational templates
-    cli/            # Command-line interface (10 commands)
+    cli/            # Command-line interface (15 commands)
   create-uni/       # npx create-uni scaffolding tool
   tests/            # Unit tests (41 tests, 7 suites)
 ```

package/README.md

@@ -21,6 +21,7 @@
   <a href="#openclaw-桥接">OpenClaw</a> &bull;
   <a href="#dashboard-仪表盘">Dashboard</a> &bull;
   <a href="#多-uni-管理">多 Uni 管理</a> &bull;
+  <a href="#agency-agents-桥接">Agency-Agents</a> &bull;
   <a href="./DESIGN.md">设计文档</a>
 </p>
 
@@ -247,20 +248,30 @@ uni deploy universe.yaml --dir ./workspaces --lang zh
 # 交互式初始化项目
 uni init
 
-# 🆕 启动 Dashboard 仪表盘
+# 启动 Dashboard 仪表盘
 uni dashboard [--port 8089]
 
-# 🆕 列出所有已注册的 Universe
+# 列出所有已注册的 Universe
 uni list
 
-# 🆕 查看已部署的 Uni / Agent 概览
+# 查看已部署的 Uni / Agent 概览
 uni status
 
-# 🆕 清理一个 Universe（删除所有相关文件 + 注册信息）
+# 清理一个 Universe（删除所有相关文件 + 注册信息）
 uni cleanup <id>
 
-# 🆕 重置一个 Universe（清除运行时数据，保留配置）
+# 重置一个 Universe（清除运行时数据，保留配置）
 uni reset <id>
+
+# 🆕 agency-agents 桥接
+uni agency init                           # 下载 agency-agents 仓库
+uni agency list                           # 查看可用分类
+uni agency update                         # 拉取最新
+uni agency import engineering design      # 按分类导入
+uni agency import all --name full-team    # 导入全部
+
+# 从原始目录导入（高级用法）
+uni import ./path/to/agents/ --name my-team
 ```
 
 | 命令 | 说明 |
@@ -275,6 +286,11 @@ uni reset <id>
 | `uni status` | 查看已部署的 Uni / Agent 概览 |
 | `uni cleanup <id>` | 清理一个 Universe 及其所有文件 |
 | `uni reset <id>` | 重置运行时数据，保留 SOUL.md 等配置 |
+| `uni agency init` | 下载 agency-agents 仓库到本地 |
+| `uni agency list` | 查看可用分类和 Agent 数量 |
+| `uni agency update` | 拉取 agency-agents 最新更新 |
+| `uni agency import` | 按分类名导入 Agent 到 universe.yaml |
+| `uni import` | 从原始目录路径导入 Agent（高级用法） |
 
 ## OpenClaw 桥接
 
@@ -456,6 +472,115 @@ import {
 | 更新 | `updateUni()` | 重新部署 SOUL.md，处理新增/移除的 Agent |
 | 清理 | `uni cleanup <id>` | 删除工作区目录 + Agent 目录 + 从 openclaw.json 移除 + 从注册中心移除 |
 
+## Agency-Agents 桥接
+
+agents-uni-core 内置了对 [agency-agents](https://github.com/msitarzewski/agency-agents) 项目的桥接支持。agency-agents 是一个高质量的 Agent 人格模板库（140+ 个 Agent），覆盖工程、设计、营销、销售、产品、测试等 14 个领域。
+
+通过桥接，你可以**一键将这些 Agent 导入 agents-uni**，自动转换为 `universe.yaml` 并部署到 OpenClaw。
+
+### 初始化
+
+```bash
+# 下载 agency-agents 到 ~/.agents-uni/agency-agents/（仅需一次）
+uni agency init
+
+# 查看可用分类
+uni agency list
+
+# 拉取最新更新
+uni agency update
+```
+
+### 按分类导入
+
+```bash
+# 导入工程团队（23 个 Agent）
+uni agency import engineering
+
+# 同时导入多个分类
+uni agency import engineering design marketing
+
+# 导入全部 140+ 个 Agent
+uni agency import all --name full-team --type hybrid
+
+# 导入并直接部署 SOUL.md 到 OpenClaw
+uni agency import engineering --name my-eng --deploy --deploy-dir ~/.openclaw
+```
+
+### 编程式调用
+
+```typescript
+import {
+  agencyInit,
+  agencyUpdate,
+  agencyListCategories,
+  resolveAgencyCategories,
+  importAgencyAgents,
+  toSoulMd,
+} from '@agents-uni/core';
+
+// 1. 初始化（首次）
+agencyInit();
+
+// 2. 列出分类
+const categories = agencyListCategories();
+// [{ name: 'engineering', agentCount: 23, path: '...' }, ...]
+
+// 3. 按分类导入
+const dirs = resolveAgencyCategories(['engineering', 'design']);
+const result = importAgencyAgents(dirs, {
+  name: 'my-team',
+  type: 'competitive',
+  relationships: 'peer',
+});
+
+// result.config → UniverseConfig (可直接部署)
+// result.agents → 解析后的 Agent 数据 (含原始人格)
+console.log(`导入了 ${result.agents.length} 个 Agent`);
+
+// 4. 生成保留原始人格的 SOUL.md
+for (const agent of result.agents) {
+  const soul = toSoulMd(agent, { universe: result.config, language: 'zh' });
+  // soul 包含 agency-agents 原始人格 + agents-uni 组织上下文
+}
+
+// 5. 定期更新
+const updateResult = agencyUpdate();
+if (updateResult.updated) {
+  console.log(`更新: ${updateResult.oldCommit} → ${updateResult.newCommit}`);
+}
+```
+
+### 数据存储
+
+```
+~/.agents-uni/
+├── agency-agents/          ← agency-agents 仓库（git clone）
+│   ├── engineering/        ← 23 个工程 Agent
+│   ├── design/             ← 8 个设计 Agent
+│   ├── marketing/          ← 27 个营销 Agent
+│   └── ...                 ← 共 14 个分类
+└── agency-meta.json        ← 安装和更新元数据
+```
+
+### 可用分类
+
+| 分类 | Agent 数 | 包含 |
+|------|---------|------|
+| engineering | 23 | Backend Architect, Frontend Developer, DevOps, SRE, Security Engineer... |
+| marketing | 27 | SEO Specialist, TikTok/Douyin Strategist, Growth Hacker, Content Creator... |
+| specialized | 27 | Blockchain Auditor, Compliance Auditor, MCP Builder, Salesforce Architect... |
+| design | 8 | UI Designer, UX Architect, Brand Guardian, Visual Storyteller... |
+| sales | 8 | Deal Strategist, Outbound Strategist, Pipeline Analyst, Sales Coach... |
+| testing | 8 | API Tester, Performance Benchmarker, Accessibility Auditor... |
+| paid-media | 7 | PPC Strategist, Paid Social, Programmatic Buyer, Ad Creative... |
+| support | 6 | Analytics Reporter, Finance Tracker, Legal Compliance... |
+| spatial-computing | 6 | visionOS Engineer, XR Developer, Terminal Integration... |
+| project-management | 6 | Jira Steward, Project Shepherd, Studio Producer... |
+| academic | 5 | Anthropologist, Historian, Psychologist, Narratologist... |
+| product | 5 | Product Manager, Sprint Prioritizer, Feedback Synthesizer... |
+| game-development | 5 | Game Designer, Level Designer, Narrative Designer, Audio Engineer... |
+
 ## 架构
 
 ```
@@ -547,6 +672,14 @@ import {
   TaskDispatcher,      // 下发 TASK.md → 收集 SUBMISSION.md
   FileWorkspaceIO,     // 文件系统 I/O 后端
   MemoryWorkspaceIO,   // 内存 I/O 后端（用于测试）
+
+  // 🆕 Agency-agents 桥接
+  agencyInit,              // 下载 agency-agents 仓库
+  agencyUpdate,            // 拉取最新更新
+  agencyListCategories,    // 列出可用分类
+  resolveAgencyCategories, // 分类名 → 目录路径
+  importAgencyAgents,      // 批量导入并生成 UniverseConfig
+  toSoulMd,                // 生成保留原始人格的 SOUL.md
 } from '@agents-uni/core';
 ```
 
@@ -571,11 +704,11 @@ agents-uni-core/
     core/           # 运行时引擎（Universe, Registry, Graph, StateMachine, ...）
     evolution/      # 自优化（Performance, Promotion, Memory, ...）
     spec/           # YAML 解析、验证、编译
-    bridge/         # OpenClaw 桥接（SOUL.md 生成、任务调度、工作区 I/O、Uni 注册中心）
+    bridge/         # OpenClaw 桥接（SOUL.md 生成、任务调度、工作区 I/O、Uni 注册中心、agency-agents 桥接）
     dashboard/      # 🆕 Dashboard 仪表盘（Hono 服务器、HTML 模板、API 路由、扩展机制）
     schema/         # JSON Schema 验证
     templates/      # 5 种内置组织模板
-    cli/            # 命令行工具（10 个命令）
+    cli/            # 命令行工具（15 个命令）
   create-uni/       # npx create-uni 脚手架工具
   tests/            # 单元测试（41 个测试，7 个套件）
 ```

package/dist/bridge/agency-import.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Agency-Agents Bridge
+ *
+ * 导入 agency-agents 项目的 Agent .md 文件，转换为 agents-uni 的
+ * AgentDefinition + SOUL.md 格式，让 193 个高质量 Agent 人格为我所用。
+ *
+ * 支持两种用法：
+ * 1. CLI: `uni import ./path/to/agency-agents/engineering/ --name my-team`
+ * 2. API: `importAgencyAgents('./engineering/', { name: 'my-team' })`
+ */
+import type { AgentDefinition, UniverseConfig } from '../types/index.js';
+export interface AgencyAgentFrontmatter {
+    name: string;
+    description: string;
+    emoji?: string;
+    color?: string;
+    vibe?: string;
+    services?: Array<{
+        name: string;
+        url: string;
+        tier: string;
+    }>;
+}
+export interface AgencyAgentFile {
+    /** File path */
+    filePath: string;
+    /** Parsed YAML frontmatter */
+    frontmatter: AgencyAgentFrontmatter;
+    /** Full markdown body (after frontmatter) */
+    body: string;
+    /** Extracted sections by header */
+    sections: Map<string, string>;
+    /** Derived agent ID (from filename) */
+    id: string;
+}
+export interface ImportOptions {
+    /** Universe name */
+    name?: string;
+    /** Universe type */
+    type?: 'hierarchical' | 'flat' | 'competitive' | 'hybrid';
+    /** Default rank for imported agents (0-100) */
+    defaultRank?: number;
+    /** Category/department to assign (derived from directory name if omitted) */
+    department?: string;
+    /** Whether to infer traits from agent content */
+    inferTraits?: boolean;
+    /** Language for generated content */
+    language?: 'zh' | 'en';
+    /** Relationship strategy between imported agents */
+    relationships?: 'none' | 'peer' | 'competitive';
+}
+export interface ImportResult {
+    /** Generated UniverseConfig */
+    config: UniverseConfig;
+    /** Parsed agent files (for SOUL.md generation) */
+    agents: AgencyAgentFile[];
+    /** Warnings encountered during import */
+    warnings: string[];
+}
+/**
+ * Parse a single agency-agents .md file
+ */
+export declare function parseAgencyAgentFile(filePath: string): AgencyAgentFile;
+/**
+ * Convert an AgencyAgentFile to an agents-uni AgentDefinition
+ */
+export declare function toAgentDefinition(agent: AgencyAgentFile, opts?: {
+    rank?: number;
+    department?: string;
+    inferTraits?: boolean;
+}): AgentDefinition;
+/**
+ * Generate a SOUL.md that preserves the original agency-agents personality
+ * and wraps it with agents-uni organizational context
+ */
+export declare function toSoulMd(agent: AgencyAgentFile, opts?: {
+    universe?: UniverseConfig;
+    language?: 'zh' | 'en';
+}): string;
+/**
+ * Import all .md agents from a directory (or multiple directories)
+ * and generate a UniverseConfig
+ */
+export declare function importAgencyAgents(dirs: string | string[], opts?: ImportOptions): ImportResult;
+//# sourceMappingURL=agency-import.d.ts.map

package/dist/bridge/agency-import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agency-import.d.ts","sourceRoot":"","sources":["../../src/bridge/agency-import.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAIzE,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC/D;AAED,MAAM,WAAW,eAAe;IAC9B,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,WAAW,EAAE,sBAAsB,CAAC;IACpC,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,uCAAuC;IACvC,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,aAAa;IAC5B,oBAAoB;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oBAAoB;IACpB,IAAI,CAAC,EAAE,cAAc,GAAG,MAAM,GAAG,aAAa,GAAG,QAAQ,CAAC;IAC1D,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACvB,oDAAoD;IACpD,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,aAAa,CAAC;CACjD;AAED,MAAM,WAAW,YAAY;IAC3B,+BAA+B;IAC/B,MAAM,EAAE,cAAc,CAAC;IACvB,kDAAkD;IAClD,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,yCAAyC;IACzC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAID;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,CActE;AAwED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,eAAe,EACtB,IAAI,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,GACnE,eAAe,CAuCjB;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,eAAe,EACtB,IAAI,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,EAAE,IAAI,GAAG,IAAI,CAAA;CAAE,GAC3D,MAAM,CAiDR;AAID;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,EACvB,IAAI,CAAC,EAAE,aAAa,GACnB,YAAY,CA8Gd"}