luxlabs 1.0.4 → 1.0.6

package/commands/interface/boilerplate.js

@@ -3,24 +3,11 @@ const path = require('path');
 
 /**
  * Get the templates directory path
- * Tries multiple paths to support both:
- * - Electron app: electron/bin/lux-cli/commands/interface/ → 4 levels up
- * - npm package: luxlabs/commands/interface/ → 2 levels up
+ * Templates are stored in lux-cli/templates/interface-boilerplate
+ * This is the single source of truth - used by both CLI and Electron app
  */
 function getTemplatesDir() {
-  const candidates = [
-    path.join(__dirname, '../../../../templates/interface-boilerplate'),  // Electron app
-    path.join(__dirname, '../../templates/interface-boilerplate'),        // npm package
-  ];
-
-  for (const candidate of candidates) {
-    if (fs.existsSync(candidate)) {
-      return candidate;
-    }
-  }
-
-  // Return first candidate for error message
-  return candidates[0];
+  return path.join(__dirname, '../../templates/interface-boilerplate');
 }
 
 /**

package/commands/interface/init.js

@@ -157,14 +157,6 @@ async function initInterface(options) {
       console.log(chalk.yellow('  ⚠ Vercel project not created (may need VERCEL_TOKEN)'));
     }
 
-    // Output parseable format for API wrapper
-    console.log(`App created: ${interfaceId}`);
-    if (githubRepoUrl) {
-      console.log(`GitHub repo: ${githubRepoUrl}`);
-    }
-    if (vercelProjectId) {
-      console.log(`Vercel project: ${vercelProjectId}`);
-    }
     console.log(chalk.dim('─'.repeat(50)));
 
     // Set up local files and push to GitHub
@@ -315,6 +307,15 @@ async function initInterface(options) {
       }
       console.log(chalk.dim('─'.repeat(50)));
 
+      // Output parseable format for IPC handler AFTER all steps complete successfully
+      console.log(`App created: ${interfaceId}`);
+      if (githubRepoUrl) {
+        console.log(`GitHub repo: ${githubRepoUrl}`);
+      }
+      if (vercelProjectId) {
+        console.log(`Vercel project: ${vercelProjectId}`);
+      }
+
       console.log(chalk.green('\n✅ Interface created successfully!\n'));
       console.log(chalk.dim('  Created:'));
       console.log(chalk.dim('    • Registered in system.interfaces'));
@@ -332,6 +333,9 @@ async function initInterface(options) {
       console.log(chalk.dim('    • Edit your code'));
       console.log(chalk.dim('    • Run'), chalk.white('lux i deploy'), chalk.dim('to push to GitHub (auto-deploys to Vercel)\n'));
     } else {
+      // No GitHub URL - output parseable format anyway (cloud-only interface)
+      console.log(`App created: ${interfaceId}`);
+
       console.log(chalk.yellow('\n⚠ No GitHub URL returned - skipping local setup'));
       console.log(chalk.dim('\n  Created:'));
       console.log(chalk.dim('    • Registered in system.interfaces'));

package/commands/tools.js

@@ -0,0 +1,299 @@
+/**
+ * Tools CLI Commands
+ *
+ * List and manage AI tools (both default and custom) that agents can use.
+ */
+
+const axios = require('axios');
+const chalk = require('chalk');
+const {
+  getStudioApiUrl,
+  getProjectId,
+  isAuthenticated,
+  loadConfig,
+} = require('../lib/config');
+const {
+  error,
+  success,
+  info,
+  formatTable,
+} = require('../lib/helpers');
+
+/**
+ * Get auth headers for Studio API
+ */
+function getStudioAuthHeaders() {
+  const config = loadConfig();
+  if (!config || !config.apiKey || !config.orgId) {
+    return {};
+  }
+  return {
+    'Authorization': `Bearer ${config.apiKey}`,
+    'X-Org-Id': config.orgId,
+    'Content-Type': 'application/json',
+  };
+}
+
+/**
+ * Get tools API URL
+ */
+function getToolsApiUrl() {
+  const studioApiUrl = getStudioApiUrl();
+  const projectId = getProjectId();
+  if (!projectId) {
+    throw new Error('No project ID found. Run this command from a Lux Studio project directory.');
+  }
+  return `${studioApiUrl}/api/projects/${projectId}/tools`;
+}
+
+async function handleTools(args) {
+  // Check authentication
+  if (!isAuthenticated()) {
+    console.log(
+      chalk.red('❌ Not authenticated. Run'),
+      chalk.white('lux login'),
+      chalk.red('first.')
+    );
+    process.exit(1);
+  }
+
+  const command = args[0];
+
+  if (!command) {
+    console.log(`
+${chalk.bold('Usage:')} lux tools <command> [args]
+
+${chalk.bold('Commands:')}
+  list                    List all available tools (default + custom)
+  list-default            List only default (built-in) tools
+  list-custom             List only custom tools
+  get <tool-id>           Get details of a specific tool
+
+${chalk.bold('Options:')}
+  --json                  Output in JSON format
+
+${chalk.bold('Examples:')}
+  lux tools list
+  lux tools list-default
+  lux tools list-custom
+  lux tools get tool_abc123
+  lux tools list --json
+`);
+    process.exit(0);
+  }
+
+  const isJsonOutput = args.includes('--json');
+
+  try {
+    switch (command) {
+      case 'list': {
+        info('Loading tools...');
+        const toolsApiUrl = getToolsApiUrl();
+        const { data } = await axios.get(toolsApiUrl, {
+          headers: getStudioAuthHeaders(),
+        });
+
+        const tools = data.tools || [];
+
+        if (isJsonOutput) {
+          console.log(JSON.stringify(tools, null, 2));
+          return;
+        }
+
+        if (tools.length === 0) {
+          console.log('\n(No tools found)\n');
+          return;
+        }
+
+        const defaultTools = tools.filter(t => t.isDefault);
+        const customTools = tools.filter(t => !t.isDefault);
+
+        // Display default tools
+        if (defaultTools.length > 0) {
+          console.log(`\n${chalk.bold.cyan('Default Tools')} (${defaultTools.length}):\n`);
+          formatTable(defaultTools.map(t => ({
+            name: t.name,
+            method: t.httpMethod,
+            category: t.category || '-',
+            description: t.description?.substring(0, 60) + (t.description?.length > 60 ? '...' : '') || '-',
+          })));
+        }
+
+        // Display custom tools
+        if (customTools.length > 0) {
+          console.log(`\n${chalk.bold.green('Custom Tools')} (${customTools.length}):\n`);
+          formatTable(customTools.map(t => ({
+            id: t.id,
+            name: t.name,
+            method: t.httpMethod,
+            endpoint: t.apiEndpoint?.substring(0, 40) + (t.apiEndpoint?.length > 40 ? '...' : '') || '-',
+          })));
+        }
+
+        console.log(`\n${chalk.green('✓')} Total: ${tools.length} tool(s) (${defaultTools.length} default, ${customTools.length} custom)\n`);
+        break;
+      }
+
+      case 'list-default': {
+        info('Loading default tools...');
+        const toolsApiUrl = getToolsApiUrl();
+        const { data } = await axios.get(toolsApiUrl, {
+          headers: getStudioAuthHeaders(),
+        });
+
+        const defaultTools = (data.tools || []).filter(t => t.isDefault);
+
+        if (isJsonOutput) {
+          console.log(JSON.stringify(defaultTools, null, 2));
+          return;
+        }
+
+        if (defaultTools.length === 0) {
+          console.log('\n(No default tools found)\n');
+          return;
+        }
+
+        console.log(`\n${chalk.bold('Default Tools')} (${defaultTools.length}):\n`);
+
+        for (const tool of defaultTools) {
+          console.log(chalk.cyan(`  ${tool.name}`));
+          console.log(chalk.gray(`    ${tool.description || 'No description'}`));
+          console.log(chalk.gray(`    Method: ${tool.httpMethod} | Category: ${tool.category || 'General'}`));
+
+          // Show input parameters if available
+          if (tool.inputSchema?.properties) {
+            const params = Object.entries(tool.inputSchema.properties)
+              .filter(([key]) => !key.startsWith('orgId') && !key.startsWith('projectId'))
+              .map(([key, schema]) => {
+                const required = tool.inputSchema.required?.includes(key) ? '*' : '';
+                return `${key}${required}`;
+              });
+            if (params.length > 0) {
+              console.log(chalk.gray(`    Parameters: ${params.join(', ')}`));
+            }
+          }
+          console.log('');
+        }
+
+        console.log(`${chalk.green('✓')} ${defaultTools.length} default tool(s)\n`);
+        break;
+      }
+
+      case 'list-custom': {
+        info('Loading custom tools...');
+        const toolsApiUrl = getToolsApiUrl();
+        const { data } = await axios.get(toolsApiUrl, {
+          headers: getStudioAuthHeaders(),
+        });
+
+        const customTools = (data.tools || []).filter(t => !t.isDefault);
+
+        if (isJsonOutput) {
+          console.log(JSON.stringify(customTools, null, 2));
+          return;
+        }
+
+        if (customTools.length === 0) {
+          console.log('\n(No custom tools found)\n');
+          return;
+        }
+
+        console.log(`\n${chalk.bold('Custom Tools')} (${customTools.length}):\n`);
+
+        for (const tool of customTools) {
+          console.log(chalk.green(`  ${tool.name}`));
+          console.log(chalk.gray(`    ID: ${tool.id}`));
+          console.log(chalk.gray(`    ${tool.description || 'No description'}`));
+          console.log(chalk.gray(`    Endpoint: ${tool.httpMethod} ${tool.apiEndpoint}`));
+          if (tool.authCredentialType) {
+            console.log(chalk.gray(`    Auth: ${tool.authCredentialType}`));
+          }
+
+          // Show input parameters if available
+          if (tool.inputSchema?.properties) {
+            const params = Object.entries(tool.inputSchema.properties)
+              .filter(([key]) => !key.startsWith('orgId') && !key.startsWith('projectId'))
+              .map(([key, schema]) => {
+                const required = tool.inputSchema.required?.includes(key) ? '*' : '';
+                return `${key}${required}`;
+              });
+            if (params.length > 0) {
+              console.log(chalk.gray(`    Parameters: ${params.join(', ')}`));
+            }
+          }
+          console.log('');
+        }
+
+        console.log(`${chalk.green('✓')} ${customTools.length} custom tool(s)\n`);
+        break;
+      }
+
+      case 'get': {
+        const toolId = args[1];
+        if (!toolId) {
+          error('Missing tool ID. Usage: lux tools get <tool-id>');
+          return;
+        }
+
+        info(`Loading tool: ${toolId}`);
+        const toolsApiUrl = getToolsApiUrl();
+        const { data } = await axios.get(`${toolsApiUrl}/${toolId}`, {
+          headers: getStudioAuthHeaders(),
+        });
+
+        const tool = data.tool;
+
+        if (isJsonOutput) {
+          console.log(JSON.stringify(tool, null, 2));
+          return;
+        }
+
+        console.log(`\n${chalk.bold('Tool Details')}\n`);
+        console.log(`  Name: ${chalk.cyan(tool.name)}`);
+        console.log(`  ID: ${tool.id}`);
+        console.log(`  Type: ${tool.isDefault ? 'Default' : 'Custom'}`);
+        console.log(`  Description: ${tool.description || '-'}`);
+        console.log(`  Method: ${tool.httpMethod}`);
+        console.log(`  Endpoint: ${tool.apiEndpoint}`);
+        if (tool.category) {
+          console.log(`  Category: ${tool.category}`);
+        }
+        if (tool.authCredentialType) {
+          console.log(`  Auth: ${tool.authCredentialType}`);
+        }
+
+        // Show input schema
+        if (tool.inputSchema?.properties) {
+          console.log(`\n  ${chalk.bold('Parameters:')}`);
+          for (const [key, schema] of Object.entries(tool.inputSchema.properties)) {
+            if (key.startsWith('orgId') || key.startsWith('projectId')) {
+              continue; // Skip system params
+            }
+            const required = tool.inputSchema.required?.includes(key);
+            console.log(`    ${key} (${schema.type})${required ? chalk.red(' *required') : ''}`);
+            if (schema.description) {
+              console.log(chalk.gray(`      ${schema.description}`));
+            }
+            if (schema.enum) {
+              console.log(chalk.gray(`      Options: ${schema.enum.join(', ')}`));
+            }
+            if (schema.default !== undefined) {
+              console.log(chalk.gray(`      Default: ${schema.default}`));
+            }
+          }
+        }
+
+        console.log('');
+        break;
+      }
+
+      default:
+        error(`Unknown command: ${command}\n\nRun 'lux tools' to see available commands`);
+    }
+  } catch (err) {
+    const errorMessage = err.response?.data?.error || err.message || 'Unknown error';
+    error(errorMessage);
+  }
+}
+
+module.exports = { handleTools };

