orkajs 1.0.0

package/dist/templates/prompt-template.d.ts

@@ -0,0 +1,18 @@
+import { d as PromptTemplateOptions } from '../types-q3EkxHXf.js';
+
+declare class PromptTemplate {
+    private template;
+    private inputVariables;
+    private partialVariables;
+    constructor(options: PromptTemplateOptions);
+    static fromTemplate(template: string, partialVariables?: Record<string, string | (() => string)>): PromptTemplate;
+    format(variables: Record<string, string>): string;
+    partial(variables: Record<string, string | (() => string)>): PromptTemplate;
+    getInputVariables(): string[];
+    getTemplate(): string;
+    private resolvePartials;
+    private validate;
+    static extractVariables(template: string): string[];
+}
+
+export { PromptTemplate };

package/dist/templates/prompt-template.js

@@ -0,0 +1,3 @@
+export { PromptTemplate } from '../chunk-TMWVWAPX.js';
+//# sourceMappingURL=prompt-template.js.map
+//# sourceMappingURL=prompt-template.js.map

package/dist/templates/prompt-template.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"prompt-template.js"}

package/dist/types/index.cjs

@@ -0,0 +1,4 @@
+'use strict';
+
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/types/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}

package/dist/types/index.d.cts

@@ -0,0 +1,149 @@
+interface LLMAdapter {
+    generate(prompt: string, options?: LLMGenerateOptions): Promise<LLMResult>;
+    embed(text: string | string[]): Promise<number[][]>;
+    readonly name: string;
+}
+interface LLMGenerateOptions {
+    temperature?: number;
+    maxTokens?: number;
+    stopSequences?: string[];
+    systemPrompt?: string;
+    messages?: ChatMessage[];
+}
+interface ChatMessage {
+    role: 'system' | 'user' | 'assistant';
+    content: string | ContentPart[];
+}
+type ContentPart = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'image_url';
+    image_url: {
+        url: string;
+        detail?: 'auto' | 'low' | 'high';
+    };
+} | {
+    type: 'image_base64';
+    data: string;
+    mimeType: 'image/png' | 'image/jpeg' | 'image/gif' | 'image/webp';
+} | {
+    type: 'audio';
+    data: string;
+    format: 'wav' | 'mp3';
+};
+interface LLMResult {
+    content: string;
+    usage: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+    model: string;
+    finishReason: 'stop' | 'length' | 'tool_calls' | 'error';
+}
+interface VectorDBAdapter {
+    upsert(collection: string, vectors: VectorRecord[]): Promise<void>;
+    search(collection: string, vector: number[], options?: VectorSearchOptions): Promise<VectorSearchResult[]>;
+    delete(collection: string, ids: string[]): Promise<void>;
+    createCollection(name: string, options?: CreateCollectionOptions): Promise<void>;
+    deleteCollection(name: string): Promise<void>;
+    readonly name: string;
+}
+interface VectorRecord {
+    id: string;
+    vector: number[];
+    metadata?: Record<string, unknown>;
+    content?: string;
+}
+interface VectorSearchOptions {
+    topK?: number;
+    filter?: Record<string, unknown>;
+    minScore?: number;
+}
+interface VectorSearchResult {
+    id: string;
+    score: number;
+    metadata?: Record<string, unknown>;
+    content?: string;
+}
+interface CreateCollectionOptions {
+    dimension?: number;
+    metric?: 'cosine' | 'euclidean' | 'dotProduct';
+}
+interface DatabaseAdapter {
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    query<T = unknown>(sql: string, params?: unknown[]): Promise<T[]>;
+    execute(sql: string, params?: unknown[]): Promise<{
+        affectedRows: number;
+    }>;
+    readonly name: string;
+}
+interface OrkaConfig {
+    llm: LLMAdapter;
+    vectorDB?: VectorDBAdapter;
+    database?: DatabaseAdapter;
+    defaults?: OrkaDefaults;
+}
+interface OrkaDefaults {
+    chunkSize?: number;
+    chunkOverlap?: number;
+    topK?: number;
+    temperature?: number;
+    maxTokens?: number;
+}
+interface KnowledgeCreateOptions {
+    name: string;
+    source: KnowledgeSource;
+    chunkSize?: number;
+    chunkOverlap?: number;
+    metadata?: Record<string, unknown>;
+}
+type KnowledgeSource = string | string[] | {
+    text: string;
+    metadata?: Record<string, unknown>;
+}[] | {
+    path: string;
+} | {
+    url: string;
+};
+interface AskOptions {
+    knowledge?: string;
+    question: string;
+    systemPrompt?: string;
+    topK?: number;
+    temperature?: number;
+    maxTokens?: number;
+    includeContext?: boolean;
+}
+interface AskResult {
+    answer: string;
+    context?: RetrievedContext[];
+    usage: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+        estimatedCost?: number;
+    };
+    latencyMs: number;
+}
+interface RetrievedContext {
+    content: string;
+    score: number;
+    metadata?: Record<string, unknown>;
+}
+interface Document {
+    id: string;
+    content: string;
+    metadata?: Record<string, unknown>;
+}
+interface Chunk {
+    id: string;
+    content: string;
+    documentId: string;
+    index: number;
+    metadata?: Record<string, unknown>;
+}
+
+export type { AskOptions, AskResult, ChatMessage, Chunk, ContentPart, CreateCollectionOptions, DatabaseAdapter, Document, KnowledgeCreateOptions, KnowledgeSource, LLMAdapter, LLMGenerateOptions, LLMResult, OrkaConfig, OrkaDefaults, RetrievedContext, VectorDBAdapter, VectorRecord, VectorSearchOptions, VectorSearchResult };

