@recursorsdk/sdk 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,386 @@
+export interface IntentResponse {
+    action: string;
+    scope: string[];
+    constraints: Record<string, unknown>;
+    quality: string;
+    preserve_existing: boolean;
+    similar_past_requests: string[];
+}
+export interface ChatMessage {
+    role: string;
+    content: string;
+}
+export interface ChatGatewayResponse {
+    policy: Record<string, unknown>;
+    normalized_messages: ChatMessage[];
+    provider_response?: Record<string, unknown>;
+}
+export interface RoboticsGatewayResponse {
+    policy: Record<string, unknown>;
+    result: Record<string, unknown>;
+}
+export interface AVGatewayResponse {
+    policy: Record<string, unknown>;
+    result: Record<string, unknown>;
+}
+export interface IntentHistoryItem {
+    id: string;
+    text: string;
+    created_at: string;
+    project_id?: string | null;
+    tags?: string[];
+}
+export interface CorrectionResponseList {
+    corrections: unknown[];
+    total: number;
+    page: number;
+    page_size: number;
+}
+export interface UserRegister {
+    email: string;
+    password: string;
+    full_name?: string;
+    username: string;
+}
+export interface UserLogin {
+    email: string;
+    password: string;
+}
+export interface TokenResponse {
+    access_token: string;
+    refresh_token?: string;
+    token_type: string;
+    expires_in: number;
+}
+export interface UserProfile {
+    id: string;
+    email: string;
+    username: string;
+    full_name?: string;
+    role: string;
+    is_active: boolean;
+    is_verified: boolean;
+    created_at: string;
+    last_login?: string;
+}
+export interface UserResponse {
+    id: string;
+    email: string;
+    username: string;
+    full_name?: string;
+    created_at: string;
+}
+export interface UserUpdate {
+    full_name?: string;
+    username?: string;
+}
+export interface PasswordChange {
+    current_password: string;
+    new_password: string;
+}
+export interface APIKeyResponse {
+    api_key: string;
+    created_at: string;
+}
+export interface ProjectCreate {
+    name: string;
+    description?: string;
+    organization_id: string;
+    settings?: Record<string, unknown>;
+}
+export interface ProjectUpdate {
+    name?: string;
+    description?: string;
+    settings?: Record<string, unknown>;
+    is_active?: boolean;
+}
+export interface ProjectResponse {
+    id: string;
+    name: string;
+    description?: string;
+    organization_id: string;
+    created_by?: string;
+    api_key?: string;
+    is_active: boolean;
+    created_at: string;
+    updated_at: string;
+    settings?: Record<string, unknown>;
+}
+export interface OrganizationCreate {
+    name: string;
+    description?: string;
+}
+export interface OrganizationUpdate {
+    name?: string;
+    description?: string;
+}
+export interface OrganizationResponse {
+    id: string;
+    name: string;
+    slug: string;
+    description?: string;
+    created_by: string;
+    created_at: string;
+    updated_at: string;
+}
+export interface UsageStatsResponse {
+    api_calls: {
+        used: number;
+        limit: number;
+        percentage: number;
+    };
+    corrections: {
+        used: number;
+        limit: number;
+        percentage: number;
+    };
+    storage_gb: {
+        used: number;
+        limit: number;
+        percentage: number;
+    };
+    llm_tokens: {
+        used: number;
+        limit: number;
+        percentage: number;
+    };
+    cost: {
+        current_period: number;
+        estimated_monthly: number;
+    };
+    subscription: {
+        plan_name: string;
+        status: string;
+        billing_period: string;
+    };
+}
+export interface BillingPlanResponse {
+    id: string;
+    name: string;
+    slug: string;
+    description: string;
+    price_monthly: number;
+    price_yearly: number;
+    features: string[];
+}
+export interface NotificationResponse {
+    id: string;
+    type: string;
+    title: string;
+    message: string;
+    is_read: boolean;
+    created_at: string;
+}
+export type { WebSocketMessage, WebSocketEventHandler } from "./websocket.js";
+export { RecursorWebSocket } from "./websocket.js";
+export declare class RecursorSDK {
+    private baseUrl;
+    private apiKey?;
+    private accessToken?;
+    private timeoutMs;
+    private wsClient?;
+    constructor(options?: {
+        baseUrl?: string;
+        apiKey?: string;
+        accessToken?: string;
+        timeoutMs?: number;
+    });
+    setAccessToken(token: string): void;
+    setApiKey(key: string): void;
+    private headers;
+    private get;
+    private post;
+    private put;
+    private patch;
+    private delete;
+    checkHealth(): Promise<boolean>;
+    detectIntent(args: {
+        user_request: string;
+        current_file?: string;
+        user_id?: string;
+        project_id?: string;
+        tags?: string[];
+        similar_limit?: number;
+        organization_id?: string;
+    }): Promise<IntentResponse>;
+    getLLMGatewayPolicy(): Promise<Record<string, unknown>>;
+    gatewayChat(args: {
+        provider?: string;
+        model?: string;
+        messages: ChatMessage[];
+        call_provider?: boolean;
+        user_id?: string;
+        organization_id?: string;
+    }): Promise<ChatGatewayResponse>;
+    getRoboticsGatewayPolicy(): Promise<Record<string, unknown>>;
+    roboticsGatewayObserve(args: {
+        state: Record<string, unknown>;
+        command?: Record<string, unknown>;
+        environment?: Record<string, unknown>[];
+        user_id?: string;
+        organization_id?: string;
+    }): Promise<RoboticsGatewayResponse>;
+    getAvGatewayPolicy(): Promise<Record<string, unknown>>;
+    avGatewayObserve(args: {
+        sensors: Record<string, unknown>;
+        state: Record<string, unknown>;
+        action: Record<string, unknown>;
+        timestamp: number;
+        vehicle_id: string;
+        user_id?: string;
+        organization_id?: string;
+    }): Promise<AVGatewayResponse>;
+    getIntentHistory(limit?: number, project_id?: string): Promise<IntentHistoryItem[]>;
+    createCorrection(args: {
+        input_text: string;
+        output_text: string;
+        expected_output?: string;
+        context?: Record<string, unknown>;
+        correction_type?: string;
+        organization_id?: string;
+    }): Promise<Record<string, unknown>>;
+    listCorrections(args?: {
+        page?: number;
+        page_size?: number;
+        include_inactive?: boolean;
+        organization_id?: string;
+    }): Promise<CorrectionResponseList>;
+    searchCorrections(query: string, limit?: number, organization_id?: string): Promise<CorrectionResponseList>;
+    getAnalyticsDashboard(user_id: string, period?: string, project_id?: string): Promise<Record<string, unknown>>;
+    getTimeSaved(user_id: string, period?: string, project_id?: string): Promise<Record<string, unknown>>;
+    getQualityMetrics(user_id: string, period?: string, project_id?: string): Promise<Record<string, unknown>>;
+    getAIAgentMetrics(user_id: string, project_id?: string): Promise<Record<string, unknown>>;
+    correctCode(code: string, language: string, project_profile?: Record<string, unknown>): Promise<Record<string, unknown>>;
+    correctConfig(config: string, config_type: string): Promise<Record<string, unknown>>;
+    correctDocumentation(markdown: string, doc_type?: string): Promise<Record<string, unknown>>;
+    applyAutoCorrections(user_id: string, model_name: string, corrections: Array<Record<string, unknown>>): Promise<Record<string, unknown>>;
+    getTrustScore(user_id: string, model_name: string): Promise<number>;
+    submitFeedback(prediction_id: string, accepted: boolean): Promise<void>;
+    getAutoCorrectStats(user_id: string): Promise<Record<string, unknown>>;
+    getPatterns(user_id?: string): Promise<Array<Record<string, unknown>>>;
+    register(userData: UserRegister): Promise<UserResponse>;
+    login(credentials: UserLogin): Promise<TokenResponse>;
+    logout(): Promise<void>;
+    refreshToken(refreshToken: string): Promise<TokenResponse>;
+    getProfile(): Promise<UserProfile>;
+    updateProfile(updates: UserUpdate): Promise<UserProfile>;
+    changePassword(passwordChange: PasswordChange): Promise<void>;
+    generateApiKey(): Promise<APIKeyResponse>;
+    revokeApiKey(): Promise<void>;
+    getPasswordRequirements(): Promise<{
+        requirements: string[];
+        min_length: number;
+        max_length: number;
+    }>;
+    createProject(projectData: ProjectCreate): Promise<ProjectResponse>;
+    getProject(projectId: string): Promise<ProjectResponse>;
+    listProjects(organizationId?: string): Promise<ProjectResponse[]>;
+    updateProject(projectId: string, updates: ProjectUpdate): Promise<ProjectResponse>;
+    deleteProject(projectId: string): Promise<void>;
+    regenerateProjectApiKey(projectId: string): Promise<APIKeyResponse>;
+    getMcpConfig(projectId: string): Promise<Record<string, unknown>>;
+    getMcpStats(projectId: string): Promise<Record<string, unknown>>;
+    createOrganization(orgData: OrganizationCreate): Promise<OrganizationResponse>;
+    listOrganizations(): Promise<OrganizationResponse[]>;
+    getOrganization(orgId: string): Promise<OrganizationResponse>;
+    updateOrganization(orgId: string, updates: OrganizationUpdate): Promise<OrganizationResponse>;
+    addMemberToOrganization(orgId: string, userId: string): Promise<void>;
+    removeMemberFromOrganization(orgId: string, userId: string): Promise<void>;
+    getUsage(): Promise<UsageStatsResponse>;
+    getUsageHistory(days?: number, resourceType?: string): Promise<Record<string, unknown>>;
+    listBillingPlans(): Promise<BillingPlanResponse[]>;
+    getSubscription(): Promise<Record<string, unknown>>;
+    listNotifications(): Promise<NotificationResponse[]>;
+    markNotificationAsRead(notificationId: string): Promise<NotificationResponse>;
+    markAllNotificationsAsRead(): Promise<void>;
+    deleteNotification(notificationId: string): Promise<void>;
+    getSettings(): Promise<Record<string, unknown>>;
+    updateAccount(updates: {
+        full_name?: string;
+        email?: string;
+    }): Promise<Record<string, unknown>>;
+    updatePreferences(preferences: Record<string, unknown>): Promise<Record<string, unknown>>;
+    getGuidelines(): Promise<Record<string, unknown>>;
+    changePasswordViaSettings(passwordChange: PasswordChange): Promise<void>;
+    deleteAccount(confirm: boolean): Promise<void>;
+    listActivityLogs(page?: number, pageSize?: number): Promise<Record<string, unknown>>;
+    exportActivityLogs(): Promise<Blob>;
+    getCorrection(correctionId: string): Promise<Record<string, unknown>>;
+    updateCorrection(correctionId: string, updates: Record<string, unknown>): Promise<Record<string, unknown>>;
+    getCorrectionStats(): Promise<Record<string, unknown>>;
+    /**
+     * Create WebSocket connection for real-time updates
+     * Requires access token (use login() first or setAccessToken())
+     */
+    createWebSocket(): Promise<import("./websocket").RecursorWebSocket>;
+    /**
+     * Connect WebSocket and return client
+     */
+    connectWebSocket(): Promise<import("./websocket").RecursorWebSocket>;
+    /**
+     * Disconnect WebSocket if connected
+     */
+    disconnectWebSocket(): void;
+    /**
+     * Create a conversation summary
+     */
+    createConversationSummary(data: {
+        conversation_id: string;
+        messages: Array<{
+            role: string;
+            content: string;
+        }>;
+        summary_text: string;
+        key_points?: string[];
+        topics?: string[];
+        metadata?: Record<string, any>;
+    }): Promise<any>;
+    /**
+     * Get a conversation summary by ID
+     */
+    getConversationSummary(conversationId: string): Promise<any>;
+    /**
+     * List recent conversation summaries
+     */
+    listConversationSummaries(params?: {
+        limit?: number;
+        days?: number;
+    }): Promise<any>;
+    /**
+     * Record an architectural change
+     */
+    recordArchitecturalChange(data: {
+        change_type: string;
+        component: string;
+        description: string;
+        before?: Record<string, any>;
+        after?: Record<string, any>;
+        impact?: string[];
+        metadata?: Record<string, any>;
+    }): Promise<any>;
+    /**
+     * List recent architectural changes
+     */
+    listArchitecturalChanges(params?: {
+        limit?: number;
+        days?: number;
+        change_type?: string;
+    }): Promise<any>;
+    /**
+     * Query rotatable memory patterns
+     */
+    queryRotatableMemory(params?: {
+        domain?: string;
+        pattern_type?: string;
+        min_effectiveness?: number;
+        limit?: number;
+    }): Promise<any>;
+    /**
+     * Record pattern usage and update effectiveness
+     */
+    recordPatternUsage(patternId: string, successful: boolean): Promise<any>;
+    /**
+     * Get rotatable memory statistics
+     */
+    getRotatableMemoryStats(): Promise<any>;
+}