vibefast-cli 0.2.4 → 0.3.1

package/2/packages/backend/convex/sharedUsers.ts

@@ -0,0 +1,48 @@
+import { getAuthUserId } from '@convex-dev/auth/server';
+import { v } from 'convex/values';
+
+import { internalQuery, query } from './_generated/server';
+
+/**
+ * Query to fetch the currently authenticated user's data.
+ * Returns the user document if authenticated, null if unauthenticated.
+ * This demonstrates session awareness for the auth backend.
+ */
+export const viewer = query({
+  args: {},
+  handler: async (ctx) => {
+    const userId = await getAuthUserId(ctx);
+    if (!userId) {
+      return null;
+    }
+    const user = await ctx.db.get(userId);
+    return user;
+  },
+});
+
+/**
+ * Internal helper for server-side consumers (agent tools, actions) that need a
+ * sanitized snapshot of a user profile by ID.
+ */
+export const getPublicProfile = internalQuery({
+  args: {
+    userId: v.id('users'),
+  },
+  handler: async (ctx, { userId }) => {
+    const user = await ctx.db.get(userId);
+    if (!user) {
+      return null;
+    }
+
+    return {
+      name: user.name ?? null,
+      email: user.email ?? null,
+      credits: user.credits ?? 0,
+      joinedAt:
+        typeof user._creationTime === 'number'
+          ? new Date(user._creationTime).toISOString()
+          : null,
+      emailVerified: Boolean(user.emailVerified),
+    };
+  },
+});

package/2/packages/backend/convex/tools/index.ts

@@ -0,0 +1,18 @@
+// Central export for all available AI tools
+// This file makes it easy to add more tools in the future
+
+import { knowledgeRetrievalTool } from './knowledgeRetrieval';
+import { tavilySearchTool } from './tavilySearch';
+import { userProfileTool } from './userProfile';
+
+// Export all tools in a single object for easy access
+export const allTools = {
+  knowledgeRetrieval: knowledgeRetrievalTool,
+  tavilySearch: tavilySearchTool,
+  userProfile: userProfileTool,
+} as const;
+
+// Export individual tools for specific use cases
+export { knowledgeRetrievalTool } from './knowledgeRetrieval';
+export { tavilySearchTool } from './tavilySearch';
+export { userProfileTool } from './userProfile';

package/2/packages/backend/convex/tools/knowledgeRetrieval.ts

@@ -0,0 +1,92 @@
+import { createTool } from '@convex-dev/agent';
+import { z } from 'zod';
+
+import { api } from '../_generated/api';
+
+export const knowledgeRetrievalTool = createTool({
+  description:
+    'Search uploaded knowledge files and synthesize an answer with citations.',
+  args: z.object({
+    query: z.string().min(1).describe('Question or topic to search.'),
+    scope: z
+      .enum(['personal', 'global'])
+      .default('personal')
+      .describe(
+        'Whether to search personal uploads or the shared global knowledge base.',
+      ),
+    filter: z
+      .union([
+        z.object({
+          type: z.literal('filename'),
+          value: z.string(),
+        }),
+        z.object({
+          type: z.literal('category'),
+          value: z.union([z.string(), z.null()]),
+        }),
+      ])
+      .optional()
+      .describe('Optional filter to narrow search by filename or category.'),
+    limit: z
+      .number()
+      .min(1)
+      .max(20)
+      .default(10)
+      .describe('Maximum number of chunks to retrieve.'),
+    chunkContext: z
+      .object({
+        before: z.number().min(0).max(5).default(1),
+        after: z.number().min(0).max(5).default(1),
+      })
+      .default({ before: 1, after: 1 })
+      .describe('Number of neighboring chunks to include around matches.'),
+  }),
+  handler: async (ctx, args): Promise<string> => {
+    const prompt = args.query.trim();
+    if (!prompt) {
+      return 'Please provide a non-empty question for knowledge retrieval.';
+    }
+
+    const filter =
+      args.filter?.type === 'filename'
+        ? {
+            name: 'filename' as const,
+            value: args.filter.value,
+          }
+        : args.filter?.type === 'category'
+          ? {
+              name: 'category' as const,
+              value: args.filter.value,
+            }
+          : undefined;
+
+    const chunkContext = {
+      before: args.chunkContext?.before ?? 1,
+      after: args.chunkContext?.after ?? 1,
+    };
+
+    const result = (await ctx.runAction(api.ragKnowledge.askKnowledge, {
+      prompt,
+      globalNamespace: args.scope === 'global',
+      limit: args.limit,
+      chunkContext,
+      filter,
+    })) as {
+      answer: string;
+      files?: { filename: string; url: string | null }[];
+    };
+
+    if (!result.files || result.files.length === 0) {
+      return `${result.answer}\n\n_No supporting files were located._`;
+    }
+
+    const references = result.files
+      .map((file: { filename: string; url: string | null }, index: number) => {
+        const label = `[${index + 1}] ${file.filename}`;
+        return file.url ? `${label} — ${file.url}` : label;
+      })
+      .join('\n');
+
+    return `${result.answer}\n\n**References**\n${references}`;
+  },
+});

