@kubun/protocol 0.17.0 → 0.17.1

package/lib/errors.d.ts

@@ -21,6 +21,13 @@ export declare const KubunErrorCodes: {
     readonly KB13: "Mutation schema validation error";
     readonly KB14: "Group control denied";
     readonly KB15: "Model not deployed";
+    readonly KB16: "Invalid fetch token";
+    readonly KB17: "Fetch token ordering violated";
+    readonly KB18: "Incomplete provider group";
+    readonly KB19: "Tombstone requires a provider-merge-policy model";
+    readonly KB20: "Provider group CHANGE rejected";
+    readonly KB21: "Missing fetch token";
+    readonly KB22: "Merge-policy remove requires a tombstone";
 };
 export type KubunErrorCode = keyof typeof KubunErrorCodes;
 export declare function isKubunErrorCode(value: unknown): value is KubunErrorCode;

package/lib/errors.js

@@ -19,7 +19,14 @@
     KB12: 'Unsupported mutation type',
     KB13: 'Mutation schema validation error',
     KB14: 'Group control denied',
-    KB15: 'Model not deployed'
+    KB15: 'Model not deployed',
+    KB16: 'Invalid fetch token',
+    KB17: 'Fetch token ordering violated',
+    KB18: 'Incomplete provider group',
+    KB19: 'Tombstone requires a provider-merge-policy model',
+    KB20: 'Provider group CHANGE rejected',
+    KB21: 'Missing fetch token',
+    KB22: 'Merge-policy remove requires a tombstone'
 };
 export function isKubunErrorCode(value) {
     return typeof value === 'string' && Object.hasOwn(KubunErrorCodes, value);

package/lib/executor.d.ts

@@ -8,6 +8,22 @@ import type { DeployGraphParams, DeployGraphResult, ExecuteGraphParams, ExecuteG
 export type GraphQLOperationParams = {
     text: string;
     variables?: Record<string, unknown>;
+    /**
+     * The caller-minted idempotency key of a connector write-back: required on
+     * any connector action mutation (`connectorCreate<Model>` /
+     * `connectorUpdate<Model>`), ignored by every other operation. Reuse the
+     * same `operationID` and `deterministicEventID` when retrying the same user
+     * intent (a retry then returns the stored outcome instead of writing twice);
+     * mint a new pair for a new intent. Only mutations carry it.
+     */
+    operationID?: string;
+    /**
+     * The deterministic identity of the user intent a connector write-back
+     * carries out (for example one per form submission), sent with
+     * `operationID`: required on any connector action mutation, stable across
+     * retries of that intent, new for a new intent.
+     */
+    deterministicEventID?: string;
 };
 /**
  * A bound GraphQL execution target for a specific graph (and optionally a viewer).

package/lib/models/cluster.d.ts

@@ -371,6 +371,19 @@ export declare const clusterModel: {
                                 }];
                             };
                         };
+                        readonly providerMergePolicy: {
+                            readonly type: "object";
+                            readonly properties: {
+                                readonly group: {
+                                    readonly type: "array";
+                                    readonly items: {
+                                        readonly type: "string";
+                                    };
+                                };
+                            };
+                            readonly required: readonly ["group"];
+                            readonly additionalProperties: false;
+                        };
                     };
                     readonly required: readonly ["name", "version", "interfaces", "schema", "fieldsMeta", "behavior"];
                     readonly additionalProperties: false;
@@ -730,6 +743,19 @@ export declare const clusterModel: {
                                 }];
                             };
                         };
+                        readonly providerMergePolicy: {
+                            readonly type: "object";
+                            readonly properties: {
+                                readonly group: {
+                                    readonly type: "array";
+                                    readonly items: {
+                                        readonly type: "string";
+                                    };
+                                };
+                            };
+                            readonly required: readonly ["group"];
+                            readonly additionalProperties: false;
+                        };
                     };
                     readonly required: readonly ["name", "version", "interfaces", "schema", "fieldsMeta", "behavior"];
                     readonly additionalProperties: false;
@@ -1095,6 +1121,19 @@ export declare const clusterModel: {
                                 }];
                             };
                         };
+                        readonly providerMergePolicy: {
+                            readonly type: "object";
+                            readonly properties: {
+                                readonly group: {
+                                    readonly type: "array";
+                                    readonly items: {
+                                        readonly type: "string";
+                                    };
+                                };
+                            };
+                            readonly required: readonly ["group"];
+                            readonly additionalProperties: false;
+                        };
                     };
                     readonly required: readonly ["name", "version", "interfaces", "schema", "fieldsMeta", "behavior", "uniqueFields"];
                     readonly additionalProperties: false;
@@ -1121,6 +1160,9 @@ export declare function clusterToRecord(cluster: ClusterModel): ClustersRecord;
 export declare const validateClusterModel: import("@sozai/schema").Validator<{
     digest: string;
     models: ({
+        providerMergePolicy?: {
+            group: string[];
+        } | undefined;
         name: string;
         version: "1.0";
         schema: {
@@ -1212,6 +1254,9 @@ export declare const validateClusterModel: import("@sozai/schema").Validator<{
         interfaces: string[];
         behavior: "default";
     } | {
+        providerMergePolicy?: {
+            group: string[];
+        } | undefined;
         name: string;
         version: "1.0";
         schema: {
@@ -1303,6 +1348,9 @@ export declare const validateClusterModel: import("@sozai/schema").Validator<{
         interfaces: string[];
         behavior: "interface";
     } | {
+        providerMergePolicy?: {
+            group: string[];
+        } | undefined;
         name: string;
         version: "1.0";
         schema: {

package/lib/models/document.d.ts

@@ -796,6 +796,19 @@ export declare const documentModelBase: {
                 }];
             };
         };
+        readonly providerMergePolicy: {
+            readonly type: "object";
+            readonly properties: {
+                readonly group: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                };
+            };
+            readonly required: readonly ["group"];
+            readonly additionalProperties: false;
+        };
     };
     readonly required: readonly ["name", "version", "interfaces", "schema", "fieldsMeta"];
     readonly additionalProperties: false;
@@ -1156,6 +1169,19 @@ export declare const documentModelDefault: {
                 }];
             };
         };
+        readonly providerMergePolicy: {
+            readonly type: "object";
+            readonly properties: {
+                readonly group: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                };
+            };
+            readonly required: readonly ["group"];
+            readonly additionalProperties: false;
+        };
     };
     readonly required: readonly ["name", "version", "interfaces", "schema", "fieldsMeta", "behavior"];
     readonly additionalProperties: false;
@@ -1516,6 +1542,19 @@ export declare const documentModelInterface: {
                 }];
             };
         };
+        readonly providerMergePolicy: {
+            readonly type: "object";
+            readonly properties: {
+                readonly group: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                };
+            };
+            readonly required: readonly ["group"];
+            readonly additionalProperties: false;
+        };
     };
     readonly required: readonly ["name", "version", "interfaces", "schema", "fieldsMeta", "behavior"];
     readonly additionalProperties: false;
@@ -1882,6 +1921,19 @@ export declare const documentModelUnique: {
                 }];
             };
         };
+        readonly providerMergePolicy: {
+            readonly type: "object";
+            readonly properties: {
+                readonly group: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                };
+            };
+            readonly required: readonly ["group"];
+            readonly additionalProperties: false;
+        };
     };
     readonly required: readonly ["name", "version", "interfaces", "schema", "fieldsMeta", "behavior", "uniqueFields"];
     readonly additionalProperties: false;
@@ -2244,6 +2296,19 @@ export declare const documentModel: {
                     }];
                 };
             };
+            readonly providerMergePolicy: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly group: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                    };
+                };
+                readonly required: readonly ["group"];
+                readonly additionalProperties: false;
+            };
         };
         readonly required: readonly ["name", "version", "interfaces", "schema", "fieldsMeta", "behavior"];
         readonly additionalProperties: false;
@@ -2603,6 +2668,19 @@ export declare const documentModel: {
                     }];
                 };
             };
+            readonly providerMergePolicy: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly group: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                    };
+                };
+                readonly required: readonly ["group"];
+                readonly additionalProperties: false;
+            };
         };
         readonly required: readonly ["name", "version", "interfaces", "schema", "fieldsMeta", "behavior"];
         readonly additionalProperties: false;
@@ -2968,6 +3046,19 @@ export declare const documentModel: {
                     }];
                 };
             };
+            readonly providerMergePolicy: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly group: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                    };
+                };
+                readonly required: readonly ["group"];
+                readonly additionalProperties: false;
+            };
         };
         readonly required: readonly ["name", "version", "interfaces", "schema", "fieldsMeta", "behavior", "uniqueFields"];
         readonly additionalProperties: false;
@@ -3334,6 +3425,19 @@ export declare const documentModelsCluster: {
                         }];
                     };
                 };
+                readonly providerMergePolicy: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly group: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "string";
+                            };
+                        };
+                    };
+                    readonly required: readonly ["group"];
+                    readonly additionalProperties: false;
+                };
             };
             readonly required: readonly ["name", "version", "interfaces", "schema", "fieldsMeta", "behavior"];
             readonly additionalProperties: false;
@@ -3693,6 +3797,19 @@ export declare const documentModelsCluster: {
                         }];
                     };
                 };
+                readonly providerMergePolicy: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly group: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "string";
+                            };
+                        };
+                    };
+                    readonly required: readonly ["group"];
+                    readonly additionalProperties: false;
+                };
             };
             readonly required: readonly ["name", "version", "interfaces", "schema", "fieldsMeta", "behavior"];
             readonly additionalProperties: false;
@@ -4058,6 +4175,19 @@ export declare const documentModelsCluster: {
                         }];
                     };
                 };
+                readonly providerMergePolicy: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly group: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "string";
+                            };
+                        };
+                    };
+                    readonly required: readonly ["group"];
+                    readonly additionalProperties: false;
+                };
             };
             readonly required: readonly ["name", "version", "interfaces", "schema", "fieldsMeta", "behavior", "uniqueFields"];
             readonly additionalProperties: false;
@@ -4425,6 +4555,19 @@ export declare const documentModelsRecord: {
                         }];
                     };
                 };
+                readonly providerMergePolicy: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly group: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "string";
+                            };
+                        };
+                    };
+                    readonly required: readonly ["group"];
+                    readonly additionalProperties: false;
+                };
             };
             readonly required: readonly ["name", "version", "interfaces", "schema", "fieldsMeta", "behavior"];
             readonly additionalProperties: false;
@@ -4784,6 +4927,19 @@ export declare const documentModelsRecord: {
                         }];
                     };
                 };
+                readonly providerMergePolicy: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly group: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "string";
+                            };
+                        };
+                    };
+                    readonly required: readonly ["group"];
+                    readonly additionalProperties: false;
+                };
             };
             readonly required: readonly ["name", "version", "interfaces", "schema", "fieldsMeta", "behavior"];
             readonly additionalProperties: false;
@@ -5149,6 +5305,19 @@ export declare const documentModelsRecord: {
                         }];
                     };
                 };
+                readonly providerMergePolicy: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly group: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "string";
+                            };
+                        };
+                    };
+                    readonly required: readonly ["group"];
+                    readonly additionalProperties: false;
+                };
             };
             readonly required: readonly ["name", "version", "interfaces", "schema", "fieldsMeta", "behavior", "uniqueFields"];
             readonly additionalProperties: false;
@@ -5199,6 +5368,9 @@ export declare const setDocumentMutation: {
                 };
             }];
         };
+        readonly sourceFetchHLC: {
+            readonly type: "string";
+        };
     };
     readonly required: readonly ["iss", "sub", "typ", "data", "hlc", "unq"];
     readonly additionalProperties: false;
@@ -5221,6 +5393,32 @@ export declare const patchOperationSchema: {
     readonly required: readonly ["op", "path"];
     readonly additionalProperties: false;
 };
+/** A JSON Patch operation, as a change mutation carries it. */
+export type PatchAddOperation = {
+    op: 'add';
+    path: string;
+    value: unknown;
+};
+export type PatchRemoveOperation = {
+    op: 'remove';
+    path: string;
+};
+export type PatchReplaceOperation = {
+    op: 'replace';
+    path: string;
+    value: unknown;
+};
+export type PatchMoveOperation = {
+    op: 'move';
+    from: string;
+    path: string;
+};
+export type PatchCopyOperation = {
+    op: 'copy';
+    from: string;
+    path: string;
+};
+export type PatchOperation = PatchAddOperation | PatchCopyOperation | PatchMoveOperation | PatchRemoveOperation | PatchReplaceOperation;
 export declare const changeDocumentMutation: {
     readonly $id: "urn:kubun:protocol:mutation:change";
     readonly type: "object";
@@ -5275,6 +5473,53 @@ export declare const changeDocumentMutation: {
     readonly additionalProperties: false;
 };
 export type ChangeDocumentMutation = FromSchema<typeof changeDocumentMutation>;
+export declare const tombstoneDocumentMutation: {
+    readonly $id: "urn:kubun:protocol:mutation:tombstone";
+    readonly type: "object";
+    readonly properties: {
+        readonly typ: {
+            readonly type: "string";
+            readonly const: "tombstone";
+        };
+        readonly iss: {
+            readonly title: "KubunDIDValue";
+            readonly type: "string";
+            readonly pattern: "^did:[a-z0-9]+:";
+        };
+        readonly aud: {
+            readonly title: "KubunDIDValue";
+            readonly type: "string";
+            readonly pattern: "^did:[a-z0-9]+:";
+        };
+        readonly sub: {
+            readonly type: "string";
+        };
+        readonly unq: {
+            readonly title: "KubunBinaryValue";
+            readonly type: "string";
+            readonly pattern: "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$";
+        };
+        readonly hlc: {
+            readonly type: "string";
+        };
+        readonly sourceFetchHLC: {
+            readonly type: "string";
+        };
+        readonly cap: {
+            readonly anyOf: readonly [{
+                readonly type: "string";
+            }, {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+            }];
+        };
+    };
+    readonly required: readonly ["iss", "aud", "sub", "typ", "unq", "hlc", "sourceFetchHLC"];
+    readonly additionalProperties: false;
+};
+export type TombstoneDocumentMutation = FromSchema<typeof tombstoneDocumentMutation>;
 export declare const documentMutation: {
     readonly $id: "urn:kubun:protocol:mutation";
     readonly anyOf: readonly [{
@@ -5320,6 +5565,9 @@ export declare const documentMutation: {
                     };
                 }];
             };
+            readonly sourceFetchHLC: {
+                readonly type: "string";
+            };
         };
         readonly required: readonly ["iss", "sub", "typ", "data", "hlc", "unq"];
         readonly additionalProperties: false;
@@ -5375,10 +5623,58 @@ export declare const documentMutation: {
         };
         readonly required: readonly ["iss", "sub", "typ", "patch", "hlc"];
         readonly additionalProperties: false;
+    }, {
+        readonly $id: "urn:kubun:protocol:mutation:tombstone";
+        readonly type: "object";
+        readonly properties: {
+            readonly typ: {
+                readonly type: "string";
+                readonly const: "tombstone";
+            };
+            readonly iss: {
+                readonly title: "KubunDIDValue";
+                readonly type: "string";
+                readonly pattern: "^did:[a-z0-9]+:";
+            };
+            readonly aud: {
+                readonly title: "KubunDIDValue";
+                readonly type: "string";
+                readonly pattern: "^did:[a-z0-9]+:";
+            };
+            readonly sub: {
+                readonly type: "string";
+            };
+            readonly unq: {
+                readonly title: "KubunBinaryValue";
+                readonly type: "string";
+                readonly pattern: "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$";
+            };
+            readonly hlc: {
+                readonly type: "string";
+            };
+            readonly sourceFetchHLC: {
+                readonly type: "string";
+            };
+            readonly cap: {
+                readonly anyOf: readonly [{
+                    readonly type: "string";
+                }, {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                }];
+            };
+        };
+        readonly required: readonly ["iss", "aud", "sub", "typ", "unq", "hlc", "sourceFetchHLC"];
+        readonly additionalProperties: false;
     }];
 };
 export type DocumentMutation = FromSchema<typeof documentMutation>;
 export declare const validateDocumentModel: import("@sozai/schema").Validator<{
+    providerMergePolicy?: {
+        group: string[];
+    } | undefined;
     name: string;
     version: "1.0";
     schema: {
@@ -5470,6 +5766,9 @@ export declare const validateDocumentModel: import("@sozai/schema").Validator<{
     interfaces: string[];
     behavior: "default";
 } | {
+    providerMergePolicy?: {
+        group: string[];
+    } | undefined;
     name: string;
     version: "1.0";
     schema: {
@@ -5561,6 +5860,9 @@ export declare const validateDocumentModel: import("@sozai/schema").Validator<{
     interfaces: string[];
     behavior: "interface";
 } | {
+    providerMergePolicy?: {
+        group: string[];
+    } | undefined;
     name: string;
     version: "1.0";
     schema: {

package/lib/models/document.js

@@ -101,7 +101,22 @@ export const documentModelBase = {
             }
         },
         schema: documentModelSchema,
-        fieldsMeta: documentFieldsMeta
+        fieldsMeta: documentFieldsMeta,
+        providerMergePolicy: {
+            type: 'object',
+            properties: {
+                group: {
+                    type: 'array',
+                    items: {
+                        type: 'string'
+                    }
+                }
+            },
+            required: [
+                'group'
+            ],
+            additionalProperties: false
+        }
     },
     required: [
         'name',
@@ -213,6 +228,9 @@ export const setDocumentMutation = {
                     }
                 }
             ]
+        },
+        sourceFetchHLC: {
+            type: 'string'
         }
     },
     required: [
@@ -287,11 +305,57 @@ export const changeDocumentMutation = {
     ],
     additionalProperties: false
 };
+export const tombstoneDocumentMutation = {
+    $id: 'urn:kubun:protocol:mutation:tombstone',
+    type: 'object',
+    properties: {
+        typ: {
+            type: 'string',
+            const: 'tombstone'
+        },
+        iss: didStringValue,
+        aud: didStringValue,
+        sub: {
+            type: 'string'
+        },
+        unq: binaryStringValue,
+        hlc: {
+            type: 'string'
+        },
+        sourceFetchHLC: {
+            type: 'string'
+        },
+        cap: {
+            anyOf: [
+                {
+                    type: 'string'
+                },
+                {
+                    type: 'array',
+                    items: {
+                        type: 'string'
+                    }
+                }
+            ]
+        }
+    },
+    required: [
+        'iss',
+        'aud',
+        'sub',
+        'typ',
+        'unq',
+        'hlc',
+        'sourceFetchHLC'
+    ],
+    additionalProperties: false
+};
 export const documentMutation = {
     $id: 'urn:kubun:protocol:mutation',
     anyOf: [
         setDocumentMutation,
-        changeDocumentMutation
+        changeDocumentMutation,
+        tombstoneDocumentMutation
     ]
 };
 // Normalization logic

package/lib/services/graph.d.ts

@@ -401,6 +401,19 @@ export declare const deployGraphParams: {
                                             }];
                                         };
                                     };
