@superdoc-dev/sdk 1.16.0-next.50 → 1.16.0-next.51

package/dist/generated/client.js

@@ -535,6 +535,7 @@ export function createDocApi(runtime) {
         close: (params = {}, options) => runtime.invoke(CONTRACT.operations["doc.close"], params, options),
         insertTab: (params = {}, options) => runtime.invoke(CONTRACT.operations["doc.insertTab"], params, options),
         insertLineBreak: (params = {}, options) => runtime.invoke(CONTRACT.operations["doc.insertLineBreak"], params, options),
+        executeCode: (params = {}, options) => runtime.invoke(CONTRACT.operations["doc.executeCode"], params, options),
         status: (params = {}, options) => runtime.invoke(CONTRACT.operations["doc.status"], params, options),
         describe: (params = {}, options) => runtime.invoke(CONTRACT.operations["doc.describe"], params, options),
         describeCommand: (params, options) => runtime.invoke(CONTRACT.operations["doc.describeCommand"], params, options),
@@ -544,6 +545,14 @@ export function createDocApi(runtime) {
             close: (params, options) => runtime.invoke(CONTRACT.operations["doc.session.close"], params, options),
             setDefault: (params, options) => runtime.invoke(CONTRACT.operations["doc.session.setDefault"], params, options),
         },
+        preset: {
+            list: (params = {}, options) => runtime.invoke(CONTRACT.operations["doc.preset.list"], params, options),
+            getCatalog: (params = {}, options) => runtime.invoke(CONTRACT.operations["doc.preset.getCatalog"], params, options),
+            getTools: (params, options) => runtime.invoke(CONTRACT.operations["doc.preset.getTools"], params, options),
+            getSystemPrompt: (params = {}, options) => runtime.invoke(CONTRACT.operations["doc.preset.getSystemPrompt"], params, options),
+            getMcpPrompt: (params = {}, options) => runtime.invoke(CONTRACT.operations["doc.preset.getMcpPrompt"], params, options),
+            dispatch: (params, options) => runtime.invoke(CONTRACT.operations["doc.preset.dispatch"], params, options),
+        },
     };
 }
 // ---------------------------------------------------------------------------
@@ -1063,5 +1072,14 @@ export function createBoundDocApi(runtime) {
         close: (params = {}, options) => runtime.invoke(CONTRACT.operations["doc.close"], params, options),
         insertTab: (params = {}, options) => runtime.invoke(CONTRACT.operations["doc.insertTab"], params, options),
         insertLineBreak: (params = {}, options) => runtime.invoke(CONTRACT.operations["doc.insertLineBreak"], params, options),
+        executeCode: (params = {}, options) => runtime.invoke(CONTRACT.operations["doc.executeCode"], params, options),
+        preset: {
+            list: (params = {}, options) => runtime.invoke(CONTRACT.operations["doc.preset.list"], params, options),
+            getCatalog: (params = {}, options) => runtime.invoke(CONTRACT.operations["doc.preset.getCatalog"], params, options),
+            getTools: (params, options) => runtime.invoke(CONTRACT.operations["doc.preset.getTools"], params, options),
+            getSystemPrompt: (params = {}, options) => runtime.invoke(CONTRACT.operations["doc.preset.getSystemPrompt"], params, options),
+            getMcpPrompt: (params = {}, options) => runtime.invoke(CONTRACT.operations["doc.preset.getMcpPrompt"], params, options),
+            dispatch: (params, options) => runtime.invoke(CONTRACT.operations["doc.preset.dispatch"], params, options),
+        },
     };
 }

package/dist/generated/contract.cjs

@@ -251209,6 +251209,112 @@ const CONTRACT = {
                 ]
             }
         },
