@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
@@ -0,0 +1,16 @@
1
+ import type { IndexerArtifactResult } from "./indexerArtifactResult.js";
2
+ import { type IndexerAuthorDependencyView } from "./indexerDependencyView.js";
3
+ import type { IndexerMainAuthorWorkset } from "./indexerMainWorkset.js";
4
+ export declare function compositionFactDependencies(input: {
5
+ composition_input: unknown;
6
+ workset: IndexerMainAuthorWorkset;
7
+ dependency_view: IndexerAuthorDependencyView;
8
+ result: IndexerArtifactResult;
9
+ }): {
10
+ node_ref: string;
11
+ kind: "selected-fact";
12
+ fact_ref: string;
13
+ fact_digest: string;
14
+ source_span_node_refs: string[];
15
+ targets: never[];
16
+ }[];
@@ -45,21 +45,21 @@ export declare const indexerArtifactFactSchema: z.ZodObject<{
45
45
  };
46
46
  evidence_refs: string[];
47
47
  }>;
48
- export declare const indexerDeterministicBlockRendererSchema: z.ZodEnum<["bullet-list", "key-value-table", "json-code-block"]>;
48
+ export declare const indexerDeterministicBlockRendererSchema: z.ZodEnum<["bullet-list", "key-value-table", "multi-column-table", "public-contract-table", "json-code-block"]>;
49
49
  export declare const indexerArtifactContentBlockSchema: z.ZodDiscriminatedUnion<"layer", [z.ZodObject<{
50
50
  block_id: z.ZodEffects<z.ZodString, string, string>;
51
51
  layer: z.ZodLiteral<"deterministic-block">;
52
- renderer: z.ZodEnum<["bullet-list", "key-value-table", "json-code-block"]>;
52
+ renderer: z.ZodEnum<["bullet-list", "key-value-table", "multi-column-table", "public-contract-table", "json-code-block"]>;
53
53
  fact_refs: z.ZodArray<z.ZodString, "many">;
54
54
  }, "strict", z.ZodTypeAny, {
55
55
  block_id: string;
56
56
  layer: "deterministic-block";
57
- renderer: "bullet-list" | "key-value-table" | "json-code-block";
57
+ renderer: "bullet-list" | "key-value-table" | "multi-column-table" | "public-contract-table" | "json-code-block";
58
58
  fact_refs: string[];
59
59
  }, {
60
60
  block_id: string;
61
61
  layer: "deterministic-block";
62
- renderer: "bullet-list" | "key-value-table" | "json-code-block";
62
+ renderer: "bullet-list" | "key-value-table" | "multi-column-table" | "public-contract-table" | "json-code-block";
63
63
  fact_refs: string[];
64
64
  }>, z.ZodObject<{
65
65
  block_id: z.ZodEffects<z.ZodString, string, string>;
@@ -121,6 +121,7 @@ export declare function projectIndexerFactValue(facts: readonly IndexerArtifactF
121
121
  export declare function renderIndexerDeterministicFacts(input: {
122
122
  renderer: IndexerDeterministicBlockRenderer;
123
123
  facts: readonly IndexerArtifactFact[];
124
+ supporting_facts?: readonly IndexerArtifactFact[];
124
125
  }): string;
125
126
  export declare function indexerRenderedContentBlockDigest(value: z.infer<typeof renderedContentBlockPayloadSchema>): string;
126
127
  export declare function buildIndexerRenderedContentBlock(input: {
@@ -133,5 +134,6 @@ export declare function validateIndexerRenderedContentBlock(value: unknown): Ind
133
134
  export declare function materializeIndexerStructuredContent(input: {
134
135
  blocks: readonly IndexerArtifactContentBlock[];
135
136
  facts: readonly IndexerArtifactFact[];
137
+ render_cache?: Map<string, IndexerRenderedContentBlock[]> | undefined;
136
138
  }): IndexerRenderedContentBlock[];
137
139
  export {};
@@ -0,0 +1,3 @@
1
+ /** Compact only information already represented in API rows. Unknown syntax
2
+ * and unique comments remain available; this is not a TypeScript evaluator. */
3
+ export declare function compactContractDeclaration(raw: string, rows: string[][]): string | undefined;