@autobe/agent 0.17.1 → 0.19.1

package/lib/agent/src/constants/AutoBeSystemPromptConstant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AutoBeSystemPromptConstant.js","sourceRoot":"","sources":["../../../../src/constants/AutoBeSystemPromptConstant.ts"],"names":[],"mappings":";;AA4BC,CAAC"}

package/lib/agent/src/context/AutoBeContext.d.ts

@@ -0,0 +1,41 @@
+import { IAgenticaVendor, IMicroAgenticaHistoryJson, MicroAgenticaHistory } from "@agentica/core";
+import { AutoBeAnalyzeHistory, AutoBeAssistantMessageEvent, AutoBeAssistantMessageHistory, AutoBeEvent, AutoBeEventSource, AutoBeHistory, AutoBeInterfaceHistory, AutoBePrismaHistory, AutoBeRealizeHistory, AutoBeTestHistory, IAutoBeCompiler, IAutoBeCompilerListener, IAutoBeGetFilesOptions, IAutoBeTokenUsageJson } from "@autobe/interface";
+import { ILlmController, ILlmSchema } from "@samchon/openapi";
+import { AutoBeState } from "./AutoBeState";
+import { AutoBeTokenUsage } from "./AutoBeTokenUsage";
+export interface AutoBeContext<Model extends ILlmSchema.Model> {
+    model: Model;
+    vendor: IAgenticaVendor;
+    locale: string;
+    compilerListener: IAutoBeCompilerListener;
+    compiler: () => Promise<IAutoBeCompiler>;
+    files: (options: IAutoBeGetFilesOptions) => Promise<Record<string, string>>;
+    histories: () => Readonly<AutoBeHistory[]>;
+    state: () => Readonly<AutoBeState>;
+    usage: () => AutoBeTokenUsage;
+    dispatch: <Event extends Exclude<AutoBeEvent, AutoBeAssistantMessageEvent>>(event: Event) => AutoBeContext.DispatchHistory<Event>;
+    assistantMessage: (message: AutoBeAssistantMessageHistory) => AutoBeAssistantMessageHistory;
+    conversate(props: AutoBeContext.IConversate<Model>): Promise<AutoBeContext.IResult<Model>>;
+}
+export declare namespace AutoBeContext {
+    type DispatchHistory<Event extends Exclude<AutoBeEvent, AutoBeAssistantMessageEvent>> = Event["type"] extends keyof DispatchHistoryMap ? DispatchHistoryMap[Event["type"]] : null;
+    type DispatchHistoryMap = {
+        assistantMessage: AutoBeAssistantMessageHistory;
+        analyzeComplete: AutoBeAnalyzeHistory;
+        prismaComplete: AutoBePrismaHistory;
+        interfaceComplete: AutoBeInterfaceHistory;
+        testComplete: AutoBeTestHistory;
+        realizeComplete: AutoBeRealizeHistory;
+    };
+    interface IConversate<Model extends ILlmSchema.Model> {
+        source: AutoBeEventSource;
+        controller: ILlmController<Model>;
+        histories: Array<IMicroAgenticaHistoryJson>;
+        enforceFunctionCall: boolean;
+        message: string;
+    }
+    interface IResult<Model extends ILlmSchema.Model> {
+        histories: MicroAgenticaHistory<Model>[];
+        tokenUsage: IAutoBeTokenUsageJson.IComponent;
+    }
+}

package/lib/agent/src/context/AutoBeContext.js.map

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

package/lib/agent/src/context/AutoBeState.d.ts

@@ -0,0 +1,8 @@
+import { AutoBeAnalyzeHistory, AutoBeInterfaceHistory, AutoBePrismaHistory, AutoBeRealizeHistory, AutoBeTestHistory } from "@autobe/interface";
+export interface AutoBeState {
+    analyze: AutoBeAnalyzeHistory | null;
+    prisma: AutoBePrismaHistory | null;
+    interface: AutoBeInterfaceHistory | null;
+    test: AutoBeTestHistory | null;
+    realize: AutoBeRealizeHistory | null;
+}

package/lib/agent/src/context/AutoBeState.js.map

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

package/lib/agent/src/context/AutoBeTokenUsage.d.ts

