@agents-uni/core 0.1.0

package/dist/bridge/openclaw-adapter.d.ts

@@ -0,0 +1,49 @@
+/**
+ * OpenClaw Adapter — bridges agents-uni-core universes to OpenClaw runtime.
+ *
+ * Generates SOUL.md files, workspace structures, and registers agents
+ * in openclaw.json so they're immediately usable.
+ */
+import type { UniverseConfig } from '../types/index.js';
+import { type SoulGeneratorOptions } from './soul-generator.js';
+export interface DeployOptions {
+    /** Base directory for OpenClaw workspaces (default: ~/.openclaw) */
+    openclawDir?: string;
+    /** Path to the universe spec file (for uni-registry tracking) */
+    specPath?: string;
+    /** SOUL.md generation options */
+    soulOptions?: SoulGeneratorOptions;
+    /** Dry run — don't write files, just return what would be written */
+    dryRun?: boolean;
+    /** Skip auto-registration of agents in openclaw.json (default: false) */
+    skipRegister?: boolean;
+}
+export interface DeployResult {
+    /** Files that were written (or would be written in dry run) */
+    files: Array<{
+        path: string;
+        content: string;
+    }>;
+    /** Agents that were deployed */
+    agents: string[];
+    /** Agents that were newly registered in openclaw.json */
+    registered: string[];
+    /** Agent runtime directories created (agents/{id}/agent/) */
+    agentDirs: string[];
+    /** Universe ID registered in uni-registry */
+    uniId: string;
+    /** Warnings */
+    warnings: string[];
+}
+/**
+ * Deploy a universe spec to OpenClaw workspace structure.
+ * Generates SOUL.md files AND registers agents in openclaw.json.
+ */
+export declare function deployToOpenClaw(universe: UniverseConfig, options?: DeployOptions): DeployResult;
+/**
+ * Register universe agents in openclaw.json so OpenClaw knows about them.
+ * Reads the existing config, merges in new agents (skips duplicates), writes back.
+ * Returns the list of newly registered agent IDs.
+ */
+export declare function registerAgentsInOpenClaw(universe: UniverseConfig, openclawDir?: string): string[];
+//# sourceMappingURL=openclaw-adapter.d.ts.map

package/dist/bridge/openclaw-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openclaw-adapter.d.ts","sourceRoot":"","sources":["../../src/bridge/openclaw-adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAoB,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAGlF,MAAM,WAAW,aAAa;IAC5B,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,WAAW,CAAC,EAAE,oBAAoB,CAAC;IACnC,qEAAqE;IACrE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,yEAAyE;IACzE,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,+DAA+D;IAC/D,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChD,gCAAgC;IAChC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,yDAAyD;IACzD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,6DAA6D;IAC7D,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,eAAe;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,cAAc,EACxB,OAAO,GAAE,aAAkB,GAC1B,YAAY,CAoEd;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,cAAc,EACxB,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,EAAE,CA4DV"}

package/dist/bridge/openclaw-adapter.js

