@agentlang/agentmanager 0.0.3

package/libs/project-provider/src/services/filesystem-registry.service.js

@@ -0,0 +1,231 @@
+'use strict';
+var __decorate =
+  (this && this.__decorate) ||
+  function (decorators, target, key, desc) {
+    var c = arguments.length,
+      r =
+        c < 3
+          ? target
+          : desc === null
+            ? (desc = Object.getOwnPropertyDescriptor(target, key))
+            : desc,
+      d;
+    if (typeof Reflect === 'object' && typeof Reflect.decorate === 'function')
+      r = Reflect.decorate(decorators, target, key, desc);
+    else
+      for (var i = decorators.length - 1; i >= 0; i--)
+        if ((d = decorators[i]))
+          r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return (c > 3 && r && Object.defineProperty(target, key, r), r);
+  };
+var __metadata =
+  (this && this.__metadata) ||
+  function (k, v) {
+    if (typeof Reflect === 'object' && typeof Reflect.metadata === 'function')
+      return Reflect.metadata(k, v);
+  };
+var __param =
+  (this && this.__param) ||
+  function (paramIndex, decorator) {
+    return function (target, key) {
+      decorator(target, key, paramIndex);
+    };
+  };
+var FileSystemRegistryService_1;
+Object.defineProperty(exports, '__esModule', { value: true });
+exports.FileSystemRegistryService = void 0;
+const common_1 = require('@nestjs/common');
+const promises_1 = require('node:fs/promises');
+const node_path_1 = require('node:path');
+const registry_errors_1 = require('../errors/registry.errors');
+const al_parser_service_1 = require('./al-parser.service');
+const constants_1 = require('../constants');
+let FileSystemRegistryService =
+  (FileSystemRegistryService_1 = class FileSystemRegistryService {
+    registryPath;
+    alParser;
+    logger = new common_1.Logger(FileSystemRegistryService_1.name);
+    constructor(registryPath, alParser) {
+      this.registryPath = registryPath;
+      this.alParser = alParser;
+    }
+    projectDir(projectId) {
+      return (0, node_path_1.join)(this.registryPath, projectId);
+    }
+    employeeDir(projectId, employeeId) {
+      return (0, node_path_1.join)(this.registryPath, projectId, employeeId);
+    }
+    async projectExists(projectId) {
+      try {
+        const s = await (0, promises_1.stat)(this.projectDir(projectId));
+        return s.isDirectory();
+      } catch {
+        return false;
+      }
+    }
+    async employeeExists(projectId, employeeId) {
+      try {
+        const s = await (0, promises_1.stat)(
+          this.employeeDir(projectId, employeeId),
+        );
+        return s.isDirectory();
+      } catch {
+        return false;
+      }
+    }
+    async listProjects() {
+      await (0, promises_1.mkdir)(this.registryPath, { recursive: true });
+      const entries = await (0, promises_1.readdir)(this.registryPath, {
+        withFileTypes: true,
+      });
+      const projects = [];
+      for (const entry of entries) {
+        if (!entry.isDirectory()) continue;
+        const projDir = (0, node_path_1.join)(this.registryPath, entry.name);
+        const children = await (0, promises_1.readdir)(projDir, {
+          withFileTypes: true,
+        });
+        const employeeCount = children.filter((c) => c.isDirectory()).length;
+        projects.push({ id: entry.name, employeeCount });
+      }
+      return projects;
+    }
+    async createProject(id) {
+      if (await this.projectExists(id)) {
+        throw new registry_errors_1.ProjectAlreadyExistsError(id);
+      }
+      await (0, promises_1.mkdir)(this.projectDir(id), { recursive: true });
+      return { id, employeeCount: 0 };
+    }
+    async deleteProject(id) {
+      if (!(await this.projectExists(id))) {
+        throw new registry_errors_1.ProjectNotFoundError(id);
+      }
+      await (0, promises_1.rm)(this.projectDir(id), {
+        recursive: true,
+        force: true,
+      });
+    }
+    async listEmployees(projectId) {
+      if (!(await this.projectExists(projectId))) {
+        throw new registry_errors_1.ProjectNotFoundError(projectId);
+      }
+      const projDir = this.projectDir(projectId);
+      const entries = await (0, promises_1.readdir)(projDir, {
+        withFileTypes: true,
+      });
+      const employees = [];
+      for (const entry of entries) {
+        if (!entry.isDirectory()) continue;
+        const empDir = (0, node_path_1.join)(projDir, entry.name);
+        const parsed = await this.alParser.parseEmployeeDir(empDir);
+        employees.push({
+          id: entry.name,
+          projectId,
+          module: parsed.module,
+        });
+      }
+      return employees;
+    }
+    async getEmployee(projectId, employeeId) {
+      if (!(await this.projectExists(projectId))) {
+        throw new registry_errors_1.ProjectNotFoundError(projectId);
+      }
+      if (!(await this.employeeExists(projectId, employeeId))) {
+        throw new registry_errors_1.EmployeeNotFoundError(
+          projectId,
+          employeeId,
+        );
+      }
+      const empDir = this.employeeDir(projectId, employeeId);
+      const parsed = await this.alParser.parseEmployeeDir(empDir);
+      return {
+        id: employeeId,
+        projectId,
+        module: parsed.module,
+        capabilities: parsed.capabilities,
+      };
+    }
+    async registerEmployee(projectId, sourcePath, employeeId) {
+      if (!(await this.projectExists(projectId))) {
+        throw new registry_errors_1.ProjectNotFoundError(projectId);
+      }
+      try {
+        await (0, promises_1.stat)(sourcePath);
+      } catch {
+        throw new registry_errors_1.RegistryError(
+          `Source path does not exist: ${sourcePath}`,
+          common_1.HttpStatus.BAD_REQUEST,
+        );
+      }
+      const id = employeeId ?? (0, node_path_1.basename)(sourcePath);
+      if (await this.employeeExists(projectId, id)) {
+        throw new registry_errors_1.EmployeeAlreadyExistsError(projectId, id);
+      }
+      const destDir = this.employeeDir(projectId, id);
+      await (0, promises_1.cp)(sourcePath, destDir, { recursive: true });
+      const parsed = await this.alParser.parseEmployeeDir(destDir);
+      return {
+        id,
+        projectId,
+        module: parsed.module,
+        capabilities: parsed.capabilities,
+      };
+    }
+    async createEmployee(projectId, employeeId, pkg) {
+      if (!(await this.projectExists(projectId))) {
+        throw new registry_errors_1.ProjectNotFoundError(projectId);
+      }
+      if (await this.employeeExists(projectId, employeeId)) {
+        throw new registry_errors_1.EmployeeAlreadyExistsError(
+          projectId,
+          employeeId,
+        );
+      }
+      const empDir = this.employeeDir(projectId, employeeId);
+      const srcDir = (0, node_path_1.join)(empDir, 'src');
+      await (0, promises_1.mkdir)(srcDir, { recursive: true });
+      await (0, promises_1.writeFile)(
+        (0, node_path_1.join)(empDir, 'package.json'),
+        JSON.stringify(pkg, null, 2) + '\n',
+        'utf-8',
+      );
+      return {
+        id: employeeId,
+        projectId,
+        module: null,
+        capabilities: [],
+      };
+    }
+    async removeEmployee(projectId, employeeId) {
+      if (!(await this.projectExists(projectId))) {
+        throw new registry_errors_1.ProjectNotFoundError(projectId);
+      }
+      if (!(await this.employeeExists(projectId, employeeId))) {
+        throw new registry_errors_1.EmployeeNotFoundError(
+          projectId,
+          employeeId,
+        );
+      }
+      await (0, promises_1.rm)(this.employeeDir(projectId, employeeId), {
+        recursive: true,
+        force: true,
+      });
+    }
+  });
+exports.FileSystemRegistryService = FileSystemRegistryService;
+exports.FileSystemRegistryService =
+  FileSystemRegistryService =
+  FileSystemRegistryService_1 =
+    __decorate(
+      [
+        (0, common_1.Injectable)(),
+        __param(0, (0, common_1.Inject)(constants_1.REGISTRY_PATH)),
+        __metadata('design:paramtypes', [
+          String,
+          al_parser_service_1.AlParserService,
+        ]),
+      ],
+      FileSystemRegistryService,
+    );
+//# sourceMappingURL=filesystem-registry.service.js.map

