@agentlang/agentmanager 0.0.3

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

@@ -0,0 +1,9 @@
+import { LlmProvider } from '../interfaces/llm-provider.interface';
+import { LlmRequest, LlmResponse } from '../types/llm.types';
+export declare class AnthropicLlmService implements LlmProvider {
+  private readonly model;
+  private readonly apiKey;
+  private readonly baseUrl;
+  constructor(model: string, apiKey: string, baseUrl?: string);
+  complete(request: LlmRequest): Promise<LlmResponse>;
+}

package/libs/agentcraft/src/services/anthropic-llm.service.js

@@ -0,0 +1,90 @@
+'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.AnthropicLlmService = void 0;
+const common_1 = require('@nestjs/common');
+const llm_errors_1 = require('../errors/llm.errors');
+let AnthropicLlmService = class AnthropicLlmService {
+  model;
+  apiKey;
+  baseUrl;
+  constructor(model, apiKey, baseUrl = 'https://api.anthropic.com') {
+    this.model = model;
+    this.apiKey = apiKey;
+    this.baseUrl = baseUrl;
+  }
+  async complete(request) {
+    const url = `${this.baseUrl.replace(/\/+$/, '')}/v1/messages`;
+    let res;
+    try {
+      res = await fetch(url, {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+          'x-api-key': this.apiKey,
+          'anthropic-version': '2023-06-01',
+        },
+        body: JSON.stringify({
+          model: this.model,
+          max_tokens: request.maxTokens ?? 16384,
+          temperature: request.temperature ?? 0,
+          system: request.systemPrompt,
+          messages: [{ role: 'user', content: request.userPrompt }],
+        }),
+      });
+    } catch (err) {
+      throw new llm_errors_1.LlmRequestFailedError(
+        `Failed to connect to Anthropic API: ${err.message}`,
+      );
+    }
+    if (!res.ok) {
+      const body = await res.text().catch(() => '');
+      throw new llm_errors_1.LlmRequestFailedError(
+        `Anthropic API returned ${res.status}: ${body}`,
+      );
+    }
+    const json = await res.json();
+    const textBlock = json?.content?.find((b) => b.type === 'text');
+    if (!textBlock || typeof textBlock.text !== 'string') {
+      throw new llm_errors_1.LlmRequestFailedError(
+        'Unexpected response shape from Anthropic API',
+      );
+    }
+    const stopReason =
+      json.stop_reason === 'max_tokens' ? 'max_tokens' : 'end_turn';
+    return { text: textBlock.text, stopReason };
+  }
+};
+exports.AnthropicLlmService = AnthropicLlmService;
+exports.AnthropicLlmService = AnthropicLlmService = __decorate(
+  [
+    (0, common_1.Injectable)(),
+    __metadata('design:paramtypes', [String, String, String]),
+  ],
+  AnthropicLlmService,
+);
+//# sourceMappingURL=anthropic-llm.service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic-llm.service.js","sourceRoot":"","sources":["anthropic-llm.service.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAG5C,qDAA6D;AAGtD,IAAM,mBAAmB,GAAzB,MAAM,mBAAmB;IAEX;IACA;IACA;IAHnB,YACmB,KAAa,EACb,MAAc,EACd,UAAkB,2BAA2B;QAF7C,UAAK,GAAL,KAAK,CAAQ;QACb,WAAM,GAAN,MAAM,CAAQ;QACd,YAAO,GAAP,OAAO,CAAsC;IAC7D,CAAC;IAEJ,KAAK,CAAC,QAAQ,CAAC,OAAmB;QAChC,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,cAAc,CAAC;QAC9D,IAAI,GAAa,CAAC;QAClB,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBACrB,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;oBAClC,WAAW,EAAE,IAAI,CAAC,MAAM;oBACxB,mBAAmB,EAAE,YAAY;iBAClC;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,KAAK,EAAE,IAAI,CAAC,KAAK;oBACjB,UAAU,EAAE,OAAO,CAAC,SAAS,IAAI,KAAK;oBACtC,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,CAAC;oBACrC,MAAM,EAAE,OAAO,CAAC,YAAY;oBAC5B,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC;iBAC1D,CAAC;aACH,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,kCAAqB,CAC7B,uCAAwC,GAAa,CAAC,OAAO,EAAE,CAChE,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YAC9C,MAAM,IAAI,kCAAqB,CAC7B,0BAA0B,GAAG,CAAC,MAAM,KAAK,IAAI,EAAE,CAChD,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,MAAM,SAAS,GAAG,IAAI,EAAE,OAAO,EAAE,IAAI,CACnC,CAAC,CAAmB,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAC3C,CAAC;QACF,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACrD,MAAM,IAAI,kCAAqB,CAC7B,8CAA8C,CAC/C,CAAC;QACJ,CAAC;QACD,MAAM,UAAU,GACd,IAAI,CAAC,WAAW,KAAK,YAAY,CAAC,CAAC,CAAC,YAAqB,CAAC,CAAC,CAAC,UAAmB,CAAC;QAClF,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC;IAC9C,CAAC;CACF,CAAA;AApDY,kDAAmB;8BAAnB,mBAAmB;IAD/B,IAAA,mBAAU,GAAE;;GACA,mBAAmB,CAoD/B"}

