@struktoai/mirage-node 0.0.5 → 0.0.6

package/dist/resource/gridfs/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../src/resource/gridfs/prompt.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,aAAa,kaAI2C,CAAA"}

package/dist/resource/gridfs/prompt.js

@@ -0,0 +1,19 @@
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+export const GRIDFS_PROMPT = `{prefix}
+  Remote MongoDB GridFS bucket. Maps GridFS filenames to virtual paths.
+  IMPORTANT: This is a remote mount. Prefer targeted reads (grep, head) over full scans. Avoid cat on large files without piping to head/tail.
+  find pushes -name/-type/-size filters into the fs.files query server-side, so find is cheap even on large buckets.
+  Supports: ls, cat, head, tail, grep, rg, wc, find, tree, jq, stat.`;
+//# sourceMappingURL=prompt.js.map

package/dist/resource/gridfs/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../src/resource/gridfs/prompt.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,uEAAuE;AAEvE,MAAM,CAAC,MAAM,aAAa,GAAG;;;;qEAIwC,CAAA"}

package/dist/resource/gsheets/gsheets.d.ts

@@ -0,0 +1,32 @@
+import { GSheetsAccessor } from '@struktoai/mirage-core/accessor/gsheets';
+import type { RegisteredCommand } from '@struktoai/mirage-core/commands/config';
+import type { RegisteredOp } from '@struktoai/mirage-core/ops/registry';
+import { BaseResource } from '@struktoai/mirage-core/resource/base';
+import type { Resource } from '@struktoai/mirage-core/resource/base';
+import { PathSpec } from '@struktoai/mirage-core/types';
+import type { FileStat } from '@struktoai/mirage-core/types';
+import { type GSheetsConfig, type GSheetsConfigRedacted } from '@struktoai/mirage-core/resource/gsheets/config';
+export interface GSheetsResourceState {
+    type: string;
+    config: GSheetsConfigRedacted;
+}
+export declare class GSheetsResource extends BaseResource implements Resource {
+    readonly kind: string;
+    readonly cachesReads: boolean;
+    readonly indexTtl: number;
+    readonly prompt: string;
+    readonly writePrompt: string;
+    readonly config: GSheetsConfig;
+    readonly accessor: GSheetsAccessor;
+    constructor(config: GSheetsConfig);
+    open(): Promise<void>;
+    commands(): readonly RegisteredCommand[];
+    ops(): readonly RegisteredOp[];
+    readFile(p: PathSpec): Promise<Uint8Array>;
+    readdir(p: PathSpec): Promise<string[]>;
+    stat(p: PathSpec): Promise<FileStat>;
+    glob(paths: readonly PathSpec[], prefix?: string): Promise<PathSpec[]>;
+    getState(): Promise<GSheetsResourceState>;
+    loadState(_state: GSheetsResourceState): Promise<void>;
+}
+//# sourceMappingURL=gsheets.d.ts.map

package/dist/resource/gsheets/gsheets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gsheets.d.ts","sourceRoot":"","sources":["../../../src/resource/gsheets/gsheets.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAA;AAGzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAA;AAM/E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAA;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAA;AACnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAA;AAKpE,OAAO,EAAE,QAAQ,EAAgB,MAAM,8BAA8B,CAAA;AACrE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAE5D,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC3B,MAAM,gDAAgD,CAAA;AAIvD,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,qBAAqB,CAAA;CAC9B;AAED,qBAAa,eAAgB,SAAQ,YAAa,YAAW,QAAQ;IACnE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAuB;IAC5C,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAO;IACpC,SAAkB,QAAQ,EAAE,MAAM,CAAS;IAC3C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAiB;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAuB;IACnD,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;IAC9B,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAA;gBAEtB,MAAM,EAAE,aAAa;IAOjC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,QAAQ,IAAI,SAAS,iBAAiB,EAAE;IAIxC,GAAG,IAAI,SAAS,YAAY,EAAE;IAI9B,QAAQ,CAAC,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC;IAI1C,OAAO,CAAC,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAIvC,IAAI,CAAC,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIpC,IAAI,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,EAAE,MAAM,SAAK,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAkBzD,QAAQ,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAOzC,SAAS,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;CAGhE"}

package/dist/resource/gsheets/gsheets.js

