@struktoai/mirage-node 0.0.7-alpha.2 → 0.0.7-alpha.3

package/dist/vfs/dropbox/config.d.ts

@@ -0,0 +1,34 @@
+import { z } from '@struktoai/mirage-core/vfs/secrets';
+import type { ConfigOf, RedactedConfig } from '@struktoai/mirage-core/vfs/secrets';
+export interface DropboxConfig {
+    clientId: string;
+    clientSecret: string;
+    refreshToken: string;
+    rootPath?: string;
+    contentSearch?: boolean;
+    endpoint?: string;
+    refreshFn?: (refreshToken: string) => Promise<{
+        accessToken: string;
+        expiresIn: number;
+    }>;
+}
+declare const DropboxConfigSchema: z.ZodObject<{
+    clientId: z.ZodString;
+    clientSecret: z.ZodString;
+    refreshToken: z.ZodString;
+    rootPath: z.ZodOptional<z.ZodString>;
+    contentSearch: z.ZodOptional<z.ZodBoolean>;
+    endpoint: z.ZodOptional<z.ZodString>;
+    refreshFn: z.ZodOptional<z.ZodCustom<(refreshToken: string) => Promise<{
+        accessToken: string;
+        expiresIn: number;
+    }>, (refreshToken: string) => Promise<{
+        accessToken: string;
+        expiresIn: number;
+    }>>>;
+}, z.core.$strip>;
+export type DropboxConfigRedacted = RedactedConfig<ConfigOf<typeof DropboxConfigSchema>, 'clientSecret' | 'refreshToken' | 'refreshFn'>;
+export declare function redactDropboxConfig(config: DropboxConfig): DropboxConfigRedacted;
+export declare function normalizeDropboxConfig(input: Record<string, unknown>): DropboxConfig;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/vfs/dropbox/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/vfs/dropbox/config.ts"],"names":[],"mappings":"AAcA,OAAO,EAKL,CAAC,EACF,MAAM,oCAAoC,CAAA;AAC3C,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAA;AAKlF,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAC1F;AAED,QAAA,MAAM,mBAAmB;;;;;;;wDAHI,MAAM,KAAK,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,iBAA9D,MAAM,KAAK,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;iBAczF,CAAA;AAIF,MAAM,MAAM,qBAAqB,GAAG,cAAc,CAChD,QAAQ,CAAC,OAAO,mBAAmB,CAAC,EACpC,cAAc,GAAG,cAAc,GAAG,WAAW,CAC9C,CAAA;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,qBAAqB,CAEhF;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,aAAa,CAEpF"}

package/dist/vfs/dropbox/config.js

@@ -0,0 +1,31 @@
+// ========= 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, secretSchema, secretStr, z, } from '@struktoai/mirage-core/vfs/secrets';
+const DropboxConfigSchema = z.object({
+    clientId: z.string(),
+    clientSecret: secretStr(),
+    refreshToken: secretStr(),
+    rootPath: z.string().optional(),
+    contentSearch: z.boolean().optional(),
+    endpoint: z.string().optional(),
+    // Declared so parse keeps it, marked secret so no snapshot carries it.
+    refreshFn: secretSchema(z.custom((value) => typeof value === 'function')).optional(),
+});
+export function redactDropboxConfig(config) {
+    return redactConfigWithSchema(DropboxConfigSchema, config);
+}
+export function normalizeDropboxConfig(input) {
+    return parseConfigWithSchema(DropboxConfigSchema, input);
+}
+//# sourceMappingURL=config.js.map

package/dist/vfs/dropbox/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/vfs/dropbox/config.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,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,YAAY,EACZ,SAAS,EACT,CAAC,GACF,MAAM,oCAAoC,CAAA;AAgB3C,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,YAAY,EAAE,SAAS,EAAE;IACzB,YAAY,EAAE,SAAS,EAAE;IACzB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACrC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,uEAAuE;IACvE,SAAS,EAAE,YAAY,CACrB,CAAC,CAAC,MAAM,CAA0C,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,UAAU,CAAC,CAC1F,CAAC,QAAQ,EAAE;CACb,CAAC,CAAA;AASF,MAAM,UAAU,mBAAmB,CAAC,MAAqB;IACvD,OAAO,sBAAsB,CAAC,mBAAmB,EAAE,MAAM,CAAqC,CAAA;AAChG,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAA8B;IACnE,OAAO,qBAAqB,CAAC,mBAAmB,EAAE,KAAK,CAAC,CAAA;AAC1D,CAAC"}

