crewly 1.4.5 → 1.4.8

package/dist/backend/backend/src/services/addon/addon-loader.service.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Addon Loader Service
+ *
+ * Scans ~/.crewly/addons/ on server startup, loads each addon's
+ * manifest.json, dynamically imports its entrypoint, and calls
+ * addon.register(app, server) so addons can attach routes, WS
+ * servers, and middleware to the running Crewly instance.
+ *
+ * Singleton pattern matching other Crewly services.
+ *
+ * @module services/addon/addon-loader.service
+ */
+import type { Application } from 'express';
+import type { Server as HttpServer } from 'http';
+import type { LoadedAddon } from './addon.types.js';
+/**
+ * AddonLoaderService discovers and loads addons from the file system.
+ *
+ * On server startup, call `loadAddons(app, server)` to scan the
+ * addons directory and register all valid addons. On shutdown, call
+ * `unloadAddons()` to invoke each addon's cleanup hook.
+ */
+export declare class AddonLoaderService {
+    private static instance;
+    /** Successfully loaded addons indexed by name */
+    private addons;
+    private logger;
+    private constructor();
+    /**
+     * Get the singleton instance.
+     *
+     * @returns The singleton AddonLoaderService instance
+     */
+    static getInstance(): AddonLoaderService;
+    /**
+     * Clear the singleton instance (for testing).
+     */
+    static clearInstance(): void;
+    /**
+     * Scan the addons directory and load all valid addons.
+     *
+     * Each addon directory must contain a manifest.json with name,
+     * version, and entrypoint fields. The entrypoint module must
+     * export a `register(app, server)` function.
+     *
+     * Errors in one addon do not prevent others from loading.
+     *
+     * @param app - The Express application instance
+     * @param server - The HTTP server instance
+     * @returns Array of successfully loaded addon names
+     */
+    loadAddons(app: Application, server: HttpServer): Promise<string[]>;
+    /**
+     * Unload all loaded addons, calling their unregister hooks.
+     * Called during server shutdown.
+     */
+    unloadAddons(): Promise<void>;
+    /**
+     * Get a loaded addon by name.
+     *
+     * @param name - The addon name from its manifest
+     * @returns The loaded addon record, or undefined
+     */
+    getAddon(name: string): LoadedAddon | undefined;
+    /**
+     * List all loaded addons.
+     *
+     * @returns Array of loaded addon records
+     */
+    listAddons(): LoadedAddon[];
+    /**
+     * Get the number of loaded addons.
+     *
+     * @returns Count of loaded addons
+     */
+    getAddonCount(): number;
+    /**
+     * Get the absolute path to the addons directory.
+     *
+     * @returns Path to ~/.crewly/addons/
+     */
+    getAddonsDir(): string;
+    /**
+     * Load a single addon from its directory.
+     *
+     * @param addonPath - Absolute path to the addon directory
+     * @param app - Express app
+     * @param server - HTTP server
+     * @throws If manifest is invalid or entrypoint fails to load
+     */
+    private loadSingleAddon;
+    /**
+     * Validate that a manifest has all required fields.
+     *
+     * @param manifest - The parsed manifest object
+     * @param manifestPath - Path to the manifest file (for error messages)
+     * @throws If any required field is missing or invalid
+     */
+    private validateManifest;
+}
+//# sourceMappingURL=addon-loader.service.d.ts.map

package/dist/backend/backend/src/services/addon/addon-loader.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"addon-loader.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/addon/addon-loader.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,MAAM,CAAC;AACjD,OAAO,KAAK,EAA8B,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAQhF;;;;;;GAMG;AACH,qBAAa,kBAAkB;IAC9B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAmC;IAE1D,iDAAiD;IACjD,OAAO,CAAC,MAAM,CAAuC;IAErD,OAAO,CAAC,MAAM,CAAgB;IAE9B,OAAO;IAIP;;;;OAIG;IACH,MAAM,CAAC,WAAW,IAAI,kBAAkB;IAOxC;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,IAAI;IAQ5B;;;;;;;;;;;;OAYG;IACG,UAAU,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA4DzE;;;OAGG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBnC;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAI/C;;;;OAIG;IACH,UAAU,IAAI,WAAW,EAAE;IAI3B;;;;OAIG;IACH,aAAa,IAAI,MAAM;IAIvB;;;;OAIG;IACH,YAAY,IAAI,MAAM;IAatB;;;;;;;OAOG;YACW,eAAe;IAkE7B;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;CAWxB"}

