@askexenow/exe-os 0.9.279 → 0.9.280

package/dist/chunk-74YEBPGM.js

@@ -0,0 +1,271 @@
+import {
+  vectorToSqlLiteral
+} from "./chunk-JDSJ3NU7.js";
+import {
+  blobToVector
+} from "./chunk-OTVEIJUQ.js";
+import {
+  getClient
+} from "./chunk-ZJP3ZONM.js";
+
+// src/lib/behaviors.ts
+import crypto from "crypto";
+function formatReflexContent(trigger, action) {
+  return `\u26A1 REFLEX: When ${trigger} \u2192 ${action}. Decide whether to act.`;
+}
+function isReflexBehavior(behavior) {
+  return behavior.domain === "reflex";
+}
+async function storeReflexBehavior(opts) {
+  const content = formatReflexContent(opts.trigger, opts.action);
+  return storeBehavior({
+    agentId: opts.agentId,
+    content,
+    domain: "reflex",
+    projectName: opts.projectName,
+    priority: "p0",
+    // Always injected — impossible to miss
+    deviceScoped: opts.deviceScoped ?? false
+  });
+}
+async function storeBehavior(opts) {
+  try {
+    const { loadEmployeesSync, baseAgentName } = await import("./lib/employees.js");
+    const roster = loadEmployeesSync();
+    if (roster.length > 0) {
+      const base = baseAgentName(opts.agentId, roster);
+      if (!roster.some((e) => e.name === opts.agentId || e.name === base)) {
+        process.stderr.write(
+          `[behaviors] WARNING: Agent "${opts.agentId}" not found in roster. Storing behavior anyway \u2014 may be orphaned.
+`
+        );
+      }
+    }
+  } catch {
+  }
+  const client = getClient();
+  const id = crypto.randomUUID();
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  const duplicate = await client.execute({
+    sql: `SELECT id FROM behaviors
+          WHERE agent_id = ?
+            AND COALESCE(domain, '') = COALESCE(?, '')
+            AND COALESCE(project_name, '') = COALESCE(?, '')
+            AND active = 1
+            AND lower(trim(content)) = lower(trim(?))
+          ORDER BY updated_at DESC
+          LIMIT 1`,
+    args: [opts.agentId, opts.domain ?? null, opts.projectName ?? null, opts.content]
+  });
+  const existingId = duplicate.rows[0]?.id;
+  if (existingId) return String(existingId);
+  let vector = null;
+  if (!process.env.VITEST) {
+    try {
+      const { embed } = await import("./lib/embedder.js");
+      const vec = await embed(opts.content);
+      vector = new Float32Array(vec);
+    } catch {
+    }
+  }
+  let createdByDevice = null;
+  try {
+    const { loadDeviceId } = await import("./lib/license.js");
+    createdByDevice = loadDeviceId() ?? null;
+  } catch {
+  }
+  const createdByAgent = process.env.AGENT_ID ?? null;
+  const sourceSessionId = process.env.CLAUDE_SESSION_ID ?? process.env.SESSION_ID ?? null;
+  let deviceId = null;
+  if (opts.deviceScoped) {
+    try {
+      const { loadDeviceId } = await import("./lib/license.js");
+      deviceId = loadDeviceId() ?? null;
+    } catch {
+    }
+  }
+  await client.execute({
+    sql: `INSERT INTO behaviors (id, agent_id, project_name, domain, priority, content, active, created_at, updated_at, vector, created_by_agent, created_by_device, source_session_id, device_id)
+          VALUES (?, ?, ?, ?, ?, ?, 1, ?, ?, ?, ?, ?, ?, ?)`,
+    args: [id, opts.agentId, opts.projectName ?? null, opts.domain ?? null, opts.priority ?? "p1", opts.content, now, now, vector ? vectorToSqlLiteral(vector) : null, createdByAgent, createdByDevice, sourceSessionId, deviceId]
+  });
+  return id;
+}
+async function listBehaviors(agentId, projectName, limit = 30) {
+  const client = getClient();
+  let currentDeviceId = null;
+  try {
+    const { loadDeviceId } = await import("./lib/license.js");
+    currentDeviceId = loadDeviceId() ?? null;
+  } catch {
+  }
+  const result = await client.execute({
+    sql: `SELECT id, agent_id, project_name, domain, priority, content, active, created_at, updated_at, vector, created_by_agent, created_by_device, source_session_id, device_id
+          FROM behaviors
+          WHERE agent_id = ? AND active = 1
+            AND (project_name IS NULL OR project_name = ?)
+            AND (device_id IS NULL OR device_id = ?)
+          ORDER BY
+            CASE WHEN priority = 'p0' THEN 0
+                 WHEN priority = 'p1' THEN 1
+                 ELSE 2 END,
+            CASE
+              WHEN lower(coalesce(domain, '')) IN ('identity', 'title', 'role') THEN 0
+              WHEN lower(content) LIKE '%identity%' THEN 0
+              WHEN lower(content) LIKE '%title%' THEN 0
+              WHEN lower(content) LIKE '%who are you%' THEN 0
+              ELSE 1
+            END,
+            updated_at DESC
+          LIMIT ?`,
+    args: [agentId, projectName ?? "", currentDeviceId ?? "", limit]
+  });
+  return result.rows.map((r) => ({
+    id: String(r.id),
+    agent_id: String(r.agent_id),
+    project_name: r.project_name ? String(r.project_name) : null,
+    domain: r.domain ? String(r.domain) : null,
+    priority: String(r.priority || "p1"),
+    content: String(r.content),
+    active: Number(r.active),
+    created_at: String(r.created_at),
+    updated_at: String(r.updated_at),
+    vector: r.vector ? blobToVector(r.vector) : null,
+    created_by_agent: r.created_by_agent ? String(r.created_by_agent) : null,
+    created_by_device: r.created_by_device ? String(r.created_by_device) : null,
+    source_session_id: r.source_session_id ? String(r.source_session_id) : null,
+    device_id: r.device_id ? String(r.device_id) : null
+  }));
+}
+async function listBehaviorsByDomain(agentId, domain) {
+  const client = getClient();
+  const result = await client.execute({
+    sql: `SELECT id, agent_id, project_name, domain, priority, content, active, created_at, updated_at, vector
+          FROM behaviors
+          WHERE agent_id = ? AND domain = ? AND active = 1`,
+    args: [agentId, domain]
+  });
+  return result.rows.map((r) => ({
+    id: String(r.id),
+    agent_id: String(r.agent_id),
+    project_name: r.project_name ? String(r.project_name) : null,
+    domain: r.domain ? String(r.domain) : null,
+    priority: String(r.priority || "p1"),
+    content: String(r.content),
+    active: Number(r.active),
+    created_at: String(r.created_at),
+    updated_at: String(r.updated_at),
+    vector: r.vector ? blobToVector(r.vector) : null,
+    created_by_agent: r.created_by_agent ? String(r.created_by_agent) : null,
+    created_by_device: r.created_by_device ? String(r.created_by_device) : null,
+    source_session_id: r.source_session_id ? String(r.source_session_id) : null,
+    device_id: r.device_id ? String(r.device_id) : null
+  }));
+}
+async function listBehaviorsSince(agentId, sinceIso, projectName, limit = 15) {
+  const client = getClient();
+  let currentDeviceId = null;
+  try {
+    const { loadDeviceId } = await import("./lib/license.js");
+    currentDeviceId = loadDeviceId() ?? null;
+  } catch {
+  }
+  const result = await client.execute({
+    sql: `SELECT id, agent_id, project_name, domain, priority, content, active, created_at, updated_at, vector, created_by_agent, created_by_device, source_session_id, device_id
+          FROM behaviors
+          WHERE agent_id = ? AND active = 1
+            AND (project_name IS NULL OR project_name = ?)
+            AND (device_id IS NULL OR device_id = ?)
+            AND (created_at > ? OR updated_at > ?)
+          ORDER BY
+            CASE WHEN priority = 'p0' THEN 0
+                 WHEN priority = 'p1' THEN 1
+                 ELSE 2 END,
+            updated_at DESC
+          LIMIT ?`,
+    args: [agentId, projectName ?? "", currentDeviceId ?? "", sinceIso, sinceIso, limit]
+  });
+  return result.rows.map((r) => ({
+    id: String(r.id),
+    agent_id: String(r.agent_id),
+    project_name: r.project_name ? String(r.project_name) : null,
+    domain: r.domain ? String(r.domain) : null,
+    priority: String(r.priority || "p1"),
+    content: String(r.content),
+    active: Number(r.active),
+    created_at: String(r.created_at),
+    updated_at: String(r.updated_at),
+    vector: r.vector ? blobToVector(r.vector) : null,
+    created_by_agent: r.created_by_agent ? String(r.created_by_agent) : null,
+    created_by_device: r.created_by_device ? String(r.created_by_device) : null,
+    source_session_id: r.source_session_id ? String(r.source_session_id) : null,
+    device_id: r.device_id ? String(r.device_id) : null
+  }));
+}
+async function listSharedSkills(currentAgentId, projectName, limit = 30) {
+  const client = getClient();
+  let currentDeviceId = null;
+  try {
+    const { loadDeviceId } = await import("./lib/license.js");
+    currentDeviceId = loadDeviceId() ?? null;
+  } catch {
+  }
+  const result = await client.execute({
+    sql: `SELECT id, agent_id, project_name, domain, priority, content, active, created_at, updated_at, vector, created_by_agent, created_by_device, source_session_id, device_id
+          FROM behaviors
+          WHERE domain = 'skill' AND active = 1
+            AND (project_name IS NULL OR project_name = ?)
+            AND (device_id IS NULL OR device_id = ?)
+          ORDER BY
+            CASE WHEN agent_id = ? THEN 0 ELSE 1 END,
+            updated_at DESC
+          LIMIT ?`,
+    args: [projectName ?? "", currentDeviceId ?? "", currentAgentId, limit]
+  });
+  return result.rows.map((r) => ({
+    id: String(r.id),
+    agent_id: String(r.agent_id),
+    project_name: r.project_name ? String(r.project_name) : null,
+    domain: r.domain ? String(r.domain) : null,
+    priority: String(r.priority || "p1"),
+    content: String(r.content),
+    active: Number(r.active),
+    created_at: String(r.created_at),
+    updated_at: String(r.updated_at),
+    vector: r.vector ? blobToVector(r.vector) : null,
+    created_by_agent: r.created_by_agent ? String(r.created_by_agent) : null,
+    created_by_device: r.created_by_device ? String(r.created_by_device) : null,
+    source_session_id: r.source_session_id ? String(r.source_session_id) : null,
+    device_id: r.device_id ? String(r.device_id) : null,
+    shared: String(r.agent_id) !== currentAgentId
+  }));
+}
+async function deactivateBehavior(id) {
+  const client = getClient();
+  const result = await client.execute({
+    sql: `UPDATE behaviors SET active = 0, updated_at = ? WHERE id = ? AND active = 1`,
+    args: [(/* @__PURE__ */ new Date()).toISOString(), id]
+  });
+  return (result.rowsAffected ?? 0) > 0;
+}
+async function reactivateBehavior(id) {
+  const client = getClient();
+  const result = await client.execute({
+    sql: `UPDATE behaviors SET active = 1, updated_at = ? WHERE id = ? AND active = 0`,
+    args: [(/* @__PURE__ */ new Date()).toISOString(), id]
+  });
+  return (result.rowsAffected ?? 0) > 0;
+}
+
+export {
+  formatReflexContent,
+  isReflexBehavior,
+  storeReflexBehavior,
+  storeBehavior,
+  listBehaviors,
+  listBehaviorsByDomain,
+  listBehaviorsSince,
+  listSharedSkills,
+  deactivateBehavior,
+  reactivateBehavior
+};