package/libs/project-provider/src/services/filesystem-registry.service.js.map

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

package/libs/project-provider/src/services/filesystem-registry.service.ts

@@ -0,0 +1,271 @@
+import { Injectable, Inject, Logger, HttpStatus } from '@nestjs/common';
+import {
+  mkdir,
+  readdir,
+  rm,
+  cp,
+  stat,
+  writeFile,
+  readFile,
+} from 'node:fs/promises';
+import { join, basename } from 'node:path';
+import {
+  Project,
+  EmployeeSummary,
+  EmployeeDetail,
+  EmployeePackage,
+} from '../types/project.types';
+import type { ProjectMetadata } from '../interfaces/registry-provider.interface';
+import { RegistryProvider } from '../interfaces/registry-provider.interface';
+import {
+  RegistryError,
+  ProjectNotFoundError,
+  ProjectAlreadyExistsError,
+  EmployeeNotFoundError,
+  EmployeeAlreadyExistsError,
+} from '../errors/registry.errors';
+import { AlParserService } from './al-parser.service';
+import { REGISTRY_PATH } from '../constants';
+
+@Injectable()
+export class FileSystemRegistryService implements RegistryProvider {
+  private readonly logger = new Logger(FileSystemRegistryService.name);
+
+  constructor(
+    @Inject(REGISTRY_PATH) private readonly registryPath: string,
+    private readonly alParser: AlParserService,
+  ) {}
+
+  private projectDir(projectId: string): string {
+    return join(this.registryPath, projectId);
+  }
+
+  private employeeDir(projectId: string, employeeId: string): string {
+    return join(this.registryPath, projectId, employeeId);
+  }
+
+  private async projectExists(projectId: string): Promise<boolean> {
+    try {
+      const s = await stat(this.projectDir(projectId));
+      return s.isDirectory();
+    } catch {
+      return false;
+    }
+  }
+
+  private async employeeExists(
+    projectId: string,
+    employeeId: string,
+  ): Promise<boolean> {
+    try {
+      const s = await stat(this.employeeDir(projectId, employeeId));
+      return s.isDirectory();
+    } catch {
+      return false;
+    }
+  }
+
+  private readonly metadataFile = 'project.json';
+
+  private async readProjectMetadata(
+    projectId: string,
+  ): Promise<ProjectMetadata | null> {
+    try {
+      const path = join(this.projectDir(projectId), this.metadataFile);
+      const raw = await readFile(path, 'utf-8');
+      return JSON.parse(raw) as ProjectMetadata;
+    } catch {
+      return null;
+    }
+  }
+
+  private async writeProjectMetadata(
+    projectId: string,
+    metadata: ProjectMetadata,
+  ): Promise<void> {
+    const path = join(this.projectDir(projectId), this.metadataFile);
+    await writeFile(path, JSON.stringify(metadata, null, 2) + '\n', 'utf-8');
+  }
+
+  async listProjects(): Promise<Project[]> {
+    await mkdir(this.registryPath, { recursive: true });
+    const entries = await readdir(this.registryPath, { withFileTypes: true });
+    const projects: Project[] = [];
+    for (const entry of entries) {
+      if (!entry.isDirectory()) continue;
+      const projDir = join(this.registryPath, entry.name);
+      const children = await readdir(projDir, { withFileTypes: true });
+      const employeeCount = children.filter((c) => c.isDirectory()).length;
+      const metadata = await this.readProjectMetadata(entry.name);
+      projects.push({
+        id: entry.name,
+        employeeCount,
+        ...metadata,
+      });
+    }
+    return projects;
+  }
+
+  async createProject(
+    id: string,
+    metadata?: ProjectMetadata,
+  ): Promise<Project> {
+    if (await this.projectExists(id)) {
+      throw new ProjectAlreadyExistsError(id);
+    }
+    await mkdir(this.projectDir(id), { recursive: true });
+    if (metadata && Object.keys(metadata).length > 0) {
+      await this.writeProjectMetadata(id, metadata);
+    }
+    return { id, employeeCount: 0, ...metadata };
+  }
+
+  async getProject(id: string): Promise<Project | null> {
+    if (!(await this.projectExists(id))) return null;
+    const projDir = this.projectDir(id);
+    const children = await readdir(projDir, { withFileTypes: true });
+    const employeeCount = children.filter((c) => c.isDirectory()).length;
+    const metadata = await this.readProjectMetadata(id);
+    return { id, employeeCount, ...metadata };
+  }
+
+  async updateProjectMetadata(
+    id: string,
+    metadata: ProjectMetadata,
+  ): Promise<Project> {
+    if (!(await this.projectExists(id))) {
+      throw new ProjectNotFoundError(id);
+    }
+    const existing = await this.readProjectMetadata(id);
+    const merged = { ...existing, ...metadata };
+    await this.writeProjectMetadata(id, merged);
+    const projDir = this.projectDir(id);
+    const children = await readdir(projDir, { withFileTypes: true });
+    const employeeCount = children.filter((c) => c.isDirectory()).length;
+    return { id, employeeCount, ...merged };
+  }
+
+  async deleteProject(id: string): Promise<void> {
+    if (!(await this.projectExists(id))) {
+      throw new ProjectNotFoundError(id);
+    }
+    await rm(this.projectDir(id), { recursive: true, force: true });
+  }
+
+  async listEmployees(projectId: string): Promise<EmployeeSummary[]> {
+    if (!(await this.projectExists(projectId))) {
+      throw new ProjectNotFoundError(projectId);
+    }
+    const projDir = this.projectDir(projectId);
+    const entries = await readdir(projDir, { withFileTypes: true });
+    const employees: EmployeeSummary[] = [];
+    for (const entry of entries) {
+      if (!entry.isDirectory()) continue;
+      const empDir = join(projDir, entry.name);
+      const parsed = await this.alParser.parseEmployeeDir(empDir);
+      employees.push({
+        id: entry.name,
+        projectId,
+        module: parsed.module,
+      });
+    }
+    return employees;
+  }
+
+  async getEmployee(
+    projectId: string,
+    employeeId: string,
+  ): Promise<EmployeeDetail> {
+    if (!(await this.projectExists(projectId))) {
+      throw new ProjectNotFoundError(projectId);
+    }
+    if (!(await this.employeeExists(projectId, employeeId))) {
+      throw new EmployeeNotFoundError(projectId, employeeId);
+    }
+    const empDir = this.employeeDir(projectId, employeeId);
+    const parsed = await this.alParser.parseEmployeeDir(empDir);
+    return {
+      id: employeeId,
+      projectId,
+      module: parsed.module,
+      capabilities: parsed.capabilities,
+    };
+  }
+
+  async registerEmployee(
+    projectId: string,
+    sourcePath: string,
+    employeeId?: string,
+  ): Promise<EmployeeDetail> {
+    if (!(await this.projectExists(projectId))) {
+      throw new ProjectNotFoundError(projectId);
+    }
+
+    try {
+      await stat(sourcePath);
+    } catch {
+      throw new RegistryError(
+        `Source path does not exist: ${sourcePath}`,
+        HttpStatus.BAD_REQUEST,
+      );
+    }
+
+    const id = employeeId ?? basename(sourcePath);
+    if (await this.employeeExists(projectId, id)) {
+      throw new EmployeeAlreadyExistsError(projectId, id);
+    }
+
+    const destDir = this.employeeDir(projectId, id);
+    await cp(sourcePath, destDir, { recursive: true });
+
+    const parsed = await this.alParser.parseEmployeeDir(destDir);
+    return {
+      id,
+      projectId,
+      module: parsed.module,
+      capabilities: parsed.capabilities,
+    };
+  }
+
+  async createEmployee(
+    projectId: string,
+    employeeId: string,
+    pkg: EmployeePackage,
+  ): Promise<EmployeeDetail> {
+    if (!(await this.projectExists(projectId))) {
+      throw new ProjectNotFoundError(projectId);
+    }
+    if (await this.employeeExists(projectId, employeeId)) {
+      throw new EmployeeAlreadyExistsError(projectId, employeeId);
+    }
+
+    const empDir = this.employeeDir(projectId, employeeId);
+    const srcDir = join(empDir, 'src');
+    await mkdir(srcDir, { recursive: true });
+    await writeFile(
+      join(empDir, 'package.json'),
+      JSON.stringify(pkg, null, 2) + '\n',
+      'utf-8',
+    );
+
+    return {
+      id: employeeId,
+      projectId,
+      module: null,
+      capabilities: [],
+    };
+  }
+
+  async removeEmployee(projectId: string, employeeId: string): Promise<void> {
+    if (!(await this.projectExists(projectId))) {
+      throw new ProjectNotFoundError(projectId);
+    }
+    if (!(await this.employeeExists(projectId, employeeId))) {
+      throw new EmployeeNotFoundError(projectId, employeeId);
+    }
+    await rm(this.employeeDir(projectId, employeeId), {
+      recursive: true,
+      force: true,
+    });
+  }
+}

