psadk 1.1.0

package/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Changelog
+
+## 1.1.0 (2025-09-17)
+
+### Features
+
+- add @modelcontextprotocol/sdk dependency and enhance PSAI class with LLM proxy functionality ([c8cf308](https://pscode.lioncloud.net///commit/c8cf308c1420ffc25cde720df11270e08c253c58))
+
+### Bug Fixes
+
+- update samples link in README.md ([93815a9](https://pscode.lioncloud.net///commit/93815a9a77d595298d363ef31707cdf76a2fd7d2))

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2019 Rakesh Ravuri
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,205 @@
+# PSADK
+
+ps adk adapter
+
+- [samples](https://pscode.lioncloud.net/agents/psadk_samples) : sample agents using PSADK
+
+## Documentation
+
+The classes are documented here [Documentation](./globals.md)
+
+## Developing with PSADK
+
+### A2A Server
+
+#### hello agent - simple chat agent
+
+clone of https://github.com/a2aproject/a2a-samples/blob/main/samples/js/src/agents/coder/index.ts
+
+```typescript
+import { getServiceToken, PSAgent, PSAgentLogger } from 'psadk';
+import dotenv from 'dotenv';
+
+dotenv.config();
+
+async function main() {
+  const token = await getServiceToken({});
+  const HelloAgent = new PSAgent({
+    name: 'HelloAgent',
+    description: 'A simple hello world agent',
+    instruction: 'You are a friendly assistant that greets users.',
+    token,
+    port: 41241,
+    log: new PSAgentLogger({ prefix: 'HelloAgent' }),
+  });
+  const { app } = HelloAgent.getA2AServer();
+  app.listen(41241, () => {
+    console.log('HelloAgent is running on http://localhost:41241');
+  });
+}
+
+main().catch((error) => {
+  console.error(error);
+  process.exit(1);
+});
+```
+
+create a .env file with the appropriate keys
+
+```bash
+PS_API_URL=https://dev.lionis.ai
+PS_APP_KEY=sk_0abb4....
+
+PS_CLIENT_ID=b5cc89b7-....
+PS_PROJECT_ID=15a2e....
+PS_WORKSPACE_ID=4ffba209-xxx-xxx-xxx-....
+
+PS_SVC_CLIENT_ID=0483....
+PS_SVC_CLIENT_SECRET=gfjt678...
+PS_SVC_APP_KEY=sk_5f2967....
+DEBUG=*
+
+```
+
+#### movie info agent - example with custom tools
+
+clone of https://github.com/a2aproject/a2a-samples/blob/main/samples/js/src/agents/movie-agent/index.ts
+
+```typescript
+import { PSAI, PSAgent, PSAgentLogger } from 'psadk';
+import dotenv from 'dotenv';
+import { movie_search_tool, movie_searchpeople_tool } from './tmdb_tools.js';
+import { prompt } from './movie_agent_prompts.js';
+dotenv.config();
+
+async function main() {
+  // const token = await PSAI.getServiceToken({});
+  const token = (await PSAI.getAuthToken()).accessToken;
+  const instruction = prompt.replace('{{now}}', new Date().toLocaleString());
+  const MovieAgent = new PSAgent({
+    name: 'MovieAgent',
+    description: 'An agent that can answer questions about movies using TMDB.',
+    instruction,
+    model: 'gpt-4.1-mini',
+    token,
+    port: 41241,
+    log: new PSAgentLogger({ prefix: 'MovieAgent' }),
+    tools: [movie_search_tool, movie_searchpeople_tool],
+  });
+  const { app, port } = MovieAgent.getA2AServer();
+  app.listen(port, () => {
+    console.log(`MovieAgent is running on http://localhost:${port}`);
+  });
+}
+
+main().catch((error) => {
+  console.error(error);
+  process.exit(1);
+});
+```
+
+Use can use [a2a inspector ui](https://a2a-inspector-908687846511.us-central1.run.app/)
+just enter the agent card url http://localhost:41241/.well-known/agent-card.json to interact with the agent
+
+#### Custom tool
+
+```typescript
+import { PSAgentTool } from 'psadk';
+import { z } from 'zod/v4';
+
+export const movie_search_tool = new PSAgentTool({
+  name: 'search_movies',
+  description: 'search TMDB for movies by title',
+  type: 'API',
+  local_execution: true,
+  hitl: true,
+  inputschema: {
+    title: `search_movies_inputs.`,
+    description: 'Inputs for search_movies tool.',
+    url: 'http://localhost/search_movies',
+    method: 'POST',
+    requestBody: z.toJSONSchema(
+      z
+        .object({
+          query: z.string().meta({
+            title: 'query',
+            description: 'The search query string for movies.',
+          }),
+        })
+        .meta({
+          title: 'search_movies_request_body',
+          description:
+            'The request body parameters for the search_movies tool.',
+        }),
+      { io: 'input' },
+    ),
+  },
+  runCallback: async ({ query }) => {
+    console.log('[tmdb:searchMovies]', JSON.stringify(query));
+    try {
+      const data = await callTmdbApi('movie', query);
+
+      // Only modify image paths to be full URLs
+      const results = data.results.map((movie: any) => {
+        if (movie.poster_path) {
+          movie.poster_path = `https://image.tmdb.org/t/p/w500${movie.poster_path}`;
+        }
+        if (movie.backdrop_path) {
+          movie.backdrop_path = `https://image.tmdb.org/t/p/w500${movie.backdrop_path}`;
+        }
+        return movie;
+      });
+
+      return {
+        status: 'success',
+        output: {
+          ...data,
+          results,
+        },
+      };
+    } catch (error) {
+      console.error('Error searching movies:', error);
+      // Re-throwing allows the caller to handle it appropriately
+      throw error;
+    }
+  },
+});
+```
+
+### Client: Sending a Message
+
+The A2AClient makes it easy to communicate with any A2A-compliant agent.
+
+```typescript
+// client.ts
+import { A2AClient, SendMessageSuccessResponse } from '@a2a-js/sdk/client';
+import { Message, MessageSendParams } from '@a2a-js/sdk';
+import { v4 as uuidv4 } from 'uuid';
+
+async function run() {
+  // Create a client pointing to the agent's Agent Card URL.
+  const client = await A2AClient.fromCardUrl(
+    'http://localhost:41241/.well-known/agent-card.json',
+  );
+
+  const sendParams: MessageSendParams = {
+    message: {
+      messageId: uuidv4(),
+      role: 'user',
+      parts: [{ kind: 'text', text: 'Hi there!' }],
+      kind: 'message',
+    },
+  };
+
+  const response = await client.sendMessage(sendParams);
+
+  if ('error' in response) {
+    console.error('Error:', response.error.message);
+  } else {
+    const result = (response as SendMessageSuccessResponse).result as Message;
+    console.log('Agent response:', result.parts[0].text); // "Hello, world!"
+  }
+}
+
+await run();
+```

package/build/main/index.d.ts

@@ -0,0 +1,6 @@
+export * from './lib/PSAI';
+export * from './lib/PSAgent';
+export * from './lib/PSAgentConfig';
+export * from './lib/PSAgentLogger';
+export * from './lib/PSAgentTool';
+export * from './lib/PSAgentTask';

package/build/main/index.js

@@ -0,0 +1,23 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./lib/PSAI"), exports);
+__exportStar(require("./lib/PSAgent"), exports);
+__exportStar(require("./lib/PSAgentConfig"), exports);
+__exportStar(require("./lib/PSAgentLogger"), exports);
+__exportStar(require("./lib/PSAgentTool"), exports);
+__exportStar(require("./lib/PSAgentTask"), exports);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7Ozs7Ozs7OztBQUFBLDZDQUEyQjtBQUMzQixnREFBOEI7QUFDOUIsc0RBQW9DO0FBQ3BDLHNEQUFvQztBQUNwQyxvREFBa0M7QUFDbEMsb0RBQWtDIn0=

package/build/main/lib/ILogger.d.ts

@@ -0,0 +1,9 @@
+export type AgentLoggerType = 'debug' | 'info' | 'error' | 'warn' | 'done';
+export default class PSAgentLogger {
+    log(type: string, message: any, ...optionalParams: any[]): void;
+    debug(message: string, ...optionalParams: any[]): void;
+    info(message: string, ...optionalParams: any[]): void;
+    error(message: string, ...optionalParams: any[]): void;
+    warn(message: string, ...optionalParams: any[]): void;
+    done(message?: string, ...optionalParams: any[]): void;
+}

package/build/main/lib/ILogger.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+console.log;
+class PSAgentLogger {
+    log(type, message, ...optionalParams) {
+        console.log(`[${new Date().toISOString()}] [${type.toUpperCase()}] ${message}`, ...optionalParams);
+    }
+    debug(message, ...optionalParams) {
+        this.log('debug', message, ...optionalParams);
+    }
+    info(message, ...optionalParams) {
+        this.log('info', message, ...optionalParams);
+    }
+    error(message, ...optionalParams) {
+        this.log('error', message, ...optionalParams);
+    }
+    warn(message, ...optionalParams) {
+        this.log('warn', message, ...optionalParams);
+    }
+    done(message = '', ...optionalParams) {
+        this.log('done', message, ...optionalParams);
+    }
+}
+exports.default = PSAgentLogger;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiSUxvZ2dlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9saWIvSUxvZ2dlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOztBQUNBLE9BQU8sQ0FBQyxHQUFHLENBQUE7QUFFWCxNQUFxQixhQUFhO0lBQ2hDLEdBQUcsQ0FBQyxJQUFZLEVBQUUsT0FBVyxFQUFFLEdBQUcsY0FBb0I7UUFDcEQsT0FBTyxDQUFDLEdBQUcsQ0FBQyxJQUFJLElBQUksSUFBSSxFQUFFLENBQUMsV0FBVyxFQUFFLE1BQU0sSUFBSSxDQUFDLFdBQVcsRUFBRSxLQUFLLE9BQU8sRUFBRSxFQUFFLEdBQUcsY0FBYyxDQUFDLENBQUM7SUFDckcsQ0FBQztJQUNNLEtBQUssQ0FBQyxPQUFlLEVBQUUsR0FBRyxjQUFvQjtRQUNuRCxJQUFJLENBQUMsR0FBRyxDQUFDLE9BQU8sRUFBRSxPQUFPLEVBQUUsR0FBRyxjQUFjLENBQUMsQ0FBQztJQUNoRCxDQUFDO0lBQ00sSUFBSSxDQUFDLE9BQWUsRUFBRSxHQUFHLGNBQW9CO1FBQ2xELElBQUksQ0FBQyxHQUFHLENBQUMsTUFBTSxFQUFFLE9BQU8sRUFBRSxHQUFHLGNBQWMsQ0FBQyxDQUFDO0lBQy9DLENBQUM7SUFDTSxLQUFLLENBQUMsT0FBZSxFQUFFLEdBQUcsY0FBb0I7UUFDbkQsSUFBSSxDQUFDLEdBQUcsQ0FBQyxPQUFPLEVBQUUsT0FBTyxFQUFFLEdBQUcsY0FBYyxDQUFDLENBQUM7SUFDaEQsQ0FBQztJQUNNLElBQUksQ0FBQyxPQUFlLEVBQUUsR0FBRyxjQUFvQjtRQUNsRCxJQUFJLENBQUMsR0FBRyxDQUFDLE1BQU0sRUFBRSxPQUFPLEVBQUUsR0FBRyxjQUFjLENBQUMsQ0FBQztJQUMvQyxDQUFDO0lBQ00sSUFBSSxDQUFDLFVBQWtCLEVBQUUsRUFBRSxHQUFHLGNBQW9CO1FBQ3ZELElBQUksQ0FBQyxHQUFHLENBQUMsTUFBTSxFQUFFLE9BQU8sRUFBRSxHQUFHLGNBQWMsQ0FBQyxDQUFDO0lBQy9DLENBQUM7Q0FDRjtBQW5CRCxnQ0FtQkMifQ==

package/build/main/lib/PSAI.d.ts

@@ -0,0 +1,29 @@
+import { PSAgentLogger } from './PSAgentLogger';
+export declare class PSAI {
+    private readonly token;
+    private dimensions;
+    private readonly baseUrl;
+    private readonly log;
+    private readonly clientid?;
+    constructor(token: string, baseUrl?: string, log?: PSAgentLogger);
+    getDimensions(embeddingModel?: string): number;
+    embedQuery(text: string, embeddingModel?: string): Promise<number[]>;
+    embedDocuments(text: string[], embeddingModel?: string): Promise<number[][]>;
+    getModels(): Promise<any>;
+    llm(prompt: string, model?: string, systemmsg?: string): Promise<unknown>;
+    static getServiceToken(options?: Record<string, string>): Promise<string>;
+    /**
+     * 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 getAuthToken(options?: Record<string, string>): Promise<{
+        accessToken: string;
+        refreshToken: string;
+    }>;
+    static getLLMproxy({ headers, baseapiurl }?: {
+        headers?: Record<string, string>;
+        baseapiurl?: string;
+    }): import("express-serve-static-core").Express;
+}