@jait/gateway 0.1.274 → 0.1.276

package/dist/plugins/manager.js

@@ -0,0 +1,393 @@
+/**
+ * Plugin Manager — discovery, loading, lifecycle, and persistence.
+ *
+ * Extension directories are scanned for `jait.plugin.json` manifests.
+ * Enabled plugins are dynamically imported and their contributions
+ * are registered with the tool / provider registries.
+ */
+import { readdir, readFile, stat } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { homedir } from "node:os";
+import { validateManifest } from "./manifest.js";
+import { discoverOpenClawPlugins, openclawToJaitManifest, createOpenClawPluginModule } from "./openclaw-adapter.js";
+/* ------------------------------------------------------------------ */
+/*  Constants                                                          */
+/* ------------------------------------------------------------------ */
+/** Default extensions root: ~/.jait/extensions/ */
+export function defaultExtensionsDir() {
+    return join(homedir(), ".jait", "extensions");
+}
+export class PluginManager {
+    sqlite;
+    toolRegistry;
+    gatewayVersion;
+    workspaceRoot;
+    extensionsDir;
+    openclawExtensionsDirs;
+    /** In-memory map of loaded plugins keyed by id. */
+    loaded = new Map();
+    /** OpenClaw plugin modules keyed by jait id (openclaw:<id>). */
+    openclawModules = new Map();
+    constructor(deps) {
+        this.sqlite = deps.sqlite;
+        this.toolRegistry = deps.toolRegistry;
+        this.gatewayVersion = deps.gatewayVersion;
+        this.workspaceRoot = deps.workspaceRoot;
+        this.extensionsDir = deps.extensionsDir ?? defaultExtensionsDir();
+        this.openclawExtensionsDirs = deps.openclawExtensionsDirs ?? [];
+    }
+    /* ---------------------------------------------------------------- */
+    /*  DB helpers                                                       */
+    /* ---------------------------------------------------------------- */
+    getInstalled(id) {
+        const row = this.sqlite
+            .prepare("SELECT * FROM plugins WHERE id = ?")
+            .get(id);
+        return row ? rowToInstalled(row) : null;
+    }
+    upsertInstalled(p) {
+        this.sqlite
+            .prepare(`INSERT INTO plugins (id, display_name, version, description, author, path, status, config, error, installed_at, updated_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+         ON CONFLICT(id) DO UPDATE SET
+           display_name = excluded.display_name,
+           version = excluded.version,
+           description = excluded.description,
+           author = excluded.author,
+           path = excluded.path,
+           status = excluded.status,
+           config = excluded.config,
+           error = excluded.error,
+           updated_at = excluded.updated_at`)
+            .run(p.id, p.displayName, p.version, p.description ?? null, p.author ?? null, p.path, p.status, JSON.stringify(p.config), p.error ?? null, p.installedAt, p.updatedAt);
+    }
+    deleteInstalled(id) {
+        this.sqlite.prepare("DELETE FROM plugins WHERE id = ?").run(id);
+    }
+    /* ---------------------------------------------------------------- */
+    /*  Discovery — scan extensions directory for manifests              */
+    /* ---------------------------------------------------------------- */
+    async discover() {
+        const manifests = [];
+        let entries;
+        try {
+            entries = await readdir(this.extensionsDir);
+        }
+        catch {
+            // Directory doesn't exist yet — that's fine
+            return manifests;
+        }
+        for (const entry of entries) {
+            const dir = join(this.extensionsDir, entry);
+            const dirStat = await stat(dir).catch(() => null);
+            if (!dirStat?.isDirectory())
+                continue;
+            const manifestPath = join(dir, "jait.plugin.json");
+            try {
+                const raw = JSON.parse(await readFile(manifestPath, "utf-8"));
+                const err = validateManifest(raw);
+                if (err) {
+                    console.warn(`Plugin manifest invalid at ${manifestPath}: ${err}`);
+                    continue;
+                }
+                // Attach the resolved directory path for later import
+                raw._path = dir;
+                manifests.push(raw);
+            }
+            catch {
+                // No manifest or invalid JSON — skip
+            }
+        }
+        return manifests;
+    }
+    /* ---------------------------------------------------------------- */
+    /*  Sync — reconcile discovered manifests with DB state              */
+    /* ---------------------------------------------------------------- */
+    /**
+     * Discover all plugins, sync them with DB, and load enabled ones.
+     * Called once at gateway startup.
+     */
+    async syncAndLoad() {
+        const manifests = await this.discover();
+        const now = new Date().toISOString();
+        for (const manifest of manifests) {
+            const dir = manifest._path;
+            let existing = this.getInstalled(manifest.id);
+            if (!existing) {
+                // New plugin discovered — install as disabled by default
+                existing = {
+                    id: manifest.id,
+                    displayName: manifest.displayName,
+                    version: manifest.version,
+                    description: manifest.description,
+                    author: manifest.author,
+                    path: dir,
+                    status: "installed",
+                    config: {},
+                    installedAt: now,
+                    updatedAt: now,
+                };
+                this.upsertInstalled(existing);
+            }
+            else {
+                // Update metadata if version/path changed
+                if (existing.version !== manifest.version || existing.path !== dir) {
+                    existing.version = manifest.version;
+                    existing.displayName = manifest.displayName;
+                    existing.description = manifest.description;
+                    existing.author = manifest.author;
+                    existing.path = dir;
+                    existing.updatedAt = now;
+                    this.upsertInstalled(existing);
+                }
+            }
+            // Load if enabled
+            if (existing.status === "enabled") {
+                await this.loadPlugin(manifest, existing);
+            }
+        }
+        // ── OpenClaw compatibility: discover openclaw.plugin.json ──────
+        // Scan both the Jait extensions dir and any explicit OpenClaw dirs
+        const openclawScanDirs = [this.extensionsDir, ...this.openclawExtensionsDirs];
+        let openclawCount = 0;
+        for (const scanDir of openclawScanDirs) {
+            const ocPlugins = await discoverOpenClawPlugins(scanDir);
+            for (const { manifest: ocManifest, dir } of ocPlugins) {
+                const jaitId = `openclaw:${ocManifest.id}`;
+                // Skip if a native Jait plugin with the same base id already exists
+                if (manifests.some((m) => m.id === ocManifest.id))
+                    continue;
+                const jaitManifest = openclawToJaitManifest(ocManifest, dir);
+                let existing = this.getInstalled(jaitId);
+                if (!existing) {
+                    existing = {
+                        id: jaitId,
+                        displayName: jaitManifest.displayName,
+                        version: jaitManifest.version ?? "0.0.0",
+                        description: jaitManifest.description,
+                        author: "OpenClaw",
+                        path: dir,
+                        status: "installed",
+                        config: {},
+                        installedAt: now,
+                        updatedAt: now,
+                    };
+                    this.upsertInstalled(existing);
+                }
+                else if (existing.path !== dir) {
+                    existing.path = dir;
+                    existing.updatedAt = now;
+                    this.upsertInstalled(existing);
+                }
+                // Store the module factory for later loading
+                const pluginModule = createOpenClawPluginModule(ocManifest, dir);
+                this.openclawModules.set(jaitId, pluginModule);
+                if (existing.status === "enabled") {
+                    await this.loadPluginWithModule(jaitManifest, existing, pluginModule);
+                }
+                openclawCount++;
+            }
+        }
+        console.log(`Plugins: ${manifests.length} native + ${openclawCount} OpenClaw discovered, ${this.loaded.size} loaded`);
+    }
+    /* ---------------------------------------------------------------- */
+    /*  Load / unload a single plugin                                    */
+    /* ---------------------------------------------------------------- */
+    buildContext(installed) {
+        const self = this;
+        return {
+            gatewayVersion: this.gatewayVersion,
+            workspaceRoot: this.workspaceRoot,
+            getConfig() {
+                // Re-read from DB to get latest
+                const current = self.getInstalled(installed.id);
+                return (current?.config ?? {});
+            },
+            async setConfig(value) {
+                const current = self.getInstalled(installed.id);
+                if (current) {
+                    current.config = value;
+                    current.updatedAt = new Date().toISOString();
+                    self.upsertInstalled(current);
+                }
+            },
+            log: {
+                info: (msg, ...args) => console.log(`[plugin:${installed.id}]`, msg, ...args),
+                warn: (msg, ...args) => console.warn(`[plugin:${installed.id}]`, msg, ...args),
+                error: (msg, ...args) => console.error(`[plugin:${installed.id}]`, msg, ...args),
+            },
+        };
+    }
+    async loadPlugin(manifest, installed) {
+        try {
+            const entryFile = manifest.main ?? "index.js";
+            const entryPath = resolve(installed.path, entryFile);
+            const mod = await import(entryPath);
+            // Support both default export and named `plugin` export
+            const pluginModule = mod.default ?? mod.plugin;
+            if (!pluginModule || typeof pluginModule.setup !== "function") {
+                throw new Error(`Plugin entry at ${entryPath} must export a PluginModule (use definePlugin())`);
+            }
+            const ctx = this.buildContext(installed);
+            const contribution = (await pluginModule.setup(ctx)) ?? null;
+            // Register contributed tools
+            if (contribution?.tools?.length) {
+                this.toolRegistry.registerPluginTools({ id: manifest.id, displayName: manifest.displayName }, contribution.tools);
+            }
+            this.loaded.set(manifest.id, {
+                manifest,
+                installed,
+                module: pluginModule,
+                contribution,
+            });
+            // Clear any previous error
+            if (installed.error) {
+                installed.error = undefined;
+                installed.updatedAt = new Date().toISOString();
+                this.upsertInstalled(installed);
+            }
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            console.error(`Failed to load plugin ${manifest.id}:`, message);
+            installed.status = "error";
+            installed.error = message;
+            installed.updatedAt = new Date().toISOString();
+            this.upsertInstalled(installed);
+        }
+    }
+    /** Load a plugin using a pre-built module (used for OpenClaw adapter). */
+    async loadPluginWithModule(manifest, installed, pluginModule) {
+        try {
+            const ctx = this.buildContext(installed);
+            const contribution = (await pluginModule.setup(ctx)) ?? null;
+            if (contribution?.tools?.length) {
+                this.toolRegistry.registerPluginTools({ id: installed.id, displayName: installed.displayName }, contribution.tools);
+            }
+            this.loaded.set(installed.id, {
+                manifest,
+                installed,
+                module: pluginModule,
+                contribution,
+            });
+            if (installed.error) {
+                installed.error = undefined;
+                installed.updatedAt = new Date().toISOString();
+                this.upsertInstalled(installed);
+            }
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            console.error(`Failed to load OpenClaw plugin ${installed.id}:`, message);
+            installed.status = "error";
+            installed.error = message;
+            installed.updatedAt = new Date().toISOString();
+            this.upsertInstalled(installed);
+        }
+    }
+    async unloadPlugin(id) {
+        const loaded = this.loaded.get(id);
+        if (!loaded)
+            return;
+        try {
+            await loaded.module?.dispose();
+        }
+        catch (err) {
+            console.error(`Error disposing plugin ${id}:`, err);
+        }
+        this.loaded.delete(id);
+    }
+    /* ---------------------------------------------------------------- */
+    /*  Public API — used by REST routes                                 */
+    /* ---------------------------------------------------------------- */
+    /** List all installed plugins (from DB). */
+    listInstalled() {
+        const rows = this.sqlite
+            .prepare("SELECT * FROM plugins ORDER BY display_name")
+            .all();
+        return rows.map(rowToInstalled);
+    }
+    /** Get a single installed plugin. */
+    getPlugin(id) {
+        return this.getInstalled(id);
+    }
+    /** Enable a plugin and load it. */
+    async enable(id) {
+        const installed = this.getInstalled(id);
+        if (!installed)
+            throw new Error(`Plugin '${id}' not found`);
+        installed.status = "enabled";
+        installed.error = undefined;
+        installed.updatedAt = new Date().toISOString();
+        this.upsertInstalled(installed);
+        // Re-discover manifest so we can load it
+        const manifests = await this.discover();
+        const manifest = manifests.find((m) => m.id === id);
+        if (manifest) {
+            await this.loadPlugin(manifest, installed);
+        }
+        else {
+            // Check for OpenClaw adapter module
+            const ocModule = this.openclawModules.get(id);
+            if (ocModule) {
+                const jaitManifest = openclawToJaitManifest({ id: id.replace(/^openclaw:/, ""), name: installed.displayName, version: installed.version, description: installed.description }, installed.path);
+                await this.loadPluginWithModule(jaitManifest, installed, ocModule);
+            }
+        }
+        return this.getInstalled(id) ?? installed;
+    }
+    /** Disable a plugin and unload it. */
+    async disable(id) {
+        const installed = this.getInstalled(id);
+        if (!installed)
+            throw new Error(`Plugin '${id}' not found`);
+        await this.unloadPlugin(id);
+        installed.status = "disabled";
+        installed.error = undefined;
+        installed.updatedAt = new Date().toISOString();
+        this.upsertInstalled(installed);
+        return installed;
+    }
+    /** Uninstall a plugin (unload + remove from DB). Does NOT delete files. */
+    async uninstall(id) {
+        await this.unloadPlugin(id);
+        this.deleteInstalled(id);
+    }
+    /** Get / set plugin config. */
+    getPluginConfig(id) {
+        return this.getInstalled(id)?.config ?? {};
+    }
+    async setPluginConfig(id, config) {
+        const installed = this.getInstalled(id);
+        if (!installed)
+            throw new Error(`Plugin '${id}' not found`);
+        installed.config = config;
+        installed.updatedAt = new Date().toISOString();
+        this.upsertInstalled(installed);
+    }
+    /** Gracefully dispose of all loaded plugins. */
+    async disposeAll() {
+        for (const [id] of this.loaded) {
+            await this.unloadPlugin(id);
+        }
+    }
+}
+/* ------------------------------------------------------------------ */
+/*  Row conversion                                                     */
+/* ------------------------------------------------------------------ */
+function rowToInstalled(row) {
+    return {
+        id: row.id,
+        displayName: row.display_name,
+        version: row.version,
+        description: row.description ?? undefined,
+        author: row.author ?? undefined,
+        path: row.path,
+        status: row.status,
+        config: JSON.parse(row.config || "{}"),
+        error: row.error ?? undefined,
+        installedAt: row.installed_at,
+        updatedAt: row.updated_at,
+    };
+}
+//# sourceMappingURL=manager.js.map

