@c4a/context 0.7.5 → 0.7.9

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 (98) hide show
  1. package/README.md +12 -4
  2. package/README.zh-CN.md +11 -4
  3. package/docs/README.md +13 -1
  4. package/docs/README.zh-CN.md +13 -1
  5. package/docs/getting-started.md +95 -69
  6. package/docs/guides/agent-dialogue.md +20 -9
  7. package/docs/guides/agent-guide.md +48 -10
  8. package/docs/guides/code-indexer-skill-authoring.md +42 -11
  9. package/docs/guides/indexer-manifest-example.md +103 -0
  10. package/docs/guides/indexer-provider-and-customization.md +334 -15
  11. package/docs/guides/indexer-skill-creation.md +99 -0
  12. package/docs/guides/knowledge-updates.md +422 -0
  13. package/docs/guides/lark-resources.md +5 -1
  14. package/docs/guides/markdown-indexer-skill-authoring.md +16 -7
  15. package/docs/guides/note.md +37 -0
  16. package/docs/guides/package-outputs.md +231 -60
  17. package/docs/guides/sessions.md +50 -0
  18. package/docs/guides/workspace-commit.md +45 -0
  19. package/docs/guides/workspace-prepare.md +72 -0
  20. package/docs/guides/workspace-restore.md +59 -0
  21. package/docs/reference/code-extractors.md +23 -11
  22. package/docs/reference/indexer-provider-protocol.md +135 -22
  23. package/docs/reference/package-templates.md +10 -9
  24. package/docs/reference/project-api.md +100 -13
  25. package/docs/reference/template-variables.md +7 -7
  26. package/index.d.ts +15 -0
  27. package/index.js +1708 -626
  28. package/indexerAgentStepProtocol.d.ts +44 -0
  29. package/indexerApprovedKnowledge.d.ts +371 -0
  30. package/indexerArticlePlan.d.ts +83 -0
  31. package/indexerArtifact.d.ts +10 -7
  32. package/indexerArtifactDependencies.d.ts +5 -5
  33. package/indexerArtifactPolicy.d.ts +12 -12
  34. package/indexerArtifactResult.d.ts +76 -69
  35. package/indexerAuthoringFixture.d.ts +8 -8
  36. package/indexerAuthorizedWorksetView.d.ts +14 -14
  37. package/indexerBaseQuestionAmendment.d.ts +40 -0
  38. package/indexerCandidateCompile.d.ts +46 -36
  39. package/indexerCatalogFallback.d.ts +566 -48
  40. package/indexerContentLayers.d.ts +6 -4
  41. package/indexerContractDeclaration.d.ts +3 -0
  42. package/indexerControlledProgram.d.ts +1039 -238
  43. package/indexerCustomizationDraft.d.ts +188 -0
  44. package/indexerDependencyView.d.ts +17 -17
  45. package/indexerEffectiveArtifact.d.ts +26 -15
  46. package/indexerExampleFactDependencies.d.ts +17 -0
  47. package/indexerExampleIdentityAudit.d.ts +2 -2
  48. package/indexerInventoryDisposition.d.ts +44 -44
  49. package/indexerKnowledgeDependency.d.ts +46 -0
  50. package/indexerLayerComposition.d.ts +92 -54
  51. package/indexerLayoutChange.d.ts +8 -8
  52. package/indexerLayoutProposalSet.d.ts +15 -10
  53. package/indexerLayoutResolver.d.ts +15 -6
  54. package/indexerLayoutTransition.d.ts +8 -8
  55. package/indexerLifecycle.d.ts +1 -1
  56. package/indexerMainRunLedger.d.ts +3 -0
  57. package/indexerMainRunProtocol.d.ts +872 -196
  58. package/indexerMainWorkset.d.ts +50 -0
  59. package/indexerNavigationArtifactPlan.d.ts +2 -2
  60. package/indexerOverlayQuestionAmendment.d.ts +56 -16
  61. package/indexerOverlayQuestionApplyProposal.d.ts +98 -26
  62. package/indexerPartitionPlan.d.ts +585 -40
  63. package/indexerPhysicalArtifactAudit.d.ts +2 -2
  64. package/indexerPhysicalArtifactManifest.d.ts +24 -24
  65. package/indexerPostAuthorRunLedger.d.ts +60 -34
  66. package/indexerPrimaryProjection.d.ts +2 -2
  67. package/indexerProfileContract.d.ts +28 -28
  68. package/indexerProgramRunProtocol.d.ts +868 -194
  69. package/indexerProjectProposal.d.ts +36 -8
  70. package/indexerProjectedArtifactFanOutAudit.d.ts +2 -2
  71. package/indexerProtocolHash.d.ts +2 -0
  72. package/indexerProvider.d.ts +102 -58
  73. package/indexerProviderComposition.d.ts +4 -4
  74. package/indexerProviderRouting.d.ts +52 -0
  75. package/indexerProviderSelectionProposal.d.ts +48 -0
  76. package/indexerPublicContractFacts.d.ts +7 -0
  77. package/indexerPublicContractTable.d.ts +11 -0
  78. package/indexerReaderTargetInventory.d.ts +6 -6
  79. package/indexerReferenceOnlyAudit.d.ts +2 -2
  80. package/indexerRegistry.d.ts +658 -0
  81. package/indexerRequirementConfirmation.d.ts +48 -16
  82. package/indexerRequirementLifecycle.d.ts +154 -42
  83. package/indexerResultReconciliation.d.ts +12 -11
  84. package/indexerSemanticInput.d.ts +27168 -3813
  85. package/{indexerGeneratedAuthoringAudit.d.ts → indexerStructuredClaims.d.ts} +0 -84
  86. package/indexerStructuredDeclaration.d.ts +8 -8
  87. package/indexerTemplateRendering.d.ts +7 -7
  88. package/indexerToolSnapshot.d.ts +16 -16
  89. package/knowledgeMap.d.ts +188 -0
  90. package/managedSources.d.ts +15 -0
  91. package/package.json +1 -1
  92. package/packageSite.d.ts +25 -0
  93. package/phases.d.ts +0 -3
  94. package/processedScopes.d.ts +75 -0
  95. package/sessionMetadata.d.ts +49 -0
  96. package/sources.d.ts +9 -3
  97. package/templates/package-templates/kb/skills/knowledge-query/SKILL.md +15 -10
  98. package/templates/package-templates.zh-CN/kb/skills/knowledge-query/SKILL.md +8 -8
