@skaile/workspaces 0.8.5

package/dist/library/src/library.d.ts

@@ -0,0 +1,344 @@
+/**
+ * ILibrary — single-interface contract for the asset Library layer.
+ *
+ * Two implementations:
+ *   - LocalLibrary  (SQLite at ~/.skaile/library/lib.db, Phase 1)
+ *   - PlatformLibrary (Postgres, Phase 3)
+ *
+ * @docLink packages/library/concepts#i-library
+ */
+/**
+ * All known asset kinds shipped with the framework (9 core + 2 initial
+ * extensions). Third-party providers can register any string as a kind at
+ * runtime via the AssetKindRegistry.
+ *
+ * @docLink packages/library/concepts#asset-kind
+ */
+export declare const KNOWN_ASSET_KINDS: readonly ["skill", "agent", "connector", "mount", "flow", "contract", "prompt", "mcp-server", "knowledge", "persona", "ruleset"];
+/** Known asset kind (for type narrowing where the old enum was used). */
+export type KnownAssetKind = (typeof KNOWN_ASSET_KINDS)[number];
+/**
+ * Asset kind — any string. Pluggable kinds are registered at runtime via
+ * `IAssetKindRegistry`. Use `KNOWN_ASSET_KINDS` for the built-in set.
+ *
+ * @docLink packages/library/concepts#asset-kind
+ */
+export type AssetKind = string;
+/**
+ * Tuple of all allowed version-pin policy values.
+ *
+ * Used to derive the `PinPolicy` type and the `PinPolicySchema` zod enum in
+ * `workspace-config.ts`.
+ *
+ * @docLink packages/library/concepts#pin-policy
+ */
+export declare const PIN_POLICIES: readonly ["exact", "minor-track", "latest"];
+/**
+ * Version-pin strategy for an Instance or Subscription.
+ *
+ * - `exact` — pins to the exact version in `defRef`; never auto-upgrades.
+ * - `minor-track` — allows compatible minor/patch updates (>=X.Y, <X+1).
+ * - `latest` — always resolves to the highest available version.
+ *
+ * @docLink packages/library/concepts#pin-policy
+ */
+export type PinPolicy = (typeof PIN_POLICIES)[number];
+/**
+ * Kind of asset source registered in the library — backed by the `libraries`
+ * table after the 2026-05-13 schema change. Kept for backward compat; new
+ * code should reference `UserLibrary` from `user-library.ts`.
+ */
+export type SourceType = "local" | "git" | "store";
+/**
+ * A registered asset source — a row in the `libraries` table.
+ *
+ * @docLink packages/library/concepts#source
+ */
+export interface Source {
+    id: string;
+    /** Backend kind (renamed from `type`). */
+    type: SourceType;
+    /** User-visible handle (NEW). */
+    name: string;
+    /** Absolute on-disk root. */
+    path: string;
+    /** Ownership level (NEW). */
+    ownership: "owner" | "contributor" | "reader";
+    /** True iff this is the auto-target for `asset migrate`. */
+    isDefault: boolean;
+    /** Backend-specific config — parsed from JSON. */
+    backendConfig: Record<string, unknown>;
+    /** Detected layout. */
+    structure?: "flat" | "domain";
+    /** True iff CLI generated the on-disk `.skaile-source.yaml`. */
+    manifestGenerated: boolean;
+    /** Last sync timestamp. */
+    lastSyncedAt?: Date;
+    createdAt: Date;
+    updatedAt: Date;
+    /** @deprecated For migration compat; now mirrors `backendConfig.url`. */
+    url?: string;
+    /** @deprecated For migration compat; mirrors `backendConfig.branch`. */
+    ref?: string;
+}
+/**
+ * Input shape for {@link LocalLibrary.addSource}.
+ *
+ * @docLink packages/library/concepts#source
+ */
+export interface AddSourceInput {
+    type: SourceType;
+    name: string;
+    path: string;
+    ownership?: "owner" | "contributor" | "reader";
+    backendConfig?: Record<string, unknown>;
+    isDefault?: boolean;
+}
+/**
+ * Result returned by {@link ILibrary.syncSource}.
+ *
+ * @docLink packages/library/concepts#source
+ */
+export interface SyncResult {
+    /** The source ID that was synced. */
+    sourceId: string;
+    /** Total number of assets discovered in the tree. */
+    assetsFound: number;
+    /** Number of asset definitions created or updated in the cache. */
+    assetsUpdated: number;
+    /** Non-fatal per-asset errors encountered during sync. */
+    errors: string[];
+}
+/**
+ * Cached asset metadata entry in the Library, sourced from a Catalog sync.
+ *
+ * The `id` field is the canonical ref (`<publisher>/<name>@<version>`).
+ *
+ * @docLink packages/library/concepts#asset-definition
+ */
+export interface AssetDefinition {
+    /** Canonical ref: `<publisher>/<name>@<version>` */
+    id: string;
+    /** Asset kind (skill, agent, connector, etc.). */
+    kind: AssetKind;
+    /** Publisher identifier (namespace owner). */
+    publisher: string;
+    /** Asset name within the publisher namespace. */
+    name: string;
+    /** Semantic version string. */
+    version: string;
+    /** SHA-256 content hash for integrity verification. */
+    sha256?: string;
+    /** Human-readable asset description from the manifest. */
+    description?: string;
+    /** SPDX license identifier from the manifest. */
+    license?: string;
+    /** Category tag from the manifest. */
+    category?: string;
+    /** Full parsed manifest as JSON-safe object. */
+    manifest: Record<string, unknown>;
+    /** Source that provided this definition (null when source was removed). */
+    sourceId?: string;
+    /**
+     * Version of the IAssetKindProvider that produced this cached entry.
+     * Independent of the asset's own version — tracks schema/logic evolution.
+     * Mismatch between stored and current provider version is informational
+     * WARN, not blocking (design decision A6).
+     */
+    kindProviderVersion?: string;
+    /** Timestamp when the definition was first cached. */
+    cachedAt: Date;
+    /** Timestamp of the last cache update. */
+    updatedAt: Date;
+}
+/**
+ * Filter options for {@link ILibrary.listAssetDefs}.
+ *
+ * @docLink packages/library/concepts#asset-definition
+ */
+export interface AssetFilter {
+    /** Filter to a specific asset kind. */
+    kind?: AssetKind;
+    /** Filter to a specific publisher namespace. */
+    publisher?: string;
+    /** Prefix match on the full `<publisher>/<name>` ref. */
+    prefix?: string;
+    /** Filter to assets from a specific source. */
+    sourceId?: string;
+    /** Maximum number of results to return. */
+    limit?: number;
+    /** Number of results to skip (for pagination). */
+    offset?: number;
+}
+/**
+ * A configured asset Instance — an `AssetDefinition` bound with user config and
+ * an optional opaque credential reference.
+ *
+ * Instances are workspace-agnostic; workspaces link to them via `Subscription`.
+ *
+ * @docLink packages/library/concepts#instance
+ */
+export interface Instance {
+    /** UUID primary key. */
+    id: string;
+    /** Asset definition ref (may include version range: `@skaile/gmail@^1.4`). */
+    defRef: string;
+    /** Version-pin strategy for this instance. */
+    defPin: PinPolicy;
+    /** Instance-specific configuration merged with the asset defaults at runtime. */
+    config: Record<string, unknown>;
+    /** Opaque handle to SecretsRouter -- never a secret value. */
+    credentialRef?: string;
+    /** Timestamp when the instance was created. */
+    createdAt: Date;
+    /** Timestamp of the last config update. */
+    updatedAt: Date;
+    /** Identity that created the instance (e.g. `preset:<ref>`). */
+    createdBy?: string;
+}
+/**
+ * Input shape for {@link ILibrary.createInstance}.
+ *
+ * @docLink packages/library/concepts#instance
+ */
+export interface CreateInstanceInput {
+    /** Canonical asset definition ref. */
+    defRef: string;
+    /** Version-pin policy; defaults to `minor-track`. */
+    defPin?: PinPolicy;
+    /** Initial configuration for the instance. */
+    config?: Record<string, unknown>;
+    /** Opaque credential reference from the SecretsRouter. */
+    credentialRef?: string;
+    /** Optional creator identity for audit trail. */
+    createdBy?: string;
+}
+/**
+ * Partial update shape for {@link ILibrary.updateInstance}.
+ *
+ * @docLink packages/library/concepts#instance
+ */
+export interface UpdateInstanceInput {
+    /** New configuration (replaces existing config). */
+    config?: Record<string, unknown>;
+    /** Updated credential reference. */
+    credentialRef?: string;
+    /** Updated pin policy. */
+    defPin?: PinPolicy;
+}
+/**
+ * Filter options for {@link ILibrary.listInstances}.
+ *
+ * @docLink packages/library/concepts#instance
+ */
+export interface InstanceFilter {
+    /** Filter by asset definition ref. */
+    defRef?: string;
+    /** Filter by pin policy. */
+    defPin?: PinPolicy;
+    /** Maximum number of results to return. */
+    limit?: number;
+    /** Number of results to skip (for pagination). */
+    offset?: number;
+}
+/**
+ * A Subscription links a workspace to an Instance, recording its pin policy.
+ *
+ * The unique constraint is `(workspaceId, instanceId)` — a workspace can only
+ * subscribe to a given Instance once.
+ *
+ * @docLink packages/library/concepts#subscription
+ */
+export interface Subscription {
+    /** UUID primary key. */
+    id: string;
+    /** Workspace path or identifier. */
+    workspaceId: string;
+    /** The Instance this subscription refers to. */
+    instanceId: string;
+    /** Pin policy recorded at subscription time. */
+    pinPolicy: PinPolicy;
+    /** Timestamp when the subscription was created. */
+    subscribedAt: Date;
+}
+/**
+ * Base error class for all Library-layer errors.
+ *
+ * All subclasses carry a machine-readable `code` string that callers can
+ * switch on without parsing the message.
+ *
+ * @docLink packages/library/concepts#errors
+ */
+export declare class LibraryError extends Error {
+    readonly code: string;
+    constructor(message: string, code: string);
+}
+/**
+ * Thrown by {@link ILibrary.removeSource} and {@link ILibrary.syncSource}
+ * when the given source ID does not exist.
+ *
+ * @docLink packages/library/concepts#errors
+ */
+export declare class SourceNotFoundError extends LibraryError {
+    constructor(id: string);
+}
+/**
+ * Thrown by {@link ILibrary.getInstance}, {@link ILibrary.updateInstance},
+ * and {@link ILibrary.deleteInstance} when the given instance ID does not exist.
+ *
+ * @docLink packages/library/concepts#errors
+ */
+export declare class InstanceNotFoundError extends LibraryError {
+    constructor(id: string);
+}
+/**
+ * Thrown by {@link ILibrary.unsubscribe} when the given subscription ID does not exist.
+ *
+ * @docLink packages/library/concepts#errors
+ */
+export declare class SubscriptionNotFoundError extends LibraryError {
+    constructor(id: string);
+}
+/**
+ * Thrown by {@link ILibrary.subscribe} when the workspace already has an active
+ * subscription to the same Instance.
+ *
+ * @docLink packages/library/concepts#errors
+ */
+export declare class DuplicateSubscriptionError extends LibraryError {
+    constructor(workspaceId: string, instanceId: string);
+}
+/**
+ * Thrown by {@link ILibrary.deleteInstance} when the Instance has active
+ * Subscriptions and `{ cascade: true }` was not passed.
+ *
+ * @docLink packages/library/concepts#errors
+ */
+export declare class InstanceHasConsumersError extends LibraryError {
+    constructor(instanceId: string, count: number);
+}
+/**
+ * Single-interface contract for the asset cache layer.
+ *
+ * @docLink packages/library/concepts#i-asset-index
+ */
+export interface IAssetIndex {
+    /** Look up a cached AssetDefinition by its canonical ref. */
+    getAssetDef(ref: string): Promise<AssetDefinition | null>;
+    /** List cached AssetDefinitions, optionally filtered. */
+    listAssetDefs(filter?: AssetFilter): Promise<AssetDefinition[]>;
+    createInstance(input: CreateInstanceInput): Promise<Instance>;
+    getInstance(id: string): Promise<Instance | null>;
+    listInstances(filter?: InstanceFilter): Promise<Instance[]>;
+    updateInstance(id: string, patch: UpdateInstanceInput): Promise<Instance>;
+    deleteInstance(id: string, opts?: {
+        cascade?: boolean;
+    }): Promise<void>;
+    subscribe(workspaceId: string, instanceId: string, pin: PinPolicy): Promise<Subscription>;
+    unsubscribe(subscriptionId: string): Promise<void>;
+    listSubscriptions(workspaceId: string): Promise<Subscription[]>;
+    getConsumptionGraph(instanceId: string): Promise<Subscription[]>;
+}
+/** @deprecated Use `IAssetIndex`. Removed in next major. */
+export type ILibrary = IAssetIndex;
+//# sourceMappingURL=library.d.ts.map

