@vertesia/common 1.1.0 → 1.1.1-dev.20260505.160410Z

package/src/prompt.ts

@@ -100,3 +100,18 @@ export interface PromptTemplateUpdatePayload
     extends Partial<
         Omit<PromptTemplate, "id" | "created_at" | "updated_at" | "created_by" | "updated_by" | "project">
     > { }
+
+export interface PromptTemplateInteractionVersion {
+    version: number;
+}
+
+export interface PromptTemplateInteractionUsage {
+    id: string;
+    name: string;
+    versions: PromptTemplateInteractionVersion[];
+}
+
+export interface PromptTemplateInteractionsResponse {
+    prompt: string;
+    interactions: PromptTemplateInteractionUsage[];
+}

package/src/store/agent-run.ts

@@ -272,6 +272,34 @@ export interface AgentRunUpdatesResponse {
     messages: CompactMessage[];
 }
 
+export interface AgentRunUpdatesQuery {
+    since?: number;
+}
+
+export interface StreamAgentRunQuery extends AgentRunUpdatesQuery {
+    skipHistory?: boolean;
+}
+
+export interface AgentRunDetailsQuery {
+    include_history?: boolean;
+}
+
+export type AgentArtifactVisibility = 'user' | 'internal' | 'all';
+
+export interface AgentRunArtifactsQuery {
+    visibility?: AgentArtifactVisibility;
+}
+
+export interface AgentRunArtifactUploadHeaders {
+    'content-type'?: string;
+}
+
+export interface AgentRunArtifactQuery {
+    url?: boolean;
+    disposition?: 'inline' | 'attachment';
+    filename?: string;
+}
+
 /**
  * Payload for posting an update into an agent's workflow stream.
  */
@@ -384,7 +412,7 @@ export interface ListAgentRunsQuery {
 }
 
 export interface ListAgentRunsResponse {
-    items: AgentRun[];
+    items: AgentRun<Record<string, unknown>, Record<string, unknown>>[];
     total_count: number;
     next_cursor: string | null;
 }

package/src/store/collections.ts

@@ -85,3 +85,40 @@ export interface CollectionSearchPayload {
     type?: string;
     types?: string[];
 }
+
+export interface CollectionMembersUpdateResult {
+    id: string;
+}
+
+export interface CollectionSecuritySettingsResponse {
+    id: string;
+    security: Record<string, string[]>;
+}
+
+export interface CollectionPropagationResponse {
+    id: string;
+    message: string;
+    security?: Record<string, string[]>;
+    shared_properties?: string[];
+}
+
+export interface CollectionChildrenUpdateResult {
+    count: number;
+}
+
+export interface CollectionMembersUpdatePayload {
+    action: "add" | "delete";
+    members: string[];
+}
+
+export interface CollectionChildrenUpdatePayload {
+    action: "add" | "delete";
+    children: string[];
+}
+
+export interface CollectionMembersQuery {
+    status?: string;
+    type?: string;
+    limit?: number;
+    offset?: number;
+}

package/src/store/doc-analyzer.ts