package/dist/backend/backend/src/services/addon/addon-loader.service.js

@@ -0,0 +1,253 @@
+/**
+ * Addon Loader Service
+ *
+ * Scans ~/.crewly/addons/ on server startup, loads each addon's
+ * manifest.json, dynamically imports its entrypoint, and calls
+ * addon.register(app, server) so addons can attach routes, WS
+ * servers, and middleware to the running Crewly instance.
+ *
+ * Singleton pattern matching other Crewly services.
+ *
+ * @module services/addon/addon-loader.service
+ */
+import { promises as fs } from 'fs';
+import path from 'path';
+import os from 'os';
+import { pathToFileURL } from 'url';
+import { ADDON_CONSTANTS } from '../../constants.js';
+import { LoggerService } from '../core/logger.service.js';
+// =============================================================================
+// Service
+// =============================================================================
+/**
+ * AddonLoaderService discovers and loads addons from the file system.
+ *
+ * On server startup, call `loadAddons(app, server)` to scan the
+ * addons directory and register all valid addons. On shutdown, call
+ * `unloadAddons()` to invoke each addon's cleanup hook.
+ */
+export class AddonLoaderService {
+    static instance = null;
+    /** Successfully loaded addons indexed by name */
+    addons = new Map();
+    logger;
+    constructor() {
+        this.logger = LoggerService.getInstance();
+    }
+    /**
+     * Get the singleton instance.
+     *
+     * @returns The singleton AddonLoaderService instance
+     */
+    static getInstance() {
+        if (!AddonLoaderService.instance) {
+            AddonLoaderService.instance = new AddonLoaderService();
+        }
+        return AddonLoaderService.instance;
+    }
+    /**
+     * Clear the singleton instance (for testing).
+     */
+    static clearInstance() {
+        AddonLoaderService.instance = null;
+    }
+    // =========================================================================
+    // Public API
+    // =========================================================================
+    /**
+     * Scan the addons directory and load all valid addons.
+     *
+     * Each addon directory must contain a manifest.json with name,
+     * version, and entrypoint fields. The entrypoint module must
+     * export a `register(app, server)` function.
+     *
+     * Errors in one addon do not prevent others from loading.
+     *
+     * @param app - The Express application instance
+     * @param server - The HTTP server instance
+     * @returns Array of successfully loaded addon names
+     */
+    async loadAddons(app, server) {
+        const addonsDir = this.getAddonsDir();
+        // Ensure addons directory exists
+        try {
+            await fs.mkdir(addonsDir, { recursive: true });
+        }
+        catch {
+            // Directory likely already exists
+        }
+        // List subdirectories
+        let entries;
+        try {
+            const dirEntries = await fs.readdir(addonsDir, { withFileTypes: true });
+            entries = dirEntries
+                .filter(e => e.isDirectory())
+                .map(e => e.name);
+        }
+        catch (error) {
+            this.logger.warn('Failed to read addons directory', {
+                path: addonsDir,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return [];
+        }
+        if (entries.length === 0) {
+            this.logger.info('No addons found', { path: addonsDir });
+            return [];
+        }
+        this.logger.info('Discovered addon directories', {
+            count: entries.length,
+            names: entries,
+        });
+        const loaded = [];
+        for (const dirName of entries) {
+            const addonPath = path.join(addonsDir, dirName);
+            try {
+                await this.loadSingleAddon(addonPath, app, server);
+                loaded.push(dirName);
+            }
+            catch (error) {
+                this.logger.error('Failed to load addon', {
+                    addon: dirName,
+                    path: addonPath,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+        this.logger.info('Addon loading complete', {
+            loaded: loaded.length,
+            total: entries.length,
+            names: loaded,
+        });
+        return loaded;
+    }
+    /**
+     * Unload all loaded addons, calling their unregister hooks.
+     * Called during server shutdown.
+     */
+    async unloadAddons() {
+        for (const [name, addon] of this.addons) {
+            try {
+                if (addon.module.unregister) {
+                    await addon.module.unregister();
+                }
+                this.logger.info('Unloaded addon', { addon: name });
+            }
+            catch (error) {
+                this.logger.error('Error unloading addon', {
+                    addon: name,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+        this.addons.clear();
+    }
+    /**
+     * Get a loaded addon by name.
+     *
+     * @param name - The addon name from its manifest
+     * @returns The loaded addon record, or undefined
+     */
+    getAddon(name) {
+        return this.addons.get(name);
+    }
+    /**
+     * List all loaded addons.
+     *
+     * @returns Array of loaded addon records
+     */
+    listAddons() {
+        return Array.from(this.addons.values());
+    }
+    /**
+     * Get the number of loaded addons.
+     *
+     * @returns Count of loaded addons
+     */
+    getAddonCount() {
+        return this.addons.size;
+    }
+    /**
+     * Get the absolute path to the addons directory.
+     *
+     * @returns Path to ~/.crewly/addons/
+     */
+    getAddonsDir() {
+        return path.join(os.homedir(), ADDON_CONSTANTS.PATHS.ADDONS_DIR === 'addons'
+            ? `.crewly/${ADDON_CONSTANTS.PATHS.ADDONS_DIR}`
+            : ADDON_CONSTANTS.PATHS.ADDONS_DIR);
+    }
+    // =========================================================================
+    // Internal
+    // =========================================================================
+    /**
+     * Load a single addon from its directory.
+     *
+     * @param addonPath - Absolute path to the addon directory
+     * @param app - Express app
+     * @param server - HTTP server
+     * @throws If manifest is invalid or entrypoint fails to load
+     */
+    async loadSingleAddon(addonPath, app, server) {
+        // Read and validate manifest
+        const manifestPath = path.join(addonPath, ADDON_CONSTANTS.MANIFEST_FILE);
+        const manifestRaw = await fs.readFile(manifestPath, 'utf-8');
+        const manifest = JSON.parse(manifestRaw);
+        this.validateManifest(manifest, manifestPath);
+        // Resolve entrypoint path
+        const entrypointPath = path.join(addonPath, manifest.entrypoint);
+        // Verify entrypoint file exists
+        try {
+            await fs.access(entrypointPath);
+        }
+        catch {
+            throw new Error(`Addon entrypoint not found: ${entrypointPath} (from manifest.entrypoint: "${manifest.entrypoint}")`);
+        }
+        // Dynamic import — use file:// URL for ESM compatibility
+        const entrypointUrl = pathToFileURL(entrypointPath).href;
+        const mod = await import(entrypointUrl);
+        // Handle both default export and named export patterns
+        const addonModule = 'default' in mod && typeof mod.default?.register === 'function'
+            ? mod.default
+            : mod;
+        if (typeof addonModule.register !== 'function') {
+            throw new Error(`Addon "${manifest.name}" entrypoint does not export a register() function`);
+        }
+        // Call register with timeout
+        await Promise.race([
+            addonModule.register(app, server),
+            new Promise((_, reject) => setTimeout(() => reject(new Error(`Addon "${manifest.name}" register() timed out`)), ADDON_CONSTANTS.TIMEOUTS.LOAD_TIMEOUT_MS)),
+        ]);
+        // Store loaded addon
+        this.addons.set(manifest.name, {
+            manifest,
+            module: addonModule,
+            path: addonPath,
+            loadedAt: new Date(),
+        });
+        this.logger.info('Loaded addon', {
+            name: manifest.name,
+            version: manifest.version,
+            entrypoint: manifest.entrypoint,
+        });
+    }
+    /**
+     * Validate that a manifest has all required fields.
+     *
+     * @param manifest - The parsed manifest object
+     * @param manifestPath - Path to the manifest file (for error messages)
+     * @throws If any required field is missing or invalid
+     */
+    validateManifest(manifest, manifestPath) {
+        if (!manifest.name || typeof manifest.name !== 'string') {
+            throw new Error(`Invalid manifest at ${manifestPath}: missing or invalid "name" field`);
+        }
+        if (!manifest.version || typeof manifest.version !== 'string') {
+            throw new Error(`Invalid manifest at ${manifestPath}: missing or invalid "version" field`);
+        }
+        if (!manifest.entrypoint || typeof manifest.entrypoint !== 'string') {
+            throw new Error(`Invalid manifest at ${manifestPath}: missing or invalid "entrypoint" field`);
+        }
+    }
+}
+//# sourceMappingURL=addon-loader.service.js.map

package/dist/backend/backend/src/services/addon/addon-loader.service.js.map

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

package/dist/backend/backend/src/services/addon/addon.types.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Addon System Types
+ *
+ * Defines the manifest format, addon interface, and registration
+ * contract for the Crewly addon/plugin system. Pro and third-party
+ * extensions implement these interfaces to hook into the server.
+ *
+ * @module services/addon/addon.types
+ */
+import type { Application } from 'express';
+import type { Server as HttpServer } from 'http';
+/**
+ * Schema for an addon's manifest.json file.
+ * Every addon directory must contain a manifest.json matching this shape.
+ */
+export interface AddonManifest {
+    /** Unique addon identifier (e.g. "crewly-pro") */
+    name: string;
+    /** Semver version string */
+    version: string;
+    /** Path to the compiled entrypoint relative to the addon directory */
+    entrypoint: string;
+    /** Human-readable description */
+    description?: string;
+    /** Author name or organization */
+    author?: string;
+    /** SPDX license identifier */
+    license?: string;
+}
+/**
+ * The export contract for an addon's entrypoint module.
+ * The addon loader calls `register()` on startup and optionally
+ * `unregister()` on shutdown.
+ */
+export interface AddonModule {
+    /**
+     * Called during server startup to let the addon attach routes,
+     * WebSocket servers, middleware, or other functionality.
+     *
+     * @param app - The Express application instance
+     * @param server - The underlying HTTP server (for WS upgrades)
+     */
+    register(app: Application, server: HttpServer): void | Promise<void>;
+    /**
+     * Optional cleanup hook called during server shutdown.
+     */
+    unregister?(): void | Promise<void>;
+}
+/**
+ * Internal record of a successfully loaded addon.
+ */
+export interface LoadedAddon {
+    /** Parsed manifest data */
+    manifest: AddonManifest;
+    /** The imported module */
+    module: AddonModule;
+    /** Absolute path to the addon directory */
+    path: string;
+    /** Timestamp when the addon was loaded */
+    loadedAt: Date;
+}
+//# sourceMappingURL=addon.types.d.ts.map

package/dist/backend/backend/src/services/addon/addon.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"addon.types.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/addon/addon.types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,MAAM,CAAC;AAMjD;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC7B,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,UAAU,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAMD;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC3B;;;;;;OAMG;IACH,QAAQ,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErE;;OAEG;IACH,UAAU,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC;AAMD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC3B,2BAA2B;IAC3B,QAAQ,EAAE,aAAa,CAAC;IACxB,0BAA0B;IAC1B,MAAM,EAAE,WAAW,CAAC;IACpB,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,QAAQ,EAAE,IAAI,CAAC;CACf"}

package/dist/backend/backend/src/services/addon/addon.types.js

@@ -0,0 +1,11 @@
+/**
+ * Addon System Types
+ *
+ * Defines the manifest format, addon interface, and registration
+ * contract for the Crewly addon/plugin system. Pro and third-party
+ * extensions implement these interfaces to hook into the server.
+ *
+ * @module services/addon/addon.types
+ */
+export {};
+//# sourceMappingURL=addon.types.js.map

package/dist/backend/backend/src/services/addon/addon.types.js.map

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

package/dist/backend/backend/src/services/addon/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Addon service barrel exports
+ *
+ * @module services/addon
+ */
+export { AddonLoaderService } from './addon-loader.service.js';
+export type { AddonManifest, AddonModule, LoadedAddon } from './addon.types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/backend/backend/src/services/addon/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/addon/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/backend/backend/src/services/addon/index.js

@@ -0,0 +1,7 @@
+/**
+ * Addon service barrel exports
+ *
+ * @module services/addon
+ */
+export { AddonLoaderService } from './addon-loader.service.js';
+//# sourceMappingURL=index.js.map

package/dist/backend/backend/src/services/addon/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../backend/src/services/addon/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/backend/backend/src/services/agent/agent-registration.service.js

@@ -2007,8 +2007,8 @@ After checking in, just say "Ready for tasks" and wait for me to send you work.`
                         error: `Crewly Agent runtime for '${sessionName}' is not initialized`,
                     };
                 }
-                // Extract conversationId from [CHAT:xxx] prefix for response routing
-                const chatPrefixMatch = message.match(/^\[CHAT:([^\]]+)\]\s*/);
+                // Extract conversationId from [CHAT:xxx] or [GCHAT:xxx ...] prefix for response routing
+                const chatPrefixMatch = message.match(/^\[(?:G?CHAT):([^\]\s]+)[^\]]*\]\s*/);
                 const incomingConversationId = chatPrefixMatch?.[1];
                 // Extract Slack context from [SLACK:channelId:threadTs] marker if present (Bug 5).
                 // This allows crewly-agent to auto-fill reply_slack with the correct thread.