@kendoo.agentdesk/agentdesk 0.3.1 → 0.4.2

package/README.md

@@ -42,17 +42,17 @@ This detects your project, asks which task tracker you use (Linear, Jira, GitHub
 
 ### 4. Run a team session
 
-With a task tracker:
+Work on an existing task:
 
 ```bash
 agentdesk team KEN-517
-agentdesk team BUG-42 -d "Fix the checkout total calculation"
 ```
 
-Without a tracker — pass requirements directly:
+Or just describe what you want — a task is created automatically:
 
 ```bash
-agentdesk team add-auth -d "Add Google OAuth to the login page"
+agentdesk team -d "Fix the checkout total calculation"
+agentdesk team -d "Add Google OAuth to the login page"
 ```
 
 Open [agentdesk.live](https://agentdesk.live) to watch the session live.
@@ -102,8 +102,8 @@ AgentDesk also auto-discovers agents from `.claude/agents/`, `.claude/commands/`
 agentdesk login                        Sign in to AgentDesk
 agentdesk logout                       Sign out and remove credentials
 agentdesk init                         Set up project and configure tracker
-agentdesk team <TASK-ID>               Run a team session on a task
-agentdesk team <TASK-ID> -d "..."      Run with a task description
+agentdesk team <TASK-ID>               Run a team session on an existing task
+agentdesk team -d "..."                Describe what you want — task created automatically
 ```
 
 ### Options

package/bin/agentdesk.mjs

@@ -2,6 +2,27 @@
 
 // AgentDesk CLI — AI team orchestrator
 
+import { readFileSync } from "fs";
+import { fileURLToPath } from "url";
+import { dirname, join } from "path";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const pkg = JSON.parse(readFileSync(join(__dirname, "../package.json"), "utf-8"));
+
+// Non-blocking update check — runs in background, never delays startup
+(async () => {
+  try {
+    const res = await fetch(`https://registry.npmjs.org/${pkg.name}/latest`, { signal: AbortSignal.timeout(3000) });
+    if (!res.ok) return;
+    const { version } = await res.json();
+    if (version !== pkg.version) {
+      console.log(`\n  Update available: ${pkg.version} → ${version}`);
+      console.log(`  Run: npm i -g ${pkg.name}\n`);
+    }
+  } catch {}
+})();
+
 const args = process.argv.slice(2);
 const command = args[0];
 
