hypha-cli 0.1.7 → 0.1.9

package/dist/workspace-DMqqSmvB.mjs

@@ -0,0 +1,283 @@
+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 getWorkspaceManager(server) {
+  return server.getService("public/*:workspace-manager");
+}
+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.
+Use a positional argument 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 wm = await getWorkspaceManager(server);
+    const clients = await wm.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)) {
+      console.log(`  ${c}`);
+    }
+    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;
+    const wm = await getWorkspaceManager(server);
+    try {
+      const result = await wm.pingClient({ 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.`);
+    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 wm = await getWorkspaceManager(server);
+    await wm.deleteClient({ client_id: clientId, workspace: targetWs, _rkwargs: true });
+    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 wm = await getWorkspaceManager(server);
+    const clients = await wm.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 wm.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 wm = await getWorkspaceManager(server);
+    const wsInfo = await wm.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 };

package/dist/{workspace-D63jR8RA.mjs → workspace-RZLvWJpe.mjs}

@@ -1,4 +1,4 @@
-import { e as hasFlag, l as loginToHypha, c as connectToHypha, g as getFlagInt, i as getFlag, f as formatJson, a as formatTable } from './helpers-DWQC3Lr8.mjs';
+import { e as hasFlag, l as loginToHypha, c as connectToHypha, g as getFlagInt, i as getFlag, f as formatJson, a as formatTable } from './helpers-BvfSCkvr.mjs';
 import 'fs';
 import 'path';
 import 'os';
@@ -38,7 +38,8 @@ Options:
     const token = await server.generateToken({
       expires_in: expiresIn,
       permission,
-      workspace
+      workspace,
+      _rkwargs: true
     });
     if (json) {
       console.log(formatJson({

package/dist/workspace-XO_tEtii.mjs

@@ -0,0 +1,284 @@
+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)) {
+      console.log(`  ${c}`);
+    }
+    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 };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "hypha-cli",
-    "version": "0.1.7",
+    "version": "0.1.9",
     "description": "Hypha Cloud CLI — manage workspaces, apps, and artifacts",
     "author": "Amun AI AB",
     "license": "SEE LICENSE IN LICENSE",