@@ -1,5 +1,6 @@
1
1
  import { z } from "zod";
2
2
  import { DEFAULT_INDEXER_REGISTRY_PATH } from "./indexerProtocolCommon.js";
3
+ export declare const indexerJsonSchema: z.ZodType<IndexerJson>;
3
4
  export type IndexerJson = null | boolean | number | string | IndexerJson[] | {
4
5
  [key: string]: IndexerJson;
5
6
  };
@@ -21,6 +22,7 @@ declare const scopeTargetSchema: z.ZodEffects<z.ZodObject<{
21
22
  }>;
22
23
  export declare const indexRequirementSchema: z.ZodEffects<z.ZodObject<{
23
24
  id: z.ZodEffects<z.ZodString, string, string>;
25
+ purpose: z.ZodOptional<z.ZodString>;
24
26
  reader_goals: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
25
27
  coverage_domains: z.ZodRecord<z.ZodEffects<z.ZodString, string, string>, z.ZodEnum<["required", "optional", "out-of-scope"]>>;
26
28
  questions: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -176,6 +178,7 @@ export declare const indexRequirementSchema: z.ZodEffects<z.ZodObject<{
176
178
  }[];
177
179
  }>;
178
180
  reason: z.ZodString;
181
+ paths: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
179
182
  }, "strict", z.ZodTypeAny, {
180
183
  id: string;
181
184
  scope: {
@@ -185,6 +188,7 @@ export declare const indexRequirementSchema: z.ZodEffects<z.ZodObject<{
185
188
  }[];
186
189
  };
187
190
  reason: string;
191
+ paths?: string[] | undefined;
188
192
  }, {
189
193
  id: string;
190
194
  scope: {
@@ -194,6 +198,7 @@ export declare const indexRequirementSchema: z.ZodEffects<z.ZodObject<{
194
198
  }[];
195
199
  };
196
200
  reason: string;
201
+ paths?: string[] | undefined;
197
202
  }>, "many">>;
198
203
  }, "strict", z.ZodTypeAny, {
199
204
  id: string;
@@ -211,6 +216,7 @@ export declare const indexRequirementSchema: z.ZodEffects<z.ZodObject<{
211
216
  module_refs: string[];
212
217
  }[];
213
218
  };
219
+ purpose?: string | undefined;
214
220
  questions?: {
215
221
  ref: string;
216
222
  authority: {
@@ -230,6 +236,7 @@ export declare const indexRequirementSchema: z.ZodEffects<z.ZodObject<{
230
236
  }[];
231
237
  };
232
238
  reason: string;
239
+ paths?: string[] | undefined;
233
240
  }[] | undefined;
234
241
  }, {
235
242
  id: string;
@@ -247,6 +254,7 @@ export declare const indexRequirementSchema: z.ZodEffects<z.ZodObject<{
247
254
  module_refs?: string[] | undefined;
248
255
  }[];
249
256
  };
257
+ purpose?: string | undefined;
250
258
  questions?: {
251
259
  ref: string;
252
260
  authority: {
@@ -266,6 +274,7 @@ export declare const indexRequirementSchema: z.ZodEffects<z.ZodObject<{
266
274
  }[];
267
275
  };
268
276
  reason: string;
277
+ paths?: string[] | undefined;
269
278
  }[] | undefined;
270
279
  }>, {
271
280
  id: string;
@@ -283,6 +292,7 @@ export declare const indexRequirementSchema: z.ZodEffects<z.ZodObject<{
283
292
  module_refs: string[];
284
293
  }[];
285
294
  };
295
+ purpose?: string | undefined;
286
296
  questions?: {
287
297
  ref: string;
288
298
  authority: {
@@ -302,6 +312,7 @@ export declare const indexRequirementSchema: z.ZodEffects<z.ZodObject<{
302
312
  }[];
303
313
  };
304
314
  reason: string;
315
+ paths?: string[] | undefined;
305
316
  }[] | undefined;
306
317
  }, {
307
318
  id: string;
@@ -319,6 +330,7 @@ export declare const indexRequirementSchema: z.ZodEffects<z.ZodObject<{
319
330
  module_refs?: string[] | undefined;
320
331
  }[];
321
332
  };
333
+ purpose?: string | undefined;
322
334
  questions?: {
323
335
  ref: string;
324
336
  authority: {
@@ -338,12 +350,14 @@ export declare const indexRequirementSchema: z.ZodEffects<z.ZodObject<{
338
350
  }[];
339
351
  };
340
352
  reason: string;
353
+ paths?: string[] | undefined;
341
354
  }[] | undefined;
342
355
  }>;
343
356
  export declare const indexRequirementSetSchema: z.ZodEffects<z.ZodObject<{
344
357
  protocol: z.ZodLiteral<"context.indexer.requirement-set/v1">;
345
358
  requirements: z.ZodArray<z.ZodEffects<z.ZodObject<{
346
359
  id: z.ZodEffects<z.ZodString, string, string>;
360
+ purpose: z.ZodOptional<z.ZodString>;
347
361
  reader_goals: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
348
362
  coverage_domains: z.ZodRecord<z.ZodEffects<z.ZodString, string, string>, z.ZodEnum<["required", "optional", "out-of-scope"]>>;
349
363
  questions: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -499,6 +513,7 @@ export declare const indexRequirementSetSchema: z.ZodEffects<z.ZodObject<{
499
513
  }[];
500
514
  }>;
501
515
  reason: z.ZodString;
516
+ paths: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
502
517
  }, "strict", z.ZodTypeAny, {
503
518
  id: string;
504
519
  scope: {
@@ -508,6 +523,7 @@ export declare const indexRequirementSetSchema: z.ZodEffects<z.ZodObject<{
508
523
  }[];
509
524
  };
510
525
  reason: string;
526
+ paths?: string[] | undefined;
511
527
  }, {
512
528
  id: string;
513
529
  scope: {
@@ -517,6 +533,7 @@ export declare const indexRequirementSetSchema: z.ZodEffects<z.ZodObject<{
517
533
  }[];
518
534
  };
519
535
  reason: string;
536
+ paths?: string[] | undefined;
520
537
  }>, "many">>;
