0agent 1.0.0

package/packages/core/dist/graph/GraphNode.js

@@ -0,0 +1,41 @@
+export var NodeType;
+(function (NodeType) {
+    NodeType["ENTITY"] = "entity";
+    NodeType["CONTEXT"] = "context";
+    NodeType["STRATEGY"] = "strategy";
+    NodeType["PLAN"] = "plan";
+    NodeType["STEP"] = "step";
+    NodeType["OUTCOME"] = "outcome";
+    NodeType["SIGNAL"] = "signal";
+    NodeType["TOOL"] = "tool";
+    NodeType["CONSTRAINT"] = "constraint";
+    NodeType["HYPOTHESIS"] = "hypothesis";
+})(NodeType || (NodeType = {}));
+export var ContentType;
+(function (ContentType) {
+    ContentType["TEXT"] = "text";
+    ContentType["IMAGE"] = "image";
+    ContentType["CODE"] = "code";
+    ContentType["STRUCTURED"] = "structured";
+    ContentType["AUDIO"] = "audio";
+})(ContentType || (ContentType = {}));
+/** Factory function to create a new node with sensible defaults. */
+export function createNode(params) {
+    const now = Date.now();
+    return {
+        id: params.id,
+        graph_id: params.graph_id,
+        label: params.label,
+        type: params.type,
+        created_at: now,
+        last_seen: now,
+        visit_count: 1,
+        metadata: params.metadata ?? {},
+        subgraph_id: params.subgraph_id ?? null,
+        embedding: null,
+        embedding_model: null,
+        embedding_at: null,
+        content: params.content ?? [],
+    };
+}
+//# sourceMappingURL=GraphNode.js.map

package/packages/core/dist/graph/GraphNode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphNode.js","sourceRoot":"","sources":["../../src/graph/GraphNode.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,QAWX;AAXD,WAAY,QAAQ;IAClB,6BAAuB,CAAA;IACvB,+BAAwB,CAAA;IACxB,iCAAyB,CAAA;IACzB,yBAAqB,CAAA;IACrB,yBAAqB,CAAA;IACrB,+BAAwB,CAAA;IACxB,6BAAuB,CAAA;IACvB,yBAAqB,CAAA;IACrB,qCAA2B,CAAA;IAC3B,qCAA2B,CAAA;AAC7B,CAAC,EAXW,QAAQ,KAAR,QAAQ,QAWnB;AAED,MAAM,CAAN,IAAY,WAMX;AAND,WAAY,WAAW;IACrB,4BAAmB,CAAA;IACnB,8BAAoB,CAAA;IACpB,4BAAmB,CAAA;IACnB,wCAAyB,CAAA;IACzB,8BAAoB,CAAA;AACtB,CAAC,EANW,WAAW,KAAX,WAAW,QAMtB;AA0BD,oEAAoE;AACpE,MAAM,UAAU,UAAU,CAAC,MAQ1B;IACC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,UAAU,EAAE,GAAG;QACf,SAAS,EAAE,GAAG;QACd,WAAW,EAAE,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,EAAE;QAC/B,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,IAAI;QACvC,SAAS,EAAE,IAAI;QACf,eAAe,EAAE,IAAI;QACrB,YAAY,EAAE,IAAI;QAClB,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,EAAE;KAC9B,CAAC;AACJ,CAAC"}

package/packages/core/dist/graph/GraphQuery.d.ts