+                                    readonly providerMergePolicy: {
+                                        readonly type: "object";
+                                        readonly properties: {
+                                            readonly group: {
+                                                readonly type: "array";
+                                                readonly items: {
+                                                    readonly type: "string";
+                                                };
+                                            };
+                                        };
+                                        readonly required: readonly ["group"];
+                                        readonly additionalProperties: false;
+                                    };
                                 };
                                 readonly required: readonly ["name", "version", "interfaces", "schema", "fieldsMeta", "behavior"];
                                 readonly additionalProperties: false;
@@ -760,6 +773,19 @@ export declare const deployGraphParams: {
                                             }];
                                         };
                                     };
+                                    readonly providerMergePolicy: {
+                                        readonly type: "object";
+                                        readonly properties: {
+                                            readonly group: {
+                                                readonly type: "array";
+                                                readonly items: {
+                                                    readonly type: "string";
+                                                };
+                                            };
+                                        };
+                                        readonly required: readonly ["group"];
+                                        readonly additionalProperties: false;
+                                    };
                                 };
                                 readonly required: readonly ["name", "version", "interfaces", "schema", "fieldsMeta", "behavior"];
                                 readonly additionalProperties: false;
@@ -1125,6 +1151,19 @@ export declare const deployGraphParams: {
                                             }];
                                         };
                                     };
