graphlit-client 1.0.20260422004 → 1.0.20260424002

package/dist/client.d.ts

@@ -3,6 +3,70 @@ import type { NormalizedCacheObject } from "@apollo/client/core/index.js";
 import * as Types from "./generated/graphql-types.js";
 import { AgentOptions, AgentResult, StreamAgentOptions, ToolHandler, RunAgentOptions, RunAgentResult } from "./types/agent.js";
 import { AgentStreamEvent } from "./types/ui-events.js";
+type ConversationFlowEntityReference = {
+    id: string;
+    name?: string | null;
+};
+export type GetConversationFlowQueryVariables = {
+    id: string;
+    correlationId?: string | null;
+};
+export type GetConversationFlowQuery = {
+    conversation?: {
+        id: string;
+        name: string;
+        creationDate: string;
+        modifiedDate?: string | null;
+        state: string;
+        correlationId?: string | null;
+        type?: string | null;
+        transcriptUri?: string | null;
+        messageCount?: number | null;
+        turnCount?: number | null;
+        agent?: ConversationFlowEntityReference | null;
+        persona?: ConversationFlowEntityReference | null;
+        specification?: ConversationFlowEntityReference | null;
+        parent?: ConversationFlowEntityReference | null;
+        children?: Array<ConversationFlowEntityReference | null> | null;
+        turns?: Array<{
+            index?: number | null;
+            tokens?: number | null;
+            timestamp?: string | null;
+            text?: string | null;
+            relevance?: number | null;
+            summary?: string | null;
+            messages?: Array<{
+                role: string;
+                author?: string | null;
+                message?: string | null;
+                tokens?: number | null;
+                throughput?: number | null;
+                ttft?: string | null;
+                completionTime?: string | null;
+                timestamp?: string | null;
+                modelService?: string | null;
+                model?: string | null;
+                data?: string | null;
+                mimeType?: string | null;
+                toolCallId?: string | null;
+                toolCallResponse?: string | null;
+                thinkingContent?: string | null;
+                thinkingSignature?: string | null;
+                toolCalls?: Array<{
+                    id: string;
+                    name: string;
+                    arguments: string;
+                    startedAt?: string | null;
+                    completedAt?: string | null;
+                    durationMs?: number | null;
+                    status?: string | null;
+                    failedAt?: string | null;
+                    firstStatusAt?: string | null;
+                } | null> | null;
+            } | null> | null;
+        } | null> | null;
+    } | null;
+};
 export type { AgentOptions, AgentResult, ArtifactCollector, ContextStrategy, ContextManagementAction, StreamAgentOptions, ToolCallResult, UsageInfo, AgentError, RunAgentOptions, RunAgentResult, TurnResult, BudgetSnapshot, HarnessStatus, QualityAssessment, } from "./types/agent.js";
 export { TokenBudgetTracker, truncateToolResult, estimateTokens, isAccurateTokenCounting, } from "./helpers/context-management.js";
 export type { AgentStreamEvent, ReasoningFormat, ReasoningMetadata, } from "./types/ui-events.js";
