taskflow-core 0.2.5 → 0.2.7

package/dist/hooks.js

@@ -0,0 +1,296 @@
+/**
+ * Flow-level hooks — fire-and-forget notifications on terminal run outcomes.
+ *
+ * Payload is summary-only (never transcripts / phase outputs).
+ * Hook failure must never change run status.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as http from "node:http";
+import * as https from "node:https";
+import { spawn } from "node:child_process";
+import { countPhaseOutcomes } from "./savings.js";
+import { getBuildInfo } from "./build-info.js";
+const MAX_HOOKS_PER_EVENT = 5;
+const DEFAULT_WEBHOOK_TIMEOUT_MS = 5_000;
+/** Map run status → hook event (or undefined if no hook fires). */
+export function hookEventForStatus(status) {
+    if (status === "completed")
+        return "complete";
+    if (status === "failed")
+        return "fail";
+    if (status === "blocked" || status === "paused")
+        return "blocked";
+    return undefined;
+}
+export function actionsForEvent(hooks, event) {
+    if (!hooks)
+        return [];
+    const list = event === "complete" ? hooks.onComplete : event === "fail" ? hooks.onFail : hooks.onBlocked;
+    return Array.isArray(list) ? list.slice(0, MAX_HOOKS_PER_EVENT) : [];
+}
+/** Build summary payload — never includes phase outputs. */
+export function buildHookPayload(event, state) {
+    const counts = countPhaseOutcomes(state.phases);
+    const build = getBuildInfo();
+    const errorSummary = firstErrorSummary(state);
+    const approvalPhaseId = findApprovalPhase(state);
+    return {
+        schema: "taskflow.hook.v1",
+        event,
+        runId: state.runId,
+        flowName: state.flowName,
+        status: state.status,
+        host: state.host,
+        packageVersion: state.packageVersion ?? build.packageVersion,
+        startedAt: state.createdAt,
+        endedAt: state.updatedAt ?? Date.now(),
+        phaseCounts: {
+            total: counts.total,
+            completed: counts.completed,
+            failed: counts.failed,
+            skipped: counts.skipped,
+            cached: counts.cached,
+        },
+        usage: aggregateUsageLite(state),
+        outputSourcePhaseId: state.outputSourcePhaseId,
+        ...(errorSummary ? { errorSummary } : {}),
+        ...(approvalPhaseId ? { approvalPhaseId } : {}),
+    };
+}
+function firstErrorSummary(state) {
+    for (const ps of Object.values(state.phases)) {
+        if (ps.error)
+            return String(ps.error).slice(0, 500);
+        if (ps.gate?.verdict === "block" && ps.gate.reason)
+            return String(ps.gate.reason).slice(0, 500);
+    }
+    if (state.finalOutput && state.status !== "completed") {
+        return String(state.finalOutput).slice(0, 500);
+    }
+    return undefined;
+}
+function findApprovalPhase(state) {
+    for (const [id, ps] of Object.entries(state.phases)) {
+        if (ps.approval)
+            return id;
+    }
+    return undefined;
+}
+function aggregateUsageLite(state) {
+    let inputTokens = 0;
+    let outputTokens = 0;
+    let totalCost = 0;
+    let any = false;
+    for (const ps of Object.values(state.phases)) {
+        const u = ps.usage;
+        if (!u)
+            continue;
+        any = true;
+        if (typeof u.input === "number")
+            inputTokens += u.input;
+        if (typeof u.output === "number")
+            outputTokens += u.output;
+        if (typeof u.cost === "number")
+            totalCost += u.cost;
+    }
+    if (!any)
+        return undefined;
+    return { inputTokens, outputTokens, totalCost };
+}
+/** Validate a single hook action; returns error string or null. */
+export function validateHookAction(action, index, event) {
+    if (!action || typeof action !== "object" || Array.isArray(action)) {
+        return `hooks.${event}[${index}] must be an object`;
+    }
+    const a = action;
+    const type = a.type;
+    if (type === "webhook") {
+        if (typeof a.url !== "string" || !a.url.trim())
+            return `hooks.${event}[${index}].url is required`;
+        const err = validateWebhookUrl(a.url.trim());
+        if (err)
+            return `hooks.${event}[${index}]: ${err}`;
+        if (a.timeoutMs !== undefined && (typeof a.timeoutMs !== "number" || a.timeoutMs < 100 || a.timeoutMs > 60_000)) {
+            return `hooks.${event}[${index}].timeoutMs must be 100–60000`;
+        }
+        return null;
+    }
+    if (type === "file") {
+        if (typeof a.path !== "string" || !a.path.trim())
+            return `hooks.${event}[${index}].path is required`;
+        if (path.isAbsolute(a.path) || a.path.split(/[/\\]/).includes("..")) {
+            return `hooks.${event}[${index}].path must be project-relative without '..'`;
+        }
+        return null;
+    }
+    if (type === "command") {
+        if (!Array.isArray(a.run) || a.run.length === 0 || !a.run.every((x) => typeof x === "string")) {
+            return `hooks.${event}[${index}].run must be a non-empty string array (no shell string)`;
+        }
+        return null;
+    }
+    return `hooks.${event}[${index}].type must be webhook|file|command`;
+}
+export function validateWebhookUrl(url) {
+    let u;
+    try {
+        u = new URL(url);
+    }
+    catch {
+        return "invalid URL";
+    }
+    if (u.protocol === "https:")
+        return null;
+    if (u.protocol === "http:") {
+        const host = u.hostname.toLowerCase();
+        if (host === "127.0.0.1" || host === "localhost" || host === "[::1]" || host === "::1")
+            return null;
+        return "http URLs are only allowed for 127.0.0.1 / localhost (use https otherwise)";
+    }
+    return "URL scheme must be https (or http://127.0.0.1|localhost)";
+}
+/** Validate flow.hooks block; returns error strings. */
+export function validateFlowHooks(hooks) {
+    if (hooks === undefined)
+        return [];
+    if (!hooks || typeof hooks !== "object" || Array.isArray(hooks))
+        return ["hooks must be an object"];
+    const h = hooks;
+    const errors = [];
+    for (const event of ["onComplete", "onFail", "onBlocked"]) {
+        if (h[event] === undefined)
+            continue;
+        if (!Array.isArray(h[event])) {
+            errors.push(`hooks.${event} must be an array`);
+            continue;
+        }
+        if (h[event].length > MAX_HOOKS_PER_EVENT) {
+            errors.push(`hooks.${event} allows at most ${MAX_HOOKS_PER_EVENT} actions`);
+        }
+        h[event].forEach((a, i) => {
+            const e = validateHookAction(a, i, event);
+            if (e)
+                errors.push(e);
+        });
+    }
+    for (const k of Object.keys(h)) {
+        if (!["onComplete", "onFail", "onBlocked"].includes(k)) {
+            errors.push(`hooks: unknown key '${k}'`);
+        }
+    }
+    return errors;
+}
+async function dispatchOne(action, payload, cwd) {
+    if (action.type === "file") {
+        const target = path.resolve(cwd, action.path);
+        const root = path.resolve(cwd);
+        if (!target.startsWith(root + path.sep) && target !== root) {
+            throw new Error(`hook file path escapes project root: ${action.path}`);
+        }
+        fs.mkdirSync(path.dirname(target), { recursive: true });
+        const tmp = `${target}.${process.pid}.${Date.now()}.tmp`;
+        fs.writeFileSync(tmp, JSON.stringify(payload, null, 2), "utf8");
+        fs.renameSync(tmp, target);
+        return;
+    }
+    if (action.type === "webhook") {
+        await postWebhook(action.url, payload, action.timeoutMs ?? DEFAULT_WEBHOOK_TIMEOUT_MS);
+        return;
+    }
+    if (action.type === "command") {
+        await runCommand(action.run, payload, cwd);
+        return;
+    }
+}
+function postWebhook(url, payload, timeoutMs) {
+    return new Promise((resolve, reject) => {
+        const body = JSON.stringify(payload);
+        const u = new URL(url);
+        const lib = u.protocol === "https:" ? https : http;
+        const req = lib.request({
+            protocol: u.protocol,
+            hostname: u.hostname,
+            port: u.port || (u.protocol === "https:" ? 443 : 80),
+            path: `${u.pathname}${u.search}`,
+            method: "POST",
+            headers: {
+                "content-type": "application/json",
+                "content-length": Buffer.byteLength(body),
+                "user-agent": "taskflow-hooks/1",
+            },
+            timeout: timeoutMs,
+        }, (res) => {
+            res.resume();
+            if (res.statusCode && res.statusCode >= 400) {
+                reject(new Error(`webhook HTTP ${res.statusCode}`));
+            }
+            else {
+                resolve();
+            }
+        });
+        req.on("timeout", () => {
+            req.destroy();
+            reject(new Error("webhook timeout"));
+        });
+        req.on("error", reject);
+        req.write(body);
+        req.end();
+    });
+}
+function runCommand(argv, payload, cwd) {
+    return new Promise((resolve, reject) => {
+        const [cmd, ...args] = argv;
+        const child = spawn(cmd, args, {
+            cwd,
+            env: {
+                ...process.env,
+                TASKFLOW_HOOK_PAYLOAD: JSON.stringify(payload),
+                TASKFLOW_HOOK_EVENT: payload.event,
+                TASKFLOW_HOOK_RUN_ID: payload.runId,
+                TASKFLOW_HOOK_STATUS: payload.status,
+            },
+            stdio: "ignore",
+        });
+        const t = setTimeout(() => {
+            child.kill("SIGTERM");
+            reject(new Error("hook command timeout"));
+        }, 30_000);
+        child.on("error", (e) => {
+            clearTimeout(t);
+            reject(e);
+        });
+        child.on("exit", (code) => {
+            clearTimeout(t);
+            if (code === 0)
+                resolve();
+            else
+                reject(new Error(`hook command exit ${code}`));
+        });
+    });
+}
+/**
+ * Dispatch hooks for a terminal run. Never throws; collects errors.
+ */
+export async function dispatchHooks(state, opts) {
+    const event = hookEventForStatus(state.status);
+    if (!event)
+        return { event: "complete", dispatched: 0, errors: [] };
+    const actions = actionsForEvent(opts.hooks ?? state.def.hooks, event);
+    if (!actions.length)
+        return { event, dispatched: 0, errors: [] };
+    const payload = buildHookPayload(event, state);
+    const errors = [];
+    let dispatched = 0;
+    for (const action of actions) {
+        try {
+            await dispatchOne(action, payload, opts.cwd);
+            dispatched++;
+        }
+        catch (e) {
+            errors.push(e instanceof Error ? e.message : String(e));
+        }
+    }
+    return { event, dispatched, errors };
+}
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

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

