memshell-party-cli 0.5.0 → 0.7.0

package/dist/index.d.ts

@@ -149,6 +149,12 @@ declare class MemPartyClient {
     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[]>;
     getVersion(): Promise<VersionInfo>;
     generateMemShell(req: MemShellGenerateRequest): Promise<MemShellGenerateResponse>;
     generateProbe(req: ProbeShellGenerateRequest): Promise<ProbeShellGenerateResponse>;
@@ -476,9 +482,15 @@ declare function execGodzilla(url: string, pass: string, key: string, command: s
 interface ProfileTemplate {
     /** <title> of this page (metadata — the template is used verbatim). */
     title: string;
-    /** Full HTML of a real page on the site (a response skin). */
+    /**
+     * Full body of a real response on the site (a response skin). Any text
+     * format is allowed — HTML, JSON, XML, JS… When it contains the literal
+     * placeholder `{{payload}}`, the ciphertext is substituted exactly there
+     * (works for every format); without a placeholder the template must be an
+     * HTML page and the cipher's marker fragment is injected before </body>.
+     */
     template: string;
-    /** Content-Type this page is served with. */
+    /** Content-Type this page is served with (the shell answers with it). */
     contentType: string;
     /** Relative rotation weight (default 1). */
     weight?: number;
@@ -502,8 +514,25 @@ interface ProfileRequest {
     secretField: string;
     /** Where the ciphertext goes: form body (default), URL query, or a header. */
     secretIn?: "body" | "query" | "header";
+    /**
+     * Body serialization when secretIn=body: "form" (default, url-encoded) or
+     * "json" (a JSON object with Content-Type application/json — for API sites
+     * whose dominant traffic is JSON XHR). Ignored when bodyTemplate is set.
+     */
+    bodyStyle?: "form" | "json";
+    /**
+     * Full request body with the literal placeholder `{{payload}}` where the
+     * ciphertext goes (takes precedence over bodyStyle; secretIn must be body).
+     * Any text format — an OpenAI-style chat JSON, a GraphQL envelope, an XML
+     * SOAP message, a multipart/form-data body (pair it with a Content-Type
+     * header carrying the same boundary). Decoy macros {{hex:N}}, {{b64:N}},
+     * {{uuid}}, {{ts}}, {{int:A:B}} are rendered per request.
+     */
+    bodyTemplate?: string;
     /** Decoy fields sent alongside (e.g. csrftoken/j_username/agreement). */
     fields?: ProfileFormField[];
+    /** Extra/override request headers for this shape (e.g. Accept). */
+    headers?: Record<string, string>;
     /** Relative rotation weight (default 1) when `request` is an array. */
     weight?: number;
 }
@@ -659,9 +688,29 @@ interface FilterTemplateOptions {
     secret: string;
     /** Carrier field names (form fields / headers) that may hold the ciphertext. */
     fields: string[];
-    /** Cover pages from the site profile (raw HTML, rotated per response). */
-    templates: string[];
+    /**
+     * Lowercase Content-Type needles (contains-match): the body is read only
+     * when its Content-Type matches one — derived from the profile's body
+     * shapes. Empty = never touch the body stream: reading a body the shell
+     * doesn't own consumes it and breaks the app behind us.
+     */
+    bodyContentTypes: string[];
+    /** Cover bodies from the site profile (rotated per response, each with its contentType). */
+    templates: Array<{
+        template: string;
+        contentType: string;
+    }>;
     cipher: MimicCipher;
+    /**
+     * Base64 bytes of the body-wrapper classes (renderWrapperJava, compiled by
+     * the build's first phase). The filter self-defines them at runtime so the
+     * uploaded shell stays a single self-contained class — MemShellParty's
+     * Custom generator can only resolve one class.
+     */
+    wrapper: {
+        bodyB64: string;
+        streamB64: string;
+    };
 }
 declare function renderFilterJava(opts: FilterTemplateOptions): string;
 declare function renderCryptoProbe(cipher: MimicCipher): string;
@@ -669,6 +718,26 @@ declare function renderCryptoProbe(cipher: MimicCipher): string;
 /** True when a working javac is available (used to skip integration tests). */
 declare function hasJavac(): boolean;
 
+type SkillScope = "user" | "claude" | "project";
+declare const SKILL_NAME = "memshell-party";
+/** Locate the bundled skill directory (handles both src/ and dist/ layouts). */
+declare function skillSourceDir(): string;
+declare function skillTargetDir(scope: SkillScope, projectDir?: string): string;
+interface SkillInstallResult {
+    scope: SkillScope;
+    dir: string;
+    /** Top-level entries after the copy. */
+    files: string[];
+}
+interface InstallSkillOptions {
+    /** Base dir for project scope (default: cwd). */
+    projectDir?: string;
+    /** Override the bundled skill source (tests). */
+    sourceDir?: string;
+}
+/** Copy the bundled skill into each scope's directory. Overwrites. */
+declare function installSkill(scopes: SkillScope[], opts?: InstallSkillOptions): SkillInstallResult[];
+
 type Suo5Mode = "auto" | "v2" | "v1";
 interface Suo5ConnectOptions extends CommonConnectOptions {
     mode?: Suo5Mode;
@@ -689,4 +758,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, 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, type ServerConfig, type ShellConfig, type ShellInput, type ShellToolConfig, type StoredProject, type StoredShell, type Suo5ConnectOptions, type Suo5Mode, type VersionInfo, autoSaveShell, buildCustomMemshell, buildMemShellRequest, buildProbeRequest, createMcpServer, defaultClassName, deriveMarkers, emitPayload, execBehinder, execGodzilla, formatOp, getProject, hasJavac, listProjects, logOp, marshalFrameBase64, marshalSuo5Map, opLogPath, profileSecretFields, readOps, removeProject, removeShell, renderCryptoProbe, renderFilterJava, resolveApiUrl, resolveCipher, resolveConnection, resolveJreVersion, saveProjectMeta, saveShell, saveShellMeta, shouldDecode, startMcpStdio, targetStorePath, testBehinder, testGodzilla, testSuo5, truncateOutput, unmarshalFrameBase64, unmarshalSuo5Map };
+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 };