ossput 0.0.1

package/dist/mcp.js

@@ -0,0 +1,244 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { formatPrefixDisplay } from "./config.js";
+import { configExists, findProjectOssputJson, listProfileNames, loadConfigWithProfile, INDEX_CONFIG_PATH, } from "./config-profiles.js";
+import { listConfiguredClients } from "./setup/mcp-registry.js";
+import { formatDirectoriesAsMarkdown, listDirectories, } from "./list-directories.js";
+import { formatListAsMarkdown } from "./list-format.js";
+import { listObjects } from "./list-objects.js";
+import { confirmUpload, prepareUpload, uploadFile, } from "./upload-pipeline.js";
+import { batchUploadFile, MAX_BATCH_FILES } from "./batch-upload.js";
+import { deleteObject } from "./delete-object.js";
+import { inferContentType } from "./validators.js";
+import { getPackageVersion } from "./setup/mcp-registry.js";
+import { mcpJson, mcpText, runMcpTool } from "./mcp-result.js";
+import { MCP_DESTRUCTIVE, MCP_READ_ONLY, MCP_WRITE, } from "./mcp-annotations.js";
+import { NPX_DOCTOR, NPX_SETUP } from "./constants.js";
+const profileField = z
+    .string()
+    .optional()
+    .describe("Named profile; default from .ossput.json or global default");
+const INSTRUCTIONS = `You are connected to ossput — Aliyun OSS direct upload (presigned PUT via fetch).
+
+When the user wants to upload files to OSS / 阿里云:
+1. If not configured, ask them to run in terminal: ${NPX_SETUP} (do NOT ask for secrets in chat).
+2. Call list_profiles or read .ossput.json for activeProfile; optional profile param overrides.
+3. Prefer upload_file(localPath, subdir?). Object keys are: {prefix}{subdir}{YYYY}/{MM}/{uuid}.ext — not the original filename.
+4. list_objects(format=markdown) for image previews; list_directories for folder prefixes.
+5. Never upload .env, keys, or files over 100MB. Return objectUrl from tool results to the user.
+6. delete_object: ONLY after user confirms exact objectKey; requires profile allowDelete:true and confirm:true.
+7. Multiple local files: prefer batch_upload_file (max ${MAX_BATCH_FILES} per call) over many upload_file calls.`;
+async function requireResolved(profile) {
+    if (!(await configExists())) {
+        throw new Error(`ossput is not configured. Run in terminal: ${NPX_SETUP}`);
+    }
+    return loadConfigWithProfile({ profile });
+}
+export async function startMcpServer() {
+    const version = await getPackageVersion();
+    const server = new McpServer({
+        name: "ossput",
+        version,
+    }, {
+        instructions: INSTRUCTIONS,
+    });
+    server.registerTool("list_profiles", {
+        description: "List configured OSS profiles and which profile is active in the current workspace.",
+        inputSchema: z.object({}),
+        annotations: MCP_READ_ONLY,
+    }, async () => runMcpTool(async () => {
+        const rows = await listProfileNames();
+        let active = null;
+        if (rows.length > 0) {
+            try {
+                active = await loadConfigWithProfile();
+            }
+            catch {
+                active = null;
+            }
+        }
+        const projectFile = await findProjectOssputJson();
+        return mcpJson({
+            profiles: rows,
+            activeProfile: active?.resolved.name ?? null,
+            bindingSource: active?.resolved.source ?? null,
+            projectFile,
+        });
+    }));
+    server.registerTool("get_setup_status", {
+        description: "Check ossput configuration, active profile, and MCP client registration.",
+        inputSchema: z.object({
+            profile: profileField,
+        }),
+        annotations: MCP_READ_ONLY,
+    }, async ({ profile }) => runMcpTool(async () => {
+        const configured = await configExists();
+        const clientsConfigured = configured
+            ? await listConfiguredClients()
+            : [];
+        let body = {
+            configured,
+            indexPath: INDEX_CONFIG_PATH,
+            clientsConfigured,
+            setupCommand: NPX_SETUP,
+            doctorCommand: NPX_DOCTOR,
+        };
+        if (configured) {
+            const { config, resolved } = await loadConfigWithProfile({ profile });
+            body = {
+                ...body,
+                activeProfile: resolved.name,
+                bindingSource: resolved.source,
+                projectFile: resolved.projectFile ?? null,
+                prefix: formatPrefixDisplay(config.prefix),
+                bucket: config.bucket,
+                region: config.region,
+                publicBaseUrl: config.publicBaseUrl ?? null,
+                allowDelete: config.allowDelete === true,
+            };
+        }
+        return mcpJson(body);
+    }));
+    server.registerTool("list_directories", {
+        description: "List subdirectory prefixes under configured prefix. format=markdown for tree view.",
+        inputSchema: z.object({
+            profile: profileField,
+            subdir: z.string().optional(),
+            format: z.enum(["json", "markdown"]).optional(),
+        }),
+        annotations: MCP_READ_ONLY,
+    }, async ({ profile, subdir, format }) => runMcpTool(async () => {
+        const { config } = await requireResolved(profile);
+        const result = await listDirectories(config, { subdir });
+        if (format === "markdown") {
+            return mcpText(formatDirectoriesAsMarkdown(result));
+        }
+        return mcpJson(result);
+    }));
+    server.registerTool("list_objects", {
+        description: "List OSS objects. format=markdown for image previews; imagesOnly to filter images.",
+        inputSchema: z.object({
+            profile: profileField,
+            subdir: z.string().optional(),
+            maxKeys: z.number().int().min(1).max(1000).optional(),
+            format: z.enum(["json", "markdown"]).optional(),
+            imagesOnly: z.boolean().optional(),
+            previewMax: z.number().int().min(1).max(50).optional(),
+        }),
+        annotations: MCP_READ_ONLY,
+    }, async ({ profile, subdir, maxKeys, format, imagesOnly, previewMax }) => runMcpTool(async () => {
+        const { config } = await requireResolved(profile);
+        const result = await listObjects(config, {
+            subdir,
+            maxKeys,
+            imagesOnly,
+        });
+        if (format === "markdown") {
+            return mcpText(formatListAsMarkdown(result, { previewMax }));
+        }
+        return mcpJson(result);
+    }));
+    server.registerTool("upload_file", {
+        description: "Upload a local file to Aliyun OSS (presigned PUT). Returns objectKey and objectUrl.",
+        inputSchema: z.object({
+            profile: profileField,
+            localPath: z.string(),
+            subdir: z.string().optional(),
+            contentType: z.string().optional(),
+        }),
+        annotations: MCP_WRITE,
+    }, async ({ profile, localPath, subdir, contentType }) => runMcpTool(async () => {
+        const { config } = await requireResolved(profile);
+        const result = await uploadFile(config, localPath, subdir, contentType);
+        return mcpJson(result);
+    }));
+    server.registerTool("batch_upload_file", {
+        description: `Batch upload local files (max ${MAX_BATCH_FILES} per call). Same rules as upload_file. Returns per-file success or error.`,
+        inputSchema: z.object({
+            profile: profileField,
+            localPaths: z.array(z.string()).min(1).max(MAX_BATCH_FILES),
+            subdir: z.string().optional(),
+            contentType: z.string().optional(),
+            stopOnError: z.boolean().optional(),
+        }),
+        annotations: MCP_WRITE,
+    }, async ({ profile, localPaths, subdir, contentType, stopOnError }) => runMcpTool(async () => {
+        const { config } = await requireResolved(profile);
+        const result = await batchUploadFile(config, localPaths, {
+            subdir,
+            contentType,
+            stopOnError: stopOnError ?? false,
+        });
+        return mcpJson(result);
+    }));
+    server.registerTool("delete_object", {
+        description: "Delete one OSS object. Destructive: requires profile allowDelete:true, objectKey under profile prefix, and confirm:true after user approval.",
+        inputSchema: z.object({
+            profile: profileField,
+            objectKey: z.string().describe("Exact key from list_objects or upload result"),
+            confirm: z
+                .literal(true)
+                .describe("Must be true after the user explicitly confirms deletion"),
+        }),
+        annotations: MCP_DESTRUCTIVE,
+    }, async ({ profile, objectKey, confirm }) => runMcpTool(async () => {
+        const { config } = await requireResolved(profile);
+        const result = await deleteObject(config, objectKey, { confirm });
+        return mcpJson(result);
+    }));
+    server.registerTool("prepare_upload", {
+        description: "Generate presigned PUT URL and objectKey.",
+        inputSchema: z.object({
+            profile: profileField,
+            filename: z.string(),
+            contentType: z.string(),
+            subdir: z.string().optional(),
+            overwrite: z.boolean().optional(),
+        }),
+        annotations: MCP_WRITE,
+    }, async ({ profile, filename, contentType, subdir, overwrite }) => runMcpTool(async () => {
+        const { config } = await requireResolved(profile);
+        const result = await prepareUpload(config, filename, contentType, subdir, overwrite ?? false);
+        return mcpJson(result);
+    }));
+    server.registerTool("confirm_upload", {
+        description: "Verify object exists on OSS after upload.",
+        inputSchema: z.object({
+            profile: profileField,
+            objectKey: z.string(),
+            expectedSizeBytes: z.number().optional(),
+        }),
+        annotations: MCP_READ_ONLY,
+    }, async ({ profile, objectKey, expectedSizeBytes }) => runMcpTool(async () => {
+        const { config } = await requireResolved(profile);
+        const result = await confirmUpload(config, objectKey, expectedSizeBytes);
+        return mcpJson(result);
+    }));
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+export async function getSetupStatusJson(profile) {
+    const configured = await configExists();
+    const base = {
+        configured,
+        indexPath: INDEX_CONFIG_PATH,
+        clientsConfigured: configured ? await listConfiguredClients() : [],
+        setupCommand: NPX_SETUP,
+        doctorCommand: NPX_DOCTOR,
+    };
+    if (!configured)
+        return base;
+    const { config, resolved } = await loadConfigWithProfile({ profile });
+    return {
+        ...base,
+        activeProfile: resolved.name,
+        bindingSource: resolved.source,
+        projectFile: resolved.projectFile ?? null,
+        prefix: formatPrefixDisplay(config.prefix),
+        bucket: config.bucket,
+        region: config.region,
+        publicBaseUrl: config.publicBaseUrl ?? null,
+    };
+}
+export { inferContentType };

package/dist/object-key.d.ts

@@ -0,0 +1,10 @@
+import type { AppConfig } from "./types.js";
+/** 规范化 OSS 对象 Key（无前导斜杠） */
+export declare function normalizeObjectKey(objectKey: string): string;
+/**
+ * 删除前校验 Key 落在当前 profile 允许范围内。
+ * - 有 prefix：Key 必须以 prefix 开头且长于 prefix
+ * - 无 prefix（桶根）：须 allowDelete，且至少 subdir/file 两段路径
+ */
+export declare function assertObjectKeyDeletable(config: AppConfig, objectKey: string): string;
+export declare function assertDeleteEnabled(config: AppConfig): void;

package/dist/object-key.js

@@ -0,0 +1,46 @@
+import { formatPrefixDisplay } from "./config.js";
+/** 规范化 OSS 对象 Key（无前导斜杠） */
+export function normalizeObjectKey(objectKey) {
+    const key = objectKey.trim().replace(/^\/+/, "");
+    if (!key) {
+        throw new Error("objectKey cannot be empty");
+    }
+    if (key.includes("..")) {
+        throw new Error("objectKey must not contain '..'");
+    }
+    if (key.endsWith("/")) {
+        throw new Error("objectKey must point to a file, not a directory prefix");
+    }
+    return key;
+}
+/**
+ * 删除前校验 Key 落在当前 profile 允许范围内。
+ * - 有 prefix：Key 必须以 prefix 开头且长于 prefix
+ * - 无 prefix（桶根）：须 allowDelete，且至少 subdir/file 两段路径
+ */
+export function assertObjectKeyDeletable(config, objectKey) {
+    const key = normalizeObjectKey(objectKey);
+    const prefix = config.prefix;
+    if (prefix) {
+        if (!key.startsWith(prefix)) {
+            throw new Error(`objectKey must start with profile prefix '${formatPrefixDisplay(prefix)}'`);
+        }
+        if (key.length <= prefix.length) {
+            throw new Error("objectKey must name a file under the profile prefix");
+        }
+        return key;
+    }
+    if (config.allowDelete !== true) {
+        throw new Error("delete is disabled when profile prefix is bucket root; set allowDelete: true in profile JSON only if you accept the risk");
+    }
+    const segments = key.split("/").filter(Boolean);
+    if (segments.length < 2) {
+        throw new Error("with bucket-root prefix, objectKey must be at least subdir/filename (2 path segments)");
+    }
+    return key;
+}
+export function assertDeleteEnabled(config) {
+    if (config.allowDelete !== true) {
+        throw new Error("delete is disabled for this profile; set allowDelete: true in ~/.config/ossput/profiles/<name>.json");
+    }
+}

package/dist/oss-client.d.ts

@@ -0,0 +1,4 @@
+import OSS from "ali-oss";
+import type { AppConfig } from "./types.js";
+export declare function createOssClient(config: AppConfig): OSS;
+export declare function publicObjectUrl(config: AppConfig, objectKey: string): string;

package/dist/oss-client.js

@@ -0,0 +1,24 @@
+import OSS from "ali-oss";
+export function createOssClient(config) {
+    const opts = {
+        region: config.region,
+        accessKeyId: config.accessKeyId,
+        accessKeySecret: config.accessKeySecret,
+        bucket: config.bucket,
+        secure: true,
+    };
+    if (config.endpoint) {
+        opts.endpoint = config.endpoint;
+    }
+    return new OSS(opts);
+}
+export function publicObjectUrl(config, objectKey) {
+    if (config.publicBaseUrl) {
+        return `${config.publicBaseUrl}/${objectKey}`;
+    }
+    if (config.endpoint) {
+        const host = config.endpoint.replace(/^https?:\/\//, "");
+        return `https://${config.bucket}.${host}/${objectKey}`;
+    }
+    return `https://${config.bucket}.${config.region}.aliyuncs.com/${objectKey}`;
+}

package/dist/profile-cli.d.ts

@@ -0,0 +1,16 @@
+export declare function runProfileList(): Promise<void>;
+export declare function runProfileShow(name?: string): Promise<void>;
+export interface ProfileAddOptions {
+    name?: string;
+    nonInteractive?: boolean;
+    configPath?: string;
+    skipConnectivity?: boolean;
+    setDefault?: boolean;
+    bindProject?: boolean;
+    label?: string;
+}
+export declare function runProfileAdd(options?: ProfileAddOptions): Promise<void>;
+export declare function runProfileUse(name: string, cwd?: string): Promise<void>;
+export declare function runProfileDefault(name: string): Promise<void>;
+export declare function runProfileRm(name: string): Promise<void>;
+export declare function runProfileCommand(sub: string, rest: string[], flags: Record<string, string | boolean>): Promise<number>;

package/dist/profile-cli.js

@@ -0,0 +1,191 @@
+import { confirm } from "@inquirer/prompts";
+import { formatPrefixDisplay, listProfileNames, loadConfigWithProfile, loadIndex, profileExists, profileFilePath, removeProfile, saveProfile, setDefaultProfile, validateProfileName, writeProjectBinding, } from "./config-profiles.js";
+import { maskSecret, printHint, ui } from "./setup/ui.js";
+import { promptOssConfig, promptProfileIdentity, } from "./setup/prompts.js";
+import { testConnectivity } from "./setup/connectivity.js";
+import { withSpinner } from "./setup/ui.js";
+export async function runProfileList() {
+    const rows = await listProfileNames();
+    if (rows.length === 0) {
+        console.log("No profiles. Run: ossput setup  or  ossput profile add <name>");
+        return;
+    }
+    for (const row of rows) {
+        const mark = row.isDefault ? "*" : " ";
+        const label = row.label ? `  ${row.label}` : "";
+        console.log(`${mark} ${row.name}${label}`);
+    }
+}
+export async function runProfileShow(name) {
+    const resolved = name
+        ? { name, source: "arg" }
+        : (await loadConfigWithProfile()).resolved;
+    const target = name ?? resolved.name;
+    const { config } = await loadConfigWithProfile({ profile: target });
+    const index = await loadIndex();
+    const label = index?.profiles[target]?.label;
+    console.log(JSON.stringify({
+        profile: target,
+        label: label ?? null,
+        region: config.region,
+        bucket: config.bucket,
+        prefix: formatPrefixDisplay(config.prefix),
+        accessKeyId: maskSecret(config.accessKeyId, 6),
+        endpoint: config.endpoint,
+        presignExpiresSec: config.presignExpiresSec,
+        allowedExtensions: config.allowedExtensions,
+        file: profileFilePath(target),
+    }, null, 2));
+}
+export async function runProfileAdd(options = {}) {
+    let name = options.name?.trim();
+    let label = options.label;
+    if (!options.nonInteractive) {
+        const identity = await promptProfileIdentity({
+            name,
+            requireNew: true,
+        });
+        name = identity.name;
+        label = identity.label ?? label;
+    }
+    else {
+        if (!name)
+            name = "default";
+        const valid = validateProfileName(name);
+        if (valid !== true)
+            throw new Error(valid);
+        if (await profileExists(name)) {
+            throw new Error(`Profile "${name}" already exists`);
+        }
+    }
+    if (!name)
+        throw new Error("Profile name is required");
+    let config;
+    if (options.nonInteractive && options.configPath) {
+        const { readFile } = await import("node:fs/promises");
+        const { parseConfig } = await import("./config.js");
+        config = parseConfig(JSON.parse(await readFile(options.configPath, "utf8")));
+    }
+    else if (options.nonInteractive) {
+        throw new Error("--non-interactive requires --config <path>");
+    }
+    else {
+        config = await promptOssConfig({ excludeProfile: name });
+    }
+    await saveProfile(name, config, {
+        label,
+        setDefault: options.setDefault,
+    });
+    console.log(ui.green(`✓ 已写入 ${profileFilePath(name)}`));
+    if (!options.skipConnectivity) {
+        try {
+            await withSpinner("正在检测 OSS 连通性", async () => {
+                await testConnectivity(config);
+            });
+            console.log(ui.green("  ✓ Bucket 连通性正常"));
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.log(ui.yellow(`  ⚠ 连通性检测未通过：${msg}`));
+        }
+    }
+    if (!options.nonInteractive) {
+        const makeDefault = options.setDefault ??
+            (await confirm({
+                message: "是否设为全局默认账号（defaultProfile）？",
+                default: !(await loadIndex()),
+            }));
+        if (makeDefault) {
+            await setDefaultProfile(name);
+            printHint(`默认账号已设为 ${ui.bold(name)}`);
+        }
+        const bind = options.bindProject ??
+            (await confirm({
+                message: `在当前目录写入 .ossput.json，绑定 profile「${name}」？`,
+                default: true,
+            }));
+        if (bind) {
+            const p = await writeProjectBinding(name);
+            console.log(ui.green(`✓ 已写入 ${p}`));
+        }
+    }
+    else {
+        if (options.setDefault)
+            await setDefaultProfile(name);
+        if (options.bindProject)
+            await writeProjectBinding(name);
+    }
+}
+export async function runProfileUse(name, cwd) {
+    const valid = validateProfileName(name);
+    if (valid !== true)
+        throw new Error(valid);
+    if (!(await profileExists(name))) {
+        throw new Error(`Profile "${name}" not found. Run: ossput profile list`);
+    }
+    const path = await writeProjectBinding(name, cwd);
+    console.log(ui.green(`✓ 已绑定 profile "${name}" → ${path}`));
+}
+export async function runProfileDefault(name) {
+    await setDefaultProfile(name);
+    console.log(ui.green(`✓ 默认 profile: ${name}`));
+}
+export async function runProfileRm(name) {
+    await removeProfile(name);
+    console.log(ui.green(`✓ 已删除 profile: ${name}`));
+}
+export async function runProfileCommand(sub, rest, flags) {
+    switch (sub) {
+        case "list":
+        case "ls":
+            await runProfileList();
+            return 0;
+        case "show":
+            await runProfileShow(rest[0]);
+            return 0;
+        case "add": {
+            await runProfileAdd({
+                name: rest[0],
+                nonInteractive: Boolean(flags.nonInteractive),
+                configPath: typeof flags.config === "string" ? flags.config : undefined,
+                skipConnectivity: Boolean(flags.skipConnectivity),
+                setDefault: flags.setDefault === true || flags.setDefault === "true",
+                bindProject: flags.bindProject === true || flags.bindProject === "true",
+                label: typeof flags.label === "string" ? flags.label : undefined,
+            });
+            return 0;
+        }
+        case "use":
+            if (!rest[0]) {
+                console.error("Usage: ossput profile use <name>");
+                return 1;
+            }
+            await runProfileUse(rest[0]);
+            return 0;
+        case "default":
+            if (!rest[0]) {
+                console.error("Usage: ossput profile default <name>");
+                return 1;
+            }
+            await runProfileDefault(rest[0]);
+            return 0;
+        case "rm":
+        case "remove":
+            if (!rest[0]) {
+                console.error("Usage: ossput profile rm <name>");
+                return 1;
+            }
+            await runProfileRm(rest[0]);
+            return 0;
+        default:
+            console.error(`Unknown profile command: ${sub}`);
+            console.log(`Usage:
+  ossput profile list
+  ossput profile add [name]
+  ossput profile show [name]
+  ossput profile use <name>
+  ossput profile default <name>
+  ossput profile rm <name>`);
+            return 1;
+    }
+}

package/dist/setup/connectivity.d.ts

@@ -0,0 +1,2 @@
+import type { AppConfig } from "../types.js";
+export declare function testConnectivity(config: AppConfig): Promise<void>;

package/dist/setup/connectivity.js

@@ -0,0 +1,5 @@
+import { createOssClient } from "../oss-client.js";
+export async function testConnectivity(config) {
+    const client = createOssClient(config);
+    await client.getBucketInfo(config.bucket);
+}

package/dist/setup/logo.d.ts

@@ -0,0 +1 @@
+export declare function printAsciiLogo(version?: string): void;

package/dist/setup/logo.js

@@ -0,0 +1,30 @@
+const supportsColor = process.stdout.isTTY && process.env.NO_COLOR !== "1" && process.env.TERM !== "dumb";
+function style(codes, text) {
+    return supportsColor ? `\x1b[${codes}m${text}\x1b[0m` : text;
+}
+const front = (t) => style("1;96", t);
+const dim = (t) => style("2", t);
+/** ANSI Shadow 字体 OSSPUT（figlet） */
+const LOGO_LINES = [
+    " ██████╗ ███████╗███████╗██████╗ ██╗   ██╗████████╗",
+    "██╔═══██╗██╔════╝██╔════╝██╔══██╗██║   ██║╚══██╔══╝",
+    "██║   ██║███████╗███████╗██████╔╝██║   ██║   ██║   ",
+    "██║   ██║╚════██║╚════██║██╔═══╝ ██║   ██║   ██║   ",
+    "╚██████╔╝███████║███████║██║     ╚██████╔╝   ██║   ",
+    " ╚═════╝ ╚══════╝╚══════╝╚═╝      ╚═════╝    ╚═╝   ",
+];
+function pad(text, spaces) {
+    return " ".repeat(spaces) + text;
+}
+export function printAsciiLogo(version) {
+    console.log("");
+    for (const row of LOGO_LINES) {
+        console.log(pad(front(row), 2));
+    }
+    const tag = version != null
+        ? `── ossput v${version} · Aliyun OSS direct upload MCP ──`
+        : "── ossput · Aliyun OSS MCP ──";
+    console.log("");
+    console.log(pad(dim(tag), 2));
+    console.log("");
+}

package/dist/setup/mcp-registry.d.ts

@@ -0,0 +1,17 @@
+export interface McpClientDefinition {
+    id: string;
+    displayName: string;
+    resolveConfigPath: () => string | null;
+}
+export declare const MCP_CLIENTS: McpClientDefinition[];
+export declare const MCP_SERVER_NAME = "ossput";
+export declare function getPackageVersion(): Promise<string>;
+/** 使用当前安装包内的 dist/index.js，避免未发布到 npm 时 npx 404 */
+export declare function buildMcpServerEntry(_version: string): Record<string, unknown>;
+export declare function readMcpEntry(configPath: string, serverName: string): Promise<unknown | undefined>;
+export declare function readOurMcpEntry(configPath: string): Promise<unknown | undefined>;
+export declare function mergeMcpConfig(configPath: string, serverName: string, entry: Record<string, unknown>, options?: {
+    force?: boolean;
+}): Promise<"created" | "updated" | "skipped">;
+export declare function listConfiguredClients(): Promise<string[]>;
+export declare function formatMergeAction(action: string): string;