@prestyj/editor 0.7.1

package/dist/core/auth/index.js

@@ -0,0 +1,18 @@
+/**
+ * ezeditor's auth surface. Single source of truth lives in
+ * `@prestyj/cli/auth` \u2014 we re-export it here so editor code keeps a
+ * stable import path while the underlying OAuth flows, refresh logic, and
+ * AuthStorage are exactly the ones ezcoder ships and exercises daily.
+ *
+ * Why re-export instead of fork: every previous fork (ezeditor 0.6.0\u20130.6.6)
+ * accumulated regressions when small details drifted \u2014 wrong OpenAI
+ * `originator`, missing 401 retry callback, broken Windows browser-open.
+ * Importing keeps editor + coder bug-fix-symmetric forever.
+ *
+ * `types.ts` and `api-keys.ts` stay editor-local: provider lists and the
+ * vision-tools API-key store are editor-specific concerns.
+ */
+export { AuthStorage, NotLoggedInError, loginAnthropic, loginOpenAI, refreshAnthropicToken, refreshOpenAIToken, } from "@prestyj/cli/auth";
+export { runLogin, runLogout, runStatus } from "./login.js";
+export { STATIC_KEY_PROVIDERS, OAUTH_PROVIDERS } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/core/auth/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/auth/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}

package/dist/core/auth/login.d.ts

@@ -0,0 +1,13 @@
+import { type SupportedAuthProvider } from "./types.js";
+/**
+ * Interactive `ezeditor login` flow. Uses the shared Ink-based provider
+ * selector with the editor's warm palette + brand. Credentials saved to
+ * ~/.ezcoder/auth.json — same file ezcoder uses, so logging in via either CLI
+ * works for both.
+ */
+export declare function runLogin(opts?: {
+    provider?: SupportedAuthProvider;
+}): Promise<void>;
+export declare function runLogout(provider?: SupportedAuthProvider): Promise<void>;
+export declare function runStatus(): Promise<void>;
+//# sourceMappingURL=login.d.ts.map

package/dist/core/auth/login.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"login.d.ts","sourceRoot":"","sources":["../../../src/core/auth/login.ts"],"names":[],"mappings":"AAKA,OAAO,EAAwB,KAAK,qBAAqB,EAAE,MAAM,YAAY,CAAC;AA2B9E;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,IAAI,GAAE;IAAE,QAAQ,CAAC,EAAE,qBAAqB,CAAA;CAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CA4C7F;AA4DD,wBAAsB,SAAS,CAAC,QAAQ,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAW/E;AAED,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAiC/C"}

package/dist/core/auth/login.js

