graphlit-client 1.0.20260217003 → 1.0.20260217005

package/dist/client.d.ts

@@ -3,7 +3,7 @@ import type { NormalizedCacheObject } from "@apollo/client/core/index.js";
 import * as Types from "./generated/graphql-types.js";
 import { AgentOptions, AgentResult, StreamAgentOptions, ToolHandler } from "./types/agent.js";
 import { AgentStreamEvent } from "./types/ui-events.js";
-export type { AgentOptions, AgentResult, StreamAgentOptions, ToolCallResult, UsageInfo, AgentError, } from "./types/agent.js";
+export type { AgentOptions, AgentResult, ArtifactCollector, StreamAgentOptions, ToolCallResult, UsageInfo, AgentError, } from "./types/agent.js";
 export type { AgentStreamEvent } from "./types/ui-events.js";
 export interface RetryConfig {
     /** Maximum number of retry attempts (default: 5) */
@@ -51,6 +51,7 @@ declare class Graphlit {
     private bedrockClient?;
     private deepseekClient?;
     private xaiClient?;
+    private readonly conversationQueues;
     constructor(organizationIdOrOptions?: string | GraphlitClientOptions, environmentId?: string, jwtSecret?: string, ownerId?: string, userId?: string, apiUri?: string);
     /**
      * Initialize the Apollo client without regenerating the token.
@@ -928,10 +929,11 @@ declare class Graphlit {
      * @param completionTime - The time taken for completion, optional.
      * @param ttft - Time to first token, optional.
      * @param throughput - Tokens per second throughput, optional.
+     * @param artifacts - The artifacts produced during the completion, optional.
      * @param correlationId - The tenant correlation identifier, optional.
      * @returns The completed conversation.
      */
-    completeConversation(completion: string, id: string, completionTime?: Types.Scalars["TimeSpan"]["input"], ttft?: Types.Scalars["TimeSpan"]["input"], throughput?: Types.Scalars["Float"]["input"], correlationId?: string): Promise<Types.CompleteConversationMutation>;
+    completeConversation(completion: string, id: string, completionTime?: Types.Scalars["TimeSpan"]["input"], ttft?: Types.Scalars["TimeSpan"]["input"], throughput?: Types.Scalars["Float"]["input"], artifacts?: Types.EntityReferenceInput[], correlationId?: string): Promise<Types.CompleteConversationMutation>;
     /**
      * Asks a question about Graphlit SDK usage.
      * @param prompt - The question about Graphlit.
@@ -2525,6 +2527,12 @@ declare class Graphlit {
      */
     promptAgent(prompt: string, conversationId?: string, specification?: Types.EntityReferenceInput, tools?: Types.ToolDefinitionInput[], toolHandlers?: Record<string, ToolHandler>, options?: AgentOptions, mimeType?: string, data?: string, // base64 encoded
     contentFilter?: Types.ContentCriteriaInput, augmentedFilter?: Types.ContentCriteriaInput, correlationId?: string, persona?: Types.EntityReferenceInput): Promise<AgentResult>;
+    /**
+     * Serializes async work per conversation ID to prevent concurrent formatConversation /
+     * completeConversation calls from racing each other. Each call chains after the previous
+     * one for the same conversation, so messages are always processed in order.
+     */
+    private enqueueForConversation;
     /**
      * Execute an agent with streaming response
      * @param prompt - The user prompt

package/dist/client.js

@@ -155,6 +155,9 @@ class Graphlit {
     bedrockClient;
     deepseekClient;
     xaiClient;
+    // Serializes streamAgent calls per conversation to prevent race conditions
+    // when a user sends a second message before the first response completes.
+    conversationQueues = new Map();
     constructor(organizationIdOrOptions, environmentId, jwtSecret, ownerId, userId, apiUri) {
         // Handle both old constructor signature and new options object
         let options;
@@ -1751,16 +1754,18 @@ class Graphlit {
      * @param completionTime - The time taken for completion, optional.
      * @param ttft - Time to first token, optional.
      * @param throughput - Tokens per second throughput, optional.
+     * @param artifacts - The artifacts produced during the completion, optional.
      * @param correlationId - The tenant correlation identifier, optional.
      * @returns The completed conversation.
      */
-    async completeConversation(completion, id, completionTime, ttft, throughput, correlationId) {
+    async completeConversation(completion, id, completionTime, ttft, throughput, artifacts, correlationId) {
         return this.mutateAndCheckError(Documents.CompleteConversation, {
             completion: completion,
             id: id,
             completionTime: completionTime,
             ttft: ttft,
             throughput: throughput,
+            artifacts: artifacts,
             correlationId: correlationId,
         });
     }
@@ -4686,6 +4691,29 @@ class Graphlit {
             clearTimeout(timeoutId);
         }
     }
+    /**
+     * Serializes async work per conversation ID to prevent concurrent formatConversation /
+     * completeConversation calls from racing each other. Each call chains after the previous
+     * one for the same conversation, so messages are always processed in order.
+     */
+    enqueueForConversation(conversationId, work, abortSignal) {
+        const previous = this.conversationQueues.get(conversationId) ?? Promise.resolve();
+        // Swallow errors from the previous call so a failed message doesn't
+        // permanently block the queue for this conversation.
+        // Check the abort signal before starting work so ESC while queued is instant.
+        const next = previous.catch(() => { }).then(() => {
+            if (abortSignal?.aborted)
+                throw new Error("Operation aborted");
+            return work();
+        });
+        this.conversationQueues.set(conversationId, next);
+        next.finally(() => {
+            if (this.conversationQueues.get(conversationId) === next) {
+                this.conversationQueues.delete(conversationId);
+            }
+        });
+        return next;
+    }
     /**
      * Execute an agent with streaming response
      * @param prompt - The user prompt
@@ -4744,107 +4772,130 @@ class Graphlit {
                     throw new Error("Failed to create conversation");
                 }
             }
-            // Check streaming support - fallback to promptAgent if not supported
-            if (fullSpec && !this.supportsStreaming(fullSpec, tools)) {
-                if (process.env.DEBUG_GRAPHLIT_SDK_STREAMING) {
-                    console.log("\n⚠️ [streamAgent] Streaming not supported, falling back to promptAgent with same conversation");
-                }
-                // Fallback to promptAgent using the same conversation and parameters
-                const promptResult = await this.promptAgent(prompt, actualConversationId, // Preserve conversation
-                specification, tools, toolHandlers, {
-                    maxToolRounds: maxRounds,
-                }, mimeType, data, contentFilter, augmentedFilter, correlationId, persona);
-                // Convert promptAgent result to streaming events
+            // Serialize execution per-conversation: if the user sends a second message
+            // before the first response completes, queue it so formatConversation /
+            // completeConversation calls never interleave on the same conversation.
+            if (this.conversationQueues.has(actualConversationId)) {
                 onEvent({
-                    type: "conversation_started",
+                    type: "conversation_queued",
                     conversationId: actualConversationId,
                     timestamp: new Date(),
                 });
-                // Debug logging for fallback
-                if (process.env.DEBUG_GRAPHLIT_SDK_STREAMING) {
-                    console.log(`📊 [streamAgent fallback] promptAgent result:`, {
-                        hasMessage: !!promptResult.message,
-                        messageLength: promptResult.message?.length,
-                        toolCallsCount: promptResult.toolCalls?.length || 0,
-                        toolResultsCount: promptResult.toolResults?.length || 0,
-                        toolCalls: promptResult.toolCalls,
-                        toolResults: promptResult.toolResults?.map((tr) => ({
-                            name: tr.name,
-                            hasResult: !!tr.result,
-                            hasError: !!tr.error,
-                        })),
+            }
+            await this.enqueueForConversation(actualConversationId, async () => {
+                // Check streaming support - fallback to promptAgent if not supported
+                if (fullSpec && !this.supportsStreaming(fullSpec, tools)) {
+                    if (process.env.DEBUG_GRAPHLIT_SDK_STREAMING) {
+                        console.log("\n⚠️ [streamAgent] Streaming not supported, falling back to promptAgent with same conversation");
+                    }
+                    // Fallback to promptAgent using the same conversation and parameters
+                    const promptResult = await this.promptAgent(prompt, actualConversationId, // Preserve conversation
+                    specification, tools, toolHandlers, {
+                        maxToolRounds: maxRounds,
+                    }, mimeType, data, contentFilter, augmentedFilter, correlationId, persona);
+                    // Convert promptAgent result to streaming events
+                    onEvent({
+                        type: "conversation_started",
+                        conversationId: actualConversationId,
+                        timestamp: new Date(),
                     });
-                }
-                // Emit tool events if there were tool calls
-                if (promptResult.toolCalls && promptResult.toolCalls.length > 0) {
-                    for (const toolCall of promptResult.toolCalls) {
-                        onEvent({
-                            type: "tool_update",
-                            toolCall: toolCall,
-                            status: "completed",
+                    // Debug logging for fallback
+                    if (process.env.DEBUG_GRAPHLIT_SDK_STREAMING) {
+                        console.log(`📊 [streamAgent fallback] promptAgent result:`, {
+                            hasMessage: !!promptResult.message,
+                            messageLength: promptResult.message?.length,
+                            toolCallsCount: promptResult.toolCalls?.length || 0,
+                            toolResultsCount: promptResult.toolResults?.length || 0,
+                            toolCalls: promptResult.toolCalls,
+                            toolResults: promptResult.toolResults?.map((tr) => ({
+                                name: tr.name,
+                                hasResult: !!tr.result,
+                                hasError: !!tr.error,
+                            })),
                         });
                     }
+                    // Emit tool events if there were tool calls
+                    if (promptResult.toolCalls && promptResult.toolCalls.length > 0) {
+                        for (const toolCall of promptResult.toolCalls) {
+                            onEvent({
+                                type: "tool_update",
+                                toolCall: toolCall,
+                                status: "completed",
+                            });
+                        }
+                    }
+                    // Emit the final message as a single update (simulating streaming)
+                    onEvent({
+                        type: "message_update",
+                        message: {
+                            __typename: "ConversationMessage",
+                            message: promptResult.message,
+                            role: Types.ConversationRoleTypes.Assistant,
+                            timestamp: new Date().toISOString(),
+                            toolCalls: promptResult.toolCalls || [],
+                        },
+                        isStreaming: false,
+                    });
+                    // Emit completion event
+                    onEvent({
+                        type: "conversation_completed",
+                        message: {
+                            __typename: "ConversationMessage",
+                            message: promptResult.message,
+                            role: Types.ConversationRoleTypes.Assistant,
+                            timestamp: new Date().toISOString(),
+                            toolCalls: promptResult.toolCalls || [],
+                        },
+                    });
+                    return; // Exit early after successful fallback
                 }
-                // Emit the final message as a single update (simulating streaming)
-                onEvent({
-                    type: "message_update",
-                    message: {
-                        __typename: "ConversationMessage",
-                        message: promptResult.message,
-                        role: Types.ConversationRoleTypes.Assistant,
-                        timestamp: new Date().toISOString(),
-                        toolCalls: promptResult.toolCalls || [],
-                    },
-                    isStreaming: false,
+                // Create UI event adapter with model information
+                const modelName = fullSpec ? getModelName(fullSpec) : undefined;
+                const modelEnum = fullSpec ? getModelEnum(fullSpec) : undefined;
+                const serviceType = fullSpec ? getServiceType(fullSpec) : undefined;
+                uiAdapter = new UIEventAdapter(onEvent, actualConversationId, {
+                    smoothingEnabled: options?.smoothingEnabled ?? true,
+                    chunkingStrategy: options?.chunkingStrategy ?? "word",
+                    smoothingDelay: options?.smoothingDelay ?? 30,
+                    model: modelEnum,
+                    modelName: modelName,
+                    modelService: serviceType,
                 });
-                // Emit completion event
-                onEvent({
-                    type: "conversation_completed",
-                    message: {
-                        __typename: "ConversationMessage",
-                        message: promptResult.message,
-                        role: Types.ConversationRoleTypes.Assistant,
-                        timestamp: new Date().toISOString(),
-                        toolCalls: promptResult.toolCalls || [],
-                    },
-                });
-                return; // Exit early after successful fallback
-            }
-            // Create UI event adapter with model information
-            const modelName = fullSpec ? getModelName(fullSpec) : undefined;
-            const modelEnum = fullSpec ? getModelEnum(fullSpec) : undefined;
-            const serviceType = fullSpec ? getServiceType(fullSpec) : undefined;
-            uiAdapter = new UIEventAdapter(onEvent, actualConversationId, {
-                smoothingEnabled: options?.smoothingEnabled ?? true,
-                chunkingStrategy: options?.chunkingStrategy ?? "word",
-                smoothingDelay: options?.smoothingDelay ?? 30,
-                model: modelEnum,
-                modelName: modelName,
-                modelService: serviceType,
-            });
-            // Start the streaming conversation
-            await this.executeStreamingAgent(prompt, actualConversationId, fullSpec, tools, toolHandlers, uiAdapter, maxRounds, abortSignal, mimeType, data, correlationId, persona);
+                // Start the streaming conversation
+                await this.executeStreamingAgent(prompt, actualConversationId, fullSpec, tools, toolHandlers, uiAdapter, maxRounds, abortSignal, mimeType, data, correlationId, persona);
+            }, abortSignal);
         }
         catch (error) {
-            const errorMessage = error instanceof Error ? error.message : "Streaming failed";
-            if (uiAdapter) {
-                uiAdapter.handleEvent({
-                    type: "error",
-                    error: errorMessage,
-                });
-            }
-            else {
-                // Fallback error event
+            const isAbortError = (error instanceof Error && error.message === "Operation aborted") ||
+                (error instanceof DOMException && error.name === "AbortError");
+            if (isAbortError) {
                 onEvent({
-                    type: "error",
-                    error: {
-                        message: errorMessage,
-                        recoverable: false,
-                    },
+                    type: "conversation_cancelled",
                     conversationId: conversationId || "",
                     timestamp: new Date(),
                 });
             }
+            else {
+                const errorMessage = error instanceof Error ? error.message : "Streaming failed";
+                if (uiAdapter) {
+                    uiAdapter.handleEvent({
+                        type: "error",
+                        error: errorMessage,
+                    });
+                }
+                else {
+                    // Fallback error event
+                    onEvent({
+                        type: "error",
+                        error: {
+                            message: errorMessage,
+                            recoverable: false,
+                        },
+                        conversationId: conversationId || "",
+                        timestamp: new Date(),
+                    });
+                }
+            }
             throw error;
         }
         finally {
@@ -4860,6 +4911,19 @@ class Graphlit {
     async executeStreamingAgent(prompt, conversationId, specification, tools, toolHandlers, uiAdapter, maxRounds, abortSignal, mimeType, data, correlationId, persona) {
         let currentRound = 0;
         let fullMessage = "";
+        // Collects artifact content IDs from tool handlers (e.g. code_execution).
+        // Handlers register async ingestion promises; we await all of them before
+        // completeConversation so the IDs are available without blocking the LLM.
+        const pendingArtifacts = [];
+        const artifactCollector = {
+            addPending(p) {
+                pendingArtifacts.push(p);
+            },
+            async resolve() {
+                const results = await Promise.all(pendingArtifacts);
+                return results.filter((r) => r != null);
+            },
+        };
         // Start the conversation
         uiAdapter.handleEvent({
             type: "start",
@@ -5320,7 +5384,7 @@ class Graphlit {
                             }
                         }
                         // Execute tool
-                        const result = await handler(args);
+                        const result = await handler(args, artifactCollector);
                         // Update UI with complete event including result
                         uiAdapter.handleEvent({
                             type: "tool_call_complete",
@@ -5387,7 +5451,9 @@ class Graphlit {
                 const seconds = ms / 1000;
                 return `PT${seconds}S`;
             };
-            const completeResponse = await this.completeConversation(trimmedMessage, conversationId, millisecondsToTimeSpan(completionTime), millisecondsToTimeSpan(ttft), throughput, correlationId);
+            // Await any pending artifact ingestions so content IDs are available
+            const collectedArtifacts = await artifactCollector.resolve();
+            const completeResponse = await this.completeConversation(trimmedMessage, conversationId, millisecondsToTimeSpan(completionTime), millisecondsToTimeSpan(ttft), throughput, collectedArtifacts.length > 0 ? collectedArtifacts : undefined, correlationId);
             // Extract token count from the response
             finalTokens =
                 completeResponse.completeConversation?.message?.tokens ?? undefined;

package/dist/generated/graphql-documents.js

@@ -1057,6 +1057,12 @@ export const DescribeEncodedImage = gql `
     mimeType
     toolCallId
     toolCallResponse
+    artifacts {
+      id
+      name
+      mimeType
+      uri
+    }
   }
 }
     `;
@@ -1198,6 +1204,12 @@ export const DescribeImage = gql `
     mimeType
     toolCallId
     toolCallResponse
+    artifacts {
+      id
+      name
+      mimeType
+      uri
+    }
   }
 }
     `;
@@ -4175,6 +4187,12 @@ export const AskGraphlit = gql `
       mimeType
       toolCallId
       toolCallResponse
+      artifacts {
+        id
+        name
+        mimeType
+        uri
+      }
     }
     messageCount
   }
@@ -4211,13 +4229,14 @@ export const CloseConversation = gql `
 }
     `;
 export const CompleteConversation = gql `
-    mutation CompleteConversation($completion: String!, $id: ID!, $completionTime: TimeSpan, $ttft: TimeSpan, $throughput: Float, $correlationId: String) {
+    mutation CompleteConversation($completion: String!, $id: ID!, $completionTime: TimeSpan, $ttft: TimeSpan, $throughput: Float, $artifacts: [EntityReferenceInput!], $correlationId: String) {
   completeConversation(
     completion: $completion
     id: $id
     completionTime: $completionTime
     ttft: $ttft
     throughput: $throughput
+    artifacts: $artifacts
     correlationId: $correlationId
   ) {
     conversation {
@@ -4354,6 +4373,12 @@ export const CompleteConversation = gql `
       mimeType
       toolCallId
       toolCallResponse
+      artifacts {
+        id
+        name
+        mimeType
+        uri
+      }
     }
     messageCount
     facets {
@@ -4539,6 +4564,12 @@ export const CompleteConversation = gql `
         mimeType
         toolCallId
         toolCallResponse
+        artifacts {
+          id
+          name
+          mimeType
+          uri
+        }
       }
     }
   }
@@ -4685,6 +4716,12 @@ export const ContinueConversation = gql `
       mimeType
       toolCallId
       toolCallResponse
+      artifacts {
+        id
+        name
+        mimeType
+        uri
+      }
     }
     messageCount
     facets {
@@ -4870,6 +4907,12 @@ export const ContinueConversation = gql `
         mimeType
         toolCallId
         toolCallResponse
+        artifacts {
+          id
+          name
+          mimeType
+          uri
+        }
       }
     }
   }
@@ -5066,6 +5109,12 @@ export const FormatConversation = gql `
       mimeType
       toolCallId
       toolCallResponse
+      artifacts {
+        id
+        name
+        mimeType
+        uri
+      }
     }
     messageCount
     facets {
@@ -5251,6 +5300,12 @@ export const FormatConversation = gql `
         mimeType
         toolCallId
         toolCallResponse
+        artifacts {
+          id
+          name
+          mimeType
+          uri
+        }
       }
     }
   }
@@ -5400,6 +5455,12 @@ export const GetConversation = gql `
       mimeType
       toolCallId
       toolCallResponse
+      artifacts {
+        id
+        name
+        mimeType
+        uri
+      }
     }
     transcriptUri
     turns {
@@ -5802,6 +5863,12 @@ export const Prompt = gql `
       mimeType
       toolCallId
       toolCallResponse
+      artifacts {
+        id
+        name
+        mimeType
+        uri
+      }
     }
     error
   }
@@ -5956,6 +6023,12 @@ export const PromptConversation = gql `
       mimeType
       toolCallId
       toolCallResponse
+      artifacts {
+        id
+        name
+        mimeType
+        uri
+      }
     }
     messageCount
     facets {
@@ -6141,6 +6214,12 @@ export const PromptConversation = gql `
         mimeType
         toolCallId
         toolCallResponse
+        artifacts {
+          id
+          name
+          mimeType
+          uri
+        }
       }
     }
   }
@@ -6421,6 +6500,12 @@ export const QueryConversations = gql `
         mimeType
         toolCallId
         toolCallResponse
+        artifacts {
+          id
+          name
+          mimeType
+          uri
+        }
       }
       transcriptUri
       turns {
@@ -6790,6 +6875,12 @@ export const QueryConversationsClusters = gql `
         mimeType
         toolCallId
         toolCallResponse
+        artifacts {
+          id
+          name
+          mimeType
+          uri
+        }
       }
       transcriptUri
       turns {
@@ -7312,6 +7403,12 @@ export const ReviseContent = gql `
       mimeType
       toolCallId
       toolCallResponse
+      artifacts {
+        id
+        name
+        mimeType
+        uri
+      }
     }
     messageCount
   }
@@ -7461,6 +7558,12 @@ export const ReviseEncodedImage = gql `
       mimeType
       toolCallId
       toolCallResponse
+      artifacts {
+        id
+        name
+        mimeType
+        uri
+      }
     }
     messageCount
   }
@@ -7609,6 +7712,12 @@ export const ReviseImage = gql `
       mimeType
       toolCallId
       toolCallResponse
+      artifacts {
+        id
+        name
+        mimeType
+        uri
+      }
     }
     messageCount
   }
@@ -7757,6 +7866,12 @@ export const ReviseText = gql `
       mimeType
       toolCallId
       toolCallResponse
+      artifacts {
+        id
+        name
+        mimeType
+        uri
+      }
     }
     messageCount
   }
@@ -16300,6 +16415,12 @@ export const PromptSpecifications = gql `
       mimeType
       toolCallId
       toolCallResponse
+      artifacts {
+        id
+        name
+        mimeType
+        uri
+      }
     }
     error
   }

package/dist/generated/graphql-types.d.ts

@@ -3634,6 +3634,8 @@ export type ConversationInput = {
 /** Represents a conversation message. */
 export type ConversationMessage = {
     __typename?: 'ConversationMessage';
+    /** The content artifacts produced in this message turn, e.g., by code execution tools. */
+    artifacts?: Maybe<Array<Maybe<Content>>>;
     /** The conversation message author. */
     author?: Maybe<Scalars['String']['output']>;
     /** The conversation message citations. */
@@ -3669,6 +3671,8 @@ export type ConversationMessage = {
 };
 /** Represents a conversation message. */
 export type ConversationMessageInput = {
+    /** The content artifact references produced in this message turn, optional. */
+    artifacts?: InputMaybe<Array<InputMaybe<EntityReferenceInput>>>;
     /** The conversation message author. */
     author?: InputMaybe<Scalars['String']['input']>;
     /** The elapsed time for the model to complete the prompt. */
@@ -13342,6 +13346,7 @@ export type MutationCloseConversationArgs = {
     id: Scalars['ID']['input'];
 };
 export type MutationCompleteConversationArgs = {
+    artifacts?: InputMaybe<Array<EntityReferenceInput>>;
     completion: Scalars['String']['input'];
     completionTime?: InputMaybe<Scalars['TimeSpan']['input']>;
     correlationId?: InputMaybe<Scalars['String']['input']>;
@@ -22591,6 +22596,13 @@ export type DescribeEncodedImageMutation = {
             name: string;
             arguments: string;
         } | null> | null;
+        artifacts?: Array<{
+            __typename?: 'Content';
+            id: string;
+            name: string;
+            mimeType?: string | null;
+            uri?: any | null;
+        } | null> | null;
     } | null;
 };
 export type DescribeImageMutationVariables = Exact<{
@@ -22740,6 +22752,13 @@ export type DescribeImageMutation = {
             name: string;
             arguments: string;
         } | null> | null;
+        artifacts?: Array<{
+            __typename?: 'Content';
+            id: string;
+            name: string;
+            mimeType?: string | null;
+            uri?: any | null;
+        } | null> | null;
     } | null;
 };
 export type ExtractContentsMutationVariables = Exact<{
@@ -26107,6 +26126,13 @@ export type AskGraphlitMutation = {
                 name: string;
                 arguments: string;
             } | null> | null;
+            artifacts?: Array<{
+                __typename?: 'Content';
+                id: string;
+                name: string;
+                mimeType?: string | null;
+                uri?: any | null;
+            } | null> | null;
         } | null;
     } | null;
 };
