@autobe/agent 0.30.0-dev.20260315 → 0.30.0

package/src/orchestrate/analyze/orchestrateAnalyzeScenarioReview.ts

@@ -1,122 +1,122 @@
-import { IAgenticaController } from "@agentica/core";
-import {
-  AutoBeAnalyzeScenarioEvent,
-  AutoBeAnalyzeScenarioReviewEvent,
-  AutoBeAnalyzeScenarioReviewIssue,
-  AutoBeEventSource,
-} from "@autobe/interface";
-import { IPointer } from "tstl";
-import typia, { ILlmApplication, IValidation } from "typia";
-import { v7 } from "uuid";
-
-import { AutoBeContext } from "../../context/AutoBeContext";
-import { transformAnalyzeScenarioReviewHistory } from "./histories/transformAnalyzeScenarioReviewHistory";
-import {
-  IAutoBeAnalyzeScenarioReviewApplication,
-  IAutoBeAnalyzeScenarioReviewApplicationComplete,
-  IAutoBeAnalyzeScenarioReviewApplicationProps,
-} from "./structures/IAutoBeAnalyzeScenarioReviewApplication";
-import { isRecord, tryParseStringAsRecord } from "./utils/repairUtils";
-
-/**
- * Orchestrate scenario review: validate scenario output against user's original
- * requirements.
- *
- * Checks entity coverage, hallucination, actor classification, relationship
- * completeness, and feature identification accuracy in a single LLM call.
- */
-export const orchestrateAnalyzeScenarioReview = async (
-  ctx: AutoBeContext,
-  props: {
-    scenario: AutoBeAnalyzeScenarioEvent;
-    retry: number;
-  },
-): Promise<AutoBeAnalyzeScenarioReviewEvent> => {
-  const start: Date = new Date();
-  const pointer: IPointer<IAutoBeAnalyzeScenarioReviewApplicationComplete | null> =
-    {
-      value: null,
-    };
-  const result: AutoBeContext.IResult = await ctx.conversate({
-    source: SOURCE,
-    controller: createController({ pointer }),
-    enforceFunctionCall: true,
-    ...transformAnalyzeScenarioReviewHistory(ctx, {
-      scenario: props.scenario,
-    }),
-  });
-
-  if (pointer.value === null) {
-    // Fallback: treat as approved if LLM failed to produce a verdict
-    const fallback: AutoBeAnalyzeScenarioReviewEvent = {
-      type: SOURCE,
-      id: v7(),
-      approved: true,
-      feedback:
-        "Review could not be completed; proceeding with current scenario.",
-      issues: [],
-      tokenUsage: result.tokenUsage,
-      metric: result.metric,
-      step: (ctx.state().analyze?.step ?? -1) + 1,
-      retry: props.retry,
-      created_at: start.toISOString(),
-    };
-    ctx.dispatch(fallback);
-    return fallback;
-  }
-
-  const event: AutoBeAnalyzeScenarioReviewEvent = {
-    type: SOURCE,
-    id: v7(),
-    approved: pointer.value.approved,
-    feedback: pointer.value.feedback,
-    issues: pointer.value.issues.map((issue) => ({
-      category: issue.category as AutoBeAnalyzeScenarioReviewIssue["category"],
-      description: issue.description,
-      suggestion: issue.suggestion,
-    })),
-    tokenUsage: result.tokenUsage,
-    metric: result.metric,
-    step: (ctx.state().analyze?.step ?? -1) + 1,
-    retry: props.retry,
-    created_at: start.toISOString(),
-  };
-  ctx.dispatch(event);
-  return event;
-};
-
-function createController(props: {
-  pointer: IPointer<IAutoBeAnalyzeScenarioReviewApplicationComplete | null>;
-}): IAgenticaController.IClass {
-  const application: ILlmApplication =
-    typia.llm.application<IAutoBeAnalyzeScenarioReviewApplication>({
-      validate: {
-        process: (
-          input: unknown,
-        ): IValidation<IAutoBeAnalyzeScenarioReviewApplicationProps> => {
-          if (isRecord(input) && typeof input.request === "string") {
-            input = {
-              ...input,
-              request: tryParseStringAsRecord(input.request),
-            };
-          }
-          return typia.validate<IAutoBeAnalyzeScenarioReviewApplicationProps>(
-            input,
-          );
-        },
-      },
-    });
-  return {
-    protocol: "class",
-    name: SOURCE,
-    application,
-    execute: {
-      process: (input) => {
-        if (input.request.type === "complete")
-          props.pointer.value = input.request;
-      },
-    } satisfies IAutoBeAnalyzeScenarioReviewApplication,
-  };
-}
-
-const SOURCE = "analyzeScenarioReview" satisfies AutoBeEventSource;
+import { IAgenticaController } from "@agentica/core";
+import {
+  AutoBeAnalyzeScenarioEvent,
+  AutoBeAnalyzeScenarioReviewEvent,
+  AutoBeAnalyzeScenarioReviewIssue,
+  AutoBeEventSource,
+} from "@autobe/interface";
+import { IPointer } from "tstl";
+import typia, { ILlmApplication, IValidation } from "typia";
+import { v7 } from "uuid";
+
+import { AutoBeContext } from "../../context/AutoBeContext";
+import { transformAnalyzeScenarioReviewHistory } from "./histories/transformAnalyzeScenarioReviewHistory";
+import {
+  IAutoBeAnalyzeScenarioReviewApplication,
+  IAutoBeAnalyzeScenarioReviewApplicationComplete,
+  IAutoBeAnalyzeScenarioReviewApplicationProps,
+} from "./structures/IAutoBeAnalyzeScenarioReviewApplication";
+import { isRecord, tryParseStringAsRecord } from "./utils/repairUtils";
+
+/**
+ * Orchestrate scenario review: validate scenario output against user's original
+ * requirements.
+ *
+ * Checks entity coverage, hallucination, actor classification, relationship
+ * completeness, and feature identification accuracy in a single LLM call.
+ */
+export const orchestrateAnalyzeScenarioReview = async (
+  ctx: AutoBeContext,
+  props: {
+    scenario: AutoBeAnalyzeScenarioEvent;
+    retry: number;
+  },
+): Promise<AutoBeAnalyzeScenarioReviewEvent> => {
+  const start: Date = new Date();
+  const pointer: IPointer<IAutoBeAnalyzeScenarioReviewApplicationComplete | null> =
+    {
+      value: null,
+    };
+  const result: AutoBeContext.IResult = await ctx.conversate({
+    source: SOURCE,
+    controller: createController({ pointer }),
+    enforceFunctionCall: true,
+    ...transformAnalyzeScenarioReviewHistory(ctx, {
+      scenario: props.scenario,
+    }),
+  });
+
+  if (pointer.value === null) {
+    // Fallback: treat as approved if LLM failed to produce a verdict
+    const fallback: AutoBeAnalyzeScenarioReviewEvent = {
+      type: SOURCE,
+      id: v7(),
+      approved: true,
+      feedback:
+        "Review could not be completed; proceeding with current scenario.",
+      issues: [],
+      tokenUsage: result.tokenUsage,
+      metric: result.metric,
+      step: (ctx.state().analyze?.step ?? -1) + 1,
+      retry: props.retry,
+      created_at: start.toISOString(),
+    };
+    ctx.dispatch(fallback);
+    return fallback;
+  }
+
+  const event: AutoBeAnalyzeScenarioReviewEvent = {
+    type: SOURCE,
+    id: v7(),
+    approved: pointer.value.approved,
+    feedback: pointer.value.feedback,
+    issues: pointer.value.issues.map((issue) => ({
+      category: issue.category as AutoBeAnalyzeScenarioReviewIssue["category"],
+      description: issue.description,
+      suggestion: issue.suggestion,
+    })),
+    tokenUsage: result.tokenUsage,
+    metric: result.metric,
+    step: (ctx.state().analyze?.step ?? -1) + 1,
+    retry: props.retry,
+    created_at: start.toISOString(),
+  };
+  ctx.dispatch(event);
+  return event;
+};
+
+function createController(props: {
+  pointer: IPointer<IAutoBeAnalyzeScenarioReviewApplicationComplete | null>;
+}): IAgenticaController.IClass {
+  const application: ILlmApplication =
+    typia.llm.application<IAutoBeAnalyzeScenarioReviewApplication>({
+      validate: {
+        process: (
+          input: unknown,
+        ): IValidation<IAutoBeAnalyzeScenarioReviewApplicationProps> => {
+          if (isRecord(input) && typeof input.request === "string") {
+            input = {
+              ...input,
+              request: tryParseStringAsRecord(input.request),
+            };
+          }
+          return typia.validate<IAutoBeAnalyzeScenarioReviewApplicationProps>(
+            input,
+          );
+        },
+      },
+    });
+  return {
+    protocol: "class",
+    name: SOURCE,
+    application,
+    execute: {
+      process: (input) => {
+        if (input.request.type === "complete")
+          props.pointer.value = input.request;
+      },
+    } satisfies IAutoBeAnalyzeScenarioReviewApplication,
+  };
+}
+
+const SOURCE = "analyzeScenarioReview" satisfies AutoBeEventSource;

