@moxxy/sdk 0.21.1 → 0.23.0

package/dist/channel-control.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Process-independent control surface for dedicated channel runners.
+ *
+ * A dedicated channel (Slack, Telegram, …) runs as its OWN isolated runner
+ * subprocess that publishes a tiny status file (`channel-<name>.status.json`,
+ * see {@link ./channel-status}) on ready and clears it on graceful shutdown. That
+ * file — NOT a held child handle — is the source of truth for "is it running",
+ * so a channel started from anywhere (the TUI `/channels` panel, `moxxy channels
+ * start`, the desktop panel) is visible and stoppable from everywhere, and keeps
+ * running after the launcher exits.
+ *
+ * These helpers are the shared spine for those surfaces:
+ *  - {@link spawnDedicatedChannel} — start one, detached, on its own runner.
+ *  - {@link liveChannelStatus}/{@link listLiveChannelStatuses} — discover the
+ *    running ones (with stale-file self-healing).
+ *  - {@link stopDedicatedChannel} — signal one to stop.
+ *
+ * Node-only (`node:child_process`, `node:fs`) — exported from `@moxxy/sdk/server`.
+ */
+import { type ChannelRunStatus } from './channel-status.js';
+/**
+ * Start a channel on its own dedicated, detached runner by re-invoking this very
+ * moxxy binary as `moxxy <name>` with `MOXXY_DEDICATED_RUNNER=1`. The child is
+ * `detached` + `unref`'d with no stdio, so it OUTLIVES the launcher (the user can
+ * quit the TUI and the bot keeps serving) and reports itself via its status file.
+ *
+ * Returns the child pid, or undefined if the spawn produced none. Throws if the
+ * moxxy CLI entry can't be resolved (no `process.argv[1]`).
+ *
+ * Caller's job (this is fire-and-forget): poll {@link liveChannelStatus} to learn
+ * when it's ready / failed (no status file within a timeout ⇒ it died on boot —
+ * re-run `moxxy <name>` in the foreground to see why).
+ */
+export declare function spawnDedicatedChannel(name: string): number | undefined;
+/**
+ * Is `pid` a live process? `kill(pid, 0)` sends no signal — it only probes:
+ *  - resolves ⇒ alive,
+ *  - `ESRCH` ⇒ gone,
+ *  - `EPERM` ⇒ alive but owned by another user (treat as alive — it exists).
+ */
+export declare function isPidAlive(pid: number): boolean;
+/**
+ * The status of channel `name` IF it is actually running. Reads its status file
+ * and verifies the pid is alive; a file whose pid is dead (the runner crashed or
+ * was SIGKILL'd without clearing it) is treated as not-running AND removed, so a
+ * stale file never masquerades as a live channel.
+ */
+export declare function liveChannelStatus(name: string): ChannelRunStatus | null;
+/**
+ * Every currently-running dedicated channel, discovered by scanning the moxxy
+ * home for status files and filtering to live pids (self-healing stale ones).
+ * Returns [] when the home dir doesn't exist yet.
+ */
+export declare function listLiveChannelStatuses(): ChannelRunStatus[];
+/**
+ * Ask channel `name` to stop by SIGTERM-ing its runner. The runner's own signal
+ * handler tears down gracefully and clears its status file. Returns `'stopped'`
+ * if a live runner was signaled, `'not-running'` if there was nothing to stop.
+ *
+ * This is a single, synchronous SIGTERM — callers that want a hard backstop poll
+ * {@link liveChannelStatus} afterwards and escalate (SIGKILL + {@link clearChannelStatus})
+ * if it ignores the term within a grace period.
+ */
+export declare function stopDedicatedChannel(name: string): 'stopped' | 'not-running';
+//# sourceMappingURL=channel-control.d.ts.map

package/dist/channel-control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-control.d.ts","sourceRoot":"","sources":["../src/channel-control.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAKH,OAAO,EACL,KAAK,gBAAgB,EAGtB,MAAM,qBAAqB,CAAC;AAS7B;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAatE;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAQ/C;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAQvE;AAQD;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,gBAAgB,EAAE,CAe5D;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,CAU5E"}

package/dist/channel-control.js