+        "doc.executeCode": {
+            "operationId": "doc.executeCode",
+            "sdkSurface": "document",
+            "command": "execute code",
+            "commandTokens": [
+                "execute",
+                "code"
+            ],
+            "category": "core",
+            "description": "Run model-authored JavaScript IN-HOST against the live, SYNCHRONOUS Document API for the open session. Two globals are injected: `doc` (the synchronous Document API — do NOT await doc.* calls) and `console`. `return` a short summary; logs and the return value come back structured as { ok, result, logs, error }. Use for complex/multi-step workflows (loops, per-item branching, extract-then-generate) in ONE call instead of chaining many narrow tools. Large code can be passed on stdin.",
+            "requiresDocumentContext": false,
+            "docRequirement": "none",
+            "responseEnvelopeKey": null,
+            "params": [
+                {
+                    "name": "sessionId",
+                    "kind": "flag",
+                    "type": "string",
+                    "flag": "session",
+                    "description": "Session ID for multi-session workflows. Optional when only one session is open."
+                },
+                {
+                    "name": "expectedRevision",
+                    "kind": "flag",
+                    "type": "number",
+                    "flag": "expected-revision",
+                    "agentVisible": false
+                },
+                {
+                    "name": "code",
+                    "kind": "flag",
+                    "type": "string",
+                    "description": "JavaScript body run as an async function with `doc` (synchronous Document API — do NOT await) and `console` injected. Omit to pass code on stdin."
+                }
+            ],
+            "constraints": null,
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "code": {
+                        "type": "string",
+                        "description": "JavaScript body run as an async function with `doc` (synchronous Document API — do NOT await) and `console` injected. Omit to pass code on stdin."
+                    }
+                },
+                "additionalProperties": false
+            },
+            "mutates": true,
+            "idempotency": "non-idempotent",
+            "supportsTrackedMode": false,
+            "supportsDryRun": false,
+            "outputSchema": {
+                "type": "object",
+                "properties": {
+                    "ok": {
+                        "type": "boolean"
+                    },
+                    "result": {},
+                    "logs": {
+                        "type": "array",
+                        "items": {
+                            "type": "object",
+                            "properties": {
+                                "level": {
+                                    "type": "string"
+                                },
+                                "message": {
+                                    "type": "string"
+                                }
+                            }
+                        }
+                    },
+                    "error": {
+                        "type": "object",
+                        "properties": {
+                            "name": {
+                                "type": "string"
+                            },
+                            "message": {
+                                "type": "string"
+                            },
+                            "stack": {
+                                "type": "string"
+                            }
+                        }
+                    },
+                    "context": {
+                        "type": "object",
+                        "properties": {
+                            "dirty": {
+                                "type": "boolean"
+                            },
+                            "revision": {
+                                "type": "number"
+                            },
+                            "mutated": {
+                                "type": "boolean"
+                            }
+                        }
+                    }
+                },
+                "required": [
+                    "ok",
+                    "logs"
+                ]
+            }
+        },
         "doc.status": {
             "operationId": "doc.status",
             "sdkSurface": "internal",
@@ -251797,6 +251903,424 @@ const CONTRACT = {
                     "activeSessionId"
                 ]
             }