package/dist/types/index.d.ts

@@ -0,0 +1,149 @@
+interface LLMAdapter {
+    generate(prompt: string, options?: LLMGenerateOptions): Promise<LLMResult>;
+    embed(text: string | string[]): Promise<number[][]>;
+    readonly name: string;
+}
+interface LLMGenerateOptions {
+    temperature?: number;
+    maxTokens?: number;
+    stopSequences?: string[];
+    systemPrompt?: string;
+    messages?: ChatMessage[];
+}
+interface ChatMessage {
+    role: 'system' | 'user' | 'assistant';
+    content: string | ContentPart[];
+}
+type ContentPart = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'image_url';
+    image_url: {
+        url: string;
+        detail?: 'auto' | 'low' | 'high';
+    };
+} | {
+    type: 'image_base64';
+    data: string;
+    mimeType: 'image/png' | 'image/jpeg' | 'image/gif' | 'image/webp';
+} | {
+    type: 'audio';
+    data: string;
+    format: 'wav' | 'mp3';
+};
+interface LLMResult {
+    content: string;
+    usage: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+    model: string;
+    finishReason: 'stop' | 'length' | 'tool_calls' | 'error';
+}
+interface VectorDBAdapter {
+    upsert(collection: string, vectors: VectorRecord[]): Promise<void>;
+    search(collection: string, vector: number[], options?: VectorSearchOptions): Promise<VectorSearchResult[]>;
+    delete(collection: string, ids: string[]): Promise<void>;
+    createCollection(name: string, options?: CreateCollectionOptions): Promise<void>;
+    deleteCollection(name: string): Promise<void>;
+    readonly name: string;
+}
+interface VectorRecord {
+    id: string;
+    vector: number[];
+    metadata?: Record<string, unknown>;
+    content?: string;
+}
+interface VectorSearchOptions {
+    topK?: number;
+    filter?: Record<string, unknown>;
+    minScore?: number;
+}
+interface VectorSearchResult {
+    id: string;
+    score: number;
+    metadata?: Record<string, unknown>;
+    content?: string;
+}
+interface CreateCollectionOptions {
+    dimension?: number;
+    metric?: 'cosine' | 'euclidean' | 'dotProduct';
+}
+interface DatabaseAdapter {
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    query<T = unknown>(sql: string, params?: unknown[]): Promise<T[]>;
+    execute(sql: string, params?: unknown[]): Promise<{
+        affectedRows: number;
+    }>;
+    readonly name: string;
+}
+interface OrkaConfig {
+    llm: LLMAdapter;
+    vectorDB?: VectorDBAdapter;
+    database?: DatabaseAdapter;
+    defaults?: OrkaDefaults;
+}
+interface OrkaDefaults {
+    chunkSize?: number;
+    chunkOverlap?: number;
+    topK?: number;
+    temperature?: number;
+    maxTokens?: number;
+}
+interface KnowledgeCreateOptions {
+    name: string;
+    source: KnowledgeSource;
+    chunkSize?: number;
+    chunkOverlap?: number;
+    metadata?: Record<string, unknown>;
+}
+type KnowledgeSource = string | string[] | {
+    text: string;
+    metadata?: Record<string, unknown>;
+}[] | {
+    path: string;
+} | {
+    url: string;
+};
+interface AskOptions {
+    knowledge?: string;
+    question: string;
+    systemPrompt?: string;
+    topK?: number;
+    temperature?: number;
+    maxTokens?: number;
+    includeContext?: boolean;
+}
+interface AskResult {
+    answer: string;
+    context?: RetrievedContext[];
+    usage: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+        estimatedCost?: number;
+    };
+    latencyMs: number;
+}
+interface RetrievedContext {
+    content: string;
+    score: number;
+    metadata?: Record<string, unknown>;
+}
+interface Document {
+    id: string;
+    content: string;
+    metadata?: Record<string, unknown>;
+}
+interface Chunk {
+    id: string;
+    content: string;
+    documentId: string;
+    index: number;
+    metadata?: Record<string, unknown>;
+}
+
+export type { AskOptions, AskResult, ChatMessage, Chunk, ContentPart, CreateCollectionOptions, DatabaseAdapter, Document, KnowledgeCreateOptions, KnowledgeSource, LLMAdapter, LLMGenerateOptions, LLMResult, OrkaConfig, OrkaDefaults, RetrievedContext, VectorDBAdapter, VectorRecord, VectorSearchOptions, VectorSearchResult };

