@ozaiya/openclaw-channel 0.10.8 → 0.10.11

package/dist/src/actionConfirmation.d.ts

@@ -0,0 +1,37 @@
+import type { OzaiyaMessageContent } from "./types.js";
+export type ActionCardStatus = "pending" | "approved" | "rejected" | "expired";
+export interface ActionCardContent {
+    action: string;
+    actionId: string;
+    status: ActionCardStatus;
+    params: Record<string, unknown>;
+    label?: string;
+}
+export interface ConfirmationDeps {
+    sendEncrypted: (groupId: string, content: OzaiyaMessageContent) => Promise<{
+        message: {
+            id: string;
+        };
+    }>;
+    editEncrypted: (groupId: string, messageId: string, content: OzaiyaMessageContent) => Promise<void>;
+}
+/**
+ * Send a confirmation card and block until the user approves, rejects, or timeout.
+ *
+ * @returns `true` if approved, `false` if rejected or timed out.
+ */
+export declare function requestConfirmation(deps: ConfirmationDeps, groupId: string, action: string, params: Record<string, unknown>, label?: string): Promise<boolean>;
+/**
+ * Check if a callback data string is an action confirmation callback.
+ * Returns parsed info or null.
+ */
+export declare function parseActionCallback(callbackData: string): {
+    actionId: string;
+    approved: boolean;
+} | null;
+/**
+ * Resolve a pending confirmation. Called when the user taps Approve/Reject.
+ *
+ * @returns `true` if the confirmation was found and resolved, `false` otherwise.
+ */
+export declare function resolveConfirmation(deps: ConfirmationDeps, actionId: string, approved: boolean): Promise<boolean>;

package/dist/src/actionConfirmation.js

@@ -0,0 +1,128 @@
+/**
+ * Action confirmation cards — human-in-the-loop approval for bot tool execution.
+ *
+ * When a bot tool (phone call, DM, group creation) is invoked, instead of executing
+ * immediately, we send a confirmation card to the chat. The user taps Approve/Reject
+ * via inline keyboard buttons. The tool's execute() blocks on a Promise that resolves
+ * when the user responds or a 5-minute timeout occurs.
+ *
+ * Callback data uses the `oz_ac:` prefix to distinguish from regular inline keyboard
+ * callbacks processed by the agent.
+ */
+import { randomBytes } from "node:crypto";
+// ─── Constants ───────────────────────────────────────────────────────────────
+const ACTION_CALLBACK_PREFIX = "oz_ac:";
+const CONFIRMATION_TIMEOUT_MS = 5 * 60 * 1000; // 5 minutes
+// ─── State ───────────────────────────────────────────────────────────────────
+const pendingConfirmations = new Map();
+// ─── Action label mapping (server-side fallback) ─────────────────────────────
+const ACTION_LABELS = {
+    make_phone_call: "Make Phone Call",
+    start_in_app_call: "Start Call",
+    message_user: "Send Direct Message",
+    create_group: "Create Group",
+};
+// ─── Public API ──────────────────────────────────────────────────────────────
+/**
+ * Send a confirmation card and block until the user approves, rejects, or timeout.
+ *
+ * @returns `true` if approved, `false` if rejected or timed out.
+ */
+export async function requestConfirmation(deps, groupId, action, params, label) {
+    const actionId = randomBytes(8).toString("hex");
+    const displayLabel = label ?? ACTION_LABELS[action] ?? action;
+    const actionCard = {
+        action,
+        actionId,
+        status: "pending",
+        params,
+        label: displayLabel,
+    };
+    const content = {
+        text: `⏳ ${displayLabel}`,
+        actionCard,
+        inlineKeyboard: {
+            rows: [[
+                    { text: "✅ Approve", callbackData: `${ACTION_CALLBACK_PREFIX}approve:${actionId}` },
+                    { text: "❌ Reject", callbackData: `${ACTION_CALLBACK_PREFIX}reject:${actionId}` },
+                ]],
+        },
+    };
+    const result = await deps.sendEncrypted(groupId, content);
+    return new Promise((resolve) => {
+        const timer = setTimeout(() => {
+            const entry = pendingConfirmations.get(actionId);
+            if (entry) {
+                pendingConfirmations.delete(actionId);
+                // Update card to show expired status
+                void updateCardStatus(deps, groupId, result.message.id, actionCard, "expired");
+                resolve(false);
+            }
+        }, CONFIRMATION_TIMEOUT_MS);
+        pendingConfirmations.set(actionId, {
+            messageId: result.message.id,
+            groupId,
+            resolve,
+            timer,
+        });
+    });
+}
+/**
+ * Check if a callback data string is an action confirmation callback.
+ * Returns parsed info or null.
+ */
+export function parseActionCallback(callbackData) {
+    if (!callbackData.startsWith(ACTION_CALLBACK_PREFIX))
+        return null;
+    const rest = callbackData.slice(ACTION_CALLBACK_PREFIX.length);
+    const colonIdx = rest.indexOf(":");
+    if (colonIdx < 0)
+        return null;
+    const verb = rest.slice(0, colonIdx);
+    const actionId = rest.slice(colonIdx + 1);
+    if (!actionId)
+        return null;
+    if (verb === "approve")
+        return { actionId, approved: true };
+    if (verb === "reject")
+        return { actionId, approved: false };
+    return null;
+}
+/**
+ * Resolve a pending confirmation. Called when the user taps Approve/Reject.
+ *
+ * @returns `true` if the confirmation was found and resolved, `false` otherwise.
+ */
+export async function resolveConfirmation(deps, actionId, approved) {
+    const entry = pendingConfirmations.get(actionId);
+    if (!entry)
+        return false;
+    clearTimeout(entry.timer);
+    pendingConfirmations.delete(actionId);
+    // Update card to show final status and remove keyboard
+    const status = approved ? "approved" : "rejected";
+    await updateCardStatus(deps, entry.groupId, entry.messageId, undefined, status);
+    entry.resolve(approved);
+    return true;
+}
+// ─── Internal ────────────────────────────────────────────────────────────────
+async function updateCardStatus(deps, groupId, messageId, existingCard, newStatus) {
+    try {
+        const statusEmoji = newStatus === "approved" ? "✅" : newStatus === "rejected" ? "❌" : "⏰";
+        const statusLabel = newStatus === "approved" ? "Approved" : newStatus === "rejected" ? "Rejected" : "Expired";
+        const label = existingCard?.label ?? "";
+        const updatedCard = existingCard
+            ? { ...existingCard, status: newStatus }
+            : { action: "", actionId: "", status: newStatus, params: {} };
+        const updatedContent = {
+            text: `${statusEmoji} ${label} — ${statusLabel}`,
+            actionCard: updatedCard,
+            // No inlineKeyboard — removes the buttons
+        };
+        await deps.editEncrypted(groupId, messageId, updatedContent);
+    }
+    catch {
+        // Best-effort edit — don't let failure break the confirmation flow
+    }
+}
+//# sourceMappingURL=actionConfirmation.js.map