package/2/packages/backend/convex/tools/tavilySearch.ts

@@ -0,0 +1,83 @@
+import { createTool } from '@convex-dev/agent';
+import { z } from 'zod';
+
+import { internal } from '../_generated/api';
+import type { Id } from '../_generated/dataModel';
+
+/**
+ * Tavily search tool exposed to the Convex agent runtime.
+ * Uses the direct HTTP API to stay compatible with the Convex execution environment.
+ */
+export const tavilySearchTool = createTool({
+  description:
+    'Search the web with Tavily to retrieve up-to-date information. Best for news, recent events, or factual lookups.',
+  args: z.object({
+    query: z.string().describe('The query to send to Tavily.'),
+  }),
+  handler: async (ctx, { query }) => {
+    const userId = ctx.userId as Id<'users'> | undefined;
+    if (userId) {
+      await ctx.runMutation(internal.rateLimit.enforceTool, { userId });
+    }
+
+    const apiKey = process.env.TAVILY_API_KEY;
+    if (!apiKey) {
+      return 'Tavily search is unavailable because TAVILY_API_KEY is not configured.';
+    }
+
+    try {
+      const response = await fetch('https://api.tavily.com/search', {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+          Authorization: `Bearer ${apiKey}`,
+        },
+        body: JSON.stringify({
+          query,
+          max_results: 5,
+          search_depth: 'basic',
+          include_answer: false,
+          include_images: false,
+        }),
+      });
+
+      if (!response.ok) {
+        const errorText = await response.text();
+        throw new Error(
+          `Tavily API error: ${response.status} ${response.statusText} - ${errorText}`,
+        );
+      }
+
+      const searchResult = await response.json();
+
+      if (!searchResult.results || searchResult.results.length === 0) {
+        return `No Tavily results found for “${query}”.`;
+      }
+
+      const formattedResults = searchResult.results
+        .map(
+          (
+            result: {
+              title?: string;
+              url?: string;
+              content?: string;
+            },
+            index: number,
+          ) => {
+            const title = result.title ?? 'Untitled';
+            const url = result.url ?? 'No URL';
+            const content = result.content?.trim() || 'No summary available.';
+            return `${index + 1}. **${title}**\n   URL: ${url}\n   Summary: ${content}`;
+          },
+        )
+        .join('\n\n');
+
+      return `🌐 **Tavily Search Results for “${query}”**\n\n${formattedResults}`;
+    } catch (error) {
+      console.error('[Tavily Search Tool] Error performing search:', error);
+      return `Tavily search failed: ${
+        error instanceof Error ? error.message : 'Unknown error'
+      }`;
+    }
+  },
+});

package/2/packages/backend/convex/tools/userProfile.ts

@@ -0,0 +1,72 @@
+import { createTool } from '@convex-dev/agent';
+import { z } from 'zod';
+
+import { internal } from '../_generated/api';
+import type { Id } from '../_generated/dataModel';
+
+type PublicUserFields = {
+  name: string | null;
+  email: string | null;
+  credits: number;
+  joinedAt: string | null;
+  emailVerified: boolean;
+};
+
+type UserProfileToolResult =
+  | {
+      found: false;
+      reason: string;
+    }
+  | {
+      found: true;
+      profile: PublicUserFields;
+      guidance: string;
+    };
+
+/**
+ * Tool that surfaces the signed-in user's profile information so the agent can
+ * answer personalized questions (e.g. “How many credits do I have?”).
+ *
+ * The handler returns a sanitized payload – no phone numbers or internal IDs –
+ * and gracefully handles anonymous or missing profiles.
+ */
+export const userProfileTool = createTool({
+  description:
+    'Fetch the current signed-in user profile (name, email, credits, join date). Use when the user asks about their account details.',
+  args: z
+    .object({})
+    .describe('No input is required; the tool looks up the current user.'),
+  handler: async (ctx, _args): Promise<UserProfileToolResult> => {
+    const userId = ctx.userId as Id<'users'> | undefined;
+
+    if (!userId) {
+      return {
+        found: false,
+        reason:
+          'There is no signed-in user associated with this conversation, so profile data is unavailable.',
+      };
+    }
+
+    await ctx.runMutation(internal.rateLimit.enforceTool, {
+      userId,
+    });
+
+    const profile = await ctx.runQuery(internal.sharedUsers.getPublicProfile, {
+      userId,
+    });
+
+    if (!profile) {
+      return {
+        found: false,
+        reason: 'Could not locate the user record linked to this conversation.',
+      };
+    }
+
+    return {
+      found: true,
+      profile,
+      guidance:
+        'Summarize the profile in natural language. If fields are null, mention they are not provided. Use credits to answer balance questions.',
+    };
+  },
+});

