@gralkor/openclaw 4.0.0

package/dist/hooks/session-end.d.ts

@@ -0,0 +1,18 @@
+import type { GralkorClient, Result } from "../gralkor/index.js";
+export interface SessionEndCtx {
+    sessionKey: string;
+}
+/**
+ * `session_end` hook: an OpenClaw-owned signal that a conversation is
+ * over. We forward it to Gralkor's `/session_end` endpoint so the
+ * server flushes that session's capture buffer immediately rather than
+ * waiting for lifespan shutdown. Server handles the graph write async
+ * and returns 204, so this call is effectively fire-and-forget from a
+ * latency standpoint.
+ *
+ * If the sessionKey was never seen by `before_prompt_build` (e.g.
+ * session_end fires on a fresh process with no prior activity), there
+ * is nothing to flush — skip the HTTP call and return ok.
+ */
+export declare function runSessionEnd(client: GralkorClient, ctx: SessionEndCtx): Promise<Result<true>>;
+//# sourceMappingURL=session-end.d.ts.map

package/dist/hooks/session-end.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-end.d.ts","sourceRoot":"","sources":["../../src/hooks/session-end.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAGjE,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,aAAa,EACrB,GAAG,EAAE,aAAa,GACjB,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAGvB"}

package/dist/hooks/session-end.js

@@ -0,0 +1,19 @@
+import { getSessionGroup } from "../session-map.js";
+/**
+ * `session_end` hook: an OpenClaw-owned signal that a conversation is
+ * over. We forward it to Gralkor's `/session_end` endpoint so the
+ * server flushes that session's capture buffer immediately rather than
+ * waiting for lifespan shutdown. Server handles the graph write async
+ * and returns 204, so this call is effectively fire-and-forget from a
+ * latency standpoint.
+ *
+ * If the sessionKey was never seen by `before_prompt_build` (e.g.
+ * session_end fires on a fresh process with no prior activity), there
+ * is nothing to flush — skip the HTTP call and return ok.
+ */
+export async function runSessionEnd(client, ctx) {
+    if (getSessionGroup(ctx.sessionKey) === null)
+        return { ok: true };
+    return client.endSession(ctx.sessionKey);
+}
+//# sourceMappingURL=session-end.js.map

