@tinyclaw/plugins 1.0.1-dev.3f91a71

package/README.md

@@ -0,0 +1,19 @@
+# @tinyclaw/plugins
+
+Config-driven plugin loader and validator for [Tiny Claw](https://github.com/warengonzaga/tinyclaw) — your autonomous AI companion.
+
+Provides `loadPlugins` which dynamically imports enabled plugins by package name, validates them, and returns them grouped by type (channels, providers, tools).
+
+## Installation
+
+```bash
+bun add @tinyclaw/plugins
+```
+
+## Part of Tiny Claw
+
+This package is part of the [Tiny Claw](https://github.com/warengonzaga/tinyclaw) monorepo.
+
+## License
+
+GPL-3.0 — see [LICENSE](../../LICENSE) for details.

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Plugin Loader
+ *
+ * Discovers installed Tiny Claw plugins by dynamically importing package names
+ * from the `plugins.enabled` config array, validates them, and returns them
+ * grouped by type.
+ *
+ * Discovery is config-driven (not filesystem-based) so plugins explicitly
+ * opt in via their pairing flow. Import failures are non-fatal — logged and
+ * skipped so the rest of the system boots normally.
+ */
+import type { ChannelPlugin, ProviderPlugin, ToolsPlugin, ConfigManagerInterface } from '@tinyclaw/types';
+export interface LoadedPlugins {
+    channels: ChannelPlugin[];
+    providers: ProviderPlugin[];
+    tools: ToolsPlugin[];
+}
+/**
+ * Load all enabled plugins.
+ *
+ * @param configManager - Used to read the `plugins.enabled` list
+ * @returns Grouped loaded plugin instances
+ */
+export declare function loadPlugins(configManager: ConfigManagerInterface): Promise<LoadedPlugins>;

package/dist/index.js

@@ -0,0 +1,71 @@
+/**
+ * Plugin Loader
+ *
+ * Discovers installed Tiny Claw plugins by dynamically importing package names
+ * from the `plugins.enabled` config array, validates them, and returns them
+ * grouped by type.
+ *
+ * Discovery is config-driven (not filesystem-based) so plugins explicitly
+ * opt in via their pairing flow. Import failures are non-fatal — logged and
+ * skipped so the rest of the system boots normally.
+ */
+import { logger } from '@tinyclaw/logger';
+/**
+ * Load all enabled plugins.
+ *
+ * @param configManager - Used to read the `plugins.enabled` list
+ * @returns Grouped loaded plugin instances
+ */
+export async function loadPlugins(configManager) {
+    const result = { channels: [], providers: [], tools: [] };
+    const enabledIds = configManager.get('plugins.enabled') ?? [];
+    if (enabledIds.length === 0) {
+        logger.info('No plugins configured');
+        return result;
+    }
+    logger.info('Loading plugins', { count: enabledIds.length, ids: enabledIds });
+    for (const id of enabledIds) {
+        try {
+            const mod = await import(id);
+            const plugin = mod.default;
+            if (!plugin || typeof plugin !== 'object') {
+                logger.warn(`Plugin "${id}" has no default export — skipping`);
+                continue;
+            }
+            if (!isValidPlugin(plugin)) {
+                logger.warn(`Plugin "${id}" failed validation — skipping`);
+                continue;
+            }
+            switch (plugin.type) {
+                case 'channel':
+                    result.channels.push(plugin);
+                    logger.info(`Loaded channel plugin: ${plugin.name} (${plugin.id})`);
+                    break;
+                case 'provider':
+                    result.providers.push(plugin);
+                    logger.info(`Loaded provider plugin: ${plugin.name} (${plugin.id})`);
+                    break;
+                case 'tools':
+                    result.tools.push(plugin);
+                    logger.info(`Loaded tools plugin: ${plugin.name} (${plugin.id})`);
+                    break;
+                default:
+                    logger.warn(`Plugin "${id}" has unknown type — skipping`);
+            }
+        }
+        catch (err) {
+            logger.warn(`Failed to load plugin "${id}": ${err.message}`);
+        }
+    }
+    return result;
+}
+/** Minimal structural validation for a plugin object. */
+function isValidPlugin(obj) {
+    if (!obj || typeof obj !== 'object')
+        return false;
+    const p = obj;
+    return (typeof p.id === 'string' &&
+        typeof p.name === 'string' &&
+        typeof p.type === 'string' &&
+        ['channel', 'provider', 'tools'].includes(p.type));
+}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@tinyclaw/plugins",
+  "version": "1.0.1-dev.3f91a71",
+  "description": "Config-driven plugin loader and validator for Tiny Claw",
+  "license": "GPL-3.0",
+  "author": "Waren Gonzaga",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/warengonzaga/tinyclaw.git",
+    "directory": "packages/plugins"
+  },
+  "homepage": "https://github.com/warengonzaga/tinyclaw/tree/main/packages/plugins#readme",
+  "bugs": {
+    "url": "https://github.com/warengonzaga/tinyclaw/issues"
+  },
+  "keywords": [
+    "tinyclaw",
+    "plugins",
+    "loader"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json"
+  },
+  "dependencies": {
+    "@tinyclaw/types": "workspace:*",
+    "@tinyclaw/logger": "workspace:*"
+  }
+}