mycontext-cli 2.0.28 → 2.0.30

package/dist/templates/ui-spec-examples.md

@@ -0,0 +1,318 @@
+# UI Specification System Examples
+
+The MyContext CLI now includes a powerful UI specification system that converts component descriptions into detailed, plain-English specifications that developers can implement without further clarification.
+
+## Quick Start
+
+### 1. Standalone UI Spec Generation
+
+Generate a UI specification from a simple description:
+
+```bash
+# Generate spec from description
+mycontext refine spec RevenueCard --desc "A card showing total revenue prominently with a small subtitle showing percentage change"
+
+# Generate spec from JSON file
+mycontext refine spec UserProfile --json-file ./user-profile.json
+
+# Generate spec from inline JSON
+mycontext refine spec ContactForm --json-input '{"name":"ContactForm","type":"form","elements":[{"type":"input","label":"Name","required":true}]}'
+```
+
+### 2. Integrated with Component Generation
+
+When generating components with verbose mode, UI specs are automatically generated:
+
+```bash
+# Generate components with UI specs
+mycontext generate-components all --verbose
+
+# Generate specific group with UI specs
+mycontext generate-components dashboard --verbose
+```
+
+## Example Outputs
+
+### Compact Specification Example
+
+**RevenueCard Component - Compact Spec**
+
+**Visual Hierarchy:**
+
+- Primary: Total Revenue, $125,430
+- Secondary: +12.5% from last month
+
+**Layout:** vertical arrangement
+**Spacing:** medium spacing between elements
+**Colors:** primary, success theme
+**Interactions:** None
+
+### Detailed Specification Example
+
+**RevenueCard Component - Detailed Implementation Spec**
+
+**Component Overview:**
+
+- Name: RevenueCard
+- Type: card
+- Description: A card component displaying revenue metrics with primary value prominently and secondary info subtly
+
+**Visual Hierarchy:**
+
+1. **title**: Total Revenue
+   - Prominence: medium (medium (~16px))
+2. **value**: $125,430
+   - Prominence: high (large (~32px))
+3. **subtitle**: +12.5% from last month
+   - Prominence: low (small (~12px))
+4. **icon**: trending-up
+   - Prominence: low (small (~12px))
+
+**Layout Specifications:**
+
+- Arrangement: vertical
+- Spacing: medium (16px between elements)
+- Alignment: left
+
+**Styling Details:**
+
+- Theme: modern
+- Color Palette: primary, success
+- Border Radius: lg
+- Shadow: sm
+
+**State Behavior:**
+
+- Default: clean, minimal appearance
+- Hover: subtle elevation or color change
+
+**Accessibility Requirements:**
+
+- All interactive elements must have aria-label or aria-labelledby
+- Focus management: tab order follows visual hierarchy
+- Color contrast: minimum 4.5:1 ratio for text
+- Screen reader: semantic HTML structure
+
+**Responsive Adjustments:**
+
+- Mobile (< 768px):
+  - Reduce spacing to 12px
+  - Stack elements vertically
+  - Increase touch targets to 44px minimum
+- Desktop (> 768px):
+  - Standard spacing (16px)
+  - Maintain original layout
+  - Hover states enabled
+
+## JSON Template Examples
+
+### Card Component Template
+
+```json
+{
+  "name": "RevenueCard",
+  "type": "card",
+  "description": "A card component displaying revenue metrics with primary value prominently and secondary info subtly",
+  "elements": [
+    {
+      "type": "title",
+      "content": "Total Revenue",
+      "prominence": "medium"
+    },
+    {
+      "type": "value",
+      "content": "$125,430",
+      "prominence": "high"
+    },
+    {
+      "type": "subtitle",
+      "content": "+12.5% from last month",
+      "prominence": "low"
+    },
+    {
+      "type": "icon",
+      "content": "trending-up",
+      "prominence": "low"
+    }
+  ],
+  "layout": "vertical",
+  "styling": {
+    "theme": "modern",
+    "colors": ["primary", "success"],
+    "spacing": "medium",
+    "borderRadius": "lg",
+    "shadow": "sm",
+    "alignment": "left"
+  }
+}
+```
+
+### Form Component Template
+
+```json
+{
+  "name": "ContactForm",
+  "type": "form",
+  "description": "A contact form with input fields and submit button",
+  "elements": [
+    {
+      "type": "input",
+      "label": "Name",
+      "required": true,
+      "prominence": "medium"
+    },
+    {
+      "type": "input",
+      "label": "Email",
+      "required": true,
+      "prominence": "medium"
+    },
+    {
+      "type": "textarea",
+      "label": "Message",
+      "required": true,
+      "prominence": "medium"
+    },
+    {
+      "type": "button",
+      "label": "Send Message",
+      "variant": "primary",
+      "prominence": "high"
+    }
+  ],
+  "layout": "vertical",
+  "styling": {
+    "theme": "modern",
+    "colors": ["primary", "secondary"],
+    "spacing": "medium",
+    "borderRadius": "md",
+    "shadow": "none",
+    "alignment": "left"
+  }
+}
+```
+
+### Button Component Template
+
+```json
+{
+  "name": "PrimaryButton",
+  "type": "button",
+  "description": "A primary action button with hover and focus states",
+  "elements": [
+    {
+      "type": "button",
+      "label": "Get Started",
+      "variant": "primary",
+      "prominence": "high"
+    }
+  ],
+  "layout": "horizontal",
+  "styling": {
+    "theme": "modern",
+    "colors": ["primary"],
+    "spacing": "none",
+    "borderRadius": "md",
+    "shadow": "sm",
+    "alignment": "center"
+  }
+}
+```
+
+## Command Options
+
+### UI Spec Command Options
+
+- `--desc <description>`: Component description
+- `--json-input <json>`: Inline JSON component description
+- `--json-file <path>`: Path to JSON file with component description
+- `--output-format <format>`: Output format (compact, detailed, both)
+- `--template <type>`: Component template (card, form, button, modal, list, custom)
+- `--verbose`: Show detailed output
+
+### Output Formats
+
+- **compact**: Short usable summary
+- **detailed**: Full implementation guidance
+- **both**: Both compact and detailed (default)
+
+## Integration Workflow
+
+### 1. Generate UI Spec First
+
+```bash
+# Generate spec for a revenue card
+mycontext refine spec RevenueCard --desc "A card showing total revenue prominently with percentage change"
+
+# Review the generated specification
+cat components/dashboard/RevenueCard.spec.md
+```
+
+### 2. Generate Component with Spec
+
+```bash
+# Generate component with verbose mode to include UI spec
+mycontext generate-components dashboard --verbose
+
+# This will create:
+# - components/dashboard/RevenueCard.tsx
+# - components/dashboard/RevenueCard.spec.md
+```
+
+### 3. Refine Component Using Spec
+
+```bash
+# Use the spec to refine the component
+mycontext refine components/dashboard/RevenueCard.tsx --prompt "Implement the UI specification exactly as described"
+```
+
+## Best Practices
+
+1. **Start with UI Specs**: Always generate UI specs before component generation for complex components
+2. **Use Templates**: Leverage the built-in templates (card, form, button, modal, list) for common patterns
+3. **Iterative Refinement**: Use the spec as a reference for iterative improvements
+4. **Team Communication**: Share UI specs with designers and developers for alignment
+5. **Documentation**: Keep UI specs alongside components for future reference
+
+## Advanced Usage
+
+### Custom Templates
+
+Create custom JSON templates for your specific component patterns:
+
+```json
+{
+  "name": "CustomComponent",
+  "type": "custom",
+  "description": "Your custom component description",
+  "elements": [
+    {
+      "type": "custom-element",
+      "content": "Custom content",
+      "prominence": "high"
+    }
+  ],
+  "layout": "custom",
+  "styling": {
+    "theme": "custom",
+    "colors": ["custom-color"],
+    "spacing": "custom",
+    "borderRadius": "custom",
+    "shadow": "custom",
+    "alignment": "custom"
+  }
+}
+```
+
+### Batch Processing
+
+Generate specs for multiple components:
+
+```bash
+# Generate specs for all components in a group
+for component in $(mycontext list components --format simple); do
+  mycontext refine spec $component --desc "Component description"
+done
+```
+
+This UI specification system bridges the gap between high-level requirements and implementation details, making component development more efficient and consistent.

