@draht/router 2026.7.13 → 2026.9.5-1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1 +1 @@
1
- {"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { homedir, tmpdir } from \"node:os\";\nimport { dirname, join, resolve } from \"node:path\";\nimport { getModels, getProviders, type KnownProvider } from \"@draht/ai/compat\";\nimport { BUILT_IN_ROLES, DEFAULT_CONFIG, type ModelRef, type RoleConfig, type RouterConfig } from \"./types.js\";\n\nexport { BUILT_IN_ROLES };\n\n/**\n * Error thrown when config validation fails.\n * Contains all validation issues found.\n */\nexport class ConfigValidationError extends Error {\n\tconstructor(public readonly errors: string[]) {\n\t\tsuper(`Config validation failed:\\n${errors.map((e) => ` - ${e}`).join(\"\\n\")}`);\n\t\tthis.name = \"ConfigValidationError\";\n\t}\n}\n\nconst PROJECT_CONFIG = \".draht/router.json\";\nconst GLOBAL_CONFIG = join(homedir(), \".draht\", \"router.json\");\n\n/**\n * Validate that a project root path is safe and doesn't contain path traversal.\n * Throws if the path attempts to escape the current working directory or uses absolute paths to sensitive areas.\n */\nfunction validateProjectRoot(projectRoot: string): void {\n\t// Resolve to absolute path to check for traversal\n\tconst resolved = resolve(projectRoot);\n\tconst cwd = resolve(process.cwd());\n\n\t// For relative paths: ensure resolved path is within or equal to cwd\n\tif (!projectRoot.startsWith(\"/\")) {\n\t\tif (!resolved.startsWith(`${cwd}/`) && resolved !== cwd) {\n\t\t\tthrow new Error(`Invalid project root: path traversal detected (${projectRoot})`);\n\t\t}\n\t\treturn;\n\t}\n\n\t// For absolute paths: allow safe locations (user home, temp dirs, current working directory)\n\tconst home = homedir();\n\tconst tmpDir = tmpdir();\n\tconst safePaths = [home, tmpDir, cwd, \"/tmp\", \"/private/tmp\"];\n\tconst isSafe = safePaths.some((safe) => resolved.startsWith(`${safe}/`) || resolved === safe);\n\tif (isSafe) {\n\t\treturn;\n\t}\n\n\t// Reject paths to system directories\n\tconst dangerousPaths = [\"/etc\", \"/usr\", \"/bin\", \"/sbin\", \"/sys\", \"/proc\", \"/dev\", \"/boot\"];\n\tfor (const dangerous of dangerousPaths) {\n\t\tif (resolved.startsWith(dangerous)) {\n\t\t\tthrow new Error(`Invalid project root: access to ${dangerous} is not allowed`);\n\t\t}\n\t}\n\n\t// Reject any other absolute path that's not explicitly safe\n\tthrow new Error(\n\t\t`Invalid project root: absolute path must be within home, temp, or current directory (${projectRoot})`,\n\t);\n}\n\n/**\n * Load router config. Project config overrides global, both fall back to defaults.\n * Validates the merged config and throws ConfigValidationError if invalid.\n */\nexport function loadConfig(projectRoot?: string): RouterConfig {\n\tif (projectRoot) {\n\t\tvalidateProjectRoot(projectRoot);\n\t}\n\n\tconst globalConfig = loadFile(GLOBAL_CONFIG);\n\tconst projectPath = projectRoot ? resolve(projectRoot, PROJECT_CONFIG) : resolve(PROJECT_CONFIG);\n\tconst projectConfig = loadFile(projectPath);\n\n\tconst result = mergeConfig(projectConfig, globalConfig);\n\tvalidateConfig(result);\n\treturn result;\n}\n\n/**\n * Save router config to project or global scope.\n * Validates the config and throws ConfigValidationError if invalid.\n */\nexport function saveConfig(config: RouterConfig, scope: \"project\" | \"global\", projectRoot?: string): void {\n\t// Validate before writing to ensure we don't save invalid configs\n\tvalidateConfig(config);\n\n\tif (scope === \"project\" && projectRoot) {\n\t\tvalidateProjectRoot(projectRoot);\n\t}\n\n\tconst path =\n\t\tscope === \"global\" ? GLOBAL_CONFIG : projectRoot ? resolve(projectRoot, PROJECT_CONFIG) : resolve(PROJECT_CONFIG);\n\n\tmkdirSync(dirname(path), { recursive: true });\n\twriteFileSync(path, JSON.stringify(config, null, \"\\t\"), \"utf-8\");\n}\n\n/**\n * Merge project config over global config over defaults.\n * Project overrides global per-role.\n */\nexport function mergeConfig(project: RouterConfig | null, global: RouterConfig | null): RouterConfig {\n\tconst base = { ...DEFAULT_CONFIG };\n\n\tif (global) {\n\t\tfor (const [role, config] of Object.entries(global)) {\n\t\t\tbase[role] = config;\n\t\t}\n\t}\n\n\tif (project) {\n\t\tfor (const [role, config] of Object.entries(project)) {\n\t\t\tbase[role] = config;\n\t\t}\n\t}\n\n\treturn base;\n}\n\nfunction loadFile(path: string): RouterConfig | null {\n\tif (!existsSync(path)) return null;\n\ttry {\n\t\treturn JSON.parse(readFileSync(path, \"utf-8\")) as RouterConfig;\n\t} catch {\n\t\treturn null;\n\t}\n}\n\n/**\n * Validate a ModelRef has non-empty provider and model.\n */\nfunction validateModelRef(ref: ModelRef, role: string, position: string): string[] {\n\tconst errors: string[] = [];\n\tif (!ref.provider || ref.provider.trim() === \"\") {\n\t\terrors.push(`Empty provider string for role ${role} (${position})`);\n\t}\n\tif (!ref.model || ref.model.trim() === \"\") {\n\t\terrors.push(`Empty model string for role ${role} (${position})`);\n\t}\n\treturn errors;\n}\n\n/**\n * Validate a RoleConfig has valid structure.\n */\nfunction validateRoleConfig(roleConfig: RoleConfig, role: string): string[] {\n\tconst errors: string[] = [];\n\n\t// Validate primary\n\terrors.push(...validateModelRef(roleConfig.primary, role, \"primary\"));\n\n\t// Validate fallbacks\n\tfor (let i = 0; i < roleConfig.fallbacks.length; i++) {\n\t\terrors.push(...validateModelRef(roleConfig.fallbacks[i], role, `fallback[${i}]`));\n\t}\n\n\treturn errors;\n}\n\n/**\n * Validate a ModelRef against the @draht/ai registry.\n * Returns errors if provider or model is not found.\n */\nfunction validateModelRefAgainstRegistry(\n\tref: ModelRef,\n\trole: string,\n\tposition: string,\n\tvalidProviders: Set<string>,\n): string[] {\n\tconst errors: string[] = [];\n\n\t// Skip if empty (already caught by structure validation)\n\tif (!ref.provider || !ref.model) {\n\t\treturn errors;\n\t}\n\n\t// Check provider exists\n\tif (!validProviders.has(ref.provider)) {\n\t\terrors.push(`Invalid provider '${ref.provider}' for role ${role} (not in @draht/ai registry)`);\n\t\treturn errors; // Don't check model if provider is invalid\n\t}\n\n\t// Check model exists for this provider\n\tconst models = getModels(ref.provider as KnownProvider);\n\tconst modelExists = models.some((m) => m.id === ref.model);\n\tif (!modelExists) {\n\t\terrors.push(`Invalid model '${ref.model}' for provider '${ref.provider}' in role ${role} (${position})`);\n\t}\n\n\treturn errors;\n}\n\n/**\n * Validate a RoleConfig against the @draht/ai registry.\n */\nfunction validateRoleConfigAgainstRegistry(\n\troleConfig: RoleConfig,\n\trole: string,\n\tvalidProviders: Set<string>,\n): string[] {\n\tconst errors: string[] = [];\n\n\t// Validate primary\n\terrors.push(...validateModelRefAgainstRegistry(roleConfig.primary, role, \"primary\", validProviders));\n\n\t// Validate fallbacks\n\tfor (let i = 0; i < roleConfig.fallbacks.length; i++) {\n\t\terrors.push(...validateModelRefAgainstRegistry(roleConfig.fallbacks[i], role, `fallback[${i}]`, validProviders));\n\t}\n\n\treturn errors;\n}\n\n/**\n * Format a ModelRef as \"provider/model\" for display.\n */\nfunction formatModelRefForValidation(ref: ModelRef): string {\n\treturn `${ref.provider}/${ref.model}`;\n}\n\n/**\n * Detect duplicate models in a fallback chain (primary + fallbacks).\n */\nfunction detectDuplicateModels(roleConfig: RoleConfig, role: string): string[] {\n\tconst errors: string[] = [];\n\tconst allModels: ModelRef[] = [roleConfig.primary, ...roleConfig.fallbacks];\n\tconst seen = new Set<string>();\n\n\tfor (const ref of allModels) {\n\t\tconst key = formatModelRefForValidation(ref);\n\t\tif (seen.has(key)) {\n\t\t\terrors.push(`Duplicate model ${key} in fallback chain for role ${role}`);\n\t\t}\n\t\tseen.add(key);\n\t}\n\n\treturn errors;\n}\n\n/**\n * Validate a router config.\n * Throws ConfigValidationError if any issues are found.\n */\nexport function validateConfig(config: RouterConfig): void {\n\tconst errors: string[] = [];\n\n\t// Check all built-in roles are present\n\tfor (const role of BUILT_IN_ROLES) {\n\t\tif (!(role in config)) {\n\t\t\terrors.push(`Missing required role: ${role}`);\n\t\t}\n\t}\n\n\t// Validate structure of each role config\n\tfor (const [role, roleConfig] of Object.entries(config)) {\n\t\terrors.push(...validateRoleConfig(roleConfig, role));\n\t}\n\n\t// Cache valid providers for registry validation\n\tconst validProviders = new Set(getProviders());\n\n\t// Validate each role config against registry\n\tfor (const [role, roleConfig] of Object.entries(config)) {\n\t\terrors.push(...validateRoleConfigAgainstRegistry(roleConfig, role, validProviders));\n\t}\n\n\t// Detect duplicate models in fallback chains\n\tfor (const [role, roleConfig] of Object.entries(config)) {\n\t\terrors.push(...detectDuplicateModels(roleConfig, role));\n\t}\n\n\tif (errors.length > 0) {\n\t\tthrow new ConfigValidationError(errors);\n\t}\n}\n"]}
1
+ {"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { homedir, tmpdir } from \"node:os\";\nimport { dirname, join, resolve } from \"node:path\";\nimport { type BuiltinProvider, getModels, getProviders } from \"@draht/ai/compat\";\nimport { BUILT_IN_ROLES, DEFAULT_CONFIG, type ModelRef, type RoleConfig, type RouterConfig } from \"./types.js\";\n\nexport { BUILT_IN_ROLES };\n\n/**\n * Error thrown when config validation fails.\n * Contains all validation issues found.\n */\nexport class ConfigValidationError extends Error {\n\tconstructor(public readonly errors: string[]) {\n\t\tsuper(`Config validation failed:\\n${errors.map((e) => ` - ${e}`).join(\"\\n\")}`);\n\t\tthis.name = \"ConfigValidationError\";\n\t}\n}\n\nconst PROJECT_CONFIG = \".draht/router.json\";\nconst GLOBAL_CONFIG = join(homedir(), \".draht\", \"router.json\");\n\n/**\n * Validate that a project root path is safe and doesn't contain path traversal.\n * Throws if the path attempts to escape the current working directory or uses absolute paths to sensitive areas.\n */\nfunction validateProjectRoot(projectRoot: string): void {\n\t// Resolve to absolute path to check for traversal\n\tconst resolved = resolve(projectRoot);\n\tconst cwd = resolve(process.cwd());\n\n\t// For relative paths: ensure resolved path is within or equal to cwd\n\tif (!projectRoot.startsWith(\"/\")) {\n\t\tif (!resolved.startsWith(`${cwd}/`) && resolved !== cwd) {\n\t\t\tthrow new Error(`Invalid project root: path traversal detected (${projectRoot})`);\n\t\t}\n\t\treturn;\n\t}\n\n\t// For absolute paths: allow safe locations (user home, temp dirs, current working directory)\n\tconst home = homedir();\n\tconst tmpDir = tmpdir();\n\tconst safePaths = [home, tmpDir, cwd, \"/tmp\", \"/private/tmp\"];\n\tconst isSafe = safePaths.some((safe) => resolved.startsWith(`${safe}/`) || resolved === safe);\n\tif (isSafe) {\n\t\treturn;\n\t}\n\n\t// Reject paths to system directories\n\tconst dangerousPaths = [\"/etc\", \"/usr\", \"/bin\", \"/sbin\", \"/sys\", \"/proc\", \"/dev\", \"/boot\"];\n\tfor (const dangerous of dangerousPaths) {\n\t\tif (resolved.startsWith(dangerous)) {\n\t\t\tthrow new Error(`Invalid project root: access to ${dangerous} is not allowed`);\n\t\t}\n\t}\n\n\t// Reject any other absolute path that's not explicitly safe\n\tthrow new Error(\n\t\t`Invalid project root: absolute path must be within home, temp, or current directory (${projectRoot})`,\n\t);\n}\n\n/**\n * Load router config. Project config overrides global, both fall back to defaults.\n * Validates the merged config and throws ConfigValidationError if invalid.\n */\nexport function loadConfig(projectRoot?: string): RouterConfig {\n\tif (projectRoot) {\n\t\tvalidateProjectRoot(projectRoot);\n\t}\n\n\tconst globalConfig = loadFile(GLOBAL_CONFIG);\n\tconst projectPath = projectRoot ? resolve(projectRoot, PROJECT_CONFIG) : resolve(PROJECT_CONFIG);\n\tconst projectConfig = loadFile(projectPath);\n\n\tconst result = mergeConfig(projectConfig, globalConfig);\n\tvalidateConfig(result);\n\treturn result;\n}\n\n/**\n * Save router config to project or global scope.\n * Validates the config and throws ConfigValidationError if invalid.\n */\nexport function saveConfig(config: RouterConfig, scope: \"project\" | \"global\", projectRoot?: string): void {\n\t// Validate before writing to ensure we don't save invalid configs\n\tvalidateConfig(config);\n\n\tif (scope === \"project\" && projectRoot) {\n\t\tvalidateProjectRoot(projectRoot);\n\t}\n\n\tconst path =\n\t\tscope === \"global\" ? GLOBAL_CONFIG : projectRoot ? resolve(projectRoot, PROJECT_CONFIG) : resolve(PROJECT_CONFIG);\n\n\tmkdirSync(dirname(path), { recursive: true });\n\twriteFileSync(path, JSON.stringify(config, null, \"\\t\"), \"utf-8\");\n}\n\n/**\n * Merge project config over global config over defaults.\n * Project overrides global per-role.\n */\nexport function mergeConfig(project: RouterConfig | null, global: RouterConfig | null): RouterConfig {\n\tconst base = { ...DEFAULT_CONFIG };\n\n\tif (global) {\n\t\tfor (const [role, config] of Object.entries(global)) {\n\t\t\tbase[role] = config;\n\t\t}\n\t}\n\n\tif (project) {\n\t\tfor (const [role, config] of Object.entries(project)) {\n\t\t\tbase[role] = config;\n\t\t}\n\t}\n\n\treturn base;\n}\n\nfunction loadFile(path: string): RouterConfig | null {\n\tif (!existsSync(path)) return null;\n\ttry {\n\t\treturn JSON.parse(readFileSync(path, \"utf-8\")) as RouterConfig;\n\t} catch {\n\t\treturn null;\n\t}\n}\n\n/**\n * Validate a ModelRef has non-empty provider and model.\n */\nfunction validateModelRef(ref: ModelRef, role: string, position: string): string[] {\n\tconst errors: string[] = [];\n\tif (!ref.provider || ref.provider.trim() === \"\") {\n\t\terrors.push(`Empty provider string for role ${role} (${position})`);\n\t}\n\tif (!ref.model || ref.model.trim() === \"\") {\n\t\terrors.push(`Empty model string for role ${role} (${position})`);\n\t}\n\treturn errors;\n}\n\n/**\n * Validate a RoleConfig has valid structure.\n */\nfunction validateRoleConfig(roleConfig: RoleConfig, role: string): string[] {\n\tconst errors: string[] = [];\n\n\t// Validate primary\n\terrors.push(...validateModelRef(roleConfig.primary, role, \"primary\"));\n\n\t// Validate fallbacks\n\tfor (let i = 0; i < roleConfig.fallbacks.length; i++) {\n\t\terrors.push(...validateModelRef(roleConfig.fallbacks[i], role, `fallback[${i}]`));\n\t}\n\n\treturn errors;\n}\n\n/**\n * Validate a ModelRef against the @draht/ai registry.\n * Returns errors if provider or model is not found.\n */\nfunction validateModelRefAgainstRegistry(\n\tref: ModelRef,\n\trole: string,\n\tposition: string,\n\tvalidProviders: Set<string>,\n): string[] {\n\tconst errors: string[] = [];\n\n\t// Skip if empty (already caught by structure validation)\n\tif (!ref.provider || !ref.model) {\n\t\treturn errors;\n\t}\n\n\t// Check provider exists\n\tif (!validProviders.has(ref.provider)) {\n\t\terrors.push(`Invalid provider '${ref.provider}' for role ${role} (not in @draht/ai registry)`);\n\t\treturn errors; // Don't check model if provider is invalid\n\t}\n\n\t// Check model exists for this provider\n\tconst models = getModels(ref.provider as BuiltinProvider);\n\tconst modelExists = models.some((m) => m.id === ref.model);\n\tif (!modelExists) {\n\t\terrors.push(`Invalid model '${ref.model}' for provider '${ref.provider}' in role ${role} (${position})`);\n\t}\n\n\treturn errors;\n}\n\n/**\n * Validate a RoleConfig against the @draht/ai registry.\n */\nfunction validateRoleConfigAgainstRegistry(\n\troleConfig: RoleConfig,\n\trole: string,\n\tvalidProviders: Set<string>,\n): string[] {\n\tconst errors: string[] = [];\n\n\t// Validate primary\n\terrors.push(...validateModelRefAgainstRegistry(roleConfig.primary, role, \"primary\", validProviders));\n\n\t// Validate fallbacks\n\tfor (let i = 0; i < roleConfig.fallbacks.length; i++) {\n\t\terrors.push(...validateModelRefAgainstRegistry(roleConfig.fallbacks[i], role, `fallback[${i}]`, validProviders));\n\t}\n\n\treturn errors;\n}\n\n/**\n * Format a ModelRef as \"provider/model\" for display.\n */\nfunction formatModelRefForValidation(ref: ModelRef): string {\n\treturn `${ref.provider}/${ref.model}`;\n}\n\n/**\n * Detect duplicate models in a fallback chain (primary + fallbacks).\n */\nfunction detectDuplicateModels(roleConfig: RoleConfig, role: string): string[] {\n\tconst errors: string[] = [];\n\tconst allModels: ModelRef[] = [roleConfig.primary, ...roleConfig.fallbacks];\n\tconst seen = new Set<string>();\n\n\tfor (const ref of allModels) {\n\t\tconst key = formatModelRefForValidation(ref);\n\t\tif (seen.has(key)) {\n\t\t\terrors.push(`Duplicate model ${key} in fallback chain for role ${role}`);\n\t\t}\n\t\tseen.add(key);\n\t}\n\n\treturn errors;\n}\n\n/**\n * Validate a router config.\n * Throws ConfigValidationError if any issues are found.\n */\nexport function validateConfig(config: RouterConfig): void {\n\tconst errors: string[] = [];\n\n\t// Check all built-in roles are present\n\tfor (const role of BUILT_IN_ROLES) {\n\t\tif (!(role in config)) {\n\t\t\terrors.push(`Missing required role: ${role}`);\n\t\t}\n\t}\n\n\t// Validate structure of each role config\n\tfor (const [role, roleConfig] of Object.entries(config)) {\n\t\terrors.push(...validateRoleConfig(roleConfig, role));\n\t}\n\n\t// Cache valid providers for registry validation\n\tconst validProviders = new Set(getProviders());\n\n\t// Validate each role config against registry\n\tfor (const [role, roleConfig] of Object.entries(config)) {\n\t\terrors.push(...validateRoleConfigAgainstRegistry(roleConfig, role, validProviders));\n\t}\n\n\t// Detect duplicate models in fallback chains\n\tfor (const [role, roleConfig] of Object.entries(config)) {\n\t\terrors.push(...detectDuplicateModels(roleConfig, role));\n\t}\n\n\tif (errors.length > 0) {\n\t\tthrow new ConfigValidationError(errors);\n\t}\n}\n"]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@draht/router",
3
- "version": "2026.7.13",
3
+ "version": "2026.9.5-1",
4
4
  "description": "Role-based model routing with direct API calls, auto-fallback, and cost tracking",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",
@@ -25,9 +25,9 @@
25
25
  "test": "bun test"
26
26
  },
27
27
  "dependencies": {
28
- "@draht/ai": "2026.7.13"
28
+ "@draht/ai": "2026.9.5-1"
29
29
  },
30
30
  "devDependencies": {
31
- "@draht/coding-agent": "2026.7.13"
31
+ "@draht/coding-agent": "2026.9.5-1"
32
32
  }
33
33
  }