@venturekit-pro/ai 0.0.0-dev.20260323005827

package/LICENSE

@@ -0,0 +1,19 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   Copyright 2024 VentureKit
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,117 @@
+# @venturekit-pro/ai
+
+> **Warning:** This package is in active development and not production-ready. APIs may change without notice.
+
+AI utilities for [VentureKit](https://venturekit.dev) — embeddings, vector stores, RAG pipelines, and agents with tool use.
+
+## Installation
+
+```bash
+npm install @venturekit-pro/ai@dev
+```
+
+### Optional Peer Dependencies
+
+Install the providers you need:
+
+```bash
+# OpenAI (embeddings, agents)
+npm install openai
+
+# AWS Bedrock (embeddings)
+npm install @aws-sdk/client-bedrock-runtime
+
+# Pinecone (vector store)
+npm install @pinecone-database/pinecone
+```
+
+## Overview
+
+`@venturekit-pro/ai` provides:
+
+- **Embeddings** — generate vector embeddings via OpenAI or AWS Bedrock
+- **Vector stores** — store and query vectors with Pinecone, pgvector, or in-memory
+- **RAG pipelines** — chunking, retrieval, and context building for retrieval-augmented generation
+- **Agents** — AI agents with tool use via OpenAI function calling
+
+## Embeddings
+
+```typescript
+import { createEmbedder } from '@venturekit-pro/ai';
+
+const embedder = createEmbedder({
+  provider: 'openai',
+  model: 'text-embedding-3-small',
+  apiKey: process.env.OPENAI_API_KEY,
+});
+
+const vector = await embedder.embed('What is VentureKit?');
+const vectors = await embedder.embedBatch(['Question 1', 'Question 2']);
+```
+
+## Vector Stores
+
+```typescript
+import { createVectorStore } from '@venturekit-pro/ai';
+
+const store = createVectorStore({
+  provider: 'pinecone',
+  indexName: 'my-index',
+  apiKey: process.env.PINECONE_API_KEY,
+});
+
+await store.upsert([{ id: 'doc-1', vector, metadata: { title: 'Guide' } }]);
+const results = await store.query(queryVector, { topK: 5 });
+```
+
+## RAG Pipeline
+
+```typescript
+import { createRagPipeline, chunkText } from '@venturekit-pro/ai';
+
+const rag = createRagPipeline({
+  embedder,
+  vectorStore: store,
+  chunkSize: 500,
+  chunkOverlap: 50,
+});
+
+// Ingest documents
+const chunks = chunkText(documentText, { size: 500, overlap: 50 });
+await rag.ingest(chunks);
+
+// Query with context
+const context = await rag.retrieve('How do I deploy?', { topK: 3 });
+```
+
+## Agents
+
+```typescript
+import { createAgent, defineTool } from '@venturekit-pro/ai';
+
+const searchTool = defineTool({
+  name: 'search',
+  description: 'Search the knowledge base',
+  parameters: { query: { type: 'string', description: 'Search query' } },
+  handler: async ({ query }) => {
+    return await rag.retrieve(query);
+  },
+});
+
+const agent = createAgent({
+  model: 'gpt-4',
+  apiKey: process.env.OPENAI_API_KEY,
+  tools: [searchTool],
+  systemPrompt: 'You are a helpful assistant.',
+});
+
+const response = await agent.run('How do I set up authentication?');
+```
+
+## API Reference
+
+See the [API reference](https://venturekit.dev/api-reference/ai) for full documentation.
+
+## License
+
+Apache-2.0 — see [LICENSE](../../LICENSE) for details.

package/dist/agents/agent.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Agent
+ *
+ * AI agent with tool use capabilities.
+ */
+import type { AgentConfig, ChatMessage, AgentResponse, Tool } from '../types/index.js';
+/**
+ * Agent interface
+ */
+export interface Agent {
+    /** Run agent with a prompt */
+    run(prompt: string): Promise<AgentResponse>;
+    /** Run agent with conversation history */
+    chat(messages: ChatMessage[]): Promise<AgentResponse>;
+    /** Add a tool to the agent */
+    addTool(tool: Tool): void;
+}
+/**
+ * Create an agent
+ */
+export declare function createAgent(config: AgentConfig): Agent;
+//# sourceMappingURL=agent.d.ts.map

package/dist/agents/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/agents/agent.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAEvF;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,8BAA8B;IAC9B,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAE5C,0CAA0C;IAC1C,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAEtD,8BAA8B;IAC9B,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,KAAK,CAatD"}

package/dist/agents/agent.js

@@ -0,0 +1,138 @@
+/**
+ * Agent
+ *
+ * AI agent with tool use capabilities.
+ */
+/**
+ * Create an agent
+ */
+export function createAgent(config) {
+    const tools = [...(config.tools || [])];
+    switch (config.provider) {
+        case 'openai':
+            return createOpenAIAgent(config, tools);
+        case 'anthropic':
+            return createAnthropicAgent(config, tools);
+        case 'bedrock':
+            return createBedrockAgent(config, tools);
+        default:
+            throw new Error(`Unsupported agent provider: ${config.provider}`);
+    }
+}
+/**
+ * OpenAI agent implementation
+ */
+function createOpenAIAgent(config, tools) {
+    return {
+        async run(prompt) {
+            const messages = [];
+            if (config.systemPrompt) {
+                messages.push({ role: 'system', content: config.systemPrompt });
+            }
+            messages.push({ role: 'user', content: prompt });
+            return this.chat(messages);
+        },
+        async chat(messages) {
+            const { default: OpenAI } = await import('openai');
+            const client = new OpenAI({ apiKey: config.apiKey });
+            const toolCalls = [];
+            let iterations = 0;
+            const openaiMessages = messages.map(m => ({
+                role: m.role,
+                content: m.content,
+            }));
+            while (iterations < (config.maxIterations || 10)) {
+                iterations++;
+                const response = await client.chat.completions.create({
+                    model: config.model,
+                    messages: openaiMessages,
+                    temperature: config.temperature,
+                    tools: tools.length > 0 ? tools.map(t => ({
+                        type: 'function',
+                        function: {
+                            name: t.name,
+                            description: t.description,
+                            parameters: t.parameters,
+                        },
+                    })) : undefined,
+                });
+                const choice = response.choices[0];
+                const message = choice.message;
+                // No tool calls, return response
+                if (!message.tool_calls || message.tool_calls.length === 0) {
+                    return {
+                        content: message.content || '',
+                        toolCalls,
+                        iterations,
+                        tokensUsed: response.usage ? {
+                            prompt: response.usage.prompt_tokens,
+                            completion: response.usage.completion_tokens,
+                            total: response.usage.total_tokens,
+                        } : undefined,
+                    };
+                }
+                // Execute tool calls
+                openaiMessages.push({
+                    role: 'assistant',
+                    content: message.content || '',
+                });
+                for (const toolCall of message.tool_calls) {
+                    const tool = tools.find(t => t.name === toolCall.function.name);
+                    if (!tool) {
+                        throw new Error(`Unknown tool: ${toolCall.function.name}`);
+                    }
+                    const args = JSON.parse(toolCall.function.arguments);
+                    const result = await tool.execute(args);
+                    toolCalls.push({
+                        tool: tool.name,
+                        input: args,
+                        output: result,
+                    });
+                    openaiMessages.push({
+                        role: 'assistant',
+                        content: JSON.stringify(result),
+                    });
+                }
+            }
+            throw new Error(`Agent exceeded max iterations (${config.maxIterations})`);
+        },
+        addTool(tool) {
+            tools.push(tool);
+        },
+    };
+}
+/**
+ * Anthropic agent implementation (Claude)
+ */
+function createAnthropicAgent(config, tools) {
+    return {
+        async run(prompt) {
+            // Anthropic implementation would go here
+            throw new Error('Anthropic agent not yet implemented - use OpenAI or Bedrock');
+        },
+        async chat(_messages) {
+            throw new Error('Anthropic agent not yet implemented - use OpenAI or Bedrock');
+        },
+        addTool(tool) {
+            tools.push(tool);
+        },
+    };
+}
+/**
+ * AWS Bedrock agent implementation
+ */
+function createBedrockAgent(config, tools) {
+    return {
+        async run(prompt) {
+            // Bedrock implementation would go here
+            throw new Error('Bedrock agent not yet implemented - use OpenAI');
+        },
+        async chat(_messages) {
+            throw new Error('Bedrock agent not yet implemented - use OpenAI');
+        },
+        addTool(tool) {
+            tools.push(tool);
+        },
+    };
+}
+//# sourceMappingURL=agent.js.map

package/dist/agents/agent.js.map

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

package/dist/agents/config.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Agent Configuration
+ */
+import type { AgentConfig, AgentConfigInput } from '../types/index.js';
+/**
+ * Default agent configuration (OpenAI GPT-4)
+ */
+export declare const DEFAULT_AGENT_CONFIG: AgentConfig;
+/**
+ * Create agent configuration from input
+ */
+export declare function createAgentConfig(input?: AgentConfigInput): AgentConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/agents/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/agents/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAEvE;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,WAKlC,CAAC;AAEF;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,CAAC,EAAE,gBAAgB,GAAG,WAAW,CAOvE"}

package/dist/agents/config.js

@@ -0,0 +1,24 @@
+/**
+ * Agent Configuration
+ */
+/**
+ * Default agent configuration (OpenAI GPT-4)
+ */
+export const DEFAULT_AGENT_CONFIG = {
+    provider: 'openai',
+    model: 'gpt-4-turbo-preview',
+    maxIterations: 10,
+    temperature: 0.7,
+};
+/**
+ * Create agent configuration from input
+ */
+export function createAgentConfig(input) {
+    if (!input)
+        return DEFAULT_AGENT_CONFIG;
+    return {
+        ...DEFAULT_AGENT_CONFIG,
+        ...input,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/agents/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/agents/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAgB;IAC/C,QAAQ,EAAE,QAAQ;IAClB,KAAK,EAAE,qBAAqB;IAC5B,aAAa,EAAE,EAAE;IACjB,WAAW,EAAE,GAAG;CACjB,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAwB;IACxD,IAAI,CAAC,KAAK;QAAE,OAAO,oBAAoB,CAAC;IAExC,OAAO;QACL,GAAG,oBAAoB;QACvB,GAAG,KAAK;KACT,CAAC;AACJ,CAAC"}

package/dist/agents/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Agents
+ *
+ * Utilities for building AI agents with tool use.
+ */
+export { createAgentConfig, DEFAULT_AGENT_CONFIG } from './config.js';
+export { createAgent } from './agent.js';
+export { defineTool } from './tools.js';
+export type { Agent } from './agent.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/agents/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,YAAY,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC"}

package/dist/agents/index.js

@@ -0,0 +1,9 @@
+/**
+ * Agents
+ *
+ * Utilities for building AI agents with tool use.
+ */
+export { createAgentConfig, DEFAULT_AGENT_CONFIG } from './config.js';
+export { createAgent } from './agent.js';
+export { defineTool } from './tools.js';
+//# sourceMappingURL=index.js.map

package/dist/agents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/dist/agents/tools.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Tool Definition Helpers
+ */
+import type { Tool } from '../types/index.js';
+/**
+ * Define a tool for agent use
+ */
+export declare function defineTool<T extends Record<string, unknown>>(config: {
+    name: string;
+    description: string;
+    parameters: Tool['parameters'];
+    execute: (params: T) => Promise<unknown>;
+}): Tool;
+//# sourceMappingURL=tools.d.ts.map

package/dist/agents/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/agents/tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAE9C;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IAC/B,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1C,GAAG,IAAI,CAOP"}

package/dist/agents/tools.js

@@ -0,0 +1,15 @@
+/**
+ * Tool Definition Helpers
+ */
+/**
+ * Define a tool for agent use
+ */
+export function defineTool(config) {
+    return {
+        name: config.name,
+        description: config.description,
+        parameters: config.parameters,
+        execute: config.execute,
+    };
+}
+//# sourceMappingURL=tools.js.map

package/dist/agents/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/agents/tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,MAAM,UAAU,UAAU,CAAoC,MAK7D;IACC,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,OAAO,EAAE,MAAM,CAAC,OAA0B;KAC3C,CAAC;AACJ,CAAC"}

package/dist/context/context.d.ts

@@ -0,0 +1,118 @@
+/**
+ * VentureKit AI Context Integration
+ *
+ * Provides tenant-aware, permission-aware AI capabilities.
+ * Wraps agents and RAG pipelines with VentureKit context
+ * so that all AI operations are scoped to the current tenant
+ * and respect user permissions.
+ */
+import type { AgentConfig, Tool, AgentResponse, ChatMessage } from '../types/agents.js';
+import type { RagConfig, RagQueryOptions, RetrievedContext } from '../types/rag.js';
+/**
+ * VentureKit context for AI operations
+ */
+export interface VentureKitAIContext {
+    /** Current tenant ID */
+    tenantId: string;
+    /** Current user ID */
+    userId?: string;
+    /** User roles/permissions */
+    permissions?: string[];
+    /** Additional metadata to inject */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Permission check function
+ */
+export type PermissionCheck = (context: VentureKitAIContext, action: string, resource?: string) => boolean | Promise<boolean>;
+/**
+ * Context-aware agent options
+ */
+export interface ContextAwareAgentOptions {
+    /** Agent config */
+    agentConfig: AgentConfig;
+    /** Create the underlying agent (injected for testability) */
+    createAgent: (config: AgentConfig) => {
+        run(prompt: string): Promise<AgentResponse>;
+        chat(messages: ChatMessage[]): Promise<AgentResponse>;
+        addTool(tool: Tool): void;
+    };
+    /** Permission check (optional) */
+    checkPermission?: PermissionCheck;
+    /** Required permission to use agent */
+    requiredPermission?: string;
+    /** Whether to inject tenant context into system prompt */
+    injectContext?: boolean;
+}
+/**
+ * Context-aware RAG options
+ */
+export interface ContextAwareRagOptions {
+    /** Create the underlying RAG pipeline (injected for testability) */
+    createPipeline: (config: RagConfig) => {
+        index(documents: Array<{
+            id: string;
+            content: string;
+            metadata?: Record<string, unknown>;
+        }>): Promise<void>;
+        retrieve(query: string, options?: RagQueryOptions): Promise<RetrievedContext>;
+        delete(ids: string[]): Promise<void>;
+    };
+    /** RAG config */
+    ragConfig: RagConfig;
+    /** Permission check (optional) */
+    checkPermission?: PermissionCheck;
+    /** Required permission to query */
+    requiredPermission?: string;
+}
+/**
+ * Build a system prompt suffix with VentureKit context
+ */
+export declare function buildContextPrompt(context: VentureKitAIContext): string;
+/**
+ * Create a tenant-scoped metadata filter for RAG queries
+ */
+export declare function tenantFilter(tenantId: string, additionalFilters?: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Create a context-aware agent that scopes all operations to a tenant
+ */
+export declare function createContextAwareAgent(context: VentureKitAIContext, options: ContextAwareAgentOptions): {
+    /**
+     * Run with permission check
+     */
+    run(prompt: string): Promise<AgentResponse>;
+    /**
+     * Chat with permission check
+     */
+    chat(messages: ChatMessage[]): Promise<AgentResponse>;
+    /**
+     * Add a tool to the underlying agent
+     */
+    addTool(tool: Tool): void;
+    /** The VentureKit context */
+    context: VentureKitAIContext;
+};
+/**
+ * Create a context-aware RAG pipeline that scopes queries to a tenant
+ */
+export declare function createContextAwareRag(context: VentureKitAIContext, options: ContextAwareRagOptions): {
+    /**
+     * Index documents with tenant metadata automatically injected
+     */
+    index(documents: Array<{
+        id: string;
+        content: string;
+        metadata?: Record<string, unknown>;
+    }>): Promise<void>;
+    /**
+     * Retrieve with automatic tenant filter
+     */
+    retrieve(query: string, options?: RagQueryOptions): Promise<RetrievedContext>;
+    /**
+     * Delete documents (scoped to tenant)
+     */
+    delete(ids: string[]): Promise<void>;
+    /** The VentureKit context */
+    context: VentureKitAIContext;
+};
+//# sourceMappingURL=context.d.ts.map

package/dist/context/context.d.ts.map

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