@pocketenv/cli 0.2.0

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@pocketenv/cli",
+  "main": "dist/index.js",
+  "bin": {
+    "pocketenv": "dist/index.js"
+  },
+  "version": "0.2.0",
+  "type": "module",
+  "keywords": [
+    "sandbox",
+    "atproto",
+    "bluesky",
+    "cli",
+    "agent",
+    "openclaw",
+    "microvm"
+  ],
+  "author": "Tsiry Sandratraina <tsiry.sndr@pocketenv.io>",
+  "license": "MPL-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/pocketenv-io/pocketenv"
+  },
+  "scripts": {
+    "dev": "tsx ./src/index.ts",
+    "build": "pkgroll && chmod +x ./dist/index.js"
+  },
+  "peerDependencies": {
+    "typescript": "^5"
+  },
+  "devDependencies": {
+    "@types/cors": "^2.8.19",
+    "@types/eventsource": "^1.1.15",
+    "@types/express": "^5.0.6",
+    "@types/ws": "^8.18.1",
+    "pkgroll": "^2.27.0",
+    "tsx": "^4.21.0"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^8.3.0",
+    "axios": "^1.13.6",
+    "chalk": "^5.6.2",
+    "cli-table3": "^0.6.5",
+    "commander": "^14.0.3",
+    "consola": "^3.4.2",
+    "cors": "^2.8.6",
+    "dayjs": "^1.11.20",
+    "effect": "^3.19.19",
+    "envalid": "^8.1.1",
+    "eventsource": "^4.1.0",
+    "express": "^5.2.1",
+    "libsodium-wrappers": "^0.8.2",
+    "open": "^11.0.0",
+    "ws": "^8.19.0",
+    "zod": "^4.3.6"
+  }
+}

package/src/client.ts

@@ -0,0 +1,6 @@
+import axios from "axios";
+import { env } from "./lib/env";
+
+export const client = axios.create({
+  baseURL: env.POCKETENV_API_URL,
+});

package/src/cmd/create.ts

@@ -0,0 +1,46 @@
+import consola from "consola";
+import { client } from "../client";
+import getAccessToken from "../lib/getAccessToken";
+import type { Sandbox } from "../types/sandbox";
+import chalk from "chalk";
+import connectToSandbox from "./ssh";
+
+async function createSandbox(
+  name: string,
+  { provider, ssh }: { provider: string | undefined; ssh: boolean | undefined },
+) {
+  const token = await getAccessToken();
+
+  if (["deno", "vercel", "daytona"].includes(provider || "")) {
+    consola.error(
+      `This Sandbox Runtime is temporarily disabled. ${chalk.greenBright(provider ?? "")}`,
+    );
+    process.exit(1);
+  }
+  try {
+    const sandbox = await client.post<Sandbox>(
+      "/xrpc/io.pocketenv.sandbox.createSandbox",
+      {
+        name,
+        base: "at://did:plc:aturpi2ls3yvsmhc6wybomun/io.pocketenv.sandbox/openclaw",
+        provider: provider ?? "cloudflare",
+      },
+      {
+        headers: {
+          Authorization: `Bearer ${token}`,
+        },
+      },
+    );
+    if (!ssh) {
+      consola.success(
+        `Sandbox created successfully: ${chalk.greenBright(sandbox.data.name)}`,
+      );
+      return;
+    }
+    await connectToSandbox(sandbox.data.name);
+  } catch (error) {
+    consola.error(`Failed to create sandbox: ${error}`);
+  }
+}
+
+export default createSandbox;

package/src/cmd/env.ts

