@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.
Files changed (91) hide show
  1. package/README.md +117 -0
  2. package/dist/causal/capabilities/causal-explainer.d.ts +33 -0
  3. package/dist/causal/capabilities/causal-explainer.d.ts.map +1 -0
  4. package/dist/causal/capabilities/causal-explainer.js +327 -0
  5. package/dist/causal/capabilities/causal-explainer.js.map +1 -0
  6. package/dist/causal/capabilities/causal-planner.d.ts +42 -0
  7. package/dist/causal/capabilities/causal-planner.d.ts.map +1 -0
  8. package/dist/causal/capabilities/causal-planner.js +289 -0
  9. package/dist/causal/capabilities/causal-planner.js.map +1 -0
  10. package/dist/causal/capabilities/effect-predictor.d.ts +30 -0
  11. package/dist/causal/capabilities/effect-predictor.d.ts.map +1 -0
  12. package/dist/causal/capabilities/effect-predictor.js +270 -0
  13. package/dist/causal/capabilities/effect-predictor.js.map +1 -0
  14. package/dist/causal/causal-reasoner.d.ts +63 -0
  15. package/dist/causal/causal-reasoner.d.ts.map +1 -0
  16. package/dist/causal/causal-reasoner.js +325 -0
  17. package/dist/causal/causal-reasoner.js.map +1 -0
  18. package/dist/causal/discovery/causal-extractor.d.ts +46 -0
  19. package/dist/causal/discovery/causal-extractor.d.ts.map +1 -0
  20. package/dist/causal/discovery/causal-extractor.js +154 -0
  21. package/dist/causal/discovery/causal-extractor.js.map +1 -0
  22. package/dist/causal/discovery/causal-validator.d.ts +50 -0
  23. package/dist/causal/discovery/causal-validator.d.ts.map +1 -0
  24. package/dist/causal/discovery/causal-validator.js +235 -0
  25. package/dist/causal/discovery/causal-validator.js.map +1 -0
  26. package/dist/causal/discovery/hypothesis-generator.d.ts +37 -0
  27. package/dist/causal/discovery/hypothesis-generator.d.ts.map +1 -0
  28. package/dist/causal/discovery/hypothesis-generator.js +225 -0
  29. package/dist/causal/discovery/hypothesis-generator.js.map +1 -0
  30. package/dist/causal/discovery/prompts.d.ts +99 -0
  31. package/dist/causal/discovery/prompts.d.ts.map +1 -0
  32. package/dist/causal/discovery/prompts.js +263 -0
  33. package/dist/causal/discovery/prompts.js.map +1 -0
  34. package/dist/causal/graph/causal-graph.d.ts +38 -0
  35. package/dist/causal/graph/causal-graph.d.ts.map +1 -0
  36. package/dist/causal/graph/causal-graph.js +321 -0
  37. package/dist/causal/graph/causal-graph.js.map +1 -0
  38. package/dist/causal/graph/graph-builder.d.ts +68 -0
  39. package/dist/causal/graph/graph-builder.d.ts.map +1 -0
  40. package/dist/causal/graph/graph-builder.js +128 -0
  41. package/dist/causal/graph/graph-builder.js.map +1 -0
  42. package/dist/causal/index.d.ts +28 -0
  43. package/dist/causal/index.d.ts.map +1 -0
  44. package/dist/causal/index.js +18 -0
  45. package/dist/causal/index.js.map +1 -0
  46. package/dist/causal/inference/adjustment.d.ts +5 -0
  47. package/dist/causal/inference/adjustment.d.ts.map +1 -0
  48. package/dist/causal/inference/adjustment.js +189 -0
  49. package/dist/causal/inference/adjustment.js.map +1 -0
  50. package/dist/causal/inference/counterfactual.d.ts +24 -0
  51. package/dist/causal/inference/counterfactual.d.ts.map +1 -0
  52. package/dist/causal/inference/counterfactual.js +199 -0
  53. package/dist/causal/inference/counterfactual.js.map +1 -0
  54. package/dist/causal/inference/d-separation.d.ts +4 -0
  55. package/dist/causal/inference/d-separation.d.ts.map +1 -0
  56. package/dist/causal/inference/d-separation.js +168 -0
  57. package/dist/causal/inference/d-separation.js.map +1 -0
  58. package/dist/causal/inference/inference-engine.d.ts +33 -0
  59. package/dist/causal/inference/inference-engine.d.ts.map +1 -0
  60. package/dist/causal/inference/inference-engine.js +254 -0
  61. package/dist/causal/inference/inference-engine.js.map +1 -0
  62. package/dist/causal/stores/causal-graph-store.d.ts +12 -0
  63. package/dist/causal/stores/causal-graph-store.d.ts.map +1 -0
  64. package/dist/causal/stores/causal-graph-store.js +60 -0
  65. package/dist/causal/stores/causal-graph-store.js.map +1 -0
  66. package/dist/causal/stores/causal-pattern-store.d.ts +19 -0
  67. package/dist/causal/stores/causal-pattern-store.d.ts.map +1 -0
  68. package/dist/causal/stores/causal-pattern-store.js +117 -0
  69. package/dist/causal/stores/causal-pattern-store.js.map +1 -0
  70. package/dist/causal/stores/intervention-log.d.ts +16 -0
  71. package/dist/causal/stores/intervention-log.d.ts.map +1 -0
  72. package/dist/causal/stores/intervention-log.js +113 -0
  73. package/dist/causal/stores/intervention-log.js.map +1 -0
  74. package/dist/index.d.ts +4 -0
  75. package/dist/index.d.ts.map +1 -1
  76. package/dist/index.js +2 -0
  77. package/dist/index.js.map +1 -1
  78. package/dist/learning/ab-testing.d.ts.map +1 -1
  79. package/dist/learning/ab-testing.js +6 -5
  80. package/dist/learning/ab-testing.js.map +1 -1
  81. package/dist/learning/auto-optimizer.d.ts.map +1 -1
  82. package/dist/learning/auto-optimizer.js +4 -2
  83. package/dist/learning/auto-optimizer.js.map +1 -1
  84. package/dist/learning/postgres-trace-store.d.ts.map +1 -1
  85. package/dist/learning/postgres-trace-store.js +15 -5
  86. package/dist/learning/postgres-trace-store.js.map +1 -1
  87. package/dist/learning/prompt-monitor.d.ts.map +1 -1
  88. package/dist/learning/prompt-monitor.js.map +1 -1
  89. package/dist/learning/rollback-manager.d.ts.map +1 -1
  90. package/dist/learning/rollback-manager.js.map +1 -1
  91. 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":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,MAAM,UAAU,sBAAsB,CACpC,KAAkB,EAClB,SAAiB,EACjB,OAAe;IAEf,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACzD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAClC,KAAK,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CACjD,CAAC;IACF,oBAAoB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAEpC,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACnD,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAChC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,OAAO,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC,CAAC,CACxE,CAAC;IAEF,MAAM,WAAW,GAAe,EAAE,CAAC;IAEnC,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,IAAI,UAAU,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;QACrD,KAAK,MAAM,MAAM,IAAI,YAAY,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,CAAC;YACpD,IAAI,kBAAkB,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC;gBAC1D,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACzB,IAAI,IAAI,KAAK,CAAC,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACzC,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;oBACtC,IAAI,MAAM,CAAC,MAAM,GAAG,OAAO;wBAAE,MAAM;gBACrC,CAAC;YACH,CAAC;QACH,CAAC;QACD,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM;IACpC,CAAC;IAED,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;IAE/B,OAAO;QACL,SAAS,EAAE,OAAO;QAClB,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,uBAAuB,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC;QAC7D,SAAS,EAAE,IAAI;QACf,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CACzB,KAAkB,EAClB,SAAiB,EACjB,OAAe,EACf,aAAuB;IAEvB,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAClC,KAAK,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CACjD,CAAC;IACF,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;QACjC,IAAI,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,MAAM,aAAa,GAAG,+BAA+B,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IACxE,MAAM,MAAM,GAAG,WAAW,CAAC,aAAa,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;IAE7E,OAAO,MAAM,CAAC,SAAS,CAAC;AAC1B,CAAC;AAED,SAAS,+BAA+B,CACtC,KAAkB,EAClB,MAAc;IAEd,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;IAC7B,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAE3C,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;QACrD,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,KAAkB,EAClB,SAAiB,EACjB,OAAe;IAEf,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACzD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAClD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACnD,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAChC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,OAAO,CACxC,CAAC;IAEF,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,IAAI,UAAU,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;QACrD,KAAK,MAAM,MAAM,IAAI,YAAY,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,CAAC;YACpD,IAAI,mBAAmB,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC;gBAC3D,OAAO;oBACL,SAAS,EAAE,MAAM;oBACjB,IAAI,EAAE,WAAW;oBACjB,OAAO,EAAE,wBAAwB,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC;oBAC7D,SAAS,EAAE,IAAI;oBACf,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,mBAAmB,CAC1B,KAAkB,EAClB,SAAiB,EACjB,OAAe,EACf,SAAmB;IAEnB,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;IAEvC,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAClD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,WAAW,GAAG,KAAK,CAAC;QACxB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/C,IAAI,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACnC,WAAW,GAAG,IAAI,CAAC;gBACnB,MAAM;YACR,CAAC;QACH,CAAC;QACD,IAAI,CAAC,WAAW;YAAE,OAAO,KAAK,CAAC;IACjC,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC1B,MAAM,gBAAgB,GAAG,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QACrD,KAAK,MAAM,MAAM,IAAI,gBAAgB,EAAE,CAAC;YACtC,IACE,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;gBAClC,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,EAC/B,CAAC;gBACD,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC1B,MAAM,WAAW,GAAG,eAAe,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;QACvD,MAAM,WAAW,GAAG,CAAC,SAAS,EAAE,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC;QAE/E,MAAM,SAAS,GAAG,WAAW,CAC3B,+BAA+B,CAAC,KAAK,EAAE,CAAC,CAAC,EACzC,CAAC,EACD,OAAO,EACP,WAAW,CACZ,CAAC;QACF,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC;YACzB,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,UAAU,CAAC,KAAkB,EAAE,SAAiB,EAAE,EAAU;IACnE,MAAM,SAAS,GAAG,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;IACzC,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC;AACnD,CAAC;AAED,SAAS,eAAe,CACtB,KAAkB,EAClB,KAAa,EACb,KAAa;IAEb,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACvE,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAEvE,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACtB,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,SAAS,uBAAuB,CAC9B,SAAiB,EACjB,OAAe,EACf,aAAuB;IAEvB,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,KAAK,OAAO,OAAO,SAAS,YAAY,OAAO,IAAI,SAAS,GAAG,CAAC;IACzE,CAAC;IAED,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5C,OAAO,KAAK,OAAO,OAAO,SAAS,WAAW,UAAU,OAAO,OAAO,IAAI,SAAS,KAAK,UAAU,OAAO,UAAU,GAAG,CAAC;AACzH,CAAC;AAED,SAAS,wBAAwB,CAC/B,SAAiB,EACjB,OAAe,EACf,SAAmB;IAEnB,MAAM,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/B,OAAO,KAAK,OAAO,OAAO,SAAS,WAAW,CAAC,OAAO,CAAC,IAAI,SAAS,QAAQ,SAAS,QAAQ,OAAO,IAAI,CAAC,KAAK,SAAS,QAAQ,SAAS,IAAI,CAAC;AAC/I,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,KAAkB,EAClB,SAAiB,EACjB,OAAe,EACf,OAAO,GAAG,CAAC;IAEX,MAAM,OAAO,GAAoB,EAAE,CAAC;IAEpC,MAAM,QAAQ,GAAG,sBAAsB,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IACnE,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzB,CAAC;IAED,MAAM,SAAS,GAAG,uBAAuB,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IACrE,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC1B,CAAC;IAED,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAClC,KAAK,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CACjD,CAAC;IAEF,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACnD,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAChC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,OAAO,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC,CAAC,CACxE,CAAC;IAEF,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,UAAU,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC;QACxE,KAAK,MAAM,MAAM,IAAI,YAAY,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,CAAC;YACpD,IAAI,kBAAkB,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC;gBAC1D,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CACzB,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,IAAI,KAAK,UAAU;oBACrB,CAAC,CAAC,SAAS,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM;oBACpC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAC/C,CAAC;gBACF,IAAI,CAAC,MAAM,EAAE,CAAC;oBACZ,OAAO,CAAC,IAAI,CAAC;wBACX,SAAS,EAAE,MAAM;wBACjB,IAAI,EAAE,UAAU;wBAChB,OAAO,EAAE,uBAAuB,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC;wBAC5D,SAAS,EAAE,IAAI,KAAK,CAAC,QAAQ,EAAE,SAAS,CAAC,MAAM,IAAI,CAAC,CAAC;wBACrD,OAAO,EAAE,IAAI;qBACd,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,QAAQ,CAAC,CAAC,YAAY,CAAI,GAAQ,EAAE,IAAY;IAC9C,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;QACf,MAAM,EAAE,CAAC;QACT,OAAO;IACT,CAAC;IACD,IAAI,GAAG,CAAC,MAAM,GAAG,IAAI;QAAE,OAAO;IAE9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,GAAG,CAAC,MAAM,GAAG,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5C,KAAK,MAAM,IAAI,IAAI,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC;YAC5D,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;AACH,CAAC"}
@@ -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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"}