@vertesia/client 1.1.1-dev.20260505.163000Z → 1.3.0-dev.20260620.061059Z

package/lib/{types/store → store}/AgentsApi.d.ts

@@ -1,5 +1,9 @@
-import { ApiTopic, ClientBase } from '@vertesia/api-fetch-client';
-import { ActiveWorkstreamsQueryResult, AgentEvent, AgentArtifactUrlResponse, AgentMessage, AgentRun, AgentRunDetailsStreamEvent, AgentRunInternals, CreateAgentRunPayload, ErrorAnalyticsResponse, FirstResponseBehaviorAnalyticsResponse, LatencyAnalyticsResponse, ListAgentRunsQuery, ListAgentRunsResponse, ListWorkflowRunsResponse, PromptSizeAnalyticsResponse, PostAgentRunUpdatePayload, PostAgentRunUpdateResponse, RecordAgentRunPayload, RunsByAgentAnalyticsResponse, SearchAgentRunsQuery, SearchAgentRunsResponse, SignalAgentPayload, SignalAgentResponse, TimeToFirstResponseAnalyticsResponse, TerminateAgentRunResponse, TokenUsageAnalyticsResponse, ToolAnalyticsResponse, ToolParameterAnalyticsResponse, TopPrincipalsAnalyticsResponse, UpdateAgentRunStatusPayload, WorkflowAnalyticsFilterOptionsResponse, WorkflowAnalyticsSummaryQuery, WorkflowAnalyticsSummaryResponse, WorkflowAnalyticsTimeSeriesQuery, WorkflowRunWithDetails, WorkflowToolParametersQuery, IngestAgentEventsResponse } from '@vertesia/common';
+import { ApiTopic, type ClientBase } from '@vertesia/api-fetch-client';
+import { type ActiveWorkstreamsQueryResult, type AgentArtifactUrlResponse, type AgentEvent, type AgentMessage, type AgentRun, type AgentRunDetailsStreamEvent, type AgentRunInternals, type AgentRunResponse, type BindRunWorkflowPayload, type CreateAgentRunPayload, type CreateProcessRunPayload, type ErrorAnalyticsResponse, type FirstResponseBehaviorAnalyticsResponse, type IngestAgentEventsResponse, type LatencyAnalyticsResponse, type ListAgentRunsQuery, type ListAgentRunsResponse, type ListWorkflowRunsResponse, type PostAgentRunUpdatePayload, type PostAgentRunUpdateResponse, type ProcessRun, type ProcessState, type PromptSizeAnalyticsResponse, type RecordAgentRunPayload, type RecordProcessRunPayload, type RunsByAgentAnalyticsResponse, type SearchAgentRunsQuery, type SearchAgentRunsResponse, type SignalAgentPayload, type SignalAgentResponse, type TerminateAgentRunResponse, type TimeToFirstResponseAnalyticsResponse, type TokenUsageAnalyticsResponse, type ToolAnalyticsResponse, type ToolParameterAnalyticsResponse, type TopPrincipalsAnalyticsResponse, type UpdateAgentRunStatusPayload, type WorkflowAnalyticsFilterOptionsResponse, type WorkflowAnalyticsSummaryQuery, type WorkflowAnalyticsSummaryResponse, type WorkflowAnalyticsTimeSeriesQuery, type WorkflowRunWithDetails, type WorkflowToolParametersQuery } from '@vertesia/common';
+export interface AgentRunStreamMessagesOptions {
+    onHistoryLoaded?: (messages: AgentMessage[]) => void;
+    onHistoryError?: (error: unknown) => void;
+}
 export declare class AgentsApi extends ApiTopic {
     constructor(parent: ClientBase);
     /**
@@ -7,19 +11,31 @@ export declare class AgentsApi extends ApiTopic {
      * Returns the created AgentRun with its stable id.
      */
     start<TData = Record<string, unknown>>(payload: CreateAgentRunPayload<TData>): Promise<AgentRun<TData>>;
+    start<TData = Record<string, unknown>>(payload: CreateProcessRunPayload<TData>): Promise<ProcessRun>;
     /**
-     * Record an AgentRun for an already-running workflow (e.g. schedule-triggered).
-     * Only creates the MongoDB document — the workflow passes its own Temporal IDs.
+     * Record a run for an already-running workflow. This only creates the
+     * MongoDB document; the caller owns the Temporal workflow ids.
+     *
+     * @internal
      */
+    recordRun<TData = Record<string, unknown>>(payload: RecordAgentRunPayload<TData>): Promise<AgentRun<TData>>;
+    recordRun<TData = Record<string, unknown>>(payload: RecordProcessRunPayload<TData>): Promise<ProcessRun>;
     createRecord(payload: RecordAgentRunPayload): Promise<AgentRun>;
     /**
      * Get agent run by id.
      */
     retrieve<TData = Record<string, unknown>>(id: string): Promise<AgentRun<TData>>;
+    /**
+     * Get any agent run by id, preserving the agent/process discriminator.
+     */
+    retrieveRun<TData = Record<string, unknown>, TProperties = Record<string, unknown>>(id: string): Promise<AgentRunResponse<TData, TProperties>>;
+    retrieveProcess(id: string): Promise<ProcessRun>;
     /**
      * List agent runs with optional filters.
      */
     list(query?: ListAgentRunsQuery): Promise<ListAgentRunsResponse>;
+    listProcessRuns(query?: Omit<ListAgentRunsQuery, 'run_kind'>): Promise<ProcessRun[]>;
+    private buildListQueryParams;
     /**
      * Search agent runs via Elasticsearch (full-text + filters).
      */
@@ -39,14 +55,46 @@ export declare class AgentsApi extends ApiTopic {
      * Fork a conversation into a new agent run.
      */
     fork(id: string): Promise<AgentRun>;
+    getContext(id: string): Promise<{
+        run_id: string;
+        current_node: string;
+        context: Record<string, unknown>;
+    }>;
+    getHistory(id: string): Promise<{
+        run_id: string;
+        current_node: string;
+        node_history: ProcessState['node_history'];
+        node_history_ref?: ProcessState['node_history_ref'];
+    }>;
+    advance(id: string, payload?: {
+        target?: string;
+        reason?: string;
+    }): Promise<{
+        message: string;
+    }>;
+    retryNode(id: string, payload?: {
+        node?: string;
+        reason?: string;
+    }): Promise<{
+        message: string;
+    }>;
+    answerTask(id: string, taskId: string, result: Record<string, unknown>): Promise<{
+        message: string;
+    }>;
     /**
      * Update agent run status/metadata.
      * Called by workflow activities to sync lifecycle state.
      */
-    updateStatus(id: string, update: UpdateAgentRunStatusPayload): Promise<AgentRun>;
+    updateStatus(id: string, update: UpdateAgentRunStatusPayload): Promise<AgentRun | ProcessRun>;
+    /**
+     * Attach Temporal workflow run ids to a pre-created run record.
+     *
+     * @internal
+     */
+    bindWorkflowRun(id: string, payload: BindRunWorkflowPayload): Promise<AgentRun | ProcessRun>;
     /**
      * Send a signal to a running agent.
-     * Signals: "UserInput", "Stop", "FileUploaded"
+     * Signals: "UserInput", "Stop", "FileUploaded", "FileRemoved"
      */
     sendSignal(id: string, signalName: string, payload?: SignalAgentPayload): Promise<SignalAgentResponse>;
     /**
@@ -73,7 +121,7 @@ export declare class AgentsApi extends ApiTopic {
      * Fetches historical messages via GET /updates (gzip-compressed),
      * then connects to SSE for real-time updates only.
      */
-    streamMessages(id: string, onMessage?: (message: AgentMessage, exitFn?: (payload: unknown) => void) => void, since?: number, signal?: AbortSignal): Promise<unknown>;
+    streamMessages(id: string, onMessage?: (message: AgentMessage, exitFn?: (payload: unknown) => void) => void, since?: number, signal?: AbortSignal, options?: AgentRunStreamMessagesOptions): Promise<unknown>;
     /**
      * Get internal/Temporal details for an agent run.
      * Returns fields normally stripped from client responses (workflow IDs, artifacts path).
@@ -85,6 +133,7 @@ export declare class AgentsApi extends ApiTopic {
      */
     getRunDetails(id: string, options?: {
         includeHistory?: boolean;
+        hydratePayloads?: boolean;
     }): Promise<WorkflowRunWithDetails>;
     /**
      * Stream Temporal history events via SSE (handles continueAsNew).
@@ -92,15 +141,16 @@ export declare class AgentsApi extends ApiTopic {
      */
     streamRunDetails(id: string, onEvent?: (event: AgentRunDetailsStreamEvent) => void, signal?: AbortSignal): Promise<void>;
     /**
-     * List child workflows (sub-agents) for an agent run.
+     * List child workflows for an agent or process run.
      */
     listChildren(id: string): Promise<ListWorkflowRunsResponse>;
     /**
      * Get details for a specific child workflow.
-     * Serves from GCS archive when available, falls back to Temporal.
+     * Serves from the child run record when available, falls back to archive or Temporal.
      */
     getChildDetails(id: string, childWorkflowId: string, options?: {
         includeHistory?: boolean;
+        hydratePayloads?: boolean;
     }): Promise<WorkflowRunWithDetails>;
     /**
      * List artifacts for an agent run.
@@ -209,3 +259,4 @@ export declare class AgentsApi extends ApiTopic {
      */
     getFirstResponseBehaviorAnalytics(query?: WorkflowAnalyticsTimeSeriesQuery): Promise<FirstResponseBehaviorAnalyticsResponse>;
 }
+//# sourceMappingURL=AgentsApi.d.ts.map

package/lib/store/AgentsApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentsApi.d.ts","sourceRoot":"","sources":["../../src/store/AgentsApi.ts"],"names":[],"mappings":"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"}

package/lib/{esm/store → store}/AgentsApi.js

@@ -1,37 +1,49 @@
 import { ApiTopic } from '@vertesia/api-fetch-client';
-import { AgentMessageType, parseMessage, toAgentMessage, } from '@vertesia/common';
+import { parseMessage, toAgentMessage, } from '@vertesia/common';
 import { EventSourceProvider } from '../execute.js';
+import { fetchSignedUrl } from './signed-url.js';
+import { shouldCloseAgentRunStream, shouldCloseCompactRunStream } from './stream-termination.js';
 export class AgentsApi extends ApiTopic {
     constructor(parent) {
         super(parent, '/api/v1/agents');
     }
-    // ========================================================================
-    // Lifecycle
-    // ========================================================================
-    /**
-     * Create and start a new agent run.
-     * Returns the created AgentRun with its stable id.
-     */
     start(payload) {
         return this.post('/', { payload });
     }
-    /**
-     * Record an AgentRun for an already-running workflow (e.g. schedule-triggered).
-     * Only creates the MongoDB document — the workflow passes its own Temporal IDs.
-     */
-    createRecord(payload) {
+    recordRun(payload) {
         return this.post('/record', { payload });
     }
+    createRecord(payload) {
+        return this.recordRun(payload);
+    }
     /**
      * Get agent run by id.
      */
     retrieve(id) {
         return this.get(`/${id}`);
     }
+    /**
+     * Get any agent run by id, preserving the agent/process discriminator.
+     */
+    retrieveRun(id) {
+        return this.get(`/${id}`);
+    }
+    retrieveProcess(id) {
+        return this.get(`/${id}`);
+    }
     /**
      * List agent runs with optional filters.
      */
     list(query) {
+        return this.get('/', { query: this.buildListQueryParams(query) });
+    }
+    async listProcessRuns(query) {
+        const response = await this.get('/', {
+            query: this.buildListQueryParams({ ...query, run_kind: 'process' }),
+        });
+        return response.items.filter(isProcessRunResponse);
+    }
+    buildListQueryParams(query) {
         const params = {};
         if (query?.id)
             params.id = query.id;
@@ -50,6 +62,10 @@ export class AgentsApi extends ApiTopic {
             params.schedule_id = query.schedule_id;
         if (query?.type)
             params.type = query.type;
+        if (query?.run_type)
+            params.run_type = Array.isArray(query.run_type) ? query.run_type.join(',') : query.run_type;
+        if (query?.run_kind)
+            params.run_kind = query.run_kind;
         if (query?.limit)
             params.limit = String(query.limit);
         if (query?.offset)
@@ -60,7 +76,7 @@ export class AgentsApi extends ApiTopic {
             params.sort = query.sort;
         if (query?.order)
             params.order = query.order;
-        return this.get('/', { query: params });
+        return params;
     }
     /**
      * Search agent runs via Elasticsearch (full-text + filters).
@@ -90,6 +106,8 @@ export class AgentsApi extends ApiTopic {
             params.limit = String(query.limit);
         if (query?.offset)
             params.offset = String(query.offset);
+        if (query?.sort?.length)
+            params.sort = query.sort.join(',');
         return this.get('/search', { query: params });
     }
     /**
@@ -114,6 +132,21 @@ export class AgentsApi extends ApiTopic {
     fork(id) {
         return this.post(`/${id}/fork`, {});
     }
+    getContext(id) {
+        return this.get(`/${id}/context`);
+    }
+    getHistory(id) {
+        return this.get(`/${id}/history`);
+    }
+    advance(id, payload) {
+        return this.post(`/${id}/advance`, { payload: payload ?? {} });
+    }
+    retryNode(id, payload) {
+        return this.post(`/${id}/retry-node`, { payload: payload ?? {} });
+    }
+    answerTask(id, taskId, result) {
+        return this.post(`/${id}/answer-task`, { payload: { task_id: taskId, result } });
+    }
     /**
      * Update agent run status/metadata.
      * Called by workflow activities to sync lifecycle state.
@@ -121,12 +154,20 @@ export class AgentsApi extends ApiTopic {
     updateStatus(id, update) {
         return this.post(`/${id}/status`, { payload: update });
     }
+    /**
+     * Attach Temporal workflow run ids to a pre-created run record.
+     *
+     * @internal
+     */
+    bindWorkflowRun(id, payload) {
+        return this.post(`/${id}/workflow`, { payload });
+    }
     // ========================================================================
     // Communication
     // ========================================================================
     /**
      * Send a signal to a running agent.
-     * Signals: "UserInput", "Stop", "FileUploaded"
+     * Signals: "UserInput", "Stop", "FileUploaded", "FileRemoved"
      */
     sendSignal(id, signalName, payload) {
         return this.post(`/${id}/signal/${signalName}`, { payload });
@@ -153,8 +194,8 @@ export class AgentsApi extends ApiTopic {
      */
     async retrieveMessages(id, since) {
         const query = since ? { since } : undefined;
-        const response = await this.get(`/${id}/updates`, { query });
-        return response.messages.map((m) => toAgentMessage(m, id));
+        const response = (await this.get(`/${id}/updates`, { query }));
+        return response.messages.map((m) => toAgentMessage(parseMessage(m), id));
     }
     /**
      * Post a message/update to an agent run.
@@ -171,7 +212,7 @@ export class AgentsApi extends ApiTopic {
      * Fetches historical messages via GET /updates (gzip-compressed),
      * then connects to SSE for real-time updates only.
      */
-    async streamMessages(id, onMessage, since, signal) {
+    async streamMessages(id, onMessage, since, signal, options) {
         let resolveFn = () => { };
         let rejectFn = () => { };
         const promise = new Promise((resolve, reject) => {
@@ -180,6 +221,7 @@ export class AgentsApi extends ApiTopic {
         });
         let reconnectAttempts = 0;
         let lastMessageTimestamp = since || 0;
+        const historyFetchStartedAt = Date.now();
         let isClosed = false;
         let currentSse = null;
         let interval = null;
@@ -189,7 +231,7 @@ export class AgentsApi extends ApiTopic {
         const baseDelay = 1000;
         const maxDelay = 30000;
         const calculateBackoffDelay = (attempts) => {
-            const exponentialDelay = Math.min(baseDelay * Math.pow(2, attempts), maxDelay);
+            const exponentialDelay = Math.min(baseDelay * 2 ** attempts, maxDelay);
             const jitter = Math.random() * 0.1 * exponentialDelay;
             return exponentialDelay + jitter;
         };
@@ -218,6 +260,65 @@ export class AgentsApi extends ApiTopic {
                 resolveFn(payload);
             }
         };
+        // SSE reconnection exhausted. The run is durable and still executing
+        // server-side — only the live view dropped. Failing fatally here aborts
+        // headless consumers (CLI `agents stream`, agent test harnesses) before
+        // they can read the result. Instead degrade gracefully: poll GET /updates
+        // for any messages we missed and exit cleanly once the run is terminal,
+        // even if the terminal message never streamed.
+        const POLL_INTERVAL_MS = 5000;
+        const isTerminalStatus = (status) => typeof status === 'string' && ['completed', 'failed', 'cancelled'].includes(status);
+        const degradeToPolling = (reason) => {
+            if (isClosed)
+                return;
+            cleanup();
+            console.warn(`Agent stream ${id}: SSE unavailable after ${maxReconnectAttempts} attempts; falling back to /updates polling.`, reason instanceof Error ? reason.message : reason);
+            const tick = async () => {
+                if (isClosed)
+                    return;
+                try {
+                    const recent = await this.retrieveMessages(id, lastMessageTimestamp || undefined);
+                    for (const msg of recent) {
+                        if (isClosed)
+                            return;
+                        if ((msg.timestamp || 0) <= lastMessageTimestamp)
+                            continue;
+                        lastMessageTimestamp = msg.timestamp || lastMessageTimestamp;
+                        if (onMessage)
+                            onMessage(msg, exit);
+                        if (isClosed)
+                            return;
+                        if (shouldCloseAgentRunStream(msg, id)) {
+                            exit(null);
+                            return;
+                        }
+                    }
+                }
+                catch {
+                    // transient poll error — retry next tick
+                }
+                if (isClosed)
+                    return;
+                // Exit even when no terminal message ever streams, by reading the run record.
+                try {
+                    const run = (await this.get(`/${id}`));
+                    if (isTerminalStatus(run?.status)) {
+                        exit(null);
+                        return;
+                    }
+                }
+                catch {
+                    // ignore — retry next tick
+                }
+                if (!isClosed) {
+                    reconnectTimer = setTimeout(() => {
+                        reconnectTimer = null;
+                        void tick();
+                    }, POLL_INTERVAL_MS);
+                }
+            };
+            void tick();
+        };
         if (signal) {
             if (signal.aborted) {
                 isClosed = true;
@@ -225,14 +326,19 @@ export class AgentsApi extends ApiTopic {
                 resolveFn(null);
                 return promise;
             }
-            abortHandler = () => { exit(null); };
+            abortHandler = () => {
+                exit(null);
+            };
             signal.addEventListener('abort', abortHandler, { once: true });
         }
         // 1. Fetch historical messages via GET /updates (gzip-compressed)
         try {
             if (!isClosed) {
                 const historical = await this.retrieveMessages(id, since);
-                for (const msg of historical) {
+                options?.onHistoryLoaded?.(historical);
+                let shouldCloseAfterHistory = false;
+                for (let index = 0; index < historical.length; index++) {
+                    const msg = historical[index];
                     if (isClosed)
                         break;
                     lastMessageTimestamp = Math.max(lastMessageTimestamp, msg.timestamp || 0);
@@ -240,21 +346,27 @@ export class AgentsApi extends ApiTopic {
                         onMessage(msg, exit);
                     if (isClosed)
                         break;
-                    const workstreamId = msg.workstream_id || 'main';
-                    const streamIsOver = msg.type === AgentMessageType.TERMINATED ||
-                        (msg.type === AgentMessageType.COMPLETE && workstreamId === 'main');
-                    if (streamIsOver) {
-                        exit(null);
-                        return promise;
-                    }
+                    shouldCloseAfterHistory = index === historical.length - 1 && shouldCloseAgentRunStream(msg, id);
+                }
+                if (shouldCloseAfterHistory) {
+                    exit(null);
+                    return promise;
                 }
             }
         }
         catch (err) {
             if (!isClosed) {
+                options?.onHistoryError?.(err);
                 console.warn('Failed to fetch historical messages, continuing with SSE:', err);
             }
         }
+        if (!isClosed && lastMessageTimestamp <= 0) {
+            // The server only replays the GET-to-SSE handoff gap when `since > 0`.
+            // New runs often have no history yet, so use the GET start time as the
+            // cursor to avoid dropping messages emitted before the SSE subscription
+            // is active.
+            lastMessageTimestamp = Math.max(1, historyFetchStartedAt - 1);
+        }
         // 2. Connect to SSE for real-time updates
         const setupStream = async (isReconnect = false) => {
             if (isClosed)
@@ -264,7 +376,7 @@ export class AgentsApi extends ApiTopic {
                 if (isClosed)
                     return;
                 const client = this.client;
-                const streamUrl = new URL(client.agents.baseUrl + `/${id}/stream`);
+                const streamUrl = new URL(`${client.agents.baseUrl}/${id}/stream`);
                 if (lastMessageTimestamp > 0) {
                     streamUrl.searchParams.set('since', lastMessageTimestamp.toString());
                 }
@@ -311,10 +423,7 @@ export class AgentsApi extends ApiTopic {
                             const agentMessage = toAgentMessage(compactMessage, id);
                             onMessage(agentMessage, exit);
                         }
-                        const workstreamId = compactMessage.w || 'main';
-                        const streamIsOver = compactMessage.t === AgentMessageType.TERMINATED ||
-                            (compactMessage.t === AgentMessageType.COMPLETE && workstreamId === 'main');
-                        if (streamIsOver) {
+                        if (shouldCloseCompactRunStream(compactMessage, id)) {
                             exit(null);
                         }
                     }
@@ -340,13 +449,11 @@ export class AgentsApi extends ApiTopic {
                         reconnectTimer = setTimeout(() => {
                             reconnectTimer = null;
                             if (!isClosed)
-                                setupStream(true);
+                                void setupStream(true);
                         }, delay);
                     }
                     else {
-                        isClosed = true;
-                        cleanup();
-                        rejectFn(new Error(`SSE connection failed after ${maxReconnectAttempts} reconnection attempts`));
+                        degradeToPolling(new Error(`SSE connection failed after ${maxReconnectAttempts} reconnection attempts`));
                     }
                 };
             }
@@ -359,17 +466,15 @@ export class AgentsApi extends ApiTopic {
                     reconnectTimer = setTimeout(() => {
                         reconnectTimer = null;
                         if (!isClosed)
-                            setupStream(true);
+                            void setupStream(true);
                     }, delay);
                 }
                 else {
-                    isClosed = true;
-                    cleanup();
-                    rejectFn(err);
+                    degradeToPolling(err);
                 }
             }
         };
-        setupStream(false);
+        void setupStream(false);
         return promise;
     }
     // ========================================================================
@@ -390,6 +495,8 @@ export class AgentsApi extends ApiTopic {
         const query = {};
         if (options?.includeHistory)
             query.include_history = 'true';
+        if (options?.hydratePayloads)
+            query.hydrate_payloads = 'true';
         return this.get(`/${id}/details`, { query });
     }
     /**
@@ -399,7 +506,7 @@ export class AgentsApi extends ApiTopic {
     async streamRunDetails(id, onEvent, signal) {
         const EventSourceImpl = await EventSourceProvider();
         const client = this.client;
-        const streamUrl = new URL(client.agents.baseUrl + `/${id}/details/stream`);
+        const streamUrl = new URL(`${client.agents.baseUrl}/${id}/details/stream`);
         const bearerToken = client._auth ? await client._auth() : undefined;
         if (!bearerToken) {
             throw new Error('No auth token available');
@@ -422,7 +529,10 @@ export class AgentsApi extends ApiTopic {
                     resolve();
                     return;
                 }
-                abortHandler = () => { cleanup(); resolve(); };
+                abortHandler = () => {
+                    cleanup();
+                    resolve();
+                };
                 signal.addEventListener('abort', abortHandler, { once: true });
             }
             sse.addEventListener('history', (ev) => {
@@ -431,7 +541,9 @@ export class AgentsApi extends ApiTopic {
                     if (onEvent)
                         onEvent({ type: 'history', data });
                 }
-                catch (_err) { /* ignore parse errors */ }
+                catch (_err) {
+                    /* ignore parse errors */
+                }
             });
             sse.addEventListener('control', (ev) => {
                 try {
@@ -443,7 +555,9 @@ export class AgentsApi extends ApiTopic {
                         resolve();
                     }
                 }
-                catch (_err) { /* ignore parse errors */ }
+                catch (_err) {
+                    /* ignore parse errors */
+                }
             });
             sse.addEventListener('error', (ev) => {
                 try {
@@ -451,7 +565,9 @@ export class AgentsApi extends ApiTopic {
                     if (onEvent)
                         onEvent({ type: 'error', data });
                 }
-                catch (_err) { /* ignore parse errors */ }
+                catch (_err) {
+                    /* ignore parse errors */
+                }
             });
             sse.onerror = (_err) => {
                 cleanup();
@@ -460,19 +576,21 @@ export class AgentsApi extends ApiTopic {
         });
     }
     /**
-     * List child workflows (sub-agents) for an agent run.
+     * List child workflows for an agent or process run.
      */
     listChildren(id) {
         return this.get(`/${id}/children`);
     }
     /**
      * Get details for a specific child workflow.
-     * Serves from GCS archive when available, falls back to Temporal.
+     * Serves from the child run record when available, falls back to archive or Temporal.
      */
     getChildDetails(id, childWorkflowId, options) {
         const query = {};
         if (options?.includeHistory)
             query.include_history = 'true';
+        if (options?.hydratePayloads)
+            query.hydrate_payloads = 'true';
         return this.get(`/${id}/children/${childWorkflowId}/details`, { query });
     }
     // ========================================================================
@@ -512,11 +630,11 @@ export class AgentsApi extends ApiTopic {
     async uploadArtifact(id, path, content, contentType) {
         const mimeType = contentType || 'application/octet-stream';
         // 1. Get signed upload URL from the agents API
-        const result = await this.put(`/${id}/artifacts/${path}`, {
+        const result = (await this.put(`/${id}/artifacts/${path}`, {
             headers: { 'Content-Type': mimeType },
-        });
+        }));
         // 2. Upload directly to cloud storage
-        const res = await fetch(result.url, {
+        const res = await fetchSignedUrl(result.url, {
             method: 'PUT',
             body: content,
             headers: { 'Content-Type': mimeType },
@@ -531,7 +649,7 @@ export class AgentsApi extends ApiTopic {
      */
     async downloadArtifact(id, path) {
         const { url } = await this.getArtifactUrl(id, path, 'attachment');
-        const res = await fetch(url);
+        const res = await fetchSignedUrl(url);
         if (!res.ok) {
             throw new Error(`Failed to download artifact: ${res.statusText}`);
         }
@@ -656,4 +774,7 @@ export class AgentsApi extends ApiTopic {
         return this.post('/analytics/first-response-behavior', { payload: query });
     }
 }
+function isProcessRunResponse(run) {
+    return run.run_kind === 'process';
+}
 //# sourceMappingURL=AgentsApi.js.map