@jungjaehoon/mama-core 2.4.1 → 4.1.0

package/package.json

@@ -1,53 +1,39 @@
 {
   "name": "@jungjaehoon/mama-core",
-  "version": "2.4.1",
+  "version": "4.1.0",
   "description": "MAMA Core - Shared modules for Memory-Augmented MCP Assistant",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
     ".": "./dist/index.js",
-    "./embeddings": "./dist/embeddings.js",
-    "./embedding-cache": "./dist/embedding-cache.js",
-    "./embedding-client": "./dist/embedding-client.js",
-    "./embedding-server": "./dist/embedding-server/index.js",
+    "./embeddings": "./dist/embedding/embedder.js",
     "./memory/types": "./dist/memory/types.js",
-    "./memory-store": "./dist/memory-store.js",
     "./db-manager": "./dist/db-manager.js",
-    "./db-adapter": "./dist/db-adapter/index.js",
     "./mama-api": "./dist/mama-api.js",
-    "./config-loader": "./dist/config-loader.js",
     "./relevance-scorer": "./dist/relevance-scorer.js",
-    "./decision-tracker": "./dist/decision-tracker.js",
     "./debug-logger": "./dist/debug-logger.js",
     "./decision-formatter": "./dist/decision-formatter.js",
-    "./ollama-client": "./dist/ollama-client.js",
     "./errors": "./dist/errors.js",
-    "./time-formatter": "./dist/time-formatter.js",
-    "./outcome-tracker": "./dist/outcome-tracker.js",
-    "./query-intent": "./dist/query-intent.js",
-    "./test-utils": "./dist/test-utils.js",
-    "./entities/store": "./dist/entities/store.js",
-    "./entities/candidate-generator": "./dist/entities/candidate-generator.js",
     "./canonicalize": "./dist/canonicalize.js",
-    "./cases/types": "./dist/cases/types.js",
-    "./cases/store": "./dist/cases/store.js",
-    "./cases/search-rollup": "./dist/cases/search-rollup.js",
-    "./cases/timeline-range": "./dist/cases/timeline-range.js",
-    "./cases/wiki-page-index": "./dist/cases/wiki-page-index.js",
-    "./connectors": "./dist/connectors/event-index.js",
-    "./connectors/event-index": "./dist/connectors/event-index.js",
-    "./connectors/raw-query": "./dist/connectors/raw-query.js",
-    "./connectors/types": "./dist/connectors/types.js",
-    "./agent-situation": "./dist/agent-situation/index.js",
-    "./agent-graph": "./dist/agent-graph/index.js",
-    "./context-compile": "./dist/context-compile/index.js",
+    "./connectors": "./dist/knowledge/event-index.js",
+    "./connectors/event-index": "./dist/knowledge/event-index.js",
+    "./connectors/raw-query": "./dist/knowledge/raw-query.js",
     "./provenance/source-ref": "./dist/provenance/source-ref.js",
-    "./edges/types": "./dist/edges/types.js",
-    "./edges/store": "./dist/edges/store.js",
-    "./edges/ref-validation": "./dist/edges/ref-validation.js"
+    "./registry/store": "./dist/registry/store.js",
+    "./operations/owner-action-effects": "./dist/operations/owner-action-effects.js",
+    "./knowledge": "./dist/knowledge/index.js",
+    "./action-contracts": "./dist/action-contracts.js",
+    "./api/catalog": "./dist/api/catalog.js",
+    "./api/dispatch": "./dist/api/dispatch.js",
+    "./client/client": "./dist/client/client.js",
+    "./client/ipc": "./dist/client/ipc.js",
+    "./runtime/*": {
+      "types": "./dist/runtime/*.d.ts",
+      "default": "./dist/runtime/*.js"
+    }
   },
   "scripts": {
-    "build": "tsc",
+    "build": "node scripts/clean-dist.mjs && tsc",
     "build:watch": "tsc --watch",
     "test": "vitest run",
     "test:watch": "vitest watch",
@@ -83,12 +69,12 @@
   "dependencies": {
     "@huggingface/transformers": "^3.8.1",
     "better-sqlite3": "^12.8.0",
-    "ws": "^8.19.0"
+    "js-tiktoken": "^1.0.21",
+    "minimatch": "^10.1.1"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",
     "@types/node": "^22.0.0",
-    "@types/ws": "^8.18.1",
     "typescript": "^5.9.3",
     "vitest": "^1.0.0"
   },

package/dist/agent-graph/alias-write.d.ts

@@ -1,3 +0,0 @@
-import type { AgentGraphAdapter, AttachEntityAliasWithEdgeInput, AttachEntityAliasWithEdgeResult } from './types.js';
-export declare function attachEntityAliasWithEdge(adapter: AgentGraphAdapter, input: AttachEntityAliasWithEdgeInput): AttachEntityAliasWithEdgeResult;
-//# sourceMappingURL=alias-write.d.ts.map

package/dist/agent-graph/alias-write.js

@@ -1,234 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.attachEntityAliasWithEdge = attachEntityAliasWithEdge;
-const node_crypto_1 = require("node:crypto");
-const canonicalize_js_1 = require("../canonicalize.js");
-const ref_validation_js_1 = require("../edges/ref-validation.js");
-const store_js_1 = require("../edges/store.js");
-const types_js_1 = require("../edges/types.js");
-const normalization_js_1 = require("../entities/normalization.js");
-const store_js_2 = require("../entities/store.js");
-const errors_js_1 = require("./errors.js");
-const TWIN_REF_KIND_SET = new Set(types_js_1.TWIN_REF_KINDS);
-function stableAliasId(input, normalizedLabel) {
-    const replayKey = replayIdempotencyKey(input);
-    if (replayKey) {
-        const hash = (0, node_crypto_1.createHash)('sha256')
-            .update(`${input.entity_id}\0${normalizedLabel}\0${replayKey}`, 'utf8')
-            .digest('hex')
-            .slice(0, 32);
-        return `alias_${hash}`;
-    }
-    return `alias_${(0, node_crypto_1.randomUUID)().replace(/-/g, '')}`;
-}
-function replayIdempotencyKey(input) {
-    return input.edge_idempotency_key ?? input.request_idempotency_key;
-}
-function loadAlias(adapter, aliasId) {
-    const row = adapter.prepare('SELECT * FROM entity_aliases WHERE id = ?').get(aliasId);
-    if (!row) {
-        throw new Error(`Entity alias was not written: ${aliasId}`);
-    }
-    return {
-        id: String(row.id),
-        entity_id: String(row.entity_id),
-        label: String(row.label),
-        normalized_label: String(row.normalized_label),
-        lang: typeof row.lang === 'string' ? row.lang : null,
-        script: typeof row.script === 'string' ? row.script : null,
-        label_type: row.label_type,
-        source_type: String(row.source_type),
-        source_ref: typeof row.source_ref === 'string' ? row.source_ref : null,
-        confidence: typeof row.confidence === 'number' ? row.confidence : null,
-        status: row.status,
-        created_at: Number(row.created_at),
-    };
-}
-function normalizeConfidence(value) {
-    if (value === undefined || value === null) {
-        return 1;
-    }
-    if (typeof value === 'number' && Number.isFinite(value) && value >= 0 && value <= 1) {
-        return value;
-    }
-    throw new errors_js_1.AgentGraphValidationError(`confidence must be between 0 and 1: ${String(value)}`);
-}
-function selectExistingAliasEdge(adapter, modelRunId, edgeIdempotencyKey) {
-    if (!edgeIdempotencyKey) {
-        return null;
-    }
-    const row = adapter
-        .prepare(`
-        SELECT *
-        FROM twin_edges
-        WHERE model_run_id = ?
-          AND edge_idempotency_key = ?
-        LIMIT 1
-      `)
-        .get(modelRunId, edgeIdempotencyKey);
-    return row ? (0, store_js_1.mapTwinEdgeRow)(row) : null;
-}
-function normalizeSourceRefs(sourceRefs) {
-    if (!sourceRefs || sourceRefs.length === 0) {
-        return [];
-    }
-    const refs = [];
-    const seen = new Set();
-    for (const ref of sourceRefs) {
-        if (!ref ||
-            typeof ref !== 'object' ||
-            typeof ref.kind !== 'string' ||
-            typeof ref.id !== 'string' ||
-            ref.id.trim().length === 0 ||
-            !TWIN_REF_KIND_SET.has(ref.kind)) {
-            throw new errors_js_1.AgentGraphValidationError('source_refs must be TwinRef objects with kind and id.');
-        }
-        const normalized = { kind: ref.kind, id: ref.id.trim() };
-        const key = `${normalized.kind}:${normalized.id}`;
-        if (!seen.has(key)) {
-            seen.add(key);
-            refs.push(normalized);
-        }
-    }
-    return refs.sort((left, right) => `${left.kind}:${left.id}`.localeCompare(`${right.kind}:${right.id}`));
-}
-function expectedRelationAttrs(alias, sourceRefs) {
-    const attrs = {
-        alias_id: alias.id,
-        label: alias.label,
-        normalized_label: alias.normalized_label,
-        lang: alias.lang,
-        script: alias.script,
-        label_type: alias.label_type,
-    };
-    if (sourceRefs.length > 0) {
-        attrs.source_refs = sourceRefs.map((ref) => ({ kind: ref.kind, id: ref.id }));
-    }
-    return attrs;
-}
-function assertAliasReplayMatches(alias, input, normalized, confidence) {
-    const expectedScript = input.script ?? normalized.script;
-    const expectedLabelType = input.label_type ?? 'alt';
-    const expectedSourceRef = input.source_ref ?? null;
-    const matches = alias.entity_id === input.entity_id &&
-        alias.label === input.label &&
-        alias.normalized_label === normalized.normalized &&
-        alias.lang === (input.lang ?? null) &&
-        alias.script === expectedScript &&
-        alias.label_type === expectedLabelType &&
-        alias.source_type === input.source_type &&
-        alias.source_ref === expectedSourceRef &&
-        alias.confidence === confidence &&
-        alias.status === 'active';
-    if (!matches) {
-        throw new errors_js_1.AgentGraphValidationError(`Conflicting entity alias replay for request idempotency key: ${replayIdempotencyKey(input)}`);
-    }
-}
-function assertAliasEdgeReplayMatches(edge, input, alias, confidence, edgeIdempotencyKey, sourceRefs) {
-    const matches = edge.edge_type === 'alias_of' &&
-        edge.subject_ref.kind === 'entity' &&
-        edge.subject_ref.id === input.entity_id &&
-        edge.object_ref.kind === 'entity' &&
-        edge.object_ref.id === input.entity_id &&
-        edge.relation_attrs_json === (0, canonicalize_js_1.canonicalizeJSON)(expectedRelationAttrs(alias, sourceRefs)) &&
-        edge.confidence === confidence &&
-        edge.source === 'agent' &&
-        edge.agent_id === input.agent_id &&
-        edge.model_run_id === input.model_run_id &&
-        edge.envelope_hash === input.envelope_hash &&
-        edge.request_idempotency_key === (input.request_idempotency_key ?? null) &&
-        edge.edge_idempotency_key === (edgeIdempotencyKey ?? null);
-    if (!matches) {
-        throw new errors_js_1.AgentGraphValidationError(`Conflicting alias edge replay for request idempotency key: ${replayIdempotencyKey(input)}`);
-    }
-}
-function insertAliasEdge(adapter, input, alias, confidence, sourceRefs) {
-    const edgeIdempotencyKey = replayIdempotencyKey(input);
-    const existing = selectExistingAliasEdge(adapter, input.model_run_id, edgeIdempotencyKey);
-    const edgeId = `edge_${(0, node_crypto_1.randomUUID)().replace(/-/g, '')}`;
-    const relationAttrs = expectedRelationAttrs(alias, sourceRefs);
-    const relationAttrsJson = (0, canonicalize_js_1.canonicalizeJSON)(relationAttrs);
-    if (existing) {
-        assertAliasEdgeReplayMatches(existing, input, alias, confidence, edgeIdempotencyKey, sourceRefs);
-        return existing;
-    }
-    const contentHash = (0, node_crypto_1.createHash)('sha256')
-        .update((0, canonicalize_js_1.canonicalizeJSON)({
-        edge_type: 'alias_of',
-        subject_ref: { kind: 'entity', id: input.entity_id },
-        object_ref: { kind: 'entity', id: input.entity_id },
-        relation_attrs_json: relationAttrsJson,
-        confidence,
-        source: 'agent',
-        agent_id: input.agent_id,
-        model_run_id: input.model_run_id,
-        envelope_hash: input.envelope_hash,
-    }), 'utf8')
-        .digest();
-    adapter
-        .prepare(`
-        INSERT INTO twin_edges (
-          edge_id, edge_type, subject_kind, subject_id, object_kind, object_id,
-          relation_attrs_json, confidence, source, agent_id, model_run_id, envelope_hash,
-          request_idempotency_key, edge_idempotency_key, content_hash, created_at
-        )
-        VALUES (?, 'alias_of', 'entity', ?, 'entity', ?, ?, ?, 'agent', ?, ?, ?, ?, ?, ?, ?)
-      `)
-        .run(edgeId, input.entity_id, input.entity_id, relationAttrsJson, confidence, input.agent_id, input.model_run_id, input.envelope_hash, input.request_idempotency_key ?? null, edgeIdempotencyKey ?? null, contentHash, Date.now());
-    const row = adapter.prepare('SELECT * FROM twin_edges WHERE edge_id = ?').get(edgeId);
-    if (!row) {
-        throw new Error(`Entity alias edge was not written: ${edgeId}`);
-    }
-    return (0, store_js_1.mapTwinEdgeRow)(row);
-}
-function attachEntityAliasWithEdge(adapter, input) {
-    const entity = (0, store_js_2.getEntityNode)(input.entity_id, adapter);
-    if (!entity || entity.status !== 'active') {
-        throw new errors_js_1.AgentGraphValidationError(`Active entity not found: ${input.entity_id}`);
-    }
-    const visibility = {
-        scopes: input.scopes,
-        connectors: input.connectors,
-        projectRefs: input.project_refs,
-        tenantId: input.tenant_id,
-        // source_refs are caller-supplied, so this is the surface where naming a raw id from
-        // an ungranted channel would bind it to an entity the caller can read back.
-        ...(input.channels ? { channels: input.channels } : {}),
-    };
-    const sourceRefs = normalizeSourceRefs(input.source_refs);
-    if (sourceRefs.length === 0) {
-        throw new errors_js_1.AgentGraphValidationError('source_refs must include at least one visible source.');
-    }
-    try {
-        (0, ref_validation_js_1.assertTwinRefsVisible)(adapter, [{ kind: 'entity', id: input.entity_id }, ...sourceRefs], visibility);
-    }
-    catch (error) {
-        throw new errors_js_1.AgentGraphValidationError(error instanceof Error ? error.message : String(error));
-    }
-    let normalized;
-    try {
-        normalized = (0, normalization_js_1.normalizeEntityLabel)(input.label);
-    }
-    catch (error) {
-        throw new errors_js_1.AgentGraphValidationError(error instanceof Error ? error.message : String(error));
-    }
-    const confidence = normalizeConfidence(input.confidence);
-    const aliasId = stableAliasId(input, normalized.normalized);
-    const createdAt = Date.now();
-    return adapter.transaction(() => {
-        adapter
-            .prepare(`
-          INSERT OR IGNORE INTO entity_aliases (
-            id, entity_id, label, normalized_label, lang, script, label_type,
-            source_type, source_ref, confidence, status, created_at
-          )
-          VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 'active', ?)
-        `)
-            .run(aliasId, input.entity_id, input.label, normalized.normalized, input.lang ?? null, input.script ?? normalized.script, input.label_type ?? 'alt', input.source_type, input.source_ref ?? null, confidence, createdAt);
-        const alias = loadAlias(adapter, aliasId);
-        assertAliasReplayMatches(alias, input, normalized, confidence);
-        const edge = insertAliasEdge(adapter, input, alias, confidence, sourceRefs);
-        return { alias, edge };
-    });
-}
-//# sourceMappingURL=alias-write.js.map

package/dist/agent-graph/entity-resolve.d.ts

@@ -1,3 +0,0 @@
-import type { AgentGraphAdapter, ResolveEntityInput, ResolveEntityResult } from './types.js';
-export declare function resolveEntity(adapter: AgentGraphAdapter, input: ResolveEntityInput): ResolveEntityResult;
-//# sourceMappingURL=entity-resolve.d.ts.map

package/dist/agent-graph/entity-resolve.js

@@ -1,271 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveEntity = resolveEntity;
-const ref_validation_js_1 = require("../edges/ref-validation.js");
-const normalization_js_1 = require("../entities/normalization.js");
-const store_js_1 = require("../entities/store.js");
-const types_js_1 = require("../edges/types.js");
-const errors_js_1 = require("./errors.js");
-const TWIN_REF_KIND_SET = new Set(types_js_1.TWIN_REF_KINDS);
-function hasScopes(scopes) {
-    return Array.isArray(scopes) && scopes.length > 0;
-}
-function normalizeLabel(value) {
-    try {
-        return (0, normalization_js_1.normalizeEntityLabel)(value).normalized;
-    }
-    catch (error) {
-        throw new errors_js_1.AgentGraphValidationError(error instanceof Error ? error.message : String(error));
-    }
-}
-function entityVisible(entity, scopes) {
-    if (!hasScopes(scopes)) {
-        return true;
-    }
-    return scopes.some((scope) => entity.scope_kind === scope.kind && entity.scope_id === scope.id);
-}
-function isAtOrBeforeAsOf(value, asOfMs) {
-    return typeof asOfMs !== 'number' || value <= asOfMs;
-}
-function scopeVisible(scopeKind, scopeId, scopes) {
-    if (!hasScopes(scopes)) {
-        return true;
-    }
-    return scopes.some((scope) => scope.kind === scopeKind && scope.id === scopeId);
-}
-function connectorVisible(connector, connectors) {
-    return !connectors || connectors.length === 0 || connectors.includes(connector);
-}
-function hasProjectOrTenantFilter(visibility) {
-    return ((Array.isArray(visibility.projectRefs) && visibility.projectRefs.length > 0) ||
-        (typeof visibility.tenantId === 'string' && visibility.tenantId.length > 0));
-}
-function refsVisible(adapter, refs, visibility) {
-    if (refs.length === 0) {
-        return true;
-    }
-    try {
-        (0, ref_validation_js_1.assertTwinRefsVisible)(adapter, refs, visibility);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-function parseSourceRefs(value, context) {
-    if (value === undefined || value === null) {
-        return [];
-    }
-    if (!Array.isArray(value)) {
-        throw new Error(`${context}.source_refs must be an array.`);
-    }
-    const refs = [];
-    for (const item of value) {
-        if (item === null ||
-            typeof item !== 'object' ||
-            typeof item.kind !== 'string' ||
-            typeof item.id !== 'string') {
-            throw new Error(`${context}.source_refs entries must be TwinRef objects.`);
-        }
-        const kind = item.kind;
-        const id = item.id.trim();
-        if (!TWIN_REF_KIND_SET.has(kind) || id.length === 0) {
-            throw new Error(`${context}.source_refs contains an invalid TwinRef.`);
-        }
-        refs.push({ kind, id });
-    }
-    return refs;
-}
-function aliasSourceRefs(adapter, aliasId, entityId) {
-    const rows = adapter
-        .prepare(`
-        SELECT relation_attrs_json
-        FROM twin_edges
-        WHERE edge_type = 'alias_of'
-          AND subject_kind = 'entity'
-          AND subject_id = ?
-          AND object_kind = 'entity'
-          AND object_id = ?
-          AND relation_attrs_json IS NOT NULL
-        ORDER BY created_at DESC, edge_id ASC
-      `)
-        .all(entityId, entityId);
-    const refs = [];
-    const seen = new Set();
-    for (const row of rows) {
-        if (!row.relation_attrs_json) {
-            continue;
-        }
-        const parsed = JSON.parse(row.relation_attrs_json);
-        if (parsed === null ||
-            typeof parsed !== 'object' ||
-            parsed.alias_id !== aliasId) {
-            continue;
-        }
-        for (const ref of parseSourceRefs(parsed.source_refs, `alias ${aliasId}`)) {
-            const key = `${ref.kind}:${ref.id}`;
-            if (!seen.has(key)) {
-                seen.add(key);
-                refs.push(ref);
-            }
-        }
-    }
-    return refs;
-}
-function aliasVisible(adapter, row, visibility, asOfMs) {
-    if (!isAtOrBeforeAsOf(row.created_at, asOfMs)) {
-        return false;
-    }
-    const sourceRefs = aliasSourceRefs(adapter, row.id, row.entity_id);
-    if (row.source_type === 'agent' && sourceRefs.length === 0) {
-        return false;
-    }
-    return refsVisible(adapter, sourceRefs, visibility);
-}
-function rawRefForObservation(adapter, row) {
-    const raw = adapter
-        .prepare(`
-        SELECT event_index_id
-        FROM connector_event_index
-        WHERE event_index_id = ?
-           OR (source_connector = ? AND source_id = ?)
-        ORDER BY CASE WHEN event_index_id = ? THEN 0 ELSE 1 END
-        LIMIT 1
-      `)
-        .get(row.source_raw_record_id, row.source_connector, row.source_raw_record_id, row.source_raw_record_id);
-    return raw ? { kind: 'raw', id: raw.event_index_id } : null;
-}
-function observationVisible(adapter, row, visibility, asOfMs) {
-    if (!isAtOrBeforeAsOf(row.timestamp_observed ?? row.created_at, asOfMs)) {
-        return false;
-    }
-    if (!scopeVisible(row.scope_kind, row.scope_id, visibility.scopes)) {
-        return false;
-    }
-    if (!connectorVisible(row.source_connector, visibility.connectors)) {
-        return false;
-    }
-    const rawRef = rawRefForObservation(adapter, row);
-    if (!rawRef) {
-        return !hasProjectOrTenantFilter(visibility);
-    }
-    return refsVisible(adapter, [rawRef], visibility);
-}
-function canonicalEntity(adapter, entityId) {
-    try {
-        const canonicalId = (0, store_js_1.resolveCanonicalEntityId)(adapter, entityId);
-        const entity = (0, store_js_1.getEntityNode)(canonicalId, adapter);
-        return entity && entity.status === 'active' ? entity : null;
-    }
-    catch (error) {
-        if (error instanceof store_js_1.EntityMergeError) {
-            throw new errors_js_1.AgentGraphValidationError(`${error.code}: ${error.message}`);
-        }
-        throw error;
-    }
-}
-function contextBoost(adapter, entityId, contextRefs, visibility, asOfMs) {
-    if (!contextRefs || contextRefs.length === 0) {
-        return 0;
-    }
-    // Spread rather than re-list: see graph-query's listFilteredEdges.
-    const edges = (0, ref_validation_js_1.listVisibleTwinEdgesForRefs)(adapter, contextRefs, { ...visibility, asOfMs });
-    return edges.some((edge) => (edge.subject_ref.kind === 'entity' && edge.subject_ref.id === entityId) ||
-        (edge.object_ref.kind === 'entity' && edge.object_ref.id === entityId))
-        ? 0.2
-        : 0;
-}
-function resolveEntity(adapter, input) {
-    const normalized = normalizeLabel(input.label);
-    const limit = Math.max(1, Math.floor(input.limit ?? 5));
-    const visibility = {
-        scopes: input.scopes,
-        connectors: input.connectors,
-        projectRefs: input.project_refs,
-        tenantId: input.tenant_id,
-        asOfMs: input.as_of_ms,
-        ...(input.channels ? { channels: input.channels } : {}),
-    };
-    if (input.context_refs && input.context_refs.length > 0) {
-        try {
-            (0, ref_validation_js_1.assertTwinRefsVisible)(adapter, input.context_refs, visibility);
-        }
-        catch (error) {
-            throw new errors_js_1.AgentGraphValidationError(error instanceof Error ? error.message : String(error));
-        }
-    }
-    const candidates = new Map();
-    const recordCandidate = (entityId, matchedLabel, matchSource, baseScore) => {
-        const entity = canonicalEntity(adapter, entityId);
-        if (!entity ||
-            !entityVisible(entity, input.scopes) ||
-            !isAtOrBeforeAsOf(entity.created_at, input.as_of_ms)) {
-            return;
-        }
-        const score = baseScore + contextBoost(adapter, entity.id, input.context_refs, visibility, input.as_of_ms);
-        const existing = candidates.get(entity.id);
-        if (!existing || score > existing.score) {
-            candidates.set(entity.id, {
-                entity,
-                matched_label: matchedLabel,
-                match_source: matchSource,
-                score,
-            });
-        }
-    };
-    const nodeRows = adapter
-        .prepare(`
-        SELECT id, preferred_label
-        FROM entity_nodes
-        WHERE status = 'active'
-      `)
-        .all();
-    for (const row of nodeRows) {
-        if (normalizeLabel(row.preferred_label) === normalized) {
-            recordCandidate(row.id, row.preferred_label, 'preferred_label', 1);
-        }
-    }
-    const aliasRows = adapter
-        .prepare(`
-        SELECT id, entity_id, label, normalized_label, source_type, created_at
-        FROM entity_aliases
-        WHERE status = 'active'
-      `)
-        .all();
-    for (const row of aliasRows) {
-        if (aliasVisible(adapter, row, visibility, input.as_of_ms) &&
-            (row.normalized_label === normalized || normalizeLabel(row.label) === normalized)) {
-            recordCandidate(row.entity_id, row.label, 'alias', 0.95);
-        }
-    }
-    const observationRows = adapter
-        .prepare(`
-        SELECT
-          l.canonical_entity_id, o.surface_form, o.normalized_form,
-          o.scope_kind, o.scope_id, o.source_connector, o.source_raw_record_id,
-          o.timestamp_observed, o.created_at
-        FROM entity_lineage_links l
-        JOIN entity_observations o ON o.id = l.entity_observation_id
-        WHERE l.status = 'active'
-      `)
-        .all();
-    for (const row of observationRows) {
-        if (observationVisible(adapter, row, visibility, input.as_of_ms) &&
-            (row.normalized_form === normalized || normalizeLabel(row.surface_form) === normalized)) {
-            recordCandidate(row.canonical_entity_id, row.surface_form, 'observation', 0.85);
-        }
-    }
-    const sorted = Array.from(candidates.values())
-        .sort((left, right) => {
-        if (right.score !== left.score) {
-            return right.score - left.score;
-        }
-        return left.entity.id.localeCompare(right.entity.id);
-    })
-        .slice(0, limit);
-    return {
-        entity: sorted[0]?.entity ?? null,
-        candidates: sorted,
-    };
-}
-//# sourceMappingURL=entity-resolve.js.map

package/dist/agent-graph/errors.d.ts

@@ -1,4 +0,0 @@
-export declare class AgentGraphValidationError extends Error {
-    constructor(message: string);
-}
-//# sourceMappingURL=errors.d.ts.map

package/dist/agent-graph/errors.js

@@ -1,11 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AgentGraphValidationError = void 0;
-class AgentGraphValidationError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = 'AgentGraphValidationError';
-    }
-}
-exports.AgentGraphValidationError = AgentGraphValidationError;
-//# sourceMappingURL=errors.js.map

package/dist/agent-graph/graph-query.d.ts

@@ -1,5 +0,0 @@
-import type { AgentGraphAdapter, AgentGraphResult, GraphNeighborhoodInput, GraphPathsInput, GraphPathsResult, GraphTimelineInput, GraphTimelineResult } from './types.js';
-export declare function getGraphNeighborhood(adapter: AgentGraphAdapter, input: GraphNeighborhoodInput): AgentGraphResult;
-export declare function getGraphPaths(adapter: AgentGraphAdapter, input: GraphPathsInput): GraphPathsResult;
-export declare function getGraphTimeline(adapter: AgentGraphAdapter, input: GraphTimelineInput): GraphTimelineResult;
-//# sourceMappingURL=graph-query.d.ts.map