@skaile/workspaces 0.8.5

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

@@ -0,0 +1,106 @@
+/**
+ * IAssetKindRegistry — contract for the frozen-state asset kind registry.
+ *
+ * Library-bound, not process-global. Follows a frozen-state machine:
+ * - register() is valid only in the "open" state
+ * - First read operation auto-freezes the registry
+ * - freeze() is idempotent
+ *
+ * Conflicts on registration are hard errors (A4):
+ * - Same kind registered twice → AssetKindConflictError
+ * - Overlapping glob patterns → AssetKindPatternConflictError
+ * - Multiple providers match a path → AssetKindPathAmbiguityError
+ *
+ * Design decisions A3, A4: locked in Phase 1.7 planning.
+ */
+import type { IAssetKindProvider, AssetKindFileFilter, AssetKindRequiresEdge } from "./asset-kind-provider.js";
+import type { ManifestValidationResult } from "@skaile/workspaces/types/manifests";
+/**
+ * Thrown when a kind is registered that already exists in the registry.
+ */
+export declare class AssetKindConflictError extends Error {
+    readonly kind: string;
+    constructor(kind: string);
+}
+/**
+ * Thrown when a provider's discovery patterns overlap with an
+ * already-registered provider's patterns.
+ */
+export declare class AssetKindPatternConflictError extends Error {
+    readonly newKind: string;
+    readonly existingKind: string;
+    readonly conflictingPattern: string;
+    constructor(newKind: string, existingKind: string, conflictingPattern: string);
+}
+/**
+ * Thrown at discovery time when multiple providers claim the same path.
+ * This indicates a bug in matchesPath implementations — should be caught
+ * earlier by pattern conflict detection, but serves as a runtime safety net.
+ */
+export declare class AssetKindPathAmbiguityError extends Error {
+    readonly path: string;
+    readonly matchingKinds: string[];
+    constructor(path: string, matchingKinds: string[]);
+}
+/**
+ * Thrown when register() is called on a frozen registry.
+ */
+export declare class AssetKindRegistryFrozenError extends Error {
+    constructor();
+}
+/**
+ * Frozen-state asset kind registry.
+ *
+ * Lifecycle:
+ * 1. Created in "open" state
+ * 2. Providers registered via register()
+ * 3. First read operation (getProvider, getAllProviders, resolveKind,
+ *    validateManifest, defaultFileFilter, extractRequires) auto-freezes
+ * 4. No further registrations allowed
+ *
+ * Implementations: AssetKindRegistry in @skaile/discovery.
+ */
+export interface IAssetKindRegistry {
+    /** Whether the registry is frozen (no further registrations allowed). */
+    readonly frozen: boolean;
+    /**
+     * Register a provider. Must be called before the registry is frozen.
+     * @throws AssetKindConflictError if kind already registered
+     * @throws AssetKindPatternConflictError if patterns overlap
+     * @throws AssetKindRegistryFrozenError if registry is frozen
+     */
+    register(provider: IAssetKindProvider): void;
+    /**
+     * Explicitly freeze the registry. Idempotent — calling on an already-frozen
+     * registry is a no-op.
+     */
+    freeze(): void;
+    /** Get a provider by kind name. Returns undefined for unregistered kinds. */
+    getProvider(kind: string): IAssetKindProvider | undefined;
+    /** Get all registered providers (snapshot, not live). */
+    getAllProviders(): IAssetKindProvider[];
+    /** Get all registered kind names. */
+    getAllKinds(): string[];
+    /**
+     * Resolve a relative path to an asset kind.
+     * @throws AssetKindPathAmbiguityError if multiple providers match
+     * @returns The kind string, or undefined if no provider matches
+     */
+    resolveKind(relativePath: string): string | undefined;
+    /**
+     * Validate a manifest for a given kind.
+     * @returns Validation result, or a failure if the kind is unregistered
+     */
+    validateManifest(kind: string, data: unknown): ManifestValidationResult<unknown>;
+    /**
+     * Compute the default file filter for an asset.
+     * @returns The file filter, or undefined if the kind is unregistered
+     */
+    defaultFileFilter(kind: string, manifestPath: string): AssetKindFileFilter | undefined;
+    /**
+     * Extract requires edges from a manifest.
+     * @returns The edges, or an empty array if the kind has no extractRequires
+     */
+    extractRequires(kind: string, assetRef: string, manifest: Record<string, unknown>): AssetKindRequiresEdge[];
+}
+//# sourceMappingURL=asset-kind-registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"asset-kind-registry.d.ts","sourceRoot":"","sources":["../../../plugins/src/asset-kind-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AAMnF;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,IAAI,EAAE,MAAM;CAKzB;AAED;;;GAGG;AACH,qBAAa,6BAA8B,SAAQ,KAAK;IACtD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;gBAExB,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM;CAS9E;AAED;;;;GAIG;AACH,qBAAa,2BAA4B,SAAQ,KAAK;IACpD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC;gBAErB,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE;CAQlD;AAED;;GAEG;AACH,qBAAa,4BAA6B,SAAQ,KAAK;;CAOtD;AAMD;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,kBAAkB;IACjC,yEAAyE;IACzE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAEzB;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAE7C;;;OAGG;IACH,MAAM,IAAI,IAAI,CAAC;IAIf,6EAA6E;IAC7E,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAAC;IAE1D,yDAAyD;IACzD,eAAe,IAAI,kBAAkB,EAAE,CAAC;IAExC,qCAAqC;IACrC,WAAW,IAAI,MAAM,EAAE,CAAC;IAExB;;;;OAIG;IACH,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAItD;;;OAGG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAEjF;;;OAGG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAAC;IAEvF;;;OAGG;IACH,eAAe,CACb,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,qBAAqB,EAAE,CAAC;CAC5B"}

