@agentlang/agentmanager 0.0.3

package/apps/monolith/src/app.module.ts

@@ -0,0 +1,75 @@
+import { Module } from '@nestjs/common';
+import { APP_FILTER, APP_GUARD, APP_INTERCEPTOR } from '@nestjs/core';
+import { ConfigModule } from '@nestjs/config';
+import type { ConfigType } from '@nestjs/config';
+import { ThrottlerModule, ThrottlerGuard } from '@nestjs/throttler';
+import {
+  ProjectProviderModule,
+  INBOX_CLIENT,
+  INBOX_HANDLER,
+  DirectInboxClientService,
+} from '@app/project-provider';
+import { AgentcraftModule } from '@app/agentcraft';
+import {
+  DatabaseModule,
+  DomainExceptionFilter,
+  LoggingInterceptor,
+} from '@app/common';
+import { AgentManagerCoreModule } from '../../agentmanager/src/agentmanager-core.module';
+import { AgentcraftCoreModule } from '../../agentcraft/src/agentcraft-core.module';
+import { FabricCoreModule } from '../../fabric/src/fabric-core.module';
+import { IntegrationsCoreModule } from '../../integrations/src/integrations-core.module';
+import { InboxService } from '../../agentmanager/src/inbox/inbox.service';
+import monolithConfig from './config/configuration';
+import fabricConfig from '../../fabric/src/config/configuration';
+import { fabricEntities } from '../../fabric/src/database/entities';
+import { MonolithHealthModule } from './health/health.module';
+
+@Module({
+  imports: [
+    ConfigModule.forRoot({
+      isGlobal: true,
+      load: [monolithConfig, fabricConfig],
+    }),
+    ThrottlerModule.forRoot([{ ttl: 60_000, limit: 100 }]),
+
+    // Database — shared single instance in monolith
+    DatabaseModule.forRootAsync({
+      inject: [fabricConfig.KEY],
+      useFactory: (config: ConfigType<typeof fabricConfig>) => ({
+        dataPath: config.dataPath,
+        database: config.database,
+        embeddedDbPort: config.embeddedDbPort,
+        embeddedDbName: config.embeddedDbName,
+        entities: fabricEntities,
+      }),
+    }),
+
+    // Global library modules — registered once
+    ProjectProviderModule.forRootAsync(),
+    AgentcraftModule.forRootAsync(),
+
+    // App CoreModules
+    AgentManagerCoreModule.forRoot('agentmanager/api'),
+    AgentcraftCoreModule.forRoot('agentcraft/api'),
+    FabricCoreModule.forRoot('fabric/api'),
+    IntegrationsCoreModule.forRoot('integrations/api'),
+
+    MonolithHealthModule,
+  ],
+  providers: [
+    { provide: APP_FILTER, useClass: DomainExceptionFilter },
+    { provide: APP_GUARD, useClass: ThrottlerGuard },
+    { provide: APP_INTERCEPTOR, useClass: LoggingInterceptor },
+    // Override InboxClient: direct DI instead of HTTP
+    {
+      provide: INBOX_HANDLER,
+      useExisting: InboxService,
+    },
+    {
+      provide: INBOX_CLIENT,
+      useClass: DirectInboxClientService,
+    },
+  ],
+})
+export class MonolithAppModule {}

package/apps/monolith/src/config/configuration.ts

