@assemblyline-agents/orgo 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OpenEve contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,44 @@
+# @assemblyline-agents/orgo
+
+Official Assembly Line connection plugin for isolated Orgo cloud desktops. It wraps
+Orgo's documented REST API in a packaged stdio MCP bridge so the agent receives
+screenshots as image content and never receives the API's VNC password fields.
+
+## Setup
+
+Create an Orgo API key, add it to the Assembly Line runtime host, then add the plugin:
+
+```sh
+export ORGO_API_KEY=...
+assembly-line add orgo agent
+```
+
+The generated connection starts read-only:
+
+```ts
+import { defineOrgoConnection } from "@assemblyline-agents/orgo";
+
+export default defineOrgoConnection({
+  access: { read: true, write: false }
+});
+```
+
+Read authority covers workspace/computer listing, computer status, and
+screenshots. Provisioning, deletion, lifecycle actions, mouse/keyboard input,
+waits, Bash, and Python require an explicit write policy:
+
+```ts
+access: {
+  read: true,
+  write: { approval: "always" }
+}
+```
+
+Orgo computers are persistent cloud resources and may continue billing until
+stopped or deleted. Use dedicated workspaces, configure auto-stop where
+appropriate, and reserve `approval: "never"` for reviewed unattended
+workloads.
+
+Set `ORGO_API_BASE_URL` or pass `apiBaseUrl` only for a developer-controlled
+Orgo-compatible endpoint. The API key remains in the host environment and is
+forwarded only to the packaged bridge process.

package/dist/client.d.ts

@@ -0,0 +1,12 @@
+export declare class OrgoApiClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    constructor(apiKey: string | undefined, configuredBaseUrl: string);
+    get(path: string): Promise<unknown>;
+    post(path: string, body?: Record<string, unknown>): Promise<unknown>;
+    delete(path: string): Promise<unknown>;
+    private request;
+}
+export declare function sanitizeComputerResponse(value: unknown): unknown;
+export declare function screenshotData(value: unknown): string;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAEA,qBAAa,aAAa;IAItB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAGd,MAAM,EAAE,MAAM,GAAG,SAAS,EAC3C,iBAAiB,EAAE,MAAM;IAYrB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAInC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAIpE,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;YAI9B,OAAO;CA2BtB;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAShE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAKrD"}

package/dist/client.js

