@superdoc-dev/sdk 1.0.0-alpha.30 → 1.0.0-alpha.32

package/tools/tool-name-map.json

@@ -1,5 +1,4 @@
 {
-  "find_content": "doc.find",
   "get_node": "doc.getNode",
   "get_node_by_id": "doc.getNodeById",
   "get_document_text": "doc.getText",
@@ -11,49 +10,6 @@
   "delete_content": "doc.delete",
   "delete_block": "doc.blocks.delete",
   "format_apply": "doc.format.apply",
-  "format_bold": "doc.format.bold",
-  "format_italic": "doc.format.italic",
-  "format_strike": "doc.format.strike",
-  "format_underline": "doc.format.underline",
-  "format_highlight": "doc.format.highlight",
-  "format_color": "doc.format.color",
-  "format_font_size": "doc.format.fontSize",
-  "format_font_family": "doc.format.fontFamily",
-  "format_letter_spacing": "doc.format.letterSpacing",
-  "format_vert_align": "doc.format.vertAlign",
-  "format_position": "doc.format.position",
-  "format_dstrike": "doc.format.dstrike",
-  "format_small_caps": "doc.format.smallCaps",
-  "format_caps": "doc.format.caps",
-  "format_shading": "doc.format.shading",
-  "format_border": "doc.format.border",
-  "format_outline": "doc.format.outline",
-  "format_shadow": "doc.format.shadow",
-  "format_emboss": "doc.format.emboss",
-  "format_imprint": "doc.format.imprint",
-  "format_char_scale": "doc.format.charScale",
-  "format_kerning": "doc.format.kerning",
-  "format_vanish": "doc.format.vanish",
-  "format_web_hidden": "doc.format.webHidden",
-  "format_spec_vanish": "doc.format.specVanish",
-  "format_rtl": "doc.format.rtl",
-  "format_cs": "doc.format.cs",
-  "format_b_cs": "doc.format.bCs",
-  "format_i_cs": "doc.format.iCs",
-  "format_east_asian_layout": "doc.format.eastAsianLayout",
-  "format_em": "doc.format.em",
-  "format_fit_text": "doc.format.fitText",
-  "format_snap_to_grid": "doc.format.snapToGrid",
-  "format_lang": "doc.format.lang",
-  "format_o_math": "doc.format.oMath",
-  "format_r_style": "doc.format.rStyle",
-  "format_r_fonts": "doc.format.rFonts",
-  "format_font_size_cs": "doc.format.fontSizeCs",
-  "format_ligatures": "doc.format.ligatures",
-  "format_num_form": "doc.format.numForm",
-  "format_num_spacing": "doc.format.numSpacing",
-  "format_stylistic_sets": "doc.format.stylisticSets",
-  "format_contextual_alternates": "doc.format.contextualAlternates",
   "styles_apply": "doc.styles.apply",
   "create_paragraph": "doc.create.paragraph",
   "create_heading": "doc.create.heading",
@@ -206,231 +162,18 @@
   "set_image_position": "doc.images.setPosition",
   "set_image_anchor_options": "doc.images.setAnchorOptions",
   "set_image_z_order": "doc.images.setZOrder",
+  "list_hyperlinks": "doc.hyperlinks.list",
+  "get_hyperlink": "doc.hyperlinks.get",
+  "wrap_hyperlink": "doc.hyperlinks.wrap",
+  "insert_hyperlink": "doc.hyperlinks.insert",
+  "patch_hyperlink": "doc.hyperlinks.patch",
+  "remove_hyperlink": "doc.hyperlinks.remove",
   "open_document": "doc.open",
   "save_document": "doc.save",
   "close_document": "doc.close",
   "get_status": "doc.status",
-  "describe_commands": "doc.describe",
-  "describe_command": "doc.describeCommand",
   "list_sessions": "doc.session.list",
   "save_session": "doc.session.save",
   "close_session": "doc.session.close",
-  "set_default_session": "doc.session.setDefault",
-  "doc_find": "doc.find",
-  "doc_getNode": "doc.getNode",
-  "doc_getNodeById": "doc.getNodeById",
-  "doc_getText": "doc.getText",
-  "doc_getMarkdown": "doc.getMarkdown",
-  "doc_getHtml": "doc.getHtml",
-  "doc_info": "doc.info",
-  "doc_insert": "doc.insert",
-  "doc_replace": "doc.replace",
-  "doc_delete": "doc.delete",
-  "doc_blocks_delete": "doc.blocks.delete",
-  "doc_format_apply": "doc.format.apply",
-  "doc_format_bold": "doc.format.bold",
-  "doc_format_italic": "doc.format.italic",
-  "doc_format_strike": "doc.format.strike",
-  "doc_format_underline": "doc.format.underline",
-  "doc_format_highlight": "doc.format.highlight",
-  "doc_format_color": "doc.format.color",
-  "doc_format_fontSize": "doc.format.fontSize",
-  "doc_format_fontFamily": "doc.format.fontFamily",
-  "doc_format_letterSpacing": "doc.format.letterSpacing",
-  "doc_format_vertAlign": "doc.format.vertAlign",
-  "doc_format_position": "doc.format.position",
-  "doc_format_dstrike": "doc.format.dstrike",
-  "doc_format_smallCaps": "doc.format.smallCaps",
-  "doc_format_caps": "doc.format.caps",
-  "doc_format_shading": "doc.format.shading",
-  "doc_format_border": "doc.format.border",
-  "doc_format_outline": "doc.format.outline",
-  "doc_format_shadow": "doc.format.shadow",
-  "doc_format_emboss": "doc.format.emboss",
-  "doc_format_imprint": "doc.format.imprint",
-  "doc_format_charScale": "doc.format.charScale",
-  "doc_format_kerning": "doc.format.kerning",
-  "doc_format_vanish": "doc.format.vanish",
-  "doc_format_webHidden": "doc.format.webHidden",
-  "doc_format_specVanish": "doc.format.specVanish",
-  "doc_format_rtl": "doc.format.rtl",
-  "doc_format_cs": "doc.format.cs",
-  "doc_format_bCs": "doc.format.bCs",
-  "doc_format_iCs": "doc.format.iCs",
-  "doc_format_eastAsianLayout": "doc.format.eastAsianLayout",
-  "doc_format_em": "doc.format.em",
-  "doc_format_fitText": "doc.format.fitText",
-  "doc_format_snapToGrid": "doc.format.snapToGrid",
-  "doc_format_lang": "doc.format.lang",
-  "doc_format_oMath": "doc.format.oMath",
-  "doc_format_rStyle": "doc.format.rStyle",
-  "doc_format_rFonts": "doc.format.rFonts",
-  "doc_format_fontSizeCs": "doc.format.fontSizeCs",
-  "doc_format_ligatures": "doc.format.ligatures",
-  "doc_format_numForm": "doc.format.numForm",
-  "doc_format_numSpacing": "doc.format.numSpacing",
-  "doc_format_stylisticSets": "doc.format.stylisticSets",
-  "doc_format_contextualAlternates": "doc.format.contextualAlternates",
-  "doc_styles_apply": "doc.styles.apply",
-  "doc_create_paragraph": "doc.create.paragraph",
-  "doc_create_heading": "doc.create.heading",
-  "doc_create_sectionBreak": "doc.create.sectionBreak",
-  "doc_sections_list": "doc.sections.list",
-  "doc_sections_get": "doc.sections.get",
-  "doc_sections_setBreakType": "doc.sections.setBreakType",
-  "doc_sections_setPageMargins": "doc.sections.setPageMargins",
-  "doc_sections_setHeaderFooterMargins": "doc.sections.setHeaderFooterMargins",
-  "doc_sections_setPageSetup": "doc.sections.setPageSetup",
-  "doc_sections_setColumns": "doc.sections.setColumns",
-  "doc_sections_setLineNumbering": "doc.sections.setLineNumbering",
-  "doc_sections_setPageNumbering": "doc.sections.setPageNumbering",
-  "doc_sections_setTitlePage": "doc.sections.setTitlePage",
-  "doc_sections_setOddEvenHeadersFooters": "doc.sections.setOddEvenHeadersFooters",
-  "doc_sections_setVerticalAlign": "doc.sections.setVerticalAlign",
-  "doc_sections_setSectionDirection": "doc.sections.setSectionDirection",
-  "doc_sections_setHeaderFooterRef": "doc.sections.setHeaderFooterRef",
-  "doc_sections_clearHeaderFooterRef": "doc.sections.clearHeaderFooterRef",
-  "doc_sections_setLinkToPrevious": "doc.sections.setLinkToPrevious",
-  "doc_sections_setPageBorders": "doc.sections.setPageBorders",
-  "doc_sections_clearPageBorders": "doc.sections.clearPageBorders",
-  "doc_styles_paragraph_setStyle": "doc.styles.paragraph.setStyle",
-  "doc_styles_paragraph_clearStyle": "doc.styles.paragraph.clearStyle",
-  "doc_format_paragraph_resetDirectFormatting": "doc.format.paragraph.resetDirectFormatting",
-  "doc_format_paragraph_setAlignment": "doc.format.paragraph.setAlignment",
-  "doc_format_paragraph_clearAlignment": "doc.format.paragraph.clearAlignment",
-  "doc_format_paragraph_setIndentation": "doc.format.paragraph.setIndentation",
-  "doc_format_paragraph_clearIndentation": "doc.format.paragraph.clearIndentation",
-  "doc_format_paragraph_setSpacing": "doc.format.paragraph.setSpacing",
-  "doc_format_paragraph_clearSpacing": "doc.format.paragraph.clearSpacing",
-  "doc_format_paragraph_setKeepOptions": "doc.format.paragraph.setKeepOptions",
-  "doc_format_paragraph_setOutlineLevel": "doc.format.paragraph.setOutlineLevel",
-  "doc_format_paragraph_setFlowOptions": "doc.format.paragraph.setFlowOptions",
-  "doc_format_paragraph_setTabStop": "doc.format.paragraph.setTabStop",
-  "doc_format_paragraph_clearTabStop": "doc.format.paragraph.clearTabStop",
-  "doc_format_paragraph_clearAllTabStops": "doc.format.paragraph.clearAllTabStops",
-  "doc_format_paragraph_setBorder": "doc.format.paragraph.setBorder",
-  "doc_format_paragraph_clearBorder": "doc.format.paragraph.clearBorder",
-  "doc_format_paragraph_setShading": "doc.format.paragraph.setShading",
-  "doc_format_paragraph_clearShading": "doc.format.paragraph.clearShading",
-  "doc_lists_list": "doc.lists.list",
-  "doc_lists_get": "doc.lists.get",
-  "doc_lists_insert": "doc.lists.insert",
-  "doc_lists_create": "doc.lists.create",
-  "doc_lists_attach": "doc.lists.attach",
-  "doc_lists_detach": "doc.lists.detach",
-  "doc_lists_indent": "doc.lists.indent",
-  "doc_lists_outdent": "doc.lists.outdent",
-  "doc_lists_join": "doc.lists.join",
-  "doc_lists_canJoin": "doc.lists.canJoin",
-  "doc_lists_separate": "doc.lists.separate",
-  "doc_lists_setLevel": "doc.lists.setLevel",
-  "doc_lists_setValue": "doc.lists.setValue",
-  "doc_lists_continuePrevious": "doc.lists.continuePrevious",
-  "doc_lists_canContinuePrevious": "doc.lists.canContinuePrevious",
-  "doc_lists_setLevelRestart": "doc.lists.setLevelRestart",
-  "doc_lists_convertToText": "doc.lists.convertToText",
-  "doc_lists_applyTemplate": "doc.lists.applyTemplate",
-  "doc_lists_applyPreset": "doc.lists.applyPreset",
-  "doc_lists_captureTemplate": "doc.lists.captureTemplate",
-  "doc_lists_setLevelNumbering": "doc.lists.setLevelNumbering",
-  "doc_lists_setLevelBullet": "doc.lists.setLevelBullet",
-  "doc_lists_setLevelPictureBullet": "doc.lists.setLevelPictureBullet",
-  "doc_lists_setLevelAlignment": "doc.lists.setLevelAlignment",
-  "doc_lists_setLevelIndents": "doc.lists.setLevelIndents",
-  "doc_lists_setLevelTrailingCharacter": "doc.lists.setLevelTrailingCharacter",
-  "doc_lists_setLevelMarkerFont": "doc.lists.setLevelMarkerFont",
-  "doc_lists_clearLevelOverrides": "doc.lists.clearLevelOverrides",
-  "doc_comments_create": "doc.comments.create",
-  "doc_comments_patch": "doc.comments.patch",
-  "doc_comments_delete": "doc.comments.delete",
-  "doc_comments_get": "doc.comments.get",
-  "doc_comments_list": "doc.comments.list",
-  "doc_trackChanges_list": "doc.trackChanges.list",
-  "doc_trackChanges_get": "doc.trackChanges.get",
-  "doc_trackChanges_decide": "doc.trackChanges.decide",
-  "doc_query_match": "doc.query.match",
-  "doc_mutations_preview": "doc.mutations.preview",
-  "doc_mutations_apply": "doc.mutations.apply",
-  "doc_capabilities_get": "doc.capabilities.get",
-  "doc_create_table": "doc.create.table",
-  "doc_tables_convertFromText": "doc.tables.convertFromText",
-  "doc_tables_delete": "doc.tables.delete",
-  "doc_tables_clearContents": "doc.tables.clearContents",
-  "doc_tables_move": "doc.tables.move",
-  "doc_tables_split": "doc.tables.split",
-  "doc_tables_convertToText": "doc.tables.convertToText",
-  "doc_tables_setLayout": "doc.tables.setLayout",
-  "doc_tables_insertRow": "doc.tables.insertRow",
-  "doc_tables_deleteRow": "doc.tables.deleteRow",
-  "doc_tables_setRowHeight": "doc.tables.setRowHeight",
-  "doc_tables_distributeRows": "doc.tables.distributeRows",
-  "doc_tables_setRowOptions": "doc.tables.setRowOptions",
-  "doc_tables_insertColumn": "doc.tables.insertColumn",
-  "doc_tables_deleteColumn": "doc.tables.deleteColumn",
-  "doc_tables_setColumnWidth": "doc.tables.setColumnWidth",
-  "doc_tables_distributeColumns": "doc.tables.distributeColumns",
-  "doc_tables_insertCell": "doc.tables.insertCell",
-  "doc_tables_deleteCell": "doc.tables.deleteCell",
-  "doc_tables_mergeCells": "doc.tables.mergeCells",
-  "doc_tables_unmergeCells": "doc.tables.unmergeCells",
-  "doc_tables_splitCell": "doc.tables.splitCell",
-  "doc_tables_setCellProperties": "doc.tables.setCellProperties",
-  "doc_tables_sort": "doc.tables.sort",
-  "doc_tables_setAltText": "doc.tables.setAltText",
-  "doc_tables_setStyle": "doc.tables.setStyle",
-  "doc_tables_clearStyle": "doc.tables.clearStyle",
-  "doc_tables_setStyleOption": "doc.tables.setStyleOption",
-  "doc_tables_setBorder": "doc.tables.setBorder",
-  "doc_tables_clearBorder": "doc.tables.clearBorder",
-  "doc_tables_applyBorderPreset": "doc.tables.applyBorderPreset",
-  "doc_tables_setShading": "doc.tables.setShading",
-  "doc_tables_clearShading": "doc.tables.clearShading",
-  "doc_tables_setTablePadding": "doc.tables.setTablePadding",
-  "doc_tables_setCellPadding": "doc.tables.setCellPadding",
-  "doc_tables_setCellSpacing": "doc.tables.setCellSpacing",
-  "doc_tables_clearCellSpacing": "doc.tables.clearCellSpacing",
-  "doc_tables_get": "doc.tables.get",
-  "doc_tables_getCells": "doc.tables.getCells",
-  "doc_tables_getProperties": "doc.tables.getProperties",
-  "doc_tables_getStyles": "doc.tables.getStyles",
-  "doc_tables_setDefaultStyle": "doc.tables.setDefaultStyle",
-  "doc_tables_clearDefaultStyle": "doc.tables.clearDefaultStyle",
-  "doc_create_tableOfContents": "doc.create.tableOfContents",
-  "doc_toc_list": "doc.toc.list",
-  "doc_toc_get": "doc.toc.get",
-  "doc_toc_configure": "doc.toc.configure",
-  "doc_toc_update": "doc.toc.update",
-  "doc_toc_remove": "doc.toc.remove",
-  "doc_toc_markEntry": "doc.toc.markEntry",
-  "doc_toc_unmarkEntry": "doc.toc.unmarkEntry",
-  "doc_toc_listEntries": "doc.toc.listEntries",
-  "doc_toc_getEntry": "doc.toc.getEntry",
-  "doc_toc_editEntry": "doc.toc.editEntry",
-  "doc_history_get": "doc.history.get",
-  "doc_history_undo": "doc.history.undo",
-  "doc_history_redo": "doc.history.redo",
-  "doc_create_image": "doc.create.image",
-  "doc_images_list": "doc.images.list",
-  "doc_images_get": "doc.images.get",
-  "doc_images_delete": "doc.images.delete",
-  "doc_images_move": "doc.images.move",
-  "doc_images_convertToInline": "doc.images.convertToInline",
-  "doc_images_convertToFloating": "doc.images.convertToFloating",
-  "doc_images_setSize": "doc.images.setSize",
-  "doc_images_setWrapType": "doc.images.setWrapType",
-  "doc_images_setWrapSide": "doc.images.setWrapSide",
-  "doc_images_setWrapDistances": "doc.images.setWrapDistances",
-  "doc_images_setPosition": "doc.images.setPosition",
-  "doc_images_setAnchorOptions": "doc.images.setAnchorOptions",
-  "doc_images_setZOrder": "doc.images.setZOrder",
-  "doc_open": "doc.open",
-  "doc_save": "doc.save",
-  "doc_close": "doc.close",
-  "doc_status": "doc.status",
-  "doc_describe": "doc.describe",
-  "doc_describeCommand": "doc.describeCommand",
-  "doc_session_list": "doc.session.list",
-  "doc_session_save": "doc.session.save",
-  "doc_session_close": "doc.session.close",
-  "doc_session_setDefault": "doc.session.setDefault"
+  "set_default_session": "doc.session.setDefault"
 }