@@ -26155,6 +26181,7 @@ export type CompleteConversationMutationVariables = Exact<{
     completionTime?: InputMaybe<Scalars['TimeSpan']['input']>;
     ttft?: InputMaybe<Scalars['TimeSpan']['input']>;
     throughput?: InputMaybe<Scalars['Float']['input']>;
+    artifacts?: InputMaybe<Array<EntityReferenceInput> | EntityReferenceInput>;
     correlationId?: InputMaybe<Scalars['String']['input']>;
 }>;
 export type CompleteConversationMutation = {
@@ -26305,6 +26332,13 @@ export type CompleteConversationMutation = {
                 name: string;
                 arguments: string;
             } | null> | null;
+            artifacts?: Array<{
+                __typename?: 'Content';
+                id: string;
+                name: string;
+                mimeType?: string | null;
+                uri?: any | null;
+            } | null> | null;
         } | null;
         facets?: Array<{
             __typename?: 'ContentFacet';
@@ -26505,6 +26539,13 @@ export type CompleteConversationMutation = {
                     name: string;
                     arguments: string;
                 } | null> | null;
+                artifacts?: Array<{
+                    __typename?: 'Content';
+                    id: string;
+                    name: string;
+                    mimeType?: string | null;
+                    uri?: any | null;
+                } | null> | null;
             } | null> | null;
         } | null;
     } | null;