package/2/packages/backend/convex/tsconfig.json

@@ -0,0 +1,25 @@
+{
+  /* This TypeScript project config describes the environment that
+   * Convex functions run in and is used to typecheck them.
+   * You can modify it, but some settings required to use Convex.
+   */
+  "compilerOptions": {
+    /* These settings are not required by Convex and can be modified. */
+    "allowJs": true,
+    "strict": true,
+    "skipLibCheck": true,
+    "jsx": "react",
+
+    /* These compiler options are required by Convex */
+    "target": "ESNext",
+    "lib": ["ES2021", "dom", "ES2023.Array"],
+    "forceConsistentCasingInFileNames": true,
+    "allowSyntheticDefaultImports": true,
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "isolatedModules": true,
+    "noEmit": true
+  },
+  "include": ["./**/*"],
+  "exclude": ["./_generated"]
+}

package/2/packages/backend/convex/users.ts

@@ -0,0 +1,54 @@
+import { v } from 'convex/values';
+
+import { internalMutation } from './_generated/server';
+
+/**
+ * Create or update a user with device-based credit assignment
+ */
+export const createUserWithDeviceCredits = internalMutation({
+  args: {
+    userId: v.id('users'),
+    deviceId: v.string(),
+    userData: v.object({
+      name: v.optional(v.string()),
+      email: v.optional(v.string()),
+      phone: v.optional(v.string()),
+      image: v.optional(v.string()),
+      emailVerificationTime: v.optional(v.number()),
+      phoneVerificationTime: v.optional(v.number()),
+      isAnonymous: v.optional(v.boolean()),
+      emailVerified: v.optional(v.number()),
+    }),
+  },
+  returns: v.object({
+    userId: v.id('users'),
+    creditsGranted: v.number(),
+  }),
+  handler: async (ctx, { userId, deviceId, userData }) => {
+    // Get initial credits based on device grant status - hardcode for now since internal import not working
+    const existingGrant = await ctx.db
+      .query('deviceGrants')
+      .withIndex('by_deviceId', (q) => q.eq('deviceId', deviceId))
+      .first();
+
+    const initialCredits: number = existingGrant ? 0 : 25;
+
+    // Update the user document with credits
+    await ctx.db.patch(userId, {
+      ...userData,
+      credits: initialCredits,
+    });
+
+    // If credits were granted, record the device grant
+    if (initialCredits > 0) {
+      await ctx.db.insert('deviceGrants', {
+        deviceId,
+        userId,
+        grantType: 'initial_free_tier',
+        grantedAt: Date.now(),
+      });
+    }
+
+    return { userId, creditsGranted: initialCredits };
+  },
+});

package/2/packages/backend/index.ts

@@ -0,0 +1,20 @@
+// Client-side exports for the frontend
+export {
+  ConvexProvider,
+  ConvexReactClient,
+  useAction,
+  useConvexAuth,
+  useMutation,
+  useQuery,
+} from 'convex/react';
+export type { FunctionReference } from 'convex/server';
+export { api } from './convex/_generated/api';
+export type { Doc, Id } from './convex/_generated/dataModel';
+
+// Type helper for getting function return types
+export type FunctionReturnType<
+  T extends FunctionReference<any, any, any, any, any, any, any>,
+> =
+  T extends FunctionReference<any, any, any, any, any, any, infer R>
+    ? R
+    : never;

package/2/packages/backend/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@vibefast/backend",
+  "version": "1.0.0",
+  "main": "index.ts",
+  "exports": {
+    "./_generated/api": "./convex/_generated/api.js",
+    "./_generated/dataModel": "./convex/_generated/dataModel.d.ts",
+    "./_generated/server": "./convex/_generated/server.d.ts",
+    "./react": "./index.ts",
+    ".": "./index.ts"
+  },
+  "scripts": {
+    "dev": "convex dev",
+    "dev:setup": "convex dev --configure --until-success"
+  },
+  "author": "",
+  "license": "ISC",
+  "description": "",
+  "devDependencies": {
+    "@types/node": "^24.3.0",
+    "typescript": "^5.9.2"
+  },
+  "dependencies": {
+    "@react-email/components": "^0.0.34",
+    "@react-email/render": "^1.1.2",
+    "@convex-dev/auth": "^0.0.87",
+    "@convex-dev/resend": "^0.1.12",
+    "@google/genai": "^1.28.0",
+    "convex": "^1.27.0",
+    "resend": "^4.8.0"
+  }
+}

package/2/packages/ui/README.md

