@autobe/agent 0.30.2 → 0.30.4-dev.20260324

package/src/orchestrate/test/experimental/transformTestCorrectHistories.ast

@@ -1,52 +1,52 @@
-import { IAgenticaHistoryJson } from "@agentica/core";
-import { IAutoBeTypeScriptCompileResult } from "@autobe/interface";
-import { v7 } from "uuid";
-
-import { AutoBeSystemPromptConstant } from "../../constants/AutoBeSystemPromptConstant";
-import { IAutoBeTestWriteResult } from "./structures/IAutoBeTestWriteResult";
-
-export const transformTestCorrectHistories = (
-  // ctx: AutoBeContext<Model>,
-  written: IAutoBeTestWriteResult,
-  failure: IAutoBeTypeScriptCompileResult.IFailure,
-): Array<
-  IAgenticaHistoryJson.IAssistantMessage | IAgenticaHistoryJson.ISystemMessage
-> => {
-  return [
-    {
-      id: v7(),
-      created_at: new Date().toISOString(),
-      type: "systemMessage",
-      text: AutoBeSystemPromptConstant.TEST_WRITE,
-    },
-    {
-      id: v7(),
-      created_at: new Date().toISOString(),
-      type: "assistantMessage",
-      text: [
-        "## Original Code",
-        "## `AutoBeTest.IFunction` data",
-        "```json",
-        JSON.stringify(written.file.function),
-        "```",
-        "## Generated TypeScript Code",
-        "```typescript",
-        written.file.content,
-        "```",
-        "",
-        "## Compile Errors",
-        "Fix the compilation error in the provided code.",
-        "",
-        "```json",
-        JSON.stringify(failure.diagnostics),
-        "```",
-      ].join("\n"),
-    },
-    {
-      id: v7(),
-      created_at: new Date().toISOString(),
-      type: "systemMessage",
-      text: AutoBeSystemPromptConstant.TEST_CORRECT,
-    },
-  ];
-};
+import { IAgenticaHistoryJson } from "@agentica/core";
+import { IAutoBeTypeScriptCompileResult } from "@autobe/interface";
+import { v7 } from "uuid";
+
+import { AutoBeSystemPromptConstant } from "../../constants/AutoBeSystemPromptConstant";
+import { IAutoBeTestWriteResult } from "./structures/IAutoBeTestWriteResult";
+
+export const transformTestCorrectHistories = (
+  // ctx: AutoBeContext<Model>,
+  written: IAutoBeTestWriteResult,
+  failure: IAutoBeTypeScriptCompileResult.IFailure,
+): Array<
+  IAgenticaHistoryJson.IAssistantMessage | IAgenticaHistoryJson.ISystemMessage
+> => {
+  return [
+    {
+      id: v7(),
+      created_at: new Date().toISOString(),
+      type: "systemMessage",
+      text: AutoBeSystemPromptConstant.TEST_WRITE,
+    },
+    {
+      id: v7(),
+      created_at: new Date().toISOString(),
+      type: "assistantMessage",
+      text: [
+        "## Original Code",
+        "## `AutoBeTest.IFunction` data",
+        "```json",
+        JSON.stringify(written.file.function),
+        "```",
+        "## Generated TypeScript Code",
+        "```typescript",
+        written.file.content,
+        "```",
+        "",
+        "## Compile Errors",
+        "Fix the compilation error in the provided code.",
+        "",
+        "```json",
+        JSON.stringify(failure.diagnostics),
+        "```",
+      ].join("\n"),
+    },
+    {
+      id: v7(),
+      created_at: new Date().toISOString(),
+      type: "systemMessage",
+      text: AutoBeSystemPromptConstant.TEST_CORRECT,
+    },
+  ];
+};

package/src/structures/IAutoBeVendor.ts

