@skaile/workspaces 0.8.5

package/dist/library/src/workspace-config.d.ts

@@ -0,0 +1,451 @@
+/**
+ * skaile.yaml v2 extensions + skaile.lock.yaml reader/writer.
+ *
+ * The v2 workspace format extends the existing v1 skaile.yaml with:
+ *   - `version: 2` marker
+ *   - `library:` section (default pin policy, instance refs with aliases)
+ *   - `presets_applied:` section (applied Preset references with timestamps)
+ *
+ * The lock file (`skaile.lock.yaml`) is new in v2 and records resolved
+ * subscription state (pinned versions, SHA256 hashes, requires graph).
+ *
+ * @docLink packages/library/api-reference#workspace-config
+ */
+import * as z from "zod";
+/**
+ * Zod schema for the `PinPolicy` type.
+ *
+ * @docLink packages/library/api-reference#workspace-config
+ */
+export declare const PinPolicySchema: z.ZodEnum<["exact", "minor-track", "latest"]>;
+/**
+ * Zod schema for a single instance reference entry within `library.instances`.
+ *
+ * Each entry holds the instance UUID and an optional human-readable alias.
+ *
+ * @docLink packages/library/api-reference#workspace-config
+ */
+export declare const LibraryInstanceRefSchema: z.ZodObject<{
+    id: z.ZodString;
+    alias: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    alias?: string | undefined;
+}, {
+    id: string;
+    alias?: string | undefined;
+}>;
+/**
+ * Zod schema for the `library:` section of skaile.yaml v2.
+ *
+ * Defaults: `pin_policy = "minor-track"`, `instances = []`.
+ *
+ * @docLink packages/library/api-reference#workspace-config
+ */
+export declare const LibrarySectionSchema: z.ZodObject<{
+    pin_policy: z.ZodDefault<z.ZodEnum<["exact", "minor-track", "latest"]>>;
+    instances: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        alias: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        alias?: string | undefined;
+    }, {
+        id: string;
+        alias?: string | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    pin_policy: "exact" | "minor-track" | "latest";
+    instances: {
+        id: string;
+        alias?: string | undefined;
+    }[];
+}, {
+    pin_policy?: "exact" | "minor-track" | "latest" | undefined;
+    instances?: {
+        id: string;
+        alias?: string | undefined;
+    }[] | undefined;
+}>;
+/**
+ * Zod schema for a single item entry inside a `presets_applied` record.
+ *
+ * @docLink packages/library/api-reference#workspace-config
+ */
+export declare const PresetAppliedItemSchema: z.ZodObject<{
+    instance_id: z.ZodString;
+    def_ref: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    def_ref: string;
+    instance_id: string;
+}, {
+    def_ref: string;
+    instance_id: string;
+}>;
+/**
+ * Zod schema for a single applied-preset entry in the `presets_applied:` section.
+ *
+ * @docLink packages/library/api-reference#workspace-config
+ */
+export declare const PresetAppliedSchema: z.ZodObject<{
+    ref: z.ZodString;
+    applied_at: z.ZodString;
+    items: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        instance_id: z.ZodString;
+        def_ref: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        def_ref: string;
+        instance_id: string;
+    }, {
+        def_ref: string;
+        instance_id: string;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    ref: string;
+    items: {
+        def_ref: string;
+        instance_id: string;
+    }[];
+    applied_at: string;
+}, {
+    ref: string;
+    applied_at: string;
+    items?: {
+        def_ref: string;
+        instance_id: string;
+    }[] | undefined;
+}>;
+/**
+ * Zod schema for the full skaile.yaml v2 workspace config document.
+ *
+ * @docLink packages/library/api-reference#workspace-config
+ */
+export declare const WorkspaceConfigV2Schema: z.ZodObject<{
+    version: z.ZodLiteral<2>;
+    library: z.ZodOptional<z.ZodObject<{
+        pin_policy: z.ZodDefault<z.ZodEnum<["exact", "minor-track", "latest"]>>;
+        instances: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            alias: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            alias?: string | undefined;
+        }, {
+            id: string;
+            alias?: string | undefined;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        pin_policy: "exact" | "minor-track" | "latest";
+        instances: {
+            id: string;
+            alias?: string | undefined;
+        }[];
+    }, {
+        pin_policy?: "exact" | "minor-track" | "latest" | undefined;
+        instances?: {
+            id: string;
+            alias?: string | undefined;
+        }[] | undefined;
+    }>>;
+    presets_applied: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        ref: z.ZodString;
+        applied_at: z.ZodString;
+        items: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            instance_id: z.ZodString;
+            def_ref: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            def_ref: string;
+            instance_id: string;
+        }, {
+            def_ref: string;
+            instance_id: string;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        ref: string;
+        items: {
+            def_ref: string;
+            instance_id: string;
+        }[];
+        applied_at: string;
+    }, {
+        ref: string;
+        applied_at: string;
+        items?: {
+            def_ref: string;
+            instance_id: string;
+        }[] | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    version: 2;
+    library?: {
+        pin_policy: "exact" | "minor-track" | "latest";
+        instances: {
+            id: string;
+            alias?: string | undefined;
+        }[];
+    } | undefined;
+    presets_applied?: {
+        ref: string;
+        items: {
+            def_ref: string;
+            instance_id: string;
+        }[];
+        applied_at: string;
+    }[] | undefined;
+}, {
+    version: 2;
+    library?: {
+        pin_policy?: "exact" | "minor-track" | "latest" | undefined;
+        instances?: {
+            id: string;
+            alias?: string | undefined;
+        }[] | undefined;
+    } | undefined;
+    presets_applied?: {
+        ref: string;
+        applied_at: string;
+        items?: {
+            def_ref: string;
+            instance_id: string;
+        }[] | undefined;
+    }[] | undefined;
+}>;
+/**
+ * Zod schema for a single resolved-subscription entry in skaile.lock.yaml.
+ *
+ * @docLink packages/library/api-reference#lock-file
+ */
+export declare const LockSubscriptionSchema: z.ZodObject<{
+    subscription_id: z.ZodString;
+    instance_id: z.ZodString;
+    def_ref: z.ZodString;
+    resolved_version: z.ZodString;
+    resolved_sha256: z.ZodOptional<z.ZodString>;
+    pin_policy: z.ZodEnum<["exact", "minor-track", "latest"]>;
+}, "strip", z.ZodTypeAny, {
+    pin_policy: "exact" | "minor-track" | "latest";
+    def_ref: string;
+    instance_id: string;
+    subscription_id: string;
+    resolved_version: string;
+    resolved_sha256?: string | undefined;
+}, {
+    pin_policy: "exact" | "minor-track" | "latest";
+    def_ref: string;
+    instance_id: string;
+    subscription_id: string;
+    resolved_version: string;
+    resolved_sha256?: string | undefined;
+}>;
+/**
+ * Zod schema for a single directed edge in the asset requires graph.
+ *
+ * @docLink packages/library/api-reference#lock-file
+ */
+export declare const RequiresEdgeSchema: z.ZodObject<{
+    from: z.ZodString;
+    to: z.ZodString;
+    kind: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    to: string;
+    from: string;
+    kind?: string | undefined;
+}, {
+    to: string;
+    from: string;
+    kind?: string | undefined;
+}>;
+/**
+ * Zod schema for a single expanded-preset entry tracking which instance IDs
+ * a preset application produced.
+ *
+ * @docLink packages/library/api-reference#lock-file
+ */
+export declare const PresetExpandedSchema: z.ZodObject<{
+    preset_ref: z.ZodString;
+    instance_ids: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    preset_ref: string;
+    instance_ids: string[];
+}, {
+    preset_ref: string;
+    instance_ids: string[];
+}>;
+/**
+ * Zod schema for the complete skaile.lock.yaml document.
+ *
+ * @docLink packages/library/api-reference#lock-file
+ */
+export declare const LockFileSchema: z.ZodObject<{
+    version: z.ZodLiteral<2>;
+    generated_at: z.ZodString;
+    subscriptions: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        subscription_id: z.ZodString;
+        instance_id: z.ZodString;
+        def_ref: z.ZodString;
+        resolved_version: z.ZodString;
+        resolved_sha256: z.ZodOptional<z.ZodString>;
+        pin_policy: z.ZodEnum<["exact", "minor-track", "latest"]>;
+    }, "strip", z.ZodTypeAny, {
+        pin_policy: "exact" | "minor-track" | "latest";
+        def_ref: string;
+        instance_id: string;
+        subscription_id: string;
+        resolved_version: string;
+        resolved_sha256?: string | undefined;
+    }, {
+        pin_policy: "exact" | "minor-track" | "latest";
+        def_ref: string;
+        instance_id: string;
+        subscription_id: string;
+        resolved_version: string;
+        resolved_sha256?: string | undefined;
+    }>, "many">>;
+    requires_graph: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        from: z.ZodString;
+        to: z.ZodString;
+        kind: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        to: string;
+        from: string;
+        kind?: string | undefined;
+    }, {
+        to: string;
+        from: string;
+        kind?: string | undefined;
+    }>, "many">>;
+    presets_expanded: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        preset_ref: z.ZodString;
+        instance_ids: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        preset_ref: string;
+        instance_ids: string[];
+    }, {
+        preset_ref: string;
+        instance_ids: string[];
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    version: 2;
+    subscriptions: {
+        pin_policy: "exact" | "minor-track" | "latest";
+        def_ref: string;
+        instance_id: string;
+        subscription_id: string;
+        resolved_version: string;
+        resolved_sha256?: string | undefined;
+    }[];
+    generated_at: string;
+    requires_graph: {
+        to: string;
+        from: string;
+        kind?: string | undefined;
+    }[];
+    presets_expanded: {
+        preset_ref: string;
+        instance_ids: string[];
+    }[];
+}, {
+    version: 2;
+    generated_at: string;
+    subscriptions?: {
+        pin_policy: "exact" | "minor-track" | "latest";
+        def_ref: string;
+        instance_id: string;
+        subscription_id: string;
+        resolved_version: string;
+        resolved_sha256?: string | undefined;
+    }[] | undefined;
+    requires_graph?: {
+        to: string;
+        from: string;
+        kind?: string | undefined;
+    }[] | undefined;
+    presets_expanded?: {
+        preset_ref: string;
+        instance_ids: string[];
+    }[] | undefined;
+}>;
+/**
+ * TypeScript type for the `library:` section of skaile.yaml v2.
+ *
+ * @docLink packages/library/api-reference#workspace-config
+ */
+export type LibrarySection = z.infer<typeof LibrarySectionSchema>;
+/**
+ * A single instance UUID reference with optional alias in `library.instances`.
+ *
+ * @docLink packages/library/api-reference#workspace-config
+ */
+export type LibraryInstanceRef = z.infer<typeof LibraryInstanceRefSchema>;
+/**
+ * Record of a previously applied preset in the `presets_applied:` section.
+ *
+ * @docLink packages/library/api-reference#workspace-config
+ */
+export type PresetApplied = z.infer<typeof PresetAppliedSchema>;
+/**
+ * The parsed v2 workspace config (skaile.yaml `version: 2` document).
+ *
+ * @docLink packages/library/api-reference#workspace-config
+ */
+export type WorkspaceConfigV2 = z.infer<typeof WorkspaceConfigV2Schema>;
+/**
+ * A single resolved-subscription record from skaile.lock.yaml.
+ *
+ * @docLink packages/library/api-reference#lock-file
+ */
+export type LockSubscription = z.infer<typeof LockSubscriptionSchema>;
+/**
+ * The parsed skaile.lock.yaml document.
+ *
+ * @docLink packages/library/api-reference#lock-file
+ */
+export type LockFile = z.infer<typeof LockFileSchema>;
+/**
+ * Extract the v2-specific sections from a parsed skaile.yaml object.
+ * Returns null if the object is v1 (no `version: 2` marker).
+ *
+ * @docLink packages/library/api-reference#workspace-config
+ */
+export declare function parseWorkspaceV2(raw: Record<string, unknown>): WorkspaceConfigV2 | null;
+/**
+ * Read the v2 sections from a skaile.yaml file on disk.
+ * Returns null if the file doesn't exist or is v1.
+ *
+ * @docLink packages/library/api-reference#workspace-config
+ */
+export declare function loadWorkspaceV2(dir: string, filename?: string): WorkspaceConfigV2 | null;
+/**
+ * Write v2 sections into an existing skaile.yaml, preserving other content.
+ * Creates a minimal v2 file if none exists.
+ *
+ * @docLink packages/library/api-reference#workspace-config
+ */
+export declare function saveWorkspaceV2(dir: string, v2: Partial<Omit<WorkspaceConfigV2, "version">>, filename?: string): void;
+/**
+ * Load and validate a skaile.lock.yaml file.
+ * Returns null if the file doesn't exist.
+ *
+ * @docLink packages/library/api-reference#lock-file
+ */
+export declare function loadLockFile(dir: string): LockFile | null;
+/**
+ * Write a skaile.lock.yaml file. Overwrites any existing lock file.
+ *
+ * @docLink packages/library/api-reference#lock-file
+ */
+export declare function saveLockFile(dir: string, lock: LockFile): void;
+/**
+ * Create an empty lock file structure.
+ *
+ * @docLink packages/library/api-reference#lock-file
+ */
+export declare function createEmptyLockFile(): LockFile;
+/**
+ * Detect the workspace config version from a skaile.yaml file.
+ * Returns 1 for v1 (no version field), 2 for v2, null if no file.
+ *
+ * @docLink packages/library/api-reference#workspace-config
+ */
+export declare function detectWorkspaceVersion(dir: string, filename?: string): 1 | 2 | null;
+//# sourceMappingURL=workspace-config.d.ts.map

