@stablebaseline/sdk 0.4.0 → 0.4.1

package/README.md

@@ -1,9 +1,9 @@
 # @stablebaseline/sdk
 
 [![npm](https://img.shields.io/npm/v/@stablebaseline/sdk?color=orange)](https://www.npmjs.com/package/@stablebaseline/sdk)
-[![Tools](https://img.shields.io/badge/MCP%20tools-163-orange)](https://stablebaseline.io/docs/mcp/tools)
+[![Tools](https://img.shields.io/badge/MCP%20tools-184-orange)](https://stablebaseline.io/docs/mcp/tools)
 
-TypeScript SDK for the **[Stable Baseline](https://stablebaseline.io) REST API** — the simplest, most complete, end-to-end agent-managed company brain. Living docs, 40+ visual diagrams, plans, and a self-learning Knowledge Graph. 163 tools across 16 categories.
+TypeScript SDK for the **[Stable Baseline](https://stablebaseline.io) REST API** — the simplest, most complete, end-to-end agent-managed company brain. Living docs, 40+ visual diagrams, plans, and a self-learning Knowledge Graph. 184 tools across 19 categories.
 
 ## Install
 
@@ -52,7 +52,7 @@ Both go in the `Authorization: Bearer <...>` header.
 
 ## Tool catalogue
 
-163 tools across 16 categories. The full list lives at [stablebaseline.io/docs/mcp/tools](https://stablebaseline.io/docs/mcp/tools). Highlights:
+184 tools across 19 categories. The full list lives at [stablebaseline.io/docs/mcp/tools](https://stablebaseline.io/docs/mcp/tools). Highlights:
 
 | Category | Sample tools |
 |---|---|

package/dist/index.cjs

@@ -49,7 +49,7 @@ var StableBaseline = class {
   authHeader;
   signal;
   /**
-   * Strongly-typed dispatch surface. Every entry is one of the 163 MCP tools.
+   * Strongly-typed dispatch surface. Every entry is one of the 184 MCP tools.
    *
    *   const orgs = await sb.tools.listOrganisations({});
    *   const doc = await sb.tools.createDocument({ folderId, title, cdmd });

package/dist/index.d.cts

@@ -874,7 +874,7 @@ interface paths {
         put?: never;
         /**
          * getWhiteboardImage
-         * @description Render a whiteboard to an IMAGE so you can SEE it and confirm your edits look right, then iterate — like taking a screenshot. Returns the rendered board as a viewable PNG (default) attached to the result. Pass elementIds to render only specific shapes (e.g. to inspect one section/slide), format:'svg' for vector markup instead of a raster, or background to set the canvas colour. Call this after addWhiteboardElements/updateWhiteboardScene to check layout, overlaps, labels and alignment before continuing.
+         * @description Render a whiteboard to an IMAGE so you can SEE it and confirm your edits look right, then iterate — like taking a screenshot. Returns the rendered board as a viewable image attached to the result. Pass elementIds to render only specific shapes (e.g. to inspect one section/slide), region:{x,y,width,height} to capture an exact scene-coordinate window (e.g. the user's viewport), theme:'light' for the fastest single-variant render, format:'svg' for vector markup, or background to set the canvas colour. Unchanged boards return instantly from a content-keyed cache. Call this after addWhiteboardElements/updateWhiteboardScene to check layout, overlaps, labels and alignment before continuing.
          */
         post: operations["getWhiteboardImage"];
         delete?: never;
@@ -7694,6 +7694,22 @@ interface operations {
                     elementIds?: string[];
                     /** @description Canvas background colour (default white), e.g. '#ffffff' or 'transparent'. */
                     background?: string;
+                    /** @description Capture only this scene-coordinate window instead of the whole board — e.g. the user's current viewport, or the neighbourhood you are editing. The output is cropped to the exact rectangle. */
+                    region?: {
+                        /** @description Window left edge (scene coordinates). */
+                        x: number;
+                        /** @description Window top edge (scene coordinates). */
+                        y: number;
+                        /** @description Window width (> 0). */
+                        width: number;
+                        /** @description Window height (> 0). */
+                        height: number;
+                    };
+                    /**
+                     * @description Which theme variant(s) to render. 'light' is fastest and right for inspecting your own edits; 'both' (default) also produces the dark variant used by the chat widget.
+                     * @enum {string}
+                     */
+                    theme?: "light" | "dark" | "both";
                 };
             };
         };
@@ -20202,7 +20218,7 @@ declare class StableBaseline {
     private authHeader;
     private signal?;
     /**
-     * Strongly-typed dispatch surface. Every entry is one of the 163 MCP tools.
+     * Strongly-typed dispatch surface. Every entry is one of the 184 MCP tools.
      *
      *   const orgs = await sb.tools.listOrganisations({});
      *   const doc = await sb.tools.createDocument({ folderId, title, cdmd });

package/dist/index.d.ts

@@ -874,7 +874,7 @@ interface paths {
         put?: never;
         /**
          * getWhiteboardImage
-         * @description Render a whiteboard to an IMAGE so you can SEE it and confirm your edits look right, then iterate — like taking a screenshot. Returns the rendered board as a viewable PNG (default) attached to the result. Pass elementIds to render only specific shapes (e.g. to inspect one section/slide), format:'svg' for vector markup instead of a raster, or background to set the canvas colour. Call this after addWhiteboardElements/updateWhiteboardScene to check layout, overlaps, labels and alignment before continuing.
+         * @description Render a whiteboard to an IMAGE so you can SEE it and confirm your edits look right, then iterate — like taking a screenshot. Returns the rendered board as a viewable image attached to the result. Pass elementIds to render only specific shapes (e.g. to inspect one section/slide), region:{x,y,width,height} to capture an exact scene-coordinate window (e.g. the user's viewport), theme:'light' for the fastest single-variant render, format:'svg' for vector markup, or background to set the canvas colour. Unchanged boards return instantly from a content-keyed cache. Call this after addWhiteboardElements/updateWhiteboardScene to check layout, overlaps, labels and alignment before continuing.
          */
         post: operations["getWhiteboardImage"];
         delete?: never;
@@ -7694,6 +7694,22 @@ interface operations {
                     elementIds?: string[];
                     /** @description Canvas background colour (default white), e.g. '#ffffff' or 'transparent'. */
                     background?: string;
+                    /** @description Capture only this scene-coordinate window instead of the whole board — e.g. the user's current viewport, or the neighbourhood you are editing. The output is cropped to the exact rectangle. */
+                    region?: {
+                        /** @description Window left edge (scene coordinates). */
+                        x: number;
+                        /** @description Window top edge (scene coordinates). */
+                        y: number;
+                        /** @description Window width (> 0). */
+                        width: number;
+                        /** @description Window height (> 0). */
+                        height: number;
+                    };
+                    /**
+                     * @description Which theme variant(s) to render. 'light' is fastest and right for inspecting your own edits; 'both' (default) also produces the dark variant used by the chat widget.
+                     * @enum {string}
+                     */
+                    theme?: "light" | "dark" | "both";
                 };
             };
         };
@@ -20202,7 +20218,7 @@ declare class StableBaseline {
     private authHeader;
     private signal?;
     /**
-     * Strongly-typed dispatch surface. Every entry is one of the 163 MCP tools.
+     * Strongly-typed dispatch surface. Every entry is one of the 184 MCP tools.
      *
      *   const orgs = await sb.tools.listOrganisations({});
      *   const doc = await sb.tools.createDocument({ folderId, title, cdmd });

package/dist/index.js

@@ -23,7 +23,7 @@ var StableBaseline = class {
   authHeader;
   signal;
   /**
-   * Strongly-typed dispatch surface. Every entry is one of the 163 MCP tools.
+   * Strongly-typed dispatch surface. Every entry is one of the 184 MCP tools.
    *
    *   const orgs = await sb.tools.listOrganisations({});
    *   const doc = await sb.tools.createDocument({ folderId, title, cdmd });

package/openapi.json

@@ -5417,7 +5417,7 @@
     "/tools/getWhiteboardImage": {
       "post": {
         "summary": "getWhiteboardImage",
-        "description": "Render a whiteboard to an IMAGE so you can SEE it and confirm your edits look right, then iterate — like taking a screenshot. Returns the rendered board as a viewable PNG (default) attached to the result. Pass elementIds to render only specific shapes (e.g. to inspect one section/slide), format:'svg' for vector markup instead of a raster, or background to set the canvas colour. Call this after addWhiteboardElements/updateWhiteboardScene to check layout, overlaps, labels and alignment before continuing.",
+        "description": "Render a whiteboard to an IMAGE so you can SEE it and confirm your edits look right, then iterate — like taking a screenshot. Returns the rendered board as a viewable image attached to the result. Pass elementIds to render only specific shapes (e.g. to inspect one section/slide), region:{x,y,width,height} to capture an exact scene-coordinate window (e.g. the user's viewport), theme:'light' for the fastest single-variant render, format:'svg' for vector markup, or background to set the canvas colour. Unchanged boards return instantly from a content-keyed cache. Call this after addWhiteboardElements/updateWhiteboardScene to check layout, overlaps, labels and alignment before continuing.",
         "operationId": "getWhiteboardImage",
         "tags": [
           "whiteboards"
@@ -5451,6 +5451,43 @@
                   "background": {
                     "type": "string",
                     "description": "Canvas background colour (default white), e.g. '#ffffff' or 'transparent'."
+                  },
+                  "region": {
+                    "type": "object",
+                    "description": "Capture only this scene-coordinate window instead of the whole board — e.g. the user's current viewport, or the neighbourhood you are editing. The output is cropped to the exact rectangle.",
+                    "properties": {
+                      "x": {
+                        "type": "number",
+                        "description": "Window left edge (scene coordinates)."
+                      },
+                      "y": {
+                        "type": "number",
+                        "description": "Window top edge (scene coordinates)."
+                      },
+                      "width": {
+                        "type": "number",
+                        "description": "Window width (> 0)."
+                      },
+                      "height": {
+                        "type": "number",
+                        "description": "Window height (> 0)."
+                      }
+                    },
+                    "required": [
+                      "x",
+                      "y",
+                      "width",
+                      "height"
+                    ]
+                  },
+                  "theme": {
+                    "type": "string",
+                    "enum": [
+                      "light",
+                      "dark",
+                      "both"
+                    ],
+                    "description": "Which theme variant(s) to render. 'light' is fastest and right for inspecting your own edits; 'both' (default) also produces the dark variant used by the chat widget."
                   }
                 },
                 "required": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stablebaseline/sdk",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "TypeScript SDK for the Stable Baseline REST API. End-to-end agent-managed company brain — docs, diagrams, plans, and a self-learning Knowledge Graph. 184 tools across 19 categories.",
   "homepage": "https://stablebaseline.io",
   "repository": {

package/src/client.ts

@@ -93,7 +93,7 @@ export class StableBaseline {
   private signal?: AbortSignal;
 
   /**
-   * Strongly-typed dispatch surface. Every entry is one of the 163 MCP tools.
+   * Strongly-typed dispatch surface. Every entry is one of the 184 MCP tools.
    *
    *   const orgs = await sb.tools.listOrganisations({});
    *   const doc = await sb.tools.createDocument({ folderId, title, cdmd });

package/src/index.ts

@@ -10,7 +10,7 @@
 //     cdmd: "# ...",
 //   });
 //
-// All 163 MCP tools are reachable from `sb.tools.<toolName>(input)`. Types
+// All 184 MCP tools are reachable from `sb.tools.<toolName>(input)`. Types
 // are generated from the live OpenAPI spec (`openapi.json` in this package).
 
 export { StableBaseline } from "./client.js";

package/src/types.generated.ts

@@ -875,7 +875,7 @@ export interface paths {
         put?: never;
         /**
          * getWhiteboardImage
-         * @description Render a whiteboard to an IMAGE so you can SEE it and confirm your edits look right, then iterate — like taking a screenshot. Returns the rendered board as a viewable PNG (default) attached to the result. Pass elementIds to render only specific shapes (e.g. to inspect one section/slide), format:'svg' for vector markup instead of a raster, or background to set the canvas colour. Call this after addWhiteboardElements/updateWhiteboardScene to check layout, overlaps, labels and alignment before continuing.
+         * @description Render a whiteboard to an IMAGE so you can SEE it and confirm your edits look right, then iterate — like taking a screenshot. Returns the rendered board as a viewable image attached to the result. Pass elementIds to render only specific shapes (e.g. to inspect one section/slide), region:{x,y,width,height} to capture an exact scene-coordinate window (e.g. the user's viewport), theme:'light' for the fastest single-variant render, format:'svg' for vector markup, or background to set the canvas colour. Unchanged boards return instantly from a content-keyed cache. Call this after addWhiteboardElements/updateWhiteboardScene to check layout, overlaps, labels and alignment before continuing.
          */
         post: operations["getWhiteboardImage"];
         delete?: never;
@@ -7695,6 +7695,22 @@ export interface operations {
                     elementIds?: string[];
                     /** @description Canvas background colour (default white), e.g. '#ffffff' or 'transparent'. */
                     background?: string;
+                    /** @description Capture only this scene-coordinate window instead of the whole board — e.g. the user's current viewport, or the neighbourhood you are editing. The output is cropped to the exact rectangle. */
+                    region?: {
+                        /** @description Window left edge (scene coordinates). */
+                        x: number;
+                        /** @description Window top edge (scene coordinates). */
+                        y: number;
+                        /** @description Window width (> 0). */
+                        width: number;
+                        /** @description Window height (> 0). */
+                        height: number;
+                    };
+                    /**
+                     * @description Which theme variant(s) to render. 'light' is fastest and right for inspecting your own edits; 'both' (default) also produces the dark variant used by the chat widget.
+                     * @enum {string}
+                     */
+                    theme?: "light" | "dark" | "both";
                 };
             };
         };