@@ -0,0 +1,173 @@
+import { IAutoBeTokenUsageJson } from "@autobe/interface";
+import { AutoBeTokenUsageComponent } from "./AutoBeTokenUsageComponent";
+import { IAutoBeApplication } from "./IAutoBeApplication";
+/**
+ * Comprehensive token usage tracker for the AutoBe vibe coding system.
+ *
+ * This class provides centralized tracking and management of token consumption
+ * across all AI agents in the automated development pipeline. It captures
+ * detailed token usage statistics for each processing phase - from initial
+ * requirements analysis through final implementation - enabling cost
+ * monitoring, performance optimization, and resource utilization analysis.
+ *
+ * The token usage data includes both input tokens (with cache efficiency) and
+ * output tokens (with generation type breakdowns), providing insights into AI
+ * processing efficiency and helping optimize the balance between computational
+ * costs and output quality.
+ *
+ * @author SunRabbit123
+ */
+export declare class AutoBeTokenUsage implements IAutoBeTokenUsageJson {
+    /**
+     * Token usage for the facade agent orchestrating the entire pipeline.
+     *
+     * Tracks tokens consumed by the initial agent that coordinates and manages
+     * the overall vibe coding process, including request parsing and response
+     * orchestration.
+     */
+    readonly facade: AutoBeTokenUsageComponent;
+    /**
+     * Token usage for the requirements analysis agent.
+     *
+     * Captures tokens used during the analysis phase where user requirements are
+     * processed, understood, and transformed into structured specifications for
+     * subsequent development phases.
+     */
+    readonly analyze: AutoBeTokenUsageComponent;
+    /**
+     * Token usage for the Prisma database schema generation agent.
+     *
+     * Records tokens consumed while designing and generating database schemas,
+     * including entity relationships, field definitions, and database-specific
+     * optimizations.
+     */
+    readonly prisma: AutoBeTokenUsageComponent;
+    /**
+     * Token usage for the API interface specification agent.
+     *
+     * Tracks tokens used in creating OpenAPI/Swagger specifications, defining
+     * endpoints, request/response structures, and API documentation.
+     */
+    readonly interface: AutoBeTokenUsageComponent;
+    /**
+     * Token usage for the test code generation agent.
+     *
+     * Monitors tokens consumed during automated test creation, including scenario
+     * planning, test case generation, and end-to-end test implementation.
+     */
+    readonly test: AutoBeTokenUsageComponent;
+    /**
+     * Token usage for the implementation realization agent.
+     *
+     * Captures tokens used in the final implementation phase where actual
+     * business logic, controllers, services, and integration code are generated.
+     */
+    readonly realize: AutoBeTokenUsageComponent;
+    /**
+     * Aggregated token usage statistics across all agents.
+     *
+     * Provides a unified view of token consumption by combining data from all
+     * processing phases in the vibe coding pipeline. This computed property
+     * dynamically calculates the sum of all agent components (facade, analyze,
+     * prisma, interface, test, realize) whenever accessed, ensuring the aggregate
+     * always reflects the current state of token usage.
+     *
+     * The aggregation performs element-wise addition across all token metrics,
+     * including total counts, input breakdowns with cache statistics, and output
+     * categorizations by generation type. This comprehensive view enables overall
+     * cost assessment and resource utilization analysis for the entire automated
+     * development session.
+     */
+    get aggregate(): IAutoBeTokenUsageJson.IComponent;
+    /**
+     * Default Constructor.
+     *
+     * Creates a new token usage tracker with all agent phases initialized to
+     * empty components. Each component starts with zero values for all token
+     * counters, providing a clean slate for tracking token consumption from the
+     * beginning of a vibe coding session.
+     */
+    constructor();
+    /**
+     * Binding Constructor.
+     *
+     * Creates a new instance that shares component references with the provided
+     * AutoBeTokenUsage instance. This establishes a bound relationship where both
+     * instances point to the same component objects. Any modifications to token
+     * counts through either instance will be reflected in both, enabling shared
+     * tracking across different contexts.
+     *
+     * @param bind Existing AutoBeTokenUsage instance to bind to
+     */
+    constructor(bind: AutoBeTokenUsage);
+    /**
+     * Initializer Constructor.
+     *
+     * Reconstructs a token usage tracker from serialized JSON data. Creates new
+     * AutoBeTokenUsageComponent instances for each agent phase, initializing them
+     * with the corresponding values from the JSON structure. This enables
+     * restoration of token usage state from persisted data or transmission
+     * between different parts of the system.
+     *
+     * @param props Token usage data in JSON format
+     */
+    constructor(props?: Omit<IAutoBeTokenUsageJson, "aggregate">);
+    /**
+     * Serialize token usage data to JSON format.
+     *
+     * Converts the internal token usage representation to the standardized
+     * IAutoBeTokenUsageJson format, suitable for persistence, transmission, or
+     * external analysis. The serialized data maintains the complete structure
+     * including all agent phases and detailed token breakdowns.
+     *
+     * @returns JSON representation of token usage statistics
+     */
+    toJSON(): IAutoBeTokenUsageJson;
+    /**
+     * Record token usage for specific processing stages.
+     *
+     * Updates token consumption statistics for one or more agent phases based on
+     * the provided usage data. This method allows selective recording of token
+     * usage for specific stages, enabling fine-grained tracking during
+     * multi-phase processing or when certain agents are invoked multiple times.
+     *
+     * @example
+     *   ```ts
+     *   tokenUsage.record(
+     *     { total: 150, input: { total: 100, cached: 20 }, output: { total: 50, ... } },
+     *     ['analyze', 'prisma']
+     *   );
+     *   ```;
+     *
+     * @param usage - Token usage component data to record
+     * @param additionalStages - Array of stage names to update with the usage
+     *   data
+     */
+    record(usage: IAutoBeTokenUsageJson.IComponent, additionalStages?: (keyof IAutoBeApplication)[]): void;
+    /**
+     * Increment current token usage with data from another instance.
+     *
+     * Adds token usage statistics from another AutoBeTokenUsage instance to this
+     * one, updating all agent phases simultaneously. This method is useful for
+     * combining token usage from parallel processing, multiple runs, or when
+     * aggregating statistics from distributed agent executions.
+     *
+     * @param usage - AutoBeTokenUsage instance to add to current statistics
+     * @returns This instance for method chaining
+     */
+    increment(usage: AutoBeTokenUsage): this;
+    /**
+     * Create a new instance combining token usage from two sources.
+     *
+     * Performs element-wise addition of token usage statistics from two
+     * AutoBeTokenUsage instances, creating a new instance with the combined
+     * totals. This static method is useful for aggregating token usage across
+     * multiple vibe coding sessions or when merging statistics from different
+     * execution contexts.
+     *
+     * @param usageA - First token usage instance
+     * @param usageB - Second token usage instance
+     * @returns New instance with combined token usage statistics
+     */
+    static plus(usageA: AutoBeTokenUsage, usageB: AutoBeTokenUsage): AutoBeTokenUsage;
+}