@@ -0,0 +1,93 @@
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { Logger } from '@nestjs/common';
+import { z } from 'zod';
+
+const configSchema = z.object({
+  port: z.number().int().positive(),
+  registryPath: z.string().min(1),
+  inboxesPath: z.string().min(1),
+  outputDir: z.string().min(1),
+  llm: z
+    .object({
+      provider: z.string(),
+      model: z.string(),
+      apiKey: z.string(),
+    })
+    .nullable(),
+  architect: z.object({
+    debounceMs: z.number().int().nonnegative(),
+    phaseRetries: z.number().int().nonnegative(),
+    subAppRetries: z.number().int().nonnegative(),
+  }),
+  deploymentService: z.object({ baseUrl: z.string() }).optional(),
+  cors: z.object({ origins: z.array(z.string()) }),
+});
+
+export type MonolithConfiguration = z.infer<typeof configSchema>;
+
+export default (): MonolithConfiguration => {
+  const logger = new Logger('MonolithConfig');
+  const configPath = resolve(process.env.CONFIG_PATH ?? './config.json');
+  let parsed: Record<string, unknown> = {};
+
+  try {
+    const raw = readFileSync(configPath, 'utf-8');
+    parsed = JSON.parse(raw);
+  } catch {
+    // Fall back to defaults / env vars
+  }
+
+  const raw = {
+    port: parsed.port ?? parseInt(process.env.PORT ?? '3000', 10),
+    registryPath:
+      parsed.registryPath ?? process.env.REGISTRY_PATH ?? './registry',
+    inboxesPath: parsed.inboxesPath ?? process.env.INBOXES_PATH ?? './inboxes',
+    outputDir: parsed.outputDir ?? process.env.CRAFT_OUTPUT_DIR ?? '.',
+    llm: buildLlmConfig(),
+    architect: {
+      debounceMs: parseInt(process.env.ARCHITECT_DEBOUNCE_MS || '5000', 10),
+      phaseRetries: parseInt(process.env.ARCHITECT_PHASE_RETRIES || '2', 10),
+      subAppRetries: parseInt(process.env.ARCHITECT_SUBAPP_RETRIES || '2', 10),
+    },
+    deploymentService: parsed.deploymentService ?? undefined,
+    cors: {
+      origins:
+        (parsed.cors as Record<string, unknown>)?.origins ??
+        (process.env.CORS_ORIGINS
+          ? process.env.CORS_ORIGINS.split(',').map((o: string) => o.trim())
+          : [
+              'http://localhost:3000',
+              'http://127.0.0.1:3000',
+              'http://localhost:5173',
+              'http://127.0.0.1:5173',
+            ]),
+    },
+  };
+
+  const result = configSchema.safeParse(raw);
+  if (!result.success) {
+    logger.error(`Invalid configuration: ${result.error.message}`);
+    throw new Error(`Invalid Monolith configuration: ${result.error.message}`);
+  }
+
+  return result.data;
+};
+
+function buildLlmConfig() {
+  const provider = process.env.CRAFT_PROVIDER || 'anthropic';
+  const apiKey =
+    process.env.CRAFT_API_KEY ||
+    process.env.ANTHROPIC_API_KEY ||
+    process.env.OPENAI_API_KEY;
+
+  if (!apiKey) return null;
+
+  return {
+    provider,
+    model:
+      process.env.CRAFT_MODEL ||
+      (provider === 'anthropic' ? 'claude-sonnet-4-6' : 'gpt-4o'),
+    apiKey,
+  };
+}

package/apps/monolith/src/health/health.controller.ts

@@ -0,0 +1,22 @@
+import { Controller, Get } from '@nestjs/common';
+import {
+  HealthCheck,
+  HealthCheckService,
+  MemoryHealthIndicator,
+} from '@nestjs/terminus';
+
+@Controller('health')
+export class MonolithHealthController {
+  constructor(
+    private health: HealthCheckService,
+    private memory: MemoryHealthIndicator,
+  ) {}
+
+  @Get()
+  @HealthCheck()
+  check() {
+    return this.health.check([
+      () => this.memory.checkHeap('memory_heap', 256 * 1024 * 1024),
+    ]);
+  }
+}

package/apps/monolith/src/health/health.module.ts

@@ -0,0 +1,9 @@
+import { Module } from '@nestjs/common';
+import { TerminusModule } from '@nestjs/terminus';
+import { MonolithHealthController } from './health.controller';
+
+@Module({
+  imports: [TerminusModule],
+  controllers: [MonolithHealthController],
+})
+export class MonolithHealthModule {}

package/apps/monolith/src/main.ts

