@agentlang/agentmanager 0.0.3

package/libs/agentcraft/src/services/registry-client.service.js

@@ -0,0 +1,158 @@
+'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.RegistryClientService = void 0;
+const common_1 = require('@nestjs/common');
+const config_1 = require('@nestjs/config');
+const node_child_process_1 = require('node:child_process');
+const DEFAULT_REGISTRY_URL =
+  'https://api.github.com/repos/agentlang-hub/resolver-registry/contents/registry/';
+const STOP_WORDS = new Set([
+  'a',
+  'an',
+  'the',
+  'and',
+  'or',
+  'for',
+  'to',
+  'in',
+  'of',
+  'with',
+  'from',
+  'by',
+  'on',
+  'is',
+  'it',
+]);
+let RegistryClientService = class RegistryClientService {
+  configService;
+  constructor(configService) {
+    this.configService = configService;
+  }
+  async search(query) {
+    const allFiles = await this.fetchListing();
+    const prefix = this.extractServicePrefix(query);
+    const keywords = this.tokenizeQuery(query);
+    let candidates = this.filterByPrefix(allFiles, prefix);
+    if (candidates.length === 0) {
+      candidates = allFiles;
+    }
+    const results = [];
+    for (const file of candidates) {
+      const entry = await this.fetchEntry(file.download_url);
+      const score = this.scoreEntry(entry, keywords);
+      if (score > 0) {
+        results.push({ entry, score });
+      }
+    }
+    results.sort((a, b) => b.score - a.score);
+    return results;
+  }
+  async clone(repoSlug, targetDir) {
+    const repoUrl = `https://github.com/${repoSlug}.git`;
+    return new Promise((resolve, reject) => {
+      (0, node_child_process_1.execFile)(
+        'git',
+        ['clone', '--depth', '1', repoUrl, targetDir],
+        (error) => {
+          if (error) {
+            reject(new Error(`Failed to clone ${repoSlug}: ${error.message}`));
+          } else {
+            resolve();
+          }
+        },
+      );
+    });
+  }
+  async fetchListing() {
+    const url =
+      this.configService?.get('CRAFT_REGISTRY_URL') ??
+      process.env.CRAFT_REGISTRY_URL ??
+      DEFAULT_REGISTRY_URL;
+    const response = await fetch(url, {
+      headers: { Accept: 'application/vnd.github.v3+json' },
+    });
+    if (!response.ok) {
+      throw new Error(
+        `Failed to fetch registry listing: ${response.status} ${response.statusText}`,
+      );
+    }
+    const entries = await response.json();
+    return entries.filter((e) => e.type === 'file' && e.name.endsWith('.json'));
+  }
+  async fetchEntry(downloadUrl) {
+    const response = await fetch(downloadUrl);
+    if (!response.ok) {
+      throw new Error(
+        `Failed to fetch registry entry: ${response.status} ${response.statusText}`,
+      );
+    }
+    return response.json();
+  }
+  extractServicePrefix(query) {
+    return query.trim().split(/\s+/)[0]?.toLowerCase() ?? '';
+  }
+  tokenizeQuery(query) {
+    return query
+      .toLowerCase()
+      .split(/\s+/)
+      .filter((w) => w.length > 0 && !STOP_WORDS.has(w));
+  }
+  scoreEntry(entry, keywords) {
+    let score = 0;
+    const service = entry.service.toLowerCase();
+    const description = entry.description.toLowerCase();
+    const tags = entry.tags.map((t) => t.toLowerCase());
+    for (const keyword of keywords) {
+      if (service.includes(keyword)) score += 3;
+      if (tags.some((tag) => tag.includes(keyword))) score += 2;
+      if (description.includes(keyword)) score += 1;
+    }
+    return score;
+  }
+  filterByPrefix(files, prefix) {
+    if (!prefix) return files;
+    return files.filter((f) => f.name.toLowerCase().startsWith(prefix));
+  }
+};
+exports.RegistryClientService = RegistryClientService;
+exports.RegistryClientService = RegistryClientService = __decorate(
+  [
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Optional)()),
+    __metadata('design:paramtypes', [config_1.ConfigService]),
+  ],
+  RegistryClientService,
+);
+//# sourceMappingURL=registry-client.service.js.map