package/dist/plugins/src/catalog-source.d.ts

@@ -0,0 +1,87 @@
+/**
+ * ICatalogSource — pluggable asset catalog source interface.
+ *
+ * Lives in workspaces/plugins (all pluggable interface contracts centralized here).
+ * Built-in implementation: LocalCatalogSource in workspaces/library.
+ *
+ * Types are defined inline (structurally compatible with library's
+ * AssetDefinition / Source) to avoid circular deps — plugins is a leaf package.
+ */
+/**
+ * A single asset entry as returned by {@link ICatalogSource.resolve} and
+ * {@link ICatalogSource.listAssets}.
+ *
+ * Types are defined inline (structurally compatible with `library`'s
+ * `AssetDefinition`) to keep `plugins` a zero-dependency leaf package.
+ *
+ * @docLink packages/workspace-plugin/index#plugin-interfaces
+ */
+export interface CatalogAsset {
+    /** Canonical ref: `<publisher>/<name>@<version>`. */
+    id: string;
+    kind: string;
+    publisher: string;
+    name: string;
+    version: string;
+    sha256?: string;
+    description?: string;
+    license?: string;
+    category?: string;
+    /** Full parsed manifest as JSON-safe object. */
+    manifest: Record<string, unknown>;
+}
+/**
+ * Optional filter passed to {@link ICatalogSource.listAssets}.
+ *
+ * All fields are optional — an empty filter returns the full catalog.
+ *
+ * @docLink packages/workspace-plugin/index#plugin-interfaces
+ */
+export interface CatalogAssetFilter {
+    kind?: string;
+    publisher?: string;
+    /** Prefix match on the full `<publisher>/<name>` ref. */
+    prefix?: string;
+}
+/**
+ * Descriptor returned by {@link ICatalogSource.listSources}.
+ *
+ * Identifies a registered catalog source by its ID, type, and URL.
+ *
+ * @docLink packages/workspace-plugin/index#plugin-interfaces
+ */
+export interface CatalogSourceInfo {
+    id: string;
+    type: string;
+    url: string;
+}
+/**
+ * Pluggable asset catalog source.
+ *
+ * Implementations:
+ * - `LocalCatalogSource` (Phase 1) — walks subscribed local repos (in `workspaces/library`)
+ * - skaile.store HTTP client (Phase 2)
+ * - Enterprise internal registries (future)
+ *
+ * @docLink packages/workspace-plugin/index#plugin-interfaces
+ */
+export interface ICatalogSource {
+    /** Unique source identifier used for registration and diagnostics. */
+    readonly id: string;
+    /** Resolve a single asset by canonical ref (`<publisher>/<name>@<version>`). */
+    resolve(ref: string): Promise<CatalogAsset | null>;
+    /** List assets matching an optional filter. */
+    listAssets(filter?: CatalogAssetFilter): Promise<CatalogAsset[]>;
+    /**
+     * Fetch the content-addressed tarball for an asset.
+     *
+     * @param ref    - Canonical asset ref.
+     * @param sha256 - Expected SHA-256 digest for integrity verification.
+     * @returns Raw tarball bytes.
+     * @throws When the tarball cannot be fetched (local sources may throw — assets are available on disk).
+     */
+    fetchTarball(ref: string, sha256: string): Promise<Uint8Array>;
+    /** List registered sources. */
+    listSources(): Promise<CatalogSourceInfo[]>;
+}
+//# sourceMappingURL=catalog-source.d.ts.map

package/dist/plugins/src/catalog-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-source.d.ts","sourceRoot":"","sources":["../../../plugins/src/catalog-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAY;IAC3B,qDAAqD;IACrD,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAMD;;;;;;;;;GASG;AACH,MAAM,WAAW,cAAc;IAC7B,sEAAsE;IACtE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,gFAAgF;IAChF,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAEnD,+CAA+C;IAC/C,UAAU,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAEjE;;;;;;;OAOG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAE/D,+BAA+B;IAC/B,WAAW,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;CAC7C"}