+                                    readonly providerMergePolicy: {
+                                        readonly type: "object";
+                                        readonly properties: {
+                                            readonly group: {
+                                                readonly type: "array";
+                                                readonly items: {
+                                                    readonly type: "string";
+                                                };
+                                            };
+                                        };
+                                        readonly required: readonly ["group"];
+                                        readonly additionalProperties: false;
+                                    };
                                 };
                                 readonly required: readonly ["name", "version", "interfaces", "schema", "fieldsMeta", "behavior", "uniqueFields"];
                                 readonly additionalProperties: false;
@@ -1545,6 +1584,19 @@ export declare const deployGraphResult: {
                                 }];
                             };
                         };
+                        readonly providerMergePolicy: {
+                            readonly type: "object";
+                            readonly properties: {
+                                readonly group: {
+                                    readonly type: "array";
+                                    readonly items: {
+                                        readonly type: "string";
+                                    };
+                                };
+                            };
+                            readonly required: readonly ["group"];
+                            readonly additionalProperties: false;
+                        };
                     };
                     readonly required: readonly ["name", "version", "interfaces", "schema", "fieldsMeta", "behavior"];
                     readonly additionalProperties: false;
@@ -1904,6 +1956,19 @@ export declare const deployGraphResult: {
                                 }];
                             };
                         };