@@ -0,0 +1,46 @@
+import { EdgeType } from './GraphEdge.js';
+import { NodeType, GraphNode } from './GraphNode.js';
+export interface StructuralQueryOpts {
+    graph_id?: string;
+    from_node?: string;
+    to_node?: string;
+    edge_type?: EdgeType;
+    node_type?: NodeType;
+    min_weight?: number;
+    max_weight?: number;
+    limit?: number;
+    order_by?: 'weight_desc' | 'weight_asc' | 'created_at_desc' | 'traversal_count_desc';
+}
+export interface SemanticQueryOpts {
+    embedding: Float32Array;
+    node_types?: NodeType[];
+    limit?: number;
+    min_similarity?: number;
+}
+export interface MergedQueryOpts {
+    structural: StructuralQueryOpts;
+    semantic?: SemanticQueryOpts;
+    semantic_weight?: number;
+    structural_weight?: number;
+    limit?: number;
+}
+export interface QueryResult {
+    node: GraphNode;
+    score: number;
+    source: 'structural' | 'semantic' | 'merged';
+}
+/**
+ * GraphQuery is a builder that holds query options.
+ * Actual execution happens in KnowledgeGraph.
+ */
+export declare class GraphQuery {
+    private opts;
+    private constructor();
+    static structural(opts: StructuralQueryOpts): GraphQuery;
+    static semantic(opts: SemanticQueryOpts): GraphQuery;
+    static merged(opts: MergedQueryOpts): GraphQuery;
+    getStructuralOpts(): StructuralQueryOpts | undefined;
+    getSemanticOpts(): SemanticQueryOpts | undefined;
+    getMergedOpts(): MergedQueryOpts;
+}
+//# sourceMappingURL=GraphQuery.d.ts.map

package/packages/core/dist/graph/GraphQuery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphQuery.d.ts","sourceRoot":"","sources":["../../src/graph/GraphQuery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAErD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,QAAQ,CAAC;IACrB,SAAS,CAAC,EAAE,QAAQ,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,aAAa,GAAG,YAAY,GAAG,iBAAiB,GAAG,sBAAsB,CAAC;CACtF;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,YAAY,CAAC;IACxB,UAAU,CAAC,EAAE,QAAQ,EAAE,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,mBAAmB,CAAC;IAChC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,YAAY,GAAG,UAAU,GAAG,QAAQ,CAAC;CAC9C;AAED;;;GAGG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,IAAI,CAAkB;IAE9B,OAAO;IAIP,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,mBAAmB,GAAG,UAAU;IAQxD,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,GAAG,UAAU;IAUpD,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,GAAG,UAAU;IAQhD,iBAAiB,IAAI,mBAAmB,GAAG,SAAS;IAQpD,eAAe,IAAI,iBAAiB,GAAG,SAAS;IAIhD,aAAa,IAAI,eAAe;CAGjC"}

package/packages/core/dist/graph/GraphQuery.js

@@ -0,0 +1,47 @@
+/**
+ * GraphQuery is a builder that holds query options.
+ * Actual execution happens in KnowledgeGraph.
+ */
+export class GraphQuery {
+    opts;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    static structural(opts) {
+        return new GraphQuery({
+            structural: opts,
+            structural_weight: 1.0,
+            semantic_weight: 0.0,
+        });
+    }
+    static semantic(opts) {
+        return new GraphQuery({
+            structural: {},
+            semantic: opts,
+            structural_weight: 0.0,
+            semantic_weight: 1.0,
+            limit: opts.limit,
+        });
+    }
+    static merged(opts) {
+        return new GraphQuery({
+            ...opts,
+            structural_weight: opts.structural_weight ?? 0.6,
+            semantic_weight: opts.semantic_weight ?? 0.4,
+        });
+    }
+    getStructuralOpts() {
+        const w = this.opts.structural_weight ?? 0.6;
+        if (w === 0 && !this.opts.structural.from_node && !this.opts.structural.to_node) {
+            return undefined;
+        }
+        return this.opts.structural;
+    }
+    getSemanticOpts() {
+        return this.opts.semantic;
+    }
+    getMergedOpts() {
+        return this.opts;
+    }
+}
+//# sourceMappingURL=GraphQuery.js.map

