@trygentic/agentloop 0.1.1-alpha.3 → 0.4.0-alpha.5

package/LICENSE

@@ -1,6 +1,6 @@
 **Commercial License Agreement**
 Software: AgentLoop
-Copyright © Troy Edwards Jr, All Rights Reserved
+Copyright © Trygentic, Inc., All Rights Reserved
 
 This Software is licensed, not sold.
 

package/README.md

@@ -44,6 +44,20 @@ npm install @trygentic/agentloop
 npx @trygentic/agentloop
 ```
 
+### Development Setup
+
+```bash
+# Clone with submodule
+git clone --recursive https://github.com/trygentic/agentloop
+
+# Or if already cloned
+git submodule update --init --recursive
+
+# Install and build
+npm install
+npm run build
+```
+
 ## Quick Start
 
 ```bash
@@ -418,33 +432,33 @@ The AgentLoop daemon allows you to run the orchestrator as a persistent backgrou
 
 ## Configuration
 
-AgentLoop uses TOML configuration files with a layered priority system.
+AgentLoop uses YAML configuration files with a layered priority system.
 
 ### Configuration File Locations
 
 | Location | Purpose |
 |----------|---------|
-| `./.agentloop/config.toml` | Project-level config (local overrides) |
-| `~/.config/agentloop/config.toml` | User-level config (global defaults) |
+| `./.agentloop/config.yaml` | Project-level config (local overrides) |
+| `~/.config/agentloop/config.yaml` | User-level config (global defaults) |
 | `~/.config/agentloop/` | Database, credentials, and cache |
 
 ### Configuration Priority (Highest to Lowest)
 
 1. Environment variables
-2. Project config (`./.agentloop/config.toml`)
-3. User config (`~/.config/agentloop/config.toml`)
+2. Project config (`./.agentloop/config.yaml`)
+3. User config (`~/.config/agentloop/config.yaml`)
 4. Default values
 
 ---
 
 ### Orchestrator Settings
 
-```toml
-[orchestrator]
-max_parallel_agents = 1        # Number of agents that can run in parallel
-use_worktrees = false          # Enable git worktrees for parallel development
-worktrees_dir = ".worktrees"   # Directory for worktrees (relative to project)
-cleanup_worktrees_on_complete = false  # Auto-cleanup worktrees after completion
+```yaml
+orchestrator:
+  max_parallel_agents: 1        # Number of agents that can run in parallel
+  use_worktrees: false          # Enable git worktrees for parallel development
+  worktrees_dir: ".worktrees"   # Directory for worktrees (relative to project)
+  cleanup_worktrees_on_complete: false  # Auto-cleanup worktrees after completion
 ```
 
 | Option | Default | Env Variable | Description |
@@ -458,19 +472,19 @@ cleanup_worktrees_on_complete = false  # Auto-cleanup worktrees after completion
 
 ### Container Sandbox Settings
 
-```toml
-[orchestrator.container_sandbox]
-enabled = false                    # Enable Podman sandboxing
-container_image = "agentloop-worker"
-network_mode = "slirp4netns"       # none, slirp4netns, or host
-memory_limit = "4g"
-cpu_limit = "2"
-
-[orchestrator.container_sandbox.agent_images]
-engineer = "agentloop-worker"
-qa-tester = "agentloop-qa-worker"
-analyzer = "agentloop-worker"
-product-manager = "agentloop-worker"
+```yaml
+orchestrator:
+  container_sandbox:
+    enabled: false                    # Enable Podman sandboxing
+    container_image: "agentloop-worker"
+    network_mode: "slirp4netns"       # none, slirp4netns, or host
+    memory_limit: "4g"
+    cpu_limit: "2"
+    agent_images:
+      engineer: "agentloop-worker"
+      qa-tester: "agentloop-qa-worker"
+      analyzer: "agentloop-worker"
+      product-manager: "agentloop-worker"
 ```
 
 | Option | Default | Description |
@@ -485,10 +499,10 @@ product-manager = "agentloop-worker"
 
 ### GitHub Settings
 
