@semiont/core 0.3.3 → 0.3.5

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 import { Subject, OperatorFunction } from 'rxjs';
-import { ErrorObject } from 'ajv';
+import { E as EnvironmentConfig, P as PlatformType$1 } from './config.types-Cas714K0.js';
+export { A as AnthropicProviderConfig, a as AppConfig, B as BackendServiceConfig, D as DatabaseServiceConfig, F as FrontendServiceConfig, G as GraphDatabaseType, b as GraphServiceConfig, I as InferenceProvidersConfig, M as McpServiceConfig, O as OllamaProviderConfig, c as ProxyServiceConfig, S as SemiontConfig, d as ServicePlatformConfig, e as ServicesConfig, f as SiteConfig } from './config.types-Cas714K0.js';
 
 /**
  * This file was auto-generated by openapi-typescript.
@@ -4987,775 +4988,63 @@ declare function userToAgent(user: {
 declare function didToAgent(did: string): Agent;
 
 /**
- * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
- * via the `definition` "PlatformType".
- */
-type PlatformType$1 = 'posix' | 'container' | 'aws' | 'external';
-/**
- * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
- * via the `definition` "GraphDatabaseType".
- */
-type GraphDatabaseType = 'neo4j' | 'janusgraph' | 'neptune' | 'memory';
-/**
- * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
- * via the `definition` "GraphServiceConfig".
- */
-type GraphServiceConfig = {
-    [k: string]: unknown;
-} & {
-    platform: ServicePlatformConfig;
-    type: GraphDatabaseType;
-    name?: string;
-    uri?: string;
-    url?: string;
-    username?: string;
-    password?: string;
-    database?: string;
-    host?: string;
-    port?: number;
-    storage?: string;
-    index?: string;
-    endpoint?: string;
-    region?: string;
-    command?: string;
-    image?: string;
-    janusgraphVersion?: string;
-    javaOptions?: string;
-    heapSize?: string;
-    pageCacheSize?: string;
-    noAuth?: boolean;
-    dataPath?: string;
-    timeout?: number;
-    wait?: number;
-    logsEndpoint?: string;
-    tag?: string;
-    resources?: ResourceRequirements;
-    security?: SecurityRequirements;
-    build?: boolean | BuildRequirements;
-    dockerfile?: string;
-    buildContext?: string;
-    buildArgs?: {
-        [k: string]: string;
-    };
-    buildTarget?: string;
-    prebuilt?: boolean;
-    noCache?: boolean;
-    secrets?: string[];
-    labels?: {
-        [k: string]: string;
-    };
-    annotations?: {
-        [k: string]: string;
-    };
-    dependencies?: string[];
-    externalDependencies?: (string | {
-        name?: string;
-        url?: string;
-        required?: boolean;
-        healthCheck?: string;
-        [k: string]: unknown;
-    })[];
-    environment?: {
-        [k: string]: string;
-    };
-    env?: {
-        [k: string]: string;
-    };
-};
-/**
- * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
- * via the `definition` "ServicePlatformConfig".
- */
-interface ServicePlatformConfig {
-    type: PlatformType$1;
-    [k: string]: unknown;
-}
-/**
- * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
- * via the `definition` "ResourceRequirements".
- */
-interface ResourceRequirements {
-    cpu?: string;
-    memory?: string;
-    gpu?: number;
-    gpus?: number;
-    replicas?: number;
-    ephemeralStorage?: string;
-    memoryReservation?: string;
-}
-/**
- * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
- * via the `definition` "SecurityRequirements".
- */
-interface SecurityRequirements {
-    readOnlyRootFilesystem?: boolean;
-    runAsNonRoot?: boolean;
-    runAsUser?: number;
-    runAsGroup?: number;
-    capabilities?: string[] | {
-        add?: string[];
-        drop?: string[];
-        [k: string]: unknown;
-    };
-    privileged?: boolean;
-    allowPrivilegeEscalation?: boolean;
-}
-/**
- * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
- * via the `definition` "BuildRequirements".
- */
-interface BuildRequirements {
-    dockerfile?: string;
-    buildContext?: string;
-    buildArgs?: {
-        [k: string]: string;
-    };
-    buildTarget?: string;
-    prebuilt?: boolean;
-    noCache?: boolean;
-}
-/**
- * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
- * via the `definition` "BackendServiceConfig".
- */
-interface BackendServiceConfig {
-    platform: ServicePlatformConfig;
-    devMode?: boolean;
-    command?: string;
-    port: number;
-    publicURL: string;
-    corsOrigin: string;
-    image?: string;
-    cpu?: string;
-    memory?: string;
-    semiontRepo?: string;
-    databaseUrl?: string;
-    projectRoot?: string;
-    timeout?: number;
-    wait?: number;
-    logsEndpoint?: string;
-    tag?: string;
-    resources?: ResourceRequirements;
-    security?: SecurityRequirements;
-    build?: boolean | BuildRequirements;
-    dockerfile?: string;
-    buildContext?: string;
-    buildArgs?: {
-        [k: string]: string;
-    };
-    buildTarget?: string;
-    prebuilt?: boolean;
-    noCache?: boolean;
-    secrets?: string[];
-    labels?: {
-        [k: string]: string;
-    };
-    annotations?: {
-        [k: string]: string;
-    };
-    dependencies?: string[];
-    externalDependencies?: (string | {
-        name?: string;
-        url?: string;
-        required?: boolean;
-        healthCheck?: string;
-        [k: string]: unknown;
-    })[];
-    redisUrl?: string;
-    environment?: {
-        [k: string]: string;
-    };
-    env?: {
-        [k: string]: string;
-    };
-}
-/**
- * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
- * via the `definition` "FrontendServiceConfig".
- */
-interface FrontendServiceConfig {
-    platform: ServicePlatformConfig;
-    devMode?: boolean;
-    command?: string;
-    port: number;
-    siteName: string;
-    image?: string;
-    semiontRepo?: string;
-    projectRoot?: string;
-    databaseUrl?: string;
-    timeout?: number;
-    wait?: number;
-    logsEndpoint?: string;
-    tag?: string;
-    resources?: ResourceRequirements;
-    security?: SecurityRequirements;
-    build?: boolean | BuildRequirements;
-    dockerfile?: string;
-    buildContext?: string;
-    buildArgs?: {
-        [k: string]: string;
-    };
-    buildTarget?: string;
-    prebuilt?: boolean;
-    noCache?: boolean;
-    secrets?: string[];
-    labels?: {
-        [k: string]: string;
-    };
-    annotations?: {
-        [k: string]: string;
-    };
-    dependencies?: string[];
-    externalDependencies?: (string | {
-        name?: string;
-        url?: string;
-        required?: boolean;
-        healthCheck?: string;
-        [k: string]: unknown;
-    })[];
-    environment?: {
-        [k: string]: string;
-    };
-    env?: {
-        [k: string]: string;
-    };
-    publicURL?: string;
-    allowedOrigins?: string[];
-}
-/**
- * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
- * via the `definition` "ProxyServiceConfig".
- */
-interface ProxyServiceConfig {
-    platform: ServicePlatformConfig;
-    type: 'envoy' | 'nginx' | 'haproxy';
-    port: number;
-    adminPort?: number;
-    backendPort?: number;
-    frontendPort?: number;
-    image?: string;
-    configPath?: string;
-    timeout?: number;
-    wait?: number;
-    logsEndpoint?: string;
-    tag?: string;
-    resources?: ResourceRequirements;
-    security?: SecurityRequirements;
-    environment?: {
-        [k: string]: string;
-    };
-    env?: {
-        [k: string]: string;
-    };
-}
-/**
- * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
- * via the `definition` "DatabaseServiceConfig".
- */
-interface DatabaseServiceConfig {
-    platform: ServicePlatformConfig;
-    type: string;
-    name?: string;
-    host: string;
-    port: number;
-    environment?: {
-        [k: string]: string;
-    };
-    env?: {
-        [k: string]: string;
-    };
-    description?: string;
-    command?: string;
-    image?: string;
-    user?: string;
-    username?: string;
-    password?: string;
-    database?: string;
-    storageSize?: string;
-    timeout?: number;
-    wait?: number;
-    logsEndpoint?: string;
-    tag?: string;
-    resources?: ResourceRequirements;
-    security?: SecurityRequirements;
-    build?: boolean | BuildRequirements;
-    dockerfile?: string;
-    buildContext?: string;
-    buildArgs?: {
-        [k: string]: string;
-    };
-    buildTarget?: string;
-    prebuilt?: boolean;
-    noCache?: boolean;
-    secrets?: string[];
-    labels?: {
-        [k: string]: string;
-    };
-    annotations?: {
-        [k: string]: string;
-    };
-    dependencies?: string[];
-    externalDependencies?: (string | {
-        name?: string;
-        url?: string;
-        required?: boolean;
-        healthCheck?: string;
-        [k: string]: unknown;
-    })[];
-}
-/**
- * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
- * via the `definition` "FilesystemServiceConfig".
- */
-interface FilesystemServiceConfig {
-    platform: ServicePlatformConfig;
-    path: string;
-    description?: string;
-    command?: string;
-    image?: string;
-    port?: number;
-    timeout?: number;
-    wait?: number;
-    logsEndpoint?: string;
-    tag?: string;
-    resources?: ResourceRequirements;
-    security?: SecurityRequirements;
-    build?: boolean | BuildRequirements;
-    dockerfile?: string;
-    buildContext?: string;
-    buildArgs?: {
-        [k: string]: string;
-    };
-    buildTarget?: string;
-    prebuilt?: boolean;
-    noCache?: boolean;
-    secrets?: string[];
-    labels?: {
-        [k: string]: string;
-    };
-    annotations?: {
-        [k: string]: string;
-    };
-    dependencies?: string[];
-    externalDependencies?: (string | {
-        name?: string;
-        url?: string;
-        required?: boolean;
-        healthCheck?: string;
-        [k: string]: unknown;
-    })[];
-    environment?: {
-        [k: string]: string;
-    };
-    env?: {
-        [k: string]: string;
-    };
-}
-/**
- * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
- * via the `definition` "InferenceServiceConfig".
- */
-interface InferenceServiceConfig {
-    platform: ServicePlatformConfig;
-    type: string;
-    model?: string;
-    maxTokens?: number;
-    endpoint?: string;
-    baseURL?: string;
-    apiKey: string;
-    command?: string;
-    image?: string;
-    port?: number;
-    organization?: string;
-    timeout?: number;
-    wait?: number;
-    logsEndpoint?: string;
-    tag?: string;
-    resources?: ResourceRequirements;
-    security?: SecurityRequirements;
-    build?: boolean | BuildRequirements;
-    dockerfile?: string;
-    buildContext?: string;
-    buildArgs?: {
-        [k: string]: string;
-    };
-    buildTarget?: string;
-    prebuilt?: boolean;
-    noCache?: boolean;
-    secrets?: string[];
-    labels?: {
-        [k: string]: string;
-    };
-    annotations?: {
-        [k: string]: string;
-    };
-    dependencies?: string[];
-    externalDependencies?: (string | {
-        name?: string;
-        url?: string;
-        required?: boolean;
-        healthCheck?: string;
-        [k: string]: unknown;
-    })[];
-    environment?: {
-        [k: string]: string;
-    };
-    env?: {
-        [k: string]: string;
-    };
-}
-/**
- * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
- * via the `definition` "McpServiceConfig".
- */
-interface McpServiceConfig {
-    platform: ServicePlatformConfig;
-    command?: string;
-    image?: string;
-    port?: number;
-    dependsOn?: string[];
-    timeout?: number;
-    wait?: number;
-    logsEndpoint?: string;
-    tag?: string;
-    resources?: ResourceRequirements;
-    security?: SecurityRequirements;
-    build?: boolean | BuildRequirements;
-    dockerfile?: string;
-    buildContext?: string;
-    buildArgs?: {
-        [k: string]: string;
-    };
-    buildTarget?: string;
-    prebuilt?: boolean;
-    noCache?: boolean;
-    secrets?: string[];
-    labels?: {
-        [k: string]: string;
-    };
-    annotations?: {
-        [k: string]: string;
-    };
-    dependencies?: string[];
-    externalDependencies?: (string | {
-        name?: string;
-        url?: string;
-        required?: boolean;
-        healthCheck?: string;
-        [k: string]: unknown;
-    })[];
-    environment?: {
-        [k: string]: string;
-    };
-    env?: {
-        [k: string]: string;
-    };
-}
-/**
- * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
- * via the `definition` "ServicesConfig".
- */
-interface ServicesConfig {
-    backend?: BackendServiceConfig;
-    frontend?: FrontendServiceConfig;
-    database?: DatabaseServiceConfig;
-    graph?: GraphServiceConfig;
-    filesystem?: FilesystemServiceConfig;
-    inference?: InferenceServiceConfig;
-    mcp?: McpServiceConfig;
-    proxy?: ProxyServiceConfig;
-    [k: string]: unknown;
-}
-/**
- * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
- * via the `definition` "SiteConfig".
- */
-interface SiteConfig {
-    /**
-     * Display name for the site
-     */
-    siteName?: string;
-    /**
-     * Primary domain for the site
-     */
-    domain: string;
-    /**
-     * Administrator email address
-     */
-    adminEmail?: string;
-    /**
-     * Support email address (optional)
-     */
-    supportEmail?: string;
-    /**
-     * Email domains allowed for OAuth authentication
-     *
-     * @minItems 1
-     */
-    oauthAllowedDomains?: [string, ...string[]];
-}
-/**
- * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
- * via the `definition` "AppConfig".
- */
-interface AppConfig {
-    features?: {
-        enableAnalytics?: boolean;
-        enableMaintenanceMode?: boolean;
-        enableDebugLogging?: boolean;
-    };
-    security?: {
-        /**
-         * Session timeout in seconds
-         */
-        sessionTimeout?: number;
-        /**
-         * Maximum failed login attempts before lockout
-         */
-        maxLoginAttempts?: number;
-        corsAllowedOrigins?: string[];
-        /**
-         * Enable local username/password authentication
-         */
-        enableLocalAuth?: boolean;
-        /**
-         * JWT signing secret (base64 encoded, 32+ bytes)
-         */
-        jwtSecret?: string;
-    };
-    performance?: {
-        enableCaching?: boolean;
-        /**
-         * Cache timeout in seconds
-         */
-        cacheTimeout?: number;
-        /**
-         * Maximum request size (e.g., '10mb')
-         */
-        maxRequestSize?: string;
-    };
-}
-/**
- * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
- * via the `definition` "EnvironmentConfig".
- */
-interface EnvironmentConfig {
-    /**
-     * Optional comment for documentation
-     */
-    _comment?: string;
-    _metadata?: {
-        environment: string;
-        projectRoot: string;
-        [k: string]: unknown;
-    };
-    /**
-     * Environment name
-     */
-    name?: string;
-    platform?: {
-        default?: PlatformType$1;
-        [k: string]: unknown;
-    };
-    services: ServicesConfig;
-    site?: SiteConfig;
-    app?: AppConfig;
-    env?: {
-        NODE_ENV?: 'development' | 'production' | 'test';
-        [k: string]: unknown;
-    };
-    /**
-     * Logging verbosity level
-     */
-    logLevel?: 'error' | 'warn' | 'info' | 'http' | 'debug';
-    deployment?: {
-        imageTagStrategy?: 'mutable' | 'immutable' | 'git-hash';
-        [k: string]: unknown;
-    };
-}
-/**
- * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
- * via the `definition` "SemiontConfig".
- */
-interface SemiontConfig {
-    /**
-     * Config file version (semver)
-     */
-    version: string;
-    /**
-     * Project name
-     */
-    project: string;
-    site: SiteConfig;
-    app?: AppConfig;
-    services?: ServicesConfig;
-}
-
-/**
- * Platform Types Module
+ * TOML Config Loader
  *
- * Re-exports PlatformType from schema-generated types.
- * Platforms represent WHERE services run (infrastructure targets).
- */
-
-/**
- * Platform type literals from JSON Schema
- * These represent the infrastructure targets where services can be deployed
- */
-type PlatformType = PlatformType$1;
-/**
- * Type guard to check if a string is a valid platform type
+ * Reads ~/.semiontconfig (TOML) and .semiont/config (TOML) and produces
+ * an EnvironmentConfig for the requested environment.
  *
- * @param value - Value to check
- * @returns True if value is a valid PlatformType
- */
-declare function isValidPlatformType(value: string): value is PlatformType;
-/**
- * Get all valid platform types
- *
- * @returns Array of all platform types
- */
-declare function getAllPlatformTypes(): PlatformType[];
-
-/**
- * Environment Loader Module
+ * File format: see TOML-XDG-CONFIG.md
  *
- * Responsible for parsing and merging environment configurations.
- * Pure functions only - callers handle filesystem I/O.
+ * Loading sequence:
+ *   1. Read .semiont/config  → projectName, site, environments.<env>.* (project base)
+ *   2. Read ~/.semiontconfig → defaults, environments.<env>.* (user overrides)
+ *   3. Deep-merge: project base ← user overrides (user wins on conflicts)
+ *      Any environment name is valid (local, staging, production, custom, ...)
+ *   4. Resolve ${VAR} references from process.env
+ *   5. Apply inheritance: workers.<name> → workers.default → error
+ *   6. Map to EnvironmentConfig shape
  */
 