package/packages/core/dist/graph/GraphQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphQuery.js","sourceRoot":"","sources":["../../src/graph/GraphQuery.ts"],"names":[],"mappings":"AAoCA;;;GAGG;AACH,MAAM,OAAO,UAAU;IACb,IAAI,CAAkB;IAE9B,YAAoB,IAAqB;QACvC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,MAAM,CAAC,UAAU,CAAC,IAAyB;QACzC,OAAO,IAAI,UAAU,CAAC;YACpB,UAAU,EAAE,IAAI;YAChB,iBAAiB,EAAE,GAAG;YACtB,eAAe,EAAE,GAAG;SACrB,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,IAAuB;QACrC,OAAO,IAAI,UAAU,CAAC;YACpB,UAAU,EAAE,EAAE;YACd,QAAQ,EAAE,IAAI;YACd,iBAAiB,EAAE,GAAG;YACtB,eAAe,EAAE,GAAG;YACpB,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,MAAM,CAAC,IAAqB;QACjC,OAAO,IAAI,UAAU,CAAC;YACpB,GAAG,IAAI;YACP,iBAAiB,EAAE,IAAI,CAAC,iBAAiB,IAAI,GAAG;YAChD,eAAe,EAAE,IAAI,CAAC,eAAe,IAAI,GAAG;SAC7C,CAAC,CAAC;IACL,CAAC;IAED,iBAAiB;QACf,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,iBAAiB,IAAI,GAAG,CAAC;QAC7C,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;YAChF,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC;IAC9B,CAAC;IAED,eAAe;QACb,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;IAC5B,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;CACF"}

package/packages/core/dist/graph/KnowledgeGraph.d.ts

@@ -0,0 +1,38 @@
+import { SQLiteAdapter } from '../storage/adapters/SQLiteAdapter.js';
+import { GraphNode, NodeContent } from './GraphNode.js';
+import { GraphEdge } from './GraphEdge.js';
+import { SubGraph } from './SubGraph.js';
+import { GraphQuery, QueryResult, StructuralQueryOpts, SemanticQueryOpts, MergedQueryOpts } from './GraphQuery.js';
+export declare class KnowledgeGraph {
+    private adapter;
+    private hnswIndex;
+    constructor(adapter: SQLiteAdapter, hnswIndex?: any);
+    addNode(node: GraphNode): void;
+    getNode(id: string): GraphNode | null;
+    updateNode(id: string, updates: Partial<Pick<GraphNode, 'label' | 'metadata' | 'embedding' | 'embedding_model' | 'embedding_at'>>): void;
+    touchNode(id: string): void;
+    deleteNode(id: string): void;
+    addContent(nodeId: string, content: NodeContent): void;
+    getContent(nodeId: string): NodeContent[];
+    addEdge(edge: GraphEdge): void;
+    getEdge(id: string): GraphEdge | null;
+    deleteEdge(id: string): void;
+    getEdgesFrom(nodeId: string): GraphEdge[];
+    getEdgesTo(nodeId: string): GraphEdge[];
+    getEdgesByNode(nodeId: string, direction: 'from' | 'to' | 'both'): GraphEdge[];
+    getEdgesBetween(fromId: string, toId: string): GraphEdge[];
+    getAllEdges(graphId?: string): GraphEdge[];
+    /**
+     * BFS from entity node, loading nodes + edges up to `depth` hops.
+     */
+    getSubGraph(entityId: string, depth?: number): SubGraph;
+    queryStructural(opts: StructuralQueryOpts): QueryResult[];
+    querySemantic(opts: SemanticQueryOpts): QueryResult[];
+    queryMerged(opts: MergedQueryOpts): QueryResult[];
+    query(q: GraphQuery): QueryResult[];
+    nodeCount(graphId?: string): number;
+    edgeCount(graphId?: string): number;
+    close(): void;
+    private sortResults;
+}
+//# sourceMappingURL=KnowledgeGraph.d.ts.map