package/tools/tools-policy.json

@@ -1,89 +1,41 @@
 {
-  "policyVersion": "v1",
-  "phases": {
-    "read": {
-      "include": [
-        "introspection",
-        "query"
-      ],
-      "exclude": [
-        "mutation",
-        "trackChanges",
-        "session",
-        "create",
-        "comments",
-        "format"
-      ],
-      "priority": [
-        "query",
-        "introspection"
-      ]
-    },
-    "locate": {
-      "include": [
-        "query"
-      ],
-      "exclude": [
-        "mutation",
-        "trackChanges",
-        "session",
-        "create",
-        "comments",
-        "format"
-      ],
-      "priority": [
-        "query"
-      ]
-    },
-    "mutate": {
-      "include": [
-        "query",
-        "mutation",
-        "format",
-        "comments",
-        "create"
-      ],
-      "exclude": [
-        "session"
-      ],
-      "priority": [
-        "query",
-        "mutation",
-        "create",
-        "format",
-        "comments"
-      ]
-    },
-    "review": {
-      "include": [
-        "query",
-        "trackChanges",
-        "comments"
-      ],
-      "exclude": [
-        "mutation",
-        "create",
-        "session",
-        "format"
-      ],
-      "priority": [
-        "trackChanges",
-        "comments",
-        "query"
-      ]
-    }
+  "policyVersion": "v3",
+  "groups": [
+    "core",
+    "format",
+    "create",
+    "tables",
+    "sections",
+    "lists",
+    "comments",
+    "trackChanges",
+    "toc",
+    "history",
+    "session"
+  ],
+  "groupDescriptions": {
+    "core": "Core operations: read nodes, get text, insert/replace/delete content, mutations",
+    "format": "Text formatting, paragraph styles, alignment, spacing, borders, shading",
+    "create": "Create structural elements: headings, paragraphs, tables, sections, TOC",
+    "tables": "Table creation, manipulation, formatting, borders, and cell operations",
+    "sections": "Page layout, margins, columns, headers/footers, page numbering",
+    "lists": "Bullet and numbered lists, indentation, list types",
+    "comments": "Comment threads — create, edit, delete, list",
+    "trackChanges": "Track changes — list, inspect, accept/reject",
+    "toc": "Table of contents — create, configure, update, manage entries",
+    "history": "Undo, redo, history inspection",
+    "session": "Session management — open, close, save, list sessions"
   },
   "defaults": {
-    "maxToolsByProfile": {
-      "intent": 12,
-      "operation": 16
-    },
-    "minReadTools": 2,
+    "mode": "essential",
+    "maxTools": 20,
+    "alwaysInclude": [
+      "core"
+    ],
     "foundationalOperationIds": [
       "doc.info",
-      "doc.find"
-    ],
-    "chooserDecisionVersion": "v1"
+      "doc.query.match"
+    ]
   },
   "capabilityFeatures": {
     "comments": [
@@ -94,7 +46,52 @@
     ],
     "lists": [
       "hasLists"
+    ],
+    "tables": [
+      "hasTables"
+    ],
+    "toc": [
+      "hasToc"
     ]
   },
-  "contractHash": "a50d080099e0a94b"
+  "essentialTools": [
+    "get_node_by_id",
+    "get_document_text",
+    "query_match",
+    "apply_mutations",
+    "undo"
+  ],
+  "discoverTool": {
+    "name": "discover_tools",
+    "description": "Load additional tool groups when you need capabilities beyond the essential set. Call this BEFORE attempting to use tools from a specific group.\n\nAvailable groups:\n  - core: Core operations: read nodes, get text, insert/replace/delete content, mutations\n  - format: Text formatting, paragraph styles, alignment, spacing, borders, shading\n  - create: Create structural elements: headings, paragraphs, tables, sections, TOC\n  - tables: Table creation, manipulation, formatting, borders, and cell operations\n  - sections: Page layout, margins, columns, headers/footers, page numbering\n  - lists: Bullet and numbered lists, indentation, list types\n  - comments: Comment threads — create, edit, delete, list\n  - trackChanges: Track changes — list, inspect, accept/reject\n  - toc: Table of contents — create, configure, update, manage entries\n  - history: Undo, redo, history inspection\n  - session: Session management — open, close, save, list sessions",
+    "schema": {
+      "type": "object",
+      "properties": {
+        "groups": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "core",
+              "format",
+              "create",
+              "tables",
+              "sections",
+              "lists",
+              "comments",
+              "trackChanges",
+              "toc",
+              "history",
+              "session"
+            ]
+          },
+          "description": "Which tool groups to load. You can request multiple at once."
+        }
+      },
+      "required": [
+        "groups"
+      ]
+    }
+  },
+  "contractHash": "628c99fc8d67fba6"
 }