package/dist/plugins/src/index.d.ts

@@ -0,0 +1,8 @@
+export declare const VERSION = "0.0.0";
+export type { IAssetKindProvider, AssetKindFileFilter, AssetKindRequiresEdge, } from "./asset-kind-provider.js";
+export { AssetKindConflictError, AssetKindPatternConflictError, AssetKindPathAmbiguityError, AssetKindRegistryFrozenError, } from "./asset-kind-registry.js";
+export type { IAssetKindRegistry } from "./asset-kind-registry.js";
+export { SecretsError, SecretNotFoundError, SecretAccessDeniedError, SecretExpiredError, ProviderUnavailableError, } from "./secrets-provider.js";
+export type { ISecretsProvider, SecretMetadata, ProviderCapabilities, SetSecretOptions, ListFilter, } from "./secrets-provider.js";
+export type { ICatalogSource, CatalogAsset, CatalogAssetFilter, CatalogSourceInfo, } from "./catalog-source.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../plugins/src/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,UAAU,CAAC;AAG/B,YAAY,EACV,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,sBAAsB,EACtB,6BAA6B,EAC7B,2BAA2B,EAC3B,4BAA4B,GAC7B,MAAM,0BAA0B,CAAC;AAElC,YAAY,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAGnE,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EACV,gBAAgB,EAChB,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,UAAU,GACX,MAAM,uBAAuB,CAAC;AAG/B,YAAY,EACV,cAAc,EACd,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC"}

package/dist/plugins/src/secrets-provider.d.ts

@@ -0,0 +1,143 @@
+/**
+ * ISecretsProvider — pluggable secret storage/retrieval interface.
+ *
+ * Lives in workspaces/plugins (all pluggable interface contracts centralized here).
+ * Built-in implementations live in workspaces/secrets.
+ *
+ * Signature locked per Phase 1 plan decision E5.
+ */
+/**
+ * Metadata record returned by {@link ISecretsProvider.getMetadata}.
+ *
+ * Carries audit timestamps and optional ownership information without
+ * exposing the secret value itself.
+ *
+ * @docLink packages/workspace-plugin/index#plugin-interfaces
+ */
+export interface SecretMetadata {
+    ref: string;
+    createdAt: Date;
+    updatedAt: Date;
+    lastAccessedAt?: Date;
+    owner?: string;
+    scopeSummary?: string;
+}
+/**
+ * Feature flags advertised by a secrets provider via
+ * {@link ISecretsProvider.getCapabilities}.
+ *
+ * Consumers use this to determine whether rotation, TTL, or batch operations
+ * are available before calling the corresponding methods.
+ *
+ * @docLink packages/workspace-plugin/index#plugin-interfaces
+ */
+export interface ProviderCapabilities {
+    supportsRotation: boolean;
+    supportsExpiry: boolean;
+    supportsBatch: boolean;
+    scopeModel: "flat" | "hierarchical";
+}
+/**
+ * Options accepted by {@link ISecretsProvider.setSecret}.
+ *
+ * @docLink packages/workspace-plugin/index#plugin-interfaces
+ */
+export interface SetSecretOptions {
+    ttlSeconds?: number;
+    metadata?: Record<string, string>;
+}
+/**
+ * Filter parameters accepted by {@link ISecretsProvider.listSecrets}.
+ *
+ * All fields are optional — an empty filter returns all accessible secrets.
+ *
+ * @docLink packages/workspace-plugin/index#plugin-interfaces
+ */
+export interface ListFilter {
+    prefix?: string;
+    owner?: string;
+    limit?: number;
+}
+/**
+ * Base error class for all secrets-layer failures.
+ *
+ * Carries a machine-readable `code` string alongside the human-readable
+ * message so callers can switch on error type without instanceof chains.
+ *
+ * @docLink packages/workspace-plugin/index#plugin-interfaces
+ */
+export declare class SecretsError extends Error {
+    code: string;
+    constructor(message: string, code: string);
+}
+/**
+ * Thrown by {@link ISecretsProvider.getSecret} when the requested `ref` does
+ * not exist in the provider's backing store.
+ *
+ * @docLink packages/workspace-plugin/index#plugin-interfaces
+ */
+export declare class SecretNotFoundError extends SecretsError {
+    constructor(ref: string);
+}
+/**
+ * Thrown when the caller does not have permission to access a secret.
+ *
+ * @docLink packages/workspace-plugin/index#plugin-interfaces
+ */
+export declare class SecretAccessDeniedError extends SecretsError {
+    constructor(message?: string);
+}
+/**
+ * Thrown by {@link ISecretsProvider.getSecret} when the secret exists but its
+ * TTL has elapsed.
+ *
+ * @docLink packages/workspace-plugin/index#plugin-interfaces
+ */
+export declare class SecretExpiredError extends SecretsError {
+    constructor(ref: string);
+}
+/**
+ * Thrown when the backing secrets provider cannot be reached.
+ *
+ * Carries an optional `cause` string with provider-specific diagnostics.
+ *
+ * @docLink packages/workspace-plugin/index#plugin-interfaces
+ */
+export declare class ProviderUnavailableError extends SecretsError {
+    constructor(providerId: string, cause?: string);
+}
+/**
+ * Pluggable interface for secret storage and retrieval.
+ *
+ * Built-in implementations (Phase 1): `LocalSecretsProvider`, `EnvSecretsProvider`
+ * (in `workspaces/secrets`).  Future implementations include Vault, AWS SM,
+ * GCP SM, Azure Key Vault, Infisical, Doppler, and Bitwarden Secrets.
+ *
+ * Registration is explicit and programmatic: `pluginRegistry.register(impl)`.
+ * Third-party providers are loaded via dynamic import driven by config.
+ *
+ * @docLink packages/workspace-plugin/index#plugin-interfaces
+ */
+export interface ISecretsProvider {
+    /** Unique provider identifier used for registration and diagnostics. */
+    readonly id: string;
+    /** Retrieve a secret by ref, returning the raw bytes. */
+    getSecret(ref: string): Promise<Uint8Array>;
+    /** Store or update a secret. Optional TTL and metadata can be attached. */
+    setSecret(ref: string, value: Uint8Array, opts?: SetSecretOptions): Promise<void>;
+    /** Permanently remove a secret. */
+    deleteSecret(ref: string): Promise<void>;
+    /** List secret refs accessible to the caller, with optional filtering. */
+    listSecrets(filter?: ListFilter): Promise<string[]>;
+    /** Verify the provider is reachable and measure round-trip latency. */
+    testConnection(): Promise<{
+        ok: boolean;
+        latencyMs?: number;
+        error?: string;
+    }>;
+    /** Return audit metadata for a secret without revealing its value. */
+    getMetadata(ref: string): Promise<SecretMetadata>;
+    /** Advertise which optional capabilities this provider supports. */
+    getCapabilities(): ProviderCapabilities;
+}
+//# sourceMappingURL=secrets-provider.d.ts.map

