Skip Proxy Agent

This agent provides a simple proxy to the Skip SaaS API, allowing Skip to be invoked through the standard MJ agent framework. It handles:

  • Converting MJ conversation messages to Skip format
  • Streaming progress updates from Skip
  • Mapping Skip responses to MJ agent next steps
  • Returning full Skip responses in the payload

Hierarchy

  • BaseAgent
    • SkipProxyAgent

Constructors

Properties

Accessors

Methods

Execute ExecuteSingleAction ExecuteSubAgent GetConfigurationPresets GetDefaultConfigurationPreset InjectContextMemory applyActionChanges applyResponseTypeAutoAlignment attemptContextRecovery buildAgentTypePromptParams checkExecutionGuardrails checkMinimumExecutionRequirements compactMessage contentToString convertMessagesToSkipFormat convertUIMarkupInMessages createActionResultMessage createCompactionStep createSubAgentResultMessage determineNextStep doesChangeScopeApply emitMessageLifecycleEvent estimateConversationTokens estimateTokens executeAgentInternal executeExpandMessageStep executeNextStep executePrompt extractSchemaDefaults filterActionChangesForSubAgent getActionExecutionCount getAgentPromptParameters getAgentPromptParametersJSON getEffectiveActionsForValidation getModelContextLimit getSubAgentExecutionCount getSystemDefaultCompactPromptId getValueFromPath handleFinalPayloadValidationFailure handleStartingPayloadValidation hasExceededAgentRunGuardrails initializeAgentType initializeEngines initializeStartingPayload isConfigurationError isFatalPromptError loadAgentConfiguration loadMessagesFromDatabase logError logStatus mapSkipResponseToNextStep preparePromptParams prepareSubAgentMessages processNextStep pruneAndCompactExpiredMessages recoveryStrategy_CompactAllActionResults recoveryStrategy_CompactOldActionResults recoveryStrategy_RemoveOldestActionResults recoveryStrategy_TrimLastUserMessage resolveTemplates resolveValueFromContext serializePayloadAtEnd serializePayloadAtStart smartTrimContent tempHack updateCompactionStep validateActionInAgent validateActionsNextStep validateAgent validateChatNextStep validateFailedNextStep validateNextStep validateRetryNextStep validateSubAgentInAgent validateSubAgentNextStep validateSuccessNextStep

Constructors

Properties

skipSDK: SkipSDK

Accessors

  • get AgentRun(): AIAgentRunEntityExtended
  • Returns AIAgentRunEntityExtended

  • get AgentTypeInstance(): BaseAgentType
  • Returns BaseAgentType

  • get AgentTypeState(): any
  • Returns any

  • get ValidationRetryCount(): number
  • Returns number