@@ -0,0 +1,84 @@
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+import { GSheetsAccessor } from '@struktoai/mirage-core/accessor/gsheets';
+import { makeResolveGlob } from '@struktoai/mirage-core/commands/builtin/generic_bind/index';
+import { GSHEETS_COMMANDS } from '@struktoai/mirage-core/commands/builtin/gsheets/index';
+import { TokenManager } from '@struktoai/mirage-core/core/google/client';
+import { read as gsheetsRead } from '@struktoai/mirage-core/core/gsheets/read';
+import { readdir as gsheetsReaddir } from '@struktoai/mirage-core/core/gsheets/readdir';
+import { stat as gsheetsStat } from '@struktoai/mirage-core/core/gsheets/stat';
+import { GSHEETS_OPS } from '@struktoai/mirage-core/ops/gsheets/index';
+import { BaseResource } from '@struktoai/mirage-core/resource/base';
+import { GSHEETS_PROMPT, GSHEETS_WRITE_PROMPT, } from '@struktoai/mirage-core/resource/gsheets/prompt';
+import { PathSpec, ResourceName } from '@struktoai/mirage-core/types';
+import { mountKey, mountPrefixOf } from '@struktoai/mirage-core/utils/key_prefix';
+import { redactGSheetsConfig, } from '@struktoai/mirage-core/resource/gsheets/config';
+const gsheetsResolveGlob = makeResolveGlob(gsheetsReaddir);
+export class GSheetsResource extends BaseResource {
+    kind = ResourceName.GSHEETS;
+    cachesReads = true;
+    indexTtl = 86_400;
+    prompt = GSHEETS_PROMPT;
+    writePrompt = GSHEETS_WRITE_PROMPT;
+    config;
+    accessor;
+    constructor(config) {
+        super();
+        this.config = config;
+        const tm = new TokenManager(config);
+        this.accessor = new GSheetsAccessor({ tokenManager: tm });
+    }
+    open() {
+        return Promise.resolve();
+    }
+    commands() {
+        return GSHEETS_COMMANDS;
+    }
+    ops() {
+        return GSHEETS_OPS;
+    }
+    readFile(p) {
+        return gsheetsRead(this.accessor, p, this.index);
+    }
+    readdir(p) {
+        return gsheetsReaddir(this.accessor, p, this.index);
+    }
+    stat(p) {
+        return gsheetsStat(this.accessor, p, this.index);
+    }
+    glob(paths, prefix = '') {
+        const effective = prefix !== ''
+            ? paths.map((p) => mountPrefixOf(p.virtual, p.resourcePath) !== ''
+                ? p
+                : new PathSpec({
+                    virtual: p.virtual,
+                    directory: p.directory,
+                    ...(p.pattern !== null ? { pattern: p.pattern } : {}),
+                    resolved: p.resolved,
+                    resourcePath: mountKey(p.virtual, prefix),
+                }))
+            : paths;
+        return gsheetsResolveGlob(this.accessor, effective, this.index);
+    }
+    getState() {
+        return Promise.resolve({
+            type: this.kind,
+            config: redactGSheetsConfig(this.config),
+        });
+    }
+    loadState(_state) {
+        return Promise.resolve();
+    }
+}
+//# sourceMappingURL=gsheets.js.map

package/dist/resource/gsheets/gsheets.js.map

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

package/dist/resource/gslides/gslides.d.ts

@@ -0,0 +1,32 @@
+import { GSlidesAccessor } from '@struktoai/mirage-core/accessor/gslides';
+import type { RegisteredCommand } from '@struktoai/mirage-core/commands/config';
+import type { RegisteredOp } from '@struktoai/mirage-core/ops/registry';
+import { BaseResource } from '@struktoai/mirage-core/resource/base';
+import type { Resource } from '@struktoai/mirage-core/resource/base';
+import { PathSpec } from '@struktoai/mirage-core/types';
+import type { FileStat } from '@struktoai/mirage-core/types';
+import { type GSlidesConfig, type GSlidesConfigRedacted } from '@struktoai/mirage-core/resource/gslides/config';
+export interface GSlidesResourceState {
+    type: string;
+    config: GSlidesConfigRedacted;
+}
+export declare class GSlidesResource extends BaseResource implements Resource {
+    readonly kind: string;
+    readonly cachesReads: boolean;
+    readonly indexTtl: number;
+    readonly prompt: string;
+    readonly writePrompt: string;
+    readonly config: GSlidesConfig;
+    readonly accessor: GSlidesAccessor;
+    constructor(config: GSlidesConfig);
+    open(): Promise<void>;
+    commands(): readonly RegisteredCommand[];
+    ops(): readonly RegisteredOp[];
+    readFile(p: PathSpec): Promise<Uint8Array>;
+    readdir(p: PathSpec): Promise<string[]>;
+    stat(p: PathSpec): Promise<FileStat>;
+    glob(paths: readonly PathSpec[], prefix?: string): Promise<PathSpec[]>;
+    getState(): Promise<GSlidesResourceState>;
+    loadState(_state: GSlidesResourceState): Promise<void>;
+}
+//# sourceMappingURL=gslides.d.ts.map