package/libs/agentcraft/src/services/registry-client.service.js.map

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

package/libs/agentcraft/src/services/registry-client.service.ts

@@ -0,0 +1,139 @@
+import { Injectable, Optional } from '@nestjs/common';
+import { ConfigService } from '@nestjs/config';
+import { execFile } from 'node:child_process';
+import {
+  RegistryEntry,
+  RegistrySearchResult,
+  GitHubContentEntry,
+} from '../types/resolver.types';
+
+const DEFAULT_REGISTRY_URL =
+  'https://api.github.com/repos/agentlang-hub/resolver-registry/contents/registry/';
+
+const STOP_WORDS = new Set([
+  'a',
+  'an',
+  'the',
+  'and',
+  'or',
+  'for',
+  'to',
+  'in',
+  'of',
+  'with',
+  'from',
+  'by',
+  'on',
+  'is',
+  'it',
+]);
+
+@Injectable()
+export class RegistryClientService {
+  constructor(@Optional() private readonly configService?: ConfigService) {}
+
+  async search(query: string): Promise<RegistrySearchResult[]> {
+    const allFiles = await this.fetchListing();
+    const prefix = this.extractServicePrefix(query);
+    const keywords = this.tokenizeQuery(query);
+
+    let candidates = this.filterByPrefix(allFiles, prefix);
+    if (candidates.length === 0) {
+      candidates = allFiles;
+    }
+
+    const results: RegistrySearchResult[] = [];
+
+    for (const file of candidates) {
+      const entry = await this.fetchEntry(file.download_url);
+      const score = this.scoreEntry(entry, keywords);
+      if (score > 0) {
+        results.push({ entry, score });
+      }
+    }
+
+    results.sort((a, b) => b.score - a.score);
+    return results;
+  }
+
+  async clone(repoSlug: string, targetDir: string): Promise<void> {
+    const repoUrl = `https://github.com/${repoSlug}.git`;
+
+    return new Promise((resolve, reject) => {
+      execFile(
+        'git',
+        ['clone', '--depth', '1', repoUrl, targetDir],
+        (error) => {
+          if (error) {
+            reject(new Error(`Failed to clone ${repoSlug}: ${error.message}`));
+          } else {
+            resolve();
+          }
+        },
+      );
+    });
+  }
+
+  private async fetchListing(): Promise<GitHubContentEntry[]> {
+    const url =
+      this.configService?.get<string>('CRAFT_REGISTRY_URL') ??
+      process.env.CRAFT_REGISTRY_URL ??
+      DEFAULT_REGISTRY_URL;
+    const response = await fetch(url, {
+      headers: { Accept: 'application/vnd.github.v3+json' },
+    });
+
+    if (!response.ok) {
+      throw new Error(
+        `Failed to fetch registry listing: ${response.status} ${response.statusText}`,
+      );
+    }
+
+    const entries: GitHubContentEntry[] = await response.json();
+    return entries.filter((e) => e.type === 'file' && e.name.endsWith('.json'));
+  }
+
+  private async fetchEntry(downloadUrl: string): Promise<RegistryEntry> {
+    const response = await fetch(downloadUrl);
+    if (!response.ok) {
+      throw new Error(
+        `Failed to fetch registry entry: ${response.status} ${response.statusText}`,
+      );
+    }
+    return response.json();
+  }
+
+  private extractServicePrefix(query: string): string {
+    return query.trim().split(/\s+/)[0]?.toLowerCase() ?? '';
+  }
+
+  private tokenizeQuery(query: string): string[] {
+    return query
+      .toLowerCase()
+      .split(/\s+/)
+      .filter((w) => w.length > 0 && !STOP_WORDS.has(w));
+  }
+
+  private scoreEntry(entry: RegistryEntry, keywords: string[]): number {
+    let score = 0;
+    const service = entry.service.toLowerCase();
+    const description = entry.description.toLowerCase();
+    const tags = entry.tags.map((t) => t.toLowerCase());
+
+    for (const keyword of keywords) {
+      if (service.includes(keyword)) score += 3;
+      if (tags.some((tag) => tag.includes(keyword))) score += 2;
+      if (description.includes(keyword)) score += 1;
+    }
+
+    return score;
+  }
+
+  private filterByPrefix(
+    files: GitHubContentEntry[],
+    prefix: string,
+  ): GitHubContentEntry[] {
+    if (!prefix) return files;
+    return files.filter((f) => f.name.toLowerCase().startsWith(prefix));
+  }
+}

