hive-am 1.4.0 → 1.6.0

package/server/dist/skills/notebook.js

@@ -1,11 +1,13 @@
+import { randomUUID } from 'node:crypto';
 import { db } from '../db.js';
 import { DomainError } from '../errors.js';
 /**
- * An agent's notebook: Markdown it keeps for itself across conversations (see the «Notebook» default skill).
- * Lives in its own table so it never travels with the agent list. Every change bumps `version`; `seen` is the version the
- * agent's live conversation already contains, so the runtime knows when it must be re-sent (e.g. after the user edits it).
+ * A notebook: Markdown an agent keeps for itself across conversations (see the «Notebook» default skill). It is an object of its own with
+ * readers (`notebooks` and `notebook_readers`, created by db/migrations.ts): an agent and the clones made from it read and write the same one, and
+ * it goes away only with its last reader. It lives in its own table so it never travels with the agent list. Every change bumps `version`;
+ * `seen` belongs to the reader: it is the version that agent's live conversation already contains, so the runtime knows when the text must be
+ * re-sent to it (e.g. after the user, or another agent that shares the notebook, changed it).
  */
-// The table (agent_notebooks) is created by db/migrations.ts.
 /** It is prompt overhead on every turn, so it has a hard cap. */
 export const NOTEBOOK_MAX = 8000;
 const NOTE_MAX = 500;
@@ -37,19 +39,61 @@ const refuseSecret = (text) => {
         throw new NotebookError(`That looks like ${what}. Credentials are never stored in the notebook: leave it out (or describe where it lives, not its value).`);
 };
 const empty = () => ({ content: '', version: 0, seen: 0, updated_at: 0, updated_by: '' });
