agentspeak-cli 0.12.0 → 0.14.1

package/dist/run-spawner.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Per-meeting background `run` loop manager, used by the auto-act
+ * branch of `agentspeak-cli watch`.
+ *
+ * When watch sees an `invite` notification, it:
+ *   1. Runs `agentspeak-cli join <invite-url>` (short, foreground,
+ *      pure HTTP — no LLM required).
+ *   2. Spawns `agentspeak-cli run --meeting <id> --exec
+ *      ~/.agentspeak/reply.sh` as a detached background process.
+ *
+ * Step 2 is what turns the agent from "joined but idle" into a true
+ * autonomous participant — the `run` loop long-polls /my_turn and
+ * invokes the reply shim on every assigned turn. Operators wire
+ * their LLM client into reply.sh (Claude Code, Cursor agent, OpenAI
+ * HTTP, etc.). Unedited shims self-quit after AUTO_SHIM_SELF_QUIT_AFTER
+ * turns so an un-configured agent still exits the meeting cleanly.
+ *
+ * Idempotency: pid-file per meeting under `~/.agentspeak/runs/<id>.run.pid`,
+ * probed with `process.kill(pid, 0)`. Duplicate invite events (server
+ * dedups via `dedup_key`, but belts-and-suspenders) are no-ops.
+ *
+ * Portability: same pattern as `watch-daemon.ts` — detached spawn
+ * with `.unref()` + append-mode log fd, works on macOS / Linux /
+ * git-bash / WSL / native Windows.
+ */
+export interface RunSpawnerPaths {
+    runsDir: string;
+    joinLogPath: string;
+    runLogPath: string;
+    runPidPath: string;
+}
+export declare function runSpawnerPaths(meetingId: string): RunSpawnerPaths;
+/**
+ * Report whether a detached `run` loop for this meeting is currently
+ * alive. Stale pid files (process no longer exists) are cleaned up as
+ * a side-effect so the next `spawnRunForMeeting` call is free to
+ * start a fresh loop.
+ */
+export declare function isRunAlive(meetingId: string): {
+    alive: boolean;
+    pid: number | null;
+};
+export interface JoinResult {
+    ok: boolean;
+    exitCode: number | null;
+    signal: NodeJS.Signals | null;
+    logPath: string;
+}
+/**
+ * Invoke `agentspeak-cli join <inviteUrl>` and wait for it to exit.
+ * Join is cheap (one HTTP POST plus a skill fetch) and synchronous so
+ * we can decide whether to proceed to `run` only on success. Output
+ * is tee'd to `~/.agentspeak/runs/<meetingId>.join.log` to preserve
+ * the [JOINED ...] confirmation line for post-mortem debugging.
+ */
+export declare function runJoin(opts: {
+    inviteUrl: string;
+    meetingId: string;
+    cliEntry?: string;
+    nodeBinary?: string;
+    timeoutMs?: number;
+}): JoinResult;
+export interface SpawnRunResult {
+    started: boolean;
+    reused: boolean;
+    pid: number | null;
+    pidPath: string;
+    logPath: string;
+    reason?: string;
+}
+/**
+ * Spawn `agentspeak-cli run --meeting <id> --exec <reply.sh>` as a
+ * detached background process, idempotently. The reply shim path is
+ * resolved via `autoShimPaths()` so every install shares the single
+ * operator-editable `~/.agentspeak/reply.sh`.
+ *
+ * Caller contract:
+ *   - Only call this AFTER `runJoin` returned `ok: true`. The `run`
+ *     loop itself does not re-run join, so a 404 here would burn its
+ *     smoke-test budget and exit.
+ *   - Duplicate calls for the same meetingId are no-ops when the
+ *     previous loop is still alive.
+ */
+export declare function spawnRunForMeeting(opts: {
+    meetingId: string;
+    cliEntry?: string;
+    nodeBinary?: string;
+    extraArgs?: string[];
+}): SpawnRunResult;
+/**
+ * Stop a running per-meeting loop, if any. Exposed for completeness
+ * (tests + future `agentspeak run stop --meeting <id>` subcommand).
+ */
+export declare function stopRunForMeeting(meetingId: string): {
+    stopped: boolean;
+    pid: number | null;
+    reason?: string;
+};
+//# sourceMappingURL=run-spawner.d.ts.map

package/dist/run-spawner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-spawner.d.ts","sourceRoot":"","sources":["../src/run-spawner.ts"],"names":[],"mappings":"AAaA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,CAQlE;AAuBD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAOpF;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,UAAU,CAyCb;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB,GAAG,cAAc,CAsFjB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG;IACpD,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAmBA"}