package/commands/workflows.js

@@ -249,19 +249,26 @@ ${chalk.bold('Examples:')}
           const now = new Date().toISOString();
 
           if (!localFlow) {
-            // New from cloud
+            // New from cloud - it's published, so set deploy snapshot
+            const cloudNodes = cloudFlow.config?.nodes || [];
+            const cloudEdges = cloudFlow.config?.edges || [];
             const newFlow = {
               id: cloudFlow.id,
               name: cloudFlow.name,
               description: cloudFlow.description,
-              nodes: cloudFlow.config?.nodes || [],
-              edges: cloudFlow.config?.edges || [],
+              nodes: cloudNodes,
+              edges: cloudEdges,
               localVersion: cloudFlow.version || 1,
               publishedVersion: cloudFlow.version || 1,
               cloudVersion: cloudFlow.version || 1,
               lastSyncedAt: now,
               createdAt: cloudFlow.updated_at || cloudFlow.created_at,
               updatedAt: cloudFlow.updated_at,
+              // Store deploy snapshot since this is a published flow
+              deployedNodes: JSON.parse(JSON.stringify(cloudNodes)),
+              deployedEdges: JSON.parse(JSON.stringify(cloudEdges)),
+              cloudPublishedAt: cloudFlow.updated_at || now,
+              cloudStatus: 'published',
             };
             saveLocalFlow(cloudFlow.id, newFlow);
             newFromCloud++;
@@ -288,18 +295,25 @@ ${chalk.bold('Examples:')}
               saveLocalFlow(cloudFlow.id, updatedFlow);
               conflicts++;
             } else if (cloudHasNewerVersion && !hasLocalChanges) {
-              // Update from cloud
+              // Update from cloud - replace with newer published version
+              const cloudNodes = cloudFlow.config?.nodes || [];
+              const cloudEdges = cloudFlow.config?.edges || [];
               const updatedFlow = {
                 ...localFlow,
                 name: cloudFlow.name,
                 description: cloudFlow.description,
-                nodes: cloudFlow.config?.nodes || [],
-                edges: cloudFlow.config?.edges || [],
+                nodes: cloudNodes,
+                edges: cloudEdges,
                 localVersion: cloudVersion,
                 publishedVersion: cloudVersion,
                 cloudVersion,
                 lastSyncedAt: now,
                 updatedAt: cloudFlow.updated_at,
+                // Update deploy snapshot to match new published version
+                deployedNodes: JSON.parse(JSON.stringify(cloudNodes)),
+                deployedEdges: JSON.parse(JSON.stringify(cloudEdges)),
+                cloudPublishedAt: cloudFlow.updated_at || now,
+                cloudStatus: 'published',
               };
               saveLocalFlow(cloudFlow.id, updatedFlow);
               synced++;
@@ -461,15 +475,23 @@ ${chalk.bold('Examples:')}
               );
 
               const newVersion = publishResponse.data.version || 1;
