@autobe/agent 0.30.0-dev.20260315 → 0.30.1

package/src/orchestrate/interface/structures/IAutoBeInterfaceSchemaApplication.ts

@@ -1,121 +1,121 @@
-import { AutoBeInterfaceSchemaDesign } from "@autobe/interface";
-
-import { IAutoBePreliminaryGetAnalysisSections } from "../../common/structures/IAutoBePreliminaryGetAnalysisSections";
-import { IAutoBePreliminaryGetDatabaseSchemas } from "../../common/structures/IAutoBePreliminaryGetDatabaseSchemas";
-import { IAutoBePreliminaryGetInterfaceOperations } from "../../common/structures/IAutoBePreliminaryGetInterfaceOperations";
-import { IAutoBePreliminaryGetPreviousAnalysisSections } from "../../common/structures/IAutoBePreliminaryGetPreviousAnalysisSections";
-import { IAutoBePreliminaryGetPreviousDatabaseSchemas } from "../../common/structures/IAutoBePreliminaryGetPreviousDatabaseSchemas";
-import { IAutoBePreliminaryGetPreviousInterfaceOperations } from "../../common/structures/IAutoBePreliminaryGetPreviousInterfaceOperations";
-import { IAutoBePreliminaryGetPreviousInterfaceSchemas } from "../../common/structures/IAutoBePreliminaryGetPreviousInterfaceSchemas";
-
-export interface IAutoBeInterfaceSchemaApplication {
-  /**
-   * Process schema generation task or preliminary data requests.
-   *
-   * Generates OpenAPI components containing named schema types and integrates
-   * them into the final OpenAPI specification. Processes all entity schemas,
-   * their variants, and related type definitions to ensure comprehensive and
-   * consistent API design.
-   *
-   * @param props Request containing either preliminary data request or complete
-   *   task
-   */
-  process(props: IAutoBeInterfaceSchemaApplication.IProps): void;
-}
-
-export namespace IAutoBeInterfaceSchemaApplication {
-  export interface IProps {
-    /**
-     * Think before you act.
-     *
-     * Before requesting preliminary data or completing your task, reflect on
-     * your current state and explain your reasoning:
-     *
-     * For preliminary requests (getAnalysisSections, getDatabaseSchemas, etc.):
-     *
-     * - What critical information is missing that you don't already have?
-     * - Why do you need it specifically right now?
-     * - Be brief - state the gap, don't list everything you have.
-     *
-     * For completion (complete):
-     *
-     * - What key assets did you acquire?
-     * - What did you accomplish?
-     * - Why is it sufficient to complete?
-     * - Summarize - don't enumerate every single item.
-     *
-     * This reflection helps you avoid duplicate requests and premature
-     * completion.
-     */
-    thinking: string;
-
-    /**
-     * Type discriminator for the request.
-     *
-     * Determines which action to perform: preliminary data retrieval
-     * (getAnalysisSections, getDatabaseSchemas, getInterfaceOperations) or
-     * final schema generation (complete). When preliminary returns empty array,
-     * that type is removed from the union, physically preventing repeated
-     * calls.
-     */
-    request:
-      | IComplete
-      | IAutoBePreliminaryGetAnalysisSections
-      | IAutoBePreliminaryGetDatabaseSchemas
-      | IAutoBePreliminaryGetInterfaceOperations
-      | IAutoBePreliminaryGetPreviousAnalysisSections
-      | IAutoBePreliminaryGetPreviousDatabaseSchemas
-      | IAutoBePreliminaryGetPreviousInterfaceOperations
-      | IAutoBePreliminaryGetPreviousInterfaceSchemas;
-  }
-
-  /**
-   * Request to generate a single OpenAPI schema component.
-   *
-   * Executes schema generation to create a type definition for a specific DTO
-   * type. Each invocation handles one schema component to ensure accuracy and
-   * clear responsibility.
-   */
-  export interface IComplete {
-    /**
-     * Type discriminator for the request.
-     *
-     * Determines which action to perform: preliminary data retrieval or actual
-     * task execution. Value "complete" indicates this is the final task
-     * execution request.
-     */
-    type: "complete";
-
-    /**
-     * Analysis of the type's purpose and context.
-     *
-     * Before designing the schema, analyze what you know:
-     *
-     * - What is this type for? (e.g., IProduct.ICreate is a creation request)
-     * - What database entities or operations inform its structure?
-     * - What fields should be included based on the variant type?
-     * - Are there related types that provide structural hints?
-     */
-    analysis: string;
-
-    /**
-     * Rationale for the schema design decisions.
-     *
-     * Explain why you designed the schema this way:
-     *
-     * - Which properties did you include and why?
-     * - What is required vs optional, and why?
-     * - Which types use $ref and why?
-     * - What was excluded and why? (e.g., auto-generated fields for ICreate)
-     */
-    rationale: string;
-
-    /**
-     * Design structure for the schema being generated.
-     *
-     * Contains `databaseSchema`, `specification`, `description`, and `schema`
-     * fields that together define a complete DTO type component.
-     */
-    design: AutoBeInterfaceSchemaDesign;
-  }
-}
+import { AutoBeInterfaceSchemaDesign } from "@autobe/interface";
+
+import { IAutoBePreliminaryGetAnalysisSections } from "../../common/structures/IAutoBePreliminaryGetAnalysisSections";
+import { IAutoBePreliminaryGetDatabaseSchemas } from "../../common/structures/IAutoBePreliminaryGetDatabaseSchemas";
+import { IAutoBePreliminaryGetInterfaceOperations } from "../../common/structures/IAutoBePreliminaryGetInterfaceOperations";
+import { IAutoBePreliminaryGetPreviousAnalysisSections } from "../../common/structures/IAutoBePreliminaryGetPreviousAnalysisSections";
+import { IAutoBePreliminaryGetPreviousDatabaseSchemas } from "../../common/structures/IAutoBePreliminaryGetPreviousDatabaseSchemas";
+import { IAutoBePreliminaryGetPreviousInterfaceOperations } from "../../common/structures/IAutoBePreliminaryGetPreviousInterfaceOperations";
+import { IAutoBePreliminaryGetPreviousInterfaceSchemas } from "../../common/structures/IAutoBePreliminaryGetPreviousInterfaceSchemas";
+
+export interface IAutoBeInterfaceSchemaApplication {
+  /**
+   * Process schema generation task or preliminary data requests.
+   *
+   * Generates OpenAPI components containing named schema types and integrates
+   * them into the final OpenAPI specification. Processes all entity schemas,
+   * their variants, and related type definitions to ensure comprehensive and
+   * consistent API design.
+   *
+   * @param props Request containing either preliminary data request or complete
+   *   task
+   */
+  process(props: IAutoBeInterfaceSchemaApplication.IProps): void;
+}
+
+export namespace IAutoBeInterfaceSchemaApplication {
+  export interface IProps {
+    /**
+     * Think before you act.
+     *
+     * Before requesting preliminary data or completing your task, reflect on
+     * your current state and explain your reasoning:
+     *
+     * For preliminary requests (getAnalysisSections, getDatabaseSchemas, etc.):
+     *
+     * - What critical information is missing that you don't already have?
+     * - Why do you need it specifically right now?
+     * - Be brief - state the gap, don't list everything you have.
+     *
+     * For completion (complete):
+     *
+     * - What key assets did you acquire?
+     * - What did you accomplish?
+     * - Why is it sufficient to complete?
+     * - Summarize - don't enumerate every single item.
+     *
+     * This reflection helps you avoid duplicate requests and premature
+     * completion.
+     */
+    thinking: string;
+
+    /**
+     * Type discriminator for the request.
+     *
+     * Determines which action to perform: preliminary data retrieval
+     * (getAnalysisSections, getDatabaseSchemas, getInterfaceOperations) or
+     * final schema generation (complete). When preliminary returns empty array,
+     * that type is removed from the union, physically preventing repeated
+     * calls.
+     */
+    request:
+      | IComplete
+      | IAutoBePreliminaryGetAnalysisSections
+      | IAutoBePreliminaryGetDatabaseSchemas
+      | IAutoBePreliminaryGetInterfaceOperations
+      | IAutoBePreliminaryGetPreviousAnalysisSections
+      | IAutoBePreliminaryGetPreviousDatabaseSchemas
+      | IAutoBePreliminaryGetPreviousInterfaceOperations
+      | IAutoBePreliminaryGetPreviousInterfaceSchemas;
+  }
+
+  /**
+   * Request to generate a single OpenAPI schema component.
+   *
+   * Executes schema generation to create a type definition for a specific DTO
+   * type. Each invocation handles one schema component to ensure accuracy and
+   * clear responsibility.
+   */
+  export interface IComplete {
+    /**
+     * Type discriminator for the request.
+     *
+     * Determines which action to perform: preliminary data retrieval or actual
+     * task execution. Value "complete" indicates this is the final task
+     * execution request.
+     */
+    type: "complete";
+
+    /**
+     * Analysis of the type's purpose and context.
+     *
+     * Before designing the schema, analyze what you know:
+     *
+     * - What is this type for? (e.g., IProduct.ICreate is a creation request)
+     * - What database entities or operations inform its structure?
+     * - What fields should be included based on the variant type?
+     * - Are there related types that provide structural hints?
+     */
+    analysis: string;
+
+    /**
+     * Rationale for the schema design decisions.
+     *
+     * Explain why you designed the schema this way:
+     *
+     * - Which properties did you include and why?
+     * - What is required vs optional, and why?
+     * - Which types use $ref and why?
+     * - What was excluded and why? (e.g., auto-generated fields for ICreate)
+     */
+    rationale: string;
+
+    /**
+     * Design structure for the schema being generated.
+     *
+     * Contains `databaseSchema`, `specification`, `description`, and `schema`
+     * fields that together define a complete DTO type component.
+     */
+    design: AutoBeInterfaceSchemaDesign;
+  }
+}

