@superdoc-dev/sdk 1.0.0-alpha.5 → 1.0.0-alpha.7

package/dist/generated/contract.d.ts

@@ -1072,6 +1072,15 @@ export declare const CONTRACT: {
                 readonly kind: "flag";
                 readonly type: "string";
                 readonly required: true;
+            }, {
+                readonly name: "blockId";
+                readonly kind: "flag";
+                readonly type: "string";
+                readonly flag: "block-id";
+            }, {
+                readonly name: "offset";
+                readonly kind: "flag";
+                readonly type: "number";
             }];
             readonly constraints: null;
             readonly mutates: true;
@@ -1080,7 +1089,32 @@ export declare const CONTRACT: {
             readonly supportsDryRun: true;
             readonly inputSchema: {
                 readonly additionalProperties: false;
+                readonly allOf: readonly [{
+                    readonly not: {
+                        readonly required: readonly ["target", "blockId"];
+                    };
+                }, {
+                    readonly not: {
+                        readonly required: readonly ["target", "offset"];
+                    };
+                }, {
+                    readonly if: {
+                        readonly required: readonly ["offset"];
+                    };
+                    readonly then: {
+                        readonly required: readonly ["blockId"];
+                    };
+                }];
                 readonly properties: {
+                    readonly blockId: {
+                        readonly description: "Block ID for block-relative targeting.";
+                        readonly type: "string";
+                    };
+                    readonly offset: {
+                        readonly description: "Character offset within the block identified by blockId.";
+                        readonly minimum: 0;
+                        readonly type: "integer";
+                    };
                     readonly target: {
                         readonly additionalProperties: false;
                         readonly properties: {
@@ -1757,7 +1791,6 @@ export declare const CONTRACT: {
                 readonly kind: "jsonFlag";
                 readonly type: "json";
                 readonly flag: "target-json";
-                readonly required: true;
                 readonly schema: {
                     readonly type: "object";
                     readonly properties: {
@@ -1787,6 +1820,19 @@ export declare const CONTRACT: {
                 readonly kind: "flag";
                 readonly type: "string";
                 readonly required: true;
+            }, {
+                readonly name: "blockId";
+                readonly kind: "flag";
+                readonly type: "string";
+                readonly flag: "block-id";
+            }, {
+                readonly name: "start";
+                readonly kind: "flag";
+                readonly type: "number";
+            }, {
+                readonly name: "end";
+                readonly kind: "flag";
+                readonly type: "number";
             }];
             readonly constraints: null;
             readonly mutates: true;
@@ -1795,7 +1841,60 @@ export declare const CONTRACT: {
             readonly supportsDryRun: true;
             readonly inputSchema: {
                 readonly additionalProperties: false;
+                readonly allOf: readonly [{
+                    readonly not: {
+                        readonly required: readonly ["target", "blockId"];
+                    };
+                }, {
+                    readonly not: {
+                        readonly required: readonly ["target", "start"];
+                    };
+                }, {
+                    readonly not: {
+                        readonly required: readonly ["target", "end"];
+                    };
+                }, {
+                    readonly if: {
+                        readonly required: readonly ["start"];
+                    };
+                    readonly then: {
+                        readonly required: readonly ["blockId", "end"];
+                    };
+                }, {
+                    readonly if: {
+                        readonly required: readonly ["end"];
+                    };
+                    readonly then: {
+                        readonly required: readonly ["blockId", "start"];
+                    };
+                }, {
+                    readonly if: {
+                        readonly required: readonly ["blockId"];
+                    };
+                    readonly then: {
+                        readonly required: readonly ["start", "end"];
+                    };
+                }];
+                readonly anyOf: readonly [{
+                    readonly required: readonly ["target"];
+                }, {
+                    readonly required: readonly ["blockId", "start", "end"];
+                }];
                 readonly properties: {
+                    readonly blockId: {
+                        readonly description: "Block ID for block-relative range targeting.";
+                        readonly type: "string";
+                    };
+                    readonly end: {
+                        readonly description: "End offset within the block identified by blockId.";
+                        readonly minimum: 0;
+                        readonly type: "integer";
+                    };
+                    readonly start: {
+                        readonly description: "Start offset within the block identified by blockId.";
+                        readonly minimum: 0;
+                        readonly type: "integer";
+                    };
                     readonly target: {
                         readonly additionalProperties: false;
                         readonly properties: {
@@ -1826,7 +1925,7 @@ export declare const CONTRACT: {
                         readonly type: "string";
                     };
                 };
-                readonly required: readonly ["target", "text"];
+                readonly required: readonly ["text"];
                 readonly type: "object";
             };
             readonly outputSchema: {
@@ -2472,7 +2571,6 @@ export declare const CONTRACT: {
                 readonly kind: "jsonFlag";
                 readonly type: "json";
                 readonly flag: "target-json";
-                readonly required: true;
                 readonly schema: {
                     readonly type: "object";
                     readonly properties: {
@@ -2497,6 +2595,19 @@ export declare const CONTRACT: {
                     };
                     readonly required: readonly ["kind", "blockId", "range"];
                 };
+            }, {
+                readonly name: "blockId";
+                readonly kind: "flag";
+                readonly type: "string";
+                readonly flag: "block-id";
+            }, {
+                readonly name: "start";
+                readonly kind: "flag";
+                readonly type: "number";
+            }, {
+                readonly name: "end";
+                readonly kind: "flag";
+                readonly type: "number";
             }];
             readonly constraints: null;
             readonly mutates: true;
@@ -2505,7 +2616,60 @@ export declare const CONTRACT: {
             readonly supportsDryRun: true;
             readonly inputSchema: {
                 readonly additionalProperties: false;
+                readonly allOf: readonly [{
+                    readonly not: {
+                        readonly required: readonly ["target", "blockId"];
+                    };
+                }, {
+                    readonly not: {
+                        readonly required: readonly ["target", "start"];
+                    };
+                }, {
+                    readonly not: {
+                        readonly required: readonly ["target", "end"];
+                    };
+                }, {
+                    readonly if: {
+                        readonly required: readonly ["start"];
+                    };
+                    readonly then: {
+                        readonly required: readonly ["blockId", "end"];
+                    };
+                }, {
+                    readonly if: {
+                        readonly required: readonly ["end"];
+                    };
+                    readonly then: {
+                        readonly required: readonly ["blockId", "start"];
+                    };
+                }, {
+                    readonly if: {
+                        readonly required: readonly ["blockId"];
+                    };
+                    readonly then: {
+                        readonly required: readonly ["start", "end"];
+                    };
+                }];
+                readonly anyOf: readonly [{
+                    readonly required: readonly ["target"];
+                }, {
+                    readonly required: readonly ["blockId", "start", "end"];
+                }];
                 readonly properties: {
+                    readonly blockId: {
+                        readonly description: "Block ID for block-relative range targeting.";
+                        readonly type: "string";
+                    };
+                    readonly end: {
+                        readonly description: "End offset within the block identified by blockId.";
+                        readonly minimum: 0;
+                        readonly type: "integer";
+                    };
+                    readonly start: {
+                        readonly description: "Start offset within the block identified by blockId.";
+                        readonly minimum: 0;
+                        readonly type: "integer";
+                    };
                     readonly target: {
                         readonly additionalProperties: false;
                         readonly properties: {
@@ -2533,7 +2697,6 @@ export declare const CONTRACT: {
                         readonly type: "object";
                     };
                 };
-                readonly required: readonly ["target"];
                 readonly type: "object";
             };
             readonly outputSchema: {
@@ -3179,7 +3342,6 @@ export declare const CONTRACT: {
                 readonly kind: "jsonFlag";
                 readonly type: "json";
                 readonly flag: "target-json";
-                readonly required: true;
                 readonly schema: {
                     readonly type: "object";
                     readonly properties: {
@@ -3204,6 +3366,19 @@ export declare const CONTRACT: {
                     };
                     readonly required: readonly ["kind", "blockId", "range"];
                 };
+            }, {
+                readonly name: "blockId";
+                readonly kind: "flag";
+                readonly type: "string";
+                readonly flag: "block-id";
+            }, {
+                readonly name: "start";
+                readonly kind: "flag";
+                readonly type: "number";
+            }, {
+                readonly name: "end";
+                readonly kind: "flag";
+                readonly type: "number";
             }];
             readonly constraints: null;
             readonly mutates: true;
@@ -3212,7 +3387,60 @@ export declare const CONTRACT: {
             readonly supportsDryRun: true;
             readonly inputSchema: {
                 readonly additionalProperties: false;
+                readonly allOf: readonly [{
+                    readonly not: {
+                        readonly required: readonly ["target", "blockId"];
+                    };
+                }, {
+                    readonly not: {
+                        readonly required: readonly ["target", "start"];
+                    };
+                }, {
+                    readonly not: {
+                        readonly required: readonly ["target", "end"];
+                    };
+                }, {
+                    readonly if: {
+                        readonly required: readonly ["start"];
+                    };
+                    readonly then: {
+                        readonly required: readonly ["blockId", "end"];
+                    };
+                }, {
+                    readonly if: {
+                        readonly required: readonly ["end"];
+                    };
+                    readonly then: {
+                        readonly required: readonly ["blockId", "start"];
+                    };
+                }, {
+                    readonly if: {
+                        readonly required: readonly ["blockId"];
+                    };
+                    readonly then: {
+                        readonly required: readonly ["start", "end"];
+                    };
+                }];
+                readonly anyOf: readonly [{
+                    readonly required: readonly ["target"];
+                }, {
+                    readonly required: readonly ["blockId", "start", "end"];
+                }];
                 readonly properties: {
+                    readonly blockId: {
+                        readonly description: "Block ID for block-relative range targeting.";
+                        readonly type: "string";
+                    };
+                    readonly end: {
+                        readonly description: "End offset within the block identified by blockId.";
+                        readonly minimum: 0;
+                        readonly type: "integer";
+                    };
+                    readonly start: {
+                        readonly description: "Start offset within the block identified by blockId.";
+                        readonly minimum: 0;
+                        readonly type: "integer";
+                    };
                     readonly target: {
                         readonly additionalProperties: false;
                         readonly properties: {
@@ -3240,7 +3468,6 @@ export declare const CONTRACT: {
                         readonly type: "object";
                     };
                 };
-                readonly required: readonly ["target"];
                 readonly type: "object";
             };
             readonly outputSchema: {
@@ -3886,7 +4113,6 @@ export declare const CONTRACT: {
                 readonly kind: "jsonFlag";
                 readonly type: "json";
                 readonly flag: "target-json";
-                readonly required: true;
                 readonly schema: {
                     readonly type: "object";
                     readonly properties: {
@@ -3911,6 +4137,19 @@ export declare const CONTRACT: {
                     };
                     readonly required: readonly ["kind", "blockId", "range"];
                 };
+            }, {
+                readonly name: "blockId";
+                readonly kind: "flag";
+                readonly type: "string";
+                readonly flag: "block-id";
+            }, {
+                readonly name: "start";
+                readonly kind: "flag";
+                readonly type: "number";
+            }, {
+                readonly name: "end";
+                readonly kind: "flag";
+                readonly type: "number";
             }];
             readonly constraints: null;
             readonly mutates: true;
@@ -3919,7 +4158,60 @@ export declare const CONTRACT: {
             readonly supportsDryRun: true;
             readonly inputSchema: {
                 readonly additionalProperties: false;
+                readonly allOf: readonly [{
+                    readonly not: {
+                        readonly required: readonly ["target", "blockId"];
+                    };
+                }, {
+                    readonly not: {
+                        readonly required: readonly ["target", "start"];
+                    };
+                }, {
+                    readonly not: {
+                        readonly required: readonly ["target", "end"];
+                    };
+                }, {
+                    readonly if: {
+                        readonly required: readonly ["start"];
+                    };
+                    readonly then: {
+                        readonly required: readonly ["blockId", "end"];
+                    };
+                }, {
+                    readonly if: {
+                        readonly required: readonly ["end"];
+                    };
+                    readonly then: {
+                        readonly required: readonly ["blockId", "start"];
+                    };
+                }, {
+                    readonly if: {
+                        readonly required: readonly ["blockId"];
+                    };
+                    readonly then: {
+                        readonly required: readonly ["start", "end"];
+                    };
+                }];
+                readonly anyOf: readonly [{
+                    readonly required: readonly ["target"];
+                }, {
+                    readonly required: readonly ["blockId", "start", "end"];
+                }];
                 readonly properties: {
+                    readonly blockId: {
+                        readonly description: "Block ID for block-relative range targeting.";
+                        readonly type: "string";
+                    };
+                    readonly end: {
+                        readonly description: "End offset within the block identified by blockId.";
+                        readonly minimum: 0;
+                        readonly type: "integer";
+                    };
+                    readonly start: {
+                        readonly description: "Start offset within the block identified by blockId.";
+                        readonly minimum: 0;
+                        readonly type: "integer";
+                    };
                     readonly target: {
                         readonly additionalProperties: false;
                         readonly properties: {
@@ -3947,7 +4239,6 @@ export declare const CONTRACT: {
                         readonly type: "object";
                     };
                 };
-                readonly required: readonly ["target"];
                 readonly type: "object";
             };
             readonly outputSchema: {
@@ -4593,7 +4884,6 @@ export declare const CONTRACT: {
                 readonly kind: "jsonFlag";
                 readonly type: "json";
                 readonly flag: "target-json";
-                readonly required: true;
                 readonly schema: {
                     readonly type: "object";
                     readonly properties: {
@@ -4618,6 +4908,19 @@ export declare const CONTRACT: {
                     };
                     readonly required: readonly ["kind", "blockId", "range"];
                 };
+            }, {
+                readonly name: "blockId";
+                readonly kind: "flag";
+                readonly type: "string";
+                readonly flag: "block-id";
+            }, {
+                readonly name: "start";
+                readonly kind: "flag";
+                readonly type: "number";
+            }, {
+                readonly name: "end";
+                readonly kind: "flag";
+                readonly type: "number";
             }];
             readonly constraints: null;
             readonly mutates: true;
@@ -4626,7 +4929,60 @@ export declare const CONTRACT: {
             readonly supportsDryRun: true;
             readonly inputSchema: {
                 readonly additionalProperties: false;
+                readonly allOf: readonly [{
+                    readonly not: {
+                        readonly required: readonly ["target", "blockId"];
+                    };
+                }, {
+                    readonly not: {
+                        readonly required: readonly ["target", "start"];
+                    };
+                }, {
+                    readonly not: {
+                        readonly required: readonly ["target", "end"];
+                    };
+                }, {
+                    readonly if: {
+                        readonly required: readonly ["start"];
+                    };
+                    readonly then: {
+                        readonly required: readonly ["blockId", "end"];
+                    };
+                }, {
+                    readonly if: {
+                        readonly required: readonly ["end"];
+                    };
+                    readonly then: {
+                        readonly required: readonly ["blockId", "start"];
+                    };
+                }, {
+                    readonly if: {
+                        readonly required: readonly ["blockId"];
+                    };
+                    readonly then: {
+                        readonly required: readonly ["start", "end"];
+                    };
+                }];
+                readonly anyOf: readonly [{
+                    readonly required: readonly ["target"];
+                }, {
+                    readonly required: readonly ["blockId", "start", "end"];
+                }];
                 readonly properties: {
+                    readonly blockId: {
+                        readonly description: "Block ID for block-relative range targeting.";
+                        readonly type: "string";
+                    };
+                    readonly end: {
+                        readonly description: "End offset within the block identified by blockId.";
+                        readonly minimum: 0;
+                        readonly type: "integer";
+                    };
+                    readonly start: {
+                        readonly description: "Start offset within the block identified by blockId.";
+                        readonly minimum: 0;
+                        readonly type: "integer";
+                    };
                     readonly target: {
                         readonly additionalProperties: false;
                         readonly properties: {
@@ -4654,7 +5010,6 @@ export declare const CONTRACT: {
                         readonly type: "object";
                     };
                 };
-                readonly required: readonly ["target"];
                 readonly type: "object";
             };
             readonly outputSchema: {
@@ -5300,7 +5655,6 @@ export declare const CONTRACT: {
                 readonly kind: "jsonFlag";
                 readonly type: "json";
                 readonly flag: "target-json";
-                readonly required: true;
                 readonly schema: {
                     readonly type: "object";
                     readonly properties: {
@@ -5325,6 +5679,19 @@ export declare const CONTRACT: {
                     };
                     readonly required: readonly ["kind", "blockId", "range"];
                 };
+            }, {
+                readonly name: "blockId";
+                readonly kind: "flag";
+                readonly type: "string";
+                readonly flag: "block-id";
+            }, {
+                readonly name: "start";
+                readonly kind: "flag";
+                readonly type: "number";
+            }, {
+                readonly name: "end";
+                readonly kind: "flag";
+                readonly type: "number";
             }];
             readonly constraints: null;
             readonly mutates: true;
@@ -5333,7 +5700,60 @@ export declare const CONTRACT: {
             readonly supportsDryRun: true;
             readonly inputSchema: {
                 readonly additionalProperties: false;
+                readonly allOf: readonly [{
+                    readonly not: {
+                        readonly required: readonly ["target", "blockId"];
+                    };
+                }, {
+                    readonly not: {
+                        readonly required: readonly ["target", "start"];
+                    };
+                }, {
+                    readonly not: {
+                        readonly required: readonly ["target", "end"];
+                    };
+                }, {
+                    readonly if: {
+                        readonly required: readonly ["start"];
+                    };
+                    readonly then: {
+                        readonly required: readonly ["blockId", "end"];
+                    };
+                }, {
+                    readonly if: {
+                        readonly required: readonly ["end"];
+                    };
+                    readonly then: {
+                        readonly required: readonly ["blockId", "start"];
+                    };
+                }, {
+                    readonly if: {
+                        readonly required: readonly ["blockId"];
+                    };
+                    readonly then: {
+                        readonly required: readonly ["start", "end"];
+                    };
+                }];
+                readonly anyOf: readonly [{
+                    readonly required: readonly ["target"];
+                }, {
+                    readonly required: readonly ["blockId", "start", "end"];
+                }];
                 readonly properties: {
+                    readonly blockId: {
+                        readonly description: "Block ID for block-relative range targeting.";
+                        readonly type: "string";
+                    };
+                    readonly end: {
+                        readonly description: "End offset within the block identified by blockId.";
+                        readonly minimum: 0;
+                        readonly type: "integer";
+                    };
+                    readonly start: {
+                        readonly description: "Start offset within the block identified by blockId.";
+                        readonly minimum: 0;
+                        readonly type: "integer";
+                    };
                     readonly target: {
                         readonly additionalProperties: false;
                         readonly properties: {
@@ -5361,7 +5781,6 @@ export declare const CONTRACT: {
                         readonly type: "object";
                     };
                 };
-                readonly required: readonly ["target"];
                 readonly type: "object";
             };
             readonly outputSchema: {
@@ -6025,83 +6444,17 @@ export declare const CONTRACT: {
                         };
                         readonly required: readonly ["kind"];
                     }, {
-                        readonly type: "object";
-                        readonly properties: {
-                            readonly kind: {
-                                readonly const: "before";
-                            };
-                            readonly target: {
-                                readonly type: "object";
-                                readonly properties: {
-                                    readonly kind: {
-                                        readonly const: "block";
-                                    };
-                                    readonly nodeType: {
-                                        readonly oneOf: readonly [{
-                                            readonly const: "paragraph";
-                                        }, {
-                                            readonly const: "heading";
-                                        }, {
-                                            readonly const: "listItem";
-                                        }, {
-                                            readonly const: "table";
-                                        }, {
-                                            readonly const: "tableRow";
-                                        }, {
-                                            readonly const: "tableCell";
-                                        }, {
-                                            readonly const: "image";
-                                        }, {
-                                            readonly const: "sdt";
-                                        }];
-                                    };
-                                    readonly nodeId: {
-                                        readonly type: "string";
-                                    };
-                                };
-                                readonly required: readonly ["kind", "nodeType", "nodeId"];
-                            };
-                        };
-                        readonly required: readonly ["kind", "target"];
+                        readonly oneOf: readonly [{
+                            readonly type: "json";
+                        }, {
+                            readonly type: "json";
+                        }];
                     }, {
-                        readonly type: "object";
-                        readonly properties: {
-                            readonly kind: {
-                                readonly const: "after";
-                            };
-                            readonly target: {
-                                readonly type: "object";
-                                readonly properties: {
-                                    readonly kind: {
-                                        readonly const: "block";
-                                    };
-                                    readonly nodeType: {
-                                        readonly oneOf: readonly [{
-                                            readonly const: "paragraph";
-                                        }, {
-                                            readonly const: "heading";
-                                        }, {
-                                            readonly const: "listItem";
-                                        }, {
-                                            readonly const: "table";
-                                        }, {
-                                            readonly const: "tableRow";
-                                        }, {
-                                            readonly const: "tableCell";
-                                        }, {
-                                            readonly const: "image";
-                                        }, {
-                                            readonly const: "sdt";
-                                        }];
-                                    };
-                                    readonly nodeId: {
-                                        readonly type: "string";
-                                    };
-                                };
-                                readonly required: readonly ["kind", "nodeType", "nodeId"];
-                            };
-                        };
-                        readonly required: readonly ["kind", "target"];
+                        readonly oneOf: readonly [{
+                            readonly type: "json";
+                        }, {
+                            readonly type: "json";
+                        }];
                     }];
                 };
             }, {
@@ -6143,10 +6496,19 @@ export declare const CONTRACT: {
                             readonly type: "object";
                         }, {
                             readonly additionalProperties: false;
+                            readonly oneOf: readonly [{
+                                readonly required: readonly ["target"];
+                            }, {
+                                readonly required: readonly ["nodeId"];
+                            }];
                             readonly properties: {
                                 readonly kind: {
                                     readonly const: "before";
                                 };
+                                readonly nodeId: {
+                                    readonly description: "Node ID shorthand — adapter resolves to a full BlockNodeAddress.";
+                                    readonly type: "string";
+                                };
                                 readonly target: {
                                     readonly additionalProperties: false;
                                     readonly properties: {
@@ -6164,14 +6526,23 @@ export declare const CONTRACT: {
                                     readonly type: "object";
                                 };
                             };
-                            readonly required: readonly ["kind", "target"];
+                            readonly required: readonly ["kind"];
                             readonly type: "object";
                         }, {
                             readonly additionalProperties: false;
+                            readonly oneOf: readonly [{
+                                readonly required: readonly ["target"];
+                            }, {
+                                readonly required: readonly ["nodeId"];
+                            }];
                             readonly properties: {
                                 readonly kind: {
                                     readonly const: "after";
                                 };
+                                readonly nodeId: {
+                                    readonly description: "Node ID shorthand — adapter resolves to a full BlockNodeAddress.";
+                                    readonly type: "string";
+                                };
                                 readonly target: {
                                     readonly additionalProperties: false;
                                     readonly properties: {
@@ -6189,7 +6560,7 @@ export declare const CONTRACT: {
                                     readonly type: "object";
                                 };
                             };
-                            readonly required: readonly ["kind", "target"];
+                            readonly required: readonly ["kind"];
                             readonly type: "object";
                         }];
                     };
@@ -6784,6 +7155,11 @@ export declare const CONTRACT: {
                     };
                     readonly required: readonly ["kind", "nodeType", "nodeId"];
                 };
+            }, {
+                readonly name: "nodeId";
+                readonly kind: "flag";
+                readonly type: "string";
+                readonly flag: "node-id";
             }, {
                 readonly name: "position";
                 readonly kind: "flag";
@@ -6812,7 +7188,16 @@ export declare const CONTRACT: {
             readonly supportsDryRun: true;
             readonly inputSchema: {
                 readonly additionalProperties: false;
+                readonly oneOf: readonly [{
+                    readonly required: readonly ["target"];
+                }, {
+                    readonly required: readonly ["nodeId"];
+                }];
                 readonly properties: {
+                    readonly nodeId: {
+                        readonly description: "Node ID shorthand — adapter resolves to a ListItemAddress.";
+                        readonly type: "string";
+                    };
                     readonly position: {
                         readonly enum: readonly ["before", "after"];
                     };
@@ -6836,7 +7221,7 @@ export declare const CONTRACT: {
                         readonly type: "string";
                     };
                 };
-                readonly required: readonly ["target", "position"];
+                readonly required: readonly ["position"];
                 readonly type: "object";
             };
             readonly outputSchema: {
@@ -7103,6 +7488,11 @@ export declare const CONTRACT: {
                     };
                     readonly required: readonly ["kind", "nodeType", "nodeId"];
                 };
+            }, {
+                readonly name: "nodeId";
+                readonly kind: "flag";
+                readonly type: "string";
+                readonly flag: "node-id";
             }, {
                 readonly name: "kind";
                 readonly kind: "flag";
@@ -7127,10 +7517,19 @@ export declare const CONTRACT: {
             readonly supportsDryRun: true;
             readonly inputSchema: {
                 readonly additionalProperties: false;
+                readonly oneOf: readonly [{
+                    readonly required: readonly ["target"];
+                }, {
+                    readonly required: readonly ["nodeId"];
+                }];
                 readonly properties: {
                     readonly kind: {
                         readonly enum: readonly ["ordered", "bullet"];
                     };
+                    readonly nodeId: {
+                        readonly description: "Node ID shorthand — adapter resolves to a ListItemAddress.";
+                        readonly type: "string";
+                    };
                     readonly target: {
                         readonly additionalProperties: false;
                         readonly properties: {
@@ -7148,7 +7547,7 @@ export declare const CONTRACT: {
                         readonly type: "object";
                     };
                 };
-                readonly required: readonly ["target", "kind"];
+                readonly required: readonly ["kind"];
                 readonly type: "object";
             };
             readonly outputSchema: {
@@ -7325,6 +7724,11 @@ export declare const CONTRACT: {
                     };
                     readonly required: readonly ["kind", "nodeType", "nodeId"];
                 };
+            }, {
+                readonly name: "nodeId";
+                readonly kind: "flag";
+                readonly type: "string";
+                readonly flag: "node-id";
             }, {
                 readonly name: "input";
                 readonly kind: "jsonFlag";
@@ -7338,7 +7742,16 @@ export declare const CONTRACT: {
             readonly supportsDryRun: true;
             readonly inputSchema: {
                 readonly additionalProperties: false;
+                readonly oneOf: readonly [{
+                    readonly required: readonly ["target"];
+                }, {
+                    readonly required: readonly ["nodeId"];
+                }];
                 readonly properties: {
+                    readonly nodeId: {
+                        readonly description: "Node ID shorthand — adapter resolves to a ListItemAddress.";
+                        readonly type: "string";
+                    };
                     readonly target: {
                         readonly additionalProperties: false;
                         readonly properties: {
@@ -7356,7 +7769,6 @@ export declare const CONTRACT: {
                         readonly type: "object";
                     };
                 };
-                readonly required: readonly ["target"];
                 readonly type: "object";
             };
             readonly outputSchema: {
@@ -7533,6 +7945,11 @@ export declare const CONTRACT: {
                     };
                     readonly required: readonly ["kind", "nodeType", "nodeId"];
                 };
+            }, {
+                readonly name: "nodeId";
+                readonly kind: "flag";
+                readonly type: "string";
+                readonly flag: "node-id";
             }, {
                 readonly name: "input";
                 readonly kind: "jsonFlag";
@@ -7546,7 +7963,16 @@ export declare const CONTRACT: {
             readonly supportsDryRun: true;
             readonly inputSchema: {
                 readonly additionalProperties: false;
+                readonly oneOf: readonly [{
+                    readonly required: readonly ["target"];
+                }, {
+                    readonly required: readonly ["nodeId"];
+                }];
                 readonly properties: {
+                    readonly nodeId: {
+                        readonly description: "Node ID shorthand — adapter resolves to a ListItemAddress.";
+                        readonly type: "string";
+                    };
                     readonly target: {
                         readonly additionalProperties: false;
                         readonly properties: {
@@ -7564,7 +7990,6 @@ export declare const CONTRACT: {
                         readonly type: "object";
                     };
                 };
-                readonly required: readonly ["target"];
                 readonly type: "object";
             };
             readonly outputSchema: {
@@ -7741,6 +8166,11 @@ export declare const CONTRACT: {
                     };
                     readonly required: readonly ["kind", "nodeType", "nodeId"];
                 };
+            }, {
+                readonly name: "nodeId";
+                readonly kind: "flag";
+                readonly type: "string";
+                readonly flag: "node-id";
             }, {
                 readonly name: "input";
                 readonly kind: "jsonFlag";
@@ -7754,7 +8184,16 @@ export declare const CONTRACT: {
             readonly supportsDryRun: true;
             readonly inputSchema: {
                 readonly additionalProperties: false;
+                readonly oneOf: readonly [{
+                    readonly required: readonly ["target"];
+                }, {
+                    readonly required: readonly ["nodeId"];
+                }];
                 readonly properties: {
+                    readonly nodeId: {
+                        readonly description: "Node ID shorthand — adapter resolves to a ListItemAddress.";
+                        readonly type: "string";
+                    };
                     readonly target: {
                         readonly additionalProperties: false;
                         readonly properties: {
@@ -7772,7 +8211,6 @@ export declare const CONTRACT: {
                         readonly type: "object";
                     };
                 };
-                readonly required: readonly ["target"];
                 readonly type: "object";
             };
             readonly outputSchema: {
@@ -7949,6 +8387,11 @@ export declare const CONTRACT: {
                     };
                     readonly required: readonly ["kind", "nodeType", "nodeId"];
                 };
+            }, {
+                readonly name: "nodeId";
+                readonly kind: "flag";
+                readonly type: "string";
+                readonly flag: "node-id";
             }, {
                 readonly name: "input";
                 readonly kind: "jsonFlag";
@@ -7962,7 +8405,16 @@ export declare const CONTRACT: {
             readonly supportsDryRun: true;
             readonly inputSchema: {
                 readonly additionalProperties: false;
+                readonly oneOf: readonly [{
+                    readonly required: readonly ["target"];
+                }, {
+                    readonly required: readonly ["nodeId"];
+                }];
                 readonly properties: {
+                    readonly nodeId: {
+                        readonly description: "Node ID shorthand — adapter resolves to a ListItemAddress.";
+                        readonly type: "string";
+                    };
                     readonly target: {
                         readonly additionalProperties: false;
                         readonly properties: {
@@ -7980,7 +8432,6 @@ export declare const CONTRACT: {
                         readonly type: "object";
                     };
                 };
-                readonly required: readonly ["target"];
                 readonly type: "object";
             };
             readonly outputSchema: {
@@ -8136,7 +8587,6 @@ export declare const CONTRACT: {
                 readonly kind: "jsonFlag";
                 readonly type: "json";
                 readonly flag: "target-json";
-                readonly required: true;
                 readonly schema: {
                     readonly type: "object";
                     readonly properties: {
@@ -8166,6 +8616,19 @@ export declare const CONTRACT: {
                 readonly kind: "flag";
                 readonly type: "string";
                 readonly required: true;
+            }, {
+                readonly name: "blockId";
+                readonly kind: "flag";
+                readonly type: "string";
+                readonly flag: "block-id";
+            }, {
+                readonly name: "start";
+                readonly kind: "flag";
+                readonly type: "number";
+            }, {
+                readonly name: "end";
+                readonly kind: "flag";
+                readonly type: "number";
             }];
             readonly constraints: null;
             readonly mutates: true;
@@ -8174,7 +8637,60 @@ export declare const CONTRACT: {
             readonly supportsDryRun: false;
             readonly inputSchema: {
                 readonly additionalProperties: false;
+                readonly allOf: readonly [{
+                    readonly not: {
+                        readonly required: readonly ["target", "blockId"];
+                    };
+                }, {
+                    readonly not: {
+                        readonly required: readonly ["target", "start"];
+                    };
+                }, {
+                    readonly not: {
+                        readonly required: readonly ["target", "end"];
+                    };
+                }, {
+                    readonly if: {
+                        readonly required: readonly ["start"];
+                    };
+                    readonly then: {
+                        readonly required: readonly ["blockId", "end"];
+                    };
+                }, {
+                    readonly if: {
+                        readonly required: readonly ["end"];
+                    };
+                    readonly then: {
+                        readonly required: readonly ["blockId", "start"];
+                    };
+                }, {
+                    readonly if: {
+                        readonly required: readonly ["blockId"];
+                    };
+                    readonly then: {
+                        readonly required: readonly ["start", "end"];
+                    };
+                }];
+                readonly anyOf: readonly [{
+                    readonly required: readonly ["target"];
+                }, {
+                    readonly required: readonly ["blockId", "start", "end"];
+                }];
                 readonly properties: {
+                    readonly blockId: {
+                        readonly description: "Block ID for block-relative range targeting.";
+                        readonly type: "string";
+                    };
+                    readonly end: {
+                        readonly description: "End offset within the block identified by blockId.";
+                        readonly minimum: 0;
+                        readonly type: "integer";
+                    };
+                    readonly start: {
+                        readonly description: "Start offset within the block identified by blockId.";
+                        readonly minimum: 0;
+                        readonly type: "integer";
+                    };
                     readonly target: {
                         readonly additionalProperties: false;
                         readonly properties: {
@@ -8205,7 +8721,7 @@ export declare const CONTRACT: {
                         readonly type: "string";
                     };
                 };
-                readonly required: readonly ["target", "text"];
+                readonly required: readonly ["text"];
                 readonly type: "object";
             };
             readonly outputSchema: {
@@ -9273,7 +9789,6 @@ export declare const CONTRACT: {
                 readonly kind: "jsonFlag";
                 readonly type: "json";
                 readonly flag: "target-json";
-                readonly required: true;
                 readonly schema: {
                     readonly type: "object";
                     readonly properties: {
@@ -9298,6 +9813,19 @@ export declare const CONTRACT: {
                     };
                     readonly required: readonly ["kind", "blockId", "range"];
                 };
+            }, {
+                readonly name: "blockId";
+                readonly kind: "flag";
+                readonly type: "string";
+                readonly flag: "block-id";
+            }, {
+                readonly name: "start";
+                readonly kind: "flag";
+                readonly type: "number";
+            }, {
+                readonly name: "end";
+                readonly kind: "flag";
+                readonly type: "number";
             }];
             readonly constraints: null;
             readonly mutates: true;
@@ -9306,10 +9834,63 @@ export declare const CONTRACT: {
             readonly supportsDryRun: false;
             readonly inputSchema: {
                 readonly additionalProperties: false;
+                readonly allOf: readonly [{
+                    readonly not: {
+                        readonly required: readonly ["target", "blockId"];
+                    };
+                }, {
+                    readonly not: {
+                        readonly required: readonly ["target", "start"];
+                    };
+                }, {
+                    readonly not: {
+                        readonly required: readonly ["target", "end"];
+                    };
+                }, {
+                    readonly if: {
+                        readonly required: readonly ["start"];
+                    };
+                    readonly then: {
+                        readonly required: readonly ["blockId", "end"];
+                    };
+                }, {
+                    readonly if: {
+                        readonly required: readonly ["end"];
+                    };
+                    readonly then: {
+                        readonly required: readonly ["blockId", "start"];
+                    };
+                }, {
+                    readonly if: {
+                        readonly required: readonly ["blockId"];
+                    };
+                    readonly then: {
+                        readonly required: readonly ["start", "end"];
+                    };
+                }];
+                readonly anyOf: readonly [{
+                    readonly required: readonly ["target"];
+                }, {
+                    readonly required: readonly ["blockId", "start", "end"];
+                }];
                 readonly properties: {
+                    readonly blockId: {
+                        readonly description: "Block ID for block-relative range targeting.";
+                        readonly type: "string";
+                    };
                     readonly commentId: {
                         readonly type: "string";
                     };
+                    readonly end: {
+                        readonly description: "End offset within the block identified by blockId.";
+                        readonly minimum: 0;
+                        readonly type: "integer";
+                    };
+                    readonly start: {
+                        readonly description: "Start offset within the block identified by blockId.";
+                        readonly minimum: 0;
+                        readonly type: "integer";
+                    };
                     readonly target: {
                         readonly additionalProperties: false;
                         readonly properties: {
@@ -9337,7 +9918,7 @@ export declare const CONTRACT: {
                         readonly type: "object";
                     };
                 };
-                readonly required: readonly ["commentId", "target"];
+                readonly required: readonly ["commentId"];
                 readonly type: "object";
             };
             readonly outputSchema: {