agentsys 5.3.0 → 5.3.1

package/.kiro/steering/web-ctl.md

@@ -0,0 +1,106 @@
+---
+inclusion: manual
+name: "web-ctl"
+description: "Use when user asks to \"open a webpage\", \"browse website\", \"log into site\", \"scrape page\", \"interact with web\", \"web automation\", \"browser control\"."
+---
+
+# /web-ctl Command
+
+Browser automation for AI agents. Navigate websites, authenticate with human handoff, and interact with web pages.
+
+## Intent Routing
+
+Parse the user's request and route appropriately:
+
+### Simple Actions (Direct Skill Invocation)
+
+For single-step requests like "go to example.com" or "take a screenshot":
+
+1. Invoke the **web-browse** skill with session name and action
+2. Sessions auto-create on first run command if they don't exist
+
+### Auth Requests
+
+For "log into X" or "authenticate to Y":
+
+1. Create a session named after the service
+2. Invoke the **web-auth** skill
+
+### Multi-Step Flows
+
+For complex requests like "find information on a website" or "fill out a form":
+
+1. Delegate to the **web-session** agent via Task tool
+
+## Quick Reference
+
+```bash
+# Session lifecycle
+node /Users/avifen/.agentsys/plugins/web-ctl/scripts/web-ctl.js session start <name>
+node /Users/avifen/.agentsys/plugins/web-ctl/scripts/web-ctl.js session auth <name> --provider <provider>
+node /Users/avifen/.agentsys/plugins/web-ctl/scripts/web-ctl.js session auth <name> --url <url> [--verify-url <url>] [--verify-selector <sel>]
+node /Users/avifen/.agentsys/plugins/web-ctl/scripts/web-ctl.js session auth <name> --provider <slug> --providers-file <path>
+node /Users/avifen/.agentsys/plugins/web-ctl/scripts/web-ctl.js session providers
+node /Users/avifen/.agentsys/plugins/web-ctl/scripts/web-ctl.js session list
+node /Users/avifen/.agentsys/plugins/web-ctl/scripts/web-ctl.js session end <name>
+node /Users/avifen/.agentsys/plugins/web-ctl/scripts/web-ctl.js session verify <name> --url <url>
+
+# Browser actions
+node /Users/avifen/.agentsys/plugins/web-ctl/scripts/web-ctl.js run <session> goto <url> [--ensure-auth]
+node /Users/avifen/.agentsys/plugins/web-ctl/scripts/web-ctl.js run <session> snapshot
+node /Users/avifen/.agentsys/plugins/web-ctl/scripts/web-ctl.js run <session> click <selector>
+node /Users/avifen/.agentsys/plugins/web-ctl/scripts/web-ctl.js run <session> read <selector>
+node /Users/avifen/.agentsys/plugins/web-ctl/scripts/web-ctl.js run <session> screenshot
+
+# Snapshot control (apply to any action with snapshot output)
+node /Users/avifen/.agentsys/plugins/web-ctl/scripts/web-ctl.js run <session> snapshot --snapshot-depth 3
+node /Users/avifen/.agentsys/plugins/web-ctl/scripts/web-ctl.js run <session> goto <url> --snapshot-selector "css=nav"
+node /Users/avifen/.agentsys/plugins/web-ctl/scripts/web-ctl.js run <session> click <sel> --no-snapshot
+node /Users/avifen/.agentsys/plugins/web-ctl/scripts/web-ctl.js run <session> snapshot --snapshot-collapse
+node /Users/avifen/.agentsys/plugins/web-ctl/scripts/web-ctl.js run <session> snapshot --snapshot-compact
+node /Users/avifen/.agentsys/plugins/web-ctl/scripts/web-ctl.js run <session> snapshot --snapshot-text-only --snapshot-max-lines 50
+node /Users/avifen/.agentsys/plugins/web-ctl/scripts/web-ctl.js run <session> goto <url> --snapshot-full
+node /Users/avifen/.agentsys/plugins/web-ctl/scripts/web-ctl.js run <session> goto <url> --snapshot-collapse --snapshot-depth 4
+
+# Macros
+node /Users/avifen/.agentsys/plugins/web-ctl/scripts/web-ctl.js run <session> select-option <sel> <text>
+node /Users/avifen/.agentsys/plugins/web-ctl/scripts/web-ctl.js run <session> tab-switch <name>
+node /Users/avifen/.agentsys/plugins/web-ctl/scripts/web-ctl.js run <session> modal-dismiss [--accept]
+node /Users/avifen/.agentsys/plugins/web-ctl/scripts/web-ctl.js run <session> form-fill --fields '<json>' [--submit]
+node /Users/avifen/.agentsys/plugins/web-ctl/scripts/web-ctl.js run <session> search-select <sel> <query> --pick <text>
+node /Users/avifen/.agentsys/plugins/web-ctl/scripts/web-ctl.js run <session> date-pick <sel> --date <YYYY-MM-DD>
+node /Users/avifen/.agentsys/plugins/web-ctl/scripts/web-ctl.js run <session> file-upload <sel> <path>
+node /Users/avifen/.agentsys/plugins/web-ctl/scripts/web-ctl.js run <session> hover-reveal <sel> --click <target>
+node /Users/avifen/.agentsys/plugins/web-ctl/scripts/web-ctl.js run <session> scroll-to <sel>
+node /Users/avifen/.agentsys/plugins/web-ctl/scripts/web-ctl.js run <session> wait-toast [--dismiss]
+node /Users/avifen/.agentsys/plugins/web-ctl/scripts/web-ctl.js run <session> iframe-action <iframe> <action> [args]
+node /Users/avifen/.agentsys/plugins/web-ctl/scripts/web-ctl.js run <session> login --user <u> --pass <p>
+node /Users/avifen/.agentsys/plugins/web-ctl/scripts/web-ctl.js run <session> next-page
+node /Users/avifen/.agentsys/plugins/web-ctl/scripts/web-ctl.js run <session> paginate --selector <sel> [--max-pages N] [--max-items N]
+node /Users/avifen/.agentsys/plugins/web-ctl/scripts/web-ctl.js run <session> extract --selector <sel> [--fields f1,f2,...] [--max-items N] [--max-field-length N]
+node /Users/avifen/.agentsys/plugins/web-ctl/scripts/web-ctl.js run <session> extract --auto [--max-items N] [--max-field-length N]
+```
+
+## Examples
+
+User: "Open github.com and show me my profile"
+1. Start session "github"
+2. Auth if needed (web-auth skill)
+3. Navigate to github.com/profile
+4. Snapshot and report
+
+User: "Take a screenshot of example.com"
+1. Start session "quick"
+2. Goto example.com
+3. Screenshot
+4. End session
+
+User: "Log into Twitter"
+1. Start session "twitter"
+2. Auth with `--provider twitter` (auto-configures URL and success detection)
+3. Report success/failure
+
+User: "Log into GitHub"
+1. Start session "github"
+2. Auth with `--provider github`
+3. Report success/failure

