@gajae-gateway/cli 0.1.8 → 0.2.1

package/dist/discord-setup.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Discord setup helpers: guided bot token acquisition and invite URL generation.
+ */
+/**
+ * Discord OAuth2 scopes needed for the adapter.
+ * `bot` allows the bot to join servers.
+ * `applications.commands` allows slash commands (future feature).
+ */
+export declare const DISCORD_BOT_SCOPES: string[];
+/**
+ * Discord permissions needed for the bot to function.
+ * Calculated as the bitwise OR of individual permission bits.
+ *
+ * - SEND_MESSAGES (2048): Send messages in channels
+ * - EMBED_LINKS (16384): Embed links in messages
+ * - ATTACH_FILES (33554432): Attach files to messages
+ * - READ_MESSAGE_HISTORY (65536): Read past messages
+ * - MENTION_EVERYONE (131072): Mention @everyone, @here
+ * - MANAGE_MESSAGES (8192): Manage messages (delete, etc.)
+ * - ADD_REACTIONS (64): React to messages
+ */
+export declare const DISCORD_BOT_PERMISSIONS: number;
+/**
+ * Prints step-by-step guidance for getting a Discord bot token.
+ * Called before asking the user to paste the token.
+ */
+export declare function printDiscordSetupGuide(log: (line: string) => void): void;
+/**
+ * Generates an OAuth2 invite URL for the Discord bot.
+ * The URL allows server owners to authorize the bot with the required permissions.
+ *
+ * @param appId - The Discord application ID (obtained from the API)
+ * @returns A clickable invite URL
+ */
+export declare function generateDiscordInviteUrl(appId: string): string;
+/**
+ * Formats the Discord bot setup success message with the invite URL.
+ * Includes clear instructions for the user to authorize the bot in their server.
+ */
+export declare function printDiscordBotReady(log: (line: string) => void, appId: string, botName?: string): void;
+//# sourceMappingURL=discord-setup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"discord-setup.d.ts","sourceRoot":"","sources":["../src/discord-setup.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,UAAmC,CAAC;AAEnE;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,uBAAuB,QAAuD,CAAC;AAE5F;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CA0BxE;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAI9D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CA0BvG"}

package/dist/gjc-install.d.ts

@@ -0,0 +1,13 @@
+export interface GjcInstallRunResult {
+    readonly exitCode: number;
+    readonly stdout: string;
+    readonly stderr: string;
+}
+export type GjcInstallRunner = (command: readonly string[], cwd: string) => Promise<GjcInstallRunResult>;
+/** Install the gateway-pinned gjc into its versioned private prefix. */
+export declare function installPinnedGjc(options: {
+    readonly home: string;
+    readonly version: string;
+    readonly runner?: GjcInstallRunner;
+}): Promise<string>;
+//# sourceMappingURL=gjc-install.d.ts.map

package/dist/gjc-install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gjc-install.d.ts","sourceRoot":"","sources":["../src/gjc-install.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAgEzG,wEAAwE;AACxE,wBAAsB,gBAAgB,CAAC,OAAO,EAAE;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC;CACnC,GAAG,OAAO,CAAC,MAAM,CAAC,CAuDlB"}

package/dist/main.d.ts

@@ -1,5 +1,6 @@
 #!/usr/bin/env bun
-import type { OpsCycleResult } from "@gajae-gateway/protocol";
+import type { OpsCycleResult, OpsDeliveriesResult, OpsSloResult } from "@gajae-gateway/protocol";
+import { GajaewayClient } from "@gajae-gateway/sdk";
 import { type LaunchRestartOptions, type RunRestartOptions } from "./restart-stack";
 import { type InstallServicesOptions, type ServicePlatform } from "./services";
 import { type RunSetupOptions } from "./setup";
@@ -12,7 +13,7 @@ export declare function socketPath(home?: string | undefined): string;
  * never after, so the list is checked up front.
  */
 export declare const COMMANDS: readonly ["status", "shutdown", "chat", "daemon", "sessions", "ops", "memory", "monitors", "work", "services", "migrate", "update", "setup"];
