@cogitator-ai/core 0.3.0 → 0.5.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 (169) 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 +334 -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 +291 -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 +266 -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 +328 -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 +237 -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 +228 -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 +265 -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 +188 -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 +198 -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 +252 -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/cogitator.d.ts.map +1 -1
  75. package/dist/cogitator.js +10 -5
  76. package/dist/cogitator.js.map +1 -1
  77. package/dist/index.d.ts +4 -0
  78. package/dist/index.d.ts.map +1 -1
  79. package/dist/index.js +2 -0
  80. package/dist/index.js.map +1 -1
  81. package/dist/learning/ab-testing.d.ts.map +1 -1
  82. package/dist/learning/ab-testing.js +6 -5
  83. package/dist/learning/ab-testing.js.map +1 -1
  84. package/dist/learning/auto-optimizer.d.ts.map +1 -1
  85. package/dist/learning/auto-optimizer.js +4 -2
  86. package/dist/learning/auto-optimizer.js.map +1 -1
  87. package/dist/learning/postgres-trace-store.d.ts.map +1 -1
  88. package/dist/learning/postgres-trace-store.js +15 -5
  89. package/dist/learning/postgres-trace-store.js.map +1 -1
  90. package/dist/learning/prompt-monitor.d.ts.map +1 -1
  91. package/dist/learning/prompt-monitor.js.map +1 -1
  92. package/dist/learning/rollback-manager.d.ts.map +1 -1
  93. package/dist/learning/rollback-manager.js.map +1 -1
  94. package/dist/llm/google.d.ts.map +1 -1
  95. package/dist/llm/google.js +5 -3
  96. package/dist/llm/google.js.map +1 -1
  97. package/package.json +5 -5
  98. package/dist/__tests__/agent.test.d.ts +0 -2
  99. package/dist/__tests__/agent.test.d.ts.map +0 -1
  100. package/dist/__tests__/agent.test.js +0 -91
  101. package/dist/__tests__/agent.test.js.map +0 -1
  102. package/dist/__tests__/base64.test.d.ts +0 -2
  103. package/dist/__tests__/base64.test.d.ts.map +0 -1
  104. package/dist/__tests__/base64.test.js +0 -62
  105. package/dist/__tests__/base64.test.js.map +0 -1
  106. package/dist/__tests__/calculator.test.d.ts +0 -2
  107. package/dist/__tests__/calculator.test.d.ts.map +0 -1
  108. package/dist/__tests__/calculator.test.js +0 -146
  109. package/dist/__tests__/calculator.test.js.map +0 -1
  110. package/dist/__tests__/cogitator-memory.test.d.ts +0 -2
  111. package/dist/__tests__/cogitator-memory.test.d.ts.map +0 -1
  112. package/dist/__tests__/cogitator-memory.test.js +0 -176
  113. package/dist/__tests__/cogitator-memory.test.js.map +0 -1
  114. package/dist/__tests__/datetime.test.d.ts +0 -2
  115. package/dist/__tests__/datetime.test.d.ts.map +0 -1
  116. package/dist/__tests__/datetime.test.js +0 -87
  117. package/dist/__tests__/datetime.test.js.map +0 -1
  118. package/dist/__tests__/exec.test.d.ts +0 -2
  119. package/dist/__tests__/exec.test.d.ts.map +0 -1
  120. package/dist/__tests__/exec.test.js +0 -59
  121. package/dist/__tests__/exec.test.js.map +0 -1
  122. package/dist/__tests__/filesystem.test.d.ts +0 -2
  123. package/dist/__tests__/filesystem.test.d.ts.map +0 -1
  124. package/dist/__tests__/filesystem.test.js +0 -148
  125. package/dist/__tests__/filesystem.test.js.map +0 -1
  126. package/dist/__tests__/google-backend.test.d.ts +0 -5
  127. package/dist/__tests__/google-backend.test.d.ts.map +0 -1
  128. package/dist/__tests__/google-backend.test.js +0 -429
  129. package/dist/__tests__/google-backend.test.js.map +0 -1
  130. package/dist/__tests__/hash.test.d.ts +0 -2
  131. package/dist/__tests__/hash.test.d.ts.map +0 -1
  132. package/dist/__tests__/hash.test.js +0 -50
  133. package/dist/__tests__/hash.test.js.map +0 -1
  134. package/dist/__tests__/http.test.d.ts +0 -2
  135. package/dist/__tests__/http.test.d.ts.map +0 -1
  136. package/dist/__tests__/http.test.js +0 -64
  137. package/dist/__tests__/http.test.js.map +0 -1
  138. package/dist/__tests__/json.test.d.ts +0 -2
  139. package/dist/__tests__/json.test.d.ts.map +0 -1
  140. package/dist/__tests__/json.test.js +0 -65
  141. package/dist/__tests__/json.test.js.map +0 -1
  142. package/dist/__tests__/logger.test.d.ts +0 -2
  143. package/dist/__tests__/logger.test.d.ts.map +0 -1
  144. package/dist/__tests__/logger.test.js +0 -186
  145. package/dist/__tests__/logger.test.js.map +0 -1
  146. package/dist/__tests__/random.test.d.ts +0 -2
  147. package/dist/__tests__/random.test.d.ts.map +0 -1
  148. package/dist/__tests__/random.test.js +0 -81
  149. package/dist/__tests__/random.test.js.map +0 -1
  150. package/dist/__tests__/regex.test.d.ts +0 -2
  151. package/dist/__tests__/regex.test.d.ts.map +0 -1
  152. package/dist/__tests__/regex.test.js +0 -75
  153. package/dist/__tests__/regex.test.js.map +0 -1
  154. package/dist/__tests__/registry.test.d.ts +0 -2
  155. package/dist/__tests__/registry.test.d.ts.map +0 -1
  156. package/dist/__tests__/registry.test.js +0 -102
  157. package/dist/__tests__/registry.test.js.map +0 -1
  158. package/dist/__tests__/sleep.test.d.ts +0 -2
  159. package/dist/__tests__/sleep.test.d.ts.map +0 -1
  160. package/dist/__tests__/sleep.test.js +0 -29
  161. package/dist/__tests__/sleep.test.js.map +0 -1
  162. package/dist/__tests__/tool.test.d.ts +0 -2
  163. package/dist/__tests__/tool.test.d.ts.map +0 -1
  164. package/dist/__tests__/tool.test.js +0 -103
  165. package/dist/__tests__/tool.test.js.map +0 -1
  166. package/dist/__tests__/uuid.test.d.ts +0 -2
  167. package/dist/__tests__/uuid.test.d.ts.map +0 -1
  168. package/dist/__tests__/uuid.test.js +0 -37
  169. package/dist/__tests__/uuid.test.js.map +0 -1