@@ -0,0 +1,81 @@
+const SENSITIVE_COMPUTER_FIELDS = new Set(["password", "vnc_password"]);
+export class OrgoApiClient {
+    apiKey;
+    baseUrl;
+    constructor(apiKey, configuredBaseUrl) {
+        this.apiKey = apiKey;
+        const parsed = new URL(configuredBaseUrl);
+        if (parsed.protocol !== "https:" && parsed.protocol !== "http:") {
+            throw new Error("Orgo API base URL must use HTTP or HTTPS.");
+        }
+        if (parsed.username || parsed.password || parsed.search || parsed.hash) {
+            throw new Error("Orgo API base URL cannot contain credentials, a query, or a fragment.");
+        }
+        this.baseUrl = parsed.toString().replace(/\/$/u, "");
+    }
+    async get(path) {
+        return this.request(path, "GET");
+    }
+    async post(path, body) {
+        return this.request(path, "POST", body);
+    }
+    async delete(path) {
+        return this.request(path, "DELETE");
+    }
+    async request(path, method, body) {
+        const apiKey = this.apiKey?.trim();
+        if (!apiKey)
+            throw new Error("Missing ORGO_API_KEY on the OpenEve runtime host.");
+        const headers = {
+            accept: "application/json",
+            authorization: `Bearer ${apiKey}`
+        };
+        if (body)
+            headers["content-type"] = "application/json";
+        const response = await fetch(`${this.baseUrl}${path}`, {
+            method,
+            headers,
+            ...(body ? { body: JSON.stringify(body) } : {})
+        });
+        const text = await response.text();
+        const parsed = text ? parseJson(text) : null;
+        if (!response.ok) {
+            const providerMessage = isRecord(parsed) && typeof parsed.error === "string"
+                ? `: ${parsed.error}`
+                : "";
+            throw new Error(`Orgo API ${method} ${path} failed with HTTP ${response.status}${providerMessage}`);
+        }
+        return parsed;
+    }
+}
+export function sanitizeComputerResponse(value) {
+    if (Array.isArray(value))
+        return value.map(sanitizeComputerResponse);
+    if (!isRecord(value))
+        return value;
+    const sanitized = {};
+    for (const [key, entry] of Object.entries(value)) {
+        if (SENSITIVE_COMPUTER_FIELDS.has(key.toLowerCase()))
+            continue;
+        sanitized[key] = sanitizeComputerResponse(entry);
+    }
+    return sanitized;
+}
+export function screenshotData(value) {
+    if (!isRecord(value) || typeof value.image !== "string" || !value.image.trim()) {
+        throw new Error("Orgo screenshot response did not include a base64 PNG image.");
+    }
+    return value.image.replace(/^data:image\/png;base64,/u, "");
+}
+function parseJson(value) {
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return value;
+    }
+}
+function isRecord(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+import { type StdioMcpPluginConnectionOptions } from "@assemblyline-agents/core";
+export interface OrgoConnectionOptions extends StdioMcpPluginConnectionOptions {
+    /** Trusted Orgo REST API base selected by the deployment owner. */
+    apiBaseUrl?: string;
+}
+export declare function defineOrgoConnection(options: OrgoConnectionOptions): import("@assemblyline-agents/core").McpStdioClientConnectionDefinition;
+export declare const openevePlugin: import("@assemblyline-agents/core").PluginModule;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,+BAA+B,EACrC,MAAM,2BAA2B,CAAC;AAMnC,MAAM,WAAW,qBAAsB,SAAQ,+BAA+B;IAC5E,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,0EAgBlE;AAED,eAAO,MAAM,aAAa,kDAA0C,CAAC"}

package/dist/index.js

@@ -0,0 +1,21 @@
+import { fileURLToPath } from "node:url";
+import { connectionPluginMetadata, definePlugin, defineStdioMcpPluginConnection } from "@assemblyline-agents/core";
+const PLUGIN = connectionPluginMetadata("orgo");
+const MCP_SERVER_PATH = fileURLToPath(new URL("./mcp-server.js", import.meta.url));
+const DEFAULT_API_BASE_URL = "https://www.orgo.ai/api";
+export function defineOrgoConnection(options) {
+    const { apiBaseUrl = process.env.ORGO_API_BASE_URL?.trim() || DEFAULT_API_BASE_URL, ...connection } = options;
+    const apiKey = process.env.ORGO_API_KEY?.trim();
+    const serverArgs = [MCP_SERVER_PATH, "--base-url", apiBaseUrl];
+    return defineStdioMcpPluginConnection(PLUGIN, {
+        ...connection,
+        command: connection.command ?? process.execPath,
+        args: connection.args ?? serverArgs,
+        env: {
+            ...(apiKey ? { ORGO_API_KEY: apiKey } : {}),
+            ...(connection.env ?? {})
+        }
+    });
+}
+export const openevePlugin = definePlugin({ connections: [PLUGIN] });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EACL,wBAAwB,EACxB,YAAY,EACZ,8BAA8B,EAE/B,MAAM,2BAA2B,CAAC;AAEnC,MAAM,MAAM,GAAG,wBAAwB,CAAC,MAAM,CAAE,CAAC;AACjD,MAAM,eAAe,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACnF,MAAM,oBAAoB,GAAG,yBAAyB,CAAC;AAOvD,MAAM,UAAU,oBAAoB,CAAC,OAA8B;IACjE,MAAM,EACJ,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,IAAI,EAAE,IAAI,oBAAoB,EAC1E,GAAG,UAAU,EACd,GAAG,OAAO,CAAC;IACZ,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC;IAChD,MAAM,UAAU,GAAG,CAAC,eAAe,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC;IAC/D,OAAO,8BAA8B,CAAC,MAAM,EAAE;QAC5C,GAAG,UAAU;QACb,OAAO,EAAE,UAAU,CAAC,OAAO,IAAI,OAAO,CAAC,QAAQ;QAC/C,IAAI,EAAE,UAAU,CAAC,IAAI,IAAI,UAAU;QACnC,GAAG,EAAE;YACH,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3C,GAAG,CAAC,UAAU,CAAC,GAAG,IAAI,EAAE,CAAC;SAC1B;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC"}

package/dist/input.d.ts

@@ -0,0 +1,13 @@
+export declare function recordValue(value: unknown): Record<string, unknown>;
+export declare function stringValue(value: unknown, name: string, options?: {
+    trim?: boolean;
+}): string;
+export declare function optionalString(value: unknown, name: string): string | undefined;
+export declare function integerValue(value: unknown, name: string, minimum: number, maximum: number): number;
+export declare function optionalInteger(value: unknown, name: string, minimum: number, maximum: number): number | undefined;
+export declare function numberValue(value: unknown, name: string, minimum: number, maximum: number): number;
+export declare function optionalNumber(value: unknown, name: string, minimum: number, maximum: number): number | undefined;
+export declare function optionalBoolean(value: unknown, name: string): boolean | undefined;
+export declare function optionalEnum<T extends string | number>(value: unknown, allowed: readonly T[], name: string): T | undefined;
+export declare function compactRecord(values: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=input.d.ts.map

package/dist/input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../src/input.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAInE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,MAAM,CAOlG;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE/E;AAED,wBAAgB,YAAY,CAC1B,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,MAAM,CAKR;AAED,wBAAgB,eAAe,CAC7B,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,MAAM,GAAG,SAAS,CAEpB;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAKlG;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,MAAM,GAAG,SAAS,CAEpB;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAIjF;AAED,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EACpD,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,SAAS,CAAC,EAAE,EACrB,IAAI,EAAE,MAAM,GACX,CAAC,GAAG,SAAS,CAMf;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEtF"}

package/dist/input.js

@@ -0,0 +1,54 @@
+export function recordValue(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : {};
+}
+export function stringValue(value, name, options = {}) {
+    if (typeof value !== "string" || value.length === 0) {
+        throw new Error(`${name} must be a non-empty string.`);
+    }
+    const normalized = options.trim === false ? value : value.trim();
+    if (!normalized)
+        throw new Error(`${name} must be a non-empty string.`);
+    return normalized;
+}
+export function optionalString(value, name) {
+    return value === undefined ? undefined : stringValue(value, name);
+}
+export function integerValue(value, name, minimum, maximum) {
+    if (typeof value !== "number" || !Number.isInteger(value) || value < minimum || value > maximum) {
+        throw new Error(`${name} must be an integer from ${minimum} to ${maximum}.`);
+    }
+    return value;
+}
+export function optionalInteger(value, name, minimum, maximum) {
+    return value === undefined ? undefined : integerValue(value, name, minimum, maximum);
+}
+export function numberValue(value, name, minimum, maximum) {
+    if (typeof value !== "number" || !Number.isFinite(value) || value < minimum || value > maximum) {
+        throw new Error(`${name} must be a number from ${minimum} to ${maximum}.`);
+    }
+    return value;
+}
+export function optionalNumber(value, name, minimum, maximum) {
+    return value === undefined ? undefined : numberValue(value, name, minimum, maximum);
+}
+export function optionalBoolean(value, name) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== "boolean")
+        throw new Error(`${name} must be a boolean.`);
+    return value;
+}
+export function optionalEnum(value, allowed, name) {
+    if (value === undefined)
+        return undefined;
+    if ((typeof value !== "string" && typeof value !== "number") || !allowed.includes(value)) {
+        throw new Error(`${name} must be one of: ${allowed.join(", ")}.`);
+    }
+    return value;
+}
+export function compactRecord(values) {
+    return Object.fromEntries(Object.entries(values).filter(([, value]) => value !== undefined));
+}
+//# sourceMappingURL=input.js.map

