memshell-party-cli 0.3.0 → 0.3.2

package/dist/index.d.ts

@@ -263,7 +263,7 @@ declare const JDK_VERSIONS: Record<string, number>;
  */
 declare function resolveJreVersion(input: string | number | undefined): number | undefined;
 
-type OpCategory = "gen" | "probe" | "connect" | "exec" | "target";
+type OpCategory = "gen" | "probe" | "connect" | "exec" | "save" | "note" | "remove";
 interface OpLogEntry {
     /** ISO timestamp. */
     ts: string;
@@ -419,6 +419,12 @@ interface ResolvedConnection {
     /** Canonical `project/shell` reference, when resolved from the store. */
     targetName?: string;
 }
+/**
+ * Auto-save a verified connection under a derived `<host>/<tool>` name and
+ * return the canonical reference. A slot already pointing at the same URL is
+ * overwritten; a name taken by a different URL gets a numeric/port suffix.
+ */
+declare function autoSaveShell(conn: ResolvedConnection): string;
 /**
  * Merge an optional saved shell reference (`<project>/<shell>` or a bare
  * project holding exactly one shell) with explicit flags.
@@ -480,4 +486,4 @@ declare function testSuo5(url: string, options?: Suo5ConnectOptions): Promise<Co
 
 declare const CLI_VERSION: string;
 
-export { ApiError, type ApiErrorResponse, type BehinderConnectOptions, CLI_VERSION, type CommandConfigVO, type CommonConnectOptions, type ConnectTestResult, type ConnectTool, type ConnectionFlags, DEFAULT_API_URL, ENV_VAR, type ExecResult, type FetchLike, type GodzillaExecOptions, type InjectorConfig, JDK_VERSIONS, type MainConfig, MemPartyClient, type MemPartyClientOptions, type MemShellGenerateRequest, type MemShellGenerateResponse, type MemShellOptions, type MemShellResult, 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, buildMemShellRequest, buildProbeRequest, createMcpServer, emitPayload, execBehinder, execGodzilla, formatOp, getProject, listProjects, logOp, marshalFrameBase64, marshalSuo5Map, opLogPath, readOps, removeProject, removeShell, resolveApiUrl, resolveConnection, resolveJreVersion, saveProjectMeta, saveShell, saveShellMeta, shouldDecode, startMcpStdio, targetStorePath, testBehinder, testGodzilla, testSuo5, truncateOutput, unmarshalFrameBase64, unmarshalSuo5Map };
+export { ApiError, type ApiErrorResponse, type BehinderConnectOptions, CLI_VERSION, type CommandConfigVO, type CommonConnectOptions, type ConnectTestResult, type ConnectTool, type ConnectionFlags, DEFAULT_API_URL, ENV_VAR, type ExecResult, type FetchLike, type GodzillaExecOptions, type InjectorConfig, JDK_VERSIONS, type MainConfig, MemPartyClient, type MemPartyClientOptions, type MemShellGenerateRequest, type MemShellGenerateResponse, type MemShellOptions, type MemShellResult, 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, buildMemShellRequest, buildProbeRequest, createMcpServer, emitPayload, execBehinder, execGodzilla, formatOp, getProject, listProjects, logOp, marshalFrameBase64, marshalSuo5Map, opLogPath, readOps, removeProject, removeShell, resolveApiUrl, resolveConnection, resolveJreVersion, saveProjectMeta, saveShell, saveShellMeta, shouldDecode, startMcpStdio, targetStorePath, testBehinder, testGodzilla, testSuo5, truncateOutput, unmarshalFrameBase64, unmarshalSuo5Map };

package/dist/index.js

@@ -1260,6 +1260,42 @@ function saveShellMeta(projectName, shellName, meta) {
   writeProjects(projects);
   return shell;
 }
+function sanitizeName(name) {
+  const s = name.replace(/[^A-Za-z0-9._-]/g, "_");
+  return /^[A-Za-z0-9]/.test(s) ? s : `x${s}`;
+}
+function autoSaveShell(conn) {
+  let host = "target";
+  let port = "";
+  try {
+    const u = new URL(conn.url);
+    host = u.hostname || host;
+    port = u.port;
+  } catch {
+  }
+  const projectName = sanitizeName(host) || "target";
+  const existing = getProject(projectName)?.shells ?? {};
+  let shellName = Object.keys(existing).find(
+    (n) => existing[n].url === conn.url && existing[n].tool === conn.tool
+  );
+  if (!shellName) {
+    const base = sanitizeName(conn.tool) || "shell";
+    shellName = base;
+    if (existing[shellName]) shellName = port ? `${base}-${port}` : `${base}-2`;
+    for (let i = 2; existing[shellName]; i++) shellName = `${base}-${i}`;
+  }
+  saveShell(projectName, shellName, {
+    url: conn.url,
+    tool: conn.tool,
+    pass: conn.pass,
+    key: conn.key,
+    headerName: conn.headerName,
+    headerValue: conn.headerValue,
+    extraHeaders: Object.keys(conn.extraHeaders).length > 0 ? conn.extraHeaders : void 0,
+    insecure: conn.insecure
+  });
+  return `${projectName}/${shellName}`;
+}
 function resolveConnection(ref, flags) {
   let stored;
   let targetName;
@@ -1269,7 +1305,7 @@ function resolveConnection(ref, flags) {
     let shellName = slash === -1 ? void 0 : ref.slice(slash + 1);
     const project = getProject(projectName);
     if (!project) {
-      throw new Error(`unknown project ${JSON.stringify(projectName)} \u2014 see 'memparty target list'`);
+      throw new Error(`unknown project ${JSON.stringify(projectName)} \u2014 see 'memparty list'`);
     }
     if (!shellName) {
       const names = Object.keys(project.shells);
@@ -1582,7 +1618,7 @@ function createMcpServer(client) {
     "connect_test",
     {
       title: "Test shell connection",
-      description: "Test whether a deployed Godzilla / Behinder / suo5 shell is alive and the credentials work, by performing the tool's real protocol handshake. Pass a saved target `name`, or url+tool with the gate header (headerName/headerValue) from generate_memshell output for MemShellParty shells.",
+      description: "Test whether a deployed Godzilla / Behinder / suo5 shell is alive and the credentials work, by performing the tool's real protocol handshake. Pass a saved target `name`, or url+tool with the gate header (headerName/headerValue) from generate_memshell output for MemShellParty shells. On success the profile is auto-saved and the canonical name returned as `savedAs` \u2014 reuse it as `name` in later calls.",
       inputSchema: connectInput
     },
     async (args) => {
@@ -1617,6 +1653,11 @@ function createMcpServer(client) {
           default:
             throw new Error(`unknown tool ${String(conn.tool)}`);
         }
+        let savedAs;
+        if (result.ok && conn.targetName === void 0) {
+          savedAs = autoSaveShell(conn);
+          conn.targetName = savedAs;
+        }
         logOp({
           category: "connect",
           action: "connect",
@@ -1628,7 +1669,7 @@ function createMcpServer(client) {
           detail: result.detail,
           error: result.error
         });
-        return jsonContent(result);
+        return jsonContent(savedAs !== void 0 ? { ...result, savedAs } : result);
       } catch (err) {
         return errorContent(err);
       }
@@ -1638,7 +1679,7 @@ function createMcpServer(client) {
     "exec_command",
     {
       title: "Execute command on shell",
-      description: "Execute a command line on a deployed Godzilla / Behinder shell and return its stdout+stderr. Uses the tool's real protocol (Godzilla execCommand method / Behinder Cmd payload). Run connect_test first to verify credentials; pass a saved target `name`, or url+tool with the same gate header (headerName/headerValue) for MemShellParty shells.",
+      description: "Execute a command line on a deployed Godzilla / Behinder shell and return its stdout+stderr. Uses the tool's real protocol (Godzilla execCommand method / Behinder Cmd payload). Run connect_test first to verify credentials; pass a saved target `name`, or url+tool with the same gate header (headerName/headerValue) for MemShellParty shells. On success the profile is auto-saved and the canonical name returned as `savedAs`.",
       inputSchema: execInput
     },
     async (args) => {
@@ -1676,6 +1717,11 @@ function createMcpServer(client) {
           default:
             throw new Error(`exec supports godzilla | behinder (got ${String(conn.tool)})`);
         }
+        let savedAs;
+        if (result.ok && conn.targetName === void 0) {
+          savedAs = autoSaveShell(conn);
+          conn.targetName = savedAs;
+        }
         const truncated = result.output !== void 0 ? truncateOutput(result.output) : null;
         logOp({
           category: "exec",
@@ -1690,7 +1736,7 @@ function createMcpServer(client) {
           outputTruncated: truncated?.truncated || void 0,
           error: result.error
         });
-        return jsonContent(result);
+        return jsonContent(savedAs !== void 0 ? { ...result, savedAs } : result);
       } catch (err) {
         return errorContent(err);
       }
@@ -1722,7 +1768,7 @@ function createMcpServer(client) {
           remark: args.shellRemark
         });
         logOp({
-          category: "target",
+          category: "save",
           action: "save",
           targetName: `${args.project}/${args.shell}`,
           url: args.url,
@@ -1761,7 +1807,7 @@ function createMcpServer(client) {
           }
           const updated2 = saveShellMeta(args.project, args.shell, { remark: args.remark });
           logOp({
-            category: "target",
+            category: "note",
             action: "note",
             targetName: `${args.project}/${args.shell}`,
             ok: true,
@@ -1778,7 +1824,7 @@ function createMcpServer(client) {
           category: args.category
         });
         logOp({
-          category: "target",
+          category: "note",
           action: "note",
           targetName: args.project,
           ok: true,
@@ -1828,7 +1874,7 @@ function createMcpServer(client) {
         const removed = args.shell ? removeShell(args.project, args.shell) : removeProject(args.project);
         if (!removed) throw new Error(`unknown target ${args.project}/${args.shell ?? ""}`);
         logOp({
-          category: "target",
+          category: "remove",
           action: "remove",
           targetName: args.shell ? `${args.project}/${args.shell}` : args.project,
           ok: true,
@@ -1844,9 +1890,9 @@ function createMcpServer(client) {
     "log_list",
     {
       title: "List operation log",
-      description: "Read the global operation log (every gen/probe/connect/exec/target op), newest first. Filter by category and/or target.",
+      description: "Read the global operation log (every gen/probe/connect/exec/save/note/remove op), newest first. Filter by category and/or target.",
       inputSchema: {
-        category: z.enum(["gen", "probe", "connect", "exec", "target"]).optional().describe("operation category"),
+        category: z.enum(["gen", "probe", "connect", "exec", "save", "note", "remove"]).optional().describe("operation category"),
         target: z.string().optional().describe("project name, project/shell, or a URL substring (e.g. host)"),
         limit: z.number().optional().describe("max entries (default 50)")
       }
@@ -1879,6 +1925,7 @@ export {
   JDK_VERSIONS,
   MemPartyClient,
   OUTPUT_LIMIT,
+  autoSaveShell,
   buildMemShellRequest,
   buildProbeRequest,
   createMcpServer,