catalist-support-agent 1.0.0

package/dist/brand/forbidden-terms.js

@@ -0,0 +1,265 @@
+/**
+ * Forbidden Terms Detector
+ *
+ * Scans text for marketplace-specific terminology that requires escalation.
+ * This is a critical component for maintaining Catalist's brand positioning
+ * as an "AI-native B2B marketplace" (NOT a wholesale distributor).
+ *
+ * CRITICAL: Any message containing forbidden terms MUST be escalated to humans.
+ * The agent cannot autonomously respond to these messages.
+ */
+import { getAllForbiddenTerms, config } from '../config.js';
+// =============================================================================
+// Forbidden Terms Detector Class
+// =============================================================================
+export class ForbiddenTermsDetector {
+    patterns;
+    terms;
+    termPatternMap;
+    constructor(customTerms) {
+        // Combine default forbidden terms with any custom terms
+        this.terms = customTerms ?? getAllForbiddenTerms();
+        // Build regex patterns for each term with word boundary matching
+        this.termPatternMap = new Map();
+        this.patterns = this.terms.map((term) => {
+            const pattern = this.buildPattern(term);
+            this.termPatternMap.set(term, pattern);
+            return pattern;
+        });
+    }
+    /**
+     * Build a regex pattern for a term that handles:
+     * - Word boundaries
+     * - Case insensitivity
+     * - Common variations (plurals, etc.)
+     * - Special characters in terms
+     */
+    buildPattern(term) {
+        // Escape special regex characters
+        const escaped = term.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+        // Handle common variations:
+        // - Add optional 's' for plurals
+        // - Add optional 'ing' for verb forms
+        // - Handle spaces that might be replaced with hyphens or underscores
+        const flexible = escaped
+            .replace(/\s+/g, '[\\s\\-_]+') // Allow spaces, hyphens, or underscores
+            .replace(/([a-z])$/i, '$1(?:s|ing)?'); // Optional plural/verb forms
+        // Use word boundaries to avoid partial matches
+        // \b doesn't work well with some terms, so we use lookahead/lookbehind
+        return new RegExp(`(?:^|[\\s\\.,!?;:'\"\\(\\[])${flexible}(?:[\\s\\.,!?;:'\"\\)\\]]|$)`, 'gi');
+    }
+    /**
+     * Scan text for forbidden terms
+     * Returns array of detected terms (empty if none found)
+     */
+    scan(text) {
+        if (!text || typeof text !== 'string') {
+            return [];
+        }
+        const normalizedText = this.normalizeText(text);
+        const detected = new Set();
+        for (const [term, pattern] of this.termPatternMap) {
+            // Reset regex state
+            pattern.lastIndex = 0;
+            if (pattern.test(normalizedText)) {
+                detected.add(term);
+            }
+        }
+        return Array.from(detected);
+    }
+    /**
+     * Quick check if text contains any forbidden terms
+     */
+    containsForbiddenTerms(text) {
+        if (!text || typeof text !== 'string') {
+            return false;
+        }
+        const normalizedText = this.normalizeText(text);
+        for (const pattern of this.patterns) {
+            pattern.lastIndex = 0;
+            if (pattern.test(normalizedText)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Get detailed scan results with positions
+     */
+    scanWithPositions(text) {
+        if (!text || typeof text !== 'string') {
+            return [];
+        }
+        const normalizedText = this.normalizeText(text);
+        const matches = [];
+        for (const [term, pattern] of this.termPatternMap) {
+            pattern.lastIndex = 0;
+            let match;
+            while ((match = pattern.exec(normalizedText)) !== null) {
+                matches.push({
+                    term,
+                    matchedText: match[0].trim(),
+                    position: match.index,
+                    context: this.extractContext(normalizedText, match.index, match[0].length),
+                });
+            }
+        }
+        return matches;
+    }
+    /**
+     * Normalize text for consistent matching
+     */
+    normalizeText(text) {
+        return text
+            .toLowerCase()
+            .normalize('NFD')
+            .replace(/[\u0300-\u036f]/g, ''); // Remove diacritics
+    }
+    /**
+     * Extract surrounding context for a match
+     */
+    extractContext(text, position, matchLength) {
+        const contextRadius = 50;
+        const start = Math.max(0, position - contextRadius);
+        const end = Math.min(text.length, position + matchLength + contextRadius);
+        let context = text.slice(start, end);
+        if (start > 0) {
+            context = '...' + context;
+        }
+        if (end < text.length) {
+            context = context + '...';
+        }
+        return context;
+    }
+    /**
+     * Add additional terms at runtime
+     */
+    addTerms(terms) {
+        for (const term of terms) {
+            if (!this.terms.includes(term.toLowerCase())) {
+                this.terms.push(term.toLowerCase());
+                const pattern = this.buildPattern(term);
+                this.termPatternMap.set(term.toLowerCase(), pattern);
+                this.patterns.push(pattern);
+            }
+        }
+    }
+    /**
+     * Get all registered forbidden terms
+     */
+    getTerms() {
+        return [...this.terms];
+    }
+}
+// =============================================================================
+// Utility Functions
+// =============================================================================
+// Singleton instance for common use
+let defaultDetector = null;
+/**
+ * Get the default forbidden terms detector (singleton)
+ */
+export function getDefaultDetector() {
+    if (!defaultDetector) {
+        defaultDetector = new ForbiddenTermsDetector();
+    }
+    return defaultDetector;
+}
+/**
+ * Quick check if text contains forbidden terms
+ */
+export function containsForbiddenTerms(text) {
+    return getDefaultDetector().containsForbiddenTerms(text);
+}
+/**
+ * Scan text for forbidden terms and return all detected terms
+ */
+export function scanForForbiddenTerms(text) {
+    return getDefaultDetector().scan(text);
+}
+/**
+ * Get detailed scan results
+ */
+export function scanForForbiddenTermsDetailed(text) {
+    const detector = getDefaultDetector();
+    const matches = detector.scanWithPositions(text);
+    return {
+        hasForbiddenTerms: matches.length > 0,
+        detectedTerms: [...new Set(matches.map((m) => m.term))],
+        matches,
+        scannedAt: new Date().toISOString(),
+    };
+}
+/**
+ * Scan message content (handles both plain text and HTML)
+ */
+export function scanMessageContent(content) {
+    const detector = getDefaultDetector();
+    const allMatches = [];
+    // Scan plain text
+    if (content.text) {
+        allMatches.push(...detector.scanWithPositions(content.text));
+    }
+    // Scan HTML (strip tags first)
+    if (content.html) {
+        const strippedHtml = stripHtmlTags(content.html);
+        allMatches.push(...detector.scanWithPositions(strippedHtml));
+    }
+    // Scan subject
+    if (content.subject) {
+        allMatches.push(...detector.scanWithPositions(content.subject));
+    }
+    // Deduplicate terms
+    const uniqueTerms = [...new Set(allMatches.map((m) => m.term))];
+    return {
+        hasForbiddenTerms: allMatches.length > 0,
+        detectedTerms: uniqueTerms,
+        matches: allMatches,
+        scannedAt: new Date().toISOString(),
+    };
+}
+/**
+ * Strip HTML tags from text
+ */
+function stripHtmlTags(html) {
+    return html
+        .replace(/<script[^>]*>[\s\S]*?<\/script>/gi, '') // Remove scripts
+        .replace(/<style[^>]*>[\s\S]*?<\/style>/gi, '') // Remove styles
+        .replace(/<[^>]+>/g, ' ') // Remove all tags
+        .replace(/&nbsp;/g, ' ')
+        .replace(/&amp;/g, '&')
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"')
+        .replace(/&#39;/g, "'")
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+/**
+ * Create brand compliance status from scan result
+ */
+export function createComplianceStatusFromScan(scanResult) {
+    const now = new Date().toISOString();
+    if (scanResult.hasForbiddenTerms) {
+        return {
+            status: 'blocked',
+            detectedTerms: scanResult.detectedTerms,
+            blockedAt: now,
+        };
+    }
+    return {
+        status: 'compliant',
+        score: 100,
+        checkedAt: now,
+    };
+}
+/**
+ * Check if escalation is required based on forbidden terms
+ */
+export function requiresEscalationForForbiddenTerms(text) {
+    if (!config.brandCompliance.enabled) {
+        return false;
+    }
+    return containsForbiddenTerms(text);
+}
+//# sourceMappingURL=forbidden-terms.js.map

package/dist/brand/forbidden-terms.js.map

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

package/dist/brand/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Brand Compliance Module
+ *
+ * Central export for all brand compliance functionality.
+ * This module ensures Catalist's positioning as an "AI-native B2B marketplace"
+ * is consistently maintained across all support communications.
+ */
+export { ForbiddenTermsDetector, containsForbiddenTerms, scanForForbiddenTerms, scanForForbiddenTermsDetailed, scanMessageContent, createComplianceStatusFromScan, requiresEscalationForForbiddenTerms, getDefaultDetector, type ForbiddenTermMatch, type ForbiddenTermsScanResult, } from './forbidden-terms.js';
+export { BrandTerminologyEnforcer, BrandComplianceChecker, checkBrandCompliance, validateResponseForBrand, performBrandTest, getBrandVoiceGuidelines, applyBrandTerminologyCorrections, getDefaultChecker, type TerminologyCorrection, type BrandComplianceCheckResult, type ResponseValidationResult, } from './compliance.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/brand/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/brand/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,6BAA6B,EAC7B,kBAAkB,EAClB,8BAA8B,EAC9B,mCAAmC,EACnC,kBAAkB,EAClB,KAAK,kBAAkB,EACvB,KAAK,wBAAwB,GAC9B,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,wBAAwB,EACxB,sBAAsB,EACtB,oBAAoB,EACpB,wBAAwB,EACxB,gBAAgB,EAChB,uBAAuB,EACvB,gCAAgC,EAChC,iBAAiB,EACjB,KAAK,qBAAqB,EAC1B,KAAK,0BAA0B,EAC/B,KAAK,wBAAwB,GAC9B,MAAM,iBAAiB,CAAC"}

package/dist/brand/index.js

@@ -0,0 +1,12 @@
+/**
+ * Brand Compliance Module
+ *
+ * Central export for all brand compliance functionality.
+ * This module ensures Catalist's positioning as an "AI-native B2B marketplace"
+ * is consistently maintained across all support communications.
+ */
+// Forbidden Terms Detection
+export { ForbiddenTermsDetector, containsForbiddenTerms, scanForForbiddenTerms, scanForForbiddenTermsDetailed, scanMessageContent, createComplianceStatusFromScan, requiresEscalationForForbiddenTerms, getDefaultDetector, } from './forbidden-terms.js';
+// Brand Compliance Checking
+export { BrandTerminologyEnforcer, BrandComplianceChecker, checkBrandCompliance, validateResponseForBrand, performBrandTest, getBrandVoiceGuidelines, applyBrandTerminologyCorrections, getDefaultChecker, } from './compliance.js';
+//# sourceMappingURL=index.js.map

package/dist/brand/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/brand/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,4BAA4B;AAC5B,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,6BAA6B,EAC7B,kBAAkB,EAClB,8BAA8B,EAC9B,mCAAmC,EACnC,kBAAkB,GAGnB,MAAM,sBAAsB,CAAC;AAE9B,4BAA4B;AAC5B,OAAO,EACL,wBAAwB,EACxB,sBAAsB,EACtB,oBAAoB,EACpB,wBAAwB,EACxB,gBAAgB,EAChB,uBAAuB,EACvB,gCAAgC,EAChC,iBAAiB,GAIlB,MAAM,iBAAiB,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,325 @@
+/**
+ * Support Agent Configuration
+ *
+ * Configuration module with Zod schema validation for the Support AI Agent SDK.
+ * Covers Supabase, Claude authentication, channel credentials (Postmark, Twilio, Slack),
+ * and brand compliance settings including forbidden terms list.
+ */
+import { z } from 'zod';
+declare const ConfigSchema: z.ZodObject<{
+    supabase: z.ZodObject<{
+        url: z.ZodString;
+        serviceRoleKey: z.ZodString;
+        anonKey: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    claude: z.ZodObject<{
+        oauthToken: z.ZodOptional<z.ZodString>;
+        apiKey: z.ZodOptional<z.ZodString>;
+        tokenCreatedAt: z.ZodOptional<z.ZodString>;
+        authMode: z.ZodDefault<z.ZodEnum<{
+            oauth: "oauth";
+            api_key: "api_key";
+            none: "none";
+        }>>;
+        model: z.ZodDefault<z.ZodString>;
+        maxTokens: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>;
+    postmark: z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        serverToken: z.ZodOptional<z.ZodString>;
+        fromAddress: z.ZodOptional<z.ZodString>;
+        replyToAddress: z.ZodOptional<z.ZodString>;
+        messageStream: z.ZodDefault<z.ZodString>;
+        webhookToken: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    twilio: z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        accountSid: z.ZodOptional<z.ZodString>;
+        authToken: z.ZodOptional<z.ZodString>;
+        fromNumber: z.ZodOptional<z.ZodString>;
+        messagingServiceSid: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    slack: z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        botToken: z.ZodOptional<z.ZodString>;
+        signingSecret: z.ZodOptional<z.ZodString>;
+        appId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    agent: z.ZodObject<{
+        responseTimeoutMs: z.ZodDefault<z.ZodNumber>;
+        maxConversationTurns: z.ZodDefault<z.ZodNumber>;
+        confidenceThresholds: z.ZodObject<{
+            high: z.ZodDefault<z.ZodNumber>;
+            medium: z.ZodDefault<z.ZodNumber>;
+            escalationTrigger: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>;
+        maxResponseAttempts: z.ZodDefault<z.ZodNumber>;
+        shadowMode: z.ZodDefault<z.ZodBoolean>;
+        autonomyPercentage: z.ZodDefault<z.ZodNumber>;
+        permissionMode: z.ZodDefault<z.ZodEnum<{
+            default: "default";
+            acceptEdits: "acceptEdits";
+            bypassPermissions: "bypassPermissions";
+            plan: "plan";
+        }>>;
+    }, z.core.$strip>;
+    brandCompliance: z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        forbiddenTerms: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        customForbiddenTerms: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        voiceEnforcementLevel: z.ZodDefault<z.ZodEnum<{
+            strict: "strict";
+            moderate: "moderate";
+            relaxed: "relaxed";
+        }>>;
+        preSendValidation: z.ZodDefault<z.ZodBoolean>;
+        postSendAudit: z.ZodDefault<z.ZodBoolean>;
+        enforcedTerminology: z.ZodDefault<z.ZodObject<{
+            preferredTerms: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    escalation: z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        defaultRecipients: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            email: z.ZodOptional<z.ZodString>;
+            phone: z.ZodOptional<z.ZodString>;
+            slackUserId: z.ZodOptional<z.ZodString>;
+            name: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        adminBaseUrl: z.ZodDefault<z.ZodString>;
+        routing: z.ZodDefault<z.ZodObject<{
+            critical: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+                email: "email";
+                sms: "sms";
+                slack: "slack";
+            }>>>;
+            high: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+                email: "email";
+                sms: "sms";
+                slack: "slack";
+            }>>>;
+            medium: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+                email: "email";
+                slack: "slack";
+            }>>>;
+            low: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+                email: "email";
+                slack: "slack";
+            }>>>;
+        }, z.core.$strip>>;
+        reEscalateAfterMs: z.ZodDefault<z.ZodNumber>;
+        slaTargets: z.ZodDefault<z.ZodObject<{
+            critical: z.ZodDefault<z.ZodNumber>;
+            high: z.ZodDefault<z.ZodNumber>;
+            medium: z.ZodDefault<z.ZodNumber>;
+            low: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    knowledge: z.ZodObject<{
+        customerDataEnabled: z.ZodDefault<z.ZodBoolean>;
+        productLookupEnabled: z.ZodDefault<z.ZodBoolean>;
+        similarConversationsEnabled: z.ZodDefault<z.ZodBoolean>;
+        maxSimilarConversations: z.ZodDefault<z.ZodNumber>;
+        similarityThreshold: z.ZodDefault<z.ZodNumber>;
+        templatesEnabled: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>;
+    openai: z.ZodObject<{
+        apiKey: z.ZodOptional<z.ZodString>;
+        embeddingModel: z.ZodDefault<z.ZodString>;
+        embeddingDimensions: z.ZodDefault<z.ZodNumber>;
+        embeddingCacheMaxSize: z.ZodDefault<z.ZodNumber>;
+        embeddingCacheTtlMs: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>;
+    logging: z.ZodObject<{
+        level: z.ZodDefault<z.ZodEnum<{
+            error: "error";
+            debug: "debug";
+            info: "info";
+            warn: "warn";
+        }>>;
+        structured: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type Config = z.infer<typeof ConfigSchema>;
+export declare const config: {
+    supabase: {
+        url: string;
+        serviceRoleKey: string;
+        anonKey?: string | undefined;
+    };
+    claude: {
+        authMode: "oauth" | "api_key" | "none";
+        model: string;
+        maxTokens: number;
+        oauthToken?: string | undefined;
+        apiKey?: string | undefined;
+        tokenCreatedAt?: string | undefined;
+    };
+    postmark: {
+        enabled: boolean;
+        messageStream: string;
+        serverToken?: string | undefined;
+        fromAddress?: string | undefined;
+        replyToAddress?: string | undefined;
+        webhookToken?: string | undefined;
+    };
+    twilio: {
+        enabled: boolean;
+        accountSid?: string | undefined;
+        authToken?: string | undefined;
+        fromNumber?: string | undefined;
+        messagingServiceSid?: string | undefined;
+    };
+    slack: {
+        enabled: boolean;
+        botToken?: string | undefined;
+        signingSecret?: string | undefined;
+        appId?: string | undefined;
+    };
+    agent: {
+        responseTimeoutMs: number;
+        maxConversationTurns: number;
+        confidenceThresholds: {
+            high: number;
+            medium: number;
+            escalationTrigger: number;
+        };
+        maxResponseAttempts: number;
+        shadowMode: boolean;
+        autonomyPercentage: number;
+        permissionMode: "default" | "acceptEdits" | "bypassPermissions" | "plan";
+    };
+    brandCompliance: {
+        enabled: boolean;
+        forbiddenTerms: string[];
+        customForbiddenTerms: string[];
+        voiceEnforcementLevel: "strict" | "moderate" | "relaxed";
+        preSendValidation: boolean;
+        postSendAudit: boolean;
+        enforcedTerminology: {
+            preferredTerms: Record<string, string>;
+        };
+    };
+    escalation: {
+        enabled: boolean;
+        defaultRecipients: {
+            email?: string | undefined;
+            phone?: string | undefined;
+            slackUserId?: string | undefined;
+            name?: string | undefined;
+        }[];
+        adminBaseUrl: string;
+        routing: {
+            critical: ("email" | "sms" | "slack")[];
+            high: ("email" | "sms" | "slack")[];
+            medium: ("email" | "slack")[];
+            low: ("email" | "slack")[];
+        };
+        reEscalateAfterMs: number;
+        slaTargets: {
+            critical: number;
+            high: number;
+            medium: number;
+            low: number;
+        };
+    };
+    knowledge: {
+        customerDataEnabled: boolean;
+        productLookupEnabled: boolean;
+        similarConversationsEnabled: boolean;
+        maxSimilarConversations: number;
+        similarityThreshold: number;
+        templatesEnabled: boolean;
+    };
+    openai: {
+        embeddingModel: string;
+        embeddingDimensions: number;
+        embeddingCacheMaxSize: number;
+        embeddingCacheTtlMs: number;
+        apiKey?: string | undefined;
+    };
+    logging: {
+        level: "error" | "debug" | "info" | "warn";
+        structured: boolean;
+    };
+};
+/**
+ * Get all forbidden terms (default + custom)
+ */
+export declare function getAllForbiddenTerms(): string[];
+/**
+ * Check if a channel is configured and enabled
+ */
+export declare function isChannelEnabled(channel: 'postmark' | 'twilio' | 'slack'): boolean;
+/**
+ * Get escalation channels for a given severity
+ */
+export declare function getEscalationChannels(severity: 'critical' | 'high' | 'medium' | 'low'): Array<'email' | 'sms' | 'slack'>;
+/**
+ * Check if autonomous response is allowed (based on shadow mode and autonomy percentage)
+ */
+export declare function isAutonomousResponseAllowed(): boolean;
+/**
+ * Get SLA target for a severity level
+ */
+export declare function getSlaTarget(severity: 'critical' | 'high' | 'medium' | 'low'): number;
+export type AuthenticationMode = 'oauth' | 'api_key' | 'none';
+export interface AuthenticationStatus {
+    isValid: boolean;
+    mode: AuthenticationMode;
+    message: string;
+    warnings: string[];
+}
+/**
+ * Validate Claude authentication configuration
+ */
+export declare function validateAuthentication(): AuthenticationStatus;
+export type ConfidenceLevel = 'high' | 'medium' | 'low';
+export declare function classifyConfidence(score: number): ConfidenceLevel;
+export declare function shouldEscalateByConfidence(confidence: number): boolean;
+/**
+ * Options for creating a config with runtime overrides.
+ * These override the values loaded from environment variables.
+ */
+export interface CreateConfigOptions {
+    supabase?: {
+        url?: string;
+        serviceRoleKey?: string;
+        anonKey?: string;
+    };
+    claude?: {
+        apiKey?: string;
+        oauthToken?: string;
+        model?: string;
+        maxTokens?: number;
+    };
+}
+/**
+ * Create a configuration object with optional runtime overrides.
+ *
+ * This function is useful when the library is imported by an application
+ * that already has its own environment variables (e.g., Admin Portal with
+ * NEXT_PUBLIC_SUPABASE_URL, SUPABASE_SERVICE_ROLE_KEY, ANTHROPIC_API_KEY).
+ *
+ * The overrides are merged with the base config loaded from environment variables.
+ *
+ * @param options - Optional overrides for supabase and claude credentials
+ * @returns A validated Config object
+ *
+ * @example
+ * ```typescript
+ * // Use with Next.js environment variables
+ * const customConfig = createConfig({
+ *   supabase: {
+ *     url: process.env.NEXT_PUBLIC_SUPABASE_URL,
+ *     serviceRoleKey: process.env.SUPABASE_SERVICE_ROLE_KEY,
+ *   },
+ *   claude: {
+ *     apiKey: process.env.ANTHROPIC_API_KEY,
+ *   },
+ * });
+ * ```
+ */
+export declare function createConfig(options?: CreateConfigOptions): Config;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA2CxB,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA2NhB,CAAC;AAEH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAgHlD,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAe,CAAC;AAMnC;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAK/C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,CAWlF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,GAC/C,KAAK,CAAC,OAAO,GAAG,KAAK,GAAG,OAAO,CAAC,CAElC;AAED;;GAEG;AACH,wBAAgB,2BAA2B,IAAI,OAAO,CAerD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,CAErF;AAMD,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAE9D,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,kBAAkB,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,oBAAoB,CA4B7D;AAMD,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAExD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAQjE;AAED,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAEtE;AAMD;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE;QACT,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,MAAM,CAAC,EAAE;QACP,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,MAAM,CA2CtE"}