@struktoai/mirage-node 0.0.5-alpha.1 → 0.0.6

package/dist/resource/github/github.d.ts

@@ -0,0 +1,37 @@
+import { GitHubAccessor } from '@struktoai/mirage-core/accessor/github';
+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 { DeltaHook } from '@struktoai/mirage-core/watch/index';
+import { type GitHubConfig, type GitHubConfigRedacted } from '@struktoai/mirage-core/core/github/config';
+export interface GitHubResourceState {
+    type: string;
+    config: GitHubConfigRedacted;
+    defaultBranch: string;
+    truncated: boolean;
+}
+export declare class GitHubResource extends BaseResource implements Resource {
+    readonly kind: string;
+    readonly cachesReads: boolean;
+    readonly sizesAlwaysKnown: boolean;
+    readonly supportsSnapshot: boolean;
+    readonly indexTtl: number;
+    readonly config: GitHubConfig;
+    readonly accessor: GitHubAccessor;
+    private constructor();
+    static create(config: GitHubConfig): Promise<GitHubResource>;
+    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[]>;
+    deltaHook(): DeltaHook;
+    getState(): Promise<GitHubResourceState>;
+    loadState(_state: GitHubResourceState): Promise<void>;
+}
+//# sourceMappingURL=github.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../../../src/resource/github/github.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAA;AAKvE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAA;AAY/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;AACpE,OAAO,EAAE,QAAQ,EAAgB,MAAM,8BAA8B,CAAA;AACrE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAE5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAA;AACnE,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,oBAAoB,EAC1B,MAAM,2CAA2C,CAAA;AAIlD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,oBAAoB,CAAA;IAC5B,aAAa,EAAE,MAAM,CAAA;IACrB,SAAS,EAAE,OAAO,CAAA;CACnB;AAED,qBAAa,cAAe,SAAQ,YAAa,YAAW,QAAQ;IAClE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAsB;IAC3C,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAO;IAIpC,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAO;IAGzC,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAO;IACzC,SAAkB,QAAQ,EAAE,MAAM,CAAS;IAC3C,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;IAC7B,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAA;IAEjC,OAAO;WAOM,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC;IAuBlE,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;IAkBlE,SAAS,IAAI,SAAS;IAIb,QAAQ,IAAI,OAAO,CAAC,mBAAmB,CAAC;IASxC,SAAS,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;CAG/D"}

package/dist/resource/github/github.js