@@ -0,0 +1,126 @@
+import { client } from "../client";
+import getAccessToken from "../lib/getAccessToken";
+import type { Sandbox } from "../types/sandbox";
+import type { Variable } from "../types/variable";
+import chalk from "chalk";
+import dayjs from "dayjs";
+import consola from "consola";
+import Table from "cli-table3";
+import { env } from "../lib/env";
+
+export async function listEnvs(sandbox: string) {
+  const token = await getAccessToken();
+  const { data } = await client.get<{ sandbox: Sandbox }>(
+    "/xrpc/io.pocketenv.sandbox.getSandbox",
+    {
+      params: {
+        id: sandbox,
+      },
+      headers: {
+        Authorization: `Bearer ${token}`,
+      },
+    },
+  );
+
+  if (!data.sandbox) {
+    consola.error(`Sandbox not found: ${chalk.greenBright(sandbox)}`);
+    process.exit(1);
+  }
+
+  const response = await client.get<{ variables: Variable[] }>(
+    "/xrpc/io.pocketenv.variable.getVariables",
+    {
+      params: {
+        sandboxId: data.sandbox.id,
+        offset: 0,
+        limit: 100,
+      },
+      headers: {
+        Authorization: `Bearer ${env.POCKETENV_TOKEN || token}`,
+      },
+    },
+  );
+
+  const table = new Table({
+    head: [
+      chalk.cyan("ID"),
+      chalk.cyan("NAME"),
+      chalk.cyan("VALUE"),
+      chalk.cyan("CREATED AT"),
+    ],
+    chars: {
+      top: "",
+      "top-mid": "",
+      "top-left": "",
+      "top-right": "",
+      bottom: "",
+      "bottom-mid": "",
+      "bottom-left": "",
+      "bottom-right": "",
+      left: "",
+      "left-mid": "",
+      mid: "",
+      "mid-mid": "",
+      right: "",
+      "right-mid": "",
+      middle: " ",
+    },
+    style: {
+      border: [],
+      head: [],
+    },
+  });
+
+  for (const variable of response.data.variables) {
+    table.push([
+      chalk.greenBright(variable.id),
+      chalk.greenBright(variable.name),
+      variable.value,
+      dayjs(variable.createdAt).fromNow(),
+    ]);
+  }
+
+  consola.log(table.toString());
+}
+
+export async function putEnv(sandbox: string, key: string, value: string) {
+  const token = await getAccessToken();
+  const { data } = await client.get<{ sandbox: Sandbox }>(
+    "/xrpc/io.pocketenv.sandbox.getSandbox",
+    {
+      params: {
+        id: sandbox,
+      },
+      headers: {
+        Authorization: `Bearer ${env.POCKETENV_TOKEN || token}`,
+      },
+    },
+  );
+
+  await client.post(
+    "/xrpc/io.pocketenv.variable.addVariable",
+    {
+      variable: { sandboxId: data.sandbox.id, name: key, value: value },
+    },
+    {
+      headers: {
+        Authorization: `Bearer ${env.POCKETENV_TOKEN || token}`,
+      },
+    },
+  );
+
+  consola.success("Variable updated successfully");
+}
+
+export async function deleteEnv(id: string) {
+  const token = await getAccessToken();
+
+  await client.post("/xrpc/io.pocketenv.variable.deleteVariable", undefined, {
+    params: { id },
+    headers: {
+      Authorization: `Bearer ${env.POCKETENV_TOKEN || token}`,
+    },
+  });
+
+  consola.success("Variable deleted successfully");
+}

package/src/cmd/list.ts