package/dist/library/src/workspace-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-config.d.ts","sourceRoot":"","sources":["../../../library/src/workspace-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAUzB;;;;GAIG;AACH,eAAO,MAAM,eAAe,+CAAuB,CAAC;AAEpD;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;EAGnC,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;EAG/B,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;EAGlC,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAI9B,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAIlC,CAAC;AAMH;;;;GAIG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;EAOjC,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;EAI7B,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;EAG/B,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMzB,CAAC;AAMH;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAMtD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,iBAAiB,GAAG,IAAI,CAGvF;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,SAAgB,GAAG,iBAAiB,GAAG,IAAI,CAO/F;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,EAAE,EAAE,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,SAAS,CAAC,CAAC,EAC/C,QAAQ,SAAgB,GACvB,IAAI,CAeN;AAQD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAMzD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI,CAU9D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,QAAQ,CAQ9C;AAMD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,SAAgB,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAO1F"}

package/dist/mounts-PQLFYD2C.js

@@ -0,0 +1,5 @@
+export { mountList, mountRead, mountStatus, mountSync } from './chunk-QT2KQHDT.js';
+import './chunk-X5YPJV4N.js';
+import './chunk-NSBPE2FW.js';
+//# sourceMappingURL=mounts-PQLFYD2C.js.map
+//# sourceMappingURL=mounts-PQLFYD2C.js.map

