@vertesia/common 1.5.0-dev.20260806.125520Z → 1.5.0-dev.20260826.064249Z

package/src/store/hive-memory.ts

@@ -1,167 +0,0 @@
-import type { BaseObject } from './common.js';
-
-/**
- * Tool recommendation within a hive memory unit
- */
-export interface HiveMemoryToolRecommendation {
-    tool_name: string;
-    guidance: string;
-}
-
-/**
- * Memory unit scope - project-scoped by default, can be elevated to account
- */
-export type HiveMemoryScope = 'project' | 'account';
-
-/**
- * Base interface for hive memory items (list/summary view)
- */
-export interface HiveMemoryItem extends BaseObject {
-    // Classification
-    task_category: string; // "document-analysis", "data-extraction", etc.
-    domain?: string; // "financial", "legal", etc.
-
-    // Summary
-    summary: string;
-
-    // Tools involved in the learnings
-    tools_involved: string[];
-
-    // Quality metrics
-    confidence_score: number; // 0-1
-    usage_count: number;
-    success_correlation: number; // correlation with successful runs
-    contribution_count: number; // number of runs that contributed
-
-    // Scoping
-    scope: HiveMemoryScope;
-}
-
-/**
- * Full hive memory unit with all learnings and patterns
- */
-export interface HiveMemory extends HiveMemoryItem {
-    // Objective patterns this memory applies to
-    objective_patterns: string[];
-
-    // Learnings
-    general_learnings: string[];
-    best_practices: string[];
-    pitfalls_to_avoid: string[];
-    tool_recommendations: HiveMemoryToolRecommendation[];
-
-    // Vector search
-    embedding?: number[];
-
-    // Security field for granular permissions
-    security?: Record<string, string[]>;
-}
-
-/**
- * Payload for creating a new hive memory unit
- */
-export interface CreateHiveMemoryPayload {
-    // Classification
-    task_category: string;
-    domain?: string;
-
-    // Content
-    summary: string;
-    objective_patterns: string[];
-
-    // Learnings
-    general_learnings: string[];
-    best_practices?: string[];
-    pitfalls_to_avoid?: string[];
-    tool_recommendations?: HiveMemoryToolRecommendation[];
-
-    // Metadata
-    tools_involved?: string[];
-
-    // Quality (optional, defaults applied)
-    confidence_score?: number;
-
-    // Scoping
-    scope?: HiveMemoryScope;
-
-    // Standard fields
-    name?: string;
-    description?: string;
-    tags?: string[];
-}
-
-/**
- * Payload for updating an existing hive memory unit
- */
-export interface UpdateHiveMemoryPayload {
-    // Classification updates
-    task_category?: string;
-    domain?: string;
-
-    // Content updates
-    summary?: string;
-
-    // Array additions (merged with existing)
-    add_objective_patterns?: string[];
-    add_general_learnings?: string[];
-    add_best_practices?: string[];
-    add_pitfalls_to_avoid?: string[];
-    add_tool_recommendations?: HiveMemoryToolRecommendation[];
-    add_tools_involved?: string[];
-
-    // Quality updates
-    confidence_score?: number;
-    increment_usage_count?: boolean;
-    increment_contribution_count?: boolean;
-    success_correlation?: number;
-
-    // Scoping
-    scope?: HiveMemoryScope;
-
-    // Standard fields
-    name?: string;
-    description?: string;
-    tags?: string[];
-}
-
-/**
- * Search parameters for finding relevant memories
- */
-export interface HiveMemorySearchParams {
-    // Semantic search
-    query?: string; // Natural language query
-    embedding?: number[]; // Pre-computed embedding for vector search
-
-    // Filters
-    task_category?: string;
-    domain?: string;
-    tools_involved?: string[];
-    scope?: HiveMemoryScope;
-    min_confidence?: number; // Minimum confidence score (0-1)
-
-    // Pagination
-    limit?: number; // Default: 5
-    offset?: number;
-}
-
-/**
- * Response from memory search
- */
-export interface HiveMemorySearchResult {
-    memories: HiveMemory[];
-    total: number;
-}
-
-/**
- * Formatted memory for agent consumption
- */
-export interface FormattedMemoryForAgent {
-    category: string;
-    domain?: string;
-    summary: string;
-    learnings: string[];
-    best_practices: string[];
-    pitfalls_to_avoid: string[];
-    tool_guidance: { tool: string; guidance: string }[];
-    confidence: number;
-}

