@autobe/agent 0.17.1 → 0.19.1

package/lib/agent/src/orchestrate/test/structures/IAutoBeTestWriteApplication.d.ts

@@ -0,0 +1,113 @@
+import { SnakePattern } from "@autobe/interface";
+export interface IAutoBeTestWriteApplication {
+    /**
+     * Main entry point for AI Function Call - generates complete E2E test code.
+     *
+     * The AI executes this function to perform the entire test generation
+     * workflow: scenario analysis → draft implementation → code review → final
+     * code production. This structured approach ensures high-quality,
+     * compilation-error-free test code.
+     *
+     * @param props Complete specification for test generation including scenario,
+     *   domain, and implementation steps
+     */
+    write(props: IAutoBeTestWriteApplication.IProps): void;
+}
+export declare namespace IAutoBeTestWriteApplication {
+    interface IProps {
+        /**
+         * Step 1: Strategic test planning and scenario analysis.
+         *
+         * AI analyzes the given test scenario and creates a comprehensive
+         * implementation strategy. This planning phase is crucial for generating
+         * well-structured, maintainable test code. The AI must define test
+         * methodology, data preparation, execution flow, and validation logic
+         * before proceeding to code implementation.
+         *
+         * Workflow: Input scenario → Strategic analysis → Detailed test plan
+         */
+        scenario: string;
+        /**
+         * Step 2: Functional domain classification for test organization.
+         *
+         * AI determines the appropriate domain category based on the scenario
+         * analysis. This classification drives file structure, test categorization,
+         * and logical grouping. The domain must be a single, lowercase word that
+         * represents the primary API resource.
+         *
+         * Workflow: Scenario analysis → Domain identification → Test organization
+         * structure
+         */
+        domain: string & SnakePattern;
+        /**
+         * Step 3: Initial TypeScript E2E test code implementation.
+         *
+         * AI generates the first working version of the test code based on the
+         * strategic plan. This draft must be compilation-error-free and follow
+         *
+         * @nestia/e2e framework conventions. The code should implement all planned
+         * test scenarios with proper async/await patterns, type safety, and
+         * comprehensive error handling.
+         *
+         * Workflow: Strategic plan → TypeScript implementation → Functional test
+         * code
+         *
+         * Critical: NO import statements, start directly with 'export async function'
+         */
+        draft: string;
+        /**
+         * Step 4: Code review and quality assessment.
+         *
+         * AI performs a thorough review of the draft implementation, examining:
+         *
+         * **Compilation & Syntax:**
+         *
+         * - TypeScript compilation errors and type mismatches
+         * - Syntax errors and missing semicolons/brackets
+         * - Correct function signatures and parameter types
+         *
+         * **Framework Compliance:**
+         *
+         * - @nestia/e2e framework conventions adherence
+         * - Proper API SDK function calling patterns
+         * - Correct use of typia.assert() and TestValidator functions
+         *
+         * **Business Logic & Test Coverage:**
+         *
+         * - Complete workflow implementation (authentication → data setup → main test
+         *   → validation)
+         * - Realistic business scenarios and user journeys
+         * - Edge case handling and error condition testing
+         * - Proper data dependencies and cleanup procedures
+         *
+         * **Code Quality & Security:**
+         *
+         * - Type safety violations (any, @ts-ignore, etc.)
+         * - Variable naming and code organization
+         * - Performance considerations and resource management
+         * - Security best practices in test data generation
+         *
+         * Workflow: Draft code → Systematic analysis → Specific improvement
+         * recommendations
+         *
+         * The review must identify concrete issues with line-by-line feedback and
+         * provide actionable solutions for each problem discovered.
+         */
+        review: string;
+        /**
+         * Step 5: Final production-ready test code.
+         *
+         * AI produces the final, polished version of the test code incorporating
+         * all review feedback. This code represents the completed test
+         * implementation, ready for production deployment. All identified issues
+         * must be resolved, and the code must meet the highest quality standards.
+         *
+         * Workflow: Review feedback → Code refinement → Production-ready
+         * implementation
+         *
+         * This is the ultimate deliverable that will be used in the actual test
+         * suite.
+         */
+        final: string;
+    }
+}

package/lib/agent/src/orchestrate/test/structures/IAutoBeTestWriteApplication.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IAutoBeTestWriteApplication.js","sourceRoot":"","sources":["../../../../../../src/orchestrate/test/structures/IAutoBeTestWriteApplication.ts"],"names":[],"mappings":""}

