memshell-party-cli 0.7.0 → 0.8.1

package/dist/index.d.ts

@@ -2,7 +2,7 @@ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 
 /**
  * Type definitions mirroring the MemShellParty backend DTOs.
- * Source of truth: boot/src/main/java/com/reajason/javaweb/boot/{dto,vo,controller}
+ * Source of truth: memshell-party-{api,boot} (v3), with legacy v2 transport support.
  */
 interface ShellConfig {
     server: string;
@@ -15,15 +15,31 @@ interface ShellConfig {
     byPassJavaModule?: boolean;
     shrink?: boolean;
     lambdaSuffix?: boolean;
-    probe?: boolean;
+    /** v3 uses a ProbeConfig object; v2 used a boolean switch. */
+    probe?: boolean | ProbeConfig;
+    obfuscation?: ObfuscationConfig;
+    obfuscationScope?: "ALL" | "MEMSHELL_INJECTOR" | "INJECTOR" | "MEMSHELL";
 }
+type ShellToolConfigObject = Record<string, unknown>;
+type ShellToolConfigValue = string | ShellToolConfigObject;
 interface ShellToolConfig {
+    [key: string]: ShellToolConfigValue | undefined;
     shellClassName?: string;
+    pass?: string;
+    key?: string;
+    paramName?: string;
+    template?: string;
+    /** @deprecated MemShellParty v2 request field. */
     godzillaPass?: string;
+    /** @deprecated MemShellParty v2 request field. */
     godzillaKey?: string;
+    /** @deprecated MemShellParty v2 request field. */
     commandParamName?: string;
+    /** @deprecated MemShellParty v2 request field. */
     commandTemplate?: string;
+    /** @deprecated MemShellParty v2 request field. */
     behinderPass?: string;
+    /** @deprecated MemShellParty v2 request field. */
     antSwordPass?: string;
     headerName?: string;
     headerValue?: string;
@@ -36,6 +52,10 @@ interface InjectorConfig {
     urlPattern?: string;
     staticInitialize?: boolean;
 }
+interface ObfuscationConfig {
+    enabled?: boolean;
+    options?: Record<string, unknown>;
+}
 interface MemShellGenerateRequest {
     shellConfig: ShellConfig;
     shellToolConfig: ShellToolConfig;
@@ -59,18 +79,20 @@ interface MemShellGenerateResponse {
     packResult?: string;
     allPackResults?: Record<string, string>;
 }
-type ProbeMethod = "ResponseBody" | "DNSLog" | "Sleep";
-type ProbeContent = "BasicInfo" | "Server" | "OS" | "JDK" | "Bytecode" | "Command";
+type ProbeMethod = "ResponseBody" | "ResponseHeader" | "DNSLog" | "Sleep";
+type ProbeContent = "BasicInfo" | "Server" | "OS" | "JDK" | "Bytecode" | "Command" | "ScriptEngine" | "Filter";
 interface ProbeConfig {
     probeMethod: string;
     probeContent: string;
     shellClassName?: string;
+    respHeaderName?: string;
     targetJreVersion?: number;
     debug?: boolean;
     byPassJavaModule?: boolean;
     shrink?: boolean;
     staticInitialize?: boolean;
     lambdaSuffix?: boolean;
+    obfuscation?: ObfuscationConfig;
 }
 interface ProbeContentConfig {
     host?: string;
@@ -79,6 +101,7 @@ interface ProbeContentConfig {
     server?: string;
     reqParamName?: string;
     commandTemplate?: string;
+    respHeaderName?: string;
 }
 interface ProbeShellGenerateRequest {
     probeConfig: ProbeConfig;
@@ -97,6 +120,30 @@ interface ProbeShellGenerateResponse {
     packResult?: string;
     allPackResults?: Record<string, string>;
 }
+interface BytecodeResult {
+    className: string;
+    size: number;
+    classBytesBase64Str: string;
+}
+interface BytecodeTransformRequest {
+    classBytesBase64: string;
+    packer?: string;
+    byPassJavaModule?: boolean;
+    staticInitialize?: boolean;
+    shrink?: boolean;
+    renamePackage?: boolean;
+    relocateFrom?: string;
+    relocateTo?: string;
+    entryMethod?: string;
+    newClassName?: string;
+    randomName?: boolean;
+    obfuscation?: ObfuscationConfig;
+    server?: string;
+    probe?: ProbeConfig | null;
+}
+interface BytecodeTransformResponse extends BytecodeResult {
+    packResult?: string;
+}
 /** server name -> supported shell types */
 type ServerConfig = Record<string, string[]>;
 /** server name -> { shell tool -> supported shell types } */
@@ -110,6 +157,41 @@ interface CommandConfigVO {
     encryptors: string[];
     implementationClasses: string[];
 }
+interface ToolConfigParam {
+    name: string;
+    type: "string" | "enum" | "object";
+    options: string[];
+    group?: string;
+    label?: string;
+    placeholder?: string;
+    ui?: RemoteSelectUiHint;
+}
+interface ToolConfigDescriptor {
+    tool: string;
+    params: ToolConfigParam[];
+}
+type ObfuscationOption = Record<string, unknown>;
+interface RemoteSelectUiHint {
+    kind: "remote-select";
+    urlQueryParam: string;
+    itemsPath: string;
+    labelPath: string;
+    valuePath?: string;
+    required: boolean;
+}
+interface PluginDescriptor {
+    jarFileName: string;
+    name: string;
+    version?: string | null;
+    author?: string | null;
+    description?: string | null;
+    homepage?: string | null;
+    license?: string | null;
+    source?: string | null;
+    spiServices: string[];
+    loaded: boolean;
+    loadError?: string | null;
+}
 interface VersionInfo {
     currentVersion: string;
     latestVersion: string;
@@ -143,23 +225,25 @@ declare class MemPartyClient {
     private readonly baseUrl;
     private readonly fetchImpl;
     private readonly timeoutMs;
+    private generationApiVersion?;
     constructor(options: MemPartyClientOptions);
     getServers(): Promise<ServerConfig>;
     getConfig(): Promise<MainConfig>;
     getPackerTree(): Promise<PackerTree>;
     getPackers(): Promise<string[]>;
     getCommandConfigs(): Promise<CommandConfigVO>;
-    /**
-     * Servers the ResponseBody probe can write a response on.
-     * Only exists on backend >= 2.9.0 — callers should fall back to the full
-     * server list when this endpoint 404s.
-     */
-    getProbeResponseBodyServers(): Promise<string[]>;
+    getShellToolConfigs(): Promise<ToolConfigDescriptor[]>;
+    getObfuscationOptions(): Promise<ObfuscationOption[]>;
+    getProbeResponseServers(): Promise<string[]>;
     getVersion(): Promise<VersionInfo>;
+    getPlugins(): Promise<PluginDescriptor[]>;
     generateMemShell(req: MemShellGenerateRequest): Promise<MemShellGenerateResponse>;
+    private getGenerationApiVersion;
     generateProbe(req: ProbeShellGenerateRequest): Promise<ProbeShellGenerateResponse>;
     /** Parse a fully-qualified class name from a base64-encoded .class file. */
     parseClassName(classBase64: string): Promise<string>;
+    decodeBytecode(classBase64: string): Promise<BytecodeResult>;
+    transformBytecode(req: BytecodeTransformRequest): Promise<BytecodeTransformResponse>;
     private request;
 }
 
@@ -176,7 +260,12 @@ interface MemShellOptions {
     shrink?: boolean;
     lambdaSuffix?: boolean;
     probe?: boolean;
+    obfuscate?: boolean;
+    obfuscationOptions?: Record<string, unknown>;
+    obfuscationScope?: "ALL" | "MEMSHELL_INJECTOR" | "INJECTOR" | "MEMSHELL";
     shellClassName?: string;
+    shellToolConfig?: Record<string, ShellToolConfigValue>;
+    shellToolParams?: ToolConfigParam[];
     godzillaPass?: string;
     godzillaKey?: string;
     commandParamName?: string;
@@ -205,12 +294,15 @@ interface ProbeOptions {
     shrink?: boolean;
     staticInitialize?: boolean;
     lambdaSuffix?: boolean;
+    obfuscate?: boolean;
+    obfuscationOptions?: Record<string, unknown>;
     host?: string;
     seconds?: number;
     sleepServer?: string;
     server?: string;
     reqParamName?: string;
     commandTemplate?: string;
+    respHeaderName?: string;
 }
 declare function buildProbeRequest(opts: ProbeOptions): ProbeShellGenerateRequest;
 
@@ -269,6 +361,19 @@ declare const JDK_VERSIONS: Record<string, number>;
  */
 declare function resolveJreVersion(input: string | number | undefined): number | undefined;
 
+declare function toolConfigForTool(configs: ToolConfigDescriptor[], tool: string): ToolConfigDescriptor | undefined;
+declare function parseShellToolConfig(assignments: string[] | undefined, params: ToolConfigParam[] | undefined): Record<string, ShellToolConfigValue>;
+declare function parseToolConfigFile(source: string, params: ToolConfigParam[] | undefined): Record<string, ShellToolConfigValue>;
+declare function validateRequiredRemoteOptions(config: Record<string, ShellToolConfigValue>, params: ToolConfigParam[] | undefined): void;
+interface RemoteOption {
+    label: string;
+    value: ShellToolConfigValue;
+}
+declare function readRemotePath(value: unknown, path: string): unknown;
+declare function normalizeRemoteOptions(payload: unknown, hint: RemoteSelectUiHint, objectMode: boolean): RemoteOption[];
+declare function validateRemoteOptionsUrl(value: string): string;
+declare function fetchRemoteOptions(sourceUrl: string, hint: RemoteSelectUiHint, objectMode: boolean, fetchImpl?: typeof fetch, signal?: AbortSignal): Promise<RemoteOption[]>;
+
 type OpCategory = "gen" | "probe" | "connect" | "exec" | "download" | "upload" | "save" | "note" | "remove";
 interface OpLogEntry {
     /** ISO timestamp. */
@@ -363,6 +468,8 @@ interface CommonConnectOptions {
     extraHeaders?: Record<string, string>;
     timeoutMs?: number;
     insecure?: boolean;
+    /** Tomcat Upgrade shell protocol: the generated shell's fully-qualified class name. */
+    upgradeProtocol?: string;
 }
 
 /** A saved shell connection profile, stored inside a project. */
@@ -377,6 +484,8 @@ interface StoredShell {
     insecure?: boolean;
     /** mimic protocol: site profile name (see 'memparty profile'). */
     profile?: string;
+    /** Godzilla Upgrade shell protocol (generated shell class name). */
+    upgradeProtocol?: string;
     /** Free-form note for this shell (e.g. "DMZ 跳板机"). */
     remark?: string;
     createdAt: string;
@@ -420,6 +529,7 @@ interface ConnectionFlags {
     extraHeaders?: Record<string, string>;
     insecure?: boolean;
     profile?: string;
+    upgradeProtocol?: string;
 }
 interface ResolvedConnection {
     url: string;
@@ -432,6 +542,7 @@ interface ResolvedConnection {
     insecure?: boolean;
     /** mimic protocol: site profile name. */
     profile?: string;
+    upgradeProtocol?: string;
     /** Canonical `project/shell` reference, when resolved from the store. */
     targetName?: string;
 }
@@ -758,4 +869,4 @@ declare function testSuo5(url: string, options?: Suo5ConnectOptions): Promise<Co
 
 declare const CLI_VERSION: string;
 
-export { ApiError, type ApiErrorResponse, type BehinderConnectOptions, type BuildDeps, CLI_VERSION, type CommandConfigVO, type CommonConnectOptions, type ConnectTestResult, type ConnectTool, type ConnectionFlags, type CustomBuildInput, type CustomBuildResult, DEFAULT_API_URL, ENV_VAR, type ExecResult, type FetchLike, type FilterTemplateOptions, type GenerateClient, type GodzillaExecOptions, type InjectorConfig, type InstallSkillOptions, JDK_VERSIONS, LEGACY_CIPHER, type MainConfig, MemPartyClient, type MemPartyClientOptions, type MemShellGenerateRequest, type MemShellGenerateResponse, type MemShellOptions, type MemShellResult, type MimicCipher, OUTPUT_LIMIT, type OpCategory, type OpFilter, type OpLogEntry, type OutputOptions, type OutputResult, type PackerOption, type PackerTree, type ProbeConfig, type ProbeContent, type ProbeContentConfig, type ProbeMethod, type ProbeOptions, type ProbeShellGenerateRequest, type ProbeShellGenerateResponse, type ProbeShellResult, type ResolvedConnection, SKILL_NAME, type ServerConfig, type ShellConfig, type ShellInput, type ShellToolConfig, type SkillInstallResult, type SkillScope, type StoredProject, type StoredShell, type Suo5ConnectOptions, type Suo5Mode, type VersionInfo, autoSaveShell, buildCustomMemshell, buildMemShellRequest, buildProbeRequest, createMcpServer, defaultClassName, deriveMarkers, emitPayload, execBehinder, execGodzilla, formatOp, getProject, hasJavac, installSkill, listProjects, logOp, marshalFrameBase64, marshalSuo5Map, opLogPath, profileSecretFields, readOps, removeProject, removeShell, renderCryptoProbe, renderFilterJava, resolveApiUrl, resolveCipher, resolveConnection, resolveJreVersion, saveProjectMeta, saveShell, saveShellMeta, shouldDecode, skillSourceDir, skillTargetDir, startMcpStdio, targetStorePath, testBehinder, testGodzilla, testSuo5, truncateOutput, unmarshalFrameBase64, unmarshalSuo5Map };
+export { ApiError, type ApiErrorResponse, type BehinderConnectOptions, type BuildDeps, type BytecodeResult, type BytecodeTransformRequest, type BytecodeTransformResponse, CLI_VERSION, type CommandConfigVO, type CommonConnectOptions, type ConnectTestResult, type ConnectTool, type ConnectionFlags, type CustomBuildInput, type CustomBuildResult, DEFAULT_API_URL, ENV_VAR, type ExecResult, type FetchLike, type FilterTemplateOptions, type GenerateClient, type GodzillaExecOptions, type InjectorConfig, type InstallSkillOptions, JDK_VERSIONS, LEGACY_CIPHER, type MainConfig, MemPartyClient, type MemPartyClientOptions, type MemShellGenerateRequest, type MemShellGenerateResponse, type MemShellOptions, type MemShellResult, type MimicCipher, OUTPUT_LIMIT, type ObfuscationConfig, type ObfuscationOption, type OpCategory, type OpFilter, type OpLogEntry, type OutputOptions, type OutputResult, type PackerOption, type PackerTree, type PluginDescriptor, type ProbeConfig, type ProbeContent, type ProbeContentConfig, type ProbeMethod, type ProbeOptions, type ProbeShellGenerateRequest, type ProbeShellGenerateResponse, type ProbeShellResult, type RemoteOption, type RemoteSelectUiHint, type ResolvedConnection, SKILL_NAME, type ServerConfig, type ShellConfig, type ShellInput, type ShellToolConfig, type ShellToolConfigObject, type ShellToolConfigValue, type SkillInstallResult, type SkillScope, type StoredProject, type StoredShell, type Suo5ConnectOptions, type Suo5Mode, type ToolConfigDescriptor, type ToolConfigParam, type VersionInfo, autoSaveShell, buildCustomMemshell, buildMemShellRequest, buildProbeRequest, createMcpServer, defaultClassName, deriveMarkers, emitPayload, execBehinder, execGodzilla, fetchRemoteOptions, formatOp, getProject, hasJavac, installSkill, listProjects, logOp, marshalFrameBase64, marshalSuo5Map, normalizeRemoteOptions, opLogPath, parseShellToolConfig, parseToolConfigFile, profileSecretFields, readOps, readRemotePath, removeProject, removeShell, renderCryptoProbe, renderFilterJava, resolveApiUrl, resolveCipher, resolveConnection, resolveJreVersion, saveProjectMeta, saveShell, saveShellMeta, shouldDecode, skillSourceDir, skillTargetDir, startMcpStdio, targetStorePath, testBehinder, testGodzilla, testSuo5, toolConfigForTool, truncateOutput, unmarshalFrameBase64, unmarshalSuo5Map, validateRemoteOptionsUrl, validateRequiredRemoteOptions };