@relaymessenger/cli 0.3.0

package/dist/codex.js

@@ -0,0 +1,227 @@
+/**
+ * Codex-side entrypoints installed by `relaymessenger install-codex`:
+ *
+ * `relaymessenger notify` — Codex appends its notification JSON as the final argv
+ * arg (kebab-case): {"type":"agent-turn-complete","thread-id":…,"turn-id":…,
+ * "cwd":…,"input-messages":[…],"last-assistant-message":…}. That is the only
+ * notify event Codex emits; approvals come through the PermissionRequest hook.
+ *
+ * `relaymessenger hook permission-request` — Codex's hooks engine pipes
+ * {session_id, turn_id, cwd, tool_name, tool_input, permission_mode} on stdin
+ * and accepts a decision on stdout (developers.openai.com/codex/hooks):
+ *   exit 0 + {"hookSpecificOutput":{"hookEventName":"PermissionRequest",
+ *             "decision":{"behavior":"allow"|"deny"}}}
+ *   exit 0 + no decision → fall through to Codex's normal approval flow
+ * The hook posts an Allow/Deny card to Relay and blocks on the phone tap
+ * (watching its per-request approval file — which a running `relaymessenger start`
+ * loop resolves — and polling the conversation directly). Timeout → deny.
+ *
+ * These entrypoints run in their own processes and never write state.json;
+ * that file is owned exclusively by the `start` loop. They read the pinned
+ * owner conversation via readStateSnapshot() and coordinate approvals only
+ * through per-request files in the active account runtime's approvals/.
+ */
+import { randomBytes } from "node:crypto";
+import { basename, dirname } from "node:path";
+import { RelayClient } from "./api.js";
+import { buildPermissionCard, newRequestId, verdictFromMessage } from "./permissions.js";
+import { ApprovalStore, CodexNotifyPolicyStore, ConfigStore, readStateSnapshot, resolveOwnerUserId, runtimeHomeForConfig, relayIdentityForConfig, } from "./store.js";
+export function requireClient(config = new ConfigStore()) {
+    const projectRoot = new CodexNotifyPolicyStore().matchProject(process.cwd());
+    if (!projectRoot) {
+        throw new Error("This project is not opted in to Relay. Run `relaymessenger install-codex` from its root first.");
+    }
+    const loaded = config.load();
+    if (!loaded?.agent_token) {
+        throw new Error("Not paired. Run `relaymessenger pair` first.");
+    }
+    let ownerUserId;
+    try {
+        ownerUserId = resolveOwnerUserId(loaded);
+    }
+    catch {
+        ownerUserId = undefined;
+    }
+    return {
+        client: new RelayClient(loaded.api_origin, loaded.agent_token),
+        ownerUserId,
+        // The owner's conversation, pinned by the loop at the first owner
+        // message — never the most recent writer.
+        conversationId: readStateSnapshot(runtimeHomeForConfig(loaded, dirname(config.path))).owner_conversation_id,
+        projectRoot,
+        runtimeHome: runtimeHomeForConfig(loaded, dirname(config.path)),
+        apiOrigin: loaded.api_origin,
+        accountIdentity: relayIdentityForConfig(loaded),
+    };
+}
+export async function notifyCommand(argv, out = console.log, dependencies = {}) {
+    const raw = argv[argv.length - 1];
+    let payload = {};
+    try {
+        payload = raw ? JSON.parse(raw) : {};
+    }
+    catch {
+        // Not JSON — treat as free text.
+        payload = { "last-assistant-message": raw };
+    }
+    if (payload.type && payload.type !== "agent-turn-complete")
+        return;
+    const projectRoot = (dependencies.policy ?? new CodexNotifyPolicyStore()).matchProject(payload.cwd);
+    if (!projectRoot) {
+        out("relaymessenger notify: suppressed — this project was not explicitly opted in.");
+        return;
+    }
+    const config = dependencies.config ?? new ConfigStore();
+    const loaded = config.load();
+    if (!loaded?.agent_token)
+        throw new Error("Not paired. Run `relaymessenger pair` first.");
+    const conversationId = readStateSnapshot(runtimeHomeForConfig(loaded, dirname(config.path))).owner_conversation_id;
+    const client = dependencies.client ?? new RelayClient(loaded.api_origin, loaded.agent_token);
+    if (!conversationId) {
+        out("relaymessenger notify: no pinned owner conversation yet — run `relaymessenger start` once and " +
+            "message the agent from the Relay app first.");
+        return;
+    }
+    const last = payload["last-assistant-message"];
+    const summary = typeof last === "string" && last.trim().length > 0
+        ? last.trim()
+        : "Codex finished a turn.";
+    const turnId = payload["turn-id"] ?? randomBytes(6).toString("hex");
+    await client.postMessage({
+        conversation_id: conversationId,
+        parts: [{ type: "text", text: `Codex (${basename(projectRoot)}): ${summary}`.slice(0, 7900) }],
+    }, `relay-notify-${turnId}`);
+}
+async function readStdin() {
+    const chunks = [];
+    for await (const chunk of process.stdin)
+        chunks.push(chunk);
+    return Buffer.concat(chunks).toString("utf8");
+}
+const HOOK_TIMEOUT_MS = 9 * 60 * 1000; // under Codex's 600 s handler default
+export async function permissionRequestHook(write = (json) => process.stdout.write(`${JSON.stringify(json)}\n`)) {
+    let input = {};
+    try {
+        input = JSON.parse(await readStdin());
+    }
+    catch {
+        return 0; // Unparseable input → no decision, Codex falls back to local approval.
+    }
+    const config = new ConfigStore().load();
+    const projectRoot = new CodexNotifyPolicyStore().matchProject(input.cwd);
+    if (!projectRoot)
+        return 0;
+    const conversationId = config?.agent_token
+        ? readStateSnapshot(runtimeHomeForConfig(config)).owner_conversation_id
+        : undefined;
+    let ownerUserId;
+    try {
+        ownerUserId = config ? resolveOwnerUserId(config) : undefined;
+    }
+    catch {
+        ownerUserId = undefined;
+    }
+    if (!config?.agent_token || !conversationId || !ownerUserId) {
+        // Not paired / no pinned owner or conversation → we cannot verify who
+        // would answer, so fall through to Codex's local approval flow.
+        return 0;
+    }
+    const client = new RelayClient(config.api_origin, config.agent_token);
+    const approvals = new ApprovalStore();
+    const requestId = newRequestId();
+    const approval = {
+        request_id: requestId,
+        conversation_id: conversationId,
+        engine: "codex",
+        tool_name: input.tool_name,
+        created_at: new Date().toISOString(),
+        deadline_at: new Date(Date.now() + HOOK_TIMEOUT_MS).toISOString(),
+        options: [
+            { option_id: "allow", label: "Allow", kind: "allow_once" },
+            { option_id: "deny", label: "Deny", kind: "reject_once" },
+        ],
+        source: "hook",
+    };
+    let card;
+    try {
+        card = buildPermissionCard({
+            requestId,
+            conversationId,
+            engineLabel: "Codex",
+            toolName: input.tool_name,
+            inputPreview: input.tool_input !== undefined ? JSON.stringify(input.tool_input) : undefined,
+        });
+    }
+    catch (error) {
+        process.stderr.write(`relaymessenger: refusing concealed approval input (${error}) — denying.\n`);
+        write(decisionJson(false));
+        return 0;
+    }
+    // Durable (create-once) before the card goes out. A running `relaymessenger
+    // start` loop sees the tap on the event stream and writes the resolution
+    // into this file; this process is the waiter that consumes it.
+    approvals.create(approval);
+    let posted;
+    try {
+        posted = await client.postMessage(card.body, card.idempotencyKey);
+    }
+    catch (error) {
+        approvals.consume(requestId);
+        process.stderr.write(`relaymessenger: approval card could not be delivered (${error}) — denying.\n`);
+        write(decisionJson(false));
+        return 0;
+    }
+    const cardSequence = posted.message.sequence;
+    const finish = (allow) => {
+        approvals.consume(requestId);
+        write(decisionJson(allow));
+        return 0;
+    };
+    const deadline = Date.now() + HOOK_TIMEOUT_MS;
+    while (Date.now() < deadline) {
+        await new Promise((resolve) => setTimeout(resolve, 2500));
+        // Path 1: a running start loop resolved our approval file.
+        const shared = approvals.get(requestId);
+        if (shared?.resolution)
+            return finish(shared.resolution.behavior === "allow");
+        if (!shared) {
+            // Aged out from under us — treat as deny.
+            break;
+        }
+        // Path 2: poll the conversation directly (works without `relaymessenger start`).
+        try {
+            const { messages } = await client.listMessages(conversationId, 10);
+            const verdict = messages
+                .filter((message) => message.sender.kind === "user" &&
+                message.sender.id === ownerUserId &&
+                message.conversation_id === conversationId &&
+                message.sequence > cardSequence)
+                .sort((a, b) => a.sequence - b.sequence)
+                .map((message) => verdictFromMessage(message))
+                .find((candidate) => candidate?.request_id === requestId);
+            if (verdict)
+                return finish(verdict.behavior === "allow");
+        }
+        catch {
+            // transient — keep polling until deadline
+        }
+    }
+    process.stderr.write("relaymessenger: no approval from Relay within the window — denying.\n");
+    return finish(false);
+}
+/**
+ * Exact PermissionRequest hook envelope from the Codex hooks reference:
+ * hookSpecificOutput.hookEventName is required — without it Codex treats the
+ * output as invalid and the phone decision is dropped.
+ */
+export function decisionJson(allow) {
+    return {
+        hookSpecificOutput: {
+            hookEventName: "PermissionRequest",
+            decision: allow
+                ? { behavior: "allow" }
+                : { behavior: "deny", message: "Denied from the Relay app." },
+        },
+    };
+}
+//# sourceMappingURL=codex.js.map