package/dist/library/src/library.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"library.d.ts","sourceRoot":"","sources":["../../../library/src/library.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAWH;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,kIAYpB,CAAC;AAEX,yEAAyE;AACzE,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhE;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAO/B;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,6CAA8C,CAAC;AAExE;;;;;;;;GAQG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAMtD;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,KAAK,GAAG,OAAO,CAAC;AAEnD;;;;GAIG;AACH,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,0CAA0C;IAC1C,IAAI,EAAE,UAAU,CAAC;IACjB,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,SAAS,EAAE,OAAO,GAAG,aAAa,GAAG,QAAQ,CAAC;IAC9C,4DAA4D;IAC5D,SAAS,EAAE,OAAO,CAAC;IACnB,kDAAkD;IAClD,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,uBAAuB;IACvB,SAAS,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC9B,gEAAgE;IAChE,iBAAiB,EAAE,OAAO,CAAC;IAC3B,2BAA2B;IAC3B,YAAY,CAAC,EAAE,IAAI,CAAC;IACpB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,yEAAyE;IACzE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,OAAO,GAAG,aAAa,GAAG,QAAQ,CAAC;IAC/C,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,aAAa,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAMD;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,oDAAoD;IACpD,EAAE,EAAE,MAAM,CAAC;IACX,kDAAkD;IAClD,IAAI,EAAE,SAAS,CAAC;IAChB,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,sDAAsD;IACtD,QAAQ,EAAE,IAAI,CAAC;IACf,0CAA0C;IAC1C,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,uCAAuC;IACvC,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAMD;;;;;;;GAOG;AACH,MAAM,WAAW,QAAQ;IACvB,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,8EAA8E;IAC9E,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,MAAM,EAAE,SAAS,CAAC;IAClB,iFAAiF;IACjF,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,8DAA8D;IAC9D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+CAA+C;IAC/C,SAAS,EAAE,IAAI,CAAC;IAChB,2CAA2C;IAC3C,SAAS,EAAE,IAAI,CAAC;IAChB,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,0DAA0D;IAC1D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,oCAAoC;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0BAA0B;IAC1B,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAMD;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,SAAS,EAAE,SAAS,CAAC;IACrB,mDAAmD;IACnD,YAAY,EAAE,IAAI,CAAC;CACpB;AAMD;;;;;;;GAOG;AACH,qBAAa,YAAa,SAAQ,KAAK;aAGnB,IAAI,EAAE,MAAM;gBAD5B,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM;CAK/B;AAED;;;;;GAKG;AACH,qBAAa,mBAAoB,SAAQ,YAAY;gBACvC,EAAE,EAAE,MAAM;CAIvB;AAED;;;;;GAKG;AACH,qBAAa,qBAAsB,SAAQ,YAAY;gBACzC,EAAE,EAAE,MAAM;CAIvB;AAED;;;;GAIG;AACH,qBAAa,yBAA0B,SAAQ,YAAY;gBAC7C,EAAE,EAAE,MAAM;CAIvB;AAED;;;;;GAKG;AACH,qBAAa,0BAA2B,SAAQ,YAAY;gBAC9C,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;CAOpD;AAED;;;;;GAKG;AACH,qBAAa,yBAA0B,SAAQ,YAAY;gBAC7C,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;CAO9C;AAYD;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,6DAA6D;IAC7D,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IAE1D,yDAAyD;IACzD,aAAa,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAEhE,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC9D,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IAClD,aAAa,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC5D,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC1E,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExE,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC1F,WAAW,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAChE,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;CAClE;AAED,4DAA4D;AAC5D,MAAM,MAAM,QAAQ,GAAG,WAAW,CAAC"}

