crewx-agent-cli 0.2.6 → 0.2.7

package/README.md

@@ -1,7 +1,7 @@
 # CrewX CLI
 
-Connect an existing Codex, Claude Code, Pi, Hermes, or OpenClaw installation to
-a CrewX workspace. The runner stays on your machine, so the agent uses its
+Connect local coding harnesses to a CrewX workspace through native adapters or
+the embedded Agent Client Protocol runtime. The runner stays on your machine, so the agent uses its
 existing login, configuration, tools, and access to the selected working
 directory.
 
@@ -18,7 +18,7 @@ cd /path/to/project
 npx --yes crewx-agent-cli@latest --join <join-code>
 ```
 
-Node.js 22 or newer is required. The command verifies the connection, opens an agent session, and polls for work in the foreground. Closing the terminal or pressing `Ctrl+C` disconnects it. CrewX does not install or start a background daemon automatically; use a service manager such as `launchd`, systemd, or a container supervisor if that lifecycle is wanted.
+Node.js 22.13 or newer is required. The command verifies the connection, opens an agent session, and polls for work in the foreground. Closing the terminal or pressing `Ctrl+C` disconnects it. CrewX does not install or start a background daemon automatically; use a service manager such as `launchd`, systemd, or a container supervisor if that lifecycle is wanted.
 
 Join mode does not write `$XDG_CONFIG_HOME/crewx/config.json`. Useful options include:
 
@@ -72,6 +72,14 @@ second, and `--cwd` last. Use `--once` for one poll and
 period the runner backs off with jitter to at most 8 seconds, honors server
 retry guidance, and resets to the base cadence as soon as work appears.
 
+Compatible CrewX servers may lease multiple assignments in one acknowledged
+page. The daemon runs at most two independent conversations at once by default,
+while replies belonging to the same durable conversation remain serialized in
+arrival order. Set `CREWX_MAX_CONCURRENT_ASSIGNMENTS` to a value from 1 through
+8 to tune that local process bound. The delivery cursor advances only after
+every assignment in the page has a delivered terminal outcome, so parallel
+execution does not weaken outbox replay or claim fencing.
+
 Assignments carry an opaque claim-fencing token. The runner includes it on
 heartbeats, messages, errors, and lifecycle events; CrewX rotates it when work
 is reassigned so a replaced runner cannot apply late results. The token is
@@ -101,15 +109,47 @@ inherited pipe that closes immediately after startup, rather than through the
 exec environment. This reduces accidental exposure but does not change the OS
 account trust boundary.
 
-## Built-in adapters
+## Embedded ACP runtime
+
+New CrewX profiles use the pinned `acpx@0.13.0` embedded runtime. Its canonical
+harness IDs are `pi`, `openclaw`, `codex`, `claude`, `gemini`, `cursor`,
+`copilot`, `droid`, `fast-agent`, `grok-build`, `iflow`, `kilocode`, `kimi`,
+`kiro`, `mux`, `opencode`, `pool`, `qoder`, `qwen`, `trae`, and `zeroclaw`.
+The corresponding harness executable and its normal authentication must be
+available to the Bridge OS user. Some acpx adapters use pinned/ranged npm
+launchers on first use and therefore require npm registry access.
+
+CrewX embeds `acpx/runtime` in an assignment-scoped worker rather than invoking
+the acpx CLI. Conversations receive stable persistent ACP session keys;
+cancellation calls ACP session cancellation; text, status, tool, usage, and
+terminal results are normalized into CrewX events. Session records and event
+logs stay below `${ACPX_STATE_HOME:-${XDG_STATE_HOME:-~/.local/state}}/crewx/acpx`
+in owner-only directories and never persist the assignment proxy credential.
+
+ACP permission prompts map `read_only` and chat-only profiles to approved reads
+with non-read requests rejected. `standard` and `full_access` approve harness
+permission requests non-interactively. ACP approval is not an operating-system
+sandbox and ACP does not define a portable workspace-write boundary: use the
+harness's own sandbox plus a dedicated OS account, container, or VM when that
+boundary matters.
+
+Exercise any ACP harness locally with, for example:
+
+```bash
+crewx run gemini "Summarize this repository"
+crewx run claude "Review the current diff" --transport acp
+```
+
+## Native compatibility adapters
 
 - **Codex** runs `codex exec --json … -`. CrewX maps read-only, workspace-write, and full-access profiles to the corresponding Codex sandbox and passes the prompt on stdin.
 - **Claude Code** runs `claude --print --output-format stream-json --verbose`. CrewX maps its profile to plan mode, non-interactive workspace edits, or skipped permission prompts and passes the prompt on stdin.
 - **Pi** runs `pi --mode json --no-approve`. CrewX deliberately ignores project-local Pi settings, extensions, skills, prompts, and themes on each daemon run. Read-only and chat-only profiles receive a restricted tool allowlist. Global Pi configuration still applies. Pi itself is not an operating-system sandbox.
 - **Hermes** runs `hermes acp` and speaks ACP v1 over stdio for session creation, model selection, prompt delivery, progress, permission requests, and cancellation. Workspace-write maps to Hermes `accept_edits`; full access maps to `dont_ask`. Hermes does not expose a trustworthy read-only or chat-only ACP mode, so CrewX rejects those profiles instead of presenting a false boundary. CrewX passes a configured model to Hermes for resolution.
-- **OpenClaw** uses a persistent agent with JSON output, a collision-resistant CrewX assignment session key, and a mode-`0600` temporary prompt file that is removed after the run. New CrewX profiles receive a managed OpenClaw ID; when that ID is missing locally, CrewX creates it inside the Bridge-approved assignment folder with OpenClaw's non-interactive agent command. Advanced profiles may select an existing OpenClaw agent instead. Before connecting and before every assignment, CrewX verifies the exact agent workspace and task-session sandbox. A sandboxed session must mount the approved directory read-write at its runtime workdir. OpenClaw continues to own its persistent tool policy and approval behavior.
+- **OpenClaw** uses a persistent agent with JSON output, a collision-resistant CrewX conversation session key, and a mode-`0600` temporary prompt file that is removed after the run. Replies in one CrewX thread reuse that session key, while separate top-level asks remain isolated. New CrewX profiles receive a managed OpenClaw ID; when that ID is missing locally, CrewX creates it inside the Bridge-approved assignment folder with OpenClaw's non-interactive agent command. Advanced profiles may select an existing OpenClaw agent instead. Before connecting and before every assignment, CrewX verifies the exact agent workspace and task-session sandbox. A sandboxed session must mount the approved directory read-write at its runtime workdir. OpenClaw continues to own its persistent tool policy and approval behavior.
 
-`crewx doctor` probes all five binaries. Runtime profile changes are read before every assignment, so supported model, permission, chat-only, working-directory, token, and deactivation changes do not require reconnecting. Chat-only and deactivated agents cannot receive task runs.
+Existing `runtime=local` profiles retain the native adapters above. `crewx doctor`
+probes all 22 supported harness IDs. Runtime profile changes are read before every assignment, so supported model, permission, chat-only, working-directory, token, and deactivation changes do not require reconnecting. Chat-only and deactivated agents cannot receive task runs.
 
 The assignment capability proxy enforces the server profile locally:
 `read_only` and chat-only profiles may use only GET operations; `standard` and

package/dist/acp-worker.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=acp-worker.d.ts.map

package/dist/acp-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp-worker.d.ts","sourceRoot":"","sources":["../src/acp-worker.ts"],"names":[],"mappings":""}

package/dist/acp-worker.js

@@ -0,0 +1,176 @@
+#!/usr/bin/env node
+import { randomUUID } from "node:crypto";
+import { chmod, mkdir } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join, resolve } from "node:path";
+import { createAcpRuntime, createAgentRegistry, createRuntimeStore, } from "acpx/runtime";
+import { ACPX_HARNESSES } from "crewx-agent-protocol";
+const READ_KINDS = new Set(["read", "search", "fetch", "think"]);
+function workerStateDir(environment = process.env) {
+    const base = environment.ACPX_STATE_HOME?.trim() ||
+        environment.XDG_STATE_HOME?.trim() ||
+        join(homedir(), ".local", "state");
+    return resolve(base, "crewx", "acpx");
+}
+function secureRuntimeStore(stateDir) {
+    const store = createRuntimeStore({ stateDir });
+    const secureEventPath = (record) => {
+        record.eventLog.active_path = join(stateDir, "events", `${encodeURIComponent(record.acpxRecordId)}.stream.ndjson`);
+        return record;
+    };
+    return {
+        async load(sessionId) {
+            const record = await store.load(sessionId);
+            return record ? secureEventPath(record) : undefined;
+        },
+        async save(record) {
+            await store.save(secureEventPath(record));
+        },
+    };
+}
+async function readRequest() {
+    process.stdin.setEncoding("utf8");
+    let raw = "";
+    for await (const chunk of process.stdin)
+        raw += chunk;
+    const value = JSON.parse(raw);
+    if (typeof value.harness !== "string" ||
+        !ACPX_HARNESSES.includes(value.harness) ||
+        typeof value.prompt !== "string" ||
+        !value.prompt.trim() ||
+        typeof value.cwd !== "string" ||
+        !value.cwd.trim() ||
+        typeof value.sessionKey !== "string" ||
+        !/^crewx-[a-f0-9]{48}$/.test(value.sessionKey) ||
+        typeof value.timeoutMs !== "number" ||
+        !Number.isSafeInteger(value.timeoutMs) ||
+        value.timeoutMs <= 0) {
+        throw new Error("CrewX supplied an invalid ACP worker request.");
+    }
+    return value;
+}
+function emit(value) {
+    process.stdout.write(`${JSON.stringify(value)}\n`);
+}
+function publicEvent(event) {
+    if (event.type !== "tool_call")
+        return event;
+    return {
+        type: event.type,
+        text: event.text,
+        ...(event.tag ? { tag: event.tag } : {}),
+        ...(event.toolCallId ? { toolCallId: event.toolCallId } : {}),
+        ...(event.status ? { status: event.status } : {}),
+        ...(event.title ? { title: event.title } : {}),
+        ...(event.kind ? { kind: event.kind } : {}),
+        ...(event.locations ? { locations: event.locations } : {}),
+    };
+}
+async function restrictedPermissionDecision(request) {
+    return READ_KINDS.has(request.inferredKind ?? "")
+        ? { outcome: "allow_once" }
+        : { outcome: "reject_once" };
+}
+async function main() {
+    process.umask(0o077);
+    const request = await readRequest();
+    const stateDir = workerStateDir();
+    await mkdir(stateDir, { recursive: true, mode: 0o700 });
+    await chmod(stateDir, 0o700);
+    await mkdir(join(stateDir, "events"), { recursive: true, mode: 0o700 });
+    await chmod(join(stateDir, "events"), 0o700);
+    const restricted = request.profile?.chatOnly === true ||
+        request.profile?.permissionPreset === "read_only";
+    const controller = new AbortController();
+    let turn;
+    let handle;
+    const stop = () => {
+        controller.abort();
+        void turn?.cancel({ reason: "CrewX assignment cancelled" });
+    };
+    process.once("SIGINT", stop);
+    process.once("SIGTERM", stop);
+    const runtime = createAcpRuntime({
+        cwd: request.cwd,
+        sessionStore: secureRuntimeStore(stateDir),
+        agentRegistry: createAgentRegistry(),
+        permissionMode: restricted ? "approve-reads" : "approve-all",
+        nonInteractivePermissions: "deny",
+        timeoutMs: request.timeoutMs,
+        probeAgent: request.harness,
+        ...(restricted
+            ? { onPermissionRequest: restrictedPermissionDecision }
+            : {}),
+    });
+    try {
+        handle = await runtime.ensureSession({
+            sessionKey: request.sessionKey,
+            agent: request.harness,
+            mode: "persistent",
+            cwd: request.cwd,
+            sessionOptions: {
+                ...(request.profile?.model ? { model: request.profile.model } : {}),
+                ...(request.profile?.chatOnly ? { allowedTools: [] } : {}),
+            },
+        });
+        if (request.profile?.model) {
+            const status = await runtime.getStatus({
+                handle,
+                signal: controller.signal,
+            });
+            if (status.models &&
+                status.models.currentModelId !== request.profile.model &&
+                status.models.availableModelIds.includes(request.profile.model)) {
+                await runtime.setConfigOption({
+                    handle,
+                    key: "model",
+                    value: request.profile.model,
+                });
+            }
+        }
+        turn = runtime.startTurn({
+            handle,
+            text: request.prompt,
+            mode: "prompt",
+            requestId: randomUUID(),
+            timeoutMs: request.timeoutMs,
+            signal: controller.signal,
+        });
+        for await (const event of turn.events) {
+            emit({ type: "event", event: publicEvent(event) });
+        }
+        const result = await turn.result;
+        emit({ type: "result", result });
+        if (result.status === "failed")
+            process.exitCode = 1;
+    }
+    finally {
+        process.removeListener("SIGINT", stop);
+        process.removeListener("SIGTERM", stop);
+        if (handle) {
+            await runtime
+                .close({
+                handle,
+                reason: "CrewX turn complete",
+                discardPersistentState: false,
+            })
+                .catch(() => undefined);
+        }
+    }
+}
+main().catch((error) => {
+    emit({
+        type: "error",
+        error: {
+            message: error instanceof Error ? error.message : String(error),
+            ...(typeof error === "object" &&
+                error !== null &&
+                "code" in error &&
+                typeof error.code === "string"
+                ? { code: error.code }
+                : {}),
+        },
+    });
+    process.exitCode = 1;
+});
+//# sourceMappingURL=acp-worker.js.map

package/dist/acp-worker.js.map

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

package/dist/adapters.d.ts

@@ -1,5 +1,5 @@
-import { type ChildProcessWithoutNullStreams, type SpawnOptionsWithoutStdio } from 'node:child_process';
-import { type AgentAdapter } from 'crewx-agent-protocol';
+import { type ChildProcessWithoutNullStreams, type SpawnOptionsWithoutStdio } from "node:child_process";
+import { type AgentAdapter } from "crewx-agent-protocol";
 export declare function adapterProbePlan(adapter: AgentAdapter): {
     args: readonly string[];
     timeoutMs: number;
@@ -7,28 +7,29 @@ export declare function adapterProbePlan(adapter: AgentAdapter): {
 export interface AdapterInvocation {
     command: string;
     args: string[];
-    output: 'jsonl' | 'json' | 'text';
+    output: "jsonl" | "json" | "text";
     prompt: {
-        type: 'stdin';
+        type: "stdin";
     } | {
-        type: 'argument';
+        type: "argument";
         index: number;
     } | {
-        type: 'file';
+        type: "file";
         flag: string;
     };
 }
 export interface AgentRuntimeProfile {
     model?: string;
-    permissionPreset?: 'read_only' | 'standard' | 'full_access';
+    permissionPreset?: "read_only" | "standard" | "full_access";
     chatOnly?: boolean;
     sessionKey?: string;
     runtimeAgentId?: string;
+    transport?: "native" | "acp";
 }
 export interface ParsedAdapterLine {
     raw: unknown;
     message?: string;
-    role?: 'assistant' | 'tool';
+    role?: "assistant" | "tool";
     eventType?: string;
 }
 export interface AdapterRunResult {
@@ -45,7 +46,7 @@ export declare function buildAdapterInvocation(adapter: AgentAdapter, profile?:
 export declare function parseCodingCommand(value: string): string[];
 export declare function parseAdapterLine(adapter: AgentAdapter, line: string): ParsedAdapterLine;
 export declare function publicOpenClawDiagnostic(value: string): string;
-export declare function verifyOpenClawRuntime(options: Pick<RunAdapterOptions, 'cwd' | 'environment' | 'spawnProcess'> & {
+export declare function verifyOpenClawRuntime(options: Pick<RunAdapterOptions, "cwd" | "environment" | "spawnProcess"> & {
     profile: AgentRuntimeProfile;
 }): Promise<void>;
 export interface RunAdapterOptions {
@@ -61,7 +62,7 @@ export interface RunAdapterOptions {
     signal?: AbortSignal | undefined;
     spawnProcess?: SpawnProcess | undefined;
     onStdout?: ((line: string, parsed: ParsedAdapterLine) => void) | undefined;
-    onMessage?: ((message: string, role: 'assistant' | 'tool') => void) | undefined;
+    onMessage?: ((message: string, role: "assistant" | "tool") => void) | undefined;
     onStderr?: ((line: string) => void) | undefined;
 }
 /**
@@ -71,6 +72,7 @@ export interface RunAdapterOptions {
  * supplied separately by the assignment executor.
  */
 export declare function runtimeEnvironment(environment?: NodeJS.ProcessEnv, controlEnvironment?: NodeJS.ProcessEnv, inherited?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
+export declare function usesAcpRuntime(adapter: AgentAdapter, profile?: AgentRuntimeProfile): boolean;
 export declare function runAdapter(options: RunAdapterOptions): Promise<AdapterRunResult>;
 export declare function probeAdapter(adapter: AgentAdapter, spawnProcess?: SpawnProcess, timeoutMs?: number): Promise<{
     available: boolean;

package/dist/adapters.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../src/adapters.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../src/adapters.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,8BAA8B,EACnC,KAAK,wBAAwB,EAC9B,MAAM,oBAAoB,CAAC;AAQ5B,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,sBAAsB,CAAC;AAiC9B,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,YAAY,GAAG;IACvD,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB,CASA;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IAClC,MAAM,EACF;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,GACjB;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GACnC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACpC;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,WAAW,GAAG,UAAU,GAAG,aAAa,CAAC;IAC5D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC;CAC9B;AAWD,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,OAAO,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IAC9B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,MAAM,YAAY,GAAG,CACzB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,EAAE,wBAAwB,KAC9B,8BAA8B,CAAC;AA6EpC,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAQxD;AAED,mFAAmF;AACnF,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,YAAY,EACrB,OAAO,GAAE,mBAAwB,EACjC,aAAa,CAAC,EAAE,MAAM,GACrB,iBAAiB,CA2GnB;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAiD1D;AAoED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,YAAY,EACrB,IAAI,EAAE,MAAM,GACX,iBAAiB,CA6DnB;AAmBD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAI9D;AAkHD,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,IAAI,CAAC,iBAAiB,EAAE,KAAK,GAAG,aAAa,GAAG,cAAc,CAAC,GAAG;IACzE,OAAO,EAAE,mBAAmB,CAAC;CAC9B,GACA,OAAO,CAAC,IAAI,CAAC,CA8Nf;AAmCD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;IAC1C,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,SAAS,CAAC;IAC5C,kBAAkB,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,SAAS,CAAC;IACnD,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACjC,YAAY,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAC3E,SAAS,CAAC,EACR,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACtE,QAAQ,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CACjD;AAQD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,GAAE,MAAM,CAAC,UAAe,EACnC,kBAAkB,GAAE,MAAM,CAAC,UAAe,EAC1C,SAAS,GAAE,MAAM,CAAC,UAAwB,GACzC,MAAM,CAAC,UAAU,CAWnB;AAumBD,wBAAgB,cAAc,CAC5B,OAAO,EAAE,YAAY,EACrB,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAST;AAmLD,wBAAsB,UAAU,CAC9B,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,gBAAgB,CAAC,CA8B3B;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE,YAAY,EACrB,YAAY,GAAE,YAAoC,EAClD,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA+GnE"}