package/dist/chunk-77C3E5LS.js

@@ -0,0 +1,54 @@
+import {
+  processCRMEvent
+} from "./chunk-YMUH7TWT.js";
+
+// src/gateway/adapters/crm-webhook.ts
+function parseTwentyWebhook(payload) {
+  if (!payload || typeof payload !== "object") return null;
+  const p = payload;
+  const eventName = p.eventName;
+  if (!eventName || typeof eventName !== "string") return null;
+  const dotIndex = eventName.indexOf(".");
+  if (dotIndex === -1) return null;
+  const objectType = eventName.slice(0, dotIndex);
+  const eventType = eventName.slice(dotIndex + 1);
+  if (!objectType || !eventType) return null;
+  const normalizedObjectType = objectType.charAt(0).toUpperCase() + objectType.slice(1);
+  const record = p.record ?? {};
+  if (typeof record !== "object") return null;
+  return {
+    eventType,
+    objectType: normalizedObjectType,
+    record
+  };
+}
+function createCRMWebhookHandler(options) {
+  return async (body) => {
+    const event = parseTwentyWebhook(body);
+    if (!event) {
+      console.warn(
+        "[crm-webhook] Malformed CRM webhook payload \u2014 skipping"
+      );
+      return;
+    }
+    console.log(
+      `[crm-webhook] ${event.objectType}.${event.eventType} received`
+    );
+    try {
+      const logs = await processCRMEvent(event, options?.executor, options?.triggers);
+      if (logs.length > 0 && options?.onFired) {
+        options.onFired(logs);
+      }
+    } catch (err) {
+      console.error(
+        "[crm-webhook] Error processing CRM event:",
+        err instanceof Error ? err.message : err
+      );
+    }
+  };
+}
+
+export {
+  parseTwentyWebhook,
+  createCRMWebhookHandler
+};