package/dist/library/src/local/db.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Local library DB initialization.
+ *
+ * Opens an `@libsql/client` SQLite connection over a `file:` URL, sets WAL +
+ * FK pragmas, applies the one-shot Libraries migration if the legacy
+ * `sources` table is present, then runs the modern DDL (idempotent via
+ * CREATE TABLE IF NOT EXISTS). `@libsql/client` runs on both Node and Bun
+ * from a single driver — no runtime dispatch.
+ *
+ * @docLink packages/library/concepts#local-library
+ */
+import { type LibSQLDatabase } from "drizzle-orm/libsql";
+import * as schema from "./schema.js";
+export type LibraryDb = LibSQLDatabase<typeof schema>;
+export interface LibraryDbHandle {
+    db: LibraryDb;
+    close(): void;
+}
+/**
+ * Open (or create) the local library SQLite database.
+ *
+ * Async because `@libsql/client` is async-only. `LocalLibrary` opens the DB
+ * lazily on first use to keep its constructor synchronous.
+ *
+ * @param dbPath - Absolute path to the `lib.db` file.
+ * @returns A handle carrying the Drizzle DB and a synchronous `close()`.
+ */
+export declare function createLibraryDb(dbPath: string): Promise<LibraryDbHandle>;
+//# sourceMappingURL=db.d.ts.map

