agentic-kit 0.0.2 → 0.1.1

package/README.md

@@ -1,12 +1,108 @@
 # Agentic Kit
 
-## Credits
+Agentic Kit is the core library providing a unified, streaming-capable interface for multiple LLM providers. It lets you plug in any supported adapter and switch between them at runtime.
 
-🛠 Built by Hyperweb (formerly Cosmology) — if you like our tools, please checkout and contribute to [our github ⚛️](https://github.com/hyperweb-io)
+## Installation
 
+```bash
+npm install agentic-kit
+# or
+yarn add agentic-kit
+```
 
-## Disclaimer
+Agentic Kit includes adapters for Ollama and Bradie out of the box.
 
-AS DESCRIBED IN THE LICENSES, THE SOFTWARE IS PROVIDED “AS IS”, AT YOUR OWN RISK, AND WITHOUT WARRANTIES OF ANY KIND.
+## Quick Start
 
-No developer or entity involved in creating this software will be liable for any claims or damages whatsoever associated with your use, inability to use, or your interaction with other users of the code, including any direct, indirect, incidental, special, exemplary, punitive or consequential damages, or loss of profits, cryptocurrencies, tokens, or anything else of value.
+```typescript
+import {
+  // Adapters
+  OllamaAdapter,
+  BradieAdapter,
+
+  // Factory functions
+  createOllamaKit,
+  createBradieKit,
+  createMultiProviderKit,
+
+  // Core type
+  AgentKit
+} from 'agentic-kit';
+
+// Ollama-only client
+const ollamaKit: AgentKit = createOllamaKit('http://localhost:11434');
+const text = await ollamaKit.generate({ model: 'mistral', prompt: 'Hello' });
+console.log(text);
+
+// Bradie-only client
+const bradieKit: AgentKit = createBradieKit({
+  domain: 'http://localhost:3000',
+  onSystemMessage: (msg) => console.log('[system]', msg),
+  onAssistantReply: (msg) => console.log('[assistant]', msg),
+});
+await bradieKit.generate({ prompt: 'Hello' });
+
+// Multi-provider client
+const multiKit = createMultiProviderKit();
+multiKit.addProvider(new OllamaAdapter('http://localhost:11434'));
+multiKit.addProvider(new BradieAdapter({
+  domain: 'http://localhost:3000',
+  onSystemMessage: console.log,
+  onAssistantReply: console.log
+}));
+const reply = await multiKit.generate({ model: 'mistral', prompt: 'Hello' });
+console.log(reply);
+```
+
+## Streaming
+
+Both adapters support a streaming mode that invokes a callback for each data chunk.
+
+```typescript
+await ollamaKit.generate(
+  { model: 'mistral', prompt: 'Hello', stream: true },
+  (chunk) => console.log('Ollama chunk:', chunk)
+);
+
+await bradieKit.generate(
+  { model: 'mistral', prompt: 'Hello', stream: true },
+  (chunk) => console.log('Bradie chunk:', chunk)
+);
+```
+
+## API Reference
+
+### AgentKit
+
+- `.generate(input: GenerateInput, options?: StreamingOptions): Promise<string | void>`
+- `.listProviders(): string[]`
+- `.setProvider(name: string): void`
+- `.getCurrentProvider(): AgentProvider | undefined`
+
+### GenerateInput
+
+```ts
+interface GenerateInput {
+  model?: string;      // For services that support named models
+  prompt: string;      // The text prompt
+  stream?: boolean;    // If true, use streaming mode
+}
+```
+
+### StreamingOptions
+
+```ts
+interface StreamingOptions {
+  onChunk?: (chunk: string) => void;
+  onStateChange?: (state: string) => void;
+  onError?: (error: Error) => void;
+}
+```
+
+## Contributing
+
+Contributions are welcome! Please submit issues and pull requests on [GitHub](https://github.com/hyperweb-io/agentic-kit).
+
+---
+
+© Hyperweb (formerly Cosmology). See LICENSE for full licensing and disclaimer. 

package/esm/index.js

@@ -1 +1,82 @@
-export {};
+import { Bradie } from '@agentic-kit/bradie';
+import OllamaClient from '@agentic-kit/ollama';
+export class OllamaAdapter {
+    name = 'ollama';
+    client;
+    constructor(baseUrl) {
+        this.client = new OllamaClient(baseUrl);
+    }
+    async generate(input) {
+        return this.client.generate(input);
+    }
+    async generateStreaming(input, onChunk) {
+        await this.client.generate({ ...input, stream: true }, onChunk);
+    }
+}
+export class BradieAdapter {
+    name = 'bradie';
+    client;
+    constructor(config) {
+        this.client = new Bradie(config);
+    }
+    async generate(input) {
+        const requestId = await this.client.sendMessage(input.prompt);
+        return new Promise((resolve, reject) => {
+            this.client.subscribeToResponse(requestId)
+                .then(() => resolve('Response completed'))
+                .catch(reject);
+        });
+    }
+    async generateStreaming(input, onChunk) {
+        const requestId = await this.client.sendMessage(input.prompt);
+        await this.client.subscribeToResponse(requestId);
+    }
+    getState() {
+        return this.client.getState();
+    }
+}
+export class AgentKit {
+    providers = new Map();
+    currentProvider;
+    addProvider(provider) {
+        this.providers.set(provider.name, provider);
+        if (!this.currentProvider) {
+            this.currentProvider = provider;
+        }
+    }
+    setProvider(name) {
+        const provider = this.providers.get(name);
+        if (!provider) {
+            throw new Error(`Provider '${name}' not found`);
+        }
+        this.currentProvider = provider;
+    }
+    getCurrentProvider() {
+        return this.currentProvider;
+    }
+    async generate(input, options) {
+        if (!this.currentProvider) {
+            throw new Error('No provider set');
+        }
+        if (input.stream && options?.onChunk) {
+            return this.currentProvider.generateStreaming(input, options.onChunk);
+        }
+        return this.currentProvider.generate(input);
+    }
+    listProviders() {
+        return Array.from(this.providers.keys());
+    }
+}
+export function createOllamaKit(baseUrl) {
+    const kit = new AgentKit();
+    kit.addProvider(new OllamaAdapter(baseUrl));
+    return kit;
+}
+export function createBradieKit(config) {
+    const kit = new AgentKit();
+    kit.addProvider(new BradieAdapter(config));
+    return kit;
+}
+export function createMultiProviderKit() {
+    return new AgentKit();
+}

package/index.d.ts

@@ -1 +1,51 @@
-export {};
+import { BradieState } from '@agentic-kit/bradie';
+import { GenerateInput } from '@agentic-kit/ollama';
+export interface AgentProvider {
+    name: string;
+    generate(input: GenerateInput): Promise<string>;
+    generateStreaming(input: GenerateInput, onChunk: (chunk: string) => void): Promise<void>;
+}
+export interface StreamingOptions {
+    onChunk?: (chunk: string) => void;
+    onStateChange?: (state: string) => void;
+    onError?: (error: Error) => void;
+}
+export declare class OllamaAdapter implements AgentProvider {
+    readonly name = "ollama";
+    private client;
+    constructor(baseUrl?: string);
+    generate(input: GenerateInput): Promise<string>;
+    generateStreaming(input: GenerateInput, onChunk: (chunk: string) => void): Promise<void>;
+}
+export declare class BradieAdapter implements AgentProvider {
+    readonly name = "bradie";
+    private client;
+    constructor(config: {
+        domain: string;
+        onSystemMessage: (msg: string) => void;
+        onAssistantReply: (msg: string) => void;
+        onError?: (err: Error) => void;
+        onComplete?: () => void;
+    });
+    generate(input: GenerateInput): Promise<string>;
+    generateStreaming(input: GenerateInput, onChunk: (chunk: string) => void): Promise<void>;
+    getState(): BradieState;
+}
+export declare class AgentKit {
+    private providers;
+    private currentProvider?;
+    addProvider(provider: AgentProvider): void;
+    setProvider(name: string): void;
+    getCurrentProvider(): AgentProvider | undefined;
+    generate(input: GenerateInput, options?: StreamingOptions): Promise<string | void>;
+    listProviders(): string[];
+}
+export declare function createOllamaKit(baseUrl?: string): AgentKit;
+export declare function createBradieKit(config: {
+    domain: string;
+    onSystemMessage: (msg: string) => void;
+    onAssistantReply: (msg: string) => void;
+    onError?: (err: Error) => void;
+    onComplete?: () => void;
+}): AgentKit;
+export declare function createMultiProviderKit(): AgentKit;

package/index.js

@@ -1,2 +1,94 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentKit = exports.BradieAdapter = exports.OllamaAdapter = void 0;
+exports.createOllamaKit = createOllamaKit;
+exports.createBradieKit = createBradieKit;
+exports.createMultiProviderKit = createMultiProviderKit;
+const bradie_1 = require("@agentic-kit/bradie");
+const ollama_1 = __importDefault(require("@agentic-kit/ollama"));
+class OllamaAdapter {
+    name = 'ollama';
+    client;
+    constructor(baseUrl) {
+        this.client = new ollama_1.default(baseUrl);
+    }
+    async generate(input) {
+        return this.client.generate(input);
+    }
+    async generateStreaming(input, onChunk) {
+        await this.client.generate({ ...input, stream: true }, onChunk);
+    }
+}
+exports.OllamaAdapter = OllamaAdapter;
+class BradieAdapter {
+    name = 'bradie';
+    client;
+    constructor(config) {
+        this.client = new bradie_1.Bradie(config);
+    }
+    async generate(input) {
+        const requestId = await this.client.sendMessage(input.prompt);
+        return new Promise((resolve, reject) => {
+            this.client.subscribeToResponse(requestId)
+                .then(() => resolve('Response completed'))
+                .catch(reject);
+        });
+    }
+    async generateStreaming(input, onChunk) {
+        const requestId = await this.client.sendMessage(input.prompt);
+        await this.client.subscribeToResponse(requestId);
+    }
+    getState() {
+        return this.client.getState();
+    }
+}
+exports.BradieAdapter = BradieAdapter;
+class AgentKit {
+    providers = new Map();
+    currentProvider;
+    addProvider(provider) {
+        this.providers.set(provider.name, provider);
+        if (!this.currentProvider) {
+            this.currentProvider = provider;
+        }
+    }
+    setProvider(name) {
+        const provider = this.providers.get(name);
+        if (!provider) {
+            throw new Error(`Provider '${name}' not found`);
+        }
+        this.currentProvider = provider;
+    }
+    getCurrentProvider() {
+        return this.currentProvider;
+    }
+    async generate(input, options) {
+        if (!this.currentProvider) {
+            throw new Error('No provider set');
+        }
+        if (input.stream && options?.onChunk) {
+            return this.currentProvider.generateStreaming(input, options.onChunk);
+        }
+        return this.currentProvider.generate(input);
+    }
+    listProviders() {
+        return Array.from(this.providers.keys());
+    }
+}
+exports.AgentKit = AgentKit;
+function createOllamaKit(baseUrl) {
+    const kit = new AgentKit();
+    kit.addProvider(new OllamaAdapter(baseUrl));
+    return kit;
+}
+function createBradieKit(config) {
+    const kit = new AgentKit();
+    kit.addProvider(new BradieAdapter(config));
+    return kit;
+}
+function createMultiProviderKit() {
+    return new AgentKit();
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-kit",
-  "version": "0.0.2",
+  "version": "0.1.1",
   "author": "Dan Lynch <pyramation@gmail.com>",
   "description": "Agentic Kit",
   "main": "index.js",
@@ -30,9 +30,9 @@
     "test:watch": "jest --watch"
   },
   "dependencies": {
-    "@agentic-kit/bradie": "^0.0.2",
-    "@agentic-kit/ollama": "^0.0.2"
+    "@agentic-kit/bradie": "^0.1.1",
+    "@agentic-kit/ollama": "^0.1.1"
   },
   "keywords": [],
-  "gitHead": "93ed791457a8bc671058efd517f7978e41563b8a"
+  "gitHead": "0204aa87ae43833af29965684146ff22ebf77564"
 }