package/dist/plugins/src/secrets-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secrets-provider.d.ts","sourceRoot":"","sources":["../../../plugins/src/secrets-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,cAAc,CAAC,EAAE,IAAI,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,oBAAoB;IACnC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,cAAc,EAAE,OAAO,CAAC;IACxB,aAAa,EAAE,OAAO,CAAC;IACvB,UAAU,EAAE,MAAM,GAAG,cAAc,CAAC;CACrC;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD;;;;;;;GAOG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,IAAI,EAAE,MAAM,CAAC;gBAED,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAK1C;AAED;;;;;GAKG;AACH,qBAAa,mBAAoB,SAAQ,YAAY;gBACvC,GAAG,EAAE,MAAM;CAIxB;AAED;;;;GAIG;AACH,qBAAa,uBAAwB,SAAQ,YAAY;gBAC3C,OAAO,SAAkB;CAItC;AAED;;;;;GAKG;AACH,qBAAa,kBAAmB,SAAQ,YAAY;gBACtC,GAAG,EAAE,MAAM;CAIxB;AAED;;;;;;GAMG;AACH,qBAAa,wBAAyB,SAAQ,YAAY;gBAC5C,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;CAO/C;AAMD;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wEAAwE;IACxE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC5C,2EAA2E;IAC3E,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClF,mCAAmC;IACnC,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,0EAA0E;IAC1E,WAAW,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACpD,uEAAuE;IACvE,cAAc,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/E,sEAAsE;IACtE,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAClD,oEAAoE;IACpE,eAAe,IAAI,oBAAoB,CAAC;CACzC"}

package/dist/provider-QXKEDXWJ.js

