psadk 1.4.8 → 1.5.0

package/build/module/lib/localAgent.js

@@ -0,0 +1,329 @@
+"use strict";
+/**
+ * Local agent helpers — plain functions, no class.
+ *
+ * Three responsibilities extracted from PSAgent so the class stays lean:
+ *   1. buildLocalAgent   — construct an agent-core Agent from PSAgentLocalConfig
+ *   2. convertTools      — map PSAgentTool[] → agent-core tool descriptors
+ *   3. executeLocalAgent — bridge a local Agent run into an A2A event bus
+ *
+ * Nothing here is exported from the public barrel. Consumers interact with
+ * local mode exclusively through PSAgent's public API.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convertTools = convertTools;
+exports.buildLocalAgent = buildLocalAgent;
+exports.executeLocalAgent = executeLocalAgent;
+const uuid_1 = require("uuid");
+const agent_js_1 = require("./agent-core/src/agent.js");
+const apiEndpoints_1 = require("./utils/apiEndpoints");
+// ─── 1. convertTools ──────────────────────────────────────────────────────────
+/**
+ * Maps PSAgentTool[] into the tool descriptor shape expected by agent-core.
+ */
+function convertTools(tools, log, options) {
+    return tools.map((psTool) => ({
+        name: psTool.Name,
+        label: psTool.Name,
+        description: psTool.Description,
+        parameters: psTool.Inputs.requestBody,
+        execute: async (toolCallId, input, signal, onUpdate) => {
+            try {
+                const result = await psTool.run(input, log, {
+                    toolCallId,
+                    signal,
+                    onUpdate,
+                    ...options,
+                });
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(result) }],
+                    details: result,
+                    ...(result?.terminate === true && { terminate: true }),
+                };
+            }
+            catch (err) {
+                throw new Error(`Tool ${psTool.Name} failed: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        },
+    }));
+}
+// ─── 2. buildLocalAgent ───────────────────────────────────────────────────────
+/**
+ * Constructs an agent-core Agent from a PSAgentLocalConfig.
+ *
+ * @param config     The local agent config.
+ * @param getBaseUrl Resolves a service base URL (forwarded from PSAgent).
+ * @param getTools   Returns the current tool list (called at build time so
+ *                   dynamically added tools via addTool() are included).
+ * @param log        Optional logger.
+ */
+function buildLocalAgent(config, getBaseUrl, getTools, log) {
+    const agentOptions = {
+        initialState: {
+            systemPrompt: config.instruction,
+            model: config.model
+                ? {
+                    id: config.model,
+                    name: config.model,
+                    api: 'openai-completions',
+                    provider: 'ps-llm',
+                    baseUrl: apiEndpoints_1.API_ENDPOINTS.LLM_SERVICE(getBaseUrl('llm'), ''),
+                    reasoning: config.llm_config?.reasoning_effort === 'medium' ||
+                        config.llm_config?.reasoning_effort === 'high',
+                    input: ['text', 'image'],
+                    cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
+                    contextWindow: config.llm_config?.context_window ?? 128000,
+                    maxTokens: config.llm_config?.max_completion_tokens ?? 4096,
+                }
+                : undefined,
+            tools: convertTools(getTools(), log),
+        },
+        ...(config.streamFn && { streamFn: config.streamFn }),
+        ...(config.transport && { transport: config.transport }),
+        ...(config.convertToLlm && { convertToLlm: config.convertToLlm }),
+        ...(config.transformContext && {
+            transformContext: config.transformContext,
+        }),
+        // Prefer an explicit getApiKey callback; fall back to config.token.
+        getApiKey: config.getApiKey ?? (config.token ? async () => config.token : undefined),
+        ...(config.onPayload && { onPayload: config.onPayload }),
+        ...(config.onResponse && { onResponse: config.onResponse }),
+        ...(config.beforeToolCall && { beforeToolCall: config.beforeToolCall }),
+        ...(config.afterToolCall && { afterToolCall: config.afterToolCall }),
+        ...(config.prepareNextTurn && { prepareNextTurn: config.prepareNextTurn }),
+        ...(config.sessionId && { sessionId: config.sessionId }),
+        ...(config.thinkingBudgets && { thinkingBudgets: config.thinkingBudgets }),
+        ...(config.maxRetryDelayMs !== undefined && {
+            maxRetryDelayMs: config.maxRetryDelayMs,
+        }),
+        ...(config.toolExecution && { toolExecution: config.toolExecution }),
+        ...(config.steeringMode && { steeringMode: config.steeringMode }),
+        ...(config.followUpMode && { followUpMode: config.followUpMode }),
+    };
+    const agent = new agent_js_1.Agent(agentOptions);
+    if (config.localListeners) {
+        for (const listener of config.localListeners) {
+            agent.subscribe(listener);
+        }
+    }
+    // U2: getHeaders wrapper — refresh non-auth headers before every LLM call.
+    // Mirrors the getToken/getApiKey pattern: instead of baking short-lived headers
+    // (e.g. X-App-Authorization, sage-trace-id) into model.headers at construction
+    // time, we call getHeaders() fresh on every streamFn invocation — including
+    // Turn 1. Authorization must NOT be returned from getHeaders; that is owned
+    // exclusively by getApiKey so the per-call bearer-token refresh works correctly.
+    if (config.getHeaders) {
+        const originalStreamFn = agent.streamFn;
+        agent.streamFn = async (model, context, options) => {
+            let freshHeaders = {};
+            try {
+                freshHeaders = await config.getHeaders();
+            }
+            catch (_err) {
+                // Non-fatal: proceed with existing model.headers (same convention as
+                // prepareNextTurn's catch-and-return-undefined behaviour).
+                // Errors are silently swallowed so a transient header-fetch failure
+                // doesn't crash the LLM call.
+            }
+            return originalStreamFn({ ...model, headers: { ...(model.headers ?? {}), ...freshHeaders } }, context, options);
+        };
+    }
+    return agent;
+}
+// ─── 3. executeLocalAgent ─────────────────────────────────────────────────────
+/**
+ * Bridges a local Agent run into an A2A ExecutionEventBus.
+ * Called from PSAgent.execute() when local: true.
+ */
+async function executeLocalAgent(agent, requestContext, eventBus, cancelledTasks, agentName, log) {
+    const userMessage = requestContext.userMessage;
+    const existingTask = requestContext.task;
+    const taskId = existingTask?.id || (0, uuid_1.v4)();
+    const contextId = userMessage.contextId || existingTask?.contextId || (0, uuid_1.v4)();
+    log?.info(`[${agentName}:LocalAgent] Processing message ${userMessage.messageId} for task ${taskId}`);
+    if (!existingTask) {
+        const initialTask = {
+            kind: 'task',
+            id: taskId,
+            contextId,
+            status: { state: 'submitted', timestamp: new Date().toISOString() },
+            history: [userMessage],
+            metadata: userMessage.metadata,
+            artifacts: [],
+        };
+        eventBus.publish(initialTask);
+    }
+    eventBus.publish({
+        kind: 'status-update',
+        taskId,
+        contextId,
+        status: {
+            state: 'working',
+            message: {
+                kind: 'message',
+                role: 'agent',
+                messageId: (0, uuid_1.v4)(),
+                parts: [{ kind: 'text', text: 'Starting local agent…' }],
+                taskId,
+                contextId,
+            },
+            timestamp: new Date().toISOString(),
+        },
+        final: false,
+    });
+    // Extract text input
+    let queryText = '';
+    for (const part of userMessage.parts ?? []) {
+        if (part.kind === 'text' && part.text) {
+            queryText += part.text;
+        }
+    }
+    if (!queryText) {
+        eventBus.publish({
+            kind: 'status-update',
+            taskId,
+            contextId,
+            status: {
+                state: 'failed',
+                message: {
+                    kind: 'message',
+                    role: 'agent',
+                    messageId: (0, uuid_1.v4)(),
+                    parts: [{ kind: 'text', text: 'No input message found to process.' }],
+                    taskId,
+                    contextId,
+                },
+                timestamp: new Date().toISOString(),
+            },
+            final: true,
+        });
+        return;
+    }
+    try {
+        const unsubscribe = agent.subscribe((event) => {
+            if (event.type === 'message_update' || event.type === 'message_start') {
+                const streamingText = event.message.role === 'assistant'
+                    ? event.message.content
+                        .filter((c) => c.type === 'text')
+                        .map((c) => c.text)
+                        .join('')
+                    : '';
+                if (streamingText) {
+                    eventBus.publish({
+                        kind: 'status-update',
+                        taskId,
+                        contextId,
+                        status: {
+                            state: 'working',
+                            message: {
+                                kind: 'message',
+                                role: 'agent',
+                                messageId: (0, uuid_1.v4)(),
+                                parts: [{ kind: 'text', text: streamingText }],
+                                taskId,
+                                contextId,
+                            },
+                            timestamp: new Date().toISOString(),
+                        },
+                        final: false,
+                    });
+                }
+            }
+        });
+        await agent.prompt(queryText);
+        await agent.waitForIdle();
+        unsubscribe();
+        if (cancelledTasks.has(taskId)) {
+            cancelledTasks.delete(taskId);
+            eventBus.publish({
+                kind: 'status-update',
+                taskId,
+                contextId,
+                status: { state: 'canceled', timestamp: new Date().toISOString() },
+                final: true,
+            });
+            eventBus.finished();
+            return;
+        }
+        const lastAssistant = [...agent.state.messages]
+            .reverse()
+            .find((m) => m.role === 'assistant');
+        const errorMessage = lastAssistant?.errorMessage;
+        const replyText = lastAssistant?.content
+            ?.filter((c) => c.type === 'text')
+            .map((c) => c.text)
+            .join('') ?? '';
+        if (errorMessage || lastAssistant?.stopReason === 'error') {
+            eventBus.publish({
+                kind: 'status-update',
+                taskId,
+                contextId,
+                status: {
+                    state: 'failed',
+                    message: {
+                        kind: 'message',
+                        role: 'agent',
+                        messageId: (0, uuid_1.v4)(),
+                        parts: [
+                            {
+                                kind: 'text',
+                                text: errorMessage ?? 'Local agent execution failed.',
+                            },
+                        ],
+                        taskId,
+                        contextId,
+                    },
+                    timestamp: new Date().toISOString(),
+                },
+                final: true,
+            });
+        }
+        else {
+            eventBus.publish({
+                kind: 'status-update',
+                taskId,
+                contextId,
+                status: {
+                    state: 'completed',
+                    message: {
+                        kind: 'message',
+                        role: 'agent',
+                        messageId: (0, uuid_1.v4)(),
+                        parts: [{ kind: 'text', text: replyText }],
+                        taskId,
+                        contextId,
+                    },
+                    timestamp: new Date().toISOString(),
+                },
+                final: true,
+            });
+        }
+    }
+    catch (error) {
+        log?.error(`[${agentName}:LocalAgent] Error processing task ${taskId}:`, error);
+        eventBus.publish({
+            kind: 'status-update',
+            taskId,
+            contextId,
+            status: {
+                state: 'failed',
+                message: {
+                    kind: 'message',
+                    role: 'agent',
+                    messageId: (0, uuid_1.v4)(),
+                    parts: [
+                        {
+                            kind: 'text',
+                            text: `Error: ${error instanceof Error ? error.message : String(error)}`,
+                        },
+                    ],
+                    taskId,
+                    contextId,
+                },
+                timestamp: new Date().toISOString(),
+            },
+            final: true,
+        });
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibG9jYWxBZ2VudC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9saWIvbG9jYWxBZ2VudC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiO0FBQUE7Ozs7Ozs7Ozs7R0FVRzs7QUFtQkgsb0NBbUNDO0FBYUQsMENBeUZDO0FBUUQsOENBeU5DO0FBelhELCtCQUFvQztBQUtwQyx3REFBa0Q7QUFHbEQsdURBQXFEO0FBRXJELGlGQUFpRjtBQUVqRjs7R0FFRztBQUNILFNBQWdCLFlBQVksQ0FDMUIsS0FBb0IsRUFDcEIsR0FBbUIsRUFDbkIsT0FBZ0M7SUFFaEMsT0FBTyxLQUFLLENBQUMsR0FBRyxDQUFDLENBQUMsTUFBTSxFQUFFLEVBQUUsQ0FBQyxDQUFDO1FBQzVCLElBQUksRUFBRSxNQUFNLENBQUMsSUFBSTtRQUNqQixLQUFLLEVBQUUsTUFBTSxDQUFDLElBQUk7UUFDbEIsV0FBVyxFQUFFLE1BQU0sQ0FBQyxXQUFXO1FBQy9CLFVBQVUsRUFBRSxNQUFNLENBQUMsTUFBTSxDQUFDLFdBQWtCO1FBQzVDLE9BQU8sRUFBRSxLQUFLLEVBQ1osVUFBa0IsRUFDbEIsS0FBMEIsRUFDMUIsTUFBb0IsRUFDcEIsUUFBdUQsRUFDdkQsRUFBRTtZQUNGLElBQUksQ0FBQztnQkFDSCxNQUFNLE1BQU0sR0FBRyxNQUFNLE1BQU0sQ0FBQyxHQUFHLENBQUMsS0FBSyxFQUFFLEdBQUcsRUFBRTtvQkFDMUMsVUFBVTtvQkFDVixNQUFNO29CQUNOLFFBQVE7b0JBQ1IsR0FBRyxPQUFPO2lCQUNYLENBQUMsQ0FBQztnQkFDSCxPQUFPO29CQUNMLE9BQU8sRUFBRSxDQUFDLEVBQUUsSUFBSSxFQUFFLE1BQWUsRUFBRSxJQUFJLEVBQUUsSUFBSSxDQUFDLFNBQVMsQ0FBQyxNQUFNLENBQUMsRUFBRSxDQUFDO29CQUNsRSxPQUFPLEVBQUUsTUFBTTtvQkFDZixHQUFHLENBQUMsTUFBTSxFQUFFLFNBQVMsS0FBSyxJQUFJLElBQUksRUFBRSxTQUFT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

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

@@ -0,0 +1,25 @@
+/**
+ * Remote agent A2A execution — plain function, no class.
+ *
+ * Bridges a remote PS platform agent run into an A2A ExecutionEventBus.
+ * Called from PSAgent.execute() when local: false (the default).
+ *
+ * Everything PSAgent-specific is passed in via RemoteAgentContext so this
+ * module has no dependency on PSAgent itself.
+ */
+import type { ExecutionEventBus, RequestContext } from '@a2a-js/sdk/server';
+import type { IStreamLogger } from './PSAgentLogger';
+import type { IPSAgentToolResult } from './PSAgentTool';
+/**
+ * Everything executeRemoteAgent needs from PSAgent, passed as a plain object.
+ * Keeps this module free of any PSAgent import / circular dependency.
+ */
+export interface RemoteAgentContext {
+    name: string;
+    log?: IStreamLogger;
+    cancelledTasks: Set<string>;
+    start: (input: object, messages: any[], log?: IStreamLogger) => Promise<string>;
+    getEvents: () => Promise<Array<Record<string, any>>>;
+    executeTool: (toolName: string, input: Record<string, any>, log?: IStreamLogger) => Promise<IPSAgentToolResult>;
+}
+export declare function executeRemoteAgent(ctx: RemoteAgentContext, requestContext: RequestContext, eventBus: ExecutionEventBus): Promise<void>;