@cogitator-ai/core 0.3.0 → 0.4.0
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/README.md +117 -0
- package/dist/causal/capabilities/causal-explainer.d.ts +33 -0
- package/dist/causal/capabilities/causal-explainer.d.ts.map +1 -0
- package/dist/causal/capabilities/causal-explainer.js +327 -0
- package/dist/causal/capabilities/causal-explainer.js.map +1 -0
- package/dist/causal/capabilities/causal-planner.d.ts +42 -0
- package/dist/causal/capabilities/causal-planner.d.ts.map +1 -0
- package/dist/causal/capabilities/causal-planner.js +289 -0
- package/dist/causal/capabilities/causal-planner.js.map +1 -0
- package/dist/causal/capabilities/effect-predictor.d.ts +30 -0
- package/dist/causal/capabilities/effect-predictor.d.ts.map +1 -0
- package/dist/causal/capabilities/effect-predictor.js +270 -0
- package/dist/causal/capabilities/effect-predictor.js.map +1 -0
- package/dist/causal/causal-reasoner.d.ts +63 -0
- package/dist/causal/causal-reasoner.d.ts.map +1 -0
- package/dist/causal/causal-reasoner.js +325 -0
- package/dist/causal/causal-reasoner.js.map +1 -0
- package/dist/causal/discovery/causal-extractor.d.ts +46 -0
- package/dist/causal/discovery/causal-extractor.d.ts.map +1 -0
- package/dist/causal/discovery/causal-extractor.js +154 -0
- package/dist/causal/discovery/causal-extractor.js.map +1 -0
- package/dist/causal/discovery/causal-validator.d.ts +50 -0
- package/dist/causal/discovery/causal-validator.d.ts.map +1 -0
- package/dist/causal/discovery/causal-validator.js +235 -0
- package/dist/causal/discovery/causal-validator.js.map +1 -0
- package/dist/causal/discovery/hypothesis-generator.d.ts +37 -0
- package/dist/causal/discovery/hypothesis-generator.d.ts.map +1 -0
- package/dist/causal/discovery/hypothesis-generator.js +225 -0
- package/dist/causal/discovery/hypothesis-generator.js.map +1 -0
- package/dist/causal/discovery/prompts.d.ts +99 -0
- package/dist/causal/discovery/prompts.d.ts.map +1 -0
- package/dist/causal/discovery/prompts.js +263 -0
- package/dist/causal/discovery/prompts.js.map +1 -0
- package/dist/causal/graph/causal-graph.d.ts +38 -0
- package/dist/causal/graph/causal-graph.d.ts.map +1 -0
- package/dist/causal/graph/causal-graph.js +321 -0
- package/dist/causal/graph/causal-graph.js.map +1 -0
- package/dist/causal/graph/graph-builder.d.ts +68 -0
- package/dist/causal/graph/graph-builder.d.ts.map +1 -0
- package/dist/causal/graph/graph-builder.js +128 -0
- package/dist/causal/graph/graph-builder.js.map +1 -0
- package/dist/causal/index.d.ts +28 -0
- package/dist/causal/index.d.ts.map +1 -0
- package/dist/causal/index.js +18 -0
- package/dist/causal/index.js.map +1 -0
- package/dist/causal/inference/adjustment.d.ts +5 -0
- package/dist/causal/inference/adjustment.d.ts.map +1 -0
- package/dist/causal/inference/adjustment.js +189 -0
- package/dist/causal/inference/adjustment.js.map +1 -0
- package/dist/causal/inference/counterfactual.d.ts +24 -0
- package/dist/causal/inference/counterfactual.d.ts.map +1 -0
- package/dist/causal/inference/counterfactual.js +199 -0
- package/dist/causal/inference/counterfactual.js.map +1 -0
- package/dist/causal/inference/d-separation.d.ts +4 -0
- package/dist/causal/inference/d-separation.d.ts.map +1 -0
- package/dist/causal/inference/d-separation.js +168 -0
- package/dist/causal/inference/d-separation.js.map +1 -0
- package/dist/causal/inference/inference-engine.d.ts +33 -0
- package/dist/causal/inference/inference-engine.d.ts.map +1 -0
- package/dist/causal/inference/inference-engine.js +254 -0
- package/dist/causal/inference/inference-engine.js.map +1 -0
- package/dist/causal/stores/causal-graph-store.d.ts +12 -0
- package/dist/causal/stores/causal-graph-store.d.ts.map +1 -0
- package/dist/causal/stores/causal-graph-store.js +60 -0
- package/dist/causal/stores/causal-graph-store.js.map +1 -0
- package/dist/causal/stores/causal-pattern-store.d.ts +19 -0
- package/dist/causal/stores/causal-pattern-store.d.ts.map +1 -0
- package/dist/causal/stores/causal-pattern-store.js +117 -0
- package/dist/causal/stores/causal-pattern-store.js.map +1 -0
- package/dist/causal/stores/intervention-log.d.ts +16 -0
- package/dist/causal/stores/intervention-log.d.ts.map +1 -0
- package/dist/causal/stores/intervention-log.js +113 -0
- package/dist/causal/stores/intervention-log.js.map +1 -0
- package/dist/index.d.ts +4 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +2 -0
- package/dist/index.js.map +1 -1
- package/dist/learning/ab-testing.d.ts.map +1 -1
- package/dist/learning/ab-testing.js +6 -5
- package/dist/learning/ab-testing.js.map +1 -1
- package/dist/learning/auto-optimizer.d.ts.map +1 -1
- package/dist/learning/auto-optimizer.js +4 -2
- package/dist/learning/auto-optimizer.js.map +1 -1
- package/dist/learning/postgres-trace-store.d.ts.map +1 -1
- package/dist/learning/postgres-trace-store.js +15 -5
- package/dist/learning/postgres-trace-store.js.map +1 -1
- package/dist/learning/prompt-monitor.d.ts.map +1 -1
- package/dist/learning/prompt-monitor.js.map +1 -1
- package/dist/learning/rollback-manager.d.ts.map +1 -1
- package/dist/learning/rollback-manager.js.map +1 -1
- package/package.json +5 -5
|
@@ -0,0 +1,189 @@
|
|
|
1
|
+
import { dSeparation } from './d-separation';
|
|
2
|
+
export function findBackdoorAdjustment(graph, treatment, outcome) {
|
|
3
|
+
if (!graph.hasNode(treatment) || !graph.hasNode(outcome)) {
|
|
4
|
+
return null;
|
|
5
|
+
}
|
|
6
|
+
const treatmentDescendants = new Set(graph.getDescendants(treatment).map((n) => n.id));
|
|
7
|
+
treatmentDescendants.add(treatment);
|
|
8
|
+
const allNodes = graph.getNodes().map((n) => n.id);
|
|
9
|
+
const candidates = allNodes.filter((n) => n !== treatment && n !== outcome && !treatmentDescendants.has(n));
|
|
10
|
+
const minimalSets = [];
|
|
11
|
+
for (let size = 0; size <= candidates.length; size++) {
|
|
12
|
+
for (const subset of combinations(candidates, size)) {
|
|
13
|
+
if (isValidBackdoorSet(graph, treatment, outcome, subset)) {
|
|
14
|
+
minimalSets.push(subset);
|
|
15
|
+
if (size === 0 || minimalSets.length > 0) {
|
|
16
|
+
const minSize = minimalSets[0].length;
|
|
17
|
+
if (subset.length > minSize)
|
|
18
|
+
break;
|
|
19
|
+
}
|
|
20
|
+
}
|
|
21
|
+
}
|
|
22
|
+
if (minimalSets.length > 0)
|
|
23
|
+
break;
|
|
24
|
+
}
|
|
25
|
+
if (minimalSets.length === 0) {
|
|
26
|
+
return null;
|
|
27
|
+
}
|
|
28
|
+
const bestSet = minimalSets[0];
|
|
29
|
+
return {
|
|
30
|
+
variables: bestSet,
|
|
31
|
+
type: 'backdoor',
|
|
32
|
+
formula: generateBackdoorFormula(treatment, outcome, bestSet),
|
|
33
|
+
isMinimal: true,
|
|
34
|
+
isValid: true,
|
|
35
|
+
};
|
|
36
|
+
}
|
|
37
|
+
function isValidBackdoorSet(graph, treatment, outcome, adjustmentSet) {
|
|
38
|
+
const treatmentDescendants = new Set(graph.getDescendants(treatment).map((n) => n.id));
|
|
39
|
+
for (const node of adjustmentSet) {
|
|
40
|
+
if (treatmentDescendants.has(node)) {
|
|
41
|
+
return false;
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
const modifiedGraph = createGraphWithoutOutgoingEdges(graph, treatment);
|
|
45
|
+
const result = dSeparation(modifiedGraph, treatment, outcome, adjustmentSet);
|
|
46
|
+
return result.separated;
|
|
47
|
+
}
|
|
48
|
+
function createGraphWithoutOutgoingEdges(graph, nodeId) {
|
|
49
|
+
const cloned = graph.clone();
|
|
50
|
+
const children = graph.getChildren(nodeId);
|
|
51
|
+
for (const child of children) {
|
|
52
|
+
const edge = cloned.getEdgeBetween(nodeId, child.id);
|
|
53
|
+
if (edge) {
|
|
54
|
+
cloned.removeEdge(edge.id);
|
|
55
|
+
}
|
|
56
|
+
}
|
|
57
|
+
return cloned;
|
|
58
|
+
}
|
|
59
|
+
export function findFrontdoorAdjustment(graph, treatment, outcome) {
|
|
60
|
+
if (!graph.hasNode(treatment) || !graph.hasNode(outcome)) {
|
|
61
|
+
return null;
|
|
62
|
+
}
|
|
63
|
+
const paths = graph.findPaths(treatment, outcome);
|
|
64
|
+
if (paths.length === 0) {
|
|
65
|
+
return null;
|
|
66
|
+
}
|
|
67
|
+
const allNodes = graph.getNodes().map((n) => n.id);
|
|
68
|
+
const candidates = allNodes.filter((n) => n !== treatment && n !== outcome);
|
|
69
|
+
for (let size = 1; size <= candidates.length; size++) {
|
|
70
|
+
for (const subset of combinations(candidates, size)) {
|
|
71
|
+
if (isValidFrontdoorSet(graph, treatment, outcome, subset)) {
|
|
72
|
+
return {
|
|
73
|
+
variables: subset,
|
|
74
|
+
type: 'frontdoor',
|
|
75
|
+
formula: generateFrontdoorFormula(treatment, outcome, subset),
|
|
76
|
+
isMinimal: true,
|
|
77
|
+
isValid: true,
|
|
78
|
+
};
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
}
|
|
82
|
+
return null;
|
|
83
|
+
}
|
|
84
|
+
function isValidFrontdoorSet(graph, treatment, outcome, mediators) {
|
|
85
|
+
const mediatorSet = new Set(mediators);
|
|
86
|
+
const paths = graph.findPaths(treatment, outcome);
|
|
87
|
+
for (const path of paths) {
|
|
88
|
+
let intercepted = false;
|
|
89
|
+
for (let i = 1; i < path.nodes.length - 1; i++) {
|
|
90
|
+
if (mediatorSet.has(path.nodes[i])) {
|
|
91
|
+
intercepted = true;
|
|
92
|
+
break;
|
|
93
|
+
}
|
|
94
|
+
}
|
|
95
|
+
if (!intercepted)
|
|
96
|
+
return false;
|
|
97
|
+
}
|
|
98
|
+
for (const m of mediators) {
|
|
99
|
+
const treatmentParents = graph.getParents(treatment);
|
|
100
|
+
for (const parent of treatmentParents) {
|
|
101
|
+
if (graph.getEdgeBetween(parent.id, m) ||
|
|
102
|
+
isAncestor(graph, parent.id, m)) {
|
|
103
|
+
return false;
|
|
104
|
+
}
|
|
105
|
+
}
|
|
106
|
+
}
|
|
107
|
+
for (const m of mediators) {
|
|
108
|
+
const confounders = findConfounders(graph, m, outcome);
|
|
109
|
+
const backdoorSet = [treatment, ...confounders.filter((c) => c !== treatment)];
|
|
110
|
+
const separated = dSeparation(createGraphWithoutOutgoingEdges(graph, m), m, outcome, backdoorSet);
|
|
111
|
+
if (!separated.separated) {
|
|
112
|
+
return false;
|
|
113
|
+
}
|
|
114
|
+
}
|
|
115
|
+
return true;
|
|
116
|
+
}
|
|
117
|
+
function isAncestor(graph, potential, of) {
|
|
118
|
+
const ancestors = graph.getAncestors(of);
|
|
119
|
+
return ancestors.some((a) => a.id === potential);
|
|
120
|
+
}
|
|
121
|
+
function findConfounders(graph, node1, node2) {
|
|
122
|
+
const ancestors1 = new Set(graph.getAncestors(node1).map((n) => n.id));
|
|
123
|
+
const ancestors2 = new Set(graph.getAncestors(node2).map((n) => n.id));
|
|
124
|
+
const confounders = [];
|
|
125
|
+
for (const a of ancestors1) {
|
|
126
|
+
if (ancestors2.has(a)) {
|
|
127
|
+
confounders.push(a);
|
|
128
|
+
}
|
|
129
|
+
}
|
|
130
|
+
return confounders;
|
|
131
|
+
}
|
|
132
|
+
function generateBackdoorFormula(treatment, outcome, adjustmentSet) {
|
|
133
|
+
if (adjustmentSet.length === 0) {
|
|
134
|
+
return `P(${outcome}|do(${treatment})) = Σ P(${outcome}|${treatment})`;
|
|
135
|
+
}
|
|
136
|
+
const adjustVars = adjustmentSet.join(', ');
|
|
137
|
+
return `P(${outcome}|do(${treatment})) = Σ_{${adjustVars}} P(${outcome}|${treatment}, ${adjustVars}) P(${adjustVars})`;
|
|
138
|
+
}
|
|
139
|
+
function generateFrontdoorFormula(treatment, outcome, mediators) {
|
|
140
|
+
const m = mediators.join(', ');
|
|
141
|
+
return `P(${outcome}|do(${treatment})) = Σ_{${m}} P(${m}|${treatment}) Σ_{${treatment}'} P(${outcome}|${m}, ${treatment}') P(${treatment}')`;
|
|
142
|
+
}
|
|
143
|
+
export function findAllAdjustmentSets(graph, treatment, outcome, maxSize = 5) {
|
|
144
|
+
const results = [];
|
|
145
|
+
const backdoor = findBackdoorAdjustment(graph, treatment, outcome);
|
|
146
|
+
if (backdoor) {
|
|
147
|
+
results.push(backdoor);
|
|
148
|
+
}
|
|
149
|
+
const frontdoor = findFrontdoorAdjustment(graph, treatment, outcome);
|
|
150
|
+
if (frontdoor) {
|
|
151
|
+
results.push(frontdoor);
|
|
152
|
+
}
|
|
153
|
+
const treatmentDescendants = new Set(graph.getDescendants(treatment).map((n) => n.id));
|
|
154
|
+
const allNodes = graph.getNodes().map((n) => n.id);
|
|
155
|
+
const candidates = allNodes.filter((n) => n !== treatment && n !== outcome && !treatmentDescendants.has(n));
|
|
156
|
+
for (let size = 0; size <= Math.min(maxSize, candidates.length); size++) {
|
|
157
|
+
for (const subset of combinations(candidates, size)) {
|
|
158
|
+
if (isValidBackdoorSet(graph, treatment, outcome, subset)) {
|
|
159
|
+
const exists = results.some((r) => r.type === 'backdoor' &&
|
|
160
|
+
r.variables.length === subset.length &&
|
|
161
|
+
r.variables.every((v) => subset.includes(v)));
|
|
162
|
+
if (!exists) {
|
|
163
|
+
results.push({
|
|
164
|
+
variables: subset,
|
|
165
|
+
type: 'backdoor',
|
|
166
|
+
formula: generateBackdoorFormula(treatment, outcome, subset),
|
|
167
|
+
isMinimal: size === (backdoor?.variables.length ?? 0),
|
|
168
|
+
isValid: true,
|
|
169
|
+
});
|
|
170
|
+
}
|
|
171
|
+
}
|
|
172
|
+
}
|
|
173
|
+
}
|
|
174
|
+
return results;
|
|
175
|
+
}
|
|
176
|
+
function* combinations(arr, size) {
|
|
177
|
+
if (size === 0) {
|
|
178
|
+
yield [];
|
|
179
|
+
return;
|
|
180
|
+
}
|
|
181
|
+
if (arr.length < size)
|
|
182
|
+
return;
|
|
183
|
+
for (let i = 0; i <= arr.length - size; i++) {
|
|
184
|
+
for (const rest of combinations(arr.slice(i + 1), size - 1)) {
|
|
185
|
+
yield [arr[i], ...rest];
|
|
186
|
+
}
|
|
187
|
+
}
|
|
188
|
+
}
|
|
189
|
+
//# sourceMappingURL=adjustment.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"adjustment.js","sourceRoot":"","sources":["../../../src/causal/inference/adjustment.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
import type { CausalGraph, CounterfactualQuery, CounterfactualResult } from '@cogitator-ai/types';
|
|
2
|
+
export interface CounterfactualReasonerOptions {
|
|
3
|
+
defaultNoiseMean?: number;
|
|
4
|
+
defaultNoiseStd?: number;
|
|
5
|
+
maxIterations?: number;
|
|
6
|
+
convergenceThreshold?: number;
|
|
7
|
+
}
|
|
8
|
+
export declare class CounterfactualReasoner {
|
|
9
|
+
private options;
|
|
10
|
+
constructor(options?: CounterfactualReasonerOptions);
|
|
11
|
+
evaluate(graph: CausalGraph, query: CounterfactualQuery): CounterfactualResult;
|
|
12
|
+
private abduction;
|
|
13
|
+
private action;
|
|
14
|
+
private prediction;
|
|
15
|
+
private evaluateEquation;
|
|
16
|
+
private evaluateEquationWithNoise;
|
|
17
|
+
private computeValue;
|
|
18
|
+
private sampleNoise;
|
|
19
|
+
private sampleGaussian;
|
|
20
|
+
private toNumber;
|
|
21
|
+
private generateExplanation;
|
|
22
|
+
}
|
|
23
|
+
export declare function evaluateCounterfactual(graph: CausalGraph, query: CounterfactualQuery, options?: CounterfactualReasonerOptions): CounterfactualResult;
|
|
24
|
+
//# sourceMappingURL=counterfactual.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"counterfactual.d.ts","sourceRoot":"","sources":["../../../src/causal/inference/counterfactual.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EAEX,mBAAmB,EACnB,oBAAoB,EAErB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,6BAA6B;IAC5C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,qBAAa,sBAAsB;IACjC,OAAO,CAAC,OAAO,CAA0C;gBAE7C,OAAO,GAAE,6BAAkC;IASvD,QAAQ,CACN,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,mBAAmB,GACzB,oBAAoB;IA4BvB,OAAO,CAAC,SAAS;IA6BjB,OAAO,CAAC,MAAM;IAkBd,OAAO,CAAC,UAAU;IA2ClB,OAAO,CAAC,gBAAgB;IAmBxB,OAAO,CAAC,yBAAyB;IAoDjC,OAAO,CAAC,YAAY;IAuBpB,OAAO,CAAC,WAAW;IAwBnB,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,mBAAmB;CAa5B;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,mBAAmB,EAC1B,OAAO,CAAC,EAAE,6BAA6B,GACtC,oBAAoB,CAGtB"}
|
|
@@ -0,0 +1,199 @@
|
|
|
1
|
+
export class CounterfactualReasoner {
|
|
2
|
+
options;
|
|
3
|
+
constructor(options = {}) {
|
|
4
|
+
this.options = {
|
|
5
|
+
defaultNoiseMean: options.defaultNoiseMean ?? 0,
|
|
6
|
+
defaultNoiseStd: options.defaultNoiseStd ?? 1,
|
|
7
|
+
maxIterations: options.maxIterations ?? 100,
|
|
8
|
+
convergenceThreshold: options.convergenceThreshold ?? 0.001,
|
|
9
|
+
};
|
|
10
|
+
}
|
|
11
|
+
evaluate(graph, query) {
|
|
12
|
+
const abductionResult = this.abduction(graph, query.factual);
|
|
13
|
+
const actionResult = this.action(graph, query.intervention, abductionResult);
|
|
14
|
+
const predictionResult = this.prediction(graph, query.target, actionResult);
|
|
15
|
+
const factualValue = query.factual[query.target] ?? this.computeValue(graph, query.target, query.factual, abductionResult);
|
|
16
|
+
return {
|
|
17
|
+
query,
|
|
18
|
+
factualValue,
|
|
19
|
+
counterfactualValue: predictionResult.value,
|
|
20
|
+
probability: predictionResult.probability,
|
|
21
|
+
explanation: this.generateExplanation(query, factualValue, predictionResult.value),
|
|
22
|
+
reasoning: {
|
|
23
|
+
abduction: abductionResult,
|
|
24
|
+
action: actionResult,
|
|
25
|
+
prediction: predictionResult.values,
|
|
26
|
+
},
|
|
27
|
+
};
|
|
28
|
+
}
|
|
29
|
+
abduction(graph, factual) {
|
|
30
|
+
const noiseTerms = {};
|
|
31
|
+
const sortedNodes = graph.topologicalSort();
|
|
32
|
+
for (const nodeId of sortedNodes) {
|
|
33
|
+
const node = graph.getNode(nodeId);
|
|
34
|
+
if (!node)
|
|
35
|
+
continue;
|
|
36
|
+
if (factual[nodeId] !== undefined && node.equation) {
|
|
37
|
+
const observedValue = this.toNumber(factual[nodeId]);
|
|
38
|
+
const predictedValue = this.evaluateEquation(node.equation, graph, nodeId, factual, {});
|
|
39
|
+
noiseTerms[nodeId] = observedValue - predictedValue;
|
|
40
|
+
}
|
|
41
|
+
else {
|
|
42
|
+
noiseTerms[nodeId] = this.sampleNoise(node);
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
return noiseTerms;
|
|
46
|
+
}
|
|
47
|
+
action(_graph, intervention, noiseTerms) {
|
|
48
|
+
const result = {};
|
|
49
|
+
for (const [key, value] of Object.entries(noiseTerms)) {
|
|
50
|
+
result[key] = value;
|
|
51
|
+
}
|
|
52
|
+
for (const [variable, value] of Object.entries(intervention)) {
|
|
53
|
+
result[variable] = value;
|
|
54
|
+
}
|
|
55
|
+
return result;
|
|
56
|
+
}
|
|
57
|
+
prediction(graph, target, state) {
|
|
58
|
+
const sortedNodes = graph.topologicalSort();
|
|
59
|
+
const computedValues = { ...state };
|
|
60
|
+
for (const nodeId of sortedNodes) {
|
|
61
|
+
if (computedValues[nodeId] !== undefined && typeof computedValues[nodeId] !== 'number') {
|
|
62
|
+
continue;
|
|
63
|
+
}
|
|
64
|
+
const node = graph.getNode(nodeId);
|
|
65
|
+
if (!node)
|
|
66
|
+
continue;
|
|
67
|
+
if (node.equation) {
|
|
68
|
+
const noiseValue = typeof computedValues[nodeId] === 'number'
|
|
69
|
+
? computedValues[nodeId]
|
|
70
|
+
: 0;
|
|
71
|
+
const parentValues = {};
|
|
72
|
+
for (const parent of graph.getParents(nodeId)) {
|
|
73
|
+
if (computedValues[parent.id] !== undefined) {
|
|
74
|
+
parentValues[parent.id] = computedValues[parent.id];
|
|
75
|
+
}
|
|
76
|
+
}
|
|
77
|
+
computedValues[nodeId] = this.evaluateEquationWithNoise(node.equation, parentValues, noiseValue);
|
|
78
|
+
}
|
|
79
|
+
}
|
|
80
|
+
return {
|
|
81
|
+
value: computedValues[target] ?? 0,
|
|
82
|
+
probability: 1.0,
|
|
83
|
+
values: computedValues,
|
|
84
|
+
};
|
|
85
|
+
}
|
|
86
|
+
evaluateEquation(equation, graph, nodeId, values, _noiseTerms) {
|
|
87
|
+
const parents = graph.getParents(nodeId);
|
|
88
|
+
const parentValues = {};
|
|
89
|
+
for (const parent of parents) {
|
|
90
|
+
if (values[parent.id] !== undefined) {
|
|
91
|
+
parentValues[parent.id] = values[parent.id];
|
|
92
|
+
}
|
|
93
|
+
}
|
|
94
|
+
return this.evaluateEquationWithNoise(equation, parentValues, 0);
|
|
95
|
+
}
|
|
96
|
+
evaluateEquationWithNoise(equation, parentValues, noise) {
|
|
97
|
+
switch (equation.type) {
|
|
98
|
+
case 'linear': {
|
|
99
|
+
let result = equation.intercept ?? 0;
|
|
100
|
+
if (equation.coefficients) {
|
|
101
|
+
for (const [variable, coefficient] of Object.entries(equation.coefficients)) {
|
|
102
|
+
const value = this.toNumber(parentValues[variable] ?? 0);
|
|
103
|
+
result += coefficient * value;
|
|
104
|
+
}
|
|
105
|
+
}
|
|
106
|
+
return result + noise;
|
|
107
|
+
}
|
|
108
|
+
case 'logistic': {
|
|
109
|
+
let linearPart = equation.intercept ?? 0;
|
|
110
|
+
if (equation.coefficients) {
|
|
111
|
+
for (const [variable, coefficient] of Object.entries(equation.coefficients)) {
|
|
112
|
+
const value = this.toNumber(parentValues[variable] ?? 0);
|
|
113
|
+
linearPart += coefficient * value;
|
|
114
|
+
}
|
|
115
|
+
}
|
|
116
|
+
linearPart += noise;
|
|
117
|
+
return 1 / (1 + Math.exp(-linearPart));
|
|
118
|
+
}
|
|
119
|
+
case 'polynomial': {
|
|
120
|
+
let result = equation.intercept ?? 0;
|
|
121
|
+
if (equation.coefficients) {
|
|
122
|
+
for (const [variable, coefficient] of Object.entries(equation.coefficients)) {
|
|
123
|
+
const value = this.toNumber(parentValues[variable] ?? 0);
|
|
124
|
+
const [varName, powerStr] = variable.split('^');
|
|
125
|
+
const power = powerStr ? parseInt(powerStr, 10) : 1;
|
|
126
|
+
const actualValue = this.toNumber(parentValues[varName] ?? value);
|
|
127
|
+
result += coefficient * Math.pow(actualValue, power);
|
|
128
|
+
}
|
|
129
|
+
}
|
|
130
|
+
return result + noise;
|
|
131
|
+
}
|
|
132
|
+
case 'custom': {
|
|
133
|
+
return noise;
|
|
134
|
+
}
|
|
135
|
+
default:
|
|
136
|
+
return noise;
|
|
137
|
+
}
|
|
138
|
+
}
|
|
139
|
+
computeValue(graph, target, observed, noiseTerms) {
|
|
140
|
+
const node = graph.getNode(target);
|
|
141
|
+
if (!node || !node.equation) {
|
|
142
|
+
return observed[target] ?? 0;
|
|
143
|
+
}
|
|
144
|
+
const parentValues = {};
|
|
145
|
+
for (const parent of graph.getParents(target)) {
|
|
146
|
+
parentValues[parent.id] = observed[parent.id] ?? 0;
|
|
147
|
+
}
|
|
148
|
+
return this.evaluateEquationWithNoise(node.equation, parentValues, noiseTerms[target] ?? 0);
|
|
149
|
+
}
|
|
150
|
+
sampleNoise(node) {
|
|
151
|
+
const params = node.equation?.noiseParams ?? {};
|
|
152
|
+
const distribution = node.equation?.noiseDistribution ?? 'gaussian';
|
|
153
|
+
switch (distribution) {
|
|
154
|
+
case 'gaussian': {
|
|
155
|
+
const mean = params.mean ?? this.options.defaultNoiseMean;
|
|
156
|
+
const std = params.std ?? this.options.defaultNoiseStd;
|
|
157
|
+
return this.sampleGaussian(mean, std);
|
|
158
|
+
}
|
|
159
|
+
case 'uniform': {
|
|
160
|
+
const min = params.min ?? -1;
|
|
161
|
+
const max = params.max ?? 1;
|
|
162
|
+
return min + Math.random() * (max - min);
|
|
163
|
+
}
|
|
164
|
+
case 'bernoulli': {
|
|
165
|
+
const p = params.p ?? 0.5;
|
|
166
|
+
return Math.random() < p ? 1 : 0;
|
|
167
|
+
}
|
|
168
|
+
default:
|
|
169
|
+
return 0;
|
|
170
|
+
}
|
|
171
|
+
}
|
|
172
|
+
sampleGaussian(mean, std) {
|
|
173
|
+
const u1 = Math.random();
|
|
174
|
+
const u2 = Math.random();
|
|
175
|
+
const z = Math.sqrt(-2 * Math.log(u1)) * Math.cos(2 * Math.PI * u2);
|
|
176
|
+
return mean + std * z;
|
|
177
|
+
}
|
|
178
|
+
toNumber(value) {
|
|
179
|
+
if (typeof value === 'number')
|
|
180
|
+
return value;
|
|
181
|
+
if (typeof value === 'boolean')
|
|
182
|
+
return value ? 1 : 0;
|
|
183
|
+
const parsed = parseFloat(value);
|
|
184
|
+
return isNaN(parsed) ? 0 : parsed;
|
|
185
|
+
}
|
|
186
|
+
generateExplanation(query, factualValue, counterfactualValue) {
|
|
187
|
+
const interventionDesc = Object.entries(query.intervention)
|
|
188
|
+
.map(([k, v]) => `${k}=${v}`)
|
|
189
|
+
.join(', ');
|
|
190
|
+
return `Given the factual observation where ${query.target}=${factualValue}, ` +
|
|
191
|
+
`if we had intervened to set ${interventionDesc}, ` +
|
|
192
|
+
`then ${query.target} would have been ${counterfactualValue}.`;
|
|
193
|
+
}
|
|
194
|
+
}
|
|
195
|
+
export function evaluateCounterfactual(graph, query, options) {
|
|
196
|
+
const reasoner = new CounterfactualReasoner(options);
|
|
197
|
+
return reasoner.evaluate(graph, query);
|
|
198
|
+
}
|
|
199
|
+
//# sourceMappingURL=counterfactual.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"counterfactual.js","sourceRoot":"","sources":["../../../src/causal/inference/counterfactual.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
import type { CausalGraph, DSeparationResult } from '@cogitator-ai/types';
|
|
2
|
+
export declare function dSeparation(graph: CausalGraph, x: string | string[], y: string | string[], z?: string[]): DSeparationResult;
|
|
3
|
+
export declare function findMinimalSeparatingSet(graph: CausalGraph, x: string | string[], y: string | string[], forbidden?: Set<string>): string[] | null;
|
|
4
|
+
//# sourceMappingURL=d-separation.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"d-separation.d.ts","sourceRoot":"","sources":["../../../src/causal/inference/d-separation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EAEX,iBAAiB,EAElB,MAAM,qBAAqB,CAAC;AAE7B,wBAAgB,WAAW,CACzB,KAAK,EAAE,WAAW,EAClB,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,EACpB,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,EACpB,CAAC,GAAE,MAAM,EAAO,GACf,iBAAiB,CAkCnB;AA2JD,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,WAAW,EAClB,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,EACpB,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,EACpB,SAAS,GAAE,GAAG,CAAC,MAAM,CAAa,GACjC,MAAM,EAAE,GAAG,IAAI,CAmBjB"}
|
|
@@ -0,0 +1,168 @@
|
|
|
1
|
+
export function dSeparation(graph, x, y, z = []) {
|
|
2
|
+
const xSet = new Set(Array.isArray(x) ? x : [x]);
|
|
3
|
+
const ySet = new Set(Array.isArray(y) ? y : [y]);
|
|
4
|
+
const zSet = new Set(z);
|
|
5
|
+
const allPaths = [];
|
|
6
|
+
for (const xNode of xSet) {
|
|
7
|
+
for (const yNode of ySet) {
|
|
8
|
+
const paths = findAllUndirectedPaths(graph, xNode, yNode);
|
|
9
|
+
allPaths.push(...paths);
|
|
10
|
+
}
|
|
11
|
+
}
|
|
12
|
+
const blockedPaths = [];
|
|
13
|
+
const openPaths = [];
|
|
14
|
+
for (const path of allPaths) {
|
|
15
|
+
const blockResult = isPathBlocked(graph, path, zSet);
|
|
16
|
+
if (blockResult.blocked) {
|
|
17
|
+
path.isBlocked = true;
|
|
18
|
+
path.blockingNodes = blockResult.blockingNodes;
|
|
19
|
+
blockedPaths.push(path);
|
|
20
|
+
}
|
|
21
|
+
else {
|
|
22
|
+
openPaths.push(path);
|
|
23
|
+
}
|
|
24
|
+
}
|
|
25
|
+
return {
|
|
26
|
+
separated: openPaths.length === 0,
|
|
27
|
+
paths: allPaths,
|
|
28
|
+
blockedPaths,
|
|
29
|
+
openPaths,
|
|
30
|
+
};
|
|
31
|
+
}
|
|
32
|
+
function findAllUndirectedPaths(graph, from, to, maxLength = 10) {
|
|
33
|
+
const paths = [];
|
|
34
|
+
const visited = new Set();
|
|
35
|
+
const dfs = (current, path, depth) => {
|
|
36
|
+
if (depth > maxLength)
|
|
37
|
+
return;
|
|
38
|
+
if (current === to && path.length > 1) {
|
|
39
|
+
paths.push({
|
|
40
|
+
nodes: [...path],
|
|
41
|
+
edges: [],
|
|
42
|
+
totalStrength: 1,
|
|
43
|
+
isBlocked: false,
|
|
44
|
+
blockingNodes: [],
|
|
45
|
+
});
|
|
46
|
+
return;
|
|
47
|
+
}
|
|
48
|
+
visited.add(current);
|
|
49
|
+
const neighbors = new Set();
|
|
50
|
+
for (const parent of graph.getParents(current)) {
|
|
51
|
+
neighbors.add(parent.id);
|
|
52
|
+
}
|
|
53
|
+
for (const child of graph.getChildren(current)) {
|
|
54
|
+
neighbors.add(child.id);
|
|
55
|
+
}
|
|
56
|
+
for (const neighbor of neighbors) {
|
|
57
|
+
if (!visited.has(neighbor)) {
|
|
58
|
+
dfs(neighbor, [...path, neighbor], depth + 1);
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
visited.delete(current);
|
|
62
|
+
};
|
|
63
|
+
dfs(from, [from], 0);
|
|
64
|
+
return paths;
|
|
65
|
+
}
|
|
66
|
+
function isPathBlocked(graph, path, conditioningSet) {
|
|
67
|
+
const blockingNodes = [];
|
|
68
|
+
for (let i = 1; i < path.nodes.length - 1; i++) {
|
|
69
|
+
const prev = path.nodes[i - 1];
|
|
70
|
+
const curr = path.nodes[i];
|
|
71
|
+
const next = path.nodes[i + 1];
|
|
72
|
+
const tripleType = getLocalTripleType(graph, prev, curr, next);
|
|
73
|
+
if (tripleType === 'chain' || tripleType === 'fork') {
|
|
74
|
+
if (conditioningSet.has(curr)) {
|
|
75
|
+
blockingNodes.push(curr);
|
|
76
|
+
}
|
|
77
|
+
}
|
|
78
|
+
else if (tripleType === 'collider') {
|
|
79
|
+
const colliderOrDescendantInZ = isColliderOrDescendantInSet(graph, curr, conditioningSet);
|
|
80
|
+
if (!colliderOrDescendantInZ) {
|
|
81
|
+
blockingNodes.push(curr);
|
|
82
|
+
}
|
|
83
|
+
}
|
|
84
|
+
}
|
|
85
|
+
const blocked = blockingNodes.length > 0 || hasAllBlockedTriples(graph, path, conditioningSet);
|
|
86
|
+
return { blocked, blockingNodes };
|
|
87
|
+
}
|
|
88
|
+
function getLocalTripleType(graph, a, b, c) {
|
|
89
|
+
const aToB = graph.getEdgeBetween(a, b) !== undefined;
|
|
90
|
+
const bToA = graph.getEdgeBetween(b, a) !== undefined;
|
|
91
|
+
const bToC = graph.getEdgeBetween(b, c) !== undefined;
|
|
92
|
+
const cToB = graph.getEdgeBetween(c, b) !== undefined;
|
|
93
|
+
if ((aToB && bToC) || (cToB && bToA)) {
|
|
94
|
+
return 'chain';
|
|
95
|
+
}
|
|
96
|
+
if (bToA && bToC) {
|
|
97
|
+
return 'fork';
|
|
98
|
+
}
|
|
99
|
+
if (aToB && cToB) {
|
|
100
|
+
return 'collider';
|
|
101
|
+
}
|
|
102
|
+
if (aToB || bToA) {
|
|
103
|
+
if (bToC || cToB) {
|
|
104
|
+
return 'chain';
|
|
105
|
+
}
|
|
106
|
+
}
|
|
107
|
+
return 'chain';
|
|
108
|
+
}
|
|
109
|
+
function isColliderOrDescendantInSet(graph, nodeId, conditioningSet) {
|
|
110
|
+
if (conditioningSet.has(nodeId))
|
|
111
|
+
return true;
|
|
112
|
+
const descendants = graph.getDescendants(nodeId);
|
|
113
|
+
for (const desc of descendants) {
|
|
114
|
+
if (conditioningSet.has(desc.id))
|
|
115
|
+
return true;
|
|
116
|
+
}
|
|
117
|
+
return false;
|
|
118
|
+
}
|
|
119
|
+
function hasAllBlockedTriples(graph, path, conditioningSet) {
|
|
120
|
+
if (path.nodes.length < 3)
|
|
121
|
+
return false;
|
|
122
|
+
for (let i = 1; i < path.nodes.length - 1; i++) {
|
|
123
|
+
const prev = path.nodes[i - 1];
|
|
124
|
+
const curr = path.nodes[i];
|
|
125
|
+
const next = path.nodes[i + 1];
|
|
126
|
+
const tripleType = getLocalTripleType(graph, prev, curr, next);
|
|
127
|
+
if (tripleType === 'chain' || tripleType === 'fork') {
|
|
128
|
+
if (conditioningSet.has(curr)) {
|
|
129
|
+
return true;
|
|
130
|
+
}
|
|
131
|
+
}
|
|
132
|
+
else if (tripleType === 'collider') {
|
|
133
|
+
if (!isColliderOrDescendantInSet(graph, curr, conditioningSet)) {
|
|
134
|
+
return true;
|
|
135
|
+
}
|
|
136
|
+
}
|
|
137
|
+
}
|
|
138
|
+
return false;
|
|
139
|
+
}
|
|
140
|
+
export function findMinimalSeparatingSet(graph, x, y, forbidden = new Set()) {
|
|
141
|
+
const xSet = new Set(Array.isArray(x) ? x : [x]);
|
|
142
|
+
const ySet = new Set(Array.isArray(y) ? y : [y]);
|
|
143
|
+
const allNodes = graph.getNodes().map((n) => n.id);
|
|
144
|
+
const candidates = allNodes.filter((n) => !xSet.has(n) && !ySet.has(n) && !forbidden.has(n));
|
|
145
|
+
for (let size = 0; size <= candidates.length; size++) {
|
|
146
|
+
for (const subset of combinations(candidates, size)) {
|
|
147
|
+
const result = dSeparation(graph, x, y, subset);
|
|
148
|
+
if (result.separated) {
|
|
149
|
+
return subset;
|
|
150
|
+
}
|
|
151
|
+
}
|
|
152
|
+
}
|
|
153
|
+
return null;
|
|
154
|
+
}
|
|
155
|
+
function* combinations(arr, size) {
|
|
156
|
+
if (size === 0) {
|
|
157
|
+
yield [];
|
|
158
|
+
return;
|
|
159
|
+
}
|
|
160
|
+
if (arr.length < size)
|
|
161
|
+
return;
|
|
162
|
+
for (let i = 0; i <= arr.length - size; i++) {
|
|
163
|
+
for (const rest of combinations(arr.slice(i + 1), size - 1)) {
|
|
164
|
+
yield [arr[i], ...rest];
|
|
165
|
+
}
|
|
166
|
+
}
|
|
167
|
+
}
|
|
168
|
+
//# sourceMappingURL=d-separation.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"d-separation.js","sourceRoot":"","sources":["../../../src/causal/inference/d-separation.ts"],"names":[],"mappings":"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"}
|