@wundam/orchex 1.0.0-rc.1

package/dist/config.js

@@ -0,0 +1,172 @@
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import * as os from 'os';
+import { z } from 'zod';
+import { TierIdSchema } from './tiers.js';
+// Well-known URLs
+export const PRODUCTION_URL = 'https://api.orchex.dev';
+// ============================================================================
+// LLM Provider Configuration
+// ============================================================================
+export const LLMProviderSchema = z.enum(['anthropic', 'openai', 'gemini', 'ollama', 'deepseek']);
+/**
+ * Detect the LLM provider based on available environment variables.
+ * Priority: ORCHEX_PROVIDER env var > first available API key
+ */
+export function detectProvider() {
+    // Explicit provider override
+    const explicit = process.env.ORCHEX_PROVIDER?.toLowerCase();
+    if (explicit && ['anthropic', 'openai', 'gemini', 'ollama', 'deepseek'].includes(explicit)) {
+        return explicit;
+    }
+    // Auto-detect from available API keys (priority order)
+    if (process.env.ANTHROPIC_API_KEY)
+        return 'anthropic';
+    if (process.env.OPENAI_API_KEY)
+        return 'openai';
+    if (process.env.GEMINI_API_KEY || process.env.GOOGLE_API_KEY)
+        return 'gemini';
+    if (process.env.DEEPSEEK_API_KEY)
+        return 'deepseek';
+    if (process.env.OLLAMA_BASE_URL || process.env.OLLAMA_HOST)
+        return 'ollama';
+    // Default to Anthropic (original behavior)
+    return 'anthropic';
+}
+/**
+ * Get the API key for a specific provider from environment variables.
+ */
+export function getProviderApiKey(provider) {
+    switch (provider) {
+        case 'anthropic':
+            return process.env.ANTHROPIC_API_KEY;
+        case 'openai':
+            return process.env.OPENAI_API_KEY;
+        case 'gemini':
+            return process.env.GEMINI_API_KEY || process.env.GOOGLE_API_KEY;
+        case 'deepseek':
+            return process.env.DEEPSEEK_API_KEY;
+        case 'ollama':
+            return undefined; // Ollama doesn't require an API key
+    }
+}
+/**
+ * Get the base URL for a provider (relevant for Ollama).
+ */
+export function getProviderBaseUrl(provider) {
+    switch (provider) {
+        case 'deepseek':
+            return process.env.DEEPSEEK_BASE_URL || 'https://api.deepseek.com/v1';
+        case 'ollama':
+            return process.env.OLLAMA_BASE_URL || process.env.OLLAMA_HOST || 'http://localhost:11434';
+        default:
+            return undefined;
+    }
+}
+/**
+ * Default models for each provider.
+ * Used when no model is specified in config or request.
+ */
+export const DEFAULT_MODELS = {
+    anthropic: 'claude-sonnet-4-5-20250929',
+    openai: 'gpt-4.1',
+    gemini: 'gemini-2.0-flash',
+    deepseek: 'deepseek-coder',
+    ollama: 'llama3.3:70b',
+};
+/**
+ * Get the configured provider.
+ * Priority: ORCHEX_PROVIDER env > config file > auto-detect from API keys > default
+ */
+export function getConfiguredProvider(config) {
+    // 1. Env var (highest — standard Unix convention)
+    const explicit = process.env.ORCHEX_PROVIDER?.toLowerCase();
+    if (explicit && LLMProviderSchema.safeParse(explicit).success) {
+        return explicit;
+    }
+    // 2. Config file
+    if (config.provider) {
+        return config.provider;
+    }
+    // 3. Auto-detect from API keys / default
+    return detectProvider();
+}
+/**
+ * Get the configured model, falling back to provider default.
+ * Priority: ORCHEX_MODEL env > config.model > provider default
+ */
+export function getConfiguredModel(config) {
+    // 1. Env var (highest — standard Unix convention)
+    if (process.env.ORCHEX_MODEL) {
+        return process.env.ORCHEX_MODEL;
+    }
+    // 2. Config file
+    if (config.model) {
+        return config.model;
+    }
+    // 3. Fall back to provider default
+    const provider = getConfiguredProvider(config);
+    return DEFAULT_MODELS[provider];
+}
+// ============================================================================
+// Config Schema
+// ============================================================================
+export const TelemetryConfigSchema = z.object({
+    enabled: z.boolean().default(false),
+    endpoint: z.string().url().optional(), // For future remote telemetry
+});
+export const ConfigSchema = z.object({
+    mode: z.enum(['local', 'cloud']).default('local'),
+    apiUrl: z.string().url().default(PRODUCTION_URL),
+    apiKey: z.string().optional(),
+    /** User's subscription tier (synced from cloud on login) */
+    tier: TierIdSchema.default('free'),
+    /** LLM provider (auto-detected if not set) */
+    provider: LLMProviderSchema.optional(),
+    /** LLM model (uses provider default if not set) */
+    model: z.string().optional(),
+    telemetry: TelemetryConfigSchema.default({ enabled: false }),
+});
+/**
+ * Validate that cloud config has required fields.
+ * Returns error message if invalid, undefined if valid.
+ */
+export function validateCloudConfig(config) {
+    if (config.mode === 'cloud' && !config.apiKey) {
+        return 'Cloud mode requires apiKey. Configure with: orchex config --staging --api-key <your-key>';
+    }
+    return undefined;
+}
+function configDir() {
+    return process.env.ORCHEX_CONFIG_DIR ?? path.join(os.homedir(), '.orchex');
+}
+function configPath() {
+    return path.join(configDir(), 'config.json');
+}
+/**
+ * Load config from disk. Returns defaults when file doesn't exist.
+ */
+export async function loadConfig() {
+    try {
+        const raw = await fs.readFile(configPath(), 'utf-8');
+        return ConfigSchema.parse(JSON.parse(raw));
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return ConfigSchema.parse({});
+        }
+        throw error;
+    }
+}
+/**
+ * Save partial config. Merges with existing config.
+ */
+export async function saveConfig(partial) {
+    const existing = await loadConfig();
+    const merged = { ...existing, ...partial };
+    const validated = ConfigSchema.parse(merged);
+    const dir = configDir();
+    await fs.mkdir(dir, { recursive: true });
+    await fs.writeFile(configPath(), JSON.stringify(validated, null, 2), { encoding: 'utf-8', mode: 0o600 });
+    return validated;
+}