package/dist/resource/gslides/gslides.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gslides.d.ts","sourceRoot":"","sources":["../../../src/resource/gslides/gslides.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAA;AAGzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAA;AAM/E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAA;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAA;AACnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAA;AAKpE,OAAO,EAAE,QAAQ,EAAgB,MAAM,8BAA8B,CAAA;AACrE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAE5D,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC3B,MAAM,gDAAgD,CAAA;AAIvD,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,qBAAqB,CAAA;CAC9B;AAED,qBAAa,eAAgB,SAAQ,YAAa,YAAW,QAAQ;IACnE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAuB;IAC5C,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAO;IACpC,SAAkB,QAAQ,EAAE,MAAM,CAAS;IAC3C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAiB;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAuB;IACnD,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;IAC9B,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAA;gBAEtB,MAAM,EAAE,aAAa;IAOjC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,QAAQ,IAAI,SAAS,iBAAiB,EAAE;IAIxC,GAAG,IAAI,SAAS,YAAY,EAAE;IAI9B,QAAQ,CAAC,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC;IAI1C,OAAO,CAAC,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAIvC,IAAI,CAAC,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIpC,IAAI,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,EAAE,MAAM,SAAK,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAkBzD,QAAQ,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAOzC,SAAS,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;CAGhE"}

package/dist/resource/gslides/gslides.js

@@ -0,0 +1,84 @@
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+import { GSlidesAccessor } from '@struktoai/mirage-core/accessor/gslides';
+import { makeResolveGlob } from '@struktoai/mirage-core/commands/builtin/generic_bind/index';
+import { GSLIDES_COMMANDS } from '@struktoai/mirage-core/commands/builtin/gslides/index';
+import { TokenManager } from '@struktoai/mirage-core/core/google/client';
+import { read as gslidesRead } from '@struktoai/mirage-core/core/gslides/read';
+import { readdir as gslidesReaddir } from '@struktoai/mirage-core/core/gslides/readdir';
+import { stat as gslidesStat } from '@struktoai/mirage-core/core/gslides/stat';
+import { GSLIDES_OPS } from '@struktoai/mirage-core/ops/gslides/index';
+import { BaseResource } from '@struktoai/mirage-core/resource/base';
+import { GSLIDES_PROMPT, GSLIDES_WRITE_PROMPT, } from '@struktoai/mirage-core/resource/gslides/prompt';
+import { PathSpec, ResourceName } from '@struktoai/mirage-core/types';
+import { mountKey, mountPrefixOf } from '@struktoai/mirage-core/utils/key_prefix';
+import { redactGSlidesConfig, } from '@struktoai/mirage-core/resource/gslides/config';
+const gslidesResolveGlob = makeResolveGlob(gslidesReaddir);
+export class GSlidesResource extends BaseResource {
+    kind = ResourceName.GSLIDES;
+    cachesReads = true;
+    indexTtl = 86_400;
+    prompt = GSLIDES_PROMPT;
+    writePrompt = GSLIDES_WRITE_PROMPT;
+    config;
+    accessor;
+    constructor(config) {
+        super();
+        this.config = config;
+        const tm = new TokenManager(config);
+        this.accessor = new GSlidesAccessor({ tokenManager: tm });
+    }
+    open() {
+        return Promise.resolve();
+    }
+    commands() {
+        return GSLIDES_COMMANDS;
+    }
+    ops() {
+        return GSLIDES_OPS;
+    }
+    readFile(p) {
+        return gslidesRead(this.accessor, p, this.index);
+    }
+    readdir(p) {
+        return gslidesReaddir(this.accessor, p, this.index);
+    }
+    stat(p) {
+        return gslidesStat(this.accessor, p, this.index);
+    }
+    glob(paths, prefix = '') {
+        const effective = prefix !== ''
+            ? paths.map((p) => mountPrefixOf(p.virtual, p.resourcePath) !== ''
+                ? p
+                : new PathSpec({
+                    virtual: p.virtual,
+                    directory: p.directory,
+                    ...(p.pattern !== null ? { pattern: p.pattern } : {}),
+                    resolved: p.resolved,
+                    resourcePath: mountKey(p.virtual, prefix),
+                }))
+            : paths;
+        return gslidesResolveGlob(this.accessor, effective, this.index);
+    }
+    getState() {
+        return Promise.resolve({
+            type: this.kind,
+            config: redactGSlidesConfig(this.config),
+        });
+    }
+    loadState(_state) {
+        return Promise.resolve();
+    }
+}
+//# sourceMappingURL=gslides.js.map