+              const now = new Date().toISOString();
 
               // Update local storage with published version and cloud ID
+              // IMPORTANT: This must match what the UI's markFlowPublished() does exactly
               const updatedFlow = {
                 ...newFlow,
                 cloudId: cloudId,
                 publishedVersion: newVersion,
                 cloudVersion: newVersion,
-                lastPublishedAt: new Date().toISOString(),
-                lastSyncedAt: new Date().toISOString(),
+                lastPublishedAt: now,
+                lastSyncedAt: now,
+                // Store snapshot of deployed config for change tracking
+                deployedNodes: JSON.parse(JSON.stringify(newFlow.nodes || [])),
+                deployedEdges: JSON.parse(JSON.stringify(newFlow.edges || [])),
+                // Cloud sync tracking - matches markFlowPublished()
+                cloudPublishedAt: now,
+                cloudStatus: 'published',
               };
               saveLocalFlow(flowId, updatedFlow);
 
@@ -580,15 +602,23 @@ ${chalk.bold('Examples:')}
         );
 
         const newVersion = data.version || (localFlow.publishedVersion || 0) + 1;
+        const now = new Date().toISOString();
 
         // Update local storage with new published version
+        // IMPORTANT: This must match what the UI's markFlowPublished() does exactly
         const updatedFlow = {
           ...localFlow,
           publishedVersion: newVersion,
           cloudVersion: newVersion,
-          lastPublishedAt: new Date().toISOString(),
-          lastSyncedAt: new Date().toISOString(),
+          lastPublishedAt: now,
+          lastSyncedAt: now,
           cloudData: undefined, // Clear any stored conflict data
+          // Store snapshot of deployed config for change tracking
+          deployedNodes: JSON.parse(JSON.stringify(localFlow.nodes || [])),
+          deployedEdges: JSON.parse(JSON.stringify(localFlow.edges || [])),
+          // Cloud sync tracking - matches markFlowPublished()
+          cloudPublishedAt: now,
+          cloudStatus: 'published',
         };
         saveLocalFlow(workflowId, updatedFlow);
 

