@c4a/context 0.6.18 → 0.7.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 (130) hide show
  1. package/README.md +5 -5
  2. package/README.zh-CN.md +5 -5
  3. package/codeIndexPlan.d.ts +84 -0
  4. package/contracts.d.ts +2 -1
  5. package/docs/README.md +7 -0
  6. package/docs/README.zh-CN.md +5 -0
  7. package/docs/getting-started.md +12 -12
  8. package/docs/guides/agent-guide.md +18 -9
  9. package/docs/guides/code-indexer-skill-authoring.md +124 -0
  10. package/docs/guides/indexer-provider-and-customization.md +140 -0
  11. package/docs/guides/lark-resources.md +7 -0
  12. package/docs/guides/markdown-indexer-skill-authoring.md +118 -0
  13. package/docs/guides/package-outputs.md +3 -3
  14. package/docs/reference/code-extractors.md +7 -6
  15. package/docs/reference/indexer-provider-protocol.md +819 -0
  16. package/docs/reference/package-templates.md +18 -10
  17. package/docs/reference/project-api.md +49 -24
  18. package/index.d.ts +48 -2
  19. package/index.js +28239 -3948
  20. package/indexerAgentStepProtocol.d.ts +9391 -0
  21. package/indexerArtifactDependencies.d.ts +689 -0
  22. package/indexerArtifactPolicy.d.ts +335 -0
  23. package/indexerArtifactResult.d.ts +2010 -0
  24. package/indexerAuditFacts.d.ts +66 -0
  25. package/indexerAuditOverrideReadiness.d.ts +27 -0
  26. package/indexerAuditProtocol.d.ts +238 -0
  27. package/indexerAuditRevision.d.ts +726 -0
  28. package/indexerAuditRevisionActions.d.ts +236 -0
  29. package/indexerAuthoringFixture.d.ts +152 -0
  30. package/indexerBaseQuestionAmendment.d.ts +2403 -0
  31. package/indexerBenchmark.d.ts +1062 -0
  32. package/indexerCandidateCompile.d.ts +801 -0
  33. package/indexerCapabilityGroupEvidence.d.ts +129 -0
  34. package/indexerCatalogFallback.d.ts +1262 -0
  35. package/indexerCollectionMapping.d.ts +75 -0
  36. package/indexerContentLayers.d.ts +137 -0
  37. package/indexerControlledInvocation.d.ts +512 -0
  38. package/indexerControlledProgram.d.ts +12535 -0
  39. package/indexerCoreExports.d.ts +21 -0
  40. package/indexerCustomizationDraft.d.ts +13800 -0
  41. package/indexerCustomizationLadder.d.ts +103 -0
  42. package/indexerDependencyView.d.ts +1610 -0
  43. package/indexerEvidenceAdapterResult.d.ts +504 -0
  44. package/indexerExampleDecision.d.ts +1606 -0
  45. package/indexerExampleIdentity.d.ts +132 -0
  46. package/indexerExampleIdentityAudit.d.ts +70 -0
  47. package/indexerExampleLinkageAudit.d.ts +80 -0
  48. package/indexerGeneratedAuthoringAudit.d.ts +208 -0
  49. package/indexerIncrementalImpact.d.ts +221 -0
  50. package/indexerInventoryDisposition.d.ts +443 -0
  51. package/indexerLayerComposition.d.ts +1652 -0
  52. package/indexerLayoutChange.d.ts +329 -0
  53. package/indexerLayoutProposalSet.d.ts +447 -0
  54. package/indexerLayoutResolver.d.ts +342 -0
  55. package/indexerLayoutTransition.d.ts +247 -0
  56. package/indexerLifecycle.d.ts +53 -0
  57. package/indexerMainLifecycle.d.ts +258 -0
  58. package/indexerMainRunLedger.d.ts +888 -0
  59. package/indexerMainRunProtocol.d.ts +6471 -0
  60. package/indexerMainWorkset.d.ts +2141 -0
  61. package/indexerMaterialAnswer.d.ts +738 -0
  62. package/indexerMaterialAnswerActualization.d.ts +91 -0
  63. package/indexerMaterialAnswerExecutionPlan.d.ts +2887 -0
  64. package/indexerMaterialAnswerFlow.d.ts +63 -0
  65. package/indexerMaterialAnswerLayout.d.ts +76 -0
  66. package/indexerMaterialAnswerReview.d.ts +217 -0
  67. package/indexerMaterialAnswerReviewRoute.d.ts +6145 -0
  68. package/indexerMaterialAnswerRunLedger.d.ts +918 -0
  69. package/indexerMaterialAnswerRunProtocol.d.ts +1253 -0
  70. package/indexerMaterialGapLedger.d.ts +3111 -0
  71. package/indexerMaterialQuestionExclusion.d.ts +129 -0
  72. package/indexerMaterialQuestionWorkset.d.ts +508 -0
  73. package/indexerNavigationArtifactGraph.d.ts +5 -0
  74. package/indexerNavigationArtifactPlan.d.ts +39 -0
  75. package/indexerOverlayQuestionAmendment.d.ts +2551 -0
  76. package/indexerOverlayQuestionApplyProposal.d.ts +4697 -0
  77. package/indexerOverlayTrust.d.ts +1425 -0
  78. package/indexerParserCoordinate.d.ts +222 -0
  79. package/indexerParserFactView.d.ts +503 -0
  80. package/indexerPartitionConvergence.d.ts +496 -0
  81. package/indexerPartitionPlan.d.ts +919 -0
  82. package/indexerPartitionStrategyResolution.d.ts +594 -0
  83. package/indexerPhysicalArtifactAudit.d.ts +247 -0
  84. package/indexerPhysicalArtifactManifest.d.ts +449 -0
  85. package/indexerPlannedMaterialAnswer.d.ts +116 -0
  86. package/indexerPostAuthorComposition.d.ts +2000 -0
  87. package/indexerPostAuthorRunLedger.d.ts +1972 -0
  88. package/indexerPrimaryProjection.d.ts +262 -0
  89. package/indexerProfileContract.d.ts +3034 -0
  90. package/indexerProfileMetricAudit.d.ts +218 -0
  91. package/indexerProgramExecutionAuthorization.d.ts +227 -0
  92. package/indexerProgramRunProtocol.d.ts +7642 -0
  93. package/indexerProjectProposal.d.ts +2807 -0
  94. package/indexerProjectedArtifactFanOutAudit.d.ts +159 -0
  95. package/indexerProjectedArtifactPlan.d.ts +217 -0
  96. package/indexerProtocolCommon.d.ts +29 -0
  97. package/indexerProvider.d.ts +2573 -0
  98. package/indexerProviderComposition.d.ts +1357 -0
  99. package/indexerProviderContractReferences.d.ts +13 -0
  100. package/indexerProviderProfileResolution.d.ts +20 -0
  101. package/indexerProviderResolution.d.ts +752 -0
  102. package/indexerProviderResolutionAction.d.ts +678 -0
  103. package/indexerProviderRouting.d.ts +3909 -0
  104. package/indexerProviderSelectionProposal.d.ts +3311 -0
  105. package/indexerQuestionAuthority.d.ts +419 -0
  106. package/indexerReaderTargetInventory.d.ts +161 -0
  107. package/indexerReferenceOnlyAudit.d.ts +90 -0
  108. package/indexerRegistry.d.ts +3019 -0
  109. package/indexerRequirementComparison.d.ts +44 -0
  110. package/indexerRequirementConfirmation.d.ts +1193 -0
  111. package/indexerRequirementLifecycle.d.ts +3314 -0
  112. package/indexerRestrictedSelector.d.ts +63 -0
  113. package/indexerResultReconciliation.d.ts +6844 -0
  114. package/indexerResultReconciliationRun.d.ts +15 -0
  115. package/indexerRunEnvelope.d.ts +384 -0
  116. package/indexerRunProtocolCommon.d.ts +21 -0
  117. package/indexerSharedArtifactFingerprint.d.ts +33 -0
  118. package/indexerStructuredDeclaration.d.ts +513 -0
  119. package/indexerSubjectCatalog.d.ts +230 -0
  120. package/indexerSubjectIdentity.d.ts +19 -0
  121. package/indexerSubjectKeyAuthority.d.ts +785 -0
  122. package/indexerTemplateRendering.d.ts +485 -0
  123. package/indexerToolSnapshot.d.ts +431 -0
  124. package/indexerWorksetRead.d.ts +287 -0
  125. package/package.json +1 -1
  126. package/phases.d.ts +11 -9
  127. package/templates/package-templates/kb/AGENTS.md +1 -1
  128. package/templates/package-templates/kb/skills/knowledge-query/SKILL.md +1 -1
  129. package/templates/package-templates.zh-CN/kb/AGENTS.md +1 -1
  130. package/templates/package-templates.zh-CN/kb/skills/knowledge-query/SKILL.md +1 -1