Methods

  • Type Parameters

    • C = any
    • R = any

    Parameters

    • params: ExecuteAgentParams<C>

    Returns Promise<ExecuteAgentResult<R>>

  • Parameters

    Returns Promise<ActionResult>

  • Type Parameters

    • SC = any
    • SR = any

    Parameters

    • params: ExecuteAgentParams<SC>
    • subAgentRequest: AgentSubAgentRequest<SC>
    • subAgent: AIAgentEntityExtended
    • stepEntity: AIAgentRunStepEntityExtended
    • Optional payload: SR
    • Optional contextMessage: ChatMessage
    • Optional stepCount: number

    Returns Promise<ExecuteAgentResult<SR>>

  • Parameters

    • input: string
    • agent: AIAgentEntityExtended
    • Optional userId: string
    • Optional companyId: string
    • Optional contextUser: UserInfo
    • Optional conversationMessages: ChatMessage[]

    Returns Promise<{
        examples: AIAgentExampleEntity[];
        notes: AIAgentNoteEntity[];
    }>

  • Parameters

    Returns {
        actions: ActionEntityExtended[];
        dynamicLimits: Record<string, number>;
    }

  • Parameters

    • params: Record<string, unknown>
    • Optional explicitResponseType: Record<string, unknown>

    Returns void

  • Type Parameters

    • P

    Parameters

    • params: ExecuteAgentParams
    • payload: P
    • errorMessage: string
    • Optional modelSelectionInfo: AIModelSelectionInfo

    Returns Promise<BaseAgentNextStep<P>>

  • Parameters

    • agentType: AIAgentTypeEntity
    • agent: AIAgentEntityExtended
    • Optional runtimeOverrides: Record<string, unknown>

    Returns Record<string, unknown>

  • Type Parameters

    • P

    Parameters

    • params: ExecuteAgentParams
    • nextStep: BaseAgentNextStep<P>
    • currentPayload: P
    • agentRun: AIAgentRunEntityExtended
    • currentStep: AIAgentRunStepEntityExtended

    Returns Promise<BaseAgentNextStep<P>>

  • Parameters

    • agent: AIAgentEntityExtended
    • agentRun: AIAgentRunEntityExtended

    Returns Promise<string[]>

  • Parameters

    • message: AgentChatMessage
    • metadata: {
          compactLength: number;
          compactMode: "First N Chars" | "AI Summary";
          compactPromptId: string;
          originalLength: number;
      }
      • compactLength: number
      • compactMode: "First N Chars" | "AI Summary"
      • compactPromptId: string
      • originalLength: number
    • params: ExecuteAgentParams

    Returns Promise<string>

  • Parameters

    Returns string

  • Parameters

    Returns void

  • Parameters

    Returns ChatMessage

  • Parameters

    • prompt: AIPromptEntityExtended
    • message: AgentChatMessage
    • params: ExecuteAgentParams

    Returns Promise<AIAgentRunStepEntityExtended>

  • Parameters

    • subAgent: AgentSubAgentRequest
    • result: ExecuteAgentResult

    Returns ChatMessage

  • Type Parameters

    • P

    Parameters

    • params: ExecuteAgentParams
    • agentType: AIAgentTypeEntity
    • promptResult: AIPromptRunResult<unknown>
    • currentPayload: P

    Returns Promise<BaseAgentNextStep<P>>

  • Parameters

    • scope: ActionChangeScope
    • agentId: string
    • isRoot: boolean
    • Optional agentIds: string[]

    Returns boolean

  • Parameters

    • event: MessageLifecycleEvent

    Returns void

  • Parameters

    Returns number

  • Parameters

    Returns number

  • Execute the Skip agent - proxies to Skip SaaS API

    Type Parameters

    Parameters

    Returns Promise<{
        finalStep: BaseAgentNextStep<P>;
        stepCount: number;
    }>

  • Parameters

    • request: BaseAgentNextStep
    • params: ExecuteAgentParams
    • currentTurn: number

    Returns void

  • Type Parameters

    • P = any

    Parameters

    • params: ExecuteAgentParams
    • config: AgentConfiguration
    • previousDecision: BaseAgentNextStep<P>
    • Optional stepCount: number

    Returns Promise<BaseAgentNextStep<P>>

  • Parameters

    • promptParams: AIPromptParams

    Returns Promise<AIPromptRunResult<unknown>>

  • Parameters

    • schemaJson: string

    Returns Record<string, unknown>

  • Parameters

    • actionChanges: ActionChange[]

    Returns ActionChange[]

  • Parameters

    • agentRunId: string
    • actionId: string

    Returns Promise<number>

  • Parameters

    • agent: AIAgentEntityExtended

    Returns TemplateParamEntity[]

  • Parameters

    • agent: AIAgentEntityExtended

    Returns string

  • Parameters

    • agentId: string

    Returns ActionEntityExtended[]

  • Parameters

    • Optional modelSelectionInfo: AIModelSelectionInfo

    Returns number

  • Parameters

    • agentRunId: string
    • subAgentId: string

    Returns Promise<number>

  • Returns string

  • Parameters

    • obj: any
    • path: string

    Returns unknown

  • Type Parameters

    • P

    Parameters

    • params: ExecuteAgentParams
    • nextStep: BaseAgentNextStep<P>
    • currentPayload: P
    • mode: string
    • errorMessages: string[]
    • agentRun: AIAgentRunEntityExtended
    • currentStep: AIAgentRunStepEntityExtended

    Returns Promise<BaseAgentNextStep<P>>

  • Type Parameters

    • P = any

    Parameters

    • params: ExecuteAgentParams<any, P>

    Returns Promise<ExecuteAgentResult>

  • Parameters

    • params: ExecuteAgentParams
    • agentRun: AIAgentRunEntityExtended

    Returns Promise<{
        current?: number;
        exceeded: boolean;
        limit?: number;
        reason?: string;
        type?: "time" | "cost" | "tokens" | "iterations";
    }>

  • Parameters

    • params: ExecuteAgentParams
    • config: AgentConfiguration

    Returns Promise<void>

  • Parameters

    Returns Promise<void>

  • Type Parameters

    • P = any

    Parameters

    • params: ExecuteAgentParams<any, P>

    Returns Promise<void>

  • Parameters

    • errorMessage: string
    • Optional config: AgentConfiguration

    Returns {
        detailedMessage: string;
        isConfigError: boolean;
    }

    • detailedMessage: string
    • isConfigError: boolean
  • Parameters

    • promptResult: AIPromptRunResult<unknown>

    Returns boolean

  • Parameters

    • agent: AIAgentEntityExtended

    Returns Promise<AgentConfiguration>

  • Load conversation messages from database with real UUIDs using MemberJunction's RunView pattern This is the preferred method as it ensures all messages have proper conversationDetailIDs

    Parameters

    • conversationId: string
    • contextUser: UserInfo

    Returns Promise<SkipMessage[]>

  • Parameters

    • error: string | Error
    • Optional options: {
          agent?: AIAgentEntityExtended;
          agentType?: AIAgentTypeEntity;
          category?: string;
          metadata?: Record<string, any>;
          severity?: "error" | "warning" | "critical";
      }
      • Optional agent?: AIAgentEntityExtended
      • Optional agentType?: AIAgentTypeEntity
      • Optional category?: string
      • Optional metadata?: Record<string, any>
      • Optional severity?: "error" | "warning" | "critical"

    Returns void

  • Parameters

    • message: string
    • Optional verboseOnly: boolean
    • Optional params: ExecuteAgentParams

    Returns void

  • Type Parameters

    • P

    Parameters

    • config: AgentConfiguration
    • payload: P
    • params: ExecuteAgentParams

    Returns Promise<AIPromptParams>

  • Parameters

    • params: ExecuteAgentParams
    • subAgentRequest: AgentSubAgentRequest
    • subAgent: AIAgentEntityExtended
    • Optional contextMessage: ChatMessage

    Returns ChatMessage[]

  • Type Parameters

    • P

    Parameters

    • nextStep: BaseAgentNextStep<P>
    • params: ExecuteAgentParams
    • agentType: AIAgentTypeEntity
    • promptResult: AIPromptRunResult<unknown>
    • currentPayload: P
    • currentStep: AIAgentRunStepEntityExtended

    Returns Promise<BaseAgentNextStep<P>>

  • Parameters

    • params: ExecuteAgentParams
    • currentTurn: number

    Returns Promise<void>

  • Parameters

    • params: ExecuteAgentParams
    • tokensToSave: number

    Returns Promise<{
        strategyName: string;
        tokensSaved: number;
    }>

  • Parameters

    • params: ExecuteAgentParams
    • tokensToSave: number
    • currentStepCount: number
    • Optional minAge: number

    Returns Promise<{
        strategyName: string;
        tokensSaved: number;
    }>

  • Parameters

    • params: ExecuteAgentParams
    • tokensToSave: number
    • currentStepCount: number
    • Optional minAge: number

    Returns {
        strategyName: string;
        tokensSaved: number;
    }

    • strategyName: string
    • tokensSaved: number
  • Parameters

    • params: ExecuteAgentParams
    • tokensToSave: number

    Returns {
        strategyName: string;
        tokensSaved: number;
    }

    • strategyName: string
    • tokensSaved: number
  • Parameters

    • obj: Record<string, unknown>
    • context: Record<string, any>
    • itemVariable: string

    Returns Record<string, unknown>

  • Parameters

    • value: string
    • context: Record<string, any>
    • itemVariable: string

    Returns any

  • Parameters

    • payload: any

    Returns string

  • Parameters

    • payload: any

    Returns string

  • Parameters

    • content: string
    • Optional maxLength: number

    Returns {
        originalLength: number;
        strategy: string;
        trimmed: string;
    }

    • originalLength: number
    • strategy: string
    • trimmed: string
  • Parameters

    • step: AIAgentRunStepEntityExtended
    • result: AIPromptRunResult<{
          summary: string;
      }>
    • message: AgentChatMessage
    • params: ExecuteAgentParams

    Returns Promise<void>

  • Parameters

    • actionName: string

    Returns string

  • Type Parameters

    • P

    Parameters

    • params: ExecuteAgentParams
    • nextStep: BaseAgentNextStep<P>
    • currentPayload: P
    • agentRun: AIAgentRunEntityExtended
    • currentStep: AIAgentRunStepEntityExtended

    Returns Promise<BaseAgentNextStep<P>>

  • Parameters

    • agent: AIAgentEntityExtended

    Returns Promise<ExecuteAgentResult>

  • Type Parameters

    • P

    Parameters

    • params: ExecuteAgentParams
    • nextStep: BaseAgentNextStep<P>
    • currentPayload: P
    • agentRun: AIAgentRunEntityExtended
    • currentStep: AIAgentRunStepEntityExtended

    Returns Promise<BaseAgentNextStep<P>>

  • Type Parameters

    • P

    Parameters

    • params: ExecuteAgentParams
    • nextStep: BaseAgentNextStep<P>
    • currentPayload: P
    • agentRun: AIAgentRunEntityExtended
    • currentStep: AIAgentRunStepEntityExtended

    Returns Promise<BaseAgentNextStep<P>>

  • Type Parameters

    • P

    Parameters

    • params: ExecuteAgentParams
    • nextStep: BaseAgentNextStep<P>
    • currentPayload: P
    • agentRun: AIAgentRunEntityExtended
    • currentStep: AIAgentRunStepEntityExtended

    Returns Promise<BaseAgentNextStep<P>>

  • Type Parameters

    • P

    Parameters

    • params: ExecuteAgentParams
    • nextStep: BaseAgentNextStep<P>
    • currentPayload: P
    • agentRun: AIAgentRunEntityExtended
    • currentStep: AIAgentRunStepEntityExtended

    Returns Promise<BaseAgentNextStep<P>>

  • Parameters

    • subAgentName: string

    Returns string

  • Type Parameters

    • P

    Parameters

    • params: ExecuteAgentParams
    • nextStep: BaseAgentNextStep<P>
    • currentPayload: P
    • agentRun: AIAgentRunEntityExtended
    • currentStep: AIAgentRunStepEntityExtended

    Returns Promise<BaseAgentNextStep<P>>

  • Type Parameters

    • P

    Parameters

    • params: ExecuteAgentParams
    • nextStep: BaseAgentNextStep<P>
    • currentPayload: P
    • agentRun: AIAgentRunEntityExtended
    • currentStep: AIAgentRunStepEntityExtended

    Returns Promise<BaseAgentNextStep<P>>