graphlit-client 1.0.20260217004 → 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) */
@@ -929,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.

package/dist/client.js

@@ -1754,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,
         });
     }
@@ -4909,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",
@@ -5369,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",
@@ -5436,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/package.json

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