@geenius/ai 0.1.0

package/packages/shared/src/types.ts

@@ -0,0 +1,501 @@
+// @geenius-ai/shared — src/types.ts
+
+// ============================================================================
+// Provider & Model Types
+// ============================================================================
+
+export type AIProviderType =
+    | 'openai'
+    | 'anthropic'
+    | 'google'
+    | 'nvidia'
+    | 'ollama'
+    | 'groq'
+    | 'together'
+    | 'elevenlabs'
+    | 'stability'
+    | 'replicate'
+    | 'fal'
+    | 'custom'
+
+export type AIGenerationType =
+    | 'text'
+    | 'image'
+    | 'audio'
+    | 'video'
+    | 'speech'
+    | 'transcription'
+    | 'embedding'
+    | 'vision'
+    | 'structured-output'
+    | 'image-edit'
+    | 'voice-clone'
+    | 'music'
+    | 'sound-effect'
+
+export type AIModelCapability =
+    | 'text'
+    | 'vision'
+    | 'image-generation'
+    | 'image-editing'
+    | 'audio-generation'
+    | 'speech-to-text'
+    | 'text-to-speech'
+    | 'video-generation'
+    | 'embedding'
+    | 'function-calling'
+    | 'streaming'
+    | 'structured-output'
+    | 'realtime-audio'
+    | 'voice-cloning'
+    | 'music-generation'
+    | 'sound-effects'
+
+export interface AIModel {
+    id: string
+    provider: AIProviderType
+    name: string
+    displayName?: string
+    capabilities: AIModelCapability[]
+    inputCostPer1k: number
+    outputCostPer1k: number
+    /** Fixed cost per call (e.g., image generation) */
+    costPerCall?: number
+    maxTokens?: number
+    contextWindow?: number
+    isActive: boolean
+    /** Metadata for specialized models */
+    meta?: Record<string, unknown>
+}
+
+export interface AIProviderConfig {
+    name: string
+    type: AIProviderType
+    baseUrl: string
+    apiKeyEnvVar: string
+    isActive: boolean
+    models: string[]
+    defaultModel?: string
+    headers?: Record<string, string>
+}
+
+// ============================================================================
+// Message & Conversation Types
+// ============================================================================
+
+export type AIMessageRole = 'system' | 'user' | 'assistant' | 'tool'
+
+export interface AIMessageContentPart {
+    type: 'text' | 'image_url' | 'audio' | 'video'
+    text?: string
+    image_url?: { url: string; detail?: 'low' | 'high' | 'auto' }
+    audio?: { data: string; format: 'mp3' | 'wav' | 'opus' }
+}
+
+export interface AIMessage {
+    role: AIMessageRole
+    content: string | AIMessageContentPart[]
+    tool_calls?: AIToolCall[]
+    tool_call_id?: string
+}
+
+export interface AIToolCall {
+    id: string
+    type: 'function'
+    function: { name: string; arguments: string }
+}
+
+export interface AIToolDefinition {
+    type: 'function'
+    function: {
+        name: string
+        description: string
+        parameters: Record<string, unknown>
+    }
+}
+
+export type AIConversationStatus = 'active' | 'archived'
+
+export interface AIConversation {
+    id: string
+    userId: string
+    title: string
+    model: string
+    systemPrompt?: string
+    status: AIConversationStatus
+    favorite: boolean
+    tags: string[]
+    folderId?: string
+    messageCount: number
+    createdAt: number
+    updatedAt: number
+}
+
+export interface AIChatMessage {
+    id: string
+    conversationId: string
+    userId: string
+    role: AIMessageRole
+    content: string
+    model?: string
+    tokens?: number
+    durationMs?: number
+    attachments?: AIAttachment[]
+    createdAt: number
+}
+
+export interface AIAttachment {
+    type: 'image' | 'audio' | 'video' | 'file'
+    url: string
+    name?: string
+    mimeType?: string
+    sizeBytes?: number
+}
+
+// ============================================================================
+// Generation Options & Results
+// ============================================================================
+
+export interface AIGenerateTextOptions {
+    model: string
+    messages: AIMessage[]
+    temperature?: number
+    maxTokens?: number
+    topP?: number
+    caller?: string
+    responseFormat?: any
+    stream?: boolean
+    tools?: AIToolDefinition[]
+    toolChoice?: 'auto' | 'none' | { type: 'function'; function: { name: string } }
+}
+
+export interface AIStructuredOutputOptions {
+    model: string
+    messages: AIMessage[]
+    schema: Record<string, unknown>
+    schemaName?: string
+    temperature?: number
+    maxTokens?: number
+    caller?: string
+}
+
+export interface AIGenerateImageOptions {
+    model?: string
+    prompt: string
+    negativePrompt?: string
+    n?: number
+    size?: string
+    quality?: 'standard' | 'hd'
+    style?: 'natural' | 'vivid'
+    responseFormat?: 'b64_json' | 'url'
+    /** Seed for reproducible generations */
+    seed?: number
+}
+
+export interface AIEditImageOptions {
+    model?: string
+    image: string  // base64
+    maskImage?: string  // base64
+    prompt: string
+    n?: number
+    size?: string
+}
+
+export interface AIGenerateAudioOptions {
+    model?: string
+    prompt: string
+    voice?: string
+    speed?: number
+    responseFormat?: 'mp3' | 'opus' | 'aac' | 'flac' | 'wav' | 'pcm'
+    /** ElevenLabs voice settings */
+    voiceSettings?: {
+        stability?: number
+        similarityBoost?: number
+        style?: number
+        useSpeakerBoost?: boolean
+    }
+}
+
+export interface AITranscribeOptions {
+    model?: string
+    audio: string  // base64
+    language?: string
+    prompt?: string
+    /** Return word-level timestamps */
+    timestampGranularities?: ('word' | 'segment')[]
+    responseFormat?: 'json' | 'text' | 'srt' | 'vtt' | 'verbose_json'
+}
+
+export interface AIGenerateVideoOptions {
+    model?: string
+    prompt: string
+    duration?: number
+    aspectRatio?: '16:9' | '9:16' | '1:1'
+    resolution?: '720p' | '1080p' | '4k'
+    /** Start image for image-to-video */
+    startImage?: string
+    /** End image for video interpolation */
+    endImage?: string
+}
+
+export interface AIEmbeddingOptions {
+    model?: string
+    input: string | string[]
+    dimensions?: number
+    encodingFormat?: 'float' | 'base64'
+}
+
+export interface AIGenerateMusicOptions {
+    model?: string
+    prompt: string
+    duration?: number
+    genre?: string
+    mood?: string
+    tempo?: number
+    instruments?: string[]
+}
+
+export interface AIGenerateSoundEffectOptions {
+    model?: string
+    prompt: string
+    duration?: number
+}
+
+export interface AIVoiceCloneOptions {
+    model?: string
+    name: string
+    /** Audio samples as base64 */
+    samples: string[]
+    description?: string
+}
+
+export interface AIGenerationResult {
+    content: string
+    model: string
+    provider: AIProviderType
+    type: AIGenerationType
+    tokens?: {
+        prompt: number
+        completion: number
+        total: number
+    }
+    cost?: {
+        input: number
+        output: number
+        total: number
+    }
+    durationMs: number
+    finishReason?: string
+    metadata?: Record<string, unknown>
+}
+
+export interface AIEmbeddingResult {
+    embeddings: number[][]
+    model: string
+    provider: AIProviderType
+    tokens: number
+    durationMs: number
+}
+
+export interface AITranscriptionResult {
+    text: string
+    language?: string
+    duration?: number
+    segments?: AITranscriptionSegment[]
+    words?: AITranscriptionWord[]
+}
+
+export interface AITranscriptionSegment {
+    id: number
+    start: number
+    end: number
+    text: string
+}
+
+export interface AITranscriptionWord {
+    word: string
+    start: number
+    end: number
+}
+
+// ============================================================================
+// Realtime Audio Types
+// ============================================================================
+
+export interface AIRealtimeConfig {
+    model?: string
+    voice?: string
+    instructions?: string
+    inputAudioFormat?: 'pcm16' | 'g711_ulaw' | 'g711_alaw'
+    outputAudioFormat?: 'pcm16' | 'g711_ulaw' | 'g711_alaw'
+    turnDetection?: {
+        type: 'server_vad'
+        threshold?: number
+        prefixPaddingMs?: number
+        silenceDurationMs?: number
+    }
+    tools?: AIToolDefinition[]
+}
+
+export type AIRealtimeEvent =
+    | { type: 'session.created' }
+    | { type: 'input_audio_buffer.speech_started' }
+    | { type: 'input_audio_buffer.speech_stopped' }
+    | { type: 'response.audio.delta'; delta: string }
+    | { type: 'response.audio.done' }
+    | { type: 'response.text.delta'; delta: string }
+    | { type: 'response.text.done'; text: string }
+    | { type: 'response.done'; usage?: { input_tokens: number; output_tokens: number } }
+    | { type: 'error'; error: { message: string; code?: string } }
+    | { type: 'input_audio_buffer.committed' }
+    | { type: 'conversation.item.created'; item: any }
+
+// ============================================================================
+// Logging Types
+// ============================================================================
+
+export type AIRequestStatus = 'success' | 'error'
+
+export interface AILogEntry {
+    requestId: string
+    model: string
+    provider: AIProviderType | string
+    caller: string
+    type: AIGenerationType | string
+    timestamp: number
+    durationMs: number
+    systemPrompt: string
+    userPrompt: string
+    hasImage: boolean
+    imageSizeBytes?: number
+    temperature?: number
+    maxTokens?: number
+    requestBodySize: number
+    status: AIRequestStatus
+    httpStatus: number
+    responseContent: string
+    responseSize: number
+    finishReason?: string
+    promptTokens?: number
+    completionTokens?: number
+    totalTokens?: number
+    errorMessage?: string
+    inputCostUsd?: number
+    outputCostUsd?: number
+    totalCostUsd?: number
+}
+
+// ============================================================================
+// Stats Types
+// ============================================================================
+
+export interface AIUsageStats {
+    totalCalls: number
+    successCalls: number
+    errorCalls: number
+    totalTokens: number
+    totalCostUsd: number
+    avgDurationMs: number
+    byModel: Record<string, { calls: number; tokens: number; cost: number }>
+    byProvider: Record<string, { calls: number; tokens: number; cost: number }>
+    byType: Record<string, { calls: number; tokens: number; cost: number }>
+    byDay: Array<{ date: string; calls: number; tokens: number; cost: number }>
+}
+
+// ============================================================================
+// Config Types
+// ============================================================================
+
+export interface AIConfig {
+    defaultProvider: AIProviderType
+    defaultModel: string
+    providers: AIProviderConfig[]
+    models: AIModel[]
+    logging: {
+        enabled: boolean
+        maxPromptLength: number
+        maxResponseLength: number
+    }
+    retries: {
+        maxAttempts: number
+        retryableStatusCodes: number[]
+        backoffMultiplierMs: number
+    }
+    /** Model defaults for each generation type */
+    generationDefaults?: {
+        image?: string
+        audio?: string
+        video?: string
+        embedding?: string
+        transcription?: string
+        music?: string
+    }
+}
+
+// ============================================================================
+// Component Props (shared across React / SolidJS)
+// ============================================================================
+
+export interface ChatWindowProps {
+    conversationId?: string
+    model?: string
+    systemPrompt?: string
+    className?: string
+    onNewConversation?: (id: string) => void
+}
+
+export interface ModelTestPageProps {
+    className?: string
+    defaultTab?: AIGenerationType
+}
+
+export interface AILogTableProps {
+    className?: string
+    limit?: number
+    filters?: {
+        model?: string
+        provider?: string
+        status?: AIRequestStatus
+        caller?: string
+        type?: AIGenerationType
+    }
+}
+
+export interface ImageGeneratorProps {
+    className?: string
+    models?: string[]
+    defaultModel?: string
+    onGenerate?: (result: AIGenerationResult) => void
+}
+
+export interface AudioPlayerProps {
+    className?: string
+    src: string
+    format?: string
+    autoPlay?: boolean
+}
+
+export interface VoiceSelectorProps {
+    className?: string
+    voices: AIVoiceOption[]
+    selectedVoice?: string
+    onSelect: (voiceId: string) => void
+}
+
+export interface AIVoiceOption {
+    id: string
+    name: string
+    provider: AIProviderType
+    language?: string
+    gender?: 'male' | 'female' | 'neutral'
+    preview?: string
+}
+
+export interface RealtimeAudioProps {
+    className?: string
+    model?: string
+    voice?: string
+    instructions?: string
+    onTranscript?: (text: string) => void
+    onResponse?: (text: string) => void
+}

