@lucern/contracts 0.1.1-alpha.1 → 0.1.2-alpha.1

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 (151) hide show
  1. package/CHANGELOG.md +3 -0
  2. package/README.md +3 -0
  3. package/dist/agents/v1.d.ts +2 -0
  4. package/dist/agents/v1.js +3 -0
  5. package/dist/agents/v1.js.map +1 -0
  6. package/dist/api-enums.contract.d.ts +60 -0
  7. package/dist/api-enums.contract.js +160 -0
  8. package/dist/api-enums.contract.js.map +1 -0
  9. package/dist/auth-context.contract.d.ts +2 -0
  10. package/dist/auth-context.contract.js +48 -0
  11. package/dist/auth-context.contract.js.map +1 -0
  12. package/dist/auth-session.contract.d.ts +2 -0
  13. package/dist/auth-session.contract.js +48 -0
  14. package/dist/auth-session.contract.js.map +1 -0
  15. package/dist/auth.contract.d.ts +92 -0
  16. package/dist/auth.contract.js +48 -0
  17. package/dist/auth.contract.js.map +1 -0
  18. package/dist/beliefs/v1.d.ts +2 -0
  19. package/dist/beliefs/v1.js +3 -0
  20. package/dist/beliefs/v1.js.map +1 -0
  21. package/dist/context-pack.contract.d.ts +496 -0
  22. package/dist/context-pack.contract.js +98 -0
  23. package/dist/context-pack.contract.js.map +1 -0
  24. package/dist/convex-admin.contract.d.ts +7 -0
  25. package/dist/convex-admin.contract.js +3 -0
  26. package/dist/convex-admin.contract.js.map +1 -0
  27. package/dist/events-types.contract.d.ts +1 -0
  28. package/dist/events-types.contract.js +136 -0
  29. package/dist/events-types.contract.js.map +1 -0
  30. package/dist/events.contract.d.ts +178 -0
  31. package/dist/events.contract.js +136 -0
  32. package/dist/events.contract.js.map +1 -0
  33. package/dist/evidence/v1.d.ts +2 -0
  34. package/dist/evidence/v1.js +3 -0
  35. package/dist/evidence/v1.js.map +1 -0
  36. package/dist/gateway.contract.d.ts +79 -0
  37. package/dist/gateway.contract.js +12 -0
  38. package/dist/gateway.contract.js.map +1 -0
  39. package/dist/graph/v1.d.ts +2 -0
  40. package/dist/graph/v1.js +3 -0
  41. package/dist/graph/v1.js.map +1 -0
  42. package/dist/ids.contract.d.ts +9 -0
  43. package/{src/ids.contract.ts → dist/ids.contract.js} +10 -17
  44. package/dist/ids.contract.js.map +1 -0
  45. package/dist/index.d.ts +15 -2004
  46. package/dist/index.js +4 -105
  47. package/dist/index.js.map +1 -0
  48. package/dist/lens-filter.contract.d.ts +72 -0
  49. package/dist/lens-filter.contract.js +71 -0
  50. package/dist/lens-filter.contract.js.map +1 -0
  51. package/dist/lens-workflow.contract.d.ts +87 -0
  52. package/dist/lens-workflow.contract.js +123 -0
  53. package/dist/lens-workflow.contract.js.map +1 -0
  54. package/dist/mcp-tools.contract-D8kXcP6d.d.ts +254 -0
  55. package/dist/mcp-tools.contract.d.ts +1 -0
  56. package/dist/mcp-tools.contract.js +2986 -0
  57. package/dist/mcp-tools.contract.js.map +1 -0
  58. package/dist/ontologies/v1.d.ts +2 -0
  59. package/dist/ontologies/v1.js +3 -0
  60. package/dist/ontologies/v1.js.map +1 -0
  61. package/dist/ontology-matching.contract.d.ts +1 -0
  62. package/dist/ontology-matching.contract.js +346 -0
  63. package/dist/ontology-matching.contract.js.map +1 -0
  64. package/dist/prompt.contract.d.ts +26 -0
  65. package/dist/prompt.contract.js +12 -0
  66. package/dist/prompt.contract.js.map +1 -0
  67. package/dist/questions/v1.d.ts +2 -0
  68. package/dist/questions/v1.js +3 -0
  69. package/dist/questions/v1.js.map +1 -0
  70. package/dist/sdk-methods.contract.d.ts +362 -0
  71. package/dist/sdk-methods.contract.js +3 -0
  72. package/dist/sdk-methods.contract.js.map +1 -0
  73. package/dist/sdk-tools.contract-BnV0hKLp.d.ts +150 -0
  74. package/dist/sdk-tools.contract.d.ts +2 -0
  75. package/dist/sdk-tools.contract.js +4222 -0
  76. package/dist/sdk-tools.contract.js.map +1 -0
  77. package/dist/text-matching.contract.d.ts +55 -0
  78. package/{src/text-matching.contract.ts → dist/text-matching.contract.js} +36 -137
  79. package/dist/text-matching.contract.js.map +1 -0
  80. package/dist/topic-scope.contract.d.ts +1 -0
  81. package/{src/v1/topics/v1.ts → dist/topic-scope.contract.js} +13 -38
  82. package/dist/topic-scope.contract.js.map +1 -0
  83. package/dist/topics/v1.d.ts +2 -0
  84. package/dist/topics/v1.js +3 -0
  85. package/dist/topics/v1.js.map +1 -0
  86. package/dist/v1/agents/v1.d.ts +2 -0
  87. package/dist/v1/agents/v1.js +3 -0
  88. package/dist/v1/agents/v1.js.map +1 -0
  89. package/dist/v1/beliefs/v1.d.ts +2 -0
  90. package/dist/v1/beliefs/v1.js +3 -0
  91. package/dist/v1/beliefs/v1.js.map +1 -0
  92. package/dist/v1/evidence/v1.d.ts +2 -0
  93. package/dist/v1/evidence/v1.js +3 -0
  94. package/dist/v1/evidence/v1.js.map +1 -0
  95. package/dist/v1/graph/v1.d.ts +2 -0
  96. package/dist/v1/graph/v1.js +3 -0
  97. package/dist/v1/graph/v1.js.map +1 -0
  98. package/dist/v1/ontologies/v1.d.ts +78 -0
  99. package/dist/v1/ontologies/v1.js +346 -0
  100. package/dist/v1/ontologies/v1.js.map +1 -0
  101. package/dist/v1/questions/v1.d.ts +2 -0
  102. package/dist/v1/questions/v1.js +3 -0
  103. package/dist/v1/questions/v1.js.map +1 -0
  104. package/dist/v1/topics/v1.d.ts +21 -0
  105. package/dist/v1/topics/v1.js +54 -0
  106. package/dist/v1/topics/v1.js.map +1 -0
  107. package/dist/v1/worktrees/v1.d.ts +2 -0
  108. package/dist/v1/worktrees/v1.js +3 -0
  109. package/dist/v1/worktrees/v1.js.map +1 -0
  110. package/dist/workflow-runtime.contract.d.ts +163 -0
  111. package/dist/workflow-runtime.contract.js +245 -0
  112. package/dist/workflow-runtime.contract.js.map +1 -0
  113. package/dist/worktrees/v1.d.ts +2 -0
  114. package/dist/worktrees/v1.js +3 -0
  115. package/dist/worktrees/v1.js.map +1 -0
  116. package/package.json +23 -7
  117. package/src/agents/v1.ts +0 -8
  118. package/src/api-enums.contract.ts +0 -183
  119. package/src/auth-context.contract.ts +0 -9
  120. package/src/auth-session.contract.ts +0 -9
  121. package/src/auth.contract.ts +0 -162
  122. package/src/beliefs/v1.ts +0 -8
  123. package/src/context-pack.contract.ts +0 -704
  124. package/src/convex-admin.contract.ts +0 -14
  125. package/src/events-types.contract.ts +0 -9
  126. package/src/events.contract.ts +0 -376
  127. package/src/evidence/v1.ts +0 -8
  128. package/src/gateway.contract.ts +0 -151
  129. package/src/graph/v1.ts +0 -8
  130. package/src/index.ts +0 -30
  131. package/src/lens-filter.contract.ts +0 -183
  132. package/src/lens-workflow.contract.ts +0 -162
  133. package/src/mcp-tools.contract.ts +0 -3636
  134. package/src/ontologies/v1.ts +0 -8
  135. package/src/ontology-matching.contract.ts +0 -9
  136. package/src/prompt.contract.ts +0 -50
  137. package/src/questions/v1.ts +0 -8
  138. package/src/sdk-methods.contract.ts +0 -522
  139. package/src/sdk-tools.contract.ts +0 -1545
  140. package/src/topic-scope.contract.ts +0 -9
  141. package/src/topics/v1.ts +0 -8
  142. package/src/v1/agents/v1.ts +0 -8
  143. package/src/v1/beliefs/v1.ts +0 -8
  144. package/src/v1/evidence/v1.ts +0 -8
  145. package/src/v1/graph/v1.ts +0 -8
  146. package/src/v1/ontologies/v1.ts +0 -276
  147. package/src/v1/questions/v1.ts +0 -8
  148. package/src/v1/worktrees/v1.ts +0 -8
  149. package/src/workflow-runtime.contract.ts +0 -440
  150. package/src/worktrees/v1.ts +0 -8
  151. package/tsconfig.json +0 -9