package/dist/index.d.ts

@@ -44,4 +44,8 @@ export * from "./deterministic.ts";
 export * from "./replay.ts";
 export * from "./exec/index.ts";
 export * from "./verifiers/index.ts";
+export * from "./preflight.ts";
+export * from "./savings.ts";
+export * from "./hooks.ts";
+export * from "./analytics.ts";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AAKtC,OAAO,EACN,6BAA6B,EAC7B,mCAAmC,EACnC,4BAA4B,EAC5B,gCAAgC,GAChC,MAAM,0BAA0B,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAK7B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AAKtC,OAAO,EACN,6BAA6B,EAC7B,mCAAmC,EACnC,4BAA4B,EAC5B,gCAAgC,GAChC,MAAM,0BAA0B,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAK7B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC"}

package/dist/index.js

@@ -52,4 +52,8 @@ export * from "./deterministic.js";
 export * from "./replay.js";
 export * from "./exec/index.js";
 export * from "./verifiers/index.js";
+export * from "./preflight.js";
+export * from "./savings.js";
+export * from "./hooks.js";
+export * from "./analytics.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,2EAA2E;AAC3E,6EAA6E;AAC7E,2EAA2E;AAC3E,6EAA6E;AAC7E,OAAO,EACN,6BAA6B,EAC7B,mCAAmC,EACnC,4BAA4B,EAC5B,gCAAgC,GAChC,MAAM,0BAA0B,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,iFAAiF;AACjF,+EAA+E;AAC/E,iFAAiF;AACjF,mCAAmC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,2EAA2E;AAC3E,6EAA6E;AAC7E,2EAA2E;AAC3E,6EAA6E;AAC7E,OAAO,EACN,6BAA6B,EAC7B,mCAAmC,EACnC,4BAA4B,EAC5B,gCAAgC,GAChC,MAAM,0BAA0B,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,iFAAiF;AACjF,+EAA+E;AAC/E,iFAAiF;AACjF,mCAAmC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC"}