package/src/orchestrate/interface/structures/IAutoBeInterfaceSchemaCastingApplication.ts

@@ -1,153 +1,153 @@
-import { AutoBeInterfaceSchemaCasting } from "@autobe/interface";
-
-import { IAutoBePreliminaryGetAnalysisSections } from "../../common/structures/IAutoBePreliminaryGetAnalysisSections";
-import { IAutoBePreliminaryGetDatabaseSchemas } from "../../common/structures/IAutoBePreliminaryGetDatabaseSchemas";
-import { IAutoBePreliminaryGetInterfaceOperations } from "../../common/structures/IAutoBePreliminaryGetInterfaceOperations";
-import { IAutoBePreliminaryGetInterfaceSchemas } from "../../common/structures/IAutoBePreliminaryGetInterfaceSchemas";
-import { IAutoBePreliminaryGetPreviousAnalysisSections } from "../../common/structures/IAutoBePreliminaryGetPreviousAnalysisSections";
-import { IAutoBePreliminaryGetPreviousDatabaseSchemas } from "../../common/structures/IAutoBePreliminaryGetPreviousDatabaseSchemas";
-import { IAutoBePreliminaryGetPreviousInterfaceOperations } from "../../common/structures/IAutoBePreliminaryGetPreviousInterfaceOperations";
-import { IAutoBePreliminaryGetPreviousInterfaceSchemas } from "../../common/structures/IAutoBePreliminaryGetPreviousInterfaceSchemas";
-
-/**
- * Application interface for the Schema Refine agent.
- *
- * The Schema Refine agent detects and corrects degenerate type aliases where
- * complex data structures have been incorrectly simplified to primitive types
- * (`string`, `number`, `boolean`, `integer`).
- *
- * This agent analyzes JSDoc descriptions, database schema hints, and naming
- * conventions to identify mismatches between documented semantics and actual
- * type definitions, then provides corrected object schema definitions.
- */
-export interface IAutoBeInterfaceSchemaCastingApplication {
-  /**
-   * Process schema refinement task or preliminary data requests.
-   *
-   * Analyzes a potentially degenerate primitive type alias and determines
-   * whether it should be refined into a proper object schema structure. Uses
-   * Chain-of-Thought reasoning to systematically evaluate the type.
-   *
-   * @param props Request containing either preliminary data request or
-   *   refinement completion
-   */
-  process(props: IAutoBeInterfaceSchemaCastingApplication.IProps): void;
-}
-
-export namespace IAutoBeInterfaceSchemaCastingApplication {
-  /** Properties for schema refinement processing. */
-  export interface IProps {
-    /**
-     * Think before you act.
-     *
-     * Before requesting preliminary data or completing your task, reflect on
-     * your current state and explain your reasoning:
-     *
-     * For preliminary requests (getAnalysisSections, getDatabaseSchemas, etc.):
-     *
-     * - What critical information is missing that you don't already have?
-     * - Why do you need it specifically right now?
-     * - Be brief - state the gap, don't list everything you have.
-     *
-     * For completion (complete):
-     *
-     * - What key assets did you acquire?
-     * - What did you accomplish?
-     * - Why is it sufficient to complete?
-     * - Summarize - don't enumerate every single item.
-     *
-     * This reflection helps you avoid duplicate requests and premature
-     * completion.
-     */
-    thinking: string;
-
-    /**
-     * Type discriminator for the request.
-     *
-     * Determines which action to perform: preliminary data retrieval
-     * (getAnalysisSections, getDatabaseSchemas, getInterfaceOperations,
-     * getInterfaceSchemas, etc.) or final refinement decision (complete). When
-     * preliminary returns empty array, that type is removed from the union,
-     * physically preventing repeated calls.
-     */
-    request:
-      | IComplete
-      | IAutoBePreliminaryGetAnalysisSections
-      | IAutoBePreliminaryGetDatabaseSchemas
-      | IAutoBePreliminaryGetInterfaceOperations
-      | IAutoBePreliminaryGetInterfaceSchemas
-      | IAutoBePreliminaryGetPreviousAnalysisSections
-      | IAutoBePreliminaryGetPreviousDatabaseSchemas
-      | IAutoBePreliminaryGetPreviousInterfaceOperations
-      | IAutoBePreliminaryGetPreviousInterfaceSchemas;
-  }
-
-  /**
-   * Request to complete schema refinement analysis.
-   *
-   * Executes the final refinement decision after analyzing a potentially
-   * degenerate primitive type. Uses structured Chain-of-Thought reasoning
-   * through observation, reasoning, and verdict properties to ensure systematic
-   * evaluation before making a decision.
-   */
-  export interface IComplete {
-    /**
-     * Type discriminator for the request.
-     *
-     * Determines which action to perform: preliminary data retrieval or actual
-     * task execution. Value "complete" indicates this is the final refinement
-     * decision request.
-     */
-    type: "complete";
-
-    /**
-     * Observation of the current type and its documentation.
-     *
-     * Describe what you observe about the type being analyzed:
-     *
-     * - What is the current type definition? (e.g., `type IFoo = number`)
-     * - What does the JSDoc/description say about the type?
-     * - Are there any database schema hints (JSON field, etc.)?
-     * - What does the naming suggest? (e.g., "Distribution", "Preferences")
-     *
-     * This is purely descriptive - state facts without judgment.
-     */
-    observation: string;
-
-    /**
-     * Reasoning about whether the type is degenerate.
-     *
-     * Analyze the observations and explain your reasoning:
-     *
-     * - Does the documentation describe a structure that contradicts the
-     *   primitive type?
-     * - Are there keywords suggesting complex structure? (key/value, array, list,
-     *   contains, mapping)
-     * - Is this a legitimate semantic alias? (e.g., `IUserId = string`)
-     * - What type SHOULD this be based on the evidence?
-     */
-    reasoning: string;
-
-    /**
-     * Final verdict on whether to refine the type.
-     *
-     * State your conclusion clearly:
-     *
-     * - Is this a degenerate type that needs refinement, or a valid primitive?
-     * - Summarize the key evidence that led to this decision.
-     * - If refining, briefly describe what the correct type should be.
-     */
-    verdict: string;
-
-    /**
-     * Casting design for the corrected object schema, or `null` if intentional.
-     *
-     * When the type is degenerate: provide the casting design with corrected
-     * object schema containing `databaseSchema`, `specification`,
-     * `description`, and `schema` fields.
-     *
-     * When the type is intentional (valid primitive alias): set to `null`.
-     */
-    casting: AutoBeInterfaceSchemaCasting | null;
-  }
-}
+import { AutoBeInterfaceSchemaCasting } from "@autobe/interface";
+
+import { IAutoBePreliminaryGetAnalysisSections } from "../../common/structures/IAutoBePreliminaryGetAnalysisSections";
+import { IAutoBePreliminaryGetDatabaseSchemas } from "../../common/structures/IAutoBePreliminaryGetDatabaseSchemas";
+import { IAutoBePreliminaryGetInterfaceOperations } from "../../common/structures/IAutoBePreliminaryGetInterfaceOperations";
+import { IAutoBePreliminaryGetInterfaceSchemas } from "../../common/structures/IAutoBePreliminaryGetInterfaceSchemas";
+import { IAutoBePreliminaryGetPreviousAnalysisSections } from "../../common/structures/IAutoBePreliminaryGetPreviousAnalysisSections";
+import { IAutoBePreliminaryGetPreviousDatabaseSchemas } from "../../common/structures/IAutoBePreliminaryGetPreviousDatabaseSchemas";
+import { IAutoBePreliminaryGetPreviousInterfaceOperations } from "../../common/structures/IAutoBePreliminaryGetPreviousInterfaceOperations";
+import { IAutoBePreliminaryGetPreviousInterfaceSchemas } from "../../common/structures/IAutoBePreliminaryGetPreviousInterfaceSchemas";
+
+/**
+ * Application interface for the Schema Refine agent.
+ *
+ * The Schema Refine agent detects and corrects degenerate type aliases where
+ * complex data structures have been incorrectly simplified to primitive types
+ * (`string`, `number`, `boolean`, `integer`).
+ *
+ * This agent analyzes JSDoc descriptions, database schema hints, and naming
+ * conventions to identify mismatches between documented semantics and actual
+ * type definitions, then provides corrected object schema definitions.
+ */
+export interface IAutoBeInterfaceSchemaCastingApplication {
+  /**
+   * Process schema refinement task or preliminary data requests.
+   *
+   * Analyzes a potentially degenerate primitive type alias and determines
+   * whether it should be refined into a proper object schema structure. Uses
+   * Chain-of-Thought reasoning to systematically evaluate the type.
+   *
+   * @param props Request containing either preliminary data request or
+   *   refinement completion
+   */
+  process(props: IAutoBeInterfaceSchemaCastingApplication.IProps): void;
+}
+
+export namespace IAutoBeInterfaceSchemaCastingApplication {
+  /** Properties for schema refinement processing. */
+  export interface IProps {
+    /**
+     * Think before you act.
+     *
+     * Before requesting preliminary data or completing your task, reflect on
+     * your current state and explain your reasoning:
+     *
+     * For preliminary requests (getAnalysisSections, getDatabaseSchemas, etc.):
+     *
+     * - What critical information is missing that you don't already have?
+     * - Why do you need it specifically right now?
+     * - Be brief - state the gap, don't list everything you have.
+     *
+     * For completion (complete):
+     *
+     * - What key assets did you acquire?
+     * - What did you accomplish?
+     * - Why is it sufficient to complete?
+     * - Summarize - don't enumerate every single item.
+     *
+     * This reflection helps you avoid duplicate requests and premature
+     * completion.
+     */
+    thinking: string;
+
+    /**
+     * Type discriminator for the request.
+     *
+     * Determines which action to perform: preliminary data retrieval
+     * (getAnalysisSections, getDatabaseSchemas, getInterfaceOperations,
+     * getInterfaceSchemas, etc.) or final refinement decision (complete). When
+     * preliminary returns empty array, that type is removed from the union,
+     * physically preventing repeated calls.
+     */
+    request:
+      | IComplete
+      | IAutoBePreliminaryGetAnalysisSections
+      | IAutoBePreliminaryGetDatabaseSchemas
+      | IAutoBePreliminaryGetInterfaceOperations
+      | IAutoBePreliminaryGetInterfaceSchemas
+      | IAutoBePreliminaryGetPreviousAnalysisSections
+      | IAutoBePreliminaryGetPreviousDatabaseSchemas
+      | IAutoBePreliminaryGetPreviousInterfaceOperations
+      | IAutoBePreliminaryGetPreviousInterfaceSchemas;
+  }
+
+  /**
+   * Request to complete schema refinement analysis.
+   *
+   * Executes the final refinement decision after analyzing a potentially
+   * degenerate primitive type. Uses structured Chain-of-Thought reasoning
+   * through observation, reasoning, and verdict properties to ensure systematic
+   * evaluation before making a decision.
+   */
+  export interface IComplete {
+    /**
+     * Type discriminator for the request.
+     *
+     * Determines which action to perform: preliminary data retrieval or actual
+     * task execution. Value "complete" indicates this is the final refinement
+     * decision request.
+     */
+    type: "complete";
+
+    /**
+     * Observation of the current type and its documentation.
+     *
+     * Describe what you observe about the type being analyzed:
+     *
+     * - What is the current type definition? (e.g., `type IFoo = number`)
+     * - What does the JSDoc/description say about the type?
+     * - Are there any database schema hints (JSON field, etc.)?
+     * - What does the naming suggest? (e.g., "Distribution", "Preferences")
+     *
+     * This is purely descriptive - state facts without judgment.
+     */
+    observation: string;
+
+    /**
+     * Reasoning about whether the type is degenerate.
+     *
+     * Analyze the observations and explain your reasoning:
+     *
+     * - Does the documentation describe a structure that contradicts the
+     *   primitive type?
+     * - Are there keywords suggesting complex structure? (key/value, array, list,
+     *   contains, mapping)
+     * - Is this a legitimate semantic alias? (e.g., `IUserId = string`)
+     * - What type SHOULD this be based on the evidence?
+     */
+    reasoning: string;
+
+    /**
+     * Final verdict on whether to refine the type.
+     *
+     * State your conclusion clearly:
+     *
+     * - Is this a degenerate type that needs refinement, or a valid primitive?
+     * - Summarize the key evidence that led to this decision.
+     * - If refining, briefly describe what the correct type should be.
+     */
+    verdict: string;
+
+    /**
+     * Casting design for the corrected object schema, or `null` if intentional.
+     *
+     * When the type is degenerate: provide the casting design with corrected
+     * object schema containing `databaseSchema`, `specification`,
+     * `description`, and `schema` fields.
+     *
+     * When the type is intentional (valid primitive alias): set to `null`.
+     */
+    casting: AutoBeInterfaceSchemaCasting | null;
+  }
+}