@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
@@ -179,21 +179,25 @@ export declare function validateIndexerTargetResolutionView(value: unknown): Ind
179
179
  export declare const indexerRepairIntentSchema: z.ZodObject<{
180
180
  target_ref: z.ZodString;
181
181
  instruction: z.ZodString;
182
+ current_markdown: z.ZodOptional<z.ZodString>;
182
183
  } & {
183
184
  intent_digest: z.ZodString;
184
185
  }, "strict", z.ZodTypeAny, {
185
186
  target_ref: string;
186
187
  instruction: string;
187
188
  intent_digest: string;
189
+ current_markdown?: string | undefined;
188
190
  }, {
189
191
  target_ref: string;
190
192
  instruction: string;
191
193
  intent_digest: string;
194
+ current_markdown?: string | undefined;
192
195
  }>;
193
196
  export type IndexerRepairIntent = z.infer<typeof indexerRepairIntentSchema>;
194
197
  export declare function buildIndexerRepairIntent(input: {
195
198
  target_ref: string;
196
199
  instruction: string;
200
+ current_markdown?: string;
197
201
  }): IndexerRepairIntent;
198
202
  export declare function validateIndexerRepairIntent(value: unknown): IndexerRepairIntent;
199
203
  declare const partitionWorksetSchema: z.ZodEffects<z.ZodObject<{
@@ -239,16 +243,19 @@ declare const partitionWorksetSchema: z.ZodEffects<z.ZodObject<{
239
243
  repair_intent: z.ZodOptional<z.ZodObject<{
240
244
  target_ref: z.ZodString;
241
245
  instruction: z.ZodString;
246
+ current_markdown: z.ZodOptional<z.ZodString>;
242
247
  } & {
243
248
  intent_digest: z.ZodString;
244
249
  }, "strict", z.ZodTypeAny, {
245
250
  target_ref: string;
246
251
  instruction: string;
247
252
  intent_digest: string;
253
+ current_markdown?: string | undefined;
248
254
  }, {
249
255
  target_ref: string;
250
256
  instruction: string;
251
257
  intent_digest: string;
258
+ current_markdown?: string | undefined;
252
259
  }>>;
253
260
  }, "strict", z.ZodTypeAny, {
254
261
  source_ref: string;
@@ -284,6 +291,7 @@ declare const partitionWorksetSchema: z.ZodEffects<z.ZodObject<{
284
291
  target_ref: string;
285
292
  instruction: string;
286
293
  intent_digest: string;
294
+ current_markdown?: string | undefined;
287
295
  } | undefined;
288
296
  }, {
289
297
  source_ref: string;
@@ -319,6 +327,7 @@ declare const partitionWorksetSchema: z.ZodEffects<z.ZodObject<{
319
327
  target_ref: string;
320
328
  instruction: string;
321
329
  intent_digest: string;
330
+ current_markdown?: string | undefined;
322
331
  } | undefined;
323
332
  }>, {
324
333
  source_ref: string;
@@ -354,6 +363,7 @@ declare const partitionWorksetSchema: z.ZodEffects<z.ZodObject<{
354
363
  target_ref: string;
355
364
  instruction: string;
356
365
  intent_digest: string;
366
+ current_markdown?: string | undefined;
357
367
  } | undefined;
358
368
  }, {
359
369
  source_ref: string;
@@ -389,6 +399,7 @@ declare const partitionWorksetSchema: z.ZodEffects<z.ZodObject<{
389
399
  target_ref: string;
390
400
  instruction: string;
391
401
  intent_digest: string;
402
+ current_markdown?: string | undefined;
392
403
  } | undefined;
393
404
  }>;
394
405
  declare const authorWorksetSchema: z.ZodEffects<z.ZodObject<{
@@ -595,16 +606,19 @@ declare const authorWorksetSchema: z.ZodEffects<z.ZodObject<{
595
606
  repair_intent: z.ZodOptional<z.ZodObject<{
596
607
  target_ref: z.ZodString;
597
608
  instruction: z.ZodString;
609
+ current_markdown: z.ZodOptional<z.ZodString>;
598
610
  } & {
599
611
  intent_digest: z.ZodString;
600
612
  }, "strict", z.ZodTypeAny, {
601
613
  target_ref: string;
602
614
  instruction: string;
603
615
  intent_digest: string;
616
+ current_markdown?: string | undefined;
604
617
  }, {
605
618
  target_ref: string;
606
619
  instruction: string;
607
620
  intent_digest: string;
621
+ current_markdown?: string | undefined;
608
622
  }>>;
609
623
  }, "strict", z.ZodTypeAny, {
610
624
  source_ref: string;
@@ -638,6 +652,7 @@ declare const authorWorksetSchema: z.ZodEffects<z.ZodObject<{
638
652
  target_ref: string;
639
653
  instruction: string;
640
654
  intent_digest: string;
655
+ current_markdown?: string | undefined;
641
656
  } | undefined;
642
657
  target_resolution_view?: {
643
658
  entries: ({
@@ -696,6 +711,7 @@ declare const authorWorksetSchema: z.ZodEffects<z.ZodObject<{
696
711
  target_ref: string;
697
712
  instruction: string;
698
713
  intent_digest: string;
714
+ current_markdown?: string | undefined;
699
715
  } | undefined;
700
716
  target_resolution_view?: {
701
717
  entries: ({
@@ -754,6 +770,7 @@ declare const authorWorksetSchema: z.ZodEffects<z.ZodObject<{
754
770
  target_ref: string;
755
771
  instruction: string;
756
772
  intent_digest: string;
773
+ current_markdown?: string | undefined;
757
774
  } | undefined;
758
775
  target_resolution_view?: {
759
776
  entries: ({
@@ -812,6 +829,7 @@ declare const authorWorksetSchema: z.ZodEffects<z.ZodObject<{
812
829
  target_ref: string;
813
830
  instruction: string;
814
831
  intent_digest: string;
832
+ current_markdown?: string | undefined;
815
833
  } | undefined;
816
834
  target_resolution_view?: {
817
835
  entries: ({
@@ -882,16 +900,19 @@ export declare const indexerMainWorksetSchema: z.ZodUnion<[z.ZodEffects<z.ZodObj
882
900
  repair_intent: z.ZodOptional<z.ZodObject<{
883
901
  target_ref: z.ZodString;
884
902
  instruction: z.ZodString;
903
+ current_markdown: z.ZodOptional<z.ZodString>;
885
904
  } & {
886
905
  intent_digest: z.ZodString;
887
906
  }, "strict", z.ZodTypeAny, {
888
907
  target_ref: string;
889
908
  instruction: string;
890
909
  intent_digest: string;
910
+ current_markdown?: string | undefined;
891
911
  }, {
892
912
  target_ref: string;
893
913
  instruction: string;
894
914
  intent_digest: string;
915
+ current_markdown?: string | undefined;
895
916
  }>>;
896
917
  }, "strict", z.ZodTypeAny, {
897
918
  source_ref: string;
@@ -927,6 +948,7 @@ export declare const indexerMainWorksetSchema: z.ZodUnion<[z.ZodEffects<z.ZodObj
927
948
  target_ref: string;
928
949
  instruction: string;
929
950
  intent_digest: string;
951
+ current_markdown?: string | undefined;
930
952
  } | undefined;
931
953
  }, {
932
954
  source_ref: string;
@@ -962,6 +984,7 @@ export declare const indexerMainWorksetSchema: z.ZodUnion<[z.ZodEffects<z.ZodObj
962
984
  target_ref: string;
963
985
  instruction: string;
964
986
  intent_digest: string;
987
+ current_markdown?: string | undefined;
965
988
  } | undefined;
966
989
  }>, {
967
990
  source_ref: string;
@@ -997,6 +1020,7 @@ export declare const indexerMainWorksetSchema: z.ZodUnion<[z.ZodEffects<z.ZodObj
997
1020
  target_ref: string;
998
1021
  instruction: string;
999
1022
  intent_digest: string;
1023
+ current_markdown?: string | undefined;
1000
1024
  } | undefined;
1001
1025
  }, {
1002
1026
  source_ref: string;
@@ -1032,6 +1056,7 @@ export declare const indexerMainWorksetSchema: z.ZodUnion<[z.ZodEffects<z.ZodObj
1032
1056
  target_ref: string;
1033
1057
  instruction: string;
1034
1058
  intent_digest: string;
1059
+ current_markdown?: string | undefined;
1035
1060
  } | undefined;
1036
1061
  }>, z.ZodEffects<z.ZodObject<{
1037
1062
  stage: z.ZodLiteral<"author">;
@@ -1237,16 +1262,19 @@ export declare const indexerMainWorksetSchema: z.ZodUnion<[z.ZodEffects<z.ZodObj
1237
1262
  repair_intent: z.ZodOptional<z.ZodObject<{
1238
1263
  target_ref: z.ZodString;
1239
1264
  instruction: z.ZodString;
1265
+ current_markdown: z.ZodOptional<z.ZodString>;
1240
1266
  } & {
1241
1267
  intent_digest: z.ZodString;
1242
1268
  }, "strict", z.ZodTypeAny, {
1243
1269
  target_ref: string;
1244
1270
  instruction: string;
1245
1271
  intent_digest: string;
1272
+ current_markdown?: string | undefined;
1246
1273
  }, {
1247
1274
  target_ref: string;
1248
1275
  instruction: string;
1249
1276
  intent_digest: string;
1277
+ current_markdown?: string | undefined;
1250
1278
  }>>;
1251
1279
  }, "strict", z.ZodTypeAny, {
1252
1280
  source_ref: string;
@@ -1280,6 +1308,7 @@ export declare const indexerMainWorksetSchema: z.ZodUnion<[z.ZodEffects<z.ZodObj
1280
1308
  target_ref: string;
1281
1309
  instruction: string;
1282
1310
  intent_digest: string;
1311
+ current_markdown?: string | undefined;
1283
1312
  } | undefined;
1284
1313
  target_resolution_view?: {
1285
1314
  entries: ({
@@ -1338,6 +1367,7 @@ export declare const indexerMainWorksetSchema: z.ZodUnion<[z.ZodEffects<z.ZodObj
1338
1367
  target_ref: string;
1339
1368
  instruction: string;
1340
1369
  intent_digest: string;
1370
+ current_markdown?: string | undefined;
1341
1371
  } | undefined;
1342
1372
  target_resolution_view?: {
1343
1373
  entries: ({
@@ -1396,6 +1426,7 @@ export declare const indexerMainWorksetSchema: z.ZodUnion<[z.ZodEffects<z.ZodObj
1396
1426
  target_ref: string;
1397
1427
  instruction: string;
1398
1428
  intent_digest: string;
1429
+ current_markdown?: string | undefined;
1399
1430
  } | undefined;
1400
1431
  target_resolution_view?: {
1401
1432
  entries: ({
@@ -1454,6 +1485,7 @@ export declare const indexerMainWorksetSchema: z.ZodUnion<[z.ZodEffects<z.ZodObj
1454
1485
  target_ref: string;
1455
1486
  instruction: string;
1456
1487
  intent_digest: string;
1488
+ current_markdown?: string | undefined;
1457
1489
  } | undefined;
1458
1490
  target_resolution_view?: {
1459
1491
  entries: ({
@@ -1598,16 +1630,19 @@ export declare const indexerMainTransportBatchSchema: z.ZodObject<{
1598
1630
  repair_intent: z.ZodOptional<z.ZodObject<{
1599
1631
  target_ref: z.ZodString;
1600
1632
  instruction: z.ZodString;
1633
+ current_markdown: z.ZodOptional<z.ZodString>;
1601
1634
  } & {
1602
1635
  intent_digest: z.ZodString;
1603
1636
  }, "strict", z.ZodTypeAny, {
1604
1637
  target_ref: string;
1605
1638
  instruction: string;
1606
1639
  intent_digest: string;
1640
+ current_markdown?: string | undefined;
1607
1641
  }, {
1608
1642
  target_ref: string;
1609
1643
  instruction: string;
1610
1644
  intent_digest: string;
1645
+ current_markdown?: string | undefined;
1611
1646
  }>>;
1612
1647
  }, "strict", z.ZodTypeAny, {
1613
1648
  source_ref: string;
@@ -1643,6 +1678,7 @@ export declare const indexerMainTransportBatchSchema: z.ZodObject<{
1643
1678
  target_ref: string;
1644
1679
  instruction: string;
1645
1680
  intent_digest: string;
1681
+ current_markdown?: string | undefined;
1646
1682
  } | undefined;
1647
1683
  }, {
1648
1684
  source_ref: string;
@@ -1678,6 +1714,7 @@ export declare const indexerMainTransportBatchSchema: z.ZodObject<{
1678
1714
  target_ref: string;
1679
1715
  instruction: string;
1680
1716
  intent_digest: string;
1717
+ current_markdown?: string | undefined;
1681
1718
  } | undefined;
1682
1719
  }>, {
1683
1720
  source_ref: string;
@@ -1713,6 +1750,7 @@ export declare const indexerMainTransportBatchSchema: z.ZodObject<{
1713
1750
  target_ref: string;
1714
1751
  instruction: string;
1715
1752
  intent_digest: string;
1753
+ current_markdown?: string | undefined;
1716
1754
  } | undefined;
1717
1755
  }, {
1718
1756
  source_ref: string;
@@ -1748,6 +1786,7 @@ export declare const indexerMainTransportBatchSchema: z.ZodObject<{
1748
1786
  target_ref: string;
1749
1787
  instruction: string;
1750
1788
  intent_digest: string;
1789
+ current_markdown?: string | undefined;
1751
1790
  } | undefined;
1752
1791
  }>, z.ZodEffects<z.ZodObject<{
1753
1792
  stage: z.ZodLiteral<"author">;
@@ -1953,16 +1992,19 @@ export declare const indexerMainTransportBatchSchema: z.ZodObject<{
1953
1992
  repair_intent: z.ZodOptional<z.ZodObject<{
1954
1993
  target_ref: z.ZodString;
1955
1994
  instruction: z.ZodString;
1995
+ current_markdown: z.ZodOptional<z.ZodString>;
1956
1996
  } & {
1957
1997
  intent_digest: z.ZodString;
1958
1998
  }, "strict", z.ZodTypeAny, {
1959
1999
  target_ref: string;
1960
2000
  instruction: string;
1961
2001
  intent_digest: string;
2002
+ current_markdown?: string | undefined;
1962
2003
  }, {
1963
2004
  target_ref: string;
1964
2005
  instruction: string;
1965
2006
  intent_digest: string;
2007
+ current_markdown?: string | undefined;
1966
2008
  }>>;
1967
2009
  }, "strict", z.ZodTypeAny, {
1968
2010
  source_ref: string;
@@ -1996,6 +2038,7 @@ export declare const indexerMainTransportBatchSchema: z.ZodObject<{
1996
2038
  target_ref: string;
1997
2039
  instruction: string;
1998
2040
  intent_digest: string;
2041
+ current_markdown?: string | undefined;
1999
2042
  } | undefined;
2000
2043
  target_resolution_view?: {
2001
2044
  entries: ({
@@ -2054,6 +2097,7 @@ export declare const indexerMainTransportBatchSchema: z.ZodObject<{
2054
2097
  target_ref: string;
2055
2098
  instruction: string;
2056
2099
  intent_digest: string;
2100
+ current_markdown?: string | undefined;
2057
2101
  } | undefined;
2058
2102
  target_resolution_view?: {
2059
2103
  entries: ({
@@ -2112,6 +2156,7 @@ export declare const indexerMainTransportBatchSchema: z.ZodObject<{
2112
2156
  target_ref: string;
2113
2157
  instruction: string;
2114
2158
  intent_digest: string;
2159
+ current_markdown?: string | undefined;
2115
2160
  } | undefined;
2116
2161
  target_resolution_view?: {
2117
2162
  entries: ({
@@ -2170,6 +2215,7 @@ export declare const indexerMainTransportBatchSchema: z.ZodObject<{
2170
2215
  target_ref: string;
2171
2216
  instruction: string;
2172
2217
  intent_digest: string;
2218
+ current_markdown?: string | undefined;
2173
2219
  } | undefined;
2174
2220
  target_resolution_view?: {
2175
2221
  entries: ({
@@ -2233,6 +2279,7 @@ export declare const indexerMainTransportBatchSchema: z.ZodObject<{
2233
2279
  target_ref: string;
2234
2280
  instruction: string;
2235
2281
  intent_digest: string;
2282
+ current_markdown?: string | undefined;
2236
2283
  } | undefined;
2237
2284
  } | {
2238
2285
  source_ref: string;
@@ -2266,6 +2313,7 @@ export declare const indexerMainTransportBatchSchema: z.ZodObject<{
2266
2313
  target_ref: string;
2267
2314
  instruction: string;
2268
2315
  intent_digest: string;
2316
+ current_markdown?: string | undefined;
2269
2317
  } | undefined;
2270
2318
  target_resolution_view?: {
2271
2319
  entries: ({
@@ -2329,6 +2377,7 @@ export declare const indexerMainTransportBatchSchema: z.ZodObject<{
2329
2377
  target_ref: string;
2330
2378
  instruction: string;
2331
2379
  intent_digest: string;
2380
+ current_markdown?: string | undefined;
2332
2381
  } | undefined;
2333
2382
  } | {
2334
2383
  source_ref: string;
@@ -2362,6 +2411,7 @@ export declare const indexerMainTransportBatchSchema: z.ZodObject<{
2362
2411
  target_ref: string;
2363
2412
  instruction: string;
2364
2413
  intent_digest: string;
2414
+ current_markdown?: string | undefined;
2365
2415
  } | undefined;
2366
2416
  target_resolution_view?: {
2367
2417
  entries: ({
@@ -14,8 +14,8 @@ export declare const indexerNavigationArtifactPlanSchema: z.ZodObject<{
14
14
  output_path: string;
15
15
  artifact_kind: string;
16
16
  artifact_id: string;
17
- plan_digest: string;
18
17
  artifact_ref: string;
18
+ plan_digest: string;
19
19
  navigation_ref: string;
20
20
  child_artifact_refs: string[];
21
21
  }, {
@@ -23,8 +23,8 @@ export declare const indexerNavigationArtifactPlanSchema: z.ZodObject<{
23
23
  output_path: string;
24
24
  artifact_kind: string;
25
25
  artifact_id: string;
26
- plan_digest: string;
27
26
  artifact_ref: string;
27
+ plan_digest: string;
28
28
  navigation_ref: string;
29
29
  child_artifact_refs: string[];
30
30
  }>;