@@ -0,0 +1,176 @@
+import { createInterface } from "node:readline/promises";
+import chalk from "chalk";
+import { renderLoginSelector } from "@prestyj/cli/ui/login";
+import { AuthStorage, loginAnthropic, loginOpenAI } from "@prestyj/cli/auth";
+import { openBrowser } from "@prestyj/cli/utils/open-browser";
+import { STATIC_KEY_PROVIDERS } from "./types.js";
+/**
+ * Editor brand palette — same warm sunset used by the main TUI. Applied to
+ * every screen ezeditor renders (login selector, status output, login flow
+ * messages) so the look is consistent and clearly distinct from ezcoder.
+ */
+const EDITOR_PRIMARY = "#f97316"; // orange-500
+const EDITOR_ACCENT = "#ec4899"; // pink-500
+const EDITOR_GRADIENT = [
+    "#fbbf24",
+    "#f59e0b",
+    "#f97316",
+    "#ea580c",
+    "#dc2626",
+    "#e11d48",
+    "#db2777",
+    "#e11d48",
+    "#dc2626",
+    "#ea580c",
+    "#f97316",
+    "#f59e0b",
+];
+const orange = chalk.hex(EDITOR_PRIMARY);
+const pink = chalk.hex(EDITOR_ACCENT);
+/**
+ * Interactive `ezeditor login` flow. Uses the shared Ink-based provider
+ * selector with the editor's warm palette + brand. Credentials saved to
+ * ~/.ezcoder/auth.json — same file ezcoder uses, so logging in via either CLI
+ * works for both.
+ */
+export async function runLogin(opts = {}) {
+    if (!process.stdin.isTTY) {
+        throw new Error("ezeditor login requires an interactive terminal");
+    }
+    process.stdout.write("\x1b[2J\x1b[3J\x1b[H");
+    let provider;
+    if (opts.provider) {
+        provider = opts.provider;
+    }
+    else {
+        const { getPackageVersion } = await import("../version.js");
+        const picked = await renderLoginSelector({
+            brand: "EZ Editor",
+            version: getPackageVersion(),
+            gradient: EDITOR_GRADIENT,
+            primary: EDITOR_PRIMARY,
+            accent: EDITOR_ACCENT,
+        });
+        if (!picked) {
+            process.stdout.write(chalk.dim("Login cancelled.\n"));
+            return;
+        }
+        provider = picked;
+    }
+    process.stdout.write(chalk.bold("\nLogging in to ") + pink(displayName(provider)) + "\n\n");
+    let creds;
+    if (provider === "anthropic") {
+        creds = await loginAnthropic(makeCallbacks());
+    }
+    else if (provider === "openai") {
+        creds = await loginOpenAI(makeCallbacks());
+    }
+    else {
+        creds = await promptApiKeyCreds(provider);
+    }
+    const storage = new AuthStorage();
+    await storage.setCredentials(provider, creds);
+    process.stdout.write(orange(`\n✓ Logged in to ${displayName(provider)}.\n`) +
+        chalk.dim(`  Credentials saved to ${storage.path}\n`) +
+        chalk.dim("  (Same file ezcoder uses — both CLIs share auth.)\n"));
+}
+function displayName(provider) {
+    switch (provider) {
+        case "anthropic":
+            return "Anthropic";
+        case "openai":
+            return "OpenAI";
+        case "glm":
+            return "Z.AI (GLM)";
+        case "moonshot":
+            return "Moonshot (Kimi)";
+        case "xiaomi":
+            return "Xiaomi (MiMo)";
+        case "minimax":
+            return "MiniMax";
+        case "deepseek":
+            return "DeepSeek";
+        case "openrouter":
+            return "OpenRouter";
+        default:
+            return provider;
+    }
+}
+async function promptApiKeyCreds(provider) {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    try {
+        const key = (await rl.question(orange(`Paste your ${provider} API key: `))).trim();
+        if (!key)
+            throw new Error("empty API key");
+        return {
+            accessToken: key,
+            refreshToken: "",
+            expiresAt: Date.now() + 100 * 365 * 24 * 60 * 60 * 1000, // ~100y, never refreshes
+        };
+    }
+    finally {
+        rl.close();
+    }
+}
+function makeCallbacks() {
+    return {
+        onOpenUrl: (url) => {
+            process.stdout.write(chalk.dim("\nOpening browser:\n  ") + url + "\n\n");
+            openBrowser(url);
+        },
+        onPromptCode: async (message) => {
+            const rl = createInterface({ input: process.stdin, output: process.stdout });
+            try {
+                return (await rl.question(orange(`${message} `))).trim();
+            }
+            finally {
+                rl.close();
+            }
+        },
+        onStatus: (msg) => {
+            process.stdout.write(chalk.dim(`  ${msg}\n`));
+        },
+    };
+}
+export async function runLogout(provider) {
+    const storage = new AuthStorage();
+    await storage.load();
+    if (provider) {
+        await storage.clearCredentials(provider);
+        process.stdout.write(orange(`✓ Logged out of ${displayName(provider)}\n`));
+        return;
+    }
+    const providers = await storage.listProviders();
+    for (const p of providers)
+        await storage.clearCredentials(p);
+    process.stdout.write(orange(`✓ Cleared all credentials (${providers.length})\n`));
+}
+export async function runStatus() {
+    const storage = new AuthStorage();
+    await storage.load();
+    const providers = await storage.listProviders();
+    const { renderCliBanner } = await import("../cli-banner.js");
+    const { getPackageVersion } = await import("../version.js");
+    process.stdout.write(renderCliBanner({
+        version: getPackageVersion(),
+        screen: "Auth",
+        subtitle: storage.path,
+    }));
+    if (providers.length === 0) {
+        process.stdout.write(chalk.yellow("  No credentials stored. Run `ezeditor login`.\n"));
+        return;
+    }
+    for (const p of providers) {
+        const c = await storage.getCredentials(p);
+        if (!c)
+            continue;
+        const isStatic = STATIC_KEY_PROVIDERS.has(p);
+        const expires = isStatic ? "—" : new Date(c.expiresAt).toLocaleString();
+        const valid = isStatic || Date.now() < c.expiresAt;
+        const tag = isStatic ? "api-key" : valid ? "valid" : "expired (will refresh)";
+        const tagColored = isStatic ? chalk.dim(tag) : valid ? chalk.green(tag) : chalk.yellow(tag);
+        process.stdout.write(`  ${pink(p.padEnd(11))} ${tagColored.padEnd(28)}  ${chalk.dim(`expires: ${expires}`)}\n`);
+    }
+    process.stdout.write("\n");
+}
+//# sourceMappingURL=login.js.map