package/lux.js

@@ -22,6 +22,7 @@ const { handleProject } = require('./commands/project');
 const { handleServers, handleLogs } = require('./commands/servers');
 const { handleTest } = require('./commands/webview');
 const { handleABTests } = require('./commands/ab-tests');
+const { handleTools } = require('./commands/tools');
 
 program
   .name('lux')
@@ -152,6 +153,15 @@ program
     handleABTests(subcommand ? [subcommand, ...(args || [])] : []);
   });
 
+// Tools commands - list AI tools (default and custom)
+program
+  .command('tools [subcommand] [args...]')
+  .description('AI tools management (list, list-default, list-custom, get)')
+  .allowUnknownOption()
+  .action((subcommand, args) => {
+    handleTools(subcommand ? [subcommand, ...(args || [])] : []);
+  });
+
 // Validate data-lux attributes
 program
   .command('validate-data-lux [interface-id]')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "luxlabs",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "description": "CLI tool for Lux - Upload and deploy interfaces from your terminal",
   "author": "Jason Henkel <jason@uselux.ai>",
   "license": "SEE LICENSE IN LICENSE",

package/templates/interface-boilerplate/app/layout.tsx

@@ -1,5 +1,7 @@
 import type { Metadata } from "next";
 import { Geist, Geist_Mono } from "next/font/google";
