@displaydev/cli 0.9.0 → 0.11.0

package/dist/mcp-server.js

@@ -198,7 +198,9 @@ function okResponse(result) {
 /**
  * Starts an MCP server over stdin/stdout.
  * Tools call the display.dev REST API via the ApiClient.
- */ export function startMcpServer(_0) {
+ */ var AUTHENTICATED_INSTRUCTIONS = 'display.dev publishes HTML or Markdown artifacts to permanent URLs gated by company authentication — ideal for sharing AI-generated reports, dashboards, or explainers with the user\'s team.';
+var PUBLIC_INSTRUCTIONS = 'display.dev publishes anonymous HTML or Markdown artifacts. Returns a preview URL (anyone can view) plus a one-shot claim URL the user visits to move the artifact into a display.dev organization.';
+export function startMcpServer(_0) {
     return _async_to_generator(function(apiClient) {
         var options, _options_mode, _options_transport, mode, server, transport;
         var _arguments = arguments;
@@ -210,6 +212,8 @@ function okResponse(result) {
                     server = new McpServer({
                         name: 'display',
                         version: '1.0.0'
+                    }, {
+                        instructions: mode === 'public' ? PUBLIC_INSTRUCTIONS : AUTHENTICATED_INSTRUCTIONS
                     });
                     if (mode === 'public') {
                         registerPublicTools(server, apiClient);
@@ -693,17 +697,77 @@ export function registerTools(server, api) {
             });
         })();
     });
-    // Agent-native parity for the artifact-detail per-artifact toggle.
-    // 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.
-    server.tool('artifact_set_branding', 'Override display.dev branding for an existing artifact without re-publishing. Paid tiers only (free-tier orgs must keep inherit).', {
-        short_id: z.string().describe('Artifact shortId'),
-        show_branding: z.enum([
-            'show',
-            'hide',
-            'inherit'
-        ]).describe('show = force branding on; hide = force off; inherit = follow org default')
+    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([
+            'public',
+            'company',
+            'private'
+        ]).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) {
+        return _async_to_generator(function() {
+            var result, err;
+            return _ts_generator(this, function(_state) {
+                switch(_state.label){
+                    case 0:
+                        if (args.visibility === undefined && !args.add_users && !args.remove_users) {
+                            return [
+                                2,
+                                {
+                                    content: [
+                                        {
+                                            type: 'text',
+                                            text: JSON.stringify({
+                                                error: 'invalid_input',
+                                                message: 'Provide at least one of visibility, add_users, or remove_users'
+                                            })
+                                        }
+                                    ],
+                                    isError: true
+                                }
+                            ];
+                        }
+                        _state.label = 1;
+                    case 1:
+                        _state.trys.push([
+                            1,
+                            3,
+                            ,
+                            4
+                        ]);
+                        return [
+                            4,
+                            api.share(args.short_id, {
+                                visibility: args.visibility,
+                                addUsers: args.add_users,
+                                removeUsers: args.remove_users
+                            })
+                        ];
+                    case 2:
+                        result = _state.sent();
+                        return [
+                            2,
+                            okResponse(result)
+                        ];
+                    case 3:
+                        err = _state.sent();
+                        return [
+                            2,
+                            errorResponse(err)
+                        ];
+                    case 4:
+                        return [
+                            2
+                        ];
+                }
+            });
+        })();
+    });
+    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) {
         return _async_to_generator(function() {
             var result, err;
@@ -718,13 +782,73 @@ export function registerTools(server, api) {
                         ]);
                         return [
                             4,
-                            api.setArtifactBranding(args.short_id, args.show_branding)
+                            api.renameArtifact(args.short_id, args.name)
                         ];
                     case 1:
                         result = _state.sent();
                         return [
                             2,
-                            okResponse(result)
+                            okResponse({
+                                url: result.url,
+                                shortId: result.shortId,
+                                name: result.name
+                            })
+                        ];
+                    case 2:
+                        err = _state.sent();
+                        return [
+                            2,
+                            errorResponse(err)
+                        ];
+                    case 3:
+                        return [
+                            2
+                        ];
+                }
+            });
+        })();
+    });
+    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.'),
+        format: z.enum([
+            'original',
+            'markdown'
+        ]).default('original').describe('Representation requested. Default "original".')
+    }, 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.exportSource(args.short_id, args.version, args.format)
+                        ];
+                    case 1:
+                        result = _state.sent();
+                        return [
+                            2,
+                            {
+                                content: [
+                                    {
+                                        type: 'text',
+                                        text: result.data.toString('utf-8')
+                                    }
+                                ],
+                                _meta: {
+                                    shortId: args.short_id,
+                                    version: args.version,
+                                    contentType: result.contentType,
+                                    sizeBytes: result.data.length
+                                }
+                            }
                         ];
                     case 2:
                         err = _state.sent();
@@ -740,11 +864,16 @@ export function registerTools(server, api) {
             });
         })();
     });
-    // Agent-native parity for the Settings → Branding dashboard toggle.
-    // Pairs with `publish`'s `show_branding` param: this tool controls the
-    // default; that param overrides it per-artifact.
-    server.tool('org_set_branding', 'Enable or disable display.dev branding for every artifact in the org (paid tiers only). Per-artifact overrides keep precedence.', {
-        enabled: z.boolean().describe('true to show the bar by default; false to hide it')
+    // 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.
+    server.tool('branding', 'Override display.dev branding for an existing artifact without re-publishing. Paid tiers only (free-tier orgs must keep inherit).', {
+        short_id: z.string().describe('Artifact shortId'),
+        show_branding: z.enum([
+            'show',
+            'hide',
+            'inherit'
+        ]).describe('show = force branding on; hide = force off; inherit = follow org default')
     }, function(args) {
         return _async_to_generator(function() {
             var result, err;
@@ -759,7 +888,7 @@ export function registerTools(server, api) {
                         ]);
                         return [
                             4,
-                            api.setOrgBranding(args.enabled)
+                            api.setArtifactBranding(args.short_id, args.show_branding)
                         ];
                     case 1:
                         result = _state.sent();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@displaydev/cli",
-  "version": "0.9.0",
+  "version": "0.11.0",
   "type": "module",
   "bin": {
     "dsp": "dist/main.js"