@workglow/ai 0.2.14 → 0.2.16

package/dist/task/ChunkVectorHybridSearchTask.d.ts

@@ -1,167 +0,0 @@
-/**
- * @license
- * Copyright 2025 Steven Roussey <sroussey@gmail.com>
- * SPDX-License-Identifier: Apache-2.0
- */
-import { CreateWorkflow, IExecuteContext, Task } from "@workglow/task-graph";
-import type { TaskConfig } from "@workglow/task-graph";
-import { DataPortSchema, FromSchema, TypedArraySchemaOptions } from "@workglow/util/schema";
-declare const inputSchema: {
-    readonly type: "object";
-    readonly properties: {
-        readonly knowledgeBase: {
-            readonly title: "Knowledge Base";
-            readonly description: "Knowledge base ID or instance";
-        } & {
-            title: string;
-            description: string;
-        } & {
-            readonly format: "knowledge-base";
-            readonly anyOf: readonly [{
-                readonly type: "string";
-                readonly title: "Knowledge Base ID";
-            }, {
-                readonly title: "Knowledge Base Instance";
-                readonly additionalProperties: true;
-            }];
-        };
-        readonly queryVector: {
-            readonly type: "array";
-            readonly format: "TypedArray";
-            readonly title: "Typed Array";
-            readonly description: "A typed array (Float32Array, Int8Array, etc.)";
-        };
-        readonly queryText: {
-            readonly type: "string";
-            readonly title: "Query Text";
-            readonly description: "The query text for full-text search";
-        };
-        readonly topK: {
-            readonly type: "number";
-            readonly title: "Top K";
-            readonly description: "Number of top results to return";
-            readonly minimum: 1;
-            readonly default: 10;
-        };
-        readonly filter: {
-            readonly type: "object";
-            readonly title: "Metadata Filter";
-            readonly description: "Filter results by metadata fields";
-        };
-        readonly scoreThreshold: {
-            readonly type: "number";
-            readonly title: "Score Threshold";
-            readonly description: "Minimum combined score threshold (0-1)";
-            readonly minimum: 0;
-            readonly maximum: 1;
-            readonly default: 0;
-        };
-        readonly vectorWeight: {
-            readonly type: "number";
-            readonly title: "Vector Weight";
-            readonly description: "Weight for vector similarity (0-1), remainder goes to text relevance";
-            readonly minimum: 0;
-            readonly maximum: 1;
-            readonly default: 0.7;
-        };
-        readonly returnVectors: {
-            readonly type: "boolean";
-            readonly title: "Return Vectors";
-            readonly description: "Whether to return vector embeddings in results";
-            readonly default: false;
-        };
-    };
-    readonly required: readonly ["knowledgeBase", "queryVector", "queryText"];
-    readonly additionalProperties: false;
-};
-declare const outputSchema: {
-    readonly type: "object";
-    readonly properties: {
-        readonly chunks: {
-            readonly type: "array";
-            readonly items: {
-                readonly type: "string";
-            };
-            readonly title: "Text Chunks";
-            readonly description: "Retrieved text chunks";
-        };
-        readonly chunk_ids: {
-            readonly type: "array";
-            readonly items: {
-                readonly type: "string";
-            };
-            readonly title: "Chunk IDs";
-            readonly description: "IDs of retrieved chunks";
-        };
-        readonly metadata: {
-            readonly type: "array";
-            readonly items: {
-                readonly type: "object";
-                readonly title: "Metadata";
-                readonly description: "Metadata of retrieved chunk";
-            };
-            readonly title: "Metadata";
-            readonly description: "Metadata of retrieved chunks";
-        };
-        readonly scores: {
-            readonly type: "array";
-            readonly items: {
-                readonly type: "number";
-            };
-            readonly title: "Scores";
-            readonly description: "Combined relevance scores for each result";
-        };
-        readonly vectors: {
-            readonly type: "array";
-            readonly items: {
-                readonly type: "array";
-                readonly format: "TypedArray";
-                readonly title: "Typed Array";
-                readonly description: "A typed array (Float32Array, Int8Array, etc.)";
-            };
-            readonly title: "Vectors";
-            readonly description: "Vector embeddings (if returnVectors is true)";
-        };
-        readonly count: {
-            readonly type: "number";
-            readonly title: "Count";
-            readonly description: "Number of results returned";
-        };
-        readonly query: {
-            readonly type: "string";
-            readonly title: "Query";
-            readonly description: "The text query used for search (pass-through)";
-        };
-    };
-    readonly required: readonly ["chunks", "chunk_ids", "metadata", "scores", "count", "query"];
-    readonly additionalProperties: false;
-};
-export type HybridSearchTaskInput = FromSchema<typeof inputSchema, TypedArraySchemaOptions>;
-export type HybridSearchTaskOutput = FromSchema<typeof outputSchema, TypedArraySchemaOptions>;
-export type ChunkVectorHybridSearchTaskConfig = TaskConfig<HybridSearchTaskInput>;
-/**
- * Task for hybrid search combining vector similarity and full-text search.
- * Requires a knowledge base that supports hybridSearch (e.g., Postgres with pgvector).
- *
- * Hybrid search improves retrieval by combining:
- * - Semantic similarity (vector search) - understands meaning
- * - Keyword matching (full-text search) - finds exact terms
- */
-export declare class ChunkVectorHybridSearchTask extends Task<HybridSearchTaskInput, HybridSearchTaskOutput, ChunkVectorHybridSearchTaskConfig> {
-    static type: string;
-    static category: string;
-    static title: string;
-    static description: string;
-    static cacheable: boolean;
-    static inputSchema(): DataPortSchema;
-    static outputSchema(): DataPortSchema;
-    execute(input: HybridSearchTaskInput, context: IExecuteContext): Promise<HybridSearchTaskOutput>;
-}
-export declare const hybridSearch: (input: HybridSearchTaskInput, config?: ChunkVectorHybridSearchTaskConfig) => Promise<HybridSearchTaskOutput>;
-declare module "@workglow/task-graph" {
-    interface Workflow {
-        hybridSearch: CreateWorkflow<HybridSearchTaskInput, HybridSearchTaskOutput, ChunkVectorHybridSearchTaskConfig>;
-    }
-}
-export {};
-//# sourceMappingURL=ChunkVectorHybridSearchTask.d.ts.map