package/src/orchestrate/analyze/orchestrateAnalyzeSectionCrossFileReview.ts

@@ -1,146 +1,146 @@
-import { IAgenticaController } from "@agentica/core";
-import {
-  AutoBeAnalyze,
-  AutoBeAnalyzeScenarioEvent,
-  AutoBeAnalyzeSectionReviewEvent,
-  AutoBeAnalyzeWriteModuleEvent,
-  AutoBeAnalyzeWriteSectionEvent,
-  AutoBeAnalyzeWriteUnitEvent,
-  AutoBeEventSource,
-  AutoBeProgressEventBase,
-} from "@autobe/interface";
-import { IPointer } from "tstl";
-import typia, { ILlmApplication, IValidation } from "typia";
-import { v7 } from "uuid";
-
-import { AutoBeContext } from "../../context/AutoBeContext";
-import { AutoBePreliminaryController } from "../common/AutoBePreliminaryController";
-import { transformAnalyzeSectionCrossFileReviewHistory } from "./histories/transformAnalyzeSectionCrossFileReviewHistory";
-import {
-  IAutoBeAnalyzeSectionCrossFileReviewApplication,
-  IAutoBeAnalyzeSectionCrossFileReviewApplicationComplete,
-  IAutoBeAnalyzeSectionCrossFileReviewApplicationProps,
-} from "./structures/IAutoBeAnalyzeSectionCrossFileReviewApplication";
-import { repairSectionReviewInput } from "./utils/repairSectionReviewUtils";
-
-/**
- * Orchestrate cross-file lightweight review of section metadata across ALL
- * files.
- *
- * This function reviews all files' section metadata (titles, keywords,
- * purposes) together in a single LLM call, providing cross-file validation for
- * terminology alignment, value consistency, naming conventions, and content
- * deduplication.
- *
- * Unlike the per-file review which checks full content, this review only
- * receives lightweight metadata to stay within context limits.
- */
-export const orchestrateAnalyzeSectionCrossFileReview = async (
-  ctx: AutoBeContext,
-  props: {
-    scenario: AutoBeAnalyzeScenarioEvent;
-    allFileSummaries: Array<{
-      file: AutoBeAnalyze.IFileScenario;
-      moduleEvent: AutoBeAnalyzeWriteModuleEvent;
-      unitEvents: AutoBeAnalyzeWriteUnitEvent[];
-      sectionEvents: AutoBeAnalyzeWriteSectionEvent[][];
-      status: "approved" | "rewritten" | "new";
-    }>;
-    mechanicalViolationSummary?: string;
-    progress: AutoBeProgressEventBase;
-    promptCacheKey: string;
-    retry: number;
-  },
-): Promise<AutoBeAnalyzeSectionReviewEvent> => {
-  const preliminary: AutoBePreliminaryController<"previousAnalysisSections"> =
-    new AutoBePreliminaryController({
-      application:
-        typia.json.application<IAutoBeAnalyzeSectionCrossFileReviewApplication>(),
-      source: SOURCE,
-      kinds: ["previousAnalysisSections"],
-      state: ctx.state(),
-    });
-  return await preliminary.orchestrate(ctx, async (out) => {
-    const pointer: IPointer<IAutoBeAnalyzeSectionCrossFileReviewApplicationComplete | null> =
-      {
-        value: null,
-      };
-    const result: AutoBeContext.IResult = await ctx.conversate({
-      source: SOURCE,
-      controller: createController({
-        pointer,
-        preliminary,
-      }),
-      enforceFunctionCall: true,
-      promptCacheKey: props.promptCacheKey,
-      ...transformAnalyzeSectionCrossFileReviewHistory(ctx, {
-        scenario: props.scenario,
-        allFileSummaries: props.allFileSummaries,
-        mechanicalViolationSummary: props.mechanicalViolationSummary,
-        preliminary,
-      }),
-    });
-    if (pointer.value === null) return out(result)(null);
-
-    const event: AutoBeAnalyzeSectionReviewEvent = {
-      type: SOURCE,
-      id: v7(),
-      fileResults: pointer.value.fileResults.map((fr) => ({
-        ...fr,
-        revisedSections: null,
-        rejectedModuleUnits: fr.rejectedModuleUnits ?? null,
-      })),
-      acquisition: preliminary.getAcquisition(),
-      tokenUsage: result.tokenUsage,
-      metric: result.metric,
-      step: (ctx.state().analyze?.step ?? -1) + 1,
-      total: props.progress.total,
-      completed: ++props.progress.completed,
-      retry: props.retry,
-      created_at: new Date().toISOString(),
-    };
-    ctx.dispatch(event);
-    return out(result)(event);
-  });
-};
-
-function createController(props: {
-  pointer: IPointer<IAutoBeAnalyzeSectionCrossFileReviewApplicationComplete | null>;
-  preliminary: AutoBePreliminaryController<"previousAnalysisSections">;
-}): IAgenticaController.IClass {
-  const validate = (
-    input: unknown,
-  ): IValidation<IAutoBeAnalyzeSectionCrossFileReviewApplicationProps> => {
-    input = repairSectionReviewInput(input);
-    const result: IValidation<IAutoBeAnalyzeSectionCrossFileReviewApplicationProps> =
-      typia.validate<IAutoBeAnalyzeSectionCrossFileReviewApplicationProps>(
-        input,
-      );
-    if (result.success === false || result.data.request.type === "complete")
-      return result;
-    return props.preliminary.validate({
-      thinking: result.data.thinking ?? "",
-      request: result.data.request,
-    });
-  };
-  const application: ILlmApplication = props.preliminary.fixApplication(
-    typia.llm.application<IAutoBeAnalyzeSectionCrossFileReviewApplication>({
-      validate: {
-        process: validate,
-      },
-    }),
-  );
-  return {
-    protocol: "class",
-    name: SOURCE,
-    application,
-    execute: {
-      process: (input) => {
-        if (input.request.type === "complete")
-          props.pointer.value = input.request;
-      },
-    } satisfies IAutoBeAnalyzeSectionCrossFileReviewApplication,
-  };
-}
-
-const SOURCE = "analyzeSectionReview" satisfies AutoBeEventSource;
+import { IAgenticaController } from "@agentica/core";
+import {
+  AutoBeAnalyze,
+  AutoBeAnalyzeScenarioEvent,
+  AutoBeAnalyzeSectionReviewEvent,
+  AutoBeAnalyzeWriteModuleEvent,
+  AutoBeAnalyzeWriteSectionEvent,
+  AutoBeAnalyzeWriteUnitEvent,
+  AutoBeEventSource,
+  AutoBeProgressEventBase,
+} from "@autobe/interface";
+import { IPointer } from "tstl";
+import typia, { ILlmApplication, IValidation } from "typia";
+import { v7 } from "uuid";
+
+import { AutoBeContext } from "../../context/AutoBeContext";
+import { AutoBePreliminaryController } from "../common/AutoBePreliminaryController";
+import { transformAnalyzeSectionCrossFileReviewHistory } from "./histories/transformAnalyzeSectionCrossFileReviewHistory";
+import {
+  IAutoBeAnalyzeSectionCrossFileReviewApplication,
+  IAutoBeAnalyzeSectionCrossFileReviewApplicationComplete,
+  IAutoBeAnalyzeSectionCrossFileReviewApplicationProps,
+} from "./structures/IAutoBeAnalyzeSectionCrossFileReviewApplication";
+import { repairSectionReviewInput } from "./utils/repairSectionReviewUtils";
+
+/**
+ * Orchestrate cross-file lightweight review of section metadata across ALL
+ * files.
+ *
+ * This function reviews all files' section metadata (titles, keywords,
+ * purposes) together in a single LLM call, providing cross-file validation for
+ * terminology alignment, value consistency, naming conventions, and content
+ * deduplication.
+ *
+ * Unlike the per-file review which checks full content, this review only
+ * receives lightweight metadata to stay within context limits.
+ */
+export const orchestrateAnalyzeSectionCrossFileReview = async (
+  ctx: AutoBeContext,
+  props: {
+    scenario: AutoBeAnalyzeScenarioEvent;
+    allFileSummaries: Array<{
+      file: AutoBeAnalyze.IFileScenario;
+      moduleEvent: AutoBeAnalyzeWriteModuleEvent;
+      unitEvents: AutoBeAnalyzeWriteUnitEvent[];
+      sectionEvents: AutoBeAnalyzeWriteSectionEvent[][];
+      status: "approved" | "rewritten" | "new";
+    }>;
+    mechanicalViolationSummary?: string;
+    progress: AutoBeProgressEventBase;
+    promptCacheKey: string;
+    retry: number;
+  },
+): Promise<AutoBeAnalyzeSectionReviewEvent> => {
+  const preliminary: AutoBePreliminaryController<"previousAnalysisSections"> =
+    new AutoBePreliminaryController({
+      application:
+        typia.json.application<IAutoBeAnalyzeSectionCrossFileReviewApplication>(),
+      source: SOURCE,
+      kinds: ["previousAnalysisSections"],
+      state: ctx.state(),
+    });
+  return await preliminary.orchestrate(ctx, async (out) => {
+    const pointer: IPointer<IAutoBeAnalyzeSectionCrossFileReviewApplicationComplete | null> =
+      {
+        value: null,
+      };
+    const result: AutoBeContext.IResult = await ctx.conversate({
+      source: SOURCE,
+      controller: createController({
+        pointer,
+        preliminary,
+      }),
+      enforceFunctionCall: true,
+      promptCacheKey: props.promptCacheKey,
+      ...transformAnalyzeSectionCrossFileReviewHistory(ctx, {
+        scenario: props.scenario,
+        allFileSummaries: props.allFileSummaries,
+        mechanicalViolationSummary: props.mechanicalViolationSummary,
+        preliminary,
+      }),
+    });
+    if (pointer.value === null) return out(result)(null);
+
+    const event: AutoBeAnalyzeSectionReviewEvent = {
+      type: SOURCE,
+      id: v7(),
+      fileResults: pointer.value.fileResults.map((fr) => ({
+        ...fr,
+        revisedSections: null,
+        rejectedModuleUnits: fr.rejectedModuleUnits ?? null,
+      })),
+      acquisition: preliminary.getAcquisition(),
+      tokenUsage: result.tokenUsage,
+      metric: result.metric,
+      step: (ctx.state().analyze?.step ?? -1) + 1,
+      total: props.progress.total,
+      completed: ++props.progress.completed,
+      retry: props.retry,
+      created_at: new Date().toISOString(),
+    };
+    ctx.dispatch(event);
+    return out(result)(event);
+  });
+};
+
+function createController(props: {
+  pointer: IPointer<IAutoBeAnalyzeSectionCrossFileReviewApplicationComplete | null>;
+  preliminary: AutoBePreliminaryController<"previousAnalysisSections">;
+}): IAgenticaController.IClass {
+  const validate = (
+    input: unknown,
+  ): IValidation<IAutoBeAnalyzeSectionCrossFileReviewApplicationProps> => {
+    input = repairSectionReviewInput(input);
+    const result: IValidation<IAutoBeAnalyzeSectionCrossFileReviewApplicationProps> =
+      typia.validate<IAutoBeAnalyzeSectionCrossFileReviewApplicationProps>(
+        input,
+      );
+    if (result.success === false || result.data.request.type === "complete")
+      return result;
+    return props.preliminary.validate({
+      thinking: result.data.thinking ?? "",
+      request: result.data.request,
+    });
+  };
+  const application: ILlmApplication = props.preliminary.fixApplication(
+    typia.llm.application<IAutoBeAnalyzeSectionCrossFileReviewApplication>({
+      validate: {
+        process: validate,
+      },
+    }),
+  );
+  return {
+    protocol: "class",
+    name: SOURCE,
+    application,
+    execute: {
+      process: (input) => {
+        if (input.request.type === "complete")
+          props.pointer.value = input.request;
+      },
+    } satisfies IAutoBeAnalyzeSectionCrossFileReviewApplication,
+  };
+}
+
+const SOURCE = "analyzeSectionReview" satisfies AutoBeEventSource;