orkajs 1.0.0

package/dist/graph/graph-workflow.d.ts

@@ -0,0 +1,29 @@
+import { LLMAdapter, VectorDBAdapter } from '../types/index.js';
+import { Knowledge } from '../core/knowledge.js';
+import { G as GraphConfig, e as GraphResult, c as GraphNode } from '../types-DsOo4p3H.js';
+
+declare class GraphWorkflow {
+    private config;
+    private nodes;
+    private adjacency;
+    private llm;
+    private vectorDB?;
+    private knowledge?;
+    constructor(config: GraphConfig, llm: LLMAdapter, vectorDB?: VectorDBAdapter, knowledge?: Knowledge);
+    run(input: string | {
+        input: string;
+        metadata?: Record<string, unknown>;
+    }): Promise<GraphResult>;
+    private executeParallel;
+    private findStartNode;
+    private validate;
+    getNodes(): GraphNode[];
+    getEdges(): Array<{
+        from: string;
+        to: string;
+        label?: string;
+    }>;
+    toMermaid(): string;
+}
+
+export { GraphWorkflow };

package/dist/graph/graph-workflow.js

@@ -0,0 +1,3 @@
+export { GraphWorkflow } from '../chunk-DI2UCZBJ.js';
+//# sourceMappingURL=graph-workflow.js.map
+//# sourceMappingURL=graph-workflow.js.map

package/dist/graph/graph-workflow.js.map

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

package/dist/graph/helpers.cjs

@@ -0,0 +1,40 @@
+'use strict';
+
+var chunkXPMSMFRX_cjs = require('../chunk-XPMSMFRX.cjs');
+
+
+
+Object.defineProperty(exports, "actionNode", {
+  enumerable: true,
+  get: function () { return chunkXPMSMFRX_cjs.actionNode; }
+});
+Object.defineProperty(exports, "conditionNode", {
+  enumerable: true,
+  get: function () { return chunkXPMSMFRX_cjs.conditionNode; }
+});
+Object.defineProperty(exports, "edge", {
+  enumerable: true,
+  get: function () { return chunkXPMSMFRX_cjs.edge; }
+});
+Object.defineProperty(exports, "endNode", {
+  enumerable: true,
+  get: function () { return chunkXPMSMFRX_cjs.endNode; }
+});
+Object.defineProperty(exports, "llmNode", {
+  enumerable: true,
+  get: function () { return chunkXPMSMFRX_cjs.llmNode; }
+});
+Object.defineProperty(exports, "parallelNode", {
+  enumerable: true,
+  get: function () { return chunkXPMSMFRX_cjs.parallelNode; }
+});
+Object.defineProperty(exports, "retrieveNode", {
+  enumerable: true,
+  get: function () { return chunkXPMSMFRX_cjs.retrieveNode; }
+});
+Object.defineProperty(exports, "startNode", {
+  enumerable: true,
+  get: function () { return chunkXPMSMFRX_cjs.startNode; }
+});
+//# sourceMappingURL=helpers.cjs.map
+//# sourceMappingURL=helpers.cjs.map

package/dist/graph/helpers.cjs.map

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

package/dist/graph/helpers.d.cts

@@ -0,0 +1,26 @@
+import { a as GraphContext, c as GraphNode } from '../types-B4UAH86O.cjs';
+import '../types/index.cjs';
+import '../core/knowledge.cjs';
+
+declare function actionNode(id: string, fn: (ctx: GraphContext) => Promise<GraphContext>): GraphNode;
+declare function conditionNode(id: string, fn: (ctx: GraphContext) => string): GraphNode;
+declare function parallelNode(id: string, nodeIds: string[]): GraphNode;
+declare function startNode(id?: string): GraphNode;
+declare function endNode(id?: string): GraphNode;
+declare function llmNode(id: string, options?: {
+    systemPrompt?: string;
+    temperature?: number;
+    maxTokens?: number;
+    promptTemplate?: string;
+}): GraphNode;
+declare function retrieveNode(id: string, knowledgeName: string, options?: {
+    topK?: number;
+    minScore?: number;
+}): GraphNode;
+declare function edge(from: string, to: string, label?: string): {
+    from: string;
+    to: string;
+    label: string | undefined;
+};
+
+export { actionNode, conditionNode, edge, endNode, llmNode, parallelNode, retrieveNode, startNode };

