@smythos/sre 1.6.14 → 1.7.1

package/dist/types/Components/APIEndpoint.class.d.ts

@@ -5,12 +5,6 @@ export declare class APIEndpoint extends Component {
     protected configSchema: Joi.ObjectSchema<any>;
     constructor();
     init(): void;
-    process(input: any, config: any, agent: Agent): Promise<{
-        headers: any;
-        body: any;
-        query: any;
-        params: any;
-        _authInfo: any;
-        _debug: string;
-    }>;
+    process(input: any, config: any, agent: Agent): Promise<any>;
+    postProcess(output: any, config: any, agent: Agent): Promise<any>;
 }

package/dist/types/Components/Component.class.d.ts

@@ -50,4 +50,13 @@ export declare class Component {
     disable(config: any, agent: Agent): Promise<any>;
     readOutput(id: any, config: any, agent: Agent): any;
     hasOutput(id: any, config: any, agent: Agent): any;
+    /**
+     * A generic registration function that can be overridden by child classes to register the trigger with providers
+     * this function is usually called outside of a workflow in order to register the trigger with providers
+     * @param componentId the id of the component to register (in SRE a single trigger instance handles all the triggers of the same type)
+     * @param agent the agent instance
+     * @param payload any additional payload to pass to the trigger
+     */
+    register(componentId: string, componentSettings: any, payload?: any): Promise<void>;
+    unregister(componentId: string, componentSettings: any, payload?: any): Promise<void>;
 }

package/dist/types/Components/Triggers/Gmail.trigger.d.ts

@@ -56,20 +56,3 @@ export declare class GmailTrigger extends Trigger {
         };
     }[]>;
 }
-/**
- * Create or update a Dkron job
- * @param {string} id - Unique job ID
- * @param {object} metadata - Arbitrary metadata object
- * @param {string} url - URL to call
- * @param {object|string} body - Request body (object will be JSON stringified)
- * @param {object} headers - HTTP headers
- * @param {string} schedule - Cron or frequency expression (e.g. "@every 1m" or "0 * * * * *")
- */
-export declare function createDkronJob(id: any, metadata: any, url: any, body: any, headers: any, schedule: any): Promise<any>;
-/**
- * Delete a Dkron job by ID
- * @param {string} id - Job ID
- */
-export declare function deleteDkronJob(id: any): Promise<{
-    success: boolean;
-}>;

package/dist/types/Components/Triggers/JobScheduler.trigger.d.ts

@@ -0,0 +1,10 @@
+import { IAgent as Agent, IAgent } from '@sre/types/Agent.types';
+import { Trigger } from './Trigger.class';
+export declare class JobSchedulerTrigger extends Trigger {
+    collectPayload(input: any, settings: any, agent: Agent): Promise<any[]>;
+    register(componentId: string, componentSettings: any, payload?: {
+        agentData: IAgent;
+        triggerUrl: string;
+    }): Promise<void>;
+    unregister(componentId: string, agent: Agent, payload?: any): Promise<void>;
+}

package/dist/types/Components/Triggers/Trigger.class.d.ts

@@ -1,6 +1,7 @@
 import { Agent } from '@sre/AgentManager/Agent.class';
 import { Component } from '../Component.class';
 import { LogHelper } from '@sre/helpers/Log.helper';
+import { IAgent } from '@sre/types/Agent.types';
 export declare class Trigger extends Component {
     protected logger: LogHelper;
     process(input: any, settings: any, agent: Agent): Promise<any>;
@@ -15,7 +16,17 @@ export declare class Trigger extends Component {
         _debug: string;
     }>;
     postProcess(output: any, settings: any, agent: Agent): Promise<any>;
+    /**
+     * This function is used to register a trigger,
+     * It can be called by a visual builder when saving a trigger component.
+     * it performs the necessary actions to register the trigger with the external service or with the internal scheduler.
+     * @param componentId - The id of the component to register
+     * @param componentSettings - The settings of the component to register
+     * @param payload - The payload to register the trigger with
+     * @returns A promise that resolves to the result of the registration
+     */
     register(componentId: string, componentSettings: any, payload: {
+        agentData: IAgent;
         triggerUrl: string;
     }): Promise<void>;
 }