@@ -0,0 +1,80 @@
+import { client } from "../client";
+import chalk from "chalk";
+import consola from "consola";
+import { env } from "../lib/env";
+import getAccessToken from "../lib/getAccessToken";
+import type { Sandbox } from "../types/sandbox";
+import Table from "cli-table3";
+import dayjs from "dayjs";
+import relativeTime from "dayjs/plugin/relativeTime";
+import type { Profile } from "../types/profile";
+dayjs.extend(relativeTime);
+
+async function listSandboxes() {
+  const token = await getAccessToken();
+
+  const profile = await client.get<Profile>(
+    "/xrpc/io.pocketenv.actor.getProfile",
+    {
+      headers: {
+        Authorization: `Bearer ${env.POCKETENV_TOKEN || token}`,
+      },
+    },
+  );
+
+  const response = await client.get<{ sandboxes: Sandbox[] }>(
+    "/xrpc/io.pocketenv.actor.getActorSandboxes",
+    {
+      params: {
+        did: profile.data.did,
+        offset: 0,
+        limit: 100,
+      },
+    },
+  );
+
+  const table = new Table({
+    head: [
+      chalk.cyan("NAME"),
+      chalk.cyan("BASE"),
+      chalk.cyan("STATUS"),
+      chalk.cyan("CREATED AT"),
+    ],
+    chars: {
+      top: "",
+      "top-mid": "",
+      "top-left": "",
+      "top-right": "",
+      bottom: "",
+      "bottom-mid": "",
+      "bottom-left": "",
+      "bottom-right": "",
+      left: "",
+      "left-mid": "",
+      mid: "",
+      "mid-mid": "",
+      right: "",
+      "right-mid": "",
+      middle: " ",
+    },
+    style: {
+      border: [],
+      head: [],
+    },
+  });
+
+  for (const sandbox of response.data.sandboxes) {
+    table.push([
+      chalk.greenBright(sandbox.name),
+      sandbox.baseSandbox,
+      sandbox.status === "RUNNING"
+        ? chalk.greenBright(sandbox.status)
+        : sandbox.status,
+      dayjs(sandbox.createdAt).fromNow(),
+    ]);
+  }
+
+  consola.log(table.toString());
+}
+
+export default listSandboxes;

package/src/cmd/login.ts

@@ -0,0 +1,49 @@
+import { client } from "../client";
+import open from "open";
+import express, { type Request, type Response } from "express";
+import cors from "cors";
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import chalk from "chalk";
+
+async function login(handle: string) {
+  const app = express();
+  app.use(cors());
+  app.use(express.json());
+
+  const server = app.listen(6997);
+
+  app.post("/token", async (req: Request, res: Response) => {
+    console.log(chalk.bold(chalk.greenBright("Login successful!\n")));
+    const tokenPath = path.join(os.homedir(), ".pocketenv", "token.json");
+    await fs.mkdir(path.dirname(tokenPath), { recursive: true });
+    await fs.writeFile(
+      tokenPath,
+      JSON.stringify({ token: req.body.token }, null, 2),
+    );
+
+    res.json({
+      ok: 1,
+    });
+
+    server.close();
+  });
+
+  const response = await client.post(`/login`, { handle, cli: true });
+
+  const redirectUrl = response.data;
+
+  if (!redirectUrl.includes("authorize")) {
+    console.error("Failed to login, please check your handle and try again.");
+    server.close();
+    return;
+  }
+
+  console.log("Please visit this URL to authorize the app:");
+  console.log(chalk.cyan(redirectUrl));
+
+  await open(response.data);
+}
+
+export default login;

package/src/cmd/logout.ts

@@ -0,0 +1,20 @@
+import os from "node:os";
+import path from "node:path";
+import fs from "node:fs/promises";
+import consola from "consola";
+
+async function logout() {
+  const tokenPath = path.join(os.homedir(), ".pocketenv", "token.json");
+
+  try {
+    await fs.access(tokenPath);
+  } catch {
+    consola.log("Logged out successfully");
+    return;
+  }
+
+  await fs.unlink(tokenPath);
+  consola.log("Logged out successfully");
+}
+
+export default logout;

package/src/cmd/rm.ts

@@ -0,0 +1,24 @@
+import consola from "consola";
+import { client } from "../client";
+import { env } from "../lib/env";
+import getAccessToken from "../lib/getAccessToken";
+
+async function deleteSandbox(id: string) {
+  const token = await getAccessToken();
+  try {
+    await client.post("/xrpc/io.pocketenv.sandbox.deleteSandbox", undefined, {
+      params: {
+        id,
+      },
+      headers: {
+        Authorization: `Bearer ${env.POCKETENV_TOKEN || token}`,
+      },
+    });
+
+    consola.success("Sandbox deleted successfully");
+  } catch {
+    consola.error("Failed to delete sandbox");
+  }
+}
+
+export default deleteSandbox;

