reticulum-openclaw 0.1.0

package/dist/channel.d.ts

@@ -0,0 +1,3 @@
+import type { ChannelPlugin } from "./types.js";
+export declare function createReticulumChannel(): ChannelPlugin;
+//# sourceMappingURL=channel.d.ts.map

package/dist/channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../src/channel.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAGV,aAAa,EAOd,MAAM,YAAY,CAAC;AAOpB,wBAAgB,sBAAsB,IAAI,aAAa,CAoNtD"}

package/dist/channel.js

@@ -0,0 +1,194 @@
+import { GatewayClient } from "./runtime.js";
+import { toGatewayConfig } from "./types.js";
+function resolveConfig(cfg) {
+    return toGatewayConfig(cfg.channels?.reticulum ?? {});
+}
+export function createReticulumChannel() {
+    let client = null;
+    return {
+        id: "reticulum",
+        meta: {
+            id: "reticulum",
+            label: "Reticulum / LXMF",
+            selectionLabel: "Reticulum (mesh network)",
+            docsPath: "channels/reticulum",
+            blurb: "Send and receive messages over the Reticulum mesh network via LXMF (MeshChat, Sideband, NomadNet compatible)",
+            aliases: ["lxmf"],
+        },
+        capabilities: {
+            chatTypes: ["direct"],
+            // LXMF is store-and-forward — streaming is not supported
+            blockStreaming: true,
+        },
+        pairing: {
+            idLabel: "LXMF Address",
+        },
+        config: {
+            listAccountIds: () => ["default"],
+            resolveAccount: (cfg) => resolveConfig(cfg),
+            isConfigured: () => true,
+        },
+        status: {
+            buildAccountSnapshot: ({ runtime }) => {
+                const snap = {
+                    accountId: runtime?.accountId ?? "default",
+                    configured: true,
+                };
+                if (runtime?.enabled !== undefined)
+                    snap.enabled = runtime.enabled;
+                if (runtime?.running !== undefined)
+                    snap.running = runtime.running;
+                if (runtime?.connected !== undefined)
+                    snap.connected = runtime.connected;
+                if (runtime?.lastInboundAt !== undefined)
+                    snap.lastInboundAt = runtime.lastInboundAt;
+                if (runtime?.lastError !== undefined)
+                    snap.lastError = runtime.lastError;
+                if (runtime?.address !== undefined)
+                    snap.address = runtime.address;
+                return snap;
+            },
+        },
+        gateway: {
+            startAccount: (ctx) => {
+                client = new GatewayClient(ctx.account);
+                ctx.setStatus({ ...ctx.getStatus(), connected: true });
+                ctx.abortSignal.addEventListener("abort", () => {
+                    client?.stop();
+                    client = null;
+                });
+                const dispatchInbound = async (event) => {
+                    ctx.setStatus({ ...ctx.getStatus(), lastInboundAt: Date.now() });
+                    ctx.log?.info(`[${ctx.accountId}] inbound message from ${event.from.slice(0, 8)}…`);
+                    if (!ctx.channelRuntime) {
+                        ctx.log?.warn?.("channelRuntime not available — cannot dispatch inbound message");
+                        return;
+                    }
+                    const senderName = event.display_name || event.from.slice(0, 8);
+                    const messageBody = event.content || event.title;
+                    try {
+                        const dmPolicy = ctx.cfg.channels?.reticulum?.dm_policy ?? "pairing";
+                        if (dmPolicy === "disabled") {
+                            ctx.log?.info(`[${ctx.accountId}] blocked sender ${event.from.slice(0, 8)}… (policy: disabled)`);
+                            return;
+                        }
+                        if (dmPolicy !== "open") {
+                            if (!ctx.channelRuntime.pairing) {
+                                ctx.log?.warn?.(`[${ctx.accountId}] dm_policy=${dmPolicy} but pairing runtime is unavailable — allowing message`);
+                            }
+                            else {
+                                const allowFrom = await ctx.channelRuntime.pairing.readAllowFromStore({
+                                    channel: "reticulum",
+                                    accountId: ctx.accountId,
+                                });
+                                if (!allowFrom.includes(event.from)) {
+                                    if (dmPolicy === "pairing") {
+                                        const { code } = await ctx.channelRuntime.pairing.upsertPairingRequest({
+                                            channel: "reticulum",
+                                            accountId: ctx.accountId,
+                                            id: event.from,
+                                            meta: { display_name: senderName },
+                                        });
+                                        const replyText = ctx.channelRuntime.pairing.buildPairingReply({
+                                            channel: "reticulum",
+                                            idLine: event.from,
+                                            code,
+                                        });
+                                        if (client) {
+                                            await client.send(event.from, replyText);
+                                        }
+                                        ctx.log?.info(`[${ctx.accountId}] pairing challenge issued for ${event.from.slice(0, 8)}…`);
+                                    }
+                                    else {
+                                        // "allowlist" — block silently
+                                        ctx.log?.info(`[${ctx.accountId}] blocked sender ${event.from.slice(0, 8)}… (not in allowlist)`);
+                                    }
+                                    return;
+                                }
+                            }
+                        }
+                        const route = ctx.channelRuntime.routing.resolveAgentRoute({
+                            cfg: ctx.cfg,
+                            channel: "reticulum",
+                            accountId: ctx.accountId,
+                            peer: { kind: "direct", id: event.from },
+                        });
+                        ctx.log?.info(`[${ctx.accountId}] route: agentId=${route.agentId} sessionKey=${route.sessionKey}`);
+                        const storePath = ctx.channelRuntime.session.resolveStorePath(ctx.cfg.session?.store, { agentId: route.agentId });
+                        const msgCtx = {
+                            Body: messageBody,
+                            BodyForAgent: messageBody,
+                            From: event.from,
+                            To: event.from,
+                            AccountId: ctx.accountId,
+                            SessionKey: route.sessionKey,
+                            ChatType: "direct",
+                            SenderName: senderName,
+                            SenderId: event.from,
+                            Provider: "reticulum",
+                            Surface: "reticulum",
+                            MessageSid: `${event.from}:${String(event.timestamp)}`,
+                            Timestamp: event.timestamp * 1000,
+                            ConversationLabel: messageBody,
+                            OriginatingChannel: "reticulum",
+                            OriginatingTo: event.from,
+                        };
+                        await ctx.channelRuntime.session.recordInboundSession({
+                            storePath,
+                            sessionKey: route.sessionKey,
+                            ctx: msgCtx,
+                            createIfMissing: true,
+                            updateLastRoute: {
+                                sessionKey: route.mainSessionKey,
+                                channel: "reticulum",
+                                to: event.from,
+                                accountId: ctx.accountId,
+                            },
+                            onRecordError: (err) => ctx.log?.error?.(`[${ctx.accountId}] session record error: ${String(err)}`),
+                        });
+                        ctx.log?.info(`[${ctx.accountId}] session recorded, dispatching to agent`);
+                        const dispatchResult = (await ctx.channelRuntime.reply.dispatchReplyWithBufferedBlockDispatcher({
+                            ctx: msgCtx,
+                            cfg: ctx.cfg,
+                            dispatcherOptions: {
+                                deliver: async (payload) => {
+                                    ctx.log?.info(`[${ctx.accountId}] deliver: text=${String(!!payload.text)} reasoning=${String(!!payload.isReasoning)} client=${String(!!client)}`);
+                                    if (payload.text && !payload.isReasoning && client) {
+                                        const reply = await client.send(event.from, payload.text);
+                                        ctx.log?.info(`[${ctx.accountId}] send result: ${reply.status}`);
+                                    }
+                                },
+                            },
+                        }));
+                        ctx.log?.info(`[${ctx.accountId}] dispatch complete: queuedFinal=${String(dispatchResult.queuedFinal)}`);
+                    }
+                    catch (err) {
+                        ctx.log?.error?.(`[${ctx.accountId}] dispatchInbound error: ${String(err)}`);
+                    }
+                };
+                return client.start((event) => dispatchInbound(event), (connected, address) => {
+                    ctx.setStatus({ ...ctx.getStatus(), connected, ...(address ? { address } : {}) });
+                    ctx.log?.info(`[${ctx.accountId}] gateway ${connected ? "reconnected" : "disconnected"}`);
+                });
+            },
+            stopAccount: (ctx) => {
+                ctx.log?.info(`[${ctx.accountId}] stopping`);
+                ctx.setStatus({ ...ctx.getStatus(), connected: false });
+                client?.stop();
+                client = null;
+                return Promise.resolve();
+            },
+        },
+        outbound: {
+            deliveryMode: "direct",
+            sendText: async ({ to, text }) => {
+                if (!client) {
+                    return { ok: false };
+                }
+                const reply = await client.send(to, text);
+                return { ok: reply.status === "queued" };
+            },
+        },
+    };
+}
+//# sourceMappingURL=channel.js.map

