@agentlang/agentmanager 0.0.3

package/libs/agentcraft/src/types/pipeline.types.d.ts

@@ -0,0 +1,55 @@
+export declare enum PipelineStep {
+  Requirements = 'requirements',
+  RequirementsDoc = 'requirements-doc',
+  DataModelSpec = 'data-model-spec',
+  UISpec = 'ui-spec',
+  APISpec = 'api-spec',
+  DataModel = 'data-model',
+  Workflows = 'workflows',
+  Agents = 'agents',
+  Assemble = 'assemble',
+  Tests = 'tests',
+}
+export interface StepDefinition {
+  id: PipelineStep;
+  name: string;
+  order: number;
+  role: string;
+  outputFile: string;
+  requiresValidation: boolean;
+  inputFiles: string[];
+}
+export interface ConversationMessage {
+  role: 'user' | 'assistant';
+  content: string;
+}
+export interface PipelineState {
+  projectName: string;
+  currentStep: PipelineStep;
+  completedSteps: PipelineStep[];
+  outputs: Record<string, string>;
+  conversations: Record<string, ConversationMessage[]>;
+  createdAt: string;
+  updatedAt: string;
+}
+export declare enum ReviewAction {
+  Approve = 'approve',
+  Revise = 'revise',
+  Edit = 'edit',
+  Back = 'back',
+  GoToStep = 'go-to-step',
+  Cancel = 'cancel',
+  Quit = 'quit',
+}
+export declare enum TestFailureAction {
+  AutoFix = 'auto-fix',
+  Analyze = 'analyze',
+  GoBack = 'go-back',
+  SaveAndExit = 'save-and-exit',
+}
+export interface CraftConfig {
+  provider: 'anthropic' | 'openai';
+  model?: string;
+  apiKey?: string;
+  outputDir: string;
+}

package/libs/agentcraft/src/types/pipeline.types.js

@@ -0,0 +1,37 @@
+'use strict';
+Object.defineProperty(exports, '__esModule', { value: true });
+exports.TestFailureAction =
+  exports.ReviewAction =
+  exports.PipelineStep =
+    void 0;
+var PipelineStep;
+(function (PipelineStep) {
+  PipelineStep['Requirements'] = 'requirements';
+  PipelineStep['RequirementsDoc'] = 'requirements-doc';
+  PipelineStep['DataModelSpec'] = 'data-model-spec';
+  PipelineStep['UISpec'] = 'ui-spec';
+  PipelineStep['APISpec'] = 'api-spec';
+  PipelineStep['DataModel'] = 'data-model';
+  PipelineStep['Workflows'] = 'workflows';
+  PipelineStep['Agents'] = 'agents';
+  PipelineStep['Assemble'] = 'assemble';
+  PipelineStep['Tests'] = 'tests';
+})(PipelineStep || (exports.PipelineStep = PipelineStep = {}));
+var ReviewAction;
+(function (ReviewAction) {
+  ReviewAction['Approve'] = 'approve';
+  ReviewAction['Revise'] = 'revise';
+  ReviewAction['Edit'] = 'edit';
+  ReviewAction['Back'] = 'back';
+  ReviewAction['GoToStep'] = 'go-to-step';
+  ReviewAction['Cancel'] = 'cancel';
+  ReviewAction['Quit'] = 'quit';
+})(ReviewAction || (exports.ReviewAction = ReviewAction = {}));
+var TestFailureAction;
+(function (TestFailureAction) {
+  TestFailureAction['AutoFix'] = 'auto-fix';
+  TestFailureAction['Analyze'] = 'analyze';
+  TestFailureAction['GoBack'] = 'go-back';
+  TestFailureAction['SaveAndExit'] = 'save-and-exit';
+})(TestFailureAction || (exports.TestFailureAction = TestFailureAction = {}));
+//# sourceMappingURL=pipeline.types.js.map