+import { Suspense } from "react";
+import { PostHogProvider, PostHogPageView } from "@/components/providers/posthog-provider";
 import "./globals.css";
 
 const geistSans = Geist({
@@ -27,7 +29,12 @@ export default function RootLayout({
       <body
         className={`${geistSans.variable} ${geistMono.variable} antialiased`}
       >
-        {children}
+        <PostHogProvider>
+          <Suspense fallback={null}>
+            <PostHogPageView />
+          </Suspense>
+          {children}
+        </PostHogProvider>
       </body>
     </html>
   );

package/templates/interface-boilerplate/components/providers/posthog-provider.tsx

@@ -0,0 +1,68 @@
+'use client'
+
+import posthog from 'posthog-js'
+import { PostHogProvider as PHProvider } from 'posthog-js/react'
+import { useEffect, useRef } from 'react'
+import { usePathname, useSearchParams } from 'next/navigation'
+
+const POSTHOG_KEY = process.env.NEXT_PUBLIC_POSTHOG_KEY
+const POSTHOG_HOST = process.env.NEXT_PUBLIC_POSTHOG_HOST || 'https://us.i.posthog.com'
+const LUX_INTERFACE_ID = process.env.NEXT_PUBLIC_LUX_INTERFACE_ID
+const LUX_ORG_ID = process.env.NEXT_PUBLIC_LUX_ORG_ID
+
+export function PostHogProvider({ children }: { children: React.ReactNode }) {
+  const initialized = useRef(false)
+
+  useEffect(() => {
+    if (!POSTHOG_KEY || initialized.current) {
+      if (!POSTHOG_KEY) {
+        console.log('[PostHog] No API key configured, skipping initialization')
+      }
+      return
+    }
+
+    posthog.init(POSTHOG_KEY, {
+      api_host: POSTHOG_HOST,
+      persistence: 'localStorage',
+      capture_pageview: false, // We capture manually for better control
+      capture_pageleave: true,
+      loaded: (ph) => {
+        // Register lux properties with all events for filtering
+        const props: Record<string, string> = {}
+        if (LUX_INTERFACE_ID) props.$lux_interface_id = LUX_INTERFACE_ID
+        if (LUX_ORG_ID) props.$lux_org_id = LUX_ORG_ID
+        if (Object.keys(props).length > 0) {
+          ph.register(props)
+        }
+      },
+    })
+
+    initialized.current = true
+  }, [])
+
+  if (!POSTHOG_KEY) {
+    return <>{children}</>
+  }
+
+  return <PHProvider client={posthog}>{children}</PHProvider>
+}
+
+export function PostHogPageView() {
+  const pathname = usePathname()
+  const searchParams = useSearchParams()
+
+  useEffect(() => {
+    if (!POSTHOG_KEY) return
+
+    const url = window.origin + pathname
+    const search = searchParams?.toString()
+    const fullUrl = search ? `${url}?${search}` : url
+
+    posthog.capture('$pageview', {
+      $current_url: fullUrl,
+      $pathname: pathname,
+    })
+  }, [pathname, searchParams])
+
+  return null
+}

package/templates/interface-boilerplate/package.json

@@ -11,6 +11,7 @@
   "dependencies": {
     "@radix-ui/react-slot": "^1.2.4",
     "better-auth": "^1.4.5",
+    "posthog-js": "^1.252.0",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "date-fns": "^4.1.0",