package/dist/plugins/manager.js.map

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

package/dist/plugins/manifest.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Plugin manifest schema — mirrors `jait.plugin.json`.
+ *
+ * Every extension must ship a manifest at the root of its package.
+ * The loader resolves the manifest first and only imports the entry
+ * module when the plugin is enabled.
+ */
+import type { ToolParametersSchema } from "../tools/contracts.js";
+/** Activation event that triggers lazy plugin load. */
+export type PluginActivationEvent = "*" | `onTool:${string}` | `onProvider:${string}` | `onCommand:${string}`;
+/** Manifest tool declaration (what goes in the JSON file). */
+export interface ManifestToolDeclaration {
+    name: string;
+    description: string;
+    parameters?: ToolParametersSchema;
+    tier?: "core" | "standard" | "external";
+    category?: string;
+    risk?: "low" | "medium" | "high";
+    consent?: "none" | "once" | "always" | "dangerous";
+}
+/** Manifest provider declaration. */
+export interface ManifestProviderDeclaration {
+    id: string;
+    displayName: string;
+    description?: string;
+}
+/** The jait.plugin.json file schema. */
+export interface PluginManifest {
+    /** Unique plugin identifier (npm-style scope ok: `@org/name`). */
+    id: string;
+    /** Human-readable display name. */
+    displayName: string;
+    /** Semver version string. */
+    version: string;
+    /** Short description shown in the extension store. */
+    description?: string;
+    /** Author name or org. */
+    author?: string;
+    /** SPDX license id. */
+    license?: string;
+    /** Relative path to the ES module entry (default: `index.js`). */
+    main?: string;
+    /** Minimum gateway version required (semver range). */
+    engines?: {
+        gateway?: string;
+    };
+    /** Activation events — when should this plugin be loaded? */
+    activationEvents?: PluginActivationEvent[];
+    /** Tools declared by this plugin (statically listed in manifest). */
+    contributes?: {
+        tools?: ManifestToolDeclaration[];
+        providers?: ManifestProviderDeclaration[];
+    };
+    /** JSON-schema for user-facing configuration. */
+    configSchema?: ToolParametersSchema;
+    /** Categories for the extension store. */
+    categories?: string[];
+    /** Keywords for search. */
+    keywords?: string[];
+    /** URL to a square icon (relative path or https). */
+    icon?: string;
+    /** Homepage / docs URL. */
+    homepage?: string;
+    /** Repository URL. */
+    repository?: string;
+}
+/** Minimal validation — returns error string or null. */
+export declare function validateManifest(raw: unknown): string | null;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/plugins/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/plugins/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAMlE,uDAAuD;AACvD,MAAM,MAAM,qBAAqB,GAC7B,GAAG,GACH,UAAU,MAAM,EAAE,GAClB,cAAc,MAAM,EAAE,GACtB,aAAa,MAAM,EAAE,CAAC;AAE1B,8DAA8D;AAC9D,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAClC,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,WAAW,CAAC;CACpD;AAED,qCAAqC;AACrC,MAAM,WAAW,2BAA2B;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wCAAwC;AACxC,MAAM,WAAW,cAAc;IAC7B,kEAAkE;IAClE,EAAE,EAAE,MAAM,CAAC;IACX,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0BAA0B;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/B,6DAA6D;IAC7D,gBAAgB,CAAC,EAAE,qBAAqB,EAAE,CAAC;IAC3C,qEAAqE;IACrE,WAAW,CAAC,EAAE;QACZ,KAAK,CAAC,EAAE,uBAAuB,EAAE,CAAC;QAClC,SAAS,CAAC,EAAE,2BAA2B,EAAE,CAAC;KAC3C,CAAC;IACF,iDAAiD;IACjD,YAAY,CAAC,EAAE,oBAAoB,CAAC;IACpC,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sBAAsB;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAMD,yDAAyD;AACzD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAW5D"}

