@hazeljs/kag 0.0.0-stage → 2.0.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (47) hide show
  1. package/README.md +122 -2
  2. package/dist/adapters/graphrag.adapter.d.ts +47 -0
  3. package/dist/adapters/graphrag.adapter.d.ts.map +1 -0
  4. package/dist/adapters/graphrag.adapter.js +111 -0
  5. package/dist/confidence.d.ts +7 -0
  6. package/dist/confidence.d.ts.map +1 -0
  7. package/dist/confidence.js +40 -0
  8. package/dist/errors/kag.error.d.ts +42 -0
  9. package/dist/errors/kag.error.d.ts.map +1 -0
  10. package/dist/errors/kag.error.js +80 -0
  11. package/dist/index.d.ts +15 -0
  12. package/dist/index.d.ts.map +1 -0
  13. package/dist/index.js +30 -0
  14. package/dist/ingestion/ingest.d.ts +24 -0
  15. package/dist/ingestion/ingest.d.ts.map +1 -0
  16. package/dist/ingestion/ingest.js +61 -0
  17. package/dist/kag.module.d.ts +29 -0
  18. package/dist/kag.module.d.ts.map +1 -0
  19. package/dist/kag.module.js +58 -0
  20. package/dist/kag.service.d.ts +66 -0
  21. package/dist/kag.service.d.ts.map +1 -0
  22. package/dist/kag.service.js +92 -0
  23. package/dist/knowledge-graph.d.ts +50 -0
  24. package/dist/knowledge-graph.d.ts.map +1 -0
  25. package/dist/knowledge-graph.js +290 -0
  26. package/dist/planner/heuristic-query-planner.d.ts +36 -0
  27. package/dist/planner/heuristic-query-planner.d.ts.map +1 -0
  28. package/dist/planner/heuristic-query-planner.js +67 -0
  29. package/dist/planner/industry-profiles.d.ts +34 -0
  30. package/dist/planner/industry-profiles.d.ts.map +1 -0
  31. package/dist/planner/industry-profiles.js +83 -0
  32. package/dist/resolution/entity-resolver.d.ts +21 -0
  33. package/dist/resolution/entity-resolver.d.ts.map +1 -0
  34. package/dist/resolution/entity-resolver.js +123 -0
  35. package/dist/security/authorizer.d.ts +27 -0
  36. package/dist/security/authorizer.d.ts.map +1 -0
  37. package/dist/security/authorizer.js +57 -0
  38. package/dist/stores/in-memory-knowledge.store.d.ts +22 -0
  39. package/dist/stores/in-memory-knowledge.store.d.ts.map +1 -0
  40. package/dist/stores/in-memory-knowledge.store.js +186 -0
  41. package/dist/temporal.d.ts +7 -0
  42. package/dist/temporal.d.ts.map +1 -0
  43. package/dist/temporal.js +63 -0
  44. package/dist/types.d.ts +207 -0
  45. package/dist/types.d.ts.map +1 -0
  46. package/dist/types.js +15 -0
  47. package/package.json +78 -4
