bump-cli 2.9.10 → 2.9.12

package/README.md

@@ -37,9 +37,9 @@ The Bump.sh CLI is a node package currently distributed via NPM. This means you
 
 _If you are looking to use Bump.sh in a continuous integration environment you might be interested by [our Github Action](https://github.com/marketplace/actions/bump-sh-api-documentation-changelog)._
 
+> [!NOTE]
 > You can download a standalone package directly from the latest
 > Github release assets if you don’t use Node.
-{: .info}
 
 ### Global installation
 
@@ -124,8 +124,8 @@ When an API is updated, the documentation should be updated at the same time. Th
 bump deploy path/to/api-document.yml --doc my-documentation --token $DOC_TOKEN
 ```
 
-> You can find your own `my-documentation` slug and `$DOC_TOKEN` api key from your [documentation settings](https://bump.sh/docs).
-{: .info}
+> [!TIP]
+> You can find your own `my-documentation` slug and `$DOC_TOKEN` api key from your [documentation settings](https://bump.sh/dashboard).
 
 You can also deploy a given API document to a different branch of your documentation with the `--branch <branch-name>` parameter. Please note the branch will be created if it doesn’t exist. More details about the branching feature are available on [this dedicated help page](https://docs.bump.sh/help/branching). E.g. deploy the API document to the `staging` branch of the documentation:
 
@@ -141,8 +141,8 @@ If you already have a hub in your [Bump.sh](https://bump.sh) account, you can au
 bump deploy dir/path/to/apis/ --auto-create --hub my-hub --token $HUB_TOKEN
 ```
 
+> [!TIP]
 > You can find your own `my-hub` slug and `$HUB_TOKEN` api key from your [hub settings](https://bump.sh/hubs).
-{: .info}
 
 Please note, by default, only files named `{slug}-api.[format]` are published. Where `{slug}` is a name for your API and `[format]` is either `yaml` or `json`. Adjust to your file naming convention using the `--filename-pattern <pattern>` option.
 
@@ -175,6 +175,20 @@ bump deploy path/to/api-document.yml --dry-run --doc my-documentation --token $D
 
 Please check `bump deploy --help` for more usage details.
 
+#### Deploy a workflow document on your MCP server
+
+Use the `bump deploy` command with the `--mcp-server` flag to push a workflow definition to your MCP server.
+
+```shell
+bump deploy path/to/flower-document.yml --mcp-server my-mcp-server-id-or-slug --token $BUMP_TOKEN
+```
+
+> [!NOTE]
+> You can find your own `mcp-server-id-or-slug` and `$BUMP_TOKEN` api key from your [MCP server settings](https://bump.sh/dashboard) at 'https://bump.sh/{your-organization}/workflow/set/{mcp-server-id}/tokens'.
+
+This feature is currently in closed beta.
+Request an early access at hello@bump.sh
+
 ### The `diff` command
 
 Using the `diff` command can help to spot differences between the local API
@@ -271,14 +285,14 @@ bump preview --live --open api-document.yaml
 - Watch the live preview being updated each time you save your file.
 - The additional `--open` flag helps to automatically open the preview URL in your browser.
 
+> [!NOTE]
 > You can create as many previews as you like without being authenticated. This is a **free and unlimited service**.
-{: .info}
 
 Please check `bump preview --help` for more usage details
 
 ### The `overlay` command
 
-The [Overlay Specification](https://spec.openapis.org/overlay/v1.0.0.html) from the OpenAPI Initiative makes it possible to modify the content of an API definition by adding a layer on top of it. That layer helps adding, removing or changing some or all of the content of the original definition. 
+The [Overlay Specification](https://spec.openapis.org/overlay/v1.0.0.html) from the OpenAPI Initiative makes it possible to modify the content of an API definition by adding a layer on top of it. That layer helps adding, removing or changing some or all of the content of the original definition.
 
 The `bump overlay` command takes an original API document, applies the changes from the overlay document, and outputs a modified version. No changes are made directly to the original document.
 

package/dist/api/index.d.ts

@@ -1,6 +1,6 @@
 import { Config } from '@oclif/core';
 import { AxiosInstance, AxiosResponse } from 'axios';
-import { DiffRequest, DiffResponse, PingResponse, PreviewRequest, PreviewResponse, VersionRequest, VersionResponse, WithDiff } from './models.js';
+import { DiffRequest, DiffResponse, PingResponse, PreviewRequest, PreviewResponse, VersionRequest, VersionResponse, WithDiff, WorkflowVersionRequest, WorkflowVersionResponse } from './models.js';
 declare class BumpApi {
     protected config?: Config | undefined;
     protected readonly client: AxiosInstance;
@@ -8,6 +8,7 @@ declare class BumpApi {
     getPing: () => Promise<AxiosResponse<PingResponse>>;
     getVersion: (versionId: string, token: string) => Promise<AxiosResponse<VersionResponse & WithDiff>>;
     postDiff: (body: DiffRequest) => Promise<AxiosResponse<DiffResponse>>;
+    postMCPServerDeploy: (mcpServerIdOrSlug: string, body: WorkflowVersionRequest, token: string) => Promise<AxiosResponse<WorkflowVersionResponse>>;
     postPreview: (body?: PreviewRequest) => Promise<AxiosResponse<PreviewResponse>>;
     postValidation: (body: VersionRequest, token: string) => Promise<AxiosResponse<void>>;
     postVersion: (body: VersionRequest, token: string) => Promise<AxiosResponse<VersionResponse>>;

package/dist/api/index.js

@@ -12,6 +12,9 @@ class BumpApi {
         headers: this.authorizationHeader(token),
     });
     postDiff = (body) => this.client.post('/diffs', body);
+    postMCPServerDeploy = (mcpServerIdOrSlug, body, token) => this.client.post(`/mcp_servers/${mcpServerIdOrSlug}/deploy`, body, {
+        headers: this.authorizationHeader(token),
+    });
     postPreview = (body) => this.client.post('/previews', body);
     postValidation = (body, token) => this.client.post('/validations', body, {
         headers: this.authorizationHeader(token),
@@ -21,7 +24,7 @@ class BumpApi {
     });
     putPreview = (versionId, body) => this.client.put(`/previews/${versionId}`, body);
     authorizationHeader = (token) => ({
-        Authorization: `Basic ${Buffer.from(token).toString('base64')}`,
+        Authorization: `Token ${token}`,
     });
     handleError = (error) => Promise.reject(new APIError(error));
     initializeResponseInterceptor = () => {

package/dist/api/models.d.ts

@@ -67,3 +67,10 @@ export interface DiffItem {
     status: string;
     type: string;
 }
+export interface WorkflowVersionRequest {
+    definition: string;
+}
+export interface WorkflowVersionResponse {
+    id: string;
+    mcp_server_id: string;
+}

package/dist/commands/deploy.d.ts

@@ -15,11 +15,13 @@ export default class Deploy extends BaseCommand<typeof Deploy> {
         'filename-pattern': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         hub: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         interactive: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'mcp-server': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         overlay: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
         preview: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         token: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
     };
     protected deployDirectory(dir: string, dryRun: boolean, token: string, hub: string, autoCreate: boolean, interactive: boolean, filenamePattern: string, documentationName: string | undefined, branch: string | undefined, overlays?: string[] | undefined): Promise<void>;
     protected deploySingleFile(api: API, dryRun: boolean, documentation: string, token: string, hub: string | undefined, autoCreate: boolean, documentationName: string | undefined, branch: string | undefined, overlay?: string[] | undefined, temporary?: boolean | undefined): Promise<void>;
+    protected deploySingleWorkflowFile(workflowDefinition: API, mcpServer: string, token: string): Promise<void>;
     run(): Promise<void>;
 }

package/dist/commands/deploy.js

@@ -7,6 +7,7 @@ import { DefinitionDirectory } from '../core/definition-directory.js';
 import { Deploy as CoreDeploy } from '../core/deploy.js';
 import { isDir } from '../core/utils/file.js';
 import { confirm as promptConfirm } from '../core/utils/prompts.js';
+import { WorkflowDeploy as CoreWorkflowDeploy } from '../core/workflow-deploy.js';
 import { API } from '../definition.js';
 import * as flagsBuilder from '../flags.js';
 export default class Deploy extends BaseCommand {
@@ -46,6 +47,12 @@ Let's deploy a new version to your my-jobs-service documentation on Bump.sh... d
 ${chalk.dim('$ bump deploy FILE --dry-run --doc <doc_slug> --token <your_doc_token>')}
 * Let's validate on Bump.sh... done
 * Definition is valid
+`,
+        `Deploy a new workflow document of ${chalk.underline('an existing MCP server')}
+
+${chalk.dim('$ bump deploy FILE --mcp-server <your_mcp_server_id_or_slug> --token <your_organization_token>')}
+* Let's deploy on Bump.sh... done
+* Your <your_mcp_server_id_or_slug> MCP server... has received a new workflow definition which will soon be ready.
 `,
     ];
     static flags = {
@@ -57,6 +64,7 @@ ${chalk.dim('$ bump deploy FILE --dry-run --doc <doc_slug> --token <your_doc_tok
         'filename-pattern': flagsBuilder.filenamePattern(),
         hub: flagsBuilder.hub(),
         interactive: flagsBuilder.interactive(),
+        'mcp-server': flagsBuilder.mcpServer(),
         overlay: flagsBuilder.overlay(),
         preview: flagsBuilder.preview(),
         token: flagsBuilder.token(),
@@ -114,6 +122,17 @@ ${chalk.dim('$ bump deploy FILE --dry-run --doc <doc_slug> --token <your_doc_tok
             ux.warn(`Your ${documentation} documentation has not changed`);
         }
     }
+    async deploySingleWorkflowFile(workflowDefinition, mcpServer, token) {
+        ux.action.status = `...a new workflow definition to your ${mcpServer} MCP server`;
+        const response = await new CoreWorkflowDeploy(this.bump).run(workflowDefinition, mcpServer, token);
+        if (response) {
+            process.stdout.write(ux.colorize('green', `Your ${mcpServer} MCP server...`));
+            ux.stdout(ux.colorize('green', `has received a new workflow definition which will soon be ready.`));
+        }
+        else {
+            ux.warn(`Your ${mcpServer} MCP server has not changed.`);
+        }
+    }
     /*
       Oclif doesn't type parsed args & flags correctly and especially
       required-ness which is not known by the compiler, thus the use of
@@ -122,7 +141,7 @@ ${chalk.dim('$ bump deploy FILE --dry-run --doc <doc_slug> --token <your_doc_tok
     */
     async run() {
         const { args, flags } = await this.parse(Deploy);
-        const [dryRun, documentation, token, hub, autoCreate, interactive, filenamePattern, documentationName, branch, overlay, temporary,] = [
+        const [dryRun, documentation, token, hub, autoCreate, interactive, filenamePattern, documentationName, branch, overlay, temporary, mcpServer,] = [
             flags['dry-run'],
             flags.doc,
             flags.token,
@@ -137,6 +156,7 @@ ${chalk.dim('$ bump deploy FILE --dry-run --doc <doc_slug> --token <your_doc_tok
             flags.overlay,
             /* when --preview is provided, generate temporary version */
             flags.preview,
+            flags['mcp-server'],
         ];
         const action = dryRun ? 'validate' : temporary ? 'preview' : 'deploy';
         ux.action.start(`Let's ${action} on Bump.sh`);
@@ -153,8 +173,12 @@ ${chalk.dim('$ bump deploy FILE --dry-run --doc <doc_slug> --token <your_doc_tok
             this.d(`${args.file} looks like an ${api.specName} spec version ${api.version}`);
             await this.deploySingleFile(api, dryRun, documentation, token, hub, autoCreate, documentationName, branch, overlay, temporary);
         }
+        else if (mcpServer) {
+            const workflowDefinition = await API.load(args.file);
+            await this.deploySingleWorkflowFile(workflowDefinition, mcpServer, token);
+        }
         else {
-            throw new CLIError('Missing required flag --doc=<slug>');
+            throw new CLIError('Missing required flag --doc=<slug> or --mcp-server=<slug>');
         }
         ux.action.stop();
     }

package/dist/core/overlay.d.ts

@@ -4,6 +4,7 @@ export declare class Overlay {
     run(spec: APIDefinition, overlay: OpenAPIOverlay): APIDefinition;
     private executeAction;
     private humanName;
+    private pathEntryToKey;
     private remove;
     private update;
 }

package/dist/core/overlay.js

@@ -76,12 +76,7 @@ export class Overlay {
         explodedPath.shift();
         // Take last element from path (which is the thing to act
         // upon)
-        let thingToActUpon = explodedPath.pop();
-        // The last element (e.g. '"price"]' or '0]') contains a final ']'
-        // so we need to remove it AND we need to parse the element to
-        // transform the string in either a string or a number
-        thingToActUpon =
-            thingToActUpon === undefined ? '$' : (thingToActUpon = JSON.parse(thingToActUpon.slice(0, -1)));
+        const thingToActUpon = this.pathEntryToKey(explodedPath.pop());
         // Reconstruct the stringified path expression targeting the parent
         const parentPath = explodedPath.join('][');
         const parent = parentPath.length > 0 ? jsonpath.query(spec, `$[${parentPath}]`) : spec;
@@ -103,6 +98,16 @@ export class Overlay {
     humanName(action) {
         return action.description ? `Action '${action.description}'` : 'Action';
     }
+    // The last path entry (e.g. "'price']" or '0]') contains a final
+    // ']' so we need to remove it AND we need to replace single quotes
+    // to double quotes AND FINALLY parse the element to transform the
+    // string in either a string or a number.
+    pathEntryToKey(pathEntry) {
+        if (pathEntry === undefined) {
+            return '$';
+        }
+        return JSON.parse(pathEntry.slice(0, -1).replaceAll(/(^'|'$)/g, '"'));
+    }
     remove(parent, property_or_index) {
         if (Array.isArray(parent)) {
             parent.splice(property_or_index, 1);

package/dist/core/schemas/flower-schemas/index.d.ts

@@ -0,0 +1,7 @@
+import type { JSONSchema7 } from 'json-schema';
+declare const _default: {
+    schemas: {
+        '0.1': JSONSchema7;
+    };
+};
+export default _default;

package/dist/core/schemas/flower-schemas/index.js

@@ -0,0 +1,6 @@
+import schemaV01 from './v0.1/schema.json' with { type: 'json' };
+export default {
+    schemas: {
+        '0.1': schemaV01,
+    },
+};

package/dist/core/schemas/flower-schemas/v0.1/schema.json

@@ -0,0 +1,126 @@
+{
+    "title": "Flower 0.1 schema",
+    "$schema": "http://json-schema.org/draft-07/schema#",
+    "type": "object",
+    "required": [
+        "flower",
+        "id",
+        "flows"
+    ],
+    "additionalProperties": false,
+    "patternProperties": {
+        "^x-[\\w\\d\\.\\-\\_]+$": {
+            "$ref": "#/definitions/specificationExtension"
+        }
+    },
+    "properties": {
+        "flower": {
+            "type": [
+                "string"
+            ],
+            "enum": [
+                "0.1"
+            ],
+            "description": "The Flower specification version of this document."
+        },
+        "id": {
+            "type": "string",
+            "description": "A unique id representing the workflow set."
+        },
+        "title": {
+            "type": "string"
+        },
+        "description": {
+            "type": "string"
+        },
+        "flows": {
+            "type": "array",
+            "items": {
+                "$ref": "#/definitions/flow"
+            }
+        }
+    },
+    "definitions": {
+        "flow": {
+            "type": "object",
+            "properties": {
+                "id": {
+                    "type": "string"
+                },
+                "description": {
+                    "type": "string"
+                },
+                "inputs": {
+                    "$ref": "#/definitions/schema"
+                },
+                "outputs": {
+                    "$ref": "#/definitions/schema"
+                },
+                "steps": {
+                    "type": "array",
+                    "items": {
+                        "$ref": "#/definitions/step"
+                    }
+                }
+            },
+            "required": [
+                "id",
+                "steps"
+            ]
+        },
+        "step": {
+            "type": "object",
+            "properties": {
+                "id": {
+                    "type": "string"
+                },
+                "outputs": {
+                    "$ref": "#/definitions/schema"
+                },
+                "request": {
+                    "type": "object",
+                    "properties": {
+                        "method": {
+                            "type": "string"
+                        },
+                        "query": {
+                            "$ref": "#/definitions/schema"
+                        },
+                        "url": {
+                            "type": "string"
+                        }
+                    }
+                }
+            },
+            "required": [
+                "id",
+                "request"
+            ]
+        },
+        "schema": {
+            "allOf": [
+                {
+                    "$ref": "http://json-schema.org/draft-07/schema#"
+                },
+                {
+                    "type": "object",
+                    "patternProperties": {
+                        "^x-[\\w\\d\\.\\-\\_]+$": {
+                            "$ref": "#/definitions/specificationExtension"
+                        }
+                    }
+                }
+            ]
+        },
+        "specificationExtension": {
+            "oneOf": [
+                {
+                    "type": "object",
+                    "description": "Any property starting with x- is valid.",
+                    "additionalProperties": true
+                },
+                {}
+            ]
+        }
+    }
+}

package/dist/core/workflow-deploy.d.ts

@@ -0,0 +1,10 @@
+import { BumpApi } from '../api/index.js';
+import { WorkflowVersionRequest, WorkflowVersionResponse } from '../api/models.js';
+import { API } from '../definition.js';
+export declare class WorkflowDeploy {
+    private _bump;
+    constructor(bumpClient: BumpApi);
+    protected createWorkflowVersion(mcpServer: string, request: WorkflowVersionRequest, token: string): Promise<WorkflowVersionResponse | undefined>;
+    d(formatter: any, ...args: any[]): void;
+    run(workflowDefinition: API, mcpServer: string, token: string): Promise<WorkflowVersionResponse | undefined>;
+}

package/dist/core/workflow-deploy.js

@@ -0,0 +1,38 @@
+import debug from 'debug';
+export class WorkflowDeploy {
+    _bump;
+    constructor(bumpClient) {
+        this._bump = bumpClient;
+    }
+    async createWorkflowVersion(mcpServer, request, token) {
+        const response = await this._bump.postMCPServerDeploy(mcpServer, request, token);
+        let version;
+        switch (response.status) {
+            case 204: {
+                break; // MCP server workflow document already exists
+            }
+            case 201: {
+                version = response.data;
+                break;
+            }
+            default: {
+                this.d(`API status response was ${response.status}. Expected 201 or 204.`);
+                throw new Error('Unexpected server response. Please contact support at https://bump.sh if this error persists');
+            }
+        }
+        return version;
+    }
+    /* eslint-disable-next-line @typescript-eslint/no-explicit-any */
+    d(formatter, ...args) {
+        return debug(`bump-cli:core:deploy`)(formatter, ...args);
+    }
+    async run(workflowDefinition, mcpServer, token) {
+        let version;
+        const request = {
+            definition: workflowDefinition.rawDefinition,
+        };
+        // eslint-disable-next-line prefer-const
+        version = await this.createWorkflowVersion(mcpServer, request, token);
+        return version;
+    }
+}

package/dist/definition.d.ts

@@ -2,6 +2,7 @@ import { JSONSchema4, JSONSchema4Array, JSONSchema4Object, JSONSchema6, JSONSche
 type SpecSchema = JSONSchema4 | JSONSchema6 | JSONSchema7;
 declare class SupportedFormat {
     static readonly asyncapi: Record<string, SpecSchema>;
+    static readonly flower: Record<string, SpecSchema>;
     static readonly openapi: Record<string, SpecSchema>;
 }
 declare class API {
@@ -10,19 +11,19 @@ declare class API {
     overlayedDefinition: APIDefinition | undefined;
     readonly rawDefinition: string;
     readonly references: APIReference[];
-    readonly spec?: SpecSchema;
-    readonly specName: string;
-    readonly version: string;
+    readonly specName?: string;
+    readonly version?: string;
     constructor(location: string, values: SpecSchema);
     static isAsyncAPI(definition: JSONSchema4Object | JSONSchema6Object): definition is AsyncAPI;
+    static isFlower(definition: JSONSchema4Object | JSONSchema6Object): definition is Flower;
     static isOpenAPI(definition: JSONSchema4Object | JSONSchema6Object): definition is OpenAPI;
     static isOpenAPIOverlay(definition: JSONSchema4Object | JSONSchema6Object): definition is OpenAPIOverlay;
     static load(path: string): Promise<API>;
     applyOverlay(overlayPath: string): Promise<void>;
     extractDefinition(outputPath?: string, overlays?: string[] | undefined): Promise<[string, APIReference[]]>;
-    getSpec(definition: APIDefinition): SpecSchema;
-    getSpecName(definition: APIDefinition): string;
-    getVersion(definition: APIDefinition): string;
+    getSpec(definition: APIDefinition): SpecSchema | undefined;
+    getSpecName(definition: APIDefinition): string | undefined;
+    getVersion(definition: APIDefinition): string | undefined;
     guessFormat(output?: string): string;
     isMainRefPath(path: string): boolean;
     resolveContent(values: SpecSchema): [string, APIDefinition];
@@ -35,7 +36,7 @@ type APIReference = {
     content: string;
     location: string;
 };
-type APIDefinition = AsyncAPI | OpenAPI | OpenAPIOverlay;
+type APIDefinition = AsyncAPI | Flower | OpenAPI | OpenAPIOverlay;
 type InfoObject = {
     readonly description?: string;
     readonly title: string;
@@ -55,4 +56,7 @@ type AsyncAPI = {
     readonly asyncapi: string;
     readonly info: InfoObject;
 } & JSONSchema4Object;
-export { API, APIDefinition, OpenAPIOverlay, SupportedFormat };
+type Flower = {
+    readonly flower: string;
+} & JSONSchema4Object;
+export { API, APIDefinition, OpenAPI, OpenAPIOverlay, SupportedFormat };

package/dist/definition.js

@@ -5,6 +5,7 @@ import { parseWithPointers, safeStringify } from '@stoplight/yaml';
 import debug from 'debug';
 import { default as nodePath } from 'node:path';
 import { Overlay } from './core/overlay.js';
+import flowerSchemas from './core/schemas/flower-schemas/index.js';
 import openapiSchemas from './core/schemas/oas-schemas/index.js';
 class SupportedFormat {
     static asyncapi = {
@@ -16,6 +17,9 @@ class SupportedFormat {
         '2.5': asyncapi.schemas['2.5.0'],
         '2.6': asyncapi.schemas['2.6.0'],
     };
+    static flower = {
+        '0.1': flowerSchemas.schemas['0.1'],
+    };
     static openapi = {
         '2.0': openapiSchemas.schemas['2.0'],
         '3.0': openapiSchemas.schemas['3.0'],
@@ -40,7 +44,6 @@ class API {
     overlayedDefinition;
     rawDefinition;
     references;
-    spec;
     specName;
     version;
     constructor(location, values) {
@@ -51,14 +54,16 @@ class API {
         this.definition = parsed;
         this.specName = this.getSpecName(parsed);
         this.version = this.getVersion(parsed);
-        this.spec = this.getSpec(parsed);
-        if (this.spec === undefined) {
+        if (!this.getSpec(parsed)) {
             throw new UnsupportedFormat(`${this.specName} ${this.version}`);
         }
     }
     static isAsyncAPI(definition) {
         return 'asyncapi' in definition;
     }
+    static isFlower(definition) {
+        return 'flower' in definition;
+    }
     static isOpenAPI(definition) {
         return typeof definition.openapi === 'string' || typeof definition.swagger === 'string';
     }
@@ -159,19 +164,43 @@ class API {
         if (API.isOpenAPIOverlay(definition)) {
             return { overlay: { type: 'string' } };
         }
-        return SupportedFormat.openapi[this.versionWithoutPatch()];
+        if (API.isFlower(definition)) {
+            return SupportedFormat.flower[this.versionWithoutPatch()];
+        }
+        if (API.isOpenAPI(definition)) {
+            return SupportedFormat.openapi[this.versionWithoutPatch()];
+        }
+        return undefined;
     }
     getSpecName(definition) {
         if (API.isAsyncAPI(definition)) {
             return 'AsyncAPI';
         }
-        return 'OpenAPI';
+        if (API.isFlower(definition)) {
+            return 'Flower';
+        }
+        if (API.isOpenAPIOverlay(definition)) {
+            return 'OpenAPIOverlay';
+        }
+        if (API.isOpenAPI(definition)) {
+            return 'OpenAPI';
+        }
+        return undefined;
     }
     getVersion(definition) {
         if (API.isAsyncAPI(definition)) {
             return definition.asyncapi;
         }
-        return (definition.openapi || definition.swagger);
+        if (API.isFlower(definition)) {
+            return definition.flower;
+        }
+        if (API.isOpenAPIOverlay(definition)) {
+            return definition.overlay;
+        }
+        if (API.isOpenAPI(definition)) {
+            return (definition.openapi || definition.swagger);
+        }
+        return undefined;
     }
     guessFormat(output) {
         return (output || this.location).endsWith('.json') ? 'json' : 'yaml';
@@ -208,11 +237,11 @@ class API {
             }
         }
         const { parsed, raw } = mainReference;
-        if (!parsed || !raw || !(parsed instanceof Object) || !('info' in parsed)) {
+        if (!parsed || !raw || !(parsed instanceof Object) || !('info' in parsed || 'flower' in parsed)) {
             debug('bump-cli:definition')(`Main location (${this.location}) not found or empty (within ${JSON.stringify(Object.keys(values))})`);
-            throw new UnsupportedFormat("Definition needs to be an object with at least an 'info' key");
+            throw new UnsupportedFormat('Definition needs to be a valid Object');
         }
-        if (!API.isOpenAPI(parsed) && !API.isAsyncAPI(parsed) && !API.isOpenAPIOverlay(parsed)) {
+        if (!API.isOpenAPI(parsed) && !API.isAsyncAPI(parsed) && !API.isOpenAPIOverlay(parsed) && !API.isFlower(parsed)) {
             throw new UnsupportedFormat();
         }
         return [raw, parsed];
@@ -243,6 +272,9 @@ class API {
         return this.rawDefinition;
     }
     versionWithoutPatch() {
+        if (!this.version) {
+            return '';
+        }
         const [major, minor] = this.version.split('.', 3);
         return `${major}.${minor}`;
     }

package/dist/flags.d.ts

@@ -46,4 +46,8 @@ declare const overlay: Interfaces.FlagDefinition<string[], Interfaces.CustomOpti
     multiple: true;
     requiredOrDefaulted: false;
 }>;
-export { autoCreate, branch, doc, docName, dryRun, expires, failOnBreaking, filenamePattern, format, hub, interactive, live, open, out, overlay, preview, token, };
+declare const mcpServer: Interfaces.FlagDefinition<string, Interfaces.CustomOptions, {
+    multiple: false;
+    requiredOrDefaulted: false;
+}>;
+export { autoCreate, branch, doc, docName, dryRun, expires, failOnBreaking, filenamePattern, format, hub, interactive, live, mcpServer, open, out, overlay, preview, token, };

package/dist/flags.js

@@ -45,7 +45,7 @@ const token = Flags.custom({
         if (envToken)
             return envToken;
     },
-    description: 'Documentation or Hub token. Can be provided via BUMP_TOKEN environment variable',
+    description: 'Documentation, Hub or Organization token. Can be provided via BUMP_TOKEN environment variable',
     required: true,
 });
 const autoCreate = (opts = {}) => {
@@ -123,4 +123,8 @@ const overlay = Flags.custom({
     description: 'Path or URL of overlay file(s) to apply before deploying',
     multiple: true,
 });
-export { autoCreate, branch, doc, docName, dryRun, expires, failOnBreaking, filenamePattern, format, hub, interactive, live, open, out, overlay, preview, token, };
+const mcpServer = Flags.custom({
+    char: 'm',
+    description: 'MCP server id or slug',
+});
+export { autoCreate, branch, doc, docName, dryRun, expires, failOnBreaking, filenamePattern, format, hub, interactive, live, mcpServer, open, out, overlay, preview, token, };

package/oclif.manifest.json

@@ -11,10 +11,11 @@
       },
       "description": "Create a new version of your documentation from the given file or URL.",
       "examples": [
-        "Deploy a new version of an existing documentation\n\n$ bump deploy FILE --doc <your_doc_id_or_slug> --token <your_doc_token>\n* Let's deploy on Bump.sh... done\n* Your new documentation version will soon be ready\n",
-        "Deploy a new version of an existing documentation attached to a hub\n\n$ bump deploy FILE --doc <doc_slug> --hub <your_hub_id_or_slug> --token <your_doc_token>\n* Let's deploy on Bump.sh... done\n* Your new documentation version will soon be ready\n",
-        "Deploy a whole directory of API definitions files to a hub\n\n$ bump deploy DIR --filename-pattern *-{slug}-api --hub <hub_slug> --token <hub_token>\nWe've found 2 valid API definitions to deploy\n└─ DIR\n   └─ source-my-service-api.yml (OpenAPI spec version 3.1.0)\n   └─ source-my-jobs-service-api.yml (AsyncAPI spec version 2.6.0)\n\nLet's deploy those documentations to your <hub_slug> hub on Bump.sh\n\n* Your new documentation version will soon be ready\nLet's deploy a new version to your my-service documentation on Bump.sh... done\n\n* Your new documentation version will soon be ready\nLet's deploy a new version to your my-jobs-service documentation on Bump.sh... done\n",
-        "Validate a new documentation version before deploying it\n\n$ bump deploy FILE --dry-run --doc <doc_slug> --token <your_doc_token>\n* Let's validate on Bump.sh... done\n* Definition is valid\n"
+        "Deploy a new version of \u001b[4man existing documentation\u001b[24m\n\n\u001b[2m$ bump deploy FILE --doc <your_doc_id_or_slug> --token <your_doc_token>\u001b[22m\n* Let's deploy on Bump.sh... done\n* Your new documentation version will soon be ready\n",
+        "Deploy a new version of \u001b[4man existing documentation attached to a hub\u001b[24m\n\n\u001b[2m$ bump deploy FILE --doc <doc_slug> --hub <your_hub_id_or_slug> --token <your_doc_token>\u001b[22m\n* Let's deploy on Bump.sh... done\n* Your new documentation version will soon be ready\n",
+        "Deploy a whole directory of \u001b[4mAPI definitions files to a hub\u001b[24m\n\n\u001b[2m$ bump deploy DIR --filename-pattern *-{slug}-api --hub <hub_slug> --token <hub_token>\u001b[22m\nWe've found 2 valid API definitions to deploy\n└─ DIR\n   └─ source-my-service-api.yml (OpenAPI spec version 3.1.0)\n   └─ source-my-jobs-service-api.yml (AsyncAPI spec version 2.6.0)\n\nLet's deploy those documentations to your <hub_slug> hub on Bump.sh\n\n* Your new documentation version will soon be ready\nLet's deploy a new version to your my-service documentation on Bump.sh... done\n\n* Your new documentation version will soon be ready\nLet's deploy a new version to your my-jobs-service documentation on Bump.sh... done\n",
+        "\u001b[4mValidate a new documentation version\u001b[24m before deploying it\n\n\u001b[2m$ bump deploy FILE --dry-run --doc <doc_slug> --token <your_doc_token>\u001b[22m\n* Let's validate on Bump.sh... done\n* Definition is valid\n",
+        "Deploy a new workflow document of \u001b[4man existing MCP server\u001b[24m\n\n\u001b[2m$ bump deploy FILE --mcp-server <your_mcp_server_id_or_slug> --token <your_organization_token>\u001b[22m\n* Let's deploy on Bump.sh... done\n* Your <your_mcp_server_id_or_slug> MCP server... has received a new workflow definition which will soon be ready.\n"
       ],
       "flags": {
         "auto-create": {
@@ -84,6 +85,14 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "mcp-server": {
+          "char": "m",
+          "description": "MCP server id or slug",
+          "name": "mcp-server",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "overlay": {
           "char": "o",
           "description": "Path or URL of overlay file(s) to apply before deploying",
@@ -101,10 +110,9 @@
         },
         "token": {
           "char": "t",
-          "description": "Documentation or Hub token. Can be provided via BUMP_TOKEN environment variable",
+          "description": "Documentation, Hub or Organization token. Can be provided via BUMP_TOKEN environment variable",
           "name": "token",
           "required": true,
-          "default": "99f52837852249b328c0a00249f846a3",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -203,10 +211,9 @@
         },
         "token": {
           "char": "t",
-          "description": "Documentation or Hub token. Can be provided via BUMP_TOKEN environment variable",
+          "description": "Documentation, Hub or Organization token. Can be provided via BUMP_TOKEN environment variable",
           "name": "token",
           "required": false,
-          "default": "99f52837852249b328c0a00249f846a3",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -236,7 +243,7 @@
       },
       "description": "Apply an OpenAPI specified overlay to your API definition.",
       "examples": [
-        "Apply the OVERLAY_FILE to the existing DEFINITION_FILE. The resulting\ndefinition is output on stdout meaning you can redirect it to a new\nfile.\n\n$ bump overlay DEFINITION_FILE OVERLAY_FILE > destination/file.json\n* Let's apply the overlay to the main definition... done\n"
+        "Apply the OVERLAY_FILE to the existing DEFINITION_FILE. The resulting\ndefinition is output on stdout meaning you can redirect it to a new\nfile.\n\n\u001b[2m$ bump overlay DEFINITION_FILE OVERLAY_FILE > destination/file.json\u001b[22m\n* Let's apply the overlay to the main definition... done\n"
       ],
       "flags": {
         "out": {
@@ -294,5 +301,5 @@
       "strict": true
     }
   },
-  "version": "2.9.10"
+  "version": "2.9.12"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "bump-cli",
   "description": "The Bump CLI is used to interact with your API documentation hosted on Bump.sh by using the API of developers.bump.sh",
-  "version": "2.9.10",
+  "version": "2.9.12",
   "author": "Paul Bonaud <paulr@bump.sh>",
   "bin": {
     "bump": "./bin/run.js"
@@ -17,7 +17,7 @@
     "@types/node": "^24",
     "@types/sinon": "^17.0.3",
     "@typescript-eslint/eslint-plugin": "^8.13.0",
-    "chai": "^5.1.2",
+    "chai": "^6.2.2",
     "eslint": "^8",
     "eslint-config-oclif": "^5",
     "eslint-config-oclif-typescript": "^3",
@@ -26,11 +26,11 @@
     "mocha": "^11",
     "mock-stdin": "^1.0.0",
     "nock": "^14.0.0-beta.16",
-    "np": "^10.1.0",
+    "np": "^11.0.2",
     "nyc": "^17.1.0",
     "oclif": "^4",
     "shx": "^0.4.0",
-    "sinon": "^19.0.2",
+    "sinon": "^21.0.1",
     "ts-node": "^10",
     "typescript": "^5"
   },
@@ -101,7 +101,7 @@
     "axios": "^1.7.7",
     "chalk": "^5.3.0",
     "debug": "^4.3.7",
-    "jsonpathly": "^2.0.2",
+    "jsonpathly": "^3.0.0",
     "mergician": "^2.0.2",
     "open": "^10.1.0"
   }