@displaydev/cli 0.18.0 → 0.20.0

package/dist/mcp-server.js

@@ -27,6 +27,19 @@ function _async_to_generator(fn) {
         });
     };
 }
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
 function _instanceof(left, right) {
     "@swc/helpers - instanceof";
     if (right != null && typeof Symbol !== "undefined" && right[Symbol.hasInstance]) {
@@ -35,6 +48,45 @@ function _instanceof(left, right) {
         return left instanceof right;
     }
 }
+function _object_spread(target) {
+    for(var i = 1; i < arguments.length; i++){
+        var source = arguments[i] != null ? arguments[i] : {};
+        var ownKeys = Object.keys(source);
+        if (typeof Object.getOwnPropertySymbols === "function") {
+            ownKeys = ownKeys.concat(Object.getOwnPropertySymbols(source).filter(function(sym) {
+                return Object.getOwnPropertyDescriptor(source, sym).enumerable;
+            }));
+        }
+        ownKeys.forEach(function(key) {
+            _define_property(target, key, source[key]);
+        });
+    }
+    return target;
+}
+function ownKeys(object, enumerableOnly) {
+    var keys = Object.keys(object);
+    if (Object.getOwnPropertySymbols) {
+        var symbols = Object.getOwnPropertySymbols(object);
+        if (enumerableOnly) {
+            symbols = symbols.filter(function(sym) {
+                return Object.getOwnPropertyDescriptor(object, sym).enumerable;
+            });
+        }
+        keys.push.apply(keys, symbols);
+    }
+    return keys;
+}
+function _object_spread_props(target, source) {
+    source = source != null ? source : {};
+    if (Object.getOwnPropertyDescriptors) {
+        Object.defineProperties(target, Object.getOwnPropertyDescriptors(source));
+    } else {
+        ownKeys(Object(source)).forEach(function(key) {
+            Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key));
+        });
+    }
+    return target;
+}
 function _ts_generator(thisArg, body) {
     var f, y, t, _ = {
         label: 0,
@@ -140,6 +192,7 @@ import { z } from 'zod';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { ApiError } from './api-client.js';
+import { withUpdateNotice } from './update-notice.js';
 var FILE_ERROR_CODES = new Set([
     'ENOENT',
     'EACCES',
@@ -261,7 +314,7 @@ export function registerPublicTools(server, api) {
             'html',
             'md'
         ]).default('html').describe('Content format')
-    }, function(args) {
+    }, withUpdateNotice(function(args) {
         return _async_to_generator(function() {
             var hasContent, hasFilePath, content, _tmp, result, err;
             return _ts_generator(this, function(_state) {
@@ -357,7 +410,7 @@ export function registerPublicTools(server, api) {
                 }
             });
         })();
-    });
+    }));
 }
 export function registerTools(server, api) {
     server.tool('publish', 'Publish an HTML or Markdown artifact behind company auth', {
@@ -381,7 +434,7 @@ export function registerTools(server, api) {
             'hide',
             'inherit'
         ]).optional().describe('display.dev attribution bar override. Paid tier only; defaults to org setting when omitted.')
-    }, function(args) {
+    }, withUpdateNotice(function(args) {
         return _async_to_generator(function() {
             var _args_name, hasContent, hasFilePath, _args_name1, content, _tmp, result, _tmp1, err;
             return _ts_generator(this, function(_state) {
@@ -559,7 +612,7 @@ export function registerTools(server, api) {
                 }
             });
         })();
-    });
+    }));
     server.tool('find', 'List or search artifacts in the caller\'s organization. Omit `query` to list every artifact (paginated). Filter by name, one-or-more authors, one-or-more visibilities, or update time. Sort by `updated_at` (default), `view_count`, or `name`. Paginate via `cursor` — if the result includes a non-null `nextCursor`, pass it back to fetch the next page; if filters change between calls, drop the cursor. The response also carries `totalCount` (`-1` means the count query exceeded its budget — treat as "many"). `visibility: ["private"]` returns only your own private artifacts, not org-wide.', {
         query: z.string().optional().describe('Search by artifact name (case-insensitive substring). Omit to list all artifacts.'),
         author: z.array(z.string()).optional().describe('Filter by one or more authors. Each value: email, userId, or the literal "me". Multiple values are ORed. "me" requires a user-scoped credential — with an org API key the wire drops it.'),
@@ -580,7 +633,7 @@ export function registerTools(server, api) {
         ]).optional().describe('Sort direction. Defaults: desc for updated_at and view_count, asc for name.'),
         cursor: z.string().optional().describe('Opaque pagination token from a prior response. Pass it back to fetch the next page. WARNING: only valid for the same `sort`/`dir`/filter set that issued it — change a filter and drop the cursor, or results will be skewed without an error.'),
         limit: z.number().int().min(1).max(100).optional().describe('Max results per page (1–100, default 50).')
-    }, function(args) {
+    }, withUpdateNotice(function(args) {
         return _async_to_generator(function() {
             var result, err;
             return _ts_generator(this, function(_state) {
@@ -615,11 +668,11 @@ export function registerTools(server, api) {
                 }
             });
         })();
-    });
+    }));
     server.tool('get', 'Get full details of a specific artifact', {
         short_id: z.string().describe('Artifact shortId'),
         include: z.array(z.string()).optional().describe('Include additional data (e.g. "versions")')
-    }, function(args) {
+    }, withUpdateNotice(function(args) {
         return _async_to_generator(function() {
             var result, err;
             return _ts_generator(this, function(_state) {
@@ -654,11 +707,11 @@ export function registerTools(server, api) {
                 }
             });
         })();
-    });
+    }));
     server.tool('delete', 'Delete an artifact permanently', {
         short_id: z.string().describe('Artifact shortId to delete'),
         confirm: z.boolean().describe('Must be true to confirm deletion')
-    }, function(args) {
+    }, withUpdateNotice(function(args) {
         return _async_to_generator(function() {
             var result, err;
             return _ts_generator(this, function(_state) {
@@ -712,7 +765,7 @@ export function registerTools(server, api) {
                 }
             });
         })();
-    });
+    }));
     server.tool('share', 'Change an artifact\'s visibility and/or add/remove individual shared-with emails without republishing.', {
         short_id: z.string().describe('Short ID of the artifact (8 chars).'),
         visibility: z.enum([
@@ -722,7 +775,7 @@ export function registerTools(server, api) {
         ]).optional().describe('Change the visibility level. Omit to keep current. "private" requires the Pro plan.'),
         add_users: z.array(z.string()).optional().describe('Emails to add to sharedWith (idempotent).'),
         remove_users: z.array(z.string()).optional().describe('Emails to remove from sharedWith (idempotent).')
-    }, function(args) {
+    }, withUpdateNotice(function(args) {
         return _async_to_generator(function() {
             var result, err;
             return _ts_generator(this, function(_state) {
@@ -780,11 +833,11 @@ export function registerTools(server, api) {
                 }
             });
         })();
-    });
+    }));
     server.tool('rename', 'Rename a published artifact. The URL slug updates to match; existing URLs still resolve because routing uses the shortId.', {
         short_id: z.string().describe('The 8-character shortId returned at publish.'),
         name: z.string().describe('New display name. 1–200 characters.')
-    }, function(args) {
+    }, withUpdateNotice(function(args) {
         return _async_to_generator(function() {
             var result, err;
             return _ts_generator(this, function(_state) {
@@ -823,7 +876,7 @@ export function registerTools(server, api) {
                 }
             });
         })();
-    });
+    }));
     server.tool('export', 'Retrieve the source bytes of a published artifact. `format: "original"` returns the publisher\'s upload (markdown for .md, HTML for .html). `format: "markdown"` always returns markdown — `.md` is unchanged, `.html` is converted via Workers AI (cached).', {
         short_id: z.string().describe('Short ID of the artifact (8 chars).'),
         version: z.number().int().min(1).optional().describe('Pinned version number. Omit for current.'),
@@ -831,7 +884,7 @@ export function registerTools(server, api) {
             'original',
             'markdown'
         ]).default('original').describe('Representation requested. Default "original".')
-    }, function(args) {
+    }, withUpdateNotice(function(args) {
         return _async_to_generator(function() {
             var result, err;
             return _ts_generator(this, function(_state) {
@@ -879,7 +932,7 @@ export function registerTools(server, api) {
                 }
             });
         })();
-    });
+    }));
     // Metadata-only: does NOT bump the artifact version. Use the `publish`
     // tool (with `show_branding`) when you're changing content at the same
     // time so both writes happen in one transaction.
