@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,222 @@
1
+ import { z } from "zod";
2
+ export declare const indexerParserPackageCoordinateSchema: z.ZodObject<{
3
+ package: z.ZodString;
4
+ export: z.ZodString;
5
+ version: z.ZodString;
6
+ }, "strict", z.ZodTypeAny, {
7
+ export: string;
8
+ package: string;
9
+ version: string;
10
+ }, {
11
+ export: string;
12
+ package: string;
13
+ version: string;
14
+ }>;
15
+ export declare const indexerParserRequirementSchema: z.ZodObject<{
16
+ protocol: z.ZodLiteral<"context.indexer.parser-requirement/v1">;
17
+ capability: z.ZodEffects<z.ZodString, string, string>;
18
+ abi: z.ZodString;
19
+ abi_digest: z.ZodString;
20
+ community_coordinate: z.ZodObject<{
21
+ package: z.ZodString;
22
+ export: z.ZodString;
23
+ version: z.ZodString;
24
+ }, "strict", z.ZodTypeAny, {
25
+ export: string;
26
+ package: string;
27
+ version: string;
28
+ }, {
29
+ export: string;
30
+ package: string;
31
+ version: string;
32
+ }>;
33
+ } & {
34
+ requirement_digest: z.ZodString;
35
+ }, "strict", z.ZodTypeAny, {
36
+ protocol: "context.indexer.parser-requirement/v1";
37
+ capability: string;
38
+ abi: string;
39
+ abi_digest: string;
40
+ community_coordinate: {
41
+ export: string;
42
+ package: string;
43
+ version: string;
44
+ };
45
+ requirement_digest: string;
46
+ }, {
47
+ protocol: "context.indexer.parser-requirement/v1";
48
+ capability: string;
49
+ abi: string;
50
+ abi_digest: string;
51
+ community_coordinate: {
52
+ export: string;
53
+ package: string;
54
+ version: string;
55
+ };
56
+ requirement_digest: string;
57
+ }>;
58
+ export type IndexerParserRequirement = z.infer<typeof indexerParserRequirementSchema>;
59
+ export declare const indexerParserCoordinateMappingSchema: z.ZodObject<{
60
+ protocol: z.ZodLiteral<"context.indexer.parser-coordinate-mapping/v1">;
61
+ capability: z.ZodEffects<z.ZodString, string, string>;
62
+ requirement_digest: z.ZodString;
63
+ resolution: z.ZodEnum<["direct", "wrapper"]>;
64
+ registry: z.ZodEffects<z.ZodString, string, string>;
65
+ actual_coordinate: z.ZodObject<{
66
+ package: z.ZodString;
67
+ export: z.ZodString;
68
+ version: z.ZodString;
69
+ }, "strict", z.ZodTypeAny, {
70
+ export: string;
71
+ package: string;
72
+ version: string;
73
+ }, {
74
+ export: string;
75
+ package: string;
76
+ version: string;
77
+ }>;
78
+ abi_digest: z.ZodString;
79
+ } & {
80
+ mapping_digest: z.ZodString;
81
+ }, "strict", z.ZodTypeAny, {
82
+ protocol: "context.indexer.parser-coordinate-mapping/v1";
83
+ registry: string;
84
+ capability: string;
85
+ abi_digest: string;
86
+ requirement_digest: string;
87
+ resolution: "direct" | "wrapper";
88
+ actual_coordinate: {
89
+ export: string;
90
+ package: string;
91
+ version: string;
92
+ };
93
+ mapping_digest: string;
94
+ }, {
95
+ protocol: "context.indexer.parser-coordinate-mapping/v1";
96
+ registry: string;
97
+ capability: string;
98
+ abi_digest: string;
99
+ requirement_digest: string;
100
+ resolution: "direct" | "wrapper";
101
+ actual_coordinate: {
102
+ export: string;
103
+ package: string;
104
+ version: string;
105
+ };
106
+ mapping_digest: string;
107
+ }>;
108
+ export type IndexerParserCoordinateMapping = z.infer<typeof indexerParserCoordinateMappingSchema>;
109
+ export declare const indexerParserResolutionLockSchema: z.ZodObject<{
110
+ protocol: z.ZodLiteral<"context.indexer.parser-resolution-lock/v1">;
111
+ capability: z.ZodEffects<z.ZodString, string, string>;
112
+ requirement_digest: z.ZodString;
113
+ mapping_digest: z.ZodString;
114
+ actual_coordinate: z.ZodObject<{
115
+ package: z.ZodString;
116
+ export: z.ZodString;
117
+ version: z.ZodString;
118
+ }, "strict", z.ZodTypeAny, {
119
+ export: string;
120
+ package: string;
121
+ version: string;
122
+ }, {
123
+ export: string;
124
+ package: string;
125
+ version: string;
126
+ }>;
127
+ abi_digest: z.ZodString;
128
+ lock_integrity: z.ZodString;
129
+ resolved_content_digest: z.ZodString;
130
+ } & {
131
+ lock_digest: z.ZodString;
132
+ }, "strict", z.ZodTypeAny, {
133
+ protocol: "context.indexer.parser-resolution-lock/v1";
134
+ capability: string;
135
+ abi_digest: string;
136
+ requirement_digest: string;
137
+ actual_coordinate: {
138
+ export: string;
139
+ package: string;
140
+ version: string;
141
+ };
142
+ mapping_digest: string;
143
+ lock_integrity: string;
144
+ resolved_content_digest: string;
145
+ lock_digest: string;
146
+ }, {
147
+ protocol: "context.indexer.parser-resolution-lock/v1";
148
+ capability: string;
149
+ abi_digest: string;
150
+ requirement_digest: string;
151
+ actual_coordinate: {
152
+ export: string;
153
+ package: string;
154
+ version: string;
155
+ };
156
+ mapping_digest: string;
157
+ lock_integrity: string;
158
+ resolved_content_digest: string;
159
+ lock_digest: string;
160
+ }>;
161
+ export type IndexerParserResolutionLock = z.infer<typeof indexerParserResolutionLockSchema>;
162
+ export declare const indexerParserImportSchema: z.ZodObject<{
163
+ capability: z.ZodEffects<z.ZodString, string, string>;
164
+ package: z.ZodString;
165
+ export: z.ZodString;
166
+ version: z.ZodString;
167
+ parser_lock_digest: z.ZodString;
168
+ }, "strict", z.ZodTypeAny, {
169
+ export: string;
170
+ package: string;
171
+ version: string;
172
+ capability: string;
173
+ parser_lock_digest: string;
174
+ }, {
175
+ export: string;
176
+ package: string;
177
+ version: string;
178
+ capability: string;
179
+ parser_lock_digest: string;
180
+ }>;
181
+ export type IndexerParserImport = z.infer<typeof indexerParserImportSchema>;
182
+ export declare function buildIndexerParserRequirement(input: {
183
+ capability: string;
184
+ abi: string;
185
+ abi_digest: string;
186
+ community_coordinate: z.input<typeof indexerParserPackageCoordinateSchema>;
187
+ }): IndexerParserRequirement;
188
+ export declare function validateIndexerParserRequirement(value: unknown): IndexerParserRequirement;
189
+ export declare function buildIndexerParserCoordinateMapping(input: {
190
+ requirement: unknown;
191
+ resolution: "direct" | "wrapper";
192
+ registry: string;
193
+ actual_coordinate: z.input<typeof indexerParserPackageCoordinateSchema>;
194
+ abi_digest: string;
195
+ }): IndexerParserCoordinateMapping;
196
+ export declare function validateIndexerParserCoordinateMapping(input: {
197
+ requirement: unknown;
198
+ mapping: unknown;
199
+ }): IndexerParserCoordinateMapping;
200
+ export declare function buildIndexerParserResolutionLock(input: {
201
+ requirement: unknown;
202
+ mapping: unknown;
203
+ lock_integrity: string;
204
+ resolved_content_digest: string;
205
+ }): IndexerParserResolutionLock;
206
+ export declare function validateIndexerParserResolutionLock(input: {
207
+ requirement: unknown;
208
+ mapping: unknown;
209
+ lock: unknown;
210
+ }): IndexerParserResolutionLock;
211
+ export declare function validateIndexerParserImport(input: {
212
+ requirement: unknown;
213
+ mapping: unknown;
214
+ lock: unknown;
215
+ parser_import: unknown;
216
+ }): IndexerParserImport;
217
+ export declare function indexerParserLockedDependency(lockValue: unknown): {
218
+ package: string;
219
+ version: string;
220
+ lock_integrity: string;
221
+ resolved_digest: string;
222
+ };