@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
@@ -63,6 +63,7 @@ export declare const indexerApprovedLayoutProjectionSchema: z.ZodObject<{
63
63
  section_identity_ref: string;
64
64
  }>, "many">;
65
65
  }, "strict", z.ZodTypeAny, {
66
+ purpose: "required" | "discretionary" | "semantic-split";
66
67
  output_path: string;
67
68
  artifact_kind: string;
68
69
  artifact_id: string;
@@ -71,7 +72,6 @@ export declare const indexerApprovedLayoutProjectionSchema: z.ZodObject<{
71
72
  section_identity_ref: string;
72
73
  }[];
73
74
  collection: import("./contracts.js").TopLevelNamespace;
74
- purpose: "required" | "discretionary" | "semantic-split";
75
75
  artifact_ref: string;
76
76
  shared_artifact_fingerprint_digest: string;
77
77
  split_of_artifact_ref: string | null;
@@ -81,6 +81,7 @@ export declare const indexerApprovedLayoutProjectionSchema: z.ZodObject<{
81
81
  end_key: string;
82
82
  } | null;
83
83
  }, {
84
+ purpose: "required" | "discretionary" | "semantic-split";
84
85
  output_path: string;
85
86
  artifact_kind: string;
86
87
  artifact_id: string;
@@ -89,7 +90,6 @@ export declare const indexerApprovedLayoutProjectionSchema: z.ZodObject<{
89
90
  section_identity_ref: string;
90
91
  }[];
91
92
  collection: import("./contracts.js").TopLevelNamespace;
92
- purpose: "required" | "discretionary" | "semantic-split";
93
93
  artifact_ref: string;
94
94
  shared_artifact_fingerprint_digest: string;
95
95
  split_of_artifact_ref: string | null;
@@ -105,6 +105,7 @@ export declare const indexerApprovedLayoutProjectionSchema: z.ZodObject<{
105
105
  protocol: "context.indexer.approved-layout-projection/v1";
106
106
  profile: string;
107
107
  artifacts: {
108
+ purpose: "required" | "discretionary" | "semantic-split";
108
109
  output_path: string;
109
110
  artifact_kind: string;
110
111
  artifact_id: string;
@@ -113,7 +114,6 @@ export declare const indexerApprovedLayoutProjectionSchema: z.ZodObject<{
113
114
  section_identity_ref: string;
114
115
  }[];
115
116
  collection: import("./contracts.js").TopLevelNamespace;
116
- purpose: "required" | "discretionary" | "semantic-split";
117
117
  artifact_ref: string;
118
118
  shared_artifact_fingerprint_digest: string;
119
119
  split_of_artifact_ref: string | null;
@@ -141,6 +141,7 @@ export declare const indexerApprovedLayoutProjectionSchema: z.ZodObject<{
141
141
  protocol: "context.indexer.approved-layout-projection/v1";
142
142
  profile: string;
143
143
  artifacts: {
144
+ purpose: "required" | "discretionary" | "semantic-split";
144
145
  output_path: string;
145
146
  artifact_kind: string;
146
147
  artifact_id: string;
@@ -149,7 +150,6 @@ export declare const indexerApprovedLayoutProjectionSchema: z.ZodObject<{
149
150
  section_identity_ref: string;
150
151
  }[];
151
152
  collection: import("./contracts.js").TopLevelNamespace;
152
- purpose: "required" | "discretionary" | "semantic-split";
153
153
  artifact_ref: string;
154
154
  shared_artifact_fingerprint_digest: string;
155
155
  split_of_artifact_ref: string | null;
@@ -228,8 +228,6 @@ export declare const indexerLayoutChangeReportSchema: z.ZodObject<{
228
228
  } & {
229
229
  report_digest: z.ZodString;
230
230
  }, "strict", z.ZodTypeAny, {
231
- protocol: "context.indexer.layout-change-report/v1";
232
- report_digest: string;
233
231
  changes: {
234
232
  kind: "artifact-added" | "artifact-removed" | "artifact-split" | "artifact-merge" | "artifact-rename" | "section-move" | "collection-move" | "path-move";
235
233
  artifact_ref: string;
@@ -241,6 +239,8 @@ export declare const indexerLayoutChangeReportSchema: z.ZodObject<{
241
239
  after_path: string | null;
242
240
  confirmation_class: "ambiguous" | "compatible-addition" | "destructive";
243
241
  }[];
242
+ protocol: "context.indexer.layout-change-report/v1";
243
+ report_digest: string;
244
244
  gate: {
245
245
  id: "confirm-layout-change";
246
246
  authority: "human";
@@ -251,8 +251,6 @@ export declare const indexerLayoutChangeReportSchema: z.ZodObject<{
251
251
  reused_artifact_refs: string[];
252
252
  requires_confirmation: boolean;
253
253
  }, {
254
- protocol: "context.indexer.layout-change-report/v1";
255
- report_digest: string;
256
254
  changes: {
257
255
  kind: "artifact-added" | "artifact-removed" | "artifact-split" | "artifact-merge" | "artifact-rename" | "section-move" | "collection-move" | "path-move";
258
256
  artifact_ref: string;
@@ -264,6 +262,8 @@ export declare const indexerLayoutChangeReportSchema: z.ZodObject<{
264
262
  after_path: string | null;
265
263
  confirmation_class: "ambiguous" | "compatible-addition" | "destructive";
266
264
  }[];
265
+ protocol: "context.indexer.layout-change-report/v1";
266
+ report_digest: string;
267
267
  gate: {
268
268
  id: "confirm-layout-change";
269
269
  authority: "human";
@@ -135,6 +135,7 @@ export declare const indexerLayoutProposalSetSchema: z.ZodObject<{
135
135
  collection_resolution_digest: string;
136
136
  }>, "many">;
137
137
  }, "strict", z.ZodTypeAny, {
138
+ purpose: "required" | "discretionary" | "semantic-split";
138
139
  output_path: string;
139
140
  artifact_kind: string;
140
141
  artifact_id: string;
@@ -153,7 +154,6 @@ export declare const indexerLayoutProposalSetSchema: z.ZodObject<{
153
154
  collection_resolution_digest: string;
154
155
  }[];
155
156
  collection: import("./contracts.js").TopLevelNamespace;
156
- purpose: "required" | "discretionary" | "semantic-split";
157
157
  node_ref: string;
158
158
  artifact_ref: string;
159
159
  internal_view_ref: string;
@@ -165,6 +165,7 @@ export declare const indexerLayoutProposalSetSchema: z.ZodObject<{
165
165
  end_key: string;
166
166
  } | null;
167
167
  }, {
168
+ purpose: "required" | "discretionary" | "semantic-split";
168
169
  output_path: string;
169
170
  artifact_kind: string;
170
171
  artifact_id: string;
@@ -183,7 +184,6 @@ export declare const indexerLayoutProposalSetSchema: z.ZodObject<{
183
184
  collection_resolution_digest: string;
184
185
  }[];
185
186
  collection: import("./contracts.js").TopLevelNamespace;
186
- purpose: "required" | "discretionary" | "semantic-split";
187
187
  node_ref: string;
188
188
  artifact_ref: string;
189
189
  internal_view_ref: string;
@@ -195,6 +195,7 @@ export declare const indexerLayoutProposalSetSchema: z.ZodObject<{
195
195
  end_key: string;
196
196
  } | null;
197
197
  }>, "many">;
198
+ delivery_artifact_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
198
199
  } & {
199
200
  proposal_digest: z.ZodString;
200
201
  }, "strict", z.ZodTypeAny, {
@@ -211,6 +212,7 @@ export declare const indexerLayoutProposalSetSchema: z.ZodObject<{
211
212
  node_ref: string;
212
213
  };
213
214
  artifacts: {
215
+ purpose: "required" | "discretionary" | "semantic-split";
214
216
  output_path: string;
215
217
  artifact_kind: string;
216
218
  artifact_id: string;
@@ -229,7 +231,6 @@ export declare const indexerLayoutProposalSetSchema: z.ZodObject<{
229
231
  collection_resolution_digest: string;
230
232
  }[];
231
233
  collection: import("./contracts.js").TopLevelNamespace;
232
- purpose: "required" | "discretionary" | "semantic-split";
233
234
  node_ref: string;
234
235
  artifact_ref: string;
235
236
  internal_view_ref: string;
@@ -244,7 +245,6 @@ export declare const indexerLayoutProposalSetSchema: z.ZodObject<{
244
245
  indexer_id: string;
245
246
  profile_contract_digest: string;
246
247
  subject_key_schema_digest: string;
247
- artifact_result_digest: string;
248
248
  shared_artifact_fingerprint: {
249
249
  protocol: "context.indexer.shared-artifact-fingerprint/v1";
250
250
  indexer_id: string;
@@ -255,7 +255,9 @@ export declare const indexerLayoutProposalSetSchema: z.ZodObject<{
255
255
  };
256
256
  proposal_digest: string;
257
257
  subject_key_schema_set_digest: string;
258
+ artifact_result_digest: string;
258
259
  post_author_composition_fingerprint: string | null;
260
+ delivery_artifact_ids?: string[] | undefined;
259
261
  }, {
260
262
  source_ref: string;
261
263
  protocol: "context.indexer.layout-proposal/v1";
@@ -270,6 +272,7 @@ export declare const indexerLayoutProposalSetSchema: z.ZodObject<{
270
272
  node_ref: string;
271
273
  };
272
274
  artifacts: {
275
+ purpose: "required" | "discretionary" | "semantic-split";
273
276
  output_path: string;
274
277
  artifact_kind: string;
275
278
  artifact_id: string;
@@ -288,7 +291,6 @@ export declare const indexerLayoutProposalSetSchema: z.ZodObject<{
288
291
  collection_resolution_digest: string;
289
292
  }[];
290
293
  collection: import("./contracts.js").TopLevelNamespace;
291
- purpose: "required" | "discretionary" | "semantic-split";
292
294
  node_ref: string;
293
295
  artifact_ref: string;
294
296
  internal_view_ref: string;
@@ -303,7 +305,6 @@ export declare const indexerLayoutProposalSetSchema: z.ZodObject<{
303
305
  indexer_id: string;
304
306
  profile_contract_digest: string;
305
307
  subject_key_schema_digest: string;
306
- artifact_result_digest: string;
307
308
  shared_artifact_fingerprint: {
308
309
  protocol: "context.indexer.shared-artifact-fingerprint/v1";
309
310
  indexer_id: string;
@@ -314,7 +315,9 @@ export declare const indexerLayoutProposalSetSchema: z.ZodObject<{
314
315
  };
315
316
  proposal_digest: string;
316
317
  subject_key_schema_set_digest: string;
318
+ artifact_result_digest: string;
317
319
  post_author_composition_fingerprint: string | null;
320
+ delivery_artifact_ids?: string[] | undefined;
318
321
  }>, "many">;
319
322
  } & {
320
323
  set_digest: z.ZodString;
@@ -334,6 +337,7 @@ export declare const indexerLayoutProposalSetSchema: z.ZodObject<{
334
337
  node_ref: string;
335
338
  };
336
339
  artifacts: {
340
+ purpose: "required" | "discretionary" | "semantic-split";
337
341
  output_path: string;
338
342
  artifact_kind: string;
339
343
  artifact_id: string;
@@ -352,7 +356,6 @@ export declare const indexerLayoutProposalSetSchema: z.ZodObject<{
352
356
  collection_resolution_digest: string;
353
357
  }[];
354
358
  collection: import("./contracts.js").TopLevelNamespace;
355
- purpose: "required" | "discretionary" | "semantic-split";
356
359
  node_ref: string;
357
360
  artifact_ref: string;
358
361
  internal_view_ref: string;
@@ -367,7 +370,6 @@ export declare const indexerLayoutProposalSetSchema: z.ZodObject<{
367
370
  indexer_id: string;
368
371
  profile_contract_digest: string;
369
372
  subject_key_schema_digest: string;
370
- artifact_result_digest: string;
371
373
  shared_artifact_fingerprint: {
372
374
  protocol: "context.indexer.shared-artifact-fingerprint/v1";
373
375
  indexer_id: string;
@@ -378,7 +380,9 @@ export declare const indexerLayoutProposalSetSchema: z.ZodObject<{
378
380
  };
379
381
  proposal_digest: string;
380
382
  subject_key_schema_set_digest: string;
383
+ artifact_result_digest: string;
381
384
  post_author_composition_fingerprint: string | null;
385
+ delivery_artifact_ids?: string[] | undefined;
382
386
  }[];
383
387
  set_digest: string;
384
388
  subject_key_schema_set_digest: string;
@@ -398,6 +402,7 @@ export declare const indexerLayoutProposalSetSchema: z.ZodObject<{
398
402
  node_ref: string;
399
403
  };
400
404
  artifacts: {
405
+ purpose: "required" | "discretionary" | "semantic-split";
401
406
  output_path: string;
402
407
  artifact_kind: string;
403
408
  artifact_id: string;
@@ -416,7 +421,6 @@ export declare const indexerLayoutProposalSetSchema: z.ZodObject<{
416
421
  collection_resolution_digest: string;
417
422
  }[];
418
423
  collection: import("./contracts.js").TopLevelNamespace;
419
- purpose: "required" | "discretionary" | "semantic-split";
420
424
  node_ref: string;
421
425
  artifact_ref: string;
422
426
  internal_view_ref: string;
@@ -431,7 +435,6 @@ export declare const indexerLayoutProposalSetSchema: z.ZodObject<{
431
435
  indexer_id: string;
432
436
  profile_contract_digest: string;
433
437
  subject_key_schema_digest: string;
434
- artifact_result_digest: string;
435
438
  shared_artifact_fingerprint: {
436
439
  protocol: "context.indexer.shared-artifact-fingerprint/v1";
437
440
  indexer_id: string;
@@ -442,7 +445,9 @@ export declare const indexerLayoutProposalSetSchema: z.ZodObject<{
442
445
  };
443
446
  proposal_digest: string;
444
447
  subject_key_schema_set_digest: string;
448
+ artifact_result_digest: string;
445
449
  post_author_composition_fingerprint: string | null;
450
+ delivery_artifact_ids?: string[] | undefined;
446
451
  }[];
447
452
  set_digest: string;
448
453
  subject_key_schema_set_digest: string;
@@ -1,4 +1,6 @@
1
1
  import { z } from "zod";
2
+ import type { KnowledgeCollection } from "./contracts.js";
3
+ import { materializeIndexerStructuredContent } from "./indexerContentLayers.js";
2
4
  import { type IndexerRenderedArtifact } from "./indexerTemplateRendering.js";
3
5
  export declare const indexerLayoutProposalSchema: z.ZodObject<{
4
6
  protocol: z.ZodLiteral<"context.indexer.layout-proposal/v1">;
@@ -133,6 +135,7 @@ export declare const indexerLayoutProposalSchema: z.ZodObject<{
133
135
  collection_resolution_digest: string;
134
136
  }>, "many">;
135
137
  }, "strict", z.ZodTypeAny, {
138
+ purpose: "required" | "discretionary" | "semantic-split";
136
139
  output_path: string;
137
140
  artifact_kind: string;
138
141
  artifact_id: string;
@@ -151,7 +154,6 @@ export declare const indexerLayoutProposalSchema: z.ZodObject<{
151
154
  collection_resolution_digest: string;
152
155
  }[];
153
156
  collection: import("./contracts.js").TopLevelNamespace;
154
- purpose: "required" | "discretionary" | "semantic-split";
155
157
  node_ref: string;
156
158
  artifact_ref: string;
157
159
  internal_view_ref: string;
@@ -163,6 +165,7 @@ export declare const indexerLayoutProposalSchema: z.ZodObject<{
163
165
  end_key: string;
164
166
  } | null;
165
167
  }, {
168
+ purpose: "required" | "discretionary" | "semantic-split";
166
169
  output_path: string;
167
170
  artifact_kind: string;
168
171
  artifact_id: string;
@@ -181,7 +184,6 @@ export declare const indexerLayoutProposalSchema: z.ZodObject<{
181
184
  collection_resolution_digest: string;
182
185
  }[];
183
186
  collection: import("./contracts.js").TopLevelNamespace;
184
- purpose: "required" | "discretionary" | "semantic-split";
185
187
  node_ref: string;
186
188
  artifact_ref: string;
187
189
  internal_view_ref: string;
@@ -193,6 +195,7 @@ export declare const indexerLayoutProposalSchema: z.ZodObject<{
193
195
  end_key: string;
194
196
  } | null;
195
197
  }>, "many">;
198
+ delivery_artifact_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
196
199
  } & {
197
200
  proposal_digest: z.ZodString;
198
201
  }, "strict", z.ZodTypeAny, {
@@ -209,6 +212,7 @@ export declare const indexerLayoutProposalSchema: z.ZodObject<{
209
212
  node_ref: string;
210
213
  };
211
214
  artifacts: {
215
+ purpose: "required" | "discretionary" | "semantic-split";
212
216
  output_path: string;
213
217
  artifact_kind: string;
214
218
  artifact_id: string;
@@ -227,7 +231,6 @@ export declare const indexerLayoutProposalSchema: z.ZodObject<{
227
231
  collection_resolution_digest: string;
228
232
  }[];
229
233
  collection: import("./contracts.js").TopLevelNamespace;
230
- purpose: "required" | "discretionary" | "semantic-split";
231
234
  node_ref: string;
232
235
  artifact_ref: string;
233
236
  internal_view_ref: string;
@@ -242,7 +245,6 @@ export declare const indexerLayoutProposalSchema: z.ZodObject<{
242
245
  indexer_id: string;
243
246
  profile_contract_digest: string;
244
247
  subject_key_schema_digest: string;
245
- artifact_result_digest: string;
246
248
  shared_artifact_fingerprint: {
247
249
  protocol: "context.indexer.shared-artifact-fingerprint/v1";
248
250
  indexer_id: string;
@@ -253,7 +255,9 @@ export declare const indexerLayoutProposalSchema: z.ZodObject<{
253
255
  };
254
256
  proposal_digest: string;
255
257
  subject_key_schema_set_digest: string;
258
+ artifact_result_digest: string;
256
259
  post_author_composition_fingerprint: string | null;
260
+ delivery_artifact_ids?: string[] | undefined;
257
261
  }, {
258
262
  source_ref: string;
259
263
  protocol: "context.indexer.layout-proposal/v1";
@@ -268,6 +272,7 @@ export declare const indexerLayoutProposalSchema: z.ZodObject<{
268
272
  node_ref: string;
269
273
  };
270
274
  artifacts: {
275
+ purpose: "required" | "discretionary" | "semantic-split";
271
276
  output_path: string;
272
277
  artifact_kind: string;
273
278
  artifact_id: string;
@@ -286,7 +291,6 @@ export declare const indexerLayoutProposalSchema: z.ZodObject<{
286
291
  collection_resolution_digest: string;
287
292
  }[];
288
293
  collection: import("./contracts.js").TopLevelNamespace;
289
- purpose: "required" | "discretionary" | "semantic-split";
290
294
  node_ref: string;
291
295
  artifact_ref: string;
292
296
  internal_view_ref: string;
@@ -301,7 +305,6 @@ export declare const indexerLayoutProposalSchema: z.ZodObject<{
301
305
  indexer_id: string;
302
306
  profile_contract_digest: string;
303
307
  subject_key_schema_digest: string;
304
- artifact_result_digest: string;
305
308
  shared_artifact_fingerprint: {
306
309
  protocol: "context.indexer.shared-artifact-fingerprint/v1";
307
310
  indexer_id: string;
@@ -312,7 +315,9 @@ export declare const indexerLayoutProposalSchema: z.ZodObject<{
312
315
  };
313
316
  proposal_digest: string;
314
317
  subject_key_schema_set_digest: string;
318
+ artifact_result_digest: string;
315
319
  post_author_composition_fingerprint: string | null;
320
+ delivery_artifact_ids?: string[] | undefined;
316
321
  }>;
317
322
  export type IndexerLayoutProposal = z.infer<typeof indexerLayoutProposalSchema>;
318
323
  export declare function indexerLayoutArtifactRef(nodeRef: string, artifact: {
@@ -326,8 +331,10 @@ export declare function indexerLayoutSectionIdentityRef(input: {
326
331
  section_key: string;
327
332
  }): string;
328
333
  export declare function indexerLayoutSectionRef(currentArtifactRef: string, sectionIdentityRef: string): string;
334
+ export declare function indexerLayoutViewRef(currentArtifactRef: string, collection: KnowledgeCollection): string;
329
335
  export declare function resolveIndexerLayout(input: {
330
336
  artifact_result: unknown;
337
+ render_cache?: Map<string, ReturnType<typeof materializeIndexerStructuredContent>> | undefined;
331
338
  post_author_envelope?: unknown | null;
332
339
  profile: string;
333
340
  profile_contract: unknown;
@@ -335,10 +342,12 @@ export declare function resolveIndexerLayout(input: {
335
342
  subject_key_schema_set: unknown;
336
343
  shared_artifact_fingerprint: unknown;
337
344
  rendered_artifacts?: readonly IndexerRenderedArtifact[];
345
+ delivery_artifact_ids?: readonly string[] | undefined;
338
346
  }): IndexerLayoutProposal;
339
347
  export declare function validateIndexerLayoutProposal(input: {
340
348
  proposal: unknown;
341
349
  artifact_result: unknown;
350
+ render_cache?: Map<string, ReturnType<typeof materializeIndexerStructuredContent>> | undefined;
342
351
  post_author_envelope?: unknown | null;
343
352
  profile_contract: unknown;
344
353
  operator_contract: unknown;
@@ -56,8 +56,6 @@ export declare const indexerLayoutTransitionSchema: z.ZodObject<{
56
56
  } & {
57
57
  report_digest: z.ZodString;
58
58
  }, "strict", z.ZodTypeAny, {
59
- protocol: "context.indexer.layout-change-report/v1";
60
- report_digest: string;
61
59
  changes: {
62
60
  kind: "artifact-added" | "artifact-removed" | "artifact-split" | "artifact-merge" | "artifact-rename" | "section-move" | "collection-move" | "path-move";
63
61
  artifact_ref: string;
@@ -69,6 +67,8 @@ export declare const indexerLayoutTransitionSchema: z.ZodObject<{
69
67
  after_path: string | null;
70
68
  confirmation_class: "ambiguous" | "compatible-addition" | "destructive";
71
69
  }[];
70
+ protocol: "context.indexer.layout-change-report/v1";
71
+ report_digest: string;
72
72
  gate: {
73
73
  id: "confirm-layout-change";
74
74
  authority: "human";
@@ -79,8 +79,6 @@ export declare const indexerLayoutTransitionSchema: z.ZodObject<{
79
79
  reused_artifact_refs: string[];
80
80
  requires_confirmation: boolean;
81
81
  }, {
82
- protocol: "context.indexer.layout-change-report/v1";
83
- report_digest: string;
84
82
  changes: {
85
83
  kind: "artifact-added" | "artifact-removed" | "artifact-split" | "artifact-merge" | "artifact-rename" | "section-move" | "collection-move" | "path-move";
86
84
  artifact_ref: string;
@@ -92,6 +90,8 @@ export declare const indexerLayoutTransitionSchema: z.ZodObject<{
92
90
  after_path: string | null;
93
91
  confirmation_class: "ambiguous" | "compatible-addition" | "destructive";
94
92
  }[];
93
+ protocol: "context.indexer.layout-change-report/v1";
94
+ report_digest: string;
95
95
  gate: {
96
96
  id: "confirm-layout-change";
97
97
  authority: "human";
@@ -129,8 +129,6 @@ export declare const indexerLayoutTransitionSchema: z.ZodObject<{
129
129
  layout_proposal_set_digest: string;
130
130
  base_projection_digests: string[];
131
131
  change_reports: {
132
- protocol: "context.indexer.layout-change-report/v1";
133
- report_digest: string;
134
132
  changes: {
135
133
  kind: "artifact-added" | "artifact-removed" | "artifact-split" | "artifact-merge" | "artifact-rename" | "section-move" | "collection-move" | "path-move";
136
134
  artifact_ref: string;
@@ -142,6 +140,8 @@ export declare const indexerLayoutTransitionSchema: z.ZodObject<{
142
140
  after_path: string | null;
143
141
  confirmation_class: "ambiguous" | "compatible-addition" | "destructive";
144
142
  }[];
143
+ protocol: "context.indexer.layout-change-report/v1";
144
+ report_digest: string;
145
145
  gate: {
146
146
  id: "confirm-layout-change";
147
147
  authority: "human";
@@ -164,8 +164,6 @@ export declare const indexerLayoutTransitionSchema: z.ZodObject<{
164
164
  layout_proposal_set_digest: string;
165
165
  base_projection_digests: string[];
166
166
  change_reports: {
167
- protocol: "context.indexer.layout-change-report/v1";
168
- report_digest: string;
169
167
  changes: {
170
168
  kind: "artifact-added" | "artifact-removed" | "artifact-split" | "artifact-merge" | "artifact-rename" | "section-move" | "collection-move" | "path-move";
171
169
  artifact_ref: string;
@@ -177,6 +175,8 @@ export declare const indexerLayoutTransitionSchema: z.ZodObject<{
177
175
  after_path: string | null;
178
176
  confirmation_class: "ambiguous" | "compatible-addition" | "destructive";
179
177
  }[];
178
+ protocol: "context.indexer.layout-change-report/v1";
179
+ report_digest: string;
180
180
  gate: {
181
181
  id: "confirm-layout-change";
182
182
  authority: "human";
@@ -2,7 +2,7 @@ export * from "./indexerArtifactResult.js";
2
2
  export * from "./indexerCapabilityGroupEvidence.js";
3
3
  export * from "./indexerInventoryDisposition.js";
4
4
  export * from "./indexerStructuredDeclaration.js";
5
- export * from "./indexerGeneratedAuthoringAudit.js";
5
+ export * from "./indexerStructuredClaims.js";
6
6
  export * from "./indexerExampleIdentity.js";
7
7
  export * from "./indexerExampleIdentityAudit.js";
8
8
  export * from "./indexerExampleDecision.js";
@@ -1017,3 +1017,6 @@ export declare function failIndexerMainRun(input: {
1017
1017
  }): IndexerMainRunLedger;
1018
1018
  export declare function retryFailedIndexerMainRuns(value: unknown): IndexerMainRunLedger;
1019
1019
  export declare function observeIndexerMainRunLedger(value: unknown): IndexerMainWorksetStatus;
1020
+ /** Invalidate only the explicitly adjusted current worksets. Preserve peers and
1021
+ * their accepted identities; the next preparation reconciles changed inputs. */
1022
+ export declare function invalidateIndexerMainRunWorksets(value: unknown, worksets: ReadonlySet<string>): IndexerMainRunLedger;