@@ -0,0 +1,918 @@
1
+ import { z } from "zod";
2
+ export declare const indexerMaterialAnswerRunLedgerEntrySchema: z.ZodDiscriminatedUnion<"state", [z.ZodObject<{
3
+ run_ref: z.ZodString;
4
+ answer_indexer_id: z.ZodEffects<z.ZodString, string, string>;
5
+ execution_request_digest: z.ZodString;
6
+ } & {
7
+ state: z.ZodLiteral<"pending">;
8
+ }, "strict", z.ZodTypeAny, {
9
+ state: "pending";
10
+ execution_request_digest: string;
11
+ answer_indexer_id: string;
12
+ run_ref: string;
13
+ }, {
14
+ state: "pending";
15
+ execution_request_digest: string;
16
+ answer_indexer_id: string;
17
+ run_ref: string;
18
+ }>, z.ZodObject<{
19
+ run_ref: z.ZodString;
20
+ answer_indexer_id: z.ZodEffects<z.ZodString, string, string>;
21
+ execution_request_digest: z.ZodString;
22
+ } & {
23
+ state: z.ZodLiteral<"running">;
24
+ attempt_digest: z.ZodString;
25
+ }, "strict", z.ZodTypeAny, {
26
+ state: "running";
27
+ execution_request_digest: string;
28
+ attempt_digest: string;
29
+ answer_indexer_id: string;
30
+ run_ref: string;
31
+ }, {
32
+ state: "running";
33
+ execution_request_digest: string;
34
+ attempt_digest: string;
35
+ answer_indexer_id: string;
36
+ run_ref: string;
37
+ }>, z.ZodObject<{
38
+ run_ref: z.ZodString;
39
+ answer_indexer_id: z.ZodEffects<z.ZodString, string, string>;
40
+ execution_request_digest: z.ZodString;
41
+ } & {
42
+ state: z.ZodLiteral<"stale">;
43
+ previous_execution_request_digest: z.ZodString;
44
+ }, "strict", z.ZodTypeAny, {
45
+ state: "stale";
46
+ execution_request_digest: string;
47
+ answer_indexer_id: string;
48
+ previous_execution_request_digest: string;
49
+ run_ref: string;
50
+ }, {
51
+ state: "stale";
52
+ execution_request_digest: string;
53
+ answer_indexer_id: string;
54
+ previous_execution_request_digest: string;
55
+ run_ref: string;
56
+ }>, z.ZodObject<{
57
+ run_ref: z.ZodString;
58
+ answer_indexer_id: z.ZodEffects<z.ZodString, string, string>;
59
+ execution_request_digest: z.ZodString;
60
+ } & {
61
+ state: z.ZodLiteral<"failed">;
62
+ failure_digest: z.ZodString;
63
+ }, "strict", z.ZodTypeAny, {
64
+ state: "failed";
65
+ execution_request_digest: string;
66
+ answer_indexer_id: string;
67
+ run_ref: string;
68
+ failure_digest: string;
69
+ }, {
70
+ state: "failed";
71
+ execution_request_digest: string;
72
+ answer_indexer_id: string;
73
+ run_ref: string;
74
+ failure_digest: string;
75
+ }>, z.ZodObject<{
76
+ run_ref: z.ZodString;
77
+ answer_indexer_id: z.ZodEffects<z.ZodString, string, string>;
78
+ execution_request_digest: z.ZodString;
79
+ } & {
80
+ state: z.ZodLiteral<"accepted">;
81
+ accepted_record_digest: z.ZodString;
82
+ result_digest: z.ZodString;
83
+ candidate_set_digest: z.ZodString;
84
+ read_receipt_set_digest: z.ZodString;
85
+ candidate_question_keys: z.ZodArray<z.ZodString, "many">;
86
+ insufficient_question_keys: z.ZodArray<z.ZodString, "many">;
87
+ }, "strict", z.ZodTypeAny, {
88
+ state: "accepted";
89
+ execution_request_digest: string;
90
+ result_digest: string;
91
+ answer_indexer_id: string;
92
+ candidate_set_digest: string;
93
+ run_ref: string;
94
+ accepted_record_digest: string;
95
+ read_receipt_set_digest: string;
96
+ candidate_question_keys: string[];
97
+ insufficient_question_keys: string[];
98
+ }, {
99
+ state: "accepted";
100
+ execution_request_digest: string;
101
+ result_digest: string;
102
+ answer_indexer_id: string;
103
+ candidate_set_digest: string;
104
+ run_ref: string;
105
+ accepted_record_digest: string;
106
+ read_receipt_set_digest: string;
107
+ candidate_question_keys: string[];
108
+ insufficient_question_keys: string[];
109
+ }>]>;
110
+ export declare const indexerMaterialAnswerRunLedgerSchema: z.ZodObject<{
111
+ protocol: z.ZodLiteral<"context.indexer.material-answer-run-ledger/v1">;
112
+ plan_digest: z.ZodString;
113
+ workset_digest: z.ZodString;
114
+ predecessor_ledger_revision: z.ZodString;
115
+ entries: z.ZodArray<z.ZodDiscriminatedUnion<"state", [z.ZodObject<{
116
+ run_ref: z.ZodString;
117
+ answer_indexer_id: z.ZodEffects<z.ZodString, string, string>;
118
+ execution_request_digest: z.ZodString;
119
+ } & {
120
+ state: z.ZodLiteral<"pending">;
121
+ }, "strict", z.ZodTypeAny, {
122
+ state: "pending";
123
+ execution_request_digest: string;
124
+ answer_indexer_id: string;
125
+ run_ref: string;
126
+ }, {
127
+ state: "pending";
128
+ execution_request_digest: string;
129
+ answer_indexer_id: string;
130
+ run_ref: string;
131
+ }>, z.ZodObject<{
132
+ run_ref: z.ZodString;
133
+ answer_indexer_id: z.ZodEffects<z.ZodString, string, string>;
134
+ execution_request_digest: z.ZodString;
135
+ } & {
136
+ state: z.ZodLiteral<"running">;
137
+ attempt_digest: z.ZodString;
138
+ }, "strict", z.ZodTypeAny, {
139
+ state: "running";
140
+ execution_request_digest: string;
141
+ attempt_digest: string;
142
+ answer_indexer_id: string;
143
+ run_ref: string;
144
+ }, {
145
+ state: "running";
146
+ execution_request_digest: string;
147
+ attempt_digest: string;
148
+ answer_indexer_id: string;
149
+ run_ref: string;
150
+ }>, z.ZodObject<{
151
+ run_ref: z.ZodString;
152
+ answer_indexer_id: z.ZodEffects<z.ZodString, string, string>;
153
+ execution_request_digest: z.ZodString;
154
+ } & {
155
+ state: z.ZodLiteral<"stale">;
156
+ previous_execution_request_digest: z.ZodString;
157
+ }, "strict", z.ZodTypeAny, {
158
+ state: "stale";
159
+ execution_request_digest: string;
160
+ answer_indexer_id: string;
161
+ previous_execution_request_digest: string;
162
+ run_ref: string;
163
+ }, {
164
+ state: "stale";
165
+ execution_request_digest: string;
166
+ answer_indexer_id: string;
167
+ previous_execution_request_digest: string;
168
+ run_ref: string;
169
+ }>, z.ZodObject<{
170
+ run_ref: z.ZodString;
171
+ answer_indexer_id: z.ZodEffects<z.ZodString, string, string>;
172
+ execution_request_digest: z.ZodString;
173
+ } & {
174
+ state: z.ZodLiteral<"failed">;
175
+ failure_digest: z.ZodString;
176
+ }, "strict", z.ZodTypeAny, {
177
+ state: "failed";
178
+ execution_request_digest: string;
179
+ answer_indexer_id: string;
180
+ run_ref: string;
181
+ failure_digest: string;
182
+ }, {
183
+ state: "failed";
184
+ execution_request_digest: string;
185
+ answer_indexer_id: string;
186
+ run_ref: string;
187
+ failure_digest: string;
188
+ }>, z.ZodObject<{
189
+ run_ref: z.ZodString;
190
+ answer_indexer_id: z.ZodEffects<z.ZodString, string, string>;
191
+ execution_request_digest: z.ZodString;
192
+ } & {
193
+ state: z.ZodLiteral<"accepted">;
194
+ accepted_record_digest: z.ZodString;
195
+ result_digest: z.ZodString;
196
+ candidate_set_digest: z.ZodString;
197
+ read_receipt_set_digest: z.ZodString;
198
+ candidate_question_keys: z.ZodArray<z.ZodString, "many">;
199
+ insufficient_question_keys: z.ZodArray<z.ZodString, "many">;
200
+ }, "strict", z.ZodTypeAny, {
201
+ state: "accepted";
202
+ execution_request_digest: string;
203
+ result_digest: string;
204
+ answer_indexer_id: string;
205
+ candidate_set_digest: string;
206
+ run_ref: string;
207
+ accepted_record_digest: string;
208
+ read_receipt_set_digest: string;
209
+ candidate_question_keys: string[];
210
+ insufficient_question_keys: string[];
211
+ }, {
212
+ state: "accepted";
213
+ execution_request_digest: string;
214
+ result_digest: string;
215
+ answer_indexer_id: string;
216
+ candidate_set_digest: string;
217
+ run_ref: string;
218
+ accepted_record_digest: string;
219
+ read_receipt_set_digest: string;
220
+ candidate_question_keys: string[];
221
+ insufficient_question_keys: string[];
222
+ }>]>, "many">;
223
+ } & {
224
+ revision: z.ZodString;
225
+ }, "strict", z.ZodTypeAny, {
226
+ entries: ({
227
+ state: "pending";
228
+ execution_request_digest: string;
229
+ answer_indexer_id: string;
230
+ run_ref: string;
231
+ } | {
232
+ state: "running";
233
+ execution_request_digest: string;
234
+ attempt_digest: string;
235
+ answer_indexer_id: string;
236
+ run_ref: string;
237
+ } | {
238
+ state: "stale";
239
+ execution_request_digest: string;
240
+ answer_indexer_id: string;
241
+ previous_execution_request_digest: string;
242
+ run_ref: string;
243
+ } | {
244
+ state: "failed";
245
+ execution_request_digest: string;
246
+ answer_indexer_id: string;
247
+ run_ref: string;
248
+ failure_digest: string;
249
+ } | {
250
+ state: "accepted";
251
+ execution_request_digest: string;
252
+ result_digest: string;
253
+ answer_indexer_id: string;
254
+ candidate_set_digest: string;
255
+ run_ref: string;
256
+ accepted_record_digest: string;
257
+ read_receipt_set_digest: string;
258
+ candidate_question_keys: string[];
259
+ insufficient_question_keys: string[];
260
+ })[];
261
+ protocol: "context.indexer.material-answer-run-ledger/v1";
262
+ workset_digest: string;
263
+ predecessor_ledger_revision: string;
264
+ plan_digest: string;
265
+ revision: string;
266
+ }, {
267
+ entries: ({
268
+ state: "pending";
269
+ execution_request_digest: string;
270
+ answer_indexer_id: string;
271
+ run_ref: string;
272
+ } | {
273
+ state: "running";
274
+ execution_request_digest: string;
275
+ attempt_digest: string;
276
+ answer_indexer_id: string;
277
+ run_ref: string;
278
+ } | {
279
+ state: "stale";
280
+ execution_request_digest: string;
281
+ answer_indexer_id: string;
282
+ previous_execution_request_digest: string;
283
+ run_ref: string;
284
+ } | {
285
+ state: "failed";
286
+ execution_request_digest: string;
287
+ answer_indexer_id: string;
288
+ run_ref: string;
289
+ failure_digest: string;
290
+ } | {
291
+ state: "accepted";
292
+ execution_request_digest: string;
293
+ result_digest: string;
294
+ answer_indexer_id: string;
295
+ candidate_set_digest: string;
296
+ run_ref: string;
297
+ accepted_record_digest: string;
298
+ read_receipt_set_digest: string;
299
+ candidate_question_keys: string[];
300
+ insufficient_question_keys: string[];
301
+ })[];
302
+ protocol: "context.indexer.material-answer-run-ledger/v1";
303
+ workset_digest: string;
304
+ predecessor_ledger_revision: string;
305
+ plan_digest: string;
306
+ revision: string;
307
+ }>;
308
+ export declare const indexerMaterialAnswerAcceptedRunRecordSchema: z.ZodObject<{
309
+ protocol: z.ZodLiteral<"context.indexer.material-answer-accepted-run/v1">;
310
+ plan_digest: z.ZodString;
311
+ run_ref: z.ZodString;
312
+ workset_digest: z.ZodString;
313
+ answer_indexer_id: z.ZodEffects<z.ZodString, string, string>;
314
+ execution_request_digest: z.ZodString;
315
+ run_result: z.ZodObject<{
316
+ protocol: z.ZodLiteral<"context.indexer.run-result/v1">;
317
+ operation: z.ZodLiteral<"material-answer">;
318
+ consumed_input_view_digest: z.ZodString;
319
+ result: z.ZodObject<{
320
+ protocol: z.ZodLiteral<"context.indexer.material-answer-result/v1">;
321
+ workset_digest: z.ZodString;
322
+ execution_request_digest: z.ZodString;
323
+ answer_indexer_id: z.ZodEffects<z.ZodString, string, string>;
324
+ answer_provider_composition_fingerprint: z.ZodString;
325
+ bindings: z.ZodArray<z.ZodObject<{
326
+ workset_digest: z.ZodString;
327
+ question_key: z.ZodString;
328
+ question_revision_digest: z.ZodString;
329
+ evidence_claims: z.ZodArray<z.ZodObject<{
330
+ kind: z.ZodEnum<["code", "contract", "configuration", "documentation", "runbook", "decision-record", "test-result", "runtime-observation", "tool-snapshot"]>;
331
+ source_ref: z.ZodString;
332
+ source_spans: z.ZodArray<z.ZodEffects<z.ZodObject<{
333
+ unit: z.ZodEnum<["byte", "line"]>;
334
+ start: z.ZodNumber;
335
+ end_exclusive: z.ZodNumber;
336
+ }, "strict", z.ZodTypeAny, {
337
+ unit: "byte" | "line";
338
+ start: number;
339
+ end_exclusive: number;
340
+ }, {
341
+ unit: "byte" | "line";
342
+ start: number;
343
+ end_exclusive: number;
344
+ }>, {
345
+ unit: "byte" | "line";
346
+ start: number;
347
+ end_exclusive: number;
348
+ }, {
349
+ unit: "byte" | "line";
350
+ start: number;
351
+ end_exclusive: number;
352
+ }>, "many">;
353
+ evidence_digest: z.ZodString;
354
+ }, "strict", z.ZodTypeAny, {
355
+ kind: "contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot";
356
+ source_ref: string;
357
+ evidence_digest: string;
358
+ source_spans: {
359
+ unit: "byte" | "line";
360
+ start: number;
361
+ end_exclusive: number;
362
+ }[];
363
+ }, {
364
+ kind: "contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot";
365
+ source_ref: string;
366
+ evidence_digest: string;
367
+ source_spans: {
368
+ unit: "byte" | "line";
369
+ start: number;
370
+ end_exclusive: number;
371
+ }[];
372
+ }>, "many">;
373
+ }, "strict", z.ZodTypeAny, {
374
+ workset_digest: string;
375
+ question_key: string;
376
+ question_revision_digest: string;
377
+ evidence_claims: {
378
+ kind: "contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot";
379
+ source_ref: string;
380
+ evidence_digest: string;
381
+ source_spans: {
382
+ unit: "byte" | "line";
383
+ start: number;
384
+ end_exclusive: number;
385
+ }[];
386
+ }[];
387
+ }, {
388
+ workset_digest: string;
389
+ question_key: string;
390
+ question_revision_digest: string;
391
+ evidence_claims: {
392
+ kind: "contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot";
393
+ source_ref: string;
394
+ evidence_digest: string;
395
+ source_spans: {
396
+ unit: "byte" | "line";
397
+ start: number;
398
+ end_exclusive: number;
399
+ }[];
400
+ }[];
401
+ }>, "many">;
402
+ result_digest: z.ZodString;
403
+ }, "strict", z.ZodTypeAny, {
404
+ protocol: "context.indexer.material-answer-result/v1";
405
+ workset_digest: string;
406
+ execution_request_digest: string;
407
+ result_digest: string;
408
+ answer_indexer_id: string;
409
+ answer_provider_composition_fingerprint: string;
410
+ bindings: {
411
+ workset_digest: string;
412
+ question_key: string;
413
+ question_revision_digest: string;
414
+ evidence_claims: {
415
+ kind: "contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot";
416
+ source_ref: string;
417
+ evidence_digest: string;
418
+ source_spans: {
419
+ unit: "byte" | "line";
420
+ start: number;
421
+ end_exclusive: number;
422
+ }[];
423
+ }[];
424
+ }[];
425
+ }, {
426
+ protocol: "context.indexer.material-answer-result/v1";
427
+ workset_digest: string;
428
+ execution_request_digest: string;
429
+ result_digest: string;
430
+ answer_indexer_id: string;
431
+ answer_provider_composition_fingerprint: string;
432
+ bindings: {
433
+ workset_digest: string;
434
+ question_key: string;
435
+ question_revision_digest: string;
436
+ evidence_claims: {
437
+ kind: "contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot";
438
+ source_ref: string;
439
+ evidence_digest: string;
440
+ source_spans: {
441
+ unit: "byte" | "line";
442
+ start: number;
443
+ end_exclusive: number;
444
+ }[];
445
+ }[];
446
+ }[];
447
+ }>;
448
+ }, "strict", z.ZodTypeAny, {
449
+ operation: "material-answer";
450
+ protocol: "context.indexer.run-result/v1";
451
+ result: {
452
+ protocol: "context.indexer.material-answer-result/v1";
453
+ workset_digest: string;
454
+ execution_request_digest: string;
455
+ result_digest: string;
456
+ answer_indexer_id: string;
457
+ answer_provider_composition_fingerprint: string;
458
+ bindings: {
459
+ workset_digest: string;
460
+ question_key: string;
461
+ question_revision_digest: string;
462
+ evidence_claims: {
463
+ kind: "contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot";
464
+ source_ref: string;
465
+ evidence_digest: string;
466
+ source_spans: {
467
+ unit: "byte" | "line";
468
+ start: number;
469
+ end_exclusive: number;
470
+ }[];
471
+ }[];
472
+ }[];
473
+ };
474
+ consumed_input_view_digest: string;
475
+ }, {
476
+ operation: "material-answer";
477
+ protocol: "context.indexer.run-result/v1";
478
+ result: {
479
+ protocol: "context.indexer.material-answer-result/v1";
480
+ workset_digest: string;
481
+ execution_request_digest: string;
482
+ result_digest: string;
483
+ answer_indexer_id: string;
484
+ answer_provider_composition_fingerprint: string;
485
+ bindings: {
486
+ workset_digest: string;
487
+ question_key: string;
488
+ question_revision_digest: string;
489
+ evidence_claims: {
490
+ kind: "contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot";
491
+ source_ref: string;
492
+ evidence_digest: string;
493
+ source_spans: {
494
+ unit: "byte" | "line";
495
+ start: number;
496
+ end_exclusive: number;
497
+ }[];
498
+ }[];
499
+ }[];
500
+ };
501
+ consumed_input_view_digest: string;
502
+ }>;
503
+ candidate_set: z.ZodObject<{
504
+ protocol: z.ZodLiteral<"context.indexer.material-answer-candidate-set/v1">;
505
+ candidate_set_digest: z.ZodString;
506
+ workset_digest: z.ZodString;
507
+ answer_result_digest: z.ZodString;
508
+ answer_indexer_id: z.ZodEffects<z.ZodString, string, string>;
509
+ answer_provider_composition_fingerprint: z.ZodString;
510
+ evaluations: z.ZodArray<z.ZodUnion<[z.ZodObject<{
511
+ state: z.ZodLiteral<"candidate">;
512
+ question_key: z.ZodString;
513
+ question_revision_digest: z.ZodString;
514
+ binding_digest: z.ZodString;
515
+ evidence_item_count: z.ZodNumber;
516
+ distinct_source_count: z.ZodNumber;
517
+ evidence: z.ZodArray<z.ZodObject<{
518
+ evidence_item_ref: z.ZodString;
519
+ kind: z.ZodEnum<["code", "contract", "configuration", "documentation", "runbook", "decision-record", "test-result", "runtime-observation", "tool-snapshot"]>;
520
+ source_ref: z.ZodString;
521
+ source_origin_ref: z.ZodString;
522
+ source_input_digest: z.ZodString;
523
+ source_spans: z.ZodArray<z.ZodEffects<z.ZodObject<{
524
+ unit: z.ZodEnum<["byte", "line"]>;
525
+ start: z.ZodNumber;
526
+ end_exclusive: z.ZodNumber;
527
+ }, "strict", z.ZodTypeAny, {
528
+ unit: "byte" | "line";
529
+ start: number;
530
+ end_exclusive: number;
531
+ }, {
532
+ unit: "byte" | "line";
533
+ start: number;
534
+ end_exclusive: number;
535
+ }>, {
536
+ unit: "byte" | "line";
537
+ start: number;
538
+ end_exclusive: number;
539
+ }, {
540
+ unit: "byte" | "line";
541
+ start: number;
542
+ end_exclusive: number;
543
+ }>, "many">;
544
+ evidence_digest: z.ZodString;
545
+ }, "strict", z.ZodTypeAny, {
546
+ kind: "contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot";
547
+ source_ref: string;
548
+ evidence_digest: string;
549
+ source_input_digest: string;
550
+ source_spans: {
551
+ unit: "byte" | "line";
552
+ start: number;
553
+ end_exclusive: number;
554
+ }[];
555
+ source_origin_ref: string;
556
+ evidence_item_ref: string;
557
+ }, {
558
+ kind: "contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot";
559
+ source_ref: string;
560
+ evidence_digest: string;
561
+ source_input_digest: string;
562
+ source_spans: {
563
+ unit: "byte" | "line";
564
+ start: number;
565
+ end_exclusive: number;
566
+ }[];
567
+ source_origin_ref: string;
568
+ evidence_item_ref: string;
569
+ }>, "many">;
570
+ }, "strict", z.ZodTypeAny, {
571
+ state: "candidate";
572
+ binding_digest: string;
573
+ evidence: {
574
+ kind: "contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot";
575
+ source_ref: string;
576
+ evidence_digest: string;
577
+ source_input_digest: string;
578
+ source_spans: {
579
+ unit: "byte" | "line";
580
+ start: number;
581
+ end_exclusive: number;
582
+ }[];
583
+ source_origin_ref: string;
584
+ evidence_item_ref: string;
585
+ }[];
586
+ question_key: string;
587
+ question_revision_digest: string;
588
+ evidence_item_count: number;
589
+ distinct_source_count: number;
590
+ }, {
591
+ state: "candidate";
592
+ binding_digest: string;
593
+ evidence: {
594
+ kind: "contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot";
595
+ source_ref: string;
596
+ evidence_digest: string;
597
+ source_input_digest: string;
598
+ source_spans: {
599
+ unit: "byte" | "line";
600
+ start: number;
601
+ end_exclusive: number;
602
+ }[];
603
+ source_origin_ref: string;
604
+ evidence_item_ref: string;
605
+ }[];
606
+ question_key: string;
607
+ question_revision_digest: string;
608
+ evidence_item_count: number;
609
+ distinct_source_count: number;
610
+ }>, z.ZodObject<{
611
+ state: z.ZodLiteral<"material-answer-evidence-insufficient">;
612
+ question_key: z.ZodString;
613
+ question_revision_digest: z.ZodString;
614
+ reason_codes: z.ZodArray<z.ZodEnum<["minimum-items-not-met", "minimum-distinct-sources-not-met", "provenance-constraint-not-met"]>, "many">;
615
+ accepted_evidence_item_count: z.ZodNumber;
616
+ distinct_source_count: z.ZodNumber;
617
+ rejected_evidence_item_refs: z.ZodArray<z.ZodString, "many">;
618
+ }, "strict", z.ZodTypeAny, {
619
+ state: "material-answer-evidence-insufficient";
620
+ question_key: string;
621
+ question_revision_digest: string;
622
+ distinct_source_count: number;
623
+ reason_codes: ("minimum-items-not-met" | "minimum-distinct-sources-not-met" | "provenance-constraint-not-met")[];
624
+ accepted_evidence_item_count: number;
625
+ rejected_evidence_item_refs: string[];
626
+ }, {
627
+ state: "material-answer-evidence-insufficient";
628
+ question_key: string;
629
+ question_revision_digest: string;
630
+ distinct_source_count: number;
631
+ reason_codes: ("minimum-items-not-met" | "minimum-distinct-sources-not-met" | "provenance-constraint-not-met")[];
632
+ accepted_evidence_item_count: number;
633
+ rejected_evidence_item_refs: string[];
634
+ }>]>, "many">;
635
+ }, "strict", z.ZodTypeAny, {
636
+ protocol: "context.indexer.material-answer-candidate-set/v1";
637
+ workset_digest: string;
638
+ answer_indexer_id: string;
639
+ answer_provider_composition_fingerprint: string;
640
+ candidate_set_digest: string;
641
+ answer_result_digest: string;
642
+ evaluations: ({
643
+ state: "candidate";
644
+ binding_digest: string;
645
+ evidence: {
646
+ kind: "contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot";
647
+ source_ref: string;
648
+ evidence_digest: string;
649
+ source_input_digest: string;
650
+ source_spans: {
651
+ unit: "byte" | "line";
652
+ start: number;
653
+ end_exclusive: number;
654
+ }[];
655
+ source_origin_ref: string;
656
+ evidence_item_ref: string;
657
+ }[];
658
+ question_key: string;
659
+ question_revision_digest: string;
660
+ evidence_item_count: number;
661
+ distinct_source_count: number;
662
+ } | {
663
+ state: "material-answer-evidence-insufficient";
664
+ question_key: string;
665
+ question_revision_digest: string;
666
+ distinct_source_count: number;
667
+ reason_codes: ("minimum-items-not-met" | "minimum-distinct-sources-not-met" | "provenance-constraint-not-met")[];
668
+ accepted_evidence_item_count: number;
669
+ rejected_evidence_item_refs: string[];
670
+ })[];
671
+ }, {
672
+ protocol: "context.indexer.material-answer-candidate-set/v1";
673
+ workset_digest: string;
674
+ answer_indexer_id: string;
675
+ answer_provider_composition_fingerprint: string;
676
+ candidate_set_digest: string;
677
+ answer_result_digest: string;
678
+ evaluations: ({
679
+ state: "candidate";
680
+ binding_digest: string;
681
+ evidence: {
682
+ kind: "contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot";
683
+ source_ref: string;
684
+ evidence_digest: string;
685
+ source_input_digest: string;
686
+ source_spans: {
687
+ unit: "byte" | "line";
688
+ start: number;
689
+ end_exclusive: number;
690
+ }[];
691
+ source_origin_ref: string;
692
+ evidence_item_ref: string;
693
+ }[];
694
+ question_key: string;
695
+ question_revision_digest: string;
696
+ evidence_item_count: number;
697
+ distinct_source_count: number;
698
+ } | {
699
+ state: "material-answer-evidence-insufficient";
700
+ question_key: string;
701
+ question_revision_digest: string;
702
+ distinct_source_count: number;
703
+ reason_codes: ("minimum-items-not-met" | "minimum-distinct-sources-not-met" | "provenance-constraint-not-met")[];
704
+ accepted_evidence_item_count: number;
705
+ rejected_evidence_item_refs: string[];
706
+ })[];
707
+ }>;
708
+ read_receipt_set_digest: z.ZodString;
709
+ } & {
710
+ record_digest: z.ZodString;
711
+ }, "strict", z.ZodTypeAny, {
712
+ protocol: "context.indexer.material-answer-accepted-run/v1";
713
+ workset_digest: string;
714
+ execution_request_digest: string;
715
+ answer_indexer_id: string;
716
+ plan_digest: string;
717
+ run_result: {
718
+ operation: "material-answer";
719
+ protocol: "context.indexer.run-result/v1";
720
+ result: {
721
+ protocol: "context.indexer.material-answer-result/v1";
722
+ workset_digest: string;
723
+ execution_request_digest: string;
724
+ result_digest: string;
725
+ answer_indexer_id: string;
726
+ answer_provider_composition_fingerprint: string;
727
+ bindings: {
728
+ workset_digest: string;
729
+ question_key: string;
730
+ question_revision_digest: string;
731
+ evidence_claims: {
732
+ kind: "contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot";
733
+ source_ref: string;
734
+ evidence_digest: string;
735
+ source_spans: {
736
+ unit: "byte" | "line";
737
+ start: number;
738
+ end_exclusive: number;
739
+ }[];
740
+ }[];
741
+ }[];
742
+ };
743
+ consumed_input_view_digest: string;
744
+ };
745
+ candidate_set: {
746
+ protocol: "context.indexer.material-answer-candidate-set/v1";
747
+ workset_digest: string;
748
+ answer_indexer_id: string;
749
+ answer_provider_composition_fingerprint: string;
750
+ candidate_set_digest: string;
751
+ answer_result_digest: string;
752
+ evaluations: ({
753
+ state: "candidate";
754
+ binding_digest: string;
755
+ evidence: {
756
+ kind: "contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot";
757
+ source_ref: string;
758
+ evidence_digest: string;
759
+ source_input_digest: string;
760
+ source_spans: {
761
+ unit: "byte" | "line";
762
+ start: number;
763
+ end_exclusive: number;
764
+ }[];
765
+ source_origin_ref: string;
766
+ evidence_item_ref: string;
767
+ }[];
768
+ question_key: string;
769
+ question_revision_digest: string;
770
+ evidence_item_count: number;
771
+ distinct_source_count: number;
772
+ } | {
773
+ state: "material-answer-evidence-insufficient";
774
+ question_key: string;
775
+ question_revision_digest: string;
776
+ distinct_source_count: number;
777
+ reason_codes: ("minimum-items-not-met" | "minimum-distinct-sources-not-met" | "provenance-constraint-not-met")[];
778
+ accepted_evidence_item_count: number;
779
+ rejected_evidence_item_refs: string[];
780
+ })[];
781
+ };
782
+ run_ref: string;
783
+ read_receipt_set_digest: string;
784
+ record_digest: string;
785
+ }, {
786
+ protocol: "context.indexer.material-answer-accepted-run/v1";
787
+ workset_digest: string;
788
+ execution_request_digest: string;
789
+ answer_indexer_id: string;
790
+ plan_digest: string;
791
+ run_result: {
792
+ operation: "material-answer";
793
+ protocol: "context.indexer.run-result/v1";
794
+ result: {
795
+ protocol: "context.indexer.material-answer-result/v1";
796
+ workset_digest: string;
797
+ execution_request_digest: string;
798
+ result_digest: string;
799
+ answer_indexer_id: string;
800
+ answer_provider_composition_fingerprint: string;
801
+ bindings: {
802
+ workset_digest: string;
803
+ question_key: string;
804
+ question_revision_digest: string;
805
+ evidence_claims: {
806
+ kind: "contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot";
807
+ source_ref: string;
808
+ evidence_digest: string;
809
+ source_spans: {
810
+ unit: "byte" | "line";
811
+ start: number;
812
+ end_exclusive: number;
813
+ }[];
814
+ }[];
815
+ }[];
816
+ };
817
+ consumed_input_view_digest: string;
818
+ };
819
+ candidate_set: {
820
+ protocol: "context.indexer.material-answer-candidate-set/v1";
821
+ workset_digest: string;
822
+ answer_indexer_id: string;
823
+ answer_provider_composition_fingerprint: string;
824
+ candidate_set_digest: string;
825
+ answer_result_digest: string;
826
+ evaluations: ({
827
+ state: "candidate";
828
+ binding_digest: string;
829
+ evidence: {
830
+ kind: "contract" | "code" | "configuration" | "documentation" | "runbook" | "decision-record" | "test-result" | "runtime-observation" | "tool-snapshot";
831
+ source_ref: string;
832
+ evidence_digest: string;
833
+ source_input_digest: string;
834
+ source_spans: {
835
+ unit: "byte" | "line";
836
+ start: number;
837
+ end_exclusive: number;
838
+ }[];
839
+ source_origin_ref: string;
840
+ evidence_item_ref: string;
841
+ }[];
842
+ question_key: string;
843
+ question_revision_digest: string;
844
+ evidence_item_count: number;
845
+ distinct_source_count: number;
846
+ } | {
847
+ state: "material-answer-evidence-insufficient";
848
+ question_key: string;
849
+ question_revision_digest: string;
850
+ distinct_source_count: number;
851
+ reason_codes: ("minimum-items-not-met" | "minimum-distinct-sources-not-met" | "provenance-constraint-not-met")[];
852
+ accepted_evidence_item_count: number;
853
+ rejected_evidence_item_refs: string[];
854
+ })[];
855
+ };
856
+ run_ref: string;
857
+ read_receipt_set_digest: string;
858
+ record_digest: string;
859
+ }>;
860
+ export type IndexerMaterialAnswerRunLedgerEntry = z.infer<typeof indexerMaterialAnswerRunLedgerEntrySchema>;
861
+ export type IndexerMaterialAnswerRunLedger = z.infer<typeof indexerMaterialAnswerRunLedgerSchema>;
862
+ export type IndexerMaterialAnswerAcceptedRunRecord = z.infer<typeof indexerMaterialAnswerAcceptedRunRecordSchema>;
863
+ export declare function buildIndexerMaterialAnswerAcceptedRunRecord(input: {
864
+ plan: unknown;
865
+ run_ref: string;
866
+ run_result: unknown;
867
+ candidate_set: unknown;
868
+ read_receipt_set_digest: string;
869
+ }): IndexerMaterialAnswerAcceptedRunRecord;
870
+ export declare function validateIndexerMaterialAnswerAcceptedRunRecord(input: {
871
+ plan: unknown;
872
+ record: unknown;
873
+ }): IndexerMaterialAnswerAcceptedRunRecord;
874
+ export declare function prepareIndexerMaterialAnswerRunLedger(input: {
875
+ plan: unknown;
876
+ previous_ledger?: unknown;
877
+ accepted_records?: readonly unknown[];
878
+ }): IndexerMaterialAnswerRunLedger;
879
+ export declare function validateIndexerMaterialAnswerRunLedger(value: unknown): IndexerMaterialAnswerRunLedger;
880
+ export declare function startIndexerMaterialAnswerRun(input: {
881
+ plan: unknown;
882
+ ledger: unknown;
883
+ expected_revision: string;
884
+ run_ref: string;
885
+ }): IndexerMaterialAnswerRunLedger;
886
+ export declare function acceptIndexerMaterialAnswerRun(input: {
887
+ plan: unknown;
888
+ ledger: unknown;
889
+ expected_revision: string;
890
+ record: unknown;
891
+ }): IndexerMaterialAnswerRunLedger;
892
+ export declare function failIndexerMaterialAnswerRun(input: {
893
+ plan: unknown;
894
+ ledger: unknown;
895
+ expected_revision: string;
896
+ run_ref: string;
897
+ failure_digest: string;
898
+ }): IndexerMaterialAnswerRunLedger;
899
+ export declare function observeIndexerMaterialAnswerRuns(input: {
900
+ plan: unknown;
901
+ ledger: unknown;
902
+ }): {
903
+ protocol: "context.indexer.material-answer-run-observation/v1";
904
+ plan_digest: string;
905
+ ledger_revision: string;
906
+ total: number;
907
+ pending: number;
908
+ running: number;
909
+ accepted: number;
910
+ failed: number;
911
+ stale: number;
912
+ next_refs: string[];
913
+ candidate_question_keys: string[];
914
+ unresolved_question_keys: string[];
915
+ accepted_record_set_digest: string;
916
+ state: "complete" | "material-required" | "failed" | "pending" | "candidates-ready";
917
+ graph_outcome: "partial" | "failed" | "completed" | "blocked" | "unverified";
918
+ };