@c4a/context 0.7.1 → 0.7.4

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 (117) hide show
  1. package/README.md +65 -170
  2. package/README.zh-CN.md +52 -129
  3. package/docs/README.md +9 -10
  4. package/docs/README.zh-CN.md +6 -7
  5. package/docs/getting-started.md +73 -428
  6. package/docs/guides/agent-guide.md +94 -518
  7. package/docs/guides/code-indexer-skill-authoring.md +24 -13
  8. package/docs/guides/markdown-indexer-skill-authoring.md +14 -14
  9. package/docs/reference/code-extractors.md +29 -121
  10. package/docs/reference/indexer-provider-protocol.md +43 -110
  11. package/docs/reference/package-templates.md +2 -3
  12. package/docs/reference/project-api.md +52 -986
  13. package/index.d.ts +10 -8
  14. package/index.js +4739 -7103
  15. package/indexerAgentStepProtocol.d.ts +1366 -7649
  16. package/indexerArtifact.d.ts +225 -0
  17. package/indexerArtifactDependencies.d.ts +41 -39
  18. package/indexerArtifactResult.d.ts +219 -252
  19. package/indexerAuthorizedWorksetView.d.ts +368 -0
  20. package/indexerBaseQuestionAmendment.d.ts +484 -280
  21. package/indexerBenchmark.d.ts +16 -16
  22. package/indexerCandidateCompile.d.ts +66 -60
  23. package/indexerCapabilityGroupEvidence.d.ts +6 -6
  24. package/indexerCatalogFallback.d.ts +122 -128
  25. package/indexerCollectionMapping.d.ts +13 -13
  26. package/indexerContentLayers.d.ts +8 -8
  27. package/indexerContractOverlay.d.ts +10 -10
  28. package/indexerControlledInvocation.d.ts +12 -12
  29. package/indexerControlledProgram.d.ts +2467 -2797
  30. package/indexerCoreExports.d.ts +6 -6
  31. package/indexerCustomizationDraft.d.ts +3315 -2091
  32. package/indexerCustomizationLadder.d.ts +2 -2
  33. package/indexerDependencyView.d.ts +108 -108
  34. package/indexerEffectiveArtifact.d.ts +1134 -0
  35. package/indexerEvidenceAdapterAuthorityMerge.d.ts +48 -0
  36. package/indexerEvidenceAdapterResult.d.ts +52 -52
  37. package/indexerExampleDecision.d.ts +128 -128
  38. package/indexerExampleIdentity.d.ts +6 -6
  39. package/indexerGeneratedAuthoringAudit.d.ts +18 -18
  40. package/indexerIncrementalImpact.d.ts +16 -16
  41. package/indexerInspectorWorksetProjection.d.ts +6 -0
  42. package/indexerInventoryDisposition.d.ts +70 -70
  43. package/indexerLayerComposition.d.ts +2139 -373
  44. package/indexerLayoutChange.d.ts +10 -10
  45. package/indexerLayoutProposalSet.d.ts +71 -66
  46. package/indexerLayoutResolver.d.ts +53 -48
  47. package/indexerLayoutTransition.d.ts +0 -50
  48. package/indexerLifecycle.d.ts +0 -13
  49. package/indexerMainLifecycle.d.ts +10 -0
  50. package/indexerMainRunLedger.d.ts +138 -11
  51. package/indexerMainRunProtocol.d.ts +1406 -785
  52. package/indexerMainWorkset.d.ts +460 -206
  53. package/indexerMaterialGapLedger.d.ts +13 -2904
  54. package/indexerOverlayQuestionAmendment.d.ts +491 -287
  55. package/indexerOverlayQuestionApplyProposal.d.ts +1022 -614
  56. package/indexerParserCapabilityCatalog.d.ts +136 -0
  57. package/indexerParserCoordinate.d.ts +16 -16
  58. package/indexerParserDependencyIntent.d.ts +22 -0
  59. package/indexerParserExecutionPlan.d.ts +388 -0
  60. package/indexerParserFactView.d.ts +42 -22
  61. package/indexerPartitionConvergence.d.ts +0 -3
  62. package/indexerPartitionInventory.d.ts +2 -0
  63. package/indexerPartitionPlan.d.ts +101 -99
  64. package/indexerPhysicalArtifactManifest.d.ts +8 -8
  65. package/indexerPostAuthorComposition.d.ts +116 -1156
  66. package/indexerPostAuthorRunLedger.d.ts +1434 -280
  67. package/indexerPrimaryProjection.d.ts +10 -10
  68. package/indexerPrimaryResultView.d.ts +435 -0
  69. package/indexerProfileContract.d.ts +181 -181
  70. package/indexerProgramExecutionAuthorization.d.ts +12 -12
  71. package/indexerProgramRunProtocol.d.ts +2141 -2749
  72. package/indexerProjectProposal.d.ts +496 -292
  73. package/indexerProjectedArtifactFanOutAudit.d.ts +0 -3
  74. package/indexerProtocolCommon.d.ts +4 -1
  75. package/indexerProvider.d.ts +134 -218
  76. package/indexerProviderComposition.d.ts +53 -53
  77. package/indexerProviderResolution.d.ts +12 -12
  78. package/indexerProviderResolutionAction.d.ts +14 -14
  79. package/indexerProviderRouting.d.ts +923 -515
  80. package/indexerProviderSelectionProposal.d.ts +893 -485
  81. package/indexerQuestionAuthority.d.ts +46 -47
  82. package/indexerReaderTargetInventory.d.ts +8 -8
  83. package/indexerRegistry.d.ts +765 -357
  84. package/indexerRequirementConfirmation.d.ts +98 -98
  85. package/indexerRequirementLifecycle.d.ts +224 -224
  86. package/indexerResultReconciliation.d.ts +204 -5919
  87. package/indexerResultReconciliationRun.d.ts +0 -1
  88. package/indexerRunEnvelope.d.ts +20 -20
  89. package/indexerSemanticInput.d.ts +3678 -0
  90. package/indexerStructuredDeclaration.d.ts +57 -53
  91. package/indexerSubjectCatalog.d.ts +14 -14
  92. package/indexerSubjectIdentity.d.ts +2 -2
  93. package/indexerSubjectKeyAuthority.d.ts +31 -30
  94. package/indexerTemplateRendering.d.ts +64 -64
  95. package/indexerToolSnapshot.d.ts +8 -8
  96. package/package.json +1 -1
  97. package/phases.d.ts +3 -183
  98. package/codeIndexPlan.d.ts +0 -158
  99. package/indexerAuditFacts.d.ts +0 -66
  100. package/indexerAuditOverrideReadiness.d.ts +0 -27
  101. package/indexerAuditProtocol.d.ts +0 -238
  102. package/indexerAuditRevision.d.ts +0 -726
  103. package/indexerAuditRevisionActions.d.ts +0 -236
  104. package/indexerMaterialAnswer.d.ts +0 -738
  105. package/indexerMaterialAnswerActualization.d.ts +0 -91
  106. package/indexerMaterialAnswerExecutionPlan.d.ts +0 -2887
  107. package/indexerMaterialAnswerFlow.d.ts +0 -63
  108. package/indexerMaterialAnswerLayout.d.ts +0 -76
  109. package/indexerMaterialAnswerReview.d.ts +0 -217
  110. package/indexerMaterialAnswerReviewRoute.d.ts +0 -6145
  111. package/indexerMaterialAnswerRunLedger.d.ts +0 -918
  112. package/indexerMaterialAnswerRunProtocol.d.ts +0 -1253
  113. package/indexerMaterialQuestionExclusion.d.ts +0 -129
  114. package/indexerMaterialQuestionWorkset.d.ts +0 -508
  115. package/indexerPlannedMaterialAnswer.d.ts +0 -116
  116. package/indexerProfileMetricAudit.d.ts +0 -218
  117. package/indexerWorksetRead.d.ts +0 -287
@@ -1,918 +0,0 @@
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
- };