@struktoai/mirage-browser 0.0.3 → 0.0.5-alpha.1

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-import { Workspace as Workspace$1, Resource, WorkspaceOptions, Accessor, RegisteredOp, RegisteredCommand, PathSpec, FileStat, FindOptions, S3Config, S3Accessor, IndexCacheStore, S3ConfigRedacted, S3BrowserPresignedUrlProvider, SlackAccessor, DiscordAccessor, PostgresConfigResolved, PgDriver, PostgresAccessor, PostgresConfig, PgQueryResult, MongoDBConfigResolved, MongoDriver, MongoDBAccessor, MongoDBConfig, EntityKind, MongoCollectionSpec, MongoFindOptions, MongoIterOptions, MongoIndexAccess, TrelloAccessor, LinearAccessor, NotionAccessor, LangfuseAccessor, GitHubAccessor, GitHubCIAccessor, GDocsAccessor, GSheetsAccessor, GSlidesAccessor, GDriveAccessor, DropboxAccessor, BoxAccessor, GoogleConfig, GmailAccessor, GoogleConfigRedacted } from '@struktoai/mirage-core';
+import { Workspace as Workspace$1, Resource, WorkspaceOptions, Accessor, RegisteredOp, RegisteredCommand, PathSpec, FileStat, FindOptions, S3Config, S3Accessor, IndexCacheStore, S3ConfigRedacted, ConfigOf, z, S3BrowserPresignedUrlProvider, RedactedConfig, SlackAccessor, DiscordAccessor, PostgresConfigResolved, PgDriver, PostgresAccessor, PostgresConfig, PgQueryResult, MongoDBConfigResolved, MongoDriver, MongoDBAccessor, MongoDBConfig, EntityKind, MongoCollectionSpec, MongoFindOptions, MongoIterOptions, MongoIndexAccess, TrelloAccessor, LinearAccessor, NotionAccessor, LangfuseAccessor, GitHubAccessor, GitHubCIAccessor, GoogleConfig, GDocsAccessor, GoogleConfigRedacted, GSheetsAccessor, GSlidesAccessor, GDriveAccessor, DropboxAccessor, BoxAccessor, GmailAccessor, GCalAccessor } from '@struktoai/mirage-core';
 export * from '@struktoai/mirage-core';
