@vertesia/common 0.24.0-dev.202601221707

package/lib/types/store/dsl-workflow.d.ts

@@ -0,0 +1,244 @@
+import { StringValue } from "ms";
+import { BaseObject } from "./common.js";
+import { WorkflowExecutionPayload } from "./index.js";
+import { ParentClosePolicyType } from "./temporalio.js";
+/**
+ * The payload sent when starting a workflow from the temporal client to the workflow instance.
+ */
+export interface DSLWorkflowExecutionPayload extends WorkflowExecutionPayload {
+    /**
+     * The workflow definition to be used by the DSL workflow.
+     * If a dsl workflow is executed and no definition is provided the workflow will fail.
+     */
+    workflow: DSLWorkflowSpec;
+}
+/**
+ * The payload for a DSL activity options.
+ *
+ * @see ActivityOptions in @temporalio/common
+ */
+export interface DSLActivityOptions {
+    startToCloseTimeout?: StringValue | number;
+    scheduleToStartTimeout?: StringValue | number;
+    scheduleToCloseTimeout?: StringValue | number;
+    retry?: DSLRetryPolicy;
+}
+/**
+ * The payload for a DSL retry policy.
+ *
+ * @see RetryPolicy in @temporalio/common
+ */
+export interface DSLRetryPolicy {
+    backoffCoefficient?: number;
+    initialInterval?: StringValue | number;
+    maximumAttempts?: number;
+    maximumInterval?: StringValue | number;
+    nonRetryableErrorTypes?: string[];
+}
+/**
+ * The payload for a DSL activity execution.
+ */
+export interface DSLActivityExecutionPayload<ParamsT extends Record<string, any>> extends WorkflowExecutionPayload {
+    activity: DSLActivitySpec;
+    params: ParamsT;
+    workflow_name: string;
+    debug_mode?: boolean;
+}
+export type ImportSpec = (string | Record<string, string>)[];
+export interface ActivityFetchSpec {
+    /**
+     * The data provider name
+     */
+    type: "document" | "document_type" | "interaction_run";
+    /**
+     * An optional URI to the data source.
+     */
+    source?: string;
+    /**
+     * The query to be executed by the data provider
+     */
+    query: Record<string, any>;
+    /**
+     * a string of space separated field names.
+     * Prefix a field name with "-" to exclude it from the result.
+     */
+    select?: string;
+    /**
+     * The number of results to return. If the result is limited to 1 the result will be a single object
+     */
+    limit?: number;
+    /**
+     * How to handle not found objects.
+     * 1. ignore - Ignore and return an empty array for multi objects query (or undefined for single object query) or empty array for multiple objects throw an error.
+     * 2. throw - Throw an error if the object or no objects are found.
+     */
+    on_not_found?: "ignore" | "throw";
+}
+export interface DSLWorkflowStepBase {
+    /**
+     * The type fo the step.
+     * If not set defaults to "activity"
+     */
+    type: "activity" | "workflow";
+}
+export interface DSLActivitySpec<PARAMS extends Record<string, any> = Record<string, any>> {
+    /**
+     * The name of the activity function
+     */
+    name: string;
+    /**
+     * Title of the activity to be displayed in the UI workflow builder
+     */
+    title?: string;
+    /**
+     * The description of the activity to e displayed in the UI workflow builder
+     */
+    description?: string;
+    /**
+     * Activities parameters. These parameters can be either literals
+     * (hardcoded strings, numbers, booleans, objects, arrays etc.), either
+     * references to the workflow variables.
+     * The workflow variables are built from the workflow params (e.g. the workflow configuration)
+     * and from the result of the previous activities.
+     */
+    params?: PARAMS;
+    /**
+     * The name of the workflow variable that will store the result of the activity
+     * If not specified the result will not be stored
+     * The parameters describe how the actual parameters will be obtained from the workflow execution vars.
+     * since it may contain references to workflow execution vars.
+     */
+    output?: string;
+    /**
+     * A JSON expression which evaluate to true or false similar to mongo matches.
+     * We support for now basic expression like: $true, $false, $eq, $ne, $gt, $gte, $lt, $lte, $in, $nin, $regexp
+     * {$eq: {name: value}},
+     * Ex: {$eq: {wfVarName: value}}
+     */
+    condition?: Record<string, any>;
+    /**
+     * The import spec is used to import data from workflow variables.
+     * The import spec is a list of variable names to import from the workflow context.
+     * You can also use objects to rename the imported variables, or to reference an expression.
+     * Example:
+     * ["runId", {"typeId": "docType.id"}]
+     */
+    import?: ImportSpec;
+    /**
+     * The fetch phase is used to fetch data from external sources.
+     */
+    fetch?: Record<string, ActivityFetchSpec>;
+    /**
+     * Projection to apply to the result. Not all activities support this.
+     */
+    projection?: never | Record<string, any>;
+    /**
+     * If true the activity will be executed in parallel with the other activities.
+     * (i.e. the workflow will not wait for the activity to finish before starting the next one)
+     */
+    parallel?: boolean;
+    /**
+     * Await for a parallel activity execution to return.
+     */
+    await?: string;
+    /**
+     * Activity options for configuring the activity execution, which overrides the activity options
+     * defined at workflow level.
+     */
+    options?: DSLActivityOptions;
+}
+export interface DSLActivityStep<PARAMS extends Record<string, any> = Record<string, any>> extends DSLActivitySpec<PARAMS>, DSLWorkflowStepBase {
+    type: "activity";
+}
+export interface DSLChildWorkflowStep extends DSLWorkflowStepBase {
+    type: "workflow";
+    name: string;
+    /**
+     * The parameters to pass to the child workflow.
+     * These parameters will be merged over the parent workflow vars and passed altogether to the child workflow.
+     */
+    vars?: Record<string, any>;
+    async?: boolean;
+    /**
+     * The name of the workflow variable that will store the result of the child workflow (if async the workflow id is stored)
+     * If not specified the result will not be stored
+     * The parameters describe how the actual parameters will be obtained from the workflow execution vars.
+     * since it may contain references to workflow execution vars.
+     */
+    output?: string;
+    /**
+     * In case the dslWorkflow is used as a child workflow the spec is used to define the child workflow.
+     * If spec is defined then the name must be "dslWorkflow"
+     */
+    spec?: DSLWorkflowSpec;
+    /**
+     * If true, copy the parent's workspace artifacts (scripts/, files/, skills/, docs/, out/)
+     * to the child workflow's agent space before execution. Defaults to true.
+     * conversation.json and tools.json are never copied.
+     */
+    inherit_artifacts?: boolean;
+    options?: {
+        memo?: Record<string, any>;
+        retry?: DSLRetryPolicy;
+        searchAttributes?: Record<string, string[] | number[] | boolean[] | Date[]>;
+        taskQueue?: string;
+        workflowExecutionTimeout?: StringValue | number;
+        workflowRunTimeout?: StringValue | number;
+        workflowTaskTimeout?: StringValue | number;
+        workflowId?: string;
+        cronSchedule?: string;
+        parentClosePolicy?: ParentClosePolicyType;
+    };
+}
+export type DSLWorkflowStep = DSLActivityStep | DSLChildWorkflowStep;
+export interface DSLWorkflowSpecBase {
+    name: string;
+    description?: string;
+    tags?: string[];
+    steps?: DSLWorkflowStep[] | never;
+    /**
+     * @deprecated use steps instead
+     */
+    activities?: DSLActivitySpec[] | never;
+    vars: Record<string, any>;
+    options?: DSLActivityOptions;
+    result?: string;
+    debug_mode?: boolean;
+}
+export interface DSLWorkflowSpecWithSteps extends DSLWorkflowSpecBase {
+    steps: DSLWorkflowStep[];
+    /**
+     * @deprecated use steps instead
+     */
+    activities?: never;
+}
+/**
+ * @deprecated use steps instead
+ */
+export interface DSLWorkflowSpecWithActivities extends DSLWorkflowSpecBase {
+    steps?: never;
+    /**
+     * @deprecated use steps instead
+     */
+    activities: DSLActivitySpec[];
+}
+/**
+ * activities and steps fields are mutually exclusive
+ * steps was added after activities and may contain a mix of activities and other tasks like exec child workflows.
+ * For backward compatibility we keep the activities field as a fallback but one should use one or the other not both.
+ */
+export type DSLWorkflowSpec = DSLWorkflowSpecWithSteps | DSLWorkflowSpecWithActivities;
+export interface DSLWorkflowDefinition extends BaseObject, DSLWorkflowSpecBase {
+    input_schema?: Record<string, any>;
+    activities?: DSLActivitySpec[];
+    steps?: DSLWorkflowStep[];
+}
+export interface WorkflowDefinitionRef {
+    id: string;
+    name: string;
+    description?: string;
+    tags?: string[];
+    created_at: Date;
+    updated_at: Date;
+}
+export declare const WorkflowDefinitionRefPopulate = "id name description tags created_at updated_at";