package/CHANGELOG.md

@@ -7,6 +7,12 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [5.3.1] - 2026-03-02
+
+### Fixed
+
+- **Code block Task() transform for Kiro** - Phase 9 reviewer Task() calls inside fenced JavaScript code blocks were not being transformed. Fixed with multiline-anchored fence regex that correctly handles backtick template literals inside code blocks.
+
 ## [5.3.0] - 2026-03-02
 
 ### Added

package/lib/adapter-transforms.js

@@ -484,6 +484,34 @@ function transformCommandForKiro(content, options) {
   content = content.replace(/(?:const|let|var)\s+\{?[^}=\n]+\}?\s*=\s*require\s*\([^)]+\);?/g, '');
   content = content.replace(/require\s*\(['"][^'"]+['"]\)/g, '');
 
+  // Transform code blocks containing Promise.all + Task() (parallel reviewer spawns).
+  // The bare Task() regex below can't reach inside fenced code blocks.
+  // Fence boundaries must be at line start (^```) to avoid matching backtick
+  // template literals inside the code as false fence endings.
+  content = content.replace(/^```(?:javascript|js)?\n([\s\S]*?)^```$/gm, (fullBlock, codeContent) => {
+    if (!codeContent.includes('Promise.all') || !codeContent.includes('Task(')) return fullBlock;
+    const taskMatches = [...codeContent.matchAll(/Task\s*\(\s*\{[\s\S]*?subagent_type:\s*['"](?:[^"':]+:)?([^'"]+)['"][\s\S]*?prompt:\s*`((?:[^`]|\$\{[^}]*\})*)`/gs)];
+    if (taskMatches.length < 2) return fullBlock;
+
+    const delegations = taskMatches.map(m => {
+      const agent = m[1];
+      const promptFirstLine = m[2].split('\n').find(l => l.trim()) || '';
+      return `Delegate to the \`${agent}\` subagent:\n> ${promptFirstLine.trim()}`;
+    });
+
+    let result = delegations.join('\n\n');
+
+    const hasReviewKeyword = delegations.some(d =>
+      /review|quality|security|performance|test|coverage/i.test(d)
+    );
+    if (delegations.length >= 4 && hasReviewKeyword) {
+      result = `**Review phase (Kiro - max 4 agents, fallback to 2 sequential):**\n\nTry delegating to these subagents (experimental parallel spawning):\n\n${result}\n\nIf parallel spawning is unavailable, run 2 combined reviewers sequentially:\n1. Delegate to the \`reviewer-quality-security\` subagent (code quality + security)\n2. Then delegate to the \`reviewer-perf-test\` subagent (performance + test coverage)\n\nAggregate all findings from whichever execution path succeeded.`;
+    }
+
+    return result;
+  });
+
+  // Transform bare Task() calls outside code blocks
   content = content.replace(/await\s+Task\s*\(\s*\{[^{}]*(?:\{[^{}]*\}[^{}]*)*\}\s*\);?/g, (match) => {
     const agentMatch = match.match(/subagent_type:\s*["'](?:[^"':]+:)?([^"']+)["']/);
     const promptMatch = match.match(/prompt:\s*[`"']([\s\S]*?)[`"']/);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentsys",
-  "version": "5.3.0",
+  "version": "5.3.1",
   "description": "A modular runtime and orchestration system for AI agents - works with Claude Code, OpenCode, and Codex CLI",
   "main": "lib/platform/detect-platform.js",
   "type": "commonjs",

package/site/content.json

@@ -5,7 +5,7 @@
     "url": "https://agent-sh.github.io/agentsys",
     "repo": "https://github.com/agent-sh/agentsys",
     "npm": "https://www.npmjs.com/package/agentsys",
-    "version": "5.3.0",
+    "version": "5.3.1",
     "author": "Avi Fenesh",
     "author_url": "https://github.com/avifenesh"
   },