@skillctl/plugin-system 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 skillctl 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/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { loadPlugins, listInstalledPlugins, addPluginRecord, removePluginRecord, discoverPluginEntry, getPluginsDir, } from './loader.js';
+export type { SkillctlPlugin, PluginAPI, PluginProgram, PluginCommand } from './types.js';
+//# 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":"AAAA,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { loadPlugins, listInstalledPlugins, addPluginRecord, removePluginRecord, discoverPluginEntry, getPluginsDir, } from './loader.js';
+//# 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,EACL,WAAW,EACX,oBAAoB,EACpB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,GACd,MAAM,aAAa,CAAC"}

package/dist/loader.d.ts

@@ -0,0 +1,15 @@
+import type { RegistrySource } from '@skillctl/core';
+import type { PluginProgram } from './types.js';
+export declare function getPluginsDir(): string;
+export declare function listInstalledPlugins(): Promise<Array<{
+    name: string;
+    path: string;
+    enabled: boolean;
+}>>;
+export declare function loadPlugins(program: PluginProgram, registryManager?: {
+    register: (s: RegistrySource) => void;
+}): Promise<string[]>;
+export declare function addPluginRecord(name: string, pluginPath: string): Promise<void>;
+export declare function removePluginRecord(name: string): Promise<boolean>;
+export declare function discoverPluginEntry(pluginDir: string): Promise<string | null>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAA6B,aAAa,EAAE,MAAM,YAAY,CAAC;AAI3E,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC,CAG7G;AAED,wBAAsB,WAAW,CAC/B,OAAO,EAAE,aAAa,EACtB,eAAe,CAAC,EAAE;IAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,cAAc,KAAK,IAAI,CAAA;CAAE,GAC1D,OAAO,CAAC,MAAM,EAAE,CAAC,CAiCnB;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAWrF;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CASvE;AAED,wBAAsB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAUnF"}

package/dist/loader.js

@@ -0,0 +1,84 @@
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { pathToFileURL } from 'node:url';
+import { loadConfig, registerAdapter } from '@skillctl/core';
+const PLUGINS_DIR = join(homedir(), '.skillctl', 'plugins');
+export function getPluginsDir() {
+    return PLUGINS_DIR;
+}
+export async function listInstalledPlugins() {
+    const config = await loadConfig();
+    return config.plugins || [];
+}
+export async function loadPlugins(program, registryManager) {
+    const config = await loadConfig();
+    if (!config.experimental?.plugins)
+        return [];
+    const loaded = [];
+    const plugins = (config.plugins || []).filter((p) => p.enabled);
+    const api = {
+        registerCommand(cmd) {
+            program.addCommand(cmd);
+        },
+        registerAdapter(adapter) {
+            registerAdapter(adapter);
+        },
+        registerRegistrySource(source) {
+            registryManager?.register(source);
+        },
+    };
+    for (const plugin of plugins) {
+        try {
+            const mod = await import(pathToFileURL(plugin.path).href);
+            const pluginExport = mod.default || mod;
+            if (typeof pluginExport.register === 'function') {
+                await pluginExport.register(api);
+                loaded.push(plugin.name);
+            }
+        }
+        catch (e) {
+            console.warn(`[plugin] failed to load ${plugin.name}: ${e.message}`);
+        }
+    }
+    return loaded;
+}
+export async function addPluginRecord(name, pluginPath) {
+    const { loadConfig, saveConfig } = await import('@skillctl/core');
+    const config = await loadConfig();
+    const plugins = config.plugins || [];
+    const existing = plugins.findIndex((p) => p.name === name);
+    const record = { name, path: pluginPath, enabled: true };
+    if (existing >= 0)
+        plugins[existing] = record;
+    else
+        plugins.push(record);
+    config.plugins = plugins;
+    config.experimental = { ...config.experimental, plugins: true };
+    await saveConfig(config);
+}
+export async function removePluginRecord(name) {
+    const { loadConfig, saveConfig } = await import('@skillctl/core');
+    const config = await loadConfig();
+    const plugins = config.plugins || [];
+    const next = plugins.filter((p) => p.name !== name);
+    if (next.length === plugins.length)
+        return false;
+    config.plugins = next;
+    await saveConfig(config);
+    return true;
+}
+export async function discoverPluginEntry(pluginDir) {
+    try {
+        const pkgRaw = await readFile(join(pluginDir, 'package.json'), 'utf8');
+        const pkg = JSON.parse(pkgRaw);
+        const entry = pkg.skillctl?.plugin || pkg.main;
+        if (entry)
+            return join(pluginDir, entry);
+    }
+    catch {
+        // no package.json
+    }
+    return null;
+}
+//# sourceMappingURL=loader.js.map

package/dist/loader.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,20 @@
+import type { AgentAdapter, RegistrySource } from '@skillctl/core';
+export interface PluginCommand {
+    name(): string;
+    description(str: string): PluginCommand;
+    action(fn: (...args: unknown[]) => void | Promise<void>): PluginCommand;
+}
+export interface PluginProgram {
+    addCommand(cmd: PluginCommand): void;
+}
+export interface PluginAPI {
+    registerCommand(cmd: PluginCommand): void;
+    registerAdapter(adapter: AgentAdapter): void;
+    registerRegistrySource(source: RegistrySource): void;
+}
+export interface SkillctlPlugin {
+    name: string;
+    version?: string;
+    register(api: PluginAPI): void | Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEnE,MAAM,WAAW,aAAa;IAC5B,IAAI,IAAI,MAAM,CAAC;IACf,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAAC;IACxC,MAAM,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC;CACzE;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAAC;CACtC;AAED,MAAM,WAAW,SAAS;IACxB,eAAe,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAAC;IAC1C,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAC7C,sBAAsB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;CACtD;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@skillctl/plugin-system",
+  "version": "0.2.0",
+  "description": "Experimental plugin loader for skillctl (commands, adapters, registries)",
+  "license": "MIT",
+  "author": "skillctl contributors",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@skillctl/core": "0.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.0",
+    "rimraf": "^5.0.7",
+    "typescript": "^5.6.3"
+  },
+  "engines": {
+    "node": ">=22.13"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/xFurti/skillctl.git",
+    "directory": "packages/plugin-system"
+  },
+  "keywords": [
+    "plugins",
+    "extensibility",
+    "agent-skills",
+    "cli"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "rimraf dist",
+    "lint": "tsc --noEmit",
+    "test": "echo 'plugin tests via cli fixture' && exit 0"
+  }
+}