@moxxy/plugin-channel-signal 0.27.0

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;GAMG;AAEH,+DAA+D;AAC/D,eAAO,MAAM,sBAAsB,QAAS,CAAC;AAE7C;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,aAIkC,CAAC;AAElE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;gCAOb,CAAC;AAEjB,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAyChE,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAaX,CAAC;AAEjB,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAKhB,CAAC;AAEjB,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAC5D,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/dist/schema.js

@@ -0,0 +1,84 @@
+import { z } from 'zod';
+/**
+ * Zod validation for signal-cli `receive` notification params — every inbound
+ * envelope is validated + size-capped BEFORE any field reaches the session
+ * (channel invariant A8). We only type the fields the channel consumes;
+ * unknown extras pass through untouched so a newer signal-cli doesn't fail
+ * validation, but nothing un-modeled is ever read.
+ */
+/** Cap on inbound prompt text we will forward to the model. */
+export const MAX_INBOUND_TEXT_CHARS = 16_000;
+/**
+ * Attachment ids become filenames under signal-cli's attachments dir; a strict
+ * charset (no separators, no dots-only names) makes path traversal impossible
+ * before we ever join() it.
+ */
+export const attachmentIdSchema = z
+    .string()
+    .min(1)
+    .max(256)
+    .regex(/^[A-Za-z0-9][A-Za-z0-9._-]*$/, 'invalid attachment id');
+export const attachmentSchema = z
+    .object({
+    id: attachmentIdSchema.optional(),
+    contentType: z.string().max(128).optional(),
+    filename: z.string().max(512).nullable().optional(),
+    size: z.number().int().nonnegative().optional(),
+})
+    .passthrough();
+const groupInfoSchema = z
+    .object({
+    groupId: z.string().max(256).optional(),
+})
+    .passthrough();
+const dataMessageSchema = z
+    .object({
+    timestamp: z.number().int().optional(),
+    message: z.string().max(MAX_INBOUND_TEXT_CHARS).nullable().optional(),
+    groupInfo: groupInfoSchema.nullable().optional(),
+    attachments: z.array(attachmentSchema).max(16).optional(),
+})
+    .passthrough();
+/**
+ * A sync'd copy of a message the ACCOUNT OWNER sent from another of their
+ * devices (their phone, Signal Desktop, …). "Note to Self" prompts arrive this
+ * way — and so can echoes of our OWN sends, which is why the channel filters
+ * these by sent-timestamp before acting (loop protection).
+ */
+const sentMessageSchema = z
+    .object({
+    timestamp: z.number().int().optional(),
+    message: z.string().max(MAX_INBOUND_TEXT_CHARS).nullable().optional(),
+    destination: z.string().max(128).nullable().optional(),
+    destinationNumber: z.string().max(32).nullable().optional(),
+    destinationUuid: z.string().max(64).nullable().optional(),
+    groupInfo: groupInfoSchema.nullable().optional(),
+    attachments: z.array(attachmentSchema).max(16).optional(),
+})
+    .passthrough();
+const syncMessageSchema = z
+    .object({
+    sentMessage: sentMessageSchema.optional(),
+})
+    .passthrough();
+export const envelopeSchema = z
+    .object({
+    source: z.string().max(128).nullable().optional(),
+    sourceNumber: z.string().max(32).nullable().optional(),
+    sourceUuid: z.string().max(64).nullable().optional(),
+    sourceName: z.string().max(256).nullable().optional(),
+    sourceDevice: z.number().int().optional(),
+    timestamp: z.number().int().optional(),
+    dataMessage: dataMessageSchema.nullable().optional(),
+    syncMessage: syncMessageSchema.nullable().optional(),
+    // typingMessage / receiptMessage / receiptMessage etc. pass through and are
+    // simply not consumed.
+})
+    .passthrough();
+export const receiveParamsSchema = z
+    .object({
+    account: z.string().max(64).optional(),
+    envelope: envelopeSchema,
+})
+    .passthrough();
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

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

package/dist/setup-wizard.d.ts

