@anonx3247/universal-agent-harness 0.1.0

package/dist/runner/index.js

@@ -0,0 +1,370 @@
+import { withRetries, err, ok } from "@app/lib/error";
+import { MessageResource } from "@app/resources/messages";
+import assert from "assert";
+import { errorToCallToolResult, createClientFromConfig } from "@app/lib/mcp";
+import { loadProfileMCPConfig } from "@app/lib/mcp-config";
+import { concurrentExecutor } from "@app/lib/async";
+import { assertNever } from "@app/lib/assert";
+import { createLLM } from "@app/models/provider";
+import { readFileSync } from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+function loadPromptForProfile(profile) {
+    const promptPath = join(__dirname, "../../profiles", profile, "prompt.md");
+    return readFileSync(promptPath, "utf-8");
+}
+export class Runner {
+    experiment;
+    agentIndex;
+    mcpClients;
+    model;
+    contextPruning;
+    messages; // ordered by position asc
+    constructor(experiment, agentIndex, mcpClients, model) {
+        this.experiment = experiment;
+        this.agentIndex = agentIndex;
+        this.mcpClients = mcpClients;
+        this.model = model;
+        this.messages = [];
+        this.contextPruning = {
+            lastAgentLoopStartIdx: 0,
+            lastAgentLoopInnerStartIdx: 0,
+        };
+    }
+    static async builder(experiment, agentIndex, config) {
+        const profile = experiment.toJSON().profile;
+        const clients = [];
+        // Load and connect to configured MCP servers
+        const mcpConfigResult = loadProfileMCPConfig(profile);
+        if (mcpConfigResult.isErr()) {
+            return mcpConfigResult;
+        }
+        const mcpConfigs = mcpConfigResult.value;
+        if (mcpConfigs.length > 0) {
+            console.log(`\x1b[36mLoading ${mcpConfigs.length} MCP server(s) for agent ${agentIndex}...\x1b[0m`);
+            for (const mcpConfig of mcpConfigs) {
+                const clientResult = await createClientFromConfig(mcpConfig);
+                if (clientResult.isErr()) {
+                    console.error(`\x1b[33mWarning: Failed to connect to MCP server '${mcpConfig.name}': ${clientResult.error.message}\x1b[0m`);
+                    // Continue with other servers even if one fails
+                    continue;
+                }
+                clients.push(clientResult.value);
+                console.log(`\x1b[32m✓ Connected to MCP server '${mcpConfig.name}'\x1b[0m`);
+            }
+        }
+        const model = createLLM(experiment.toJSON().model, {
+            thinking: config.thinking,
+        });
+        const runner = await Runner.initialize(experiment, agentIndex, clients, model);
+        if (runner.isErr()) {
+            return runner;
+        }
+        return ok(runner.value);
+    }
+    static async initialize(experiment, agentIndex, mcpClients, model) {
+        const runner = new Runner(experiment, agentIndex, mcpClients, model);
+        const messages = await MessageResource.listMessagesByAgent(runner.experiment, runner.agentIndex);
+        runner.messages = messages;
+        return ok(runner);
+    }
+    async tools() {
+        const tools = [];
+        for (const client of this.mcpClients) {
+            try {
+                const ct = await client.listTools();
+                for (const tool of ct.tools) {
+                    tools.push({
+                        name: `${client.getServerVersion()?.name}-${tool.name}`,
+                        description: tool.description,
+                        inputSchema: tool.inputSchema,
+                    });
+                }
+            }
+            catch (error) {
+                return err("tool_error", `Error listing tools from client ${client.getServerVersion()?.name}`, error);
+            }
+        }
+        return ok(tools);
+    }
+    async executeTool(t) {
+        for (const client of this.mcpClients) {
+            try {
+                const ct = await client.listTools();
+                for (const tool of ct.tools) {
+                    if (`${client.getServerVersion()?.name}-${tool.name}` === t.name) {
+                        const result = await client.callTool({
+                            name: tool.name,
+                            arguments: t.input,
+                        });
+                        const toolResult = {
+                            type: "tool_result",
+                            toolUseId: t.id,
+                            toolUseName: t.name,
+                            content: result.content,
+                            isError: (result.isError ?? false),
+                        };
+                        return toolResult;
+                    }
+                }
+            }
+            catch (error) {
+                return {
+                    type: "tool_result",
+                    toolUseId: t.id,
+                    toolUseName: t.name,
+                    content: errorToCallToolResult(err("tool_execution_error", `Error executing tool ${t.name}`, error)).content,
+                    isError: true,
+                };
+            }
+        }
+        return {
+            type: "tool_result",
+            toolUseId: t.id,
+            toolUseName: t.name,
+            content: errorToCallToolResult(err("tool_execution_error", `No MCP client found to execute tool ${t.name}`)).content,
+            isError: true,
+        };
+    }
+    isNewUserMessageNeeded() {
+        if (this.messages.length === 0) {
+            return true;
+        }
+        // If the role is agent it means we had no tool use in the last tick and we need a user message.
+        const last = this.messages[this.messages.length - 1];
+        if (last.toJSON().role === "agent") {
+            return true;
+        }
+        return false;
+    }
+    async newUserMessage() {
+        const position = this.messages.length > 0
+            ? this.messages[this.messages.length - 1].position() + 1
+            : 0;
+        const m = {
+            role: "user",
+            content: [
+                {
+                    type: "text",
+                    text: `\
+<system>
+This is an automated system message and there is no user available to respond. Proceed autonomously, making sure to use tools as only tools have visible effects on the system. Never stay idle and always pro-actively work on solving the problem.
+</system>
+`,
+                    provider: null,
+                },
+            ],
+        };
+        const message = await MessageResource.create(this.experiment, this.agentIndex, m, position, 0, // User messages have no token usage
+        0);
+        return ok(message);
+    }
+    isAgentLoopStartMessage(message) {
+        // A user message with only text content marks the start of an agentic loop.
+        return (message.role === "user" && message.content.every((c) => c.type === "text"));
+    }
+    isAgentLoopInnerStartMessage(m) {
+        // We prune at tool_uses because it ensures the conversation is valid (since any following
+        // tool_result is guaranteed to have its corresponding tool_use before it).
+        return m.role === "agent" && m.content.some((c) => c.type === "tool_use");
+    }
+    shiftContextPruning() {
+        /**
+         * We bump lastAgentLoopInnerStartIdx whilst ensuring that the conversation is valid. This is
+         * done by pruning messages before a tool_use (since any following tool_result is guaranteed to
+         * have its corresponding tool_use before it).
+         */
+        assert(this.contextPruning.lastAgentLoopInnerStartIdx < this.messages.length, "lastLoopInnerStartIdx is out of bounds.");
+        let idx = this.contextPruning.lastAgentLoopInnerStartIdx >
+            this.contextPruning.lastAgentLoopStartIdx
+            ? this.contextPruning.lastAgentLoopInnerStartIdx + 1
+            : /* This avoids an unneeded iteration, without this, if they were equal, the result of the
+               * iteration would have been: lastAgentLoopInnerStartIdx === lastAgentLoopStartIdx + 1.
+               * Which results in no change to `messages` since:
+               * forall idx, messages.slice(idx) === [messages[idx], ...messages.slice(idx+1)] */
+                this.contextPruning.lastAgentLoopInnerStartIdx + 2;
+        let foundNewAgenticLoop = false;
+        for (; idx < this.messages.length; idx++) {
+            const m = this.messages[idx].toJSON();
+            if (this.isAgentLoopInnerStartMessage(m)) {
+                break;
+            }
+            if (this.isAgentLoopStartMessage(m)) {
+                foundNewAgenticLoop = true;
+                break;
+            }
+        }
+        if (idx >= this.messages.length) {
+            return err("agent_loop_overflow_error", "No agentic loop start position found after last.");
+        }
+        if (foundNewAgenticLoop) {
+            this.contextPruning.lastAgentLoopStartIdx = idx;
+        }
+        this.contextPruning.lastAgentLoopInnerStartIdx = idx;
+        return ok(undefined);
+    }
+    /**
+     * Render past agent messages to the model handling truncation to fit the model context window as
+     * needed.
+     *
+     * @param systemPrompt System prompt to use for the model call.
+     * @param tools Tools to provide to the model.
+     */
+    async renderForModel(systemPrompt, tools) {
+        /**
+         * Invariants:
+         * (1) The agent loop is always started by a user message (with only text content).
+         * (2) Tool Result must be preceded by a corresponding (i.e. same tool_use_id) Tool Use.
+         *
+         * - If lastAgentLoopInnerStartIdx === lastAgentLoopStartIdx: we have a full agent loop. And we
+         * select all messages from lastAgentLoopStartIdx (messages[lastAgentLoopInnerStartIdx]
+         * verifies (1)). And since the agent loop is not pruned we also automatically verify (2).
+         *
+         * If lastAgentLoopInnerStartIdx > lastAgentLoopStartIdx: we prune messages *in* the agent loop.
+         * We select messages from lastAgentLoopInnerStartIdx (messages[lastAgentLoopInnerStartIdx]
+         * verifies (2)). BUT we also need to include the user text message at the start of the agent
+         * loop (at lastAgentLoopStartIdx) to ensure (1).
+         */
+        let tokenCount = 0;
+        do {
+            // Prune messages before contextPruning.lastAgentLoopInnerStartIdx.
+            let messages = [...this.messages]
+                .slice(this.contextPruning.lastAgentLoopInnerStartIdx)
+                .map((m) => m.toJSON());
+            if (this.contextPruning.lastAgentLoopInnerStartIdx >
+                this.contextPruning.lastAgentLoopStartIdx) {
+                // A valid conversation must begin with a user message. In this case we use the
+                // user message at the start of the agent loop. Ensuring (1).
+                const agentLoopStartUserMessage = this.messages[this.contextPruning.lastAgentLoopStartIdx].toJSON();
+                messages = [agentLoopStartUserMessage, ...messages];
+            }
+            const res = await this.model.tokens(messages, systemPrompt, tools);
+            if (res.isErr()) {
+                console.log("Agent: " + this.agentIndex);
+                console.log(messages.length);
+                messages.forEach((m) => {
+                    console.log(m.role);
+                    console.log(m.content);
+                    console.log("----");
+                });
+                return res;
+            }
+            tokenCount = res.value;
+            if (tokenCount > this.model.maxTokens()) {
+                const res = this.shiftContextPruning();
+                if (res.isErr()) {
+                    return res;
+                }
+            }
+            else {
+                return ok(messages);
+            }
+        } while (tokenCount > this.model.maxTokens());
+        return err("agent_loop_overflow_error", "Unreachable");
+    }
+    /**
+     * Logs message content during runner execution to display progress.
+     */
+    logContent(c, messageId) {
+        let out = `\x1b[1m\x1b[37mAgent ${this.agentIndex}\x1b[0m`; // name: bold white
+        if (messageId) {
+            out += ` \x1b[1m\x1b[33m#${messageId}\x1b[0m`; // message id: bold yellow if available
+        }
+        switch (c.type) {
+            case "thinking": {
+                out += ` \x1b[90m>\x1b[0m `; // separator: grey
+                out += `\x1b[1m\x1b[95mThinking:\x1b[0m `; // label: bold magenta/purple
+                out += `\x1b[90m${c.thinking.replace(/\n/g, " ")}\x1b[0m`; // text: grey
+                break;
+            }
+            case "text": {
+                out += ` \x1b[90m>\x1b[0m `; // separator: grey
+                out += `\x1b[1m\x1b[38;5;208mText:\x1b[0m `; // label: bold orange (256-color)
+                out += `\x1b[90m${c.text.replace(/\n/g, " ")}\x1b[0m`; // content: grey
+                break;
+            }
+            case "tool_use": {
+                out += ` \x1b[90m>\x1b[0m `; // separator: grey
+                out += `\x1b[1m\x1b[32mToolUse:\x1b[0m `; // label: bold green
+                out += `${c.name}`;
+                break;
+            }
+            case "tool_result": {
+                out += ` \x1b[90m<\x1b[0m `; // separator: grey
+                out += `\x1b[1m\x1b[34mToolResult:\x1b[0m `; // label: bold blue
+                out +=
+                    `${c.toolUseName} ` +
+                        `${c.isError
+                            ? "\x1b[1m\x1b[31m[error]\x1b[0m"
+                            : "\x1b[1m\x1b[32m[success]\x1b[0m"}`;
+                break;
+            }
+            default:
+                assertNever(c);
+        }
+        console.log(out);
+    }
+    /**
+     * Advance runer by one tick (one agent call + associated tools executions).
+     */
+    async tick() {
+        const tools = await this.tools();
+        if (tools.isErr()) {
+            return tools;
+        }
+        if (this.isNewUserMessageNeeded()) {
+            const newMessage = await this.newUserMessage();
+            if (newMessage.isErr()) {
+                return newMessage;
+            }
+            this.messages.push(newMessage.value);
+        }
+        const profile = this.experiment.toJSON().profile;
+        const systemPrompt = loadPromptForProfile(profile).replace("{{PROBLEM}}", this.experiment.toJSON().problem);
+        const messagesForModel = await this.renderForModel(systemPrompt, tools.value);
+        if (messagesForModel.isErr()) {
+            return messagesForModel;
+        }
+        const res = await withRetries(async () => {
+            return this.model.run(messagesForModel.value, systemPrompt, tools.value);
+        })({});
+        if (res.isErr()) {
+            return res;
+        }
+        const { message, tokenUsage } = res.value;
+        if (message.content.length === 0) {
+            console.log(`WARNING: Skipping empty agent response content for agent ${this.agentIndex}`);
+            return ok(undefined);
+        }
+        const toolResults = await concurrentExecutor(message.content.filter((content) => content.type === "tool_use"), async (t) => {
+            return await this.executeTool(t);
+        }, { concurrency: 8 });
+        const last = this.messages[this.messages.length - 1];
+        // Calculate cost and tokens for this message
+        const totalTokens = tokenUsage?.total ?? 0;
+        const cost = tokenUsage ? this.model.cost([tokenUsage]) : 0;
+        const agentMessage = await MessageResource.create(this.experiment, this.agentIndex, message, last.position() + 1, totalTokens, cost);
+        this.messages.push(agentMessage);
+        message.content.forEach((c) => {
+            this.logContent(c, agentMessage.toJSON().id);
+        });
+        if (toolResults.length > 0) {
+            const toolResultsMessage = await MessageResource.create(this.experiment, this.agentIndex, {
+                role: "user",
+                content: toolResults,
+            }, last.position() + 2, 0, // Tool results have no token usage
+            0);
+            this.messages.push(toolResultsMessage);
+            toolResults.forEach((tr) => {
+                this.logContent(tr, toolResultsMessage.toJSON().id);
+                if (tr.isError) {
+                    console.error(tr.content);
+                }
+            });
+        }
+        return ok(undefined);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/runner/index.js.map

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

package/dist/tools/index.d.ts

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

package/dist/tools/index.d.ts.map

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

package/dist/tools/index.js

@@ -0,0 +1,4 @@
+export {};
+// Tool exports
+// This file is reserved for future tool integrations
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":";AAAA,eAAe;AACf,qDAAqD"}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@anonx3247/universal-agent-harness",
+  "version": "0.1.0",
+  "description": "Universal multi-agent orchestration system with MCP server support",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "imports": {
+    "@app/*": "./src/*"
+  },
+  "bin": {
+    "agent-harness": "./dist/agent-harness.js"
+  },
+  "files": [
+    "dist",
+    "profiles",
+    "README.md"
+  ],
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "lint": "NODE_OPTIONS='--max-old-space-size=8192' eslint --cache --cache-location .eslintcache src/",
+    "build": "tsc",
+    "dev": "tsx src/agent-harness.ts"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/dockerode": "^3.3.44",
+    "@types/node": "^22.0.0",
+    "@types/tar-stream": "^3.1.4",
+    "drizzle-kit": "^0.31.4",
+    "eslint": "^9.39.1",
+    "tsx": "^4.0.0",
+    "typescript": "^5.8.3",
+    "typescript-eslint": "^8.46.3"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.57.0",
+    "@google/genai": "^1.13.0",
+    "@huggingface/transformers": "^3.8.1",
+    "@mistralai/mistralai": "^1.10.0",
+    "@modelcontextprotocol/sdk": "^1.17.1",
+    "@types/json-schema": "^7.0.15",
+    "better-sqlite3": "^12.2.0",
+    "commander": "^14.0.0",
+    "dockerode": "^4.0.8",
+    "drizzle-orm": "^0.44.3",
+    "jiti": "^2.6.1",
+    "openai": "^5.16.0",
+    "tar-stream": "^3.1.7"
+  }
+}