521
538
  }, "strict", z.ZodTypeAny, {
522
539
  id: string;
@@ -534,6 +551,7 @@ export declare const indexRequirementSetSchema: z.ZodEffects<z.ZodObject<{
534
551
  module_refs: string[];
535
552
  }[];
536
553
  };
554
+ purpose?: string | undefined;
537
555
  questions?: {
538
556
  ref: string;
539
557
  authority: {
@@ -553,6 +571,7 @@ export declare const indexRequirementSetSchema: z.ZodEffects<z.ZodObject<{
553
571
  }[];
554
572
  };
555
573
  reason: string;
574
+ paths?: string[] | undefined;
556
575
  }[] | undefined;
557
576
  }, {
558
577
  id: string;
@@ -570,6 +589,7 @@ export declare const indexRequirementSetSchema: z.ZodEffects<z.ZodObject<{
570
589
  module_refs?: string[] | undefined;
571
590
  }[];
572
591
  };
592
+ purpose?: string | undefined;
573
593
  questions?: {
574
594
  ref: string;
575
595
  authority: {
@@ -589,6 +609,7 @@ export declare const indexRequirementSetSchema: z.ZodEffects<z.ZodObject<{
589
609
  }[];
590
610
  };
591
611
  reason: string;
612
+ paths?: string[] | undefined;
592
613
  }[] | undefined;
593
614
  }>, {
594
615
  id: string;
@@ -606,6 +627,7 @@ export declare const indexRequirementSetSchema: z.ZodEffects<z.ZodObject<{
606
627
  module_refs: string[];
607
628
  }[];
608
629
  };
630
+ purpose?: string | undefined;
609
631
  questions?: {
610
632
  ref: string;
611
633
  authority: {
@@ -625,6 +647,7 @@ export declare const indexRequirementSetSchema: z.ZodEffects<z.ZodObject<{
625
647
  }[];
626
648
  };
627
649
  reason: string;
650
+ paths?: string[] | undefined;
628
651
  }[] | undefined;
629
652
  }, {
630
653
  id: string;
@@ -642,6 +665,7 @@ export declare const indexRequirementSetSchema: z.ZodEffects<z.ZodObject<{
642
665
  module_refs?: string[] | undefined;
643
666
  }[];
644
667
  };
668
+ purpose?: string | undefined;
645
669
  questions?: {
646
670
  ref: string;
647
671
  authority: {
@@ -661,6 +685,7 @@ export declare const indexRequirementSetSchema: z.ZodEffects<z.ZodObject<{
661
685
  }[];
662
686
  };
663
687
  reason: string;
688
+ paths?: string[] | undefined;
664
689
  }[] | undefined;
665
690
  }>, "many">;
666
691
  }, "strict", z.ZodTypeAny, {
@@ -681,6 +706,7 @@ export declare const indexRequirementSetSchema: z.ZodEffects<z.ZodObject<{
681
706
  module_refs: string[];
682
707
  }[];
683
708
  };
709
+ purpose?: string | undefined;
684
710
  questions?: {
685
711
  ref: string;
686
712
  authority: {
@@ -700,6 +726,7 @@ export declare const indexRequirementSetSchema: z.ZodEffects<z.ZodObject<{
700
726
  }[];
701
727
  };
702
728
  reason: string;
729
+ paths?: string[] | undefined;
703
730
  }[] | undefined;
704
731
  }[];
705
732
  }, {
@@ -720,6 +747,7 @@ export declare const indexRequirementSetSchema: z.ZodEffects<z.ZodObject<{
720
747
  module_refs?: string[] | undefined;
721
748
  }[];
722
749
  };
750
+ purpose?: string | undefined;
723
751
  questions?: {
724
752
  ref: string;
725
753
  authority: {
@@ -739,6 +767,7 @@ export declare const indexRequirementSetSchema: z.ZodEffects<z.ZodObject<{
739
767
  }[];
740
768
  };
741
769
  reason: string;
770
+ paths?: string[] | undefined;
742
771
  }[] | undefined;
743
772
  }[];
744
773
  }>, {
@@ -759,6 +788,7 @@ export declare const indexRequirementSetSchema: z.ZodEffects<z.ZodObject<{
759
788
  module_refs: string[];
760
789
  }[];
761
790
  };
791
+ purpose?: string | undefined;
762
792
  questions?: {
763
793
  ref: string;
764
794
  authority: {
@@ -778,6 +808,7 @@ export declare const indexRequirementSetSchema: z.ZodEffects<z.ZodObject<{
778
808
  }[];
779
809
  };
780
810
  reason: string;
811
+ paths?: string[] | undefined;
781
812
  }[] | undefined;
782
813
  }[];
783
814
  }, {
@@ -798,6 +829,7 @@ export declare const indexRequirementSetSchema: z.ZodEffects<z.ZodObject<{
798
829
  module_refs?: string[] | undefined;
799
830
  }[];
800
831
  };
832
+ purpose?: string | undefined;
801
833
  questions?: {
802
834
  ref: string;
803
835
  authority: {
@@ -817,6 +849,7 @@ export declare const indexRequirementSetSchema: z.ZodEffects<z.ZodObject<{
817
849
  }[];
818
850
  };
819
851
  reason: string;
852
+ paths?: string[] | undefined;
820
853
  }[] | undefined;