package/dist/types/index.js

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/types-0sTm-82H.d.cts

@@ -0,0 +1,34 @@
+interface PromptTemplate {
+    id: string;
+    version: number;
+    name: string;
+    template: string;
+    variables: string[];
+    metadata?: Record<string, unknown>;
+    createdAt: number;
+    isActive: boolean;
+}
+interface PromptRenderOptions {
+    variables: Record<string, string>;
+    version?: number;
+}
+interface PromptDiff {
+    fromVersion: number;
+    toVersion: number;
+    changes: PromptChange[];
+}
+interface PromptChange {
+    type: 'added' | 'removed' | 'modified';
+    field: string;
+    oldValue?: string;
+    newValue?: string;
+}
+interface PromptRegistryConfig {
+    persistence?: PromptPersistence;
+}
+interface PromptPersistence {
+    save(prompts: Map<string, PromptTemplate[]>): Promise<void>;
+    load(): Promise<Map<string, PromptTemplate[]>>;
+}
+
+export type { PromptChange as P, PromptDiff as a, PromptPersistence as b, PromptRegistryConfig as c, PromptRenderOptions as d, PromptTemplate as e };

package/dist/types-0sTm-82H.d.ts

@@ -0,0 +1,34 @@
+interface PromptTemplate {
+    id: string;
+    version: number;
+    name: string;
+    template: string;
+    variables: string[];
+    metadata?: Record<string, unknown>;
+    createdAt: number;
+    isActive: boolean;
+}
+interface PromptRenderOptions {
+    variables: Record<string, string>;
+    version?: number;
+}
+interface PromptDiff {
+    fromVersion: number;
+    toVersion: number;
+    changes: PromptChange[];
+}
+interface PromptChange {
+    type: 'added' | 'removed' | 'modified';
+    field: string;
+    oldValue?: string;
+    newValue?: string;
+}
+interface PromptRegistryConfig {
+    persistence?: PromptPersistence;
+}
+interface PromptPersistence {
+    save(prompts: Map<string, PromptTemplate[]>): Promise<void>;
+    load(): Promise<Map<string, PromptTemplate[]>>;
+}
+
+export type { PromptChange as P, PromptDiff as a, PromptPersistence as b, PromptRegistryConfig as c, PromptRenderOptions as d, PromptTemplate as e };

package/dist/types-8NBD4dQH.d.cts