@@ -0,0 +1,119 @@
+// ========= 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 { GitHubAccessor } from '@struktoai/mirage-core/accessor/github';
+import { RAMIndexCacheStore } from '@struktoai/mirage-core/cache/index/ram';
+import { makeResolveGlob } from '@struktoai/mirage-core/commands/builtin/generic_bind/index';
+import { GITHUB_COMMANDS } from '@struktoai/mirage-core/commands/builtin/github/index';
+import { HttpGitHubTransport, fetchRepoInfo as fetchGitHubRepoInfo, fetchTree as fetchGitHubTree, } from '@struktoai/mirage-core/core/github/client';
+import { read as githubRead } from '@struktoai/mirage-core/core/github/read';
+import { readdir as githubReaddir } from '@struktoai/mirage-core/core/github/readdir';
+import { stat as githubStat } from '@struktoai/mirage-core/core/github/stat';
+import { buildTreeMap as githubBuildTreeMap } from '@struktoai/mirage-core/core/github/tree';
+import { buildDeltaHook } from '@struktoai/mirage-core/core/github/watch';
+import { GITHUB_OPS } from '@struktoai/mirage-core/ops/github/index';
+import { BaseResource } from '@struktoai/mirage-core/resource/base';
+import { PathSpec, ResourceName } from '@struktoai/mirage-core/types';
+import { mountKey, mountPrefixOf } from '@struktoai/mirage-core/utils/key_prefix';
+import { redactGitHubConfig, } from '@struktoai/mirage-core/core/github/config';
+const githubResolveGlob = makeResolveGlob(githubReaddir);
+export class GitHubResource extends BaseResource {
+    kind = ResourceName.GITHUB;
+    cachesReads = true;
+    // The git tree API reports the exact blob size for every file; the
+    // blob read returns those same bytes, and submodule gitlinks (which
+    // have no size and no blob) are excluded from the tree.
+    sizesAlwaysKnown = true;
+    // Blob shas are stable per-path markers, so cached reads can be
+    // probe-verified under ALWAYS and snapshots carry drift fingerprints.
+    supportsSnapshot = true;
+    indexTtl = 86_400;
+    config;
+    accessor;
+    constructor(config, accessor, index) {
+        super();
+        this.config = config;
+        this.accessor = accessor;
+        this._index = index;
+    }
+    static async create(config) {
+        const transportOpts = { token: config.token };
+        if (config.baseUrl !== undefined)
+            transportOpts.baseUrl = config.baseUrl;
+        const transport = new HttpGitHubTransport(transportOpts);
+        const repoInfo = await fetchGitHubRepoInfo(transport, config.owner, config.repo);
+        const ref = config.ref ?? repoInfo.default_branch;
+        const { tree, truncated } = await fetchGitHubTree(transport, config.owner, config.repo, ref);
+        const treeMap = githubBuildTreeMap(tree);
+        const accessor = new GitHubAccessor({
+            transport,
+            owner: config.owner,
+            repo: config.repo,
+            ref,
+            defaultBranch: repoInfo.default_branch,
+            truncated,
+            tree: treeMap,
+        });
+        // Not seeded here: the index is keyed by mount prefix, which only a
+        // PathSpec knows, so the first read seeds it from the accessor's tree.
+        const index = new RAMIndexCacheStore({ ttl: 86_400 });
+        return new GitHubResource(config, accessor, index);
+    }
+    open() {
+        return Promise.resolve();
+    }
+    commands() {
+        return GITHUB_COMMANDS;
+    }
+    ops() {
+        return GITHUB_OPS;
+    }
+    readFile(p) {
+        return githubRead(this.accessor, p, this.index);
+    }
+    readdir(p) {
+        return githubReaddir(this.accessor, p, this.index);
+    }
+    stat(p) {
+        return githubStat(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 githubResolveGlob(this.accessor, effective, this.index);
+    }
+    deltaHook() {
+        return buildDeltaHook(this.accessor);
+    }
+    getState() {
+        return Promise.resolve({
+            type: this.kind,
+            config: redactGitHubConfig(this.config),
+            defaultBranch: this.accessor.defaultBranch,
+            truncated: this.accessor.truncated,
+        });
+    }
+    loadState(_state) {
+        return Promise.resolve();
+    }
+}
+//# sourceMappingURL=github.js.map

package/dist/resource/github/github.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.js","sourceRoot":"","sources":["../../../src/resource/github/github.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,cAAc,EAAE,MAAM,wCAAwC,CAAA;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAA;AAE3E,OAAO,EAAE,eAAe,EAAE,MAAM,4DAA4D,CAAA;AAC5F,OAAO,EAAE,eAAe,EAAE,MAAM,sDAAsD,CAAA;AAEtF,OAAO,EACL,mBAAmB,EACnB,aAAa,IAAI,mBAAmB,EACpC,SAAS,IAAI,eAAe,GAC7B,MAAM,2CAA2C,CAAA;AAClD,OAAO,EAAE,IAAI,IAAI,UAAU,EAAE,MAAM,yCAAyC,CAAA;AAC5E,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,4CAA4C,CAAA;AACrF,OAAO,EAAE,IAAI,IAAI,UAAU,EAAE,MAAM,yCAAyC,CAAA;AAC5E,OAAO,EAAE,YAAY,IAAI,kBAAkB,EAAE,MAAM,yCAAyC,CAAA;AAC5F,OAAO,EAAE,cAAc,EAAE,MAAM,0CAA0C,CAAA;AACzE,OAAO,EAAE,UAAU,EAAE,MAAM,yCAAyC,CAAA;AAEpE,OAAO,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAA;AAEnE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAErE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAA;AAEjF,OAAO,EACL,kBAAkB,GAGnB,MAAM,2CAA2C,CAAA;AAElD,MAAM,iBAAiB,GAAG,eAAe,CAAC,aAAa,CAAC,CAAA;AASxD,MAAM,OAAO,cAAe,SAAQ,YAAY;IACrC,IAAI,GAAW,YAAY,CAAC,MAAM,CAAA;IAClC,WAAW,GAAY,IAAI,CAAA;IACpC,mEAAmE;IACnE,oEAAoE;IACpE,wDAAwD;IAC/C,gBAAgB,GAAY,IAAI,CAAA;IACzC,gEAAgE;IAChE,sEAAsE;IAC7D,gBAAgB,GAAY,IAAI,CAAA;IACvB,QAAQ,GAAW,MAAM,CAAA;IAClC,MAAM,CAAc;IACpB,QAAQ,CAAgB;IAEjC,YAAoB,MAAoB,EAAE,QAAwB,EAAE,KAAsB;QACxF,KAAK,EAAE,CAAA;QACP,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QACpB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;QACxB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAA;IACrB,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAoB;QACtC,MAAM,aAAa,GAAwC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAA;QAClF,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS;YAAE,aAAa,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAA;QACxE,MAAM,SAAS,GAAG,IAAI,mBAAmB,CAAC,aAAa,CAAC,CAAA;QACxD,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,CAAA;QAChF,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,IAAI,QAAQ,CAAC,cAAc,CAAA;QACjD,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,MAAM,eAAe,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;QAC5F,MAAM,OAAO,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAA;QACxC,MAAM,QAAQ,GAAG,IAAI,cAAc,CAAC;YAClC,SAAS;YACT,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,GAAG;YACH,aAAa,EAAE,QAAQ,CAAC,cAAc;YACtC,SAAS;YACT,IAAI,EAAE,OAAO;SACd,CAAC,CAAA;QACF,oEAAoE;QACpE,uEAAuE;QACvE,MAAM,KAAK,GAAG,IAAI,kBAAkB,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAA;QACrD,OAAO,IAAI,cAAc,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAA;IACpD,CAAC;IAED,IAAI;QACF,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA;IAC1B,CAAC;IAED,QAAQ;QACN,OAAO,eAAe,CAAA;IACxB,CAAC;IAED,GAAG;QACD,OAAO,UAAU,CAAA;IACnB,CAAC;IAED,QAAQ,CAAC,CAAW;QAClB,OAAO,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAA;IACjD,CAAC;IAED,OAAO,CAAC,CAAW;QACjB,OAAO,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAA;IACpD,CAAC;IAED,IAAI,CAAC,CAAW;QACd,OAAO,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAA;IACjD,CAAC;IAED,IAAI,CAAC,KAA0B,EAAE,MAAM,GAAG,EAAE;QAC1C,MAAM,SAAS,GACb,MAAM,KAAK,EAAE;YACX,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACd,aAAa,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,YAAY,CAAC,KAAK,EAAE;gBAC7C,CAAC,CAAC,CAAC;gBACH,CAAC,CAAC,IAAI,QAAQ,CAAC;oBACX,OAAO,EAAE,CAAC,CAAC,OAAO;oBAClB,SAAS,EAAE,CAAC,CAAC,SAAS;oBACtB,GAAG,CAAC,CAAC,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACrD,QAAQ,EAAE,CAAC,CAAC,QAAQ;oBACpB,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC;iBAC1C,CAAC,CACP;YACH,CAAC,CAAC,KAAK,CAAA;QACX,OAAO,iBAAiB,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,CAAA;IAChE,CAAC;IAED,SAAS;QACP,OAAO,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IACtC,CAAC;IAEQ,QAAQ;QACf,OAAO,OAAO,CAAC,OAAO,CAAC;YACrB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC;YACvC,aAAa,EAAE,IAAI,CAAC,QAAQ,CAAC,aAAa;YAC1C,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,SAAS;SACnC,CAAC,CAAA;IACJ,CAAC;IAEQ,SAAS,CAAC,MAA2B;QAC5C,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA;IAC1B,CAAC;CACF"}

package/dist/resource/gmail/gmail.d.ts

@@ -0,0 +1,33 @@
+import { GmailAccessor } from '@struktoai/mirage-core/accessor/gmail';
+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 GmailConfig, type GmailConfigRedacted } from '@struktoai/mirage-core/resource/gmail/config';
+export interface GmailResourceState {
+    type: string;
+    config: GmailConfigRedacted;
+}
+export declare class GmailResource extends BaseResource implements Resource {
+    readonly kind: string;
+    readonly cachesReads: boolean;
+    readonly sizesAlwaysKnown: boolean;
+    readonly indexTtl: number;
+    readonly prompt: string;
+    readonly writePrompt: string;
+    readonly config: GmailConfig;
+    readonly accessor: GmailAccessor;
+    constructor(config: GmailConfig);
+    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<GmailResourceState>;
+    loadState(_state: GmailResourceState): Promise<void>;
+}
+//# sourceMappingURL=gmail.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gmail.d.ts","sourceRoot":"","sources":["../../../src/resource/gmail/gmail.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAA;AAGrE,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;AAEpE,OAAO,EAAE,QAAQ,EAAgB,MAAM,8BAA8B,CAAA;AACrE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAE5D,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACzB,MAAM,8CAA8C,CAAA;AAIrD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,mBAAmB,CAAA;CAC5B;AAED,qBAAa,aAAc,SAAQ,YAAa,YAAW,QAAQ;IACjE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAqB;IAC1C,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAO;IAIpC,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAO;IACzC,SAAkB,QAAQ,EAAE,MAAM,CAAS;IAC3C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAe;IACtC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAqB;IACjD,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAA;gBAEpB,MAAM,EAAE,WAAW;IAO/B,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,kBAAkB,CAAC;IAOvC,SAAS,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;CAG9D"}