@@ -0,0 +1,151 @@
+/**
+ * OpenClaw Adapter — bridges agents-uni-core universes to OpenClaw runtime.
+ *
+ * Generates SOUL.md files, workspace structures, and registers agents
+ * in openclaw.json so they're immediately usable.
+ */
+import { mkdirSync, writeFileSync, readFileSync, existsSync } from 'node:fs';
+import { join, resolve, dirname } from 'node:path';
+import { generateAllSouls } from './soul-generator.js';
+import { registerUni } from './uni-registry.js';
+/**
+ * Deploy a universe spec to OpenClaw workspace structure.
+ * Generates SOUL.md files AND registers agents in openclaw.json.
+ */
+export function deployToOpenClaw(universe, options = {}) {
+    const openclawDir = options.openclawDir ?? join(process.env.HOME ?? process.env.USERPROFILE ?? '.', '.openclaw');
+    const souls = generateAllSouls(universe, options.soulOptions);
+    const files = [];
+    const agentDirs = [];
+    const warnings = [];
+    // Generate workspace directories, SOUL.md files, and agent runtime directories
+    for (const agent of universe.agents) {
+        const workspaceName = `workspace-${agent.id}`;
+        const workspacePath = join(openclawDir, workspaceName);
+        const soulPath = join(workspacePath, 'SOUL.md');
+        const soulContent = souls.get(agent.id) ?? '';
+        files.push({ path: soulPath, content: soulContent });
+        // Create agent runtime directory structure (agents/{id}/agent/ and sessions/)
+        // This mirrors OpenClaw's native structure: ~/.openclaw/agents/{id}/agent/
+        const agentDir = join(openclawDir, 'agents', agent.id, 'agent');
+        const sessionsDir = join(openclawDir, 'agents', agent.id, 'sessions');
+        agentDirs.push(agentDir);
+        if (!options.dryRun) {
+            mkdirSync(agentDir, { recursive: true });
+            mkdirSync(sessionsDir, { recursive: true });
+        }
+    }
+    // Generate permission matrix as a reference file
+    const permMatrixContent = generatePermissionReference(universe);
+    files.push({
+        path: join(openclawDir, `${universe.name}-permissions.md`),
+        content: permMatrixContent,
+    });
+    // Write files (unless dry run)
+    if (!options.dryRun) {
+        for (const file of files) {
+            const dir = dirname(file.path);
+            mkdirSync(dir, { recursive: true });
+            writeFileSync(file.path, file.content, 'utf-8');
+        }
+    }
+    // Auto-register agents in openclaw.json (unless dry run or explicitly skipped)
+    let registered = [];
+    if (!options.dryRun && !options.skipRegister) {
+        registered = registerAgentsInOpenClaw(universe, openclawDir);
+    }
+    // Auto-register universe in uni-registry (unless dry run)
+    if (!options.dryRun) {
+        const specPath = options.specPath ?? 'unknown';
+        registerUni(universe, resolve(specPath), openclawDir);
+    }
+    return {
+        files,
+        agents: universe.agents.map(a => a.id),
+        registered,
+        agentDirs,
+        uniId: universe.name,
+        warnings,
+    };
+}
+/**
+ * Register universe agents in openclaw.json so OpenClaw knows about them.
+ * Reads the existing config, merges in new agents (skips duplicates), writes back.
+ * Returns the list of newly registered agent IDs.
+ */
+export function registerAgentsInOpenClaw(universe, openclawDir) {
+    const dir = openclawDir ?? join(process.env.HOME ?? process.env.USERPROFILE ?? '.', '.openclaw');
+    const configPath = join(dir, 'openclaw.json');
+    // Read existing config, or create a new one if it doesn't exist
+    let config;
+    if (existsSync(configPath)) {
+        try {
+            config = JSON.parse(readFileSync(configPath, 'utf-8'));
+        }
+        catch {
+            return []; // Can't parse, don't touch it
+        }
+    }
+    else {
+        // Create a new openclaw.json with sensible defaults
+        config = {
+            version: '1.0.0',
+            agents: { list: [] },
+        };
+    }
+    // Ensure agents section exists (initialize if missing)
+    if (!config.agents) {
+        config.agents = { list: [] };
+    }
+    const agents = config.agents;
+    if (!agents.list) {
+        agents.list = [];
+    }
+    const list = agents.list;
+    const existingIds = new Set(list.map(a => a.id));
+    const newlyRegistered = [];
+    for (const agent of universe.agents) {
+        if (existingIds.has(agent.id))
+            continue; // Already registered, skip
+        const workspacePath = join(dir, `workspace-${agent.id}`);
+        const agentDir = join(dir, 'agents', agent.id, 'agent');
+        list.push({
+            id: agent.id,
+            name: agent.name,
+            workspace: workspacePath,
+            agentDir,
+        });
+        newlyRegistered.push(agent.id);
+    }
+    if (newlyRegistered.length > 0) {
+        agents.list = list;
+        config.agents = agents;
+        // Ensure the directory exists before writing
+        mkdirSync(dir, { recursive: true });
+        writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+    }
+    return newlyRegistered;
+}
+function generatePermissionReference(universe) {
+    const lines = [
+        `# ${universe.name} Permission Matrix`,
+        '',
+        `Generated from universe spec v${universe.version}`,
+        '',
+        '## Permission Entries',
+        '',
+        '| Actor | Target | Actions |',
+        '|-------|--------|---------|',
+    ];
+    for (const entry of universe.governance.permissionMatrix) {
+        lines.push(`| ${entry.actor} | ${entry.target} | ${entry.actions.join(', ')} |`);
+    }
+    lines.push('');
+    lines.push('## Review Policy');
+    lines.push('');
+    lines.push(`- Mandatory: ${universe.governance.reviewPolicy.mandatory}`);
+    lines.push(`- Reviewers: ${universe.governance.reviewPolicy.reviewers.join(', ')}`);
+    lines.push(`- Max Rounds: ${universe.governance.reviewPolicy.maxRounds}`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=openclaw-adapter.js.map

package/dist/bridge/openclaw-adapter.js.map

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

package/dist/bridge/soul-generator.d.ts

@@ -0,0 +1,34 @@
+/**
+ * SOUL.md Generator — transforms universe agent definitions into
+ * OpenClaw-compatible SOUL.md personality files.
+ *
+ * SOUL.md is the "personality template" that OpenClaw loads for each agent.
+ * It defines who the agent IS, not just what it DOES.
+ *
+ * 核心理念：每个 Agent 都围绕用户而存在。SOUL.md 不仅定义
+ * Agent 之间的关系，更重要的是定义 Agent 与用户（ruler）的关系。
+ * Agent 的存在意义是帮助用户、满足用户需求、为用户服务。
+ */
+import type { AgentDefinition, UniverseConfig } from '../types/index.js';
+export type { RulerDefinition } from '../types/index.js';
+export interface SoulGeneratorOptions {
+    /** Include relationship context in SOUL.md */
+    includeRelationships?: boolean;
+    /** Include permission information */
+    includePermissions?: boolean;
+    /** Include the agent's relationship with the user/ruler */
+    includeUserRelationship?: boolean;
+    /** Custom header to prepend */
+    header?: string;
+    /** Language for generated content */
+    language?: 'zh' | 'en';
+}
+/**
+ * Generate a SOUL.md file for an agent based on its universe definition.
+ */
+export declare function generateSoul(agent: AgentDefinition, universe: UniverseConfig, options?: SoulGeneratorOptions): string;
+/**
+ * Generate SOUL.md files for all agents in a universe.
+ */
+export declare function generateAllSouls(universe: UniverseConfig, options?: SoulGeneratorOptions): Map<string, string>;
+//# sourceMappingURL=soul-generator.d.ts.map

package/dist/bridge/soul-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"soul-generator.d.ts","sourceRoot":"","sources":["../../src/bridge/soul-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAmB,MAAM,mBAAmB,CAAC;AAG1F,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,MAAM,WAAW,oBAAoB;IACnC,8CAA8C;IAC9C,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,qCAAqC;IACrC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,2DAA2D;IAC3D,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;CACxB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,eAAe,EACtB,QAAQ,EAAE,cAAc,EACxB,OAAO,GAAE,oBAAyB,GACjC,MAAM,CAwIR;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,cAAc,EACxB,OAAO,GAAE,oBAAyB,GACjC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAMrB"}

package/dist/bridge/soul-generator.js

@@ -0,0 +1,149 @@
+/**
+ * SOUL.md Generator — transforms universe agent definitions into
+ * OpenClaw-compatible SOUL.md personality files.
+ *
+ * SOUL.md is the "personality template" that OpenClaw loads for each agent.
+ * It defines who the agent IS, not just what it DOES.
+ *
+ * 核心理念：每个 Agent 都围绕用户而存在。SOUL.md 不仅定义
+ * Agent 之间的关系，更重要的是定义 Agent 与用户（ruler）的关系。
+ * Agent 的存在意义是帮助用户、满足用户需求、为用户服务。
+ */
+/**
+ * Generate a SOUL.md file for an agent based on its universe definition.
+ */
+export function generateSoul(agent, universe, options = {}) {
+    const lang = options.language ?? 'zh';
+    const sections = [];
+    const ruler = universe.ruler;
+    // Header
+    sections.push(`# ${agent.name} (${agent.role.title})`);
+    sections.push('');
+    // Identity section — includes user relationship context
+    if (lang === 'zh') {
+        sections.push(`## 身份`);
+        sections.push(`你是 **${agent.name}**，在「${universe.name}」中担任 **${agent.role.title}**。`);
+        if (agent.role.department) {
+            sections.push(`所属部门：${agent.role.department}`);
+        }
+        if (agent.rank !== undefined) {
+            sections.push(`当前品级：${agent.rank}`);
+        }
+    }
+    else {
+        sections.push(`## Identity`);
+        sections.push(`You are **${agent.name}**, serving as **${agent.role.title}** in "${universe.name}".`);
+        if (agent.role.department) {
+            sections.push(`Department: ${agent.role.department}`);
+        }
+    }
+    sections.push('');
+    // User/Ruler relationship section — the most important relationship
+    if (options.includeUserRelationship !== false && ruler) {
+        const rulerTitle = ruler.title ?? (lang === 'zh' ? '用户' : 'the User');
+        if (lang === 'zh') {
+            sections.push(`## 与${rulerTitle}的关系`);
+            sections.push(`你的一切行为都是为了服务**${rulerTitle}**（用户）。`);
+            if (ruler.description) {
+                sections.push(`${rulerTitle}是${ruler.description.trim()}`);
+            }
+            sections.push('');
+            sections.push(`### 服务准则`);
+            sections.push(`- 你的首要目标是帮助${rulerTitle}完成任务、达成目标`);
+            sections.push(`- 主动理解${rulerTitle}的意图和需求，不仅限于字面指令`);
+            sections.push(`- 在竞争中脱颖而出，让${rulerTitle}看到你的价值`);
+            sections.push(`- 保持独特的性格和风格，让${rulerTitle}感受到你的个性`);
+        }
+        else {
+            sections.push(`## Relationship with ${rulerTitle}`);
+            sections.push(`Everything you do is in service of **${rulerTitle}** (the user).`);
+            if (ruler.description) {
+                sections.push(`${rulerTitle} is ${ruler.description.trim()}`);
+            }
+            sections.push('');
+            sections.push(`### Service Principles`);
+            sections.push(`- Your primary goal is to help ${rulerTitle} accomplish tasks and achieve goals`);
+            sections.push(`- Proactively understand ${rulerTitle}'s intent and needs, beyond literal instructions`);
+            sections.push(`- Stand out in competition to demonstrate your value to ${rulerTitle}`);
+            sections.push(`- Maintain your unique personality and style — let ${rulerTitle} feel your character`);
+        }
+        sections.push('');
+    }
+    // Duties section
+    sections.push(lang === 'zh' ? `## 核心职责` : `## Core Duties`);
+    for (let i = 0; i < agent.role.duties.length; i++) {
+        sections.push(`${i + 1}. ${agent.role.duties[i]}`);
+    }
+    sections.push('');
+    // Permissions section
+    if (options.includePermissions !== false) {
+        sections.push(lang === 'zh' ? `## 权限` : `## Permissions`);
+        sections.push(lang === 'zh' ? '你被授权执行以下操作：' : 'You are authorized to:');
+        for (const perm of agent.role.permissions) {
+            sections.push(`- ${perm}`);
+        }
+        sections.push('');
+    }
+    // Traits section
+    if (agent.traits && Object.keys(agent.traits).length > 0) {
+        sections.push(lang === 'zh' ? `## 性格特征` : `## Personality Traits`);
+        for (const [trait, value] of Object.entries(agent.traits)) {
+            const bar = '█'.repeat(Math.round(value * 10)) + '░'.repeat(10 - Math.round(value * 10));
+            sections.push(`- ${trait}: ${bar} (${(value * 100).toFixed(0)}%)`);
+        }
+        sections.push('');
+    }
+    // Relationships section (agent-to-agent)
+    if (options.includeRelationships !== false) {
+        const myRelationships = universe.relationships.filter(r => r.from === agent.id || r.to === agent.id);
+        if (myRelationships.length > 0) {
+            sections.push(lang === 'zh' ? `## 关系网络` : `## Relationships`);
+            for (const rel of myRelationships) {
+                const other = rel.from === agent.id ? rel.to : rel.from;
+                const direction = rel.from === agent.id ? '→' : '←';
+                const otherAgent = universe.agents.find(a => a.id === other);
+                const otherName = otherAgent?.name ?? other;
+                sections.push(`- ${direction} ${otherName}: ${rel.type}`);
+            }
+            sections.push('');
+        }
+    }
+    // Constraints section
+    if (agent.constraints && agent.constraints.length > 0) {
+        sections.push(lang === 'zh' ? `## 行为约束` : `## Constraints`);
+        for (const constraint of agent.constraints) {
+            sections.push(`- ⚠️ ${constraint}`);
+        }
+        sections.push('');
+    }
+    // Capabilities section
+    if (agent.capabilities && agent.capabilities.length > 0) {
+        sections.push(lang === 'zh' ? `## 可用技能` : `## Available Skills`);
+        for (const cap of agent.capabilities) {
+            sections.push(`- ${cap}`);
+        }
+        sections.push('');
+    }
+    // Universe context
+    sections.push(lang === 'zh' ? `## 组织背景` : `## Organization Context`);
+    sections.push(`- ${lang === 'zh' ? '组织' : 'Organization'}: ${universe.name} (${universe.type})`);
+    sections.push(`- ${lang === 'zh' ? '描述' : 'Description'}: ${universe.description}`);
+    sections.push(`- ${lang === 'zh' ? '治理模式' : 'Governance'}: ${universe.governance.decisionModel}`);
+    sections.push('');
+    // Custom header
+    if (options.header) {
+        sections.unshift(options.header, '');
+    }
+    return sections.join('\n');
+}
+/**
+ * Generate SOUL.md files for all agents in a universe.
+ */
+export function generateAllSouls(universe, options = {}) {
+    const souls = new Map();
+    for (const agent of universe.agents) {
+        souls.set(agent.id, generateSoul(agent, universe, options));
+    }
+    return souls;
+}
+//# sourceMappingURL=soul-generator.js.map

package/dist/bridge/soul-generator.js.map

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

package/dist/bridge/task-dispatcher.d.ts

@@ -0,0 +1,107 @@
+/**
+ * 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
+ */
+import type { WorkspaceIO } from './workspace-io.js';
+import type { EventBus } from '../core/event-bus.js';
+export interface EvaluationCriterion {
+    name: string;
+    weight: number;
+    description: string;
+}
+export interface DispatchTask {
+    /** Unique task ID */
+    id: string;
+    /** Human-readable title */
+    title: string;
+    /** Full task description for agents */
+    description: string;
+    /** Evaluation criteria (passed through to judge) */
+    criteria: EvaluationCriterion[];
+    /** Maximum time allowed for submissions (ms) */
+    timeoutMs: number;
+    /** Agent IDs that should participate */
+    participants: string[];
+    /** Optional metadata */
+    metadata?: Record<string, unknown>;
+}
+export interface AgentSubmission {
+    agentId: string;
+    output: string;
+    submittedAt: string;
+    /** Time from dispatch to submission (ms) */
+    duration: number;
+}
+export interface DispatchResult {
+    taskId: string;
+    taskTitle: string;
+    dispatchedAt: string;
+    collectedAt: string;
+    submissions: AgentSubmission[];
+    /** Agents that did not submit in time */
+    timedOut: string[];
+    /** Agents that failed during dispatch (TASK.md could not be written) */
+    dispatchFailed: string[];
+}
+export interface DispatcherOptions {
+    /** Polling interval for checking submissions (ms, default: 2000) */
+    pollIntervalMs?: number;
+    /** Whether to clean up TASK.md and SUBMISSION.md after collection (default: true) */
+    cleanup?: boolean;
+    /** Optional EventBus for emitting race lifecycle events */
+    eventBus?: EventBus;
+}
+/**
+ * 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 declare class TaskDispatcher {
+    private readonly io;
+    private readonly pollIntervalMs;
+    private readonly cleanup;
+    private readonly eventBus?;
+    constructor(io: WorkspaceIO, options?: DispatcherOptions);
+    /**
+     * 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.
+     */
+    dispatch(task: DispatchTask): Promise<string[]>;
+    /**
+     * Collect submissions from participants, polling until timeout.
+     * Returns all collected submissions and which agents timed out.
+     */
+    collect(task: DispatchTask, dispatchedAt: string, excludeAgents?: string[]): Promise<DispatchResult>;
+    /**
+     * 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`.
+     */
+    run(task: DispatchTask): Promise<DispatchResult>;
+}
+//# sourceMappingURL=task-dispatcher.d.ts.map

package/dist/bridge/task-dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-dispatcher.d.ts","sourceRoot":"","sources":["../../src/bridge/task-dispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAIrD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,qBAAqB;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,eAAe,EAAE,CAAC;IAC/B,yCAAyC;IACzC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,wEAAwE;IACxE,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,oEAAoE;IACpE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qFAAqF;IACrF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAqDD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAc;IACjC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAW;gBAEzB,EAAE,EAAE,WAAW,EAAE,OAAO,GAAE,iBAAsB;IAO5D;;;;OAIG;IACG,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA0CrD;;;OAGG;IACG,OAAO,CACX,IAAI,EAAE,YAAY,EAClB,YAAY,EAAE,MAAM,EACpB,aAAa,GAAE,MAAM,EAAO,GAC3B,OAAO,CAAC,cAAc,CAAC;IAoF1B;;;;;;OAMG;IACG,GAAG,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC;CAiBvD"}