@kl-c/matrixos 0.2.0 → 0.2.1

package/dist/cli/adopt.d.ts

@@ -1,42 +1,32 @@
 /**
- * matrixos adopt [telegram]
+ * matrixos adopt — re-run the full MaTrixOS adoption wizard, or adopt a
+ * specific channel (e.g. telegram).
  *
- * Interactive adoption flow: asks the user for credentials, ingests them
- * via the same .klc-gateway.env file used by `gateway set-token`, and
- * validates the token against the platform API.
- *
- * Why a dedicated command and not just `gateway set-token`:
- * - `set-token` is the low-level "write one token" primitive
- * - `adopt` is the high-level "configure a channel end-to-end" UX
- *   (token + chat id + optional validation)
- * - `adopt` is what a user re-runs when they want to fix or migrate
- *   their setup
- *
- * The slash command `/adopt` in Telegram dispatches to this same flow
- * (see gateway-handler.ts).
- *
- * Token is NEVER hardcoded. Always prompted (masked) or read from --token.
+ * "adopt" is intentionally separate from the initial install: it lets an
+ * existing user reconfigure providers, channels, and profile without
+ * reinstalling from scratch.
  */
-export interface AdoptOptions {
-    readonly channel?: "telegram";
-    readonly envPath?: string;
-    readonly token?: string;
-    readonly allowedChatId?: string;
-    readonly nonInteractive?: boolean;
-    /** Mock the validator (for tests). Returns true if the token is valid. */
-    readonly validate?: (token: string) => Promise<boolean>;
+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 {
-    readonly ok: boolean;
-    readonly channel: string;
-    readonly tokenWritten: boolean;
-    readonly allowedChatId?: string;
-    readonly validated: boolean;
-    readonly message: string;
-    /** Never the actual token — only a boolean and a length. */
-    readonly tokenLength?: number;
+    ok: boolean;
+    channel?: AdoptChannel;
+    message: string;
+    tokenWritten?: boolean;
+    tokenLength?: number;
+    validated?: boolean;
+    allowedChatId?: string;
 }
-export declare function upsertEnvFile(path: string, updates: Record<string, string>): void;
-/** Default Telegram validator: hits getMe. Returns true on 200. */
-export declare function defaultTelegramValidate(token: string): Promise<boolean>;
-export declare function runAdopt(opts?: AdoptOptions): Promise<AdoptResult>;
+export declare function runChannelAdopt(channel: AdoptChannel, options?: RunAdoptOptions): Promise<AdoptResult>;
+export declare function runAdopt(options?: RunAdoptOptions): Promise<AdoptResult>;