@michaelhartmayer/agentctl 1.1.0 → 1.1.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/skills.js CHANGED
@@ -5,35 +5,23 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
5
5
  Object.defineProperty(exports, "__esModule", { value: true });
6
6
  exports.SUPPORTED_AGENTS = void 0;
7
7
  exports.copySkill = copySkill;
8
- const path_1 = __importDefault(require("path"));
9
8
  const fs_extra_1 = __importDefault(require("fs-extra"));
9
+ const skills_1 = require("./logic/skills");
10
10
  exports.SUPPORTED_AGENTS = ['cursor', 'antigravity', 'agentsmd', 'gemini'];
11
11
  async function copySkill(targetDir, agent) {
12
- // We assume the skill file is located at ../skills/agentctl/SKILL.md relative to specific dist/src/ location
13
- // Or we find it in the project root if running from source.
14
- // In production (dist), structure might be:
15
- // dist/index.js
16
- // skills/agentctl/SKILL.md (if we copy it to dist)
17
- // Let's try to locate the source SKILL.md
18
- // If we are in /src, it is in ../skills/agentctl/SKILL.md
19
- // If we are in /dist/src (tsc default?), it depends on build.
20
- // Robust finding:
21
- let sourcePath = path_1.default.resolve(__dirname, '../../skills/agentctl/SKILL.md');
22
- if (!fs_extra_1.default.existsSync(sourcePath)) {
23
- // Try looking in src check (dev mode)
24
- sourcePath = path_1.default.resolve(__dirname, '../skills/agentctl/SKILL.md');
12
+ const sources = skills_1.SkillsLogic.getSourcePaths({ dirname: __dirname });
13
+ let sourcePath = null;
14
+ for (const p of sources) {
15
+ if (fs_extra_1.default.existsSync(p)) {
16
+ sourcePath = p;
17
+ break;
18
+ }
25
19
  }
26
- if (!fs_extra_1.default.existsSync(sourcePath)) {
27
- // Fallback for when running from dist/src
28
- sourcePath = path_1.default.resolve(__dirname, '../../../skills/agentctl/SKILL.md');
29
- }
30
- if (!fs_extra_1.default.existsSync(sourcePath)) {
31
- throw new Error(`Could not locate source SKILL.md. Checked: ${path_1.default.resolve(__dirname, '../../skills/agentctl/SKILL.md')}`);
20
+ if (!sourcePath) {
21
+ throw new Error(`Could not locate source SKILL.md. Checked: ${sources[0]}`);
32
22
  }
33
23
  await fs_extra_1.default.ensureDir(targetDir);
34
- // Determine filename
35
- const filename = agent === 'cursor' ? 'agentctl.md' : 'SKILL.md';
36
- const targetFile = path_1.default.join(targetDir, filename);
24
+ const targetFile = skills_1.SkillsLogic.getTargetPath(targetDir, agent);
37
25
  await fs_extra_1.default.copy(sourcePath, targetFile, { overwrite: true });
38
26
  return targetFile;
39
27
  }
package/package.json CHANGED
@@ -4,7 +4,7 @@
4
4
  "access": "public"
5
5
  },
6
6
  "description": "Agent Controller - A unified interface for humans and AI agents",
7
- "version": "1.1.0",
7
+ "version": "1.1.4",
8
8
  "main": "dist/index.js",
9
9
  "bin": {
10
10
  "agentctl": "./dist/index.js"
package/dist/package.json DELETED
@@ -1,60 +0,0 @@
1
- {
2
- "name": "@michaelhartmayer/agentctl",
3
- "publishConfig": {
4
- "access": "public"
5
- },
6
- "description": "Agent Controller - A unified interface for humans and AI agents",
7
- "version": "1.1.0",
8
- "main": "dist/index.js",
9
- "bin": {
10
- "agentctl": "./dist/index.js"
11
- },
12
- "files": [
13
- "dist",
14
- "skills",
15
- "scripts",
16
- "agentctl.cmd",
17
- "README.md"
18
- ],
19
- "scripts": {
20
- "build": "tsc",
21
- "test": "vitest run",
22
- "test:watch": "vitest",
23
- "lint": "eslint src tests",
24
- "register:path": "node scripts/register-path.js",
25
- "unregister:path": "node scripts/unregister-path.js",
26
- "release": "standard-version",
27
- "prepublishOnly": "npm run build && npm run test",
28
- "prepare": "husky"
29
- },
30
- "keywords": [
31
- "cli",
32
- "agent",
33
- "ai",
34
- "automation",
35
- "framework"
36
- ],
37
- "author": "Michael Hartmayer",
38
- "license": "MIT",
39
- "dependencies": {
40
- "chalk": "^4.1.2",
41
- "commander": "^14.0.3",
42
- "fs-extra": "^11.3.3"
43
- },
44
- "devDependencies": {
45
- "@commitlint/cli": "^20.4.1",
46
- "@commitlint/config-conventional": "^20.4.1",
47
- "@types/fs-extra": "^11.0.4",
48
- "@types/node": "^25.2.3",
49
- "@typescript-eslint/eslint-plugin": "^8.55.0",
50
- "@typescript-eslint/parser": "^8.55.0",
51
- "@vitest/coverage-v8": "^4.0.18",
52
- "eslint": "^8.57.1",
53
- "eslint-plugin-eslint-comments": "^3.2.0",
54
- "husky": "^9.1.7",
55
- "standard-version": "^9.5.0",
56
- "ts-node": "^10.9.2",
57
- "typescript": "^5.9.3",
58
- "vitest": "^4.0.18"
59
- }
60
- }
package/dist/src/ctl.js DELETED
@@ -1,316 +0,0 @@
1
- "use strict";
2
- var __importDefault = (this && this.__importDefault) || function (mod) {
3
- return (mod && mod.__esModule) ? mod : { "default": mod };
4
- };
5
- Object.defineProperty(exports, "__esModule", { value: true });
6
- exports.scaffold = scaffold;
7
- exports.alias = alias;
8
- exports.group = group;
9
- exports.pushGlobal = pushGlobal;
10
- exports.pullLocal = pullLocal;
11
- exports.installSkill = installSkill;
12
- exports.rm = rm;
13
- exports.mv = mv;
14
- exports.inspect = inspect;
15
- exports.list = list;
16
- const fs_extra_1 = __importDefault(require("fs-extra"));
17
- const path_1 = __importDefault(require("path"));
18
- const resolve_1 = require("./resolve");
19
- const fs_utils_1 = require("./fs-utils");
20
- const manifest_1 = require("./manifest");
21
- async function scaffold(args, options = {}) {
22
- const { targetDir, name, isWin } = await prepareCommand(args, options);
23
- const scriptName = isWin ? 'command.cmd' : 'command.sh';
24
- const scriptPath = path_1.default.join(targetDir, scriptName);
25
- const scriptContent = isWin
26
- ? '@echo off\r\nREM Add your command logic here\r\necho Not implemented'
27
- : '#!/usr/bin/env bash\n# Add your command logic here\necho "Not implemented"';
28
- await fs_extra_1.default.writeFile(scriptPath, scriptContent);
29
- if (!isWin)
30
- await fs_extra_1.default.chmod(scriptPath, 0o755);
31
- const manifest = {
32
- name,
33
- description: '',
34
- type: 'scaffold',
35
- run: `./${scriptName}`,
36
- };
37
- await fs_extra_1.default.writeJson(path_1.default.join(targetDir, 'manifest.json'), manifest, { spaces: 2 });
38
- console.log(`Scaffolded command: ${args.join(' ')}`);
39
- }
40
- async function alias(args, target, options = {}) {
41
- const { targetDir, name } = await prepareCommand(args, options);
42
- const manifest = {
43
- name,
44
- description: '',
45
- type: 'alias',
46
- run: target,
47
- };
48
- await fs_extra_1.default.writeJson(path_1.default.join(targetDir, 'manifest.json'), manifest, { spaces: 2 });
49
- console.log(`Aliased command: ${args.join(' ')} -> ${target}`);
50
- }
51
- async function group(args, options = {}) {
52
- const { targetDir, name } = await prepareCommand(args, options);
53
- const manifest = {
54
- name,
55
- description: '',
56
- type: 'group',
57
- };
58
- await fs_extra_1.default.writeJson(path_1.default.join(targetDir, 'manifest.json'), manifest, { spaces: 2 });
59
- console.log(`Created group: ${args.join(' ')}`);
60
- }
61
- async function pushGlobal(args, options = {}) {
62
- const cwd = options.cwd || process.cwd();
63
- const localRoot = (0, fs_utils_1.findLocalRoot)(cwd);
64
- if (!localRoot)
65
- throw new Error('Not in a local context');
66
- const globalRoot = options.globalDir || (0, fs_utils_1.getGlobalRoot)();
67
- const localAgentctl = path_1.default.join(localRoot, '.agentctl');
68
- const cmdPathStr = args.join(path_1.default.sep);
69
- const srcDir = path_1.default.join(localAgentctl, cmdPathStr);
70
- if (!await fs_extra_1.default.pathExists(srcDir)) {
71
- throw new Error(`Local command ${args.join(' ')} not found`);
72
- }
73
- const destDir = path_1.default.join(globalRoot, cmdPathStr);
74
- if (await fs_extra_1.default.pathExists(destDir)) {
75
- throw new Error(`Global command ${args.join(' ')} already exists`);
76
- }
77
- await fs_extra_1.default.ensureDir(path_1.default.dirname(destDir));
78
- if (options.move) {
79
- await fs_extra_1.default.move(srcDir, destDir);
80
- console.log(`Moved ${args.join(' ')} to global scope`);
81
- }
82
- else {
83
- await fs_extra_1.default.copy(srcDir, destDir);
84
- console.log(`Copied ${args.join(' ')} to global scope`);
85
- }
86
- }
87
- async function pullLocal(args, options = {}) {
88
- const cwd = options.cwd || process.cwd();
89
- const localRoot = (0, fs_utils_1.findLocalRoot)(cwd);
90
- if (!localRoot)
91
- throw new Error('Not in a local context');
92
- const globalRoot = options.globalDir || (0, fs_utils_1.getGlobalRoot)();
93
- const cmdPathStr = args.join(path_1.default.sep);
94
- const srcDir = path_1.default.join(globalRoot, cmdPathStr);
95
- if (!await fs_extra_1.default.pathExists(srcDir)) {
96
- throw new Error(`Global command ${args.join(' ')} not found`);
97
- }
98
- const localAgentctl = path_1.default.join(localRoot, '.agentctl');
99
- const destDir = path_1.default.join(localAgentctl, cmdPathStr);
100
- if (await fs_extra_1.default.pathExists(destDir)) {
101
- throw new Error(`Local command ${args.join(' ')} already exists`);
102
- }
103
- await fs_extra_1.default.ensureDir(path_1.default.dirname(destDir));
104
- if (options.move) {
105
- await fs_extra_1.default.move(srcDir, destDir);
106
- console.log(`Moved ${args.join(' ')} to local scope`);
107
- }
108
- else {
109
- await fs_extra_1.default.copy(srcDir, destDir);
110
- console.log(`Copied ${args.join(' ')} to local scope`);
111
- }
112
- }
113
- const skills_1 = require("./skills");
114
- async function installSkill(agent, options = {}) {
115
- const cwd = options.cwd || process.cwd();
116
- if (!skills_1.SUPPORTED_AGENTS.includes(agent)) {
117
- throw new Error(`Agent '${agent}' not supported. Supported agents: ${skills_1.SUPPORTED_AGENTS.join(', ')}`);
118
- }
119
- let targetDir;
120
- if (agent === 'cursor') {
121
- targetDir = path_1.default.join(cwd, '.cursor', 'skills');
122
- }
123
- else if (agent === 'antigravity') {
124
- if (options.global) {
125
- const globalRoot = options.antigravityGlobalDir || (0, fs_utils_1.getAntigravityGlobalRoot)();
126
- targetDir = path_1.default.join(globalRoot, 'skills', 'agentctl');
127
- }
128
- else {
129
- targetDir = path_1.default.join(cwd, '.agent', 'skills', 'agentctl');
130
- }
131
- }
132
- else if (agent === 'agentsmd') {
133
- targetDir = path_1.default.join(cwd, '.agents', 'skills', 'agentctl');
134
- }
135
- else if (agent === 'gemini') {
136
- if (options.global) {
137
- const globalRoot = options.geminiGlobalDir || path_1.default.join(process.env.HOME || process.env.USERPROFILE, '.gemini');
138
- targetDir = path_1.default.join(globalRoot, 'skills', 'agentctl');
139
- }
140
- else {
141
- targetDir = path_1.default.join(cwd, '.gemini', 'skills', 'agentctl');
142
- }
143
- }
144
- else {
145
- throw new Error(`Agent logic for '${agent}' not implemented.`);
146
- }
147
- const p = await (0, skills_1.copySkill)(targetDir, agent);
148
- console.log(`Installed skill for ${agent} at ${p}`);
149
- }
150
- async function rm(args, options = {}) {
151
- const resolved = await (0, resolve_1.resolveCommand)(args, options);
152
- if (!resolved) {
153
- throw new Error(`Command ${args.join(' ')} not found${options.global ? ' in global scope' : ''}`);
154
- }
155
- const targetDir = path_1.default.dirname(resolved.manifestPath);
156
- await fs_extra_1.default.remove(targetDir);
157
- console.log(`Removed ${resolved.scope} command: ${args.join(' ')}`);
158
- }
159
- async function mv(srcArgs, destArgs, options = {}) {
160
- const resolved = await (0, resolve_1.resolveCommand)(srcArgs, options);
161
- if (!resolved) {
162
- throw new Error(`Command ${srcArgs.join(' ')} not found`);
163
- }
164
- const srcDir = path_1.default.dirname(resolved.manifestPath);
165
- const rootDir = resolved.scope === 'local'
166
- ? (0, fs_utils_1.findLocalRoot)(options.cwd || process.cwd())
167
- : (options.globalDir || (0, fs_utils_1.getGlobalRoot)());
168
- if (!rootDir)
169
- throw new Error('Cannot determine root for move');
170
- const agentctlDir = resolved.scope === 'local' ? path_1.default.join(rootDir, '.agentctl') : rootDir;
171
- // For global, rootDir IS the agentctl dir (config dir). Local has .agentctl subdir.
172
- const destPathStr = destArgs.join(path_1.default.sep);
173
- const destDir = path_1.default.join(agentctlDir, destPathStr);
174
- if (await fs_extra_1.default.pathExists(destDir)) {
175
- throw new Error(`Destination ${destArgs.join(' ')} already exists`);
176
- }
177
- // Check parent validity (nesting under capped)
178
- let current = path_1.default.dirname(destDir);
179
- while (current.length >= agentctlDir.length && !isSamePath(current, path_1.default.dirname(agentctlDir))) {
180
- if (await isCapped(current)) {
181
- const relPath = path_1.default.relative(agentctlDir, current); // relative to base
182
- throw new Error(`Cannot nest command under capped command: ${relPath}`);
183
- }
184
- current = path_1.default.dirname(current);
185
- }
186
- await fs_extra_1.default.move(srcDir, destDir);
187
- // Update manifest name
188
- const manifestPath = path_1.default.join(destDir, 'manifest.json');
189
- if (await fs_extra_1.default.pathExists(manifestPath)) {
190
- const manifest = await fs_extra_1.default.readJson(manifestPath);
191
- manifest.name = destArgs[destArgs.length - 1];
192
- await fs_extra_1.default.writeJson(manifestPath, manifest, { spaces: 2 });
193
- }
194
- console.log(`Moved ${srcArgs.join(' ')} to ${destArgs.join(' ')}`);
195
- }
196
- async function inspect(args, options = {}) {
197
- const resolved = await (0, resolve_1.resolveCommand)(args, options);
198
- if (!resolved) {
199
- return null;
200
- }
201
- return {
202
- manifest: resolved.manifest,
203
- resolvedPath: resolved.manifestPath,
204
- scope: resolved.scope
205
- };
206
- }
207
- async function list(options = {}) {
208
- const cwd = options.cwd || process.cwd();
209
- const localRoot = (0, fs_utils_1.findLocalRoot)(cwd);
210
- const globalRoot = options.globalDir || (0, fs_utils_1.getGlobalRoot)();
211
- const commands = new Map();
212
- async function walk(dir, prefix, scope) {
213
- if (!await fs_extra_1.default.pathExists(dir))
214
- return;
215
- const files = await fs_extra_1.default.readdir(dir);
216
- for (const file of files) {
217
- const filePath = path_1.default.join(dir, file);
218
- let stats;
219
- try {
220
- stats = await fs_extra_1.default.stat(filePath);
221
- }
222
- catch {
223
- continue;
224
- }
225
- if (!stats.isDirectory())
226
- continue;
227
- const cmdPathParts = [...prefix, file];
228
- const cmdPath = cmdPathParts.join(' ');
229
- let manifest = null;
230
- const mPath = path_1.default.join(filePath, 'manifest.json');
231
- if (await fs_extra_1.default.pathExists(mPath)) {
232
- manifest = await (0, manifest_1.readManifest)(mPath);
233
- }
234
- let type = 'group';
235
- if (manifest) {
236
- if ((0, manifest_1.isCappedManifest)(manifest)) {
237
- type = manifest.type || 'scaffold';
238
- }
239
- else if (manifest.type) {
240
- type = manifest.type;
241
- }
242
- }
243
- const item = {
244
- path: cmdPath,
245
- type,
246
- scope,
247
- description: manifest?.description || ''
248
- };
249
- if (!commands.has(cmdPath)) {
250
- commands.set(cmdPath, item);
251
- const effectiveManifest = manifest || { name: file, type: 'group' };
252
- if (!(0, manifest_1.isCappedManifest)(effectiveManifest)) {
253
- await walk(filePath, cmdPathParts, scope);
254
- }
255
- }
256
- else {
257
- const existing = commands.get(cmdPath);
258
- if (existing && existing.scope === 'local') {
259
- if (existing.type === 'group' && type === 'group') {
260
- await walk(filePath, cmdPathParts, scope);
261
- }
262
- }
263
- }
264
- }
265
- }
266
- if (localRoot) {
267
- await walk(path_1.default.join(localRoot, '.agentctl'), [], 'local');
268
- }
269
- await walk(globalRoot, [], 'global');
270
- return Array.from(commands.values());
271
- }
272
- // Helpers
273
- async function prepareCommand(args, options = {}) {
274
- const cwd = options.cwd || process.cwd();
275
- const rootDir = cwd;
276
- const agentctlDir = path_1.default.join(rootDir, '.agentctl');
277
- if (args.length === 0)
278
- throw new Error('No command path provided');
279
- const cmdPath = args.join(path_1.default.sep);
280
- const targetDir = path_1.default.join(agentctlDir, cmdPath);
281
- if (await fs_extra_1.default.pathExists(targetDir)) {
282
- throw new Error(`Command ${args.join(' ')} already exists`);
283
- }
284
- let current = path_1.default.dirname(targetDir);
285
- while (current.length >= agentctlDir.length && !isSamePath(current, path_1.default.dirname(agentctlDir))) {
286
- if (await isCapped(current)) {
287
- const relPath = path_1.default.relative(agentctlDir, current); // This uses cwd for resolution if agentctlDir is cwd resolved
288
- // Need to verify relative works predictably
289
- // agentctlDir comes from path.join(cwd, '.agentctl').
290
- throw new Error(`Cannot nest command under capped command: ${relPath}`);
291
- }
292
- current = path_1.default.dirname(current);
293
- }
294
- await fs_extra_1.default.ensureDir(targetDir);
295
- return {
296
- targetDir,
297
- name: args[args.length - 1],
298
- isWin: process.platform === 'win32'
299
- };
300
- }
301
- async function isCapped(dir) {
302
- const manifestPath = path_1.default.join(dir, 'manifest.json');
303
- if (await fs_extra_1.default.pathExists(manifestPath)) {
304
- try {
305
- const m = await fs_extra_1.default.readJson(manifestPath);
306
- return (0, manifest_1.isCappedManifest)(m);
307
- }
308
- catch {
309
- return false;
310
- }
311
- }
312
- return false;
313
- }
314
- function isSamePath(p1, p2) {
315
- return path_1.default.relative(p1, p2) === '';
316
- }
@@ -1,35 +0,0 @@
1
- "use strict";
2
- var __importDefault = (this && this.__importDefault) || function (mod) {
3
- return (mod && mod.__esModule) ? mod : { "default": mod };
4
- };
5
- Object.defineProperty(exports, "__esModule", { value: true });
6
- exports.getGlobalRoot = getGlobalRoot;
7
- exports.getAntigravityGlobalRoot = getAntigravityGlobalRoot;
8
- exports.findLocalRoot = findLocalRoot;
9
- const path_1 = __importDefault(require("path"));
10
- const os_1 = __importDefault(require("os"));
11
- const fs_extra_1 = __importDefault(require("fs-extra"));
12
- function getGlobalRoot() {
13
- if (process.platform === 'win32') {
14
- return path_1.default.join(process.env.APPDATA || path_1.default.join(os_1.default.homedir(), 'AppData', 'Roaming'), 'agentctl');
15
- }
16
- return path_1.default.join(os_1.default.homedir(), '.config', 'agentctl');
17
- }
18
- function getAntigravityGlobalRoot() {
19
- return path_1.default.join(os_1.default.homedir(), '.gemini', 'antigravity');
20
- }
21
- function findLocalRoot(cwd = process.cwd()) {
22
- let current = path_1.default.resolve(cwd);
23
- const root = path_1.default.parse(current).root;
24
- // Safety break and root check
25
- // Using for(;;) to avoid no-constant-condition
26
- for (;;) {
27
- if (fs_extra_1.default.existsSync(path_1.default.join(current, '.agentctl'))) {
28
- return current;
29
- }
30
- if (current === root) {
31
- return null;
32
- }
33
- current = path_1.default.dirname(current);
34
- }
35
- }