@chainai/core 1.0.3 → 1.1.0

package/dist/services/ic-service.d.ts

@@ -1,47 +0,0 @@
-/**
- * IC Service - Manages connections to Internet Computer canisters
- */
-import type { ValidationResult, ResponseCustomization } from '../types';
-export interface ICServiceConfig {
-    host: string;
-    nlpEdgeCanisterId: string;
-    developerManagerCanisterId: string;
-}
-export declare class ICService {
-    private agent;
-    private nlpEdgeActor;
-    private developerManagerActor;
-    private config;
-    constructor(config: ICServiceConfig);
-    /**
-     * Validate an API key with the developer_manager canister
-     */
-    validateApiKey(apiKey: string): Promise<ValidationResult>;
-    /**
-     * Get response customization for an API key
-     */
-    getResponseCustomization(apiKey: string): Promise<ResponseCustomization | null>;
-    /**
-     * Set response customization for an API key
-     */
-    setResponseCustomization(apiKey: string, customization: Partial<ResponseCustomization>): Promise<{
-        ok: boolean;
-        message?: string;
-        error?: string;
-    }>;
-    /**
-     * Delete response customization (reset to defaults)
-     */
-    deleteResponseCustomization(apiKey: string): Promise<{
-        ok: boolean;
-        message?: string;
-    }>;
-    /**
-     * Get the NLP Edge actor for direct canister calls
-     */
-    getNLPEdgeActor(): any;
-    /**
-     * Get the Developer Manager actor for direct canister calls
-     */
-    getDeveloperManagerActor(): any;
-}

package/dist/services/ic-service.js

@@ -1,165 +0,0 @@
-"use strict";
-/**
- * IC Service - Manages connections to Internet Computer canisters
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ICService = void 0;
-const agent_1 = require("@dfinity/agent");
-const principal_1 = require("@dfinity/principal");
-// IDL factory for NLP Edge canister
-const createNLPEdgeIdl = (idlFactory) => {
-    const { IDL } = idlFactory;
-    // AIResponse type matches the canister's AIResponse record
-    const AIResponseType = IDL.Record({
-        'intent': IDL.Text,
-        'kind': IDL.Text,
-        'response': IDL.Text,
-        'toolData': IDL.Text,
-        'confidence': IDL.Nat,
-        'conversationId': IDL.Text,
-    });
-    // ChatResponse is Result<AIResponse, Text> = variant { ok: AIResponse; err: Text }
-    const ChatResponseType = IDL.Variant({
-        'ok': AIResponseType,
-        'err': IDL.Text,
-    });
-    return IDL.Service({
-        'chat': IDL.Func([IDL.Record({
-                'message': IDL.Text,
-                'conversationId': IDL.Text,
-                'language': IDL.Opt(IDL.Text),
-                'userContext': IDL.Opt(IDL.Text),
-                'apiKey': IDL.Opt(IDL.Text),
-            })], [ChatResponseType], []),
-        'health': IDL.Func([], [IDL.Text], ['query']),
-    });
-};
-// IDL factory for Developer Manager canister
-const createDeveloperManagerIdl = (idlFactory) => {
-    const { IDL } = idlFactory;
-    return IDL.Service({
-        'validateApiKey': IDL.Func([IDL.Text], [IDL.Text], ['query']),
-        'getResponseCustomization': IDL.Func([IDL.Text], [IDL.Text], ['query']),
-        'setResponseCustomization': IDL.Func([IDL.Text, IDL.Text, IDL.Text, IDL.Text, IDL.Text, IDL.Text, IDL.Text], [IDL.Text], []),
-        'deleteResponseCustomization': IDL.Func([IDL.Text], [IDL.Text], []),
-        'recordUsage': IDL.Func([IDL.Text], [], []),
-    });
-};
-class ICService {
-    constructor(config) {
-        this.config = config;
-        this.agent = new agent_1.HttpAgent({ host: config.host });
-        // For local development, fetch root key
-        if (config.host.includes('localhost') || config.host.includes('127.0.0.1')) {
-            this.agent.fetchRootKey().catch(console.warn);
-        }
-        // Create actors (using simplified IDL for now)
-        this.nlpEdgeActor = agent_1.Actor.createActor(createNLPEdgeIdl, {
-            agent: this.agent,
-            canisterId: principal_1.Principal.fromText(config.nlpEdgeCanisterId),
-        });
-        this.developerManagerActor = agent_1.Actor.createActor(createDeveloperManagerIdl, {
-            agent: this.agent,
-            canisterId: principal_1.Principal.fromText(config.developerManagerCanisterId),
-        });
-    }
-    /**
-     * Validate an API key with the developer_manager canister
-     */
-    async validateApiKey(apiKey) {
-        try {
-            const result = await this.developerManagerActor.validateApiKey(apiKey);
-            const parsed = JSON.parse(result);
-            if (parsed.ok) {
-                return {
-                    ok: true,
-                    developerId: parsed.developerId,
-                    tier: parsed.tier,
-                    rateLimit: parsed.rateLimit,
-                    hasCustomization: parsed.hasCustomization || false,
-                };
-            }
-            else {
-                return {
-                    ok: false,
-                    error: parsed.error,
-                };
-            }
-        }
-        catch (error) {
-            return {
-                ok: false,
-                error: error instanceof Error ? error.message : 'Unknown error',
-            };
-        }
-    }
-    /**
-     * Get response customization for an API key
-     */
-    async getResponseCustomization(apiKey) {
-        try {
-            const result = await this.developerManagerActor.getResponseCustomization(apiKey);
-            const parsed = JSON.parse(result);
-            if (parsed.ok && parsed.customization) {
-                return {
-                    apiKey,
-                    ...parsed.customization,
-                };
-            }
-            return null;
-        }
-        catch (error) {
-            console.error('Error fetching customization:', error);
-            return null;
-        }
-    }
-    /**
-     * Set response customization for an API key
-     */
-    async setResponseCustomization(apiKey, customization) {
-        try {
-            const styleText = customization.style || 'professional';
-            const lengthText = customization.length || 'medium';
-            const responseFormatText = customization.responseFormat || 'text';
-            const actionTemplatesJson = JSON.stringify(customization.actionTemplates || {});
-            const actionSchemasJson = JSON.stringify(customization.actionSchemas || {});
-            const dataFormatJson = JSON.stringify(customization.dataFormat || {});
-            const result = await this.developerManagerActor.setResponseCustomization(apiKey, styleText, lengthText, responseFormatText, actionTemplatesJson, actionSchemasJson, dataFormatJson);
-            return JSON.parse(result);
-        }
-        catch (error) {
-            return {
-                ok: false,
-                error: error instanceof Error ? error.message : 'Unknown error',
-            };
-        }
-    }
-    /**
-     * Delete response customization (reset to defaults)
-     */
-    async deleteResponseCustomization(apiKey) {
-        try {
-            const result = await this.developerManagerActor.deleteResponseCustomization(apiKey);
-            return JSON.parse(result);
-        }
-        catch (error) {
-            return {
-                ok: false,
-                message: error instanceof Error ? error.message : 'Unknown error',
-            };
-        }
-    }
-    /**
-     * Get the NLP Edge actor for direct canister calls
-     */
-    getNLPEdgeActor() {
-        return this.nlpEdgeActor;
-    }
-    /**
-     * Get the Developer Manager actor for direct canister calls
-     */
-    getDeveloperManagerActor() {
-        return this.developerManagerActor;
-    }
-}
-exports.ICService = ICService;

