@stablebaseline/sdk 0.5.3 → 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 +66 -29
- package/dist/index.d.ts +66 -29
- package/openapi.json +106 -34
- package/package.json +2 -2
- package/src/types.generated.ts +66 -29
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.
|
|
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,
|
|
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;
|
|
@@ -854,7 +854,7 @@ interface paths {
|
|
|
854
854
|
put?: never;
|
|
855
855
|
/**
|
|
856
856
|
* listWhiteboards
|
|
857
|
-
* @description List the whiteboards in a project (hidden whiteboard-kind documents). Returns documentId, diagramId, title and timestamps for each.
|
|
857
|
+
* @description List AND grep the whiteboards in a project (hidden whiteboard-kind documents). `query` searches the title and friendlyId (substring by default; set isRegex:true for a regular expression, caseSensitive:true for exact case). This is the tool to find a board by name — listDocuments deliberately excludes whiteboards. Returns documentId, diagramId, title and timestamps for each.
|
|
858
858
|
*/
|
|
859
859
|
post: operations["listWhiteboards"];
|
|
860
860
|
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
|
|
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
|
|
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
|
|
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;
|
|
@@ -1674,11 +1674,11 @@ interface paths {
|
|
|
1674
1674
|
put?: never;
|
|
1675
1675
|
/**
|
|
1676
1676
|
* searchImprovements
|
|
1677
|
-
* @description
|
|
1677
|
+
* @description Ranked semantic search over IMPROVEMENTS AND TASKS — hybrid full-text + vector, so it matches meaning rather than just wording. Returns ranked { improvements }, each with a versionTimestamp you can pass straight to updateImprovement without a getImprovement round-trip.
|
|
1678
1678
|
*
|
|
1679
|
-
*
|
|
1679
|
+
* Improvements and tasks are one table (a task is an improvement with is_task=true), so both are searched by default. Pass types:["task"] or types:["improvement"] to narrow to one.
|
|
1680
1680
|
*
|
|
1681
|
-
*
|
|
1681
|
+
* This tool searches improvements and tasks ONLY. To find a document, whiteboard, plan or compliance item by name or friendly id, use kg_search({ query, artefactMetadataOnly: true }) — it matches title + friendly id + uuid across every artefact type and needs no knowledge graph. To search document CONTENT, use listDocuments.
|
|
1682
1682
|
*/
|
|
1683
1683
|
post: operations["searchImprovements"];
|
|
1684
1684
|
delete?: never;
|
|
@@ -2258,7 +2258,7 @@ interface paths {
|
|
|
2258
2258
|
put?: never;
|
|
2259
2259
|
/**
|
|
2260
2260
|
* kg_search
|
|
2261
|
-
* @description Unified Knowledge Graph KNOWLEDGE retrieval — facts, themes and relationships from INSIDE document CONTENT.
|
|
2261
|
+
* @description Unified Knowledge Graph KNOWLEDGE retrieval — facts, themes and relationships from INSIDE document CONTENT. To LOCATE AN ARTEFACT BY NAME OR ID rather than answer a question, pass artefactMetadataOnly:true — see below. Without that flag this tool retrieves knowledge from inside content and will not reliably find a thing by its title.
|
|
2262
2262
|
*
|
|
2263
2263
|
* PICK THE MODE THAT FITS THE QUERY:
|
|
2264
2264
|
*
|
|
@@ -2278,6 +2278,9 @@ interface paths {
|
|
|
2278
2278
|
* - User asks 'how is X connected to Y' → 'path' (with both entity IDs)
|
|
2279
2279
|
* - User asks 'what's near entity X' → 'graph' (with srcEntityId)
|
|
2280
2280
|
* - 'local' returned nothing useful and the question is broad → retry with 'ppr'
|
|
2281
|
+
* - User wants to FIND a named artefact ("the GTM plan", "DOC-123", a uuid) → artefactMetadataOnly:true
|
|
2282
|
+
*
|
|
2283
|
+
* ARTEFACT-METADATA MODE (artefactMetadataOnly:true): ignores `mode` entirely and matches title + friendly id + uuid across EVERY artefact type — documents, whiteboards, plans, tasks, improvements, compliance frameworks. Returns a typed navigable list ({ artefacts: [{ result_type, id, friendly_id, title, snippet, document_id, project_id, href }] }). It reads no document content and needs no knowledge graph: unlike every other mode it is NOT limited to what has been ingested, so it still finds artefacts in projects where the KG is switched off. Narrow it with artefactTypes. To search inside document BODIES use listDocuments (full-content grep).
|
|
2281
2284
|
*/
|
|
2282
2285
|
post: operations["kg_search"];
|
|
2283
2286
|
delete?: never;
|
|
@@ -3857,7 +3860,7 @@ interface paths {
|
|
|
3857
3860
|
put?: never;
|
|
3858
3861
|
/**
|
|
3859
3862
|
* setDefaultBrandKit
|
|
3860
|
-
* @description Set or clear the default BRAND KIT at a scope: organization, workspace, or
|
|
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.
|
|
3861
3864
|
*/
|
|
3862
3865
|
post: operations["setDefaultBrandKit"];
|
|
3863
3866
|
delete?: never;
|
|
@@ -3877,7 +3880,7 @@ interface paths {
|
|
|
3877
3880
|
put?: never;
|
|
3878
3881
|
/**
|
|
3879
3882
|
* updateOrgFeatureFlags
|
|
3880
|
-
* @description Toggle feature
|
|
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.
|
|
3881
3884
|
*/
|
|
3882
3885
|
post: operations["updateOrgFeatureFlags"];
|
|
3883
3886
|
delete?: never;
|
|
@@ -6363,7 +6366,7 @@ interface operations {
|
|
|
6363
6366
|
align?: "left" | "center" | "right";
|
|
6364
6367
|
/** @description Caption below the diagram. */
|
|
6365
6368
|
caption?: string;
|
|
6366
|
-
/** @description Insert after this line
|
|
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. */
|
|
6367
6370
|
afterLine?: number;
|
|
6368
6371
|
/** @description BPMN only. Color plan: { byElementId: { ElementId: SwatchName } }. */
|
|
6369
6372
|
colorPlan?: {
|
|
@@ -6386,6 +6389,10 @@ interface operations {
|
|
|
6386
6389
|
imageScale?: 1 | 2 | 3;
|
|
6387
6390
|
/** @description Background for the returned png/jpeg (e.g. '#ffffff' or 'transparent'). */
|
|
6388
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;
|
|
6389
6396
|
};
|
|
6390
6397
|
};
|
|
6391
6398
|
};
|
|
@@ -6482,6 +6489,10 @@ interface operations {
|
|
|
6482
6489
|
align?: "left" | "center" | "right";
|
|
6483
6490
|
/** @description New caption. */
|
|
6484
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;
|
|
6485
6496
|
/** @description BPMN only. Updated color plan. Set to null to remove. */
|
|
6486
6497
|
colorPlan?: {
|
|
6487
6498
|
/** @description Map of element IDs to color swatch names. */
|
|
@@ -7145,7 +7156,7 @@ interface operations {
|
|
|
7145
7156
|
brandKitId?: string;
|
|
7146
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). */
|
|
7147
7158
|
slideCount?: number;
|
|
7148
|
-
/** @description
|
|
7159
|
+
/** @description Deprecated and ignored. Still accepted so existing callers do not break; passing it changes nothing. */
|
|
7149
7160
|
imageCount?: number;
|
|
7150
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. */
|
|
7151
7162
|
advancedDeckBuilding?: boolean;
|
|
@@ -7450,10 +7461,10 @@ interface operations {
|
|
|
7450
7461
|
*/
|
|
7451
7462
|
kind?: "deck";
|
|
7452
7463
|
/**
|
|
7453
|
-
* @description Output format. 'pptx' (default) = editable PowerPoint; 'pdf' = vector PDF; 'png' = one
|
|
7464
|
+
* @description Output format. 'pptx' (default) = editable PowerPoint; 'pdf' = vector PDF; 'png' = one image per slide. HTML is not available.
|
|
7454
7465
|
* @enum {string}
|
|
7455
7466
|
*/
|
|
7456
|
-
format?: "pptx" | "pdf" | "png"
|
|
7467
|
+
format?: "pptx" | "pdf" | "png";
|
|
7457
7468
|
/** @description Optional brand kit id (reserved for future per-export theming; the design is already branded, so this is usually unnecessary). */
|
|
7458
7469
|
brandKitId?: string;
|
|
7459
7470
|
};
|
|
@@ -7893,6 +7904,12 @@ interface operations {
|
|
|
7893
7904
|
content: {
|
|
7894
7905
|
"application/json": {
|
|
7895
7906
|
projectId: string;
|
|
7907
|
+
/** @description Grep across title and friendlyId. Substring by default; a regular expression when isRegex is true. */
|
|
7908
|
+
query?: string;
|
|
7909
|
+
/** @description Treat `query` as a regular expression. */
|
|
7910
|
+
isRegex?: boolean;
|
|
7911
|
+
/** @description Match case exactly. Default false. */
|
|
7912
|
+
caseSensitive?: boolean;
|
|
7896
7913
|
};
|
|
7897
7914
|
};
|
|
7898
7915
|
};
|
|
@@ -8565,6 +8582,10 @@ interface operations {
|
|
|
8565
8582
|
align?: "left" | "center" | "right";
|
|
8566
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. */
|
|
8567
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;
|
|
8568
8589
|
/**
|
|
8569
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.
|
|
8570
8591
|
* @enum {string}
|
|
@@ -9148,6 +9169,12 @@ interface operations {
|
|
|
9148
9169
|
scale?: 1 | 2 | 3;
|
|
9149
9170
|
/** @description Background for png/jpeg, e.g. '#ffffff' or 'transparent' (png only). */
|
|
9150
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;
|
|
9151
9178
|
};
|
|
9152
9179
|
};
|
|
9153
9180
|
};
|
|
@@ -9790,7 +9817,7 @@ interface operations {
|
|
|
9790
9817
|
width?: number;
|
|
9791
9818
|
/** @description Height in pixels. */
|
|
9792
9819
|
height?: number;
|
|
9793
|
-
/** @description Insert after this line (0
|
|
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. */
|
|
9794
9821
|
afterLine?: number;
|
|
9795
9822
|
/** @description Alt text. Defaults to caption. */
|
|
9796
9823
|
alt?: string;
|
|
@@ -9982,6 +10009,8 @@ interface operations {
|
|
|
9982
10009
|
"application/json": {
|
|
9983
10010
|
/** @description Image ID from IMAGE_OMITTED markers. */
|
|
9984
10011
|
imageId: string;
|
|
10012
|
+
/** @description Optional document optimistic-lock token; validated when provided. (Alias accepted: documentVersionTimestamp.) */
|
|
10013
|
+
versionTimestamp?: number;
|
|
9985
10014
|
};
|
|
9986
10015
|
};
|
|
9987
10016
|
};
|
|
@@ -11942,18 +11971,16 @@ interface operations {
|
|
|
11942
11971
|
requestBody?: {
|
|
11943
11972
|
content: {
|
|
11944
11973
|
"application/json": {
|
|
11945
|
-
/** @description Search query — a name fragment or a friendly id. */
|
|
11974
|
+
/** @description Search query — meaning, a name fragment, or a friendly id (e.g. "IMP-2", "TAS-7"). */
|
|
11946
11975
|
query: string;
|
|
11947
|
-
/** @description
|
|
11948
|
-
types?: ("
|
|
11976
|
+
/** @description Narrow to one kind. Omit (or pass both) to search improvements and tasks together. Other artefact types are NOT accepted here — use kg_search with artefactMetadataOnly:true for those. */
|
|
11977
|
+
types?: ("improvement" | "task")[];
|
|
11949
11978
|
/** @description Limit to a project. */
|
|
11950
11979
|
projectId?: string;
|
|
11951
11980
|
/** @description Limit to a workspace. */
|
|
11952
11981
|
workspaceId?: string;
|
|
11953
|
-
/** @description Max results (default 20
|
|
11982
|
+
/** @description Max results (default 20, max 50). */
|
|
11954
11983
|
limit?: number;
|
|
11955
|
-
/** @description Pagination offset (cross-artefact mode). */
|
|
11956
|
-
offset?: number;
|
|
11957
11984
|
};
|
|
11958
11985
|
};
|
|
11959
11986
|
};
|
|
@@ -14714,8 +14741,17 @@ interface operations {
|
|
|
14714
14741
|
requestBody?: {
|
|
14715
14742
|
content: {
|
|
14716
14743
|
"application/json": {
|
|
14717
|
-
/** @description Natural-language query. Required for local/global/ppr; optional for graph (use srcEntityId instead). */
|
|
14744
|
+
/** @description Natural-language query. Required for local/global/ppr; optional for graph (use srcEntityId instead). With artefactMetadataOnly:true this is the artefact name, friendly id or uuid to find. */
|
|
14718
14745
|
query?: string;
|
|
14746
|
+
/**
|
|
14747
|
+
* @description Find artefacts BY NAME/ID instead of retrieving knowledge. Matches title + friendly id + uuid only — never document content — across all artefact types, and does not require the knowledge graph to be enabled. Default false.
|
|
14748
|
+
* @default false
|
|
14749
|
+
*/
|
|
14750
|
+
artefactMetadataOnly?: boolean;
|
|
14751
|
+
/** @description Only with artefactMetadataOnly:true. Restrict the search to these artefact types. Omit to search all of them. Unknown values are rejected rather than ignored. */
|
|
14752
|
+
artefactTypes?: ("document" | "whiteboard" | "improvement" | "task" | "plan" | "compliance")[];
|
|
14753
|
+
/** @description Only with artefactMetadataOnly:true. Skip this many results for paging. */
|
|
14754
|
+
offset?: number;
|
|
14719
14755
|
/**
|
|
14720
14756
|
* @description Retrieval strategy. See tool description for when to use each — strongly prefer 'global' for thematic/overview questions.
|
|
14721
14757
|
* @default local
|
|
@@ -21246,7 +21282,7 @@ interface operations {
|
|
|
21246
21282
|
logoUrl?: string;
|
|
21247
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. */
|
|
21248
21284
|
officeUrl?: string;
|
|
21249
|
-
/** @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. */
|
|
21250
21286
|
tokens?: {
|
|
21251
21287
|
[key: string]: unknown;
|
|
21252
21288
|
};
|
|
@@ -21423,8 +21459,8 @@ interface operations {
|
|
|
21423
21459
|
content: {
|
|
21424
21460
|
"application/json": {
|
|
21425
21461
|
/** @enum {string} */
|
|
21426
|
-
scope: "organization" | "workspace" | "project";
|
|
21427
|
-
/** @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. */
|
|
21428
21464
|
scopeId: string;
|
|
21429
21465
|
/** @description Brand kit to make default, or null to clear. */
|
|
21430
21466
|
brandKitId?: string | null;
|
|
@@ -21515,6 +21551,7 @@ interface operations {
|
|
|
21515
21551
|
compliance?: boolean;
|
|
21516
21552
|
knowledge_graph?: boolean;
|
|
21517
21553
|
documents?: boolean;
|
|
21554
|
+
meeting_scribe?: boolean;
|
|
21518
21555
|
};
|
|
21519
21556
|
};
|
|
21520
21557
|
};
|