package/dist/task/ChunkVectorHybridSearchTask.d.ts.map

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

package/dist/task/ChunkVectorSearchTask.d.ts

@@ -1,139 +0,0 @@
-/**
- * @license
- * Copyright 2025 Steven Roussey <sroussey@gmail.com>
- * SPDX-License-Identifier: Apache-2.0
- */
-import { CreateWorkflow, IExecuteContext, Task } from "@workglow/task-graph";
-import type { TaskConfig } from "@workglow/task-graph";
-import { DataPortSchema, FromSchema, TypedArraySchemaOptions } from "@workglow/util/schema";
-declare const inputSchema: {
-    readonly type: "object";
-    readonly properties: {
-        readonly knowledgeBase: {
-            readonly title: "Knowledge Base";
-            readonly description: "Knowledge base ID or instance";
-        } & {
-            title: string;
-            description: string;
-        } & {
-            readonly format: "knowledge-base";
-            readonly anyOf: readonly [{
-                readonly type: "string";
-                readonly title: "Knowledge Base ID";
-            }, {
-                readonly title: "Knowledge Base Instance";
-                readonly additionalProperties: true;
-            }];
-        };
-        readonly query: {
-            readonly type: "array";
-            readonly format: "TypedArray";
-            readonly title: "Typed Array";
-            readonly description: "A typed array (Float32Array, Int8Array, etc.)";
-        };
-        readonly topK: {
-            readonly type: "number";
-            readonly title: "Top K";
-            readonly description: "Number of top results to return";
-            readonly minimum: 1;
-            readonly default: 10;
-        };
-        readonly filter: {
-            readonly type: "object";
-            readonly title: "Metadata Filter";
-            readonly description: "Filter results by metadata fields";
-        };
-        readonly scoreThreshold: {
-            readonly type: "number";
-            readonly title: "Score Threshold";
-            readonly description: "Minimum similarity score threshold (0-1)";
-            readonly minimum: 0;
-            readonly maximum: 1;
-            readonly default: 0;
-        };
-    };
-    readonly required: readonly ["knowledgeBase", "query"];
-    readonly additionalProperties: false;
-};
-declare const outputSchema: {
-    readonly type: "object";
-    readonly properties: {
-        readonly ids: {
-            readonly type: "array";
-            readonly items: {
-                readonly type: "string";
-            };
-            readonly title: "IDs";
-            readonly description: "IDs of matching vectors";
-        };
-        readonly vectors: {
-            readonly type: "array";
-            readonly items: {
-                readonly type: "array";
-                readonly format: "TypedArray";
-                readonly title: "Typed Array";
-                readonly description: "A typed array (Float32Array, Int8Array, etc.)";
-            };
-            readonly title: "Vectors";
-            readonly description: "Matching vector embeddings";
-        };
-        readonly metadata: {
-            readonly type: "array";
-            readonly items: {
-                readonly type: "object";
-                readonly title: "Metadata";
-                readonly description: "Metadata of matching vector";
-            };
-            readonly title: "Metadata";
-            readonly description: "Metadata of matching vectors";
-        };
-        readonly scores: {
-            readonly type: "array";
-            readonly items: {
-                readonly type: "number";
-            };
-            readonly title: "Scores";
-            readonly description: "Similarity scores for each result";
-        };
-        readonly count: {
-            readonly type: "number";
-            readonly title: "Count";
-            readonly description: "Number of results returned";
-        };
-    };
-    readonly required: readonly ["ids", "vectors", "metadata", "scores", "count"];
-    readonly additionalProperties: false;
-};
-export type VectorStoreSearchTaskInput = FromSchema<typeof inputSchema, TypedArraySchemaOptions>;
-export type VectorStoreSearchTaskOutput = FromSchema<typeof outputSchema, TypedArraySchemaOptions>;
-export type ChunkVectorSearchTaskConfig = TaskConfig<VectorStoreSearchTaskInput>;
-/**
- * Task for searching similar vectors in a knowledge base.
- * Returns top-K most similar vectors with their metadata and scores.
- */
-export declare class ChunkVectorSearchTask extends Task<VectorStoreSearchTaskInput, VectorStoreSearchTaskOutput, ChunkVectorSearchTaskConfig> {
-    static type: string;
-    static category: string;
-    static title: string;
-    static description: string;
-    static cacheable: boolean;
-    static inputSchema(): DataPortSchema;
-    static outputSchema(): DataPortSchema;
-    execute(input: VectorStoreSearchTaskInput, _context: IExecuteContext): Promise<VectorStoreSearchTaskOutput>;
-}
-export declare const vectorStoreSearch: (input: VectorStoreSearchTaskInput, config?: ChunkVectorSearchTaskConfig) => Promise<{
-    count: number;
-    ids: string[];
-    metadata: {
-        [x: string]: unknown;
-    }[];
-    scores: number[];
-    vectors: import("@workglow/util/schema").TypedArray[];
-}>;
-declare module "@workglow/task-graph" {
-    interface Workflow {
-        vectorStoreSearch: CreateWorkflow<VectorStoreSearchTaskInput, VectorStoreSearchTaskOutput, ChunkVectorSearchTaskConfig>;
-    }
-}
-export {};
-//# sourceMappingURL=ChunkVectorSearchTask.d.ts.map

