hypha-cli 0.1.7 → 0.1.9

package/dist/cli.mjs

@@ -21,11 +21,18 @@ function printHelp() {
 
 Usage: hypha [--server URL] [--workspace WS] <command> [options]
 
-Workspace:
+Connection:
   login [server-url]             Login to Hypha server (opens browser)
+  info [--json]                  Show connection info
   token [options]                Generate a workspace token
+
+Workspace management:
   services [options]             List services in workspace
-  info                           Show workspace info
+  clients [workspace] [--json]   List connected clients
+  ping <client-id>               Ping a client (check if alive)
+  kick <client-id> [workspace]   Disconnect and remove a client (admin)
+  cleanup [workspace]            Remove dead/stale clients (admin)
+  workspace-info [ws] [--json]   Show detailed workspace info (admin)
 
 Apps (manage server app definitions and instances):
   apps list [--json]             List installed app definitions
@@ -70,17 +77,32 @@ async function main() {
   }
   const commandArgs = args.slice(1);
   if (subcommand === "login") {
-    const { loginCommand } = await import('./workspace-D63jR8RA.mjs');
+    const { loginCommand } = await import('./workspace-DDljPOfV.mjs');
     await loginCommand(commandArgs);
   } else if (subcommand === "token") {
-    const { tokenCommand } = await import('./workspace-D63jR8RA.mjs');
+    const { tokenCommand } = await import('./workspace-DDljPOfV.mjs');
     await tokenCommand(commandArgs);
   } else if (subcommand === "services") {
-    const { servicesCommand } = await import('./workspace-D63jR8RA.mjs');
+    const { servicesCommand } = await import('./workspace-DDljPOfV.mjs');
     await servicesCommand(commandArgs);
   } else if (subcommand === "info") {
-    const { infoCommand } = await import('./workspace-D63jR8RA.mjs');
+    const { infoCommand } = await import('./workspace-DDljPOfV.mjs');
     await infoCommand(commandArgs);
+  } else if (subcommand === "clients") {
+    const { clientsCommand } = await import('./workspace-DDljPOfV.mjs');
+    await clientsCommand(commandArgs);
+  } else if (subcommand === "ping") {
+    const { pingCommand } = await import('./workspace-DDljPOfV.mjs');
+    await pingCommand(commandArgs);
+  } else if (subcommand === "kick") {
+    const { kickCommand } = await import('./workspace-DDljPOfV.mjs');
+    await kickCommand(commandArgs);
+  } else if (subcommand === "cleanup") {
+    const { cleanupCommand } = await import('./workspace-DDljPOfV.mjs');
+    await cleanupCommand(commandArgs);
+  } else if (subcommand === "workspace-info") {
+    const { workspaceInfoCommand } = await import('./workspace-DDljPOfV.mjs');
+    await workspaceInfoCommand(commandArgs);
   } else if (subcommand === "apps") {
     const { handleAppsCommand } = await import('./apps-DqDtK6XB.mjs');
     await handleAppsCommand(commandArgs);

package/dist/workspace-BwLwj61H.mjs

@@ -0,0 +1,206 @@
+import { e as hasFlag, l as loginToHypha, c as connectToHypha, g as getFlagInt, i as getFlag, f as formatJson, a as formatTable, r as resolveServerUrl } from './helpers-DWQC3Lr8.mjs';
+import 'fs';
+import 'path';
+import 'os';
+
+async function loginCommand(args) {
+  if (hasFlag(args, "--help", "-h")) {
+    console.log(`Usage: hypha login [server-url]
+
+Login to a Hypha server via browser-based OAuth.
+Credentials are saved to ~/.hypha/.env.
+
+Default server: https://hypha.aicell.io`);
+    return;
+  }
+  const serverUrl = args[0] && !args[0].startsWith("-") ? args[0] : void 0;
+  await loginToHypha(serverUrl);
+}
+async function tokenCommand(args) {
+  if (hasFlag(args, "--help", "-h")) {
+    console.log(`Usage: hypha token [options]
+
+Generate a workspace token.
+
+Options:
+  --expires-in <seconds>     Token expiration (default: 3600)
+  --permission <perm>        Permission level: read, read_write, admin (default: read_write)
+  --workspace <ws>           Target workspace (default: current)
+  --json                     Output as JSON`);
+    return;
+  }
+  const server = await connectToHypha();
+  try {
+    const expiresIn = getFlagInt(args, "--expires-in") || 3600;
+    const permission = getFlag(args, "--permission") || "read_write";
+    const workspace = getFlag(args, "--workspace") || server.config.workspace;
+    const json = hasFlag(args, "--json");
+    const token = await server.generateToken({
+      expires_in: expiresIn,
+      permission,
+      workspace
+    });
+    if (json) {
+      console.log(formatJson({
+        token,
+        workspace,
+        permission,
+        expires_in: expiresIn
+      }));
+    } else {
+      console.log(token);
+    }
+  } finally {
+    await server.disconnect();
+  }
+}
+async function servicesCommand(args) {
+  if (hasFlag(args, "--help", "-h")) {
+    console.log(`Usage: hypha services [options]
+
+List services in the current workspace.
+
+Options:
+  --type <type>              Filter by service type
+  --include-unlisted         Include unlisted services
+  --json                     Output as JSON`);
+    return;
+  }
+  const server = await connectToHypha();
+  try {
+    const type = getFlag(args, "--type");
+    const includeUnlisted = hasFlag(args, "--include-unlisted");
+    const json = hasFlag(args, "--json");
+    const query = { _rkwargs: true };
+    if (type) query.type = type;
+    if (includeUnlisted) query.include_unlisted = true;
+    const services = await server.listServices(query);
+    if (json) {
+      console.log(formatJson(services));
+      return;
+    }
+    if (!services || services.length === 0) {
+      console.log("No services found.");
+      return;
+    }
+    const rows = [["ID", "NAME", "TYPE", "DESCRIPTION"]];
+    for (const svc of services) {
+      rows.push([
+        svc.id || "",
+        svc.name || "",
+        svc.type || "",
+        (svc.description || "").slice(0, 60)
+      ]);
+    }
+    console.log(formatTable(rows));
+  } finally {
+    await server.disconnect();
+  }
+}
+async function clientsCommand(args) {
+  if (hasFlag(args, "--help", "-h")) {
+    console.log(`Usage: hypha clients [options]
+
+List connected clients in the workspace.
+
+Options:
+  --json                     Output as JSON`);
+    return;
+  }
+  const server = await connectToHypha();
+  try {
+    const json = hasFlag(args, "--json");
+    const wm = await server.getService("public/*:workspace-manager");
+    const clients = await wm.listClients({ workspace: server.config.workspace, _rkwargs: true });
+    if (json) {
+      console.log(formatJson(clients));
+      return;
+    }
+    console.log(`${clients.length} client(s) in workspace ${server.config.workspace}`);
+    if (clients.length === 0) return;
+    const byToken = {};
+    for (const c of clients) {
+      const id = typeof c === "string" ? c : c.id || c;
+      const key = String(id).split("/").pop()?.split(":")[0] || String(id);
+      if (!byToken[key]) byToken[key] = [];
+      byToken[key].push(String(id));
+    }
+    for (const c of clients.slice(0, 30)) {
+      const id = typeof c === "string" ? c : c.id || c;
+      console.log(`  ${id}`);
+    }
+    if (clients.length > 30) {
+      console.log(`  ... and ${clients.length - 30} more`);
+    }
+  } finally {
+    await server.disconnect();
+  }
+}
+async function cleanupCommand(args) {
+  if (hasFlag(args, "--help", "-h")) {
+    console.log(`Usage: hypha cleanup [options]
+
+Ping all clients in the workspace and remove dead/stale ones.
+Requires admin permission.
+
+Options:
+  --timeout <seconds>        Ping timeout per client (default: 2)
+  --json                     Output as JSON`);
+    return;
+  }
+  const server = await connectToHypha();
+  try {
+    const timeout = getFlagInt(args, "--timeout") || 2;
+    const json = hasFlag(args, "--json");
+    const ws = server.config.workspace;
+    const wm = await server.getService("public/*:workspace-manager");
+    const clients = await wm.listClients({ workspace: ws, _rkwargs: true });
+    console.log(`Workspace ${ws}: ${clients.length} client(s)`);
+    console.log(`Pinging all clients (timeout=${timeout}s)... this may take a while.`);
+    const result = await wm.cleanup({ workspace: ws, timeout, _rkwargs: true });
+    const removed = result?.removed_clients || result?.removedClients || [];
+    if (json) {
+      console.log(formatJson(result));
+    } else {
+      console.log(`Removed ${removed.length} dead client(s).`);
+      if (removed.length > 0 && removed.length <= 20) {
+        for (const c of removed) {
+          console.log(`  - ${c}`);
+        }
+      }
+      if (result?.removed_workspace || result?.removedWorkspace) {
+        console.log(`Workspace ${ws} was removed (no live clients remaining).`);
+      }
+    }
+  } finally {
+    await server.disconnect();
+  }
+}
+async function infoCommand(args) {
+  if (hasFlag(args, "--help", "-h")) {
+    console.log(`Usage: hypha info [--json]
+
+Show workspace information.`);
+    return;
+  }
+  const server = await connectToHypha();
+  try {
+    const json = hasFlag(args, "--json");
+    const info = {
+      server_url: server.config.public_base_url || resolveServerUrl(),
+      workspace: server.config.workspace,
+      client_id: server.config.client_id
+    };
+    if (json) {
+      console.log(formatJson(info));
+    } else {
+      console.log(`Server:    ${info.server_url}`);
+      console.log(`Workspace: ${info.workspace}`);
+      console.log(`Client ID: ${info.client_id}`);
+    }
+  } finally {
+    await server.disconnect();
+  }
+}
+
+export { cleanupCommand, clientsCommand, infoCommand, loginCommand, servicesCommand, tokenCommand };

package/dist/workspace-DCueGyht.mjs

@@ -0,0 +1,127 @@
+import { e as hasFlag, l as loginToHypha, c as connectToHypha, g as getFlagInt, i as getFlag, f as formatJson, a as formatTable, r as resolveServerUrl } from './helpers-DWQC3Lr8.mjs';
+import 'fs';
+import 'path';
+import 'os';
+
+async function loginCommand(args) {
+  if (hasFlag(args, "--help", "-h")) {
+    console.log(`Usage: hypha login [server-url]
+
+Login to a Hypha server via browser-based OAuth.
+Credentials are saved to ~/.hypha/.env.
+
+Default server: https://hypha.aicell.io`);
+    return;
+  }
+  const serverUrl = args[0] && !args[0].startsWith("-") ? args[0] : void 0;
+  await loginToHypha(serverUrl);
+}
+async function tokenCommand(args) {
+  if (hasFlag(args, "--help", "-h")) {
+    console.log(`Usage: hypha token [options]
+
+Generate a workspace token.
+
+Options:
+  --expires-in <seconds>     Token expiration (default: 3600)
+  --permission <perm>        Permission level: read, read_write, admin (default: read_write)
+  --workspace <ws>           Target workspace (default: current)
+  --json                     Output as JSON`);
+    return;
+  }
+  const server = await connectToHypha();
+  try {
+    const expiresIn = getFlagInt(args, "--expires-in") || 3600;
+    const permission = getFlag(args, "--permission") || "read_write";
+    const workspace = getFlag(args, "--workspace") || server.config.workspace;
+    const json = hasFlag(args, "--json");
+    const token = await server.generateToken({
+      expires_in: expiresIn,
+      permission,
+      workspace
+    });
+    if (json) {
+      console.log(formatJson({
+        token,
+        workspace,
+        permission,
+        expires_in: expiresIn
+      }));
+    } else {
+      console.log(token);
+    }
+  } finally {
+    await server.disconnect();
+  }
+}
+async function servicesCommand(args) {
+  if (hasFlag(args, "--help", "-h")) {
+    console.log(`Usage: hypha services [options]
+
+List services in the current workspace.
+
+Options:
+  --type <type>              Filter by service type
+  --include-unlisted         Include unlisted services
+  --json                     Output as JSON`);
+    return;
+  }
+  const server = await connectToHypha();
+  try {
+    const type = getFlag(args, "--type");
+    const includeUnlisted = hasFlag(args, "--include-unlisted");
+    const json = hasFlag(args, "--json");
+    const query = { _rkwargs: true };
+    if (type) query.type = type;
+    if (includeUnlisted) query.include_unlisted = true;
+    const services = await server.listServices(query);
+    if (json) {
+      console.log(formatJson(services));
+      return;
+    }
+    if (!services || services.length === 0) {
+      console.log("No services found.");
+      return;
+    }
+    const rows = [["ID", "NAME", "TYPE", "DESCRIPTION"]];
+    for (const svc of services) {
+      rows.push([
+        svc.id || "",
+        svc.name || "",
+        svc.type || "",
+        (svc.description || "").slice(0, 60)
+      ]);
+    }
+    console.log(formatTable(rows));
+  } finally {
+    await server.disconnect();
+  }
+}
+async function infoCommand(args) {
+  if (hasFlag(args, "--help", "-h")) {
+    console.log(`Usage: hypha info [--json]
+
+Show workspace information.`);
+    return;
+  }
+  const server = await connectToHypha();
+  try {
+    const json = hasFlag(args, "--json");
+    const info = {
+      server_url: server.config.public_base_url || resolveServerUrl(),
+      workspace: server.config.workspace,
+      client_id: server.config.client_id
+    };
+    if (json) {
+      console.log(formatJson(info));
+    } else {
+      console.log(`Server:    ${info.server_url}`);
+      console.log(`Workspace: ${info.workspace}`);
+      console.log(`Client ID: ${info.client_id}`);
+    }
+  } finally {
+    await server.disconnect();
+  }
+}
+
+export { infoCommand, loginCommand, servicesCommand, tokenCommand };

package/dist/workspace-DDljPOfV.mjs

@@ -0,0 +1,286 @@
+import { e as hasFlag, l as loginToHypha, c as connectToHypha, g as getFlagInt, i as getFlag, f as formatJson, a as formatTable, r as resolveServerUrl } from './helpers-DWQC3Lr8.mjs';
+import 'fs';
+import 'path';
+import 'os';
+
+async function loginCommand(args) {
+  if (hasFlag(args, "--help", "-h")) {
+    console.log(`Usage: hypha login [server-url]
+
+Login to a Hypha server via browser-based OAuth.
+Credentials are saved to ~/.hypha/.env.
+
+Default server: https://hypha.aicell.io`);
+    return;
+  }
+  const serverUrl = args[0] && !args[0].startsWith("-") ? args[0] : void 0;
+  await loginToHypha(serverUrl);
+}
+async function tokenCommand(args) {
+  if (hasFlag(args, "--help", "-h")) {
+    console.log(`Usage: hypha token [options]
+
+Generate a workspace token.
+
+Options:
+  --expires-in <seconds>     Token expiration (default: 3600)
+  --permission <perm>        Permission level: read, read_write, admin (default: read_write)
+  --workspace <ws>           Target workspace (default: current)
+  --json                     Output as JSON`);
+    return;
+  }
+  const server = await connectToHypha();
+  try {
+    const expiresIn = getFlagInt(args, "--expires-in") || 3600;
+    const permission = getFlag(args, "--permission") || "read_write";
+    const workspace = getFlag(args, "--workspace") || server.config.workspace;
+    const json = hasFlag(args, "--json");
+    const token = await server.generateToken({
+      expires_in: expiresIn,
+      permission,
+      workspace
+    });
+    if (json) {
+      console.log(formatJson({
+        token,
+        workspace,
+        permission,
+        expires_in: expiresIn
+      }));
+    } else {
+      console.log(token);
+    }
+  } finally {
+    await server.disconnect();
+  }
+}
+async function servicesCommand(args) {
+  if (hasFlag(args, "--help", "-h")) {
+    console.log(`Usage: hypha services [options]
+
+List services in the current workspace.
+
+Options:
+  --type <type>              Filter by service type
+  --include-unlisted         Include unlisted services
+  --json                     Output as JSON`);
+    return;
+  }
+  const server = await connectToHypha();
+  try {
+    const type = getFlag(args, "--type");
+    const includeUnlisted = hasFlag(args, "--include-unlisted");
+    const json = hasFlag(args, "--json");
+    const query = { _rkwargs: true };
+    if (type) query.type = type;
+    if (includeUnlisted) query.include_unlisted = true;
+    const services = await server.listServices(query);
+    if (json) {
+      console.log(formatJson(services));
+      return;
+    }
+    if (!services || services.length === 0) {
+      console.log("No services found.");
+      return;
+    }
+    const rows = [["ID", "NAME", "TYPE", "DESCRIPTION"]];
+    for (const svc of services) {
+      rows.push([
+        svc.id || "",
+        svc.name || "",
+        svc.type || "",
+        (svc.description || "").slice(0, 60)
+      ]);
+    }
+    console.log(formatTable(rows));
+  } finally {
+    await server.disconnect();
+  }
+}
+async function clientsCommand(args) {
+  if (hasFlag(args, "--help", "-h")) {
+    console.log(`Usage: hypha clients [workspace] [options]
+
+List connected clients in a workspace. Defaults to the connected workspace.
+Pass a workspace name as positional arg to target a different workspace (requires admin).
+
+Options:
+  --json                     Output as JSON`);
+    return;
+  }
+  const server = await connectToHypha();
+  try {
+    const json = hasFlag(args, "--json");
+    const targetWs = args[0] && !args[0].startsWith("-") ? args[0] : server.config.workspace;
+    const clients = await server.listClients({ workspace: targetWs, _rkwargs: true });
+    if (json) {
+      console.log(formatJson(clients));
+      return;
+    }
+    console.log(`${clients.length} client(s) in workspace ${targetWs}`);
+    if (clients.length === 0) return;
+    for (const c of clients.slice(0, 50)) {
+      const id = typeof c === "string" ? c : c.id || String(c);
+      const email = typeof c === "object" ? c.user?.email || "" : "";
+      console.log(`  ${id}${email ? "  (" + email + ")" : ""}`);
+    }
+    if (clients.length > 50) {
+      console.log(`  ... and ${clients.length - 50} more`);
+    }
+  } finally {
+    await server.disconnect();
+  }
+}
+async function pingCommand(args) {
+  if (hasFlag(args, "--help", "-h")) {
+    console.log(`Usage: hypha ping <client-id> [options]
+
+Ping a specific client to check if it's alive.
+
+Options:
+  --timeout <seconds>        Ping timeout (default: 5)`);
+    return;
+  }
+  const clientId = args[0] && !args[0].startsWith("-") ? args[0] : void 0;
+  if (!clientId) {
+    console.error("Usage: hypha ping <client-id>");
+    process.exit(1);
+  }
+  const server = await connectToHypha();
+  try {
+    const timeout = getFlagInt(args, "--timeout") || 5;
+    try {
+      const result = await server.ping({ client_id: clientId, timeout, _rkwargs: true });
+      console.log(`${clientId}: ${result}`);
+    } catch (e) {
+      console.log(`${clientId}: dead (${e.message || e})`);
+    }
+  } finally {
+    await server.disconnect();
+  }
+}
+async function kickCommand(args) {
+  if (hasFlag(args, "--help", "-h")) {
+    console.log(`Usage: hypha kick <client-id> [workspace]
+
+Disconnect a client and remove all its services. Requires admin.
+If workspace is not specified, uses the connected workspace.
+
+Note: delete_client is not in the default workspace interface.
+This command uses the workspace-manager service directly.`);
+    return;
+  }
+  const clientId = args[0] && !args[0].startsWith("-") ? args[0] : void 0;
+  if (!clientId) {
+    console.error("Usage: hypha kick <client-id> [workspace]");
+    process.exit(1);
+  }
+  const server = await connectToHypha();
+  try {
+    const targetWs = args[1] && !args[1].startsWith("-") ? args[1] : server.config.workspace;
+    const svc = await server.getService(`${server.config.workspace}/*:default`);
+    if (svc.deleteClient) {
+      await svc.deleteClient({ client_id: clientId, workspace: targetWs, _rkwargs: true });
+    } else {
+      console.error("delete_client is not available. Use `hypha cleanup` instead.");
+      process.exit(1);
+    }
+    console.log(`Kicked client ${clientId} from ${targetWs}`);
+  } finally {
+    await server.disconnect();
+  }
+}
+async function cleanupCommand(args) {
+  if (hasFlag(args, "--help", "-h")) {
+    console.log(`Usage: hypha cleanup [workspace] [options]
+
+Ping all clients in a workspace and remove dead/stale ones.
+Requires admin permission.
+Defaults to the connected workspace. Pass workspace name as positional arg.
+
+Options:
+  --timeout <seconds>        Ping timeout per client (default: 2)
+  --json                     Output as JSON`);
+    return;
+  }
+  const server = await connectToHypha();
+  try {
+    const timeout = getFlagInt(args, "--timeout") || 2;
+    const json = hasFlag(args, "--json");
+    const targetWs = args[0] && !args[0].startsWith("-") ? args[0] : server.config.workspace;
+    const clients = await server.listClients({ workspace: targetWs, _rkwargs: true });
+    console.log(`Workspace ${targetWs}: ${clients.length} client(s)`);
+    console.log(`Pinging all clients (timeout=${timeout}s)... this may take a while.`);
+    const result = await server.cleanup({ workspace: targetWs, timeout, _rkwargs: true });
+    const removed = result?.removed_clients || result?.removedClients || [];
+    if (json) {
+      console.log(formatJson(result));
+    } else {
+      console.log(`Removed ${removed.length} dead client(s).`);
+      if (removed.length > 0 && removed.length <= 30) {
+        for (const c of removed) {
+          console.log(`  - ${c}`);
+        }
+      }
+      if (result?.removed_workspace || result?.removedWorkspace) {
+        console.log(`Workspace ${targetWs} was removed (no live clients remaining).`);
+      }
+    }
+  } finally {
+    await server.disconnect();
+  }
+}
+async function workspaceInfoCommand(args) {
+  if (hasFlag(args, "--help", "-h")) {
+    console.log(`Usage: hypha workspace-info [workspace] [--json]
+
+Show detailed workspace information (admin).`);
+    return;
+  }
+  const server = await connectToHypha();
+  try {
+    const json = hasFlag(args, "--json");
+    const targetWs = args[0] && !args[0].startsWith("-") ? args[0] : server.config.workspace;
+    const wsInfo = await server.getWorkspaceInfo({ workspace: targetWs, _rkwargs: true });
+    if (json) {
+      console.log(formatJson(wsInfo));
+    } else {
+      console.log(`Workspace: ${wsInfo.id || wsInfo.name || targetWs}`);
+      for (const [k, v] of Object.entries(wsInfo)) {
+        if (k === "id" || k === "name") continue;
+        const val = typeof v === "object" ? JSON.stringify(v) : String(v);
+        console.log(`  ${k}: ${val.slice(0, 120)}`);
+      }
+    }
+  } finally {
+    await server.disconnect();
+  }
+}
+async function infoCommand(args) {
+  if (hasFlag(args, "--help", "-h")) {
+    console.log(`Usage: hypha info [--json]
+
+Show connection information.`);
+    return;
+  }
+  const server = await connectToHypha();
+  try {
+    const json = hasFlag(args, "--json");
+    const info = {
+      server_url: server.config.public_base_url || resolveServerUrl(),
+      workspace: server.config.workspace,
+      client_id: server.config.client_id
+    };
+    if (json) {
+      console.log(formatJson(info));
+    } else {
+      console.log(`Server:    ${info.server_url}`);
+      console.log(`Workspace: ${info.workspace}`);
+      console.log(`Client ID: ${info.client_id}`);
+    }
+  } finally {
+    await server.disconnect();
+  }
+}
+
+export { cleanupCommand, clientsCommand, infoCommand, kickCommand, loginCommand, pingCommand, servicesCommand, tokenCommand, workspaceInfoCommand };