-export { GoogleConfig as GmailConfig, GoogleConfigRedacted as GmailConfigRedacted, MountMode, S3BrowserOperation, S3BrowserPresignedUrlProvider, S3BrowserSignOptions, S3Config, S3ConfigRedacted, normalizeGoogleConfig as normalizeGmailConfig, redactGoogleConfig as redactGmailConfig, redactS3Config } from '@struktoai/mirage-core';
+export { GoogleConfig as GCalConfig, GoogleConfigRedacted as GCalConfigRedacted, GoogleConfig as GDocsConfig, GoogleConfigRedacted as GDocsConfigRedacted, GoogleConfig as GDriveConfig, GoogleConfigRedacted as GDriveConfigRedacted, GoogleConfig as GSheetsConfig, GoogleConfigRedacted as GSheetsConfigRedacted, GoogleConfig as GSlidesConfig, GoogleConfigRedacted as GSlidesConfigRedacted, GoogleConfig as GmailConfig, GoogleConfigRedacted as GmailConfigRedacted, Mem0Config, Mem0Resource, MountMode, OneDriveConfig, OneDriveResource, S3BrowserOperation, S3BrowserPresignedUrlProvider, S3BrowserSignOptions, S3Config, S3ConfigRedacted, SharePointConfig, SharePointResource, normalizeGoogleConfig as normalizeGCalConfig, normalizeGoogleConfig as normalizeGDocsConfig, normalizeGoogleConfig as normalizeGDriveConfig, normalizeGoogleConfig as normalizeGSheetsConfig, normalizeGoogleConfig as normalizeGSlidesConfig, normalizeGoogleConfig as normalizeGmailConfig, redactGoogleConfig as redactGCalConfig, redactGoogleConfig as redactGDocsConfig, redactGoogleConfig as redactGDriveConfig, redactGoogleConfig as redactGSheetsConfig, redactGoogleConfig as redactGSlidesConfig, redactGoogleConfig as redactGmailConfig, redactS3Config } from '@struktoai/mirage-core';
 import { OAuthClientProvider } from '@modelcontextprotocol/sdk/client/auth.js';
 
 declare class Workspace extends Workspace$1 {
@@ -26,6 +26,7 @@ interface OPFSResourceState {
 }
 declare class OPFSResource implements Resource {
     readonly kind: "opfs";
+    readonly sizesAlwaysKnown: boolean;
     readonly prompt = "{prefix}\n  Browser Origin Private File System. Persistent per-origin storage that survives page reloads.\n  Standard commands: ls, cat, head, tail, grep, wc, find, tree, mkdir, touch, cp, mv, rm, tee.";
     readonly rootName: string;
     readonly accessor: OPFSAccessor;
@@ -81,12 +82,14 @@ declare class S3Resource implements Resource {
     readonly supportsSnapshot: boolean;
     readonly kind: string;
     readonly cachesReads: boolean;
+    readonly sizesAlwaysKnown: boolean;
     readonly indexTtl: number;
     readonly prompt: string;
     readonly config: S3Config;
     readonly accessor: S3Accessor;
     readonly index: IndexCacheStore;
     constructor(config: S3Config);
+    storageId(): string;
     open(): Promise<void>;
     close(): Promise<void>;
     commands(): readonly RegisteredCommand[];
@@ -108,24 +111,23 @@ declare class S3Resource implements Resource {
     du(p: PathSpec): Promise<number>;
     find(p: PathSpec, options?: FindOptions): Promise<string[]>;
     glob(paths: readonly PathSpec[], prefix?: string): Promise<PathSpec[]>;
-    fingerprint(p: PathSpec): Promise<string | null>;
     getState(): Promise<S3ResourceState>;
     loadState(_state: S3ResourceState): Promise<void>;
-    _duAll(p: PathSpec): Promise<[[string, number][], number]>;
+    _duEntries(p: PathSpec): Promise<[[string, number][], number]>;
     _rangeRead(p: PathSpec, offset: number, size: number): Promise<Uint8Array>;
     _create(p: PathSpec): Promise<void>;
 }
 
-interface GCSConfig {
-    bucket: string;
-    presignedUrlProvider: S3BrowserPresignedUrlProvider;
-    region?: string;
-    endpoint?: string;
-    defaultContentType?: string;
-}
-interface GCSConfigRedacted extends Omit<GCSConfig, 'presignedUrlProvider'> {
-    presignedUrlProvider: '<REDACTED>';
-}
+declare const GCSConfigSchema: z.ZodObject<{
+    bucket: z.ZodString;
+    presignedUrlProvider: z.ZodCustom<S3BrowserPresignedUrlProvider, S3BrowserPresignedUrlProvider>;
+    region: z.ZodOptional<z.ZodString>;
+    endpoint: z.ZodOptional<z.ZodString>;
+    defaultContentType: z.ZodOptional<z.ZodString>;
+    keyPrefix: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type GCSConfig = ConfigOf<typeof GCSConfigSchema>;
+type GCSConfigRedacted = RedactedConfig<GCSConfig, 'presignedUrlProvider'>;
 declare function gcsToS3Config(config: GCSConfig): S3Config;
 declare function redactGcsConfig(config: GCSConfig): GCSConfigRedacted;
 
@@ -148,17 +150,17 @@ declare class GCSResource extends S3Resource {
 
 declare const GCS_BROWSER_PROMPT = "{prefix}\n  Remote Google Cloud Storage bucket accessed via presigned URLs (browser runtime).\n  Supports the full filesystem command set: ls/tree/cat/grep/find/du/cp/mv/rm/etc.\n  Listing operations require the presigner to sign LIST/COPY operations in\n  addition to GET/PUT/HEAD/DELETE \u2014 see S3BrowserPresignedUrlProvider docs.";
 
-interface R2Config {
-    bucket: string;
-    presignedUrlProvider: S3BrowserPresignedUrlProvider;
-    accountId?: string;
-    region?: string;
-    endpoint?: string;
-    defaultContentType?: string;
-}
-interface R2ConfigRedacted extends Omit<R2Config, 'presignedUrlProvider'> {
-    presignedUrlProvider: '<REDACTED>';
-}
+declare const R2ConfigSchema: z.ZodObject<{
+    bucket: z.ZodString;
+    presignedUrlProvider: z.ZodCustom<S3BrowserPresignedUrlProvider, S3BrowserPresignedUrlProvider>;
+    accountId: z.ZodOptional<z.ZodString>;
+    region: z.ZodOptional<z.ZodString>;
+    endpoint: z.ZodOptional<z.ZodString>;
+    defaultContentType: z.ZodOptional<z.ZodString>;
+    keyPrefix: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type R2Config = ConfigOf<typeof R2ConfigSchema>;
+type R2ConfigRedacted = RedactedConfig<R2Config, 'presignedUrlProvider'>;
 declare function resolvedR2Endpoint(config: R2Config): string | undefined;
 declare function r2ToS3Config(config: R2Config): S3Config;
 declare function redactR2Config(config: R2Config): R2ConfigRedacted;
@@ -182,17 +184,17 @@ declare class R2Resource extends S3Resource {
 
 declare const R2_BROWSER_PROMPT = "{prefix}\n  Remote Cloudflare R2 bucket accessed via presigned URLs (browser runtime).\n  Supports the full filesystem command set: ls/tree/cat/grep/find/du/cp/mv/rm/etc.\n  Listing operations require the presigner to sign LIST/COPY operations in\n  addition to GET/PUT/HEAD/DELETE \u2014 see S3BrowserPresignedUrlProvider docs.";
 
-interface OCIConfig {
-    bucket: string;
-    presignedUrlProvider: S3BrowserPresignedUrlProvider;
-    namespace?: string;
-    region?: string;
-    endpoint?: string;
-    defaultContentType?: string;
-}
-interface OCIConfigRedacted extends Omit<OCIConfig, 'presignedUrlProvider'> {
-    presignedUrlProvider: '<REDACTED>';
-}
+declare const OCIConfigSchema: z.ZodObject<{
+    bucket: z.ZodString;
+    presignedUrlProvider: z.ZodCustom<S3BrowserPresignedUrlProvider, S3BrowserPresignedUrlProvider>;
+    namespace: z.ZodOptional<z.ZodString>;
+    region: z.ZodOptional<z.ZodString>;
+    endpoint: z.ZodOptional<z.ZodString>;
+    defaultContentType: z.ZodOptional<z.ZodString>;
+    keyPrefix: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type OCIConfig = ConfigOf<typeof OCIConfigSchema>;
+type OCIConfigRedacted = RedactedConfig<OCIConfig, 'presignedUrlProvider'>;
 declare function resolvedOciEndpoint(config: OCIConfig): string | undefined;
 declare function ociToS3Config(config: OCIConfig): S3Config;
 declare function redactOciConfig(config: OCIConfig): OCIConfigRedacted;
@@ -216,17 +218,17 @@ declare class OCIResource extends S3Resource {
 
 declare const OCI_BROWSER_PROMPT = "{prefix}\n  Remote Oracle Cloud Object Storage accessed via presigned URLs (browser runtime).\n  Supports the full filesystem command set: ls/tree/cat/grep/find/du/cp/mv/rm/etc.\n  Listing operations require the presigner to sign LIST/COPY operations in\n  addition to GET/PUT/HEAD/DELETE \u2014 see S3BrowserPresignedUrlProvider docs.";
 
-interface SupabaseConfig {
-    bucket: string;
-    presignedUrlProvider: S3BrowserPresignedUrlProvider;
-    projectRef?: string;
-    region?: string;
-    endpoint?: string;
-    defaultContentType?: string;
-}
-interface SupabaseConfigRedacted extends Omit<SupabaseConfig, 'presignedUrlProvider'> {
-    presignedUrlProvider: '<REDACTED>';
-}
+declare const SupabaseConfigSchema: z.ZodObject<{
+    bucket: z.ZodString;
+    presignedUrlProvider: z.ZodCustom<S3BrowserPresignedUrlProvider, S3BrowserPresignedUrlProvider>;
+    projectRef: z.ZodOptional<z.ZodString>;
+    region: z.ZodOptional<z.ZodString>;
+    endpoint: z.ZodOptional<z.ZodString>;
+    defaultContentType: z.ZodOptional<z.ZodString>;
+    keyPrefix: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type SupabaseConfig = ConfigOf<typeof SupabaseConfigSchema>;
+type SupabaseConfigRedacted = RedactedConfig<SupabaseConfig, 'presignedUrlProvider'>;
 declare function resolvedSupabaseEndpoint(config: SupabaseConfig): string | undefined;
 declare function supabaseToS3Config(config: SupabaseConfig): S3Config;
 declare function redactSupabaseConfig(config: SupabaseConfig): SupabaseConfigRedacted;
@@ -250,16 +252,16 @@ declare class SupabaseResource extends S3Resource {
 
 declare const SUPABASE_BROWSER_PROMPT = "{prefix}\n  Remote Supabase Storage bucket accessed via presigned URLs (browser runtime).\n  Supports the full filesystem command set: ls/tree/cat/grep/find/du/cp/mv/rm/etc.\n  Listing operations require the presigner to sign LIST/COPY operations in\n  addition to GET/PUT/HEAD/DELETE \u2014 see S3BrowserPresignedUrlProvider docs.";
 
-interface MinIOConfig {
-    bucket: string;
-    presignedUrlProvider: S3BrowserPresignedUrlProvider;
-    endpoint?: string;
-    region?: string;
-    defaultContentType?: string;
-}
-interface MinIOConfigRedacted extends Omit<MinIOConfig, 'presignedUrlProvider'> {
-    presignedUrlProvider: '<REDACTED>';
-}
+declare const MinIOConfigSchema: z.ZodObject<{
+    bucket: z.ZodString;
+    presignedUrlProvider: z.ZodCustom<S3BrowserPresignedUrlProvider, S3BrowserPresignedUrlProvider>;
+    endpoint: z.ZodOptional<z.ZodString>;
+    region: z.ZodOptional<z.ZodString>;
+    defaultContentType: z.ZodOptional<z.ZodString>;
+    keyPrefix: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type MinIOConfig = ConfigOf<typeof MinIOConfigSchema>;
+type MinIOConfigRedacted = RedactedConfig<MinIOConfig, 'presignedUrlProvider'>;
 declare function minioToS3Config(config: MinIOConfig): S3Config;
 declare function redactMinIOConfig(config: MinIOConfig): MinIOConfigRedacted;
 
@@ -282,16 +284,16 @@ declare class MinIOResource extends S3Resource {
 
 declare const MINIO_BROWSER_PROMPT = "{prefix}\n  Remote MinIO bucket (S3-compatible) accessed via presigned URLs (browser runtime).\n  Supports the full filesystem command set: ls/tree/cat/grep/find/du/cp/mv/rm/etc.\n  Listing operations require the presigner to sign LIST/COPY operations in\n  addition to GET/PUT/HEAD/DELETE \u2014 see S3BrowserPresignedUrlProvider docs.";
 
-interface SeaweedFSConfig {
-    bucket: string;
-    presignedUrlProvider: S3BrowserPresignedUrlProvider;
-    endpoint?: string;
-    region?: string;
-    defaultContentType?: string;
-}
-interface SeaweedFSConfigRedacted extends Omit<SeaweedFSConfig, 'presignedUrlProvider'> {
-    presignedUrlProvider: '<REDACTED>';
-}
+declare const SeaweedFSConfigSchema: z.ZodObject<{
+    bucket: z.ZodString;
+    presignedUrlProvider: z.ZodCustom<S3BrowserPresignedUrlProvider, S3BrowserPresignedUrlProvider>;
+    endpoint: z.ZodOptional<z.ZodString>;
+    region: z.ZodOptional<z.ZodString>;
+    defaultContentType: z.ZodOptional<z.ZodString>;
+    keyPrefix: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type SeaweedFSConfig = ConfigOf<typeof SeaweedFSConfigSchema>;
+type SeaweedFSConfigRedacted = RedactedConfig<SeaweedFSConfig, 'presignedUrlProvider'>;
 declare function seaweedfsToS3Config(config: SeaweedFSConfig): S3Config;
 declare function redactSeaweedFSConfig(config: SeaweedFSConfig): SeaweedFSConfigRedacted;
 
@@ -314,16 +316,16 @@ declare class SeaweedFSResource extends S3Resource {
 
 declare const SEAWEEDFS_BROWSER_PROMPT = "{prefix}\n  Remote SeaweedFS bucket (S3-compatible gateway) accessed via presigned URLs (browser runtime).\n  Supports the full filesystem command set: ls/tree/cat/grep/find/du/cp/mv/rm/etc.\n  Listing operations require the presigner to sign LIST/COPY operations in\n  addition to GET/PUT/HEAD/DELETE \u2014 see S3BrowserPresignedUrlProvider docs.";
 
-interface CephConfig {
-    bucket: string;
-    presignedUrlProvider: S3BrowserPresignedUrlProvider;
-    endpoint?: string;
-    region?: string;
-    defaultContentType?: string;
-}
-interface CephConfigRedacted extends Omit<CephConfig, 'presignedUrlProvider'> {
-    presignedUrlProvider: '<REDACTED>';
-}
+declare const CephConfigSchema: z.ZodObject<{
+    bucket: z.ZodString;
+    presignedUrlProvider: z.ZodCustom<S3BrowserPresignedUrlProvider, S3BrowserPresignedUrlProvider>;
+    endpoint: z.ZodOptional<z.ZodString>;
+    region: z.ZodOptional<z.ZodString>;
+    defaultContentType: z.ZodOptional<z.ZodString>;
+    keyPrefix: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type CephConfig = ConfigOf<typeof CephConfigSchema>;
+type CephConfigRedacted = RedactedConfig<CephConfig, 'presignedUrlProvider'>;
 declare function cephToS3Config(config: CephConfig): S3Config;
 declare function redactCephConfig(config: CephConfig): CephConfigRedacted;
 
@@ -346,16 +348,16 @@ declare class CephResource extends S3Resource {
 
 declare const CEPH_BROWSER_PROMPT = "{prefix}\n  Remote Ceph Rados Gateway bucket (S3-compatible) accessed via presigned URLs (browser runtime).\n  Supports the full filesystem command set: ls/tree/cat/grep/find/du/cp/mv/rm/etc.\n  Listing operations require the presigner to sign LIST/COPY operations in\n  addition to GET/PUT/HEAD/DELETE \u2014 see S3BrowserPresignedUrlProvider docs.";
 
-interface WasabiConfig {
-    bucket: string;
-    presignedUrlProvider: S3BrowserPresignedUrlProvider;
-    region?: string;
-    endpoint?: string;
-    defaultContentType?: string;
-}
-interface WasabiConfigRedacted extends Omit<WasabiConfig, 'presignedUrlProvider'> {
-    presignedUrlProvider: '<REDACTED>';
-}
+declare const WasabiConfigSchema: z.ZodObject<{
+    bucket: z.ZodString;
+    presignedUrlProvider: z.ZodCustom<S3BrowserPresignedUrlProvider, S3BrowserPresignedUrlProvider>;
+    region: z.ZodOptional<z.ZodString>;
+    endpoint: z.ZodOptional<z.ZodString>;
+    defaultContentType: z.ZodOptional<z.ZodString>;
+    keyPrefix: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type WasabiConfig = ConfigOf<typeof WasabiConfigSchema>;
+type WasabiConfigRedacted = RedactedConfig<WasabiConfig, 'presignedUrlProvider'>;
 declare function resolvedWasabiEndpoint(config: WasabiConfig): string;
 declare function wasabiToS3Config(config: WasabiConfig): S3Config;
 declare function redactWasabiConfig(config: WasabiConfig): WasabiConfigRedacted;
@@ -379,16 +381,16 @@ declare class WasabiResource extends S3Resource {
 
 declare const WASABI_BROWSER_PROMPT = "{prefix}\n  Remote Wasabi bucket (S3-compatible) accessed via presigned URLs (browser runtime).\n  Supports the full filesystem command set: ls/tree/cat/grep/find/du/cp/mv/rm/etc.\n  Listing operations require the presigner to sign LIST/COPY operations in\n  addition to GET/PUT/HEAD/DELETE \u2014 see S3BrowserPresignedUrlProvider docs.";
 
-interface BackblazeConfig {
-    bucket: string;
-    presignedUrlProvider: S3BrowserPresignedUrlProvider;
-    region?: string;
-    endpoint?: string;
-    defaultContentType?: string;
-}
-interface BackblazeConfigRedacted extends Omit<BackblazeConfig, 'presignedUrlProvider'> {
-    presignedUrlProvider: '<REDACTED>';
-}
+declare const BackblazeConfigSchema: z.ZodObject<{
+    bucket: z.ZodString;
+    presignedUrlProvider: z.ZodCustom<S3BrowserPresignedUrlProvider, S3BrowserPresignedUrlProvider>;
+    region: z.ZodOptional<z.ZodString>;
+    endpoint: z.ZodOptional<z.ZodString>;
+    defaultContentType: z.ZodOptional<z.ZodString>;
+    keyPrefix: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type BackblazeConfig = ConfigOf<typeof BackblazeConfigSchema>;
+type BackblazeConfigRedacted = RedactedConfig<BackblazeConfig, 'presignedUrlProvider'>;
 declare function resolvedBackblazeEndpoint(config: BackblazeConfig): string | undefined;
 declare function backblazeToS3Config(config: BackblazeConfig): S3Config;
 declare function redactBackblazeConfig(config: BackblazeConfig): BackblazeConfigRedacted;
@@ -412,16 +414,16 @@ declare class BackblazeResource extends S3Resource {
 
 declare const BACKBLAZE_BROWSER_PROMPT = "{prefix}\n  Remote Backblaze B2 bucket (S3-compatible) accessed via presigned URLs (browser runtime).\n  Supports the full filesystem command set: ls/tree/cat/grep/find/du/cp/mv/rm/etc.\n  Listing operations require the presigner to sign LIST/COPY operations in\n  addition to GET/PUT/HEAD/DELETE \u2014 see S3BrowserPresignedUrlProvider docs.";
 
-interface DigitalOceanConfig {
-    bucket: string;
-    presignedUrlProvider: S3BrowserPresignedUrlProvider;
-    region?: string;
-    endpoint?: string;
-    defaultContentType?: string;
-}
-interface DigitalOceanConfigRedacted extends Omit<DigitalOceanConfig, 'presignedUrlProvider'> {
-    presignedUrlProvider: '<REDACTED>';
-}
+declare const DigitalOceanConfigSchema: z.ZodObject<{
+    bucket: z.ZodString;
+    presignedUrlProvider: z.ZodCustom<S3BrowserPresignedUrlProvider, S3BrowserPresignedUrlProvider>;
+    region: z.ZodOptional<z.ZodString>;
+    endpoint: z.ZodOptional<z.ZodString>;
+    defaultContentType: z.ZodOptional<z.ZodString>;
+    keyPrefix: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type DigitalOceanConfig = ConfigOf<typeof DigitalOceanConfigSchema>;
+type DigitalOceanConfigRedacted = RedactedConfig<DigitalOceanConfig, 'presignedUrlProvider'>;
 declare function resolvedDigitalOceanEndpoint(config: DigitalOceanConfig): string | undefined;
 declare function digitalOceanToS3Config(config: DigitalOceanConfig): S3Config;
 declare function redactDigitalOceanConfig(config: DigitalOceanConfig): DigitalOceanConfigRedacted;
@@ -445,16 +447,16 @@ declare class DigitalOceanResource extends S3Resource {
 
 declare const DIGITALOCEAN_BROWSER_PROMPT = "{prefix}\n  Remote DigitalOcean Spaces bucket (S3-compatible) accessed via presigned URLs (browser runtime).\n  Supports the full filesystem command set: ls/tree/cat/grep/find/du/cp/mv/rm/etc.\n  Listing operations require the presigner to sign LIST/COPY operations in\n  addition to GET/PUT/HEAD/DELETE \u2014 see S3BrowserPresignedUrlProvider docs.";
 
-interface TencentConfig {
-    bucket: string;
-    presignedUrlProvider: S3BrowserPresignedUrlProvider;
-    region?: string;
-    endpoint?: string;
-    defaultContentType?: string;
-}
-interface TencentConfigRedacted extends Omit<TencentConfig, 'presignedUrlProvider'> {
-    presignedUrlProvider: '<REDACTED>';
-}
+declare const TencentConfigSchema: z.ZodObject<{
+    bucket: z.ZodString;
+    presignedUrlProvider: z.ZodCustom<S3BrowserPresignedUrlProvider, S3BrowserPresignedUrlProvider>;
+    region: z.ZodOptional<z.ZodString>;
+    endpoint: z.ZodOptional<z.ZodString>;
+    defaultContentType: z.ZodOptional<z.ZodString>;
+    keyPrefix: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type TencentConfig = ConfigOf<typeof TencentConfigSchema>;
+type TencentConfigRedacted = RedactedConfig<TencentConfig, 'presignedUrlProvider'>;
 declare function resolvedTencentEndpoint(config: TencentConfig): string | undefined;
 declare function tencentToS3Config(config: TencentConfig): S3Config;
 declare function redactTencentConfig(config: TencentConfig): TencentConfigRedacted;
@@ -478,16 +480,16 @@ declare class TencentResource extends S3Resource {
 
 declare const TENCENT_BROWSER_PROMPT = "{prefix}\n  Remote Tencent Cloud COS bucket (S3-compatible) accessed via presigned URLs (browser runtime).\n  Supports the full filesystem command set: ls/tree/cat/grep/find/du/cp/mv/rm/etc.\n  Listing operations require the presigner to sign LIST/COPY operations in\n  addition to GET/PUT/HEAD/DELETE \u2014 see S3BrowserPresignedUrlProvider docs.";
 
-interface AliyunConfig {
-    bucket: string;
-    presignedUrlProvider: S3BrowserPresignedUrlProvider;
-    region?: string;
-    endpoint?: string;
-    defaultContentType?: string;
-}
-interface AliyunConfigRedacted extends Omit<AliyunConfig, 'presignedUrlProvider'> {
-    presignedUrlProvider: '<REDACTED>';
-}
+declare const AliyunConfigSchema: z.ZodObject<{
+    bucket: z.ZodString;
+    presignedUrlProvider: z.ZodCustom<S3BrowserPresignedUrlProvider, S3BrowserPresignedUrlProvider>;
+    region: z.ZodOptional<z.ZodString>;
+    endpoint: z.ZodOptional<z.ZodString>;
+    defaultContentType: z.ZodOptional<z.ZodString>;
+    keyPrefix: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type AliyunConfig = ConfigOf<typeof AliyunConfigSchema>;
+type AliyunConfigRedacted = RedactedConfig<AliyunConfig, 'presignedUrlProvider'>;
 declare function resolvedAliyunEndpoint(config: AliyunConfig): string | undefined;
 declare function aliyunToS3Config(config: AliyunConfig): S3Config;
 declare function redactAliyunConfig(config: AliyunConfig): AliyunConfigRedacted;
@@ -511,16 +513,16 @@ declare class AliyunResource extends S3Resource {
 
 declare const ALIYUN_BROWSER_PROMPT = "{prefix}\n  Remote Alibaba Cloud OSS bucket (S3-compatible) accessed via presigned URLs (browser runtime).\n  Supports the full filesystem command set: ls/tree/cat/grep/find/du/cp/mv/rm/etc.\n  Listing operations require the presigner to sign LIST/COPY operations in\n  addition to GET/PUT/HEAD/DELETE \u2014 see S3BrowserPresignedUrlProvider docs.";
 
-interface ScalewayConfig {
-    bucket: string;
-    presignedUrlProvider: S3BrowserPresignedUrlProvider;
-    region?: string;
-    endpoint?: string;
-    defaultContentType?: string;
-}
-interface ScalewayConfigRedacted extends Omit<ScalewayConfig, 'presignedUrlProvider'> {
-    presignedUrlProvider: '<REDACTED>';
-}
+declare const ScalewayConfigSchema: z.ZodObject<{
+    bucket: z.ZodString;
+    presignedUrlProvider: z.ZodCustom<S3BrowserPresignedUrlProvider, S3BrowserPresignedUrlProvider>;
+    region: z.ZodOptional<z.ZodString>;
+    endpoint: z.ZodOptional<z.ZodString>;
+    defaultContentType: z.ZodOptional<z.ZodString>;
+    keyPrefix: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type ScalewayConfig = ConfigOf<typeof ScalewayConfigSchema>;
+type ScalewayConfigRedacted = RedactedConfig<ScalewayConfig, 'presignedUrlProvider'>;
 declare function resolvedScalewayEndpoint(config: ScalewayConfig): string | undefined;
 declare function scalewayToS3Config(config: ScalewayConfig): S3Config;
 declare function redactScalewayConfig(config: ScalewayConfig): ScalewayConfigRedacted;
@@ -544,16 +546,16 @@ declare class ScalewayResource extends S3Resource {
 
 declare const SCALEWAY_BROWSER_PROMPT = "{prefix}\n  Remote Scaleway Object Storage bucket (S3-compatible) accessed via presigned URLs (browser runtime).\n  Supports the full filesystem command set: ls/tree/cat/grep/find/du/cp/mv/rm/etc.\n  Listing operations require the presigner to sign LIST/COPY operations in\n  addition to GET/PUT/HEAD/DELETE \u2014 see S3BrowserPresignedUrlProvider docs.";
 
-interface QingStorConfig {
-    bucket: string;
-    presignedUrlProvider: S3BrowserPresignedUrlProvider;
-    region?: string;
-    endpoint?: string;
-    defaultContentType?: string;
-}
-interface QingStorConfigRedacted extends Omit<QingStorConfig, 'presignedUrlProvider'> {
-    presignedUrlProvider: '<REDACTED>';
-}
+declare const QingStorConfigSchema: z.ZodObject<{
+    bucket: z.ZodString;
+    presignedUrlProvider: z.ZodCustom<S3BrowserPresignedUrlProvider, S3BrowserPresignedUrlProvider>;
+    region: z.ZodOptional<z.ZodString>;
+    endpoint: z.ZodOptional<z.ZodString>;
+    defaultContentType: z.ZodOptional<z.ZodString>;
+    keyPrefix: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type QingStorConfig = ConfigOf<typeof QingStorConfigSchema>;
+type QingStorConfigRedacted = RedactedConfig<QingStorConfig, 'presignedUrlProvider'>;
 declare function resolvedQingStorEndpoint(config: QingStorConfig): string | undefined;
 declare function qingStorToS3Config(config: QingStorConfig): S3Config;
 declare function redactQingStorConfig(config: QingStorConfig): QingStorConfigRedacted;
@@ -577,14 +579,13 @@ declare class QingStorResource extends S3Resource {
 
 declare const QINGSTOR_BROWSER_PROMPT = "{prefix}\n  Remote QingStor bucket (S3-compatible) accessed via presigned URLs (browser runtime).\n  Supports the full filesystem command set: ls/tree/cat/grep/find/du/cp/mv/rm/etc.\n  Listing operations require the presigner to sign LIST/COPY operations in\n  addition to GET/PUT/HEAD/DELETE \u2014 see S3BrowserPresignedUrlProvider docs.";
 
-interface SlackConfig {
-    proxyUrl: string;
-    getHeaders?: () => Promise<Record<string, string>> | Record<string, string>;
-}
-interface SlackConfigRedacted {
-    proxyUrl: string;
-    getHeaders?: '<REDACTED>';
-}
+type HeaderProvider$1 = () => Promise<Record<string, string>> | Record<string, string>;
+declare const SlackConfigSchema: z.ZodObject<{
+    proxyUrl: z.ZodString;
+    getHeaders: z.ZodOptional<z.ZodCustom<HeaderProvider$1, HeaderProvider$1>>;
+}, z.core.$strip>;
+type SlackConfig = ConfigOf<typeof SlackConfigSchema>;
+type SlackConfigRedacted = RedactedConfig<SlackConfig, 'getHeaders'>;
 declare function redactSlackConfig(config: SlackConfig): SlackConfigRedacted;
 
 interface SlackResourceState {
@@ -594,6 +595,7 @@ interface SlackResourceState {
 declare class SlackResource implements Resource {
     readonly kind: string;
     readonly cachesReads: boolean;
+    readonly sizesAlwaysKnown: boolean;
     readonly indexTtl: number;
     readonly prompt: string;
     readonly writePrompt: string;
@@ -608,20 +610,18 @@ declare class SlackResource implements Resource {
     readFile(p: PathSpec): Promise<Uint8Array>;
     readdir(p: PathSpec): Promise<string[]>;
     stat(p: PathSpec): Promise<FileStat>;
-    fingerprint(p: PathSpec): Promise<string | null>;
     glob(paths: readonly PathSpec[], prefix?: string): Promise<PathSpec[]>;
     getState(): Promise<SlackResourceState>;
     loadState(_state: SlackResourceState): Promise<void>;
 }
 
-interface DiscordConfig {
-    proxyUrl: string;
-    getHeaders?: () => Promise<Record<string, string>> | Record<string, string>;
-}
-interface DiscordConfigRedacted {
-    proxyUrl: string;
-    getHeaders?: '<REDACTED>';
-}
+type HeaderProvider = () => Promise<Record<string, string>> | Record<string, string>;
+declare const DiscordConfigSchema: z.ZodObject<{
+    proxyUrl: z.ZodString;
+    getHeaders: z.ZodOptional<z.ZodCustom<HeaderProvider, HeaderProvider>>;
+}, z.core.$strip>;
+type DiscordConfig = ConfigOf<typeof DiscordConfigSchema>;
+type DiscordConfigRedacted = RedactedConfig<DiscordConfig, 'getHeaders'>;
 declare function redactDiscordConfig(config: DiscordConfig): DiscordConfigRedacted;
 
 interface DiscordResourceState {
@@ -631,6 +631,7 @@ interface DiscordResourceState {
 declare class DiscordResource implements Resource {
     readonly kind: string;
     readonly cachesReads: boolean;
+    readonly sizesAlwaysKnown: boolean;
     readonly indexTtl: number;
     readonly prompt: string;
     readonly writePrompt: string;
@@ -645,7 +646,6 @@ declare class DiscordResource implements Resource {
     readFile(p: PathSpec): Promise<Uint8Array>;
     readdir(p: PathSpec): Promise<string[]>;
     stat(p: PathSpec): Promise<FileStat>;
-    fingerprint(p: PathSpec): Promise<string | null>;
     glob(paths: readonly PathSpec[], prefix?: string): Promise<PathSpec[]>;
     getState(): Promise<DiscordResourceState>;
     loadState(_state: DiscordResourceState): Promise<void>;
@@ -734,20 +734,15 @@ declare class HttpMongoDriver implements MongoDriver {
     close(): Promise<void>;
 }
 
-interface TrelloConfig {
-    apiKey: string;
-    apiToken: string;
-    workspaceId?: string;
-    boardIds?: readonly string[];
-    baseUrl?: string;
-}
-interface TrelloConfigRedacted {
-    apiKey: '<REDACTED>';
-    apiToken: '<REDACTED>';
-    workspaceId?: string;
-    boardIds?: readonly string[];
-    baseUrl?: string;
-}
+declare const TrelloConfigSchema: z.ZodObject<{
+    apiKey: z.ZodString;
+    apiToken: z.ZodString;
+    workspaceId: z.ZodOptional<z.ZodString>;
+    boardIds: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
+    baseUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type TrelloConfig = ConfigOf<typeof TrelloConfigSchema>;
+type TrelloConfigRedacted = RedactedConfig<TrelloConfig, 'apiKey' | 'apiToken'>;
 declare function redactTrelloConfig(config: TrelloConfig): TrelloConfigRedacted;
 
 interface TrelloResourceState {
@@ -772,24 +767,19 @@ declare class TrelloResource implements Resource {
     readFile(p: PathSpec): Promise<Uint8Array>;
     readdir(p: PathSpec): Promise<string[]>;
     stat(p: PathSpec): Promise<FileStat>;
-    fingerprint(p: PathSpec): Promise<string | null>;
     glob(paths: readonly PathSpec[], prefix?: string): Promise<PathSpec[]>;
     getState(): Promise<TrelloResourceState>;
     loadState(_state: TrelloResourceState): Promise<void>;
 }
 
-interface LinearConfig {
-    apiKey: string;
-    workspace?: string;
-    teamIds?: readonly string[];
-    baseUrl?: string;
-}
-interface LinearConfigRedacted {
-    apiKey: '<REDACTED>';
-    workspace?: string;
-    teamIds?: readonly string[];
-    baseUrl?: string;
-}
+declare const LinearConfigSchema: z.ZodObject<{
+    apiKey: z.ZodString;
+    workspace: z.ZodOptional<z.ZodString>;
+    teamIds: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
+    baseUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type LinearConfig = ConfigOf<typeof LinearConfigSchema>;
+type LinearConfigRedacted = RedactedConfig<LinearConfig, 'apiKey'>;
 declare function redactLinearConfig(config: LinearConfig): LinearConfigRedacted;
 
 interface LinearResourceState {
@@ -799,6 +789,7 @@ interface LinearResourceState {
 declare class LinearResource implements Resource {
     readonly kind: string;
     readonly cachesReads: boolean;
+    readonly sizesAlwaysKnown: boolean;
     readonly indexTtl: number;
     readonly prompt: string;
     readonly writePrompt: string;
@@ -814,20 +805,17 @@ declare class LinearResource implements Resource {
     readFile(p: PathSpec): Promise<Uint8Array>;
     readdir(p: PathSpec): Promise<string[]>;
     stat(p: PathSpec): Promise<FileStat>;
-    fingerprint(p: PathSpec): Promise<string | null>;
     glob(paths: readonly PathSpec[], prefix?: string): Promise<PathSpec[]>;
     getState(): Promise<LinearResourceState>;
     loadState(_state: LinearResourceState): Promise<void>;
 }
 
-interface NotionConfig {
-    authProvider: OAuthClientProvider;
-    serverUrl?: string;
-}
-interface NotionConfigRedacted {
-    authProvider: '<REDACTED>';
-    serverUrl?: string;
-}
+declare const NotionConfigSchema: z.ZodObject<{
+    authProvider: z.ZodCustom<OAuthClientProvider, OAuthClientProvider>;
+    serverUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type NotionConfig = ConfigOf<typeof NotionConfigSchema>;
+type NotionConfigRedacted = RedactedConfig<NotionConfig, 'authProvider'>;
 declare function redactNotionConfig(config: NotionConfig): NotionConfigRedacted;
 
 interface NotionResourceState {
@@ -851,28 +839,21 @@ declare class NotionResource implements Resource {
     readFile(p: PathSpec): Promise<Uint8Array>;
     readdir(p: PathSpec): Promise<string[]>;
     stat(p: PathSpec): Promise<FileStat>;
-    fingerprint(p: PathSpec): Promise<string | null>;
     glob(paths: readonly PathSpec[], prefix?: string): Promise<PathSpec[]>;
     getState(): Promise<NotionResourceState>;
     loadState(_state: NotionResourceState): Promise<void>;
 }
 
-interface LangfuseConfig {
-    publicKey: string;
-    secretKey: string;
-    host?: string;
-    defaultTraceLimit?: number;
-    defaultSearchLimit?: number;
-    defaultFromTimestamp?: string;
-}
-interface LangfuseConfigRedacted {
-    publicKey: string;
-    secretKey: '<REDACTED>';
-    host?: string;
-    defaultTraceLimit?: number;
-    defaultSearchLimit?: number;
-    defaultFromTimestamp?: string;
-}
+declare const LangfuseConfigSchema: z.ZodObject<{
+    publicKey: z.ZodString;
+    secretKey: z.ZodString;
+    host: z.ZodOptional<z.ZodString>;
+    defaultTraceLimit: z.ZodOptional<z.ZodNumber>;
+    defaultSearchLimit: z.ZodOptional<z.ZodNumber>;
+    defaultFromTimestamp: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type LangfuseConfig = ConfigOf<typeof LangfuseConfigSchema>;
+type LangfuseConfigRedacted = RedactedConfig<LangfuseConfig, 'secretKey'>;
 declare function redactLangfuseConfig(config: LangfuseConfig): LangfuseConfigRedacted;
 
 interface LangfuseResourceState {
@@ -895,26 +876,20 @@ declare class LangfuseResource implements Resource {
     readFile(p: PathSpec): Promise<Uint8Array>;
     readdir(p: PathSpec): Promise<string[]>;
     stat(p: PathSpec): Promise<FileStat>;
-    fingerprint(_p: PathSpec): Promise<string | null>;
     glob(paths: readonly PathSpec[], prefix?: string): Promise<PathSpec[]>;
     getState(): Promise<LangfuseResourceState>;
     loadState(_state: LangfuseResourceState): Promise<void>;
 }
 
-interface GitHubConfig {
-    token: string;
-    owner: string;
-    repo: string;
-    ref?: string;
-    baseUrl?: string;
-}
-interface GitHubConfigRedacted {
-    token: '<REDACTED>';
-    owner: string;
-    repo: string;
-    ref?: string;
-    baseUrl?: string;
-}
+declare const GitHubConfigSchema: z.ZodObject<{
+    token: z.ZodString;
+    owner: z.ZodString;
+    repo: z.ZodString;
+    ref: z.ZodOptional<z.ZodString>;
+    baseUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type GitHubConfig = ConfigOf<typeof GitHubConfigSchema>;
+type GitHubConfigRedacted = RedactedConfig<GitHubConfig, 'token'>;
 declare function redactGitHubConfig(config: GitHubConfig): GitHubConfigRedacted;
 declare function normalizeGitHubConfig(input: Record<string, unknown>): GitHubConfig;
 
@@ -927,6 +902,8 @@ interface GitHubResourceState {
 declare class GitHubResource implements Resource {
     readonly kind: string;
     readonly cachesReads: boolean;
+    readonly sizesAlwaysKnown: boolean;
+    readonly supportsSnapshot: boolean;
     readonly indexTtl: number;
     readonly prompt: string;
     readonly config: GitHubConfig;
@@ -941,26 +918,20 @@ declare class GitHubResource implements Resource {
     readFile(p: PathSpec): Promise<Uint8Array>;
     readdir(p: PathSpec): Promise<string[]>;
     stat(p: PathSpec): Promise<FileStat>;
-    fingerprint(p: PathSpec): Promise<string | null>;
     glob(paths: readonly PathSpec[], prefix?: string): Promise<PathSpec[]>;
     getState(): Promise<GitHubResourceState>;
     loadState(_state: GitHubResourceState): Promise<void>;
 }
 
-interface GitHubCIConfig {
-    token: string;
-    owner: string;
-    repo: string;
-    days?: number;
-    baseUrl?: string;
-}
-interface GitHubCIConfigRedacted {
-    token: '<REDACTED>';
-    owner: string;
-    repo: string;
-    days?: number;
-    baseUrl?: string;
-}
+declare const GitHubCIConfigSchema: z.ZodObject<{
+    token: z.ZodString;
+    owner: z.ZodString;
+    repo: z.ZodString;
+    days: z.ZodOptional<z.ZodNumber>;
+    baseUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type GitHubCIConfig = ConfigOf<typeof GitHubCIConfigSchema>;
+type GitHubCIConfigRedacted = RedactedConfig<GitHubCIConfig, 'token'>;
 declare function redactGitHubCIConfig(config: GitHubCIConfig): GitHubCIConfigRedacted;
 declare function normalizeGitHubCIConfig(input: Record<string, unknown>): GitHubCIConfig;
 
@@ -984,32 +955,14 @@ declare class GitHubCIResource implements Resource {
     readFile(p: PathSpec): Promise<Uint8Array>;
     readdir(p: PathSpec): Promise<string[]>;
     stat(p: PathSpec): Promise<FileStat>;
-    fingerprint(p: PathSpec): Promise<string | null>;
     glob(paths: readonly PathSpec[], prefix?: string): Promise<PathSpec[]>;
     getState(): Promise<GitHubCIResourceState>;
     loadState(_state: GitHubCIResourceState): Promise<void>;
 }
 
-interface GDocsConfig {
-    clientId: string;
-    clientSecret?: string;
-    refreshToken: string;
-    refreshFn?: (refreshToken: string) => Promise<{
-        accessToken: string;
-        expiresIn: number;
-    }>;
-}
-interface GDocsConfigRedacted {
-    clientId: string;
-    clientSecret?: '<REDACTED>';
-    refreshToken: '<REDACTED>';
-}
-declare function redactGDocsConfig(config: GDocsConfig): GDocsConfigRedacted;
-declare function normalizeGDocsConfig(input: Record<string, unknown>): GDocsConfig;
-
 interface GDocsResourceState {
     type: string;
-    config: GDocsConfigRedacted;
+    config: GoogleConfigRedacted;
 }
 declare class GDocsResource implements Resource {
     readonly kind: string;
@@ -1017,10 +970,10 @@ declare class GDocsResource implements Resource {
     readonly indexTtl: number;
     readonly prompt: string;
     readonly writePrompt: string;
-    readonly config: GDocsConfig;
+    readonly config: GoogleConfig;
     readonly accessor: GDocsAccessor;
     readonly index: IndexCacheStore;
-    constructor(config: GDocsConfig);
+    constructor(config: GoogleConfig);
     open(): Promise<void>;
     close(): Promise<void>;
     commands(): readonly RegisteredCommand[];
@@ -1028,32 +981,14 @@ declare class GDocsResource implements Resource {
     readFile(p: PathSpec): Promise<Uint8Array>;
     readdir(p: PathSpec): Promise<string[]>;
     stat(p: PathSpec): Promise<FileStat>;
-    fingerprint(p: PathSpec): Promise<string | null>;
     glob(paths: readonly PathSpec[], prefix?: string): Promise<PathSpec[]>;
     getState(): Promise<GDocsResourceState>;
     loadState(_state: GDocsResourceState): Promise<void>;
 }
 
-interface GSheetsConfig {
-    clientId: string;
-    clientSecret?: string;
-    refreshToken: string;
-    refreshFn?: (refreshToken: string) => Promise<{
-        accessToken: string;
-        expiresIn: number;
-    }>;
-}
-interface GSheetsConfigRedacted {
-    clientId: string;
-    clientSecret?: '<REDACTED>';
-    refreshToken: '<REDACTED>';
-}
-declare function redactGSheetsConfig(config: GSheetsConfig): GSheetsConfigRedacted;
-declare function normalizeGSheetsConfig(input: Record<string, unknown>): GSheetsConfig;
-
 interface GSheetsResourceState {
     type: string;
-    config: GSheetsConfigRedacted;
+    config: GoogleConfigRedacted;
 }
 declare class GSheetsResource implements Resource {
     readonly kind: string;
@@ -1061,10 +996,10 @@ declare class GSheetsResource implements Resource {
     readonly indexTtl: number;
     readonly prompt: string;
     readonly writePrompt: string;
-    readonly config: GSheetsConfig;
+    readonly config: GoogleConfig;
     readonly accessor: GSheetsAccessor;
     readonly index: IndexCacheStore;
-    constructor(config: GSheetsConfig);
+    constructor(config: GoogleConfig);
     open(): Promise<void>;
     close(): Promise<void>;
     commands(): readonly RegisteredCommand[];
@@ -1072,32 +1007,14 @@ declare class GSheetsResource implements Resource {
     readFile(p: PathSpec): Promise<Uint8Array>;
     readdir(p: PathSpec): Promise<string[]>;
     stat(p: PathSpec): Promise<FileStat>;
-    fingerprint(p: PathSpec): Promise<string | null>;
     glob(paths: readonly PathSpec[], prefix?: string): Promise<PathSpec[]>;
     getState(): Promise<GSheetsResourceState>;
     loadState(_state: GSheetsResourceState): Promise<void>;
 }
 
-interface GSlidesConfig {
-    clientId: string;
-    clientSecret?: string;
-    refreshToken: string;
-    refreshFn?: (refreshToken: string) => Promise<{
-        accessToken: string;
-        expiresIn: number;
-    }>;
-}
-interface GSlidesConfigRedacted {
-    clientId: string;
-    clientSecret?: '<REDACTED>';
-    refreshToken: '<REDACTED>';
-}
-declare function redactGSlidesConfig(config: GSlidesConfig): GSlidesConfigRedacted;
-declare function normalizeGSlidesConfig(input: Record<string, unknown>): GSlidesConfig;
-
 interface GSlidesResourceState {
     type: string;
-    config: GSlidesConfigRedacted;
+    config: GoogleConfigRedacted;
 }
 declare class GSlidesResource implements Resource {
     readonly kind: string;
@@ -1105,10 +1022,10 @@ declare class GSlidesResource implements Resource {
     readonly indexTtl: number;
     readonly prompt: string;
     readonly writePrompt: string;
-    readonly config: GSlidesConfig;
+    readonly config: GoogleConfig;
     readonly accessor: GSlidesAccessor;
     readonly index: IndexCacheStore;
-    constructor(config: GSlidesConfig);
+    constructor(config: GoogleConfig);
     open(): Promise<void>;
     close(): Promise<void>;
     commands(): readonly RegisteredCommand[];
@@ -1116,42 +1033,25 @@ declare class GSlidesResource implements Resource {
     readFile(p: PathSpec): Promise<Uint8Array>;
     readdir(p: PathSpec): Promise<string[]>;
     stat(p: PathSpec): Promise<FileStat>;
-    fingerprint(p: PathSpec): Promise<string | null>;
     glob(paths: readonly PathSpec[], prefix?: string): Promise<PathSpec[]>;
     getState(): Promise<GSlidesResourceState>;
     loadState(_state: GSlidesResourceState): Promise<void>;
 }
 
-interface GDriveConfig {
-    clientId: string;
-    clientSecret?: string;
-    refreshToken: string;
-    refreshFn?: (refreshToken: string) => Promise<{
-        accessToken: string;
-        expiresIn: number;
-    }>;
-}
-interface GDriveConfigRedacted {
-    clientId: string;
-    clientSecret?: '<REDACTED>';
-    refreshToken: '<REDACTED>';
-}
-declare function redactGDriveConfig(config: GDriveConfig): GDriveConfigRedacted;
-declare function normalizeGDriveConfig(input: Record<string, unknown>): GDriveConfig;
-
 interface GDriveResourceState {
     type: string;
-    config: GDriveConfigRedacted;
+    config: GoogleConfigRedacted;
 }
 declare class GDriveResource implements Resource {
     readonly kind: string;
     readonly cachesReads: boolean;
+    readonly supportsSnapshot: boolean;
     readonly indexTtl: number;
     readonly prompt: string;
-    readonly config: GDriveConfig;
+    readonly config: GoogleConfig;
     readonly accessor: GDriveAccessor;
     readonly index: IndexCacheStore;
-    constructor(config: GDriveConfig);
+    constructor(config: GoogleConfig);
     open(): Promise<void>;
     close(): Promise<void>;
     commands(): readonly RegisteredCommand[];
@@ -1159,7 +1059,6 @@ declare class GDriveResource implements Resource {
     readFile(p: PathSpec): Promise<Uint8Array>;
     readdir(p: PathSpec): Promise<string[]>;
     stat(p: PathSpec): Promise<FileStat>;
-    fingerprint(p: PathSpec): Promise<string | null>;
     glob(paths: readonly PathSpec[], prefix?: string): Promise<PathSpec[]>;
     getState(): Promise<GDriveResourceState>;
     loadState(_state: GDriveResourceState): Promise<void>;
@@ -1169,16 +1068,23 @@ interface DropboxConfig {
     clientId: string;
     clientSecret?: string;
     refreshToken: string;
+    rootPath?: string;
+    contentSearch?: boolean;
+    endpoint?: string;
     refreshFn?: (refreshToken: string) => Promise<{
         accessToken: string;
         expiresIn: number;
     }>;
 }
-interface DropboxConfigRedacted {
-    clientId: string;
-    clientSecret?: '<REDACTED>';
-    refreshToken: '<REDACTED>';
-}
+declare const DropboxConfigSchema: z.ZodObject<{
+    clientId: z.ZodString;
+    clientSecret: z.ZodOptional<z.ZodString>;
+    refreshToken: z.ZodString;
+    rootPath: z.ZodOptional<z.ZodString>;
+    contentSearch: z.ZodOptional<z.ZodBoolean>;
+    endpoint: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type DropboxConfigRedacted = RedactedConfig<ConfigOf<typeof DropboxConfigSchema>, 'clientSecret' | 'refreshToken'>;
 declare function redactDropboxConfig(config: DropboxConfig): DropboxConfigRedacted;
 declare function normalizeDropboxConfig(input: Record<string, unknown>): DropboxConfig;
 
@@ -1189,6 +1095,7 @@ interface DropboxResourceState {
 declare class DropboxResource implements Resource {
     readonly kind: string;
     readonly cachesReads: boolean;
+    readonly sizesAlwaysKnown: boolean;
     readonly indexTtl: number;
     readonly prompt: string;
     readonly config: DropboxConfig;
@@ -1202,13 +1109,15 @@ declare class DropboxResource implements Resource {
     readFile(p: PathSpec): Promise<Uint8Array>;
     readdir(p: PathSpec): Promise<string[]>;
     stat(p: PathSpec): Promise<FileStat>;
-    fingerprint(p: PathSpec): Promise<string | null>;
     glob(paths: readonly PathSpec[], prefix?: string): Promise<PathSpec[]>;
     getState(): Promise<DropboxResourceState>;
     loadState(_state: DropboxResourceState): Promise<void>;
 }
 
 interface BoxConfig {
+    endpoint?: string;
+    rootFolderId?: string;
+    contentSearch?: boolean;
     clientId?: string;
     clientSecret?: string;
     refreshToken?: string;
@@ -1220,12 +1129,16 @@ interface BoxConfig {
     }>;
     onRefreshTokenRotated?: (newRefreshToken: string) => void | Promise<void>;
 }
-interface BoxConfigRedacted {
-    clientId?: string;
-    clientSecret?: '<REDACTED>';
-    refreshToken?: '<REDACTED>';
-    accessToken?: '<REDACTED>';
-}
+declare const BoxConfigSchema: z.ZodObject<{
+    endpoint: z.ZodOptional<z.ZodString>;
+    rootFolderId: z.ZodOptional<z.ZodString>;
+    contentSearch: z.ZodOptional<z.ZodBoolean>;
+    clientId: z.ZodOptional<z.ZodString>;
+    clientSecret: z.ZodOptional<z.ZodString>;
+    refreshToken: z.ZodOptional<z.ZodString>;
+    accessToken: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type BoxConfigRedacted = RedactedConfig<ConfigOf<typeof BoxConfigSchema>, 'clientSecret' | 'refreshToken' | 'accessToken'>;
 declare function redactBoxConfig(config: BoxConfig): BoxConfigRedacted;
 declare function normalizeBoxConfig(input: Record<string, unknown>): BoxConfig;
 
@@ -1236,6 +1149,7 @@ interface BoxResourceState {
 declare class BoxResource implements Resource {
     readonly kind: string;
     readonly cachesReads: boolean;
+    readonly sizesAlwaysKnown: boolean;
     readonly indexTtl: number;
     readonly prompt: string;
     readonly config: BoxConfig;
@@ -1249,7 +1163,6 @@ declare class BoxResource implements Resource {
     readFile(p: PathSpec): Promise<Uint8Array>;
     readdir(p: PathSpec): Promise<string[]>;
     stat(p: PathSpec): Promise<FileStat>;
-    fingerprint(p: PathSpec): Promise<string | null>;
     glob(paths: readonly PathSpec[], prefix?: string): Promise<PathSpec[]>;
     getState(): Promise<BoxResourceState>;
     loadState(_state: BoxResourceState): Promise<void>;
@@ -1262,6 +1175,7 @@ interface GmailResourceState {
 declare class GmailResource implements Resource {
     readonly kind: string;
     readonly cachesReads: boolean;
+    readonly sizesAlwaysKnown: boolean;
     readonly indexTtl: number;
     readonly prompt: string;
     readonly writePrompt: string;
@@ -1276,12 +1190,37 @@ declare class GmailResource implements Resource {
     readFile(p: PathSpec): Promise<Uint8Array>;
     readdir(p: PathSpec): Promise<string[]>;
     stat(p: PathSpec): Promise<FileStat>;
-    fingerprint(p: PathSpec): Promise<string | null>;
     glob(paths: readonly PathSpec[], prefix?: string): Promise<PathSpec[]>;
     getState(): Promise<GmailResourceState>;
     loadState(_state: GmailResourceState): Promise<void>;
 }
 
+interface GCalResourceState {
+    type: string;
+    config: GoogleConfigRedacted;
+}
+declare class GCalResource implements Resource {
+    readonly kind: string;
+    readonly cachesReads: boolean;
+    readonly indexTtl: number;
+    readonly prompt: string;
+    readonly writePrompt: string;
+    readonly config: GoogleConfig;
+    readonly accessor: GCalAccessor;
+    readonly index: IndexCacheStore;
+    constructor(config: GoogleConfig);
+    open(): Promise<void>;
+    close(): 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<GCalResourceState>;
+    loadState(_state: GCalResourceState): Promise<void>;
+}
+
 /**
  * Construct a resource by registry name in the browser runtime.
  * Mirrors Python's `mirage.resource.registry.build_resource` and the
@@ -1297,7 +1236,12 @@ declare class GmailResource implements Resource {
  */
 type ResourceFactory = (config: Record<string, unknown>) => Promise<Resource>;
 declare function knownResources(): string[];
+/**
+ * Register a custom resource factory under `name`. Builtin names cannot
+ * be shadowed; re-registering a custom name replaces it. Mirrors
+ * Python's `register_resource` and the Node counterpart.
+ */
 declare function register(name: string, factory: ResourceFactory): void;
 declare function buildResource(name: string, config?: Record<string, unknown>): Promise<Resource>;
 
-export { ALIYUN_BROWSER_PROMPT, type AliyunConfig, type AliyunConfigRedacted, AliyunResource, type AliyunResourceState, BACKBLAZE_BROWSER_PROMPT, type BackblazeConfig, type BackblazeConfigRedacted, BackblazeResource, type BackblazeResourceState, type BoxConfig, type BoxConfigRedacted, BoxResource, type BoxResourceState, CEPH_BROWSER_PROMPT, type CephConfig, type CephConfigRedacted, CephResource, type CephResourceState, DIGITALOCEAN_BROWSER_PROMPT, type DigitalOceanConfig, type DigitalOceanConfigRedacted, DigitalOceanResource, type DigitalOceanResourceState, type DiscordConfig, type DiscordConfigRedacted, DiscordResource, type DiscordResourceState, type DropboxConfig, type DropboxConfigRedacted, DropboxResource, type DropboxResourceState, type GCSConfig, type GCSConfigRedacted, GCSResource, type GCSResourceState, GCS_BROWSER_PROMPT, type GDocsConfig, type GDocsConfigRedacted, GDocsResource, type GDocsResourceState, type GDriveConfig, type GDriveConfigRedacted, GDriveResource, type GDriveResourceState, type GSheetsConfig, type GSheetsConfigRedacted, GSheetsResource, type GSheetsResourceState, type GSlidesConfig, type GSlidesConfigRedacted, GSlidesResource, type GSlidesResourceState, type GitHubCIConfig, type GitHubCIConfigRedacted, GitHubCIResource, type GitHubCIResourceState, type GitHubConfig, type GitHubConfigRedacted, GitHubResource, type GitHubResourceState, GmailResource, type GmailResourceState, HttpMongoDriver, type HttpMongoDriverOptions, type LangfuseConfig, type LangfuseConfigRedacted, LangfuseResource, type LangfuseResourceState, type LinearConfig, type LinearConfigRedacted, LinearResource, type LinearResourceState, MINIO_BROWSER_PROMPT, type MinIOConfig, type MinIOConfigRedacted, MinIOResource, type MinIOResourceState, MongoDBResource, type MongoDBResourceOptions, NeonPgDriver, type NotionConfig, type NotionConfigRedacted, NotionResource, type NotionResourceState, type OCIConfig, type OCIConfigRedacted, OCIResource, type OCIResourceState, OCI_BROWSER_PROMPT, OPFSAccessor, OPFSResource, type OPFSResourceOptions, type OPFSResourceState, OPFS_COMMANDS, OPFS_OPS, OPFS_PROMPT, PostgresResource, type PostgresResourceOptions, QINGSTOR_BROWSER_PROMPT, type QingStorConfig, type QingStorConfigRedacted, QingStorResource, type QingStorResourceState, type R2Config, type R2ConfigRedacted, R2Resource, type R2ResourceState, R2_BROWSER_PROMPT, type ResourceFactory, S3Resource, type S3ResourceState, S3_BROWSER_PROMPT, SCALEWAY_BROWSER_PROMPT, SEAWEEDFS_BROWSER_PROMPT, SUPABASE_BROWSER_PROMPT, type ScalewayConfig, type ScalewayConfigRedacted, ScalewayResource, type ScalewayResourceState, type SeaweedFSConfig, type SeaweedFSConfigRedacted, SeaweedFSResource, type SeaweedFSResourceState, type SlackConfig, type SlackConfigRedacted, SlackResource, type SlackResourceState, type SupabaseConfig, type SupabaseConfigRedacted, SupabaseResource, type SupabaseResourceState, TENCENT_BROWSER_PROMPT, type TencentConfig, type TencentConfigRedacted, TencentResource, type TencentResourceState, type TrelloConfig, type TrelloConfigRedacted, TrelloResource, type TrelloResourceState, WASABI_BROWSER_PROMPT, type WasabiConfig, type WasabiConfigRedacted, WasabiResource, type WasabiResourceState, Workspace, aliyunToS3Config, backblazeToS3Config, buildResource, cephToS3Config, digitalOceanToS3Config, gcsToS3Config, knownResources, minioToS3Config, normalizeBoxConfig, normalizeDropboxConfig, normalizeGDocsConfig, normalizeGDriveConfig, normalizeGSheetsConfig, normalizeGSlidesConfig, normalizeGitHubCIConfig, normalizeGitHubConfig, ociToS3Config, qingStorToS3Config, r2ToS3Config, redactAliyunConfig, redactBackblazeConfig, redactBoxConfig, redactCephConfig, redactDigitalOceanConfig, redactDiscordConfig, redactDropboxConfig, redactGDocsConfig, redactGDriveConfig, redactGSheetsConfig, redactGSlidesConfig, redactGcsConfig, redactGitHubCIConfig, redactGitHubConfig, redactLangfuseConfig, redactLinearConfig, redactMinIOConfig, redactNotionConfig, redactOciConfig, redactQingStorConfig, redactR2Config, redactScalewayConfig, redactSeaweedFSConfig, redactSlackConfig, redactSupabaseConfig, redactTencentConfig, redactTrelloConfig, redactWasabiConfig, register as registerResourceFactory, resolvedAliyunEndpoint, resolvedBackblazeEndpoint, resolvedDigitalOceanEndpoint, resolvedOciEndpoint, resolvedQingStorEndpoint, resolvedR2Endpoint, resolvedScalewayEndpoint, resolvedSupabaseEndpoint, resolvedTencentEndpoint, resolvedWasabiEndpoint, scalewayToS3Config, seaweedfsToS3Config, supabaseToS3Config, tencentToS3Config, wasabiToS3Config };
+export { ALIYUN_BROWSER_PROMPT, type AliyunConfig, type AliyunConfigRedacted, AliyunResource, type AliyunResourceState, BACKBLAZE_BROWSER_PROMPT, type BackblazeConfig, type BackblazeConfigRedacted, BackblazeResource, type BackblazeResourceState, type BoxConfig, type BoxConfigRedacted, BoxResource, type BoxResourceState, CEPH_BROWSER_PROMPT, type CephConfig, type CephConfigRedacted, CephResource, type CephResourceState, DIGITALOCEAN_BROWSER_PROMPT, type DigitalOceanConfig, type DigitalOceanConfigRedacted, DigitalOceanResource, type DigitalOceanResourceState, type DiscordConfig, type DiscordConfigRedacted, DiscordResource, type DiscordResourceState, type DropboxConfig, type DropboxConfigRedacted, DropboxResource, type DropboxResourceState, type GCSConfig, type GCSConfigRedacted, GCSResource, type GCSResourceState, GCS_BROWSER_PROMPT, GCalResource, type GCalResourceState, GDocsResource, type GDocsResourceState, GDriveResource, type GDriveResourceState, GSheetsResource, type GSheetsResourceState, GSlidesResource, type GSlidesResourceState, type GitHubCIConfig, type GitHubCIConfigRedacted, GitHubCIResource, type GitHubCIResourceState, type GitHubConfig, type GitHubConfigRedacted, GitHubResource, type GitHubResourceState, GmailResource, type GmailResourceState, HttpMongoDriver, type HttpMongoDriverOptions, type LangfuseConfig, type LangfuseConfigRedacted, LangfuseResource, type LangfuseResourceState, type LinearConfig, type LinearConfigRedacted, LinearResource, type LinearResourceState, MINIO_BROWSER_PROMPT, type MinIOConfig, type MinIOConfigRedacted, MinIOResource, type MinIOResourceState, MongoDBResource, type MongoDBResourceOptions, NeonPgDriver, type NotionConfig, type NotionConfigRedacted, NotionResource, type NotionResourceState, type OCIConfig, type OCIConfigRedacted, OCIResource, type OCIResourceState, OCI_BROWSER_PROMPT, OPFSAccessor, OPFSResource, type OPFSResourceOptions, type OPFSResourceState, OPFS_COMMANDS, OPFS_OPS, OPFS_PROMPT, PostgresResource, type PostgresResourceOptions, QINGSTOR_BROWSER_PROMPT, type QingStorConfig, type QingStorConfigRedacted, QingStorResource, type QingStorResourceState, type R2Config, type R2ConfigRedacted, R2Resource, type R2ResourceState, R2_BROWSER_PROMPT, type ResourceFactory, S3Resource, type S3ResourceState, S3_BROWSER_PROMPT, SCALEWAY_BROWSER_PROMPT, SEAWEEDFS_BROWSER_PROMPT, SUPABASE_BROWSER_PROMPT, type ScalewayConfig, type ScalewayConfigRedacted, ScalewayResource, type ScalewayResourceState, type SeaweedFSConfig, type SeaweedFSConfigRedacted, SeaweedFSResource, type SeaweedFSResourceState, type SlackConfig, type SlackConfigRedacted, SlackResource, type SlackResourceState, type SupabaseConfig, type SupabaseConfigRedacted, SupabaseResource, type SupabaseResourceState, TENCENT_BROWSER_PROMPT, type TencentConfig, type TencentConfigRedacted, TencentResource, type TencentResourceState, type TrelloConfig, type TrelloConfigRedacted, TrelloResource, type TrelloResourceState, WASABI_BROWSER_PROMPT, type WasabiConfig, type WasabiConfigRedacted, WasabiResource, type WasabiResourceState, Workspace, aliyunToS3Config, backblazeToS3Config, buildResource, cephToS3Config, digitalOceanToS3Config, gcsToS3Config, knownResources, minioToS3Config, normalizeBoxConfig, normalizeDropboxConfig, normalizeGitHubCIConfig, normalizeGitHubConfig, ociToS3Config, qingStorToS3Config, r2ToS3Config, redactAliyunConfig, redactBackblazeConfig, redactBoxConfig, redactCephConfig, redactDigitalOceanConfig, redactDiscordConfig, redactDropboxConfig, redactGcsConfig, redactGitHubCIConfig, redactGitHubConfig, redactLangfuseConfig, redactLinearConfig, redactMinIOConfig, redactNotionConfig, redactOciConfig, redactQingStorConfig, redactR2Config, redactScalewayConfig, redactSeaweedFSConfig, redactSlackConfig, redactSupabaseConfig, redactTencentConfig, redactTrelloConfig, redactWasabiConfig, register as registerResourceFactory, resolvedAliyunEndpoint, resolvedBackblazeEndpoint, resolvedDigitalOceanEndpoint, resolvedOciEndpoint, resolvedQingStorEndpoint, resolvedR2Endpoint, resolvedScalewayEndpoint, resolvedSupabaseEndpoint, resolvedTencentEndpoint, resolvedWasabiEndpoint, scalewayToS3Config, seaweedfsToS3Config, supabaseToS3Config, tencentToS3Config, wasabiToS3Config };