package/dist/services/nlp-service.d.ts

@@ -1,21 +0,0 @@
-/**
- * NLP Service - Handles chat requests and streaming responses
- */
-import type { ICService } from './ic-service';
-import type { ChatRequest, ChatResponse, StreamCallbacks } from '../types';
-export declare class NLPService {
-    private icService;
-    constructor(icService: ICService);
-    /**
-     * Send a chat message and get AI response
-     */
-    chat(request: ChatRequest): Promise<ChatResponse>;
-    /**
-     * Stream chat response word-by-word for better UX
-     */
-    streamChat(request: ChatRequest, callbacks: StreamCallbacks): Promise<void>;
-    /**
-     * Check canister health
-     */
-    health(): Promise<string>;
-}

package/dist/services/nlp-service.js

@@ -1,104 +0,0 @@
-"use strict";
-/**
- * NLP Service - Handles chat requests and streaming responses
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.NLPService = void 0;
-class NLPService {
-    constructor(icService) {
-        this.icService = icService;
-    }
-    /**
-     * Send a chat message and get AI response
-     */
-    async chat(request) {
-        const actor = this.icService.getNLPEdgeActor();
-        // Build user context with wallet information
-        const userContextData = {};
-        // Include legacy userContext if provided
-        if (request.userContext) {
-            Object.assign(userContextData, request.userContext);
-        }
-        // Include wallet context (this is the key addition for wallet addresses)
-        if (request.walletContext) {
-            userContextData.wallets = request.walletContext.wallets;
-            if (request.walletContext.activeChain) {
-                userContextData.activeChain = request.walletContext.activeChain;
-            }
-            if (request.walletContext.activeAddress) {
-                userContextData.activeAddress = request.walletContext.activeAddress;
-            }
-        }
-        const hasContext = Object.keys(userContextData).length > 0;
-        const chatRequest = {
-            message: request.text,
-            conversationId: request.conversationId || '',
-            language: request.language ? [request.language] : [],
-            userContext: hasContext ? [JSON.stringify(userContextData)] : [],
-            apiKey: request.apiKey ? [request.apiKey] : [],
-        };
-        try {
-            const result = await actor.chat(chatRequest);
-            if (result.ok) {
-                return {
-                    ok: true,
-                    data: {
-                        response: result.ok.response,
-                        intent: result.ok.intent,
-                        kind: result.ok.kind,
-                        toolData: result.ok.toolData,
-                        confidence: result.ok.confidence,
-                        conversationId: result.ok.conversationId,
-                    },
-                };
-            }
-            else {
-                return {
-                    ok: false,
-                    error: result.err,
-                };
-            }
-        }
-        catch (error) {
-            return {
-                ok: false,
-                error: error instanceof Error ? error.message : 'Unknown error',
-            };
-        }
-    }
-    /**
-     * Stream chat response word-by-word for better UX
-     */
-    async streamChat(request, callbacks) {
-        try {
-            // Send start event
-            callbacks.onChunk?.('');
-            const result = await this.chat(request);
-            if (result.ok && result.data) {
-                const response = result.data.response;
-                // Stream response word-by-word with 15ms delay
-                const words = response.split(' ');
-                for (let i = 0; i < words.length; i++) {
-                    const chunk = words[i] + (i < words.length - 1 ? ' ' : '');
-                    callbacks.onChunk?.(chunk);
-                    await new Promise(resolve => setTimeout(resolve, 15));
-                }
-                callbacks.onDone?.(result.data);
-            }
-            else {
-                callbacks.onError?.(result.error || 'An error occurred');
-            }
-        }
-        catch (error) {
-            callbacks.onError?.(error instanceof Error ? error.message : 'Unknown error');
-        }
-    }
-    /**
-     * Check canister health
-     */
-    async health() {
-        const actor = this.icService.getNLPEdgeActor();
-        return await actor.health();
-    }
-}
-exports.NLPService = NLPService;

