@mka-rainmaker/ama 0.1.0

package/dist/analyzers/sidecar/analyzer.js

@@ -0,0 +1,114 @@
+import { spawn } from "node:child_process";
+import * as readline from "node:readline";
+import { frame, parseMessage } from "./protocol.js";
+/**
+ * Drives an out-of-process deep analyzer (a "sidecar") over the {@link ./protocol.ts}
+ * contract. Implements {@link Analyzer} (tier `deep`) so it plugs in alongside the
+ * in-process analyzers, but delegates the actual work to a subprocess (e.g. a Roslyn or
+ * native-Java tool) that speaks NDJSON over stdio.
+ *
+ * One subprocess per `analyze` call (one per language batch per index): spawn, send the
+ * `analyze` request on stdin, read the matching `result` from stdout, then tear it down.
+ * The sidecar's stderr is inherited so its logs reach Ama's stderr, never the protocol
+ * stream. A spawn failure, a malformed message, an `error` reply, or an exit-without-result
+ * rejects — the indexer's per-analyzer isolation then skips this language (graceful
+ * fall-through to baseline is the routing layer's job, ama-3bb.4). (ama-3bb.1)
+ */
+export class SidecarAnalyzer {
+    language;
+    extensions;
+    command;
+    args;
+    tier = "deep";
+    constructor(language, extensions, command, args = []) {
+        this.language = language;
+        this.extensions = extensions;
+        this.command = command;
+        this.args = args;
+    }
+    /** Probe whether the sidecar can start and speak the protocol: spawn it and wait for
+     *  its `ready` handshake within `timeoutMs`. A spawn failure, an early exit, or a
+     *  timeout means unavailable — routing then leaves the language to the baseline tier
+     *  rather than dropping it. (ama-3bb.4) */
+    isAvailable(timeoutMs = 2000) {
+        return new Promise((resolve) => {
+            const child = spawn(this.command, [...this.args], { stdio: ["pipe", "pipe", "ignore"] });
+            let done = false;
+            const finish = (ok) => {
+                if (done)
+                    return;
+                done = true;
+                clearTimeout(timer);
+                child.kill();
+                resolve(ok);
+            };
+            const timer = setTimeout(() => finish(false), timeoutMs);
+            child.on("error", () => finish(false)); // spawn failure (ENOENT, …)
+            child.on("exit", () => finish(false)); // exited before announcing
+            child.stdin?.on("error", () => { });
+            if (!child.stdout) {
+                finish(false);
+                return;
+            }
+            const rl = readline.createInterface({ input: child.stdout });
+            rl.on("line", (line) => {
+                try {
+                    if (parseMessage(line).type === "ready")
+                        finish(true);
+                }
+                catch {
+                    // ignore noise on stdout until a valid `ready` arrives or the timeout fires
+                }
+            });
+        });
+    }
+    analyze(root, files) {
+        const request = { type: "analyze", id: 1, root, files };
+        return new Promise((resolve, reject) => {
+            const child = spawn(this.command, [...this.args], { stdio: ["pipe", "pipe", "inherit"] });
+            let settled = false;
+            const finish = (run) => {
+                if (settled)
+                    return;
+                settled = true;
+                child.kill();
+                run();
+            };
+            child.on("error", (err) => finish(() => reject(err))); // spawn failure (ENOENT, …)
+            child.on("exit", () => {
+                if (!settled)
+                    reject(new Error(`${this.language} sidecar exited without a result`));
+            });
+            // Writing to a sidecar that failed to spawn can emit EPIPE; the `error`/`exit`
+            // handlers carry the real failure, so swallow the stream error to avoid a crash.
+            child.stdin?.on("error", () => { });
+            if (!child.stdout) {
+                finish(() => reject(new Error(`${this.language} sidecar has no stdout`)));
+                return;
+            }
+            const rl = readline.createInterface({ input: child.stdout });
+            rl.on("line", (line) => {
+                if (settled)
+                    return;
+                let msg;
+                try {
+                    msg = parseMessage(line);
+                }
+                catch (err) {
+                    finish(() => reject(err instanceof Error ? err : new Error(String(err))));
+                    return;
+                }
+                if (msg.type === "result" && msg.id === request.id) {
+                    finish(() => resolve({ nodes: msg.nodes, edges: msg.edges, resolution: msg.resolution }));
+                }
+                else if (msg.type === "error") {
+                    finish(() => reject(new Error(msg.message)));
+                }
+                // `ready` (and any unrelated result id) is ignored.
+            });
+            child.stdin?.write(frame(request));
+            child.stdin?.end();
+        });
+    }
+}
+//# sourceMappingURL=analyzer.js.map