-```toml
-[github]
-enabled = true
-token = "ghp_your_token_here"   # Or use GITHUB_PERSONAL_ACCESS_TOKEN env var
+```yaml
+github:
+  enabled: true
+  token: "ghp_your_token_here"   # Or use GITHUB_PERSONAL_ACCESS_TOKEN env var
 ```
 
 | Option | Default | Env Variable | Description |
@@ -500,19 +514,19 @@ token = "ghp_your_token_here"   # Or use GITHUB_PERSONAL_ACCESS_TOKEN env var
 
 ### Jira Settings
 
-```toml
-[jira]
-siteUrl = "https://yourcompany.atlassian.net"
-project = "PROJ"
-boardId = "123"
+```yaml
+jira:
+  siteUrl: "https://yourcompany.atlassian.net"
+  project: "PROJ"
+  boardId: "123"
 
-# Basic Auth (simpler)
-email = "user@example.com"
-apiToken = "your_api_token"
+  # Basic Auth (simpler)
+  email: "user@example.com"
+  apiToken: "your_api_token"
 
-# Or OAuth (more secure) - set via /jira set-oauth command
-# clientId = "your_oauth_client_id"
-# clientSecret = "your_oauth_client_secret"
+  # Or OAuth (more secure) - set via /jira set-oauth command
+  # clientId: "your_oauth_client_id"
+  # clientSecret: "your_oauth_client_secret"
 ```
 
 | Option | Description |
@@ -527,29 +541,28 @@ apiToken = "your_api_token"
 
 ### Example Configuration
 
-**User-level defaults** (`~/.config/agentloop/config.toml`):
-```toml
-[github]
-enabled = true
+**User-level defaults** (`~/.config/agentloop/config.yaml`):
+```yaml
+github:
+  enabled: true
 
-[orchestrator]
-max_parallel_agents = 4
-use_worktrees = true
+orchestrator:
+  max_parallel_agents: 4
+  use_worktrees: true
 ```
 
-**Project-level overrides** (`./.agentloop/config.toml`):
-```toml
-[orchestrator]
-max_parallel_agents = 10
-
-[orchestrator.container_sandbox]
-enabled = true
-network_mode = "slirp4netns"
-
-[jira]
-siteUrl = "https://company.atlassian.net"
-project = "MYPROJ"
-boardId = "42"
+**Project-level overrides** (`./.agentloop/config.yaml`):
+```yaml
+orchestrator:
+  max_parallel_agents: 10
+  container_sandbox:
+    enabled: true
+    network_mode: "slirp4netns"
+
+jira:
+  siteUrl: "https://company.atlassian.net"
+  project: "MYPROJ"
+  boardId: "42"
 ```
 
 ---
@@ -595,6 +608,112 @@ agentloop config
 - npm or yarn
 - Podman (optional, for container sandboxing)
 