+                        readonly providerMergePolicy: {
+                            readonly type: "object";
+                            readonly properties: {
+                                readonly group: {
+                                    readonly type: "array";
+                                    readonly items: {
+                                        readonly type: "string";
+                                    };
+                                };
+                            };
+                            readonly required: readonly ["group"];
+                            readonly additionalProperties: false;
+                        };
                     };
                     readonly required: readonly ["name", "version", "interfaces", "schema", "fieldsMeta", "behavior"];
                     readonly additionalProperties: false;
@@ -2269,6 +2334,19 @@ export declare const deployGraphResult: {
                                 }];
                             };
                         };
+                        readonly providerMergePolicy: {
+                            readonly type: "object";
+                            readonly properties: {
+                                readonly group: {
+                                    readonly type: "array";
+                                    readonly items: {
+                                        readonly type: "string";
+                                    };
+                                };
+                            };
+                            readonly required: readonly ["group"];
+                            readonly additionalProperties: false;
+                        };
                     };
                     readonly required: readonly ["name", "version", "interfaces", "schema", "fieldsMeta", "behavior", "uniqueFields"];
                     readonly additionalProperties: false;
@@ -2699,6 +2777,19 @@ export declare const loadGraphResult: {
                                 }];
                             };
                         };
+                        readonly providerMergePolicy: {
+                            readonly type: "object";
+                            readonly properties: {
+                                readonly group: {
+                                    readonly type: "array";
+                                    readonly items: {
+                                        readonly type: "string";
+                                    };
+                                };
+                            };
+                            readonly required: readonly ["group"];
+                            readonly additionalProperties: false;
+                        };
                     };
                     readonly required: readonly ["name", "version", "interfaces", "schema", "fieldsMeta", "behavior"];
                     readonly additionalProperties: false;
