@skaile/workspaces 0.8.5

package/dist/asset-manager/src/index.d.ts

@@ -0,0 +1,459 @@
+/**
+ * @skaile/asset-manager — programmatic AI asset management API.
+ *
+ * Manages project-local repositories, dependency resolution, deployment,
+ * lock files, patches, and contribution workflows.
+ *
+ * Usage:
+ *   import { AssetManager } from "@skaile/workspaces/asset-manager"
+ *   const am = new AssetManager({ projectDir: "/path/to/project" })
+ *   await am.install()
+ */
+import type { AssetCollision, CatalogEntry, LockFile } from "@skaile/workspaces/core";
+import type { DriverTarget } from "@skaile/workspaces/core";
+import type { HistoryEntry } from "./history.js";
+export type { DeployOptions } from "./installer.js";
+export type { Log } from "./renderers.js";
+export type { HistoryEntry } from "./history.js";
+export { createScaffold, deployAll, removeAsset } from "./installer.js";
+export { renderAgentToFramework } from "./renderers.js";
+export { appendHistory, clearHistory, getRecentHistory, loadHistory, } from "./history.js";
+/**
+ * Metadata about a repository declared in `skaile.yaml`.
+ *
+ * @docLink packages/asset-manager/concepts#asset-manager
+ */
+export interface RepoInfo {
+    /** Repository name as declared in `skaile.yaml`. */
+    name: string;
+    /** How the repo is sourced: cloned from a URL, mounted from a local path, or symlinked via `skaile repo link`. */
+    kind: "local" | "remote" | "linked";
+    /** Remote URL (present when `kind === "remote"`). */
+    url?: string;
+    /** Filesystem path (present when `kind === "local"` or `kind === "linked"`). */
+    path?: string;
+    /** Git branch configured for this repository. */
+    branch: string;
+    /** Whether the repository has been cloned/resolved locally. */
+    cloned: boolean;
+}
+/**
+ * Live sync status for a repository.
+ *
+ * @docLink packages/asset-manager/concepts#asset-manager
+ */
+export interface RepoStatusInfo {
+    /** Repository name as declared in `skaile.yaml`. */
+    name: string;
+    /** How the repo is sourced. */
+    kind: "local" | "remote" | "linked";
+    /** Number of commits the local clone is behind the remote. */
+    behind: number;
+    /** `true` when the local clone matches the remote HEAD. */
+    upToDate: boolean;
+    /** Error message when status check failed. */
+    error?: string;
+}
+/**
+ * Result of a full `skaile install` or `skaile add` run.
+ *
+ * @docLink packages/asset-manager/concepts#asset-manager
+ */
+export interface InstallResult {
+    /** Asset refs (`kind:name`) successfully deployed in this run. */
+    deployed: string[];
+    /** Asset refs (`kind:name`) removed because they are no longer in the resolved set. */
+    removed: string[];
+    /** Asset refs that could not be resolved in any configured repository. */
+    missing: string[];
+    /** Whether `skaile.lock.yaml` was written or updated. */
+    lockWritten: boolean;
+    /** Assets that exist in multiple repos — the resolved entry shadows others. */
+    collisions: AssetCollision[];
+    /**
+     * npm packages installed as a side effect of resolving runtime asset peer
+     * deps (connectors / mounts declared in skaile.yaml). Empty when nothing
+     * needed installing or when the runtime-deps step was skipped.
+     */
+    npmInstalled?: string[];
+    /**
+     * npm packages that the runtime-deps step tried but failed to install.
+     * Non-fatal — listed for telemetry and CLI reporting.
+     */
+    npmFailed?: string[];
+}
+/**
+ * An installed asset whose source repository is behind the remote.
+ *
+ * @docLink packages/asset-manager/concepts#asset-manager
+ */
+export interface OutdatedEntry {
+    /** Asset kind (`skill`, `agent`, `prompt`, `flow`, `contract`). */
+    kind: string;
+    /** Asset name as registered in the catalog. */
+    name: string;
+    /** Repository that provides this asset. */
+    repository: string;
+    /** Version string recorded in the lock file at install time. */
+    currentVersion: string;
+    /** Number of commits the local repository is behind the remote. */
+    behind: number;
+}
+/**
+ * A node in the resolved dependency tree (returned by `AssetManager.tree()`).
+ *
+ * @docLink packages/asset-manager/concepts#asset-manager
+ */
+export interface DependencyNode {
+    /** Asset ref (`kind:name`) or `"project"` for the root node. */
+    ref: string;
+    /** Transitive dependencies resolved by this node. */
+    children: DependencyNode[];
+}
+/**
+ * A missing dependency detected by `AssetManager.doctor()`.
+ *
+ * @docLink packages/asset-manager/concepts#asset-manager
+ */
+export interface DepIssue {
+    /** Kind of the asset that has the unsatisfied requirement. */
+    assetKind: string;
+    /** Name of the asset that has the unsatisfied requirement. */
+    assetName: string;
+    /** Kind of the missing dependency. */
+    depKind: string;
+    /** Name of the missing dependency. */
+    depName: string;
+    /** `true` when the missing dependency exists in a configured repository but has not been installed. */
+    inRepos: boolean;
+}
+/**
+ * A single deployed asset shown in the workspace overview.
+ *
+ * @docLink packages/asset-manager/concepts#asset-manager
+ */
+export interface OverviewEntry {
+    /** Asset kind (`skill`, `agent`, `prompt`, `flow`, `contract`). */
+    kind: string;
+    /** Asset name. */
+    name: string;
+    /** Domain the asset belongs to (from the lock file; `"unknown"` when unresolvable). */
+    domain: string;
+    /** Repository that provides this asset. */
+    repository: string;
+    /** Version string from the lock file. */
+    version: string;
+    /**
+     * Sync status relative to the source repository.
+     * - `"synced"` — local clone matches remote HEAD
+     * - `"outdated"` — local clone is behind the remote
+     * - `"local"` — sourced from a local path, no remote to compare
+     * - `"error"` — status check failed
+     * - `"unknown"` — repository not found or lock entry missing
+     */
+    syncStatus: string;
+}
+/**
+ * Aggregated workspace overview returned by `AssetManager.overview()`.
+ *
+ * @docLink packages/asset-manager/concepts#asset-manager
+ */
+export interface OverviewResult {
+    /** Entries grouped by domain, sorted alphabetically. Each group is sorted by kind then name. */
+    byDomain: Map<string, OverviewEntry[]>;
+    /** Total number of deployed assets. */
+    total: number;
+    /** Sync status for each configured repository. */
+    repos: RepoStatusInfo[];
+}
+/**
+ * Options for constructing an {@link AssetManager}.
+ *
+ * @docLink packages/asset-manager/concepts#asset-manager
+ */
+export interface AssetManagerOptions {
+    /** Absolute or relative path to the workspace root (must contain `skaile.yaml`). */
+    projectDir: string;
+    /**
+     * Agent framework to target for asset deployment.
+     * Determines which framework directories (``.claude/``, ``.omp/``, etc.) are used.
+     * Defaults to `"claude-code"`.
+     */
+    driverTarget?: DriverTarget;
+    /**
+     * When `true`, assets are installed into the global Skaile cache rather than the
+     * project workspace. Skips `skaile.yaml` dependency updates.
+     */
+    global?: boolean;
+}
+/**
+ * Programmatic API for managing AI assets in a Skaile workspace.
+ *
+ * `AssetManager` wraps repository management, catalog search, asset installation,
+ * lock-file tracking, patch workflows, and workspace diagnostics. The CLI delegates
+ * all `skaile catalog`, `skaile repo`, `skaile install`, `skaile add`, and
+ * `skaile init` commands to this class.
+ *
+ * @example
+ * ```typescript
+ * import { AssetManager } from "@skaile/workspaces/asset-manager";
+ *
+ * const am = new AssetManager({ projectDir: "/my-project" });
+ *
+ * // Install all dependencies declared in skaile.yaml
+ * const result = await am.install();
+ * console.log(`Deployed: ${result.deployed.join(", ")}`);
+ *
+ * // Add a single skill (resolves transitive deps, updates skaile.yaml)
+ * const deployed = am.add("skill:my-skill");
+ *
+ * // Search the catalog
+ * const skills = am.search("code review", "skill");
+ * ```
+ *
+ * @docLink packages/asset-manager/concepts#asset-manager
+ */
+export declare class AssetManager {
+    /** Resolved absolute path to the workspace root. */
+    readonly projectDir: string;
+    /** Agent framework driver target used for all deploy operations. */
+    readonly driverTarget: DriverTarget;
+    /** Whether this instance operates in global-install mode. */
+    readonly global: boolean;
+    constructor(opts: AssetManagerOptions);
+    private get reposDir();
+    private get lockPath();
+    private get patchDir();
+    private get deployOpts();
+    private loadConfig;
+    /**
+     * Install all dependencies declared in `skaile.yaml`.
+     *
+     * Steps: clone/pull repositories → resolve transitive dependencies → reconcile
+     * (remove stale assets) → deploy new assets → write `skaile.lock.yaml` → record history.
+     *
+     * @param opts - Optional installation options.
+     * @param opts.locked - When `true`, restore the exact versions recorded in the existing
+     *   lock file instead of resolving from source. Throws if no lock file is found.
+     * @returns {@link InstallResult} summarising what was deployed, what was missing, and any collisions.
+     */
+    install(opts?: {
+        locked?: boolean;
+    }): Promise<InstallResult>;
+    /**
+     * Resolve runtime assets and install any missing npm peer deps.
+     *
+     * - Required deps: installed via `bun add --optional`. Failure is recorded
+     *   in `npmFailed` but does not throw — install() proceeds so users get a
+     *   useful error message rather than a hung command.
+     * - Optional deps: not installed automatically (would force every consumer
+     *   to pull every connector's deps). Future: add a flag to opt in.
+     */
+    private installRuntimeAssetDeps;
+    private installLocked;
+    /**
+     * Add a single asset (and its transitive dependencies) to the workspace.
+     *
+     * Resolves `ref`, deploys the asset and all requirements, then records the ref
+     * in `skaile.yaml` `dependencies` so subsequent `skaile install` runs re-deploy it.
+     *
+     * @param ref - Asset ref in `kind:name` or `repo/kind:name` form (e.g. `skill:my-skill`).
+     * @returns Array of asset refs that were deployed in this call.
+     * @throws When the asset cannot be found in any configured repository.
+     */
+    add(ref: string): string[];
+    /**
+     * Remove a deployed asset and unregister it from `skaile.yaml`.
+     *
+     * @param ref - Asset ref in `kind:name` form (e.g. `skill:my-skill`).
+     * @returns `true` if the asset was found and removed, `false` if it was not deployed.
+     */
+    remove(ref: string): boolean;
+    /**
+     * Search the catalog across all configured repositories.
+     *
+     * @param query - Substring to match against entry names and descriptions (case-insensitive).
+     *   Omit to return all entries.
+     * @param kind - Filter by asset kind (`"skill"`, `"agent"`, `"prompt"`, `"flow"`, `"contract"`).
+     *   Omit to return all kinds.
+     * @returns Array of matching {@link CatalogEntry} objects from all accessible repositories.
+     */
+    search(query?: string, kind?: string): CatalogEntry[];
+    /**
+     * Look up a single asset's full catalog entry.
+     *
+     * @param ref - Asset ref in `kind:name` or `repo/kind:name` form.
+     * @returns The matching {@link CatalogEntry}, or `null` when not found.
+     */
+    info(ref: string): CatalogEntry | null;
+    /**
+     * List all assets currently deployed in the workspace (or global cache).
+     *
+     * Scans the framework deploy directories rather than the lock file, so it
+     * also returns assets that were installed manually or outside of `skaile install`.
+     *
+     * @param kind - Filter by asset kind. Omit to return all kinds.
+     * @returns Shallow {@link CatalogEntry} objects (description and version will be empty).
+     */
+    listDeployed(kind?: string): CatalogEntry[];
+    /**
+     * Build an aggregated workspace overview with domain grouping and sync status.
+     *
+     * Combines deployed assets, lock file metadata, and live repository status
+     * into a single structured result. Used by `skaile status`.
+     *
+     * @returns {@link OverviewResult} with entries grouped by domain and per-repo sync status.
+     */
+    overview(): OverviewResult;
+    /**
+     * Build the resolved dependency tree from the lock file.
+     *
+     * @returns Root {@link DependencyNode} with `ref === "project"` whose children
+     *   are the directly-declared dependencies, each with their own transitive subtrees.
+     *   Returns a single node with `ref === "(no lock file)"` when no lock exists.
+     */
+    tree(): DependencyNode;
+    /**
+     * Explain why an asset is installed by tracing its dependency chain in the lock file.
+     *
+     * @param ref - Asset ref in `kind:name` form.
+     * @returns Chain of refs from the asset back to `"direct (skaile.yaml)"`, or `[]` when
+     *   the asset is not in the lock file.
+     */
+    why(ref: string): string[];
+    /**
+     * List installed assets whose source repository is behind the remote.
+     *
+     * Only remote repositories (not local paths) are checked for staleness.
+     *
+     * @returns Array of {@link OutdatedEntry} objects, one per asset in a repository
+     *   that has commits not yet pulled locally.
+     */
+    outdated(): OutdatedEntry[];
+    /**
+     * Produce a unified diff between the deployed asset and its catalog source.
+     *
+     * Useful for detecting manual edits to deployed files or verifying that a patch
+     * was applied correctly.
+     *
+     * @param ref - Asset ref in `kind:name` form.
+     * @returns Unified diff string, or `null` when there are no differences or the
+     *   asset is not deployed/resolvable.
+     */
+    diff(ref: string): string | null;
+    /**
+     * Resolve all declared dependencies and write (or overwrite) `skaile.lock.yaml`.
+     *
+     * Performs repository sync and full dependency resolution without deploying assets.
+     * Use this to regenerate the lock file after manually editing `skaile.yaml`.
+     *
+     * @returns The written {@link LockFile} data.
+     */
+    lock(): LockFile;
+    /**
+     * Extract a deployed asset into a patch working directory for editing.
+     *
+     * Copies the deployed asset to `.skaile/patches/<kind>-<name>/` so changes
+     * can be made there and then committed as a patch file via `patchCommit`.
+     *
+     * @param ref - Asset ref in `kind:name` form.
+     * @returns Absolute path to the patch working directory.
+     * @throws When the asset cannot be found in the catalog.
+     */
+    patch(ref: string): string;
+    /**
+     * Generate a `.patch` file from changes made in the patch working directory.
+     *
+     * Diffs the patch working directory against the original catalog source and
+     * writes the result to `.skaile/patches/<kind>-<name>.patch`.
+     *
+     * @param ref - Asset ref in `kind:name` form.
+     * @returns Absolute path to the generated `.patch` file.
+     * @throws When the patch working directory does not exist or no differences are found.
+     */
+    patchCommit(ref: string): string;
+    /**
+     * Apply the committed patch file to the repository clone and open a contribution branch.
+     *
+     * Applies `.skaile/patches/<kind>-<name>.patch` to the repository clone, creates a
+     * `patch/<kind>-<name>` branch, and stages a commit — ready to push via `contribPush`.
+     *
+     * @param ref - Asset ref in `kind:name` form.
+     * @throws When the asset is not found, has no repository, or the patch file is missing.
+     */
+    patchSubmit(ref: string): void;
+    /**
+     * Delete the patch working directory and patch file for an asset.
+     *
+     * @param ref - Asset ref in `kind:name` form.
+     */
+    patchRemove(ref: string): void;
+    /**
+     * Scan deployed assets for unsatisfied transitive dependencies.
+     *
+     * For each deployed asset, checks that all entries in its `requires` list are
+     * also deployed. Returns a list of issues with a flag indicating whether the
+     * missing dependency can be resolved from a configured repository.
+     *
+     * @returns Array of {@link DepIssue} objects. An empty array means the workspace is healthy.
+     */
+    doctor(): DepIssue[];
+    /**
+     * Create a minimal asset scaffold directory (delegates to {@link createScaffold}).
+     *
+     * @param name - Asset name (also used as the directory name).
+     * @param kind - Asset kind: `skill` | `agent` | `bundle` | `flow` | `prompt` | `contract`.
+     * @param destDir - Parent directory to create the asset in.
+     * @returns `{ ok: true, path }` on success, `{ ok: false, path: errorMessage }` if the
+     *   directory already exists.
+     */
+    create(name: string, kind: string, destDir: string): {
+        ok: boolean;
+        path: string;
+    };
+    /**
+     * Return recent asset action history entries, newest first.
+     *
+     * @param limit - Maximum number of entries to return. Defaults to `20`.
+     * @returns Array of {@link HistoryEntry} objects in reverse-chronological order.
+     */
+    history(limit?: number): HistoryEntry[];
+    /**
+     * Erase all asset action history for this workspace.
+     */
+    clearHistory(): void;
+    /**
+     * Remove deployed assets tracked by the lock file and report unmanaged ones.
+     *
+     * With `opts.all`, also deletes `.skaile/history.yaml`, `.skaile/patches/`,
+     * `.skaile/repos/`, and `skaile.lock.yaml` — effectively resetting the workspace
+     * to a pre-install state.
+     *
+     * @param opts - Optional cleanup options.
+     * @param opts.all - When `true`, remove all Skaile-managed state in addition to deployed assets.
+     * @returns Object with `removed` (successfully cleaned refs), `skipped` (with reasons),
+     *   and `unmanaged` (deployed assets not in the lock file).
+     */
+    clean(opts?: {
+        all?: boolean;
+    }): {
+        removed: string[];
+        skipped: Array<{
+            ref: string;
+            reason: string;
+        }>;
+        unmanaged: string[];
+    };
+    /** Add a dependency ref to skaile.yaml if not already present. */
+    private addDependencyToConfig;
+    /** Remove a dependency ref from skaile.yaml. */
+    private removeDependencyFromConfig;
+    private resolveRepoDir;
+}
+export { scaffoldWorkspace, listTemplates, setTemplatesDir } from "./scaffold/index.js";
+export type { ScaffoldOptions, ScaffoldResult, TemplateManifest } from "./scaffold/index.js";
+export { AGENT_RENDERERS, claudeCodeRenderer, codexRenderer, driverTargetSupportsAgents, ompRenderer, } from "./renderers.js";
+export type { AgentRenderer, AgentRenderInput, AgentRenderResult } from "./renderers.js";
+export type { AbilityRef, ConnectorRef, ContractRef, FragmentContext, FragmentId, } from "./fragments.js";
+export { BUILT_IN_FRAGMENTS, resolveFragments, loadPromptExtensions } from "./fragments.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/asset-manager/src/index.d.ts.map

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