package/dist/input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.js","sourceRoot":"","sources":["../src/input.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mcp-server.d.ts.map

package/dist/mcp-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":""}

package/dist/mcp-server.js

@@ -0,0 +1,164 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+import { OrgoApiClient, sanitizeComputerResponse, screenshotData } from "./client.js";
+import { compactRecord, integerValue, numberValue, optionalBoolean, optionalEnum, optionalInteger, optionalNumber, optionalString, recordValue, stringValue } from "./input.js";
+import { ORGO_TOOLS } from "./tools.js";
+const api = new OrgoApiClient(process.env.ORGO_API_KEY, parseBaseUrl(process.argv.slice(2)));
+const server = new Server({ name: "openeve-orgo", version: "0.1.0" }, {
+    capabilities: { tools: {} },
+    instructions: "Control Orgo cloud desktops through typed REST operations. VNC credentials are always stripped from tool results."
+});
+server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: ORGO_TOOLS }));
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    try {
+        return await callTool(request.params.name, recordValue(request.params.arguments));
+    }
+    catch (error) {
+        return toolResult({ error: error instanceof Error ? error.message : String(error) }, true);
+    }
+});
+await server.connect(new StdioServerTransport());
+async function callTool(name, input) {
+    if (name === "list_workspaces") {
+        return toolResult(sanitizeComputerResponse(await api.get("/workspaces")));
+    }
+    if (name === "create_workspace") {
+        return toolResult(await api.post("/workspaces", {
+            name: stringValue(input.name, "name")
+        }));
+    }
+    if (name === "list_computers") {
+        return toolResult(sanitizeComputerResponse(await api.get("/computers")));
+    }
+    if (name === "get_computer") {
+        return computerResult(await api.get(computerPath(input)));
+    }
+    if (name === "create_computer") {
+        const body = compactRecord({
+            workspace_id: stringValue(input.workspace_id, "workspace_id"),
+            name: stringValue(input.name, "name"),
+            os: optionalEnum(input.os, ["linux"], "os"),
+            ram: optionalEnum(input.ram, [4, 8, 16, 32, 64], "ram"),
+            cpu: optionalEnum(input.cpu, [1, 2, 4, 8, 16], "cpu"),
+            disk_size_gb: optionalInteger(input.disk_size_gb, "disk_size_gb", 8, 10_000),
+            resolution: optionalString(input.resolution, "resolution"),
+            auto_stop_minutes: optionalInteger(input.auto_stop_minutes, "auto_stop_minutes", 0, 525_600),
+            template_ref: optionalString(input.template_ref, "template_ref")
+        });
+        return computerResult(await api.post("/computers", body));
+    }
+    if (name === "delete_computer") {
+        return computerResult(await api.delete(computerPath(input)));
+    }
+    if (name === "start_computer" || name === "stop_computer" || name === "restart_computer") {
+        const action = name.replace("_computer", "");
+        return computerResult(await api.post(`${computerPath(input)}/${action}`));
+    }
+    if (name === "screenshot") {
+        const computerId = computerIdValue(input);
+        const image = screenshotData(await api.get(`/computers/${encodeURIComponent(computerId)}/screenshot`));
+        return {
+            content: [
+                { type: "image", data: image, mimeType: "image/png" },
+                { type: "text", text: JSON.stringify({ computer_id: computerId, format: "image/png" }) }
+            ]
+        };
+    }
+    if (name === "click") {
+        return toolResult(await api.post(`${computerPath(input)}/click`, compactRecord({
+            x: integerValue(input.x, "x", 0, 100_000),
+            y: integerValue(input.y, "y", 0, 100_000),
+            button: optionalEnum(input.button, ["left", "right"], "button"),
+            double: optionalBoolean(input.double, "double")
+        })));
+    }
+    if (name === "drag") {
+        return toolResult(await api.post(`${computerPath(input)}/drag`, compactRecord({
+            start_x: integerValue(input.start_x, "start_x", 0, 100_000),
+            start_y: integerValue(input.start_y, "start_y", 0, 100_000),
+            end_x: integerValue(input.end_x, "end_x", 0, 100_000),
+            end_y: integerValue(input.end_y, "end_y", 0, 100_000),
+            button: optionalEnum(input.button, ["left", "right"], "button"),
+            duration: optionalNumber(input.duration, "duration", 0, 60)
+        })));
+    }
+    if (name === "type_text") {
+        return toolResult(await api.post(`${computerPath(input)}/type`, {
+            text: stringValue(input.text, "text", { trim: false })
+        }));
+    }
+    if (name === "press_key") {
+        return toolResult(await api.post(`${computerPath(input)}/key`, {
+            key: stringValue(input.key, "key")
+        }));
+    }
+    if (name === "scroll") {
+        return toolResult(await api.post(`${computerPath(input)}/scroll`, compactRecord({
+            direction: requiredEnum(input.direction, ["up", "down"], "direction"),
+            amount: integerValue(input.amount, "amount", 1, 100),
+            x: optionalInteger(input.x, "x", 0, 100_000),
+            y: optionalInteger(input.y, "y", 0, 100_000)
+        })));
+    }
+    if (name === "wait") {
+        return toolResult(await api.post(`${computerPath(input)}/wait`, {
+            seconds: numberValue(input.seconds, "seconds", 0, 60)
+        }));
+    }
+    if (name === "execute_bash") {
+        return toolResult(await api.post(`${computerPath(input)}/bash`, {
+            command: boundedString(input.command, "command", 20_000)
+        }));
+    }
+    if (name === "execute_python") {
+        return toolResult(await api.post(`${computerPath(input)}/exec`, compactRecord({
+            code: boundedString(input.code, "code", 50_000),
+            timeout: optionalInteger(input.timeout, "timeout", 1, 300)
+        })));
+    }
+    throw new Error(`Unknown Orgo tool: ${name}`);
+}
+function parseBaseUrl(args) {
+    let baseUrl = process.env.ORGO_API_BASE_URL?.trim() || "https://www.orgo.ai/api";
+    for (let index = 0; index < args.length; index += 2) {
+        const flag = args[index];
+        const value = args[index + 1];
+        if (!flag || value === undefined)
+            throw new Error(`Missing value for ${flag ?? "server option"}.`);
+        if (flag === "--base-url")
+            baseUrl = value;
+        else
+            throw new Error(`Unknown Orgo MCP server option: ${flag}`);
+    }
+    return baseUrl;
+}
+function computerPath(input) {
+    return `/computers/${encodeURIComponent(computerIdValue(input))}`;
+}
+function computerIdValue(input) {
+    return stringValue(input.computer_id, "computer_id");
+}
+function computerResult(value) {
+    return toolResult(sanitizeComputerResponse(value));
+}
+function requiredEnum(value, allowed, name) {
+    const selected = optionalEnum(value, allowed, name);
+    if (!selected)
+        throw new Error(`${name} is required.`);
+    return selected;
+}
+function boundedString(value, name, maximumLength) {
+    const selected = stringValue(value, name, { trim: false });
+    if (selected.length > maximumLength) {
+        throw new Error(`${name} must contain at most ${maximumLength} characters.`);
+    }
+    return selected;
+}
+function toolResult(value, isError = false) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(value, null, 2) }],
+        ...(isError ? { isError: true } : {})
+    };
+}
+//# sourceMappingURL=mcp-server.js.map

