executor 1.4.28-windows-x64 → 1.4.28

package/README.md

@@ -0,0 +1,154 @@
+# executor
+
+[https://github.com/user-attachments/assets/11225f83-e848-42ba-99b2-a993bcc88dad](https://github.com/user-attachments/assets/11225f83-e848-42ba-99b2-a993bcc88dad)
+
+The integration layer for AI agents. One catalog for every tool, shared across every agent you use.
+
+[Ask DeepWiki](https://deepwiki.com/RhysSullivan/executor)
+
+## Quick start
+
+```bash
+npm install -g executor
+executor web
+```
+
+This starts a local runtime with a web UI at `http://127.0.0.1:4788`. From there, add your first source and start using tools.
+
+### Use as an MCP server
+
+Point any MCP-compatible agent (Cursor, Claude Code, OpenCode, etc.) at Executor to share your tool catalog, auth, and policies across all of them.
+
+```bash
+
+executor mcp
+```
+
+Example `mcp.json` for Claude Code / Cursor:
+
+```json
+{
+  "mcpServers": {
+    "executor": {
+      "command": "executor",
+      "args": ["mcp"]
+    }
+  }
+}
+```
+
+## Add a source
+
+If you can represent it with a JSON schema, it can be an integration. Executor has first-party support for OpenAPI, GraphQL, MCP, and Google Discovery — but the plugin system is open to any source type.
+
+### Via the web UI
+
+Open `http://127.0.0.1:4788`, go to **Add Source**, paste a URL, and Executor will detect the type, index the tools, and handle auth.
+
+### Via the CLI
+
+```bash
+executor call executor openapi addSource '{
+  "spec": "https://petstore3.swagger.io/api/v3/openapi.json",
+  "namespace": "petstore",
+  "baseUrl": "https://petstore3.swagger.io/api/v3"
+}'
+```
+
+Use `baseUrl` when the OpenAPI document has relative `servers` entries (for example `"/api/v3"`).
+
+## Use tools
+
+Agents discover and call tools through a typed TypeScript runtime:
+
+```ts
+// discover by intent
+const matches = await tools.discover({ query: "github issues", limit: 5 });
+
+// inspect the schema
+const detail = await tools.describe.tool({
+  path: matches.bestPath,
+  includeSchemas: true,
+});
+
+// call with type safety
+const issues = await tools.github.issues.list({
+  owner: "vercel",
+  repo: "next.js",
+});
+```
+
+Use tools via the CLI:
+
+```bash
+executor tools search "send email"
+executor call --help
+executor call github --help
+executor call github issues --help
+executor call cloudflare --help --match dns --limit 20
+executor call github issues create '{"owner":"octocat","repo":"Hello-World","title":"Hi"}'
+executor call gmail send '{"to":"alice@example.com","subject":"Hi"}'
+```
+
+`executor call`, `executor resume`, and `executor tools ...` commands auto-start a local daemon if needed.
+If the default port is busy, the CLI will pick an available local port and track it automatically.
+
+If an execution pauses for auth or approval, resume it:
+
+```bash
+executor resume --execution-id exec_123
+```
+
+## CLI reference
+
+```bash
+executor web                        # start runtime + web UI
+executor daemon run                 # start persistent local daemon in background
+executor daemon status              # show daemon status
+executor daemon stop                # stop daemon
+executor daemon restart             # restart daemon
+executor mcp                        # start MCP endpoint
+executor call <path...> '{"k":"v"}' # invoke a tool by path segments
+executor call <path...> --help      # browse namespaces/resources/methods
+executor call <path...> --help --match "<text>" --limit <n> # narrow huge namespaces
+executor resume --execution-id <id> # resume paused execution
+executor tools search "<query>"     # search tools by intent
+executor tools sources              # list configured sources + tool counts
+executor tools describe <path>      # show tool TypeScript/JSON schema
+```
+
+## Developing locally
+
+```bash
+bun install
+bun dev
+```
+
+The dev server starts at `http://127.0.0.1:4788`.
+
+## Community
+
+Join the Discord: [https://discord.gg/eF29HBHwM6](https://discord.gg/eF29HBHwM6)
+
+## Learn more
+
+Visit [executor.sh](https://executor.sh) to learn more.
+
+## Attribution
+
+- Thank you to [Crystian](https://www.linkedin.com/in/crystian/) for providing the npm package name `executor`.
+
+## References
+
+As part of my coding process, I give my agent access to references to other codebases to understand patterns and how other people have implemented systems.
+
+A non exhaustive list of references are:
+
+- [Better Auth](https://github.com/better-auth/better-auth) - Storage adapter reference
+- [Effect](https://github.com/Effect-TS/effect) - General code patterns
+- [OpenCode](https://github.com/anomalyco/opencode) - Plugin system reference
+- [OpenClaw](https://github.com/openclaw/openclaw) - Plugin system reference
+- [Emdash](https://github.com/emdash-cms/emdash) - Plugin system reference
+- [Pi](https://github.com/badlogic/pi-mono) - Plugin system reference
+
+It's encouraged also that you can use this codebase as a reference to understand how it's implemented

package/bin/executor

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+const childProcess = require("child_process");
+const fs = require("fs");
+const path = require("path");
+const os = require("os");
+
+function spawnAndExit(target) {
+  const child = childProcess.spawn(target, process.argv.slice(2), { stdio: "inherit" });
+  child.on("error", (err) => { console.error(err.message); process.exit(1); });
+  const forward = (signal) => { if (!child.killed) { try { child.kill(signal); } catch {} } };
+  ["SIGINT", "SIGTERM", "SIGHUP"].forEach((sig) => process.on(sig, () => forward(sig)));
+  child.on("exit", (code, signal) => {
+    if (signal) process.kill(process.pid, signal);
+    else process.exit(typeof code === "number" ? code : 0);
+  });
+}
+
+if (process.env.EXECUTOR_BIN_PATH) {
+  spawnAndExit(process.env.EXECUTOR_BIN_PATH);
+  return;
+}
+
+const isWin = process.platform === "win32";
+const binary = isWin ? "executor.exe" : "executor";
+
+// Package names use "windows" (not "win32") to match what the build script emits.
+const platformMap = { darwin: "darwin", linux: "linux", win32: "windows" };
+const archMap = { x64: "x64", arm64: "arm64" };
+const platform = platformMap[os.platform()] || os.platform();
+const arch = archMap[os.arch()] || os.arch();
+
+const isMusl = (() => {
+  if (platform !== "linux") return false;
+  try { if (fs.existsSync("/etc/alpine-release")) return true; } catch {}
+  try {
+    const r = childProcess.spawnSync("ldd", ["--version"], { encoding: "utf8" });
+    if (((r.stdout || "") + (r.stderr || "")).toLowerCase().includes("musl")) return true;
+  } catch {}
+  return false;
+})();
+
+// Candidate package names in preference order. On linux a system might match
+// glibc or musl; try musl first if detected, glibc first otherwise.
+const candidates = (() => {
+  const base = "executor-" + platform + "-" + arch;
+  if (platform === "linux") {
+    return isMusl ? [base + "-musl", base] : [base, base + "-musl"];
+  }
+  return [base];
+})();
+
+function detectPackageManager() {
+  const ua = process.env.npm_config_user_agent || "";
+  if (/\bbun\//.test(ua)) return "bun";
+  const execPath = process.env.npm_execpath || "";
+  if (execPath.includes("bun")) return "bun";
+  if (__dirname.includes(".bun/install/global") || __dirname.includes(".bun\\install\\global")) {
+    return "bun";
+  }
+  return ua ? "npm" : null;
+}
+
+for (const name of candidates) {
+  try {
+    const pkgJson = require.resolve(name + "/package.json");
+    const candidate = path.join(path.dirname(pkgJson), "bin", binary);
+    if (fs.existsSync(candidate)) {
+      spawnAndExit(candidate);
+      return;
+    }
+  } catch {
+    // package not installed for this platform; try next candidate
+  }
+}
+
+// Preview wrapper compat: pkg.pr.new previews download the platform binary
+// to bin/runtime/ rather than via optionalDependencies.
+const scriptDir = path.dirname(fs.realpathSync(__filename));
+const previewBinary = path.join(scriptDir, "runtime", binary);
+if (fs.existsSync(previewBinary)) {
+  spawnAndExit(previewBinary);
+  return;
+}
+
+const pm = detectPackageManager();
+const reinstall = pm === "bun"
+  ? "bun install -g executor"
+  : pm === "npm"
+    ? "npm install -g executor"
+    : "reinstall executor";
+console.error(
+  "executor: could not locate a platform binary for " + os.platform() + "-" + os.arch() + ".\n" +
+    "Tried optionalDependencies: " + candidates.map((n) => '"' + n + '"').join(", ") + "\n" +
+    "To fix: " + reinstall
+);
+process.exit(1);

package/package.json

@@ -1,12 +1,14 @@
 {
   "name": "executor",
-  "version": "1.4.28-windows-x64",
-  "description": "Local AI executor with a CLI, local API server, and web UI. (windows-x64)",
-  "os": [
-    "win32"
-  ],
-  "cpu": [
-    "x64"
+  "version": "1.4.28",
+  "description": "Local AI executor with a CLI, local API server, and web UI.",
+  "keywords": [
+    "agent",
+    "ai",
+    "automation",
+    "cli",
+    "executor",
+    "local-first"
   ],
   "homepage": "https://github.com/RhysSullivan/executor",
   "bugs": {
@@ -16,5 +18,21 @@
     "type": "git",
     "url": "git+https://github.com/RhysSullivan/executor.git"
   },
-  "license": "MIT"
+  "license": "MIT",
+  "bin": {
+    "executor": "bin/executor"
+  },
+  "optionalDependencies": {
+    "executor-linux-x64": "npm:executor@1.4.28-linux-x64",
+    "executor-linux-arm64": "npm:executor@1.4.28-linux-arm64",
+    "executor-linux-x64-musl": "npm:executor@1.4.28-linux-x64-musl",
+    "executor-linux-arm64-musl": "npm:executor@1.4.28-linux-arm64-musl",
+    "executor-darwin-x64": "npm:executor@1.4.28-darwin-x64",
+    "executor-darwin-arm64": "npm:executor@1.4.28-darwin-arm64",
+    "executor-windows-x64": "npm:executor@1.4.28-windows-x64",
+    "executor-windows-arm64": "npm:executor@1.4.28-windows-arm64"
+  },
+  "engines": {
+    "node": ">=20"
+  }
 }