@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,785 @@
1
+ import { z } from "zod";
2
+ import { type IndexerSubjectKeyContract } from "./indexerProfileContract.js";
3
+ import type { IndexerProviderManifest } from "./indexerProvider.js";
4
+ import { type IndexerSubjectKey } from "./indexerSubjectIdentity.js";
5
+ export declare const indexerResolvedSubjectKeySchema: z.ZodObject<{
6
+ protocol: z.ZodLiteral<"context.indexer.resolved-subject-key-schema/v1">;
7
+ indexer_id: z.ZodEffects<z.ZodString, string, string>;
8
+ profile: z.ZodEffects<z.ZodString, string, string>;
9
+ authority: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
10
+ kind: z.ZodLiteral<"community-base">;
11
+ profile_contract_version: z.ZodString;
12
+ profile_contract_digest: z.ZodString;
13
+ }, "strict", z.ZodTypeAny, {
14
+ kind: "community-base";
15
+ profile_contract_digest: string;
16
+ profile_contract_version: string;
17
+ }, {
18
+ kind: "community-base";
19
+ profile_contract_digest: string;
20
+ profile_contract_version: string;
21
+ }>, z.ZodObject<{
22
+ kind: z.ZodLiteral<"provider-extension">;
23
+ extends: z.ZodEffects<z.ZodString, string, string>;
24
+ provider_layer_id: z.ZodEffects<z.ZodString, string, string>;
25
+ provider_id: z.ZodEffects<z.ZodString, string, string>;
26
+ provider_version: z.ZodString;
27
+ provider_integrity: z.ZodString;
28
+ manifest_digest: z.ZodString;
29
+ }, "strict", z.ZodTypeAny, {
30
+ kind: "provider-extension";
31
+ extends: string;
32
+ provider_id: string;
33
+ manifest_digest: string;
34
+ provider_integrity: string;
35
+ provider_version: string;
36
+ provider_layer_id: string;
37
+ }, {
38
+ kind: "provider-extension";
39
+ extends: string;
40
+ provider_id: string;
41
+ manifest_digest: string;
42
+ provider_integrity: string;
43
+ provider_version: string;
44
+ provider_layer_id: string;
45
+ }>]>;
46
+ schema: z.ZodEffects<z.ZodObject<{
47
+ version: z.ZodNumber;
48
+ namespace: z.ZodObject<{
49
+ operator: z.ZodEnum<["canonical-source-module-namespace", "canonical-service-namespace", "canonical-module-identity", "canonical-export-family"]>;
50
+ }, "strict", z.ZodTypeAny, {
51
+ operator: "canonical-source-module-namespace" | "canonical-service-namespace" | "canonical-module-identity" | "canonical-export-family";
52
+ }, {
53
+ operator: "canonical-source-module-namespace" | "canonical-service-namespace" | "canonical-module-identity" | "canonical-export-family";
54
+ }>;
55
+ kinds: z.ZodArray<z.ZodObject<{
56
+ id: z.ZodEffects<z.ZodString, string, string>;
57
+ local_key: z.ZodObject<{
58
+ operator: z.ZodEnum<["canonical-source-module-namespace", "canonical-service-namespace", "canonical-module-identity", "canonical-export-family"]>;
59
+ }, "strict", z.ZodTypeAny, {
60
+ operator: "canonical-source-module-namespace" | "canonical-service-namespace" | "canonical-module-identity" | "canonical-export-family";
61
+ }, {
62
+ operator: "canonical-source-module-namespace" | "canonical-service-namespace" | "canonical-module-identity" | "canonical-export-family";
63
+ }>;
64
+ }, "strict", z.ZodTypeAny, {
65
+ id: string;
66
+ local_key: {
67
+ operator: "canonical-source-module-namespace" | "canonical-service-namespace" | "canonical-module-identity" | "canonical-export-family";
68
+ };
69
+ }, {
70
+ id: string;
71
+ local_key: {
72
+ operator: "canonical-source-module-namespace" | "canonical-service-namespace" | "canonical-module-identity" | "canonical-export-family";
73
+ };
74
+ }>, "many">;
75
+ normalization: z.ZodOptional<z.ZodArray<z.ZodEnum<["trim", "unicode-nfc", "preserve-case", "lowercase"]>, "many">>;
76
+ }, "strict", z.ZodTypeAny, {
77
+ namespace: {
78
+ operator: "canonical-source-module-namespace" | "canonical-service-namespace" | "canonical-module-identity" | "canonical-export-family";
79
+ };
80
+ version: number;
81
+ kinds: {
82
+ id: string;
83
+ local_key: {
84
+ operator: "canonical-source-module-namespace" | "canonical-service-namespace" | "canonical-module-identity" | "canonical-export-family";
85
+ };
86
+ }[];
87
+ normalization?: ("trim" | "unicode-nfc" | "preserve-case" | "lowercase")[] | undefined;
88
+ }, {
89
+ namespace: {
90
+ operator: "canonical-source-module-namespace" | "canonical-service-namespace" | "canonical-module-identity" | "canonical-export-family";
91
+ };
92
+ version: number;
93
+ kinds: {
94
+ id: string;
95
+ local_key: {
96
+ operator: "canonical-source-module-namespace" | "canonical-service-namespace" | "canonical-module-identity" | "canonical-export-family";
97
+ };
98
+ }[];
99
+ normalization?: ("trim" | "unicode-nfc" | "preserve-case" | "lowercase")[] | undefined;
100
+ }>, {
101
+ namespace: {
102
+ operator: "canonical-source-module-namespace" | "canonical-service-namespace" | "canonical-module-identity" | "canonical-export-family";
103
+ };
104
+ version: number;
105
+ kinds: {
106
+ id: string;
107
+ local_key: {
108
+ operator: "canonical-source-module-namespace" | "canonical-service-namespace" | "canonical-module-identity" | "canonical-export-family";
109
+ };
110
+ }[];
111
+ normalization?: ("trim" | "unicode-nfc" | "preserve-case" | "lowercase")[] | undefined;
112
+ }, {
113
+ namespace: {
114
+ operator: "canonical-source-module-namespace" | "canonical-service-namespace" | "canonical-module-identity" | "canonical-export-family";
115
+ };
116
+ version: number;
117
+ kinds: {
118
+ id: string;
119
+ local_key: {
120
+ operator: "canonical-source-module-namespace" | "canonical-service-namespace" | "canonical-module-identity" | "canonical-export-family";
121
+ };
122
+ }[];
123
+ normalization?: ("trim" | "unicode-nfc" | "preserve-case" | "lowercase")[] | undefined;
124
+ }>;
125
+ schema_digest: z.ZodString;
126
+ resolved_digest: z.ZodString;
127
+ }, "strict", z.ZodTypeAny, {
128
+ protocol: "context.indexer.resolved-subject-key-schema/v1";
129
+ authority: {
130
+ kind: "community-base";
131
+ profile_contract_digest: string;
132
+ profile_contract_version: string;
133
+ } | {
134
+ kind: "provider-extension";
135
+ extends: string;
136
+ provider_id: string;
137
+ manifest_digest: string;
138
+ provider_integrity: string;
139
+ provider_version: string;
140
+ provider_layer_id: string;
141
+ };
142
+ profile: string;
143
+ indexer_id: string;
144
+ resolved_digest: string;
145
+ schema: {
146
+ namespace: {
147
+ operator: "canonical-source-module-namespace" | "canonical-service-namespace" | "canonical-module-identity" | "canonical-export-family";
148
+ };
149
+ version: number;
150
+ kinds: {
151
+ id: string;
152
+ local_key: {
153
+ operator: "canonical-source-module-namespace" | "canonical-service-namespace" | "canonical-module-identity" | "canonical-export-family";
154
+ };
155
+ }[];
156
+ normalization?: ("trim" | "unicode-nfc" | "preserve-case" | "lowercase")[] | undefined;
157
+ };
158
+ schema_digest: string;
159
+ }, {
160
+ protocol: "context.indexer.resolved-subject-key-schema/v1";
161
+ authority: {
162
+ kind: "community-base";
163
+ profile_contract_digest: string;
164
+ profile_contract_version: string;
165
+ } | {
166
+ kind: "provider-extension";
167
+ extends: string;
168
+ provider_id: string;
169
+ manifest_digest: string;
170
+ provider_integrity: string;
171
+ provider_version: string;
172
+ provider_layer_id: string;
173
+ };
174
+ profile: string;
175
+ indexer_id: string;
176
+ resolved_digest: string;
177
+ schema: {
178
+ namespace: {
179
+ operator: "canonical-source-module-namespace" | "canonical-service-namespace" | "canonical-module-identity" | "canonical-export-family";
180
+ };
181
+ version: number;
182
+ kinds: {
183
+ id: string;
184
+ local_key: {
185
+ operator: "canonical-source-module-namespace" | "canonical-service-namespace" | "canonical-module-identity" | "canonical-export-family";
186
+ };
187
+ }[];
188
+ normalization?: ("trim" | "unicode-nfc" | "preserve-case" | "lowercase")[] | undefined;
189
+ };
190
+ schema_digest: string;
191
+ }>;
192
+ export type IndexerResolvedSubjectKeySchema = z.infer<typeof indexerResolvedSubjectKeySchema>;
193
+ export declare const indexerResolvedSubjectKeySchemaSetSchema: z.ZodEffects<z.ZodObject<{
194
+ protocol: z.ZodLiteral<"context.indexer.resolved-subject-key-schema-set/v1">;
195
+ schemas: z.ZodArray<z.ZodObject<{
196
+ protocol: z.ZodLiteral<"context.indexer.resolved-subject-key-schema/v1">;
197
+ indexer_id: z.ZodEffects<z.ZodString, string, string>;
198
+ profile: z.ZodEffects<z.ZodString, string, string>;
199
+ authority: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
200
+ kind: z.ZodLiteral<"community-base">;
201
+ profile_contract_version: z.ZodString;
202
+ profile_contract_digest: z.ZodString;
203
+ }, "strict", z.ZodTypeAny, {
204
+ kind: "community-base";
205
+ profile_contract_digest: string;
206
+ profile_contract_version: string;
207
+ }, {
208
+ kind: "community-base";
209
+ profile_contract_digest: string;
210
+ profile_contract_version: string;
211
+ }>, z.ZodObject<{
212
+ kind: z.ZodLiteral<"provider-extension">;
213
+ extends: z.ZodEffects<z.ZodString, string, string>;
214
+ provider_layer_id: z.ZodEffects<z.ZodString, string, string>;
215
+ provider_id: z.ZodEffects<z.ZodString, string, string>;
216
+ provider_version: z.ZodString;
217
+ provider_integrity: z.ZodString;
218
+ manifest_digest: z.ZodString;
219
+ }, "strict", z.ZodTypeAny, {
220
+ kind: "provider-extension";
221
+ extends: string;
222
+ provider_id: string;
223
+ manifest_digest: string;
224
+ provider_integrity: string;
225
+ provider_version: string;
226
+ provider_layer_id: string;
227
+ }, {
228
+ kind: "provider-extension";
229
+ extends: string;
230
+ provider_id: string;
231
+ manifest_digest: string;
232
+ provider_integrity: string;
233
+ provider_version: string;
234
+ provider_layer_id: string;
235
+ }>]>;
236
+ schema: z.ZodEffects<z.ZodObject<{
237
+ version: z.ZodNumber;
238
+ namespace: z.ZodObject<{
239
+ operator: z.ZodEnum<["canonical-source-module-namespace", "canonical-service-namespace", "canonical-module-identity", "canonical-export-family"]>;
240
+ }, "strict", z.ZodTypeAny, {
241
+ operator: "canonical-source-module-namespace" | "canonical-service-namespace" | "canonical-module-identity" | "canonical-export-family";
242
+ }, {
243
+ operator: "canonical-source-module-namespace" | "canonical-service-namespace" | "canonical-module-identity" | "canonical-export-family";
244
+ }>;
245
+ kinds: z.ZodArray<z.ZodObject<{
246
+ id: z.ZodEffects<z.ZodString, string, string>;
247
+ local_key: z.ZodObject<{
248
+ operator: z.ZodEnum<["canonical-source-module-namespace", "canonical-service-namespace", "canonical-module-identity", "canonical-export-family"]>;
249
+ }, "strict", z.ZodTypeAny, {
250
+ operator: "canonical-source-module-namespace" | "canonical-service-namespace" | "canonical-module-identity" | "canonical-export-family";
251
+ }, {
252
+ operator: "canonical-source-module-namespace" | "canonical-service-namespace" | "canonical-module-identity" | "canonical-export-family";
253
+ }>;
254
+ }, "strict", z.ZodTypeAny, {
255
+ id: string;
256
+ local_key: {
257
+ operator: "canonical-source-module-namespace" | "canonical-service-namespace" | "canonical-module-identity" | "canonical-export-family";
258
+ };
259
+ }, {
260
+ id: string;
261
+ local_key: {
262
+ operator: "canonical-source-module-namespace" | "canonical-service-namespace" | "canonical-module-identity" | "canonical-export-family";
263
+ };
264
+ }>, "many">;
265
+ normalization: z.ZodOptional<z.ZodArray<z.ZodEnum<["trim", "unicode-nfc", "preserve-case", "lowercase"]>, "many">>;
266
+ }, "strict", z.ZodTypeAny, {
267
+ namespace: {
268
+ operator: "canonical-source-module-namespace" | "canonical-service-namespace" | "canonical-module-identity" | "canonical-export-family";
269
+ };
270
+ version: number;
271
+ kinds: {
272
+ id: string;
273
+ local_key: {
274
+ operator: "canonical-source-module-namespace" | "canonical-service-namespace" | "canonical-module-identity" | "canonical-export-family";
275
+ };
276
+ }[];
277
+ normalization?: ("trim" | "unicode-nfc" | "preserve-case" | "lowercase")[] | undefined;
278
+ }, {
279
+ namespace: {
280
+ operator: "canonical-source-module-namespace" | "canonical-service-namespace" | "canonical-module-identity" | "canonical-export-family";
281
+ };
282
+ version: number;
283
+ kinds: {
284
+ id: string;
285
+ local_key: {
286
+ operator: "canonical-source-module-namespace" | "canonical-service-namespace" | "canonical-module-identity" | "canonical-export-family";
287
+ };
288
+ }[];
289
+ normalization?: ("trim" | "unicode-nfc" | "preserve-case" | "lowercase")[] | undefined;
290
+ }>, {
291
+ namespace: {
292
+ operator: "canonical-source-module-namespace" | "canonical-service-namespace" | "canonical-module-identity" | "canonical-export-family";
293
+ };
294
+ version: number;
295
+ kinds: {
296
+ id: string;
297
+ local_key: {
298
+ operator: "canonical-source-module-namespace" | "canonical-service-namespace" | "canonical-module-identity" | "canonical-export-family";
299
+ };
300
+ }[];
301
+ normalization?: ("trim" | "unicode-nfc" | "preserve-case" | "lowercase")[] | undefined;
302
+ }, {
303
+ namespace: {
304
+ operator: "canonical-source-module-namespace" | "canonical-service-namespace" | "canonical-module-identity" | "canonical-export-family";
305
+ };
306
+ version: number;
307
+ kinds: {
308
+ id: string;
309
+ local_key: {
310
+ operator: "canonical-source-module-namespace" | "canonical-service-namespace" | "canonical-module-identity" | "canonical-export-family";
311
+ };
312
+ }[];
313
+ normalization?: ("trim" | "unicode-nfc" | "preserve-case" | "lowercase")[] | undefined;
314
+ }>;
315
+ schema_digest: z.ZodString;
316
+ resolved_digest: z.ZodString;
317
+ }, "strict", z.ZodTypeAny, {
318
+ protocol: "context.indexer.resolved-subject-key-schema/v1";
319
+ authority: {
320
+ kind: "community-base";
321
+ profile_contract_digest: string;
322
+ profile_contract_version: string;
323
+ } | {
324
+ kind: "provider-extension";
325
+ extends: string;
326
+ provider_id: string;
327
+ manifest_digest: string;
328
+ provider_integrity: string;
329
+ provider_version: string;
330
+ provider_layer_id: string;
331
+ };
332
+ profile: string;
333
+ indexer_id: string;
334
+ resolved_digest: string;
335
+ schema: {
336
+ namespace: {
337
+ operator: "canonical-source-module-namespace" | "canonical-service-namespace" | "canonical-module-identity" | "canonical-export-family";
338
+ };
339
+ version: number;
340
+ kinds: {
341
+ id: string;
342
+ local_key: {
343
+ operator: "canonical-source-module-namespace" | "canonical-service-namespace" | "canonical-module-identity" | "canonical-export-family";
344
+ };
345
+ }[];
346
+ normalization?: ("trim" | "unicode-nfc" | "preserve-case" | "lowercase")[] | undefined;
347
+ };
348
+ schema_digest: string;
349
+ }, {
350
+ protocol: "context.indexer.resolved-subject-key-schema/v1";
351
+ authority: {
352
+ kind: "community-base";
353
+ profile_contract_digest: string;
354
+ profile_contract_version: string;
355
+ } | {
356
+ kind: "provider-extension";
357
+ extends: string;
358
+ provider_id: string;
359
+ manifest_digest: string;
360
+ provider_integrity: string;
361
+ provider_version: string;
362
+ provider_layer_id: string;
363
+ };
364
+ profile: string;
365
+ indexer_id: string;
366
+ resolved_digest: string;
367
+ schema: {
368
+ namespace: {
369
+ operator: "canonical-source-module-namespace" | "canonical-service-namespace" | "canonical-module-identity" | "canonical-export-family";
370
+ };
371
+ version: number;
372
+ kinds: {
373
+ id: string;
374
+ local_key: {
375
+ operator: "canonical-source-module-namespace" | "canonical-service-namespace" | "canonical-module-identity" | "canonical-export-family";
376
+ };
377
+ }[];
378
+ normalization?: ("trim" | "unicode-nfc" | "preserve-case" | "lowercase")[] | undefined;
379
+ };
380
+ schema_digest: string;
381
+ }>, "many">;
382
+ set_digest: z.ZodString;
383
+ }, "strict", z.ZodTypeAny, {
384
+ protocol: "context.indexer.resolved-subject-key-schema-set/v1";
385
+ set_digest: string;
386
+ schemas: {
387
+ protocol: "context.indexer.resolved-subject-key-schema/v1";
388
+ authority: {
389
+ kind: "community-base";
390
+ profile_contract_digest: string;
391
+ profile_contract_version: string;
392
+ } | {
393
+ kind: "provider-extension";
394
+ extends: string;
395
+ provider_id: string;
396
+ manifest_digest: string;
397
+ provider_integrity: string;
398
+ provider_version: string;
399
+ provider_layer_id: string;
400
+ };
401
+ profile: string;
402
+ indexer_id: string;
403
+ resolved_digest: string;
404
+ schema: {
405
+ namespace: {
406
+ operator: "canonical-source-module-namespace" | "canonical-service-namespace" | "canonical-module-identity" | "canonical-export-family";
407
+ };
408
+ version: number;
409
+ kinds: {
410
+ id: string;
411
+ local_key: {
412
+ operator: "canonical-source-module-namespace" | "canonical-service-namespace" | "canonical-module-identity" | "canonical-export-family";
413
+ };
414
+ }[];
415
+ normalization?: ("trim" | "unicode-nfc" | "preserve-case" | "lowercase")[] | undefined;
416
+ };
417
+ schema_digest: string;
418
+ }[];
419
+ }, {
420
+ protocol: "context.indexer.resolved-subject-key-schema-set/v1";
421
+ set_digest: string;
422
+ schemas: {
423
+ protocol: "context.indexer.resolved-subject-key-schema/v1";
424
+ authority: {
425
+ kind: "community-base";
426
+ profile_contract_digest: string;
427
+ profile_contract_version: string;
428
+ } | {
429
+ kind: "provider-extension";
430
+ extends: string;
431
+ provider_id: string;
432
+ manifest_digest: string;
433
+ provider_integrity: string;
434
+ provider_version: string;
435
+ provider_layer_id: string;
436
+ };
437
+ profile: string;
438
+ indexer_id: string;
439
+ resolved_digest: string;
440
+ schema: {
441
+ namespace: {
442
+ operator: "canonical-source-module-namespace" | "canonical-service-namespace" | "canonical-module-identity" | "canonical-export-family";
443
+ };
444
+ version: number;
445
+ kinds: {
446
+ id: string;
447
+ local_key: {
448
+ operator: "canonical-source-module-namespace" | "canonical-service-namespace" | "canonical-module-identity" | "canonical-export-family";
449
+ };
450
+ }[];
451
+ normalization?: ("trim" | "unicode-nfc" | "preserve-case" | "lowercase")[] | undefined;
452
+ };
453
+ schema_digest: string;
454
+ }[];
455
+ }>, {
456
+ protocol: "context.indexer.resolved-subject-key-schema-set/v1";
457
+ set_digest: string;
458
+ schemas: {
459
+ protocol: "context.indexer.resolved-subject-key-schema/v1";
460
+ authority: {
461
+ kind: "community-base";
462
+ profile_contract_digest: string;
463
+ profile_contract_version: string;
464
+ } | {
465
+ kind: "provider-extension";
466
+ extends: string;
467
+ provider_id: string;
468
+ manifest_digest: string;
469
+ provider_integrity: string;
470
+ provider_version: string;
471
+ provider_layer_id: string;
472
+ };
473
+ profile: string;
474
+ indexer_id: string;
475
+ resolved_digest: string;
476
+ schema: {
477
+ namespace: {
478
+ operator: "canonical-source-module-namespace" | "canonical-service-namespace" | "canonical-module-identity" | "canonical-export-family";
479
+ };
480
+ version: number;
481
+ kinds: {
482
+ id: string;
483
+ local_key: {
484
+ operator: "canonical-source-module-namespace" | "canonical-service-namespace" | "canonical-module-identity" | "canonical-export-family";
485
+ };
486
+ }[];
487
+ normalization?: ("trim" | "unicode-nfc" | "preserve-case" | "lowercase")[] | undefined;
488
+ };
489
+ schema_digest: string;
490
+ }[];
491
+ }, {
492
+ protocol: "context.indexer.resolved-subject-key-schema-set/v1";
493
+ set_digest: string;
494
+ schemas: {
495
+ protocol: "context.indexer.resolved-subject-key-schema/v1";
496
+ authority: {
497
+ kind: "community-base";
498
+ profile_contract_digest: string;
499
+ profile_contract_version: string;
500
+ } | {
501
+ kind: "provider-extension";
502
+ extends: string;
503
+ provider_id: string;
504
+ manifest_digest: string;
505
+ provider_integrity: string;
506
+ provider_version: string;
507
+ provider_layer_id: string;
508
+ };
509
+ profile: string;
510
+ indexer_id: string;
511
+ resolved_digest: string;
512
+ schema: {
513
+ namespace: {
514
+ operator: "canonical-source-module-namespace" | "canonical-service-namespace" | "canonical-module-identity" | "canonical-export-family";
515
+ };
516
+ version: number;
517
+ kinds: {
518
+ id: string;
519
+ local_key: {
520
+ operator: "canonical-source-module-namespace" | "canonical-service-namespace" | "canonical-module-identity" | "canonical-export-family";
521
+ };
522
+ }[];
523
+ normalization?: ("trim" | "unicode-nfc" | "preserve-case" | "lowercase")[] | undefined;
524
+ };
525
+ schema_digest: string;
526
+ }[];
527
+ }>;
528
+ export type IndexerResolvedSubjectKeySchemaSet = z.infer<typeof indexerResolvedSubjectKeySchemaSetSchema>;
529
+ export interface IndexerSubjectKeyProfileSelection {
530
+ indexer_id: string;
531
+ profile: string;
532
+ role: "primary" | "supporting" | "extension";
533
+ provider_layer_id: string;
534
+ }
535
+ export interface IndexerSubjectKeyProviderAuthority {
536
+ indexer_id: string;
537
+ provider_layer_id: string;
538
+ provider_integrity: string;
539
+ manifest_digest: string;
540
+ manifest: IndexerProviderManifest;
541
+ }
542
+ export declare function indexerSubjectKeySchemaDigest(profile: string, schema: IndexerSubjectKeyContract): string;
543
+ export declare function indexerResolvedSubjectKeySchemaDigest(value: Omit<IndexerResolvedSubjectKeySchema, "resolved_digest">): string;
544
+ export declare function validateIndexerResolvedSubjectKeySchemaSet(value: unknown): IndexerResolvedSubjectKeySchemaSet;
545
+ export declare function requireIndexerSubjectKeySchemaBinding(input: {
546
+ schema_set: unknown;
547
+ indexer_id: string;
548
+ profile: string;
549
+ schema_digest: string;
550
+ }): IndexerResolvedSubjectKeySchema;
551
+ export declare function resolveIndexerSubjectKeySchemas(input: {
552
+ profile_contract: unknown;
553
+ operator_contract: unknown;
554
+ selections: readonly IndexerSubjectKeyProfileSelection[];
555
+ providers: readonly IndexerSubjectKeyProviderAuthority[];
556
+ }): IndexerResolvedSubjectKeySchemaSet;
557
+ export declare function validateIndexerSubjectKeyForSchema(value: unknown, resolvedValue: unknown): IndexerSubjectKey;
558
+ export declare const indexerSubjectReidentificationReportSchema: z.ZodObject<{
559
+ protocol: z.ZodLiteral<"context.indexer.subject-reidentification-report/v1">;
560
+ profile: z.ZodEffects<z.ZodString, string, string>;
561
+ old_schema_digest: z.ZodString;
562
+ new_schema_digest: z.ZodString;
563
+ old_authority_version: z.ZodString;
564
+ new_authority_version: z.ZodString;
565
+ classification: z.ZodEnum<["equivalent", "compatible", "identity-breaking"]>;
566
+ approved_catalog_digest: z.ZodString;
567
+ affected_node_refs: z.ZodArray<z.ZodString, "many">;
568
+ mappings: z.ZodArray<z.ZodObject<{
569
+ old_node_ref: z.ZodString;
570
+ new_node_ref: z.ZodString;
571
+ new_subject_key: z.ZodObject<{
572
+ protocol: z.ZodLiteral<"context.subject-key/v1">;
573
+ namespace: z.ZodEffects<z.ZodString, string, string>;
574
+ kind: z.ZodEffects<z.ZodString, string, string>;
575
+ local_key: z.ZodEffects<z.ZodString, string, string>;
576
+ }, "strict", z.ZodTypeAny, {
577
+ kind: string;
578
+ protocol: "context.subject-key/v1";
579
+ namespace: string;
580
+ local_key: string;
581
+ }, {
582
+ kind: string;
583
+ protocol: "context.subject-key/v1";
584
+ namespace: string;
585
+ local_key: string;
586
+ }>;
587
+ }, "strict", z.ZodTypeAny, {
588
+ old_node_ref: string;
589
+ new_subject_key: {
590
+ kind: string;
591
+ protocol: "context.subject-key/v1";
592
+ namespace: string;
593
+ local_key: string;
594
+ };
595
+ new_node_ref: string;
596
+ }, {
597
+ old_node_ref: string;
598
+ new_subject_key: {
599
+ kind: string;
600
+ protocol: "context.subject-key/v1";
601
+ namespace: string;
602
+ local_key: string;
603
+ };
604
+ new_node_ref: string;
605
+ }>, "many">;
606
+ missing_node_refs: z.ZodArray<z.ZodString, "many">;
607
+ splits: z.ZodArray<z.ZodObject<{
608
+ old_node_ref: z.ZodString;
609
+ new_node_refs: z.ZodArray<z.ZodString, "many">;
610
+ }, "strict", z.ZodTypeAny, {
611
+ old_node_ref: string;
612
+ new_node_refs: string[];
613
+ }, {
614
+ old_node_ref: string;
615
+ new_node_refs: string[];
616
+ }>, "many">;
617
+ merges: z.ZodArray<z.ZodObject<{
618
+ new_node_ref: z.ZodString;
619
+ old_node_refs: z.ZodArray<z.ZodString, "many">;
620
+ }, "strict", z.ZodTypeAny, {
621
+ new_node_ref: string;
622
+ old_node_refs: string[];
623
+ }, {
624
+ new_node_ref: string;
625
+ old_node_refs: string[];
626
+ }>, "many">;
627
+ collisions: z.ZodArray<z.ZodObject<{
628
+ new_node_ref: z.ZodString;
629
+ old_node_refs: z.ZodArray<z.ZodString, "many">;
630
+ }, "strict", z.ZodTypeAny, {
631
+ new_node_ref: string;
632
+ old_node_refs: string[];
633
+ }, {
634
+ new_node_ref: string;
635
+ old_node_refs: string[];
636
+ }>, "many">;
637
+ issues: z.ZodArray<z.ZodEnum<["schema-version-not-increased", "authority-major-not-increased", "missing-mapping", "unknown-mapping-source", "ambiguous-mapping", "collision"]>, "many">;
638
+ mapping_digest: z.ZodString;
639
+ gate_required: z.ZodBoolean;
640
+ activation_allowed: z.ZodBoolean;
641
+ report_digest: z.ZodString;
642
+ }, "strict", z.ZodTypeAny, {
643
+ protocol: "context.indexer.subject-reidentification-report/v1";
644
+ issues: ("schema-version-not-increased" | "authority-major-not-increased" | "missing-mapping" | "unknown-mapping-source" | "ambiguous-mapping" | "collision")[];
645
+ profile: string;
646
+ mapping_digest: string;
647
+ report_digest: string;
648
+ classification: "compatible" | "equivalent" | "identity-breaking";
649
+ old_schema_digest: string;
650
+ new_schema_digest: string;
651
+ old_authority_version: string;
652
+ new_authority_version: string;
653
+ approved_catalog_digest: string;
654
+ affected_node_refs: string[];
655
+ mappings: {
656
+ old_node_ref: string;
657
+ new_subject_key: {
658
+ kind: string;
659
+ protocol: "context.subject-key/v1";
660
+ namespace: string;
661
+ local_key: string;
662
+ };
663
+ new_node_ref: string;
664
+ }[];
665
+ missing_node_refs: string[];
666
+ splits: {
667
+ old_node_ref: string;
668
+ new_node_refs: string[];
669
+ }[];
670
+ merges: {
671
+ new_node_ref: string;
672
+ old_node_refs: string[];
673
+ }[];
674
+ collisions: {
675
+ new_node_ref: string;
676
+ old_node_refs: string[];
677
+ }[];
678
+ gate_required: boolean;
679
+ activation_allowed: boolean;
680
+ }, {
681
+ protocol: "context.indexer.subject-reidentification-report/v1";
682
+ issues: ("schema-version-not-increased" | "authority-major-not-increased" | "missing-mapping" | "unknown-mapping-source" | "ambiguous-mapping" | "collision")[];
683
+ profile: string;
684
+ mapping_digest: string;
685
+ report_digest: string;
686
+ classification: "compatible" | "equivalent" | "identity-breaking";
687
+ old_schema_digest: string;
688
+ new_schema_digest: string;
689
+ old_authority_version: string;
690
+ new_authority_version: string;
691
+ approved_catalog_digest: string;
692
+ affected_node_refs: string[];
693
+ mappings: {
694
+ old_node_ref: string;
695
+ new_subject_key: {
696
+ kind: string;
697
+ protocol: "context.subject-key/v1";
698
+ namespace: string;
699
+ local_key: string;
700
+ };
701
+ new_node_ref: string;
702
+ }[];
703
+ missing_node_refs: string[];
704
+ splits: {
705
+ old_node_ref: string;
706
+ new_node_refs: string[];
707
+ }[];
708
+ merges: {
709
+ new_node_ref: string;
710
+ old_node_refs: string[];
711
+ }[];
712
+ collisions: {
713
+ new_node_ref: string;
714
+ old_node_refs: string[];
715
+ }[];
716
+ gate_required: boolean;
717
+ activation_allowed: boolean;
718
+ }>;
719
+ export type IndexerSubjectReidentificationReport = z.infer<typeof indexerSubjectReidentificationReportSchema>;
720
+ export declare function analyzeIndexerSubjectKeySchemaTransition(input: {
721
+ old_schema: unknown;
722
+ new_schema: unknown;
723
+ approved_subjects: readonly unknown[];
724
+ proposed_mappings: readonly unknown[];
725
+ }): IndexerSubjectReidentificationReport;
726
+ export declare const indexerSubjectReidentificationAuthorizationSchema: z.ZodObject<{
727
+ protocol: z.ZodLiteral<"context.indexer.subject-reidentification-authorization/v1">;
728
+ action: z.ZodLiteral<"confirm-subject-reidentification">;
729
+ project_ref: z.ZodString;
730
+ profile: z.ZodEffects<z.ZodString, string, string>;
731
+ old_schema_digest: z.ZodString;
732
+ new_schema_digest: z.ZodString;
733
+ approved_catalog_digest: z.ZodString;
734
+ mapping_digest: z.ZodString;
735
+ report_digest: z.ZodString;
736
+ non_delegable: z.ZodLiteral<true>;
737
+ authorized_by: z.ZodString;
738
+ authorized_at: z.ZodString;
739
+ authorization_digest: z.ZodString;
740
+ }, "strict", z.ZodTypeAny, {
741
+ protocol: "context.indexer.subject-reidentification-authorization/v1";
742
+ profile: string;
743
+ mapping_digest: string;
744
+ project_ref: string;
745
+ report_digest: string;
746
+ non_delegable: true;
747
+ old_schema_digest: string;
748
+ new_schema_digest: string;
749
+ approved_catalog_digest: string;
750
+ action: "confirm-subject-reidentification";
751
+ authorized_by: string;
752
+ authorized_at: string;
753
+ authorization_digest: string;
754
+ }, {
755
+ protocol: "context.indexer.subject-reidentification-authorization/v1";
756
+ profile: string;
757
+ mapping_digest: string;
758
+ project_ref: string;
759
+ report_digest: string;
760
+ non_delegable: true;
761
+ old_schema_digest: string;
762
+ new_schema_digest: string;
763
+ approved_catalog_digest: string;
764
+ action: "confirm-subject-reidentification";
765
+ authorized_by: string;
766
+ authorized_at: string;
767
+ authorization_digest: string;
768
+ }>;
769
+ export type IndexerSubjectReidentificationAuthorization = z.infer<typeof indexerSubjectReidentificationAuthorizationSchema>;
770
+ export declare function indexerSubjectReidentificationAuthorizationDigest(value: Omit<IndexerSubjectReidentificationAuthorization, "authorization_digest">): string;
771
+ export declare function authorizeIndexerSubjectReidentification(input: {
772
+ report: IndexerSubjectReidentificationReport;
773
+ project_ref: string;
774
+ authorized_by: string;
775
+ authorized_at: string;
776
+ }): IndexerSubjectReidentificationAuthorization;
777
+ export declare function enforceIndexerSubjectKeySchemaTransition(input: {
778
+ report: unknown;
779
+ old_schema: unknown;
780
+ new_schema: unknown;
781
+ approved_subjects: readonly unknown[];
782
+ proposed_mappings: readonly unknown[];
783
+ project_ref: string;
784
+ authorization?: unknown;
785
+ }): IndexerSubjectReidentificationReport;