package/dist/hooks/session-end.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-end.js","sourceRoot":"","sources":["../../src/hooks/session-end.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAMpD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAqB,EACrB,GAAkB;IAElB,IAAI,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,IAAI;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IAClE,OAAO,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;AAC3C,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,130 @@
+import type { MemoryPluginApi } from "./types.js";
+/**
+ * Parse a GitHub `owner/repo` slug from a package.json `repository.url` field.
+ * The slug is passed to `createServerManager` as `wheelRepo` and to the
+ * `falkordblite` wheel URL the server-manager downloads at boot — the same
+ * slug the publish script (`scripts/publish-clawhub.sh`) uploads to via
+ * `gh release upload`. Deriving both sides from one source (this field)
+ * keeps publish and runtime in lockstep.
+ */
+export declare function parseGithubRepoSlug(repositoryUrl: string): string;
+export declare function resetRegistrationForTests(): void;
+export declare const id = "@gralkor/openclaw";
+export declare const name = "Gralkor Memory (OpenClaw)";
+export declare const description = "Persistent, temporally-aware memory via Graphiti knowledge graphs and FalkorDB";
+export declare const kind: "memory";
+export declare const tools: string[];
+export declare const configSchema: {
+    type: "object";
+    required: readonly ["agentName"];
+    properties: {
+        agentName: {
+            type: "string";
+            minLength: number;
+        };
+        search: {
+            type: "object";
+            properties: {
+                maxResults: {
+                    type: "number";
+                    default: 20;
+                };
+            };
+        };
+        dataDir: {
+            type: "string";
+            description: string;
+        };
+        workspaceDir: {
+            type: "string";
+            description: string;
+        };
+        test: {
+            type: "boolean";
+            default: boolean;
+            description: string;
+        };
+        googleApiKey: {
+            type: "string";
+            description: string;
+        };
+        openaiApiKey: {
+            type: "string";
+            description: string;
+        };
+        anthropicApiKey: {
+            type: "string";
+            description: string;
+        };
+        groqApiKey: {
+            type: "string";
+            description: string;
+        };
+        interpretMaxOutputTokens: {
+            type: "number";
+            description: string;
+        };
+    };
+};
+export declare function register(api: MemoryPluginApi): void;
+declare const _default: {
+    id: string;
+    name: string;
+    description: string;
+    kind: "memory";
+    configSchema: {
+        type: "object";
+        required: readonly ["agentName"];
+        properties: {
+            agentName: {
+                type: "string";
+                minLength: number;
+            };
+            search: {
+                type: "object";
+                properties: {
+                    maxResults: {
+                        type: "number";
+                        default: 20;
+                    };
+                };
+            };
+            dataDir: {
+                type: "string";
+                description: string;
+            };
+            workspaceDir: {
+                type: "string";
+                description: string;
+            };
+            test: {
+                type: "boolean";
+                default: boolean;
+                description: string;
+            };
+            googleApiKey: {
+                type: "string";
+                description: string;
+            };
+            openaiApiKey: {
+                type: "string";
+                description: string;
+            };
+            anthropicApiKey: {
+                type: "string";
+                description: string;
+            };
+            groqApiKey: {
+                type: "string";
+                description: string;
+            };
+            interpretMaxOutputTokens: {
+                type: "number";
+                description: string;
+            };
+        };
+    };
+    register: typeof register;
+};
+export default _default;
+//# 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,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAmBlD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAQjE;AAID,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD;AAED,eAAO,MAAM,EAAE,sBAAsB,CAAC;AACtC,eAAO,MAAM,IAAI,8BAA8B,CAAC;AAChD,eAAO,MAAM,WAAW,mFAC0D,CAAC;AACnF,eAAO,MAAM,IAAI,EAAG,QAAiB,CAAC;AAEtC,eAAO,MAAM,KAAK,UAKjB,CAAC;AAEF,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwDxB,CAAC;AAEF,wBAAgB,QAAQ,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI,CAiDnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAED,wBAAuE"}

package/dist/index.js