package/dist/mcp-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.js","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":"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"}

package/dist/tools.d.ts

@@ -0,0 +1,3 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const ORGO_TOOLS: Tool[];
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAe/D,eAAO,MAAM,UAAU,EAAE,IAAI,EAuM5B,CAAC"}

package/dist/tools.js

@@ -0,0 +1,212 @@
+const COMPUTER_ID = {
+    type: "string",
+    minLength: 1,
+    description: "Orgo computer UUID returned by list_computers or create_computer."
+};
+const COMPUTER_ID_INPUT = {
+    type: "object",
+    required: ["computer_id"],
+    properties: { computer_id: COMPUTER_ID },
+    additionalProperties: false
+};
+export const ORGO_TOOLS = [
+    {
+        name: "list_workspaces",
+        description: "List Orgo workspaces available to the configured API key.",
+        inputSchema: { type: "object", properties: {}, additionalProperties: false }
+    },
+    {
+        name: "create_workspace",
+        description: "Create an Orgo workspace for cloud computers.",
+        inputSchema: {
+            type: "object",
+            required: ["name"],
+            properties: { name: { type: "string", minLength: 1 } },
+            additionalProperties: false
+        }
+    },
+    {
+        name: "list_computers",
+        description: "List Orgo cloud computers and their current lifecycle status.",
+        inputSchema: { type: "object", properties: {}, additionalProperties: false }
+    },
+    {
+        name: "get_computer",
+        description: "Get one Orgo computer's status and non-secret connection metadata.",
+        inputSchema: COMPUTER_ID_INPUT
+    },
+    {
+        name: "create_computer",
+        description: "Provision a persistent Orgo Linux desktop. It may continue billing until stopped or deleted.",
+        inputSchema: {
+            type: "object",
+            required: ["workspace_id", "name"],
+            properties: {
+                workspace_id: { type: "string", minLength: 1 },
+                name: { type: "string", minLength: 1 },
+                os: { type: "string", enum: ["linux"] },
+                ram: { type: "integer", enum: [4, 8, 16, 32, 64] },
+                cpu: { type: "integer", enum: [1, 2, 4, 8, 16] },
+                disk_size_gb: { type: "integer", minimum: 8 },
+                resolution: {
+                    type: "string",
+                    pattern: "^[0-9]+x[0-9]+x[0-9]+$",
+                    description: "Desktop resolution such as 1280x720x24."
+                },
+                auto_stop_minutes: { type: "integer", minimum: 0 },
+                template_ref: { type: "string", minLength: 1 }
+            },
+            additionalProperties: false
+        }
+    },
+    {
+        name: "delete_computer",
+        description: "Permanently delete an Orgo computer and its disk.",
+        inputSchema: COMPUTER_ID_INPUT
+    },
+    {
+        name: "start_computer",
+        description: "Start a stopped Orgo computer.",
+        inputSchema: COMPUTER_ID_INPUT
+    },
+    {
+        name: "stop_computer",
+        description: "Stop a running Orgo computer while preserving its disk.",
+        inputSchema: COMPUTER_ID_INPUT
+    },
+    {
+        name: "restart_computer",
+        description: "Restart an Orgo computer while preserving its disk.",
+        inputSchema: COMPUTER_ID_INPUT
+    },
+    {
+        name: "screenshot",
+        description: "Capture the current Orgo desktop as a PNG image.",
+        inputSchema: COMPUTER_ID_INPUT
+    },
+    {
+        name: "click",
+        description: "Click screen coordinates on a running Orgo computer.",
+        inputSchema: {
+            type: "object",
+            required: ["computer_id", "x", "y"],
+            properties: {
+                computer_id: COMPUTER_ID,
+                x: { type: "integer", minimum: 0 },
+                y: { type: "integer", minimum: 0 },
+                button: { type: "string", enum: ["left", "right"] },
+                double: { type: "boolean" }
+            },
+            additionalProperties: false
+        }
+    },
+    {
+        name: "drag",
+        description: "Drag between two screen coordinates on a running Orgo computer.",
+        inputSchema: {
+            type: "object",
+            required: ["computer_id", "start_x", "start_y", "end_x", "end_y"],
+            properties: {
+                computer_id: COMPUTER_ID,
+                start_x: { type: "integer", minimum: 0 },
+                start_y: { type: "integer", minimum: 0 },
+                end_x: { type: "integer", minimum: 0 },
+                end_y: { type: "integer", minimum: 0 },
+                button: { type: "string", enum: ["left", "right"] },
+                duration: { type: "number", minimum: 0, maximum: 60 }
+            },
+            additionalProperties: false
+        }
+    },
+    {
+        name: "type_text",
+        description: "Type text into the focused application on a running Orgo computer.",
+        inputSchema: {
+            type: "object",
+            required: ["computer_id", "text"],
+            properties: {
+                computer_id: COMPUTER_ID,
+                text: { type: "string", minLength: 1 }
+            },
+            additionalProperties: false
+        }
+    },
+    {
+        name: "press_key",
+        description: "Press a key or chord such as Enter, Tab, ctrl+c, or ctrl+shift+t.",
+        inputSchema: {
+            type: "object",
+            required: ["computer_id", "key"],
+            properties: {
+                computer_id: COMPUTER_ID,
+                key: { type: "string", minLength: 1 }
+            },
+            additionalProperties: false
+        }
+    },
+    {
+        name: "scroll",
+        description: "Scroll the desktop in one direction by a bounded amount.",
+        inputSchema: {
+            type: "object",
+            required: ["computer_id", "direction", "amount"],
+            properties: {
+                computer_id: COMPUTER_ID,
+                direction: { type: "string", enum: ["up", "down"] },
+                amount: { type: "integer", minimum: 1, maximum: 100 },
+                x: {
+                    type: "integer",
+                    minimum: 0,
+                    description: "Optional cursor X coordinate before scrolling."
+                },
+                y: {
+                    type: "integer",
+                    minimum: 0,
+                    description: "Optional cursor Y coordinate before scrolling."
+                }
+            },
+            additionalProperties: false
+        }
+    },
+    {
+        name: "wait",
+        description: "Wait up to 60 seconds for the Orgo desktop to settle.",
+        inputSchema: {
+            type: "object",
+            required: ["computer_id", "seconds"],
+            properties: {
+                computer_id: COMPUTER_ID,
+                seconds: { type: "number", minimum: 0, maximum: 60 }
+            },
+            additionalProperties: false
+        }
+    },
+    {
+        name: "execute_bash",
+        description: "Execute a shell command inside an Orgo computer. This has full machine authority.",
+        inputSchema: {
+            type: "object",
+            required: ["computer_id", "command"],
+            properties: {
+                computer_id: COMPUTER_ID,
+                command: { type: "string", minLength: 1, maxLength: 20000 }
+            },
+            additionalProperties: false
+        }
+    },
+    {
+        name: "execute_python",
+        description: "Execute Python code inside an Orgo computer with a bounded timeout.",
+        inputSchema: {
+            type: "object",
+            required: ["computer_id", "code"],
+            properties: {
+                computer_id: COMPUTER_ID,
+                code: { type: "string", minLength: 1, maxLength: 50000 },
+                timeout: { type: "integer", minimum: 1, maximum: 300 }
+            },
+            additionalProperties: false
+        }
+    }
+];
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@assemblyline-agents/orgo",
+  "version": "0.1.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.2",
+    "@assemblyline-agents/core": "0.1.0"
+  },
+  "description": "Official OpenEve Orgo cloud computer-use connection plugin.",
+  "files": [
+    "dist",
+    "skills"
+  ],
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jasonbadeaux/openeve.git",
+    "directory": "packages/orgo"
+  },
+  "bugs": {
+    "url": "https://github.com/jasonbadeaux/openeve/issues"
+  },
+  "homepage": "https://github.com/jasonbadeaux/openeve#readme",
+  "author": "OpenEve contributors",
+  "keywords": [
+    "openeve",
+    "ai",
+    "agents",
+    "orgo",
+    "computer-use",
+    "cloud",
+    "plugin"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "check": "tsc -p tsconfig.json --noEmit"
+  }
+}

