dpth 0.1.0

package/dist/agent-sdk.js

@@ -0,0 +1,367 @@
+/**
+ * dpth.io Agent SDK
+ *
+ * Simple client for agents to participate in the dpth.io network.
+ * Handles registration, heartbeat, task claiming, and result submission.
+ *
+ * Usage:
+ *   const agent = new DpthAgent({
+ *     name: 'my-agent',
+ *     apiUrl: 'https://fathom.gib.lol/api/dpth',
+ *     capabilities: { storageCapacityMb: 1000, cpuCores: 4, ... }
+ *   });
+ *
+ *   await agent.register();
+ *   await agent.startWorking();
+ */
+import { createHash, generateKeyPairSync } from 'crypto';
+// ─── Agent Class ─────────────────────────────────────
+export class DpthAgent {
+    config;
+    agentId = null;
+    publicKey;
+    privateKey;
+    running = false;
+    pollTimeout = null;
+    constructor(config) {
+        // Generate key pair if not provided
+        if (config.privateKey) {
+            this.privateKey = config.privateKey;
+            // Derive public key from private
+            this.publicKey = this.derivePublicKey(config.privateKey);
+        }
+        else {
+            const { publicKey, privateKey } = generateKeyPairSync('ed25519');
+            this.privateKey = privateKey.export({ type: 'pkcs8', format: 'pem' });
+            this.publicKey = publicKey.export({ type: 'spki', format: 'pem' });
+        }
+        this.config = {
+            ...config,
+            privateKey: this.privateKey,
+            pollIntervalMs: config.pollIntervalMs || 5000,
+            handlers: config.handlers || {},
+        };
+    }
+    derivePublicKey(privateKeyPem) {
+        // For ed25519, derive a compact public key identifier
+        const hash = createHash('sha256').update(privateKeyPem).digest('hex');
+        return `dpth:pub:${hash.slice(0, 32)}`;
+    }
+    /**
+     * Get a header-safe version of the public key (base64, no PEM wrapping)
+     */
+    getHeaderSafeKey() {
+        // Strip PEM headers and newlines for HTTP header compatibility
+        return this.publicKey
+            .replace(/-----BEGIN.*?-----/g, '')
+            .replace(/-----END.*?-----/g, '')
+            .replace(/\n/g, '')
+            .trim();
+    }
+    // ─── API Methods ─────────────────────────────────
+    async fetch(path, options) {
+        const url = `${this.config.apiUrl}${path}`;
+        const response = await fetch(url, {
+            ...options,
+            headers: {
+                'Content-Type': 'application/json',
+                'X-Agent-Id': this.agentId || '',
+                'X-Public-Key': this.getHeaderSafeKey(),
+                ...options?.headers,
+            },
+        });
+        return response;
+    }
+    /**
+     * Register this agent with the network
+     */
+    async register() {
+        const response = await this.fetch('/agents', {
+            method: 'POST',
+            body: JSON.stringify({
+                name: this.config.name,
+                publicKey: this.publicKey,
+                capabilities: this.config.capabilities,
+            }),
+        });
+        if (!response.ok) {
+            const error = await response.json();
+            throw new Error(`Registration failed: ${error.error || response.statusText}`);
+        }
+        const result = await response.json();
+        this.agentId = result.agent.id;
+        console.log(`[dpth] Agent registered: ${this.agentId}`);
+    }
+    /**
+     * Deregister from the network
+     */
+    async deregister() {
+        if (!this.agentId)
+            return;
+        await this.fetch(`/agents?id=${this.agentId}`, {
+            method: 'DELETE',
+        });
+        this.agentId = null;
+        console.log('[dpth] Agent deregistered');
+    }
+    /**
+     * Fetch available tasks
+     */
+    async getTasks(limit = 10) {
+        const types = this.config.capabilities.taskTypes.join(',');
+        const response = await this.fetch(`/tasks?limit=${limit}&type=${types}`);
+        if (!response.ok) {
+            throw new Error('Failed to fetch tasks');
+        }
+        const result = await response.json();
+        return result.tasks;
+    }
+    /**
+     * Claim a task for processing
+     */
+    async claimTask(taskId) {
+        const response = await this.fetch('/tasks?action=claim', {
+            method: 'POST',
+            body: JSON.stringify({
+                taskId,
+                agentId: this.agentId,
+            }),
+        });
+        if (!response.ok) {
+            const error = await response.json();
+            throw new Error(`Failed to claim task: ${error.error}`);
+        }
+        const result = await response.json();
+        return result.task;
+    }
+    /**
+     * Complete a task with results
+     */
+    async completeTask(taskId, result) {
+        const response = await this.fetch('/tasks?action=complete', {
+            method: 'POST',
+            body: JSON.stringify({
+                taskId,
+                agentId: this.agentId,
+                success: result.success,
+                output: result.output,
+            }),
+        });
+        if (!response.ok) {
+            throw new Error('Failed to complete task');
+        }
+    }
+    /**
+     * Store a chunk, returns CID
+     */
+    async storeChunk(data) {
+        const response = await this.fetch('/storage', {
+            method: 'POST',
+            body: JSON.stringify(data),
+        });
+        if (!response.ok) {
+            throw new Error('Failed to store chunk');
+        }
+        const result = await response.json();
+        return result.cid;
+    }
+    /**
+     * Retrieve a chunk by CID
+     */
+    async getChunk(cid) {
+        const response = await this.fetch(`/storage?cid=${cid}`);
+        if (!response.ok) {
+            throw new Error('Chunk not found');
+        }
+        return response.json();
+    }
+    /**
+     * Get pending storage proof challenges for this agent
+     */
+    async getPendingChallenges() {
+        const response = await this.fetch('/proofs?pending');
+        if (!response.ok) {
+            throw new Error('Failed to get pending challenges');
+        }
+        const result = await response.json();
+        return result.pending.filter((c) => c.agentId === this.agentId);
+    }
+    /**
+     * Submit a storage proof response
+     * @param challengeId The challenge ID
+     * @param proof SHA256(chunk_data + nonce)
+     */
+    async submitProof(challengeId, proof) {
+        const response = await this.fetch('/proofs?action=respond', {
+            method: 'POST',
+            body: JSON.stringify({
+                challengeId,
+                agentId: this.agentId,
+                proof,
+            }),
+        });
+        if (!response.ok) {
+            const error = await response.json();
+            throw new Error(`Proof submission failed: ${error.error}`);
+        }
+        return response.json();
+    }
+    /**
+     * Generate a proof for a chunk + nonce
+     * (Agents should use this to compute proofs from their local storage)
+     */
+    static computeProof(chunkData, nonce) {
+        // In browser/Node environments, use Web Crypto or Node crypto
+        // This is a placeholder - agents implement their own
+        const encoder = new TextEncoder();
+        const data = encoder.encode(chunkData + nonce);
+        // Note: Real implementation needs async crypto
+        // This is just to show the interface
+        throw new Error('Implement with crypto.subtle.digest or createHash');
+    }
+    // ─── Worker Loop ─────────────────────────────────
+    /**
+     * Start the work loop — continuously poll for and process tasks
+     */
+    async startWorking() {
+        if (this.running)
+            return;
+        if (!this.agentId) {
+            await this.register();
+        }
+        this.running = true;
+        console.log('[dpth] Starting work loop');
+        this.pollLoop();
+    }
+    /**
+     * Stop the work loop
+     */
+    stopWorking() {
+        this.running = false;
+        if (this.pollTimeout) {
+            clearTimeout(this.pollTimeout);
+            this.pollTimeout = null;
+        }
+        console.log('[dpth] Stopped work loop');
+    }
+    async pollLoop() {
+        if (!this.running)
+            return;
+        try {
+            // Fetch available tasks
+            const tasks = await this.getTasks(1);
+            if (tasks.length > 0) {
+                const task = tasks[0];
+                await this.processTask(task);
+            }
+        }
+        catch (error) {
+            console.error('[dpth] Error in poll loop:', error);
+        }
+        // Schedule next poll
+        this.pollTimeout = setTimeout(() => this.pollLoop(), this.config.pollIntervalMs);
+    }
+    async processTask(task) {
+        console.log(`[dpth] Processing task ${task.id} (${task.type})`);
+        try {
+            // Claim the task
+            const claimed = await this.claimTask(task.id);
+            // Get handler for task type
+            const handler = this.config.handlers[task.type];
+            if (!handler) {
+                throw new Error(`No handler for task type: ${task.type}`);
+            }
+            // Execute handler
+            const result = await handler(claimed);
+            // Complete the task
+            await this.completeTask(task.id, result);
+            console.log(`[dpth] Completed task ${task.id}`);
+        }
+        catch (error) {
+            console.error(`[dpth] Task ${task.id} failed:`, error);
+            // Report failure
+            await this.completeTask(task.id, {
+                success: false,
+                error: error instanceof Error ? error.message : 'Unknown error',
+            });
+        }
+    }
+    // ─── Utilities ───────────────────────────────────
+    /**
+     * Get the agent's public key (for verification)
+     */
+    getPublicKey() {
+        return this.publicKey;
+    }
+    /**
+     * Get the agent's ID (after registration)
+     */
+    getAgentId() {
+        return this.agentId;
+    }
+    /**
+     * Check if agent is registered
+     */
+    isRegistered() {
+        return this.agentId !== null;
+    }
+    /**
+     * Check if work loop is running
+     */
+    isWorking() {
+        return this.running;
+    }
+}
+// ─── Built-in Task Handlers ──────────────────────────
+/**
+ * Default embedding handler using OpenAI-compatible API
+ */
+export function createEmbedHandler(apiKey, model = 'text-embedding-3-small') {
+    return async (task) => {
+        const text = task.input.data;
+        const response = await fetch('https://api.openai.com/v1/embeddings', {
+            method: 'POST',
+            headers: {
+                'Authorization': `Bearer ${apiKey}`,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({
+                model,
+                input: text,
+            }),
+        });
+        if (!response.ok) {
+            throw new Error(`Embedding API failed: ${response.statusText}`);
+        }
+        const result = await response.json();
+        return {
+            success: true,
+            output: {
+                data: result.data[0].embedding,
+            },
+        };
+    };
+}
+/**
+ * Default extraction handler (simple regex-based)
+ */
+export function createExtractHandler() {
+    return async (task) => {
+        const text = task.input.data;
+        // Simple email extraction
+        const emails = text.match(/[\w.-]+@[\w.-]+\.\w+/g) || [];
+        // Simple number extraction
+        const numbers = text.match(/\$?[\d,]+\.?\d*/g) || [];
+        return {
+            success: true,
+            output: {
+                data: {
+                    emails,
+                    numbers,
+                    length: text.length,
+                },
+            },
+        };
+    };
+}
+//# sourceMappingURL=agent-sdk.js.map

package/dist/agent-sdk.js.map

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

package/dist/correlation.d.ts

@@ -0,0 +1,94 @@
+/**
+ * dpth.io Correlation Engine
+ *
+ * The magic sauce. Automatically discovers relationships between metrics
+ * across different data sources without explicit configuration.
+ *
+ * Key capabilities:
+ * - Pearson correlation for contemporaneous relationships
+ * - Cross-correlation for lagged/causal relationships
+ * - Anomaly detection via statistical analysis
+ * - Significance testing to filter noise
+ */
+import { Metric, MetricPoint, Pattern, CorrelationQuery } from './types.js';
+/**
+ * Register a metric for correlation analysis
+ */
+export declare function registerMetric(metric: Metric): void;
+/**
+ * Add data points to a metric
+ */
+export declare function addMetricPoints(metricId: string, points: MetricPoint[]): void;
+/**
+ * Get a metric by ID
+ */
+export declare function getMetric(id: string): Metric | undefined;
+/**
+ * List all metrics
+ */
+export declare function listMetrics(): Metric[];
+export interface CorrelationResult {
+    metricA: string;
+    metricB: string;
+    correlation: number;
+    lagDays: number;
+    pValue: number;
+    sampleSize: number;
+    direction: 'positive' | 'negative';
+}
+/**
+ * Calculate correlation between two metrics
+ */
+export declare function calculateCorrelation(metricIdA: string, metricIdB: string, lagDays?: number): CorrelationResult | null;
+/**
+ * Find all correlations for a metric
+ */
+export declare function findCorrelations(query: CorrelationQuery): CorrelationResult[];
+/**
+ * Discover all significant correlations in the system
+ */
+export declare function discoverAllCorrelations(minCorrelation?: number, maxLagDays?: number): CorrelationResult[];
+export interface AnomalyResult {
+    metricId: string;
+    timestamp: Date;
+    value: number;
+    expected: number;
+    stdDeviations: number;
+    severity: 'low' | 'medium' | 'high';
+}
+/**
+ * Detect anomalies in a metric using z-score
+ */
+export declare function detectAnomalies(metricId: string, threshold?: number): AnomalyResult[];
+/**
+ * Detect all anomalies across all metrics
+ */
+export declare function discoverAllAnomalies(threshold?: number): AnomalyResult[];
+export interface TrendResult {
+    metricId: string;
+    direction: 'up' | 'down' | 'stable';
+    slope: number;
+    rSquared: number;
+    changePercent: number;
+    period: {
+        start: Date;
+        end: Date;
+    };
+}
+/**
+ * Detect trend in a metric using linear regression
+ */
+export declare function detectTrend(metricId: string, periodDays?: number): TrendResult | null;
+/**
+ * Convert correlation results to Pattern format
+ */
+export declare function correlationToPattern(result: CorrelationResult): Pattern;
+/**
+ * Convert anomaly result to Pattern format
+ */
+export declare function anomalyToPattern(result: AnomalyResult): Pattern;
+/**
+ * Clear all metrics (for testing)
+ */
+export declare function clearMetrics(): void;
+//# sourceMappingURL=correlation.d.ts.map

package/dist/correlation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"correlation.d.ts","sourceRoot":"","sources":["../src/correlation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,MAAM,EACN,WAAW,EACX,OAAO,EAIP,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAOpB;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAEnD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI,CAO7E;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAExD;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,EAAE,CAEtC;AA0KD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,UAAU,GAAG,UAAU,CAAC;CACpC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,MAAU,GAClB,iBAAiB,GAAG,IAAI,CAsB1B;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,gBAAgB,GAAG,iBAAiB,EAAE,CAkD7E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,cAAc,GAAE,MAAY,EAC5B,UAAU,GAAE,MAAW,GACtB,iBAAiB,EAAE,CA+BrB;AAID,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,IAAI,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CACrC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,SAAS,GAAE,MAAY,GACtB,aAAa,EAAE,CA4BjB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,GAAE,MAAY,GAAG,aAAa,EAAE,CAiB7E;AAID,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,IAAI,GAAG,MAAM,GAAG,QAAQ,CAAC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE;QAAE,KAAK,EAAE,IAAI,CAAC;QAAC,GAAG,EAAE,IAAI,CAAA;KAAE,CAAC;CACpC;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,EAChB,UAAU,GAAE,MAAW,GACtB,WAAW,GAAG,IAAI,CA6DpB;AAID;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAqCvE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CA4B/D;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAEnC"}