package/dist/types/Components/index.d.ts

@@ -42,6 +42,9 @@ import { MemoryWriteKeyVal } from './MemoryWriteKeyVal.class';
 import { MemoryReadKeyVal } from './MemoryReadKeyVal.class';
 import { MemoryDeleteKeyVal } from './MemoryDeleteKeyVal.class';
 import { MemoryWriteObject } from './MemoryWriteObject.class';
+import { GmailTrigger } from './Triggers/Gmail.trigger';
+import { WhatsAppTrigger } from './Triggers/WhatsApp.trigger';
+import { JobSchedulerTrigger } from './Triggers/JobScheduler.trigger';
 export declare const ComponentInstances: {
     Component: Component;
     Note: Component;
@@ -91,4 +94,7 @@ export declare const ComponentInstances: {
     MemoryReadKeyVal: MemoryReadKeyVal;
     MemoryDeleteKeyVal: MemoryDeleteKeyVal;
     MemoryWriteObject: MemoryWriteObject;
+    GmailTrigger: GmailTrigger;
+    WhatsAppTrigger: WhatsAppTrigger;
+    JobSchedulerTrigger: JobSchedulerTrigger;
 };

package/dist/types/Core/Connector.class.d.ts

@@ -31,4 +31,5 @@ export declare class Connector<TRequest = any> {
     user(candidate: AccessCandidate | string): TRequest;
     team(teamId: string): TRequest;
     agent(agentId: string): TRequest;
+    handleEvent(eventName: string, data: any): void;
 }

package/dist/types/Core/ConnectorsService.d.ts

@@ -15,6 +15,7 @@ import { LogConnector } from '@sre/IO/Log.service/LogConnector';
 import { ComponentConnector } from '@sre/AgentManager/Component.service/ComponentConnector';
 import { ModelsProviderConnector } from '@sre/LLMManager/ModelsProvider.service/ModelsProviderConnector';
 import { CodeConnector } from '@sre/ComputeManager/Code.service/CodeConnector';
+import { SchedulerConnector } from '@sre/AgentManager/Scheduler.service/SchedulerConnector';
 export declare class ConnectorService {
     static Connectors: {};
     static ConnectorInstances: any;
@@ -58,6 +59,7 @@ export declare class ConnectorService {
     static hasInstance(connectorType: TConnectorService, connectorName?: string): any;
     static getRouterConnector(name?: string): RouterConnector;
     static getCodeConnector(name?: string): CodeConnector;
+    static getSchedulerConnector(name?: string): SchedulerConnector;
 }
 export declare abstract class ConnectorServiceProvider {
     abstract register(): any;

package/dist/types/Core/HookService.d.ts

@@ -35,7 +35,7 @@ export declare function hook(hookName: string): (target: any, propertyKey: strin
  * Decorator function that executes registered hooks asynchronously before and after the decorated method
  * @param hookName The name of the hook to trigger
  */
-export declare function hookAsync(hookName: string): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+export declare function hookAsync(hookName: string, customContext?: Record<string, any> | ((instance: any) => Record<string, any>)): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
 /**
  * Decorator function that executes registered hooks asynchronously before the decorated method
  * @param hookName The name of the hook to trigger

package/dist/types/helpers/Conversation.helper.d.ts

@@ -59,6 +59,8 @@ export declare class Conversation extends EventEmitter {
         handler: (args: Record<string, any>) => Promise<any>;
         inputs?: any[];
     }): Promise<void>;
+    removeTool(toolName: string): Promise<void>;
+    get toolNames(): string[];
     /**
      * updates LLM model, if spec is available, it will update the tools config
      * @param model

package/dist/types/helpers/Crypto.helper.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Generate a service-specific authentication key
+ */
+export declare function generateServiceKey(serviceName: string): string;
+/**
+ * Validate a service key
+ */
+export declare function validateServiceKey(serviceName: string, providedKey: string): boolean;

package/dist/types/index.d.ts

@@ -48,12 +48,14 @@ export * from './Core/boot';
 export * from './Core/Connector.class';
 export * from './Core/ConnectorsService';
 export * from './Core/DummyConnector';
+export * from './Core/ExternalEventsReceiver';
 export * from './Core/HookService';
 export * from './Core/SmythRuntime.class';
 export * from './Core/SystemEvents';
 export * from './helpers/AWSLambdaCode.helper';
 export * from './helpers/BinaryInput.helper';
 export * from './helpers/Conversation.helper';
+export * from './helpers/Crypto.helper';
 export * from './helpers/ECMASandbox.helper';
 export * from './helpers/JsonContent.helper';
 export * from './helpers/LocalCache.helper';
@@ -86,6 +88,10 @@ export * from './Components/APICall/parseHeaders';
 export * from './Components/APICall/parseProxy';
 export * from './Components/APICall/parseUrl';
 export * from './Components/Image/imageSettings.config';
+export * from './Components/Triggers/Gmail.trigger';
+export * from './Components/Triggers/JobScheduler.trigger';
+export * from './Components/Triggers/Trigger.class';
+export * from './Components/Triggers/WhatsApp.trigger';
 export * from './subsystems/AgentManager/Agent.class';
 export * from './subsystems/AgentManager/Agent.helper';
 export * from './subsystems/AgentManager/AgentLogger.class';
@@ -110,6 +116,10 @@ export * from './subsystems/AgentManager/AgentData.service/AgentDataConnector';
 export * from './subsystems/AgentManager/AgentData.service/index';
 export * from './subsystems/AgentManager/Component.service/ComponentConnector';
 export * from './subsystems/AgentManager/Component.service/index';
+export * from './subsystems/AgentManager/Scheduler.service/index';
+export * from './subsystems/AgentManager/Scheduler.service/Job.class';
+export * from './subsystems/AgentManager/Scheduler.service/Schedule.class';
+export * from './subsystems/AgentManager/Scheduler.service/SchedulerConnector';
 export * from './subsystems/ComputeManager/Code.service/CodeConnector';
 export * from './subsystems/ComputeManager/Code.service/index';
 export * from './subsystems/IO/CLI.service/CLIConnector';
@@ -138,6 +148,8 @@ export * from './subsystems/Security/AccessControl/AccessRequest.class';
 export * from './subsystems/Security/AccessControl/ACL.class';
 export * from './subsystems/Security/Account.service/AccountConnector';
 export * from './subsystems/Security/Account.service/index';
+export * from './subsystems/Security/Credentials/Credentials.class';
+export * from './subsystems/Security/Credentials/ManagedOAuth2Credentials.class';
 export * from './subsystems/Security/ManagedVault.service/index';
 export * from './subsystems/Security/ManagedVault.service/ManagedVaultConnector';
 export * from './subsystems/Security/Vault.service/index';
@@ -147,6 +159,7 @@ export * from './subsystems/AgentManager/AgentData.service/connectors/CLIAgentDa
 export * from './subsystems/AgentManager/AgentData.service/connectors/LocalAgentDataConnector.class';
 export * from './subsystems/AgentManager/AgentData.service/connectors/NullAgentData.class';
 export * from './subsystems/AgentManager/Component.service/connectors/LocalComponentConnector.class';
+export * from './subsystems/AgentManager/Scheduler.service/connectors/LocalScheduler.class';
 export * from './subsystems/ComputeManager/Code.service/connectors/AWSLambdaCode.class';
 export * from './subsystems/IO/Log.service/connectors/ConsoleLog.class';
 export * from './subsystems/IO/NKV.service/connectors/NKVLocalStorage.class';

package/dist/types/subsystems/AgentManager/Agent.class.d.ts

@@ -13,10 +13,12 @@ export declare class Agent implements IAgent {
     components: any;
     connections: any;
     endpoints: any;
+    triggers: any;
     sessionId: any;
     sessionTag: string;
     callerSessionId: any;
     apiBasePath: string;
+    triggerBasePath: string;
     agentRuntime: AgentRuntime | any;
     usingTestDomain: boolean;
     domain: string;
@@ -24,7 +26,7 @@ export declare class Agent implements IAgent {
     circularLimit: number;
     version: string;
     agentVariables: any;
-    private _kill;
+    private _killReason;
     async: boolean;
     jobID: string;
     planInfo: any;
@@ -44,7 +46,7 @@ export declare class Agent implements IAgent {
     addSSE(sseSource: Response | AgentSSE, monitorId?: string): void;
     setRequest(agentRequest: AgentRequest | any): void;
     setCallback(callback: (data: any) => void): void;
-    kill(): void;
+    kill(reason?: string): void;
     isKilled(): boolean;
     private parseVariables;
     process(endpointPath: any, input: any): Promise<any>;

package/dist/types/subsystems/AgentManager/AgentData.service/AgentDataConnector.d.ts

@@ -9,6 +9,7 @@ export interface IAgentDataConnector {
     };
 }
 export declare abstract class AgentDataConnector extends Connector implements IAgentDataConnector {
+    static ephemeralAgentData: Map<string, any>;
     name: string;
     abstract getAgentData(agentId: string, version?: string): Promise<any>;
     abstract getAgentIdByDomain(domain: string): Promise<string>;
@@ -30,4 +31,16 @@ export declare abstract class AgentDataConnector extends Connector implements IA
      * @returns
      */
     getOpenAPIJSON(source: string | Record<string, any>, server_url: any, version: any, aiOnly?: boolean): Promise<any>;
+    /**
+     * Sets ephemeral agent data for the given agent ID
+     * @param agentId
+     * @param data
+     */
+    setEphemeralAgentData(agentId: string, data: any): Promise<void>;
+    /**
+     * Gets ephemeral agent data for the given agent ID
+     * @param agentId
+     * @returns
+     */
+    getEphemeralAgentData(agentId: string): Promise<any>;
 }

package/dist/types/subsystems/AgentManager/AgentData.service/connectors/NullAgentData.class.d.ts

@@ -6,10 +6,7 @@ export declare class NullAgentData extends AgentDataConnector {
     name: string;
     constructor(settings: TArgs);
     getAgentConfig(agentId: string): Partial<TArgs>;
-    getAgentData(agentId: string, version?: string): Promise<{
-        data: {};
-        version: string;
-    }>;
+    getAgentData(agentId: string, version?: string): Promise<any>;
     getAgentIdByDomain(domain: string): Promise<string>;
     getAgentSettings(agentId: string, version?: string): Promise<{}>;
     getAgentEmbodiments(agentId: string): Promise<any>;

package/dist/types/subsystems/AgentManager/Scheduler.service/Job.class.d.ts

@@ -1,9 +1,10 @@
 /**
  * Job - Wrapper for agent-based scheduled tasks
  *
- * Jobs can execute in two ways:
+ * Jobs can execute in three ways:
  * 1. **Skill Execution**: Call a specific agent skill with arguments
- * 2. **Prompt Execution**: Send a prompt to an agent for processing
+ * 2. **Trigger Execution**: Invoke an agent trigger (no arguments)
+ * 3. **Prompt Execution**: Send a prompt to an agent for processing
  *
  * All job data is fully serializable, allowing jobs to persist and resume after restart.
  *
@@ -23,6 +24,17 @@
  *     }
  * });
  *
+ * // Trigger execution job
+ * const triggerJob = new Job({
+ *     type: 'trigger',
+ *     agentId: 'my-agent',
+ *     triggerName: 'daily_sync',
+ *     metadata: {
+ *         name: 'Daily Sync',
+ *         description: 'Sync data every day at midnight'
+ *     }
+ * });
+ *
  * // Prompt execution job
  * const promptJob = new Job({
  *     type: 'prompt',
@@ -36,7 +48,7 @@
  * ```
  */
 export interface IJobMetadata {
-    name: string;
+    name?: string;
     description?: string;
     tags?: string[];
     retryOnFailure?: boolean;
@@ -52,7 +64,13 @@ export interface ISkillJobConfig {
     agentId: string;
     skillName: string;
     args?: Record<string, any> | any[];
-    metadata: IJobMetadata;
+    metadata?: IJobMetadata;
+}
+export interface ITriggerJobConfig {
+    type: 'trigger';
+    agentId: string;
+    triggerName: string;
+    metadata?: IJobMetadata;
 }
 /**
  * Configuration for a prompt-based job
@@ -61,11 +79,12 @@ export interface IPromptJobConfig {
     type: 'prompt';
     agentId: string;
     prompt: string;
-    metadata: IJobMetadata;
+    metadata?: IJobMetadata;
 }
-export type IJobConfig = ISkillJobConfig | IPromptJobConfig;
+export type IJobConfig = ISkillJobConfig | IPromptJobConfig | ITriggerJobConfig;
 export declare class Job {
     private config;
+    get agentId(): string;
     constructor(config: IJobConfig);
     /**
      * Get the job metadata
@@ -93,6 +112,10 @@ export declare class Job {
      * Execute a skill-based job
      */
     private executeSkill;
+    /**
+     * Execute a trigger-based job
+     */
+    private executeTrigger;
     /**
      * Execute a prompt-based job
      */

package/dist/types/subsystems/AgentManager/Scheduler.service/SchedulerConnector.d.ts

@@ -5,6 +5,7 @@ import { SecureConnector } from '@sre/Security/SecureConnector.class';
 import { IAccessCandidate, IACL, TAccessRole } from '@sre/types/ACL.types';
 import { Schedule, IScheduleData } from './Schedule.class';
 import { Job, IJobConfig } from './Job.class';
+import EventEmitter from 'events';
 /**
  * Scheduled job data structure
  */
@@ -13,7 +14,7 @@ export interface IScheduledJob {
     schedule: IScheduleData;
     jobConfig: IJobConfig;
     acl: IACL;
-    status: 'active' | 'paused' | 'completed' | 'failed';
+    status: 'active' | 'paused';
     lastRun?: string;
     nextRun?: string;
     createdBy: {
@@ -37,11 +38,13 @@ export interface IJobExecution {
  */
 export interface ISchedulerRequest {
     list(): Promise<IScheduledJob[]>;
-    add(jobId: string, schedule: Schedule, job: Job): Promise<void>;
+    add(jobId: string, job: Job, schedule: Schedule): Promise<void>;
     delete(jobId: string): Promise<void>;
     get(jobId: string): Promise<IScheduledJob | undefined>;
     pause(jobId: string): Promise<void>;
     resume(jobId: string): Promise<void>;
+    on(event: string, listener: (...args: any[]) => void): any;
+    off(event: string, listener: (...args: any[]) => void): any;
 }
 /**
  * Abstract base class for scheduler connectors
@@ -70,6 +73,8 @@ export interface ISchedulerRequest {
 export declare abstract class SchedulerConnector extends SecureConnector<ISchedulerRequest> {
     abstract id: string;
     abstract name: string;
+    protected _eventEmitter: EventEmitter;
+    constructor(settings?: any);
     /**
      * Get ACL for a specific job resource
      * @param resourceId - Job ID
@@ -93,7 +98,7 @@ export declare abstract class SchedulerConnector extends SecureConnector<ISchedu
      * @param schedule - Schedule definition
      * @param job - Job to execute
      */
-    protected abstract add(acRequest: AccessRequest, jobId: string, schedule: Schedule, job: Job): Promise<void>;
+    protected abstract add(acRequest: AccessRequest, jobId: string, job: Job, schedule: Schedule): Promise<void>;
     /**
      * Delete a scheduled job
      * @param acRequest - Access request
@@ -124,4 +129,7 @@ export declare abstract class SchedulerConnector extends SecureConnector<ISchedu
      * @param jobId - Job ID
      */
     protected constructJobKey(candidate: IAccessCandidate, jobId: string): string;
+    protected emit(event: string, ...args: any[]): boolean;
+    on(event: string, listener: (...args: any[]) => void): this;
+    off(event: string, listener: (...args: any[]) => void): this;
 }

package/dist/types/subsystems/AgentManager/Scheduler.service/connectors/LocalScheduler.class.d.ts

@@ -11,10 +11,12 @@ export type LocalSchedulerConfig = {
      */
     folder?: string;
     /**
-     * Auto-start scheduler on initialization
+     * Enable job execution
+     * If true: loads jobs at start and executes them on schedule
+     * If false: allows job management but skips all execution (for multi-instance setups)
      * Defaults to true
      */
-    autoStart?: boolean;
+    runJobs?: boolean;
     /**
      * Keep execution history
      * Defaults to true
@@ -33,9 +35,22 @@ export type LocalSchedulerConfig = {
  * Loads and schedules jobs on initialization.
  * Provides full ACL-based access control and candidate isolation.
  *
+ * **Multi-Instance Safety**: Uses static storage to prevent race conditions when
+ * multiple scheduler instances are running. Job timers are shared across all instances,
+ * ensuring each job runs only once even if scheduled by multiple instances.
+ *
+ * **Multi-Instance Setup**: Use the `runJobs` config to control execution:
+ * - Set `runJobs: true` on ONE instance to execute jobs
+ * - Set `runJobs: false` on other instances to only manage jobs (add/delete/pause/resume)
+ *
  * @example
  * ```typescript
- * const scheduler = new LocalScheduler({ folder: '~/.smyth/scheduler' });
+ * // Execution instance (runs jobs)
+ * const scheduler = new LocalScheduler({ folder: '~/.smyth/scheduler', runJobs: true });
+ *
+ * // Management-only instance (no execution)
+ * const managerScheduler = new LocalScheduler({ folder: '~/.smyth/scheduler', runJobs: false });
+ *
  * const candidate = new AccessCandidate(TAccessRole.User, 'user123');
  * const requester = scheduler.requester(candidate);
  *
@@ -51,10 +66,11 @@ export declare class LocalScheduler extends SchedulerConnector {
     protected _settings?: LocalSchedulerConfig;
     name: string;
     id: string;
+    private static jobs;
+    private static timers;
     private folder;
     private jobsPrefix;
     private runtimePrefix;
-    private jobs;
     private isInitialized;
     private config;
     constructor(_settings?: LocalSchedulerConfig);
@@ -73,12 +89,12 @@ export declare class LocalScheduler extends SchedulerConnector {
     private getCandidateFolderName;
     /**
      * Get the job configuration file path
-     * Format: scheduler/jobs/<username>.user/<jobId>.json
+     * Format: scheduler/jobs/<username>.user/<role_id_jobId>.json
      */
     private getJobFilePath;
     /**
      * Get the runtime data file path
-     * Format: scheduler/.jobs.runtime/<username>.user/<jobId>.json
+     * Format: scheduler/.jobs.runtime/<username>.user/<role_id_jobId>.json
      */
     private getRuntimeFilePath;
     /**
@@ -104,10 +120,15 @@ export declare class LocalScheduler extends SchedulerConnector {
     /**
      * Schedule a job for execution
      * Jobs are fully serializable and can be executed after restart
+     *
+     * **Multi-Instance Safety**: Before scheduling, checks if a timer already exists
+     * for this job (from another scheduler instance) and clears it. This ensures
+     * each job has exactly one active timer across all instances.
      */
     private scheduleJob;
     /**
      * Unschedule a job
+     * Uses the job key (not just jobId) to access the static timer storage
      */
     private unscheduleJob;
     /**
@@ -119,13 +140,16 @@ export declare class LocalScheduler extends SchedulerConnector {
      */
     getResourceACL(resourceId: string, candidate: IAccessCandidate): Promise<ACL>;
     protected list(acRequest: AccessRequest): Promise<IScheduledJob[]>;
-    protected add(acRequest: AccessRequest, jobId: string, schedule: Schedule, job: Job): Promise<void>;
+    protected add(acRequest: AccessRequest, jobId: string, job: Job, schedule: Schedule): Promise<void>;
     protected delete(acRequest: AccessRequest, jobId: string): Promise<void>;
     protected get(acRequest: AccessRequest, jobId: string): Promise<IScheduledJob | undefined>;
     protected pause(acRequest: AccessRequest, jobId: string): Promise<void>;
     protected resume(acRequest: AccessRequest, jobId: string): Promise<void>;
     /**
      * Cleanup - stop all scheduled jobs
+     *
+     * Note: This clears ALL timers in the static storage, affecting all instances.
+     * Use with caution in multi-instance environments.
      */
     shutdown(): Promise<void>;
 }

package/dist/types/subsystems/LLMManager/LLM.service/connectors/Perplexity.class.d.ts

@@ -69,14 +69,11 @@ export declare class PerplexityConnector extends LLMConnector {
             text?: string;
             functionCall?: {
                 name: string;
-                args: string;
+                args: string | Record<string, any>;
             };
             functionResponse?: {
                 name: string;
-                response: {
-                    name: string;
-                    content: string;
-                };
+                response: any;
             };
         }[];
         tool_calls?: ToolData[];

package/dist/types/subsystems/LLMManager/LLM.service/connectors/openai/OpenAIConnector.class.d.ts

@@ -14,7 +14,7 @@ export declare class OpenAIConnector extends LLMConnector {
      * Determine the appropriate interface type based on context and capabilities
      */
     private getInterfaceType;
-    protected getClient(params: ILLMRequestContext): Promise<OpenAI>;
+    protected getClient(context: ILLMRequestContext): Promise<OpenAI>;
     protected request({ acRequest, body, context }: ILLMRequestFuncParams): Promise<TLLMChatResponse>;
     protected streamRequest({ acRequest, body, context }: ILLMRequestFuncParams): Promise<EventEmitter>;
     protected imageGenRequest({ acRequest, body, context }: ILLMRequestFuncParams): Promise<OpenAI.ImagesResponse>;
@@ -44,14 +44,11 @@ export declare class OpenAIConnector extends LLMConnector {
             text?: string;
             functionCall?: {
                 name: string;
-                args: string;
+                args: string | Record<string, any>;
             };
             functionResponse?: {
                 name: string;
-                response: {
-                    name: string;
-                    content: string;
-                };
+                response: any;
             };
         }[];
         tool_calls?: ToolData[];

package/dist/types/subsystems/LLMManager/LLM.service/connectors/openai/apiInterfaces/ResponsesApiInterface.d.ts

@@ -108,12 +108,19 @@ export declare class ResponsesApiInterface extends OpenAIApiInterface {
      * Upload files to storage
      */
     private uploadFiles;
+    /**
+     * Upload file to OpenAI Files API
+     * Similar to GoogleAI's uploadFile implementation
+     */
+    private uploadFile;
     /**
      * Process image files with Responses API specific formatting
+     * Uses OpenAI Files API for uploading images
      */
     private processImageData;
     /**
      * Process document files with Responses API specific formatting
+     * Uses OpenAI Files API for uploading documents
      */
     private processDocumentData;
     /**

package/dist/types/subsystems/LLMManager/LLM.service/connectors/xAI.class.d.ts

@@ -104,14 +104,11 @@ export declare class xAIConnector extends LLMConnector {
             text?: string;
             functionCall?: {
                 name: string;
-                args: string;
+                args: string | Record<string, any>;
             };
             functionResponse?: {
                 name: string;
-                response: {
-                    name: string;
-                    content: string;
-                };
+                response: any;
             };
         }[];
         tool_calls?: ToolData[];

package/dist/types/types/Agent.types.d.ts

@@ -25,6 +25,7 @@ export interface IAgent {
     sessionTag: any;
     callerSessionId: any;
     apiBasePath: any;
+    triggerBasePath: any;
     agentRuntime: AgentRuntime | any;
     usingTestDomain: any;
     domain: any;

package/dist/types/types/LLM.types.d.ts

@@ -341,14 +341,11 @@ export type TLLMMessageBlock = {
         text?: string;
         functionCall?: {
             name: string;
-            args: string;
+            args: string | Record<string, any>;
         };
         functionResponse?: {
             name: string;
-            response: {
-                name: string;
-                content: string;
-            };
+            response: any;
         };
     }[];
     tool_calls?: ToolData[];