package/libs/agentcraft/src/types/pipeline.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.types.js","sourceRoot":"","sources":["pipeline.types.ts"],"names":[],"mappings":";;;AAAA,IAAY,YAWX;AAXD,WAAY,YAAY;IACtB,6CAA6B,CAAA;IAC7B,oDAAoC,CAAA;IACpC,iDAAiC,CAAA;IACjC,kCAAkB,CAAA;IAClB,oCAAoB,CAAA;IACpB,wCAAwB,CAAA;IACxB,uCAAuB,CAAA;IACvB,iCAAiB,CAAA;IACjB,qCAAqB,CAAA;IACrB,+BAAe,CAAA;AACjB,CAAC,EAXW,YAAY,4BAAZ,YAAY,QAWvB;AA2BD,IAAY,YAQX;AARD,WAAY,YAAY;IACtB,mCAAmB,CAAA;IACnB,iCAAiB,CAAA;IACjB,6BAAa,CAAA;IACb,6BAAa,CAAA;IACb,uCAAuB,CAAA;IACvB,iCAAiB,CAAA;IACjB,6BAAa,CAAA;AACf,CAAC,EARW,YAAY,4BAAZ,YAAY,QAQvB;AAED,IAAY,iBAKX;AALD,WAAY,iBAAiB;IAC3B,yCAAoB,CAAA;IACpB,wCAAmB,CAAA;IACnB,uCAAkB,CAAA;IAClB,kDAA6B,CAAA;AAC/B,CAAC,EALW,iBAAiB,iCAAjB,iBAAiB,QAK5B"}

package/libs/agentcraft/src/types/pipeline.types.ts

@@ -0,0 +1,61 @@
+export enum PipelineStep {
+  Requirements = 'requirements',
+  RequirementsDoc = 'requirements-doc',
+  DataModelSpec = 'data-model-spec',
+  UISpec = 'ui-spec',
+  APISpec = 'api-spec',
+  DataModel = 'data-model',
+  Workflows = 'workflows',
+  Agents = 'agents',
+  Assemble = 'assemble',
+  Tests = 'tests',
+}
+
+export interface StepDefinition {
+  id: PipelineStep;
+  name: string;
+  order: number;
+  role: string;
+  outputFile: string;
+  requiresValidation: boolean;
+  inputFiles: string[];
+}
+
+export interface ConversationMessage {
+  role: 'user' | 'assistant';
+  content: string;
+}
+
+export interface PipelineState {
+  projectName: string;
+  currentStep: PipelineStep;
+  completedSteps: PipelineStep[];
+  outputs: Record<string, string>;
+  conversations: Record<string, ConversationMessage[]>;
+  createdAt: string;
+  updatedAt: string;
+}
+
+export enum ReviewAction {
+  Approve = 'approve',
+  Revise = 'revise',
+  Edit = 'edit',
+  Back = 'back',
+  GoToStep = 'go-to-step',
+  Cancel = 'cancel',
+  Quit = 'quit',
+}
+
+export enum TestFailureAction {
+  AutoFix = 'auto-fix',
+  Analyze = 'analyze',
+  GoBack = 'go-back',
+  SaveAndExit = 'save-and-exit',
+}
+
+export interface CraftConfig {
+  provider: 'anthropic' | 'openai';
+  model?: string;
+  apiKey?: string;
+  outputDir: string;
+}

package/libs/agentcraft/src/types/resolver.types.d.ts

@@ -0,0 +1,27 @@
+export interface RegistryEntry {
+  name: string;
+  service: string;
+  description: string;
+  tags: string[];
+  entities: {
+    name: string;
+    operations: string[];
+    attributes: string[];
+  }[];
+  auth: {
+    envVars: string[];
+    scheme: string;
+  };
+  repo: string;
+  version: string;
+}
+export interface RegistrySearchResult {
+  entry: RegistryEntry;
+  score: number;
+}
+export interface GitHubContentEntry {
+  name: string;
+  path: string;
+  download_url: string;
+  type: string;
+}

package/libs/agentcraft/src/types/resolver.types.js

@@ -0,0 +1,3 @@
+'use strict';
+Object.defineProperty(exports, '__esModule', { value: true });
+//# sourceMappingURL=resolver.types.js.map

package/libs/agentcraft/src/types/resolver.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.types.js","sourceRoot":"","sources":["resolver.types.ts"],"names":[],"mappings":""}

package/libs/agentcraft/src/types/resolver.types.ts

@@ -0,0 +1,22 @@
+export interface RegistryEntry {
+  name: string;
+  service: string;
+  description: string;
+  tags: string[];
+  entities: { name: string; operations: string[]; attributes: string[] }[];
+  auth: { envVars: string[]; scheme: string };
+  repo: string;
+  version: string;
+}
+
+export interface RegistrySearchResult {
+  entry: RegistryEntry;
+  score: number;
+}
+
+export interface GitHubContentEntry {
+  name: string;
+  path: string;
+  download_url: string;
+  type: string;
+}

package/libs/agentcraft/src/types/signal.types.d.ts