package/dist/library/src/local/db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../../../library/src/local/db.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EAAW,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAyOtC,MAAM,MAAM,SAAS,GAAG,cAAc,CAAC,OAAO,MAAM,CAAC,CAAC;AAEtD,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,SAAS,CAAC;IACd,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAc9E"}

package/dist/library/src/local/library.d.ts

@@ -0,0 +1,85 @@
+/**
+ * LocalLibrary — SQLite-backed ILibrary implementation.
+ *
+ * Storage: ~/.skaile/libraries/lib.db (overridable via constructor arg or
+ * SKAILE_LIBRARIES_DIR env, with legacy SKAILE_LIBRARY_DIR fallback).
+ * Auto-creates the directory on first use.
+ *
+ * All four entity tables (libraries, asset_definitions, instances, subscriptions)
+ * are created on first open. See db.ts for DDL.
+ *
+ * @docLink packages/library/concepts#local-library
+ */
+import type { IAssetKindRegistry } from "@skaile/workspaces/plugins";
+import type { AddSourceInput, AssetDefinition, AssetFilter, CreateInstanceInput, IAssetIndex, Instance, InstanceFilter, PinPolicy, Source, Subscription, SyncResult, UpdateInstanceInput } from "../library.js";
+import { type LibraryDb } from "./db.js";
+export interface LocalLibraryOptions {
+    /** Override the library storage directory. */
+    libraryDir?: string;
+    /** Kind registry for provider-version tracking and kind validation. */
+    kindRegistry?: IAssetKindRegistry;
+}
+/**
+ * SQLite-backed implementation of {@link IAssetIndex}.
+ *
+ * Backed by `@libsql/client`, so it runs on both Node and Bun. Stores data at
+ * `~/.skaile/libraries/lib.db` by default. Override with the
+ * `SKAILE_LIBRARIES_DIR` environment variable (or legacy `SKAILE_LIBRARY_DIR`)
+ * or the constructor argument.
+ *
+ * The constructor is synchronous — it only resolves the storage path. The
+ * SQLite connection is opened lazily on first use (`@libsql/client` is
+ * async-only). Always call {@link LocalLibrary.close} in a `finally` block to
+ * release the connection.
+ *
+ * @docLink packages/library/concepts#local-library
+ */
+export declare class LocalLibrary implements IAssetIndex {
+    private readonly dbPath;
+    private dbHandleRef;
+    private dbPromise;
+    private _kindRegistry;
+    /**
+     * Construct a LocalLibrary. Synchronous — does not open the DB.
+     *
+     * @param optionsOrDir - Either a `LocalLibraryOptions` object or a string
+     *   path (legacy signature, kept for backward compat).
+     */
+    constructor(optionsOrDir?: string | LocalLibraryOptions);
+    /**
+     * Lazily open the SQLite DB on first use. The `??=` dedupes concurrent
+     * first calls so the DB is opened exactly once, with no race.
+     */
+    private ensureDb;
+    /** The kind registry bound to this library (if any). */
+    get kinds(): IAssetKindRegistry | undefined;
+    /** Close the underlying SQLite connection. Call in tests / cleanup. */
+    close(): void;
+    /** Internal access for UserLibraryManager. Do not call from user code. */
+    dbHandle(): Promise<LibraryDb>;
+    listSources(): Promise<Source[]>;
+    addSource(input: AddSourceInput): Promise<Source>;
+    removeSource(id: string): Promise<void>;
+    syncSource(id: string): Promise<SyncResult>;
+    /**
+     * Insert or update a cached asset definition.
+     *
+     * Not on the IAssetIndex interface -- used by catalog sources (Task 1.5)
+     * and tests. INSERT OR REPLACE semantics.
+     */
+    upsertAssetDef(def: AssetDefinition): Promise<void>;
+    getAssetDef(ref: string): Promise<AssetDefinition | null>;
+    listAssetDefs(filter?: AssetFilter): Promise<AssetDefinition[]>;
+    createInstance(input: CreateInstanceInput): Promise<Instance>;
+    getInstance(id: string): Promise<Instance | null>;
+    listInstances(filter?: InstanceFilter): Promise<Instance[]>;
+    updateInstance(id: string, patch: UpdateInstanceInput): Promise<Instance>;
+    deleteInstance(id: string, opts?: {
+        cascade?: boolean;
+    }): Promise<void>;
+    subscribe(workspaceId: string, instanceId: string, pin: PinPolicy): Promise<Subscription>;
+    unsubscribe(subscriptionId: string): Promise<void>;
+    listSubscriptions(workspaceId: string): Promise<Subscription[]>;
+    getConsumptionGraph(instanceId: string): Promise<Subscription[]>;
+}
+//# sourceMappingURL=library.d.ts.map

