narai-primitives 2.0.0-rc.1

package/dist/toolkit/connector.js

@@ -0,0 +1,593 @@
+import { parseAgentArgs } from "./agent_cli.js";
+import { createAuditWriter, scrubSecrets } from "./audit/writer.js";
+import { readFirstMatchingPattern } from "./hardship/read.js";
+import { createHardshipRecorder } from "./hardship/record.js";
+import { buildCurateSnapshot } from "./plugin/curate-cmd.js";
+import { ApprovalEngine } from "./policy/approval.js";
+import { loadPolicyConfig } from "./policy/config.js";
+import { checkPolicy } from "./policy/gate.js";
+import { DEFAULT_POLICY, } from "./policy/types.js";
+/**
+ * Helper for writing a single action spec with full param-type inference.
+ * TypeScript can't thread `z.infer<S>` through the `actions` record on its
+ * own, so wrapping each spec in `defineAction` gives the handler's `p` the
+ * exact schema-inferred type without manual annotations.
+ *
+ * Usage:
+ *   actions: {
+ *     list_functions: defineAction({
+ *       params: z.object({ region: z.string() }),
+ *       classify: { kind: "read" },
+ *       handler: async (p, ctx) => ctx.sdk.lambda.list(p),
+ *     }),
+ *   },
+ */
+export function defineAction(spec) {
+    return spec;
+}
+/**
+ * Escape hatch for handlers that need to emit a non-success envelope the
+ * base framework doesn't model directly. Throw this from a handler with
+ * the exact envelope shape you want returned — the framework will add the
+ * `action` field and emit it verbatim.
+ *
+ * Typical use: `db-agent-connector` throws this for `denied` / `escalate` /
+ * `present_only` results coming back from its internal policy gate, since
+ * those are shaped with additional fields (`reason`, `formatted_sql`,
+ * `execution_time_ms`) that ErrorEnvelope can't carry.
+ *
+ * Prefer the `classify` hook + `extendDecision` for policy-gate-driven
+ * envelopes whenever possible — this escape hatch is for cases where the
+ * status decision can only be made after running the handler.
+ */
+export class EnvelopeOverride extends Error {
+    envelope;
+    constructor(envelope) {
+        super(`EnvelopeOverride: ${envelope.status}`);
+        this.name = "EnvelopeOverride";
+        this.envelope = envelope;
+    }
+}
+// ───────────────────────────────────────────────────────────────────────────
+// Error-code mapping defaults
+// ───────────────────────────────────────────────────────────────────────────
+const RETRIABLE_CODES = new Set([
+    "RATE_LIMITED",
+    "TIMEOUT",
+    "CONNECTION_ERROR",
+]);
+function isZodErrorLike(err) {
+    if (err === null || typeof err !== "object")
+        return false;
+    const e = err;
+    return (e["name"] === "ZodError" &&
+        Array.isArray(e["issues"]) &&
+        e["issues"].every((i) => {
+            if (!i || typeof i !== "object")
+                return false;
+            const issue = i;
+            return Array.isArray(issue["path"]) && typeof issue["message"] === "string";
+        }));
+}
+function defaultErrorMap(err) {
+    // Structural check instead of `instanceof z.ZodError` because consumers
+    // may install toolkit via `file:` deps or otherwise end up with their
+    // own zod instance — instanceof would return false and the error would
+    // leak through as a misclassified CONNECTION_ERROR. Duck-typing on
+    // `name === "ZodError"` + shape catches every zod instance regardless
+    // of module identity.
+    if (isZodErrorLike(err)) {
+        const msg = err.issues
+            .map((i) => `${i.path.join(".") || "<root>"}: ${i.message}`)
+            .join("; ");
+        return { error_code: "VALIDATION_ERROR", message: msg };
+    }
+    const message = err instanceof Error ? err.message : String(err);
+    // Heuristic mapping — connectors override via mapError for service-specific codes.
+    const lower = message.toLowerCase();
+    if (lower.includes("enotfound") || lower.includes("econnrefused") || lower.includes("network")) {
+        return { error_code: "CONNECTION_ERROR", message };
+    }
+    if (lower.includes("timeout") || lower.includes("etimedout")) {
+        return { error_code: "TIMEOUT", message };
+    }
+    if (lower.includes("401") || lower.includes("unauthor") || lower.includes("forbidden")) {
+        return { error_code: "AUTH_ERROR", message };
+    }
+    if (lower.includes("404") || lower.includes("not found")) {
+        return { error_code: "NOT_FOUND", message };
+    }
+    if (lower.includes("429") || lower.includes("rate limit")) {
+        return { error_code: "RATE_LIMITED", message };
+    }
+    if (lower.includes("sdk") && lower.includes("not installed")) {
+        return { error_code: "CONFIG_ERROR", message };
+    }
+    return { error_code: "CONNECTION_ERROR", message };
+}
+// ───────────────────────────────────────────────────────────────────────────
+// Factory
+// ───────────────────────────────────────────────────────────────────────────
+export function createConnector(cfg) {
+    if (cfg.name.length === 0) {
+        throw new Error("createConnector: 'name' is required");
+    }
+    if (Object.keys(cfg.actions).length === 0) {
+        throw new Error(`createConnector(${cfg.name}): at least one action must be declared`);
+    }
+    const validActions = new Set(Object.keys(cfg.actions));
+    // Policy config — loaded once per connector instance.
+    let loadedPolicy = null;
+    let policyLoadError = null;
+    if (cfg.disablePolicyDiscovery !== true) {
+        try {
+            loadedPolicy = loadPolicyConfig({
+                name: cfg.name,
+                floorAspects: cfg.policyFloorAspects ?? [],
+                ...(cfg.policyConfigPath !== undefined
+                    ? { explicitPath: cfg.policyConfigPath }
+                    : {}),
+            });
+        }
+        catch (err) {
+            // Surface config errors deterministically on first call via fetch.
+            policyLoadError = err instanceof Error ? err.message : String(err);
+        }
+    }
+    const rules = loadedPolicy?.rules ?? cfg.defaultPolicy ?? DEFAULT_POLICY;
+    const approvalMode = loadedPolicy?.approval_mode ?? "auto";
+    // Audit + approval engine + hardship recorder (all instance-scoped).
+    const audit = createAuditWriter(cfg.audit !== undefined
+        ? {
+            enabled: cfg.audit.enabled,
+            ...(cfg.audit.path !== undefined ? { path: cfg.audit.path } : {}),
+        }
+        : { enabled: false });
+    const approvals = new ApprovalEngine({
+        onGrantExpired: (grantType) => audit.logEvent({ event_type: "grant_expired", grant_type: grantType }),
+    });
+    const recorder = cfg.hardship?.recorder ??
+        createHardshipRecorder({
+            connector: cfg.name,
+            ...(cfg.hardship?.enabled !== undefined ? { enabled: cfg.hardship.enabled } : {}),
+            sessionId: audit.sessionId,
+        });
+    // Lazy SDK loading — only on first success decision.
+    let sdkPromise = null;
+    const loadSdk = async () => {
+        if (cfg.sdk === undefined)
+            return undefined;
+        if (sdkPromise === null)
+            sdkPromise = cfg.sdk();
+        return sdkPromise;
+    };
+    // Lazy credentials loading — only on first success decision.
+    let credsPromise = null;
+    const loadCreds = async () => {
+        if (credsPromise === null)
+            credsPromise = cfg.credentials();
+        return credsPromise;
+    };
+    // Track last successful SDK resolution for recordResolution defaulting.
+    let lastCtx = null;
+    // ─── fetch ──────────────────────────────────────────────────────────────
+    const fetch = async (action, params) => {
+        // Argument validation: action must be registered.
+        if (!validActions.has(action)) {
+            return {
+                status: "error",
+                action,
+                error_code: "VALIDATION_ERROR",
+                message: `Unknown action '${action}'. Valid: ${[...validActions].join(", ")}`,
+                retriable: false,
+            };
+        }
+        if (policyLoadError !== null) {
+            return {
+                status: "error",
+                action,
+                error_code: "CONFIG_ERROR",
+                message: `Policy config error: ${policyLoadError}`,
+                retriable: false,
+            };
+        }
+        const spec = cfg.actions[action];
+        const start = Date.now();
+        // 1. Validate params via Zod.
+        const parsed = spec.params.safeParse(params);
+        if (!parsed.success) {
+            const mapped = defaultErrorMap(parsed.error);
+            const env = {
+                status: "error",
+                action,
+                error_code: mapped.error_code,
+                message: mapped.message,
+                retriable: false,
+            };
+            audit.logEvent({
+                event_type: "action",
+                connector: cfg.name,
+                action,
+                status: "error",
+                execution_time_ms: Date.now() - start,
+            });
+            recorder({
+                action,
+                kind: "validation",
+                context: mapped.message,
+                scope: safeScope(cfg, { sdk: undefined, action, params }),
+            });
+            return env;
+        }
+        const validated = parsed.data;
+        // 2. Classify (factory hook wins; else per-action static/fn classify).
+        let classification;
+        try {
+            if (cfg.classify !== undefined) {
+                classification = await cfg.classify(action, validated);
+            }
+            else if (typeof spec.classify === "function") {
+                classification = spec.classify(validated);
+            }
+            else {
+                classification = spec.classify;
+            }
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return errorEnvelope(action, "CONFIG_ERROR", `classify() threw: ${message}`, false, start);
+        }
+        // 3. Policy gate.
+        let decision = checkPolicy(classification, rules, approvalMode, approvals);
+        // 4. extendDecision hook: may widen Decision into an ExtendedEnvelope.
+        let extended = decision;
+        if (cfg.extendDecision !== undefined) {
+            try {
+                extended = cfg.extendDecision(decision, {
+                    action,
+                    params: validated,
+                    classification,
+                });
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                return errorEnvelope(action, "CONFIG_ERROR", `extendDecision() threw: ${message}`, false, start);
+            }
+        }
+        audit.logEvent({
+            event_type: `policy_${decision.status}`,
+            connector: cfg.name,
+            action,
+            reason: decision.reason,
+            kind: classification.kind,
+            ...(classification.aspects !== undefined ? { aspects: classification.aspects } : {}),
+        });
+        // 5. If not a base success, the caller gets an envelope now (no SDK load).
+        if (isEnvelopeLike(extended)) {
+            return toEnvelope(cfg.name, action, extended, start, audit);
+        }
+        if (decision.status === "denied") {
+            const deniedScope = safeScope(cfg, { sdk: undefined, action, params: validated });
+            const deniedHitOpts = {
+                connector: cfg.name,
+                scope: deniedScope,
+                facts: { kind: "policy_denied", action, context: decision.reason },
+            };
+            if (cfg.runtime?.cwd !== undefined)
+                deniedHitOpts.cwd = cfg.runtime.cwd;
+            if (cfg.runtime?.home !== undefined)
+                deniedHitOpts.home = cfg.runtime.home;
+            const deniedHit = readFirstMatchingPattern(deniedHitOpts);
+            const env = {
+                status: "denied",
+                action,
+                reason: decision.reason,
+                ...(deniedHit
+                    ? {
+                        resolution_hint: {
+                            pattern_id: deniedHit.match.pattern_id,
+                            advice: deniedHit.match.advice,
+                            confidence: deniedHit.match.confidence,
+                            scope: deniedHit.scopeLevel,
+                        },
+                    }
+                    : {}),
+            };
+            auditAction(audit, cfg.name, action, "denied", start);
+            return env;
+        }
+        if (decision.status === "escalate") {
+            const escalateScope = safeScope(cfg, { sdk: undefined, action, params: validated });
+            const escalateHitOpts = {
+                connector: cfg.name,
+                scope: escalateScope,
+                facts: { kind: "policy_escalate", action, context: decision.reason },
+            };
+            if (cfg.runtime?.cwd !== undefined)
+                escalateHitOpts.cwd = cfg.runtime.cwd;
+            if (cfg.runtime?.home !== undefined)
+                escalateHitOpts.home = cfg.runtime.home;
+            const escalateHit = readFirstMatchingPattern(escalateHitOpts);
+            const env = {
+                status: "escalate",
+                action,
+                reason: decision.reason,
+                ...(escalateHit
+                    ? {
+                        resolution_hint: {
+                            pattern_id: escalateHit.match.pattern_id,
+                            advice: escalateHit.match.advice,
+                            confidence: escalateHit.match.confidence,
+                            scope: escalateHit.scopeLevel,
+                        },
+                    }
+                    : {}),
+            };
+            auditAction(audit, cfg.name, action, "escalate", start);
+            return env;
+        }
+        // 6. decision.status === "success". Load SDK + creds lazily, run handler.
+        let sdk;
+        let credentials;
+        try {
+            [sdk, credentials] = await Promise.all([loadSdk(), loadCreds()]);
+        }
+        catch (err) {
+            return mapAndBuildError(err, action, cfg, audit, recorder, classification, start, undefined, validated);
+        }
+        lastCtx = { sdk, action, params: validated };
+        const ctx = {
+            sdk,
+            credentials,
+            policy: decision,
+            recordHardship: recorder,
+            logger: {
+                debug: (msg) => audit.logEvent({ event_type: "debug", details: { msg } }),
+                warn: (msg) => audit.logEvent({ event_type: "warn", details: { msg } }),
+            },
+        };
+        let data;
+        try {
+            data = await spec.handler(validated, ctx);
+        }
+        catch (err) {
+            // Handlers can emit any envelope shape via EnvelopeOverride.
+            if (err instanceof EnvelopeOverride) {
+                const envOverride = { ...err.envelope, action };
+                auditAction(audit, cfg.name, action, envOverride.status, start);
+                return envOverride;
+            }
+            return mapAndBuildError(err, action, cfg, audit, recorder, classification, start, sdk, validated);
+        }
+        const env = {
+            status: "success",
+            action,
+            data: isRecord(data) ? data : { result: data },
+        };
+        auditAction(audit, cfg.name, action, "success", start);
+        return env;
+    };
+    // ─── main ───────────────────────────────────────────────────────────────
+    const main = async (argv) => {
+        // --help / --curate / --version are handled here before action dispatch.
+        if (argv.includes("--help") || argv.includes("-h")) {
+            printHelp(cfg);
+            return 0;
+        }
+        if (argv.includes("--curate")) {
+            const snap = buildCurateSnapshot({ connector: cfg.name });
+            process.stdout.write(JSON.stringify(snap, null, 2) + "\n");
+            return 0;
+        }
+        if (argv.includes("--version") || argv.includes("-v")) {
+            process.stdout.write(`${cfg.name} ${cfg.version ?? ""}\n`);
+            return 0;
+        }
+        // Argument errors emit a structured envelope on stdout (status=error,
+        // error_code=VALIDATION_ERROR) so consumers parsing JSON from stdout never
+        // hit the case where stdout is empty and the failure is text on stderr.
+        // Exit code is 2 (CLI misuse), distinct from 1 (handled action-level error).
+        const writeArgErrorEnvelope = (action, message) => {
+            const env = {
+                status: "error",
+                action,
+                error_code: "VALIDATION_ERROR",
+                message,
+                retriable: false,
+            };
+            process.stdout.write(JSON.stringify(env) + "\n");
+            process.stderr.write(`argument error: ${message}\n`);
+        };
+        let parsed;
+        try {
+            parsed = parseAgentArgs(argv, { flags: ["action", "params"] });
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            writeArgErrorEnvelope("<unknown>", msg);
+            return 2;
+        }
+        const action = parsed.action;
+        const paramsRaw = parsed.params ?? "{}";
+        if (typeof action !== "string" || action.length === 0) {
+            writeArgErrorEnvelope("<unknown>", "--action is required");
+            return 2;
+        }
+        let params;
+        try {
+            params = JSON.parse(paramsRaw);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            writeArgErrorEnvelope(action, `--params must be valid JSON (${msg})`);
+            return 2;
+        }
+        const env = await fetch(action, params);
+        process.stdout.write(JSON.stringify(env) + "\n");
+        return exitCodeForEnvelope(env);
+    };
+    return {
+        main,
+        fetch,
+        validActions,
+        name: cfg.name,
+        recordResolution(input) {
+            const scope = input.scope !== undefined
+                ? input.scope
+                : lastCtx && cfg.scope
+                    ? safeScope(cfg, lastCtx)
+                    : null;
+            recorder({
+                action: input.action ?? lastCtx?.action ?? "unknown",
+                kind: "resolution",
+                context: `pattern=${input.pattern_id}`,
+                resolution: input.advice,
+                scope,
+            });
+        },
+    };
+}
+// ───────────────────────────────────────────────────────────────────────────
+// Helpers
+// ───────────────────────────────────────────────────────────────────────────
+function isRecord(v) {
+    return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+function isEnvelopeLike(v) {
+    if (!isRecord(v))
+        return false;
+    const status = v["status"];
+    if (typeof status !== "string")
+        return false;
+    // Base decision statuses (success/denied/escalate) come back from
+    // checkPolicy without an `action` field; anything else is an extension.
+    const action = v["action"];
+    return typeof action === "string";
+}
+function toEnvelope(connector, action, value, start, audit) {
+    if (isEnvelopeLike(value)) {
+        auditAction(audit, connector, action, value.status, start);
+        return value;
+    }
+    // Fallback: decision without envelope form (shouldn't hit in practice —
+    // main path handles base decisions explicitly).
+    auditAction(audit, connector, action, value.status, start);
+    return {
+        status: value.status,
+        action,
+        message: value.reason,
+        extension: {},
+    };
+}
+function auditAction(audit, connector, action, status, start) {
+    audit.logEvent({
+        event_type: "action",
+        connector,
+        action,
+        status,
+        execution_time_ms: Date.now() - start,
+    });
+}
+function errorEnvelope(action, code, message, retriable, _start) {
+    return {
+        status: "error",
+        action,
+        error_code: code,
+        message,
+        retriable,
+    };
+}
+function safeScope(cfg, ctx) {
+    if (!cfg.scope)
+        return null;
+    try {
+        return cfg.scope(ctx);
+    }
+    catch {
+        return null;
+    }
+}
+function mapAndBuildError(err, action, cfg, audit, recorder, _classification, start, sdk, params) {
+    let code;
+    let message;
+    let retriable;
+    const override = cfg.mapError?.(err, action);
+    if (override?.error_code !== undefined && override?.message !== undefined) {
+        code = override.error_code;
+        message = override.message;
+        retriable = override.retriable ?? RETRIABLE_CODES.has(code);
+    }
+    else {
+        const def = defaultErrorMap(err);
+        code = def.error_code;
+        message = def.message;
+        retriable = RETRIABLE_CODES.has(code);
+    }
+    const scope = safeScope(cfg, { sdk, action, params });
+    auditAction(audit, cfg.name, action, "error", start);
+    recorder({
+        action,
+        kind: code.toLowerCase(),
+        context: scrubSecrets(message),
+        scope,
+    });
+    const hitOpts = {
+        connector: cfg.name,
+        scope,
+        facts: {
+            kind: code.toLowerCase(),
+            action,
+            context: scrubSecrets(message),
+        },
+    };
+    if (cfg.runtime?.cwd !== undefined)
+        hitOpts.cwd = cfg.runtime.cwd;
+    if (cfg.runtime?.home !== undefined)
+        hitOpts.home = cfg.runtime.home;
+    const hit = readFirstMatchingPattern(hitOpts);
+    return {
+        status: "error",
+        action,
+        error_code: code,
+        message,
+        retriable,
+        ...(hit
+            ? {
+                resolution_hint: {
+                    pattern_id: hit.match.pattern_id,
+                    advice: hit.match.advice,
+                    confidence: hit.match.confidence,
+                    scope: hit.scopeLevel,
+                },
+            }
+            : {}),
+    };
+}
+function exitCodeForEnvelope(env) {
+    const status = env.status;
+    if (status === "success")
+        return 0;
+    // Connector-extended "presentation" statuses (e.g. db-agent's present_only)
+    // exit 0 since they represent a valid non-error response.
+    if (typeof status === "string" && status.startsWith("present"))
+        return 0;
+    return 1;
+}
+function printHelp(cfg) {
+    const lines = [
+        `${cfg.name}${cfg.version ? ` (${cfg.version})` : ""}`,
+        "",
+        "Usage:",
+        `  ${cfg.name} --action <name> --params '<json>'`,
+        `  ${cfg.name} --curate                 # dump hardship clusters as JSON`,
+        `  ${cfg.name} --help | --version`,
+        "",
+        "Actions:",
+    ];
+    for (const [name, spec] of Object.entries(cfg.actions)) {
+        const desc = spec.description ?? "";
+        lines.push(`  ${name.padEnd(24)} ${desc}`);
+    }
+    process.stdout.write(lines.join("\n") + "\n");
+}
+//# sourceMappingURL=connector.js.map

package/dist/toolkit/connector.js.map

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

package/dist/toolkit/extract_binary.d.ts

@@ -0,0 +1,45 @@
+#!/usr/bin/env node
+import { importOptional } from "./_optional.js";
+export declare const FORMAT_MAP: Readonly<Record<string, "pdf" | "docx" | "pptx">>;
+export type BinaryFormat = "pdf" | "docx" | "pptx";
+export { importOptional };
+export interface ExtractOptions {
+    maxBytes?: number;
+}
+export interface ExtractResult {
+    format: BinaryFormat;
+    text: string;
+    sizeBytes: number;
+}
+export declare class ExtractCapExceeded extends Error {
+    readonly sizeBytes: number;
+    readonly maxBytes: number;
+    constructor(sizeBytes: number, maxBytes: number);
+}
+/**
+ * Normalize extracted plain text so PDF / DOCX / PPTX outputs share the
+ * same shape as the Python pipeline:
+ *   - strip per-line trailing whitespace
+ *   - collapse 3+ consecutive newlines down to exactly 2
+ *   - trim leading/trailing whitespace overall
+ */
+export declare function normalizeExtracted(text: string): string;
+/**
+ * Extract text from a PDF file using pdfjs-dist's legacy build (Node-safe).
+ * Per-format helpers return raw strings; `extract()` wraps into ExtractResult.
+ */
+export declare function extractPdf(filePath: string): Promise<string>;
+/** Extract text from a DOCX file using mammoth's undocumented `convertToMarkdown`. */
+export declare function extractDocx(filePath: string): Promise<string>;
+/** Extract text from a PPTX file using JSZip + fast-xml-parser. */
+export declare function extractPptx(filePath: string): Promise<string>;
+/**
+ * Extract text from a binary file to markdown, returning `ExtractResult`.
+ *
+ * Enforces a size cap (default 50 MiB) before reading the file; throws
+ * `ExtractCapExceeded` when exceeded. If `fmt` is not given, auto-detects
+ * from the file extension.
+ */
+export declare function extract(inputPath: string, fmt?: BinaryFormat | null, opts?: ExtractOptions): Promise<ExtractResult>;
+export declare function main(argv?: readonly string[]): Promise<number>;
+//# sourceMappingURL=extract_binary.d.ts.map

package/dist/toolkit/extract_binary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract_binary.d.ts","sourceRoot":"","sources":["../../src/toolkit/extract_binary.ts"],"names":[],"mappings":";AAwBA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAIhD,eAAO,MAAM,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC,CAIxE,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAEnD,OAAO,EAAE,cAAc,EAAE,CAAC;AAM1B,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,YAAY,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,kBAAmB,SAAQ,KAAK;aAEzB,SAAS,EAAE,MAAM;aACjB,QAAQ,EAAE,MAAM;gBADhB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM;CAKnC;AAID;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOvD;AA8BD;;;GAGG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA2BlE;AAeD,sFAAsF;AACtF,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAenE;AAuFD,mEAAmE;AACnE,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAwCnE;AASD;;;;;;GAMG;AACH,wBAAsB,OAAO,CAC3B,SAAS,EAAE,MAAM,EACjB,GAAG,GAAE,YAAY,GAAG,IAAW,EAC/B,IAAI,CAAC,EAAE,cAAc,GACpB,OAAO,CAAC,aAAa,CAAC,CA4BxB;AAuED,wBAAsB,IAAI,CACxB,IAAI,GAAE,SAAS,MAAM,EAA0B,GAC9C,OAAO,CAAC,MAAM,CAAC,CAqBjB"}