package/dist/channel.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+import type { OpenClawPluginApi } from "./types.js";
+declare const _default: {
+    id: string;
+    name: string;
+    description: string;
+    configSchema: {
+        type: string;
+        additionalProperties: boolean;
+        properties: {};
+    };
+    register(api: OpenClawPluginApi): void;
+};
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;;;;;;;;;;kBAYpC,iBAAiB,GAAG,IAAI;;AAVxC,wBAaE"}

package/dist/index.js

@@ -0,0 +1,15 @@
+import { createReticulumChannel } from "./channel.js";
+export default {
+    id: "reticulum",
+    name: "Reticulum / LXMF",
+    description: "Send and receive messages over the Reticulum mesh network via LXMF",
+    configSchema: {
+        type: "object",
+        additionalProperties: false,
+        properties: {},
+    },
+    register(api) {
+        api.registerChannel({ plugin: createReticulumChannel() });
+    },
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAGtD,eAAe;IACb,EAAE,EAAE,WAAW;IACf,IAAI,EAAE,kBAAkB;IACxB,WAAW,EAAE,oEAAoE;IACjF,YAAY,EAAE;QACZ,IAAI,EAAE,QAAQ;QACd,oBAAoB,EAAE,KAAK;QAC3B,UAAU,EAAE,EAAE;KACf;IAED,QAAQ,CAAC,GAAsB;QAC7B,GAAG,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,sBAAsB,EAAE,EAAE,CAAC,CAAC;IAC5D,CAAC;CACF,CAAC"}

package/dist/runtime.d.ts

@@ -0,0 +1,15 @@
+import type { GatewayConfig, GatewayReply, LxmfEvent } from "./types.js";
+export type EventCallback = (event: LxmfEvent) => void | Promise<void>;
+export type StatusCallback = (connected: boolean, address?: string) => void;
+export declare class GatewayClient {
+    private readonly config;
+    private sub;
+    private req;
+    private running;
+    private heartbeatTimer;
+    constructor(config: GatewayConfig);
+    start(onEvent: EventCallback, onStatusChange?: StatusCallback): Promise<void>;
+    send(to: string, content: string, title?: string): Promise<GatewayReply>;
+    stop(): void;
+}
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAe,MAAM,YAAY,CAAC;AAEtF,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AACvE,MAAM,MAAM,cAAc,GAAG,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;AAE5E,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,GAAG,CAAiB;IAC5B,OAAO,CAAC,GAAG,CAAc;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,cAAc,CAA+C;gBAEzD,MAAM,EAAE,aAAa;IAM3B,KAAK,CAAC,OAAO,EAAE,aAAa,EAAE,cAAc,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IA0D7E,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,YAAY,CAAC;IAS1E,IAAI,IAAI,IAAI;CASb"}

package/dist/runtime.js

@@ -0,0 +1,103 @@
+import * as zmq from "zeromq";
+export class GatewayClient {
+    config;
+    sub;
+    req;
+    running = false;
+    heartbeatTimer = null;
+    constructor(config) {
+        this.config = config;
+        this.sub = new zmq.Subscriber();
+        this.req = new zmq.Request({ sendTimeout: config.send_timeout_ms, receiveTimeout: config.send_timeout_ms });
+    }
+    async start(onEvent, onStatusChange) {
+        this.sub.connect(this.config.events_socket);
+        this.sub.subscribe("");
+        this.req.connect(this.config.command_socket);
+        this.running = true;
+        // Track liveness via heartbeat frames published by the gateway.
+        // The timeout is 2.5× the heartbeat interval to tolerate one missed beat.
+        let lastPulseAt = Date.now();
+        let lastKnownAddress;
+        let reportedConnected = true;
+        const timeoutMs = this.config.heartbeat_interval_ms * 2.5;
+        this.heartbeatTimer = setInterval(() => {
+            const connected = Date.now() - lastPulseAt < timeoutMs;
+            if (connected !== reportedConnected) {
+                reportedConnected = connected;
+                onStatusChange?.(connected);
+            }
+        }, this.config.heartbeat_interval_ms);
+        for await (const [msg] of this.sub) {
+            // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+            if (!this.running)
+                break; // stop() may be called externally between iterations
+            const raw = msg?.toString();
+            if (!raw)
+                continue;
+            let event;
+            try {
+                event = JSON.parse(raw);
+            }
+            catch {
+                continue;
+            }
+            // Any parseable frame counts as a pulse (heartbeat or message).
+            lastPulseAt = Date.now();
+            const address = isHeartbeat(event) ? event.address : undefined;
+            // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+            if (!reportedConnected) {
+                // Reconnected after a gap — always notify (with address if available).
+                reportedConnected = true;
+                lastKnownAddress = address;
+                onStatusChange?.(true, address);
+            }
+            else if (address !== undefined && address !== lastKnownAddress) {
+                // Address changed (e.g. gateway restarted with a new identity) — notify once.
+                lastKnownAddress = address;
+                onStatusChange?.(true, address);
+            }
+            if (!isLxmfEvent(event))
+                continue; // silently drops heartbeats and unknown frames
+            const { allowed_senders, max_message_length } = this.config;
+            if (allowed_senders.length > 0 && !allowed_senders.includes(event.from))
+                continue;
+            void onEvent({ ...event, content: event.content.slice(0, max_message_length) });
+        }
+    }
+    async send(to, content, title = "") {
+        const cmd = { cmd: "send", id: crypto.randomUUID(), to, content, title };
+        await this.req.send(JSON.stringify(cmd));
+        const [raw] = await this.req.receive();
+        // REP socket always delivers exactly one frame; non-null is safe here
+        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+        return JSON.parse(raw.toString());
+    }
+    stop() {
+        this.running = false;
+        if (this.heartbeatTimer !== null) {
+            clearInterval(this.heartbeatTimer);
+            this.heartbeatTimer = null;
+        }
+        this.sub.close();
+        this.req.close();
+    }
+}
+function isHeartbeat(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const v = value;
+    return v.type === "heartbeat" && typeof v.address === "string";
+}
+function isLxmfEvent(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const v = value;
+    return (v.type === "message" &&
+        typeof v.from === "string" &&
+        typeof v.display_name === "string" &&
+        typeof v.content === "string" &&
+        typeof v.title === "string" &&
+        typeof v.timestamp === "number");
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,223 @@
+export interface LxmfEvent {
+    type: "message";
+    from: string;
+    display_name: string;
+    content: string;
+    title: string;
+    timestamp: number;
+}
+export interface SendCommand {
+    cmd: "send";
+    id: string;
+    to: string;
+    content: string;
+    title: string;
+}
+export interface GatewayReply {
+    status: "queued" | "error";
+    id: string;
+    reason?: string;
+}
+/** Full internal config passed to GatewayClient — all fields required. */
+export interface GatewayConfig {
+    events_socket: string;
+    command_socket: string;
+    allowed_senders: string[];
+    max_message_length: number;
+    send_timeout_ms: number;
+    heartbeat_interval_ms: number;
+}
+export interface PluginConfig {
+    events_socket?: string;
+    command_socket?: string;
+    allowed_senders?: string[];
+    max_message_length?: number;
+    send_timeout_ms?: number;
+    heartbeat_interval_ms?: number;
+    dm_policy?: "open" | "pairing" | "allowlist" | "disabled";
+}
+export declare function toGatewayConfig(raw: PluginConfig): GatewayConfig;
+export interface OpenClawConfig extends Record<string, unknown> {
+    channels?: {
+        reticulum?: PluginConfig;
+    } & Record<string, unknown>;
+}
+export interface ChannelMeta {
+    id: string;
+    label: string;
+    selectionLabel: string;
+    docsPath: string;
+    blurb: string;
+    aliases?: string[];
+}
+export interface ChannelCapabilities {
+    chatTypes: string[];
+    blockStreaming?: boolean;
+    media?: boolean;
+}
+export interface ChannelConfigAdapter<T> {
+    listAccountIds: (cfg: OpenClawConfig) => string[];
+    resolveAccount: (cfg: OpenClawConfig, accountId?: string | null) => T;
+    isConfigured?: (account: T, cfg: OpenClawConfig) => boolean | Promise<boolean>;
+}
+/** Subset of MsgContext used to describe an inbound LXMF message. */
+export interface MsgContext {
+    Body?: string;
+    BodyForAgent?: string;
+    From?: string;
+    To?: string;
+    AccountId?: string;
+    SessionKey?: string;
+    ChatType?: string;
+    SenderName?: string;
+    SenderId?: string;
+    Provider?: string;
+    Surface?: string;
+    MessageSid?: string;
+    Timestamp?: number;
+    ConversationLabel?: string;
+    OriginatingChannel?: string;
+    OriginatingTo?: string;
+}
+/** AI-generated reply payload passed to the deliver callback. */
+export interface ReplyPayload {
+    text?: string;
+    isReasoning?: boolean;
+}
+export interface AgentRoute {
+    agentId: string;
+    sessionKey: string;
+    mainSessionKey: string;
+    accountId: string;
+}
+export interface ChannelRuntime {
+    routing: {
+        resolveAgentRoute: (params: {
+            cfg: OpenClawConfig;
+            channel: string;
+            accountId?: string | null;
+            peer?: {
+                kind: string;
+                id: string;
+            } | null;
+        }) => AgentRoute;
+    };
+    pairing?: {
+        /** channel and accountId are required on the real PluginRuntime["channel"].pairing API. */
+        readAllowFromStore: (params: {
+            channel: string;
+            accountId: string;
+        }) => Promise<string[]>;
+        upsertPairingRequest: (input: {
+            channel: string;
+            id: string;
+            accountId: string;
+            meta?: Record<string, string | undefined>;
+        }) => Promise<{
+            code: string;
+            created: boolean;
+        }>;
+        buildPairingReply: (params: {
+            channel: string;
+            idLine: string;
+            code: string;
+        }) => string;
+    };
+    session: {
+        resolveStorePath: (store: string | undefined, opts: {
+            agentId: string;
+        }) => string;
+        recordInboundSession: (params: {
+            storePath: string;
+            sessionKey: string;
+            ctx: MsgContext;
+            createIfMissing?: boolean;
+            updateLastRoute?: {
+                sessionKey: string;
+                channel: string;
+                to: string;
+                accountId?: string | null;
+            };
+            onRecordError: (err: unknown) => void;
+        }) => Promise<void>;
+    };
+    reply: {
+        dispatchReplyWithBufferedBlockDispatcher: (params: {
+            ctx: MsgContext;
+            cfg: OpenClawConfig;
+            dispatcherOptions: {
+                deliver: (payload: ReplyPayload, info: {
+                    kind: string;
+                }) => Promise<void>;
+            };
+        }) => Promise<unknown>;
+    };
+}
+export interface ChannelGatewayContext<TAccount = unknown> {
+    cfg: OpenClawConfig;
+    accountId: string;
+    account: TAccount;
+    abortSignal: AbortSignal;
+    log?: {
+        info: (msg: string) => void;
+        warn?: (msg: string) => void;
+        error?: (msg: string) => void;
+    };
+    channelRuntime?: ChannelRuntime;
+    getStatus: () => ChannelAccountSnapshot;
+    setStatus: (next: ChannelAccountSnapshot) => void;
+}
+export interface ChannelOutboundContext {
+    cfg: OpenClawConfig;
+    to: string;
+    text: string;
+    accountId?: string | null;
+}
+export interface ChannelStatusAdapter<TAccount> {
+    buildAccountSnapshot?: (params: {
+        account: TAccount;
+        cfg: OpenClawConfig;
+        runtime?: ChannelAccountSnapshot;
+    }) => ChannelAccountSnapshot | Promise<ChannelAccountSnapshot>;
+}
+export interface ChannelAccountSnapshot {
+    accountId: string;
+    name?: string;
+    enabled?: boolean;
+    configured?: boolean;
+    running?: boolean;
+    connected?: boolean;
+    lastInboundAt?: number | null;
+    lastError?: string | null;
+    address?: string | null;
+}
+export interface ChannelPairingAdapter {
+    /** Label shown to the user for the sender identifier (e.g. "LXMF Address"). */
+    idLabel: string;
+    normalizeAllowEntry?: (entry: string) => string;
+}
+export interface ChannelPlugin<TAccount = GatewayConfig> {
+    id: string;
+    meta: ChannelMeta;
+    capabilities: ChannelCapabilities;
+    config: ChannelConfigAdapter<TAccount>;
+    pairing?: ChannelPairingAdapter;
+    status?: ChannelStatusAdapter<TAccount>;
+    gateway?: {
+        startAccount?: (ctx: ChannelGatewayContext<TAccount>) => Promise<unknown>;
+        stopAccount?: (ctx: ChannelGatewayContext<TAccount>) => Promise<void>;
+    };
+    outbound?: {
+        deliveryMode: "direct" | "gateway" | "hybrid";
+        sendText?: (ctx: ChannelOutboundContext) => Promise<{
+            ok: boolean;
+        }>;
+    };
+}
+export interface OpenClawPluginApi {
+    runtime: unknown;
+    registerChannel: (registration: {
+        plugin: ChannelPlugin;
+    }) => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,14 @@
+// ---------------------------------------------------------------------------
+// ZMQ wire types (gateway ↔ plugin IPC)
+// ---------------------------------------------------------------------------
+export function toGatewayConfig(raw) {
+    return {
+        events_socket: raw.events_socket ?? "tcp://localhost:2600",
+        command_socket: raw.command_socket ?? "tcp://localhost:2601",
+        allowed_senders: raw.allowed_senders ?? [],
+        max_message_length: raw.max_message_length ?? 4096,
+        send_timeout_ms: raw.send_timeout_ms ?? 5000,
+        heartbeat_interval_ms: raw.heartbeat_interval_ms ?? 30_000,
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,wCAAwC;AACxC,8EAA8E;AAiD9E,MAAM,UAAU,eAAe,CAAC,GAAiB;IAC/C,OAAO;QACL,aAAa,EAAE,GAAG,CAAC,aAAa,IAAI,sBAAsB;QAC1D,cAAc,EAAE,GAAG,CAAC,cAAc,IAAI,sBAAsB;QAC5D,eAAe,EAAE,GAAG,CAAC,eAAe,IAAI,EAAE;QAC1C,kBAAkB,EAAE,GAAG,CAAC,kBAAkB,IAAI,IAAI;QAClD,eAAe,EAAE,GAAG,CAAC,eAAe,IAAI,IAAI;QAC5C,qBAAqB,EAAE,GAAG,CAAC,qBAAqB,IAAI,MAAM;KAC3D,CAAC;AACJ,CAAC"}

package/openclaw.plugin.json

@@ -0,0 +1,12 @@
+{
+  "id": "reticulum",
+  "name": "Reticulum / LXMF",
+  "description": "Connect to Reticulum mesh networks via LXMF messaging (MeshChat, Sideband, NomadNet compatible)",
+  "version": "0.1.0",
+  "channels": ["reticulum"],
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {}
+  }
+}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "reticulum-openclaw",
+  "version": "0.1.0",
+  "description": "OpenClaw channel plugin for Reticulum / LXMF mesh networking",
+  "type": "module",
+  "main": "dist/index.js",
+  "files": ["dist", "openclaw.plugin.json"],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src",
+    "lint:fix": "eslint src --fix",
+    "format": "prettier --write src",
+    "format:check": "prettier --check src"
+  },
+  "openclaw": {
+    "extensions": ["./dist/index.js"]
+  },
+  "peerDependencies": {
+    "openclaw": "*"
+  },
+  "dependencies": {
+    "zeromq": "6.5.0"
+  },
+  "devDependencies": {
+    "@types/node": "25.3.3",
+    "@typescript-eslint/eslint-plugin": "8.56.1",
+    "@typescript-eslint/parser": "8.56.1",
+    "eslint": "10.0.2",
+    "prettier": "3.8.1",
+    "typescript": "5.9.3",
+    "@vitest/coverage-v8": "4.0.18",
+    "vitest": "4.0.18"
+  }
+}