package/dist/src/actionConfirmation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actionConfirmation.js","sourceRoot":"","sources":["../../src/actionConfirmation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAsB1C,gFAAgF;AAEhF,MAAM,sBAAsB,GAAG,QAAQ,CAAC;AACxC,MAAM,uBAAuB,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,YAAY;AAE3D,gFAAgF;AAEhF,MAAM,oBAAoB,GAAG,IAAI,GAAG,EAA+B,CAAC;AASpE,gFAAgF;AAEhF,MAAM,aAAa,GAA2B;IAC5C,eAAe,EAAE,iBAAiB;IAClC,iBAAiB,EAAE,YAAY;IAC/B,YAAY,EAAE,qBAAqB;IACnC,YAAY,EAAE,cAAc;CAC7B,CAAC;AAEF,gFAAgF;AAEhF;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,IAAsB,EACtB,OAAe,EACf,MAAc,EACd,MAA+B,EAC/B,KAAc;IAEd,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAChD,MAAM,YAAY,GAAG,KAAK,IAAI,aAAa,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC;IAE9D,MAAM,UAAU,GAAsB;QACpC,MAAM;QACN,QAAQ;QACR,MAAM,EAAE,SAAS;QACjB,MAAM;QACN,KAAK,EAAE,YAAY;KACpB,CAAC;IAEF,MAAM,OAAO,GAAyB;QACpC,IAAI,EAAE,KAAK,YAAY,EAAE;QACzB,UAAU;QACV,cAAc,EAAE;YACd,IAAI,EAAE,CAAC;oBACL,EAAE,IAAI,EAAE,WAAW,EAAE,YAAY,EAAE,GAAG,sBAAsB,WAAW,QAAQ,EAAE,EAAE;oBACnF,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,EAAE,GAAG,sBAAsB,UAAU,QAAQ,EAAE,EAAE;iBAClF,CAAC;SACH;KACF,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAE1D,OAAO,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,EAAE;QACtC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,MAAM,KAAK,GAAG,oBAAoB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACjD,IAAI,KAAK,EAAE,CAAC;gBACV,oBAAoB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBACtC,qCAAqC;gBACrC,KAAK,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;gBAC/E,OAAO,CAAC,KAAK,CAAC,CAAC;YACjB,CAAC;QACH,CAAC,EAAE,uBAAuB,CAAC,CAAC;QAE5B,oBAAoB,CAAC,GAAG,CAAC,QAAQ,EAAE;YACjC,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE;YAC5B,OAAO;YACP,OAAO;YACP,KAAK;SACN,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,YAAoB;IAItD,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,sBAAsB,CAAC;QAAE,OAAO,IAAI,CAAC;IAClE,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC/D,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,QAAQ,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;IAC1C,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC5D,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAC5D,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,IAAsB,EACtB,QAAgB,EAChB,QAAiB;IAEjB,MAAM,KAAK,GAAG,oBAAoB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACjD,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IAEzB,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC1B,oBAAoB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAEtC,uDAAuD;IACvD,MAAM,MAAM,GAAqB,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC;IACpE,MAAM,gBAAgB,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IAEhF,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACxB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,gFAAgF;AAEhF,KAAK,UAAU,gBAAgB,CAC7B,IAAsB,EACtB,OAAe,EACf,SAAiB,EACjB,YAA2C,EAC3C,SAA2B;IAE3B,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,SAAS,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;QAC1F,MAAM,WAAW,GAAG,SAAS,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;QAC9G,MAAM,KAAK,GAAG,YAAY,EAAE,KAAK,IAAI,EAAE,CAAC;QAExC,MAAM,WAAW,GAAsB,YAAY;YACjD,CAAC,CAAC,EAAE,GAAG,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE;YACxC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QAEhE,MAAM,cAAc,GAAyB;YAC3C,IAAI,EAAE,GAAG,WAAW,IAAI,KAAK,MAAM,WAAW,EAAE;YAChD,UAAU,EAAE,WAAW;YACvB,0CAA0C;SAC3C,CAAC;QAEF,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC;IAC/D,CAAC;IAAC,MAAM,CAAC;QACP,mEAAmE;IACrE,CAAC;AACH,CAAC"}