@wundam/orchex 1.0.0-rc.1

package/dist/tiers.js

@@ -0,0 +1,108 @@
+import { z } from 'zod';
+// ============================================================================
+// Tier Definitions
+// ============================================================================
+export const TierIdSchema = z.enum(['free', 'pro', 'team', 'enterprise']);
+export const TierSchema = z.object({
+    id: TierIdSchema,
+    name: z.string(),
+    price: z.number().describe('Monthly price in USD, -1 = contact sales'),
+    cloudOrchestrations: z.number().describe('Max cloud orchestrations per month, 0 = local only, -1 = unlimited'),
+    maxParallelAgents: z.number().describe('Max parallel agents'),
+    selfHealing: z.enum(['none', 'full']),
+    smartPlanning: z.enum(['none', 'full']),
+    teamMembers: z.number().describe('Max team members, 1 = solo, -1 = unlimited'),
+    /** Maximum # of dependency waves (-1 = unlimited) */
+    maxWaves: z.number().describe('Max dependency waves allowed. -1 = unlimited'),
+    /** Maximum # of distinct LLM providers per orchestration (-1 = unlimited) */
+    maxProviders: z.number().describe('Max LLM providers allowed per orchestration. -1 = unlimited'),
+});
+// ============================================================================
+// Canonical tier definitions — 4-tier value-based pricing (2026-02-06)
+// ============================================================================
+//
+// PRICING RATIONALE (Updated 2026-02-13 — charm pricing alignment):
+// ------------------
+// Cost Analysis:
+// - Variable cost per orchestration: ~$0.006 (Fly.io per-second billing + storage)
+// - Fixed infrastructure: ~$35-55/month (API server, PostgreSQL, monitoring)
+// - LLM API costs: $0 (BYOK - user pays their own API costs)
+//
+// With BYOK and efficient infrastructure, margins are 93%+. We price for VALUE,
+// not cost. Users save ~30 min per orchestration in time value.
+//
+// Value Calculation:
+// - Time saved per orchestration: ~30 minutes (parallel execution, auto-apply, self-healing)
+// - At $50/hr developer rate: ~$25 value per orchestration
+// - Pro user (50 orchestrations): $1,250 potential value for $19 = 65x ROI
+//
+// Tier Design (5-tier model, code tracks 4 — Trial is a feature of Free):
+// - Free: Funnel, local only, no cloud costs. $5 one-time cloud credit (30 days).
+// - Pro ($19): Individual devs, freelancers - 100 orchestrations covers power users
+// - Team ($49): Small teams (2-10) - shared quotas, org management, 500 runs
+// - Enterprise: Custom - SLA, dedicated infra, custom integrations (compliance discussed in sales)
+//
+// Why 100 orchestrations for Pro:
+// - Most users do 15-50/month (won't hit limit)
+// - Power users (50-100/month) still comfortable
+// - Heavy users (100+) naturally upgrade to Team
+// ============================================================================
+export const TIERS = {
+    free: {
+        id: 'free',
+        name: 'Free',
+        price: 0,
+        cloudOrchestrations: 0,
+        maxParallelAgents: 5,
+        selfHealing: 'none',
+        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
+    },
+    pro: {
+        id: 'pro',
+        name: 'Pro',
+        price: 19,
+        cloudOrchestrations: 100,
+        maxParallelAgents: 15,
+        selfHealing: 'full',
+        smartPlanning: 'full',
+        teamMembers: 1,
+        maxWaves: 10, // e.g., higher but not unlimited
+        maxProviders: 2,
+    },
+    team: {
+        id: 'team',
+        name: 'Team',
+        price: 49,
+        cloudOrchestrations: 500,
+        maxParallelAgents: 25,
+        selfHealing: 'full',
+        smartPlanning: 'full',
+        teamMembers: -1, // unlimited
+        maxWaves: 25,
+        maxProviders: 3,
+    },
+    enterprise: {
+        id: 'enterprise',
+        name: 'Enterprise',
+        price: -1, // contact sales
+        cloudOrchestrations: -1, // unlimited
+        maxParallelAgents: 50,
+        selfHealing: 'full',
+        smartPlanning: 'full',
+        teamMembers: -1, // unlimited
+        maxWaves: -1, // unlimited
+        maxProviders: -1, // unlimited
+    },
+};
+// ============================================================================
+// Helpers
+// ============================================================================
+export function getTier(id) {
+    return TIERS[id];
+}
+export function isCloudTier(id) {
+    return TIERS[id].cloudOrchestrations !== 0;
+}

package/dist/tools.d.ts

@@ -0,0 +1,18 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ExecutorStrategy } from './types.js';
+import type { TierId } from './tiers.js';
+import type { IUserStore } from './storage/users.js';
+import type { IProviderKeyStore } from './storage/provider-keys.js';
+import type { IHistoryStore } from './storage/history.js';
+export declare function setProjectDir(dir: string): void;
+export interface ToolContext {
+    userStore: IUserStore;
+    userId: string;
+    userTier: TierId;
+    userCreatedAt: string;
+    organizationId?: string;
+    providerKeyStore?: IProviderKeyStore;
+    historyStore?: IHistoryStore;
+}
+export declare function generatePlanTemplate(featureName: string, slug: string): string;
+export declare function registerTools(server: McpServer, executor?: ExecutorStrategy, context?: ToolContext): void;