@astroanywhere/cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Astro Anywhere
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,58 @@
+# @astroanywhere/cli
+
+CLI for managing [Astro](https://github.com/astro-anywhere) projects, plans, tasks, and environments.
+
+## Install
+
+```bash
+npm install -g @astroanywhere/cli
+```
+
+## Usage
+
+```bash
+# Configure server connection
+astro-cli config set server-url http://localhost:3001
+
+# Authenticate (for remote servers)
+astro-cli login
+
+# List projects
+astro-cli project list
+
+# View plan
+astro-cli plan tree --project-id <id>
+
+# Dispatch a task
+astro-cli task dispatch <nodeId> --project-id <id>
+
+# Watch task output
+astro-cli task watch <executionId>
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `project list\|show\|create\|delete` | Manage projects |
+| `plan tree\|create-node\|update-node` | Manage plan graphs |
+| `task list\|show\|dispatch\|cancel\|steer\|watch` | Manage tasks |
+| `env list\|show\|revoke` | Manage environments and machines |
+| `search <query>` | Search across projects, tasks, executions |
+| `activity` | View activity feed |
+| `trace` | View execution traces |
+| `config` | Manage CLI configuration |
+| `login\|logout\|whoami` | Authentication |
+
+## Configuration
+
+Config is stored at `~/.astro/config.json`.
+
+| Setting | Env var | Description |
+|---------|---------|-------------|
+| `serverUrl` | `ASTRO_SERVER_URL` | Astro server URL |
+| `authToken` | — | Access token (set via `login`) |
+
+## License
+
+MIT

package/dist/chunk-PYFBZGQG.js

@@ -0,0 +1,351 @@
+// src/config.ts
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+var CONFIG_DIR = join(homedir(), ".astro");
+var CONFIG_FILE = join(CONFIG_DIR, "config.json");
+var DEFAULT_SERVER_URL = "https://api.astroanywhere.com";
+function loadConfig() {
+  try {
+    if (existsSync(CONFIG_FILE)) {
+      const raw = readFileSync(CONFIG_FILE, "utf-8");
+      return { serverUrl: DEFAULT_SERVER_URL, ...JSON.parse(raw) };
+    }
+  } catch {
+  }
+  return { serverUrl: DEFAULT_SERVER_URL };
+}
+function saveConfig(updates) {
+  mkdirSync(CONFIG_DIR, { recursive: true });
+  const current = loadConfig();
+  const merged = { ...current, ...updates };
+  writeFileSync(CONFIG_FILE, JSON.stringify(merged, null, 2) + "\n");
+}
+function clearAuth() {
+  const current = loadConfig();
+  delete current.authToken;
+  delete current.refreshToken;
+  mkdirSync(CONFIG_DIR, { recursive: true });
+  writeFileSync(CONFIG_FILE, JSON.stringify(current, null, 2) + "\n");
+}
+function resetConfig() {
+  mkdirSync(CONFIG_DIR, { recursive: true });
+  writeFileSync(CONFIG_FILE, JSON.stringify({ serverUrl: DEFAULT_SERVER_URL }, null, 2) + "\n");
+}
+function getServerUrl(cliOverride) {
+  if (cliOverride) return cliOverride;
+  if (process.env.ASTRO_SERVER_URL) return process.env.ASTRO_SERVER_URL;
+  const config = loadConfig();
+  return config.serverUrl;
+}
+
+// src/client.ts
+var AstroClient = class {
+  baseUrl;
+  headers;
+  constructor(opts) {
+    this.baseUrl = getServerUrl(opts?.serverUrl);
+    const config = loadConfig();
+    this.headers = {
+      "Content-Type": "application/json",
+      ...config.authToken ? { Authorization: `Bearer ${config.authToken}` } : {}
+    };
+  }
+  async refreshAccessToken() {
+    const config = loadConfig();
+    if (!config.refreshToken) return false;
+    try {
+      const url = new URL("/api/device/refresh", this.baseUrl);
+      const res = await fetch(url.toString(), {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ refreshToken: config.refreshToken, grantType: "refresh_token" })
+      });
+      if (!res.ok) return false;
+      const data = await res.json();
+      saveConfig({
+        authToken: data.accessToken,
+        ...data.refreshToken ? { refreshToken: data.refreshToken } : {}
+      });
+      this.headers["Authorization"] = `Bearer ${data.accessToken}`;
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  async request(method, path, body, params) {
+    const url = new URL(path, this.baseUrl);
+    if (params) {
+      for (const [k, v] of Object.entries(params)) {
+        if (v !== void 0) url.searchParams.set(k, v);
+      }
+    }
+    let res = await fetch(url.toString(), {
+      method,
+      headers: this.headers,
+      body: body ? JSON.stringify(body) : void 0
+    });
+    if (res.status === 401) {
+      const refreshed = await this.refreshAccessToken();
+      if (refreshed) {
+        res = await fetch(url.toString(), {
+          method,
+          headers: this.headers,
+          body: body ? JSON.stringify(body) : void 0
+        });
+      }
+    }
+    if (!res.ok) {
+      const text = await res.text();
+      throw new Error(`API error ${res.status}: ${text}`);
+    }
+    return res.json();
+  }
+  get(path, params) {
+    return this.request("GET", path, void 0, params);
+  }
+  post(path, body) {
+    return this.request("POST", path, body);
+  }
+  del(path) {
+    return this.request("DELETE", path);
+  }
+  // ── Projects ────────────────────────────────────────────────────────
+  async listProjects() {
+    return this.get("/api/data/projects");
+  }
+  async getProject(id) {
+    return this.get(`/api/data/projects/${id}`);
+  }
+  async createProject(data) {
+    return this.post("/api/data/projects", data);
+  }
+  async deleteProject(id) {
+    return this.del(`/api/data/projects/${id}`);
+  }
+  /**
+   * Resolve a partial project ID to a full project.
+   * Lists all projects and finds the one matching the prefix.
+   * Throws if 0 or >1 matches.
+   */
+  async resolveProject(partialId) {
+    const projects = await this.listProjects();
+    const matches = projects.filter((p) => p.id.startsWith(partialId));
+    if (matches.length === 0) throw new Error(`No project found matching "${partialId}"`);
+    if (matches.length > 1) throw new Error(`Ambiguous ID "${partialId}" matches ${matches.length} projects`);
+    return matches[0];
+  }
+  // ── Plan ────────────────────────────────────────────────────────────
+  async getPlan(projectId) {
+    const result = await this.get(`/api/data/plan/${projectId}`);
+    return {
+      nodes: result.nodes ?? [],
+      edges: result.edges ?? []
+    };
+  }
+  async getFullPlan() {
+    const result = await this.get("/api/data/plan");
+    return {
+      nodes: result.nodes ?? [],
+      edges: result.edges ?? []
+    };
+  }
+  // ── Executions ──────────────────────────────────────────────────────
+  /**
+   * Get executions map keyed by nodeClientId.
+   * Server returns Record<nodeClientId, Execution>.
+   */
+  async getExecutions() {
+    return this.get("/api/data/executions");
+  }
+  // ── Tool Traces & File Changes ─────────────────────────────────────
+  async listToolTraces(executionId) {
+    return this.get("/api/data/tool-traces", { executionId });
+  }
+  async listFileChanges(executionId) {
+    return this.get("/api/data/file-changes", { executionId });
+  }
+  // ── Activity ────────────────────────────────────────────────────────
+  async listActivities(params) {
+    return this.get("/api/data/activities", params);
+  }
+  // ── Machines ────────────────────────────────────────────────────────
+  async listMachines() {
+    const result = await this.get("/api/device/machines");
+    return result.machines ?? [];
+  }
+  async getMachine(id) {
+    return this.get(`/api/device/machines/${id}`);
+  }
+  async revokeMachine(id) {
+    return this.del(`/api/device/machines/${id}`);
+  }
+  /**
+   * Resolve a partial machine ID to a full machine.
+   * Lists all machines and finds the one matching the prefix.
+   */
+  async resolveMachine(partialId) {
+    const machines = await this.listMachines();
+    const matches = machines.filter((m) => !m.isRevoked && m.id.startsWith(partialId));
+    if (matches.length === 0) throw new Error(`No active machine found matching "${partialId}"`);
+    if (matches.length > 1) throw new Error(`Ambiguous ID "${partialId}" matches ${matches.length} machines`);
+    return matches[0];
+  }
+  // ── Observations ────────────────────────────────────────────────────
+  async listObservations(executionId) {
+    return this.get("/api/observations", { executionId });
+  }
+  async getObservationStats(executionId) {
+    return this.get("/api/observations/stats", { executionId });
+  }
+  // ── Search ──────────────────────────────────────────────────────────
+  async search(query) {
+    return this.get("/api/data/search", { q: query });
+  }
+  // ── Plan CRUD ─────────────────────────────────────────────────────
+  async createPlanNode(data) {
+    return this.post("/api/data/plan/nodes", {
+      type: "task",
+      status: "planned",
+      ...data
+    });
+  }
+  async updatePlanNode(nodeId, patch) {
+    return this.request("PATCH", `/api/data/plan/nodes/${nodeId}`, patch);
+  }
+  async deletePlanNode(nodeId) {
+    return this.del(`/api/data/plan/nodes/${nodeId}`);
+  }
+  // ── Project Update ────────────────────────────────────────────────
+  async updateProject(id, patch) {
+    return this.request("PATCH", `/api/data/projects/${id}`, patch);
+  }
+  // ── Cancel / Steer ────────────────────────────────────────────────
+  async cancelTask(params) {
+    return this.post("/api/dispatch/cancel", params);
+  }
+  async steerTask(params) {
+    return this.post("/api/dispatch/steer", params);
+  }
+  // ── Relay / Environment ───────────────────────────────────────────
+  async getRelayStatus() {
+    return this.get("/api/relay/status");
+  }
+  async getProviders() {
+    return this.get("/api/health/providers");
+  }
+  async getSlurmClusters() {
+    return this.get("/api/relay/slurm/clusters");
+  }
+  // ── Observations (extended) ───────────────────────────────────────
+  async getTraceSummary(executionId) {
+    const url = new URL(`/api/observations/${executionId}/summary`, this.baseUrl);
+    const res = await fetch(url.toString(), { headers: this.headers });
+    if (!res.ok) {
+      const text = await res.text();
+      throw new Error(`API error ${res.status}: ${text}`);
+    }
+    return res.text();
+  }
+  async listObservationsFiltered(params) {
+    return this.get("/api/observations", params);
+  }
+  // ── SSE Events Stream ─────────────────────────────────────────────
+  async streamEvents(params) {
+    const url = new URL("/api/events/stream", this.baseUrl);
+    if (params?.projectId) url.searchParams.set("projectId", params.projectId);
+    const res = await fetch(url.toString(), {
+      headers: {
+        ...this.headers,
+        Accept: "text/event-stream"
+      }
+    });
+    if (!res.ok) {
+      const text = await res.text();
+      throw new Error(`SSE connect failed (${res.status}): ${text}`);
+    }
+    return res;
+  }
+  // ── Dispatch (SSE streaming) ────────────────────────────────────────
+  /**
+   * Dispatch a task for execution. Returns the raw Response for SSE streaming.
+   */
+  async dispatchTask(payload) {
+    const url = new URL("/api/dispatch/task", this.baseUrl);
+    const res = await fetch(url.toString(), {
+      method: "POST",
+      headers: this.headers,
+      body: JSON.stringify(payload)
+    });
+    if (!res.ok) {
+      const text = await res.text();
+      throw new Error(`Dispatch failed (${res.status}): ${text}`);
+    }
+    return res;
+  }
+};
+async function streamDispatchToStdout(response) {
+  if (!response.body) {
+    console.log("Task dispatched (no stream)");
+    return;
+  }
+  const reader = response.body.getReader();
+  const decoder = new TextDecoder();
+  let buffer = "";
+  while (true) {
+    const { done, value } = await reader.read();
+    if (done) break;
+    buffer += decoder.decode(value, { stream: true });
+    const lines = buffer.split("\n");
+    buffer = lines.pop() ?? "";
+    for (const line of lines) {
+      if (line.startsWith("data: ")) {
+        try {
+          const event = JSON.parse(line.slice(6));
+          switch (event.type) {
+            case "text":
+              process.stdout.write(event.content ?? "");
+              break;
+            case "tool_use":
+              console.log(`
+[tool] ${event.name}`);
+              break;
+            case "result":
+              console.log(`
+--- Result: ${event.status} ---`);
+              if (event.summary) console.log(event.summary);
+              break;
+            case "error":
+              console.error(`
+Error: ${event.message}`);
+              break;
+            case "done":
+              break;
+          }
+        } catch {
+        }
+      }
+    }
+  }
+}
+var _client = null;
+var _clientUrl;
+function getClient(serverUrl) {
+  const resolvedUrl = getServerUrl(serverUrl);
+  if (!_client || resolvedUrl !== _clientUrl) {
+    _client = new AstroClient({ serverUrl });
+    _clientUrl = resolvedUrl;
+  }
+  return _client;
+}
+
+export {
+  loadConfig,
+  saveConfig,
+  clearAuth,
+  resetConfig,
+  getServerUrl,
+  AstroClient,
+  streamDispatchToStdout,
+  getClient
+};

package/dist/client.js

@@ -0,0 +1,10 @@
+import {
+  AstroClient,
+  getClient,
+  streamDispatchToStdout
+} from "./chunk-PYFBZGQG.js";
+export {
+  AstroClient,
+  getClient,
+  streamDispatchToStdout
+};