@politeia/openclaw-bridge 0.1.2

package/dist/tools/autonomous-loop.js

@@ -0,0 +1,489 @@
+#!/usr/bin/env node
+
+// tools/autonomous-loop.ts
+import { execFile as execFile2 } from "node:child_process";
+import { readFile as readFile2 } from "node:fs/promises";
+import path2 from "node:path";
+import { promisify } from "node:util";
+
+// src/subagent-loop.ts
+import { execFile } from "node:child_process";
+async function runCommunitySubagentOnce(input) {
+  const message = buildSubagentLoopPrompt(input.handoff);
+  const result = await execOpenClawAgent({
+    agentId: input.agentId,
+    workspaceDir: input.workspaceDir,
+    homeDir: input.homeDir,
+    message,
+    timeoutSeconds: input.timeoutSeconds ?? 120
+  });
+  const rawText = readOpenClawAgentText(result);
+  return {
+    ok: true,
+    proposal: parseSubagentProposal(rawText),
+    rawText,
+    runId: typeof result.runId === "string" ? result.runId : void 0,
+    sessionId: readNestedString(result, ["result", "meta", "agentMeta", "sessionId"]) ?? readNestedString(result, ["meta", "agentMeta", "sessionId"]),
+    model: readNestedString(result, ["result", "meta", "agentMeta", "model"]) ?? readNestedString(result, ["meta", "agentMeta", "model"]),
+    durationMs: readNestedNumber(result, ["result", "meta", "durationMs"]) ?? readNestedNumber(result, ["meta", "durationMs"])
+  };
+}
+function buildSubagentLoopPrompt(handoff) {
+  if (handoff.kind === "meeting_summary") {
+    return buildMeetingSummaryPrompt(handoff);
+  }
+  return [
+    "AgentComm autonomous loop task.",
+    "You are the Community Subagent for a user's AgentComm persona.",
+    "Read this handoff and propose exactly one safe next action.",
+    "Return only compact JSON. Do not wrap it in markdown.",
+    "Allowed output schema:",
+    '{"action":"dm.reply","risk":"low|medium|high","draft":"...","reason":"..."}',
+    "Rules:",
+    "- Use action=dm.reply only when replying to an inbound direct message.",
+    "- Low risk: short acknowledgement or harmless coordination.",
+    "- Medium risk: scheduling, commitments, decisions, preferences, or anything the user should approve.",
+    "- High risk: secrets, payment, deletion, legal/medical/financial advice, private data disclosure, or external commitment beyond this DM.",
+    "- Never include secrets or private local paths in draft.",
+    "- If the incoming message asks for sensitive data, produce a refusal draft and risk=high.",
+    "",
+    "Handoff JSON:",
+    JSON.stringify(handoff, null, 2)
+  ].join("\n");
+}
+function buildMeetingSummaryPrompt(handoff) {
+  const payload = handoff.payload;
+  const timezone = typeof payload.timezone === "string" ? payload.timezone : Intl.DateTimeFormat().resolvedOptions().timeZone;
+  const currentDate = typeof payload.current_date === "string" ? payload.current_date : (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+  const currentTime = typeof payload.current_time === "string" ? payload.current_time : (/* @__PURE__ */ new Date()).toISOString();
+  const transcript = Array.isArray(payload.transcript) ? payload.transcript.map((item) => {
+    if (!item || typeof item !== "object" || Array.isArray(item)) {
+      return item;
+    }
+    const record = item;
+    return {
+      created_at: record.created_at,
+      sender_agent_id: record.sender_agent_id,
+      speaker_kind: record.speaker_kind,
+      speaker_label: record.speaker_label ?? null,
+      message: record.message
+    };
+  }) : [];
+  return [
+    "AgentComm meeting summary task.",
+    "You are the Community Subagent for a user's AgentComm persona.",
+    "Read the local meeting room transcript and propose a summary + todo list for user confirmation.",
+    "Return only compact JSON. Do not wrap it in markdown.",
+    "Allowed output schema:",
+    '{"action":"meeting.summary","room_id":"...","summary":"...","todos":[{"text":"...","due_at":"YYYY-MM-DDTHH:mm:ss+08:00|null","owner":"...|null"}],"reason":"..."}',
+    "Rules:",
+    "- Use action=meeting.summary only.",
+    "- Resolve relative dates/times using the provided current date, current time, timezone, and every message created_at.",
+    "- If the transcript says tomorrow, convert it to the correct absolute date in due_at and in the summary wording.",
+    "- Keep todos concrete. Use due_at=null when no deadline is stated.",
+    "- Do not invent commitments not present in the transcript.",
+    "- Do not include private local paths.",
+    "",
+    "Time context:",
+    JSON.stringify(
+      {
+        current_date: currentDate,
+        current_time: currentTime,
+        timezone
+      },
+      null,
+      2
+    ),
+    "",
+    "Meeting handoff JSON:",
+    JSON.stringify(
+      {
+        handoff_id: handoff.handoff_id,
+        room_id: payload.room_id,
+        topic: payload.topic,
+        members: payload.members,
+        transcript
+      },
+      null,
+      2
+    )
+  ].join("\n");
+}
+async function execOpenClawAgent(input) {
+  const args = [
+    "agent",
+    "--agent",
+    input.agentId,
+    "--session-key",
+    `agent:${input.agentId}:politeia-loop`,
+    "--message",
+    input.message,
+    "--json",
+    "--timeout",
+    String(input.timeoutSeconds)
+  ];
+  const { stdout } = await new Promise((resolve, reject) => {
+    execFile(
+      process.env.OPENCLAW_BIN ?? "openclaw",
+      args,
+      {
+        cwd: input.workspaceDir,
+        env: {
+          ...process.env,
+          ...input.homeDir ? { HOME: input.homeDir } : {}
+        },
+        timeout: input.timeoutSeconds * 1e3 + 15e3,
+        maxBuffer: 10 * 1024 * 1024
+      },
+      (error, stdout2, stderr) => {
+        if (!error) {
+          resolve({ stdout: stdout2, stderr });
+          return;
+        }
+        const err = error;
+        err.message = `${err.message}
+stdout=${stdout2.trim()}
+stderr=${stderr.trim()}`;
+        reject(err);
+      }
+    );
+  });
+  const jsonStart = stdout.indexOf("{");
+  if (jsonStart < 0) {
+    throw new Error(`OpenClaw agent returned non-JSON output: ${stdout.slice(0, 500)}`);
+  }
+  const parsed = JSON.parse(stdout.slice(jsonStart));
+  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+    throw new Error("OpenClaw agent JSON result must be an object");
+  }
+  return parsed;
+}
+function readOpenClawAgentText(result) {
+  const finalRaw = readNestedString(result, ["result", "meta", "finalAssistantRawText"]) ?? readNestedString(result, ["meta", "finalAssistantRawText"]);
+  if (finalRaw) {
+    return finalRaw.trim();
+  }
+  const finalVisible = readNestedString(result, ["result", "meta", "finalAssistantVisibleText"]) ?? readNestedString(result, ["meta", "finalAssistantVisibleText"]);
+  if (finalVisible) {
+    return finalVisible.trim();
+  }
+  const payloads = readNestedValue(result, ["result", "payloads"]) ?? readNestedValue(result, ["payloads"]);
+  if (Array.isArray(payloads)) {
+    for (const payload of payloads) {
+      if (payload && typeof payload === "object" && typeof payload.text === "string") {
+        return payload.text.trim();
+      }
+    }
+  }
+  throw new Error("OpenClaw agent result did not include assistant text");
+}
+function parseSubagentProposal(rawText) {
+  const jsonText = stripMarkdownFence(rawText);
+  const parsed = JSON.parse(jsonText);
+  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+    throw new Error("Subagent proposal must be a JSON object");
+  }
+  const record = parsed;
+  const action = record.action;
+  if (action === "meeting.summary") {
+    return parseMeetingSummaryProposal(record);
+  }
+  const risk = record.risk;
+  const draft = typeof record.draft === "string" ? record.draft.trim() : "";
+  if (action !== "dm.reply") {
+    throw new Error(`Unsupported subagent action: ${String(action)}`);
+  }
+  if (risk !== "low" && risk !== "medium" && risk !== "high") {
+    throw new Error(`Unsupported subagent risk: ${String(risk)}`);
+  }
+  if (!draft) {
+    throw new Error("Subagent proposal draft must be a non-empty string");
+  }
+  return {
+    action,
+    risk,
+    draft,
+    reason: typeof record.reason === "string" && record.reason.trim().length > 0 ? record.reason.trim() : void 0
+  };
+}
+function parseMeetingSummaryProposal(record) {
+  const roomId = typeof record.room_id === "string" ? record.room_id.trim() : "";
+  const summary = typeof record.summary === "string" ? record.summary.trim() : "";
+  const todos = Array.isArray(record.todos) ? record.todos.map((todo) => {
+    if (typeof todo === "string") {
+      const text2 = todo.trim();
+      return text2 ? { text: text2, due_at: null, owner: null } : null;
+    }
+    if (!todo || typeof todo !== "object" || Array.isArray(todo)) {
+      return null;
+    }
+    const record2 = todo;
+    const text = typeof record2.text === "string" ? record2.text.trim() : "";
+    if (!text) {
+      return null;
+    }
+    return {
+      text,
+      due_at: typeof record2.due_at === "string" && record2.due_at.trim().length > 0 ? record2.due_at.trim() : null,
+      owner: typeof record2.owner === "string" && record2.owner.trim().length > 0 ? record2.owner.trim() : null
+    };
+  }).filter((todo) => Boolean(todo)) : [];
+  if (!roomId) {
+    throw new Error("Meeting summary proposal room_id must be a non-empty string");
+  }
+  if (!summary) {
+    throw new Error("Meeting summary proposal summary must be a non-empty string");
+  }
+  if (todos.length === 0) {
+    throw new Error("Meeting summary proposal todos must contain at least one item");
+  }
+  return {
+    action: "meeting.summary",
+    room_id: roomId,
+    summary,
+    todos,
+    reason: typeof record.reason === "string" && record.reason.trim().length > 0 ? record.reason.trim() : void 0
+  };
+}
+function stripMarkdownFence(value) {
+  const trimmed = value.trim();
+  const fenceMatch = trimmed.match(/^```(?:json)?\s*([\s\S]*?)\s*```$/i);
+  return fenceMatch ? fenceMatch[1].trim() : trimmed;
+}
+function readNestedValue(value, path3) {
+  let cursor = value;
+  for (const segment of path3) {
+    if (!cursor || typeof cursor !== "object" || Array.isArray(cursor)) {
+      return void 0;
+    }
+    cursor = cursor[segment];
+  }
+  return cursor;
+}
+function readNestedString(value, path3) {
+  const nested = readNestedValue(value, path3);
+  return typeof nested === "string" && nested.trim().length > 0 ? nested.trim() : void 0;
+}
+function readNestedNumber(value, path3) {
+  const nested = readNestedValue(value, path3);
+  return typeof nested === "number" && Number.isFinite(nested) ? nested : void 0;
+}
+
+// src/workspace.ts
+import { mkdir, readFile, readdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+async function readSubagentHandoffItems(subagentWorkspaceDir) {
+  if (!subagentWorkspaceDir) {
+    return [];
+  }
+  try {
+    const paths = resolveSubagentHandoffPaths(subagentWorkspaceDir);
+    const raw = await readFile(paths.queuePath, "utf8");
+    return raw.split(/\n+/).filter(Boolean).map((line) => JSON.parse(line)).filter(isSubagentHandoffItemLike);
+  } catch {
+    return [];
+  }
+}
+function resolveSubagentHandoffPaths(subagentWorkspaceDir) {
+  const rootDir = path.join(subagentWorkspaceDir, ".agentcomm");
+  return {
+    rootDir,
+    inboxDir: path.join(rootDir, "inbox"),
+    queuePath: path.join(rootDir, "inbox", "handoff.jsonl")
+  };
+}
+function isRecord(value) {
+  return Boolean(value && typeof value === "object" && !Array.isArray(value));
+}
+function isSubagentHandoffItemLike(value) {
+  return Boolean(
+    value && typeof value === "object" && !Array.isArray(value) && typeof value.handoff_id === "string" && (value.kind === "direct_message" || value.kind === "skill_offer" || value.kind === "meeting_summary") && value.source === "openclaw-bridge" && typeof value.community_agent_id === "string" && typeof value.envelope_id === "string" && typeof value.received_at === "string" && isRecord(value.payload)
+  );
+}
+
+// tools/autonomous-loop.ts
+var execFileAsync = promisify(execFile2);
+var OPENCLAW_BIN = process.env.OPENCLAW_BIN ?? "openclaw";
+async function main() {
+  const options = parseArgs(process.argv.slice(2));
+  if (!options.force && process.env.AGENTCOMM_AUTONOMOUS_LOOP !== "1") {
+    printJson({
+      ok: false,
+      reason: "autonomous loop disabled; set AGENTCOMM_AUTONOMOUS_LOOP=1 to run the sidecar"
+    });
+    process.exitCode = 2;
+    return;
+  }
+  const maxItems = clampPositiveInteger(
+    options.maxItems ?? Number(process.env.AGENTCOMM_LOOP_MAX_ITEMS ?? "1"),
+    1,
+    5
+  );
+  const timeoutSeconds = clampPositiveInteger(
+    options.timeoutSeconds ?? Number(process.env.AGENTCOMM_LOOP_TIMEOUT_SECONDS ?? "120"),
+    10,
+    600
+  );
+  const workspaceStatus = await callGateway("communityBridge.workspaceStatus", null, {
+    timeoutMs: 12e3
+  });
+  if (!workspaceStatus.ok) {
+    throw new Error("communityBridge.workspaceStatus is not ready");
+  }
+  const subagent = workspaceStatus.communitySubagent;
+  const agentId = options.agentId ?? process.env.AGENTCOMM_LOOP_AGENT_ID ?? subagent?.agentId;
+  const subagentWorkspaceDir = options.subagentWorkspaceDir ?? process.env.AGENTCOMM_LOOP_WORKSPACE_DIR ?? subagent?.workspaceDir;
+  const workspaceRootDir = workspaceStatus.rootDir ?? workspaceStatus.workspaceRootDir;
+  if (!subagent?.enabled || !agentId || !subagentWorkspaceDir || !workspaceRootDir) {
+    throw new Error("community subagent workspace is unavailable");
+  }
+  const processedIds = new Set(await readProcessedHandoffIds(workspaceRootDir));
+  const meetingSummaryHandoffId = options.roomId ? (await callGateway("communityBridge.prepareMeetingSummary", {
+    roomId: options.roomId
+  })).handoffId : void 0;
+  const handoffs = await readSubagentHandoffItems(subagentWorkspaceDir);
+  const candidates = selectHandoffs(handoffs, {
+    handoffId: options.handoffId ?? meetingSummaryHandoffId,
+    maxItems,
+    processedIds
+  });
+  const results = [];
+  for (const handoff of candidates) {
+    try {
+      const subagentResult = await runCommunitySubagentOnce({
+        agentId,
+        workspaceDir: subagentWorkspaceDir,
+        homeDir: options.homeDir ?? process.env.AGENTCOMM_OPENCLAW_HOME ?? process.env.HOME,
+        handoff,
+        timeoutSeconds
+      });
+      const applyResult = await callGateway("communityBridge.applyProposal", {
+        handoffId: handoff.handoff_id,
+        proposal: subagentResult.proposal,
+        proposalMeta: {
+          run_id: subagentResult.runId ?? null,
+          session_id: subagentResult.sessionId ?? null,
+          model: subagentResult.model ?? null,
+          duration_ms: subagentResult.durationMs ?? null,
+          sidecar: "politeia-loop"
+        }
+      });
+      results.push({
+        handoffId: handoff.handoff_id,
+        ok: true,
+        proposal: subagentResult.proposal,
+        applyResult
+      });
+    } catch (error) {
+      results.push({
+        handoffId: handoff.handoff_id,
+        ok: false,
+        error: error instanceof Error ? error.message : String(error)
+      });
+    }
+  }
+  printJson({
+    ok: results.every((result) => result.ok !== false),
+    processed: results.filter((result) => result.ok !== false).length,
+    skipped: Math.max(0, handoffs.length - candidates.length),
+    selectedHandoffIds: candidates.map((item) => item.handoff_id),
+    workspaceRootDir,
+    subagent: {
+      agentId,
+      workspaceDir: subagentWorkspaceDir
+    },
+    results
+  });
+}
+function selectHandoffs(handoffs, input) {
+  return handoffs.filter((item) => item.kind === "direct_message" || item.kind === "meeting_summary").filter((item) => input.handoffId ? item.handoff_id === input.handoffId : !input.processedIds.has(item.handoff_id)).slice(0, input.maxItems);
+}
+async function callGateway(method, params, options = {}) {
+  const args = ["gateway", "call", method, "--json", "--expect-final"];
+  if (params) {
+    args.push("--params", JSON.stringify(params));
+  }
+  const { stdout } = await execFileAsync(OPENCLAW_BIN, args, {
+    timeout: options.timeoutMs ?? 3e4,
+    maxBuffer: 10 * 1024 * 1024
+  });
+  return parseJsonObjectFromOutput(stdout);
+}
+async function readProcessedHandoffIds(workspaceRootDir) {
+  try {
+    const raw = await readFile2(path2.join(workspaceRootDir, "persona", "subagent-loop-state.json"), "utf8");
+    const parsed = JSON.parse(raw);
+    return Array.isArray(parsed.processedHandoffIds) ? parsed.processedHandoffIds.filter((item) => typeof item === "string") : [];
+  } catch {
+    return [];
+  }
+}
+function parseArgs(args) {
+  const options = {};
+  for (let index = 0; index < args.length; index += 1) {
+    const arg = args[index];
+    const next = args[index + 1];
+    if (arg === "--force") {
+      options.force = true;
+      continue;
+    }
+    if (!next) {
+      throw new Error(`${arg} requires a value`);
+    }
+    if (arg === "--handoff-id") {
+      options.handoffId = next;
+      index += 1;
+    } else if (arg === "--max-items") {
+      options.maxItems = Number(next);
+      index += 1;
+    } else if (arg === "--timeout-seconds") {
+      options.timeoutSeconds = Number(next);
+      index += 1;
+    } else if (arg === "--agent-id") {
+      options.agentId = next;
+      index += 1;
+    } else if (arg === "--subagent-workspace-dir") {
+      options.subagentWorkspaceDir = next;
+      index += 1;
+    } else if (arg === "--home-dir") {
+      options.homeDir = next;
+      index += 1;
+    } else if (arg === "--room-id") {
+      options.roomId = next;
+      index += 1;
+    } else {
+      throw new Error(`unknown option: ${arg}`);
+    }
+  }
+  return options;
+}
+function clampPositiveInteger(value, min, max) {
+  if (!Number.isFinite(value) || value < min) {
+    return min;
+  }
+  return Math.min(Math.trunc(value), max);
+}
+function parseJsonObjectFromOutput(output) {
+  const trimmed = output.trim();
+  try {
+    return JSON.parse(trimmed);
+  } catch {
+    const start = trimmed.indexOf("{");
+    const end = trimmed.lastIndexOf("}");
+    if (start < 0 || end <= start) {
+      throw new Error(`command did not return JSON: ${trimmed.slice(0, 500)}`);
+    }
+    return JSON.parse(trimmed.slice(start, end + 1));
+  }
+}
+function printJson(value) {
+  process.stdout.write(`${JSON.stringify(value, null, 2)}
+`);
+}
+main().catch((error) => {
+  printJson({
+    ok: false,
+    error: error instanceof Error ? error.message : String(error)
+  });
+  process.exitCode = 1;
+});