package/dist/core/auth/login.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"login.js","sourceRoot":"","sources":["../../../src/core/auth/login.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAyB,MAAM,mBAAmB,CAAC;AACpG,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAA8B,MAAM,YAAY,CAAC;AAE9E;;;;GAIG;AACH,MAAM,cAAc,GAAG,SAAS,CAAC,CAAC,aAAa;AAC/C,MAAM,aAAa,GAAG,SAAS,CAAC,CAAC,WAAW;AAC5C,MAAM,eAAe,GAAG;IACtB,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;CACV,CAAC;AAEF,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;AACzC,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;AAEtC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,OAA6C,EAAE;IAC5E,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAE7C,IAAI,QAA+B,CAAC;IACpC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;IAC3B,CAAC;SAAM,CAAC;QACN,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;QAC5D,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC;YACvC,KAAK,EAAE,WAAW;YAClB,OAAO,EAAE,iBAAiB,EAAE;YAC5B,QAAQ,EAAE,eAAe;YACzB,OAAO,EAAE,cAAc;YACvB,MAAM,EAAE,aAAa;SACtB,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC,CAAC;YACtD,OAAO;QACT,CAAC;QACD,QAAQ,GAAG,MAA+B,CAAC;IAC7C,CAAC;IAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC;IAE5F,IAAI,KAAuB,CAAC;IAC5B,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;QAC7B,KAAK,GAAG,MAAM,cAAc,CAAC,aAAa,EAAE,CAAC,CAAC;IAChD,CAAC;SAAM,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,KAAK,GAAG,MAAM,WAAW,CAAC,aAAa,EAAE,CAAC,CAAC;IAC7C,CAAC;SAAM,CAAC;QACN,KAAK,GAAG,MAAM,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC5C,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IAClC,MAAM,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAE9C,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,MAAM,CAAC,oBAAoB,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC;QACpD,KAAK,CAAC,GAAG,CAAC,0BAA0B,OAAO,CAAC,IAAI,IAAI,CAAC;QACrD,KAAK,CAAC,GAAG,CAAC,sDAAsD,CAAC,CACpE,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,QAAgB;IACnC,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,WAAW;YACd,OAAO,WAAW,CAAC;QACrB,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC;QAClB,KAAK,KAAK;YACR,OAAO,YAAY,CAAC;QACtB,KAAK,UAAU;YACb,OAAO,iBAAiB,CAAC;QAC3B,KAAK,QAAQ;YACX,OAAO,eAAe,CAAC;QACzB,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC;QACnB,KAAK,UAAU;YACb,OAAO,UAAU,CAAC;QACpB,KAAK,YAAY;YACf,OAAO,YAAY,CAAC;QACtB;YACE,OAAO,QAAQ,CAAC;IACpB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,QAA+B;IAC9D,MAAM,EAAE,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7E,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,cAAc,QAAQ,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACnF,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;QAC3C,OAAO;YACL,WAAW,EAAE,GAAG;YAChB,YAAY,EAAE,EAAE;YAChB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,yBAAyB;SACnF,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;AACH,CAAC;AAED,SAAS,aAAa;IACpB,OAAO;QACL,SAAS,EAAE,CAAC,GAAW,EAAE,EAAE;YACzB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,wBAAwB,CAAC,GAAG,GAAG,GAAG,MAAM,CAAC,CAAC;YACzE,WAAW,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;QACD,YAAY,EAAE,KAAK,EAAE,OAAe,EAAmB,EAAE;YACvD,MAAM,EAAE,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;YAC7E,IAAI,CAAC;gBACH,OAAO,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAC3D,CAAC;oBAAS,CAAC;gBACT,EAAE,CAAC,KAAK,EAAE,CAAC;YACb,CAAC;QACH,CAAC;QACD,QAAQ,EAAE,CAAC,GAAW,EAAE,EAAE;YACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC;QAChD,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,QAAgC;IAC9D,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IAClC,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;IACrB,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,OAAO,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QACzC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,mBAAmB,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3E,OAAO;IACT,CAAC;IACD,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,aAAa,EAAE,CAAC;IAChD,KAAK,MAAM,CAAC,IAAI,SAAS;QAAE,MAAM,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAC7D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,8BAA8B,SAAS,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC;AACpF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS;IAC7B,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IAClC,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;IACrB,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,aAAa,EAAE,CAAC;IAEhD,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;IAC7D,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;IAC5D,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,eAAe,CAAC;QACd,OAAO,EAAE,iBAAiB,EAAE;QAC5B,MAAM,EAAE,MAAM;QACd,QAAQ,EAAE,OAAO,CAAC,IAAI;KACvB,CAAC,CACH,CAAC;IAEF,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,kDAAkD,CAAC,CAAC,CAAC;QACvF,OAAO;IACT,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC1B,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;QAC1C,IAAI,CAAC,CAAC;YAAE,SAAS;QACjB,MAAM,QAAQ,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAA0B,CAAC,CAAC;QACtE,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,cAAc,EAAE,CAAC;QACxE,MAAM,KAAK,GAAG,QAAQ,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,SAAS,CAAC;QACnD,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,wBAAwB,CAAC;QAC9E,MAAM,UAAU,GAAG,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC5F,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,YAAY,OAAO,EAAE,CAAC,IAAI,CAC1F,CAAC;IACJ,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC"}