package/dist/codex.js.map

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

package/dist/doctor.d.ts

@@ -0,0 +1,2 @@
+export declare function doctor(out?: (line: string) => void): Promise<boolean>;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../src/doctor.ts"],"names":[],"mappings":"AAgBA,wBAAsB,MAAM,CAAC,GAAG,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CA4IxF"}

package/dist/doctor.js

@@ -0,0 +1,122 @@
+/** `relaymessenger doctor` — environment and pairing health checks. */
+import { existsSync, statSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import crossSpawn from "cross-spawn";
+import { resolveApiOrigin, RelayClient } from "./api.js";
+import { claudeBypassWarning } from "./claude-settings.js";
+import { ADAPTER_PACKAGES, ADAPTER_VERSIONS, adapterEntrypoint } from "./engine/acp.js";
+import { EXTERNAL_ENGINE_SPECS } from "./engine/catalog.js";
+import { ApprovalStore, ConfigStore, readStateSnapshot, runtimeHomeForConfig, } from "./store.js";
+export async function doctor(out = console.log) {
+    let healthy = true;
+    const check = (ok, label, detail) => {
+        healthy = healthy && ok;
+        out(`${ok ? "ok " : "FAIL"}  ${label}${detail ? ` — ${detail}` : ""}`);
+        return ok;
+    };
+    const [nodeMajor, nodeMinor] = process.versions.node.split(".").map(Number);
+    check((nodeMajor ?? 0) > 22 || (nodeMajor === 22 && (nodeMinor ?? 0) >= 18), "node >= 22.18", `running ${process.versions.node}`);
+    const config = new ConfigStore();
+    const loaded = config.load();
+    if (check(Boolean(loaded?.agent_token), "paired (config.json has agent_token)", config.path)) {
+        if (process.platform !== "win32") {
+            const mode = statSync(config.path).mode & 0o777;
+            check(mode === 0o600, "config.json is chmod 600", `mode ${mode.toString(8)}`);
+        }
+        const owner = process.env.RELAY_OWNER_USER_ID ?? loaded?.owner_user_id;
+        check(Boolean(owner), "owner pinned (owner_user_id)", owner ?? "missing — re-run `relaymessenger pair` or set RELAY_OWNER_USER_ID");
+        let origin = loaded.api_origin;
+        try {
+            origin = resolveApiOrigin(loaded.api_origin);
+            if (process.env.RELAY_API_ORIGIN) {
+                out(`info  RELAY_API_ORIGIN override active (${origin}) — development/testing only`);
+            }
+        }
+        catch (error) {
+            check(false, "RELAY_API_ORIGIN valid", String(error?.message ?? error));
+        }
+        try {
+            const client = new RelayClient(origin, loaded.agent_token);
+            const me = (await client.getMe());
+            const handle = me?.agent?.handle ?? me?.handle;
+            check(true, `API reachable (${origin})`, handle ? `@${handle}` : undefined);
+        }
+        catch (error) {
+            check(false, `API reachable (${origin})`, String(error?.message ?? error));
+        }
+    }
+    else {
+        out("     run `relaymessenger pair` to connect this machine to a Relay agent");
+    }
+    if (loaded?.agent_token) {
+        // Match `start`: durable state is scoped to the effective origin.
+        let effectiveOrigin = loaded.api_origin;
+        try {
+            effectiveOrigin = resolveApiOrigin(loaded.api_origin);
+        }
+        catch {
+            // Invalid override already reported above; fall back to the paired origin.
+        }
+        const runtimeHome = runtimeHomeForConfig({ ...loaded, api_origin: effectiveOrigin }, dirname(config.path));
+        try {
+            const state = readStateSnapshot(runtimeHome);
+            const pendingEvents = Object.values(state.pending_events).reduce((sum, queue) => sum + queue.length, 0);
+            const pendingApprovals = new ApprovalStore(runtimeHome).list().length;
+            out(`info  state: cursor=${state.cursor}, pending_events=${pendingEvents}, ` +
+                `pending_approvals=${pendingApprovals}, owner_conversation=${state.owner_conversation_id ?? "unset"} ` +
+                `(${join(runtimeHome, "state.json")})`);
+        }
+        catch (error) {
+            check(false, "runtime state readable", String(error));
+        }
+    }
+    else {
+        out("info  runtime state unavailable until this machine is paired");
+    }
+    for (const [engine, pkg] of Object.entries(ADAPTER_PACKAGES)) {
+        try {
+            const entrypoint = adapterEntrypoint(engine);
+            check(existsSync(entrypoint), `${engine} adapter installed (${pkg}@${ADAPTER_VERSIONS[engine]})`, entrypoint);
+        }
+        catch (error) {
+            check(false, `${engine} adapter installed (${pkg}@${ADAPTER_VERSIONS[engine]})`, String(error));
+        }
+    }
+    for (const [engine, spec] of Object.entries(EXTERNAL_ENGINE_SPECS)) {
+        const lookup = crossSpawn.sync(process.platform === "win32" ? "where.exe" : "which", [spec.command], {
+            encoding: "utf8",
+            windowsHide: true,
+        });
+        if (lookup.status !== 0) {
+            out(`info  ${engine}: not installed — ${spec.docsUrl}`);
+            continue;
+        }
+        const version = crossSpawn.sync(spec.command, spec.versionArgs, {
+            encoding: "utf8",
+            timeout: 20_000,
+            windowsHide: true,
+        });
+        check(version.status === 0, `${engine} binary present`, version.stdout?.trim() || version.stderr?.trim());
+        if (spec.checkArgs) {
+            const readiness = crossSpawn.sync(spec.command, spec.checkArgs, {
+                encoding: "utf8",
+                timeout: 30_000,
+                windowsHide: true,
+            });
+            check(readiness.status === 0, `${engine} ACP readiness`, readiness.stdout?.trim() || readiness.stderr?.trim());
+        }
+    }
+    // Warn (not fail) when Claude settings disable phone approvals entirely.
+    const bypass = claudeBypassWarning();
+    if (bypass)
+        out(`warn  ${bypass}`);
+    const codexConfig = join(homedir(), ".codex", "config.toml");
+    out(existsSync(codexConfig)
+        ? `info  codex config present (${codexConfig}); run \`relaymessenger install-codex\` to wire notify + approvals`
+        : "info  no ~/.codex/config.toml — install Codex or skip install-codex");
+    out("");
+    out(healthy ? "All checks passed." : "Some checks failed — see above.");
+    return healthy;
+}
+//# sourceMappingURL=doctor.js.map

package/dist/doctor.js.map

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

package/dist/engine/acp.d.ts

@@ -0,0 +1,69 @@
+import { type RequestPermissionRequest, type ToolCallUpdate } from "@agentclientprotocol/sdk";
+import type { EngineAdapter, SessionRef, TurnCallbacks, TurnResult } from "./types.js";
+import type { SessionStore } from "../store.js";
+import { type EngineName } from "./catalog.js";
+export declare const ADAPTER_PACKAGES: Record<string, string>;
+/** Versions must exactly match package.json; tests enforce the lock. */
+export declare const ADAPTER_VERSIONS: Record<string, string>;
+/** Resolve the installed, lockfile-pinned executable without invoking npm. */
+export declare function adapterEntrypoint(engine: "claude" | "codex"): string;
+export interface EngineProcessSpec {
+    command: string;
+    args: string[];
+    display: string;
+}
+/** Shell-free, deterministic process descriptor for one ACP runtime. */
+export declare function engineProcessSpec(engine: EngineName): EngineProcessSpec;
+export declare function engineEnv(parent?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
+/**
+ * Accumulates one turn's streamed assistant text. Chunks stream into the
+ * current message segment; a tool-call boundary ends the segment, so the next
+ * chunk starts a distinct message. Distinct segments join with a blank line —
+ * a plain "" join would fuse back-to-back messages into one word
+ * ("…the file." + "Created…" → "file.Created").
+ */
+export declare class AgentTextBuffer {
+    private readonly segments;
+    private open;
+    append(chunk: string): void;
+    /** Mark a message boundary: the next appended chunk starts a new segment. */
+    endSegment(): void;
+    /** Segments trimmed (no doubled blank lines), empty segments dropped. */
+    toString(): string;
+}
+/** Merge a sparse ACP tool-call update without erasing previously known fields. */
+export declare function mergeToolCall(previous: ToolCallUpdate | undefined, incoming: ToolCallUpdate): ToolCallUpdate;
+/**
+ * Flatten the security-relevant parts of an ACP tool call — raw input,
+ * affected locations, content — into one preview string for the approval
+ * card. Length is clamped downstream (head + tail) by the card builder.
+ */
+export declare function permissionDetail(toolCall: RequestPermissionRequest["toolCall"]): string | undefined;
+/** True only when the phone can display the full operation being approved. */
+export declare function permissionInputComplete(toolCall: RequestPermissionRequest["toolCall"]): boolean;
+export declare class AcpEngine implements EngineAdapter {
+    readonly engine: EngineName;
+    private readonly sessions;
+    private readonly log;
+    private child;
+    private connection;
+    private ctx;
+    private initialization;
+    private loadSessionSupported;
+    /** Live turn state keyed by ACP session id. */
+    private readonly turns;
+    /** conversation_id → ACP session + repository for the live process. */
+    private readonly liveSessions;
+    private permissionSeq;
+    constructor(engine: EngineName, sessions: SessionStore, log?: (line: string) => void);
+    private ensureConnected;
+    private connect;
+    private resetConnection;
+    private handleUpdate;
+    private handlePermission;
+    private openSession;
+    startTurn(ref: SessionRef, promptText: string, callbacks: TurnCallbacks): Promise<TurnResult>;
+    abort(ref: SessionRef): Promise<void>;
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=acp.d.ts.map

package/dist/engine/acp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp.d.ts","sourceRoot":"","sources":["../../src/engine/acp.ts"],"names":[],"mappings":"AAiBA,OAAO,EAML,KAAK,wBAAwB,EAG7B,KAAK,cAAc,EACpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EACV,aAAa,EAEb,UAAU,EACV,aAAa,EACb,UAAU,EACX,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EAGL,KAAK,UAAU,EAChB,MAAM,cAAc,CAAC;AAEtB,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAGnD,CAAC;AAEF,wEAAwE;AACxE,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAGnD,CAAC;AAIF,8EAA8E;AAC9E,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,CAKpE;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wEAAwE;AACxE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,iBAAiB,CAcvE;AAwDD,wBAAgB,SAAS,CAAC,MAAM,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAAC,UAAU,CAoBpF;AAED;;;;;;GAMG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IACzC,OAAO,CAAC,IAAI,CAAS;IAErB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAQ3B,6EAA6E;IAC7E,UAAU,IAAI,IAAI;IAIlB,yEAAyE;IACzE,QAAQ,IAAI,MAAM;CAMnB;AASD,mFAAmF;AACnF,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,cAAc,GAAG,SAAS,EACpC,QAAQ,EAAE,cAAc,GACvB,cAAc,CAOhB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,wBAAwB,CAAC,UAAU,CAAC,GAC7C,MAAM,GAAG,SAAS,CA+BpB;AAED,8EAA8E;AAC9E,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,wBAAwB,CAAC,UAAU,CAAC,GAC7C,OAAO,CAQT;AAED,qBAAa,SAAU,YAAW,aAAa;IAa3C,QAAQ,CAAC,MAAM,EAAE,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,GAAG;IAdtB,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,GAAG,CAA4B;IACvC,OAAO,CAAC,cAAc,CAA4B;IAClD,OAAO,CAAC,oBAAoB,CAAS;IACrC,+CAA+C;IAC/C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;IACtD,uEAAuE;IACvE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAyD;IACtF,OAAO,CAAC,aAAa,CAAK;gBAGf,MAAM,EAAE,UAAU,EACV,QAAQ,EAAE,YAAY,EACtB,GAAG,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAe;YAG3C,eAAe;YAcf,OAAO;IAkDrB,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,YAAY;YAsBN,gBAAgB;YAmChB,WAAW;IAmCnB,SAAS,CAAC,GAAG,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC;IAkB7F,KAAK,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAMrC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAM/B"}