@agents-uni/core 0.1.0

package/dist/bridge/task-dispatcher.js

@@ -0,0 +1,217 @@
+/**
+ * Task Dispatcher — the missing link between OpenClaw agents and competition engines.
+ *
+ * Completes the race loop:
+ *   deploy SOUL.md → dispatch TASK.md → agent executes → collect SUBMISSION.md → judge
+ *
+ * Design principles:
+ * 1. File protocol: no HTTP required from agents, just file read/write
+ * 2. Pluggable I/O: swap FileWorkspaceIO for remote/memory backends
+ * 3. Event-driven: all lifecycle stages emit events via the org EventBus
+ * 4. Timeout-aware: agents that fail to submit within timeLimit are marked as timed out
+ * 5. Fault-tolerant: partial dispatch failures don't crash the whole pipeline
+ */
+// ─── Task Markdown Generator ────────────────────
+function generateTaskMarkdown(task, agentId) {
+    const lines = [
+        `# 📋 Task: ${task.title}`,
+        '',
+        `> **Task ID**: \`${task.id}\``,
+        `> **Participant**: \`${agentId}\``,
+        `> **Time Limit**: ${Math.round(task.timeoutMs / 1000)}s`,
+        '',
+        '---',
+        '',
+        '## Description',
+        '',
+        task.description,
+        '',
+    ];
+    if (task.criteria.length > 0) {
+        lines.push('## Evaluation Criteria', '');
+        lines.push('| Criterion | Weight | Description |');
+        lines.push('|-----------|--------|-------------|');
+        for (const c of task.criteria) {
+            lines.push(`| ${c.name} | ${c.weight} | ${c.description} |`);
+        }
+        lines.push('');
+    }
+    lines.push('## How to Submit', '', 'Write your response to a file named `SUBMISSION.md` in this workspace directory.', 'The dispatcher will automatically collect your submission.', '', '---', `*Dispatched at: ${new Date().toISOString()}*`);
+    return lines.join('\n');
+}
+// ─── Submission Parser ──────────────────────────
+function parseSubmission(raw) {
+    // For now, the entire SUBMISSION.md content is the output.
+    // Future: support structured frontmatter (confidence, reasoning, etc.)
+    return raw.trim();
+}
+// ─── TaskDispatcher ─────────────────────────────
+/**
+ * Dispatches tasks to agent workspaces and collects their submissions.
+ *
+ * Usage:
+ * ```typescript
+ * const io = new FileWorkspaceIO();
+ * const dispatcher = new TaskDispatcher(io, { eventBus: universe.events });
+ *
+ * const result = await dispatcher.run({
+ *   id: 'race-001',
+ *   title: '撰写一篇策论',
+ *   description: '就"如何提升协作效率"撰写500字策论',
+ *   criteria: [{ name: '质量', weight: 0.6, description: '...' }],
+ *   timeoutMs: 60000,
+ *   participants: ['zhenhuan', 'huafei', 'anlingrong'],
+ * });
+ * ```
+ */
+export class TaskDispatcher {
+    io;
+    pollIntervalMs;
+    cleanup;
+    eventBus;
+    constructor(io, options = {}) {
+        this.io = io;
+        this.pollIntervalMs = options.pollIntervalMs ?? 2000;
+        this.cleanup = options.cleanup ?? true;
+        this.eventBus = options.eventBus;
+    }
+    /**
+     * Dispatch a task to all participants' workspaces.
+     * Writes TASK.md to each agent's workspace directory.
+     * Returns the list of agent IDs that failed to receive the task.
+     */
+    async dispatch(task) {
+        const failed = [];
+        // Clear any stale submissions first (best effort)
+        for (const agentId of task.participants) {
+            try {
+                await this.io.clearSubmission(agentId);
+                await this.io.clearTask(agentId);
+            }
+            catch {
+                // Stale cleanup is best-effort; if it fails, continue
+            }
+        }
+        // Write task to each workspace
+        for (const agentId of task.participants) {
+            try {
+                const markdown = generateTaskMarkdown(task, agentId);
+                await this.io.writeTask(agentId, markdown);
+            }
+            catch (err) {
+                failed.push(agentId);
+                console.warn(`[TaskDispatcher] Failed to dispatch TASK.md to ${agentId}:`, err instanceof Error ? err.message : err);
+            }
+        }
+        // Emit event
+        if (this.eventBus) {
+            const dispatched = task.participants.filter(id => !failed.includes(id));
+            await this.eventBus.emitSimple('race.dispatched', dispatched, `任务「${task.title}」已下发给 ${dispatched.length} 名参赛者` +
+                (failed.length > 0 ? `（${failed.length} 名下发失败）` : ''), { taskId: task.id, participants: dispatched, failed });
+        }
+        return failed;
+    }
+    /**
+     * Collect submissions from participants, polling until timeout.
+     * Returns all collected submissions and which agents timed out.
+     */
+    async collect(task, dispatchedAt, excludeAgents = []) {
+        const startTime = Date.now();
+        // Only wait for agents that actually received the task
+        const activeParticipants = task.participants.filter(id => !excludeAgents.includes(id));
+        const remaining = new Set(activeParticipants);
+        const submissions = [];
+        // Poll for submissions
+        while (remaining.size > 0) {
+            const elapsed = Date.now() - startTime;
+            if (elapsed >= task.timeoutMs)
+                break;
+            for (const agentId of [...remaining]) {
+                try {
+                    const raw = await this.io.readSubmission(agentId);
+                    if (raw !== null) {
+                        const output = parseSubmission(raw);
+                        submissions.push({
+                            agentId,
+                            output,
+                            submittedAt: new Date().toISOString(),
+                            duration: Date.now() - startTime,
+                        });
+                        remaining.delete(agentId);
+                        // Emit per-agent submission event
+                        if (this.eventBus) {
+                            await this.eventBus.emitSimple('race.submitted', [agentId], `${agentId} 已提交赛马结果`, { taskId: task.id, agentId, duration: Date.now() - startTime });
+                        }
+                    }
+                }
+                catch {
+                    // Read failure is transient (file being written); retry on next poll
+                }
+            }
+            if (remaining.size === 0)
+                break;
+            // Wait before next poll (but don't exceed timeout)
+            const remainingMs = task.timeoutMs - (Date.now() - startTime);
+            if (remainingMs <= 0)
+                break;
+            await sleep(Math.min(this.pollIntervalMs, remainingMs));
+        }
+        const timedOut = [...remaining];
+        const collectedAt = new Date().toISOString();
+        // Cleanup files (best effort)
+        if (this.cleanup) {
+            for (const agentId of task.participants) {
+                try {
+                    await this.io.clearTask(agentId);
+                    await this.io.clearSubmission(agentId);
+                }
+                catch {
+                    // Cleanup is best-effort
+                }
+            }
+        }
+        // Emit collection complete event
+        if (this.eventBus) {
+            await this.eventBus.emitSimple('race.collected', task.participants, `任务「${task.title}」收集完成: ${submissions.length} 份提交, ${timedOut.length} 超时`, { taskId: task.id, submitted: submissions.length, timedOut });
+        }
+        return {
+            taskId: task.id,
+            taskTitle: task.title,
+            dispatchedAt,
+            collectedAt,
+            submissions,
+            timedOut,
+            dispatchFailed: excludeAgents,
+        };
+    }
+    /**
+     * Run a complete dispatch-collect cycle: dispatch task, wait for submissions, return results.
+     * This is the primary high-level API.
+     *
+     * Agents that fail to receive the task are excluded from collection
+     * and reported in `dispatchFailed`.
+     */
+    async run(task) {
+        if (task.participants.length === 0) {
+            return {
+                taskId: task.id,
+                taskTitle: task.title,
+                dispatchedAt: new Date().toISOString(),
+                collectedAt: new Date().toISOString(),
+                submissions: [],
+                timedOut: [],
+                dispatchFailed: [],
+            };
+        }
+        const dispatchedAt = new Date().toISOString();
+        const failed = await this.dispatch(task);
+        return this.collect(task, dispatchedAt, failed);
+    }
+}
+// ─── Helpers ────────────────────────────────────
+function sleep(ms) {
+    if (ms <= 0)
+        return Promise.resolve();
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=task-dispatcher.js.map

package/dist/bridge/task-dispatcher.js.map

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

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

@@ -0,0 +1,82 @@
+/**
+ * Uni Registry — manages multiple universe deployments.
+ *
+ * Tracks which universes are deployed to OpenClaw, their agents,
+ * and provides lifecycle operations (register, update, reset, cleanup).
+ *
+ * Storage: ~/.openclaw/uni-registry.json
+ */
+import type { UniverseConfig, UniverseType } from '../types/index.js';
+import { type SoulGeneratorOptions } from './soul-generator.js';
+export interface UniRegistryEntry {
+    /** Universe identifier (from config.name) */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Absolute path to the universe.yaml spec file */
+    specPath: string;
+    /** Organization type */
+    type: UniverseType;
+    /** Agent IDs belonging to this uni */
+    agentIds: string[];
+    /** First deployment timestamp */
+    deployedAt: string;
+    /** Last update timestamp */
+    updatedAt: string;
+    /** Spec version */
+    version: string;
+    /** Description */
+    description: string;
+}
+export interface UniRegistry {
+    version: string;
+    unis: UniRegistryEntry[];
+}
+/**
+ * Register a universe in the registry.
+ * If already registered, updates the existing entry.
+ */
+export declare function registerUni(config: UniverseConfig, specPath: string, openclawDir?: string): UniRegistryEntry;
+/**
+ * List all registered universes.
+ */
+export declare function listUnis(openclawDir?: string): UniRegistryEntry[];
+/**
+ * Get a specific universe by ID.
+ */
+export declare function getUni(id: string, openclawDir?: string): UniRegistryEntry | null;
+/**
+ * Remove a universe from the registry (does NOT delete files).
+ */
+export declare function unregisterUni(id: string, openclawDir?: string): boolean;
+/**
+ * Fully clean up a universe:
+ * 1. Delete all workspace-{agentId}/ directories
+ * 2. Delete all agents/{agentId}/ directories
+ * 3. Remove agents from openclaw.json
+ * 4. Delete the {uni}-permissions.md file
+ * 5. Remove from uni-registry.json
+ */
+export declare function cleanupUni(id: string, openclawDir?: string): {
+    removedWorkspaces: string[];
+    removedAgentDirs: string[];
+    removedFromConfig: string[];
+};
+/**
+ * Update a universe: regenerate SOUL.md files for all agents,
+ * handle added/removed agents, update registry.
+ */
+export declare function updateUni(id: string, config: UniverseConfig, specPath: string, soulOptions?: SoulGeneratorOptions, openclawDir?: string): {
+    added: string[];
+    removed: string[];
+    updated: string[];
+};
+/**
+ * Reset a universe: clear runtime data (sessions, TASK.md, SUBMISSION.md)
+ * but preserve SOUL.md and configuration.
+ */
+export declare function resetUni(id: string, openclawDir?: string): {
+    clearedSessions: string[];
+    clearedTasks: string[];
+};
+//# sourceMappingURL=uni-registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"uni-registry.d.ts","sourceRoot":"","sources":["../../src/bridge/uni-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAoB,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAKlF,MAAM,WAAW,gBAAgB;IAC/B,6CAA6C;IAC7C,EAAE,EAAE,MAAM,CAAC;IACX,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,IAAI,EAAE,YAAY,CAAC;IACnB,sCAAsC;IACtC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,gBAAgB,EAAE,CAAC;CAC1B;AAoCD;;;GAGG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,MAAM,GACnB,gBAAgB,CAkClB;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAEjE;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAGhF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAOvE;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG;IAC5D,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B,CAsCA;AAED;;;GAGG;AACH,wBAAgB,SAAS,CACvB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,oBAAoB,EAClC,WAAW,CAAC,EAAE,MAAM,GACnB;IACD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAoDA;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG;IAC1D,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB,CAyCA"}

package/dist/bridge/uni-registry.js

@@ -0,0 +1,261 @@
+/**
+ * Uni Registry — manages multiple universe deployments.
+ *
+ * Tracks which universes are deployed to OpenClaw, their agents,
+ * and provides lifecycle operations (register, update, reset, cleanup).
+ *
+ * Storage: ~/.openclaw/uni-registry.json
+ */
+import { mkdirSync, writeFileSync, readFileSync, existsSync, rmSync, readdirSync, } from 'node:fs';
+import { join } from 'node:path';
+import { generateAllSouls } from './soul-generator.js';
+// ─── Helpers ──────────────────────────────────────
+function getOpenClawDir(openclawDir) {
+    return openclawDir ?? join(process.env.HOME ?? process.env.USERPROFILE ?? '.', '.openclaw');
+}
+function getRegistryPath(openclawDir) {
+    return join(getOpenClawDir(openclawDir), 'uni-registry.json');
+}
+function readRegistry(openclawDir) {
+    const path = getRegistryPath(openclawDir);
+    if (!existsSync(path)) {
+        return { version: '1.0.0', unis: [] };
+    }
+    try {
+        return JSON.parse(readFileSync(path, 'utf-8'));
+    }
+    catch {
+        return { version: '1.0.0', unis: [] };
+    }
+}
+function writeRegistry(registry, openclawDir) {
+    const dir = getOpenClawDir(openclawDir);
+    mkdirSync(dir, { recursive: true });
+    const path = getRegistryPath(openclawDir);
+    writeFileSync(path, JSON.stringify(registry, null, 2) + '\n', 'utf-8');
+}
+// ─── Public API ───────────────────────────────────
+/**
+ * Register a universe in the registry.
+ * If already registered, updates the existing entry.
+ */
+export function registerUni(config, specPath, openclawDir) {
+    const registry = readRegistry(openclawDir);
+    const now = new Date().toISOString();
+    const existing = registry.unis.find(u => u.id === config.name);
+    if (existing) {
+        // Update existing entry
+        existing.name = config.description || config.name;
+        existing.specPath = specPath;
+        existing.type = config.type;
+        existing.agentIds = config.agents.map(a => a.id);
+        existing.updatedAt = now;
+        existing.version = config.version;
+        existing.description = config.description;
+        writeRegistry(registry, openclawDir);
+        return existing;
+    }
+    // New entry
+    const entry = {
+        id: config.name,
+        name: config.description || config.name,
+        specPath,
+        type: config.type,
+        agentIds: config.agents.map(a => a.id),
+        deployedAt: now,
+        updatedAt: now,
+        version: config.version,
+        description: config.description,
+    };
+    registry.unis.push(entry);
+    writeRegistry(registry, openclawDir);
+    return entry;
+}
+/**
+ * List all registered universes.
+ */
+export function listUnis(openclawDir) {
+    return readRegistry(openclawDir).unis;
+}
+/**
+ * Get a specific universe by ID.
+ */
+export function getUni(id, openclawDir) {
+    const registry = readRegistry(openclawDir);
+    return registry.unis.find(u => u.id === id) ?? null;
+}
+/**
+ * Remove a universe from the registry (does NOT delete files).
+ */
+export function unregisterUni(id, openclawDir) {
+    const registry = readRegistry(openclawDir);
+    const idx = registry.unis.findIndex(u => u.id === id);
+    if (idx === -1)
+        return false;
+    registry.unis.splice(idx, 1);
+    writeRegistry(registry, openclawDir);
+    return true;
+}
+/**
+ * Fully clean up a universe:
+ * 1. Delete all workspace-{agentId}/ directories
+ * 2. Delete all agents/{agentId}/ directories
+ * 3. Remove agents from openclaw.json
+ * 4. Delete the {uni}-permissions.md file
+ * 5. Remove from uni-registry.json
+ */
+export function cleanupUni(id, openclawDir) {
+    const dir = getOpenClawDir(openclawDir);
+    const entry = getUni(id, openclawDir);
+    if (!entry) {
+        return { removedWorkspaces: [], removedAgentDirs: [], removedFromConfig: [] };
+    }
+    const removedWorkspaces = [];
+    const removedAgentDirs = [];
+    // Delete workspace and agent directories
+    for (const agentId of entry.agentIds) {
+        const workspacePath = join(dir, `workspace-${agentId}`);
+        if (existsSync(workspacePath)) {
+            rmSync(workspacePath, { recursive: true, force: true });
+            removedWorkspaces.push(workspacePath);
+        }
+        const agentPath = join(dir, 'agents', agentId);
+        if (existsSync(agentPath)) {
+            rmSync(agentPath, { recursive: true, force: true });
+            removedAgentDirs.push(agentPath);
+        }
+    }
+    // Remove agents from openclaw.json
+    const removedFromConfig = removeAgentsFromOpenClawConfig(entry.agentIds, openclawDir);
+    // Delete permissions file
+    const permPath = join(dir, `${id}-permissions.md`);
+    if (existsSync(permPath)) {
+        rmSync(permPath, { force: true });
+    }
+    // Remove from registry
+    unregisterUni(id, openclawDir);
+    return { removedWorkspaces, removedAgentDirs, removedFromConfig };
+}
+/**
+ * Update a universe: regenerate SOUL.md files for all agents,
+ * handle added/removed agents, update registry.
+ */
+export function updateUni(id, config, specPath, soulOptions, openclawDir) {
+    const dir = getOpenClawDir(openclawDir);
+    const entry = getUni(id, openclawDir);
+    const oldAgentIds = entry ? new Set(entry.agentIds) : new Set();
+    const newAgentIds = new Set(config.agents.map(a => a.id));
+    const added = [];
+    const removed = [];
+    const updated = [];
+    // Generate new SOUL.md files
+    const souls = generateAllSouls(config, soulOptions);
+    for (const agent of config.agents) {
+        const workspacePath = join(dir, `workspace-${agent.id}`);
+        const agentDir = join(dir, 'agents', agent.id, 'agent');
+        const sessionsDir = join(dir, 'agents', agent.id, 'sessions');
+        mkdirSync(workspacePath, { recursive: true });
+        mkdirSync(agentDir, { recursive: true });
+        mkdirSync(sessionsDir, { recursive: true });
+        const soulContent = souls.get(agent.id) ?? '';
+        writeFileSync(join(workspacePath, 'SOUL.md'), soulContent, 'utf-8');
+        if (oldAgentIds.has(agent.id)) {
+            updated.push(agent.id);
+        }
+        else {
+            added.push(agent.id);
+        }
+    }
+    // Clean up removed agents
+    for (const oldId of oldAgentIds) {
+        if (!newAgentIds.has(oldId)) {
+            const workspacePath = join(dir, `workspace-${oldId}`);
+            const agentPath = join(dir, 'agents', oldId);
+            if (existsSync(workspacePath))
+                rmSync(workspacePath, { recursive: true, force: true });
+            if (existsSync(agentPath))
+                rmSync(agentPath, { recursive: true, force: true });
+            removed.push(oldId);
+        }
+    }
+    // Update openclaw.json (remove old, add new)
+    if (removed.length > 0) {
+        removeAgentsFromOpenClawConfig(removed, openclawDir);
+    }
+    // Update registry entry
+    registerUni(config, specPath, openclawDir);
+    return { added, removed, updated };
+}
+/**
+ * Reset a universe: clear runtime data (sessions, TASK.md, SUBMISSION.md)
+ * but preserve SOUL.md and configuration.
+ */
+export function resetUni(id, openclawDir) {
+    const dir = getOpenClawDir(openclawDir);
+    const entry = getUni(id, openclawDir);
+    if (!entry) {
+        return { clearedSessions: [], clearedTasks: [] };
+    }
+    const clearedSessions = [];
+    const clearedTasks = [];
+    for (const agentId of entry.agentIds) {
+        // Clear sessions
+        const sessionsDir = join(dir, 'agents', agentId, 'sessions');
+        if (existsSync(sessionsDir)) {
+            const files = readdirSync(sessionsDir);
+            for (const file of files) {
+                rmSync(join(sessionsDir, file), { force: true });
+            }
+            if (files.length > 0)
+                clearedSessions.push(agentId);
+        }
+        // Clear TASK.md and SUBMISSION.md from workspace
+        const workspacePath = join(dir, `workspace-${agentId}`);
+        for (const runtimeFile of ['TASK.md', 'SUBMISSION.md']) {
+            const filePath = join(workspacePath, runtimeFile);
+            if (existsSync(filePath)) {
+                rmSync(filePath, { force: true });
+                clearedTasks.push(`${agentId}/${runtimeFile}`);
+            }
+        }
+    }
+    // Update registry timestamp
+    const registry = readRegistry(openclawDir);
+    const entryRef = registry.unis.find(u => u.id === id);
+    if (entryRef) {
+        entryRef.updatedAt = new Date().toISOString();
+        writeRegistry(registry, openclawDir);
+    }
+    return { clearedSessions, clearedTasks };
+}
+// ─── Internal Helpers ─────────────────────────────
+function removeAgentsFromOpenClawConfig(agentIds, openclawDir) {
+    const dir = getOpenClawDir(openclawDir);
+    const configPath = join(dir, 'openclaw.json');
+    if (!existsSync(configPath))
+        return [];
+    try {
+        const config = JSON.parse(readFileSync(configPath, 'utf-8'));
+        const agents = config.agents;
+        if (!agents)
+            return [];
+        const list = (agents.list ?? []);
+        const idsToRemove = new Set(agentIds);
+        const removed = [];
+        agents.list = list.filter(a => {
+            const id = a.id;
+            if (idsToRemove.has(id)) {
+                removed.push(id);
+                return false;
+            }
+            return true;
+        });
+        config.agents = agents;
+        writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+        return removed;
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=uni-registry.js.map

package/dist/bridge/uni-registry.js.map

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

package/dist/bridge/workspace-io.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Workspace I/O — file-based communication protocol between dispatcher and agents.
+ *
+ * Design principle: agents communicate through files, not HTTP.
+ * This aligns with OpenClaw's file-driven model where each agent has a workspace
+ * directory. The dispatcher writes TASK.md, the agent reads it, executes, and
+ * writes SUBMISSION.md. Simple, debuggable, zero infrastructure.
+ *
+ * File protocol:
+ *   TASK.md       — written by dispatcher, read by agent
+ *   SUBMISSION.md — written by agent, read by dispatcher
+ */
+/**
+ * Abstract workspace I/O — can be swapped for remote, in-memory, or custom backends.
+ */
+export interface WorkspaceIO {
+    /** Write a task file to an agent's workspace */
+    writeTask(agentId: string, content: string): Promise<void>;
+    /** Read the submission from an agent's workspace. Returns null if not yet submitted. */
+    readSubmission(agentId: string): Promise<string | null>;
+    /** Remove the task file after collection */
+    clearTask(agentId: string): Promise<void>;
+    /** Remove the submission file after collection */
+    clearSubmission(agentId: string): Promise<void>;
+    /** Check if a submission exists without reading its content */
+    hasSubmission(agentId: string): Promise<boolean>;
+}
+export interface FileWorkspaceIOOptions {
+    /** Base directory for OpenClaw workspaces (default: ~/.openclaw) */
+    openclawDir?: string;
+    /** Workspace directory name pattern (default: workspace-{agentId}) */
+    workspacePattern?: string;
+}
+/**
+ * Default file-system implementation of WorkspaceIO.
+ *
+ * Reads and writes to ~/.openclaw/workspace-{agentId}/ by default.
+ */
+export declare class FileWorkspaceIO implements WorkspaceIO {
+    private readonly baseDir;
+    private readonly pattern;
+    constructor(options?: FileWorkspaceIOOptions);
+    private workspacePath;
+    writeTask(agentId: string, content: string): Promise<void>;
+    readSubmission(agentId: string): Promise<string | null>;
+    clearTask(agentId: string): Promise<void>;
+    clearSubmission(agentId: string): Promise<void>;
+    hasSubmission(agentId: string): Promise<boolean>;
+}
+/**
+ * In-memory WorkspaceIO for unit tests — no file system needed.
+ */
+export declare class MemoryWorkspaceIO implements WorkspaceIO {
+    readonly tasks: Map<string, string>;
+    readonly submissions: Map<string, string>;
+    writeTask(agentId: string, content: string): Promise<void>;
+    readSubmission(agentId: string): Promise<string | null>;
+    clearTask(agentId: string): Promise<void>;
+    clearSubmission(agentId: string): Promise<void>;
+    hasSubmission(agentId: string): Promise<boolean>;
+    /** Test helper: simulate an agent submitting work */
+    simulateSubmission(agentId: string, output: string): void;
+}
+//# sourceMappingURL=workspace-io.d.ts.map

package/dist/bridge/workspace-io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-io.d.ts","sourceRoot":"","sources":["../../src/bridge/workspace-io.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAOH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,gDAAgD;IAChD,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3D,wFAAwF;IACxF,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAExD,4CAA4C;IAC5C,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1C,kDAAkD;IAClD,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhD,+DAA+D;IAC/D,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAClD;AAOD,MAAM,WAAW,sBAAsB;IACrC,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sEAAsE;IACtE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;GAIG;AACH,qBAAa,eAAgB,YAAW,WAAW;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,GAAE,sBAA2B;IAQhD,OAAO,CAAC,aAAa;IAKf,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM1D,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAUvD,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOzC,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO/C,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAGvD;AAID;;GAEG;AACH,qBAAa,iBAAkB,YAAW,WAAW;IACnD,QAAQ,CAAC,KAAK,sBAA6B;IAC3C,QAAQ,CAAC,WAAW,sBAA6B;IAE3C,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1D,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIvD,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAItD,qDAAqD;IACrD,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAG1D"}