@superdoc-dev/sdk 1.0.0 → 1.0.1-next.1

package/dist/helpers/format.d.ts

@@ -24,7 +24,7 @@
  * await clearBold(doc.format.apply, { blockId: 'p1', start: 0, end: 5 });
  * ```
  */
-import type { InvokeOptions, OperationSpec } from '../runtime/transport-common.js';
+import type { InvokeOptions } from '../runtime/transport-common.js';
 export interface FormatHelperParams {
     target?: {
         kind: 'text';
@@ -45,33 +45,33 @@ export interface FormatHelperParams {
     expectedRevision?: string;
 }
 /**
- * Generic invoke function that works with a bound document handle runtime.
- * Accepts the same signature as SuperDocRuntime.invoke.
+ * Bound format.apply method from a document handle.
+ * Signature matches `doc.format.apply(params, options)`.
  */
-type RuntimeInvokeFn = <T = unknown>(operation: OperationSpec, params?: Record<string, unknown>, options?: InvokeOptions) => Promise<T>;
+type FormatApplyFn = (params?: Record<string, unknown>, options?: InvokeOptions) => Promise<unknown>;
 /** Apply bold ON. Equivalent to `format.apply` with `inline: { bold: 'on' }`. */
-export declare function formatBold(invoke: RuntimeInvokeFn, params?: FormatHelperParams, options?: InvokeOptions): Promise<unknown>;
+export declare function formatBold(apply: FormatApplyFn, params?: FormatHelperParams, options?: InvokeOptions): Promise<unknown>;
 /** Apply italic ON. Equivalent to `format.apply` with `inline: { italic: 'on' }`. */
-export declare function formatItalic(invoke: RuntimeInvokeFn, params?: FormatHelperParams, options?: InvokeOptions): Promise<unknown>;
+export declare function formatItalic(apply: FormatApplyFn, params?: FormatHelperParams, options?: InvokeOptions): Promise<unknown>;
 /** Apply underline ON. Equivalent to `format.apply` with `inline: { underline: 'on' }`. */
-export declare function formatUnderline(invoke: RuntimeInvokeFn, params?: FormatHelperParams, options?: InvokeOptions): Promise<unknown>;
+export declare function formatUnderline(apply: FormatApplyFn, params?: FormatHelperParams, options?: InvokeOptions): Promise<unknown>;
 /** Apply strikethrough ON. Equivalent to `format.apply` with `inline: { strike: 'on' }`. */
-export declare function formatStrikethrough(invoke: RuntimeInvokeFn, params?: FormatHelperParams, options?: InvokeOptions): Promise<unknown>;
+export declare function formatStrikethrough(apply: FormatApplyFn, params?: FormatHelperParams, options?: InvokeOptions): Promise<unknown>;
 /** Apply bold OFF. Equivalent to `format.apply` with `inline: { bold: 'off' }`. */
-export declare function unformatBold(invoke: RuntimeInvokeFn, params?: FormatHelperParams, options?: InvokeOptions): Promise<unknown>;
+export declare function unformatBold(apply: FormatApplyFn, params?: FormatHelperParams, options?: InvokeOptions): Promise<unknown>;
 /** Apply italic OFF. Equivalent to `format.apply` with `inline: { italic: 'off' }`. */
-export declare function unformatItalic(invoke: RuntimeInvokeFn, params?: FormatHelperParams, options?: InvokeOptions): Promise<unknown>;
+export declare function unformatItalic(apply: FormatApplyFn, params?: FormatHelperParams, options?: InvokeOptions): Promise<unknown>;
 /** Apply underline OFF. Equivalent to `format.apply` with `inline: { underline: 'off' }`. */
-export declare function unformatUnderline(invoke: RuntimeInvokeFn, params?: FormatHelperParams, options?: InvokeOptions): Promise<unknown>;
+export declare function unformatUnderline(apply: FormatApplyFn, params?: FormatHelperParams, options?: InvokeOptions): Promise<unknown>;
 /** Apply strikethrough OFF. Equivalent to `format.apply` with `inline: { strike: 'off' }`. */
-export declare function unformatStrikethrough(invoke: RuntimeInvokeFn, params?: FormatHelperParams, options?: InvokeOptions): Promise<unknown>;
+export declare function unformatStrikethrough(apply: FormatApplyFn, params?: FormatHelperParams, options?: InvokeOptions): Promise<unknown>;
 /** Clear bold formatting. Equivalent to `format.apply` with `inline: { bold: 'clear' }`. */
-export declare function clearBold(invoke: RuntimeInvokeFn, params?: FormatHelperParams, options?: InvokeOptions): Promise<unknown>;
+export declare function clearBold(apply: FormatApplyFn, params?: FormatHelperParams, options?: InvokeOptions): Promise<unknown>;
 /** Clear italic formatting. Equivalent to `format.apply` with `inline: { italic: 'clear' }`. */
-export declare function clearItalic(invoke: RuntimeInvokeFn, params?: FormatHelperParams, options?: InvokeOptions): Promise<unknown>;
+export declare function clearItalic(apply: FormatApplyFn, params?: FormatHelperParams, options?: InvokeOptions): Promise<unknown>;
 /** Clear underline formatting. Equivalent to `format.apply` with `inline: { underline: 'clear' }`. */
-export declare function clearUnderline(invoke: RuntimeInvokeFn, params?: FormatHelperParams, options?: InvokeOptions): Promise<unknown>;
+export declare function clearUnderline(apply: FormatApplyFn, params?: FormatHelperParams, options?: InvokeOptions): Promise<unknown>;
 /** Clear strikethrough formatting. Equivalent to `format.apply` with `inline: { strike: 'clear' }`. */
-export declare function clearStrikethrough(invoke: RuntimeInvokeFn, params?: FormatHelperParams, options?: InvokeOptions): Promise<unknown>;
+export declare function clearStrikethrough(apply: FormatApplyFn, params?: FormatHelperParams, options?: InvokeOptions): Promise<unknown>;
 export {};
 //# sourceMappingURL=format.d.ts.map

package/dist/helpers/format.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/helpers/format.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAoBnF,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IAClF,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6EAA6E;IAC7E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAClC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;GAGG;AACH,KAAK,eAAe,GAAG,CAAC,CAAC,GAAG,OAAO,EACjC,SAAS,EAAE,aAAa,EACxB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,CAAC,EAAE,aAAa,KACpB,OAAO,CAAC,CAAC,CAAC,CAAC;AA0BhB,iFAAiF;AACjF,wBAAgB,UAAU,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,GAAE,kBAAuB,EAAE,OAAO,CAAC,EAAE,aAAa,oBAE3G;AAED,qFAAqF;AACrF,wBAAgB,YAAY,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,GAAE,kBAAuB,EAAE,OAAO,CAAC,EAAE,aAAa,oBAE7G;AAED,2FAA2F;AAC3F,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,GAAE,kBAAuB,EAAE,OAAO,CAAC,EAAE,aAAa,oBAEhH;AAED,4FAA4F;AAC5F,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,GAAE,kBAAuB,EAAE,OAAO,CAAC,EAAE,aAAa,oBAEpH;AAMD,mFAAmF;AACnF,wBAAgB,YAAY,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,GAAE,kBAAuB,EAAE,OAAO,CAAC,EAAE,aAAa,oBAE7G;AAED,uFAAuF;AACvF,wBAAgB,cAAc,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,GAAE,kBAAuB,EAAE,OAAO,CAAC,EAAE,aAAa,oBAE/G;AAED,6FAA6F;AAC7F,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,GAAE,kBAAuB,EAAE,OAAO,CAAC,EAAE,aAAa,oBAElH;AAED,8FAA8F;AAC9F,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,eAAe,EACvB,MAAM,GAAE,kBAAuB,EAC/B,OAAO,CAAC,EAAE,aAAa,oBAGxB;AAMD,4FAA4F;AAC5F,wBAAgB,SAAS,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,GAAE,kBAAuB,EAAE,OAAO,CAAC,EAAE,aAAa,oBAE1G;AAED,gGAAgG;AAChG,wBAAgB,WAAW,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,GAAE,kBAAuB,EAAE,OAAO,CAAC,EAAE,aAAa,oBAE5G;AAED,sGAAsG;AACtG,wBAAgB,cAAc,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,GAAE,kBAAuB,EAAE,OAAO,CAAC,EAAE,aAAa,oBAE/G;AAED,uGAAuG;AACvG,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,GAAE,kBAAuB,EAAE,OAAO,CAAC,EAAE,aAAa,oBAEnH"}
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/helpers/format.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAEpE,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IAClF,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6EAA6E;IAC7E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAClC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;GAGG;AACH,KAAK,aAAa,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,aAAa,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AA0BrG,iFAAiF;AACjF,wBAAgB,UAAU,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,GAAE,kBAAuB,EAAE,OAAO,CAAC,EAAE,aAAa,oBAExG;AAED,qFAAqF;AACrF,wBAAgB,YAAY,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,GAAE,kBAAuB,EAAE,OAAO,CAAC,EAAE,aAAa,oBAE1G;AAED,2FAA2F;AAC3F,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,GAAE,kBAAuB,EAAE,OAAO,CAAC,EAAE,aAAa,oBAE7G;AAED,4FAA4F;AAC5F,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,GAAE,kBAAuB,EAAE,OAAO,CAAC,EAAE,aAAa,oBAEjH;AAMD,mFAAmF;AACnF,wBAAgB,YAAY,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,GAAE,kBAAuB,EAAE,OAAO,CAAC,EAAE,aAAa,oBAE1G;AAED,uFAAuF;AACvF,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,GAAE,kBAAuB,EAAE,OAAO,CAAC,EAAE,aAAa,oBAE5G;AAED,6FAA6F;AAC7F,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,GAAE,kBAAuB,EAAE,OAAO,CAAC,EAAE,aAAa,oBAE/G;AAED,8FAA8F;AAC9F,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,GAAE,kBAAuB,EAAE,OAAO,CAAC,EAAE,aAAa,oBAEnH;AAMD,4FAA4F;AAC5F,wBAAgB,SAAS,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,GAAE,kBAAuB,EAAE,OAAO,CAAC,EAAE,aAAa,oBAEvG;AAED,gGAAgG;AAChG,wBAAgB,WAAW,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,GAAE,kBAAuB,EAAE,OAAO,CAAC,EAAE,aAAa,oBAEzG;AAED,sGAAsG;AACtG,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,GAAE,kBAAuB,EAAE,OAAO,CAAC,EAAE,aAAa,oBAE5G;AAED,uGAAuG;AACvG,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,GAAE,kBAAuB,EAAE,OAAO,CAAC,EAAE,aAAa,oBAEhH"}

package/dist/helpers/format.js

@@ -24,23 +24,6 @@
  * await clearBold(doc.format.apply, { blockId: 'p1', start: 0, end: 5 });
  * ```
  */