@@ -0,0 +1,14 @@
+import type { ChannelSubcommandContext } from '@moxxy/sdk';
+/**
+ * Interactive Signal setup wizard (the channel's `interactiveCommand`).
+ *
+ * Walks the operator through:
+ *   1. verify the `signal-cli` binary is installed (install hint when missing),
+ *   2. store the account number (E.164) in the vault — no API token exists for
+ *      Signal; identity comes from device linking,
+ *   3. choose the autonomous tool allow-list,
+ *   4. hand off to the pair flow (QR link) when the account isn't linked yet,
+ *      or start the channel directly when it is.
+ */
+export declare function runSignalWizard(ctx: ChannelSubcommandContext): Promise<number>;
+//# sourceMappingURL=setup-wizard.d.ts.map

package/dist/setup-wizard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-wizard.d.ts","sourceRoot":"","sources":["../src/setup-wizard.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAU3D;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,wBAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,CA2EpF"}

package/dist/setup-wizard.js

@@ -0,0 +1,85 @@
+import { cancel, intro, isCancel, log, note, outro, text } from '@clack/prompts';
+import { E164_RE, SIGNAL_ACCOUNT_KEY } from './keys.js';
+import { SIGNAL_CLI_INSTALL_HINT, findSignalCliOnPath, listSignalAccounts } from './sidecar.js';
+import { runSignalPairFlow } from './pair-flow.js';
+const ANSI = process.stdout.isTTY && !process.env.NO_COLOR;
+const bold = (s) => (ANSI ? `\x1b[1m${s}\x1b[22m` : s);
+const dim = (s) => (ANSI ? `\x1b[2m${s}\x1b[22m` : s);
+/**
+ * Interactive Signal setup wizard (the channel's `interactiveCommand`).
+ *
+ * Walks the operator through:
+ *   1. verify the `signal-cli` binary is installed (install hint when missing),
+ *   2. store the account number (E.164) in the vault — no API token exists for
+ *      Signal; identity comes from device linking,
+ *   3. choose the autonomous tool allow-list,
+ *   4. hand off to the pair flow (QR link) when the account isn't linked yet,
+ *      or start the channel directly when it is.
+ */
+export async function runSignalWizard(ctx) {
+    const vault = ctx.deps.vault;
+    intro(bold('moxxy signal setup'));
+    const binary = findSignalCliOnPath();
+    if (!binary) {
+        log.error(SIGNAL_CLI_INSTALL_HINT);
+        return 1;
+    }
+    log.success(`Found signal-cli: ${binary}`);
+    note('moxxy joins your Signal account as a LINKED DEVICE (like Signal Desktop).\n' +
+        'It will see the messages your account receives, so it runs on its own\n' +
+        'dedicated, isolated runner. After linking, message your own "Note to Self"\n' +
+        'to talk to moxxy; other senders must be allow-listed explicitly.', 'how the Signal channel works');
+    const existing = await vault.get(SIGNAL_ACCOUNT_KEY);
+    const account = await text({
+        message: 'Your Signal account number (E.164)',
+        placeholder: '+15551234567',
+        ...(existing ? { initialValue: existing } : {}),
+        validate: (v) => {
+            if (!v || !v.trim())
+                return 'required';
+            if (!E164_RE.test(v.trim()))
+                return 'expected E.164, e.g. +15551234567';
+            return undefined;
+        },
+    });
+    if (isCancel(account)) {
+        cancel('cancelled.');
+        return 0;
+    }
+    const accountNumber = String(account).trim();
+    await vault.set(SIGNAL_ACCOUNT_KEY, accountNumber, ['signal']);
+    log.success(`Stored account ${accountNumber} in the vault.`);
+    const allow = await text({
+        message: 'Autonomous tool allow-list (comma-separated; "*" = all, blank = read-only)',
+        placeholder: 'Read, Grep, Glob',
+    });
+    if (isCancel(allow)) {
+        cancel('cancelled.');
+        return 0;
+    }
+    const allowedTools = String(allow)
+        .split(',')
+        .map((s) => s.trim())
+        .filter(Boolean);
+    // Linked already? (one-shot listAccounts spawn; on probe failure fall through
+    // to the pair flow, which handles the already-linked case gracefully too).
+    let linked = false;
+    try {
+        linked = (await listSignalAccounts({ binary })).includes(accountNumber);
+    }
+    catch {
+        linked = false;
+    }
+    if (linked) {
+        log.info('This machine is already linked. Starting the channel…');
+        outro(dim('handing off to the channel…'));
+        return ctx.startChannel({ allowedTools });
+    }
+    note('Next: link this machine to your Signal account. A QR will appear —\n' +
+        'on your phone open Signal → Settings → Linked Devices → Link New Device\n' +
+        'and scan it. signal-cli keeps the linked-device keys in\n' +
+        '~/.local/share/signal-cli/ (moxxy stores only the number + allow-list).', 'link your phone');
+    outro(dim('opening the linking QR…'));
+    return runSignalPairFlow(ctx, { allowedTools });
+}
+//# sourceMappingURL=setup-wizard.js.map