@@ -26662,6 +26703,13 @@ export type ContinueConversationMutation = {
                 name: string;
                 arguments: string;
             } | null> | null;
+            artifacts?: Array<{
+                __typename?: 'Content';
+                id: string;
+                name: string;
+                mimeType?: string | null;
+                uri?: any | null;
+            } | null> | null;
         } | null;
         facets?: Array<{
             __typename?: 'ContentFacet';
@@ -26862,6 +26910,13 @@ export type ContinueConversationMutation = {
                     name: string;
                     arguments: string;
                 } | null> | null;
+                artifacts?: Array<{
+                    __typename?: 'Content';
+                    id: string;
+                    name: string;
+                    mimeType?: string | null;
+                    uri?: any | null;
+                } | null> | null;
             } | null> | null;
         } | null;
     } | null;
@@ -27085,6 +27140,13 @@ export type FormatConversationMutation = {
                 name: string;
                 arguments: string;
             } | null> | null;
+            artifacts?: Array<{
+                __typename?: 'Content';
+                id: string;
+                name: string;
+                mimeType?: string | null;
+                uri?: any | null;
+            } | null> | null;
         } | null;
         facets?: Array<{
             __typename?: 'ContentFacet';
@@ -27285,6 +27347,13 @@ export type FormatConversationMutation = {
                     name: string;
                     arguments: string;
                 } | null> | null;
+                artifacts?: Array<{
+                    __typename?: 'Content';
+                    id: string;
+                    name: string;
+                    mimeType?: string | null;
+                    uri?: any | null;
+                } | null> | null;
             } | null> | null;
         } | null;
     } | null;
