@kl-c/matrixos 0.1.49 → 0.2.1

package/dist/cli/adopt.d.ts

@@ -0,0 +1,32 @@
+/**
+ * matrixos adopt — re-run the full MaTrixOS adoption wizard, or adopt a
+ * specific channel (e.g. telegram).
+ *
+ * "adopt" is intentionally separate from the initial install: it lets an
+ * existing user reconfigure providers, channels, and profile without
+ * reinstalling from scratch.
+ */
+export type AdoptChannel = "telegram";
+export interface RunAdoptOptions {
+    /** If set, only adopt this channel instead of running the full wizard. */
+    channel?: AdoptChannel;
+    /** Pre-supplied token for non-interactive channel adoption. */
+    token?: string;
+    /** Restrict gateway to a single chat id. */
+    allowedChatId?: string;
+    /** Skip interactive prompts (requires token for channel adoption). */
+    nonInteractive?: boolean;
+    /** For tests: validate the token via Telegram getMe. */
+    validate?: () => Promise<boolean>;
+}
+export interface AdoptResult {
+    ok: boolean;
+    channel?: AdoptChannel;
+    message: string;
+    tokenWritten?: boolean;
+    tokenLength?: number;
+    validated?: boolean;
+    allowedChatId?: string;
+}
+export declare function runChannelAdopt(channel: AdoptChannel, options?: RunAdoptOptions): Promise<AdoptResult>;
+export declare function runAdopt(options?: RunAdoptOptions): Promise<AdoptResult>;

package/dist/cli/gateway-start.d.ts

@@ -0,0 +1,39 @@
+/**
+ * matrixos gateway start [telegram]
+ *
+ * Boots the MaTrixOS gateway: loads `.klc-gateway.env`, builds a
+ * GatewayConfig, instantiates the requested channel adapter, registers it
+ * with the MatrixGateway, sets a message handler that shells out to
+ * `matrixos run`, and starts long-polling.
+ *
+ * Token handling: the token is read from `.klc-gateway.env` (chmod 600)
+ * via `loadGatewayEnv()`. NEVER hardcoded. Set it with
+ * `matrixos gateway set-token telegram --token "<token>"` or
+ * `matrixos gateway set-token telegram -i` (masked interactive prompt).
+ *
+ * The file `.klc-gateway.env` is gitignored (created by `set-token`).
+ */
+import { MatrixGateway, TelegramAdapter, type GatewayConfig, type TelegramChannelConfig } from "@matrixos/matrix-gateway-core";
+export interface GatewayStartOptions {
+    readonly channel?: "telegram" | "discord";
+    readonly envPath?: string;
+    readonly command?: string;
+    readonly args?: string[];
+    readonly timeoutMs?: number;
+    /** Mock-friendly: inject a built gateway instead of constructing one. */
+    readonly gatewayFactory?: (config: GatewayConfig) => MatrixGateway;
+    readonly adapterFactory?: (config: TelegramChannelConfig) => TelegramAdapter;
+}
+export interface GatewayStartResult {
+    readonly ok: boolean;
+    readonly channel: string;
+    readonly pid: number;
+    readonly envLoaded: boolean;
+    readonly tokenPresent: boolean;
+    readonly message: string;
+}
+/** Parse a .klc-gateway.env file (KEY=value, no shell quoting) without dotenv dep. */
+export declare function loadGatewayEnv(path?: string): Record<string, string>;
+export declare function buildTelegramConfig(env: Record<string, string>): TelegramChannelConfig;
+export declare function buildGatewayConfig(channel: TelegramChannelConfig): GatewayConfig;
+export declare function runGatewayStart(opts?: GatewayStartOptions): Promise<GatewayStartResult>;