@dbx-tools/appkit-mastra 0.6.10 → 0.6.11

package/src/remote-skills.ts

@@ -1,19 +1,24 @@
 /**
  * Startup provisioning of remote Agent-Skill sources for a Mastra workspace.
  *
- * A {@link RemoteSkillSource} names WHERE a `SKILL.md` tree comes from - a
- * GitHub `owner/repo`, any git / GitLab URL, or a direct download URL - and
- * optional per-source policy. {@link provisionRemoteSkills} materializes every
- * source into a local `SKILL.md` tree at app boot and returns the directories
- * to hand Mastra as extra skill scan paths.
+ * A {@link RemoteSkillSource} names WHERE a `SKILL.md` tree comes from - the
+ * {@link AITOOLS_SOURCE} constant, a GitHub `owner/repo`, any git / GitLab URL,
+ * or a direct download URL - and optional per-source policy.
+ * {@link provisionRemoteSkills} materializes every source into a local
+ * `SKILL.md` tree at app boot and returns the directories to hand Mastra as
+ * extra skill scan paths.
  *
  * Resolution per source, in order:
  *
- * 1. the OPTIONAL `skills` npm CLI (peer dep): if installed, each source is
+ * 1. the {@link AITOOLS_SOURCE} constant (`"aitools"`): Databricks' own skill
+ *    set, read straight from the public repo the `databricks aitools` CLI
+ *    sources from. No CLI, no Databricks auth - which is what makes it usable
+ *    inside a Databricks App container, where the CLI is not installed;
+ * 2. the OPTIONAL `skills` npm CLI (peer dep): if installed, each source is
  *    copied into a staging dir with `skills add <source> --agent <dir> --copy`,
  *    which understands every source format the ecosystem does (GitHub
  *    shorthand, git URLs, archive/download URLs);
- * 2. otherwise a plain {@link fetch} of the source URL (built with
+ * 3. otherwise a plain {@link fetch} of the source URL (built with
  *    {@link net.urlBuilder}), writing the downloaded `SKILL.md` to a staging
  *    dir.
  *
@@ -35,7 +40,7 @@
 
 import { mkdir, readdir, readFile, rm, stat, writeFile } from "node:fs/promises";
 import { createRequire } from "node:module";
-import { join, posix } from "node:path";
+import { dirname, join, posix } from "node:path";
 import type { WorkspaceClient } from "@databricks/sdk-experimental";
 import { appkit } from "@dbx-tools/appkit";
 import type { WorkspaceClientLike } from "@dbx-tools/appkit";
@@ -43,7 +48,8 @@ import { exec } from "@dbx-tools/core";
 import { DatabricksFileSystem } from "@dbx-tools/databricks";
 import { localFS, type LocalFileSystem } from "@dbx-tools/fs";
 import { find } from "@dbx-tools/path";
-import { error, hash, log, net, string } from "@dbx-tools/shared-core";
+import { error, hash, json, log, net, object, string } from "@dbx-tools/shared-core";
+import type { OneOrMany } from "@dbx-tools/shared-core";
 import type { FileSystem } from "@dbx-tools/shared-fs";
 
 const logger = log.logger("mastra/remote-skills");
@@ -68,20 +74,55 @@ const DEFAULT_MAX_DOWNLOAD_BYTES = 10 * 1024 * 1024;
 /** Stable temp directory holding one rebuilt skill tree per remote source. */
 const LOCAL_SKILLS_DIR = "mastra-local-skills";
 
