@agentex/agent 0.0.16 → 0.0.19

package/dist/providers/_shared/http-agent.d.ts

@@ -0,0 +1,39 @@
+import type { ExecutionContext, ExecutionResult, ProviderModule, SessionCodec } from "../../types.js";
+/**
+ * Reusable "remote HTTP agent" adapter — the pattern OpenClaw encodes and the
+ * shape any gateway-backed agent reuses: resolve a gateway URL (per-call command
+ * override → saved sessionParams → default), round-trip a session key through
+ * `sessionParams`, POST the prompt, map 401/403 to an `auth_required` event, and
+ * bound the request with an AbortController timeout.
+ */
+export interface HttpAgentOptions {
+    /** Provider id (used on events + the result). */
+    providerType: string;
+    /** Gateway base URL used when neither `config.command` nor a saved URL is set. */
+    defaultBaseUrl: string;
+    /** Path appended to the base URL for the run endpoint (e.g. "/api/agent/run"). */
+    runPath: string;
+    /** Recovery command surfaced on `auth_required` (e.g. "openclaw login"). */
+    loginCommand?: string;
+    /** Build the JSON request body. Default: `{ prompt, sessionKey?, model? }`. */
+    buildBody?: (input: {
+        prompt: string;
+        sessionKey: string | null;
+        model: string | null;
+    }) => Record<string, unknown>;
+    /** Pull the summary text from the gateway response. Default: summary ?? result ?? output. */
+    extractSummary?: (response: Record<string, unknown>) => string | null;
+    /** Pull the (possibly new) session key from the response. Default: `response.sessionKey ?? prev`. */
+    extractSessionKey?: (response: Record<string, unknown>, prev: string | null) => string | null;
+    /** Pull the model id from the response. Default: `response.model ?? fallback`. */
+    extractModel?: (response: Record<string, unknown>, fallback: string | null) => string | null;
+    /** Pull the cost from the response. Default: `response.costUsd` when numeric. */
+    extractCost?: (response: Record<string, unknown>) => number | null;
+}
+/** Execute a single turn against a remote HTTP agent gateway. */
+export declare function runHttpAgent(opts: HttpAgentOptions, ctx: ExecutionContext): Promise<ExecutionResult>;
+/** Session codec for HTTP-agent providers — round-trips `{ sessionKey, gatewayUrl }`. */
+export declare const httpAgentSessionCodec: SessionCodec;
+/** Build a `ProviderModule` for a remote HTTP agent gateway. */
+export declare function httpAgentProvider(opts: HttpAgentOptions): ProviderModule;
+//# sourceMappingURL=http-agent.d.ts.map

package/dist/providers/_shared/http-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-agent.d.ts","sourceRoot":"","sources":["../../../src/providers/_shared/http-agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,YAAY,EACb,MAAM,gBAAgB,CAAC;AAGxB;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iDAAiD;IACjD,YAAY,EAAE,MAAM,CAAC;IACrB,kFAAkF;IAClF,cAAc,EAAE,MAAM,CAAC;IACvB,kFAAkF;IAClF,OAAO,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpH,6FAA6F;IAC7F,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,GAAG,IAAI,CAAC;IACtE,qGAAqG;IACrG,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,MAAM,GAAG,IAAI,CAAC;IAC9F,kFAAkF;IAClF,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,KAAK,MAAM,GAAG,IAAI,CAAC;IAC7F,iFAAiF;IACjF,WAAW,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,GAAG,IAAI,CAAC;CACpE;AAgBD,iEAAiE;AACjE,wBAAsB,YAAY,CAChC,IAAI,EAAE,gBAAgB,EACtB,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,eAAe,CAAC,CAgM1B;AAED,yFAAyF;AACzF,eAAO,MAAM,qBAAqB,EAAE,YAoBnC,CAAC;AAEF,gEAAgE;AAChE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,gBAAgB,GAAG,cAAc,CA6BxE"}

package/dist/providers/_shared/http-agent.js

