psadk 1.1.0

package/build/module/lib/PSAI.js

@@ -0,0 +1,314 @@
+// import { EmbeddingsInterface } from '@langchain/core/embeddings';
+// fetch-retry can also wrap Node.js's native fetch API implementation:
+const fetch = require('fetch-retry')(global.fetch);
+import { JwtUtils } from './jwt';
+import { PSAgentLogger } from './PSAgentLogger';
+import express from 'express';
+const log = new PSAgentLogger();
+let existingToken = {
+    service_token: null,
+    refresh_token: null,
+    expires: new Date(0),
+    service_expires: new Date(0)
+};
+// export default class AIHelper implements EmbeddingsInterface{
+export class PSAI {
+    token;
+    dimensions;
+    baseUrl;
+    log;
+    clientid;
+    constructor(token, baseUrl, log) {
+        this.token = token;
+        this.baseUrl = baseUrl || process.env.PS_API_URL || '';
+        this.clientid = process.env.PS_CLIENT_ID || '';
+        this.dimensions = 1536; // default to 1536 dimensions (for text-embedding-3-small)
+        this.log = log || new PSAgentLogger();
+    }
+    getDimensions(embeddingModel = 'text-embedding-3-small') {
+        if (embeddingModel === 'text-embedding-3-small') {
+            return 1536;
+        }
+        else if (embeddingModel === 'text-embedding-3-large') {
+            return 3072;
+        }
+        else if (embeddingModel === 'text-embedding-ada-002') {
+            return 1536;
+        }
+        else {
+            return this.dimensions;
+        }
+    }
+    async embedQuery(text, embeddingModel = 'text-embedding-3-small') {
+        const response = await fetch(`${this.baseUrl}/api/v1/vectors/embeddings`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${this.token}`,
+                'x-client-id': this.clientid || '',
+            },
+            body: JSON.stringify({
+                input: text,
+                model: embeddingModel,
+                "dimensions": this.getDimensions(embeddingModel),
+            }),
+        });
+        const data = await response.json();
+        if (!response.ok) {
+            this.log.error(`Failed to fetch embedding: ${response.status} ${response.statusText}`, data);
+            throw new Error(`HTTP error! status: ${response.status}`);
+        }
+        return data.data[0].embedding;
+    }
+    async embedDocuments(text, embeddingModel = 'text-embedding-3-small') {
+        const response = await fetch(`${this.baseUrl}/api/v1/vectors/embeddings`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${this.token}`,
+                'x-client-id': this.clientid || '',
+            },
+            body: JSON.stringify({
+                input: text,
+                model: embeddingModel,
+                "dimensions": this.getDimensions(embeddingModel),
+            }),
+        });
+        const data = await response.json();
+        if (!response.ok) {
+            this.log.error(`Failed to fetch embedding: ${response.status} ${response.statusText}`, data);
+            throw new Error(`HTTP error! status: ${response.status}`);
+        }
+        return data.data.map((item) => item.embedding);
+    }
+    async getModels() {
+        const lres = await fetch(`${this.baseUrl}/api/v1/llm/models`, {
+            headers: {
+                'Authorization': `Bearer ${this.token}`,
+            }
+        });
+        if (!lres.ok) {
+            this.log.error(`Failed to fetch LLM models: ${lres.status} ${lres.statusText}`);
+        }
+        const { data: models } = await lres.json();
+        return models;
+    }
+    async llm(prompt, model = "o3-mini", systemmsg = "You are a helpful assistant. Answer as concisely as possible.") {
+        try {
+            const res = await fetch(`${this.baseUrl}/api/v1/llm/chat/completions`, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    "Authorization": `Bearer ${this.token}`,
+                },
+                body: JSON.stringify({
+                    model,
+                    messages: [
+                        { role: "system", content: systemmsg },
+                        { role: "user", content: prompt }
+                    ]
+                }),
+                retries: 3,
+                retryOn: function (attempt, error, response) {
+                    // retry on any network error, or 4xx or 5xx status codes
+                    if (error !== null || response.status >= 400 && attempt < 4) {
+                        this.log.warn(`retrying execute agent, attempt number ${attempt + 1}`);
+                        return true;
+                    }
+                    return false;
+                },
+                retryDelay: function (attempt, _error, _response) {
+                    return Math.pow(2, attempt) * 1000; // 1000, 2000, 4000
+                }
+            });
+            if (!res.ok) {
+                this.log.debug(`Failed to fetch LLM completion: ${res.status} ${res.statusText}`);
+                try {
+                    const errorData = (await res.json());
+                    this.log.debug(errorData);
+                    throw new Error(`LLM call failed.\n\n status: ${res.status}, details: ${errorData}`);
+                }
+                catch (e) {
+                    throw new Error(`LLM call failed.\n\n status: ${res.status}, and could not parse error response`);
+                }
+            }
+            const data = await res.json();
+            return data;
+        }
+        catch (error) {
+            this.log.debug('Error in llm call:', error);
+            throw error;
+        }
+    }
+    static async getServiceToken(options) {
+        const { baseurl = process.env.PS_API_URL || '', appkey = process.env.PS_SVC_APP_KEY || '', clientid = process.env.PS_SVC_CLIENT_ID || '', clientsecret = process.env.PS_SVC_CLIENT_SECRET || '' } = options || {};
+        if (!baseurl || !appkey || !clientid || !clientsecret) {
+            throw new Error('Missing required environment variables for service token retrieval');
+        }
+        const currentTime = new Date();
+        // Check if the existing token is still valid and expires after 20 minutes
+        if (existingToken && existingToken.service_token && existingToken.service_expires.getTime() > (currentTime.getTime() + 20 * 60000)) {
+            return existingToken.service_token;
+        }
+        const token = Buffer.from(`${clientid}:${clientsecret}`).toString('base64');
+        if (existingToken && existingToken.expires > currentTime) {
+            log.debug(`Found existing refresh token: ${existingToken.refresh_token}`);
+            const tres = await fetch(`${baseurl}/api/v2/auth/refreshtoken?client=machine`, {
+                headers: {
+                    'Authorization': `Basic ${token}`,
+                    'app-key': appkey || '',
+                    'rt': existingToken.refresh_token || ''
+                }
+            });
+            if (tres.ok) {
+                const { accessToken, refreshToken } = (await tres.json());
+                const spayload = JwtUtils.decode(accessToken);
+                const rpayload = JwtUtils.decode(refreshToken);
+                existingToken.service_token = accessToken;
+                existingToken.refresh_token = refreshToken;
+                existingToken.expires = new Date(rpayload?.exp * 1000);
+                existingToken.service_expires = new Date(spayload?.exp * 1000);
+                log.debug(`Refreshed service token: expires at ${existingToken.service_expires}`);
+                return accessToken;
+            }
+            else {
+                log.debug(`Failed to refresh service token, status: ${tres.status}`);
+            }
+        }
+        const tres = await fetch(`${baseurl}/api/v2/auth/login?client=machine&source=custom`, {
+            headers: {
+                'Authorization': `Basic ${token}`,
+                'app-key': appkey || ''
+            }
+        });
+        const { serviceToken, refreshToken } = (await tres.json());
+        const spayload = JwtUtils.decode(serviceToken);
+        const rpayload = JwtUtils.decode(refreshToken);
+        log.debug(`service token expires: ${JSON.stringify(new Date(spayload?.exp * 1000))}`);
+        log.debug(`refresh token expires: ${JSON.stringify(new Date(rpayload?.exp * 1000))}`);
+        existingToken.service_token = serviceToken;
+        existingToken.refresh_token = refreshToken;
+        existingToken.expires = new Date(rpayload?.exp * 1000);
+        existingToken.service_expires = new Date(spayload?.exp * 1000);
+        return serviceToken;
+    }
+    /**
+     * fetch access token by launching a local server to listen for the callback
+     * @param options - baseUrl and appKey for authentication
+     * @returns accessToken and refreshToken
+     * @throws error if any required values are missing or if authentication fails
+     */
+    static async getAuthToken(options) {
+        const { baseurl = options?.baseUrl || process.env.PS_API_URL || '', appkey = options?.appKey || process.env.PS_APP_KEY || '', } = options || {};
+        if (baseurl === '' || appkey === '') {
+            throw new Error('Missing required values baseUrl & appKey or default environment variables PS_API_URL/PS_APP_KEY for access token retrieval');
+        }
+        try {
+            let isCallbackFinished = false;
+            let callBackError = null;
+            let accessToken = null;
+            let refreshToken = null;
+            let appInitialized = false;
+            const app = express();
+            const router = express.Router();
+            router.use(express.json()); // for parsing application/json
+            router.use(express.urlencoded({ extended: true })); // for parsing application/x-www-form-urlencoded
+            router.get('/callback', (req, res) => {
+                const status = req.query.status;
+                if (status !== "success") {
+                    log.error(`Authentication failed with status: ${status}`);
+                    callBackError = `Authentication failed with status: ${status}`;
+                    isCallbackFinished = true;
+                    return res.status(400).send('Authentication failed');
+                }
+                log.debug("Authentication successful.");
+                accessToken = req.query["at"];
+                refreshToken = req.query["rt"];
+                if (!accessToken || !refreshToken) {
+                    log.error('Missing access token or refresh token in callback');
+                    callBackError = 'Missing access token or refresh token in callback';
+                    isCallbackFinished = true;
+                    return res.status(400).send('Missing tokens');
+                }
+                callBackError = null;
+                isCallbackFinished = true;
+                return res.status(200).send('Authentication successful! You can close this window.');
+            });
+            router.get('/login', async (_req, res) => {
+                const rurl = encodeURIComponent('http://localhost:3133/callback');
+                const loginUrl = `${baseurl}/api/v2/auth/login?client=desktop&redirect_url=${rurl}`;
+                const lres = await fetch(loginUrl, {
+                    headers: { 'app-key': appkey || '' }
+                });
+                if (lres.status >= 400) {
+                    log.error(`Failed to initiate login: ${lres.status} ${lres.statusText}`);
+                    callBackError = `Failed to initiate login: ${lres.status} ${lres.statusText}`;
+                    isCallbackFinished = true;
+                    return res.status(500).send('Failed to initiate login');
+                }
+                const data = lres.body;
+                if (!data) {
+                    log.error('No response body from login initiation');
+                    callBackError = 'No response body from login initiation';
+                    isCallbackFinished = true;
+                    return res.status(500).send('No response body from login initiation');
+                }
+                const reader = data.getReader();
+                const decoder = new TextDecoder('utf-8');
+                let lresText = '';
+                while (true) {
+                    const { done, value } = await reader.read();
+                    if (done)
+                        break;
+                    lresText += decoder.decode(value);
+                }
+                if (!lresText || lresText.length === 0) {
+                    log.error('Empty response body from login initiation');
+                    callBackError = 'Empty response body from login initiation';
+                    isCallbackFinished = true;
+                    return res.status(500).send('Empty response body from login initiation');
+                }
+                log.debug('Redirecting to authentication provider');
+                return res.redirect(lresText);
+            });
+            app.use('', router);
+            app.listen(3133, () => {
+                log.debug('Listening on port 3133 for OAuth callback');
+                appInitialized = true;
+            }).on('error', (err) => {
+                log.error('Failed to start local server:', err);
+                callBackError = `Failed to start local server: ${err.message}`;
+                isCallbackFinished = true;
+                appInitialized = true;
+            });
+            do {
+                await new Promise(resolve => setTimeout(resolve, 500));
+            } while (!appInitialized && !callBackError);
+            if (appInitialized) {
+                console.log(`Please open the following URL in your browser to authenticate:\n\nhttp://localhost:3133/login\n`);
+                // Open the URL in the default browser
+                const open = (await import('open')).default;
+                await open(`http://localhost:3133/login`);
+                do {
+                    await new Promise(resolve => setTimeout(resolve, 500));
+                } while (!isCallbackFinished && !callBackError);
+            }
+            if (callBackError) {
+                throw new Error(callBackError);
+            }
+            if (!accessToken || !refreshToken) {
+                throw new Error('Failed to obtain tokens from callback');
+            }
+            log.debug(`Obtained access token and refresh token from callback`);
+            return {
+                accessToken: accessToken,
+                refreshToken: refreshToken
+            };
+        }
+        catch (error) {
+            log.error('Error in getAccessToken:', error);
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiUFNBSS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9saWIvUFNBSS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxvRUFBb0U7QUFDcEUsdUVBQXVFO0FBQ3ZFLE1BQU0sS0FBSyxHQUFHLE9BQU8sQ0FBQyxhQUFhLENBQUMsQ0FBQyxNQUFNLENBQUMsS0FBSyxDQUFDLENBQUM7QUFDbkQsT0FBTyxFQUFFLFFBQVEsRUFBZ0IsTUFBTSxPQUFPLENBQUM7QUFDL0MsT0FBTyxFQUFDLGFBQWEsRUFBQyxNQUFNLGlCQUFpQixDQUFDO0FBQzlDLE9BQU8sT0FBOEIsTUFBTSxTQUFTLENBQUM7QUFFckQsTUFBTSxHQUFHLEdBQUcsSUFBSSxhQUFhLEVBQUUsQ0FBQztBQUVoQyxJQUFJLGFBQWEsR0FLYjtJQUNGLGFBQWEsRUFBRSxJQUFJO0lBQ25CLGFBQWEsRUFBRSxJQUFJO0lBQ25CLE9BQU8sRUFBRSxJQUFJLElBQUksQ0FBQyxDQUFDLENBQUM7SUFDcEIsZUFBZSxFQUFFLElBQUksSUFBSSxDQUFDLENBQUMsQ0FBQztDQUM3QixDQUFDO0FBRUYsZ0VBQWdFO0FBQ2hFLE1BQU0sT0FBTyxJQUFJO0lBQ0UsS0FBSyxDQUFTO0lBQ3ZCLFVBQVUsQ0FBUTtJQUNULE9BQU8sQ0FBUztJQUNoQixHQUFHLENBQWdCO0lBQ25CLFFBQVEsQ0FBUztJQUVsQyxZQUFZLEtBQWEsRUFBRSxPQUFnQixFQUFFLEdBQW1CO1FBQzlELElBQUksQ0FBQyxLQUFLLEdBQUcsS0FBSyxDQUFDO1FBQ25CLElBQUksQ0FBQyxPQUFPLEdBQUcsT0FBTyxJQUFJLE9BQU8sQ0FBQyxHQUFHLENBQUMsVUFBVSxJQUFJLEVBQUUsQ0FBQztRQUN2RCxJQUFJLENBQUMsUUFBUSxHQUFHLE9BQU8sQ0FBQyxHQUFHLENBQUMsWUFBWSxJQUFJLEVBQUUsQ0FBQztRQUMvQyxJQUFJLENBQUMsVUFBVSxHQUFHLElBQUksQ0FBQyxDQUFDLDBEQUEwRDtRQUNsRixJ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

package/build/module/lib/PSAgent.d.ts

@@ -0,0 +1,215 @@
+import { PSAgentConfig } from "./PSAgentConfig";
+import { IPSAgentToolResult, PSAgentTool } from "./PSAgentTool";
+import { PSAgentLogger } from "./PSAgentLogger";
+import { z } from "zod/v4";
+import { PSAgentTask } from "./PSAgentTask";
+import type { AgentCard } from "@a2a-js/sdk";
+import { AgentExecutor, RequestContext, ExecutionEventBus, TaskStore } from "@a2a-js/sdk/server";
+import express from "express";
+export declare function sleep(ms: number): Promise<void>;
+/**
+ * PSAgent class to manage AI agents with tools and tasks
+ * Implements AgentExecutor interface from A2A SDK
+ * Supports starting, resuming, cancelling agents and executing tools
+ * Manages agent state, tools, tasks and interactions with A2A platform
+ * Includes methods for A2A server setup and event fetching
+ *
+ * uses the token from config if not PS_API_TOKEN env variable
+ * adds x-client-id, x-project-id, x-workspace-id from env variables
+ * PS_CLIENT_ID, PS_PROJECT_ID, PS_WORKSPACE_ID respectively for authentication headers
+ *
+ * @example
+ * ```typescript
+ * import { PSAI, PSAgent, PSAgentLogger } from 'psadk';
+ * import dotenv from 'dotenv';
+ * dotenv.config();
+ * async function main() {
+ *   const token = await PSAI.getServiceToken({});
+ *   const HelloAgent = new PSAgent({
+ *     name: 'HelloAgent',
+ *     description: 'A simple hello world agent',
+ *     system_prompt: 'You are a helpful assistant that greets users.',
+ *     model: 'gpt-5',
+ *     tools: [],
+ *     log: new PSAgentLogger({ level: 'info' }),
+ *     token: token,
+ *     port: 41241,
+ *   });
+ *   const { app, port } = HelloAgent.getServer();
+ *   app.listen(port, () => {
+ *     console.log('HelloAgent is running on http://localhost:${port}');
+ *   });
+ * }
+ * main();
+ * ```
+ * @see PSAgentConfig, PSAgentTool, PSAgentTask
+ *
+ * @see
+ * https://dev.lionis.ai/docs/api/v1/agents/create-agent
+ * https://pscode.lioncloud.net/ai-tso/psadk_samples
+ * https://a2aproject.com/docs/getting-started/quickstart
+ *
+ */
+export declare class PSAgent implements AgentExecutor {
+    config: PSAgentConfig;
+    private tools;
+    private tasks;
+    private agentId?;
+    private correlationId?;
+    private readonly log?;
+    private cancelledTasks;
+    cancelTask: (taskId: string, _eventBus: ExecutionEventBus) => Promise<void>;
+    /**
+     * create a new PSAgent with the given config
+     * @param config PSAgentConfig with optional logger
+     */
+    constructor(config: PSAgentConfig & {
+        log?: PSAgentLogger;
+    });
+    /**
+     * Get the Agent Class
+     * @returns Agent class from config or default "LlmAgent"
+     */
+    get AgentClass(): string;
+    /**
+     * Get the Name of the Agent
+     *
+     * @returns Name of the agent from config
+     */
+    get Name(): string;
+    /**
+     * Get the Description of the Agent
+     * @returns Description of the agent from config
+     */
+    get Description(): string;
+    /**
+     * Get the Instruction(System Prompt) of the Agent
+     * @returns Instruction(System prompt) of the agent from config
+     */
+    get Instruction(): string;
+    /**
+     * Get the Model of the Agent
+     * @returns Model of the agent from config
+     */
+    get Model(): string | undefined;
+    /**
+     * Get the Input Schema of the Agent
+     * @returns Input schema of the agent from config
+     */
+    get InputSchema(): z.core.JSONSchema.BaseSchema | undefined;
+    /**
+     * Get the Output Schema of the Agent
+     * @returns Output schema of the agent from config
+     */
+    get OutputSchema(): z.core.JSONSchema.BaseSchema | undefined;
+    /**
+     * Get the Token for the Agent
+     * @returns Token of the agent from config
+     */
+    get Token(): string | undefined;
+    /**
+     * Set the Token for the Agent
+     * @param value Token string to set in config
+     */
+    set Token(value: string | undefined);
+    /**
+     * Get the Tools for the Agent
+     * Includes both config tools and dynamically added tools
+     * @returns Array of PSAgentTool instances
+     */
+    get Tools(): PSAgentTool[];
+    /**
+     * Get the Tasks for the Agent
+     * Includes both config tasks and dynamically added tasks
+     * @returns Array of PSAgentTask instances
+     */
+    get Tasks(): PSAgentTask[];
+    /**
+     * Get the Agent ID after starting the agent
+     * @returns Agent ID string or undefined if not started
+     */
+    get AgentId(): string | undefined;
+    /**
+     * Get the Correlation ID after starting the agent
+     * @returns Correlation ID string or undefined if not started
+     */
+    get CorrelationId(): string | undefined;
+    /**
+     * Add tools to the agent dynamically
+     * @param tool PSAgentTool to add to the agent
+     */
+    addTool(tool: PSAgentTool): void;
+    private getToken;
+    private getAuthHeaders;
+    private getBaseUrl;
+    /**
+     * start a new temp agent on the agent platform
+     * @param input input to the agent the schema should match InputSchema if provided
+     * @param history history of messages for agent context
+     * @param log logger to use for logging, defaults to agent's logger
+     * @returns Correlation ID of the started agent
+     */
+    start(input: Object, history?: any[], log?: PSAgentLogger): Promise<string>;
+    /**
+     * resume the agent with tool output after a tool execution or human input
+     * @param tooloutput output from the tool execution to send back to the agent
+     * @returns
+     */
+    resume(tooloutput: Record<string, any>): Promise<Record<string, any>>;
+    /**
+     * deletes the agent running on the platform
+     * @param log optional logger to use for logging, defaults to agent's logger
+     */
+    cancel(log?: PSAgentLogger): Promise<void>;
+    /**
+     * Gets all the events for the current agent run identified correlation ID
+     * @returns Array of event objects for the current agent's correlation ID
+     * @see https://dev.lionis.ai/api/v1/events/events?correlationId={{correlation_id}}
+     */
+    getEvents(): Promise<Array<Record<string, any>>>;
+    /**
+     * Invoke the tool with the given name and input
+     * @remarks
+     * The input object should match the tool's input schema
+     *
+     * @param toolName name of the tool to execute
+     * @param input input object for the tool execution should match tool's input schema
+     * @param log logger to use for logging, defaults to agent's logger
+     * @returns output from the tool execution or error if any
+     *
+     * @example
+     * Example input for PSArtifactTool:
+     * ```json
+     * {
+     *   "name": "example_artifact",
+     *   "action": "write",
+     *   "content": "This is an example artifact content."
+     * }
+     * ```
+     */
+    executeTool(toolName: string, input: Record<string, any>, log?: PSAgentLogger): Promise<IPSAgentToolResult>;
+    /**
+     *
+     * @param requestContext
+     * @param eventBus
+     * @returns
+     */
+    execute(requestContext: RequestContext, eventBus: ExecutionEventBus): Promise<void>;
+    private getHostIPAddress;
+    /**
+     * Port for A2A express server
+     * @returns Port number from config or default 41241
+     */
+    private getPort;
+    /**
+     *
+     * @param taskStore Optional TaskStore, defaults to InMemoryTaskStore
+     * @returns A2A Express app
+     */
+    getServer(taskStore?: TaskStore): {
+        app: express.Express;
+        port: number;
+    };
+    getAgentCard(): AgentCard;
+    static FromConfigFile(config_path: string): PSAgent;
+}