package/profiles/example/prompt.md

@@ -0,0 +1,54 @@
+You are an AI agent working autonomously to solve problems using the tools available to you.
+
+## Your Environment
+
+You have access to various tools through MCP (Model Context Protocol) servers. The specific tools available depend on your configuration, but may include:
+- File system operations
+- Code execution
+- API integrations
+- Data storage and retrieval
+- And more...
+
+Use the tools you have access to creatively and effectively to solve the problem at hand.
+
+## Primary Objective
+
+**Problem Solving**: Your fundamental goal is to solve the problem systematically and thoroughly. Approach every task with:
+- Intellectual honesty
+- Skepticism of unsubstantiated claims
+- Commitment to following evidence wherever it leads
+- Rigorous verification of results
+
+## Core Principles
+
+**Rigorous Thinking**: Employ critical thinking and rigorous justification. A solution cannot be considered valid unless every step is logically sound and clearly explained.
+
+**Honesty About Completeness**: If you cannot find a complete solution, present only significant partial results that you can rigorously justify. Do not guess or create solutions with hidden flaws.
+
+**Divide and Conquer**: Break complex problems into manageable sub-problems. Solve them independently and combine results to form a complete solution.
+
+**Challenge Assumptions**: Actively seek out and challenge existing assumptions, methodologies, and conclusions. Be open to revising your views based on new evidence.
+
+## Working Method
+
+1. **Understand the Problem**: Read and analyze the problem carefully. Break it down into components if needed.
+
+2. **Plan Your Approach**: Outline the steps you'll take to solve the problem.
+
+3. **Execute Systematically**: Use your available tools to:
+   - Gather and analyze information
+   - Test hypotheses
+   - Verify results
+   - Document findings
+
+4. **Verify Results**: Always verify your work. Test edge cases, check calculations, and ensure logical soundness.
+
+5. **Document Progress**: Keep clear reasoning about your findings and any obstacles encountered.
+
+## Autonomous Operation
+
+There is no user interacting with you. Never ask for confirmation or approval - proceed autonomously with your plan. Work persistently toward solving the problem, exploring different approaches as needed.
+
+## Problem
+
+{{PROBLEM}}

package/profiles/example/settings.json

@@ -0,0 +1,11 @@
+{
+  "mcpServers": [
+    {
+      "name": "memory",
+      "transport": "stdio",
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-memory"],
+      "enabled": true
+    }
+  ]
+}

package/profiles/example/settings.json.example

@@ -0,0 +1,38 @@
+{
+  "mcpServers": [
+    {
+      "name": "filesystem",
+      "transport": "stdio",
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"],
+      "enabled": true
+    },
+    {
+      "name": "github",
+      "transport": "stdio",
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-github"],
+      "env": {
+        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
+      },
+      "enabled": false
+    },
+    {
+      "name": "brave-search",
+      "transport": "stdio",
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
+      "env": {
+        "BRAVE_API_KEY": "${BRAVE_API_KEY}"
+      },
+      "enabled": false
+    },
+    {
+      "name": "custom-api",
+      "transport": "sse",
+      "url": "https://api.example.com/mcp",
+      "token": "${API_TOKEN}",
+      "enabled": false
+    }
+  ]
+}