package/dist/setup-wizard.js.map

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

package/dist/sidecar.d.ts

@@ -0,0 +1,137 @@
+import { SignalRpcClient, type RpcStream } from './jsonrpc.js';
+/**
+ * signal-cli sidecar lifecycle — the plugin owns the external `signal-cli`
+ * process the way `@moxxy/plugin-browser` owns its Playwright sidecar:
+ * spawn on channel `start()`, health-check before use, SIGTERM→SIGKILL grace
+ * on stop (via the sdk's `sleepWithAbort`, the runner-supervisor pattern).
+ *
+ * Transport: `signal-cli -a <account> daemon --socket <path>` — JSON-RPC over
+ * a UNIX socket. Chosen over `--tcp`/`--http` because a filesystem socket is
+ * never remotely reachable and needs no port/auth story; the socket lives in a
+ * fresh per-process temp path so two channels can't collide.
+ *
+ * signal-cli keeps the actual Signal protocol store (identity keys, sessions,
+ * message queue) in ITS OWN data dir — `$XDG_DATA_HOME/signal-cli/`
+ * (`~/.local/share/signal-cli/` by default). moxxy never touches those files;
+ * attachments land in `<dataDir>/attachments/<id>`.
+ */
+export interface SidecarLogger {
+    info?(msg: string, meta?: Record<string, unknown>): void;
+    warn?(msg: string, meta?: Record<string, unknown>): void;
+}
+/** The slice of `child_process.ChildProcess` the sidecar manager needs. */
+export interface SpawnedProcess {
+    readonly pid?: number | undefined;
+    kill(signal?: NodeJS.Signals): boolean;
+    once(event: 'exit', listener: (code: number | null) => void): unknown;
+    once(event: 'error', listener: (err: Error) => void): unknown;
+    readonly stderr?: {
+        on(event: 'data', listener: (chunk: Buffer | string) => void): unknown;
+    } | null;
+    readonly stdout?: {
+        on(event: 'data', listener: (chunk: Buffer | string) => void): unknown;
+    } | null;
+}
+export type SpawnFn = (command: string, args: ReadonlyArray<string>) => SpawnedProcess;
+export type ConnectFn = (socketPath: string) => Promise<RpcStream>;
+/** `$XDG_DATA_HOME/signal-cli` (defaults to `~/.local/share/signal-cli`). */
+export declare function signalCliDataDir(env?: NodeJS.ProcessEnv): string;
+/** Where the daemon writes received attachments (voice notes live here). */
+export declare function signalCliAttachmentsDir(env?: NodeJS.ProcessEnv): string;
+/**
+ * Cheap PATH probe for the `signal-cli` binary — a directory scan with an
+ * exec-bit check, NO process spawn (signal-cli is a JVM app; spawning it takes
+ * seconds and `isAvailable` runs on every `moxxy channels list` / `doctor`).
+ * Returns the resolved path or null. Never throws: a missing/odd PATH must
+ * not crash discovery.
+ */
+export declare function findSignalCliOnPath(env?: NodeJS.ProcessEnv): string | null;
+/** One-line install guidance surfaced when the binary is missing. */
+export declare const SIGNAL_CLI_INSTALL_HINT: string;
+export interface SignalSidecarOptions {
+    /** E.164 account the daemon serves (`-a <account>`). */
+    readonly account: string;
+    /** Binary path/name. Default `signal-cli` (resolved by the OS from PATH). */
+    readonly binary?: string;
+    /** Socket path override (tests). Default: fresh path under the OS tmpdir. */
+    readonly socketPath?: string;
+    /** How long to wait for the daemon socket + health check. Default 45s —
+     *  signal-cli is a JVM app and cold-starts slowly. */
+    readonly bootTimeoutMs?: number;
+    /** SIGTERM grace before SIGKILL. Default 5s. */
+    readonly killGraceMs?: number;
+    readonly logger?: SidecarLogger;
+    readonly spawnFn?: SpawnFn;
+    readonly connectFn?: ConnectFn;
+}
+export declare class SignalSidecar {
+    private readonly opts;
+    private child;
+    private exited;
+    private exitCode;
+    private client;
+    private readonly recentStderr;
+    private readonly exitListeners;
+    readonly socketPath: string;
+    constructor(opts: SignalSidecarOptions);
+    /** Fires when the daemon exits (clean stop AND crash). */
+    onExit(listener: (code: number | null) => void): () => void;
+    get rpc(): SignalRpcClient | null;
+    /**
+     * Spawn the daemon and wait until it is actually serving: the socket accepts
+     * a connection AND a `version` JSON-RPC round-trips. Rejects (and reaps the
+     * child) when the child dies early or the boot deadline passes, carrying the
+     * daemon's stderr tail so the CAUSE ("User +… is not registered") surfaces
+     * instead of a bare timeout.
+     */
+    start(): Promise<SignalRpcClient>;
+    /**
+     * Graceful shutdown: close the RPC stream, SIGTERM, wait `killGraceMs` for a
+     * clean exit (aborting the wait the moment `exit` fires — the sdk's
+     * `sleepWithAbort` pattern from the runner supervisor), then SIGKILL a
+     * holdout so a wedged JVM can never outlive the channel as an orphan.
+     */
+    stop(): Promise<void>;
+    /** Resolves true when the child exits within `ms`, false on timeout. */
+    private waitForExit;
+    private markExited;
+    private watchStderr;
+    private describeEarlyExit;
+    private stderrTailSuffix;
+    private removeSocketFile;
+}
+export interface LinkProcessHandle {
+    /** Resolves with the `sgnl://linkdevice…` URI to render as a QR. */
+    readonly uri: Promise<string>;
+    /** Resolves when the phone completed the link (process exited 0). Carries the
+     *  linked account number when signal-cli printed it. Rejects on failure. */
+    readonly completed: Promise<{
+        account: string | null;
+    }>;
+    cancel(): void;
+}
+/**
+ * Run `signal-cli link -n <deviceName>`: it prints the linking URI, then blocks
+ * until the phone scans it (or the QR expires, at which point it exits
+ * non-zero). Separate from the daemon — linking happens BEFORE an account
+ * exists locally, so the daemon (which requires one) can't do it.
+ */
+export declare function startLinkProcess(opts: {
+    readonly deviceName: string;
+    readonly binary?: string;
+    readonly spawnFn?: SpawnFn;
+    readonly logger?: SidecarLogger;
+}): LinkProcessHandle;
+/**
+ * List the accounts registered in the local signal-cli store (a one-shot
+ * `signal-cli --output=json listAccounts` spawn). Used at channel start to
+ * decide "linked already?" — NOT in `isAvailable` (JVM spawns are too slow for
+ * a discovery probe). Parses JSON output and falls back to scraping `+<digits>`
+ * so an older plain-text signal-cli still works.
+ */
+export declare function listSignalAccounts(opts?: {
+    readonly binary?: string;
+    readonly spawnFn?: SpawnFn;
+    readonly timeoutMs?: number;
+}): Promise<string[]>;
+//# sourceMappingURL=sidecar.d.ts.map

package/dist/sidecar.d.ts.map

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