@trustgraph/react-state 1.7.1 → 1.7.2
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.
- package/dist/index.cjs +246 -172
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.ts +2 -2
- package/dist/index.d.ts.map +1 -1
- package/dist/index.esm.js +247 -174
- package/dist/index.esm.js.map +1 -1
- package/dist/state/chat-session.d.ts.map +1 -1
- package/dist/state/explainability.d.ts +8 -5
- package/dist/state/explainability.d.ts.map +1 -1
- package/dist/utils/explainability.d.ts +50 -18
- package/dist/utils/explainability.d.ts.map +1 -1
- package/package.json +1 -1
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"chat-session.d.ts","sourceRoot":"","sources":["../../src/state/chat-session.ts"],"names":[],"mappings":"AAiBA;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAI,WAAU;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO;;
|
|
1
|
+
{"version":3,"file":"chat-session.d.ts","sourceRoot":"","sources":["../../src/state/chat-session.ts"],"names":[],"mappings":"AAiBA;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAI,WAAU;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO;;eA+QpB,MAAM;;;;CAoDhD,CAAC;AAGF,eAAO,MAAM,OAAO,cAtUqB;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE;;eA+Qf,MAAM;;;;CAuDZ,CAAC"}
|
|
@@ -4,10 +4,11 @@
|
|
|
4
4
|
*
|
|
5
5
|
* Processing strategy:
|
|
6
6
|
* - Events are processed immediately as they arrive
|
|
7
|
-
* -
|
|
8
|
-
*
|
|
9
|
-
* - Edge
|
|
10
|
-
* -
|
|
7
|
+
* - Explain triples are embedded directly in events (no store lookups)
|
|
8
|
+
* - Edge labels are resolved via triple store queries
|
|
9
|
+
* - Edge label resolution + provenance runs in parallel
|
|
10
|
+
* - onUpdate callback fires on every session state change, allowing
|
|
11
|
+
* callers to sync to external stores (e.g. Zustand)
|
|
11
12
|
*/
|
|
12
13
|
import type { ExplainEvent } from "@trustgraph/client";
|
|
13
14
|
import { type ExplainabilitySession } from "../utils/explainability";
|
|
@@ -16,6 +17,8 @@ export interface UseExplainabilityOptions {
|
|
|
16
17
|
collection?: string;
|
|
17
18
|
/** Trace provenance for selected edges (default: true) */
|
|
18
19
|
traceProvenance?: boolean;
|
|
20
|
+
/** Called on every session state change with the latest session */
|
|
21
|
+
onUpdate?: (session: ExplainabilitySession) => void;
|
|
19
22
|
}
|
|
20
23
|
export interface UseExplainabilityResult {
|
|
21
24
|
/** Add an explain event (wire this to graphRag callbacks.onExplain) */
|
|
@@ -39,5 +42,5 @@ export interface UseExplainabilityResult {
|
|
|
39
42
|
* Hook for managing explainability during inference
|
|
40
43
|
*/
|
|
41
44
|
export declare const useExplainability: (options?: UseExplainabilityOptions) => UseExplainabilityResult;
|
|
42
|
-
export type { ExplainabilitySession, QuestionEvent, ExplorationEvent, FocusEvent, SynthesisEvent, SelectedEdge, ProvenanceChain, ProvenanceChainItem, } from "../utils/explainability";
|
|
45
|
+
export type { ExplainabilitySession, ExplainEventType, StructuredExplainEvent, QuestionEvent, ExplorationEvent, FocusEvent, SynthesisEvent, SelectedEdge, ProvenanceChain, ProvenanceChainItem, AgentQuestionEvent, DecompositionEvent, AnalysisEvent, ReflectionEvent, ConclusionEvent, } from "../utils/explainability";
|
|
43
46
|
//# sourceMappingURL=explainability.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"explainability.d.ts","sourceRoot":"","sources":["../../src/state/explainability.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"explainability.d.ts","sourceRoot":"","sources":["../../src/state/explainability.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAU,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAIL,KAAK,qBAAqB,EAM3B,MAAM,yBAAyB,CAAC;AAEjC,MAAM,WAAW,wBAAwB;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,mEAAmE;IACnE,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,qBAAqB,KAAK,IAAI,CAAC;CACrD;AAED,MAAM,WAAW,uBAAuB;IACtC,uEAAuE;IACvE,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IACxC,8DAA8D;IAC9D,OAAO,EAAE,qBAAqB,CAAC;IAC/B,gFAAgF;IAChF,UAAU,EAAE,KAAK,CAAC,SAAS,CAAC,qBAAqB,CAAC,CAAC;IACnD,0BAA0B;IAC1B,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,qDAAqD;IACrD,WAAW,EAAE,OAAO,CAAC;IACrB,iEAAiE;IACjE,eAAe,EAAE,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC1C,iCAAiC;IACjC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,wBAAwB;IACxB,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAC5B,UAAS,wBAA6B,KACrC,uBAiOF,CAAC;AAGF,YAAY,EACV,qBAAqB,EACrB,gBAAgB,EAChB,sBAAsB,EACtB,aAAa,EACb,gBAAgB,EAChB,UAAU,EACV,cAAc,EACd,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,eAAe,GAChB,MAAM,yBAAyB,CAAC"}
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
* Explainability utilities for parsing and structuring explain events
|
|
3
3
|
*/
|
|
4
4
|
import type { Triple, Term } from "@trustgraph/client";
|
|
5
|
-
export type ExplainEventType = "question" | "exploration" | "focus" | "synthesis" | "unknown";
|
|
5
|
+
export type ExplainEventType = "question" | "exploration" | "focus" | "synthesis" | "agent-question" | "decomposition" | "analysis" | "reflection" | "conclusion" | "unknown";
|
|
6
6
|
export interface QuestionEvent {
|
|
7
7
|
type: "question";
|
|
8
8
|
explainId: string;
|
|
@@ -50,7 +50,47 @@ export interface SynthesisEvent {
|
|
|
50
50
|
/** Content length (full content is streamed separately) */
|
|
51
51
|
contentLength?: number;
|
|
52
52
|
}
|
|
53
|
-
export
|
|
53
|
+
export interface AgentQuestionEvent {
|
|
54
|
+
type: "agent-question";
|
|
55
|
+
explainId: string;
|
|
56
|
+
explainGraph: string;
|
|
57
|
+
query?: string;
|
|
58
|
+
label?: string;
|
|
59
|
+
timestamp?: string;
|
|
60
|
+
derivedFrom?: string[];
|
|
61
|
+
}
|
|
62
|
+
export interface DecompositionEvent {
|
|
63
|
+
type: "decomposition";
|
|
64
|
+
explainId: string;
|
|
65
|
+
explainGraph: string;
|
|
66
|
+
label?: string;
|
|
67
|
+
goals: string[];
|
|
68
|
+
derivedFrom?: string[];
|
|
69
|
+
}
|
|
70
|
+
export interface AnalysisEvent {
|
|
71
|
+
type: "analysis";
|
|
72
|
+
explainId: string;
|
|
73
|
+
explainGraph: string;
|
|
74
|
+
label?: string;
|
|
75
|
+
action?: string;
|
|
76
|
+
arguments?: string;
|
|
77
|
+
derivedFrom?: string[];
|
|
78
|
+
}
|
|
79
|
+
export interface ReflectionEvent {
|
|
80
|
+
type: "reflection";
|
|
81
|
+
explainId: string;
|
|
82
|
+
explainGraph: string;
|
|
83
|
+
label?: string;
|
|
84
|
+
derivedFrom?: string[];
|
|
85
|
+
}
|
|
86
|
+
export interface ConclusionEvent {
|
|
87
|
+
type: "conclusion";
|
|
88
|
+
explainId: string;
|
|
89
|
+
explainGraph: string;
|
|
90
|
+
label?: string;
|
|
91
|
+
derivedFrom?: string[];
|
|
92
|
+
}
|
|
93
|
+
export type StructuredExplainEvent = QuestionEvent | ExplorationEvent | FocusEvent | SynthesisEvent | AgentQuestionEvent | DecompositionEvent | AnalysisEvent | ReflectionEvent | ConclusionEvent;
|
|
54
94
|
export interface ProvenanceChainItem {
|
|
55
95
|
uri: string;
|
|
56
96
|
label: string;
|
|
@@ -68,10 +108,10 @@ export interface ExplainabilitySession {
|
|
|
68
108
|
exploration?: ExplorationEvent;
|
|
69
109
|
focus?: FocusEvent;
|
|
70
110
|
synthesis?: SynthesisEvent;
|
|
111
|
+
agentSteps?: StructuredExplainEvent[];
|
|
71
112
|
}
|
|
72
113
|
/**
|
|
73
|
-
* Extract event type from explainId URI
|
|
74
|
-
* e.g., "urn:trustgraph:question:abc123" → "question"
|
|
114
|
+
* Extract event type from explainId URI (graph-rag only)
|
|
75
115
|
*/
|
|
76
116
|
export declare function getEventType(explainId: string): ExplainEventType;
|
|
77
117
|
/**
|
|
@@ -87,24 +127,14 @@ export declare function extractQuotedTriple(term: Term): {
|
|
|
87
127
|
o: string;
|
|
88
128
|
} | null;
|
|
89
129
|
/**
|
|
90
|
-
*
|
|
130
|
+
* Detect event type from RDF types in embedded triples.
|
|
131
|
+
* Returns an agent event type if matched, "unknown" otherwise.
|
|
91
132
|
*/
|
|
133
|
+
export declare function getEventTypeFromTriples(triples: Triple[]): ExplainEventType;
|
|
92
134
|
export declare function parseQuestionTriples(explainId: string, explainGraph: string, triples: Triple[]): QuestionEvent;
|
|
93
|
-
/**
|
|
94
|
-
* Parse triples for an exploration event
|
|
95
|
-
*/
|
|
96
135
|
export declare function parseExplorationTriples(explainId: string, explainGraph: string, triples: Triple[]): ExplorationEvent;
|
|
97
|
-
/**
|
|
98
|
-
* Parse triples for a focus event
|
|
99
|
-
*/
|
|
100
136
|
export declare function parseFocusTriples(explainId: string, explainGraph: string, triples: Triple[]): FocusEvent;
|
|
101
|
-
/**
|
|
102
|
-
* Parse triples for a synthesis event
|
|
103
|
-
*/
|
|
104
137
|
export declare function parseSynthesisTriples(explainId: string, explainGraph: string, triples: Triple[]): SynthesisEvent;
|
|
105
|
-
/**
|
|
106
|
-
* Parse triples for an edge selection entity
|
|
107
|
-
*/
|
|
108
138
|
export declare function parseEdgeSelectionTriples(triples: Triple[]): {
|
|
109
139
|
edge: {
|
|
110
140
|
s: string;
|
|
@@ -114,7 +144,9 @@ export declare function parseEdgeSelectionTriples(triples: Triple[]): {
|
|
|
114
144
|
reasoning: string | null;
|
|
115
145
|
};
|
|
116
146
|
/**
|
|
117
|
-
* Parse triples
|
|
147
|
+
* Parse triples into a structured event.
|
|
148
|
+
* Tries RDF type detection first (agent events), then URI patterns (graph-rag).
|
|
149
|
+
* Returns null for events with no triples (inner graph-rag plumbing).
|
|
118
150
|
*/
|
|
119
151
|
export declare function parseExplainTriples(explainId: string, explainGraph: string, triples: Triple[]): StructuredExplainEvent | null;
|
|
120
152
|
//# sourceMappingURL=explainability.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"explainability.d.ts","sourceRoot":"","sources":["../../src/utils/explainability.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;
|
|
1
|
+
{"version":3,"file":"explainability.d.ts","sourceRoot":"","sources":["../../src/utils/explainability.ts"],"names":[],"mappings":"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"}
|