package/dist/types/chat.d.ts

@@ -1,66 +0,0 @@
-/**
- * Chat request and response types for Chain AI
- */
-/**
- * Wallet address for a specific chain
- */
-export interface WalletAddress {
-    chain: 'ethereum' | 'bitcoin' | 'solana' | 'icp' | string;
-    address: string;
-    /** Optional label (e.g., "MetaMask", "Phantom") */
-    label?: string;
-    /** Whether this is the primary wallet for the chain */
-    isPrimary?: boolean;
-}
-/**
- * Wallet context included with each request
- * Contains all connected wallet addresses so the AI can access them
- * for queries like balance, transaction history, etc.
- */
-export interface WalletContext {
-    /** All connected wallet addresses */
-    wallets: WalletAddress[];
-    /** Currently active/selected chain (optional) */
-    activeChain?: string;
-    /** Currently active wallet address (optional) */
-    activeAddress?: string;
-}
-/**
- * Function type for dynamically fetching wallet addresses
- * Useful when wallet state may change between requests
- */
-export type WalletProvider = () => WalletContext | Promise<WalletContext>;
-export interface ChatRequest {
-    text: string;
-    conversationId?: string;
-    /** @deprecated Use walletContext instead for wallet data */
-    userContext?: any;
-    /** Wallet addresses to include with the request */
-    walletContext?: WalletContext;
-    language?: string;
-    apiKey?: string;
-}
-export interface AIResponse {
-    response: string;
-    intent: string;
-    kind: string;
-    toolData: string;
-    confidence: number;
-    conversationId: string;
-}
-export interface ChatResponse {
-    ok: boolean;
-    data?: AIResponse;
-    error?: string;
-}
-export interface Message {
-    id: string;
-    role: 'user' | 'assistant';
-    content: string;
-    timestamp: number;
-}
-export interface StreamCallbacks {
-    onChunk?: (chunk: string) => void;
-    onDone?: (data: AIResponse) => void;
-    onError?: (error: string) => void;
-}

package/dist/types/chat.js

@@ -1,5 +0,0 @@
-"use strict";
-/**
- * Chat request and response types for Chain AI
- */
-Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/customization.d.ts