package/dist/chunk-7EAYV7G2.js

@@ -0,0 +1,345 @@
+import {
+  employeeSessionName,
+  isEmployeeAlive,
+  resolveExeSession,
+  sendIntercom,
+  strictSessionScopeFilter
+} from "./chunk-IPZ4JWBG.js";
+import {
+  parseMessage,
+  serializeMessage
+} from "./chunk-4JERP7NT.js";
+import {
+  recordOrchestrationEventBestEffort
+} from "./chunk-X46O77S4.js";
+import {
+  getClient
+} from "./chunk-ZJP3ZONM.js";
+
+// src/lib/messaging.ts
+import crypto from "crypto";
+function generateUlid() {
+  const timestamp = Date.now().toString(36).padStart(10, "0");
+  const random = crypto.randomBytes(10).toString("hex").slice(0, 16);
+  return (timestamp + random).toUpperCase();
+}
+function rowToMessage(row) {
+  return {
+    id: row.id,
+    fromAgent: row.from_agent,
+    fromDevice: row.from_device,
+    targetAgent: row.target_agent,
+    targetProject: row.target_project ?? null,
+    targetDevice: row.target_device,
+    sessionScope: row.session_scope ?? null,
+    content: row.content,
+    priority: row.priority ?? "normal",
+    status: row.status ?? "pending",
+    serverSeq: row.server_seq != null ? Number(row.server_seq) : null,
+    retryCount: Number(row.retry_count ?? 0),
+    createdAt: row.created_at,
+    deliveredAt: row.delivered_at ?? null,
+    processedAt: row.processed_at ?? null,
+    failedAt: row.failed_at ?? null,
+    failureReason: row.failure_reason ?? null
+  };
+}
+var MAX_RETRIES = 10;
+async function countUnreadMessages(targetAgent, sessionScope) {
+  const client = getClient();
+  const scope = strictSessionScopeFilter(sessionScope);
+  const result = await client.execute({
+    sql: `SELECT COUNT(*) AS count FROM messages
+          WHERE target_agent = ? AND status IN ('pending', 'delivered')${scope.sql}`,
+    args: [targetAgent, ...scope.args]
+  });
+  return Number(result.rows[0]?.count ?? 0);
+}
+async function sendMessage(input) {
+  const client = getClient();
+  const id = generateUlid();
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  const targetDevice = input.targetDevice ?? "local";
+  const sessionScope = input.sessionScope === void 0 ? resolveExeSession() : input.sessionScope;
+  await client.execute({
+    sql: `INSERT INTO messages (id, from_agent, from_device, target_agent, target_project, target_device, session_scope, content, priority, status, founder_id, created_at)
+          VALUES (?, ?, 'local', ?, ?, ?, ?, ?, ?, 'pending', ?, ?)`,
+    args: [
+      id,
+      input.fromAgent,
+      input.targetAgent,
+      input.targetProject ?? null,
+      targetDevice,
+      sessionScope,
+      input.content,
+      input.priority ?? "normal",
+      input.founderId ?? null,
+      now
+    ]
+  });
+  recordOrchestrationEventBestEffort({
+    eventType: "message.sent",
+    source: "messaging.sendMessage",
+    agentId: input.fromAgent,
+    payload: { targetAgent: input.targetAgent, priority: input.priority ?? "normal", targetDevice },
+    sessionScope: sessionScope ?? null
+  });
+  try {
+    if (targetDevice !== "local") {
+      await deliverCrossMachineMessage(id, targetDevice);
+    } else {
+      await deliverLocalMessage(id);
+    }
+  } catch {
+  }
+  const sentScope = strictSessionScopeFilter(sessionScope);
+  const result = await client.execute({
+    sql: `SELECT * FROM messages WHERE id = ?${sentScope.sql}`,
+    args: [id, ...sentScope.args]
+  });
+  return rowToMessage(result.rows[0]);
+}
+var _wsClientSend = null;
+function setWsClientSend(fn) {
+  _wsClientSend = fn;
+}
+async function deliverCrossMachineMessage(messageId, targetDevice) {
+  const client = getClient();
+  const result = await client.execute({
+    sql: "SELECT * FROM messages WHERE id = ?",
+    args: [messageId]
+  });
+  if (result.rows.length === 0) return false;
+  const msg = rowToMessage(result.rows[0]);
+  if (msg.status !== "pending") return false;
+  if (!_wsClientSend) {
+    return false;
+  }
+  const payload = JSON.stringify({
+    id: msg.id,
+    fromAgent: msg.fromAgent,
+    targetAgent: msg.targetAgent,
+    targetProject: msg.targetProject,
+    sessionScope: msg.sessionScope,
+    content: msg.content,
+    priority: msg.priority,
+    createdAt: msg.createdAt
+  });
+  const sent = _wsClientSend(targetDevice, payload);
+  if (sent) {
+    await client.execute({
+      sql: "UPDATE messages SET status = 'synced' WHERE id = ?",
+      args: [messageId]
+    });
+    return true;
+  }
+  return false;
+}
+async function deliverLocalMessage(messageId) {
+  const client = getClient();
+  const result = await client.execute({
+    sql: "SELECT * FROM messages WHERE id = ?",
+    args: [messageId]
+  });
+  if (result.rows.length === 0) return false;
+  const msg = rowToMessage(result.rows[0]);
+  if (msg.status !== "pending") return false;
+  const targetAgent = msg.targetAgent;
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  try {
+    const exeSession = resolveExeSession();
+    if (!exeSession) {
+      throw new Error("No coordinator session found");
+    }
+    process.stderr.write(`[messaging] ENTER deliverLocal: target=${targetAgent} exeSession=${exeSession}
+`);
+    const { isCoordinatorName: isCoord } = await import("./lib/employees.js");
+    const isCOO = isCoord(targetAgent);
+    process.stderr.write(`[messaging] COO check: targetAgent="${targetAgent}" isCOO=${isCOO}
+`);
+    const sessionName = isCOO ? exeSession : employeeSessionName(targetAgent, exeSession);
+    process.stderr.write(`[messaging] delivery attempt: target=${targetAgent} session=${sessionName} isCOO=${isCOO}
+`);
+    if (!isCOO && !isEmployeeAlive(sessionName)) {
+      throw new Error("Session not running \u2014 message stays queued");
+    }
+    const unreadCount = await countUnreadMessages(targetAgent, msg.sessionScope);
+    if (unreadCount <= 0) {
+      return false;
+    }
+    const intercomResult = sendIntercom(sessionName, { force: true, reason: "message" });
+    process.stderr.write(`[messaging] intercom result for ${sessionName}: ${intercomResult}
+`);
+    await client.execute({
+      sql: "UPDATE messages SET status = 'delivered', delivered_at = ? WHERE id = ?",
+      args: [now, messageId]
+    });
+    recordOrchestrationEventBestEffort({
+      eventType: "message.delivered",
+      source: "messaging.deliverLocalMessage",
+      agentId: msg.targetAgent,
+      payload: { fromAgent: msg.fromAgent, priority: msg.priority }
+    });
+    return true;
+  } catch (err) {
+    process.stderr.write(
+      `[messaging] delivery failed for message ${messageId}: ${err instanceof Error ? err.message : String(err)}
+`
+    );
+    const newRetryCount = msg.retryCount + 1;
+    if (newRetryCount >= MAX_RETRIES) {
+      await markFailed(messageId, "session unavailable after 10 retries", msg.sessionScope);
+    } else {
+      await client.execute({
+        sql: "UPDATE messages SET retry_count = ? WHERE id = ?",
+        args: [newRetryCount, messageId]
+      });
+    }
+    return false;
+  }
+}
+async function getPendingMessages(targetAgent, sessionScope) {
+  const client = getClient();
+  const scope = strictSessionScopeFilter(sessionScope);
+  const result = await client.execute({
+    sql: `SELECT * FROM messages
+          WHERE target_agent = ? AND status IN ('pending', 'delivered')${scope.sql}
+          ORDER BY id`,
+    args: [targetAgent, ...scope.args]
+  });
+  return result.rows.map((row) => rowToMessage(row));
+}
+async function markRead(messageId, sessionScope) {
+  const client = getClient();
+  const scope = strictSessionScopeFilter(sessionScope);
+  await client.execute({
+    sql: `UPDATE messages SET status = 'read'
+          WHERE id = ? AND status IN ('pending', 'delivered')${scope.sql}`,
+    args: [messageId, ...scope.args]
+  });
+  recordOrchestrationEventBestEffort({
+    eventType: "message.read",
+    source: "messaging.markRead",
+    payload: { messageId }
+  });
+}
+async function markAcknowledged(messageId, sessionScope) {
+  const client = getClient();
+  const scope = strictSessionScopeFilter(sessionScope);
+  await client.execute({
+    sql: `UPDATE messages SET status = 'acknowledged', processed_at = ?
+          WHERE id = ? AND status = 'read'${scope.sql}`,
+    args: [(/* @__PURE__ */ new Date()).toISOString(), messageId, ...scope.args]
+  });
+}
+async function markProcessed(messageId, sessionScope) {
+  const client = getClient();
+  const scope = strictSessionScopeFilter(sessionScope);
+  await client.execute({
+    sql: `UPDATE messages SET status = 'processed', processed_at = ?
+          WHERE id = ?${scope.sql}`,
+    args: [(/* @__PURE__ */ new Date()).toISOString(), messageId, ...scope.args]
+  });
+}
+async function getMessageStatus(messageId, sessionScope) {
+  const client = getClient();
+  const scope = strictSessionScopeFilter(sessionScope);
+  const result = await client.execute({
+    sql: `SELECT status FROM messages WHERE id = ?${scope.sql}`,
+    args: [messageId, ...scope.args]
+  });
+  return result.rows[0]?.status ?? null;
+}
+async function getUnacknowledgedMessages(targetAgent, sessionScope) {
+  const client = getClient();
+  const scope = strictSessionScopeFilter(sessionScope);
+  const result = await client.execute({
+    sql: `SELECT * FROM messages
+          WHERE target_agent = ? AND status IN ('pending', 'delivered', 'read')${scope.sql}
+          ORDER BY id`,
+    args: [targetAgent, ...scope.args]
+  });
+  return result.rows.map((row) => rowToMessage(row));
+}
+async function getReadMessages(targetAgent, sessionScope) {
+  const client = getClient();
+  const scope = strictSessionScopeFilter(sessionScope);
+  const result = await client.execute({
+    sql: `SELECT * FROM messages
+          WHERE target_agent = ? AND status = 'read'${scope.sql}
+          ORDER BY id`,
+    args: [targetAgent, ...scope.args]
+  });
+  return result.rows.map((row) => rowToMessage(row));
+}
+async function markFailed(messageId, reason, sessionScope) {
+  const client = getClient();
+  const scope = strictSessionScopeFilter(sessionScope);
+  await client.execute({
+    sql: `UPDATE messages SET status = 'failed', failed_at = ?, failure_reason = ?
+          WHERE id = ?${scope.sql}`,
+    args: [(/* @__PURE__ */ new Date()).toISOString(), reason, messageId, ...scope.args]
+  });
+}
+async function getFailedMessages(sessionScope) {
+  const client = getClient();
+  const scope = strictSessionScopeFilter(sessionScope);
+  const result = await client.execute({
+    sql: `SELECT * FROM messages WHERE status = 'failed'${scope.sql} ORDER BY created_at DESC`,
+    args: [...scope.args]
+  });
+  return result.rows.map((row) => rowToMessage(row));
+}
+async function retryPendingMessages(sessionScope) {
+  const client = getClient();
+  const scope = strictSessionScopeFilter(sessionScope);
+  const result = await client.execute({
+    sql: `SELECT * FROM messages
+          WHERE status = 'pending' AND retry_count < ?${scope.sql}
+          ORDER BY id`,
+    args: [MAX_RETRIES, ...scope.args]
+  });
+  let delivered = 0;
+  for (const row of result.rows) {
+    const msg = rowToMessage(row);
+    try {
+      const success = await deliverLocalMessage(msg.id);
+      if (success) delivered++;
+    } catch {
+    }
+  }
+  return delivered;
+}
+async function sendTypedMessage(envelope, targetAgent, opts) {
+  return sendMessage({
+    fromAgent: envelope.from,
+    targetAgent,
+    targetProject: opts?.targetProject,
+    targetDevice: opts?.targetDevice,
+    content: serializeMessage(envelope),
+    priority: opts?.priority,
+    sessionScope: opts?.sessionScope
+  });
+}
+function parseIncomingMessage(content) {
+  return parseMessage(content);
+}
+
+export {
+  countUnreadMessages,
+  sendMessage,
+  setWsClientSend,
+  deliverLocalMessage,
+  getPendingMessages,
+  markRead,
+  markAcknowledged,
+  markProcessed,
+  getMessageStatus,
+  getUnacknowledgedMessages,
+  getReadMessages,
+  markFailed,
+  getFailedMessages,
+  retryPendingMessages,
+  sendTypedMessage,
+  parseIncomingMessage
+};