agor-live 0.3.15 → 0.4.2

package/bin/agor-daemon.js

@@ -7,8 +7,14 @@
  * The daemon is compiled from apps/agor-daemon and bundled during build.
  */
 
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
+// Check Node.js version requirement before loading any dependencies
+import { checkNodeVersion } from './version-check.js';
+
+checkNodeVersion();
+
+// Use dynamic imports to ensure version check runs first
+const path = await import('node:path');
+const { fileURLToPath } = await import('node:url');
 
 // Get directory of this file
 const dirname = path.dirname(fileURLToPath(import.meta.url));

package/bin/agor.js

@@ -7,7 +7,13 @@
  * The CLI commands are compiled from apps/agor-cli and bundled during build.
  */
 
-import { execute } from '@oclif/core';
+// Check Node.js version requirement before loading any dependencies
+import { checkNodeVersion } from './version-check.js';
+
+checkNodeVersion();
+
+// Use dynamic import to ensure version check runs first
+const { execute } = await import('@oclif/core');
 
 // oclif will resolve commands relative to this file
 // Commands are at ../dist/cli/commands (configured in package.json)

package/bin/version-check.js

@@ -0,0 +1,20 @@
+/**
+ * Node.js version check utility
+ * Used by CLI and daemon entry points to ensure Node 20+ requirement
+ */
+
+import chalk from 'chalk';
+
+export function checkNodeVersion() {
+  const nodeVersion = process.versions.node;
+  const majorVersion = parseInt(nodeVersion.split('.')[0], 10);
+
+  if (majorVersion < 20) {
+    console.error(chalk.red('✖ Error: Agor requires Node.js v20.0.0 or higher'));
+    console.error(chalk.yellow(`  Current version: v${nodeVersion}\n`));
+    console.error('Please upgrade Node.js:');
+    console.error(`  • Using nvm: ${chalk.cyan('nvm install 20 && nvm use 20')}`);
+    console.error(`  • Download: ${chalk.cyan('https://nodejs.org/')}\n`);
+    process.exit(1);
+  }
+}

package/dist/cli/commands/init.js