-export declare const CLI_USAGE = "usage: gajaeway [--socket PATH] status|shutdown|chat|daemon run|sessions list [--json] [--fields a,b,c] [--limit N] [--offset N]|sessions inspect <originKey-or-index>|memory audit|memory search <query>|monitors ... (test <id> [--type T] [--payload J] [--wait[=SECONDS]])|work run|start <name> [--cwd DIR] [--resume] [--model ID|--preset NAME] [--notify originKey (start only)] <text>|work status <name>|work steer <name> <text>|work retire [--force] <name>|work retire --all-dead|work jobs|ops backup <path>|ops redeliver <deliveryId>|ops redeliver --since <iso>|ops cycle [--json]|ops integrity|ops restore <backupPath>|ops restart-stack [--status]|services install|repair --bin-dir DIR [--launch-agents-dir DIR] [--unit-dir DIR] [--platform darwin|linux]|migrate [--source PATH] [--target PATH] [--dry-run]|update [--check] [--force] [--bin-dir DIR] [--no-restart]|setup [--from-env] [--adapters discord,slack,telegram] [--owner ID] [--discord-app-id ID]|setup --status (work run waits for a response; caller timeout does not end the attempt); cron timezone is an IANA zone and defaults to the gateway host's local timezone";
+export declare const CLI_USAGE = "usage: gajaeway [--version] [--socket PATH] status|shutdown|chat|daemon run|sessions list [--json] [--fields a,b,c] [--limit N] [--offset N]|sessions inspect <originKey-or-index>|memory audit|memory search <query>|monitors ... (settle <eventId>|retry <eventId>|test <id> [--type T] [--payload J] [--wait[=SECONDS]])|work run|start <name> [--cwd DIR] [--resume] [--model ID|--preset NAME] [--notify originKey (start only)] <text>|work status <name>|work steer <name> <text>|work retire [--force] <name>|work retire --all-dead|work jobs [--limit N] [--offset N]|ops backup <path>|ops deliveries [--since ISO] [--state S] [--limit N] [--json]|ops redeliver <deliveryId>|ops redeliver --since <iso>|ops cycle [--json]|ops integrity|ops restart-stack [--status]|services install|repair --bin-dir DIR [--launch-agents-dir DIR] [--unit-dir DIR] [--platform darwin|linux]|migrate [--source PATH] [--target PATH] [--dry-run]|update [--check] [--force] [--bin-dir DIR] [--no-restart]|setup [--from-env] [--adapters discord,slack,telegram] [--owner ID] [--discord-app-id ID]|setup --status|setup --broker-agent [--from DIR] (work run waits for a response; caller timeout does not end the attempt); cron timezone is an IANA zone and defaults to the gateway host's local timezone";
 /** Usage errors exit 2, as `gajaeway-gateway` does; 1 stays a runtime failure. */
 export declare const USAGE_EXIT_CODE = 2;
 /** The usage text when `command` cannot be dispatched, undefined when it can. */