package/dist/preflight.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Preflight dry-run — zero-token plan before spend.
+ *
+ * Binds typed args, runs structural verify, projects a phase plan with
+ * static/dynamic binding status, and computes a worst-case agent-call bound.
+ */
+import { type Phase } from "./schema.ts";
+import { type VerificationIssue, type VerificationResult, type TaskflowVerifier } from "./verify.ts";
+export interface PreflightOptions {
+    /** Invocation arguments (same shape as taskflow_run.args). */
+    args?: Record<string, unknown>;
+    /** When true (default), missing required typed args → ok:false. */
+    strictArgs?: boolean;
+    /** Optional plugin verifiers (same as verify/lint). */
+    verifiers?: TaskflowVerifier[];
+    /** Working directory for validateTaskflow cwd checks. */
+    cwd?: string;
+}
+export type PreflightWhenKind = "always" | "static-true" | "static-false" | "dynamic";
+export interface PreflightBinding {
+    path: string;
+    status: "bound" | "unresolved" | "dynamic";
+    value?: string;
+}
+export interface PreflightPhasePlan {
+    id: string;
+    type: string;
+    order: number;
+    when: PreflightWhenKind;
+    bindings: PreflightBinding[];
+    agent?: string;
+    modelHint?: string;
+    notes?: string[];
+}
+export interface PreflightBudgetBound {
+    maxAgentCalls: number | "unbounded";
+    maxMapFanout?: number | "unbounded";
+    phasesCounted: number;
+    assumptions: string[];
+}
+export interface PreflightResult {
+    ok: boolean;
+    issues: VerificationIssue[];
+    flowName: string;
+    args: Record<string, unknown>;
+    phases: PreflightPhasePlan[];
+    budget: PreflightBudgetBound;
+    summary: string;
+    /** Structural verify result (may be empty if flow failed validation). */
+    verify?: VerificationResult;
+}
+/** Classify a `when` guard for preflight (args-only static evaluation). */
+export declare function classifyWhen(when: string | undefined, args: Record<string, unknown>): PreflightWhenKind;
+export declare function computeBudgetBound(phases: Phase[], args?: Record<string, unknown>): PreflightBudgetBound;
+/**
+ * Plan a flow without executing any agent. Pure w.r.t. model spend.
+ */
+export declare function preflightTaskflow(raw: unknown, opts?: PreflightOptions): PreflightResult;
+export declare function formatPreflightSummary(p: {
+    ok: boolean;
+    flowName: string;
+    phases: PreflightPhasePlan[];
+    budget: PreflightBudgetBound;
+    issueCount: number;
+    errorCount: number;
+}): string;
+/** Full human report for MCP/CLI. */
+export declare function formatPreflightReport(r: PreflightResult, json?: boolean): string;
+//# sourceMappingURL=preflight.d.ts.map

