cogxai 2.8.0

package/dist/core/inference.d.ts

@@ -0,0 +1,37 @@
+export type InferenceProvider = 'anthropic' | 'venice' | 'auto';
+export interface InferenceConfig {
+    /** Primary provider (default: 'auto' — tries Venice first, falls back to Anthropic) */
+    primary?: InferenceProvider;
+    /** Fallback provider if primary fails */
+    fallback?: InferenceProvider;
+    /** Venice model override */
+    veniceModel?: string;
+    /** Anthropic model override */
+    anthropicModel?: string;
+}
+export interface GenerateOptions {
+    /** User message/prompt */
+    userMessage: string;
+    /** Additional context to include */
+    context?: string;
+    /** Feature-specific instructions */
+    featureInstruction?: string;
+    /** System prompt override */
+    systemPrompt?: string;
+    /** Max tokens */
+    maxTokens?: number;
+    /** Force a specific provider */
+    provider?: InferenceProvider;
+}
+export declare function configureInference(config: InferenceConfig): void;
+export declare function getInferenceConfig(): InferenceConfig;
+/**
+ * Generate a response using the configured inference provider(s).
+ * Handles automatic fallback if primary fails.
+ */
+export declare function generate(opts: GenerateOptions): Promise<string>;
+/**
+ * Quick helper for simple prompts.
+ */
+export declare function ask(prompt: string, opts?: Partial<GenerateOptions>): Promise<string>;
+//# sourceMappingURL=inference.d.ts.map

package/dist/core/inference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inference.d.ts","sourceRoot":"","sources":["../../src/core/inference.ts"],"names":[],"mappings":"AAoBA,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEhE,MAAM,WAAW,eAAe;IAC9B,uFAAuF;IACvF,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAE5B,yCAAyC;IACzC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAE7B,4BAA4B;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,+BAA+B;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,0BAA0B;IAC1B,WAAW,EAAE,MAAM,CAAC;IAEpB,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,oCAAoC;IACpC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B,6BAA6B;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,iBAAiB;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CAC9B;AAOD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAGhE;AAED,wBAAgB,kBAAkB,IAAI,eAAe,CAEpD;AAED;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAsBrE;AAyED;;GAEG;AACH,wBAAsB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAE1F"}

package/dist/core/inference.js

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configureInference = configureInference;
+exports.getInferenceConfig = getInferenceConfig;
+exports.generate = generate;
+exports.ask = ask;
+const logger_1 = require("./logger");
+const claude_client_1 = require("./claude-client");
+const venice_client_1 = require("./venice-client");
+const log = (0, logger_1.createChildLogger)('inference');
+let inferenceConfig = {
+    primary: 'auto',
+    fallback: 'anthropic',
+};
+function configureInference(config) {
+    inferenceConfig = { ...inferenceConfig, ...config };
+    log.info({ primary: inferenceConfig.primary, fallback: inferenceConfig.fallback }, 'Inference configured');
+}
+function getInferenceConfig() {
+    return inferenceConfig;
+}
+/**
+ * Generate a response using the configured inference provider(s).
+ * Handles automatic fallback if primary fails.
+ */
+async function generate(opts) {
+    const provider = opts.provider || inferenceConfig.primary || 'auto';
+    // Determine which providers to try
+    const providers = getProviderOrder(provider);
+    let lastError = null;
+    for (const p of providers) {
+        try {
+            const result = await generateWithProvider(p, opts);
+            if (result) {
+                log.debug({ provider: p }, 'Inference succeeded');
+                return result;
+            }
+        }
+        catch (err) {
+            lastError = err;
+            log.warn({ provider: p, error: err.message }, 'Provider failed, trying next');
+        }
+    }
+    throw lastError || new Error('All inference providers failed');
+}
+function getProviderOrder(provider) {
+    if (provider === 'auto') {
+        // Prefer Venice (decentralized) if available, fall back to Anthropic
+        const providers = [];
+        if ((0, venice_client_1.isVeniceEnabled)()) {
+            providers.push('venice');
+        }
+        providers.push('anthropic');
+        return providers;
+    }
+    const providers = [provider];
+    if (inferenceConfig.fallback && inferenceConfig.fallback !== provider) {
+        providers.push(inferenceConfig.fallback);
+    }
+    return providers;
+}
+async function generateWithProvider(provider, opts) {
+    switch (provider) {
+        case 'venice':
+            return generateWithVenice(opts);
+        case 'anthropic':
+            return generateWithAnthropic(opts);
+        default:
+            throw new Error(`Unknown provider: ${provider}`);
+    }
+}
+async function generateWithVenice(opts) {
+    if (!(0, venice_client_1.isVeniceEnabled)()) {
+        throw new Error('Venice not configured');
+    }
+    const messages = [];
+    // Build system prompt
+    let systemPrompt = opts.systemPrompt || 'You are CogxAI, an AI with persistent memory.';
+    if (opts.featureInstruction) {
+        systemPrompt += `\n\n${opts.featureInstruction}`;
+    }
+    // Add context if provided
+    let userContent = opts.userMessage;
+    if (opts.context) {
+        userContent = `${opts.context}\n\n---\n\n${opts.userMessage}`;
+    }
+    messages.push({ role: 'user', content: userContent });
+    return (0, venice_client_1.generateVeniceResponse)({
+        messages,
+        systemPrompt,
+        maxTokens: opts.maxTokens,
+        model: inferenceConfig.veniceModel,
+    });
+}
+async function generateWithAnthropic(opts) {
+    // Use existing Claude client
+    return (0, claude_client_1.generateResponse)({
+        userMessage: opts.userMessage,
+        context: opts.context,
+        featureInstruction: opts.featureInstruction,
+        maxTokens: opts.maxTokens,
+    });
+}
+/**
+ * Quick helper for simple prompts.
+ */
+async function ask(prompt, opts) {
+    return generate({ userMessage: prompt, ...opts });
+}
+//# sourceMappingURL=inference.js.map