package/dist/templates/ui-spec-templates.json

@@ -0,0 +1,244 @@
+{
+  "card": {
+    "name": "RevenueCard",
+    "type": "card",
+    "description": "A card component displaying revenue metrics with primary value prominently and secondary info subtly",
+    "elements": [
+      {
+        "type": "title",
+        "content": "Total Revenue",
+        "prominence": "medium"
+      },
+      {
+        "type": "value",
+        "content": "$125,430",
+        "prominence": "high"
+      },
+      {
+        "type": "subtitle",
+        "content": "+12.5% from last month",
+        "prominence": "low"
+      },
+      {
+        "type": "icon",
+        "content": "trending-up",
+        "prominence": "low"
+      }
+    ],
+    "layout": "vertical",
+    "styling": {
+      "theme": "modern",
+      "colors": ["primary", "success"],
+      "spacing": "medium",
+      "borderRadius": "lg",
+      "shadow": "sm",
+      "alignment": "left"
+    }
+  },
+  "form": {
+    "name": "ContactForm",
+    "type": "form",
+    "description": "A contact form with input fields and submit button",
+    "elements": [
+      {
+        "type": "input",
+        "inputType": "text",
+        "label": "Name",
+        "placeholder": "Enter your name",
+        "required": true,
+        "prominence": "medium"
+      },
+      {
+        "type": "input",
+        "inputType": "email",
+        "label": "Email",
+        "placeholder": "your.email@example.com",
+        "required": true,
+        "prominence": "medium"
+      },
+      {
+        "type": "textarea",
+        "label": "Message",
+        "placeholder": "Your message here...",
+        "rows": 4,
+        "required": true,
+        "prominence": "medium"
+      },
+      {
+        "type": "button",
+        "label": "Send Message",
+        "variant": "primary",
+        "prominence": "high"
+      }
+    ],
+    "layout": "vertical",
+    "styling": {
+      "theme": "modern",
+      "colors": ["primary", "secondary"],
+      "spacing": "medium",
+      "borderRadius": "md",
+      "shadow": "none",
+      "alignment": "left"
+    }
+  },
+  "button": {
+    "name": "PrimaryButton",
+    "type": "button",
+    "description": "A primary action button with hover and focus states",
+    "elements": [
+      {
+        "type": "button",
+        "label": "Get Started",
+        "variant": "primary",
+        "prominence": "high",
+        "icon": "arrow-right",
+        "iconPosition": "right"
+      }
+    ],
+    "layout": "horizontal",
+    "styling": {
+      "theme": "modern",
+      "colors": ["primary"],
+      "spacing": "none",
+      "borderRadius": "md",
+      "shadow": "sm",
+      "alignment": "center"
+    }
+  },
+  "modal": {
+    "name": "ConfirmationModal",
+    "type": "modal",
+    "description": "A confirmation modal with title, message, and action buttons",
+    "elements": [
+      {
+        "type": "icon",
+        "content": "alert-circle",
+        "prominence": "medium",
+        "color": "warning"
+      },
+      {
+        "type": "title",
+        "content": "Confirm Action",
+        "prominence": "high"
+      },
+      {
+        "type": "message",
+        "content": "Are you sure you want to proceed? This action cannot be undone.",
+        "prominence": "medium"
+      },
+      {
+        "type": "buttonGroup",
+        "layout": "horizontal",
+        "buttons": [
+          {
+            "type": "button",
+            "label": "Cancel",
+            "variant": "secondary",
+            "prominence": "medium"
+          },
+          {
+            "type": "button",
+            "label": "Confirm",
+            "variant": "primary",
+            "prominence": "high"
+          }
+        ]
+      }
+    ],
+    "layout": "vertical",
+    "styling": {
+      "theme": "modern",
+      "colors": ["primary", "secondary", "danger"],
+      "spacing": "medium",
+      "borderRadius": "lg",
+      "shadow": "xl",
+      "alignment": "center",
+      "backdrop": "blur"
+    }
+  },
+  "list": {
+    "name": "UserList",
+    "type": "list",
+    "description": "A list of users with avatar, name, and status",
+    "repeatable": true,
+    "elements": [
+      {
+        "type": "avatar",
+        "content": "User Avatar",
+        "size": "md",
+        "prominence": "medium"
+      },
+      {
+        "type": "text",
+        "label": "name",
+        "content": "John Doe",
+        "prominence": "high"
+      },
+      {
+        "type": "badge",
+        "label": "status",
+        "content": "Online",
+        "variant": "success",
+        "prominence": "low"
+      },
+      {
+        "type": "button",
+        "label": "View Profile",
+        "variant": "ghost",
+        "prominence": "medium"
+      }
+    ],
+    "layout": "horizontal",
+    "styling": {
+      "theme": "modern",
+      "colors": ["primary", "success"],
+      "spacing": "medium",
+      "borderRadius": "md",
+      "shadow": "none",
+      "alignment": "left",
+      "divider": true
+    }
+  },
+  "navigation": {
+    "name": "MainNavigation",
+    "type": "navigation",
+    "description": "A horizontal navigation bar with logo and menu items",
+    "elements": [
+      {
+        "type": "logo",
+        "content": "Brand Logo",
+        "prominence": "high"
+      },
+      {
+        "type": "navItem",
+        "label": "Home",
+        "active": true,
+        "prominence": "medium"
+      },
+      {
+        "type": "navItem",
+        "label": "About",
+        "prominence": "medium"
+      },
+      {
+        "type": "navItem",
+        "label": "Services",
+        "prominence": "medium"
+      },
+      {
+        "type": "navItem",
+        "label": "Contact",
+        "prominence": "medium"
+      }
+    ],
+    "layout": "horizontal",
+    "styling": {
+      "theme": "modern",
+      "colors": ["primary", "secondary"],
+      "spacing": "medium",
+      "borderRadius": "none",
+      "shadow": "sm",
+      "alignment": "space-between"
+    }
+  }
+}