package/libs/agentcraft/src/services/anthropic-llm.service.ts

@@ -0,0 +1,61 @@
+import { Injectable } from '@nestjs/common';
+import { LlmProvider } from '../interfaces/llm-provider.interface';
+import { LlmRequest, LlmResponse } from '../types/llm.types';
+import { LlmRequestFailedError } from '../errors/llm.errors';
+
+@Injectable()
+export class AnthropicLlmService implements LlmProvider {
+  constructor(
+    private readonly model: string,
+    private readonly apiKey: string,
+    private readonly baseUrl: string = 'https://api.anthropic.com',
+  ) {}
+
+  async complete(request: LlmRequest): Promise<LlmResponse> {
+    const url = `${this.baseUrl.replace(/\/+$/, '')}/v1/messages`;
+    let res: Response;
+    try {
+      res = await fetch(url, {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+          'x-api-key': this.apiKey,
+          'anthropic-version': '2023-06-01',
+        },
+        body: JSON.stringify({
+          model: this.model,
+          max_tokens: request.maxTokens ?? 16384,
+          temperature: request.temperature ?? 0,
+          system: request.systemPrompt,
+          messages: [{ role: 'user', content: request.userPrompt }],
+        }),
+      });
+    } catch (err) {
+      throw new LlmRequestFailedError(
+        `Failed to connect to Anthropic API: ${(err as Error).message}`,
+      );
+    }
+
+    if (!res.ok) {
+      const body = await res.text().catch(() => '');
+      throw new LlmRequestFailedError(
+        `Anthropic API returned ${res.status}: ${body}`,
+      );
+    }
+
+    const json = await res.json();
+    const textBlock = json?.content?.find(
+      (b: { type: string }) => b.type === 'text',
+    );
+    if (!textBlock || typeof textBlock.text !== 'string') {
+      throw new LlmRequestFailedError(
+        'Unexpected response shape from Anthropic API',
+      );
+    }
+    const stopReason =
+      json.stop_reason === 'max_tokens'
+        ? ('max_tokens' as const)
+        : ('end_turn' as const);
+    return { text: textBlock.text, stopReason };
+  }
+}

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

@@ -0,0 +1,65 @@
+import { EventEmitter } from 'node:events';
+import {
+  PipelineStep,
+  ReviewAction,
+  TestFailureAction,
+  StepDefinition,
+} from '../types/pipeline.types';
+export interface SSEEvent {
+  type: string;
+  data: Record<string, unknown>;
+  timestamp: string;
+}
+export type WaitingFor =
+  | 'idea'
+  | 'feedback'
+  | 'reviewAction'
+  | 'targetStep'
+  | 'editableStep'
+  | 'editContent'
+  | 'postEditNavigation'
+  | 'testFailureAction'
+  | 'resume'
+  | null;
+export declare class ApiAdapterService {
+  private readonly emitter;
+  private eventLog;
+  private currentStepOutput;
+  private _waitingFor;
+  private stashedFeedback;
+  private stashedTargetStep;
+  private stashedEditStep;
+  private stashedEditContent;
+  private stashedPostEditTarget;
+  get waitingFor(): WaitingFor;
+  get output(): string;
+  get events(): readonly SSEEvent[];
+  get eventEmitter(): EventEmitter;
+  resolveIdea(idea: string): void;
+  resolveReviewAction(
+    action: ReviewAction,
+    feedback?: string,
+    targetStep?: PipelineStep,
+    editStep?: PipelineStep,
+    editContent?: string,
+    postEditTarget?: PipelineStep,
+  ): void;
+  resolveTargetStep(step: PipelineStep): void;
+  resolveResume(value: boolean): void;
+  resolveEditableStep(step: PipelineStep): void;
+  resolveEditContent(content: string): void;
+  resolvePostEditNavigation(step: PipelineStep): void;
+  resolveTestFailureAction(action: TestFailureAction): void;
+  showStepHeader(step: StepDefinition): void;
+  showInfo(message: string): void;
+  showSuccess(message: string): void;
+  showError(message: string): void;
+  writeChunk(chunk: string): void;
+  getAppIdea(): Promise<string>;
+  getReviewAction(): Promise<ReviewAction>;
+  confirmResume(): Promise<boolean>;
+  private emit;
+}
+export declare class ApiAdapterFactory {
+  create(): ApiAdapterService;
+}