@@ -890,7 +943,7 @@ export function registerTools(server, api) {
             'hide',
             'inherit'
         ]).describe('show = force branding on; hide = force off; inherit = follow org default')
-    }, function(args) {
+    }, withUpdateNotice(function(args) {
         return _async_to_generator(function() {
             var result, err;
             return _ts_generator(this, function(_state) {
@@ -925,14 +978,14 @@ export function registerTools(server, api) {
                 }
             });
         })();
-    });
+    }));
     server.tool('set_logo', 'Upload or replace the org logo (paid tiers only). Used as the favicon on every artifact the org publishes. Stdio variant reads bytes from a local file path.', {
         file_path: z.string().describe('Path to a local PNG or WebP file. Square, 32×32 to 1024×1024, ≤256 KB.'),
         content_type: z.enum([
             'image/png',
             'image/webp'
         ]).optional().describe('Optional declared MIME type; inferred from the file extension when omitted.')
-    }, function(args) {
+    }, withUpdateNotice(function(args) {
         return _async_to_generator(function() {
             var bytes, err, contentType, lower, result, err1;
             return _ts_generator(this, function(_state) {
@@ -1021,8 +1074,8 @@ export function registerTools(server, api) {
                 }
             });
         })();
-    });
-    server.tool('clear_logo', 'Remove the org logo. Idempotent — succeeds even when no logo is currently set.', {}, function() {
+    }));
+    server.tool('clear_logo', 'Remove the org logo. Idempotent — succeeds even when no logo is currently set.', {}, withUpdateNotice(function() {
         return _async_to_generator(function() {
             var err;
             return _ts_generator(this, function(_state) {
@@ -1059,5 +1112,447 @@ export function registerTools(server, api) {
                 }
             });
         })();
-    });
+    }));
+    registerCommentTools(server, api);
+}
+/**
+ * Comment tools (feat-comments §3) — stdio transport mirror of the
+ * eight HTTP MCP tools in `api/src/mcp/comment-tools.ts`. KB-page
+ * subjects return `subject_type_not_implemented` here too; the
+ * polymorphic shape is part of the public contract so the CLI's MCP
+ * surface accepts the same input even when the wire path 501s.
+ */ function registerCommentTools(server, api) {
+    function rejectKbPage() {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        error: 'subject_type_not_implemented',
+                        message: 'KB-page subjects are not yet supported. Pass subject_type="artifact".',
+                        status: 501
+                    })
+                }
+            ],
+            isError: true
+        };
+    }
+    function requireShortId(args) {
+        if (!args.short_id) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: 'validation_error',
+                            message: 'short_id is required for subject_type=artifact',
+                            status: 400
+                        })
+                    }
+                ],
+                isError: true
+            };
+        }
+        return args.short_id;
+    }
+    var subjectArgs = {
+        subject_type: z.enum([
+            'artifact',
+            'kb_page'
+        ]).describe('Subject discriminator'),
+        short_id: z.string().optional().describe('Artifact shortId (subject_type=artifact)'),
+        kb_name: z.string().optional().describe('KB name (subject_type=kb_page; not yet supported)'),
+        file_path: z.string().optional().describe('KB page path (subject_type=kb_page; not yet supported)')
+    };
+    var anchorSchema = z.object({
+        textQuote: z.object({
+            prefix: z.string(),
+            exact: z.string(),
+            suffix: z.string()
+        }),
+        cssPath: z.string(),
+        textPosition: z.object({
+            start: z.number().int(),
+            end: z.number().int()
+        }).optional()
+    }).optional();
+    server.tool('add_comment', 'Post a root comment or reply on an artifact. Root: pass `anchor` and omit `parent_id`. Reply: pass `parent_id` (the root comment id) and omit `anchor` (replies inherit the root anchor).', _object_spread_props(_object_spread({}, subjectArgs), {
+        body: z.string().min(1).max(10000).describe('Comment body (≤10k chars)'),
+        parent_id: z.string().optional().describe('Root comment id when posting a reply'),
+        anchor: anchorSchema
+    }), withUpdateNotice(function(args) {
+        return _async_to_generator(function() {
+            var shortIdOrErr, result, err;
+            return _ts_generator(this, function(_state) {
+                switch(_state.label){
+                    case 0:
+                        if (args.subject_type === 'kb_page') {
+                            return [
+                                2,
+                                rejectKbPage()
+                            ];
+                        }
+                        shortIdOrErr = requireShortId(args);
+                        if (typeof shortIdOrErr !== 'string') {
+                            return [
+                                2,
+                                shortIdOrErr
+                            ];
+                        }
+                        _state.label = 1;
+                    case 1:
+                        _state.trys.push([
+                            1,
+                            3,
+                            ,
+                            4
+                        ]);
+                        return [
+                            4,
+                            api.addComment(shortIdOrErr, {
+                                body: args.body,
+                                anchor: args.anchor,
+                                parentId: args.parent_id
+                            })
+                        ];
+                    case 2:
+                        result = _state.sent();
+                        return [
+                            2,
+                            okResponse(result)
+                        ];
+                    case 3:
+                        err = _state.sent();
+                        return [
+                            2,
+                            errorResponse(err)
+                        ];
+                    case 4:
+                        return [
+                            2
+                        ];
+                }
+            });
+        })();
+    }));
+    server.tool('list_comments', 'List comment threads on a subject. Reads from Postgres (not the KV widget cache).', _object_spread_props(_object_spread({}, subjectArgs), {
+        status: z.enum([
+            'open',
+            'resolved',
+            'all'
+        ]).optional().describe('Defaults to "open"'),
+        since: z.string().optional().describe('ISO-8601 — return only threads with activity at or after this timestamp')
+    }), withUpdateNotice(function(args) {
+        return _async_to_generator(function() {
+            var shortIdOrErr, result, err;
+            return _ts_generator(this, function(_state) {
+                switch(_state.label){
+                    case 0:
+                        if (args.subject_type === 'kb_page') {
+                            return [
+                                2,
+                                rejectKbPage()
+                            ];
+                        }
+                        shortIdOrErr = requireShortId(args);
+                        if (typeof shortIdOrErr !== 'string') {
+                            return [
+                                2,
+                                shortIdOrErr
+                            ];
+                        }
+                        _state.label = 1;
+                    case 1:
+                        _state.trys.push([
+                            1,
+                            3,
+                            ,
+                            4
+                        ]);
+                        return [
+                            4,
+                            api.listComments(shortIdOrErr, {
+                                status: args.status,
+                                since: args.since
+                            })
+                        ];
+                    case 2:
+                        result = _state.sent();
+                        return [
+                            2,
+                            okResponse(result)
+                        ];
+                    case 3:
+                        err = _state.sent();
+                        return [
+                            2,
+                            errorResponse(err)
+                        ];
+                    case 4:
+                        return [
+                            2
+                        ];
+                }
+            });
+        })();
+    }));
+    server.tool('edit_comment', 'Edit your own comment within the 5-minute author window. After 5 minutes the body is locked.', {
+        comment_id: z.string(),
+        body: z.string().min(1).max(10000)
+    }, withUpdateNotice(function(args) {
+        return _async_to_generator(function() {
+            var result, err;
+            return _ts_generator(this, function(_state) {
+                switch(_state.label){
+                    case 0:
+                        _state.trys.push([
+                            0,
+                            2,
+                            ,
+                            3
+                        ]);
+                        return [
+                            4,
+                            api.editComment(args.comment_id, args.body)
+                        ];
+                    case 1:
+                        result = _state.sent();
+                        return [
+                            2,
+                            okResponse(result)
+                        ];
+                    case 2:
+                        err = _state.sent();
+                        return [
+                            2,
+                            errorResponse(err)
+                        ];
+                    case 3:
+                        return [
+                            2
+                        ];
+                }
+            });
+        })();
+    }));
+    server.tool('delete_comment', 'Soft-delete a comment. Author / artifact creator / org admin. Replies remain visible; body becomes "[deleted]".', {
+        comment_id: z.string()
+    }, withUpdateNotice(function(args) {
+        return _async_to_generator(function() {
+            var err;
+            return _ts_generator(this, function(_state) {
+                switch(_state.label){
+                    case 0:
+                        _state.trys.push([
+                            0,
+                            2,
+                            ,
+                            3
+                        ]);
+                        return [
+                            4,
+                            api.deleteComment(args.comment_id)
+                        ];
+                    case 1:
+                        _state.sent();
+                        return [
+                            2,
+                            okResponse({
+                                deleted: true
+                            })
+                        ];
+                    case 2:
+                        err = _state.sent();
+                        return [
+                            2,
+                            errorResponse(err)
+                        ];
+                    case 3:
+                        return [
+                            2
+                        ];
+                }
+            });
+        })();
+    }));
+    server.tool('resolve_thread', 'Mark a thread resolved (root comment id). Thread participant / artifact creator / org admin.', {
+        comment_id: z.string()
+    }, withUpdateNotice(function(args) {
+        return _async_to_generator(function() {
+            var result, err;
+            return _ts_generator(this, function(_state) {
+                switch(_state.label){
+                    case 0:
+                        _state.trys.push([
+                            0,
+                            2,
+                            ,
+                            3
+                        ]);
+                        return [
+                            4,
+                            api.resolveThread(args.comment_id)
+                        ];
+                    case 1:
+                        result = _state.sent();
+                        return [
+                            2,
+                            okResponse(result)
+                        ];
+                    case 2:
+                        err = _state.sent();
+                        return [
+                            2,
+                            errorResponse(err)
+                        ];
+                    case 3:
+                        return [
+                            2
+                        ];
+                }
+            });
+        })();
+    }));
+    server.tool('reopen_thread', 'Reopen a resolved thread. Any authenticated user with view access on the artifact.', {
+        comment_id: z.string()
+    }, withUpdateNotice(function(args) {
+        return _async_to_generator(function() {
+            var result, err;
+            return _ts_generator(this, function(_state) {
+                switch(_state.label){
+                    case 0:
+                        _state.trys.push([
+                            0,
+                            2,
+                            ,
+                            3
+                        ]);
+                        return [
+                            4,
+                            api.reopenThread(args.comment_id)
+                        ];
+                    case 1:
+                        result = _state.sent();
+                        return [
+                            2,
+                            okResponse(result)
+                        ];
+                    case 2:
+                        err = _state.sent();
+                        return [
+                            2,
+                            errorResponse(err)
+                        ];
+                    case 3:
+                        return [
+                            2
+                        ];
+                }
+            });
+        })();
+    }));
+    server.tool('watch', 'Watch the subject for comment notifications. Per-user; service-account API keys cannot subscribe.', subjectArgs, withUpdateNotice(function(args) {
+        return _async_to_generator(function() {
+            var shortIdOrErr, result, err;
+            return _ts_generator(this, function(_state) {
+                switch(_state.label){
+                    case 0:
+                        if (args.subject_type === 'kb_page') {
+                            return [
+                                2,
+                                rejectKbPage()
+                            ];
+                        }
+                        shortIdOrErr = requireShortId(args);
+                        if (typeof shortIdOrErr !== 'string') {
+                            return [
+                                2,
+                                shortIdOrErr
+                            ];
+                        }
+                        _state.label = 1;
+                    case 1:
+                        _state.trys.push([
+                            1,
+                            3,
+                            ,
+                            4
+                        ]);
+                        return [
+                            4,
+                            api.watchArtifact(shortIdOrErr)
+                        ];
+                    case 2:
+                        result = _state.sent();
+                        return [
+                            2,
+                            okResponse(result)
+                        ];
+                    case 3:
+                        err = _state.sent();
+                        return [
+                            2,
+                            errorResponse(err)
+                        ];
+                    case 4:
+                        return [
+                            2
+                        ];
+                }
+            });
+        })();
+    }));
+    server.tool('unwatch', 'Unwatch the subject. Per-user; service-account API keys cannot subscribe.', subjectArgs, withUpdateNotice(function(args) {
+        return _async_to_generator(function() {
+            var shortIdOrErr, err;
+            return _ts_generator(this, function(_state) {
+                switch(_state.label){
+                    case 0:
+                        if (args.subject_type === 'kb_page') {
+                            return [
+                                2,
+                                rejectKbPage()
+                            ];
+                        }
+                        shortIdOrErr = requireShortId(args);
+                        if (typeof shortIdOrErr !== 'string') {
+                            return [
+                                2,
+                                shortIdOrErr
+                            ];
+                        }
+                        _state.label = 1;
+                    case 1:
+                        _state.trys.push([
+                            1,
+                            3,
+                            ,
+                            4
+                        ]);
+                        return [
+                            4,
+                            api.unwatchArtifact(shortIdOrErr)
+                        ];
+                    case 2:
+                        _state.sent();
+                        return [
+                            2,
+                            okResponse({
+                                watching: false
+                            })
+                        ];
+                    case 3:
+                        err = _state.sent();
+                        return [
+                            2,
+                            errorResponse(err)
+                        ];
+                    case 4:
+                        return [
+                            2
+                        ];
+                }
+            });
+        })();
+    }));
 }