+/* ------------------------------ AI Tools ------------------------------ */
+
+/**
+ * Source constant selecting Databricks' own AI Tools skill set.
+ *
+ * @example
+ * mastra({ remoteSkills: "aitools" });
+ */
+export const AITOOLS_SOURCE = "aitools";
+
+/** The {@link AITOOLS_SOURCE} literal, for callers spelling the union out. */
+export type AiToolsSource = typeof AITOOLS_SOURCE;
+
+/**
+ * The PUBLIC repo `databricks aitools install` sources from. Reading it
+ * directly is what lets an app get the same skills the CLI installs without
+ * the CLI - which a Databricks App container does not ship.
+ */
+const AITOOLS_REPO = "databricks/databricks-agent-skills";
+
+/** Repo ref the skills are read from. Override per source with `ref`. */
+const AITOOLS_REF = "main";
+
+/** Skill files downloaded at once; the set is ~30 skills of a few files each. */
+const AITOOLS_CONCURRENCY = 8;
+
+/** The subset of the repo's generated `manifest.json` this module reads. */
+interface AiToolsManifest {
+  skills?: Record<string, { files?: string[]; repo_dir?: string }>;
+}
+
 /* -------------------------------- types -------------------------------- */
 
 /**
  * One remote skill source and its per-source policy.
  *
- * `source` is anything the `skills` ecosystem understands: a GitHub
- * `owner/repo` shorthand, a full GitHub / GitLab / git URL, or a direct
- * download URL to a `SKILL.md` or archive.
+ * `source` is {@link AITOOLS_SOURCE} or anything the `skills` ecosystem
+ * understands: a GitHub `owner/repo` shorthand, a full GitHub / GitLab / git
+ * URL, or a direct download URL to a `SKILL.md` or archive.
  */
 export interface RemoteSkillSourceOptions {
-  /** GitHub shorthand, git / GitLab URL, or a direct download URL. */
-  source: string;
-  /** Install only these skill names from the source (CLI path only). */
+  /** `"aitools"`, a GitHub shorthand, a git / GitLab URL, or a download URL. */
+  source: net.UrlLike | AiToolsSource;
+  /** Install only these skill names from the source. */
   skills?: string | string[];
+  /** Include experimental skills. `"aitools"` only. */
+  experimental?: boolean;
+  /** Pin the repo ref (tag / branch / sha). `"aitools"` only; defaults to `main`. */
+  ref?: string;
   /** Override the byte ceiling on a direct-fetch download for this source. */
   maxDownloadBytes?: number;
   /**
@@ -92,22 +133,26 @@ export interface RemoteSkillSourceOptions {
 }
 
 /**
- * A remote skill source: a bare source string (GitHub shorthand / URL) or a
- * {@link RemoteSkillSourceOptions} with per-source policy.
+ * A remote skill source: the {@link AITOOLS_SOURCE} constant, a URL-like
+ * (string / `URL` / `{ url }`), or a {@link RemoteSkillSourceOptions} bag with
+ * per-source policy.
  */
-export type RemoteSkillSource = string | RemoteSkillSourceOptions;
+export type RemoteSkillSource = net.UrlLike | AiToolsSource | RemoteSkillSourceOptions;
 
 /**
- * The workspace `remoteSkills` option. A single source, a list, or a
- * {@link ProvisionRemoteSkillsOptions} bag when top-level policy is needed.
+ * The workspace `remoteSkills` option: one source, a non-empty list of them, or
+ * a {@link ProvisionRemoteSkillsOptions} bag when top-level policy is needed.
  */
 export type RemoteSkillsOption =
-  RemoteSkillSource | RemoteSkillSource[] | ProvisionRemoteSkillsOptions;
+  RemoteSkillSource | OneOrMany<RemoteSkillSource> | ProvisionRemoteSkillsOptions;
+
+/** A source entry with its `source` flattened to a plain string. */
+type NormalizedSource = Omit<RemoteSkillSourceOptions, "source"> & { source: string };
 
 /** Top-level remote-skills provisioning options. */
 export interface ProvisionRemoteSkillsOptions {
   /** Sources to materialize at startup. */
-  sources: RemoteSkillSource | RemoteSkillSource[];
+  sources: RemoteSkillSource | OneOrMany<RemoteSkillSource>;
   /**
    * Fail app startup when a source can't be resolved. Defaults to `true`. A
    * per-source `failOnError` wins over this.
@@ -147,26 +192,42 @@ export function normalizeRemoteSkillsOption(
   option: RemoteSkillsOption | undefined,
 ): ProvisionRemoteSkillsOptions | undefined {
   if (option === undefined) return undefined;
-  if (typeof option === "string") return { sources: [option] };
-  if (Array.isArray(option)) return option.length > 0 ? { sources: option } : undefined;
-  if (isProvisionOptions(option)) {
-    const sources = Array.isArray(option.sources) ? option.sources : [option.sources];
-    return sources.length > 0 ? { ...option, sources } : undefined;
-  }
-  // A lone RemoteSkillSourceOptions object.
-  return { sources: [option] };
+  const bag = isProvisionOptions(option) ? option : undefined;
+  const sources = toSourceList(bag ? bag.sources : (option as RemoteSkillSource));
+  // An empty list is the same as no configuration at all.
+  if (!object.isOneOrMany(sources)) return undefined;
+  return { ...bag, sources };
 }
 
 /** A `sources`-bearing bag is the top-level options shape, not a single source. */
-function isProvisionOptions(
-  value: RemoteSkillSourceOptions | ProvisionRemoteSkillsOptions,
-): value is ProvisionRemoteSkillsOptions {
-  return "sources" in value;
+function isProvisionOptions(value: unknown): value is ProvisionRemoteSkillsOptions {
+  return object.isRecord(value) && "sources" in value;
 }
 
-/** Coerce a source entry to its normalized {@link RemoteSkillSourceOptions}. */
-function toSourceOptions(source: RemoteSkillSource): RemoteSkillSourceOptions {
-  return typeof source === "string" ? { source } : source;
+/** One source or many, as a plain array. A source is never itself an array. */
+function toSourceList(
+  input: RemoteSkillSource | OneOrMany<RemoteSkillSource>,
+): RemoteSkillSource[] {
+  return Array.isArray(input) ? [...input] : [input];
+}
+
+/** Flatten a source entry - string, `URL`, `{ url }`, or options bag - to a {@link NormalizedSource}. */
+function toSourceOptions(source: RemoteSkillSource): NormalizedSource {
+  if (typeof source === "string") return { source };
+  if (source instanceof URL) return { source: source.toString() };
+  if ("source" in source) return { ...source, source: toSourceString(source.source) };
+  return { source: source.url };
+}
+
+/** A {@link net.UrlLike} as the plain string the staging paths work with. */
+function toSourceString(source: net.UrlLike): string {
+  if (typeof source === "string") return source;
+  return source instanceof URL ? source.toString() : source.url;
+}
+
+/** True when a source selects the built-in Databricks AI Tools skill set. */
+function isAiToolsSource(source: string): boolean {
+  return source.trim().toLowerCase() === AITOOLS_SOURCE;
 }
 
 /**
@@ -265,24 +326,92 @@ function resolveDatabricksBasePath(
  * `skills` CLI and falling back to a direct fetch.
  */
 async function stageSource(
-  sourceOptions: RemoteSkillSourceOptions,
+  sourceOptions: NormalizedSource,
   stagingRoot: string,
   options: ProvisionRemoteSkillsOptions,
 ): Promise<string> {
   const target = join(stagingRoot, `src-${hash.id()}`);
   await mkdir(target, { recursive: true });
+  // AI Tools resolves from a known repo layout, so it never needs the CLI.
+  if (isAiToolsSource(sourceOptions.source)) return stageAiTools(sourceOptions, target, options);
   const viaCli = await stageViaSkillsCli(sourceOptions, target);
   if (viaCli) return viaCli;
   return stageViaFetch(sourceOptions, target, options);
 }
 
+/**
+ * Materialize the Databricks AI Tools skills into `target`.
+ *
+ * Reads the repo's own generated `manifest.json` (which names each skill's
+ * files and whether it lives under `skills/` or `experimental/`) and downloads
+ * them - the same thing `databricks aitools install` does, minus the CLI and
+ * minus any Databricks auth, since the repo is public.
+ */
+async function stageAiTools(
+  sourceOptions: NormalizedSource,
+  target: string,
+  options: ProvisionRemoteSkillsOptions,
+): Promise<string> {
+  const maxBytes = resolveMaxBytes(sourceOptions, options);
+  const ref = string.trimToNull(sourceOptions.ref) ?? AITOOLS_REF;
+  const manifest = json.parse(
+    (await download(aiToolsRawUrl(ref, "manifest.json"), maxBytes)).toString("utf8"),
+    undefined,
+  ) as AiToolsManifest | undefined;
+
+  const wanted = new Set(string.parseList(sourceOptions.skills));
+  const selected = Object.entries(manifest?.skills ?? {}).filter(([name, entry]) =>
+    wanted.size > 0
+      ? wanted.has(name)
+      : entry.repo_dir !== "experimental" || sourceOptions.experimental === true,
+  );
+  if (selected.length === 0) {
+    throw new Error(`no matching skills in ${AITOOLS_REPO}@${ref}`);
+  }
+
+  const files = selected.flatMap(([name, entry]) =>
+    (entry.files ?? []).map((file) => ({
+      url: aiToolsRawUrl(ref, `${entry.repo_dir ?? "skills"}/${name}/${file}`),
+      path: join(target, name, ...file.split("/")),
+    })),
+  );
+  await mapConcurrent(files, AITOOLS_CONCURRENCY, async (item) => {
+    const body = await download(item.url, maxBytes);
+    await mkdir(dirname(item.path), { recursive: true });
+    await writeFile(item.path, body);
+  });
+
+  logger.debug("aitools:staged", { ref, skills: selected.length, files: files.length });
+  return target;
+}
+
+/** Raw-content URL for a path in the AI Tools repo at `ref`. */
+function aiToolsRawUrl(ref: string, path: string): string {
+  return `https://raw.githubusercontent.com/${AITOOLS_REPO}/${ref}/${path}`;
+}
+
+/** Run `worker` over `items`, at most `limit` in flight. */
+async function mapConcurrent<T>(
+  items: readonly T[],
+  limit: number,
+  worker: (item: T) => Promise<void>,
+): Promise<void> {
+  let cursor = 0;
+  const runners = Array.from({ length: Math.min(limit, items.length) }, async () => {
+    while (cursor < items.length) {
+      await worker(items[cursor++]!);
+    }
+  });
+  await Promise.all(runners);
+}
+
 /**
  * Copy a source into `target` with the `skills` CLI when it is installed.
  * Returns the dir holding the copied `SKILL.md` trees, or `undefined` when the
  * CLI is absent (so the caller can fall back to a fetch).
  */
 async function stageViaSkillsCli(
-  sourceOptions: RemoteSkillSourceOptions,
+  sourceOptions: NormalizedSource,
   target: string,
 ): Promise<string | undefined> {
   const cli = await resolveSkillsCli();
@@ -338,7 +467,7 @@ async function resolveSkillsCli(): Promise<{ command: string; args: string[] } |
  * Used when the `skills` CLI isn't installed; supports a direct `SKILL.md` URL.
  */
 async function stageViaFetch(
-  sourceOptions: RemoteSkillSourceOptions,
+  sourceOptions: NormalizedSource,
   target: string,
   options: ProvisionRemoteSkillsOptions,
 ): Promise<string> {
@@ -348,18 +477,7 @@ async function stageViaFetch(
       `source "${sourceOptions.source}" is not a URL and the optional "skills" package is not installed`,
     );
   }
-  const maxBytes =
-    sourceOptions.maxDownloadBytes ?? options.maxDownloadBytes ?? DEFAULT_MAX_DOWNLOAD_BYTES;
-  const response = await fetch(url.toString());
-  if (!response.ok) {
-    throw new Error(
-      `download failed: ${response.status} ${response.statusText} (${url.toString()})`,
-    );
-  }
-  const buffer = Buffer.from(await response.arrayBuffer());
-  if (buffer.byteLength > maxBytes) {
-    throw new Error(`download exceeds ${maxBytes} bytes (${url.toString()})`);
-  }
+  const buffer = await download(url.toString(), resolveMaxBytes(sourceOptions, options));
   const name = string.toSlug(deriveSkillName(url.toString())) || "remote-skill";
   const skillDir = join(target, name);
   await mkdir(skillDir, { recursive: true });
@@ -367,6 +485,27 @@ async function stageViaFetch(
   return target;
 }
 
+/** The effective download ceiling: per-source, then top-level, then the default. */
+function resolveMaxBytes(
+  sourceOptions: NormalizedSource,
+  options: ProvisionRemoteSkillsOptions,
+): number {
+  return sourceOptions.maxDownloadBytes ?? options.maxDownloadBytes ?? DEFAULT_MAX_DOWNLOAD_BYTES;
+}
+
+/** GET a URL, failing loudly on a non-2xx status or an oversized body. */
+async function download(url: string, maxBytes: number): Promise<Buffer> {
+  const response = await fetch(url);
+  if (!response.ok) {
+    throw new Error(`download failed: ${response.status} ${response.statusText} (${url})`);
+  }
+  const buffer = Buffer.from(await response.arrayBuffer());
+  if (buffer.byteLength > maxBytes) {
+    throw new Error(`download exceeds ${maxBytes} bytes (${url})`);
+  }
+  return buffer;
+}
+
 /** Derive a skill directory name from a download URL's last path segment. */
 function deriveSkillName(urlString: string): string {
   const url = net.urlBuilder(urlString);

package/lib/src/databricks-aitools.d.ts

@@ -1,73 +0,0 @@
-/**
- * Startup provisioning of Databricks AI Tools skills for a Mastra workspace.
- *
- * Databricks AI Tools (`databricks aitools`) are Databricks-owned Agent-Skill
- * (`SKILL.md`) trees installed and kept up to date through the Databricks CLI.
- * {@link provisionDatabricksAITools} shells out to the CLI
- * (`databricks aitools install --path <dir>`) to materialize a resolved,
- * agent-agnostic skill set into a directory, then hands it to Mastra as an
- * extra LOCAL skill scan path - so an agent gets first-class Databricks skills
- * without anyone hand-copying `SKILL.md` files. It never reimplements the CLI's
- * sourcing; the CLI is the source of truth.
- *
- * The option is `false | true | "auto" | DatabricksAIToolsOptions`:
- *
- * - `false` (default) - off.
- * - `"auto"` - run the CLI when it's installed; if the `databricks` CLI isn't
- *   available, log and move on (never fails startup). The "on if the CLI is
- *   around" default.
- * - `true` (`"require"`) - require the CLI: fail startup (subject to
- *   `failOnError`) when it isn't available or produces nothing.
- * - an options bag for a specific `skills` subset, `experimental` skills, an
- *   explicit output `path`, or a custom `cli` path.
- *
- * @module
- */
-/** How aggressively to enable Databricks AI Tools skills. */
-export type DatabricksAIToolsMode = "auto" | "require";
-/** Options for {@link provisionDatabricksAITools}. */
-export interface DatabricksAIToolsOptions {
-    /**
-     * `"auto"` (default) runs the CLI when installed and logs-and-continues when
-     * it isn't; `"require"` fails startup when the CLI can't supply skills.
-     */
-    mode?: DatabricksAIToolsMode;
-    /** Install only these skill names (comma/space list or array). */
-    skills?: string | string[];
-    /** Include experimental skills when the CLI has to fetch. */
-    experimental?: boolean;
-    /**
-     * Explicit directory to materialize skills into with the CLI. Defaults to a
-     * fresh {@link localFS.tmpFS} root.
-     */
-    path?: string;
-    /** Absolute path to the `databricks` CLI. Defaults to `databricks` on PATH. */
-    cli?: string;
-    /**
-     * Fail app startup when required skills can't be provisioned. Defaults to
-     * `true` for `mode: "require"` and `false` for `"auto"`.
-     */
-    failOnError?: boolean;
-}
-/** The `databricksAITools` config option: a toggle, `"auto"`, or an options bag. */
-export type DatabricksAIToolsOption = boolean | "auto" | DatabricksAIToolsOptions;
-/** What {@link provisionDatabricksAITools} resolved. */
-export interface ProvisionedDatabricksAITools {
-    /** Extra LOCAL skill scan paths to hand Mastra. Empty when disabled/unresolved. */
-    localSkillPaths: string[];
-    /** How the skills were sourced, for logging. */
-    source?: "cli";
-}
-/** Normalize the `databricksAITools` option into a flat options bag, or `undefined` when off. */
-export declare function normalizeDatabricksAIToolsOption(option: DatabricksAIToolsOption | undefined): DatabricksAIToolsOptions | undefined;
-/**
- * Materialize Databricks AI Tools skills at app startup and return them as
- * extra local skill scan paths.
- *
- * Resolution: reuse the installed global tree when present (no CLI call) unless
- * `refresh`/`skills`/`path` ask for a fresh CLI materialization; otherwise run
- * `databricks aitools install --path <dir> --skills-only` when the CLI resolves.
- * A `"require"` provision that yields nothing fails startup unless
- * `failOnError: false`.
- */
-export declare function provisionDatabricksAITools(option: DatabricksAIToolsOption | undefined): Promise<ProvisionedDatabricksAITools>;

package/lib/src/databricks-aitools.js

@@ -1,152 +0,0 @@
-/**
- * Startup provisioning of Databricks AI Tools skills for a Mastra workspace.
- *
- * Databricks AI Tools (`databricks aitools`) are Databricks-owned Agent-Skill
- * (`SKILL.md`) trees installed and kept up to date through the Databricks CLI.
- * {@link provisionDatabricksAITools} shells out to the CLI
- * (`databricks aitools install --path <dir>`) to materialize a resolved,
- * agent-agnostic skill set into a directory, then hands it to Mastra as an
- * extra LOCAL skill scan path - so an agent gets first-class Databricks skills
- * without anyone hand-copying `SKILL.md` files. It never reimplements the CLI's
- * sourcing; the CLI is the source of truth.
- *
- * The option is `false | true | "auto" | DatabricksAIToolsOptions`:
- *
- * - `false` (default) - off.
- * - `"auto"` - run the CLI when it's installed; if the `databricks` CLI isn't
- *   available, log and move on (never fails startup). The "on if the CLI is
- *   around" default.
- * - `true` (`"require"`) - require the CLI: fail startup (subject to
- *   `failOnError`) when it isn't available or produces nothing.
- * - an options bag for a specific `skills` subset, `experimental` skills, an
- *   explicit output `path`, or a custom `cli` path.
- *
- * @module
- */
-import { existsSync } from "node:fs";
-import { exec } from "@dbx-tools/core";
-import { localFS } from "@dbx-tools/fs";
-import { error, log, string } from "@dbx-tools/shared-core";
-const logger = log.logger("mastra/databricks-aitools");
-/** The Databricks CLI binary name; resolved on `PATH`. */
-const DATABRICKS_CLI = "databricks";
-/** Stable temp directory the CLI's skill tree is rebuilt into each boot. */
-const SKILLS_CACHE_DIR = "databricks-aitools";
-/* ------------------------------- helpers ------------------------------- */
-/** Normalize the `databricksAITools` option into a flat options bag, or `undefined` when off. */
-export function normalizeDatabricksAIToolsOption(option) {
-    if (option === undefined || option === false)
-        return undefined;
-    if (option === true)
-        return { mode: "require" };
-    if (option === "auto")
-        return { mode: "auto" };
-    return { mode: option.mode ?? "auto", ...option };
-}
-/**
- * Materialize Databricks AI Tools skills at app startup and return them as
- * extra local skill scan paths.
- *
- * Resolution: reuse the installed global tree when present (no CLI call) unless
- * `refresh`/`skills`/`path` ask for a fresh CLI materialization; otherwise run
- * `databricks aitools install --path <dir> --skills-only` when the CLI resolves.
- * A `"require"` provision that yields nothing fails startup unless
- * `failOnError: false`.
- */
-export async function provisionDatabricksAITools(option) {
-    const options = normalizeDatabricksAIToolsOption(option);
-    const empty = { localSkillPaths: [] };
-    if (!options)
-        return empty;
-    const mode = options.mode ?? "auto";
-    const failOnError = options.failOnError ?? mode === "require";
-    try {
-        // The `databricks` CLI is the source of truth. When it's resolvable, run
-        // `databricks aitools install --path <dir>` to materialize a fresh,
-        // agent-agnostic skill set into a dir Mastra can scan.
-        const cliPath = await resolveCli(options.cli);
-        if (cliPath) {
-            const dir = await materializeViaCli(cliPath, options);
-            if (dir)
-                return { localSkillPaths: [dir], source: "cli" };
-        }
-        // CLI not installed (or produced nothing). "auto" logs and moves on;
-        // "require" fails startup unless `failOnError: false`.
-        if (failOnError) {
-            throw new Error(`Databricks AI Tools required but the "${DATABRICKS_CLI}" CLI is not available. Install the Databricks CLI (\`databricks aitools install\`), or set databricksAITools: "auto".`);
-        }
-        logger.info("databricks CLI not available; skipping AI Tools skills");
-        return empty;
-    }
-    catch (err) {
-        if (failOnError) {
-            throw new Error(`failed to provision Databricks AI Tools skills: ${error.errorMessage(err)}`, { cause: error.toError(err) });
-        }
-        logger.warn("skipped", { error: error.errorMessage(err) });
-        return empty;
-    }
-}
-/** Resolve the `databricks` CLI, returning its invocation path or `undefined`. */
-async function resolveCli(cli) {
-    const command = string.trimToNull(cli) ?? DATABRICKS_CLI;
-    try {
-        const result = await exec.spawn(command, ["aitools", "version"], {
-            stdout: "capture",
-            stderr: "capture",
-            check: false,
-        });
-        if (result.exitCode === 0)
-            return command;
-    }
-    catch {
-        // CLI absent or `aitools` unsupported - caller falls back / fails.
-    }
-    return undefined;
-}
-/**
- * Run `databricks aitools install --path <dir>` to materialize a resolved,
- * agent-agnostic skill set into a directory (writes `<name>/SKILL.md` trees,
- * no agents, no state) Mastra can then scan.
- */
-async function materializeViaCli(cli, options) {
-    const explicit = string.trimToNull(options.path);
-    let dir;
-    if (explicit) {
-        // An explicit path is the caller's to own - install straight into it.
-        await installSkills(cli, options, explicit);
-        dir = explicit;
-    }
-    else {
-        // The resolved skill set is the same on almost every boot, so rebuild ONE
-        // stable temp tree rather than leaving a fresh scratch dir behind each
-        // time. The CLI writes into a throwaway root that only replaces the stable
-        // one on success, so a failed install keeps the previous skills usable.
-        const stable = await localFS.rebuildFS(SKILLS_CACHE_DIR, (scratch) => installSkills(cli, options, scratch.root));
-        dir = stable.root;
-    }
-    if (!existsSync(dir))
-        return undefined;
-    logger.debug("materialized aitools skills via CLI", {
-        path: dir,
-        skills: string.parseList(options.skills),
-    });
-    return dir;
-}
-/** Run `databricks aitools install --path <dir>`, failing loudly on a non-zero exit. */
-async function installSkills(cli, options, dir) {
-    const args = ["aitools", "install", "--path", dir];
-    const skills = string.parseList(options.skills);
-    if (skills.length > 0)
-        args.push("--skills", skills.join(","));
-    if (options.experimental)
-        args.push("--experimental");
-    const result = await exec.spawn(cli, args, {
-        stdout: "capture",
-        stderr: "capture",
-        check: false,
-    });
-    if (result.exitCode !== 0) {
-        throw new Error(`databricks aitools install failed (exit ${result.exitCode}): ${result.stderr || result.stdout}`);
-    }
-}
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGF0YWJyaWNrcy1haXRvb2xzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2RhdGFicmlja3MtYWl0b29scy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0dBd0JHO0FBRUgsT0FBTyxFQUFFLFVBQVUsRUFBRSxNQUFNLFNBQVMsQ0FBQztBQUNyQyxPQUFPLEVBQUUsSUFBSSxFQUFFLE1BQU0saUJBQWlCLENBQUM7QUFDdkMsT0FBTyxFQUFFLE9BQU8sRUFBRSxNQUFNLGVBQWUsQ0FBQztBQUN4QyxPQUFPLEVBQUUsS0FBSyxFQUFFLEdBQUcsRUFBRSxNQUFNLEVBQUUsTUFBTSx3QkFBd0IsQ0FBQztBQUU1RCxNQUFNLE1BQU0sR0FBRyxHQUFHLENBQUMsTUFBTSxDQUFDLDJCQUEyQixDQUFDLENBQUM7QUFFdkQsMERBQTBEO0FBQzFELE1BQU0sY0FBYyxHQUFHLFlBQVksQ0FBQztBQUVwQyw0RUFBNEU7QUFDNUUsTUFBTSxnQkFBZ0IsR0FBRyxvQkFBb0IsQ0FBQztBQTJDOUMsNkVBQTZFO0FBRTdFLGlHQUFpRztBQUNqRyxNQUFNLFVBQVUsZ0NBQWdDLENBQzlDLE1BQTJDO0lBRTNDLElBQUksTUFBTSxLQUFLLFNBQVMsSUFBSSxNQUFNLEtBQUssS0FBSztRQUFFLE9BQU8sU0FBUyxDQUFDO0lBQy9ELElBQUksTUFBTSxLQUFLLElBQUk7UUFBRSxPQUFPLEVBQUUsSUFBSSxFQUFFLFNBQVMsRUFBRSxDQUFDO0lBQ2hELElBQUksTUFBTSxLQUFLLE1BQU07UUFBRSxPQUFPLEVBQUUsSUFBSSxFQUFFLE1BQU0sRUFBRSxDQUFDO0lBQy9DLE9BQU8sRUFBRSxJQUFJLEVBQUUsTUFBTSxDQUFDLElBQUksSUFBSSxNQUFNLEVBQUUsR0FBRyxNQUFNLEVBQUUsQ0FBQztBQUNwRCxDQUFDO0FBRUQ7Ozs7Ozs7OztHQVNHO0FBQ0gsTUFBTSxDQUFDLEtBQUssVUFBVSwwQkFBMEIsQ0FD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ekMsTUFBTSxFQUFFLFNBQVM7UUFDakIsTUFBTSxFQUFFLFNBQVM7UUFDakIsS0FBSyxFQUFFLEtBQUs7S0FDYixDQUFDLENBQUM7SUFDSCxJQUFJLE1BQU0sQ0FBQyxRQUFRLEtBQUssQ0FBQyxFQUFFLENBQUM7UUFDMUIsTUFBTSxJQUFJLEtBQUssQ0FDYiwyQ0FBMkMsTUFBTSxDQUFDLFFBQVEsTUFBTSxNQUFNLENBQUMsTUFBTSxJQUFJLE1BQU0sQ0FBQyxNQUFNLEVBQUUsQ0FDakcsQ0FBQztJQUNKLENBQUM7QUFDSCxDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBTdGFydHVwIHByb3Zpc2lvbmluZyBvZiBEYXRhYnJpY2tzIEFJIFRvb2xzIHNraWxscyBmb3IgYSBNYXN0cmEgd29ya3NwYWNlLlxuICpcbiAqIERhdGFicmlja3MgQUkgVG9vbHMgKGBkYXRhYnJpY2tzIGFpdG9vbHNgKSBhcmUgRGF0YWJyaWNrcy1vd25lZCBBZ2VudC1Ta2lsbFxuICogKGBTS0lMTC5tZGApIHRyZWVzIGluc3RhbGxlZCBhbmQga2VwdCB1cCB0byBkYXRlIHRocm91Z2ggdGhlIERhdGFicmlja3MgQ0xJLlxuICoge0BsaW5rIHByb3Zpc2lvbkRhdGFicmlja3NBSVRvb2xzfSBzaGVsbHMgb3V0IHRvIHRoZSBDTElcbiAqIChgZGF0YWJyaWNrcyBhaXRvb2xzIGluc3RhbGwgLS1wYXRoIDxkaXI+YCkgdG8gbWF0ZXJpYWxpemUgYSByZXNvbHZlZCxcbiAqIGFnZW50LWFnbm9zdGljIHNraWxsIHNldCBpbnRvIGEgZGlyZWN0b3J5LCB0aGVuIGhhbmRzIGl0IHRvIE1hc3RyYSBhcyBhblxuICogZXh0cmEgTE9DQUwgc2tpbGwgc2NhbiBwYXRoIC0gc28gYW4gYWdlbnQgZ2V0cyBmaXJzdC1jbGFzcyBEYXRhYnJpY2tzIHNraWxsc1xuICogd2l0aG91dCBhbnlvbmUgaGFuZC1jb3B5aW5nIGBTS0lMTC5tZGAgZmlsZXMuIEl0IG5ldmVyIHJlaW1wbGVtZW50cyB0aGUgQ0xJJ3NcbiAqIHNvdXJjaW5nOyB0aGUgQ0xJIGlzIHRoZSBzb3VyY2Ugb2YgdHJ1dGguXG4gKlxuICogVGhlIG9wdGlvbiBpcyBgZmFsc2UgfCB0cnVlIHwgXCJhdXRvXCIgfCBEYXRhYnJpY2tzQUlUb29sc09wdGlvbnNgOlxuICpcbiAqIC0gYGZhbHNlYCAoZGVmYXVsdCkgLSBvZmYuXG4gKiAtIGBcImF1dG9cImAgLSBydW4gdGhlIENMSSB3aGVuIGl0J3MgaW5zdGFsbGVkOyBpZiB0aGUgYGRhdGFicmlja3NgIENMSSBpc24ndFxuICogICBhdmFpbGFibGUsIGxvZyBhbmQgbW92ZSBvbiAobmV2ZXIgZmFpbHMgc3RhcnR1cCkuIFRoZSBcIm9uIGlmIHRoZSBDTEkgaXNcbiAqICAgYXJvdW5kXCIgZGVmYXVsdC5cbiAqIC0gYHRydWVgIChgXCJyZXF1aXJlXCJgKSAtIHJlcXVpcmUgdGhlIENMSTogZmFpbCBzdGFydHVwIChzdWJqZWN0IHRvXG4gKiAgIGBmYWlsT25FcnJvcmApIHdoZW4gaXQgaXNuJ3QgYXZhaWxhYmxlIG9yIHByb2R1Y2VzIG5vdGhpbmcuXG4gKiAtIGFuIG9wdGlvbnMgYmFnIGZvciBhIHNwZWNpZmljIGBza2lsbHNgIHN1YnNldCwgYGV4cGVyaW1lbnRhbGAgc2tpbGxzLCBhblxuICogICBleHBsaWNpdCBvdXRwdXQgYHBhdGhgLCBvciBhIGN1c3RvbSBgY2xpYCBwYXRoLlxuICpcbiAqIEBtb2R1bGVcbiAqL1xuXG5pbXBvcnQgeyBleGlzdHNTeW5jIH0gZnJvbSBcIm5vZGU6ZnNcIjtcbmltcG9ydCB7IGV4ZWMgfSBmcm9tIFwiQGRieC10b29scy9jb3JlXCI7XG5pbXBvcnQgeyBsb2NhbEZTIH0gZnJvbSBcIkBkYngtdG9vbHMvZnNcIjtcbmltcG9ydCB7IGVycm9yLCBsb2csIHN0cmluZyB9IGZyb20gXCJAZGJ4LXRvb2xzL3NoYXJlZC1jb3JlXCI7XG5cbmNvbnN0IGxvZ2dlciA9IGxvZy5sb2dnZXIoXCJtYXN0cmEvZGF0YWJyaWNrcy1haXRvb2xzXCIpO1xuXG4vKiogVGhlIERhdGFicmlja3MgQ0xJIGJpbmFyeSBuYW1lOyByZXNvbHZlZCBvbiBgUEFUSGAuICovXG5jb25zdCBEQVRBQlJJQ0tTX0NMSSA9IFwiZGF0YWJyaWNrc1wiO1xuXG4vKiogU3RhYmxlIHRlbXAgZGlyZWN0b3J5IHRoZSBDTEkncyBza2lsbCB0cmVlIGlzIHJlYnVpbHQgaW50byBlYWNoIGJvb3QuICovXG5jb25zdCBTS0lMTFNfQ0FDSEVfRElSID0gXCJkYXRhYnJpY2tzLWFpdG9vbHNcIjtcblxuLyogLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0gdHlwZXMgLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0gKi9cblxuLyoqIEhvdyBhZ2dyZXNzaXZlbHkgdG8gZW5hYmxlIERhdGFicmlja3MgQUkgVG9vbHMgc2tpbGxzLiAqL1xuZXhwb3J0IHR5cGUgRGF0YWJyaWNrc0FJVG9vbHNNb2RlID0gXCJhdXRvXCIgfCBcInJlcXVpcmVcIjtcblxuLyoqIE9wdGlvbnMgZm9yIHtAbGluayBwcm92aXNpb25EYXRhYnJpY2tzQUlUb29sc30uICovXG5leHBvcnQgaW50ZXJmYWNlIERhdGFicmlja3NBSVRvb2xzT3B0aW9ucyB7XG4gIC8qKlxuICAgKiBgXCJhdXRvXCJgIChkZWZhdWx0KSBydW5zIHRoZSBDTEkgd2hlbiBpbnN0YWxsZWQgYW5kIGxvZ3MtYW5kLWNvbnRpbnVlcyB3aGVuXG4gICAqIGl0IGlzbid0OyBgXCJyZXF1aXJlXCJgIGZhaWxzIHN0YXJ0dXAgd2hlbiB0aGUgQ0xJIGNhbid0IHN1cHBseSBza2lsbHMuXG4gICAqL1xuICBtb2RlPzogRGF0YWJyaWNrc0FJVG9vbHNNb2RlO1xuICAvKiogSW5zdGFsbCBvbmx5IHRoZXNlIHNraWxsIG5hbWVzIChjb21tYS9zcGFjZSBsaXN0IG9yIGFycmF5KS4gKi9cbiAgc2tpbGxzPzogc3RyaW5nIHwgc3RyaW5nW107XG4gIC8qKiBJbmNsdWRlIGV4cGVyaW1lbnRhbCBza2lsbHMgd2hlbiB0aGUgQ0xJIGhhcyB0byBmZXRjaC4gKi9cbiAgZXhwZXJpbWVudGFsPzogYm9vbGVhbjtcbiAgLyoqXG4gICAqIEV4cGxpY2l0IGRpcmVjdG9yeSB0byBtYXRlcmlhbGl6ZSBza2lsbHMgaW50byB3aXRoIHRoZSBDTEkuIERlZmF1bHRzIHRvIGFcbiAgICogZnJlc2gge0BsaW5rIGxvY2FsRlMudG1wRlN9IHJvb3QuXG4gICAqL1xuICBwYXRoPzogc3RyaW5nO1xuICAvKiogQWJzb2x1dGUgcGF0aCB0byB0aGUgYGRhdGFicmlja3NgIENMSS4gRGVmYXVsdHMgdG8gYGRhdGFicmlja3NgIG9uIFBBVEguICovXG4gIGNsaT86IHN0cmluZztcbiAgLyoqXG4gICAqIEZhaWwgYXBwIHN0YXJ0dXAgd2hlbiByZXF1aXJlZCBza2lsbHMgY2FuJ3QgYmUgcHJvdmlzaW9uZWQuIERlZmF1bHRzIHRvXG4gICAqIGB0cnVlYCBmb3IgYG1vZGU6IFwicmVxdWlyZVwiYCBhbmQgYGZhbHNlYCBmb3IgYFwiYXV0b1wiYC5cbiAgICovXG4gIGZhaWxPbkVycm9yPzogYm9vbGVhbjtcbn1cblxuLyoqIFRoZSBgZGF0YWJyaWNrc0FJVG9vbHNgIGNvbmZpZyBvcHRpb246IGEgdG9nZ2xlLCBgXCJhdXRvXCJgLCBvciBhbiBvcHRpb25zIGJhZy4gKi9cbmV4cG9ydCB0eXBlIERhdGFicmlja3NBSVRvb2xzT3B0aW9uID0gYm9vbGVhbiB8IFwiYXV0b1wiIHwgRGF0YWJyaWNrc0FJVG9vbHNPcHRpb25zO1xuXG4vKiogV2hhdCB7QGxpbmsgcHJvdmlzaW9uRGF0YWJyaWNrc0FJVG9vbHN9IHJlc29sdmVkLiAqL1xuZXhwb3J0IGludGVyZmFjZSBQcm92aXNpb25lZERhdGFicmlja3NBSVRvb2xzIHtcbiAgLyoqIEV4dHJhIExPQ0FMIHNraWxsIHNjYW4gcGF0aHMgdG8gaGFuZCBNYXN0cmEuIEVtcHR5IHdoZW4gZGlzYWJsZWQvdW5yZXNvbHZlZC4gKi9cbiAgbG9jYWxTa2lsbFBhdGhzOiBzdHJpbmdbXTtcbiAgLyoqIEhvdyB0aGUgc2tpbGxzIHdlcmUgc291cmNlZCwgZm9yIGxvZ2dpbmcuICovXG4gIHNvdXJjZT86IFwiY2xpXCI7XG59XG5cbi8qIC0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0gaGVscGVycyAtLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tICovXG5cbi8qKiBOb3JtYWxpemUgdGhlIGBkYXRhYnJpY2tzQUlUb29sc2Agb3B0aW9uIGludG8gYSBmbGF0IG9wdGlvbnMgYmFnLCBvciBgdW5kZWZpbmVkYCB3aGVuIG9mZi4gKi9cbmV4cG9ydCBmdW5jdGlvbiBub3JtYWxpemVEYXRhYnJpY2tzQUlUb29sc09wdGlvbihcbiAgb3B0aW9uOiBEYXRhYnJpY2tzQUlUb29sc09wdGlvbiB8IHVuZGVmaW5lZCxcbik6IERhdGFicmlja3NBSVRvb2xzT3B0aW9ucyB8IHVuZGVmaW5lZCB7XG4gIGlmIChvcHRpb24gPT09IHVuZGVmaW5lZCB8fCBvcHRpb24gPT09IGZhbHNlKSByZXR1cm4gdW5kZWZpbmVkO1xuICBpZiAob3B0aW9uID09PSB0cnVlKSByZXR1cm4geyBtb2RlOiBcInJlcXVpcmVcIiB9O1xuICBpZiAob3B0aW9uID09PSBcImF1dG9cIikgcmV0dXJuIHsgbW9kZTogXCJhdXRvXCIgfTtcbiAgcmV0dXJuIHsgbW9kZTogb3B0aW9uLm1vZGUgPz8gXCJhdXRvXCIsIC4uLm9wdGlvbiB9O1xufVxuXG4vKipcbiAqIE1hdGVyaWFsaXplIERhdGFicmlja3MgQUkgVG9vbHMgc2tpbGxzIGF0IGFwcCBzdGFydHVwIGFuZCByZXR1cm4gdGhlbSBhc1xuICogZXh0cmEgbG9jYWwgc2tpbGwgc2NhbiBwYXRocy5cbiAqXG4gKiBSZXNvbHV0aW9uOiByZXVzZSB0aGUgaW5zdGFsbGVkIGdsb2JhbCB0cmVlIHdoZW4gcHJlc2VudCAobm8gQ0xJIGNhbGwpIHVubGVzc1xuICogYHJlZnJlc2hgL2Bza2lsbHNgL2BwYXRoYCBhc2sgZm9yIGEgZnJlc2ggQ0xJIG1hdGVyaWFsaXphdGlvbjsgb3RoZXJ3aXNlIHJ1blxuICogYGRhdGFicmlja3MgYWl0b29scyBpbnN0YWxsIC0tcGF0aCA8ZGlyPiAtLXNraWxscy1vbmx5YCB3aGVuIHRoZSBDTEkgcmVzb2x2ZXMuXG4gKiBBIGBcInJlcXVpcmVcImAgcHJvdmlzaW9uIHRoYXQgeWllbGRzIG5vdGhpbmcgZmFpbHMgc3RhcnR1cCB1bmxlc3NcbiAqIGBmYWlsT25FcnJvcjogZmFsc2VgLlxuICovXG5leHBvcnQgYXN5bmMgZnVuY3Rpb24gcHJvdmlzaW9uRGF0YWJyaWNrc0FJVG9vbHMoXG4gIG9wdGlvbjogRGF0YWJyaWNrc0FJVG9vbHNPcHRpb24gfCB1bmRlZmluZWQsXG4pOiBQcm9taXNlPFByb3Zpc2lvbmVkRGF0YWJyaWNrc0FJVG9vbHM+IHtcbiAgY29uc3Qgb3B0aW9ucyA9IG5vcm1hbGl6ZURhdGFicmlja3NBSVRvb2xzT3B0aW9uKG9wdGlvbik7XG4gIGNvbnN0IGVtcHR5OiBQcm92aXNpb25lZERhdGFicmlja3NBSVRvb2xzID0geyBsb2NhbFNraWxsUGF0aHM6IFtdIH07XG4gIGlmICghb3B0aW9ucykgcmV0dXJuIGVtcHR5O1xuXG4gIGNvbnN0IG1vZGUgPSBvcHRpb25zLm1vZGUgPz8gXCJhdXRvXCI7XG4gIGNvbnN0IGZhaWxPbkVycm9yID0gb3B0aW9ucy5mYWlsT25FcnJvciA/PyBtb2RlID09PSBcInJlcXVpcmVcIjtcblxuICB0cnkge1xuICAgIC8vIFRoZSBgZGF0YWJyaWNrc2AgQ0xJIGlzIHRoZSBzb3VyY2Ugb2YgdHJ1dGguIFdoZW4gaXQncyByZXNvbHZhYmxlLCBydW5cbiAgICAvLyBgZGF0YWJyaWNrcyBhaXRvb2xzIGluc3RhbGwgLS1wYXRoIDxkaXI+YCB0byBtYXRlcmlhbGl6ZSBhIGZyZXNoLFxuICAgIC8vIGFnZW50LWFnbm9zdGljIHNraWxsIHNldCBpbnRvIGEgZGlyIE1hc3RyYSBjYW4gc2Nhbi5cbiAgICBjb25zdCBjbGlQYXRoID0gYXdhaXQgcmVzb2x2ZUNsaShvcHRpb25zLmNsaSk7XG4gICAgaWYgKGNsaVBhdGgpIHtcbiAgICAgIGNvbnN0IGRpciA9IGF3YWl0IG1hdGVyaWFsaXplVmlhQ2xpKGNsaVBhdGgsIG9wdGlvbnMpO1xuICAgICAgaWYgKGRpcikgcmV0dXJuIHsgbG9jYWxTa2lsbFBhdGhzOiBbZGlyXSwgc291cmNlOiBcImNsaVwiIH07XG4gICAgfVxuXG4gICAgLy8gQ0xJIG5vdCBpbnN0YWxsZWQgKG9yIHByb2R1Y2VkIG5vdGhpbmcpLiBcImF1dG9cIiBsb2dzIGFuZCBtb3ZlcyBvbjtcbiAgICAvLyBcInJlcXVpcmVcIiBmYWlscyBzdGFydHVwIHVubGVzcyBgZmFpbE9uRXJyb3I6IGZhbHNlYC5cbiAgICBpZiAoZmFpbE9uRXJyb3IpIHtcbiAgICAgIHRocm93IG5ldyBFcnJvcihcbiAgICAgICAgYERhdGFicmlja3MgQUkgVG9vbHMgcmVxdWlyZWQgYnV0IHRoZSBcIiR7REFUQUJSSUNLU19DTEl9XCIgQ0xJIGlzIG5vdCBhdmFpbGFibGUuIEluc3RhbGwgdGhlIERhdGFicmlja3MgQ0xJIChcXGBkYXRhYnJpY2tzIGFpdG9vbHMgaW5zdGFsbFxcYCksIG9yIHNldCBkYXRhYnJpY2tzQUlUb29sczogXCJhdXRvXCIuYCxcbiAgICAgICk7XG4gICAgfVxuICAgIGxvZ2dlci5pbmZvKFwiZGF0YWJyaWNrcyBDTEkgbm90IGF2YWlsYWJsZTsgc2tpcHBpbmcgQUkgVG9vbHMgc2tpbGxzXCIpO1xuICAgIHJldHVybiBlbXB0eTtcbiAgfSBjYXRjaCAoZXJyKSB7XG4gICAgaWYgKGZhaWxPbkVycm9yKSB7XG4gICAgICB0aHJvdyBuZXcgRXJyb3IoXG4gICAgICAgIGBmYWlsZWQgdG8gcHJvdmlzaW9uIERhdGFicmlja3MgQUkgVG9vbHMgc2tpbGxzOiAke2Vycm9yLmVycm9yTWVzc2FnZShlcnIpfWAsXG4gICAgICAgIHsgY2F1c2U6IGVycm9yLnRvRXJyb3IoZXJyKSB9LFxuICAgICAgKTtcbiAgICB9XG4gICAgbG9nZ2VyLndhcm4oXCJza2lwcGVkXCIsIHsgZXJyb3I6IGVycm9yLmVycm9yTWVzc2FnZShlcnIpIH0pO1xuICAgIHJldHVybiBlbXB0eTtcbiAgfVxufVxuXG4vKiogUmVzb2x2ZSB0aGUgYGRhdGFicmlja3NgIENMSSwgcmV0dXJuaW5nIGl0cyBpbnZvY2F0aW9uIHBhdGggb3IgYHVuZGVmaW5lZGAuICovXG5hc3luYyBmdW5jdGlvbiByZXNvbHZlQ2xpKGNsaTogc3RyaW5nIHwgdW5kZWZpbmVkKTogUHJvbWlzZTxzdHJpbmcgfCB1bmRlZmluZWQ+IHtcbiAgY29uc3QgY29tbWFuZCA9IHN0cmluZy50cmltVG9OdWxsKGNsaSkgPz8gREFUQUJSSUNLU19DTEk7XG4gIHRyeSB7XG4gICAgY29uc3QgcmVzdWx0ID0gYXdhaXQgZXhlYy5zcGF3bihjb21tYW5kLCBbXCJhaXRvb2xzXCIsIFwidmVyc2lvblwiXSwge1xuICAgICAgc3Rkb3V0OiBcImNhcHR1cmVcIixcbiAgICAgIHN0ZGVycjogXCJjYXB0dXJlXCIsXG4gICAgICBjaGVjazogZmFsc2UsXG4gICAgfSk7XG4gICAgaWYgKHJlc3VsdC5leGl0Q29kZSA9PT0gMCkgcmV0dXJuIGNvbW1hbmQ7XG4gIH0gY2F0Y2gge1xuICAgIC8vIENMSSBhYnNlbnQgb3IgYGFpdG9vbHNgIHVuc3VwcG9ydGVkIC0gY2FsbGVyIGZhbGxzIGJhY2sgLyBmYWlscy5cbiAgfVxuICByZXR1cm4gdW5kZWZpbmVkO1xufVxuXG4vKipcbiAqIFJ1biBgZGF0YWJyaWNrcyBhaXRvb2xzIGluc3RhbGwgLS1wYXRoIDxkaXI+YCB0byBtYXRlcmlhbGl6ZSBhIHJlc29sdmVkLFxuICogYWdlbnQtYWdub3N0aWMgc2tpbGwgc2V0IGludG8gYSBkaXJlY3RvcnkgKHdyaXRlcyBgPG5hbWU+L1NLSUxMLm1kYCB0cmVlcyxcbiAqIG5vIGFnZW50cywgbm8gc3RhdGUpIE1hc3RyYSBjYW4gdGhlbiBzY2FuLlxuICovXG5hc3luYyBmdW5jdGlvbiBtYXRlcmlhbGl6ZVZpYUNsaShcbiAgY2xpOiBzdHJpbmcsXG4gIG9wdGlvbnM6IERhdGFicmlja3NBSVRvb2xzT3B0aW9ucyxcbik6IFByb21pc2U8c3RyaW5nIHwgdW5kZWZpbmVkPiB7XG4gIGNvbnN0IGV4cGxpY2l0ID0gc3RyaW5nLnRyaW1Ub051bGwob3B0aW9ucy5wYXRoKTtcbiAgbGV0IGRpcjogc3RyaW5nO1xuXG4gIGlmIChleHBsaWNpdCkge1xuICAgIC8vIEFuIGV4cGxpY2l0IHBhdGggaXMgdGhlIGNhbGxlcidzIHRvIG93biAtIGluc3RhbGwgc3RyYWlnaHQgaW50byBpdC5cbiAgICBhd2FpdCBpbnN0YWxsU2tpbGxzKGNsaSwgb3B0aW9ucywgZXhwbGljaXQpO1xuICAgIGRpciA9IGV4cGxpY2l0O1xuICB9IGVsc2Uge1xuICAgIC8vIFRoZSByZXNvbHZlZCBza2lsbCBzZXQgaXMgdGhlIHNhbWUgb24gYWxtb3N0IGV2ZXJ5IGJvb3QsIHNvIHJlYnVpbGQgT05FXG4gICAgLy8gc3RhYmxlIHRlbXAgdHJlZSByYXRoZXIgdGhhbiBsZWF2aW5nIGEgZnJlc2ggc2NyYXRjaCBkaXIgYmVoaW5kIGVhY2hcbiAgICAvLyB0aW1lLiBUaGUgQ0xJIHdyaXRlcyBpbnRvIGEgdGhyb3dhd2F5IHJvb3QgdGhhdCBvbmx5IHJlcGxhY2VzIHRoZSBzdGFibGVcbiAgICAvLyBvbmUgb24gc3VjY2Vzcywgc28gYSBmYWlsZWQgaW5zdGFsbCBrZWVwcyB0aGUgcHJldmlvdXMgc2tpbGxzIHVzYWJsZS5cbiAgICBjb25zdCBzdGFibGUgPSBhd2FpdCBsb2NhbEZTLnJlYnVpbGRGUyhTS0lMTFNfQ0FDSEVfRElSLCAoc2NyYXRjaCkgPT5cbiAgICAgIGluc3RhbGxTa2lsbHMoY2xpLCBvcHRpb25zLCBzY3JhdGNoLnJvb3QpLFxuICAgICk7XG4gICAgZGlyID0gc3RhYmxlLnJvb3Q7XG4gIH1cblxuICBpZiAoIWV4aXN0c1N5bmMoZGlyKSkgcmV0dXJuIHVuZGVmaW5lZDtcbiAgbG9nZ2VyLmRlYnVnKFwibWF0ZXJpYWxpemVkIGFpdG9vbHMgc2tpbGxzIHZpYSBDTElcIiwge1xuICAgIHBhdGg6IGRpcixcbiAgICBza2lsbHM6IHN0cmluZy5wYXJzZUxpc3Qob3B0aW9ucy5za2lsbHMpLFxuICB9KTtcbiAgcmV0dXJuIGRpcjtcbn1cblxuLyoqIFJ1biBgZGF0YWJyaWNrcyBhaXRvb2xzIGluc3RhbGwgLS1wYXRoIDxkaXI+YCwgZmFpbGluZyBsb3VkbHkgb24gYSBub24temVybyBleGl0LiAqL1xuYXN5bmMgZnVuY3Rpb24gaW5zdGFsbFNraWxscyhcbiAgY2xpOiBzdHJpbmcsXG4gIG9wdGlvbnM6IERhdGFicmlja3NBSVRvb2xzT3B0aW9ucyxcbiAgZGlyOiBzdHJpbmcsXG4pOiBQcm9taXNlPHZvaWQ+IHtcbiAgY29uc3QgYXJncyA9IFtcImFpdG9vbHNcIiwgXCJpbnN0YWxsXCIsIFwiLS1wYXRoXCIsIGRpcl07XG4gIGNvbnN0IHNraWxscyA9IHN0cmluZy5wYXJzZUxpc3Qob3B0aW9ucy5za2lsbHMpO1xuICBpZiAoc2tpbGxzLmxlbmd0aCA+IDApIGFyZ3MucHVzaChcIi0tc2tpbGxzXCIsIHNraWxscy5qb2luKFwiLFwiKSk7XG4gIGlmIChvcHRpb25zLmV4cGVyaW1lbnRhbCkgYXJncy5wdXNoKFwiLS1leHBlcmltZW50YWxcIik7XG5cbiAgY29uc3QgcmVzdWx0ID0gYXdhaXQgZXhlYy5zcGF3bihjbGksIGFyZ3MsIHtcbiAgICBzdGRvdXQ6IFwiY2FwdHVyZVwiLFxuICAgIHN0ZGVycjogXCJjYXB0dXJlXCIsXG4gICAgY2hlY2s6IGZhbHNlLFxuICB9KTtcbiAgaWYgKHJlc3VsdC5leGl0Q29kZSAhPT0gMCkge1xuICAgIHRocm93IG5ldyBFcnJvcihcbiAgICAgIGBkYXRhYnJpY2tzIGFpdG9vbHMgaW5zdGFsbCBmYWlsZWQgKGV4aXQgJHtyZXN1bHQuZXhpdENvZGV9KTogJHtyZXN1bHQuc3RkZXJyIHx8IHJlc3VsdC5zdGRvdXR9YCxcbiAgICApO1xuICB9XG59XG4iXX0=