@agentlang/agentmanager 0.0.3

package/libs/agentcraft/src/services/craft-config.service.js

@@ -0,0 +1,127 @@
+'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);
+    };
+  };
+Object.defineProperty(exports, '__esModule', { value: true });
+exports.CraftConfigService = void 0;
+const common_1 = require('@nestjs/common');
+const config_1 = require('@nestjs/config');
+const promises_1 = require('node:fs/promises');
+const node_path_1 = require('node:path');
+const node_os_1 = require('node:os');
+const CONFIG_DIR = (0, node_path_1.join)(
+  (0, node_os_1.homedir)(),
+  '.config',
+  'agentcraft',
+);
+const CONFIG_FILE = (0, node_path_1.join)(CONFIG_DIR, 'config.json');
+const DEFAULTS = {
+  provider: 'anthropic',
+  model: undefined,
+  outputDir: '.',
+};
+let CraftConfigService = class CraftConfigService {
+  configService;
+  constructor(configService) {
+    this.configService = configService;
+  }
+  async resolve(flags = {}) {
+    const globalConf = await this.loadConfigFile(CONFIG_FILE);
+    const projectConf = await this.loadConfigFile(
+      (0, node_path_1.join)(process.cwd(), '.craftrc.json'),
+    );
+    const envConf = this.loadEnvConfig();
+    const provider =
+      flags.provider ||
+      envConf.provider ||
+      projectConf.provider ||
+      globalConf.provider ||
+      DEFAULTS.provider;
+    const model =
+      flags.model ||
+      envConf.model ||
+      projectConf.model ||
+      globalConf.model ||
+      DEFAULTS.model;
+    const apiKey =
+      flags.apiKey || envConf.apiKey || projectConf.apiKey || globalConf.apiKey;
+    const outputDir =
+      flags.outputDir ||
+      envConf.outputDir ||
+      projectConf.outputDir ||
+      globalConf.outputDir ||
+      DEFAULTS.outputDir;
+    return { provider, model, apiKey, outputDir };
+  }
+  async saveGlobal(updates) {
+    await (0, promises_1.mkdir)(CONFIG_DIR, { recursive: true });
+    const existing = await this.loadConfigFile(CONFIG_FILE);
+    const merged = { ...existing, ...updates };
+    await (0, promises_1.writeFile)(
+      CONFIG_FILE,
+      JSON.stringify(merged, null, 2) + '\n',
+    );
+  }
+  getDefaultModel(provider) {
+    return provider === 'anthropic' ? 'claude-sonnet-4-6' : 'gpt-4o';
+  }
+  async loadConfigFile(filePath) {
+    try {
+      const content = await (0, promises_1.readFile)(filePath, 'utf-8');
+      return JSON.parse(content);
+    } catch {
+      return {};
+    }
+  }
+  loadEnvConfig() {
+    const get = (key) => this.configService?.get(key) ?? process.env[key];
+    return {
+      provider: get('CRAFT_PROVIDER'),
+      model: get('CRAFT_MODEL'),
+      apiKey:
+        get('CRAFT_API_KEY') ||
+        get('ANTHROPIC_API_KEY') ||
+        get('OPENAI_API_KEY'),
+      outputDir: get('CRAFT_OUTPUT_DIR'),
+    };
+  }
+};
+exports.CraftConfigService = CraftConfigService;
+exports.CraftConfigService = CraftConfigService = __decorate(
+  [
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Optional)()),
+    __metadata('design:paramtypes', [config_1.ConfigService]),
+  ],
+  CraftConfigService,
+);
+//# sourceMappingURL=craft-config.service.js.map

package/libs/agentcraft/src/services/craft-config.service.js.map

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

package/libs/agentcraft/src/services/craft-config.service.ts