package/lib/agent/src/orchestrate/test/structures/IAutoBeTestWriteResult.d.ts

@@ -0,0 +1,7 @@
+import { AutoBeTestScenario, AutoBeTestWriteEvent } from "@autobe/interface";
+import { IAutoBeTestScenarioArtifacts } from "./IAutoBeTestScenarioArtifacts";
+export interface IAutoBeTestWriteResult {
+    scenario: AutoBeTestScenario;
+    artifacts: IAutoBeTestScenarioArtifacts;
+    event: AutoBeTestWriteEvent;
+}

package/lib/agent/src/orchestrate/test/structures/IAutoBeTestWriteResult.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IAutoBeTestWriteResult.js","sourceRoot":"","sources":["../../../../../../src/orchestrate/test/structures/IAutoBeTestWriteResult.ts"],"names":[],"mappings":""}

package/lib/agent/src/structures/IAutoBeConfig.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Interface defining behavioral configuration for AutoBeAgent localization and
+ * context.
+ *
+ * This interface customizes the agent's communication style, language
+ * preferences, and geographical context to provide personalized vibe coding
+ * experiences. The configuration enables culturally appropriate interactions
+ * and regionally aware development decisions throughout the automated
+ * development pipeline.
+ *
+ * Locale and timezone settings influence not only the language of communication
+ * but also contextual understanding of regulatory requirements, business
+ * practices, and temporal considerations that may affect requirements analysis,
+ * database design, API specifications, and implementation approaches.
+ *
+ * @author Samchon
+ */
+export interface IAutoBeConfig {
+    /**
+     * Language and cultural locale preference for AI agent communication.
+     *
+     * Configures the language and cultural context for all AI assistant responses
+     * throughout the vibe coding process. When specified, the agent will
+     * communicate in the preferred language while respecting cultural conventions
+     * and linguistic nuances during requirements gathering, progress updates, and
+     * guidance provision.
+     *
+     * The locale setting also influences the agent's understanding of regional
+     * business practices, regulatory considerations, and cultural expectations
+     * that may impact software design decisions and implementation approaches.
+     *
+     * Common formats follow BCP 47 language tags such as "en-US", "ko-KR",
+     * "ja-JP", "zh-CN", "de-DE", etc. Platform-specific detection methods:
+     *
+     * - Browser: `navigator.language`
+     * - Node.js: `process.env.LANG.split(".")[0]`
+     *
+     * @default System locale or "en" if unavailable
+     */
+    locale?: string;
+    /**
+     * Geographic timezone for temporal context and time-sensitive operations.
+     *
+     * Provides timezone awareness for proper handling of time-related
+     * considerations during the vibe coding process. This includes scheduling
+     * references, temporal business logic requirements, timestamp handling in
+     * generated code, and time-based communications that need to be
+     * contextualized for the user's local time.
+     *
+     * Timezone awareness ensures that generated applications properly handle time
+     * zones, that scheduling-related requirements are interpreted correctly, and
+     * that temporal references in documentation and code comments reflect the
+     * user's geographical context.
+     *
+     * Format follows IANA Time Zone Database identifiers such as
+     * "America/New_York", "Asia/Seoul", "Europe/London", "Pacific/Auckland", etc.
+     * Platform detection: `Intl.DateTimeFormat().resolvedOptions().timeZone`
+     *
+     * @default System timezone or "UTC" if unavailable
+     */
+    timezone?: string;
+    /**
+     * Backoff strategy for retrying failed operations.
+     *
+     * Defines the logic for retrying failed operations when the agent encounters
+     * errors. This includes retrying function calls, API requests, and other
+     * operations that may fail due to temporary issues.
+     */
+    backoffStrategy?: (props: {
+        count: number;
+        error: unknown;
+    }) => number;
+}

package/lib/agent/src/structures/IAutoBeConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IAutoBeConfig.js","sourceRoot":"","sources":["../../../../src/structures/IAutoBeConfig.ts"],"names":[],"mappings":""}

package/lib/agent/src/structures/IAutoBeProps.d.ts

