@bolloon/bolloon-agent 0.3.51 → 0.4.0

package/dist/llm/tool-manifest/fetch_sports_data.js

@@ -18,9 +18,9 @@ export const fetch_sports_data = {
         { name: 'league', type: 'enum', required: true, description: 'nfl/nba/nhl/mlb/wnba/ncaafb/ncaamb/ncaawb/epl/la_liga/serie_a/bundesliga/ligue_1/mls/champions_league/tennis/golf/nascar/cricket/mma', enumValues: ['nfl', 'nba', 'nhl', 'mlb', 'wnba', 'ncaafb', 'ncaamb', 'ncaawb', 'epl', 'la_liga', 'serie_a', 'bundesliga', 'ligue_1', 'mls', 'champions_league', 'tennis', 'golf', 'nascar', 'cricket', 'mma'] },
         { name: 'team', type: 'string', required: false, description: '可选的球队名称' },
     ],
-    callExample: `[TOOL:fetch_sports_data]
-[P:data_type]scores
-[P:league]nba
+    callExample: `[TOOL:fetch_sports_data]
+[P:data_type]scores
+[P:league]nba
 [ENDTOOL]`,
     layerId: 'tool.manifest',
 };

package/dist/llm/tool-manifest/image_search.js

@@ -17,8 +17,8 @@ export const image_search = {
         { name: 'max_results', type: 'integer', required: false, description: '返回图片数 (默认 3, 最少 3, 最多 5)', minimum: 3, maximum: 5, default: 3 },
         { name: 'query', type: 'string', required: true, description: '搜索查询 (3-6 词具体)' },
     ],
-    callExample: `[TOOL:image_search]
-[P:query]Eiffel Tower Paris
+    callExample: `[TOOL:image_search]
+[P:query]Eiffel Tower Paris
 [ENDTOOL]`,
     layerId: 'tool.image_search',
 };

package/dist/llm/tool-manifest/index.js

@@ -48,65 +48,6 @@ export function getToolsByLayer(layerId) {
  *
  * 不包含: 完整 parameters schema (那是 PiAI 客户端在调用时读)
  */
-/**
- * 把 ToolManifest 转成 OpenAI function calling 格式 (tools 数组)
- * 用于 native tool_choice: "auto" 模式, 让 LLM 选择调用.
- *
- * 注意: 递归处理嵌套参数 (type='object' 的 properties / type='array' 的 items)
- */
-export function formatForOpenAI(tools) {
-    const list = tools ?? ALL;
-    return list.map((t) => {
-        const properties = {};
-        const required = [];
-        for (const p of t.parameters) {
-            properties[p.name] = convertParameter(p);
-            if (p.required)
-                required.push(p.name);
-        }
-        return {
-            type: 'function',
-            function: {
-                name: t.id,
-                description: t.oneLine,
-                parameters: {
-                    type: 'object',
-                    properties,
-                    required,
-                },
-            },
-        };
-    });
-}
-function convertParameter(p) {
-    const schema = { type: p.type === 'enum' ? 'string' : p.type };
-    if (p.description)
-        schema.description = p.description;
-    if (p.enumValues)
-        schema.enum = p.enumValues;
-    if (p.default !== undefined)
-        schema.default = p.default;
-    if (p.minimum !== undefined)
-        schema.minimum = p.minimum;
-    if (p.maximum !== undefined)
-        schema.maximum = p.maximum;
-    if (p.format)
-        schema.format = p.format;
-    if (p.type === 'object' && p.properties) {
-        schema.properties = {};
-        for (const sub of p.properties) {
-            schema.properties[sub.name] = convertParameter(sub);
-        }
-    }
-    if (p.type === 'array' && p.items) {
-        schema.items = convertParameter(p.items);
-        if (p.minItems !== undefined)
-            schema.minItems = p.minItems;
-        if (p.maxItems !== undefined)
-            schema.maxItems = p.maxItems;
-    }
-    return schema;
-}
 export function formatForPrompt(tools) {
     const list = tools ?? ALL;
     const lines = [

package/dist/llm/tool-manifest/mcp.js

@@ -15,7 +15,7 @@ export const search_mcp_registry = {
     parameters: [
         { name: 'keywords', type: 'array', required: true, description: '搜索关键词', minItems: 1, items: { name: 'kw', type: 'string', required: true, description: '关键词' } }
     ],
-    callExample: `[TOOL:search_mcp_registry]
+    callExample: `[TOOL:search_mcp_registry]
 [P:keywords]${'${'}JSON.stringify(["calendar","schedule"])[ENDTOOL]`,
     layerId: 'tool.mcp_apps',
 };
@@ -37,7 +37,7 @@ export const suggest_connectors = {
     parameters: [
         { name: 'uuids', type: 'array', required: true, description: '从 search_mcp_registry 结果的 directoryUuid 复制', minItems: 1, items: { name: 'u', type: 'string', required: true, description: 'uuid' } }
     ],
-    callExample: `[TOOL:suggest_connectors]
+    callExample: `[TOOL:suggest_connectors]
 [P:uuids]${'${'}JSON.stringify(["uuid-from-search-result"])[ENDTOOL]`,
     layerId: 'tool.mcp_apps',
 };

package/dist/llm/tool-manifest/message_compose.js

@@ -23,9 +23,9 @@ export const message_compose_v1 = {
                 ],
             } },
     ],
