@skaile/workspaces 0.8.5

package/dist/discovery/src/source-config.d.ts

@@ -0,0 +1,456 @@
+import * as z from "zod";
+/**
+ * Semver regex matching `MAJOR.MINOR.PATCH` with optional `-<prerelease>` and
+ * `+<build>` segments. Author-shipped inventory entries must declare a version
+ * that matches this regex.
+ *
+ * @docLink packages/discovery/concepts#author-manifest-semver
+ */
+export declare const SEMVER_RE: RegExp;
+declare const PublisherOverrideSchema: z.ZodObject<{
+    /** Relative path within the repo (trailing slash convention). */
+    path: z.ZodString;
+    /** Publisher namespace override for assets under this path. */
+    publisher: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    publisher: string;
+}, {
+    path: string;
+    publisher: string;
+}>;
+declare const SyncConfigSchema: z.ZodEffects<z.ZodObject<{
+    /** How the catalog backend learns about repo changes. */
+    trigger: z.ZodDefault<z.ZodEnum<["webhook", "poll"]>>;
+    /** Seconds between polls. Required when trigger=poll. */
+    poll_interval: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    trigger: "poll" | "webhook";
+    poll_interval?: number | undefined;
+}, {
+    trigger?: "poll" | "webhook" | undefined;
+    poll_interval?: number | undefined;
+}>, {
+    trigger: "poll" | "webhook";
+    poll_interval?: number | undefined;
+}, {
+    trigger?: "poll" | "webhook" | undefined;
+    poll_interval?: number | undefined;
+}>;
+/**
+ * Single entry in the author-shipped inventory (the `assets:` block of a
+ * `.skaile-source.yaml` with `version: 2`).
+ *
+ * When the `assets:` block is present, discovery uses these entries as the
+ * source of truth (`discoverFromManifest`) instead of running glob walk +
+ * publisher resolution.
+ *
+ * @docLink packages/discovery/concepts#author-manifest-asset-entry
+ */
+declare const AssetEntrySchema: z.ZodObject<{
+    /** Relative path within the repo (directory or file). */
+    path: z.ZodString;
+    /** Asset kind — validated against `IAssetKindRegistry` at discovery time. */
+    kind: z.ZodString;
+    /** Publisher namespace. Required per entry; overrides publisher_default / _overrides. */
+    publisher: z.ZodString;
+    /** Asset name. Identity tuple is `<publisher>/<name>@<version>`. */
+    name: z.ZodString;
+    /** Semver version string. */
+    version: z.ZodString;
+    /**
+     * Hex-encoded SHA256 hash of the deterministic tarball contents.
+     * Optional on write, REQUIRED on Catalog publish (Phase 4).
+     */
+    sha256: z.ZodOptional<z.ZodString>;
+    /** Curated file filter (paths relative to `path:`). At least one entry. */
+    files: z.ZodArray<z.ZodString, "many">;
+    /** Author-declared requires-graph entries. */
+    requires: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /** Optional passthrough to `AssetDefinition.manifest`. */
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    kind: string;
+    version: string;
+    requires: string[];
+    path: string;
+    publisher: string;
+    files: string[];
+    metadata?: Record<string, unknown> | undefined;
+    sha256?: string | undefined;
+}, {
+    name: string;
+    kind: string;
+    version: string;
+    path: string;
+    publisher: string;
+    files: string[];
+    requires?: string[] | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    sha256?: string | undefined;
+}>;
+/**
+ * Root schema for `.skaile-source.yaml`.
+ *
+ * Declares how a repo maps to Catalog publisher namespaces.
+ * Template variable `<domain>` in publisher_default is replaced at discovery
+ * time with the first-level directory name containing the asset.
+ *
+ * Schema version `1` is the original glob-discovery surface. Version `2`
+ * extends the schema with an optional `assets:` block — when present,
+ * discovery uses the author-shipped inventory as authoritative and skips
+ * glob walk + publisher resolution + AI enrichment.
+ *
+ * @docLink packages/discovery/concepts#source-config-schema
+ */
+export declare const SourceConfigSchema: z.ZodEffects<z.ZodObject<{
+    /** Schema version. `1` (glob mode) or `2` (allows `assets:` block). */
+    version: z.ZodUnion<[z.ZodLiteral<1>, z.ZodLiteral<2>]>;
+    /**
+     * Default publisher namespace template.
+     * Use `@<domain>` to derive from first-level directory name.
+     * Use a literal like `@skaile` if the entire repo maps to one publisher.
+     */
+    publisher_default: z.ZodEffects<z.ZodString, string, string>;
+    /** Default git ref for version resolution. */
+    default_ref: z.ZodDefault<z.ZodString>;
+    /** Per-path publisher overrides. Evaluated in order; first match wins. */
+    publisher_overrides: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        /** Relative path within the repo (trailing slash convention). */
+        path: z.ZodString;
+        /** Publisher namespace override for assets under this path. */
+        publisher: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        publisher: string;
+    }, {
+        path: string;
+        publisher: string;
+    }>, "many">>;
+    /** Optional sync configuration for the catalog backend. */
+    sync: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        /** How the catalog backend learns about repo changes. */
+        trigger: z.ZodDefault<z.ZodEnum<["webhook", "poll"]>>;
+        /** Seconds between polls. Required when trigger=poll. */
+        poll_interval: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        trigger: "poll" | "webhook";
+        poll_interval?: number | undefined;
+    }, {
+        trigger?: "poll" | "webhook" | undefined;
+        poll_interval?: number | undefined;
+    }>, {
+        trigger: "poll" | "webhook";
+        poll_interval?: number | undefined;
+    }, {
+        trigger?: "poll" | "webhook" | undefined;
+        poll_interval?: number | undefined;
+    }>>;
+    /**
+     * Optional author-shipped asset inventory. When present, discovery uses
+     * these entries verbatim and skips glob walk + AI enrichment.
+     *
+     * Requires `version: 2`.
+     */
+    assets: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        /** Relative path within the repo (directory or file). */
+        path: z.ZodString;
+        /** Asset kind — validated against `IAssetKindRegistry` at discovery time. */
+        kind: z.ZodString;
+        /** Publisher namespace. Required per entry; overrides publisher_default / _overrides. */
+        publisher: z.ZodString;
+        /** Asset name. Identity tuple is `<publisher>/<name>@<version>`. */
+        name: z.ZodString;
+        /** Semver version string. */
+        version: z.ZodString;
+        /**
+         * Hex-encoded SHA256 hash of the deterministic tarball contents.
+         * Optional on write, REQUIRED on Catalog publish (Phase 4).
+         */
+        sha256: z.ZodOptional<z.ZodString>;
+        /** Curated file filter (paths relative to `path:`). At least one entry. */
+        files: z.ZodArray<z.ZodString, "many">;
+        /** Author-declared requires-graph entries. */
+        requires: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        /** Optional passthrough to `AssetDefinition.manifest`. */
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        kind: string;
+        version: string;
+        requires: string[];
+        path: string;
+        publisher: string;
+        files: string[];
+        metadata?: Record<string, unknown> | undefined;
+        sha256?: string | undefined;
+    }, {
+        name: string;
+        kind: string;
+        version: string;
+        path: string;
+        publisher: string;
+        files: string[];
+        requires?: string[] | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        sha256?: string | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    version: 1 | 2;
+    publisher_default: string;
+    default_ref: string;
+    publisher_overrides: {
+        path: string;
+        publisher: string;
+    }[];
+    sync?: {
+        trigger: "poll" | "webhook";
+        poll_interval?: number | undefined;
+    } | undefined;
+    assets?: {
+        name: string;
+        kind: string;
+        version: string;
+        requires: string[];
+        path: string;
+        publisher: string;
+        files: string[];
+        metadata?: Record<string, unknown> | undefined;
+        sha256?: string | undefined;
+    }[] | undefined;
+}, {
+    version: 1 | 2;
+    publisher_default: string;
+    sync?: {
+        trigger?: "poll" | "webhook" | undefined;
+        poll_interval?: number | undefined;
+    } | undefined;
+    default_ref?: string | undefined;
+    publisher_overrides?: {
+        path: string;
+        publisher: string;
+    }[] | undefined;
+    assets?: {
+        name: string;
+        kind: string;
+        version: string;
+        path: string;
+        publisher: string;
+        files: string[];
+        requires?: string[] | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        sha256?: string | undefined;
+    }[] | undefined;
+}>, {
+    version: 1 | 2;
+    publisher_default: string;
+    default_ref: string;
+    publisher_overrides: {
+        path: string;
+        publisher: string;
+    }[];
+    sync?: {
+        trigger: "poll" | "webhook";
+        poll_interval?: number | undefined;
+    } | undefined;
+    assets?: {
+        name: string;
+        kind: string;
+        version: string;
+        requires: string[];
+        path: string;
+        publisher: string;
+        files: string[];
+        metadata?: Record<string, unknown> | undefined;
+        sha256?: string | undefined;
+    }[] | undefined;
+}, {
+    version: 1 | 2;
+    publisher_default: string;
+    sync?: {
+        trigger?: "poll" | "webhook" | undefined;
+        poll_interval?: number | undefined;
+    } | undefined;
+    default_ref?: string | undefined;
+    publisher_overrides?: {
+        path: string;
+        publisher: string;
+    }[] | undefined;
+    assets?: {
+        name: string;
+        kind: string;
+        version: string;
+        path: string;
+        publisher: string;
+        files: string[];
+        requires?: string[] | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        sha256?: string | undefined;
+    }[] | undefined;
+}>;
+/**
+ * Validated configuration derived from `.skaile-source.yaml`.
+ *
+ * @docLink packages/discovery/concepts#source-config
+ */
+export type SourceConfig = z.infer<typeof SourceConfigSchema>;
+/**
+ * A `SourceConfig` known to be `version: 2` with the `assets:` block populated.
+ * Returned from {@link isManifestMode} after a successful narrow.
+ *
+ * @docLink packages/discovery/concepts#source-config-v2
+ */
+export type SourceConfigV2 = SourceConfig & {
+    version: 2;
+    assets: AssetEntry[];
+};
+/**
+ * A single entry in the author-shipped inventory.
+ *
+ * @docLink packages/discovery/concepts#author-manifest-asset-entry
+ */
+export type AssetEntry = z.infer<typeof AssetEntrySchema>;
+/**
+ * A single per-path publisher namespace override entry.
+ *
+ * The first matching override (by path prefix) wins during publisher resolution.
+ *
+ * @docLink packages/discovery/concepts#publisher-override
+ */
+export type PublisherOverride = z.infer<typeof PublisherOverrideSchema>;
+/**
+ * Sync configuration that controls how the catalog backend learns about repo changes.
+ *
+ * @docLink packages/discovery/concepts#sync-config
+ */
+export type SyncConfig = z.infer<typeof SyncConfigSchema>;
+/**
+ * Successful result from {@link validateSourceConfig} or {@link loadSourceConfig}.
+ *
+ * `warnings` lists non-fatal anomalies (e.g. `assets:` present alongside
+ * `publisher_overrides:` — the latter is ignored in manifest mode).
+ *
+ * @docLink packages/discovery/concepts#validation-success
+ */
+export interface ValidationSuccess {
+    ok: true;
+    config: SourceConfig;
+    warnings?: string[];
+}
+/**
+ * Failed result from {@link validateSourceConfig} or {@link loadSourceConfig},
+ * carrying a list of per-field validation errors.
+ *
+ * @docLink packages/discovery/concepts#validation-failure
+ */
+export interface ValidationFailure {
+    ok: false;
+    errors: Array<{
+        path: string;
+        message: string;
+    }>;
+}
+/**
+ * Discriminated union returned by {@link validateSourceConfig} and {@link loadSourceConfig}.
+ *
+ * Use `result.ok` to narrow to {@link ValidationSuccess} or {@link ValidationFailure}.
+ *
+ * @docLink packages/discovery/concepts#validation-result
+ */
+export type ValidationResult = ValidationSuccess | ValidationFailure;
+/**
+ * Parse raw YAML text into a plain object.
+ *
+ * Throws if the YAML is syntactically invalid. Pass the result to
+ * {@link validateSourceConfig} to apply schema validation.
+ *
+ * @param yamlText - Raw YAML content of the `.skaile-source.yaml` file
+ * @returns The parsed object (unvalidated)
+ * @docLink packages/discovery/concepts#parse-source-config
+ */
+export declare function parseSourceConfig(yamlText: string): unknown;
+/**
+ * Validate a parsed object against the {@link SourceConfigSchema}.
+ *
+ * @param parsed - Plain object produced by {@link parseSourceConfig} or any other YAML parser
+ * @returns A {@link ValidationSuccess} with the typed config, or a {@link ValidationFailure} with field errors
+ * @docLink packages/discovery/concepts#validate-source-config
+ */
+export declare function validateSourceConfig(parsed: unknown): ValidationResult;
+/**
+ * Convenience wrapper that parses YAML and validates in a single call.
+ *
+ * Equivalent to calling {@link parseSourceConfig} followed by {@link validateSourceConfig}.
+ *
+ * @param yamlText - Raw YAML content of the `.skaile-source.yaml` file
+ * @returns A {@link ValidationResult} (success or failure)
+ * @docLink packages/discovery/concepts#load-source-config
+ */
+export declare function loadSourceConfig(yamlText: string): ValidationResult;
+/**
+ * Narrow a {@link SourceConfig} to {@link SourceConfigV2} when it carries an
+ * author-shipped inventory.
+ *
+ * @param config - Validated source config
+ * @returns `true` when `version === 2` and `assets:` is present (and non-empty
+ *   array — empty arrays still trigger manifest mode and yield an empty
+ *   discovery result, which matches an empty repo).
+ * @docLink packages/discovery/concepts#is-manifest-mode
+ */
+export declare function isManifestMode(config: SourceConfig): config is SourceConfigV2;
+/**
+ * A {@link SourceConfig} produced by merging a base in-repo config with a
+ * local sidecar overlay. Always shaped like a regular `SourceConfig` —
+ * downstream consumers treat it identically.
+ *
+ * @docLink packages/discovery/concepts#merged-source-config
+ */
+export type MergedSourceConfig = SourceConfig;
+/**
+ * Merge a base in-repo `.skaile-source.yaml` config with a local sidecar
+ * overlay.
+ *
+ * Merge rules (per PR-3 §D.3):
+ *
+ * | Field                 | Resolution                                          |
+ * |-----------------------|-----------------------------------------------------|
+ * | `version`             | sidecar wins (sidecar is always v2)                 |
+ * | `publisher_default`   | sidecar wins if set, else base                      |
+ * | `publisher_overrides` | sidecar wins if non-empty, else base                |
+ * | `default_ref`         | sidecar wins if set, else base                      |
+ * | `sync`                | sidecar wins if set, else base                      |
+ * | `assets:`             | sidecar fully **replaces** base (no partial merge)  |
+ *
+ * Pure function — no I/O. Callers responsible for loading both configs.
+ *
+ * @param base - The in-repo source config (or `undefined` if absent)
+ * @param overlay - The sidecar source config (or `undefined` for identity)
+ * @returns The merged config, or `undefined` if both inputs are missing
+ * @docLink packages/discovery/concepts#merge-source-configs
+ */
+export declare function mergeSourceConfigs(base: SourceConfig | undefined, overlay: SourceConfig | undefined): MergedSourceConfig | undefined;
+/**
+ * Load and merge a base `.skaile-source.yaml` (at `<rootPath>/.skaile-source.yaml`)
+ * with an optional sidecar manifest at `<sidecarPath>/.skaile-source.yaml`.
+ *
+ * Either side may be absent. The result is wrapped in a {@link ValidationResult}
+ * so the discovery dispatcher can surface per-side parse errors uniformly.
+ *
+ * Field merge follows {@link mergeSourceConfigs}. The sidecar's
+ * `.skaile-source.yaml` is the only sidecar artifact this helper touches; the
+ * README + lock file under `<sidecarPath>` are consumer concerns.
+ *
+ * @param rootPath - Absolute path to the upstream repo root
+ * @param sidecarPath - Optional absolute path to the sidecar directory
+ *   (e.g. `~/.skaile/sources/<slug>/`)
+ * @returns A {@link ValidationResult} carrying the merged config. Returns
+ *   `{ ok: true, config: <merged> }` when at least one side parses; returns
+ *   `{ ok: false, errors: [...] }` only when a present file is structurally
+ *   invalid. Missing files on both sides yield a typed success with an
+ *   empty/default v2 config.
+ * @docLink packages/discovery/concepts#load-merged-source-config
+ */
+export declare function loadMergedSourceConfig(rootPath: string, sidecarPath?: string): ValidationResult;
+export {};
+//# sourceMappingURL=source-config.d.ts.map

