@fractary/codex 0.9.0 → 0.9.1

package/dist/index.d.ts

@@ -393,6 +393,7 @@ 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>;
@@ -501,8 +502,78 @@ 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?: {
         source?: string | undefined;
         systems?: string | undefined;
@@ -535,8 +606,26 @@ 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?: {
         source?: string | undefined;
         systems?: string | undefined;
@@ -569,6 +658,23 @@ 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<{
@@ -614,10 +720,10 @@ declare const UnifiedConfigSchema: z.ZodObject<{
             } | undefined;
             bucket?: string | undefined;
             prefix?: string | undefined;
-            region?: string | undefined;
             auth?: {
                 profile?: string | undefined;
             } | undefined;
+            region?: string | undefined;
         }, {
             local: {
                 base_path: string;
@@ -629,10 +735,10 @@ declare const UnifiedConfigSchema: z.ZodObject<{
             } | undefined;
             bucket?: string | undefined;
             prefix?: string | undefined;
-            region?: string | undefined;
             auth?: {
                 profile?: string | undefined;
             } | undefined;
+            region?: string | undefined;
         }>, {
             local: {
                 base_path: string;
@@ -644,10 +750,10 @@ declare const UnifiedConfigSchema: z.ZodObject<{
             } | undefined;
             bucket?: string | undefined;
             prefix?: string | undefined;
-            region?: string | undefined;
             auth?: {
                 profile?: string | undefined;
             } | undefined;
+            region?: string | undefined;
         }, {
             local: {
                 base_path: string;
@@ -659,13 +765,12 @@ declare const UnifiedConfigSchema: z.ZodObject<{
             } | undefined;
             bucket?: string | undefined;
             prefix?: string | undefined;
-            region?: string | undefined;
             auth?: {
                 profile?: string | undefined;
             } | undefined;
+            region?: string | undefined;
         }>>;
     }, "strip", z.ZodTypeAny, {
-        schema_version: string;
         sources: Record<string, {
             local: {
                 base_path: string;
@@ -677,13 +782,13 @@ declare const UnifiedConfigSchema: z.ZodObject<{
             } | undefined;
             bucket?: string | undefined;
             prefix?: string | undefined;
-            region?: string | undefined;
             auth?: {
                 profile?: string | undefined;
             } | undefined;
+            region?: string | undefined;
         }>;
-    }, {
         schema_version: string;
+    }, {
         sources: Record<string, {
             local: {
                 base_path: string;
@@ -695,14 +800,16 @@ declare const UnifiedConfigSchema: z.ZodObject<{
             } | undefined;
             bucket?: string | undefined;
             prefix?: string | undefined;
-            region?: 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>;
@@ -811,8 +918,78 @@ declare const UnifiedConfigSchema: 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?: {
             source?: string | undefined;
             systems?: string | undefined;
@@ -845,8 +1022,26 @@ declare const UnifiedConfigSchema: 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?: {
             source?: string | undefined;
             systems?: string | undefined;
@@ -879,10 +1074,26 @@ declare const UnifiedConfigSchema: 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;
     }>>;
 }, "strip", z.ZodTypeAny, {
     file?: {
-        schema_version: string;
         sources: Record<string, {
             local: {
                 base_path: string;
@@ -894,14 +1105,16 @@ declare const UnifiedConfigSchema: z.ZodObject<{
             } | undefined;
             bucket?: string | undefined;
             prefix?: string | undefined;
-            region?: 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;
@@ -934,10 +1147,26 @@ declare const UnifiedConfigSchema: 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;
     } | undefined;
 }, {
     file?: {
-        schema_version: string;
         sources: Record<string, {
             local: {
                 base_path: string;
@@ -949,14 +1178,16 @@ declare const UnifiedConfigSchema: z.ZodObject<{
             } | undefined;
             bucket?: string | undefined;
             prefix?: string | undefined;
-            region?: 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;
@@ -989,6 +1220,23 @@ declare const UnifiedConfigSchema: 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;
     } | undefined;
 }>;
 type UnifiedConfig = z.infer<typeof UnifiedConfigSchema>;
@@ -1181,11 +1429,15 @@ interface StorageManagerConfig {
     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;

package/dist/index.js

@@ -883,8 +883,40 @@ var ArchiveProjectConfigSchema = z.object({
 var ArchiveConfigSchema = z.object({
   projects: z.record(ArchiveProjectConfigSchema)
 });
+var GitHubAuthConfigSchema = z.object({
+  /** Default token environment variable name (default: GITHUB_TOKEN) */
+  default_token_env: z.string().optional(),
+  /** Fallback to public access if authentication fails */
+  fallback_to_public: z.boolean().optional()
+});
+var AuthConfigSchema = z.object({
+  /** GitHub authentication configuration */
+  github: GitHubAuthConfigSchema.optional()
+});
+var SourceConfigSchema = z.object({
+  /** Source type */
+  type: z.enum(["github", "s3", "http", "local"]),
+  /** Environment variable containing the authentication token */
+  token_env: z.string().optional(),
+  /** Direct token value (not recommended, use token_env instead) */
+  token: z.string().optional(),
+  /** Branch to fetch from (for GitHub sources) */
+  branch: z.string().optional(),
+  /** Base URL (for HTTP sources) */
+  base_url: z.string().optional(),
+  /** Bucket name (for S3 sources) */
+  bucket: z.string().optional(),
+  /** Prefix/path within bucket (for S3 sources) */
+  prefix: z.string().optional()
+});
+var DependencyConfigSchema = z.object({
+  /** Sources within this dependency */
+  sources: z.record(SourceConfigSchema)
+});
 var CodexConfigSchema = z.object({
   organizationSlug: z.string(),
+  /** Project name (optional) */
+  project: z.string().optional(),
   directories: z.object({
     source: z.string().optional(),
     target: z.string().optional(),
@@ -894,7 +926,11 @@ var CodexConfigSchema = z.object({
   // Directional sync configuration
   sync: DirectionalSyncSchema.optional(),
   // Archive configuration
-  archive: ArchiveConfigSchema.optional()
+  archive: ArchiveConfigSchema.optional(),
+  // Authentication configuration
+  auth: AuthConfigSchema.optional(),
+  // Dependencies configuration (external projects)
+  dependencies: z.record(DependencyConfigSchema).optional()
 }).strict();
 var FileSourceSchema = z.object({
   type: z.enum(["s3", "r2", "gcs", "local"]),
@@ -2269,7 +2305,9 @@ var S3ArchiveStorage = class {
 var StorageManager = class {
   providers = /* @__PURE__ */ new Map();
   priority;
+  codexConfig;
   constructor(config = {}) {
+    this.codexConfig = config.codexConfig;
     this.providers.set("local", new LocalStorage(config.local));
     this.providers.set("github", new GitHubStorage(config.github));
     this.providers.set("http", new HttpStorage(config.http));
@@ -2281,6 +2319,48 @@ var StorageManager = class {
     }
     this.priority = config.priority || (config.filePlugin && config.s3Archive ? ["file-plugin", "local", "s3-archive", "github", "http"] : config.filePlugin ? ["file-plugin", "local", "github", "http"] : config.s3Archive ? ["local", "s3-archive", "github", "http"] : ["local", "github", "http"]);
   }
+  /**
+   * Resolve authentication token for a reference
+   *
+   * Looks up dependency-specific authentication or falls back to default
+   */
+  resolveToken(reference) {
+    if (!this.codexConfig) {
+      return void 0;
+    }
+    const dependencyKey = `${reference.org}/${reference.project}`;
+    if (this.codexConfig.dependencies?.[dependencyKey]) {
+      const dependency = this.codexConfig.dependencies[dependencyKey];
+      for (const [, sourceConfig] of Object.entries(dependency.sources)) {
+        if (sourceConfig.type === "github") {
+          if (sourceConfig.token_env) {
+            const token = process.env[sourceConfig.token_env];
+            if (token) {
+              return token;
+            }
+          }
+          if (sourceConfig.token) {
+            return sourceConfig.token;
+          }
+        }
+      }
+    }
+    const defaultTokenEnv = this.codexConfig.auth?.github?.default_token_env || "GITHUB_TOKEN";
+    return process.env[defaultTokenEnv];
+  }
+  /**
+   * Resolve fetch options with authentication
+   *
+   * Merges reference-specific authentication with provided options
+   */
+  resolveFetchOptions(reference, options) {
+    const token = this.resolveToken(reference);
+    return {
+      ...options,
+      token: options?.token || token
+      // Explicit option overrides resolved token
+    };
+  }
   /**
    * Register a custom storage provider
    */
@@ -2321,8 +2401,10 @@ var StorageManager = class {
    * Fetch content for a reference
    *
    * Tries providers in priority order until one succeeds.
+   * Automatically resolves authentication based on dependency configuration.
    */
   async fetch(reference, options) {
+    const resolvedOptions = this.resolveFetchOptions(reference, options);
     const errors = [];
     for (const type of this.priority) {
       const provider = this.providers.get(type);
@@ -2330,7 +2412,7 @@ var StorageManager = class {
         continue;
       }
       try {
-        return await provider.fetch(reference, options);
+        return await provider.fetch(reference, resolvedOptions);
       } catch (error) {
         errors.push(error instanceof Error ? error : new Error(String(error)));
       }
@@ -2351,15 +2433,17 @@ var StorageManager = class {
    * Check if content exists for a reference
    *
    * Returns true if any provider reports the content exists.
+   * Automatically resolves authentication based on dependency configuration.
    */
   async exists(reference, options) {
+    const resolvedOptions = this.resolveFetchOptions(reference, options);
     for (const type of this.priority) {
       const provider = this.providers.get(type);
       if (!provider || !provider.canHandle(reference)) {
         continue;
       }
       try {
-        if (await provider.exists(reference, options)) {
+        if (await provider.exists(reference, resolvedOptions)) {
           return true;
         }
       } catch {
@@ -2379,6 +2463,8 @@ var StorageManager = class {
   }
   /**
    * Fetch multiple references in parallel
+   *
+   * Automatically resolves authentication for each reference based on dependency configuration.
    */
   async fetchMany(references, options) {
     const results = /* @__PURE__ */ new Map();