@@ -3058,6 +3149,19 @@ export declare const loadGraphResult: {
                                 }];
                             };
                         };
+                        readonly providerMergePolicy: {
+                            readonly type: "object";
+                            readonly properties: {
+                                readonly group: {
+                                    readonly type: "array";
+                                    readonly items: {
+                                        readonly type: "string";
+                                    };
+                                };
+                            };
+                            readonly required: readonly ["group"];
+                            readonly additionalProperties: false;
+                        };
                     };
                     readonly required: readonly ["name", "version", "interfaces", "schema", "fieldsMeta", "behavior"];
                     readonly additionalProperties: false;
@@ -3423,6 +3527,19 @@ export declare const loadGraphResult: {
                                 }];
                             };
                         };
+                        readonly providerMergePolicy: {
+                            readonly type: "object";
+                            readonly properties: {
+                                readonly group: {
+                                    readonly type: "array";
+                                    readonly items: {
+                                        readonly type: "string";
+                                    };
+                                };
+                            };
+                            readonly required: readonly ["group"];
+                            readonly additionalProperties: false;
+                        };
                     };
                     readonly required: readonly ["name", "version", "interfaces", "schema", "fieldsMeta", "behavior", "uniqueFields"];
                     readonly additionalProperties: false;
@@ -3592,6 +3709,32 @@ export declare const mutateGraphParams: {
         readonly transactionID: {
             readonly type: "string";
         };
+        readonly invocationCaps: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+            };
+        };
+        /**
+         * The connector operation-envelope ids for a credential-spend connector
+         * action (`connectorCreate<Model>`/`connectorUpdate<Model>`). Optional:
+         * never in `required`, so a request from an older client that omits them
+         * still validates. Not accepted by an older server, though: the params
+         * are `additionalProperties: false`, so a server that predates these
+         * fields rejects a request carrying them — the server must be upgraded
+         * before a client sends them. Forwarded onto
+         * `ExecutionContext.operationID`/`ExecutionContext.deterministicEventID`
+         * by the engine; verified downstream in `@kubun/plugin-connector`.
+         */
+        readonly operationID: {
+            readonly type: "string";
+        };
+        readonly deterministicEventID: {
+            readonly type: "string";
+        };
         readonly id: {
             readonly type: "string";
         };
