hiloop-openclaw 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,32 @@
+import { HiloopChannelMonitor, HiloopChannelSender, type Gateway } from "./src/channel.js";
+import { type ToolRegistrar } from "./src/tools.js";
+export type { HiloopConfig } from "./src/config.js";
+export { HiloopConfigSchema } from "./src/config.js";
+export { HiloopApiClient } from "./src/api-client.js";
+export { HiloopChannelMonitor, HiloopChannelSender, } from "./src/channel.js";
+export { registerHiloopTools } from "./src/tools.js";
+export interface PluginContext {
+    config: {
+        channels: {
+            hiloop?: Record<string, unknown>;
+        };
+    };
+    gateway: Gateway & ToolRegistrar;
+    logger: {
+        info(msg: string, ...args: unknown[]): void;
+        warn(msg: string, ...args: unknown[]): void;
+        error(msg: string, ...args: unknown[]): void;
+    };
+}
+/**
+ * OpenClaw plugin entry point.
+ *
+ * Called by the OpenClaw runtime when this plugin is loaded.
+ * Reads config from `context.config.channels.hiloop`, sets up
+ * the channel monitor (inbound), sender (outbound), and tools.
+ */
+export declare function initialize(context: PluginContext): {
+    monitor: HiloopChannelMonitor;
+    sender: HiloopChannelSender;
+    shutdown: () => void;
+};

package/dist/index.js

