@knights-eye-chess/ai-analysis 0.0.0-stage → 0.1.0-dev.14

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 (258) hide show
  1. package/LICENSE +235 -0
  2. package/LICENSING.md +26 -0
  3. package/NOTICE +5 -0
  4. package/NPM-PUBLISHING.md +24 -0
  5. package/README.md +141 -2
  6. package/SOURCE-ORIGIN.json +16 -0
  7. package/THIRD_PARTY_NOTICES.md +18 -0
  8. package/build.mjs +22 -0
  9. package/dist/answer-pipeline.test.mjs +375 -0
  10. package/dist/chunk-PLKNJRPF.js +10662 -0
  11. package/dist/chunk-XQDZJOYD.js +2515 -0
  12. package/dist/index.js +146 -0
  13. package/dist/owner-tests/chess-reasoning-compact-search-preparation.test.mjs +963 -0
  14. package/dist/owner-tests/mechanism-encoding.test.mjs +529 -0
  15. package/dist/owner-tests/move-mechanism-facts.test.mjs +396 -0
  16. package/dist/owner-tests/pipeline-host-preparation.test.mjs +10556 -0
  17. package/dist/owner-tests/position-preparation.test.mjs +625 -0
  18. package/dist/owner-tests/preparation-consolidation.test.mjs +1052 -0
  19. package/dist/owner-tests/prose-reference-admission.test.mjs +1770 -0
  20. package/dist/owner-tests/score-comparison-notices.test.mjs +240 -0
  21. package/dist/owner-tests/simple-engine-presentation.test.mjs +233 -0
  22. package/dist/owner-tests/tool-input-loop-guard.test.mjs +78 -0
  23. package/dist/research.js +2274 -0
  24. package/dist/runtime-closure.json +103 -0
  25. package/dist/shared-runtime-closure.json +39 -0
  26. package/dist/shared.js +152 -0
  27. package/dist/types/ai-request-failure.d.ts +14 -0
  28. package/dist/types/ai-request-limits.d.ts +4 -0
  29. package/dist/types/ai-routing-diagnostics.d.ts +14 -0
  30. package/dist/types/chess-reasoning/ablation-adaptive-evidence-loop.d.ts +127 -0
  31. package/dist/types/chess-reasoning/ablation-adaptive-runtime.d.ts +178 -0
  32. package/dist/types/chess-reasoning/ablation-direct-synthesis.d.ts +1030 -0
  33. package/dist/types/chess-reasoning/ablation-evidence-bundle.d.ts +185 -0
  34. package/dist/types/chess-reasoning/ablation-evidence-capture.d.ts +37 -0
  35. package/dist/types/chess-reasoning/ablation-lean-direct-runtime.d.ts +193 -0
  36. package/dist/types/chess-reasoning/ablation-model-facing-evidence.d.ts +38 -0
  37. package/dist/types/chess-reasoning/ablation-transport-correction.d.ts +13 -0
  38. package/dist/types/chess-reasoning/ai-sdk-runtime-support.d.ts +93 -0
  39. package/dist/types/chess-reasoning/answer-host-contracts.d.ts +59 -0
  40. package/dist/types/chess-reasoning/answer-model-connector.d.ts +68 -0
  41. package/dist/types/chess-reasoning/answer-pipeline-exports.d.ts +98 -0
  42. package/dist/types/chess-reasoning/answer-pipeline.d.ts +41 -0
  43. package/dist/types/chess-reasoning/answer-reference-validation.d.ts +40 -0
  44. package/dist/types/chess-reasoning/answer-tool-host.d.ts +8 -0
  45. package/dist/types/chess-reasoning/branch-expansion-policy.d.ts +13 -0
  46. package/dist/types/chess-reasoning/branch-expansion.d.ts +39 -0
  47. package/dist/types/chess-reasoning/causal-claim-checks.d.ts +21 -0
  48. package/dist/types/chess-reasoning/chess-reference-dictionary.d.ts +13 -0
  49. package/dist/types/chess-reasoning/classification-question-target.d.ts +22 -0
  50. package/dist/types/chess-reasoning/classification-reassessment.d.ts +31 -0
  51. package/dist/types/chess-reasoning/compact-search-preparation.d.ts +7 -0
  52. package/dist/types/chess-reasoning/concept-registry.d.ts +99 -0
  53. package/dist/types/chess-reasoning/conversation-context.d.ts +12 -0
  54. package/dist/types/chess-reasoning/engine-search-failure.d.ts +7 -0
  55. package/dist/types/chess-reasoning/evidence-citation-normalization.d.ts +9 -0
  56. package/dist/types/chess-reasoning/evidence-licenses.d.ts +57 -0
  57. package/dist/types/chess-reasoning/evidence-selector-contract.d.ts +5 -0
  58. package/dist/types/chess-reasoning/existing-analysis-context.d.ts +104 -0
  59. package/dist/types/chess-reasoning/fact-observation-provider.d.ts +15 -0
  60. package/dist/types/chess-reasoning/fact-provider.d.ts +111 -0
  61. package/dist/types/chess-reasoning/fresh-engine-pv-witnesses.d.ts +67 -0
  62. package/dist/types/chess-reasoning/historical-prose.d.ts +23 -0
  63. package/dist/types/chess-reasoning/idea-graph.d.ts +34 -0
  64. package/dist/types/chess-reasoning/initial-search-plan.d.ts +37 -0
  65. package/dist/types/chess-reasoning/lossless-evidence-sharing.d.ts +18 -0
  66. package/dist/types/chess-reasoning/matched-comparison.d.ts +10 -0
  67. package/dist/types/chess-reasoning/material-accounting.d.ts +80 -0
  68. package/dist/types/chess-reasoning/material-format.d.ts +4 -0
  69. package/dist/types/chess-reasoning/mechanical-fact-provider.d.ts +33 -0
  70. package/dist/types/chess-reasoning/mechanical-ray-facts.d.ts +19 -0
  71. package/dist/types/chess-reasoning/mechanism-presentation.d.ts +9 -0
  72. package/dist/types/chess-reasoning/move-mechanism-facts.d.ts +45 -0
  73. package/dist/types/chess-reasoning/native-answer-connector.d.ts +4 -0
  74. package/dist/types/chess-reasoning/opening-source-contracts.d.ts +54 -0
  75. package/dist/types/chess-reasoning/opening-source-credits.d.ts +16 -0
  76. package/dist/types/chess-reasoning/opponent-threat-preparation.d.ts +7 -0
  77. package/dist/types/chess-reasoning/piece-identities.d.ts +11 -0
  78. package/dist/types/chess-reasoning/poc-contracts.d.ts +1026 -0
  79. package/dist/types/chess-reasoning/poc-hypotheses.d.ts +74 -0
  80. package/dist/types/chess-reasoning/poc-move-witnesses.d.ts +13 -0
  81. package/dist/types/chess-reasoning/poc-observations.d.ts +23 -0
  82. package/dist/types/chess-reasoning/poc-piece-refs.d.ts +12 -0
  83. package/dist/types/chess-reasoning/poc-plan-model.d.ts +45 -0
  84. package/dist/types/chess-reasoning/poc-semantic-text.d.ts +8 -0
  85. package/dist/types/chess-reasoning/poc-tools.d.ts +81 -0
  86. package/dist/types/chess-reasoning/portable-answer-runtime.d.ts +291 -0
  87. package/dist/types/chess-reasoning/position-analysis-contracts.d.ts +31 -0
  88. package/dist/types/chess-reasoning/position-analysis-scope.d.ts +3 -0
  89. package/dist/types/chess-reasoning/preparation-consolidation.d.ts +21 -0
  90. package/dist/types/chess-reasoning/production-observation-provider.d.ts +16 -0
  91. package/dist/types/chess-reasoning/question-routing.d.ts +326 -0
  92. package/dist/types/chess-reasoning/recorded-main-line.d.ts +37 -0
  93. package/dist/types/chess-reasoning/recorded-position-tools.d.ts +11 -0
  94. package/dist/types/chess-reasoning/recorded-reference-context.d.ts +13 -0
  95. package/dist/types/chess-reasoning/recorded-selected-classification.d.ts +36 -0
  96. package/dist/types/chess-reasoning/reference-limits.d.ts +2 -0
  97. package/dist/types/chess-reasoning/research-exports.d.ts +197 -0
  98. package/dist/types/chess-reasoning/saved-score-presentation.d.ts +14 -0
  99. package/dist/types/chess-reasoning/score-comparison-notices.d.ts +33 -0
  100. package/dist/types/chess-reasoning/server-simple-policy.d.ts +31 -0
  101. package/dist/types/chess-reasoning/simple-agent-config.d.ts +73 -0
  102. package/dist/types/chess-reasoning/simple-board-analysis.d.ts +85 -0
  103. package/dist/types/chess-reasoning/simple-compact-evidence.d.ts +7 -0
  104. package/dist/types/chess-reasoning/simple-completion.d.ts +23 -0
  105. package/dist/types/chess-reasoning/simple-engine-presentation.d.ts +3 -0
  106. package/dist/types/chess-reasoning/simple-evidence-preparation.d.ts +17 -0
  107. package/dist/types/chess-reasoning/simple-evidence-view.d.ts +17 -0
  108. package/dist/types/chess-reasoning/simple-explanation-coverage.d.ts +90 -0
  109. package/dist/types/chess-reasoning/simple-fact-delivery.d.ts +43 -0
  110. package/dist/types/chess-reasoning/simple-fallback-premise.d.ts +5 -0
  111. package/dist/types/chess-reasoning/simple-prose-references.d.ts +108 -0
  112. package/dist/types/chess-reasoning/simple-runtime-version.d.ts +1 -0
  113. package/dist/types/chess-reasoning/stable.d.ts +2 -0
  114. package/dist/types/chess-reasoning/tool-input-loop-guard.d.ts +5 -0
  115. package/dist/types/chess-reasoning/types.d.ts +180 -0
  116. package/dist/types/chess-reasoning/visible-support-lines.d.ts +12 -0
  117. package/dist/types/chess-reasoning/wikibooks-index.d.ts +30 -0
  118. package/dist/types/chess-reasoning/wikibooks-tool-context.d.ts +10 -0
  119. package/dist/types/player-perspective.d.ts +16 -0
  120. package/dist/types/shared-exports.d.ts +22 -0
  121. package/docs/API.md +82 -0
  122. package/docs/OWNERSHIP-ADOPTION.md +35 -0
  123. package/docs/OWNERSHIP-DRIFT.json +55 -0
  124. package/docs/RESEARCH-API.md +28 -0
  125. package/licenses/third-party/INVENTORY.json +202 -0
  126. package/licenses/third-party/ai-7.0.85/LICENSE +13 -0
  127. package/licenses/third-party/ai-sdk--gateway-4.0.69/LICENSE +13 -0
  128. package/licenses/third-party/ai-sdk--provider-4.0.9/LICENSE +13 -0
  129. package/licenses/third-party/ai-sdk--provider-utils-5.0.34/APACHE-2.0.txt +73 -0
  130. package/licenses/third-party/ai-sdk--provider-utils-5.0.34/src/to-json-schema/zod3-to-json-schema/LICENSE +16 -0
  131. package/licenses/third-party/chess.js-1.4.0/LICENSE +23 -0
  132. package/licenses/third-party/eventsource-parser-3.1.1/LICENSE +21 -0
  133. package/licenses/third-party/json-schema-0.4.0/LICENSE +195 -0
  134. package/licenses/third-party/standard-schema--spec-1.1.0/LICENSE +21 -0
  135. package/licenses/third-party/types--json-schema-7.0.15/LICENSE +21 -0
  136. package/licenses/third-party/types--node-22.19.19/LICENSE +21 -0
  137. package/licenses/third-party/undici-7.30.0/LICENSE +21 -0
  138. package/licenses/third-party/undici-7.30.0/lib/web/fetch/LICENSE +21 -0
  139. package/licenses/third-party/undici-types-6.21.0/LICENSE +21 -0
  140. package/licenses/third-party/vercel--oidc-3.2.0/LICENSE +202 -0
  141. package/licenses/third-party/workflow--serde-4.1.0/APACHE-2.0.txt +73 -0
  142. package/licenses/third-party/workflow--serde-4.1.0/LICENSE.md +3 -0
  143. package/licenses/third-party/zod-4.6.5/LICENSE +21 -0
  144. package/npm-release.json +5 -0
  145. package/package.json +72 -4
  146. package/scripts/check-release-tooling.mjs +22 -0
  147. package/scripts/pack.mjs +68 -0
  148. package/scripts/publish-reviewed.mjs +72 -0
  149. package/scripts/release-tooling.json +13 -0
  150. package/scripts/update-dependency.mjs +44 -0
  151. package/scripts/verify-release.mjs +52 -0
  152. package/src/ai-request-failure.ts +34 -0
  153. package/src/ai-request-limits.ts +4 -0
  154. package/src/ai-routing-diagnostics.ts +33 -0
  155. package/src/chess-reasoning/ablation-adaptive-evidence-loop.ts +515 -0
  156. package/src/chess-reasoning/ablation-adaptive-runtime.ts +924 -0
  157. package/src/chess-reasoning/ablation-direct-synthesis.ts +1128 -0
  158. package/src/chess-reasoning/ablation-evidence-bundle.ts +726 -0
  159. package/src/chess-reasoning/ablation-evidence-capture.ts +513 -0
  160. package/src/chess-reasoning/ablation-lean-direct-runtime.ts +670 -0
  161. package/src/chess-reasoning/ablation-model-facing-evidence.ts +212 -0
  162. package/src/chess-reasoning/ablation-transport-correction.ts +106 -0
  163. package/src/chess-reasoning/ai-sdk-runtime-support.ts +381 -0
  164. package/src/chess-reasoning/answer-host-contracts.ts +10 -0
  165. package/src/chess-reasoning/answer-model-connector.ts +83 -0
  166. package/src/chess-reasoning/answer-pipeline-exports.ts +98 -0
  167. package/src/chess-reasoning/answer-pipeline.ts +195 -0
  168. package/src/chess-reasoning/answer-reference-validation.ts +124 -0
  169. package/src/chess-reasoning/answer-tool-host.ts +10 -0
  170. package/src/chess-reasoning/branch-expansion-policy.ts +32 -0
  171. package/src/chess-reasoning/branch-expansion.ts +80 -0
  172. package/src/chess-reasoning/causal-claim-checks.ts +256 -0
  173. package/src/chess-reasoning/chess-reference-dictionary.ts +21 -0
  174. package/src/chess-reasoning/classification-question-target.ts +30 -0
  175. package/src/chess-reasoning/classification-reassessment.ts +34 -0
  176. package/src/chess-reasoning/compact-search-preparation.ts +125 -0
  177. package/src/chess-reasoning/concept-registry.ts +275 -0
  178. package/src/chess-reasoning/conversation-context.ts +29 -0
  179. package/src/chess-reasoning/engine-search-failure.ts +11 -0
  180. package/src/chess-reasoning/evidence-citation-normalization.ts +15 -0
  181. package/src/chess-reasoning/evidence-licenses.ts +166 -0
  182. package/src/chess-reasoning/evidence-selector-contract.ts +5 -0
  183. package/src/chess-reasoning/existing-analysis-context.ts +544 -0
  184. package/src/chess-reasoning/fact-observation-provider.ts +134 -0
  185. package/src/chess-reasoning/fact-provider.ts +250 -0
  186. package/src/chess-reasoning/fresh-engine-pv-witnesses.ts +128 -0
  187. package/src/chess-reasoning/historical-prose.ts +116 -0
  188. package/src/chess-reasoning/idea-graph.ts +224 -0
  189. package/src/chess-reasoning/initial-search-plan.ts +115 -0
  190. package/src/chess-reasoning/lossless-evidence-sharing.ts +135 -0
  191. package/src/chess-reasoning/matched-comparison.ts +40 -0
  192. package/src/chess-reasoning/material-accounting.ts +55 -0
  193. package/src/chess-reasoning/material-format.ts +47 -0
  194. package/src/chess-reasoning/mechanical-fact-provider.ts +1602 -0
  195. package/src/chess-reasoning/mechanical-ray-facts.ts +123 -0
  196. package/src/chess-reasoning/mechanism-presentation.ts +94 -0
  197. package/src/chess-reasoning/move-mechanism-facts.ts +185 -0
  198. package/src/chess-reasoning/native-answer-connector.ts +13 -0
  199. package/src/chess-reasoning/opening-source-contracts.ts +47 -0
  200. package/src/chess-reasoning/opening-source-credits.ts +53 -0
  201. package/src/chess-reasoning/opponent-threat-preparation.ts +98 -0
  202. package/src/chess-reasoning/piece-identities.ts +159 -0
  203. package/src/chess-reasoning/poc-contracts.ts +1097 -0
  204. package/src/chess-reasoning/poc-hypotheses.ts +759 -0
  205. package/src/chess-reasoning/poc-move-witnesses.ts +170 -0
  206. package/src/chess-reasoning/poc-observations.ts +611 -0
  207. package/src/chess-reasoning/poc-piece-refs.ts +62 -0
  208. package/src/chess-reasoning/poc-plan-model.ts +345 -0
  209. package/src/chess-reasoning/poc-semantic-text.ts +10 -0
  210. package/src/chess-reasoning/poc-tools.ts +978 -0
  211. package/src/chess-reasoning/portable-answer-runtime.ts +684 -0
  212. package/src/chess-reasoning/position-analysis-contracts.ts +88 -0
  213. package/src/chess-reasoning/position-analysis-scope.ts +20 -0
  214. package/src/chess-reasoning/preparation-consolidation.ts +91 -0
  215. package/src/chess-reasoning/production-observation-provider.ts +41 -0
  216. package/src/chess-reasoning/question-routing.ts +332 -0
  217. package/src/chess-reasoning/recorded-main-line.ts +55 -0
  218. package/src/chess-reasoning/recorded-position-tools.ts +78 -0
  219. package/src/chess-reasoning/recorded-reference-context.ts +44 -0
  220. package/src/chess-reasoning/recorded-selected-classification.ts +54 -0
  221. package/src/chess-reasoning/reference-limits.ts +2 -0
  222. package/src/chess-reasoning/research-exports.ts +197 -0
  223. package/src/chess-reasoning/saved-score-presentation.ts +6 -0
  224. package/src/chess-reasoning/score-comparison-notices.ts +115 -0
  225. package/src/chess-reasoning/server-simple-policy.ts +75 -0
  226. package/src/chess-reasoning/simple-agent-config.ts +58 -0
  227. package/src/chess-reasoning/simple-board-analysis.ts +57 -0
  228. package/src/chess-reasoning/simple-compact-evidence.ts +79 -0
  229. package/src/chess-reasoning/simple-completion.ts +37 -0
  230. package/src/chess-reasoning/simple-engine-presentation.ts +95 -0
  231. package/src/chess-reasoning/simple-evidence-preparation.ts +32 -0
  232. package/src/chess-reasoning/simple-evidence-view.ts +69 -0
  233. package/src/chess-reasoning/simple-explanation-coverage.ts +118 -0
  234. package/src/chess-reasoning/simple-fact-delivery.ts +52 -0
  235. package/src/chess-reasoning/simple-fallback-premise.ts +65 -0
  236. package/src/chess-reasoning/simple-prose-references.ts +528 -0
  237. package/src/chess-reasoning/simple-runtime-version.ts +2 -0
  238. package/src/chess-reasoning/stable.ts +18 -0
  239. package/src/chess-reasoning/tool-input-loop-guard.ts +38 -0
  240. package/src/chess-reasoning/types.ts +195 -0
  241. package/src/chess-reasoning/visible-support-lines.ts +44 -0
  242. package/src/chess-reasoning/wikibooks-index.ts +56 -0
  243. package/src/chess-reasoning/wikibooks-tool-context.ts +91 -0
  244. package/src/player-perspective.ts +41 -0
  245. package/src/shared-exports.ts +23 -0
  246. package/test/answer-pipeline.test.mjs +375 -0
  247. package/test/owner/chess-reasoning-compact-search-preparation.test.mjs +111 -0
  248. package/test/owner/mechanism-encoding.test.mjs +78 -0
  249. package/test/owner/move-mechanism-facts.test.mjs +105 -0
  250. package/test/owner/pipeline-host-preparation.test.mjs +115 -0
  251. package/test/owner/position-preparation.test.mjs +22 -0
  252. package/test/owner/preparation-consolidation.test.mjs +74 -0
  253. package/test/owner/prose-reference-admission.test.mjs +26 -0
  254. package/test/owner/score-comparison-notices.test.mjs +116 -0
  255. package/test/owner/simple-engine-presentation.test.mjs +50 -0
  256. package/test/owner/tool-input-loop-guard.test.mjs +25 -0
  257. package/test-types.mts +23 -0
  258. package/tsconfig.json +22 -0