package/dist/discovery/src/source-config.d.ts.map

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

package/dist/discovery/src/tree-entries.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Asset discovery over a virtual file tree (no real filesystem access).
+ *
+ * `discoverAssetsInTreeEntries()` is the server-side counterpart to
+ * `discoverAssetsInTree()` — same kind resolution, manifest parsing,
+ * publisher/name derivation, requires extraction, and SHA256 hashing — but
+ * driven by a flat list of {@link TreeEntry} (the shape returned by GitHub's
+ * Git Trees API: `GET /repos/:owner/:repo/git/trees/:tree_sha?recursive=1`).
+ *
+ * Used by the public Catalog backend (`@postxl/skaile-store-api`) so that
+ * Source ingestion never touches the local filesystem and never runs
+ * `git clone` (per spec § Phase 2: "no client-side cloning, ever").
+ *
+ * The function is async because manifest parsing and content hashing both
+ * require fetching blob bytes from the remote host (e.g. GitHub Blobs API).
+ *
+ * Per-kind file-filter logic is mirrored from `builtin-providers.ts` — the
+ * provider implementations there read `fs.readdirSync` / `fs.existsSync`,
+ * which doesn't translate to a virtual tree, so this module reimplements
+ * the same patterns against the supplied {@link TreeEntry} list. The
+ * resulting `fileFilter.files` set is identical to what
+ * `discoverAssetsInTree()` would produce for the same content laid out on
+ * disk.
+ *
+ * @module
+ */
+import type { IAssetKindRegistry } from "@skaile/workspaces/plugins";
+import type { SourceConfig } from "./source-config.js";
+import type { DiscoveryResult } from "./discover.js";
+/**
+ * A single entry in a virtual file tree (the shape returned by GitHub's
+ * Git Trees API).
+ *
+ * Only the four fields used by discovery are required; consumers may pass
+ * Octokit's full `GitTreeResponse[]` directly because TypeScript structural
+ * typing accepts the superset.
+ *
+ * @docLink packages/discovery/concepts#tree-entry
+ */
+export interface TreeEntry {
+    /** Repo-relative path (forward slashes), e.g. `domain/skills/review/SKILL.md`. */
+    path: string;
+    /** `"blob"` for files, `"tree"` for directories, `"commit"` for submodules. */
+    type: "blob" | "tree" | "commit" | string;
+    /** Git object SHA used to fetch blob contents via {@link DiscoverAssetsInTreeEntriesOptions.fetchBlob}. */
+    sha: string;
+    /** Optional file mode (`"100644"` etc.). When `"100755"`, indicates an executable. */
+    mode?: string;
+    /** Optional blob size in bytes. */
+    size?: number;
+}
+/**
+ * Options for {@link discoverAssetsInTreeEntries}.
+ *
+ * @docLink packages/discovery/concepts#discover-assets-in-tree-entries-options
+ */
+export interface DiscoverAssetsInTreeEntriesOptions {
+    /**
+     * Async resolver that returns the bytes of a blob given its Git SHA.
+     *
+     * The store backend wires this to Octokit's
+     * `repos.getContent` / `git.getBlob` API; tests can pass a synchronous
+     * map-backed implementation. Returning `null` is treated identically to a
+     * fetch error (the file is skipped during hashing).
+     */
+    fetchBlob: (sha: string) => Promise<Buffer | Uint8Array | string | null>;
+    /** Optional `.skaile-source.yaml` config (parsed with {@link parseSourceConfig}). */
+    sourceConfig?: SourceConfig;
+    /**
+     * Optional sidecar overlay config (loaded out-of-band from
+     * `~/.skaile/sources/<slug>/.skaile-source.yaml`). When provided, the
+     * `sourceConfig` resolved from the tree (or passed explicitly) is merged
+     * with this overlay via {@link mergeSourceConfigs} before dispatch.
+     *
+     * @docLink packages/discovery/concepts#sidecar-overlay
+     */
+    sidecarSourceConfig?: SourceConfig;
+    /** Optional kind registry. Defaults to {@link createDefaultRegistry}. */
+    registry?: IAssetKindRegistry;
+}
+/**
+ * Discover assets in a virtual tree (Octokit `TreeEntry[]`).
+ *
+ * Mirrors {@link discoverAssetsInTree} but operates on a remote tree
+ * snapshot — no `node:fs` access. Manifest content and per-asset file
+ * bytes are fetched on demand via `options.fetchBlob`.
+ *
+ * @param entries - Flat list of tree entries (paths + blob SHAs). Tree
+ *   entries with `type: "tree"` are ignored (directories are reconstructed
+ *   from blob paths).
+ * @param options - Blob fetcher + optional source config and registry.
+ * @returns A {@link DiscoveryResult} identical in shape to
+ *   {@link discoverAssetsInTree}'s output, including `assets`, `graph`,
+ *   and `errors`.
+ * @docLink packages/discovery/concepts#discover-assets-in-tree-entries
+ */
+export declare function discoverAssetsInTreeEntries(entries: TreeEntry[], options: DiscoverAssetsInTreeEntriesOptions): Promise<DiscoveryResult>;
+//# sourceMappingURL=tree-entries.d.ts.map