package/dist/graph/helpers.d.ts

@@ -0,0 +1,26 @@
+import { a as GraphContext, c as GraphNode } from '../types-DsOo4p3H.js';
+import '../types/index.js';
+import '../core/knowledge.js';
+
+declare function actionNode(id: string, fn: (ctx: GraphContext) => Promise<GraphContext>): GraphNode;
+declare function conditionNode(id: string, fn: (ctx: GraphContext) => string): GraphNode;
+declare function parallelNode(id: string, nodeIds: string[]): GraphNode;
+declare function startNode(id?: string): GraphNode;
+declare function endNode(id?: string): GraphNode;
+declare function llmNode(id: string, options?: {
+    systemPrompt?: string;
+    temperature?: number;
+    maxTokens?: number;
+    promptTemplate?: string;
+}): GraphNode;
+declare function retrieveNode(id: string, knowledgeName: string, options?: {
+    topK?: number;
+    minScore?: number;
+}): GraphNode;
+declare function edge(from: string, to: string, label?: string): {
+    from: string;
+    to: string;
+    label: string | undefined;
+};
+
+export { actionNode, conditionNode, edge, endNode, llmNode, parallelNode, retrieveNode, startNode };

package/dist/graph/helpers.js

@@ -0,0 +1,3 @@
+export { actionNode, conditionNode, edge, endNode, llmNode, parallelNode, retrieveNode, startNode } from '../chunk-4EBSDFBS.js';
+//# sourceMappingURL=helpers.js.map
+//# sourceMappingURL=helpers.js.map

package/dist/graph/helpers.js.map

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

package/dist/graph/index.cjs

@@ -0,0 +1,45 @@
+'use strict';
+
+var chunkXPMSMFRX_cjs = require('../chunk-XPMSMFRX.cjs');
+var chunkXAKPLGNG_cjs = require('../chunk-XAKPLGNG.cjs');
+
+
+
+Object.defineProperty(exports, "actionNode", {
+  enumerable: true,
+  get: function () { return chunkXPMSMFRX_cjs.actionNode; }
+});
+Object.defineProperty(exports, "conditionNode", {
+  enumerable: true,
+  get: function () { return chunkXPMSMFRX_cjs.conditionNode; }
+});
+Object.defineProperty(exports, "edge", {
+  enumerable: true,
+  get: function () { return chunkXPMSMFRX_cjs.edge; }
+});
+Object.defineProperty(exports, "endNode", {
+  enumerable: true,
+  get: function () { return chunkXPMSMFRX_cjs.endNode; }
+});
+Object.defineProperty(exports, "llmNode", {
+  enumerable: true,
+  get: function () { return chunkXPMSMFRX_cjs.llmNode; }
+});
+Object.defineProperty(exports, "parallelNode", {
+  enumerable: true,
+  get: function () { return chunkXPMSMFRX_cjs.parallelNode; }
+});
+Object.defineProperty(exports, "retrieveNode", {
+  enumerable: true,
+  get: function () { return chunkXPMSMFRX_cjs.retrieveNode; }
+});
+Object.defineProperty(exports, "startNode", {
+  enumerable: true,
+  get: function () { return chunkXPMSMFRX_cjs.startNode; }
+});
+Object.defineProperty(exports, "GraphWorkflow", {
+  enumerable: true,
+  get: function () { return chunkXAKPLGNG_cjs.GraphWorkflow; }
+});
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/graph/index.cjs.map

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

package/dist/graph/index.d.cts

@@ -0,0 +1,5 @@
+export { GraphWorkflow } from './graph-workflow.cjs';
+export { actionNode, conditionNode, edge, endNode, llmNode, parallelNode, retrieveNode, startNode } from './helpers.cjs';
+export { G as GraphConfig, a as GraphContext, b as GraphEdge, c as GraphNode, d as GraphNodeResult, e as GraphResult } from '../types-B4UAH86O.cjs';
+import '../types/index.cjs';
+import '../core/knowledge.cjs';

package/dist/graph/index.d.ts