@@ -27449,6 +27518,13 @@ export type GetConversationQuery = {
                 name: string;
                 arguments: string;
             } | null> | null;
+            artifacts?: Array<{
+                __typename?: 'Content';
+                id: string;
+                name: string;
+                mimeType?: string | null;
+                uri?: any | null;
+            } | null> | null;
         } | null> | null;
         turns?: Array<{
             __typename?: 'ConversationTurn';
@@ -27923,6 +27999,13 @@ export type PromptMutation = {
                 name: string;
                 arguments: string;
             } | null> | null;
+            artifacts?: Array<{
+                __typename?: 'Content';
+                id: string;
+                name: string;
+                mimeType?: string | null;
+                uri?: any | null;
+            } | null> | null;
         } | null> | null;
     } | null;
 };
@@ -28087,6 +28170,13 @@ export type PromptConversationMutation = {
                 name: string;
                 arguments: string;
             } | null> | null;
+            artifacts?: Array<{
+                __typename?: 'Content';
+                id: string;
+                name: string;
+                mimeType?: string | null;
+                uri?: any | null;
+            } | null> | null;
         } | null;
         facets?: Array<{
             __typename?: 'ContentFacet';
@@ -28287,6 +28377,13 @@ export type PromptConversationMutation = {
                     name: string;
                     arguments: string;
                 } | null> | null;
+                artifacts?: Array<{
+                    __typename?: 'Content';
+                    id: string;
+                    name: string;
+                    mimeType?: string | null;
+                    uri?: any | null;
+                } | null> | null;
             } | null> | null;
         } | null;
     } | null;