package/dist/core/inference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inference.js","sourceRoot":"","sources":["../../src/core/inference.ts"],"names":[],"mappings":"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"}

package/dist/core/input-guardrails.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Input guardrails — detect and block manipulation attempts before processing.
+ * Protects against prompt injection, CA spoofing, and identity attacks.
+ */
+export interface InputGuardrailResult {
+    safe: boolean;
+    reason?: string;
+    isCASpoofAttempt?: boolean;
+    spoofedAddress?: string;
+}
+/**
+ * Check incoming message for manipulation attempts.
+ * Returns { safe: false } if the message is trying to manipulate the bot.
+ */
+export declare function checkInput(text: string): InputGuardrailResult;
+/**
+ * Get a response to a CA spoofing attempt.
+ * Firm but not aggressive — don't engage with the manipulation.
+ */
+export declare function getCASpoofResponse(): string;
+//# sourceMappingURL=input-guardrails.d.ts.map

package/dist/core/input-guardrails.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-guardrails.d.ts","sourceRoot":"","sources":["../../src/core/input-guardrails.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAmBH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,CA8B7D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C"}

package/dist/core/input-guardrails.js

@@ -0,0 +1,59 @@
+"use strict";
+/**
+ * Input guardrails — detect and block manipulation attempts before processing.
+ * Protects against prompt injection, CA spoofing, and identity attacks.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkInput = checkInput;
+exports.getCASpoofResponse = getCASpoofResponse;
+const logger_1 = require("./logger");
+const tokenomics_1 = require("../knowledge/tokenomics");
+const log = (0, logger_1.createChildLogger)('input-guardrails');
+// Solana address pattern
+const SOLANA_ADDRESS_RE = /[1-9A-HJ-NP-Za-km-z]{32,44}/g;
+// Patterns that indicate CA manipulation attempts
+const CA_INJECTION_PATTERNS = [
+    /(?:your|the|cogxai'?s?)\s+(?:ca|contract|address|mint)\s+(?:is|was|should be|=)/i,
+    /(?:ca|contract|address)\s*[:=]\s*[1-9A-HJ-NP-Za-km-z]{32,44}/i,
+    /(?:remember|store|save|update|change|set)\s+(?:the\s+)?(?:ca|contract|address)/i,
+    /(?:new|real|actual|correct|official)\s+(?:ca|contract|address)/i,
+    /(?:here'?s?|this is)\s+(?:the|your|my)\s+(?:ca|contract|address)/i,
+];
+/**
+ * Check incoming message for manipulation attempts.
+ * Returns { safe: false } if the message is trying to manipulate the bot.
+ */
+function checkInput(text) {
+    const lower = text.toLowerCase();
+    // Check for CA manipulation patterns
+    for (const pattern of CA_INJECTION_PATTERNS) {
+        if (pattern.test(text)) {
+            // Extract any addresses in the message
+            const addresses = text.match(SOLANA_ADDRESS_RE) || [];
+            // If they're providing an address that's NOT the official CA, it's an attack
+            const foreignAddresses = addresses.filter(addr => addr !== tokenomics_1.COGXAI_CA);
+            if (foreignAddresses.length > 0) {
+                log.warn({
+                    text: text.slice(0, 200),
+                    spoofedAddress: foreignAddresses[0],
+                    pattern: pattern.source
+                }, 'INPUT GUARDRAIL: CA spoofing attempt detected');
+                return {
+                    safe: false,
+                    reason: 'ca_spoof_attempt',
+                    isCASpoofAttempt: true,
+                    spoofedAddress: foreignAddresses[0],
+                };
+            }
+        }
+    }
+    return { safe: true };
+}
+/**
+ * Get a response to a CA spoofing attempt.
+ * Firm but not aggressive — don't engage with the manipulation.
+ */
+function getCASpoofResponse() {
+    return `Nice try. The only CA I recognize is ${tokenomics_1.COGXAI_CA}. That's hardcoded, not up for debate.`;
+}
+//# sourceMappingURL=input-guardrails.js.map