package/libs/agentcraft/src/services/requirements-generator.service.ts

@@ -0,0 +1,238 @@
+import { Injectable, Inject, Optional, Logger } from '@nestjs/common';
+import { CRAFT_LLM_PROVIDER } from '../constants';
+import { CraftLlmProvider } from '../interfaces/llm-provider.interface';
+import type { ToolDefinition } from '../types/llm.types';
+import {
+  DecompositionResult,
+  AppRequirements,
+  RequirementsResult,
+} from '../types/architect.types';
+
+@Injectable()
+export class RequirementsGeneratorService {
+  private readonly logger = new Logger(RequirementsGeneratorService.name);
+
+  private readonly requirementsTool: ToolDefinition = {
+    name: 'produce_requirements',
+    description:
+      'Produce detailed requirements documents for the baseline app and each sub-app.',
+    inputSchema: {
+      type: 'object',
+      required: ['baseline', 'subApps'],
+      additionalProperties: false,
+      properties: {
+        baseline: {
+          type: 'object',
+          required: ['appName', 'requirements'],
+          additionalProperties: false,
+          properties: {
+            appName: {
+              type: 'string',
+              description: 'PascalCase baseline app name',
+            },
+            requirements: {
+              type: 'string',
+              description:
+                'Detailed requirements for the baseline data model in markdown.',
+            },
+          },
+        },
+        subApps: {
+          type: 'array',
+          items: {
+            type: 'object',
+            required: ['appName', 'requirements'],
+            additionalProperties: false,
+            properties: {
+              appName: {
+                type: 'string',
+                description: 'PascalCase sub-app name',
+              },
+              requirements: {
+                type: 'string',
+                description:
+                  'Detailed requirements for this sub-app in markdown.',
+              },
+            },
+          },
+        },
+      },
+    },
+  };
+
+  constructor(
+    @Inject(CRAFT_LLM_PROVIDER)
+    @Optional()
+    private readonly llm: CraftLlmProvider | null,
+  ) {}
+
+  async generateRequirements(
+    kbContent: string,
+    decomposition: DecompositionResult,
+  ): Promise<RequirementsResult> {
+    if (!this.llm) throw new Error('LLM provider not configured');
+
+    this.logger.log(
+      `Generating requirements for "${decomposition.projectName}" (KB: ${kbContent.length} chars, ${decomposition.subApps.length} sub-apps)`,
+    );
+
+    const systemPrompt = this.buildRequirementsPrompt(decomposition);
+
+    const response = await this.llm.chat({
+      system: systemPrompt,
+      messages: [
+        { role: 'user', content: `## Knowledge Base\n\n${kbContent}` },
+      ],
+      maxTokens: 64000,
+      tools: [this.requirementsTool],
+      toolChoice: { type: 'tool', name: 'produce_requirements' },
+      cacheControl: true,
+    });
+
+    this.logger.log(
+      `LLM response received (toolCalls: ${response.toolCalls?.length ?? 0}, truncated: ${response.truncated ?? false})`,
+    );
+
+    if (response.truncated) {
+      throw new Error(
+        `Requirements generation was truncated (output tokens: ${response.usage?.outputTokens ?? '?'}).`,
+      );
+    }
+
+    const toolCall = response.toolCalls?.[0];
+    if (toolCall) {
+      this.logger.log('Parsing requirements from tool call');
+      const result = this.parseToolCallInput(toolCall.input, decomposition);
+      this.logger.log(
+        `Requirements generated: baseline="${result.baseline.appName}", ${result.subApps.length} sub-apps`,
+      );
+      return result;
+    }
+
+    // Fallback: parse text response
+    const text = response.content
+      .filter((b) => b.type === 'text')
+      .map((b) => b.text)
+      .join('');
+
+    if (text) {
+      try {
+        let json = text.trim();
+        json = json
+          .replace(/^```(?:json)?\s*\n?/i, '')
+          .replace(/\n?```\s*$/i, '');
+        const braceIdx = json.indexOf('{');
+        if (braceIdx > 0) json = json.slice(braceIdx);
+        const parsed = JSON.parse(json);
+        return this.parseToolCallInput(parsed, decomposition);
+      } catch {
+        // fall through
+      }
+    }
+
+    throw new Error(
+      'Requirements generation did not return a tool call. LLM response: ' +
+        text.slice(0, 200),
+    );
+  }
+
+  private buildRequirementsPrompt(decomposition: DecompositionResult): string {
+    const subAppEntries = decomposition.subApps
+      .map((s) => `  - **${s.name}**: ${s.description}`)
+      .join('\n');
+
+    return `You are a requirements analyst. You have been given a knowledge base describing an application and a decomposition of that application into a baseline data model and sub-apps.
+
+Your task is to produce a **detailed requirements document** for each app (baseline + each sub-app). These requirements will be used by downstream steps to allocate entities and generate code — so they must capture ALL relevant detail from the knowledge base.
+
+## Decomposition
+
+**Baseline**: ${decomposition.baselineDescription}
+
+**Sub-apps**:
+${subAppEntries}
+
+## What to include in each requirements document
+
+For the **baseline** app:
+- Every shared entity and its attributes (types, constraints, defaults, enums)
+- Every relationship between shared entities (cardinality, direction)
+- Data validation rules and business constraints
+- Any domain terminology or definitions
+
+For each **sub-app**:
+- Functional requirements: what the sub-app does, step by step
+- Business rules and logic specific to this sub-app
+- Workflows and their triggers, steps, and outcomes
+- Events it produces or consumes
+- Agents and their responsibilities
+- Local entities specific to this sub-app (not shared)
+- How it interacts with baseline entities (read, update, create)
+- Edge cases, error handling, and validation rules
+- Any API endpoints, user interactions, or integrations mentioned in the KB
+
+## Rules
+
+1. Extract EVERY relevant detail from the knowledge base — do not summarize or skip.
+2. If the KB mentions specific field names, types, enum values, or constraints, include them verbatim.
+3. Each requirement should be assigned to exactly ONE app. Do not duplicate requirements across apps.
+4. If information in the KB is ambiguous about which app it belongs to, assign it to the most relevant sub-app.
+5. The baseline requirements should focus ONLY on data definitions — no workflows, no agents, no business logic.
+6. Write requirements in clear, structured markdown with headers and bullet points.
+
+Call the \`produce_requirements\` tool with the requirements for all apps.`;
+  }
+
+  private parseToolCallInput(
+    input: unknown,
+    decomposition: DecompositionResult,
+  ): RequirementsResult {
+    if (!input || typeof input !== 'object') {
+      throw new Error('Requirements tool call input is not an object.');
+    }
+
+    const obj = input as Record<string, unknown>;
+
+    const baseline = this.parseAppRequirements(
+      obj.baseline,
+      decomposition.projectName,
+    );
+
+    const subAppsRaw = obj.subApps ?? obj.sub_apps ?? obj.subapps;
+    if (!Array.isArray(subAppsRaw)) {
+      throw new Error(
+        `Requirements must include a subApps array. Got keys: ${Object.keys(obj).join(', ')}`,
+      );
+    }
+
+    const subApps: AppRequirements[] = subAppsRaw.map(
+      (s: unknown, i: number) => {
+        const fallbackName = decomposition.subApps[i]?.name ?? `SubApp${i + 1}`;
+        return this.parseAppRequirements(s, fallbackName);
+      },
+    );
+
+    return { baseline, subApps };
+  }
+
+  private parseAppRequirements(
+    raw: unknown,
+    fallbackName: string,
+  ): AppRequirements {
+    if (!raw || typeof raw !== 'object') {
+      throw new Error(`Requirements for "${fallbackName}" is not an object.`);
+    }
+
+    const obj = raw as Record<string, unknown>;
+    const appName =
+      typeof obj.appName === 'string' ? obj.appName : fallbackName;
+    const requirements =
+      typeof obj.requirements === 'string' ? obj.requirements : '';
+
+    if (!requirements) {
+      throw new Error(`Requirements for "${appName}" is empty.`);
+    }
+
+    return { appName, requirements };
+  }
+}