package/libs/project-provider/src/services/http-inbox-client.service.d.ts

@@ -0,0 +1,7 @@
+import { InboxClient } from '../interfaces/inbox-client.interface';
+export declare class HttpInboxClientService implements InboxClient {
+  private readonly baseUrl;
+  private readonly logger;
+  constructor(baseUrl: string);
+  notify(inbox: string, subject: string, body: string): Promise<void>;
+}

package/libs/project-provider/src/services/http-inbox-client.service.js

@@ -0,0 +1,66 @@
+'use strict';
+var __decorate =
+  (this && this.__decorate) ||
+  function (decorators, target, key, desc) {
+    var c = arguments.length,
+      r =
+        c < 3
+          ? target
+          : desc === null
+            ? (desc = Object.getOwnPropertyDescriptor(target, key))
+            : desc,
+      d;
+    if (typeof Reflect === 'object' && typeof Reflect.decorate === 'function')
+      r = Reflect.decorate(decorators, target, key, desc);
+    else
+      for (var i = decorators.length - 1; i >= 0; i--)
+        if ((d = decorators[i]))
+          r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return (c > 3 && r && Object.defineProperty(target, key, r), r);
+  };
+var __metadata =
+  (this && this.__metadata) ||
+  function (k, v) {
+    if (typeof Reflect === 'object' && typeof Reflect.metadata === 'function')
+      return Reflect.metadata(k, v);
+  };
+var HttpInboxClientService_1;
+Object.defineProperty(exports, '__esModule', { value: true });
+exports.HttpInboxClientService = void 0;
+const common_1 = require('@nestjs/common');
+let HttpInboxClientService =
+  (HttpInboxClientService_1 = class HttpInboxClientService {
+    baseUrl;
+    logger = new common_1.Logger(HttpInboxClientService_1.name);
+    constructor(baseUrl) {
+      this.baseUrl = baseUrl;
+    }
+    async notify(inbox, subject, body) {
+      const url = `${this.baseUrl}/api/inboxes/${encodeURIComponent(inbox)}/messages`;
+      this.logger.debug(`Sending notification to inbox ${inbox}`);
+      const response = await fetch(url, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+          from: { kind: 'agentcraft', id: 'agentcraft' },
+          subject,
+          body,
+          kind: 'notification',
+        }),
+      });
+      if (!response.ok) {
+        const text = await response.text().catch(() => '');
+        this.logger.warn(`Inbox push failed (${response.status}): ${text}`);
+        throw new Error(`Inbox push failed (${response.status}): ${text}`);
+      }
+    }
+  });
+exports.HttpInboxClientService = HttpInboxClientService;
+exports.HttpInboxClientService =
+  HttpInboxClientService =
+  HttpInboxClientService_1 =
+    __decorate(
+      [(0, common_1.Injectable)(), __metadata('design:paramtypes', [String])],
+      HttpInboxClientService,
+    );
+//# sourceMappingURL=http-inbox-client.service.js.map

