@voltagent/core 1.2.18 → 1.2.20

package/dist/index.d.mts

@@ -457,6 +457,11 @@ type ProviderTextResponse<TOriginalResponse> = {
 type StreamPart = TextStreamPart<any> & {
     subAgentId?: string;
     subAgentName?: string;
+    executingAgentId?: string;
+    executingAgentName?: string;
+    parentAgentId?: string;
+    parentAgentName?: string;
+    agentPath?: string[];
 };
 /**
  * Response type for text streaming operations
@@ -1986,6 +1991,15 @@ type VoltOpsDiscordCredential = VoltOpsStoredCredentialRef | WithCredentialMetad
 }> | WithCredentialMetadata<{
     webhookUrl: string;
 }>;
+type VoltOpsPostgresCredential = VoltOpsStoredCredentialRef | WithCredentialMetadata<{
+    host: string;
+    port?: number;
+    user: string;
+    password: string;
+    database: string;
+    ssl?: boolean;
+    rejectUnauthorized?: boolean;
+}>;
 type VoltOpsGmailCredential = VoltOpsStoredCredentialRef | WithCredentialMetadata<{
     accessToken?: string;
     refreshToken?: string;
@@ -2176,6 +2190,22 @@ interface VoltOpsDiscordMemberRoleParams extends VoltOpsDiscordBaseParams {
     userId: string;
     roleId: string;
 }
+interface VoltOpsPostgresBaseParams {
+    credential: VoltOpsPostgresCredential;
+    actionId?: string;
+    catalogId?: string;
+    projectId?: string | null;
+}
+interface VoltOpsPostgresExecuteParams extends VoltOpsPostgresBaseParams {
+    query: string;
+    parameters?: unknown[];
+    applicationName?: string;
+    statementTimeoutMs?: number;
+    connectionTimeoutMs?: number;
+    ssl?: {
+        rejectUnauthorized?: boolean;
+    };
+}
 interface VoltOpsGmailBaseParams {
     credential: VoltOpsGmailCredential;
     actionId?: string;
@@ -2258,6 +2288,9 @@ type VoltOpsActionsApi = {
         getEmail: (params: VoltOpsGmailGetEmailParams) => Promise<VoltOpsActionExecutionResult>;
         getThread: (params: VoltOpsGmailGetThreadParams) => Promise<VoltOpsActionExecutionResult>;
     };
+    postgres: {
+        executeQuery: (params: VoltOpsPostgresExecuteParams) => Promise<VoltOpsActionExecutionResult>;
+    };
 };
 interface VoltOpsEvalsApi {
     runs: {
@@ -2702,6 +2735,9 @@ declare class VoltOpsActionsClient {
         getEmail: (params: VoltOpsGmailGetEmailParams) => Promise<VoltOpsActionExecutionResult>;
         getThread: (params: VoltOpsGmailGetThreadParams) => Promise<VoltOpsActionExecutionResult>;
     };
+    readonly postgres: {
+        executeQuery: (params: VoltOpsPostgresExecuteParams) => Promise<VoltOpsActionExecutionResult>;
+    };
     constructor(transport: VoltOpsActionsTransport, options?: {
         useProjectEndpoint?: boolean;
     });
@@ -2722,6 +2758,7 @@ declare class VoltOpsActionsClient {
     private searchGmailEmails;
     private getGmailEmail;
     private getGmailThread;
+    private executePostgresQuery;
     private sendDiscordMessage;
     private sendDiscordWebhookMessage;
     private deleteDiscordMessage;
@@ -2749,6 +2786,7 @@ declare class VoltOpsActionsClient {
     private ensureSlackCredential;
     private ensureDiscordCredential;
     private ensureGmailCredential;
+    private ensurePostgresCredential;
     private normalizeCredentialMetadata;
     private normalizeIdentifier;
     private ensureRecord;
@@ -3051,10 +3089,29 @@ type VoltAgentTextStreamPart<TOOLS extends Record<string, any> = Record<string,
      * Optional identifier for the subagent that generated this event
      */
     subAgentId?: string;
+    /**
+     * Optional identifier for the agent that actually executed the step
+     * (same as subAgentId for first-level handoffs)
+     */
+    executingAgentId?: string;
     /**
      * Optional name of the subagent that generated this event
      */
     subAgentName?: string;
+    /**
+     * Optional name of the agent that actually executed the step
+     * (same as subAgentName for first-level handoffs)
+     */
+    executingAgentName?: string;
+    /**
+     * Parent agent reference when forwarded through supervisors
+     */
+    parentAgentId?: string;
+    parentAgentName?: string;
+    /**
+     * Ordered list of agent names from supervisor -> executing agent
+     */
+    agentPath?: string[];
 };
 /**
  * Extended StreamTextResult that uses VoltAgentTextStreamPart for fullStream.

package/dist/index.d.ts

@@ -457,6 +457,11 @@ type ProviderTextResponse<TOriginalResponse> = {
 type StreamPart = TextStreamPart<any> & {
     subAgentId?: string;
     subAgentName?: string;
+    executingAgentId?: string;
+    executingAgentName?: string;
+    parentAgentId?: string;
+    parentAgentName?: string;
+    agentPath?: string[];
 };
 /**
  * Response type for text streaming operations
@@ -1986,6 +1991,15 @@ type VoltOpsDiscordCredential = VoltOpsStoredCredentialRef | WithCredentialMetad
 }> | WithCredentialMetadata<{
     webhookUrl: string;
 }>;
+type VoltOpsPostgresCredential = VoltOpsStoredCredentialRef | WithCredentialMetadata<{
+    host: string;
+    port?: number;
+    user: string;
+    password: string;
+    database: string;
+    ssl?: boolean;
+    rejectUnauthorized?: boolean;
+}>;
 type VoltOpsGmailCredential = VoltOpsStoredCredentialRef | WithCredentialMetadata<{
     accessToken?: string;
     refreshToken?: string;
@@ -2176,6 +2190,22 @@ interface VoltOpsDiscordMemberRoleParams extends VoltOpsDiscordBaseParams {
     userId: string;
     roleId: string;
 }
+interface VoltOpsPostgresBaseParams {
+    credential: VoltOpsPostgresCredential;
+    actionId?: string;
+    catalogId?: string;
+    projectId?: string | null;
+}
+interface VoltOpsPostgresExecuteParams extends VoltOpsPostgresBaseParams {
+    query: string;
+    parameters?: unknown[];
+    applicationName?: string;
+    statementTimeoutMs?: number;
+    connectionTimeoutMs?: number;
+    ssl?: {
+        rejectUnauthorized?: boolean;
+    };
+}
 interface VoltOpsGmailBaseParams {
     credential: VoltOpsGmailCredential;
     actionId?: string;
@@ -2258,6 +2288,9 @@ type VoltOpsActionsApi = {
         getEmail: (params: VoltOpsGmailGetEmailParams) => Promise<VoltOpsActionExecutionResult>;
         getThread: (params: VoltOpsGmailGetThreadParams) => Promise<VoltOpsActionExecutionResult>;
     };
+    postgres: {
+        executeQuery: (params: VoltOpsPostgresExecuteParams) => Promise<VoltOpsActionExecutionResult>;
+    };
 };
 interface VoltOpsEvalsApi {
     runs: {
@@ -2702,6 +2735,9 @@ declare class VoltOpsActionsClient {
         getEmail: (params: VoltOpsGmailGetEmailParams) => Promise<VoltOpsActionExecutionResult>;
         getThread: (params: VoltOpsGmailGetThreadParams) => Promise<VoltOpsActionExecutionResult>;
     };
+    readonly postgres: {
+        executeQuery: (params: VoltOpsPostgresExecuteParams) => Promise<VoltOpsActionExecutionResult>;
+    };
     constructor(transport: VoltOpsActionsTransport, options?: {
         useProjectEndpoint?: boolean;
     });
@@ -2722,6 +2758,7 @@ declare class VoltOpsActionsClient {
     private searchGmailEmails;
     private getGmailEmail;
     private getGmailThread;
+    private executePostgresQuery;
     private sendDiscordMessage;
     private sendDiscordWebhookMessage;
     private deleteDiscordMessage;
@@ -2749,6 +2786,7 @@ declare class VoltOpsActionsClient {
     private ensureSlackCredential;
     private ensureDiscordCredential;
     private ensureGmailCredential;
+    private ensurePostgresCredential;
     private normalizeCredentialMetadata;
     private normalizeIdentifier;
     private ensureRecord;
@@ -3051,10 +3089,29 @@ type VoltAgentTextStreamPart<TOOLS extends Record<string, any> = Record<string,
      * Optional identifier for the subagent that generated this event
      */
     subAgentId?: string;