package/lib/{context → agent/src/context}/AutoBeTokenUsage.js

@@ -132,6 +132,13 @@ class AutoBeTokenUsage {
         });
         return this;
     }
+    /** @internal */
+    decrement(usage) {
+        AutoBeTokenUsage.keys().forEach((key) => {
+            this[key].decrement(usage[key]);
+        });
+        return this;
+    }
     /**
      * Create a new instance combining token usage from two sources.
      *

package/lib/agent/src/context/AutoBeTokenUsage.js.map

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

package/lib/agent/src/context/AutoBeTokenUsageComponent.d.ts

@@ -0,0 +1,117 @@
+import { IAutoBeTokenUsageJson } from "@autobe/interface";
+/**
+ * Token usage component for individual AI agents in the vibe coding pipeline.
+ *
+ * Represents detailed token consumption statistics for a specific processing
+ * phase (facade, analyze, prisma, interface, test, or realize). This class
+ * tracks both input and output token usage with granular breakdowns, enabling
+ * precise cost analysis and performance optimization for each agent.
+ *
+ * The component structure includes:
+ *
+ * - Total token count for quick cost calculations
+ * - Input token breakdown with cache efficiency metrics
+ * - Output token categorization by generation type
+ *
+ * This granular tracking helps identify optimization opportunities and
+ * understand the computational characteristics of each agent phase.
+ *
+ * @author SunRabbit123
+ */
+export declare class AutoBeTokenUsageComponent implements IAutoBeTokenUsageJson.IComponent {
+    /**
+     * Detailed breakdown of input token consumption.
+     *
+     * Tracks how many tokens were processed as input to the AI agent, including:
+     *
+     * - Total input tokens processed
+     * - Cached tokens that were reused from previous operations
+     *
+     * The cache efficiency (cached/total ratio) indicates how well the system is
+     * reusing context across multiple invocations.
+     */
+    readonly input: IAutoBeTokenUsageJson.IInput;
+    /**
+     * Detailed breakdown of output token generation.
+     *
+     * Categorizes generated tokens by their purpose and acceptance status:
+     *
+     * - Total output tokens generated
+     * - Reasoning tokens (internal processing)
+     * - Accepted prediction tokens (efficient generation)
+     * - Rejected prediction tokens (quality control overhead)
+     *
+     * These metrics help understand the AI's generation efficiency and the
+     * effectiveness of its predictive mechanisms.
+     */
+    readonly output: IAutoBeTokenUsageJson.IOutput;
+    /**
+     * Total token count combining all input and output tokens.
+     *
+     * Represents the complete token consumption for this component, providing a
+     * single metric for overall resource utilization. This value is critical for
+     * cost calculations and comparing efficiency across different agents or
+     * processing phases.
+     */
+    get total(): number;
+    /**
+     * Default Constructor.
+     *
+     * Creates a new token usage component with all counters initialized to zero.
+     * Constructs fresh input and output objects with default values, providing a
+     * clean starting point for tracking token consumption in an agent phase.
+     */
+    constructor();
+    /**
+     * Initializer Constructor.
+     *
+     * Creates a new component populated with existing token usage data. Directly
+     * assigns the provided values to instance properties, preserving the exact
+     * token counts and structure from the source data for accurate tracking
+     * continuation.
+     *
+     * @param props - Token usage data to initialize the component
+     */
+    constructor(props: Omit<IAutoBeTokenUsageJson.IComponent, "total">);
+    /**
+     * Export token usage data as JSON.
+     *
+     * Converts the component's token usage statistics to the standardized
+     * IAutoBeTokenUsageJson.IComponent format. This serialization maintains the
+     * complete structure including total counts and detailed breakdowns for both
+     * input and output tokens.
+     *
+     * @returns JSON representation of the token usage component
+     */
+    toJSON(): IAutoBeTokenUsageJson.IComponent;
+    /**
+     * Add token usage data to current statistics.
+     *
+     * Increments all token counters in this component by the corresponding values
+     * from the provided component data. This method performs in-place updates,
+     * modifying the current instance rather than creating a new one.
+     *
+     * Updates include:
+     *
+     * - Total token count
+     * - Input tokens (both total and cached)
+     * - Output tokens (reasoning, accepted/rejected predictions)
+     *
+     * @param props - Token usage component data to add to current values
+     */
+    increment(props: IAutoBeTokenUsageJson.IComponent): void;
+    /**
+     * Create new component combining two token usage statistics.
+     *
+     * Performs element-wise addition of all token counters from two components,
+     * creating a new AutoBeTokenUsageComponent instance with the combined totals.
+     * This static method is useful for aggregating token usage across multiple
+     * agent invocations or combining statistics from parallel processing.
+     *
+     * @param a - First token usage component
+     * @param b - Second token usage component
+     * @returns New component with combined token statistics
+     */
+    static plus(a: AutoBeTokenUsageComponent, b: AutoBeTokenUsageComponent): AutoBeTokenUsageComponent;
+    static minus(a: AutoBeTokenUsageComponent, b: AutoBeTokenUsageComponent): AutoBeTokenUsageComponent;
+}