@@ -0,0 +1,1030 @@
1
+ import { type AblationEvidenceClosureBundle } from "./ablation-evidence-bundle.js";
2
+ import type { ReasoningClaimKind, ReasoningHypothesisProposal, ReasoningHypothesisProvenance, ReasoningHypothesisRecord, ReasoningHypothesisRelationProposal, ReasoningHypothesisRelationRecord, ReasoningNarrativeSegment } from "./poc-contracts.js";
3
+ import type { ProofStrength } from "./types.js";
4
+ /**
5
+ * Contract used by the direct ablation arms only. It deliberately ends before
6
+ * C's observation review, criticism, terminal review, graph selection,
7
+ * checkpoint, discourse, rendering, or repair stages.
8
+ */
9
+ export declare const ABLATION_DIRECT_SYNTHESIS_VERSION: "architecture-ablation-direct-synthesis/2";
10
+ /**
11
+ * Provider-facing schema. Strict structured-output providers require every
12
+ * object field to be required and every object to be closed. The parser below
13
+ * maps explicit nulls and entry-encoded attribute values back to the existing
14
+ * optional/object-valued semantic contract before materialization.
15
+ */
16
+ export declare const DIRECT_SYNTHESIS_PROPOSAL_JSON_SCHEMA: {
17
+ readonly type: "object";
18
+ readonly additionalProperties: false;
19
+ readonly required: readonly ["schemaVersion", "hypotheses", "relations", "claims", "demonstrations", "coverage", "limitations", "riskProfile"];
20
+ readonly properties: {
21
+ readonly schemaVersion: {
22
+ readonly const: "architecture-ablation-direct-synthesis/2";
23
+ };
24
+ readonly hypotheses: {
25
+ readonly type: "array";
26
+ readonly minItems: 1;
27
+ readonly maxItems: 16;
28
+ readonly items: {
29
+ readonly $ref: "#/$defs/hypothesis";
30
+ };
31
+ };
32
+ readonly relations: {
33
+ readonly type: "array";
34
+ readonly maxItems: 24;
35
+ readonly items: {
36
+ readonly $ref: "#/$defs/relation";
37
+ };
38
+ };
39
+ readonly claims: {
40
+ readonly type: "array";
41
+ readonly minItems: 1;
42
+ readonly maxItems: 16;
43
+ readonly items: {
44
+ readonly $ref: "#/$defs/claim";
45
+ };
46
+ };
47
+ readonly demonstrations: {
48
+ readonly type: readonly ["array", "null"];
49
+ readonly maxItems: 8;
50
+ readonly items: {
51
+ readonly $ref: "#/$defs/demonstration";
52
+ };
53
+ };
54
+ readonly coverage: {
55
+ readonly $ref: "#/$defs/coverage";
56
+ };
57
+ readonly limitations: {
58
+ readonly type: "array";
59
+ readonly maxItems: 24;
60
+ readonly items: {
61
+ readonly type: "string";
62
+ readonly minLength: 1;
63
+ readonly maxLength: 1000;
64
+ };
65
+ };
66
+ readonly riskProfile: {
67
+ readonly $ref: "#/$defs/riskProfile";
68
+ };
69
+ };
70
+ readonly $defs: {
71
+ readonly reference: {
72
+ readonly type: "object";
73
+ readonly additionalProperties: false;
74
+ readonly required: readonly ["domain", "id"];
75
+ readonly properties: {
76
+ readonly domain: {
77
+ readonly type: "string";
78
+ readonly minLength: 1;
79
+ readonly maxLength: 160;
80
+ };
81
+ readonly id: {
82
+ readonly type: "string";
83
+ readonly minLength: 1;
84
+ readonly maxLength: 200;
85
+ };
86
+ };
87
+ };
88
+ readonly participant: {
89
+ readonly type: "object";
90
+ readonly additionalProperties: false;
91
+ readonly required: readonly ["role", "ref"];
92
+ readonly properties: {
93
+ readonly role: {
94
+ readonly type: "string";
95
+ readonly minLength: 1;
96
+ readonly maxLength: 160;
97
+ };
98
+ readonly ref: {
99
+ readonly $ref: "#/$defs/reference";
100
+ };
101
+ };
102
+ };
103
+ readonly anchor: {
104
+ readonly type: "object";
105
+ readonly additionalProperties: false;
106
+ readonly required: readonly ["participant", "disposition"];
107
+ readonly properties: {
108
+ readonly participant: {
109
+ readonly $ref: "#/$defs/participant";
110
+ };
111
+ readonly disposition: {
112
+ readonly const: "required";
113
+ };
114
+ };
115
+ };
116
+ readonly attributeEntry: {
117
+ readonly type: "object";
118
+ readonly additionalProperties: false;
119
+ readonly required: readonly ["key", "value"];
120
+ readonly properties: {
121
+ readonly key: {
122
+ readonly type: "string";
123
+ readonly minLength: 1;
124
+ readonly maxLength: 160;
125
+ };
126
+ readonly value: {
127
+ readonly $ref: "#/$defs/attributeValue";
128
+ };
129
+ };
130
+ };
131
+ readonly attributeObject: {
132
+ readonly type: "object";
133
+ readonly additionalProperties: false;
134
+ readonly required: readonly ["entries"];
135
+ readonly properties: {
136
+ readonly entries: {
137
+ readonly type: "array";
138
+ readonly maxItems: 32;
139
+ readonly items: {
140
+ readonly $ref: "#/$defs/attributeEntry";
141
+ };
142
+ };
143
+ };
144
+ };
145
+ readonly attributeValue: {
146
+ readonly anyOf: readonly [{
147
+ readonly type: "object";
148
+ readonly additionalProperties: false;
149
+ readonly required: readonly ["type", "value"];
150
+ readonly properties: {
151
+ readonly type: {
152
+ readonly const: "string";
153
+ };
154
+ readonly value: {
155
+ readonly type: "string";
156
+ readonly maxLength: 1000;
157
+ };
158
+ };
159
+ }, {
160
+ readonly type: "object";
161
+ readonly additionalProperties: false;
162
+ readonly required: readonly ["type", "value"];
163
+ readonly properties: {
164
+ readonly type: {
165
+ readonly const: "number";
166
+ };
167
+ readonly value: {
168
+ readonly type: "number";
169
+ };
170
+ };
171
+ }, {
172
+ readonly type: "object";
173
+ readonly additionalProperties: false;
174
+ readonly required: readonly ["type", "value"];
175
+ readonly properties: {
176
+ readonly type: {
177
+ readonly const: "boolean";
178
+ };
179
+ readonly value: {
180
+ readonly type: "boolean";
181
+ };
182
+ };
183
+ }, {
184
+ readonly type: "object";
185
+ readonly additionalProperties: false;
186
+ readonly required: readonly ["type", "value"];
187
+ readonly properties: {
188
+ readonly type: {
189
+ readonly const: "null";
190
+ };
191
+ readonly value: {
192
+ readonly type: "null";
193
+ };
194
+ };
195
+ }, {
196
+ readonly type: "object";
197
+ readonly additionalProperties: false;
198
+ readonly required: readonly ["type", "items"];
199
+ readonly properties: {
200
+ readonly type: {
201
+ readonly const: "array";
202
+ };
203
+ readonly items: {
204
+ readonly type: "array";
205
+ readonly maxItems: 32;
206
+ readonly items: {
207
+ readonly $ref: "#/$defs/attributeValue";
208
+ };
209
+ };
210
+ };
211
+ }, {
212
+ readonly type: "object";
213
+ readonly additionalProperties: false;
214
+ readonly required: readonly ["type", "entries"];
215
+ readonly properties: {
216
+ readonly type: {
217
+ readonly const: "object";
218
+ };
219
+ readonly entries: {
220
+ readonly type: "array";
221
+ readonly maxItems: 32;
222
+ readonly items: {
223
+ readonly $ref: "#/$defs/attributeEntry";
224
+ };
225
+ };
226
+ };
227
+ }];
228
+ };
229
+ readonly hypothesis: {
230
+ readonly type: "object";
231
+ readonly additionalProperties: false;
232
+ readonly required: readonly ["localId", "entityType", "concepts", "owner", "participants", "attributes", "proofStrength", "evidenceIds", "sourceObservationIds", "parentHypothesisIds", "anchorRequirements"];
233
+ readonly properties: {
234
+ readonly localId: {
235
+ readonly type: "string";
236
+ readonly minLength: 1;
237
+ readonly maxLength: 160;
238
+ };
239
+ readonly entityType: {
240
+ readonly type: "string";
241
+ readonly minLength: 1;
242
+ readonly maxLength: 160;
243
+ };
244
+ readonly concepts: {
245
+ readonly type: "array";
246
+ readonly minItems: 1;
247
+ readonly maxItems: 4;
248
+ readonly items: {
249
+ readonly type: "string";
250
+ readonly minLength: 1;
251
+ readonly maxLength: 160;
252
+ };
253
+ };
254
+ readonly owner: {
255
+ readonly enum: readonly ["w", "b", null];
256
+ };
257
+ readonly participants: {
258
+ readonly type: "array";
259
+ readonly maxItems: 12;
260
+ readonly items: {
261
+ readonly $ref: "#/$defs/participant";
262
+ };
263
+ };
264
+ readonly attributes: {
265
+ readonly $ref: "#/$defs/attributeObject";
266
+ };
267
+ readonly proofStrength: {
268
+ readonly enum: readonly ["observed", "supported", "forced", null];
269
+ };
270
+ readonly evidenceIds: {
271
+ readonly type: "array";
272
+ readonly maxItems: 12;
273
+ readonly items: {
274
+ readonly type: "string";
275
+ readonly minLength: 1;
276
+ readonly maxLength: 200;
277
+ };
278
+ };
279
+ readonly sourceObservationIds: {
280
+ readonly type: "array";
281
+ readonly maxItems: 12;
282
+ readonly items: {
283
+ readonly type: "string";
284
+ readonly minLength: 1;
285
+ readonly maxLength: 200;
286
+ };
287
+ };
288
+ readonly parentHypothesisIds: {
289
+ readonly type: "array";
290
+ readonly maxItems: 8;
291
+ readonly items: {
292
+ readonly type: "string";
293
+ readonly minLength: 1;
294
+ readonly maxLength: 200;
295
+ };
296
+ };
297
+ readonly anchorRequirements: {
298
+ readonly type: "array";
299
+ readonly maxItems: 12;
300
+ readonly items: {
301
+ readonly $ref: "#/$defs/anchor";
302
+ };
303
+ };
304
+ };
305
+ };
306
+ readonly relation: {
307
+ readonly type: "object";
308
+ readonly additionalProperties: false;
309
+ readonly required: readonly ["localId", "relationType", "from", "to", "attributes", "evidenceIds", "sourceObservationIds"];
310
+ readonly properties: {
311
+ readonly localId: {
312
+ readonly type: "string";
313
+ readonly minLength: 1;
314
+ readonly maxLength: 160;
315
+ };
316
+ readonly relationType: {
317
+ readonly type: "string";
318
+ readonly minLength: 1;
319
+ readonly maxLength: 160;
320
+ };
321
+ readonly from: {
322
+ readonly type: "string";
323
+ readonly minLength: 1;
324
+ readonly maxLength: 160;
325
+ };
326
+ readonly to: {
327
+ readonly type: "string";
328
+ readonly minLength: 1;
329
+ readonly maxLength: 160;
330
+ };
331
+ readonly attributes: {
332
+ readonly $ref: "#/$defs/attributeObject";
333
+ };
334
+ readonly evidenceIds: {
335
+ readonly type: "array";
336
+ readonly minItems: 1;
337
+ readonly maxItems: 12;
338
+ readonly items: {
339
+ readonly type: "string";
340
+ readonly minLength: 1;
341
+ readonly maxLength: 200;
342
+ };
343
+ };
344
+ readonly sourceObservationIds: {
345
+ readonly type: "array";
346
+ readonly maxItems: 12;
347
+ readonly items: {
348
+ readonly type: "string";
349
+ readonly minLength: 1;
350
+ readonly maxLength: 200;
351
+ };
352
+ };
353
+ };
354
+ };
355
+ readonly segment: {
356
+ readonly anyOf: readonly [{
357
+ readonly type: "object";
358
+ readonly additionalProperties: false;
359
+ readonly required: readonly ["type", "text"];
360
+ readonly properties: {
361
+ readonly type: {
362
+ readonly const: "text";
363
+ };
364
+ readonly text: {
365
+ readonly type: "string";
366
+ readonly minLength: 1;
367
+ readonly maxLength: 600;
368
+ };
369
+ };
370
+ }, {
371
+ readonly type: "object";
372
+ readonly additionalProperties: false;
373
+ readonly required: readonly ["type", "pieceId", "form", "capitalize", "label"];
374
+ readonly properties: {
375
+ readonly type: {
376
+ readonly const: "piece";
377
+ };
378
+ readonly pieceId: {
379
+ readonly type: "string";
380
+ readonly minLength: 1;
381
+ readonly maxLength: 200;
382
+ };
383
+ readonly form: {
384
+ readonly enum: readonly ["definite", "color-qualified", "square-qualified", "canonical", "bare", "bare-square-qualified", null];
385
+ };
386
+ readonly capitalize: {
387
+ readonly type: readonly ["boolean", "null"];
388
+ };
389
+ readonly label: {
390
+ readonly type: readonly ["string", "null"];
391
+ readonly minLength: 1;
392
+ readonly maxLength: 120;
393
+ };
394
+ };
395
+ }, {
396
+ readonly type: "object";
397
+ readonly additionalProperties: false;
398
+ readonly required: readonly ["type", "pieceKind", "color", "label"];
399
+ readonly properties: {
400
+ readonly type: {
401
+ readonly const: "piece-kind";
402
+ };
403
+ readonly pieceKind: {
404
+ readonly enum: readonly ["bishop", "king", "knight", "pawn", "queen", "rook"];
405
+ };
406
+ readonly color: {
407
+ readonly enum: readonly ["w", "b", null];
408
+ };
409
+ readonly label: {
410
+ readonly type: readonly ["string", "null"];
411
+ readonly minLength: 1;
412
+ readonly maxLength: 120;
413
+ };
414
+ };
415
+ }, {
416
+ readonly type: "object";
417
+ readonly additionalProperties: false;
418
+ readonly required: readonly ["type", "square", "label"];
419
+ readonly properties: {
420
+ readonly type: {
421
+ readonly const: "square";
422
+ };
423
+ readonly square: {
424
+ readonly type: "string";
425
+ readonly minLength: 1;
426
+ readonly maxLength: 2;
427
+ };
428
+ readonly label: {
429
+ readonly type: readonly ["string", "null"];
430
+ readonly minLength: 1;
431
+ readonly maxLength: 120;
432
+ };
433
+ };
434
+ }, {
435
+ readonly type: "object";
436
+ readonly additionalProperties: false;
437
+ readonly required: readonly ["type", "uci", "pieceId", "san", "label"];
438
+ readonly properties: {
439
+ readonly type: {
440
+ readonly const: "move";
441
+ };
442
+ readonly uci: {
443
+ readonly type: "string";
444
+ readonly minLength: 1;
445
+ readonly maxLength: 5;
446
+ };
447
+ readonly pieceId: {
448
+ readonly type: "string";
449
+ readonly minLength: 1;
450
+ readonly maxLength: 200;
451
+ };
452
+ readonly san: {
453
+ readonly type: "string";
454
+ readonly minLength: 1;
455
+ readonly maxLength: 40;
456
+ };
457
+ readonly label: {
458
+ readonly type: readonly ["string", "null"];
459
+ readonly minLength: 1;
460
+ readonly maxLength: 120;
461
+ };
462
+ };
463
+ }, {
464
+ readonly type: "object";
465
+ readonly additionalProperties: false;
466
+ readonly required: readonly ["type", "entityLocalId", "label"];
467
+ readonly properties: {
468
+ readonly type: {
469
+ readonly const: "entity";
470
+ };
471
+ readonly entityLocalId: {
472
+ readonly type: "string";
473
+ readonly minLength: 1;
474
+ readonly maxLength: 160;
475
+ };
476
+ readonly label: {
477
+ readonly type: readonly ["string", "null"];
478
+ readonly minLength: 1;
479
+ readonly maxLength: 120;
480
+ };
481
+ };
482
+ }, {
483
+ readonly type: "object";
484
+ readonly additionalProperties: false;
485
+ readonly required: readonly ["type", "relationLocalId", "fromEntityLocalId", "toEntityLocalId", "label"];
486
+ readonly properties: {
487
+ readonly type: {
488
+ readonly const: "relation";
489
+ };
490
+ readonly relationLocalId: {
491
+ readonly type: "string";
492
+ readonly minLength: 1;
493
+ readonly maxLength: 160;
494
+ };
495
+ readonly fromEntityLocalId: {
496
+ readonly type: "string";
497
+ readonly minLength: 1;
498
+ readonly maxLength: 160;
499
+ };
500
+ readonly toEntityLocalId: {
501
+ readonly type: "string";
502
+ readonly minLength: 1;
503
+ readonly maxLength: 160;
504
+ };
505
+ readonly label: {
506
+ readonly type: readonly ["string", "null"];
507
+ readonly minLength: 1;
508
+ readonly maxLength: 120;
509
+ };
510
+ };
511
+ }];
512
+ };
513
+ readonly claim: {
514
+ readonly type: "object";
515
+ readonly additionalProperties: false;
516
+ readonly required: readonly ["localId", "kind", "content", "proofStrength", "evidenceIds", "qualifications"];
517
+ readonly properties: {
518
+ readonly localId: {
519
+ readonly type: "string";
520
+ readonly minLength: 1;
521
+ readonly maxLength: 160;
522
+ };
523
+ readonly kind: {
524
+ readonly enum: readonly ["fact", "interpretation", "consequence", "defense", "uncertainty"];
525
+ };
526
+ readonly content: {
527
+ readonly type: "array";
528
+ readonly minItems: 1;
529
+ readonly maxItems: 32;
530
+ readonly items: {
531
+ readonly $ref: "#/$defs/segment";
532
+ };
533
+ };
534
+ readonly proofStrength: {
535
+ readonly enum: readonly ["observed", "supported", "forced", null];
536
+ };
537
+ readonly evidenceIds: {
538
+ readonly type: "array";
539
+ readonly minItems: 1;
540
+ readonly maxItems: 12;
541
+ readonly items: {
542
+ readonly type: "string";
543
+ readonly minLength: 1;
544
+ readonly maxLength: 200;
545
+ };
546
+ };
547
+ readonly qualifications: {
548
+ readonly type: "array";
549
+ readonly maxItems: 8;
550
+ readonly items: {
551
+ readonly type: "array";
552
+ readonly minItems: 1;
553
+ readonly maxItems: 16;
554
+ readonly items: {
555
+ readonly $ref: "#/$defs/segment";
556
+ };
557
+ };
558
+ };
559
+ };
560
+ };
561
+ readonly demonstration: {
562
+ readonly anyOf: readonly [{
563
+ readonly type: "object";
564
+ readonly additionalProperties: false;
565
+ readonly required: readonly ["localId", "type", "start", "moves", "label", "evidenceIds"];
566
+ readonly properties: {
567
+ readonly localId: {
568
+ readonly type: "string";
569
+ readonly minLength: 1;
570
+ readonly maxLength: 160;
571
+ };
572
+ readonly type: {
573
+ readonly const: "legal-variation";
574
+ };
575
+ readonly start: {
576
+ readonly enum: readonly ["before", "after"];
577
+ };
578
+ readonly moves: {
579
+ readonly type: "array";
580
+ readonly minItems: 1;
581
+ readonly maxItems: 16;
582
+ readonly items: {
583
+ readonly type: "object";
584
+ readonly additionalProperties: false;
585
+ readonly required: readonly ["uci", "pieceId", "san"];
586
+ readonly properties: {
587
+ readonly uci: {
588
+ readonly type: "string";
589
+ readonly minLength: 1;
590
+ readonly maxLength: 5;
591
+ };
592
+ readonly pieceId: {
593
+ readonly type: "string";
594
+ readonly minLength: 1;
595
+ readonly maxLength: 200;
596
+ };
597
+ readonly san: {
598
+ readonly type: "string";
599
+ readonly minLength: 1;
600
+ readonly maxLength: 40;
601
+ };
602
+ };
603
+ };
604
+ };
605
+ readonly label: {
606
+ readonly type: "string";
607
+ readonly minLength: 1;
608
+ readonly maxLength: 160;
609
+ };
610
+ readonly evidenceIds: {
611
+ readonly type: "array";
612
+ readonly minItems: 1;
613
+ readonly maxItems: 12;
614
+ readonly items: {
615
+ readonly type: "string";
616
+ readonly minLength: 1;
617
+ readonly maxLength: 200;
618
+ };
619
+ };
620
+ };
621
+ }, {
622
+ readonly type: "object";
623
+ readonly additionalProperties: false;
624
+ readonly required: readonly ["localId", "type", "pieceId", "waypoints", "prerequisiteRefs", "label", "evidenceIds"];
625
+ readonly properties: {
626
+ readonly localId: {
627
+ readonly type: "string";
628
+ readonly minLength: 1;
629
+ readonly maxLength: 160;
630
+ };
631
+ readonly type: {
632
+ readonly const: "conditional-route";
633
+ };
634
+ readonly pieceId: {
635
+ readonly type: "string";
636
+ readonly minLength: 1;
637
+ readonly maxLength: 200;
638
+ };
639
+ readonly waypoints: {
640
+ readonly type: "array";
641
+ readonly minItems: 1;
642
+ readonly maxItems: 16;
643
+ readonly items: {
644
+ readonly type: "string";
645
+ readonly minLength: 1;
646
+ readonly maxLength: 1000;
647
+ };
648
+ };
649
+ readonly prerequisiteRefs: {
650
+ readonly type: "array";
651
+ readonly minItems: 1;
652
+ readonly maxItems: 16;
653
+ readonly items: {
654
+ readonly $ref: "#/$defs/segment";
655
+ };
656
+ };
657
+ readonly label: {
658
+ readonly type: "string";
659
+ readonly minLength: 1;
660
+ readonly maxLength: 160;
661
+ };
662
+ readonly evidenceIds: {
663
+ readonly type: "array";
664
+ readonly minItems: 1;
665
+ readonly maxItems: 12;
666
+ readonly items: {
667
+ readonly type: "string";
668
+ readonly minLength: 1;
669
+ readonly maxLength: 200;
670
+ };
671
+ };
672
+ };
673
+ }, {
674
+ readonly type: "object";
675
+ readonly additionalProperties: false;
676
+ readonly required: readonly ["localId", "type", "relationLocalId", "fromEntityLocalId", "toEntityLocalId", "label", "evidenceIds"];
677
+ readonly properties: {
678
+ readonly localId: {
679
+ readonly type: "string";
680
+ readonly minLength: 1;
681
+ readonly maxLength: 160;
682
+ };
683
+ readonly type: {
684
+ readonly const: "static-relationship";
685
+ };
686
+ readonly relationLocalId: {
687
+ readonly type: "string";
688
+ readonly minLength: 1;
689
+ readonly maxLength: 160;
690
+ };
691
+ readonly fromEntityLocalId: {
692
+ readonly type: "string";
693
+ readonly minLength: 1;
694
+ readonly maxLength: 160;
695
+ };
696
+ readonly toEntityLocalId: {
697
+ readonly type: "string";
698
+ readonly minLength: 1;
699
+ readonly maxLength: 160;
700
+ };
701
+ readonly label: {
702
+ readonly type: "string";
703
+ readonly minLength: 1;
704
+ readonly maxLength: 160;
705
+ };
706
+ readonly evidenceIds: {
707
+ readonly type: "array";
708
+ readonly minItems: 1;
709
+ readonly maxItems: 12;
710
+ readonly items: {
711
+ readonly type: "string";
712
+ readonly minLength: 1;
713
+ readonly maxLength: 200;
714
+ };
715
+ };
716
+ };
717
+ }];
718
+ };
719
+ readonly coverageLane: {
720
+ readonly type: "object";
721
+ readonly additionalProperties: false;
722
+ readonly required: readonly ["status", "evidenceIds", "unresolved"];
723
+ readonly properties: {
724
+ readonly status: {
725
+ readonly enum: readonly ["complete", "partial", "unavailable"];
726
+ };
727
+ readonly evidenceIds: {
728
+ readonly type: "array";
729
+ readonly maxItems: 12;
730
+ readonly items: {
731
+ readonly type: "string";
732
+ readonly minLength: 1;
733
+ readonly maxLength: 200;
734
+ };
735
+ };
736
+ readonly unresolved: {
737
+ readonly type: "array";
738
+ readonly maxItems: 24;
739
+ readonly items: {
740
+ readonly type: "string";
741
+ readonly minLength: 1;
742
+ readonly maxLength: 1000;
743
+ };
744
+ };
745
+ };
746
+ };
747
+ readonly omission: {
748
+ readonly type: "object";
749
+ readonly additionalProperties: false;
750
+ readonly required: readonly ["localId", "reason"];
751
+ readonly properties: {
752
+ readonly localId: {
753
+ readonly type: "string";
754
+ readonly minLength: 1;
755
+ readonly maxLength: 160;
756
+ };
757
+ readonly reason: {
758
+ readonly type: "string";
759
+ readonly minLength: 1;
760
+ readonly maxLength: 500;
761
+ };
762
+ };
763
+ };
764
+ readonly coverage: {
765
+ readonly type: "object";
766
+ readonly additionalProperties: false;
767
+ readonly required: readonly ["responseCoverage", "continuationCoverage", "unresolvedEvidenceObligations", "omittedHypotheses", "omittedRelations"];
768
+ readonly properties: {
769
+ readonly responseCoverage: {
770
+ readonly $ref: "#/$defs/coverageLane";
771
+ };
772
+ readonly continuationCoverage: {
773
+ readonly $ref: "#/$defs/coverageLane";
774
+ };
775
+ readonly unresolvedEvidenceObligations: {
776
+ readonly type: "array";
777
+ readonly maxItems: 24;
778
+ readonly items: {
779
+ readonly type: "object";
780
+ readonly additionalProperties: false;
781
+ readonly required: readonly ["id", "reason"];
782
+ readonly properties: {
783
+ readonly id: {
784
+ readonly type: "string";
785
+ readonly minLength: 1;
786
+ readonly maxLength: 160;
787
+ };
788
+ readonly reason: {
789
+ readonly type: "string";
790
+ readonly minLength: 1;
791
+ readonly maxLength: 500;
792
+ };
793
+ };
794
+ };
795
+ };
796
+ readonly omittedHypotheses: {
797
+ readonly type: "array";
798
+ readonly maxItems: 24;
799
+ readonly items: {
800
+ readonly $ref: "#/$defs/omission";
801
+ };
802
+ };
803
+ readonly omittedRelations: {
804
+ readonly type: "array";
805
+ readonly maxItems: 24;
806
+ readonly items: {
807
+ readonly $ref: "#/$defs/omission";
808
+ };
809
+ };
810
+ };
811
+ };
812
+ readonly riskProfile: {
813
+ readonly type: "object";
814
+ readonly additionalProperties: false;
815
+ readonly required: readonly ["level", "reasons"];
816
+ readonly properties: {
817
+ readonly level: {
818
+ readonly enum: readonly ["low", "medium", "high"];
819
+ };
820
+ readonly reasons: {
821
+ readonly type: "array";
822
+ readonly maxItems: 12;
823
+ readonly items: {
824
+ readonly type: "string";
825
+ readonly minLength: 1;
826
+ readonly maxLength: 1000;
827
+ };
828
+ };
829
+ };
830
+ };
831
+ };
832
+ };
833
+ export type DirectSynthesisArm = "A1" | "B" | "B-prime";
834
+ export type DirectSynthesisSegment = Exclude<ReasoningNarrativeSegment, {
835
+ type: "move" | "entity" | "relation";
836
+ }> | {
837
+ type: "move";
838
+ uci: string;
839
+ pieceId: string;
840
+ san: string;
841
+ label?: string;
842
+ } | {
843
+ type: "entity";
844
+ entityLocalId: string;
845
+ label?: string;
846
+ } | {
847
+ type: "relation";
848
+ relationLocalId: string;
849
+ fromEntityLocalId: string;
850
+ toEntityLocalId: string;
851
+ label?: string;
852
+ };
853
+ export type DirectSynthesisClaim = {
854
+ localId: string;
855
+ kind: ReasoningClaimKind;
856
+ content: DirectSynthesisSegment[];
857
+ proofStrength: ProofStrength | null;
858
+ evidenceIds: string[];
859
+ qualifications: DirectSynthesisSegment[][];
860
+ };
861
+ export type DirectSynthesisDemonstration = {
862
+ localId: string;
863
+ type: "legal-variation";
864
+ start: "before" | "after";
865
+ moves: Array<{
866
+ uci: string;
867
+ pieceId: string;
868
+ san: string;
869
+ }>;
870
+ label: string;
871
+ evidenceIds: string[];
872
+ } | {
873
+ localId: string;
874
+ type: "conditional-route";
875
+ pieceId: string;
876
+ waypoints: string[];
877
+ prerequisiteRefs: DirectSynthesisSegment[];
878
+ label: string;
879
+ evidenceIds: string[];
880
+ } | {
881
+ localId: string;
882
+ type: "static-relationship";
883
+ relationLocalId: string;
884
+ fromEntityLocalId: string;
885
+ toEntityLocalId: string;
886
+ label: string;
887
+ evidenceIds: string[];
888
+ };
889
+ export type DirectSynthesisRiskProfile = {
890
+ level: "low" | "medium" | "high";
891
+ reasons: string[];
892
+ };
893
+ export type DirectSynthesisCoverageStatus = "complete" | "partial" | "unavailable";
894
+ export type DirectSynthesisCoverage = {
895
+ responseCoverage: {
896
+ status: DirectSynthesisCoverageStatus;
897
+ evidenceIds: string[];
898
+ unresolved: string[];
899
+ };
900
+ continuationCoverage: {
901
+ status: DirectSynthesisCoverageStatus;
902
+ evidenceIds: string[];
903
+ unresolved: string[];
904
+ };
905
+ unresolvedEvidenceObligations: Array<{
906
+ id: string;
907
+ reason: string;
908
+ }>;
909
+ omittedHypotheses: Array<{
910
+ localId: string;
911
+ reason: string;
912
+ }>;
913
+ omittedRelations: Array<{
914
+ localId: string;
915
+ reason: string;
916
+ }>;
917
+ };
918
+ /** A local relation handle is transport-only and is discarded after remapping. */
919
+ export type DirectSynthesisRelationProposal = ReasoningHypothesisRelationProposal & {
920
+ localId: string;
921
+ };
922
+ /** Model-local handles are permitted only in this inbound proposal. */
923
+ export type DirectSynthesisProposal = {
924
+ schemaVersion: typeof ABLATION_DIRECT_SYNTHESIS_VERSION;
925
+ hypotheses: ReasoningHypothesisProposal[];
926
+ relations: DirectSynthesisRelationProposal[];
927
+ claims: DirectSynthesisClaim[];
928
+ demonstrations?: DirectSynthesisDemonstration[];
929
+ coverage: DirectSynthesisCoverage;
930
+ limitations: string[];
931
+ riskProfile: DirectSynthesisRiskProfile;
932
+ };
933
+ export type CanonicalDirectSynthesisClaim = Omit<DirectSynthesisClaim, "localId" | "content" | "qualifications"> & {
934
+ id: string;
935
+ content: ReasoningNarrativeSegment[];
936
+ qualifications: ReasoningNarrativeSegment[][];
937
+ };
938
+ export type CanonicalDirectSynthesisDemonstration = {
939
+ id: string;
940
+ type: "legal-variation";
941
+ start: "before" | "after";
942
+ moves: Array<{
943
+ uci: string;
944
+ pieceId: string;
945
+ san: string;
946
+ }>;
947
+ label: string;
948
+ evidenceIds: string[];
949
+ } | {
950
+ id: string;
951
+ type: "conditional-route";
952
+ pieceId: string;
953
+ waypoints: string[];
954
+ prerequisiteRefs: ReasoningNarrativeSegment[];
955
+ label: string;
956
+ evidenceIds: string[];
957
+ } | {
958
+ id: string;
959
+ type: "static-relationship";
960
+ relationId: string;
961
+ fromEntityId: string;
962
+ toEntityId: string;
963
+ relationType: string;
964
+ label: string;
965
+ evidenceIds: string[];
966
+ };
967
+ /** The Ledger's localId is an input-only helper and is never persisted here. */
968
+ export type CanonicalDirectSynthesisHypothesis = Omit<ReasoningHypothesisRecord, "localId">;
969
+ /**
970
+ * This artifact is intentionally pre-checkpoint. It contains only canonical
971
+ * Ledger records plus directly validated narrative material; it does not
972
+ * manufacture acceptance, graph selection, or a C-stage checkpoint.
973
+ */
974
+ export type DirectSynthesisArtifact = {
975
+ schemaVersion: typeof ABLATION_DIRECT_SYNTHESIS_VERSION;
976
+ contextHash: string;
977
+ bundleHash: string;
978
+ hypotheses: CanonicalDirectSynthesisHypothesis[];
979
+ relations: ReasoningHypothesisRelationRecord[];
980
+ claims: CanonicalDirectSynthesisClaim[];
981
+ demonstrations: CanonicalDirectSynthesisDemonstration[];
982
+ coverage: Omit<DirectSynthesisCoverage, "omittedHypotheses" | "omittedRelations"> & {
983
+ omittedHypothesisIds: Array<{
984
+ hypothesisId: string;
985
+ reason: string;
986
+ }>;
987
+ omittedRelationIds: Array<{
988
+ relationId: string;
989
+ reason: string;
990
+ }>;
991
+ };
992
+ admission: "pre-checkpoint-proposed";
993
+ productSupport: "not-a-validated-graph-checkpoint-or-product-result";
994
+ limitations: string[];
995
+ riskProfile: DirectSynthesisRiskProfile;
996
+ };
997
+ export type DirectSynthesisIssue = {
998
+ path: string;
999
+ code: string;
1000
+ message: string;
1001
+ permittedReferences: string[];
1002
+ };
1003
+ export type DirectSynthesisMaterializationResult = {
1004
+ ok: true;
1005
+ metadata: {
1006
+ arm: DirectSynthesisArm;
1007
+ };
1008
+ artifact: DirectSynthesisArtifact;
1009
+ } | {
1010
+ ok: false;
1011
+ metadata: {
1012
+ arm: DirectSynthesisArm;
1013
+ };
1014
+ code: "direct-synthesis-rejected";
1015
+ issues: DirectSynthesisIssue[];
1016
+ };
1017
+ export type MaterializeDirectSynthesisInput = {
1018
+ arm: DirectSynthesisArm;
1019
+ bundle: Readonly<AblationEvidenceClosureBundle>;
1020
+ proposal: unknown;
1021
+ provenance?: ReasoningHypothesisProvenance;
1022
+ };
1023
+ /** Strict parser intended for a later model-runtime adapter. */
1024
+ export declare function parseDirectSynthesisProposal(value: unknown): DirectSynthesisProposal;
1025
+ /**
1026
+ * Deterministically validates and materializes a direct A1/B/B-prime result.
1027
+ * It returns a typed failure instead of narrowing, repairing, or inventing
1028
+ * chess meaning.
1029
+ */
1030
+ export declare function materializeDirectSynthesis(input: MaterializeDirectSynthesisInput): DirectSynthesisMaterializationResult;