package/lib/types/store/dsl-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dsl-workflow.d.ts","sourceRoot":"","sources":["../../../src/store/dsl-workflow.ts"],"names":[],"mappings":"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"}

package/lib/types/store/index.d.ts

@@ -0,0 +1,13 @@
+export * from "./activity-catalog.js";
+export * from "./collections.js";
+export * from "./common.js";
+export * from "./conversation-state.js";
+export * from "./doc-analyzer.js";
+export * from "./dsl-workflow.js";
+export * from "./object-types.js";
+export * from "./schedule.js";
+export * from "./signals.js";
+export * from "./store.js";
+export * from "./temporalio.js";
+export * from "./worker.js";
+export * from "./workflow.js";

package/lib/types/store/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/store/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC"}

package/lib/types/store/object-types.d.ts

@@ -0,0 +1,23 @@
+import type { JSONSchemaType } from "ajv";
+export interface RenditionProperties {
+    mime_type: string;
+    source_etag?: string;
+    height?: number;
+    width?: number;
+    multipart?: boolean;
+    total_parts?: number;
+}
+export declare const RenditionSchema: JSONSchemaType<RenditionProperties>;
+export interface DocumentPartProperties {
+    source_etag?: string;
+    part_number: number;
+    title?: string;
+    source_line_start?: number;
+    source_line_end?: number;
+    type?: 'text' | 'image' | 'table' | 'chart' | 'diagram' | 'code' | 'other';
+    page_number?: number;
+    description?: string;
+    height?: number;
+    width?: number;
+}
+export declare const DocumentPartSchema: JSONSchemaType<DocumentPartProperties>;