package/packages/shared/tsconfig.json

@@ -0,0 +1,25 @@
+{
+    "compilerOptions": {
+        "target": "ES2022",
+        "module": "ESNext",
+        "moduleResolution": "bundler",
+        "declaration": true,
+        "declarationMap": true,
+        "sourceMap": true,
+        "outDir": "./dist",
+        "rootDir": "./src",
+        "strict": true,
+        "esModuleInterop": true,
+        "skipLibCheck": true,
+        "forceConsistentCasingInFileNames": true,
+        "resolveJsonModule": true,
+        "isolatedModules": true
+    },
+    "include": [
+        "src"
+    ],
+    "exclude": [
+        "node_modules",
+        "dist"
+    ]
+}

package/packages/shared/tsup.config.ts

@@ -0,0 +1,22 @@
+import { defineConfig } from 'tsup'
+
+export default defineConfig({
+    entry: {
+        index: 'src/index.ts',
+        config: 'src/config.ts',
+        'providers/index': 'src/providers/index.ts',
+        'convex/index': 'src/convex/index.ts',
+        content: 'src/content.ts',
+        memory: 'src/memory.ts',
+        skills: 'src/skills.ts',
+    },
+    format: ['esm'],
+    dts: true,
+    clean: true,
+    sourcemap: true,
+    external: [
+        'convex',
+        'convex/server',
+        'convex/values',
+    ],
+})

