memshell-party-cli 0.1.0 → 0.2.0

package/dist/index.d.ts

@@ -267,6 +267,58 @@ declare function createMcpServer(client: MemPartyClient): McpServer;
 /** Start the MCP server over stdio. */
 declare function startMcpStdio(client: MemPartyClient): Promise<void>;
 
+/** Shared types for the shell connection testers. */
+type ConnectTool = "behinder" | "godzilla" | "suo5";
+interface ConnectTestResult {
+    ok: boolean;
+    tool: ConnectTool;
+    url: string;
+    /** Human-readable success detail (echo size, session id, protocol variant...). */
+    detail?: string;
+    /** Human-readable failure reason. */
+    error?: string;
+    durationMs: number;
+}
+interface CommonConnectOptions {
+    /**
+     * MemShellParty shells are gated by a header check:
+     * the request must carry `headerName` containing `headerValue`
+     * (both are reported by `memparty gen --json` as shellToolConfig).
+     */
+    headerName?: string;
+    headerValue?: string;
+    /** Extra request headers (already merged with the gate header). */
+    extraHeaders?: Record<string, string>;
+    timeoutMs?: number;
+    insecure?: boolean;
+}
+
+interface BehinderConnectOptions extends CommonConnectOptions {
+    /** Request body encoding. Default: try base64, then raw AES bytes. */
+    requestEncoding?: "base64" | "raw";
+}
+declare function testBehinder(url: string, pass: string, options?: BehinderConnectOptions): Promise<ConnectTestResult>;
+
+declare function testGodzilla(url: string, pass: string, key: string, options?: CommonConnectOptions): Promise<ConnectTestResult>;
+
+type Suo5Mode = "auto" | "v2" | "v1";
+interface Suo5ConnectOptions extends CommonConnectOptions {
+    mode?: Suo5Mode;
+}
+/** suo5's `Marshal`: [klen u8][key][vlen u32 BE][value] per entry. */
+declare function marshalSuo5Map(entries: Array<[string, Buffer]>): Buffer;
+declare function unmarshalSuo5Map(data: Buffer): Map<string, Buffer>;
+/** suo5's `DataFrame.MarshalBinaryBase64`. */
+declare function marshalFrameBase64(data: Buffer): Buffer;
+interface Suo5Frame {
+    data: Buffer;
+    /** offset just past this frame */
+    next: number;
+}
+/** suo5's `ReadFrameBase64` over a flat buffer. Throws on truncation. */
+declare function unmarshalFrameBase64(buf: Buffer, offset?: number): Suo5Frame;
+declare function testSuo5(url: string, options?: Suo5ConnectOptions): Promise<ConnectTestResult>;
+
 declare const CLI_VERSION: string;
 
-export { ApiError, type ApiErrorResponse, CLI_VERSION, type CommandConfigVO, DEFAULT_API_URL, ENV_VAR, type FetchLike, type InjectorConfig, JDK_VERSIONS, type MainConfig, MemPartyClient, type MemPartyClientOptions, type MemShellGenerateRequest, type MemShellGenerateResponse, type MemShellOptions, type MemShellResult, 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 ServerConfig, type ShellConfig, type ShellToolConfig, type VersionInfo, buildMemShellRequest, buildProbeRequest, createMcpServer, emitPayload, resolveApiUrl, resolveJreVersion, shouldDecode, startMcpStdio };
+export { ApiError, type ApiErrorResponse, type BehinderConnectOptions, CLI_VERSION, type CommandConfigVO, type CommonConnectOptions, type ConnectTestResult, type ConnectTool, DEFAULT_API_URL, ENV_VAR, type FetchLike, type InjectorConfig, JDK_VERSIONS, type MainConfig, MemPartyClient, type MemPartyClientOptions, type MemShellGenerateRequest, type MemShellGenerateResponse, type MemShellOptions, type MemShellResult, 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 ServerConfig, type ShellConfig, type ShellToolConfig, type Suo5ConnectOptions, type Suo5Mode, type VersionInfo, buildMemShellRequest, buildProbeRequest, createMcpServer, emitPayload, marshalFrameBase64, marshalSuo5Map, resolveApiUrl, resolveJreVersion, shouldDecode, startMcpStdio, testBehinder, testGodzilla, testSuo5, unmarshalFrameBase64, unmarshalSuo5Map };