package/src/cmd/secret.ts

@@ -0,0 +1,127 @@
+import { client } from "../client";
+import getAccessToken from "../lib/getAccessToken";
+import { password } from "@inquirer/prompts";
+import type { Sandbox } from "../types/sandbox";
+import type { Secret } from "../types/secret";
+import chalk from "chalk";
+import consola from "consola";
+import Table from "cli-table3";
+import dayjs from "dayjs";
+import relativeTime from "dayjs/plugin/relativeTime";
+import { env } from "../lib/env";
+import encrypt from "../lib/sodium";
+
+dayjs.extend(relativeTime);
+
+export async function listSecrets(sandbox: string) {
+  const token = await getAccessToken();
+  const { data } = await client.get<{ sandbox: Sandbox }>(
+    "/xrpc/io.pocketenv.sandbox.getSandbox",
+    {
+      params: {
+        id: sandbox,
+      },
+      headers: {
+        Authorization: `Bearer ${env.POCKETENV_TOKEN || token}`,
+      },
+    },
+  );
+  const response = await client.get<{ secrets: Secret[] }>(
+    "/xrpc/io.pocketenv.secret.getSecrets",
+    {
+      params: {
+        sandboxId: data.sandbox.id,
+        offset: 0,
+        limit: 100,
+      },
+      headers: {
+        Authorization: `Bearer ${env.POCKETENV_TOKEN || token}`,
+      },
+    },
+  );
+
+  const table = new Table({
+    head: [chalk.cyan("ID"), chalk.cyan("NAME"), chalk.cyan("CREATED AT")],
+    chars: {
+      top: "",
+      "top-mid": "",
+      "top-left": "",
+      "top-right": "",
+      bottom: "",
+      "bottom-mid": "",
+      "bottom-left": "",
+      "bottom-right": "",
+      left: "",
+      "left-mid": "",
+      mid: "",
+      "mid-mid": "",
+      right: "",
+      "right-mid": "",
+      middle: " ",
+    },
+    style: {
+      border: [],
+      head: [],
+    },
+  });
+
+  for (const secret of response.data.secrets) {
+    table.push([
+      chalk.greenBright(secret.id),
+      chalk.greenBright(secret.name),
+      dayjs(secret.createdAt).fromNow(),
+    ]);
+  }
+
+  consola.log(table.toString());
+}
+
+export async function putSecret(sandbox: string, key: string) {
+  const token = await getAccessToken();
+  const value = await password({ message: "Enter secret value" });
+
+  const { data } = await client.get("/xrpc/io.pocketenv.sandbox.getSandbox", {
+    params: {
+      id: sandbox,
+    },
+    headers: {
+      Authorization: `Bearer ${env.POCKETENV_TOKEN || token}`,
+    },
+  });
+
+  if (!data.sandbox) {
+    consola.error(`Sandbox not found: ${chalk.greenBright(sandbox)}`);
+    process.exit(1);
+  }
+
+  await client.post(
+    "/xrpc/io.pocketenv.secret.addSecret",
+    {
+      secret: {
+        sandboxId: data.sandbox.id,
+        name: key,
+        value: await encrypt(value),
+      },
+    },
+    {
+      headers: {
+        Authorization: `Bearer ${env.POCKETENV_TOKEN || token}`,
+      },
+    },
+  );
+}
+
+export async function deleteSecret(id: string) {
+  const token = await getAccessToken();
+
+  await client.post("/xrpc/io.pocketenv.secret.deleteSecret", undefined, {
+    params: {
+      id,
+    },
+    headers: {
+      Authorization: `Bearer ${env.POCKETENV_TOKEN || token}`,
+    },
+  });
+
+  consola.success("Secret deleted successfully");
+}