Skip to content

Commit

Permalink
feat: computer use tool
Browse files Browse the repository at this point in the history
  • Loading branch information
veasion committed Dec 14, 2024
1 parent 89f158a commit 3def826
Show file tree
Hide file tree
Showing 11 changed files with 523 additions and 65 deletions.
1 change: 0 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,5 +7,4 @@ Eko Keeps Operating - Empowering language to transform human words into action -
npm install
npm run build
```
6 changes: 5 additions & 1 deletion public/manifest.json
Original file line number Diff line number Diff line change
Expand Up @@ -7,8 +7,12 @@
"type": "module",
"service_worker": "js/background.js"
},
"icons": {
"16": "icon.png",
"48": "icon.png",
"128": "icon.png"
},
"action": {
"default_icon": "icon.png",
"default_popup": "popup.html"
},
"options_ui": {
Expand Down
295 changes: 295 additions & 0 deletions src/background/tools/computer_use.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,295 @@
import { Tool, InputSchema } from "../../types/action.types";
import * as utils from "../utils";

/**
* Computer Use
*/
export class ComputerUse implements Tool {
name: string;
description: string;
input_schema: InputSchema;
windowId?: number;
tabId?: number;

constructor(size: [number, number]) {
this.name = "computer_use";
this.description = `Use a mouse and keyboard to interact with a computer, and take screenshots.
* This is a browser GUI interface where you do not have access to the address bar or bookmarks. You must operate the browser using inputs like screenshots, mouse, keyboard, etc.
* Some operations may take time to process, so you may need to wait and take successive screenshots to see the results of your actions. E.g. if you clicked submit button, but it didn't work, try taking another screenshot.
* The screen's resolution is ${size[0]}x${size[1]}.
* Whenever you intend to move the cursor to click on an element, you should consult a screenshot to determine the coordinates of the element before moving the cursor.
* If you tried clicking on a button or link but it failed to load, even after waiting, try adjusting your cursor position so that the tip of the cursor visually falls on the element that you want to click.
* Make sure to click any buttons, links, icons, etc with the cursor tip in the center of the element.`;
this.input_schema = {
type: "object",
properties: {
action: {
type: "string",
description: `The action to perform. The available actions are:
* \`key\`: Press a key or key-combination on the keyboard.
- This supports pyautogui hotkey syntax.
- Multiple keys are combined using the "+" symbol.
- Examples: "a", "enter", "ctrl+s", "command+shift+a", "num0".
* \`type\`: Type a string of text on the keyboard.
* \`cursor_position\`: Get the current (x, y) pixel coordinate of the cursor on the screen.
* \`mouse_move\`: Move the cursor to a specified (x, y) pixel coordinate on the screen.
* \`left_click\`: Click the left mouse button.
* \`left_click_drag\`: Click and drag the cursor to a specified (x, y) pixel coordinate on the screen.
* \`right_click\`: Click the right mouse button.
* \`double_click\`: Double-click the left mouse button.
* \`screenshot\`: Take a screenshot of the screen.
* \`scroll\`: Performs a scroll of the mouse scroll wheel, The coordinate parameter is ineffective, each time a scroll operation is performed.`,
enum: [
"key",
"type",
"mouse_move",
"left_click",
"left_click_drag",
"right_click",
"double_click",
"screenshot",
"cursor_position",
"scroll",
],
},
coordinate: {
type: "array",
description:
"(x, y): The x (pixels from the left edge) and y (pixels from the top edge) coordinates to move the mouse to.",
},
text: {
type: "string",
description: "Required only by `action=type` and `action=key`",
},
},
required: ["action"],
};
}

/**
* computer
*
* @param {*} params { action: 'mouse_move', coordinate: [100, 200] }
* @returns { success: true, coordinate?: [], image?: { type: 'base64', media_type: 'image/jpeg', data: '/9j...' } }
*/
async execute(params: unknown): Promise<unknown> {
if (
typeof params !== "object" ||
params === null ||
!("action" in params)
) {
throw new Error(
'Invalid parameters. Expected an object with a "action" property.'
);
}
let { action, coordinate, text } = params as any;
let tabId = await this.getTabId();
let result;
switch (action as string) {
case "key":
result = await key(tabId, text, coordinate);
break;
case "type":
result = await type(tabId, text, coordinate);
break;
case "mouse_move":
result = await mouse_move(tabId, coordinate);
break;
case "left_click":
result = await left_click(tabId, coordinate);
break;
case "left_click_drag":
result = await left_click_drag(tabId, coordinate);
break;
case "right_click":
result = await right_click(tabId, coordinate);
break;
case "double_click":
result = await double_click(tabId, coordinate);
break;
case "screenshot":
result = await screenshot(this.windowId);
break;
case "cursor_position":
result = await cursor_position(tabId);
break;
case "scroll":
result = await scroll(tabId, coordinate);
break;
default:
throw Error(
`Invalid parameters. The "${action}" value is not included in the "action" enumeration.`
);
}
return { success: true, ...result };
}

async getTabId(): Promise<number> {
let tabId = this.tabId;
if (!tabId) {
tabId = await utils.getCurrentTabId();
}
return tabId as number;
}
}