+    /**
+     * Optional identifier for the agent that actually executed the step
+     * (same as subAgentId for first-level handoffs)
+     */
+    executingAgentId?: string;
     /**
      * Optional name of the subagent that generated this event
      */
     subAgentName?: string;
+    /**
+     * Optional name of the agent that actually executed the step
+     * (same as subAgentName for first-level handoffs)
+     */
+    executingAgentName?: string;
+    /**
+     * Parent agent reference when forwarded through supervisors
+     */
+    parentAgentId?: string;
+    parentAgentName?: string;
+    /**
+     * Ordered list of agent names from supervisor -> executing agent
+     */
+    agentPath?: string[];
 };
 /**
  * Extended StreamTextResult that uses VoltAgentTextStreamPart for fullStream.

package/dist/index.js

@@ -5850,6 +5850,21 @@ var WorkflowStreamWriterImpl = class {
       if (part.subAgentName) {
         metadata.subAgentName = part.subAgentName;
       }
+      if (part.executingAgentId) {
+        metadata.executingAgentId = part.executingAgentId;
+      }
+      if (part.executingAgentName) {
+        metadata.executingAgentName = part.executingAgentName;
+      }
+      if (part.parentAgentId) {
+        metadata.parentAgentId = part.parentAgentId;
+      }
+      if (part.parentAgentName) {
+        metadata.parentAgentName = part.parentAgentName;
+      }
+      if (part.agentPath) {
+        metadata.agentPath = part.agentPath;
+      }
       let input;
       let output;
       let status;
@@ -8982,6 +8997,9 @@ var VoltOpsActionsClient = class {
       getEmail: this.getGmailEmail.bind(this),
       getThread: this.getGmailThread.bind(this)
     };
+    this.postgres = {
+      executeQuery: this.executePostgresQuery.bind(this)
+    };
   }
   static {
     __name(this, "VoltOpsActionsClient");
@@ -8990,6 +9008,7 @@ var VoltOpsActionsClient = class {
   slack;
   discord;
   gmail;
+  postgres;
   useProjectEndpoint;
   get actionExecutionPath() {
     return this.useProjectEndpoint ? "/actions/project/run" : "/actions/execute";
@@ -9453,6 +9472,60 @@ var VoltOpsActionsClient = class {
       input
     });
   }
+  async executePostgresQuery(params) {
+    if (!params || typeof params !== "object") {
+      throw new VoltOpsActionError("params must be provided", 400);
+    }
+    const credential = this.ensurePostgresCredential(params.credential);
+    const query = this.trimString(params.query);
+    if (!query) {
+      throw new VoltOpsActionError("query must be provided", 400);
+    }
+    const parameters = Array.isArray(params.parameters) ? params.parameters : [];
+    const applicationName = this.trimString(params.applicationName);
+    const statementTimeoutMs = this.normalizePositiveInteger(
+      params.statementTimeoutMs,
+      "statementTimeoutMs",
+      { allowZero: false }
+    );
+    const connectionTimeoutMs = this.normalizePositiveInteger(
+      params.connectionTimeoutMs,
+      "connectionTimeoutMs",
+      { allowZero: false }
+    );
+    const ssl = params.ssl && typeof params.ssl === "object" && !Array.isArray(params.ssl) ? {
+      rejectUnauthorized: typeof params.ssl.rejectUnauthorized === "boolean" ? params.ssl.rejectUnauthorized : void 0
+    } : void 0;
+    const input = {
+      query
+    };
+    if (parameters.length) {
+      input.parameters = parameters;
+    }
+    if (applicationName) {
+      input.applicationName = applicationName;
+    }
+    if (typeof statementTimeoutMs === "number") {
+      input.statementTimeoutMs = statementTimeoutMs;
+    }
+    if (typeof connectionTimeoutMs === "number") {
+      input.connectionTimeoutMs = connectionTimeoutMs;
+    }
+    if (ssl) {
+      input.ssl = ssl;
+    }
+    const payload = {
+      credential,
+      catalogId: params.catalogId ?? void 0,
+      actionId: params.actionId ?? "postgres.executeQuery",
+      projectId: params.projectId ?? void 0,
+      payload: {
+        input
+      }
+    };
+    const response = await this.postActionExecution(this.actionExecutionPath, payload);
+    return this.mapActionExecution(response);
+  }
   async sendDiscordMessage(params) {
     if (!params || typeof params !== "object") {
       throw new VoltOpsActionError("params must be provided", 400);
@@ -10052,6 +10125,51 @@ var VoltOpsActionsClient = class {
     }
     return payload;
   }
+  ensurePostgresCredential(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+      throw new VoltOpsActionError("credential must be an object", 400);
+    }
+    const record = value;
+    const metadata = this.normalizeCredentialMetadata(record.metadata);
+    const storedId = this.trimString(
+      typeof record.credentialId === "string" ? record.credentialId : typeof record.id === "string" ? record.id : void 0
+    );
+    if (storedId) {
+      return metadata ? { credentialId: storedId, metadata } : { credentialId: storedId };
+    }
+    const host = this.trimString(record.host);
+    const user = this.trimString(record.user);
+    const password = this.trimString(record.password);
+    const database = this.trimString(record.database);
+    if (!host || !user || !password || !database) {
+      throw new VoltOpsActionError(
+        "credential must include host, user, password, and database for Postgres actions",
+        400
+      );
+    }
+    const port = typeof record.port === "number" && Number.isFinite(record.port) ? Math.trunc(record.port) : void 0;
+    const ssl = typeof record.ssl === "boolean" ? record.ssl : void 0;
+    const rejectUnauthorized = typeof record.rejectUnauthorized === "boolean" ? record.rejectUnauthorized : void 0;
+    const payload = {
+      host,
+      user,
+      password,
+      database
+    };
+    if (port !== void 0) {
+      payload.port = port;
+    }
+    if (ssl !== void 0) {
+      payload.ssl = ssl;
+    }
+    if (rejectUnauthorized !== void 0) {
+      payload.rejectUnauthorized = rejectUnauthorized;
+    }
+    if (metadata) {
+      payload.metadata = metadata;
+    }
+    return payload;
+  }
   normalizeCredentialMetadata(metadata) {
     if (metadata === void 0 || metadata === null) {
       return void 0;
@@ -10116,7 +10234,7 @@ var VoltOpsActionsClient = class {
     }
     return entries.length > 0 ? entries : void 0;
   }
-  normalizePositiveInteger(value, field) {
+  normalizePositiveInteger(value, field, options) {
     if (value === void 0 || value === null) {
       return void 0;
     }
@@ -10124,8 +10242,9 @@ var VoltOpsActionsClient = class {
       throw new VoltOpsActionError(`${field} must be a finite number`, 400);
     }
     const normalized = Math.floor(value);
-    if (normalized <= 0) {
-      throw new VoltOpsActionError(`${field} must be greater than 0`, 400);
+    const allowZero = options?.allowZero ?? false;
+    if (normalized < 0 || !allowZero && normalized === 0) {
+      throw new VoltOpsActionError(`${field} must be greater than ${allowZero ? "-1" : "0"}`, 400);
     }
     return normalized;
   }
@@ -15994,11 +16113,11 @@ function createMetadataEnrichedStream(originalStream, metadata, allowedTypes) {
               type: SUBAGENT_DATA_EVENT_TYPE,
               // Don't include id to prevent overwriting in AI SDK - each delta should be a new part
               data: {
-                subAgentName: metadata.subAgentName,
-                subAgentId: metadata.subAgentId,
-                originalType: chunkObj.type,
-                // Include all original chunk data
-                ...chunkObj
+                // Include original chunk first so metadata can override it
+                ...chunkObj,
+                ...metadata,
+                // Preserve the original event type for consumers
+                originalType: chunkObj.type
               }
             };
             controller.enqueue(dataEvent);
@@ -16300,6 +16419,10 @@ Context: ${(0, import_utils17.safeStringify)(contextObj, { indentation: 2 })}`;
       };
       if (this.isDirectAgent(targetAgentConfig)) {
         const response = await targetAgent.streamText(messages, baseOptions);
+        const forwardingMetadata = this.buildForwardingMetadata(
+          targetAgent,
+          parentOperationContext
+        );
         const uiStreamWriter = parentOperationContext?.systemContext?.get(
           "uiStreamWriter"
         );
@@ -16310,10 +16433,7 @@ Context: ${(0, import_utils17.safeStringify)(contextObj, { indentation: 2 })}`;
           const subagentUIStream = response.toUIMessageStream();
           const enrichedStream = createMetadataEnrichedStream(
             subagentUIStream,
-            {
-              subAgentId: targetAgent.id,
-              subAgentName: targetAgent.name
-            },
+            forwardingMetadata,
             this.supervisorConfig?.fullStreamEventForwarding?.types || ["tool-call", "tool-result"]
           );
           uiStreamWriter.merge(enrichedStream);
@@ -16331,8 +16451,7 @@ Context: ${(0, import_utils17.safeStringify)(contextObj, { indentation: 2 })}`;
                 }
                 const enrichedPart = {
                   ...part,
-                  subAgentId: targetAgent.id,
-                  subAgentName: targetAgent.name
+                  ...forwardingMetadata
                 };
                 this.registerToolCallMetadata(parentOperationContext, enrichedPart, targetAgent);
                 await fullStreamWriter.write(enrichedPart);
@@ -16358,6 +16477,10 @@ Context: ${(0, import_utils17.safeStringify)(contextObj, { indentation: 2 })}`;
       } else if (this.isStreamTextConfig(targetAgentConfig)) {
         const options2 = { ...baseOptions, ...targetAgentConfig.options };
         const response = await targetAgent.streamText(messages, options2);
+        const forwardingMetadata = this.buildForwardingMetadata(
+          targetAgent,
+          parentOperationContext
+        );
         const uiStreamWriter = parentOperationContext?.systemContext?.get(
           "uiStreamWriter"
         );
@@ -16368,10 +16491,7 @@ Context: ${(0, import_utils17.safeStringify)(contextObj, { indentation: 2 })}`;
           const subagentUIStream = response.toUIMessageStream();
           const enrichedStream = createMetadataEnrichedStream(
             subagentUIStream,
-            {
-              subAgentId: targetAgent.id,
-              subAgentName: targetAgent.name
-            },
+            forwardingMetadata,
             this.supervisorConfig?.fullStreamEventForwarding?.types || ["tool-call", "tool-result"]
           );
           uiStreamWriter.merge(enrichedStream);
@@ -16389,8 +16509,7 @@ Context: ${(0, import_utils17.safeStringify)(contextObj, { indentation: 2 })}`;
                 }
                 const enrichedPart = {
                   ...part,
-                  subAgentId: targetAgent.id,
-                  subAgentName: targetAgent.name
+                  ...forwardingMetadata
                 };
                 this.registerToolCallMetadata(parentOperationContext, enrichedPart, targetAgent);
                 await fullStreamWriter.write(enrichedPart);
@@ -16686,6 +16805,18 @@ Context: ${(0, import_utils17.safeStringify)(contextObj, { indentation: 2 })}`;
       return subAgentData;
     });
   }
+  buildForwardingMetadata(agent, oc) {
+    const parentMetadata = oc?.systemContext?.get(AGENT_METADATA_CONTEXT_KEY);
+    return {
+      subAgentId: agent.id,
+      subAgentName: agent.name,
+      executingAgentId: agent.id,
+      executingAgentName: agent.name,
+      parentAgentId: parentMetadata?.agentId,
+      parentAgentName: parentMetadata?.agentName,
+      agentPath: parentMetadata ? [parentMetadata.agentName, agent.name] : [agent.name]
+    };
+  }
   registerToolCallMetadata(oc, part, agent) {
     if (!oc || !part?.type || !part.type.startsWith("tool-") || !part.toolCallId) {
       return;