@@ -0,0 +1,63 @@
+# Shared UI Package
+
+This package contains shared React Native components that work across both web (Next.js) and mobile (Expo) applications.
+
+## Components
+
+### SharedButton
+
+A cross-platform button component with variant support.
+
+**Props:**
+
+- `title` (string): Button text
+- `onPress` (() => void): Click/press handler
+- `variant` ('primary' | 'secondary'): Button style variant (default: 'primary')
+
+**Usage:**
+
+```tsx
+import { SharedButton } from 'ui';
+
+<SharedButton
+  title="Click Me"
+  onPress={() => console.log('Pressed!')}
+  variant="primary"
+/>;
+```
+
+### SharedCard
+
+A card component for displaying content with title, description, and emoji.
+
+**Props:**
+
+- `title` (string): Card title
+- `description` (string): Card description text
+- `emoji` (string): Emoji to display (default: '📦')
+
+**Usage:**
+
+```tsx
+import { SharedCard } from 'ui';
+
+<SharedCard
+  emoji="✨"
+  title="Card Title"
+  description="This is a description of the card content."
+/>;
+```
+
+## Development
+
+Build the package:
+
+```bash
+pnpm build
+```
+
+## Notes
+
+- All components use React Native primitives (View, Text, TouchableOpacity) for maximum compatibility
+- Styling is done with inline styles to ensure consistency across platforms
+- Components are fully typed with TypeScript

package/2/packages/ui/index.ts

@@ -0,0 +1 @@
+export * from './src/components';

package/2/packages/ui/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "ui",
+  "version": "0.1.0",
+  "private": true,
+  "main": "./index.ts",
+  "types": "./index.ts",
+  "exports": {
+    ".": "./index.ts"
+  },
+  "scripts": {
+    "build": "tsc"
+  },
+  "dependencies": {
+    "react": "19.1.0",
+    "react-native": "0.76.2"
+  },
+  "devDependencies": {
+    "@types/react": "^19",
+    "typescript": "^5"
+  }
+}

package/2/packages/ui/src/components/SharedButton.tsx

@@ -0,0 +1,31 @@
+import type React from 'react';
+import { Text, TouchableOpacity, View, type ViewStyle } from 'react-native';
+
+interface SharedButtonProps {
+  title: string;
+  onPress: () => void;
+  variant?: 'primary' | 'secondary';
+}
+
+export const SharedButton: React.FC<SharedButtonProps> = ({
+  title,
+  onPress,
+  variant = 'primary',
+}) => {
+  const buttonStyle: ViewStyle = {
+    paddingVertical: 12,
+    paddingHorizontal: 24,
+    borderRadius: 8,
+    alignItems: 'center',
+    justifyContent: 'center',
+    backgroundColor: variant === 'primary' ? '#3b82f6' : '#6b7280',
+  };
+
+  return (
+    <TouchableOpacity onPress={onPress} style={buttonStyle}>
+      <Text style={{ color: '#ffffff', fontSize: 16, fontWeight: '600' }}>
+        {title}
+      </Text>
+    </TouchableOpacity>
+  );
+};

package/2/packages/ui/src/components/SharedCard.tsx

@@ -0,0 +1,48 @@
+import type React from 'react';
+import { Text, View, type ViewStyle } from 'react-native';
+
+interface SharedCardProps {
+  title: string;
+  description: string;
+  emoji?: string;
+}
+
+export const SharedCard: React.FC<SharedCardProps> = ({
+  title,
+  description,
+  emoji = '📦',
+}) => {
+  const cardStyle: ViewStyle = {
+    backgroundColor: '#ffffff',
+    borderRadius: 12,
+    padding: 16,
+    shadowColor: '#000',
+    shadowOffset: { width: 0, height: 2 },
+    shadowOpacity: 0.1,
+    shadowRadius: 8,
+    elevation: 3,
+    borderWidth: 1,
+    borderColor: '#e5e7eb',
+  };
+
+  return (
+    <View style={cardStyle}>
+      <View
+        style={{
+          flexDirection: 'row',
+          alignItems: 'center',
+          gap: 8,
+          marginBottom: 8,
+        }}
+      >
+        <Text style={{ fontSize: 24 }}>{emoji}</Text>
+        <Text style={{ fontSize: 18, fontWeight: '700', color: '#111827' }}>
+          {title}
+        </Text>
+      </View>
+      <Text style={{ fontSize: 14, color: '#6b7280', lineHeight: 20 }}>
+        {description}
+      </Text>
+    </View>
+  );
+};

package/2/packages/ui/src/components/index.ts

@@ -0,0 +1,2 @@
+export { SharedButton } from './SharedButton';
+export { SharedCard } from './SharedCard';

package/2/packages/ui/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "composite": true,
+    "outDir": "dist",
+    "rootDir": "src"
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}