@tickernelz/paperclip-pro-adapter-openclaw-gateway 2026.925.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 Paperclip AI
+Copyright (c) 2026 Zhafron Adani Kautsar (paperclip-pro fork modifications)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,85 @@
+# OpenClaw Gateway Adapter
+
+This document describes how `@tickernelz/paperclip-pro-adapter-openclaw-gateway` invokes OpenClaw over the Gateway protocol.
+
+## Transport
+
+This adapter always uses WebSocket gateway transport.
+
+- URL must be `ws://` or `wss://`
+- Connect flow follows gateway protocol:
+1. receive `connect.challenge`
+2. send `req connect` (protocol/client/auth/device payload)
+3. send `req agent`
+4. wait for completion via `req agent.wait`
+5. stream `event agent` frames into Paperclip logs/transcript parsing
+
+## Auth Modes
+
+Gateway credentials can be provided in any of these ways:
+
+- `authToken` / `token` in adapter config
+- `headers.x-openclaw-token`
+- `headers.x-openclaw-auth` (legacy)
+- `password` (shared password mode)
+
+When a token is present and `authorization` header is missing, the adapter derives `Authorization: Bearer <token>`.
+
+## Device Auth
+
+By default the adapter sends a signed `device` payload in `connect` params.
+
+- set `disableDeviceAuth=true` to omit device signing
+- set `devicePrivateKeyPem` to pin a stable signing key
+- without `devicePrivateKeyPem`, the adapter generates an ephemeral Ed25519 keypair per run
+- when `autoPairOnFirstConnect` is enabled (default), the adapter handles one initial `pairing required` by calling `device.pair.list` + `device.pair.approve` over shared auth, then retries once.
+
+## Session Strategy
+
+The adapter supports the same session routing model as HTTP OpenClaw mode:
+
+- `sessionKeyStrategy=issue|fixed|run`
+- `sessionKey` is used when strategy is `fixed`
+
+Resolved session key is sent as `agent.sessionKey`.
+
+## Payload Mapping
+
+The agent request is built as:
+
+- required fields:
+  - `message` (wake text plus optional `payloadTemplate.message`/`payloadTemplate.text` prefix)
+  - `idempotencyKey` (Paperclip `runId`)
+  - `sessionKey` (resolved strategy)
+- optional additions:
+  - all `payloadTemplate` fields merged in
+  - `agentId` from config if set and not already in template
+
+## Timeouts
+
+- `timeoutSec` controls adapter-level request budget
+- `waitTimeoutMs` controls `agent.wait.timeoutMs`
+
+If `agent.wait` returns `timeout`, adapter returns `openclaw_gateway_wait_timeout`.
+
+## Log Format
+
+Structured gateway event logs use:
+
+- `[openclaw-gateway] ...` for lifecycle/system logs
+- `[openclaw-gateway:event] run=<id> stream=<stream> data=<json>` for `event agent` frames
+
+UI/CLI parsers consume these lines to render transcript updates.
+
+## No-remote-git contract
+
+Like every Paperclip adapter, this one must treat the local execution-workspace
+cwd as the only persistence boundary across runs — no `git push` from runtime
+code, no assuming a `git remote` exists. The gateway transport here doesn't
+touch the workspace directly, but if you extend the adapter to ship code to
+the OpenClaw side, use the round-trip helpers in `@tickernelz/paperclip-pro-adapter-utils`
+(`prepareWorkspaceForSshExecution` → `restoreWorkspaceFromSshExecution`)
+rather than reaching for a git remote. See
+[`packages/adapters/AUTHORING.md`](../AUTHORING.md#no-remote-git-contract-cross-run-persistence)
+for the full contract and the pinning test at
+[`packages/adapter-utils/src/ssh-fixture.test.ts`](../../adapter-utils/src/ssh-fixture.test.ts).

package/dist/cli/format-event.d.ts

@@ -0,0 +1,2 @@
+export declare function printOpenClawGatewayStreamEvent(raw: string, debug: boolean): void;
+//# sourceMappingURL=format-event.d.ts.map

package/dist/cli/format-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-event.d.ts","sourceRoot":"","sources":["../../src/cli/format-event.ts"],"names":[],"mappings":"AAEA,wBAAgB,+BAA+B,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAoBjF"}

package/dist/cli/format-event.js

@@ -0,0 +1,20 @@
+import pc from "picocolors";
+export function printOpenClawGatewayStreamEvent(raw, debug) {
+    const line = raw.trim();
+    if (!line)
+        return;
+    if (!debug) {
+        console.log(line);
+        return;
+    }
+    if (line.startsWith("[openclaw-gateway:event]")) {
+        console.log(pc.cyan(line));
+        return;
+    }
+    if (line.startsWith("[openclaw-gateway]")) {
+        console.log(pc.blue(line));
+        return;
+    }
+    console.log(pc.gray(line));
+}
+//# sourceMappingURL=format-event.js.map

package/dist/cli/format-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-event.js","sourceRoot":"","sources":["../../src/cli/format-event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,MAAM,UAAU,+BAA+B,CAAC,GAAW,EAAE,KAAc;IACzE,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACxB,IAAI,CAAC,IAAI;QAAE,OAAO;IAElB,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClB,OAAO;IACT,CAAC;IAED,IAAI,IAAI,CAAC,UAAU,CAAC,0BAA0B,CAAC,EAAE,CAAC;QAChD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3B,OAAO;IACT,CAAC;IAED,IAAI,IAAI,CAAC,UAAU,CAAC,oBAAoB,CAAC,EAAE,CAAC;QAC1C,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3B,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAC7B,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,2 @@
+export { printOpenClawGatewayStreamEvent } from "./format-event.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,+BAA+B,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/cli/index.js

@@ -0,0 +1,2 @@
+export { printOpenClawGatewayStreamEvent } from "./format-event.js";
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,+BAA+B,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export declare const type = "openclaw_gateway";
+export declare const label = "OpenClaw Gateway";
+export declare const models: {
+    id: string;
+    label: string;
+}[];
+export declare const agentConfigurationDoc = "# openclaw_gateway agent configuration\n\nAdapter: openclaw_gateway\n\nUse when:\n- You want Paperclip to invoke OpenClaw over the Gateway WebSocket protocol.\n- You want native gateway auth/connect semantics instead of HTTP /v1/responses or /hooks/*.\n\nDon't use when:\n- You only expose OpenClaw HTTP endpoints.\n- Your deployment does not permit outbound WebSocket access from the Paperclip server.\n\nCore fields:\n- url (string, required): OpenClaw gateway WebSocket URL (ws:// or wss://)\n- headers (object, optional): handshake headers; supports x-openclaw-token / x-openclaw-auth\n- authToken (string, optional): shared gateway token override\n- password (string, optional): gateway shared password, if configured\n\nGateway connect identity fields:\n- clientId (string, optional): gateway client id (default gateway-client)\n- clientMode (string, optional): gateway client mode (default backend)\n- clientVersion (string, optional): client version string\n- role (string, optional): gateway role (default operator)\n- scopes (string[] | comma string, optional): gateway scopes (default [\"operator.admin\"])\n- disableDeviceAuth (boolean, optional): disable signed device payload in connect params (default false)\n\nRequest behavior fields:\n- payloadTemplate (object, optional): additional fields merged into gateway agent params\n- workspaceRuntime (object, optional): reserved workspace runtime metadata; workspace runtime services are manually controlled from the workspace UI and are not auto-started by heartbeats\n- timeoutSec (number, optional): adapter timeout in seconds (default 120)\n- waitTimeoutMs (number, optional): agent.wait timeout override (default timeoutSec * 1000)\n- autoPairOnFirstConnect (boolean, optional): on first \"pairing required\", attempt device.pair.list/device.pair.approve via shared auth, then retry once (default true)\n- paperclipApiUrl (string, optional): absolute Paperclip base URL advertised in wake text\n- claimedApiKeyPath (string, optional): path to the claimed API key JSON file read by the agent at wake time (default ~/.openclaw/workspace/paperclip-claimed-api-key.json)\n\nSession routing fields:\n- sessionKeyStrategy (string, optional): issue (default), fixed, or run\n- sessionKey (string, optional): fixed session key when strategy=fixed (default paperclip)\n\nWake payload notes:\n- Paperclip wake context is embedded into the generated message text\n- No top-level paperclip field is sent; the gateway agent schema rejects unknown root params\n\nStandard result metadata supported:\n- meta.runtimeServices (array, optional): normalized adapter-managed runtime service reports\n- meta.previewUrl (string, optional): shorthand single preview URL\n- meta.previewUrls (string[], optional): shorthand multiple preview URLs\n";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,IAAI,qBAAqB,CAAC;AACvC,eAAO,MAAM,KAAK,qBAAqB,CAAC;AAExC,eAAO,MAAM,MAAM,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAO,CAAC;AAE1D,eAAO,MAAM,qBAAqB,0uFA+CjC,CAAC"}

package/dist/index.js

@@ -0,0 +1,52 @@
+export const type = "openclaw_gateway";
+export const label = "OpenClaw Gateway";
+export const models = [];
+export const agentConfigurationDoc = `# openclaw_gateway agent configuration
+
+Adapter: openclaw_gateway
+
+Use when:
+- You want Paperclip to invoke OpenClaw over the Gateway WebSocket protocol.
+- You want native gateway auth/connect semantics instead of HTTP /v1/responses or /hooks/*.
+
+Don't use when:
+- You only expose OpenClaw HTTP endpoints.
+- Your deployment does not permit outbound WebSocket access from the Paperclip server.
+
+Core fields:
+- url (string, required): OpenClaw gateway WebSocket URL (ws:// or wss://)
+- headers (object, optional): handshake headers; supports x-openclaw-token / x-openclaw-auth
+- authToken (string, optional): shared gateway token override
+- password (string, optional): gateway shared password, if configured
+
+Gateway connect identity fields:
+- clientId (string, optional): gateway client id (default gateway-client)
+- clientMode (string, optional): gateway client mode (default backend)
+- clientVersion (string, optional): client version string
+- role (string, optional): gateway role (default operator)
+- scopes (string[] | comma string, optional): gateway scopes (default ["operator.admin"])
+- disableDeviceAuth (boolean, optional): disable signed device payload in connect params (default false)
+
+Request behavior fields:
+- payloadTemplate (object, optional): additional fields merged into gateway agent params
+- workspaceRuntime (object, optional): reserved workspace runtime metadata; workspace runtime services are manually controlled from the workspace UI and are not auto-started by heartbeats
+- timeoutSec (number, optional): adapter timeout in seconds (default 120)
+- waitTimeoutMs (number, optional): agent.wait timeout override (default timeoutSec * 1000)
+- autoPairOnFirstConnect (boolean, optional): on first "pairing required", attempt device.pair.list/device.pair.approve via shared auth, then retry once (default true)
+- paperclipApiUrl (string, optional): absolute Paperclip base URL advertised in wake text
+- claimedApiKeyPath (string, optional): path to the claimed API key JSON file read by the agent at wake time (default ~/.openclaw/workspace/paperclip-claimed-api-key.json)
+
+Session routing fields:
+- sessionKeyStrategy (string, optional): issue (default), fixed, or run
+- sessionKey (string, optional): fixed session key when strategy=fixed (default paperclip)
+
+Wake payload notes:
+- Paperclip wake context is embedded into the generated message text
+- No top-level paperclip field is sent; the gateway agent schema rejects unknown root params
+
+Standard result metadata supported:
+- meta.runtimeServices (array, optional): normalized adapter-managed runtime service reports
+- meta.previewUrl (string, optional): shorthand single preview URL
+- meta.previewUrls (string[], optional): shorthand multiple preview URLs
+`;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,IAAI,GAAG,kBAAkB,CAAC;AACvC,MAAM,CAAC,MAAM,KAAK,GAAG,kBAAkB,CAAC;AAExC,MAAM,CAAC,MAAM,MAAM,GAAoC,EAAE,CAAC;AAE1D,MAAM,CAAC,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+CpC,CAAC"}

package/dist/server/execute-dispatch.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=execute-dispatch.test.d.ts.map

package/dist/server/execute-dispatch.test.d.ts.map

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

package/dist/server/execute-dispatch.test.js

@@ -0,0 +1,192 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+const websocketState = vi.hoisted(() => ({
+    connectionAttempts: 0,
+    failConnectAttempts: 0,
+    failAgentRequests: 0,
+    events: [],
+    messages: [],
+}));
+vi.mock("ws", async () => {
+    const { EventEmitter } = await import("node:events");
+    class FakeWebSocket extends EventEmitter {
+        static OPEN = 1;
+        readyState = FakeWebSocket.OPEN;
+        attempt;
+        constructor() {
+            super();
+            this.attempt = ++websocketState.connectionAttempts;
+            websocketState.events.push(`construct:${this.attempt}`);
+            queueMicrotask(() => {
+                if (this.attempt <= websocketState.failConnectAttempts) {
+                    this.emit("error", new Error("ECONNREFUSED"));
+                    return;
+                }
+                this.emit("open");
+                this.emit("message", JSON.stringify({
+                    type: "event",
+                    event: "connect.challenge",
+                    payload: { nonce: "test-nonce" },
+                }));
+            });
+        }
+        send(payload) {
+            const request = JSON.parse(payload);
+            if (request.method === "agent")
+                websocketState.messages.push(request.params?.message ?? "");
+            websocketState.events.push(`send:${request.method}`);
+            if (request.method === "agent" && websocketState.failAgentRequests > 0) {
+                websocketState.failAgentRequests--;
+                queueMicrotask(() => {
+                    this.emit("close", 1006, Buffer.from("ECONNRESET"));
+                });
+                return;
+            }
+            const responsePayload = request.method === "connect"
+                ? { protocol: 3 }
+                : { status: "ok", runId: "remote-run-1", summary: "done" };
+            queueMicrotask(() => {
+                this.emit("message", JSON.stringify({
+                    type: "res",
+                    id: request.id,
+                    ok: true,
+                    payload: responsePayload,
+                }));
+            });
+        }
+        close() { }
+    }
+    return { WebSocket: FakeWebSocket };
+});
+import { execute } from "./execute.js";
+function createContext(input = {}) {
+    return {
+        runId: "run-1",
+        agent: {
+            id: "agent-1",
+            companyId: "company-1",
+            name: "OpenClaw Agent",
+            adapterType: "openclaw_gateway",
+            adapterConfig: {},
+        },
+        runtime: {
+            sessionId: null,
+            sessionParams: null,
+            sessionDisplayId: null,
+            taskKey: null,
+        },
+        config: {
+            url: "ws://127.0.0.1:18789",
+            disableDeviceAuth: true,
+            timeoutSec: 1,
+        },
+        context: {
+            issueId: "issue-1",
+            taskId: "issue-1",
+            wakeReason: "interaction_resolved",
+        },
+        onLog: input.onLog ?? (async () => { }),
+        onDispatch: input.onDispatch,
+    };
+}
+describe("openclaw_gateway execute dispatch boundary", () => {
+    beforeEach(() => {
+        websocketState.connectionAttempts = 0;
+        websocketState.failConnectAttempts = 0;
+        websocketState.failAgentRequests = 0;
+        websocketState.events = [];
+        websocketState.messages = [];
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+    });
+    it.each([false, true])("sends conversation policy without the issue-completion workflow (resumed=%s)", async (resumed) => {
+        const ctx = createContext();
+        const directive = "Chat directive: clarify goals and hand plans off to project tasks.";
+        ctx.context = {
+            ...ctx.context,
+            conversationMode: true,
+            paperclipTaskMarkdown: directive,
+            paperclipTaskMarkdownCompact: directive,
+            paperclipWake: {
+                reason: "issue_commented",
+                issue: { id: "issue-1", workMode: "planning", status: "in_progress" },
+                interactionKind: "request_confirmation",
+                interactionStatus: "accepted",
+            },
+        };
+        if (resumed)
+            ctx.runtime.sessionId = "prior-session";
+        const result = await execute(ctx);
+        expect(result.exitCode).toBe(0);
+        expect(websocketState.messages).toHaveLength(1);
+        const prompt = websocketState.messages[0];
+        expect(prompt).toContain(directive);
+        expect(prompt).toContain("X-Paperclip-Run-Id");
+        expect(prompt).not.toContain("Execution contract:");
+        expect(prompt).not.toContain("Create child issues");
+        expect(prompt).not.toContain('"status":"done"');
+        expect(prompt).not.toContain("GET /api/issues/{issueId}/comments");
+    });
+    it("reports dispatch after transport setup and before the remote agent request", async () => {
+        const onDispatch = vi.fn(() => {
+            websocketState.events.push("dispatch");
+        });
+        const result = await execute(createContext({ onDispatch }));
+        expect(result).toMatchObject({ exitCode: 0 });
+        expect(onDispatch).toHaveBeenCalledTimes(1);
+        expect(websocketState.events).toEqual([
+            "construct:1",
+            "send:connect",
+            "dispatch",
+            "send:agent",
+        ]);
+    });
+    it("retains the continuation gate through transient connection backoff", async () => {
+        vi.useFakeTimers();
+        websocketState.failConnectAttempts = 1;
+        let resolveBackoff;
+        const backoffReached = new Promise((resolve) => {
+            resolveBackoff = resolve;
+        });
+        let resolveAuthorityChange;
+        const authorityChange = new Promise((resolve) => {
+            resolveAuthorityChange = resolve;
+        });
+        const onDispatch = vi.fn(resolveAuthorityChange);
+        const resultPromise = execute(createContext({
+            onDispatch,
+            onLog: async (_stream, chunk) => {
+                if (chunk.includes("transient error, retry"))
+                    resolveBackoff();
+            },
+        }));
+        await backoffReached;
+        expect(websocketState.connectionAttempts).toBe(1);
+        expect(onDispatch).not.toHaveBeenCalled();
+        let authorityChangeSettled = false;
+        void authorityChange.then(() => {
+            authorityChangeSettled = true;
+        });
+        await vi.advanceTimersByTimeAsync(0);
+        expect(authorityChangeSettled).toBe(false);
+        await vi.advanceTimersByTimeAsync(2_000);
+        const result = await resultPromise;
+        await authorityChange;
+        expect(result).toMatchObject({ exitCode: 0 });
+        expect(websocketState.connectionAttempts).toBe(2);
+        expect(onDispatch).toHaveBeenCalledTimes(1);
+        expect(authorityChangeSettled).toBe(true);
+    });
+    it("does not retry after the remote-work boundary has been crossed", async () => {
+        websocketState.failAgentRequests = 1;
+        const onDispatch = vi.fn();
+        const result = await execute(createContext({ onDispatch }));
+        expect(result).toMatchObject({
+            exitCode: 1,
+            errorCode: "openclaw_gateway_request_failed",
+        });
+        expect(websocketState.connectionAttempts).toBe(1);
+        expect(onDispatch).toHaveBeenCalledTimes(1);
+    });
+});
+//# sourceMappingURL=execute-dispatch.test.js.map

package/dist/server/execute-dispatch.test.js.map

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

package/dist/server/execute.d.ts

@@ -0,0 +1,21 @@
+import type { AdapterExecutionContext, AdapterExecutionResult } from "@tickernelz/paperclip-pro-adapter-utils";
+type SessionKeyStrategy = "fixed" | "issue" | "run";
+export declare function resolveSessionKey(input: {
+    strategy: SessionKeyStrategy;
+    configuredSessionKey: string | null;
+    agentId: string | null;
+    runId: string;
+    issueId: string | null;
+}): string;
+export declare function resolveClaimedApiKeyPath(value: unknown): string;
+export declare function buildAgentParams(input: {
+    payloadTemplate: Record<string, unknown>;
+    message: string;
+    sessionKey: string;
+    runId: string;
+    configuredAgentId: string | null;
+    waitTimeoutMs: number;
+}): Record<string, unknown>;
+export declare function execute(ctx: AdapterExecutionContext): Promise<AdapterExecutionResult>;
+export {};
+//# sourceMappingURL=execute.d.ts.map

package/dist/server/execute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../src/server/execute.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,sBAAsB,EAEvB,MAAM,yCAAyC,CAAC;AAiBjD,KAAK,kBAAkB,GAAG,OAAO,GAAG,OAAO,GAAG,KAAK,CAAC;AA4HpD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB,GAAG,MAAM,CAST;AAuLD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAE/D;AAmJD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IACtC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAmB1B;AAghBD,wBAAsB,OAAO,CAAC,GAAG,EAAE,uBAAuB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAoe3F"}