@@ -0,0 +1,109 @@
+import { AutoBeHistory, IAutoBeCompiler, IAutoBeCompilerListener, IAutoBeTokenUsageJson } from "@autobe/interface";
+import { ILlmSchema } from "@samchon/openapi";
+import { AutoBeTokenUsage } from "../context/AutoBeTokenUsage";
+import { IAutoBeConfig } from "./IAutoBeConfig";
+import { IAutoBeVendor } from "./IAutoBeVendor";
+/**
+ * Configuration properties for initializing an AutoBeAgent instance.
+ *
+ * This interface defines all the essential parameters required to create and
+ * configure an AutoBeAgent for vibe coding operations. The properties establish
+ * the AI model capabilities, vendor connectivity, compilation infrastructure,
+ * behavioral context, and optional session continuity through conversation
+ * histories.
+ *
+ * The configuration enables type-safe AI function calling through
+ * model-specific schema generation, ensures compatibility with various AI
+ * service providers, and provides the compilation tools necessary for the
+ * sophisticated AST-based development pipeline that transforms conversations
+ * into working software.
+ *
+ * @author Samchon
+ */
+export interface IAutoBeProps<Model extends ILlmSchema.Model> {
+    /**
+     * AI model type specification for type-safe function calling schema
+     * generation.
+     *
+     * Determines the specific AI model schema used for generating function
+     * calling interfaces through
+     * [`typia.llm.application()`](https://typia.io/docs/llm/application). This
+     * type parameter ensures compile-time type safety and enables model-specific
+     * optimizations in the AI function calling interface generation process.
+     *
+     * Common values include "chatgpt" for OpenAI models, "claude" for Anthropic
+     * models, "deepseek" for DeepSeek models, and "llama" for Meta Llama models.
+     * The choice affects function calling capabilities, parameter limitations,
+     * and schema requirements throughout the vibe coding pipeline.
+     *
+     * Note that Google Gemini ("gemini") is not supported due to its lack of
+     * reference types and union types support required for OpenAPI document
+     * composition in the vibe coding process.
+     */
+    model: Model;
+    /**
+     * AI vendor configuration for service provider integration.
+     *
+     * Defines the complete AI service connection including the OpenAI SDK
+     * instance, model identifier, request options, and concurrency controls. This
+     * configuration enables the AutoBeAgent to connect with various AI providers
+     * while maintaining consistent functionality across the entire automated
+     * development workflow.
+     *
+     * The vendor settings determine the AI capabilities available for
+     * requirements analysis, database design, API specification, testing, and
+     * implementation phases of the vibe coding process.
+     */
+    vendor: IAutoBeVendor;
+    /**
+     * Compiler factory function for TypeScript, Prisma, and OpenAPI operations.
+     *
+     * Factory function that creates compiler instances required for the
+     * sophisticated AST-based development pipeline. The compiler handles
+     * validation, transformation, and code generation across all development
+     * phases including Prisma schema compilation, OpenAPI document validation,
+     * and TypeScript code compilation.
+     *
+     * For high-performance scenarios with multiple concurrent users, the compiler
+     * can be separated into dedicated worker processes to prevent blocking the
+     * main agent during computationally intensive compilation operations.
+     */
+    compiler: (listener: IAutoBeCompilerListener) => IAutoBeCompiler | Promise<IAutoBeCompiler>;
+    /**
+     * Optional conversation and development histories for session continuation.
+     *
+     * Enables resuming previous vibe coding sessions by providing the
+     * chronological record of past conversations, development activities, and
+     * generated artifacts. When provided, the agent reconstructs its internal
+     * state from these histories, allowing seamless continuation of development
+     * work.
+     *
+     * This capability supports iterative development workflows where users can
+     * return to modify, enhance, or extend previously generated applications
+     * while maintaining full context of earlier decisions and implementations.
+     */
+    histories?: AutoBeHistory[] | undefined;
+    /**
+     * Optional behavioral configuration for localization and context.
+     *
+     * Customizes the agent's communication style, language preferences, and
+     * geographical context to provide personalized vibe coding experiences.
+     * Configuration includes locale settings for internationalized responses and
+     * timezone information for temporal context awareness.
+     *
+     * These settings influence how the agent communicates with users, interprets
+     * regional requirements (such as regulatory considerations), and handles
+     * time-sensitive operations throughout the development process.
+     */
+    config?: IAutoBeConfig | undefined;
+    /**
+     * Token usage information.
+     *
+     * You can start token usage tracing by assigning this property.
+     *
+     * If you assign {@link IAutoBeTokenUsageJson} value, the token usage tracing
+     * would be from the value. Otherwise you assign the {@link AutoBeTokenUsage}
+     * typed instance, the tracing would be binded to the instance.
+     */
+    tokenUsage?: IAutoBeTokenUsageJson | AutoBeTokenUsage | undefined;
+}