@@ -0,0 +1,265 @@
+import { uuidv7 } from "../../utils/uuid.js";
+function str(v) {
+    return typeof v === "string" && v.length > 0 ? v : null;
+}
+function defaultSummary(r) {
+    return str(r["summary"]) ?? str(r["result"]) ?? str(r["output"]);
+}
+/** Resolve the session key from session params (sessionKey / session_key). */
+function readSessionKey(sessionParams) {
+    if (!sessionParams)
+        return null;
+    return str(sessionParams["sessionKey"]) ?? str(sessionParams["session_key"]);
+}
+/** Execute a single turn against a remote HTTP agent gateway. */
+export async function runHttpAgent(opts, ctx) {
+    const runId = ctx.runId ?? uuidv7();
+    const model = ctx.model ?? ctx.config?.model ?? null;
+    const config = ctx.config ?? {};
+    const startedAt = new Date().toISOString();
+    const startMs = Date.now();
+    const savedGatewayUrl = str(ctx.sessionParams?.["gatewayUrl"]);
+    const gatewayUrl = config.command?.trim() || savedGatewayUrl || opts.defaultBaseUrl;
+    const endpoint = gatewayUrl.replace(/\/$/, "") + opts.runPath;
+    const sessionKey = readSessionKey(ctx.sessionParams);
+    const body = opts.buildBody
+        ? opts.buildBody({ prompt: ctx.prompt, sessionKey, model })
+        : {
+            prompt: ctx.prompt,
+            ...(sessionKey ? { sessionKey } : {}),
+            ...(model ? { model } : {}),
+        };
+    const abortController = new AbortController();
+    let timeoutHandle = null;
+    let timedOut = false;
+    if (config.timeoutSec && config.timeoutSec > 0) {
+        timeoutHandle = setTimeout(() => {
+            timedOut = true;
+            abortController.abort();
+        }, config.timeoutSec * 1000);
+    }
+    // Chain a caller-supplied signal (a caller abort is distinct from a timeout).
+    if (ctx.signal) {
+        if (ctx.signal.aborted)
+            abortController.abort();
+        else
+            ctx.signal.addEventListener("abort", () => abortController.abort(), { once: true });
+    }
+    try {
+        const response = await fetch(endpoint, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(body),
+            signal: abortController.signal,
+        });
+        if (timeoutHandle)
+            clearTimeout(timeoutHandle);
+        if (!response.ok) {
+            const errorText = await response.text().catch(() => "");
+            const isAuth = response.status === 401 || response.status === 403;
+            if (isAuth && ctx.onEvent) {
+                try {
+                    await ctx.onEvent({
+                        type: "auth_required",
+                        httpStatus: response.status,
+                        reason: "unknown",
+                        loginCommand: opts.loginCommand ?? `${opts.providerType} login`,
+                        message: errorText || null,
+                        timestamp: new Date().toISOString(),
+                        providerType: opts.providerType,
+                        sessionId: sessionKey ?? null,
+                        messageId: null,
+                        eventId: null,
+                        turnId: null,
+                        parentToolCallId: null,
+                        raw: { status: response.status, body: errorText },
+                    });
+                }
+                catch {
+                    /* swallow */
+                }
+            }
+            return {
+                runId,
+                exitCode: 1,
+                signal: null,
+                status: "failed",
+                startedAt,
+                completedAt: new Date().toISOString(),
+                durationMs: Date.now() - startMs,
+                errorMessage: `${opts.providerType} gateway returned ${response.status}: ${errorText}`,
+                errorCode: isAuth ? "auth_required" : null,
+                costUsd: null,
+                model,
+                summary: null,
+                sessionParams: sessionKey ? { sessionKey, gatewayUrl } : null,
+                sessionDisplayId: sessionKey,
+                clearSession: false,
+                billingType: null,
+            };
+        }
+        const result = (await response.json());
+        const newSessionKey = opts.extractSessionKey
+            ? opts.extractSessionKey(result, sessionKey)
+            : (str(result["sessionKey"]) ?? sessionKey);
+        const summary = (opts.extractSummary ?? defaultSummary)(result);
+        const resolvedModel = opts.extractModel
+            ? opts.extractModel(result, model)
+            : (str(result["model"]) ?? model);
+        const costUsd = opts.extractCost
+            ? opts.extractCost(result)
+            : typeof result["costUsd"] === "number"
+                ? result["costUsd"]
+                : null;
+        if (ctx.onEvent && summary) {
+            try {
+                await ctx.onEvent({
+                    type: "result",
+                    text: summary,
+                    costUsd,
+                    isError: false,
+                    stopReason: null,
+                    terminalReason: null,
+                    numTurns: null,
+                    durationMs: null,
+                    timestamp: new Date().toISOString(),
+                    providerType: opts.providerType,
+                    sessionId: newSessionKey ?? null,
+                    messageId: null,
+                    eventId: null,
+                    turnId: null,
+                    parentToolCallId: null,
+                    raw: result,
+                });
+            }
+            catch {
+                /* swallow */
+            }
+        }
+        return {
+            runId,
+            exitCode: 0,
+            signal: null,
+            status: "completed",
+            startedAt,
+            completedAt: new Date().toISOString(),
+            durationMs: Date.now() - startMs,
+            errorMessage: null,
+            errorCode: null,
+            costUsd,
+            model: resolvedModel,
+            summary,
+            sessionParams: newSessionKey ? { sessionKey: newSessionKey, gatewayUrl } : null,
+            sessionDisplayId: newSessionKey,
+            clearSession: false,
+            billingType: null,
+            raw: result,
+        };
+    }
+    catch (err) {
+        if (timeoutHandle)
+            clearTimeout(timeoutHandle);
+        if (err instanceof Error && err.name === "AbortError") {
+            // A timeout and a caller-supplied signal abort both surface as AbortError;
+            // distinguish them so consumers can tell a deadline from a cancellation.
+            const isTimeout = timedOut;
+            return {
+                runId,
+                exitCode: null,
+                signal: null,
+                status: isTimeout ? "timeout" : "aborted",
+                startedAt,
+                completedAt: new Date().toISOString(),
+                durationMs: Date.now() - startMs,
+                errorMessage: isTimeout ? `Timed out after ${config.timeoutSec ?? 0}s` : "Aborted by caller",
+                errorCode: isTimeout ? "timeout" : "aborted",
+                costUsd: null,
+                model,
+                summary: null,
+                sessionParams: sessionKey ? { sessionKey, gatewayUrl } : null,
+                sessionDisplayId: sessionKey,
+                clearSession: false,
+                billingType: null,
+            };
+        }
+        // A transient network error (DNS, reset) is recoverable — preserve the
+        // session key / gateway so the caller can resume rather than losing it.
+        return {
+            runId,
+            exitCode: null,
+            signal: null,
+            status: "failed",
+            startedAt,
+            completedAt: new Date().toISOString(),
+            durationMs: Date.now() - startMs,
+            errorMessage: err instanceof Error ? err.message : `${opts.providerType} execution failed`,
+            errorCode: null,
+            costUsd: null,
+            model,
+            summary: null,
+            sessionParams: sessionKey ? { sessionKey, gatewayUrl } : null,
+            sessionDisplayId: sessionKey,
+            clearSession: false,
+            billingType: null,
+        };
+    }
+}
+/** Session codec for HTTP-agent providers — round-trips `{ sessionKey, gatewayUrl }`. */
+export const httpAgentSessionCodec = {
+    deserialize(raw) {
+        if (typeof raw !== "object" || raw === null || Array.isArray(raw))
+            return null;
+        const obj = raw;
+        const sessionKey = str(obj["sessionKey"]) ?? str(obj["session_key"]);
+        if (!sessionKey)
+            return null;
+        const gatewayUrl = str(obj["gatewayUrl"]);
+        return { sessionKey, ...(gatewayUrl ? { gatewayUrl } : {}) };
+    },
+    serialize(params) {
+        if (!params)
+            return null;
+        const sessionKey = str(params["sessionKey"]) ?? str(params["session_key"]);
+        if (!sessionKey)
+            return null;
+        const gatewayUrl = str(params["gatewayUrl"]);
+        return { sessionKey, ...(gatewayUrl ? { gatewayUrl } : {}) };
+    },
+    getDisplayId(params) {
+        if (!params)
+            return null;
+        return str(params["sessionKey"]) ?? str(params["session_key"]);
+    },
+};
+/** Build a `ProviderModule` for a remote HTTP agent gateway. */
+export function httpAgentProvider(opts) {
+    async function resolveAuth() {
+        // The gateway is a URL, not a local binary, so we can't probe presence here.
+        return {
+            providerType: opts.providerType,
+            binary: { installed: true },
+            options: [],
+            source: "filesystem",
+        };
+    }
+    return {
+        type: opts.providerType,
+        capabilities: {
+            sessions: false,
+            modelDiscovery: false,
+            quotaProbing: false,
+            mcp: false,
+            skills: false,
+            instructions: false,
+            workspace: false,
+            planMode: false,
+            concurrentSend: false,
+            cancelQueuedMessage: false,
+            modes: false,
+        },
+        execute: (ctx) => runHttpAgent(opts, ctx),
+        resolveAuth,
+        sessionCodec: httpAgentSessionCodec,
+    };
+}
+//# sourceMappingURL=http-agent.js.map