package/dist/vfs/email/email.d.ts

@@ -0,0 +1,38 @@
+import { BaseVFS } from '@struktoai/mirage-core/vfs/base';
+import { EmailAccessor } from '../../accessor/email.ts';
+import { type EmailConfig, type EmailConfigRedacted } from '../../core/email/config.ts';
+import type { DirListing, PathSpec, FileStat } from '@struktoai/mirage-core/types';
+import type { Handed } from '@struktoai/mirage-core/vfs/types';
+export interface EmailVFSState {
+    type: string;
+    config: EmailConfigRedacted;
+}
+export declare class EmailVFS extends BaseVFS {
+    readonly name: string;
+    readonly cachesReads: boolean;
+    readonly sizesAlwaysKnown: boolean;
+    readonly indexTtl: number;
+    readonly prompt: string;
+    readonly writePrompt: string;
+    readonly searchable: readonly string[];
+    readonly handed: {
+        readonly readdir: readonly ["entry"];
+        readonly read: readonly ["entry"];
+        readonly readMany: readonly ["entry"];
+        readonly stat: readonly ["entry"];
+    };
+    readonly config: EmailConfig;
+    readonly accessor: EmailAccessor;
+    constructor(config: EmailConfig);
+    close(): Promise<void>;
+    readdir(path: PathSpec, handed?: Handed): Promise<FileStat[] | DirListing>;
+    read(path: PathSpec, handed?: Handed, offset?: number, size?: number | null): Promise<Uint8Array>;
+    readMany(paths: PathSpec[], limit: number, handed?: readonly Handed[]): Promise<Map<string, Uint8Array>>;
+    stat(path: PathSpec, handed?: Handed): Promise<FileStat>;
+    filesContaining(path: PathSpec, text: string, opts: {
+        wholeWord: boolean;
+        ignoreCase: boolean;
+    }): Promise<PathSpec[] | null>;
+    getState(): Promise<EmailVFSState>;
+}
+//# sourceMappingURL=email.d.ts.map

package/dist/vfs/email/email.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.d.ts","sourceRoot":"","sources":["../../../src/vfs/email/email.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAA;AAIzD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAEvD,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACzB,MAAM,4BAA4B,CAAA;AAEnC,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAClF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAA;AAO9D,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,mBAAmB,CAAA;CAC5B;AAED,qBAAa,QAAS,SAAQ,OAAO;IACnC,SAAkB,IAAI,EAAE,MAAM,CAAgB;IAC9C,SAAkB,WAAW,EAAE,OAAO,CAAO;IAI7C,SAAkB,gBAAgB,EAAE,OAAO,CAAO;IAClD,SAAkB,QAAQ,EAAE,MAAM,CAAS;IAC3C,SAAkB,MAAM,EAAE,MAAM,CAAS;IACzC,SAAkB,WAAW,EAAE,MAAM,CAAe;IAEpD,SAAkB,UAAU,EAAE,SAAS,MAAM,EAAE,CAAuB;IACtE,SAAkB,MAAM;;;;;MAKd;IACV,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,SAAkB,QAAQ,EAAE,aAAa,CAAA;gBAE7B,MAAM,EAAE,WAAW;IAMhB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,GAAG,UAAU,CAAC;IAIpE,IAAI,CACjB,IAAI,EAAE,QAAQ,EACd,MAAM,CAAC,EAAE,MAAM,EACf,MAAM,SAAI,EACV,IAAI,GAAE,MAAM,GAAG,IAAW,GACzB,OAAO,CAAC,UAAU,CAAC;IAKb,QAAQ,CACf,KAAK,EAAE,QAAQ,EAAE,EACjB,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,GACzB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAI1B,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIxD,eAAe,CACtB,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,OAAO,CAAA;KAAE,GAChD,OAAO,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC;IAKpB,QAAQ,IAAI,OAAO,CAAC,aAAa,CAAC;CAM5C"}

package/dist/vfs/email/email.js