@@ -28591,6 +28688,13 @@ export type QueryConversationsQuery = {
                     name: string;
                     arguments: string;
                 } | null> | null;
+                artifacts?: Array<{
+                    __typename?: 'Content';
+                    id: string;
+                    name: string;
+                    mimeType?: string | null;
+                    uri?: any | null;
+                } | null> | null;
             } | null> | null;
             turns?: Array<{
                 __typename?: 'ConversationTurn';
@@ -29028,6 +29132,13 @@ export type QueryConversationsClustersQuery = {
                     name: string;
                     arguments: string;
                 } | null> | null;
+                artifacts?: Array<{
+                    __typename?: 'Content';
+                    id: string;
+                    name: string;
+                    mimeType?: string | null;
+                    uri?: any | null;
+                } | null> | null;
             } | null> | null;
             turns?: Array<{
                 __typename?: 'ConversationTurn';
@@ -29652,6 +29763,13 @@ export type ReviseContentMutation = {
                 name: string;
                 arguments: string;
             } | null> | null;
+            artifacts?: Array<{
+                __typename?: 'Content';
+                id: string;
+                name: string;
+                mimeType?: string | null;
+                uri?: any | null;
+            } | null> | null;
         } | null;
     } | null;
 };
@@ -29811,6 +29929,13 @@ export type ReviseEncodedImageMutation = {
                 name: string;
                 arguments: string;
             } | null> | null;