package/dist/providers/_shared/http-agent.js.map

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

package/dist/providers/acp/index.d.ts

@@ -0,0 +1,29 @@
+import type { ProviderModel, ProviderModule } from "../../types.js";
+import { type AcpTransformers } from "./session.js";
+/**
+ * Configuration for a generic ACP-backed provider. The canonical use is the
+ * config-extend `extends: "acp"` form, but any code can build one directly:
+ *
+ * ```ts
+ * registerProvider(acpProvider({ id: "gemini", command: ["gemini", "--acp"] }));
+ * ```
+ */
+export interface AcpProviderConfig {
+    /** Unique provider id. */
+    id: string;
+    /** Command to spawn the ACP agent: [binary, ...args]. */
+    command: string[];
+    /** Environment overlay applied to every spawn. */
+    env?: Record<string, string>;
+    /** Display label (informational). */
+    label?: string;
+    /** Static model list surfaced via listModels(). */
+    models?: ProviderModel[];
+    /** Default mode id applied on session creation. */
+    modeId?: string;
+    /** Per-agent quirk transformers (modes / modeId). */
+    transformers?: AcpTransformers;
+}
+/** Build a generic ACP-backed `ProviderModule`. */
+export declare function acpProvider(config: AcpProviderConfig): ProviderModule;
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/acp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/acp/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAOV,aAAa,EACb,cAAc,EAIf,MAAM,gBAAgB,CAAC;AAIxB,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,cAAc,CAAC;AAEtB;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC,0BAA0B;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,yDAAyD;IACzD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,kDAAkD;IAClD,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;IACzB,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,YAAY,CAAC,EAAE,eAAe,CAAC;CAChC;AAsHD,mDAAmD;AACnD,wBAAgB,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,cAAc,CAsCrE"}