821
854
  }[];
822
855
  }>;
@@ -896,6 +929,611 @@ export declare const indexerDistributionSchema: z.ZodEffects<z.ZodDiscriminatedU
896
929
  kind: "marketplace";
897
930
  locator: string;
898
931
  }>;
932
+ export declare const indexerRegistryEntryInputSchema: z.ZodObject<{
933
+ id: z.ZodEffects<z.ZodString, string, string>;
934
+ operations: z.ZodDefault<z.ZodArray<z.ZodEnum<["main-index"]>, "many">>;
935
+ requirement_bindings: z.ZodArray<z.ZodEffects<z.ZodEffects<z.ZodObject<{
936
+ requirement_ref: z.ZodEffects<z.ZodString, string, string>;
937
+ coverage_domains: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
938
+ owned_scope: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
939
+ ref: z.ZodString;
940
+ }, "strict", z.ZodTypeAny, {
941
+ ref: string;
942
+ }, {
943
+ ref: string;
944
+ }>, z.ZodEffects<z.ZodObject<{
945
+ targets: z.ZodArray<z.ZodEffects<z.ZodObject<{
946
+ source_ref: z.ZodString;
947
+ module_refs: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
948
+ }, "strict", z.ZodTypeAny, {
949
+ source_ref: string;
950
+ module_refs: string[];
951
+ }, {
952
+ source_ref: string;
953
+ module_refs?: string[] | undefined;
954
+ }>, {
955
+ source_ref: string;
956
+ module_refs: string[];
957
+ }, {
958
+ source_ref: string;
959
+ module_refs?: string[] | undefined;
960
+ }>, "many">;
961
+ }, "strict", z.ZodTypeAny, {
962
+ targets: {
963
+ source_ref: string;
964
+ module_refs: string[];
965
+ }[];
966
+ }, {
967
+ targets: {
968
+ source_ref: string;
969
+ module_refs?: string[] | undefined;
970
+ }[];
971
+ }>, {
972
+ targets: {
973
+ source_ref: string;
974
+ module_refs: string[];
975
+ }[];
976
+ }, {
977
+ targets: {
978
+ source_ref: string;
979
+ module_refs?: string[] | undefined;
980
+ }[];
981
+ }>]>>;
982
+ role: z.ZodEnum<["primary", "enricher"]>;
983
+ }, "strict", z.ZodTypeAny, {
984
+ coverage_domains: string[];
985
+ requirement_ref: string;
986
+ role: "primary" | "enricher";
987
+ owned_scope?: {
988
+ targets: {
989
+ source_ref: string;
990
+ module_refs: string[];
991
+ }[];
992
+ } | {
993
+ ref: string;
994
+ } | undefined;
995
+ }, {
996
+ coverage_domains: string[];
997
+ requirement_ref: string;
998
+ role: "primary" | "enricher";
999
+ owned_scope?: {
1000
+ targets: {
1001
+ source_ref: string;
1002
+ module_refs?: string[] | undefined;
1003
+ }[];
1004
+ } | {
1005
+ ref: string;
1006
+ } | undefined;
1007
+ }>, {
1008
+ owned_scope: {
1009
+ targets: {
1010
+ source_ref: string;
1011
+ module_refs: string[];
1012
+ }[];
1013
+ } | {
1014
+ ref: string;
1015
+ };
1016
+ coverage_domains: string[];
1017
+ requirement_ref: string;
1018
+ role: "primary" | "enricher";
1019
+ }, {
1020
+ coverage_domains: string[];
1021
+ requirement_ref: string;
1022
+ role: "primary" | "enricher";
1023
+ owned_scope?: {
1024
+ targets: {
1025
+ source_ref: string;
1026
+ module_refs?: string[] | undefined;
1027
+ }[];
1028
+ } | {
1029
+ ref: string;
1030
+ } | undefined;
1031
+ }>, {
1032
+ owned_scope: {
1033
+ targets: {
1034
+ source_ref: string;
1035
+ module_refs: string[];
1036
+ }[];
1037
+ } | {
1038
+ ref: string;
1039
+ };
1040
+ coverage_domains: string[];
1041
+ requirement_ref: string;
1042
+ role: "primary" | "enricher";
1043
+ }, {
1044
+ coverage_domains: string[];
1045
+ requirement_ref: string;
1046
+ role: "primary" | "enricher";
1047
+ owned_scope?: {
1048
+ targets: {
1049
+ source_ref: string;
1050
+ module_refs?: string[] | undefined;
1051
+ }[];
1052
+ } | {
1053
+ ref: string;
1054
+ } | undefined;
1055
+ }>, "many">;
1056
+ read_scope: z.ZodOptional<z.ZodEffects<z.ZodObject<{
1057
+ refs: z.ZodArray<z.ZodString, "many">;
1058
+ extra_targets: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodObject<{
1059
+ source_ref: z.ZodString;
1060
+ module_refs: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
1061
+ }, "strict", z.ZodTypeAny, {
1062
+ source_ref: string;
1063
+ module_refs: string[];
1064
+ }, {
1065
+ source_ref: string;
1066
+ module_refs?: string[] | undefined;
1067
+ }>, {
1068
+ source_ref: string;
1069
+ module_refs: string[];
1070
+ }, {
1071
+ source_ref: string;
1072
+ module_refs?: string[] | undefined;
1073
+ }>, "many">>;
1074
+ }, "strict", z.ZodTypeAny, {
1075
+ refs: string[];
1076
+ extra_targets?: {
1077
+ source_ref: string;
1078
+ module_refs: string[];
1079
+ }[] | undefined;
1080
+ }, {
1081
+ refs: string[];
1082
+ extra_targets?: {
1083
+ source_ref: string;
1084
+ module_refs?: string[] | undefined;
1085
+ }[] | undefined;
1086
+ }>, {
1087
+ refs: string[];
1088
+ extra_targets?: {
1089
+ source_ref: string;
1090
+ module_refs: string[];
1091
+ }[] | undefined;
1092
+ }, {
1093
+ refs: string[];
1094
+ extra_targets?: {
1095
+ source_ref: string;
1096
+ module_refs?: string[] | undefined;
1097
+ }[] | undefined;
1098
+ }>>;
1099
+ profile: z.ZodObject<{
1100
+ primary: z.ZodObject<{
1101
+ id: z.ZodEffects<z.ZodString, string, string>;
1102
+ provider: z.ZodEffects<z.ZodString, string, string>;
1103
+ variants: z.ZodOptional<z.ZodRecord<z.ZodEffects<z.ZodString, string, string>, z.ZodEffects<z.ZodString, string, string>>>;
1104
+ }, "strict", z.ZodTypeAny, {
1105
+ id: string;
1106
+ provider: string;
1107
+ variants?: Record<string, string> | undefined;
1108
+ }, {
1109
+ id: string;
1110
+ provider: string;
1111
+ variants?: Record<string, string> | undefined;
1112
+ }>;
1113
+ additional: z.ZodOptional<z.ZodArray<z.ZodObject<{
1114
+ id: z.ZodEffects<z.ZodString, string, string>;
1115
+ provider: z.ZodEffects<z.ZodString, string, string>;
1116
+ variants: z.ZodOptional<z.ZodRecord<z.ZodEffects<z.ZodString, string, string>, z.ZodEffects<z.ZodString, string, string>>>;
1117
+ } & {
1118
+ kind: z.ZodEnum<["supporting", "extension"]>;
1119
+ }, "strict", z.ZodTypeAny, {
1120
+ id: string;
1121
+ kind: "supporting" | "extension";
1122
+ provider: string;
1123
+ variants?: Record<string, string> | undefined;
1124
+ }, {
1125
+ id: string;
1126
+ kind: "supporting" | "extension";
1127
+ provider: string;
1128
+ variants?: Record<string, string> | undefined;
1129
+ }>, "many">>;
1130
+ composers: z.ZodOptional<z.ZodArray<z.ZodObject<{
1131
+ id: z.ZodEffects<z.ZodString, string, string>;
1132
+ provider: z.ZodEffects<z.ZodString, string, string>;
1133
+ }, "strict", z.ZodTypeAny, {
1134
+ id: string;
1135
+ provider: string;
1136
+ }, {
1137
+ id: string;
1138
+ provider: string;
1139
+ }>, "many">>;
1140
+ }, "strict", z.ZodTypeAny, {
1141
+ primary: {
1142
+ id: string;
1143
+ provider: string;
1144
+ variants?: Record<string, string> | undefined;
1145
+ };
1146
+ additional?: {
1147
+ id: string;
1148
+ kind: "supporting" | "extension";
1149
+ provider: string;
1150
+ variants?: Record<string, string> | undefined;
1151
+ }[] | undefined;
1152
+ composers?: {
1153
+ id: string;
1154
+ provider: string;
1155
+ }[] | undefined;
1156
+ }, {
1157
+ primary: {
1158
+ id: string;
1159
+ provider: string;
1160
+ variants?: Record<string, string> | undefined;
1161
+ };
1162
+ additional?: {
1163
+ id: string;
1164
+ kind: "supporting" | "extension";
1165
+ provider: string;
1166
+ variants?: Record<string, string> | undefined;
1167
+ }[] | undefined;
1168
+ composers?: {
1169
+ id: string;
1170
+ provider: string;
1171
+ }[] | undefined;
1172
+ }>;
1173
+ providers: z.ZodArray<z.ZodEffects<z.ZodEffects<z.ZodObject<{
1174
+ id: z.ZodEffects<z.ZodString, string, string>;
1175
+ role: z.ZodDefault<z.ZodEnum<["primary", "extension"]>>;
1176
+ skill: z.ZodEffects<z.ZodString, string, string>;
1177
+ version: z.ZodString;
1178
+ integrity: z.ZodString;
1179
+ distribution: z.ZodOptional<z.ZodEffects<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
1180
+ kind: z.ZodLiteral<"cli-bundled">;
1181
+ locator: z.ZodString;
1182
+ }, "strict", z.ZodTypeAny, {
1183
+ kind: "cli-bundled";
1184
+ locator: string;
1185
+ }, {
1186
+ kind: "cli-bundled";
1187
+ locator: string;
1188
+ }>, z.ZodObject<{
1189
+ kind: z.ZodLiteral<"bundled">;
1190
+ locator: z.ZodString;
1191
+ }, "strict", z.ZodTypeAny, {
1192
+ kind: "bundled";
1193
+ locator: string;
1194
+ }, {
1195
+ kind: "bundled";
1196
+ locator: string;
1197
+ }>, z.ZodObject<{
1198
+ kind: z.ZodLiteral<"workspace">;
1199
+ locator: z.ZodString;
1200
+ }, "strict", z.ZodTypeAny, {
1201
+ kind: "workspace";
1202
+ locator: string;
1203
+ }, {
1204
+ kind: "workspace";
1205
+ locator: string;
1206
+ }>, z.ZodObject<{
1207
+ kind: z.ZodLiteral<"package">;
1208
+ locator: z.ZodString;
1209
+ }, "strict", z.ZodTypeAny, {
1210
+ kind: "package";
1211
+ locator: string;
1212
+ }, {
1213
+ kind: "package";
1214
+ locator: string;
1215
+ }>, z.ZodObject<{
1216
+ kind: z.ZodLiteral<"marketplace">;
1217
+ locator: z.ZodString;
1218
+ }, "strict", z.ZodTypeAny, {
1219
+ kind: "marketplace";
1220
+ locator: string;
1221
+ }, {
1222
+ kind: "marketplace";
1223
+ locator: string;
1224
+ }>]>, {
1225
+ kind: "cli-bundled";
1226
+ locator: string;
1227
+ } | {
1228
+ kind: "bundled";
1229
+ locator: string;
1230
+ } | {
1231
+ kind: "workspace";
1232
+ locator: string;
1233
+ } | {
1234
+ kind: "package";
1235
+ locator: string;
1236
+ } | {
1237
+ kind: "marketplace";
1238
+ locator: string;
1239
+ }, {
1240
+ kind: "cli-bundled";
1241
+ locator: string;
1242
+ } | {
1243
+ kind: "bundled";
1244
+ locator: string;
1245
+ } | {
1246
+ kind: "workspace";
1247
+ locator: string;
1248
+ } | {
1249
+ kind: "package";
1250
+ locator: string;
1251
+ } | {
1252
+ kind: "marketplace";
1253
+ locator: string;
1254
+ }>>;
1255
+ config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<IndexerJson, z.ZodTypeDef, IndexerJson>>>;
1256
+ }, "strict", z.ZodTypeAny, {
1257
+ id: string;
1258
+ role: "primary" | "extension";
1259
+ skill: string;
1260
+ version: string;
1261
+ integrity: string;
1262
+ distribution?: {
1263
+ kind: "cli-bundled";
1264
+ locator: string;
1265
+ } | {
1266
+ kind: "bundled";
1267
+ locator: string;
1268
+ } | {
1269
+ kind: "workspace";
1270
+ locator: string;
1271
+ } | {
1272
+ kind: "package";
1273
+ locator: string;
1274
+ } | {
1275
+ kind: "marketplace";
1276
+ locator: string;
1277
+ } | undefined;
1278
+ config?: Record<string, IndexerJson> | undefined;
1279
+ }, {
1280
+ id: string;
1281
+ skill: string;
1282
+ version: string;
1283
+ integrity: string;
1284
+ role?: "primary" | "extension" | undefined;
1285
+ distribution?: {
1286
+ kind: "cli-bundled";
1287
+ locator: string;
1288
+ } | {
1289
+ kind: "bundled";
1290
+ locator: string;
1291
+ } | {
1292
+ kind: "workspace";
1293
+ locator: string;
1294
+ } | {
1295
+ kind: "package";
1296
+ locator: string;
1297
+ } | {
1298
+ kind: "marketplace";
1299
+ locator: string;
1300
+ } | undefined;
1301
+ config?: Record<string, IndexerJson> | undefined;
1302
+ }>, {
1303
+ distribution: {
1304
+ kind: "cli-bundled";
1305
+ locator: string;
1306
+ } | {
1307
+ kind: "bundled";
1308
+ locator: string;
1309
+ } | {
1310
+ kind: "workspace";
1311
+ locator: string;
1312
+ } | {
1313
+ kind: "package";
1314
+ locator: string;
1315
+ } | {
1316
+ kind: "marketplace";
1317
+ locator: string;
1318
+ };
1319
+ id: string;
1320
+ role: "primary" | "extension";
1321
+ skill: string;
1322
+ version: string;
1323
+ integrity: string;
1324
+ config?: Record<string, IndexerJson> | undefined;
1325
+ }, {
1326
+ id: string;
1327
+ skill: string;
1328
+ version: string;
1329
+ integrity: string;
1330
+ role?: "primary" | "extension" | undefined;
1331
+ distribution?: {
1332
+ kind: "cli-bundled";
1333
+ locator: string;
1334
+ } | {
1335
+ kind: "bundled";
1336
+ locator: string;
1337
+ } | {
1338
+ kind: "workspace";
1339
+ locator: string;
1340
+ } | {
1341
+ kind: "package";
1342
+ locator: string;
1343
+ } | {
1344
+ kind: "marketplace";
1345
+ locator: string;
1346
+ } | undefined;
1347
+ config?: Record<string, IndexerJson> | undefined;
1348
+ }>, {
1349
+ distribution: {
1350
+ kind: "cli-bundled";
1351
+ locator: string;
1352
+ } | {
1353
+ kind: "bundled";
1354
+ locator: string;
1355
+ } | {
1356
+ kind: "workspace";
1357
+ locator: string;
1358
+ } | {
1359
+ kind: "package";
1360
+ locator: string;
1361
+ } | {
1362
+ kind: "marketplace";
1363
+ locator: string;
1364
+ };
1365
+ id: string;
1366
+ role: "primary" | "extension";
1367
+ skill: string;
1368
+ version: string;
1369
+ integrity: string;
1370
+ config?: Record<string, IndexerJson> | undefined;
1371
+ }, {
1372
+ id: string;
1373
+ skill: string;
1374
+ version: string;
1375
+ integrity: string;
1376
+ role?: "primary" | "extension" | undefined;
1377
+ distribution?: {
1378
+ kind: "cli-bundled";
1379
+ locator: string;
1380
+ } | {
1381
+ kind: "bundled";
1382
+ locator: string;
1383
+ } | {
1384
+ kind: "workspace";
1385
+ locator: string;
1386
+ } | {
1387
+ kind: "package";
1388
+ locator: string;
1389
+ } | {
1390
+ kind: "marketplace";
1391
+ locator: string;
1392
+ } | undefined;
1393
+ config?: Record<string, IndexerJson> | undefined;
1394
+ }>, "many">;
1395
+ customization: z.ZodOptional<z.ZodObject<{
1396
+ mode: z.ZodEnum<["extend", "replace"]>;
1397
+ }, "strict", z.ZodTypeAny, {
1398
+ mode: "replace" | "extend";
1399
+ }, {
1400
+ mode: "replace" | "extend";
1401
+ }>>;
1402
+ }, "strict", z.ZodTypeAny, {
1403
+ id: string;
1404
+ operations: "main-index"[];
1405
+ requirement_bindings: {
1406
+ owned_scope: {
1407
+ targets: {
1408
+ source_ref: string;
1409
+ module_refs: string[];
1410
+ }[];
1411
+ } | {
1412
+ ref: string;
1413
+ };
1414
+ coverage_domains: string[];
1415
+ requirement_ref: string;
1416
+ role: "primary" | "enricher";
1417
+ }[];
1418
+ profile: {
1419
+ primary: {
1420
+ id: string;
1421
+ provider: string;
1422
+ variants?: Record<string, string> | undefined;
1423
+ };
1424
+ additional?: {
1425
+ id: string;
1426
+ kind: "supporting" | "extension";
1427
+ provider: string;
1428
+ variants?: Record<string, string> | undefined;
1429
+ }[] | undefined;
1430
+ composers?: {
1431
+ id: string;
1432
+ provider: string;
1433
+ }[] | undefined;
1434
+ };
1435
+ providers: {
1436
+ distribution: {
1437
+ kind: "cli-bundled";
1438
+ locator: string;
1439
+ } | {
1440
+ kind: "bundled";
1441
+ locator: string;
1442
+ } | {
1443
+ kind: "workspace";
1444
+ locator: string;
1445
+ } | {
1446
+ kind: "package";
1447
+ locator: string;
1448
+ } | {
1449
+ kind: "marketplace";
1450
+ locator: string;
1451
+ };
1452
+ id: string;
1453
+ role: "primary" | "extension";
1454
+ skill: string;
1455
+ version: string;
1456
+ integrity: string;
1457
+ config?: Record<string, IndexerJson> | undefined;
1458
+ }[];
1459
+ read_scope?: {
1460
+ refs: string[];
1461
+ extra_targets?: {
1462
+ source_ref: string;
1463
+ module_refs: string[];
1464
+ }[] | undefined;
1465
+ } | undefined;
1466
+ customization?: {
1467
+ mode: "replace" | "extend";
1468
+ } | undefined;
1469
+ }, {
1470
+ id: string;
1471
+ requirement_bindings: {
1472
+ coverage_domains: string[];
1473
+ requirement_ref: string;
1474
+ role: "primary" | "enricher";
1475
+ owned_scope?: {
1476
+ targets: {
1477
+ source_ref: string;
1478
+ module_refs?: string[] | undefined;
1479
+ }[];
1480
+ } | {
1481
+ ref: string;
1482
+ } | undefined;
1483
+ }[];
1484
+ profile: {
1485
+ primary: {
1486
+ id: string;
1487
+ provider: string;
1488
+ variants?: Record<string, string> | undefined;
1489
+ };
1490
+ additional?: {
1491
+ id: string;
1492
+ kind: "supporting" | "extension";
1493
+ provider: string;
1494
+ variants?: Record<string, string> | undefined;
1495
+ }[] | undefined;
1496
+ composers?: {
1497
+ id: string;
1498
+ provider: string;
1499
+ }[] | undefined;
1500
+ };
1501
+ providers: {
1502
+ id: string;
1503
+ skill: string;
1504
+ version: string;
1505
+ integrity: string;
1506
+ role?: "primary" | "extension" | undefined;
1507
+ distribution?: {
1508
+ kind: "cli-bundled";
1509
+ locator: string;
1510
+ } | {
1511
+ kind: "bundled";
1512
+ locator: string;
1513
+ } | {
1514
+ kind: "workspace";
1515
+ locator: string;
1516
+ } | {
1517
+ kind: "package";
1518
+ locator: string;
1519
+ } | {
1520
+ kind: "marketplace";
1521
+ locator: string;
1522
+ } | undefined;
1523
+ config?: Record<string, IndexerJson> | undefined;
1524
+ }[];
1525
+ operations?: "main-index"[] | undefined;
1526
+ read_scope?: {
1527
+ refs: string[];
1528
+ extra_targets?: {
1529
+ source_ref: string;
1530
+ module_refs?: string[] | undefined;
1531
+ }[] | undefined;
1532
+ } | undefined;
1533
+ customization?: {
1534
+ mode: "replace" | "extend";
1535
+ } | undefined;
1536
+ }>;
899
1537
  export declare const indexerRegistryEntrySchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
