@calljmp/cli/src/common/agent.d.ts

Calljmp CLI

import { ServiceError } from './error';
import { DurationLiteral } from './time';
export interface AgentConfig {
    name: string;
    description: string;
    forms?: {
        inputSchema?: Record<string, unknown>;
    };
}
export interface AgentPhaseConfig {
    name: string;
    description?: string;
    scope?: Record<string, unknown>;
}
export interface AgentRetryOptions {
    retries?: number;
    delay?: number;
    backoff?: 'exponential' | 'linear';
    onError?: (error: Error, attempt: number) => void;
}
export interface AgentParallelOptions {
    concurrency?: number;
}
export interface AgentSuspendOptions {
    reason?: string;
    timeout?: number | 'indefinite' | DurationLiteral;
    scope?: Record<string, unknown>;
}
export declare enum AgentStatus {
    Pending = "pending",
    Running = "running",
    Completed = "completed",
    Failed = "failed",
    Suspended = "suspended",
    Canceled = "canceled"
}
export interface AgentPendingData {
}
export interface AgentRunningData {
}
export interface AgentCompletedData {
    [key: string]: any;
}
export interface AgentFailedData {
    message: string;
}
export interface AgentSuspendedData {
    reason?: string;
    timeout?: number;
    resumption: string;
}
export interface AgentCanceledData {
}
export type AgentStatusData = AgentPendingData | AgentRunningData | AgentCompletedData | AgentFailedData | AgentSuspendedData | AgentCanceledData;
export interface AgentConstraints {
    agent: {
        maxRequests: number;
    };
    execution: {
        maxRuntimeSeconds: number;
    };
    workflows: {
        maxPhases: number;
    };
    web: {
        maxScrapes: number;
    };
    llm: {
        maxNeurons: number;
    };
    datasets: {
        maxQueries: number;
    };
}
export declare enum AgentType {
    Permanent = "permanent",
    Ephemeral = "ephemeral"
}
export interface Agent {
    id: number;
    projectId: number;
    deploymentId: string;
    type: AgentType;
    version: number;
    name: string;
    description: string | null;
    createdAt: Date;
    updatedAt: Date;
    lastInvocationAt: Date | null;
    invocationKey: string | null;
    webhookEndpoint: string | null;
    eventKey: string | null;
    lookupKey: string | null;
}
export interface AgentRun {
    agentId: string;
    runId: string;
    status: AgentStatus;
    data: AgentStatusData | null;
    createdAt: Date;
    updatedAt: Date;
}
export declare function jsonToAgentRun(json: Record<string, any>): AgentRun;
export declare function agentRunToJson(agentRun: AgentRun): {
    agentId: string;
    runId: string;
    status: AgentStatus;
    data: AgentStatusData | null;
    createdAt: string;
    updatedAt: string;
};
export declare function jsonToAgent(json: Record<string, any>): Agent;
export declare function agentToJson(agent: Agent): {
    id: number;
    projectId: number;
    deploymentId: string;
    type: AgentType;
    version: number;
    name: string;
    description: string | null;
    createdAt: string;
    updatedAt: string;
    lastInvocationAt: string | null;
    invocationKey: string | null;
    webhookEndpoint: string | null;
    eventKey: string | null;
    lookupKey: string | null;
};
export declare enum AgentAnalyticsEventType {
    ConsoleLog = "console_log",
    AgentStart = "agent_start",
    AgentComplete = "agent_complete",
    AgentError = "agent_error",
    AgentSuspend = "agent_suspend",
    AgentResume = "agent_resume",
    PhaseStart = "phase_start",
    PhaseComplete = "phase_complete",
    PhaseError = "phase_error"
}
interface BaseAgentAnalyticsEvent {
    id: string;
    projectId: number;
    createdAt: Date;
    agentId: string;
    runId: string;
    eventType: AgentAnalyticsEventType;
    payload: Record<string, any>;
    order: number;
}
export type AgentAnalyticsConsoleLogLevel = 'debug' | 'info' | 'warn' | 'error';
export interface AgentAnalyticsConsoleLogEvent extends BaseAgentAnalyticsEvent {
    eventType: AgentAnalyticsEventType.ConsoleLog;
    payload: {
        level: AgentAnalyticsConsoleLogLevel;
        message: string;
        args: unknown[];
    };
}
export interface AgentAnalyticsAgentStartEvent extends BaseAgentAnalyticsEvent {
    eventType: AgentAnalyticsEventType.AgentStart;
    payload: {
        input?: unknown;
    };
}
export interface AgentAnalyticsAgentCompleteEvent extends BaseAgentAnalyticsEvent {
    eventType: AgentAnalyticsEventType.AgentComplete;
    payload: {
        output?: unknown;
    };
}
export interface AgentAnalyticsAgentErrorEvent extends BaseAgentAnalyticsEvent {
    eventType: AgentAnalyticsEventType.AgentError;
    payload: {
        error: {
            name: string;
            message: string;
            stack?: string;
        };
    };
}
export interface AgentAnalyticsAgentSuspendEvent extends BaseAgentAnalyticsEvent {
    eventType: AgentAnalyticsEventType.AgentSuspend;
    payload: {
        reason?: string;
        timeout?: number;
        resumption: string;
    };
}
export interface AgentAnalyticsAgentResumeEvent extends BaseAgentAnalyticsEvent {
    eventType: AgentAnalyticsEventType.AgentResume;
    payload: {
        resumption: string;
    };
}
export interface AgentAnalyticsPhaseStartEvent extends BaseAgentAnalyticsEvent {
    eventType: AgentAnalyticsEventType.PhaseStart;
    payload: {
        name: string;
        description?: string;
        scope?: Record<string, unknown>;
        id: string;
        group: string;
    };
}
export interface AgentAnalyticsPhaseCompleteEvent extends BaseAgentAnalyticsEvent {
    eventType: AgentAnalyticsEventType.PhaseComplete;
    payload: {
        name: string;
        description?: string;
        scope?: Record<string, unknown>;
        output?: unknown;
        id: string;
        group: string;
    };
}
export interface AgentAnalyticsPhaseErrorEvent extends BaseAgentAnalyticsEvent {
    eventType: AgentAnalyticsEventType.PhaseError;
    payload: {
        name: string;
        description?: string;
        scope?: Record<string, unknown>;
        id: string;
        group: string;
        error: {
            name: string;
            message: string;
            stack?: string;
        };
    };
}
export type AgentAnalyticsEvent = AgentAnalyticsConsoleLogEvent | AgentAnalyticsAgentStartEvent | AgentAnalyticsAgentCompleteEvent | AgentAnalyticsAgentErrorEvent | AgentAnalyticsAgentSuspendEvent | AgentAnalyticsAgentResumeEvent | AgentAnalyticsPhaseStartEvent | AgentAnalyticsPhaseCompleteEvent | AgentAnalyticsPhaseErrorEvent;
export declare function jsonToAgentAnalyticsEvent(json: Record<string, any>): AgentAnalyticsEvent;
export declare function agentAnalyticsEventToJson(event: AgentAnalyticsEvent): {
    id: string;
    projectId: number;
    createdAt: string;
    agentId: string;
    runId: string;
    eventType: AgentAnalyticsEventType;
    payload: {
        level: AgentAnalyticsConsoleLogLevel;
        message: string;
        args: unknown[];
    } | {
        input?: unknown;
    } | {
        output?: unknown;
    } | {
        error: {
            name: string;
            message: string;
            stack?: string;
        };
    } | {
        reason?: string;
        timeout?: number;
        resumption: string;
    } | {
        resumption: string;
    } | {
        name: string;
        description?: string;
        scope?: Record<string, unknown>;
        id: string;
        group: string;
    } | {
        name: string;
        description?: string;
        scope?: Record<string, unknown>;
        output?: unknown;
        id: string;
        group: string;
    } | {
        name: string;
        description?: string;
        scope?: Record<string, unknown>;
        id: string;
        group: string;
        error: {
            name: string;
            message: string;
            stack?: string;
        };
    };
    order: number;
};
interface AgentRunBaseEvent {
    type: string;
    timestamp: Date;
}
export interface AgentRunInfoEvent extends AgentRunBaseEvent {
    type: 'info';
    id: string;
}
export interface AgentRunAnalyticsEvent extends AgentRunBaseEvent {
    type: 'analytics';
    event: AgentAnalyticsEvent;
    summary?: string;
}
export interface AgentRunErrorEvent extends AgentRunBaseEvent {
    type: 'error';
    error: ServiceError;
}
export interface AgentRunDoneEvent extends AgentRunBaseEvent {
    type: 'done';
}
export type AgentRunEvent = AgentRunInfoEvent | AgentRunAnalyticsEvent | AgentRunErrorEvent | AgentRunDoneEvent;
export declare function agentRunEventToJson(event: AgentRunEvent): {
    type: string;
    id: string;
    timestamp: string;
    event?: undefined;
    summary?: undefined;
    error?: undefined;
} | {
    type: string;
    event: {
        id: string;
        projectId: number;
        createdAt: string;
        agentId: string;
        runId: string;
        eventType: AgentAnalyticsEventType;
        payload: {
            level: AgentAnalyticsConsoleLogLevel;
            message: string;
            args: unknown[];
        } | {
            input?: unknown;
        } | {
            output?: unknown;
        } | {
            error: {
                name: string;
                message: string;
                stack?: string;
            };
        } | {
            reason?: string;
            timeout?: number;
            resumption: string;
        } | {
            resumption: string;
        } | {
            name: string;
            description?: string;
            scope?: Record<string, unknown>;
            id: string;
            group: string;
        } | {
            name: string;
            description?: string;
            scope?: Record<string, unknown>;
            output?: unknown;
            id: string;
            group: string;
        } | {
            name: string;
            description?: string;
            scope?: Record<string, unknown>;
            id: string;
            group: string;
            error: {
                name: string;
                message: string;
                stack?: string;
            };
        };
        order: number;
    };
    timestamp: string;
    summary: string | undefined;
    id?: undefined;
    error?: undefined;
} | {
    type: string;
    error: {
        message: string;
        code: import("./error").ServiceErrorCode;
    };
    timestamp: string;
    id?: undefined;
    event?: undefined;
    summary?: undefined;
} | {
    type: string;
    timestamp: string;
    id?: undefined;
    event?: undefined;
    summary?: undefined;
    error?: undefined;
};
export declare function jsonToAgentRunEvent(json: Record<string, any>): AgentRunEvent;
export interface AgentStackTraceFrame {
    line: number;
    column: number;
    source: string;
    functionName?: string;
}
export interface AgentStackTrace {
    message: string;
    name: string;
    frames: AgentStackTraceFrame[];
}
export declare function jsonToAgentStackTrace(json: Record<string, any>): AgentStackTrace;
export declare function agentStackTraceToJson(stackTrace: AgentStackTrace): Record<string, any>;
export {};
//# sourceMappingURL=agent.d.ts.map