@@ -0,0 +1,5 @@
+export { GraphWorkflow } from './graph-workflow.js';
+export { actionNode, conditionNode, edge, endNode, llmNode, parallelNode, retrieveNode, startNode } from './helpers.js';
+export { G as GraphConfig, a as GraphContext, b as GraphEdge, c as GraphNode, d as GraphNodeResult, e as GraphResult } from '../types-DsOo4p3H.js';
+import '../types/index.js';
+import '../core/knowledge.js';

package/dist/graph/index.js

@@ -0,0 +1,4 @@
+export { actionNode, conditionNode, edge, endNode, llmNode, parallelNode, retrieveNode, startNode } from '../chunk-4EBSDFBS.js';
+export { GraphWorkflow } from '../chunk-DI2UCZBJ.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/graph/index.js.map

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

package/dist/index-8bLog_oR.d.ts

@@ -0,0 +1,167 @@
+import { LLMAdapter, OrkaConfig, AskOptions, AskResult, DatabaseAdapter } from './types/index.js';
+import { Knowledge } from './core/knowledge.js';
+import { Workflow } from './workflow/workflow.js';
+import { W as WorkflowConfig } from './types-DxUxY78w.js';
+import { EvalCase, MetricFn, EvalResult, EvalSummary } from './evaluation/metrics.js';
+import { A as Agent } from './agent-w0NX6-Li.js';
+import { A as AgentConfig } from './types-q1PSyGEh.js';
+import { MemoryConfig, Memory } from './memory/memory.js';
+import { SessionMemory } from './memory/session-memory.js';
+import { Tracer, LogLevel, ObservabilityHook } from './observability/index.js';
+import { GraphWorkflow } from './graph/graph-workflow.js';
+import { G as GraphConfig } from './types-DsOo4p3H.js';
+import { PromptRegistry } from './prompts/registry.js';
+import { c as PromptRegistryConfig } from './types-0sTm-82H.js';
+import { Assertion } from './evaluation/assertions.js';
+import { Reporter, TestSuiteReport } from './evaluation/reporters.js';
+
+interface EvaluateOptions {
+    dataset: EvalCase[];
+    metrics?: (string | MetricFn)[];
+    concurrency?: number;
+    onResult?: (result: EvalResult, index: number) => void;
+}
+declare class Evaluator {
+    private orka;
+    private llm;
+    constructor(orka: Orka, llm: LLMAdapter);
+    evaluate(options: EvaluateOptions): Promise<EvalSummary>;
+    private resolveMetrics;
+    private buildSummary;
+    private chunk;
+}
+
+interface TestSuiteConfig {
+    name: string;
+    dataset: EvalCase[];
+    metrics?: (string | MetricFn)[];
+    assertions?: Assertion[];
+    reporters?: Reporter[];
+    concurrency?: number;
+    bail?: boolean;
+}
+declare class TestRunner {
+    private orka;
+    constructor(orka: Orka);
+    run(config: TestSuiteConfig): Promise<TestSuiteReport>;
+    private runCase;
+    private buildReport;
+    private resolveMetrics;
+    private chunk;
+}
+
+interface OrkaFullConfig extends OrkaConfig {
+    observability?: {
+        logLevel?: LogLevel;
+        hooks?: ObservabilityHook[];
+    };
+    memory?: MemoryConfig;
+    prompts?: PromptRegistryConfig;
+}
+declare class Orka {
+    private llm;
+    private vectorDB?;
+    private database?;
+    private defaults;
+    readonly knowledge: Knowledge;
+    readonly tracer: Tracer;
+    readonly prompts: PromptRegistry;
+    private _memory?;
+    private _sessionMemory?;
+    constructor(config: OrkaFullConfig);
+    /**
+     * Ask a question using the knowledge base
+     * @param options - Ask options
+     * @returns Ask result
+     */
+    ask(options: AskOptions): Promise<AskResult>;
+    /**
+     * Generate a response using the LLM
+     * @param prompt - The prompt to generate a response for
+     * @param options - Generation options
+     * @returns Generated response
+     */
+    generate(prompt: string, options?: {
+        temperature?: number;
+        maxTokens?: number;
+        systemPrompt?: string;
+    }): Promise<string>;
+    /**
+     * Embed text using the LLM
+     * @param text - The text to embed
+     * @returns Embeddings
+     */
+    embed(text: string | string[]): Promise<number[][]>;
+    /**
+     * Create a new workflow
+     * @param config - Workflow configuration
+     * @returns Workflow instance
+     */
+    workflow(config: WorkflowConfig): Workflow;
+    /**
+     * Create a new agent
+     * @param config - Agent configuration
+     * @returns Agent instance
+     */
+    agent(config: AgentConfig): Agent;
+    /**
+     * Evaluate a workflow or agent
+     * @param options - Evaluation options
+     * @returns Evaluation summary
+     */
+    evaluate(options: EvaluateOptions): Promise<EvalSummary>;
+    /**
+     * Get or create memory instance
+     * @returns Memory instance
+     */
+    memory(): Memory;
+    /**
+     * Get or create session memory instance
+     * @returns SessionMemory instance
+     */
+    sessions(): SessionMemory;
+    /**
+     * Get database adapter
+     * @returns Database adapter or undefined
+     */
+    getDatabase(): DatabaseAdapter | undefined;
+    /**
+     * Create a new graph workflow
+     * @param config - Graph configuration
+     * @returns GraphWorkflow instance
+     */
+    graph(config: GraphConfig): GraphWorkflow;
+    /**
+     * Run a test suite
+     * @param config - Test suite configuration
+     * @returns Test suite report
+     */
+    test(config: TestSuiteConfig): Promise<TestSuiteReport>;
+    /**
+     * Get the LLM adapter
+     * @returns LLM adapter
+     */
+    getLLM(): LLMAdapter;
+    /**
+     * Build a prompt from question and context
+     * @param question - The question to answer
+     * @param context - The context to use
+     * @param _systemPrompt - The system prompt to use (unused)
+     * @returns The built prompt
+     */
+    private buildPrompt;
+    /**
+     * Get the default system prompt
+     * @param hasContext - Whether context is available
+     * @returns The default system prompt
+     */
+    private getDefaultSystemPrompt;
+}
+/**
+ * Create a new Orka instance
+ * @param config - Orka configuration
+ * @returns Orka instance
+ */
+declare function createOrka(config: OrkaFullConfig): Orka;
+
+export { type EvaluateOptions as E, Orka as O, TestRunner as T, Evaluator as a, type OrkaFullConfig as b, type TestSuiteConfig as c, createOrka as d };

