@wundam/orchex 1.0.0-rc.2 → 1.0.0-rc.21

package/dist/setup/index.js

@@ -0,0 +1,111 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { IDE_REGISTRY, detectIdes, findBySlug, FALLBACK_CONFIG_PATH, generateMcpConfig, mergeConfig, } from './ide-registry.js';
+function parseFlags(args) {
+    const flags = { dryRun: false, force: false, help: false };
+    for (let i = 0; i < args.length; i++) {
+        if (args[i] === '--ide' && args[i + 1]) {
+            flags.ide = args[++i];
+        }
+        else if (args[i].startsWith('--ide=')) {
+            flags.ide = args[i].slice(6);
+        }
+        else if (args[i] === '--dry-run') {
+            flags.dryRun = true;
+        }
+        else if (args[i] === '--force') {
+            flags.force = true;
+        }
+        else if (args[i] === '--help') {
+            flags.help = true;
+        }
+    }
+    return flags;
+}
+function printSetupHelp() {
+    console.log(`
+Usage: orchex setup [options]
+
+Auto-configure Orchex MCP server for your IDE
+
+Options:
+  --ide <name>    Target specific IDE (cursor, windsurf)
+  --dry-run       Show config without writing
+  --force         Overwrite existing config
+  --help          Show this help
+
+Supported IDEs:
+  cursor    Cursor IDE (project-level config)
+  windsurf  Windsurf IDE (global config)
+
+Examples:
+  orchex setup                  # Auto-detect and configure all IDEs
+  orchex setup --ide cursor     # Configure Cursor only
+  orchex setup --dry-run        # Preview changes
+`.trim());
+}
+async function writeConfigToPath(configPath, ideName, flags) {
+    const orchexConfig = generateMcpConfig();
+    const orchexEntry = orchexConfig.mcpServers.orchex;
+    // Read existing config
+    let existing = {};
+    if (fs.existsSync(configPath)) {
+        try {
+            existing = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+        }
+        catch {
+            console.error(`Error: invalid JSON in ${configPath}`);
+            return;
+        }
+        // Check if orchex already configured
+        const servers = existing.mcpServers;
+        if (servers?.orchex && !flags.force) {
+            console.log(`${ideName}: orchex already configured in ${configPath}`);
+            return;
+        }
+    }
+    const merged = mergeConfig(existing, orchexEntry);
+    if (flags.dryRun) {
+        console.log(`Would write to ${configPath}:`);
+        console.log(JSON.stringify(merged, null, 2));
+        return;
+    }
+    // Create parent directories
+    fs.mkdirSync(path.dirname(configPath), { recursive: true });
+    fs.writeFileSync(configPath, JSON.stringify(merged, null, 2) + '\n');
+    console.log(`${ideName}: wrote ${configPath}`);
+}
+export async function handleSetupCommand(args, projectDir = process.cwd()) {
+    const flags = parseFlags(args);
+    if (flags.help) {
+        printSetupHelp();
+        return;
+    }
+    if (flags.ide) {
+        // Target specific IDE
+        const ide = findBySlug(flags.ide);
+        if (!ide) {
+            console.error(`Unknown IDE: ${flags.ide}. Supported: ${IDE_REGISTRY.map(i => i.slug).join(', ')}`);
+            return;
+        }
+        await writeConfigToPath(ide.configPath(projectDir), ide.name, flags);
+        return;
+    }
+    // Auto-detect IDEs
+    const detected = detectIdes(projectDir);
+    for (const ide of detected) {
+        await writeConfigToPath(ide.configPath(projectDir), ide.name, flags);
+    }
+    // Always write fallback .mcp.json
+    console.log('Writing standard MCP config (works with Claude Code, VS Code, and other MCP clients)');
+    await writeConfigToPath(FALLBACK_CONFIG_PATH(projectDir), 'Standard MCP', flags);
+    // Print next steps
+    if (!flags.dryRun) {
+        console.log(`
+Setup complete! Next steps:
+1. Restart your IDE/editor
+2. Verify with: orchex_status (in MCP client)
+3. API keys: Set ANTHROPIC_API_KEY or OPENAI_API_KEY
+   (Orchex auto-detects from environment)`);
+    }
+}