+/** The notebook an agent reads, with that agent's own `seen`. */
+const readerRow = (agentId) => db.prepare(`SELECT n.id, n.content, n.version, r.seen, n.updated_at, n.updated_by FROM notebook_readers r JOIN notebooks n ON n.id = r.notebook_id WHERE r.agent_id = ?`).get(agentId);
+/** The notebook the agent reads, created empty (version 0) when it has none yet. */
+function ensure(agentId) {
+    let row = readerRow(agentId);
+    if (!row) {
+        const id = randomUUID();
+        db.prepare('INSERT INTO notebooks (id) VALUES (?)').run(id);
+        db.prepare('INSERT INTO notebook_readers (agent_id, notebook_id, seen) VALUES (?,?,0)').run(agentId, id);
+        row = readerRow(agentId);
+    }
+    return row;
+}
 export const notebooks = {
-    get: (agentId) => db.prepare('SELECT content,version,seen,updated_at,updated_by FROM agent_notebooks WHERE agent_id=?').get(agentId) ?? empty(),
+    get: (agentId) => { const r = readerRow(agentId); return r ? { content: r.content, version: r.version, seen: r.seen, updated_at: r.updated_at, updated_by: r.updated_by } : empty(); },
+    /** The other agents that read the same notebook (empty for an ordinary notebook). */
+    sharedWith(agentId) {
+        const r = readerRow(agentId);
+        if (!r)
+            return [];
+        return db.prepare('SELECT a.id, a.name FROM notebook_readers x JOIN agents a ON a.id = x.agent_id WHERE x.notebook_id = ? AND x.agent_id <> ? ORDER BY a.name').all(r.id, agentId);
+    },
     /** The agent (or the user) replaced the text. `live`: the change happened inside the conversation the agent is running now. */
-    save(agentId, content, by, live) {
-        const cur = notebooks.get(agentId), version = cur.version + 1, t = Date.now();
-        const seen = live ? version : cur.seen;
-        db.prepare(`INSERT INTO agent_notebooks (agent_id,content,version,seen,updated_at,updated_by) VALUES (?,?,?,?,?,?)
-      ON CONFLICT(agent_id) DO UPDATE SET content=excluded.content, version=excluded.version, seen=excluded.seen, updated_at=excluded.updated_at, updated_by=excluded.updated_by`)
-            .run(agentId, content, version, seen, t, by);
+    save: db.transaction((agentId, content, by, live) => {
+        const row = ensure(agentId); // an agent that never had one gets its own
+        const version = row.version + 1;
+        db.prepare('UPDATE notebooks SET content=?, version=?, updated_at=?, updated_by=? WHERE id=?').run(content, version, Date.now(), by, row.id);
+        // Only the writer's own conversation already contains what it just wrote; the other readers are sent it on their next turn.
+        if (live)
+            db.prepare('UPDATE notebook_readers SET seen=? WHERE agent_id=?').run(version, agentId);
         return notebooks.get(agentId);
-    },
+    }),
     /** The runtime sent version `v` to the agent's conversation. */
-    markSeen: (agentId, v) => { db.prepare('UPDATE agent_notebooks SET seen=MAX(seen, ?) WHERE agent_id=?').run(v, agentId); },
+    markSeen: (agentId, v) => { db.prepare('UPDATE notebook_readers SET seen=MAX(seen, ?) WHERE agent_id=?').run(v, agentId); },
+    /**
+     * `to` starts reading the notebook of `from` (a clone sharing its source's notes): `from` gets one if it had none, and what `to` read before
+     * is dropped with its last reader. Its `seen` starts at 0, so its first turn is sent the text.
+     */
+    share: db.transaction((fromId, toId) => {
+        if (fromId === toId)
+            return;
+        const nb = ensure(fromId);
+        db.prepare('INSERT INTO notebook_readers (agent_id, notebook_id, seen) VALUES (?,?,0) ON CONFLICT(agent_id) DO UPDATE SET notebook_id=excluded.notebook_id, seen=0').run(toId, nb.id);
+        db.prepare('DELETE FROM notebooks WHERE id NOT IN (SELECT notebook_id FROM notebook_readers)').run(); // what `to` read before, if nobody else does
+    }),
+    /** Gives the agent its own copy of the notebook it shares, and leaves the shared one with the others. Does nothing for an agent that shares nothing. */
+    separate: db.transaction((agentId) => {
+        const row = readerRow(agentId);
+        if (!row || !notebooks.sharedWith(agentId).length)
+            return notebooks.get(agentId);
+        const id = randomUUID();
+        db.prepare('INSERT INTO notebooks (id, content, version, updated_at, updated_by) VALUES (?,?,?,?,?)').run(id, row.content, row.version, row.updated_at, row.updated_by);
+        db.prepare('UPDATE notebook_readers SET notebook_id=? WHERE agent_id=?').run(id, agentId); // `seen` stays: it still describes what this agent's conversation holds
+        return notebooks.get(agentId);
+    }),
     /** Edit from the UI. `version` (when given) must be the one the user was looking at. */
     edit(agentId, content, version) {
         const text = content.replace(/\r\n/g, '\n').trimEnd();

package/server/dist/watch.js

@@ -134,7 +134,7 @@ async function noticeNow(w, reason) {
             ? (es ? `Apareció el archivo que esperabas (${dur}). Reviso el resultado…` : `The file you were waiting for appeared (${dur}). Checking the result…`)
             : (es ? `Terminó el proceso que esperabas (PID ${w.pid}, ${dur}). Reviso el resultado…` : `The process you were waiting for (PID ${w.pid}) has finished (${dur}). Checking the result…`);
         const msg = `🔔 ${who}${body}`;
-        const { externalId } = await adapter.send(thread.target, msg);
+        const { externalId } = await adapter.send(adapter.proactive?.(thread.target) ?? thread.target, msg);
         threadMessages.record(thread.id, 'out', externalId, { name: agents.get(w.agent_id)?.name }, msg);
     }
     catch (e) {

package/server/mcp/dispatch.mjs

@@ -1,15 +1,18 @@
 #!/usr/bin/env node
 // Minimal MCP stdio server for hive-am agents. Tool groups come from HIVE_CAPS:
-//   dispatch → list_agents, dispatch (orchestrators with a team)
+//   dispatch → list_agents, dispatch, dispatch_status (orchestrators with a team)
 //   channel  → channel_reply, channel_send_file, channel_react, channel_mute (agents linked to Telegram/Slack)
 //   wake     → wake_me, wake_when_done, schedule_create, schedule_list, schedule_cancel (agents with the Wake-ups skill: to be woken later in the same place)
 //   objects  → object_list, object_logs, object_action (agents with the Colony objects skill: the servers and containers of their colony)
+//   databases → object_db_* (agents with the Database management skill: the database resources of their colony)
 // It only talks to the hive-am HTTP API; all rules (assignments, queueing) live there.
 import { createInterface } from 'node:readline';
 
 const API = process.env.HIVE_AM_API ?? 'http://127.0.0.1:4400';
 const FROM = process.env.HIVE_AGENT_ID;
 const CAPS = new Set((process.env.HIVE_CAPS ?? 'dispatch').split(',').filter(Boolean));
+// A synchronous dispatch waits with dispatch_status calls of this many seconds each, so no request lasts long enough to hit a client timeout.
+const POLL_S = Math.min(60, Math.max(1, Number(process.env.HIVE_AM_DISPATCH_POLL_S) || 25));
 
 const allTools = [
   {
@@ -21,17 +24,32 @@ const allTools = [
   {
     cap: 'dispatch',
     name: 'dispatch',
-    description: 'Send a self-contained task to one of your subagents and wait for its final answer. Every delegation starts a fresh conversation for the subagent, so include all the context it needs.',
+    description: 'Send a self-contained task to one of your subagents. By default the call returns at once with a task id and the answer arrives later as a message to you (you can also ask with dispatch_status), so you can answer the person or delegate more meanwhile. Set background: false only for a very short task whose answer you need right now: the call then waits for the final answer. Every delegation starts a fresh conversation for the subagent, so include all the context it needs.',
     inputSchema: {
       type: 'object',
       properties: {
         agent: { type: 'string', description: 'Exact subagent name from list_agents' },
         task: { type: 'string', description: 'Full instructions for the subagent; include all context it needs.' },
+        background: { type: 'boolean', description: 'Return at once with a task id (default true). The result is sent to you as a message when the subagent finishes. Set false to wait for the final answer in this call.' },
       },
       required: ['agent', 'task'],
       additionalProperties: false,
     },
   },
+  {
+    cap: 'dispatch',
+    name: 'dispatch_status',
+    description: 'State of a task you delegated: queued, running, done, failed or interrupted, with the result once it has finished. With wait_seconds it waits up to that long for the end before answering.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: { type: 'string', description: 'The task id that dispatch returned' },
+        wait_seconds: { type: 'number', minimum: 0, maximum: 60, description: 'Wait up to this many seconds (0 to 60, default 0) for the task to finish.' },
+      },
+      required: ['id'],
+      additionalProperties: false,
+    },
+  },
   {
     cap: 'channel',
     name: 'channel_reply',
@@ -105,7 +123,7 @@ const allTools = [
   {
     cap: 'channel',
     name: 'channel_react',
-    description: 'React with ONE emoji to the message you are handling (a thumbs-up to say "got it", a heart to say thanks). It is lighter than a reply and counts as your answer when nothing else needs saying. Each platform allows only some emoji (on Telegram a fixed list: 👍 👎 ❤ 🔥 👏 🎉 🙏 👌 👀 💯 🤔 😁 😢 ✍ 🫡 …); an emoji that is not allowed is refused and the error lists the ones you can use. Follow the "Chat channels" skill for when to react.',
+    description: 'React with ONE emoji to the message you are handling (a thumbs-up to say "got it", a heart to say thanks). It is lighter than a reply and counts as your answer when nothing else needs saying. Each platform allows only some emoji (on Telegram a fixed list: 👍 👎 ❤ 🔥 👏 🎉 🙏 👌 👀 💯 🤔 😁 😢 ✍ 🫡 …; on Slack a wider set, by emoji or as :name:); an emoji that is not allowed is refused and the error lists the ones you can use. Follow the "Chat channels" skill for when to react.',
     inputSchema: {
       type: 'object',
       properties: { emoji: { type: 'string', description: 'A single emoji, e.g. 👍.' } },
@@ -218,8 +236,78 @@ const allTools = [
     inputSchema: { type: 'object', properties: { id: { type: 'string', description: 'The schedule id.' } }, required: ['id'], additionalProperties: false },
   },
 ];
+
+// ---- Database management (cap `databases`): one tool per operation, all answered by POST /api/agent-objects/db/<op> ----
+const NAME = { type: 'string', description: 'The exact name of the database resource, as object_db_list shows it.' };
+const DB = { type: 'string', description: 'Another database of the same server to use instead of the one the resource opens by default (see object_db_schema).' };
+const SCHEMA = { type: 'string', description: 'The schema (PostgreSQL, SQL Server), the database (MySQL) or "main" (SQLite), as object_db_schema shows it.' };
+const TABLE = { type: 'string', description: 'The table or view name.' };
+const dbTool = (name, description, properties = {}, required = []) => ({ cap: 'databases', name: `object_db_${name}`, description, inputSchema: { type: 'object', properties, required, additionalProperties: false } });
+const dbTools = [
+  dbTool('list', 'List the database resources you look after: name, engine, database and state. Use these exact names in the other object_db tools.'),
+  dbTool('schema', 'The structure of a database: the databases of the server, the current one and its tables and views (with a row estimate). Start here.', { name: NAME, database: DB }, ['name']),
+  dbTool('columns', 'The columns of a table or view: name, type, nullable, key and default.', { name: NAME, schema: SCHEMA, table: TABLE, database: DB }, ['name', 'schema', 'table']),
+  dbTool('describe', 'A table in full: columns, primary key, indexes, foreign keys and the number of rows.', { name: NAME, schema: SCHEMA, table: TABLE, database: DB }, ['name', 'schema', 'table']),
+  dbTool('search', 'Find tables, views and columns whose name contains some text, across everything the connection can see.', { name: NAME, query: { type: 'string', description: 'Part of a name.' }, database: DB }, ['name', 'query']),
+  dbTool('ddl', 'The CREATE statement of a table (with its indexes).', { name: NAME, schema: SCHEMA, table: TABLE, database: DB }, ['name', 'schema', 'table']),
+  dbTool('sample', 'The first rows of a table or view, without writing SQL.', { name: NAME, schema: SCHEMA, table: TABLE, limit: { type: 'number', description: 'How many rows (default 10).' }, database: DB }, ['name', 'schema', 'table']),
+  dbTool('query', 'Run ONE SQL statement: a read, or (not in read-only mode) a write or DDL. DROP and TRUNCATE need Full access. A result is cut at the resource\'s row limit and a query at its time limit. Writes are real and cannot be undone: say what you are about to change first. Results can contain secrets: never repeat them in a chat.', { name: NAME, sql: { type: 'string', description: 'One SQL statement.' }, database: DB }, ['name', 'sql']),
+  dbTool('exec', 'Run several SQL statements as ONE transaction: all are applied or none (a failure says which statement it was). Not in read-only mode; DROP and TRUNCATE need Full access and one of them refuses the whole script. MySQL commits by itself on CREATE, ALTER and DROP, so a DDL in the middle cannot be undone there.', { name: NAME, sql: { type: 'string', description: 'Statements separated by ;' }, database: DB }, ['name', 'sql']),
+  dbTool('explain', 'The execution plan of a statement, without running it.', { name: NAME, sql: { type: 'string', description: 'One SQL statement.' }, database: DB }, ['name', 'sql']),
+  dbTool('export', 'Write the result of a query to a CSV or JSON file inside your own working folder. It never writes outside it and never overwrites a file unless overwrite is true. Not in read-only mode.', { name: NAME, sql: { type: 'string', description: 'The query.' }, format: { type: 'string', enum: ['csv', 'json'] }, file: { type: 'string', description: 'The file, relative to your working folder.' }, overwrite: { type: 'boolean' }, database: DB }, ['name', 'sql', 'format', 'file']),
+  dbTool('saved', 'The named queries saved on a resource: list them, or add, update or remove one (not in read-only mode). A password in the text is replaced by ***.', { name: NAME, op: { type: 'string', enum: ['list', 'add', 'update', 'remove'] }, id: { type: 'string', description: 'The id of the saved query (update, remove).' }, query_name: { type: 'string', description: 'Its name (add, update).' }, sql: { type: 'string', description: 'Its text (add, update).' }, database: DB }, ['name', 'op']),
+  dbTool('history', 'The last 200 queries run on a resource (by people and by agents), or clear them (not in read-only mode).', { name: NAME, op: { type: 'string', enum: ['list', 'clear'] } }, ['name', 'op']),
+  dbTool('sessions', 'Who is connected to the server and what they are running (MySQL, PostgreSQL, SQL Server). Not in read-only mode.', { name: NAME }, ['name']),
+  dbTool('kill', 'Cancel what a session is running (MySQL, PostgreSQL) or end the session (SQL Server). Full access only. It can interrupt other people: look at object_db_sessions first and do it only when asked.', { name: NAME, id: { type: 'number', description: 'The session id from object_db_sessions.' } }, ['name', 'id']),
+  dbTool('config', 'How a resource connects: engine, host, port, user, database, SSL, driver properties and limits. The password is never shown: passwordSet says whether one exists.', { name: NAME }, ['name']),
+  dbTool('config_set', 'Change how a resource connects (Full access only). Give only the fields to change inside config; the engine cannot change. The new connection is tested first and nothing is saved if it fails. A password you give is stored and never shown again: do not repeat it anywhere. Can also rename it, move it to your colony or out of any, and choose the agent that looks after it.', { name: NAME, config: { type: 'object', description: 'Fields to change: host, port, user, password, database, file (SQLite), ssl, trustCert, props, readOnly, timeoutSec, maxRows.' }, new_name: { type: 'string' }, colony_id: { type: 'string', description: '"mine" (your colony) or "none".' }, manager_id: { type: 'string', description: 'An agent name or id, "me", or "none" to leave it to the colony.' } }, ['name']),
+  dbTool('test', 'Test a connection: a saved resource by name, or (Full access) a configuration that is not saved yet.', { name: { type: 'string', description: 'A saved resource to test.' }, config: { type: 'object', description: 'A draft configuration to test instead (Full access).' } }),
+  dbTool('create', 'Create a database resource (Full access only). The connection is tested first and nothing is created if it fails. It is created in your colony (or none) and you become the agent that looks after it. A password in config is stored and never shown again: do not repeat it anywhere.', { name: { type: 'string', description: 'The name of the new resource.' }, config: { type: 'object', description: 'engine (mysql, postgresql, sqlite, mssql) and host, port, user, password, database (or file for SQLite), ssl, trustCert, props, readOnly, timeoutSec, maxRows.' }, colony_id: { type: 'string', description: '"mine" (default) or "none".' } }, ['name', 'config']),
+  dbTool('delete', 'Delete a database resource (Full access only). The database itself is not touched: only hive-am forgets the connection, its saved queries and its history.', { name: NAME }, ['name']),
+];
+allTools.push(...dbTools);
 const tools = allTools.filter((t) => CAPS.has(t.cap)).map(({ cap, ...t }) => t);
 
+// ---- how a database answer is written for the model ----
+const cellText = (v) => (v === null || v === undefined ? 'NULL' : String(v).replace(/\r?\n/g, '\\n'));
+const table = (columns, rows) => [columns.map((c) => c.name ?? c).join('\t'), ...rows.map((r) => r.map(cellText).join('\t'))].join('\n');
+const resultText = (r) => {
+  if (!r.columns?.length) return r.affected !== undefined ? `OK, ${r.affected} row${r.affected === 1 ? '' : 's'} affected (${r.ms ?? 0} ms).` : `OK (${r.ms ?? 0} ms).`;
+  return `${table(r.columns, r.rows)}\n${r.rows.length} row${r.rows.length === 1 ? '' : 's'}${r.truncated ? ' (cut at the resource\'s row limit: ask for fewer rows or columns)' : ''} in ${r.ms ?? 0} ms.`;
+};
+const dbAnswer = (op, j) => {
+  switch (op) {
+    case 'list': return j.databases.length ? j.databases.map((d) => `${d.name} · ${d.engine}${d.database ? ` · ${d.database}` : ''} · ${d.status}${d.detail ? ` (${d.detail})` : ''}`).join('\n') : 'You look after no database resources.';
+    case 'schema': return `${j.engine}, database ${j.database || '(none)'}${j.databases.length ? `. Databases on the server: ${j.databases.join(', ')}` : ''}.\n${j.tables.length ? j.tables.map((t) => `${t.schema}.${t.name} (${t.type}${t.rows !== undefined ? `, ~${t.rows} rows` : ''})`).join('\n') : 'No tables.'}`;
+    case 'columns': return j.columns.length ? j.columns.map((c) => `${c.name} ${c.type}${c.nullable ? '' : ' NOT NULL'}${c.key ? ` ${c.key}` : ''}${c.default !== undefined && c.default !== null ? ` DEFAULT ${c.default}` : ''}`).join('\n') : 'No columns: that table does not exist.';
+    case 'describe': return [`${j.schema}.${j.table}: ${j.rowCount ?? '?'} rows`, 'Columns:', ...j.columns.map((c) => `  ${c.name} ${c.type}${c.nullable ? '' : ' NOT NULL'}${c.key ? ` ${c.key}` : ''}`), `Primary key: ${j.primaryKey.join(', ') || '(none)'}`, 'Indexes:', ...(j.indexes.length ? j.indexes.map((i) => `  ${i.name}${i.unique ? ' UNIQUE' : ''} (${i.columns.join(', ')})`) : ['  (none)']), 'Foreign keys:', ...(j.foreignKeys.length ? j.foreignKeys.map((f) => `  ${f.name}: (${f.columns.join(', ')}) -> ${f.refSchema ? `${f.refSchema}.` : ''}${f.refTable} (${f.refColumns.join(', ')})`) : ['  (none)'])].join('\n');
+    case 'search': return j.matches.length ? j.matches.map((m) => (m.column ? `${m.schema}.${m.table}.${m.column} (column)` : `${m.schema}.${m.table} (${m.type})`)).join('\n') : 'Nothing matches.';
+    case 'ddl': return j.ddl;
+    case 'sample': case 'query': case 'explain': case 'sessions': return resultText(j);
+    case 'exec': return `${j.results.length} statement${j.results.length === 1 ? '' : 's'} applied in one transaction (${j.ms} ms).\n${j.results.map((r, n) => `${n + 1}. ${r.statement.replace(/\s+/g, ' ').slice(0, 80)}\n   ${resultText(r).split('\n').join('\n   ')}`).join('\n')}`;
+    case 'export': return `Wrote ${j.rows} row${j.rows === 1 ? '' : 's'} as ${j.format} to ${j.file} (${j.bytes} bytes)${j.truncated ? ', cut at the resource\'s row limit' : ''}.`;
+    case 'saved': return j.saved === undefined ? 'Done.' : Array.isArray(j.saved) ? (j.saved.length ? j.saved.map((q) => `${q.id} · ${q.name}${q.database ? ` (${q.database})` : ''}\n${q.sql}`).join('\n\n') : 'No saved queries.') : `Saved: ${j.saved.id} · ${j.saved.name}`;
+    case 'history': return j.cleared ? 'History cleared.' : j.history.length ? j.history.map((h) => `${new Date(h.at).toISOString().slice(0, 19)} ${h.ok ? 'ok' : 'FAILED'}${h.by ? ` (${h.by})` : ''} ${h.sql.replace(/\s+/g, ' ').slice(0, 160)}${h.error ? ` -> ${h.error}` : ''}`).join('\n') : 'No history.';
+    case 'kill': return j.text;
+    case 'config': return JSON.stringify({ name: j.name, ...j.config }, null, 2);
+    case 'test': return `Connection works: ${j.version} (${j.ms} ms).`;
+    case 'create': return `Created the database resource "${j.name}" (${j.engine}). You look after it now.`;
+    case 'config_set': return `Saved the connection of "${j.name}" after testing it.`;
+    case 'delete': return `Deleted the database resource "${j.deleted}".`;
+    default: return JSON.stringify(j);
+  }
+};
+
+async function taskStatus(id, waitSeconds) {
+  const r = await fetch(`${API}/api/dispatch/status`, {
+    method: 'POST', headers: { 'content-type': 'application/json' },
+    body: JSON.stringify({ from: FROM, id, wait_seconds: waitSeconds }),
+  });
+  const j = await r.json();
+  if (!r.ok) throw Object.assign(new Error(j.error ?? `dispatch_status failed (${r.status})`), { status: r.status });
+  return j;
+}
+
 async function call(name, args) {
   if (!tools.some((t) => t.name === name)) throw new Error(`Unknown tool ${name}`);
   if (name === 'list_agents') {
@@ -227,13 +315,29 @@ async function call(name, args) {
     return JSON.stringify(await r.json(), null, 2);
   }
   if (name === 'dispatch') {
+    const background = args.background !== false;
     const r = await fetch(`${API}/api/dispatch`, {
       method: 'POST', headers: { 'content-type': 'application/json' },
-      body: JSON.stringify({ from: FROM, agent: args.agent, task: args.task }),
+      body: JSON.stringify({ from: FROM, agent: args.agent, task: args.task, background, poll: !background }),
     });
     const j = await r.json();
     if (!r.ok) throw new Error(j.error ?? `dispatch failed (${r.status})`);
-    return j.text || '(the subagent finished without a text answer)';
+    if (background) return `Task ${j.id} sent to ${j.agent} (${j.status}). You will be woken with the result when it finishes; you can also ask with dispatch_status.`;
+    // Wait for the end with short calls: the answer is read from the server's record, never from one long request.
+    for (let errors = 0; ;) {
+      let s;
+      try { s = await taskStatus(j.id, POLL_S); errors = 0; } catch (e) {
+        if (e.status || ++errors > 5) throw new Error(`${e.message}. The task ${j.id} goes on: ask for its result with dispatch_status.`);
+        await new Promise((ok) => setTimeout(ok, 2000));
+        continue;
+      }
+      if (s.status === 'done') return s.result;
+      if (s.status === 'failed' || s.status === 'interrupted') throw new Error(`${j.agent} did not finish the task (${s.status}): ${s.result}`);
+    }
+  }
+  if (name === 'dispatch_status') {
+    const s = await taskStatus(args.id, args.wait_seconds);
+    return `Task ${s.id} for ${s.agent}: ${s.status}.${s.note ? ` ${s.note}` : ''}${s.result !== undefined ? ` Result:\n${s.result}` : ' Not finished yet.'}`;
   }
   if (name === 'channel_reply') {
     const r = await fetch(`${API}/api/channel/reply`, {
@@ -293,6 +397,13 @@ async function call(name, args) {
     if (!r.ok) throw new Error(j.error ?? `channel_mute failed (${r.status})`);
     return j.muted ? `Muted in this thread (${j.place}). You will only be woken when someone mentions you or replies to you.` : `Unmuted in this thread (${j.place}).`;
   }
+  if (name.startsWith('object_db_')) {
+    const op = name.slice('object_db_'.length);
+    const r = await fetch(`${API}/api/agent-objects/db/${op}`, { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ from: FROM, ...args }) });
+    const j = await r.json();
+    if (!r.ok) throw new Error(j.error ?? `${name} failed (${r.status})`);
+    return dbAnswer(op, j);
+  }
   if (name === 'object_list' || name === 'object_logs' || name === 'object_action') {
     const r = await fetch(`${API}/api/agent-objects/${name.slice('object_'.length)}`, {
       method: 'POST', headers: { 'content-type': 'application/json' },

package/web/.next/BUILD_ID

@@ -1 +1 @@
-YT6HM6qmegMJaBMX5QvuP
+tdnUXVa01m25EjOobxVd1

package/web/.next/app-build-manifest.json

@@ -13,30 +13,49 @@
       "static/chunks/89-b194fcffe5120c44.js",
       "static/chunks/main-app-6086068e5fb5eacd.js",
       "static/css/945795da867f5250.css",
-      "static/css/582723fcea1f9887.css",
-      "static/chunks/586-f7017d585a84738d.js",
-      "static/chunks/281-113274e705940a55.js",
-      "static/chunks/app/layout-fad968a635f9a4b3.js"
+      "static/css/c7faf690373117bb.css",
+      "static/chunks/586-4f67b823df060b46.js",
+      "static/chunks/281-4506bc98b7111729.js",
+      "static/chunks/app/layout-cb5af29b0742c513.js"
+    ],
+    "/chat/page": [
+      "static/chunks/webpack-ef515e41a83a16ac.js",
+      "static/chunks/0937d497-114a2a3de515565e.js",
+      "static/chunks/89-b194fcffe5120c44.js",
+      "static/chunks/main-app-6086068e5fb5eacd.js",
+      "static/chunks/586-4f67b823df060b46.js",
+      "static/chunks/706-fa2be0f10ffebe6a.js",
+      "static/chunks/281-4506bc98b7111729.js",
+      "static/chunks/517-8f2db464d10a4624.js",
+      "static/chunks/app/chat/page-383bc24e72dab7fa.js"
     ],
     "/connections/page": [
       "static/chunks/webpack-ef515e41a83a16ac.js",
       "static/chunks/0937d497-114a2a3de515565e.js",
       "static/chunks/89-b194fcffe5120c44.js",
       "static/chunks/main-app-6086068e5fb5eacd.js",
-      "static/chunks/586-f7017d585a84738d.js",
-      "static/chunks/281-113274e705940a55.js",
-      "static/chunks/app/connections/page-eb11cfb1ffeab3ca.js"
+      "static/chunks/586-4f67b823df060b46.js",
+      "static/chunks/281-4506bc98b7111729.js",
+      "static/chunks/app/connections/page-b0ea2eae62cef74e.js"
     ],
-    "/chat/page": [
+    "/resources/[id]/page": [
       "static/chunks/webpack-ef515e41a83a16ac.js",
       "static/chunks/0937d497-114a2a3de515565e.js",
       "static/chunks/89-b194fcffe5120c44.js",
       "static/chunks/main-app-6086068e5fb5eacd.js",
-      "static/chunks/586-f7017d585a84738d.js",
+      "static/chunks/586-4f67b823df060b46.js",
       "static/chunks/706-fa2be0f10ffebe6a.js",
-      "static/chunks/281-113274e705940a55.js",
-      "static/chunks/517-373a80c8ba432bdc.js",
-      "static/chunks/app/chat/page-5261b12b7d50f5d1.js"
+      "static/chunks/642-dc874c8caf203ee1.js",
+      "static/chunks/837-33c7480524f48577.js",
+      "static/chunks/771-db19da9b1a24820c.js",
+      "static/chunks/281-4506bc98b7111729.js",
+      "static/chunks/517-8f2db464d10a4624.js",
+      "static/chunks/350-0fe82e622e7a670f.js",
+      "static/chunks/606-14fb5aaa4d0ff22d.js",
+      "static/chunks/587-3c53d91a1c4f99d6.js",
+      "static/chunks/30-9adcbe92b15a6815.js",
+      "static/chunks/491-196bcb3dd11bb460.js",
+      "static/chunks/app/resources/[id]/page-1e2afddcb1f04884.js"
     ],
     "/relations/page": [
       "static/chunks/webpack-ef515e41a83a16ac.js",
@@ -45,133 +64,130 @@
       "static/chunks/main-app-6086068e5fb5eacd.js",
       "static/css/c4a545148b5320ec.css",
       "static/chunks/2b9ff8ee-969e65cc354b2150.js",
-      "static/chunks/586-f7017d585a84738d.js",
-      "static/chunks/562-7c2e33d838e869bf.js",
-      "static/chunks/281-113274e705940a55.js",
-      "static/chunks/app/relations/page-a44fd515a3b0525e.js"
+      "static/chunks/586-4f67b823df060b46.js",
+      "static/chunks/757-03361e7a97a605a2.js",
+      "static/chunks/281-4506bc98b7111729.js",
+      "static/chunks/app/relations/page-02710fe1f8a670a9.js"
     ],
-    "/agents/[id]/page": [
+    "/resources/page": [
       "static/chunks/webpack-ef515e41a83a16ac.js",
       "static/chunks/0937d497-114a2a3de515565e.js",
       "static/chunks/89-b194fcffe5120c44.js",
       "static/chunks/main-app-6086068e5fb5eacd.js",
-      "static/chunks/586-f7017d585a84738d.js",
+      "static/chunks/586-4f67b823df060b46.js",
       "static/chunks/706-fa2be0f10ffebe6a.js",
+      "static/chunks/642-dc874c8caf203ee1.js",
       "static/chunks/837-33c7480524f48577.js",
-      "static/chunks/391-18768499e741112e.js",
-      "static/chunks/316-26da9cc233ba7557.js",
-      "static/chunks/281-113274e705940a55.js",
-      "static/chunks/517-373a80c8ba432bdc.js",
+      "static/chunks/771-db19da9b1a24820c.js",
+      "static/chunks/281-4506bc98b7111729.js",
+      "static/chunks/517-8f2db464d10a4624.js",
       "static/chunks/350-0fe82e622e7a670f.js",
-      "static/chunks/606-c9a19918b02a98d0.js",
+      "static/chunks/606-14fb5aaa4d0ff22d.js",
+      "static/chunks/587-3c53d91a1c4f99d6.js",
       "static/chunks/30-9adcbe92b15a6815.js",
-      "static/chunks/705-f81face97b1bb1af.js",
-      "static/chunks/app/agents/[id]/page-6ed6edb3e74b0ebe.js"
+      "static/chunks/491-196bcb3dd11bb460.js",
+      "static/chunks/app/resources/page-195b0af83b8ace0d.js"
     ],
-    "/agents/page": [
+    "/page": [
       "static/chunks/webpack-ef515e41a83a16ac.js",
       "static/chunks/0937d497-114a2a3de515565e.js",
       "static/chunks/89-b194fcffe5120c44.js",
       "static/chunks/main-app-6086068e5fb5eacd.js",
-      "static/chunks/586-f7017d585a84738d.js",
+      "static/chunks/586-4f67b823df060b46.js",
       "static/chunks/706-fa2be0f10ffebe6a.js",
-      "static/chunks/281-113274e705940a55.js",
-      "static/chunks/517-373a80c8ba432bdc.js",
-      "static/chunks/app/agents/page-9bb8cba69776c719.js"
+      "static/chunks/642-dc874c8caf203ee1.js",
+      "static/chunks/162-68ba190086f5ad39.js",
+      "static/chunks/281-4506bc98b7111729.js",
+      "static/chunks/517-8f2db464d10a4624.js",
+      "static/chunks/350-0fe82e622e7a670f.js",
+      "static/chunks/606-14fb5aaa4d0ff22d.js",
+      "static/chunks/587-3c53d91a1c4f99d6.js",
+      "static/chunks/app/page-5e547e87de23d9fa.js"
     ],
-    "/resources/[id]/page": [
+    "/schedules/page": [
       "static/chunks/webpack-ef515e41a83a16ac.js",
       "static/chunks/0937d497-114a2a3de515565e.js",
       "static/chunks/89-b194fcffe5120c44.js",
       "static/chunks/main-app-6086068e5fb5eacd.js",
-      "static/chunks/586-f7017d585a84738d.js",
-      "static/chunks/706-fa2be0f10ffebe6a.js",
-      "static/chunks/837-33c7480524f48577.js",
-      "static/chunks/391-18768499e741112e.js",
-      "static/chunks/281-113274e705940a55.js",
-      "static/chunks/517-373a80c8ba432bdc.js",
-      "static/chunks/350-0fe82e622e7a670f.js",
-      "static/chunks/606-c9a19918b02a98d0.js",
-      "static/chunks/587-8e4d2be01ba7d48f.js",
-      "static/chunks/30-9adcbe92b15a6815.js",
-      "static/chunks/656-f537149fe28f79aa.js",
-      "static/chunks/app/resources/[id]/page-fc494e85b01e8cb7.js"
+      "static/chunks/586-4f67b823df060b46.js",
+      "static/chunks/281-4506bc98b7111729.js",
+      "static/chunks/app/schedules/page-96976fff4ee23538.js"
     ],
-    "/resources/page": [
+    "/sessions/page": [
       "static/chunks/webpack-ef515e41a83a16ac.js",
       "static/chunks/0937d497-114a2a3de515565e.js",
       "static/chunks/89-b194fcffe5120c44.js",
       "static/chunks/main-app-6086068e5fb5eacd.js",
-      "static/chunks/586-f7017d585a84738d.js",
+      "static/chunks/586-4f67b823df060b46.js",
       "static/chunks/706-fa2be0f10ffebe6a.js",
-      "static/chunks/837-33c7480524f48577.js",
-      "static/chunks/391-18768499e741112e.js",
-      "static/chunks/281-113274e705940a55.js",
-      "static/chunks/517-373a80c8ba432bdc.js",
+      "static/chunks/654-92a63b3c4b412666.js",
+      "static/chunks/281-4506bc98b7111729.js",
       "static/chunks/350-0fe82e622e7a670f.js",
-      "static/chunks/606-c9a19918b02a98d0.js",
-      "static/chunks/587-8e4d2be01ba7d48f.js",
-      "static/chunks/30-9adcbe92b15a6815.js",
-      "static/chunks/656-f537149fe28f79aa.js",
-      "static/chunks/app/resources/page-61cccd8fdcc2f6c8.js"
+      "static/chunks/705-ce86175dea00e6a9.js",
+      "static/chunks/app/sessions/page-85638705fdc18174.js"
     ],
-    "/page": [
+    "/skills/page": [
       "static/chunks/webpack-ef515e41a83a16ac.js",
       "static/chunks/0937d497-114a2a3de515565e.js",
       "static/chunks/89-b194fcffe5120c44.js",
       "static/chunks/main-app-6086068e5fb5eacd.js",
-      "static/chunks/586-f7017d585a84738d.js",
+      "static/chunks/586-4f67b823df060b46.js",
       "static/chunks/706-fa2be0f10ffebe6a.js",
-      "static/chunks/391-18768499e741112e.js",
-      "static/chunks/281-113274e705940a55.js",
-      "static/chunks/517-373a80c8ba432bdc.js",
-      "static/chunks/350-0fe82e622e7a670f.js",
-      "static/chunks/606-c9a19918b02a98d0.js",
-      "static/chunks/587-8e4d2be01ba7d48f.js",
-      "static/chunks/app/page-99e0351e6ccaa384.js"
+      "static/chunks/281-4506bc98b7111729.js",
+      "static/chunks/app/skills/page-bc1acd0663f36129.js"
     ],
-    "/schedules/page": [
+    "/types/page": [
       "static/chunks/webpack-ef515e41a83a16ac.js",
       "static/chunks/0937d497-114a2a3de515565e.js",
       "static/chunks/89-b194fcffe5120c44.js",
       "static/chunks/main-app-6086068e5fb5eacd.js",
-      "static/chunks/586-f7017d585a84738d.js",
-      "static/chunks/281-113274e705940a55.js",
-      "static/chunks/app/schedules/page-96976fff4ee23538.js"
+      "static/chunks/586-4f67b823df060b46.js",
+      "static/chunks/706-fa2be0f10ffebe6a.js",
+      "static/chunks/281-4506bc98b7111729.js",
+      "static/chunks/517-8f2db464d10a4624.js",
+      "static/chunks/app/types/page-c4c2b2217c4667e8.js"
     ],
-    "/sessions/page": [
+    "/agents/layout": [
       "static/chunks/webpack-ef515e41a83a16ac.js",
       "static/chunks/0937d497-114a2a3de515565e.js",
       "static/chunks/89-b194fcffe5120c44.js",
       "static/chunks/main-app-6086068e5fb5eacd.js",
-      "static/chunks/586-f7017d585a84738d.js",
+      "static/chunks/586-4f67b823df060b46.js",
       "static/chunks/706-fa2be0f10ffebe6a.js",
-      "static/chunks/654-92a63b3c4b412666.js",
-      "static/chunks/281-113274e705940a55.js",
+      "static/chunks/642-dc874c8caf203ee1.js",
+      "static/chunks/281-4506bc98b7111729.js",
+      "static/chunks/517-8f2db464d10a4624.js",
       "static/chunks/350-0fe82e622e7a670f.js",
-      "static/chunks/705-f81face97b1bb1af.js",
-      "static/chunks/app/sessions/page-a7534ebd90e982d6.js"
+      "static/chunks/app/agents/layout-71dd98d696935e29.js"
     ],
-    "/types/page": [
+    "/agents/page": [
       "static/chunks/webpack-ef515e41a83a16ac.js",
       "static/chunks/0937d497-114a2a3de515565e.js",
       "static/chunks/89-b194fcffe5120c44.js",
       "static/chunks/main-app-6086068e5fb5eacd.js",
-      "static/chunks/586-f7017d585a84738d.js",
+      "static/chunks/586-4f67b823df060b46.js",
       "static/chunks/706-fa2be0f10ffebe6a.js",
-      "static/chunks/281-113274e705940a55.js",
-      "static/chunks/517-373a80c8ba432bdc.js",
-      "static/chunks/app/types/page-ebd37e220f77c1f3.js"
+      "static/chunks/281-4506bc98b7111729.js",
+      "static/chunks/517-8f2db464d10a4624.js",
+      "static/chunks/app/agents/page-9da499db6d22731f.js"
     ],
-    "/skills/page": [
+    "/agents/[id]/page": [
       "static/chunks/webpack-ef515e41a83a16ac.js",
       "static/chunks/0937d497-114a2a3de515565e.js",
       "static/chunks/89-b194fcffe5120c44.js",
       "static/chunks/main-app-6086068e5fb5eacd.js",
-      "static/chunks/586-f7017d585a84738d.js",
+      "static/chunks/586-4f67b823df060b46.js",
       "static/chunks/706-fa2be0f10ffebe6a.js",
-      "static/chunks/281-113274e705940a55.js",
-      "static/chunks/app/skills/page-bc1acd0663f36129.js"
+      "static/chunks/642-dc874c8caf203ee1.js",
+      "static/chunks/837-33c7480524f48577.js",
+      "static/chunks/214-35b88db02113ae02.js",
+      "static/chunks/281-4506bc98b7111729.js",
+      "static/chunks/517-8f2db464d10a4624.js",
+      "static/chunks/350-0fe82e622e7a670f.js",
+      "static/chunks/606-14fb5aaa4d0ff22d.js",
+      "static/chunks/30-9adcbe92b15a6815.js",
+      "static/chunks/705-ce86175dea00e6a9.js",
+      "static/chunks/app/agents/[id]/page-803d53aedd10c8e5.js"
     ]
   }
 }

package/web/.next/app-path-routes-manifest.json

@@ -1,18 +1,18 @@
 {
   "/_not-found/page": "/_not-found",
-  "/apple-icon.png/route": "/apple-icon.png",
-  "/favicon.ico/route": "/favicon.ico",
   "/icon.png/route": "/icon.png",
-  "/connections/page": "/connections",
+  "/favicon.ico/route": "/favicon.ico",
+  "/apple-icon.png/route": "/apple-icon.png",
   "/chat/page": "/chat",
-  "/relations/page": "/relations",
-  "/agents/[id]/page": "/agents/[id]",
-  "/agents/page": "/agents",
+  "/connections/page": "/connections",
   "/resources/[id]/page": "/resources/[id]",
+  "/relations/page": "/relations",
   "/resources/page": "/resources",
   "/page": "/",
   "/schedules/page": "/schedules",
   "/sessions/page": "/sessions",
+  "/skills/page": "/skills",
   "/types/page": "/types",
-  "/skills/page": "/skills"
+  "/agents/page": "/agents",
+  "/agents/[id]/page": "/agents/[id]"
 }

package/web/.next/build-manifest.json

@@ -5,8 +5,8 @@
   "devFiles": [],
   "ampDevFiles": [],
   "lowPriorityFiles": [
-    "static/YT6HM6qmegMJaBMX5QvuP/_buildManifest.js",
-    "static/YT6HM6qmegMJaBMX5QvuP/_ssgManifest.js"
+    "static/tdnUXVa01m25EjOobxVd1/_buildManifest.js",
+    "static/tdnUXVa01m25EjOobxVd1/_ssgManifest.js"
   ],
   "rootMainFiles": [
     "static/chunks/webpack-ef515e41a83a16ac.js",