@moxxy/plugin-channel-signal 0.27.0

package/dist/channel.d.ts.map

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

package/dist/channel.js

@@ -0,0 +1,468 @@
+import { newTurnId } from '@moxxy/core';
+import { TurnCoordinator, resolveSecret } from '@moxxy/channel-kit';
+import { SIGNAL_ACCOUNT_ENV, SIGNAL_ACCOUNT_KEY, SIGNAL_ALLOWED_SENDERS_KEY, normalizeSender, parseAllowedSenders, } from './keys.js';
+import { receiveParamsSchema, } from './schema.js';
+import { SIGNAL_CLI_INSTALL_HINT, SignalSidecar, findSignalCliOnPath, listSignalAccounts, signalCliAttachmentsDir, startLinkProcess, } from './sidecar.js';
+import { buildSignalPermissionResolver } from './permission.js';
+import { runSignalTurn } from './channel/turn-runner.js';
+import { splitForSignal } from './channel/chunker.js';
+import { pickAudioAttachment, transcribeVoiceAttachment } from './channel/voice.js';
+/** Device name shown in the phone's "Linked Devices" list. */
+const LINK_DEVICE_NAME = 'moxxy';
+/** Bound on remembered own-send timestamps for the sync-echo drop. */
+const MAX_SENT_TIMESTAMPS = 256;
+/** Rate limit for "dropped invalid/unauthorized envelope" warnings. */
+const DROP_WARN_INTERVAL_MS = 5_000;
+export class SignalChannel {
+    name = 'signal';
+    /**
+     * Installed on the session by the CLI dispatcher. Replaced in `start()` once
+     * the live tool registry is available for `['*']` expansion; until then it
+     * denies everything (safe default before start).
+     */
+    permissionResolver;
+    opts;
+    session = null;
+    model;
+    account = null;
+    allowedSenders = new Set();
+    sidecar = null;
+    rpc = null;
+    link = null;
+    handle = null;
+    runningSettled = false;
+    resolveRunning = null;
+    rejectRunning = null;
+    stopping = false;
+    // Single-flight turn state + the bounded own-turn-id set the foreign-turn
+    // mirror gate filters on (invariant #8).
+    turns = new TurnCoordinator();
+    lastTarget = null;
+    logUnsub = null;
+    /**
+     * Timestamps of messages WE sent through the daemon (signal-cli's `send`
+     * result). A linked device sees the account's sends come back as
+     * `syncMessage.sentMessage` envelopes — including its own — so any sync'd
+     * sent-message whose timestamp is in this set is an echo of ourselves and
+     * must be dropped (loop protection).
+     */
+    sentTimestamps = new Set();
+    // Link-window connect state, published via requestUrl/connected + the
+    // dedicated-runner status file (the desktop panel renders the QR from it).
+    linkUri = null;
+    linked = false;
+    connectListeners = new Set();
+    linkedListeners = new Set();
+    lastDropWarnAt = 0;
+    constructor(opts) {
+        this.opts = opts;
+        // Pre-start: deny-all (replaced with the real allow-list resolver in start()).
+        this.permissionResolver = buildSignalPermissionResolver({
+            allowedTools: [],
+            allToolNames: [],
+            ...(opts.logger ? { logger: opts.logger } : {}),
+        });
+    }
+    /** The `sgnl://linkdevice…` URI while a linking window is open; null otherwise. */
+    get requestUrl() {
+        return this.linkUri;
+    }
+    /** Whether the account is linked (the "connect the other side" step). */
+    get connected() {
+        return this.linked;
+    }
+    /** Fires when linking completes (the pair flow prints success off this). */
+    onLinked(listener) {
+        this.linkedListeners.add(listener);
+        return () => this.linkedListeners.delete(listener);
+    }
+    async start(startOpts) {
+        if (this.handle)
+            return this.handle;
+        this.session = startOpts.session;
+        this.model = startOpts.model;
+        const findBinary = this.opts.findBinaryFn ?? (() => findSignalCliOnPath());
+        const binary = this.opts.binary ?? findBinary();
+        if (!binary)
+            throw new Error(SIGNAL_CLI_INSTALL_HINT);
+        // Account: explicit option → env → vault (shared channel-kit precedence).
+        this.account =
+            this.opts.account ??
+                (await resolveSecret(this.opts.vault, {
+                    envVar: SIGNAL_ACCOUNT_ENV,
+                    vaultKey: SIGNAL_ACCOUNT_KEY,
+                }));
+        // Sender allow-list: vault + option extras. The owner's own Note-to-Self is
+        // allowed implicitly (see handleSyncSent) and needs no entry.
+        this.allowedSenders = new Set([
+            ...parseAllowedSenders(await this.opts.vault.get(SIGNAL_ALLOWED_SENDERS_KEY)),
+            ...(this.opts.allowedSenders ?? []).map(normalizeSender),
+        ].filter(Boolean));
+        // Linked yet? (One-shot `listAccounts` spawn — NOT in isAvailable, JVM
+        // spawns are too slow for discovery.) A probe failure is treated as
+        // "assume linked" when an account is configured: the daemon boot below
+        // surfaces the real error with signal-cli's own stderr, which beats
+        // guessing wrong and opening a spurious link window.
+        let isLinked = false;
+        if (this.account) {
+            try {
+                const listAccounts = this.opts.listAccountsFn ?? ((o) => listSignalAccounts(o));
+                const accounts = await listAccounts({ binary });
+                isLinked = accounts.includes(this.account);
+            }
+            catch (err) {
+                this.opts.logger?.warn?.('signal: listAccounts probe failed; assuming linked', {
+                    err: err instanceof Error ? err.message : String(err),
+                });
+                isLinked = true;
+            }
+        }
+        // Swap in the real autonomous allow-list resolver now that the tool
+        // registry is live (mirrors the Slack channel; `['*']` expands here).
+        const allowedTools = startOpts.allowedTools ?? this.opts.allowedTools ?? [];
+        const allToolNames = this.session.tools.list().map((t) => t.name);
+        this.permissionResolver = buildSignalPermissionResolver({
+            allowedTools,
+            allToolNames,
+            ...(this.opts.logger ? { logger: this.opts.logger } : {}),
+        });
+        this.session.setPermissionResolver(this.permissionResolver);
+        // Mirror-to-last-target: post assistant prose for turns this channel did
+        // NOT initiate (a co-attached surface ran one) into the last thread served.
+        this.logUnsub = this.session.log.subscribe((event) => this.mirrorForeignTurn(event));
+        const running = new Promise((resolve, reject) => {
+            this.resolveRunning = resolve;
+            this.rejectRunning = reject;
+        });
+        const dedicated = startOpts.dedicated === true || process.env.MOXXY_DEDICATED_RUNNER === '1';
+        if (isLinked) {
+            this.linked = true;
+            await this.bootDaemon(binary, this.account);
+        }
+        else if (startOpts.pair || dedicated) {
+            await this.openLinkWindow(binary);
+        }
+        else {
+            this.logUnsub?.();
+            this.logUnsub = null;
+            throw new Error('This machine is not linked to a Signal account yet. Run `moxxy channels signal pair` ' +
+                '(scan the QR with your phone: Signal → Settings → Linked Devices), or start it from the desktop Channels panel.');
+        }
+        this.handle = {
+            running,
+            onConnectChange: (listener) => {
+                this.connectListeners.add(listener);
+                return () => this.connectListeners.delete(listener);
+            },
+            stop: async (reason = 'shutdown') => {
+                this.stopping = true;
+                // Abort the in-flight turn FIRST so the model loop stops the moment the
+                // operator asks to shut down (shared/remote Session: spend continues
+                // otherwise and only its output is discarded).
+                this.turns.abort(reason);
+                this.link?.cancel();
+                this.link = null;
+                this.logUnsub?.();
+                this.logUnsub = null;
+                const sidecar = this.sidecar;
+                this.sidecar = null;
+                this.rpc = null;
+                if (sidecar)
+                    await sidecar.stop();
+                this.settleRunning();
+            },
+        };
+        this.opts.logger?.info?.('signal: channel started', {
+            linked: this.linked,
+            account: this.account,
+            allowedSenders: this.allowedSenders.size,
+        });
+        return this.handle;
+    }
+    // -------------------------------------------------------------------------
+    // Linking (secondary-device pairing)
+    // -------------------------------------------------------------------------
+    async openLinkWindow(binary) {
+        const makeLink = this.opts.linkFactory ??
+            ((o) => startLinkProcess({
+                deviceName: o.deviceName,
+                binary: o.binary,
+                ...(this.opts.spawnFn ? { spawnFn: this.opts.spawnFn } : {}),
+                ...(this.opts.logger ? { logger: this.opts.logger } : {}),
+            }));
+        const link = makeLink({ deviceName: LINK_DEVICE_NAME, binary });
+        this.link = link;
+        this.linkUri = await link.uri; // throws when signal-cli can't start linking
+        this.notifyConnectChange();
+        this.opts.logger?.info?.('signal: linking window open');
+        // Completion is async (the user scans on their phone). Boot the daemon the
+        // moment linking lands; a failure at any point is fatal for the handle so
+        // a supervisor restarts us (and the pair flow surfaces the error).
+        void link.completed
+            .then(async ({ account }) => {
+            if (this.stopping)
+                return;
+            const acct = account ?? this.account;
+            if (!acct) {
+                throw new Error('linking completed but signal-cli did not report the account number — ' +
+                    `store it via \`moxxy channels signal setup\` (vault key ${SIGNAL_ACCOUNT_KEY}) and restart`);
+            }
+            this.account = acct;
+            await this.opts.vault.set(SIGNAL_ACCOUNT_KEY, acct, ['signal']);
+            this.link = null;
+            this.linkUri = null;
+            this.linked = true;
+            await this.bootDaemon(binary, acct);
+            this.notifyConnectChange();
+            for (const listener of this.linkedListeners) {
+                try {
+                    listener(acct);
+                }
+                catch {
+                    /* listener errors are not ours */
+                }
+            }
+            this.opts.logger?.info?.('signal: linked', { account: acct });
+        })
+            .catch((err) => {
+            if (this.stopping)
+                return;
+            this.fatal(new Error(`Signal linking failed: ${err instanceof Error ? err.message : String(err)}`));
+        });
+    }
+    // -------------------------------------------------------------------------
+    // Daemon + inbound envelopes
+    // -------------------------------------------------------------------------
+    async bootDaemon(binary, account) {
+        const makeSidecar = this.opts.sidecarFactory ??
+            ((o) => new SignalSidecar({
+                account: o.account,
+                binary: o.binary,
+                ...(this.opts.spawnFn ? { spawnFn: this.opts.spawnFn } : {}),
+                ...(this.opts.logger ? { logger: this.opts.logger } : {}),
+            }));
+        const sidecar = makeSidecar({ account, binary });
+        this.sidecar = sidecar;
+        const rpc = await sidecar.start();
+        this.rpc = rpc;
+        rpc.onNotification('receive', (params) => this.handleReceive(params));
+        // An unexpected daemon death is fatal: reject `running` so the process
+        // exits non-zero and a supervisor (desktop panel / systemd) restarts it.
+        sidecar.onExit((code) => {
+            if (this.stopping)
+                return;
+            this.fatal(new Error(`signal-cli daemon exited unexpectedly (code=${code ?? 'null'})`));
+        });
+    }
+    /** Every inbound notification funnels through here — zod-validate FIRST. */
+    handleReceive(params) {
+        const parsed = receiveParamsSchema.safeParse(params);
+        if (!parsed.success) {
+            this.warnDrop('invalid receive payload (schema mismatch)');
+            return;
+        }
+        const envelope = parsed.data.envelope;
+        if (envelope.dataMessage) {
+            this.handleDataMessage(envelope);
+            return;
+        }
+        const sent = envelope.syncMessage?.sentMessage;
+        if (sent) {
+            this.handleSyncSent(sent);
+            return;
+        }
+        // Typing / receipt / group-update envelopes: nothing to do.
+    }
+    /** A message from ANOTHER account — gate on the sender allow-list. */
+    handleDataMessage(envelope) {
+        const data = envelope.dataMessage;
+        const number = envelope.sourceNumber ?? null;
+        const uuid = envelope.sourceUuid ?? null;
+        const senderIds = [number, uuid, envelope.source ?? null]
+            .filter((x) => typeof x === 'string' && x.length > 0)
+            .map(normalizeSender);
+        if (senderIds.length === 0) {
+            this.warnDrop('data message without a sender identity');
+            return;
+        }
+        // v1: direct messages only. Group fan-in needs its own trust story.
+        if (data.groupInfo) {
+            this.opts.logger?.debug?.('signal: ignoring group message');
+            return;
+        }
+        // Our own account as a dataMessage source is an echo path (legit owner
+        // prompts arrive as syncMessage.sentMessage) — never respond to ourselves.
+        if (this.account && senderIds.includes(normalizeSender(this.account))) {
+            this.opts.logger?.debug?.('signal: ignoring data message from own account');
+            return;
+        }
+        // THE allow-list gate: every session-reaching path passes through here or
+        // through handleSyncSent's owner check. Unknown senders are dropped
+        // silently (no reply) — answering would leak the bot's existence.
+        if (!senderIds.some((id) => this.allowedSenders.has(id))) {
+            this.warnDrop(`unauthorized sender (${senderIds[0] ?? 'unknown'})`);
+            return;
+        }
+        const target = { recipient: number ?? uuid ?? senderIds[0] };
+        this.dispatchInBackground(this.processMessage(target, data.message ?? null, data.attachments), 'data-message');
+    }
+    /**
+     * A sync'd copy of a message the ACCOUNT OWNER sent from another device.
+     * Two jobs: (1) drop echoes of OUR OWN sends (linked devices receive the
+     * account's sends back — loop protection), (2) accept the owner's
+     * Note-to-Self prompts, which are allowed by default after linking.
+     */
+    handleSyncSent(sent) {
+        if (typeof sent.timestamp === 'number' && this.sentTimestamps.has(sent.timestamp)) {
+            this.opts.logger?.debug?.('signal: dropping sync echo of own send');
+            return;
+        }
+        if (sent.groupInfo)
+            return;
+        // Only the owner's own Note-to-Self drives the session. Their outbound
+        // messages to OTHER people are private conversation traffic — never react.
+        const dest = sent.destinationNumber ?? sent.destination ?? null;
+        const isNoteToSelf = this.account != null && dest != null && dest === this.account;
+        if (!isNoteToSelf)
+            return;
+        this.dispatchInBackground(this.processMessage({ noteToSelf: true }, sent.message ?? null, sent.attachments), 'note-to-self');
+    }
+    /** Voice → transcript, busy gate, then one coordinated turn. */
+    async processMessage(target, text, attachments) {
+        if (!this.session)
+            return;
+        let prompt = text?.trim() ?? '';
+        if (!prompt) {
+            const audio = pickAudioAttachment(attachments);
+            if (!audio)
+                return; // stickers/images/reactions — nothing to run
+            const transcript = await transcribeVoiceAttachment({
+                session: this.session,
+                attachmentsDir: this.opts.attachmentsDir ?? signalCliAttachmentsDir(),
+                reply: (t) => this.sendText(target, t),
+                ...(this.opts.logger ? { logger: this.opts.logger } : {}),
+            }, audio);
+            if (!transcript)
+                return;
+            prompt = transcript;
+        }
+        // Atomic single-flight guard (the coordinator claims the slot BEFORE any
+        // await); the turnId minted here is recorded as an own-turn id — that's
+        // what mirrorForeignTurn filters on (invariant #8).
+        const lease = this.turns.begin(newTurnId());
+        if (!lease) {
+            await this.sendText(target, 'I am still working on the previous prompt. One moment…');
+            return;
+        }
+        this.lastTarget = target;
+        try {
+            await runSignalTurn({
+                session: this.session,
+                send: (t) => this.sendText(target, t),
+                sendTyping: (stop) => this.sendTyping(target, stop),
+                ...(this.opts.logger ? { logger: this.opts.logger } : {}),
+            }, {
+                text: prompt,
+                ...(this.model ? { model: this.model } : {}),
+                controller: lease.controller,
+                turnId: lease.turnId,
+            });
+        }
+        finally {
+            lease.end();
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Outbound
+    // -------------------------------------------------------------------------
+    /** Send one message and record its timestamp for the sync-echo drop. */
+    async sendText(target, text) {
+        const rpc = this.rpc;
+        if (!rpc)
+            throw new Error('signal daemon is not running');
+        const params = 'noteToSelf' in target ? { noteToSelf: true, message: text } : { recipient: [target.recipient], message: text };
+        const result = (await rpc.request('send', params));
+        const ts = result && typeof result === 'object' ? result.timestamp : undefined;
+        if (typeof ts === 'number') {
+            this.sentTimestamps.add(ts);
+            if (this.sentTimestamps.size > MAX_SENT_TIMESTAMPS) {
+                const oldest = this.sentTimestamps.values().next().value;
+                if (oldest !== undefined)
+                    this.sentTimestamps.delete(oldest);
+            }
+        }
+    }
+    async sendTyping(target, stop) {
+        const rpc = this.rpc;
+        if (!rpc)
+            return;
+        const recipient = 'noteToSelf' in target ? this.account : target.recipient;
+        if (!recipient)
+            return;
+        await rpc.request('sendTyping', { recipient: [recipient], ...(stop ? { stop: true } : {}) });
+    }
+    /**
+     * Post the assistant's prose for a turn this channel did not initiate.
+     * Skipped for our own turnIds (robust to async ordering / replay, invariant
+     * #8) and while a turn of ours is streaming via the chunked sender.
+     */
+    mirrorForeignTurn(event) {
+        const text = this.turns.mirrorText(event);
+        if (text == null)
+            return;
+        const target = this.lastTarget;
+        if (!target || !this.rpc)
+            return;
+        void (async () => {
+            for (const part of splitForSignal(text)) {
+                await this.sendText(target, part);
+            }
+        })().catch((err) => {
+            this.opts.logger?.warn?.('signal: mirror failed', { err: String(err) });
+        });
+    }
+    // -------------------------------------------------------------------------
+    // Plumbing
+    // -------------------------------------------------------------------------
+    /**
+     * Run a handler detached from the socket read loop (an envelope handler that
+     * awaited a whole turn would park notification delivery for its duration).
+     * Errors are logged here — nothing upstream awaits this promise.
+     */
+    dispatchInBackground(work, kind) {
+        void work.catch((err) => {
+            this.opts.logger?.warn?.('signal: handler failed', { kind, err: String(err) });
+        });
+    }
+    warnDrop(reason) {
+        const now = Date.now();
+        if (now - this.lastDropWarnAt < DROP_WARN_INTERVAL_MS)
+            return;
+        this.lastDropWarnAt = now;
+        this.opts.logger?.warn?.(`signal: dropped inbound envelope — ${reason}`);
+    }
+    notifyConnectChange() {
+        for (const listener of this.connectListeners) {
+            try {
+                listener();
+            }
+            catch (err) {
+                this.opts.logger?.warn?.('signal: connect-change listener threw', { err: String(err) });
+            }
+        }
+    }
+    settleRunning() {
+        if (this.runningSettled)
+            return;
+        this.runningSettled = true;
+        this.resolveRunning?.();
+    }
+    fatal(err) {
+        this.opts.logger?.error?.('signal: fatal channel error', { err: err.message });
+        if (this.runningSettled)
+            return;
+        this.runningSettled = true;
+        this.rejectRunning?.(err);
+    }
+}
+//# 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,28 @@
+import { type Plugin } from '@moxxy/sdk';
+import type { VaultStore } from '@moxxy/plugin-vault';
+export { SignalChannel, type SignalChannelOptions, type SignalStartOpts, type SendTarget, type SignalRpcLike, type SignalSidecarLike, } from './channel.js';
+export { buildSignalPermissionResolver } from './permission.js';
+export { SignalRpcClient, type RpcStream } from './jsonrpc.js';
+export { SignalSidecar, startLinkProcess, listSignalAccounts, findSignalCliOnPath, signalCliDataDir, signalCliAttachmentsDir, SIGNAL_CLI_INSTALL_HINT, type LinkProcessHandle, type SpawnFn, type SpawnedProcess, } from './sidecar.js';
+export { receiveParamsSchema, envelopeSchema, attachmentSchema, MAX_INBOUND_TEXT_CHARS, type SignalEnvelope, type SignalAttachment, } from './schema.js';
+export { ChunkedSender, takeChunk, splitForSignal, SIGNAL_CHUNK_SOFT_LIMIT, SIGNAL_CHUNK_HARD_LIMIT, } from './channel/chunker.js';
+export { SIGNAL_ACCOUNT_KEY, SIGNAL_ACCOUNT_ENV, SIGNAL_ALLOWED_SENDERS_KEY, parseAllowedSenders, normalizeSender, E164_RE, } from './keys.js';
+export interface BuildSignalPluginOptions {
+    /** Host-injected encrypted secret store (available immediately). */
+    readonly vault: VaultStore;
+}
+/**
+ * Build the Signal channel plugin with a host-injected vault (mirrors the
+ * Telegram/Slack plugins' vault injection).
+ */
+export declare function buildSignalPlugin(opts: BuildSignalPluginOptions): Plugin;
+/**
+ * Discovery-loadable default export: resolves the vault from the inter-plugin
+ * service registry in `onInit` (the vault plugin publishes `'vault'`). Requires
+ * `@moxxy/plugin-vault` to load first (declared in `package.json`
+ * `moxxy.requirements`). The channel + subcommands read the vault via
+ * `getVault()`, so resolution is deferred to call time — after `onInit` wired it.
+ */
+export declare const signalPlugin: Plugin;
+export default signalPlugin;
+//# 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":"AAAA,OAAO,EAAoD,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AAC3F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAiBtD,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,iBAAiB,GACvB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,6BAA6B,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,uBAAuB,EACvB,uBAAuB,EACvB,KAAK,iBAAiB,EACtB,KAAK,OAAO,EACZ,KAAK,cAAc,GACpB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACtB,KAAK,cAAc,EACnB,KAAK,gBAAgB,GACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,aAAa,EACb,SAAS,EACT,cAAc,EACd,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,0BAA0B,EAC1B,mBAAmB,EACnB,eAAe,EACf,OAAO,GACR,MAAM,WAAW,CAAC;AAEnB,MAAM,WAAW,wBAAwB;IACvC,oEAAoE;IACpE,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;CAC5B;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,wBAAwB,GAAG,MAAM,CAExE;AAED;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,EAAE,MAgBvB,CAAC;AAEL,eAAe,YAAY,CAAC"}