-    callExample: `[TOOL:message_compose_v1]
-[P:kind]email
-[P:summary_title]Follow-up on Q3 review
+    callExample: `[TOOL:message_compose_v1]
+[P:kind]email
+[P:summary_title]Follow-up on Q3 review
 [P:variants]${'${'}JSON.stringify([{"label":"direct","subject":"Quick follow-up","body":"..."}])[ENDTOOL]`,
     layerId: 'tool.manifest',
 };

package/dist/llm/tool-manifest/places.js

@@ -23,7 +23,7 @@ export const places_search = {
         { name: 'location_bias_lng', type: 'number', required: false, description: '可选经度' },
         { name: 'location_bias_radius', type: 'number', required: false, description: '米 (默认 5000)', default: 5000 }
     ],
-    callExample: `[TOOL:places_search]
+    callExample: `[TOOL:places_search]
 [P:queries]${'${'}JSON.stringify([{"query":"ramen restaurants Tokyo"}])[ENDTOOL]`,
     layerId: 'tool.manifest',
 };
@@ -77,7 +77,7 @@ export const places_map_display_v0 = {
         { name: 'title', type: 'string', required: false, description: '行程标题' },
         { name: 'narrative', type: 'string', required: false, description: '行程叙述' },
     ],
-    callExample: `[TOOL:places_map_display_v0]
+    callExample: `[TOOL:places_map_display_v0]
 [P:locations]${'${'}JSON.stringify([{"name":"Senso-ji","latitude":35.7148,"longitude":139.7967,"place_id":"ChIJ..."}])[ENDTOOL]`,
     layerId: 'tool.manifest',
 };

package/dist/llm/tool-manifest/present_files.js

@@ -15,7 +15,7 @@ export const present_files = {
     parameters: [
         { name: 'filepaths', type: 'array', required: true, description: '至少 1 个文件路径', minItems: 1, items: { name: 'path', type: 'string', required: true, description: '容器内路径' } },
     ],
-    callExample: `[TOOL:present_files]
+    callExample: `[TOOL:present_files]
 [P:filepaths]${'${'}JSON.stringify(["/home/bolloon/report.md"])[ENDTOOL]`,
     layerId: 'tool.manifest',
 };

package/dist/llm/tool-manifest/recipe.js

@@ -33,8 +33,8 @@ export const recipe_display_v0 = {
             } },
         { name: 'notes', type: 'string', required: false, description: '附加说明' },
     ],
-    callExample: `[TOOL:recipe_display_v0]
-[P:title]Pasta
+    callExample: `[TOOL:recipe_display_v0]
+[P:title]Pasta
 [P:ingredients]${'${'}JSON.stringify([{"id":"a1","amount":500,"name":"pasta"}])[ENDTOOL]`,
     layerId: 'tool.manifest',
 };

package/dist/llm/tool-manifest/str_replace.js

@@ -17,11 +17,11 @@ export const str_replace = {
         { name: 'new_str', type: 'string', required: true, description: '新字符串 (空字符串 = 删除)', default: '' },
         { name: 'path', type: 'string', required: true, description: '文件路径' },
     ],
-    callExample: `[TOOL:str_replace]
-[P:description]修复 typo
-[P:old_str]recieve
-[P:new_str]receive
-[P:path]/home/bolloon/main.py
+    callExample: `[TOOL:str_replace]
+[P:description]修复 typo
+[P:old_str]recieve
+[P:new_str]receive
+[P:path]/home/bolloon/main.py
 [ENDTOOL]`,
     layerId: 'tool.manifest',
 };