+## Architecture
+
+AgentLoop uses [OpenCode](https://github.com/anthropics/opencode) as a git submodule for:
+
+- **Tool System** (`@opencode/tool/`): Built-in tools (bash, read, write, edit, grep, glob, etc.)
+- **LLM Abstraction** (`@opencode/session/llm`): Vercel AI SDK integration with streaming support
+- **Provider Management** (`@opencode/provider/`): 18+ bundled AI SDK providers
+
+### Core Technologies
+
+- **OCLIF**: CLI framework for command-line interface
+- **OpenTUI**: Terminal UI framework (React-like components)
+- **Better SQLite3**: Local database for state management
+- **MCP (Model Context Protocol)**: Extensible tool system
+
+### Supported Providers
+
+All providers supported by OpenCode (via Vercel AI SDK):
+- **Anthropic** - Claude 4, Claude Sonnet, Claude Haiku
+- **OpenAI** - GPT-4o, o1, o3
+- **Google** - Gemini Pro, Gemini Flash
+- **xAI** - Grok
+- **DeepSeek** - DeepSeek Chat, DeepSeek Coder
+- **OpenCode Zen** - Free tier for getting started
+- And many more through OpenRouter
+
+
+## MCP Servers
+
+AgentLoop integrates with various Model Context Protocol (MCP) servers to enhance agent capabilities:
+
+### Configured MCP Servers
+
+| Server | Description | Tools |
+|--------|-------------|-------|
+| **serena** | Code editing and codebase traversal | File operations, symbol manipulation, code generation |
+| **code-graph-rag** | Semantic code analysis with RAG | 24 tools for code search, similarity detection, impact analysis |
+| **playwright** | Browser automation and testing | Web scraping, UI testing, interaction automation |
+| **supabase** | Database operations | SQL execution, migrations, schema management |
+| **mcp-atlassian** | Jira integration | Issue tracking, project management |
+| **agentloop-debug** | Internal debugging tools | Task management, agent coordination |
+
+### Code Graph RAG MCP
+
+The **code-graph-rag-mcp** server provides advanced semantic code analysis:
+
+- **Semantic Search**: Find code by meaning, not just keywords
+- **Code Similarity**: Detect duplicate code and similar patterns
+- **Impact Analysis**: Assess the impact of potential changes
+- **Performance**: 5.5x faster than traditional file-based search
+- **Languages**: Supports TypeScript, JavaScript, Python, Java, Go, Rust, C++, C#, Ruby, PHP
+
+**Requirements**: Node.js 18+, 2GB RAM minimum (8GB recommended)
+
+For detailed information, see [docs/mcp/CODE_GRAPH_RAG_MCP.md](./docs/mcp/CODE_GRAPH_RAG_MCP.md)
+
+### Configuring MCP Servers
+
+MCP servers are configured in `.mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "code-graph-rag": {
+      "command": "npx",
+      "args": ["-y", "@er77/code-graph-rag-mcp", "/work"],
+      "env": {
+        "MCP_SEMANTIC_WARMUP_LIMIT": "1000"
+      }
+    }
+  }
+}
+```
+
+For more MCP integration examples, see [docs/mcp/GITHUB_MCP_INTEGRATION.md](./docs/mcp/GITHUB_MCP_INTEGRATION.md)
+
+
+
+## Templates
+
+Built-in agent templates are distributed as part of the npm package in the `.claude/agents/` directory. When you install AgentLoop, these templates are automatically available and loaded by the agent system.
+
+## Migration Notes
+
+This project recently migrated from a Single Executable Application (SEA) binary distribution to a standard npm package. See [docs/SEA_MIGRATION.md](./docs/SEA_MIGRATION.md) for details about the changes and benefits.
+
+## Contributing
+
+Contributions are welcome! Please ensure:
+
+1. Code follows the existing style (run `npm run format`)
+2. TypeScript compiles without errors (`npm run typecheck`)
+3. Linting passes (`npm run lint`)
+4. Tests pass (`npm test`)
+
+## Additional Documentation
+
+For more detailed information about specific features:
+
+- **[Architecture Overview](docs/architecture/overview.md)**: OpenCode integration and system architecture
+- **[Project-Scoped Tasks](docs/PROJECT_SCOPED_TASKS.md)**: How tasks are isolated by project directory
+- **[Project Metadata](docs/PROJECT_METADATA.md)**: Understanding project_name and project_id fields for remote syncing
+- **[Authentication](docs/auth/IMPLEMENTATION.md)**: Authentication flow and credential management
+- **[Mixpanel Integration](docs/MIXPANEL_IMPLEMENTATION.md)**: Telemetry and analytics
+- **[Other Documentation](docs/)**: Additional implementation details and guides
+
 ## License
 
 See [License](./license)

package/bin/agentloop

@@ -0,0 +1,83 @@
+#!/usr/bin/env node
+
+/**
+ * AgentLoop npm shim
+ *
+ * This thin wrapper finds and executes the platform-specific binary.
+ * The binary is installed via optionalDependencies during npm install.
+ */
+
+import { execSync, spawn } from "child_process";
+import fs from "fs";
+import os from "os";
+import path from "path";
+import { fileURLToPath } from "url";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+function isMusl() {
+  if (os.platform() !== "linux") return false;
+  try {
+    const output = execSync("ldd --version 2>&1", { encoding: "utf8" });
+    return output.includes("musl");
+  } catch {
+    try {
+      const release = fs.readFileSync("/etc/os-release", "utf8");
+      return release.includes("Alpine");
+    } catch {
+      return false;
+    }
+  }
+}
+
+function findBinary() {
+  const platform = os.platform() === "win32" ? "windows" : os.platform();
+  const arch = os.arch() === "arm64" ? "arm64" : "x64";
+  const suffix = isMusl() ? "-musl" : "";
+  const packageName = `@trygentic/agentloop-${platform}-${arch}${suffix}`;
+  const executableName = platform === "windows" ? "agentloop-cli.exe" : "agentloop-cli";
+
+  // Check for symlinked binary in same directory (created by postinstall)
+  const localBinary = path.join(__dirname, executableName);
+  if (fs.existsSync(localBinary)) {
+    return localBinary;
+  }
+
+  // Find in node_modules
+  const nodeModules = path.resolve(__dirname, "..", "node_modules");
+  const packageBinary = path.join(nodeModules, packageName, "bin", executableName);
+  if (fs.existsSync(packageBinary)) {
+    return packageBinary;
+  }
+
+  // Try global node_modules
+  const globalNodeModules = path.resolve(__dirname, "..", "..", "..");
+  const globalBinary = path.join(globalNodeModules, packageName, "bin", executableName);
+  if (fs.existsSync(globalBinary)) {
+    return globalBinary;
+  }
+
+  console.error(`Error: Could not find agentloop binary for ${platform}-${arch}${suffix}`);
+  console.error(`Expected package: ${packageName}`);
+  console.error(`\nTry reinstalling: npm install -g @trygentic/agentloop`);
+  process.exit(1);
+}
+
+const binary = findBinary();
+const child = spawn(binary, process.argv.slice(2), {
+  stdio: "inherit",
+  env: process.env,
+});
+
+child.on("error", (err) => {
+  console.error(`Failed to start agentloop: ${err.message}`);
+  process.exit(1);
+});
+
+child.on("exit", (code, signal) => {
+  if (signal) {
+    process.kill(process.pid, signal);
+  } else {
+    process.exit(code ?? 0);
+  }
+});

package/package.json

@@ -1,96 +1,28 @@
 {
   "name": "@trygentic/agentloop",
-  "version": "0.1.1-alpha.3",
-  "description": "An autonomous agent orchestrator abstraction over Claude Code",
-  "author": "trygentic.ai",
-  "license": "SEE LICENSE IN LICENSE",
-  "main": "dist-obfuscated/index.js",
-  "type": "module",
+  "version": "0.4.0-alpha.5",
+  "description": "AI-powered autonomous coding agent",
   "bin": {
-    "agentloop": "./bin/run.js"
+    "agentloop": "./bin/agentloop"
   },
   "scripts": {
-    "build:agents": "node --loader ts-node/esm scripts/build-agents.ts",
-    "prebuild": "npm run build:agents",
-    "build": "tsc",
-    "bundle": "node scripts/bundle.cjs",
-    "build:bundled": "npm run build && npm run bundle",
-    "build:obfuscated": "npm run build:bundled && npm run obfuscate",
-    "build:obfuscated:prod": "npm run build:obfuscated && npm run upload-sourcemaps",
-    "obfuscate": "node scripts/obfuscate.cjs",
-    "upload-sourcemaps": "node scripts/upload-sourcemaps.cjs",
-    "dev": "tsc --watch",
-    "clean": "rm -rf dist dist-bundled *.tsbuildinfo",
-    "start": "node --loader ts-node/esm ./bin/run.js",
-    "typecheck": "tsc --noEmit",
-    "lint": "eslint src --ext .ts,.tsx",
-    "format": "prettier --write \"src/**/*.{ts,tsx}\"",
-    "reset-mock": "npm run build && node --loader ts-node/esm scripts/reset-mock.ts",
-    "clear-mock": "npm run build && node --loader ts-node/esm scripts/clear-mock.ts",
-    "prepare": "lefthook install",
-    "prepublishOnly": "npm run verify-no-sourcemaps",
-    "verify-no-sourcemaps": "node scripts/verify-no-sourcemaps.cjs"
+    "postinstall": "node ./scripts/postinstall.mjs"
   },
-  "dependencies": {
-    "@anthropic-ai/claude-agent-sdk": "0.1.14",
-    "@oclif/core": "^3.15.1",
-    "@sentry/node": "^10.23.0",
-    "@ts-dag/builder": "^0.1.0-alpha.6",
-    "@ts-dag/visualizer": "^0.1.0-alpha.1",
-    "@types/better-sqlite3": "^7.6.13",
-    "@types/nunjucks": "^3.2.6",
-    "better-sqlite3": "^12.4.1",
-    "chalk": "^5.6.2",
-    "conf": "^15.0.2",
-    "dotenv": "^17.2.3",
-    "ink": "^5.2.1",
-    "ink-spinner": "^5.0.0",
-    "ink-text-input": "^6.0.0",
-    "mistreevous": "^4.3.1",
-    "mixpanel": "^0.18.1",
-    "node-machine-id": "^1.1.12",
-    "nunjucks": "^3.2.4",
-    "open": "^9.1.0",
-    "react": "^18.2.0",
-    "smol-toml": "^1.5.2",
-    "zod": "^3.25.76"
+  "optionalDependencies": {
+    "@trygentic/agentloop-darwin-arm64": "0.4.0-alpha.5",
+    "@trygentic/agentloop-darwin-x64": "0.4.0-alpha.5",
+    "@trygentic/agentloop-linux-arm64": "0.4.0-alpha.5",
+    "@trygentic/agentloop-linux-x64": "0.4.0-alpha.5",
+    "@trygentic/agentloop-linux-x64-musl": "0.4.0-alpha.5",
+    "@trygentic/agentloop-linux-arm64-musl": "0.4.0-alpha.5",
+    "@trygentic/agentloop-windows-x64": "0.4.0-alpha.5"
   },
-  "devDependencies": {
-    "@modelcontextprotocol/sdk": "^1.23.0",
-    "@sentry/cli": "^2.40.0",
-    "@types/node": "^20.10.6",
-    "@types/react": "^18.2.46",
-    "@typescript-eslint/eslint-plugin": "^6.17.0",
-    "@typescript-eslint/parser": "^6.17.0",
-    "esbuild": "^0.27.0",
-    "eslint": "^8.56.0",
-    "glob": "^11.0.3",
-    "javascript-obfuscator": "^4.1.1",
-    "lefthook": "^1.10.1",
-    "prettier": "^3.1.1",
-    "ts-node": "^10.9.2",
-    "typescript": ">=4.3.5 <5.4.0"
-  },
-  "files": [
-    "dist-obfuscated/**/*",
-    "!dist-obfuscated/**/*.ts",
-    "!dist-obfuscated/**/*.d.ts",
-    "!dist-obfuscated/**/*.map",
-    "bin/**/*",
-    "README.md",
-    "LICENSE"
-  ],
   "engines": {
     "node": ">=18.0.0"
   },
-  "oclif": {
-    "bin": "agentloop",
-    "dirname": "agentloop",
-    "commands": "./dist-obfuscated/commands",
-    "topicSeparator": " ",
-    "topics": {},
-    "hooks": {
-      "prerun": "./dist-obfuscated/hooks/prerun/check-auth.js"
-    }
-  }
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/trygentic/agentloop"
+  },
+  "license": "SEE LICENSE IN LICENSE"
 }

package/scripts/postinstall.mjs

@@ -0,0 +1,82 @@
+#!/usr/bin/env node
+
+/**
+ * AgentLoop postinstall script
+ *
+ * Creates symlinks from the main package's bin to the platform executables
+ * for faster execution (avoids the Node.js shim overhead).
+ *
+ * If symlink creation fails (e.g., on Windows), the shim will handle
+ * executable discovery at runtime.
+ */
+
+import fs from "fs";
+import os from "os";
+import path from "path";
+import { fileURLToPath } from "url";
+import { execSync } from "child_process";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+const platform = os.platform() === "win32" ? "windows" : os.platform();
+const arch = os.arch() === "arm64" ? "arm64" : "x64";
+
+// For Linux, detect musl vs glibc
+function isMusl() {
+  if (platform !== "linux") return false;
+  try {
+    const output = execSync("ldd --version 2>&1", { encoding: "utf8" });
+    return output.includes("musl");
+  } catch {
+    try {
+      const release = fs.readFileSync("/etc/os-release", "utf8");
+      return release.includes("Alpine");
+    } catch {
+      return false;
+    }
+  }
+}
+
+const suffix = isMusl() ? "-musl" : "";
+const packageName = `@trygentic/agentloop-${platform}-${arch}${suffix}`;
+const ext = platform === "windows" ? ".exe" : "";
+
+// Binaries to link
+const binaries = ["agentloop", "agentloop-daemon"];
+
+// Find the platform-specific package
+const nodeModules = path.resolve(__dirname, "..", "node_modules");
+const binDir = path.join(__dirname, "..", "bin");
+
+let linked = 0;
+for (const binary of binaries) {
+  const executableName = `${binary}${ext}`;
+  const sourcePath = path.join(nodeModules, packageName, "bin", executableName);
+  const targetPath = path.join(binDir, executableName);
+
+  if (fs.existsSync(sourcePath)) {
+    try {
+      // Remove existing file/symlink
+      if (fs.existsSync(targetPath)) {
+        fs.unlinkSync(targetPath);
+      }
+
+      // Create symlink (Unix) or copy (Windows)
+      if (platform === "windows") {
+        fs.copyFileSync(sourcePath, targetPath);
+      } else {
+        fs.symlinkSync(sourcePath, targetPath);
+      }
+      linked++;
+    } catch {
+      // Symlink failed, shim will handle at runtime
+    }
+  }
+}
+
+if (linked > 0) {
+  console.log(`agentloop: linked ${linked} executable(s) for ${platform}-${arch}${suffix}`);
+} else {
+  console.log(`agentloop: platform executables not found (${packageName})`);
+  console.log("agentloop: will use runtime executable resolution");
+}

package/bin/dev.js

@@ -1,55 +0,0 @@
-#!/usr/bin/env node
-import "dotenv/config";
-try {
-  await import("../dist/instrument.js");
-} catch (error) {
-}
-import { execute } from "@oclif/core";
-import { readFileSync, writeFileSync } from "fs";
-import { dirname, join } from "path";
-import { fileURLToPath } from "url";
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const packageJsonPath = join(__dirname, "..", "package.json");
-const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
-if (packageJson.oclif) {
-  if (packageJson.oclif.commands) {
-    packageJson.oclif.commands = packageJson.oclif.commands.replace("dist-obfuscated", "dist");
-  }
-  if (packageJson.oclif.hooks) {
-    Object.keys(packageJson.oclif.hooks).forEach((hookName) => {
-      const hookValue = packageJson.oclif.hooks[hookName];
-      if (typeof hookValue === "string") {
-        packageJson.oclif.hooks[hookName] = hookValue.replace("dist-obfuscated", "dist");
-      }
-    });
-  }
-}
-const manifestPath = join(__dirname, "..", "oclif.manifest.json");
-let manifestModified = false;
-try {
-  const manifest = JSON.parse(readFileSync(manifestPath, "utf-8"));
-  if (manifest.commands) {
-    Object.keys(manifest.commands).forEach((commandId) => {
-      const command = manifest.commands[commandId];
-      if (command.relativePath && Array.isArray(command.relativePath)) {
-        const originalPath = [...command.relativePath];
-        command.relativePath = command.relativePath.map(
-          (path) => path === "dist-obfuscated" ? "dist" : path
-        );
-        if (JSON.stringify(originalPath) !== JSON.stringify(command.relativePath)) {
-          manifestModified = true;
-        }
-      }
-    });
-  }
-  if (manifestModified) {
-    writeFileSync(manifestPath, JSON.stringify(manifest, null, 2) + "\n", "utf-8");
-  }
-} catch (error) {
-}
-await execute({
-  development: false,
-  // Use false to avoid src/ directory loading
-  dir: import.meta.url,
-  loadOptions: { root: join(__dirname, ".."), pjson: packageJson }
-});