@@ -0,0 +1,16 @@
+export type SignalKind =
+  | 'requirements-change'
+  | 'incident'
+  | 'feedback'
+  | 'scheduled'
+  | 'manual';
+export type SignalPriority = 'low' | 'medium' | 'high' | 'critical';
+export interface Signal {
+  id: string;
+  kind: SignalKind;
+  source: string;
+  summary: string;
+  data: Record<string, unknown>;
+  timestamp: string;
+  priority: SignalPriority;
+}

package/libs/agentcraft/src/types/signal.types.js

@@ -0,0 +1,3 @@
+'use strict';
+Object.defineProperty(exports, '__esModule', { value: true });
+//# sourceMappingURL=signal.types.js.map

package/libs/agentcraft/src/types/signal.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal.types.js","sourceRoot":"","sources":["signal.types.ts"],"names":[],"mappings":""}

package/libs/agentcraft/src/types/signal.types.ts

@@ -0,0 +1,18 @@
+export type SignalKind =
+  | 'requirements-change'
+  | 'incident'
+  | 'feedback'
+  | 'scheduled'
+  | 'manual';
+
+export type SignalPriority = 'low' | 'medium' | 'high' | 'critical';
+
+export interface Signal {
+  id: string;
+  kind: SignalKind;
+  source: string;
+  summary: string;
+  data: Record<string, unknown>;
+  timestamp: string;
+  priority: SignalPriority;
+}

package/libs/agentcraft/src/utils/kb-loader.ts

@@ -0,0 +1,67 @@
+import fs from 'node:fs';
+import path from 'node:path';
+
+const SUPPORTED_EXTENSIONS = [
+  '.txt',
+  '.md',
+  '.markdown',
+  '.al',
+  '.json',
+  '.yaml',
+  '.yml',
+];
+
+/**
+ * Loads ALL documents from the knowledgebase directory and returns them
+ * as a single concatenated string.
+ */
+export function loadAllKBDocuments(kbPath: string): string {
+  const resolved = path.resolve(kbPath);
+
+  let files: string[];
+  try {
+    files = fs.readdirSync(resolved);
+  } catch {
+    throw new Error(
+      `Knowledge base directory not found: ${resolved}\n` +
+        'Autonomous mode requires a knowledge base. Provide a directory containing specification documents.',
+    );
+  }
+
+  const sections: string[] = [];
+
+  for (const file of files.sort()) {
+    const ext = path.extname(file).toLowerCase();
+    if (!SUPPORTED_EXTENSIONS.includes(ext)) continue;
+
+    const filePath = path.join(resolved, file);
+    let stat;
+    try {
+      stat = fs.statSync(filePath);
+    } catch {
+      continue;
+    }
+    if (!stat.isFile()) continue;
+
+    let content: string;
+    try {
+      content = fs.readFileSync(filePath, 'utf-8');
+    } catch {
+      continue;
+    }
+
+    if (content.trim()) {
+      sections.push(`--- Document: ${file} ---\n${content}`);
+    }
+  }
+
+  if (sections.length === 0) {
+    throw new Error(
+      `Knowledge base at ${resolved} contains no supported documents.\n` +
+        `Supported file types: ${SUPPORTED_EXTENSIONS.join(', ')}\n` +
+        'Add specification documents describing the application to generate.',
+    );
+  }
+
+  return sections.join('\n\n');
+}

package/libs/agentcraft/src/utils/output-writer.ts

@@ -0,0 +1,71 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { normalizeGeneratedCode } from './validator';
+
+const FILE_DELIMITER_PATTERN = /^--- FILE:\s*(.+?)\s*---$/;
+
+export interface ParsedFile {
+  filePath: string;
+  content: string;
+}
+
+/**
+ * Parses the multi-file output format from the assembly step.
+ * The format uses `--- FILE: <path> ---` as delimiters between files.
+ */
+export function parseAssemblyOutput(output: string): ParsedFile[] {
+  const lines = output.split('\n');
+  const files: ParsedFile[] = [];
+  let currentFile: string | null = null;
+  let currentContent: string[] = [];
+
+  for (const line of lines) {
+    const match = FILE_DELIMITER_PATTERN.exec(line);
+    if (match) {
+      if (currentFile !== null) {
+        files.push({
+          filePath: currentFile,
+          content: currentContent.join('\n').trim(),
+        });
+      }
+      currentFile = match[1];
+      currentContent = [];
+    } else if (currentFile !== null) {
+      currentContent.push(line);
+    }
+  }
+
+  if (currentFile !== null) {
+    files.push({
+      filePath: currentFile,
+      content: currentContent.join('\n').trim(),
+    });
+  }
+
+  return files;
+}
+
+/**
+ * Writes the parsed assembly output files to the output directory.
+ * Returns the list of written file paths.
+ */
+export function writeAppFiles(output: string, outputDir: string): string[] {
+  const files = parseAssemblyOutput(output);
+
+  if (files.length === 0) {
+    return [];
+  }
+
+  const writtenPaths: string[] = [];
+
+  for (const file of files) {
+    const fullPath = path.join(outputDir, file.filePath);
+    const dir = path.dirname(fullPath);
+    fs.mkdirSync(dir, { recursive: true });
+    const cleaned = normalizeGeneratedCode(file.content);
+    fs.writeFileSync(fullPath, cleaned + '\n');
+    writtenPaths.push(fullPath);
+  }
+
+  return writtenPaths;
+}

