@openagents-org/agent-launcher 0.2.131 → 0.2.133

package/src/adapters/codex.js

@@ -168,7 +168,7 @@ class CodexAdapter extends BaseAdapter {
   }
 
   _buildSystemContext(channelName) {
-    return buildOpenclawSystemPrompt({
+    const base = buildOpenclawSystemPrompt({
       agentName: this.agentName,
       workspaceId: this.workspaceId,
       channelName,
@@ -177,6 +177,38 @@ class CodexAdapter extends BaseAdapter {
       mode: this._mode,
       disabledModules: this.disabledModules,
     });
+    const skillsSection = this._buildInstalledSkillsSection();
+    return skillsSection ? `${base}\n\n${skillsSection}` : base;
+  }
+
+  /**
+   * Codex has no native skills-directory discovery (unlike Claude Code), so
+   * we inject installed Skill Hub skills directly into its context. Each
+   * skill's SKILL.md lives at <workingDir>/.codex/skills/<id>/SKILL.md and
+   * Codex (running with cwd=workingDir, full file access) can read it.
+   */
+  _buildInstalledSkillsSection() {
+    let skills = [];
+    try {
+      const installer = require('../skill-installer');
+      skills = installer.listInstalledSkills({
+        agentType: this.agentType || 'codex',
+        workingDir: this.workingDir,
+      });
+    } catch {
+      return '';
+    }
+    if (!skills.length) return '';
+    const lines = skills.map((s) => {
+      const desc = s.description ? ` — ${s.description}` : '';
+      return `- **${s.name}** (\`${s.id}\`)${desc}\n  Read its instructions: \`cat ${s.skillMd}\``;
+    });
+    return (
+      '## Installed Skills\n' +
+      'You have the following skills installed. When a task matches a skill, ' +
+      'read its `SKILL.md` (via the `cat` command shown) and follow it:\n' +
+      lines.join('\n')
+    );
   }
 
   // ------------------------------------------------------------------
@@ -205,14 +237,17 @@ class CodexAdapter extends BaseAdapter {
     } catch {}
   }
 
-  async _onControlAction(action, _payload) {
+  async _onControlAction(action, payload) {
     if (action === 'stop') {
       for (const [channel, proc] of Object.entries(this._channelProcesses)) {
         await this._stopProcess(proc);
         delete this._channelProcesses[channel];
         try { await this.sendStatus(channel, 'Execution stopped by user'); } catch {}
       }
+      return;
     }
+    // Shared actions (status, routines, skill.install, skill.uninstall).
+    await super._onControlAction(action, payload);
   }
 
   // ------------------------------------------------------------------

package/src/adapters/workspace-prompt.js

@@ -136,6 +136,7 @@ function buildApiSkillsPrompt({ endpoint, workspaceId, token, agentName, channel
   const caps = [];
   if (!disabled.has('files')) caps.push('share and read files with other agents and users');
   if (!disabled.has('browser')) caps.push('browse websites in a shared browser');
+  if (!disabled.has('knowledge')) caps.push('create and access a shared knowledge base');
   caps.push('discover other agents in the workspace');
 
   sections.push(
@@ -292,7 +293,7 @@ function buildApiSkillsPrompt({ endpoint, workspaceId, token, agentName, channel
   }
 
   // To-Dos (planning)
-  if (!isPlan) {
+  if (!isPlan && !disabled.has('todos')) {
     sections.push(
       '\n### To-Do List (Planning)\n\n' +
       'Create or update your to-do list to track progress. The entire list ' +
@@ -315,7 +316,7 @@ function buildApiSkillsPrompt({ endpoint, workspaceId, token, agentName, channel
   }
 
   // Timers
-  if (!isPlan) {
+  if (!isPlan && !disabled.has('timers')) {
     sections.push(
       '\n### Timers\n\n' +
       'Set a timer that will send you a message after a delay, waking you up ' +
@@ -336,7 +337,7 @@ function buildApiSkillsPrompt({ endpoint, workspaceId, token, agentName, channel
   }
 
   // Routines (recurring scheduled tasks)
-  if (!isPlan) {
+  if (!isPlan && !disabled.has('routines')) {
     sections.push(
       '\n### Routines (Recurring Tasks)\n\n' +
       'Create a recurring routine that fires on a schedule. Each routine gets ' +
@@ -366,6 +367,52 @@ function buildApiSkillsPrompt({ endpoint, workspaceId, token, agentName, channel
     );
   }
 
+  // Notifications / Inbox
+  if (!isPlan && !disabled.has('notifications')) {
+    sections.push(
+      '\n### Notifications (Inbox)\n\n' +
+      'Send notifications to the workspace inbox. Notifications appear in a ' +
+      'dedicated panel separate from the chat stream. Use for task completions, ' +
+      'important findings, or anything that needs human attention.\n\n' +
+      '**Send a notification:**\n' +
+      `\`${curl} -s -X POST -H "${h}" -H "Content-Type: application/json" ` +
+      `${baseUrl}/v1/notifications -d '{"title":"Task Complete","message":"The analysis is ready.",` +
+      `"priority":"normal","channel":"${channelName}",` +
+      `"network":"${workspaceId}",` +
+      `"source":"openagents:${agentName}"}'\`\n\n` +
+      '**Priority values:** `low`, `normal`, `high`\n\n' +
+      '**List notifications:**\n' +
+      `\`${curl} -s -H "${h}" "${baseUrl}/v1/notifications?network=${workspaceId}"\`\n`
+    );
+  }
+
+  // Knowledge Base
+  if (!isPlan && !disabled.has('knowledge')) {
+    sections.push(
+      '\n### Knowledge Base\n\n' +
+      'The workspace has a shared knowledge base of markdown documents. ' +
+      'Use it to store and retrieve shared information like API docs, ' +
+      'design decisions, project conventions, and other reference material. ' +
+      'Knowledge entries are accessible to all agents via @knowledge:slug mentions.\n\n' +
+      '**Create a knowledge entry:**\n' +
+      `\`${curl} -s -X POST -H "${h}" -H "Content-Type: application/json" ` +
+      `${baseUrl}/v1/knowledge -d '{"title":"API Design Patterns","content":"# API Design Patterns\\n\\n...",` +
+      `"description":"Common API patterns used in this project",` +
+      `"network":"${workspaceId}",` +
+      `"source":"openagents:${agentName}"}'\`\n\n` +
+      '**List knowledge entries:**\n' +
+      `\`${curl} -s -H "${h}" "${baseUrl}/v1/knowledge?network=${workspaceId}"\`\n\n` +
+      '**Read a knowledge entry by slug:**\n' +
+      `\`${curl} -s -H "${h}" "${baseUrl}/v1/knowledge/by-slug/api-design-patterns?network=${workspaceId}"\`\n\n` +
+      '**Update a knowledge entry:**\n' +
+      `\`${curl} -s -X PUT -H "${h}" -H "Content-Type: application/json" ` +
+      `${baseUrl}/v1/knowledge/ENTRY_ID -d '{"title":"Updated Title","content":"# Updated\\n\\n...",` +
+      `"network":"${workspaceId}","source":"openagents:${agentName}"}'\`\n\n` +
+      '**Delete a knowledge entry:**\n' +
+      `\`${curl} -s -X DELETE -H "${h}" "${baseUrl}/v1/knowledge/ENTRY_ID?network=${workspaceId}"\`\n`
+    );
+  }
+
   // Discovery
   sections.push(
     '\n### Discover Agents\n\n' +
@@ -408,7 +455,10 @@ function buildClaudeSystemPrompt({ agentName, workspaceId, channelName, mode = '
     'Use workspace_get_agents to see other agents.\n' +
     'Use workspace_put_todos to track your progress. ALWAYS create a to-do list when given multiple tasks or multi-step work.\n' +
     'Use workspace_create_timer to set a reminder that wakes you up later.\n' +
-    'Use workspace_create_routine to set up recurring scheduled tasks (e.g. daily reviews).\n'
+    'Use workspace_create_routine to set up recurring scheduled tasks (e.g. daily reviews).\n' +
+    'Use workspace_send_notification to send a notification to the workspace inbox when you complete a task or have important results.\n' +
+    'Use workspace_write_knowledge to create or update shared knowledge base entries that persist across conversations.\n' +
+    'Use workspace_read_knowledge to read knowledge entries by ID or slug (from @knowledge:slug mentions).\n'
   );
   parts.push(buildBrowserDirective(browserEnabled));
   parts.push(buildCollaborationPrompt());

package/src/cli.js

@@ -128,6 +128,16 @@ async function cmdCreate(connector, flags, positional) {
     // Signal daemon to pick up the new agent
     try { connector.sendDaemonCommand('reload'); } catch {}
 
+    // Newly created agents are local-only until connected to a workspace.
+    // Without a workspace connection they will not appear in the Workspace Dashboard.
+    const created = connector.config.getAgent(name);
+    if (created && !created.network) {
+      print('');
+      print(`Note: '${name}' is local-only and will not appear in the Workspace Dashboard.`);
+      print(`To make it visible, connect it to a workspace:`);
+      print(`  agn connect ${name} <workspace-token>`);
+    }
+
     if (!connector.isInstalled(type)) {
       if (!flags.install) {
         print(`Runtime '${type}' is not installed. Run: agn install ${type}`);
@@ -278,9 +288,30 @@ async function cmdRuntimes(connector) {
 
 async function cmdConnect(connector, flags, positional) {
   const name = positional[0];
-  const token = positional[1] || flags.token;
-  if (!name || !token) {
+  // Token resolution order: positional arg / --token flag, then env vars.
+  // OPENAGENTS_WORKSPACE_TOKEN is preferred; OA_WORKSPACE_TOKEN is supported
+  // for compatibility with the existing mcp-server env var.
+  const token = positional[1]
+    || flags.token
+    || process.env.OPENAGENTS_WORKSPACE_TOKEN
+    || process.env.OA_WORKSPACE_TOKEN;
+
+  if (!name) {
     print('Usage: agn connect <agent-name> <token>');
+    process.exitCode = 1;
+    return;
+  }
+
+  if (!token) {
+    // No token supplied and none in the environment. Never prompt — keep
+    // CI / non-interactive environments from hanging. Print a helpful error
+    // explaining why the agent stays invisible and how to fix it.
+    print(`Error: no workspace token provided for '${name}'.`);
+    print(`Without a token, '${name}' stays local-only and will not appear in the Workspace Dashboard.`);
+    print('Provide a token in one of these ways:');
+    print(`  agn connect ${name} <workspace-token>`);
+    print(`  OPENAGENTS_WORKSPACE_TOKEN=<workspace-token> agn connect ${name}`);
+    process.exitCode = 1;
     return;
   }
 
@@ -502,6 +533,89 @@ async function cmdToolMode(connector, _flags, positional) {
   }
 }
 
+async function cmdSkills(connector, _flags, positional) {
+  const { SKILL_CATALOG, getSkillDefaults } = require('./skill-catalog');
+  const toggleable = SKILL_CATALOG.filter(s => s.toggleable);
+  const first = positional[0];
+  const second = positional[1];
+  const third = positional[2];
+
+  // agn skills → list skills for all agents
+  if (!first) {
+    const agents = connector.config.getAgents();
+    if (agents.length === 0) { print('No agents configured'); return; }
+    for (const a of agents) {
+      const defaults = getSkillDefaults();
+      const skills = a.skills || {};
+      const parts = toggleable.map(s => {
+        const enabled = skills[s.id] !== undefined ? skills[s.id] : defaults[s.id];
+        return `${enabled ? '+' : '-'}${s.id}`;
+      });
+      print(`  ${a.name}: ${parts.join(' ')}`);
+    }
+    print('\nUsage: agn skills <agent> [enable|disable <skill>]');
+    print('Available skills: ' + toggleable.map(s => s.id).join(', '));
+    return;
+  }
+
+  // agn skills catalog → show full catalog
+  if (first === 'catalog') {
+    print('Skill Hub — Available Skills:\n');
+    for (const s of SKILL_CATALOG) {
+      const tag = s.toggleable ? (s.defaultEnabled ? '[on]' : '[off]') : '[always]';
+      print(`  ${s.id.padEnd(16)} ${tag.padEnd(10)} ${s.name}`);
+      print(`  ${''.padEnd(16)} ${''.padEnd(10)} ${s.description}`);
+      print('');
+    }
+    return;
+  }
+
+  const agent = connector.config.getAgent(first);
+  if (!agent) { print(`Agent '${first}' not found`); process.exitCode = 1; return; }
+
+  // agn skills <agent> → show agent's skills
+  if (!second) {
+    const defaults = getSkillDefaults();
+    const skills = agent.skills || {};
+    print(`Skills for ${first}:\n`);
+    for (const s of toggleable) {
+      const enabled = skills[s.id] !== undefined ? skills[s.id] : defaults[s.id];
+      const marker = enabled ? '  ✓' : '  ✗';
+      print(`${marker} ${s.id.padEnd(14)} ${s.name} — ${s.description}`);
+    }
+    print('\nUsage: agn skills <agent> enable|disable <skill>');
+    return;
+  }
+
+  // agn skills <agent> enable|disable <skill>
+  if (second !== 'enable' && second !== 'disable') {
+    print(`Unknown action: ${second}. Use 'enable' or 'disable'.`);
+    process.exitCode = 1;
+    return;
+  }
+  if (!third) {
+    print(`Usage: agn skills ${first} ${second} <skill>`);
+    print('Available skills: ' + toggleable.map(s => s.id).join(', '));
+    process.exitCode = 1;
+    return;
+  }
+
+  const skillDef = toggleable.find(s => s.id === third);
+  if (!skillDef) {
+    print(`Unknown skill: ${third}`);
+    print('Available skills: ' + toggleable.map(s => s.id).join(', '));
+    process.exitCode = 1;
+    return;
+  }
+
+  const current = agent.skills || {};
+  const updated = { ...current, [third]: second === 'enable' };
+  connector.config.updateAgent(first, { skills: updated });
+  try { connector.sendDaemonCommand('reload'); } catch {}
+  const verb = second === 'enable' ? 'Enabled' : 'Disabled';
+  print(`${verb} '${skillDef.name}' for ${first}`);
+}
+
 async function cmdTestLLM(connector, _flags, positional) {
   const type = positional[0];
   if (!type) { print('Usage: agn test-llm <type>'); return; }
@@ -566,6 +680,7 @@ Commands:
   connect <agent> <token>     Connect agent to workspace
   disconnect <agent>          Disconnect agent from workspace
   env <type> [--set K=V]      View/set env vars for agent type
+  skills [agent] [action]     Manage agent skills (enable/disable)
   tool-mode [agent] [mode]    View/set tool mode (mcp or skills)
   autostart [--disable]       Enable/disable auto-start on login
   test-llm <type>             Test LLM connection
@@ -652,6 +767,7 @@ async function main() {
     autostart: () => cmdAutostart(connector, flags),
     workspace: () => cmdWorkspace(connector, flags, positional),
     env: () => cmdEnv(connector, flags, positional),
+    skills: () => cmdSkills(connector, flags, positional),
     'tool-mode': () => cmdToolMode(connector, flags, positional),
     'test-llm': () => cmdTestLLM(connector, flags, positional),
     update: () => cmdUpdate(),

package/src/daemon.js

@@ -58,12 +58,20 @@ class Daemon {
     // Write PID file
     this._writePid();
 
-    // Periodic status + command check
+    // Periodic status (heavy: JSON serialize + write) every 5s.
     this._statusInterval = setInterval(() => {
       this._writeStatus();
-      this._processCommands();
     }, 5000);
 
+    // Command file poll (cheap: existsSync on a tiny file) every 200ms so
+    // start/stop/restart from the launcher feels responsive. With a 5s
+    // combined interval, users saw up to 5s before the daemon even noticed
+    // a Stop click — this was especially painful on Windows where there's
+    // no SIGHUP shortcut and Stop landed near the end of a tick.
+    this._cmdInterval = setInterval(() => {
+      this._processCommands();
+    }, 200);
+
     // Watch config file for hot-reload
     this._watchConfig();
 
@@ -429,6 +437,7 @@ class Daemon {
 
   async _adapterLoop(name, agentCfg, info, network) {
     const { createAdapter } = require('./adapters');
+    const { skillsToDisabledModules } = require('./skill-catalog');
     const agentType = agentCfg.type || 'openclaw';
     const endpoint = network.endpoint || 'https://workspace-endpoint.openagents.org';
 
@@ -442,7 +451,7 @@ class Daemon {
         endpoint,
         agentType,
         openclawAgentId: agentCfg.openclaw_agent_id || 'main',
-        disabledModules: new Set(),
+        disabledModules: skillsToDisabledModules(agentCfg.skills),
         agentEnv: this._buildAgentEnv(agentCfg),
         workingDir: agentCfg.path || undefined,
         toolMode: agentCfg.tool_mode || 'skills',

package/src/index.js

@@ -126,6 +126,17 @@ class AgentConnector {
     return { success: true };
   }
 
+  /**
+   * Delete the entire type-level env file (~/.openagents/env/<type>.env).
+   * Used by the launcher's "wipe saved credentials" path on uninstall so
+   * sensitive values (API keys) don't survive a reinstall as surprise
+   * pre-filled defaults in the setup wizard.
+   */
+  deleteAgentEnv(agentType) {
+    this.env.delete(agentType);
+    return { success: true };
+  }
+
   saveAgentInstanceEnv(agentName, env) {
     const agent = this.config.getAgent(agentName);
     if (!agent) throw new Error(`Agent '${agentName}' not found`);

package/src/installer.js

@@ -4,7 +4,7 @@ const fs = require('fs');
 const os = require('os');
 const path = require('path');
 const { execSync, exec } = require('child_process');
-const { whichBinary, getEnhancedEnv, getRuntimePrefix } = require('./paths');
+const { whichBinary, getEnhancedEnv, getRuntimePrefix, clearBinaryLookupCache } = require('./paths');
 const { EnvManager } = require('./env');
 
 const STATUS_CACHE_TTL_MS = 10000;
@@ -90,7 +90,15 @@ class Installer {
     // Fallback: check if binary exists on PATH (system install)
     const binaryPath = this._whichBinary(agentType);
     if (!binaryPath) {
-      try { fs.unlinkSync(path.join(this.markersDir, agentType)); } catch {}
+      // If a successful install wrote a marker, surface installed=true even
+      // when binary detection can't (yet) see the freshly-installed CLI —
+      // e.g. PATH caches not yet picking up a brand-new ~/.cursor/bin. The
+      // marker is the ground truth of what we just installed; UI was
+      // silently showing "not installed" right after a successful install
+      // because earlier code aggressively deleted the marker here.
+      if (this._hasMarker(agentType)) {
+        return { installed: true, managed: true, location: 'marker' };
+      }
       return { installed: false, managed: false, location: null };
     }
 
@@ -418,6 +426,8 @@ class Installer {
       cmd = rawCmd; // pip commands stay as-is
     }
 
+    cmd = this._wrapForWindowsShell(cmd);
+
     if (onData) onData(`$ ${cmd}\n\n`);
 
     const env = this._buildShellEnv();
@@ -579,6 +589,8 @@ class Installer {
       cmd = this._resolveNpmCommand(args);
     }
 
+    cmd = this._wrapForWindowsShell(cmd);
+
     if (onData) onData(`$ ${cmd}\n\n`);
 
     const env = this._buildShellEnv();
@@ -708,6 +720,12 @@ class Installer {
       fs.mkdirSync(this.markersDir, { recursive: true });
       fs.writeFileSync(path.join(this.markersDir, agentType), '', 'utf-8');
     } catch {}
+
+    // Drop the 30s PATH/whichBinary caches so the very next getInstallInfo
+    // sees the freshly-created bin dir (e.g. ~/.cursor/bin) instead of the
+    // pre-install snapshot. Without this, install completes but UI keeps
+    // showing "not installed" until the cache expires.
+    try { clearBinaryLookupCache(); } catch {}
   }
 
   _markUninstalled(agentType) {
@@ -727,6 +745,9 @@ class Installer {
       const markerFile = path.join(this.markersDir, agentType);
       if (fs.existsSync(markerFile)) fs.unlinkSync(markerFile);
     } catch {}
+
+    // Symmetric with _markInstalled: invalidate so detection re-runs cleanly.
+    try { clearBinaryLookupCache(); } catch {}
   }
 
   // -- Shell env + exec --
@@ -1040,6 +1061,24 @@ class Installer {
     return `${npmBin} ${args}`;
   }
 
+  /**
+   * Wrap a command in `powershell.exe -Command "..."` when (a) we're on Windows
+   * and (b) the command uses PowerShell-only tokens like `irm`, `iex`,
+   * `Invoke-RestMethod`, etc. The launcher's install shell is cmd.exe, which
+   * doesn't recognize these aliases — without wrapping, e.g. Cursor's
+   * `irm '…' | iex` exits 255. Skips commands already prefixed with
+   * `powershell`/`powershell.exe` so we don't double-wrap.
+   */
+  _wrapForWindowsShell(cmd) {
+    if (!cmd || process.platform !== 'win32') return cmd;
+    const trimmed = cmd.trimStart();
+    if (/^("[^"]*\\)?powershell(\.exe)?["']?\s/i.test(trimmed)) return cmd;
+    const psTokens = /\b(irm|iwr|iex|Invoke-RestMethod|Invoke-WebRequest|Invoke-Expression|Expand-Archive|Get-[A-Z]\w*|Set-[A-Z]\w*)\b/;
+    if (!psTokens.test(cmd)) return cmd;
+    const escaped = cmd.replace(/"/g, '\\"');
+    return `powershell.exe -NoProfile -ExecutionPolicy Bypass -Command "${escaped}"`;
+  }
+
   _execShell(cmd, timeoutMs = 300000) {
     return new Promise((resolve, reject) => {
       const env = this._buildShellEnv();
@@ -1049,7 +1088,8 @@ class Installer {
         shell = env.ComSpec || 'C:\\Windows\\System32\\cmd.exe';
       }
 
-      exec(cmd, {
+      const finalCmd = this._wrapForWindowsShell(cmd);
+      exec(finalCmd, {
         encoding: 'utf-8',
         timeout: timeoutMs,
         shell,