package/dist/providers/acp/index.js

@@ -0,0 +1,153 @@
+import { ensureCommandResolvable } from "../../utils/binary.js";
+import { uuidv7 } from "../../utils/uuid.js";
+import { registerAcpFactory } from "../../derived.js";
+import { createAcpSession, listAcpModes, } from "./session.js";
+function mapTurnStatus(status) {
+    switch (status) {
+        case "completed":
+        case "max_turns":
+        case "max_budget":
+            return "completed";
+        case "failed":
+            return "failed";
+        case "aborted":
+            return "aborted";
+        case "timeout":
+            return "timeout";
+        default:
+            return "completed";
+    }
+}
+async function runAcpExecute(deps, ctx) {
+    const runId = ctx.runId ?? uuidv7();
+    const startedAt = new Date().toISOString();
+    const startMs = Date.now();
+    const model = ctx.model ?? ctx.config?.model ?? null;
+    const sessionCtx = {
+        ...(ctx.cwd !== undefined ? { cwd: ctx.cwd } : {}),
+        ...(ctx.env !== undefined ? { env: ctx.env } : {}),
+        ...(ctx.config !== undefined ? { config: ctx.config } : {}),
+        ...(ctx.onEvent ? { onEvent: ctx.onEvent } : {}),
+        ...(ctx.onOutput ? { onOutput: ctx.onOutput } : {}),
+        ...(ctx.signal ? { signal: ctx.signal } : {}),
+    };
+    const base = {
+        runId,
+        startedAt,
+        signal: null,
+        model,
+        summary: null,
+        sessionParams: null,
+        sessionDisplayId: null,
+        clearSession: false,
+        billingType: null,
+    };
+    let session = null;
+    try {
+        session = await createAcpSession(deps, sessionCtx);
+        const handle = await session.send(ctx.prompt, {
+            ...(ctx.config?.timeoutSec ? { timeoutSec: ctx.config.timeoutSec } : {}),
+            ...(ctx.signal ? { signal: ctx.signal } : {}),
+        });
+        const turn = await handle.result;
+        const sessionId = session.sessionId;
+        await session.close();
+        return {
+            ...base,
+            completedAt: new Date().toISOString(),
+            durationMs: Date.now() - startMs,
+            exitCode: turn.status === "completed" ? 0 : 1,
+            status: mapTurnStatus(turn.status),
+            errorMessage: turn.errorMessage,
+            errorCode: turn.errorCode,
+            summary: turn.summary,
+            ...(turn.usage ? { usage: turn.usage } : {}),
+            costUsd: turn.costUsd,
+            sessionParams: sessionId ? { sessionId } : null,
+            sessionDisplayId: sessionId,
+        };
+    }
+    catch (err) {
+        if (session) {
+            try {
+                await session.close();
+            }
+            catch {
+                /* ignore */
+            }
+        }
+        return {
+            ...base,
+            completedAt: new Date().toISOString(),
+            durationMs: Date.now() - startMs,
+            exitCode: 1,
+            signal: null,
+            status: "failed",
+            errorMessage: err instanceof Error ? err.message : String(err),
+            errorCode: "acp_error",
+            costUsd: null,
+        };
+    }
+}
+async function resolveAcpAuth(config, authCtx) {
+    const binary = authCtx?.command ?? config.command[0];
+    try {
+        const resolved = await ensureCommandResolvable(binary);
+        return {
+            providerType: config.id,
+            binary: { installed: true, resolvedPath: resolved.bin },
+            options: [],
+            source: "filesystem",
+        };
+    }
+    catch (err) {
+        return {
+            providerType: config.id,
+            binary: { installed: false, error: err instanceof Error ? err.message : String(err) },
+            options: [],
+            source: "filesystem",
+        };
+    }
+}
+/** Build a generic ACP-backed `ProviderModule`. */
+export function acpProvider(config) {
+    const deps = {
+        provider: config.id,
+        command: config.command,
+        ...(config.env ? { env: config.env } : {}),
+        ...(config.modeId ? { modeId: config.modeId } : {}),
+        ...(config.transformers ? { transformers: config.transformers } : {}),
+    };
+    const provider = {
+        type: config.id,
+        capabilities: {
+            sessions: true,
+            modelDiscovery: Boolean(config.models),
+            quotaProbing: false,
+            mcp: false,
+            skills: false,
+            instructions: false,
+            workspace: true,
+            planMode: false,
+            concurrentSend: false,
+            cancelQueuedMessage: false,
+            modes: true,
+            // Real capability set is negotiated at the ACP initialize handshake.
+            dynamicCapabilities: true,
+        },
+        execute: (ctx) => runAcpExecute(deps, ctx),
+        createSession: (ctx) => createAcpSession(deps, ctx),
+        resolveAuth: (authCtx) => resolveAcpAuth(config, authCtx),
+        listModes: (opts) => listAcpModes(deps, opts),
+    };
+    if (config.models) {
+        const models = config.models;
+        provider.listModels = async () => models;
+    }
+    return provider;
+}
+// Register the factory so `loadProvidersFromConfig({ extends: "acp" })` can
+// build ACP providers. Importing this module is cheap — the SDK is only loaded
+// when a session/execute actually runs (dynamic import in session.ts).
+registerAcpFactory(acpProvider);
+//# sourceMappingURL=index.js.map