package/libs/agentcraft/src/services/spec-fetcher.service.d.ts

@@ -0,0 +1,3 @@
+export declare class SpecFetcherService {
+  fetch(source: string): Promise<string>;
+}

package/libs/agentcraft/src/services/spec-fetcher.service.js

@@ -0,0 +1,46 @@
+'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.SpecFetcherService = void 0;
+const common_1 = require('@nestjs/common');
+const promises_1 = require('node:fs/promises');
+const node_path_1 = require('node:path');
+let SpecFetcherService = class SpecFetcherService {
+  async fetch(source) {
+    if (source.startsWith('http://') || source.startsWith('https://')) {
+      const response = await fetch(source);
+      if (!response.ok) {
+        throw new Error(
+          `Failed to fetch spec from ${source}: ${response.status} ${response.statusText}`,
+        );
+      }
+      return response.text();
+    }
+    const resolved = (0, node_path_1.resolve)(source);
+    return (0, promises_1.readFile)(resolved, 'utf-8');
+  }
+};
+exports.SpecFetcherService = SpecFetcherService;
+exports.SpecFetcherService = SpecFetcherService = __decorate(
+  [(0, common_1.Injectable)()],
+  SpecFetcherService,
+);
+//# sourceMappingURL=spec-fetcher.service.js.map