package/dist/library/src/local/library.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"library.d.ts","sourceRoot":"","sources":["../../../../library/src/local/library.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAGrE,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,WAAW,EACX,mBAAmB,EACnB,WAAW,EACX,QAAQ,EACR,cAAc,EACd,SAAS,EACT,MAAM,EACN,YAAY,EACZ,UAAU,EACV,mBAAmB,EACpB,MAAM,eAAe,CAAC;AAQvB,OAAO,EAAmB,KAAK,SAAS,EAAwB,MAAM,SAAS,CAAC;AAwFhF,MAAM,WAAW,mBAAmB;IAClC,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,YAAY,CAAC,EAAE,kBAAkB,CAAC;CACnC;AAMD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,YAAa,YAAW,WAAW;IAC9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,WAAW,CAAgC;IACnD,OAAO,CAAC,SAAS,CAAyC;IAC1D,OAAO,CAAC,aAAa,CAAiC;IAEtD;;;;;OAKG;gBACS,YAAY,CAAC,EAAE,MAAM,GAAG,mBAAmB;IAcvD;;;OAGG;YACW,QAAQ;IAOtB,wDAAwD;IACxD,IAAI,KAAK,IAAI,kBAAkB,GAAG,SAAS,CAE1C;IAED,uEAAuE;IACvE,KAAK,IAAI,IAAI;IAMb,0EAA0E;IACpE,QAAQ,IAAI,OAAO,CAAC,SAAS,CAAC;IAM9B,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAMhC,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IA2BjD,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWvC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAuBjD;;;;;OAKG;IACG,cAAc,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAkDnD,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAUzD,aAAa,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IA0B/D,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAiC7D,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAMjD,aAAa,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAqB3D,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAyBzE,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BvE,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,YAAY,CAAC;IAiCzF,WAAW,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYlD,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAW/D,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAUvE"}