package/dist/providers/acp/index.js.map

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

package/dist/providers/acp/parse.d.ts

@@ -0,0 +1,22 @@
+import type { StreamEvent } from "../../types.js";
+/** Extract text from an ACP `ContentBlock` (a chunk update's `content`). */
+export declare function extractContentText(content: unknown): string | null;
+/** Extract displayable text from a tool call's `content` (ToolCallContent[]). */
+export declare function extractToolContentText(content: unknown): string | null;
+export interface AcpBaseInfo {
+    provider: string;
+    sessionId: string | null;
+    timestamp: string;
+}
+/**
+ * Map an ACP `session/update` payload (`params.update`) to an agentex
+ * `StreamEvent`. Returns null for updates with no agentex equivalent (user
+ * echoes, in-progress tool ticks). Unknown update kinds surface as
+ * `type: "unknown"` for forward-compat.
+ */
+export declare function mapAcpUpdate(update: Record<string, unknown>, info: AcpBaseInfo): StreamEvent | null;
+/** Map an ACP `stopReason` to an agentex TurnResult status. */
+export declare function mapAcpStopReason(stopReason: string | undefined): TurnStatus;
+type TurnStatus = "completed" | "failed" | "max_turns" | "max_budget" | "aborted" | "timeout";
+export {};
+//# sourceMappingURL=parse.d.ts.map

package/dist/providers/acp/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../src/providers/acp/parse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAyB,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAMzE,4EAA4E;AAC5E,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAKlE;AAED,iFAAiF;AACjF,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAkBtE;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAiBD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,WAAW,GAAG,WAAW,GAAG,IAAI,CA4CnG;AAMD,+DAA+D;AAC/D,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,CAe3E;AAED,KAAK,UAAU,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,YAAY,GAAG,SAAS,GAAG,SAAS,CAAC"}