package/skills/orgo/SKILL.md

@@ -0,0 +1,39 @@
+---
+name: orgo
+description: Provision, inspect, and control isolated Orgo cloud desktops through a developer-configured API key.
+---
+# Orgo cloud computer use
+
+Use Orgo when a task needs a persistent full Linux desktop rather than only a
+browser tab or the user's own Mac. The deployment owner supplies
+`ORGO_API_KEY`; never place it, VNC credentials, cookies, or login secrets in
+tool arguments or prompts.
+
+Start with `list_workspaces` and `list_computers`. Reuse a purpose-built
+computer when possible. Creating a computer consumes account capacity and may
+continue billing until it is stopped or deleted, so use the smallest suitable
+configuration and set `auto_stop_minutes` for unattended work.
+
+For visual interaction, call `screenshot`, reason from the returned image, take
+one narrow action, and capture another screenshot after navigation or any
+state-changing input. Keep coordinates within the displayed resolution. Use
+`execute_bash` or `execute_python` only when direct machine execution is
+actually appropriate; both have full authority inside the cloud computer.
+
+Use dedicated workspaces and computers for untrusted sites or files. Do not
+sign into sensitive accounts without explicit user authorization and an
+approved credential workflow. Prefer stopping a reusable computer after work.
+Delete it only when the user or operating policy clearly requires permanent
+disk removal.
+
+The scaffold is read-only: it can list workspaces/computers, inspect computer
+status, and take screenshots. Provisioning, lifecycle changes, mouse/keyboard
+input, waits, and code execution require:
+
+```ts
+write: { approval: "always" }
+```
+
+Use `write: { approval: "never" }` only for a dedicated Orgo account and
+autonomous workload whose cost, login, data, and deletion boundaries have been
+reviewed.