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

package/dist/generated/contract.d.ts

@@ -1791,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: {
@@ -1821,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;
@@ -1829,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: {
@@ -1860,7 +1925,7 @@ export declare const CONTRACT: {
                         readonly type: "string";
                     };
                 };
-                readonly required: readonly ["target", "text"];
+                readonly required: readonly ["text"];
                 readonly type: "object";
             };
             readonly outputSchema: {
@@ -2506,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: {
@@ -2531,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;
@@ -2539,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: {
@@ -2567,7 +2697,6 @@ export declare const CONTRACT: {
                         readonly type: "object";
                     };
                 };
-                readonly required: readonly ["target"];
                 readonly type: "object";
             };
             readonly outputSchema: {
@@ -3213,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: {
@@ -3238,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;
@@ -3246,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: {
@@ -3274,7 +3468,6 @@ export declare const CONTRACT: {
                         readonly type: "object";
                     };
                 };
-                readonly required: readonly ["target"];
                 readonly type: "object";
             };
             readonly outputSchema: {
@@ -3920,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: {
@@ -3945,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;
@@ -3953,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: {
@@ -3981,7 +4239,6 @@ export declare const CONTRACT: {
                         readonly type: "object";
                     };
                 };
-                readonly required: readonly ["target"];
                 readonly type: "object";
             };
             readonly outputSchema: {
@@ -4627,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: {
@@ -4652,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;
@@ -4660,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: {
@@ -4688,7 +5010,6 @@ export declare const CONTRACT: {
                         readonly type: "object";
                     };
                 };
-                readonly required: readonly ["target"];
                 readonly type: "object";
             };
             readonly outputSchema: {
@@ -5334,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: {
@@ -5359,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;
@@ -5367,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: {
@@ -5395,7 +5781,6 @@ export declare const CONTRACT: {
                         readonly type: "object";
                     };
                 };
-                readonly required: readonly ["target"];
                 readonly type: "object";
             };
             readonly outputSchema: {
@@ -6059,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";
+                        }];
                     }];
                 };
             }, {
@@ -6177,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: {
@@ -6198,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: {
@@ -6223,7 +6560,7 @@ export declare const CONTRACT: {
                                     readonly type: "object";
                                 };
                             };
-                            readonly required: readonly ["kind", "target"];
+                            readonly required: readonly ["kind"];
                             readonly type: "object";
                         }];
                     };
@@ -6818,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";
@@ -6846,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"];
                     };
@@ -6870,7 +7221,7 @@ export declare const CONTRACT: {
                         readonly type: "string";
                     };
                 };
-                readonly required: readonly ["target", "position"];
+                readonly required: readonly ["position"];
                 readonly type: "object";
             };
             readonly outputSchema: {
@@ -7137,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";
@@ -7161,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: {
@@ -7182,7 +7547,7 @@ export declare const CONTRACT: {
                         readonly type: "object";
                     };
                 };
-                readonly required: readonly ["target", "kind"];
+                readonly required: readonly ["kind"];
                 readonly type: "object";
             };
             readonly outputSchema: {
@@ -7359,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";
@@ -7372,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: {
@@ -7390,7 +7769,6 @@ export declare const CONTRACT: {
                         readonly type: "object";
                     };
                 };
-                readonly required: readonly ["target"];
                 readonly type: "object";
             };
             readonly outputSchema: {
@@ -7567,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";
@@ -7580,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: {
@@ -7598,7 +7990,6 @@ export declare const CONTRACT: {
                         readonly type: "object";
                     };
                 };
-                readonly required: readonly ["target"];
                 readonly type: "object";
             };
             readonly outputSchema: {
@@ -7775,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";
@@ -7788,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: {
@@ -7806,7 +8211,6 @@ export declare const CONTRACT: {
                         readonly type: "object";
                     };
                 };
-                readonly required: readonly ["target"];
                 readonly type: "object";
             };
             readonly outputSchema: {
@@ -7983,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";
@@ -7996,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: {
@@ -8014,7 +8432,6 @@ export declare const CONTRACT: {
                         readonly type: "object";
                     };
                 };
-                readonly required: readonly ["target"];
                 readonly type: "object";
             };
             readonly outputSchema: {
@@ -8170,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: {
@@ -8200,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;
@@ -8208,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: {
@@ -8239,7 +8721,7 @@ export declare const CONTRACT: {
                         readonly type: "string";
                     };
                 };
-                readonly required: readonly ["target", "text"];
+                readonly required: readonly ["text"];
                 readonly type: "object";
             };
             readonly outputSchema: {
@@ -9307,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: {
@@ -9332,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;
@@ -9340,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: {
@@ -9371,7 +9918,7 @@ export declare const CONTRACT: {
                         readonly type: "object";
                     };
                 };
-                readonly required: readonly ["commentId", "target"];
+                readonly required: readonly ["commentId"];
                 readonly type: "object";
             };
             readonly outputSchema: {