@@ -0,0 +1,133 @@
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+import { GralkorHttpClient, GRALKOR_URL, validateOntologyConfig, } from "./gralkor/index.js";
+import { resolveConfig, defaultConfig, } from "./config.js";
+import { registerTools, registerHooks, registerServerService, registerMemoryCapability, resetServerManagerForTests, } from "./register.js";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const pluginDir = join(__dirname, ".."); // dist/ → plugin root
+const pkgJson = JSON.parse(readFileSync(join(pluginDir, "package.json"), "utf-8"));
+const version = pkgJson.version;
+/**
+ * Parse a GitHub `owner/repo` slug from a package.json `repository.url` field.
+ * The slug is passed to `createServerManager` as `wheelRepo` and to the
+ * `falkordblite` wheel URL the server-manager downloads at boot — the same
+ * slug the publish script (`scripts/publish-clawhub.sh`) uploads to via
+ * `gh release upload`. Deriving both sides from one source (this field)
+ * keeps publish and runtime in lockstep.
+ */
+export function parseGithubRepoSlug(repositoryUrl) {
+    const match = repositoryUrl.match(/github\.com[:/]([^/]+)\/([^/.]+?)(?:\.git)?$/);
+    if (!match) {
+        throw new Error(`Cannot parse GitHub owner/repo from repository.url=${JSON.stringify(repositoryUrl)} — expected a github.com URL`);
+    }
+    return `${match[1]}/${match[2]}`;
+}
+const wheelRepo = parseGithubRepoSlug(pkgJson.repository?.url ?? "");
+export function resetRegistrationForTests() {
+    resetServerManagerForTests();
+}
+export const id = "@gralkor/openclaw";
+export const name = "Gralkor Memory (OpenClaw)";
+export const description = "Persistent, temporally-aware memory via Graphiti knowledge graphs and FalkorDB";
+export const kind = "memory";
+export const tools = [
+    "memory_search",
+    "memory_add",
+    "memory_build_indices",
+    "memory_build_communities",
+];
+export const configSchema = {
+    type: "object",
+    required: ["agentName"],
+    properties: {
+        agentName: {
+            type: "string",
+            minLength: 1,
+        },
+        search: {
+            type: "object",
+            properties: {
+                maxResults: {
+                    type: "number",
+                    default: defaultConfig.search.maxResults,
+                },
+            },
+        },
+        dataDir: {
+            type: "string",
+            description: "Required. Directory for persistent backend data (venv, FalkorDB database). Operator must set this path.",
+        },
+        workspaceDir: {
+            type: "string",
+            description: "Native memory workspace root. Scanned at startup for MD files to index into the graph. Defaults to ~/.openclaw/workspace.",
+        },
+        test: {
+            type: "boolean",
+            default: false,
+            description: "Enable test mode — logs full episode bodies and search results for debugging.",
+        },
+        googleApiKey: {
+            type: "string",
+            description: "Google API key for Gemini LLM and embeddings",
+        },
+        openaiApiKey: {
+            type: "string",
+            description: "OpenAI API key; also needed for embeddings with Anthropic/Groq providers",
+        },
+        anthropicApiKey: {
+            type: "string",
+            description: "Anthropic API key for Claude-based LLM extraction",
+        },
+        groqApiKey: {
+            type: "string",
+            description: "Groq API key for Groq-hosted LLM extraction",
+        },
+        interpretMaxOutputTokens: {
+            type: "number",
+            description: "Optional positive integer. Output-token budget the server passes to its interpret pipeline on every recall. Unset → server default (2000). Raise for wide-recall workloads where the default truncates and surfaces as InterpretParseFailed in the server logs.",
+        },
+    },
+};
+export function register(api) {
+    if (api.registrationMode && api.registrationMode !== "full")
+        return;
+    try {
+        const config = resolveConfig((api.pluginConfig ?? {}));
+        validateOntologyConfig(config.ontology);
+        console.log(`[gralkor] boot: plugin loaded (v${version})`);
+        if (config.test) {
+            console.log(`[gralkor] raw pluginConfig: ${JSON.stringify(api.pluginConfig)}`);
+        }
+        const llmSummary = config.llm
+            ? `${config.llm.provider}/${config.llm.model}`
+            : "server-default";
+        const embedderSummary = config.embedder
+            ? `${config.embedder.provider}/${config.embedder.model}`
+            : "server-default";
+        const ontologySummary = config.ontology
+            ? `${Object.keys(config.ontology.entities ?? {}).length} entities, ${Object.keys(config.ontology.edges ?? {}).length} edges`
+            : "none";
+        console.log(`[gralkor] config:` +
+            ` llm=${llmSummary}` +
+            ` embedder=${embedderSummary}` +
+            ` ontology=${ontologySummary}` +
+            ` test=${config.test}` +
+            ` dataDir=${config.dataDir ?? "default"}`);
+        const client = new GralkorHttpClient({
+            baseUrl: GRALKOR_URL,
+            interpretMaxOutputTokens: config.interpretMaxOutputTokens,
+        });
+        registerTools(api, client, config);
+        registerHooks(api, client, config);
+        registerServerService(api, config, version, wheelRepo);
+        registerMemoryCapability(api);
+    }
+    catch (err) {
+        console.error(`[gralkor] boot: register() failed:`, err instanceof Error ? err.message : err);
+        throw err;
+    }
+}
+export default { id, name, description, kind, configSchema, register };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/native-indexer.d.ts