@@ -0,0 +1,62 @@
+interface OutputParser<T = unknown> {
+    parse(text: string): T;
+    getFormatInstructions(): string;
+}
+interface JSONParserOptions {
+    strict?: boolean;
+}
+interface StructuredOutputParserOptions<T> {
+    schema: ZodLikeSchema<T>;
+    strict?: boolean;
+}
+interface ZodLikeSchema<T = unknown> {
+    parse(data: unknown): T;
+    safeParse(data: unknown): {
+        success: boolean;
+        data?: T;
+        error?: {
+            message: string;
+            issues?: Array<{
+                path: (string | number)[];
+                message: string;
+            }>;
+        };
+    };
+    shape?: Record<string, unknown>;
+    description?: string;
+}
+interface ListParserOptions {
+    separator?: string;
+    trim?: boolean;
+}
+interface RegexParserOptions {
+    regex: RegExp;
+    outputKeys: string[];
+}
+interface AutoFixParserOptions<T> {
+    parser: OutputParser<T>;
+    maxRetries?: number;
+    llm?: {
+        generate(prompt: string, options?: {
+            temperature?: number;
+            maxTokens?: number;
+        }): Promise<{
+            content: string;
+        }>;
+    };
+}
+interface XMLParserOptions {
+    tags?: string[];
+    strict?: boolean;
+}
+interface CSVParserOptions {
+    separator?: string;
+    headers?: string[];
+    strict?: boolean;
+}
+interface CommaSeparatedListParserOptions {
+    trim?: boolean;
+    removeDuplicates?: boolean;
+}
+
+export type { AutoFixParserOptions as A, CSVParserOptions as C, JSONParserOptions as J, ListParserOptions as L, OutputParser as O, RegexParserOptions as R, StructuredOutputParserOptions as S, XMLParserOptions as X, ZodLikeSchema as Z, CommaSeparatedListParserOptions as a };

package/dist/types-8NBD4dQH.d.ts

@@ -0,0 +1,62 @@
+interface OutputParser<T = unknown> {
+    parse(text: string): T;
+    getFormatInstructions(): string;
+}
+interface JSONParserOptions {
+    strict?: boolean;
+}
+interface StructuredOutputParserOptions<T> {
+    schema: ZodLikeSchema<T>;
+    strict?: boolean;
+}
+interface ZodLikeSchema<T = unknown> {
+    parse(data: unknown): T;
+    safeParse(data: unknown): {
+        success: boolean;
+        data?: T;
+        error?: {
+            message: string;
+            issues?: Array<{
+                path: (string | number)[];
+                message: string;
+            }>;
+        };
+    };
+    shape?: Record<string, unknown>;
+    description?: string;
+}
+interface ListParserOptions {
+    separator?: string;
+    trim?: boolean;
+}
+interface RegexParserOptions {
+    regex: RegExp;
+    outputKeys: string[];
+}
+interface AutoFixParserOptions<T> {
+    parser: OutputParser<T>;
+    maxRetries?: number;
+    llm?: {
+        generate(prompt: string, options?: {
+            temperature?: number;
+            maxTokens?: number;
+        }): Promise<{
+            content: string;
+        }>;
+    };
+}
+interface XMLParserOptions {
+    tags?: string[];
+    strict?: boolean;
+}
+interface CSVParserOptions {
+    separator?: string;
+    headers?: string[];
+    strict?: boolean;
+}
+interface CommaSeparatedListParserOptions {
+    trim?: boolean;
+    removeDuplicates?: boolean;
+}
+
+export type { AutoFixParserOptions as A, CSVParserOptions as C, JSONParserOptions as J, ListParserOptions as L, OutputParser as O, RegexParserOptions as R, StructuredOutputParserOptions as S, XMLParserOptions as X, ZodLikeSchema as Z, CommaSeparatedListParserOptions as a };

package/dist/types-B4UAH86O.d.cts

