@vertesia/common 0.73.0 → 0.75.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vertesia/common",
-  "version": "0.73.0",
+  "version": "0.75.0",
   "type": "module",
   "types": "./lib/types/index.d.ts",
   "files": [
@@ -27,7 +27,7 @@
   "dependencies": {
     "ajv": "^8.16.0",
     "json-schema": "^0.4.0",
-    "@llumiverse/common": "0.21.0"
+    "@llumiverse/common": "0.22.0"
   },
   "ts_dual_module": {
     "outDir": "lib"

package/src/access-control.ts

@@ -36,8 +36,9 @@ export enum Permission {
     content_read = "content:read",
     content_write = "content:write",
     content_delete = "content:delete",
-
     content_admin = "content:admin", //manage schemas
+    content_superadmin = "content:superadmin", // list all objects and collections
+
 
     workflow_run = "workflow:run",
     workflow_admin = "workflow:admin",

package/src/apikey.ts

@@ -13,7 +13,7 @@ export interface ApiKey {
     role: ProjectRoles;
     maskedValue?: string; //masked value
     account: string; // the account id
-    project: string; // the project id if any
+    project: ProjectRef; // the project id if any
     enabled: boolean;
     created_by: string,
     updated_by: string,

package/src/interaction.ts

@@ -77,6 +77,7 @@ export interface InteractionEndpoint {
     visibility?: InteractionVisibility;
     version: number;
     tags: string[];
+    output_modality?: Modalities;
     result_schema?: JSONSchema;
     params_schema?: JSONSchema;
 }
@@ -348,6 +349,9 @@ export interface AsyncConversationExecutionPayload extends AsyncExecutionPayload
     /** Whether to enable debug mode */
     debug_mode?: boolean;
 
+    /** Maximum depth for nested conversations to prevent infinite recursion (default: 5) */
+    max_nested_conversation_depth?: number;
+
 }
 
 export interface AsyncInteractionExecutionPayload extends AsyncExecutionPayloadBase {
@@ -373,6 +377,7 @@ interface ResumeConversationPayload {
 
 export interface ToolResultContent {
     content: string;
+    is_error: boolean;
     files?: string[];
 }
 

package/src/payload.ts

@@ -11,6 +11,7 @@ import {
 } from "./query.js";
 
 export interface SearchPayload {
+    facets?: FacetSpec[];
     query?: SimpleSearchQuery;
     limit?: number;
     offset?: number;

package/src/project.ts

@@ -13,11 +13,13 @@ export enum ProjectRoles {
     project_admin = "project_admin", // all permissions but manage_account, manage_billing
     developer = "developer", // all permissions but manage_account, manage_billing, manage_roles, delete
     application = "application", // executor + request_pk
+    consumer = "consumer", // required permissions for users of micro apps
     executor = "executor", // can only read and execute interactions
     reader = "reader", // can only read (browse)
     billing = "billing", // can only manage billings
     member = "member", // can only access, but no specific permissions
     app_member = "app_member", // used to mark an user have access to an application. does not provide any permission on its own
+    content_superadmin = "content_superadmin", // can see all content objects and collections
 }
 
 export function isRoleIncludedIn(role: string, includingRole: string) {
@@ -91,6 +93,17 @@ export enum SupportedEmbeddingTypes {
     properties = "properties"
 }
 
+export enum FullTextType {
+    full_text = "full_text"
+}
+
+export type SearchTypes = SupportedEmbeddingTypes | FullTextType;
+
+export const SearchTypes = {
+    ...SupportedEmbeddingTypes,
+    ...FullTextType
+} as const;
+
 export interface ProjectConfigurationEmbeddings {
     environment: string;
     enabled: boolean;

package/src/query.ts

@@ -1,6 +1,8 @@
 import { ExecutionRunStatus } from './interaction.js';
-import { SupportedEmbeddingTypes } from './project.js';
 import { CollectionSearchPayload } from './store/collections.js';
+import { SearchTypes, SupportedEmbeddingTypes } from "./project.js";
+
+export type EmbeddingSearchConfig = Partial<Record<SupportedEmbeddingTypes, boolean>>;
 
 export interface RunListingQueryOptions {
     project?: string;
@@ -22,18 +24,22 @@ export interface RunListingFilters {
     workflow_run_ids?: string[],
 }
 
+export type scoreAggregationTypes = 'rrf' | 'rsf' | 'smart';
+export type dynamicScalingTypes = 'off' | 'on';
+
 export interface VectorSearchQuery {
     objectId?: string;
     values?: number[];
     text?: string;
     image?: string;
-    threshold?: number;
-    type: SupportedEmbeddingTypes
+    config?: EmbeddingSearchConfig;
 }
 
 export interface SimpleSearchQuery {
     name?: string;
     status?: string | string[];
+    limit?: number;
+    offset?: number;
 }
 
 export interface ObjectSearchQuery extends SimpleSearchQuery {
@@ -43,10 +49,10 @@ export interface ObjectSearchQuery extends SimpleSearchQuery {
     updatedTo?: string;
     location?: string;
     parent?: string;
-    similarTo?: string;
-    embeddingType?: SupportedEmbeddingTypes;
     type?: string;
     types?: string[];
+    all_revisions?: boolean;
+    from_root?: string;
 }
 
 export interface ObjectTypeSearchQuery extends SimpleSearchQuery {
@@ -91,8 +97,34 @@ export interface WorkflowExecutionSearchQuery extends SimpleSearchQuery {
     status?: string;
 }
 
+/**
+ * ComplexSearchQuery is used for full-text search and vector embedding search.
+ */
 export interface ComplexSearchQuery extends ObjectSearchQuery {
     vector?: VectorSearchQuery;
+
+    /**
+     * If present, do a full text search.
+     */
+    fullText?: string;
+
+    weights?: Record<SearchTypes, number>;
+
+    /**
+     * dynamicScaling rescales the weights when a particular search type is not present in the results, per object.
+     * e.g. Weights of 5,3,2 will be treated as 0,3,2 if the first search type is not present in the results.
+     * Ignored when scoreAggregation is 'smart'
+     * Default is 'on'
+    */
+    dynamic_scaling?: dynamicScalingTypes;   // Move to top level
+
+    /**
+     * rrf: Reciprocal Rank Fusion
+     * rsf: Reciprocal Score Fusion
+     * smart: Our own algorithm (default and recommended)
+     */
+    score_aggregation?: scoreAggregationTypes;
+
     match?: Record<string, any>;
 }
 

package/src/store/collections.ts

@@ -17,6 +17,7 @@ export interface CreateCollectionPayload {
     parent?: string | null;
     table_layout?: ColumnLayout[] | null;
     allowed_types?: string[];
+    updated_by?: string,
 }
 
 export interface CollectionItem extends BaseObject {
@@ -48,6 +49,7 @@ export interface CollectionItem extends BaseObject {
 export interface Collection extends CollectionItem {
     properties: Record<string, any>;
     query?: Record<string, any>;
+    security?: Record<string, string[]>; // ACL for collection access
 }
 
 export interface StaticCollection extends Collection {

package/src/store/store.ts

@@ -24,6 +24,7 @@ export interface ContentObject<T = any> extends ContentObjectItem<T> {
     parts?: string[]; // the list of objectId of the parts of the object
     parts_etag?: string; // the etag of the text used for the parts list
     transcript?: Transcript;
+    security?: Record<string, string[]>; // Security field for granular permissions
 }
 
 export type ContentNature =

package/src/store/workflow.ts

@@ -65,6 +65,10 @@ export interface WorkflowExecutionBaseParams<T = Record<string, any>> {
     parent?: {
         run_id: string;
         workflow_id: string;
+        /**
+         * the depth of nested parent workflows
+         */
+        run_depth?: number;
     };
 
     /**