@@ -0,0 +1,92 @@
+import { Injectable, Optional } from '@nestjs/common';
+import { ConfigService } from '@nestjs/config';
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { CraftConfig } from '../types/pipeline.types';
+
+const CONFIG_DIR = join(homedir(), '.config', 'agentcraft');
+const CONFIG_FILE = join(CONFIG_DIR, 'config.json');
+
+interface RawConfig {
+  provider?: string;
+  model?: string;
+  apiKey?: string;
+  outputDir?: string;
+}
+
+const DEFAULTS: CraftConfig = {
+  provider: 'anthropic',
+  model: undefined,
+  outputDir: '.',
+};
+
+@Injectable()
+export class CraftConfigService {
+  constructor(@Optional() private readonly configService?: ConfigService) {}
+
+  async resolve(flags: Partial<CraftConfig> = {}): Promise<CraftConfig> {
+    const globalConf = await this.loadConfigFile(CONFIG_FILE);
+    const projectConf = await this.loadConfigFile(
+      join(process.cwd(), '.craftrc.json'),
+    );
+    const envConf = this.loadEnvConfig();
+
+    const provider = (flags.provider ||
+      envConf.provider ||
+      projectConf.provider ||
+      globalConf.provider ||
+      DEFAULTS.provider) as CraftConfig['provider'];
+    const model =
+      flags.model ||
+      envConf.model ||
+      projectConf.model ||
+      globalConf.model ||
+      DEFAULTS.model;
+    const apiKey =
+      flags.apiKey || envConf.apiKey || projectConf.apiKey || globalConf.apiKey;
+    const outputDir =
+      flags.outputDir ||
+      envConf.outputDir ||
+      projectConf.outputDir ||
+      globalConf.outputDir ||
+      DEFAULTS.outputDir;
+
+    return { provider, model, apiKey, outputDir };
+  }
+
+  async saveGlobal(updates: Partial<CraftConfig>): Promise<void> {
+    await mkdir(CONFIG_DIR, { recursive: true });
+    const existing = await this.loadConfigFile(CONFIG_FILE);
+    const merged = { ...existing, ...updates };
+    await writeFile(CONFIG_FILE, JSON.stringify(merged, null, 2) + '\n');
+  }
+
+  getDefaultModel(provider: CraftConfig['provider']): string {
+    return provider === 'anthropic' ? 'claude-sonnet-4-6' : 'gpt-4o';
+  }
+
+  private async loadConfigFile(filePath: string): Promise<RawConfig> {
+    try {
+      const content = await readFile(filePath, 'utf-8');
+      return JSON.parse(content) as RawConfig;
+    } catch {
+      return {};
+    }
+  }
+
+  private loadEnvConfig(): RawConfig {
+    const get = (key: string): string | undefined =>
+      this.configService?.get<string>(key) ?? process.env[key];
+
+    return {
+      provider: get('CRAFT_PROVIDER'),
+      model: get('CRAFT_MODEL'),
+      apiKey:
+        get('CRAFT_API_KEY') ||
+        get('ANTHROPIC_API_KEY') ||
+        get('OPENAI_API_KEY'),
+      outputDir: get('CRAFT_OUTPUT_DIR'),
+    };
+  }
+}

package/libs/agentcraft/src/services/craft-llm-adapter.service.d.ts

@@ -0,0 +1,12 @@
+import { CraftLlmProvider } from '../interfaces/llm-provider.interface';
+import { LlmProvider } from '../interfaces/llm-provider.interface';
+import { ChatRequest, ChatResponse } from '../types/llm.types';
+export declare class CraftLlmAdapterService implements CraftLlmProvider {
+  private readonly provider;
+  constructor(provider: LlmProvider);
+  chat(request: ChatRequest): Promise<ChatResponse>;
+  chatStream(
+    request: ChatRequest,
+    onChunk: (text: string) => void,
+  ): Promise<ChatResponse>;
+}

package/libs/agentcraft/src/services/craft-llm-adapter.service.js

@@ -0,0 +1,73 @@
+'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);
+  };
+Object.defineProperty(exports, '__esModule', { value: true });
+exports.CraftLlmAdapterService = void 0;
+const common_1 = require('@nestjs/common');
+let CraftLlmAdapterService = class CraftLlmAdapterService {
+  provider;
+  constructor(provider) {
+    this.provider = provider;
+  }
+  async chat(request) {
+    const userPrompt = request.messages
+      .map((m) => {
+        const text =
+          typeof m.content === 'string'
+            ? m.content
+            : m.content
+                .filter((b) => b.type === 'text')
+                .map((b) => b.text)
+                .join('');
+        return `[${m.role}]\n${text}`;
+      })
+      .join('\n\n');
+    const result = await this.provider.complete({
+      systemPrompt: request.system,
+      userPrompt,
+    });
+    return {
+      content: [{ type: 'text', text: result.text }],
+      stopReason:
+        result.stopReason === 'max_tokens' ? 'max_tokens' : 'end_turn',
+    };
+  }
+  async chatStream(request, onChunk) {
+    const response = await this.chat(request);
+    const text = response.content
+      .filter((b) => b.type === 'text')
+      .map((b) => b.text)
+      .join('');
+    onChunk(text);
+    return response;
+  }
+};
+exports.CraftLlmAdapterService = CraftLlmAdapterService;
+exports.CraftLlmAdapterService = CraftLlmAdapterService = __decorate(
+  [(0, common_1.Injectable)(), __metadata('design:paramtypes', [Object])],
+  CraftLlmAdapterService,
+);
+//# sourceMappingURL=craft-llm-adapter.service.js.map