@@ -18,22 +39,25 @@ if (!command || command === "help" || command === "--help") {
     agentdesk login                        Sign in to AgentDesk
     agentdesk logout                       Sign out and remove credentials
     agentdesk init                         Set up project and configure tracker
-    agentdesk team <TASK-ID>               Run a team session on a task
-    agentdesk team <TASK-ID> -d "..."      Run with a task description
+    agentdesk team <TASK-ID>               Run a team session on an existing task
+    agentdesk team -d "..."                Create a task and run a session
 
   Options:
     --description, -d    Task description or requirements
     --cwd                Working directory (defaults to current)
 
-  Task trackers:
-    agentdesk init configures your tracker (Linear, Jira, GitHub Issues).
-    Without a tracker, pass requirements directly:
-      agentdesk team my-feature -d "Add dark mode support"
+  How it works:
+    With a tracker (Linear, Jira, GitHub Issues):
+      agentdesk team KEN-517               Work on an existing task
+      agentdesk team -d "Fix login bug"    Create a new task, then work on it
+
+    Without a tracker:
+      agentdesk team -d "Add dark mode"    Describe what you want
 
   Examples:
     agentdesk team KEN-517
-    agentdesk team BUG-42 -d "Fix the checkout total calculation"
-    agentdesk team add-auth -d "Add Google OAuth to the login page"
+    agentdesk team -d "Fix the checkout total calculation"
+    agentdesk team -d "Add Google OAuth to the login page"
 
   Dashboard: https://agentdesk.live
 `);
@@ -56,23 +80,28 @@ else if (command === "init") {
 }
 
 else if (command === "team") {
-  const taskId = args[1];
-  if (!taskId) {
-    console.error("Usage: agentdesk team <TASK-ID>");
-    process.exit(1);
-  }
-
-  // Parse options
+  // Parse options first to find -d and --cwd
   let description = "";
   let cwd = process.cwd();
-  for (let i = 2; i < args.length; i++) {
-    if ((args[i] === "--description" || args[i] === "-d") && args[i + 1]) {
-      description = args[++i];
-    } else if (args[i] === "--cwd" && args[i + 1]) {
-      cwd = args[++i];
+  let taskId = null;
+  const remaining = args.slice(1);
+
+  for (let i = 0; i < remaining.length; i++) {
+    if ((remaining[i] === "--description" || remaining[i] === "-d") && remaining[i + 1]) {
+      description = remaining[++i];
+    } else if (remaining[i] === "--cwd" && remaining[i + 1]) {
+      cwd = remaining[++i];
+    } else if (!taskId && !remaining[i].startsWith("-")) {
+      taskId = remaining[i];
     }
   }
 
+  if (!taskId && !description) {
+    console.error("Usage: agentdesk team <TASK-ID>");
+    console.error("   or: agentdesk team -d \"description\"");
+    process.exit(1);
+  }
+
   const { runTeam } = await import("../cli/team.mjs");
   const code = await runTeam(taskId, { description, cwd });
   process.exit(code);

package/cli/team.mjs

@@ -36,19 +36,44 @@ export async function runTeam(taskId, opts = {}) {
   // Detect project and load config
   const project = detectProject(cwd);
   const config = loadConfig(cwd);
-  console.log(`Project: ${project.name || "unknown"} (${project.label})`);
-  console.log(`Task: ${taskId}`);
-
-  // Determine tracker and build task link
   const tracker = config.tracker || (project.hasLinear ? "linear" : null);
+
+  // If no task ID, handle based on tracker
+  let createTask = false;
+  if (!taskId) {
+    if (tracker) {
+      // Tracker configured but no task ID — agents will create a task
+      createTask = true;
+      taskId = `new-${Date.now().toString(36)}`;
+      console.log(`Project: ${project.name || "unknown"} (${project.label})`);
+      console.log(`Mode: Create new ${tracker} task from description`);
+    } else {
+      // No tracker — generate a label from description
+      taskId = description
+        .toLowerCase()
+        .replace(/[^a-z0-9\s-]/g, "")
+        .trim()
+        .replace(/\s+/g, "-")
+        .slice(0, 40) || `task-${Date.now().toString(36)}`;
+      console.log(`Project: ${project.name || "unknown"} (${project.label})`);
+      console.log(`Task: ${taskId}`);
+    }
+  } else {
+    console.log(`Project: ${project.name || "unknown"} (${project.label})`);
+    console.log(`Task: ${taskId}`);
+  }
+
+  // Build task link (only for existing tasks with a tracker)
   let taskLink = null;
-  if (tracker === "linear" && config.linear?.workspace) {
-    taskLink = `https://linear.app/${config.linear.workspace}/issue/${taskId}`;
-  } else if (tracker === "jira" && config.jira?.baseUrl) {
-    taskLink = `${config.jira.baseUrl}/browse/${taskId}`;
-  } else if (tracker === "github") {
-    const repo = config.github?.repo || "";
-    if (repo) taskLink = `https://github.com/${repo}/issues/${taskId}`;
+  if (!createTask) {
+    if (tracker === "linear" && config.linear?.workspace) {
+      taskLink = `https://linear.app/${config.linear.workspace}/issue/${taskId}`;
+    } else if (tracker === "jira" && config.jira?.baseUrl) {
+      taskLink = `${config.jira.baseUrl}/browse/${taskId}`;
+    } else if (tracker === "github") {
+      const repo = config.github?.repo || "";
+      if (repo) taskLink = `https://github.com/${repo}/issues/${taskId}`;
+    }
   }
   if (tracker) console.log(`Tracker: ${tracker}`);
   if (taskLink) console.log(`Task: ${taskLink}`);
@@ -68,6 +93,20 @@ export async function runTeam(taskId, opts = {}) {
     prompt = prompt.replace(/\{\{#TASK_DESCRIPTION\}\}[\s\S]*?\{\{\/TASK_DESCRIPTION\}\}/g, "");
   }
 
+  // Create task instruction — when -d is used without a task ID and a tracker is configured
+  if (createTask && description) {
+    let createInstr = "\n\n## CREATE TASK\n\nNo task ID was provided. Before starting work, Jane MUST create a new task in the tracker:\n\n";
+    if (tracker === "linear") {
+      createInstr += `Create a Linear issue using the GraphQL API:\n- Endpoint: https://api.linear.app/graphql\n- Auth: Authorization: $LINEAR_API_KEY\n- Set the title based on the description below\n- After creation, use the returned identifier (e.g., KEN-530) as the task ID for the rest of the session\n`;
+    } else if (tracker === "jira") {
+      createInstr += `Create a Jira issue:\n- Endpoint: ${config.jira?.baseUrl || ""}/rest/api/3/issue\n- Auth: Basic auth with $JIRA_EMAIL and $JIRA_API_TOKEN\n- Set the summary based on the description below\n- After creation, use the returned key (e.g., PROJ-42) as the task ID for the rest of the session\n`;
+    } else if (tracker === "github") {
+      createInstr += `Create a GitHub issue:\n- Run: gh issue create --title "..." --body "..."\n- After creation, use the returned issue number as the task ID for the rest of the session\n`;
+    }
+    createInstr += `\nTask description: ${description}\n`;
+    prompt += createInstr;
+  }
+
   // Tracker integration — enable the matching section, strip the rest
   const trackers = ["LINEAR", "JIRA", "GITHUB"];
   for (const t of trackers) {
@@ -100,8 +139,7 @@ export async function runTeam(taskId, opts = {}) {
   const projectEnv = loadDotEnv(cwd);
   const apiKey = projectEnv.AGENTDESK_API_KEY || process.env.AGENTDESK_API_KEY || getStoredApiKey() || null;
   const agentdeskServer = process.env.AGENTDESK_SERVER || "https://agentdesk.live";
-  const baseUrl = process.env.AGENTDESK_URL || "wss://agentdesk.live/ws/agent";
-  const AGENTDESK_URL = apiKey ? `${baseUrl}?api_key=${apiKey}` : baseUrl;
+  const AGENTDESK_URL = process.env.AGENTDESK_URL || "wss://agentdesk.live/ws/agent";
   const sessionId = `${taskId}-${randomUUID().slice(0, 8)}`;
   const inboxUrl = `${agentdeskServer}/api/sessions/${sessionId}/inbox`;
 
@@ -138,33 +176,40 @@ export async function runTeam(taskId, opts = {}) {
   try {
     vizWs = new WebSocket(AGENTDESK_URL);
     vizWs.on("open", () => {
-      vizConnected = true;
-      console.log("AgentDesk: connected");
-      vizSend({
-        type: "session:start",
-        taskId,
-        taskLink,
-        title: description || taskId,
-        project: project.name || null,
-        sessionNumber: 1,
-        agents: ["Jane", "Dennis", "Bart", "Vera", "Sam", "Luna", "Mark"],
-      });
-      while (vizQueue.length > 0 && vizWs.readyState === WebSocket.OPEN) {
-        vizWs.send(vizQueue.shift());
+      // Authenticate via first message (proxy-safe — query params can be stripped)
+      if (apiKey) {
+        vizWs.send(JSON.stringify({ type: "auth", apiKey }));
+      }
+    });
+    vizWs.on("message", (raw) => {
+      let msg;
+      try { msg = JSON.parse(raw.toString()); } catch { return; }
+      if (msg.type === "auth:ok") {
+        vizConnected = true;
+        console.log("AgentDesk: connected");
+        vizSend({
+          type: "session:start",
+          taskId,
+          taskLink,
+          title: description || taskId,
+          project: project.name || null,
+          sessionNumber: 1,
+          agents: ["Jane", "Dennis", "Bart", "Vera", "Sam", "Luna", "Mark"],
+        });
+        while (vizQueue.length > 0 && vizWs.readyState === WebSocket.OPEN) {
+          vizWs.send(vizQueue.shift());
+        }
+      } else if (msg.type === "auth:error") {
+        console.log("AgentDesk: authentication failed — run 'agentdesk login'");
+        vizConnected = false;
       }
     });
     vizWs.on("error", () => { vizConnected = false; });
     vizWs.on("close", (code) => {
       vizConnected = false;
-      if (code === 1006 && !vizConnected) {
-        console.log("AgentDesk: not connected — run 'agentdesk login' to authenticate");
-      }
-    });
-    vizWs.on("unexpected-response", (_req, res) => {
-      if (res.statusCode === 401) {
+      if (code === 4001) {
         console.log("AgentDesk: authentication required — run 'agentdesk login'");
       }
-      vizConnected = false;
     });
   } catch {
     // AgentDesk not running

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kendoo.agentdesk/agentdesk",
-  "version": "0.3.1",
+  "version": "0.4.2",
   "description": "AI team orchestrator for Claude Code — run collaborative agent sessions from your terminal",
   "type": "module",
   "bin": {