package/dist/mounts-PQLFYD2C.js.map

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

package/dist/open-library-N5T5HRTS.js

@@ -0,0 +1,12 @@
+export { openCatalogSource, openLibrary, openUserLibraryManager, resolveCatalogSource } from './chunk-77CUYYO3.js';
+import './chunk-4NDWKA64.js';
+import './chunk-DOMCYP7D.js';
+import './chunk-46T37EBP.js';
+import './chunk-OKRUTSG7.js';
+import './chunk-ZUQIXLRJ.js';
+import './chunk-BVHFSUFM.js';
+import './chunk-JLPC4YWT.js';
+import './chunk-Z3RER6YZ.js';
+import './chunk-NSBPE2FW.js';
+//# sourceMappingURL=open-library-N5T5HRTS.js.map
+//# sourceMappingURL=open-library-N5T5HRTS.js.map

package/dist/open-library-N5T5HRTS.js.map

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

package/dist/paths-FKKGS6BA.js

@@ -0,0 +1,4 @@
+export { AI_RESOURCES, MONOREPO_ROOT } from './chunk-2M3XTMOL.js';
+import './chunk-NSBPE2FW.js';
+//# sourceMappingURL=paths-FKKGS6BA.js.map
+//# sourceMappingURL=paths-FKKGS6BA.js.map