@@ -4046,6 +4189,19 @@ export declare const graphProtocol: {
                                                     }];
                                                 };
                                             };
+                                            readonly providerMergePolicy: {
+                                                readonly type: "object";
+                                                readonly properties: {
+                                                    readonly group: {
+                                                        readonly type: "array";
+                                                        readonly items: {
+                                                            readonly type: "string";
+                                                        };
+                                                    };
+                                                };
+                                                readonly required: readonly ["group"];
+                                                readonly additionalProperties: false;
+                                            };
                                         };
                                         readonly required: readonly ["name", "version", "interfaces", "schema", "fieldsMeta", "behavior"];
                                         readonly additionalProperties: false;
@@ -4405,6 +4561,19 @@ export declare const graphProtocol: {
                                                     }];
                                                 };
                                             };
+                                            readonly providerMergePolicy: {
+                                                readonly type: "object";
+                                                readonly properties: {
+                                                    readonly group: {
+                                                        readonly type: "array";
+                                                        readonly items: {
+                                                            readonly type: "string";
+                                                        };
+                                                    };
+                                                };
+                                                readonly required: readonly ["group"];
+                                                readonly additionalProperties: false;
+                                            };
                                         };
                                         readonly required: readonly ["name", "version", "interfaces", "schema", "fieldsMeta", "behavior"];
                                         readonly additionalProperties: false;