@@ -0,0 +1,78 @@
+// ========= 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 { BaseVFS } from '@struktoai/mirage-core/vfs/base';
+import { VFSName } from '@struktoai/mirage-core/types';
+import { EmailAccessor } from "../../accessor/email.js";
+import { redactEmailConfig, } from "../../core/email/config.js";
+import { PROMPT, WRITE_PROMPT } from "./prompt.js";
+import { sliceWindow } from '@struktoai/mirage-core/utils/ranges';
+import { readdir as emailReaddir } from "../../core/email/readdir.js";
+import { read as emailRead, readMany as emailReadMany } from "../../core/email/read.js";
+import { stat as emailStat } from "../../core/email/stat.js";
+import { filesContaining as emailFilesContaining } from "../../core/email/search.js";
+export class EmailVFS extends BaseVFS {
+    name = VFSName.EMAIL;
+    cachesReads = true;
+    // Every listed file carries an exact size: .email.json is rendered at
+    // readdir from the full message source the listing already fetches, and an
+    // attachment's size is its decoded payload length.
+    sizesAlwaysKnown = true;
+    indexTtl = 86_400;
+    prompt = PROMPT;
+    writePrompt = WRITE_PROMPT;
+    // IMAP search names messages; an attachment is read as usual.
+    searchable = ['*/*/*.email.json'];
+    handed = {
+        readdir: ['entry'],
+        read: ['entry'],
+        readMany: ['entry'],
+        stat: ['entry'],
+    };
+    config;
+    accessor;
+    constructor(config) {
+        super();
+        this.config = config;
+        this.accessor = new EmailAccessor(config);
+    }
+    async close() {
+        await this.accessor.close();
+        await super.close();
+    }
+    readdir(path, handed) {
+        return emailReaddir(this.accessor, path, handed?.entry);
+    }
+    async read(path, handed, offset = 0, size = null) {
+        const data = await emailRead(this.accessor, path, handed?.entry);
+        return offset === 0 && size === null ? data : sliceWindow(data, offset, size);
+    }
+    readMany(paths, limit, handed) {
+        return emailReadMany(this.accessor, paths, limit, handed);
+    }
+    stat(path, handed) {
+        return emailStat(this.accessor, path, handed?.entry);
+    }
+    filesContaining(path, text, opts) {
+        if (!this.config.contentSearch)
+            return Promise.resolve(null);
+        return emailFilesContaining(this.accessor, text, [path], opts.wholeWord);
+    }
+    getState() {
+        return Promise.resolve({
+            type: this.name,
+            config: redactEmailConfig(this.config),
+        });
+    }
+}
+//# sourceMappingURL=email.js.map

package/dist/vfs/email/email.js.map

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

package/dist/vfs/email/index.d.ts

@@ -0,0 +1,3 @@
+export { buildEmailConfig, normalizeEmailConfig, redactEmailConfig, type EmailConfig, type EmailConfigInput, type EmailConfigRedacted, } from '../../core/email/config.ts';
+export { PROMPT as EMAIL_PROMPT, WRITE_PROMPT as EMAIL_WRITE_PROMPT } from './prompt.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/vfs/email/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/vfs/email/index.ts"],"names":[],"mappings":"AAcA,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,GACzB,MAAM,4BAA4B,CAAA;AACnC,OAAO,EAAE,MAAM,IAAI,YAAY,EAAE,YAAY,IAAI,kBAAkB,EAAE,MAAM,aAAa,CAAA"}

package/dist/vfs/email/index.js

@@ -0,0 +1,16 @@
+// ========= 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 { buildEmailConfig, normalizeEmailConfig, redactEmailConfig, } from "../../core/email/config.js";
+export { PROMPT as EMAIL_PROMPT, WRITE_PROMPT as EMAIL_WRITE_PROMPT } from "./prompt.js";
+//# sourceMappingURL=index.js.map

package/dist/vfs/email/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/vfs/email/index.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,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,GAIlB,MAAM,4BAA4B,CAAA;AACnC,OAAO,EAAE,MAAM,IAAI,YAAY,EAAE,YAAY,IAAI,kBAAkB,EAAE,MAAM,aAAa,CAAA"}

package/dist/vfs/email/prompt.d.ts