package/libs/project-provider/src/services/http-inbox-client.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-inbox-client.service.js","sourceRoot":"","sources":["http-inbox-client.service.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAAA,2CAAoD;AAI7C,IAAM,sBAAsB,8BAA5B,MAAM,sBAAsB;IAGJ;IAFZ,MAAM,GAAG,IAAI,eAAM,CAAC,wBAAsB,CAAC,IAAI,CAAC,CAAC;IAElE,YAA6B,OAAe;QAAf,YAAO,GAAP,OAAO,CAAQ;IAAG,CAAC;IAEhD,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,OAAe,EAAE,IAAY;QACvD,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,gBAAgB,kBAAkB,CAAC,KAAK,CAAC,WAAW,CAAC;QAChF,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,iCAAiC,KAAK,EAAE,CAAC,CAAC;QAC5D,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,IAAI,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,YAAY,EAAE;gBAC9C,OAAO;gBACP,IAAI;gBACJ,IAAI,EAAE,cAAc;aACrB,CAAC;SACH,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YACnD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,sBAAsB,QAAQ,CAAC,MAAM,MAAM,IAAI,EAAE,CAAC,CAAC;YACpE,MAAM,IAAI,KAAK,CAAC,sBAAsB,QAAQ,CAAC,MAAM,MAAM,IAAI,EAAE,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;CACF,CAAA;AAxBY,wDAAsB;iCAAtB,sBAAsB;IADlC,IAAA,mBAAU,GAAE;;GACA,sBAAsB,CAwBlC"}

