society-protocol 1.0.0

package/dist/persona/embeddings.js

@@ -0,0 +1,265 @@
+import crypto from 'crypto';
+import { existsSync, readFileSync } from 'fs';
+import { dirname, join } from 'path';
+const DEFAULT_DIM = 384;
+const DEFAULT_MAX_TOKENS = 128;
+function normalize(values) {
+    const norm = Math.sqrt(values.reduce((acc, v) => acc + v * v, 0)) || 1;
+    return values.map((v) => v / norm);
+}
+function hashEmbedding(text, dim = DEFAULT_DIM) {
+    const out = new Array(dim).fill(0);
+    const tokens = text.toLowerCase().split(/\s+/).filter(Boolean);
+    if (tokens.length === 0)
+        return out;
+    for (const token of tokens) {
+        const digest = crypto.createHash('sha256').update(token).digest();
+        for (let i = 0; i < digest.length; i++) {
+            const idx = (digest[i] + i * 31) % dim;
+            out[idx] += ((digest[i] / 255) - 0.5) * 2;
+        }
+    }
+    return normalize(out);
+}
+export class PersonaEmbeddingService {
+    dim;
+    modelId;
+    onnxModelPath;
+    onnxVocabPath;
+    maxTokens;
+    onnxSession = null;
+    ort = null;
+    tokenizer = null;
+    initialized = false;
+    constructor(config = {}) {
+        this.dim = config.dim || DEFAULT_DIM;
+        this.modelId = config.modelId || 'all-MiniLM-L6-v2';
+        this.onnxModelPath = config.onnxModelPath || process.env.SOCIETY_PERSONA_ONNX_MODEL;
+        this.onnxVocabPath = config.onnxVocabPath || process.env.SOCIETY_PERSONA_ONNX_VOCAB;
+        this.maxTokens = Math.max(8, config.maxTokens || DEFAULT_MAX_TOKENS);
+        this.onnxSession = config.onnxSession || null;
+        this.tokenizer = config.tokenizer || null;
+    }
+    async embedText(text) {
+        await this.ensureInitialized();
+        if (this.onnxSession && this.tokenizer) {
+            try {
+                const vector = await this.embedWithOnnx(text);
+                return {
+                    vector,
+                    model: this.modelId,
+                    dim: this.dim,
+                    runtime: 'onnx',
+                };
+            }
+            catch (error) {
+                if (process.env.NODE_ENV === 'production') {
+                    throw new Error(`ONNX inference failed in production: ${error.message}`);
+                }
+            }
+        }
+        return {
+            vector: hashEmbedding(text, this.dim),
+            model: 'fallback-hash-v1',
+            dim: this.dim,
+            runtime: 'fallback-hash',
+        };
+    }
+    async ensureInitialized() {
+        if (this.initialized)
+            return;
+        this.initialized = true;
+        try {
+            if (this.onnxSession && this.tokenizer) {
+                return;
+            }
+            const dynamicImport = new Function('m', 'return import(m)');
+            const ort = await dynamicImport('onnxruntime-node');
+            if (!this.onnxModelPath) {
+                throw new Error('SOCIETY_PERSONA_ONNX_MODEL not configured');
+            }
+            const vocabPath = this.resolveVocabPath();
+            if (!vocabPath) {
+                throw new Error('SOCIETY_PERSONA_ONNX_VOCAB not configured and vocab.txt was not found near model');
+            }
+            this.ort = ort;
+            this.onnxSession = await ort.InferenceSession.create(this.onnxModelPath);
+            this.tokenizer = createWordPieceTokenizer(vocabPath);
+        }
+        catch (error) {
+            const isProd = process.env.NODE_ENV === 'production';
+            if (isProd) {
+                throw new Error(`ONNX runtime/model is required in production for Persona embeddings: ${error.message}`);
+            }
+            this.onnxSession = null;
+            this.ort = null;
+            this.tokenizer = null;
+        }
+    }
+    resolveVocabPath() {
+        if (this.onnxVocabPath && existsSync(this.onnxVocabPath)) {
+            return this.onnxVocabPath;
+        }
+        if (!this.onnxModelPath)
+            return undefined;
+        const candidate = join(dirname(this.onnxModelPath), 'vocab.txt');
+        if (existsSync(candidate))
+            return candidate;
+        return undefined;
+    }
+    makeIntTensor(values) {
+        if (!this.ort?.Tensor) {
+            return {
+                type: 'int64',
+                dims: [1, values.length],
+                data: BigInt64Array.from(values.map((v) => BigInt(v))),
+            };
+        }
+        return new this.ort.Tensor('int64', BigInt64Array.from(values.map((v) => BigInt(v))), [1, values.length]);
+    }
+    async embedWithOnnx(text) {
+        const encoded = this.tokenizer.encode(text, this.maxTokens);
+        const inputNames = Array.isArray(this.onnxSession.inputNames)
+            ? this.onnxSession.inputNames
+            : ['input_ids', 'attention_mask', 'token_type_ids'];
+        const feeds = {};
+        for (const name of inputNames) {
+            const lower = String(name).toLowerCase();
+            if (lower.includes('input') && lower.includes('id')) {
+                feeds[name] = this.makeIntTensor(encoded.inputIds);
+            }
+            else if (lower.includes('attention')) {
+                feeds[name] = this.makeIntTensor(encoded.attentionMask);
+            }
+            else if (lower.includes('token') && lower.includes('type')) {
+                feeds[name] = this.makeIntTensor(encoded.tokenTypeIds);
+            }
+            else {
+                feeds[name] = this.makeIntTensor(encoded.inputIds);
+            }
+        }
+        const outputs = await this.onnxSession.run(feeds);
+        const outputName = (Array.isArray(this.onnxSession.outputNames) && this.onnxSession.outputNames[0])
+            || Object.keys(outputs)[0];
+        const output = outputs[outputName];
+        if (!output) {
+            throw new Error('ONNX session returned no outputs');
+        }
+        const pooled = poolEmbedding(output, encoded.attentionMask);
+        return fitAndNormalize(pooled, this.dim);
+    }
+}
+export function vectorToJson(vector) {
+    return `[${vector.map((v) => Number.isFinite(v) ? Number(v.toFixed(8)) : 0).join(',')}]`;
+}
+function fitAndNormalize(values, dim) {
+    const out = values.length === dim
+        ? values
+        : values.length > dim
+            ? values.slice(0, dim)
+            : values.concat(new Array(dim - values.length).fill(0));
+    return normalize(out);
+}
+function poolEmbedding(tensor, attentionMask) {
+    const dataRaw = tensor?.data;
+    const dimsRaw = tensor?.dims;
+    const data = Array.from(dataRaw || []);
+    const dims = Array.isArray(dimsRaw) ? dimsRaw.map((d) => Number(d)) : [];
+    if (dims.length === 3) {
+        const seq = dims[1];
+        const hidden = dims[2];
+        const out = new Array(hidden).fill(0);
+        let count = 0;
+        for (let i = 0; i < seq; i++) {
+            if ((attentionMask[i] || 0) === 0)
+                continue;
+            count += 1;
+            const offset = i * hidden;
+            for (let h = 0; h < hidden; h++) {
+                out[h] += Number(data[offset + h] || 0);
+            }
+        }
+        if (count > 0) {
+            for (let h = 0; h < hidden; h++)
+                out[h] /= count;
+        }
+        return out;
+    }
+    if (dims.length === 2) {
+        const hidden = dims[1];
+        return data.slice(0, hidden).map((v) => Number(v || 0));
+    }
+    return data.map((v) => Number(v || 0));
+}
+function createWordPieceTokenizer(vocabPath) {
+    const lines = readFileSync(vocabPath, 'utf8')
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .filter(Boolean);
+    const vocab = new Map();
+    lines.forEach((token, index) => vocab.set(token, index));
+    const unk = vocab.get('[UNK]') ?? 100;
+    const cls = vocab.get('[CLS]') ?? 101;
+    const sep = vocab.get('[SEP]') ?? 102;
+    const pad = vocab.get('[PAD]') ?? 0;
+    return {
+        encode(text, maxTokens) {
+            const words = basicTokenize(text);
+            const pieces = [cls];
+            for (const word of words) {
+                const wordPieces = toWordPieces(word, vocab, unk);
+                for (const id of wordPieces) {
+                    if (pieces.length >= maxTokens - 1)
+                        break;
+                    pieces.push(id);
+                }
+                if (pieces.length >= maxTokens - 1)
+                    break;
+            }
+            pieces.push(sep);
+            const attentionMask = new Array(pieces.length).fill(1);
+            const tokenTypeIds = new Array(pieces.length).fill(0);
+            // Pad to stable shape for ONNX sessions with fixed max length.
+            while (pieces.length < maxTokens) {
+                pieces.push(pad);
+                attentionMask.push(0);
+                tokenTypeIds.push(0);
+            }
+            return {
+                inputIds: pieces,
+                attentionMask,
+                tokenTypeIds,
+            };
+        },
+    };
+}
+function basicTokenize(text) {
+    const matches = text.toLowerCase().match(/[a-z0-9]+|[^\s]/g);
+    return matches || [];
+}
+function toWordPieces(token, vocab, unkId) {
+    if (vocab.has(token)) {
+        return [vocab.get(token)];
+    }
+    const result = [];
+    let start = 0;
+    while (start < token.length) {
+        let end = token.length;
+        let piece;
+        while (start < end) {
+            const candidate = start === 0 ? token.slice(start, end) : `##${token.slice(start, end)}`;
+            if (vocab.has(candidate)) {
+                piece = candidate;
+                break;
+            }
+            end -= 1;
+        }
+        if (!piece) {
+            return [unkId];
+        }
+        result.push(vocab.get(piece));
+        start = end;
+    }
+    return result.length > 0 ? result : [unkId];
+}
+//# sourceMappingURL=embeddings.js.map