package/packages/core/dist/graph/KnowledgeGraph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KnowledgeGraph.d.ts","sourceRoot":"","sources":["../../src/graph/KnowledgeGraph.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AACrE,OAAO,EAAE,SAAS,EAAY,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAE,SAAS,EAAY,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EACL,UAAU,EACV,WAAW,EACX,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EAChB,MAAM,iBAAiB,CAAC;AAEzB,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAgB;IAE/B,OAAO,CAAC,SAAS,CAAa;gBAElB,OAAO,EAAE,aAAa,EAAE,SAAS,CAAC,EAAE,GAAG;IAOnD,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAO9B,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAIrC,UAAU,CACR,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,GAAG,UAAU,GAAG,WAAW,GAAG,iBAAiB,GAAG,cAAc,CAAC,CAAC,GACzG,IAAI;IA+BP,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAI3B,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAa5B,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI;IAQtD,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,EAAE;IAMzC,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAI9B,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAIrC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAI5B,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE;IAIzC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE;IAIvC,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,SAAS,EAAE;IAI9E,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE;IAK1D,WAAW,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE;IAM1C;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,QAAQ;IA4C1D,eAAe,CAAC,IAAI,EAAE,mBAAmB,GAAG,WAAW,EAAE;IA2FzD,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,WAAW,EAAE;IAwCrD,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,WAAW,EAAE;IAsDjD,KAAK,CAAC,CAAC,EAAE,UAAU,GAAG,WAAW,EAAE;IAqBnC,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM;IAInC,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM;IAMnC,KAAK,IAAI,IAAI;IAMb,OAAO,CAAC,WAAW;CAmBpB"}

package/packages/core/dist/graph/KnowledgeGraph.js