@@ -0,0 +1,56 @@
+import { NestFactory } from '@nestjs/core';
+import {
+  FastifyAdapter,
+  NestFastifyApplication,
+} from '@nestjs/platform-fastify';
+import { Logger } from '@nestjs/common';
+import { ZodValidationPipe } from 'nestjs-zod';
+import { SwaggerModule, DocumentBuilder } from '@nestjs/swagger';
+import helmet from '@fastify/helmet';
+import { MonolithAppModule } from './app.module';
+import { ConfigService } from '@nestjs/config';
+
+async function bootstrap() {
+  const app = await NestFactory.create<NestFastifyApplication>(
+    MonolithAppModule,
+    new FastifyAdapter({ bodyLimit: 1_048_576 }),
+  );
+
+  await app.register(helmet as Parameters<typeof app.register>[0], {
+    contentSecurityPolicy: false,
+  });
+
+  const config = app.get(ConfigService);
+  const port = config.get<number>('port', 3000);
+  const corsOrigins = config.get<string[]>('cors.origins', [
+    'http://localhost:3000',
+    'http://127.0.0.1:3000',
+    'http://localhost:5173',
+    'http://127.0.0.1:5173',
+  ]);
+
+  app.enableCors({ origin: corsOrigins, credentials: true });
+  app.enableShutdownHooks();
+  app.useGlobalPipes(new ZodValidationPipe());
+
+  const swaggerConfig = new DocumentBuilder()
+    .setTitle('AgentManager Monolith API')
+    .setDescription(
+      'Unified API: AgentManager + Agentcraft + Fabric in a single process',
+    )
+    .setVersion('1.0')
+    .build();
+  const document = SwaggerModule.createDocument(app, swaggerConfig);
+  SwaggerModule.setup('docs', app, document);
+
+  await app.listen(port, '0.0.0.0');
+
+  const logger = new Logger('Bootstrap');
+  logger.log(`Monolith listening on port ${port}`);
+}
+
+bootstrap().catch((err) => {
+  const logger = new Logger('Bootstrap');
+  logger.error(`Failed to start Monolith: ${err}`);
+  process.exit(1);
+});

package/apps/monolith/tsconfig.app.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "outDir": "../../dist/apps/monolith"
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "test", "**/*spec.ts"]
+}

package/libs/agentcraft/src/agentcraft.module.d.ts

@@ -0,0 +1,12 @@
+import { DynamicModule } from '@nestjs/common';
+export interface LlmConfig {
+  provider: 'openai' | 'anthropic';
+  model: string;
+  apiKey: string;
+  baseUrl?: string;
+}
+export declare class AgentcraftModule {
+  static forRoot(llmConfig?: LlmConfig): DynamicModule;
+  static forRootAsync(): DynamicModule;
+  private static createLlmProvider;
+}

package/libs/agentcraft/src/agentcraft.module.js