900
1538
  id: z.ZodEffects<z.ZodString, string, string>;
901
1539
  operations: z.ZodDefault<z.ZodArray<z.ZodEnum<["main-index"]>, "many">>;
@@ -1773,6 +2411,7 @@ export declare const indexerRegistrySchema: z.ZodEffects<z.ZodObject<{
1773
2411
  protocol: z.ZodLiteral<"context.indexer.registry/v1">;
1774
2412
  requirements: z.ZodArray<z.ZodEffects<z.ZodObject<{
1775
2413
  id: z.ZodEffects<z.ZodString, string, string>;
2414
+ purpose: z.ZodOptional<z.ZodString>;
1776
2415
  reader_goals: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
1777
2416
  coverage_domains: z.ZodRecord<z.ZodEffects<z.ZodString, string, string>, z.ZodEnum<["required", "optional", "out-of-scope"]>>;
1778
2417
  questions: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -1928,6 +2567,7 @@ export declare const indexerRegistrySchema: z.ZodEffects<z.ZodObject<{
1928
2567
  }[];
1929
2568
  }>;
1930
2569
  reason: z.ZodString;
2570
+ paths: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
1931
2571
  }, "strict", z.ZodTypeAny, {
1932
2572
  id: string;
1933
2573
  scope: {
@@ -1937,6 +2577,7 @@ export declare const indexerRegistrySchema: z.ZodEffects<z.ZodObject<{
1937
2577
  }[];
1938
2578
  };
1939
2579
  reason: string;
2580
+ paths?: string[] | undefined;
1940
2581
  }, {
1941
2582
  id: string;
1942
2583
  scope: {
@@ -1946,6 +2587,7 @@ export declare const indexerRegistrySchema: z.ZodEffects<z.ZodObject<{
1946
2587
  }[];
1947
2588
  };
1948
2589
  reason: string;
2590
+ paths?: string[] | undefined;
1949
2591
  }>, "many">>;