package/dist/preflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.d.ts","sourceRoot":"","sources":["../src/preflight.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EASN,KAAK,KAAK,EAIV,MAAM,aAAa,CAAC;AACrB,OAAO,EACN,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EAEvB,KAAK,gBAAgB,EACrB,MAAM,aAAa,CAAC;AAMrB,MAAM,WAAW,gBAAgB;IAChC,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,mEAAmE;IACnE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,uDAAuD;IACvD,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,yDAAyD;IACzD,GAAG,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,aAAa,GAAG,cAAc,GAAG,SAAS,CAAC;AAEtF,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,GAAG,YAAY,GAAG,SAAS,CAAC;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,iBAAiB,CAAC;IACxB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACpC,aAAa,EAAE,MAAM,GAAG,WAAW,CAAC;IACpC,YAAY,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC/B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,MAAM,EAAE,oBAAoB,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,MAAM,CAAC,EAAE,kBAAkB,CAAC;CAC5B;AAeD,2EAA2E;AAC3E,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,iBAAiB,CAuBvG;AAwED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,oBAAoB,CAqH5G;AAMD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,GAAE,gBAAqB,GAAG,eAAe,CA2G5F;AAED,wBAAgB,sBAAsB,CAAC,CAAC,EAAE;IACzC,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,MAAM,EAAE,oBAAoB,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACnB,GAAG,MAAM,CAcT;AAED,qCAAqC;AACrC,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,eAAe,EAAE,IAAI,UAAQ,GAAG,MAAM,CA0B9E"}