package/dist/resource/gmail/gmail.js

@@ -0,0 +1,88 @@
+// ========= 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 { GmailAccessor } from '@struktoai/mirage-core/accessor/gmail';
+import { makeResolveGlob } from '@struktoai/mirage-core/commands/builtin/generic_bind/index';
+import { GMAIL_COMMANDS } from '@struktoai/mirage-core/commands/builtin/gmail/index';
+import { read as gmailRead } from '@struktoai/mirage-core/core/gmail/read';
+import { readdir as gmailReaddir } from '@struktoai/mirage-core/core/gmail/readdir';
+import { stat as gmailStat } from '@struktoai/mirage-core/core/gmail/stat';
+import { TokenManager } from '@struktoai/mirage-core/core/google/client';
+import { GMAIL_OPS } from '@struktoai/mirage-core/ops/gmail/index';
+import { BaseResource } from '@struktoai/mirage-core/resource/base';
+import { GMAIL_PROMPT, GMAIL_WRITE_PROMPT } from '@struktoai/mirage-core/resource/gmail/prompt';
+import { PathSpec, ResourceName } from '@struktoai/mirage-core/types';
+import { mountKey, mountPrefixOf } from '@struktoai/mirage-core/utils/key_prefix';
+import { redactGmailConfig, } from '@struktoai/mirage-core/resource/gmail/config';
+const gmailResolveGlob = makeResolveGlob(gmailReaddir);
+export class GmailResource extends BaseResource {
+    kind = ResourceName.GMAIL;
+    cachesReads = true;
+    // Every listed file carries an exact size: .gmail.json is rendered at
+    // readdir from the full message the listing already fetched, and
+    // attachments carry the decoded byte count.
+    sizesAlwaysKnown = true;
+    indexTtl = 86_400;
+    prompt = GMAIL_PROMPT;
+    writePrompt = GMAIL_WRITE_PROMPT;
+    config;
+    accessor;
+    constructor(config) {
+        super();
+        this.config = config;
+        const tm = new TokenManager(config);
+        this.accessor = new GmailAccessor({ tokenManager: tm });
+    }
+    open() {
+        return Promise.resolve();
+    }
+    commands() {
+        return GMAIL_COMMANDS;
+    }
+    ops() {
+        return GMAIL_OPS;
+    }
+    readFile(p) {
+        return gmailRead(this.accessor, p, this.index);
+    }
+    readdir(p) {
+        return gmailReaddir(this.accessor, p, this.index);
+    }
+    stat(p) {
+        return gmailStat(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 gmailResolveGlob(this.accessor, effective, this.index);
+    }
+    getState() {
+        return Promise.resolve({
+            type: this.kind,
+            config: redactGmailConfig(this.config),
+        });
+    }
+    loadState(_state) {
+        return Promise.resolve();
+    }
+}
+//# sourceMappingURL=gmail.js.map

package/dist/resource/gmail/gmail.js.map

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

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

@@ -0,0 +1,20 @@
+import { z } from '@struktoai/mirage-core/resource/secrets';
+import type { ConfigOf, RedactedConfig } from '@struktoai/mirage-core/resource/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/resource/gridfs/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/resource/gridfs/config.ts"],"names":[],"mappings":"AAeA,OAAO,EAIL,CAAC,EACF,MAAM,yCAAyC,CAAA;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAA;AAEvF,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/resource/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/resource/s3/config';
+import { parseConfigWithSchema, redactConfigWithSchema, secretStr, z, } from '@struktoai/mirage-core/resource/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/resource/gridfs/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/resource/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,2CAA2C,CAAA;AAC9E,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,SAAS,EACT,CAAC,GACF,MAAM,yCAAyC,CAAA;AAGhD,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/resource/gridfs/gridfs.d.ts

@@ -0,0 +1,50 @@
+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 } from '@struktoai/mirage-core/resource/base';
+import { PathSpec } from '@struktoai/mirage-core/types';
+import type { FileStat } from '@struktoai/mirage-core/types';
+import { GridFSAccessor } from '../../accessor/gridfs.ts';
+import { type GridFSConfig, type GridFSConfigRedacted } from './config.ts';
+import { type DeltaHook } from '@struktoai/mirage-core/watch/index';
+export interface GridFSResourceState {
+    type: string;
+    config: GridFSConfigRedacted;
+}
+export declare class GridFSResource extends BaseResource implements Resource {
+    readonly kind: string;
+    readonly cachesReads: boolean;
+    readonly supportsSnapshot: boolean;
+    readonly sizesAlwaysKnown: boolean;
+    readonly indexTtl: number;
+    readonly prompt: string;
+    readonly config: GridFSConfig;
+    readonly accessor: GridFSAccessor;
+    readonly opsMap: Record<string, unknown>;
+    constructor(config: GridFSConfig);
+    open(): Promise<void>;
+    close(): 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>;
+    appendFile(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>;
+    rmdir(p: PathSpec): Promise<void>;
+    unlink(p: PathSpec): Promise<void>;
+    rename(src: PathSpec, dst: PathSpec): Promise<void>;
+    truncate(p: PathSpec, length: number): Promise<void>;
+    copy(src: PathSpec, dst: PathSpec): Promise<void>;
+    rmR(p: PathSpec): Promise<void>;
+    du(p: PathSpec): Promise<number>;
+    find(p: PathSpec, options?: FindOptions): Promise<string[]>;
+    glob(paths: readonly PathSpec[], prefix?: string): Promise<PathSpec[]>;
+    deltaHook(): DeltaHook;
+    getState(): Promise<GridFSResourceState>;
+    loadState(_state: GridFSResourceState): Promise<void>;
+}
+//# sourceMappingURL=gridfs.d.ts.map

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

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

package/dist/resource/gridfs/gridfs.js

@@ -0,0 +1,190 @@
+// ========= 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 { normalizeKeyPrefix } from '@struktoai/mirage-core/resource/s3/config';
+import { PathSpec, ResourceName } from '@struktoai/mirage-core/types';
+import { mountKey, mountPrefixOf } from '@struktoai/mirage-core/utils/key_prefix';
+import { GridFSAccessor } from "../../accessor/gridfs.js";
+import { GRIDFS_COMMANDS } from "../../commands/builtin/gridfs/index.js";
+import { SCOPE_ERROR } from "../../core/gridfs/constants.js";
+import { copy as copyCore } from "../../core/gridfs/copy.js";
+import { create as createCore } from "../../core/gridfs/create.js";
+import { size as duSizeCore, entries as duEntriesCore } from "../../core/gridfs/du/index.js";
+import { exists as existsCore } from "../../core/gridfs/exists.js";
+import { find as findCore } from "../../core/gridfs/find.js";
+import { mkdir as mkdirCore } from "../../core/gridfs/mkdir.js";
+import { read as readCore } from "../../core/gridfs/read.js";
+import { readdir as readdirCore } from "../../core/gridfs/readdir.js";
+import { rename as renameCore } from "../../core/gridfs/rename.js";
+import { rmR as rmRCore } from "../../core/gridfs/rm.js";
+import { rmdir as rmdirCore } from "../../core/gridfs/rmdir.js";
+import { stat as statCore } from "../../core/gridfs/stat.js";
+import { rangeRead as rangeReadCore, stream as streamCore } from "../../core/gridfs/stream.js";
+import { truncate as truncateCore } from "../../core/gridfs/truncate.js";
+import { unlink as unlinkCore } from "../../core/gridfs/unlink.js";
+import { write as writeCore } from "../../core/gridfs/write.js";
+import { GRIDFS_OPS } from "../../ops/gridfs/index.js";
+import { redactConfig } from "./config.js";
+import { GRIDFS_PROMPT } from "./prompt.js";
+import {} from '@struktoai/mirage-core/watch/index';
+import { buildDeltaHook } from "../../core/gridfs/watch.js";
+const globCore = makeResolveGlob(readdirCore, SCOPE_ERROR);
+export class GridFSResource extends BaseResource {
+    kind = ResourceName.GRIDFS;
+    cachesReads = true;
+    supportsSnapshot = true;
+    // byte store: stat() sizes every file from metadata
+    sizesAlwaysKnown = true;
+    indexTtl = 600;
+    prompt = GRIDFS_PROMPT;
+    config;
+    accessor;
+    opsMap = {
+        read_bytes: readCore,
+        write: writeCore,
+        readdir: readdirCore,
+        stat: statCore,
+        unlink: unlinkCore,
+        rmdir: rmdirCore,
+        copy: copyCore,
+        rename: renameCore,
+        mkdir: mkdirCore,
+        read_stream: streamCore,
+        range_read: rangeReadCore,
+        rm_recursive: rmRCore,
+        du_size: duSizeCore,
+        du_entries: duEntriesCore,
+        create: createCore,
+        truncate: truncateCore,
+        exists: existsCore,
+        find_flat: findCore,
+    };
+    constructor(config) {
+        super();
+        const normalized = normalizeKeyPrefix(config.keyPrefix);
+        const cfg = { ...config };
+        if (normalized !== undefined) {
+            cfg.keyPrefix = normalized;
+        }
+        else {
+            delete cfg.keyPrefix;
+        }
+        this.config = cfg;
+        this.accessor = new GridFSAccessor(this.config);
+    }
+    open() {
+        return Promise.resolve();
+    }
+    async close() {
+        await this.accessor.close();
+        await super.close();
+    }
+    commands() {
+        return GRIDFS_COMMANDS;
+    }
+    ops() {
+        return GRIDFS_OPS;
+    }
+    streamPath(p) {
+        return streamCore(this.accessor, p);
+    }
+    readFile(p) {
+        return readCore(this.accessor, p);
+    }
+    writeFile(p, data) {
+        return writeCore(this.accessor, p, data);
+    }
+    async appendFile(p, data) {
+        let existing;
+        try {
+            existing = await readCore(this.accessor, p);
+        }
+        catch (err) {
+            if (err?.code === 'ENOENT') {
+                existing = new Uint8Array();
+            }
+            else {
+                throw err;
+            }
+        }
+        const merged = new Uint8Array(existing.byteLength + data.byteLength);
+        merged.set(existing, 0);
+        merged.set(data, existing.byteLength);
+        await writeCore(this.accessor, p, merged);
+    }
+    readdir(p) {
+        return readdirCore(this.accessor, p, this.index);
+    }
+    stat(p) {
+        return statCore(this.accessor, p);
+    }
+    exists(p) {
+        return existsCore(this.accessor, p);
+    }
+    mkdir(p) {
+        return mkdirCore(this.accessor, p);
+    }
+    rmdir(p) {
+        return rmdirCore(this.accessor, p);
+    }
+    unlink(p) {
+        return unlinkCore(this.accessor, p);
+    }
+    rename(src, dst) {
+        return renameCore(this.accessor, src, dst);
+    }
+    truncate(p, length) {
+        return truncateCore(this.accessor, p, length);
+    }
+    copy(src, dst) {
+        return copyCore(this.accessor, src, dst);
+    }
+    rmR(p) {
+        return rmRCore(this.accessor, p);
+    }
+    du(p) {
+        return duSizeCore(this.accessor, p);
+    }
+    find(p, options = {}) {
+        return findCore(this.accessor, p, options);
+    }
+    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);
+    }
+    deltaHook() {
+        return buildDeltaHook(this.accessor);
+    }
+    getState() {
+        return Promise.resolve({
+            type: this.kind,
+            config: redactConfig(this.config),
+        });
+    }
+    loadState(_state) {
+        return Promise.resolve();
+    }
+}
+//# sourceMappingURL=gridfs.js.map

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

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

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

@@ -0,0 +1,2 @@
+export declare const GRIDFS_PROMPT = "{prefix}\n  Remote MongoDB GridFS bucket. Maps GridFS filenames to virtual paths.\n  IMPORTANT: This is a remote mount. Prefer targeted reads (grep, head) over full scans. Avoid cat on large files without piping to head/tail.\n  find pushes -name/-type/-size filters into the fs.files query server-side, so find is cheap even on large buckets.\n  Supports: ls, cat, head, tail, grep, rg, wc, find, tree, jq, stat.";
+//# sourceMappingURL=prompt.d.ts.map