package/libs/agentcraft/src/services/api-adapter.service.js

@@ -0,0 +1,167 @@
+'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.ApiAdapterFactory = exports.ApiAdapterService = void 0;
+const common_1 = require('@nestjs/common');
+const node_events_1 = require('node:events');
+let ApiAdapterService = class ApiAdapterService {
+  emitter = new node_events_1.EventEmitter();
+  eventLog = [];
+  currentStepOutput = '';
+  _waitingFor = null;
+  stashedFeedback = null;
+  stashedTargetStep = null;
+  stashedEditStep = null;
+  stashedEditContent = null;
+  stashedPostEditTarget = null;
+  get waitingFor() {
+    return this._waitingFor;
+  }
+  get output() {
+    return this.currentStepOutput;
+  }
+  get events() {
+    return this.eventLog;
+  }
+  get eventEmitter() {
+    return this.emitter;
+  }
+  resolveIdea(idea) {
+    if (this._waitingFor !== 'idea') return;
+    this._waitingFor = null;
+    this.emit('waitingFor', { waitingFor: null });
+    this.emitter.emit('resolve:idea', idea);
+  }
+  resolveReviewAction(
+    action,
+    feedback,
+    targetStep,
+    editStep,
+    editContent,
+    postEditTarget,
+  ) {
+    if (feedback) this.stashedFeedback = feedback;
+    if (targetStep) this.stashedTargetStep = targetStep;
+    if (editStep) this.stashedEditStep = editStep;
+    if (editContent !== undefined) this.stashedEditContent = editContent;
+    if (postEditTarget) this.stashedPostEditTarget = postEditTarget;
+    if (this._waitingFor !== 'reviewAction') return;
+    this._waitingFor = null;
+    this.emit('waitingFor', { waitingFor: null });
+    this.emitter.emit('resolve:reviewAction', action);
+  }
+  resolveTargetStep(step) {
+    if (this._waitingFor !== 'targetStep') return;
+    this._waitingFor = null;
+    this.emitter.emit('resolve:targetStep', step);
+  }
+  resolveResume(value) {
+    if (this._waitingFor !== 'resume') return;
+    this._waitingFor = null;
+    this.emitter.emit('resolve:resume', value);
+  }
+  resolveEditableStep(step) {
+    if (this._waitingFor !== 'editableStep') return;
+    this._waitingFor = null;
+    this.emitter.emit('resolve:editableStep', step);
+  }
+  resolveEditContent(content) {
+    if (this._waitingFor !== 'editContent') return;
+    this._waitingFor = null;
+    this.emitter.emit('resolve:editContent', content);
+  }
+  resolvePostEditNavigation(step) {
+    if (this._waitingFor !== 'postEditNavigation') return;
+    this._waitingFor = null;
+    this.emitter.emit('resolve:postEditNavigation', step);
+  }
+  resolveTestFailureAction(action) {
+    if (this._waitingFor !== 'testFailureAction') return;
+    this._waitingFor = null;
+    this.emitter.emit('resolve:testFailureAction', action);
+  }
+  showStepHeader(step) {
+    this.currentStepOutput = '';
+    this.emit('stepStart', {
+      stepId: step.id,
+      stepName: step.name,
+      stepOrder: step.order,
+      role: step.role,
+    });
+  }
+  showInfo(message) {
+    this.emit('info', { message });
+  }
+  showSuccess(message) {
+    this.emit('success', { message });
+  }
+  showError(message) {
+    this.emit('error', { message });
+  }
+  writeChunk(chunk) {
+    this.currentStepOutput += chunk;
+    this.emit('chunk', { chunk });
+  }
+  getAppIdea() {
+    this._waitingFor = 'idea';
+    this.emit('waitingFor', { waitingFor: 'idea' });
+    return new Promise((resolve) => this.emitter.once('resolve:idea', resolve));
+  }
+  getReviewAction() {
+    this._waitingFor = 'reviewAction';
+    this.emit('waitingFor', { waitingFor: 'reviewAction' });
+    return new Promise((resolve) =>
+      this.emitter.once('resolve:reviewAction', resolve),
+    );
+  }
+  confirmResume() {
+    this._waitingFor = 'resume';
+    this.emit('waitingFor', { waitingFor: 'resume' });
+    return new Promise((resolve) =>
+      this.emitter.once('resolve:resume', resolve),
+    );
+  }
+  emit(type, data) {
+    const event = {
+      type,
+      data,
+      timestamp: new Date().toISOString(),
+    };
+    this.eventLog.push(event);
+    this.emitter.emit('sse', event);
+  }
+};
+exports.ApiAdapterService = ApiAdapterService;
+exports.ApiAdapterService = ApiAdapterService = __decorate(
+  [(0, common_1.Injectable)()],
+  ApiAdapterService,
+);
+let ApiAdapterFactory = class ApiAdapterFactory {
+  create() {
+    return new ApiAdapterService();
+  }
+};
+exports.ApiAdapterFactory = ApiAdapterFactory;
+exports.ApiAdapterFactory = ApiAdapterFactory = __decorate(
+  [(0, common_1.Injectable)()],
+  ApiAdapterFactory,
+);
+//# sourceMappingURL=api-adapter.service.js.map

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

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