package/dist/utils/envExampleGenerator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"envExampleGenerator.d.ts","sourceRoot":"","sources":["../../src/utils/envExampleGenerator.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,mBAAmB;IAClC,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,YAAY,CAAC,EAAE,mBAAmB,CAAC;IACnC,eAAe,CAAC,EAAE,mBAAmB,CAAC;CACvC;AAED,qBAAa,mBAAmB;IAC9B;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,WAAW,CAAC,EAAE,WAAW,GAAG,MAAM;IAwE5D;;OAEG;WACU,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CActE"}
+{"version":3,"file":"envExampleGenerator.d.ts","sourceRoot":"","sources":["../../src/utils/envExampleGenerator.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,mBAAmB;IAClC,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,YAAY,CAAC,EAAE,mBAAmB,CAAC;IACnC,eAAe,CAAC,EAAE,mBAAmB,CAAC;CACvC;AAED,qBAAa,mBAAmB;IAC9B;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,WAAW,CAAC,EAAE,WAAW,GAAG,MAAM;IA+E5D;;OAEG;WACU,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CActE"}

package/dist/utils/envExampleGenerator.js

@@ -55,6 +55,10 @@ class EnvExampleGenerator {
         envVars.add("# XAI/Grok (Fallback 2)");
         envVars.add("XAI_API_KEY=");
         envVars.add("");
+        // Add OpenRouter
+        envVars.add("# OpenRouter (Fallback 3 - Free Tier for Testing)");
+        envVars.add("MYCONTEXT_OPENROUTER_API_KEY=");
+        envVars.add("");
         // Generation settings
         envVars.add("# Optional: Generation Settings");
         envVars.add("MYCONTEXT_TEMPERATURE=0.1");
@@ -79,17 +83,19 @@ MYCONTEXT_API_KEY=mctx-xxx
 
 ### Option 2: Bring Your Own Keys (Free)
 \`\`\`bash
-ANTHROPIC_API_KEY=sk-ant-xxx   # Claude (primary)
-XAI_API_KEY=xai-xxx             # Grok (fallback)
+ANTHROPIC_API_KEY=sk-ant-xxx      # Claude (primary)
+XAI_API_KEY=xai-xxx                # Grok (fallback 1)
+MYCONTEXT_OPENROUTER_API_KEY=sk-or-xxx  # OpenRouter free tier (fallback 2)
 \`\`\`
 
 ## Provider Chain
-MyContext AI → Claude SDK → XAI (automatic fallback)
+MyContext AI → Claude SDK → XAI → OpenRouter (automatic fallback)
 
 ## Get API Keys
 
 - **Claude**: https://console.anthropic.com/
 - **XAI**: https://console.x.ai/
+- **OpenRouter**: https://openrouter.ai/keys (free tier available)
 - **MyContext AI**: Coming soon at api.mycontext.dev
 
 ## Environment Variables

package/dist/utils/envExampleGenerator.js.map

@@ -1 +1 @@
-{"version":3,"file":"envExampleGenerator.js","sourceRoot":"","sources":["../../src/utils/envExampleGenerator.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,6CAA+B;AAC/B,gDAAwB;AAWxB,MAAa,mBAAmB;IAC9B;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,WAAyB;QACjD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAElC,kEAAkE;QAClE,OAAO,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;QAC/D,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAEhB,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;QACzC,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAEhB,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;QACvC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAEhB,sBAAsB;QACtB,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;QAC/C,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;QACzC,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;QAEzC,kCAAkC;QAClC,MAAM,YAAY,GAAG,WAAW;YAC9B,CAAC,CAAC,EAAE,GAAG,WAAW,CAAC,YAAY,EAAE,GAAG,WAAW,CAAC,eAAe,EAAE;YACjE,CAAC,CAAC,EAAE,CAAC;QAEP,IAAI,YAAY,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACrC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;QAC7C,CAAC;QAED,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;EA0BT,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;;;;CAW/B,CAAC;IACA,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,WAAmB;QACjD,IAAI,CAAC;YACH,MAAM,eAAe,GAAG,cAAI,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;YAC/D,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;gBACzC,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;gBACvD,OAAO,IAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC;YAC9C,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,wDAAwD;QAC1D,CAAC;QAED,4BAA4B;QAC5B,OAAO,IAAI,CAAC,kBAAkB,EAAE,CAAC;IACnC,CAAC;CACF;AA7FD,kDA6FC"}
+{"version":3,"file":"envExampleGenerator.js","sourceRoot":"","sources":["../../src/utils/envExampleGenerator.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,6CAA+B;AAC/B,gDAAwB;AAWxB,MAAa,mBAAmB;IAC9B;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,WAAyB;QACjD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAElC,kEAAkE;QAClE,OAAO,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;QAC/D,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAEhB,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;QACzC,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAEhB,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;QACvC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAEhB,iBAAiB;QACjB,OAAO,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAC;QACjE,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;QAC7C,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAEhB,sBAAsB;QACtB,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;QAC/C,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;QACzC,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;QAEzC,kCAAkC;QAClC,MAAM,YAAY,GAAG,WAAW;YAC9B,CAAC,CAAC,EAAE,GAAG,WAAW,CAAC,YAAY,EAAE,GAAG,WAAW,CAAC,eAAe,EAAE;YACjE,CAAC,CAAC,EAAE,CAAC;QAEP,IAAI,YAAY,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACrC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;QAC7C,CAAC;QAED,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4BT,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;;;;CAW/B,CAAC;IACA,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,WAAmB;QACjD,IAAI,CAAC;YACH,MAAM,eAAe,GAAG,cAAI,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;YAC/D,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;gBACzC,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;gBACvD,OAAO,IAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC;YAC9C,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,wDAAwD;QAC1D,CAAC;QAED,4BAA4B;QAC5B,OAAO,IAAI,CAAC,kBAAkB,EAAE,CAAC;IACnC,CAAC;CACF;AApGD,kDAoGC"}

package/dist/utils/hybridAIClient.d.ts.map

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

package/dist/utils/hybridAIClient.js

@@ -39,6 +39,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.HybridAIClient = void 0;
 const claudeAgentClient_1 = require("./claudeAgentClient");
 const hostedApiClient_1 = require("./hostedApiClient");
+const openRouterClient_1 = require("./openRouterClient");
 const logger_1 = require("./logger");
 const chalk_1 = __importDefault(require("chalk"));
 const fs = __importStar(require("fs"));
@@ -120,6 +121,19 @@ class HybridAIClient {
                 isAvailable: () => claudeAgentClient.checkConnection(),
             });
         }
+        // OpenRouter (free tier - testing only)
+        const openRouterClient = new openRouterClient_1.OpenRouterClient();
+        if (openRouterClient.hasApiKey()) {
+            this.providers.push({
+                name: "openrouter",
+                priority: 3, // Lower than Claude/XAI, higher than hosted
+                client: openRouterClient,
+                isAvailable: () => openRouterClient.checkConnection(),
+            });
+            if (!HybridAIClient.hasLoggedInitialization) {
+                console.log(chalk_1.default.blue("🆓 Using OpenRouter free tier (DeepSeek-R1)"));
+            }
+        }
         // Sort providers by priority (lower number = higher priority)
         this.providers.sort((a, b) => a.priority - b.priority);
         // Add hosted API as fallback if no local providers are available
@@ -239,6 +253,9 @@ class HybridAIClient {
             return (this.config?.xai?.models?.["text-generator"]?.name ||
                 "grok-4-fast-reasoning");
         }
+        if (provider.name === "openrouter") {
+            return "deepseek-ai/DeepSeek-R1";
+        }
         // Default model name
         return "qwen3-coder";
     }
@@ -455,6 +472,10 @@ class HybridAIClient {
                         model: modelName,
                     });
                 }
+                else if (provider.name === "openrouter") {
+                    const openRouterClient = provider.client;
+                    return await openRouterClient.generateText(prompt, options);
+                }
                 else if (provider.name === "hosted") {
                     const hostedClient = provider.client;
                     const response = await hostedClient.generateText(prompt, options);