package/dist/discovery/src/tree-entries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-entries.d.ts","sourceRoot":"","sources":["../../../discovery/src/tree-entries.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAMH,OAAO,KAAK,EAAE,kBAAkB,EAAuB,MAAM,4BAA4B,CAAC;AAC1F,OAAO,KAAK,EAAc,YAAY,EAAkB,MAAM,oBAAoB,CAAC;AAInF,OAAO,KAAK,EAAmB,eAAe,EAAE,MAAM,eAAe,CAAC;AAMtE;;;;;;;;;GASG;AACH,MAAM,WAAW,SAAS;IACxB,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC1C,2GAA2G;IAC3G,GAAG,EAAE,MAAM,CAAC;IACZ,sFAAsF;IACtF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,WAAW,kCAAkC;IACjD;;;;;;;OAOG;IACH,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,UAAU,GAAG,MAAM,GAAG,IAAI,CAAC,CAAC;IAEzE,qFAAqF;IACrF,YAAY,CAAC,EAAE,YAAY,CAAC;IAE5B;;;;;;;OAOG;IACH,mBAAmB,CAAC,EAAE,YAAY,CAAC;IAEnC,yEAAyE;IACzE,QAAQ,CAAC,EAAE,kBAAkB,CAAC;CAC/B;AAMD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,SAAS,EAAE,EACpB,OAAO,EAAE,kCAAkC,GAC1C,OAAO,CAAC,eAAe,CAAC,CAkJ1B"}