package/dist/library/src/local/local-catalog-source.d.ts

@@ -0,0 +1,66 @@
+/**
+ * LocalCatalogSource — ICatalogSource backed by local filesystem discovery.
+ *
+ * Walks subscribed local repos via `discoverAssetsInTree`, computes SHA256
+ * over the deterministic file filter, and caches AssetDefinition rows in
+ * the LocalLibrary SQLite.
+ *
+ * Used by the CLI for local-only workflows. The platform uses the remote
+ * catalog source (Phase 2).
+ *
+ * @docLink packages/library/concepts#local-catalog-source
+ */
+import type { CatalogAsset, CatalogAssetFilter, CatalogSourceInfo, IAssetKindRegistry, ICatalogSource } from "@skaile/workspaces/plugins";
+import type { LocalLibrary } from "./library.js";
+/**
+ * Optional constructor opts for {@link LocalCatalogSource}.
+ *
+ * @docLink packages/library/concepts#local-catalog-source
+ */
+export interface LocalCatalogSourceOptions {
+    /**
+     * Absolute path to a sidecar directory carrying a local-overlay manifest
+     * (`~/.skaile/sources/<slug>/`). When set, discovery merges the sidecar's
+     * `.skaile-source.yaml` on top of the in-repo config before dispatch.
+     *
+     * Typically populated by `openLibrary()`-based callers reading
+     * `source.sidecarPath` from the registered source row.
+     */
+    sidecarPath?: string;
+}
+/**
+ * Local-filesystem implementation of `ICatalogSource` (from `@skaile/plugins`).
+ *
+ * Backed by `discoverAssetsInTree` from `@skaile/discovery`. Upserts discovered
+ * assets into the `LocalLibrary` cache via `upsertAssetDef()`. Preset-kind assets
+ * are skipped (handled by the Preset subsystem, not stored as AssetDefinitions).
+ *
+ * @docLink packages/library/concepts#local-catalog-source
+ */
+export declare class LocalCatalogSource implements ICatalogSource {
+    private readonly library;
+    private readonly sourceId;
+    private readonly rootPath;
+    private readonly registry?;
+    readonly id: string;
+    private readonly sidecarPath?;
+    constructor(library: LocalLibrary, sourceId: string, rootPath: string, registry?: IAssetKindRegistry | undefined, options?: LocalCatalogSourceOptions);
+    resolve(ref: string): Promise<CatalogAsset | null>;
+    listAssets(filter?: CatalogAssetFilter): Promise<CatalogAsset[]>;
+    fetchTarball(_ref: string, _sha256: string): Promise<Uint8Array>;
+    listSources(): Promise<CatalogSourceInfo[]>;
+    /**
+     * Sync: discover assets in the source directory and cache them in the library.
+     *
+     * Runs the discovery pipeline (glob -> parse -> filter -> hash -> requires)
+     * and upserts each discovered asset into the LocalLibrary cache.
+     *
+     * @returns Discovery statistics and any errors encountered.
+     */
+    sync(): Promise<{
+        assetsFound: number;
+        assetsUpdated: number;
+        errors: string[];
+    }>;
+}
+//# sourceMappingURL=local-catalog-source.d.ts.map

package/dist/library/src/local/local-catalog-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-catalog-source.d.ts","sourceRoot":"","sources":["../../../../library/src/local/local-catalog-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAUH,OAAO,KAAK,EACV,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACf,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAMjD;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAMD;;;;;;;;GAQG;AACH,qBAAa,kBAAmB,YAAW,cAAc;IAKrD,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAP5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAS;gBAGnB,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,kBAAkB,YAAA,EAC9C,OAAO,CAAC,EAAE,yBAAyB;IAM/B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAMlD,UAAU,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAUhE,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAMhE,WAAW,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAIjD;;;;;;;OAOG;IACG,IAAI,IAAI,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CAuDxF"}