package/dist/analyzers/sidecar/analyzer.js.map

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

package/dist/analyzers/sidecar/protocol.d.ts

@@ -0,0 +1,508 @@
+import { z } from "zod";
+/** A {@link GraphNode} on the wire. Kept in lockstep with the graph model; the node/edge
+ *  round-trip test fails if a required field drifts. */
+export declare const graphNodeSchema: z.ZodObject<{
+    id: z.ZodString;
+    kind: z.ZodEnum<["File", "Module", "Class", "Interface", "Enum", "TypeAlias", "Function", "Method", "Property", "Variable", "Route", "Component"]>;
+    name: z.ZodString;
+    file: z.ZodString;
+    qualifiedName: z.ZodString;
+    range: z.ZodOptional<z.ZodObject<{
+        startLine: z.ZodNumber;
+        endLine: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        startLine: number;
+        endLine: number;
+    }, {
+        startLine: number;
+        endLine: number;
+    }>>;
+    tier: z.ZodEnum<["deep", "baseline"]>;
+}, "strip", z.ZodTypeAny, {
+    kind: "File" | "Module" | "Class" | "Interface" | "Enum" | "TypeAlias" | "Function" | "Method" | "Property" | "Variable" | "Route" | "Component";
+    name: string;
+    id: string;
+    file: string;
+    qualifiedName: string;
+    tier: "deep" | "baseline";
+    range?: {
+        startLine: number;
+        endLine: number;
+    } | undefined;
+}, {
+    kind: "File" | "Module" | "Class" | "Interface" | "Enum" | "TypeAlias" | "Function" | "Method" | "Property" | "Variable" | "Route" | "Component";
+    name: string;
+    id: string;
+    file: string;
+    qualifiedName: string;
+    tier: "deep" | "baseline";
+    range?: {
+        startLine: number;
+        endLine: number;
+    } | undefined;
+}>;
+/** A {@link GraphEdge} on the wire. */
+export declare const graphEdgeSchema: z.ZodObject<{
+    from: z.ZodString;
+    to: z.ZodString;
+    kind: z.ZodEnum<["Defines", "Calls", "Instantiates", "Overrides", "Inherits", "Implements", "UsesType", "Returns", "Imports", "ImportsType", "References"]>;
+    provenance: z.ZodOptional<z.ZodEnum<["resolved", "heuristic", "dispatch"]>>;
+    at: z.ZodOptional<z.ZodObject<{
+        line: z.ZodNumber;
+        column: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        line: number;
+        column: number;
+    }, {
+        line: number;
+        column: number;
+    }>>;
+    sites: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        line: z.ZodNumber;
+        column: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        line: number;
+        column: number;
+    }, {
+        line: number;
+        column: number;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    kind: "Defines" | "Calls" | "Instantiates" | "Overrides" | "Inherits" | "Implements" | "UsesType" | "Returns" | "Imports" | "ImportsType" | "References";
+    from: string;
+    to: string;
+    at?: {
+        line: number;
+        column: number;
+    } | undefined;
+    provenance?: "resolved" | "heuristic" | "dispatch" | undefined;
+    sites?: {
+        line: number;
+        column: number;
+    }[] | undefined;
+}, {
+    kind: "Defines" | "Calls" | "Instantiates" | "Overrides" | "Inherits" | "Implements" | "UsesType" | "Returns" | "Imports" | "ImportsType" | "References";
+    from: string;
+    to: string;
+    at?: {
+        line: number;
+        column: number;
+    } | undefined;
+    provenance?: "resolved" | "heuristic" | "dispatch" | undefined;
+    sites?: {
+        line: number;
+        column: number;
+    }[] | undefined;
+}>;
+/** Ama → sidecar: analyze these repo-relative `files` rooted at the absolute `root`.
+ *  `id` correlates the matching `result`/`error`. */
+export declare const analyzeRequestSchema: z.ZodObject<{
+    type: z.ZodLiteral<"analyze">;
+    id: z.ZodNumber;
+    root: z.ZodString;
+    files: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    type: "analyze";
+    id: number;
+    root: string;
+    files: string[];
+}, {
+    type: "analyze";
+    id: number;
+    root: string;
+    files: string[];
+}>;
+/** Sidecar → Ama: the analysis of one request's files. */
+declare const resultSchema: z.ZodObject<{
+    type: z.ZodLiteral<"result">;
+    id: z.ZodNumber;
+    nodes: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodEnum<["File", "Module", "Class", "Interface", "Enum", "TypeAlias", "Function", "Method", "Property", "Variable", "Route", "Component"]>;
+        name: z.ZodString;
+        file: z.ZodString;
+        qualifiedName: z.ZodString;
+        range: z.ZodOptional<z.ZodObject<{
+            startLine: z.ZodNumber;
+            endLine: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            startLine: number;
+            endLine: number;
+        }, {
+            startLine: number;
+            endLine: number;
+        }>>;
+        tier: z.ZodEnum<["deep", "baseline"]>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "File" | "Module" | "Class" | "Interface" | "Enum" | "TypeAlias" | "Function" | "Method" | "Property" | "Variable" | "Route" | "Component";
+        name: string;
+        id: string;
+        file: string;
+        qualifiedName: string;
+        tier: "deep" | "baseline";
+        range?: {
+            startLine: number;
+            endLine: number;
+        } | undefined;
+    }, {
+        kind: "File" | "Module" | "Class" | "Interface" | "Enum" | "TypeAlias" | "Function" | "Method" | "Property" | "Variable" | "Route" | "Component";
+        name: string;
+        id: string;
+        file: string;
+        qualifiedName: string;
+        tier: "deep" | "baseline";
+        range?: {
+            startLine: number;
+            endLine: number;
+        } | undefined;
+    }>, "many">;
+    edges: z.ZodArray<z.ZodObject<{
+        from: z.ZodString;
+        to: z.ZodString;
+        kind: z.ZodEnum<["Defines", "Calls", "Instantiates", "Overrides", "Inherits", "Implements", "UsesType", "Returns", "Imports", "ImportsType", "References"]>;
+        provenance: z.ZodOptional<z.ZodEnum<["resolved", "heuristic", "dispatch"]>>;
+        at: z.ZodOptional<z.ZodObject<{
+            line: z.ZodNumber;
+            column: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            line: number;
+            column: number;
+        }, {
+            line: number;
+            column: number;
+        }>>;
+        sites: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            line: z.ZodNumber;
+            column: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            line: number;
+            column: number;
+        }, {
+            line: number;
+            column: number;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "Defines" | "Calls" | "Instantiates" | "Overrides" | "Inherits" | "Implements" | "UsesType" | "Returns" | "Imports" | "ImportsType" | "References";
+        from: string;
+        to: string;
+        at?: {
+            line: number;
+            column: number;
+        } | undefined;
+        provenance?: "resolved" | "heuristic" | "dispatch" | undefined;
+        sites?: {
+            line: number;
+            column: number;
+        }[] | undefined;
+    }, {
+        kind: "Defines" | "Calls" | "Instantiates" | "Overrides" | "Inherits" | "Implements" | "UsesType" | "Returns" | "Imports" | "ImportsType" | "References";
+        from: string;
+        to: string;
+        at?: {
+            line: number;
+            column: number;
+        } | undefined;
+        provenance?: "resolved" | "heuristic" | "dispatch" | undefined;
+        sites?: {
+            line: number;
+            column: number;
+        }[] | undefined;
+    }>, "many">;
+    resolution: z.ZodOptional<z.ZodObject<{
+        callsTotal: z.ZodNumber;
+        callsResolved: z.ZodNumber;
+        unresolved: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        callsTotal: number;
+        callsResolved: number;
+        unresolved: Record<string, number>;
+    }, {
+        callsTotal: number;
+        callsResolved: number;
+        unresolved: Record<string, number>;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    nodes: {
+        kind: "File" | "Module" | "Class" | "Interface" | "Enum" | "TypeAlias" | "Function" | "Method" | "Property" | "Variable" | "Route" | "Component";
+        name: string;
+        id: string;
+        file: string;
+        qualifiedName: string;
+        tier: "deep" | "baseline";
+        range?: {
+            startLine: number;
+            endLine: number;
+        } | undefined;
+    }[];
+    edges: {
+        kind: "Defines" | "Calls" | "Instantiates" | "Overrides" | "Inherits" | "Implements" | "UsesType" | "Returns" | "Imports" | "ImportsType" | "References";
+        from: string;
+        to: string;
+        at?: {
+            line: number;
+            column: number;
+        } | undefined;
+        provenance?: "resolved" | "heuristic" | "dispatch" | undefined;
+        sites?: {
+            line: number;
+            column: number;
+        }[] | undefined;
+    }[];
+    type: "result";
+    id: number;
+    resolution?: {
+        callsTotal: number;
+        callsResolved: number;
+        unresolved: Record<string, number>;
+    } | undefined;
+}, {
+    nodes: {
+        kind: "File" | "Module" | "Class" | "Interface" | "Enum" | "TypeAlias" | "Function" | "Method" | "Property" | "Variable" | "Route" | "Component";
+        name: string;
+        id: string;
+        file: string;
+        qualifiedName: string;
+        tier: "deep" | "baseline";
+        range?: {
+            startLine: number;
+            endLine: number;
+        } | undefined;
+    }[];
+    edges: {
+        kind: "Defines" | "Calls" | "Instantiates" | "Overrides" | "Inherits" | "Implements" | "UsesType" | "Returns" | "Imports" | "ImportsType" | "References";
+        from: string;
+        to: string;
+        at?: {
+            line: number;
+            column: number;
+        } | undefined;
+        provenance?: "resolved" | "heuristic" | "dispatch" | undefined;
+        sites?: {
+            line: number;
+            column: number;
+        }[] | undefined;
+    }[];
+    type: "result";
+    id: number;
+    resolution?: {
+        callsTotal: number;
+        callsResolved: number;
+        unresolved: Record<string, number>;
+    } | undefined;
+}>;
+/** Any message a sidecar sends to Ama. */
+export declare const sidecarMessageSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"ready">;
+    language: z.ZodString;
+    version: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "ready";
+    language: string;
+    version?: string | undefined;
+}, {
+    type: "ready";
+    language: string;
+    version?: string | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"result">;
+    id: z.ZodNumber;
+    nodes: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodEnum<["File", "Module", "Class", "Interface", "Enum", "TypeAlias", "Function", "Method", "Property", "Variable", "Route", "Component"]>;
+        name: z.ZodString;
+        file: z.ZodString;
+        qualifiedName: z.ZodString;
+        range: z.ZodOptional<z.ZodObject<{
+            startLine: z.ZodNumber;
+            endLine: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            startLine: number;
+            endLine: number;
+        }, {
+            startLine: number;
+            endLine: number;
+        }>>;
+        tier: z.ZodEnum<["deep", "baseline"]>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "File" | "Module" | "Class" | "Interface" | "Enum" | "TypeAlias" | "Function" | "Method" | "Property" | "Variable" | "Route" | "Component";
+        name: string;
+        id: string;
+        file: string;
+        qualifiedName: string;
+        tier: "deep" | "baseline";
+        range?: {
+            startLine: number;
+            endLine: number;
+        } | undefined;
+    }, {
+        kind: "File" | "Module" | "Class" | "Interface" | "Enum" | "TypeAlias" | "Function" | "Method" | "Property" | "Variable" | "Route" | "Component";
+        name: string;
+        id: string;
+        file: string;
+        qualifiedName: string;
+        tier: "deep" | "baseline";
+        range?: {
+            startLine: number;
+            endLine: number;
+        } | undefined;
+    }>, "many">;
+    edges: z.ZodArray<z.ZodObject<{
+        from: z.ZodString;
+        to: z.ZodString;
+        kind: z.ZodEnum<["Defines", "Calls", "Instantiates", "Overrides", "Inherits", "Implements", "UsesType", "Returns", "Imports", "ImportsType", "References"]>;
+        provenance: z.ZodOptional<z.ZodEnum<["resolved", "heuristic", "dispatch"]>>;
+        at: z.ZodOptional<z.ZodObject<{
+            line: z.ZodNumber;
+            column: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            line: number;
+            column: number;
+        }, {
+            line: number;
+            column: number;
+        }>>;
+        sites: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            line: z.ZodNumber;
+            column: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            line: number;
+            column: number;
+        }, {
+            line: number;
+            column: number;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "Defines" | "Calls" | "Instantiates" | "Overrides" | "Inherits" | "Implements" | "UsesType" | "Returns" | "Imports" | "ImportsType" | "References";
+        from: string;
+        to: string;
+        at?: {
+            line: number;
+            column: number;
+        } | undefined;
+        provenance?: "resolved" | "heuristic" | "dispatch" | undefined;
+        sites?: {
+            line: number;
+            column: number;
+        }[] | undefined;
+    }, {
+        kind: "Defines" | "Calls" | "Instantiates" | "Overrides" | "Inherits" | "Implements" | "UsesType" | "Returns" | "Imports" | "ImportsType" | "References";
+        from: string;
+        to: string;
+        at?: {
+            line: number;
+            column: number;
+        } | undefined;
+        provenance?: "resolved" | "heuristic" | "dispatch" | undefined;
+        sites?: {
+            line: number;
+            column: number;
+        }[] | undefined;
+    }>, "many">;
+    resolution: z.ZodOptional<z.ZodObject<{
+        callsTotal: z.ZodNumber;
+        callsResolved: z.ZodNumber;
+        unresolved: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        callsTotal: number;
+        callsResolved: number;
+        unresolved: Record<string, number>;
+    }, {
+        callsTotal: number;
+        callsResolved: number;
+        unresolved: Record<string, number>;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    nodes: {
+        kind: "File" | "Module" | "Class" | "Interface" | "Enum" | "TypeAlias" | "Function" | "Method" | "Property" | "Variable" | "Route" | "Component";
+        name: string;
+        id: string;
+        file: string;
+        qualifiedName: string;
+        tier: "deep" | "baseline";
+        range?: {
+            startLine: number;
+            endLine: number;
+        } | undefined;
+    }[];
+    edges: {
+        kind: "Defines" | "Calls" | "Instantiates" | "Overrides" | "Inherits" | "Implements" | "UsesType" | "Returns" | "Imports" | "ImportsType" | "References";
+        from: string;
+        to: string;
+        at?: {
+            line: number;
+            column: number;
+        } | undefined;
+        provenance?: "resolved" | "heuristic" | "dispatch" | undefined;
+        sites?: {
+            line: number;
+            column: number;
+        }[] | undefined;
+    }[];
+    type: "result";
+    id: number;
+    resolution?: {
+        callsTotal: number;
+        callsResolved: number;
+        unresolved: Record<string, number>;
+    } | undefined;
+}, {
+    nodes: {
+        kind: "File" | "Module" | "Class" | "Interface" | "Enum" | "TypeAlias" | "Function" | "Method" | "Property" | "Variable" | "Route" | "Component";
+        name: string;
+        id: string;
+        file: string;
+        qualifiedName: string;
+        tier: "deep" | "baseline";
+        range?: {
+            startLine: number;
+            endLine: number;
+        } | undefined;
+    }[];
+    edges: {
+        kind: "Defines" | "Calls" | "Instantiates" | "Overrides" | "Inherits" | "Implements" | "UsesType" | "Returns" | "Imports" | "ImportsType" | "References";
+        from: string;
+        to: string;
+        at?: {
+            line: number;
+            column: number;
+        } | undefined;
+        provenance?: "resolved" | "heuristic" | "dispatch" | undefined;
+        sites?: {
+            line: number;
+            column: number;
+        }[] | undefined;
+    }[];
+    type: "result";
+    id: number;
+    resolution?: {
+        callsTotal: number;
+        callsResolved: number;
+        unresolved: Record<string, number>;
+    } | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"error">;
+    id: z.ZodOptional<z.ZodNumber>;
+    message: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "error";
+    message: string;
+    id?: number | undefined;
+}, {
+    type: "error";
+    message: string;
+    id?: number | undefined;
+}>]>;
+export type AnalyzeRequest = z.infer<typeof analyzeRequestSchema>;
+export type SidecarMessage = z.infer<typeof sidecarMessageSchema>;
+export type AnalyzeResult = z.infer<typeof resultSchema>;
+/** Encode a protocol message as one NDJSON line (its JSON, plus the framing newline).
+ *  Used by both ends; a message must contain no raw newline of its own (JSON escapes them). */
+export declare function frame(message: AnalyzeRequest | SidecarMessage): string;
+/** Parse one inbound line as an `analyze` request (the sidecar's side). Throws (ZodError
+ *  or SyntaxError) on a malformed or invalid line. */
+export declare function parseRequest(line: string): AnalyzeRequest;
+/** Parse one inbound line as a sidecar message (Ama's side). Throws on a malformed or
+ *  invalid line, so a buggy sidecar can't inject an ill-formed node/edge into the graph. */
+export declare function parseMessage(line: string): SidecarMessage;
+export {};
+//# sourceMappingURL=protocol.d.ts.map

package/dist/analyzers/sidecar/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../../src/analyzers/sidecar/protocol.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA8BxB;wDACwD;AACxD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQ1B,CAAC;AAEH,uCAAuC;AACvC,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAO1B,CAAC;AAQH;qDACqD;AACrD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;EAK/B,CAAC;AASH,0DAA0D;AAC1D,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMhB,CAAC;AASH,0CAA0C;AAC1C,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAI/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAEzD;+FAC+F;AAC/F,wBAAgB,KAAK,CAAC,OAAO,EAAE,cAAc,GAAG,cAAc,GAAG,MAAM,CAEtE;AAED;sDACsD;AACtD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAEzD;AAED;4FAC4F;AAC5F,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAEzD"}