export async function key(
tabId: number,
key: string,
coordinate?: [number, number]
) {
if (!coordinate) {
coordinate = (await cursor_position(tabId)).coordinate;
}
await mouse_move(tabId, coordinate);
let mapping: { [key: string]: string } = {
space: " ",
escape: "esc",
return: "enter",
page_up: "pageup",
page_down: "pagedown",
back_space: "backspace",
};
let keys = key.replace(/\s+/g, " ").split(" ");
for (let i = 0; i < keys.length; i++) {
let _key = keys[i];
if (_key.indexOf("+") > -1) {
let mapped_keys = _key.split("+").map((k) => mapping[k] || k);
await runComputeruseCommand("hotkey", mapped_keys);
} else {
let mapped_key = mapping[_key] || _key;
await runComputeruseCommand("press", [mapped_key]);
}
await utils.sleep(100);
}
}

export async function type(
tabId: number,
text: string,
coordinate?: [number, number]
) {
if (coordinate) {
await mouse_move(tabId, coordinate);
}
await runComputeruseCommand("write", [text]);
}

export async function mouse_move(tabId: number, coordinate: [number, number]) {
await runComputeruseCommand("moveTo", coordinate);
}

export async function left_click(tabId: number, coordinate?: [number, number]) {
if (!coordinate) {
coordinate = (await cursor_position(tabId)).coordinate;
}
await runComputeruseCommand("click", [
coordinate[0],
coordinate[1],
1,
0,
"left",
]);
}

export async function left_click_drag(
tabId: number,
coordinate: [number, number]
) {
await runComputeruseCommand("dragTo", [coordinate[0], coordinate[1], 0]);
}

export async function right_click(
tabId: number,
coordinate?: [number, number]
) {
if (!coordinate) {
coordinate = (await cursor_position(tabId)).coordinate;
}
await runComputeruseCommand("click", [
coordinate[0],
coordinate[1],
1,
0,
"right",
]);
}

export async function double_click(
tabId: number,
coordinate?: [number, number]
) {
if (!coordinate) {
coordinate = (await cursor_position(tabId)).coordinate;
}
await runComputeruseCommand("click", [
coordinate[0],
coordinate[1],
2,
0,
"left",
]);
}

export async function screenshot(windowId?: number): Promise<{
image: {
type: "base64";
media_type: "image/png" | "image/jpeg";
data: string;
};
}> {
let screenshot = (await runComputeruseCommand("screenshot")).result;
let dataUrl = screenshot.startsWith("data:")
? screenshot
: "data:image/png;base64," + screenshot;
/*
if (!windowId) {
const window = await chrome.windows.getCurrent();
windowId = window.id;
}
let dataUrl = await chrome.tabs.captureVisibleTab(windowId as number, {
format: "jpeg", // jpeg / png
quality: 80, // 0-100
});
*/
let data = dataUrl.substring(dataUrl.indexOf("base64,") + 7);
return {
image: {
type: "base64",
media_type: dataUrl.indexOf("png") > -1 ? "image/png" : "image/jpeg",
data: data,
},
};
}

export async function cursor_position(tabId: number): Promise<{
coordinate: [number, number];
}> {
/*
let result: any = await chrome.tabs.sendMessage(tabId, {
type: "computer:cursor_position",
});
return { coordinate: result.coordinate as [number, number] };
*/
let response = await runComputeruseCommand("position");
return response.result;
}

export async function size(): Promise<[number, number]> {
let response = await runComputeruseCommand("size");
return response.result;
}

export async function scroll(tabId: number, coordinate?: [number, number]) {
await runComputeruseCommand("scroll", [2]);
}

export async function runComputeruseCommand(
func: string,
args?: Array<any>
): Promise<{ result: any }> {
return (await chrome.runtime.sendMessage("gcgnhflnikdhbgielkialpbfcdpifcml", {
func,
args,
})) as any as { result: any };
}
Empty file removed src/background/tools/screenshot.ts
Empty file.
2 changes: 1 addition & 1 deletion src/background/tools/web_search.ts
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ export class WebSearch implements Tool {
description: "search for keywords",
},
maxResults: {
type: "number",
type: "integer",
description: "Maximum search results, default 5",
},
},
Expand Down
19 changes: 19 additions & 0 deletions src/background/utils.ts
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,25 @@ export function getCurrentTabId(): Promise<number | undefined> {
});
}

export async function getPageSize(): Promise<{ width: number; height: number }> {
let tabId = await getCurrentTabId();
let injectionResult = await chrome.scripting.executeScript({
target: { tabId: tabId as number },
func: () => [
window.innerWidth ||
document.documentElement.clientWidth ||
document.body.clientWidth,
window.innerHeight ||
document.documentElement.clientHeight ||
document.body.clientHeight,
],
});
return {
width: injectionResult[0].result[0] as number,
height: injectionResult[0].result[1] as number,
};
}

export function sleep(time: number): Promise<void> {
return new Promise((resolve) => setTimeout(() => resolve(), time));
}
Expand Down
32 changes: 32 additions & 0 deletions src/content/index.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,32 @@
declare const eko: any;

chrome.runtime.onMessage.addListener(function (request, sender, sendResponse) {
(async () => {
try {
switch (request.type) {
case "page:getDetailLinks": {
let result = await eko.getDetailLinks(request.search);
sendResponse(result);
break;
}
case "page:getContent": {
let result = await eko.getContent(request.search);
sendResponse(result);
break;
}
case "computer:cursor_position": {
sendResponse({ coordinate: [eko.lastMouseX, eko.lastMouseY] });
break;
}
}
} catch (e) {
console.log("onMessage error", e);
}
})();
return true;
});

document.addEventListener("mousemove", (event) => {
eko.lastMouseX = event.clientX;
eko.lastMouseY = event.clientY;
});
Loading

0 comments on commit 3def826

Please sign in to comment.