package/dist/llm/tool-manifest/view.js

@@ -16,9 +16,9 @@ export const view = {
         { name: 'path', type: 'string', required: true, description: '绝对路径' },
         { name: 'view_range', type: 'array', required: false, description: '[start, end] 1-indexed, end=-1 表示到末尾', minItems: 2, maxItems: 2, items: { name: 'r', type: 'integer', required: true, description: '行号' } }
     ],
-    callExample: `[TOOL:view]
-[P:description]读 README
-[P:path]/home/bolloon/README.md
+    callExample: `[TOOL:view]
+[P:description]读 README
+[P:path]/home/bolloon/README.md
 [ENDTOOL]`,
     layerId: 'tool.manifest',
 };

package/dist/llm/tool-manifest/weather.js

@@ -18,10 +18,10 @@ export const weather_fetch = {
         { name: 'latitude', type: 'number', required: true, description: '纬度' },
         { name: 'longitude', type: 'number', required: true, description: '经度' },
     ],
-    callExample: `[TOOL:weather_fetch]
-[P:location_name]San Francisco, CA
-[P:latitude]37.78
-[P:longitude]-122.41
+    callExample: `[TOOL:weather_fetch]
+[P:location_name]San Francisco, CA
+[P:latitude]37.78
+[P:longitude]-122.41
 [ENDTOOL]`,
     layerId: 'tool.manifest',
 };

package/dist/llm/tool-manifest/web.js

@@ -15,8 +15,8 @@ export const web_search = {
     parameters: [
         { name: 'query', type: 'string', required: true, description: '搜索查询 (1-6 词最佳)' },
     ],
-    callExample: `[TOOL:web_search]
-[P:query]S&P 500 current price
+    callExample: `[TOOL:web_search]
+[P:query]S&P 500 current price
 [ENDTOOL]`,
     layerId: 'tool.web_search',
 };
@@ -44,8 +44,8 @@ export const web_fetch = {
         { name: 'web_fetch_rate_limit_key', type: 'string', required: false, description: '速率限制键' },
         { name: 'web_fetch_rate_limit_dark_launch', type: 'boolean', required: false, description: '速率限制暗启动模式' },
     ],
-    callExample: `[TOOL:web_fetch]
-[P:url]https://example.com/article
+    callExample: `[TOOL:web_fetch]
+[P:url]https://example.com/article
 [ENDTOOL]`,
     layerId: 'tool.manifest',
 };

package/dist/locales/en.js

@@ -0,0 +1,28 @@
+/**
+ * locales/en.ts — English catalog (source of truth)
+ *
+ * 范围纪律 (Hermes i18n): 只放用户可见静态消息 (审批/护栏/任务系统广播);
+ * agent 输出/日志/报错不翻译。
+ */
+export const catalog = {
+    guard: {
+        deny_reason: 'Command hit high-risk guard {pattern} (core untouched: privilege escalation / format / delete root / .bolloon data). Try a safer command.',
+        self_lifecycle_reason: 'Command would restart or kill the bolloon host service (pattern {pattern}) — this creates a supervisor revival loop. Not allowed.',
+        empty: 'Empty command',
+    },
+    tasks: {
+        cancelled: 'Task cancelled: {title}',
+        review_pending: 'Task finished execution, awaiting review: {title}',
+        approved: 'Task approved: {title}',
+        rejected: 'Task rejected, back to queue: {title}',
+        failed: 'Task failed: {message}',
+        failed_retry: 'Task failed: {message} (auto-retry)',
+        parents_undone: 'Task parents not done ({parents}) — cannot execute until parents finish',
+        breaker_tripped: 'Failed {count} times consecutively, circuit broken (no auto-retry): {message}',
+    },
+    claim: {
+        busy: 'Another task is currently executing',
+        not_claimable: 'Task not claimable (status={status})',
+        released: '[task-claim] reclaimed {count} stale claim(s)',
+    },
+};

package/dist/locales/zh.js