@@ -0,0 +1,174 @@
+import './chunk-NSBPE2FW.js';
+import { trace, context, SpanStatusCode } from '@opentelemetry/api';
+import { BatchSpanProcessor, BasicTracerProvider } from '@opentelemetry/sdk-trace-node';
+import { resourceFromAttributes } from '@opentelemetry/resources';
+
+// telemetry/src/otel/gen-ai.ts
+function generationAttributes(gen) {
+  const attrs = {
+    "gen_ai.system": gen.provider,
+    "gen_ai.request.model": gen.model,
+    "skaile.generation.duration_ms": gen.durationMs
+  };
+  if (gen.inputTokens !== void 0) {
+    attrs["gen_ai.usage.input_tokens"] = gen.inputTokens;
+  }
+  if (gen.outputTokens !== void 0) {
+    attrs["gen_ai.usage.output_tokens"] = gen.outputTokens;
+  }
+  if (gen.totalTokens !== void 0) {
+    attrs["gen_ai.usage.total_tokens"] = gen.totalTokens;
+  }
+  if (gen.stopReason) {
+    attrs["gen_ai.response.finish_reasons"] = gen.stopReason;
+  }
+  if (gen.costUsd !== void 0) {
+    attrs["skaile.generation.cost_usd"] = gen.costUsd;
+  }
+  if (gen.promptPreview) {
+    attrs["skaile.generation.prompt_preview"] = gen.promptPreview;
+  }
+  return attrs;
+}
+
+// telemetry/src/otel/exporter.ts
+async function createOtlpExporter(config) {
+  const { OTLPTraceExporter } = await import('@opentelemetry/exporter-trace-otlp-http');
+  const headers = {};
+  if (config.auth && config.secretKey) {
+    const encoded = Buffer.from(`${config.auth}:${config.secretKey}`).toString("base64");
+    headers.Authorization = `Basic ${encoded}`;
+  }
+  return new OTLPTraceExporter({
+    url: config.endpoint,
+    headers
+  });
+}
+var OtelTelemetryProvider = class _OtelTelemetryProvider {
+  tracer;
+  tracerProvider;
+  spanMap = /* @__PURE__ */ new Map();
+  /**
+   * Use OtelTelemetryProvider.create(config) instead of new.
+   * The static factory awaits exporter setup so no early spans are lost.
+   */
+  constructor(_config, tracerProvider) {
+    this.tracerProvider = tracerProvider;
+    this.tracer = tracerProvider.getTracer("skaile-telemetry");
+  }
+  /** Async factory — ensures the exporter is wired before any spans are created. */
+  static async create(config) {
+    const resource = resourceFromAttributes({
+      "service.name": "skaile-workspaces",
+      "service.version": "0.1.0"
+    });
+    const spanProcessors = [];
+    if (config.endpoint) {
+      const exporter = await createOtlpExporter(config);
+      const processor = new BatchSpanProcessor(exporter, {
+        maxExportBatchSize: config.batchSize,
+        scheduledDelayMillis: config.exportIntervalMs
+      });
+      spanProcessors.push(processor);
+    }
+    const tracerProvider = new BasicTracerProvider({ resource, spanProcessors });
+    return new _OtelTelemetryProvider(config, tracerProvider);
+  }
+  startTrace(opts) {
+    const rootSpan = this.tracer.startSpan(opts.name, {
+      attributes: {
+        "skaile.trace.kind": opts.kind,
+        ...opts.attributes ?? {}
+      }
+    });
+    const spanContext = rootSpan.spanContext();
+    const traceId = spanContext.traceId;
+    const spanId = spanContext.spanId;
+    this.spanMap.set(spanId, rootSpan);
+    return {
+      traceId,
+      rootSpan: { spanId, traceId }
+    };
+  }
+  endTrace(traceObj, result) {
+    this.endSpan(traceObj.rootSpan, result);
+  }
+  startSpan(parent, opts) {
+    const parentSpanId = "rootSpan" in parent ? parent.rootSpan.spanId : parent.spanId;
+    const parentOtelSpan = this.spanMap.get(parentSpanId);
+    let childSpan;
+    if (parentOtelSpan) {
+      const parentCtx = trace.setSpan(context.active(), parentOtelSpan);
+      childSpan = this.tracer.startSpan(
+        opts.name,
+        {
+          attributes: {
+            "skaile.span.kind": opts.kind,
+            ...opts.attributes ?? {}
+          }
+        },
+        parentCtx
+      );
+    } else {
+      childSpan = this.tracer.startSpan(opts.name, {
+        attributes: {
+          "skaile.span.kind": opts.kind,
+          ...opts.attributes ?? {}
+        }
+      });
+    }
+    const spanContext = childSpan.spanContext();
+    this.spanMap.set(spanContext.spanId, childSpan);
+    return {
+      spanId: spanContext.spanId,
+      traceId: spanContext.traceId
+    };
+  }
+  endSpan(span, result) {
+    const otelSpan = this.spanMap.get(span.spanId);
+    if (!otelSpan) return;
+    if (result?.attributes) {
+      otelSpan.setAttributes(result.attributes);
+    }
+    if (result?.status === "error") {
+      otelSpan.setStatus({
+        code: SpanStatusCode.ERROR,
+        message: result.error
+      });
+    } else {
+      otelSpan.setStatus({ code: SpanStatusCode.OK });
+    }
+    otelSpan.end();
+    this.spanMap.delete(span.spanId);
+  }
+  addEvent(span, name, attrs) {
+    const otelSpan = this.spanMap.get(span.spanId);
+    otelSpan?.addEvent(name, attrs);
+  }
+  logGeneration(span, generation) {
+    const otelSpan = this.spanMap.get(span.spanId);
+    if (!otelSpan) return;
+    const attrs = generationAttributes(generation);
+    otelSpan.setAttributes(attrs);
+    otelSpan.addEvent("gen_ai.generation", attrs);
+  }
+  recordMetric(_name, _value, _tags) {
+  }
+  async flush() {
+    try {
+      await this.tracerProvider.forceFlush();
+    } catch {
+    }
+  }
+  async shutdown() {
+    try {
+      await this.tracerProvider.shutdown();
+    } catch {
+    }
+    this.spanMap.clear();
+  }
+};
+
+export { OtelTelemetryProvider };
+//# sourceMappingURL=provider-QXKEDXWJ.js.map
+//# sourceMappingURL=provider-QXKEDXWJ.js.map