package/dist/core/auth/types.d.ts

@@ -0,0 +1,22 @@
+export interface OAuthCredentials {
+    accessToken: string;
+    refreshToken: string;
+    /** ms epoch */
+    expiresAt: number;
+    /** OpenAI chatgpt_account_id from JWT (when applicable). */
+    accountId?: string;
+    /** Optional custom API base URL. */
+    baseUrl?: string;
+}
+export interface OAuthLoginCallbacks {
+    onOpenUrl: (url: string) => void;
+    onPromptCode: (message: string) => Promise<string>;
+    onStatus: (message: string) => void;
+}
+/** All providers ezeditor supports — mirrors ezcoder's set. */
+export type SupportedAuthProvider = "anthropic" | "openai" | "glm" | "moonshot" | "xiaomi" | "minimax" | "deepseek" | "openrouter";
+/** Providers that use static API keys (no OAuth refresh). */
+export declare const STATIC_KEY_PROVIDERS: Set<SupportedAuthProvider>;
+/** Providers that use OAuth (PKCE). */
+export declare const OAUTH_PROVIDERS: Set<SupportedAuthProvider>;
+//# sourceMappingURL=types.d.ts.map

package/dist/core/auth/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/auth/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACnD,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC;AAED,+DAA+D;AAC/D,MAAM,MAAM,qBAAqB,GAC7B,WAAW,GACX,QAAQ,GACR,KAAK,GACL,UAAU,GACV,QAAQ,GACR,SAAS,GACT,UAAU,GACV,YAAY,CAAC;AAEjB,6DAA6D;AAC7D,eAAO,MAAM,oBAAoB,4BAO/B,CAAC;AAEH,uCAAuC;AACvC,eAAO,MAAM,eAAe,4BAA0D,CAAC"}