+        },
+        "doc.preset.list": {
+            "operationId": "doc.preset.list",
+            "sdkSurface": "document",
+            "command": "preset list",
+            "commandTokens": [
+                "preset",
+                "list"
+            ],
+            "category": "session",
+            "description": "List the LLM-tools preset ids registered in the Node SDK preset registry, plus the default preset id.",
+            "requiresDocumentContext": false,
+            "docRequirement": "none",
+            "responseEnvelopeKey": null,
+            "params": [],
+            "constraints": null,
+            "inputSchema": {
+                "type": "object",
+                "properties": {},
+                "additionalProperties": false
+            },
+            "mutates": false,
+            "idempotency": "idempotent",
+            "supportsTrackedMode": false,
+            "supportsDryRun": false,
+            "outputSchema": {
+                "type": "object",
+                "properties": {
+                    "presets": {
+                        "type": "array",
+                        "items": {
+                            "type": "string"
+                        }
+                    },
+                    "defaultPreset": {
+                        "type": "string"
+                    }
+                },
+                "required": [
+                    "presets",
+                    "defaultPreset"
+                ]
+            },
+            "skipAsATool": true
+        },
+        "doc.preset.getCatalog": {
+            "operationId": "doc.preset.getCatalog",
+            "sdkSurface": "document",
+            "command": "preset get-catalog",
+            "commandTokens": [
+                "preset",
+                "get-catalog"
+            ],
+            "category": "session",
+            "description": "Return the full tool catalog for an LLM-tools preset (defaults to the registered default preset).",
+            "requiresDocumentContext": false,
+            "docRequirement": "none",
+            "responseEnvelopeKey": null,
+            "params": [
+                {
+                    "name": "preset",
+                    "kind": "flag",
+                    "type": "string",
+                    "description": "Preset id. Defaults to the SDK default preset (legacy)."
+                }
+            ],
+            "constraints": null,
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "preset": {
+                        "type": "string",
+                        "description": "Preset id. Defaults to the SDK default preset (legacy)."
+                    }
+                },
+                "additionalProperties": false
+            },
+            "mutates": false,
+            "idempotency": "idempotent",
+            "supportsTrackedMode": false,
+            "supportsDryRun": false,
+            "outputSchema": {
+                "type": "object"
+            },
+            "skipAsATool": true
+        },
+        "doc.preset.getTools": {
+            "operationId": "doc.preset.getTools",
+            "sdkSurface": "document",
+            "command": "preset get-tools",
+            "commandTokens": [
+                "preset",
+                "get-tools"
+            ],
+            "category": "session",
+            "description": "Return the provider-shaped tool array (openai|anthropic|vercel|generic) for an LLM-tools preset, plus the active cache strategy.",
+            "requiresDocumentContext": false,
+            "docRequirement": "none",
+            "responseEnvelopeKey": null,
+            "params": [
+                {
+                    "name": "provider",
+                    "kind": "flag",
+                    "type": "string",
+                    "required": true,
+                    "schema": {
+                        "oneOf": [
+                            {
+                                "const": "openai"
+                            },
+                            {
+                                "const": "anthropic"
+                            },
+                            {
+                                "const": "vercel"
+                            },
+                            {
+                                "const": "generic"
+                            }
+                        ]
+                    },
+                    "description": "Tool provider format: openai | anthropic | vercel | generic."
+                },
+                {
+                    "name": "preset",
+                    "kind": "flag",
+                    "type": "string",
+                    "description": "Preset id. Defaults to the SDK default preset (legacy)."
+                },
+                {
+                    "name": "cache",
+                    "kind": "flag",
+                    "type": "boolean",
+                    "description": "Apply provider-specific prompt-cache markers."
+                },
+                {
+                    "name": "excludeActions",
+                    "kind": "flag",
+                    "type": "string",
+                    "description": "Comma-separated action names to remove from the advertised action surface (core preset). Unknown names fail."
+                }
+            ],
+            "constraints": null,
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "provider": {
+                        "type": "string",
+                        "oneOf": [
+                            {
+                                "const": "openai"
+                            },
+                            {
+                                "const": "anthropic"
+                            },
+                            {
+                                "const": "vercel"
+                            },
+                            {
+                                "const": "generic"
+                            }
+                        ],
+                        "description": "Tool provider format: openai | anthropic | vercel | generic."
+                    },
+                    "preset": {
+                        "type": "string",
+                        "description": "Preset id. Defaults to the SDK default preset (legacy)."
+                    },
+                    "cache": {
+                        "type": "boolean",
+                        "description": "Apply provider-specific prompt-cache markers."
+                    },
+                    "excludeActions": {
+                        "type": "string",
+                        "description": "Comma-separated action names to remove from the advertised action surface (core preset). Unknown names fail."
+                    }
+                },
+                "required": [
+                    "provider"
+                ],
+                "additionalProperties": false
+            },
+            "mutates": false,
+            "idempotency": "idempotent",
+            "supportsTrackedMode": false,
+            "supportsDryRun": false,
+            "outputSchema": {
+                "type": "object",
+                "properties": {
+                    "tools": {
+                        "type": "array"
+                    },
+                    "cacheStrategy": {
+                        "type": "string"
+                    }
+                },
+                "required": [
+                    "tools",
+                    "cacheStrategy"
+                ]
+            },
+            "skipAsATool": true
+        },
+        "doc.preset.getSystemPrompt": {
+            "operationId": "doc.preset.getSystemPrompt",
+            "sdkSurface": "document",
+            "command": "preset get-system-prompt",
+            "commandTokens": [
+                "preset",
+                "get-system-prompt"
+            ],
+            "category": "session",
+            "description": "Return the SDK-style system prompt for an LLM-tools preset.",
+            "requiresDocumentContext": false,
+            "docRequirement": "none",
+            "responseEnvelopeKey": null,
+            "params": [
+                {
+                    "name": "preset",
+                    "kind": "flag",
+                    "type": "string",
+                    "description": "Preset id. Defaults to the SDK default preset (legacy)."
+                },
+                {
+                    "name": "excludeActions",
+                    "kind": "flag",
+                    "type": "string",
+                    "description": "Comma-separated action names whose per-action documentation lines are dropped from the prompt (core preset)."
+                }
+            ],
+            "constraints": null,
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "preset": {
+                        "type": "string",
+                        "description": "Preset id. Defaults to the SDK default preset (legacy)."
+                    },
+                    "excludeActions": {
+                        "type": "string",
+                        "description": "Comma-separated action names whose per-action documentation lines are dropped from the prompt (core preset)."
+                    }
+                },
+                "additionalProperties": false
+            },
+            "mutates": false,
+            "idempotency": "idempotent",
+            "supportsTrackedMode": false,
+            "supportsDryRun": false,
+            "outputSchema": {
+                "type": "object",
+                "properties": {
+                    "prompt": {
+                        "type": "string"
+                    }
+                },
+                "required": [
+                    "prompt"
+                ]
+            },
+            "skipAsATool": true
+        },
+        "doc.preset.getMcpPrompt": {
+            "operationId": "doc.preset.getMcpPrompt",
+            "sdkSurface": "document",
+            "command": "preset get-mcp-prompt",
+            "commandTokens": [
+                "preset",
+                "get-mcp-prompt"
+            ],
+            "category": "session",
+            "description": "Return the MCP-flavored system prompt for an LLM-tools preset.",
+            "requiresDocumentContext": false,
+            "docRequirement": "none",
+            "responseEnvelopeKey": null,
+            "params": [
+                {
+                    "name": "preset",
+                    "kind": "flag",
+                    "type": "string",
+                    "description": "Preset id. Defaults to the SDK default preset (legacy)."
+                }
+            ],
+            "constraints": null,
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "preset": {
+                        "type": "string",
+                        "description": "Preset id. Defaults to the SDK default preset (legacy)."
+                    }
+                },
+                "additionalProperties": false
+            },
+            "mutates": false,
+            "idempotency": "idempotent",
+            "supportsTrackedMode": false,
+            "supportsDryRun": false,
+            "outputSchema": {
+                "type": "object",
+                "properties": {
+                    "prompt": {
+                        "type": "string"
+                    }
+                },
+                "required": [
+                    "prompt"
+                ]
+            },
+            "skipAsATool": true
+        },
+        "doc.preset.dispatch": {
+            "operationId": "doc.preset.dispatch",
+            "sdkSurface": "document",
+            "command": "preset dispatch",
+            "commandTokens": [
+                "preset",
+                "dispatch"
+            ],
+            "category": "core",
+            "description": "Dispatch an LLM tool call through the named preset's dispatcher against the active session's live document. Used by cross-language SDKs (e.g. Python) to proxy preset behavior over the CLI.",
+            "requiresDocumentContext": false,
+            "docRequirement": "none",
+            "responseEnvelopeKey": null,
+            "params": [
+                {
+                    "name": "sessionId",
+                    "kind": "flag",
+                    "type": "string",
+                    "flag": "session",
+                    "description": "Session ID for multi-session workflows. Optional when only one session is open."
+                },
+                {
+                    "name": "expectedRevision",
+                    "kind": "flag",
+                    "type": "number",
+                    "flag": "expected-revision",
+                    "agentVisible": false
+                },
+                {
+                    "name": "toolName",
+                    "kind": "flag",
+                    "type": "string",
+                    "flag": "tool-name",
+                    "required": true,
+                    "description": "Tool name to dispatch (e.g. superdoc_perform_action, superdoc_inspect, superdoc_execute_code)."
+                },
+                {
+                    "name": "args",
+                    "kind": "jsonFlag",
+                    "type": "json",
+                    "flag": "args-json",
+                    "description": "Tool arguments as a JSON object (matches the preset tool input schema)."
+                },
+                {
+                    "name": "excludeActions",
+                    "kind": "flag",
+                    "type": "string",
+                    "description": "Comma-separated action names to refuse at dispatch (defense-in-depth for a narrowed tool surface)."
+                },
+                {
+                    "name": "preset",
+                    "kind": "flag",
+                    "type": "string",
+                    "description": "Preset id. Defaults to the SDK default preset (legacy)."
+                }
+            ],
+            "constraints": null,
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "toolName": {
+                        "type": "string",
+                        "description": "Tool name to dispatch (e.g. superdoc_perform_action, superdoc_inspect, superdoc_execute_code)."
+                    },
+                    "args": {
+                        "type": "object",
+                        "description": "Tool arguments as a JSON object (matches the preset tool input schema)."
+                    },
+                    "excludeActions": {
+                        "type": "string",
+                        "description": "Comma-separated action names to refuse at dispatch (defense-in-depth for a narrowed tool surface)."
+                    },
+                    "preset": {
+                        "type": "string",
+                        "description": "Preset id. Defaults to the SDK default preset (legacy)."
+                    }
+                },
+                "required": [
+                    "toolName"
+                ],
+                "additionalProperties": false
+            },
+            "mutates": true,
+            "idempotency": "non-idempotent",
+            "supportsTrackedMode": false,
+            "supportsDryRun": false,
+            "outputSchema": {
+                "type": "object",
+                "properties": {
+                    "result": {},
+                    "context": {
+                        "type": "object",
+                        "properties": {
+                            "dirty": {
+                                "type": "boolean"
+                            },
+                            "revision": {
+                                "type": "number"
+                            },
+                            "mutated": {
+                                "type": "boolean"
+                            }
+                        }
+                    }
+                }
+            },
+            "skipAsATool": true
         }
     }
 };

package/dist/generated/contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/generated/contract.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,KAAK,GAAG,MAAM,GAAG,UAAU,CAAC;IAClC,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,QAAQ;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,GAAG,EAAE;QACH,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,QAAQ,EAAE;QACR,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,aAAa,EAAE,MAAM,EAAE,CAAC;KACzB,CAAC;IACF,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;CACpD;AAED,eAAO,MAAM,QAAQ,EAAE,QAsxuPtB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC,MAAM,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC"}
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/generated/contract.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,KAAK,GAAG,MAAM,GAAG,UAAU,CAAC;IAClC,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,QAAQ;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,GAAG,EAAE;QACH,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,QAAQ,EAAE;QACR,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,aAAa,EAAE,MAAM,EAAE,CAAC;KACzB,CAAC;IACF,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;CACpD;AAED,eAAO,MAAM,QAAQ,EAAE,QAkyvPtB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC,MAAM,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC"}