@@ -0,0 +1,188 @@
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) || isAncestor(graph, parent.id, m)) {
102
+ return false;
103
+ }
104
+ }
105
+ }
106
+ for (const m of mediators) {
107
+ const confounders = findConfounders(graph, m, outcome);
108
+ const backdoorSet = [treatment, ...confounders.filter((c) => c !== treatment)];
109
+ const separated = dSeparation(createGraphWithoutOutgoingEdges(graph, m), m, outcome, backdoorSet);
110
+ if (!separated.separated) {
111
+ return false;
112
+ }
113
+ }
114
+ return true;
115
+ }
116
+ function isAncestor(graph, potential, of) {
117
+ const ancestors = graph.getAncestors(of);
118
+ return ancestors.some((a) => a.id === potential);
119
+ }
120
+ function findConfounders(graph, node1, node2) {
121
+ const ancestors1 = new Set(graph.getAncestors(node1).map((n) => n.id));
122
+ const ancestors2 = new Set(graph.getAncestors(node2).map((n) => n.id));
123
+ const confounders = [];
124
+ for (const a of ancestors1) {
125
+ if (ancestors2.has(a)) {
126
+ confounders.push(a);
127
+ }
128
+ }
129
+ return confounders;
130
+ }
131
+ function generateBackdoorFormula(treatment, outcome, adjustmentSet) {
132
+ if (adjustmentSet.length === 0) {
133
+ return `P(${outcome}|do(${treatment})) = Σ P(${outcome}|${treatment})`;
134
+ }
135
+ const adjustVars = adjustmentSet.join(', ');
136
+ return `P(${outcome}|do(${treatment})) = Σ_{${adjustVars}} P(${outcome}|${treatment}, ${adjustVars}) P(${adjustVars})`;
137
+ }
138
+ function generateFrontdoorFormula(treatment, outcome, mediators) {
139
+ const m = mediators.join(', ');
140
+ return `P(${outcome}|do(${treatment})) = Σ_{${m}} P(${m}|${treatment}) Σ_{${treatment}'} P(${outcome}|${m}, ${treatment}') P(${treatment}')`;
141
+ }
142
+ export function findAllAdjustmentSets(graph, treatment, outcome, maxSize = 5) {
143
+ const results = [];
144
+ const backdoor = findBackdoorAdjustment(graph, treatment, outcome);
145
+ if (backdoor) {
146
+ results.push(backdoor);
147
+ }
148
+ const frontdoor = findFrontdoorAdjustment(graph, treatment, outcome);
149
+ if (frontdoor) {
150
+ results.push(frontdoor);
151
+ }
152
+ const treatmentDescendants = new Set(graph.getDescendants(treatment).map((n) => n.id));
153
+ const allNodes = graph.getNodes().map((n) => n.id);
154
+ const candidates = allNodes.filter((n) => n !== treatment && n !== outcome && !treatmentDescendants.has(n));
155
+ for (let size = 0; size <= Math.min(maxSize, candidates.length); size++) {
156
+ for (const subset of combinations(candidates, size)) {
157
+ if (isValidBackdoorSet(graph, treatment, outcome, subset)) {
158
+ const exists = results.some((r) => r.type === 'backdoor' &&
159
+ r.variables.length === subset.length &&
160
+ r.variables.every((v) => subset.includes(v)));
161
+ if (!exists) {
162
+ results.push({
163
+ variables: subset,
164
+ type: 'backdoor',
165
+ formula: generateBackdoorFormula(treatment, outcome, subset),
166
+ isMinimal: size === (backdoor?.variables.length ?? 0),
167
+ isValid: true,
168
+ });
169
+ }
170
+ }
171
+ }
172
+ }
173
+ return results;
174
+ }
175
+ function* combinations(arr, size) {
176
+ if (size === 0) {
177
+ yield [];
178
+ return;
179
+ }
180
+ if (arr.length < size)
181
+ return;
182
+ for (let i = 0; i <= arr.length - size; i++) {
183
+ for (const rest of combinations(arr.slice(i + 1), size - 1)) {
184
+ yield [arr[i], ...rest];
185
+ }
186
+ }
187
+ }
188
+ //# 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,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,mBAAmB,GAAG,oBAAoB;IAyB9E,OAAO,CAAC,SAAS;IAuBjB,OAAO,CAAC,MAAM;IAkBd,OAAO,CAAC,UAAU;IA8ClB,OAAO,CAAC,gBAAgB;IAmBxB,OAAO,CAAC,yBAAyB;IAoDjC,OAAO,CAAC,YAAY;IAmBpB,OAAO,CAAC,WAAW;IAwBnB,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,mBAAmB;CAe5B;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,mBAAmB,EAC1B,OAAO,CAAC,EAAE,6BAA6B,GACtC,oBAAoB,CAGtB"}
@@ -0,0 +1,198 @@
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] ??
16
+ this.computeValue(graph, query.target, query.factual, abductionResult);
17
+ return {
18
+ query,
19
+ factualValue,
20
+ counterfactualValue: predictionResult.value,
21
+ probability: predictionResult.probability,
22
+ explanation: this.generateExplanation(query, factualValue, predictionResult.value),
23
+ reasoning: {
24
+ abduction: abductionResult,
25
+ action: actionResult,
26
+ prediction: predictionResult.values,
27
+ },
28
+ };
29
+ }
30
+ abduction(graph, factual) {
31
+ const noiseTerms = {};
32
+ const sortedNodes = graph.topologicalSort();
33
+ for (const nodeId of sortedNodes) {
34
+ const node = graph.getNode(nodeId);
35
+ if (!node)
36
+ continue;
37
+ if (factual[nodeId] !== undefined && node.equation) {
38
+ const observedValue = this.toNumber(factual[nodeId]);
39
+ const predictedValue = this.evaluateEquation(node.equation, graph, nodeId, factual, {});
40
+ noiseTerms[nodeId] = observedValue - predictedValue;
41
+ }
42
+ else {
43
+ noiseTerms[nodeId] = this.sampleNoise(node);
44
+ }
45
+ }
46
+ return noiseTerms;
47
+ }
48
+ action(_graph, intervention, noiseTerms) {
49
+ const result = {};
50
+ for (const [key, value] of Object.entries(noiseTerms)) {
51
+ result[key] = value;
52
+ }
53
+ for (const [variable, value] of Object.entries(intervention)) {
54
+ result[variable] = value;
55
+ }
56
+ return result;
57
+ }
58
+ prediction(graph, target, state) {
59
+ const sortedNodes = graph.topologicalSort();
60
+ const computedValues = { ...state };
61
+ for (const nodeId of sortedNodes) {
62
+ if (computedValues[nodeId] !== undefined && typeof computedValues[nodeId] !== 'number') {
63
+ continue;
64
+ }
65
+ const node = graph.getNode(nodeId);
66
+ if (!node)
67
+ continue;
68
+ if (node.equation) {
69
+ const noiseValue = typeof computedValues[nodeId] === 'number' ? computedValues[nodeId] : 0;
70
+ const parentValues = {};
71
+ for (const parent of graph.getParents(nodeId)) {
72
+ if (computedValues[parent.id] !== undefined) {
73
+ parentValues[parent.id] = computedValues[parent.id];
74
+ }
75
+ }
76
+ computedValues[nodeId] = this.evaluateEquationWithNoise(node.equation, parentValues, noiseValue);
77
+ }
78
+ }
79
+ return {
80
+ value: computedValues[target] ?? 0,
81
+ probability: 1.0,
82
+ values: computedValues,
83
+ };
84
+ }
85
+ evaluateEquation(equation, graph, nodeId, values, _noiseTerms) {
86
+ const parents = graph.getParents(nodeId);
87
+ const parentValues = {};
88
+ for (const parent of parents) {
89
+ if (values[parent.id] !== undefined) {
90
+ parentValues[parent.id] = values[parent.id];
91
+ }
92
+ }
93
+ return this.evaluateEquationWithNoise(equation, parentValues, 0);
94
+ }
95
+ evaluateEquationWithNoise(equation, parentValues, noise) {
96
+ switch (equation.type) {
97
+ case 'linear': {
98
+ let result = equation.intercept ?? 0;
99
+ if (equation.coefficients) {
100
+ for (const [variable, coefficient] of Object.entries(equation.coefficients)) {
101
+ const value = this.toNumber(parentValues[variable] ?? 0);
102
+ result += coefficient * value;
103
+ }
104
+ }
105
+ return result + noise;
106
+ }
107
+ case 'logistic': {
108
+ let linearPart = equation.intercept ?? 0;
109
+ if (equation.coefficients) {
110
+ for (const [variable, coefficient] of Object.entries(equation.coefficients)) {
111
+ const value = this.toNumber(parentValues[variable] ?? 0);
112
+ linearPart += coefficient * value;
113
+ }
114
+ }
115
+ linearPart += noise;
116
+ return 1 / (1 + Math.exp(-linearPart));
117
+ }
118
+ case 'polynomial': {
119
+ let result = equation.intercept ?? 0;
120
+ if (equation.coefficients) {
121
+ for (const [variable, coefficient] of Object.entries(equation.coefficients)) {
122
+ const value = this.toNumber(parentValues[variable] ?? 0);
123
+ const [varName, powerStr] = variable.split('^');
124
+ const power = powerStr ? parseInt(powerStr, 10) : 1;
125
+ const actualValue = this.toNumber(parentValues[varName] ?? value);
126
+ result += coefficient * Math.pow(actualValue, power);
127
+ }
128
+ }
129
+ return result + noise;
130
+ }
131
+ case 'custom': {
132
+ return noise;
133
+ }
134
+ default:
135
+ return noise;
136
+ }
137
+ }
138
+ computeValue(graph, target, observed, noiseTerms) {
139
+ const node = graph.getNode(target);
140
+ if (!node?.equation) {
141
+ return observed[target] ?? 0;
142
+ }
143
+ const parentValues = {};
144
+ for (const parent of graph.getParents(target)) {
145
+ parentValues[parent.id] = observed[parent.id] ?? 0;
146
+ }
147
+ return this.evaluateEquationWithNoise(node.equation, parentValues, noiseTerms[target] ?? 0);
148
+ }
149
+ sampleNoise(node) {
150
+ const params = node.equation?.noiseParams ?? {};
151
+ const distribution = node.equation?.noiseDistribution ?? 'gaussian';
152
+ switch (distribution) {
153
+ case 'gaussian': {
154
+ const mean = params.mean ?? this.options.defaultNoiseMean;
155
+ const std = params.std ?? this.options.defaultNoiseStd;
156
+ return this.sampleGaussian(mean, std);
157
+ }
158
+ case 'uniform': {
159
+ const min = params.min ?? -1;
160
+ const max = params.max ?? 1;
161
+ return min + Math.random() * (max - min);
162
+ }
163
+ case 'bernoulli': {
164
+ const p = params.p ?? 0.5;
165
+ return Math.random() < p ? 1 : 0;
166
+ }
167
+ default:
168
+ return 0;
169
+ }
170
+ }
171
+ sampleGaussian(mean, std) {
172
+ const u1 = Math.random();
173
+ const u2 = Math.random();
174
+ const z = Math.sqrt(-2 * Math.log(u1)) * Math.cos(2 * Math.PI * u2);
175
+ return mean + std * z;
176
+ }
177
+ toNumber(value) {
178
+ if (typeof value === 'number')
179
+ return value;
180
+ if (typeof value === 'boolean')
181
+ return value ? 1 : 0;
182
+ const parsed = parseFloat(value);
183
+ return isNaN(parsed) ? 0 : parsed;
184
+ }
185
+ generateExplanation(query, factualValue, counterfactualValue) {
186
+ const interventionDesc = Object.entries(query.intervention)
187
+ .map(([k, v]) => `${k}=${v}`)
188
+ .join(', ');
189
+ return (`Given the factual observation where ${query.target}=${factualValue}, ` +
190
+ `if we had intervened to set ${interventionDesc}, ` +
191
+ `then ${query.target} would have been ${counterfactualValue}.`);
192
+ }
193
+ }
194
+ export function evaluateCounterfactual(graph, query, options) {
195
+ const reasoner = new CounterfactualReasoner(options);
196
+ return reasoner.evaluate(graph, query);
197
+ }
198
+ //# 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,EAAE,WAAW,EAAc,iBAAiB,EAAc,MAAM,qBAAqB,CAAC;AAElG,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;AAkJD,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,WAAW,EAClB,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,EACpB,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,EACpB,SAAS,cAAoB,GAC5B,MAAM,EAAE,GAAG,IAAI,CAiBjB"}
@@ -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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"}