@@ -0,0 +1,345 @@
+import { SubGraph } from './SubGraph.js';
+export class KnowledgeGraph {
+    adapter;
+    // HNSWIndex is optional — semantic queries return empty if not set
+    hnswIndex;
+    constructor(adapter, hnswIndex) {
+        this.adapter = adapter;
+        this.hnswIndex = hnswIndex ?? null;
+    }
+    // ─── Node CRUD ────────────────────────────
+    addNode(node) {
+        this.adapter.insertNode(node);
+        if (node.embedding && this.hnswIndex) {
+            this.hnswIndex.add(node.id, node.embedding);
+        }
+    }
+    getNode(id) {
+        return this.adapter.getNode(id);
+    }
+    updateNode(id, updates) {
+        const existing = this.adapter.getNode(id);
+        if (!existing) {
+            throw new Error(`Node not found: ${id}`);
+        }
+        // Build updated node for re-insertion of changed fields
+        if (updates.label !== undefined) {
+            existing.label = updates.label;
+        }
+        if (updates.metadata !== undefined) {
+            existing.metadata = updates.metadata;
+        }
+        if (updates.embedding !== undefined) {
+            existing.embedding = updates.embedding;
+            if (updates.embedding && this.hnswIndex) {
+                this.hnswIndex.add(id, updates.embedding);
+            }
+        }
+        if (updates.embedding_model !== undefined) {
+            existing.embedding_model = updates.embedding_model;
+        }
+        if (updates.embedding_at !== undefined) {
+            existing.embedding_at = updates.embedding_at;
+        }
+        // Delete and re-insert to update all fields
+        this.adapter.deleteNode(id);
+        this.adapter.insertNode(existing);
+    }
+    touchNode(id) {
+        this.adapter.updateNodeLastSeen(id, Date.now());
+    }
+    deleteNode(id) {
+        this.adapter.deleteNode(id);
+        if (this.hnswIndex) {
+            try {
+                this.hnswIndex.remove(id);
+            }
+            catch {
+                // Ignore if not in index
+            }
+        }
+    }
+    // ─── Node Content ─────────────────────────
+    addContent(nodeId, content) {
+        const node = this.adapter.getNode(nodeId);
+        if (!node) {
+            throw new Error(`Node not found: ${nodeId}`);
+        }
+        this.adapter.insertNodeContent(content);
+    }
+    getContent(nodeId) {
+        return this.adapter.getNodeContent(nodeId);
+    }
+    // ─── Edge CRUD ────────────────────────────
+    addEdge(edge) {
+        this.adapter.insertEdge(edge);
+    }
+    getEdge(id) {
+        return this.adapter.getEdge(id);
+    }
+    deleteEdge(id) {
+        this.adapter.deleteEdge(id);
+    }
+    getEdgesFrom(nodeId) {
+        return this.adapter.getEdgesByNode(nodeId, 'from');
+    }
+    getEdgesTo(nodeId) {
+        return this.adapter.getEdgesByNode(nodeId, 'to');
+    }
+    getEdgesByNode(nodeId, direction) {
+        return this.adapter.getEdgesByNode(nodeId, direction);
+    }
+    getEdgesBetween(fromId, toId) {
+        const edges = this.adapter.getEdgesByNode(fromId, 'from');
+        return edges.filter((e) => e.to_node === toId);
+    }
+    getAllEdges(graphId) {
+        return this.adapter.getAllEdges(graphId);
+    }
+    // ─── Subgraph ─────────────────────────────
+    /**
+     * BFS from entity node, loading nodes + edges up to `depth` hops.
+     */
+    getSubGraph(entityId, depth = 2) {
+        const rootNode = this.adapter.getNode(entityId);
+        if (!rootNode) {
+            throw new Error(`Entity node not found: ${entityId}`);
+        }
+        const subgraph = new SubGraph(entityId, entityId);
+        subgraph.addNode(rootNode);
+        let frontier = new Set([entityId]);
+        const visited = new Set([entityId]);
+        for (let d = 0; d < depth; d++) {
+            const nextFrontier = new Set();
+            for (const nodeId of frontier) {
+                const outEdges = this.adapter.getEdgesByNode(nodeId, 'both');
+                for (const edge of outEdges) {
+                    subgraph.addEdge(edge);
+                    // Determine the neighbor node
+                    const neighborId = edge.from_node === nodeId ? edge.to_node : edge.from_node;
+                    if (!visited.has(neighborId)) {
+                        visited.add(neighborId);
+                        const neighborNode = this.adapter.getNode(neighborId);
+                        if (neighborNode) {
+                            subgraph.addNode(neighborNode);
+                            nextFrontier.add(neighborId);
+                        }
+                    }
+                }
+            }
+            frontier = nextFrontier;
+            if (frontier.size === 0)
+                break;
+        }
+        return subgraph;
+    }
+    // ─── Query ────────────────────────────────
+    queryStructural(opts) {
+        const results = [];
+        const limit = opts.limit ?? 50;
+        if (opts.from_node) {
+            // Get edges from the specified node
+            let edges = this.adapter.getEdgesByNode(opts.from_node, 'from');
+            // Filter by edge type
+            if (opts.edge_type) {
+                edges = edges.filter((e) => e.type === opts.edge_type);
+            }
+            // Filter by weight range
+            if (opts.min_weight !== undefined) {
+                edges = edges.filter((e) => e.weight >= opts.min_weight);
+            }
+            if (opts.max_weight !== undefined) {
+                edges = edges.filter((e) => e.weight <= opts.max_weight);
+            }
+            // Filter by graph_id
+            if (opts.graph_id) {
+                edges = edges.filter((e) => e.graph_id === opts.graph_id);
+            }
+            // Resolve target nodes
+            for (const edge of edges) {
+                const targetNode = this.adapter.getNode(edge.to_node);
+                if (!targetNode)
+                    continue;
+                // Filter by node type
+                if (opts.node_type && targetNode.type !== opts.node_type)
+                    continue;
+                results.push({
+                    node: targetNode,
+                    score: edge.weight,
+                    source: 'structural',
+                });
+            }
+        }
+        else if (opts.to_node) {
+            // Get edges to the specified node
+            let edges = this.adapter.getEdgesByNode(opts.to_node, 'to');
+            if (opts.edge_type) {
+                edges = edges.filter((e) => e.type === opts.edge_type);
+            }
+            if (opts.min_weight !== undefined) {
+                edges = edges.filter((e) => e.weight >= opts.min_weight);
+            }
+            if (opts.max_weight !== undefined) {
+                edges = edges.filter((e) => e.weight <= opts.max_weight);
+            }
+            if (opts.graph_id) {
+                edges = edges.filter((e) => e.graph_id === opts.graph_id);
+            }
+            for (const edge of edges) {
+                const sourceNode = this.adapter.getNode(edge.from_node);
+                if (!sourceNode)
+                    continue;
+                if (opts.node_type && sourceNode.type !== opts.node_type)
+                    continue;
+                results.push({
+                    node: sourceNode,
+                    score: edge.weight,
+                    source: 'structural',
+                });
+            }
+        }
+        else if (opts.graph_id || opts.node_type) {
+            // Query nodes directly by graph_id and/or type
+            const nodes = this.adapter.queryNodes({
+                graph_id: opts.graph_id,
+                type: opts.node_type,
+                limit,
+            });
+            for (const node of nodes) {
+                results.push({
+                    node,
+                    score: 1.0, // No edge weight context, default to 1.0
+                    source: 'structural',
+                });
+            }
+        }
+        // Sort results
+        this.sortResults(results, opts.order_by ?? 'weight_desc');
+        return results.slice(0, limit);
+    }
+    querySemantic(opts) {
+        if (!this.hnswIndex) {
+            return [];
+        }
+        const limit = opts.limit ?? 20;
+        const minSimilarity = opts.min_similarity ?? 0.0;
+        let searchResults;
+        try {
+            searchResults = this.hnswIndex.search(opts.embedding, limit * 2); // oversample for filtering
+        }
+        catch {
+            return [];
+        }
+        const results = [];
+        for (const hit of searchResults) {
+            if (hit.similarity < minSimilarity)
+                continue;
+            const node = this.adapter.getNode(hit.id);
+            if (!node)
+                continue;
+            // Filter by node types if specified
+            if (opts.node_types && opts.node_types.length > 0) {
+                if (!opts.node_types.includes(node.type))
+                    continue;
+            }
+            results.push({
+                node,
+                score: hit.similarity,
+                source: 'semantic',
+            });
+            if (results.length >= limit)
+                break;
+        }
+        return results;
+    }
+    queryMerged(opts) {
+        const structuralWeight = opts.structural_weight ?? 0.6;
+        const semanticWeight = opts.semantic_weight ?? 0.4;
+        const limit = opts.limit ?? 50;
+        // Run structural query
+        const structuralResults = this.queryStructural(opts.structural);
+        // Run semantic query if provided
+        const semanticResults = opts.semantic
+            ? this.querySemantic(opts.semantic)
+            : [];
+        // Build score maps keyed by node id
+        const scoreMap = new Map();
+        for (const r of structuralResults) {
+            scoreMap.set(r.node.id, {
+                node: r.node,
+                structScore: r.score,
+                semScore: 0,
+            });
+        }
+        for (const r of semanticResults) {
+            const existing = scoreMap.get(r.node.id);
+            if (existing) {
+                existing.semScore = r.score;
+            }
+            else {
+                scoreMap.set(r.node.id, {
+                    node: r.node,
+                    structScore: 0,
+                    semScore: r.score,
+                });
+            }
+        }
+        // Compute merged scores
+        const merged = [];
+        for (const entry of scoreMap.values()) {
+            const score = structuralWeight * entry.structScore + semanticWeight * entry.semScore;
+            merged.push({
+                node: entry.node,
+                score,
+                source: 'merged',
+            });
+        }
+        // Sort by score descending
+        merged.sort((a, b) => b.score - a.score);
+        return merged.slice(0, limit);
+    }
+    query(q) {
+        const merged = q.getMergedOpts();
+        const structOpts = q.getStructuralOpts();
+        const semOpts = q.getSemanticOpts();
+        // Pure semantic query
+        if (!structOpts && semOpts) {
+            return this.querySemantic(semOpts);
+        }
+        // Pure structural query
+        if (structOpts && !semOpts) {
+            return this.queryStructural(structOpts);
+        }
+        // Merged query
+        return this.queryMerged(merged);
+    }
+    // ─── Stats ────────────────────────────────
+    nodeCount(graphId) {
+        return this.adapter.countNodes(graphId);
+    }
+    edgeCount(graphId) {
+        return this.adapter.countEdges(graphId);
+    }
+    // ─── Lifecycle ────────────────────────────
+    close() {
+        this.adapter.close();
+    }
+    // ─── Private helpers ──────────────────────
+    sortResults(results, orderBy) {
+        switch (orderBy) {
+            case 'weight_desc':
+                results.sort((a, b) => b.score - a.score);
+                break;
+            case 'weight_asc':
+                results.sort((a, b) => a.score - b.score);
+                break;
+            case 'created_at_desc':
+                results.sort((a, b) => b.node.created_at - a.node.created_at);
+                break;
+            case 'traversal_count_desc':
+                results.sort((a, b) => b.node.visit_count - a.node.visit_count);
+                break;
+        }
+    }
+}
+//# sourceMappingURL=KnowledgeGraph.js.map