package/lib/{context → agent/src/context}/AutoBeTokenUsageComponent.js

@@ -59,8 +59,16 @@ class AutoBeTokenUsageComponent {
     toJSON() {
         return {
             total: this.total,
-            input: this.input,
-            output: this.output,
+            input: {
+                total: this.input.total,
+                cached: this.input.cached,
+            },
+            output: {
+                total: this.output.total,
+                reasoning: this.output.reasoning,
+                accepted_prediction: this.output.accepted_prediction,
+                rejected_prediction: this.output.rejected_prediction,
+            },
         };
     }
     /* -----------------------------------------------------------
@@ -89,6 +97,15 @@ class AutoBeTokenUsageComponent {
         this.output.accepted_prediction += props.output.accepted_prediction;
         this.output.rejected_prediction += props.output.rejected_prediction;
     }
+    /** @internal */
+    decrement(props) {
+        this.input.total -= props.input.total;
+        this.input.cached -= props.input.cached;
+        this.output.total -= props.output.total;
+        this.output.reasoning -= props.output.reasoning;
+        this.output.accepted_prediction -= props.output.accepted_prediction;
+        this.output.rejected_prediction -= props.output.rejected_prediction;
+    }
     /**
      * Create new component combining two token usage statistics.
      *
@@ -115,6 +132,20 @@ class AutoBeTokenUsageComponent {
             },
         });
     }
+    static minus(a, b) {
+        return new AutoBeTokenUsageComponent({
+            input: {
+                total: a.input.total - b.input.total,
+                cached: a.input.cached - b.input.cached,
+            },
+            output: {
+                total: a.output.total - b.output.total,
+                reasoning: a.output.reasoning - b.output.reasoning,
+                accepted_prediction: a.output.accepted_prediction - b.output.accepted_prediction,
+                rejected_prediction: a.output.rejected_prediction - b.output.rejected_prediction,
+            },
+        });
+    }
 }
 exports.AutoBeTokenUsageComponent = AutoBeTokenUsageComponent;
 //# sourceMappingURL=AutoBeTokenUsageComponent.js.map

package/lib/agent/src/context/AutoBeTokenUsageComponent.js.map

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

package/lib/agent/src/context/IAutoBeApplication.d.ts

@@ -0,0 +1,107 @@
+import { IAutoBeApplicationProps } from "./IAutoBeApplicationProps";
+import { IAutoBeApplicationResult } from "./IAutoBeApplicationResult";
+/**
+ * Application for AutoBE function calling.
+ *
+ * @author Samchon
+ */
+export interface IAutoBeApplication {
+    /**
+     * Run Analyze Agent.
+     *
+     * Executes the Analyze agent to process user requirements and generate a
+     * structured specification document. This agent analyzes all conversation
+     * history between users and AI, separates business logic from technical
+     * requirements, and establishes development priorities and scope.
+     *
+     * **IMPORTANT**: Only call this function when sufficient requirements have
+     * been discussed to generate a comprehensive specification. The context must
+     * contain enough detail about the system's purpose, core features, data
+     * models, and business rules. If requirements are unclear or incomplete,
+     * continue gathering information through conversation instead.
+     *
+     * The agent will automatically generate follow-up questions for any ambiguous
+     * requirements and continuously refine its understanding through iterative
+     * conversation. When executed after other agents have generated code, it can
+     * also interpret change requests in the context of existing implementations.
+     */
+    analyze(props: IAutoBeApplicationProps): Promise<IAutoBeApplicationResult>;
+    /**
+     * Run prisma agent.
+     *
+     * Executes the Prisma agent to generate database schema files and ERD
+     * documentation. This agent reads the requirements specification created by
+     * the {@link analyze Analyze agent} and produces a complete Prisma schema with
+     * comprehensive documentation for each entity and attribute.
+     *
+     * **PREREQUISITE**: Only call this function after the {@link analyze} function
+     * has been successfully executed and a requirements specification document
+     * has been generated. The Prisma agent depends on the structured requirements
+     * analysis to design the database schema properly. Without a completed
+     * requirements specification, this function should NOT be called.
+     *
+     * The agent will automatically validate the generated schema using the Prisma
+     * compiler, self-correct any compilation errors through feedback loops, and
+     * generate ERD documentation using prisma-markdown. An internal review
+     * process ensures schema quality and optimization.
+     */
+    prisma(props: IAutoBeApplicationProps): Promise<IAutoBeApplicationResult>;
+    /**
+     * Run interface agent.
+     *
+     * Executes the Interface agent to design and generate API interfaces. This
+     * agent creates OpenAPI schemas and TypeScript/NestJS code based on the
+     * requirements specification and ERD documentation from previous agents.
+     *
+     * The agent follows a sophisticated pipeline: first constructing formal
+     * OpenAPI Operation Schemas and JSON Schemas, then validating these schemas,
+     * and finally transforming them into NestJS controllers and DTOs. Each
+     * generated interface includes comprehensive JSDoc comments and undergoes
+     * internal review for consistency.
+     */
+    interface(props: IAutoBeApplicationProps): Promise<IAutoBeApplicationResult>;
+    /**
+     * Run test program agent.
+     *
+     * Executes the Test agent to generate comprehensive E2E test suites for all
+     * {@link interface API interfaces}. This agent synthesizes outputs from
+     * previous agents to create tests that validate both individual endpoints and
+     * their interactions.
+     *
+     * **PREREQUISITE**: Only call this function after the {@link interface}
+     * function has been successfully executed and API interfaces have been
+     * generated. The Test agent requires the completed API interface definitions,
+     * OpenAPI schemas, and TypeScript code to generate appropriate test
+     * scenarios. Without completed interface design, this function should NOT be
+     * called.
+     *
+     * The agent will analyze dependency relationships between API functions,
+     * structure integrated test scenarios with correct execution sequences, and
+     * enhance pre-generated test scaffolds with business logic validation.
+     * TypeScript compiler validation and internal review ensure test quality and
+     * optimal coverage.
+     */
+    test(props: IAutoBeApplicationProps): Promise<IAutoBeApplicationResult>;
+    /**
+     * Run realize agent.
+     *
+     * Executes the Realize agent to implement the actual business logic for each
+     * API endpoint. This agent synthesizes all outputs from previous agents to
+     * generate fully functional service provider code.
+     *
+     * **PREREQUISITE**: Only call this function after the {@link interface}
+     * function has been successfully executed and API interfaces have been
+     * generated. The Realize agent requires the completed API interface
+     * definitions to implement the corresponding service logic. It also benefits
+     * from having test code available for validation. Without completed interface
+     * design, this function should NOT be called.
+     *
+     * The agent will create service implementations with multiple validation
+     * layers: TypeScript compiler feedback, runtime validation through test
+     * execution, and quality optimization through internal review. The generated
+     * code handles database interactions through Prisma, implements security and
+     * validation checks, and processes business rules according to
+     * specifications.
+     */
+    realize(props: IAutoBeApplicationProps): Promise<IAutoBeApplicationResult>;
+}

package/lib/agent/src/context/IAutoBeApplication.js.map

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

package/lib/agent/src/context/IAutoBeApplicationProps.d.ts

@@ -0,0 +1,4 @@
+export interface IAutoBeApplicationProps {
+    /** The reason of the function call. */
+    reason: string;
+}

package/lib/agent/src/context/IAutoBeApplicationProps.js.map

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

package/lib/agent/src/context/IAutoBeApplicationResult.d.ts

@@ -0,0 +1,4 @@
+export interface IAutoBeApplicationResult {
+    type: "success" | "failure" | "exception" | "in-progress" | "prerequisites-not-satisfied";
+    description: string;
+}

package/lib/agent/src/context/IAutoBeApplicationResult.js.map

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

package/lib/agent/src/context/assertSchemaModel.d.ts

@@ -0,0 +1,2 @@
+import { ILlmSchema } from "@samchon/openapi";
+export declare function assertSchemaModel<Model extends ILlmSchema.Model>(model: Model): asserts model is Exclude<Model, "gemini" | "3.0">;

package/lib/agent/src/context/assertSchemaModel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertSchemaModel.js","sourceRoot":"","sources":["../../../../src/context/assertSchemaModel.ts"],"names":[],"mappings":";;AAEA,8CAcC;AAdD,SAAgB,iBAAiB,CAC/B,KAAY;IAEZ,IAAI,KAAK,KAAK,QAAQ;QACpB,MAAM,IAAI,KAAK,CACb;YACE,6DAA6D;YAC7D,gEAAgE;YAChE,+EAA+E;YAC/E,gEAAgE;YAChE,kEAAkE;YAClE,2CAA2C;SAC5C,CAAC,IAAI,CAAC,GAAG,CAAC,CACZ,CAAC;AACN,CAAC"}

package/lib/agent/src/factory/consentFunctionCall.d.ts

@@ -0,0 +1,10 @@
+import { AutoBeEvent, AutoBeEventSource } from "@autobe/interface";
+import { IAutoBeConfig } from "../structures/IAutoBeConfig";
+import { IAutoBeVendor } from "../structures/IAutoBeVendor";
+export declare const consentFunctionCall: (props: {
+    dispatch: (event: AutoBeEvent) => void;
+    source: AutoBeEventSource;
+    config: IAutoBeConfig;
+    vendor: IAutoBeVendor;
+    assistantMessage: string;
+}) => Promise<string | null>;