@c4a/context 0.7.4 → 0.7.8

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 (97) hide show
  1. package/README.md +17 -8
  2. package/README.zh-CN.md +15 -8
  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 +19 -9
  7. package/docs/guides/agent-guide.md +52 -10
  8. package/docs/guides/code-indexer-skill-authoring.md +50 -5
  9. package/docs/guides/indexer-manifest-example.md +103 -0
  10. package/docs/guides/indexer-provider-and-customization.md +307 -31
  11. package/docs/guides/indexer-skill-creation.md +99 -0
  12. package/docs/guides/knowledge-updates.md +324 -0
  13. package/docs/guides/lark-resources.md +5 -1
  14. package/docs/guides/markdown-indexer-skill-authoring.md +25 -7
  15. package/docs/guides/note.md +37 -0
  16. package/docs/guides/package-outputs.md +22 -17
  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 +116 -22
  23. package/docs/reference/package-templates.md +10 -9
  24. package/docs/reference/project-api.md +47 -13
  25. package/docs/reference/template-variables.md +7 -7
  26. package/index.d.ts +11 -0
  27. package/index.js +1819 -584
  28. package/indexerAgentStepProtocol.d.ts +1284 -2060
  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 +7 -5
  33. package/indexerArtifactPolicy.d.ts +16 -16
  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/indexerCompositionFactDependencies.d.ts +16 -0
  41. package/indexerContentLayers.d.ts +6 -4
  42. package/indexerContractDeclaration.d.ts +3 -0
  43. package/indexerControlledProgram.d.ts +1039 -238
  44. package/indexerCustomizationDraft.d.ts +188 -0
  45. package/indexerDependencyView.d.ts +17 -17
  46. package/indexerEffectiveArtifact.d.ts +26 -15
  47. package/indexerExampleFactDependencies.d.ts +17 -0
  48. package/indexerExampleIdentityAudit.d.ts +2 -2
  49. package/indexerInventoryDisposition.d.ts +44 -44
  50. package/indexerKnowledgeDependency.d.ts +46 -0
  51. package/indexerLayerComposition.d.ts +92 -54
  52. package/indexerLayoutChange.d.ts +8 -8
  53. package/indexerLayoutProposalSet.d.ts +15 -10
  54. package/indexerLayoutResolver.d.ts +15 -6
  55. package/indexerLayoutTransition.d.ts +8 -8
  56. package/indexerLifecycle.d.ts +1 -1
  57. package/indexerMainRunLedger.d.ts +7 -0
  58. package/indexerMainRunProtocol.d.ts +872 -196
  59. package/indexerMainWorkset.d.ts +50 -0
  60. package/indexerNavigationArtifactPlan.d.ts +2 -2
  61. package/indexerOverlayQuestionAmendment.d.ts +56 -16
  62. package/indexerOverlayQuestionApplyProposal.d.ts +98 -26
  63. package/indexerPartitionPlan.d.ts +585 -40
  64. package/indexerPhysicalArtifactAudit.d.ts +2 -2
  65. package/indexerPhysicalArtifactManifest.d.ts +24 -24
  66. package/indexerPostAuthorRunLedger.d.ts +60 -34
  67. package/indexerPrimaryProjection.d.ts +2 -2
  68. package/indexerProfileContract.d.ts +28 -28
  69. package/indexerProgramRunProtocol.d.ts +868 -194
  70. package/indexerProjectProposal.d.ts +36 -8
  71. package/indexerProjectedArtifactFanOutAudit.d.ts +2 -2
  72. package/indexerProvider.d.ts +72 -28
  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 +52 -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 +28014 -1847
  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/managedSources.d.ts +15 -0
  90. package/package.json +1 -1
  91. package/phases.d.ts +0 -3
  92. package/processedScopes.d.ts +75 -0
  93. package/readingStructure.d.ts +188 -0
  94. package/sessionMetadata.d.ts +49 -0
  95. package/sources.d.ts +9 -3
  96. package/templates/package-templates/kb/skills/knowledge-query/SKILL.md +15 -10
  97. package/templates/package-templates.zh-CN/kb/skills/knowledge-query/SKILL.md +8 -8
@@ -10,11 +10,11 @@ export declare const indexerArtifactPolicyEligibilitySchema: z.ZodObject<{
10
10
  path: z.ZodString;
11
11
  value: z.ZodType<IndexerJson, z.ZodTypeDef, IndexerJson>;
12
12
  }, "strict", z.ZodTypeAny, {
13
- value: IndexerJson;
14
13
  path: string;
15
- }, {
16
14
  value: IndexerJson;
15
+ }, {
17
16
  path: string;
17
+ value: IndexerJson;
18
18
  }>, "many">;
19
19
  provider_supported_variants: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