package/dist/asset-manager/src/installer.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Asset deployment — symlink (local repos) or copy (remote repos) to framework dirs.
+ */
+import type { CatalogEntry } from "@skaile/workspaces/core";
+import type { DriverTarget, RepositoryDeclaration } from "@skaile/workspaces/core";
+import type { Log } from "./renderers.js";
+export type { Log } from "./renderers.js";
+/**
+ * Options controlling where and how assets are deployed.
+ *
+ * @docLink packages/asset-manager/api-reference#installer
+ */
+export interface DeployOptions {
+    /** Agent framework to target (determines framework-specific directory layout). Defaults to `"claude-code"`. */
+    driverTarget?: DriverTarget;
+    /** When `true`, deploy into the global Skaile cache rather than a project workspace. */
+    global?: boolean;
+    /** Absolute path to the workspace root. Defaults to `process.cwd()`. */
+    cwd?: string;
+}
+/**
+ * Deploy a single asset to the framework-specific directory.
+ *
+ * Uses symlinks for local-path repositories (fast, live-updating) and copies
+ * for remote repositories (persists after repo wipes). Agents are rendered
+ * via the enriched `installAgent` path which resolves abilities, contracts,
+ * and framework fragments before writing the native agent file.
+ *
+ * @param entry - Catalog entry describing the asset to deploy.
+ * @param repositories - Repository declarations from `skaile.yaml` (used to
+ *   determine whether the source is a local path or a remote clone).
+ * @param opts - Deployment target options.
+ * @param log - Optional logger callback for progress messages.
+ * @returns `true` when the asset was deployed successfully.
+ * @docLink packages/asset-manager/api-reference#installer
+ */
+export declare function deployAsset(entry: CatalogEntry, repositories: Record<string, RepositoryDeclaration>, opts?: DeployOptions, log?: Log): boolean;
+/**
+ * Deploy all resolved assets, applying patches where configured.
+ *
+ * Already-deployed assets are skipped unless their deployed manifest content differs
+ * from the source. This handles copies (remote repos) that have gone stale after a
+ * source update. Symlinked (local) repos always resolve to the live source, so their
+ * hashes always match and they are never needlessly re-linked.
+ *
+ * @param resolved - Catalog entries to deploy (output of `resolveAll`).
+ * @param repositories - Repository declarations from `skaile.yaml`.
+ * @param patches - Map of `kind:name` → patch file path for patch application.
+ * @param opts - Deployment target options.
+ * @param log - Optional logger callback for progress messages.
+ * @returns Array of asset refs (`kind:name`) that were newly deployed in this call.
+ * @docLink packages/asset-manager/api-reference#installer
+ */
+export declare function deployAll(resolved: CatalogEntry[], repositories: Record<string, RepositoryDeclaration>, patches: Record<string, string>, opts?: DeployOptions, log?: Log): string[];
+/**
+ * Remove a deployed asset from the framework directory.
+ *
+ * Removes symlinks with `unlink`; removes copied directories with `rm -rf`.
+ *
+ * @param kind - Asset kind (`skill`, `agent`, `prompt`, `flow`, `contract`).
+ * @param name - Asset name as registered in the catalog.
+ * @param opts - Deployment target options (must match the options used at install time).
+ * @returns `true` if the asset existed and was removed; `false` if it was not deployed.
+ * @docLink packages/asset-manager/api-reference#installer
+ */
+export declare function removeAsset(kind: string, name: string, opts?: DeployOptions): boolean;
+/**
+ * Create a minimal scaffold directory for a new asset.
+ *
+ * Writes the appropriate manifest file (`SKILL.md`, `AGENT.md`, `CONTRACT.md`,
+ * `<name>.bundle.yaml`, `<name>.flow.yaml`, or `<name>.prompt.md`) inside a
+ * new `<destDir>/<name>/` directory.
+ *
+ * @param name - Asset name (also used as the directory name).
+ * @param kind - Asset kind: `skill` | `agent` | `bundle` | `flow` | `prompt` | `contract`.
+ * @param destDir - Parent directory to create the asset in.
+ * @returns `{ ok: true, path }` on success, `{ ok: false, path: errorMessage }` if the
+ *   directory already exists.
+ * @docLink packages/asset-manager/api-reference#installer
+ */
+export declare function createScaffold(name: string, kind: string, destDir: string): {
+    ok: boolean;
+    path: string;
+};
+//# sourceMappingURL=installer.d.ts.map

package/dist/asset-manager/src/installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../../../asset-manager/src/installer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAe,YAAY,EAAE,MAAM,yBAAyB,CAAC;AASzE,OAAO,KAAK,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEnF,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAG1C,YAAY,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AA6C1C;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,+GAA+G;IAC/G,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,wFAAwF;IACxF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,wEAAwE;IACxE,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAID;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,YAAY,EACnB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,EACnD,IAAI,GAAE,aAAkB,EACxB,GAAG,GAAE,GAAU,GACd,OAAO,CAwDT;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,YAAY,EAAE,EACxB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,EACnD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,IAAI,GAAE,aAAkB,EACxB,GAAG,GAAE,GAAU,GACd,MAAM,EAAE,CAwEV;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,aAAkB,GAAG,OAAO,CAczF;AAkCD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAwB/B"}