package/dist/core/auth/types.js

@@ -0,0 +1,12 @@
+/** Providers that use static API keys (no OAuth refresh). */
+export const STATIC_KEY_PROVIDERS = new Set([
+    "glm",
+    "moonshot",
+    "xiaomi",
+    "minimax",
+    "deepseek",
+    "openrouter",
+]);
+/** Providers that use OAuth (PKCE). */
+export const OAUTH_PROVIDERS = new Set(["anthropic", "openai"]);
+//# sourceMappingURL=types.js.map

package/dist/core/auth/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/auth/types.ts"],"names":[],"mappings":"AA4BA,6DAA6D;AAC7D,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAwB;IACjE,KAAK;IACL,UAAU;IACV,QAAQ;IACR,SAAS;IACT,UAAU;IACV,YAAY;CACb,CAAC,CAAC;AAEH,uCAAuC;AACvC,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,GAAG,CAAwB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC"}

package/dist/core/beats.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Beat detection + cut-snapping primitive.
+ *
+ * `detectBeats` shells out to a librosa-backed sidecar; `snapCuts` is the
+ * pure algorithm that clamps proposed cut points to the nearest detected
+ * beat within a tolerance. The split keeps the algorithm fully unit-testable
+ * (no Python required) and isolates the heavy import-path inside the sidecar.
+ */
+export interface DetectBeatsResult {
+    /** Estimated tempo (BPM). */
+    tempo: number;
+    /** Beat times in seconds, sorted ascending. */
+    beats: number[];
+    /** Audio duration in seconds (post-load). */
+    durationSec: number;
+}
+export interface DetectBeatsOptions {
+    signal?: AbortSignal;
+    /** Optional librosa target sample rate. Defaults to librosa's choice (22050). */
+    sampleRate?: number;
+}
+/**
+ * Spawn the beats sidecar, write `{audioPath, sr}` to stdin, return the
+ * parsed JSON. Throws with a structured message on sidecar failure so the
+ * tool wrapper can format it for the agent.
+ */
+export declare function detectBeats(audioPath: string, opts?: DetectBeatsOptions): Promise<DetectBeatsResult>;
+export interface SnappedCut {
+    /** The cut point as supplied by the caller. */
+    originalSec: number;
+    /** The beat time it was snapped to. */
+    snappedSec: number;
+    /** Index into the beats array. */
+    beatIdx: number;
+    /** Signed offset (snappedSec - originalSec). Magnitude ≤ toleranceSec. */
+    deltaSec: number;
+}
+export interface UnchangedCut {
+    /** Cut point that fell beyond toleranceSec from any beat. */
+    atSec: number;
+    /** Distance to the closest beat (positive). undefined if no beats supplied. */
+    nearestBeatDeltaSec?: number;
+}
+export interface SnapResult {
+    snapped: SnappedCut[];
+    unchanged: UnchangedCut[];
+}
+/**
+ * Snap each cut point to the nearest beat within `toleranceSec`. Cuts beyond
+ * the tolerance are returned in `unchanged` with their distance to the
+ * closest beat (so the agent can decide whether to widen the tolerance).
+ *
+ * Tiebreak: when two beats are equidistant, the EARLIER beat wins. (Cuts
+ * read more naturally on the upbeat than the downbeat that follows.)
+ *
+ * Pure function — no I/O. Beats list need not be sorted; we sort defensively.
+ */
+export declare function snapCuts(cutPoints: number[], beats: number[], toleranceSec: number): SnapResult;
+//# sourceMappingURL=beats.d.ts.map

package/dist/core/beats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"beats.d.ts","sourceRoot":"","sources":["../../src/core/beats.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AAEH,MAAM,WAAW,iBAAiB;IAChC,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,iFAAiF;IACjF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,kBAAuB,GAC5B,OAAO,CAAC,iBAAiB,CAAC,CAqC5B;AAED,MAAM,WAAW,UAAU;IACzB,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,+EAA+E;IAC/E,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,SAAS,EAAE,YAAY,EAAE,CAAC;CAC3B;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,MAAM,GAAG,UAAU,CAgE/F"}