package/lib/agent/src/structures/IAutoBeProps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IAutoBeProps.js","sourceRoot":"","sources":["../../../../src/structures/IAutoBeProps.ts"],"names":[],"mappings":""}

package/lib/agent/src/structures/IAutoBeVendor.d.ts

@@ -0,0 +1,87 @@
+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;
+}

package/lib/agent/src/structures/IAutoBeVendor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IAutoBeVendor.js","sourceRoot":"","sources":["../../../../src/structures/IAutoBeVendor.ts"],"names":[],"mappings":""}

package/lib/agent/src/utils/arrayToRecord.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Converts an array of key-value pairs (entries) into a Record.
+ *
+ * @param entries - Array of [key, value] tuples
+ * @returns Record object from the entries
+ */
+export declare function arrayToRecord<V>(entries: Array<[string, V]>): Record<string, V>;
+/**
+ * Converts an array of objects into a Record using specified key and value
+ * properties.
+ *
+ * @param items - Array of items to convert
+ * @param keyProp - Property name to use as the key
+ * @param valueProp - Property name to use as the value
+ * @returns Record object with the extracted key-value pairs
+ */
+export declare function arrayToRecord<T, K extends keyof T, V extends keyof T>(items: T[], keyProp: K, valueProp: V): Record<string, T[V]>;

package/lib/agent/src/utils/arrayToRecord.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrayToRecord.js","sourceRoot":"","sources":["../../../../src/utils/arrayToRecord.ts"],"names":[],"mappings":";;AAyBA,sCAuBC;AAvBD,SAAgB,aAAa,CAC3B,KAAiC,EACjC,OAAW,EACX,SAAa;IAEb,0CAA0C;IAC1C,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzE,OAAQ,KAA8B,CAAC,MAAM,CAC3C,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,EAC3D,EAAE,CACH,CAAC;IACJ,CAAC;IAED,2DAA2D;IAC3D,IAAI,OAAO,KAAK,SAAS,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QACrD,OAAQ,KAAa;aAClB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACd,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC;SACzC,CAAC,CAAC;aACF,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;AACzD,CAAC"}

package/lib/agent/src/utils/backoffRetry.d.ts

@@ -0,0 +1,22 @@
+export interface RetryOptions {
+    /** Maximum number of retry attempts (default: 5) */
+    maxRetries: number;
+    /** Base delay in milliseconds (default: 2000) */
+    baseDelay: number;
+    /** Maximum delay in milliseconds (default: 60_000) */
+    maxDelay: number;
+    /** Jitter factor for randomization (0-1, default: 0.3) */
+    jitter: number;
+    /** Function to determine if error should trigger retry (default: isRetryError) */
+    handleError: (error: any) => boolean;
+}
+/**
+ * @param fn Function to Apply the retry logic.
+ * @param maxRetries How many time to try. Max Retry is 5.
+ * @returns
+ */
+export declare function randomBackoffRetry<T>(fn: () => Promise<T>, options?: Partial<RetryOptions>): Promise<T>;
+export declare function randomBackoffStrategy(props: {
+    count: number;
+    error: unknown;
+}): number;

package/lib/agent/src/utils/backoffRetry.js.map

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

package/lib/agent/src/utils/divideArray.d.ts

@@ -0,0 +1,4 @@
+export declare function divideArray<T>(props: {
+    array: T[];
+    capacity: number;
+}): T[][];

package/lib/agent/src/utils/divideArray.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"divideArray.js","sourceRoot":"","sources":["../../../../src/utils/divideArray.ts"],"names":[],"mappings":";;AAAA,kCAeC;AAfD,SAAgB,WAAW,CAAI,KAAuC;IACpE,IAAI,KAAK,CAAC,QAAQ,IAAI,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACzD,CAAC;IACD,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,SAAS,CAAC,qCAAqC,CAAC,CAAC;IAC7D,CAAC;IACD,IAAI,KAAK,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACzD,CAAC;IAED,MAAM,IAAI,GAAW,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;IACpE,MAAM,QAAQ,GAAW,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC9D,MAAM,OAAO,GAAQ,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACzC,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;AACzE,CAAC"}

package/lib/agent/src/utils/emplaceMap.d.ts

