@stablebaseline/sdk 0.6.0 → 0.6.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.cts CHANGED
@@ -694,7 +694,7 @@ interface paths {
694
694
  put?: never;
695
695
  /**
696
696
  * designDeckInWhiteboard
697
- * @description Create or refine a slide deck INSIDE an existing whiteboard by conversing with the AI design agent. Send a brief for a NEW deck, a change to an EXISTING one, or an answer to the agent's question. The agent builds a polished, on-brand deck and places it on the board; if the brief is ambiguous it asks ONE clarifying question (answer with the same sessionId). Returns immediately; poll getDeckReplyInWhiteboard for the result. Use for building or editing slide decks / presentations. WHITEBOARD IS REQUIRED: a deck always lives inside a whiteboard, so documentId (the whiteboard's id) is required. If you do NOT already have a whiteboard id, ASK THE USER which whiteboard they want the deck designed in — do NOT create a whiteboard automatically. Only call createWhiteboard first if the user explicitly asks for a brand-new board; otherwise use the id of the whiteboard they name. FIRST vs FOLLOW-UP: the first call (from nothing) builds; a follow-up call (an answer, a change, or a new instruction) passes the sessionId (or the deckId) plus the new message. kind:'deck' (default) is the premium on-brand HTML deck; kind:'express' builds the native, deterministic branded-executive deck directly on the whiteboard (faster, lower fidelity, one-shot, not conversational). COST + APPROVAL: a build costs 50 credits and an edit 10; a clarifying question is FREE. GENERATED IMAGES are extra and OFF by default: decks are type-only unless the user asks for visuals, in which case set imageCount (5 credits each, ceiling scales with slide count and plan tier, max 10) and the exact total is quoted before anything is charged — exactly that many images are produced, and the image surcharge auto-refunds if the build cannot deliver them. ADVANCED DECK BUILDING (optional, OFF by default): set advancedDeckBuilding:true to build the deck over several rounds of redraft and review by a panel of design, brand, accessibility and copy reviewers instead of one composer pass. It usually raises design quality, but it is not a guarantee. It is much slower and it costs more: a standard build takes roughly 2 to 8 minutes, advanced deck building takes roughly 15 to 20 minutes, and it adds 15 credits per depth level on top of the turn fee (advancedDeckBuildingDepth is 1 to 3, default 3, so +45 credits, making a 50-credit build cost 95). Only turn it on when the user asks for the highest quality and accepts the wait and the cost. Call FIRST without confirm to get the exact cost plus the workspace balance, show it to the user, and only call again with confirm:true once they agree. The fee is auto-refunded if a turn produces no change or fails. Returns sessionId (the conversation), deckId (the deck), status, turnType, started, awaitingUser, needsConfirmation, insufficientCredits, slideCount + slideCountClamped (the target the conversation now carries, and whether it was reduced to the maximum), advancedDeckBuilding (whether advanced deck building is on for this conversation), advancedDeckBuildingStatus, and assistantMessage. Export the finished deck with exportFromWhiteboard.
697
+ * @description Create or refine a slide deck INSIDE an existing whiteboard by conversing with the AI design agent. Send a brief for a NEW deck, a change to an EXISTING one, or an answer to the agent's question. The agent builds a polished, on-brand deck and places it on the board; if the brief is ambiguous it asks ONE clarifying question (answer with the same sessionId). Returns immediately; poll getDeckReplyInWhiteboard for the result. Use for building or editing slide decks / presentations. WHITEBOARD IS REQUIRED: a deck always lives inside a whiteboard, so documentId (the whiteboard's id) is required. If you do NOT already have a whiteboard id, ASK THE USER which whiteboard they want the deck designed in — do NOT create a whiteboard automatically. Only call createWhiteboard first if the user explicitly asks for a brand-new board; otherwise use the id of the whiteboard they name. FIRST vs FOLLOW-UP: the first call (from nothing) builds; a follow-up call (an answer, a change, or a new instruction) passes the sessionId (or the deckId) plus the new message. kind:'deck' (default) is the premium on-brand HTML deck; kind:'express' builds the native, deterministic branded-executive deck directly on the whiteboard (faster, lower fidelity, one-shot, not conversational). COST + APPROVAL: a build costs 50 credits and an edit 10; a clarifying question is FREE. It can also generate imagery for the deck where the design calls for it. ADVANCED DECK BUILDING (optional, OFF by default): set advancedDeckBuilding:true to build the deck over several rounds of redraft and review by a panel of design, brand, accessibility and copy reviewers instead of one composer pass. It usually raises design quality, but it is not a guarantee. It is much slower and it costs more: a standard build takes roughly 2 to 8 minutes, advanced deck building takes roughly 15 to 20 minutes, and it adds 15 credits per depth level on top of the turn fee (advancedDeckBuildingDepth is 1 to 3, default 3, so +45 credits, making a 50-credit build cost 95). Only turn it on when the user asks for the highest quality and accepts the wait and the cost. Call FIRST without confirm to get the exact cost plus the workspace balance, show it to the user, and only call again with confirm:true once they agree. The fee is auto-refunded if a turn produces no change or fails. Returns sessionId (the conversation), deckId (the deck), status, turnType, started, awaitingUser, needsConfirmation, insufficientCredits, slideCount + slideCountClamped (the target the conversation now carries, and whether it was reduced to the maximum), advancedDeckBuilding (whether advanced deck building is on for this conversation), advancedDeckBuildingStatus, and assistantMessage. Export the finished deck with exportFromWhiteboard.
698
698
  */
699
699
  post: operations["designDeckInWhiteboard"];
700
700
  delete?: never;
@@ -754,7 +754,7 @@ interface paths {
754
754
  put?: never;
755
755
  /**
756
756
  * exportFromWhiteboard
757
- * @description Export a design that lives in a whiteboard to an editable PowerPoint (PPTX), PDF, PNG images, or raw HTML. Give it the whiteboard documentId and the designId (the deck). kind:'deck' (default) renders the finished deck via the export worker: 'pptx' = native, fully-editable PowerPoint (real shapes and text, not screenshots); 'pdf' = vector, one page per slide; 'png' = one image per slide (returned as a base64 array); 'html' = the self-contained deck HTML. Returns the file as base64 in data (pptx/pdf/html) or per-slide base64 in slides (png). The design must be finished; one that is still generating, failed, or archived returns a clear message.
757
+ * @description Export a design that lives in a whiteboard to an editable PowerPoint (PPTX), a PDF, or PNG images. LARGE DECKS FINISH IN THE BACKGROUND: if the export takes longer than one tool call can wait, this returns status:'exporting' with a jobId instead of the file — wait about 30 seconds and call this tool AGAIN with the SAME arguments to collect it. Repeat until status is 'completed' and 'url' is present. Nothing is re-exported while a job is already running, so polling is cheap and safe. Download links are available for 1 hour. Give it the whiteboard documentId and the designId (the deck). kind:'deck' (default) renders the finished deck via the export worker: 'pptx' = native, fully-editable PowerPoint (real shapes and text, not screenshots); 'pdf' = vector, one page per slide; 'png' = one image per slide. HTML is not an available format — do not ask for it. Small exports come back as base64 in data (pptx/pdf); anything larger, and every png export, comes back as download links. The design must be finished; one that is still generating, failed, or archived returns a clear message.
758
758
  */
759
759
  post: operations["exportFromWhiteboard"];
760
760
  delete?: never;
@@ -1094,7 +1094,7 @@ interface paths {
1094
1094
  put?: never;
1095
1095
  /**
1096
1096
  * renderDiagram
1097
- * @description Generate a diagram from its DSL/code and get the IMAGE back — WITHOUT inserting it into any document or whiteboard. For acting as a pure diagram generator. Provide diagramType (e.g. 'mermaid', 'd2', 'plantuml', 'graphviz', 'bpmn', 'vegalite'; call listDiagramTypes for the full set) and source (the diagram code). Choose format 'png' (default), 'jpeg', or 'svg'; for raster choose scale 1/2/3 for 1x/2x/3x; optional background (png only). Returns a TEMPORARY signed imageUrl that expires in 1 hour (then auto-deleted), and for png/jpeg the image inline so you can see it. To render a diagram that already lives in a document/whiteboard use getDiagramImage; to persist a new one use insertDiagramInDocument or insertWhiteboardDiagram.
1097
+ * @description Generate a diagram from its DSL/code and get the IMAGE back — WITHOUT inserting it into any document or whiteboard. For acting as a pure diagram generator. Provide diagramType (e.g. 'mermaid', 'd2', 'plantuml', 'graphviz', 'bpmn', 'vegalite'; call listDiagramTypes for the full set) and source (the diagram code). Choose format 'png' (default), 'jpeg', or 'svg'; for raster choose scale 1/2/3 for 1x/2x/3x; optional background (png only). Returns a TEMPORARY imageUrl that stays available for 1 hour (the render is then deleted), and for png/jpeg the image inline so you can see it. The link carries no signing token, so it survives being rendered as a citation. To render a diagram that already lives in a document/whiteboard use getDiagramImage; to persist a new one use insertDiagramInDocument or insertWhiteboardDiagram.
1098
1098
  */
1099
1099
  post: operations["renderDiagram"];
1100
1100
  delete?: never;
@@ -1114,7 +1114,7 @@ interface paths {
1114
1114
  put?: never;
1115
1115
  /**
1116
1116
  * getDiagramImage
1117
- * @description Render a diagram that ALREADY exists in a document to an IMAGE (svg/png/jpeg @1x/2x/3x) and return it — a temporary signed URL (expires in 1 hour) plus, for png/jpeg, the image inline so you can see it. Pass the diagramId (from getDocument's DIAGRAM markers or getDiagramInDocument). Reuses the diagram's cached server render when available (pixel-identical to the editor); when the diagram has no cached render yet, the fresh render is persisted back to the document (persistedRender:true in the response), so reading repairs unrendered diagrams. Use renderDiagram instead to generate from raw DSL without an existing diagram.
1117
+ * @description Render a diagram that ALREADY exists in a document to an IMAGE (svg/png/jpeg @1x/2x/3x) and return it — a temporary imageUrl available for 1 hour plus, for png/jpeg, the image inline so you can see it, and title/url citing the document the diagram lives in. Pass the diagramId (from getDocument's DIAGRAM markers or getDiagramInDocument). Reuses the diagram's cached server render when available (pixel-identical to the editor), otherwise renders from the diagram's source on the fly. Read-only: nothing in the document or the diagram is changed; the image is a temporary artefact that expires after 1 hour. Use renderDiagram instead to generate from raw DSL without an existing diagram.
1118
1118
  */
1119
1119
  post: operations["getDiagramImage"];
1120
1120
  delete?: never;
@@ -1234,7 +1234,7 @@ interface paths {
1234
1234
  put?: never;
1235
1235
  /**
1236
1236
  * insertImageInDocument
1237
- * @description Insert an image into a document (max 10MB). Provide imageBase64, imageBinary, or imageUrl. For large files, call createImageUploadSession first then use the returned assetUrl.
1237
+ * @description Insert an image into a document (max 10MB). Provide imageBase64, imageBinary, or imageUrl. For large files, call createImageUploadSession first then use the returned assetUrl. nlDescription AND caption are both REQUIRED, not optional polish: they are what makes the image findable in search and what lets an agent decide whether this picture belongs on a slide or in an answer, since neither can see the pixels from a filename. Write them about what the image SHOWS.
1238
1238
  */
1239
1239
  post: operations["insertImageInDocument"];
1240
1240
  delete?: never;
@@ -1254,7 +1254,7 @@ interface paths {
1254
1254
  put?: never;
1255
1255
  /**
1256
1256
  * updateImageInDocument
1257
- * @description Update image metadata (alt, caption, dimensions, alignment). Requires the document's versionTimestamp (from getDocument or any mutating tool's response) for optimistic locking.
1257
+ * @description Update image metadata (alt, caption, nlDescription, dimensions, alignment) — metadata only; to change the picture itself, delete it and insert the new one. Requires the document's versionTimestamp (from getDocument or any mutating tool's response) for optimistic locking.
1258
1258
  */
1259
1259
  post: operations["updateImageInDocument"];
1260
1260
  delete?: never;
@@ -1274,7 +1274,7 @@ interface paths {
1274
1274
  put?: never;
1275
1275
  /**
1276
1276
  * deleteImageInDocument
1277
- * @description Delete an image from a document and storage.
1277
+ * @description Delete an image: removes the stored file, the database record, AND the image from the document body — both the IMAGE marker in the markdown and the image node in the document's rich-text content, so the picture stops appearing on every read. Deleting an image the document still references is the point of this tool; do not hand-edit the marker out with editDocument, which removes the reference but leaves the file and record behind.
1278
1278
  */
1279
1279
  post: operations["deleteImageInDocument"];
1280
1280
  delete?: never;
@@ -3860,7 +3860,7 @@ interface paths {
3860
3860
  put?: never;
3861
3861
  /**
3862
3862
  * setDefaultBrandKit
3863
- * @description Set or clear the default BRAND KIT at a scope: organization, workspace, or project. Defaults cascade most-specific-first (a per-board/document override beats project beats workspace beats organization). Pass brandKitId:null to clear. Auth: org owner/admin.
3863
+ * @description Set or clear the default BRAND KIT at a scope: organization, workspace, project, folder, or document. Defaults cascade most-specific-first, lowest level up: document beats the nearest folder up the (nested) folder chain beats project beats workspace beats organization. Diagram brand theming, exports and decks all resolve through this cascade. Pass brandKitId:null to clear. Auth: org owner/admin.
3864
3864
  */
3865
3865
  post: operations["setDefaultBrandKit"];
3866
3866
  delete?: never;
@@ -3880,7 +3880,7 @@ interface paths {
3880
3880
  put?: never;
3881
3881
  /**
3882
3882
  * updateOrgFeatureFlags
3883
- * @description Toggle feature flags on settings.enabledFeatures (plans, improvements, compliance, knowledge_graph, documents). Auth: can_admin_org + org admin. Rate limit 30/min. Plan-tier gated: enabling knowledge_graph requires Pro/Enterprise.
3883
+ * @description Toggle organisation feature modules (plans, improvements, compliance, knowledge_graph, documents, meeting_scribe). Auth: can_admin_org + org admin. Rate limit 30/min. A flag can only be ENABLED when the feature is available to the organisation — included in its plan (knowledge_graph and compliance need Enterprise, meeting_scribe needs Pro or Enterprise) or granted by a platform administrator. Disabling is always allowed. Disabled modules hide their tools and app pages.
3884
3884
  */
3885
3885
  post: operations["updateOrgFeatureFlags"];
3886
3886
  delete?: never;
@@ -6366,7 +6366,7 @@ interface operations {
6366
6366
  align?: "left" | "center" | "right";
6367
6367
  /** @description Caption below the diagram. */
6368
6368
  caption?: string;
6369
- /** @description Insert after this line number (1-based). */
6369
+ /** @description Insert after this line, counting the SAME line numbers getDocument prints (1-based; frontmatter is not counted, and every diagram/image marker counts as exactly one line). 0 inserts at the very beginning; omit it to append at the end. Re-read with getDocument if the document may have changed, since the number is positional. */
6370
6370
  afterLine?: number;
6371
6371
  /** @description BPMN only. Color plan: { byElementId: { ElementId: SwatchName } }. */
6372
6372
  colorPlan?: {
@@ -6389,6 +6389,10 @@ interface operations {
6389
6389
  imageScale?: 1 | 2 | 3;
6390
6390
  /** @description Background for the returned png/jpeg (e.g. '#ffffff' or 'transparent'). */
6391
6391
  imageBackground?: string;
6392
+ /** @description Brand theming is ON BY DEFAULT: the document's effective BRAND KIT (colours only — typefaces are never injected) is baked into the diagram DSL before it is validated, rendered and stored, so the diagram is on-brand everywhere it appears (cascade: brandKitId override → project default → workspace default → org default → the built-in Stable Baseline theme). Set false to keep the library's stock styling. Themable types: mermaid, plantuml, graphviz, d2, systemsarchitecture, vega, vegalite, infographic — other types (incl. bpmn, which has colorPlan) are always stored unchanged. Author theming in the DSL wins (an existing mermaid %%{init}%%, plantuml !theme, d2 vars.d2-config, or a hand-written infographic palette is never overridden). The stored diagramCode is the THEMED source. */
6393
+ applyBrandTheme?: boolean;
6394
+ /** @description Optional brand kit UUID (see listBrandKits) to theme with instead of the cascade default. Must belong to your organisation. */
6395
+ brandKitId?: string;
6392
6396
  };
6393
6397
  };
6394
6398
  };
@@ -6485,6 +6489,10 @@ interface operations {
6485
6489
  align?: "left" | "center" | "right";
6486
6490
  /** @description New caption. */
6487
6491
  caption?: string;
6492
+ /** @description Brand theming is ON BY DEFAULT when diagramCode is provided: the document's effective BRAND KIT is baked into the new DSL before it is validated, rendered and stored. Set false to keep the library's stock styling. Same cascade + themable types + author-wins guards as insertDiagramInDocument. The stored diagramCode is the THEMED source. */
6493
+ applyBrandTheme?: boolean;
6494
+ /** @description Optional brand kit UUID (see listBrandKits) to theme with instead of the cascade default. Must belong to your organisation. */
6495
+ brandKitId?: string;
6488
6496
  /** @description BPMN only. Updated color plan. Set to null to remove. */
6489
6497
  colorPlan?: {
6490
6498
  /** @description Map of element IDs to color swatch names. */
@@ -7148,7 +7156,7 @@ interface operations {
7148
7156
  brandKitId?: string;
7149
7157
  /** @description The number of slides to build — a hard requirement: the deck is built with exactly this many slides. SET THIS whenever the user states or implies a count, EXACT OR APPROXIMATE: '12 slides' → 12, 'about 15' / '15 or so' → 15, 'no more than 10' → 10. Never expand the user's number: if they said 'about 15', pass 15 and shape the brief to fit 15 — outlining 19 sections in the message does not raise the count, it just fights this parameter. It is PERSISTED on the conversation, so send it ONCE (on the turn that states it) and every later build turn of the same conversation carries it automatically; send it again only to CHANGE the target. It is honoured on edit turns too ('cut it to 8 slides'). Anything above the 30-slide maximum is reduced to 30 and the reduction is stated back in the response. Omit ONLY when the user gave no count at all; the designer then chooses (typical 6 to 12). */
7150
7158
  slideCount?: number;
7151
- /** @description How many AI-GENERATED images this turn may produce. DEFAULT IS 0 — decks are type-only unless the user asks for visuals. SET THIS when the user wants imagery: 'a cover image' → 1, 'a few images' → 2, 'image-led / very visual' → omit nothing and pass a higher number. Each image costs 5 extra credits, quoted upfront in the confirmation (base fee + images), and EXACTLY this many are produced — never more, never fewer (the image surcharge is auto-refunded if the build cannot deliver them). The ceiling scales with the deck (about one image per three slides, so a 30-slide deck tops out at 10) and with the plan tier; anything above the ceiling is reduced and the reduction is stated back. If omitted, the count is derived conservatively from the user's wording (silence = 0). */
7159
+ /** @description Deprecated and ignored. Still accepted so existing callers do not break; passing it changes nothing. */
7152
7160
  imageCount?: number;
7153
7161
  /** @description Optional, OFF by default. Build the deck with ADVANCED DECK BUILDING: instead of one composer pass, the deck is redrafted and reviewed over several rounds by a panel of design, brand, accessibility and copy reviewers, each round scoring the deck and listing what must be fixed. It usually produces a higher-quality deck, but it is not a guarantee. TIME: a standard build takes roughly 2 to 8 minutes; advanced deck building takes roughly 15 to 20 minutes. COST: 15 extra credits per depth level on top of the turn fee, so the default depth of 3 adds 45 credits and makes a 50-credit build cost 95. This is the user's deliberate choice, so only switch it on when they have asked for the best possible deck and accepted the wait and the cost. Quote the turn FIRST (call without confirm) so the user sees the real total before approving. Set it once and it is remembered for the rest of the conversation; pass false to turn it off again. */
7154
7162
  advancedDeckBuilding?: boolean;
@@ -7453,10 +7461,10 @@ interface operations {
7453
7461
  */
7454
7462
  kind?: "deck";
7455
7463
  /**
7456
- * @description Output format. 'pptx' (default) = editable PowerPoint; 'pdf' = vector PDF; 'png' = one base64 image per slide; 'html' = the design's self-contained HTML.
7464
+ * @description Output format. 'pptx' (default) = editable PowerPoint; 'pdf' = vector PDF; 'png' = one image per slide. HTML is not available.
7457
7465
  * @enum {string}
7458
7466
  */
7459
- format?: "pptx" | "pdf" | "png" | "html";
7467
+ format?: "pptx" | "pdf" | "png";
7460
7468
  /** @description Optional brand kit id (reserved for future per-export theming; the design is already branded, so this is usually unnecessary). */
7461
7469
  brandKitId?: string;
7462
7470
  };
@@ -8574,6 +8582,10 @@ interface operations {
8574
8582
  align?: "left" | "center" | "right";
8575
8583
  /** @description Element id of an EXISTING embedded diagram to re-render and replace in place (keeps the element id + board position). Omit for a fresh insert. If the id is not on the board, a new element is created with it. */
8576
8584
  updateElementId?: string;
8585
+ /** @description Brand theming is ON BY DEFAULT: the board's effective BRAND KIT (colours only — typefaces are never injected) is baked into the diagram before it is rendered and its editable source stored (cascade: brandKitId override → project → workspace → org default → the built-in Stable Baseline theme). Set false to keep the library's stock styling. Themable types: mermaid, plantuml, graphviz, d2, systemsarchitecture, vega, vegalite, infographic; author theming in the DSL always wins. */
8586
+ applyBrandTheme?: boolean;
8587
+ /** @description Optional brand kit UUID (see listBrandKits) to theme with instead of the cascade default. Must belong to your organisation. */
8588
+ brandKitId?: string;
8577
8589
  /**
8578
8590
  * @description When 'contain' AND both width and height are given, treat width/height as a BOUNDING BOX: the diagram is scaled to its natural aspect ratio to fit inside the box (never upscaled past 1.5x natural) and centred, so it never stretches. The response's diagram.{x,y,width,height} carry the final drawn geometry. Omit for the exact width/height behaviour.
8579
8591
  * @enum {string}
@@ -9157,6 +9169,12 @@ interface operations {
9157
9169
  scale?: 1 | 2 | 3;
9158
9170
  /** @description Background for png/jpeg, e.g. '#ffffff' or 'transparent' (png only). */
9159
9171
  background?: string;
9172
+ /** @description Brand theming is ON BY DEFAULT: the effective BRAND KIT (colours only — typefaces are never injected) is baked into the diagram before rendering (cascade: brandKitId override → project default → workspace default → org default → the built-in Stable Baseline theme). Set false to render with the library's stock styling instead. Themable types: mermaid, plantuml, graphviz, d2, systemsarchitecture, vega, vegalite, infographic — other types always render unchanged. Author theming in the DSL wins (an existing mermaid %%{init}%%, plantuml !theme, d2 vars.d2-config, or a hand-written infographic palette is never overridden). */
9173
+ applyBrandTheme?: boolean;
9174
+ /** @description Optional brand kit UUID (see listBrandKits) to theme with instead of the cascade default. Must belong to your organisation. */
9175
+ brandKitId?: string;
9176
+ /** @description Optional project UUID used to resolve the project → workspace → org brand-kit cascade. Without it the built-in Stable Baseline brand themes the render. */
9177
+ projectId?: string;
9160
9178
  };
9161
9179
  };
9162
9180
  };
@@ -9799,7 +9817,7 @@ interface operations {
9799
9817
  width?: number;
9800
9818
  /** @description Height in pixels. */
9801
9819
  height?: number;
9802
- /** @description Insert after this line (0 = beginning, omit = end). */
9820
+ /** @description Insert after this line, counting the SAME line numbers getDocument prints (1-based; frontmatter is not counted, and every diagram/image marker counts as exactly one line). 0 inserts at the very beginning; omit it to append at the end. Re-read with getDocument if the document may have changed, since the number is positional. */
9803
9821
  afterLine?: number;
9804
9822
  /** @description Alt text. Defaults to caption. */
9805
9823
  alt?: string;
@@ -9991,6 +10009,8 @@ interface operations {
9991
10009
  "application/json": {
9992
10010
  /** @description Image ID from IMAGE_OMITTED markers. */
9993
10011
  imageId: string;
10012
+ /** @description Optional document optimistic-lock token; validated when provided. (Alias accepted: documentVersionTimestamp.) */
10013
+ versionTimestamp?: number;
9994
10014
  };
9995
10015
  };
9996
10016
  };
@@ -21262,7 +21282,7 @@ interface operations {
21262
21282
  logoUrl?: string;
21263
21283
  /** @description URL of an existing .pptx or .docx to extract the brand from (theme colours + fonts + logo + watermark + embedded fonts). Max 25MB. Omit if passing logoUrl or tokens. */
21264
21284
  officeUrl?: string;
21265
- /** @description Explicit DTCG brand tokens { color:{brand:{primary,primaryText,ink,bg,surface,muted,border,positive,warning,negative}}, font:{heading,body} }. Omit to extract from logoUrl/officeUrl. */
21285
+ /** @description Explicit DTCG brand tokens { color:{brand:{primary,primaryText,ink,bg,surface,muted,border,positive,warning,negative,accentHover?,accentActive?}}, font:{heading,body} }. EXTENDED CAPTURE (all optional; captured values replace derivation heuristics in deck/document theming): structure:{typeScalePx:[..], leadingBody, leadingTight, trackingDisplayEm, spacingPx:[..], radiusPx:{sm,md,lg}, elevation:'flat'|'ring'|'soft'|'raised'}, motion:{speed:'snappy'|'standard'|'stately', easing:'cubic-bezier(..)'}, voice:{tone, notes}, imagery:{style, notes}, antiPatterns:['never ..']. Omit tokens entirely to extract from logoUrl/officeUrl. */
21266
21286
  tokens?: {
21267
21287
  [key: string]: unknown;
21268
21288
  };
@@ -21439,8 +21459,8 @@ interface operations {
21439
21459
  content: {
21440
21460
  "application/json": {
21441
21461
  /** @enum {string} */
21442
- scope: "organization" | "workspace" | "project";
21443
- /** @description The org/workspace/project id for the chosen scope. */
21462
+ scope: "organization" | "workspace" | "project" | "folder" | "document";
21463
+ /** @description The org/workspace/project/folder/document id for the chosen scope. */
21444
21464
  scopeId: string;
21445
21465
  /** @description Brand kit to make default, or null to clear. */
21446
21466
  brandKitId?: string | null;
@@ -21531,6 +21551,7 @@ interface operations {
21531
21551
  compliance?: boolean;
21532
21552
  knowledge_graph?: boolean;
21533
21553
  documents?: boolean;
21554
+ meeting_scribe?: boolean;
21534
21555
  };
21535
21556
  };
21536
21557
  };
package/dist/index.d.ts CHANGED
@@ -694,7 +694,7 @@ interface paths {
694
694
  put?: never;
695
695
  /**
696
696
  * designDeckInWhiteboard
697
- * @description Create or refine a slide deck INSIDE an existing whiteboard by conversing with the AI design agent. Send a brief for a NEW deck, a change to an EXISTING one, or an answer to the agent's question. The agent builds a polished, on-brand deck and places it on the board; if the brief is ambiguous it asks ONE clarifying question (answer with the same sessionId). Returns immediately; poll getDeckReplyInWhiteboard for the result. Use for building or editing slide decks / presentations. WHITEBOARD IS REQUIRED: a deck always lives inside a whiteboard, so documentId (the whiteboard's id) is required. If you do NOT already have a whiteboard id, ASK THE USER which whiteboard they want the deck designed in — do NOT create a whiteboard automatically. Only call createWhiteboard first if the user explicitly asks for a brand-new board; otherwise use the id of the whiteboard they name. FIRST vs FOLLOW-UP: the first call (from nothing) builds; a follow-up call (an answer, a change, or a new instruction) passes the sessionId (or the deckId) plus the new message. kind:'deck' (default) is the premium on-brand HTML deck; kind:'express' builds the native, deterministic branded-executive deck directly on the whiteboard (faster, lower fidelity, one-shot, not conversational). COST + APPROVAL: a build costs 50 credits and an edit 10; a clarifying question is FREE. GENERATED IMAGES are extra and OFF by default: decks are type-only unless the user asks for visuals, in which case set imageCount (5 credits each, ceiling scales with slide count and plan tier, max 10) and the exact total is quoted before anything is charged — exactly that many images are produced, and the image surcharge auto-refunds if the build cannot deliver them. ADVANCED DECK BUILDING (optional, OFF by default): set advancedDeckBuilding:true to build the deck over several rounds of redraft and review by a panel of design, brand, accessibility and copy reviewers instead of one composer pass. It usually raises design quality, but it is not a guarantee. It is much slower and it costs more: a standard build takes roughly 2 to 8 minutes, advanced deck building takes roughly 15 to 20 minutes, and it adds 15 credits per depth level on top of the turn fee (advancedDeckBuildingDepth is 1 to 3, default 3, so +45 credits, making a 50-credit build cost 95). Only turn it on when the user asks for the highest quality and accepts the wait and the cost. Call FIRST without confirm to get the exact cost plus the workspace balance, show it to the user, and only call again with confirm:true once they agree. The fee is auto-refunded if a turn produces no change or fails. Returns sessionId (the conversation), deckId (the deck), status, turnType, started, awaitingUser, needsConfirmation, insufficientCredits, slideCount + slideCountClamped (the target the conversation now carries, and whether it was reduced to the maximum), advancedDeckBuilding (whether advanced deck building is on for this conversation), advancedDeckBuildingStatus, and assistantMessage. Export the finished deck with exportFromWhiteboard.
697
+ * @description Create or refine a slide deck INSIDE an existing whiteboard by conversing with the AI design agent. Send a brief for a NEW deck, a change to an EXISTING one, or an answer to the agent's question. The agent builds a polished, on-brand deck and places it on the board; if the brief is ambiguous it asks ONE clarifying question (answer with the same sessionId). Returns immediately; poll getDeckReplyInWhiteboard for the result. Use for building or editing slide decks / presentations. WHITEBOARD IS REQUIRED: a deck always lives inside a whiteboard, so documentId (the whiteboard's id) is required. If you do NOT already have a whiteboard id, ASK THE USER which whiteboard they want the deck designed in — do NOT create a whiteboard automatically. Only call createWhiteboard first if the user explicitly asks for a brand-new board; otherwise use the id of the whiteboard they name. FIRST vs FOLLOW-UP: the first call (from nothing) builds; a follow-up call (an answer, a change, or a new instruction) passes the sessionId (or the deckId) plus the new message. kind:'deck' (default) is the premium on-brand HTML deck; kind:'express' builds the native, deterministic branded-executive deck directly on the whiteboard (faster, lower fidelity, one-shot, not conversational). COST + APPROVAL: a build costs 50 credits and an edit 10; a clarifying question is FREE. It can also generate imagery for the deck where the design calls for it. ADVANCED DECK BUILDING (optional, OFF by default): set advancedDeckBuilding:true to build the deck over several rounds of redraft and review by a panel of design, brand, accessibility and copy reviewers instead of one composer pass. It usually raises design quality, but it is not a guarantee. It is much slower and it costs more: a standard build takes roughly 2 to 8 minutes, advanced deck building takes roughly 15 to 20 minutes, and it adds 15 credits per depth level on top of the turn fee (advancedDeckBuildingDepth is 1 to 3, default 3, so +45 credits, making a 50-credit build cost 95). Only turn it on when the user asks for the highest quality and accepts the wait and the cost. Call FIRST without confirm to get the exact cost plus the workspace balance, show it to the user, and only call again with confirm:true once they agree. The fee is auto-refunded if a turn produces no change or fails. Returns sessionId (the conversation), deckId (the deck), status, turnType, started, awaitingUser, needsConfirmation, insufficientCredits, slideCount + slideCountClamped (the target the conversation now carries, and whether it was reduced to the maximum), advancedDeckBuilding (whether advanced deck building is on for this conversation), advancedDeckBuildingStatus, and assistantMessage. Export the finished deck with exportFromWhiteboard.
698
698
  */
699
699
  post: operations["designDeckInWhiteboard"];
700
700
  delete?: never;
@@ -754,7 +754,7 @@ interface paths {
754
754
  put?: never;
755
755
  /**
756
756
  * exportFromWhiteboard
757
- * @description Export a design that lives in a whiteboard to an editable PowerPoint (PPTX), PDF, PNG images, or raw HTML. Give it the whiteboard documentId and the designId (the deck). kind:'deck' (default) renders the finished deck via the export worker: 'pptx' = native, fully-editable PowerPoint (real shapes and text, not screenshots); 'pdf' = vector, one page per slide; 'png' = one image per slide (returned as a base64 array); 'html' = the self-contained deck HTML. Returns the file as base64 in data (pptx/pdf/html) or per-slide base64 in slides (png). The design must be finished; one that is still generating, failed, or archived returns a clear message.
757
+ * @description Export a design that lives in a whiteboard to an editable PowerPoint (PPTX), a PDF, or PNG images. LARGE DECKS FINISH IN THE BACKGROUND: if the export takes longer than one tool call can wait, this returns status:'exporting' with a jobId instead of the file — wait about 30 seconds and call this tool AGAIN with the SAME arguments to collect it. Repeat until status is 'completed' and 'url' is present. Nothing is re-exported while a job is already running, so polling is cheap and safe. Download links are available for 1 hour. Give it the whiteboard documentId and the designId (the deck). kind:'deck' (default) renders the finished deck via the export worker: 'pptx' = native, fully-editable PowerPoint (real shapes and text, not screenshots); 'pdf' = vector, one page per slide; 'png' = one image per slide. HTML is not an available format — do not ask for it. Small exports come back as base64 in data (pptx/pdf); anything larger, and every png export, comes back as download links. The design must be finished; one that is still generating, failed, or archived returns a clear message.
758
758
  */
759
759
  post: operations["exportFromWhiteboard"];
760
760
  delete?: never;
@@ -1094,7 +1094,7 @@ interface paths {
1094
1094
  put?: never;
1095
1095
  /**
1096
1096
  * renderDiagram
1097
- * @description Generate a diagram from its DSL/code and get the IMAGE back — WITHOUT inserting it into any document or whiteboard. For acting as a pure diagram generator. Provide diagramType (e.g. 'mermaid', 'd2', 'plantuml', 'graphviz', 'bpmn', 'vegalite'; call listDiagramTypes for the full set) and source (the diagram code). Choose format 'png' (default), 'jpeg', or 'svg'; for raster choose scale 1/2/3 for 1x/2x/3x; optional background (png only). Returns a TEMPORARY signed imageUrl that expires in 1 hour (then auto-deleted), and for png/jpeg the image inline so you can see it. To render a diagram that already lives in a document/whiteboard use getDiagramImage; to persist a new one use insertDiagramInDocument or insertWhiteboardDiagram.
1097
+ * @description Generate a diagram from its DSL/code and get the IMAGE back — WITHOUT inserting it into any document or whiteboard. For acting as a pure diagram generator. Provide diagramType (e.g. 'mermaid', 'd2', 'plantuml', 'graphviz', 'bpmn', 'vegalite'; call listDiagramTypes for the full set) and source (the diagram code). Choose format 'png' (default), 'jpeg', or 'svg'; for raster choose scale 1/2/3 for 1x/2x/3x; optional background (png only). Returns a TEMPORARY imageUrl that stays available for 1 hour (the render is then deleted), and for png/jpeg the image inline so you can see it. The link carries no signing token, so it survives being rendered as a citation. To render a diagram that already lives in a document/whiteboard use getDiagramImage; to persist a new one use insertDiagramInDocument or insertWhiteboardDiagram.
1098
1098
  */
1099
1099
  post: operations["renderDiagram"];
1100
1100
  delete?: never;
@@ -1114,7 +1114,7 @@ interface paths {
1114
1114
  put?: never;
1115
1115
  /**
1116
1116
  * getDiagramImage
1117
- * @description Render a diagram that ALREADY exists in a document to an IMAGE (svg/png/jpeg @1x/2x/3x) and return it — a temporary signed URL (expires in 1 hour) plus, for png/jpeg, the image inline so you can see it. Pass the diagramId (from getDocument's DIAGRAM markers or getDiagramInDocument). Reuses the diagram's cached server render when available (pixel-identical to the editor); when the diagram has no cached render yet, the fresh render is persisted back to the document (persistedRender:true in the response), so reading repairs unrendered diagrams. Use renderDiagram instead to generate from raw DSL without an existing diagram.
1117
+ * @description Render a diagram that ALREADY exists in a document to an IMAGE (svg/png/jpeg @1x/2x/3x) and return it — a temporary imageUrl available for 1 hour plus, for png/jpeg, the image inline so you can see it, and title/url citing the document the diagram lives in. Pass the diagramId (from getDocument's DIAGRAM markers or getDiagramInDocument). Reuses the diagram's cached server render when available (pixel-identical to the editor), otherwise renders from the diagram's source on the fly. Read-only: nothing in the document or the diagram is changed; the image is a temporary artefact that expires after 1 hour. Use renderDiagram instead to generate from raw DSL without an existing diagram.
1118
1118
  */
1119
1119
  post: operations["getDiagramImage"];
1120
1120
  delete?: never;
@@ -1234,7 +1234,7 @@ interface paths {
1234
1234
  put?: never;
1235
1235
  /**
1236
1236
  * insertImageInDocument
1237
- * @description Insert an image into a document (max 10MB). Provide imageBase64, imageBinary, or imageUrl. For large files, call createImageUploadSession first then use the returned assetUrl.
1237
+ * @description Insert an image into a document (max 10MB). Provide imageBase64, imageBinary, or imageUrl. For large files, call createImageUploadSession first then use the returned assetUrl. nlDescription AND caption are both REQUIRED, not optional polish: they are what makes the image findable in search and what lets an agent decide whether this picture belongs on a slide or in an answer, since neither can see the pixels from a filename. Write them about what the image SHOWS.
1238
1238
  */
1239
1239
  post: operations["insertImageInDocument"];
1240
1240
  delete?: never;
@@ -1254,7 +1254,7 @@ interface paths {
1254
1254
  put?: never;
1255
1255
  /**
1256
1256
  * updateImageInDocument
1257
- * @description Update image metadata (alt, caption, dimensions, alignment). Requires the document's versionTimestamp (from getDocument or any mutating tool's response) for optimistic locking.
1257
+ * @description Update image metadata (alt, caption, nlDescription, dimensions, alignment) — metadata only; to change the picture itself, delete it and insert the new one. Requires the document's versionTimestamp (from getDocument or any mutating tool's response) for optimistic locking.
1258
1258
  */
1259
1259
  post: operations["updateImageInDocument"];
1260
1260
  delete?: never;
@@ -1274,7 +1274,7 @@ interface paths {
1274
1274
  put?: never;
1275
1275
  /**
1276
1276
  * deleteImageInDocument
1277
- * @description Delete an image from a document and storage.
1277
+ * @description Delete an image: removes the stored file, the database record, AND the image from the document body — both the IMAGE marker in the markdown and the image node in the document's rich-text content, so the picture stops appearing on every read. Deleting an image the document still references is the point of this tool; do not hand-edit the marker out with editDocument, which removes the reference but leaves the file and record behind.
1278
1278
  */
1279
1279
  post: operations["deleteImageInDocument"];
1280
1280
  delete?: never;
@@ -3860,7 +3860,7 @@ interface paths {
3860
3860
  put?: never;
3861
3861
  /**
3862
3862
  * setDefaultBrandKit
3863
- * @description Set or clear the default BRAND KIT at a scope: organization, workspace, or project. Defaults cascade most-specific-first (a per-board/document override beats project beats workspace beats organization). Pass brandKitId:null to clear. Auth: org owner/admin.
3863
+ * @description Set or clear the default BRAND KIT at a scope: organization, workspace, project, folder, or document. Defaults cascade most-specific-first, lowest level up: document beats the nearest folder up the (nested) folder chain beats project beats workspace beats organization. Diagram brand theming, exports and decks all resolve through this cascade. Pass brandKitId:null to clear. Auth: org owner/admin.
3864
3864
  */
3865
3865
  post: operations["setDefaultBrandKit"];
3866
3866
  delete?: never;
@@ -3880,7 +3880,7 @@ interface paths {
3880
3880
  put?: never;
3881
3881
  /**
3882
3882
  * updateOrgFeatureFlags
3883
- * @description Toggle feature flags on settings.enabledFeatures (plans, improvements, compliance, knowledge_graph, documents). Auth: can_admin_org + org admin. Rate limit 30/min. Plan-tier gated: enabling knowledge_graph requires Pro/Enterprise.
3883
+ * @description Toggle organisation feature modules (plans, improvements, compliance, knowledge_graph, documents, meeting_scribe). Auth: can_admin_org + org admin. Rate limit 30/min. A flag can only be ENABLED when the feature is available to the organisation — included in its plan (knowledge_graph and compliance need Enterprise, meeting_scribe needs Pro or Enterprise) or granted by a platform administrator. Disabling is always allowed. Disabled modules hide their tools and app pages.
3884
3884
  */
3885
3885
  post: operations["updateOrgFeatureFlags"];
3886
3886
  delete?: never;
@@ -6366,7 +6366,7 @@ interface operations {
6366
6366
  align?: "left" | "center" | "right";
6367
6367
  /** @description Caption below the diagram. */
6368
6368
  caption?: string;
6369
- /** @description Insert after this line number (1-based). */
6369
+ /** @description Insert after this line, counting the SAME line numbers getDocument prints (1-based; frontmatter is not counted, and every diagram/image marker counts as exactly one line). 0 inserts at the very beginning; omit it to append at the end. Re-read with getDocument if the document may have changed, since the number is positional. */
6370
6370
  afterLine?: number;
6371
6371
  /** @description BPMN only. Color plan: { byElementId: { ElementId: SwatchName } }. */
6372
6372
  colorPlan?: {
@@ -6389,6 +6389,10 @@ interface operations {
6389
6389
  imageScale?: 1 | 2 | 3;
6390
6390
  /** @description Background for the returned png/jpeg (e.g. '#ffffff' or 'transparent'). */
6391
6391
  imageBackground?: string;
6392
+ /** @description Brand theming is ON BY DEFAULT: the document's effective BRAND KIT (colours only — typefaces are never injected) is baked into the diagram DSL before it is validated, rendered and stored, so the diagram is on-brand everywhere it appears (cascade: brandKitId override → project default → workspace default → org default → the built-in Stable Baseline theme). Set false to keep the library's stock styling. Themable types: mermaid, plantuml, graphviz, d2, systemsarchitecture, vega, vegalite, infographic — other types (incl. bpmn, which has colorPlan) are always stored unchanged. Author theming in the DSL wins (an existing mermaid %%{init}%%, plantuml !theme, d2 vars.d2-config, or a hand-written infographic palette is never overridden). The stored diagramCode is the THEMED source. */
6393
+ applyBrandTheme?: boolean;
6394
+ /** @description Optional brand kit UUID (see listBrandKits) to theme with instead of the cascade default. Must belong to your organisation. */
6395
+ brandKitId?: string;
6392
6396
  };
6393
6397
  };
6394
6398
  };
@@ -6485,6 +6489,10 @@ interface operations {
6485
6489
  align?: "left" | "center" | "right";
6486
6490
  /** @description New caption. */
6487
6491
  caption?: string;
6492
+ /** @description Brand theming is ON BY DEFAULT when diagramCode is provided: the document's effective BRAND KIT is baked into the new DSL before it is validated, rendered and stored. Set false to keep the library's stock styling. Same cascade + themable types + author-wins guards as insertDiagramInDocument. The stored diagramCode is the THEMED source. */
6493
+ applyBrandTheme?: boolean;
6494
+ /** @description Optional brand kit UUID (see listBrandKits) to theme with instead of the cascade default. Must belong to your organisation. */
6495
+ brandKitId?: string;
6488
6496
  /** @description BPMN only. Updated color plan. Set to null to remove. */
6489
6497
  colorPlan?: {
6490
6498
  /** @description Map of element IDs to color swatch names. */
@@ -7148,7 +7156,7 @@ interface operations {
7148
7156
  brandKitId?: string;
7149
7157
  /** @description The number of slides to build — a hard requirement: the deck is built with exactly this many slides. SET THIS whenever the user states or implies a count, EXACT OR APPROXIMATE: '12 slides' → 12, 'about 15' / '15 or so' → 15, 'no more than 10' → 10. Never expand the user's number: if they said 'about 15', pass 15 and shape the brief to fit 15 — outlining 19 sections in the message does not raise the count, it just fights this parameter. It is PERSISTED on the conversation, so send it ONCE (on the turn that states it) and every later build turn of the same conversation carries it automatically; send it again only to CHANGE the target. It is honoured on edit turns too ('cut it to 8 slides'). Anything above the 30-slide maximum is reduced to 30 and the reduction is stated back in the response. Omit ONLY when the user gave no count at all; the designer then chooses (typical 6 to 12). */
7150
7158
  slideCount?: number;
7151
- /** @description How many AI-GENERATED images this turn may produce. DEFAULT IS 0 — decks are type-only unless the user asks for visuals. SET THIS when the user wants imagery: 'a cover image' → 1, 'a few images' → 2, 'image-led / very visual' → omit nothing and pass a higher number. Each image costs 5 extra credits, quoted upfront in the confirmation (base fee + images), and EXACTLY this many are produced — never more, never fewer (the image surcharge is auto-refunded if the build cannot deliver them). The ceiling scales with the deck (about one image per three slides, so a 30-slide deck tops out at 10) and with the plan tier; anything above the ceiling is reduced and the reduction is stated back. If omitted, the count is derived conservatively from the user's wording (silence = 0). */
7159
+ /** @description Deprecated and ignored. Still accepted so existing callers do not break; passing it changes nothing. */
7152
7160
  imageCount?: number;
7153
7161
  /** @description Optional, OFF by default. Build the deck with ADVANCED DECK BUILDING: instead of one composer pass, the deck is redrafted and reviewed over several rounds by a panel of design, brand, accessibility and copy reviewers, each round scoring the deck and listing what must be fixed. It usually produces a higher-quality deck, but it is not a guarantee. TIME: a standard build takes roughly 2 to 8 minutes; advanced deck building takes roughly 15 to 20 minutes. COST: 15 extra credits per depth level on top of the turn fee, so the default depth of 3 adds 45 credits and makes a 50-credit build cost 95. This is the user's deliberate choice, so only switch it on when they have asked for the best possible deck and accepted the wait and the cost. Quote the turn FIRST (call without confirm) so the user sees the real total before approving. Set it once and it is remembered for the rest of the conversation; pass false to turn it off again. */
7154
7162
  advancedDeckBuilding?: boolean;
@@ -7453,10 +7461,10 @@ interface operations {
7453
7461
  */
7454
7462
  kind?: "deck";
7455
7463
  /**
7456
- * @description Output format. 'pptx' (default) = editable PowerPoint; 'pdf' = vector PDF; 'png' = one base64 image per slide; 'html' = the design's self-contained HTML.
7464
+ * @description Output format. 'pptx' (default) = editable PowerPoint; 'pdf' = vector PDF; 'png' = one image per slide. HTML is not available.
7457
7465
  * @enum {string}
7458
7466
  */
7459
- format?: "pptx" | "pdf" | "png" | "html";
7467
+ format?: "pptx" | "pdf" | "png";
7460
7468
  /** @description Optional brand kit id (reserved for future per-export theming; the design is already branded, so this is usually unnecessary). */
7461
7469
  brandKitId?: string;
7462
7470
  };
@@ -8574,6 +8582,10 @@ interface operations {
8574
8582
  align?: "left" | "center" | "right";
8575
8583
  /** @description Element id of an EXISTING embedded diagram to re-render and replace in place (keeps the element id + board position). Omit for a fresh insert. If the id is not on the board, a new element is created with it. */
8576
8584
  updateElementId?: string;
8585
+ /** @description Brand theming is ON BY DEFAULT: the board's effective BRAND KIT (colours only — typefaces are never injected) is baked into the diagram before it is rendered and its editable source stored (cascade: brandKitId override → project → workspace → org default → the built-in Stable Baseline theme). Set false to keep the library's stock styling. Themable types: mermaid, plantuml, graphviz, d2, systemsarchitecture, vega, vegalite, infographic; author theming in the DSL always wins. */
8586
+ applyBrandTheme?: boolean;
8587
+ /** @description Optional brand kit UUID (see listBrandKits) to theme with instead of the cascade default. Must belong to your organisation. */
8588
+ brandKitId?: string;
8577
8589
  /**
8578
8590
  * @description When 'contain' AND both width and height are given, treat width/height as a BOUNDING BOX: the diagram is scaled to its natural aspect ratio to fit inside the box (never upscaled past 1.5x natural) and centred, so it never stretches. The response's diagram.{x,y,width,height} carry the final drawn geometry. Omit for the exact width/height behaviour.
8579
8591
  * @enum {string}
@@ -9157,6 +9169,12 @@ interface operations {
9157
9169
  scale?: 1 | 2 | 3;
9158
9170
  /** @description Background for png/jpeg, e.g. '#ffffff' or 'transparent' (png only). */
9159
9171
  background?: string;
9172
+ /** @description Brand theming is ON BY DEFAULT: the effective BRAND KIT (colours only — typefaces are never injected) is baked into the diagram before rendering (cascade: brandKitId override → project default → workspace default → org default → the built-in Stable Baseline theme). Set false to render with the library's stock styling instead. Themable types: mermaid, plantuml, graphviz, d2, systemsarchitecture, vega, vegalite, infographic — other types always render unchanged. Author theming in the DSL wins (an existing mermaid %%{init}%%, plantuml !theme, d2 vars.d2-config, or a hand-written infographic palette is never overridden). */
9173
+ applyBrandTheme?: boolean;
9174
+ /** @description Optional brand kit UUID (see listBrandKits) to theme with instead of the cascade default. Must belong to your organisation. */
9175
+ brandKitId?: string;
9176
+ /** @description Optional project UUID used to resolve the project → workspace → org brand-kit cascade. Without it the built-in Stable Baseline brand themes the render. */
9177
+ projectId?: string;
9160
9178
  };
9161
9179
  };
9162
9180
  };
@@ -9799,7 +9817,7 @@ interface operations {
9799
9817
  width?: number;
9800
9818
  /** @description Height in pixels. */
9801
9819
  height?: number;
9802
- /** @description Insert after this line (0 = beginning, omit = end). */
9820
+ /** @description Insert after this line, counting the SAME line numbers getDocument prints (1-based; frontmatter is not counted, and every diagram/image marker counts as exactly one line). 0 inserts at the very beginning; omit it to append at the end. Re-read with getDocument if the document may have changed, since the number is positional. */
9803
9821
  afterLine?: number;
9804
9822
  /** @description Alt text. Defaults to caption. */
9805
9823
  alt?: string;
@@ -9991,6 +10009,8 @@ interface operations {
9991
10009
  "application/json": {
9992
10010
  /** @description Image ID from IMAGE_OMITTED markers. */
9993
10011
  imageId: string;
10012
+ /** @description Optional document optimistic-lock token; validated when provided. (Alias accepted: documentVersionTimestamp.) */
10013
+ versionTimestamp?: number;
9994
10014
  };
9995
10015
  };
9996
10016
  };
@@ -21262,7 +21282,7 @@ interface operations {
21262
21282
  logoUrl?: string;
21263
21283
  /** @description URL of an existing .pptx or .docx to extract the brand from (theme colours + fonts + logo + watermark + embedded fonts). Max 25MB. Omit if passing logoUrl or tokens. */
21264
21284
  officeUrl?: string;
21265
- /** @description Explicit DTCG brand tokens { color:{brand:{primary,primaryText,ink,bg,surface,muted,border,positive,warning,negative}}, font:{heading,body} }. Omit to extract from logoUrl/officeUrl. */
21285
+ /** @description Explicit DTCG brand tokens { color:{brand:{primary,primaryText,ink,bg,surface,muted,border,positive,warning,negative,accentHover?,accentActive?}}, font:{heading,body} }. EXTENDED CAPTURE (all optional; captured values replace derivation heuristics in deck/document theming): structure:{typeScalePx:[..], leadingBody, leadingTight, trackingDisplayEm, spacingPx:[..], radiusPx:{sm,md,lg}, elevation:'flat'|'ring'|'soft'|'raised'}, motion:{speed:'snappy'|'standard'|'stately', easing:'cubic-bezier(..)'}, voice:{tone, notes}, imagery:{style, notes}, antiPatterns:['never ..']. Omit tokens entirely to extract from logoUrl/officeUrl. */
21266
21286
  tokens?: {
21267
21287
  [key: string]: unknown;
21268
21288
  };
@@ -21439,8 +21459,8 @@ interface operations {
21439
21459
  content: {
21440
21460
  "application/json": {
21441
21461
  /** @enum {string} */
21442
- scope: "organization" | "workspace" | "project";
21443
- /** @description The org/workspace/project id for the chosen scope. */
21462
+ scope: "organization" | "workspace" | "project" | "folder" | "document";
21463
+ /** @description The org/workspace/project/folder/document id for the chosen scope. */
21444
21464
  scopeId: string;
21445
21465
  /** @description Brand kit to make default, or null to clear. */
21446
21466
  brandKitId?: string | null;
@@ -21531,6 +21551,7 @@ interface operations {
21531
21551
  compliance?: boolean;
21532
21552
  knowledge_graph?: boolean;
21533
21553
  documents?: boolean;
21554
+ meeting_scribe?: boolean;
21534
21555
  };
21535
21556
  };
21536
21557
  };
package/openapi.json CHANGED
@@ -3348,7 +3348,7 @@
3348
3348
  },
3349
3349
  "afterLine": {
3350
3350
  "type": "number",
3351
- "description": "Insert after this line number (1-based)."
3351
+ "description": "Insert after this line, counting the SAME line numbers getDocument prints (1-based; frontmatter is not counted, and every diagram/image marker counts as exactly one line). 0 inserts at the very beginning; omit it to append at the end. Re-read with getDocument if the document may have changed, since the number is positional."
3352
3352
  },
3353
3353
  "colorPlan": {
3354
3354
  "type": "object",
@@ -3391,6 +3391,14 @@
3391
3391
  "imageBackground": {
3392
3392
  "type": "string",
3393
3393
  "description": "Background for the returned png/jpeg (e.g. '#ffffff' or 'transparent')."
3394
+ },
3395
+ "applyBrandTheme": {
3396
+ "type": "boolean",
3397
+ "description": "Brand theming is ON BY DEFAULT: the document's effective BRAND KIT (colours only — typefaces are never injected) is baked into the diagram DSL before it is validated, rendered and stored, so the diagram is on-brand everywhere it appears (cascade: brandKitId override → project default → workspace default → org default → the built-in Stable Baseline theme). Set false to keep the library's stock styling. Themable types: mermaid, plantuml, graphviz, d2, systemsarchitecture, vega, vegalite, infographic — other types (incl. bpmn, which has colorPlan) are always stored unchanged. Author theming in the DSL wins (an existing mermaid %%{init}%%, plantuml !theme, d2 vars.d2-config, or a hand-written infographic palette is never overridden). The stored diagramCode is the THEMED source."
3398
+ },
3399
+ "brandKitId": {
3400
+ "type": "string",
3401
+ "description": "Optional brand kit UUID (see listBrandKits) to theme with instead of the cascade default. Must belong to your organisation."
3394
3402
  }
3395
3403
  },
3396
3404
  "required": [
@@ -3522,6 +3530,14 @@
3522
3530
  "type": "string",
3523
3531
  "description": "New caption."
3524
3532
  },
3533
+ "applyBrandTheme": {
3534
+ "type": "boolean",
3535
+ "description": "Brand theming is ON BY DEFAULT when diagramCode is provided: the document's effective BRAND KIT is baked into the new DSL before it is validated, rendered and stored. Set false to keep the library's stock styling. Same cascade + themable types + author-wins guards as insertDiagramInDocument. The stored diagramCode is the THEMED source."
3536
+ },
3537
+ "brandKitId": {
3538
+ "type": "string",
3539
+ "description": "Optional brand kit UUID (see listBrandKits) to theme with instead of the cascade default. Must belong to your organisation."
3540
+ },
3525
3541
  "colorPlan": {
3526
3542
  "type": "object",
3527
3543
  "description": "BPMN only. Updated color plan. Set to null to remove.",
@@ -4361,7 +4377,7 @@
4361
4377
  "/tools/designDeckInWhiteboard": {
4362
4378
  "post": {
4363
4379
  "summary": "designDeckInWhiteboard",
4364
- "description": "Create or refine a slide deck INSIDE an existing whiteboard by conversing with the AI design agent. Send a brief for a NEW deck, a change to an EXISTING one, or an answer to the agent's question. The agent builds a polished, on-brand deck and places it on the board; if the brief is ambiguous it asks ONE clarifying question (answer with the same sessionId). Returns immediately; poll getDeckReplyInWhiteboard for the result. Use for building or editing slide decks / presentations. WHITEBOARD IS REQUIRED: a deck always lives inside a whiteboard, so documentId (the whiteboard's id) is required. If you do NOT already have a whiteboard id, ASK THE USER which whiteboard they want the deck designed in — do NOT create a whiteboard automatically. Only call createWhiteboard first if the user explicitly asks for a brand-new board; otherwise use the id of the whiteboard they name. FIRST vs FOLLOW-UP: the first call (from nothing) builds; a follow-up call (an answer, a change, or a new instruction) passes the sessionId (or the deckId) plus the new message. kind:'deck' (default) is the premium on-brand HTML deck; kind:'express' builds the native, deterministic branded-executive deck directly on the whiteboard (faster, lower fidelity, one-shot, not conversational). COST + APPROVAL: a build costs 50 credits and an edit 10; a clarifying question is FREE. GENERATED IMAGES are extra and OFF by default: decks are type-only unless the user asks for visuals, in which case set imageCount (5 credits each, ceiling scales with slide count and plan tier, max 10) and the exact total is quoted before anything is charged — exactly that many images are produced, and the image surcharge auto-refunds if the build cannot deliver them. ADVANCED DECK BUILDING (optional, OFF by default): set advancedDeckBuilding:true to build the deck over several rounds of redraft and review by a panel of design, brand, accessibility and copy reviewers instead of one composer pass. It usually raises design quality, but it is not a guarantee. It is much slower and it costs more: a standard build takes roughly 2 to 8 minutes, advanced deck building takes roughly 15 to 20 minutes, and it adds 15 credits per depth level on top of the turn fee (advancedDeckBuildingDepth is 1 to 3, default 3, so +45 credits, making a 50-credit build cost 95). Only turn it on when the user asks for the highest quality and accepts the wait and the cost. Call FIRST without confirm to get the exact cost plus the workspace balance, show it to the user, and only call again with confirm:true once they agree. The fee is auto-refunded if a turn produces no change or fails. Returns sessionId (the conversation), deckId (the deck), status, turnType, started, awaitingUser, needsConfirmation, insufficientCredits, slideCount + slideCountClamped (the target the conversation now carries, and whether it was reduced to the maximum), advancedDeckBuilding (whether advanced deck building is on for this conversation), advancedDeckBuildingStatus, and assistantMessage. Export the finished deck with exportFromWhiteboard.",
4380
+ "description": "Create or refine a slide deck INSIDE an existing whiteboard by conversing with the AI design agent. Send a brief for a NEW deck, a change to an EXISTING one, or an answer to the agent's question. The agent builds a polished, on-brand deck and places it on the board; if the brief is ambiguous it asks ONE clarifying question (answer with the same sessionId). Returns immediately; poll getDeckReplyInWhiteboard for the result. Use for building or editing slide decks / presentations. WHITEBOARD IS REQUIRED: a deck always lives inside a whiteboard, so documentId (the whiteboard's id) is required. If you do NOT already have a whiteboard id, ASK THE USER which whiteboard they want the deck designed in — do NOT create a whiteboard automatically. Only call createWhiteboard first if the user explicitly asks for a brand-new board; otherwise use the id of the whiteboard they name. FIRST vs FOLLOW-UP: the first call (from nothing) builds; a follow-up call (an answer, a change, or a new instruction) passes the sessionId (or the deckId) plus the new message. kind:'deck' (default) is the premium on-brand HTML deck; kind:'express' builds the native, deterministic branded-executive deck directly on the whiteboard (faster, lower fidelity, one-shot, not conversational). COST + APPROVAL: a build costs 50 credits and an edit 10; a clarifying question is FREE. It can also generate imagery for the deck where the design calls for it. ADVANCED DECK BUILDING (optional, OFF by default): set advancedDeckBuilding:true to build the deck over several rounds of redraft and review by a panel of design, brand, accessibility and copy reviewers instead of one composer pass. It usually raises design quality, but it is not a guarantee. It is much slower and it costs more: a standard build takes roughly 2 to 8 minutes, advanced deck building takes roughly 15 to 20 minutes, and it adds 15 credits per depth level on top of the turn fee (advancedDeckBuildingDepth is 1 to 3, default 3, so +45 credits, making a 50-credit build cost 95). Only turn it on when the user asks for the highest quality and accepts the wait and the cost. Call FIRST without confirm to get the exact cost plus the workspace balance, show it to the user, and only call again with confirm:true once they agree. The fee is auto-refunded if a turn produces no change or fails. Returns sessionId (the conversation), deckId (the deck), status, turnType, started, awaitingUser, needsConfirmation, insufficientCredits, slideCount + slideCountClamped (the target the conversation now carries, and whether it was reduced to the maximum), advancedDeckBuilding (whether advanced deck building is on for this conversation), advancedDeckBuildingStatus, and assistantMessage. Export the finished deck with exportFromWhiteboard.",
4365
4381
  "operationId": "designDeckInWhiteboard",
4366
4382
  "tags": [
4367
4383
  "whiteboards"
@@ -4413,7 +4429,7 @@
4413
4429
  },
4414
4430
  "imageCount": {
4415
4431
  "type": "number",
4416
- "description": "How many AI-GENERATED images this turn may produce. DEFAULT IS 0 — decks are type-only unless the user asks for visuals. SET THIS when the user wants imagery: 'a cover image' → 1, 'a few images' → 2, 'image-led / very visual' → omit nothing and pass a higher number. Each image costs 5 extra credits, quoted upfront in the confirmation (base fee + images), and EXACTLY this many are produced — never more, never fewer (the image surcharge is auto-refunded if the build cannot deliver them). The ceiling scales with the deck (about one image per three slides, so a 30-slide deck tops out at 10) and with the plan tier; anything above the ceiling is reduced and the reduction is stated back. If omitted, the count is derived conservatively from the user's wording (silence = 0)."
4432
+ "description": "Deprecated and ignored. Still accepted so existing callers do not break; passing it changes nothing."
4417
4433
  },
4418
4434
  "advancedDeckBuilding": {
4419
4435
  "type": "boolean",
@@ -4808,7 +4824,7 @@
4808
4824
  "/tools/exportFromWhiteboard": {
4809
4825
  "post": {
4810
4826
  "summary": "exportFromWhiteboard",
4811
- "description": "Export a design that lives in a whiteboard to an editable PowerPoint (PPTX), PDF, PNG images, or raw HTML. Give it the whiteboard documentId and the designId (the deck). kind:'deck' (default) renders the finished deck via the export worker: 'pptx' = native, fully-editable PowerPoint (real shapes and text, not screenshots); 'pdf' = vector, one page per slide; 'png' = one image per slide (returned as a base64 array); 'html' = the self-contained deck HTML. Returns the file as base64 in data (pptx/pdf/html) or per-slide base64 in slides (png). The design must be finished; one that is still generating, failed, or archived returns a clear message.",
4827
+ "description": "Export a design that lives in a whiteboard to an editable PowerPoint (PPTX), a PDF, or PNG images. LARGE DECKS FINISH IN THE BACKGROUND: if the export takes longer than one tool call can wait, this returns status:'exporting' with a jobId instead of the file — wait about 30 seconds and call this tool AGAIN with the SAME arguments to collect it. Repeat until status is 'completed' and 'url' is present. Nothing is re-exported while a job is already running, so polling is cheap and safe. Download links are available for 1 hour. Give it the whiteboard documentId and the designId (the deck). kind:'deck' (default) renders the finished deck via the export worker: 'pptx' = native, fully-editable PowerPoint (real shapes and text, not screenshots); 'pdf' = vector, one page per slide; 'png' = one image per slide. HTML is not an available format — do not ask for it. Small exports come back as base64 in data (pptx/pdf); anything larger, and every png export, comes back as download links. The design must be finished; one that is still generating, failed, or archived returns a clear message.",
4812
4828
  "operationId": "exportFromWhiteboard",
4813
4829
  "tags": [
4814
4830
  "whiteboards"
@@ -4840,10 +4856,9 @@
4840
4856
  "enum": [
4841
4857
  "pptx",
4842
4858
  "pdf",
4843
- "png",
4844
- "html"
4859
+ "png"
4845
4860
  ],
4846
- "description": "Output format. 'pptx' (default) = editable PowerPoint; 'pdf' = vector PDF; 'png' = one base64 image per slide; 'html' = the design's self-contained HTML."
4861
+ "description": "Output format. 'pptx' (default) = editable PowerPoint; 'pdf' = vector PDF; 'png' = one image per slide. HTML is not available."
4847
4862
  },
4848
4863
  "brandKitId": {
4849
4864
  "type": "string",
@@ -6431,6 +6446,14 @@
6431
6446
  "type": "string",
6432
6447
  "description": "Element id of an EXISTING embedded diagram to re-render and replace in place (keeps the element id + board position). Omit for a fresh insert. If the id is not on the board, a new element is created with it."
6433
6448
  },
6449
+ "applyBrandTheme": {
6450
+ "type": "boolean",
6451
+ "description": "Brand theming is ON BY DEFAULT: the board's effective BRAND KIT (colours only — typefaces are never injected) is baked into the diagram before it is rendered and its editable source stored (cascade: brandKitId override → project → workspace → org default → the built-in Stable Baseline theme). Set false to keep the library's stock styling. Themable types: mermaid, plantuml, graphviz, d2, systemsarchitecture, vega, vegalite, infographic; author theming in the DSL always wins."
6452
+ },
6453
+ "brandKitId": {
6454
+ "type": "string",
6455
+ "description": "Optional brand kit UUID (see listBrandKits) to theme with instead of the cascade default. Must belong to your organisation."
6456
+ },
6434
6457
  "fit": {
6435
6458
  "type": "string",
6436
6459
  "enum": [
@@ -7186,7 +7209,7 @@
7186
7209
  "/tools/renderDiagram": {
7187
7210
  "post": {
7188
7211
  "summary": "renderDiagram",
7189
- "description": "Generate a diagram from its DSL/code and get the IMAGE back — WITHOUT inserting it into any document or whiteboard. For acting as a pure diagram generator. Provide diagramType (e.g. 'mermaid', 'd2', 'plantuml', 'graphviz', 'bpmn', 'vegalite'; call listDiagramTypes for the full set) and source (the diagram code). Choose format 'png' (default), 'jpeg', or 'svg'; for raster choose scale 1/2/3 for 1x/2x/3x; optional background (png only). Returns a TEMPORARY signed imageUrl that expires in 1 hour (then auto-deleted), and for png/jpeg the image inline so you can see it. To render a diagram that already lives in a document/whiteboard use getDiagramImage; to persist a new one use insertDiagramInDocument or insertWhiteboardDiagram.",
7212
+ "description": "Generate a diagram from its DSL/code and get the IMAGE back — WITHOUT inserting it into any document or whiteboard. For acting as a pure diagram generator. Provide diagramType (e.g. 'mermaid', 'd2', 'plantuml', 'graphviz', 'bpmn', 'vegalite'; call listDiagramTypes for the full set) and source (the diagram code). Choose format 'png' (default), 'jpeg', or 'svg'; for raster choose scale 1/2/3 for 1x/2x/3x; optional background (png only). Returns a TEMPORARY imageUrl that stays available for 1 hour (the render is then deleted), and for png/jpeg the image inline so you can see it. The link carries no signing token, so it survives being rendered as a citation. To render a diagram that already lives in a document/whiteboard use getDiagramImage; to persist a new one use insertDiagramInDocument or insertWhiteboardDiagram.",
7190
7213
  "operationId": "renderDiagram",
7191
7214
  "tags": [
7192
7215
  "diagrams"
@@ -7227,6 +7250,18 @@
7227
7250
  "background": {
7228
7251
  "type": "string",
7229
7252
  "description": "Background for png/jpeg, e.g. '#ffffff' or 'transparent' (png only)."
7253
+ },
7254
+ "applyBrandTheme": {
7255
+ "type": "boolean",
7256
+ "description": "Brand theming is ON BY DEFAULT: the effective BRAND KIT (colours only — typefaces are never injected) is baked into the diagram before rendering (cascade: brandKitId override → project default → workspace default → org default → the built-in Stable Baseline theme). Set false to render with the library's stock styling instead. Themable types: mermaid, plantuml, graphviz, d2, systemsarchitecture, vega, vegalite, infographic — other types always render unchanged. Author theming in the DSL wins (an existing mermaid %%{init}%%, plantuml !theme, d2 vars.d2-config, or a hand-written infographic palette is never overridden)."
7257
+ },
7258
+ "brandKitId": {
7259
+ "type": "string",
7260
+ "description": "Optional brand kit UUID (see listBrandKits) to theme with instead of the cascade default. Must belong to your organisation."
7261
+ },
7262
+ "projectId": {
7263
+ "type": "string",
7264
+ "description": "Optional project UUID used to resolve the project → workspace → org brand-kit cascade. Without it the built-in Stable Baseline brand themes the render."
7230
7265
  }
7231
7266
  },
7232
7267
  "required": [
@@ -7315,7 +7350,7 @@
7315
7350
  "/tools/getDiagramImage": {
7316
7351
  "post": {
7317
7352
  "summary": "getDiagramImage",
7318
- "description": "Render a diagram that ALREADY exists in a document to an IMAGE (svg/png/jpeg @1x/2x/3x) and return it — a temporary signed URL (expires in 1 hour) plus, for png/jpeg, the image inline so you can see it. Pass the diagramId (from getDocument's DIAGRAM markers or getDiagramInDocument). Reuses the diagram's cached server render when available (pixel-identical to the editor); when the diagram has no cached render yet, the fresh render is persisted back to the document (persistedRender:true in the response), so reading repairs unrendered diagrams. Use renderDiagram instead to generate from raw DSL without an existing diagram.",
7353
+ "description": "Render a diagram that ALREADY exists in a document to an IMAGE (svg/png/jpeg @1x/2x/3x) and return it — a temporary imageUrl available for 1 hour plus, for png/jpeg, the image inline so you can see it, and title/url citing the document the diagram lives in. Pass the diagramId (from getDocument's DIAGRAM markers or getDiagramInDocument). Reuses the diagram's cached server render when available (pixel-identical to the editor), otherwise renders from the diagram's source on the fly. Read-only: nothing in the document or the diagram is changed; the image is a temporary artefact that expires after 1 hour. Use renderDiagram instead to generate from raw DSL without an existing diagram.",
7319
7354
  "operationId": "getDiagramImage",
7320
7355
  "tags": [
7321
7356
  "diagrams"
@@ -8036,7 +8071,7 @@
8036
8071
  "/tools/insertImageInDocument": {
8037
8072
  "post": {
8038
8073
  "summary": "insertImageInDocument",
8039
- "description": "Insert an image into a document (max 10MB). Provide imageBase64, imageBinary, or imageUrl. For large files, call createImageUploadSession first then use the returned assetUrl.",
8074
+ "description": "Insert an image into a document (max 10MB). Provide imageBase64, imageBinary, or imageUrl. For large files, call createImageUploadSession first then use the returned assetUrl. nlDescription AND caption are both REQUIRED, not optional polish: they are what makes the image findable in search and what lets an agent decide whether this picture belongs on a slide or in an answer, since neither can see the pixels from a filename. Write them about what the image SHOWS.",
8040
8075
  "operationId": "insertImageInDocument",
8041
8076
  "tags": [
8042
8077
  "images"
@@ -8097,7 +8132,7 @@
8097
8132
  },
8098
8133
  "afterLine": {
8099
8134
  "type": "number",
8100
- "description": "Insert after this line (0 = beginning, omit = end)."
8135
+ "description": "Insert after this line, counting the SAME line numbers getDocument prints (1-based; frontmatter is not counted, and every diagram/image marker counts as exactly one line). 0 inserts at the very beginning; omit it to append at the end. Re-read with getDocument if the document may have changed, since the number is positional."
8101
8136
  },
8102
8137
  "alt": {
8103
8138
  "type": "string",
@@ -8200,7 +8235,7 @@
8200
8235
  "/tools/updateImageInDocument": {
8201
8236
  "post": {
8202
8237
  "summary": "updateImageInDocument",
8203
- "description": "Update image metadata (alt, caption, dimensions, alignment). Requires the document's versionTimestamp (from getDocument or any mutating tool's response) for optimistic locking.",
8238
+ "description": "Update image metadata (alt, caption, nlDescription, dimensions, alignment) — metadata only; to change the picture itself, delete it and insert the new one. Requires the document's versionTimestamp (from getDocument or any mutating tool's response) for optimistic locking.",
8204
8239
  "operationId": "updateImageInDocument",
8205
8240
  "tags": [
8206
8241
  "images"
@@ -8335,7 +8370,7 @@
8335
8370
  "/tools/deleteImageInDocument": {
8336
8371
  "post": {
8337
8372
  "summary": "deleteImageInDocument",
8338
- "description": "Delete an image from a document and storage.",
8373
+ "description": "Delete an image: removes the stored file, the database record, AND the image from the document body — both the IMAGE marker in the markdown and the image node in the document's rich-text content, so the picture stops appearing on every read. Deleting an image the document still references is the point of this tool; do not hand-edit the marker out with editDocument, which removes the reference but leaves the file and record behind.",
8339
8374
  "operationId": "deleteImageInDocument",
8340
8375
  "tags": [
8341
8376
  "images"
@@ -8350,6 +8385,10 @@
8350
8385
  "imageId": {
8351
8386
  "type": "string",
8352
8387
  "description": "Image ID from IMAGE_OMITTED markers."
8388
+ },
8389
+ "versionTimestamp": {
8390
+ "type": "number",
8391
+ "description": "Optional document optimistic-lock token; validated when provided. (Alias accepted: documentVersionTimestamp.)"
8353
8392
  }
8354
8393
  },
8355
8394
  "required": [
@@ -23556,7 +23595,7 @@
23556
23595
  },
23557
23596
  "tokens": {
23558
23597
  "type": "object",
23559
- "description": "Explicit DTCG brand tokens { color:{brand:{primary,primaryText,ink,bg,surface,muted,border,positive,warning,negative}}, font:{heading,body} }. Omit to extract from logoUrl/officeUrl.",
23598
+ "description": "Explicit DTCG brand tokens { color:{brand:{primary,primaryText,ink,bg,surface,muted,border,positive,warning,negative,accentHover?,accentActive?}}, font:{heading,body} }. EXTENDED CAPTURE (all optional; captured values replace derivation heuristics in deck/document theming): structure:{typeScalePx:[..], leadingBody, leadingTight, trackingDisplayEm, spacingPx:[..], radiusPx:{sm,md,lg}, elevation:'flat'|'ring'|'soft'|'raised'}, motion:{speed:'snappy'|'standard'|'stately', easing:'cubic-bezier(..)'}, voice:{tone, notes}, imagery:{style, notes}, antiPatterns:['never ..']. Omit tokens entirely to extract from logoUrl/officeUrl.",
23560
23599
  "additionalProperties": true
23561
23600
  },
23562
23601
  "guidance": {
@@ -23764,7 +23803,7 @@
23764
23803
  "/tools/setDefaultBrandKit": {
23765
23804
  "post": {
23766
23805
  "summary": "setDefaultBrandKit",
23767
- "description": "Set or clear the default BRAND KIT at a scope: organization, workspace, or project. Defaults cascade most-specific-first (a per-board/document override beats project beats workspace beats organization). Pass brandKitId:null to clear. Auth: org owner/admin.",
23806
+ "description": "Set or clear the default BRAND KIT at a scope: organization, workspace, project, folder, or document. Defaults cascade most-specific-first, lowest level up: document beats the nearest folder up the (nested) folder chain beats project beats workspace beats organization. Diagram brand theming, exports and decks all resolve through this cascade. Pass brandKitId:null to clear. Auth: org owner/admin.",
23768
23807
  "operationId": "setDefaultBrandKit",
23769
23808
  "tags": [
23770
23809
  "settings"
@@ -23781,12 +23820,14 @@
23781
23820
  "enum": [
23782
23821
  "organization",
23783
23822
  "workspace",
23784
- "project"
23823
+ "project",
23824
+ "folder",
23825
+ "document"
23785
23826
  ]
23786
23827
  },
23787
23828
  "scopeId": {
23788
23829
  "type": "string",
23789
- "description": "The org/workspace/project id for the chosen scope."
23830
+ "description": "The org/workspace/project/folder/document id for the chosen scope."
23790
23831
  },
23791
23832
  "brandKitId": {
23792
23833
  "type": [
@@ -23882,7 +23923,7 @@
23882
23923
  "/tools/updateOrgFeatureFlags": {
23883
23924
  "post": {
23884
23925
  "summary": "updateOrgFeatureFlags",
23885
- "description": "Toggle feature flags on settings.enabledFeatures (plans, improvements, compliance, knowledge_graph, documents). Auth: can_admin_org + org admin. Rate limit 30/min. Plan-tier gated: enabling knowledge_graph requires Pro/Enterprise.",
23926
+ "description": "Toggle organisation feature modules (plans, improvements, compliance, knowledge_graph, documents, meeting_scribe). Auth: can_admin_org + org admin. Rate limit 30/min. A flag can only be ENABLED when the feature is available to the organisation — included in its plan (knowledge_graph and compliance need Enterprise, meeting_scribe needs Pro or Enterprise) or granted by a platform administrator. Disabling is always allowed. Disabled modules hide their tools and app pages.",
23886
23927
  "operationId": "updateOrgFeatureFlags",
23887
23928
  "tags": [
23888
23929
  "settings"
@@ -23911,6 +23952,9 @@
23911
23952
  },
23912
23953
  "documents": {
23913
23954
  "type": "boolean"
23955
+ },
23956
+ "meeting_scribe": {
23957
+ "type": "boolean"
23914
23958
  }
23915
23959
  },
23916
23960
  "required": [
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@stablebaseline/sdk",
3
- "version": "0.6.0",
3
+ "version": "0.6.1",
4
4
  "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. 196 tools across 18 categories.",
5
5
  "homepage": "https://stablebaseline.io",
6
6
  "repository": {
@@ -60,7 +60,7 @@
60
60
  "openapi-typescript": "^7.5.0",
61
61
  "tsup": "^8.3.5",
62
62
  "typescript": "^5.6.3",
63
- "vitest": "^4.1.10"
63
+ "vitest": "^4.1.11"
64
64
  },
65
65
  "engines": {
66
66
  "node": ">=18"
@@ -695,7 +695,7 @@ export interface paths {
695
695
  put?: never;
696
696
  /**
697
697
  * designDeckInWhiteboard
698
- * @description Create or refine a slide deck INSIDE an existing whiteboard by conversing with the AI design agent. Send a brief for a NEW deck, a change to an EXISTING one, or an answer to the agent's question. The agent builds a polished, on-brand deck and places it on the board; if the brief is ambiguous it asks ONE clarifying question (answer with the same sessionId). Returns immediately; poll getDeckReplyInWhiteboard for the result. Use for building or editing slide decks / presentations. WHITEBOARD IS REQUIRED: a deck always lives inside a whiteboard, so documentId (the whiteboard's id) is required. If you do NOT already have a whiteboard id, ASK THE USER which whiteboard they want the deck designed in — do NOT create a whiteboard automatically. Only call createWhiteboard first if the user explicitly asks for a brand-new board; otherwise use the id of the whiteboard they name. FIRST vs FOLLOW-UP: the first call (from nothing) builds; a follow-up call (an answer, a change, or a new instruction) passes the sessionId (or the deckId) plus the new message. kind:'deck' (default) is the premium on-brand HTML deck; kind:'express' builds the native, deterministic branded-executive deck directly on the whiteboard (faster, lower fidelity, one-shot, not conversational). COST + APPROVAL: a build costs 50 credits and an edit 10; a clarifying question is FREE. GENERATED IMAGES are extra and OFF by default: decks are type-only unless the user asks for visuals, in which case set imageCount (5 credits each, ceiling scales with slide count and plan tier, max 10) and the exact total is quoted before anything is charged — exactly that many images are produced, and the image surcharge auto-refunds if the build cannot deliver them. ADVANCED DECK BUILDING (optional, OFF by default): set advancedDeckBuilding:true to build the deck over several rounds of redraft and review by a panel of design, brand, accessibility and copy reviewers instead of one composer pass. It usually raises design quality, but it is not a guarantee. It is much slower and it costs more: a standard build takes roughly 2 to 8 minutes, advanced deck building takes roughly 15 to 20 minutes, and it adds 15 credits per depth level on top of the turn fee (advancedDeckBuildingDepth is 1 to 3, default 3, so +45 credits, making a 50-credit build cost 95). Only turn it on when the user asks for the highest quality and accepts the wait and the cost. Call FIRST without confirm to get the exact cost plus the workspace balance, show it to the user, and only call again with confirm:true once they agree. The fee is auto-refunded if a turn produces no change or fails. Returns sessionId (the conversation), deckId (the deck), status, turnType, started, awaitingUser, needsConfirmation, insufficientCredits, slideCount + slideCountClamped (the target the conversation now carries, and whether it was reduced to the maximum), advancedDeckBuilding (whether advanced deck building is on for this conversation), advancedDeckBuildingStatus, and assistantMessage. Export the finished deck with exportFromWhiteboard.
698
+ * @description Create or refine a slide deck INSIDE an existing whiteboard by conversing with the AI design agent. Send a brief for a NEW deck, a change to an EXISTING one, or an answer to the agent's question. The agent builds a polished, on-brand deck and places it on the board; if the brief is ambiguous it asks ONE clarifying question (answer with the same sessionId). Returns immediately; poll getDeckReplyInWhiteboard for the result. Use for building or editing slide decks / presentations. WHITEBOARD IS REQUIRED: a deck always lives inside a whiteboard, so documentId (the whiteboard's id) is required. If you do NOT already have a whiteboard id, ASK THE USER which whiteboard they want the deck designed in — do NOT create a whiteboard automatically. Only call createWhiteboard first if the user explicitly asks for a brand-new board; otherwise use the id of the whiteboard they name. FIRST vs FOLLOW-UP: the first call (from nothing) builds; a follow-up call (an answer, a change, or a new instruction) passes the sessionId (or the deckId) plus the new message. kind:'deck' (default) is the premium on-brand HTML deck; kind:'express' builds the native, deterministic branded-executive deck directly on the whiteboard (faster, lower fidelity, one-shot, not conversational). COST + APPROVAL: a build costs 50 credits and an edit 10; a clarifying question is FREE. It can also generate imagery for the deck where the design calls for it. ADVANCED DECK BUILDING (optional, OFF by default): set advancedDeckBuilding:true to build the deck over several rounds of redraft and review by a panel of design, brand, accessibility and copy reviewers instead of one composer pass. It usually raises design quality, but it is not a guarantee. It is much slower and it costs more: a standard build takes roughly 2 to 8 minutes, advanced deck building takes roughly 15 to 20 minutes, and it adds 15 credits per depth level on top of the turn fee (advancedDeckBuildingDepth is 1 to 3, default 3, so +45 credits, making a 50-credit build cost 95). Only turn it on when the user asks for the highest quality and accepts the wait and the cost. Call FIRST without confirm to get the exact cost plus the workspace balance, show it to the user, and only call again with confirm:true once they agree. The fee is auto-refunded if a turn produces no change or fails. Returns sessionId (the conversation), deckId (the deck), status, turnType, started, awaitingUser, needsConfirmation, insufficientCredits, slideCount + slideCountClamped (the target the conversation now carries, and whether it was reduced to the maximum), advancedDeckBuilding (whether advanced deck building is on for this conversation), advancedDeckBuildingStatus, and assistantMessage. Export the finished deck with exportFromWhiteboard.
699
699
  */
700
700
  post: operations["designDeckInWhiteboard"];
701
701
  delete?: never;
@@ -755,7 +755,7 @@ export interface paths {
755
755
  put?: never;
756
756
  /**
757
757
  * exportFromWhiteboard
758
- * @description Export a design that lives in a whiteboard to an editable PowerPoint (PPTX), PDF, PNG images, or raw HTML. Give it the whiteboard documentId and the designId (the deck). kind:'deck' (default) renders the finished deck via the export worker: 'pptx' = native, fully-editable PowerPoint (real shapes and text, not screenshots); 'pdf' = vector, one page per slide; 'png' = one image per slide (returned as a base64 array); 'html' = the self-contained deck HTML. Returns the file as base64 in data (pptx/pdf/html) or per-slide base64 in slides (png). The design must be finished; one that is still generating, failed, or archived returns a clear message.
758
+ * @description Export a design that lives in a whiteboard to an editable PowerPoint (PPTX), a PDF, or PNG images. LARGE DECKS FINISH IN THE BACKGROUND: if the export takes longer than one tool call can wait, this returns status:'exporting' with a jobId instead of the file — wait about 30 seconds and call this tool AGAIN with the SAME arguments to collect it. Repeat until status is 'completed' and 'url' is present. Nothing is re-exported while a job is already running, so polling is cheap and safe. Download links are available for 1 hour. Give it the whiteboard documentId and the designId (the deck). kind:'deck' (default) renders the finished deck via the export worker: 'pptx' = native, fully-editable PowerPoint (real shapes and text, not screenshots); 'pdf' = vector, one page per slide; 'png' = one image per slide. HTML is not an available format — do not ask for it. Small exports come back as base64 in data (pptx/pdf); anything larger, and every png export, comes back as download links. The design must be finished; one that is still generating, failed, or archived returns a clear message.
759
759
  */
760
760
  post: operations["exportFromWhiteboard"];
761
761
  delete?: never;
@@ -1095,7 +1095,7 @@ export interface paths {
1095
1095
  put?: never;
1096
1096
  /**
1097
1097
  * renderDiagram
1098
- * @description Generate a diagram from its DSL/code and get the IMAGE back — WITHOUT inserting it into any document or whiteboard. For acting as a pure diagram generator. Provide diagramType (e.g. 'mermaid', 'd2', 'plantuml', 'graphviz', 'bpmn', 'vegalite'; call listDiagramTypes for the full set) and source (the diagram code). Choose format 'png' (default), 'jpeg', or 'svg'; for raster choose scale 1/2/3 for 1x/2x/3x; optional background (png only). Returns a TEMPORARY signed imageUrl that expires in 1 hour (then auto-deleted), and for png/jpeg the image inline so you can see it. To render a diagram that already lives in a document/whiteboard use getDiagramImage; to persist a new one use insertDiagramInDocument or insertWhiteboardDiagram.
1098
+ * @description Generate a diagram from its DSL/code and get the IMAGE back — WITHOUT inserting it into any document or whiteboard. For acting as a pure diagram generator. Provide diagramType (e.g. 'mermaid', 'd2', 'plantuml', 'graphviz', 'bpmn', 'vegalite'; call listDiagramTypes for the full set) and source (the diagram code). Choose format 'png' (default), 'jpeg', or 'svg'; for raster choose scale 1/2/3 for 1x/2x/3x; optional background (png only). Returns a TEMPORARY imageUrl that stays available for 1 hour (the render is then deleted), and for png/jpeg the image inline so you can see it. The link carries no signing token, so it survives being rendered as a citation. To render a diagram that already lives in a document/whiteboard use getDiagramImage; to persist a new one use insertDiagramInDocument or insertWhiteboardDiagram.
1099
1099
  */
1100
1100
  post: operations["renderDiagram"];
1101
1101
  delete?: never;
@@ -1115,7 +1115,7 @@ export interface paths {
1115
1115
  put?: never;
1116
1116
  /**
1117
1117
  * getDiagramImage
1118
- * @description Render a diagram that ALREADY exists in a document to an IMAGE (svg/png/jpeg @1x/2x/3x) and return it — a temporary signed URL (expires in 1 hour) plus, for png/jpeg, the image inline so you can see it. Pass the diagramId (from getDocument's DIAGRAM markers or getDiagramInDocument). Reuses the diagram's cached server render when available (pixel-identical to the editor); when the diagram has no cached render yet, the fresh render is persisted back to the document (persistedRender:true in the response), so reading repairs unrendered diagrams. Use renderDiagram instead to generate from raw DSL without an existing diagram.
1118
+ * @description Render a diagram that ALREADY exists in a document to an IMAGE (svg/png/jpeg @1x/2x/3x) and return it — a temporary imageUrl available for 1 hour plus, for png/jpeg, the image inline so you can see it, and title/url citing the document the diagram lives in. Pass the diagramId (from getDocument's DIAGRAM markers or getDiagramInDocument). Reuses the diagram's cached server render when available (pixel-identical to the editor), otherwise renders from the diagram's source on the fly. Read-only: nothing in the document or the diagram is changed; the image is a temporary artefact that expires after 1 hour. Use renderDiagram instead to generate from raw DSL without an existing diagram.
1119
1119
  */
1120
1120
  post: operations["getDiagramImage"];
1121
1121
  delete?: never;
@@ -1235,7 +1235,7 @@ export interface paths {
1235
1235
  put?: never;
1236
1236
  /**
1237
1237
  * insertImageInDocument
1238
- * @description Insert an image into a document (max 10MB). Provide imageBase64, imageBinary, or imageUrl. For large files, call createImageUploadSession first then use the returned assetUrl.
1238
+ * @description Insert an image into a document (max 10MB). Provide imageBase64, imageBinary, or imageUrl. For large files, call createImageUploadSession first then use the returned assetUrl. nlDescription AND caption are both REQUIRED, not optional polish: they are what makes the image findable in search and what lets an agent decide whether this picture belongs on a slide or in an answer, since neither can see the pixels from a filename. Write them about what the image SHOWS.
1239
1239
  */
1240
1240
  post: operations["insertImageInDocument"];
1241
1241
  delete?: never;
@@ -1255,7 +1255,7 @@ export interface paths {
1255
1255
  put?: never;
1256
1256
  /**
1257
1257
  * updateImageInDocument
1258
- * @description Update image metadata (alt, caption, dimensions, alignment). Requires the document's versionTimestamp (from getDocument or any mutating tool's response) for optimistic locking.
1258
+ * @description Update image metadata (alt, caption, nlDescription, dimensions, alignment) — metadata only; to change the picture itself, delete it and insert the new one. Requires the document's versionTimestamp (from getDocument or any mutating tool's response) for optimistic locking.
1259
1259
  */
1260
1260
  post: operations["updateImageInDocument"];
1261
1261
  delete?: never;
@@ -1275,7 +1275,7 @@ export interface paths {
1275
1275
  put?: never;
1276
1276
  /**
1277
1277
  * deleteImageInDocument
1278
- * @description Delete an image from a document and storage.
1278
+ * @description Delete an image: removes the stored file, the database record, AND the image from the document body — both the IMAGE marker in the markdown and the image node in the document's rich-text content, so the picture stops appearing on every read. Deleting an image the document still references is the point of this tool; do not hand-edit the marker out with editDocument, which removes the reference but leaves the file and record behind.
1279
1279
  */
1280
1280
  post: operations["deleteImageInDocument"];
1281
1281
  delete?: never;
@@ -3861,7 +3861,7 @@ export interface paths {
3861
3861
  put?: never;
3862
3862
  /**
3863
3863
  * setDefaultBrandKit
3864
- * @description Set or clear the default BRAND KIT at a scope: organization, workspace, or project. Defaults cascade most-specific-first (a per-board/document override beats project beats workspace beats organization). Pass brandKitId:null to clear. Auth: org owner/admin.
3864
+ * @description Set or clear the default BRAND KIT at a scope: organization, workspace, project, folder, or document. Defaults cascade most-specific-first, lowest level up: document beats the nearest folder up the (nested) folder chain beats project beats workspace beats organization. Diagram brand theming, exports and decks all resolve through this cascade. Pass brandKitId:null to clear. Auth: org owner/admin.
3865
3865
  */
3866
3866
  post: operations["setDefaultBrandKit"];
3867
3867
  delete?: never;
@@ -3881,7 +3881,7 @@ export interface paths {
3881
3881
  put?: never;
3882
3882
  /**
3883
3883
  * updateOrgFeatureFlags
3884
- * @description Toggle feature flags on settings.enabledFeatures (plans, improvements, compliance, knowledge_graph, documents). Auth: can_admin_org + org admin. Rate limit 30/min. Plan-tier gated: enabling knowledge_graph requires Pro/Enterprise.
3884
+ * @description Toggle organisation feature modules (plans, improvements, compliance, knowledge_graph, documents, meeting_scribe). Auth: can_admin_org + org admin. Rate limit 30/min. A flag can only be ENABLED when the feature is available to the organisation — included in its plan (knowledge_graph and compliance need Enterprise, meeting_scribe needs Pro or Enterprise) or granted by a platform administrator. Disabling is always allowed. Disabled modules hide their tools and app pages.
3885
3885
  */
3886
3886
  post: operations["updateOrgFeatureFlags"];
3887
3887
  delete?: never;
@@ -6367,7 +6367,7 @@ export interface operations {
6367
6367
  align?: "left" | "center" | "right";
6368
6368
  /** @description Caption below the diagram. */
6369
6369
  caption?: string;
6370
- /** @description Insert after this line number (1-based). */
6370
+ /** @description Insert after this line, counting the SAME line numbers getDocument prints (1-based; frontmatter is not counted, and every diagram/image marker counts as exactly one line). 0 inserts at the very beginning; omit it to append at the end. Re-read with getDocument if the document may have changed, since the number is positional. */
6371
6371
  afterLine?: number;
6372
6372
  /** @description BPMN only. Color plan: { byElementId: { ElementId: SwatchName } }. */
6373
6373
  colorPlan?: {
@@ -6390,6 +6390,10 @@ export interface operations {
6390
6390
  imageScale?: 1 | 2 | 3;
6391
6391
  /** @description Background for the returned png/jpeg (e.g. '#ffffff' or 'transparent'). */
6392
6392
  imageBackground?: string;
6393
+ /** @description Brand theming is ON BY DEFAULT: the document's effective BRAND KIT (colours only — typefaces are never injected) is baked into the diagram DSL before it is validated, rendered and stored, so the diagram is on-brand everywhere it appears (cascade: brandKitId override → project default → workspace default → org default → the built-in Stable Baseline theme). Set false to keep the library's stock styling. Themable types: mermaid, plantuml, graphviz, d2, systemsarchitecture, vega, vegalite, infographic — other types (incl. bpmn, which has colorPlan) are always stored unchanged. Author theming in the DSL wins (an existing mermaid %%{init}%%, plantuml !theme, d2 vars.d2-config, or a hand-written infographic palette is never overridden). The stored diagramCode is the THEMED source. */
6394
+ applyBrandTheme?: boolean;
6395
+ /** @description Optional brand kit UUID (see listBrandKits) to theme with instead of the cascade default. Must belong to your organisation. */
6396
+ brandKitId?: string;
6393
6397
  };
6394
6398
  };
6395
6399
  };
@@ -6486,6 +6490,10 @@ export interface operations {
6486
6490
  align?: "left" | "center" | "right";
6487
6491
  /** @description New caption. */
6488
6492
  caption?: string;
6493
+ /** @description Brand theming is ON BY DEFAULT when diagramCode is provided: the document's effective BRAND KIT is baked into the new DSL before it is validated, rendered and stored. Set false to keep the library's stock styling. Same cascade + themable types + author-wins guards as insertDiagramInDocument. The stored diagramCode is the THEMED source. */
6494
+ applyBrandTheme?: boolean;
6495
+ /** @description Optional brand kit UUID (see listBrandKits) to theme with instead of the cascade default. Must belong to your organisation. */
6496
+ brandKitId?: string;
6489
6497
  /** @description BPMN only. Updated color plan. Set to null to remove. */
6490
6498
  colorPlan?: {
6491
6499
  /** @description Map of element IDs to color swatch names. */
@@ -7149,7 +7157,7 @@ export interface operations {
7149
7157
  brandKitId?: string;
7150
7158
  /** @description The number of slides to build — a hard requirement: the deck is built with exactly this many slides. SET THIS whenever the user states or implies a count, EXACT OR APPROXIMATE: '12 slides' → 12, 'about 15' / '15 or so' → 15, 'no more than 10' → 10. Never expand the user's number: if they said 'about 15', pass 15 and shape the brief to fit 15 — outlining 19 sections in the message does not raise the count, it just fights this parameter. It is PERSISTED on the conversation, so send it ONCE (on the turn that states it) and every later build turn of the same conversation carries it automatically; send it again only to CHANGE the target. It is honoured on edit turns too ('cut it to 8 slides'). Anything above the 30-slide maximum is reduced to 30 and the reduction is stated back in the response. Omit ONLY when the user gave no count at all; the designer then chooses (typical 6 to 12). */
7151
7159
  slideCount?: number;
7152
- /** @description How many AI-GENERATED images this turn may produce. DEFAULT IS 0 — decks are type-only unless the user asks for visuals. SET THIS when the user wants imagery: 'a cover image' → 1, 'a few images' → 2, 'image-led / very visual' → omit nothing and pass a higher number. Each image costs 5 extra credits, quoted upfront in the confirmation (base fee + images), and EXACTLY this many are produced — never more, never fewer (the image surcharge is auto-refunded if the build cannot deliver them). The ceiling scales with the deck (about one image per three slides, so a 30-slide deck tops out at 10) and with the plan tier; anything above the ceiling is reduced and the reduction is stated back. If omitted, the count is derived conservatively from the user's wording (silence = 0). */
7160
+ /** @description Deprecated and ignored. Still accepted so existing callers do not break; passing it changes nothing. */
7153
7161
  imageCount?: number;
7154
7162
  /** @description Optional, OFF by default. Build the deck with ADVANCED DECK BUILDING: instead of one composer pass, the deck is redrafted and reviewed over several rounds by a panel of design, brand, accessibility and copy reviewers, each round scoring the deck and listing what must be fixed. It usually produces a higher-quality deck, but it is not a guarantee. TIME: a standard build takes roughly 2 to 8 minutes; advanced deck building takes roughly 15 to 20 minutes. COST: 15 extra credits per depth level on top of the turn fee, so the default depth of 3 adds 45 credits and makes a 50-credit build cost 95. This is the user's deliberate choice, so only switch it on when they have asked for the best possible deck and accepted the wait and the cost. Quote the turn FIRST (call without confirm) so the user sees the real total before approving. Set it once and it is remembered for the rest of the conversation; pass false to turn it off again. */
7155
7163
  advancedDeckBuilding?: boolean;
@@ -7454,10 +7462,10 @@ export interface operations {
7454
7462
  */
7455
7463
  kind?: "deck";
7456
7464
  /**
7457
- * @description Output format. 'pptx' (default) = editable PowerPoint; 'pdf' = vector PDF; 'png' = one base64 image per slide; 'html' = the design's self-contained HTML.
7465
+ * @description Output format. 'pptx' (default) = editable PowerPoint; 'pdf' = vector PDF; 'png' = one image per slide. HTML is not available.
7458
7466
  * @enum {string}
7459
7467
  */
7460
- format?: "pptx" | "pdf" | "png" | "html";
7468
+ format?: "pptx" | "pdf" | "png";
7461
7469
  /** @description Optional brand kit id (reserved for future per-export theming; the design is already branded, so this is usually unnecessary). */
7462
7470
  brandKitId?: string;
7463
7471
  };
@@ -8575,6 +8583,10 @@ export interface operations {
8575
8583
  align?: "left" | "center" | "right";
8576
8584
  /** @description Element id of an EXISTING embedded diagram to re-render and replace in place (keeps the element id + board position). Omit for a fresh insert. If the id is not on the board, a new element is created with it. */
8577
8585
  updateElementId?: string;
8586
+ /** @description Brand theming is ON BY DEFAULT: the board's effective BRAND KIT (colours only — typefaces are never injected) is baked into the diagram before it is rendered and its editable source stored (cascade: brandKitId override → project → workspace → org default → the built-in Stable Baseline theme). Set false to keep the library's stock styling. Themable types: mermaid, plantuml, graphviz, d2, systemsarchitecture, vega, vegalite, infographic; author theming in the DSL always wins. */
8587
+ applyBrandTheme?: boolean;
8588
+ /** @description Optional brand kit UUID (see listBrandKits) to theme with instead of the cascade default. Must belong to your organisation. */
8589
+ brandKitId?: string;
8578
8590
  /**
8579
8591
  * @description When 'contain' AND both width and height are given, treat width/height as a BOUNDING BOX: the diagram is scaled to its natural aspect ratio to fit inside the box (never upscaled past 1.5x natural) and centred, so it never stretches. The response's diagram.{x,y,width,height} carry the final drawn geometry. Omit for the exact width/height behaviour.
8580
8592
  * @enum {string}
@@ -9158,6 +9170,12 @@ export interface operations {
9158
9170
  scale?: 1 | 2 | 3;
9159
9171
  /** @description Background for png/jpeg, e.g. '#ffffff' or 'transparent' (png only). */
9160
9172
  background?: string;
9173
+ /** @description Brand theming is ON BY DEFAULT: the effective BRAND KIT (colours only — typefaces are never injected) is baked into the diagram before rendering (cascade: brandKitId override → project default → workspace default → org default → the built-in Stable Baseline theme). Set false to render with the library's stock styling instead. Themable types: mermaid, plantuml, graphviz, d2, systemsarchitecture, vega, vegalite, infographic — other types always render unchanged. Author theming in the DSL wins (an existing mermaid %%{init}%%, plantuml !theme, d2 vars.d2-config, or a hand-written infographic palette is never overridden). */
9174
+ applyBrandTheme?: boolean;
9175
+ /** @description Optional brand kit UUID (see listBrandKits) to theme with instead of the cascade default. Must belong to your organisation. */
9176
+ brandKitId?: string;
9177
+ /** @description Optional project UUID used to resolve the project → workspace → org brand-kit cascade. Without it the built-in Stable Baseline brand themes the render. */
9178
+ projectId?: string;
9161
9179
  };
9162
9180
  };
9163
9181
  };
@@ -9800,7 +9818,7 @@ export interface operations {
9800
9818
  width?: number;
9801
9819
  /** @description Height in pixels. */
9802
9820
  height?: number;
9803
- /** @description Insert after this line (0 = beginning, omit = end). */
9821
+ /** @description Insert after this line, counting the SAME line numbers getDocument prints (1-based; frontmatter is not counted, and every diagram/image marker counts as exactly one line). 0 inserts at the very beginning; omit it to append at the end. Re-read with getDocument if the document may have changed, since the number is positional. */
9804
9822
  afterLine?: number;
9805
9823
  /** @description Alt text. Defaults to caption. */
9806
9824
  alt?: string;
@@ -9992,6 +10010,8 @@ export interface operations {
9992
10010
  "application/json": {
9993
10011
  /** @description Image ID from IMAGE_OMITTED markers. */
9994
10012
  imageId: string;
10013
+ /** @description Optional document optimistic-lock token; validated when provided. (Alias accepted: documentVersionTimestamp.) */
10014
+ versionTimestamp?: number;
9995
10015
  };
9996
10016
  };
9997
10017
  };
@@ -21263,7 +21283,7 @@ export interface operations {
21263
21283
  logoUrl?: string;
21264
21284
  /** @description URL of an existing .pptx or .docx to extract the brand from (theme colours + fonts + logo + watermark + embedded fonts). Max 25MB. Omit if passing logoUrl or tokens. */
21265
21285
  officeUrl?: string;
21266
- /** @description Explicit DTCG brand tokens { color:{brand:{primary,primaryText,ink,bg,surface,muted,border,positive,warning,negative}}, font:{heading,body} }. Omit to extract from logoUrl/officeUrl. */
21286
+ /** @description Explicit DTCG brand tokens { color:{brand:{primary,primaryText,ink,bg,surface,muted,border,positive,warning,negative,accentHover?,accentActive?}}, font:{heading,body} }. EXTENDED CAPTURE (all optional; captured values replace derivation heuristics in deck/document theming): structure:{typeScalePx:[..], leadingBody, leadingTight, trackingDisplayEm, spacingPx:[..], radiusPx:{sm,md,lg}, elevation:'flat'|'ring'|'soft'|'raised'}, motion:{speed:'snappy'|'standard'|'stately', easing:'cubic-bezier(..)'}, voice:{tone, notes}, imagery:{style, notes}, antiPatterns:['never ..']. Omit tokens entirely to extract from logoUrl/officeUrl. */
21267
21287
  tokens?: {
21268
21288
  [key: string]: unknown;
21269
21289
  };
@@ -21440,8 +21460,8 @@ export interface operations {
21440
21460
  content: {
21441
21461
  "application/json": {
21442
21462
  /** @enum {string} */
21443
- scope: "organization" | "workspace" | "project";
21444
- /** @description The org/workspace/project id for the chosen scope. */
21463
+ scope: "organization" | "workspace" | "project" | "folder" | "document";
21464
+ /** @description The org/workspace/project/folder/document id for the chosen scope. */
21445
21465
  scopeId: string;
21446
21466
  /** @description Brand kit to make default, or null to clear. */
21447
21467
  brandKitId?: string | null;
@@ -21532,6 +21552,7 @@ export interface operations {
21532
21552
  compliance?: boolean;
21533
21553
  knowledge_graph?: boolean;
21534
21554
  documents?: boolean;
21555
+ meeting_scribe?: boolean;
21535
21556
  };
21536
21557
  };
21537
21558
  };