package/dist/provider-QXKEDXWJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../telemetry/src/otel/gen-ai.ts","../telemetry/src/otel/exporter.ts","../telemetry/src/otel/provider.ts"],"names":[],"mappings":"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","file":"provider-QXKEDXWJ.js","sourcesContent":["import type { GenerationEvent, Attributes } from \"../types.js\";\n\n/**\n * Build OTEL span attributes following the GenAI semantic conventions.\n * Langfuse auto-detects these as LLM generations.\n *\n * Maps {@link GenerationEvent} fields to standard `gen_ai.*` keys (model,\n * provider, token counts, stop reason) and Skaile-specific `skaile.generation.*`\n * keys (duration, cost, prompt preview). Only defined fields are included in\n * the returned map — undefined optional fields are omitted.\n *\n * @param gen - The generation event to convert to OTEL attributes.\n * @returns A flat {@link Attributes} map ready to pass to `otelSpan.setAttributes()`.\n * @see https://opentelemetry.io/docs/specs/semconv/gen-ai/\n * @docLink packages/telemetry/concepts#otel-telemetry-provider\n */\nexport function generationAttributes(gen: GenerationEvent): Attributes {\n  const attrs: Attributes = {\n    \"gen_ai.system\": gen.provider,\n    \"gen_ai.request.model\": gen.model,\n    \"skaile.generation.duration_ms\": gen.durationMs,\n  };\n\n  if (gen.inputTokens !== undefined) {\n    attrs[\"gen_ai.usage.input_tokens\"] = gen.inputTokens;\n  }\n  if (gen.outputTokens !== undefined) {\n    attrs[\"gen_ai.usage.output_tokens\"] = gen.outputTokens;\n  }\n  if (gen.totalTokens !== undefined) {\n    attrs[\"gen_ai.usage.total_tokens\"] = gen.totalTokens;\n  }\n  if (gen.stopReason) {\n    attrs[\"gen_ai.response.finish_reasons\"] = gen.stopReason;\n  }\n  if (gen.costUsd !== undefined) {\n    attrs[\"skaile.generation.cost_usd\"] = gen.costUsd;\n  }\n  if (gen.promptPreview) {\n    attrs[\"skaile.generation.prompt_preview\"] = gen.promptPreview;\n  }\n\n  return attrs;\n}\n","import type { TelemetryConfig } from \"../types.js\";\n\n/**\n * Create an OTLP/HTTP trace exporter configured for the given endpoint.\n * Lazy-loads `@opentelemetry/exporter-trace-otlp-http` so the module is never\n * imported when `provider: \"none\"`.\n *\n * When both `config.auth` and `config.secretKey` are present, a Basic\n * Authorization header is constructed (base-64 encoded `auth:secretKey`),\n * which is the format expected by Langfuse's OTLP ingestion endpoint.\n *\n * @param config - The resolved {@link TelemetryConfig}. `config.endpoint` must\n *   be set (callers gate on this before calling).\n * @returns A configured `OTLPTraceExporter` instance.\n * @docLink packages/telemetry/concepts#otel-telemetry-provider\n */\nexport async function createOtlpExporter(config: TelemetryConfig) {\n  const { OTLPTraceExporter } = await import(\"@opentelemetry/exporter-trace-otlp-http\");\n\n  const headers: Record<string, string> = {};\n\n  if (config.auth && config.secretKey) {\n    const encoded = Buffer.from(`${config.auth}:${config.secretKey}`).toString(\"base64\");\n    headers.Authorization = `Basic ${encoded}`;\n  }\n\n  return new OTLPTraceExporter({\n    url: config.endpoint,\n    headers,\n  });\n}\n","import type {\n  Attributes,\n  GenerationEvent,\n  Span,\n  SpanOptions,\n  SpanResult,\n  TelemetryConfig,\n  TelemetryProvider,\n  Trace,\n  TraceOptions,\n} from \"../types.js\";\nimport { generationAttributes } from \"./gen-ai.js\";\nimport { createOtlpExporter } from \"./exporter.js\";\n\nimport { trace, context, SpanStatusCode } from \"@opentelemetry/api\";\nimport type { Span as OtelSpan, Tracer } from \"@opentelemetry/api\";\nimport { BasicTracerProvider, BatchSpanProcessor } from \"@opentelemetry/sdk-trace-node\";\nimport { resourceFromAttributes } from \"@opentelemetry/resources\";\n\n/**\n * OpenTelemetry-backed telemetry provider. Exports traces via OTLP/HTTP\n * to any compatible backend (Langfuse, Grafana Tempo, Jaeger, etc.).\n *\n * Always instantiate via the async static factory {@link OtelTelemetryProvider.create}\n * so the OTLP exporter is wired before any spans are created. Active OTEL spans\n * are tracked in an internal map keyed by `spanId`; both `flush()` and `shutdown()`\n * swallow export errors so telemetry failures never crash the agent.\n *\n * @docLink packages/telemetry/concepts#otel-telemetry-provider\n */\nexport class OtelTelemetryProvider implements TelemetryProvider {\n  private readonly tracer: Tracer;\n  private readonly tracerProvider: BasicTracerProvider;\n\n  private readonly spanMap = new Map<string, OtelSpan>();\n\n  /**\n   * Use OtelTelemetryProvider.create(config) instead of new.\n   * The static factory awaits exporter setup so no early spans are lost.\n   */\n  private constructor(_config: TelemetryConfig, tracerProvider: BasicTracerProvider) {\n    this.tracerProvider = tracerProvider;\n    this.tracer = tracerProvider.getTracer(\"skaile-telemetry\");\n  }\n\n  /** Async factory — ensures the exporter is wired before any spans are created. */\n  static async create(config: TelemetryConfig): Promise<OtelTelemetryProvider> {\n    const resource = resourceFromAttributes({\n      \"service.name\": \"skaile-workspaces\",\n      \"service.version\": \"0.1.0\",\n    });\n\n    const spanProcessors = [];\n\n    if (config.endpoint) {\n      const exporter = await createOtlpExporter(config);\n      const processor = new BatchSpanProcessor(exporter, {\n        maxExportBatchSize: config.batchSize,\n        scheduledDelayMillis: config.exportIntervalMs,\n      });\n      spanProcessors.push(processor);\n    }\n\n    const tracerProvider = new BasicTracerProvider({ resource, spanProcessors });\n\n    return new OtelTelemetryProvider(config, tracerProvider);\n  }\n\n  startTrace(opts: TraceOptions): Trace {\n    const rootSpan = this.tracer.startSpan(opts.name, {\n      attributes: {\n        \"skaile.trace.kind\": opts.kind,\n        ...(opts.attributes ?? {}),\n      },\n    });\n\n    const spanContext = rootSpan.spanContext();\n    const traceId = spanContext.traceId;\n    const spanId = spanContext.spanId;\n\n    this.spanMap.set(spanId, rootSpan);\n\n    return {\n      traceId,\n      rootSpan: { spanId, traceId },\n    };\n  }\n\n  endTrace(traceObj: Trace, result?: SpanResult): void {\n    this.endSpan(traceObj.rootSpan, result);\n  }\n\n  startSpan(parent: Trace | Span, opts: SpanOptions): Span {\n    const parentSpanId = \"rootSpan\" in parent ? parent.rootSpan.spanId : parent.spanId;\n    const parentOtelSpan = this.spanMap.get(parentSpanId);\n    let childSpan: OtelSpan;\n\n    if (parentOtelSpan) {\n      const parentCtx = trace.setSpan(context.active(), parentOtelSpan);\n      childSpan = this.tracer.startSpan(\n        opts.name,\n        {\n          attributes: {\n            \"skaile.span.kind\": opts.kind,\n            ...(opts.attributes ?? {}),\n          },\n        },\n        parentCtx,\n      );\n    } else {\n      childSpan = this.tracer.startSpan(opts.name, {\n        attributes: {\n          \"skaile.span.kind\": opts.kind,\n          ...(opts.attributes ?? {}),\n        },\n      });\n    }\n\n    const spanContext = childSpan.spanContext();\n    this.spanMap.set(spanContext.spanId, childSpan);\n\n    return {\n      spanId: spanContext.spanId,\n      traceId: spanContext.traceId,\n    };\n  }\n\n  endSpan(span: Span, result?: SpanResult): void {\n    const otelSpan = this.spanMap.get(span.spanId);\n    if (!otelSpan) return;\n\n    if (result?.attributes) {\n      otelSpan.setAttributes(result.attributes);\n    }\n\n    if (result?.status === \"error\") {\n      otelSpan.setStatus({\n        code: SpanStatusCode.ERROR,\n        message: result.error,\n      });\n    } else {\n      otelSpan.setStatus({ code: SpanStatusCode.OK });\n    }\n\n    otelSpan.end();\n    this.spanMap.delete(span.spanId);\n  }\n\n  addEvent(span: Span, name: string, attrs?: Attributes): void {\n    const otelSpan = this.spanMap.get(span.spanId);\n    otelSpan?.addEvent(name, attrs);\n  }\n\n  logGeneration(span: Span, generation: GenerationEvent): void {\n    const otelSpan = this.spanMap.get(span.spanId);\n    if (!otelSpan) return;\n\n    const attrs = generationAttributes(generation);\n    otelSpan.setAttributes(attrs);\n    otelSpan.addEvent(\"gen_ai.generation\", attrs);\n  }\n\n  recordMetric(_name: string, _value: number, _tags?: Record<string, string>): void {\n    // Phase 2: wire to OTEL Metrics API when we add a metrics backend\n  }\n\n  async flush(): Promise<void> {\n    try {\n      await this.tracerProvider.forceFlush();\n    } catch {\n      // Swallow export errors (e.g. no collector running) — telemetry\n      // failures must never crash the agent.\n    }\n  }\n\n  async shutdown(): Promise<void> {\n    try {\n      await this.tracerProvider.shutdown();\n    } catch {\n      // Swallow export errors on shutdown.\n    }\n    this.spanMap.clear();\n  }\n}\n"]}