+            artifacts?: Array<{
+                __typename?: 'Content';
+                id: string;
+                name: string;
+                mimeType?: string | null;
+                uri?: any | null;
+            } | null> | null;
         } | null;
     } | null;
 };
@@ -29969,6 +30094,13 @@ export type ReviseImageMutation = {
                 name: string;
                 arguments: string;
             } | null> | null;
+            artifacts?: Array<{
+                __typename?: 'Content';
+                id: string;
+                name: string;
+                mimeType?: string | null;
+                uri?: any | null;
+            } | null> | null;
         } | null;
     } | null;
 };
@@ -30127,6 +30259,13 @@ export type ReviseTextMutation = {
                 name: string;
                 arguments: string;
             } | null> | null;
+            artifacts?: Array<{
+                __typename?: 'Content';
+                id: string;
+                name: string;
+                mimeType?: string | null;
+                uri?: any | null;
+            } | null> | null;
         } | null;
     } | null;
 };
@@ -40497,6 +40636,13 @@ export type PromptSpecificationsMutation = {
                 name: string;
                 arguments: string;
             } | null> | null;
+            artifacts?: Array<{
+                __typename?: 'Content';
+                id: string;
+                name: string;
+                mimeType?: string | null;
+                uri?: any | null;
+            } | null> | null;
         } | null> | null;
     } | null> | null;
 };

