@stablebaseline/sdk 0.5.0 → 0.5.2
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 +634 -56
- package/dist/index.d.ts +634 -56
- package/openapi.json +947 -82
- package/package.json +2 -2
- package/src/types.generated.ts +634 -56
package/src/types.generated.ts
CHANGED
|
@@ -35,7 +35,7 @@ export interface paths {
|
|
|
35
35
|
put?: never;
|
|
36
36
|
/**
|
|
37
37
|
* listDiagramTypes
|
|
38
|
-
* @description List supported diagram types. Use the returned `type` field
|
|
38
|
+
* @description List supported diagram types. Pass `query` to search by name OR intent (keyword + semantic): e.g. 'circuit diagram', 'wiring harness', 'timing waveform', 'network topology', 'database schema'. Use the returned `type` field with getDiagramTypeGuide (DSL instructions + example) and insertDiagramInDocument / renderDiagram.
|
|
39
39
|
*/
|
|
40
40
|
post: operations["listDiagramTypes"];
|
|
41
41
|
delete?: never;
|
|
@@ -235,7 +235,7 @@ export interface paths {
|
|
|
235
235
|
put?: never;
|
|
236
236
|
/**
|
|
237
237
|
* listWorkspaces
|
|
238
|
-
* @description List workspaces you have access to. Supports query filtering by name/slug.
|
|
238
|
+
* @description List workspaces you have access to. Scope to one organisation with organisationId (a structural filter — use it rather than `query`, which only searches names/slugs). Supports query filtering by name/slug.
|
|
239
239
|
*/
|
|
240
240
|
post: operations["listWorkspaces"];
|
|
241
241
|
delete?: never;
|
|
@@ -375,7 +375,7 @@ export interface paths {
|
|
|
375
375
|
put?: never;
|
|
376
376
|
/**
|
|
377
377
|
* listDocuments
|
|
378
|
-
* @description List AND grep documents in a project, workspace, or folder. `query` does a full-content search across each document's body (not just the title) and returns the matching lines — like grep across your docs. Each returned document includes `contentMatches: [{line, text, context?}]` and `matchCount`; the `text` is anchor-ready (paste it straight into editDocument's oldText). Use isRegex:true for regular-expression search (e.g. "TODO\(.*\)", "ACME-\d+"), caseSensitive for exact case, and contextLines for surrounding lines (grep -C). versionTimestamp is returned per document so you can edit straight from the results without a getDocument round-trip. Also supports date filtering.
|
|
378
|
+
* @description List AND grep documents in a project, workspace, or folder. `query` does a full-content search across each document's body (not just the title) and returns the matching lines — like grep across your docs. Each returned document includes `contentMatches: [{line, text, context?}]` and `matchCount`; the `text` is anchor-ready (paste it straight into editDocument's oldText). Use isRegex:true for regular-expression search (e.g. "TODO\(.*\)", "ACME-\d+"), caseSensitive for exact case, and contextLines for surrounding lines (grep -C). versionTimestamp is returned per document so you can edit straight from the results without a getDocument round-trip. Also supports date filtering. SCOPE HONESTY — read this before concluding something is absent: only documents that actually matched are returned (a document is never listed with matchCount 0 just because it was in scope), and the `grep` block reports `scannedDocuments` against `totalDocumentsInScope`. When `truncated` is true the search covered only part of the scope, so an absence is NOT proof; repeat with `scanOffset` set to the returned `nextScanOffset` until that field is gone, and union the results. A document too large to read is returned with `contentSearchSkipped: true` and NO matchCount, because its body was never searched.
|
|
379
379
|
*/
|
|
380
380
|
post: operations["listDocuments"];
|
|
381
381
|
delete?: never;
|
|
@@ -415,7 +415,7 @@ export interface paths {
|
|
|
415
415
|
put?: never;
|
|
416
416
|
/**
|
|
417
417
|
* getFolderHierarchy
|
|
418
|
-
* @description Get the folder and document tree
|
|
418
|
+
* @description Get the folder and document tree. Pass folderId for the subtree under one folder, or projectId for the project's ENTIRE folder tree from the root (no need to reassemble listFolders' flat list by parentId). Alias for getProjectHierarchy.
|
|
419
419
|
*/
|
|
420
420
|
post: operations["getFolderHierarchy"];
|
|
421
421
|
delete?: never;
|
|
@@ -435,7 +435,7 @@ export interface paths {
|
|
|
435
435
|
put?: never;
|
|
436
436
|
/**
|
|
437
437
|
* getDocument
|
|
438
|
-
* @description Read a document's content with line numbers.
|
|
438
|
+
* @description Read a document's content with line numbers. content.text lines are formatted `NNNNN<TAB>content` (cat -n style); the number+tab prefix is DISPLAY ONLY — never part of the document — so when building editDocument anchor patches, copy only the text AFTER the tab. Reads paginate by lines (offset/limit, default 200): use content.totalLines and content.nextOffset to page. document.versionTimestamp is the optimistic-lock token that every mutating document tool accepts (as versionTimestamp; the older documentVersionTimestamp name also works) — and every mutating tool returns a fresh token, so you rarely need to re-read just to keep editing. Diagrams/images appear as OMITTED markers with metadata (type, diagramId, renderStatus, nlDescription) — use getDiagramInDocument(diagramId) for full DSL code, or pass includeDiagramDsl:true to inline each diagram's DSL and versionTimestamp directly into its DIAGRAM_OMITTED marker (saves a getDiagramInDocument call when you intend to read or edit diagrams).
|
|
439
439
|
*/
|
|
440
440
|
post: operations["getDocument"];
|
|
441
441
|
delete?: never;
|
|
@@ -455,7 +455,7 @@ export interface paths {
|
|
|
455
455
|
put?: never;
|
|
456
456
|
/**
|
|
457
457
|
* createDocument
|
|
458
|
-
* @description Create a document from CDMD markdown
|
|
458
|
+
* @description Create a document from CDMD markdown (standard Markdown plus SB extensions — call getCdmdLanguageGuide if unfamiliar). The body goes in `cdmd` (`content` is accepted as an alias). A leading `---` YAML frontmatter block is stored and preserved: title/exported_at/generator are managed by the platform, and any other key you set (doc_type, authority_state, owner, conforms_to, …) round-trips untouched through reads and later edits. Do not include DIAGRAM/IMAGE markers — insert them after with dedicated tools. Returns the new document's id and versionTimestamp (the optimistic-lock token for subsequent edits). Supports @-mentioning people: embed `<!-- REFERENCE: {"type":"user","id":"<user_uuid>","label":"Name"} -->` to notify a teammate. Use listAssignablePrincipals to look up the user_id from a name; mentions of users outside the project are silently dropped.
|
|
459
459
|
*/
|
|
460
460
|
post: operations["createDocument"];
|
|
461
461
|
delete?: never;
|
|
@@ -475,7 +475,7 @@ export interface paths {
|
|
|
475
475
|
put?: never;
|
|
476
476
|
/**
|
|
477
477
|
* editDocument
|
|
478
|
-
* @description Edit a document: the PREFERRED tool for small targeted changes. Two patch dialects — do NOT mix them in one call. (1) ANCHOR patches {oldText, newText, before?, after?} — RECOMMENDED: replace an exact snippet of existing text with new text. oldText must match the document byte-for-byte AND be unique; if it occurs more than once, either expand oldText until it is unique, or add `before`/`after` (the EXACT text immediately before/after the match) to disambiguate. A no-match returns nearby context; an ambiguous match returns the occurrence count. Anchors do NOT drift, so you don't need fresh line numbers and they survive concurrent edits. Use newText:"" to delete. (2) LINE patches {startLine, endLine, replacement} — 1-based and INCLUSIVE: call getDocument first for line numbers; replace line 5 with {startLine:5,endLine:5}; INSERT before line N (deleting nothing) with {startLine:N,endLine:N-1}; append to an L-line document with {startLine:L+1,endLine:L}. Line numbers are ABSOLUTE and GO STALE after ANY edit — re-call getDocument before further line patches; out-of-range patches are rejected with the current line count. versionTimestamp from getDocument is required for optimistic locking, EXCEPT when dryRun:true. Set dryRun:true to apply the patches and get the resulting text back WITHOUT saving (verify before committing — kills retry loops). Do not edit or delete DIAGRAM/IMAGE marker lines (rejected with guidance) — use dedicated diagram/image tools. To @-mention a person, insert `<!-- REFERENCE: {"type":"user","id":"<user_uuid>","label":"Name"} -->`; look up the user_id via listAssignablePrincipals. Mentioned users are notified automatically.
|
|
478
|
+
* @description Edit a document: the PREFERRED tool for small targeted changes. Two patch dialects — do NOT mix them in one call. (1) ANCHOR patches {oldText, newText, before?, after?} — RECOMMENDED: replace an exact snippet of existing text with new text. oldText must match the document byte-for-byte AND be unique; if it occurs more than once, either expand oldText until it is unique, or add `before`/`after` (the EXACT text immediately before/after the match) to disambiguate. A no-match returns nearby context; an ambiguous match returns the occurrence count. Anchors do NOT drift, so you don't need fresh line numbers and they survive concurrent edits. Use newText:"" to delete. (2) LINE patches {startLine, endLine, replacement} — 1-based and INCLUSIVE: call getDocument first for line numbers; replace line 5 with {startLine:5,endLine:5}; INSERT before line N (deleting nothing) with {startLine:N,endLine:N-1}; append to an L-line document with {startLine:L+1,endLine:L}. Line numbers are ABSOLUTE and GO STALE after ANY edit — re-call getDocument before further line patches; out-of-range patches are rejected with the current line count. versionTimestamp from getDocument (or from any mutating tool's response — they all return the fresh token) is required for optimistic locking, EXCEPT when dryRun:true. If your token is stale, the error tells you who changed the document, when, and the currentVersionTimestamp — anchor patches survive concurrent edits, so retrying with that token is usually safe. Set dryRun:true to apply the patches and get the resulting text back WITHOUT saving (verify before committing — kills retry loops). IMPORTANT: getDocument displays lines as `NNNNN<TAB>content`; that prefix is display-only — oldText/before/after must contain only the content AFTER the tab. Do not edit or delete DIAGRAM/IMAGE marker lines (rejected with guidance) — use dedicated diagram/image tools. To @-mention a person, insert `<!-- REFERENCE: {"type":"user","id":"<user_uuid>","label":"Name"} -->`; look up the user_id via listAssignablePrincipals. Mentioned users are notified automatically.
|
|
479
479
|
*/
|
|
480
480
|
post: operations["editDocument"];
|
|
481
481
|
delete?: never;
|
|
@@ -495,7 +495,7 @@ export interface paths {
|
|
|
495
495
|
put?: never;
|
|
496
496
|
/**
|
|
497
497
|
* findAndReplaceTextInDocument
|
|
498
|
-
* @description Find and replace EXACT substrings in a document (NOT regex: wildcards and patterns are matched literally). Replaces EVERY occurrence and returns the replacement count; best for renames and repeated phrases. For a single targeted change at a known location, prefer editDocument (
|
|
498
|
+
* @description Find and replace EXACT substrings in a document (NOT regex: wildcards and patterns are matched literally). Replaces EVERY occurrence and returns the replacement count; best for renames and repeated phrases. For a single targeted change at a known location, prefer editDocument (anchor patches). Case-sensitive by default. Diagrams/images are automatically protected — only document text is affected. Returns document.versionTimestamp (the fresh optimistic-lock token) like every other mutating tool, so you can chain straight into editDocument or the diagram tools. Pass versionTimestamp to opt into optimistic locking (optional here — whole-document find/replace is position-independent). Note: when the `replace` value contains a `<!-- REFERENCE: {...} -->` marker (e.g. inserting a user mention), it round-trips losslessly through the editor and triggers notifications if it adds a new user mention.
|
|
499
499
|
*/
|
|
500
500
|
post: operations["findAndReplaceTextInDocument"];
|
|
501
501
|
delete?: never;
|
|
@@ -515,7 +515,7 @@ export interface paths {
|
|
|
515
515
|
put?: never;
|
|
516
516
|
/**
|
|
517
517
|
* getDiagramInDocument
|
|
518
|
-
* @description Get a diagram's full details including raw DSL source code. Use diagramId from DIAGRAM_OMITTED markers in getDocument output. Returns diagramCode, type, name, nlDescription, and versionTimestamp.
|
|
518
|
+
* @description Get a diagram's full details including raw DSL source code. Use diagramId from DIAGRAM_OMITTED markers in getDocument output. Returns diagramCode, type, name, nlDescription, renderStatus/renderError, and versionTimestamp — the diagram's optimistic-lock token for updateDiagramInDocument (every diagram write also returns it fresh).
|
|
519
519
|
*/
|
|
520
520
|
post: operations["getDiagramInDocument"];
|
|
521
521
|
delete?: never;
|
|
@@ -535,7 +535,7 @@ export interface paths {
|
|
|
535
535
|
put?: never;
|
|
536
536
|
/**
|
|
537
537
|
* insertDiagramInDocument
|
|
538
|
-
* @description Insert a new diagram into a document. Call listDiagramTypes to find your type, then getDiagramTypeGuide for DSL syntax before writing diagramCode.
|
|
538
|
+
* @description Insert a new diagram into a document. Call listDiagramTypes to find your type, then getDiagramTypeGuide for DSL syntax before writing diagramCode. The diagramCode is COMPILE-CHECKED BY RENDERING at write time: broken DSL is rejected with the renderer's error (fix and retry), and valid DSL is rendered + thumbnailed immediately so the document displays instantly everywhere. The response tells you what happened: diagram.renderStatus ('rendered' | 'pending_render' with renderError when the renderer was unavailable), plus fresh optimistic-lock tokens — document.versionTimestamp and diagram.versionTimestamp — so you can keep editing without re-reading. Always set prompt (and ideally nlDescription) to describe what the diagram shows. To SEE the result inline set returnImage:true, or call getDiagramImage afterwards; if it is wrong or ugly, correct it with updateDiagramInDocument (provide the full updated diagramCode).
|
|
539
539
|
*/
|
|
540
540
|
post: operations["insertDiagramInDocument"];
|
|
541
541
|
delete?: never;
|
|
@@ -555,7 +555,7 @@ export interface paths {
|
|
|
555
555
|
put?: never;
|
|
556
556
|
/**
|
|
557
557
|
* updateDiagramInDocument
|
|
558
|
-
* @description Update a diagram's code, description, or properties. Call getDiagramTypeGuide for DSL syntax.
|
|
558
|
+
* @description Update a diagram's code, description, or properties. Call getDiagramTypeGuide for DSL syntax. New diagramCode is COMPILE-CHECKED BY RENDERING at write time — broken DSL is rejected with the renderer's error — and a valid change is re-rendered + re-thumbnailed immediately (response diagram.renderStatus tells you the outcome). Provide a version lock: diagramVersionTimestamp (from getDiagramInDocument, getDocument with includeDiagramDsl:true, or any diagram write's response — PREFERRED: locks just this diagram, so concurrent edits elsewhere in the document don't conflict; bare versionTimestamp is accepted as an alias) OR documentVersionTimestamp (locks the whole document). The response returns BOTH fresh tokens for chaining. Documents carrying a legacy marker (no embedded diagramId) are upgraded automatically on update. IMPORTANT: to change what the diagram visually shows you MUST provide diagramCode with the full updated DSL source — prompt/nlDescription are metadata only. After updating, view it with getDiagramImage and keep prompt/nlDescription in step with what the diagram now shows.
|
|
559
559
|
*/
|
|
560
560
|
post: operations["updateDiagramInDocument"];
|
|
561
561
|
delete?: never;
|
|
@@ -575,7 +575,7 @@ export interface paths {
|
|
|
575
575
|
put?: never;
|
|
576
576
|
/**
|
|
577
577
|
* deleteDiagramInDocument
|
|
578
|
-
* @description Delete a diagram
|
|
578
|
+
* @description Delete a diagram: removes the database record AND every reference to it in the document body — the current marker format plus legacy forms (markers without an embedded diagramId, and old plain-text `[Diagram: name]` placeholders). The response's removedFromBody says whether a marker was actually found in the body, and versionTimestamp is the document's fresh lock token.
|
|
579
579
|
*/
|
|
580
580
|
post: operations["deleteDiagramInDocument"];
|
|
581
581
|
delete?: never;
|
|
@@ -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. 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, 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. 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.
|
|
699
699
|
*/
|
|
700
700
|
post: operations["designDeckInWhiteboard"];
|
|
701
701
|
delete?: never;
|
|
@@ -735,7 +735,7 @@ export interface paths {
|
|
|
735
735
|
put?: never;
|
|
736
736
|
/**
|
|
737
737
|
* getDeckReplyInWhiteboard
|
|
738
|
-
* @description Get the design agent's reply after calling designDeckInWhiteboard OR designIllustrationInWhiteboard: the status (thinking/building/ready) and EITHER the finished result (a deck's slide count + preview, or the placed illustration) OR a clarifying question to answer (call the SAME tool you started with, passing the sessionId + your answer). Poll until ready or a question appears. Give it the whiteboard documentId and the deckId (both returned by the tool you called). It returns the build status ('generating' while working, 'ready' when finished, 'failed' if it failed) plus, once ready, the slide count and a thumbnail image URL. IMPORTANT for the conversation: if the agent asked a CLARIFYING QUESTION instead of doing the work, this returns awaitingUser:true with pendingQuestion (and assistantMessage) — relay that question to the user, then call the SAME design tool again with the same sessionId and the user's answer as message to continue. It also returns the full conversation (history + status + pending question). A turn usually takes about
|
|
738
|
+
* @description Get the design agent's reply after calling designDeckInWhiteboard OR designIllustrationInWhiteboard: the status (thinking/building/ready) and EITHER the finished result (a deck's slide count + preview, or the placed illustration) OR a clarifying question to answer (call the SAME tool you started with, passing the sessionId + your answer). Poll until ready or a question appears. Give it the whiteboard documentId and the deckId (both returned by the tool you called). It returns the build status ('generating' while working, 'ready' when finished, 'failed' if it failed) plus, once ready, the slide count and a thumbnail image URL. IMPORTANT for the conversation: if the agent asked a CLARIFYING QUESTION instead of doing the work, this returns awaitingUser:true with pendingQuestion (and assistantMessage) — relay that question to the user, then call the SAME design tool again with the same sessionId and the user's answer as message to continue. It also returns the full conversation (history + status + pending question). While a turn is running it additionally returns live build state: stage, percent, feed (the agent's real per-step lines), slideTarget (the count it is building to), slides (the finished slides so far, each with a fetchable image url), partialHtml (the deck so far), and, when advanced deck building is on, advancedDeckBuildingProgress (the round-by-round reviewer scores; also emitted as the deprecated `jury` field for one release). Every one of those is optional and absent when there is nothing to report. A standard turn usually takes about 2 to 8 minutes, so poll every 15 to 30 seconds until it is 'ready' or awaitingUser is true; a turn running with advanced deck building takes roughly 15 to 20 minutes, so keep polling for that long before treating it as stuck. When ready, the deck or illustration has already been placed on the whiteboard; a deck can also be exported with exportFromWhiteboard. If a turn failed or produced no change, the user was not charged.
|
|
739
739
|
*/
|
|
740
740
|
post: operations["getDeckReplyInWhiteboard"];
|
|
741
741
|
delete?: never;
|
|
@@ -764,6 +764,66 @@ export interface paths {
|
|
|
764
764
|
patch?: never;
|
|
765
765
|
trace?: never;
|
|
766
766
|
};
|
|
767
|
+
"/tools/startMeetingScribe": {
|
|
768
|
+
parameters: {
|
|
769
|
+
query?: never;
|
|
770
|
+
header?: never;
|
|
771
|
+
path?: never;
|
|
772
|
+
cookie?: never;
|
|
773
|
+
};
|
|
774
|
+
get?: never;
|
|
775
|
+
put?: never;
|
|
776
|
+
/**
|
|
777
|
+
* startMeetingScribe
|
|
778
|
+
* @description Invite the Stable Baseline Meeting Scribe bot to a LIVE meeting (Zoom, Google Meet, Microsoft Teams, or Webex) so it paints a live, editable whiteboard of the conversation as it happens: sticky notes and topic clusters, an agenda that ticks itself off, and decisions and actions pinned to rails, on a real board the team keeps working in afterwards. The bot transcribes only and stores no recording. WHITEBOARD IS REQUIRED: the scribe always paints an existing whiteboard, so documentId (the whiteboard's id) is required. If you do not have a whiteboard id, ASK THE USER which whiteboard to use; do not create one automatically. COST + APPROVAL: it bills 2 credits per minute in 5-minute blocks while it runs (a 60-minute meeting is about 120 credits; hard cap 180 minutes), and it needs the user's explicit approval. Call FIRST without confirm to get the exact quote plus the workspace balance, show that to the user, and only call again with confirm:true once they agree. Available on the Pro and Enterprise plans. It returns immediately with a sessionId; poll getMeetingScribeStatus to watch it join and paint, and stopMeetingScribe to end it. The user can also just remove the bot from the meeting to stop it.
|
|
779
|
+
*/
|
|
780
|
+
post: operations["startMeetingScribe"];
|
|
781
|
+
delete?: never;
|
|
782
|
+
options?: never;
|
|
783
|
+
head?: never;
|
|
784
|
+
patch?: never;
|
|
785
|
+
trace?: never;
|
|
786
|
+
};
|
|
787
|
+
"/tools/getMeetingScribeStatus": {
|
|
788
|
+
parameters: {
|
|
789
|
+
query?: never;
|
|
790
|
+
header?: never;
|
|
791
|
+
path?: never;
|
|
792
|
+
cookie?: never;
|
|
793
|
+
};
|
|
794
|
+
get?: never;
|
|
795
|
+
put?: never;
|
|
796
|
+
/**
|
|
797
|
+
* getMeetingScribeStatus
|
|
798
|
+
* @description Get a meeting scribe's status after startMeetingScribe: the session state (joining, in the waiting room, live in the call, paused, ending, ended, or failed), the live activity feed of what the scribe has painted, and the board it is painting. Give it the sessionId returned by startMeetingScribe. Poll every 15 to 30 seconds while the meeting runs. When the meeting ends the board holds the finished 'meeting map' (topics, decisions, actions, and a summary).
|
|
799
|
+
*/
|
|
800
|
+
post: operations["getMeetingScribeStatus"];
|
|
801
|
+
delete?: never;
|
|
802
|
+
options?: never;
|
|
803
|
+
head?: never;
|
|
804
|
+
patch?: never;
|
|
805
|
+
trace?: never;
|
|
806
|
+
};
|
|
807
|
+
"/tools/stopMeetingScribe": {
|
|
808
|
+
parameters: {
|
|
809
|
+
query?: never;
|
|
810
|
+
header?: never;
|
|
811
|
+
path?: never;
|
|
812
|
+
cookie?: never;
|
|
813
|
+
};
|
|
814
|
+
get?: never;
|
|
815
|
+
put?: never;
|
|
816
|
+
/**
|
|
817
|
+
* stopMeetingScribe
|
|
818
|
+
* @description Stop a running meeting scribe: the bot leaves the meeting and the board is finalised (tidy pass plus a summary frame). Give it the sessionId returned by startMeetingScribe. Billing stops at the current block; the user can also stop the scribe simply by removing the bot from the meeting.
|
|
819
|
+
*/
|
|
820
|
+
post: operations["stopMeetingScribe"];
|
|
821
|
+
delete?: never;
|
|
822
|
+
options?: never;
|
|
823
|
+
head?: never;
|
|
824
|
+
patch?: never;
|
|
825
|
+
trace?: never;
|
|
826
|
+
};
|
|
767
827
|
"/tools/createWhiteboard": {
|
|
768
828
|
parameters: {
|
|
769
829
|
query?: never;
|
|
@@ -915,7 +975,7 @@ export interface paths {
|
|
|
915
975
|
put?: never;
|
|
916
976
|
/**
|
|
917
977
|
* insertWhiteboardDiagram
|
|
918
|
-
* @description Insert a real DIAGRAM (BPMN, Diagrams-as-Code / any DSL: mermaid, d2, plantuml, graphviz, …)
|
|
978
|
+
* @description Insert (or re-render in place) a real DIAGRAM (BPMN, Diagrams-as-Code / any DSL: mermaid, d2, plantuml, graphviz, …) on a whiteboard as an editable SB diagram element. Provide documentId, diagramType (call listDiagramTypes / getDiagramTypeGuide), and source (the DSL). The diagram is rendered to an image stored like a pasted image, and its editable source is kept in a sidecar so it stays a live, re-openable diagram (double-click on the canvas opens the BPMN / code / AI editor). Options: caption (label beneath it), width/height to size it (auto width caps at 480px; an explicit width may go up to 1200px), and x/y or align ('left'|'center'|'right') to place it (defaults to the right of existing content). Pass updateElementId to UPDATE an existing embedded diagram in place — re-render + replace its image and DSL while keeping the same element id and board position (used to live-edit a diagram as it evolves); if that id is not on the board yet it is created carrying that id. After inserting, call getWhiteboardImage to see it and verify it rendered correctly (fix the source and re-insert if it is wrong). For a plain picture (not a diagram) use insertWhiteboardImage; to generate a diagram image WITHOUT inserting use renderDiagram.
|
|
919
979
|
*/
|
|
920
980
|
post: operations["insertWhiteboardDiagram"];
|
|
921
981
|
delete?: never;
|
|
@@ -1055,7 +1115,7 @@ export interface paths {
|
|
|
1055
1115
|
put?: never;
|
|
1056
1116
|
/**
|
|
1057
1117
|
* getDiagramImage
|
|
1058
|
-
* @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). 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 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.
|
|
1059
1119
|
*/
|
|
1060
1120
|
post: operations["getDiagramImage"];
|
|
1061
1121
|
delete?: never;
|
|
@@ -1095,7 +1155,7 @@ export interface paths {
|
|
|
1095
1155
|
put?: never;
|
|
1096
1156
|
/**
|
|
1097
1157
|
* reorderDocuments
|
|
1098
|
-
* @description
|
|
1158
|
+
* @description MOVE documents between folders and/or reorder them — the batch filing tool. Pass [{documentId, position, folderId?}, ...]: `position` is a non-negative integer (usually renumber siblings sequentially as 0, 1, 2…), and the optional per-item `folderId` MOVES that document into the given folder (use null to move it to the project root; omit it to leave the document where it is). Use this to reorganise a project — file loose documents into subfolders, restructure a folder tree, or reorder siblings — in one call. Filing is metadata only: it does NOT bump the document version and does NOT create a version-history snapshot, so tidying folders never shows up as a content revision. A bad folderId fails the whole call rather than half-applying it. For a single document you can also use editDocument({documentId, folderId, position}), which behaves identically (and likewise creates no version when only the filing changes).
|
|
1099
1159
|
*/
|
|
1100
1160
|
post: operations["reorderDocuments"];
|
|
1101
1161
|
delete?: never;
|
|
@@ -1195,7 +1255,7 @@ export interface paths {
|
|
|
1195
1255
|
put?: never;
|
|
1196
1256
|
/**
|
|
1197
1257
|
* updateImageInDocument
|
|
1198
|
-
* @description Update image metadata (alt, caption, dimensions, alignment). Requires
|
|
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.
|
|
1199
1259
|
*/
|
|
1200
1260
|
post: operations["updateImageInDocument"];
|
|
1201
1261
|
delete?: never;
|
|
@@ -1375,7 +1435,7 @@ export interface paths {
|
|
|
1375
1435
|
put?: never;
|
|
1376
1436
|
/**
|
|
1377
1437
|
* createImprovement
|
|
1378
|
-
* @description Create an improvement item in a project. Requires projectId and title. Auto-assigns friendly ID.
|
|
1438
|
+
* @description Create an improvement item in a project. Requires projectId and title. Auto-assigns friendly ID. Accepts every field updateImprovement accepts, so an item can be created complete in one call rather than create-then-update.
|
|
1379
1439
|
*/
|
|
1380
1440
|
post: operations["createImprovement"];
|
|
1381
1441
|
delete?: never;
|
|
@@ -1395,7 +1455,7 @@ export interface paths {
|
|
|
1395
1455
|
put?: never;
|
|
1396
1456
|
/**
|
|
1397
1457
|
* updateImprovement
|
|
1398
|
-
* @description Update an improvement (or a task — tasks share this row, but prefer the symmetric updateTask alias when working from getTask). Supports the full field set including `checklist` (tick-boxes with due dates + completion attribution) and `acceptance_criteria` (objects with per-row updated_by/at attribution). Requires versionTimestamp from getImprovement for optimistic locking.
|
|
1458
|
+
* @description Update an improvement (or a task — tasks share this row, but prefer the symmetric updateTask alias when working from getTask). Supports the full field set including `checklist` (tick-boxes with due dates + completion attribution) and `acceptance_criteria` (objects with per-row updated_by/at attribution). Requires versionTimestamp from getImprovement for optimistic locking. Statuses are captured / in_progress / blocked / done / rejected / deferred, and FOUR of those are CLOSED: blocked, done, rejected, deferred. Entering one needs its comment (blocked needs blocked_comment, rejected needs rejection_comment, done needs completion_comment); leaving one for an open status needs reopened_comment — including blocked -> in_progress, which surprises people because `blocked` does not sound terminal. `metadata` MERGES into what is stored (null on a key deletes it); pass metadata_replace:true to overwrite the object wholesale. Assignment: pass `owner_id=<uuid>` to assign to a user, `owner_team_id=<uuid>` to assign to a team (mutually exclusive — a DB CHECK constraint enforces this). To unassign, pass `owner_id=null` AND `owner_team_id=null`. To switch from a user owner to a team owner, send `owner_id=null, owner_team_id=<uuid>` in the SAME call (sending only one side leaves the stale value and triggers the XOR check). Use listAssignablePrincipals or listTeams to discover valid IDs.
|
|
1399
1459
|
*/
|
|
1400
1460
|
post: operations["updateImprovement"];
|
|
1401
1461
|
delete?: never;
|
|
@@ -1919,7 +1979,7 @@ export interface paths {
|
|
|
1919
1979
|
put?: never;
|
|
1920
1980
|
/**
|
|
1921
1981
|
* createTask
|
|
1922
|
-
* @description Create a task in a plan. Requires planId and title.
|
|
1982
|
+
* @description Create a task in a plan. Requires planId and title. Accepts every field updateTask accepts, so a task can be created complete in ONE call — no create-then-update, and no window in which other actors read a half-written record.
|
|
1923
1983
|
*/
|
|
1924
1984
|
post: operations["createTask"];
|
|
1925
1985
|
delete?: never;
|
|
@@ -1979,7 +2039,7 @@ export interface paths {
|
|
|
1979
2039
|
put?: never;
|
|
1980
2040
|
/**
|
|
1981
2041
|
* updateTask
|
|
1982
|
-
* @description Update a task. Tasks share a row with improvements (`improvement_items` with `is_task=true`), so this is a thin alias over updateImprovement — every field on updateImprovement is supported, including `checklist`, `acceptance_criteria`,
|
|
2042
|
+
* @description Update a task. Tasks share a row with improvements (`improvement_items` with `is_task=true`), so this is a thin alias over updateImprovement — every field on updateImprovement is supported, including `checklist`, `acceptance_criteria`, dates, owner, percent_complete, etc. Requires versionTimestamp from getTask for optimistic locking. Statuses are captured / in_progress / blocked / done / rejected / deferred, and FOUR of those are CLOSED: blocked, done, rejected, deferred. Entering one needs its comment (blocked_comment / rejection_comment / completion_comment); leaving one for an open status needs reopened_comment — including blocked -> in_progress, which surprises people because `blocked` does not sound terminal. `metadata` MERGES into what is stored (null on a key deletes it); pass metadata_replace:true to overwrite the object wholesale. To edit checklist items: call getTask, modify the `checklist` array (preserving each row's `id` to keep its attribution stamps), and pass the full array back here — array order is the sort order. Assignment: pass `owner_id=<uuid>` to assign to a user, `owner_team_id=<uuid>` to assign to a team (mutually exclusive — the DB enforces with a CHECK constraint). To unassign, pass `owner_id=null` AND `owner_team_id=null`. To switch owner kind, send the new value AND null the old one in the SAME call.
|
|
1983
2043
|
*/
|
|
1984
2044
|
post: operations["updateTask"];
|
|
1985
2045
|
delete?: never;
|
|
@@ -2099,7 +2159,7 @@ export interface paths {
|
|
|
2099
2159
|
put?: never;
|
|
2100
2160
|
/**
|
|
2101
2161
|
* deleteTaskDependency
|
|
2102
|
-
* @description Remove a task-dependency edge. Neither item's dates are changed.
|
|
2162
|
+
* @description Remove a task-dependency edge. Neither item's dates are changed. Needs the same 'write' plan permission as createTaskDependency, so an actor that can draw an edge can also undo it — the edge is fully recreatable from (predecessor, successor, type, lag).
|
|
2103
2163
|
*/
|
|
2104
2164
|
post: operations["deleteTaskDependency"];
|
|
2105
2165
|
delete?: never;
|
|
@@ -4010,6 +4070,7 @@ export interface operations {
|
|
|
4010
4070
|
requestBody?: {
|
|
4011
4071
|
content: {
|
|
4012
4072
|
"application/json": {
|
|
4073
|
+
/** @description Keyword or intent, e.g. 'circuit', 'wiring harness', 'timing'. Semantic-backed: matches descriptions, not just names. */
|
|
4013
4074
|
query?: string;
|
|
4014
4075
|
enabledOnly?: boolean;
|
|
4015
4076
|
limit?: number;
|
|
@@ -4520,6 +4581,8 @@ export interface operations {
|
|
|
4520
4581
|
/** @description Workspace UUID. Optional but recommended — when present, the result includes ALL org members; when omitted, only direct project grants + team-expanded users are returned. */
|
|
4521
4582
|
workspaceId?: string;
|
|
4522
4583
|
/** @description Optional ILIKE search filter — matched against display_name + email (users) and team name (teams). */
|
|
4584
|
+
query?: string;
|
|
4585
|
+
/** @description Deprecated alias for `query`, still accepted. Prefer `query` — that is the name every other list tool uses. */
|
|
4523
4586
|
q?: string;
|
|
4524
4587
|
/**
|
|
4525
4588
|
* @description Filter to one principal kind. Default 'all' returns users first then teams.
|
|
@@ -4616,6 +4679,8 @@ export interface operations {
|
|
|
4616
4679
|
/** @description Workspace UUID. The parent organization is resolved from v_workspaces. */
|
|
4617
4680
|
workspaceId?: string;
|
|
4618
4681
|
/** @description Optional ILIKE search on team name/slug. */
|
|
4682
|
+
query?: string;
|
|
4683
|
+
/** @description Deprecated alias for `query`, still accepted. Prefer `query` — that is the name every other list tool uses. */
|
|
4619
4684
|
q?: string;
|
|
4620
4685
|
/** @description When true, each team gets a `members` array (user_id, role, joined_at). Capped at 500 total members across the page. Default false. */
|
|
4621
4686
|
includeMembers?: boolean;
|
|
@@ -4875,6 +4940,10 @@ export interface operations {
|
|
|
4875
4940
|
requestBody?: {
|
|
4876
4941
|
content: {
|
|
4877
4942
|
"application/json": {
|
|
4943
|
+
/** @description Return only workspaces in this organisation. Use listOrganisations to find the id. (organizationId is accepted as a spelling alias.) */
|
|
4944
|
+
organisationId?: string;
|
|
4945
|
+
/** @description Spelling alias for organisationId. */
|
|
4946
|
+
organizationId?: string;
|
|
4878
4947
|
query?: string;
|
|
4879
4948
|
limit?: number;
|
|
4880
4949
|
offset?: number;
|
|
@@ -5506,7 +5575,10 @@ export interface operations {
|
|
|
5506
5575
|
/** @description Cap on matching lines returned per document. 1-20, default 5. */
|
|
5507
5576
|
maxMatchesPerDocument?: number;
|
|
5508
5577
|
limit?: number;
|
|
5578
|
+
/** @description Pagination offset over the MATCHES. When searching, use scanOffset (not this) to reach documents the scan has not covered. */
|
|
5509
5579
|
offset?: number;
|
|
5580
|
+
/** @description Search-only. Where to start the document scan within the scope. One call examines a bounded window; when the response reports truncated:true it also returns nextScanOffset — repeat with scanOffset set to that value until nextScanOffset is absent, and union the results, to search a scope larger than one window exhaustively. */
|
|
5581
|
+
scanOffset?: number;
|
|
5510
5582
|
/** @description ISO 8601 date filter (from). */
|
|
5511
5583
|
fromDate?: string;
|
|
5512
5584
|
/** @description ISO 8601 date filter (to). */
|
|
@@ -5693,8 +5765,10 @@ export interface operations {
|
|
|
5693
5765
|
requestBody?: {
|
|
5694
5766
|
content: {
|
|
5695
5767
|
"application/json": {
|
|
5696
|
-
/** @description
|
|
5697
|
-
|
|
5768
|
+
/** @description Return the whole project's folder tree from the root. Provide this or folderId. */
|
|
5769
|
+
projectId?: string;
|
|
5770
|
+
/** @description The folder ID to start from. Omit and pass projectId to get the project root hierarchy. */
|
|
5771
|
+
folderId?: string;
|
|
5698
5772
|
/** @description Max nesting depth. Default: 10, max: 20. */
|
|
5699
5773
|
maxDepth?: number;
|
|
5700
5774
|
/** @description Include documents. Default: true. */
|
|
@@ -5788,7 +5862,9 @@ export interface operations {
|
|
|
5788
5862
|
requestBody?: {
|
|
5789
5863
|
content: {
|
|
5790
5864
|
"application/json": {
|
|
5791
|
-
/** @description
|
|
5865
|
+
/** @description Optional. Narrows a friendly-id lookup to one project. Only needed when a friendly id is ambiguous — TAS-/IMP-/PLN- ids are numbered per PROJECT, so the same id can exist in several. Ignored when the id is a UUID. */
|
|
5866
|
+
projectId?: string;
|
|
5867
|
+
/** @description The document ID to read. Accepts either the UUID or the friendly id (e.g. DOC-815); friendly ids are resolved within your organisation. */
|
|
5792
5868
|
documentId: string;
|
|
5793
5869
|
/** @description Lines to skip from start. Default: 0. */
|
|
5794
5870
|
offset?: number;
|
|
@@ -5884,7 +5960,10 @@ export interface operations {
|
|
|
5884
5960
|
projectId: string;
|
|
5885
5961
|
folderId?: string;
|
|
5886
5962
|
title?: string;
|
|
5887
|
-
|
|
5963
|
+
/** @description Document body in CDMD markdown. Alias: content. */
|
|
5964
|
+
cdmd?: string;
|
|
5965
|
+
/** @description Alias for cdmd — provide one of the two. */
|
|
5966
|
+
content?: string;
|
|
5888
5967
|
/** @description Sort position within the parent folder (or project root if no folderId). When omitted, the document is appended at the end. */
|
|
5889
5968
|
position?: number;
|
|
5890
5969
|
/** @description Version history summary. */
|
|
@@ -5970,15 +6049,19 @@ export interface operations {
|
|
|
5970
6049
|
requestBody?: {
|
|
5971
6050
|
content: {
|
|
5972
6051
|
"application/json": {
|
|
6052
|
+
/** @description Optional. Narrows a friendly-id lookup to one project. Only needed when a friendly id is ambiguous — TAS-/IMP-/PLN- ids are numbered per PROJECT, so the same id can exist in several. Ignored when the id is a UUID. */
|
|
6053
|
+
projectId?: string;
|
|
5973
6054
|
documentId: string;
|
|
5974
6055
|
/** @description New title. */
|
|
5975
6056
|
title?: string;
|
|
5976
|
-
/** @description
|
|
5977
|
-
folderId?: string;
|
|
5978
|
-
/** @description Sort position within the parent folder. Use to reposition a single document. For batch sibling reorder, use reorderDocuments. */
|
|
6057
|
+
/** @description MOVE the document into this folder (null moves it to the project root). Send it with patches:[] to file the document without touching its content — a folder-only move updates folder_id, creates NO version-history entry, and does not bump the document version. To move many documents at once use reorderDocuments, which takes folderId per item. */
|
|
6058
|
+
folderId?: string | null;
|
|
6059
|
+
/** @description Sort position within the parent folder. Use to reposition a single document; like folderId, a position-only change creates no version. For batch sibling reorder/move, use reorderDocuments. */
|
|
5979
6060
|
position?: number;
|
|
5980
|
-
/** @description
|
|
6061
|
+
/** @description Optimistic-lock token from getDocument() or any mutating tool's response. Required unless dryRun:true. (Alias accepted: documentVersionTimestamp.) */
|
|
5981
6062
|
versionTimestamp?: number;
|
|
6063
|
+
/** @description Legacy integer version guard, checked in addition to versionTimestamp. Prefer versionTimestamp — this exists for older clients and is optional. */
|
|
6064
|
+
expectedVersion?: number;
|
|
5982
6065
|
/** @description If true, apply the patches and RETURN the resulting document text without saving — no version bump, no lock required. Use to preview/verify a patch before committing. Default false. */
|
|
5983
6066
|
dryRun?: boolean;
|
|
5984
6067
|
/** @description Version history summary. */
|
|
@@ -6082,6 +6165,8 @@ export interface operations {
|
|
|
6082
6165
|
requestBody?: {
|
|
6083
6166
|
content: {
|
|
6084
6167
|
"application/json": {
|
|
6168
|
+
/** @description Optional. Narrows a friendly-id lookup to one project. Only needed when a friendly id is ambiguous — TAS-/IMP-/PLN- ids are numbered per PROJECT, so the same id can exist in several. Ignored when the id is a UUID. */
|
|
6169
|
+
projectId?: string;
|
|
6085
6170
|
documentId: string;
|
|
6086
6171
|
/** @description Text to search for. */
|
|
6087
6172
|
find: string;
|
|
@@ -6089,6 +6174,8 @@ export interface operations {
|
|
|
6089
6174
|
replace: string;
|
|
6090
6175
|
/** @description Case-sensitive matching. Default: true. */
|
|
6091
6176
|
caseSensitive?: boolean;
|
|
6177
|
+
/** @description Optional optimistic-lock token from getDocument() or a previous write; validated when provided. (Alias accepted: documentVersionTimestamp.) */
|
|
6178
|
+
versionTimestamp?: number;
|
|
6092
6179
|
/** @description Version history summary. */
|
|
6093
6180
|
changeSummary?: string;
|
|
6094
6181
|
};
|
|
@@ -6257,9 +6344,11 @@ export interface operations {
|
|
|
6257
6344
|
requestBody?: {
|
|
6258
6345
|
content: {
|
|
6259
6346
|
"application/json": {
|
|
6347
|
+
/** @description Optional. Narrows a friendly-id lookup to one project. Only needed when a friendly id is ambiguous — TAS-/IMP-/PLN- ids are numbered per PROJECT, so the same id can exist in several. Ignored when the id is a UUID. */
|
|
6348
|
+
projectId?: string;
|
|
6260
6349
|
documentId: string;
|
|
6261
|
-
/** @description
|
|
6262
|
-
documentVersionTimestamp
|
|
6350
|
+
/** @description Optimistic-lock token: the document's versionTimestamp from getDocument() or any mutating tool's response. (Alias accepted: versionTimestamp.) */
|
|
6351
|
+
documentVersionTimestamp?: number;
|
|
6263
6352
|
/** @description Diagram type (e.g. mermaid, plantuml, bpmn, d2). Call listDiagramTypes for all types. */
|
|
6264
6353
|
type: string;
|
|
6265
6354
|
/** @description Diagram DSL code. Call getDiagramTypeGuide for syntax. EXCEPTION — for type 'infographic', put a plain-English DESCRIPTION of the infographic here (NOT code); the system designs the AntV spec and renders it. */
|
|
@@ -6267,16 +6356,16 @@ export interface operations {
|
|
|
6267
6356
|
/** @description Short description of what the diagram shows (1-2 sentences). */
|
|
6268
6357
|
prompt: string;
|
|
6269
6358
|
/** @description Extended description of the diagram (2-4 sentences). */
|
|
6270
|
-
nlDescription
|
|
6359
|
+
nlDescription?: string;
|
|
6271
6360
|
/**
|
|
6272
6361
|
* @description Alignment.
|
|
6273
6362
|
* @enum {string}
|
|
6274
6363
|
*/
|
|
6275
|
-
align
|
|
6364
|
+
align?: "left" | "center" | "right";
|
|
6276
6365
|
/** @description Caption below the diagram. */
|
|
6277
|
-
caption
|
|
6366
|
+
caption?: string;
|
|
6278
6367
|
/** @description Insert after this line number (1-based). */
|
|
6279
|
-
afterLine
|
|
6368
|
+
afterLine?: number;
|
|
6280
6369
|
/** @description BPMN only. Color plan: { byElementId: { ElementId: SwatchName } }. */
|
|
6281
6370
|
colorPlan?: {
|
|
6282
6371
|
/** @description Map of element IDs to color swatch names. */
|
|
@@ -6381,7 +6470,7 @@ export interface operations {
|
|
|
6381
6470
|
"application/json": {
|
|
6382
6471
|
/** @description Diagram ID from DIAGRAM_OMITTED markers. */
|
|
6383
6472
|
diagramId: string;
|
|
6384
|
-
/** @description New diagram DSL source code. REQUIRED to change what the diagram visually renders. Call getDiagramTypeGuide for syntax. Must provide the COMPLETE updated DSL, not just the changed parts. */
|
|
6473
|
+
/** @description New diagram DSL source code. REQUIRED to change what the diagram visually renders. Call getDiagramTypeGuide for syntax. Must provide the COMPLETE updated DSL, not just the changed parts. EXCEPTION — for type 'infographic', pass either a plain-English DESCRIPTION of the new infographic (the system designs, renders, and stores the AntV spec, same as insert) or complete AntV Infographic DSL (first line `infographic <template-name>`). */
|
|
6385
6474
|
diagramCode?: string;
|
|
6386
6475
|
/** @description New short description (metadata only — does NOT change the rendered diagram). */
|
|
6387
6476
|
prompt?: string;
|
|
@@ -6403,7 +6492,7 @@ export interface operations {
|
|
|
6403
6492
|
};
|
|
6404
6493
|
/** @description Document-level optimistic lock: versionTimestamp from getDocument(). Locks the whole document. Provide this OR diagramVersionTimestamp (at least one is required). */
|
|
6405
6494
|
documentVersionTimestamp?: number;
|
|
6406
|
-
/** @description Diagram-level optimistic lock: versionTimestamp of THIS diagram (from getDiagramInDocument,
|
|
6495
|
+
/** @description Diagram-level optimistic lock: versionTimestamp of THIS diagram (from getDiagramInDocument, getDocument with includeDiagramDsl:true, or a previous write's response). Preferred: locks only this diagram, so concurrent edits to OTHER diagrams in the same document don't conflict. (Alias accepted: versionTimestamp.) The response returns the new diagram.versionTimestamp for chaining further edits. */
|
|
6407
6496
|
diagramVersionTimestamp?: number;
|
|
6408
6497
|
};
|
|
6409
6498
|
};
|
|
@@ -6488,6 +6577,8 @@ export interface operations {
|
|
|
6488
6577
|
"application/json": {
|
|
6489
6578
|
/** @description Diagram ID from DIAGRAM_OMITTED markers. */
|
|
6490
6579
|
diagramId: string;
|
|
6580
|
+
/** @description Optional document optimistic-lock token; validated when provided. (Alias accepted: documentVersionTimestamp.) */
|
|
6581
|
+
versionTimestamp?: number;
|
|
6491
6582
|
};
|
|
6492
6583
|
};
|
|
6493
6584
|
};
|
|
@@ -6570,6 +6661,8 @@ export interface operations {
|
|
|
6570
6661
|
content: {
|
|
6571
6662
|
"application/json": {
|
|
6572
6663
|
documentId: string;
|
|
6664
|
+
/** @description Optional. Narrows a friendly-id lookup to one project. Ignored when documentId is a UUID. */
|
|
6665
|
+
projectId?: string;
|
|
6573
6666
|
};
|
|
6574
6667
|
};
|
|
6575
6668
|
};
|
|
@@ -6748,6 +6841,13 @@ export interface operations {
|
|
|
6748
6841
|
designProfile?: "standard" | "branded-executive" | "illustrated" | "image" | "agentic" | "agentic-deck";
|
|
6749
6842
|
/** @description Optional brand kit id (from listBrandKits) to theme a branded-executive deck. If omitted, the org's built-in default is used. Create one from just a logo (or a .pptx/.docx) via createBrandKit. */
|
|
6750
6843
|
brandKitId?: string;
|
|
6844
|
+
/** @description Design the board from a meeting transcript (exactly one of documentId or text). When set, the board is built as a 'meeting map' (topics, decisions, actions) from the transcript instead of from the goal alone. This mode is billed by transcript LENGTH — 2 credits per minute of transcript (10-minute minimum), not the flat 50; the first (unconfirmed) call returns the exact cost to relay to the user. */
|
|
6845
|
+
sourceTranscript?: {
|
|
6846
|
+
/** @description The id of a Stable Baseline document holding the meeting transcript/notes to design from. */
|
|
6847
|
+
documentId?: string;
|
|
6848
|
+
/** @description The raw transcript text to design from (pasted). Provide this OR documentId, not both. */
|
|
6849
|
+
text?: string;
|
|
6850
|
+
};
|
|
6751
6851
|
};
|
|
6752
6852
|
};
|
|
6753
6853
|
};
|
|
@@ -6851,6 +6951,8 @@ export interface operations {
|
|
|
6851
6951
|
tags?: string[];
|
|
6852
6952
|
/** @description Optional URL of a reference image the component should match; the critic compares the render to it. */
|
|
6853
6953
|
referenceImageUrl?: string;
|
|
6954
|
+
/** @description Optional brand kit id (from listBrandKits) to theme the component. If omitted, the organisation's effective brand is used. */
|
|
6955
|
+
brandKitId?: string;
|
|
6854
6956
|
/** @description Redesign even if a component with this key already exists (default false = reuse). */
|
|
6855
6957
|
force?: boolean;
|
|
6856
6958
|
};
|
|
@@ -7027,7 +7129,7 @@ export interface operations {
|
|
|
7027
7129
|
"application/json": {
|
|
7028
7130
|
/** @description The whiteboard the deck lives in. REQUIRED: a deck cannot exist without a whiteboard, and this is that whiteboard's id. If you do not already have a whiteboard id, ASK THE USER which whiteboard to design the deck in — never create one automatically. Only call createWhiteboard first if the user explicitly wants a new board. */
|
|
7029
7131
|
documentId: string;
|
|
7030
|
-
/** @description This turn's message in plain language: the design brief on the first turn, an edit instruction later, or the user's ANSWER to a clarifying question the agent asked. On a follow-up turn, pass this together with the sessionId (or deckId) from the earlier call. */
|
|
7132
|
+
/** @description This turn's message in plain language: the design brief on the first turn, an edit instruction later, or the user's ANSWER to a clarifying question the agent asked. On a follow-up turn, pass this together with the sessionId (or deckId) from the earlier call. If the user mentioned how many slides they want, ALSO pass slideCount with that number — never leave the count only in prose, and never outline more slides in this message than slideCount. */
|
|
7031
7133
|
message: string;
|
|
7032
7134
|
/** @description The design conversation to continue, as returned by an earlier designDeckInWhiteboard call. Pass it together with message to answer a question, make an edit, or send a follow-up. Omit on the very first call to start a new conversation. */
|
|
7033
7135
|
sessionId?: string;
|
|
@@ -7042,8 +7144,14 @@ export interface operations {
|
|
|
7042
7144
|
title?: string;
|
|
7043
7145
|
/** @description Optional brand kit id (from listBrandKits) to theme the deck. If omitted, the organisation's effective brand is used. */
|
|
7044
7146
|
brandKitId?: string;
|
|
7045
|
-
/** @description
|
|
7147
|
+
/** @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). */
|
|
7046
7148
|
slideCount?: number;
|
|
7149
|
+
/** @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). */
|
|
7150
|
+
imageCount?: number;
|
|
7151
|
+
/** @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. */
|
|
7152
|
+
advancedDeckBuilding?: boolean;
|
|
7153
|
+
/** @description Optional. How many redraft-and-review rounds advanced deck building may run: 1 to 3, default 3. Each round is a full redraft plus four reviews, adds roughly 5 minutes, and costs 15 credits (depth 1 = +15, depth 2 = +30, depth 3 = +45). Ignored unless advancedDeckBuilding is true. */
|
|
7154
|
+
advancedDeckBuildingDepth?: number;
|
|
7047
7155
|
/** @description Optional reference images for THIS turn (up to 8; images only). The agent lifts palette, layout, and tone from them (it does not pixel-copy). Non-image attachments are ignored. */
|
|
7048
7156
|
attachments?: {
|
|
7049
7157
|
/** @description A public https URL to the image. */
|
|
@@ -7054,6 +7162,8 @@ export interface operations {
|
|
|
7054
7162
|
mediaType?: string;
|
|
7055
7163
|
/** @description Optional human-readable name for the image. */
|
|
7056
7164
|
name?: string;
|
|
7165
|
+
/** @description Optional attachment type hint, passed through to the design worker. */
|
|
7166
|
+
type?: string;
|
|
7057
7167
|
}[];
|
|
7058
7168
|
/** @description Set true ONLY after the user has approved the cost (50 for a build, 10 for an edit). Leave unset/false on the first call of a turn to receive the cost quote plus balance. A clarifying question turn is never charged. */
|
|
7059
7169
|
confirm?: boolean;
|
|
@@ -7160,6 +7270,8 @@ export interface operations {
|
|
|
7160
7270
|
mediaType?: string;
|
|
7161
7271
|
/** @description Optional human-readable name for the image. */
|
|
7162
7272
|
name?: string;
|
|
7273
|
+
/** @description Optional attachment type hint, passed through to the design worker. */
|
|
7274
|
+
type?: string;
|
|
7163
7275
|
}[];
|
|
7164
7276
|
/** @description Set true ONLY after the user has approved the cost (50 for a build, 10 for an edit). Leave unset/false on the first call of a turn to receive the cost quote plus balance. A clarifying question turn is never charged. */
|
|
7165
7277
|
confirm?: boolean;
|
|
@@ -7416,6 +7528,275 @@ export interface operations {
|
|
|
7416
7528
|
};
|
|
7417
7529
|
};
|
|
7418
7530
|
};
|
|
7531
|
+
startMeetingScribe: {
|
|
7532
|
+
parameters: {
|
|
7533
|
+
query?: never;
|
|
7534
|
+
header?: never;
|
|
7535
|
+
path?: never;
|
|
7536
|
+
cookie?: never;
|
|
7537
|
+
};
|
|
7538
|
+
requestBody?: {
|
|
7539
|
+
content: {
|
|
7540
|
+
"application/json": {
|
|
7541
|
+
/** @description The whiteboard the scribe paints into. REQUIRED: a meeting scribe always paints an existing board. If you do not have a whiteboard id, ask the user which whiteboard to use; never create one automatically. */
|
|
7542
|
+
documentId: string;
|
|
7543
|
+
/** @description The meeting link to join: a Zoom, Google Meet, Microsoft Teams, or Webex URL (https only). Any other host is rejected. */
|
|
7544
|
+
meetingUrl: string;
|
|
7545
|
+
/** @description Optional agenda pre-drawn on the board as a left rail; each item gets a status sticker (pending, active, done) as the conversation reaches it. Omit to let the rail build itself from the topics that emerge. */
|
|
7546
|
+
agenda?: {
|
|
7547
|
+
/** @description The agenda item text. */
|
|
7548
|
+
label: string;
|
|
7549
|
+
/** @description Optional stable id; one is minted if omitted. */
|
|
7550
|
+
id?: string;
|
|
7551
|
+
/**
|
|
7552
|
+
* @description Optional starting status sticker. Default: pending.
|
|
7553
|
+
* @enum {string}
|
|
7554
|
+
*/
|
|
7555
|
+
status?: "pending" | "active" | "done";
|
|
7556
|
+
}[];
|
|
7557
|
+
/** @description Optional per-meeting settings: { language (BCP-47, e.g. 'en'), sttProvider ('assemblyai' default, or 'captions'), presentMode ('off' default, or 'camera'/'screenshare' to stream the live board back into the meeting), botName (override the default '{Org} Scribe (Stable Baseline)') }. */
|
|
7558
|
+
settings?: {
|
|
7559
|
+
[key: string]: unknown;
|
|
7560
|
+
};
|
|
7561
|
+
/** @description Set true ONLY after the user has approved the per-minute cost. Leave unset/false on the first call to receive the quote plus balance. */
|
|
7562
|
+
confirm?: boolean;
|
|
7563
|
+
};
|
|
7564
|
+
};
|
|
7565
|
+
};
|
|
7566
|
+
responses: {
|
|
7567
|
+
/** @description Tool result (shape varies per tool — refer to the tool's docs for the exact return value). */
|
|
7568
|
+
200: {
|
|
7569
|
+
headers: {
|
|
7570
|
+
[name: string]: unknown;
|
|
7571
|
+
};
|
|
7572
|
+
content: {
|
|
7573
|
+
"application/json": {
|
|
7574
|
+
[key: string]: unknown;
|
|
7575
|
+
};
|
|
7576
|
+
};
|
|
7577
|
+
};
|
|
7578
|
+
/** @description Validation error. */
|
|
7579
|
+
400: {
|
|
7580
|
+
headers: {
|
|
7581
|
+
[name: string]: unknown;
|
|
7582
|
+
};
|
|
7583
|
+
content: {
|
|
7584
|
+
"application/json": components["schemas"]["ErrorResponse"];
|
|
7585
|
+
};
|
|
7586
|
+
};
|
|
7587
|
+
/** @description Missing or invalid credentials. */
|
|
7588
|
+
401: {
|
|
7589
|
+
headers: {
|
|
7590
|
+
[name: string]: unknown;
|
|
7591
|
+
};
|
|
7592
|
+
content: {
|
|
7593
|
+
"application/json": components["schemas"]["ErrorResponse"];
|
|
7594
|
+
};
|
|
7595
|
+
};
|
|
7596
|
+
/** @description Authenticated but lacking the required permission or feature flag. */
|
|
7597
|
+
403: {
|
|
7598
|
+
headers: {
|
|
7599
|
+
[name: string]: unknown;
|
|
7600
|
+
};
|
|
7601
|
+
content: {
|
|
7602
|
+
"application/json": components["schemas"]["ErrorResponse"];
|
|
7603
|
+
};
|
|
7604
|
+
};
|
|
7605
|
+
/** @description Resource not found. */
|
|
7606
|
+
404: {
|
|
7607
|
+
headers: {
|
|
7608
|
+
[name: string]: unknown;
|
|
7609
|
+
};
|
|
7610
|
+
content: {
|
|
7611
|
+
"application/json": components["schemas"]["ErrorResponse"];
|
|
7612
|
+
};
|
|
7613
|
+
};
|
|
7614
|
+
/** @description Body did not match the tool's input schema. */
|
|
7615
|
+
422: {
|
|
7616
|
+
headers: {
|
|
7617
|
+
[name: string]: unknown;
|
|
7618
|
+
};
|
|
7619
|
+
content: {
|
|
7620
|
+
"application/json": components["schemas"]["ErrorResponse"];
|
|
7621
|
+
};
|
|
7622
|
+
};
|
|
7623
|
+
/** @description Server error. */
|
|
7624
|
+
500: {
|
|
7625
|
+
headers: {
|
|
7626
|
+
[name: string]: unknown;
|
|
7627
|
+
};
|
|
7628
|
+
content: {
|
|
7629
|
+
"application/json": components["schemas"]["ErrorResponse"];
|
|
7630
|
+
};
|
|
7631
|
+
};
|
|
7632
|
+
};
|
|
7633
|
+
};
|
|
7634
|
+
getMeetingScribeStatus: {
|
|
7635
|
+
parameters: {
|
|
7636
|
+
query?: never;
|
|
7637
|
+
header?: never;
|
|
7638
|
+
path?: never;
|
|
7639
|
+
cookie?: never;
|
|
7640
|
+
};
|
|
7641
|
+
requestBody?: {
|
|
7642
|
+
content: {
|
|
7643
|
+
"application/json": {
|
|
7644
|
+
/** @description The meeting scribe session to poll, as returned by startMeetingScribe. */
|
|
7645
|
+
sessionId: string;
|
|
7646
|
+
};
|
|
7647
|
+
};
|
|
7648
|
+
};
|
|
7649
|
+
responses: {
|
|
7650
|
+
/** @description Tool result (shape varies per tool — refer to the tool's docs for the exact return value). */
|
|
7651
|
+
200: {
|
|
7652
|
+
headers: {
|
|
7653
|
+
[name: string]: unknown;
|
|
7654
|
+
};
|
|
7655
|
+
content: {
|
|
7656
|
+
"application/json": {
|
|
7657
|
+
[key: string]: unknown;
|
|
7658
|
+
};
|
|
7659
|
+
};
|
|
7660
|
+
};
|
|
7661
|
+
/** @description Validation error. */
|
|
7662
|
+
400: {
|
|
7663
|
+
headers: {
|
|
7664
|
+
[name: string]: unknown;
|
|
7665
|
+
};
|
|
7666
|
+
content: {
|
|
7667
|
+
"application/json": components["schemas"]["ErrorResponse"];
|
|
7668
|
+
};
|
|
7669
|
+
};
|
|
7670
|
+
/** @description Missing or invalid credentials. */
|
|
7671
|
+
401: {
|
|
7672
|
+
headers: {
|
|
7673
|
+
[name: string]: unknown;
|
|
7674
|
+
};
|
|
7675
|
+
content: {
|
|
7676
|
+
"application/json": components["schemas"]["ErrorResponse"];
|
|
7677
|
+
};
|
|
7678
|
+
};
|
|
7679
|
+
/** @description Authenticated but lacking the required permission or feature flag. */
|
|
7680
|
+
403: {
|
|
7681
|
+
headers: {
|
|
7682
|
+
[name: string]: unknown;
|
|
7683
|
+
};
|
|
7684
|
+
content: {
|
|
7685
|
+
"application/json": components["schemas"]["ErrorResponse"];
|
|
7686
|
+
};
|
|
7687
|
+
};
|
|
7688
|
+
/** @description Resource not found. */
|
|
7689
|
+
404: {
|
|
7690
|
+
headers: {
|
|
7691
|
+
[name: string]: unknown;
|
|
7692
|
+
};
|
|
7693
|
+
content: {
|
|
7694
|
+
"application/json": components["schemas"]["ErrorResponse"];
|
|
7695
|
+
};
|
|
7696
|
+
};
|
|
7697
|
+
/** @description Body did not match the tool's input schema. */
|
|
7698
|
+
422: {
|
|
7699
|
+
headers: {
|
|
7700
|
+
[name: string]: unknown;
|
|
7701
|
+
};
|
|
7702
|
+
content: {
|
|
7703
|
+
"application/json": components["schemas"]["ErrorResponse"];
|
|
7704
|
+
};
|
|
7705
|
+
};
|
|
7706
|
+
/** @description Server error. */
|
|
7707
|
+
500: {
|
|
7708
|
+
headers: {
|
|
7709
|
+
[name: string]: unknown;
|
|
7710
|
+
};
|
|
7711
|
+
content: {
|
|
7712
|
+
"application/json": components["schemas"]["ErrorResponse"];
|
|
7713
|
+
};
|
|
7714
|
+
};
|
|
7715
|
+
};
|
|
7716
|
+
};
|
|
7717
|
+
stopMeetingScribe: {
|
|
7718
|
+
parameters: {
|
|
7719
|
+
query?: never;
|
|
7720
|
+
header?: never;
|
|
7721
|
+
path?: never;
|
|
7722
|
+
cookie?: never;
|
|
7723
|
+
};
|
|
7724
|
+
requestBody?: {
|
|
7725
|
+
content: {
|
|
7726
|
+
"application/json": {
|
|
7727
|
+
/** @description The meeting scribe session to stop, as returned by startMeetingScribe. */
|
|
7728
|
+
sessionId: string;
|
|
7729
|
+
};
|
|
7730
|
+
};
|
|
7731
|
+
};
|
|
7732
|
+
responses: {
|
|
7733
|
+
/** @description Tool result (shape varies per tool — refer to the tool's docs for the exact return value). */
|
|
7734
|
+
200: {
|
|
7735
|
+
headers: {
|
|
7736
|
+
[name: string]: unknown;
|
|
7737
|
+
};
|
|
7738
|
+
content: {
|
|
7739
|
+
"application/json": {
|
|
7740
|
+
[key: string]: unknown;
|
|
7741
|
+
};
|
|
7742
|
+
};
|
|
7743
|
+
};
|
|
7744
|
+
/** @description Validation error. */
|
|
7745
|
+
400: {
|
|
7746
|
+
headers: {
|
|
7747
|
+
[name: string]: unknown;
|
|
7748
|
+
};
|
|
7749
|
+
content: {
|
|
7750
|
+
"application/json": components["schemas"]["ErrorResponse"];
|
|
7751
|
+
};
|
|
7752
|
+
};
|
|
7753
|
+
/** @description Missing or invalid credentials. */
|
|
7754
|
+
401: {
|
|
7755
|
+
headers: {
|
|
7756
|
+
[name: string]: unknown;
|
|
7757
|
+
};
|
|
7758
|
+
content: {
|
|
7759
|
+
"application/json": components["schemas"]["ErrorResponse"];
|
|
7760
|
+
};
|
|
7761
|
+
};
|
|
7762
|
+
/** @description Authenticated but lacking the required permission or feature flag. */
|
|
7763
|
+
403: {
|
|
7764
|
+
headers: {
|
|
7765
|
+
[name: string]: unknown;
|
|
7766
|
+
};
|
|
7767
|
+
content: {
|
|
7768
|
+
"application/json": components["schemas"]["ErrorResponse"];
|
|
7769
|
+
};
|
|
7770
|
+
};
|
|
7771
|
+
/** @description Resource not found. */
|
|
7772
|
+
404: {
|
|
7773
|
+
headers: {
|
|
7774
|
+
[name: string]: unknown;
|
|
7775
|
+
};
|
|
7776
|
+
content: {
|
|
7777
|
+
"application/json": components["schemas"]["ErrorResponse"];
|
|
7778
|
+
};
|
|
7779
|
+
};
|
|
7780
|
+
/** @description Body did not match the tool's input schema. */
|
|
7781
|
+
422: {
|
|
7782
|
+
headers: {
|
|
7783
|
+
[name: string]: unknown;
|
|
7784
|
+
};
|
|
7785
|
+
content: {
|
|
7786
|
+
"application/json": components["schemas"]["ErrorResponse"];
|
|
7787
|
+
};
|
|
7788
|
+
};
|
|
7789
|
+
/** @description Server error. */
|
|
7790
|
+
500: {
|
|
7791
|
+
headers: {
|
|
7792
|
+
[name: string]: unknown;
|
|
7793
|
+
};
|
|
7794
|
+
content: {
|
|
7795
|
+
"application/json": components["schemas"]["ErrorResponse"];
|
|
7796
|
+
};
|
|
7797
|
+
};
|
|
7798
|
+
};
|
|
7799
|
+
};
|
|
7419
7800
|
createWhiteboard: {
|
|
7420
7801
|
parameters: {
|
|
7421
7802
|
query?: never;
|
|
@@ -7594,6 +7975,9 @@ export interface operations {
|
|
|
7594
7975
|
requestBody?: {
|
|
7595
7976
|
content: {
|
|
7596
7977
|
"application/json": {
|
|
7978
|
+
/** @description Optional. Narrows a friendly-id lookup to one project. Only needed when a friendly id is ambiguous — TAS-/IMP-/PLN- ids are numbered per PROJECT, so the same id can exist in several. Ignored when the id is a UUID. */
|
|
7979
|
+
projectId?: string;
|
|
7980
|
+
/** @description Accepts either the UUID or the friendly id (e.g. WBD-12); friendly ids are resolved within your organisation. */
|
|
7597
7981
|
documentId: string;
|
|
7598
7982
|
/** @description When true, returns the full Excalidraw scene so it can be modified and written back. */
|
|
7599
7983
|
includeElements?: boolean;
|
|
@@ -7678,6 +8062,8 @@ export interface operations {
|
|
|
7678
8062
|
requestBody?: {
|
|
7679
8063
|
content: {
|
|
7680
8064
|
"application/json": {
|
|
8065
|
+
/** @description Optional. Narrows a friendly-id lookup to one project. Only needed when a friendly id is ambiguous — TAS-/IMP-/PLN- ids are numbered per PROJECT, so the same id can exist in several. Ignored when the id is a UUID. */
|
|
8066
|
+
projectId?: string;
|
|
7681
8067
|
documentId: string;
|
|
7682
8068
|
/** @description Elements to write. For mode 'patch', each may be a partial { id, ...changedFields } merged into the matching element by id; full Excalidraw elements for 'replace'/'append' (or new ids in 'patch'). */
|
|
7683
8069
|
elements?: Record<string, never>[];
|
|
@@ -7777,6 +8163,8 @@ export interface operations {
|
|
|
7777
8163
|
requestBody?: {
|
|
7778
8164
|
content: {
|
|
7779
8165
|
"application/json": {
|
|
8166
|
+
/** @description Optional. Narrows a friendly-id lookup to one project. Only needed when a friendly id is ambiguous — TAS-/IMP-/PLN- ids are numbered per PROJECT, so the same id can exist in several. Ignored when the id is a UUID. */
|
|
8167
|
+
projectId?: string;
|
|
7780
8168
|
documentId: string;
|
|
7781
8169
|
/** @description Non-empty array of shape specs to append. Prefer stencils / sticky notes / architecture icons over raw rectangles wherever a standard form fits (see the `type` enum below and the tool description). */
|
|
7782
8170
|
shapes: ({
|
|
@@ -8068,6 +8456,12 @@ export interface operations {
|
|
|
8068
8456
|
fileName?: string;
|
|
8069
8457
|
/** @description Lock the placed image so it cannot be moved, resized, or deleted by hand (e.g. a deck-owned framed slide image that changes only via the deck conversation). Defaults to false. */
|
|
8070
8458
|
locked?: boolean;
|
|
8459
|
+
/** @description Optional plain-language description of the image, stored on the element for accessibility and so agents reading the board later know what it depicts. */
|
|
8460
|
+
nlDescription?: string;
|
|
8461
|
+
/** @description Arbitrary Excalidraw customData stored on the element (e.g. { deckId } so a board image resolves back to its source deck). Merged with any builder-set customData. */
|
|
8462
|
+
customData?: {
|
|
8463
|
+
[key: string]: unknown;
|
|
8464
|
+
};
|
|
8071
8465
|
};
|
|
8072
8466
|
};
|
|
8073
8467
|
};
|
|
@@ -8157,19 +8551,26 @@ export interface operations {
|
|
|
8157
8551
|
source: string;
|
|
8158
8552
|
/** @description Optional caption shown beneath the diagram. */
|
|
8159
8553
|
caption?: string;
|
|
8160
|
-
/** @description Display width in px (aspect ratio preserved).
|
|
8554
|
+
/** @description Display width in px (aspect ratio preserved). Auto-size caps at 480px; an explicit width is honoured up to 1200px. */
|
|
8161
8555
|
width?: number;
|
|
8162
8556
|
/** @description Display height in px (defaults from width + aspect). */
|
|
8163
8557
|
height?: number;
|
|
8164
|
-
/** @description Top-left x on the canvas. Omit to auto-place. */
|
|
8558
|
+
/** @description Top-left x on the canvas. Omit to auto-place (or to keep the existing position when updateElementId is given). */
|
|
8165
8559
|
x?: number;
|
|
8166
|
-
/** @description Top-left y on the canvas. Omit to auto-place. */
|
|
8560
|
+
/** @description Top-left y on the canvas. Omit to auto-place (or to keep the existing position when updateElementId is given). */
|
|
8167
8561
|
y?: number;
|
|
8168
8562
|
/**
|
|
8169
8563
|
* @description Horizontal alignment relative to existing content (placed below it). Ignored if x/y given.
|
|
8170
8564
|
* @enum {string}
|
|
8171
8565
|
*/
|
|
8172
8566
|
align?: "left" | "center" | "right";
|
|
8567
|
+
/** @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. */
|
|
8568
|
+
updateElementId?: string;
|
|
8569
|
+
/**
|
|
8570
|
+
* @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.
|
|
8571
|
+
* @enum {string}
|
|
8572
|
+
*/
|
|
8573
|
+
fit?: "contain";
|
|
8173
8574
|
};
|
|
8174
8575
|
};
|
|
8175
8576
|
};
|
|
@@ -8355,6 +8756,8 @@ export interface operations {
|
|
|
8355
8756
|
requestBody?: {
|
|
8356
8757
|
content: {
|
|
8357
8758
|
"application/json": {
|
|
8759
|
+
/** @description Optional. Narrows a friendly-id lookup to one project. Only needed when a friendly id is ambiguous — TAS-/IMP-/PLN- ids are numbered per PROJECT, so the same id can exist in several. Ignored when the id is a UUID. */
|
|
8760
|
+
projectId?: string;
|
|
8358
8761
|
/** @description The whiteboard's documentId. */
|
|
8359
8762
|
documentId: string;
|
|
8360
8763
|
/** @description Rows as arrays of cell strings. If headers is omitted, the first row is treated as the header row. */
|
|
@@ -8541,7 +8944,9 @@ export interface operations {
|
|
|
8541
8944
|
requestBody?: {
|
|
8542
8945
|
content: {
|
|
8543
8946
|
"application/json": {
|
|
8544
|
-
/** @description
|
|
8947
|
+
/** @description Optional. Narrows a friendly-id lookup to one project. Only needed when a friendly id is ambiguous — TAS-/IMP-/PLN- ids are numbered per PROJECT, so the same id can exist in several. Ignored when the id is a UUID. */
|
|
8948
|
+
projectId?: string;
|
|
8949
|
+
/** @description The whiteboard's documentId. Accepts either the UUID or the friendly id (e.g. WBD-12); friendly ids are resolved within your organisation. */
|
|
8545
8950
|
documentId: string;
|
|
8546
8951
|
/** @description Render only these element ids (plus their bound labels + group peers) instead of the whole board. */
|
|
8547
8952
|
elementIds?: string[];
|
|
@@ -8645,6 +9050,8 @@ export interface operations {
|
|
|
8645
9050
|
content: {
|
|
8646
9051
|
"application/json": {
|
|
8647
9052
|
documentId: string;
|
|
9053
|
+
/** @description Optional. Narrows a friendly-id lookup to one project. Ignored when documentId is a UUID. */
|
|
9054
|
+
projectId?: string;
|
|
8648
9055
|
};
|
|
8649
9056
|
};
|
|
8650
9057
|
};
|
|
@@ -9001,10 +9408,13 @@ export interface operations {
|
|
|
9001
9408
|
requestBody?: {
|
|
9002
9409
|
content: {
|
|
9003
9410
|
"application/json": {
|
|
9004
|
-
/** @description
|
|
9411
|
+
/** @description Documents to file. All must belong to the same project (a batch spanning projects is rejected). */
|
|
9005
9412
|
items: {
|
|
9006
9413
|
documentId: string;
|
|
9414
|
+
/** @description Sort position among siblings. Non-negative integer. */
|
|
9007
9415
|
position: number;
|
|
9416
|
+
/** @description Optional. MOVE the document into this folder; null moves it to the project root. Omit to leave its current folder untouched. The folder must exist and belong to the same project. */
|
|
9417
|
+
folderId?: string | null;
|
|
9008
9418
|
}[];
|
|
9009
9419
|
};
|
|
9010
9420
|
};
|
|
@@ -9087,6 +9497,9 @@ export interface operations {
|
|
|
9087
9497
|
requestBody?: {
|
|
9088
9498
|
content: {
|
|
9089
9499
|
"application/json": {
|
|
9500
|
+
/** @description Optional. Narrows a friendly-id lookup to one project. Only needed when a friendly id is ambiguous — TAS-/IMP-/PLN- ids are numbered per PROJECT, so the same id can exist in several. Ignored when the id is a UUID. */
|
|
9501
|
+
projectId?: string;
|
|
9502
|
+
/** @description Accepts either the UUID or the friendly id (e.g. DOC-815); friendly ids are resolved within your organisation. */
|
|
9090
9503
|
documentId: string;
|
|
9091
9504
|
/** @description Filter to a specific version. */
|
|
9092
9505
|
versionNumber?: number;
|
|
@@ -9267,6 +9680,8 @@ export interface operations {
|
|
|
9267
9680
|
requestBody?: {
|
|
9268
9681
|
content: {
|
|
9269
9682
|
"application/json": {
|
|
9683
|
+
/** @description Optional. Narrows a friendly-id lookup to one project. Only needed when a friendly id is ambiguous — TAS-/IMP-/PLN- ids are numbered per PROJECT, so the same id can exist in several. Ignored when the id is a UUID. */
|
|
9684
|
+
projectId?: string;
|
|
9270
9685
|
documentId: string;
|
|
9271
9686
|
/** @description Original filename (e.g. screenshot.png). */
|
|
9272
9687
|
fileName: string;
|
|
@@ -9355,9 +9770,11 @@ export interface operations {
|
|
|
9355
9770
|
requestBody?: {
|
|
9356
9771
|
content: {
|
|
9357
9772
|
"application/json": {
|
|
9773
|
+
/** @description Optional. Narrows a friendly-id lookup to one project. Only needed when a friendly id is ambiguous — TAS-/IMP-/PLN- ids are numbered per PROJECT, so the same id can exist in several. Ignored when the id is a UUID. */
|
|
9774
|
+
projectId?: string;
|
|
9358
9775
|
documentId: string;
|
|
9359
|
-
/** @description
|
|
9360
|
-
documentVersionTimestamp
|
|
9776
|
+
/** @description Optimistic-lock token: the document's versionTimestamp from getDocument() or any mutating tool's response. (Alias accepted: versionTimestamp.) */
|
|
9777
|
+
documentVersionTimestamp?: number;
|
|
9361
9778
|
/** @description Base64-encoded image data. Mutually exclusive with imageBinary/imageUrl. */
|
|
9362
9779
|
imageBase64?: string;
|
|
9363
9780
|
/** @description Raw binary as byte array. Mutually exclusive with imageBase64/imageUrl. */
|
|
@@ -9466,8 +9883,8 @@ export interface operations {
|
|
|
9466
9883
|
"application/json": {
|
|
9467
9884
|
/** @description Image ID from IMAGE_OMITTED markers. */
|
|
9468
9885
|
imageId: string;
|
|
9469
|
-
/** @description
|
|
9470
|
-
documentVersionTimestamp
|
|
9886
|
+
/** @description Optimistic-lock token: the document's versionTimestamp from getDocument() or any mutating tool's response. (Alias accepted: versionTimestamp.) */
|
|
9887
|
+
documentVersionTimestamp?: number;
|
|
9471
9888
|
/** @description New alt text. */
|
|
9472
9889
|
alt?: string;
|
|
9473
9890
|
/** @description New image description. */
|
|
@@ -9647,6 +10064,8 @@ export interface operations {
|
|
|
9647
10064
|
requestBody?: {
|
|
9648
10065
|
content: {
|
|
9649
10066
|
"application/json": {
|
|
10067
|
+
/** @description Optional. Narrows a friendly-id lookup to one project. Only needed when a friendly id is ambiguous — TAS-/IMP-/PLN- ids are numbered per PROJECT, so the same id can exist in several. Ignored when the id is a UUID. */
|
|
10068
|
+
projectId?: string;
|
|
9650
10069
|
documentId: string;
|
|
9651
10070
|
/** @description Original filename (e.g. sales-data.csv). Extension auto-detects content type. */
|
|
9652
10071
|
fileName: string;
|
|
@@ -9733,6 +10152,8 @@ export interface operations {
|
|
|
9733
10152
|
requestBody?: {
|
|
9734
10153
|
content: {
|
|
9735
10154
|
"application/json": {
|
|
10155
|
+
/** @description Optional. Narrows a friendly-id lookup to one project. Only needed when a friendly id is ambiguous — TAS-/IMP-/PLN- ids are numbered per PROJECT, so the same id can exist in several. Ignored when the id is a UUID. */
|
|
10156
|
+
projectId?: string;
|
|
9736
10157
|
documentId: string;
|
|
9737
10158
|
/** @description Attachment ID to delete. */
|
|
9738
10159
|
attachmentId: string;
|
|
@@ -10197,6 +10618,9 @@ export interface operations {
|
|
|
10197
10618
|
requestBody?: {
|
|
10198
10619
|
content: {
|
|
10199
10620
|
"application/json": {
|
|
10621
|
+
/** @description Optional. Narrows a friendly-id lookup to one project. Only needed when a friendly id is ambiguous — TAS-/IMP-/PLN- ids are numbered per PROJECT, so the same id can exist in several. Ignored when the id is a UUID. */
|
|
10622
|
+
projectId?: string;
|
|
10623
|
+
/** @description Accepts either the UUID or the friendly id (e.g. IMP-42); friendly ids are resolved within your organisation. */
|
|
10200
10624
|
improvementId: string;
|
|
10201
10625
|
};
|
|
10202
10626
|
};
|
|
@@ -10281,7 +10705,7 @@ export interface operations {
|
|
|
10281
10705
|
"application/json": {
|
|
10282
10706
|
projectId: string;
|
|
10283
10707
|
title: string;
|
|
10284
|
-
/** @description Type. Default: enhancement. Valid values: feature, bug, tech_debt, architecture_gap, documentation_gap, risk, enhancement, task. Setting type='task' makes the row a task (TAS- prefix); any other type makes it a non-task improvement (IMP- prefix). */
|
|
10708
|
+
/** @description Type. Default: enhancement. Valid values: feature, bug, tech_debt, architecture_gap, documentation_gap, risk, enhancement, task. Despite the tool's name there is no 'improvement' value — pass it and it is accepted as an alias for 'enhancement', which is also the default. Setting type='task' makes the row a task (TAS- prefix); any other type makes it a non-task improvement (IMP- prefix). */
|
|
10285
10709
|
type?: string;
|
|
10286
10710
|
/** @description Priority. Default: medium. */
|
|
10287
10711
|
priority?: string;
|
|
@@ -10303,6 +10727,12 @@ export interface operations {
|
|
|
10303
10727
|
/** @description Optional — server mints one if omitted. Preserve on edits. */
|
|
10304
10728
|
id?: string;
|
|
10305
10729
|
text: string;
|
|
10730
|
+
/** @description Server-stamped. Echo back unchanged; ignored on new rows. */
|
|
10731
|
+
updated_at?: string;
|
|
10732
|
+
/** @description Server-stamped user id. Echo back unchanged. */
|
|
10733
|
+
updated_by?: string;
|
|
10734
|
+
/** @description Server-stamped credential label. Echo back unchanged. */
|
|
10735
|
+
updated_by_credential_name?: string;
|
|
10306
10736
|
}[];
|
|
10307
10737
|
/** @description Tick-box checklist shown above acceptance_criteria. The full array REPLACES the stored list on update, and array order = display order — to edit, fetch via getTask/getImprovement, modify, and send back the whole list. Operations: mark done with `completed: true`; un-mark with `completed: false`; add rows by appending `{ text }` (id is auto-minted); remove by omitting; reorder by rearranging. Echo back each existing `id` you keep so per-row attribution (who added/completed it, when) survives. */
|
|
10308
10738
|
checklist?: {
|
|
@@ -10313,6 +10743,18 @@ export interface operations {
|
|
|
10313
10743
|
due_date?: string;
|
|
10314
10744
|
/** @description true = ticked, false/omitted = not done. Server stamps timestamp + actor. */
|
|
10315
10745
|
completed?: boolean;
|
|
10746
|
+
/** @description Server-stamped ISO timestamp. Prefer `completed`; an explicit value here wins if both are sent. */
|
|
10747
|
+
completed_at?: string;
|
|
10748
|
+
/** @description Server-stamped user id. Echo back unchanged. */
|
|
10749
|
+
completed_by?: string;
|
|
10750
|
+
/** @description Server-stamped credential label. Echo back unchanged. */
|
|
10751
|
+
completed_by_credential_name?: string;
|
|
10752
|
+
/** @description Server-stamped. Echo back unchanged; ignored on new rows. */
|
|
10753
|
+
updated_at?: string;
|
|
10754
|
+
/** @description Server-stamped user id. Echo back unchanged. */
|
|
10755
|
+
updated_by?: string;
|
|
10756
|
+
/** @description Server-stamped credential label. Echo back unchanged. */
|
|
10757
|
+
updated_by_credential_name?: string;
|
|
10316
10758
|
}[];
|
|
10317
10759
|
constraints?: string[];
|
|
10318
10760
|
non_goals?: string[];
|
|
@@ -10352,6 +10794,12 @@ export interface operations {
|
|
|
10352
10794
|
wbs_code?: string;
|
|
10353
10795
|
/** @description Progress percentage (0-100). Null means not tracked. */
|
|
10354
10796
|
percent_complete?: number;
|
|
10797
|
+
source_channel?: string;
|
|
10798
|
+
impacted_repositories?: string[];
|
|
10799
|
+
/** @description Free-form JSON for logical links: blocks, blocked_by, duplicates, supersedes, relates_to (arrays of item IDs). */
|
|
10800
|
+
relationships?: Record<string, never>;
|
|
10801
|
+
/** @description Free-form JSON stored alongside the item. On updateImprovement this MERGES rather than replaces. */
|
|
10802
|
+
metadata?: Record<string, never>;
|
|
10355
10803
|
};
|
|
10356
10804
|
};
|
|
10357
10805
|
};
|
|
@@ -10433,6 +10881,8 @@ export interface operations {
|
|
|
10433
10881
|
requestBody?: {
|
|
10434
10882
|
content: {
|
|
10435
10883
|
"application/json": {
|
|
10884
|
+
/** @description Optional. Narrows a friendly-id lookup to one project. Only needed when a friendly id is ambiguous — TAS-/IMP-/PLN- ids are numbered per PROJECT, so the same id can exist in several. Ignored when the id is a UUID. */
|
|
10885
|
+
projectId?: string;
|
|
10436
10886
|
improvementId: string;
|
|
10437
10887
|
/** @description Version timestamp from getImprovement() for optimistic locking. */
|
|
10438
10888
|
versionTimestamp: number;
|
|
@@ -10463,6 +10913,12 @@ export interface operations {
|
|
|
10463
10913
|
/** @description Optional — server mints one if omitted. Preserve on edits. */
|
|
10464
10914
|
id?: string;
|
|
10465
10915
|
text: string;
|
|
10916
|
+
/** @description Server-stamped. Echo back unchanged; ignored on new rows. */
|
|
10917
|
+
updated_at?: string;
|
|
10918
|
+
/** @description Server-stamped user id. Echo back unchanged. */
|
|
10919
|
+
updated_by?: string;
|
|
10920
|
+
/** @description Server-stamped credential label. Echo back unchanged. */
|
|
10921
|
+
updated_by_credential_name?: string;
|
|
10466
10922
|
}[];
|
|
10467
10923
|
/** @description Tick-box checklist shown above acceptance_criteria. The full array REPLACES the stored list on update, and array order = display order — to edit, fetch via getTask/getImprovement, modify, and send back the whole list. Operations: mark done with `completed: true`; un-mark with `completed: false`; add rows by appending `{ text }` (id is auto-minted); remove by omitting; reorder by rearranging. Echo back each existing `id` you keep so per-row attribution (who added/completed it, when) survives. */
|
|
10468
10924
|
checklist?: {
|
|
@@ -10473,6 +10929,18 @@ export interface operations {
|
|
|
10473
10929
|
due_date?: string;
|
|
10474
10930
|
/** @description true = ticked, false/omitted = not done. Server stamps timestamp + actor. */
|
|
10475
10931
|
completed?: boolean;
|
|
10932
|
+
/** @description Server-stamped ISO timestamp. Prefer `completed`; an explicit value here wins if both are sent. */
|
|
10933
|
+
completed_at?: string;
|
|
10934
|
+
/** @description Server-stamped user id. Echo back unchanged. */
|
|
10935
|
+
completed_by?: string;
|
|
10936
|
+
/** @description Server-stamped credential label. Echo back unchanged. */
|
|
10937
|
+
completed_by_credential_name?: string;
|
|
10938
|
+
/** @description Server-stamped. Echo back unchanged; ignored on new rows. */
|
|
10939
|
+
updated_at?: string;
|
|
10940
|
+
/** @description Server-stamped user id. Echo back unchanged. */
|
|
10941
|
+
updated_by?: string;
|
|
10942
|
+
/** @description Server-stamped credential label. Echo back unchanged. */
|
|
10943
|
+
updated_by_credential_name?: string;
|
|
10476
10944
|
}[];
|
|
10477
10945
|
constraints?: string[];
|
|
10478
10946
|
non_goals?: string[];
|
|
@@ -10498,11 +10966,14 @@ export interface operations {
|
|
|
10498
10966
|
rejection_comment?: string;
|
|
10499
10967
|
/** @description Required when status=done. */
|
|
10500
10968
|
completion_comment?: string;
|
|
10501
|
-
/** @description Required when
|
|
10969
|
+
/** @description Required when moving OUT of a closed status. The closed set is blocked, done, rejected and deferred — note that `blocked` counts as closed, so blocked -> in_progress needs this comment. */
|
|
10502
10970
|
reopened_comment?: string;
|
|
10503
|
-
/** @description Free-form JSON for logical links: blocks, blocked_by, duplicates, supersedes, relates_to (arrays of item IDs). */
|
|
10971
|
+
/** @description Free-form JSON for logical links: blocks, blocked_by, duplicates, supersedes, relates_to (arrays of item IDs). REPLACES the stored object wholesale — read it first and send the complete set. */
|
|
10504
10972
|
relationships?: Record<string, never>;
|
|
10973
|
+
/** @description Free-form JSON. MERGES into the stored object key by key: keys you don't send are left alone, and sending a key with value null deletes it. Send metadata_replace:true to overwrite the whole object instead. (Merging is the default so a partial write can never destroy a sibling key written by another actor.) */
|
|
10505
10974
|
metadata?: Record<string, never>;
|
|
10975
|
+
/** @description Opt out of the metadata merge: true means the object you send REPLACES everything stored, deleting any key you omit. Default false. */
|
|
10976
|
+
metadata_replace?: boolean;
|
|
10506
10977
|
/** @description Link to plan. Null to unlink. */
|
|
10507
10978
|
plan_id?: string;
|
|
10508
10979
|
/** @description Assign to phase. Null to unassign. */
|
|
@@ -10594,6 +11065,8 @@ export interface operations {
|
|
|
10594
11065
|
requestBody?: {
|
|
10595
11066
|
content: {
|
|
10596
11067
|
"application/json": {
|
|
11068
|
+
/** @description Optional. Narrows a friendly-id lookup to one project. Only needed when a friendly id is ambiguous — TAS-/IMP-/PLN- ids are numbered per PROJECT, so the same id can exist in several. Ignored when the id is a UUID. */
|
|
11069
|
+
projectId?: string;
|
|
10597
11070
|
improvementId: string;
|
|
10598
11071
|
};
|
|
10599
11072
|
};
|
|
@@ -11108,6 +11581,8 @@ export interface operations {
|
|
|
11108
11581
|
requestBody?: {
|
|
11109
11582
|
content: {
|
|
11110
11583
|
"application/json": {
|
|
11584
|
+
/** @description Optional. Narrows a friendly-id lookup to one project. Only needed when a friendly id is ambiguous — TAS-/IMP-/PLN- ids are numbered per PROJECT, so the same id can exist in several. Ignored when the id is a UUID. */
|
|
11585
|
+
projectId?: string;
|
|
11111
11586
|
improvementId: string;
|
|
11112
11587
|
/** @description Summary of the evidence. */
|
|
11113
11588
|
summary: string;
|
|
@@ -11202,6 +11677,8 @@ export interface operations {
|
|
|
11202
11677
|
requestBody?: {
|
|
11203
11678
|
content: {
|
|
11204
11679
|
"application/json": {
|
|
11680
|
+
/** @description Optional. Narrows a friendly-id lookup to one project. Only needed when a friendly id is ambiguous — TAS-/IMP-/PLN- ids are numbered per PROJECT, so the same id can exist in several. Ignored when the id is a UUID. */
|
|
11681
|
+
projectId?: string;
|
|
11205
11682
|
improvementId: string;
|
|
11206
11683
|
/** @description Type: comment, agent_update, field_change. Default: comment. */
|
|
11207
11684
|
activityType?: string;
|
|
@@ -11661,6 +12138,9 @@ export interface operations {
|
|
|
11661
12138
|
requestBody?: {
|
|
11662
12139
|
content: {
|
|
11663
12140
|
"application/json": {
|
|
12141
|
+
/** @description Optional. Narrows a friendly-id lookup to one project. Only needed when a friendly id is ambiguous — TAS-/IMP-/PLN- ids are numbered per PROJECT, so the same id can exist in several. Ignored when the id is a UUID. */
|
|
12142
|
+
projectId?: string;
|
|
12143
|
+
/** @description Accepts either the UUID or the friendly id (e.g. PLN-3); friendly ids are resolved within your organisation. */
|
|
11664
12144
|
planId: string;
|
|
11665
12145
|
};
|
|
11666
12146
|
};
|
|
@@ -11843,6 +12323,8 @@ export interface operations {
|
|
|
11843
12323
|
requestBody?: {
|
|
11844
12324
|
content: {
|
|
11845
12325
|
"application/json": {
|
|
12326
|
+
/** @description Optional. Narrows a friendly-id lookup to one project. Only needed when a friendly id is ambiguous — TAS-/IMP-/PLN- ids are numbered per PROJECT, so the same id can exist in several. Ignored when the id is a UUID. */
|
|
12327
|
+
projectId?: string;
|
|
11846
12328
|
planId: string;
|
|
11847
12329
|
/** @description Version timestamp from getPlan() for optimistic locking. */
|
|
11848
12330
|
versionTimestamp: number;
|
|
@@ -11943,6 +12425,8 @@ export interface operations {
|
|
|
11943
12425
|
requestBody?: {
|
|
11944
12426
|
content: {
|
|
11945
12427
|
"application/json": {
|
|
12428
|
+
/** @description Optional. Narrows a friendly-id lookup to one project. Only needed when a friendly id is ambiguous — TAS-/IMP-/PLN- ids are numbered per PROJECT, so the same id can exist in several. Ignored when the id is a UUID. */
|
|
12429
|
+
projectId?: string;
|
|
11946
12430
|
planId: string;
|
|
11947
12431
|
};
|
|
11948
12432
|
};
|
|
@@ -12107,6 +12591,9 @@ export interface operations {
|
|
|
12107
12591
|
requestBody?: {
|
|
12108
12592
|
content: {
|
|
12109
12593
|
"application/json": {
|
|
12594
|
+
/** @description Optional. Narrows a friendly-id lookup to one project. Only needed when a friendly id is ambiguous — TAS-/IMP-/PLN- ids are numbered per PROJECT, so the same id can exist in several. Ignored when the id is a UUID. */
|
|
12595
|
+
projectId?: string;
|
|
12596
|
+
/** @description Accepts either the UUID or the friendly id (e.g. PHA-7); friendly ids are resolved within your organisation. */
|
|
12110
12597
|
phaseId: string;
|
|
12111
12598
|
};
|
|
12112
12599
|
};
|
|
@@ -12290,6 +12777,8 @@ export interface operations {
|
|
|
12290
12777
|
requestBody?: {
|
|
12291
12778
|
content: {
|
|
12292
12779
|
"application/json": {
|
|
12780
|
+
/** @description Optional. Narrows a friendly-id lookup to one project. Only needed when a friendly id is ambiguous — TAS-/IMP-/PLN- ids are numbered per PROJECT, so the same id can exist in several. Ignored when the id is a UUID. */
|
|
12781
|
+
projectId?: string;
|
|
12293
12782
|
phaseId: string;
|
|
12294
12783
|
/** @description Version timestamp from getPlanPhase() for optimistic locking. */
|
|
12295
12784
|
versionTimestamp: number;
|
|
@@ -12389,6 +12878,8 @@ export interface operations {
|
|
|
12389
12878
|
requestBody?: {
|
|
12390
12879
|
content: {
|
|
12391
12880
|
"application/json": {
|
|
12881
|
+
/** @description Optional. Narrows a friendly-id lookup to one project. Only needed when a friendly id is ambiguous — TAS-/IMP-/PLN- ids are numbered per PROJECT, so the same id can exist in several. Ignored when the id is a UUID. */
|
|
12882
|
+
projectId?: string;
|
|
12392
12883
|
phaseId: string;
|
|
12393
12884
|
};
|
|
12394
12885
|
};
|
|
@@ -12557,6 +13048,8 @@ export interface operations {
|
|
|
12557
13048
|
requestBody?: {
|
|
12558
13049
|
content: {
|
|
12559
13050
|
"application/json": {
|
|
13051
|
+
/** @description Optional. Narrows a friendly-id lookup to one project. Only needed when a friendly id is ambiguous — TAS-/IMP-/PLN- ids are numbered per PROJECT, so the same id can exist in several. Ignored when the id is a UUID. */
|
|
13052
|
+
projectId?: string;
|
|
12560
13053
|
planId: string;
|
|
12561
13054
|
/** @description Type: comment, agent_update, field_change. Default: comment. */
|
|
12562
13055
|
activityType?: string;
|
|
@@ -12826,17 +13319,35 @@ export interface operations {
|
|
|
12826
13319
|
/** @description Phase to assign to. */
|
|
12827
13320
|
phaseId?: string;
|
|
12828
13321
|
description?: string;
|
|
12829
|
-
/** @description Type. Default: task. Tasks created in plans are typed 'task' (friendly_id prefix TAS-). Override only if you want the row to appear as a non-task improvement (IMP- prefix). */
|
|
13322
|
+
/** @description Type. Default: task. Tasks created in plans are typed 'task' (friendly_id prefix TAS-). Override only if you want the row to appear as a non-task improvement (IMP- prefix). Valid values: feature, bug, tech_debt, architecture_gap, documentation_gap, risk, enhancement, task. */
|
|
12830
13323
|
type?: string;
|
|
12831
13324
|
/** @description Initial status. Default: captured. */
|
|
12832
13325
|
status?: string;
|
|
12833
13326
|
/** @description Priority. Default: medium. */
|
|
12834
13327
|
priority?: string;
|
|
13328
|
+
/** @description e.g. this_week, this_month, this_quarter. */
|
|
13329
|
+
urgency?: string;
|
|
13330
|
+
/** @description Where this task came from (free text, e.g. 'meeting', 'compliance-scan'). Stored for provenance and shown in the improvement/task record. */
|
|
13331
|
+
source?: string;
|
|
13332
|
+
source_channel?: string;
|
|
13333
|
+
/** @description Category ID. */
|
|
13334
|
+
category_id?: string;
|
|
13335
|
+
problem_statement?: string;
|
|
13336
|
+
desired_outcome?: string;
|
|
13337
|
+
business_impact?: string;
|
|
13338
|
+
user_impact?: string;
|
|
13339
|
+
why_now?: string;
|
|
12835
13340
|
/** @description Acceptance criteria — ordered list of pass/fail statements that define "done" for this item. Each row is `{ id, text }` with server-stamped `updated_at / updated_by / updated_by_credential_name`. REPLACES the whole array on update. Echo back existing `id`s on rows you keep so attribution stamps survive. Bare strings are accepted for convenience (e.g. `["row 1", "row 2"]`) and auto-converted to `{ id, text }`. */
|
|
12836
13341
|
acceptance_criteria?: {
|
|
12837
13342
|
/** @description Optional — server mints one if omitted. Preserve on edits. */
|
|
12838
13343
|
id?: string;
|
|
12839
13344
|
text: string;
|
|
13345
|
+
/** @description Server-stamped. Echo back unchanged; ignored on new rows. */
|
|
13346
|
+
updated_at?: string;
|
|
13347
|
+
/** @description Server-stamped user id. Echo back unchanged. */
|
|
13348
|
+
updated_by?: string;
|
|
13349
|
+
/** @description Server-stamped credential label. Echo back unchanged. */
|
|
13350
|
+
updated_by_credential_name?: string;
|
|
12840
13351
|
}[];
|
|
12841
13352
|
/** @description Tick-box checklist shown above acceptance_criteria. The full array REPLACES the stored list on update, and array order = display order — to edit, fetch via getTask/getImprovement, modify, and send back the whole list. Operations: mark done with `completed: true`; un-mark with `completed: false`; add rows by appending `{ text }` (id is auto-minted); remove by omitting; reorder by rearranging. Echo back each existing `id` you keep so per-row attribution (who added/completed it, when) survives. */
|
|
12842
13353
|
checklist?: {
|
|
@@ -12847,7 +13358,37 @@ export interface operations {
|
|
|
12847
13358
|
due_date?: string;
|
|
12848
13359
|
/** @description true = ticked, false/omitted = not done. Server stamps timestamp + actor. */
|
|
12849
13360
|
completed?: boolean;
|
|
13361
|
+
/** @description Server-stamped ISO timestamp. Prefer `completed`; an explicit value here wins if both are sent. */
|
|
13362
|
+
completed_at?: string;
|
|
13363
|
+
/** @description Server-stamped user id. Echo back unchanged. */
|
|
13364
|
+
completed_by?: string;
|
|
13365
|
+
/** @description Server-stamped credential label. Echo back unchanged. */
|
|
13366
|
+
completed_by_credential_name?: string;
|
|
13367
|
+
/** @description Server-stamped. Echo back unchanged; ignored on new rows. */
|
|
13368
|
+
updated_at?: string;
|
|
13369
|
+
/** @description Server-stamped user id. Echo back unchanged. */
|
|
13370
|
+
updated_by?: string;
|
|
13371
|
+
/** @description Server-stamped credential label. Echo back unchanged. */
|
|
13372
|
+
updated_by_credential_name?: string;
|
|
12850
13373
|
}[];
|
|
13374
|
+
constraints?: string[];
|
|
13375
|
+
non_goals?: string[];
|
|
13376
|
+
/** @description Array of {id, title}. */
|
|
13377
|
+
impacted_documents?: Record<string, never>[];
|
|
13378
|
+
/** @description Document IDs to link. Titles resolved automatically. */
|
|
13379
|
+
linked_document_ids?: string[];
|
|
13380
|
+
/** @description Array of {id, name}. */
|
|
13381
|
+
impacted_diagrams?: Record<string, never>[];
|
|
13382
|
+
impacted_components?: string[];
|
|
13383
|
+
impacted_repositories?: string[];
|
|
13384
|
+
agent_ready?: boolean;
|
|
13385
|
+
agent_missing_info?: string[];
|
|
13386
|
+
agent_recommended_action?: string;
|
|
13387
|
+
/** @description low, medium, high, very_high. */
|
|
13388
|
+
agent_complexity?: string;
|
|
13389
|
+
/** @description 0.00 to 1.00. */
|
|
13390
|
+
agent_confidence?: number;
|
|
13391
|
+
agent_brief?: string;
|
|
12851
13392
|
/** @description User UUID to assign as owner. MUTUALLY EXCLUSIVE with owner_team_id. Use listAssignablePrincipals(projectId, kind='user') to look up valid UUIDs. */
|
|
12852
13393
|
owner_id?: string;
|
|
12853
13394
|
/** @description Team UUID to assign as owner (assigns the whole team). MUTUALLY EXCLUSIVE with owner_id. Use listTeams or listAssignablePrincipals(kind='team') to look up valid UUIDs. */
|
|
@@ -12862,6 +13403,10 @@ export interface operations {
|
|
|
12862
13403
|
position?: number;
|
|
12863
13404
|
/** @description Progress percentage (0-100). Null means not tracked. */
|
|
12864
13405
|
percent_complete?: number;
|
|
13406
|
+
/** @description Free-form JSON for logical links: blocks, blocked_by, duplicates, supersedes, relates_to (arrays of item IDs). */
|
|
13407
|
+
relationships?: Record<string, never>;
|
|
13408
|
+
/** @description Free-form JSON stored alongside the task. On updateTask this MERGES rather than replaces. */
|
|
13409
|
+
metadata?: Record<string, never>;
|
|
12865
13410
|
};
|
|
12866
13411
|
};
|
|
12867
13412
|
};
|
|
@@ -13045,6 +13590,9 @@ export interface operations {
|
|
|
13045
13590
|
requestBody?: {
|
|
13046
13591
|
content: {
|
|
13047
13592
|
"application/json": {
|
|
13593
|
+
/** @description Optional. Narrows a friendly-id lookup to one project. Only needed when a friendly id is ambiguous — TAS-/IMP-/PLN- ids are numbered per PROJECT, so the same id can exist in several. Ignored when the id is a UUID. */
|
|
13594
|
+
projectId?: string;
|
|
13595
|
+
/** @description Accepts either the UUID or the friendly id (e.g. TAS-176); friendly ids are resolved within your organisation. */
|
|
13048
13596
|
taskId: string;
|
|
13049
13597
|
};
|
|
13050
13598
|
};
|
|
@@ -13127,6 +13675,8 @@ export interface operations {
|
|
|
13127
13675
|
requestBody?: {
|
|
13128
13676
|
content: {
|
|
13129
13677
|
"application/json": {
|
|
13678
|
+
/** @description Optional. Narrows a friendly-id lookup to one project. Only needed when a friendly id is ambiguous — TAS-/IMP-/PLN- ids are numbered per PROJECT, so the same id can exist in several. Ignored when the id is a UUID. */
|
|
13679
|
+
projectId?: string;
|
|
13130
13680
|
taskId: string;
|
|
13131
13681
|
/** @description Version timestamp from getTask() for optimistic locking. */
|
|
13132
13682
|
versionTimestamp: number;
|
|
@@ -13160,6 +13710,12 @@ export interface operations {
|
|
|
13160
13710
|
/** @description Optional — server mints one if omitted. Preserve on edits. */
|
|
13161
13711
|
id?: string;
|
|
13162
13712
|
text: string;
|
|
13713
|
+
/** @description Server-stamped. Echo back unchanged; ignored on new rows. */
|
|
13714
|
+
updated_at?: string;
|
|
13715
|
+
/** @description Server-stamped user id. Echo back unchanged. */
|
|
13716
|
+
updated_by?: string;
|
|
13717
|
+
/** @description Server-stamped credential label. Echo back unchanged. */
|
|
13718
|
+
updated_by_credential_name?: string;
|
|
13163
13719
|
}[];
|
|
13164
13720
|
/** @description Tick-box checklist shown above acceptance_criteria. The full array REPLACES the stored list on update, and array order = display order — to edit, fetch via getTask/getImprovement, modify, and send back the whole list. Operations: mark done with `completed: true`; un-mark with `completed: false`; add rows by appending `{ text }` (id is auto-minted); remove by omitting; reorder by rearranging. Echo back each existing `id` you keep so per-row attribution (who added/completed it, when) survives. */
|
|
13165
13721
|
checklist?: {
|
|
@@ -13170,6 +13726,18 @@ export interface operations {
|
|
|
13170
13726
|
due_date?: string;
|
|
13171
13727
|
/** @description true = ticked, false/omitted = not done. Server stamps timestamp + actor. */
|
|
13172
13728
|
completed?: boolean;
|
|
13729
|
+
/** @description Server-stamped ISO timestamp. Prefer `completed`; an explicit value here wins if both are sent. */
|
|
13730
|
+
completed_at?: string;
|
|
13731
|
+
/** @description Server-stamped user id. Echo back unchanged. */
|
|
13732
|
+
completed_by?: string;
|
|
13733
|
+
/** @description Server-stamped credential label. Echo back unchanged. */
|
|
13734
|
+
completed_by_credential_name?: string;
|
|
13735
|
+
/** @description Server-stamped. Echo back unchanged; ignored on new rows. */
|
|
13736
|
+
updated_at?: string;
|
|
13737
|
+
/** @description Server-stamped user id. Echo back unchanged. */
|
|
13738
|
+
updated_by?: string;
|
|
13739
|
+
/** @description Server-stamped credential label. Echo back unchanged. */
|
|
13740
|
+
updated_by_credential_name?: string;
|
|
13173
13741
|
}[];
|
|
13174
13742
|
constraints?: string[];
|
|
13175
13743
|
non_goals?: string[];
|
|
@@ -13195,11 +13763,14 @@ export interface operations {
|
|
|
13195
13763
|
rejection_comment?: string;
|
|
13196
13764
|
/** @description Required when status=done. */
|
|
13197
13765
|
completion_comment?: string;
|
|
13198
|
-
/** @description Required when
|
|
13766
|
+
/** @description Required when moving OUT of a closed status. The closed set is blocked, done, rejected and deferred — note that `blocked` counts as closed, so blocked -> in_progress needs this comment. */
|
|
13199
13767
|
reopened_comment?: string;
|
|
13200
|
-
/** @description Free-form JSON for logical links: blocks, blocked_by, duplicates, supersedes, relates_to (arrays of item IDs). */
|
|
13768
|
+
/** @description Free-form JSON for logical links: blocks, blocked_by, duplicates, supersedes, relates_to (arrays of item IDs). REPLACES the stored object wholesale — read it first and send the complete set. */
|
|
13201
13769
|
relationships?: Record<string, never>;
|
|
13770
|
+
/** @description Free-form JSON. MERGES into the stored object key by key: keys you don't send are left alone, and sending a key with value null deletes it. Send metadata_replace:true to overwrite the whole object instead. (Merging is the default so a partial write can never destroy a sibling key written by another actor.) */
|
|
13202
13771
|
metadata?: Record<string, never>;
|
|
13772
|
+
/** @description Opt out of the metadata merge: true means the object you send REPLACES everything stored, deleting any key you omit. Default false. */
|
|
13773
|
+
metadata_replace?: boolean;
|
|
13203
13774
|
/** @description Link to plan. Null to unlink. */
|
|
13204
13775
|
plan_id?: string;
|
|
13205
13776
|
/** @description Assign to phase. Null to unassign. */
|
|
@@ -13285,6 +13856,9 @@ export interface operations {
|
|
|
13285
13856
|
requestBody?: {
|
|
13286
13857
|
content: {
|
|
13287
13858
|
"application/json": {
|
|
13859
|
+
/** @description Optional. Narrows a friendly-id lookup to one project. Only needed when a friendly id is ambiguous — TAS-/IMP-/PLN- ids are numbered per PROJECT, so the same id can exist in several. Ignored when the id is a UUID. */
|
|
13860
|
+
projectId?: string;
|
|
13861
|
+
/** @description Accepts either the UUID or the friendly id (e.g. PLN-3); friendly ids are resolved within your organisation. */
|
|
13288
13862
|
planId: string;
|
|
13289
13863
|
};
|
|
13290
13864
|
};
|
|
@@ -14149,7 +14723,9 @@ export interface operations {
|
|
|
14149
14723
|
* @enum {string}
|
|
14150
14724
|
*/
|
|
14151
14725
|
mode?: "local" | "global" | "graph" | "path" | "ppr";
|
|
14726
|
+
/** @description STRONGLY RECOMMENDED — in practice required. The KG is scoped per project/workspace and there is usually no organisation-wide default, so a call with no projectId and no workspaceId typically matches no scope rule and returns nothing useful. Use listProjects to find the id. */
|
|
14152
14727
|
projectId?: string;
|
|
14728
|
+
/** @description Alternative to projectId — searches the whole workspace subtree. Give one of the two. */
|
|
14153
14729
|
workspaceId?: string;
|
|
14154
14730
|
/** @description Required for mode='path'. Optional source entity for mode='graph'. */
|
|
14155
14731
|
srcEntityId?: string;
|
|
@@ -14328,6 +14904,8 @@ export interface operations {
|
|
|
14328
14904
|
"application/json": {
|
|
14329
14905
|
entityId?: string;
|
|
14330
14906
|
name?: string;
|
|
14907
|
+
/** @description Scope the lookup to one project. Recommended when resolving by `name`, since the same entity name can exist in several projects. */
|
|
14908
|
+
projectId?: string;
|
|
14331
14909
|
};
|
|
14332
14910
|
};
|
|
14333
14911
|
};
|