@agents-uni/core 0.1.1 → 0.1.2

package/dist/bridge/agency-import.js

@@ -0,0 +1,323 @@
+/**
+ * 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 { readFileSync, readdirSync, statSync } from 'node:fs';
+import { join, basename, extname } from 'node:path';
+// ─── Parsing ─────────────────────────────────
+/**
+ * Parse a single agency-agents .md file
+ */
+export function parseAgencyAgentFile(filePath) {
+    const raw = readFileSync(filePath, 'utf-8');
+    const { frontmatter, body } = parseFrontmatter(raw);
+    const sections = parseSections(body);
+    // Derive ID from filename: "engineering-backend-architect.md" → "backend-architect"
+    let id = basename(filePath, extname(filePath));
+    // Strip common prefixes (engineering-, design-, marketing-, etc.)
+    id = id.replace(/^(engineering|design|marketing|sales|product|testing|support|specialized|spatial-computing|game-development|strategy|academic|paid-media|project-management)-/, '');
+    return { filePath, frontmatter, body, sections, id };
+}
+/**
+ * Parse YAML frontmatter from markdown
+ */
+function parseFrontmatter(raw) {
+    const match = raw.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+    if (!match) {
+        return {
+            frontmatter: { name: 'Unknown', description: '' },
+            body: raw,
+        };
+    }
+    const yamlBlock = match[1];
+    const body = match[2];
+    // Simple YAML parser for flat key-value (avoids dependency)
+    const fm = {};
+    for (const line of yamlBlock.split('\n')) {
+        const kv = line.match(/^(\w+):\s*(.+)$/);
+        if (kv) {
+            fm[kv[1]] = kv[2].trim();
+        }
+    }
+    return {
+        frontmatter: {
+            name: fm.name ?? 'Unknown',
+            description: fm.description ?? '',
+            emoji: fm.emoji,
+            color: fm.color,
+            vibe: fm.vibe,
+        },
+        body,
+    };
+}
+/**
+ * Extract sections by H2 headers
+ */
+function parseSections(body) {
+    const sections = new Map();
+    const lines = body.split('\n');
+    let currentHeader = '';
+    let currentContent = [];
+    for (const line of lines) {
+        const headerMatch = line.match(/^##\s+(.+)$/);
+        if (headerMatch) {
+            if (currentHeader) {
+                sections.set(currentHeader, currentContent.join('\n').trim());
+            }
+            currentHeader = headerMatch[1].trim();
+            currentContent = [];
+        }
+        else {
+            currentContent.push(line);
+        }
+    }
+    if (currentHeader) {
+        sections.set(currentHeader, currentContent.join('\n').trim());
+    }
+    return sections;
+}
+// ─── Conversion ──────────────────────────────
+/**
+ * Convert an AgencyAgentFile to an agents-uni AgentDefinition
+ */
+export function toAgentDefinition(agent, opts) {
+    const rank = opts?.rank ?? 50;
+    const department = opts?.department;
+    // Extract duties from Core Mission section
+    const missionSection = findSection(agent.sections, 'Core Mission') ??
+        findSection(agent.sections, 'Mission');
+    const duties = extractDuties(missionSection);
+    // Infer traits from Identity section
+    const traits = {};
+    if (opts?.inferTraits !== false) {
+        const identitySection = findSection(agent.sections, 'Identity') ??
+            findSection(agent.sections, 'Memory');
+        if (identitySection) {
+            Object.assign(traits, inferTraitsFromText(identitySection));
+        }
+    }
+    return {
+        id: agent.id,
+        name: agent.frontmatter.name,
+        role: {
+            title: agent.frontmatter.name,
+            duties,
+            permissions: [],
+            ...(department ? { department } : {}),
+        },
+        rank,
+        ...(Object.keys(traits).length > 0 ? { traits } : {}),
+        metadata: {
+            source: 'agency-agents',
+            emoji: agent.frontmatter.emoji ?? '',
+            vibe: agent.frontmatter.vibe ?? '',
+            originalFile: agent.filePath,
+        },
+    };
+}
+/**
+ * Generate a SOUL.md that preserves the original agency-agents personality
+ * and wraps it with agents-uni organizational context
+ */
+export function toSoulMd(agent, opts) {
+    const lang = opts?.language ?? 'en';
+    const uni = opts?.universe;
+    const lines = [];
+    // Header
+    lines.push(`# ${agent.frontmatter.emoji ?? '🤖'} ${agent.frontmatter.name}`);
+    lines.push('');
+    if (agent.frontmatter.vibe) {
+        lines.push(`> ${agent.frontmatter.vibe}`);
+        lines.push('');
+    }
+    // Organizational context (if universe provided)
+    if (uni) {
+        const header = lang === 'zh' ? '## 组织背景' : '## Organizational Context';
+        lines.push(header);
+        lines.push('');
+        lines.push(lang === 'zh'
+            ? `你是 **${uni.name}** 组织中的一员。`
+            : `You are a member of the **${uni.name}** organization.`);
+        if (uni.ruler) {
+            lines.push('');
+            lines.push(lang === 'zh'
+                ? `你的一切行动服务于用户（${uni.ruler.title ?? '决策者'}）。用户是整个关系网络的核心。`
+                : `All your actions serve the user (${uni.ruler.title ?? 'the decision maker'}). The user is at the center of the entire relationship network.`);
+        }
+        lines.push('');
+    }
+    // Preserve original personality content
+    const divider = lang === 'zh'
+        ? '## 核心人格（来自 agency-agents）'
+        : '## Core Personality (from agency-agents)';
+    lines.push(divider);
+    lines.push('');
+    lines.push(agent.body.trim());
+    lines.push('');
+    return lines.join('\n');
+}
+// ─── Batch Import ────────────────────────────
+/**
+ * Import all .md agents from a directory (or multiple directories)
+ * and generate a UniverseConfig
+ */
+export function importAgencyAgents(dirs, opts) {
+    const dirList = Array.isArray(dirs) ? dirs : [dirs];
+    const warnings = [];
+    const agents = [];
+    for (const dir of dirList) {
+        let files;
+        try {
+            files = readdirSync(dir).filter((f) => f.endsWith('.md') && !f.startsWith('README'));
+        }
+        catch {
+            warnings.push(`Cannot read directory: ${dir}`);
+            continue;
+        }
+        for (const file of files) {
+            const filePath = join(dir, file);
+            try {
+                if (!statSync(filePath).isFile())
+                    continue;
+                const agent = parseAgencyAgentFile(filePath);
+                // Skip files without valid frontmatter (docs, guides, etc.)
+                if (agent.frontmatter.name === 'Unknown' && !agent.frontmatter.description) {
+                    warnings.push(`Skipped non-agent file: ${file}`);
+                    continue;
+                }
+                agents.push(agent);
+            }
+            catch (e) {
+                warnings.push(`Failed to parse ${file}: ${e}`);
+            }
+        }
+    }
+    // Check for duplicate IDs
+    const idCounts = new Map();
+    for (const a of agents) {
+        idCounts.set(a.id, (idCounts.get(a.id) ?? 0) + 1);
+    }
+    for (const [id, count] of idCounts) {
+        if (count > 1) {
+            // Disambiguate by prepending directory name
+            let idx = 0;
+            for (const a of agents) {
+                if (a.id === id) {
+                    if (idx > 0) {
+                        const dirName = basename(join(a.filePath, '..'));
+                        a.id = `${dirName}-${a.id}`;
+                    }
+                    idx++;
+                }
+            }
+        }
+    }
+    // Derive department from directory name
+    const department = opts?.department ?? (dirList.length === 1 ? basename(dirList[0]) : undefined);
+    // Build AgentDefinitions
+    const agentDefs = agents.map((a) => toAgentDefinition(a, {
+        rank: opts?.defaultRank ?? 50,
+        department,
+        inferTraits: opts?.inferTraits,
+    }));
+    // Build relationships
+    const relationships = [];
+    if (opts?.relationships === 'peer') {
+        // All agents are peers
+        for (let i = 0; i < agentDefs.length; i++) {
+            for (let j = i + 1; j < agentDefs.length; j++) {
+                relationships.push({
+                    from: agentDefs[i].id,
+                    to: agentDefs[j].id,
+                    type: 'peer',
+                    weight: 0.5,
+                });
+            }
+        }
+    }
+    else if (opts?.relationships === 'competitive') {
+        for (let i = 0; i < agentDefs.length; i++) {
+            for (let j = i + 1; j < agentDefs.length; j++) {
+                relationships.push({
+                    from: agentDefs[i].id,
+                    to: agentDefs[j].id,
+                    type: 'competitive',
+                    weight: 0.5,
+                });
+            }
+        }
+    }
+    const config = {
+        name: opts?.name ?? 'imported-universe',
+        version: '1.0.0',
+        type: opts?.type ?? 'flat',
+        description: `Imported from agency-agents (${agents.length} agents)`,
+        agents: agentDefs,
+        relationships,
+        protocols: [],
+        governance: {
+            decisionModel: opts?.type === 'competitive' ? 'meritocratic' : 'democratic',
+            permissionMatrix: [],
+            reviewPolicy: { mandatory: false, reviewers: [], maxRounds: 1 },
+            escalationRules: [],
+        },
+    };
+    return { config, agents, warnings };
+}
+// ─── Helpers ─────────────────────────────────
+function findSection(sections, keyword) {
+    for (const [key, value] of sections) {
+        if (key.toLowerCase().includes(keyword.toLowerCase())) {
+            return value;
+        }
+    }
+    return undefined;
+}
+function extractDuties(section) {
+    if (!section)
+        return [];
+    const duties = [];
+    for (const line of section.split('\n')) {
+        const match = line.match(/^###\s+(.+)$/);
+        if (match) {
+            duties.push(match[1].trim());
+        }
+    }
+    // If no H3 headers found, try bullet points
+    if (duties.length === 0) {
+        for (const line of section.split('\n')) {
+            const match = line.match(/^[-*]\s+\*\*(.+?)\*\*/);
+            if (match) {
+                duties.push(match[1].trim());
+            }
+        }
+    }
+    return duties.slice(0, 8); // Cap at 8 duties
+}
+function inferTraitsFromText(text) {
+    const traits = {};
+    const lower = text.toLowerCase();
+    const traitKeywords = {
+        creativity: ['creative', 'innovative', 'imaginative', 'artistic', 'design'],
+        precision: ['detail', 'precise', 'meticulous', 'accurate', 'pixel-perfect'],
+        speed: ['fast', 'rapid', 'quick', 'agile', 'efficient'],
+        collaboration: ['team', 'collaborat', 'cooperat', 'communicate'],
+        strategy: ['strateg', 'planning', 'architect', 'systematic'],
+        security: ['security', 'secure', 'protect', 'compliance', 'defense'],
+        reliability: ['reliable', 'robust', 'stable', 'resilient', 'consistent'],
+    };
+    for (const [trait, keywords] of Object.entries(traitKeywords)) {
+        const hits = keywords.filter((kw) => lower.includes(kw)).length;
+        if (hits > 0) {
+            traits[trait] = Math.min(0.5 + hits * 0.15, 0.95);
+        }
+    }
+    return traits;
+}
+//# sourceMappingURL=agency-import.js.map

package/dist/bridge/agency-import.js.map

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

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

@@ -0,0 +1,93 @@
+/**
+ * Agency-Agents Registry
+ *
+ * 管理 agency-agents 仓库的本地生命周期：
+ * - init:   克隆到 ~/.agents-uni/agency-agents/
+ * - update: git pull 拉取最新
+ * - list:   列出所有可用分类及 agent 数量
+ * - resolve: 将分类名转为目录路径
+ *
+ * 让用户无需手动 clone 和管理路径。
+ */
+/**
+ * Categories that contain actual agent .md files
+ * (excludes examples, integrations, scripts)
+ */
+declare const AGENT_CATEGORIES: readonly ["academic", "design", "engineering", "game-development", "marketing", "paid-media", "product", "project-management", "sales", "spatial-computing", "specialized", "strategy", "support", "testing"];
+export type AgencyCategory = typeof AGENT_CATEGORIES[number];
+export interface AgencyCategoryInfo {
+    /** Category name (directory name) */
+    name: string;
+    /** Number of agent .md files */
+    agentCount: number;
+    /** Absolute path to the category directory */
+    path: string;
+}
+export interface AgencyStatus {
+    /** Whether agency-agents is installed locally */
+    installed: boolean;
+    /** Local directory path */
+    dir: string;
+    /** Current git commit hash (short) */
+    commit?: string;
+    /** Last update time (from git log) */
+    lastUpdated?: string;
+    /** Total agent count across all categories */
+    totalAgents?: number;
+    /** Category breakdown */
+    categories?: AgencyCategoryInfo[];
+}
+export interface AgencyUpdateResult {
+    /** Whether new commits were pulled */
+    updated: boolean;
+    /** Previous commit hash */
+    oldCommit: string;
+    /** New commit hash */
+    newCommit: string;
+    /** Summary of changes (git log --oneline) */
+    changelog: string[];
+}
+/**
+ * Get the local agency-agents directory path
+ */
+export declare function getAgencyDir(): string;
+/**
+ * Check if agency-agents is installed locally
+ */
+export declare function isAgencyInstalled(): boolean;
+/**
+ * Clone agency-agents repo to ~/.agents-uni/agency-agents/
+ *
+ * @param shallow - Use shallow clone (--depth 1) for faster download. Default: true
+ * @throws If git is not available or clone fails
+ */
+export declare function agencyInit(shallow?: boolean): void;
+/**
+ * Pull latest changes from agency-agents repo
+ *
+ * @returns Update result with old/new commit hashes and changelog
+ * @throws If not installed or git pull fails
+ */
+export declare function agencyUpdate(): AgencyUpdateResult;
+/**
+ * List all available agent categories with agent counts
+ */
+export declare function agencyListCategories(): AgencyCategoryInfo[];
+/**
+ * Get full status of the local agency-agents installation
+ */
+export declare function agencyStatus(): AgencyStatus;
+/**
+ * Resolve category names to absolute directory paths
+ *
+ * @param categories - Category names (e.g., ['engineering', 'design']) or ['all']
+ * @returns Array of absolute directory paths
+ * @throws If agency-agents is not installed or a category doesn't exist
+ */
+export declare function resolveAgencyCategories(categories: string[]): string[];
+/**
+ * Get list of valid category names
+ */
+export declare function getAvailableCategories(): readonly string[];
+export {};
+//# sourceMappingURL=agency-registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agency-registry.d.ts","sourceRoot":"","sources":["../../src/bridge/agency-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAaH;;;GAGG;AACH,QAAA,MAAM,gBAAgB,+MAeZ,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC;AAI7D,MAAM,WAAW,kBAAkB;IACjC,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,iDAAiD;IACjD,SAAS,EAAE,OAAO,CAAC;IACnB,2BAA2B;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,UAAU,CAAC,EAAE,kBAAkB,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAID;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,OAAO,UAAO,GAAG,IAAI,CAkB/C;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,IAAI,kBAAkB,CAqDjD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,kBAAkB,EAAE,CAsC3D;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,YAAY,CAoB3C;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CA0BtE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,SAAS,MAAM,EAAE,CAE1D"}

package/dist/bridge/agency-registry.js

@@ -0,0 +1,250 @@
+/**
+ * Agency-Agents Registry
+ *
+ * 管理 agency-agents 仓库的本地生命周期：
+ * - init:   克隆到 ~/.agents-uni/agency-agents/
+ * - update: git pull 拉取最新
+ * - list:   列出所有可用分类及 agent 数量
+ * - resolve: 将分类名转为目录路径
+ *
+ * 让用户无需手动 clone 和管理路径。
+ */
+import { existsSync, readdirSync, readFileSync, mkdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { execSync } from 'node:child_process';
+import { homedir } from 'node:os';
+// ─── Constants ───────────────────────────────
+const AGENCY_REPO_URL = 'https://github.com/msitarzewski/agency-agents.git';
+const AGENTS_UNI_HOME = join(homedir(), '.agents-uni');
+const AGENCY_DIR = join(AGENTS_UNI_HOME, 'agency-agents');
+/**
+ * Categories that contain actual agent .md files
+ * (excludes examples, integrations, scripts)
+ */
+const AGENT_CATEGORIES = [
+    'academic',
+    'design',
+    'engineering',
+    'game-development',
+    'marketing',
+    'paid-media',
+    'product',
+    'project-management',
+    'sales',
+    'spatial-computing',
+    'specialized',
+    'strategy',
+    'support',
+    'testing',
+];
+// ─── Core Functions ──────────────────────────
+/**
+ * Get the local agency-agents directory path
+ */
+export function getAgencyDir() {
+    return AGENCY_DIR;
+}
+/**
+ * Check if agency-agents is installed locally
+ */
+export function isAgencyInstalled() {
+    return existsSync(join(AGENCY_DIR, '.git'));
+}
+/**
+ * Clone agency-agents repo to ~/.agents-uni/agency-agents/
+ *
+ * @param shallow - Use shallow clone (--depth 1) for faster download. Default: true
+ * @throws If git is not available or clone fails
+ */
+export function agencyInit(shallow = true) {
+    if (isAgencyInstalled()) {
+        throw new Error(`agency-agents is already installed at ${AGENCY_DIR}. Use agencyUpdate() to pull latest.`);
+    }
+    // Ensure parent directory exists
+    mkdirSync(AGENTS_UNI_HOME, { recursive: true });
+    const depthFlag = shallow ? '--depth 1' : '';
+    execSync(`git clone ${depthFlag} ${AGENCY_REPO_URL} "${AGENCY_DIR}"`, {
+        stdio: 'pipe',
+        encoding: 'utf-8',
+    });
+    // Write metadata
+    writeAgencyMeta({ installedAt: new Date().toISOString() });
+}
+/**
+ * Pull latest changes from agency-agents repo
+ *
+ * @returns Update result with old/new commit hashes and changelog
+ * @throws If not installed or git pull fails
+ */
+export function agencyUpdate() {
+    if (!isAgencyInstalled()) {
+        throw new Error('agency-agents is not installed. Run `uni agency init` first.');
+    }
+    const oldCommit = getGitCommit();
+    // For shallow clones, unshallow first to enable proper pull
+    try {
+        const isShallow = existsSync(join(AGENCY_DIR, '.git', 'shallow'));
+        if (isShallow) {
+            execSync('git fetch --unshallow', { cwd: AGENCY_DIR, stdio: 'pipe' });
+        }
+    }
+    catch {
+        // Already unshallowed or not applicable, continue
+    }
+    execSync('git pull origin main', {
+        cwd: AGENCY_DIR,
+        stdio: 'pipe',
+        encoding: 'utf-8',
+    });
+    const newCommit = getGitCommit();
+    // Get changelog between old and new
+    let changelog = [];
+    if (oldCommit !== newCommit) {
+        try {
+            const log = execSync(`git log --oneline ${oldCommit}..${newCommit}`, { cwd: AGENCY_DIR, stdio: 'pipe', encoding: 'utf-8' }).trim();
+            changelog = log ? log.split('\n') : [];
+        }
+        catch {
+            changelog = ['(unable to retrieve changelog)'];
+        }
+    }
+    // Update metadata
+    writeAgencyMeta({
+        ...readAgencyMeta(),
+        lastUpdatedAt: new Date().toISOString(),
+    });
+    return {
+        updated: oldCommit !== newCommit,
+        oldCommit,
+        newCommit,
+        changelog,
+    };
+}
+/**
+ * List all available agent categories with agent counts
+ */
+export function agencyListCategories() {
+    if (!isAgencyInstalled()) {
+        throw new Error('agency-agents is not installed. Run `uni agency init` first.');
+    }
+    const categories = [];
+    for (const cat of AGENT_CATEGORIES) {
+        const catDir = join(AGENCY_DIR, cat);
+        if (!existsSync(catDir))
+            continue;
+        const files = readdirSync(catDir).filter((f) => f.endsWith('.md') && !f.startsWith('README'));
+        // Count only files with valid frontmatter (actual agents)
+        let agentCount = 0;
+        for (const file of files) {
+            try {
+                const content = readFileSync(join(catDir, file), 'utf-8');
+                if (content.startsWith('---\n')) {
+                    agentCount++;
+                }
+            }
+            catch {
+                // Skip unreadable files
+            }
+        }
+        categories.push({
+            name: cat,
+            agentCount,
+            path: catDir,
+        });
+    }
+    return categories;
+}
+/**
+ * Get full status of the local agency-agents installation
+ */
+export function agencyStatus() {
+    const installed = isAgencyInstalled();
+    if (!installed) {
+        return { installed, dir: AGENCY_DIR };
+    }
+    const commit = getGitCommit();
+    const lastUpdated = getGitLastDate();
+    const categories = agencyListCategories();
+    const totalAgents = categories.reduce((sum, c) => sum + c.agentCount, 0);
+    return {
+        installed,
+        dir: AGENCY_DIR,
+        commit,
+        lastUpdated,
+        totalAgents,
+        categories,
+    };
+}
+/**
+ * Resolve category names to absolute directory paths
+ *
+ * @param categories - Category names (e.g., ['engineering', 'design']) or ['all']
+ * @returns Array of absolute directory paths
+ * @throws If agency-agents is not installed or a category doesn't exist
+ */
+export function resolveAgencyCategories(categories) {
+    if (!isAgencyInstalled()) {
+        throw new Error('agency-agents is not installed. Run `uni agency init` first.');
+    }
+    // Handle --all / 'all'
+    if (categories.length === 1 && categories[0] === 'all') {
+        return AGENT_CATEGORIES
+            .map((cat) => join(AGENCY_DIR, cat))
+            .filter((p) => existsSync(p));
+    }
+    const paths = [];
+    for (const cat of categories) {
+        const catDir = join(AGENCY_DIR, cat);
+        if (!existsSync(catDir)) {
+            throw new Error(`Category "${cat}" not found. Available: ${AGENT_CATEGORIES.join(', ')}`);
+        }
+        paths.push(catDir);
+    }
+    return paths;
+}
+/**
+ * Get list of valid category names
+ */
+export function getAvailableCategories() {
+    return AGENT_CATEGORIES;
+}
+// ─── Internal Helpers ────────────────────────
+function getGitCommit() {
+    try {
+        return execSync('git rev-parse --short HEAD', {
+            cwd: AGENCY_DIR,
+            stdio: 'pipe',
+            encoding: 'utf-8',
+        }).trim();
+    }
+    catch {
+        return 'unknown';
+    }
+}
+function getGitLastDate() {
+    try {
+        return execSync('git log -1 --format=%ci', {
+            cwd: AGENCY_DIR,
+            stdio: 'pipe',
+            encoding: 'utf-8',
+        }).trim();
+    }
+    catch {
+        return 'unknown';
+    }
+}
+function readAgencyMeta() {
+    const metaPath = join(AGENTS_UNI_HOME, 'agency-meta.json');
+    try {
+        return JSON.parse(readFileSync(metaPath, 'utf-8'));
+    }
+    catch {
+        return {};
+    }
+}
+function writeAgencyMeta(meta) {
+    const metaPath = join(AGENTS_UNI_HOME, 'agency-meta.json');
+    mkdirSync(AGENTS_UNI_HOME, { recursive: true });
+    writeFileSync(metaPath, JSON.stringify(meta, null, 2), 'utf-8');
+}
+//# sourceMappingURL=agency-registry.js.map