@crewai-ts/core 0.1.2 → 0.1.5

package/dist/lite-agent.d.ts

@@ -0,0 +1,154 @@
+import { Agent, type CodeExecutionMode } from "./agent.js";
+import { type AfterLLMCallHook, type BeforeLLMCallHook } from "./hooks.js";
+import { type InputFiles } from "./input-files.js";
+import { type LLM, type LLMClient, type UsageMetrics } from "./llm.js";
+import { LiteAgentOutput } from "./lite-agent-output.js";
+import { Memory, type MemoryScope } from "./memory.js";
+import { AgentFinish } from "./agent-parser.js";
+import type { AgentStepCallback, LLMMessage, Tool } from "./types.js";
+export type LiteAgentGuardrailResult = readonly [boolean, unknown] | {
+    success: boolean;
+    result?: unknown;
+    error?: unknown;
+};
+export type LiteAgentGuardrail = (output: LiteAgentOutput) => LiteAgentGuardrailResult | Promise<LiteAgentGuardrailResult>;
+type ModelDumpOptions = {
+    mode?: string;
+    exclude?: ReadonlySet<string> | readonly string[] | Record<string, unknown>;
+};
+export type LiteAgentKickoffOptions = {
+    responseFormat?: unknown;
+    response_format?: unknown;
+    inputFiles?: InputFiles;
+    input_files?: InputFiles;
+};
+export type LiteAgentOptions = {
+    id?: string;
+    role: string;
+    goal: string;
+    backstory: string;
+    llm?: LLM | string | null;
+    tools?: readonly Tool[];
+    verbose?: boolean;
+    maxIterations?: number;
+    max_iterations?: number;
+    maxExecutionTime?: number | null;
+    max_execution_time?: number | null;
+    respectContextWindow?: boolean;
+    respect_context_window?: boolean;
+    useStopWords?: boolean;
+    use_stop_words?: boolean;
+    requestWithinRpmLimit?: (() => boolean) | null;
+    request_within_rpm_limit?: (() => boolean) | null;
+    responseFormat?: unknown;
+    response_format?: unknown;
+    guardrail?: LiteAgentGuardrail | null;
+    guardrailMaxRetries?: number;
+    guardrail_max_retries?: number;
+    memory?: Memory | MemoryScope | boolean | null;
+    stepCallback?: AgentStepCallback | null;
+    step_callback?: AgentStepCallback | null;
+    codeExecutionMode?: CodeExecutionMode;
+    code_execution_mode?: CodeExecutionMode;
+    a2a?: unknown;
+};
+export type LiteAgentKickoffInput = string | readonly LLMMessage[];
+export type LiteAgentKickoffFunction = (messages: LiteAgentKickoffInput, responseFormatOrOptions?: unknown, inputFiles?: InputFiles) => LiteAgentOutput | Promise<LiteAgentOutput>;
+export declare function _kickoff_with_a2a_support(agent: LiteAgent, original_kickoff: LiteAgentKickoffFunction, messages: LiteAgentKickoffInput, response_format?: unknown, input_files?: InputFiles | null, extension_registry?: import("./a2a.js").ExtensionRegistry): Promise<LiteAgentOutput>;
+export declare function task_to_kickoff_adapter(original_kickoff: LiteAgentKickoffFunction, messages: LiteAgentKickoffInput, response_format?: unknown, input_files?: InputFiles | null): (...args: unknown[]) => Promise<string>;
+export declare class LiteAgent {
+    readonly id: string;
+    readonly role: string;
+    readonly goal: string;
+    readonly backstory: string;
+    llm: LLM | LLMClient | string | null;
+    readonly tools: readonly Tool[];
+    readonly verbose: boolean;
+    readonly maxIterations: number;
+    readonly max_iterations: number;
+    readonly maxExecutionTime: number | null;
+    readonly max_execution_time: number | null;
+    readonly respectContextWindow: boolean;
+    readonly respect_context_window: boolean;
+    readonly useStopWords: boolean;
+    readonly use_stop_words: boolean;
+    readonly requestWithinRpmLimit: (() => boolean) | null;
+    readonly request_within_rpm_limit: (() => boolean) | null;
+    readonly responseFormat: unknown;
+    readonly response_format: unknown;
+    readonly guardrail: LiteAgentGuardrail | null;
+    readonly guardrailMaxRetries: number;
+    readonly guardrail_max_retries: number;
+    memory: Memory | MemoryScope | null;
+    readonly stepCallback: AgentStepCallback | null;
+    readonly codeExecutionMode: CodeExecutionMode;
+    readonly code_execution_mode: CodeExecutionMode;
+    readonly a2a: unknown;
+    readonly originalAgent: Agent | null;
+    readonly original_agent: Agent | null;
+    toolsResults: Record<string, unknown>[];
+    tools_results: Record<string, unknown>[];
+    private readonly _key;
+    private currentMessages;
+    private currentIterations;
+    private usageMetrics;
+    constructor(options: LiteAgentOptions);
+    get key(): string;
+    get messages(): readonly LLMMessage[];
+    get iterations(): number;
+    get _original_role(): string;
+    get beforeLlmCallHooks(): BeforeLLMCallHook[];
+    get before_llm_call_hooks(): BeforeLLMCallHook[];
+    get afterLlmCallHooks(): AfterLLMCallHook[];
+    get after_llm_call_hooks(): AfterLLMCallHook[];
+    setupLlm(): this;
+    setup_llm(): this;
+    parseTools(): this;
+    parse_tools(): this;
+    setupA2aSupport(): this;
+    setup_a2a_support(): this;
+    ensureGuardrailIsCallable(): this;
+    ensure_guardrail_is_callable(): this;
+    resolveMemory(): this;
+    resolve_memory(): this;
+    static validateGuardrailFunction(value: LiteAgentGuardrail | string | null | undefined): LiteAgentGuardrail | string | null | undefined;
+    static validate_guardrail_function(value: LiteAgentGuardrail | string | null | undefined): LiteAgentGuardrail | string | null | undefined;
+    modelDump(options?: ModelDumpOptions): Record<string, unknown>;
+    model_dump(options?: ModelDumpOptions): Record<string, unknown>;
+    kickoff(messages: LiteAgentKickoffInput, responseFormatOrOptions?: unknown, inputFiles?: InputFiles): Promise<LiteAgentOutput>;
+    kickoffAsync(messages: LiteAgentKickoffInput, responseFormatOrOptions?: unknown, inputFiles?: InputFiles): Promise<LiteAgentOutput>;
+    kickoff_async(messages: LiteAgentKickoffInput, responseFormatOrOptions?: unknown, inputFiles?: InputFiles): Promise<LiteAgentOutput>;
+    akickoff(messages: LiteAgentKickoffInput, responseFormatOrOptions?: unknown, inputFiles?: InputFiles): Promise<LiteAgentOutput>;
+    _invokeLoop(responseModel?: unknown): Promise<AgentFinish>;
+    _invoke_loop(response_model?: unknown): Promise<AgentFinish>;
+    _executeCore(agentInfo?: Record<string, unknown> | null): Promise<LiteAgentOutput>;
+    _execute_core(agent_info?: Record<string, unknown> | null): Promise<LiteAgentOutput>;
+    getUsageMetrics(): UsageMetrics;
+    get_usage_metrics(): UsageMetrics;
+    getTokenUsageSummary(): UsageMetrics;
+    get_token_usage_summary(): UsageMetrics;
+    resetUsageMetrics(): void;
+    reset_usage_metrics(): void;
+    _formatMessages(messages: LiteAgentKickoffInput, responseFormat?: unknown, inputFiles?: InputFiles): LLMMessage[];
+    _format_messages(messages: LiteAgentKickoffInput, response_format?: unknown, input_files?: InputFiles): LLMMessage[];
+    _getDefaultSystemPrompt(responseFormat?: unknown): string;
+    _get_default_system_prompt(response_format?: unknown): string;
+    _serializeResponseFormat(value: unknown): unknown;
+    _serialize_response_format(value: unknown): unknown;
+    _showLogs(formattedAnswer: unknown): void;
+    _show_logs(formatted_answer: unknown): void;
+    _getLastUserContent(): string;
+    _get_last_user_content(): string;
+    _appendMessage(message: LLMMessage): void;
+    _append_message(message: LLMMessage): void;
+    _injectMemoryContext(): void;
+    _inject_memory_context(): void;
+    _saveToMemory(outputText: string): void;
+    _save_to_memory(output_text: string): void;
+    private toolsWithMemoryTools;
+    private toAgent;
+    private agentInfo;
+    private captureStepCallback;
+    private applyGuardrail;
+}
+export {};