@@ -1,3 +1,4 @@
+import type { JSONObject } from "../json.js";
 import { WorkflowExecutionPayload, WorkflowRunStatus } from "./workflow.js";
 
 export interface PdfToRichtextOptions {
@@ -64,7 +65,7 @@ export interface DocTableCsv extends DocTable {
 export interface DocTableJson extends DocTable {
     format: "application/json";
     title?: string;
-    data: Object[];
+    data: JSONObject[];
 }
 
 /**

package/src/store/dsl-workflow.ts

@@ -4,6 +4,8 @@ import { BaseObject } from "./common.js";
 import { WorkflowExecutionPayload } from "./index.js";
 import { ParentClosePolicyType } from "./temporalio.js";
 
+export type DurationValue = StringValue | number;
+
 /**
  * Discriminator for workflow input type - either object IDs or GCS file URIs
  */
@@ -42,9 +44,9 @@ export interface DSLWorkflowExecutionPayload extends WorkflowExecutionPayload {
  * @see ActivityOptions in @temporalio/common
  */
 export interface DSLActivityOptions {
-    startToCloseTimeout?: StringValue | number;
-    scheduleToStartTimeout?: StringValue | number;
-    scheduleToCloseTimeout?: StringValue | number;
+    startToCloseTimeout?: DurationValue;
+    scheduleToStartTimeout?: DurationValue;
+    scheduleToCloseTimeout?: DurationValue;
     retry?: DSLRetryPolicy;
 }
 
@@ -55,12 +57,15 @@ export interface DSLActivityOptions {
  */
 export interface DSLRetryPolicy {
     backoffCoefficient?: number;
-    initialInterval?: StringValue | number;
+    initialInterval?: DurationValue;
     maximumAttempts?: number;
-    maximumInterval?: StringValue | number;
+    maximumInterval?: DurationValue;
     nonRetryableErrorTypes?: string[];
 }
 
+export type WorkflowSearchAttributeValue = string[] | number[] | boolean[] | Date[];
+export type WorkflowSearchAttributes = Record<string, WorkflowSearchAttributeValue>;
+
 /**
  * The payload for a DSL activity execution.
  */
@@ -225,11 +230,11 @@ export interface DSLChildWorkflowStep extends DSLWorkflowStepBase {
     options?: {
         memo?: Record<string, any>;
         retry?: DSLRetryPolicy;
-        searchAttributes?: Record<string, string[] | number[] | boolean[] | Date[]>;
+        searchAttributes?: WorkflowSearchAttributes;
         taskQueue?: string;
-        workflowExecutionTimeout?: StringValue | number;
-        workflowRunTimeout?: StringValue | number;
-        workflowTaskTimeout?: StringValue | number;
+        workflowExecutionTimeout?: DurationValue;
+        workflowRunTimeout?: DurationValue;
+        workflowTaskTimeout?: DurationValue;
         workflowId?: string;
         cronSchedule?: string;
         parentClosePolicy?: ParentClosePolicyType;

package/src/store/rendering.ts

@@ -152,6 +152,11 @@ export interface RenderMarkdownStatusResponse extends WorkflowRunStatus {
     error?: string;
 }
 
+export interface RenderMarkdownStatusQuery {
+    workflow_id: string;
+    workflow_run_id: string;
+}
+
 /**
  * Client-side polling options for markdown rendering.
  */

package/src/store/store.ts

@@ -12,6 +12,37 @@ export enum ContentObjectApiHeaders {
     SUPPRESS_WORKFLOWS = 'x-suppress-workflows',
 }
 
+export interface CreateContentObjectQuery {
+    collection_id?: string;
+    processing_priority?: ContentObjectProcessingPriority;
+}
+
+export interface CreateContentObjectHeaders {
+    'x-collection-id'?: string;
+    'x-processing-priority'?: ContentObjectProcessingPriority;
+}
+
+export interface UpdateContentObjectQuery {
+    create_revision?: boolean;
+    revision_label?: string;
+    processing_priority?: ContentObjectProcessingPriority;
+}
+
+export interface UpdateContentObjectHeaders {
+    'if-match'?: string;
+    'x-create-revision'?: boolean;
+    'x-revision-label'?: string;
+    'x-processing-priority'?: ContentObjectProcessingPriority;
+    'x-suppress-workflows'?: boolean;
+}
+
+export interface GetObjectRenditionQuery {
+    block_on_generation?: boolean;
+    generate_if_missing?: boolean;
+    max_hw?: number;
+    sign_url?: boolean;
+}
+
 /**
  * Headers for Data Store API calls.
  * Used for Cloud Run session affinity to route requests to the same instance.
@@ -54,6 +85,64 @@ export interface ContentObjectUserPermissions {
     can_delete: boolean;
 }
 
+export interface ContentObjectTextResponse {
+    text?: string;
+}
+
+export interface DeleteContentObjectResult {
+    id: string;
+    count: number;
+}
+
+export interface SetObjectEmbeddingsResponse {
+    type?: Embedding;
+}
+
+export interface ContentObjectApiTypeRef {
+    id?: string;
+    code?: string;
+    name: string;
+}
+
+export interface ContentObjectApiRevision {
+    parent?: string;
+    root: string;
+    head: boolean;
+    label?: string;
+}
+
+export interface ContentObjectItemApiResponse extends BaseObject {
+    parent: string;
+    location: string;
+    status: ContentObjectStatus;
+    type?: ContentObjectApiTypeRef;
+    content: ContentSource;
+    external_id?: string;
+    properties: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+    tokens?: {
+        count: number;
+        encoding: string;
+        etag: string;
+    };
+    revision: ContentObjectApiRevision;
+    is_deleted?: boolean;
+    is_locked?: boolean;
+    score?: number;
+    user_permissions?: ContentObjectUserPermissions;
+}
+
+export interface ContentObjectApiResponse extends ContentObjectItemApiResponse {
+    text?: string;
+    text_etag?: string;
+    embeddings?: Record<string, Embedding>;
+    parts?: string[];
+    parts_etag?: string;
+    transcript?: Record<string, unknown>;
+    security?: Record<string, string[]>;
+    inherited_properties?: InheritedPropertyMetadata[];
+}
+
 export interface ContentObject<T = any> extends ContentObjectItem<T> {
     text?: string; // the text representation of the object
     text_etag?: string;
@@ -493,6 +582,12 @@ export interface GetRenditionResponse {
     workflow_run_id?: string;
 }
 
+export interface ObjectSearchResponse {
+    results: ContentObjectItem<Record<string, unknown>>[];
+    facets: import('../facets.js').ComputedFacetResponse;
+    aggregations?: Record<string, unknown>;
+}
+
 // ============================================================================
 // Rendition Format Compatibility Utilities
 // ============================================================================
@@ -627,6 +722,15 @@ export interface GetFileUrlResponse {
     path: string;
 }
 
+export interface FileMetadataResponse {
+    name: string;
+    size: number;
+    contentType: string;
+    contentDisposition?: string;
+    etag?: string;
+    customMetadata?: Record<string, string>;
+}
+
 export interface SetFileMetadataPayload {
     /** The file path (relative to bucket) or full URI */
     file: string;
@@ -634,6 +738,11 @@ export interface SetFileMetadataPayload {
     metadata: Record<string, string>;
 }
 
+export interface FileMetadataUpdateResult {
+    success: boolean;
+    file: string;
+}
+
 export interface BulkUploadUrlsPayload {
     files: { name: string; mime_type?: string; id?: string }[];
 }
@@ -642,6 +751,61 @@ export interface BulkUploadUrlsResponse {
     files: GetFileUrlResponse[];
 }
 
+export interface FileBucketResponse {
+    bucket: string;
+}
+
+export interface FileListResponse {
+    files: string[];
+}
+
+export interface FileMetadataQuery {
+    file: string;
+}
+
+export interface FileListQuery {
+    prefix: string;
+}
+
+export interface FileDeleteQuery {
+    prefix?: boolean;
+}
+
+export interface ContentObjectTypeCatalogQuery {
+    tag?: string;
+    layout?: boolean;
+    schema?: boolean;
+    limit?: number;
+    offset?: number;
+}
+
+export interface ContentObjectTypeListQuery {
+    name?: string;
+    chunkable?: boolean;
+    layout?: boolean;
+    schema?: boolean;
+    limit?: number;
+    offset?: number;
+}
+
+export interface CopyFilePayload {
+    source: string;
+    dest: string;
+}
+
+export interface CopyFileResponse {
+    success: boolean;
+    source: string;
+    dest: string;
+}
+
+export interface DeleteFileResult {
+    success: boolean;
+    count: number;
+    message?: string;
+    file?: string;
+}
+
 export enum ContentObjectProcessingPriority {
     normal = "normal",
     low = "low",

package/src/store/workflow.ts

@@ -1,4 +1,6 @@
+import type { ModelOptions } from "@llumiverse/common";
 import { ConversationVisibility, InteractionRef, UserChannel } from "../interaction.js";
+import { JSONValue } from "../json.js";
 import { JSONSchema } from "../json-schema.js";
 import type { WorkflowInput } from "./dsl-workflow.js";
 
@@ -587,12 +589,44 @@ export interface ListWorkflowRunsResponse {
     has_more?: boolean;
 }
 
+export interface WorkflowExecutionStartResult {
+    run_id: string;
+    workflow_id: string;
+}
+
 export interface ListWorkflowInteractionsResponse {
     workflow_id: string,
     run_id: string,
     interaction: WorkflowInteractionVars
 }
 
+export interface WorkflowRunUpdatesResponse {
+    messages: CompactMessage[];
+}
+
+export interface WorkflowRunDetailsQuery {
+    include_history?: boolean;
+    history_format?: 'events' | 'tasks' | 'agent';
+}
+
+export interface WorkflowRunUpdatesQuery {
+    since?: number;
+}
+
+export interface WorkflowRunStreamQuery extends WorkflowRunUpdatesQuery {
+    skipHistory?: boolean;
+}
+
+export interface WorkflowUpdatePublishResponse {
+    success: true;
+}
+
+export interface WorkflowActionResponse {
+    message: string;
+}
+
+export type WorkflowQueryResult = JSONValue;
+
 export interface WorkflowInteractionVars {
     type: string,
     interaction: string,
@@ -608,7 +642,8 @@ export interface WorkflowInteractionVars {
     tool_names: string[],
     config: {
         environment: string,
-        model: string
+        model: string,
+        model_options?: ModelOptions
     },
     interactionParamsSchema?: JSONSchema,
     collection_id?: string;

package/src/sts-token-types.ts

@@ -110,8 +110,14 @@ export interface TokenResponse {
     token: string;
 }
 
+export interface IssueTokenResponse {
+    token: string;
+    token_type: 'Bearer';
+    expires_in?: number;
+}
+
 export interface ValidateTokenResponse {
     valid: boolean;
     payload?: any;
     error?: string;
-}
+}

package/src/user.ts

@@ -1,5 +1,5 @@
 import { ApiKey } from "./apikey.js";
-import { ProjectRoles } from "./project.js";
+import { ProjectRef, ProjectRoles } from "./project.js";
 
 export interface UserWithAccounts extends User {
     accounts: AccountRef[];
@@ -116,6 +116,23 @@ export interface InviteUserResponsePayload {
     action: 'invited' | 'added';
 }
 
+export interface InviteAcceptanceResponse {
+    status: 'added';
+}
+
+export interface InviteDeclineResponse {
+    status: 'deleted';
+}
+
+export interface AccountProjectsResponse {
+    data: ProjectRef[];
+}
+
+export interface GoogleProjectTokenResponse {
+    principal: string;
+    token: string;
+}
+
 
 
 type UserOrApiKey<T extends User | ApiKey> = T extends User ? User : ApiKey;