package/libs/project-provider/src/services/http-inbox-client.service.ts

@@ -0,0 +1,29 @@
+import { Injectable, Logger } from '@nestjs/common';
+import { InboxClient } from '../interfaces/inbox-client.interface';
+
+@Injectable()
+export class HttpInboxClientService implements InboxClient {
+  private readonly logger = new Logger(HttpInboxClientService.name);
+
+  constructor(private readonly baseUrl: string) {}
+
+  async notify(inbox: string, subject: string, body: string): Promise<void> {
+    const url = `${this.baseUrl}/api/inboxes/${encodeURIComponent(inbox)}/messages`;
+    this.logger.debug(`Sending notification to inbox ${inbox}`);
+    const response = await fetch(url, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({
+        from: { kind: 'agentcraft', id: 'agentcraft' },
+        subject,
+        body,
+        kind: 'notification',
+      }),
+    });
+    if (!response.ok) {
+      const text = await response.text().catch(() => '');
+      this.logger.warn(`Inbox push failed (${response.status}): ${text}`);
+      throw new Error(`Inbox push failed (${response.status}): ${text}`);
+    }
+  }
+}

package/libs/project-provider/src/services/noop-inbox-client.service.d.ts

@@ -0,0 +1,4 @@
+import { InboxClient } from '../interfaces/inbox-client.interface';
+export declare class NoopInboxClientService implements InboxClient {
+  notify(): Promise<void>;
+}