package/libs/agentcraft/src/services/spec-fetcher.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-fetcher.service.js","sourceRoot":"","sources":["spec-fetcher.service.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAA4C;AAC5C,+CAA4C;AAC5C,yCAAoC;AAG7B,IAAM,kBAAkB,GAAxB,MAAM,kBAAkB;IAC7B,KAAK,CAAC,KAAK,CAAC,MAAc;QACxB,IAAI,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAClE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,CAAC;YACrC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CACb,6BAA6B,MAAM,KAAK,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CACjF,CAAC;YACJ,CAAC;YACD,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;QACzB,CAAC;QAED,MAAM,QAAQ,GAAG,IAAA,mBAAO,EAAC,MAAM,CAAC,CAAC;QACjC,OAAO,IAAA,mBAAQ,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACrC,CAAC;CACF,CAAA;AAfY,gDAAkB;6BAAlB,kBAAkB;IAD9B,IAAA,mBAAU,GAAE;GACA,kBAAkB,CAe9B"}

package/libs/agentcraft/src/services/spec-fetcher.service.ts

@@ -0,0 +1,21 @@
+import { Injectable } from '@nestjs/common';
+import { readFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+
+@Injectable()
+export class SpecFetcherService {
+  async fetch(source: string): Promise<string> {
+    if (source.startsWith('http://') || source.startsWith('https://')) {
+      const response = await fetch(source);
+      if (!response.ok) {
+        throw new Error(
+          `Failed to fetch spec from ${source}: ${response.status} ${response.statusText}`,
+        );
+      }
+      return response.text();
+    }
+
+    const resolved = resolve(source);
+    return readFile(resolved, 'utf-8');
+  }
+}