20
20
  eligible_variants: z.ZodArray<z.ZodObject<{
@@ -71,8 +71,8 @@ export declare const indexerArtifactPolicyEligibilitySchema: z.ZodObject<{
71
71
  profile_id: string;
72
72
  profile_contract_digest: string;
73
73
  canonical_facts: {
74
- value: IndexerJson;
75
74
  path: string;
75
+ value: IndexerJson;
76
76
  }[];
77
77
  provider_supported_variants: string[];
78
78
  eligible_variants: {
@@ -94,8 +94,8 @@ export declare const indexerArtifactPolicyEligibilitySchema: z.ZodObject<{
94
94
  profile_id: string;
95
95
  profile_contract_digest: string;
96
96
  canonical_facts: {
97
- value: IndexerJson;
98
97
  path: string;
98
+ value: IndexerJson;
99
99
  }[];
100
100
  provider_supported_variants: string[];
101
101
  eligible_variants: {
@@ -133,16 +133,16 @@ declare const artifactBundleEntrySchema: z.ZodUnion<[z.ZodObject<{
133
133
  reader_question_refs: z.ZodArray<z.ZodString, "many">;
134
134
  evidence_refs: z.ZodArray<z.ZodString, "many">;
135
135
  }, "strict", z.ZodTypeAny, {
136
+ purpose: "required" | "discretionary";
136
137
  evidence_refs: string[];
137
138
  artifact_kind: string;
138
139
  artifact_id: string;
139
- purpose: "required" | "discretionary";
140
140
  reader_question_refs: string[];
141
141
  }, {
142
+ purpose: "required" | "discretionary";
142
143
  evidence_refs: string[];
143
144
  artifact_kind: string;
144
145
  artifact_id: string;
145
- purpose: "required" | "discretionary";
146
146
  reader_question_refs: string[];
147
147
  }>, z.ZodObject<{
148
148
  artifact_id: z.ZodEffects<z.ZodString, string, string>;
@@ -165,10 +165,10 @@ declare const artifactBundleEntrySchema: z.ZodUnion<[z.ZodObject<{
165
165
  end_key: string;
166
166
  }>;
167
167
  }, "strict", z.ZodTypeAny, {
168
+ purpose: "semantic-split";
168
169
  evidence_refs: string[];
169
170
  artifact_kind: string;
170
171
  artifact_id: string;
171
- purpose: "semantic-split";
172
172
  reader_question_refs: string[];
173
173
  split_of: string;
174
174
  boundary: {
@@ -177,10 +177,10 @@ declare const artifactBundleEntrySchema: z.ZodUnion<[z.ZodObject<{
177
177
  end_key: string;
178
178
  };
179
179
  }, {
180
+ purpose: "semantic-split";
180
181
  evidence_refs: string[];
181
182
  artifact_kind: string;
182
183
  artifact_id: string;
183
- purpose: "semantic-split";
184
184
  reader_question_refs: string[];
185
185
  split_of: string;
186
186
  boundary: {
@@ -200,16 +200,16 @@ export declare const indexerArtifactBundleSchema: z.ZodObject<{
200
200
  reader_question_refs: z.ZodArray<z.ZodString, "many">;
201
201
  evidence_refs: z.ZodArray<z.ZodString, "many">;
202
202
  }, "strict", z.ZodTypeAny, {
203
+ purpose: "required" | "discretionary";
203
204
  evidence_refs: string[];
204
205
  artifact_kind: string;
205
206
  artifact_id: string;
206
- purpose: "required" | "discretionary";
207
207
  reader_question_refs: string[];
208
208
  }, {
209
+ purpose: "required" | "discretionary";
209
210
  evidence_refs: string[];
210
211
  artifact_kind: string;
211
212
  artifact_id: string;
212
- purpose: "required" | "discretionary";
213
213
  reader_question_refs: string[];
214
214
  }>, z.ZodObject<{
215
215
  artifact_id: z.ZodEffects<z.ZodString, string, string>;
@@ -232,10 +232,10 @@ export declare const indexerArtifactBundleSchema: z.ZodObject<{
232
232
  end_key: string;
233
233
  }>;
234
234
  }, "strict", z.ZodTypeAny, {
235
+ purpose: "semantic-split";
235
236
  evidence_refs: string[];
236
237
  artifact_kind: string;
237
238
  artifact_id: string;
238
- purpose: "semantic-split";
239
239
  reader_question_refs: string[];
240
240
  split_of: string;
241
241
  boundary: {
@@ -244,10 +244,10 @@ export declare const indexerArtifactBundleSchema: z.ZodObject<{
244
244
  end_key: string;
245
245
  };
246
246
  }, {
247
+ purpose: "semantic-split";
247
248
  evidence_refs: string[];
248
249
  artifact_kind: string;
249
250
  artifact_id: string;
250
- purpose: "semantic-split";
251
251
  reader_question_refs: string[];
252
252
  split_of: string;
253
253
  boundary: {
@@ -264,16 +264,16 @@ export declare const indexerArtifactBundleSchema: z.ZodObject<{
264
264
  protocol: "context.indexer.artifact-bundle/v1";
265
265
  artifact_policy_variant: string;
266
266
  artifacts: ({
267
+ purpose: "required" | "discretionary";
267
268
  evidence_refs: string[];
268
269
  artifact_kind: string;
269
270
  artifact_id: string;
270
- purpose: "required" | "discretionary";
271
271
  reader_question_refs: string[];
272
272
  } | {
273
+ purpose: "semantic-split";
273
274
  evidence_refs: string[];
274
275
  artifact_kind: string;
275
276
  artifact_id: string;
276
- purpose: "semantic-split";
277
277
  reader_question_refs: string[];
278
278
  split_of: string;
279
279
  boundary: {
@@ -290,16 +290,16 @@ export declare const indexerArtifactBundleSchema: z.ZodObject<{
290
290
  protocol: "context.indexer.artifact-bundle/v1";
291
291
  artifact_policy_variant: string;
292
292
  artifacts: ({
293
+ purpose: "required" | "discretionary";
293
294
  evidence_refs: string[];
294
295
  artifact_kind: string;
295
296
  artifact_id: string;
296
- purpose: "required" | "discretionary";
297
297
  reader_question_refs: string[];
298
298
  } | {
299
+ purpose: "semantic-split";
299
300
  evidence_refs: string[];
300
301
  artifact_kind: string;
301
302
  artifact_id: string;
302
- purpose: "semantic-split";
303
303
  reader_question_refs: string[];
304
304
  split_of: string;
305
305
  boundary: {