package/dist/context-builder.d.ts

@@ -0,0 +1,46 @@
+import type { Manifest, StructuredPrompt } from './types.js';
+/**
+ * Build project context: file tree, package.json deps, tsconfig summary.
+ */
+export declare function buildProjectContext(projectDir: string): Promise<string>;
+/**
+ * Build stream context: full content of owned and read files.
+ * Directory patterns (ending with '/') expand to all files within.
+ */
+export declare function buildStreamContext(projectDir: string, owns: string[], reads: string[]): Promise<string>;
+/**
+ * Build dependency context: summaries and created file contents from completed deps.
+ */
+export declare function buildDependencyContext(projectDir: string, deps: string[], manifest: Manifest): Promise<string>;
+/**
+ * Build output instructions: artifact format, rules, constraints.
+ */
+export declare function buildInstructions(streamId: string, owns: string[]): string;
+/**
+ * Build the complete prompt for an agent, assembling all 4 context layers.
+ */
+export declare function buildFullPrompt(projectDir: string, streamId: string, manifest: Manifest): Promise<string>;
+/**
+ * Options for building an optimized prompt.
+ */
+export interface BuildPromptOptions {
+    /** Provider for budget limit lookup (e.g., 'anthropic', 'openai') */
+    provider?: string;
+    /** Model for more specific limit lookup */
+    model?: string;
+    /** Whether to enforce hard budget limits (throws ContextBudgetExceededError) */
+    enforceHardLimit?: boolean;
+}
+/**
+ * Build an optimized prompt with caching hints for cost reduction.
+ *
+ * Improvements over buildFullPrompt:
+ * 1. Uses import graph analysis to prune unused files from context
+ * 2. Generates caching hints for Anthropic prompt caching (90% savings on cached content)
+ * 3. Returns structured prompt for fine-grained caching control
+ * 4. Tracks optimization metrics for telemetry
+ * 5. Performs budget validation and includes check results (Orchex Learn)
+ *
+ * @throws ContextBudgetExceededError if hard limit violated and enforceHardLimit is true
+ */
+export declare function buildFullPromptOptimized(projectDir: string, streamId: string, manifest: Manifest, options?: BuildPromptOptions): Promise<StructuredPrompt>;