package/dist/index-HyHJwtzW.d.cts

@@ -0,0 +1,167 @@
+import { LLMAdapter, OrkaConfig, AskOptions, AskResult, DatabaseAdapter } from './types/index.cjs';
+import { Knowledge } from './core/knowledge.cjs';
+import { Workflow } from './workflow/workflow.cjs';
+import { W as WorkflowConfig } from './types-D_0MABWj.cjs';
+import { EvalCase, MetricFn, EvalResult, EvalSummary } from './evaluation/metrics.cjs';
+import { A as Agent } from './agent-CEhm_T9r.cjs';
+import { A as AgentConfig } from './types-ZpM642VC.cjs';
+import { MemoryConfig, Memory } from './memory/memory.cjs';
+import { SessionMemory } from './memory/session-memory.cjs';
+import { Tracer, LogLevel, ObservabilityHook } from './observability/index.cjs';
+import { GraphWorkflow } from './graph/graph-workflow.cjs';
+import { G as GraphConfig } from './types-B4UAH86O.cjs';
+import { PromptRegistry } from './prompts/registry.cjs';
+import { c as PromptRegistryConfig } from './types-0sTm-82H.cjs';
+import { Assertion } from './evaluation/assertions.cjs';
+import { Reporter, TestSuiteReport } from './evaluation/reporters.cjs';
+
+interface EvaluateOptions {
+    dataset: EvalCase[];
+    metrics?: (string | MetricFn)[];
+    concurrency?: number;
+    onResult?: (result: EvalResult, index: number) => void;
+}
+declare class Evaluator {
+    private orka;
+    private llm;
+    constructor(orka: Orka, llm: LLMAdapter);
+    evaluate(options: EvaluateOptions): Promise<EvalSummary>;
+    private resolveMetrics;
+    private buildSummary;
+    private chunk;
+}
+
+interface TestSuiteConfig {
+    name: string;
+    dataset: EvalCase[];
+    metrics?: (string | MetricFn)[];
+    assertions?: Assertion[];
+    reporters?: Reporter[];
+    concurrency?: number;
+    bail?: boolean;
+}
+declare class TestRunner {
+    private orka;
+    constructor(orka: Orka);
+    run(config: TestSuiteConfig): Promise<TestSuiteReport>;
+    private runCase;
+    private buildReport;
+    private resolveMetrics;
+    private chunk;
+}
+
+interface OrkaFullConfig extends OrkaConfig {
+    observability?: {
+        logLevel?: LogLevel;
+        hooks?: ObservabilityHook[];
+    };
+    memory?: MemoryConfig;
+    prompts?: PromptRegistryConfig;
+}
+declare class Orka {
+    private llm;
+    private vectorDB?;
+    private database?;
+    private defaults;
+    readonly knowledge: Knowledge;
+    readonly tracer: Tracer;
+    readonly prompts: PromptRegistry;
+    private _memory?;
+    private _sessionMemory?;
+    constructor(config: OrkaFullConfig);
+    /**
+     * Ask a question using the knowledge base
+     * @param options - Ask options
+     * @returns Ask result
+     */
+    ask(options: AskOptions): Promise<AskResult>;
+    /**
+     * Generate a response using the LLM
+     * @param prompt - The prompt to generate a response for
+     * @param options - Generation options
+     * @returns Generated response
+     */
+    generate(prompt: string, options?: {
+        temperature?: number;
+        maxTokens?: number;
+        systemPrompt?: string;
+    }): Promise<string>;
+    /**
+     * Embed text using the LLM
+     * @param text - The text to embed
+     * @returns Embeddings
+     */
+    embed(text: string | string[]): Promise<number[][]>;
+    /**
+     * Create a new workflow
+     * @param config - Workflow configuration
+     * @returns Workflow instance
+     */
+    workflow(config: WorkflowConfig): Workflow;
+    /**
+     * Create a new agent
+     * @param config - Agent configuration
+     * @returns Agent instance
+     */
+    agent(config: AgentConfig): Agent;
+    /**
+     * Evaluate a workflow or agent
+     * @param options - Evaluation options
+     * @returns Evaluation summary
+     */
+    evaluate(options: EvaluateOptions): Promise<EvalSummary>;
+    /**
+     * Get or create memory instance
+     * @returns Memory instance
+     */
+    memory(): Memory;
+    /**
+     * Get or create session memory instance
+     * @returns SessionMemory instance
+     */
+    sessions(): SessionMemory;
+    /**
+     * Get database adapter
+     * @returns Database adapter or undefined
+     */
+    getDatabase(): DatabaseAdapter | undefined;
+    /**
+     * Create a new graph workflow
+     * @param config - Graph configuration
+     * @returns GraphWorkflow instance
+     */
+    graph(config: GraphConfig): GraphWorkflow;
+    /**
+     * Run a test suite
+     * @param config - Test suite configuration
+     * @returns Test suite report
+     */
+    test(config: TestSuiteConfig): Promise<TestSuiteReport>;
+    /**
+     * Get the LLM adapter
+     * @returns LLM adapter
+     */
+    getLLM(): LLMAdapter;
+    /**
+     * Build a prompt from question and context
+     * @param question - The question to answer
+     * @param context - The context to use
+     * @param _systemPrompt - The system prompt to use (unused)
+     * @returns The built prompt
+     */
+    private buildPrompt;
+    /**
+     * Get the default system prompt
+     * @param hasContext - Whether context is available
+     * @returns The default system prompt
+     */
+    private getDefaultSystemPrompt;
+}
+/**
+ * Create a new Orka instance
+ * @param config - Orka configuration
+ * @returns Orka instance
+ */
+declare function createOrka(config: OrkaFullConfig): Orka;
+
+export { type EvaluateOptions as E, Orka as O, TestRunner as T, Evaluator as a, type OrkaFullConfig as b, type TestSuiteConfig as c, createOrka as d };