@@ -0,0 +1,41 @@
+import { HiloopConfigSchema } from "./src/config.js";
+import { HiloopApiClient } from "./src/api-client.js";
+import { HiloopChannelMonitor, HiloopChannelSender, } from "./src/channel.js";
+import { registerHiloopTools } from "./src/tools.js";
+export { HiloopConfigSchema } from "./src/config.js";
+export { HiloopApiClient } from "./src/api-client.js";
+export { HiloopChannelMonitor, HiloopChannelSender, } from "./src/channel.js";
+export { registerHiloopTools } from "./src/tools.js";
+/**
+ * OpenClaw plugin entry point.
+ *
+ * Called by the OpenClaw runtime when this plugin is loaded.
+ * Reads config from `context.config.channels.hiloop`, sets up
+ * the channel monitor (inbound), sender (outbound), and tools.
+ */
+export function initialize(context) {
+    const rawConfig = context.config.channels.hiloop;
+    if (!rawConfig) {
+        throw new Error("[hiloop] Missing channel config. Add channels.hiloop to your openclaw.json.");
+    }
+    const config = HiloopConfigSchema.parse(rawConfig);
+    const client = new HiloopApiClient(config);
+    // Set up channel monitor (human -> OpenClaw)
+    const monitor = new HiloopChannelMonitor(client, config, context.gateway);
+    // Set up channel sender (OpenClaw -> human)
+    const sender = new HiloopChannelSender(client, config);
+    // Register Hiloop-specific tools
+    registerHiloopTools(context.gateway, client, config);
+    // Start polling for inbound messages
+    monitor.start();
+    context.logger.info(`[hiloop] Channel active, polling every ${config.pollIntervalMs}ms`);
+    return {
+        monitor,
+        sender,
+        shutdown: () => {
+            monitor.stop();
+            context.logger.info("[hiloop] Channel stopped");
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAqB,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EACL,oBAAoB,EACpB,mBAAmB,GAEpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,mBAAmB,EAAsB,MAAM,gBAAgB,CAAC;AAGzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EACL,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAiBrD;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,OAAsB;IAK/C,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;IACjD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,6EAA6E,CAC9E,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAiB,kBAAkB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACjE,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC;IAE3C,6CAA6C;IAC7C,MAAM,OAAO,GAAG,IAAI,oBAAoB,CACtC,MAAM,EACN,MAAM,EACN,OAAO,CAAC,OAAO,CAChB,CAAC;IAEF,4CAA4C;IAC5C,MAAM,MAAM,GAAG,IAAI,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEvD,iCAAiC;IACjC,mBAAmB,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAErD,qCAAqC;IACrC,OAAO,CAAC,KAAK,EAAE,CAAC;IAChB,OAAO,CAAC,MAAM,CAAC,IAAI,CACjB,0CAA0C,MAAM,CAAC,cAAc,IAAI,CACpE,CAAC;IAEF,OAAO;QACL,OAAO;QACP,MAAM;QACN,QAAQ,EAAE,GAAG,EAAE;YACb,OAAO,CAAC,IAAI,EAAE,CAAC;YACf,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QAClD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/src/api-client.d.ts

@@ -0,0 +1,73 @@
+import type { HiloopConfig } from "./config.js";
+export interface CreateInteractionParams {
+    type: "approval" | "chat" | "review" | "form" | "notification" | "live_session" | "voice_call" | "payment" | "scheduled_call";
+    encryptedTitle: string;
+    encryptedDescription?: string;
+    priority?: "critical" | "high" | "normal" | "low";
+    deadlineMinutes?: number;
+    encryptedOptions?: string;
+    encryptedFormSchema?: string;
+}
+export interface Interaction {
+    id: string;
+    type: string;
+    status: string;
+    priority: string;
+    createdAt: string;
+    updatedAt: string;
+    encryptedTitle?: string;
+    encryptedDescription?: string;
+    encryptedOptions?: string;
+    encryptedResponse?: string;
+    respondedBy?: string;
+    respondedAt?: string;
+}
+export interface Message {
+    id: string;
+    interactionId: string;
+    sender: "agent" | "human";
+    encryptedContent: string;
+    createdAt: string;
+    senderName?: string;
+    senderId?: string;
+}
+export interface InteractionListResponse {
+    interactions: Interaction[];
+    total: number;
+    page: number;
+    pageSize: number;
+}
+export interface MessageListResponse {
+    messages: Message[];
+    total: number;
+    page: number;
+    pageSize: number;
+}
+export interface QuotaResponse {
+    used: number;
+    limit: number;
+    resetsAt: string;
+    plan: string;
+}
+export declare class HiloopApiClient {
+    private baseUrl;
+    private apiKey;
+    constructor(config: HiloopConfig);
+    private apiFetch;
+    createInteraction(params: CreateInteractionParams): Promise<Interaction>;
+    getInteraction(id: string): Promise<Interaction>;
+    awaitResponse(id: string, timeout?: number): Promise<Interaction>;
+    listInteractions(filters?: {
+        status?: string;
+        type?: string;
+        page?: number;
+    }): Promise<InteractionListResponse>;
+    cancelInteraction(id: string): Promise<Interaction>;
+    acknowledgeInteraction(id: string): Promise<Interaction>;
+    sendMessage(interactionId: string, content: string): Promise<Message>;
+    listMessages(interactionId: string, page?: number): Promise<MessageListResponse>;
+    checkQuota(): Promise<QuotaResponse>;
+    getTransitions(id: string): Promise<{
+        transitions: unknown[];
+    }>;
+}

package/dist/src/api-client.js

@@ -0,0 +1,69 @@
+export class HiloopApiClient {
+    baseUrl;
+    apiKey;
+    constructor(config) {
+        this.baseUrl = config.baseUrl.replace(/\/$/, "");
+        this.apiKey = config.apiKey;
+    }
+    async apiFetch(path, options = {}) {
+        const url = `${this.baseUrl}/v1${path}`;
+        const headers = {
+            "Content-Type": "application/json",
+            "X-API-Key": this.apiKey,
+            ...options.headers,
+        };
+        const res = await fetch(url, { ...options, headers });
+        const body = await res.json();
+        if (!res.ok) {
+            throw new Error(`Hiloop API error ${res.status}: ${body.error || JSON.stringify(body)}`);
+        }
+        return body;
+    }
+    async createInteraction(params) {
+        return this.apiFetch("/agent/interactions", {
+            method: "POST",
+            body: JSON.stringify(params),
+        });
+    }
+    async getInteraction(id) {
+        return this.apiFetch(`/agent/interactions/${id}`);
+    }
+    async awaitResponse(id, timeout = 30) {
+        return this.apiFetch(`/agent/interactions/${id}/await?timeout=${timeout}`);
+    }
+    async listInteractions(filters) {
+        const query = new URLSearchParams();
+        if (filters?.status)
+            query.set("status", filters.status);
+        if (filters?.type)
+            query.set("type", filters.type);
+        if (filters?.page)
+            query.set("page", String(filters.page));
+        const qs = query.toString();
+        return this.apiFetch(`/agent/interactions${qs ? `?${qs}` : ""}`);
+    }
+    async cancelInteraction(id) {
+        return this.apiFetch(`/agent/interactions/${id}`, {
+            method: "DELETE",
+        });
+    }
+    async acknowledgeInteraction(id) {
+        return this.apiFetch(`/agent/interactions/${id}/acknowledge`, { method: "POST" });
+    }
+    async sendMessage(interactionId, content) {
+        return this.apiFetch(`/agent/interactions/${interactionId}/messages`, {
+            method: "POST",
+            body: JSON.stringify({ encryptedContent: content }),
+        });
+    }
+    async listMessages(interactionId, page = 1) {
+        return this.apiFetch(`/agent/interactions/${interactionId}/messages?page=${page}`);
+    }
+    async checkQuota() {
+        return this.apiFetch("/agent/quota");
+    }
+    async getTransitions(id) {
+        return this.apiFetch(`/agent/interactions/${id}/transitions`);
+    }
+}
+//# sourceMappingURL=api-client.js.map

package/dist/src/api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.js","sourceRoot":"","sources":["../../src/api-client.ts"],"names":[],"mappings":"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"}

package/dist/src/channel.d.ts

@@ -0,0 +1,52 @@
+import type { HiloopApiClient } from "./api-client.js";
+import type { HiloopConfig } from "./config.js";
+export interface MessageEnvelope {
+    channel: string;
+    chatType: "dm" | "group";
+    sender: {
+        id: string;
+        name: string;
+    };
+    content: string;
+    threadId: string;
+    timestamp: string;
+    metadata?: Record<string, unknown>;
+}
+export interface ChannelStatusReport {
+    connected: boolean;
+    channel: string;
+    account?: string;
+    error?: string;
+    quotaUsed?: number;
+    quotaLimit?: number;
+}
+export interface Gateway {
+    handleChannelMessage(envelope: MessageEnvelope): Promise<void>;
+}
+export declare class HiloopChannelMonitor {
+    private client;
+    private config;
+    private gateway;
+    private deliveredInteractions;
+    private lastMessageIds;
+    private pollTimer;
+    constructor(client: HiloopApiClient, config: HiloopConfig, gateway: Gateway);
+    start(): void;
+    stop(): void;
+    private poll;
+    private deliverInteraction;
+    private checkNewMessages;
+    private filterNewMessages;
+}
+export declare class HiloopChannelSender {
+    private client;
+    private config;
+    private threadToInteraction;
+    constructor(client: HiloopApiClient, config: HiloopConfig);
+    /** Map an existing thread to a Hiloop interaction */
+    trackThread(threadId: string, interactionId: string): void;
+    send(threadId: string, content: string): Promise<{
+        interactionId: string;
+    }>;
+    getStatus(): Promise<ChannelStatusReport>;
+}

package/dist/src/channel.js

@@ -0,0 +1,168 @@
+export class HiloopChannelMonitor {
+    client;
+    config;
+    gateway;
+    deliveredInteractions = new Set();
+    lastMessageIds = new Map();
+    pollTimer = null;
+    constructor(client, config, gateway) {
+        this.client = client;
+        this.config = config;
+        this.gateway = gateway;
+    }
+    start() {
+        if (this.pollTimer)
+            return;
+        this.pollTimer = setInterval(() => void this.poll(), this.config.pollIntervalMs);
+        // Run an immediate first poll
+        void this.poll();
+    }
+    stop() {
+        if (this.pollTimer) {
+            clearInterval(this.pollTimer);
+            this.pollTimer = null;
+        }
+    }
+    async poll() {
+        try {
+            // Check for responded interactions
+            const { interactions } = await this.client.listInteractions({
+                status: "responded",
+            });
+            for (const interaction of interactions) {
+                if (!this.deliveredInteractions.has(interaction.id)) {
+                    await this.deliverInteraction(interaction);
+                    this.deliveredInteractions.add(interaction.id);
+                }
+            }
+            // Check for new messages on active chat interactions
+            const activeChats = await this.client.listInteractions({
+                status: "assigned",
+                type: "chat",
+            });
+            for (const chat of activeChats.interactions) {
+                await this.checkNewMessages(chat);
+            }
+        }
+        catch (err) {
+            console.error("[hiloop] Poll error:", err);
+        }
+    }
+    async deliverInteraction(interaction) {
+        // For chat interactions, deliver the latest messages
+        if (interaction.type === "chat") {
+            await this.checkNewMessages(interaction);
+            return;
+        }
+        // For other types (approval, review, form, etc.), deliver the response
+        const envelope = {
+            channel: "hiloop",
+            chatType: "dm",
+            sender: {
+                id: interaction.respondedBy || "unknown",
+                name: interaction.respondedBy || "Human",
+            },
+            content: interaction.encryptedResponse || "[responded]",
+            threadId: interaction.id,
+            timestamp: interaction.respondedAt || interaction.updatedAt,
+            metadata: {
+                interactionType: interaction.type,
+                status: interaction.status,
+                priority: interaction.priority,
+            },
+        };
+        await this.gateway.handleChannelMessage(envelope);
+    }
+    async checkNewMessages(interaction) {
+        try {
+            const { messages } = await this.client.listMessages(interaction.id);
+            const lastKnown = this.lastMessageIds.get(interaction.id);
+            const newMessages = this.filterNewMessages(messages, lastKnown);
+            for (const msg of newMessages) {
+                if (msg.sender === "human") {
+                    const envelope = {
+                        channel: "hiloop",
+                        chatType: "dm",
+                        sender: {
+                            id: msg.senderId || "unknown",
+                            name: msg.senderName || "Human",
+                        },
+                        content: msg.encryptedContent,
+                        threadId: interaction.id,
+                        timestamp: msg.createdAt,
+                        metadata: {
+                            messageId: msg.id,
+                            interactionType: interaction.type,
+                        },
+                    };
+                    await this.gateway.handleChannelMessage(envelope);
+                }
+            }
+            if (messages.length > 0) {
+                this.lastMessageIds.set(interaction.id, messages[messages.length - 1].id);
+            }
+        }
+        catch (err) {
+            console.error(`[hiloop] Error checking messages for ${interaction.id}:`, err);
+        }
+    }
+    filterNewMessages(messages, lastKnownId) {
+        if (!lastKnownId)
+            return messages;
+        const idx = messages.findIndex((m) => m.id === lastKnownId);
+        if (idx === -1)
+            return messages;
+        return messages.slice(idx + 1);
+    }
+}
+export class HiloopChannelSender {
+    client;
+    config;
+    // Maps OpenClaw threadId -> Hiloop interactionId
+    threadToInteraction = new Map();
+    constructor(client, config) {
+        this.client = client;
+        this.config = config;
+    }
+    /** Map an existing thread to a Hiloop interaction */
+    trackThread(threadId, interactionId) {
+        this.threadToInteraction.set(threadId, interactionId);
+    }
+    async send(threadId, content) {
+        const existingId = this.threadToInteraction.get(threadId);
+        if (existingId) {
+            // Send a message on the existing interaction
+            await this.client.sendMessage(existingId, content);
+            return { interactionId: existingId };
+        }
+        // Create a new chat interaction
+        const interaction = await this.client.createInteraction({
+            type: "chat",
+            encryptedTitle: content.slice(0, 100),
+            encryptedDescription: content,
+            priority: this.config.defaultPriority,
+        });
+        this.threadToInteraction.set(threadId, interaction.id);
+        return { interactionId: interaction.id };
+    }
+    async getStatus() {
+        try {
+            const quota = await this.client.checkQuota();
+            return {
+                connected: true,
+                channel: "hiloop",
+                account: quota.plan,
+                quotaUsed: quota.used,
+                quotaLimit: quota.limit,
+            };
+        }
+        catch (err) {
+            return {
+                connected: false,
+                channel: "hiloop",
+                error: err instanceof Error ? err.message : String(err),
+            };
+        }
+    }
+}
+//# sourceMappingURL=channel.js.map

package/dist/src/channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.js","sourceRoot":"","sources":["../../src/channel.ts"],"names":[],"mappings":"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"}

package/dist/src/config.d.ts

@@ -0,0 +1,21 @@
+import { z } from "zod";
+export declare const HiloopConfigSchema: z.ZodObject<{
+    apiKey: z.ZodString;
+    baseUrl: z.ZodDefault<z.ZodString>;
+    pollIntervalMs: z.ZodDefault<z.ZodNumber>;
+    defaultPriority: z.ZodDefault<z.ZodEnum<["critical", "high", "normal", "low"]>>;
+    dmPolicy: z.ZodDefault<z.ZodEnum<["pairing", "allowlist", "open"]>>;
+}, "strip", z.ZodTypeAny, {
+    apiKey: string;
+    baseUrl: string;
+    pollIntervalMs: number;
+    defaultPriority: "critical" | "high" | "normal" | "low";
+    dmPolicy: "pairing" | "allowlist" | "open";
+}, {
+    apiKey: string;
+    baseUrl?: string | undefined;
+    pollIntervalMs?: number | undefined;
+    defaultPriority?: "critical" | "high" | "normal" | "low" | undefined;
+    dmPolicy?: "pairing" | "allowlist" | "open" | undefined;
+}>;
+export type HiloopConfig = z.infer<typeof HiloopConfigSchema>;

package/dist/src/config.js

@@ -0,0 +1,23 @@
+import { z } from "zod";
+export const HiloopConfigSchema = z.object({
+    apiKey: z
+        .string()
+        .startsWith("hlp_", "API key must start with hlp_"),
+    baseUrl: z
+        .string()
+        .url()
+        .default("https://api.hi-loop.com"),
+    pollIntervalMs: z
+        .number()
+        .int()
+        .min(500)
+        .max(30_000)
+        .default(2000),
+    defaultPriority: z
+        .enum(["critical", "high", "normal", "low"])
+        .default("normal"),
+    dmPolicy: z
+        .enum(["pairing", "allowlist", "open"])
+        .default("pairing"),
+});
+//# sourceMappingURL=config.js.map

package/dist/src/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,UAAU,CAAC,MAAM,EAAE,8BAA8B,CAAC;IACrD,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,GAAG,EAAE;SACL,OAAO,CAAC,yBAAyB,CAAC;IACrC,cAAc,EAAE,CAAC;SACd,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,GAAG,CAAC;SACR,GAAG,CAAC,MAAM,CAAC;SACX,OAAO,CAAC,IAAI,CAAC;IAChB,eAAe,EAAE,CAAC;SACf,IAAI,CAAC,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;SAC3C,OAAO,CAAC,QAAQ,CAAC;IACpB,QAAQ,EAAE,CAAC;SACR,IAAI,CAAC,CAAC,SAAS,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;SACtC,OAAO,CAAC,SAAS,CAAC;CACtB,CAAC,CAAC"}

package/dist/src/tools.d.ts

@@ -0,0 +1,12 @@
+import { z } from "zod";
+import type { HiloopApiClient } from "./api-client.js";
+import type { HiloopConfig } from "./config.js";
+export interface ToolRegistrar {
+    registerTool(def: {
+        name: string;
+        description: string;
+        schema: z.ZodObject<z.ZodRawShape>;
+        handler: (params: Record<string, unknown>) => Promise<unknown>;
+    }): void;
+}
+export declare function registerHiloopTools(registrar: ToolRegistrar, client: HiloopApiClient, config: HiloopConfig): void;

package/dist/src/tools.js

@@ -0,0 +1,197 @@
+import { z } from "zod";
+export function registerHiloopTools(registrar, client, config) {
+    registrar.registerTool({
+        name: "hiloop_request_approval",
+        description: "Request approval from a human via Hiloop. Use when you need permission " +
+            "to proceed with a dangerous or irreversible action.",
+        schema: z.object({
+            title: z.string().describe("What you need approved"),
+            options: z
+                .array(z.string())
+                .default(["Approve", "Deny"])
+                .describe("Choices for the human (default: Approve/Deny)"),
+            priority: z
+                .enum(["critical", "high", "normal", "low"])
+                .default(config.defaultPriority)
+                .describe("Priority level"),
+            deadlineMinutes: z
+                .number()
+                .optional()
+                .describe("Deadline in minutes from now"),
+            description: z
+                .string()
+                .optional()
+                .describe("Additional context for the human"),
+        }),
+        handler: async (params) => {
+            const interaction = await client.createInteraction({
+                type: "approval",
+                encryptedTitle: params.title,
+                encryptedDescription: params.description,
+                encryptedOptions: JSON.stringify(params.options),
+                priority: params.priority || config.defaultPriority,
+                deadlineMinutes: params.deadlineMinutes,
+            });
+            return { interactionId: interaction.id, status: interaction.status };
+        },
+    });
+    registrar.registerTool({
+        name: "hiloop_request_review",
+        description: "Request a human review of content, code, or a document via Hiloop.",
+        schema: z.object({
+            title: z.string().describe("What needs to be reviewed"),
+            description: z
+                .string()
+                .optional()
+                .describe("Content or details to review"),
+            priority: z
+                .enum(["critical", "high", "normal", "low"])
+                .default(config.defaultPriority),
+            deadlineMinutes: z.number().optional(),
+        }),
+        handler: async (params) => {
+            const interaction = await client.createInteraction({
+                type: "review",
+                encryptedTitle: params.title,
+                encryptedDescription: params.description,
+                priority: params.priority || config.defaultPriority,
+                deadlineMinutes: params.deadlineMinutes,
+            });
+            return { interactionId: interaction.id, status: interaction.status };
+        },
+    });
+    registrar.registerTool({
+        name: "hiloop_request_form",
+        description: "Send a form to a human to fill out. Useful for gathering structured data.",
+        schema: z.object({
+            title: z.string().describe("Form title"),
+            formSchema: z
+                .string()
+                .describe("JSON schema describing the form fields"),
+            priority: z
+                .enum(["critical", "high", "normal", "low"])
+                .default(config.defaultPriority),
+            deadlineMinutes: z.number().optional(),
+        }),
+        handler: async (params) => {
+            const interaction = await client.createInteraction({
+                type: "form",
+                encryptedTitle: params.title,
+                encryptedFormSchema: params.formSchema,
+                priority: params.priority || config.defaultPriority,
+                deadlineMinutes: params.deadlineMinutes,
+            });
+            return { interactionId: interaction.id, status: interaction.status };
+        },
+    });
+    registrar.registerTool({
+        name: "hiloop_send_notification",
+        description: "Send a fire-and-forget notification to a human. No response expected.",
+        schema: z.object({
+            title: z.string().describe("Notification title"),
+            description: z
+                .string()
+                .optional()
+                .describe("Notification body"),
+            priority: z
+                .enum(["critical", "high", "normal", "low"])
+                .default(config.defaultPriority),
+        }),
+        handler: async (params) => {
+            const interaction = await client.createInteraction({
+                type: "notification",
+                encryptedTitle: params.title,
+                encryptedDescription: params.description,
+                priority: params.priority || config.defaultPriority,
+            });
+            return { interactionId: interaction.id, status: interaction.status };
+        },
+    });
+    registrar.registerTool({
+        name: "hiloop_start_live_session",
+        description: "Start a live session with a human for real-time screen sharing or collaboration.",
+        schema: z.object({
+            title: z.string().describe("Session title"),
+            description: z
+                .string()
+                .optional()
+                .describe("What the session is about"),
+            priority: z
+                .enum(["critical", "high", "normal", "low"])
+                .default(config.defaultPriority),
+        }),
+        handler: async (params) => {
+            const interaction = await client.createInteraction({
+                type: "live_session",
+                encryptedTitle: params.title,
+                encryptedDescription: params.description,
+                priority: params.priority || config.defaultPriority,
+            });
+            return { interactionId: interaction.id, status: interaction.status };
+        },
+    });
+    registrar.registerTool({
+        name: "hiloop_check_status",
+        description: "Check the current status of a Hiloop interaction.",
+        schema: z.object({
+            interactionId: z.string().describe("The interaction ID to check"),
+        }),
+        handler: async (params) => {
+            const interaction = await client.getInteraction(params.interactionId);
+            return {
+                id: interaction.id,
+                type: interaction.type,
+                status: interaction.status,
+                priority: interaction.priority,
+                respondedBy: interaction.respondedBy,
+                respondedAt: interaction.respondedAt,
+                encryptedResponse: interaction.encryptedResponse,
+            };
+        },
+    });
+    registrar.registerTool({
+        name: "hiloop_await_response",
+        description: "Wait for a human to respond to a Hiloop interaction. Long-polls up to 30 seconds.",
+        schema: z.object({
+            interactionId: z.string().describe("The interaction ID to wait on"),
+            timeout: z
+                .number()
+                .min(1)
+                .max(30)
+                .default(30)
+                .describe("Timeout in seconds (max 30)"),
+        }),
+        handler: async (params) => {
+            const interaction = await client.awaitResponse(params.interactionId, params.timeout);
+            return {
+                id: interaction.id,
+                status: interaction.status,
+                encryptedResponse: interaction.encryptedResponse,
+                respondedBy: interaction.respondedBy,
+                respondedAt: interaction.respondedAt,
+            };
+        },
+    });
+    registrar.registerTool({
+        name: "hiloop_cancel_request",
+        description: "Cancel a pending Hiloop interaction.",
+        schema: z.object({
+            interactionId: z
+                .string()
+                .describe("The interaction ID to cancel"),
+        }),
+        handler: async (params) => {
+            const interaction = await client.cancelInteraction(params.interactionId);
+            return { id: interaction.id, status: interaction.status };
+        },
+    });
+    registrar.registerTool({
+        name: "hiloop_check_quota",
+        description: "Check your Hiloop usage quota (how many interactions you can create).",
+        schema: z.object({}),
+        handler: async () => {
+            return await client.checkQuota();
+        },
+    });
+}
+//# sourceMappingURL=tools.js.map

package/dist/src/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/tools.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "hiloop-openclaw",
+  "version": "0.1.0",
+  "description": "Hiloop channel plugin for OpenClaw - human-in-the-loop for AI agents",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "src/skill.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "tsc",
+    "dev": "tsc --watch"
+  },
+  "openclaw": {
+    "extensions": ["channel", "tools"],
+    "channel": {
+      "id": "hiloop",
+      "label": "Hiloop",
+      "description": "Human-in-the-loop interactions: approvals, chat, reviews, forms, live sessions, voice"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sjorsdev/hiloop.git",
+    "directory": "integrations/openclaw"
+  },
+  "homepage": "https://www.hi-loop.com/docs/openclaw",
+  "bugs": {
+    "url": "https://github.com/sjorsdev/hiloop/issues"
+  },
+  "keywords": [
+    "openclaw",
+    "openclaw-plugin",
+    "openclaw-channel",
+    "hiloop",
+    "human-in-the-loop",
+    "ai-agents",
+    "approval",
+    "review",
+    "chat"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "zod": "^3.24"
+  },
+  "devDependencies": {
+    "@types/node": "^22",
+    "typescript": "^5.7"
+  }
+}

package/src/skill.md

@@ -0,0 +1,49 @@
+# Hiloop - Human-in-the-Loop Channel
+
+You have access to Hiloop, a zero-trust human-in-the-loop platform. Use it to reach humans for approvals, reviews, chat, forms, live sessions, and notifications.
+
+## When to use Hiloop
+
+- **Approvals**: Use `hiloop_request_approval` when you need permission to do something dangerous, irreversible, or costly. Examples: deploying to production, deleting data, spending money, sending emails.
+- **Reviews**: Use `hiloop_request_review` when you need a human to review content, code, or a document before proceeding.
+- **Forms**: Use `hiloop_request_form` when you need structured data from a human (e.g., configuration, preferences, details for a task).
+- **Notifications**: Use `hiloop_send_notification` for fire-and-forget updates. No response expected.
+- **Live sessions**: Use `hiloop_start_live_session` when you need real-time collaboration or screen sharing.
+- **Chat**: Send messages through the Hiloop channel for conversational back-and-forth.
+
+## Priority guide
+
+- `critical` - Blocking, time-sensitive, needs immediate attention
+- `high` - Important, should be handled soon
+- `normal` - Default, handled in regular order
+- `low` - Can wait, non-urgent
+
+## Workflow patterns
+
+### Approval gate
+```
+1. hiloop_request_approval(title: "Deploy v2.3 to production", options: ["Approve", "Deny", "Defer"])
+2. hiloop_await_response(interactionId: "...")
+3. If approved, proceed. If denied, stop. If deferred, wait and check later.
+```
+
+### Gather information
+```
+1. hiloop_request_form(title: "Database migration config", formSchema: '{"host":"string","port":"number"}')
+2. hiloop_await_response(interactionId: "...")
+3. Use the submitted form data to proceed.
+```
+
+### Notify and continue
+```
+1. hiloop_send_notification(title: "Build completed successfully")
+2. Continue with next task (no need to wait).
+```
+
+## Tips
+
+- Always include a clear, descriptive title so the human knows what they are responding to.
+- Set deadlines for time-sensitive requests using `deadlineMinutes`.
+- Use `hiloop_check_status` to poll for status without blocking.
+- Use `hiloop_await_response` (up to 30s) for synchronous waiting.
+- Check `hiloop_check_quota` if you are creating many interactions.