@@ -0,0 +1,52 @@
+import { RetrievedContext, LLMAdapter, VectorDBAdapter } from './types/index.cjs';
+import { Knowledge } from './core/knowledge.cjs';
+
+interface GraphContext {
+    input: string;
+    output: string;
+    nodeOutputs: Record<string, string>;
+    context: RetrievedContext[];
+    metadata: Record<string, unknown>;
+    llm: LLMAdapter;
+    vectorDB?: VectorDBAdapter;
+    knowledge?: Knowledge;
+}
+interface GraphNode {
+    id: string;
+    type: 'action' | 'condition' | 'parallel' | 'start' | 'end';
+    execute?: (ctx: GraphContext) => Promise<GraphContext>;
+    condition?: (ctx: GraphContext) => string;
+    parallelNodes?: string[];
+    metadata?: Record<string, unknown>;
+}
+interface GraphEdge {
+    from: string;
+    to: string;
+    label?: string;
+}
+interface GraphConfig {
+    name: string;
+    nodes: GraphNode[];
+    edges: GraphEdge[];
+    maxIterations?: number;
+    onNodeComplete?: (nodeId: string, ctx: GraphContext) => void;
+    onError?: (error: Error, nodeId: string) => void;
+}
+interface GraphNodeResult {
+    nodeId: string;
+    type: GraphNode['type'];
+    output: string;
+    latencyMs: number;
+    metadata?: Record<string, unknown>;
+}
+interface GraphResult {
+    name: string;
+    input: string;
+    output: string;
+    nodeResults: GraphNodeResult[];
+    path: string[];
+    totalLatencyMs: number;
+    metadata: Record<string, unknown>;
+}
+
+export type { GraphConfig as G, GraphContext as a, GraphEdge as b, GraphNode as c, GraphNodeResult as d, GraphResult as e };

package/dist/types-BAR-Rjlg.d.cts

@@ -0,0 +1,39 @@
+import { LLMAdapter, LLMResult, LLMGenerateOptions } from './types/index.cjs';
+
+interface RouterConfig {
+    routes: Route[];
+    defaultAdapter: LLMAdapter;
+}
+interface Route {
+    condition: (prompt: string, options?: LLMGenerateOptions) => boolean;
+    adapter: LLMAdapter;
+    name?: string;
+}
+interface ConsensusConfig {
+    adapters: LLMAdapter[];
+    strategy: 'majority' | 'best_score' | 'merge';
+    judge?: LLMAdapter;
+    temperature?: number;
+}
+interface ConsensusResult extends LLMResult {
+    responses: Array<{
+        adapter: string;
+        content: string;
+        score?: number;
+    }>;
+    selectedAdapter: string;
+}
+interface RaceConfig {
+    adapters: LLMAdapter[];
+    timeout?: number;
+}
+interface RaceResult extends LLMResult {
+    winnerAdapter: string;
+    latencyMs: number;
+}
+interface LoadBalancerConfig {
+    adapters: LLMAdapter[];
+    strategy: 'round_robin' | 'random' | 'least_tokens';
+}
+
+export type { ConsensusConfig as C, LoadBalancerConfig as L, RaceConfig as R, ConsensusResult as a, RaceResult as b, Route as c, RouterConfig as d };

package/dist/types-BLcg9dP2.d.ts

@@ -0,0 +1,47 @@
+import { VectorSearchResult, LLMAdapter, VectorDBAdapter } from './types/index.js';
+
+interface Retriever {
+    retrieve(query: string, collection: string): Promise<VectorSearchResult[]>;
+}
+interface MultiQueryRetrieverOptions {
+    llm: LLMAdapter;
+    vectorDB: VectorDBAdapter;
+    queryCount?: number;
+    topK?: number;
+    minScore?: number;
+    deduplicateByContent?: boolean;
+}
+interface ContextualCompressionRetrieverOptions {
+    llm: LLMAdapter;
+    vectorDB: VectorDBAdapter;
+    topK?: number;
+    minScore?: number;
+    maxCompressedLength?: number;
+}
+interface EnsembleRetrieverOptions {
+    retrievers: Retriever[];
+    weights?: number[];
+    topK?: number;
+}
+interface ParentDocumentRetrieverOptions {
+    vectorDB: VectorDBAdapter;
+    llm: LLMAdapter;
+    childTopK?: number;
+    parentTopK?: number;
+    minScore?: number;
+}
+interface SelfQueryRetrieverOptions {
+    llm: LLMAdapter;
+    vectorDB: VectorDBAdapter;
+    metadataFields: MetadataFieldInfo[];
+    topK?: number;
+    minScore?: number;
+}
+interface MetadataFieldInfo {
+    name: string;
+    type: 'string' | 'number' | 'boolean' | 'date';
+    description: string;
+    enumValues?: string[];
+}
+
+export type { ContextualCompressionRetrieverOptions as C, EnsembleRetrieverOptions as E, MetadataFieldInfo as M, ParentDocumentRetrieverOptions as P, Retriever as R, SelfQueryRetrieverOptions as S, MultiQueryRetrieverOptions as a };