package/packages/core/dist/graph/KnowledgeGraph.js.map

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

package/packages/core/dist/graph/SubGraph.d.ts

@@ -0,0 +1,36 @@
+import { GraphNode } from './GraphNode.js';
+import { GraphEdge } from './GraphEdge.js';
+export declare class SubGraph {
+    readonly id: string;
+    readonly rootEntityId: string;
+    private nodes;
+    private edges;
+    constructor(id: string, rootEntityId: string);
+    addNode(node: GraphNode): void;
+    addEdge(edge: GraphEdge): void;
+    getNode(id: string): GraphNode | undefined;
+    getEdge(id: string): GraphEdge | undefined;
+    /** Remove a node and all edges connected to it. */
+    removeNode(id: string): void;
+    removeEdge(id: string): void;
+    getNodes(): GraphNode[];
+    getEdges(): GraphEdge[];
+    getEdgesFrom(nodeId: string): GraphEdge[];
+    getEdgesTo(nodeId: string): GraphEdge[];
+    get nodeCount(): number;
+    get edgeCount(): number;
+    /** Serialize to a plain object for snapshot injection into subagents. */
+    toSnapshot(): {
+        id: string;
+        rootEntityId: string;
+        nodes: GraphNode[];
+        edges: GraphEdge[];
+    };
+    static fromSnapshot(snapshot: {
+        id: string;
+        rootEntityId: string;
+        nodes: GraphNode[];
+        edges: GraphEdge[];
+    }): SubGraph;
+}
+//# sourceMappingURL=SubGraph.d.ts.map

package/packages/core/dist/graph/SubGraph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubGraph.d.ts","sourceRoot":"","sources":["../../src/graph/SubGraph.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,qBAAa,QAAQ;IACnB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,KAAK,CAAyB;gBAE1B,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM;IAO5C,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAI9B,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAI9B,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAI1C,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAI1C,mDAAmD;IACnD,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAS5B,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAI5B,QAAQ,IAAI,SAAS,EAAE;IAIvB,QAAQ,IAAI,SAAS,EAAE;IAIvB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE;IAUzC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE;IAUvC,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,yEAAyE;IACzE,UAAU,IAAI;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,SAAS,EAAE,CAAC;QAAC,KAAK,EAAE,SAAS,EAAE,CAAA;KAAE;IAS1F,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,SAAS,EAAE,CAAC;QAAC,KAAK,EAAE,SAAS,EAAE,CAAA;KAAE,GAAG,QAAQ;CAUtH"}