@@ -0,0 +1,142 @@
+'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 AgentcraftModule_1;
+Object.defineProperty(exports, '__esModule', { value: true });
+exports.AgentcraftModule = void 0;
+const common_1 = require('@nestjs/common');
+const config_1 = require('@nestjs/config');
+const constants_1 = require('./constants');
+const anthropic_llm_service_1 = require('./services/anthropic-llm.service');
+const openai_llm_service_1 = require('./services/openai-llm.service');
+const craft_llm_adapter_service_1 = require('./services/craft-llm-adapter.service');
+const architect_loop_service_1 = require('./services/architect-loop.service');
+const pipeline_steps_service_1 = require('./services/pipeline-steps.service');
+const pipeline_state_service_1 = require('./services/pipeline-state.service');
+const output_parser_service_1 = require('./services/output-parser.service');
+const craft_config_service_1 = require('./services/craft-config.service');
+const api_adapter_service_1 = require('./services/api-adapter.service');
+const spec_fetcher_service_1 = require('./services/spec-fetcher.service');
+const registry_client_service_1 = require('./services/registry-client.service');
+const PIPELINE_SERVICES = [
+  pipeline_steps_service_1.PipelineStepsService,
+  pipeline_state_service_1.PipelineStateService,
+  output_parser_service_1.OutputParserService,
+  craft_config_service_1.CraftConfigService,
+  api_adapter_service_1.ApiAdapterService,
+  api_adapter_service_1.ApiAdapterFactory,
+  spec_fetcher_service_1.SpecFetcherService,
+  registry_client_service_1.RegistryClientService,
+];
+let AgentcraftModule = (AgentcraftModule_1 = class AgentcraftModule {
+  static forRoot(llmConfig) {
+    const providers = [
+      architect_loop_service_1.ArchitectLoopFactory,
+      ...PIPELINE_SERVICES,
+    ];
+    if (llmConfig) {
+      providers.push(
+        {
+          provide: constants_1.LLM_PROVIDER,
+          useFactory: () => AgentcraftModule_1.createLlmProvider(llmConfig),
+        },
+        {
+          provide: constants_1.CRAFT_LLM_PROVIDER,
+          useFactory: (llm) =>
+            new craft_llm_adapter_service_1.CraftLlmAdapterService(llm),
+          inject: [constants_1.LLM_PROVIDER],
+        },
+      );
+    }
+    return {
+      module: AgentcraftModule_1,
+      global: true,
+      providers,
+      exports: [
+        constants_1.LLM_PROVIDER,
+        constants_1.CRAFT_LLM_PROVIDER,
+        architect_loop_service_1.ArchitectLoopFactory,
+        ...PIPELINE_SERVICES,
+      ],
+    };
+  }
+  static forRootAsync() {
+    return {
+      module: AgentcraftModule_1,
+      global: true,
+      imports: [config_1.ConfigModule],
+      providers: [
+        architect_loop_service_1.ArchitectLoopFactory,
+        ...PIPELINE_SERVICES,
+        {
+          provide: constants_1.LLM_PROVIDER,
+          useFactory: (config) => {
+            const llmConfig = config.get('llm');
+            if (!llmConfig) return null;
+            return AgentcraftModule_1.createLlmProvider(llmConfig);
+          },
+          inject: [config_1.ConfigService],
+        },
+        {
+          provide: constants_1.CRAFT_LLM_PROVIDER,
+          useFactory: (llm) =>
+            llm
+              ? new craft_llm_adapter_service_1.CraftLlmAdapterService(llm)
+              : null,
+          inject: [constants_1.LLM_PROVIDER],
+        },
+      ],
+      exports: [
+        constants_1.LLM_PROVIDER,
+        constants_1.CRAFT_LLM_PROVIDER,
+        architect_loop_service_1.ArchitectLoopFactory,
+        ...PIPELINE_SERVICES,
+      ],
+    };
+  }
+  static createLlmProvider(llmConfig) {
+    switch (llmConfig.provider) {
+      case 'anthropic':
+        return new anthropic_llm_service_1.AnthropicLlmService(
+          llmConfig.model,
+          llmConfig.apiKey,
+          llmConfig.baseUrl,
+        );
+      case 'openai':
+        return new openai_llm_service_1.OpenaiLlmService(
+          llmConfig.model,
+          llmConfig.apiKey,
+          llmConfig.baseUrl,
+        );
+      default:
+        return new anthropic_llm_service_1.AnthropicLlmService(
+          llmConfig.model,
+          llmConfig.apiKey,
+          llmConfig.baseUrl,
+        );
+    }
+  }
+});
+exports.AgentcraftModule = AgentcraftModule;
+exports.AgentcraftModule =
+  AgentcraftModule =
+  AgentcraftModule_1 =
+    __decorate([(0, common_1.Module)({})], AgentcraftModule);
+//# sourceMappingURL=agentcraft.module.js.map

package/libs/agentcraft/src/agentcraft.module.js.map

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

package/libs/agentcraft/src/agentcraft.module.ts