package/dist/persona/embeddings.js.map

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

package/dist/persona/engine.d.ts

@@ -0,0 +1,79 @@
+import { EventEmitter } from 'events';
+import type { Storage } from '../storage.js';
+import type { AddMemoryInput, CapabilityCaveats, CapabilityToken, CapabilityValidationInput, CapabilityValidationResult, ExportSubgraphInput, GenerateZkProofInput, GraphQueryInput, GraphQueryResult, IssueClaimInput, IssueCapabilityInput, LinkMemoryInput, MemoryQueryInput, MemoryQueryResult, PersonaClaim, PersonaEdge, PersonaNode, PersonaSyncDelta, PersonaVault, PortableSubgraph, RunRetentionSweepInput, RunRetentionSweepResult, SyncApplyResult, VerifyPersonaAccessLogInput, VerifyPersonaAccessLogResult, VerifyZkProofInput, UpdateMemoryInput, UpdatePreferenceInput, ZkProofBundle, ZkVerifyResult } from './types.js';
+export interface PersonaEngineConfig {
+    defaultVaultName?: string;
+    encryptionKey?: string;
+    shortTermWindow?: number;
+    emaAlpha?: number;
+    onnxModelPath?: string;
+}
+export declare class PersonaVaultEngine extends EventEmitter {
+    private storage;
+    private identityDid;
+    private capabilityManager;
+    private lifecycle;
+    private embeddings;
+    private zkp;
+    private encryptionKey;
+    private claimSigningSecret;
+    private graphRankCache;
+    constructor(storage: Storage, identityDid: string, config?: PersonaEngineConfig);
+    createVault(input: {
+        name: string;
+        ownerDid?: string;
+    }): Promise<PersonaVault>;
+    addMemory(input: AddMemoryInput): Promise<PersonaNode>;
+    updateMemory(nodeId: string, patch: UpdateMemoryInput): Promise<PersonaNode>;
+    deleteMemory(nodeId: string, _reason?: string): Promise<void>;
+    linkMemories(input: LinkMemoryInput): Promise<PersonaEdge>;
+    queryMemories(input: MemoryQueryInput): Promise<MemoryQueryResult>;
+    queryGraph(input: GraphQueryInput): Promise<GraphQueryResult>;
+    updatePreference(input: UpdatePreferenceInput): Promise<PersonaNode>;
+    verifyPersonaAccessLog(input: VerifyPersonaAccessLogInput): Promise<VerifyPersonaAccessLogResult>;
+    runRetentionSweep(input?: RunRetentionSweepInput): Promise<RunRetentionSweepResult>;
+    issueCapability(input: IssueCapabilityInput): Promise<CapabilityToken>;
+    attenuateCapability(input: {
+        tokenId: string;
+        caveatsPatch: Partial<CapabilityCaveats>;
+    }): Promise<CapabilityToken>;
+    revokeCapability(tokenId: string, reason: string): Promise<void>;
+    validateCapability(input: CapabilityValidationInput): CapabilityValidationResult;
+    issueClaim(input: IssueClaimInput): Promise<PersonaClaim>;
+    revokeClaim(claimId: string, _reason: string): Promise<void>;
+    generateZkProof(input: GenerateZkProofInput): Promise<ZkProofBundle>;
+    verifyZkProof(input: VerifyZkProofInput): Promise<ZkVerifyResult>;
+    applySyncDelta(delta: PersonaSyncDelta): Promise<SyncApplyResult>;
+    exportSubgraph(input: ExportSubgraphInput): Promise<PortableSubgraph>;
+    getProfile(vaultId?: string): Promise<Record<string, unknown>>;
+    listClaims(vaultId?: string, includeRevoked?: boolean): Promise<PersonaClaim[]>;
+    getClaim(claimId: string): Promise<PersonaClaim | undefined>;
+    listZkProofs(vaultId?: string): ZkProofBundle[];
+    getZkProof(proofId: string): ZkProofBundle | undefined;
+    listZkCircuits(): any[];
+    buildSyncDelta(input: {
+        vaultId: string;
+        operations: Array<{
+            type: 'node_upsert' | 'node_delete' | 'edge_upsert' | 'edge_delete' | 'capability_revoke' | 'capability_attenuate' | 'claim_upsert' | 'claim_revoke' | 'zkp_proof_upsert';
+            payload: Record<string, unknown>;
+        }>;
+        cursor?: string;
+        proofs?: ZkProofBundle[];
+    }): PersonaSyncDelta;
+    private resolveVaultId;
+    private ensureDefaultVault;
+    private bumpLifecycle;
+    private indexEmbedding;
+    private nextVectorRowId;
+    private upsertLocalDomainDoc;
+    private mergeCrdtDomainDoc;
+    private recordMetric;
+    private getOrBuildGraphRank;
+    private inflateNode;
+    private encrypt;
+    private decrypt;
+    private inflateClaim;
+    private detectProofSystem;
+}
+export default PersonaVaultEngine;
+//# sourceMappingURL=engine.d.ts.map

package/dist/persona/engine.d.ts.map

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