package/packages/shared/vitest.config.ts

@@ -0,0 +1,4 @@
+import { defineConfig } from 'vitest/config'
+export default defineConfig({
+  test: { globals: true, environment: 'node' },
+})

package/packages/solidjs/README.md

@@ -0,0 +1 @@
+# ✦ @geenius-ai/solidjs\n\n> SolidJS primitives, components, and pages for geenius-ai\n\n---\n\n## Overview\nBuilt with Steve Jobs-level minimalism and Jony Ive-level craftsmanship, this package is designed to deliver unparalleled developer experience (DX) and rock-solid performance.\n\n## Installation\n\n```bash\npnpm add @geenius-ai/solidjs\n```\n\n## Usage\n\n```typescript\nimport { init } from '@geenius-ai/solidjs';\n\n// Initialize the module with absolute precision\ninit({\n  mode: 'premium',\n});\n```\n\n## Architecture\n- **Zero-config**: It just works.\n- **Strictly Typed**: Fully written in TypeScript for flawless IntelliSense.\n- **Framework Agnostic**: seamlessly integrates into the Geenius ecosystem.\n\n---\n\n*Designed by Antigravity HQ*\n

package/packages/solidjs/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@geenius-ai/solidjs",
+  "version": "0.1.0",
+  "private": false,
+  "type": "module",
+  "description": "SolidJS primitives, components, and pages for geenius-ai",
+  "author": "Antigravity HQ",
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./primitives": {
+      "types": "./dist/primitives/index.d.ts",
+      "import": "./dist/primitives/index.js"
+    },
+    "./components": {
+      "types": "./dist/components/index.d.ts",
+      "import": "./dist/components/index.js"
+    },
+    "./pages": {
+      "types": "./dist/pages/index.d.ts",
+      "import": "./dist/pages/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "clean": "rm -rf dist",
+    "type-check": "tsc --noEmit",
+    "prepublishOnly": "pnpm clean && pnpm build"
+  },
+  "dependencies": {
+    "@geenius-ai/shared": "workspace:*"
+  },
+  "peerDependencies": {
+    "convex": ">=1.0.0",
+    "solid-js": ">=1.0.0"
+  },
+  "devDependencies": {
+    "convex": "^1.34.0",
+    "solid-js": "^1.9.0",
+    "tsup": "^8.5.1",
+    "typescript": "~6.0.2"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/packages/solidjs/src/components/ChatWindow.tsx

@@ -0,0 +1,78 @@
+// @geenius-ai/solidjs — src/components/ChatWindow.tsx
+
+/**
+ * SolidJS chat window component.
+ */
+
+import { createSignal, For, Show, type Component, type JSX } from 'solid-js'
+import type { AIChatMessage } from '@geenius-ai/shared'
+import { createChat, type CreateChatOptions } from '../primitives/createChat'
+
+export interface SolidChatWindowProps extends CreateChatOptions {
+    className?: string
+    renderMessage?: (message: AIChatMessage) => JSX.Element
+}
+
+export const ChatWindow: Component<SolidChatWindowProps> = (props) => {
+    const [input, setInput] = createSignal('')
+    const chat = createChat(props)
+
+    const handleSubmit = async (e: Event) => {
+        e.preventDefault()
+        const content = input().trim()
+        if (!content || chat.isSending()) return
+        setInput('')
+        await chat.sendMessage(content)
+    }
+
+    return (
+        <div class={props.className} data-ai-component="chat-window">
+            <div data-ai-messages>
+                <Show when={chat.messages().length === 0}>
+                    <div data-ai-empty><p>Start a conversation</p></div>
+                </Show>
+
+                <For each={chat.messages()}>
+                    {(msg) => props.renderMessage ? props.renderMessage(msg) : (
+                        <div data-ai-message data-ai-role={msg.role}>
+                            <div data-ai-message-role>{msg.role}</div>
+                            <div data-ai-message-content>{msg.content}</div>
+                        </div>
+                    )}
+                </For>
+
+                <Show when={chat.isSending()}>
+                    <div data-ai-message data-ai-role="assistant" data-ai-loading>
+                        <span>Thinking…</span>
+                    </div>
+                </Show>
+            </div>
+
+            <Show when={chat.error()}>
+                <div data-ai-error role="alert">
+                    <span>{chat.error()}</span>
+                    <button onClick={chat.clearError}>×</button>
+                </div>
+            </Show>
+
+            <form onSubmit={handleSubmit} data-ai-input-form>
+                <textarea
+                    value={input()}
+                    onInput={(e) => setInput(e.currentTarget.value)}
+                    placeholder="Type a message…"
+                    disabled={chat.isSending()}
+                    data-ai-input
+                    onKeyDown={(e) => {
+                        if (e.key === 'Enter' && !e.shiftKey) {
+                            e.preventDefault()
+                            handleSubmit(e)
+                        }
+                    }}
+                />
+                <button type="submit" disabled={chat.isSending() || !input().trim()} data-ai-send>
+                    {chat.isSending() ? 'Sending…' : 'Send'}
+                </button>
+            </form>
+        </div>
+    )
+}