-/**
- * Generic service configuration
- * Platform-specific fields should be accessed through platform-specific interfaces
- */
-interface ServiceConfig {
-    platform?: {
-        type: PlatformType;
-    };
-    port?: number;
-    name?: string;
-    [key: string]: any;
+interface InferenceConfig {
+    type: 'anthropic' | 'ollama';
+    model: string;
+    maxTokens?: number;
+    apiKey?: string;
+    endpoint?: string;
+    baseURL?: string;
 }
-interface AWSConfig {
-    region: string;
-    accountId: string;
-    certificateArn?: string;
-    hostedZoneId?: string;
-    rootDomain?: string;
-    stacks?: {
-        data?: string;
-        app?: string;
-    };
-    database?: {
-        name?: string;
-        instanceClass?: string;
-        allocatedStorage?: number;
-        backupRetentionDays?: number;
-        multiAZ?: boolean;
-    };
-    ecs?: {
-        desiredCount?: number;
-        minCapacity?: number;
-        maxCapacity?: number;
-    };
-    monitoring?: {
-        enableDetailedMonitoring?: boolean;
-        logRetentionDays?: number;
-    };
+interface ActorInferenceConfig {
+    gatherer?: InferenceConfig;
+    matcher?: InferenceConfig;
 }
-/**
- * Deep merge utility for configuration objects
- * Pure function - no side effects
- */
-declare function deepMerge(target: any, ...sources: any[]): any;
-/**
- * Recursively resolve environment variable placeholders in configuration
- * Replaces ${VAR_NAME} with the value from the provided env object
- * Pure function - accepts env as parameter instead of using process.env
- *
- * @param obj - Configuration object to process
- * @param env - Environment variables object
- * @returns Configuration with resolved environment variables
- */
-declare function resolveEnvVars(obj: any, env: Record<string, string | undefined>): any;
-/**
- * Parse and merge configuration files
- * Pure function - accepts file contents as strings instead of reading from filesystem
- *
- * @param baseContent - Contents of semiont.json (null if file doesn't exist)
- * @param envContent - Contents of environment-specific JSON file
- * @param env - Environment variables object
- * @param environment - Environment name
- * @param projectRoot - Project root path (for metadata only)
- * @returns Merged and validated environment configuration
- * @throws ConfigurationError if parsing or validation fails
- */
-declare function parseAndMergeConfigs(baseContent: string | null, envContent: string, env: Record<string, string | undefined>, environment: string, projectRoot: string): EnvironmentConfig;
-/**
- * Get NODE_ENV value from environment config
- *
- * @param config - Environment configuration
- * @returns NODE_ENV value (defaults to 'development' if not specified)
- */
-declare function getNodeEnvForEnvironment(config: EnvironmentConfig): 'development' | 'production' | 'test';
-/**
- * List environment names from filenames
- * Pure function - accepts array of filenames instead of reading from filesystem
- *
- * @param files - Array of filenames from environments directory
- * @returns Sorted array of environment names
- */
-declare function listEnvironmentNames(files: string[]): string[];
-/**
- * Type guard to check if config has AWS settings
- *
- * @param config - Environment configuration
- * @returns True if AWS configuration is present
- */
-declare function hasAWSConfig(config: EnvironmentConfig): config is EnvironmentConfig & {
-    aws: AWSConfig;
+interface WorkerInferenceConfig {
+    default?: InferenceConfig;
+    'reference-annotation'?: InferenceConfig;
+    'highlight-annotation'?: InferenceConfig;
+    'assessment-annotation'?: InferenceConfig;
+    'comment-annotation'?: InferenceConfig;
+    'tag-annotation'?: InferenceConfig;
+    'generation'?: InferenceConfig;
+}
+type TomlFileReader = {
+    readIfExists: (path: string) => string | null;
 };
 /**
- * Display configuration for debugging
+ * Parse ~/.semiontconfig and .semiont/config and return EnvironmentConfig.
  *
- * @param config - Configuration to display
+ * @param projectRoot - Path to the project root (contains .semiont/config)
+ * @param environment - Environment name (e.g. 'local', 'production')
+ * @param globalConfigPath - Path to ~/.semiontconfig (caller resolves ~ expansion)
+ * @param reader - File reader abstraction
+ * @param env - Environment variables for ${VAR} resolution
  */
-declare function displayConfiguration(config: EnvironmentConfig): void;
+declare function loadTomlConfig(projectRoot: string, environment: string, globalConfigPath: string, reader: TomlFileReader, env: Record<string, string | undefined>): EnvironmentConfig;
 /**
- * File reader abstraction for platform-agnostic config loading
- * Implementations provide platform-specific file I/O (Node.js, Deno, Bun, etc.)
- */
-type ConfigFileReader = {
-    /** Read file if it exists, return null otherwise */
-    readIfExists: (path: string) => string | null;
-    /** Read file, throw error if it doesn't exist */
-    readRequired: (path: string) => string;
-};
-/**
- * Create a config loader with a specific file reader implementation
- * Higher-order function that returns a platform-specific config loader
- *
- * @param reader - Platform-specific file reader implementation
- * @returns Function to load environment config from filesystem
- *
- * @example
- * ```typescript
- * import * as fs from 'fs';
- * import { createConfigLoader } from '@semiont/core';
- *
- * const nodeReader = {
- *   readIfExists: (path) => fs.existsSync(path) ? fs.readFileSync(path, 'utf-8') : null,
- *   readRequired: (path) => {
- *     if (!fs.existsSync(path)) throw new Error(`File not found: ${path}`);
- *     return fs.readFileSync(path, 'utf-8');
- *   },
- * };
- *
- * const loadConfig = createConfigLoader(nodeReader);
- * const config = loadConfig('/project/root', 'production');
- * ```
+ * Create a TOML config loader backed by a file reader.
+ * Drop-in replacement for createConfigLoader that reads TOML instead of JSON.
+ * The caller must resolve globalConfigPath (e.g. expand '~' using process.env.HOME).
  */
-declare function createConfigLoader(reader: ConfigFileReader): (projectRoot: string, environment: string) => EnvironmentConfig;
+declare function createTomlConfigLoader(reader: TomlFileReader, globalConfigPath: string, env: Record<string, string | undefined>): (projectRoot: string, environment: string) => EnvironmentConfig;
 
 /**
  * Environment validation utilities
@@ -5779,35 +5068,6 @@ declare function parseEnvironment(value: string | undefined, availableEnvironmen
  */
 declare function validateEnvironment(value: string | undefined, availableEnvironments: string[]): Environment;
 
-/**
- * Config Schema Validator
- *
- * Validates configuration data against JSON Schema using Ajv (JSON Schema validator).
- * Provides runtime validation for semiont.json and environment config files.
- */
-
-interface ValidationResult {
-    valid: boolean;
-    errors: ErrorObject[] | null;
-    errorMessage?: string;
-}
-/**
- * Validate semiont.json config
- */
-declare function validateSemiontConfig(data: unknown): ValidationResult;
-/**
- * Validate environment config (environments/*.json)
- */
-declare function validateEnvironmentConfig(data: unknown): ValidationResult;
-/**
- * Validate site config
- */
-declare function validateSiteConfig(data: unknown): ValidationResult;
-/**
- * Format validation errors into human-readable message
- */
-declare function formatErrors(errors: ErrorObject[]): string;
-
 /**
  * Configuration Error Class
  *
@@ -5825,6 +5085,32 @@ declare class ConfigurationError extends Error {
     toString(): string;
 }
 
+/**
+ * Platform Types Module
+ *
+ * Re-exports PlatformType from schema-generated types.
+ * Platforms represent WHERE services run (infrastructure targets).
+ */
+
+/**
+ * Platform type literals from JSON Schema
+ * These represent the infrastructure targets where services can be deployed
+ */
+type PlatformType = PlatformType$1;
+/**
+ * Type guard to check if a string is a valid platform type
+ *
+ * @param value - Value to check
+ * @returns True if value is a valid PlatformType
+ */
+declare function isValidPlatformType(value: string): value is PlatformType;
+/**
+ * Get all valid platform types
+ *
+ * @returns Array of all platform types
+ */
+declare function getAllPlatformTypes(): PlatformType[];
+
 /**
  * @semiont/core
  *
@@ -5835,4 +5121,4 @@ declare class ConfigurationError extends Error {
 declare const CORE_TYPES_VERSION = "0.1.0";
 declare const SDK_VERSION = "0.1.0";
 
-export { APIError, type AWSConfig, type AccessToken, type AnnotationAddedEvent, type AnnotationBodyUpdatedEvent, type AnnotationCategory, type AnnotationId, type AnnotationRemovedEvent, type AnnotationUri, type AppConfig, type AssembledAnnotation, type AuthCode, type BackendServiceConfig, type BaseEvent, type BaseUrl, type BodyItem, type BodyOperation, type BurstBufferOptions, CORE_TYPES_VERSION, CREATION_METHODS, type CloneToken, type ConfigFileReader, ConfigurationError, ConflictError, type ContentFormat$1 as ContentFormat, type CreateAnnotationInternal, type CreationMethod, type DatabaseServiceConfig, type Email, type EntityTagAddedEvent, type EntityTagRemovedEvent, type EntityType, type EntityTypeStats, type Environment, type EnvironmentConfig, EventBus, type EventMap, type EventMetadata, type EventName, type EventQuery, type EventSignature, type FilesystemServiceConfig, type FrontendServiceConfig, type GatheredContext, type GoogleAuthRequest, type GoogleCredential, type GraphConnection, type GraphDatabaseType, type GraphPath, type GraphServiceConfig, type InferenceServiceConfig, type JobCompletedEvent, type JobFailedEvent, type JobId, type JobProgressEvent, type JobStartedEvent, type Logger, type MCPToken, type MarkProgress, type McpServiceConfig, type Motivation$2 as Motivation, NotFoundError, type PlatformType, type ProxyServiceConfig, type RefreshToken, type RepresentationAddedEvent, type RepresentationRemovedEvent, type ResourceAnnotationUri, type ResourceAnnotations, type ResourceArchivedEvent, type ResourceClonedEvent, type ResourceCreatedEvent, type ResourceEvent, type ResourceEventType, type ResourceFilter, type ResourceId, type ResourceScopedEvent, type ResourceUnarchivedEvent, type ResourceUri, SDK_VERSION, ScopedEventBus, ScriptError, type SearchQuery, type SelectionData, type Selector, type SemiontConfig, SemiontError, type ServiceConfig, type ServicePlatformConfig, type ServicesConfig, type SiteConfig, type StoredEvent, type SystemEvent, UnauthorizedError, type UpdateResourceInput, type UserDID, type UserId, ValidationError, type ValidationResult, type YieldProgress, accessToken, annotationId, annotationUri, applyBodyOperations, assembleAnnotation, authCode, baseUrl, burstBuffer, cloneToken, type components, createConfigLoader, deepMerge, didToAgent, displayConfiguration, email, entityType, findBodyItem, formatErrors, generateUuid, getAllPlatformTypes, getAnnotationUriFromEvent, getEventType, getFragmentSelector, getNodeEnvForEnvironment, getSvgSelector, getTextPositionSelector, googleCredential, hasAWSConfig, isAnnotationId, isArray, isBoolean, isDefined, isEventRelatedToAnnotation, isFunction, isNull, isNullish, isNumber, isObject, isResourceEvent$1 as isResourceEvent, isResourceId, isResourceScopedEvent, isResourceEvent as isStoredEvent, isString, isSystemEvent, isUndefined, isValidPlatformType, jobId, listEnvironmentNames, mcpToken, type operations, parseAndMergeConfigs, parseEnvironment, type paths, refreshToken, resolveEnvVars, resourceAnnotationUri, resourceId, resourceUri, searchQuery, userDID, userId, userToAgent, userToDid, validateEnvironment, validateEnvironmentConfig, validateSemiontConfig, validateSiteConfig, validateSvgMarkup };
+export { APIError, type AccessToken, type AnnotationAddedEvent, type AnnotationBodyUpdatedEvent, type AnnotationCategory, type AnnotationId, type AnnotationRemovedEvent, type AnnotationUri, type AssembledAnnotation, type AuthCode, type BaseEvent, type BaseUrl, type BodyItem, type BodyOperation, type BurstBufferOptions, CORE_TYPES_VERSION, CREATION_METHODS, type CloneToken, ConfigurationError, ConflictError, type ContentFormat$1 as ContentFormat, type CreateAnnotationInternal, type CreationMethod, type Email, type EntityTagAddedEvent, type EntityTagRemovedEvent, type EntityType, type EntityTypeStats, type Environment, EnvironmentConfig, EventBus, type EventMap, type EventMetadata, type EventName, type EventQuery, type EventSignature, type GatheredContext, type GoogleAuthRequest, type GoogleCredential, type GraphConnection, type GraphPath, type JobCompletedEvent, type JobFailedEvent, type JobId, type JobProgressEvent, type JobStartedEvent, type Logger, type MCPToken, type MarkProgress, type Motivation$2 as Motivation, NotFoundError, type PlatformType, type RefreshToken, type RepresentationAddedEvent, type RepresentationRemovedEvent, type ResourceAnnotationUri, type ResourceAnnotations, type ResourceArchivedEvent, type ResourceClonedEvent, type ResourceCreatedEvent, type ResourceEvent, type ResourceEventType, type ResourceFilter, type ResourceId, type ResourceScopedEvent, type ResourceUnarchivedEvent, type ResourceUri, SDK_VERSION, ScopedEventBus, ScriptError, type SearchQuery, type SelectionData, type Selector, SemiontError, type StoredEvent, type SystemEvent, type ActorInferenceConfig as TomlActorInferenceConfig, type TomlFileReader, type InferenceConfig as TomlInferenceConfig, type WorkerInferenceConfig as TomlWorkerInferenceConfig, UnauthorizedError, type UpdateResourceInput, type UserDID, type UserId, ValidationError, type YieldProgress, accessToken, annotationId, annotationUri, applyBodyOperations, assembleAnnotation, authCode, baseUrl, burstBuffer, cloneToken, type components, createTomlConfigLoader, didToAgent, email, entityType, findBodyItem, generateUuid, getAllPlatformTypes, getAnnotationUriFromEvent, getEventType, getFragmentSelector, getSvgSelector, getTextPositionSelector, googleCredential, isAnnotationId, isArray, isBoolean, isDefined, isEventRelatedToAnnotation, isFunction, isNull, isNullish, isNumber, isObject, isResourceEvent$1 as isResourceEvent, isResourceId, isResourceScopedEvent, isResourceEvent as isStoredEvent, isString, isSystemEvent, isUndefined, isValidPlatformType, jobId, loadTomlConfig, mcpToken, type operations, parseEnvironment, type paths, refreshToken, resourceAnnotationUri, resourceId, resourceUri, searchQuery, userDID, userId, userToAgent, userToDid, validateEnvironment, validateSvgMarkup };