@@ -0,0 +1,26 @@
+/**
+ * locales/zh.ts — 中文目录 (默认语言)
+ * 键集合与占位符必须与 en.ts 一致 — parity 测试断言 (Hermes test_i18n.py 模式).
+ */
+export const catalog = {
+    guard: {
+        deny_reason: '命令命中高危护栏 {pattern} (核心不碰: 提权/格式化/删根/.bolloon 数据). 换一条安全命令.',
+        self_lifecycle_reason: '命令会重启或杀死 bolloon 宿主服务 (模式 {pattern}) — 会形成 supervisor 复活循环, 不允许.',
+        empty: '命令为空',
+    },
+    tasks: {
+        cancelled: '任务已取消: {title}',
+        review_pending: '任务执行完成, 待审批: {title}',
+        approved: '任务审批通过: {title}',
+        rejected: '任务审批驳回, 退回队列: {title}',
+        failed: '任务执行失败: {message}',
+        failed_retry: '任务执行失败: {message} (自动重试)',
+        parents_undone: '任务父依赖未完成 ({parents}) — 父任务完成后才能执行',
+        breaker_tripped: '连续失败 {count} 次, 熔断 (不再自动重试): {message}',
+    },
+    claim: {
+        busy: '另一个任务正在执行',
+        not_claimable: '任务不可认领 (status={status})',
+        released: '[task-claim] 已回收 {count} 个过期认领',
+    },
+};

package/dist/pi-ecosystem-colony/index.js