package/libs/agentcraft/src/services/api-adapter.service.ts

@@ -0,0 +1,186 @@
+import { Injectable } from '@nestjs/common';
+import { EventEmitter } from 'node:events';
+import {
+  PipelineStep,
+  ReviewAction,
+  TestFailureAction,
+  StepDefinition,
+} from '../types/pipeline.types';
+
+export interface SSEEvent {
+  type: string;
+  data: Record<string, unknown>;
+  timestamp: string;
+}
+
+export type WaitingFor =
+  | 'idea'
+  | 'feedback'
+  | 'reviewAction'
+  | 'targetStep'
+  | 'editableStep'
+  | 'editContent'
+  | 'postEditNavigation'
+  | 'testFailureAction'
+  | 'resume'
+  | null;
+
+@Injectable()
+export class ApiAdapterService {
+  private readonly emitter = new EventEmitter();
+  private eventLog: SSEEvent[] = [];
+  private currentStepOutput = '';
+  private _waitingFor: WaitingFor = null;
+
+  private stashedFeedback: string | null = null;
+  private stashedTargetStep: PipelineStep | null = null;
+  private stashedEditStep: PipelineStep | null = null;
+  private stashedEditContent: string | null = null;
+  private stashedPostEditTarget: PipelineStep | null = null;
+
+  get waitingFor(): WaitingFor {
+    return this._waitingFor;
+  }
+
+  get output(): string {
+    return this.currentStepOutput;
+  }
+
+  get events(): readonly SSEEvent[] {
+    return this.eventLog;
+  }
+
+  get eventEmitter(): EventEmitter {
+    return this.emitter;
+  }
+
+  resolveIdea(idea: string): void {
+    if (this._waitingFor !== 'idea') return;
+    this._waitingFor = null;
+    this.emit('waitingFor', { waitingFor: null });
+    this.emitter.emit('resolve:idea', idea);
+  }
+
+  resolveReviewAction(
+    action: ReviewAction,
+    feedback?: string,
+    targetStep?: PipelineStep,
+    editStep?: PipelineStep,
+    editContent?: string,
+    postEditTarget?: PipelineStep,
+  ): void {
+    if (feedback) this.stashedFeedback = feedback;
+    if (targetStep) this.stashedTargetStep = targetStep;
+    if (editStep) this.stashedEditStep = editStep;
+    if (editContent !== undefined) this.stashedEditContent = editContent;
+    if (postEditTarget) this.stashedPostEditTarget = postEditTarget;
+    if (this._waitingFor !== 'reviewAction') return;
+    this._waitingFor = null;
+    this.emit('waitingFor', { waitingFor: null });
+    this.emitter.emit('resolve:reviewAction', action);
+  }
+
+  resolveTargetStep(step: PipelineStep): void {
+    if (this._waitingFor !== 'targetStep') return;
+    this._waitingFor = null;
+    this.emitter.emit('resolve:targetStep', step);
+  }
+
+  resolveResume(value: boolean): void {
+    if (this._waitingFor !== 'resume') return;
+    this._waitingFor = null;
+    this.emitter.emit('resolve:resume', value);
+  }
+
+  resolveEditableStep(step: PipelineStep): void {
+    if (this._waitingFor !== 'editableStep') return;
+    this._waitingFor = null;
+    this.emitter.emit('resolve:editableStep', step);
+  }
+
+  resolveEditContent(content: string): void {
+    if (this._waitingFor !== 'editContent') return;
+    this._waitingFor = null;
+    this.emitter.emit('resolve:editContent', content);
+  }
+
+  resolvePostEditNavigation(step: PipelineStep): void {
+    if (this._waitingFor !== 'postEditNavigation') return;
+    this._waitingFor = null;
+    this.emitter.emit('resolve:postEditNavigation', step);
+  }
+
+  resolveTestFailureAction(action: TestFailureAction): void {
+    if (this._waitingFor !== 'testFailureAction') return;
+    this._waitingFor = null;
+    this.emitter.emit('resolve:testFailureAction', action);
+  }
+
+  // --- IO methods ---
+
+  showStepHeader(step: StepDefinition): void {
+    this.currentStepOutput = '';
+    this.emit('stepStart', {
+      stepId: step.id,
+      stepName: step.name,
+      stepOrder: step.order,
+      role: step.role,
+    });
+  }
+
+  showInfo(message: string): void {
+    this.emit('info', { message });
+  }
+
+  showSuccess(message: string): void {
+    this.emit('success', { message });
+  }
+
+  showError(message: string): void {
+    this.emit('error', { message });
+  }
+
+  writeChunk(chunk: string): void {
+    this.currentStepOutput += chunk;
+    this.emit('chunk', { chunk });
+  }
+
+  getAppIdea(): Promise<string> {
+    this._waitingFor = 'idea';
+    this.emit('waitingFor', { waitingFor: 'idea' });
+    return new Promise((resolve) => this.emitter.once('resolve:idea', resolve));
+  }
+
+  getReviewAction(): Promise<ReviewAction> {
+    this._waitingFor = 'reviewAction';
+    this.emit('waitingFor', { waitingFor: 'reviewAction' });
+    return new Promise((resolve) =>
+      this.emitter.once('resolve:reviewAction', resolve),
+    );
+  }
+
+  confirmResume(): Promise<boolean> {
+    this._waitingFor = 'resume';
+    this.emit('waitingFor', { waitingFor: 'resume' });
+    return new Promise((resolve) =>
+      this.emitter.once('resolve:resume', resolve),
+    );
+  }
+
+  private emit(type: string, data: Record<string, unknown>): void {
+    const event: SSEEvent = {
+      type,
+      data,
+      timestamp: new Date().toISOString(),
+    };
+    this.eventLog.push(event);
+    this.emitter.emit('sse', event);
+  }
+}
+
+@Injectable()
+export class ApiAdapterFactory {
+  create(): ApiAdapterService {
+    return new ApiAdapterService();
+  }
+}

package/libs/agentcraft/src/services/architect-loop.service.d.ts

@@ -0,0 +1,16 @@
+import { Signal } from '../types/signal.types';
+export interface ArchitectLoopConfig {
+  projectId: string;
+  userId: string;
+}
+export interface ArchitectLoop {
+  ingest(signal: Signal): void;
+  run(): Promise<void>;
+  stop(): void;
+  onLog: ((phase: string, detail: string) => void) | null;
+  onSignalComplete: ((signal: Signal, summary: string) => void) | null;
+}
+export declare class ArchitectLoopFactory {
+  private readonly logger;
+  create(config: ArchitectLoopConfig): ArchitectLoop;
+}