package/dist/resolver/index.js

@@ -0,0 +1,4 @@
+export { buildRequiresPreamble, parseCompactionDirectives, parseSkillFrontmatter, parseSkillRequirements, validateConnectorRequirements, validateFlowVersions, validateRequirements } from '../chunk-IPUYL6TD.js';
+import '../chunk-NSBPE2FW.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/resolver/index.js.map

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

package/dist/resolver/src/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./parser.js";
+export * from "./preamble.js";
+export * from "./types.js";
+export * from "./validator.js";
+export * from "./version.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/resolver/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../resolver/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC"}

package/dist/resolver/src/parser.d.ts

@@ -0,0 +1,47 @@
+import type { SkillRequirements } from "./types.js";
+/**
+ * Extract YAML frontmatter from a SKILL.md string.
+ *
+ * Frontmatter is delimited by leading `---` fences. Returns the parsed object,
+ * or an empty object `{}` if no frontmatter block is found or if the YAML is malformed.
+ * Errors are silently swallowed — callers should treat an empty result as "no requirements".
+ *
+ * @param content - Raw SKILL.md file content (full string, including `---` fences)
+ * @returns Parsed frontmatter object, or `{}` on absence or parse failure
+ *
+ * @docLink packages/resolver/api-reference#parseskill-frontmatter
+ */
+export declare function parseSkillFrontmatter(content: string): Record<string, any>;
+/**
+ * Parse skill requirements from raw SKILL.md content into a `SkillRequirements` object.
+ *
+ * Supports two frontmatter formats:
+ * 1. **New format** — `metadata.prerequisites` with explicit
+ *    `files`, `inputs_required`, `inputs_optional`, `reads`, `produces`, and `resources` arrays.
+ * 2. **Legacy format** — `metadata.user_inputs.dialog[]` array, automatically promoted to
+ *    `inputs_required` / `inputs_optional` based on each entry's `required` flag.
+ *
+ * Returns empty requirements `{ files: [], inputs_required: [], inputs_optional: [], reads: [], produces: [], resources: [] }`
+ * when no recognisable prerequisites section is found.
+ *
+ * @param content - Raw SKILL.md file content (full string, including `---` fences)
+ * @returns Structured `SkillRequirements` (never throws)
+ *
+ * @docLink packages/resolver/api-reference#parseskill-requirements
+ */
+export declare function parseSkillRequirements(content: string): SkillRequirements;
+/**
+ * Extract compaction directives from a SKILL.md markdown body.
+ *
+ * Scans the markdown body (not frontmatter) for a `## Compaction Directives` section
+ * and returns each bullet point as a trimmed string. Compaction directives are hints
+ * the agent uses to summarise context when the conversation history grows long.
+ * Returns an empty array when the section is absent.
+ *
+ * @param content - Raw SKILL.md file content (full string including frontmatter and body)
+ * @returns Array of directive strings extracted from the bullet list, or `[]` if none found
+ *
+ * @docLink packages/resolver/api-reference#parse-compaction-directives
+ */
+export declare function parseCompactionDirectives(content: string): string[];
+//# sourceMappingURL=parser.d.ts.map

package/dist/resolver/src/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../resolver/src/parser.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAoC,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEtF;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAQ1E;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAkEzE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAenE"}