@@ -0,0 +1,139 @@
+/**
+ * Process-independent control surface for dedicated channel runners.
+ *
+ * A dedicated channel (Slack, Telegram, …) runs as its OWN isolated runner
+ * subprocess that publishes a tiny status file (`channel-<name>.status.json`,
+ * see {@link ./channel-status}) on ready and clears it on graceful shutdown. That
+ * file — NOT a held child handle — is the source of truth for "is it running",
+ * so a channel started from anywhere (the TUI `/channels` panel, `moxxy channels
+ * start`, the desktop panel) is visible and stoppable from everywhere, and keeps
+ * running after the launcher exits.
+ *
+ * These helpers are the shared spine for those surfaces:
+ *  - {@link spawnDedicatedChannel} — start one, detached, on its own runner.
+ *  - {@link liveChannelStatus}/{@link listLiveChannelStatuses} — discover the
+ *    running ones (with stale-file self-healing).
+ *  - {@link stopDedicatedChannel} — signal one to stop.
+ *
+ * Node-only (`node:child_process`, `node:fs`) — exported from `@moxxy/sdk/server`.
+ */
+import { spawn } from 'node:child_process';
+import { readdirSync } from 'node:fs';
+import { clearChannelStatus, readChannelStatus, } from './channel-status.js';
+import { moxxyHome } from './fs-utils.js';
+/** Env vars that ADDRESS a runner (socket + sticky session). We scrub these from
+ *  a spawned channel's env so `applyDedicatedRunnerEnv` (which only fills UNSET
+ *  vars) derives the channel's OWN isolated socket/session from its name — rather
+ *  than the channel silently inheriting and sharing the launcher's runner. */
+const ADDRESSING_ENV = ['MOXXY_RUNNER_SOCKET', 'MOXXY_SESSION_ID', 'MOXXY_SESSION_SOURCE'];
+/**
+ * Start a channel on its own dedicated, detached runner by re-invoking this very
+ * moxxy binary as `moxxy <name>` with `MOXXY_DEDICATED_RUNNER=1`. The child is
+ * `detached` + `unref`'d with no stdio, so it OUTLIVES the launcher (the user can
+ * quit the TUI and the bot keeps serving) and reports itself via its status file.
+ *
+ * Returns the child pid, or undefined if the spawn produced none. Throws if the
+ * moxxy CLI entry can't be resolved (no `process.argv[1]`).
+ *
+ * Caller's job (this is fire-and-forget): poll {@link liveChannelStatus} to learn
+ * when it's ready / failed (no status file within a timeout ⇒ it died on boot —
+ * re-run `moxxy <name>` in the foreground to see why).
+ */
+export function spawnDedicatedChannel(name) {
+    const node = process.execPath; // the running Node binary (pnpm `moxxy` launches via Node)
+    const entry = process.argv[1]; // the resolved CLI entry (…/cli/dist/bin.js)
+    if (!entry) {
+        throw new Error('cannot start a channel: the moxxy CLI entry is unknown (process.argv[1] missing)');
+    }
+    const env = { ...process.env, MOXXY_DEDICATED_RUNNER: '1' };
+    for (const key of ADDRESSING_ENV)
+        delete env[key];
+    const child = spawn(node, [entry, name], { detached: true, stdio: 'ignore', env });
+    child.unref();
+    return child.pid;
+}
+/**
+ * Is `pid` a live process? `kill(pid, 0)` sends no signal — it only probes:
+ *  - resolves ⇒ alive,
+ *  - `ESRCH` ⇒ gone,
+ *  - `EPERM` ⇒ alive but owned by another user (treat as alive — it exists).
+ */
+export function isPidAlive(pid) {
+    if (!Number.isInteger(pid) || pid <= 0)
+        return false;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        return err.code === 'EPERM';
+    }
+}
+/**
+ * The status of channel `name` IF it is actually running. Reads its status file
+ * and verifies the pid is alive; a file whose pid is dead (the runner crashed or
+ * was SIGKILL'd without clearing it) is treated as not-running AND removed, so a
+ * stale file never masquerades as a live channel.
+ */
+export function liveChannelStatus(name) {
+    const status = readChannelStatus(name);
+    if (!status)
+        return null;
+    if (!isPidAlive(status.pid)) {
+        clearChannelStatus(name);
+        return null;
+    }
+    return status;
+}
+/** The channel name encoded in a `channel-<name>.status.json` file, or null. */
+function statusFileChannelName(file) {
+    const m = /^channel-(.+)\.status\.json$/.exec(file);
+    return m ? (m[1] ?? null) : null;
+}
+/**
+ * Every currently-running dedicated channel, discovered by scanning the moxxy
+ * home for status files and filtering to live pids (self-healing stale ones).
+ * Returns [] when the home dir doesn't exist yet.
+ */
+export function listLiveChannelStatuses() {
+    let files;
+    try {
+        files = readdirSync(moxxyHome());
+    }
+    catch {
+        return []; // no ~/.moxxy yet ⇒ nothing running
+    }
+    const live = [];
+    for (const file of files) {
+        const name = statusFileChannelName(file);
+        if (!name)
+            continue;
+        const status = liveChannelStatus(name);
+        if (status)
+            live.push(status);
+    }
+    return live;
+}
+/**
+ * Ask channel `name` to stop by SIGTERM-ing its runner. The runner's own signal
+ * handler tears down gracefully and clears its status file. Returns `'stopped'`
+ * if a live runner was signaled, `'not-running'` if there was nothing to stop.
+ *
+ * This is a single, synchronous SIGTERM — callers that want a hard backstop poll
+ * {@link liveChannelStatus} afterwards and escalate (SIGKILL + {@link clearChannelStatus})
+ * if it ignores the term within a grace period.
+ */
+export function stopDedicatedChannel(name) {
+    const status = liveChannelStatus(name);
+    if (!status)
+        return 'not-running';
+    try {
+        process.kill(status.pid, 'SIGTERM');
+    }
+    catch {
+        // Raced us to exit between the liveness check and here — already stopped.
+        clearChannelStatus(name);
+    }
+    return 'stopped';
+}
+//# sourceMappingURL=channel-control.js.map

package/dist/channel-control.js.map

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

package/dist/channel-status.d.ts

@@ -0,0 +1,32 @@
+/**
+ * The on-disk status a dedicated channel runner publishes so an out-of-process
+ * supervisor (the desktop "Channels" panel) can observe it without the runner
+ * protocol. Written by `moxxy <channel>` when it self-hosts a dedicated runner,
+ * read by the desktop host; removed on graceful shutdown.
+ *
+ * It is intentionally tiny — readiness + the public ingest URL — not a mirror of
+ * the session. The supervisor owns liveness (it holds the child handle); this
+ * file is the channel's own report of "I'm up, and here's the URL to paste".
+ */
+export interface ChannelRunStatus {
+    /** Channel name (e.g. `slack`, `telegram`). */
+    readonly name: string;
+    /** PID of the channel runner process. */
+    readonly pid: number;
+    /** ISO timestamp the channel reported ready. */
+    readonly startedAt: string;
+    /** The session source the runner stamped (e.g. `slack`). */
+    readonly source?: string;
+    /** Public ingest URL (e.g. Slack's Events Request URL) once the tunnel is up;
+     *  null for channels with no inbound endpoint (Telegram long-polls). */
+    readonly requestUrl?: string | null;
+}
+/** `~/.moxxy/channel-<name>.status.json` (honors `$MOXXY_HOME`). */
+export declare function channelStatusPath(name: string): string;
+/** Atomically publish a channel's run status (0600 — it may carry a URL). */
+export declare function writeChannelStatus(status: ChannelRunStatus): void;
+/** Read a channel's published status, or null if absent/unparseable. */
+export declare function readChannelStatus(name: string): ChannelRunStatus | null;
+/** Remove a channel's status file (best-effort; called on graceful shutdown). */
+export declare function clearChannelStatus(name: string): void;
+//# sourceMappingURL=channel-status.d.ts.map

package/dist/channel-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-status.d.ts","sourceRoot":"","sources":["../src/channel-status.ts"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,4DAA4D;IAC5D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB;4EACwE;IACxE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAED,oEAAoE;AACpE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,6EAA6E;AAC7E,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAEjE;AAED,wEAAwE;AACxE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAMvE;AAED,iFAAiF;AACjF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAMrD"}

package/dist/channel-status.js

