@superdoc-dev/sdk 1.0.0-alpha.1 → 1.0.0-alpha.2

package/src/generated/client.ts

@@ -6,29 +6,44 @@ import type { SuperDocRuntime, InvokeOptions } from '../runtime/process';
 
 export interface DocOpenParams {
   doc: string;
-  replace?: boolean;
   sessionId?: string;
-  collaboration?: Record<string, unknown> | unknown[];
+  collaboration?: {
+    providerType: string;
+    url: string;
+    documentId: string;
+    tokenEnv?: string;
+    syncTimeoutMs?: number;
+  };
 }
 
 export interface DocStatusParams {
   sessionId?: string;
 }
 
-export interface DocCloseParams {
+export interface DocSaveParams {
   sessionId?: string;
-  save?: boolean;
   inPlace?: boolean;
   out?: string;
-  discard?: boolean;
   force?: boolean;
 }
 
+export interface DocCloseParams {
+  sessionId?: string;
+  discard?: boolean;
+}
+
 export interface DocInfoParams {
   doc?: string;
   sessionId?: string;
 }
 
+export interface DocDescribeParams {
+}
+
+export interface DocDescribeCommandParams {
+  operationId: string;
+}
+
 export interface DocFindParams {
   doc?: string;
   sessionId?: string;
@@ -42,14 +57,79 @@ export interface DocFindParams {
   offset?: number;
   include?: string[];
   includeUnknown?: boolean;
-  query?: Record<string, unknown> | unknown[];
-  within?: Record<string, unknown> | unknown[];
+  query?: {
+    select: {
+      type: string;
+      nodeType?: string;
+      kind?: "block" | "inline";
+      pattern?: string;
+      mode?: "contains" | "regex";
+      caseSensitive?: boolean;
+    };
+    within?: ({
+      kind: "block";
+      nodeType: "paragraph" | "heading" | "listItem" | "table" | "tableRow" | "tableCell" | "blockquote" | "codeBlock" | "image" | "sdt" | "field";
+      nodeId: string;
+    }) | ({
+      kind: "inline";
+      nodeType: "run" | "field" | "bookmark" | "comment" | "hyperlink" | "sdt" | "image" | "footnoteRef" | "tab" | "lineBreak";
+      anchor: {
+        start: {
+          blockId: string;
+          offset: number;
+        };
+        end: {
+          blockId: string;
+          offset: number;
+        };
+      };
+    });
+    limit?: number;
+    offset?: number;
+    include?: Array<string>;
+    includeUnknown?: boolean;
+  };
+  within?: ({
+    kind: "block";
+    nodeType: "paragraph" | "heading" | "listItem" | "table" | "tableRow" | "tableCell" | "blockquote" | "codeBlock" | "image" | "sdt" | "field";
+    nodeId: string;
+  }) | ({
+    kind: "inline";
+    nodeType: "run" | "field" | "bookmark" | "comment" | "hyperlink" | "sdt" | "image" | "footnoteRef" | "tab" | "lineBreak";
+    anchor: {
+      start: {
+        blockId: string;
+        offset: number;
+      };
+      end: {
+        blockId: string;
+        offset: number;
+      };
+    };
+  });
 }
 
 export interface DocGetNodeParams {
   doc?: string;
   sessionId?: string;
-  address: Record<string, unknown> | unknown[];
+  address: ({
+    kind: "block";
+    nodeType: "paragraph" | "heading" | "listItem" | "table" | "tableRow" | "tableCell" | "blockquote" | "codeBlock" | "image" | "sdt" | "field";
+    nodeId: string;
+  }) | ({
+    kind: "inline";
+    nodeType: "run" | "field" | "bookmark" | "comment" | "hyperlink" | "sdt" | "image" | "footnoteRef" | "tab" | "lineBreak";
+    anchor: {
+      start: {
+        blockId: string;
+        offset: number;
+      };
+      end: {
+        blockId: string;
+        offset: number;
+      };
+    };
+  });
 }
 
 export interface DocGetNodeByIdParams {
@@ -62,7 +142,14 @@ export interface DocGetNodeByIdParams {
 export interface DocCommentsAddParams {
   doc?: string;
   sessionId?: string;
-  target: Record<string, unknown> | unknown[];
+  target: {
+    kind: "text";
+    blockId: string;
+    range: {
+      start: number;
+      end: number;
+    };
+  };
   text: string;
   out?: string;
   force?: boolean;
@@ -93,7 +180,14 @@ export interface DocCommentsMoveParams {
   doc?: string;
   sessionId?: string;
   id: string;
-  target: Record<string, unknown> | unknown[];
+  target: {
+    kind: "text";
+    blockId: string;
+    range: {
+      start: number;
+      end: number;
+    };
+  };
   out?: string;
   force?: boolean;
   expectedRevision?: number;
@@ -152,10 +246,38 @@ export interface DocCommentsListParams {
   includeResolved?: boolean;
 }
 
+export interface DocCreateParagraphParams {
+  doc?: string;
+  sessionId?: string;
+  input?: {
+    at?: {
+      kind: string;
+      target?: {
+        kind: string;
+        nodeType: string;
+        nodeId: string;
+      };
+    };
+    text?: string;
+  };
+  changeMode?: string;
+  out?: string;
+  dryRun?: boolean;
+  force?: boolean;
+  expectedRevision?: number;
+}
+
 export interface DocInsertParams {
   doc?: string;
   sessionId?: string;
-  target: Record<string, unknown> | unknown[];
+  target?: {
+    kind: "text";
+    blockId: string;
+    range: {
+      start: number;
+      end: number;
+    };
+  };
   text: string;
   changeMode?: string;
   out?: string;
@@ -167,7 +289,14 @@ export interface DocInsertParams {
 export interface DocReplaceParams {
   doc?: string;
   sessionId?: string;
-  target: Record<string, unknown> | unknown[];
+  target: {
+    kind: "text";
+    blockId: string;
+    range: {
+      start: number;
+      end: number;
+    };
+  };
   text: string;
   changeMode?: string;
   out?: string;
@@ -179,7 +308,14 @@ export interface DocReplaceParams {
 export interface DocDeleteParams {
   doc?: string;
   sessionId?: string;
-  target: Record<string, unknown> | unknown[];
+  target: {
+    kind: "text";
+    blockId: string;
+    range: {
+      start: number;
+      end: number;
+    };
+  };
   changeMode?: string;
   out?: string;
   dryRun?: boolean;
@@ -190,7 +326,14 @@ export interface DocDeleteParams {
 export interface DocFormatBoldParams {
   doc?: string;
   sessionId?: string;
-  target: Record<string, unknown> | unknown[];
+  target: {
+    kind: "text";
+    blockId: string;
+    range: {
+      start: number;
+      end: number;
+    };
+  };
   changeMode?: string;
   out?: string;
   dryRun?: boolean;
@@ -249,15 +392,18 @@ export interface DocTrackChangesRejectAllParams {
 export interface DocSessionListParams {
 }
 
-export interface DocSessionCloseParams {
+export interface DocSessionSaveParams {
   sessionId: string;
-  save?: boolean;
   inPlace?: boolean;
   out?: string;
-  discard?: boolean;
   force?: boolean;
 }
 
+export interface DocSessionCloseParams {
+  sessionId: string;
+  discard?: boolean;
+}
+
 export interface DocSessionSetDefaultParams {
   sessionId: string;
 }
@@ -265,7 +411,6 @@ export interface DocSessionSetDefaultParams {
 export type DocOpenResult = {
   active: boolean;
   contextId: string;
-  replaced: boolean;
   document: {
     path?: string;
     source: string;
@@ -311,6 +456,26 @@ export type DocStatusResult = {
   lastSavedAt?: string;
 };
 
+export type DocSaveResult = {
+  contextId: string;
+  saved: boolean;
+  inPlace: boolean;
+  document: {
+    path?: string;
+    source: string;
+    revision: number;
+  };
+  context: {
+    dirty: boolean;
+    revision: number;
+    lastSavedAt?: string;
+  };
+  output: {
+    path: string;
+    byteLength: number;
+  };
+};
+
 export type DocCloseResult = {
   contextId: string;
   closed: boolean;
@@ -357,6 +522,91 @@ export type DocInfoResult = {
   };
 };
 
+export type DocDescribeResult = {
+  contractVersion: string;
+  cli: {
+    package: string;
+    minVersion: string;
+    binaryName: string;
+  };
+  protocol: {
+    defaultOutput: string;
+    successEnvelope: Array<string>;
+    errorEnvelope: Array<string>;
+    host: {
+      protocolVersion: string;
+      features: Array<string>;
+      notifications: Array<string>;
+    };
+  };
+  invariants: Array<string>;
+  operationCount: number;
+  operations: Array<{
+    id: string;
+    command: Array<string>;
+    description: string;
+    category: string;
+    stability: string;
+    mutates: boolean;
+    requiresOpenContext: boolean;
+    capabilities?: Array<string>;
+    aliases?: Array<string>;
+    examples?: Array<string>;
+    errors?: Array<string>;
+  }>;
+};
+
+export type DocDescribeCommandResult = {
+  contractVersion: string;
+  query: string;
+  operation: {
+    id: string;
+    command: Array<string>;
+    description: string;
+    category: string;
+    stability: string;
+    mutates: boolean;
+    requiresOpenContext: boolean;
+    capabilities?: Array<string>;
+    aliases?: Array<string>;
+    examples?: Array<string>;
+    params: Array<{
+      name: string;
+      kind: string;
+      type: string;
+      flag?: string;
+      required?: boolean;
+      schema?: ({
+        type: string;
+        items?: unknown;
+        properties?: unknown;
+        required?: Array<string>;
+      }) | ({
+        oneOf: Array<unknown>;
+      });
+    }>;
+    constraints?: {
+      mutuallyExclusive?: Array<Array<string>>;
+      requiresOneOf?: Array<Array<string>>;
+      requiredWhen?: Array<{
+        param: string;
+        whenParam: string;
+        equals?: unknown;
+        present?: boolean;
+      }>;
+    };
+    response: ({
+      type: string;
+      items?: unknown;
+      properties?: unknown;
+      required?: Array<string>;
+    }) | ({
+      oneOf: Array<unknown>;
+    });
+    errors: Array<string>;
+  };
+};
+
 export type DocFindResult = {
   document: {
     path?: string;
@@ -364,8 +614,507 @@ export type DocFindResult = {
     byteLength: number;
     revision: number;
   };
-  query: unknown;
-  result: unknown;
+  query: {
+    select: {
+      type: string;
+      nodeType?: string;
+      kind?: "block" | "inline";
+      pattern?: string;
+      mode?: "contains" | "regex";
+      caseSensitive?: boolean;
+    };
+    within?: ({
+      kind: "block";
+      nodeType: "paragraph" | "heading" | "listItem" | "table" | "tableRow" | "tableCell" | "blockquote" | "codeBlock" | "image" | "sdt" | "field";
+      nodeId: string;
+    }) | ({
+      kind: "inline";
+      nodeType: "run" | "field" | "bookmark" | "comment" | "hyperlink" | "sdt" | "image" | "footnoteRef" | "tab" | "lineBreak";
+      anchor: {
+        start: {
+          blockId: string;
+          offset: number;
+        };
+        end: {
+          blockId: string;
+          offset: number;
+        };
+      };
+    });
+    limit?: number;
+    offset?: number;
+    include?: Array<string>;
+    includeUnknown?: boolean;
+  };
+  result: {
+    matches: Array<({
+      kind: "block";
+      nodeType: "paragraph" | "heading" | "listItem" | "table" | "tableRow" | "tableCell" | "blockquote" | "codeBlock" | "image" | "sdt" | "field";
+      nodeId: string;
+    }) | ({
+      kind: "inline";
+      nodeType: "run" | "field" | "bookmark" | "comment" | "hyperlink" | "sdt" | "image" | "footnoteRef" | "tab" | "lineBreak";
+      anchor: {
+        start: {
+          blockId: string;
+          offset: number;
+        };
+        end: {
+          blockId: string;
+          offset: number;
+        };
+      };
+    })>;
+    total: number;
+    nodes?: Array<({
+      summary?: {
+        label?: string;
+        text?: string;
+      };
+      text?: string;
+      nodes?: Array<unknown>;
+      nodeType: "paragraph";
+      kind: "block";
+      properties: {
+        styleId?: string;
+        alignment?: string;
+        indentation?: {
+          left?: number;
+          right?: number;
+          firstLine?: number;
+          hanging?: number;
+          unit?: string;
+        };
+        spacing?: {
+          before?: number;
+          after?: number;
+          line?: number;
+          unit?: string;
+        };
+        keepWithNext?: boolean;
+        outlineLevel?: number;
+        paragraphNumbering?: {
+          numId?: number;
+          level?: number;
+        };
+      };
+    }) | ({
+      summary?: {
+        label?: string;
+        text?: string;
+      };
+      text?: string;
+      nodes?: Array<unknown>;
+      nodeType: "heading";
+      kind: "block";
+      properties: {
+        styleId?: string;
+        alignment?: string;
+        indentation?: {
+          left?: number;
+          right?: number;
+          firstLine?: number;
+          hanging?: number;
+          unit?: string;
+        };
+        spacing?: {
+          before?: number;
+          after?: number;
+          line?: number;
+          unit?: string;
+        };
+        keepWithNext?: boolean;
+        outlineLevel?: number;
+        paragraphNumbering?: {
+          numId?: number;
+          level?: number;
+        };
+        headingLevel: 1 | 2 | 3 | 4 | 5 | 6;
+      };
+    }) | ({
+      summary?: {
+        label?: string;
+        text?: string;
+      };
+      text?: string;
+      nodes?: Array<unknown>;
+      nodeType: "listItem";
+      kind: "block";
+      properties: {
+        styleId?: string;
+        alignment?: string;
+        indentation?: {
+          left?: number;
+          right?: number;
+          firstLine?: number;
+          hanging?: number;
+          unit?: string;
+        };
+        spacing?: {
+          before?: number;
+          after?: number;
+          line?: number;
+          unit?: string;
+        };
+        keepWithNext?: boolean;
+        outlineLevel?: number;
+        paragraphNumbering?: {
+          numId?: number;
+          level?: number;
+        };
+        numbering?: {
+          marker?: string;
+          path?: Array<number>;
+          ordinal?: number;
+          listIndex?: number;
+        };
+      };
+    }) | ({
+      summary?: {
+        label?: string;
+        text?: string;
+      };
+      text?: string;
+      nodes?: Array<unknown>;
+      nodeType: "table";
+      kind: "block";
+      properties: {
+        layout?: string;
+        width?: number;
+        alignment?: string;
+        borders?: {
+          top?: string;
+          right?: string;
+          bottom?: string;
+          left?: string;
+          insideH?: string;
+          insideV?: string;
+        };
+      };
+    }) | ({
+      summary?: {
+        label?: string;
+        text?: string;
+      };
+      text?: string;
+      nodes?: Array<unknown>;
+      nodeType: "tableRow";
+      kind: "block";
+      properties: {
+        rowIndex?: number;
+      };
+    }) | ({
+      summary?: {
+        label?: string;
+        text?: string;
+      };
+      text?: string;
+      nodes?: Array<unknown>;
+      nodeType: "tableCell";
+      kind: "block";
+      properties: {
+        rowIndex?: number;
+        colIndex?: number;
+        width?: number;
+        shading?: string;
+        vMerge?: boolean;
+        gridSpan?: number;
+        padding?: number;
+        borders?: {
+          top?: string;
+          right?: string;
+          bottom?: string;
+          left?: string;
+          insideH?: string;
+          insideV?: string;
+        };
+      };
+    }) | ({
+      summary?: {
+        label?: string;
+        text?: string;
+      };
+      text?: string;
+      nodes?: Array<unknown>;
+      nodeType: "blockquote";
+      kind: "block";
+      properties: {
+      };
+    }) | ({
+      summary?: {
+        label?: string;
+        text?: string;
+      };
+      text?: string;
+      nodes?: Array<unknown>;
+      nodeType: "codeBlock";
+      kind: "block";
+      properties: {
+      };
+    }) | ({
+      summary?: {
+        label?: string;
+        text?: string;
+      };
+      text?: string;
+      nodes?: Array<unknown>;
+      nodeType: "image";
+      kind: "block";
+      properties: {
+        src?: string;
+        alt?: string;
+        size?: {
+          width?: number;
+          height?: number;
+          unit?: string;
+        };
+        wrap?: string;
+      };
+    }) | ({
+      summary?: {
+        label?: string;
+        text?: string;
+      };
+      text?: string;
+      nodes?: Array<unknown>;
+      nodeType: "image";
+      kind: "inline";
+      properties: {
+        src?: string;
+        alt?: string;
+        size?: {
+          width?: number;
+          height?: number;
+          unit?: string;
+        };
+        wrap?: string;
+      };
+    }) | ({
+      summary?: {
+        label?: string;
+        text?: string;
+      };
+      text?: string;
+      nodes?: Array<unknown>;
+      nodeType: "sdt";
+      kind: "block";
+      properties: {
+        tag?: string;
+        alias?: string;
+        type?: string;
+        appearance?: string;
+        placeholder?: string;
+      };
+    }) | ({
+      summary?: {
+        label?: string;
+        text?: string;
+      };
+      text?: string;
+      nodes?: Array<unknown>;
+      nodeType: "sdt";
+      kind: "inline";
+      properties: {
+        tag?: string;
+        alias?: string;
+        type?: string;
+        appearance?: string;
+        placeholder?: string;
+      };
+    }) | ({
+      summary?: {
+        label?: string;
+        text?: string;
+      };
+      text?: string;
+      nodes?: Array<unknown>;
+      nodeType: "field";
+      kind: "block";
+      properties: {
+        tag?: string;
+        alias?: string;
+        type?: string;
+        appearance?: string;
+        placeholder?: string;
+        fieldType?: string;
+        instruction?: string;
+        resultText?: string;
+      };
+    }) | ({
+      summary?: {
+        label?: string;
+        text?: string;
+      };
+      text?: string;
+      nodes?: Array<unknown>;
+      nodeType: "field";
+      kind: "inline";
+      properties: {
+        tag?: string;
+        alias?: string;
+        type?: string;
+        appearance?: string;
+        placeholder?: string;
+        fieldType?: string;
+        instruction?: string;
+        resultText?: string;
+      };
+    }) | ({
+      summary?: {
+        label?: string;
+        text?: string;
+      };
+      text?: string;
+      nodes?: Array<unknown>;
+      nodeType: "run";
+      kind: "inline";
+      properties: {
+        bold?: boolean;
+        italic?: boolean;
+        underline?: boolean;
+        font?: string;
+        size?: number;
+        color?: string;
+        highlight?: string;
+        styleId?: string;
+        language?: string;
+      };
+    }) | ({
+      summary?: {
+        label?: string;
+        text?: string;
+      };
+      text?: string;
+      nodes?: Array<unknown>;
+      nodeType: "bookmark";
+      kind: "inline";
+      properties: {
+        name?: string;
+        bookmarkId?: string;
+      };
+    }) | ({
+      summary?: {
+        label?: string;
+        text?: string;
+      };
+      text?: string;
+      nodes?: Array<unknown>;
+      nodeType: "comment";
+      kind: "inline";
+      properties: {
+        commentId: string;
+        author?: string;
+        status?: string;
+        createdAt?: string;
+        commentText?: string;
+      };
+      bodyText?: string;
+      bodyNodes?: Array<unknown>;
+    }) | ({
+      summary?: {
+        label?: string;
+        text?: string;
+      };
+      text?: string;
+      nodes?: Array<unknown>;
+      nodeType: "hyperlink";
+      kind: "inline";
+      properties: {
+        href?: string;
+        anchor?: string;
+        tooltip?: string;
+      };
+    }) | ({
+      summary?: {
+        label?: string;
+        text?: string;
+      };
+      text?: string;
+      nodes?: Array<unknown>;
+      nodeType: "footnoteRef";
+      kind: "inline";
+      properties: {
+        noteId?: string;
+      };
+    }) | ({
+      summary?: {
+        label?: string;
+        text?: string;
+      };
+      text?: string;
+      nodes?: Array<unknown>;
+      nodeType: "tab";
+      kind: "inline";
+      properties: {
+      };
+    }) | ({
+      summary?: {
+        label?: string;
+        text?: string;
+      };
+      text?: string;
+      nodes?: Array<unknown>;
+      nodeType: "lineBreak";
+      kind: "inline";
+      properties: {
+      };
+    })>;
+    context?: Array<{
+      address: ({
+        kind: "block";
+        nodeType: "paragraph" | "heading" | "listItem" | "table" | "tableRow" | "tableCell" | "blockquote" | "codeBlock" | "image" | "sdt" | "field";
+        nodeId: string;
+      }) | ({
+        kind: "inline";
+        nodeType: "run" | "field" | "bookmark" | "comment" | "hyperlink" | "sdt" | "image" | "footnoteRef" | "tab" | "lineBreak";
+        anchor: {
+          start: {
+            blockId: string;
+            offset: number;
+          };
+          end: {
+            blockId: string;
+            offset: number;
+          };
+        };
+      });
+      snippet: string;
+      highlightRange: {
+        start: number;
+        end: number;
+      };
+      textRanges?: Array<{
+        kind: "text";
+        blockId: string;
+        range: {
+          start: number;
+          end: number;
+        };
+      }>;
+    }>;
+    diagnostics?: Array<{
+      message: string;
+      address?: ({
+        kind: "block";
+        nodeType: "paragraph" | "heading" | "listItem" | "table" | "tableRow" | "tableCell" | "blockquote" | "codeBlock" | "image" | "sdt" | "field";
+        nodeId: string;
+      }) | ({
+        kind: "inline";
+        nodeType: "run" | "field" | "bookmark" | "comment" | "hyperlink" | "sdt" | "image" | "footnoteRef" | "tab" | "lineBreak";
+        anchor: {
+          start: {
+            blockId: string;
+            offset: number;
+          };
+          end: {
+            blockId: string;
+            offset: number;
+          };
+        };
+      });
+      hint?: string;
+    }>;
+  };
 };
 
 export type DocGetNodeResult = {
@@ -375,8 +1124,417 @@ export type DocGetNodeResult = {
     byteLength: number;
     revision: number;
   };
-  address: unknown;
-  node: unknown;
+  address: ({
+    kind: "block";
+    nodeType: "paragraph" | "heading" | "listItem" | "table" | "tableRow" | "tableCell" | "blockquote" | "codeBlock" | "image" | "sdt" | "field";
+    nodeId: string;
+  }) | ({
+    kind: "inline";
+    nodeType: "run" | "field" | "bookmark" | "comment" | "hyperlink" | "sdt" | "image" | "footnoteRef" | "tab" | "lineBreak";
+    anchor: {
+      start: {
+        blockId: string;
+        offset: number;
+      };
+      end: {
+        blockId: string;
+        offset: number;
+      };
+    };
+  });
+  node: ({
+    summary?: {
+      label?: string;
+      text?: string;
+    };
+    text?: string;
+    nodes?: Array<unknown>;
+    nodeType: "paragraph";
+    kind: "block";
+    properties: {
+      styleId?: string;
+      alignment?: string;
+      indentation?: {
+        left?: number;
+        right?: number;
+        firstLine?: number;
+        hanging?: number;
+        unit?: string;
+      };
+      spacing?: {
+        before?: number;
+        after?: number;
+        line?: number;
+        unit?: string;
+      };
+      keepWithNext?: boolean;
+      outlineLevel?: number;
+      paragraphNumbering?: {
+        numId?: number;
+        level?: number;
+      };
+    };
+  }) | ({
+    summary?: {
+      label?: string;
+      text?: string;
+    };
+    text?: string;
+    nodes?: Array<unknown>;
+    nodeType: "heading";
+    kind: "block";
+    properties: {
+      styleId?: string;
+      alignment?: string;
+      indentation?: {
+        left?: number;
+        right?: number;
+        firstLine?: number;
+        hanging?: number;
+        unit?: string;
+      };
+      spacing?: {
+        before?: number;
+        after?: number;
+        line?: number;
+        unit?: string;
+      };
+      keepWithNext?: boolean;
+      outlineLevel?: number;
+      paragraphNumbering?: {
+        numId?: number;
+        level?: number;
+      };
+      headingLevel: 1 | 2 | 3 | 4 | 5 | 6;
+    };
+  }) | ({
+    summary?: {
+      label?: string;
+      text?: string;
+    };
+    text?: string;
+    nodes?: Array<unknown>;
+    nodeType: "listItem";
+    kind: "block";
+    properties: {
+      styleId?: string;
+      alignment?: string;
+      indentation?: {
+        left?: number;
+        right?: number;
+        firstLine?: number;
+        hanging?: number;
+        unit?: string;
+      };
+      spacing?: {
+        before?: number;
+        after?: number;
+        line?: number;
+        unit?: string;
+      };
+      keepWithNext?: boolean;
+      outlineLevel?: number;
+      paragraphNumbering?: {
+        numId?: number;
+        level?: number;
+      };
+      numbering?: {
+        marker?: string;
+        path?: Array<number>;
+        ordinal?: number;
+        listIndex?: number;
+      };
+    };
+  }) | ({
+    summary?: {
+      label?: string;
+      text?: string;
+    };
+    text?: string;
+    nodes?: Array<unknown>;
+    nodeType: "table";
+    kind: "block";
+    properties: {
+      layout?: string;
+      width?: number;
+      alignment?: string;
+      borders?: {
+        top?: string;
+        right?: string;
+        bottom?: string;
+        left?: string;
+        insideH?: string;
+        insideV?: string;
+      };
+    };
+  }) | ({
+    summary?: {
+      label?: string;
+      text?: string;
+    };
+    text?: string;
+    nodes?: Array<unknown>;
+    nodeType: "tableRow";
+    kind: "block";
+    properties: {
+      rowIndex?: number;
+    };
+  }) | ({
+    summary?: {
+      label?: string;
+      text?: string;
+    };
+    text?: string;
+    nodes?: Array<unknown>;
+    nodeType: "tableCell";
+    kind: "block";
+    properties: {
+      rowIndex?: number;
+      colIndex?: number;
+      width?: number;
+      shading?: string;
+      vMerge?: boolean;
+      gridSpan?: number;
+      padding?: number;
+      borders?: {
+        top?: string;
+        right?: string;
+        bottom?: string;
+        left?: string;
+        insideH?: string;
+        insideV?: string;
+      };
+    };
+  }) | ({
+    summary?: {
+      label?: string;
+      text?: string;
+    };
+    text?: string;
+    nodes?: Array<unknown>;
+    nodeType: "blockquote";
+    kind: "block";
+    properties: {
+    };
+  }) | ({
+    summary?: {
+      label?: string;
+      text?: string;
+    };
+    text?: string;
+    nodes?: Array<unknown>;
+    nodeType: "codeBlock";
+    kind: "block";
+    properties: {
+    };
+  }) | ({
+    summary?: {
+      label?: string;
+      text?: string;
+    };
+    text?: string;
+    nodes?: Array<unknown>;
+    nodeType: "image";
+    kind: "block";
+    properties: {
+      src?: string;
+      alt?: string;
+      size?: {
+        width?: number;
+        height?: number;
+        unit?: string;
+      };
+      wrap?: string;
+    };
+  }) | ({
+    summary?: {
+      label?: string;
+      text?: string;
+    };
+    text?: string;
+    nodes?: Array<unknown>;
+    nodeType: "image";
+    kind: "inline";
+    properties: {
+      src?: string;
+      alt?: string;
+      size?: {
+        width?: number;
+        height?: number;
+        unit?: string;
+      };
+      wrap?: string;
+    };
+  }) | ({
+    summary?: {
+      label?: string;
+      text?: string;
+    };
+    text?: string;
+    nodes?: Array<unknown>;
+    nodeType: "sdt";
+    kind: "block";
+    properties: {
+      tag?: string;
+      alias?: string;
+      type?: string;
+      appearance?: string;
+      placeholder?: string;
+    };
+  }) | ({
+    summary?: {
+      label?: string;
+      text?: string;
+    };
+    text?: string;
+    nodes?: Array<unknown>;
+    nodeType: "sdt";
+    kind: "inline";
+    properties: {
+      tag?: string;
+      alias?: string;
+      type?: string;
+      appearance?: string;
+      placeholder?: string;
+    };
+  }) | ({
+    summary?: {
+      label?: string;
+      text?: string;
+    };
+    text?: string;
+    nodes?: Array<unknown>;
+    nodeType: "field";
+    kind: "block";
+    properties: {
+      tag?: string;
+      alias?: string;
+      type?: string;
+      appearance?: string;
+      placeholder?: string;
+      fieldType?: string;
+      instruction?: string;
+      resultText?: string;
+    };
+  }) | ({
+    summary?: {
+      label?: string;
+      text?: string;
+    };
+    text?: string;
+    nodes?: Array<unknown>;
+    nodeType: "field";
+    kind: "inline";
+    properties: {
+      tag?: string;
+      alias?: string;
+      type?: string;
+      appearance?: string;
+      placeholder?: string;
+      fieldType?: string;
+      instruction?: string;
+      resultText?: string;
+    };
+  }) | ({
+    summary?: {
+      label?: string;
+      text?: string;
+    };
+    text?: string;
+    nodes?: Array<unknown>;
+    nodeType: "run";
+    kind: "inline";
+    properties: {
+      bold?: boolean;
+      italic?: boolean;
+      underline?: boolean;
+      font?: string;
+      size?: number;
+      color?: string;
+      highlight?: string;
+      styleId?: string;
+      language?: string;
+    };
+  }) | ({
+    summary?: {
+      label?: string;
+      text?: string;
+    };
+    text?: string;
+    nodes?: Array<unknown>;
+    nodeType: "bookmark";
+    kind: "inline";
+    properties: {
+      name?: string;
+      bookmarkId?: string;
+    };
+  }) | ({
+    summary?: {
+      label?: string;
+      text?: string;
+    };
+    text?: string;
+    nodes?: Array<unknown>;
+    nodeType: "comment";
+    kind: "inline";
+    properties: {
+      commentId: string;
+      author?: string;
+      status?: string;
+      createdAt?: string;
+      commentText?: string;
+    };
+    bodyText?: string;
+    bodyNodes?: Array<unknown>;
+  }) | ({
+    summary?: {
+      label?: string;
+      text?: string;
+    };
+    text?: string;
+    nodes?: Array<unknown>;
+    nodeType: "hyperlink";
+    kind: "inline";
+    properties: {
+      href?: string;
+      anchor?: string;
+      tooltip?: string;
+    };
+  }) | ({
+    summary?: {
+      label?: string;
+      text?: string;
+    };
+    text?: string;
+    nodes?: Array<unknown>;
+    nodeType: "footnoteRef";
+    kind: "inline";
+    properties: {
+      noteId?: string;
+    };
+  }) | ({
+    summary?: {
+      label?: string;
+      text?: string;
+    };
+    text?: string;
+    nodes?: Array<unknown>;
+    nodeType: "tab";
+    kind: "inline";
+    properties: {
+    };
+  }) | ({
+    summary?: {
+      label?: string;
+      text?: string;
+    };
+    text?: string;
+    nodes?: Array<unknown>;
+    nodeType: "lineBreak";
+    kind: "inline";
+    properties: {
+    };
+  });
 };
 
 export type DocGetNodeByIdResult = {
@@ -388,7 +1546,399 @@ export type DocGetNodeByIdResult = {
   };
   nodeId: string;
   nodeType?: string;
-  node: unknown;
+  node: ({
+    summary?: {
+      label?: string;
+      text?: string;
+    };
+    text?: string;
+    nodes?: Array<unknown>;
+    nodeType: "paragraph";
+    kind: "block";
+    properties: {
+      styleId?: string;
+      alignment?: string;
+      indentation?: {
+        left?: number;
+        right?: number;
+        firstLine?: number;
+        hanging?: number;
+        unit?: string;
+      };
+      spacing?: {
+        before?: number;
+        after?: number;
+        line?: number;
+        unit?: string;
+      };
+      keepWithNext?: boolean;
+      outlineLevel?: number;
+      paragraphNumbering?: {
+        numId?: number;
+        level?: number;
+      };
+    };
+  }) | ({
+    summary?: {
+      label?: string;
+      text?: string;
+    };
+    text?: string;
+    nodes?: Array<unknown>;
+    nodeType: "heading";
+    kind: "block";
+    properties: {
+      styleId?: string;
+      alignment?: string;
+      indentation?: {
+        left?: number;
+        right?: number;
+        firstLine?: number;
+        hanging?: number;
+        unit?: string;
+      };
+      spacing?: {
+        before?: number;
+        after?: number;
+        line?: number;
+        unit?: string;
+      };
+      keepWithNext?: boolean;
+      outlineLevel?: number;
+      paragraphNumbering?: {
+        numId?: number;
+        level?: number;
+      };
+      headingLevel: 1 | 2 | 3 | 4 | 5 | 6;
+    };
+  }) | ({
+    summary?: {
+      label?: string;
+      text?: string;
+    };
+    text?: string;
+    nodes?: Array<unknown>;
+    nodeType: "listItem";
+    kind: "block";
+    properties: {
+      styleId?: string;
+      alignment?: string;
+      indentation?: {
+        left?: number;
+        right?: number;
+        firstLine?: number;
+        hanging?: number;
+        unit?: string;
+      };
+      spacing?: {
+        before?: number;
+        after?: number;
+        line?: number;
+        unit?: string;
+      };
+      keepWithNext?: boolean;
+      outlineLevel?: number;
+      paragraphNumbering?: {
+        numId?: number;
+        level?: number;
+      };
+      numbering?: {
+        marker?: string;
+        path?: Array<number>;
+        ordinal?: number;
+        listIndex?: number;
+      };
+    };
+  }) | ({
+    summary?: {
+      label?: string;
+      text?: string;
+    };
+    text?: string;
+    nodes?: Array<unknown>;
+    nodeType: "table";
+    kind: "block";
+    properties: {
+      layout?: string;
+      width?: number;
+      alignment?: string;
+      borders?: {
+        top?: string;
+        right?: string;
+        bottom?: string;
+        left?: string;
+        insideH?: string;
+        insideV?: string;
+      };
+    };
+  }) | ({
+    summary?: {
+      label?: string;
+      text?: string;
+    };
+    text?: string;
+    nodes?: Array<unknown>;
+    nodeType: "tableRow";
+    kind: "block";
+    properties: {
+      rowIndex?: number;
+    };
+  }) | ({
+    summary?: {
+      label?: string;
+      text?: string;
+    };
+    text?: string;
+    nodes?: Array<unknown>;
+    nodeType: "tableCell";
+    kind: "block";
+    properties: {
+      rowIndex?: number;
+      colIndex?: number;
+      width?: number;
+      shading?: string;
+      vMerge?: boolean;
+      gridSpan?: number;
+      padding?: number;
+      borders?: {
+        top?: string;
+        right?: string;
+        bottom?: string;
+        left?: string;
+        insideH?: string;
+        insideV?: string;
+      };
+    };
+  }) | ({
+    summary?: {
+      label?: string;
+      text?: string;
+    };
+    text?: string;
+    nodes?: Array<unknown>;
+    nodeType: "blockquote";
+    kind: "block";
+    properties: {
+    };
+  }) | ({
+    summary?: {
+      label?: string;
+      text?: string;
+    };
+    text?: string;
+    nodes?: Array<unknown>;
+    nodeType: "codeBlock";
+    kind: "block";
+    properties: {
+    };
+  }) | ({
+    summary?: {
+      label?: string;
+      text?: string;
+    };
+    text?: string;
+    nodes?: Array<unknown>;
+    nodeType: "image";
+    kind: "block";
+    properties: {
+      src?: string;
+      alt?: string;
+      size?: {
+        width?: number;
+        height?: number;
+        unit?: string;
+      };
+      wrap?: string;
+    };
+  }) | ({
+    summary?: {
+      label?: string;
+      text?: string;
+    };
+    text?: string;
+    nodes?: Array<unknown>;
+    nodeType: "image";
+    kind: "inline";
+    properties: {
+      src?: string;
+      alt?: string;
+      size?: {
+        width?: number;
+        height?: number;
+        unit?: string;
+      };
+      wrap?: string;
+    };
+  }) | ({
+    summary?: {
+      label?: string;
+      text?: string;
+    };
+    text?: string;
+    nodes?: Array<unknown>;
+    nodeType: "sdt";
+    kind: "block";
+    properties: {
+      tag?: string;
+      alias?: string;
+      type?: string;
+      appearance?: string;
+      placeholder?: string;
+    };
+  }) | ({
+    summary?: {
+      label?: string;
+      text?: string;
+    };
+    text?: string;
+    nodes?: Array<unknown>;
+    nodeType: "sdt";
+    kind: "inline";
+    properties: {
+      tag?: string;
+      alias?: string;
+      type?: string;
+      appearance?: string;
+      placeholder?: string;
+    };
+  }) | ({
+    summary?: {
+      label?: string;
+      text?: string;
+    };
+    text?: string;
+    nodes?: Array<unknown>;
+    nodeType: "field";
+    kind: "block";
+    properties: {
+      tag?: string;
+      alias?: string;
+      type?: string;
+      appearance?: string;
+      placeholder?: string;
+      fieldType?: string;
+      instruction?: string;
+      resultText?: string;
+    };
+  }) | ({
+    summary?: {
+      label?: string;
+      text?: string;
+    };
+    text?: string;
+    nodes?: Array<unknown>;
+    nodeType: "field";
+    kind: "inline";
+    properties: {
+      tag?: string;
+      alias?: string;
+      type?: string;
+      appearance?: string;
+      placeholder?: string;
+      fieldType?: string;
+      instruction?: string;
+      resultText?: string;
+    };
+  }) | ({
+    summary?: {
+      label?: string;
+      text?: string;
+    };
+    text?: string;
+    nodes?: Array<unknown>;
+    nodeType: "run";
+    kind: "inline";
+    properties: {
+      bold?: boolean;
+      italic?: boolean;
+      underline?: boolean;
+      font?: string;
+      size?: number;
+      color?: string;
+      highlight?: string;
+      styleId?: string;
+      language?: string;
+    };
+  }) | ({
+    summary?: {
+      label?: string;
+      text?: string;
+    };
+    text?: string;
+    nodes?: Array<unknown>;
+    nodeType: "bookmark";
+    kind: "inline";
+    properties: {
+      name?: string;
+      bookmarkId?: string;
+    };
+  }) | ({
+    summary?: {
+      label?: string;
+      text?: string;
+    };
+    text?: string;
+    nodes?: Array<unknown>;
+    nodeType: "comment";
+    kind: "inline";
+    properties: {
+      commentId: string;
+      author?: string;
+      status?: string;
+      createdAt?: string;
+      commentText?: string;
+    };
+    bodyText?: string;
+    bodyNodes?: Array<unknown>;
+  }) | ({
+    summary?: {
+      label?: string;
+      text?: string;
+    };
+    text?: string;
+    nodes?: Array<unknown>;
+    nodeType: "hyperlink";
+    kind: "inline";
+    properties: {
+      href?: string;
+      anchor?: string;
+      tooltip?: string;
+    };
+  }) | ({
+    summary?: {
+      label?: string;
+      text?: string;
+    };
+    text?: string;
+    nodes?: Array<unknown>;
+    nodeType: "footnoteRef";
+    kind: "inline";
+    properties: {
+      noteId?: string;
+    };
+  }) | ({
+    summary?: {
+      label?: string;
+      text?: string;
+    };
+    text?: string;
+    nodes?: Array<unknown>;
+    nodeType: "tab";
+    kind: "inline";
+    properties: {
+    };
+  }) | ({
+    summary?: {
+      label?: string;
+      text?: string;
+    };
+    text?: string;
+    nodes?: Array<unknown>;
+    nodeType: "lineBreak";
+    kind: "inline";
+    properties: {
+    };
+  });
 };
 
 export type DocCommentsAddResult = {
@@ -398,9 +1948,38 @@ export type DocCommentsAddResult = {
     byteLength: number;
     revision: number;
   };
-  target: unknown;
+  target: {
+    kind: "text";
+    blockId: string;
+    range: {
+      start: number;
+      end: number;
+    };
+  };
   text: string;
-  receipt: unknown;
+  receipt: {
+    success: boolean;
+    inserted?: Array<{
+      kind: string;
+      entityType: string;
+      entityId: string;
+    }>;
+    updated?: Array<{
+      kind: string;
+      entityType: string;
+      entityId: string;
+    }>;
+    removed?: Array<{
+      kind: string;
+      entityType: string;
+      entityId: string;
+    }>;
+    failure?: {
+      code: string;
+      message: string;
+      details?: unknown;
+    };
+  };
   context?: {
     dirty: boolean;
     revision: number;
@@ -420,7 +1999,29 @@ export type DocCommentsEditResult = {
   };
   id: string;
   text: string;
-  receipt: unknown;
+  receipt: {
+    success: boolean;
+    inserted?: Array<{
+      kind: string;
+      entityType: string;
+      entityId: string;
+    }>;
+    updated?: Array<{
+      kind: string;
+      entityType: string;
+      entityId: string;
+    }>;
+    removed?: Array<{
+      kind: string;
+      entityType: string;
+      entityId: string;
+    }>;
+    failure?: {
+      code: string;
+      message: string;
+      details?: unknown;
+    };
+  };
   context?: {
     dirty: boolean;
     revision: number;
@@ -440,7 +2041,29 @@ export type DocCommentsReplyResult = {
   };
   parentId: string;
   text: string;
-  receipt: unknown;
+  receipt: {
+    success: boolean;
+    inserted?: Array<{
+      kind: string;
+      entityType: string;
+      entityId: string;
+    }>;
+    updated?: Array<{
+      kind: string;
+      entityType: string;
+      entityId: string;
+    }>;
+    removed?: Array<{
+      kind: string;
+      entityType: string;
+      entityId: string;
+    }>;
+    failure?: {
+      code: string;
+      message: string;
+      details?: unknown;
+    };
+  };
   context?: {
     dirty: boolean;
     revision: number;
@@ -459,8 +2082,37 @@ export type DocCommentsMoveResult = {
     revision: number;
   };
   id: string;
-  target: unknown;
-  receipt: unknown;
+  target: {
+    kind: "text";
+    blockId: string;
+    range: {
+      start: number;
+      end: number;
+    };
+  };
+  receipt: {
+    success: boolean;
+    inserted?: Array<{
+      kind: string;
+      entityType: string;
+      entityId: string;
+    }>;
+    updated?: Array<{
+      kind: string;
+      entityType: string;
+      entityId: string;
+    }>;
+    removed?: Array<{
+      kind: string;
+      entityType: string;
+      entityId: string;
+    }>;
+    failure?: {
+      code: string;
+      message: string;
+      details?: unknown;
+    };
+  };
   context?: {
     dirty: boolean;
     revision: number;
@@ -479,7 +2131,29 @@ export type DocCommentsResolveResult = {
     revision: number;
   };
   id: string;
-  receipt: unknown;
+  receipt: {
+    success: boolean;
+    inserted?: Array<{
+      kind: string;
+      entityType: string;
+      entityId: string;
+    }>;
+    updated?: Array<{
+      kind: string;
+      entityType: string;
+      entityId: string;
+    }>;
+    removed?: Array<{
+      kind: string;
+      entityType: string;
+      entityId: string;
+    }>;
+    failure?: {
+      code: string;
+      message: string;
+      details?: unknown;
+    };
+  };
   context?: {
     dirty: boolean;
     revision: number;
@@ -498,7 +2172,29 @@ export type DocCommentsRemoveResult = {
     revision: number;
   };
   id: string;
-  receipt: unknown;
+  receipt: {
+    success: boolean;
+    inserted?: Array<{
+      kind: string;
+      entityType: string;
+      entityId: string;
+    }>;
+    updated?: Array<{
+      kind: string;
+      entityType: string;
+      entityId: string;
+    }>;
+    removed?: Array<{
+      kind: string;
+      entityType: string;
+      entityId: string;
+    }>;
+    failure?: {
+      code: string;
+      message: string;
+      details?: unknown;
+    };
+  };
   context?: {
     dirty: boolean;
     revision: number;
@@ -518,7 +2214,29 @@ export type DocCommentsSetInternalResult = {
   };
   id: string;
   isInternal: boolean;
-  receipt: unknown;
+  receipt: {
+    success: boolean;
+    inserted?: Array<{
+      kind: string;
+      entityType: string;
+      entityId: string;
+    }>;
+    updated?: Array<{
+      kind: string;
+      entityType: string;
+      entityId: string;
+    }>;
+    removed?: Array<{
+      kind: string;
+      entityType: string;
+      entityId: string;
+    }>;
+    failure?: {
+      code: string;
+      message: string;
+      details?: unknown;
+    };
+  };
   context?: {
     dirty: boolean;
     revision: number;
@@ -536,8 +2254,30 @@ export type DocCommentsSetActiveResult = {
     byteLength: number;
     revision: number;
   };
-  id: string;
-  receipt: unknown;
+  id?: string;
+  receipt: {
+    success: boolean;
+    inserted?: Array<{
+      kind: string;
+      entityType: string;
+      entityId: string;
+    }>;
+    updated?: Array<{
+      kind: string;
+      entityType: string;
+      entityId: string;
+    }>;
+    removed?: Array<{
+      kind: string;
+      entityType: string;
+      entityId: string;
+    }>;
+    failure?: {
+      code: string;
+      message: string;
+      details?: unknown;
+    };
+  };
 };
 
 export type DocCommentsGoToResult = {
@@ -548,7 +2288,29 @@ export type DocCommentsGoToResult = {
     revision: number;
   };
   id: string;
-  receipt: unknown;
+  receipt: {
+    success: boolean;
+    inserted?: Array<{
+      kind: string;
+      entityType: string;
+      entityId: string;
+    }>;
+    updated?: Array<{
+      kind: string;
+      entityType: string;
+      entityId: string;
+    }>;
+    removed?: Array<{
+      kind: string;
+      entityType: string;
+      entityId: string;
+    }>;
+    failure?: {
+      code: string;
+      message: string;
+      details?: unknown;
+    };
+  };
 };
 
 export type DocCommentsGetResult = {
@@ -559,7 +2321,30 @@ export type DocCommentsGetResult = {
     revision: number;
   };
   id: string;
-  comment: unknown;
+  comment: {
+    address: {
+      kind: string;
+      entityType: string;
+      entityId: string;
+    };
+    commentId: string;
+    importedId?: string;
+    parentCommentId?: string;
+    text?: string;
+    isInternal?: boolean;
+    status: string;
+    target?: {
+      kind: "text";
+      blockId: string;
+      range: {
+        start: number;
+        end: number;
+      };
+    };
+    createdTime?: number;
+    creatorName?: string;
+    creatorEmail?: string;
+  };
 };
 
 export type DocCommentsListResult = {
@@ -569,102 +2354,457 @@ export type DocCommentsListResult = {
     byteLength: number;
     revision: number;
   };
-  query: unknown;
-  result: unknown;
+  query: {
+    includeResolved?: boolean;
+  };
+  result: {
+    matches: Array<{
+      address: {
+        kind: string;
+        entityType: string;
+        entityId: string;
+      };
+      commentId: string;
+      importedId?: string;
+      parentCommentId?: string;
+      text?: string;
+      isInternal?: boolean;
+      status: string;
+      target?: {
+        kind: "text";
+        blockId: string;
+        range: {
+          start: number;
+          end: number;
+        };
+      };
+      createdTime?: number;
+      creatorName?: string;
+      creatorEmail?: string;
+    }>;
+    total: number;
+  };
 };
 
-export type DocInsertResult = {
+export type DocCreateParagraphResult = ({
   document: {
     path?: string;
     source: string;
     byteLength: number;
     revision: number;
   };
-  target: unknown;
-  text?: string;
-  changeMode?: string;
-  dryRun?: boolean;
-  proposed?: unknown;
-  receipt?: unknown;
+  input: {
+    at?: {
+      kind: string;
+      target?: {
+        kind: string;
+        nodeType: string;
+        nodeId: string;
+      };
+    };
+    text?: string;
+  };
+  changeMode: "direct" | "tracked";
+  dryRun: true;
+  proposed: {
+    kind: string;
+    position: number;
+    targetNodeId?: string;
+  };
   context?: {
     dirty: boolean;
     revision: number;
   };
   output?: {
     path: string;
+    skippedWrite: true;
+  };
+}) | ({
+  document: {
+    path?: string;
+    source: string;
     byteLength: number;
+    revision: number;
   };
-};
+  input: {
+    at?: {
+      kind: string;
+      target?: {
+        kind: string;
+        nodeType: string;
+        nodeId: string;
+      };
+    };
+    text?: string;
+  };
+  changeMode: "direct" | "tracked";
+  dryRun: false;
+  result: {
+    success: boolean;
+    paragraph?: {
+      kind: string;
+      nodeType: string;
+      nodeId: string;
+    };
+    insertionPoint?: {
+      kind: "text";
+      blockId: string;
+      range: {
+        start: number;
+        end: number;
+      };
+    };
+    trackedChangeRefs?: Array<{
+      kind: string;
+      entityType: string;
+      entityId: string;
+    }>;
+    failure?: {
+      code: string;
+      message: string;
+      details?: unknown;
+    };
+  };
+  context?: {
+    dirty: boolean;
+    revision: number;
+  };
+  output?: {
+    path: string;
+    byteLength: number;
+  };
+});
 
-export type DocReplaceResult = {
+export type DocInsertResult = ({
   document: {
     path?: string;
     source: string;
     byteLength: number;
     revision: number;
   };
-  target: unknown;
-  changeMode?: string;
-  dryRun?: boolean;
-  proposed?: unknown;
-  receipt?: unknown;
-  from?: string;
-  to?: string;
+  target: {
+    kind: "text";
+    blockId: string;
+    range: {
+      start: number;
+      end: number;
+    };
+  };
+  text: string;
+  changeMode: "direct" | "tracked";
+  dryRun: true;
+  proposed: {
+    at: number;
+    text: string;
+  };
   context?: {
     dirty: boolean;
     revision: number;
   };
   output?: {
     path: string;
+    skippedWrite: true;
+  };
+}) | ({
+  document: {
+    path?: string;
+    source: string;
     byteLength: number;
+    revision: number;
   };
-};
+  target: {
+    kind: "text";
+    blockId: string;
+    range: {
+      start: number;
+      end: number;
+    };
+  };
+  text: string;
+  changeMode: "direct" | "tracked";
+  dryRun: false;
+  receipt: {
+    success: boolean;
+    inserted?: Array<{
+      kind: string;
+      entityType: string;
+      entityId: string;
+    }>;
+    updated?: Array<{
+      kind: string;
+      entityType: string;
+      entityId: string;
+    }>;
+    removed?: Array<{
+      kind: string;
+      entityType: string;
+      entityId: string;
+    }>;
+    failure?: {
+      code: string;
+      message: string;
+      details?: unknown;
+    };
+  };
+  context?: {
+    dirty: boolean;
+    revision: number;
+  };
+  output?: {
+    path: string;
+    byteLength: number;
+  };
+});
 
-export type DocDeleteResult = {
+export type DocReplaceResult = ({
   document: {
     path?: string;
     source: string;
     byteLength: number;
     revision: number;
   };
-  target: unknown;
-  changeMode?: string;
-  dryRun?: boolean;
-  proposed?: unknown;
-  receipt?: unknown;
-  removedText?: string;
+  target: {
+    kind: "text";
+    blockId: string;
+    range: {
+      start: number;
+      end: number;
+    };
+  };
+  changeMode: "direct" | "tracked";
+  dryRun: true;
+  proposed: {
+    target: {
+      kind: "text";
+      blockId: string;
+      range: {
+        start: number;
+        end: number;
+      };
+    };
+    text: string;
+  };
   context?: {
     dirty: boolean;
     revision: number;
   };
   output?: {
     path: string;
+    skippedWrite: true;
+  };
+}) | ({
+  document: {
+    path?: string;
+    source: string;
     byteLength: number;
+    revision: number;
   };
-};
+  target: {
+    kind: "text";
+    blockId: string;
+    range: {
+      start: number;
+      end: number;
+    };
+  };
+  changeMode: "direct" | "tracked";
+  dryRun: false;
+  receipt: {
+    success: boolean;
+    inserted?: Array<{
+      kind: string;
+      entityType: string;
+      entityId: string;
+    }>;
+    updated?: Array<{
+      kind: string;
+      entityType: string;
+      entityId: string;
+    }>;
+    removed?: Array<{
+      kind: string;
+      entityType: string;
+      entityId: string;
+    }>;
+    failure?: {
+      code: string;
+      message: string;
+      details?: unknown;
+    };
+  };
+  to: string;
+  context?: {
+    dirty: boolean;
+    revision: number;
+  };
+  output?: {
+    path: string;
+    byteLength: number;
+  };
+});
 
-export type DocFormatBoldResult = {
+export type DocDeleteResult = ({
   document: {
     path?: string;
     source: string;
     byteLength: number;
     revision: number;
   };
-  target: unknown;
-  changeMode?: string;
-  dryRun?: boolean;
-  proposed?: unknown;
-  receipt?: unknown;
-  selectedText?: string;
+  target: {
+    kind: "text";
+    blockId: string;
+    range: {
+      start: number;
+      end: number;
+    };
+  };
+  changeMode: "direct" | "tracked";
+  dryRun: true;
+  proposed: {
+    from: number;
+    to: number;
+    removedText: string;
+  };
   context?: {
     dirty: boolean;
     revision: number;
   };
   output?: {
     path: string;
+    skippedWrite: true;
+  };
+}) | ({
+  document: {
+    path?: string;
+    source: string;
     byteLength: number;
+    revision: number;
   };
-};
+  target: {
+    kind: "text";
+    blockId: string;
+    range: {
+      start: number;
+      end: number;
+    };
+  };
+  changeMode: "direct" | "tracked";
+  dryRun: false;
+  receipt: {
+    success: boolean;
+    inserted?: Array<{
+      kind: string;
+      entityType: string;
+      entityId: string;
+    }>;
+    updated?: Array<{
+      kind: string;
+      entityType: string;
+      entityId: string;
+    }>;
+    removed?: Array<{
+      kind: string;
+      entityType: string;
+      entityId: string;
+    }>;
+    failure?: {
+      code: string;
+      message: string;
+      details?: unknown;
+    };
+  };
+  removedText: string;
+  context?: {
+    dirty: boolean;
+    revision: number;
+  };
+  output?: {
+    path: string;
+    byteLength: number;
+  };
+});
+
+export type DocFormatBoldResult = ({
+  document: {
+    path?: string;
+    source: string;
+    byteLength: number;
+    revision: number;
+  };
+  target: {
+    kind: "text";
+    blockId: string;
+    range: {
+      start: number;
+      end: number;
+    };
+  };
+  changeMode: "direct" | "tracked";
+  dryRun: true;
+  proposed: {
+    from: number;
+    to: number;
+    selectedText: string;
+    mark: string;
+  };
+  context?: {
+    dirty: boolean;
+    revision: number;
+  };
+  output?: {
+    path: string;
+    skippedWrite: true;
+  };
+}) | ({
+  document: {
+    path?: string;
+    source: string;
+    byteLength: number;
+    revision: number;
+  };
+  target: {
+    kind: "text";
+    blockId: string;
+    range: {
+      start: number;
+      end: number;
+    };
+  };
+  changeMode: "direct" | "tracked";
+  dryRun: false;
+  receipt: {
+    success: boolean;
+    inserted?: Array<{
+      kind: string;
+      entityType: string;
+      entityId: string;
+    }>;
+    updated?: Array<{
+      kind: string;
+      entityType: string;
+      entityId: string;
+    }>;
+    removed?: Array<{
+      kind: string;
+      entityType: string;
+      entityId: string;
+    }>;
+    failure?: {
+      code: string;
+      message: string;
+      details?: unknown;
+    };
+  };
+  selectedText: string;
+  context?: {
+    dirty: boolean;
+    revision: number;
+  };
+  output?: {
+    path: string;
+    byteLength: number;
+  };
+});
 
 export type DocTrackChangesListResult = {
   document: {
@@ -673,8 +2813,33 @@ export type DocTrackChangesListResult = {
     byteLength: number;
     revision: number;
   };
-  query: unknown;
-  result: unknown;
+  query: {
+    limit?: number;
+    offset?: number;
+    type?: "insert" | "delete" | "format";
+  };
+  result: {
+    matches: Array<{
+      kind: string;
+      entityType: string;
+      entityId: string;
+    }>;
+    total: number;
+    changes?: Array<{
+      address: {
+        kind: string;
+        entityType: string;
+        entityId: string;
+      };
+      id: string;
+      type: "insert" | "delete" | "format";
+      author?: string;
+      authorEmail?: string;
+      authorImage?: string;
+      date?: string;
+      excerpt?: string;
+    }>;
+  };
 };
 
 export type DocTrackChangesGetResult = {
@@ -685,7 +2850,20 @@ export type DocTrackChangesGetResult = {
     revision: number;
   };
   id: string;
-  change: unknown;
+  change: {
+    address: {
+      kind: string;
+      entityType: string;
+      entityId: string;
+    };
+    id: string;
+    type: "insert" | "delete" | "format";
+    author?: string;
+    authorEmail?: string;
+    authorImage?: string;
+    date?: string;
+    excerpt?: string;
+  };
 };
 
 export type DocTrackChangesAcceptResult = {
@@ -696,7 +2874,29 @@ export type DocTrackChangesAcceptResult = {
     revision: number;
   };
   id: string;
-  receipt: unknown;
+  receipt: {
+    success: boolean;
+    inserted?: Array<{
+      kind: string;
+      entityType: string;
+      entityId: string;
+    }>;
+    updated?: Array<{
+      kind: string;
+      entityType: string;
+      entityId: string;
+    }>;
+    removed?: Array<{
+      kind: string;
+      entityType: string;
+      entityId: string;
+    }>;
+    failure?: {
+      code: string;
+      message: string;
+      details?: unknown;
+    };
+  };
   context?: {
     dirty: boolean;
     revision: number;
@@ -715,7 +2915,29 @@ export type DocTrackChangesRejectResult = {
     revision: number;
   };
   id: string;
-  receipt: unknown;
+  receipt: {
+    success: boolean;
+    inserted?: Array<{
+      kind: string;
+      entityType: string;
+      entityId: string;
+    }>;
+    updated?: Array<{
+      kind: string;
+      entityType: string;
+      entityId: string;
+    }>;
+    removed?: Array<{
+      kind: string;
+      entityType: string;
+      entityId: string;
+    }>;
+    failure?: {
+      code: string;
+      message: string;
+      details?: unknown;
+    };
+  };
   context?: {
     dirty: boolean;
     revision: number;
@@ -733,7 +2955,29 @@ export type DocTrackChangesAcceptAllResult = {
     byteLength: number;
     revision: number;
   };
-  receipt: unknown;
+  receipt: {
+    success: boolean;
+    inserted?: Array<{
+      kind: string;
+      entityType: string;
+      entityId: string;
+    }>;
+    updated?: Array<{
+      kind: string;
+      entityType: string;
+      entityId: string;
+    }>;
+    removed?: Array<{
+      kind: string;
+      entityType: string;
+      entityId: string;
+    }>;
+    failure?: {
+      code: string;
+      message: string;
+      details?: unknown;
+    };
+  };
   context?: {
     dirty: boolean;
     revision: number;
@@ -751,7 +2995,29 @@ export type DocTrackChangesRejectAllResult = {
     byteLength: number;
     revision: number;
   };
-  receipt: unknown;
+  receipt: {
+    success: boolean;
+    inserted?: Array<{
+      kind: string;
+      entityType: string;
+      entityId: string;
+    }>;
+    updated?: Array<{
+      kind: string;
+      entityType: string;
+      entityId: string;
+    }>;
+    removed?: Array<{
+      kind: string;
+      entityType: string;
+      entityId: string;
+    }>;
+    failure?: {
+      code: string;
+      message: string;
+      details?: unknown;
+    };
+  };
   context?: {
     dirty: boolean;
     revision: number;
@@ -785,6 +3051,27 @@ export type DocSessionListResult = {
   total: number;
 };
 
+export type DocSessionSaveResult = {
+  sessionId: string;
+  contextId: string;
+  saved: boolean;
+  inPlace: boolean;
+  document: {
+    path?: string;
+    source: string;
+    revision: number;
+  };
+  context: {
+    dirty: boolean;
+    revision: number;
+    lastSavedAt?: string;
+  };
+  output: {
+    path: string;
+    byteLength: number;
+  };
+};
+
 export type DocSessionCloseResult = {
   sessionId: string;
   contextId: string;
@@ -814,8 +3101,11 @@ export function createDocApi(runtime: SuperDocRuntime) {
   return {
     open: (params: DocOpenParams, options?: InvokeOptions) => runtime.invoke<DocOpenResult>(OPERATION_MAP["doc.open"], params as unknown as Record<string, unknown>, options),
     status: (params: DocStatusParams = {}, options?: InvokeOptions) => runtime.invoke<DocStatusResult>(OPERATION_MAP["doc.status"], params as unknown as Record<string, unknown>, options),
+    save: (params: DocSaveParams = {}, options?: InvokeOptions) => runtime.invoke<DocSaveResult>(OPERATION_MAP["doc.save"], params as unknown as Record<string, unknown>, options),
     close: (params: DocCloseParams = {}, options?: InvokeOptions) => runtime.invoke<DocCloseResult>(OPERATION_MAP["doc.close"], params as unknown as Record<string, unknown>, options),
     info: (params: DocInfoParams = {}, options?: InvokeOptions) => runtime.invoke<DocInfoResult>(OPERATION_MAP["doc.info"], params as unknown as Record<string, unknown>, options),
+    describe: (params: DocDescribeParams = {}, options?: InvokeOptions) => runtime.invoke<DocDescribeResult>(OPERATION_MAP["doc.describe"], params as unknown as Record<string, unknown>, options),
+    describeCommand: (params: DocDescribeCommandParams, options?: InvokeOptions) => runtime.invoke<DocDescribeCommandResult>(OPERATION_MAP["doc.describeCommand"], params as unknown as Record<string, unknown>, options),
     find: (params: DocFindParams = {}, options?: InvokeOptions) => runtime.invoke<DocFindResult>(OPERATION_MAP["doc.find"], params as unknown as Record<string, unknown>, options),
     getNode: (params: DocGetNodeParams, options?: InvokeOptions) => runtime.invoke<DocGetNodeResult>(OPERATION_MAP["doc.getNode"], params as unknown as Record<string, unknown>, options),
     getNodeById: (params: DocGetNodeByIdParams, options?: InvokeOptions) => runtime.invoke<DocGetNodeByIdResult>(OPERATION_MAP["doc.getNodeById"], params as unknown as Record<string, unknown>, options),
@@ -832,6 +3122,9 @@ export function createDocApi(runtime: SuperDocRuntime) {
       get: (params: DocCommentsGetParams, options?: InvokeOptions) => runtime.invoke<DocCommentsGetResult>(OPERATION_MAP["doc.comments.get"], params as unknown as Record<string, unknown>, options),
       list: (params: DocCommentsListParams = {}, options?: InvokeOptions) => runtime.invoke<DocCommentsListResult>(OPERATION_MAP["doc.comments.list"], params as unknown as Record<string, unknown>, options),
     },
+    create: {
+      paragraph: (params: DocCreateParagraphParams = {}, options?: InvokeOptions) => runtime.invoke<DocCreateParagraphResult>(OPERATION_MAP["doc.create.paragraph"], params as unknown as Record<string, unknown>, options),
+    },
     insert: (params: DocInsertParams, options?: InvokeOptions) => runtime.invoke<DocInsertResult>(OPERATION_MAP["doc.insert"], params as unknown as Record<string, unknown>, options),
     replace: (params: DocReplaceParams, options?: InvokeOptions) => runtime.invoke<DocReplaceResult>(OPERATION_MAP["doc.replace"], params as unknown as Record<string, unknown>, options),
     delete: (params: DocDeleteParams, options?: InvokeOptions) => runtime.invoke<DocDeleteResult>(OPERATION_MAP["doc.delete"], params as unknown as Record<string, unknown>, options),
@@ -848,6 +3141,7 @@ export function createDocApi(runtime: SuperDocRuntime) {
     },
     session: {
       list: (params: DocSessionListParams = {}, options?: InvokeOptions) => runtime.invoke<DocSessionListResult>(OPERATION_MAP["doc.session.list"], params as unknown as Record<string, unknown>, options),
+      save: (params: DocSessionSaveParams, options?: InvokeOptions) => runtime.invoke<DocSessionSaveResult>(OPERATION_MAP["doc.session.save"], params as unknown as Record<string, unknown>, options),
       close: (params: DocSessionCloseParams, options?: InvokeOptions) => runtime.invoke<DocSessionCloseResult>(OPERATION_MAP["doc.session.close"], params as unknown as Record<string, unknown>, options),
       setDefault: (params: DocSessionSetDefaultParams, options?: InvokeOptions) => runtime.invoke<DocSessionSetDefaultResult>(OPERATION_MAP["doc.session.setDefault"], params as unknown as Record<string, unknown>, options),
     },