@displaydev/cli 0.8.1 → 0.10.0

package/dist/api-client.js

@@ -561,17 +561,29 @@ export var ApiClient = /*#__PURE__*/ function() {
         {
             key: "exportSource",
             value: /**
-   * Fetch the raw source bytes of an artifact (the markdown for `.md`,
-   * the served HTML for `.html`). Returns the body plus the response's
-   * Content-Type so callers can disambiguate. Throws `ApiError` on
-   * non-2xx (the CLI maps 404 to a clean message + exit 4).
-   */ function exportSource(shortId, version) {
+   * Fetch the source bytes of an artifact. `format: 'original'` returns
+   * the publisher's upload (markdown for `.md`, HTML for `.html`).
+   * `format: 'markdown'` returns markdown regardless — `.md` is unchanged,
+   * `.html` is converted server-side via Workers AI (cached).
+   *
+   * Returns the body plus the response's Content-Type. Throws `ApiError`
+   * on non-2xx (CLI maps 404 to a clean message + exit 4).
+   */ function exportSource(shortId, version, format) {
                 return _async_to_generator(function() {
-                    var _res_headers_get, qs, url, res, _parsed_message, text, parsed, arrayBuffer;
+                    var _res_headers_get, params, qs, url, res, _parsed_message, text, parsed, arrayBuffer;
                     return _ts_generator(this, function(_state) {
                         switch(_state.label){
                             case 0:
-                                qs = version !== undefined ? "?v=".concat(version) : '';
+                                params = [];
+                                if (version !== undefined) {
+                                    params.push("v=".concat(version));
+                                }
+                                // `original` is the API default — omit so smoke tests / network
+                                // logs aren't littered with redundant query params.
+                                if (format !== undefined && format !== 'original') {
+                                    params.push("format=".concat(format));
+                                }
+                                qs = params.length > 0 ? "?".concat(params.join('&')) : '';
                                 url = "".concat(this.baseUrl, "/v1/artifacts/").concat(shortId, "/source").concat(qs);
                                 return [
                                     4,

package/dist/main.js

@@ -781,7 +781,7 @@ program.command('get <shortId>').description('Get artifact details').option('--i
     })();
 });
 // --- export ---
-program.command('export <shortId>').description('Print the published source bytes to stdout. Pin a version with @<n>.').action(function(shortIdArg) {
+program.command('export <shortId>').description('Print the published source bytes to stdout. Pin a version with @<n>.').option('--format <format>', 'Representation: "original" (default — bytes as uploaded) or "markdown" (.html artifacts are converted via Workers AI).', 'original').action(function(shortIdArg, opts) {
     return _async_to_generator(function() {
         var parsed, auth, client, result, err, msg;
         return _ts_generator(this, function(_state) {
@@ -792,6 +792,10 @@ program.command('export <shortId>').description('Print the published source byte
                         console.error('Invalid argument. Expected <shortId> or <shortId>@<version> (version must be a positive integer).');
                         process.exit(2);
                     }
+                    if (opts.format !== 'original' && opts.format !== 'markdown') {
+                        console.error('Invalid --format. Expected "original" or "markdown".');
+                        process.exit(2);
+                    }
                     return [
                         4,
                         resolveAuthOrConfig()
@@ -809,7 +813,7 @@ program.command('export <shortId>').description('Print the published source byte
                     ]);
                     return [
                         4,
-                        client.exportSource(parsed.shortId, parsed.version)
+                        client.exportSource(parsed.shortId, parsed.version, opts.format)
                     ];
                 case 3:
                     result = _state.sent();

package/dist/mcp-server.js

@@ -693,17 +693,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 +778,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 +860,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 +884,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.8.1",
+  "version": "0.10.0",
   "type": "module",
   "bin": {
     "dsp": "dist/main.js"