@@ -0,0 +1,365 @@
+/**
+ * Pi Ant Colony Integration for Bolloon
+ *
+ * Multi-agent collaboration system with white-box signal protocol.
+ * Based on oh-pi's ant colony system: COLONY_SIGNAL protocol for agent coordination.
+ *
+ * Signal Protocol:
+ * COLONY_SIGNAL:LAUNCHED → SCOUTING → WORKING → REVIEWING → COMPLETE
+ *
+ * Key features:
+ * - Fully visible signal protocol (no black boxes)
+ * - Per-ant turn limits, cost tracking, concurrent scheduling
+ * - White-box design: no "what is it doing in the background" anxiety
+ */
+import { EventEmitter } from 'events';
+import * as fs from 'fs/promises';
+import * as path from 'path';
+// Colony state
+const ants = new Map();
+const tasks = new Map();
+const signalHistory = [];
+const STATE_DIR = path.join(process.env.HOME || '/tmp', '.bolloon', 'colony');
+// Event emitter
+class ColonyEventEmitter extends EventEmitter {
+}
+const colonyEvents = new ColonyEventEmitter();
+/**
+ * Generate a unique ant ID
+ */
+function generateAntId() {
+    return `ant-${Date.now()}-${Math.random().toString(36).substring(2, 8)}`;
+}
+/**
+ * Register a new ant in the colony
+ */
+export function registerAnt(name, role, maxTurns = 10, tokenBudget = 50000) {
+    const id = generateAntId();
+    const ant = {
+        id,
+        name,
+        role,
+        signal: 'LAUNCHED',
+        turnCount: 0,
+        maxTurns,
+        tokenBudget,
+        tokensUsed: 0,
+        createdAt: new Date().toISOString(),
+        updatedAt: new Date().toISOString(),
+    };
+    ants.set(id, ant);
+    emitSignal(id, 'LAUNCHED');
+    console.log(`[Colony] Registered ant: ${name} (${role})`);
+    return ant;
+}
+/**
+ * Emit a signal transition
+ */
+function emitSignal(antId, newSignal, details) {
+    const ant = ants.get(antId);
+    if (!ant)
+        return;
+    const event = {
+        antId,
+        antName: ant.name,
+        fromSignal: ant.signal,
+        toSignal: newSignal,
+        timestamp: new Date().toISOString(),
+        details,
+    };
+    signalHistory.push(event);
+    if (signalHistory.length > 100) {
+        signalHistory.shift();
+    }
+    ant.signal = newSignal;
+    ant.updatedAt = new Date().toISOString();
+    ants.set(antId, ant);
+    colonyEvents.emit('signal', event);
+    console.log(`[Colony] ${ant.name}: ${event.fromSignal} → ${event.toSignal}${details ? ` (${details})` : ''}`);
+}
+/**
+ * Transition ant to SCOUTING
+ */
+export function antScouting(antId, task) {
+    const ant = ants.get(antId);
+    if (!ant)
+        return;
+    ant.task = task;
+    ants.set(antId, ant);
+    emitSignal(antId, 'SCOUTING', `Task: ${task.substring(0, 50)}...`);
+}
+/**
+ * Transition ant to WORKING
+ */
+export function antWorking(antId) {
+    const ant = ants.get(antId);
+    if (!ant)
+        return;
+    emitSignal(antId, 'WORKING');
+}
+/**
+ * Transition ant to REVIEWING
+ */
+export function antReviewing(antId) {
+    emitSignal(antId, 'REVIEWING');
+}
+/**
+ * Complete ant work
+ */
+export function antComplete(antId, result) {
+    const ant = ants.get(antId);
+    if (!ant)
+        return;
+    ant.result = result;
+    ants.set(antId, ant);
+    emitSignal(antId, 'COMPLETE', `Result: ${result.substring(0, 50)}...`);
+}
+/**
+ * Fail ant work
+ */
+export function antFail(antId, error) {
+    const ant = ants.get(antId);
+    if (!ant)
+        return;
+    ant.result = error;
+    ants.set(antId, ant);
+    emitSignal(antId, 'FAILED', error);
+}
+/**
+ * Abort ant work
+ */
+export function antAbort(antId, reason) {
+    emitSignal(antId, 'ABORTED', reason);
+}
+/**
+ * Increment turn count
+ */
+export function antTick(antId, tokensUsed = 0) {
+    const ant = ants.get(antId);
+    if (!ant)
+        return;
+    ant.turnCount++;
+    ant.tokensUsed += tokensUsed;
+    ant.updatedAt = new Date().toISOString();
+    ants.set(antId, ant);
+    // Check if exceeded limits
+    if (ant.turnCount >= ant.maxTurns) {
+        antAbort(antId, 'Max turns exceeded');
+    }
+    else if (ant.tokensUsed >= ant.tokenBudget) {
+        antAbort(antId, 'Token budget exceeded');
+    }
+}
+/**
+ * Create a colony task
+ */
+export function createTask(description) {
+    const id = `task-${Date.now()}-${Math.random().toString(36).substring(2, 8)}`;
+    const task = {
+        id,
+        description,
+        status: 'pending',
+        assignedAnts: [],
+        results: new Map(),
+        createdAt: new Date().toISOString(),
+    };
+    tasks.set(id, task);
+    console.log(`[Colony] Created task: ${id} - ${description.substring(0, 50)}...`);
+    return task;
+}
+/**
+ * Dispatch task to ants
+ */
+export function dispatchTask(taskId, antIds) {
+    const task = tasks.get(taskId);
+    if (!task)
+        return;
+    task.status = 'dispatched';
+    task.assignedAnts = antIds;
+    tasks.set(taskId, task);
+    for (const antId of antIds) {
+        const ant = ants.get(antId);
+        if (ant) {
+            antScouting(antId, task.description);
+        }
+    }
+    console.log(`[Colony] Dispatched task ${taskId} to ${antIds.length} ants`);
+}
+/**
+ * Record ant result for a task
+ */
+export function recordResult(taskId, antId, result) {
+    const task = tasks.get(taskId);
+    if (!task)
+        return;
+    task.results.set(antId, result);
+    // Check if all ants completed
+    if (task.results.size === task.assignedAnts.length) {
+        task.status = 'completed';
+        task.completedAt = new Date().toISOString();
+        for (const id of task.assignedAnts) {
+            antReviewing(id);
+        }
+    }
+    tasks.set(taskId, task);
+}
+/**
+ * Get ant by ID
+ */
+export function getAnt(antId) {
+    return ants.get(antId);
+}
+/**
+ * List all ants
+ */
+export function listAnts() {
+    return Array.from(ants.values());
+}
+/**
+ * List ants by role
+ */
+export function listAntsByRole(role) {
+    return Array.from(ants.values()).filter((a) => a.role === role);
+}
+/**
+ * Get ants by signal state
+ */
+export function listAntsBySignal(signal) {
+    return Array.from(ants.values()).filter((a) => a.signal === signal);
+}
+/**
+ * Get active ants (not complete/failed/aborted)
+ */
+export function getActiveAnts() {
+    return Array.from(ants.values()).filter((a) => !['COMPLETE', 'FAILED', 'ABORTED'].includes(a.signal));
+}
+/**
+ * Get task by ID
+ */
+export function getTask(taskId) {
+    return tasks.get(taskId);
+}
+/**
+ * List all tasks
+ */
+export function listTasks() {
+    return Array.from(tasks.values());
+}
+/**
+ * Get signal history
+ */
+export function getSignalHistory() {
+    return [...signalHistory];
+}
+/**
+ * Get colony status
+ */
+export function getColonyStatus() {
+    const antList = Array.from(ants.values());
+    const taskList = Array.from(tasks.values());
+    const signalDistribution = {
+        LAUNCHED: 0,
+        SCOUTING: 0,
+        WORKING: 0,
+        REVIEWING: 0,
+        COMPLETE: 0,
+        FAILED: 0,
+        ABORTED: 0,
+    };
+    for (const ant of antList) {
+        signalDistribution[ant.signal]++;
+    }
+    return {
+        antCount: antList.length,
+        activeAnts: antList.filter((a) => !['COMPLETE', 'FAILED', 'ABORTED'].includes(a.signal)).length,
+        taskCount: taskList.length,
+        activeTasks: taskList.filter((t) => t.status === 'in_progress' || t.status === 'dispatched').length,
+        signalDistribution,
+    };
+}
+/**
+ * Subscribe to colony events
+ */
+export function onColonyEvent(event, callback) {
+    colonyEvents.on(event, callback);
+}
+/**
+ * Unsubscribe from colony events
+ */
+export function offColonyEvent(event, callback) {
+    colonyEvents.off(event, callback);
+}
+/**
+ * Get formatted colony dump for debugging
+ */
+export function getColonyDump() {
+    const status = getColonyStatus();
+    const active = getActiveAnts();
+    let dump = '# Colony Status\n\n';
+    dump += `Ants: ${status.antCount} total, ${status.activeAnts} active\n`;
+    dump += `Tasks: ${status.taskCount} total, ${status.activeTasks} active\n\n`;
+    dump += '## Signal Distribution\n';
+    for (const [signal, count] of Object.entries(status.signalDistribution)) {
+        if (count > 0) {
+            dump += `- ${signal}: ${count}\n`;
+        }
+    }
+    dump += '\n## Active Ants\n';
+    for (const ant of active) {
+        dump += `- ${ant.name} (${ant.role}): ${ant.signal} [${ant.turnCount}/${ant.maxTurns} turns, ${ant.tokensUsed}/${ant.tokenBudget} tokens]\n`;
+        if (ant.task) {
+            dump += `  Task: ${ant.task.substring(0, 60)}...\n`;
+        }
+    }
+    dump += '\n## Recent Signals\n';
+    const recent = signalHistory.slice(-10);
+    for (const event of recent.reverse()) {
+        dump += `- ${event.timestamp}: ${event.antName}: ${event.fromSignal} → ${event.toSignal}\n`;
+    }
+    return dump;
+}
+/**
+ * Persist colony state
+ */
+export async function persistColony() {
+    try {
+        await fs.mkdir(STATE_DIR, { recursive: true });
+        const state = {
+            ants: Array.from(ants.values()),
+            tasks: Array.from(tasks.entries()).map(([id, t]) => ({
+                ...t,
+                results: Array.from(t.results.entries()),
+            })),
+            signalHistory: signalHistory.slice(-50),
+            persistedAt: new Date().toISOString(),
+        };
+        await fs.writeFile(path.join(STATE_DIR, 'colony.json'), JSON.stringify(state, null, 2));
+        console.log('[Colony] Persisted state');
+    }
+    catch (e) {
+        console.warn('[Colony] Failed to persist:', e);
+    }
+}
+/**
+ * Load colony state
+ */
+export async function loadColony() {
+    try {
+        const data = await fs.readFile(path.join(STATE_DIR, 'colony.json'), 'utf-8');
+        const state = JSON.parse(data);
+        ants.clear();
+        for (const a of state.ants) {
+            ants.set(a.id, a);
+        }
+        tasks.clear();
+        for (const t of state.tasks) {
+            tasks.set(t.id, { ...t, results: new Map(t.results) });
+        }
+        signalHistory.length = 0;
+        signalHistory.push(...state.signalHistory);
+        console.log(`[Colony] Loaded ${ants.size} ants, ${tasks.size} tasks`);
+    }
+    catch {
+        // No persisted state
+    }
+}