package/dist/plugins/manifest.js

@@ -0,0 +1,28 @@
+/**
+ * Plugin manifest schema — mirrors `jait.plugin.json`.
+ *
+ * Every extension must ship a manifest at the root of its package.
+ * The loader resolves the manifest first and only imports the entry
+ * module when the plugin is enabled.
+ */
+/* ------------------------------------------------------------------ */
+/*  Validation                                                         */
+/* ------------------------------------------------------------------ */
+/** Minimal validation — returns error string or null. */
+export function validateManifest(raw) {
+    if (!raw || typeof raw !== "object")
+        return "Manifest must be a JSON object";
+    const m = raw;
+    if (typeof m.id !== "string" || !m.id)
+        return "Manifest must have a non-empty 'id'";
+    if (typeof m.displayName !== "string" || !m.displayName)
+        return "Manifest must have a non-empty 'displayName'";
+    if (typeof m.version !== "string" || !m.version)
+        return "Manifest must have a non-empty 'version'";
+    // id format: lowercase alphanumeric, hyphens, dots, and scoped (@org/name)
+    if (!/^(@[\w-]+\/)?[\w][\w.-]*$/.test(m.id)) {
+        return `Invalid plugin id '${m.id}' — use alphanumeric, hyphens, dots, and optional @scope/`;
+    }
+    return null;
+}
+//# sourceMappingURL=manifest.js.map