package/lib/types/store/object-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object-types.d.ts","sourceRoot":"","sources":["../../../src/store/object-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,KAAK,CAAA;AAIzC,MAAM,WAAW,mBAAmB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,eAAO,MAAM,eAAe,EAAE,cAAc,CAAC,mBAAmB,CAqC/D,CAAA;AAID,MAAM,WAAW,sBAAsB;IAEnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;IAC3E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAElB;AAGD,eAAO,MAAM,kBAAkB,EAAE,cAAc,CAAC,sBAAsB,CAwDrE,CAAA"}

package/lib/types/store/schedule.d.ts

@@ -0,0 +1,182 @@
+/**
+ * Agent Schedule Types
+ *
+ * Defines types for scheduling agents to run on a recurring basis using cron expressions.
+ * Schedules are stored in MongoDB with execution handled by Temporal.
+ */
+/**
+ * Represents a scheduled agent execution configuration.
+ */
+export interface AgentSchedule {
+    /** Unique identifier for the schedule */
+    id: string;
+    /** Human-readable name for the schedule */
+    name: string;
+    /** Optional description of what the schedule does */
+    description?: string;
+    /** Project ID this schedule belongs to */
+    project: string;
+    /** Account ID this schedule belongs to */
+    account: string;
+    /** Interaction ID or endpoint name to execute (e.g., "MyAgent" or ObjectId) */
+    interaction: string;
+    /** Cached interaction name for display purposes */
+    interaction_name?: string;
+    /**
+     * Cron expression defining when to run.
+     * Standard 5-field format: minute hour day-of-month month day-of-week
+     * Examples:
+     * - "0 0 * * MON" - Every Monday at midnight
+     * - "0 9 * * *" - Daily at 9am
+     * - "0 * * * *" - Every hour
+     */
+    cron_expression: string;
+    /** Timezone for the cron expression (defaults to "UTC") */
+    timezone?: string;
+    /** Variables to pass to the agent workflow */
+    vars?: Record<string, any>;
+    /** Optional task queue override for the workflow */
+    task_queue?: string;
+    /** Whether the schedule is enabled (can be paused/resumed) */
+    enabled: boolean;
+    /** Temporal schedule ID once created (format: schedule:{accountId}:{projectId}:{scheduleId}) */
+    temporal_schedule_id?: string;
+    /** User or service that created this schedule */
+    created_by: string;
+    /** User or service that last updated this schedule */
+    updated_by?: string;
+    /** Timestamp when the schedule was created */
+    created_at: Date;
+    /** Timestamp when the schedule was last updated */
+    updated_at: Date;
+    /** Timestamp of the last successful execution */
+    last_run_at?: Date;
+    /** Timestamp of the next scheduled execution */
+    next_run_at?: Date;
+    /** Total number of times this schedule has executed */
+    run_count?: number;
+}
+/**
+ * Payload for creating a new schedule.
+ */
+export interface CreateSchedulePayload {
+    /** Human-readable name for the schedule */
+    name: string;
+    /** Optional description of what the schedule does */
+    description?: string;
+    /** Interaction ID or endpoint name to execute */
+    interaction: string;
+    /**
+     * Cron expression defining when to run.
+     * Standard 5-field format: minute hour day-of-month month day-of-week
+     */
+    cron_expression: string;
+    /** Timezone for the cron expression (defaults to "UTC") */
+    timezone?: string;
+    /** Variables to pass to the agent workflow */
+    vars?: Record<string, any>;
+    /** Optional task queue override */
+    task_queue?: string;
+    /** Whether the schedule should be enabled immediately (defaults to true) */
+    enabled?: boolean;
+}
+/**
+ * Payload for updating an existing schedule.
+ */
+export interface UpdateSchedulePayload {
+    /** Updated name */
+    name?: string;
+    /** Updated description */
+    description?: string;
+    /** Updated cron expression */
+    cron_expression?: string;
+    /** Updated timezone */
+    timezone?: string;
+    /** Updated variables */
+    vars?: Record<string, any>;
+    /** Updated task queue */
+    task_queue?: string;
+    /** Enable or disable the schedule */
+    enabled?: boolean;
+}
+/**
+ * Summary information for listing schedules.
+ */
+export interface ScheduleListItem {
+    id: string;
+    name: string;
+    description?: string;
+    interaction: string;
+    interaction_name?: string;
+    cron_expression: string;
+    timezone?: string;
+    enabled: boolean;
+    last_run_at?: Date;
+    next_run_at?: Date;
+    run_count?: number;
+    created_by: string;
+    updated_at: Date;
+}
+/**
+ * Information about a schedule's recent and upcoming runs.
+ */
+export interface ScheduleRunInfo {
+    /** The schedule ID */
+    schedule_id: string;
+    /** Recent workflow executions from this schedule */
+    recent_runs: Array<{
+        workflow_id: string;
+        run_id: string;
+        started_at: Date;
+        status: string;
+    }>;
+    /** Upcoming scheduled execution times */
+    upcoming_runs: Date[];
+}
+/**
+ * Extended schedule information including Temporal execution details.
+ */
+export interface AgentScheduleWithTemporalInfo extends AgentSchedule {
+    /** Information from Temporal about the schedule execution */
+    temporal_info?: {
+        /** Number of actions (workflow starts) executed */
+        num_actions_taken: number;
+        /** Number of actions missed due to catchup window */
+        num_actions_missed: number;
+        /** Number of actions skipped due to overlap policy */
+        num_actions_skipped: number;
+        /** Currently running workflows started by this schedule */
+        running_actions: Array<{
+            workflow_id: string;
+            run_id: string;
+        }>;
+        /** Recent actions taken by the schedule */
+        recent_actions: Array<{
+            scheduled_at: Date;
+            taken_at: Date;
+            workflow_id: string;
+            run_id: string;
+        }>;
+        /** Next scheduled action times */
+        next_action_times: Date[];
+        /** Whether the schedule is currently paused in Temporal */
+        paused: boolean;
+        /** Optional note about why the schedule is paused */
+        pause_note?: string;
+    };
+}
+/**
+ * Common cron expression presets for UI convenience.
+ */
+export declare const CRON_PRESETS: {
+    readonly EVERY_HOUR: "0 * * * *";
+    readonly EVERY_DAY_MIDNIGHT: "0 0 * * *";
+    readonly EVERY_DAY_9AM: "0 9 * * *";
+    readonly EVERY_MONDAY_MIDNIGHT: "0 0 * * MON";
+    readonly EVERY_WEEKDAY_9AM: "0 9 * * MON-FRI";
+    readonly FIRST_OF_MONTH: "0 0 1 * *";
+};
+/**
+ * Human-readable descriptions for cron presets.
+ */
+export declare const CRON_PRESET_LABELS: Record<keyof typeof CRON_PRESETS, string>;

package/lib/types/store/schedule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule.d.ts","sourceRoot":"","sources":["../../../src/store/schedule.ts"],"names":[],"mappings":"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"}

package/lib/types/store/signals.d.ts

@@ -0,0 +1,24 @@
+export interface UserInputSignal {
+    message: string;
+    metadata?: Record<string, any>;
+    auth_token?: string;
+    /**
+     * Email attachments to be processed as store objects.
+     * These will be downloaded, uploaded to store, and processed for text extraction
+     * before the conversation continues.
+     */
+    attachments?: EmailAttachment[];
+}
+/**
+ * Email attachment metadata for processing in conversation workflows.
+ */
+export interface EmailAttachment {
+    /** Original filename */
+    filename: string;
+    /** MIME content type */
+    content_type: string;
+    /** Size in bytes */
+    size: number;
+    /** Resend download URL (temporary, expires) */
+    download_url: string;
+}

package/lib/types/store/signals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signals.d.ts","sourceRoot":"","sources":["../../../src/store/signals.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,WAAW,CAAC,EAAE,eAAe,EAAE,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAC;CACxB"}