@@ -1,55 +0,0 @@
-/**
- * Response customization types for Chain AI
- * Allows per-API-key customization of AI responses
- */
-export type ResponseStyle = 'professional' | 'casual' | 'technical' | 'friendly' | 'concise';
-export type ResponseLength = 'short' | 'medium' | 'detailed';
-export type ResponseFormat = 'text' | 'json' | 'hybrid';
-export type DateFormat = 'relative' | 'absolute' | 'both';
-export type AddressFormat = 'full' | 'truncated' | 'ens';
-export type NumberFormat = 'us' | 'eu' | 'scientific';
-export interface ActionSchema {
-    required: string[];
-    optional?: string[];
-    inferRules?: {
-        [field: string]: string;
-    };
-}
-export interface ActionSchemas {
-    send?: ActionSchema;
-    swap?: ActionSchema;
-    approve?: ActionSchema;
-    transfer?: ActionSchema;
-    stake?: ActionSchema;
-    [key: string]: ActionSchema | undefined;
-}
-export interface ActionTemplates {
-    send?: string;
-    swap?: string;
-    approve?: string;
-    price?: string;
-    balance?: string;
-    fees?: string;
-    transaction_status?: string;
-    transaction_history?: string;
-}
-export interface DataFormatOptions {
-    priceDecimals: number;
-    showUsdEquivalent: boolean;
-    dateFormat: DateFormat;
-    addressDisplay: AddressFormat;
-    numberFormat: NumberFormat;
-}
-export interface ResponseCustomization {
-    apiKey: string;
-    style: ResponseStyle;
-    length: ResponseLength;
-    responseFormat: ResponseFormat;
-    actionTemplates: ActionTemplates;
-    actionSchemas?: ActionSchemas;
-    dataFormat: DataFormatOptions;
-    createdAt: number;
-    updatedAt: number;
-}
-export declare const DEFAULT_ACTION_SCHEMAS: ActionSchemas;
-export declare const DEFAULT_CUSTOMIZATION: Omit<ResponseCustomization, 'apiKey' | 'createdAt' | 'updatedAt'>;

package/dist/types/customization.js

@@ -1,35 +0,0 @@
-"use strict";
-/**
- * Response customization types for Chain AI
- * Allows per-API-key customization of AI responses
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_CUSTOMIZATION = exports.DEFAULT_ACTION_SCHEMAS = void 0;
-// Example action schema for common wallet operations
-exports.DEFAULT_ACTION_SCHEMAS = {
-    send: {
-        required: ['amount', 'currency', 'address'],
-        optional: ['fee', 'memo'],
-        inferRules: {
-            chain: 'Infer from address format (e.g., bc1q... = Bitcoin, 0x... = Ethereum)',
-        },
-    },
-    swap: {
-        required: ['fromCurrency', 'toCurrency', 'amount'],
-        optional: ['slippage', 'deadline'],
-    },
-};
-exports.DEFAULT_CUSTOMIZATION = {
-    style: 'professional',
-    length: 'medium',
-    responseFormat: 'text',
-    actionTemplates: {},
-    actionSchemas: undefined, // Wallet providers can define their own
-    dataFormat: {
-        priceDecimals: 2,
-        showUsdEquivalent: true,
-        dateFormat: 'relative',
-        addressDisplay: 'truncated',
-        numberFormat: 'us',
-    },
-};

package/dist/types/index.d.ts

@@ -1,39 +0,0 @@
-/**
- * Main types export for @chainai/core
- */
-export type { ResponseCustomization, ResponseStyle, ResponseLength, ActionTemplates, DataFormatOptions, DateFormat, AddressFormat, NumberFormat, } from './customization';
-export { DEFAULT_CUSTOMIZATION } from './customization';
-export type { ChatRequest, ChatResponse, AIResponse, Message, StreamCallbacks, WalletAddress, WalletContext, WalletProvider, } from './chat';
-export interface ChainAIConfig {
-    apiKey: string;
-    host?: string;
-    nlpEdgeCanisterId?: string;
-    developerManagerCanisterId?: string;
-    /**
-     * Wallet provider function that returns connected wallet addresses.
-     * Called automatically before each request to include current wallet state.
-     *
-     * @example
-     * ```ts
-     * const config = {
-     *   apiKey: 'your-api-key',
-     *   walletProvider: () => ({
-     *     wallets: [
-     *       { chain: 'ethereum', address: '0x...', label: 'MetaMask' },
-     *       { chain: 'solana', address: 'ABC...', label: 'Phantom' },
-     *     ],
-     *     activeChain: 'ethereum',
-     *   }),
-     * };
-     * ```
-     */
-    walletProvider?: import('./chat').WalletProvider;
-}
-export interface ValidationResult {
-    ok: boolean;
-    developerId?: string;
-    tier?: string;
-    rateLimit?: number;
-    hasCustomization?: boolean;
-    error?: string;
-}

package/dist/types/index.js

@@ -1,8 +0,0 @@
-"use strict";
-/**
- * Main types export for @chainai/core
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_CUSTOMIZATION = void 0;
-var customization_1 = require("./customization");
-Object.defineProperty(exports, "DEFAULT_CUSTOMIZATION", { enumerable: true, get: function () { return customization_1.DEFAULT_CUSTOMIZATION; } });