package/dist/core/beats.js

@@ -0,0 +1,122 @@
+import { runPython } from "./python.js";
+import { sidecarPath } from "./python/sidecar-path.js";
+/**
+ * Spawn the beats sidecar, write `{audioPath, sr}` to stdin, return the
+ * parsed JSON. Throws with a structured message on sidecar failure so the
+ * tool wrapper can format it for the agent.
+ */
+export async function detectBeats(audioPath, opts = {}) {
+    const script = sidecarPath("beats.py");
+    const stdin = JSON.stringify({
+        audioPath,
+        sr: opts.sampleRate,
+    });
+    const { code, stdout, stderr } = await runPython(script, [], {
+        signal: opts.signal,
+        stdin,
+    });
+    // Parse stdout regardless of exit code — the sidecar reports errors as
+    // structured JSON on stdout (with exit 1) so we can surface them cleanly.
+    const trimmed = stdout.trim();
+    if (!trimmed) {
+        throw new Error(`beat sidecar returned empty stdout (exit ${code}): ${tail(stderr)}`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(trimmed);
+    }
+    catch {
+        throw new Error(`beat sidecar returned malformed output: ${trimmed.slice(-200)} | stderr: ${tail(stderr)}`);
+    }
+    if (parsed && typeof parsed === "object" && "error" in parsed) {
+        const err = parsed;
+        throw new Error(err.error ?? "unknown beat sidecar error");
+    }
+    if (!parsed ||
+        typeof parsed !== "object" ||
+        !Array.isArray(parsed.beats)) {
+        throw new Error(`beat sidecar returned unexpected shape: ${trimmed.slice(-200)}`);
+    }
+    return parsed;
+}
+/**
+ * Snap each cut point to the nearest beat within `toleranceSec`. Cuts beyond
+ * the tolerance are returned in `unchanged` with their distance to the
+ * closest beat (so the agent can decide whether to widen the tolerance).
+ *
+ * Tiebreak: when two beats are equidistant, the EARLIER beat wins. (Cuts
+ * read more naturally on the upbeat than the downbeat that follows.)
+ *
+ * Pure function — no I/O. Beats list need not be sorted; we sort defensively.
+ */
+export function snapCuts(cutPoints, beats, toleranceSec) {
+    const snapped = [];
+    const unchanged = [];
+    if (!Array.isArray(cutPoints) || cutPoints.length === 0) {
+        return { snapped, unchanged };
+    }
+    if (!Array.isArray(beats) || beats.length === 0) {
+        for (const c of cutPoints)
+            unchanged.push({ atSec: c });
+        return { snapped, unchanged };
+    }
+    const tol = Math.max(0, Number.isFinite(toleranceSec) ? toleranceSec : 0);
+    // Defensive sort + dedupe: the sidecar already returns sorted beats, but a
+    // pure function shouldn't trust its inputs.
+    const sortedBeats = [...beats].filter((b) => Number.isFinite(b)).sort((a, b) => a - b);
+    for (const cut of cutPoints) {
+        if (!Number.isFinite(cut)) {
+            unchanged.push({ atSec: cut });
+            continue;
+        }
+        // Binary search for the first beat >= cut.
+        let lo = 0;
+        let hi = sortedBeats.length;
+        while (lo < hi) {
+            const mid = (lo + hi) >>> 1;
+            if (sortedBeats[mid] < cut)
+                lo = mid + 1;
+            else
+                hi = mid;
+        }
+        // Candidates: sortedBeats[lo-1] (left) and sortedBeats[lo] (right).
+        const leftIdx = lo - 1;
+        const rightIdx = lo < sortedBeats.length ? lo : -1;
+        let bestIdx = -1;
+        let bestDelta = Infinity; // signed: best - cut
+        if (leftIdx >= 0) {
+            const d = sortedBeats[leftIdx] - cut; // ≤ 0
+            if (Math.abs(d) < Math.abs(bestDelta)) {
+                bestIdx = leftIdx;
+                bestDelta = d;
+            }
+        }
+        if (rightIdx >= 0) {
+            const d = sortedBeats[rightIdx] - cut; // ≥ 0
+            // Strict <: ties go to the earlier (left) beat already chosen above.
+            if (Math.abs(d) < Math.abs(bestDelta)) {
+                bestIdx = rightIdx;
+                bestDelta = d;
+            }
+        }
+        if (bestIdx >= 0 && Math.abs(bestDelta) <= tol) {
+            snapped.push({
+                originalSec: cut,
+                snappedSec: sortedBeats[bestIdx],
+                beatIdx: bestIdx,
+                deltaSec: bestDelta,
+            });
+        }
+        else {
+            unchanged.push({
+                atSec: cut,
+                nearestBeatDeltaSec: bestIdx >= 0 ? Math.abs(bestDelta) : undefined,
+            });
+        }
+    }
+    return { snapped, unchanged };
+}
+function tail(s) {
+    return s.split("\n").filter(Boolean).slice(-3).join(" | ").slice(-300);
+}
+//# sourceMappingURL=beats.js.map

package/dist/core/beats.js.map

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

package/dist/core/beats.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=beats.test.d.ts.map

package/dist/core/beats.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"beats.test.d.ts","sourceRoot":"","sources":["../../src/core/beats.test.ts"],"names":[],"mappings":""}

