graphlit-client 1.0.20251223001 → 1.0.20251227001

package/dist/client.d.ts

@@ -263,6 +263,45 @@ declare class Graphlit {
      * @returns The count of alerts.
      */
     countAlerts(filter?: Types.AlertFilter): Promise<Types.CountAlertsQuery>;
+    /**
+     * Creates a fact.
+     * @param fact - The fact to create.
+     * @returns The created fact.
+     */
+    createFact(fact: Types.FactInput): Promise<Types.CreateFactMutation>;
+    /**
+     * Updates a fact.
+     * @param fact - The fact to update.
+     * @returns The updated fact.
+     */
+    updateFact(fact: Types.FactUpdateInput): Promise<Types.UpdateFactMutation>;
+    /**
+     * Deletes a fact.
+     * @param id - The ID of the fact to delete.
+     * @returns The deleted fact.
+     */
+    deleteFact(id: string): Promise<Types.DeleteFactMutation>;
+    /**
+     * Lookup a fact given its ID.
+     * @param id - ID of the fact.
+     * @param correlationId - The tenant correlation identifier, optional.
+     * @returns The fact.
+     */
+    getFact(id: string, correlationId?: string): Promise<Types.GetFactQuery>;
+    /**
+     * Retrieves facts based on the provided filter criteria.
+     * @param filter - The filter criteria to apply when retrieving facts.
+     * @param correlationId - The tenant correlation identifier, optional.
+     * @returns The facts.
+     */
+    queryFacts(filter?: Types.FactFilter, correlationId?: string): Promise<Types.QueryFactsQuery>;
+    /**
+     * Counts facts based on the provided filter criteria.
+     * @param filter - The filter criteria to apply when counting facts.
+     * @param correlationId - The tenant correlation identifier, optional.
+     * @returns The count of facts.
+     */
+    countFacts(filter?: Types.FactFilter, correlationId?: string): Promise<Types.CountFactsQuery>;
     /**
      * Creates a collection.
      * @param collection - The collection to create.
@@ -771,6 +810,24 @@ declare class Graphlit {
      * @returns The retrieved sources.
      */
     retrieveSources(prompt: string, filter?: Types.ContentFilter, augmentedFilter?: Types.ContentFilter, retrievalStrategy?: Types.RetrievalStrategyInput, rerankingStrategy?: Types.RerankingStrategyInput, correlationId?: string): Promise<Types.RetrieveSourcesMutation>;
+    /**
+     * Retrieves entities based on the provided prompt.
+     * @param prompt - The prompt for entity retrieval.
+     * @param types - The observable types to filter by, optional.
+     * @param searchType - The search type to use, optional.
+     * @param limit - The maximum number of results to return, optional.
+     * @param correlationId - The tenant correlation identifier, optional.
+     * @returns The retrieved entities.
+     */
+    retrieveEntities(prompt: string, types?: Types.ObservableTypes[], searchType?: Types.SearchTypes, limit?: number, correlationId?: string): Promise<Types.RetrieveEntitiesMutation>;
+    /**
+     * Retrieves facts based on the provided prompt.
+     * @param prompt - The prompt for fact retrieval.
+     * @param filter - The filter criteria to apply when retrieving facts, optional.
+     * @param correlationId - The tenant correlation identifier, optional.
+     * @returns The retrieved facts.
+     */
+    retrieveFacts(prompt: string, filter?: Types.FactFilter, correlationId?: string): Promise<Types.RetrieveFactsMutation>;
     /**
      * Formats a conversation for external LLM completion.
      * @param prompt - The prompt to format.

package/dist/client.js

@@ -650,6 +650,93 @@ class Graphlit {
     async countAlerts(filter) {
         return this.queryAndCheckError(Documents.CountAlerts, { filter: filter });
     }
+    /**
+     * Creates a fact.
+     * @param fact - The fact to create.
+     * @returns The created fact.
+     */
+    async createFact(fact) {
+        return this.mutateAndCheckError(Documents.CreateFact, { fact: fact });
+    }
+    /**
+     * Updates a fact.
+     * @param fact - The fact to update.
+     * @returns The updated fact.
+     */
+    async updateFact(fact) {
+        return this.mutateAndCheckError(Documents.UpdateFact, { fact: fact });
+    }
+    /**
+     * Deletes a fact.
+     * @param id - The ID of the fact to delete.
+     * @returns The deleted fact.
+     */
+    async deleteFact(id) {
+        return this.mutateAndCheckError(Documents.DeleteFact, { id: id });
+    }
+    // /**
+    //  * Deletes multiple facts.
+    //  * @param ids - The IDs of the facts to delete.
+    //  * @param isSynchronous - Whether this mutation is synchronous.
+    //  * @returns The deleted facts.
+    //  */
+    // public async deleteFacts(
+    //   ids: string[],
+    //   isSynchronous?: boolean,
+    // ): Promise<Types.DeleteFactsMutation> {
+    //   return this.mutateAndCheckError<
+    //     Types.DeleteFactsMutation,
+    //     Types.DeleteFactsMutationVariables
+    //   >(Documents.DeleteFacts, { ids: ids, isSynchronous: isSynchronous });
+    // }
+    // /**
+    //  * Deletes all facts based on the provided filter criteria.
+    //  * @param filter - The filter criteria to apply when deleting facts.
+    //  * @param isSynchronous - Whether this mutation is synchronous.
+    //  * @param correlationId - The tenant correlation identifier, optional.
+    //  * @returns The result of the deletion.
+    //  */
+    // public async deleteAllFacts(
+    //   filter?: Types.FactFilter,
+    //   isSynchronous?: boolean,
+    //   correlationId?: string,
+    // ): Promise<Types.DeleteAllFactsMutation> {
+    //   return this.mutateAndCheckError<
+    //     Types.DeleteAllFactsMutation,
+    //     Types.DeleteAllFactsMutationVariables
+    //   >(Documents.DeleteAllFacts, {
+    //     filter: filter,
+    //     isSynchronous: isSynchronous,
+    //     correlationId: correlationId,
+    //   });
+    // }
+    /**
+     * Lookup a fact given its ID.
+     * @param id - ID of the fact.
+     * @param correlationId - The tenant correlation identifier, optional.
+     * @returns The fact.
+     */
+    async getFact(id, correlationId) {
+        return this.queryAndCheckError(Documents.GetFact, { id: id, correlationId: correlationId });
+    }
+    /**
+     * Retrieves facts based on the provided filter criteria.
+     * @param filter - The filter criteria to apply when retrieving facts.
+     * @param correlationId - The tenant correlation identifier, optional.
+     * @returns The facts.
+     */
+    async queryFacts(filter, correlationId) {
+        return this.queryAndCheckError(Documents.QueryFacts, { filter: filter, correlationId: correlationId });
+    }
+    /**
+     * Counts facts based on the provided filter criteria.
+     * @param filter - The filter criteria to apply when counting facts.
+     * @param correlationId - The tenant correlation identifier, optional.
+     * @returns The count of facts.
+     */
+    async countFacts(filter, correlationId) {
+        return this.queryAndCheckError(Documents.CountFacts, { filter: filter, correlationId: correlationId });
+    }
     /**
      * Creates a collection.
      * @param collection - The collection to create.
@@ -1497,6 +1584,38 @@ class Graphlit {
             correlationId: correlationId,
         });
     }
+    /**
+     * Retrieves entities based on the provided prompt.
+     * @param prompt - The prompt for entity retrieval.
+     * @param types - The observable types to filter by, optional.
+     * @param searchType - The search type to use, optional.
+     * @param limit - The maximum number of results to return, optional.
+     * @param correlationId - The tenant correlation identifier, optional.
+     * @returns The retrieved entities.
+     */
+    async retrieveEntities(prompt, types, searchType, limit, correlationId) {
+        return this.mutateAndCheckError(Documents.RetrieveEntities, {
+            prompt: prompt,
+            types: types,
+            searchType: searchType,
+            limit: limit,
+            correlationId: correlationId,
+        });
+    }
+    /**
+     * Retrieves facts based on the provided prompt.
+     * @param prompt - The prompt for fact retrieval.
+     * @param filter - The filter criteria to apply when retrieving facts, optional.
+     * @param correlationId - The tenant correlation identifier, optional.
+     * @returns The retrieved facts.
+     */
+    async retrieveFacts(prompt, filter, correlationId) {
+        return this.mutateAndCheckError(Documents.RetrieveFacts, {
+            prompt: prompt,
+            filter: filter,
+            correlationId: correlationId,
+        });
+    }
     /**
      * Formats a conversation for external LLM completion.
      * @param prompt - The prompt to format.

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

@@ -84,6 +84,8 @@ export declare const Prompt: import("graphql").DocumentNode;
 export declare const PromptConversation: import("graphql").DocumentNode;
 export declare const PublishConversation: import("graphql").DocumentNode;
 export declare const QueryConversations: import("graphql").DocumentNode;
+export declare const RetrieveEntities: import("graphql").DocumentNode;
+export declare const RetrieveFacts: import("graphql").DocumentNode;
 export declare const RetrieveSources: import("graphql").DocumentNode;
 export declare const RetrieveView: import("graphql").DocumentNode;
 export declare const ReviseContent: import("graphql").DocumentNode;
@@ -101,6 +103,12 @@ export declare const GetEvent: import("graphql").DocumentNode;
 export declare const QueryEvents: import("graphql").DocumentNode;
 export declare const QueryEventsClusters: import("graphql").DocumentNode;
 export declare const UpdateEvent: import("graphql").DocumentNode;
+export declare const CountFacts: import("graphql").DocumentNode;
+export declare const CreateFact: import("graphql").DocumentNode;
+export declare const DeleteFact: import("graphql").DocumentNode;
+export declare const GetFact: import("graphql").DocumentNode;
+export declare const QueryFacts: import("graphql").DocumentNode;
+export declare const UpdateFact: import("graphql").DocumentNode;
 export declare const CountFeeds: import("graphql").DocumentNode;
 export declare const CreateFeed: import("graphql").DocumentNode;
 export declare const DeleteAllFeeds: import("graphql").DocumentNode;

package/dist/generated/graphql-documents.js

@@ -6344,6 +6344,45 @@ export const QueryConversations = gql `
   }
 }
     `;
+export const RetrieveEntities = gql `
+    mutation RetrieveEntities($prompt: String!, $types: [ObservableTypes!], $searchType: SearchTypes, $limit: Int, $correlationId: String) {
+  retrieveEntities(
+    prompt: $prompt
+    types: $types
+    searchType: $searchType
+    limit: $limit
+    correlationId: $correlationId
+  ) {
+    results {
+      id
+      name
+      type
+      relevance
+      metadata
+    }
+  }
+}
+    `;
+export const RetrieveFacts = gql `
+    mutation RetrieveFacts($prompt: String!, $filter: FactFilter, $correlationId: String) {
+  retrieveFacts(prompt: $prompt, filter: $filter, correlationId: $correlationId) {
+    results {
+      fact {
+        id
+        text
+        status
+        validAt
+        invalidAt
+        state
+      }
+      relevance
+      content {
+        id
+      }
+    }
+  }
+}
+    `;
 export const RetrieveSources = gql `
     mutation RetrieveSources($prompt: String!, $filter: ContentFilter, $augmentedFilter: ContentFilter, $retrievalStrategy: RetrievalStrategyInput, $rerankingStrategy: RerankingStrategyInput, $correlationId: String) {
   retrieveSources(
@@ -7301,6 +7340,71 @@ export const UpdateEvent = gql `
   }
 }
     `;
+export const CountFacts = gql `
+    query CountFacts($filter: FactFilter, $correlationId: String) {
+  countFacts(filter: $filter, correlationId: $correlationId) {
+    count
+  }
+}
+    `;
+export const CreateFact = gql `
+    mutation CreateFact($fact: FactInput!) {
+  createFact(fact: $fact) {
+    id
+    state
+  }
+}
+    `;
+export const DeleteFact = gql `
+    mutation DeleteFact($id: ID!) {
+  deleteFact(id: $id) {
+    id
+    state
+  }
+}
+    `;
+export const GetFact = gql `
+    query GetFact($id: ID!, $correlationId: String) {
+  fact(id: $id, correlationId: $correlationId) {
+    id
+    creationDate
+    owner {
+      id
+    }
+    text
+    status
+    validAt
+    invalidAt
+    relevance
+  }
+}
+    `;
+export const QueryFacts = gql `
+    query QueryFacts($filter: FactFilter, $correlationId: String) {
+  facts(filter: $filter, correlationId: $correlationId) {
+    results {
+      id
+      creationDate
+      owner {
+        id
+      }
+      text
+      status
+      validAt
+      invalidAt
+      relevance
+    }
+  }
+}
+    `;
+export const UpdateFact = gql `
+    mutation UpdateFact($fact: FactUpdateInput!) {
+  updateFact(fact: $fact) {
+    id
+    state
+  }
+}
+    `;
 export const CountFeeds = gql `
     query CountFeeds($filter: FeedFilter, $correlationId: String) {
   countFeeds(filter: $filter, correlationId: $correlationId) {
@@ -7535,6 +7639,8 @@ export const GetFeed = gql `
         uri
         repositoryOwner
         repositoryName
+        clientId
+        clientSecret
         refreshToken
         personalAccessToken
         connector {
@@ -7566,6 +7672,8 @@ export const GetFeed = gql `
         uri
         repositoryOwner
         repositoryName
+        clientId
+        clientSecret
         refreshToken
         personalAccessToken
         connector {
@@ -7581,6 +7689,8 @@ export const GetFeed = gql `
         uri
         repositoryOwner
         repositoryName
+        clientId
+        clientSecret
         refreshToken
         personalAccessToken
         connector {
@@ -7719,6 +7829,7 @@ export const GetFeed = gql `
       }
       teamId
       channelId
+      includeAttachments
     }
     discord {
       readLimit
@@ -7983,6 +8094,8 @@ export const QueryFeeds = gql `
           uri
           repositoryOwner
           repositoryName
+          clientId
+          clientSecret
           refreshToken
           personalAccessToken
           connector {
@@ -8014,6 +8127,8 @@ export const QueryFeeds = gql `
           uri
           repositoryOwner
           repositoryName
+          clientId
+          clientSecret
           refreshToken
           personalAccessToken
           connector {
@@ -8029,6 +8144,8 @@ export const QueryFeeds = gql `
           uri
           repositoryOwner
           repositoryName
+          clientId
+          clientSecret
           refreshToken
           personalAccessToken
           connector {
@@ -8167,6 +8284,7 @@ export const QueryFeeds = gql `
         }
         teamId
         channelId
+        includeAttachments
       }
       discord {
         readLimit
@@ -14130,6 +14248,9 @@ export const GetSpecification = gql `
       generateGraph
       observableLimit
     }
+    factStrategy {
+      factLimit
+    }
     revisionStrategy {
       type
       customRevision
@@ -14508,6 +14629,9 @@ export const QuerySpecifications = gql `
         generateGraph
         observableLimit
       }
+      factStrategy {
+        factLimit
+      }
       revisionStrategy {
         type
         customRevision
@@ -16138,6 +16262,7 @@ export const CreateWorkflow = gql `
             tokenThreshold
             timeBudget
             entityBudget
+            extractionType
           }
         }
       }
@@ -16409,6 +16534,7 @@ export const GetWorkflow = gql `
             tokenThreshold
             timeBudget
             entityBudget
+            extractionType
           }
         }
       }
@@ -16654,6 +16780,7 @@ export const QueryWorkflows = gql `
               tokenThreshold
               timeBudget
               entityBudget
+              extractionType
             }
           }
         }
@@ -16893,6 +17020,7 @@ export const UpdateWorkflow = gql `
             tokenThreshold
             timeBudget
             entityBudget
+            extractionType
           }
         }
       }
@@ -17131,6 +17259,7 @@ export const UpsertWorkflow = gql `
             tokenThreshold
             timeBudget
             entityBudget
+            extractionType
           }
         }
       }

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

@@ -2096,6 +2096,8 @@ export type Content = {
     error?: Maybe<Scalars['String']['output']>;
     /** The content event metadata. */
     event?: Maybe<EventMetadata>;
+    /** The facts extracted from this content. */
+    facts?: Maybe<Array<Maybe<Fact>>>;
     /** The geo-tags of the content, as GeoJSON Features with Point geometry. */
     features?: Maybe<Scalars['String']['output']>;
     /** The feed where this content was sourced from. */
@@ -4322,6 +4324,8 @@ export declare enum EntityTypes {
     Conversation = "CONVERSATION",
     /** Event */
     Event = "EVENT",
+    /** Fact */
+    Fact = "FACT",
     /** Feed */
     Feed = "FEED",
     /** Investment */
@@ -4776,6 +4780,13 @@ export type ExtractCompletion = {
     /** The extracted JSON value from the called tool. */
     value: Scalars['String']['output'];
 };
+/** The type of extraction to perform. */
+export declare enum ExtractionTypes {
+    /** Extract observable entities (Person, Organization, Place, etc.). */
+    Entities = "ENTITIES",
+    /** Extract factual assertions and claims from content. */
+    Facts = "FACTS"
+}
 /** Represents an extraction workflow job. */
 export type ExtractionWorkflowJob = {
     __typename?: 'ExtractionWorkflowJob';
@@ -4818,6 +4829,145 @@ export declare enum FacetValueTypes {
     /** Facet by value */
     Value = "VALUE"
 }
+/** Represents a fact extracted from content. */
+export type Fact = {
+    __typename?: 'Fact';
+    /** The content from which the fact was extracted. */
+    content?: Maybe<Content>;
+    /** The creation date of the fact. */
+    creationDate: Scalars['DateTime']['output'];
+    /** The ID of the fact. */
+    id: Scalars['ID']['output'];
+    /** The date/time when this fact became invalid. */
+    invalidAt?: Maybe<Scalars['DateTime']['output']>;
+    /** The entities mentioned in this fact. */
+    mentions?: Maybe<Array<Maybe<MentionReference>>>;
+    /** The modified date of the fact. */
+    modifiedDate?: Maybe<Scalars['DateTime']['output']>;
+    /** The owner of the fact. */
+    owner: Owner;
+    /** The relevance score of the fact. */
+    relevance?: Maybe<Scalars['Float']['output']>;
+    /** The state of the fact (i.e. created, finished). */
+    state: EntityState;
+    /** The resolution status of the fact. */
+    status?: Maybe<FactStatus>;
+    /** The fact assertion text. */
+    text: Scalars['String']['output'];
+    /** The date/time when this fact became valid. */
+    validAt?: Maybe<Scalars['DateTime']['output']>;
+};
+/** Represents a filter for facts. */
+export type FactFilter = {
+    /** Filter by parent content. */
+    content?: InputMaybe<EntityReferenceFilter>;
+    /** Filter by creation date recent timespan. For example, a timespan of one day will return fact(s) created in the last 24 hours. */
+    createdInLast?: InputMaybe<Scalars['TimeSpan']['input']>;
+    /** Filter fact(s) by their creation date range. */
+    creationDateRange?: InputMaybe<DateRangeFilter>;
+    /** The sort direction for query results. */
+    direction?: InputMaybe<OrderDirectionTypes>;
+    /** Whether to disable inheritance from project to owner, upon fact retrieval. Defaults to False. */
+    disableInheritance?: InputMaybe<Scalars['Boolean']['input']>;
+    /** Filter fact(s) by their unique ID. */
+    id?: InputMaybe<Scalars['ID']['input']>;
+    /** Limit the number of fact(s) to be returned. Defaults to 100. */
+    limit?: InputMaybe<Scalars['Int']['input']>;
+    /** Filter by mentioned entities. Multiple mentions use AND logic (all must match). */
+    mentions?: InputMaybe<Array<InputMaybe<MentionReferenceFilter>>>;
+    /** Filter fact(s) by their modified date range. */
+    modifiedDateRange?: InputMaybe<DateRangeFilter>;
+    /** Filter by modified date recent timespan. For example, a timespan of one day will return fact(s) modified in the last 24 hours. */
+    modifiedInLast?: InputMaybe<Scalars['TimeSpan']['input']>;
+    /** Filter fact(s) by their name. */
+    name?: InputMaybe<Scalars['String']['input']>;
+    /** When using similarity search, the number of similar items to be returned. Defaults to 100. */
+    numberSimilar?: InputMaybe<Scalars['Int']['input']>;
+    /** Skip the specified number of fact(s) from the beginning of the result set. Only supported on keyword search. */
+    offset?: InputMaybe<Scalars['Int']['input']>;
+    /** The sort order for query results. */
+    orderBy?: InputMaybe<OrderByTypes>;
+    /** The query syntax for the search text. Defaults to Simple. */
+    queryType?: InputMaybe<SearchQueryTypes>;
+    /** The relevance score threshold for vector and hybrid search. Results below this threshold will be filtered out. Hybrid search defaults to 0.006. Vector search defaults to 0.54, or 0.78 for OpenAI Ada-002, or 0.61 for Google embedding models. Not applicable to keyword search. */
+    relevanceThreshold?: InputMaybe<Scalars['Float']['input']>;
+    /** Filter fact(s) by searching for similar text. */
+    search?: InputMaybe<Scalars['String']['input']>;
+    /** The type of search to be used. Defaults to Vector. */
+    searchType?: InputMaybe<SearchTypes>;
+    /** Filter fact(s) by their states. */
+    states?: InputMaybe<Array<EntityState>>;
+    /** Filter by fact statuses. */
+    statuses?: InputMaybe<Array<InputMaybe<FactStatus>>>;
+    /** Point-in-time filter: returns facts that were valid at this date (ValidAt <= date AND (InvalidAt is null OR InvalidAt > date)). */
+    validAt?: InputMaybe<Scalars['DateTime']['input']>;
+};
+/** Represents the configuration for retrieving the fact knowledge graph. */
+export type FactGraphInput = {
+    /** Filter by entity types. */
+    types?: InputMaybe<Array<ObservableTypes>>;
+};
+/** Represents a fact. */
+export type FactInput = {
+    /** The content from which the fact was extracted. */
+    content: EntityReferenceInput;
+    /** The date/time when this fact became invalid. */
+    invalidAt?: InputMaybe<Scalars['DateTime']['input']>;
+    /** The resolution status of the fact. */
+    status?: InputMaybe<FactStatus>;
+    /** The fact assertion text. */
+    text: Scalars['String']['input'];
+    /** The date/time when this fact became valid. */
+    validAt?: InputMaybe<Scalars['DateTime']['input']>;
+};
+/** Represents fact query results. */
+export type FactResults = {
+    __typename?: 'FactResults';
+    /** The knowledge graph generated from the retrieved facts. */
+    graph?: Maybe<Graph>;
+    /** The fact results. */
+    results?: Maybe<Array<Maybe<Fact>>>;
+};
+/** The resolution status of a fact. */
+export declare enum FactStatus {
+    /** Inactive or archived fact. */
+    Archived = "ARCHIVED",
+    /** Authoritative version of the fact. */
+    Canonical = "CANONICAL",
+    /** Duplicate of a canonical fact. */
+    Duplicate = "DUPLICATE",
+    /** Replaced by a newer fact. */
+    Superseded = "SUPERSEDED"
+}
+/** Represents a fact injection strategy for RAG. */
+export type FactStrategy = {
+    __typename?: 'FactStrategy';
+    /** The maximum number of facts per content, defaults to all. */
+    factLimit?: Maybe<Scalars['Int']['output']>;
+};
+/** Represents a fact injection strategy for RAG. */
+export type FactStrategyInput = {
+    /** The maximum number of facts per content, defaults to all. */
+    factLimit?: InputMaybe<Scalars['Int']['input']>;
+};
+/** Represents a fact injection strategy for RAG. */
+export type FactStrategyUpdateInput = {
+    /** The maximum number of facts per content, defaults to all. */
+    factLimit?: InputMaybe<Scalars['Int']['input']>;
+};
+/** Represents a fact. */
+export type FactUpdateInput = {
+    /** The ID of the fact to update. */
+    id: Scalars['ID']['input'];
+    /** The date/time when this fact became invalid. */
+    invalidAt?: InputMaybe<Scalars['DateTime']['input']>;
+    /** The resolution status of the fact. */
+    status?: InputMaybe<FactStatus>;
+    /** The fact assertion text. */
+    text?: InputMaybe<Scalars['String']['input']>;
+    /** The date/time when this fact became valid. */
+    validAt?: InputMaybe<Scalars['DateTime']['input']>;
+};
 /** Represents a feed. */
 export type Feed = {
     __typename?: 'Feed';
@@ -9820,6 +9970,21 @@ export type MedicalTherapyUpdateInput = {
     /** The medicaltherapy URI. */
     uri?: InputMaybe<Scalars['URL']['input']>;
 };
+/** Represents an entity mention in a fact. */
+export type MentionReference = {
+    __typename?: 'MentionReference';
+    /** The mentioned entity. */
+    observable?: Maybe<NamedEntityReference>;
+    /** The mentioned entity type. */
+    type?: Maybe<ObservableTypes>;
+};
+/** Represents a filter for entity mentions in facts. */
+export type MentionReferenceFilter = {
+    /** Filter by mentioned entity. */
+    observable?: InputMaybe<EntityReferenceFilter>;
+    /** Filter by mentioned entity type. */
+    type?: InputMaybe<ObservableTypes>;
+};
 /** Represents message metadata. */
 export type MessageMetadata = {
     __typename?: 'MessageMetadata';
@@ -10577,6 +10742,8 @@ export type ModelTextExtractionProperties = {
     __typename?: 'ModelTextExtractionProperties';
     /** The total entity budget for entity extraction. Extraction will stop after this many entities are extracted across all types. */
     entityBudget?: Maybe<Scalars['Int']['output']>;
+    /** The extraction type (Entities or Facts). Defaults to Entities. */
+    extractionType?: Maybe<ExtractionTypes>;
     /** The LLM specification used for entity extraction. */
     specification?: Maybe<EntityReference>;
     /** The time budget for entity extraction. Extraction will stop after this duration. Defaults to 30 minutes. */
@@ -10588,6 +10755,8 @@ export type ModelTextExtractionProperties = {
 export type ModelTextExtractionPropertiesInput = {
     /** The total entity budget for entity extraction. Extraction will stop after this many entities are extracted across all types. */
     entityBudget?: InputMaybe<Scalars['Int']['input']>;
+    /** The extraction type (Entities or Facts). Defaults to Entities. */
+    extractionType?: InputMaybe<ExtractionTypes>;
     /** The LLM specification used for entity extraction. */
     specification?: InputMaybe<EntityReferenceInput>;
     /** The time budget for entity extraction. Extraction will stop after this duration. Defaults to 30 minutes. */
@@ -10643,6 +10812,8 @@ export type Mutation = {
     createConversation?: Maybe<Conversation>;
     /** Creates a new event. */
     createEvent?: Maybe<Event>;
+    /** Creates a new fact. */
+    createFact?: Maybe<Fact>;
     /** Creates a new feed. */
     createFeed?: Maybe<Feed>;
     /** Creates a new investment. */
@@ -10781,6 +10952,8 @@ export type Mutation = {
     deleteEvent?: Maybe<Event>;
     /** Bulk deletes events. */
     deleteEvents?: Maybe<Array<Maybe<Event>>>;
+    /** Deletes a fact. */
+    deleteFact?: Maybe<Fact>;
     /** Deletes a feed. */
     deleteFeed?: Maybe<Feed>;
     /** Bulk deletes feeds. */
@@ -10971,6 +11144,10 @@ export type Mutation = {
     restartAllContents?: Maybe<Array<Maybe<Content>>>;
     /** Restarts workflow on content. */
     restartContent?: Maybe<Content>;
+    /** Retrieve entities by semantic search over entity names and descriptions. */
+    retrieveEntities?: Maybe<RetrievedEntityResults>;
+    /** Retrieve facts by semantic search over fact text. */
+    retrieveFacts?: Maybe<RetrievedFactResults>;
     /** Retrieve content sources. */
     retrieveSources?: Maybe<ContentSourceResults>;
     /** Retrieve content sources using a saved view. */
@@ -11011,6 +11188,8 @@ export type Mutation = {
     updateConversation?: Maybe<Conversation>;
     /** Updates an event. */
     updateEvent?: Maybe<Event>;
+    /** Updates a fact. */
+    updateFact?: Maybe<Fact>;
     /** Updates an existing feed. */
     updateFeed?: Maybe<Feed>;
     /** Updates a investment. */
@@ -11140,6 +11319,9 @@ export type MutationCreateConversationArgs = {
 export type MutationCreateEventArgs = {
     event: EventInput;
 };
+export type MutationCreateFactArgs = {
+    fact: FactInput;
+};
 export type MutationCreateFeedArgs = {
     correlationId?: InputMaybe<Scalars['String']['input']>;
     feed: FeedInput;
@@ -11414,6 +11596,9 @@ export type MutationDeleteEventsArgs = {
     ids: Array<Scalars['ID']['input']>;
     isSynchronous?: InputMaybe<Scalars['Boolean']['input']>;
 };
+export type MutationDeleteFactArgs = {
+    id: Scalars['ID']['input'];
+};
 export type MutationDeleteFeedArgs = {
     id: Scalars['ID']['input'];
 };
@@ -11870,6 +12055,18 @@ export type MutationRestartAllContentsArgs = {
 export type MutationRestartContentArgs = {
     id: Scalars['ID']['input'];
 };
+export type MutationRetrieveEntitiesArgs = {
+    correlationId?: InputMaybe<Scalars['String']['input']>;
+    limit?: InputMaybe<Scalars['Int']['input']>;
+    prompt: Scalars['String']['input'];
+    searchType?: InputMaybe<SearchTypes>;
+    types?: InputMaybe<Array<ObservableTypes>>;
+};
+export type MutationRetrieveFactsArgs = {
+    correlationId?: InputMaybe<Scalars['String']['input']>;
+    filter?: InputMaybe<FactFilter>;
+    prompt: Scalars['String']['input'];
+};
 export type MutationRetrieveSourcesArgs = {
     augmentedFilter?: InputMaybe<ContentFilter>;
     correlationId?: InputMaybe<Scalars['String']['input']>;
@@ -11971,6 +12168,9 @@ export type MutationUpdateConversationArgs = {
 export type MutationUpdateEventArgs = {
     event: EventUpdateInput;
 };
+export type MutationUpdateFactArgs = {
+    fact: FactUpdateInput;
+};
 export type MutationUpdateFeedArgs = {
     feed: FeedUpdateInput;
 };
@@ -14753,6 +14953,8 @@ export type Query = {
     countConversations?: Maybe<CountResult>;
     /** Counts events based on the provided filter criteria. */
     countEvents?: Maybe<CountResult>;
+    /** Counts facts based on the provided filter criteria. */
+    countFacts?: Maybe<CountResult>;
     /** Counts feeds based on the provided filter criteria. */
     countFeeds?: Maybe<CountResult>;
     /** Counts investment funds based on the provided filter criteria. */
@@ -14815,6 +15017,10 @@ export type Query = {
     event?: Maybe<Event>;
     /** Retrieves events based on the provided filter criteria. */
     events?: Maybe<EventResults>;
+    /** Lookup a fact given its ID. */
+    fact?: Maybe<Fact>;
+    /** Retrieves facts based on the provided filter criteria. */
+    facts?: Maybe<FactResults>;
     /** Lookup a feed given its ID. */
     feed?: Maybe<Feed>;
     /** Returns whether any feed exists based on the provided filter criteria. */
@@ -15069,6 +15275,10 @@ export type QueryCountEventsArgs = {
     correlationId?: InputMaybe<Scalars['String']['input']>;
     filter?: InputMaybe<EventFilter>;
 };
+export type QueryCountFactsArgs = {
+    correlationId?: InputMaybe<Scalars['String']['input']>;
+    filter?: InputMaybe<FactFilter>;
+};
 export type QueryCountFeedsArgs = {
     correlationId?: InputMaybe<Scalars['String']['input']>;
     filter?: InputMaybe<FeedFilter>;
@@ -15193,6 +15403,15 @@ export type QueryEventsArgs = {
     facets?: InputMaybe<Array<EventFacetInput>>;
     filter?: InputMaybe<EventFilter>;
 };
+export type QueryFactArgs = {
+    correlationId?: InputMaybe<Scalars['String']['input']>;
+    id: Scalars['ID']['input'];
+};
+export type QueryFactsArgs = {
+    correlationId?: InputMaybe<Scalars['String']['input']>;
+    filter?: InputMaybe<FactFilter>;
+    graph?: InputMaybe<FactGraphInput>;
+};
 export type QueryFeedArgs = {
     correlationId?: InputMaybe<Scalars['String']['input']>;
     id: Scalars['ID']['input'];
@@ -16163,6 +16382,42 @@ export type RetrievalStrategyUpdateInput = {
     /** The retrieval strategy type. */
     type?: InputMaybe<RetrievalStrategyTypes>;
 };
+/** Represents a retrieved entity with relevance score. */
+export type RetrievedEntity = {
+    __typename?: 'RetrievedEntity';
+    /** The entity identifier. */
+    id: Scalars['ID']['output'];
+    /** The entity metadata as JSON-LD. */
+    metadata?: Maybe<Scalars['String']['output']>;
+    /** The entity name. */
+    name?: Maybe<Scalars['String']['output']>;
+    /** The relevance score of the entity to the retrieval prompt. */
+    relevance?: Maybe<Scalars['Float']['output']>;
+    /** The entity type. */
+    type: ObservableTypes;
+};
+/** Represents retrieved entity results. */
+export type RetrievedEntityResults = {
+    __typename?: 'RetrievedEntityResults';
+    /** The retrieved entity results. */
+    results?: Maybe<Array<Maybe<RetrievedEntity>>>;
+};
+/** Represents a retrieved fact with relevance score. */
+export type RetrievedFact = {
+    __typename?: 'RetrievedFact';
+    /** The content from which the fact was extracted. */
+    content?: Maybe<EntityReference>;
+    /** The retrieved fact. */
+    fact: Fact;
+    /** The relevance score of the fact to the retrieval prompt. */
+    relevance?: Maybe<Scalars['Float']['output']>;
+};
+/** Represents retrieved fact results. */
+export type RetrievedFactResults = {
+    __typename?: 'RetrievedFactResults';
+    /** The retrieved fact results. */
+    results?: Maybe<Array<Maybe<RetrievedFact>>>;
+};
 /** Represents a prompted content revision. */
 export type ReviseContent = {
     __typename?: 'ReviseContent';
@@ -16824,6 +17079,8 @@ export type Specification = {
     customInstructions?: Maybe<Scalars['String']['output']>;
     /** The Deepseek model properties. */
     deepseek?: Maybe<DeepseekModelProperties>;
+    /** The strategy for including extracted facts in RAG context. */
+    factStrategy?: Maybe<FactStrategy>;
     /** The Google model properties. */
     google?: Maybe<GoogleModelProperties>;
     /** The strategy for GraphRAG retrieval. */
@@ -16930,6 +17187,8 @@ export type SpecificationInput = {
     customInstructions?: InputMaybe<Scalars['String']['input']>;
     /** The Deepseek model properties. */
     deepseek?: InputMaybe<DeepseekModelPropertiesInput>;
+    /** The strategy for including extracted facts in RAG context. */
+    factStrategy?: InputMaybe<FactStrategyInput>;
     /** The Google model properties. */
     google?: InputMaybe<GoogleModelPropertiesInput>;
     /** The strategy for GraphRAG retrieval. */
@@ -16979,6 +17238,8 @@ export type SpecificationResults = {
 };
 /** Specification type */
 export declare enum SpecificationTypes {
+    /** Agentic completion */
+    Agentic = "AGENTIC",
     /** Content classification */
     Classification = "CLASSIFICATION",
     /** Prompt completion */
@@ -17014,6 +17275,8 @@ export type SpecificationUpdateInput = {
     customInstructions?: InputMaybe<Scalars['String']['input']>;
     /** The Deepseek model properties. */
     deepseek?: InputMaybe<DeepseekModelPropertiesUpdateInput>;
+    /** The strategy for including extracted facts in RAG context. */
+    factStrategy?: InputMaybe<FactStrategyUpdateInput>;
     /** The Google model properties. */
     google?: InputMaybe<GoogleModelPropertiesUpdateInput>;
     /** The strategy for GraphRAG retrieval. */
@@ -25468,6 +25731,55 @@ export type QueryConversationsQuery = {
         }> | null;
     } | null;
 };
+export type RetrieveEntitiesMutationVariables = Exact<{
+    prompt: Scalars['String']['input'];
+    types?: InputMaybe<Array<ObservableTypes> | ObservableTypes>;
+    searchType?: InputMaybe<SearchTypes>;
+    limit?: InputMaybe<Scalars['Int']['input']>;
+    correlationId?: InputMaybe<Scalars['String']['input']>;
+}>;
+export type RetrieveEntitiesMutation = {
+    __typename?: 'Mutation';
+    retrieveEntities?: {
+        __typename?: 'RetrievedEntityResults';
+        results?: Array<{
+            __typename?: 'RetrievedEntity';
+            id: string;
+            name?: string | null;
+            type: ObservableTypes;
+            relevance?: number | null;
+            metadata?: string | null;
+        } | null> | null;
+    } | null;
+};
+export type RetrieveFactsMutationVariables = Exact<{
+    prompt: Scalars['String']['input'];
+    filter?: InputMaybe<FactFilter>;
+    correlationId?: InputMaybe<Scalars['String']['input']>;
+}>;
+export type RetrieveFactsMutation = {
+    __typename?: 'Mutation';
+    retrieveFacts?: {
+        __typename?: 'RetrievedFactResults';
+        results?: Array<{
+            __typename?: 'RetrievedFact';
+            relevance?: number | null;
+            fact: {
+                __typename?: 'Fact';
+                id: string;
+                text: string;
+                status?: FactStatus | null;
+                validAt?: any | null;
+                invalidAt?: any | null;
+                state: EntityState;
+            };
+            content?: {
+                __typename?: 'EntityReference';
+                id: string;
+            } | null;
+        } | null> | null;
+    } | null;
+};
 export type RetrieveSourcesMutationVariables = Exact<{
     prompt: Scalars['String']['input'];
     filter?: InputMaybe<ContentFilter>;
@@ -26532,6 +26844,95 @@ export type UpdateEventMutation = {
         name: string;
     } | null;
 };
+export type CountFactsQueryVariables = Exact<{
+    filter?: InputMaybe<FactFilter>;
+    correlationId?: InputMaybe<Scalars['String']['input']>;
+}>;
+export type CountFactsQuery = {
+    __typename?: 'Query';
+    countFacts?: {
+        __typename?: 'CountResult';
+        count?: any | null;
+    } | null;
+};
+export type CreateFactMutationVariables = Exact<{
+    fact: FactInput;
+}>;
+export type CreateFactMutation = {
+    __typename?: 'Mutation';
+    createFact?: {
+        __typename?: 'Fact';
+        id: string;
+        state: EntityState;
+    } | null;
+};
+export type DeleteFactMutationVariables = Exact<{
+    id: Scalars['ID']['input'];
+}>;
+export type DeleteFactMutation = {
+    __typename?: 'Mutation';
+    deleteFact?: {
+        __typename?: 'Fact';
+        id: string;
+        state: EntityState;
+    } | null;
+};
+export type GetFactQueryVariables = Exact<{
+    id: Scalars['ID']['input'];
+    correlationId?: InputMaybe<Scalars['String']['input']>;
+}>;
+export type GetFactQuery = {
+    __typename?: 'Query';
+    fact?: {
+        __typename?: 'Fact';
+        id: string;
+        creationDate: any;
+        text: string;
+        status?: FactStatus | null;
+        validAt?: any | null;
+        invalidAt?: any | null;
+        relevance?: number | null;
+        owner: {
+            __typename?: 'Owner';
+            id: string;
+        };
+    } | null;
+};
+export type QueryFactsQueryVariables = Exact<{
+    filter?: InputMaybe<FactFilter>;
+    correlationId?: InputMaybe<Scalars['String']['input']>;
+}>;
+export type QueryFactsQuery = {
+    __typename?: 'Query';
+    facts?: {
+        __typename?: 'FactResults';
+        results?: Array<{
+            __typename?: 'Fact';
+            id: string;
+            creationDate: any;
+            text: string;
+            status?: FactStatus | null;
+            validAt?: any | null;
+            invalidAt?: any | null;
+            relevance?: number | null;
+            owner: {
+                __typename?: 'Owner';
+                id: string;
+            };
+        } | null> | null;
+    } | null;
+};
+export type UpdateFactMutationVariables = Exact<{
+    fact: FactUpdateInput;
+}>;
+export type UpdateFactMutation = {
+    __typename?: 'Mutation';
+    updateFact?: {
+        __typename?: 'Fact';
+        id: string;
+        state: EntityState;
+    } | null;
+};
 export type CountFeedsQueryVariables = Exact<{
     filter?: InputMaybe<FeedFilter>;
     correlationId?: InputMaybe<Scalars['String']['input']>;
@@ -26827,6 +27228,8 @@ export type GetFeedQuery = {
                 uri?: any | null;
                 repositoryOwner: string;
                 repositoryName: string;
+                clientId?: string | null;
+                clientSecret?: string | null;
                 refreshToken?: string | null;
                 personalAccessToken?: string | null;
                 connector?: {
@@ -26865,6 +27268,8 @@ export type GetFeedQuery = {
                 uri?: any | null;
                 repositoryOwner: string;
                 repositoryName: string;
+                clientId?: string | null;
+                clientSecret?: string | null;
                 refreshToken?: string | null;
                 personalAccessToken?: string | null;
                 connector?: {
@@ -26883,6 +27288,8 @@ export type GetFeedQuery = {
                 uri?: any | null;
                 repositoryOwner: string;
                 repositoryName: string;
+                clientId?: string | null;
+                clientSecret?: string | null;
                 refreshToken?: string | null;
                 personalAccessToken?: string | null;
                 connector?: {
@@ -27040,6 +27447,7 @@ export type GetFeedQuery = {
             refreshToken?: string | null;
             teamId: string;
             channelId: string;
+            includeAttachments?: boolean | null;
             connector?: {
                 __typename?: 'EntityReference';
                 id: string;
@@ -27371,6 +27779,8 @@ export type QueryFeedsQuery = {
                     uri?: any | null;
                     repositoryOwner: string;
                     repositoryName: string;
+                    clientId?: string | null;
+                    clientSecret?: string | null;
                     refreshToken?: string | null;
                     personalAccessToken?: string | null;
                     connector?: {
@@ -27409,6 +27819,8 @@ export type QueryFeedsQuery = {
                     uri?: any | null;
                     repositoryOwner: string;
                     repositoryName: string;
+                    clientId?: string | null;
+                    clientSecret?: string | null;
                     refreshToken?: string | null;
                     personalAccessToken?: string | null;
                     connector?: {
@@ -27427,6 +27839,8 @@ export type QueryFeedsQuery = {
                     uri?: any | null;
                     repositoryOwner: string;
                     repositoryName: string;
+                    clientId?: string | null;
+                    clientSecret?: string | null;
                     refreshToken?: string | null;
                     personalAccessToken?: string | null;
                     connector?: {
@@ -27584,6 +27998,7 @@ export type QueryFeedsQuery = {
                 refreshToken?: string | null;
                 teamId: string;
                 channelId: string;
+                includeAttachments?: boolean | null;
                 connector?: {
                     __typename?: 'EntityReference';
                     id: string;
@@ -34832,6 +35247,10 @@ export type GetSpecificationQuery = {
             generateGraph?: boolean | null;
             observableLimit?: number | null;
         } | null;
+        factStrategy?: {
+            __typename?: 'FactStrategy';
+            factLimit?: number | null;
+        } | null;
         revisionStrategy?: {
             __typename?: 'RevisionStrategy';
             type: RevisionStrategyTypes;
@@ -35256,6 +35675,10 @@ export type QuerySpecificationsQuery = {
                 generateGraph?: boolean | null;
                 observableLimit?: number | null;
             } | null;
+            factStrategy?: {
+                __typename?: 'FactStrategy';
+                factLimit?: number | null;
+            } | null;
             revisionStrategy?: {
                 __typename?: 'RevisionStrategy';
                 type: RevisionStrategyTypes;
@@ -37309,6 +37732,7 @@ export type CreateWorkflowMutation = {
                         tokenThreshold?: number | null;
                         timeBudget?: any | null;
                         entityBudget?: number | null;
+                        extractionType?: ExtractionTypes | null;
                         specification?: {
                             __typename?: 'EntityReference';
                             id: string;
@@ -37650,6 +38074,7 @@ export type GetWorkflowQuery = {
                         tokenThreshold?: number | null;
                         timeBudget?: any | null;
                         entityBudget?: number | null;
+                        extractionType?: ExtractionTypes | null;
                         specification?: {
                             __typename?: 'EntityReference';
                             id: string;
@@ -37958,6 +38383,7 @@ export type QueryWorkflowsQuery = {
                             tokenThreshold?: number | null;
                             timeBudget?: any | null;
                             entityBudget?: number | null;
+                            extractionType?: ExtractionTypes | null;
                             specification?: {
                                 __typename?: 'EntityReference';
                                 id: string;
@@ -38257,6 +38683,7 @@ export type UpdateWorkflowMutation = {
                         tokenThreshold?: number | null;
                         timeBudget?: any | null;
                         entityBudget?: number | null;
+                        extractionType?: ExtractionTypes | null;
                         specification?: {
                             __typename?: 'EntityReference';
                             id: string;
@@ -38555,6 +38982,7 @@ export type UpsertWorkflowMutation = {
                         tokenThreshold?: number | null;
                         timeBudget?: any | null;
                         entityBudget?: number | null;
+                        extractionType?: ExtractionTypes | null;
                         specification?: {
                             __typename?: 'EntityReference';
                             id: string;

package/dist/generated/graphql-types.js

@@ -796,6 +796,8 @@ export var EntityTypes;
     EntityTypes["Conversation"] = "CONVERSATION";
     /** Event */
     EntityTypes["Event"] = "EVENT";
+    /** Fact */
+    EntityTypes["Fact"] = "FACT";
     /** Feed */
     EntityTypes["Feed"] = "FEED";
     /** Investment */
@@ -873,6 +875,14 @@ export var EventFacetTypes;
     /** Creation Date */
     EventFacetTypes["CreationDate"] = "CREATION_DATE";
 })(EventFacetTypes || (EventFacetTypes = {}));
+/** The type of extraction to perform. */
+export var ExtractionTypes;
+(function (ExtractionTypes) {
+    /** Extract observable entities (Person, Organization, Place, etc.). */
+    ExtractionTypes["Entities"] = "ENTITIES";
+    /** Extract factual assertions and claims from content. */
+    ExtractionTypes["Facts"] = "FACTS";
+})(ExtractionTypes || (ExtractionTypes = {}));
 /** Facet value types */
 export var FacetValueTypes;
 (function (FacetValueTypes) {
@@ -883,6 +893,18 @@ export var FacetValueTypes;
     /** Facet by value */
     FacetValueTypes["Value"] = "VALUE";
 })(FacetValueTypes || (FacetValueTypes = {}));
+/** The resolution status of a fact. */
+export var FactStatus;
+(function (FactStatus) {
+    /** Inactive or archived fact. */
+    FactStatus["Archived"] = "ARCHIVED";
+    /** Authoritative version of the fact. */
+    FactStatus["Canonical"] = "CANONICAL";
+    /** Duplicate of a canonical fact. */
+    FactStatus["Duplicate"] = "DUPLICATE";
+    /** Replaced by a newer fact. */
+    FactStatus["Superseded"] = "SUPERSEDED";
+})(FactStatus || (FactStatus = {}));
 /** Feed connector type */
 export var FeedConnectorTypes;
 (function (FeedConnectorTypes) {
@@ -2317,6 +2339,8 @@ export var SoftwareFacetTypes;
 /** Specification type */
 export var SpecificationTypes;
 (function (SpecificationTypes) {
+    /** Agentic completion */
+    SpecificationTypes["Agentic"] = "AGENTIC";
     /** Content classification */
     SpecificationTypes["Classification"] = "CLASSIFICATION";
     /** Prompt completion */

package/package.json

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