@@ -4770,6 +4939,19 @@ export declare const graphProtocol: {
                                                     }];
                                                 };
                                             };
+                                            readonly providerMergePolicy: {
+                                                readonly type: "object";
+                                                readonly properties: {
+                                                    readonly group: {
+                                                        readonly type: "array";
+                                                        readonly items: {
+                                                            readonly type: "string";
+                                                        };
+                                                    };
+                                                };
+                                                readonly required: readonly ["group"];
+                                                readonly additionalProperties: false;
+                                            };
                                         };
                                         readonly required: readonly ["name", "version", "interfaces", "schema", "fieldsMeta", "behavior", "uniqueFields"];
                                         readonly additionalProperties: false;
@@ -5189,6 +5371,19 @@ export declare const graphProtocol: {
                                         }];
                                     };
                                 };
+                                readonly providerMergePolicy: {
+                                    readonly type: "object";
+                                    readonly properties: {
+                                        readonly group: {
+                                            readonly type: "array";
+                                            readonly items: {
+                                                readonly type: "string";
+                                            };
+                                        };
+                                    };
+                                    readonly required: readonly ["group"];
+                                    readonly additionalProperties: false;
+                                };
                             };
                             readonly required: readonly ["name", "version", "interfaces", "schema", "fieldsMeta", "behavior"];
                             readonly additionalProperties: false;
@@ -5548,6 +5743,19 @@ export declare const graphProtocol: {
                                         }];
                                     };
                                 };
+                                readonly providerMergePolicy: {
+                                    readonly type: "object";
+                                    readonly properties: {
+                                        readonly group: {
+                                            readonly type: "array";
+                                            readonly items: {
+                                                readonly type: "string";
+                                            };
+                                        };
+                                    };
+                                    readonly required: readonly ["group"];
+                                    readonly additionalProperties: false;
+                                };
                             };
                             readonly required: readonly ["name", "version", "interfaces", "schema", "fieldsMeta", "behavior"];
                             readonly additionalProperties: false;
@@ -5913,6 +6121,19 @@ export declare const graphProtocol: {
                                         }];
                                     };
                                 };
+                                readonly providerMergePolicy: {
+                                    readonly type: "object";
+                                    readonly properties: {
+                                        readonly group: {
+                                            readonly type: "array";
+                                            readonly items: {
+                                                readonly type: "string";
+                                            };
+                                        };
+                                    };
+                                    readonly required: readonly ["group"];
+                                    readonly additionalProperties: false;
+                                };
                             };
                             readonly required: readonly ["name", "version", "interfaces", "schema", "fieldsMeta", "behavior", "uniqueFields"];
                             readonly additionalProperties: false;
@@ -6346,6 +6567,19 @@ export declare const graphProtocol: {
                                         }];
                                     };
                                 };
