@askexenow/exe-os 0.9.270 → 0.9.272

package/dist/chunk-SVFNKSZV.js

@@ -0,0 +1,333 @@
+import {
+  executeAction,
+  substituteTemplate
+} from "./chunk-7ET5CYTD.js";
+
+// src/automation/workflow-engine.ts
+import { randomUUID } from "crypto";
+var _definitions = /* @__PURE__ */ new Map();
+var _instances = /* @__PURE__ */ new Map();
+function createWorkflowDefinition(input) {
+  const def = {
+    id: randomUUID().slice(0, 12),
+    ...input,
+    created_at: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  def.steps = def.steps.map((s, i) => ({ ...s, index: s.index || i + 1 }));
+  _definitions.set(def.id, def);
+  return def;
+}
+function getWorkflowDefinition(id) {
+  return _definitions.get(id);
+}
+function listWorkflowDefinitions() {
+  return [..._definitions.values()];
+}
+function buildTemplateContext(instance) {
+  const ctx = { ...instance.context };
+  const stepMap = {};
+  for (const sr of instance.step_results) {
+    stepMap[String(sr.step_index)] = {
+      status: sr.status,
+      result: sr.result,
+      error: sr.error
+    };
+  }
+  ctx.step = stepMap;
+  return ctx;
+}
+function resolveActionParams(action, context) {
+  const resolved = {};
+  for (const [key, val] of Object.entries(action.params)) {
+    resolved[key] = substituteTemplate(val, context);
+  }
+  return { ...action, params: resolved };
+}
+function startWorkflow(definitionId, context = {}) {
+  const def = _definitions.get(definitionId);
+  if (!def) throw new Error(`Workflow definition "${definitionId}" not found`);
+  const instance = {
+    id: randomUUID().slice(0, 12),
+    definition_id: definitionId,
+    status: "running",
+    current_step: 1,
+    step_results: [],
+    context,
+    created_at: (/* @__PURE__ */ new Date()).toISOString(),
+    updated_at: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  _instances.set(instance.id, instance);
+  return instance;
+}
+function getWorkflowInstance(id) {
+  return _instances.get(id);
+}
+function listWorkflowInstances(status) {
+  const all = [..._instances.values()];
+  return status ? all.filter((i) => i.status === status) : all;
+}
+async function advanceWorkflow(instanceId) {
+  const instance = _instances.get(instanceId);
+  if (!instance) throw new Error(`Workflow instance "${instanceId}" not found`);
+  if (instance.status !== "running") {
+    throw new Error(`Workflow "${instanceId}" is ${instance.status}, cannot advance`);
+  }
+  const def = _definitions.get(instance.definition_id);
+  if (!def) throw new Error(`Workflow definition "${instance.definition_id}" not found`);
+  const step = def.steps.find((s) => s.index === instance.current_step);
+  if (!step) {
+    instance.status = "completed";
+    instance.updated_at = (/* @__PURE__ */ new Date()).toISOString();
+    return instance;
+  }
+  const templateCtx = buildTemplateContext(instance);
+  const stepResult = {
+    step_index: step.index,
+    status: "success",
+    started_at: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  switch (step.type) {
+    case "execute_action": {
+      const action = step.action ?? buildActionFromConnector(step);
+      if (!action) {
+        stepResult.status = "failed";
+        stepResult.error = "No action defined for execute_action step";
+        break;
+      }
+      const resolvedAction = resolveActionParams(action, templateCtx);
+      const result = await executeAction(resolvedAction, templateCtx);
+      stepResult.status = result.success ? "success" : "failed";
+      stepResult.result = result;
+      stepResult.error = result.error;
+      if (!result.success) {
+        instance.status = "failed";
+      }
+      break;
+    }
+    case "wait_for_approval": {
+      const { createTask } = await import("./lib/tasks.js");
+      const { getCoordinatorName } = await import("./lib/employees.js");
+      const message = step.approval_message ? substituteTemplate(step.approval_message, templateCtx) : `Workflow "${def.name}" step ${step.index} ("${step.name}") requires approval.`;
+      const task = await createTask({
+        title: `[Workflow Approval] ${def.name}: ${step.name}`,
+        assignedTo: getCoordinatorName(),
+        assignedBy: "workflow-engine",
+        projectName: "exe-os",
+        priority: "p1",
+        context: `${message}
+
+**Workflow:** ${def.name} (${instance.id})
+**Step:** ${step.index} \u2014 ${step.name}
+
+To approve: call approve_workflow_step with instance_id="${instance.id}"
+To reject: call approve_workflow_step with instance_id="${instance.id}" approved=false`,
+        baseDir: process.cwd()
+      });
+      instance.approval_task_id = task.id;
+      instance.status = "waiting_approval";
+      stepResult.status = "pending_approval";
+      break;
+    }
+    case "conditional": {
+      if (!step.condition) {
+        stepResult.status = "failed";
+        stepResult.error = "No condition defined for conditional step";
+        break;
+      }
+      const resolvedExpr = substituteTemplate(step.condition.expression, templateCtx);
+      const conditionMet = evaluateSimpleExpression(resolvedExpr);
+      stepResult.result = { expression: resolvedExpr, met: conditionMet };
+      if (conditionMet && step.condition.then_step) {
+        instance.current_step = step.condition.then_step;
+        stepResult.completed_at = (/* @__PURE__ */ new Date()).toISOString();
+        instance.step_results.push(stepResult);
+        instance.updated_at = (/* @__PURE__ */ new Date()).toISOString();
+        return instance;
+      } else if (!conditionMet && step.condition.else_step) {
+        instance.current_step = step.condition.else_step;
+        stepResult.completed_at = (/* @__PURE__ */ new Date()).toISOString();
+        instance.step_results.push(stepResult);
+        instance.updated_at = (/* @__PURE__ */ new Date()).toISOString();
+        return instance;
+      }
+      break;
+    }
+  }
+  stepResult.completed_at = (/* @__PURE__ */ new Date()).toISOString();
+  instance.step_results.push(stepResult);
+  if (instance.status === "running") {
+    const nextStep = def.steps.find((s) => s.index > step.index);
+    if (nextStep) {
+      instance.current_step = nextStep.index;
+    } else {
+      instance.status = "completed";
+    }
+  }
+  instance.updated_at = (/* @__PURE__ */ new Date()).toISOString();
+  return instance;
+}
+async function runWorkflow(instanceId) {
+  let instance = _instances.get(instanceId);
+  if (!instance) throw new Error(`Workflow instance "${instanceId}" not found`);
+  while (instance.status === "running") {
+    instance = await advanceWorkflow(instanceId);
+  }
+  return instance;
+}
+async function approveWorkflowStep(instanceId, approved = true) {
+  const instance = _instances.get(instanceId);
+  if (!instance) throw new Error(`Workflow instance "${instanceId}" not found`);
+  if (instance.status !== "waiting_approval") {
+    throw new Error(`Workflow "${instanceId}" is not waiting for approval (status: ${instance.status})`);
+  }
+  const pendingResult = instance.step_results.find(
+    (sr) => sr.step_index === instance.current_step && sr.status === "pending_approval"
+  );
+  if (pendingResult) {
+    pendingResult.status = approved ? "approved" : "failed";
+    pendingResult.completed_at = (/* @__PURE__ */ new Date()).toISOString();
+    pendingResult.result = { approved };
+  }
+  if (!approved) {
+    instance.status = "cancelled";
+    instance.updated_at = (/* @__PURE__ */ new Date()).toISOString();
+    return instance;
+  }
+  const def = _definitions.get(instance.definition_id);
+  if (!def) throw new Error(`Workflow definition "${instance.definition_id}" not found`);
+  const currentStep = def.steps.find((s) => s.index === instance.current_step);
+  const nextStep = currentStep ? def.steps.find((s) => s.index > currentStep.index) : void 0;
+  if (nextStep) {
+    instance.current_step = nextStep.index;
+    instance.status = "running";
+  } else {
+    instance.status = "completed";
+  }
+  instance.approval_task_id = void 0;
+  instance.updated_at = (/* @__PURE__ */ new Date()).toISOString();
+  if (instance.status === "running") {
+    return runWorkflow(instanceId);
+  }
+  return instance;
+}
+function buildActionFromConnector(step) {
+  if (!step.connector || !step.operation) return null;
+  const params = {};
+  if (step.payload) {
+    for (const [k, v] of Object.entries(step.payload)) {
+      params[k] = String(v);
+    }
+  }
+  params._connector = step.connector;
+  params._operation = step.operation;
+  return {
+    type: "mcp_tool",
+    params
+  };
+}
+function evaluateSimpleExpression(expr) {
+  const operators = ["==", "!=", ">=", "<=", ">", "<"];
+  for (const op of operators) {
+    const idx = expr.indexOf(op);
+    if (idx === -1) continue;
+    const left = expr.slice(0, idx).trim();
+    const right = expr.slice(idx + op.length).trim();
+    switch (op) {
+      case "==":
+        return left === right;
+      case "!=":
+        return left !== right;
+      case ">":
+        return Number(left) > Number(right);
+      case "<":
+        return Number(left) < Number(right);
+      case ">=":
+        return Number(left) >= Number(right);
+      case "<=":
+        return Number(left) <= Number(right);
+    }
+  }
+  return expr.trim() !== "" && expr.trim() !== "false" && expr.trim() !== "0";
+}
+async function persistWorkflows() {
+  try {
+    const { getClient } = await import("./lib/database.js");
+    const client = getClient();
+    for (const def of _definitions.values()) {
+      await client.execute({
+        sql: `INSERT OR REPLACE INTO workflow_definitions (id, name, description, steps, trigger_event, created_at)
+              VALUES (?, ?, ?, ?, ?, ?)`,
+        args: [def.id, def.name, def.description ?? null, JSON.stringify(def.steps), def.trigger_event ?? null, def.created_at]
+      });
+    }
+    for (const inst of _instances.values()) {
+      await client.execute({
+        sql: `INSERT OR REPLACE INTO workflow_instances
+              (id, definition_id, status, current_step, step_results, context, approval_task_id, created_at, updated_at)
+              VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+        args: [
+          inst.id,
+          inst.definition_id,
+          inst.status,
+          inst.current_step,
+          JSON.stringify(inst.step_results),
+          JSON.stringify(inst.context),
+          inst.approval_task_id ?? null,
+          inst.created_at,
+          inst.updated_at
+        ]
+      });
+    }
+  } catch (e) {
+    process.stderr.write(`[workflow-engine] persist failed: ${e instanceof Error ? e.message : String(e)}
+`);
+  }
+}
+async function loadWorkflows() {
+  try {
+    const { getClient } = await import("./lib/database.js");
+    const client = getClient();
+    const defs = await client.execute("SELECT * FROM workflow_definitions");
+    for (const row of defs.rows) {
+      const def = {
+        id: String(row.id),
+        name: String(row.name),
+        description: String(row.description),
+        steps: JSON.parse(String(row.steps)),
+        trigger_event: String(row.trigger_event),
+        created_at: String(row.created_at)
+      };
+      _definitions.set(def.id, def);
+    }
+    const insts = await client.execute("SELECT * FROM workflow_instances WHERE status NOT IN ('completed', 'cancelled')");
+    for (const row of insts.rows) {
+      const inst = {
+        id: String(row.id),
+        definition_id: String(row.definition_id),
+        status: String(row.status),
+        current_step: Number(row.current_step),
+        step_results: JSON.parse(String(row.step_results)),
+        context: JSON.parse(String(row.context)),
+        approval_task_id: row.approval_task_id ? String(row.approval_task_id) : void 0,
+        created_at: String(row.created_at),
+        updated_at: String(row.updated_at)
+      };
+      _instances.set(inst.id, inst);
+    }
+  } catch {
+  }
+}
+
+export {
+  createWorkflowDefinition,
+  getWorkflowDefinition,
+  listWorkflowDefinitions,
+  startWorkflow,
+  getWorkflowInstance,
+  listWorkflowInstances,
+  advanceWorkflow,
+  runWorkflow,
+  approveWorkflowStep,
+  persistWorkflows,
+  loadWorkflows
+};

package/dist/chunk-TAQT2DC7.js

@@ -0,0 +1,330 @@
+import {
+  employeeSessionName,
+  isEmployeeAlive,
+  resolveExeSession,
+  sendIntercom,
+  strictSessionScopeFilter
+} from "./chunk-5AS622MM.js";
+import {
+  parseMessage,
+  serializeMessage
+} from "./chunk-4JERP7NT.js";
+import {
+  recordOrchestrationEventBestEffort
+} from "./chunk-2NQQP3FF.js";
+import {
+  getClient
+} from "./chunk-CHBHR5W6.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 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 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 {
+  sendMessage,
+  setWsClientSend,
+  deliverLocalMessage,
+  getPendingMessages,
+  markRead,
+  markAcknowledged,
+  markProcessed,
+  getMessageStatus,
+  getUnacknowledgedMessages,
+  getReadMessages,
+  markFailed,
+  getFailedMessages,
+  retryPendingMessages,
+  sendTypedMessage,
+  parseIncomingMessage
+};