package/dist/resource/gslides/gslides.js.map

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

package/dist/resource/hf_buckets/base.d.ts

@@ -0,0 +1,34 @@
+import type { RegisteredCommand } from '@struktoai/mirage-core/commands/config';
+import type { RegisteredOp } from '@struktoai/mirage-core/ops/registry';
+import { BaseResource } from '@struktoai/mirage-core/resource/base';
+import type { FindOptions, Resource, ResourceStateBase } from '@struktoai/mirage-core/resource/base';
+import { PathSpec } from '@struktoai/mirage-core/types';
+import type { FileStat } from '@struktoai/mirage-core/types';
+import type { HfAccessor } from '../../accessor/hf.ts';
+import { type DeltaHook } from '@struktoai/mirage-core/watch/index';
+export declare abstract class HfResource extends BaseResource implements Resource {
+    abstract readonly prompt: string;
+    abstract readonly accessor: HfAccessor;
+    abstract getState(): Promise<ResourceStateBase>;
+    readonly cachesReads: boolean;
+    readonly sizesAlwaysKnown: boolean;
+    readonly supportsSnapshot: boolean;
+    readonly opsMap: Record<string, unknown>;
+    open(): Promise<void>;
+    commands(): readonly RegisteredCommand[];
+    ops(): readonly RegisteredOp[];
+    streamPath(p: PathSpec): AsyncIterable<Uint8Array>;
+    readFile(p: PathSpec): Promise<Uint8Array>;
+    writeFile(p: PathSpec, data: Uint8Array): Promise<void>;
+    readdir(p: PathSpec): Promise<string[]>;
+    stat(p: PathSpec): Promise<FileStat>;
+    exists(p: PathSpec): Promise<boolean>;
+    mkdir(p: PathSpec): Promise<void>;
+    unlink(p: PathSpec): Promise<void>;
+    du(p: PathSpec): Promise<number>;
+    find(p: PathSpec, options?: FindOptions): Promise<string[]>;
+    deltaHook(): DeltaHook;
+    glob(paths: readonly PathSpec[], prefix?: string): Promise<PathSpec[]>;
+    loadState(_state: unknown): Promise<void>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/resource/hf_buckets/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/resource/hf_buckets/base.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAA;AAC/E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAA;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAA;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAA;AACpG,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAE5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAetD,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,oCAAoC,CAAA;AAKnE,8BAAsB,UAAW,SAAQ,YAAa,YAAW,QAAQ;IACvE,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAA;aAMpB,QAAQ,IAAI,OAAO,CAAC,iBAAiB,CAAC;IACxD,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAO;IAIpC,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAO;IACzC,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAO;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAcvC;IAED,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,QAAQ,IAAI,SAAS,iBAAiB,EAAE;IAIxC,GAAG,IAAI,SAAS,YAAY,EAAE;IAI9B,UAAU,CAAC,CAAC,EAAE,QAAQ,GAAG,aAAa,CAAC,UAAU,CAAC;IAIlD,QAAQ,CAAC,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC;IAI1C,SAAS,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvD,OAAO,CAAC,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAIvC,IAAI,CAAC,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIpC,MAAM,CAAC,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;IAIrC,KAAK,CAAC,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjC,MAAM,CAAC,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlC,EAAE,CAAC,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC;IAIhC,IAAI,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAI/D,SAAS,IAAI,SAAS;IAItB,IAAI,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,EAAE,MAAM,SAAK,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAiBzD,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAGnD"}

package/dist/resource/hf_buckets/base.js

@@ -0,0 +1,117 @@
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+import { makeResolveGlob } from '@struktoai/mirage-core/commands/builtin/generic_bind/index';
+import { BaseResource } from '@struktoai/mirage-core/resource/base';
+import { PathSpec } from '@struktoai/mirage-core/types';
+import { mountKey, mountPrefixOf } from '@struktoai/mirage-core/utils/key_prefix';
+import { HF_COMMANDS } from "../../commands/builtin/hf/index.js";
+import { SCOPE_ERROR } from "../../core/hf/constants.js";
+import { create as createCore } from "../../core/hf/create.js";
+import { size as duSizeCore, entries as duEntriesCore } from "../../core/hf/du/index.js";
+import { exists as existsCore } from "../../core/hf/exists.js";
+import { find as findCore } from "../../core/hf/find.js";
+import { mkdir as mkdirCore } from "../../core/hf/mkdir.js";
+import { read as readCore } from "../../core/hf/read.js";
+import { readdir as readdirCore } from "../../core/hf/readdir.js";
+import { stat as statCore } from "../../core/hf/stat.js";
+import { rangeRead as rangeReadCore, stream as streamCore } from "../../core/hf/stream.js";
+import { unlink as unlinkCore } from "../../core/hf/unlink.js";
+import { write as writeCore } from "../../core/hf/write.js";
+import { HF_OPS } from "../../ops/hf/index.js";
+import {} from '@struktoai/mirage-core/watch/index';
+import { buildDeltaHook } from "../../core/hf/watch.js";
+const globCore = makeResolveGlob(readdirCore, SCOPE_ERROR);
+export class HfResource extends BaseResource {
+    cachesReads = true;
+    // The Hub tree API reports each file's exact byte size (the LFS
+    // object size for LFS files); readdir backfills any lister-omitted
+    // size with one stat.
+    sizesAlwaysKnown = true;
+    supportsSnapshot = true;
+    opsMap = {
+        read_bytes: readCore,
+        readdir: readdirCore,
+        stat: statCore,
+        read_stream: streamCore,
+        range_read: rangeReadCore,
+        du_size: duSizeCore,
+        du_entries: duEntriesCore,
+        exists: existsCore,
+        find_flat: findCore,
+        write: writeCore,
+        create: createCore,
+        unlink: unlinkCore,
+        mkdir: mkdirCore,
+    };
+    open() {
+        return Promise.resolve();
+    }
+    commands() {
+        return HF_COMMANDS;
+    }
+    ops() {
+        return HF_OPS;
+    }
+    streamPath(p) {
+        return streamCore(this.accessor, p);
+    }
+    readFile(p) {
+        return readCore(this.accessor, p, this.index);
+    }
+    writeFile(p, data) {
+        return writeCore(this.accessor, p, data);
+    }
+    readdir(p) {
+        return readdirCore(this.accessor, p, this.index);
+    }
+    stat(p) {
+        return statCore(this.accessor, p, this.index);
+    }
+    exists(p) {
+        return existsCore(this.accessor, p);
+    }
+    mkdir(p) {
+        return mkdirCore(this.accessor, p);
+    }
+    unlink(p) {
+        return unlinkCore(this.accessor, p);
+    }
+    du(p) {
+        return duSizeCore(this.accessor, p);
+    }
+    find(p, options = {}) {
+        return findCore(this.accessor, p, options);
+    }
+    deltaHook() {
+        return buildDeltaHook(this.accessor);
+    }
+    glob(paths, prefix = '') {
+        const effective = prefix
+            ? paths.map((p) => mountPrefixOf(p.virtual, p.resourcePath)
+                ? p
+                : new PathSpec({
+                    virtual: p.virtual,
+                    directory: p.directory,
+                    ...(p.pattern !== null ? { pattern: p.pattern } : {}),
+                    resolved: p.resolved,
+                    resourcePath: mountKey(p.virtual, prefix),
+                }))
+            : paths;
+        return globCore(this.accessor, effective, this.index);
+    }
+    loadState(_state) {
+        return Promise.resolve();
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/resource/hf_buckets/base.js.map

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

package/dist/resource/hf_buckets/config.d.ts

@@ -0,0 +1,58 @@
+import { z } from '@struktoai/mirage-core/resource/secrets';
+import type { ConfigOf, RedactedConfig } from '@struktoai/mirage-core/resource/secrets';
+export declare const HF_ENDPOINT = "https://huggingface.co";
+export declare function assertHfRepoId(value: string, field: string): string;
+/**
+ * Either spelling the Hub itself accepts for a repository.
+ *
+ * A repo id is `namespace/name` or a bare `name`, and the second resolves
+ * against whoever the token belongs to. That is not a convenience:
+ * `hf repo create widget` followed by `hf download widget` is what the real
+ * CLI produces, and refusing the bare form made mirage reject an id the Hub
+ * had just minted. What is refused is a shape the Hub has no reading for: an
+ * empty segment, or more than one slash.
+ *
+ * A BUCKET keeps the stricter rule (`assertHfRepoId`): the Buckets API has no
+ * namespace-from-token step, so a bare bucket name addresses nothing.
+ */
+export declare function assertHfRepoRef(value: string, field: string): string;
+export interface HfBucketsConfig {
+    bucket: string;
+    token?: string;
+    endpoint?: string;
+    timeoutMs?: number;
+    keyPrefix?: string;
+}
+declare const HfBucketsConfigSchema: z.ZodObject<{
+    bucket: z.ZodString;
+    token: z.ZodOptional<z.ZodString>;
+    endpoint: z.ZodOptional<z.ZodString>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+    keyPrefix: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type HfBucketsConfigRedacted = RedactedConfig<ConfigOf<typeof HfBucketsConfigSchema>, 'token'>;
+export declare function redactHfBucketsConfig(config: HfBucketsConfig): HfBucketsConfigRedacted;
+export declare function normalizeHfBucketsConfig(input: Record<string, unknown>): HfBucketsConfig;
+export interface HfRepoConfig {
+    repoId: string;
+    token?: string;
+    endpoint?: string;
+    timeoutMs?: number;
+    keyPrefix?: string;
+    revision?: string;
+    expandCommits?: boolean;
+}
+declare const HfRepoConfigSchema: z.ZodObject<{
+    repoId: z.ZodString;
+    token: z.ZodOptional<z.ZodString>;
+    endpoint: z.ZodOptional<z.ZodString>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+    keyPrefix: z.ZodOptional<z.ZodString>;
+    revision: z.ZodOptional<z.ZodString>;
+    expandCommits: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type HfRepoConfigRedacted = RedactedConfig<ConfigOf<typeof HfRepoConfigSchema>, 'token'>;
+export declare function redactHfRepoConfig(config: HfRepoConfig): HfRepoConfigRedacted;
+export declare function normalizeHfRepoConfig(input: Record<string, unknown>): HfRepoConfig;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/resource/hf_buckets/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/resource/hf_buckets/config.ts"],"names":[],"mappings":"AAcA,OAAO,EAIL,CAAC,EACF,MAAM,yCAAyC,CAAA;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAA;AAGvF,eAAO,MAAM,WAAW,2BAA2B,CAAA;AAEnD,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAMnE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAMpE;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAUD,QAAA,MAAM,qBAAqB;;;;;;iBAMzB,CAAA;AAIF,MAAM,MAAM,uBAAuB,GAAG,cAAc,CAClD,QAAQ,CAAC,OAAO,qBAAqB,CAAC,EACtC,OAAO,CACR,CAAA;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,eAAe,GAAG,uBAAuB,CAKtF;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,eAAe,CAIxF;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IASjB,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AAED,QAAA,MAAM,kBAAkB;;;;;;;;iBAQtB,CAAA;AAIF,MAAM,MAAM,oBAAoB,GAAG,cAAc,CAAC,QAAQ,CAAC,OAAO,kBAAkB,CAAC,EAAE,OAAO,CAAC,CAAA;AAE/F,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,oBAAoB,CAK7E;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY,CAIlF"}

package/dist/resource/hf_buckets/config.js

@@ -0,0 +1,89 @@
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+import { parseConfigWithSchema, redactConfigWithSchema, secretStr, z, } from '@struktoai/mirage-core/resource/secrets';
+import { secondsToMs } from '@struktoai/mirage-core/utils/normalize';
+export const HF_ENDPOINT = 'https://huggingface.co';
+export function assertHfRepoId(value, field) {
+    const parts = value.split('/');
+    if (parts.length !== 2 || parts[0] === '' || parts[1] === '') {
+        throw new Error(`${field} must be in 'namespace/name' form; got ${JSON.stringify(value)}`);
+    }
+    return value;
+}
+/**
+ * Either spelling the Hub itself accepts for a repository.
+ *
+ * A repo id is `namespace/name` or a bare `name`, and the second resolves
+ * against whoever the token belongs to. That is not a convenience:
+ * `hf repo create widget` followed by `hf download widget` is what the real
+ * CLI produces, and refusing the bare form made mirage reject an id the Hub
+ * had just minted. What is refused is a shape the Hub has no reading for: an
+ * empty segment, or more than one slash.
+ *
+ * A BUCKET keeps the stricter rule (`assertHfRepoId`): the Buckets API has no
+ * namespace-from-token step, so a bare bucket name addresses nothing.
+ */
+export function assertHfRepoRef(value, field) {
+    const parts = value.split('/');
+    if (parts.length > 2 || parts.some((p) => p === '')) {
+        throw new Error(`${field} must be 'name' or 'namespace/name'; got ${JSON.stringify(value)}`);
+    }
+    return value;
+}
+// Python states the timeout in seconds; the redactor fills `endpoint`
+// from HF_ENDPOINT, so it is optional on the wire exactly as python's
+// default makes it.
+const HF_NORMALIZER = {
+    rename: { timeout: 'timeoutMs' },
+    transform: { timeout: secondsToMs },
+};
+const HfBucketsConfigSchema = z.object({
+    bucket: z.string(),
+    token: secretStr().optional(),
+    endpoint: z.string().optional(),
+    timeoutMs: z.number().optional(),
+    keyPrefix: z.string().optional(),
+});
+export function redactHfBucketsConfig(config) {
+    return redactConfigWithSchema(HfBucketsConfigSchema, {
+        ...config,
+        endpoint: config.endpoint ?? HF_ENDPOINT,
+    });
+}
+export function normalizeHfBucketsConfig(input) {
+    const config = parseConfigWithSchema(HfBucketsConfigSchema, input, HF_NORMALIZER);
+    assertHfRepoId(config.bucket, 'bucket');
+    return config;
+}
+const HfRepoConfigSchema = z.object({
+    repoId: z.string(),
+    token: secretStr().optional(),
+    endpoint: z.string().optional(),
+    timeoutMs: z.number().optional(),
+    keyPrefix: z.string().optional(),
+    revision: z.string().optional(),
+    expandCommits: z.boolean().optional(),
+});
+export function redactHfRepoConfig(config) {
+    return redactConfigWithSchema(HfRepoConfigSchema, {
+        ...config,
+        endpoint: config.endpoint ?? HF_ENDPOINT,
+    });
+}
+export function normalizeHfRepoConfig(input) {
+    const config = parseConfigWithSchema(HfRepoConfigSchema, input, HF_NORMALIZER);
+    assertHfRepoRef(config.repoId, 'repo_id');
+    return config;
+}
+//# sourceMappingURL=config.js.map

package/dist/resource/hf_buckets/config.js.map

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

package/dist/resource/hf_buckets/hf_buckets.d.ts

@@ -0,0 +1,16 @@
+import { HfBucketsAccessor } from '../../accessor/hf.ts';
+import { HfResource } from './base.ts';
+import { type HfBucketsConfig, type HfBucketsConfigRedacted } from './config.ts';
+export interface HfBucketsResourceState {
+    type: string;
+    config: HfBucketsConfigRedacted;
+}
+export declare class HfBucketsResource extends HfResource {
+    readonly kind: string;
+    readonly prompt: string;
+    readonly config: HfBucketsConfig;
+    readonly accessor: HfBucketsAccessor;
+    constructor(config: HfBucketsConfig);
+    getState(): Promise<HfBucketsResourceState>;
+}
+//# sourceMappingURL=hf_buckets.d.ts.map

package/dist/resource/hf_buckets/hf_buckets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hf_buckets.d.ts","sourceRoot":"","sources":["../../../src/resource/hf_buckets/hf_buckets.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AACtC,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,uBAAuB,EAE7B,MAAM,aAAa,CAAA;AAGpB,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,uBAAuB,CAAA;CAChC;AAED,qBAAa,iBAAkB,SAAQ,UAAU;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAA0B;IAC/C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAoB;IAC3C,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAA;IAChC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAA;gBAExB,MAAM,EAAE,eAAe;IAcnC,QAAQ,IAAI,OAAO,CAAC,sBAAsB,CAAC;CAM5C"}