package/dist/flows-ZULSVHX5.js

@@ -0,0 +1,7 @@
+export { flowFindFlowForSession, flowGetSession, flowList, flowListSessions, flowShow } from './chunk-6UQ66R46.js';
+import './chunk-XCBG2KDC.js';
+import './chunk-HK5FRWG6.js';
+import './chunk-X5YPJV4N.js';
+import './chunk-NSBPE2FW.js';
+//# sourceMappingURL=flows-ZULSVHX5.js.map
+//# sourceMappingURL=flows-ZULSVHX5.js.map

package/dist/flows-ZULSVHX5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"flows-ZULSVHX5.js"}

package/dist/helpers-I3SREIC3.js

@@ -0,0 +1,4 @@
+export { S, colorRef, formatRelativeTime, kindColor, kindColorPad, logErr, logInfo, logOk, logWarn } from './chunk-4NDWKA64.js';
+import './chunk-NSBPE2FW.js';
+//# sourceMappingURL=helpers-I3SREIC3.js.map
+//# sourceMappingURL=helpers-I3SREIC3.js.map

package/dist/helpers-I3SREIC3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"helpers-I3SREIC3.js"}

package/dist/library/index.js

@@ -0,0 +1,9 @@
+export { CatalogCache, CatalogConfigSchema, CatalogHttpError, DuplicateLibraryNameError, DuplicateSubscriptionError, GitSyncDriver, InstanceHasConsumersError, InstanceNotFoundError, InterpolationError, KNOWN_ASSET_KINDS, KnowledgeManifestSchema, LIBRARY_BACKENDS, LIBRARY_OWNERSHIPS, LIBRARY_STRUCTURES, LOCAL_CATALOG_URL, LibraryConfigSchema, LibraryError, LibraryInstanceRefSchema, LibrarySectionSchema, LibrarySyncError, LocalCatalogSource, LocalLibrary, LocalSyncDriver, LockFileSchema, LockSubscriptionSchema, OfflineError, OperationNotPermittedError, PIN_POLICIES, PinPolicySchema, PresetAppliedSchema, PresetExpandedSchema, RemoteCatalogSource, RequiresEdgeSchema, RestCatalogSource, SidecarGit, SkaileConfigSchema, SourceNotFoundError, StoreSyncDriver, SubscriptionNotFoundError, TarballHashMismatchError, UserLibraryManager, UserLibraryNotFoundError, WorkspaceConfigV2Schema, applyNonStructuralUpgrade, applyPreset, applyPresetFromData, classifyRef, createEmptyLockFile, deriveSlug, detectChanges, detectNestedPresetRefs, detectWorkspaceVersion, evaluateUpgrade, extractLibraryInstanceId, extractReferencedKeys, filterKey, getConfigDefaults, getDefaultValue, getSidecarRoot, hasInterpolationTokens, interpolate, isLocalCatalogUrl, isSecretPlaceholder, knowledgeKindProvider, listSidecarSlugsOnDisk, loadLockFile, loadWorkspaceV2, migrateWorkspaceConfig, parsePreset, parsePresetYaml, parseWorkspaceV2, projectConfigPath, queryInstancePickerChoices, resolveAllItems, resolveConfig, resolveItem, resolveLibraryDir, resolvePin, resolveSidecarPaths, saveConfig, saveLockFile, saveWorkspaceV2, sha256Hex, storeSecrets, trpcGetUrl, userConfigPath, validateAllPlaceholders, validateKnowledge, validateNestingDepth, validatePlaceholder, writeManifestIfMissing } from '../chunk-DOMCYP7D.js';
+import '../chunk-46T37EBP.js';
+import '../chunk-OKRUTSG7.js';
+import '../chunk-BVHFSUFM.js';
+import '../chunk-JLPC4YWT.js';
+import '../chunk-Z3RER6YZ.js';
+import '../chunk-NSBPE2FW.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/library/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}