package/dist/core/beats.test.js

@@ -0,0 +1,86 @@
+import { describe, expect, it } from "vitest";
+import { snapCuts } from "./beats.js";
+describe("snapCuts", () => {
+    it("returns empty results for empty cut list", () => {
+        const r = snapCuts([], [1, 2, 3], 0.25);
+        expect(r.snapped).toEqual([]);
+        expect(r.unchanged).toEqual([]);
+    });
+    it("returns every cut in unchanged when beats list is empty", () => {
+        const r = snapCuts([1.0, 2.0], [], 0.25);
+        expect(r.snapped).toEqual([]);
+        expect(r.unchanged).toEqual([{ atSec: 1.0 }, { atSec: 2.0 }]);
+    });
+    it("snaps a cut to the nearest beat within tolerance", () => {
+        // Beats at 1.0, 2.0, 3.0; cut at 2.07s with tol 0.25 → snaps to 2.0.
+        const r = snapCuts([2.07], [1.0, 2.0, 3.0], 0.25);
+        expect(r.snapped).toHaveLength(1);
+        expect(r.unchanged).toEqual([]);
+        expect(r.snapped[0]).toEqual({
+            originalSec: 2.07,
+            snappedSec: 2.0,
+            beatIdx: 1,
+            deltaSec: expect.closeTo(-0.07, 5),
+        });
+    });
+    it("leaves a cut unchanged when the closest beat is outside tolerance", () => {
+        // Beats at 0, 1; cut at 0.5 → equidistant, but 0.5 > tol of 0.1.
+        const r = snapCuts([0.5], [0.0, 1.0], 0.1);
+        expect(r.snapped).toEqual([]);
+        expect(r.unchanged).toHaveLength(1);
+        expect(r.unchanged[0].atSec).toBe(0.5);
+        expect(r.unchanged[0].nearestBeatDeltaSec).toBeCloseTo(0.5, 5);
+    });
+    it("picks the LEFT beat on a perfect tie (earlier beat wins)", () => {
+        // Cut at 1.5 between beats at 1.0 and 2.0 — both 0.5 away.
+        const r = snapCuts([1.5], [1.0, 2.0], 1.0);
+        expect(r.snapped).toHaveLength(1);
+        expect(r.snapped[0].snappedSec).toBe(1.0);
+        expect(r.snapped[0].beatIdx).toBe(0);
+    });
+    it("snaps each cut independently and preserves input order", () => {
+        const cuts = [3.05, 1.04, 2.5];
+        const beats = [1.0, 2.0, 3.0, 4.0];
+        const r = snapCuts(cuts, beats, 0.1);
+        // 3.05 → 3.0 (delta -0.05)
+        // 1.04 → 1.0 (delta -0.04)
+        // 2.5  → ties left at 2.0 BUT |0.5| > 0.1 tol → unchanged.
+        expect(r.snapped.map((s) => s.originalSec)).toEqual([3.05, 1.04]);
+        expect(r.unchanged.map((u) => u.atSec)).toEqual([2.5]);
+    });
+    it("clamps negative tolerance to 0 (no snap occurs)", () => {
+        const r = snapCuts([1.0001], [1.0], -0.5);
+        // Tolerance was negative → clamped to 0; cut isn't EXACTLY on the beat,
+        // so it falls into unchanged.
+        expect(r.snapped).toEqual([]);
+        expect(r.unchanged).toHaveLength(1);
+    });
+    it("handles cuts before the first beat and after the last beat", () => {
+        const beats = [5.0, 6.0, 7.0];
+        const r = snapCuts([4.95, 7.05, 100], beats, 0.1);
+        // 4.95 → 5.0, 7.05 → 7.0, 100 → unchanged (closest delta 93)
+        expect(r.snapped.map((s) => s.snappedSec)).toEqual([5.0, 7.0]);
+        expect(r.unchanged).toHaveLength(1);
+        expect(r.unchanged[0].atSec).toBe(100);
+        expect(r.unchanged[0].nearestBeatDeltaSec).toBeCloseTo(93, 1);
+    });
+    it("sorts beat input defensively", () => {
+        // Caller passes beats out of order; we still find the right neighbour.
+        const r = snapCuts([2.04], [3.0, 1.0, 2.0], 0.1);
+        expect(r.snapped[0].snappedSec).toBe(2.0);
+        expect(r.snapped[0].beatIdx).toBe(1); // index in the SORTED list
+    });
+    it("treats non-finite cuts as unchanged", () => {
+        const r = snapCuts([NaN, 1.0], [1.0, 2.0], 0.1);
+        expect(r.snapped).toHaveLength(1);
+        expect(r.snapped[0].originalSec).toBe(1.0);
+        expect(r.unchanged).toHaveLength(1);
+        expect(Number.isNaN(r.unchanged[0].atSec)).toBe(true);
+    });
+    it("zero tolerance only snaps exact-match cuts", () => {
+        const r = snapCuts([1.0, 1.001], [1.0, 2.0], 0);
+        expect(r.snapped.map((s) => s.originalSec)).toEqual([1.0]);
+        expect(r.unchanged.map((u) => u.atSec)).toEqual([1.001]);
+    });
+});
+//# sourceMappingURL=beats.test.js.map