package/libs/project-provider/src/services/noop-inbox-client.service.js

@@ -0,0 +1,32 @@
+'use strict';
+var __decorate =
+  (this && this.__decorate) ||
+  function (decorators, target, key, desc) {
+    var c = arguments.length,
+      r =
+        c < 3
+          ? target
+          : desc === null
+            ? (desc = Object.getOwnPropertyDescriptor(target, key))
+            : desc,
+      d;
+    if (typeof Reflect === 'object' && typeof Reflect.decorate === 'function')
+      r = Reflect.decorate(decorators, target, key, desc);
+    else
+      for (var i = decorators.length - 1; i >= 0; i--)
+        if ((d = decorators[i]))
+          r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return (c > 3 && r && Object.defineProperty(target, key, r), r);
+  };
+Object.defineProperty(exports, '__esModule', { value: true });
+exports.NoopInboxClientService = void 0;
+const common_1 = require('@nestjs/common');
+let NoopInboxClientService = class NoopInboxClientService {
+  async notify() {}
+};
+exports.NoopInboxClientService = NoopInboxClientService;
+exports.NoopInboxClientService = NoopInboxClientService = __decorate(
+  [(0, common_1.Injectable)()],
+  NoopInboxClientService,
+);
+//# sourceMappingURL=noop-inbox-client.service.js.map

package/libs/project-provider/src/services/noop-inbox-client.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop-inbox-client.service.js","sourceRoot":"","sources":["noop-inbox-client.service.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAA4C;AAIrC,IAAM,sBAAsB,GAA5B,MAAM,sBAAsB;IACjC,KAAK,CAAC,MAAM;IAEZ,CAAC;CACF,CAAA;AAJY,wDAAsB;iCAAtB,sBAAsB;IADlC,IAAA,mBAAU,GAAE;GACA,sBAAsB,CAIlC"}

package/libs/project-provider/src/services/noop-inbox-client.service.ts

@@ -0,0 +1,9 @@
+import { Injectable } from '@nestjs/common';
+import { InboxClient } from '../interfaces/inbox-client.interface';
+
+@Injectable()
+export class NoopInboxClientService implements InboxClient {
+  async notify(_inbox: string, _subject: string, _body: string): Promise<void> {
+    // No-op
+  }
+}