package/dist/tier-gating.js

@@ -26,22 +26,6 @@ export function checkTierLimits(opts) {
             };
         }
     }
-    // 3. maxProviders: Count distinct providers across streams with explicit provider field
-    if (tier.maxProviders !== -1) {
-        const providers = new Set();
-        for (const s of Object.values(streams)) {
-            if (s.provider)
-                providers.add(s.provider);
-        }
-        if (providers.size > tier.maxProviders) {
-            return {
-                allowed: false,
-                error: `Too many LLM providers for tier '${tier.name}'. Max allowed: ${tier.maxProviders}, requested: ${providers.size}. Upgrade to increase this limit.`,
-                code: 'MAX_PROVIDERS_EXCEEDED',
-                suggestion: `Reduce the number of distinct providers to ${tier.maxProviders} or fewer, or upgrade your tier.`,
-            };
-        }
-    }
     return { allowed: true };
 }
 /**

package/dist/tiers.d.ts

@@ -17,8 +17,8 @@ export declare const TierSchema: z.ZodObject<{
     /** Maximum # of API tokens per user (-1 = unlimited) */
     maxApiTokens: z.ZodNumber;
 }, "strip", z.ZodTypeAny, {
-    name: string;
     id: "free" | "pro" | "team" | "enterprise";
+    name: string;
     price: number;
     cloudOrchestrations: number;
     maxParallelAgents: number;
@@ -29,8 +29,8 @@ export declare const TierSchema: z.ZodObject<{
     maxProviders: number;
     maxApiTokens: number;
 }, {
-    name: string;
     id: "free" | "pro" | "team" | "enterprise";
+    name: string;
     price: number;
     cloudOrchestrations: number;
     maxParallelAgents: number;
@@ -53,7 +53,7 @@ export declare const TIERS: {
         readonly smartPlanning: "none";
         readonly teamMembers: 1;
         readonly maxWaves: 2;
-        readonly maxProviders: 1;
+        readonly maxProviders: -1;
         readonly maxApiTokens: 2;
     };
     readonly pro: {
@@ -66,7 +66,7 @@ export declare const TIERS: {
         readonly smartPlanning: "full";
         readonly teamMembers: 1;
         readonly maxWaves: 10;
-        readonly maxProviders: 2;
+        readonly maxProviders: -1;
         readonly maxApiTokens: 10;
     };
     readonly team: {
@@ -79,7 +79,7 @@ export declare const TIERS: {
         readonly smartPlanning: "full";
         readonly teamMembers: -1;
         readonly maxWaves: 25;
-        readonly maxProviders: 3;
+        readonly maxProviders: -1;
         readonly maxApiTokens: 50;
     };
     readonly enterprise: {
@@ -98,3 +98,33 @@ export declare const TIERS: {
 };
 export declare function getTier(id: TierId): Tier;
 export declare function isCloudTier(id: TierId): boolean;
+/** Trial window in days — free users get Pro limits during this period if they have trial runs. */
+export declare const TRIAL_WINDOW_DAYS = 30;
+export interface EffectiveTierInput {
+    tier: TierId;
+    createdAt: string;
+    trialRunsRemaining: number;
+}
+/**
+ * Resolve the effective tier for a user.
+ * Free users within the trial window (30 days) with remaining trial runs
+ * get Pro-level limits. All other users return their stored tier.
+ */
+export declare function getEffectiveTier(user: EffectiveTierInput): TierId;
+/**
+ * Minimal promotion shape for tier calculation.
+ * The full Promotion interface (with userId, promoType, stripe fields, etc.)
+ * lives in storage/promotions.ts — server-only, not published to npm.
+ * @internal
+ */
+export interface PublishedPromotion {
+    status: 'active' | 'expired' | 'cancelled' | 'superseded';
+    expiresAt: string;
+    limitsOverride: Partial<Pick<Tier, 'maxParallelAgents' | 'maxWaves' | 'maxProviders' | 'maxApiTokens' | 'cloudOrchestrations'>>;
+}
+/**
+ * Resolve effective limits for a user by merging active promotion overrides
+ * on top of the base tier limits.
+ * Returns a Tier object with overridden numeric fields.
+ */
+export declare function getEffectiveLimits(tierId: TierId, promotion: PublishedPromotion | null): Tier;

package/dist/tiers.js

@@ -60,7 +60,7 @@ export const TIERS = {
         smartPlanning: 'none',
         teamMembers: 1,
         maxWaves: 2, // max dependency depth for free tier (decision: all docs agree on 2)
-        maxProviders: 1, // only 1 provider allowed for free
+        maxProviders: -1, // unlimited — BYOK, zero cost regardless of provider count
         maxApiTokens: 2,
     },
     pro: {
@@ -73,7 +73,7 @@ export const TIERS = {
         smartPlanning: 'full',
         teamMembers: 1,
         maxWaves: 10, // e.g., higher but not unlimited
-        maxProviders: 2,
+        maxProviders: -1, // unlimited
         maxApiTokens: 10,
     },
     team: {
@@ -86,7 +86,7 @@ export const TIERS = {
         smartPlanning: 'full',
         teamMembers: -1, // unlimited
         maxWaves: 25,
-        maxProviders: 3,
+        maxProviders: -1, // unlimited
         maxApiTokens: 50,
     },
     enterprise: {
@@ -112,3 +112,39 @@ export function getTier(id) {
 export function isCloudTier(id) {
     return TIERS[id].cloudOrchestrations !== 0;
 }
+/** Trial window in days — free users get Pro limits during this period if they have trial runs. */
+export const TRIAL_WINDOW_DAYS = 30;
+/**
+ * Resolve the effective tier for a user.
+ * Free users within the trial window (30 days) with remaining trial runs
+ * get Pro-level limits. All other users return their stored tier.
+ */
+export function getEffectiveTier(user) {
+    if (user.tier !== 'free')
+        return user.tier;
+    const accountAgeDays = (Date.now() - new Date(user.createdAt).getTime()) / (1000 * 60 * 60 * 24);
+    if (accountAgeDays <= TRIAL_WINDOW_DAYS && user.trialRunsRemaining > 0) {
+        return 'pro';
+    }
+    return 'free';
+}
+/**
+ * Resolve effective limits for a user by merging active promotion overrides
+ * on top of the base tier limits.
+ * Returns a Tier object with overridden numeric fields.
+ */
+export function getEffectiveLimits(tierId, promotion) {
+    const base = getTier(tierId);
+    if (!promotion || promotion.status !== 'active' || new Date(promotion.expiresAt) <= new Date()) {
+        return base;
+    }
+    const override = promotion.limitsOverride;
+    return {
+        ...base,
+        maxParallelAgents: override.maxParallelAgents ?? base.maxParallelAgents,
+        maxWaves: override.maxWaves ?? base.maxWaves,
+        maxProviders: override.maxProviders ?? base.maxProviders,
+        maxApiTokens: override.maxApiTokens ?? base.maxApiTokens,
+        cloudOrchestrations: override.cloudOrchestrations ?? base.cloudOrchestrations,
+    };
+}

package/dist/tools.d.ts

@@ -1,6 +1,6 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { ExecutorStrategy } from './types.js';
-import type { TierId } from './tiers.js';
+import type { TierId, PublishedPromotion } from './tiers.js';
 /** @internal */
 interface ToolUserStore {
     getUserById(id: string): Promise<{
@@ -29,6 +29,10 @@ interface ToolHistoryStore {
     }>;
     saveRun(run: Record<string, unknown>, streams: Record<string, unknown>[], artifactData?: unknown): Promise<unknown>;
 }
+/** @internal Cloud-only promotion store. Only the method used by tools.ts is declared. */
+interface IPromotionStore {
+    getActiveByUserId(userId: string): Promise<PublishedPromotion | null>;
+}
 export declare function setProjectDir(dir: string): void;
 /** @internal Cloud-only context — not part of the public npm API. */
 export interface ToolContext {
@@ -39,6 +43,7 @@ export interface ToolContext {
     organizationId?: string;
     providerKeyStore?: ToolProviderKeyStore;
     historyStore?: ToolHistoryStore;
+    promotionStore?: IPromotionStore;
 }
 export declare function generatePlanTemplate(featureName: string, slug: string): string;
 export declare function registerTools(server: McpServer, executor?: ExecutorStrategy, context?: ToolContext): void;