@@ -0,0 +1,161 @@
+import { Module, DynamicModule } from '@nestjs/common';
+import { ConfigModule, ConfigService } from '@nestjs/config';
+import { LLM_PROVIDER, CRAFT_LLM_PROVIDER } from './constants';
+import { AnthropicLlmService } from './services/anthropic-llm.service';
+import { OpenaiLlmService } from './services/openai-llm.service';
+import { CraftLlmAdapterService } from './services/craft-llm-adapter.service';
+import { AnthropicCraftLlmService } from './services/anthropic-craft-llm.service';
+import { ArchitectLoopFactory } from './services/architect-loop.service';
+import { PipelineStepsService } from './services/pipeline-steps.service';
+import { PipelineStateService } from './services/pipeline-state.service';
+import { OutputParserService } from './services/output-parser.service';
+import { CraftConfigService } from './services/craft-config.service';
+import {
+  ApiAdapterService,
+  ApiAdapterFactory,
+} from './services/api-adapter.service';
+import { SpecFetcherService } from './services/spec-fetcher.service';
+import { RegistryClientService } from './services/registry-client.service';
+import { PlannerService } from './services/planner.service';
+import { ExecutorService } from './services/executor.service';
+import { AutonomousRunnerService } from './services/autonomous-runner.service';
+import { DecomposerService } from './services/decomposer.service';
+import { RequirementsGeneratorService } from './services/requirements-generator.service';
+import { DesignGeneratorService } from './services/design-generator.service';
+import { UIBlueprintGeneratorService } from './services/ui-blueprint-generator.service';
+import { ReadmeGeneratorService } from './services/readme-generator.service';
+import { KbWatcherService } from './services/kb-watcher.service';
+import { LlmProvider } from './interfaces/llm-provider.interface';
+import type { CraftLlmProvider } from './interfaces/llm-provider.interface';
+
+export interface LlmConfig {
+  provider: 'openai' | 'anthropic';
+  model: string;
+  apiKey: string;
+  baseUrl?: string;
+}
+
+const PIPELINE_SERVICES = [
+  PipelineStepsService,
+  PipelineStateService,
+  OutputParserService,
+  CraftConfigService,
+  ApiAdapterService,
+  ApiAdapterFactory,
+  SpecFetcherService,
+  RegistryClientService,
+  PlannerService,
+  ExecutorService,
+  AutonomousRunnerService,
+  DecomposerService,
+  RequirementsGeneratorService,
+  DesignGeneratorService,
+  UIBlueprintGeneratorService,
+  ReadmeGeneratorService,
+  KbWatcherService,
+];
+
+@Module({})
+export class AgentcraftModule {
+  static forRoot(llmConfig?: LlmConfig): DynamicModule {
+    const providers: any[] = [ArchitectLoopFactory, ...PIPELINE_SERVICES];
+
+    if (llmConfig) {
+      providers.push(
+        {
+          provide: LLM_PROVIDER,
+          useFactory: (): LlmProvider =>
+            AgentcraftModule.createLlmProvider(llmConfig),
+        },
+        {
+          provide: CRAFT_LLM_PROVIDER,
+          useFactory: (): CraftLlmProvider =>
+            AgentcraftModule.createCraftLlmProvider(llmConfig),
+        },
+      );
+    }
+
+    return {
+      module: AgentcraftModule,
+      global: true,
+      providers,
+      exports: [
+        LLM_PROVIDER,
+        CRAFT_LLM_PROVIDER,
+        ArchitectLoopFactory,
+        ...PIPELINE_SERVICES,
+      ],
+    };
+  }
+
+  static forRootAsync(): DynamicModule {
+    return {
+      module: AgentcraftModule,
+      global: true,
+      imports: [ConfigModule],
+      providers: [
+        ArchitectLoopFactory,
+        ...PIPELINE_SERVICES,
+        {
+          provide: LLM_PROVIDER,
+          useFactory: (config: ConfigService): LlmProvider | null => {
+            const llmConfig = config.get<LlmConfig>('llm');
+            if (!llmConfig) return null;
+            return AgentcraftModule.createLlmProvider(llmConfig);
+          },
+          inject: [ConfigService],
+        },
+        {
+          provide: CRAFT_LLM_PROVIDER,
+          useFactory: (config: ConfigService): CraftLlmProvider | null => {
+            const llmConfig = config.get<LlmConfig>('llm');
+            if (!llmConfig) return null;
+            return AgentcraftModule.createCraftLlmProvider(llmConfig);
+          },
+          inject: [ConfigService],
+        },
+      ],
+      exports: [
+        LLM_PROVIDER,
+        CRAFT_LLM_PROVIDER,
+        ArchitectLoopFactory,
+        ...PIPELINE_SERVICES,
+      ],
+    };
+  }
+
+  private static createLlmProvider(llmConfig: LlmConfig): LlmProvider {
+    switch (llmConfig.provider) {
+      case 'anthropic':
+        return new AnthropicLlmService(
+          llmConfig.model,
+          llmConfig.apiKey,
+          llmConfig.baseUrl,
+        );
+      case 'openai':
+        return new OpenaiLlmService(
+          llmConfig.model,
+          llmConfig.apiKey,
+          llmConfig.baseUrl,
+        );
+      default:
+        return new AnthropicLlmService(
+          llmConfig.model,
+          llmConfig.apiKey,
+          llmConfig.baseUrl,
+        );
+    }
+  }
+
+  private static createCraftLlmProvider(
+    llmConfig: LlmConfig,
+  ): CraftLlmProvider {
+    if (llmConfig.provider === 'anthropic') {
+      return new AnthropicCraftLlmService(llmConfig.model, llmConfig.apiKey);
+    }
+
+    // For non-Anthropic providers, use the adapter (no tool support)
+    const llm = AgentcraftModule.createLlmProvider(llmConfig);
+    return new CraftLlmAdapterService(llm);
+  }
+}