@@ -214,6 +214,10 @@ var Init = class _Init extends Command {
     if (!skipPrompts) {
       await this.promptAuthSetup(dbPath);
       await this.promptApiKeys();
+    } else {
+      await setConfigValue("daemon.requireAuth", true);
+      await setConfigValue("daemon.allowAnonymous", false);
+      this.log(`${chalk.green("   \u2713")} Enabled authentication (multiplayer mode)`);
     }
     this.log("");
     this.log(chalk.green.bold("\u2705 Agor initialized successfully!"));

package/dist/cli/commands/open.d.ts

@@ -0,0 +1,13 @@
+import { Command } from '@oclif/core';
+
+/**
+ * `agor open` - Open Agor UI in browser
+ */
+
+declare class Open extends Command {
+    static description: string;
+    static examples: string[];
+    run(): Promise<void>;
+}
+
+export { Open as default };

package/dist/cli/commands/open.js

@@ -0,0 +1,90 @@
+// src/commands/open.ts
+import { exec } from "child_process";
+import { promisify } from "util";
+import { isDaemonRunning } from "@agor/core/api";
+import { getDaemonUrl } from "@agor/core/config";
+import { Command } from "@oclif/core";
+import chalk from "chalk";
+
+// src/lib/context.ts
+import path from "path";
+import { fileURLToPath } from "url";
+function isInstalledPackage() {
+  const dirname = typeof __dirname !== "undefined" ? __dirname : path.dirname(fileURLToPath(import.meta.url));
+  const isInMonorepoSource = dirname.includes("/apps/agor-cli/") || dirname.includes("\\apps\\agor-cli\\");
+  return !isInMonorepoSource;
+}
+function isCodespaces() {
+  return !!process.env.CODESPACE_NAME && !!process.env.GITHUB_CODESPACES_PORT_FORWARDING_DOMAIN;
+}
+function getUIUrl() {
+  if (isCodespaces()) {
+    const codespaceName = process.env.CODESPACE_NAME;
+    const domain = process.env.GITHUB_CODESPACES_PORT_FORWARDING_DOMAIN;
+    if (isInstalledPackage()) {
+      return `https://${codespaceName}-3030.${domain}/ui`;
+    } else {
+      return `https://${codespaceName}-5173.${domain}`;
+    }
+  }
+  if (isInstalledPackage()) {
+    return "http://localhost:3030/ui";
+  } else {
+    return "http://localhost:5173";
+  }
+}
+
+// src/commands/open.ts
+var execAsync = promisify(exec);
+var Open = class extends Command {
+  static description = "Open Agor UI in browser";
+  static examples = ["<%= config.bin %> <%= command.id %>"];
+  async run() {
+    const daemonUrl = await getDaemonUrl();
+    const running = await isDaemonRunning(daemonUrl);
+    if (!running) {
+      this.log(chalk.red("\u2717 Daemon is not running"));
+      this.log("");
+      this.log("Start the daemon first:");
+      this.log("  " + chalk.cyan("agor daemon start"));
+      this.log("");
+      this.exit(1);
+    }
+    const uiUrl = getUIUrl();
+    if (isCodespaces()) {
+      this.log(chalk.green("\u2713 Agor UI is ready"));
+      this.log("");
+      this.log("Open this URL in your browser:");
+      this.log("  " + chalk.cyan(uiUrl));
+      this.log("");
+      this.log(chalk.dim("(GitHub Codespaces will automatically forward the port)"));
+      this.log("");
+      return;
+    }
+    try {
+      this.log(chalk.green("Opening Agor UI in browser..."));
+      this.log(chalk.dim(`URL: ${uiUrl}`));
+      this.log("");
+      const platform = process.platform;
+      let command;
+      if (platform === "darwin") {
+        command = `open "${uiUrl}"`;
+      } else if (platform === "win32") {
+        command = `start "" "${uiUrl}"`;
+      } else {
+        command = `xdg-open "${uiUrl}"`;
+      }
+      await execAsync(command);
+      this.log(chalk.green("\u2713 Browser opened"));
+    } catch (error) {
+      this.log(chalk.yellow("\u26A0 Could not open browser automatically"));
+      this.log("");
+      this.log("Visit this URL manually:");
+      this.log("  " + chalk.cyan(uiUrl));
+      this.log("");
+    }
+  }
+};
+export {
+  Open as default
+};

package/dist/cli/lib/context.d.ts

@@ -17,6 +17,12 @@ declare function isInstalledPackage(): boolean;
  * @returns path to daemon binary, or null if in development
  */
 declare function getDaemonPath(): string | null;
+/**
+ * Check if running in GitHub Codespaces
+ *
+ * @returns true if running in Codespaces
+ */
+declare function isCodespaces(): boolean;
 /**
  * Get appropriate UI URL based on context
  *
@@ -24,4 +30,4 @@ declare function getDaemonPath(): string | null;
  */
 declare function getUIUrl(): string;
 
-export { getDaemonPath, getUIUrl, isInstalledPackage };
+export { getDaemonPath, getUIUrl, isCodespaces, isInstalledPackage };

package/dist/cli/lib/context.js

@@ -18,7 +18,19 @@ function getDaemonPath() {
   const packageRoot = dirname.substring(0, cliDistIndex);
   return path.join(packageRoot, "dist", "daemon", "index.js");
 }
+function isCodespaces() {
+  return !!process.env.CODESPACE_NAME && !!process.env.GITHUB_CODESPACES_PORT_FORWARDING_DOMAIN;
+}
 function getUIUrl() {
+  if (isCodespaces()) {
+    const codespaceName = process.env.CODESPACE_NAME;
+    const domain = process.env.GITHUB_CODESPACES_PORT_FORWARDING_DOMAIN;
+    if (isInstalledPackage()) {
+      return `https://${codespaceName}-3030.${domain}/ui`;
+    } else {
+      return `https://${codespaceName}-5173.${domain}`;
+    }
+  }
   if (isInstalledPackage()) {
     return "http://localhost:3030/ui";
   } else {
@@ -28,5 +40,6 @@ function getUIUrl() {
 export {
   getDaemonPath,
   getUIUrl,
+  isCodespaces,
   isInstalledPackage
 };

package/dist/daemon/index.js

@@ -733,6 +733,7 @@ import { homedir as homedir2 } from "os";
 import { join as join3 } from "path";
 import cors from "cors";
 import express from "express";
+import swagger from "feathers-swagger";
 import jwt from "jsonwebtoken";
 
 // src/services/board-comments.ts
@@ -3066,6 +3067,31 @@ async function main() {
   app.publish(() => {
     return app.channel("everybody");
   });
+  app.configure(
+    swagger({
+      openApiVersion: 3,
+      docsPath: "/docs",
+      docsJsonPath: "/docs.json",
+      ui: swagger.swaggerUI({ docsPath: "/docs" }),
+      specs: {
+        info: {
+          title: "Agor API",
+          description: "REST and WebSocket API for Agor agent orchestration platform",
+          version: DAEMON_VERSION
+        },
+        servers: [{ url: `http://localhost:${DAEMON_PORT}`, description: "Local daemon" }],
+        components: {
+          securitySchemes: {
+            BearerAuth: {
+              type: "http",
+              scheme: "bearer",
+              bearerFormat: "JWT"
+            }
+          }
+        }
+      }
+    })
+  );
   console.log(`\u{1F4E6} Connecting to database: ${DB_PATH}`);
   const dbFilePath = DB_PATH.startsWith("file:") ? DB_PATH.slice(5) : DB_PATH;
   const dbDir = dbFilePath.substring(0, dbFilePath.lastIndexOf("/"));
@@ -3101,7 +3127,28 @@ async function main() {
   app.use("/tasks", createTasksService(db));
   const messagesService = createMessagesService(db);
   app.use("/messages", messagesService, {
-    events: ["streaming:start", "streaming:chunk", "streaming:end", "streaming:error"]
+    events: ["streaming:start", "streaming:chunk", "streaming:end", "streaming:error"],
+    docs: {
+      description: "Conversation messages within AI agent sessions",
+      definitions: {
+        messages: {
+          type: "object",
+          properties: {
+            message_id: { type: "string", format: "uuid" },
+            session_id: { type: "string", format: "uuid" },
+            task_id: { type: "string", format: "uuid" },
+            type: {
+              type: "string",
+              enum: ["user", "assistant", "system", "tool_use", "tool_result"]
+            },
+            role: { type: "string" },
+            content: { type: "string" },
+            created_at: { type: "string", format: "date-time" }
+          }
+        }
+      }
+    }
+    // biome-ignore lint/suspicious/noExplicitAny: feathers-swagger docs option not typed in FeathersJS
   });
   app.use("/boards", createBoardsService(db));
   app.use("/board-objects", createBoardObjectsService(db));