@@ -0,0 +1,362 @@
1
+ import { EpistemicLayer, BeliefStatus, ConfidenceTrigger, ForkReason, ContradictionSeverity, DefeatType, ReasoningMethod, MergeOutcome, JudgmentType, BranchStatus, PullRequestStatus } from './api-enums.contract.js';
2
+ import { ContextRankingProfile, PublicCompiledContext } from './context-pack.contract.js';
3
+
4
+ /**
5
+ * SDK Method Contract Definitions
6
+ *
7
+ * Canonical method signatures for the Lucern TypeScript SDK.
8
+ * DERIVED from API contracts — not independently authored.
9
+ *
10
+ * These types define the public API of `@lucern/sdk`, covering:
11
+ * - client initialization (formerly @lucern/sdk-core)
12
+ * - belief, evidence, edge, contradiction operations (formerly @lucern/sdk-graph)
13
+ * - branch, worktree, merge, push, pull request lifecycle (formerly @lucern/sdk-workflows)
14
+ *
15
+ * Historical note: T7.3.2 (2026-04-18) deleted the three sdk-alpha shim
16
+ * packages; all surfaces now ship in the single `@lucern/sdk` package.
17
+ *
18
+ * CONTRACT SURFACE: Method signatures are semver-bound.
19
+ * Adding optional parameters is non-breaking.
20
+ * Changing required parameters or return types is BREAKING.
21
+ */
22
+
23
+ type LucernClientConfig = {
24
+ apiKey: string;
25
+ environment: "sandbox" | "production";
26
+ /** Optional base URL override for self-hosted deployments */
27
+ baseUrl?: string;
28
+ };
29
+ type LucernClient = {
30
+ /** The authenticated client instance */
31
+ readonly config: LucernClientConfig;
32
+ };
33
+ /** Input to createBelief() */
34
+ type CreateBeliefInput = {
35
+ canonicalText: string;
36
+ topicId: string;
37
+ /** @deprecated Use topicId. */
38
+ projectId?: string;
39
+ layer?: EpistemicLayer;
40
+ domain?: string;
41
+ nodeType?: string;
42
+ };
43
+ /** Result of createBelief() */
44
+ type BeliefResult = {
45
+ nodeId: string;
46
+ globalId: string;
47
+ canonicalText: string;
48
+ status: BeliefStatus;
49
+ createdAt: number;
50
+ };
51
+ /** Input to refineBelief() */
52
+ type RefineBeliefInput = {
53
+ canonicalText: string;
54
+ rationale?: string;
55
+ };
56
+ /** Input to modulateConfidence() */
57
+ type ModulateConfidenceInput = {
58
+ confidence: number;
59
+ trigger: ConfidenceTrigger;
60
+ rationale: string;
61
+ };
62
+ /** Result of modulateConfidence() */
63
+ type ConfidenceResult = {
64
+ nodeId: string;
65
+ newConfidence: number;
66
+ previousConfidence: number | null;
67
+ trigger: ConfidenceTrigger;
68
+ };
69
+ /** Input to forkBelief() */
70
+ type ForkBeliefInput = {
71
+ newFormulation: string;
72
+ forkReason: ForkReason;
73
+ };
74
+ /** Result of forkBelief() */
75
+ type ForkResult = {
76
+ nodeId: string;
77
+ parentNodeId: string;
78
+ forkReason: ForkReason;
79
+ canonicalText: string;
80
+ };
81
+ /** Input to addEvidence() */
82
+ type AddEvidenceInput = {
83
+ canonicalText: string;
84
+ topicId: string;
85
+ /** @deprecated Use topicId. */
86
+ projectId?: string;
87
+ sourceUrl?: string;
88
+ supports?: {
89
+ nodeId: string;
90
+ weight: number;
91
+ reasoning?: string;
92
+ };
93
+ };
94
+ /** Result of addEvidence() */
95
+ type EvidenceResult = {
96
+ nodeId: string;
97
+ globalId: string;
98
+ edgeId?: string;
99
+ };
100
+ /** Input to flagContradiction() */
101
+ type FlagContradictionInput = {
102
+ beliefA: string;
103
+ beliefB: string;
104
+ description: string;
105
+ severity: ContradictionSeverity;
106
+ topicId: string;
107
+ /** @deprecated Use topicId. */
108
+ projectId?: string;
109
+ defeatType?: DefeatType;
110
+ };
111
+ /** Result of flagContradiction() */
112
+ type ContradictionResult = {
113
+ contradictionId: string;
114
+ status: "unresolved";
115
+ beliefA: string;
116
+ beliefB: string;
117
+ defeatType?: DefeatType;
118
+ };
119
+ /** Input to createEdge() */
120
+ type CreateEdgeInput = {
121
+ sourceId: string;
122
+ targetId: string;
123
+ edgeType: string;
124
+ weight?: number;
125
+ reasoning?: string;
126
+ reasoningMethod?: ReasoningMethod;
127
+ };
128
+ /** Result of createEdge() */
129
+ type EdgeResult = {
130
+ globalId: string;
131
+ edgeType: string;
132
+ fromLayer: EpistemicLayer;
133
+ toLayer: EpistemicLayer;
134
+ };
135
+ /** Input to queryLineage() */
136
+ type QueryLineageInput = {
137
+ depth?: number;
138
+ };
139
+ /** Result of queryLineage() */
140
+ type LineageResult = {
141
+ chain: Array<{
142
+ nodeId: string;
143
+ canonicalText: string;
144
+ confidence: number | null;
145
+ forkedFrom: string | null;
146
+ scoredAt: number | null;
147
+ }>;
148
+ forkTree: Record<string, string[]>;
149
+ depth: number;
150
+ };
151
+ /** Input to searchBeliefs() */
152
+ type SearchBeliefsInput = {
153
+ query: string;
154
+ status?: BeliefStatus;
155
+ minConfidence?: number;
156
+ topicId?: string;
157
+ /** @deprecated Use topicId. */
158
+ projectId?: string;
159
+ limit?: number;
160
+ };
161
+ /** Input to context.compile() */
162
+ type CompileContextInput = {
163
+ query?: string;
164
+ budget?: number;
165
+ ranking?: ContextRankingProfile;
166
+ limit?: number;
167
+ maxDepth?: number;
168
+ includeEntities?: boolean;
169
+ };
170
+ /** Result of context.compile() */
171
+ type CompiledContextResult = PublicCompiledContext;
172
+ /** Input to addWorktree() — like git worktree add <branch> */
173
+ type AddWorktreeInput = {
174
+ title: string;
175
+ topicId: string;
176
+ /** @deprecated Use topicId. */
177
+ projectId?: string;
178
+ branchId?: string;
179
+ objective?: string;
180
+ hypothesis?: string;
181
+ beliefIds?: string[];
182
+ autoShape?: boolean;
183
+ domainPackId?: string;
184
+ executionOrder?: number;
185
+ dependsOn?: string[];
186
+ blocks?: string[];
187
+ gate?: string;
188
+ };
189
+ /** Result of addWorktree() */
190
+ type WorktreeResult = {
191
+ worktreeId: string;
192
+ title: string;
193
+ status: string;
194
+ hypothesis?: string;
195
+ questionCount?: number;
196
+ taskCount?: number;
197
+ autoShapeApplied?: boolean;
198
+ };
199
+ /** Input to merge() */
200
+ type MergeInput = {
201
+ outcomes: Array<{
202
+ beliefId: string;
203
+ confidence: number;
204
+ rationale: string;
205
+ }>;
206
+ summary?: string;
207
+ };
208
+ /** Result of merge() */
209
+ type MergeResult = {
210
+ worktreeId: string;
211
+ status: "merged";
212
+ outcome: MergeOutcome;
213
+ beliefsScored: number;
214
+ };
215
+ /** Input to recordJudgment() */
216
+ type RecordJudgmentInput = {
217
+ title: string;
218
+ rationale: string;
219
+ topicId: string;
220
+ /** @deprecated Use topicId. */
221
+ projectId?: string;
222
+ beliefIds?: string[];
223
+ confidence?: number;
224
+ judgmentType?: JudgmentType;
225
+ };
226
+ /** Result of recordJudgment() */
227
+ type JudgmentResult = {
228
+ judgmentId: string;
229
+ title: string;
230
+ status: "issued";
231
+ };
232
+ /** Input to createBranch() */
233
+ type CreateBranchInput = {
234
+ name: string;
235
+ topicId: string;
236
+ /** @deprecated Use topicId. */
237
+ projectId?: string;
238
+ description?: string;
239
+ };
240
+ /** Result of createBranch() */
241
+ type BranchResult = {
242
+ branchId: string;
243
+ name: string;
244
+ status: BranchStatus;
245
+ createdAt: number;
246
+ };
247
+ /** Input to push() */
248
+ type PushInput = {
249
+ targetContext: string;
250
+ beliefIds?: string[];
251
+ };
252
+ /** Result of push() */
253
+ type PushResult = {
254
+ pushedCount: number;
255
+ targetContext: string;
256
+ pushedAt: number;
257
+ };
258
+ /** Input to openPullRequest() */
259
+ type OpenPullRequestInput = {
260
+ reviewers?: string[];
261
+ summary: string;
262
+ };
263
+ /** Result of openPullRequest() */
264
+ type PullRequestResult = {
265
+ pullRequestId: string;
266
+ worktreeId: string;
267
+ status: PullRequestStatus;
268
+ };
269
+ /** Input to bisectConfidence() */
270
+ type BisectConfidenceInput = {
271
+ expectedDirection: "overconfident" | "underconfident";
272
+ timeRange?: {
273
+ start: number;
274
+ end: number;
275
+ };
276
+ };
277
+ /** Result of bisectConfidence() */
278
+ type BisectResult = {
279
+ inflectionEntry: {
280
+ confidence: number;
281
+ trigger: ConfidenceTrigger;
282
+ rationale: string;
283
+ timestamp: number;
284
+ };
285
+ triggerEvent: string;
286
+ confidenceBefore: number;
287
+ confidenceAfter: number;
288
+ };
289
+ /**
290
+ * @lucern/sdk (graph) method signatures.
291
+ *
292
+ * These define the public API. Implementation must match these signatures.
293
+ * Parameters are the source of truth — generated from API contracts.
294
+ */
295
+ type LucernGraphMethods = {
296
+ createBelief(client: LucernClient, input: CreateBeliefInput): Promise<BeliefResult>;
297
+ refineBelief(client: LucernClient, nodeId: string, input: RefineBeliefInput): Promise<BeliefResult>;
298
+ modulateConfidence(client: LucernClient, nodeId: string, input: ModulateConfidenceInput): Promise<ConfidenceResult>;
299
+ forkBelief(client: LucernClient, nodeId: string, input: ForkBeliefInput): Promise<ForkResult>;
300
+ archiveBelief(client: LucernClient, nodeId: string, rationale?: string): Promise<{
301
+ nodeId: string;
302
+ status: "archived";
303
+ }>;
304
+ addEvidence(client: LucernClient, input: AddEvidenceInput): Promise<EvidenceResult>;
305
+ flagContradiction(client: LucernClient, input: FlagContradictionInput): Promise<ContradictionResult>;
306
+ createEdge(client: LucernClient, input: CreateEdgeInput): Promise<EdgeResult>;
307
+ queryLineage(client: LucernClient, nodeId: string, input?: QueryLineageInput): Promise<LineageResult>;
308
+ getConfidenceHistory(client: LucernClient, nodeId: string): Promise<{
309
+ entries: Array<{
310
+ confidence: number;
311
+ trigger: ConfidenceTrigger;
312
+ rationale: string;
313
+ timestamp: number;
314
+ userId: string;
315
+ }>;
316
+ }>;
317
+ getAuditTrail(client: LucernClient, nodeId: string, limit?: number): Promise<{
318
+ entries: Array<{
319
+ action: string;
320
+ actor: string;
321
+ timestamp: number;
322
+ rationale?: string;
323
+ }>;
324
+ }>;
325
+ searchBeliefs(client: LucernClient, input: SearchBeliefsInput): Promise<{
326
+ results: BeliefResult[];
327
+ }>;
328
+ findContradictions(client: LucernClient, input: {
329
+ topicId?: string;
330
+ projectId?: string;
331
+ nodeId?: string;
332
+ status?: string;
333
+ }): Promise<{
334
+ contradictions: ContradictionResult[];
335
+ }>;
336
+ traverseGraph(client: LucernClient, input: {
337
+ startNode: string;
338
+ direction?: "up" | "down" | "both";
339
+ maxDepth?: number;
340
+ }): Promise<{
341
+ nodes: unknown[];
342
+ edges: unknown[];
343
+ depth: number;
344
+ }>;
345
+ bisectConfidence(client: LucernClient, nodeId: string, input: BisectConfidenceInput): Promise<BisectResult>;
346
+ recordJudgment(client: LucernClient, input: RecordJudgmentInput): Promise<JudgmentResult>;
347
+ };
348
+ /**
349
+ * @lucern/sdk (workflows) method signatures.
350
+ *
351
+ * Lifecycle: createBranch (git branch) → addWorktree (git worktree add) →
352
+ * openPullRequest (git pull request) → merge (git merge) → push (git push)
353
+ */
354
+ type LucernWorkflowMethods = {
355
+ createBranch(client: LucernClient, input: CreateBranchInput): Promise<BranchResult>;
356
+ addWorktree(client: LucernClient, input: AddWorktreeInput): Promise<WorktreeResult>;
357
+ merge(client: LucernClient, worktreeId: string, input: MergeInput): Promise<MergeResult>;
358
+ openPullRequest(client: LucernClient, worktreeId: string, input: OpenPullRequestInput): Promise<PullRequestResult>;
359
+ push(client: LucernClient, worktreeId: string, input: PushInput): Promise<PushResult>;
360
+ };
361
+
362
+ export type { AddEvidenceInput, AddWorktreeInput, BeliefResult, BisectConfidenceInput, BisectResult, BranchResult, CompileContextInput, CompiledContextResult, ConfidenceResult, ContradictionResult, CreateBeliefInput, CreateBranchInput, CreateEdgeInput, EdgeResult, EvidenceResult, FlagContradictionInput, ForkBeliefInput, ForkResult, JudgmentResult, LineageResult, LucernClient, LucernClientConfig, LucernGraphMethods, LucernWorkflowMethods, MergeInput, MergeResult, ModulateConfidenceInput, OpenPullRequestInput, PullRequestResult, PushInput, PushResult, QueryLineageInput, RecordJudgmentInput, RefineBeliefInput, SearchBeliefsInput, WorktreeResult };
@@ -0,0 +1,3 @@
1
+
2
+ //# sourceMappingURL=sdk-methods.contract.js.map
3
+ //# sourceMappingURL=sdk-methods.contract.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":[],"names":[],"mappings":"","file":"sdk-methods.contract.js"}
@@ -0,0 +1,150 @@
1
+ import { M as McpToolContract } from './mcp-tools.contract-D8kXcP6d.js';
2
+
3
+ /**
4
+ * SDK-Only Tool Contract Definitions
5
+ *
6
+ * Tools available in @lucern/sdk but NOT in the MCP gateway.
7
+ * The SDK unfolds deeper capabilities after the MCP gateway shows developers what's possible.
8
+ *
9
+ * Total SDK surface = MCP tools (44) + SDK-only tools (44) = 88 tools
10
+ *
11
+ * These tools are organized into capability tiers:
12
+ * - Advanced workflow & phase management (12 tools)
13
+ * - Deeper graph navigation (6 tools)
14
+ * - Conviction & analytics (7 tools)
15
+ * - Extended question & evidence analytics (1 tool; core lifecycle promoted to MCP)
16
+ * - Task lifecycle (5 tools)
17
+ * - Domain analytics (8 tools)
18
+ * - Bias detection suite (5 tools)
19
+ *
20
+ * CONTRACT SURFACE: These definitions are the external API for SDK consumers.
21
+ * Renaming a tool or changing its description is a BREAKING CHANGE.
22
+ *
23
+ * Git-native naming rules (same as MCP, enforced by lint):
24
+ * 1. Workflow tools use git verbs directly
25
+ * 2. Knowledge tools use epistemic verbs
26
+ * 3. First sentence of description includes the git analog verb
27
+ * 4. Description includes "Like `git X`" parenthetical
28
+ * 5. Parameter names use domain terms (canonicalText, nodeId, confidence)
29
+ */
30
+
31
+ /** SDK-only tool contract — same shape as MCP but with sdk-only tier marker */
32
+ interface SdkToolContract extends Omit<McpToolContract, "tier"> {
33
+ tier: "sdk-only";
34
+ }
35
+ declare const START_WORKTREE: SdkToolContract;
36
+ declare const UPDATE_WORKTREE_PHASE: SdkToolContract;
37
+ declare const ADVANCE_WORKTREE_PHASE: SdkToolContract;
38
+ declare const ADD_NOTE_TO_WORKTREE: SdkToolContract;
39
+ declare const LINK_DOCUMENT_TO_WORKTREE: SdkToolContract;
40
+ declare const LINK_EVIDENCE_TO_WORKTREE: SdkToolContract;
41
+ declare const LINK_QUESTION_TO_WORKTREE: SdkToolContract;
42
+ declare const LINK_BELIEF_TO_WORKTREE: SdkToolContract;
43
+ declare const CREATE_SYNTHESIZED_BELIEF: SdkToolContract;
44
+ declare const COMPLETE_HYPOTHESIS_FORMATION: SdkToolContract;
45
+ declare const COMPLETE_EVIDENCE_REVIEW: SdkToolContract;
46
+ declare const REFINE_WORKTREE_BELIEF: SdkToolContract;
47
+ declare const TRACE_PROVENANCE: SdkToolContract;
48
+ declare const GET_BELIEF_RELATIONSHIPS: SdkToolContract;
49
+ declare const GET_BELIEF_SUPPORT_CHAIN: SdkToolContract;
50
+ declare const EXPLORE_CONNECTIONS: SdkToolContract;
51
+ declare const GET_DEEP_LINEAGE: SdkToolContract;
52
+ declare const GRAPH_AWARE_SEARCH: SdkToolContract;
53
+ declare const GET_COLLECTION_CONVICTION: SdkToolContract;
54
+ declare const GET_CONVICTION_TREND: SdkToolContract;
55
+ declare const ANALYZE_BELIEF_CRITICALITY: SdkToolContract;
56
+ declare const ANALYZE_BELIEF_CLUSTER_CANDIDATES: SdkToolContract;
57
+ declare const CREATE_BELIEF_CONDITIONAL: SdkToolContract;
58
+ declare const GET_NECESSARY_EVIDENCE: SdkToolContract;
59
+ declare const ANALYZE_REASONING_DEPTH: SdkToolContract;
60
+ declare const GET_EVIDENCE_BY_METHODOLOGY: SdkToolContract;
61
+ declare const CREATE_EVIDENCE_TASK: SdkToolContract;
62
+ declare const LIST_TASKS: SdkToolContract;
63
+ declare const UPDATE_TASK: SdkToolContract;
64
+ declare const GET_TASK_COUNTS: SdkToolContract;
65
+ declare const ADD_RESEARCH_ACTION: SdkToolContract;
66
+ declare const GET_PREDICTIONS: SdkToolContract;
67
+ declare const GET_SURPRISE_DETECTION: SdkToolContract;
68
+ declare const GET_CHALLENGED_BELIEFS: SdkToolContract;
69
+ declare const GET_CAUSAL_CHAINS: SdkToolContract;
70
+ declare const GET_NON_CONSENSUS_BELIEFS: SdkToolContract;
71
+ declare const GET_BELIEFS_BY_EPISTEMIC_STATUS: SdkToolContract;
72
+ declare const GET_PRIVILEGED_EVIDENCE: SdkToolContract;
73
+ declare const GET_PRIVILEGED_SIGNALS: SdkToolContract;
74
+ declare const DETECT_ANCHORING_BIAS: SdkToolContract;
75
+ declare const DETECT_SOURCE_CONCENTRATION: SdkToolContract;
76
+ declare const FIND_SOFT_CONTRADICTIONS: SdkToolContract;
77
+ declare const FIND_SEMANTIC_BRIDGES: SdkToolContract;
78
+ declare const FIND_SEMANTIC_ORPHANS: SdkToolContract;
79
+ /** All SDK-only tool contracts, indexed by name */
80
+ declare const SDK_ONLY_TOOL_CONTRACTS: Record<string, SdkToolContract>;
81
+ /** Complete SDK surface: MCP gateway tools + SDK-only advanced tools */
82
+ declare const ALL_SDK_TOOL_CONTRACTS: Record<string, McpToolContract | SdkToolContract>;
83
+ /** All SDK-only tool names */
84
+ declare const SDK_ONLY_TOOL_NAMES: string[];
85
+ /** All tool names across the complete SDK surface */
86
+ declare const ALL_SDK_TOOL_NAMES: string[];
87
+ /**
88
+ * Lint validation: every SDK tool description must contain "Like `git" reference.
89
+ * Reuses the same git-semantic validation rule as MCP tools.
90
+ */
91
+ declare function validateSdkGitSemantics(tool: SdkToolContract): {
92
+ valid: boolean;
93
+ reason?: string;
94
+ };
95
+
96
+ declare const sdkTools_contract_ADD_NOTE_TO_WORKTREE: typeof ADD_NOTE_TO_WORKTREE;
97
+ declare const sdkTools_contract_ADD_RESEARCH_ACTION: typeof ADD_RESEARCH_ACTION;
98
+ declare const sdkTools_contract_ADVANCE_WORKTREE_PHASE: typeof ADVANCE_WORKTREE_PHASE;
99
+ declare const sdkTools_contract_ALL_SDK_TOOL_CONTRACTS: typeof ALL_SDK_TOOL_CONTRACTS;
100
+ declare const sdkTools_contract_ALL_SDK_TOOL_NAMES: typeof ALL_SDK_TOOL_NAMES;
101
+ declare const sdkTools_contract_ANALYZE_BELIEF_CLUSTER_CANDIDATES: typeof ANALYZE_BELIEF_CLUSTER_CANDIDATES;
102
+ declare const sdkTools_contract_ANALYZE_BELIEF_CRITICALITY: typeof ANALYZE_BELIEF_CRITICALITY;
103
+ declare const sdkTools_contract_ANALYZE_REASONING_DEPTH: typeof ANALYZE_REASONING_DEPTH;
104
+ declare const sdkTools_contract_COMPLETE_EVIDENCE_REVIEW: typeof COMPLETE_EVIDENCE_REVIEW;
105
+ declare const sdkTools_contract_COMPLETE_HYPOTHESIS_FORMATION: typeof COMPLETE_HYPOTHESIS_FORMATION;
106
+ declare const sdkTools_contract_CREATE_BELIEF_CONDITIONAL: typeof CREATE_BELIEF_CONDITIONAL;
107
+ declare const sdkTools_contract_CREATE_EVIDENCE_TASK: typeof CREATE_EVIDENCE_TASK;
108
+ declare const sdkTools_contract_CREATE_SYNTHESIZED_BELIEF: typeof CREATE_SYNTHESIZED_BELIEF;
109
+ declare const sdkTools_contract_DETECT_ANCHORING_BIAS: typeof DETECT_ANCHORING_BIAS;
110
+ declare const sdkTools_contract_DETECT_SOURCE_CONCENTRATION: typeof DETECT_SOURCE_CONCENTRATION;
111
+ declare const sdkTools_contract_EXPLORE_CONNECTIONS: typeof EXPLORE_CONNECTIONS;
112
+ declare const sdkTools_contract_FIND_SEMANTIC_BRIDGES: typeof FIND_SEMANTIC_BRIDGES;
113
+ declare const sdkTools_contract_FIND_SEMANTIC_ORPHANS: typeof FIND_SEMANTIC_ORPHANS;
114
+ declare const sdkTools_contract_FIND_SOFT_CONTRADICTIONS: typeof FIND_SOFT_CONTRADICTIONS;
115
+ declare const sdkTools_contract_GET_BELIEFS_BY_EPISTEMIC_STATUS: typeof GET_BELIEFS_BY_EPISTEMIC_STATUS;
116
+ declare const sdkTools_contract_GET_BELIEF_RELATIONSHIPS: typeof GET_BELIEF_RELATIONSHIPS;
117
+ declare const sdkTools_contract_GET_BELIEF_SUPPORT_CHAIN: typeof GET_BELIEF_SUPPORT_CHAIN;
118
+ declare const sdkTools_contract_GET_CAUSAL_CHAINS: typeof GET_CAUSAL_CHAINS;
119
+ declare const sdkTools_contract_GET_CHALLENGED_BELIEFS: typeof GET_CHALLENGED_BELIEFS;
120
+ declare const sdkTools_contract_GET_COLLECTION_CONVICTION: typeof GET_COLLECTION_CONVICTION;
121
+ declare const sdkTools_contract_GET_CONVICTION_TREND: typeof GET_CONVICTION_TREND;
122
+ declare const sdkTools_contract_GET_DEEP_LINEAGE: typeof GET_DEEP_LINEAGE;
123
+ declare const sdkTools_contract_GET_EVIDENCE_BY_METHODOLOGY: typeof GET_EVIDENCE_BY_METHODOLOGY;
124
+ declare const sdkTools_contract_GET_NECESSARY_EVIDENCE: typeof GET_NECESSARY_EVIDENCE;
125
+ declare const sdkTools_contract_GET_NON_CONSENSUS_BELIEFS: typeof GET_NON_CONSENSUS_BELIEFS;
126
+ declare const sdkTools_contract_GET_PREDICTIONS: typeof GET_PREDICTIONS;
127
+ declare const sdkTools_contract_GET_PRIVILEGED_EVIDENCE: typeof GET_PRIVILEGED_EVIDENCE;
128
+ declare const sdkTools_contract_GET_PRIVILEGED_SIGNALS: typeof GET_PRIVILEGED_SIGNALS;
129
+ declare const sdkTools_contract_GET_SURPRISE_DETECTION: typeof GET_SURPRISE_DETECTION;
130
+ declare const sdkTools_contract_GET_TASK_COUNTS: typeof GET_TASK_COUNTS;
131
+ declare const sdkTools_contract_GRAPH_AWARE_SEARCH: typeof GRAPH_AWARE_SEARCH;
132
+ declare const sdkTools_contract_LINK_BELIEF_TO_WORKTREE: typeof LINK_BELIEF_TO_WORKTREE;
133
+ declare const sdkTools_contract_LINK_DOCUMENT_TO_WORKTREE: typeof LINK_DOCUMENT_TO_WORKTREE;
134
+ declare const sdkTools_contract_LINK_EVIDENCE_TO_WORKTREE: typeof LINK_EVIDENCE_TO_WORKTREE;
135
+ declare const sdkTools_contract_LINK_QUESTION_TO_WORKTREE: typeof LINK_QUESTION_TO_WORKTREE;
136
+ declare const sdkTools_contract_LIST_TASKS: typeof LIST_TASKS;
137
+ declare const sdkTools_contract_REFINE_WORKTREE_BELIEF: typeof REFINE_WORKTREE_BELIEF;
138
+ declare const sdkTools_contract_SDK_ONLY_TOOL_CONTRACTS: typeof SDK_ONLY_TOOL_CONTRACTS;
139
+ declare const sdkTools_contract_SDK_ONLY_TOOL_NAMES: typeof SDK_ONLY_TOOL_NAMES;
140
+ declare const sdkTools_contract_START_WORKTREE: typeof START_WORKTREE;
141
+ type sdkTools_contract_SdkToolContract = SdkToolContract;
142
+ declare const sdkTools_contract_TRACE_PROVENANCE: typeof TRACE_PROVENANCE;
143
+ declare const sdkTools_contract_UPDATE_TASK: typeof UPDATE_TASK;
144
+ declare const sdkTools_contract_UPDATE_WORKTREE_PHASE: typeof UPDATE_WORKTREE_PHASE;
145
+ declare const sdkTools_contract_validateSdkGitSemantics: typeof validateSdkGitSemantics;
146
+ declare namespace sdkTools_contract {
147
+ export { sdkTools_contract_ADD_NOTE_TO_WORKTREE as ADD_NOTE_TO_WORKTREE, sdkTools_contract_ADD_RESEARCH_ACTION as ADD_RESEARCH_ACTION, sdkTools_contract_ADVANCE_WORKTREE_PHASE as ADVANCE_WORKTREE_PHASE, sdkTools_contract_ALL_SDK_TOOL_CONTRACTS as ALL_SDK_TOOL_CONTRACTS, sdkTools_contract_ALL_SDK_TOOL_NAMES as ALL_SDK_TOOL_NAMES, sdkTools_contract_ANALYZE_BELIEF_CLUSTER_CANDIDATES as ANALYZE_BELIEF_CLUSTER_CANDIDATES, sdkTools_contract_ANALYZE_BELIEF_CRITICALITY as ANALYZE_BELIEF_CRITICALITY, sdkTools_contract_ANALYZE_REASONING_DEPTH as ANALYZE_REASONING_DEPTH, sdkTools_contract_COMPLETE_EVIDENCE_REVIEW as COMPLETE_EVIDENCE_REVIEW, sdkTools_contract_COMPLETE_HYPOTHESIS_FORMATION as COMPLETE_HYPOTHESIS_FORMATION, sdkTools_contract_CREATE_BELIEF_CONDITIONAL as CREATE_BELIEF_CONDITIONAL, sdkTools_contract_CREATE_EVIDENCE_TASK as CREATE_EVIDENCE_TASK, sdkTools_contract_CREATE_SYNTHESIZED_BELIEF as CREATE_SYNTHESIZED_BELIEF, sdkTools_contract_DETECT_ANCHORING_BIAS as DETECT_ANCHORING_BIAS, sdkTools_contract_DETECT_SOURCE_CONCENTRATION as DETECT_SOURCE_CONCENTRATION, sdkTools_contract_EXPLORE_CONNECTIONS as EXPLORE_CONNECTIONS, sdkTools_contract_FIND_SEMANTIC_BRIDGES as FIND_SEMANTIC_BRIDGES, sdkTools_contract_FIND_SEMANTIC_ORPHANS as FIND_SEMANTIC_ORPHANS, sdkTools_contract_FIND_SOFT_CONTRADICTIONS as FIND_SOFT_CONTRADICTIONS, sdkTools_contract_GET_BELIEFS_BY_EPISTEMIC_STATUS as GET_BELIEFS_BY_EPISTEMIC_STATUS, sdkTools_contract_GET_BELIEF_RELATIONSHIPS as GET_BELIEF_RELATIONSHIPS, sdkTools_contract_GET_BELIEF_SUPPORT_CHAIN as GET_BELIEF_SUPPORT_CHAIN, sdkTools_contract_GET_CAUSAL_CHAINS as GET_CAUSAL_CHAINS, sdkTools_contract_GET_CHALLENGED_BELIEFS as GET_CHALLENGED_BELIEFS, sdkTools_contract_GET_COLLECTION_CONVICTION as GET_COLLECTION_CONVICTION, sdkTools_contract_GET_CONVICTION_TREND as GET_CONVICTION_TREND, sdkTools_contract_GET_DEEP_LINEAGE as GET_DEEP_LINEAGE, sdkTools_contract_GET_EVIDENCE_BY_METHODOLOGY as GET_EVIDENCE_BY_METHODOLOGY, sdkTools_contract_GET_NECESSARY_EVIDENCE as GET_NECESSARY_EVIDENCE, sdkTools_contract_GET_NON_CONSENSUS_BELIEFS as GET_NON_CONSENSUS_BELIEFS, sdkTools_contract_GET_PREDICTIONS as GET_PREDICTIONS, sdkTools_contract_GET_PRIVILEGED_EVIDENCE as GET_PRIVILEGED_EVIDENCE, sdkTools_contract_GET_PRIVILEGED_SIGNALS as GET_PRIVILEGED_SIGNALS, sdkTools_contract_GET_SURPRISE_DETECTION as GET_SURPRISE_DETECTION, sdkTools_contract_GET_TASK_COUNTS as GET_TASK_COUNTS, sdkTools_contract_GRAPH_AWARE_SEARCH as GRAPH_AWARE_SEARCH, sdkTools_contract_LINK_BELIEF_TO_WORKTREE as LINK_BELIEF_TO_WORKTREE, sdkTools_contract_LINK_DOCUMENT_TO_WORKTREE as LINK_DOCUMENT_TO_WORKTREE, sdkTools_contract_LINK_EVIDENCE_TO_WORKTREE as LINK_EVIDENCE_TO_WORKTREE, sdkTools_contract_LINK_QUESTION_TO_WORKTREE as LINK_QUESTION_TO_WORKTREE, sdkTools_contract_LIST_TASKS as LIST_TASKS, sdkTools_contract_REFINE_WORKTREE_BELIEF as REFINE_WORKTREE_BELIEF, sdkTools_contract_SDK_ONLY_TOOL_CONTRACTS as SDK_ONLY_TOOL_CONTRACTS, sdkTools_contract_SDK_ONLY_TOOL_NAMES as SDK_ONLY_TOOL_NAMES, sdkTools_contract_START_WORKTREE as START_WORKTREE, type sdkTools_contract_SdkToolContract as SdkToolContract, sdkTools_contract_TRACE_PROVENANCE as TRACE_PROVENANCE, sdkTools_contract_UPDATE_TASK as UPDATE_TASK, sdkTools_contract_UPDATE_WORKTREE_PHASE as UPDATE_WORKTREE_PHASE, sdkTools_contract_validateSdkGitSemantics as validateSdkGitSemantics };
148
+ }
149
+
150
+ export { ADVANCE_WORKTREE_PHASE as A, GET_CHALLENGED_BELIEFS as B, CREATE_SYNTHESIZED_BELIEF as C, GET_CAUSAL_CHAINS as D, EXPLORE_CONNECTIONS as E, GET_NON_CONSENSUS_BELIEFS as F, GET_BELIEF_RELATIONSHIPS as G, GET_BELIEFS_BY_EPISTEMIC_STATUS as H, GET_PRIVILEGED_EVIDENCE as I, GET_PRIVILEGED_SIGNALS as J, DETECT_ANCHORING_BIAS as K, LINK_DOCUMENT_TO_WORKTREE as L, DETECT_SOURCE_CONCENTRATION as M, FIND_SOFT_CONTRADICTIONS as N, FIND_SEMANTIC_BRIDGES as O, FIND_SEMANTIC_ORPHANS as P, SDK_ONLY_TOOL_CONTRACTS as Q, REFINE_WORKTREE_BELIEF as R, type SdkToolContract as S, TRACE_PROVENANCE as T, UPDATE_WORKTREE_PHASE as U, ALL_SDK_TOOL_CONTRACTS as V, SDK_ONLY_TOOL_NAMES as W, ALL_SDK_TOOL_NAMES as X, validateSdkGitSemantics as Y, START_WORKTREE as a, ADD_NOTE_TO_WORKTREE as b, LINK_EVIDENCE_TO_WORKTREE as c, LINK_QUESTION_TO_WORKTREE as d, LINK_BELIEF_TO_WORKTREE as e, COMPLETE_HYPOTHESIS_FORMATION as f, COMPLETE_EVIDENCE_REVIEW as g, GET_BELIEF_SUPPORT_CHAIN as h, GET_DEEP_LINEAGE as i, GRAPH_AWARE_SEARCH as j, GET_COLLECTION_CONVICTION as k, GET_CONVICTION_TREND as l, ANALYZE_BELIEF_CRITICALITY as m, ANALYZE_BELIEF_CLUSTER_CANDIDATES as n, CREATE_BELIEF_CONDITIONAL as o, GET_NECESSARY_EVIDENCE as p, ANALYZE_REASONING_DEPTH as q, GET_EVIDENCE_BY_METHODOLOGY as r, sdkTools_contract as s, CREATE_EVIDENCE_TASK as t, LIST_TASKS as u, UPDATE_TASK as v, GET_TASK_COUNTS as w, ADD_RESEARCH_ACTION as x, GET_PREDICTIONS as y, GET_SURPRISE_DETECTION as z };
@@ -0,0 +1,2 @@
1
+ import './mcp-tools.contract-D8kXcP6d.js';
2
+ export { b as ADD_NOTE_TO_WORKTREE, x as ADD_RESEARCH_ACTION, A as ADVANCE_WORKTREE_PHASE, V as ALL_SDK_TOOL_CONTRACTS, X as ALL_SDK_TOOL_NAMES, n as ANALYZE_BELIEF_CLUSTER_CANDIDATES, m as ANALYZE_BELIEF_CRITICALITY, q as ANALYZE_REASONING_DEPTH, g as COMPLETE_EVIDENCE_REVIEW, f as COMPLETE_HYPOTHESIS_FORMATION, o as CREATE_BELIEF_CONDITIONAL, t as CREATE_EVIDENCE_TASK, C as CREATE_SYNTHESIZED_BELIEF, K as DETECT_ANCHORING_BIAS, M as DETECT_SOURCE_CONCENTRATION, E as EXPLORE_CONNECTIONS, O as FIND_SEMANTIC_BRIDGES, P as FIND_SEMANTIC_ORPHANS, N as FIND_SOFT_CONTRADICTIONS, H as GET_BELIEFS_BY_EPISTEMIC_STATUS, G as GET_BELIEF_RELATIONSHIPS, h as GET_BELIEF_SUPPORT_CHAIN, D as GET_CAUSAL_CHAINS, B as GET_CHALLENGED_BELIEFS, k as GET_COLLECTION_CONVICTION, l as GET_CONVICTION_TREND, i as GET_DEEP_LINEAGE, r as GET_EVIDENCE_BY_METHODOLOGY, p as GET_NECESSARY_EVIDENCE, F as GET_NON_CONSENSUS_BELIEFS, y as GET_PREDICTIONS, I as GET_PRIVILEGED_EVIDENCE, J as GET_PRIVILEGED_SIGNALS, z as GET_SURPRISE_DETECTION, w as GET_TASK_COUNTS, j as GRAPH_AWARE_SEARCH, e as LINK_BELIEF_TO_WORKTREE, L as LINK_DOCUMENT_TO_WORKTREE, c as LINK_EVIDENCE_TO_WORKTREE, d as LINK_QUESTION_TO_WORKTREE, u as LIST_TASKS, R as REFINE_WORKTREE_BELIEF, Q as SDK_ONLY_TOOL_CONTRACTS, W as SDK_ONLY_TOOL_NAMES, a as START_WORKTREE, S as SdkToolContract, T as TRACE_PROVENANCE, v as UPDATE_TASK, U as UPDATE_WORKTREE_PHASE, Y as validateSdkGitSemantics } from './sdk-tools.contract-BnV0hKLp.js';