@@ -1,113 +1,127 @@
-import OpenAI from "openai";
-
-/**
- * Interface representing AI vendor configuration for the AutoBeAgent.
- *
- * Defines the connection parameters and settings required to integrate with AI
- * service providers that power the vibe coding pipeline. While utilizing the
- * OpenAI SDK as the connection interface, this configuration supports various
- * LLM vendors beyond OpenAI through flexible endpoint and authentication
- * configuration, enabling integration with Claude, DeepSeek, Meta Llama, and
- * other providers that follow OpenAI-compatible API patterns.
- *
- * The vendor configuration determines the AI capabilities available throughout
- * the entire automated development workflow, from requirements analysis and
- * database design through API specification, testing, and final implementation.
- * Different vendors may offer varying performance characteristics, cost
- * structures, and feature support that can be optimized for specific vibe
- * coding needs.
- *
- * Concurrent request management is built-in to prevent API rate limiting and
- * optimize resource utilization across multiple development phases and parallel
- * operations within the vibe coding pipeline.
- *
- * @author Samchon
- */
-export interface IAutoBeVendor {
-  /**
-   * OpenAI SDK instance configured for the target AI vendor.
-   *
-   * Provides the API connection interface used by the AutoBeAgent to
-   * communicate with AI services. While this uses the OpenAI SDK, it can be
-   * configured to connect with various LLM providers by setting the appropriate
-   * `baseURL` and authentication credentials. The SDK serves as a universal
-   * connector that abstracts the underlying API communication protocols.
-   *
-   * For non-OpenAI vendors, configure the SDK with the vendor's API endpoint
-   * and authentication requirements to enable seamless integration with the
-   * vibe coding system.
-   */
-  api: OpenAI;
-
-  /**
-   * Specific model identifier to use for AI operations.
-   *
-   * Specifies the exact model name or identifier that should be used for vibe
-   * coding tasks. Supports both official OpenAI chat models and custom model
-   * identifiers for third-party hosting services, cloud providers, or
-   * alternative LLM vendors. The model choice significantly impacts the
-   * quality, performance, and cost of the automated development process.
-   *
-   * Examples include "gpt-4", "gpt-3.5-turbo" for OpenAI, or vendor-specific
-   * identifiers like "claude-3-sonnet", "deepseek-chat-v3", "llama3.3-70b" when
-   * using alternative providers through compatible APIs.
-   */
-  model: OpenAI.ChatModel | ({} & string);
-
-  /**
-   * Optional request configuration for API calls.
-   *
-   * Additional request options that will be applied to all API calls made
-   * through the OpenAI SDK. This can include custom headers, timeouts, retry
-   * policies, or other HTTP client configuration that may be required for
-   * specific vendor integrations or enterprise environments.
-   *
-   * These options provide fine-grained control over the API communication
-   * behavior and can be used to optimize performance or meet specific
-   * infrastructure requirements.
-   */
-  options?: OpenAI.RequestOptions | undefined;
-
-  /**
-   * Maximum number of concurrent API requests allowed.
-   *
-   * Controls the concurrency level for AI API calls to prevent rate limiting,
-   * manage resource consumption, and optimize system performance. The vibe
-   * coding pipeline may make multiple parallel requests during development
-   * phases, and this setting ensures controlled resource utilization.
-   *
-   * A reasonable default provides balanced performance while respecting typical
-   * API rate limits. Lower values reduce resource consumption but may slow
-   * development progress, while higher values can improve performance but risk
-   * hitting rate limits or overwhelming the AI service.
-   *
-   * Set to undefined to disable concurrency limiting, allowing unlimited
-   * parallel requests (use with caution based on your API limits and
-   * infrastructure capacity).
-   *
-   * @default 16
-   */
-  semaphore?: number | undefined;
-
-  /**
-   * Indicates whether this vendor/model supports explicit tool choice control.
-   *
-   * When set to `true`, the agent may pass the `tool_choice` parameter with a
-   * value of `"required"` (or other explicit values) for models that implement
-   * OpenAI-style tool calling. This allows the agent to force the model to call
-   * one of the provided tools when appropriate.
-   *
-   * When set to `false`, the agent will avoid sending `tool_choice` in a way
-   * that forces tool invocation, and will instead rely on the model's default
-   * behavior or omit tool-choice configuration entirely. This should be used
-   * for vendors or models that do not understand, partially implement, or are
-   * unstable with the `tool_choice` parameter.
-   *
-   * This flag is necessary so that a single agent implementation can work
-   * across multiple vendors and models with differing levels of tool-calling
-   * support, without causing API errors or unexpected behavior.
-   *
-   * @default true
-   */
-  useToolChoice?: boolean;
-}
+import OpenAI from "openai";
+
+/**
+ * Interface representing AI vendor configuration for the AutoBeAgent.
+ *
+ * Defines the connection parameters and settings required to integrate with AI
+ * service providers that power the vibe coding pipeline. While utilizing the
+ * OpenAI SDK as the connection interface, this configuration supports various
+ * LLM vendors beyond OpenAI through flexible endpoint and authentication
+ * configuration, enabling integration with Claude, DeepSeek, Meta Llama, and
+ * other providers that follow OpenAI-compatible API patterns.
+ *
+ * The vendor configuration determines the AI capabilities available throughout
+ * the entire automated development workflow, from requirements analysis and
+ * database design through API specification, testing, and final implementation.
+ * Different vendors may offer varying performance characteristics, cost
+ * structures, and feature support that can be optimized for specific vibe
+ * coding needs.
+ *
+ * Concurrent request management is built-in to prevent API rate limiting and
+ * optimize resource utilization across multiple development phases and parallel
+ * operations within the vibe coding pipeline.
+ *
+ * @author Samchon
+ */
+export interface IAutoBeVendor {
+  /**
+   * OpenAI SDK instance configured for the target AI vendor.
+   *
+   * Provides the API connection interface used by the AutoBeAgent to
+   * communicate with AI services. While this uses the OpenAI SDK, it can be
+   * configured to connect with various LLM providers by setting the appropriate
+   * `baseURL` and authentication credentials. The SDK serves as a universal
+   * connector that abstracts the underlying API communication protocols.
+   *
+   * For non-OpenAI vendors, configure the SDK with the vendor's API endpoint
+   * and authentication requirements to enable seamless integration with the
+   * vibe coding system.
+   */
+  api: OpenAI;
+
+  /**
+   * Specific model identifier to use for AI operations.
+   *
+   * Specifies the exact model name or identifier that should be used for vibe
+   * coding tasks. Supports both official OpenAI chat models and custom model
+   * identifiers for third-party hosting services, cloud providers, or
+   * alternative LLM vendors. The model choice significantly impacts the
+   * quality, performance, and cost of the automated development process.
+   *
+   * Examples include "gpt-4", "gpt-3.5-turbo" for OpenAI, or vendor-specific
+   * identifiers like "claude-3-sonnet", "deepseek-chat-v3", "llama3.3-70b" when
+   * using alternative providers through compatible APIs.
+   */
+  model: OpenAI.ChatModel | ({} & string);
+
+  /**
+   * Optional human-readable label for this vendor/model configuration.
+   *
+   * This is a display or grouping name that is distinct from the underlying
+   * `model` identifier, and is intended for use in logs, UIs, selection menus,
+   * or archive views where a more descriptive name is helpful (for example,
+   * "Primary GPT-4", "Fast Drafting Model", or "Internal Llama Cluster").
+   *
+   * When omitted, callers should fall back to displaying or logging the `model`
+   * value itself, or another sensible default derived from the model
+   * identifier.
+   */
+  label?: string | undefined;
+
+  /**
+   * Optional request configuration for API calls.
+   *
+   * Additional request options that will be applied to all API calls made
+   * through the OpenAI SDK. This can include custom headers, timeouts, retry
+   * policies, or other HTTP client configuration that may be required for
+   * specific vendor integrations or enterprise environments.
+   *
+   * These options provide fine-grained control over the API communication
+   * behavior and can be used to optimize performance or meet specific
+   * infrastructure requirements.
+   */
+  options?: OpenAI.RequestOptions | undefined;
+
+  /**
+   * Maximum number of concurrent API requests allowed.
+   *
+   * Controls the concurrency level for AI API calls to prevent rate limiting,
+   * manage resource consumption, and optimize system performance. The vibe
+   * coding pipeline may make multiple parallel requests during development
+   * phases, and this setting ensures controlled resource utilization.
+   *
+   * A reasonable default provides balanced performance while respecting typical
+   * API rate limits. Lower values reduce resource consumption but may slow
+   * development progress, while higher values can improve performance but risk
+   * hitting rate limits or overwhelming the AI service.
+   *
+   * Set to undefined to disable concurrency limiting, allowing unlimited
+   * parallel requests (use with caution based on your API limits and
+   * infrastructure capacity).
+   *
+   * @default 16
+   */
+  semaphore?: number | undefined;
+
+  /**
+   * Indicates whether this vendor/model supports explicit tool choice control.
+   *
+   * When set to `true`, the agent may pass the `tool_choice` parameter with a
+   * value of `"required"` (or other explicit values) for models that implement
+   * OpenAI-style tool calling. This allows the agent to force the model to call
+   * one of the provided tools when appropriate.
+   *
+   * When set to `false`, the agent will avoid sending `tool_choice` in a way
+   * that forces tool invocation, and will instead rely on the model's default
+   * behavior or omit tool-choice configuration entirely. This should be used
+   * for vendors or models that do not understand, partially implement, or are
+   * unstable with the `tool_choice` parameter.
+   *
+   * This flag is necessary so that a single agent implementation can work
+   * across multiple vendors and models with differing levels of tool-calling
+   * support, without causing API errors or unexpected behavior.
+   *
+   * @default true
+   */
+  useToolChoice?: boolean;
+}