@mininglamp-oss/cc-channel-octo 1.0.1-dev.0ac574a

package/dist/cli.js

@@ -0,0 +1,467 @@
+#!/usr/bin/env node
+/**
+ * cc-channel-octo CLI — a process supervisor for the gateway.
+ *
+ * The gateway itself (`index.ts`) only runs in the foreground. This thin
+ * supervisor backgrounds it, tracks a single process-wide PID file, and stops
+ * it gracefully (SIGTERM, then SIGKILL on timeout). It does NOT replace the
+ * per-bot `gateway.lock` (which prevents two processes serving the same bot) —
+ * the PID file lives at the baseDir root, a sibling of every bot subtree.
+ *
+ *   cc-channel-octo start [--foreground]
+ *   cc-channel-octo stop  [--timeout=<seconds>]
+ *   cc-channel-octo restart
+ *   cc-channel-octo status
+ *
+ * POSIX only (macOS/Linux): stop relies on SIGTERM/SIGKILL. On Windows, run the
+ * gateway under a service manager instead — Node has no SIGTERM semantics there.
+ */
+import { spawn, execFileSync } from 'node:child_process';
+import { openSync, readFileSync, writeFileSync, existsSync, mkdirSync, unlinkSync, realpathSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+import { setTimeout as sleep } from 'node:timers/promises';
+import { DEFAULT_CONFIG_PATH } from './config.js';
+import { configure } from './configure.js';
+/**
+ * Resolve the supervisor's fixed paths. baseDir defaults to the directory of
+ * the global config (`~/.cc-channel-octo`); tests inject a temp dir. indexEntry
+ * is the compiled gateway entrypoint, a sibling of this file.
+ */
+export function resolveSupervisorPaths(baseDir) {
+    const base = baseDir ?? dirname(DEFAULT_CONFIG_PATH);
+    return {
+        baseDir: base,
+        pidFile: join(base, 'cc-channel-octo.pid'),
+        logFile: join(base, 'logs', 'gateway.log'),
+        indexEntry: fileURLToPath(new URL('./index.js', import.meta.url)),
+    };
+}
+/**
+ * Extract a package version from raw package.json text. Returns 'unknown'
+ * rather than throwing if the text is malformed or has no non-empty string
+ * `version`. Pure (no I/O) so the fallback paths are unit-testable.
+ */
+export function parseVersion(raw) {
+    try {
+        const pkg = JSON.parse(raw);
+        if (pkg && typeof pkg === 'object' && 'version' in pkg) {
+            const v = pkg.version;
+            if (typeof v === 'string' && v.length > 0)
+                return v;
+        }
+    }
+    catch {
+        /* fall through to 'unknown' */
+    }
+    return 'unknown';
+}
+/**
+ * The package version, read at runtime from package.json — which lives at the
+ * package root, one level up from this module in both src/ (src/cli.ts) and the
+ * compiled output (dist/cli.js). Returns 'unknown' if the file can't be read.
+ */
+export function readVersion() {
+    try {
+        return parseVersion(readFileSync(new URL('../package.json', import.meta.url), 'utf-8'));
+    }
+    catch {
+        return 'unknown';
+    }
+}
+export function parseArgs(argv) {
+    const [cmd = '', ...rest] = argv;
+    let foreground = false;
+    let timeoutSec = 10;
+    let version;
+    let gatewayUrl;
+    let apiKey;
+    let model;
+    let apiUrl;
+    for (let i = 0; i < rest.length; i++) {
+        const a = rest[i];
+        if (a === '--foreground' || a === '-f') {
+            foreground = true;
+        }
+        else if (a.startsWith('--timeout=')) {
+            const n = Number.parseInt(a.slice('--timeout='.length), 10);
+            if (Number.isFinite(n) && n > 0)
+                timeoutSec = n;
+        }
+        else if (a === '--gateway-url') {
+            const next = rest[++i];
+            if (next === undefined || next.startsWith('--')) {
+                throw new Error('configure: --gateway-url requires a value');
+            }
+            gatewayUrl = next;
+        }
+        else if (a.startsWith('--gateway-url=')) {
+            gatewayUrl = a.slice('--gateway-url='.length);
+        }
+        else if (a === '--api-key') {
+            const next = rest[++i];
+            if (next === undefined || next.startsWith('--')) {
+                throw new Error('configure: --api-key requires a value');
+            }
+            apiKey = next;
+        }
+        else if (a.startsWith('--api-key=')) {
+            apiKey = a.slice('--api-key='.length);
+        }
+        else if (a === '--model') {
+            const next = rest[++i];
+            if (next === undefined || next.startsWith('--')) {
+                throw new Error('configure: --model requires a value');
+            }
+            model = next;
+        }
+        else if (a.startsWith('--model=')) {
+            model = a.slice('--model='.length);
+        }
+        else if (a === '--api-url') {
+            const next = rest[++i];
+            if (next === undefined || next.startsWith('--')) {
+                throw new Error('configure: --api-url requires a value');
+            }
+            apiUrl = next;
+        }
+        else if (a.startsWith('--api-url=')) {
+            apiUrl = a.slice('--api-url='.length);
+        }
+        else if (!a.startsWith('-') && version === undefined) {
+            version = a;
+        }
+    }
+    return { cmd, foreground, timeoutMs: timeoutSec * 1000, version, gatewayUrl, apiKey, model, apiUrl };
+}
+/**
+ * Liveness probe via signal 0. EPERM means the process exists but is owned by
+ * another user — still "alive" for our purposes; ESRCH means it's gone.
+ */
+export function isAlive(pid) {
+    if (!Number.isInteger(pid) || pid <= 0)
+        return false;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        return err.code === 'EPERM';
+    }
+}
+export function procStartTime(pid) {
+    if (!Number.isInteger(pid) || pid <= 0)
+        return null;
+    try {
+        const out = execFileSync('ps', ['-p', String(pid), '-o', 'lstart='], {
+            encoding: 'utf-8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        }).trim();
+        return out.length > 0 ? out : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Read the PID record. Accepts the current JSON form (`{"pid":N,"id":"…"}`) and
+ * the legacy bare-integer form (written by pre-ownership-token releases), which
+ * yields a null identity so callers fall back to liveness-only handling.
+ */
+export function readPidRecord(pidFile) {
+    if (!existsSync(pidFile))
+        return null;
+    const raw = readFileSync(pidFile, 'utf-8').trim();
+    if (!raw)
+        return null;
+    if (/^\d+$/.test(raw)) {
+        const pid = Number.parseInt(raw, 10);
+        return Number.isInteger(pid) && pid > 0 ? { pid, id: null } : null;
+    }
+    try {
+        const parsed = JSON.parse(raw);
+        if (parsed && typeof parsed === 'object' && 'pid' in parsed) {
+            const pidVal = parsed.pid;
+            const idVal = parsed.id;
+            if (typeof pidVal === 'number' && Number.isInteger(pidVal) && pidVal > 0) {
+                return { pid: pidVal, id: typeof idVal === 'string' ? idVal : null };
+            }
+        }
+    }
+    catch {
+        /* fall through to null */
+    }
+    return null;
+}
+/** The numeric PID from the file (no ownership check), or null. */
+export function readPid(pidFile) {
+    return readPidRecord(pidFile)?.pid ?? null;
+}
+export function writePid(pidFile, pid, id) {
+    writeFileSync(pidFile, `${JSON.stringify({ pid, id })}\n`, { mode: 0o600 });
+}
+export function removePid(pidFile) {
+    try {
+        unlinkSync(pidFile);
+    }
+    catch {
+        /* already gone — fine */
+    }
+}
+/**
+ * PID of the running gateway we own, or null. A process counts as ours only if
+ * it is alive AND its current OS identity matches the one recorded at start —
+ * the guard that stops `stop`/`restart`/`upgrade` from signaling a process that
+ * merely inherited the PID after an unclean crash + reuse. Identity mismatch
+ * means the file is stale (PID recycled), so it is removed. Legacy files (no
+ * recorded identity) and unreadable live identities fall back to liveness only,
+ * matching the pre-ownership-token behavior rather than refusing to stop.
+ */
+export function resolveOwnedPid(paths, procId) {
+    const rec = readPidRecord(paths.pidFile);
+    if (rec === null)
+        return null;
+    if (!isAlive(rec.pid)) {
+        removePid(paths.pidFile);
+        return null;
+    }
+    if (rec.id === null)
+        return rec.pid; // legacy file — nothing to verify against
+    const liveId = procId(rec.pid);
+    if (liveId === null)
+        return rec.pid; // identity unreadable — don't refuse to act
+    if (liveId === rec.id)
+        return rec.pid; // verified ours
+    removePid(paths.pidFile); // PID was recycled by an unrelated process
+    return null;
+}
+async function cmdStart(paths, foreground, procId) {
+    if (foreground) {
+        const child = spawn(process.execPath, [paths.indexEntry], {
+            stdio: 'inherit',
+            env: process.env,
+        });
+        return new Promise((resolve) => {
+            child.on('exit', (code) => resolve(code ?? 0));
+        });
+    }
+    const running = resolveOwnedPid(paths, procId);
+    if (running !== null) {
+        console.log(`cc-channel-octo: already running (pid ${running})`);
+        return 0;
+    }
+    mkdirSync(dirname(paths.logFile), { recursive: true });
+    const fd = openSync(paths.logFile, 'a');
+    const child = spawn(process.execPath, [paths.indexEntry], {
+        detached: true,
+        stdio: ['ignore', fd, fd],
+        env: process.env,
+    });
+    child.unref();
+    if (child.pid === undefined) {
+        console.error('cc-channel-octo: failed to spawn gateway');
+        return 1;
+    }
+    // Record the child's start-time identity alongside its PID so a later
+    // stop/restart can confirm it's still our process and not a PID-reuse victim.
+    writePid(paths.pidFile, child.pid, procId(child.pid));
+    // Confirm it didn't exit immediately (bad config, taken lock, …).
+    await sleep(400);
+    if (!isAlive(child.pid)) {
+        removePid(paths.pidFile);
+        console.error(`cc-channel-octo: gateway exited on startup; see ${paths.logFile}`);
+        return 1;
+    }
+    console.log(`cc-channel-octo: started (pid ${child.pid}), logs at ${paths.logFile}`);
+    return 0;
+}
+async function cmdStop(paths, timeoutMs, procId) {
+    const pid = resolveOwnedPid(paths, procId);
+    if (pid === null) {
+        // resolveOwnedPid already removed a stale/recycled file.
+        console.log('cc-channel-octo: not running');
+        return 0;
+    }
+    try {
+        process.kill(pid, 'SIGTERM');
+    }
+    catch {
+        removePid(paths.pidFile);
+        console.log('cc-channel-octo: not running');
+        return 0;
+    }
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        if (!isAlive(pid)) {
+            removePid(paths.pidFile);
+            console.log(`cc-channel-octo: stopped (pid ${pid})`);
+            return 0;
+        }
+        await sleep(200);
+    }
+    try {
+        process.kill(pid, 'SIGKILL');
+    }
+    catch {
+        /* exited between the last check and now — fine */
+    }
+    removePid(paths.pidFile);
+    console.log(`cc-channel-octo: force-killed (pid ${pid}) after ${timeoutMs / 1000}s`);
+    return 0;
+}
+function cmdStatus(paths, procId) {
+    const pid = resolveOwnedPid(paths, procId);
+    if (pid !== null) {
+        console.log(`cc-channel-octo: running (pid ${pid}), logs at ${paths.logFile}`);
+    }
+    else {
+        console.log('cc-channel-octo: stopped');
+    }
+    return 0;
+}
+/** npm package name installed globally for the gateway. */
+const NPM_PKG = '@mininglamp-oss/cc-channel-octo';
+/**
+ * Semantic-version whitelist. The version reaches us from the daemon → fleet
+ * upgrade order (an untrusted boundary) and is interpolated into an npm spec,
+ * so reject anything outside `[0-9A-Za-z.-+]` to prevent argument/shell
+ * injection even though we spawn npm without a shell.
+ */
+const VERSION_RE = /^[0-9A-Za-z.\-+]+$/;
+/**
+ * Build the `npm install -g <pkg>@<version>` argument vector. A blank/omitted
+ * version installs `@latest`. Pure (no I/O) so the injection guard is unit
+ * testable. Throws on an unsafe version string.
+ */
+export function buildUpgradeArgs(version) {
+    const v = version && version.trim() ? version.trim() : 'latest';
+    if (v !== 'latest' && !VERSION_RE.test(v)) {
+        throw new Error(`unsafe version: ${v}`);
+    }
+    return ['install', '-g', `${NPM_PKG}@${v}`];
+}
+/**
+ * Self-update: `npm install -g @mininglamp-oss/cc-channel-octo@<version>` then
+ * restart the gateway so the new code is live. Invoked by the daemon to drive
+ * a fleet upgrade order (mirrors openclaw's daemon-driven plugin install).
+ */
+async function cmdUpgrade(paths, timeoutMs, procId, version) {
+    let args;
+    try {
+        args = buildUpgradeArgs(version);
+    }
+    catch (err) {
+        console.error(`cc-channel-octo: ${err.message}`);
+        return 2;
+    }
+    console.log(`cc-channel-octo: upgrading via npm ${args.join(' ')}`);
+    const code = await new Promise((resolve) => {
+        const child = spawn('npm', args, { stdio: 'inherit', env: process.env });
+        child.on('error', (err) => {
+            console.error(`cc-channel-octo: failed to spawn npm: ${err.message}`);
+            resolve(1);
+        });
+        child.on('exit', (c) => resolve(c ?? 1));
+    });
+    if (code !== 0) {
+        console.error(`cc-channel-octo: npm install failed (exit ${code})`);
+        return code;
+    }
+    // Restart so the freshly installed code is running.
+    await cmdStop(paths, timeoutMs, procId);
+    return cmdStart(paths, false, procId);
+}
+function usage() {
+    return `cc-channel-octo ${readVersion()} — gateway process supervisor
+
+Usage:
+  cc-channel-octo start [--foreground]   start the gateway in the background
+  cc-channel-octo stop [--timeout=<s>]   gracefully stop (SIGTERM, then SIGKILL)
+  cc-channel-octo restart                stop (if running) then start
+  cc-channel-octo status                 show running state
+  cc-channel-octo upgrade [<version>]    npm install -g the gateway (default latest) then restart
+  cc-channel-octo configure --gateway-url <url> [--api-key <key>] [--model <model>] [--api-url <octo-server-url>]   write LLM gateway + key (+ optional model / Octo server url) to config (key also via CC_OCTO_CONFIGURE_API_KEY)
+  cc-channel-octo version                print the version
+
+Paths (under ~/.cc-channel-octo):
+  pid : cc-channel-octo.pid
+  log : logs/gateway.log
+
+POSIX only (macOS/Linux). On Windows, run under a service manager.`;
+}
+export async function run(argv, baseDir, procId = procStartTime) {
+    let parsed;
+    try {
+        parsed = parseArgs(argv);
+    }
+    catch (err) {
+        // Usage error (e.g. a flag missing its value): report it as a usage
+        // failure (exit 2), not an unhandled internal error from the top-level catch.
+        console.error(`cc-channel-octo: ${err.message}`);
+        return 2;
+    }
+    const { cmd, foreground, timeoutMs, version, gatewayUrl, apiKey, model, apiUrl } = parsed;
+    const paths = resolveSupervisorPaths(baseDir);
+    switch (cmd) {
+        case 'start':
+            return cmdStart(paths, foreground, procId);
+        case 'stop':
+            return cmdStop(paths, timeoutMs, procId);
+        case 'restart':
+            await cmdStop(paths, timeoutMs, procId);
+            return cmdStart(paths, false, procId);
+        case 'status':
+            return cmdStatus(paths, procId);
+        case 'upgrade':
+            return cmdUpgrade(paths, timeoutMs, procId, version);
+        case 'configure': {
+            const resolvedApiKey = apiKey ?? process.env.CC_OCTO_CONFIGURE_API_KEY ?? '';
+            const configPath = baseDir ? join(baseDir, 'config.json') : undefined;
+            try {
+                configure(gatewayUrl ?? '', resolvedApiKey, configPath, { model, apiUrl });
+                console.log('cc-channel-octo: configured gateway + api key');
+                return 0;
+            }
+            catch (err) {
+                console.error(`cc-channel-octo: ${err.message}`);
+                return 2;
+            }
+        }
+        case 'version':
+        case '--version':
+        case '-v':
+            console.log(readVersion());
+            return 0;
+        case 'help':
+        case '--help':
+        case '-h':
+            console.log(usage());
+            return 0;
+        case '':
+            // Backward compat: bare `cc-channel-octo` (e.g. `npx cc-channel-octo`)
+            // runs the gateway in the foreground, matching the pre-supervisor bin
+            // (`dist/index.js`) behavior documented in README/CHANGELOG. Daemon-style
+            // process management is opt-in via the `start`/`stop`/`restart`/`status`
+            // subcommands.
+            return cmdStart(paths, true, procId);
+        default:
+            console.error(`cc-channel-octo: unknown command '${cmd}'\n`);
+            console.error(usage());
+            return 2;
+    }
+}
+// Run only when invoked as a script (production / linked bin), not when
+// imported (tests). When called via the `bin` symlink, Node resolves
+// import.meta.url to the real file but leaves process.argv[1] as the symlink
+// path — so resolve argv[1] to its realpath before comparing, or the linked
+// command would silently no-op.
+const entrypoint = process.argv[1];
+if (entrypoint && import.meta.url === pathToFileURL(realpathSync(entrypoint)).href) {
+    run(process.argv.slice(2))
+        .then((code) => process.exit(code))
+        .catch((err) => {
+        console.error('cc-channel-octo:', String(err));
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACjH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAS3C;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAgB;IACrD,MAAM,IAAI,GAAG,OAAO,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACrD,OAAO;QACL,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,qBAAqB,CAAC;QAC1C,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,CAAC;QAC1C,UAAU,EAAE,aAAa,CAAC,IAAI,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;KAClE,CAAC;AACJ,CAAC;AAkBD;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,IAAI,CAAC;QACH,MAAM,GAAG,GAAY,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,SAAS,IAAI,GAAG,EAAE,CAAC;YACvD,MAAM,CAAC,GAAI,GAA4B,CAAC,OAAO,CAAC;YAChD,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,+BAA+B;IACjC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW;IACzB,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1F,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAc;IACtC,MAAM,CAAC,GAAG,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IACjC,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,IAAI,UAAU,GAAG,EAAE,CAAC;IACpB,IAAI,OAA2B,CAAC;IAChC,IAAI,UAA8B,CAAC;IACnC,IAAI,MAA0B,CAAC;IAC/B,IAAI,KAAyB,CAAC;IAC9B,IAAI,MAA0B,CAAC;IAC/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,IAAI,CAAC,KAAK,cAAc,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;YACvC,UAAU,GAAG,IAAI,CAAC;QACpB,CAAC;aAAM,IAAI,CAAC,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YACtC,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;YAC5D,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;gBAAE,UAAU,GAAG,CAAC,CAAC;QAClD,CAAC;aAAM,IAAI,CAAC,KAAK,eAAe,EAAE,CAAC;YACjC,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YACvB,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBAChD,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAA;YAC9D,CAAC;YACD,UAAU,GAAG,IAAI,CAAC;QACpB,CAAC;aAAM,IAAI,CAAC,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;YAC1C,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAChD,CAAC;aAAM,IAAI,CAAC,KAAK,WAAW,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YACvB,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBAChD,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAA;YAC1D,CAAC;YACD,MAAM,GAAG,IAAI,CAAC;QAChB,CAAC;aAAM,IAAI,CAAC,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YACtC,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QACxC,CAAC;aAAM,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YACvB,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBAChD,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAA;YACxD,CAAC;YACD,KAAK,GAAG,IAAI,CAAC;QACf,CAAC;aAAM,IAAI,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YACpC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACrC,CAAC;aAAM,IAAI,CAAC,KAAK,WAAW,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YACvB,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBAChD,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAA;YAC1D,CAAC;YACD,MAAM,GAAG,IAAI,CAAC;QAChB,CAAC;aAAM,IAAI,CAAC,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YACtC,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QACxC,CAAC;aAAM,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YACvD,OAAO,GAAG,CAAC,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,GAAG,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AACvG,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,GAAW;IACjC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACrD,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAQ,GAA6B,CAAC,IAAI,KAAK,OAAO,CAAC;IACzD,CAAC;AACH,CAAC;AAsBD,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACpD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,EAAE;YACnE,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;SACpC,CAAC,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IAClD,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACrC,OAAO,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACrE,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACxC,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,IAAI,MAAM,EAAE,CAAC;YAC5D,MAAM,MAAM,GAAI,MAA2B,CAAC,GAAG,CAAC;YAChD,MAAM,KAAK,GAAI,MAA2B,CAAC,EAAE,CAAC;YAC9C,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YACvE,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,0BAA0B;IAC5B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,OAAO,CAAC,OAAe;IACrC,OAAO,aAAa,CAAC,OAAO,CAAC,EAAE,GAAG,IAAI,IAAI,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,OAAe,EAAE,GAAW,EAAE,EAAiB;IACtE,aAAa,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,IAAI,CAAC;QACH,UAAU,CAAC,OAAO,CAAC,CAAC;IACtB,CAAC;IAAC,MAAM,CAAC;QACP,yBAAyB;IAC3B,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAAC,KAAsB,EAAE,MAAsB;IAC5E,MAAM,GAAG,GAAG,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACzC,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC9B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QACtB,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,GAAG,CAAC,EAAE,KAAK,IAAI;QAAE,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,0CAA0C;IAC/E,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,4CAA4C;IACjF,IAAI,MAAM,KAAK,GAAG,CAAC,EAAE;QAAE,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,gBAAgB;IACvD,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,2CAA2C;IACrE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,KAAsB,EAAE,UAAmB,EAAE,MAAsB;IACzF,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE;YACxD,KAAK,EAAE,SAAS;YAChB,GAAG,EAAE,OAAO,CAAC,GAAG;SACjB,CAAC,CAAC;QACH,OAAO,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,EAAE;YACrC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,OAAO,GAAG,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC/C,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,OAAO,CAAC,GAAG,CAAC,yCAAyC,OAAO,GAAG,CAAC,CAAC;QACjE,OAAO,CAAC,CAAC;IACX,CAAC;IAED,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,MAAM,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACxC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE;QACxD,QAAQ,EAAE,IAAI;QACd,KAAK,EAAE,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,CAAC;QACzB,GAAG,EAAE,OAAO,CAAC,GAAG;KACjB,CAAC,CAAC;IACH,KAAK,CAAC,KAAK,EAAE,CAAC;IAEd,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC1D,OAAO,CAAC,CAAC;IACX,CAAC;IACD,sEAAsE;IACtE,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IAEtD,kEAAkE;IAClE,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;IACjB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACzB,OAAO,CAAC,KAAK,CAAC,mDAAmD,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAClF,OAAO,CAAC,CAAC;IACX,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,iCAAiC,KAAK,CAAC,GAAG,cAAc,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACrF,OAAO,CAAC,CAAC;AACX,CAAC;AAED,KAAK,UAAU,OAAO,CAAC,KAAsB,EAAE,SAAiB,EAAE,MAAsB;IACtF,MAAM,GAAG,GAAG,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC3C,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACjB,yDAAyD;QACzD,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;QAC5C,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;QAC5C,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IACxC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC7B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAClB,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACzB,OAAO,CAAC,GAAG,CAAC,iCAAiC,GAAG,GAAG,CAAC,CAAC;YACrD,OAAO,CAAC,CAAC;QACX,CAAC;QACD,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC;IAED,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,kDAAkD;IACpD,CAAC;IACD,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACzB,OAAO,CAAC,GAAG,CAAC,sCAAsC,GAAG,WAAW,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC;IACrF,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,SAAS,CAAC,KAAsB,EAAE,MAAsB;IAC/D,MAAM,GAAG,GAAG,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC3C,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACjB,OAAO,CAAC,GAAG,CAAC,iCAAiC,GAAG,cAAc,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACjF,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,2DAA2D;AAC3D,MAAM,OAAO,GAAG,iCAAiC,CAAC;AAClD;;;;;GAKG;AACH,MAAM,UAAU,GAAG,oBAAoB,CAAC;AAExC;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAgB;IAC/C,MAAM,CAAC,GAAG,OAAO,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;IAChE,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,IAAI,CAAC,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,UAAU,CAAC,KAAsB,EAAE,SAAiB,EAAE,MAAsB,EAAE,OAAgB;IAC3G,IAAI,IAAc,CAAC;IACnB,IAAI,CAAC;QACH,IAAI,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,oBAAqB,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QAC5D,OAAO,CAAC,CAAC;IACX,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,sCAAsC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACpE,MAAM,IAAI,GAAG,MAAM,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,EAAE;QACjD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QACzE,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACxB,OAAO,CAAC,KAAK,CAAC,yCAAyC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YACtE,OAAO,CAAC,CAAC,CAAC,CAAC;QACb,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IACH,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,6CAA6C,IAAI,GAAG,CAAC,CAAC;QACpE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,oDAAoD;IACpD,MAAM,OAAO,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IACxC,OAAO,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;AACxC,CAAC;AAED,SAAS,KAAK;IACZ,OAAO,mBAAmB,WAAW,EAAE;;;;;;;;;;;;;;;mEAe0B,CAAC;AACpE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,IAAc,EAAE,OAAgB,EAAE,SAAyB,aAAa;IAChG,IAAI,MAAkB,CAAC;IACvB,IAAI,CAAC;QACH,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,oEAAoE;QACpE,8EAA8E;QAC9E,OAAO,CAAC,KAAK,CAAC,oBAAqB,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QAC5D,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAC1F,MAAM,KAAK,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAC9C,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,OAAO;YACV,OAAO,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;QAC7C,KAAK,MAAM;YACT,OAAO,OAAO,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;QAC3C,KAAK,SAAS;YACZ,MAAM,OAAO,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;YACxC,OAAO,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QACxC,KAAK,QAAQ;YACX,OAAO,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAClC,KAAK,SAAS;YACZ,OAAO,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QACvD,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,cAAc,GAAG,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,yBAAyB,IAAI,EAAE,CAAC;YAC7E,MAAM,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YACtE,IAAI,CAAC;gBACH,SAAS,CAAC,UAAU,IAAI,EAAE,EAAE,cAAc,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;gBAC3E,OAAO,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC;gBAC7D,OAAO,CAAC,CAAC;YACX,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CAAC,oBAAqB,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;gBAC5D,OAAO,CAAC,CAAC;YACX,CAAC;QACH,CAAC;QACD,KAAK,SAAS,CAAC;QACf,KAAK,WAAW,CAAC;QACjB,KAAK,IAAI;YACP,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;YAC3B,OAAO,CAAC,CAAC;QACX,KAAK,MAAM,CAAC;QACZ,KAAK,QAAQ,CAAC;QACd,KAAK,IAAI;YACP,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;YACrB,OAAO,CAAC,CAAC;QACX,KAAK,EAAE;YACL,uEAAuE;YACvE,sEAAsE;YACtE,0EAA0E;YAC1E,yEAAyE;YACzE,eAAe;YACf,OAAO,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QACvC;YACE,OAAO,CAAC,KAAK,CAAC,qCAAqC,GAAG,KAAK,CAAC,CAAC;YAC7D,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;YACvB,OAAO,CAAC,CAAC;IACb,CAAC;AACH,CAAC;AAED,wEAAwE;AACxE,qEAAqE;AACrE,6EAA6E;AAC7E,4EAA4E;AAC5E,gCAAgC;AAChC,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACnC,IAAI,UAAU,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,aAAa,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACnF,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SACvB,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;SAClC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QACb,OAAO,CAAC,KAAK,CAAC,kBAAkB,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands.d.ts

@@ -0,0 +1,57 @@
+/**
+ * In-chat slash commands (v0.3).
+ *
+ * Users can control their session without leaving the chat:
+ *   /reset            — clear this session's conversation history
+ *   /config           — show the effective per-session settings
+ *   /help             — list available commands
+ *
+ * Commands are matched on the FIRST line of the cleaned message text (after the
+ * router has stripped any leading @bot mention), so `@bot /reset` works in
+ * groups. Matching is case-insensitive and tolerant of surrounding whitespace.
+ *
+ * A command is scoped to the sessionKey of the message. In a group the session
+ * is shared per channel, so `/reset` clears the WHOLE group's conversation
+ * history (every member shares one session), not just the caller's. In a DM it
+ * clears that peer's history. Note: it does NOT clear long-term auto-memory.
+ *
+ * Note: commands are handled inside the router's processing callback, AFTER the
+ * per-session rate limit is applied. A user who has exhausted their token bucket
+ * therefore cannot run `/reset` or `/help` until it refills — control commands
+ * are rate-limited like normal messages. This is intentional (a flooder should
+ * not get a rate-limit bypass via slash commands); documented in the README.
+ */
+import type { Config } from './config.js';
+import type { SessionStore } from './session-store.js';
+/** Result of attempting to handle a command. */
+export interface CommandResult {
+    /** True when the text was a recognized command and was handled. */
+    handled: boolean;
+    /** Reply to send back to the user (only meaningful when handled). */
+    reply?: string;
+}
+/**
+ * Parse the command token from a message body. Returns the lowercased command
+ * name (without the leading slash) and the trimmed argument string, or null
+ * when the text does not start with a slash command.
+ *
+ * Only the first whitespace-delimited token on the first line is considered, so
+ * a message that merely mentions "/reset" mid-sentence is NOT treated as a
+ * command — it must lead.
+ */
+export declare function parseCommand(body: string): {
+    name: string;
+    args: string;
+} | null;
+/**
+ * Try to handle `body` as a slash command for the given session.
+ *
+ * Returns `{ handled: false }` when the text is not a command (caller proceeds
+ * with the normal agent pipeline). When handled, returns the reply to send and
+ * performs any side effect (e.g. clearing history) immediately.
+ *
+ * `messageSeq` is the seq of the command message itself; `/reset` records it as
+ * a persisted barrier so cold-start group backfill cannot resurrect pre-reset
+ * history on a later turn.
+ */
+export declare function handleCommand(body: string, sessionKey: string, store: SessionStore, config: Config, messageSeq?: number): CommandResult;

package/dist/commands.js

@@ -0,0 +1,121 @@
+/**
+ * In-chat slash commands (v0.3).
+ *
+ * Users can control their session without leaving the chat:
+ *   /reset            — clear this session's conversation history
+ *   /config           — show the effective per-session settings
+ *   /help             — list available commands
+ *
+ * Commands are matched on the FIRST line of the cleaned message text (after the
+ * router has stripped any leading @bot mention), so `@bot /reset` works in
+ * groups. Matching is case-insensitive and tolerant of surrounding whitespace.
+ *
+ * A command is scoped to the sessionKey of the message. In a group the session
+ * is shared per channel, so `/reset` clears the WHOLE group's conversation
+ * history (every member shares one session), not just the caller's. In a DM it
+ * clears that peer's history. Note: it does NOT clear long-term auto-memory.
+ *
+ * Note: commands are handled inside the router's processing callback, AFTER the
+ * per-session rate limit is applied. A user who has exhausted their token bucket
+ * therefore cannot run `/reset` or `/help` until it refills — control commands
+ * are rate-limited like normal messages. This is intentional (a flooder should
+ * not get a rate-limit bypass via slash commands); documented in the README.
+ */
+/** Not a command at all — let the normal agent pipeline take over. */
+const NOT_A_COMMAND = { handled: false };
+/**
+ * Parse the command token from a message body. Returns the lowercased command
+ * name (without the leading slash) and the trimmed argument string, or null
+ * when the text does not start with a slash command.
+ *
+ * Only the first whitespace-delimited token on the first line is considered, so
+ * a message that merely mentions "/reset" mid-sentence is NOT treated as a
+ * command — it must lead.
+ */
+export function parseCommand(body) {
+    const firstLine = body.split('\n', 1)[0]?.trim() ?? '';
+    // The command name must be followed by a TOKEN BOUNDARY — end-of-line or
+    // whitespace — before any args. Without this, path/route-like text such as
+    // `/reset/foo`, `/config.json`, or `/help.md` would be parsed as the bare
+    // command and could trigger a destructive action (`/reset`). Requiring `\s+`
+    // (or EOL) after the name means only a real command token matches; anything
+    // glued to the name (`/foo.bar`, `/a/b`) is NOT a command and falls through
+    // to the normal agent pipeline.
+    const match = firstLine.match(/^\/([a-zA-Z][a-zA-Z0-9_-]*)(?:\s+(.*))?$/);
+    if (!match)
+        return null;
+    return { name: match[1].toLowerCase(), args: (match[2] ?? '').trim() };
+}
+/** Human-readable list of supported commands. */
+const HELP_TEXT = [
+    'Available commands:',
+    '• `/reset` — clear the conversation history for this session (the whole group, in a group chat); does not clear long-term memory',
+    '• `/config` — show the current session settings',
+    '• `/help` — show this message',
+].join('\n');
+/**
+ * Render the effective, non-sensitive per-session configuration. Deliberately
+ * omits secrets (botToken, apiUrl host details beyond scheme) — this reply is
+ * visible to any user who can message the bot.
+ */
+function renderConfig(config) {
+    const tools = config.sdk.allowedTools === '*'
+        ? '* (all SDK tools)'
+        : config.sdk.allowedTools.join(', ');
+    return [
+        'Current settings:',
+        `• model: ${config.sdk.model ?? '(SDK default)'}`,
+        `• allowedTools: ${tools}`,
+        `• permissionMode: ${config.sdk.permissionMode}`,
+        `• rateLimit: ${config.rateLimit.maxPerMinute} req/min`,
+        `• historyLimit: ${config.context.historyLimit} messages`,
+    ].join('\n');
+}
+/**
+ * Try to handle `body` as a slash command for the given session.
+ *
+ * Returns `{ handled: false }` when the text is not a command (caller proceeds
+ * with the normal agent pipeline). When handled, returns the reply to send and
+ * performs any side effect (e.g. clearing history) immediately.
+ *
+ * `messageSeq` is the seq of the command message itself; `/reset` records it as
+ * a persisted barrier so cold-start group backfill cannot resurrect pre-reset
+ * history on a later turn.
+ */
+export function handleCommand(body, sessionKey, store, config, messageSeq) {
+    const parsed = parseCommand(body);
+    if (!parsed)
+        return NOT_A_COMMAND;
+    switch (parsed.name) {
+        case 'reset': {
+            // Scoped to THIS sessionKey. In a group the session is shared per channel,
+            // so this clears the whole group's conversation history; in a DM it clears
+            // that peer's. Long-term auto-memory (under memoryBase) is NOT cleared.
+            store.deleteSession(sessionKey);
+            // Persist a barrier at this message_seq so G4 cold-start backfill (which
+            // refetches channel history when the local cache is empty) cannot
+            // re-seed the history we just cleared — even across a process restart.
+            if (messageSeq !== undefined) {
+                store.setResetBarrier(sessionKey, messageSeq);
+            }
+            // v0.3 persistent sessions: also forget the SDK session id, otherwise the
+            // next turn would `resume` it and bring the just-cleared conversation back.
+            store.clearSdkSessionId(sessionKey);
+            return { handled: true, reply: '✓ Conversation history cleared (long-term memory is kept).' };
+        }
+        case 'config': {
+            return { handled: true, reply: renderConfig(config) };
+        }
+        case 'help': {
+            return { handled: true, reply: HELP_TEXT };
+        }
+        default:
+            // A leading-slash token we don't recognize. Report it rather than
+            // silently forwarding to the agent, so typos are visible.
+            return {
+                handled: true,
+                reply: `Unknown command: /${parsed.name}\n\n${HELP_TEXT}`,
+            };
+    }
+}
+//# sourceMappingURL=commands.js.map