@substrate-ai/core 0.19.54

package/dist/config/types.d.ts

@@ -0,0 +1,456 @@
+/**
+ * Zod validation schemas and TypeScript interfaces for the Substrate configuration system.
+ *
+ * Extracted from src/modules/config/config-schema.ts and src/modules/config/config-system.ts
+ * for use in @substrate-ai/core.
+ *
+ * NOTE: TokenCeilings / token_ceilings is intentionally excluded from SubstrateConfig here.
+ * That field is SDLC-specific. The SDLC package will extend this type with
+ * `SdlcConfig extends SubstrateConfig` (with token_ceilings added) in a future story.
+ */
+import { z } from 'zod';
+import type { ILogger } from '../dispatch/types.js';
+/** Subscription routing modes */
+export declare const SubscriptionRoutingSchema: z.ZodEnum<{
+    auto: "auto";
+    subscription: "subscription";
+    api: "api";
+    disabled: "disabled";
+}>;
+export type SubscriptionRouting = z.infer<typeof SubscriptionRoutingSchema>;
+/** Rate limit configuration for a provider */
+export declare const RateLimitSchema: z.ZodObject<{
+    tokens: z.ZodNumber;
+    window_seconds: z.ZodNumber;
+}, z.core.$strict>;
+export type RateLimitConfig = z.infer<typeof RateLimitSchema>;
+/** Per-provider configuration */
+export declare const ProviderConfigSchema: z.ZodObject<{
+    enabled: z.ZodBoolean;
+    cli_path: z.ZodOptional<z.ZodString>;
+    subscription_routing: z.ZodEnum<{
+        auto: "auto";
+        subscription: "subscription";
+        api: "api";
+        disabled: "disabled";
+    }>;
+    max_concurrent: z.ZodNumber;
+    rate_limit: z.ZodOptional<z.ZodObject<{
+        tokens: z.ZodNumber;
+        window_seconds: z.ZodNumber;
+    }, z.core.$strict>>;
+    api_key_env: z.ZodOptional<z.ZodString>;
+    api_billing: z.ZodBoolean;
+}, z.core.$strict>;
+export type ProviderConfig = z.infer<typeof ProviderConfigSchema>;
+/** Map of all known providers */
+export declare const ProvidersSchema: z.ZodObject<{
+    claude: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodBoolean;
+        cli_path: z.ZodOptional<z.ZodString>;
+        subscription_routing: z.ZodEnum<{
+            auto: "auto";
+            subscription: "subscription";
+            api: "api";
+            disabled: "disabled";
+        }>;
+        max_concurrent: z.ZodNumber;
+        rate_limit: z.ZodOptional<z.ZodObject<{
+            tokens: z.ZodNumber;
+            window_seconds: z.ZodNumber;
+        }, z.core.$strict>>;
+        api_key_env: z.ZodOptional<z.ZodString>;
+        api_billing: z.ZodBoolean;
+    }, z.core.$strict>>;
+    codex: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodBoolean;
+        cli_path: z.ZodOptional<z.ZodString>;
+        subscription_routing: z.ZodEnum<{
+            auto: "auto";
+            subscription: "subscription";
+            api: "api";
+            disabled: "disabled";
+        }>;
+        max_concurrent: z.ZodNumber;
+        rate_limit: z.ZodOptional<z.ZodObject<{
+            tokens: z.ZodNumber;
+            window_seconds: z.ZodNumber;
+        }, z.core.$strict>>;
+        api_key_env: z.ZodOptional<z.ZodString>;
+        api_billing: z.ZodBoolean;
+    }, z.core.$strict>>;
+    gemini: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodBoolean;
+        cli_path: z.ZodOptional<z.ZodString>;
+        subscription_routing: z.ZodEnum<{
+            auto: "auto";
+            subscription: "subscription";
+            api: "api";
+            disabled: "disabled";
+        }>;
+        max_concurrent: z.ZodNumber;
+        rate_limit: z.ZodOptional<z.ZodObject<{
+            tokens: z.ZodNumber;
+            window_seconds: z.ZodNumber;
+        }, z.core.$strict>>;
+        api_key_env: z.ZodOptional<z.ZodString>;
+        api_billing: z.ZodBoolean;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type ProvidersConfig = z.infer<typeof ProvidersSchema>;
+export declare const LogLevelSchema: z.ZodEnum<{
+    error: "error";
+    trace: "trace";
+    debug: "debug";
+    info: "info";
+    warn: "warn";
+    fatal: "fatal";
+}>;
+export type LogLevelValue = z.infer<typeof LogLevelSchema>;
+export declare const GlobalSettingsSchema: z.ZodObject<{
+    log_level: z.ZodEnum<{
+        error: "error";
+        trace: "trace";
+        debug: "debug";
+        info: "info";
+        warn: "warn";
+        fatal: "fatal";
+    }>;
+    max_concurrent_tasks: z.ZodNumber;
+    budget_cap_tokens: z.ZodNumber;
+    budget_cap_usd: z.ZodNumber;
+    workspace_dir: z.ZodOptional<z.ZodString>;
+    update_check: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export type GlobalSettings = z.infer<typeof GlobalSettingsSchema>;
+export declare const CostTrackerConfigSchema: z.ZodObject<{
+    enabled: z.ZodBoolean;
+    token_rates_provider: z.ZodEnum<{
+        builtin: "builtin";
+        custom: "custom";
+    }>;
+    track_planning_costs: z.ZodBoolean;
+    savings_reporting: z.ZodBoolean;
+}, z.core.$strict>;
+export type CostTrackerConfig = z.infer<typeof CostTrackerConfigSchema>;
+export declare const BudgetConfigSchema: z.ZodObject<{
+    default_task_budget_usd: z.ZodNumber;
+    default_session_budget_usd: z.ZodNumber;
+    planning_costs_count_against_budget: z.ZodBoolean;
+    warning_threshold_percent: z.ZodNumber;
+}, z.core.$strict>;
+export type BudgetConfig = z.infer<typeof BudgetConfigSchema>;
+export declare const TelemetryConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    port: z.ZodDefault<z.ZodNumber>;
+    meshUrl: z.ZodOptional<z.ZodString>;
+    projectId: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type TelemetryConfig = z.infer<typeof TelemetryConfigSchema>;
+/** Current supported config format version */
+export declare const CURRENT_CONFIG_FORMAT_VERSION = "1";
+/** Current supported task graph version */
+export declare const CURRENT_TASK_GRAPH_VERSION = "1";
+/** All config format versions this toolkit can read and validate */
+export declare const SUPPORTED_CONFIG_FORMAT_VERSIONS: readonly string[];
+/** All task graph format versions this toolkit can read and validate */
+export declare const SUPPORTED_TASK_GRAPH_VERSIONS: readonly string[];
+export declare const SubstrateConfigSchema: z.ZodObject<{
+    config_format_version: z.ZodEnum<{
+        1: "1";
+    }>;
+    task_graph_version: z.ZodOptional<z.ZodEnum<{
+        1: "1";
+    }>>;
+    global: z.ZodObject<{
+        log_level: z.ZodEnum<{
+            error: "error";
+            trace: "trace";
+            debug: "debug";
+            info: "info";
+            warn: "warn";
+            fatal: "fatal";
+        }>;
+        max_concurrent_tasks: z.ZodNumber;
+        budget_cap_tokens: z.ZodNumber;
+        budget_cap_usd: z.ZodNumber;
+        workspace_dir: z.ZodOptional<z.ZodString>;
+        update_check: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>;
+    providers: z.ZodObject<{
+        claude: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodBoolean;
+            cli_path: z.ZodOptional<z.ZodString>;
+            subscription_routing: z.ZodEnum<{
+                auto: "auto";
+                subscription: "subscription";
+                api: "api";
+                disabled: "disabled";
+            }>;
+            max_concurrent: z.ZodNumber;
+            rate_limit: z.ZodOptional<z.ZodObject<{
+                tokens: z.ZodNumber;
+                window_seconds: z.ZodNumber;
+            }, z.core.$strict>>;
+            api_key_env: z.ZodOptional<z.ZodString>;
+            api_billing: z.ZodBoolean;
+        }, z.core.$strict>>;
+        codex: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodBoolean;
+            cli_path: z.ZodOptional<z.ZodString>;
+            subscription_routing: z.ZodEnum<{
+                auto: "auto";
+                subscription: "subscription";
+                api: "api";
+                disabled: "disabled";
+            }>;
+            max_concurrent: z.ZodNumber;
+            rate_limit: z.ZodOptional<z.ZodObject<{
+                tokens: z.ZodNumber;
+                window_seconds: z.ZodNumber;
+            }, z.core.$strict>>;
+            api_key_env: z.ZodOptional<z.ZodString>;
+            api_billing: z.ZodBoolean;
+        }, z.core.$strict>>;
+        gemini: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodBoolean;
+            cli_path: z.ZodOptional<z.ZodString>;
+            subscription_routing: z.ZodEnum<{
+                auto: "auto";
+                subscription: "subscription";
+                api: "api";
+                disabled: "disabled";
+            }>;
+            max_concurrent: z.ZodNumber;
+            rate_limit: z.ZodOptional<z.ZodObject<{
+                tokens: z.ZodNumber;
+                window_seconds: z.ZodNumber;
+            }, z.core.$strict>>;
+            api_key_env: z.ZodOptional<z.ZodString>;
+            api_billing: z.ZodBoolean;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    cost_tracker: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodBoolean;
+        token_rates_provider: z.ZodEnum<{
+            builtin: "builtin";
+            custom: "custom";
+        }>;
+        track_planning_costs: z.ZodBoolean;
+        savings_reporting: z.ZodBoolean;
+    }, z.core.$strict>>;
+    budget: z.ZodOptional<z.ZodObject<{
+        default_task_budget_usd: z.ZodNumber;
+        default_session_budget_usd: z.ZodNumber;
+        planning_costs_count_against_budget: z.ZodBoolean;
+        warning_threshold_percent: z.ZodNumber;
+    }, z.core.$strict>>;
+    telemetry: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        port: z.ZodDefault<z.ZodNumber>;
+        meshUrl: z.ZodOptional<z.ZodString>;
+        projectId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    trivialOutputThreshold: z.ZodOptional<z.ZodNumber>;
+}, z.core.$loose>;
+export type SubstrateConfig = z.infer<typeof SubstrateConfigSchema>;
+export declare const PartialProviderConfigSchema: z.ZodObject<{
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    cli_path: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    subscription_routing: z.ZodOptional<z.ZodEnum<{
+        auto: "auto";
+        subscription: "subscription";
+        api: "api";
+        disabled: "disabled";
+    }>>;
+    max_concurrent: z.ZodOptional<z.ZodNumber>;
+    rate_limit: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+        tokens: z.ZodNumber;
+        window_seconds: z.ZodNumber;
+    }, z.core.$strict>>>;
+    api_key_env: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    api_billing: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export type PartialProviderConfig = z.infer<typeof PartialProviderConfigSchema>;
+export declare const PartialGlobalSettingsSchema: z.ZodObject<{
+    log_level: z.ZodOptional<z.ZodEnum<{
+        error: "error";
+        trace: "trace";
+        debug: "debug";
+        info: "info";
+        warn: "warn";
+        fatal: "fatal";
+    }>>;
+    max_concurrent_tasks: z.ZodOptional<z.ZodNumber>;
+    budget_cap_tokens: z.ZodOptional<z.ZodNumber>;
+    budget_cap_usd: z.ZodOptional<z.ZodNumber>;
+    workspace_dir: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    update_check: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+}, z.core.$strict>;
+export type PartialGlobalSettings = z.infer<typeof PartialGlobalSettingsSchema>;
+export declare const PartialSubstrateConfigSchema: z.ZodObject<{
+    config_format_version: z.ZodOptional<z.ZodEnum<{
+        1: "1";
+    }>>;
+    task_graph_version: z.ZodOptional<z.ZodEnum<{
+        1: "1";
+    }>>;
+    global: z.ZodOptional<z.ZodObject<{
+        log_level: z.ZodOptional<z.ZodEnum<{
+            error: "error";
+            trace: "trace";
+            debug: "debug";
+            info: "info";
+            warn: "warn";
+            fatal: "fatal";
+        }>>;
+        max_concurrent_tasks: z.ZodOptional<z.ZodNumber>;
+        budget_cap_tokens: z.ZodOptional<z.ZodNumber>;
+        budget_cap_usd: z.ZodOptional<z.ZodNumber>;
+        workspace_dir: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        update_check: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+    }, z.core.$strict>>;
+    providers: z.ZodOptional<z.ZodObject<{
+        claude: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+            cli_path: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+            subscription_routing: z.ZodOptional<z.ZodEnum<{
+                auto: "auto";
+                subscription: "subscription";
+                api: "api";
+                disabled: "disabled";
+            }>>;
+            max_concurrent: z.ZodOptional<z.ZodNumber>;
+            rate_limit: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+                tokens: z.ZodNumber;
+                window_seconds: z.ZodNumber;
+            }, z.core.$strict>>>;
+            api_key_env: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+            api_billing: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>>;
+        codex: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+            cli_path: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+            subscription_routing: z.ZodOptional<z.ZodEnum<{
+                auto: "auto";
+                subscription: "subscription";
+                api: "api";
+                disabled: "disabled";
+            }>>;
+            max_concurrent: z.ZodOptional<z.ZodNumber>;
+            rate_limit: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+                tokens: z.ZodNumber;
+                window_seconds: z.ZodNumber;
+            }, z.core.$strict>>>;
+            api_key_env: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+            api_billing: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>>;
+        gemini: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+            cli_path: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+            subscription_routing: z.ZodOptional<z.ZodEnum<{
+                auto: "auto";
+                subscription: "subscription";
+                api: "api";
+                disabled: "disabled";
+            }>>;
+            max_concurrent: z.ZodOptional<z.ZodNumber>;
+            rate_limit: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+                tokens: z.ZodNumber;
+                window_seconds: z.ZodNumber;
+            }, z.core.$strict>>>;
+            api_key_env: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+            api_billing: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>>;
+    }, z.core.$strip>>;
+    cost_tracker: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        token_rates_provider: z.ZodOptional<z.ZodEnum<{
+            builtin: "builtin";
+            custom: "custom";
+        }>>;
+        track_planning_costs: z.ZodOptional<z.ZodBoolean>;
+        savings_reporting: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>;
+    budget: z.ZodOptional<z.ZodObject<{
+        default_task_budget_usd: z.ZodOptional<z.ZodNumber>;
+        default_session_budget_usd: z.ZodOptional<z.ZodNumber>;
+        planning_costs_count_against_budget: z.ZodOptional<z.ZodBoolean>;
+        warning_threshold_percent: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    telemetry: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+        port: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+        meshUrl: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        projectId: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    }, z.core.$strict>>;
+    trivialOutputThreshold: z.ZodOptional<z.ZodNumber>;
+}, z.core.$loose>;
+export type PartialSubstrateConfig = z.infer<typeof PartialSubstrateConfigSchema>;
+/**
+ * Options for initializing the config system.
+ */
+export interface ConfigSystemOptions {
+    /** Path to the project-level .substrate/ directory (default: <cwd>/.substrate) */
+    projectConfigDir?: string;
+    /** Path to the global user-level .substrate/ directory (default: ~/.substrate) */
+    globalConfigDir?: string;
+    /**
+     * Additional values that override everything except env vars.
+     * Typically populated from CLI flags.
+     */
+    cliOverrides?: PartialSubstrateConfig;
+    /**
+     * Logger instance for config system messages.
+     * Defaults to console if not provided.
+     */
+    logger?: ILogger;
+}
+/**
+ * Provides access to fully-merged, validated Substrate configuration.
+ *
+ * Hierarchy (lowest → highest priority):
+ *   built-in defaults < global config < project config < env vars < CLI flags
+ */
+export interface ConfigSystem {
+    /**
+     * Load and validate configuration from all sources in hierarchy order.
+     * Must be called before `getConfig()`.
+     */
+    load(): Promise<void>;
+    /**
+     * Return the fully-merged, validated configuration.
+     * @throws {ConfigError} if `load()` has not been called or config is invalid.
+     */
+    getConfig(): SubstrateConfig;
+    /**
+     * Return a single value by dot-notation key (e.g. "global.log_level").
+     * @returns the value, or undefined if the key does not exist.
+     */
+    get(key: string): unknown;
+    /**
+     * Persist a single value to the project config file using dot-notation key.
+     * @throws {ConfigError} if key is invalid or the update fails.
+     */
+    set(key: string, value: unknown): Promise<void>;
+    /**
+     * Return the merged config with all credential values masked.
+     * Safe to display in CLI output or logs.
+     */
+    getMasked(): SubstrateConfig;
+    /**
+     * Whether load() has been called and succeeded.
+     */
+    readonly isLoaded: boolean;
+    /**
+     * Return the current config format version string.
+     */
+    getConfigFormatVersion(): string;
+    /**
+     * Check whether the given config format version is compatible with this toolkit.
+     * @param version - Version string to check
+     * @returns true if the version is in SUPPORTED_CONFIG_FORMAT_VERSIONS
+     */
+    isCompatible(version: string): boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/config/types.d.ts.map

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

package/dist/config/types.js

@@ -0,0 +1,174 @@
+/**
+ * Zod validation schemas and TypeScript interfaces for the Substrate configuration system.
+ *
+ * Extracted from src/modules/config/config-schema.ts and src/modules/config/config-system.ts
+ * for use in @substrate-ai/core.
+ *
+ * NOTE: TokenCeilings / token_ceilings is intentionally excluded from SubstrateConfig here.
+ * That field is SDLC-specific. The SDLC package will extend this type with
+ * `SdlcConfig extends SubstrateConfig` (with token_ceilings added) in a future story.
+ */
+import { z } from 'zod';
+// ---------------------------------------------------------------------------
+// Provider-level schema
+// ---------------------------------------------------------------------------
+/** Subscription routing modes */
+export const SubscriptionRoutingSchema = z.enum(['auto', 'subscription', 'api', 'disabled']);
+/** Rate limit configuration for a provider */
+export const RateLimitSchema = z
+    .object({
+    tokens: z.number().int().positive(),
+    window_seconds: z.number().int().positive(),
+})
+    .strict();
+/** Per-provider configuration */
+export const ProviderConfigSchema = z
+    .object({
+    enabled: z.boolean(),
+    /** Path to the CLI binary — resolved at runtime; never used for api keys */
+    cli_path: z.string().optional(),
+    subscription_routing: SubscriptionRoutingSchema,
+    max_concurrent: z.number().int().min(1).max(32),
+    rate_limit: RateLimitSchema.optional(),
+    /** Name of the environment variable that holds the API key */
+    api_key_env: z.string().optional(),
+    /** Whether API billing is enabled for this provider */
+    api_billing: z.boolean(),
+})
+    .strict();
+/** Map of all known providers */
+export const ProvidersSchema = z
+    .object({
+    claude: ProviderConfigSchema.optional(),
+    codex: ProviderConfigSchema.optional(),
+    gemini: ProviderConfigSchema.optional(),
+})
+    .strict();
+// ---------------------------------------------------------------------------
+// Global / project settings
+// ---------------------------------------------------------------------------
+export const LogLevelSchema = z.enum(['trace', 'debug', 'info', 'warn', 'error', 'fatal']);
+export const GlobalSettingsSchema = z
+    .object({
+    log_level: LogLevelSchema,
+    max_concurrent_tasks: z.number().int().min(1).max(64),
+    /** Max total tokens per orchestration session (0 = unlimited) */
+    budget_cap_tokens: z.number().int().min(0),
+    /** Max approximate USD cost per session (0 = unlimited) */
+    budget_cap_usd: z.number().min(0),
+    /** Working directory for temporary files */
+    workspace_dir: z.string().optional(),
+    /** Whether to perform automatic background update checks (default: true) */
+    update_check: z.boolean().optional(),
+})
+    .strict();
+// ---------------------------------------------------------------------------
+// Cost tracker config schema
+// ---------------------------------------------------------------------------
+export const CostTrackerConfigSchema = z
+    .object({
+    /** Enable cost tracking (default: true) */
+    enabled: z.boolean(),
+    /** Source for token rates: 'builtin' uses built-in table, 'custom' uses injected custom rates */
+    token_rates_provider: z.enum(['builtin', 'custom']),
+    /** Whether to track planning/orchestration costs in addition to task costs */
+    track_planning_costs: z.boolean(),
+    /** Whether to include savings summary in cost reports (FR28) */
+    savings_reporting: z.boolean(),
+})
+    .strict();
+// ---------------------------------------------------------------------------
+// Budget enforcer config schema
+// ---------------------------------------------------------------------------
+export const BudgetConfigSchema = z
+    .object({
+    /** Default per-task budget cap in USD if task has no explicit cap (0 = unlimited) */
+    default_task_budget_usd: z.number().min(0),
+    /** Default session budget cap in USD (0 = unlimited) */
+    default_session_budget_usd: z.number().min(0),
+    /** When true, planning/orchestration costs count toward session budget */
+    planning_costs_count_against_budget: z.boolean(),
+    /** Percentage threshold at which budget:warning is emitted (0-100) */
+    warning_threshold_percent: z.number().min(0).max(100),
+})
+    .strict();
+// ---------------------------------------------------------------------------
+// Telemetry config schema
+// ---------------------------------------------------------------------------
+export const TelemetryConfigSchema = z
+    .object({
+    /** Whether OTLP telemetry ingestion is enabled */
+    enabled: z.boolean().default(false),
+    /** Port for the local OTLP HTTP ingestion server (1–65535) */
+    port: z.number().int().min(1).max(65535).default(4318),
+    /** Agent-mesh telemetry server URL (e.g., http://localhost:4100). When set, run reports are pushed after pipeline completion. */
+    meshUrl: z.string().url().optional(),
+    /** Project identifier sent with run reports (e.g., "nextgen-ticketing"). Defaults to the directory name. */
+    projectId: z.string().optional(),
+})
+    .strict();
+// ---------------------------------------------------------------------------
+// Top-level configuration document
+// (token_ceilings intentionally excluded — SDLC-specific, see file header)
+// ---------------------------------------------------------------------------
+// ---------------------------------------------------------------------------
+// Config format version constants
+// ---------------------------------------------------------------------------
+/** Current supported config format version */
+export const CURRENT_CONFIG_FORMAT_VERSION = '1';
+/** Current supported task graph version */
+export const CURRENT_TASK_GRAPH_VERSION = '1';
+/** All config format versions this toolkit can read and validate */
+export const SUPPORTED_CONFIG_FORMAT_VERSIONS = ['1'];
+/** All task graph format versions this toolkit can read and validate */
+export const SUPPORTED_TASK_GRAPH_VERSIONS = ['1'];
+// ---------------------------------------------------------------------------
+// Top-level configuration document
+// (token_ceilings intentionally excluded — SDLC-specific, see file header)
+// .passthrough() allows SDLC/factory packages to extend the config shape
+// (e.g. with token_ceilings) without core validation stripping unknown keys.
+// ---------------------------------------------------------------------------
+export const SubstrateConfigSchema = z
+    .object({
+    /** Schema version for migration support */
+    config_format_version: z.enum(['1']),
+    /** Task graph version for migration support */
+    task_graph_version: z.enum(['1']).optional(),
+    global: GlobalSettingsSchema,
+    providers: ProvidersSchema,
+    /** Cost tracker settings */
+    cost_tracker: CostTrackerConfigSchema.optional(),
+    /** Budget enforcement settings */
+    budget: BudgetConfigSchema.optional(),
+    /** OTLP telemetry ingestion settings */
+    telemetry: TelemetryConfigSchema.optional(),
+    /** Minimum output token count for TrivialOutputCheck (Story 51-3). Default: 100. */
+    trivialOutputThreshold: z.number().int().nonnegative().optional(),
+})
+    .passthrough();
+// ---------------------------------------------------------------------------
+// Partial / merged config (allows partial during load before merging)
+// ---------------------------------------------------------------------------
+export const PartialProviderConfigSchema = ProviderConfigSchema.partial();
+export const PartialGlobalSettingsSchema = GlobalSettingsSchema.partial();
+export const PartialSubstrateConfigSchema = z
+    .object({
+    config_format_version: z.enum(['1']).optional(),
+    task_graph_version: z.enum(['1']).optional(),
+    global: PartialGlobalSettingsSchema.optional(),
+    providers: z
+        .object({
+        claude: PartialProviderConfigSchema.optional(),
+        codex: PartialProviderConfigSchema.optional(),
+        gemini: PartialProviderConfigSchema.optional(),
+    })
+        .partial()
+        .optional(),
+    cost_tracker: CostTrackerConfigSchema.partial().optional(),
+    budget: BudgetConfigSchema.partial().optional(),
+    telemetry: TelemetryConfigSchema.partial().optional(),
+    /** Minimum output token count for TrivialOutputCheck (Story 51-3). Default: 100. */
+    trivialOutputThreshold: z.number().int().nonnegative().optional(),
+})
+    .passthrough();
+//# sourceMappingURL=types.js.map

package/dist/config/types.js.map

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