@@ -25,7 +26,7 @@ export declare function parseArgs(args: string[]): {
 export interface MainOptions {
     readonly services?: Pick<InstallServicesOptions, "loginPathRunner" | "writeFile">;
     /** Test seams for `setup`: the platform fetch and the prompter. */
-    readonly setup?: Pick<RunSetupOptions, "fetch" | "prompter" | "env">;
+    readonly setup?: Pick<RunSetupOptions, "fetch" | "prompter" | "env" | "binDir" | "runBrokerAgent">;
     /** Test seams for `ops restart-stack`; the real path spawns the service manager. */
     readonly restartStack?: {
         readonly launch?: Omit<LaunchRestartOptions, "home">;
@@ -59,34 +60,20 @@ export declare function renderCycle(cycle: OpsCycleResult): string[];
  * healthy. Extracted so the automation-facing contract is pinned by tests.
  */
 export declare function cycleExitCode(cycle: OpsCycleResult): number;
+export declare function renderSlo(result: OpsSloResult): string[];
+export declare function sloExitCode(result: OpsSloResult): number;
+export declare function renderDeliveries(result: OpsDeliveriesResult): string[];
 /**
- * The same acceptance the gateway applies at boot (`PRAGMA integrity_check`
- * must answer `ok`), run read-only against the backup before it replaces
- * anything. A 16-byte header match is not a database: a truncated or
- * bit-flipped file passes it, gets copied into place, and the next boot
- * fails while the restore already reported success.
- *
- * An empty file is also refused: SQLite treats a zero-length file as a valid
- * empty database and `integrity_check` answers `ok` for it, but restoring it
- * would boot a gateway with every table freshly created and nothing in them.
- *
- * Opening a WAL-mode backup read-only may leave empty `-wal`/`-shm` sidecars
- * next to the backup; `ops backup` writes delete-mode files, which gain none.
- */
-export declare function verifyBackupIntegrity(backupPath: string): void;
-/**
- * The database the gateway actually opens: `config.json` `dbPath` when set,
- * otherwise `<home>/gateway.db` — the same file-based resolution as the
- * gateway's `loadConfig`. An absent `config.json` means defaults, exactly as
- * at boot. A present-but-unreadable one (EACCES, EISDIR, or a dangling symlink,
- * which reports ENOENT while the entry exists) refuses the restore instead of
- * guessing, as boot refuses to start: copying a backup over the wrong file
- * reports success while the live database stays broken.
- *
- * `schemaVersion` is deliberately not checked: `dbPath` is a version-independent
- * string, and disaster recovery must not be blocked by an unrelated schema bump.
+ * Poll for memory operation completion. Memory operations (audit, autolink) are
+ * long-running and return an opRef immediately; this function polls for the result.
+ * If the CLI wait expires before completion, report 'still running' instead of failure.
  */
-export declare function restoreTargetPath(home?: string): Promise<string>;
-export declare function restoreDatabase(socket: string, backupPath: string): Promise<void>;
+export declare function pollMemoryOp(client: Pick<GajaewayClient, "request">, opRef: string, maxWaitMs?: number, // 5 min default CLI timeout
+pollIntervalMs?: number): Promise<{
+    status: "completed" | "failed" | "still_running";
+    elapsedMs: number;
+    result?: unknown;
+    error?: string;
+}>;
 export declare function main(args?: string[], options?: MainOptions): Promise<void>;
 //# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";AAIA,OAAO,KAAK,EAKX,cAAc,EAQd,MAAM,yBAAyB,CAAC;AAcjC,OAAO,EAEN,KAAK,oBAAoB,EAEzB,KAAK,iBAAiB,EAItB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,KAAK,sBAAsB,EAAmB,KAAK,eAAe,EAAgB,MAAM,YAAY,CAAC;AAC9G,OAAO,EAAE,KAAK,eAAe,EAAY,MAAM,SAAS,CAAC;AACzD,OAAO,EAA4C,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAGrF,wBAAgB,UAAU,CAAC,IAAI,qBAA4B,GAAG,MAAM,CAEnE;AAED;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,8IAcX,CAAC;AAEX,eAAO,MAAM,SAAS,0mCACklC,CAAC;AAEzmC,kFAAkF;AAClF,eAAO,MAAM,eAAe,IAAI,CAAC;AAEjC,iFAAiF;AACjF,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAExE;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAQ9F;AAMD,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,sBAAsB,EAAE,iBAAiB,GAAG,WAAW,CAAC,CAAC;IAClF,mEAAmE;IACnE,QAAQ,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,OAAO,GAAG,UAAU,GAAG,KAAK,CAAC,CAAC;IACrE,oFAAoF;IACpF,QAAQ,CAAC,YAAY,CAAC,EAAE;QACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC;QACrD,QAAQ,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;KACtD,CAAC;IACF,kFAAkF;IAClF,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC;CAC7B;AAED,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,QAAQ,CAAC;AAElD,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,eAAe,CAAC;CACpC;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,kBAAkB,CA8B7E;AAqID;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,EAAE,CA+C3D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAE3D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAwB9D;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,SAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CA2B7E;AAED,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBvF;AA8DD,wBAAsB,IAAI,CAAC,IAAI,WAAwB,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2cjG"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"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"}