@@ -0,0 +1,29 @@
+import { readFileSync, rmSync } from 'node:fs';
+import { moxxyPath, writeFileAtomicSync } from './fs-utils.js';
+/** `~/.moxxy/channel-<name>.status.json` (honors `$MOXXY_HOME`). */
+export function channelStatusPath(name) {
+    return moxxyPath(`channel-${name}.status.json`);
+}
+/** Atomically publish a channel's run status (0600 — it may carry a URL). */
+export function writeChannelStatus(status) {
+    writeFileAtomicSync(channelStatusPath(status.name), JSON.stringify(status), { mode: 0o600 });
+}
+/** Read a channel's published status, or null if absent/unparseable. */
+export function readChannelStatus(name) {
+    try {
+        return JSON.parse(readFileSync(channelStatusPath(name), 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+/** Remove a channel's status file (best-effort; called on graceful shutdown). */
+export function clearChannelStatus(name) {
+    try {
+        rmSync(channelStatusPath(name), { force: true });
+    }
+    catch {
+        /* best-effort */
+    }
+}
+//# sourceMappingURL=channel-status.js.map

package/dist/channel-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-status.js","sourceRoot":"","sources":["../src/channel-status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAE/C,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AA0B/D,oEAAoE;AACpE,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,SAAS,CAAC,WAAW,IAAI,cAAc,CAAC,CAAC;AAClD,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,kBAAkB,CAAC,MAAwB;IACzD,mBAAmB,CAAC,iBAAiB,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AAC/F,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAqB,CAAC;IACvF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,IAAI,CAAC;QACH,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC;QACP,iBAAiB;IACnB,CAAC;AACH,CAAC"}

package/dist/channel.d.ts

@@ -1,5 +1,6 @@
 import type { PermissionResolver } from './permission.js';
 import type { ClientSession } from './client-session.js';
+import type { SessionSource } from './event-store.js';
 /**
  * A Channel is a bidirectional surface that drives a Session: it feeds user
  * prompts in, renders assistant chunks + tool activity out, and implements a
@@ -22,6 +23,16 @@ export interface Channel<TStartOpts = unknown> {
      * resolves when the channel exits gracefully.
      */
     start(opts: TStartOpts): Promise<ChannelHandle>;
+    /**
+     * The channel's runtime "connect value" — published once running and surfaced
+     * by control surfaces per the channel's declared {@link ChannelConnectStep}.
+     * Its meaning depends on `connect.kind`: for Slack it is the Events Request URL
+     * the user pastes into the app (after its proxy tunnel opens); for Telegram it
+     * is the `https://t.me/<botname>` link of the resolved bot. Null when the
+     * channel has no connect value yet (still resolving) or none at all. Read by
+     * the dedicated-runner host and written to the channel's status file.
+     */
+    readonly requestUrl?: string | null;
 }
 export interface ChannelHandle {
     /**
@@ -121,6 +132,94 @@ export interface ChannelDef<TStartOpts = unknown> {
      * starts the channel.
      */
     readonly interactiveCommand?: string;
+    /**
+     * Declare that this channel runs on its OWN dedicated, isolated runner: a
+     * distinct runner socket (`channel-<name>.sock`) + a stable sticky session id
+     * (`moxxy-channel-<name>`), so the channel acts as its own agent thread,
+     * separate from whatever runner serves the desktop/TUI. NO runner-protocol
+     * change — one dedicated runner is still one Session. Channels that should
+     * operate autonomously (slack, telegram) set this; the CLI reads it generically
+     * (see `applyDedicatedRunnerEnv`) so no per-channel name list is needed. Any
+     * channel can also opt in at runtime via `--dedicated` / `MOXXY_DEDICATED_RUNNER=1`.
+     */
+    readonly dedicatedRunner?: boolean;
+    /**
+     * The {@link SessionSource} to stamp on this channel's sessions when it runs
+     * dedicated (persisted into the meta sidecar; surfaces filter history by it).
+     * Only honored alongside `dedicatedRunner`. When unset, the source falls back
+     * to the usual env/default resolution.
+     */
+    readonly sessionSource?: SessionSource;
+    /**
+     * Declarative config the channel needs to run (its secret fields + where they
+     * live in the vault, plus pairing hints). This is what a control surface — the
+     * TUI `/channels` panel, `moxxy channels start`, the desktop "Channels" panel —
+     * renders to let the user configure + start the channel WITHOUT hardcoding a
+     * per-channel table. The channel self-describes here; the vault keys named are
+     * the same ones the channel actually reads at boot (its `keys.ts`). Channels
+     * with no setup (web/http) omit this.
+     */
+    readonly config?: ChannelConfigDescriptor;
+}
+/** One secret/config input a channel exposes for a control surface to collect. */
+export interface ChannelConfigField {
+    /** Option key (e.g. `botToken`). Stable identifier within the channel. */
+    readonly name: string;
+    /** Short human label (e.g. `Bot token`). */
+    readonly label: string;
+    /** The vault key the channel reads this value from (e.g. `slack_bot_token`). */
+    readonly vaultKey: string;
+    /** Must be present for the channel to count as "configured". */
+    readonly required?: boolean;
+    /** Treat as a secret — mask the input and never echo the stored value. */
+    readonly secret?: boolean;
+    /** Placeholder shown in an empty input (e.g. `xoxb-…`). */
+    readonly placeholder?: string;
+    /** One-line guidance on where to obtain the value. */
+    readonly help?: string;
+}
+/** What a channel declares about being configured + run from a control surface. */
+export interface ChannelConfigDescriptor {
+    /** The fields to collect, in display order. */
+    readonly fields: ReadonlyArray<ChannelConfigField>;
+    /** The channel exposes a public ingest URL (Slack's Request URL) once started,
+     *  so a control surface should poll for + surface it. */
+    readonly hasRequestUrl?: boolean;
+    /** Post-start pairing/setup instructions to show the user. */
+    readonly runHint?: string;
+    /** How a control surface should present the "now connect the other side" step
+     *  once the channel is running — declaratively, so each channel renders the
+     *  same way without per-channel UI code. See {@link ChannelConnectStep}. */
+    readonly connect?: ChannelConnectStep;
+}
+/**
+ * Declares how a control surface (TUI `/channels`, the desktop Channels panel)
+ * presents a channel's post-start "connect" step. The runtime VALUE this step
+ * renders is the channel's {@link Channel.requestUrl} (Slack's Request URL,
+ * Telegram's `t.me/<bot>` link); this descriptor only says how to render it, so
+ * a new channel plugs in by declaring a `kind` rather than shipping bespoke UI.
+ */
+export interface ChannelConnectStep {
+    /**
+     * Presentation of the channel's runtime connect value:
+     * - `qr`: render a QR of the value plus the value itself (e.g. scan/open a
+     *   `t.me/<bot>` link, or a mobile pairing URL).
+     * - `url`: show the value as a copyable URL the user pastes elsewhere
+     *   (Slack's Events Request URL).
+     * - `instructions`: static `steps`, no runtime value.
+     */
+    readonly kind: 'qr' | 'url' | 'instructions';
+    /** Heading for the step, e.g. "Connect your Telegram". */
+    readonly title?: string;
+    /** One-line helper under the value, e.g. "Scan, or open the link and send /start". */
+    readonly hint?: string;
+    /** When true and the value is an https URL the user should OPEN (not paste),
+     *  a control surface may show an "open externally" affordance. */
+    readonly openable?: boolean;
+    /** Label for the open affordance, e.g. "Open in Telegram". */
+    readonly openLabel?: string;
+    /** For `kind: 'instructions'` — static steps shown verbatim (no runtime value). */
+    readonly steps?: ReadonlyArray<string>;
 }
 export interface ChannelAvailability {
     readonly ok: boolean;

package/dist/channel.d.ts.map

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

package/dist/channel.js.map

@@ -1 +1 @@
-{"version":3,"file":"channel.js","sourceRoot":"","sources":["../src/channel.ts"],"names":[],"mappings":"AAgDA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAgB,EAAE,IAAsB;IACvE,oEAAoE;IACpE,8EAA8E;IAC9E,oEAAoE;IACpE,OAAO,OAAO,CAAC,KAAK,CAAC,IAAa,CAAC,CAAC;AACtC,CAAC"}
+{"version":3,"file":"channel.js","sourceRoot":"","sources":["../src/channel.ts"],"names":[],"mappings":"AA4DA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAgB,EAAE,IAAsB;IACvE,oEAAoE;IACpE,8EAA8E;IAC9E,oEAAoE;IACpE,OAAO,OAAO,CAAC,KAAK,CAAC,IAAa,CAAC,CAAC;AACtC,CAAC"}

package/dist/event-store.d.ts

@@ -11,7 +11,7 @@ import type { SessionId } from './ids.js';
  * event (prompts, tool I/O), so that explicit opt-in is the trust boundary.
  */
 /** Originating channel of a session (persisted into the meta sidecar). */
-export type SessionSource = 'cli' | 'tui' | 'desktop' | 'mobile';
+export type SessionSource = 'cli' | 'tui' | 'desktop' | 'mobile' | 'slack' | 'telegram';
 /**
  * The single per-session metadata record (the JSONL impl writes it to
  * `~/.moxxy/sessions/<id>.json`). ONE per session — the unit every surface

package/dist/event-store.d.ts.map

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

package/dist/index.d.ts

@@ -21,6 +21,7 @@ export type { TunnelProviderDef, TunnelHandle, TunnelOpenOptions } from './tunne
 export type { EventStoreDef, EventStoreSession, EventStoreScope, EventLogLike, EventPage, SessionMeta, SessionSource, } from './event-store.js';
 export { isRetryableError, toFriendlyError, zodToJsonSchema, estimateTextTokens, type StopReason } from './provider-utils.js';
 export type { WriteFileAtomicOptions } from './fs-utils.js';
+export type { ChannelRunStatus } from './channel-status.js';
 export type { CrossProcessFireLock, CrossProcessFireLockOptions } from './cross-process-lock.js';
 export { createMutex, type Mutex } from './mutex.js';
 export { createJsonFileStore, type JsonFileStore, type JsonFileStoreOptions, } from './json-file-store.js';
@@ -46,7 +47,7 @@ export type { AppContext, TurnContext, ToolCallContext, ToolResultContext, ToolC
 export type { ServiceRegistry, NamedRegistry } from './services.js';
 export type { PluginKind, PluginSpec, Plugin, PluginManifest, ResolvedPluginManifest, } from './plugin.js';
 export { startChannelWith } from './channel.js';
-export type { Channel, ChannelHandle, ChannelStartArgs, ChannelStartOptsBase, ChannelFactoryDeps, ChannelDef, ChannelAvailability, ChannelRegistry, ChannelSubcommand, ChannelSubcommandContext, ChannelCommandArgs, } from './channel.js';
+export type { Channel, ChannelHandle, ChannelStartArgs, ChannelStartOptsBase, ChannelFactoryDeps, ChannelDef, ChannelConfigField, ChannelConfigDescriptor, ChannelConnectStep, ChannelAvailability, ChannelRegistry, ChannelSubcommand, ChannelSubcommandContext, ChannelCommandArgs, } from './channel.js';
 export type { EmbeddingProvider, EmbedderDef } from './embedding.js';
 export { CachedEmbeddingProvider } from './embedding-cache.js';
 export { defineSurface } from './surface.js';

package/dist/index.d.ts.map

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

package/dist/index.js.map

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

package/dist/server.d.ts

@@ -17,5 +17,7 @@
 export { writeFileAtomic, writeFileAtomicSync, moxxyHome, moxxyPath, } from './fs-utils.js';
 export { CrossProcessFireLock } from './cross-process-lock.js';
 export { readRequestBody, bearerTokenMatches } from './http-utils.js';
+export { channelStatusPath, writeChannelStatus, readChannelStatus, clearChannelStatus, } from './channel-status.js';
+export { spawnDedicatedChannel, isPidAlive, liveChannelStatus, listLiveChannelStatuses, stopDedicatedChannel, } from './channel-control.js';
 export { resolveChannelToken, rotateChannelToken, bearerGuard, encodeWsBearerProtocol, tokenFromWsProtocolHeader, MOXXY_WS_SUBPROTOCOL, MOXXY_WS_BEARER_PROTOCOL_PREFIX, } from './channel-auth.js';
 //# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,SAAS,EACT,SAAS,GACV,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,WAAW,EACX,sBAAsB,EACtB,yBAAyB,EACzB,oBAAoB,EACpB,+BAA+B,GAChC,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,SAAS,EACT,SAAS,GACV,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAItE,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAI7B,OAAO,EACL,qBAAqB,EACrB,UAAU,EACV,iBAAiB,EACjB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,WAAW,EACX,sBAAsB,EACtB,yBAAyB,EACzB,oBAAoB,EACpB,+BAA+B,GAChC,MAAM,mBAAmB,CAAC"}

package/dist/server.js

@@ -19,5 +19,13 @@ export { writeFileAtomic, writeFileAtomicSync, moxxyHome, moxxyPath, } from './f
 // options type is re-exported from the main barrel like other erased types.
 export { CrossProcessFireLock } from './cross-process-lock.js';
 export { readRequestBody, bearerTokenMatches } from './http-utils.js';
+// Dedicated-channel run-status file: a channel publishes readiness + its public
+// ingest URL so the desktop "Channels" supervisor can observe it out-of-process
+// (node:fs). The `ChannelRunStatus` *type* rides the main barrel like the others.
+export { channelStatusPath, writeChannelStatus, readChannelStatus, clearChannelStatus, } from './channel-status.js';
+// Process-independent control of dedicated channel runners (start detached,
+// discover via status files, stop) — shared by the TUI `/channels` panel and the
+// `moxxy channels start|stop|status` subcommands (node:child_process + node:fs).
+export { spawnDedicatedChannel, isPidAlive, liveChannelStatus, listLiveChannelStatuses, stopDedicatedChannel, } from './channel-control.js';
 export { resolveChannelToken, rotateChannelToken, bearerGuard, encodeWsBearerProtocol, tokenFromWsProtocolHeader, MOXXY_WS_SUBPROTOCOL, MOXXY_WS_BEARER_PROTOCOL_PREFIX, } from './channel-auth.js';
 //# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,SAAS,EACT,SAAS,GACV,MAAM,eAAe,CAAC;AACvB,0EAA0E;AAC1E,4EAA4E;AAC5E,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,WAAW,EACX,sBAAsB,EACtB,yBAAyB,EACzB,oBAAoB,EACpB,+BAA+B,GAChC,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,SAAS,EACT,SAAS,GACV,MAAM,eAAe,CAAC;AACvB,0EAA0E;AAC1E,4EAA4E;AAC5E,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACtE,gFAAgF;AAChF,gFAAgF;AAChF,kFAAkF;AAClF,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAC7B,4EAA4E;AAC5E,iFAAiF;AACjF,iFAAiF;AACjF,OAAO,EACL,qBAAqB,EACrB,UAAU,EACV,iBAAiB,EACjB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,WAAW,EACX,sBAAsB,EACtB,yBAAyB,EACzB,oBAAoB,EACpB,+BAA+B,GAChC,MAAM,mBAAmB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moxxy/sdk",
-  "version": "0.21.1",
+  "version": "0.23.0",
   "description": "Typed public surface for the moxxy framework: event types, define* factories, lifecycle hook signatures.",
   "keywords": [
     "moxxy",

package/src/channel-control.test.ts

@@ -0,0 +1,141 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+
+// `spawnDedicatedChannel` re-invokes the CLI via node:child_process — mock it so
+// the test asserts the spawn shape without launching a real process. `vi.hoisted`
+// makes the mock fn available to the hoisted `vi.mock` factory.
+const { spawnMock } = vi.hoisted(() => ({
+  spawnMock: vi.fn(() => ({ pid: 4321, unref: (): void => {} })),
+}));
+vi.mock('node:child_process', () => ({ spawn: spawnMock }));
+
+import {
+  isPidAlive,
+  listLiveChannelStatuses,
+  liveChannelStatus,
+  spawnDedicatedChannel,
+  stopDedicatedChannel,
+} from './channel-control.js';
+import { channelStatusPath, writeChannelStatus } from './channel-status.js';
+
+// A pid that is essentially never alive (above the platform max) → ESRCH.
+const DEAD_PID = 2_000_000_000;
+
+let home: string;
+let prevHome: string | undefined;
+
+beforeEach(() => {
+  home = fs.mkdtempSync(path.join(os.tmpdir(), 'moxxy-channel-control-'));
+  prevHome = process.env.MOXXY_HOME;
+  process.env.MOXXY_HOME = home;
+  spawnMock.mockClear();
+});
+
+afterEach(() => {
+  if (prevHome === undefined) delete process.env.MOXXY_HOME;
+  else process.env.MOXXY_HOME = prevHome;
+  fs.rmSync(home, { recursive: true, force: true });
+  vi.restoreAllMocks();
+});
+
+describe('isPidAlive', () => {
+  it('is true for the current process, false for a dead/invalid pid', () => {
+    expect(isPidAlive(process.pid)).toBe(true);
+    expect(isPidAlive(DEAD_PID)).toBe(false);
+    expect(isPidAlive(0)).toBe(false);
+    expect(isPidAlive(-1)).toBe(false);
+  });
+});
+
+describe('liveChannelStatus', () => {
+  it('returns null when no status file exists', () => {
+    expect(liveChannelStatus('slack')).toBeNull();
+  });
+
+  it('returns the status when the runner pid is alive', () => {
+    writeChannelStatus({
+      name: 'slack',
+      pid: process.pid,
+      startedAt: new Date().toISOString(),
+      requestUrl: 'https://example.test/slack',
+    });
+    const s = liveChannelStatus('slack');
+    expect(s?.pid).toBe(process.pid);
+    expect(s?.requestUrl).toBe('https://example.test/slack');
+  });
+
+  it('self-heals a stale file (dead pid) — returns null AND removes it', () => {
+    writeChannelStatus({ name: 'ghost', pid: DEAD_PID, startedAt: new Date().toISOString() });
+    expect(fs.existsSync(channelStatusPath('ghost'))).toBe(true);
+    expect(liveChannelStatus('ghost')).toBeNull();
+    expect(fs.existsSync(channelStatusPath('ghost'))).toBe(false);
+  });
+});
+
+describe('listLiveChannelStatuses', () => {
+  it('returns only live channels, drops stale files, ignores unrelated files', () => {
+    writeChannelStatus({ name: 'slack', pid: process.pid, startedAt: new Date().toISOString() });
+    writeChannelStatus({ name: 'telegram', pid: process.pid, startedAt: new Date().toISOString() });
+    writeChannelStatus({ name: 'ghost', pid: DEAD_PID, startedAt: new Date().toISOString() });
+    fs.writeFileSync(path.join(home, 'vault.json'), '{}'); // unrelated file in ~/.moxxy
+
+    const names = listLiveChannelStatuses()
+      .map((s) => s.name)
+      .sort();
+    expect(names).toEqual(['slack', 'telegram']);
+    expect(fs.existsSync(channelStatusPath('ghost'))).toBe(false);
+  });
+
+  it('returns [] when the home dir does not exist', () => {
+    process.env.MOXXY_HOME = path.join(home, 'does-not-exist');
+    expect(listLiveChannelStatuses()).toEqual([]);
+  });
+});
+
+describe('stopDedicatedChannel', () => {
+  it('reports not-running when there is no live status', () => {
+    expect(stopDedicatedChannel('slack')).toBe('not-running');
+  });
+
+  it('SIGTERMs the live runner and reports stopped', () => {
+    // Intercept kill so the liveness probe (signal 0) reports alive and the
+    // SIGTERM is recorded rather than actually delivered.
+    const killSpy = vi
+      .spyOn(process, 'kill')
+      .mockImplementation(((_pid: number, _sig?: string | number) => true) as typeof process.kill);
+    writeChannelStatus({ name: 'slack', pid: 999_999, startedAt: new Date().toISOString() });
+
+    expect(stopDedicatedChannel('slack')).toBe('stopped');
+    expect(killSpy).toHaveBeenCalledWith(999_999, 'SIGTERM');
+  });
+});
+
+describe('spawnDedicatedChannel', () => {
+  it('spawns a detached, dedicated runner with a scrubbed env', () => {
+    process.env.MOXXY_RUNNER_SOCKET = '/tmp/should-be-scrubbed.sock';
+    process.env.MOXXY_SESSION_ID = 'should-be-scrubbed';
+    try {
+      const pid = spawnDedicatedChannel('slack');
+      expect(pid).toBe(4321);
+      expect(spawnMock).toHaveBeenCalledTimes(1);
+      const [bin, argsArg, optsArg] = spawnMock.mock.calls[0] as [
+        string,
+        string[],
+        { detached?: boolean; stdio?: string; env?: NodeJS.ProcessEnv },
+      ];
+      expect(bin).toBe(process.execPath);
+      expect(argsArg).toEqual([process.argv[1], 'slack']);
+      expect(optsArg.detached).toBe(true);
+      expect(optsArg.stdio).toBe('ignore');
+      // Dedicated flag set; addressing vars scrubbed so the channel isolates.
+      expect(optsArg.env?.MOXXY_DEDICATED_RUNNER).toBe('1');
+      expect(optsArg.env?.MOXXY_RUNNER_SOCKET).toBeUndefined();
+      expect(optsArg.env?.MOXXY_SESSION_ID).toBeUndefined();
+    } finally {
+      delete process.env.MOXXY_RUNNER_SOCKET;
+      delete process.env.MOXXY_SESSION_ID;
+    }
+  });
+});

package/src/channel-control.ts

@@ -0,0 +1,144 @@
+/**
+ * Process-independent control surface for dedicated channel runners.
+ *
+ * A dedicated channel (Slack, Telegram, …) runs as its OWN isolated runner
+ * subprocess that publishes a tiny status file (`channel-<name>.status.json`,
+ * see {@link ./channel-status}) on ready and clears it on graceful shutdown. That
+ * file — NOT a held child handle — is the source of truth for "is it running",
+ * so a channel started from anywhere (the TUI `/channels` panel, `moxxy channels
+ * start`, the desktop panel) is visible and stoppable from everywhere, and keeps
+ * running after the launcher exits.
+ *
+ * These helpers are the shared spine for those surfaces:
+ *  - {@link spawnDedicatedChannel} — start one, detached, on its own runner.
+ *  - {@link liveChannelStatus}/{@link listLiveChannelStatuses} — discover the
+ *    running ones (with stale-file self-healing).
+ *  - {@link stopDedicatedChannel} — signal one to stop.
+ *
+ * Node-only (`node:child_process`, `node:fs`) — exported from `@moxxy/sdk/server`.
+ */
+
+import { spawn } from 'node:child_process';
+import { readdirSync } from 'node:fs';
+
+import {
+  type ChannelRunStatus,
+  clearChannelStatus,
+  readChannelStatus,
+} from './channel-status.js';
+import { moxxyHome } from './fs-utils.js';
+
+/** Env vars that ADDRESS a runner (socket + sticky session). We scrub these from
+ *  a spawned channel's env so `applyDedicatedRunnerEnv` (which only fills UNSET
+ *  vars) derives the channel's OWN isolated socket/session from its name — rather
+ *  than the channel silently inheriting and sharing the launcher's runner. */
+const ADDRESSING_ENV = ['MOXXY_RUNNER_SOCKET', 'MOXXY_SESSION_ID', 'MOXXY_SESSION_SOURCE'] as const;
+
+/**
+ * Start a channel on its own dedicated, detached runner by re-invoking this very
+ * moxxy binary as `moxxy <name>` with `MOXXY_DEDICATED_RUNNER=1`. The child is
+ * `detached` + `unref`'d with no stdio, so it OUTLIVES the launcher (the user can
+ * quit the TUI and the bot keeps serving) and reports itself via its status file.
+ *
+ * Returns the child pid, or undefined if the spawn produced none. Throws if the
+ * moxxy CLI entry can't be resolved (no `process.argv[1]`).
+ *
+ * Caller's job (this is fire-and-forget): poll {@link liveChannelStatus} to learn
+ * when it's ready / failed (no status file within a timeout ⇒ it died on boot —
+ * re-run `moxxy <name>` in the foreground to see why).
+ */
+export function spawnDedicatedChannel(name: string): number | undefined {
+  const node = process.execPath; // the running Node binary (pnpm `moxxy` launches via Node)
+  const entry = process.argv[1]; // the resolved CLI entry (…/cli/dist/bin.js)
+  if (!entry) {
+    throw new Error('cannot start a channel: the moxxy CLI entry is unknown (process.argv[1] missing)');
+  }
+
+  const env: NodeJS.ProcessEnv = { ...process.env, MOXXY_DEDICATED_RUNNER: '1' };
+  for (const key of ADDRESSING_ENV) delete env[key];
+
+  const child = spawn(node, [entry, name], { detached: true, stdio: 'ignore', env });
+  child.unref();
+  return child.pid;
+}
+
+/**
+ * Is `pid` a live process? `kill(pid, 0)` sends no signal — it only probes:
+ *  - resolves ⇒ alive,
+ *  - `ESRCH` ⇒ gone,
+ *  - `EPERM` ⇒ alive but owned by another user (treat as alive — it exists).
+ */
+export function isPidAlive(pid: number): boolean {
+  if (!Number.isInteger(pid) || pid <= 0) return false;
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch (err) {
+    return (err as NodeJS.ErrnoException).code === 'EPERM';
+  }
+}
+
+/**
+ * The status of channel `name` IF it is actually running. Reads its status file
+ * and verifies the pid is alive; a file whose pid is dead (the runner crashed or
+ * was SIGKILL'd without clearing it) is treated as not-running AND removed, so a
+ * stale file never masquerades as a live channel.
+ */
+export function liveChannelStatus(name: string): ChannelRunStatus | null {
+  const status = readChannelStatus(name);
+  if (!status) return null;
+  if (!isPidAlive(status.pid)) {
+    clearChannelStatus(name);
+    return null;
+  }
+  return status;
+}
+
+/** The channel name encoded in a `channel-<name>.status.json` file, or null. */
+function statusFileChannelName(file: string): string | null {
+  const m = /^channel-(.+)\.status\.json$/.exec(file);
+  return m ? (m[1] ?? null) : null;
+}
+
+/**
+ * Every currently-running dedicated channel, discovered by scanning the moxxy
+ * home for status files and filtering to live pids (self-healing stale ones).
+ * Returns [] when the home dir doesn't exist yet.
+ */
+export function listLiveChannelStatuses(): ChannelRunStatus[] {
+  let files: string[];
+  try {
+    files = readdirSync(moxxyHome());
+  } catch {
+    return []; // no ~/.moxxy yet ⇒ nothing running
+  }
+  const live: ChannelRunStatus[] = [];
+  for (const file of files) {
+    const name = statusFileChannelName(file);
+    if (!name) continue;
+    const status = liveChannelStatus(name);
+    if (status) live.push(status);
+  }
+  return live;
+}
+
+/**
+ * Ask channel `name` to stop by SIGTERM-ing its runner. The runner's own signal
+ * handler tears down gracefully and clears its status file. Returns `'stopped'`
+ * if a live runner was signaled, `'not-running'` if there was nothing to stop.
+ *
+ * This is a single, synchronous SIGTERM — callers that want a hard backstop poll
+ * {@link liveChannelStatus} afterwards and escalate (SIGKILL + {@link clearChannelStatus})
+ * if it ignores the term within a grace period.
+ */
+export function stopDedicatedChannel(name: string): 'stopped' | 'not-running' {
+  const status = liveChannelStatus(name);
+  if (!status) return 'not-running';
+  try {
+    process.kill(status.pid, 'SIGTERM');
+  } catch {
+    // Raced us to exit between the liveness check and here — already stopped.
+    clearChannelStatus(name);
+  }
+  return 'stopped';
+}

package/src/channel-status.ts

@@ -0,0 +1,55 @@
+import { readFileSync, rmSync } from 'node:fs';
+
+import { moxxyPath, writeFileAtomicSync } from './fs-utils.js';
+
+/**
+ * The on-disk status a dedicated channel runner publishes so an out-of-process
+ * supervisor (the desktop "Channels" panel) can observe it without the runner
+ * protocol. Written by `moxxy <channel>` when it self-hosts a dedicated runner,
+ * read by the desktop host; removed on graceful shutdown.
+ *
+ * It is intentionally tiny — readiness + the public ingest URL — not a mirror of
+ * the session. The supervisor owns liveness (it holds the child handle); this
+ * file is the channel's own report of "I'm up, and here's the URL to paste".
+ */
+export interface ChannelRunStatus {
+  /** Channel name (e.g. `slack`, `telegram`). */
+  readonly name: string;
+  /** PID of the channel runner process. */
+  readonly pid: number;
+  /** ISO timestamp the channel reported ready. */
+  readonly startedAt: string;
+  /** The session source the runner stamped (e.g. `slack`). */
+  readonly source?: string;
+  /** Public ingest URL (e.g. Slack's Events Request URL) once the tunnel is up;
+   *  null for channels with no inbound endpoint (Telegram long-polls). */
+  readonly requestUrl?: string | null;
+}
+
+/** `~/.moxxy/channel-<name>.status.json` (honors `$MOXXY_HOME`). */
+export function channelStatusPath(name: string): string {
+  return moxxyPath(`channel-${name}.status.json`);
+}
+
+/** Atomically publish a channel's run status (0600 — it may carry a URL). */
+export function writeChannelStatus(status: ChannelRunStatus): void {
+  writeFileAtomicSync(channelStatusPath(status.name), JSON.stringify(status), { mode: 0o600 });
+}
+
+/** Read a channel's published status, or null if absent/unparseable. */
+export function readChannelStatus(name: string): ChannelRunStatus | null {
+  try {
+    return JSON.parse(readFileSync(channelStatusPath(name), 'utf8')) as ChannelRunStatus;
+  } catch {
+    return null;
+  }
+}
+
+/** Remove a channel's status file (best-effort; called on graceful shutdown). */
+export function clearChannelStatus(name: string): void {
+  try {
+    rmSync(channelStatusPath(name), { force: true });
+  } catch {
+    /* best-effort */
+  }
+}

package/src/channel.ts

@@ -1,5 +1,6 @@
 import type { PermissionResolver } from './permission.js';
 import type { ClientSession } from './client-session.js';
+import type { SessionSource } from './event-store.js';
 
 /**
  * A Channel is a bidirectional surface that drives a Session: it feeds user
@@ -25,6 +26,17 @@ export interface Channel<TStartOpts = unknown> {
    * resolves when the channel exits gracefully.
    */
   start(opts: TStartOpts): Promise<ChannelHandle>;
+
+  /**
+   * The channel's runtime "connect value" — published once running and surfaced
+   * by control surfaces per the channel's declared {@link ChannelConnectStep}.
+   * Its meaning depends on `connect.kind`: for Slack it is the Events Request URL
+   * the user pastes into the app (after its proxy tunnel opens); for Telegram it
+   * is the `https://t.me/<botname>` link of the resolved bot. Null when the
+   * channel has no connect value yet (still resolving) or none at all. Read by
+   * the dedicated-runner host and written to the channel's status file.
+   */
+  readonly requestUrl?: string | null;
 }
 
 export interface ChannelHandle {
@@ -134,6 +146,97 @@ export interface ChannelDef<TStartOpts = unknown> {
    * starts the channel.
    */
   readonly interactiveCommand?: string;
+  /**
+   * Declare that this channel runs on its OWN dedicated, isolated runner: a
+   * distinct runner socket (`channel-<name>.sock`) + a stable sticky session id
+   * (`moxxy-channel-<name>`), so the channel acts as its own agent thread,
+   * separate from whatever runner serves the desktop/TUI. NO runner-protocol
+   * change — one dedicated runner is still one Session. Channels that should
+   * operate autonomously (slack, telegram) set this; the CLI reads it generically
+   * (see `applyDedicatedRunnerEnv`) so no per-channel name list is needed. Any
+   * channel can also opt in at runtime via `--dedicated` / `MOXXY_DEDICATED_RUNNER=1`.
+   */
+  readonly dedicatedRunner?: boolean;
+  /**
+   * The {@link SessionSource} to stamp on this channel's sessions when it runs
+   * dedicated (persisted into the meta sidecar; surfaces filter history by it).
+   * Only honored alongside `dedicatedRunner`. When unset, the source falls back
+   * to the usual env/default resolution.
+   */
+  readonly sessionSource?: SessionSource;
+  /**
+   * Declarative config the channel needs to run (its secret fields + where they
+   * live in the vault, plus pairing hints). This is what a control surface — the
+   * TUI `/channels` panel, `moxxy channels start`, the desktop "Channels" panel —
+   * renders to let the user configure + start the channel WITHOUT hardcoding a
+   * per-channel table. The channel self-describes here; the vault keys named are
+   * the same ones the channel actually reads at boot (its `keys.ts`). Channels
+   * with no setup (web/http) omit this.
+   */
+  readonly config?: ChannelConfigDescriptor;
+}
+
+/** One secret/config input a channel exposes for a control surface to collect. */
+export interface ChannelConfigField {
+  /** Option key (e.g. `botToken`). Stable identifier within the channel. */
+  readonly name: string;
+  /** Short human label (e.g. `Bot token`). */
+  readonly label: string;
+  /** The vault key the channel reads this value from (e.g. `slack_bot_token`). */
+  readonly vaultKey: string;
+  /** Must be present for the channel to count as "configured". */
+  readonly required?: boolean;
+  /** Treat as a secret — mask the input and never echo the stored value. */
+  readonly secret?: boolean;
+  /** Placeholder shown in an empty input (e.g. `xoxb-…`). */
+  readonly placeholder?: string;
+  /** One-line guidance on where to obtain the value. */
+  readonly help?: string;
+}
+
+/** What a channel declares about being configured + run from a control surface. */
+export interface ChannelConfigDescriptor {
+  /** The fields to collect, in display order. */
+  readonly fields: ReadonlyArray<ChannelConfigField>;
+  /** The channel exposes a public ingest URL (Slack's Request URL) once started,
+   *  so a control surface should poll for + surface it. */
+  readonly hasRequestUrl?: boolean;
+  /** Post-start pairing/setup instructions to show the user. */
+  readonly runHint?: string;
+  /** How a control surface should present the "now connect the other side" step
+   *  once the channel is running — declaratively, so each channel renders the
+   *  same way without per-channel UI code. See {@link ChannelConnectStep}. */
+  readonly connect?: ChannelConnectStep;
+}
+
+/**
+ * Declares how a control surface (TUI `/channels`, the desktop Channels panel)
+ * presents a channel's post-start "connect" step. The runtime VALUE this step
+ * renders is the channel's {@link Channel.requestUrl} (Slack's Request URL,
+ * Telegram's `t.me/<bot>` link); this descriptor only says how to render it, so
+ * a new channel plugs in by declaring a `kind` rather than shipping bespoke UI.
+ */
+export interface ChannelConnectStep {
+  /**
+   * Presentation of the channel's runtime connect value:
+   * - `qr`: render a QR of the value plus the value itself (e.g. scan/open a
+   *   `t.me/<bot>` link, or a mobile pairing URL).
+   * - `url`: show the value as a copyable URL the user pastes elsewhere
+   *   (Slack's Events Request URL).
+   * - `instructions`: static `steps`, no runtime value.
+   */
+  readonly kind: 'qr' | 'url' | 'instructions';
+  /** Heading for the step, e.g. "Connect your Telegram". */
+  readonly title?: string;
+  /** One-line helper under the value, e.g. "Scan, or open the link and send /start". */
+  readonly hint?: string;
+  /** When true and the value is an https URL the user should OPEN (not paste),
+   *  a control surface may show an "open externally" affordance. */
+  readonly openable?: boolean;
+  /** Label for the open affordance, e.g. "Open in Telegram". */
+  readonly openLabel?: string;
+  /** For `kind: 'instructions'` — static steps shown verbatim (no runtime value). */
+  readonly steps?: ReadonlyArray<string>;
 }
 
 export interface ChannelAvailability {

package/src/event-store.ts

@@ -13,7 +13,7 @@ import type { SessionId } from './ids.js';
  */
 
 /** Originating channel of a session (persisted into the meta sidecar). */
-export type SessionSource = 'cli' | 'tui' | 'desktop' | 'mobile';
+export type SessionSource = 'cli' | 'tui' | 'desktop' | 'mobile' | 'slack' | 'telegram';
 
 /**
  * The single per-session metadata record (the JSONL impl writes it to

package/src/index.ts

@@ -194,6 +194,7 @@ export type {
 // builtins and would break a browser/RN bundle. See ./server.ts.
 export { isRetryableError, toFriendlyError, zodToJsonSchema, estimateTextTokens, type StopReason } from './provider-utils.js';
 export type { WriteFileAtomicOptions } from './fs-utils.js';
+export type { ChannelRunStatus } from './channel-status.js';
 export type { CrossProcessFireLock, CrossProcessFireLockOptions } from './cross-process-lock.js';
 export { createMutex, type Mutex } from './mutex.js';
 export {
@@ -372,6 +373,9 @@ export type {
   ChannelStartOptsBase,
   ChannelFactoryDeps,
   ChannelDef,
+  ChannelConfigField,
+  ChannelConfigDescriptor,
+  ChannelConnectStep,
   ChannelAvailability,
   ChannelRegistry,
   ChannelSubcommand,

package/src/server.ts

@@ -25,6 +25,25 @@ export {
 // options type is re-exported from the main barrel like other erased types.
 export { CrossProcessFireLock } from './cross-process-lock.js';
 export { readRequestBody, bearerTokenMatches } from './http-utils.js';
+// Dedicated-channel run-status file: a channel publishes readiness + its public
+// ingest URL so the desktop "Channels" supervisor can observe it out-of-process
+// (node:fs). The `ChannelRunStatus` *type* rides the main barrel like the others.
+export {
+  channelStatusPath,
+  writeChannelStatus,
+  readChannelStatus,
+  clearChannelStatus,
+} from './channel-status.js';
+// Process-independent control of dedicated channel runners (start detached,
+// discover via status files, stop) — shared by the TUI `/channels` panel and the
+// `moxxy channels start|stop|status` subcommands (node:child_process + node:fs).
+export {
+  spawnDedicatedChannel,
+  isPidAlive,
+  liveChannelStatus,
+  listLiveChannelStatuses,
+  stopDedicatedChannel,
+} from './channel-control.js';
 export {
   resolveChannelToken,
   rotateChannelToken,