graphlit-client 1.0.20260226003 → 1.0.20260226005

package/dist/client.d.ts

@@ -5,7 +5,7 @@ import { AgentOptions, AgentResult, StreamAgentOptions, ToolHandler } from "./ty
 import { AgentStreamEvent } from "./types/ui-events.js";
 export type { AgentOptions, AgentResult, ArtifactCollector, ContextStrategy, ContextManagementAction, StreamAgentOptions, ToolCallResult, UsageInfo, AgentError, } from "./types/agent.js";
 export { TokenBudgetTracker, truncateToolResult, estimateTokens, isAccurateTokenCounting, } from "./helpers/context-management.js";
-export type { AgentStreamEvent } from "./types/ui-events.js";
+export type { AgentStreamEvent, ReasoningFormat, ReasoningMetadata, } from "./types/ui-events.js";
 export interface RetryConfig {
     /** Maximum number of retry attempts (default: 5) */
     maxAttempts?: number;

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

@@ -7663,6 +7663,37 @@ export type GoogleFeedPropertiesUpdateInput = {
     /** Google Cloud storage container prefix. */
     prefix?: InputMaybe<Scalars['String']['input']>;
 };
+/** Google image aspect ratio type */
+export declare enum GoogleImageAspectRatioTypes {
+    /** Landscape (3:2) */
+    Landscape_3X2 = "LANDSCAPE_3X2",
+    /** Ultra wide landscape (4:1) */
+    Landscape_4X1 = "LANDSCAPE_4X1",
+    /** Landscape (4:3) */
+    Landscape_4X3 = "LANDSCAPE_4X3",
+    /** Landscape (5:4) */
+    Landscape_5X4 = "LANDSCAPE_5X4",
+    /** Ultra wide landscape (8:1) */
+    Landscape_8X1 = "LANDSCAPE_8X1",
+    /** Widescreen (16:9) */
+    Landscape_16X9 = "LANDSCAPE_16X9",
+    /** Ultrawide cinematic (21:9) */
+    Landscape_21X9 = "LANDSCAPE_21X9",
+    /** Tall portrait (1:4) */
+    Portrait_1X4 = "PORTRAIT_1X4",
+    /** Ultra tall portrait (1:8) */
+    Portrait_1X8 = "PORTRAIT_1X8",
+    /** Portrait (2:3) */
+    Portrait_2X3 = "PORTRAIT_2X3",
+    /** Portrait (3:4) */
+    Portrait_3X4 = "PORTRAIT_3X4",
+    /** Portrait (4:5) */
+    Portrait_4X5 = "PORTRAIT_4X5",
+    /** Vertical video (9:16) */
+    Portrait_9X16 = "PORTRAIT_9X16",
+    /** Square (1:1) */
+    Square_1X1 = "SQUARE_1X1"
+}
 /** Google Image model type */
 export declare enum GoogleImageModels {
     /** Developer-specified model */
@@ -7677,6 +7708,8 @@ export declare enum GoogleImageModels {
 /** Represents the Google Image publishing properties. */
 export type GoogleImagePublishingProperties = {
     __typename?: 'GoogleImagePublishingProperties';
+    /** The image aspect ratio, optional. Defaults to 1:1 square. */
+    aspectRatio?: Maybe<GoogleImageAspectRatioTypes>;
     /** The number of images to generate, optional. Defaults to 1. */
     count?: Maybe<Scalars['Int']['output']>;
     /** The Google Image model. */
@@ -7688,6 +7721,8 @@ export type GoogleImagePublishingProperties = {
 };
 /** Represents the Google Image publishing properties. */
 export type GoogleImagePublishingPropertiesInput = {
+    /** The image aspect ratio, optional. Defaults to 1:1 square. */
+    aspectRatio?: InputMaybe<GoogleImageAspectRatioTypes>;
     /** The number of images to generate, optional. Defaults to 1. */
     count?: InputMaybe<Scalars['Int']['input']>;
     /** The Google Image model. */
@@ -16469,10 +16504,14 @@ export type Persona = {
     __typename?: 'Persona';
     /** The creation date of the persona. */
     creationDate: Scalars['DateTime']['output'];
+    /** The display name of the persona. */
+    displayName?: Maybe<Scalars['String']['output']>;
     /** The persona memories as fact references. */
     facts?: Maybe<Array<FactReference>>;
     /** The ID of the persona. */
     id: Scalars['ID']['output'];
+    /** The external unique identifier of the persona. */
+    identifier?: Maybe<Scalars['String']['output']>;
     /** The behavioral/communication instructions for this persona context. */
     instructions?: Maybe<Scalars['String']['output']>;
     /** The modified date of the persona. */
@@ -16481,12 +16520,16 @@ export type Persona = {
     name: Scalars['String']['output'];
     /** The owner of the persona. */
     owner: Owner;
+    /** The origin platform of the persona. */
+    platform?: Maybe<Scalars['String']['output']>;
     /** The relevance score of the persona. */
     relevance?: Maybe<Scalars['Float']['output']>;
     /** The contextual role of the persona. */
     role?: Maybe<Scalars['String']['output']>;
     /** The state of the persona (i.e. created, finished). */
     state: EntityState;
+    /** The IANA timezone of the persona. */
+    timezone?: Maybe<Scalars['String']['output']>;
 };
 /** Represents a filter for personas. */
 export type PersonaFilter = {
@@ -16498,6 +16541,8 @@ export type PersonaFilter = {
     direction?: InputMaybe<OrderDirectionTypes>;
     /** Filter persona(s) by their unique ID. */
     id?: InputMaybe<Scalars['ID']['input']>;
+    /** Filter persona(s) by their external identifier. */
+    identifier?: InputMaybe<Scalars['String']['input']>;
     /** Limit the number of persona(s) to be returned. Defaults to 100. */
     limit?: InputMaybe<Scalars['Int']['input']>;
     /** Filter persona(s) by their modified date range. */
@@ -16519,12 +16564,20 @@ export type PersonaFilter = {
 };
 /** Represents a persona. */
 export type PersonaInput = {
+    /** The display name of the persona. */
+    displayName?: InputMaybe<Scalars['String']['input']>;
+    /** The external unique identifier of the persona. */
+    identifier?: InputMaybe<Scalars['String']['input']>;
     /** The behavioral/communication instructions for this persona context. */
     instructions?: InputMaybe<Scalars['String']['input']>;
     /** The name of the persona. */
     name: Scalars['String']['input'];
+    /** The origin platform of the persona. */
+    platform?: InputMaybe<Scalars['String']['input']>;
     /** The contextual role of the persona. */
     role?: InputMaybe<Scalars['String']['input']>;
+    /** The IANA timezone of the persona. */
+    timezone?: InputMaybe<Scalars['String']['input']>;
 };
 /** Represents persona query results. */
 export type PersonaResults = {
@@ -16534,14 +16587,22 @@ export type PersonaResults = {
 };
 /** Represents a persona. */
 export type PersonaUpdateInput = {
+    /** The display name of the persona. */
+    displayName?: InputMaybe<Scalars['String']['input']>;
     /** The ID of the persona to update. */
     id: Scalars['ID']['input'];
+    /** The external unique identifier of the persona. */
+    identifier?: InputMaybe<Scalars['String']['input']>;
     /** The behavioral/communication instructions for this persona context. */
     instructions?: InputMaybe<Scalars['String']['input']>;
     /** The name of the persona. */
     name?: InputMaybe<Scalars['String']['input']>;
+    /** The origin platform of the persona. */
+    platform?: InputMaybe<Scalars['String']['input']>;
     /** The contextual role of the persona. */
     role?: InputMaybe<Scalars['String']['input']>;
+    /** The IANA timezone of the persona. */
+    timezone?: InputMaybe<Scalars['String']['input']>;
 };
 /** Represents a place. */
 export type Place = {

package/dist/generated/graphql-types.js

@@ -1491,6 +1491,38 @@ export var GoogleEmailAuthenticationTypes;
     GoogleEmailAuthenticationTypes["Connector"] = "CONNECTOR";
     GoogleEmailAuthenticationTypes["User"] = "USER";
 })(GoogleEmailAuthenticationTypes || (GoogleEmailAuthenticationTypes = {}));
+/** Google image aspect ratio type */
+export var GoogleImageAspectRatioTypes;
+(function (GoogleImageAspectRatioTypes) {
+    /** Landscape (3:2) */
+    GoogleImageAspectRatioTypes["Landscape_3X2"] = "LANDSCAPE_3X2";
+    /** Ultra wide landscape (4:1) */
+    GoogleImageAspectRatioTypes["Landscape_4X1"] = "LANDSCAPE_4X1";
+    /** Landscape (4:3) */
+    GoogleImageAspectRatioTypes["Landscape_4X3"] = "LANDSCAPE_4X3";
+    /** Landscape (5:4) */
+    GoogleImageAspectRatioTypes["Landscape_5X4"] = "LANDSCAPE_5X4";
+    /** Ultra wide landscape (8:1) */
+    GoogleImageAspectRatioTypes["Landscape_8X1"] = "LANDSCAPE_8X1";
+    /** Widescreen (16:9) */
+    GoogleImageAspectRatioTypes["Landscape_16X9"] = "LANDSCAPE_16X9";
+    /** Ultrawide cinematic (21:9) */
+    GoogleImageAspectRatioTypes["Landscape_21X9"] = "LANDSCAPE_21X9";
+    /** Tall portrait (1:4) */
+    GoogleImageAspectRatioTypes["Portrait_1X4"] = "PORTRAIT_1X4";
+    /** Ultra tall portrait (1:8) */
+    GoogleImageAspectRatioTypes["Portrait_1X8"] = "PORTRAIT_1X8";
+    /** Portrait (2:3) */
+    GoogleImageAspectRatioTypes["Portrait_2X3"] = "PORTRAIT_2X3";
+    /** Portrait (3:4) */
+    GoogleImageAspectRatioTypes["Portrait_3X4"] = "PORTRAIT_3X4";
+    /** Portrait (4:5) */
+    GoogleImageAspectRatioTypes["Portrait_4X5"] = "PORTRAIT_4X5";
+    /** Vertical video (9:16) */
+    GoogleImageAspectRatioTypes["Portrait_9X16"] = "PORTRAIT_9X16";
+    /** Square (1:1) */
+    GoogleImageAspectRatioTypes["Square_1X1"] = "SQUARE_1X1";
+})(GoogleImageAspectRatioTypes || (GoogleImageAspectRatioTypes = {}));
 /** Google Image model type */
 export var GoogleImageModels;
 (function (GoogleImageModels) {

package/dist/streaming/ui-event-adapter.d.ts

@@ -66,6 +66,11 @@ export declare class UIEventAdapter {
     private handleReasoningStart;
     private handleReasoningDelta;
     private handleReasoningEnd;
+    /**
+     * Build a ReasoningMetadata object from accumulated reasoning state.
+     * Returns undefined when no reasoning content has been captured.
+     */
+    private buildReasoningMetadata;
     /**
      * Clean up any pending timers
      */

package/dist/streaming/ui-event-adapter.js

@@ -107,6 +107,11 @@ export class UIEventAdapter {
         this.lastTokenTime = 0;
         this.tokenCount = 0;
         this.tokenDelays = [];
+        // Reset reasoning state so stale thinking from a prior round doesn't leak
+        this.reasoningContent = "";
+        this.reasoningFormat = undefined;
+        this.reasoningSignature = undefined;
+        this.isInReasoning = false;
         // Reset tool call tracking flags
         this.hasToolCallsInProgress = false;
         this.hadToolCallsBeforeResume = false;
@@ -436,12 +441,21 @@ export class UIEventAdapter {
             }
             return; // Exit without emitting conversation_completed
         }
+        // Attach reasoning metadata to the final message
+        const reasoning = this.buildReasoningMetadata();
+        if (reasoning) {
+            finalMessage.isThinking = true;
+            finalMessage.thinkingContent = reasoning.content;
+        }
         // Include context window usage if available
         const event = {
             type: "conversation_completed",
             message: finalMessage,
             metrics: finalMetrics,
         };
+        if (reasoning) {
+            event.reasoning = reasoning;
+        }
         if (this.contextWindowUsage) {
             event.contextWindow = this.contextWindowUsage;
         }
@@ -599,12 +613,22 @@ export class UIEventAdapter {
                 metrics.streamingThroughput = Math.round((this.currentMessage.length / streamingTime) * 1000);
             }
         }
-        this.emitUIEvent({
+        // Attach reasoning metadata to the message and event
+        const reasoning = this.buildReasoningMetadata();
+        if (reasoning) {
+            message.isThinking = true;
+            message.thinkingContent = reasoning.content;
+        }
+        const event = {
             type: "message_update",
             message,
             isStreaming,
             metrics,
-        });
+        };
+        if (reasoning) {
+            event.reasoning = reasoning;
+        }
+        this.emitUIEvent(event);
     }
     emitUIEvent(event) {
         this.onEvent(event);
@@ -674,6 +698,23 @@ export class UIEventAdapter {
             });
         }
     }
+    /**
+     * Build a ReasoningMetadata object from accumulated reasoning state.
+     * Returns undefined when no reasoning content has been captured.
+     */
+    buildReasoningMetadata() {
+        if (!this.reasoningContent || !this.reasoningFormat) {
+            return undefined;
+        }
+        const metadata = {
+            content: this.reasoningContent,
+            format: this.reasoningFormat,
+        };
+        if (this.reasoningSignature) {
+            metadata.signature = this.reasoningSignature;
+        }
+        return metadata;
+    }
     /**
      * Clean up any pending timers
      */

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

@@ -21,12 +21,24 @@ export type ContextWindowEvent = {
     };
     timestamp: Date;
 };
+/**
+ * Structured reasoning/thinking metadata.
+ * Provides a canonical representation across all providers so the UI
+ * can decide whether and how to render model reasoning.
+ */
+export type ReasoningMetadata = {
+    content: string;
+    format: ReasoningFormat;
+    signature?: string;
+};
 /**
  * Extended conversation message with additional streaming metadata
  */
 export type StreamingConversationMessage = Partial<ConversationMessage> & {
     message: string;
     modelName?: string;
+    isThinking?: boolean;
+    thinkingContent?: string;
 };
 /**
  * Simplified UI-focused streaming events using GraphQL types
@@ -58,6 +70,7 @@ export type AgentStreamEvent = {
     type: "message_update";
     message: StreamingConversationMessage;
     isStreaming: boolean;
+    reasoning?: ReasoningMetadata;
     metrics?: {
         ttft?: number;
         elapsedTime: number;
@@ -80,6 +93,7 @@ export type AgentStreamEvent = {
 } | {
     type: "conversation_completed";
     message: StreamingConversationMessage;
+    reasoning?: ReasoningMetadata;
     metrics?: {
         ttft?: number;
         totalTime: number;

package/package.json

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