package/libs/agentcraft/src/utils/spec-fetcher.ts

@@ -0,0 +1,20 @@
+import fs from 'node:fs';
+import path from 'node:path';
+
+/**
+ * Fetches an API specification from a URL or local file path.
+ */
+export async function fetchSpec(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 = path.resolve(source);
+  return fs.readFileSync(resolved, 'utf-8');
+}

package/libs/agentcraft/src/utils/spec-trimmer.ts

@@ -0,0 +1,280 @@
+const DEFAULT_CHAR_BUDGET = 300_000;
+const MAX_DESCRIPTION_LENGTH = 200;
+
+export interface TrimResult {
+  content: string;
+  originalSize: number;
+  trimmedSize: number;
+  wasOpenAPI: boolean;
+  pathsKept?: number;
+  pathsTotal?: number;
+}
+
+/**
+ * Trims an API specification to fit within a character budget.
+ */
+export function trimSpec(
+  specContent: string,
+  description: string,
+  charBudget: number = DEFAULT_CHAR_BUDGET,
+): TrimResult {
+  const originalSize = specContent.length;
+
+  if (originalSize <= charBudget) {
+    return {
+      content: specContent,
+      originalSize,
+      trimmedSize: originalSize,
+      wasOpenAPI: false,
+    };
+  }
+
+  let spec: Record<string, unknown>;
+  try {
+    spec = JSON.parse(specContent) as Record<string, unknown>;
+  } catch {
+    return {
+      ...hardTruncate(specContent, charBudget),
+      originalSize,
+      wasOpenAPI: false,
+    };
+  }
+
+  if (
+    !spec ||
+    (typeof spec.openapi !== 'string' && typeof spec.swagger !== 'string')
+  ) {
+    return {
+      ...hardTruncate(JSON.stringify(spec), charBudget),
+      originalSize,
+      wasOpenAPI: false,
+    };
+  }
+
+  const stripped = stripOpenAPIBulk(spec) as Record<string, unknown>;
+  let result = JSON.stringify(stripped);
+
+  if (result.length <= charBudget) {
+    const paths = spec.paths as Record<string, unknown> | undefined;
+    const pathsTotal = paths ? Object.keys(paths).length : 0;
+    return {
+      content: result,
+      originalSize,
+      trimmedSize: result.length,
+      wasOpenAPI: true,
+      pathsKept: pathsTotal,
+      pathsTotal,
+    };
+  }
+
+  const strippedPaths = stripped.paths as Record<string, unknown> | undefined;
+  const pathsTotal = strippedPaths ? Object.keys(strippedPaths).length : 0;
+  const filtered = filterPathsByDescription(stripped, description, charBudget);
+  result = JSON.stringify(filtered);
+  const filteredPaths = (filtered as Record<string, unknown>).paths as
+    | Record<string, unknown>
+    | undefined;
+  const pathsKept = filteredPaths ? Object.keys(filteredPaths).length : 0;
+
+  if (result.length <= charBudget) {
+    return {
+      content: result,
+      originalSize,
+      trimmedSize: result.length,
+      wasOpenAPI: true,
+      pathsKept,
+      pathsTotal,
+    };
+  }
+
+  return {
+    ...hardTruncate(result, charBudget),
+    originalSize,
+    wasOpenAPI: true,
+    pathsKept,
+    pathsTotal,
+  };
+}
+
+function stripOpenAPIBulk(obj: unknown): unknown {
+  if (Array.isArray(obj)) {
+    return obj.map((item: unknown) => stripOpenAPIBulk(item));
+  }
+
+  if (obj !== null && typeof obj === 'object') {
+    const source = obj as Record<string, unknown>;
+    const cleaned: Record<string, unknown> = {};
+    for (const key of Object.keys(source)) {
+      if (key === 'examples' || key === 'example') continue;
+      if (key.startsWith('x-')) continue;
+
+      const value = source[key];
+      if (
+        key === 'description' &&
+        typeof value === 'string' &&
+        value.length > MAX_DESCRIPTION_LENGTH
+      ) {
+        cleaned[key] = value.slice(0, MAX_DESCRIPTION_LENGTH) + '...';
+      } else {
+        cleaned[key] = stripOpenAPIBulk(value);
+      }
+    }
+    return cleaned;
+  }
+
+  return obj;
+}
+
+function filterPathsByDescription(
+  spec: Record<string, unknown>,
+  description: string,
+  budget: number,
+): Record<string, unknown> {
+  if (!spec.paths || typeof spec.paths !== 'object') {
+    return spec;
+  }
+
+  const keywords = tokenizeToKeywords(description);
+  if (keywords.length === 0) {
+    return spec;
+  }
+
+  const scored: { path: string; score: number; content: unknown }[] = [];
+  for (const [pathKey, pathValue] of Object.entries(
+    spec.paths as Record<string, unknown>,
+  )) {
+    const pathText = pathKey + ' ' + JSON.stringify(pathValue);
+    const pathLower = pathText.toLowerCase();
+    let score = 0;
+    for (const kw of keywords) {
+      if (pathLower.includes(kw)) score++;
+    }
+    scored.push({ path: pathKey, score, content: pathValue });
+  }
+
+  scored.sort((a, b) => b.score - a.score);
+
+  const { paths: _paths, ...specWithoutPaths } = spec;
+  const baseJson = JSON.stringify({ ...specWithoutPaths, paths: {} });
+  let currentSize = baseJson.length;
+  const keptPaths: Record<string, unknown> = {};
+
+  for (const entry of scored) {
+    const pathJson = JSON.stringify({ [entry.path]: entry.content });
+    const addedSize = pathJson.length;
+    if (currentSize + addedSize > budget && Object.keys(keptPaths).length > 0) {
+      break;
+    }
+    keptPaths[entry.path] = entry.content;
+    currentSize += addedSize;
+  }
+
+  return { ...specWithoutPaths, paths: keptPaths };
+}
+
+function tokenizeToKeywords(description: string): string[] {
+  const stopWords = new Set([
+    'a',
+    'an',
+    'the',
+    'and',
+    'or',
+    'but',
+    'in',
+    'on',
+    'at',
+    'to',
+    'for',
+    'of',
+    'with',
+    'by',
+    'from',
+    'is',
+    'are',
+    'was',
+    'were',
+    'be',
+    'been',
+    'being',
+    'have',
+    'has',
+    'had',
+    'do',
+    'does',
+    'did',
+    'will',
+    'would',
+    'could',
+    'should',
+    'may',
+    'might',
+    'shall',
+    'can',
+    'that',
+    'this',
+    'these',
+    'those',
+    'it',
+    'its',
+    'i',
+    'we',
+    'you',
+    'they',
+    'he',
+    'she',
+    'my',
+    'our',
+    'your',
+    'their',
+    'his',
+    'her',
+    'all',
+    'each',
+    'every',
+    'both',
+    'few',
+    'more',
+    'most',
+    'some',
+    'any',
+    'no',
+    'not',
+    'only',
+    'same',
+    'so',
+    'than',
+    'too',
+    'very',
+    'just',
+    'about',
+    'above',
+    'after',
+    'again',
+    'against',
+    'between',
+    'into',
+    'through',
+    'during',
+    'before',
+    'api',
+    'using',
+    'use',
+    'crud',
+    'operations',
+  ]);
+
+  return description
+    .toLowerCase()
+    .split(/[^a-z0-9]+/)
+    .filter((word) => word.length >= 2 && !stopWords.has(word));
+}
+
+function hardTruncate(
+  text: string,
+  limit: number,
+): { content: string; trimmedSize: number } {
+  const marker = `\n\n[... truncated — showing first ${limit.toLocaleString()} of ${text.length.toLocaleString()} characters]`;
+  const cutoff = limit - marker.length;
+  const content = text.slice(0, cutoff) + marker;
+  return { content, trimmedSize: content.length };
+}