@@ -0,0 +1,207 @@
1
+ /**
2
+ * Knowledge-Augmented Generation types
3
+ */
4
+ export interface KnowledgeSource {
5
+ type: string;
6
+ id?: string;
7
+ authority?: number;
8
+ priority?: number;
9
+ metadata?: Record<string, unknown>;
10
+ }
11
+ export interface KnowledgeEntity {
12
+ id: string;
13
+ type: string;
14
+ properties: Record<string, unknown>;
15
+ metadata?: Record<string, unknown>;
16
+ aliases?: string[];
17
+ confidence?: number;
18
+ }
19
+ export interface KnowledgeRelation {
20
+ id: string;
21
+ from: string;
22
+ to: string;
23
+ type: string;
24
+ properties?: Record<string, unknown>;
25
+ confidence?: number;
26
+ source?: KnowledgeSource;
27
+ }
28
+ export interface KnowledgeFact {
29
+ id?: string;
30
+ subject: string;
31
+ predicate: string;
32
+ object: unknown;
33
+ confidence?: number;
34
+ source?: KnowledgeSource;
35
+ validFrom?: Date | string;
36
+ validUntil?: Date | string;
37
+ priority?: number;
38
+ createdAt?: Date | string;
39
+ }
40
+ export interface KnowledgeScope {
41
+ tenantId: string;
42
+ graph?: string;
43
+ }
44
+ export interface KnowledgeQuery {
45
+ entityIds?: string[];
46
+ types?: string[];
47
+ predicate?: string;
48
+ asOf?: Date | string;
49
+ currentOnly?: boolean;
50
+ limit?: number;
51
+ }
52
+ export interface TraversalOptions {
53
+ depth?: number;
54
+ relationTypes?: string[];
55
+ asOf?: Date | string;
56
+ }
57
+ export interface TraversalResult {
58
+ entities: KnowledgeEntity[];
59
+ relations: KnowledgeRelation[];
60
+ facts: KnowledgeFact[];
61
+ confidence: number;
62
+ }
63
+ export interface KnowledgeResult {
64
+ entities: KnowledgeEntity[];
65
+ relations: KnowledgeRelation[];
66
+ facts: KnowledgeFact[];
67
+ contradictions?: KnowledgeFact[][];
68
+ }
69
+ export interface KnowledgeEvidence {
70
+ entity?: string;
71
+ relation?: string;
72
+ entity2?: string;
73
+ fact?: KnowledgeFact;
74
+ source?: KnowledgeSource;
75
+ }
76
+ export interface KnowledgeAnswer {
77
+ answer?: string;
78
+ evidence: KnowledgeEvidence[];
79
+ sources: KnowledgeSource[];
80
+ confidence: number;
81
+ alternatives?: KnowledgeFact[];
82
+ explanation?: string;
83
+ }
84
+ export interface AskOptions {
85
+ explain?: boolean;
86
+ rag?: boolean;
87
+ asOf?: Date | string;
88
+ depth?: number;
89
+ graph?: string;
90
+ }
91
+ export interface EntityResolutionCandidate {
92
+ entity: KnowledgeEntity;
93
+ confidence: number;
94
+ strategy: string;
95
+ }
96
+ export interface EntityResolutionResult {
97
+ merged?: KnowledgeEntity;
98
+ candidates: EntityResolutionCandidate[];
99
+ }
100
+ export type EntityResolutionStrategy = 'exact' | 'normalized' | 'semantic' | 'custom';
101
+ export type ContradictionPolicy = 'keep' | 'rank' | 'reject';
102
+ export type ConfidenceAggregation = 'min' | 'product';
103
+ export interface KnowledgeStore {
104
+ upsertEntity(scope: KnowledgeScope, entity: KnowledgeEntity): Promise<void>;
105
+ upsertRelation(scope: KnowledgeScope, relation: KnowledgeRelation): Promise<void>;
106
+ upsertFact(scope: KnowledgeScope, fact: KnowledgeFact): Promise<{
107
+ contradictions: KnowledgeFact[];
108
+ }>;
109
+ getEntity(scope: KnowledgeScope, id: string): Promise<KnowledgeEntity | null>;
110
+ query(scope: KnowledgeScope, query: KnowledgeQuery): Promise<KnowledgeResult>;
111
+ traverse(scope: KnowledgeScope, seedIds: string[], options?: TraversalOptions): Promise<TraversalResult>;
112
+ listEntities(scope: KnowledgeScope): Promise<KnowledgeEntity[]>;
113
+ clear?(scope: KnowledgeScope): Promise<void>;
114
+ }
115
+ export interface KnowledgeAuthorizer {
116
+ canAccess(scope: KnowledgeScope, action: 'read' | 'write', resource: {
117
+ kind: 'entity' | 'relation' | 'fact' | 'source';
118
+ id?: string;
119
+ type?: string;
120
+ }): Promise<boolean> | boolean;
121
+ }
122
+ export interface KnowledgeRetriever {
123
+ search(query: string, options?: {
124
+ topK?: number;
125
+ tenantId?: string;
126
+ }): Promise<Array<{
127
+ content: string;
128
+ id?: string;
129
+ score?: number;
130
+ }>>;
131
+ }
132
+ export interface KnowledgeExtractor {
133
+ extract(input: unknown): Promise<{
134
+ entities: KnowledgeEntity[];
135
+ relations: KnowledgeRelation[];
136
+ facts?: KnowledgeFact[];
137
+ }>;
138
+ }
139
+ export interface KnowledgeQueryPlanner {
140
+ plan(question: string, context: {
141
+ scope: KnowledgeScope;
142
+ entities: KnowledgeEntity[];
143
+ }): Promise<{
144
+ seedIds: string[];
145
+ depth: number;
146
+ relationTypes?: string[];
147
+ template?: string;
148
+ }>;
149
+ }
150
+ export interface ObservationPromotion {
151
+ subject: string;
152
+ predicate: string;
153
+ object: unknown;
154
+ confidence: number;
155
+ validated: boolean;
156
+ source?: KnowledgeSource;
157
+ validFrom?: Date | string;
158
+ validUntil?: Date | string;
159
+ }
160
+ export interface ContextContribution {
161
+ text: string;
162
+ evidence?: unknown[];
163
+ fingerprint?: string;
164
+ }
165
+ export interface ContextContributor {
166
+ readonly kind: 'cag' | 'kag';
167
+ contribute(request: {
168
+ query: string;
169
+ tenantId: string;
170
+ namespace?: string;
171
+ agentId?: string;
172
+ }): Promise<ContextContribution>;
173
+ }
174
+ export interface KagModuleOptions {
175
+ store?: KnowledgeStore;
176
+ tenantId?: string;
177
+ graph?: string;
178
+ multiTenant?: boolean;
179
+ mergeThreshold?: number;
180
+ contradictionPolicy?: ContradictionPolicy;
181
+ confidenceAggregation?: ConfidenceAggregation;
182
+ authorizer?: KnowledgeAuthorizer;
183
+ retriever?: KnowledgeRetriever;
184
+ extractor?: KnowledgeExtractor;
185
+ planner?: KnowledgeQueryPlanner;
186
+ /**
187
+ * Industry / domain profile for the default HeuristicQueryPlanner.
188
+ * Ignored when `planner` is provided explicitly.
189
+ * Defaults to a generic (non-commerce) profile.
190
+ */
191
+ industry?: import('./planner/industry-profiles').IndustryProfile | import('./planner/industry-profiles').IndustryProfile[];
192
+ llm?: (prompt: string) => Promise<string> | string;
193
+ eventEmitter?: {
194
+ emit(event: string, ...values: unknown[]): unknown;
195
+ };
196
+ embed?: (text: string) => Promise<number[]> | number[];
197
+ }
198
+ export declare const KAG_OPTIONS = "KAG_OPTIONS";
199
+ export declare const KAG_EVENTS: {
200
+ readonly ENTITY_CREATED: "kag.entity.created";
201
+ readonly ENTITY_UPDATED: "kag.entity.updated";
202
+ readonly RELATION_CREATED: "kag.relation.created";
203
+ readonly FACT_ADDED: "kag.fact.added";
204
+ readonly CONTRADICTION_DETECTED: "kag.contradiction.detected";
205
+ readonly QUERY_COMPLETED: "kag.query.completed";
206
+ };
207
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
package/dist/types.js ADDED
@@ -0,0 +1,15 @@
1
+ "use strict";
2
+ /**
3
+ * Knowledge-Augmented Generation types
4
+ */
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ exports.KAG_EVENTS = exports.KAG_OPTIONS = void 0;
7
+ exports.KAG_OPTIONS = 'KAG_OPTIONS';
8
+ exports.KAG_EVENTS = {
9
+ ENTITY_CREATED: 'kag.entity.created',
10
+ ENTITY_UPDATED: 'kag.entity.updated',
11
+ RELATION_CREATED: 'kag.relation.created',
12
+ FACT_ADDED: 'kag.fact.added',
13
+ CONTRADICTION_DETECTED: 'kag.contradiction.detected',
14
+ QUERY_COMPLETED: 'kag.query.completed',
15
+ };
package/package.json CHANGED
@@ -1,6 +1,80 @@
1
1
  {
2
2
  "name": "@hazeljs/kag",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
6
- }
3
+ "version": "2.0.10",
4
+ "description": "Knowledge-Augmented Generation for HazelJS — entities, facts, relations, and structured reasoning",
5
+ "main": "dist/index.js",
6
+ "types": "dist/index.d.ts",
7
+ "exports": {
8
+ ".": {
9
+ "types": "./dist/index.d.ts",
10
+ "default": "./dist/index.js"
11
+ }
12
+ },
13
+ "files": [
14
+ "dist"
15
+ ],
16
+ "scripts": {
17
+ "build": "tsc",
18
+ "test": "jest --coverage",
19
+ "lint": "eslint \"src/**/*.ts\" --ignore-pattern \"src/bench.ts\"",
20
+ "lint:fix": "eslint \"src/**/*.ts\" --ignore-pattern \"src/bench.ts\" --fix",
21
+ "clean": "rm -rf dist",
22
+ "bench": "ts-node --transpile-only src/bench.ts"
23
+ },
24
+ "dependencies": {
25
+ "eventemitter3": "^5.0.4"
26
+ },
27
+ "devDependencies": {
28
+ "@types/node": "^20.19.39",
29
+ "@typescript-eslint/eslint-plugin": "^8.58.0",
30
+ "@typescript-eslint/parser": "^8.58.0",
31
+ "eslint": "^8.57.1",
32
+ "jest": "^29.7.0",
33
+ "ts-jest": "^29.4.9",
34
+ "ts-node": "^10.9.2",
35
+ "typescript": "^6.0.3"
36
+ },
37
+ "peerDependencies": {
38
+ "@hazeljs/core": "^2.0.10",
39
+ "@hazeljs/ai": "^2.0.10",
40
+ "@hazeljs/rag": "^2.0.10",
41
+ "@hazeljs/memory": "^2.0.10",
42
+ "@hazeljs/event-emitter": "^2.0.10"
43
+ },
44
+ "peerDependenciesMeta": {
45
+ "@hazeljs/ai": {
46
+ "optional": true
47
+ },
48
+ "@hazeljs/rag": {
49
+ "optional": true
50
+ },
51
+ "@hazeljs/memory": {
52
+ "optional": true
53
+ },
54
+ "@hazeljs/event-emitter": {
55
+ "optional": true
56
+ }
57
+ },
58
+ "publishConfig": {
59
+ "access": "public"
60
+ },
61
+ "repository": {
62
+ "type": "git",
63
+ "url": "https://github.com/hazel-js/hazeljs",
64
+ "directory": "packages/kag"
65
+ },
66
+ "keywords": [
67
+ "hazeljs",
68
+ "kag",
69
+ "knowledge-augmented-generation",
70
+ "knowledge-graph",
71
+ "entities",
72
+ "facts"
73
+ ],
74
+ "author": "Muhammad Arslan <muhammad.arslan@hazeljs.ai>",
75
+ "license": "Apache-2.0",
76
+ "bugs": {
77
+ "url": "https://github.com/hazel-js/hazeljs/issues"
78
+ },
79
+ "homepage": "https://hazeljs.ai"
80
+ }