@fractary/codex 0.8.0 → 0.9.1

package/dist/index.d.cts

@@ -33,16 +33,56 @@ declare function getExtension(uri: string): string;
 declare function getFilename(uri: string): string;
 declare function getDirectory(uri: string): string;
 
+type StorageProviderType = 'local' | 'github' | 'http' | 's3' | 's3-archive' | 'r2' | 'gcs' | 'drive' | 'file-plugin';
+interface FetchResult {
+    content: Buffer;
+    contentType: string;
+    size: number;
+    source: string;
+    metadata?: Record<string, unknown>;
+}
+interface FetchOptions {
+    timeout?: number;
+    maxRetries?: number;
+    token?: string;
+    branch?: string;
+    followRedirects?: boolean;
+    maxSize?: number;
+}
+interface StorageProvider {
+    readonly name: string;
+    readonly type: StorageProviderType;
+    fetch(reference: ResolvedReference, options?: FetchOptions): Promise<FetchResult>;
+    exists(reference: ResolvedReference, options?: FetchOptions): Promise<boolean>;
+    canHandle(reference: ResolvedReference): boolean;
+}
+interface StorageProviderConfig {
+    type: StorageProviderType;
+    options?: Record<string, unknown>;
+    timeout?: number;
+    maxRetries?: number;
+    auth?: {
+        tokenEnv?: string;
+        token?: string;
+    };
+}
+declare const DEFAULT_FETCH_OPTIONS: Required<FetchOptions>;
+declare function mergeFetchOptions(options?: FetchOptions): Required<FetchOptions>;
+declare function detectContentType(path: string): string;
+
 interface ResolvedReference extends ParsedReference {
     cachePath: string;
     isCurrentProject: boolean;
     localPath?: string;
+    sourceType?: StorageProviderType;
+    filePluginSource?: string;
 }
 interface ResolveOptions {
     cacheDir?: string;
     currentOrg?: string;
     currentProject?: string;
     cwd?: string;
+    config?: any;
 }
 declare const DEFAULT_CACHE_DIR = ".fractary/codex/cache";
 declare function detectCurrentProject(cwd?: string): {
@@ -143,7 +183,7 @@ declare const CustomTypeSchema: z.ZodObject<{
     description?: string | undefined;
     defaultTtl?: number | undefined;
     archiveAfterDays?: number | null | undefined;
-    archiveStorage?: "local" | "cloud" | "drive" | null | undefined;
+    archiveStorage?: "local" | "drive" | "cloud" | null | undefined;
     syncPatterns?: string[] | undefined;
     excludePatterns?: string[] | undefined;
     permissions?: {
@@ -155,7 +195,7 @@ declare const CustomTypeSchema: z.ZodObject<{
     description?: string | undefined;
     defaultTtl?: number | undefined;
     archiveAfterDays?: number | null | undefined;
-    archiveStorage?: "local" | "cloud" | "drive" | null | undefined;
+    archiveStorage?: "local" | "drive" | "cloud" | null | undefined;
     syncPatterns?: string[] | undefined;
     excludePatterns?: string[] | undefined;
     permissions?: {
@@ -188,7 +228,7 @@ declare const TypesConfigSchema: z.ZodObject<{
         description?: string | undefined;
         defaultTtl?: number | undefined;
         archiveAfterDays?: number | null | undefined;
-        archiveStorage?: "local" | "cloud" | "drive" | null | undefined;
+        archiveStorage?: "local" | "drive" | "cloud" | null | undefined;
         syncPatterns?: string[] | undefined;
         excludePatterns?: string[] | undefined;
         permissions?: {
@@ -200,7 +240,7 @@ declare const TypesConfigSchema: z.ZodObject<{
         description?: string | undefined;
         defaultTtl?: number | undefined;
         archiveAfterDays?: number | null | undefined;
-        archiveStorage?: "local" | "cloud" | "drive" | null | undefined;
+        archiveStorage?: "local" | "drive" | "cloud" | null | undefined;
         syncPatterns?: string[] | undefined;
         excludePatterns?: string[] | undefined;
         permissions?: {
@@ -214,7 +254,7 @@ declare const TypesConfigSchema: z.ZodObject<{
         description?: string | undefined;
         defaultTtl?: number | undefined;
         archiveAfterDays?: number | null | undefined;
-        archiveStorage?: "local" | "cloud" | "drive" | null | undefined;
+        archiveStorage?: "local" | "drive" | "cloud" | null | undefined;
         syncPatterns?: string[] | undefined;
         excludePatterns?: string[] | undefined;
         permissions?: {
@@ -228,7 +268,7 @@ declare const TypesConfigSchema: z.ZodObject<{
         description?: string | undefined;
         defaultTtl?: number | undefined;
         archiveAfterDays?: number | null | undefined;
-        archiveStorage?: "local" | "cloud" | "drive" | null | undefined;
+        archiveStorage?: "local" | "drive" | "cloud" | null | undefined;
         syncPatterns?: string[] | undefined;
         excludePatterns?: string[] | undefined;
         permissions?: {
@@ -353,17 +393,18 @@ declare const SyncRulesSchema: z.ZodObject<{
 type SyncRules = z.infer<typeof SyncRulesSchema>;
 declare const CodexConfigSchema: z.ZodObject<{
     organizationSlug: z.ZodString;
+    project: z.ZodOptional<z.ZodString>;
     directories: z.ZodOptional<z.ZodObject<{
         source: z.ZodOptional<z.ZodString>;
         target: z.ZodOptional<z.ZodString>;
         systems: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        systems?: string | undefined;
         source?: string | undefined;
+        systems?: string | undefined;
         target?: string | undefined;
     }, {
-        systems?: string | undefined;
         source?: string | undefined;
+        systems?: string | undefined;
         target?: string | undefined;
     }>>;
     rules: z.ZodOptional<z.ZodObject<{
@@ -461,11 +502,81 @@ declare const CodexConfigSchema: z.ZodObject<{
             prefix?: string | undefined;
         }>;
     }>>;
+    auth: z.ZodOptional<z.ZodObject<{
+        github: z.ZodOptional<z.ZodObject<{
+            default_token_env: z.ZodOptional<z.ZodString>;
+            fallback_to_public: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            default_token_env?: string | undefined;
+            fallback_to_public?: boolean | undefined;
+        }, {
+            default_token_env?: string | undefined;
+            fallback_to_public?: boolean | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        github?: {
+            default_token_env?: string | undefined;
+            fallback_to_public?: boolean | undefined;
+        } | undefined;
+    }, {
+        github?: {
+            default_token_env?: string | undefined;
+            fallback_to_public?: boolean | undefined;
+        } | undefined;
+    }>>;
+    dependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        sources: z.ZodRecord<z.ZodString, z.ZodObject<{
+            type: z.ZodEnum<["github", "s3", "http", "local"]>;
+            token_env: z.ZodOptional<z.ZodString>;
+            token: z.ZodOptional<z.ZodString>;
+            branch: z.ZodOptional<z.ZodString>;
+            base_url: z.ZodOptional<z.ZodString>;
+            bucket: z.ZodOptional<z.ZodString>;
+            prefix: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type: "local" | "github" | "http" | "s3";
+            token?: string | undefined;
+            branch?: string | undefined;
+            bucket?: string | undefined;
+            prefix?: string | undefined;
+            token_env?: string | undefined;
+            base_url?: string | undefined;
+        }, {
+            type: "local" | "github" | "http" | "s3";
+            token?: string | undefined;
+            branch?: string | undefined;
+            bucket?: string | undefined;
+            prefix?: string | undefined;
+            token_env?: string | undefined;
+            base_url?: string | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        sources: Record<string, {
+            type: "local" | "github" | "http" | "s3";
+            token?: string | undefined;
+            branch?: string | undefined;
+            bucket?: string | undefined;
+            prefix?: string | undefined;
+            token_env?: string | undefined;
+            base_url?: string | undefined;
+        }>;
+    }, {
+        sources: Record<string, {
+            type: "local" | "github" | "http" | "s3";
+            token?: string | undefined;
+            branch?: string | undefined;
+            bucket?: string | undefined;
+            prefix?: string | undefined;
+            token_env?: string | undefined;
+            base_url?: string | undefined;
+        }>;
+    }>>>;
 }, "strict", z.ZodTypeAny, {
     organizationSlug: string;
+    project?: string | undefined;
     directories?: {
-        systems?: string | undefined;
         source?: string | undefined;
+        systems?: string | undefined;
         target?: string | undefined;
     } | undefined;
     rules?: {
@@ -495,11 +606,29 @@ declare const CodexConfigSchema: z.ZodObject<{
             prefix?: string | undefined;
         }>;
     } | undefined;
+    auth?: {
+        github?: {
+            default_token_env?: string | undefined;
+            fallback_to_public?: boolean | undefined;
+        } | undefined;
+    } | undefined;
+    dependencies?: Record<string, {
+        sources: Record<string, {
+            type: "local" | "github" | "http" | "s3";
+            token?: string | undefined;
+            branch?: string | undefined;
+            bucket?: string | undefined;
+            prefix?: string | undefined;
+            token_env?: string | undefined;
+            base_url?: string | undefined;
+        }>;
+    }> | undefined;
 }, {
     organizationSlug: string;
+    project?: string | undefined;
     directories?: {
-        systems?: string | undefined;
         source?: string | undefined;
+        systems?: string | undefined;
         target?: string | undefined;
     } | undefined;
     rules?: {
@@ -529,8 +658,588 @@ declare const CodexConfigSchema: z.ZodObject<{
             prefix?: string | undefined;
         }>;
     } | undefined;
+    auth?: {
+        github?: {
+            default_token_env?: string | undefined;
+            fallback_to_public?: boolean | undefined;
+        } | undefined;
+    } | undefined;
+    dependencies?: Record<string, {
+        sources: Record<string, {
+            type: "local" | "github" | "http" | "s3";
+            token?: string | undefined;
+            branch?: string | undefined;
+            bucket?: string | undefined;
+            prefix?: string | undefined;
+            token_env?: string | undefined;
+            base_url?: string | undefined;
+        }>;
+    }> | undefined;
 }>;
 type CodexConfig = z.infer<typeof CodexConfigSchema>;
+declare const UnifiedConfigSchema: z.ZodObject<{
+    file: z.ZodOptional<z.ZodObject<{
+        schema_version: z.ZodString;
+        sources: z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodObject<{
+            type: z.ZodEnum<["s3", "r2", "gcs", "local"]>;
+            bucket: z.ZodOptional<z.ZodString>;
+            prefix: z.ZodOptional<z.ZodString>;
+            region: z.ZodOptional<z.ZodString>;
+            local: z.ZodObject<{
+                base_path: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                base_path: string;
+            }, {
+                base_path: string;
+            }>;
+            push: z.ZodOptional<z.ZodObject<{
+                compress: z.ZodOptional<z.ZodBoolean>;
+                keep_local: z.ZodOptional<z.ZodBoolean>;
+            }, "strip", z.ZodTypeAny, {
+                compress?: boolean | undefined;
+                keep_local?: boolean | undefined;
+            }, {
+                compress?: boolean | undefined;
+                keep_local?: boolean | undefined;
+            }>>;
+            auth: z.ZodOptional<z.ZodObject<{
+                profile: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                profile?: string | undefined;
+            }, {
+                profile?: string | undefined;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            local: {
+                base_path: string;
+            };
+            type: "local" | "s3" | "r2" | "gcs";
+            push?: {
+                compress?: boolean | undefined;
+                keep_local?: boolean | undefined;
+            } | undefined;
+            bucket?: string | undefined;
+            prefix?: string | undefined;
+            auth?: {
+                profile?: string | undefined;
+            } | undefined;
+            region?: string | undefined;
+        }, {
+            local: {
+                base_path: string;
+            };
+            type: "local" | "s3" | "r2" | "gcs";
+            push?: {
+                compress?: boolean | undefined;
+                keep_local?: boolean | undefined;
+            } | undefined;
+            bucket?: string | undefined;
+            prefix?: string | undefined;
+            auth?: {
+                profile?: string | undefined;
+            } | undefined;
+            region?: string | undefined;
+        }>, {
+            local: {
+                base_path: string;
+            };
+            type: "local" | "s3" | "r2" | "gcs";
+            push?: {
+                compress?: boolean | undefined;
+                keep_local?: boolean | undefined;
+            } | undefined;
+            bucket?: string | undefined;
+            prefix?: string | undefined;
+            auth?: {
+                profile?: string | undefined;
+            } | undefined;
+            region?: string | undefined;
+        }, {
+            local: {
+                base_path: string;
+            };
+            type: "local" | "s3" | "r2" | "gcs";
+            push?: {
+                compress?: boolean | undefined;
+                keep_local?: boolean | undefined;
+            } | undefined;
+            bucket?: string | undefined;
+            prefix?: string | undefined;
+            auth?: {
+                profile?: string | undefined;
+            } | undefined;
+            region?: string | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        sources: Record<string, {
+            local: {
+                base_path: string;
+            };
+            type: "local" | "s3" | "r2" | "gcs";
+            push?: {
+                compress?: boolean | undefined;
+                keep_local?: boolean | undefined;
+            } | undefined;
+            bucket?: string | undefined;
+            prefix?: string | undefined;
+            auth?: {
+                profile?: string | undefined;
+            } | undefined;
+            region?: string | undefined;
+        }>;
+        schema_version: string;
+    }, {
+        sources: Record<string, {
+            local: {
+                base_path: string;
+            };
+            type: "local" | "s3" | "r2" | "gcs";
+            push?: {
+                compress?: boolean | undefined;
+                keep_local?: boolean | undefined;
+            } | undefined;
+            bucket?: string | undefined;
+            prefix?: string | undefined;
+            auth?: {
+                profile?: string | undefined;
+            } | undefined;
+            region?: string | undefined;
+        }>;
+        schema_version: string;
+    }>>;
+    codex: z.ZodOptional<z.ZodObject<{
+        organizationSlug: z.ZodString;
+        project: z.ZodOptional<z.ZodString>;
+        directories: z.ZodOptional<z.ZodObject<{
+            source: z.ZodOptional<z.ZodString>;
+            target: z.ZodOptional<z.ZodString>;
+            systems: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            source?: string | undefined;
+            systems?: string | undefined;
+            target?: string | undefined;
+        }, {
+            source?: string | undefined;
+            systems?: string | undefined;
+            target?: string | undefined;
+        }>>;
+        rules: z.ZodOptional<z.ZodObject<{
+            autoSyncPatterns: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                pattern: z.ZodString;
+                include: z.ZodArray<z.ZodString, "many">;
+                exclude: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            }, "strip", z.ZodTypeAny, {
+                include: string[];
+                pattern: string;
+                exclude?: string[] | undefined;
+            }, {
+                include: string[];
+                pattern: string;
+                exclude?: string[] | undefined;
+            }>, "many">>;
+            preventSelfSync: z.ZodOptional<z.ZodBoolean>;
+            preventCodexSync: z.ZodOptional<z.ZodBoolean>;
+            allowProjectOverrides: z.ZodOptional<z.ZodBoolean>;
+            defaultInclude: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            defaultExclude: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            autoSyncPatterns?: {
+                include: string[];
+                pattern: string;
+                exclude?: string[] | undefined;
+            }[] | undefined;
+            preventSelfSync?: boolean | undefined;
+            preventCodexSync?: boolean | undefined;
+            allowProjectOverrides?: boolean | undefined;
+            defaultInclude?: string[] | undefined;
+            defaultExclude?: string[] | undefined;
+        }, {
+            autoSyncPatterns?: {
+                include: string[];
+                pattern: string;
+                exclude?: string[] | undefined;
+            }[] | undefined;
+            preventSelfSync?: boolean | undefined;
+            preventCodexSync?: boolean | undefined;
+            allowProjectOverrides?: boolean | undefined;
+            defaultInclude?: string[] | undefined;
+            defaultExclude?: string[] | undefined;
+        }>>;
+        sync: z.ZodOptional<z.ZodObject<{
+            to_codex: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            from_codex: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            default_to_codex: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            default_from_codex: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            to_codex?: string[] | undefined;
+            from_codex?: string[] | undefined;
+            default_to_codex?: string[] | undefined;
+            default_from_codex?: string[] | undefined;
+        }, {
+            to_codex?: string[] | undefined;
+            from_codex?: string[] | undefined;
+            default_to_codex?: string[] | undefined;
+            default_from_codex?: string[] | undefined;
+        }>>;
+        archive: z.ZodOptional<z.ZodObject<{
+            projects: z.ZodRecord<z.ZodString, z.ZodObject<{
+                enabled: z.ZodBoolean;
+                handler: z.ZodEnum<["s3", "r2", "gcs", "local"]>;
+                bucket: z.ZodOptional<z.ZodString>;
+                prefix: z.ZodOptional<z.ZodString>;
+                patterns: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            }, "strip", z.ZodTypeAny, {
+                enabled: boolean;
+                handler: "local" | "s3" | "r2" | "gcs";
+                patterns?: string[] | undefined;
+                bucket?: string | undefined;
+                prefix?: string | undefined;
+            }, {
+                enabled: boolean;
+                handler: "local" | "s3" | "r2" | "gcs";
+                patterns?: string[] | undefined;
+                bucket?: string | undefined;
+                prefix?: string | undefined;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            projects: Record<string, {
+                enabled: boolean;
+                handler: "local" | "s3" | "r2" | "gcs";
+                patterns?: string[] | undefined;
+                bucket?: string | undefined;
+                prefix?: string | undefined;
+            }>;
+        }, {
+            projects: Record<string, {
+                enabled: boolean;
+                handler: "local" | "s3" | "r2" | "gcs";
+                patterns?: string[] | undefined;
+                bucket?: string | undefined;
+                prefix?: string | undefined;
+            }>;
+        }>>;
+        auth: z.ZodOptional<z.ZodObject<{
+            github: z.ZodOptional<z.ZodObject<{
+                default_token_env: z.ZodOptional<z.ZodString>;
+                fallback_to_public: z.ZodOptional<z.ZodBoolean>;
+            }, "strip", z.ZodTypeAny, {
+                default_token_env?: string | undefined;
+                fallback_to_public?: boolean | undefined;
+            }, {
+                default_token_env?: string | undefined;
+                fallback_to_public?: boolean | undefined;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            github?: {
+                default_token_env?: string | undefined;
+                fallback_to_public?: boolean | undefined;
+            } | undefined;
+        }, {
+            github?: {
+                default_token_env?: string | undefined;
+                fallback_to_public?: boolean | undefined;
+            } | undefined;
+        }>>;
+        dependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            sources: z.ZodRecord<z.ZodString, z.ZodObject<{
+                type: z.ZodEnum<["github", "s3", "http", "local"]>;
+                token_env: z.ZodOptional<z.ZodString>;
+                token: z.ZodOptional<z.ZodString>;
+                branch: z.ZodOptional<z.ZodString>;
+                base_url: z.ZodOptional<z.ZodString>;
+                bucket: z.ZodOptional<z.ZodString>;
+                prefix: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                type: "local" | "github" | "http" | "s3";
+                token?: string | undefined;
+                branch?: string | undefined;
+                bucket?: string | undefined;
+                prefix?: string | undefined;
+                token_env?: string | undefined;
+                base_url?: string | undefined;
+            }, {
+                type: "local" | "github" | "http" | "s3";
+                token?: string | undefined;
+                branch?: string | undefined;
+                bucket?: string | undefined;
+                prefix?: string | undefined;
+                token_env?: string | undefined;
+                base_url?: string | undefined;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            sources: Record<string, {
+                type: "local" | "github" | "http" | "s3";
+                token?: string | undefined;
+                branch?: string | undefined;
+                bucket?: string | undefined;
+                prefix?: string | undefined;
+                token_env?: string | undefined;
+                base_url?: string | undefined;
+            }>;
+        }, {
+            sources: Record<string, {
+                type: "local" | "github" | "http" | "s3";
+                token?: string | undefined;
+                branch?: string | undefined;
+                bucket?: string | undefined;
+                prefix?: string | undefined;
+                token_env?: string | undefined;
+                base_url?: string | undefined;
+            }>;
+        }>>>;
+    }, "strict", z.ZodTypeAny, {
+        organizationSlug: string;
+        project?: string | undefined;
+        directories?: {
+            source?: string | undefined;
+            systems?: string | undefined;
+            target?: string | undefined;
+        } | undefined;
+        rules?: {
+            autoSyncPatterns?: {
+                include: string[];
+                pattern: string;
+                exclude?: string[] | undefined;
+            }[] | undefined;
+            preventSelfSync?: boolean | undefined;
+            preventCodexSync?: boolean | undefined;
+            allowProjectOverrides?: boolean | undefined;
+            defaultInclude?: string[] | undefined;
+            defaultExclude?: string[] | undefined;
+        } | undefined;
+        sync?: {
+            to_codex?: string[] | undefined;
+            from_codex?: string[] | undefined;
+            default_to_codex?: string[] | undefined;
+            default_from_codex?: string[] | undefined;
+        } | undefined;
+        archive?: {
+            projects: Record<string, {
+                enabled: boolean;
+                handler: "local" | "s3" | "r2" | "gcs";
+                patterns?: string[] | undefined;
+                bucket?: string | undefined;
+                prefix?: string | undefined;
+            }>;
+        } | undefined;
+        auth?: {
+            github?: {
+                default_token_env?: string | undefined;
+                fallback_to_public?: boolean | undefined;
+            } | undefined;
+        } | undefined;
+        dependencies?: Record<string, {
+            sources: Record<string, {
+                type: "local" | "github" | "http" | "s3";
+                token?: string | undefined;
+                branch?: string | undefined;
+                bucket?: string | undefined;
+                prefix?: string | undefined;
+                token_env?: string | undefined;
+                base_url?: string | undefined;
+            }>;
+        }> | undefined;
+    }, {
+        organizationSlug: string;
+        project?: string | undefined;
+        directories?: {
+            source?: string | undefined;
+            systems?: string | undefined;
+            target?: string | undefined;
+        } | undefined;
+        rules?: {
+            autoSyncPatterns?: {
+                include: string[];
+                pattern: string;
+                exclude?: string[] | undefined;
+            }[] | undefined;
+            preventSelfSync?: boolean | undefined;
+            preventCodexSync?: boolean | undefined;
+            allowProjectOverrides?: boolean | undefined;
+            defaultInclude?: string[] | undefined;
+            defaultExclude?: string[] | undefined;
+        } | undefined;
+        sync?: {
+            to_codex?: string[] | undefined;
+            from_codex?: string[] | undefined;
+            default_to_codex?: string[] | undefined;
+            default_from_codex?: string[] | undefined;
+        } | undefined;
+        archive?: {
+            projects: Record<string, {
+                enabled: boolean;
+                handler: "local" | "s3" | "r2" | "gcs";
+                patterns?: string[] | undefined;
+                bucket?: string | undefined;
+                prefix?: string | undefined;
+            }>;
+        } | undefined;
+        auth?: {
+            github?: {
+                default_token_env?: string | undefined;
+                fallback_to_public?: boolean | undefined;
+            } | undefined;
+        } | undefined;
+        dependencies?: Record<string, {
+            sources: Record<string, {
+                type: "local" | "github" | "http" | "s3";
+                token?: string | undefined;
+                branch?: string | undefined;
+                bucket?: string | undefined;
+                prefix?: string | undefined;
+                token_env?: string | undefined;
+                base_url?: string | undefined;
+            }>;
+        }> | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    file?: {
+        sources: Record<string, {
+            local: {
+                base_path: string;
+            };
+            type: "local" | "s3" | "r2" | "gcs";
+            push?: {
+                compress?: boolean | undefined;
+                keep_local?: boolean | undefined;
+            } | undefined;
+            bucket?: string | undefined;
+            prefix?: string | undefined;
+            auth?: {
+                profile?: string | undefined;
+            } | undefined;
+            region?: string | undefined;
+        }>;
+        schema_version: string;
+    } | undefined;
+    codex?: {
+        organizationSlug: string;
+        project?: string | undefined;
+        directories?: {
+            source?: string | undefined;
+            systems?: string | undefined;
+            target?: string | undefined;
+        } | undefined;
+        rules?: {
+            autoSyncPatterns?: {
+                include: string[];
+                pattern: string;
+                exclude?: string[] | undefined;
+            }[] | undefined;
+            preventSelfSync?: boolean | undefined;
+            preventCodexSync?: boolean | undefined;
+            allowProjectOverrides?: boolean | undefined;
+            defaultInclude?: string[] | undefined;
+            defaultExclude?: string[] | undefined;
+        } | undefined;
+        sync?: {
+            to_codex?: string[] | undefined;
+            from_codex?: string[] | undefined;
+            default_to_codex?: string[] | undefined;
+            default_from_codex?: string[] | undefined;
+        } | undefined;
+        archive?: {
+            projects: Record<string, {
+                enabled: boolean;
+                handler: "local" | "s3" | "r2" | "gcs";
+                patterns?: string[] | undefined;
+                bucket?: string | undefined;
+                prefix?: string | undefined;
+            }>;
+        } | undefined;
+        auth?: {
+            github?: {
+                default_token_env?: string | undefined;
+                fallback_to_public?: boolean | undefined;
+            } | undefined;
+        } | undefined;
+        dependencies?: Record<string, {
+            sources: Record<string, {
+                type: "local" | "github" | "http" | "s3";
+                token?: string | undefined;
+                branch?: string | undefined;
+                bucket?: string | undefined;
+                prefix?: string | undefined;
+                token_env?: string | undefined;
+                base_url?: string | undefined;
+            }>;
+        }> | undefined;
+    } | undefined;
+}, {
+    file?: {
+        sources: Record<string, {
+            local: {
+                base_path: string;
+            };
+            type: "local" | "s3" | "r2" | "gcs";
+            push?: {
+                compress?: boolean | undefined;
+                keep_local?: boolean | undefined;
+            } | undefined;
+            bucket?: string | undefined;
+            prefix?: string | undefined;
+            auth?: {
+                profile?: string | undefined;
+            } | undefined;
+            region?: string | undefined;
+        }>;
+        schema_version: string;
+    } | undefined;
+    codex?: {
+        organizationSlug: string;
+        project?: string | undefined;
+        directories?: {
+            source?: string | undefined;
+            systems?: string | undefined;
+            target?: string | undefined;
+        } | undefined;
+        rules?: {
+            autoSyncPatterns?: {
+                include: string[];
+                pattern: string;
+                exclude?: string[] | undefined;
+            }[] | undefined;
+            preventSelfSync?: boolean | undefined;
+            preventCodexSync?: boolean | undefined;
+            allowProjectOverrides?: boolean | undefined;
+            defaultInclude?: string[] | undefined;
+            defaultExclude?: string[] | undefined;
+        } | undefined;
+        sync?: {
+            to_codex?: string[] | undefined;
+            from_codex?: string[] | undefined;
+            default_to_codex?: string[] | undefined;
+            default_from_codex?: string[] | undefined;
+        } | undefined;
+        archive?: {
+            projects: Record<string, {
+                enabled: boolean;
+                handler: "local" | "s3" | "r2" | "gcs";
+                patterns?: string[] | undefined;
+                bucket?: string | undefined;
+                prefix?: string | undefined;
+            }>;
+        } | undefined;
+        auth?: {
+            github?: {
+                default_token_env?: string | undefined;
+                fallback_to_public?: boolean | undefined;
+            } | undefined;
+        } | undefined;
+        dependencies?: Record<string, {
+            sources: Record<string, {
+                type: "local" | "github" | "http" | "s3";
+                token?: string | undefined;
+                branch?: string | undefined;
+                bucket?: string | undefined;
+                prefix?: string | undefined;
+                token_env?: string | undefined;
+                base_url?: string | undefined;
+            }>;
+        }> | undefined;
+    } | undefined;
+}>;
+type UnifiedConfig = z.infer<typeof UnifiedConfigSchema>;
 
 interface ParseMetadataOptions {
     strict?: boolean;
@@ -604,43 +1313,6 @@ interface CustomSyncDestination {
 declare function parseCustomDestination(value: string): CustomSyncDestination;
 declare function getCustomSyncDestinations(metadata: Metadata): CustomSyncDestination[];
 
-type StorageProviderType = 'local' | 'github' | 'http' | 's3' | 's3-archive' | 'r2' | 'gcs' | 'drive';
-interface FetchResult {
-    content: Buffer;
-    contentType: string;
-    size: number;
-    source: string;
-    metadata?: Record<string, unknown>;
-}
-interface FetchOptions {
-    timeout?: number;
-    maxRetries?: number;
-    token?: string;
-    branch?: string;
-    followRedirects?: boolean;
-    maxSize?: number;
-}
-interface StorageProvider {
-    readonly name: string;
-    readonly type: StorageProviderType;
-    fetch(reference: ResolvedReference, options?: FetchOptions): Promise<FetchResult>;
-    exists(reference: ResolvedReference, options?: FetchOptions): Promise<boolean>;
-    canHandle(reference: ResolvedReference): boolean;
-}
-interface StorageProviderConfig {
-    type: StorageProviderType;
-    options?: Record<string, unknown>;
-    timeout?: number;
-    maxRetries?: number;
-    auth?: {
-        tokenEnv?: string;
-        token?: string;
-    };
-}
-declare const DEFAULT_FETCH_OPTIONS: Required<FetchOptions>;
-declare function mergeFetchOptions(options?: FetchOptions): Required<FetchOptions>;
-declare function detectContentType(path: string): string;
-
 interface LocalStorageOptions {
     baseDir?: string;
 }
@@ -708,6 +1380,35 @@ declare class HttpStorage implements StorageProvider {
 }
 declare function createHttpStorage(options?: HttpStorageOptions): HttpStorage;
 
+interface FilePluginStorageOptions {
+    config: UnifiedConfig;
+    enableS3Fallback?: boolean;
+    baseDir?: string;
+}
+declare class FilePluginStorage implements StorageProvider {
+    private options;
+    readonly name = "file-plugin";
+    readonly type: "local";
+    private sourceResolver;
+    private baseDir;
+    constructor(options: FilePluginStorageOptions);
+    canHandle(reference: ResolvedReference): boolean;
+    fetch(reference: ResolvedReference, _options?: FetchOptions): Promise<FetchResult>;
+    exists(reference: ResolvedReference, _options?: FetchOptions): Promise<boolean>;
+    private detectContentType;
+    private createFileNotFoundError;
+}
+
+interface FilePluginFileNotFoundErrorOptions {
+    includeCloudSuggestions?: boolean;
+    storageType?: string;
+}
+declare class FilePluginFileNotFoundError extends Error {
+    readonly filePath: string;
+    readonly sourceName: string;
+    constructor(filePath: string, sourceName: string, options?: FilePluginFileNotFoundErrorOptions);
+}
+
 interface ArchiveProjectConfig {
     enabled: boolean;
     handler: 's3' | 'r2' | 'gcs' | 'local';
@@ -725,13 +1426,18 @@ interface StorageManagerConfig {
     github?: GitHubStorageOptions;
     http?: HttpStorageOptions;
     s3Archive?: S3ArchiveStorageOptions;
+    filePlugin?: FilePluginStorageOptions;
     priority?: StorageProviderType[];
     enableCaching?: boolean;
+    codexConfig?: CodexConfig;
 }
 declare class StorageManager {
     private providers;
     private priority;
+    private codexConfig?;
     constructor(config?: StorageManagerConfig);
+    private resolveToken;
+    private resolveFetchOptions;
     registerProvider(provider: StorageProvider): void;
     removeProvider(type: StorageProviderType): boolean;
     getProvider(type: StorageProviderType): StorageProvider | undefined;
@@ -1270,4 +1976,4 @@ declare function hasLegacyReferences(text: string): boolean;
 declare function migrateFileReferences(content: string, options?: ConversionOptions): ReferenceConversionResult;
 declare function generateReferenceMigrationSummary(results: ReferenceConversionResult[]): string;
 
-export { type ArtifactType, type AutoSyncPattern, AutoSyncPatternSchema, BUILT_IN_TYPES, CODEX_URI_PREFIX, type CacheEntry, type CacheEntryMetadata, type CacheEntryStatus, type CacheLookupResult, CacheManager, type CacheManagerConfig, CachePersistence, type CachePersistenceOptions, type CacheStats, type CodexConfig, CodexConfigSchema, CodexError, CommonRules, ConfigurationError, type ConversionOptions, type ConvertedReference, type CustomSyncDestination, type CustomTypeConfig, CustomTypeSchema, DEFAULT_CACHE_DIR, DEFAULT_FETCH_OPTIONS, DEFAULT_MIGRATION_OPTIONS, DEFAULT_PERMISSION_CONFIG, DEFAULT_SYNC_CONFIG, DEFAULT_TYPE, type EvaluationResult, type EvaluationSummary, type FetchOptions, type FetchResult, type FileInfo, type FileSyncStatus, GitHubStorage, type GitHubStorageOptions, HttpStorage, type HttpStorageOptions, LEGACY_PATTERNS, LEGACY_REF_PREFIX, type LegacyAutoSyncPattern, type LegacyCodexConfig, type LoadConfigOptions, LocalStorage, type LocalStorageOptions, type Metadata, MetadataSchema, type MigrationChange, type MigrationOptions, type MigrationResult, type ModernCodexConfig, type ModernSyncPattern, PERMISSION_LEVEL_ORDER, type ParseMetadataOptions, type ParseOptions, type ParseResult, type ParsedReference, type PermissionAction, type PermissionConfig, type PermissionContext, PermissionDeniedError, type PermissionLevel, PermissionManager, type PermissionManagerConfig, type PermissionResult, type PermissionRule, type PermissionScope, type PlanStats, type ReferenceConversionResult, type ResolveOptions, type ResolveOrgOptions, type ResolvedReference, type SerializedCacheEntry, type ShouldSyncOptions, StorageManager, type StorageManagerConfig, type StorageProvider, type StorageProviderConfig, type StorageProviderType, type SyncConfig, type SyncDirection, SyncManager, type SyncManagerConfig, type SyncManifest, type SyncManifestEntry, type SyncOperation, type SyncOptions, type SyncPlan, type SyncResult, type SyncRule, type SyncRules, SyncRulesSchema, TTL, TypeRegistry, type TypeRegistryOptions, type TypesConfig, TypesConfigSchema, ValidationError, type VersionDetectionResult, buildUri, calculateCachePath, calculateContentHash, convertLegacyReference, convertLegacyReferences, convertToUri, createCacheEntry, createCacheManager, createCachePersistence, createDefaultRegistry, createEmptyModernConfig, createEmptySyncPlan, createGitHubStorage, createHttpStorage, createLocalStorage, createPermissionManager, createRule, createRulesFromPatterns, createStorageManager, createSyncManager, createSyncPlan, deserializeCacheEntry, detectContentType, detectCurrentProject, detectVersion, estimateSyncTime, evaluatePath, evaluatePaths, evaluatePatterns, evaluatePermission, evaluatePermissions, extendType, extractOrgFromRepoName, extractRawFrontmatter, filterByPatterns, filterByPermission, filterPlanOperations, filterSyncablePaths, findLegacyReferences, formatPlanSummary, generateMigrationReport, generateReferenceMigrationSummary, getBuiltInType, getBuiltInTypeNames, getCacheEntryAge, getCacheEntryStatus, getCurrentContext, getCustomSyncDestinations, getDefaultCacheManager, getDefaultConfig, getDefaultDirectories, getDefaultPermissionManager, getDefaultRules, getDefaultStorageManager, getDirectory, getExtension, getFilename, getMigrationRequirements, getPlanStats, getRelativeCachePath, getRemainingTtl, getTargetRepos, hasContentChanged, hasFrontmatter, hasLegacyReferences, hasPermission as hasPermissionLevel, isBuiltInType, isCacheEntryFresh, isCacheEntryValid, isCurrentProjectUri, isLegacyConfig, isLegacyReference, isModernConfig, isAllowed as isPermissionAllowed, isValidUri, levelGrants, loadConfig, loadCustomTypes, matchAnyPattern, matchPattern, maxLevel, mergeFetchOptions, mergeRules, mergeTypes, migrateConfig, migrateFileReferences, minLevel, needsMigration, parseCustomDestination, parseMetadata, parseReference, parseTtl, resolveOrganization, resolveReference, resolveReferences, ruleMatchesAction, ruleMatchesContext, ruleMatchesPath, sanitizePath, serializeCacheEntry, setDefaultCacheManager, setDefaultPermissionManager, setDefaultStorageManager, shouldSyncToRepo, summarizeEvaluations, touchCacheEntry, validateCustomTypes, validateMetadata, validateMigratedConfig, validateOrg, validatePath, validateRules as validatePermissionRules, validateProject, validateRules$1 as validateRules, validateUri };
+export { type ArtifactType, type AutoSyncPattern, AutoSyncPatternSchema, BUILT_IN_TYPES, CODEX_URI_PREFIX, type CacheEntry, type CacheEntryMetadata, type CacheEntryStatus, type CacheLookupResult, CacheManager, type CacheManagerConfig, CachePersistence, type CachePersistenceOptions, type CacheStats, type CodexConfig, CodexConfigSchema, CodexError, CommonRules, ConfigurationError, type ConversionOptions, type ConvertedReference, type CustomSyncDestination, type CustomTypeConfig, CustomTypeSchema, DEFAULT_CACHE_DIR, DEFAULT_FETCH_OPTIONS, DEFAULT_MIGRATION_OPTIONS, DEFAULT_PERMISSION_CONFIG, DEFAULT_SYNC_CONFIG, DEFAULT_TYPE, type EvaluationResult, type EvaluationSummary, type FetchOptions, type FetchResult, type FileInfo, FilePluginFileNotFoundError, type FilePluginFileNotFoundErrorOptions, FilePluginStorage, type FilePluginStorageOptions, type FileSyncStatus, GitHubStorage, type GitHubStorageOptions, HttpStorage, type HttpStorageOptions, LEGACY_PATTERNS, LEGACY_REF_PREFIX, type LegacyAutoSyncPattern, type LegacyCodexConfig, type LoadConfigOptions, LocalStorage, type LocalStorageOptions, type Metadata, MetadataSchema, type MigrationChange, type MigrationOptions, type MigrationResult, type ModernCodexConfig, type ModernSyncPattern, PERMISSION_LEVEL_ORDER, type ParseMetadataOptions, type ParseOptions, type ParseResult, type ParsedReference, type PermissionAction, type PermissionConfig, type PermissionContext, PermissionDeniedError, type PermissionLevel, PermissionManager, type PermissionManagerConfig, type PermissionResult, type PermissionRule, type PermissionScope, type PlanStats, type ReferenceConversionResult, type ResolveOptions, type ResolveOrgOptions, type ResolvedReference, type SerializedCacheEntry, type ShouldSyncOptions, StorageManager, type StorageManagerConfig, type StorageProvider, type StorageProviderConfig, type StorageProviderType, type SyncConfig, type SyncDirection, SyncManager, type SyncManagerConfig, type SyncManifest, type SyncManifestEntry, type SyncOperation, type SyncOptions, type SyncPlan, type SyncResult, type SyncRule, type SyncRules, SyncRulesSchema, TTL, TypeRegistry, type TypeRegistryOptions, type TypesConfig, TypesConfigSchema, ValidationError, type VersionDetectionResult, buildUri, calculateCachePath, calculateContentHash, convertLegacyReference, convertLegacyReferences, convertToUri, createCacheEntry, createCacheManager, createCachePersistence, createDefaultRegistry, createEmptyModernConfig, createEmptySyncPlan, createGitHubStorage, createHttpStorage, createLocalStorage, createPermissionManager, createRule, createRulesFromPatterns, createStorageManager, createSyncManager, createSyncPlan, deserializeCacheEntry, detectContentType, detectCurrentProject, detectVersion, estimateSyncTime, evaluatePath, evaluatePaths, evaluatePatterns, evaluatePermission, evaluatePermissions, extendType, extractOrgFromRepoName, extractRawFrontmatter, filterByPatterns, filterByPermission, filterPlanOperations, filterSyncablePaths, findLegacyReferences, formatPlanSummary, generateMigrationReport, generateReferenceMigrationSummary, getBuiltInType, getBuiltInTypeNames, getCacheEntryAge, getCacheEntryStatus, getCurrentContext, getCustomSyncDestinations, getDefaultCacheManager, getDefaultConfig, getDefaultDirectories, getDefaultPermissionManager, getDefaultRules, getDefaultStorageManager, getDirectory, getExtension, getFilename, getMigrationRequirements, getPlanStats, getRelativeCachePath, getRemainingTtl, getTargetRepos, hasContentChanged, hasFrontmatter, hasLegacyReferences, hasPermission as hasPermissionLevel, isBuiltInType, isCacheEntryFresh, isCacheEntryValid, isCurrentProjectUri, isLegacyConfig, isLegacyReference, isModernConfig, isAllowed as isPermissionAllowed, isValidUri, levelGrants, loadConfig, loadCustomTypes, matchAnyPattern, matchPattern, maxLevel, mergeFetchOptions, mergeRules, mergeTypes, migrateConfig, migrateFileReferences, minLevel, needsMigration, parseCustomDestination, parseMetadata, parseReference, parseTtl, resolveOrganization, resolveReference, resolveReferences, ruleMatchesAction, ruleMatchesContext, ruleMatchesPath, sanitizePath, serializeCacheEntry, setDefaultCacheManager, setDefaultPermissionManager, setDefaultStorageManager, shouldSyncToRepo, summarizeEvaluations, touchCacheEntry, validateCustomTypes, validateMetadata, validateMigratedConfig, validateOrg, validatePath, validateRules as validatePermissionRules, validateProject, validateRules$1 as validateRules, validateUri };