@@ -0,0 +1,43 @@
+import type { GralkorClient } from "./gralkor/index.js";
+export declare const GRALKOR_MARKER = "<!-- GRALKOR:INDEXED -->";
+export interface DiscoveredFile {
+    absPath: string;
+    relPath: string;
+    groupId: string;
+}
+/**
+ * Discover native OpenClaw memory files under workspaceDir.
+ *
+ * Paths scanned:
+ *   {workspaceDir}/MEMORY.md       → groupId (provided by caller)
+ *   {workspaceDir}/memory/*.md     → groupId (provided by caller)
+ *
+ * The caller (before_prompt_build) knows the agentId and thus the correct
+ * group — no routing logic needed here.
+ */
+export declare function discoverFiles(workspaceDir: string, groupId: string): Promise<DiscoveredFile[]>;
+/**
+ * Index a single native memory file into the graph via the Gralkor client.
+ *
+ * Marker semantics:
+ *   - No marker: ingest entire content, append marker at EOF.
+ *   - Marker at EOF: skip (nothing new).
+ *   - Marker mid-file: ingest content after marker, move marker to EOF.
+ *
+ * If the memoryAdd call fails, the file is NOT modified — next run will
+ * retry. Returns true if content was ingested, false if skipped, and
+ * propagates client errors as thrown exceptions so the caller can decide
+ * per-file whether to continue.
+ */
+export declare function indexFile(client: GralkorClient, file: DiscoveredFile): Promise<boolean>;
+/**
+ * Scan the workspace for native memory files and index any new content
+ * into the graph. Fire-and-forget safe — per-file errors are caught and
+ * logged; the loop continues.
+ *
+ * Called from before_prompt_build on each session start. Already-indexed
+ * files (marker at EOF) cost only a disk read + string search, so
+ * calling every session is cheap.
+ */
+export declare function runNativeIndexer(client: GralkorClient, workspaceDir: string, groupId: string): Promise<void>;
+//# sourceMappingURL=native-indexer.d.ts.map

package/dist/native-indexer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-indexer.d.ts","sourceRoot":"","sources":["../src/native-indexer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,eAAO,MAAM,cAAc,6BAA6B,CAAC;AAEzD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CACjC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,cAAc,EAAE,CAAC,CA6B3B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,OAAO,CAAC,CAuBlB;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,aAAa,EACrB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAiCf"}

package/dist/native-indexer.js

@@ -0,0 +1,107 @@
+import { readdir, readFile, writeFile } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+export const GRALKOR_MARKER = "<!-- GRALKOR:INDEXED -->";
+/**
+ * Discover native OpenClaw memory files under workspaceDir.
+ *
+ * Paths scanned:
+ *   {workspaceDir}/MEMORY.md       → groupId (provided by caller)
+ *   {workspaceDir}/memory/*.md     → groupId (provided by caller)
+ *
+ * The caller (before_prompt_build) knows the agentId and thus the correct
+ * group — no routing logic needed here.
+ */
+export async function discoverFiles(workspaceDir, groupId) {
+    if (!existsSync(workspaceDir))
+        return [];
+    const files = [];
+    const rootMemory = join(workspaceDir, "MEMORY.md");
+    if (existsSync(rootMemory)) {
+        files.push({ absPath: rootMemory, relPath: "MEMORY.md", groupId });
+    }
+    const memoryDir = join(workspaceDir, "memory");
+    if (existsSync(memoryDir)) {
+        try {
+            const entries = await readdir(memoryDir);
+            for (const entry of entries.sort()) {
+                if (entry.endsWith(".md")) {
+                    files.push({
+                        absPath: join(memoryDir, entry),
+                        relPath: `memory/${entry}`,
+                        groupId,
+                    });
+                }
+            }
+        }
+        catch {
+            /* ignore */
+        }
+    }
+    return files;
+}
+/**
+ * Index a single native memory file into the graph via the Gralkor client.
+ *
+ * Marker semantics:
+ *   - No marker: ingest entire content, append marker at EOF.
+ *   - Marker at EOF: skip (nothing new).
+ *   - Marker mid-file: ingest content after marker, move marker to EOF.
+ *
+ * If the memoryAdd call fails, the file is NOT modified — next run will
+ * retry. Returns true if content was ingested, false if skipped, and
+ * propagates client errors as thrown exceptions so the caller can decide
+ * per-file whether to continue.
+ */
+export async function indexFile(client, file) {
+    const raw = await readFile(file.absPath, "utf8");
+    const markerPos = raw.indexOf(GRALKOR_MARKER);
+    const newContent = markerPos === -1
+        ? raw.trim()
+        : raw.slice(markerPos + GRALKOR_MARKER.length).trim();
+    const prefix = markerPos === -1 ? raw.trimEnd() : raw.slice(0, markerPos).trimEnd();
+    if (!newContent)
+        return false;
+    const result = await client.memoryAdd(file.groupId, newContent, file.relPath);
+    if ("error" in result) {
+        throw new Error(`memoryAdd failed for ${file.relPath}: ${JSON.stringify(result.error)}`);
+    }
+    const body = markerPos === -1 ? prefix : `${prefix}\n${newContent}`;
+    await writeFile(file.absPath, `${body}\n${GRALKOR_MARKER}\n`);
+    return true;
+}
+/**
+ * Scan the workspace for native memory files and index any new content
+ * into the graph. Fire-and-forget safe — per-file errors are caught and
+ * logged; the loop continues.
+ *
+ * Called from before_prompt_build on each session start. Already-indexed
+ * files (marker at EOF) cost only a disk read + string search, so
+ * calling every session is cheap.
+ */
+export async function runNativeIndexer(client, workspaceDir, groupId) {
+    if (!existsSync(workspaceDir)) {
+        console.log(`[gralkor] native-index: workspaceDir not found (${workspaceDir}) — skipping`);
+        return;
+    }
+    const files = await discoverFiles(workspaceDir, groupId);
+    if (files.length === 0)
+        return;
+    let indexed = 0;
+    for (const file of files) {
+        try {
+            const ingested = await indexFile(client, file);
+            if (ingested) {
+                indexed++;
+                console.log(`[gralkor] native-index: indexed ${file.relPath} → ${file.groupId}`);
+            }
+        }
+        catch (err) {
+            console.log(`[gralkor] native-index: error on ${file.relPath} — ${err instanceof Error ? err.message : err}`);
+        }
+    }
+    if (indexed > 0) {
+        console.log(`[gralkor] native-index: done — ${indexed} file(s) ingested`);
+    }
+}
+//# sourceMappingURL=native-indexer.js.map