package/dist/core/beats.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"beats.test.js","sourceRoot":"","sources":["../../src/core/beats.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE;IACxB,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,CAAC,GAAG,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QACxC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC9B,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;QACzC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC9B,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,qEAAqE;QACrE,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;QAClD,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAClC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAChC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;YAC3B,WAAW,EAAE,IAAI;YACjB,UAAU,EAAE,GAAG;YACf,OAAO,EAAE,CAAC;YACV,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;SACnC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mEAAmE,EAAE,GAAG,EAAE;QAC3E,iEAAiE;QACjE,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;QAC3C,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC9B,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACvC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAClE,2DAA2D;QAC3D,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;QAC3C,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAClC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1C,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAChE,MAAM,IAAI,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;QAC/B,MAAM,KAAK,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QACnC,MAAM,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;QACrC,2BAA2B;QAC3B,2BAA2B;QAC3B,2DAA2D;QAC3D,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QAClE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;QAC1C,wEAAwE;QACxE,8BAA8B;QAC9B,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC9B,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;QACpE,MAAM,KAAK,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QAC9B,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;QAClD,6DAA6D;QAC7D,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;QAC/D,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACvC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,WAAW,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,uEAAuE;QACvE,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;QACjD,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1C,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,2BAA2B;IACnE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;QAChD,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAClC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3C,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QAChD,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC3D,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}