-/**
- * Minimal operation spec for `format.apply`. Used to invoke the canonical
- * operation through the runtime without depending on generated code.
- *
- * doc and sessionId are omitted — the bound document handle injects them.
- */
-const FORMAT_APPLY_SPEC = {
-    operationId: 'doc.format.apply',
-    commandTokens: ['format', 'apply'],
-    params: [
-        { name: 'target', kind: 'jsonFlag', type: 'json' },
-        { name: 'inline', kind: 'jsonFlag', type: 'json' },
-        { name: 'dryRun', kind: 'flag', type: 'boolean' },
-        { name: 'changeMode', kind: 'flag', type: 'string' },
-        { name: 'expectedRevision', kind: 'flag', type: 'string' },
-    ],
-};
 /**
  * Normalizes flat-flag shorthand params (blockId, start, end) into a
  * canonical `target` object. If `target` is already provided, flat flags
@@ -63,56 +46,56 @@ function mergeInlineStyles(params, inline) {
 // format* helpers — apply ON directive
 // ---------------------------------------------------------------------------
 /** Apply bold ON. Equivalent to `format.apply` with `inline: { bold: 'on' }`. */
-export function formatBold(invoke, params = {}, options) {
-    return invoke(FORMAT_APPLY_SPEC, mergeInlineStyles(params, { bold: 'on' }), options);
+export function formatBold(apply, params = {}, options) {
+    return apply(mergeInlineStyles(params, { bold: 'on' }), options);
 }
 /** Apply italic ON. Equivalent to `format.apply` with `inline: { italic: 'on' }`. */
-export function formatItalic(invoke, params = {}, options) {
-    return invoke(FORMAT_APPLY_SPEC, mergeInlineStyles(params, { italic: 'on' }), options);
+export function formatItalic(apply, params = {}, options) {
+    return apply(mergeInlineStyles(params, { italic: 'on' }), options);
 }
 /** Apply underline ON. Equivalent to `format.apply` with `inline: { underline: 'on' }`. */
-export function formatUnderline(invoke, params = {}, options) {
-    return invoke(FORMAT_APPLY_SPEC, mergeInlineStyles(params, { underline: 'on' }), options);
+export function formatUnderline(apply, params = {}, options) {
+    return apply(mergeInlineStyles(params, { underline: 'on' }), options);
 }
 /** Apply strikethrough ON. Equivalent to `format.apply` with `inline: { strike: 'on' }`. */
-export function formatStrikethrough(invoke, params = {}, options) {
-    return invoke(FORMAT_APPLY_SPEC, mergeInlineStyles(params, { strike: 'on' }), options);
+export function formatStrikethrough(apply, params = {}, options) {
+    return apply(mergeInlineStyles(params, { strike: 'on' }), options);
 }
 // ---------------------------------------------------------------------------
 // unformat* helpers — apply explicit OFF directive (style override)
 // ---------------------------------------------------------------------------
 /** Apply bold OFF. Equivalent to `format.apply` with `inline: { bold: 'off' }`. */
-export function unformatBold(invoke, params = {}, options) {
-    return invoke(FORMAT_APPLY_SPEC, mergeInlineStyles(params, { bold: 'off' }), options);
+export function unformatBold(apply, params = {}, options) {
+    return apply(mergeInlineStyles(params, { bold: 'off' }), options);
 }
 /** Apply italic OFF. Equivalent to `format.apply` with `inline: { italic: 'off' }`. */
-export function unformatItalic(invoke, params = {}, options) {
-    return invoke(FORMAT_APPLY_SPEC, mergeInlineStyles(params, { italic: 'off' }), options);
+export function unformatItalic(apply, params = {}, options) {
+    return apply(mergeInlineStyles(params, { italic: 'off' }), options);
 }
 /** Apply underline OFF. Equivalent to `format.apply` with `inline: { underline: 'off' }`. */
-export function unformatUnderline(invoke, params = {}, options) {
-    return invoke(FORMAT_APPLY_SPEC, mergeInlineStyles(params, { underline: 'off' }), options);
+export function unformatUnderline(apply, params = {}, options) {
+    return apply(mergeInlineStyles(params, { underline: 'off' }), options);
 }
 /** Apply strikethrough OFF. Equivalent to `format.apply` with `inline: { strike: 'off' }`. */
-export function unformatStrikethrough(invoke, params = {}, options) {
-    return invoke(FORMAT_APPLY_SPEC, mergeInlineStyles(params, { strike: 'off' }), options);
+export function unformatStrikethrough(apply, params = {}, options) {
+    return apply(mergeInlineStyles(params, { strike: 'off' }), options);
 }
 // ---------------------------------------------------------------------------
 // clear* helpers — remove direct formatting (inherit from style cascade)
 // ---------------------------------------------------------------------------
 /** Clear bold formatting. Equivalent to `format.apply` with `inline: { bold: 'clear' }`. */
-export function clearBold(invoke, params = {}, options) {
-    return invoke(FORMAT_APPLY_SPEC, mergeInlineStyles(params, { bold: 'clear' }), options);
+export function clearBold(apply, params = {}, options) {
+    return apply(mergeInlineStyles(params, { bold: 'clear' }), options);
 }
 /** Clear italic formatting. Equivalent to `format.apply` with `inline: { italic: 'clear' }`. */
-export function clearItalic(invoke, params = {}, options) {
-    return invoke(FORMAT_APPLY_SPEC, mergeInlineStyles(params, { italic: 'clear' }), options);
+export function clearItalic(apply, params = {}, options) {
+    return apply(mergeInlineStyles(params, { italic: 'clear' }), options);
 }
 /** Clear underline formatting. Equivalent to `format.apply` with `inline: { underline: 'clear' }`. */
-export function clearUnderline(invoke, params = {}, options) {
-    return invoke(FORMAT_APPLY_SPEC, mergeInlineStyles(params, { underline: 'clear' }), options);
+export function clearUnderline(apply, params = {}, options) {
+    return apply(mergeInlineStyles(params, { underline: 'clear' }), options);
 }
 /** Clear strikethrough formatting. Equivalent to `format.apply` with `inline: { strike: 'clear' }`. */
-export function clearStrikethrough(invoke, params = {}, options) {
-    return invoke(FORMAT_APPLY_SPEC, mergeInlineStyles(params, { strike: 'clear' }), options);
+export function clearStrikethrough(apply, params = {}, options) {
+    return apply(mergeInlineStyles(params, { strike: 'clear' }), options);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superdoc-dev/sdk",
-  "version": "1.0.0",
+  "version": "1.0.1-next.1",
   "private": false,
   "type": "module",
   "main": "./dist/index.cjs",
@@ -26,11 +26,11 @@
     "typescript": "^5.9.2"
   },
   "optionalDependencies": {
-    "@superdoc-dev/sdk-darwin-x64": "1.0.0",
-    "@superdoc-dev/sdk-linux-x64": "1.0.0",
-    "@superdoc-dev/sdk-darwin-arm64": "1.0.0",
-    "@superdoc-dev/sdk-linux-arm64": "1.0.0",
-    "@superdoc-dev/sdk-windows-x64": "1.0.0"
+    "@superdoc-dev/sdk-darwin-arm64": "1.0.1-next.1",
+    "@superdoc-dev/sdk-darwin-x64": "1.0.1-next.1",
+    "@superdoc-dev/sdk-windows-x64": "1.0.1-next.1",
+    "@superdoc-dev/sdk-linux-x64": "1.0.1-next.1",
+    "@superdoc-dev/sdk-linux-arm64": "1.0.1-next.1"
   },
   "publishConfig": {
     "access": "public"

package/tools/intent_dispatch_generated.py

@@ -21,6 +21,8 @@ def dispatch_intent_tool(
             return execute('doc.getHtml', rest)
         elif action == 'info':
             return execute('doc.info', rest)
+        elif action == 'blocks':
+            return execute('doc.blocks.list', rest)
         else:
             raise SuperDocError(f'Unknown action for superdoc_get_content: {action}', code='TOOL_DISPATCH_NOT_FOUND', details={'toolName': 'superdoc_get_content', 'action': action})
     elif tool_name == 'superdoc_edit':

package/tools/system-prompt.md

@@ -129,9 +129,9 @@ To add a comment on specific text:
 
 **Only pass `action`, `text`, and `target` for creating a new comment.** Do not pass other params — they belong to different comment actions.
 
-### Resolving and reopening comments
+### Resolving comments
 
-To resolve a comment, use `action: "update"` with `{ commentId: "<id>", status: "resolved" }`. To reopen it, use `status: "open"`. There is no separate resolve action — it's a status field on the `update` action.
+To resolve a comment, use `action: "update"` with `{ commentId: "<id>", status: "resolved" }`. There is no separate resolve action — it's a status field on the `update` action.
 
 ## Important rules