superuser.app 0.0.0 → 0.0.1

package/README.md

@@ -1,67 +1,67 @@
 # Superuser Package Manager
 ## Extend AI agents with tools, instantly
 
-`ibot` is the official CLI for publishing [Superuser](https://instant.chat) packages.
-You can use this utility to publish new packages to the Superuser package registry,
-available at [instant.chat/packages](https://instant.chat/packages).
+`sutr` is the official CLI for publishing [Superuser](https://superuser.app) packages.
+You can use this utility to publish new packages to the Superuser toolkit registry,
+available at [superuser.app/packages](https://superuser.app/packages).
 
-[Superuser](https://instant.chat) enables you to rapidly build custom
+[Superuser](https://superuser.app) enables you to rapidly build custom
 chatbots and AI agents that can be extended with custom tools. It provides four
 major features;
 
 1. Chat with and develop your agent in real time from the web
-2. Extend your agent with [hosted tool packages](https://instant.chat/packages)
+2. Extend your agent with [hosted tool packages](https://superuser.app/packages)
 3. Write your own private tool packages for your agents
 4. Deploy your agent to third-party services like Discord and Slack
 
-## What is the Superuser Package Registry?
+## What is the Superuser toolkit registry?
 
-The Superuser Package Registry is a **serverless hosting platform and registry** for
+The Superuser toolkit registry is a **serverless hosting platform and registry** for
 building tools that extend AI chatbots and agents.
 
-**Superuser packages are just REST API servers.**
+**Superuser toolkits are just REST API servers.**
 Every package is an [Instant API](https://github.com/instant-dev/api) project,
 which is a simple way to export and auto-document JavaScript functions as REST endpoints
 that can be called via any HTTP client.
 
 Authentication to your published packages are handled via **API keychains** which
-are delegated via [Superuser](https://instant.chat).
+are delegated via [Superuser](https://superuser.app).
 
 **NOTE:** While in beta, only Superuser agents can use your published tools.
 We'll be opening up the gateway to programmatic access in the coming months.
 
 ## Superuser Package vs. MCP
 
-Reminder, **Superuser packages are just REST API servers.**
+Reminder, **Superuser toolkits are just REST API servers.**
 
 MCP, or Model Context Protocol, is a standard for passing tool and prompt context
-between AI models and service providers. Superuser packages are **not**
+between AI models and service providers. Superuser toolkits are **not**
 MCP compatible out of the box, as they are simply REST APIs. However, it is our goal to add
 MCP bindings to the [Instant API](https://github.com/instant-dev/api) framework which
-powers all Superuser packages. When formalized, this will allow you to use
-Superuser packages with any MCP-compatible client or service provider.
+powers all Superuser toolkits. When formalized, this will allow you to use
+Superuser toolkits with any MCP-compatible client or service provider.
 Contributors welcome!
 
 ## Quickstart
 
-Visit [instant.chat/signup](https://instant.chat/signup) to register.
+Visit [superuser.app/signup](https://superuser.app/signup) to register.
 Creating a new bot is easy, you can then use this CLI to develop
 and publish custom packages to extend your bots.
 
 ```shell
-$ npm i ibot -g
+$ npm i superuser.app -g
 $ mkdir new-project
 $ cd new-project
-$ ibot init  # initialize project in this directory
-$ ibot login # log in to Superuser Package Registry with your Superuser account
-$ ibot serve # run your tool package on a local server to test
-$ ibot run / # test a single endpoint (like curl)
-$ ibot up    # publish to development environment
-$ ibot up --env staging    # publish to staging environment
-$ ibot up --env production # publish to production environment
+$ sutr init  # initialize project in this directory
+$ sutr login # log in to Superuser toolkit registry with your Superuser account
+$ sutr serve # run your tool package on a local server to test
+$ sutr run / # test a single endpoint (like curl)
+$ sutr publish    # publish to development environment
+$ sutr publish --env staging    # publish to staging environment
+$ sutr publish --env production # publish to production environment
 ```
 
-You can run `ibot help` at any time to see available commands.
+You can run `sutr help` at any time to see available commands.
 
 # Table of contents
 
@@ -90,7 +90,7 @@ Tool packages are REST APIs that can be used by your agent. You can publish tool
 for use by your agent and others or keep them private.
 
 When you ask your agent a question that requires a tool call, Superuser will
-automatically route the request to the appropriate tool from the Superuser Package Registry
+automatically route the request to the appropriate tool from the Superuser toolkit registry
 and call the tool on your behalf.
 
 ## How is hosting billed?
@@ -100,7 +100,7 @@ for development purposes, you can use our lowest-tier model indefinitely in rate
 on the free tier **but only while on the web interface**.
 
 Tools cost money to run, and are billed as serverless functions
-at a rate of [$0.50 of credits per 1,000 GB-s](https://instant.chat/pricing) of usage.
+at a rate of [$0.50 of credits per 1,000 GB-s](https://superuser.app/pricing) of usage.
 Credits are prepaid, and during our beta period all users get a one-time bonus of $1.00
 in free usage credits.
 
@@ -112,33 +112,33 @@ For example, a function with 512 MB (0.5 GB) of RAM running for 200ms would use:
 
 # Building custom packages for your bots
 
-Building bots on [Superuser](https://instant.chat) is straightforward. Extending
+Building bots on [Superuser](https://superuser.app) is straightforward. Extending
 with custom tool packages can be done online via the web interface, or if you prefer
 working with your own editor, you can use this CLI.
 
 ## Initialize a project
 
-To initialize a new Superuser package:
+To initialize a new Superuser toolkit:
 
 ```shell
-$ npm i ibot -g
+$ npm i sutr -g
 $ mkdir new-project
 $ cd new-project
-$ ibot init
+$ sutr init
 ```
 
-You'll be walked through the process. The `ibot` CLI will automatically check for
+You'll be walked through the process. The `sutr` CLI will automatically check for
 updates to core packages, so make sure you update when available. To play around with your
-Superuser package locally;
+Superuser toolkit locally;
 
 ```shell
-$ ibot serve
+$ sutr serve
 ```
 
 Will start an HTTP server. To execute a standalone endpoint / tool:
 
 ```shell
-$ ibot run /
+$ sutr run /
 ```
 
 ### Defining tools aka endpoints
@@ -147,9 +147,9 @@ Defining custom tools is easy. You'll find the terms **tool** and
 **endpoint** used interchangeably as they all refer
 to the same thing: your bot executing custom code in the cloud.
 
-A **tool** is just an **endpoint** hosted by the Superuser Package Registry.
+A **tool** is just an **endpoint** hosted by the Superuser toolkit registry.
 
-All endpoints for Superuser packages live in the `functions/` directory.
+All endpoints for Superuser toolkits live in the `functions/` directory.
 Each file name maps to the endpoint route e.g. `functions/hello.js`
 routes to `localhost:8000/hello`. You can export custom `GET`, `POST`, `PUT`
 and `DELETE` functions from every file. Here's an example "hello world" endpoint:
@@ -173,7 +173,7 @@ your tool package.
 ### Endpoint name, description, types
 
 Using the comment block above every exported method (e.g. GET) you can
-define your endpoint. Superuser packages use an open source specification called
+define your endpoint. Superuser toolkits use an open source specification called
 [Instant API](https://github.com/instant-dev/api) to export JavaScript
 functions as type safe web APIs. You can learn more about how to properly
 define and document the shape (parameters) of your API there.
@@ -197,14 +197,14 @@ they will be billed from their balance.
 To deploy a public project to a `development` environment, you can use:
 
 ```shell
-$ ibot up
+$ sutr publish
 ```
 
 You can also publish to `staging` and `production` using:
 
 ```shell
-$ ibot up --env staging
-$ ibot up --env production
+$ sutr publish --env staging
+$ sutr publish --env production
 ```
 
 ### Private packages
@@ -233,15 +233,15 @@ There are a few additional utilities you may find useful with this package;
 
 ```shell
 # generates functions/my-endpoint/example.js
-$ ibot g:endpoint my-endpoint/example
+$ sutr g:endpoint my-endpoint/example
 ```
 
 ## Generate tests
 
 ```shell
 # Generate blank tests or ones for an endpoint
-$ ibot g:test my_test # OR ...
-$ ibot g:test --endpoint my-endpoint/example
+$ sutr g:test my_test # OR ...
+$ sutr g:test --endpoint my-endpoint/example
 ```
 
 ## Run tests
@@ -249,7 +249,7 @@ $ ibot g:test --endpoint my-endpoint/example
 You can write tests for your tools to verify they work. Simply run;
 
 ```shell
-$ ibot test
+$ sutr test
 ```
 
 And voila!
@@ -273,7 +273,7 @@ to another user of the platform.
 
 # Roadmap
 
-There's a lot to build! [Superuser](https://instant.chat) is still in early beta. Coming soon;
+There's a lot to build! [Superuser](https://superuser.app) is still in early beta. Coming soon;
 
 - Deploy to Slack
 - Uploading image support
@@ -289,7 +289,7 @@ but feel free to bookmark all of these links.
 
 | Destination | Link |
 | ----------- | ---- |
-| Superuser | [instant.chat](https://instant.chat) |
+| Superuser | [superuser.app](https://superuser.app) |
 | GitHub | [github.com/instantbots](https://github.com/instantbots) |
 | Discord | [discord.gg/instant](https://discord.gg/instant) |
 | X / instantbots | [x.com/instantbots](https://x.com/instantbots) |

package/commands/init.js

@@ -88,7 +88,7 @@ class InitCommand extends Command {
     if ((pkgExists || functExists) && !force) {
       throw new Error(
         `You already have a project initialized here.\n` +
-        `If you want to overwrite it, use \`$ ibot init --force\``
+        `If you want to overwrite it, use \`$ sup init --force\``
       );
     } else {
       console.log(`✨ We've detected you're starting from scratch`);
@@ -195,12 +195,12 @@ class InitCommand extends Command {
         `Here are some helpful commands to get started:`,
         ``,
         `(1) Create a set of endpoints for a path (create, read, update, destroy):`,
-        colors.grey.bold(`     $ ibot g:endpoint path/to/endpoint\n`),
+        colors.grey.bold(`     $ sup g:endpoint path/to/endpoint\n`),
         `(2) Run your dev server:`,
-        colors.grey.bold(`     $ ibot serve`),
+        colors.grey.bold(`     $ sup serve`),
         ``,
         `For more information about ${colors.bold(`Superuser`)}:`,
-        `     Home    => ${colors.bold.underline.blue('https://instant.chat')}`,
+        `     Home    => ${colors.bold.underline.blue('https://superuser.app')}`,
         `     GitHub  => ${colors.bold.underline.blue('https://github.com/instantbots')}`,
         `     Discord => ${colors.bold.underline.blue('https://discord.gg/instant')}`,
         `     X       => ${colors.bold.underline.blue('https://x.com/instantbots')}`,

package/commands/login.js

@@ -14,7 +14,7 @@ class LoginCommand extends Command {
 
   help () {
     return {
-      description: 'Login to the Superuser Package Registry',
+      description: 'Login to the Superuser toolkit registry',
       args: [],
       flags: {},
       vflags: {
@@ -101,7 +101,10 @@ class LoginCommand extends Command {
     console.log(colors.bold(`${colors.cyan(`Logged in`)} to ${colors.green('Superuser')} successfully!`));
     console.log(`${colors.bold(`email`)}:    ${user.email}`);
     if (user.memberships && user.memberships.length) {
-      console.log(`${colors.bold(`username`)}: ${user.memberships[0].organization.name}`);
+      const membership = user.memberships.find(m => m.organization?.is_user_primary);
+      if (membership) {
+        console.log(`${colors.bold(`username`)}: ${membership.organization.name}`);
+      }
     }
     console.log(`${colors.bold(`login at`)}: ${token.created_at}`);
     console.log();

package/commands/{up.js → publish.js}

@@ -19,7 +19,7 @@ const DEFAULT_IGNORE = [
   '.git',               // do not deploy git history
   '.DS_Store',          // do not deploy macOS files
   'package-lock.json',  // deps installed from package.json
-  'serve.instant.js'     // not used by Superuser Package Registry; irrelevant
+  'serve.instant.js'     // not used by Superuser toolkit registry; irrelevant
 ];
 
 function formatSize (size) {
@@ -76,12 +76,12 @@ function readFiles (base, properties, dir, data) {
 class UpCommand extends Command {
 
   constructor() {
-    super('up');
+    super('publish');
   }
 
   help () {
     return {
-      description: 'Deploys your project to the Superuser Package Registry',
+      description: 'Deploys your toolkit to the Superuser toolkit registry',
       args: [],
       flags: {
         v: 'Verbose mode; print full details of packaging'
@@ -130,9 +130,9 @@ class UpCommand extends Command {
     console.log();
 
     !fs.existsSync('/tmp') && fs.mkdirSync('/tmp');
-    !fs.existsSync('/tmp/ibot') && fs.mkdirSync('/tmp/ibot', 0o777);
+    !fs.existsSync('/tmp/sutr') && fs.mkdirSync('/tmp/sutr', 0o777);
     const tmpName = name.replace(/\//g, '.');
-    const tmpPath = `/tmp/ibot/${tmpName}.${new Date().valueOf()}.tar.gz`;
+    const tmpPath = `/tmp/sutr/${tmpName}.${new Date().valueOf()}.tar.gz`;
 
     const t0 = new Date().valueOf();
 
@@ -140,9 +140,9 @@ class UpCommand extends Command {
     const pack = tar.pack();
 
     let ignore = DEFAULT_IGNORE.slice();
-    if (fs.existsSync(path.join(process.cwd(), '.ibotignore'))) {
+    if (fs.existsSync(path.join(process.cwd(), '.sutrignore'))) {
       ignore = ignore.concat(
-        fs.readFileSync(path.join(process.cwd(), '.ibotignore')).toString()
+        fs.readFileSync(path.join(process.cwd(), '.sutrignore')).toString()
           .split('\n')
           .map(line => line.trim())
           .filter(line => !!line && !line.trim().startsWith('#'))
@@ -204,20 +204,18 @@ class UpCommand extends Command {
         {
           name: name,
           environment: env,
-          timeout: Math.max(1, Math.min(parseInt(functJSON.timeout) || 0), 900),
           tarball: {_base64: result.toString('base64')},
           _stream: true
         },
         ({event, data, id}) => {
           if (event === '@response') {
-            let json;
+            let result = data;
             try {
-              json = JSON.parse(data.body);
-              data.data = json;
+              result.data = JSON.parse(data.body);
             } catch (e) {
               // do nothing;
             }
-            resolve(data);
+            resolve(result);
           } else if (event === 'log') {
             console.log(`${colors.bold.grey(`Deploy:`)} ${data}`);
           }
@@ -241,11 +239,15 @@ class UpCommand extends Command {
     }
 
     const url = upResult.data.version_urls[env];
+    const registryUrl = upResult.data.registry_urls?.[env];
     const time = new Date().valueOf() - t0;
 
     console.log();
     console.log(`${colors.bold.green('Success:')} ${colors.bold(name)} deployed to ${colors.bold.grey(env)} in ${time} ms!`);
-    console.log(` => ${colors.bold.blue(url)}`);
+    if (registryUrl) {
+      console.log(` Registry URL => ${colors.bold.blue(registryUrl)}`);
+    }
+    console.log(` Web URL      => ${colors.bold.blue(url)}`);
     console.log();
 
     return void 0;

package/commands/register.js

@@ -15,7 +15,7 @@ class RegisterCommand extends Command {
 
   help () {
     return {
-      description: 'Registers a new user account with the Superuser Package Registry',
+      description: 'Registers a new user account with the Superuser toolkit registry',
       args: [],
       flags: {},
       vflags: {}

package/helpers/constants.js

@@ -1,3 +1,3 @@
 module.exports = {
-  BASE_URL: 'https://api.instant.chat'
+  BASE_URL: 'https://api.superuser.app'
 };

package/helpers/load_package.js

@@ -16,7 +16,7 @@ module.exports = async (params = null, validate = false) => {
     if (validate) {
       throw new Error(
         `No "superuser.json" in this directory. Are you sure you meant to do this?\n` +
-        `Run \`$ ibot init\` to initialize a project here if you are.`
+        `Run \`$ sup init\` to initialize a project here if you are.`
       );
     }
   } else {

package/helpers/settings_manager.js

@@ -2,7 +2,7 @@ const os = require('os');
 const fs = require('fs');
 const path = require('path');
 
-const SETTINGS_FILENAME = '~/.ibotrc';
+const SETTINGS_FILENAME = '~/.surc';
 
 const parsePathname = (pathname) => {
   if (!pathname) {
@@ -61,7 +61,7 @@ function readSettings (validate = false) {
     i++;
   }
   if (validate && !profileList[0]) {
-    throw new Error(`You are not logged in. Try \`ibot login\` to log in first.`);
+    throw new Error(`You are not logged in. Try \`sup login\` to log in first.`);
   }
   return {
     activeProfile: profileList[0],

package/helpers/verify_packages.js

@@ -17,13 +17,13 @@ module.exports = async (print = false) => {
   }
   const packages = [
     {
-      title: 'Superuser Package CLI',
+      title: 'Superuser toolkit registry',
       name: pkgs.self.name,
       version: pkgs.self.version,
       global: true
     },
     {
-      title: 'Superuser Package Gateway (Instant API)',
+      title: 'Superuser toolkit gateway (Instant API)',
       name: pkgs.api ? pkgs.api.name : null,
       version: pkgs.api ? pkgs.api.version : null,
       dev: true
@@ -63,7 +63,7 @@ module.exports = async (print = false) => {
       drawBox.center(
         `yellow`,
         ``,
-        `Updates are available for ${colors.bold('ibot')}:`,
+        `Updates are available for ${colors.bold('sutr')}:`,
         ``,
         ...updatePackages.map(pkg => {
           return [
@@ -74,7 +74,7 @@ module.exports = async (print = false) => {
           ].join('\n')
         }),
         `Install all with:`,
-        `${colors.bold.grey(`ibot update`)}`,
+        `${colors.bold.grey(`sup update`)}`,
         ``
       )
     );

package/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 const { CommandLineInterface } = require('cmnd');
-const CLI = new CommandLineInterface('Superuser Package CLI');
+const CLI = new CommandLineInterface('Superuser toolkit registry');
 
 CLI.load(__dirname, './commands');
 CLI.run(process.argv.slice(2));

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "superuser.app",
-  "version": "0.0.0",
-  "description": "Superuser package manager: command line interface for building toolkits for your agents",
+  "version": "0.0.1",
+  "description": "Superuser toolkit registry: command line interface for building toolkits for your agents",
   "main": "index.js",
   "files": [
     "/commands",
@@ -12,7 +12,7 @@
     "test": "echo \"Error: no test specified\" && exit 1"
   },
   "bin": {
-    "sup": "index.js"
+    "sutr": "index.js"
   },
   "author": "Keith Horwood",
   "license": "MIT",
@@ -21,7 +21,7 @@
     "colors": "^1.4.0",
     "i": "^0.3.7",
     "inquirer": "^8.2.6",
-    "io": "^1.5.0",
+    "io": "^1.5.8",
     "minimatch": "^9.0.4",
     "semver": "^7.5.4",
     "tar-stream": "^3.1.7",

package/src/init/serve.instant.js

@@ -1,5 +1,5 @@
 /**
- * This file is ** NOT ** used in production on the Superuser Package Registry
+ * This file is ** NOT ** used in production on the Superuser toolkit registry
  * Any code you change here ** WILL NOT ** run when hosted with Superuser Package
  * 
  * However, it used for local development and allows you to ship your Superuser Package