1950
2592
  }, "strict", z.ZodTypeAny, {
1951
2593
  id: string;
@@ -1963,6 +2605,7 @@ export declare const indexerRegistrySchema: z.ZodEffects<z.ZodObject<{
1963
2605
  module_refs: string[];
1964
2606
  }[];
1965
2607
  };
2608
+ purpose?: string | undefined;
1966
2609
  questions?: {
1967
2610
  ref: string;
1968
2611
  authority: {
@@ -1982,6 +2625,7 @@ export declare const indexerRegistrySchema: z.ZodEffects<z.ZodObject<{
1982
2625
  }[];
1983
2626
  };
1984
2627
  reason: string;
2628
+ paths?: string[] | undefined;
1985
2629
  }[] | undefined;
1986
2630
  }, {
1987
2631
  id: string;
@@ -1999,6 +2643,7 @@ export declare const indexerRegistrySchema: z.ZodEffects<z.ZodObject<{
1999
2643
  module_refs?: string[] | undefined;
2000
2644
  }[];
2001
2645
  };
2646
+ purpose?: string | undefined;
2002
2647
  questions?: {
2003
2648
  ref: string;
2004
2649
  authority: {
@@ -2018,6 +2663,7 @@ export declare const indexerRegistrySchema: z.ZodEffects<z.ZodObject<{
2018
2663
  }[];
2019
2664
  };
2020
2665
  reason: string;
2666
+ paths?: string[] | undefined;
2021
2667
  }[] | undefined;