package/src/store/object-types.ts

@@ -1,123 +0,0 @@
-import type { JSONSchemaType } from 'ajv';
-
-/*Default JSON Schema type for rendition*/
-
-export interface RenditionProperties {
-    mime_type: string;
-    source_etag?: string;
-    height?: number;
-    width?: number;
-    multipart?: boolean;
-    total_parts?: number;
-}
-
-export const RenditionSchema: JSONSchemaType<RenditionProperties> = {
-    type: 'object',
-    description:
-        'Represent a rendition of a file stored in an object. It will be stored as a separate object in the database.',
-    properties: {
-        mime_type: {
-            type: 'string',
-            description: 'The format of the rendition. This is a MIME type.',
-        },
-        source_etag: {
-            type: 'string',
-            description: 'The ETag of the file used for the rendition.',
-            nullable: true,
-        },
-        height: {
-            type: 'integer',
-            description: 'The height of the rendition',
-            nullable: true,
-        },
-        width: {
-            type: 'integer',
-            description: 'The width of the rendition',
-            nullable: true,
-        },
-        multipart: {
-            type: 'boolean',
-            description: 'If the rendition is a multi-part rendition',
-            nullable: true,
-            default: false,
-        },
-        total_parts: {
-            type: 'integer',
-            description: 'The total number of parts in the rendition',
-            nullable: true,
-        },
-    },
-    required: ['mime_type'],
-};
-
-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 const DocumentPartSchema: JSONSchemaType<DocumentPartProperties> = {
-    type: 'object',
-    description: 'Represent a semantic chunk of a document',
-    properties: {
-        source_etag: {
-            type: 'string',
-            description: 'The ETag of the file used for the rendition.',
-            nullable: true,
-        },
-        part_number: {
-            type: 'integer',
-            description: 'The part number of the chunk',
-        },
-        title: {
-            type: 'string',
-            description: 'The title of the chunk',
-            nullable: true,
-        },
-        source_line_start: {
-            type: 'integer',
-            description: 'The line number where the chunk starts',
-            nullable: true,
-        },
-        source_line_end: {
-            type: 'integer',
-            description: 'The line number where the chunk ends',
-            nullable: true,
-        },
-        type: {
-            type: 'string',
-            description: 'The type of the chunk',
-            enum: ['text', 'image', 'table', 'chart', 'diagram', 'code', 'other'],
-            nullable: true,
-        },
-        page_number: {
-            type: 'integer',
-            description: 'The page number of the document part',
-            nullable: true,
-        },
-        description: {
-            type: 'string',
-            description:
-                "The description of the document part, if it's an image, the exhaustive description of the image",
-            nullable: true,
-        },
-        height: {
-            type: 'integer',
-            description: 'The height of the rendition',
-            nullable: true,
-        },
-        width: {
-            type: 'integer',
-            description: 'The width of the rendition',
-            nullable: true,
-        },
-    },
-    required: ['part_number'],
-};

package/src/store/process-schema.test.ts