package/libs/agentcraft/src/services/craft-llm-adapter.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"craft-llm-adapter.service.js","sourceRoot":"","sources":["craft-llm-adapter.service.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAMrC,IAAM,sBAAsB,GAA5B,MAAM,sBAAsB;IACJ;IAA7B,YAA6B,QAAqB;QAArB,aAAQ,GAAR,QAAQ,CAAa;IAAG,CAAC;IAEtD,KAAK,CAAC,IAAI,CAAC,OAAoB;QAC7B,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ;aAChC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACT,MAAM,IAAI,GACR,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ;gBAC3B,CAAC,CAAC,CAAC,CAAC,OAAO;gBACX,CAAC,CAAC,CAAC,CAAC,OAAO;qBACN,MAAM,CACL,CAAC,CAAC,EAAuC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAC9D;qBACA,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;qBAClB,IAAI,CAAC,EAAE,CAAC,CAAC;YAClB,OAAO,IAAI,CAAC,CAAC,IAAI,MAAM,IAAI,EAAE,CAAC;QAChC,CAAC,CAAC;aACD,IAAI,CAAC,MAAM,CAAC,CAAC;QAEhB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAC1C,YAAY,EAAE,OAAO,CAAC,MAAM;YAC5B,UAAU;SACX,CAAC,CAAC;QAEH,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;YAC9C,UAAU,EACR,MAAM,CAAC,UAAU,KAAK,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,UAAU;SACjE,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,UAAU,CACd,OAAoB,EACpB,OAA+B;QAE/B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC1C,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO;aAC1B,MAAM,CAAC,CAAC,CAAC,EAAuC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC;aACrE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;aAClB,IAAI,CAAC,EAAE,CAAC,CAAC;QACZ,OAAO,CAAC,IAAI,CAAC,CAAC;QACd,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF,CAAA;AA3CY,wDAAsB;iCAAtB,sBAAsB;IADlC,IAAA,mBAAU,GAAE;;GACA,sBAAsB,CA2ClC"}

package/libs/agentcraft/src/services/craft-llm-adapter.service.ts

@@ -0,0 +1,52 @@
+import { Injectable } from '@nestjs/common';
+import { CraftLlmProvider } from '../interfaces/llm-provider.interface';
+import { LlmProvider } from '../interfaces/llm-provider.interface';
+import { ChatRequest, ChatResponse } from '../types/llm.types';
+
+@Injectable()
+export class CraftLlmAdapterService implements CraftLlmProvider {
+  constructor(private readonly provider: LlmProvider) {}
+
+  async chat(request: ChatRequest): Promise<ChatResponse> {
+    const userPrompt = request.messages
+      .map((m) => {
+        const text =
+          typeof m.content === 'string'
+            ? m.content
+            : m.content
+                .filter(
+                  (b): b is { type: 'text'; text: string } => b.type === 'text',
+                )
+                .map((b) => b.text)
+                .join('');
+        return `[${m.role}]\n${text}`;
+      })
+      .join('\n\n');
+
+    const result = await this.provider.complete({
+      systemPrompt: request.system,
+      userPrompt,
+      maxTokens: request.maxTokens,
+    });
+
+    return {
+      content: [{ type: 'text', text: result.text }],
+      stopReason:
+        result.stopReason === 'max_tokens' ? 'max_tokens' : 'end_turn',
+      toolCalls: [],
+    };
+  }
+
+  async chatStream(
+    request: ChatRequest,
+    onChunk: (text: string) => void,
+  ): Promise<ChatResponse> {
+    const response = await this.chat(request);
+    const text = response.content
+      .filter((b): b is { type: 'text'; text: string } => b.type === 'text')
+      .map((b) => b.text)
+      .join('');
+    onChunk(text);
+    return response;
+  }
+}