package/dist/paths-FKKGS6BA.js.map

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

package/dist/plugins/index.js

@@ -0,0 +1,4 @@
+export { AssetKindConflictError, AssetKindPathAmbiguityError, AssetKindPatternConflictError, AssetKindRegistryFrozenError, ProviderUnavailableError, SecretAccessDeniedError, SecretExpiredError, SecretNotFoundError, SecretsError, VERSION } from '../chunk-OKRUTSG7.js';
+import '../chunk-NSBPE2FW.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/plugins/index.js.map

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

package/dist/plugins/src/asset-kind-provider.d.ts

@@ -0,0 +1,99 @@
+/**
+ * IAssetKindProvider — pluggable asset kind extension interface.
+ *
+ * Each asset kind (skill, flow, knowledge, etc.) is backed by an
+ * IAssetKindProvider implementation. Core kinds (skill, agent, connector,
+ * mount, mcp-server, contract, prompt, persona, ruleset) ship as built-in
+ * providers in @skaile/discovery. Extension kinds (flow, knowledge, future
+ * custom kinds) ship from their owning runtime packages and are explicitly
+ * registered by the CLI at bootstrap.
+ *
+ * Lives in workspaces/plugins alongside other pluggable interface
+ * contracts (ISecretsProvider, ICatalogSource, IKnowledgeBackend).
+ *
+ * Design decision A2: locked in Phase 1.7 planning.
+ */
+import type { ManifestValidationResult } from "@skaile/workspaces/types/manifests";
+export interface AssetKindFileFilter {
+    /** Root directory of the asset (usually the manifest's parent dir). */
+    assetRoot: string;
+    /** Relative paths (from assetRoot) to include in the tarball. */
+    files: string[];
+}
+export interface AssetKindRequiresEdge {
+    /** Asset ref of the requiring asset. */
+    from: string;
+    /** Asset ref of the required asset. */
+    to: string;
+    /** Manifest field that produced this edge. */
+    field: string;
+}
+/**
+ * Pluggable asset kind provider.
+ *
+ * Implementations:
+ *   - 9 core kinds: built-in providers in @skaile/discovery (skill, agent,
+ *     connector, mount, mcp-server, contract, prompt, persona, ruleset)
+ *   - flow: @skaile/workspaces/base-assets/connectors/flow/engine (extension kind)
+ *   - knowledge: @skaile/workspaces/library/knowledge (extension kind, Phase 4 runtime)
+ *   - Custom kinds: any third-party package (future)
+ */
+export interface IAssetKindProvider {
+    /** Unique kind identifier (e.g. "flow", "knowledge", "notebook"). */
+    readonly kind: string;
+    /** Human-readable display name (e.g. "Flow", "Knowledge Base"). */
+    readonly displayName: string;
+    /**
+     * Version of this provider implementation.
+     * Independent of asset version — tracks schema/logic evolution.
+     * Stored alongside cached assets as `kind_provider_version`.
+     * Mismatch between stored and current is informational WARN, not blocking.
+     */
+    readonly providerVersion: string;
+    /**
+     * Glob patterns that identify assets of this kind.
+     * Used for deterministic discovery (e.g. ["** / *.flow.yaml", "** / *.flow.json"]).
+     * Must not overlap with any other registered provider's patterns.
+     */
+    readonly discoveryPatterns: string[];
+    /**
+     * Test if a relative path (from source root) matches this kind.
+     * Called during discovery for path -> kind resolution.
+     * Must be consistent with discoveryPatterns but may use filename-based
+     * logic for efficiency (avoiding full glob matching).
+     */
+    matchesPath(relativePath: string): boolean;
+    /**
+     * Validate a parsed manifest against this kind's schema.
+     * Returns the validated data on success, or structured errors on failure.
+     */
+    validateManifest(data: unknown): ManifestValidationResult<unknown>;
+    /**
+     * Compute the default file filter for an asset of this kind.
+     * Returns the asset root directory and the list of files to include
+     * in the content-addressed tarball.
+     */
+    defaultFileFilter(manifestPath: string): AssetKindFileFilter;
+    /**
+     * Extract cross-asset dependency edges from a manifest.
+     * Optional — kinds with no cross-references can omit this.
+     *
+     * @param assetRef  - Canonical ref of the asset being analyzed
+     * @param manifest  - Parsed manifest data
+     * @returns Array of dependency edges
+     */
+    extractRequires?(assetRef: string, manifest: Record<string, unknown>): AssetKindRequiresEdge[];
+    /**
+     * Install hook — runs after the asset is cached in the Library.
+     * Optional — used for kinds that need post-install setup (e.g.
+     * downloading additional resources, compiling schemas).
+     */
+    install?(assetDef: Record<string, unknown>): Promise<void>;
+    /**
+     * Resolve hook — runs when the asset is loaded for runtime composition.
+     * Optional — used for kinds that need runtime transformation (e.g.
+     * flow schema normalization, knowledge indexing).
+     */
+    resolve?(assetDef: Record<string, unknown>): Promise<Record<string, unknown>>;
+}
+//# sourceMappingURL=asset-kind-provider.d.ts.map

package/dist/plugins/src/asset-kind-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-kind-provider.d.ts","sourceRoot":"","sources":["../../../plugins/src/asset-kind-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AAMnF,MAAM,WAAW,mBAAmB;IAClC,uEAAuE;IACvE,SAAS,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;CACf;AAMD;;;;;;;;;GASG;AACH,MAAM,WAAW,kBAAkB;IACjC,qEAAqE;IACrE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,mEAAmE;IACnE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B;;;;;OAKG;IACH,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAEjC;;;;OAIG;IACH,QAAQ,CAAC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAErC;;;;;OAKG;IACH,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC;IAE3C;;;OAGG;IACH,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAEnE;;;;OAIG;IACH,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,mBAAmB,CAAC;IAE7D;;;;;;;OAOG;IACH,eAAe,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,qBAAqB,EAAE,CAAC;IAE/F;;;;OAIG;IACH,OAAO,CAAC,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3D;;;;OAIG;IACH,OAAO,CAAC,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC/E"}