package/dist/plugins/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/plugins/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAwEH,wEAAwE;AACxE,yEAAyE;AACzE,wEAAwE;AAExE,yDAAyD;AACzD,MAAM,UAAU,gBAAgB,CAAC,GAAY;IAC3C,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,gCAAgC,CAAC;IAC7E,MAAM,CAAC,GAAG,GAA8B,CAAC;IACzC,IAAI,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ,IAAI,CAAC,CAAC,CAAC,EAAE;QAAE,OAAO,qCAAqC,CAAC;IACpF,IAAI,OAAO,CAAC,CAAC,WAAW,KAAK,QAAQ,IAAI,CAAC,CAAC,CAAC,WAAW;QAAE,OAAO,8CAA8C,CAAC;IAC/G,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,CAAC,CAAC,OAAO;QAAE,OAAO,0CAA0C,CAAC;IACnG,2EAA2E;IAC3E,IAAI,CAAC,2BAA2B,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QAC5C,OAAO,sBAAsB,CAAC,CAAC,EAAE,2DAA2D,CAAC;IAC/F,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/plugins/openclaw-adapter.d.ts

@@ -0,0 +1,42 @@
+/**
+ * OpenClaw compatibility adapter.
+ *
+ * Loads OpenClaw-format plugins (openclaw.plugin.json + index.ts using
+ * definePluginEntry) and bridges them into Jait's plugin system.
+ *
+ * Supported:
+ *  - Tool registration (registerTool) → Jait ToolDefinition
+ *  - Plugin config passthrough
+ *  - Scoped logging
+ *
+ * Unsupported registrations (channels, speech providers, CLI backends, etc.)
+ * are silently captured so the plugin doesn't throw, but they are not wired
+ * into Jait's runtime. They are logged at debug level.
+ */
+import type { PluginManifest as JaitManifest } from "./manifest.js";
+import type { PluginModule } from "./contracts.js";
+interface OpenClawManifest {
+    id: string;
+    name?: string;
+    description?: string;
+    version?: string;
+    configSchema?: Record<string, unknown>;
+    contracts?: {
+        tools?: string[];
+        webFetchProviders?: string[];
+        webSearchProviders?: string[];
+        [key: string]: unknown;
+    };
+    providers?: string[];
+    channels?: string[];
+    uiHints?: Record<string, unknown>;
+    enabledByDefault?: boolean;
+}
+export declare function discoverOpenClawPlugins(extensionsDir: string): Promise<{
+    manifest: OpenClawManifest;
+    dir: string;
+}[]>;
+export declare function openclawToJaitManifest(oc: OpenClawManifest, _dir: string): JaitManifest;
+export declare function createOpenClawPluginModule(manifest: OpenClawManifest, dir: string): PluginModule;
+export {};
+//# sourceMappingURL=openclaw-adapter.d.ts.map

package/dist/plugins/openclaw-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openclaw-adapter.d.ts","sourceRoot":"","sources":["../../src/plugins/openclaw-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EAAE,cAAc,IAAI,YAAY,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAA4D,MAAM,gBAAgB,CAAC;AAO7G,UAAU,gBAAgB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,SAAS,CAAC,EAAE;QACV,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;QAC7B,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;QAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAkID,wBAAsB,uBAAuB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,gBAAgB,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAwB3H;AAMD,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,GAAG,YAAY,CAcvF;AAMD,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,gBAAgB,EAC1B,GAAG,EAAE,MAAM,GACV,YAAY,CA8Ed"}