@@ -1,149 +0,0 @@
-import Ajv from 'ajv';
-import { describe, expect, it } from 'vitest';
-import { PROCESS_DEFINITION_FORMAT_VERSION, type ProcessDefinitionBody } from './process.js';
-import { ProcessDefinitionBodyJsonSchema } from './process-schema.js';
-
-function validDefinition(): ProcessDefinitionBody {
-    return {
-        format_version: PROCESS_DEFINITION_FORMAT_VERSION,
-        process: 'invoice_review',
-        initial: 'fanout',
-        metadata: {
-            provenance: {
-                bpmn: {
-                    process_id: 'InvoiceReview',
-                },
-            },
-        },
-        context: {
-            schema: {
-                type: 'object',
-                additionalProperties: true,
-                properties: {
-                    invoices: { type: 'array' },
-                    results: { type: 'array' },
-                },
-            },
-            initial: {
-                invoices: [],
-            },
-        },
-        nodes: {
-            fanout: {
-                type: 'foreach',
-                foreach: 'invoices',
-                as: 'invoice',
-                item_id: '{{invoice.id}}',
-                max_concurrency: 10,
-                failure_policy: 'collect_errors',
-                collect: {
-                    into: 'results',
-                    include: ['status', 'index', 'item_id', 'output', 'child_run_id'],
-                },
-                metadata: {
-                    editor: {
-                        render: 'foreach',
-                    },
-                },
-                node: {
-                    type: 'process',
-                    process: 'invoice_child_review',
-                    run_type: 'programmatic',
-                    returns: {
-                        from: 'context.review',
-                    },
-                },
-                transitions: [{ to: 'done', metadata: { edge_kind: 'default' } }],
-            },
-            done: {
-                type: 'final',
-            },
-        },
-    };
-}
-
-describe('process definition JSON schema', () => {
-    it('accepts current process engine definition features', () => {
-        const validate = new Ajv.default({ allErrors: true, strict: false }).compile(ProcessDefinitionBodyJsonSchema);
-
-        expect(validate(validDefinition())).toBe(true);
-    });
-
-    it('accepts inline script sources and script nodes', () => {
-        const validate = new Ajv.default({ allErrors: true, strict: false }).compile(ProcessDefinitionBodyJsonSchema);
-        const definition = validDefinition();
-        definition.resources = {
-            scripts: {
-                normalize: {
-                    language: 'typescript',
-                    entrypoint: 'main.ts',
-                    source: {
-                        type: 'inline',
-                        files: {
-                            'main.ts': 'console.log("ok");',
-                        },
-                    },
-                    packages: ['zod@4.0.0'],
-                },
-            },
-        };
-        definition.nodes.fanout.node = {
-            type: 'script',
-            script: 'normalize',
-            timeout: 120,
-        };
-
-        expect(validate(definition)).toBe(true);
-    });
-
-    it('rejects legacy script resources without a source discriminator', () => {
-        const validate = new Ajv.default({ allErrors: true, strict: false }).compile(ProcessDefinitionBodyJsonSchema);
-        const definition = validDefinition() as unknown as Record<string, unknown>;
-        definition.resources = {
-            scripts: {
-                normalize: {
-                    language: 'typescript',
-                    entrypoint: 'main.ts',
-                    files: { 'main.ts': 'console.log("ok");' },
-                },
-            },
-        };
-
-        expect(validate(definition)).toBe(false);
-    });
-
-    it('rejects malformed process definition shape for editor diagnostics', () => {
-        const validate = new Ajv.default({ allErrors: true, strict: false }).compile(ProcessDefinitionBodyJsonSchema);
-        const invalidDefinition = {
-            format_version: PROCESS_DEFINITION_FORMAT_VERSION,
-            process: 'invoice_review',
-            initial: 'fanout',
-            context: {
-                schema: {
-                    type: 'object',
-                },
-                initial: {},
-            },
-            nodes: {
-                fanout: {
-                    type: 'foreach',
-                    collect: {
-                        into: 'results',
-                        include: ['bogus'],
-                    },
-                    node: {
-                        type: 'human_task',
-                    },
-                    transitions: [{ to: 'done', trigger: 'manual' }],
-                },
-                done: {
-                    type: 'final',
-                },
-            },
-        };
-
-        expect(validate(invalidDefinition)).toBe(false);
-        const messages = validate.errors?.map((error) => error.message ?? '') ?? [];
-        expect(messages).toContain('must be equal to one of the allowed values');
-    });
-});