2022
2668
  }>, {
2023
2669
  id: string;
@@ -2035,6 +2681,7 @@ export declare const indexerRegistrySchema: z.ZodEffects<z.ZodObject<{
2035
2681
  module_refs: string[];
2036
2682
  }[];
2037
2683
  };
2684
+ purpose?: string | undefined;
2038
2685
  questions?: {
2039
2686
  ref: string;
2040
2687
  authority: {
@@ -2054,6 +2701,7 @@ export declare const indexerRegistrySchema: z.ZodEffects<z.ZodObject<{
2054
2701
  }[];
2055
2702
  };
2056
2703
  reason: string;
2704
+ paths?: string[] | undefined;
2057
2705
  }[] | undefined;
2058
2706
  }, {
2059
2707
  id: string;
@@ -2071,6 +2719,7 @@ export declare const indexerRegistrySchema: z.ZodEffects<z.ZodObject<{
2071
2719
  module_refs?: string[] | undefined;
2072
2720
  }[];
2073
2721
  };
2722
+ purpose?: string | undefined;
2074
2723
  questions?: {
2075
2724
  ref: string;
2076
2725
  authority: {
@@ -2090,6 +2739,7 @@ export declare const indexerRegistrySchema: z.ZodEffects<z.ZodObject<{
2090
2739
  }[];
2091
2740
  };
2092
2741
  reason: string;
2742
+ paths?: string[] | undefined;
2093
2743
  }[] | undefined;