package/dist/types/agent.d.ts

@@ -1,5 +1,13 @@
 import { ConversationMessage, ConversationToolCall } from "../generated/graphql-types.js";
-export type ToolHandler = (args: any) => Promise<any>;
+export interface ArtifactCollector {
+    addPending(promise: Promise<{
+        id: string;
+    } | undefined>): void;
+    resolve(): Promise<{
+        id: string;
+    }[]>;
+}
+export type ToolHandler = (args: any, artifacts?: ArtifactCollector) => Promise<any>;
 export interface AgentOptions {
     maxToolRounds?: number;
     timeout?: number;

package/dist/types/ui-events.d.ts

@@ -35,6 +35,14 @@ export type AgentStreamEvent = {
     conversationId: string;
     timestamp: Date;
     model?: string;
+} | {
+    type: "conversation_queued";
+    conversationId: string;
+    timestamp: Date;
+} | {
+    type: "conversation_cancelled";
+    conversationId: string;
+    timestamp: Date;
 } | ContextWindowEvent | {
     type: "message_update";
     message: StreamingConversationMessage;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "graphlit-client",
-  "version": "1.0.20260217003",
+  "version": "1.0.20260217005",
   "description": "Graphlit API Client for TypeScript",
   "type": "module",
   "main": "./dist/client.js",