@skenora/resources 0.1.2

package/README.md

@@ -0,0 +1,60 @@
+# @skenora/resources
+
+Provider-based resource discovery, policy, caching, integrity checks, and
+lifetime management for Skenora.
+
+```bash
+pnpm add @skenora/resources
+```
+
+Entry points:
+
+| Import                         | Purpose                                                  |
+| ------------------------------ | -------------------------------------------------------- |
+| `@skenora/resources`           | `ResourceManager`, provider contracts, discovery helpers |
+| `@skenora/resources/workspace` | workspace provider and shared resource context           |
+| `@skenora/resources/http`      | opt-in allowlisted HTTPS provider                        |
+| `@skenora/resources/memory`    | in-memory Blob resources                                 |
+
+Resource providers translate persistent locators into acquired bytes.
+`ResourceScope` owns temporary Blob URLs and must be disposed. Network loading
+is unavailable until the host explicitly installs and authorizes an HTTP or
+custom provider.
+
+See the [resource guide](https://github.com/zhangjiadi225/skenora/blob/main/docs/RESOURCES.md).
+
+## Scene-plan bindings and leases
+
+Scene-plan inputs use logical references. The host supplies an already
+authorized `ResourceBinding` and may validate it against the plan's kind,
+media type, and SHA-256 integrity requirement without performing I/O:
+
+```ts
+import {
+  createResourceBindingScope,
+  createResourceBindingTable,
+} from "@skenora/resources";
+
+const bindings = createResourceBindingTable(
+  [{ assetRef: "chair", asset: authorizedAsset }],
+  [{ assetRef: "chair", kind: "model" }],
+);
+const bindingScope = createResourceBindingScope(resources, bindings);
+const chair = bindingScope.acquire("chair");
+const resolved = await chair.resource;
+
+// Keep the lease until Runtime projection has completed.
+bindingScope.dispose();
+```
+
+`ModelVisibleResourceDescriptor` and
+`toModelVisibleResourceDescriptor()` expose only an opaque logical reference
+and safe metadata. They omit provider ids, sources, paths, URLs, thumbnails,
+credentials, and Blob URLs. The existing `ResourceDescriptor` remains
+available for trusted host/provider code for backward compatibility; callers
+must project it before returning data to a model.
+
+`ResourceBindingScope` creates one child `ResourceScope` per lease. Releasing
+a lease or disposing the binding scope delegates to the existing
+reference-counted cache and Blob URL cleanup. Authorization, downloads,
+imports, and workspace writes remain outside this package.

package/dist/http.d.ts

@@ -0,0 +1,2 @@
+export * from "./providers/http-provider.js";
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC"}

package/dist/http.js

@@ -0,0 +1,2 @@
+export * from "./providers/http-provider.js";
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./resource-manager.js";
+export * from "./resource-bindings.js";
+export * from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export * from "./resource-manager.js";
+export * from "./resource-bindings.js";
+export * from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,SAAS,CAAC"}

package/dist/memory.d.ts

@@ -0,0 +1,2 @@
+export * from "./providers/memory-provider.js";
+//# sourceMappingURL=memory.d.ts.map

package/dist/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../src/memory.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC"}

package/dist/memory.js

@@ -0,0 +1,2 @@
+export * from "./providers/memory-provider.js";
+//# sourceMappingURL=memory.js.map

package/dist/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../src/memory.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC"}

package/dist/providers/http-provider.d.ts

@@ -0,0 +1,22 @@
+import type { HttpResourceLocator, ResourceLocator } from "@skenora/contracts";
+import type { ResourceProvider, ResourceRequestContext, ResourceResponse } from "../types.js";
+export interface HttpResourceProviderOptions {
+    allowedOrigins?: Iterable<string>;
+    allowSameOrigin?: boolean;
+    allowRedirects?: boolean;
+    allowPrivateHosts?: boolean;
+    maxBytes?: number;
+    timeoutMs?: number;
+    credentials?: RequestCredentials;
+    headers?: (locator: Readonly<HttpResourceLocator>) => HeadersInit | Promise<HeadersInit>;
+    fetch?: typeof fetch;
+}
+export declare class HttpResourceProvider implements ResourceProvider {
+    #private;
+    readonly type = "http";
+    constructor(options?: HttpResourceProviderOptions);
+    canonicalize(locator: ResourceLocator): string;
+    open(locator: ResourceLocator, context: ResourceRequestContext): Promise<ResourceResponse>;
+    resolveRelative(base: ResourceLocator, relativeUri: string): HttpResourceLocator;
+}
+//# sourceMappingURL=http-provider.d.ts.map

package/dist/providers/http-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-provider.d.ts","sourceRoot":"","sources":["../../src/providers/http-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,KAAK,EACV,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,EACjB,MAAM,UAAU,CAAC;AAElB,MAAM,WAAW,2BAA2B;IAC1C,cAAc,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAClC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,OAAO,CAAC,EAAE,CACR,OAAO,EAAE,QAAQ,CAAC,mBAAmB,CAAC,KACnC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACxC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAED,qBAAa,oBAAqB,YAAW,gBAAgB;;IAC3D,QAAQ,CAAC,IAAI,UAAU;gBAWX,OAAO,GAAE,2BAAgC;IAoBrD,YAAY,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM;IAIxC,IAAI,CACR,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,gBAAgB,CAAC;IAqD5B,eAAe,CACb,IAAI,EAAE,eAAe,EACrB,WAAW,EAAE,MAAM,GAClB,mBAAmB;CAgCvB"}

package/dist/providers/http-provider.js

@@ -0,0 +1,157 @@
+export class HttpResourceProvider {
+    type = "http";
+    #allowedOrigins;
+    #allowSameOrigin;
+    #allowRedirects;
+    #allowPrivateHosts;
+    #maxBytes;
+    #timeoutMs;
+    #credentials;
+    #headers;
+    #fetch;
+    constructor(options = {}) {
+        this.#allowedOrigins = new Set([...(options.allowedOrigins ?? [])].map(normalizeOrigin));
+        this.#allowSameOrigin = options.allowSameOrigin ?? true;
+        this.#allowRedirects = options.allowRedirects ?? false;
+        this.#allowPrivateHosts = options.allowPrivateHosts ?? false;
+        this.#maxBytes = options.maxBytes ?? 100 * 1024 * 1024;
+        this.#timeoutMs = options.timeoutMs ?? 30_000;
+        this.#credentials = options.credentials ?? "omit";
+        this.#headers = options.headers;
+        this.#fetch = options.fetch ?? fetch;
+        if (!Number.isFinite(this.#maxBytes) || this.#maxBytes <= 0) {
+            throw new Error("HTTP resource maxBytes must be positive");
+        }
+        if (!Number.isFinite(this.#timeoutMs) || this.#timeoutMs <= 0) {
+            throw new Error("HTTP resource timeoutMs must be positive");
+        }
+    }
+    canonicalize(locator) {
+        return this.#assertAllowed(httpLocator(locator).url).href;
+    }
+    async open(locator, context) {
+        const input = httpLocator(locator);
+        const url = this.#assertAllowed(input.url);
+        const timeout = new AbortController();
+        const timeoutId = setTimeout(() => timeout.abort(), this.#timeoutMs);
+        const combined = combineSignals(context.signal, timeout.signal);
+        try {
+            const response = await this.#fetch(url, {
+                method: "GET",
+                mode: "cors",
+                credentials: this.#credentials,
+                redirect: this.#allowRedirects ? "follow" : "error",
+                signal: combined.signal,
+                ...(this.#headers ? { headers: await this.#headers(input) } : {}),
+            });
+            if (!response.ok) {
+                throw new Error(`HTTP resource request failed (${response.status}): ${url.href}`);
+            }
+            const finalUrl = this.#assertAllowed(response.url || url.href);
+            const declaredSize = Number(response.headers.get("content-length"));
+            if (Number.isFinite(declaredSize) && declaredSize > this.#maxBytes) {
+                throw new Error(`HTTP resource exceeds maxBytes: ${declaredSize}`);
+            }
+            const blob = await response.blob();
+            if (blob.size > this.#maxBytes) {
+                throw new Error(`HTTP resource exceeds maxBytes: ${blob.size}`);
+            }
+            const name = decodeURIComponent(finalUrl.pathname.split("/").at(-1) || "resource");
+            const mediaType = response.headers.get("content-type")?.split(";", 1)[0];
+            return {
+                blob,
+                name,
+                resolvedLocator: { type: "http", url: finalUrl.href },
+                ...(mediaType ? { mediaType } : {}),
+            };
+        }
+        catch (error) {
+            if (timeout.signal.aborted && !context.signal.aborted) {
+                throw new DOMException("HTTP resource request timed out", "TimeoutError");
+            }
+            throw error;
+        }
+        finally {
+            clearTimeout(timeoutId);
+            combined.dispose();
+        }
+    }
+    resolveRelative(base, relativeUri) {
+        const resolved = new URL(relativeUri, this.#assertAllowed(httpLocator(base).url));
+        this.#assertAllowed(resolved.href);
+        return { type: "http", url: resolved.href };
+    }
+    #assertAllowed(input) {
+        let url;
+        try {
+            url = new URL(input);
+        }
+        catch {
+            throw new Error(`HTTP resource URL is invalid: ${input}`);
+        }
+        if (url.protocol !== "https:") {
+            throw new Error(`HTTP resource URL must use HTTPS: ${url.href}`);
+        }
+        if (!this.#allowPrivateHosts && isPrivateHostname(url.hostname)) {
+            throw new Error(`HTTP resource host is private: ${url.hostname}`);
+        }
+        const sameOrigin = this.#allowSameOrigin &&
+            typeof location !== "undefined" &&
+            url.origin === location.origin;
+        if (!sameOrigin && !this.#allowedOrigins.has(url.origin)) {
+            throw new Error(`HTTP resource origin is not allowed: ${url.origin}`);
+        }
+        url.hash = "";
+        return url;
+    }
+}
+function combineSignals(first, second) {
+    const controller = new AbortController();
+    const abort = () => controller.abort();
+    if (first.aborted || second.aborted)
+        controller.abort();
+    else {
+        first.addEventListener("abort", abort, { once: true });
+        second.addEventListener("abort", abort, { once: true });
+    }
+    return {
+        signal: controller.signal,
+        dispose() {
+            first.removeEventListener("abort", abort);
+            second.removeEventListener("abort", abort);
+        },
+    };
+}
+function httpLocator(locator) {
+    if (locator.type !== "http") {
+        throw new Error(`HTTP provider cannot resolve: ${locator.type}`);
+    }
+    return locator;
+}
+function normalizeOrigin(value) {
+    const url = new URL(value);
+    if (url.protocol !== "https:") {
+        throw new Error(`Allowed resource origin must use HTTPS: ${value}`);
+    }
+    return url.origin;
+}
+function isPrivateHostname(hostname) {
+    const value = hostname.replace(/^\[|\]$/gu, "").toLowerCase();
+    if (value === "localhost" ||
+        value === "::1" ||
+        value.endsWith(".localhost") ||
+        value.endsWith(".local")) {
+        return true;
+    }
+    const parts = value.split(".").map(Number);
+    if (parts.length !== 4 || parts.some((part) => !Number.isInteger(part))) {
+        return false;
+    }
+    const [a = -1, b = -1] = parts;
+    return (a === 10 ||
+        a === 127 ||
+        (a === 169 && b === 254) ||
+        (a === 172 && b >= 16 && b <= 31) ||
+        (a === 192 && b === 168));
+}
+//# sourceMappingURL=http-provider.js.map

package/dist/providers/http-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-provider.js","sourceRoot":"","sources":["../../src/providers/http-provider.ts"],"names":[],"mappings":"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"}

package/dist/providers/memory-provider.d.ts

@@ -0,0 +1,19 @@
+import type { MemoryResourceLocator, ResourceLocator } from "@skenora/contracts";
+import type { ResourceDescriptor, ResourceProvider, ResourceRequestContext, ResourceResponse, ResourceSearchPage, ResourceSearchQuery } from "../types.js";
+export interface MemoryResourceEntry {
+    blob: Blob;
+    descriptor: Omit<ResourceDescriptor, "source">;
+}
+export declare class MemoryResourceProvider implements ResourceProvider {
+    #private;
+    readonly type = "memory";
+    constructor(entries?: Readonly<Record<string, MemoryResourceEntry>>);
+    set(key: string, entry: MemoryResourceEntry): void;
+    delete(key: string): boolean;
+    canonicalize(locator: ResourceLocator): string;
+    open(locator: ResourceLocator, context: ResourceRequestContext): Promise<ResourceResponse>;
+    resolveRelative(base: ResourceLocator, relativeUri: string): MemoryResourceLocator;
+    search(query: ResourceSearchQuery, context: ResourceRequestContext): Promise<ResourceSearchPage>;
+    describe(locator: ResourceLocator, context: ResourceRequestContext): Promise<ResourceDescriptor>;
+}
+//# sourceMappingURL=memory-provider.d.ts.map

package/dist/providers/memory-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-provider.d.ts","sourceRoot":"","sources":["../../src/providers/memory-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,eAAe,EAChB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EACV,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,UAAU,CAAC;AAElB,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,IAAI,CAAC;IACX,UAAU,EAAE,IAAI,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAC;CAChD;AAED,qBAAa,sBAAuB,YAAW,gBAAgB;;IAC7D,QAAQ,CAAC,IAAI,YAAY;gBAGb,OAAO,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAM;IAIvE,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,GAAG,IAAI;IAQlD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B,YAAY,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM;IAIxC,IAAI,CACR,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,gBAAgB,CAAC;IAc5B,eAAe,CACb,IAAI,EAAE,eAAe,EACrB,WAAW,EAAE,MAAM,GAClB,qBAAqB;IAyBlB,MAAM,CACV,KAAK,EAAE,mBAAmB,EAC1B,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,kBAAkB,CAAC;IA4BxB,QAAQ,CACZ,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,kBAAkB,CAAC;CAO/B"}

package/dist/providers/memory-provider.js

@@ -0,0 +1,131 @@
+export class MemoryResourceProvider {
+    type = "memory";
+    #entries = new Map();
+    constructor(entries = {}) {
+        for (const [key, entry] of Object.entries(entries))
+            this.set(key, entry);
+    }
+    set(key, entry) {
+        const normalized = normalizeKey(key);
+        this.#entries.set(normalized, {
+            blob: entry.blob,
+            descriptor: structuredClone(entry.descriptor),
+        });
+    }
+    delete(key) {
+        return this.#entries.delete(normalizeKey(key));
+    }
+    canonicalize(locator) {
+        return normalizeKey(memoryLocator(locator).key);
+    }
+    async open(locator, context) {
+        throwIfAborted(context.signal);
+        const key = normalizeKey(memoryLocator(locator).key);
+        const entry = this.#entries.get(key);
+        if (!entry)
+            throw new Error(`Memory resource not found: ${key}`);
+        return {
+            blob: entry.blob,
+            name: key.split("/").at(-1) ?? entry.descriptor.label,
+            ...(entry.descriptor.mediaType
+                ? { mediaType: entry.descriptor.mediaType }
+                : {}),
+        };
+    }
+    resolveRelative(base, relativeUri) {
+        const baseKey = memoryLocator(base).key;
+        const relative = decodeRelativeUri(relativeUri);
+        if (/^[a-z][a-z\d+.-]*:/iu.test(relative) || relative.startsWith("/")) {
+            throw new Error(`Memory resource reference must be relative: ${relativeUri}`);
+        }
+        const segments = baseKey.split("/").slice(0, -1);
+        for (const segment of relative.split("/")) {
+            if (!segment || segment === ".")
+                continue;
+            if (segment === "..") {
+                if (segments.length === 0) {
+                    throw new Error(`Memory resource reference escapes its root: ${relativeUri}`);
+                }
+                segments.pop();
+            }
+            else {
+                segments.push(segment);
+            }
+        }
+        return { type: "memory", key: normalizeKey(segments.join("/")) };
+    }
+    async search(query, context) {
+        throwIfAborted(context.signal);
+        const text = query.query?.trim().toLowerCase() ?? "";
+        const tags = query.tags?.map((tag) => tag.toLowerCase()) ?? [];
+        const items = [...this.#entries.entries()]
+            .flatMap(([key, entry]) => {
+            const descriptor = entry.descriptor;
+            if (query.kind && descriptor.kind !== query.kind)
+                return [];
+            const haystack = [
+                descriptor.label,
+                descriptor.description ?? "",
+                ...(descriptor.tags ?? []),
+            ]
+                .join(" ")
+                .toLowerCase();
+            if (text &&
+                !text.split(/\s+/u).every((term) => haystack.includes(term))) {
+                return [];
+            }
+            if (!tags.every((tag) => haystack.includes(tag)))
+                return [];
+            return [withSource(key, descriptor)];
+        })
+            .slice(0, query.limit ?? 20);
+        return { items };
+    }
+    async describe(locator, context) {
+        throwIfAborted(context.signal);
+        const key = normalizeKey(memoryLocator(locator).key);
+        const entry = this.#entries.get(key);
+        if (!entry)
+            throw new Error(`Memory resource not found: ${key}`);
+        return withSource(key, entry.descriptor);
+    }
+}
+function decodeRelativeUri(uri) {
+    const path = uri.split(/[?#]/u, 1)[0] ?? uri;
+    try {
+        return decodeURIComponent(path);
+    }
+    catch {
+        return path;
+    }
+}
+function withSource(key, descriptor) {
+    return {
+        ...structuredClone(descriptor),
+        source: { type: "memory", key },
+    };
+}
+function memoryLocator(locator) {
+    if (locator.type !== "memory") {
+        throw new Error(`Memory provider cannot resolve: ${locator.type}`);
+    }
+    return locator;
+}
+function normalizeKey(key) {
+    const normalized = key.replaceAll("\\", "/").replace(/^\.\//u, "");
+    if (!normalized ||
+        normalized.startsWith("/") ||
+        normalized.includes("\0") ||
+        normalized
+            .split("/")
+            .some((segment) => !segment || segment === "." || segment === "..")) {
+        throw new Error(`Memory resource key is invalid: ${key}`);
+    }
+    return normalized;
+}
+function throwIfAborted(signal) {
+    if (signal.aborted) {
+        throw new DOMException("Memory resource request was aborted", "AbortError");
+    }
+}
+//# sourceMappingURL=memory-provider.js.map

package/dist/providers/memory-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-provider.js","sourceRoot":"","sources":["../../src/providers/memory-provider.ts"],"names":[],"mappings":"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"}

package/dist/providers/workspace-provider.d.ts

@@ -0,0 +1,14 @@
+import type { ResourceLocator, WorkspaceResourceLocator } from "@skenora/contracts";
+import { type WorkspaceSource } from "@skenora/workspace";
+import type { ResourceDescriptor, ResourceProvider, ResourceRequestContext, ResourceResponse, ResourceSearchPage, ResourceSearchQuery } from "../types.js";
+export declare class WorkspaceResourceProvider implements ResourceProvider {
+    readonly type = "workspace";
+    readonly source: WorkspaceSource;
+    constructor(source: WorkspaceSource);
+    canonicalize(locator: ResourceLocator): string;
+    open(locator: ResourceLocator, context: ResourceRequestContext): Promise<ResourceResponse>;
+    resolveRelative(base: ResourceLocator, relativeUri: string): WorkspaceResourceLocator;
+    search(query: ResourceSearchQuery, context: ResourceRequestContext): Promise<ResourceSearchPage>;
+    describe(locator: ResourceLocator, context: ResourceRequestContext): Promise<ResourceDescriptor>;
+}
+//# sourceMappingURL=workspace-provider.d.ts.map

package/dist/providers/workspace-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-provider.d.ts","sourceRoot":"","sources":["../../src/providers/workspace-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,wBAAwB,EACzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EACV,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,UAAU,CAAC;AAElB,qBAAa,yBAA0B,YAAW,gBAAgB;IAChE,QAAQ,CAAC,IAAI,eAAe;IAC5B,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;gBAErB,MAAM,EAAE,eAAe;IAInC,YAAY,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM;IAIxC,IAAI,CACR,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,gBAAgB,CAAC;IAY5B,eAAe,CACb,IAAI,EAAE,eAAe,EACrB,WAAW,EAAE,MAAM,GAClB,wBAAwB;IAUrB,MAAM,CACV,KAAK,EAAE,mBAAmB,EAC1B,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,kBAAkB,CAAC;IA6CxB,QAAQ,CACZ,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,kBAAkB,CAAC;CAoB/B"}

package/dist/providers/workspace-provider.js

@@ -0,0 +1,126 @@
+import { inferAssetKind, normalizeWorkspacePath, resolveWorkspaceRelativePath, } from "@skenora/workspace";
+export class WorkspaceResourceProvider {
+    type = "workspace";
+    source;
+    constructor(source) {
+        this.source = source;
+    }
+    canonicalize(locator) {
+        return normalizeWorkspacePath(workspaceLocator(locator).path);
+    }
+    async open(locator, context) {
+        throwIfAborted(context.signal);
+        const path = normalizeWorkspacePath(workspaceLocator(locator).path);
+        const file = await this.source.read(path);
+        throwIfAborted(context.signal);
+        return {
+            blob: file,
+            name: file.name || path.split("/").at(-1) || path,
+            ...(file.type ? { mediaType: file.type } : {}),
+        };
+    }
+    resolveRelative(base, relativeUri) {
+        return {
+            type: "workspace",
+            path: resolveWorkspaceRelativePath(workspaceLocator(base).path, decodeRelativeUri(relativeUri)),
+        };
+    }
+    async search(query, context) {
+        throwIfAborted(context.signal);
+        const text = query.query?.trim().toLowerCase() ?? "";
+        const tags = query.tags?.map((tag) => tag.toLowerCase()) ?? [];
+        const offset = parseCursor(query.cursor);
+        const limit = query.limit ?? 20;
+        const entries = (await this.source.list()).filter((entry) => {
+            if (entry.kind !== "file")
+                return false;
+            const kind = inferAssetKind(entry.path);
+            if (!kind || (query.kind && kind !== query.kind))
+                return false;
+            const haystack = entry.path.toLowerCase();
+            return ((!text ||
+                text.split(/\s+/u).every((term) => haystack.includes(term))) &&
+                tags.every((tag) => haystack.includes(tag)));
+        });
+        throwIfAborted(context.signal);
+        const slice = entries.slice(offset, offset + limit);
+        const items = slice.flatMap((entry) => {
+            const kind = inferAssetKind(entry.path);
+            if (!kind)
+                return [];
+            return [
+                {
+                    id: `workspace:${entry.path}`,
+                    label: entry.name,
+                    kind,
+                    source: { type: "workspace", path: entry.path },
+                    tags: entry.path.split("/").slice(0, -1),
+                    technical: {
+                        format: extensionOf(entry.path),
+                        ...(entry.size === undefined ? {} : { size: entry.size }),
+                    },
+                },
+            ];
+        });
+        const nextOffset = offset + slice.length;
+        return {
+            items,
+            ...(nextOffset < entries.length
+                ? { nextCursor: String(nextOffset) }
+                : {}),
+        };
+    }
+    async describe(locator, context) {
+        throwIfAborted(context.signal);
+        const path = normalizeWorkspacePath(workspaceLocator(locator).path);
+        const kind = inferAssetKind(path);
+        if (!(await this.source.has(path)) || !kind) {
+            throw new Error(`Workspace resource not found or unsupported: ${path}`);
+        }
+        const file = await this.source.read(path);
+        return {
+            id: `workspace:${path}`,
+            label: file.name || path.split("/").at(-1) || path,
+            kind,
+            source: { type: "workspace", path },
+            tags: path.split("/").slice(0, -1),
+            technical: {
+                format: extensionOf(path),
+                size: file.size,
+            },
+        };
+    }
+}
+function workspaceLocator(locator) {
+    if (locator.type !== "workspace") {
+        throw new Error(`Workspace provider cannot resolve: ${locator.type}`);
+    }
+    return locator;
+}
+function decodeRelativeUri(uri) {
+    const path = uri.split(/[?#]/u, 1)[0] ?? uri;
+    try {
+        return decodeURIComponent(path);
+    }
+    catch {
+        return path;
+    }
+}
+function extensionOf(path) {
+    return path.split(".").at(-1)?.toLowerCase() ?? "";
+}
+function parseCursor(cursor) {
+    if (cursor === undefined)
+        return 0;
+    const value = Number(cursor);
+    if (!Number.isInteger(value) || value < 0) {
+        throw new Error("Workspace resource cursor is invalid");
+    }
+    return value;
+}
+function throwIfAborted(signal) {
+    if (signal.aborted) {
+        throw new DOMException("Workspace resource request was aborted", "AbortError");
+    }
+}
+//# sourceMappingURL=workspace-provider.js.map

package/dist/providers/workspace-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-provider.js","sourceRoot":"","sources":["../../src/providers/workspace-provider.ts"],"names":[],"mappings":"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"}