2094
2744
  }>, "many">;
2095
2745
  indexers: z.ZodArray<z.ZodEffects<z.ZodEffects<z.ZodObject<{
@@ -2983,6 +3633,7 @@ export declare const indexerRegistrySchema: z.ZodEffects<z.ZodObject<{
2983
3633
  module_refs: string[];
2984
3634
  }[];
2985
3635
  };
3636
+ purpose?: string | undefined;
2986
3637
  questions?: {
2987
3638
  ref: string;
2988
3639
  authority: {
@@ -3002,6 +3653,7 @@ export declare const indexerRegistrySchema: z.ZodEffects<z.ZodObject<{
3002
3653
  }[];
3003
3654
  };
3004
3655
  reason: string;
3656
+ paths?: string[] | undefined;
3005
3657
  }[] | undefined;
3006
3658
  }[];
3007
3659
  indexers: {
@@ -3090,6 +3742,7 @@ export declare const indexerRegistrySchema: z.ZodEffects<z.ZodObject<{
3090
3742
  module_refs?: string[] | undefined;
3091
3743
  }[];
3092
3744
  };
3745
+ purpose?: string | undefined;
3093
3746
  questions?: {
3094
3747
  ref: string;
3095
3748
  authority: {
@@ -3109,6 +3762,7 @@ export declare const indexerRegistrySchema: z.ZodEffects<z.ZodObject<{
3109
3762
  }[];
3110
3763
  };
3111
3764
  reason: string;
3765
+ paths?: string[] | undefined;
3112
3766
  }[] | undefined;
3113
3767
  }[];
3114
3768
  indexers: {
@@ -3197,6 +3851,7 @@ export declare const indexerRegistrySchema: z.ZodEffects<z.ZodObject<{
3197
3851
  module_refs: string[];
3198
3852
  }[];
3199
3853
  };
3854
+ purpose?: string | undefined;
3200
3855
  questions?: {
3201
3856
  ref: string;
3202
3857
  authority: {
@@ -3216,6 +3871,7 @@ export declare const indexerRegistrySchema: z.ZodEffects<z.ZodObject<{
3216
3871
  }[];
3217
3872
  };
3218
3873
  reason: string;
3874
+ paths?: string[] | undefined;
3219
3875
  }[] | undefined;
3220
3876
  }[];
3221
3877
  indexers: {
@@ -3304,6 +3960,7 @@ export declare const indexerRegistrySchema: z.ZodEffects<z.ZodObject<{
3304
3960
  module_refs?: string[] | undefined;
3305
3961
  }[];
3306
3962
  };
3963
+ purpose?: string | undefined;
3307
3964
  questions?: {
3308
3965
  ref: string;
3309
3966
  authority: {
@@ -3323,6 +3980,7 @@ export declare const indexerRegistrySchema: z.ZodEffects<z.ZodObject<{
3323
3980
  }[];
3324
3981
  };
3325
3982
  reason: string;
3983
+ paths?: string[] | undefined;
3326
3984
  }[] | undefined;
3327
3985
  }[];
3328
3986
  indexers: {