package/libs/agentcraft/src/services/decomposer.service.ts

@@ -0,0 +1,115 @@
+import { Injectable, Inject, Optional, Logger } from '@nestjs/common';
+import { CRAFT_LLM_PROVIDER } from '../constants';
+import { CraftLlmProvider } from '../interfaces/llm-provider.interface';
+import {
+  DecompositionResult,
+  SubAppDefinition,
+} from '../types/architect.types';
+import { DECOMPOSITION_SYSTEM_PROMPT } from '../prompts/decomposition.prompt';
+
+@Injectable()
+export class DecomposerService {
+  private readonly logger = new Logger(DecomposerService.name);
+
+  constructor(
+    @Inject(CRAFT_LLM_PROVIDER)
+    @Optional()
+    private readonly llm: CraftLlmProvider | null,
+  ) {}
+
+  async decomposeApp(
+    kbContent: string,
+    projectName: string,
+  ): Promise<DecompositionResult> {
+    if (!this.llm) throw new Error('LLM provider not configured');
+
+    this.logger.log(
+      `Starting decomposition for "${projectName}" (KB: ${kbContent.length} chars)`,
+    );
+
+    const response = await this.llm.chat({
+      system: DECOMPOSITION_SYSTEM_PROMPT,
+      messages: [
+        {
+          role: 'user',
+          content: `## Project: ${projectName}\n\n## Knowledge Base\n\n${kbContent}`,
+        },
+      ],
+      cacheControl: true,
+    });
+
+    const text = response.content
+      .filter((b) => b.type === 'text')
+      .map((b) => b.text)
+      .join('');
+
+    this.logger.log(`LLM response received (${text.length} chars)`);
+
+    const result = this.parseDecompositionResponse(text, projectName);
+    this.logger.log(
+      `Decomposed into ${result.subApps.length} sub-apps: ${result.subApps.map((s) => s.name).join(', ')}`,
+    );
+    return result;
+  }
+
+  parseDecompositionResponse(
+    response: string,
+    fallbackName: string,
+  ): DecompositionResult {
+    let json = response.trim();
+    json = json.replace(/^```(?:json)?\s*\n?/i, '').replace(/\n?```\s*$/i, '');
+
+    const braceIdx = json.indexOf('{');
+    if (braceIdx > 0) {
+      json = json.slice(braceIdx);
+    }
+
+    let parsed: unknown;
+    try {
+      parsed = JSON.parse(json);
+    } catch {
+      throw new Error(
+        `Failed to parse decomposition JSON from LLM response.\nResponse starts with: ${response.slice(0, 200)}`,
+      );
+    }
+
+    if (!parsed || typeof parsed !== 'object') {
+      throw new Error('Decomposition response is not a JSON object.');
+    }
+
+    const obj = parsed as Record<string, unknown>;
+
+    const projectName =
+      typeof obj.projectName === 'string' ? obj.projectName : fallbackName;
+    const baselineDescription =
+      typeof obj.baselineDescription === 'string'
+        ? obj.baselineDescription
+        : '';
+
+    if (!baselineDescription) {
+      throw new Error('Decomposition must include a baselineDescription.');
+    }
+
+    if (!Array.isArray(obj.subApps) || obj.subApps.length === 0) {
+      throw new Error('Decomposition must include at least one sub-app.');
+    }
+
+    const subApps: SubAppDefinition[] = obj.subApps.map(
+      (s: unknown, i: number) => {
+        if (!s || typeof s !== 'object') {
+          throw new Error(`Sub-app ${i} is not an object.`);
+        }
+        const sub = s as Record<string, unknown>;
+        const name = typeof sub.name === 'string' ? sub.name : '';
+        const description =
+          typeof sub.description === 'string' ? sub.description : '';
+        if (!name) throw new Error(`Sub-app ${i} is missing a name.`);
+        if (!description)
+          throw new Error(`Sub-app ${i} is missing a description.`);
+        return { name, description };
+      },
+    );
+
+    return { projectName, baselineDescription, subApps };
+  }
+}