package/dist/run-spawner.js

@@ -0,0 +1,220 @@
+import { spawn, spawnSync } from 'node:child_process';
+import { existsSync, mkdirSync, openSync, readFileSync, unlinkSync, writeFileSync, } from 'node:fs';
+import { join } from 'node:path';
+import { autoShimPaths } from './auto-shim.js';
+import { home } from './state.js';
+export function runSpawnerPaths(meetingId) {
+    const dir = join(home(), 'runs');
+    return {
+        runsDir: dir,
+        joinLogPath: join(dir, `${meetingId}.join.log`),
+        runLogPath: join(dir, `${meetingId}.run.log`),
+        runPidPath: join(dir, `${meetingId}.run.pid`),
+    };
+}
+function pidIsAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function readExistingPid(pidPath) {
+    if (!existsSync(pidPath))
+        return null;
+    try {
+        const raw = readFileSync(pidPath, 'utf8').trim();
+        const pid = Number.parseInt(raw, 10);
+        if (!Number.isFinite(pid) || pid <= 0)
+            return null;
+        return pid;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Report whether a detached `run` loop for this meeting is currently
+ * alive. Stale pid files (process no longer exists) are cleaned up as
+ * a side-effect so the next `spawnRunForMeeting` call is free to
+ * start a fresh loop.
+ */
+export function isRunAlive(meetingId) {
+    const { runPidPath } = runSpawnerPaths(meetingId);
+    const pid = readExistingPid(runPidPath);
+    if (!pid)
+        return { alive: false, pid: null };
+    if (pidIsAlive(pid))
+        return { alive: true, pid };
+    try {
+        unlinkSync(runPidPath);
+    }
+    catch { /* best-effort */ }
+    return { alive: false, pid };
+}
+/**
+ * Invoke `agentspeak-cli join <inviteUrl>` and wait for it to exit.
+ * Join is cheap (one HTTP POST plus a skill fetch) and synchronous so
+ * we can decide whether to proceed to `run` only on success. Output
+ * is tee'd to `~/.agentspeak/runs/<meetingId>.join.log` to preserve
+ * the [JOINED ...] confirmation line for post-mortem debugging.
+ */
+export function runJoin(opts) {
+    const { inviteUrl, meetingId } = opts;
+    const { runsDir, joinLogPath } = runSpawnerPaths(meetingId);
+    mkdirSync(runsDir, { recursive: true });
+    const nodeBinary = opts.nodeBinary ?? process.execPath;
+    const cliEntry = opts.cliEntry ?? process.argv[1];
+    if (!cliEntry) {
+        return { ok: false, exitCode: null, signal: null, logPath: joinLogPath };
+    }
+    try {
+        writeFileSync(joinLogPath, `\n[${new Date().toISOString()}] join starting (invite=${inviteUrl})\n`, { flag: 'a' });
+    }
+    catch { /* best-effort */ }
+    const result = spawnSync(nodeBinary, [cliEntry, 'join', inviteUrl], {
+        timeout: opts.timeoutMs ?? 60_000,
+        env: process.env,
+        stdio: 'pipe',
+        encoding: 'utf8',
+    });
+    const combined = [
+        result.stdout ?? '',
+        result.stderr ?? '',
+        `[${new Date().toISOString()}] join exited code=${result.status} signal=${result.signal ?? ''}\n`,
+    ].join('\n');
+    try {
+        writeFileSync(joinLogPath, combined, { flag: 'a' });
+    }
+    catch { /* best-effort */ }
+    return {
+        ok: result.status === 0,
+        exitCode: result.status,
+        signal: result.signal,
+        logPath: joinLogPath,
+    };
+}
+/**
+ * Spawn `agentspeak-cli run --meeting <id> --exec <reply.sh>` as a
+ * detached background process, idempotently. The reply shim path is
+ * resolved via `autoShimPaths()` so every install shares the single
+ * operator-editable `~/.agentspeak/reply.sh`.
+ *
+ * Caller contract:
+ *   - Only call this AFTER `runJoin` returned `ok: true`. The `run`
+ *     loop itself does not re-run join, so a 404 here would burn its
+ *     smoke-test budget and exit.
+ *   - Duplicate calls for the same meetingId are no-ops when the
+ *     previous loop is still alive.
+ */
+export function spawnRunForMeeting(opts) {
+    const { meetingId } = opts;
+    const { runsDir, runLogPath, runPidPath } = runSpawnerPaths(meetingId);
+    mkdirSync(runsDir, { recursive: true });
+    const alive = isRunAlive(meetingId);
+    if (alive.alive && alive.pid) {
+        return {
+            started: false,
+            reused: true,
+            pid: alive.pid,
+            pidPath: runPidPath,
+            logPath: runLogPath,
+        };
+    }
+    const nodeBinary = opts.nodeBinary ?? process.execPath;
+    const cliEntry = opts.cliEntry ?? process.argv[1];
+    if (!cliEntry) {
+        return {
+            started: false,
+            reused: false,
+            pid: null,
+            pidPath: runPidPath,
+            logPath: runLogPath,
+            reason: 'no_cli_entry',
+        };
+    }
+    // Resolve the operator's reply shim. The auto-shim is written on
+    // `init` and the EDIT-ME block is where operators plug in their
+    // LLM client. If the shim is missing we still proceed — `run`
+    // will surface a clear smoke-test failure in the per-meeting log.
+    const { posixPath: replyShim } = autoShimPaths();
+    const logFd = openSync(runLogPath, 'a');
+    try {
+        writeFileSync(runLogPath, `\n[${new Date().toISOString()}] run starting (meeting=${meetingId} exec=${replyShim})\n`, { flag: 'a' });
+    }
+    catch { /* best-effort */ }
+    const args = [
+        'run',
+        '--meeting',
+        meetingId,
+        '--exec',
+        replyShim,
+        ...(opts.extraArgs ?? []),
+    ];
+    const child = spawn(nodeBinary, [cliEntry, ...args], {
+        detached: true,
+        stdio: ['ignore', logFd, logFd],
+        env: process.env,
+    });
+    child.unref();
+    if (!child.pid) {
+        return {
+            started: false,
+            reused: false,
+            pid: null,
+            pidPath: runPidPath,
+            logPath: runLogPath,
+            reason: 'spawn_failed',
+        };
+    }
+    try {
+        writeFileSync(runPidPath, `${child.pid}\n`, { encoding: 'utf8' });
+    }
+    catch {
+        // Pid file is best-effort; if we can't persist we may spawn a
+        // duplicate next time, which is bounded by the `run` loop's own
+        // exit-on-terminal-status behaviour.
+    }
+    return {
+        started: true,
+        reused: false,
+        pid: child.pid,
+        pidPath: runPidPath,
+        logPath: runLogPath,
+    };
+}
+/**
+ * Stop a running per-meeting loop, if any. Exposed for completeness
+ * (tests + future `agentspeak run stop --meeting <id>` subcommand).
+ */
+export function stopRunForMeeting(meetingId) {
+    const { runPidPath } = runSpawnerPaths(meetingId);
+    const pid = readExistingPid(runPidPath);
+    if (!pid)
+        return { stopped: false, pid: null, reason: 'no_pid_file' };
+    if (!pidIsAlive(pid)) {
+        try {
+            unlinkSync(runPidPath);
+        }
+        catch { /* best-effort */ }
+        return { stopped: false, pid, reason: 'already_dead' };
+    }
+    try {
+        process.kill(pid, 'SIGTERM');
+    }
+    catch (err) {
+        return {
+            stopped: false,
+            pid,
+            reason: `kill_failed: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+    try {
+        unlinkSync(runPidPath);
+    }
+    catch { /* best-effort */ }
+    return { stopped: true, pid };
+}
+//# sourceMappingURL=run-spawner.js.map

package/dist/run-spawner.js.map

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

package/dist/skill-template.d.ts

@@ -54,7 +54,7 @@ export interface StepSkillSnippet {
  *
  * Bump this constant whenever you bump the protocol root skill.
  */
-export declare const CLI_SKILL_VERSION = 31;
+export declare const CLI_SKILL_VERSION = 33;
 export interface RenderedSkillBlock {
     name: string;
     path: string;

package/dist/skill-template.js

@@ -249,7 +249,7 @@ const ROOT_SKILL_DESCRIPTION = 'AgentSpeak is an online meeting coordinator for
  *
  * Bump this constant whenever you bump the protocol root skill.
  */
-export const CLI_SKILL_VERSION = 31;
+export const CLI_SKILL_VERSION = 33;
 function skillFrontmatter(name, description, version = CLI_SKILL_VERSION) {
     return [
         '---',

package/dist/version.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Single source of truth for the CLI's semver string.
+ *
+ * Kept in its own module (rather than re-exported from index.ts) so
+ * sub-modules like `watch-daemon.ts` can import it without pulling the
+ * whole argv dispatcher into their graph.
+ *
+ * Must be kept in sync with `package.json > version` at release time.
+ * `npm run build` does not auto-derive this — a stale constant will
+ * cause the version-stamped watch-daemon restart check to misfire, so
+ * release hygiene: bump both files in the same commit.
+ */
+export declare const CLI_VERSION = "0.14.1";
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,WAAW,WAAW,CAAC"}

package/dist/version.js

@@ -0,0 +1,14 @@
+/**
+ * Single source of truth for the CLI's semver string.
+ *
+ * Kept in its own module (rather than re-exported from index.ts) so
+ * sub-modules like `watch-daemon.ts` can import it without pulling the
+ * whole argv dispatcher into their graph.
+ *
+ * Must be kept in sync with `package.json > version` at release time.
+ * `npm run build` does not auto-derive this — a stale constant will
+ * cause the version-stamped watch-daemon restart check to misfire, so
+ * release hygiene: bump both files in the same commit.
+ */
+export const CLI_VERSION = '0.14.1';
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CAAC"}

package/dist/watch-daemon.d.ts

@@ -34,7 +34,15 @@ export interface EnsureWatchResult {
     started: boolean;
     /** True iff an existing live daemon was reused. */
     reused: boolean;
+    /**
+     * True iff an existing daemon was killed and replaced because its
+     * stamped CLI version did not match the current one (e.g. the caller
+     * is `tutorial` running 0.14.1 but the daemon was spawned by 0.13.0).
+     */
+    restartedForVersionMismatch: boolean;
     pid: number | null;
+    /** CLI version that spawned the CURRENT daemon (null for legacy pid files). */
+    previousCliVersion?: string | null;
     pidPath: string;
     logPath: string;
     /** Populated only when reused=false && started=false (i.e. skipped). */
@@ -53,6 +61,11 @@ export declare function ensureWatchRunning(opts?: {
     cliEntry?: string;
     nodeBinary?: string;
     extraArgs?: string[];
+    /**
+     * CLI version to stamp into the pid file. Defaults to the compiled-in
+     * `CLI_VERSION`. Tests override this to simulate upgrade scenarios.
+     */
+    cliVersion?: string;
 }): EnsureWatchResult;
 export interface StopWatchResult {
     stopped: boolean;
@@ -67,10 +80,12 @@ export declare function stopWatch(): StopWatchResult;
 /**
  * Report whether a daemon is currently running, for `watch status` /
  * doctor-style introspection. Returns null when no pid file exists.
+ * `cliVersion` is null for legacy pid files written by CLI <= 0.14.0.
  */
 export declare function watchStatus(): {
     pid: number;
     alive: boolean;
+    cliVersion: string | null;
 } | null;
 /**
  * Ensure the agent's wake_config advertises pull mode (when unset)

package/dist/watch-daemon.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"watch-daemon.d.ts","sourceRoot":"","sources":["../src/watch-daemon.ts"],"names":[],"mappings":"AAIA,OAAO,EAAiB,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGtE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,gBAAgB,IAAI,gBAAgB,CAMnD;AAED,MAAM,WAAW,iBAAiB;IAChC,gDAAgD;IAChD,OAAO,EAAE,OAAO,CAAC;IACjB,mDAAmD;IACnD,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAgCD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,GAAE;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB,GAAG,iBAAiB,CAkFzB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,eAAe,CAqB3C;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAKpE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,wBAAwB,CAC5C,QAAQ,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE,EACvD,WAAW,EAAE,WAAW,GAAG,SAAS,EACpC,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GACzB,OAAO,CAAC,IAAI,CAAC,CA8Df"}
+{"version":3,"file":"watch-daemon.d.ts","sourceRoot":"","sources":["../src/watch-daemon.ts"],"names":[],"mappings":"AAIA,OAAO,EAAiB,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAItE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,gBAAgB,IAAI,gBAAgB,CAMnD;AAED,MAAM,WAAW,iBAAiB;IAChC,gDAAgD;IAChD,OAAO,EAAE,OAAO,CAAC;IACjB,mDAAmD;IACnD,MAAM,EAAE,OAAO,CAAC;IAChB;;;;OAIG;IACH,2BAA2B,EAAE,OAAO,CAAC;IACrC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,+EAA+E;IAC/E,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAoED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,GAAE;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,iBAAiB,CAoHzB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,eAAe,CAqB3C;AAED;;;;GAIG;AACH,wBAAgB,WAAW,IAAI;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,IAAI,CAK/F;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,wBAAwB,CAC5C,QAAQ,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE,EACvD,WAAW,EAAE,WAAW,GAAG,SAAS,EACpC,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GACzB,OAAO,CAAC,IAAI,CAAC,CAuEf"}