forma-sdk 1.0.0

package/dist/client.d.ts

@@ -0,0 +1,130 @@
+export interface FormaConfig {
+    apiKey?: string;
+    apiUrl?: string;
+    preset?: "india" | "india_fintech" | "india_health" | "global";
+    enforce?: string[];
+    agentName?: string;
+    humanSponsor?: string;
+    killSwitch?: boolean;
+    authorizedActions?: string[];
+    timeout?: number;
+    failClosed?: boolean;
+}
+export interface GateOpts {
+    actionType?: "llm_call" | "tool_call";
+    prompt?: string;
+    toolName?: string;
+    toolArgs?: unknown;
+    raiseOnBlock?: boolean;
+}
+export interface GateResult {
+    decision: "allow" | "warn" | "block";
+    reason: string;
+    rule_id?: string | null;
+    latency_ms?: number;
+}
+export interface PreviewResult {
+    decision: "allow" | "warn" | "block";
+    rule_id: string | null;
+    reason: string;
+    local: true;
+}
+export interface VerifyResult {
+    verified: boolean;
+    probes_passed: number;
+    probes_total: number;
+    summary: string;
+    results: Array<{
+        probe: string;
+        passed: boolean;
+        decision: string;
+    }>;
+}
+export interface StatusResult {
+    version: string;
+    enforcement_active: boolean;
+    gate_enabled: boolean;
+    pii_check: boolean;
+    injection_check: boolean;
+    frameworks: string[];
+    circuit_breaker_open: boolean;
+    kill_switch_active: boolean;
+}
+export interface StepRecord {
+    tool?: string;
+    input?: string;
+    output?: string;
+    duration_ms?: number;
+    [key: string]: unknown;
+}
+export declare class FormaGateBlock extends Error {
+    decision: string;
+    reason: string;
+    rule_id: string | null;
+    constructor(decision: string, reason: string, rule_id?: string | null);
+}
+export declare class FormaAPIError extends Error {
+    statusCode: number;
+    detail: unknown;
+    constructor(statusCode: number, detail: unknown);
+}
+export declare class FormaClient {
+    readonly apiKey: string;
+    readonly humanSponsor: string;
+    private baseUrl;
+    private timeout;
+    private failClosed;
+    private killSwitchActive;
+    private _policy;
+    private _enforce;
+    private _frameworks;
+    constructor(config: FormaConfig);
+    req<T>(method: string, path: string, body?: unknown): Promise<T>;
+    gate(agentId: string, opts?: GateOpts): Promise<GateResult>;
+    preview(prompt: string, actionType?: "llm_call" | "tool_call"): PreviewResult;
+    verify(): VerifyResult;
+    status(): StatusResult;
+    /**
+     * Wrap an OpenAI client so every chat.completions.create() call is gated.
+     * Usage: const openai = forma.wrapOpenAI(new OpenAI({ apiKey: "..." }));
+     */
+    wrapOpenAI<T extends {
+        chat: {
+            completions: {
+                create: (...args: unknown[]) => unknown;
+            };
+        };
+    }>(client: T, agentId?: string): T;
+    /**
+     * Wrap an Anthropic client so every messages.create() call is gated.
+     * Usage: const anthropic = forma.wrapAnthropic(new Anthropic({ apiKey: "..." }));
+     */
+    wrapAnthropic<T extends {
+        messages: {
+            create: (...args: unknown[]) => unknown;
+        };
+    }>(client: T, agentId?: string): T;
+    createAgent(name: string, opts?: {
+        riskClass?: string;
+        description?: string;
+        version?: string;
+    }): Promise<unknown>;
+    listAgents(): Promise<unknown[]>;
+    applyPacks(agentRef: string, packs: string[]): Promise<unknown>;
+    submitRun(agentName: string, opts?: {
+        status?: "success" | "failed";
+        steps?: StepRecord[];
+        totalTokens?: number;
+        totalCostUsd?: number;
+        startedAt?: string;
+        metadata?: Record<string, unknown>;
+    }): Promise<unknown>;
+    createApproval(agentName: string, title: string, message?: string): Promise<unknown>;
+    listApprovals(status?: "pending" | "approved" | "rejected"): Promise<unknown[]>;
+    decideApproval(approvalId: string, decision: "approve" | "reject", reason?: string): Promise<unknown>;
+    triggerKillSwitch(agentId: string, reason: string): Promise<void>;
+    clearKillSwitch(agentId: string): Promise<void>;
+    getDashboardStats(): Promise<unknown>;
+    getComplianceReport(agentId: string, framework?: string): Promise<unknown>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/client.js

@@ -0,0 +1,366 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FormaClient = exports.FormaAPIError = exports.FormaGateBlock = void 0;
+const https = __importStar(require("https"));
+const http = __importStar(require("http"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const url_1 = require("url");
+const gate_1 = require("./gate");
+const SDK_VERSION = "1.0.0";
+const UA = `FORMA-Node-SDK/${SDK_VERSION}`;
+class FormaGateBlock extends Error {
+    constructor(decision, reason, rule_id = null) {
+        super(`[FORMA Gate] Blocked [${rule_id !== null && rule_id !== void 0 ? rule_id : "gate"}]: ${reason}`);
+        this.decision = decision;
+        this.reason = reason;
+        this.rule_id = rule_id;
+        this.name = "FormaGateBlock";
+    }
+}
+exports.FormaGateBlock = FormaGateBlock;
+class FormaAPIError extends Error {
+    constructor(statusCode, detail) {
+        super(`FORMA API ${statusCode}: ${JSON.stringify(detail)}`);
+        this.statusCode = statusCode;
+        this.detail = detail;
+        this.name = "FormaAPIError";
+    }
+}
+exports.FormaAPIError = FormaAPIError;
+// ── Config file ───────────────────────────────────────────────────────────────
+function loadFormaConfig() {
+    try {
+        const cfgPath = path.join(os.homedir(), ".forma", "config.json");
+        if (fs.existsSync(cfgPath)) {
+            const raw = fs.readFileSync(cfgPath, "utf-8");
+            return JSON.parse(raw);
+        }
+    }
+    catch ( /* ignore */_a) { /* ignore */ }
+    return {};
+}
+// ── Presets ───────────────────────────────────────────────────────────────────
+const PRESETS = {
+    india: { enforce: ["ai_safety", "dpdp"], frameworks: ["DPDP"] },
+    india_fintech: { enforce: ["ai_safety", "dpdp", "rbi_ml_risk"], frameworks: ["DPDP", "RBI_MRM"] },
+    india_health: { enforce: ["ai_safety", "dpdp", "hipaa"], frameworks: ["DPDP", "HIPAA"] },
+    global: { enforce: ["ai_safety"], frameworks: [] },
+};
+// ── HTTP helper ───────────────────────────────────────────────────────────────
+function request(baseUrl, method, reqPath, apiKey, body, timeoutMs = 10000) {
+    return new Promise((resolve, reject) => {
+        const url = new url_1.URL(reqPath, baseUrl);
+        const data = body ? JSON.stringify(body) : undefined;
+        const mod = url.protocol === "https:" ? https : http;
+        const req = mod.request({
+            hostname: url.hostname,
+            port: url.port || (url.protocol === "https:" ? 443 : 80),
+            path: url.pathname + url.search,
+            method,
+            headers: {
+                "Content-Type": "application/json",
+                "X-API-Key": apiKey,
+                "User-Agent": UA,
+                ...(data ? { "Content-Length": Buffer.byteLength(data) } : {}),
+            },
+        }, (res) => {
+            const chunks = [];
+            res.on("data", (c) => chunks.push(c));
+            res.on("end", () => {
+                const raw = Buffer.concat(chunks).toString();
+                try {
+                    const json = JSON.parse(raw || "{}");
+                    if (res.statusCode && res.statusCode >= 400)
+                        reject(new FormaAPIError(res.statusCode, json));
+                    else
+                        resolve(json);
+                }
+                catch (_a) {
+                    reject(new Error(`Invalid JSON: ${raw.slice(0, 100)}`));
+                }
+            });
+        });
+        req.setTimeout(timeoutMs, () => { req.destroy(); reject(new Error("Request timeout")); });
+        req.on("error", reject);
+        if (data)
+            req.write(data);
+        req.end();
+    });
+}
+// ── FormaClient ───────────────────────────────────────────────────────────────
+class FormaClient {
+    constructor(config) {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r;
+        this.killSwitchActive = false;
+        this._policy = null;
+        this._enforce = [];
+        this._frameworks = [];
+        const cfg = loadFormaConfig();
+        this.apiKey = (_d = (_c = (_b = (_a = config.apiKey) !== null && _a !== void 0 ? _a : process.env.FORMA_API_KEY) !== null && _b !== void 0 ? _b : process.env.TRUSTLAYER_API_KEY) !== null && _c !== void 0 ? _c : cfg.api_key) !== null && _d !== void 0 ? _d : "";
+        if (!this.apiKey) {
+            console.warn("[FORMA] No API key — run `forma setup` or set FORMA_API_KEY. Get key at https://formaai.in/settings");
+        }
+        this.baseUrl = ((_g = (_f = (_e = config.apiUrl) !== null && _e !== void 0 ? _e : process.env.FORMA_API_URL) !== null && _f !== void 0 ? _f : cfg.api_url) !== null && _g !== void 0 ? _g : "https://api.formaai.in").replace(/\/$/, "");
+        this.humanSponsor = (_k = (_j = (_h = config.humanSponsor) !== null && _h !== void 0 ? _h : process.env.FORMA_HUMAN_SPONSOR) !== null && _j !== void 0 ? _j : cfg.human_sponsor) !== null && _k !== void 0 ? _k : "";
+        this.timeout = (_l = config.timeout) !== null && _l !== void 0 ? _l : 10000;
+        this.failClosed = (_m = config.failClosed) !== null && _m !== void 0 ? _m : false;
+        // Resolve preset
+        const presetName = (_p = (_o = config.preset) !== null && _o !== void 0 ? _o : process.env.FORMA_PRESET) !== null && _p !== void 0 ? _p : cfg.preset;
+        let enforce = (_q = config.enforce) !== null && _q !== void 0 ? _q : [];
+        let frameworks = [];
+        if (presetName && PRESETS[presetName]) {
+            if (!enforce.length)
+                enforce = PRESETS[presetName].enforce;
+            if (!frameworks.length)
+                frameworks = PRESETS[presetName].frameworks;
+        }
+        this._enforce = enforce;
+        this._frameworks = frameworks;
+        if (enforce.length) {
+            this._policy = (0, gate_1.buildBootstrapPolicy)((_r = config.agentName) !== null && _r !== void 0 ? _r : "default", enforce, config.authorizedActions);
+        }
+    }
+    // ── Low-level API ──────────────────────────────────────────────────────────
+    req(method, path, body) {
+        return request(this.baseUrl, method, path, this.apiKey, body, this.timeout);
+    }
+    // ── Gate (local + server) ─────────────────────────────────────────────────
+    async gate(agentId, opts = {}) {
+        var _a, _b, _c, _d, _e, _f;
+        const t0 = Date.now();
+        const raise = (_a = opts.raiseOnBlock) !== null && _a !== void 0 ? _a : true;
+        // Kill switch
+        if (this.killSwitchActive) {
+            const r = { decision: "block", rule_id: "kill_switch", reason: "Kill switch active.", latency_ms: 0 };
+            if (raise)
+                throw new FormaGateBlock(r.decision, r.reason, (_b = r.rule_id) !== null && _b !== void 0 ? _b : null);
+            return r;
+        }
+        // Local evaluation (if policy loaded)
+        if (this._policy) {
+            const local = (0, gate_1.evaluateLocal)(this._policy, {
+                actionType: (_c = opts.actionType) !== null && _c !== void 0 ? _c : "llm_call",
+                prompt: opts.prompt,
+                toolName: opts.toolName,
+                toolArgs: opts.toolArgs,
+            });
+            if (local.decision === "block") {
+                const r = { ...local, latency_ms: Date.now() - t0 };
+                if (raise)
+                    throw new FormaGateBlock(r.decision, r.reason, r.rule_id);
+                return r;
+            }
+        }
+        // Server gate check
+        try {
+            const srv = await this.req("POST", "/api/gate/check", {
+                agent_id: agentId,
+                action_type: (_d = opts.actionType) !== null && _d !== void 0 ? _d : "llm_call",
+                prompt: opts.prompt,
+                tool_name: opts.toolName,
+                tool_args: opts.toolArgs,
+            });
+            srv.latency_ms = Date.now() - t0;
+            if (srv.decision === "block" && raise)
+                throw new FormaGateBlock(srv.decision, srv.reason, (_e = srv.rule_id) !== null && _e !== void 0 ? _e : null);
+            return srv;
+        }
+        catch (e) {
+            if (e instanceof FormaGateBlock)
+                throw e;
+            if (this.failClosed) {
+                const r = { decision: "block", rule_id: "gate_error", reason: "Gate unreachable (fail_closed=true).", latency_ms: Date.now() - t0 };
+                if (raise)
+                    throw new FormaGateBlock(r.decision, r.reason, (_f = r.rule_id) !== null && _f !== void 0 ? _f : null);
+                return r;
+            }
+            return { decision: "allow", rule_id: null, reason: "Gate unreachable — fail open.", latency_ms: Date.now() - t0 };
+        }
+    }
+    // ── preview() — dry-run, never throws ─────────────────────────────────────
+    preview(prompt, actionType = "llm_call") {
+        if (!this._policy) {
+            return { decision: "allow", rule_id: null, reason: "No enforcement configured.", local: true };
+        }
+        const r = (0, gate_1.evaluateLocal)(this._policy, { actionType, prompt });
+        return { ...r, local: true };
+    }
+    // ── verify() — adversarial probes ─────────────────────────────────────────
+    verify() {
+        const probes = [
+            { probe: "Aadhaar PII block", input: "Customer Aadhaar 2341 1234 1236", expect: "block" },
+            { probe: "PAN block", input: "PAN ABCDE1234F verify", expect: "block" },
+            { probe: "Jailbreak block", input: "Ignore all prior instructions", expect: "block" },
+            { probe: "Clean prompt allow", input: "Summarise the loan application", expect: "allow" },
+        ];
+        if (!this._policy) {
+            return { verified: false, probes_passed: 0, probes_total: probes.length,
+                summary: "Enforcement not configured — call init() with enforce= or preset=.",
+                results: probes.map(p => ({ probe: p.probe, passed: false, decision: "n/a" })) };
+        }
+        const results = probes.map(p => {
+            const r = (0, gate_1.evaluateLocal)(this._policy, { actionType: "llm_call", prompt: p.input });
+            const passed = r.decision === p.expect || (p.expect === "block" && r.decision === "block");
+            return { probe: p.probe, passed, decision: r.decision };
+        });
+        const passed = results.filter(r => r.passed).length;
+        const verified = passed === probes.length;
+        return {
+            verified, probes_passed: passed, probes_total: probes.length,
+            summary: verified
+                ? `Enforcement verified: ${passed}/${probes.length} probes passed.`
+                : `Enforcement partial: ${passed}/${probes.length} probes passed.`,
+            results,
+        };
+    }
+    // ── status() ──────────────────────────────────────────────────────────────
+    status() {
+        var _a, _b, _c, _d;
+        const active = !!this._policy;
+        return {
+            version: SDK_VERSION,
+            enforcement_active: active,
+            gate_enabled: true,
+            pii_check: (_b = (_a = this._policy) === null || _a === void 0 ? void 0 : _a.piiCheck) !== null && _b !== void 0 ? _b : false,
+            injection_check: (_d = (_c = this._policy) === null || _c === void 0 ? void 0 : _c.injectionCheck) !== null && _d !== void 0 ? _d : false,
+            frameworks: this._frameworks,
+            circuit_breaker_open: false,
+            kill_switch_active: this.killSwitchActive,
+        };
+    }
+    // ── OpenAI middleware ──────────────────────────────────────────────────────
+    /**
+     * Wrap an OpenAI client so every chat.completions.create() call is gated.
+     * Usage: const openai = forma.wrapOpenAI(new OpenAI({ apiKey: "..." }));
+     */
+    wrapOpenAI(client, agentId = "openai-agent") {
+        const self = this;
+        const originalCreate = client.chat.completions.create.bind(client.chat.completions);
+        const wrapped = async function (...args) {
+            var _a, _b;
+            const params = args[0];
+            const prompt = (_b = (_a = params === null || params === void 0 ? void 0 : params.messages) === null || _a === void 0 ? void 0 : _a.filter(m => ["user", "system", "tool"].includes(m.role)).map(m => m.content).join("\n")) !== null && _b !== void 0 ? _b : "";
+            await self.gate(agentId, { actionType: "llm_call", prompt });
+            return originalCreate(...args);
+        };
+        client.chat.completions.create = wrapped;
+        return client;
+    }
+    /**
+     * Wrap an Anthropic client so every messages.create() call is gated.
+     * Usage: const anthropic = forma.wrapAnthropic(new Anthropic({ apiKey: "..." }));
+     */
+    wrapAnthropic(client, agentId = "anthropic-agent") {
+        const self = this;
+        const originalCreate = client.messages.create.bind(client.messages);
+        const wrapped = async function (...args) {
+            var _a;
+            const params = args[0];
+            const parts = [];
+            if (params === null || params === void 0 ? void 0 : params.system)
+                parts.push(params.system);
+            (_a = params === null || params === void 0 ? void 0 : params.messages) === null || _a === void 0 ? void 0 : _a.forEach(m => { if (typeof m.content === "string")
+                parts.push(m.content); });
+            await self.gate(agentId, { actionType: "llm_call", prompt: parts.join("\n") });
+            return originalCreate(...args);
+        };
+        client.messages.create = wrapped;
+        return client;
+    }
+    // ── Agents ────────────────────────────────────────────────────────────────
+    createAgent(name, opts = {}) {
+        var _a, _b;
+        return this.req("POST", "/api/agents", {
+            name,
+            human_sponsor: this.humanSponsor,
+            risk_class: (_a = opts.riskClass) !== null && _a !== void 0 ? _a : "medium",
+            description: (_b = opts.description) !== null && _b !== void 0 ? _b : "",
+        });
+    }
+    listAgents() {
+        return this.req("GET", "/api/agents");
+    }
+    applyPacks(agentRef, packs) {
+        return this.req("POST", `/api/gate/policy/${agentRef}/apply`, { packs });
+    }
+    // ── Runs ──────────────────────────────────────────────────────────────────
+    submitRun(agentName, opts = {}) {
+        var _a, _b, _c, _d, _e, _f;
+        return this.req("POST", "/api/runs", {
+            run_id: `${agentName}-${Date.now()}-${Math.random().toString(36).slice(2, 7)}`,
+            agent_name: agentName,
+            human_sponsor: this.humanSponsor,
+            started_at: (_a = opts.startedAt) !== null && _a !== void 0 ? _a : new Date().toISOString(),
+            status: (_b = opts.status) !== null && _b !== void 0 ? _b : "success",
+            steps: (_c = opts.steps) !== null && _c !== void 0 ? _c : [],
+            total_tokens: (_d = opts.totalTokens) !== null && _d !== void 0 ? _d : 0,
+            total_cost_usd: (_e = opts.totalCostUsd) !== null && _e !== void 0 ? _e : 0,
+            metadata: (_f = opts.metadata) !== null && _f !== void 0 ? _f : {},
+        });
+    }
+    // ── Approvals ─────────────────────────────────────────────────────────────
+    createApproval(agentName, title, message) {
+        return this.req("POST", "/api/approvals", { agent_name: agentName, title, message });
+    }
+    listApprovals(status) {
+        const q = status ? `?status=${status}` : "";
+        return this.req("GET", `/api/approvals${q}`);
+    }
+    decideApproval(approvalId, decision, reason) {
+        return this.req("POST", `/api/approvals/${approvalId}/decide`, { decision, reason });
+    }
+    // ── Kill switch ───────────────────────────────────────────────────────────
+    async triggerKillSwitch(agentId, reason) {
+        await this.req("POST", `/api/agents/${agentId}/kill`, { reason, triggered_by: this.humanSponsor });
+        this.killSwitchActive = true;
+    }
+    async clearKillSwitch(agentId) {
+        await this.req("DELETE", `/api/agents/${agentId}/kill`);
+        this.killSwitchActive = false;
+    }
+    // ── Dashboard ─────────────────────────────────────────────────────────────
+    getDashboardStats() {
+        return this.req("GET", "/api/dashboard/stats");
+    }
+    // ── Compliance ────────────────────────────────────────────────────────────
+    getComplianceReport(agentId, framework = "dpdp") {
+        return this.req("GET", `/api/compliance/report/${agentId}?framework=${framework}`);
+    }
+}
+exports.FormaClient = FormaClient;
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/gate.d.ts

@@ -0,0 +1,37 @@
+/**
+ * FORMA Local Gate — TypeScript port of Python gate_local.py
+ * Evaluates prompts locally in <1ms — no network hop on the critical path.
+ * PII patterns + threat detection keep sensitive data from leaving the process.
+ */
+export declare function normalize(text: string): string;
+export declare function detectPii(text: string): string | null;
+export interface ThreatResult {
+    decision: "block" | "warn" | "allow";
+    rule_id: string | null;
+    reason: string;
+}
+export declare function detectThreat(text: string): ThreatResult;
+export declare const PACK_FLAGS: Record<string, string>;
+export declare const PII_PACKS: Set<string>;
+export interface Policy {
+    agentName: string;
+    piiCheck: boolean;
+    injectionCheck: boolean;
+    killActive: boolean;
+    authorizedActions: string[] | null;
+    frameworks: string[];
+    enforce_packs: string[];
+}
+export declare function buildBootstrapPolicy(agentName: string, packs: string[], authorizedActions?: string[]): Policy;
+export interface GateDecision {
+    decision: "allow" | "warn" | "block";
+    rule_id: string | null;
+    reason: string;
+}
+export declare function evaluateLocal(policy: Policy, opts: {
+    actionType: string;
+    prompt?: string;
+    toolName?: string;
+    toolArgs?: unknown;
+}): GateDecision;
+//# sourceMappingURL=gate.d.ts.map

package/dist/gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate.d.ts","sourceRoot":"","sources":["../src/gate.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG9C;AAiCD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOrD;AAgBD,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;IACrC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAYvD;AAGD,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAM7C,CAAC;AAEF,eAAO,MAAM,SAAS,aAA0E,CAAC;AAGjG,MAAM,WAAW,MAAM;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,OAAO,CAAC;IACxB,UAAU,EAAE,OAAO,CAAC;IACpB,iBAAiB,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACnC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,iBAAiB,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAW7G;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;IACrC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GACnF,YAAY,CAmCd"}