@@ -0,0 +1 @@
+export declare function emplaceMap<Key, T>(dict: Map<Key, T>, key: Key, generator: () => T): T;

package/lib/agent/src/utils/emplaceMap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emplaceMap.js","sourceRoot":"","sources":["../../../../src/utils/emplaceMap.ts"],"names":[],"mappings":";;AAAA,gCAaC;AAbD,SAAgB,UAAU,CACxB,IAAiB,EACjB,GAAQ,EACR,SAAkB;IAElB,MAAM,MAAM,GAAkB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,KAAK,GAAM,SAAS,EAAE,CAAC;IAC7B,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACrB,OAAO,KAAK,CAAC;AACf,CAAC"}

package/lib/agent/src/utils/predicateStateMessage.d.ts

@@ -0,0 +1,4 @@
+import { AutoBeState } from "../context/AutoBeState";
+type StepName = "analyze" | "prisma" | "interface" | "test" | "realize";
+export declare const predicateStateMessage: (state: AutoBeState, future: StepName) => string | null;
+export {};

package/lib/agent/src/utils/predicateStateMessage.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.predicateStateMessage = void 0;
+const utils_1 = require("@autobe/utils");
+const predicateStateMessage = (state, future) => {
+    if (future === "analyze")
+        return null;
+    if (future === "prisma")
+        return predicatePrisma(state);
+    const futureIndex = STEP_ORDER.indexOf(future);
+    for (const key of STEP_ORDER.slice(0, futureIndex))
+        if (state[key] === null)
+            return buildMissingStepsMessage(future, key);
+    const prevStepName = STEP_ORDER[futureIndex - 1];
+    if (state.analyze.step !== state[prevStepName].step)
+        return buildOutdatedMessage(prevStepName, "analyze", state);
+    return null;
+};
+exports.predicateStateMessage = predicateStateMessage;
+const buildMissingStepsMessage = (current, missing) => {
+    const currentIndex = STEP_ORDER.indexOf(current);
+    const missingIndex = STEP_ORDER.indexOf(missing);
+    const remainingSteps = STEP_ORDER.slice(missingIndex, currentIndex + 1)
+        .map((step, index) => `${index + 1}. ${STEP_DESCRIPTIONS[step]}`)
+        .join("\n    ");
+    const currentAction = ACTION_NAMES[current];
+    return utils_1.StringUtil.trim `
+    ${STEP_DESCRIPTIONS[missing]} not completed yet.
+
+    To ${currentAction}, complete these steps:
+    
+    ${remainingSteps}
+
+    Start with step ${missingIndex + 1}.
+  `;
+};
+const buildOutdatedMessage = (outdatedStep, currentStep, state) => {
+    var _a, _b;
+    const outdatedVersion = (_a = state[outdatedStep]) === null || _a === void 0 ? void 0 : _a.step;
+    const currentVersion = (_b = state[currentStep]) === null || _b === void 0 ? void 0 : _b.step;
+    return utils_1.StringUtil.trim `
+    ${STEP_NAMES[outdatedStep]} is outdated (step ${outdatedVersion}).
+    
+    Requirements are now at step ${currentVersion}.
+    
+    Please update ${outdatedStep} to match current requirements.
+  `;
+};
+const predicatePrisma = (state) => {
+    if (state.analyze !== null)
+        return null;
+    return utils_1.StringUtil.trim `
+    Requirements analysis not started.
+    
+    Discuss your project with AI to generate requirements analysis.
+    Database design will follow after requirements are ready.
+  `;
+};
+const STEP_DESCRIPTIONS = {
+    analyze: "Requirements analysis",
+    prisma: "Database design",
+    interface: "API interface design",
+    test: "E2E test creation",
+    realize: "Implementation",
+};
+const STEP_NAMES = {
+    analyze: "Requirements analysis",
+    prisma: "Database schema",
+    interface: "API interface",
+    test: "Test functions",
+    realize: "Implementation",
+};
+const ACTION_NAMES = {
+    analyze: "analyze requirements",
+    prisma: "design database",
+    interface: "design API interface",
+    test: "create tests",
+    realize: "implement the program",
+};
+const STEP_ORDER = [
+    "analyze",
+    "prisma",
+    "interface",
+    "test",
+    "realize",
+];
+//# sourceMappingURL=predicateStateMessage.js.map

package/lib/agent/src/utils/predicateStateMessage.js.map

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