package/libs/agentcraft/src/constants.d.ts

@@ -0,0 +1,2 @@
+export declare const LLM_PROVIDER = 'LLM_PROVIDER';
+export declare const CRAFT_LLM_PROVIDER = 'CRAFT_LLM_PROVIDER';

package/libs/agentcraft/src/constants.js

@@ -0,0 +1,6 @@
+'use strict';
+Object.defineProperty(exports, '__esModule', { value: true });
+exports.CRAFT_LLM_PROVIDER = exports.LLM_PROVIDER = void 0;
+exports.LLM_PROVIDER = 'LLM_PROVIDER';
+exports.CRAFT_LLM_PROVIDER = 'CRAFT_LLM_PROVIDER';
+//# sourceMappingURL=constants.js.map

package/libs/agentcraft/src/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,YAAY,GAAG,cAAc,CAAC;AAC9B,QAAA,kBAAkB,GAAG,oBAAoB,CAAC"}

package/libs/agentcraft/src/constants.ts

@@ -0,0 +1,2 @@
+export const LLM_PROVIDER = 'LLM_PROVIDER';
+export const CRAFT_LLM_PROVIDER = 'CRAFT_LLM_PROVIDER';

package/libs/agentcraft/src/dto/submit-action.dto.ts

@@ -0,0 +1,20 @@
+import { createZodDto } from 'nestjs-zod';
+import { z } from 'zod';
+
+export const SubmitActionBaseSchema = z.object({
+  action: z.string().optional(),
+  feedback: z.string().optional(),
+});
+
+export const SubmitActionSchema = SubmitActionBaseSchema.extend({
+  targetStep: z.string().optional(),
+  resume: z.boolean().optional(),
+  editStep: z.string().optional(),
+  editContent: z.string().optional(),
+  postEditTarget: z.string().optional(),
+});
+
+export class SubmitActionDto extends createZodDto(SubmitActionSchema) {}
+export class SubmitResolverActionDto extends createZodDto(
+  SubmitActionBaseSchema,
+) {}

package/libs/agentcraft/src/errors/domain.error.d.ts

@@ -0,0 +1,8 @@
+export { DomainError } from '@app/project-provider';
+import { DomainError } from '@app/project-provider';
+export declare class SessionNotFoundError extends DomainError {
+  constructor();
+}
+export declare class InvalidSessionStateError extends DomainError {
+  constructor(message: string);
+}

package/libs/agentcraft/src/errors/domain.error.js

@@ -0,0 +1,27 @@
+'use strict';
+Object.defineProperty(exports, '__esModule', { value: true });
+exports.InvalidSessionStateError =
+  exports.SessionNotFoundError =
+  exports.DomainError =
+    void 0;
+var project_provider_1 = require('../../../project-provider/src');
+Object.defineProperty(exports, 'DomainError', {
+  enumerable: true,
+  get: function () {
+    return project_provider_1.DomainError;
+  },
+});
+const project_provider_2 = require('../../../project-provider/src');
+class SessionNotFoundError extends project_provider_2.DomainError {
+  constructor() {
+    super('Session not found', 404);
+  }
+}
+exports.SessionNotFoundError = SessionNotFoundError;
+class InvalidSessionStateError extends project_provider_2.DomainError {
+  constructor(message) {
+    super(message, 409);
+  }
+}
+exports.InvalidSessionStateError = InvalidSessionStateError;
+//# sourceMappingURL=domain.error.js.map

package/libs/agentcraft/src/errors/domain.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.error.js","sourceRoot":"","sources":["domain.error.ts"],"names":[],"mappings":";;;AAAA,kEAAoD;AAA3C,+GAAA,WAAW,OAAA;AACpB,oEAAoD;AAEpD,MAAa,oBAAqB,SAAQ,8BAAW;IACnD;QACE,KAAK,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC;IAClC,CAAC;CACF;AAJD,oDAIC;AAED,MAAa,wBAAyB,SAAQ,8BAAW;IACvD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACtB,CAAC;CACF;AAJD,4DAIC"}