package/dist/core/input-guardrails.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-guardrails.js","sourceRoot":"","sources":["../../src/core/input-guardrails.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AA8BH,gCA8BC;AAMD,gDAEC;AAlED,qCAA6C;AAC7C,wDAAoD;AAEpD,MAAM,GAAG,GAAG,IAAA,0BAAiB,EAAC,kBAAkB,CAAC,CAAC;AAElD,yBAAyB;AACzB,MAAM,iBAAiB,GAAG,8BAA8B,CAAC;AAEzD,kDAAkD;AAClD,MAAM,qBAAqB,GAAG;IAC5B,kFAAkF;IAClF,+DAA+D;IAC/D,iFAAiF;IACjF,iEAAiE;IACjE,mEAAmE;CACpE,CAAC;AASF;;;GAGG;AACH,SAAgB,UAAU,CAAC,IAAY;IACrC,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAEjC,qCAAqC;IACrC,KAAK,MAAM,OAAO,IAAI,qBAAqB,EAAE,CAAC;QAC5C,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACvB,uCAAuC;YACvC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAAC;YAEtD,6EAA6E;YAC7E,MAAM,gBAAgB,GAAG,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,KAAK,sBAAS,CAAC,CAAC;YAEtE,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAChC,GAAG,CAAC,IAAI,CAAC;oBACP,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;oBACxB,cAAc,EAAE,gBAAgB,CAAC,CAAC,CAAC;oBACnC,OAAO,EAAE,OAAO,CAAC,MAAM;iBACxB,EAAE,+CAA+C,CAAC,CAAC;gBAEpD,OAAO;oBACL,IAAI,EAAE,KAAK;oBACX,MAAM,EAAE,kBAAkB;oBAC1B,gBAAgB,EAAE,IAAI;oBACtB,cAAc,EAAE,gBAAgB,CAAC,CAAC,CAAC;iBACpC,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACxB,CAAC;AAED;;;GAGG;AACH,SAAgB,kBAAkB;IAChC,OAAO,wCAAwC,sBAAS,wCAAwC,CAAC;AACnG,CAAC"}

package/dist/core/logger.d.ts

@@ -0,0 +1,3 @@
+export declare const logger: any;
+export declare function createChildLogger(name: string): any;
+//# sourceMappingURL=logger.d.ts.map

package/dist/core/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/core/logger.ts"],"names":[],"mappings":"AA6BA,eAAO,MAAM,MAAM,KAIjB,CAAC;AAEH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,OAE7C"}

package/dist/core/logger.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = void 0;
+exports.createChildLogger = createChildLogger;
+// Lazy-load pino — SDK users don't need it installed
+let _logger = null;
+function getLogger() {
+    if (!_logger) {
+        try {
+            const pino = require('pino');
+            const logDestination = process.env.MCP_MODE === '1' ? 2 : 1;
+            _logger = pino({
+                level: process.env.LOG_LEVEL || 'info',
+                transport: process.env.NODE_ENV !== 'production'
+                    ? { target: 'pino/file', options: { destination: logDestination } }
+                    : undefined,
+            });
+        }
+        catch {
+            // pino not installed (SDK mode) — use console fallback
+            _logger = {
+                info: console.log,
+                warn: console.warn,
+                error: console.error,
+                debug: () => { },
+                fatal: console.error,
+                child: () => _logger,
+            };
+        }
+    }
+    return _logger;
+}
+exports.logger = new Proxy({}, {
+    get(_, prop) {
+        return getLogger()[prop];
+    },
+});
+function createChildLogger(name) {
+    return getLogger().child({ module: name });
+}
+//# sourceMappingURL=logger.js.map

package/dist/core/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/core/logger.ts"],"names":[],"mappings":";;;AAmCA,8CAEC;AArCD,qDAAqD;AACrD,IAAI,OAAO,GAAQ,IAAI,CAAC;AAExB,SAAS,SAAS;IAChB,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;YAC7B,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC5D,OAAO,GAAG,IAAI,CAAC;gBACb,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM;gBACtC,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY;oBAC9C,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,WAAW,EAAE,cAAc,EAAE,EAAE;oBACnE,CAAC,CAAC,SAAS;aACd,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,uDAAuD;YACvD,OAAO,GAAG;gBACR,IAAI,EAAE,OAAO,CAAC,GAAG;gBACjB,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;gBACf,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO;aACrB,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAEY,QAAA,MAAM,GAAG,IAAI,KAAK,CAAC,EAAS,EAAE;IACzC,GAAG,CAAC,CAAC,EAAE,IAAI;QACT,OAAO,SAAS,EAAE,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;CACF,CAAC,CAAC;AAEH,SAAgB,iBAAiB,CAAC,IAAY;IAC5C,OAAO,SAAS,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AAC7C,CAAC"}

