@parhelia/core 0.1.10745

package/dist/editor/services/agentService.d.ts

@@ -0,0 +1,306 @@
+import { Message } from "../ai/types";
+export declare const AGENT_BASE_URL = "/parhelia/agent";
+export interface StartAgentRequest {
+    agentId: string;
+    message: string;
+    sessionId: string;
+    profileId: string;
+    mode?: "autonomous" | "read-only" | "supervised";
+    model?: string;
+    /** @deprecated Use profileId instead. Kept for backward compatibility. */
+    profile?: string;
+    deterministic?: boolean;
+    seed?: number;
+    context?: any;
+}
+export interface StartAgentResponse {
+    agentId: string;
+    status: string;
+    message: string;
+    startedAt: string;
+}
+export interface AgentCostInfo {
+    total?: number;
+    input?: number;
+    output?: number;
+    cached?: number;
+    cacheWrite?: number;
+    limit?: number;
+    tokens?: {
+        total?: number;
+        input?: number;
+        output?: number;
+        cached?: number;
+        cacheWrite?: number;
+    };
+}
+export interface AgentStreamMessage {
+    type: string;
+    data: any;
+    cost?: AgentCostInfo;
+    timestamp: string;
+    error?: string;
+}
+export type AgentStreamMessageType = "statusUpdate" | "contentChunk" | "toolCall" | "toolResult" | "editOperations" | "completed" | "error" | "contextUpdate";
+export type AgentStatus = "new" | "running" | "waitingForApproval" | "closed" | "cancelled" | "completed" | "error" | "idle" | "costLimitReached" | number;
+export type Agent = {
+    id: string;
+    name: string;
+    description?: string;
+    userId: string;
+    updatedDate: string;
+    status: AgentStatus;
+    isShared?: boolean;
+    ownerName?: string;
+    profileId?: string;
+    profileName?: string;
+    profileSvgIcon?: string;
+    messageCount?: number;
+    totalCost?: number;
+    totalTokensUsed?: number;
+};
+export type AgentDetails = Agent & {
+    profileId?: string;
+    profileName: string;
+    profileSvgIcon?: string;
+    model: string;
+    createdDate: string;
+    lastMessageDate?: string;
+    totalTokensUsed: number;
+    totalInputTokens: number;
+    totalOutputTokens: number;
+    totalCachedInputTokens: number;
+    totalInputTokenCost: number;
+    totalOutputTokenCost: number;
+    totalCachedInputTokenCost: number;
+    totalCost: number;
+    currency: string;
+    messageCount: number;
+    /** Cost limit for this agent (in USD) */
+    costLimit?: number;
+    /** Agent context data (JSON string) - contains pages, componentIds, field, comment, etc. */
+    agentContext?: string;
+    messages?: AgentChatMessage[];
+};
+export declare function approveToolCall(params: {
+    agentId: string;
+    messageId: string;
+    toolCallId: string;
+    note?: string;
+}): Promise<{
+    success: boolean;
+}>;
+export declare function rejectToolCall(params: {
+    agentId: string;
+    messageId: string;
+    toolCallId: string;
+    note?: string;
+}): Promise<{
+    success: boolean;
+}>;
+export type AgentContextData = {
+    selection?: string[];
+    selectedText?: string;
+    items?: Array<{
+        id: string;
+        language: string;
+        version: number;
+        path?: string;
+        name?: string;
+        createdByAgent?: boolean;
+    }>;
+    /** Component context with page information per component */
+    components?: Array<{
+        componentId: string;
+        pageItem: {
+            id: string;
+            language: string;
+            version: number;
+            path?: string;
+            name?: string;
+        };
+    }>;
+    field?: {
+        fieldId: string;
+        fieldName?: string;
+        item?: {
+            id: string;
+            language: string;
+            version: number;
+            path?: string;
+            name?: string;
+        };
+    };
+    comment?: {
+        id: string;
+        text?: string;
+        fieldName?: string;
+        itemName?: string;
+        author?: string;
+        selectedText?: string;
+        rangeStart?: number;
+        rangeEnd?: number;
+    };
+    mode?: "autonomous" | "read-only" | "supervised";
+    profile?: string;
+    additionalData?: Record<string, any>;
+};
+export type AgentMetadata = AgentContextData;
+export interface AgentChatMessage {
+    id: string;
+    agentId: string;
+    messageIndex: number;
+    role: string;
+    content: string;
+    name: string;
+    toolCallId?: string;
+    messageType: string;
+    isCompleted: boolean;
+    model: string;
+    tokensUsed: number;
+    inputTokens: number;
+    outputTokens: number;
+    cachedInputTokens: number;
+    inputTokenCost: number;
+    outputTokenCost: number;
+    cachedInputTokenCost: number;
+    totalCost: number;
+    currency: string;
+    responseTimeMs?: number;
+    createdDate: string;
+    editOperations?: string;
+    longRunningTaskIds?: string;
+    metadata?: string;
+    toolCalls?: AgentChatToolCall[];
+}
+export interface AgentChatToolCall {
+    id: string;
+    messageId: string;
+    toolCallId: string;
+    functionName: string;
+    functionArguments: string;
+    functionResult?: string;
+    functionError?: string;
+    isCompleted: boolean;
+    responseTimeMs?: number;
+    createdDate: string;
+}
+/**
+ * Starts an agent execution and returns immediately
+ */
+export declare function startAgent(request: StartAgentRequest): Promise<StartAgentResponse>;
+/**
+ * Connects to an agent's real-time stream using Server-Sent Events
+ */
+export declare function connectToAgentStream(agentId: string, onMessage: (message: AgentStreamMessage) => void, signal?: AbortSignal, clientSessionId?: string): Promise<void>;
+/**
+ * Gets the current status of an agent execution
+ */
+export declare function getAgentStatus(agentId: string): Promise<any>;
+/**
+ * Gets all currently running agents for monitoring
+ */
+export declare function getRunningAgents(): Promise<any>;
+/**
+ * Gets a single agent by ID with complete message history and cost information
+ */
+export declare function getAgent(agentId: string): Promise<AgentDetails>;
+export interface GetAgentsParams {
+    skip?: number;
+    limit?: number;
+    includeShared?: boolean;
+    includeOwned?: boolean;
+    searchTerm?: string;
+    excludeClosed?: boolean;
+}
+export interface GetAgentsResponse {
+    agents: Agent[];
+    totalCount: number;
+    hasMore: boolean;
+}
+export interface ProfileAgentsGroup {
+    profileId: string | null;
+    profileName: string;
+    profileSvgIcon?: string;
+    totalClosedCount: number;
+    agents: Agent[];
+}
+export interface GetAgentsGroupedResponse {
+    activeAgents: Agent[];
+    closedAgentsByProfile: ProfileAgentsGroup[];
+}
+/**
+ * Gets all agents for the current user with pagination and search support
+ */
+export declare function getActiveAgents(params?: GetAgentsParams): Promise<GetAgentsResponse>;
+/**
+ * Gets all active agents and closed agents grouped by profile for the current user
+ */
+export declare function getAgentsGrouped(searchTerm?: string, includeShared?: boolean, includeOwned?: boolean): Promise<GetAgentsGroupedResponse>;
+/**
+ * Gets more closed agents for a specific profile
+ */
+export declare function getClosedAgentsByProfile(profileId: string, skip: number, limit: number, searchTerm?: string): Promise<GetAgentsResponse>;
+/**
+ * Gets all closed agents for the current user
+ * @deprecated Use getActiveAgents() instead - the backend now returns all agents (including closed) by default
+ */
+export declare function getClosedAgents(limit?: number): Promise<Agent[]>;
+/**
+ * Gets all non-closed agents across all users (admin only)
+ */
+export declare function getAllAgents(limit?: number): Promise<AgentDetails[]>;
+/**
+ * Cancels a running agent execution
+ */
+export declare function cancelAgent(agentId: string): Promise<any>;
+/**
+ * Permanently deletes an agent and all its messages
+ */
+export declare function deleteAgent(agentId: string): Promise<any>;
+/**
+ * Closes an agent by canceling execution and setting status to closed
+ */
+export declare function closeAgent(agentId: string): Promise<any>;
+/**
+ * Updates the selected model for an agent chat (persists to DB)
+ */
+/**
+ * Updates agent settings like model name and mode in one call.
+ */
+export declare function updateAgentSettings(agentId: string, settings: {
+    model?: string | null;
+    mode?: "autonomous" | "read-only" | "supervised" | string | null;
+    profileId?: string | null;
+    profileName?: string | null;
+}): Promise<{
+    success: boolean;
+    updates?: {
+        model: boolean;
+        mode: boolean;
+    };
+}>;
+/**
+ * Updates the metadata (context) for an agent chat
+ */
+export declare function updateAgentContext(agentId: string, metadata: AgentMetadata): Promise<{
+    success: boolean;
+}>;
+export declare function updateAgentCostLimit(agentId: string, action: "extend" | "set", amount?: number): Promise<{
+    success: boolean;
+    costLimit?: number;
+    initialCostLimit?: number;
+}>;
+/**
+ * Checks if an agent exists and returns its current state with messages
+ */
+export declare function checkAgentState(agentId: string): Promise<{
+    exists: boolean;
+    agent?: Agent;
+    isRunning: boolean;
+}>;
+/**
+ * Converts persisted agent messages to a unified UI message format
+ */
+export declare function convertAgentMessagesToTerminalFormat(agentMessages: AgentChatMessage[]): Message[];
+export declare function canonicalizeAgentMetadata(meta: AgentMetadata | any): AgentContextData;