package/dist/task/ChunkVectorSearchTask.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ChunkVectorSearchTask.d.ts","sourceRoot":"","sources":["../../src/task/ChunkVectorSearchTask.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,IAAI,EAAY,MAAM,sBAAsB,CAAC;AACvF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EACL,cAAc,EACd,UAAU,EAEV,uBAAuB,EACxB,MAAM,uBAAuB,CAAC;AAE/B,QAAA,MAAM,WAAW;mBACT,QAAQ;;iBAEZ,aAAa;;;;;;;;;;;;;;;;iBAIb,KAAK;;;;;;iBAIL,IAAI;qBACF,IAAI,EAAE,QAAQ;qBACd,KAAK,EAAE,OAAO;qBACd,WAAW,EAAE,iCAAiC;qBAC9C,OAAO,EAAE,CAAC;qBACV,OAAO,EAAE,EAAE;;iBAEb,MAAM;qBACJ,IAAI,EAAE,QAAQ;qBACd,KAAK,EAAE,iBAAiB;qBACxB,WAAW,EAAE,mCAAmC;;iBAElD,cAAc;qBACZ,IAAI,EAAE,QAAQ;qBACd,KAAK,EAAE,iBAAiB;qBACxB,WAAW,EAAE,0CAA0C;qBACvD,OAAO,EAAE,CAAC;qBACV,OAAO,EAAE,CAAC;qBACV,OAAO,EAAE,CAAC;;;;;CAKmB,CAAC;AAEpC,QAAA,MAAM,YAAY;mBACV,QAAQ;;iBAEZ,GAAG;qBACD,IAAI,EAAE,OAAO;qBACb,KAAK;yBAAI,IAAI,EAAE,QAAQ;;qBACvB,KAAK,EAAE,KAAK;qBACZ,WAAW,EAAE,yBAAyB;;iBAExC,OAAO;qBACL,IAAI,EAAE,OAAO;qBACb,KAAK;;;;;;qBAIL,KAAK,EAAE,SAAS;qBAChB,WAAW,EAAE,4BAA4B;;iBAE3C,QAAQ;qBACN,IAAI,EAAE,OAAO;qBACb,KAAK;yBACH,IAAI,EAAE,QAAQ;yBACd,KAAK,EAAE,UAAU;yBACjB,WAAW,EAAE,6BAA6B;;qBAE5C,KAAK,EAAE,UAAU;qBACjB,WAAW,EAAE,8BAA8B;;iBAE7C,MAAM;qBACJ,IAAI,EAAE,OAAO;qBACb,KAAK;yBAAI,IAAI,EAAE,QAAQ;;qBACvB,KAAK,EAAE,QAAQ;qBACf,WAAW,EAAE,mCAAmC;;iBAElD,KAAK;qBACH,IAAI,EAAE,QAAQ;qBACd,KAAK,EAAE,OAAO;qBACd,WAAW,EAAE,4BAA4B;;;;;CAKZ,CAAC;AAEpC,MAAM,MAAM,0BAA0B,GAAG,UAAU,CAAC,OAAO,WAAW,EAAE,uBAAuB,CAAC,CAAC;AACjG,MAAM,MAAM,2BAA2B,GAAG,UAAU,CAAC,OAAO,YAAY,EAAE,uBAAuB,CAAC,CAAC;AACnG,MAAM,MAAM,2BAA2B,GAAG,UAAU,CAAC,0BAA0B,CAAC,CAAC;AAEjF;;;GAGG;AACH,qBAAa,qBAAsB,SAAQ,IAAI,CAC7C,0BAA0B,EAC1B,2BAA2B,EAC3B,2BAA2B,CAC5B;IACC,OAAuB,IAAI,SAA2B;IACtD,OAAuB,QAAQ,SAAkB;IACjD,OAAuB,KAAK,SAAyB;IACrD,OAAuB,WAAW,SAAoD;IACtF,OAAuB,SAAS,UAAQ;IAExC,OAAuB,WAAW,IAAI,cAAc,CAEnD;IAED,OAAuB,YAAY,IAAI,cAAc,CAEpD;IAEc,OAAO,CACpB,KAAK,EAAE,0BAA0B,EACjC,QAAQ,EAAE,eAAe,GACxB,OAAO,CAAC,2BAA2B,CAAC,CAkBtC;CACF;AAED,eAAO,MAAM,iBAAiB,UACrB,0BAA0B,WACxB,2BAA2B;;;;;;;;EAGrC,CAAC;AAEF,OAAO,QAAQ,sBAAsB,CAAC,CAAC;IACrC,UAAU,QAAQ;QAChB,iBAAiB,EAAE,cAAc,CAC/B,0BAA0B,EAC1B,2BAA2B,EAC3B,2BAA2B,CAC5B,CAAC;KACH;CACF"}