@@ -1080,6 +1144,13 @@ declare class Graphlit {
      * @returns The conversation.
      */
     getConversation(id: string): Promise<Types.GetConversationQuery>;
+    /**
+     * Lookup a conversation with only fields needed by flow visualizations.
+     * @param id - ID of the conversation.
+     * @param correlationId - The tenant correlation identifier, optional.
+     * @returns The lightweight conversation flow payload.
+     */
+    getConversationFlow(id: string, correlationId?: string): Promise<GetConversationFlowQuery>;
     /**
      * Retrieves conversations based on the provided filter criteria.
      * @param filter - The filter criteria to apply when retrieving conversations.
@@ -1872,6 +1943,12 @@ declare class Graphlit {
      * @returns The updated connector.
      */
     updateConnector(connector: Types.ConnectorUpdateInput): Promise<Types.UpdateConnectorMutation>;
+    /**
+     * Creates or updates a connector.
+     * @param connector - The connector to create or update.
+     * @returns The created or updated connector.
+     */
+    upsertConnector(connector: Types.ConnectorInput): Promise<Types.UpsertConnectorMutation>;
     /**
      * Deletes a connector.
      * @param id - The ID of the connector to delete.

package/dist/client.js

@@ -3,6 +3,7 @@ import jwt from "jsonwebtoken";
 import { ApolloClient, InMemoryCache, createHttpLink, ApolloLink, ApolloError, } from "@apollo/client/core/index.js";
 // Apollo retry link for resilient error handling
 import { RetryLink } from "@apollo/client/link/retry/index.js";
+import gql from "graphql-tag";
 import { attachPartialErrors } from "./partial-errors.js";
 import * as Types from "./generated/graphql-types.js";
 import * as Documents from "./generated/graphql-documents.js";
@@ -29,6 +30,81 @@ let CohereClientV2;
 let Mistral;
 let BedrockRuntimeClient;
 let Cerebras;
+// Special-purpose lightweight conversation query for agent-flow visualization.
+// This is hand-written instead of generated so UI clients can avoid fetching
+// heavy citation/content/artifact fields without changing codegen templates.
+const GetConversationFlow = gql `
+  query GetConversationFlow($id: ID!, $correlationId: String) {
+    conversation(id: $id, correlationId: $correlationId) {
+      id
+      name
+      creationDate
+      modifiedDate
+      state
+      correlationId
+      type
+      transcriptUri
+      turns {
+        index
+        messages {
+          role
+          author
+          message
+          toolCalls {
+            id
+            name
+            arguments
+            startedAt
+            completedAt
+            durationMs
+            status
+            failedAt
+            firstStatusAt
+          }
+          tokens
+          throughput
+          ttft
+          completionTime
+          timestamp
+          modelService
+          model
+          data
+          mimeType
+          toolCallId
+          toolCallResponse
+          thinkingContent
+          thinkingSignature
+        }
+        tokens
+        timestamp
+        text
+        relevance
+        summary
+      }
+      messageCount
+      turnCount
+      agent {
+        id
+      }
+      persona {
+        id
+        name
+      }
+      specification {
+        id
+        name
+      }
+      parent {
+        id
+        name
+      }
+      children {
+        id
+        name
+      }
+    }
+  }
+`;
 function nowIsoString() {
     return new Date().toISOString();
 }
@@ -2068,6 +2144,15 @@ class Graphlit {
     async getConversation(id) {
         return this.queryAndCheckError(Documents.GetConversation, { id: id });
     }
+    /**
+     * Lookup a conversation with only fields needed by flow visualizations.
+     * @param id - ID of the conversation.
+     * @param correlationId - The tenant correlation identifier, optional.
+     * @returns The lightweight conversation flow payload.
+     */
+    async getConversationFlow(id, correlationId) {
+        return this.queryAndCheckError(GetConversationFlow, { id: id, correlationId: correlationId });
+    }
     /**
      * Retrieves conversations based on the provided filter criteria.
      * @param filter - The filter criteria to apply when retrieving conversations.
@@ -3293,16 +3378,14 @@ class Graphlit {
     async updateConnector(connector) {
         return this.mutateAndCheckError(Documents.UpdateConnector, { connector: connector });
     }
-    /*
-    public async upsertConnector(
-      connector: Types.ConnectorInput
-    ): Promise<Types.UpsertConnectorMutation> {
-      return this.mutateAndCheckError<
-        Types.UpsertConnectorMutation,
-        { connector: Types.ConnectorInput }
-      >(Documents.UpsertConnector, { connector: connector });
+    /**
+     * Creates or updates a connector.
+     * @param connector - The connector to create or update.
+     * @returns The created or updated connector.
+     */
+    async upsertConnector(connector) {
+        return this.mutateAndCheckError(Documents.UpsertConnector, { connector: connector });
     }
-    */
     /**
      * Deletes a connector.
      * @param id - The ID of the connector to delete.

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

@@ -61,6 +61,7 @@ export declare const DeleteConnector: import("graphql").DocumentNode;
 export declare const GetConnector: import("graphql").DocumentNode;
 export declare const QueryConnectors: import("graphql").DocumentNode;
 export declare const UpdateConnector: import("graphql").DocumentNode;
+export declare const UpsertConnector: import("graphql").DocumentNode;
 export declare const AddContentLabel: import("graphql").DocumentNode;
 export declare const ApproveContent: import("graphql").DocumentNode;
 export declare const ClassifyContents: import("graphql").DocumentNode;

package/dist/generated/graphql-documents.js

@@ -2091,6 +2091,16 @@ export const UpdateConnector = gql `
   }
 }
     `;
+export const UpsertConnector = gql `
+    mutation UpsertConnector($connector: ConnectorInput!) {
+  upsertConnector(connector: $connector) {
+    id
+    name
+    state
+    type
+  }
+}
+    `;
 export const AddContentLabel = gql `
     mutation AddContentLabel($id: ID!, $label: String!) {
   addContentLabel(id: $id, label: $label) {

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

@@ -3477,7 +3477,7 @@ export type Content = {
     links?: Maybe<Array<LinkReference>>;
     /** The geo-location of the content. */
     location?: Maybe<Point>;
-    /** The content text formatted as Markdown. Returns the persisted frontmatter-aware Markdown export when available, and otherwise falls back to on-demand export. Export is bounded by stored token count. */
+    /** The content text formatted as Markdown. Returns the persisted Markdown body when available, and otherwise falls back to on-demand export. Export is bounded by stored token count. */
     markdown?: Maybe<Scalars['String']['output']>;
     /** The persisted Markdown export URI of the content. This references the frontmatter-aware Markdown file written under the content folder. */
     markdownUri?: Maybe<Scalars['URL']['output']>;
@@ -17042,6 +17042,8 @@ export type Mutation = {
     upsertAlert?: Maybe<Alert>;
     /** Upserts a category. */
     upsertCategory?: Maybe<Category>;
+    /** Upserts a connector. */
+    upsertConnector?: Maybe<Connector>;
     /** Upserts an emotion. */
     upsertEmotion?: Maybe<Emotion>;
     /** Upserts a label. */
@@ -18327,6 +18329,9 @@ export type MutationUpsertCategoryArgs = {
     category: CategoryInput;
     correlationId?: InputMaybe<Scalars['String']['input']>;
 };
+export type MutationUpsertConnectorArgs = {
+    connector: ConnectorInput;
+};
 export type MutationUpsertEmotionArgs = {
     correlationId?: InputMaybe<Scalars['String']['input']>;
     emotion: EmotionInput;
@@ -29308,6 +29313,19 @@ export type UpdateConnectorMutation = {
         type?: ConnectorTypes | null;
     } | null;
 };
+export type UpsertConnectorMutationVariables = Exact<{
+    connector: ConnectorInput;
+}>;
+export type UpsertConnectorMutation = {
+    __typename?: 'Mutation';
+    upsertConnector?: {
+        __typename?: 'Connector';
+        id: string;
+        name: string;
+        state: EntityState;
+        type?: ConnectorTypes | null;
+    } | null;
+};
 export type AddContentLabelMutationVariables = Exact<{
     id: Scalars['ID']['input'];
     label: Scalars['String']['input'];

package/package.json

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