package/dist/native-indexer.js.map

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

package/dist/register.d.ts

@@ -0,0 +1,25 @@
+import { type GralkorClient, type ServerManager } from "./gralkor/index.js";
+import { type GralkorPluginConfig } from "./config.js";
+import type { MemoryPluginApi } from "./types.js";
+export interface RegisterContext {
+    api: MemoryPluginApi;
+    config: GralkorPluginConfig;
+    version: string;
+}
+export declare function registerTools(api: MemoryPluginApi, client: GralkorClient, config: GralkorPluginConfig): void;
+export declare function registerHooks(api: MemoryPluginApi, client: GralkorClient, config: GralkorPluginConfig): void;
+export declare function resetServerManagerForTests(): void;
+/**
+ * Declares this plugin as the active memory capability for OpenClaw 2026.5.x+.
+ * Once registered, `openclaw plugins info` reports `Shape: memory capability`
+ * and OpenClaw routes the `plugins.slots.memory` slot through this plugin.
+ *
+ * The capability is intentionally minimal — capture/recall is hook+tool-driven
+ * (see registerHooks / registerTools). The promptBuilder only contributes the
+ * static usage hints that the agent reads alongside the tool definitions, and
+ * flushPlanResolver opts out of OpenClaw's compaction-flush turn (we capture
+ * per agent_end, so a follow-up flush turn would duplicate the work).
+ */
+export declare function registerMemoryCapability(api: MemoryPluginApi): void;
+export declare function registerServerService(api: MemoryPluginApi, config: GralkorPluginConfig, version: string, wheelRepo: string): ServerManager;
+//# sourceMappingURL=register.d.ts.map

package/dist/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,aAAa,EAClB,KAAK,aAAa,EACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAkB,KAAK,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAWlD,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,eAAe,CAAC;IACrB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,aAAa,CAC3B,GAAG,EAAE,eAAe,EACpB,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,mBAAmB,GAC1B,IAAI,CA6EN;AAgBD,wBAAgB,aAAa,CAC3B,GAAG,EAAE,eAAe,EACpB,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,mBAAmB,GAC1B,IAAI,CA+CN;AAID,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD;AAQD;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI,CAMnE;AAED,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,eAAe,EACpB,MAAM,EAAE,mBAAmB,EAC3B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,aAAa,CAmCf"}