package/dist/core/memory-graph.d.ts

@@ -0,0 +1,126 @@
+import type { Memory, MemoryType } from './memory';
+export type EntityType = 'person' | 'project' | 'concept' | 'token' | 'wallet' | 'location' | 'event';
+export interface Entity {
+    id: number;
+    entity_type: EntityType;
+    name: string;
+    normalized_name: string;
+    aliases: string[];
+    description: string | null;
+    metadata: Record<string, unknown>;
+    mention_count: number;
+    first_seen: string;
+    last_seen: string;
+    embedding: number[] | null;
+}
+export interface EntityMention {
+    id: number;
+    entity_id: number;
+    memory_id: number;
+    context: string;
+    salience: number;
+    created_at: string;
+}
+export interface EntityRelation {
+    id: number;
+    source_entity_id: number;
+    target_entity_id: number;
+    relation_type: string;
+    strength: number;
+    evidence_memory_ids: number[];
+    created_at: string;
+}
+/**
+ * Find or create an entity by name.
+ * Deduplicates by normalized_name.
+ */
+export declare function findOrCreateEntity(name: string, entityType: EntityType, opts?: {
+    aliases?: string[];
+    description?: string;
+    metadata?: Record<string, unknown>;
+}): Promise<Entity | null>;
+/**
+ * Link an entity to a memory with context and salience.
+ */
+export declare function createEntityMention(entityId: number, memoryId: number, context: string, salience?: number): Promise<void>;
+/**
+ * Get all memories that mention an entity.
+ */
+export declare function getMemoriesByEntity(entityId: number, opts?: {
+    limit?: number;
+    memoryTypes?: MemoryType[];
+}): Promise<Memory[]>;
+/**
+ * Get all entities mentioned in a memory.
+ */
+export declare function getEntitiesInMemory(memoryId: number): Promise<Entity[]>;
+/**
+ * Find entities that frequently co-occur with a given entity across memories.
+ * Uses the get_entity_cooccurrence RPC to find related entities.
+ */
+export declare function getEntityCooccurrences(entityId: number, opts?: {
+    minCooccurrence?: number;
+    maxResults?: number;
+}): Promise<Array<{
+    related_entity_id: number;
+    cooccurrence_count: number;
+    avg_salience: number;
+}>>;
+/**
+ * Create or strengthen a relationship between two entities.
+ */
+export declare function createEntityRelation(sourceEntityId: number, targetEntityId: number, relationType: string, evidenceMemoryId?: number, strength?: number): Promise<void>;
+/**
+ * Simple rule-based entity extraction.
+ * For production, replace with NER model or LLM extraction.
+ */
+export declare function extractEntitiesFromText(text: string): Array<{
+    name: string;
+    type: EntityType;
+}>;
+/**
+ * Extract and link entities from a memory.
+ * Call this after storeMemory().
+ */
+export declare function extractAndLinkEntities(memoryId: number, content: string, summary: string, relatedUser?: string): Promise<void>;
+/**
+ * Get the full knowledge graph for visualization.
+ * Returns nodes (entities + optionally memories) and edges.
+ */
+export declare function getKnowledgeGraph(opts?: {
+    entityTypes?: EntityType[];
+    minMentions?: number;
+    includeMemories?: boolean;
+    limit?: number;
+}): Promise<{
+    nodes: Array<{
+        id: string;
+        type: string;
+        label: string;
+        size: number;
+    }>;
+    edges: Array<{
+        source: string;
+        target: string;
+        type: string;
+        weight: number;
+    }>;
+}>;
+/**
+ * Find entities similar to a query using vector search.
+ */
+export declare function findSimilarEntities(query: string, opts?: {
+    limit?: number;
+    entityTypes?: EntityType[];
+}): Promise<Entity[]>;
+export declare function getGraphStats(): Promise<{
+    entityCount: number;
+    relationCount: number;
+    mentionCount: number;
+    topEntities: Array<{
+        name: string;
+        type: string;
+        mentions: number;
+    }>;
+}>;
+//# sourceMappingURL=memory-graph.d.ts.map

package/dist/core/memory-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-graph.d.ts","sourceRoot":"","sources":["../../src/core/memory-graph.ts"],"names":[],"mappings":"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"}