@agent-native/core 0.101.7 → 0.101.10

package/corpus/templates/content/shared/api.ts

@@ -366,6 +366,7 @@ export type ContentDatabaseBodyHydrationState =
   | "pending"
   | "hydrating"
   | "hydrated"
+  | "unavailable"
   | "error";
 
 export interface ContentDatabaseBodyHydration {
@@ -379,6 +380,7 @@ export interface ContentDatabaseBodyHydrationSummary {
   pending: number;
   hydrating: number;
   hydrated: number;
+  unavailable?: number;
   error: number;
   total: number;
 }
@@ -452,6 +454,8 @@ export type ContentDatabaseSourceExecutionState =
   | "write_disabled"
   | "blocked"
   | "running"
+  | "response_received"
+  | "reconciliation_required"
   | "succeeded"
   | "failed";
 
@@ -507,6 +511,8 @@ export interface ContentDatabaseSourceFieldChange {
   sourceFieldKey: string;
   currentValue: DocumentPropertyValue;
   proposedValue: DocumentPropertyValue;
+  /** Exact provider-native JSON value; review continues to show proposedValue. */
+  builderValueJson?: string;
 }
 
 export interface ContentDatabaseSourceBodyChange {
@@ -647,6 +653,7 @@ export interface ContentDatabaseSource {
     allowDraftWrites?: boolean;
     allowPublishWrites?: boolean;
     allowedWriteModes?: ContentDatabaseSourcePushMode[];
+    builderModelFields?: BuilderCmsModelFieldSummary[];
     federation?: ContentDatabaseSourceFederation;
   };
   fields: ContentDatabaseSourceFieldMapping[];
@@ -667,6 +674,7 @@ export interface BuilderCmsModelFieldSummary {
   label?: string;
   type: string;
   inputType?: string;
+  model?: string;
   enum?: string[];
   options?: string[];
   required: boolean;
@@ -725,6 +733,12 @@ export interface ContentDatabaseResponse {
   duplicatedDocumentIds?: string[];
   deletedItemIds?: string[];
   deletedDocumentIds?: string[];
+  timings?: BuilderActionTiming[];
+}
+
+export interface BuilderActionTiming {
+  name: string;
+  durationMs: number;
 }
 
 export interface ContentDatabaseUnavailableResponse {
@@ -958,6 +972,25 @@ export interface PrepareBuilderSourceExecutionRequest {
   confirmUnpublish?: boolean;
 }
 
+export interface CancelPreparedBuilderSourceUpdateRequest {
+  databaseId?: string;
+  documentId?: string;
+  sourceId: string;
+  changeSetId: string;
+  note?: string;
+}
+
+export interface CancelPreparedBuilderSourceUpdateResponse extends ContentDatabaseResponse {
+  cancellation: {
+    sourceId: string;
+    changeSetId: string;
+    executionIds: string[];
+    status: "cancelled" | "already_cancelled";
+    cancelledAt: string;
+    cancelledBy: string;
+  };
+}
+
 export interface ValidateBuilderSourceExecutionRequest {
   databaseId?: string;
   documentId?: string;
@@ -988,6 +1021,7 @@ export interface PrepareBuilderSourceReviewRequest {
   pushModeConfirmation?: ContentDatabaseSourcePushMode;
   publicationTransition?: BuilderCmsPublicationTransitionIntent;
   confirmUnpublish?: boolean;
+  transitions?: Record<string, ExecuteBuilderSourceBatchTransition>;
 }
 
 export interface ExecuteBuilderSourceBatchTransition {
@@ -1004,12 +1038,17 @@ export interface ExecuteBuilderSourceBatchRequest {
   transitions?: Record<string, ExecuteBuilderSourceBatchTransition>;
 }
 
-export type BuilderSourceBatchItemStatus = "succeeded" | "blocked" | "failed";
+export type BuilderSourceBatchItemStatus =
+  | "succeeded"
+  | "blocked"
+  | "reconciliation_required"
+  | "failed";
 
 export interface BuilderSourceBatchItemResult {
   changeSetId: string;
   status: BuilderSourceBatchItemStatus;
   message?: string;
+  timings?: BuilderActionTiming[];
 }
 
 export interface ExecuteBuilderSourceBatchResponse {
@@ -1017,9 +1056,11 @@ export interface ExecuteBuilderSourceBatchResponse {
     total: number;
     succeeded: number;
     blocked: number;
+    reconciliationRequired: number;
     failed: number;
   };
   results: BuilderSourceBatchItemResult[];
+  timings?: BuilderActionTiming[];
 }
 
 export interface SetContentDatabaseSourceWriteModeRequest {
@@ -1100,6 +1141,8 @@ export interface ContentDatabaseSourceReviewRowSummary {
   databaseItemId: string | null;
   documentId: string | null;
   title: string;
+  /** Existing Builder entry targeted by this write; null for new drafts. */
+  targetEntryId?: string | null;
   fieldChanges: ContentDatabaseSourceFieldChange[];
   bodyChange: ContentDatabaseSourceBodyChange | null;
   riskLevel: ContentDatabaseSourceRiskLevel;
@@ -1129,18 +1172,44 @@ export interface ContentDatabaseSourceReviewPayload {
       | "stale"
       | "write_disabled"
       | "running"
+      | "reconciliation_required"
       | "succeeded"
       | "failed";
     message: string;
   };
 }
 
+export interface PreviewBuilderSourceReviewRequest {
+  databaseId?: string;
+  documentId?: string;
+  sourceId?: string;
+  scope?: "selected" | "all";
+  documentIds?: string[];
+}
+
+export interface PreviewBuilderSourceReviewResponse {
+  sourceId: string;
+  sourceTable: string;
+  changeSetIds: string[];
+  review: ContentDatabaseSourceReviewPayload | null;
+}
+
 export interface PrepareBuilderSourceReviewResponse {
   database: ContentDatabase;
   properties: DocumentProperty[];
   items: ContentDatabaseItem[];
   source: ContentDatabaseSource | null;
   review: ContentDatabaseSourceReviewPayload;
+  /**
+   * Maps the operator-selected diff identities to the immutable change-set
+   * identities prepared for execution. These differ when a cancelled or
+   * otherwise closed synthetic diff is reviewed again as a new revision.
+   */
+  preparedChangeSetMappings: Array<{
+    requestedChangeSetId: string;
+    preparedChangeSetId: string;
+  }>;
+  timings?: BuilderActionTiming[];
 }
 
 export interface ProcessBuilderBodyHydrationRequest {