@vertesia/common 1.0.0-dev.20260203.130115Z → 1.0.0-dev.20260227.104700Z

package/lib/types/store/hive-memory.d.ts.map

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

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

@@ -0,0 +1,15 @@
+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 "./hive-memory.js";
+export * from "./object-types.js";
+export * from "./schedule.js";
+export * from "./signals.js";
+export * from "./store.js";
+export * from "./rendering.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,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,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/rendering.d.ts

@@ -0,0 +1,193 @@
+/**
+ * Rendering API types
+ *
+ * Types for rendering content to various formats (PDF, DOCX, images)
+ */
+import { ImageRenditionFormat, MarkdownRenditionFormat } from "./store.js";
+import { WorkflowExecutionStatus, WorkflowRunStatus } from "./workflow.js";
+/** Base vars shared by all rendition types */
+interface BaseRenditionVars {
+    mime_type?: string;
+    /** Custom upload path — overrides the default renditions/{etag}/{name} path */
+    outputPath?: string;
+}
+/** Workflow vars for image renditions (jpeg, png, webp) */
+export interface ImageRenditionVars extends BaseRenditionVars {
+    format?: ImageRenditionFormat;
+    max_hw?: number;
+    max_pages?: number;
+}
+/** Metadata for PDF rendering (displayed in header/footer) */
+export interface PdfRenderingMetadata {
+    /** Document ID to display in footer */
+    document_id?: string;
+    /** Agent name that generated the document */
+    agent_name?: string;
+    /** Agent run ID to display in footer */
+    agent_run_id?: string;
+    /** Document subtitle */
+    subtitle?: string;
+    /** Document author(s) */
+    author?: string | string[];
+    /** Document date (displayed in header and title page; defaults to today if omitted) */
+    date?: string;
+}
+/** Workflow vars for markdown renditions (pdf, docx) */
+export interface MarkdownRenditionVars extends BaseRenditionVars {
+    format: MarkdownRenditionFormat;
+    /** Inline markdown content (mutually exclusive with objectId) */
+    content?: string;
+    /** Blob store path to fetch markdown from (mutually exclusive with content/objectId) */
+    artifactPath?: string;
+    /** Document title for inline content */
+    title?: string;
+    /** URL to template file (LaTeX for PDF, reference doc for DOCX) */
+    templateUrl?: string;
+    /** Optional logo URL for template variable `logo-path` (studio-hosted URL) */
+    templateLogoUrl?: string;
+    /** Template file via artifact:/store: protocol (takes precedence over templateUrl) */
+    templatePath?: string;
+    /** Logo file via artifact:/store: protocol (takes precedence over templateLogoUrl) */
+    logoPath?: string;
+    /** Use Vertesia default template if no templateUrl provided (default: true for pdf) */
+    useDefaultTemplate?: boolean;
+    /** Additional pandoc command-line options */
+    pandocOptions?: string[];
+    /** Run ID for resolving artifact: URLs in markdown */
+    artifactRunId?: string;
+    /** Document metadata for PDF footer/header */
+    metadata?: PdfRenderingMetadata;
+    /** Source reference for auto-wired template data: `store:<objectId>` or `artifact:<path-to-json>` */
+    templateDataSource?: string;
+}
+/** Discriminated union of all rendition workflow vars */
+export type GenerateRenditionVars = ImageRenditionVars | MarkdownRenditionVars;
+/** Type guard for markdown rendition vars */
+export declare function isMarkdownRenditionVars(vars: GenerateRenditionVars): vars is MarkdownRenditionVars;
+/**
+ * Payload for rendering markdown to PDF or DOCX.
+ * Either object_id OR content must be provided.
+ */
+export interface RenderMarkdownPayload {
+    /** Output format */
+    format: MarkdownRenditionFormat;
+    /** Object ID to render (mutually exclusive with content) */
+    object_id?: string;
+    /** Inline markdown content to render (mutually exclusive with object_id) */
+    content?: string;
+    /** Document title (used for filename when using inline content) */
+    title?: string;
+    /** URL to a template file for pandoc (DOCX reference doc or LaTeX template) */
+    template_url?: string;
+    /** Optional logo URL for template variable `logo-path` (studio-hosted URL) */
+    template_logo_url?: string;
+    /** Template file via artifact:/store: protocol (takes precedence over template_url) */
+    template_path?: string;
+    /** Logo file via artifact:/store: protocol (takes precedence over template_logo_url) */
+    logo_path?: string;
+    /** Use Vertesia default template if no template_url provided (default: true for pdf) */
+    use_default_template?: boolean;
+    /** Additional pandoc command-line options */
+    pandoc_options?: string[];
+    /** Run ID for resolving artifact: and image: URLs */
+    artifact_run_id?: string;
+    /** Document metadata for PDF footer/header */
+    metadata?: PdfRenderingMetadata;
+    /** Source reference for auto-wired template data: `store:<objectId>` or `artifact:<path-to-json>` */
+    template_data_source?: string;
+    /** Custom upload path for the rendered output */
+    output_path?: string;
+}
+/**
+ * Initial response when starting a markdown rendering workflow.
+ * Clients should poll status using workflow_id/workflow_run_id.
+ */
+export interface RenderMarkdownStartResponse extends WorkflowRunStatus {
+    /** Requested output format */
+    format: MarkdownRenditionFormat;
+}
+/**
+ * Polled status response for markdown rendering workflow.
+ */
+export interface RenderMarkdownStatusResponse extends WorkflowRunStatus {
+    /** Requested output format (if known) */
+    format?: MarkdownRenditionFormat;
+    /** Download URL for completed output */
+    download_url?: string;
+    /** File URI in storage for completed output */
+    file_uri?: string;
+    /** Error details for failed/terminated runs */
+    error?: string;
+}
+/**
+ * Client-side polling options for markdown rendering.
+ */
+export interface RenderMarkdownPollOptions {
+    /** Maximum time to wait in milliseconds (default: 10 minutes) */
+    timeoutMs?: number;
+    /** Polling interval in milliseconds (default: 1500ms) */
+    pollIntervalMs?: number;
+}
+/**
+ * Result from the GenerateRenditions workflow.
+ * Shared between zeno-server (consumer) and workflows (producer).
+ */
+export interface GenerateRenditionsResult {
+    uploads: string[];
+    format: string;
+    status: string;
+    fileUri?: string;
+    /** Warnings about rich content blocks that failed to render (document was still produced) */
+    warnings?: string[];
+}
+/**
+ * Response from the rendering API.
+ */
+export interface RenderMarkdownResponse {
+    /** Rendering status */
+    status: "success";
+    /** Output format */
+    format: MarkdownRenditionFormat;
+    /** Download URL for the rendered document */
+    download_url?: string;
+    /** File URI in storage */
+    file_uri?: string;
+}
+/** A slide rendered from a named SVG template with structured content */
+export interface TemplateSlide {
+    type: 'template';
+    /** Template name: 'title' | 'section' | 'bullets' | 'two-column' | 'image-text' */
+    template: string;
+    /** Key-value content for the template (values can be strings or string arrays) */
+    content: Record<string, string | string[]>;
+}
+/** A slide with raw SVG markup */
+export interface RawSvgSlide {
+    type: 'svg';
+    /** Complete SVG markup (should use 1920x1080 viewBox) */
+    svg: string;
+}
+/** A single slide specification — either template-based or raw SVG */
+export type SlideSpec = TemplateSlide | RawSvgSlide;
+/** Options for rendering a slide deck to PDF */
+export interface RenderSlidesDeckOptions {
+    /** Canvas scale factor for higher resolution (default: 2) */
+    scale?: number;
+    /** Background color for each slide (default: '#ffffff') */
+    backgroundColor?: string;
+    /** Slide theme — replaces default colors in SVG templates */
+    theme?: Record<string, string>;
+}
+/** Result of rendering a slide deck to PDF */
+export interface RenderSlidesDeckResult {
+    /** PDF file as a Uint8Array (use Buffer.from() in Node.js) */
+    buffer: Uint8Array;
+    /** Number of slides rendered */
+    slideCount: number;
+    /** PDF page width in points (720 = 10") */
+    pageWidth: number;
+    /** PDF page height in points (540 = 7.5") */
+    pageHeight: number;
+}
+export declare function isWorkflowTerminalStatus(status: WorkflowExecutionStatus): boolean;
+export {};

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

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

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

@@ -0,0 +1,184 @@
+/**
+ * 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;
+    /** Visibility of the conversation (defaults to "project") */
+    visibility?: 'project' | 'private';
+}
+/**
+ * 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"}