@proletariat/cli 0.3.110 → 0.3.112

package/dist/commands/gateway/connect.d.ts

@@ -0,0 +1,33 @@
+/**
+ * prlt gateway connect — Register a messaging channel (PRLT-1255)
+ *
+ * MVP: only the telegram channel type is implemented. The command stores
+ * the bot token + allowlist in machine.db so `prlt gateway start` can
+ * bring the adapter up later.
+ *
+ * Examples:
+ *   prlt gateway connect telegram --token 123:abc --allow 111 --allow 222
+ *   prlt gateway connect telegram --token 123:abc --allow 111,222
+ */
+import { PromptCommand } from '../../lib/prompt-command.js';
+export default class GatewayConnect extends PromptCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        type: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        name: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        token: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        allow: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'poll-interval-ms': import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        machine: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+/**
+ * Accept `--allow 111 --allow 222` and `--allow 111,222` equally. Blank
+ * entries are stripped so users can't accidentally register an empty id.
+ */
+export declare function parseAllowlist(raw: string[] | undefined): string[];

package/dist/commands/gateway/connect.js

@@ -0,0 +1,130 @@
+/**
+ * prlt gateway connect — Register a messaging channel (PRLT-1255)
+ *
+ * MVP: only the telegram channel type is implemented. The command stores
+ * the bot token + allowlist in machine.db so `prlt gateway start` can
+ * bring the adapter up later.
+ *
+ * Examples:
+ *   prlt gateway connect telegram --token 123:abc --allow 111 --allow 222
+ *   prlt gateway connect telegram --token 123:abc --allow 111,222
+ */
+import { Args, Flags } from '@oclif/core';
+import { PromptCommand } from '../../lib/prompt-command.js';
+import { machineOutputFlags } from '../../lib/pmo/index.js';
+import { shouldOutputJson, outputErrorAsJson, outputSuccessAsJson, createMetadata, } from '../../lib/prompt-json.js';
+import { styles } from '../../lib/styles.js';
+import { MachineDB } from '../../lib/machine-db.js';
+const SUPPORTED_CHANNEL_TYPES = ['telegram'];
+export default class GatewayConnect extends PromptCommand {
+    static description = 'Register a messaging channel (Telegram) with the gateway';
+    static examples = [
+        '<%= config.bin %> gateway connect telegram --token 123:abc --allow 111 --allow 222',
+        '<%= config.bin %> gateway connect telegram --token 123:abc --allow 111,222 --name my-bot',
+    ];
+    static args = {
+        type: Args.string({
+            description: 'Channel type',
+            required: true,
+            options: [...SUPPORTED_CHANNEL_TYPES],
+        }),
+    };
+    static flags = {
+        ...machineOutputFlags,
+        name: Flags.string({
+            description: 'Channel name (primary key). Defaults to the channel type.',
+        }),
+        token: Flags.string({
+            description: 'Telegram bot token from @BotFather',
+        }),
+        allow: Flags.string({
+            description: 'Telegram user id(s) allowed to message agents (repeatable, or comma-separated)',
+            multiple: true,
+        }),
+        'poll-interval-ms': Flags.integer({
+            description: 'Delay between getUpdates polls (0 uses Telegram long-poll)',
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(GatewayConnect);
+        const jsonMode = shouldOutputJson(flags);
+        const channelType = args.type;
+        const channelName = flags.name || channelType;
+        if (channelType === 'telegram') {
+            if (!flags.token) {
+                if (jsonMode) {
+                    outputErrorAsJson('MISSING_TOKEN', 'Telegram requires --token', createMetadata('gateway connect', flags));
+                    return;
+                }
+                this.log(styles.error('Telegram requires --token'));
+                return;
+            }
+            const allowlist = parseAllowlist(flags.allow);
+            if (allowlist.length === 0) {
+                if (jsonMode) {
+                    outputErrorAsJson('MISSING_ALLOWLIST', 'Telegram requires --allow <user-id> (at least one)', createMetadata('gateway connect', flags));
+                    return;
+                }
+                this.log(styles.error('Telegram requires --allow <user-id> (at least one)'));
+                return;
+            }
+            const config = {
+                token: flags.token,
+                allowlist,
+                ...(flags['poll-interval-ms'] !== undefined ? { pollIntervalMs: flags['poll-interval-ms'] } : {}),
+            };
+            const db = new MachineDB();
+            try {
+                db.upsertMessagingChannel({
+                    name: channelName,
+                    type: 'telegram',
+                    configJson: JSON.stringify(config),
+                    active: true,
+                });
+            }
+            finally {
+                db.close();
+            }
+            if (jsonMode) {
+                outputSuccessAsJson({
+                    channel: {
+                        name: channelName,
+                        type: 'telegram',
+                        allowlist,
+                        active: true,
+                    },
+                }, createMetadata('gateway connect', flags));
+                return;
+            }
+            this.log(styles.success(`Connected telegram channel "${channelName}"`));
+            this.log(styles.muted(`  Allowlist: ${allowlist.join(', ')}`));
+            this.log(styles.muted(`  Start the gateway with: prlt gateway start`));
+            return;
+        }
+        // Unreachable under current oclif `options` constraint, but we keep
+        // it so future channel types slot in cleanly.
+        if (jsonMode) {
+            outputErrorAsJson('UNSUPPORTED_CHANNEL', `Channel type "${channelType}" is not implemented yet`, createMetadata('gateway connect', flags));
+            return;
+        }
+        this.log(styles.error(`Channel type "${channelType}" is not implemented yet`));
+    }
+}
+/**
+ * Accept `--allow 111 --allow 222` and `--allow 111,222` equally. Blank
+ * entries are stripped so users can't accidentally register an empty id.
+ */
+export function parseAllowlist(raw) {
+    if (!raw)
+        return [];
+    const out = [];
+    for (const entry of raw) {
+        for (const piece of entry.split(',')) {
+            const trimmed = piece.trim();
+            if (trimmed)
+                out.push(trimmed);
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=connect.js.map

package/dist/commands/gateway/connect.js.map

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

package/dist/commands/gateway/disconnect.d.ts

@@ -0,0 +1,21 @@
+/**
+ * prlt gateway disconnect — Remove or deactivate a messaging channel.
+ *
+ * By default, this deletes the channel registration outright. Pass
+ * --deactivate to keep the row around (and its stored credentials) but
+ * mark it inactive so `prlt gateway start` skips it.
+ */
+import { PromptCommand } from '../../lib/prompt-command.js';
+export default class GatewayDisconnect extends PromptCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        name: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        deactivate: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        machine: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/gateway/disconnect.js

@@ -0,0 +1,69 @@
+/**
+ * prlt gateway disconnect — Remove or deactivate a messaging channel.
+ *
+ * By default, this deletes the channel registration outright. Pass
+ * --deactivate to keep the row around (and its stored credentials) but
+ * mark it inactive so `prlt gateway start` skips it.
+ */
+import { Args, Flags } from '@oclif/core';
+import { PromptCommand } from '../../lib/prompt-command.js';
+import { machineOutputFlags } from '../../lib/pmo/index.js';
+import { shouldOutputJson, outputErrorAsJson, outputSuccessAsJson, createMetadata, } from '../../lib/prompt-json.js';
+import { styles } from '../../lib/styles.js';
+import { MachineDB } from '../../lib/machine-db.js';
+export default class GatewayDisconnect extends PromptCommand {
+    static description = 'Disconnect a registered messaging channel';
+    static examples = [
+        '<%= config.bin %> gateway disconnect telegram',
+        '<%= config.bin %> gateway disconnect telegram --deactivate',
+    ];
+    static args = {
+        name: Args.string({
+            description: 'Channel name (as registered with `gateway connect`)',
+            required: true,
+        }),
+    };
+    static flags = {
+        ...machineOutputFlags,
+        deactivate: Flags.boolean({
+            description: 'Mark the channel inactive instead of deleting it',
+            default: false,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(GatewayDisconnect);
+        const jsonMode = shouldOutputJson(flags);
+        const db = new MachineDB();
+        try {
+            const existing = db.getMessagingChannel(args.name);
+            if (!existing) {
+                if (jsonMode) {
+                    outputErrorAsJson('CHANNEL_NOT_FOUND', `No channel registered with name "${args.name}"`, createMetadata('gateway disconnect', flags));
+                    return;
+                }
+                this.log(styles.error(`No channel registered with name "${args.name}"`));
+                return;
+            }
+            if (flags.deactivate) {
+                db.setMessagingChannelActive(args.name, false);
+            }
+            else {
+                db.deleteMessagingChannel(args.name);
+            }
+            if (jsonMode) {
+                outputSuccessAsJson({
+                    channel: args.name,
+                    action: flags.deactivate ? 'deactivated' : 'deleted',
+                }, createMetadata('gateway disconnect', flags));
+                return;
+            }
+            this.log(styles.success(flags.deactivate
+                ? `Deactivated channel "${args.name}"`
+                : `Removed channel "${args.name}"`));
+        }
+        finally {
+            db.close();
+        }
+    }
+}
+//# sourceMappingURL=disconnect.js.map

package/dist/commands/gateway/disconnect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"disconnect.js","sourceRoot":"","sources":["../../../src/commands/gateway/disconnect.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAC3D,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,GACf,MAAM,0BAA0B,CAAA;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAEnD,MAAM,CAAC,OAAO,OAAO,iBAAkB,SAAQ,aAAa;IAC1D,MAAM,CAAC,WAAW,GAAG,2CAA2C,CAAA;IAEhE,MAAM,CAAC,QAAQ,GAAG;QAChB,+CAA+C;QAC/C,4DAA4D;KAC7D,CAAA;IAED,MAAM,CAAC,IAAI,GAAG;QACZ,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC;YAChB,WAAW,EAAE,qDAAqD;YAClE,QAAQ,EAAE,IAAI;SACf,CAAC;KACH,CAAA;IAED,MAAM,CAAC,KAAK,GAAG;QACb,GAAG,kBAAkB;QACrB,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC;YACxB,WAAW,EAAE,kDAAkD;YAC/D,OAAO,EAAE,KAAK;SACf,CAAC;KACH,CAAA;IAED,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAA;QAC3D,MAAM,QAAQ,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAA;QAExC,MAAM,EAAE,GAAG,IAAI,SAAS,EAAE,CAAA;QAC1B,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YAClD,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,IAAI,QAAQ,EAAE,CAAC;oBACb,iBAAiB,CACf,mBAAmB,EACnB,oCAAoC,IAAI,CAAC,IAAI,GAAG,EAChD,cAAc,CAAC,oBAAoB,EAAE,KAAK,CAAC,CAC5C,CAAA;oBACD,OAAM;gBACR,CAAC;gBACD,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,oCAAoC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAA;gBACxE,OAAM;YACR,CAAC;YAED,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;gBACrB,EAAE,CAAC,yBAAyB,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;YAChD,CAAC;iBAAM,CAAC;gBACN,EAAE,CAAC,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACtC,CAAC;YAED,IAAI,QAAQ,EAAE,CAAC;gBACb,mBAAmB,CACjB;oBACE,OAAO,EAAE,IAAI,CAAC,IAAI;oBAClB,MAAM,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS;iBACrD,EACD,cAAc,CAAC,oBAAoB,EAAE,KAAK,CAAC,CAC5C,CAAA;gBACD,OAAM;YACR,CAAC;YAED,IAAI,CAAC,GAAG,CACN,MAAM,CAAC,OAAO,CACZ,KAAK,CAAC,UAAU;gBACd,CAAC,CAAC,wBAAwB,IAAI,CAAC,IAAI,GAAG;gBACtC,CAAC,CAAC,oBAAoB,IAAI,CAAC,IAAI,GAAG,CACrC,CACF,CAAA;QACH,CAAC;gBAAS,CAAC;YACT,EAAE,CAAC,KAAK,EAAE,CAAA;QACZ,CAAC;IACH,CAAC"}

package/dist/commands/gateway/start.d.ts

@@ -0,0 +1,23 @@
+/**
+ * prlt gateway start — Start the messaging gateway daemon.
+ *
+ * Loads every active channel from machine.db, wires it up to the
+ * MessagingGateway router, and blocks until SIGINT/SIGTERM. Each inbound
+ * message is forwarded to its bound agent via `prlt session poke`.
+ *
+ * MVP note: this runs in the foreground. `--background` is documented on
+ * the ticket but intentionally deferred — it will land alongside the
+ * generic daemon lifecycle work in a follow-up ticket.
+ */
+import { PromptCommand } from '../../lib/prompt-command.js';
+export default class GatewayStart extends PromptCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        'default-agent': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'wait-timeout': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        machine: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/gateway/start.js

@@ -0,0 +1,133 @@
+/**
+ * prlt gateway start — Start the messaging gateway daemon.
+ *
+ * Loads every active channel from machine.db, wires it up to the
+ * MessagingGateway router, and blocks until SIGINT/SIGTERM. Each inbound
+ * message is forwarded to its bound agent via `prlt session poke`.
+ *
+ * MVP note: this runs in the foreground. `--background` is documented on
+ * the ticket but intentionally deferred — it will land alongside the
+ * generic daemon lifecycle work in a follow-up ticket.
+ */
+import { Flags } from '@oclif/core';
+import { PromptCommand } from '../../lib/prompt-command.js';
+import { machineOutputFlags } from '../../lib/pmo/index.js';
+import { shouldOutputJson, outputSuccessAsJson, outputErrorAsJson, createMetadata, } from '../../lib/prompt-json.js';
+import { styles } from '../../lib/styles.js';
+import { MachineDB } from '../../lib/machine-db.js';
+import { MessagingGateway } from '../../lib/gateway/router.js';
+import { ShellSessionPoker } from '../../lib/gateway/session-poker.js';
+import { buildChannelFromRecord } from '../../lib/gateway/channel-factory.js';
+export default class GatewayStart extends PromptCommand {
+    static description = 'Start the messaging gateway daemon (foreground)';
+    static examples = [
+        '<%= config.bin %> gateway start',
+        '<%= config.bin %> gateway start --default-agent altman',
+    ];
+    static flags = {
+        ...machineOutputFlags,
+        'default-agent': Flags.string({
+            description: 'Agent session id to bind newly-seen users to (required unless a static resolver is configured)',
+        }),
+        'wait-timeout': Flags.integer({
+            description: 'Max seconds to wait for an agent response before giving up',
+            default: 90,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(GatewayStart);
+        const jsonMode = shouldOutputJson(flags);
+        const db = new MachineDB();
+        // Load active channels at startup. A future revision can hot-reload
+        // this by watching the table for changes, but the MVP only reads at
+        // start time.
+        const records = db.listMessagingChannels({ onlyActive: true });
+        if (records.length === 0) {
+            db.close();
+            if (jsonMode) {
+                outputErrorAsJson('NO_CHANNELS', 'No active messaging channels registered. Connect one first with `prlt gateway connect`.', createMetadata('gateway start', flags));
+                return;
+            }
+            this.log(styles.error('No active messaging channels registered.'));
+            this.log(styles.muted('Connect one with: prlt gateway connect telegram --token ... --allow ...'));
+            return;
+        }
+        const gateway = new MessagingGateway({
+            db,
+            sessionPoker: new ShellSessionPoker(),
+            waitTimeoutSec: flags['wait-timeout'],
+            resolveAgentForNewUser: (_msg) => flags['default-agent'] ?? null,
+            logger: {
+                info: msg => this.log(styles.muted(msg)),
+                error: (msg, err) => {
+                    const errMsg = err instanceof Error ? err.message : err !== undefined ? String(err) : '';
+                    this.log(styles.error(errMsg ? `${msg}: ${errMsg}` : msg));
+                },
+            },
+        });
+        for (const record of records) {
+            try {
+                const channel = buildChannelFromRecord(record);
+                gateway.registerChannel(channel);
+            }
+            catch (err) {
+                const errMsg = err instanceof Error ? err.message : String(err);
+                this.log(styles.error(`Failed to build channel "${record.name}": ${errMsg}`));
+            }
+        }
+        if (gateway.listChannelNames().length === 0) {
+            db.close();
+            if (jsonMode) {
+                outputErrorAsJson('NO_VALID_CHANNELS', 'No valid messaging channels could be built from storage.', createMetadata('gateway start', flags));
+                return;
+            }
+            this.log(styles.error('No valid messaging channels could be built from storage.'));
+            return;
+        }
+        await gateway.start();
+        if (jsonMode) {
+            outputSuccessAsJson({
+                started: true,
+                channels: gateway.listChannelNames(),
+                defaultAgent: flags['default-agent'] ?? null,
+            }, createMetadata('gateway start', flags));
+        }
+        else {
+            this.log(styles.success('Messaging gateway started'));
+            this.log(styles.muted(`  channels: ${gateway.listChannelNames().join(', ')}`));
+            if (flags['default-agent']) {
+                this.log(styles.muted(`  default agent: ${flags['default-agent']}`));
+            }
+            else {
+                this.log(styles.warning('  no --default-agent: new users will be rejected'));
+            }
+            this.log(styles.muted('  press Ctrl-C to stop'));
+        }
+        // Block until we're asked to shut down. We install handlers for both
+        // SIGINT and SIGTERM so `docker stop` and Ctrl-C both unwind cleanly.
+        await waitForShutdownSignal();
+        this.log(styles.muted('Shutting down gateway...'));
+        try {
+            await gateway.stop();
+        }
+        finally {
+            db.close();
+        }
+    }
+}
+/**
+ * Resolve when we receive SIGINT or SIGTERM. Exported-less so tests don't
+ * have to shim it — the test suite exercises `MessagingGateway` directly.
+ */
+function waitForShutdownSignal() {
+    return new Promise(resolve => {
+        const onSignal = () => {
+            process.off('SIGINT', onSignal);
+            process.off('SIGTERM', onSignal);
+            resolve();
+        };
+        process.on('SIGINT', onSignal);
+        process.on('SIGTERM', onSignal);
+    });
+}
+//# sourceMappingURL=start.js.map

package/dist/commands/gateway/start.js.map

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

package/dist/commands/gateway/status.d.ts

@@ -0,0 +1,16 @@
+/**
+ * prlt gateway status — Show registered messaging channels and routes.
+ *
+ * Reports one line per channel with its type, active flag, last
+ * activity timestamp, and the number of user→agent routes it owns.
+ */
+import { PromptCommand } from '../../lib/prompt-command.js';
+export default class GatewayStatus extends PromptCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        machine: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/gateway/status.js

@@ -0,0 +1,76 @@
+/**
+ * prlt gateway status — Show registered messaging channels and routes.
+ *
+ * Reports one line per channel with its type, active flag, last
+ * activity timestamp, and the number of user→agent routes it owns.
+ */
+import { PromptCommand } from '../../lib/prompt-command.js';
+import { machineOutputFlags } from '../../lib/pmo/index.js';
+import { shouldOutputJson, outputSuccessAsJson, createMetadata, } from '../../lib/prompt-json.js';
+import { styles } from '../../lib/styles.js';
+import { MachineDB } from '../../lib/machine-db.js';
+export default class GatewayStatus extends PromptCommand {
+    static description = 'Show registered messaging channels and their activity';
+    static examples = ['<%= config.bin %> gateway status'];
+    static flags = {
+        ...machineOutputFlags,
+    };
+    async run() {
+        const { flags } = await this.parse(GatewayStatus);
+        const jsonMode = shouldOutputJson(flags);
+        const db = new MachineDB();
+        let statuses = [];
+        try {
+            const channels = db.listMessagingChannels({ onlyActive: false });
+            statuses = channels.map(ch => buildStatus(db, ch));
+        }
+        finally {
+            db.close();
+        }
+        if (jsonMode) {
+            outputSuccessAsJson({ channels: statuses }, createMetadata('gateway status', flags));
+            return;
+        }
+        if (statuses.length === 0) {
+            this.log(styles.muted('No messaging channels registered.'));
+            this.log(styles.muted('Connect one with: prlt gateway connect telegram --token ... --allow ...'));
+            return;
+        }
+        this.log(styles.header('Messaging Gateway Channels'));
+        this.log('');
+        for (const s of statuses) {
+            const active = s.active ? styles.success('active') : styles.muted('inactive');
+            const last = s.lastMessageAt ? formatRelative(new Date(s.lastMessageAt)) : 'never';
+            this.log(`  ${styles.emphasis(s.name)} [${s.type}] — ${active}`);
+            this.log(`    last activity: ${last}`);
+            this.log(`    routes: ${s.routeCount}`);
+            this.log('');
+        }
+    }
+}
+function buildStatus(db, ch) {
+    return {
+        name: ch.name,
+        type: ch.type,
+        active: ch.active,
+        lastMessageAt: ch.lastMessageAt ? ch.lastMessageAt.toISOString() : null,
+        routeCount: db.countMessagingRoutesForChannel(ch.name),
+    };
+}
+function formatRelative(d) {
+    const deltaMs = Date.now() - d.getTime();
+    if (deltaMs < 0)
+        return d.toISOString();
+    const seconds = Math.floor(deltaMs / 1000);
+    if (seconds < 60)
+        return `${seconds}s ago`;
+    const minutes = Math.floor(seconds / 60);
+    if (minutes < 60)
+        return `${minutes}m ago`;
+    const hours = Math.floor(minutes / 60);
+    if (hours < 48)
+        return `${hours}h ago`;
+    const days = Math.floor(hours / 24);
+    return `${days}d ago`;
+}
+//# sourceMappingURL=status.js.map

package/dist/commands/gateway/status.js.map

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

package/dist/commands/gateway/test.d.ts

@@ -0,0 +1,22 @@
+/**
+ * prlt gateway test — Send a test message through a registered channel.
+ *
+ * Loads a channel's config from machine.db, instantiates the adapter,
+ * and calls `sendMessage` directly. This doesn't start the polling loop,
+ * so it's safe to run alongside a live `gateway start`.
+ */
+import { PromptCommand } from '../../lib/prompt-command.js';
+export default class GatewayTest extends PromptCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        name: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        to: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        message: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        machine: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/gateway/test.js

@@ -0,0 +1,83 @@
+/**
+ * prlt gateway test — Send a test message through a registered channel.
+ *
+ * Loads a channel's config from machine.db, instantiates the adapter,
+ * and calls `sendMessage` directly. This doesn't start the polling loop,
+ * so it's safe to run alongside a live `gateway start`.
+ */
+import { Args, Flags } from '@oclif/core';
+import { PromptCommand } from '../../lib/prompt-command.js';
+import { machineOutputFlags } from '../../lib/pmo/index.js';
+import { shouldOutputJson, outputErrorAsJson, outputSuccessAsJson, createMetadata, } from '../../lib/prompt-json.js';
+import { styles } from '../../lib/styles.js';
+import { MachineDB } from '../../lib/machine-db.js';
+import { buildChannelFromRecord } from '../../lib/gateway/channel-factory.js';
+export default class GatewayTest extends PromptCommand {
+    static description = 'Send a test message through a registered messaging channel';
+    static examples = [
+        '<%= config.bin %> gateway test telegram --to 123456789 --message "hello from prlt"',
+    ];
+    static args = {
+        name: Args.string({
+            description: 'Channel name (as registered with `gateway connect`)',
+            required: true,
+        }),
+    };
+    static flags = {
+        ...machineOutputFlags,
+        to: Flags.string({
+            description: 'Recipient id on the channel (e.g. Telegram chat id)',
+            required: true,
+        }),
+        message: Flags.string({
+            description: 'Text to send',
+            default: 'hello from prlt',
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(GatewayTest);
+        const jsonMode = shouldOutputJson(flags);
+        const db = new MachineDB();
+        const record = db.getMessagingChannel(args.name);
+        db.close();
+        if (!record) {
+            if (jsonMode) {
+                outputErrorAsJson('CHANNEL_NOT_FOUND', `No channel registered with name "${args.name}"`, createMetadata('gateway test', flags));
+                return;
+            }
+            this.log(styles.error(`No channel registered with name "${args.name}"`));
+            return;
+        }
+        let channel;
+        try {
+            channel = buildChannelFromRecord(record);
+        }
+        catch (err) {
+            const errMsg = err instanceof Error ? err.message : String(err);
+            if (jsonMode) {
+                outputErrorAsJson('CHANNEL_BUILD_FAILED', errMsg, createMetadata('gateway test', flags));
+                return;
+            }
+            this.log(styles.error(errMsg));
+            return;
+        }
+        try {
+            await channel.sendMessage({ channel: channel.name, id: flags.to }, flags.message);
+        }
+        catch (err) {
+            const errMsg = err instanceof Error ? err.message : String(err);
+            if (jsonMode) {
+                outputErrorAsJson('SEND_FAILED', errMsg, createMetadata('gateway test', flags));
+                return;
+            }
+            this.log(styles.error(`Failed to send: ${errMsg}`));
+            return;
+        }
+        if (jsonMode) {
+            outputSuccessAsJson({ channel: args.name, to: flags.to, message: flags.message }, createMetadata('gateway test', flags));
+            return;
+        }
+        this.log(styles.success(`Sent test message via "${args.name}" to ${flags.to}`));
+    }
+}
+//# sourceMappingURL=test.js.map

package/dist/commands/gateway/test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.js","sourceRoot":"","sources":["../../../src/commands/gateway/test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAC3D,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,GACf,MAAM,0BAA0B,CAAA;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAA;AAE7E,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,aAAa;IACpD,MAAM,CAAC,WAAW,GAAG,4DAA4D,CAAA;IAEjF,MAAM,CAAC,QAAQ,GAAG;QAChB,oFAAoF;KACrF,CAAA;IAED,MAAM,CAAC,IAAI,GAAG;QACZ,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC;YAChB,WAAW,EAAE,qDAAqD;YAClE,QAAQ,EAAE,IAAI;SACf,CAAC;KACH,CAAA;IAED,MAAM,CAAC,KAAK,GAAG;QACb,GAAG,kBAAkB;QACrB,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC;YACf,WAAW,EAAE,qDAAqD;YAClE,QAAQ,EAAE,IAAI;SACf,CAAC;QACF,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC;YACpB,WAAW,EAAE,cAAc;YAC3B,OAAO,EAAE,iBAAiB;SAC3B,CAAC;KACH,CAAA;IAED,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAA;QACrD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAA;QAExC,MAAM,EAAE,GAAG,IAAI,SAAS,EAAE,CAAA;QAC1B,MAAM,MAAM,GAAG,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAChD,EAAE,CAAC,KAAK,EAAE,CAAA;QAEV,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,IAAI,QAAQ,EAAE,CAAC;gBACb,iBAAiB,CACf,mBAAmB,EACnB,oCAAoC,IAAI,CAAC,IAAI,GAAG,EAChD,cAAc,CAAC,cAAc,EAAE,KAAK,CAAC,CACtC,CAAA;gBACD,OAAM;YACR,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,oCAAoC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAA;YACxE,OAAM;QACR,CAAC;QAED,IAAI,OAAO,CAAA;QACX,IAAI,CAAC;YACH,OAAO,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAA;QAC1C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,MAAM,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;YAC/D,IAAI,QAAQ,EAAE,CAAC;gBACb,iBAAiB,CACf,sBAAsB,EACtB,MAAM,EACN,cAAc,CAAC,cAAc,EAAE,KAAK,CAAC,CACtC,CAAA;gBACD,OAAM;YACR,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAA;YAC9B,OAAM;QACR,CAAC;QAED,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,WAAW,CACvB,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,EACvC,KAAK,CAAC,OAAO,CACd,CAAA;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,MAAM,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;YAC/D,IAAI,QAAQ,EAAE,CAAC;gBACb,iBAAiB,CACf,aAAa,EACb,MAAM,EACN,cAAc,CAAC,cAAc,EAAE,KAAK,CAAC,CACtC,CAAA;gBACD,OAAM;YACR,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,mBAAmB,MAAM,EAAE,CAAC,CAAC,CAAA;YACnD,OAAM;QACR,CAAC;QAED,IAAI,QAAQ,EAAE,CAAC;YACb,mBAAmB,CACjB,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,EAC5D,cAAc,CAAC,cAAc,EAAE,KAAK,CAAC,CACtC,CAAA;YACD,OAAM;QACR,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,0BAA0B,IAAI,CAAC,IAAI,QAAQ,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,CAAA;IACjF,CAAC"}