+                                readonly providerMergePolicy: {
+                                    readonly type: "object";
+                                    readonly properties: {
+                                        readonly group: {
+                                            readonly type: "array";
+                                            readonly items: {
+                                                readonly type: "string";
+                                            };
+                                        };
+                                    };
+                                    readonly required: readonly ["group"];
+                                    readonly additionalProperties: false;
+                                };
                             };
                             readonly required: readonly ["name", "version", "interfaces", "schema", "fieldsMeta", "behavior"];
                             readonly additionalProperties: false;
@@ -6705,6 +6939,19 @@ export declare const graphProtocol: {
                                         }];
                                     };
                                 };
+                                readonly providerMergePolicy: {
+                                    readonly type: "object";
+                                    readonly properties: {
+                                        readonly group: {
+                                            readonly type: "array";
+                                            readonly items: {
+                                                readonly type: "string";
+                                            };
+                                        };
+                                    };
+                                    readonly required: readonly ["group"];
+                                    readonly additionalProperties: false;
+                                };
                             };
                             readonly required: readonly ["name", "version", "interfaces", "schema", "fieldsMeta", "behavior"];
                             readonly additionalProperties: false;
@@ -7070,6 +7317,19 @@ export declare const graphProtocol: {
                                         }];
                                     };
                                 };
+                                readonly providerMergePolicy: {
+                                    readonly type: "object";
+                                    readonly properties: {
+                                        readonly group: {
+                                            readonly type: "array";
+                                            readonly items: {
+                                                readonly type: "string";
+                                            };
+                                        };
+                                    };
+                                    readonly required: readonly ["group"];
+                                    readonly additionalProperties: false;
+                                };
                             };
                             readonly required: readonly ["name", "version", "interfaces", "schema", "fieldsMeta", "behavior", "uniqueFields"];
                             readonly additionalProperties: false;
@@ -7128,6 +7388,32 @@ export declare const graphProtocol: {
                 readonly transactionID: {
                     readonly type: "string";
                 };
+                readonly invocationCaps: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                    };
+                };
+                /**
+                 * The connector operation-envelope ids for a credential-spend connector
+                 * action (`connectorCreate<Model>`/`connectorUpdate<Model>`). Optional:
+                 * never in `required`, so a request from an older client that omits them
+                 * still validates. Not accepted by an older server, though: the params
+                 * are `additionalProperties: false`, so a server that predates these
+                 * fields rejects a request carrying them — the server must be upgraded
+                 * before a client sends them. Forwarded onto
+                 * `ExecutionContext.operationID`/`ExecutionContext.deterministicEventID`
+                 * by the engine; verified downstream in `@kubun/plugin-connector`.
+                 */
+                readonly operationID: {
+                    readonly type: "string";
+                };
+                readonly deterministicEventID: {
+                    readonly type: "string";
+                };
                 readonly id: {
                     readonly type: "string";
                 };

package/lib/services/graph.js

@@ -232,6 +232,31 @@ export const mutateGraphParams = {
         },
         transactionID: {
             type: 'string'
+        },
+        invocationCaps: {
+            type: 'array',
+            items: {
+                type: 'array',
+                items: {
+                    type: 'string'
+                }
+            }
+        },
+        /**
+     * The connector operation-envelope ids for a credential-spend connector
+     * action (`connectorCreate<Model>`/`connectorUpdate<Model>`). Optional:
+     * never in `required`, so a request from an older client that omits them
+     * still validates. Not accepted by an older server, though: the params
+     * are `additionalProperties: false`, so a server that predates these
+     * fields rejects a request carrying them — the server must be upgraded
+     * before a client sends them. Forwarded onto
+     * `ExecutionContext.operationID`/`ExecutionContext.deterministicEventID`
+     * by the engine; verified downstream in `@kubun/plugin-connector`.
+     */ operationID: {
+            type: 'string'
+        },
+        deterministicEventID: {
+            type: 'string'
         }
     },
     required: [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubun/protocol",
-  "version": "0.17.0",
+  "version": "0.17.1",
   "keywords": [],
   "license": "see LICENSE.md",
   "sideEffects": false,
@@ -24,7 +24,7 @@
     "change-case": "^5.4.4"
   },
   "devDependencies": {
-    "graphql": "^16.14.2",
+    "graphql": "^17.0.2",
     "json-schema-typed": "^8.0.2"
   },
   "publishConfig": {