@parhelia/core 0.1.12556 → 0.1.12565

package/dist/editor/services/agentErrorMessage.js

@@ -0,0 +1,91 @@
+function decodeHtmlEntities(value) {
+    if (typeof document === "undefined") {
+        return value;
+    }
+    const textarea = document.createElement("textarea");
+    textarea.innerHTML = value;
+    return textarea.value;
+}
+function isRecord(value) {
+    return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function looksLikeJson(value) {
+    return (value.startsWith("{") || value.startsWith("[") || value.startsWith('"'));
+}
+function cleanPlainTextError(value) {
+    return decodeHtmlEntities(value)
+        .replace(/^Failed to start agent:\s*/i, "")
+        .replace(/^Unknown error\s*/i, "")
+        .replace(/^Error:\s*/i, "")
+        .replace(/^Error\s+/i, "")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+function extractAgentErrorMessage(value, depth) {
+    if (depth > 8 || value === undefined || value === null) {
+        return "";
+    }
+    if (typeof value === "string") {
+        const normalized = decodeHtmlEntities(value.replace(/<br\s*\/?>/gi, "\n")).trim();
+        if (!normalized) {
+            return "";
+        }
+        const jsonCandidate = normalized
+            .replace(/^Failed to start agent:\s*/i, "")
+            .replace(/^Error:\s*/i, "")
+            .trim();
+        if (looksLikeJson(jsonCandidate)) {
+            try {
+                const parsed = JSON.parse(jsonCandidate);
+                const structuredMessage = extractAgentErrorMessage(parsed, depth + 1);
+                if (structuredMessage) {
+                    return structuredMessage;
+                }
+            }
+            catch {
+                // Fall through to plain-text cleanup when the provider error isn't valid JSON.
+            }
+        }
+        const firstMeaningfulLine = normalized
+            .split(/\r?\n/)
+            .map((line) => cleanPlainTextError(line.trim()))
+            .find(Boolean);
+        return firstMeaningfulLine || cleanPlainTextError(normalized);
+    }
+    if (Array.isArray(value)) {
+        for (const entry of value) {
+            const extracted = extractAgentErrorMessage(entry, depth + 1);
+            if (extracted) {
+                return extracted;
+            }
+        }
+        return "";
+    }
+    if (isRecord(value)) {
+        const metadata = isRecord(value.metadata) ? value.metadata : null;
+        const candidates = [
+            metadata?.raw,
+            value.raw,
+            value.error,
+            value.message,
+            value.detail,
+            value.error_description,
+            value.description,
+            value.title,
+            value.summary,
+            value.reason,
+        ];
+        for (const candidate of candidates) {
+            const extracted = extractAgentErrorMessage(candidate, depth + 1);
+            if (extracted) {
+                return extracted;
+            }
+        }
+        return "";
+    }
+    return cleanPlainTextError(String(value));
+}
+export function toUserFacingAgentErrorMessage(value) {
+    return extractAgentErrorMessage(value, 0);
+}
+//# sourceMappingURL=agentErrorMessage.js.map

package/dist/editor/services/agentErrorMessage.js.map

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

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

@@ -1,4 +1,6 @@
+import type { AgentStatus } from "./agentStatus";
 export declare const AGENT_BASE_URL = "/parhelia/agent";
+export type { AgentStatus } from "./agentStatus";
 export interface StartAgentRequest {
     agentId: string;
     message: string;
@@ -6,13 +8,11 @@ export interface StartAgentRequest {
     profileId: string;
     mode?: "autonomous" | "read-only" | "supervised";
     model?: string;
-    deterministic?: boolean;
-    seed?: number;
     context?: any;
 }
 export interface StartAgentResponse {
     agentId: string;
-    status: string;
+    status: AgentStatus;
     message: string;
     startedAt: string;
 }
@@ -22,6 +22,8 @@ export interface AgentCostInfo {
     output?: number;
     cached?: number;
     cacheWrite?: number;
+    imageCost?: number;
+    totalImageCost?: number;
     limit?: number;
     tokens?: {
         total?: number;
@@ -40,8 +42,7 @@ export interface AgentStreamMessage {
     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 AgentStreamMessageType = "statusUpdate" | "contentChunk" | "toolCall" | "toolResult" | "editOperations" | "heartbeat" | "completed" | "error" | "contextUpdate";
 export type Agent = {
     id: string;
     name: string;
@@ -51,9 +52,13 @@ export type Agent = {
     status: AgentStatus;
     isShared?: boolean;
     ownerName?: string;
+    visibilityMode?: "Private" | "ProjectMembers" | "ExplicitMembers" | string;
+    effectiveAccessLevel?: "None" | "View" | "FullAccess" | string;
+    canManage?: boolean;
     profileId?: string;
     profileName?: string;
     profileSvgIcon?: string;
+    triggerSubscriptionCount?: number;
     messageCount?: number;
     totalCost?: number;
     totalTokensUsed?: number;
@@ -62,6 +67,8 @@ export type Agent = {
     nextRunAt?: string;
     /** ID of the parent agent if this agent was spawned from another agent */
     parentAgentId?: string;
+    /** Active skills assigned to the agent in the backend table. */
+    assignedSkillIds?: string[];
 };
 export type AgentDetails = Agent & {
     profileId?: string;
@@ -77,6 +84,7 @@ export type AgentDetails = Agent & {
     totalInputTokenCost: number;
     totalOutputTokenCost: number;
     totalCachedInputTokenCost: number;
+    totalImageCost: number;
     totalCost: number;
     currency: string;
     messageCount: number;
@@ -96,6 +104,24 @@ export type AgentDetails = Agent & {
     /** Estimated tokens used in the current context (persisted in DB) */
     contextUsedTokens?: number;
 };
+export interface AgentSkill {
+    id: string;
+    name: string;
+    disabled: boolean;
+    description?: string;
+    instructions?: string;
+    allowedAgentProfiles?: Array<{
+        id: string;
+        name: string;
+    }>;
+    additionalAllowedTools?: string[];
+}
+export interface AgentSkillCatalog {
+    skills: AgentSkill[];
+    rootIds: string[];
+    selectableTemplateIds: string[];
+}
+export declare function getAgentAvailableTools(agentId: string): Promise<string[]>;
 export declare function approveToolCall(params: {
     agentId: string;
     messageId: string;
@@ -112,6 +138,14 @@ export declare function rejectToolCall(params: {
 }): Promise<{
     success: boolean;
 }>;
+export declare function createOperationAllowance(params: {
+    agentId: string;
+    itemId: string;
+    operationType: string;
+    scopeType: "itemSubtree";
+}): Promise<{
+    success: boolean;
+}>;
 export type AgentContextData = {
     selection?: string[];
     selectedText?: string;
@@ -172,6 +206,19 @@ export type AgentContextData = {
     openSidebars?: string[];
     additionalData?: Record<string, any>;
 };
+export interface AgentBrowserClaim {
+    sessionId?: string;
+    browserId?: string;
+    terminalInstanceId?: string;
+    claimedAt?: string;
+}
+export interface AgentBrowserClaimResponse {
+    success: boolean;
+    message?: string;
+    claim?: AgentBrowserClaim | null;
+    claimedByCurrentSession?: boolean;
+    claimedByAnotherBrowser?: boolean;
+}
 export type AgentMetadata = AgentContextData;
 export interface AgentDocument {
     id: string;
@@ -183,6 +230,11 @@ export interface AgentDocument {
     uploadedBy: string;
     uploadedDate: string;
 }
+export declare const AGENT_DOCUMENT_UPLOADED_EVENT = "agent:document:uploaded";
+export interface AgentDocumentUploadedDetail {
+    agentId: string;
+    document: AgentDocument;
+}
 export interface AgentChatMessage {
     id: string;
     agentId: string;
@@ -219,7 +271,10 @@ export interface AgentChatToolCall {
     functionName: string;
     functionArguments: string;
     functionResult?: string;
+    functionResultRichContent?: string;
     functionError?: string;
+    isPruned?: boolean;
+    prunedAt?: string;
     isCompleted: boolean;
     responseTimeMs?: number;
     createdDate: string;
@@ -283,6 +338,107 @@ export declare function getLastPayload(agentId: string): Promise<{
     payload: string;
     rawResponse: string;
 }>;
+export interface AgentDiagnosticsEvent {
+    timestamp: string;
+    kind: string;
+    messageType: string;
+    detail?: string | null;
+    seq?: number | null;
+    sessionId?: string | null;
+    deliveryStatus?: string | null;
+}
+export interface AgentDiagnosticsSessionDelivery {
+    lastAttemptAt?: string | null;
+    lastSuccessAt?: string | null;
+    lastFailureAt?: string | null;
+    lastFailureReason?: string | null;
+    lastMessageType?: string | null;
+    lastSeq?: number | null;
+    lastDeliveryStatus?: string | null;
+}
+export interface AgentDiagnosticsSession {
+    sessionId?: string | null;
+    sessionFound: boolean;
+    browserMatched: boolean;
+    isConnected: boolean;
+    isSubscribed: boolean;
+    connectedAt?: string | null;
+    lastDelivery?: AgentDiagnosticsSessionDelivery | null;
+}
+export interface AgentDiagnosticsExecution {
+    status: string;
+    startedAt?: string | null;
+    completedAt?: string | null;
+    error?: string | null;
+    isInMemoryExecution: boolean;
+    runId?: string | null;
+}
+export interface AgentDiagnosticsRunRequest {
+    requestedAt?: string | null;
+    source?: string | null;
+    detail?: string | null;
+}
+export interface AgentDiagnosticsCancellation {
+    requestedAt?: string | null;
+    source?: string | null;
+    reason?: string | null;
+    requestedBy?: string | null;
+    detail?: string | null;
+    observedAt?: string | null;
+    observedSource?: string | null;
+    observedDetail?: string | null;
+}
+export interface AgentDiagnosticsTransport {
+    lastMessageType?: string | null;
+    lastDeltaType?: string | null;
+    lastStatusState?: string | null;
+    lastLifecycleEventType?: string | null;
+    lastSeq?: number | null;
+    lastProducedAt?: string | null;
+    lastBroadcastAt?: string | null;
+    lastFailureAt?: string | null;
+    lastFailure?: string | null;
+    targetSessionCount: number;
+    successfulSessionCount: number;
+    failedSessionCount: number;
+    connectedSubscriberCount: number;
+    recentEvents: AgentDiagnosticsEvent[];
+}
+export interface AgentPersistentLog {
+    logId: string;
+    agentId?: string | null;
+    projectId?: string | null;
+    taskId?: string | null;
+    runId?: string | null;
+    sessionId?: string | null;
+    userId?: string | null;
+    parentAgentId?: string | null;
+    messageId?: string | null;
+    toolCallId?: string | null;
+    eventType?: string | null;
+    stage?: string | null;
+    status?: string | null;
+    source?: string | null;
+    seq?: number | null;
+    summary?: string | null;
+    payloadPreview?: string | null;
+    resultPreview?: string | null;
+    metadataJson?: string | null;
+    durationMs?: number | null;
+    success?: boolean | null;
+    error?: string | null;
+    createdAt: string;
+}
+export interface AgentDiagnosticsResponse {
+    agentId: string;
+    execution: AgentDiagnosticsExecution;
+    transport: AgentDiagnosticsTransport;
+    currentSession: AgentDiagnosticsSession;
+    lastRunRequest?: AgentDiagnosticsRunRequest | null;
+    lastCancellation?: AgentDiagnosticsCancellation | null;
+    persistentLogs: AgentPersistentLog[];
+}
+export declare function getAgentDiagnostics(agentId: string, sessionId?: string): Promise<AgentDiagnosticsResponse>;
 export interface GetAgentsParams {
     skip?: number;
     limit?: number;
@@ -290,6 +446,7 @@ export interface GetAgentsParams {
     includeOwned?: boolean;
     searchTerm?: string;
     excludeClosed?: boolean;
+    signal?: AbortSignal;
 }
 export interface GetAgentsResponse {
     agents: Agent[];
@@ -359,6 +516,38 @@ export declare function updateAgentSettings(agentId: string, settings: {
 export declare function updateAgentContext(agentId: string, metadata: AgentMetadata): Promise<{
     success: boolean;
 }>;
+export declare function persistDraftAgent(params: {
+    agentId: string;
+    sessionId?: string;
+    profileId: string;
+    mode?: "autonomous" | "read-only" | "supervised" | string | null;
+    model?: string | null;
+    name?: string;
+    context?: AgentMetadata | null;
+}): Promise<AgentDetails>;
+export declare function assignAgentSkill(params: {
+    agentId: string;
+    skillId: string;
+}): Promise<{
+    success: boolean;
+}>;
+export declare function revokeAgentSkill(params: {
+    agentId: string;
+    skillId: string;
+}): Promise<{
+    success: boolean;
+}>;
+export declare function claimAgentBrowser(params: {
+    agentId: string;
+    sessionId: string;
+    takeOver?: boolean;
+    terminalInstanceId?: string;
+}): Promise<AgentBrowserClaimResponse>;
+export declare function releaseAgentBrowser(params: {
+    agentId: string;
+    sessionId: string;
+    terminalInstanceId?: string;
+}): Promise<AgentBrowserClaimResponse>;
 export declare function updateAgentCostLimit(agentId: string, action: "extend" | "set", amount?: number): Promise<{
     success: boolean;
     costLimit?: number;
@@ -373,6 +562,8 @@ export declare function uploadDocument(agentId: string, file: File, profileId?:
     document?: AgentDocument;
     error?: string;
 }>;
+export declare function getAgentSkillCatalog(includeDisabled?: boolean): Promise<AgentSkillCatalog>;
+export declare function getAgentSkills(includeDisabled?: boolean): Promise<AgentSkill[]>;
 /**
  * Gets all documents for an agent
  */
@@ -406,8 +597,41 @@ export interface QueuedPrompt {
     scheduledFor?: string | null;
     processedDate?: string | null;
 }
+export interface AgentTriggerSubscription {
+    id: string;
+    agentId: string;
+    triggerName: string;
+    filter?: string | null;
+    isActive: boolean;
+    createdAtUtc: string;
+}
+export interface AgentSitecoreAllowance {
+    itemId: string;
+    itemPath: string;
+    operationType: string;
+    scopeType: string;
+    source?: string | null;
+    grantedBy?: string | null;
+    grantedAt?: string | null;
+}
+export interface AgentFilesystemAllowance {
+    normalizedPath: string;
+    operationType: string;
+    source?: string | null;
+    grantedBy?: string | null;
+    grantedAt?: string | null;
+}
+export interface AgentOperationAllowancesResponse {
+    sitecore: AgentSitecoreAllowance[];
+    filesystem: AgentFilesystemAllowance[];
+}
 /**
  * Gets pending queued prompts for an agent
  */
 export declare function getPendingPrompts(agentId: string): Promise<QueuedPrompt[]>;
+/**
+ * Gets trigger subscriptions for an agent
+ */
+export declare function getAgentTriggerSubscriptions(agentId: string): Promise<AgentTriggerSubscription[]>;
+export declare function getAgentOperationAllowances(agentId: string): Promise<AgentOperationAllowancesResponse>;
 export declare function canonicalizeAgentMetadata(meta: AgentMetadata | any): AgentContextData;