@@ -0,0 +1,3 @@
+export declare const PROMPT = "{prefix}\n  <folder>/\n    <yyyy-mm-dd>/\n      <subject>__<uid>.email.json\n      <subject>__<uid>/           # if attachments exist\n        <attachment-filename>\n  Folders include: INBOX, Sent, Drafts, etc. cat shows email as JSON.\n\n  <subject> is sanitized (don't construct it; ls the date dir).\n\n  To act on mail (list/search/read/compose/reply/forward), use the\n  himalaya CLI if installed: himalaya --help";
+export declare const WRITE_PROMPT = "  Sending mail goes through the himalaya CLI if installed:\n    himalaya message compose --to \"to@email.com\" --subject \"Hi\" \\\n      --body \"...\" --send";
+//# sourceMappingURL=prompt.d.ts.map

package/dist/vfs/email/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../src/vfs/email/prompt.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,MAAM,uaAW0B,CAAA;AAE7C,eAAO,MAAM,YAAY,oKAEC,CAAA"}

package/dist/vfs/email/prompt.js

@@ -0,0 +1,29 @@
+// ========= 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 PROMPT = `{prefix}
+  <folder>/
+    <yyyy-mm-dd>/
+      <subject>__<uid>.email.json
+      <subject>__<uid>/           # if attachments exist
+        <attachment-filename>
+  Folders include: INBOX, Sent, Drafts, etc. cat shows email as JSON.
+
+  <subject> is sanitized (don't construct it; ls the date dir).
+
+  To act on mail (list/search/read/compose/reply/forward), use the
+  himalaya CLI if installed: himalaya --help`;
+export const WRITE_PROMPT = `  Sending mail goes through the himalaya CLI if installed:
+    himalaya message compose --to "to@email.com" --subject "Hi" \\
+      --body "..." --send`;
+//# sourceMappingURL=prompt.js.map

package/dist/vfs/email/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../src/vfs/email/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,MAAM,GAAG;;;;;;;;;;;6CAWuB,CAAA;AAE7C,MAAM,CAAC,MAAM,YAAY,GAAG;;0BAEF,CAAA"}

package/dist/vfs/gcs/config.d.ts

@@ -0,0 +1,36 @@
+import { z } from '@struktoai/mirage-core/vfs/secrets';
+import type { ConfigOf, RedactedConfig } from '@struktoai/mirage-core/vfs/secrets';
+import type { S3Config } from '../s3/config.ts';
+export declare const GCS_ENDPOINT = "https://storage.googleapis.com";
+export interface GCSConfig {
+    bucket: string;
+    accessKeyId?: string;
+    secretAccessKey?: string;
+    sessionToken?: string;
+    profile?: string;
+    endpoint?: string;
+    region?: string;
+    timeoutMs?: number;
+    forcePathStyle?: boolean;
+    keyPrefix?: string;
+    proxy?: string;
+}
+declare const GCSConfigSchema: z.ZodObject<{
+    bucket: z.ZodString;
+    accessKeyId: z.ZodOptional<z.ZodString>;
+    secretAccessKey: z.ZodOptional<z.ZodString>;
+    sessionToken: z.ZodOptional<z.ZodString>;
+    profile: z.ZodOptional<z.ZodString>;
+    endpoint: z.ZodOptional<z.ZodString>;
+    region: z.ZodOptional<z.ZodString>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+    forcePathStyle: z.ZodOptional<z.ZodBoolean>;
+    keyPrefix: z.ZodOptional<z.ZodString>;
+    proxy: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type GCSConfigRedacted = RedactedConfig<ConfigOf<typeof GCSConfigSchema>, 'accessKeyId' | 'secretAccessKey' | 'sessionToken' | 'proxy'>;
+export declare function gcsToS3Config(config: GCSConfig): S3Config;
+export declare function redactGcsConfig(config: GCSConfig): GCSConfigRedacted;
+export declare function normalizeGcsConfig(input: Record<string, unknown>): GCSConfig;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/vfs/gcs/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/vfs/gcs/config.ts"],"names":[],"mappings":"AAcA,OAAO,EAIL,CAAC,EACF,MAAM,oCAAoC,CAAA;AAC3C,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAA;AAElF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAE/C,eAAO,MAAM,YAAY,mCAAmC,CAAA;AAE5D,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,QAAA,MAAM,eAAe;;;;;;;;;;;;iBAYnB,CAAA;AAIF,MAAM,MAAM,iBAAiB,GAAG,cAAc,CAC5C,QAAQ,CAAC,OAAO,eAAe,CAAC,EAChC,aAAa,GAAG,iBAAiB,GAAG,cAAc,GAAG,OAAO,CAC7D,CAAA;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,QAAQ,CAczD;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,iBAAiB,CAMpE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAE5E"}

package/dist/vfs/gcs/config.js

@@ -0,0 +1,55 @@
+// ========= 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/vfs/secrets';
+import { S3_FAMILY_NORMALIZER } from "../s3/config.js";
+export const GCS_ENDPOINT = 'https://storage.googleapis.com';
+const GCSConfigSchema = z.object({
+    bucket: z.string(),
+    accessKeyId: secretStr().optional(),
+    secretAccessKey: secretStr().optional(),
+    sessionToken: secretStr().optional(),
+    profile: z.string().optional(),
+    endpoint: z.string().optional(),
+    region: z.string().optional(),
+    timeoutMs: z.number().optional(),
+    forcePathStyle: z.boolean().optional(),
+    keyPrefix: z.string().optional(),
+    proxy: secretStr().optional(),
+});
+export function gcsToS3Config(config) {
+    return {
+        bucket: config.bucket,
+        region: config.region ?? 'auto',
+        endpoint: config.endpoint ?? GCS_ENDPOINT,
+        ...(config.accessKeyId !== undefined ? { accessKeyId: config.accessKeyId } : {}),
+        ...(config.secretAccessKey !== undefined ? { secretAccessKey: config.secretAccessKey } : {}),
+        ...(config.sessionToken !== undefined ? { sessionToken: config.sessionToken } : {}),
+        ...(config.profile !== undefined ? { profile: config.profile } : {}),
+        ...(config.timeoutMs !== undefined ? { timeoutMs: config.timeoutMs } : {}),
+        ...(config.forcePathStyle !== undefined ? { forcePathStyle: config.forcePathStyle } : {}),
+        ...(config.keyPrefix !== undefined ? { keyPrefix: config.keyPrefix } : {}),
+        ...(config.proxy !== undefined ? { proxy: config.proxy } : {}),
+    };
+}
+export function redactGcsConfig(config) {
+    return redactConfigWithSchema(GCSConfigSchema, {
+        ...config,
+        endpoint: config.endpoint ?? GCS_ENDPOINT,
+        region: config.region ?? 'auto',
+    });
+}
+export function normalizeGcsConfig(input) {
+    return parseConfigWithSchema(GCSConfigSchema, input, S3_FAMILY_NORMALIZER);
+}
+//# sourceMappingURL=config.js.map

package/dist/vfs/gcs/config.js.map

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

package/dist/vfs/gcs/gcs.d.ts

@@ -0,0 +1,8 @@
+import { S3AliasVFS, type S3AliasVFSState } from '../s3_alias.ts';
+import { type GCSConfig, type GCSConfigRedacted } from './config.ts';
+export type GCSVFSState = S3AliasVFSState<GCSConfigRedacted>;
+export declare class GCSVFS extends S3AliasVFS<GCSConfig, GCSConfigRedacted> {
+    readonly prompt: string;
+    constructor(config: GCSConfig);
+}
+//# sourceMappingURL=gcs.d.ts.map

package/dist/vfs/gcs/gcs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gcs.d.ts","sourceRoot":"","sources":["../../../src/vfs/gcs/gcs.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAA;AACjE,OAAO,EAAkC,KAAK,SAAS,EAAE,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAGpG,MAAM,MAAM,WAAW,GAAG,eAAe,CAAC,iBAAiB,CAAC,CAAA;AAE5D,qBAAa,MAAO,SAAQ,UAAU,CAAC,SAAS,EAAE,iBAAiB,CAAC;IAClE,SAAkB,MAAM,EAAE,MAAM,CAAS;gBAE7B,MAAM,EAAE,SAAS;CAG9B"}

package/dist/vfs/gcs/gcs.js

@@ -0,0 +1,24 @@
+// ========= 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 { VFSName } from '@struktoai/mirage-core/types';
+import { S3AliasVFS } from "../s3_alias.js";
+import { gcsToS3Config, redactGcsConfig } from "./config.js";
+import { PROMPT } from "./prompt.js";
+export class GCSVFS extends S3AliasVFS {
+    prompt = PROMPT;
+    constructor(config) {
+        super(VFSName.GCS, config, gcsToS3Config(config), redactGcsConfig);
+    }
+}
+//# sourceMappingURL=gcs.js.map

package/dist/vfs/gcs/gcs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gcs.js","sourceRoot":"","sources":["../../../src/vfs/gcs/gcs.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,OAAO,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAA;AACtD,OAAO,EAAE,UAAU,EAAwB,MAAM,gBAAgB,CAAA;AACjE,OAAO,EAAE,aAAa,EAAE,eAAe,EAA0C,MAAM,aAAa,CAAA;AACpG,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAIpC,MAAM,OAAO,MAAO,SAAQ,UAAwC;IAChD,MAAM,GAAW,MAAM,CAAA;IAEzC,YAAY,MAAiB;QAC3B,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,EAAE,eAAe,CAAC,CAAA;IACpE,CAAC;CACF"}

package/dist/vfs/gcs/prompt.d.ts

@@ -0,0 +1,2 @@
+export declare const PROMPT = "{prefix}\n  Remote Google Cloud Storage bucket.\n  IMPORTANT: This is a remote mount. Prefer targeted reads over full scans.\n  Supports: ls, cat, head, tail, grep, rg, wc, find, tree, jq, stat.";
+//# sourceMappingURL=prompt.d.ts.map

package/dist/vfs/gcs/prompt.d.ts.map

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

package/dist/vfs/gcs/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 PROMPT = `\
+{prefix}
+  Remote Google Cloud Storage bucket.
+  IMPORTANT: This is a remote mount. Prefer targeted reads over full scans.
+  Supports: ls, cat, head, tail, grep, rg, wc, find, tree, jq, stat.`;
+//# sourceMappingURL=prompt.js.map

package/dist/vfs/gcs/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../src/vfs/gcs/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,MAAM,GAAG;;;;qEAI+C,CAAA"}

package/dist/vfs/gridfs/config.d.ts

@@ -0,0 +1,20 @@
+import { z } from '@struktoai/mirage-core/vfs/secrets';
+import type { ConfigOf, RedactedConfig } from '@struktoai/mirage-core/vfs/secrets';
+declare const GridFSConfigSchema: z.ZodObject<{
+    uri: z.ZodString;
+    database: z.ZodString;
+    bucket: z.ZodOptional<z.ZodString>;
+    keyPrefix: z.ZodOptional<z.ZodString>;
+    chunkSizeBytes: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type GridFSConfig = ConfigOf<typeof GridFSConfigSchema>;
+export type GridFSConfigRedacted = RedactedConfig<GridFSConfig, 'uri'>;
+export declare function redactConfig(config: GridFSConfig): GridFSConfigRedacted;
+/**
+ * Translate Python-style snake_case keys (as used in YAML configs and the
+ * Python `GridFSConfig`) to the TS-idiomatic camelCase fields, and
+ * normalize the key prefix the way the accessor expects.
+ */
+export declare function normalizeGridFSConfig(input: Record<string, unknown>): GridFSConfig;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/vfs/gridfs/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/vfs/gridfs/config.ts"],"names":[],"mappings":"AAeA,OAAO,EAIL,CAAC,EACF,MAAM,oCAAoC,CAAA;AAC3C,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAA;AAElF,QAAA,MAAM,kBAAkB;;;;;;iBAMtB,CAAA;AAEF,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAE9D,MAAM,MAAM,oBAAoB,GAAG,cAAc,CAAC,YAAY,EAAE,KAAK,CAAC,CAAA;AAEtE,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,oBAAoB,CAEvE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY,CASlF"}

package/dist/vfs/gridfs/config.js

@@ -0,0 +1,42 @@
+// ========= 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 { normalizeKeyPrefix } from '@struktoai/mirage-core/vfs/s3/config';
+import { parseConfigWithSchema, redactConfigWithSchema, secretStr, z, } from '@struktoai/mirage-core/vfs/secrets';
+const GridFSConfigSchema = z.object({
+    uri: secretStr(),
+    database: z.string(),
+    bucket: z.string().optional(),
+    keyPrefix: z.string().optional(),
+    chunkSizeBytes: z.number().optional(),
+});
+export function redactConfig(config) {
+    return redactConfigWithSchema(GridFSConfigSchema, config);
+}
+/**
+ * Translate Python-style snake_case keys (as used in YAML configs and the
+ * Python `GridFSConfig`) to the TS-idiomatic camelCase fields, and
+ * normalize the key prefix the way the accessor expects.
+ */
+export function normalizeGridFSConfig(input) {
+    const norm = parseConfigWithSchema(GridFSConfigSchema, input);
+    const prefix = normalizeKeyPrefix(norm.keyPrefix);
+    if (prefix !== undefined) {
+        norm.keyPrefix = prefix;
+    }
+    else {
+        delete norm.keyPrefix;
+    }
+    return norm;
+}
+//# sourceMappingURL=config.js.map

package/dist/vfs/gridfs/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/vfs/gridfs/config.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,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAA;AACzE,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,SAAS,EACT,CAAC,GACF,MAAM,oCAAoC,CAAA;AAG3C,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,GAAG,EAAE,SAAS,EAAE;IAChB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACtC,CAAC,CAAA;AAMF,MAAM,UAAU,YAAY,CAAC,MAAoB;IAC/C,OAAO,sBAAsB,CAAC,kBAAkB,EAAE,MAAM,CAAoC,CAAA;AAC9F,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAA8B;IAClE,MAAM,IAAI,GAAG,qBAAqB,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAA;IAC7D,MAAM,MAAM,GAAG,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IACjD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,MAAM,CAAA;IACzB,CAAC;SAAM,CAAC;QACN,OAAO,IAAI,CAAC,SAAS,CAAA;IACvB,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/vfs/gridfs/gridfs.d.ts

@@ -0,0 +1,45 @@
+import type { ByteSource } from '@struktoai/mirage-core/io/types';
+import { BaseVFS } from '@struktoai/mirage-core/vfs/base';
+import { GridFSAccessor } from '../../accessor/gridfs.ts';
+import { type GridFSConfig, type GridFSConfigRedacted } from './config.ts';
+import type { PathSpec, FileStat } from '@struktoai/mirage-core/types';
+import type { Handed } from '@struktoai/mirage-core/vfs/types';
+export interface GridFSVFSState {
+    type: string;
+    config: GridFSConfigRedacted;
+}
+export declare class GridFSVFS extends BaseVFS {
+    readonly name: string;
+    readonly cachesReads: boolean;
+    readonly supportsSnapshot: boolean;
+    readonly sizesAlwaysKnown: boolean;
+    readonly readRevalidatable: boolean;
+    readonly prompt: string;
+    readonly config: GridFSConfig;
+    readonly accessor: GridFSAccessor;
+    constructor(config: GridFSConfig);
+    close(): Promise<void>;
+    readonly readsRanges: boolean;
+    readonly maxGlobMatches: number;
+    readTree(path: PathSpec): Promise<Map<string, FileStat> | null>;
+    readdir(path: PathSpec): Promise<FileStat[]>;
+    read(path: PathSpec, _handed?: Handed, offset?: number, size?: number | null): Promise<Uint8Array>;
+    stat(path: PathSpec): Promise<FileStat>;
+    readStream(path: PathSpec): AsyncIterable<Uint8Array>;
+    exists(path: PathSpec): Promise<boolean>;
+    write(path: PathSpec, data: Uint8Array): Promise<FileStat | null>;
+    writeStream(path: PathSpec, data: ByteSource, signal?: AbortSignal): Promise<FileStat | null>;
+    append(path: PathSpec, data: Uint8Array): Promise<FileStat | null | undefined>;
+    appendStream(path: PathSpec, data: ByteSource): Promise<FileStat | null | undefined>;
+    create(path: PathSpec): Promise<FileStat | null>;
+    mkdir(path: PathSpec, parents?: boolean): Promise<void>;
+    unlink(path: PathSpec): Promise<void>;
+    rmdir(path: PathSpec): Promise<void>;
+    rmR(path: PathSpec): Promise<void>;
+    rename(src: PathSpec, dst: PathSpec): Promise<void>;
+    copy(src: PathSpec, dst: PathSpec): Promise<void>;
+    truncate(path: PathSpec, length: number, noCreate?: boolean): Promise<FileStat | null>;
+    storageLocation(): string;
+    getState(): Promise<GridFSVFSState>;
+}
+//# sourceMappingURL=gridfs.d.ts.map

package/dist/vfs/gridfs/gridfs.d.ts.map

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