agentic-kit 0.1.1 → 0.3.0

package/LICENSE

@@ -1,6 +1,7 @@
 MIT License
 
-Copyright (c) 2024 Interweb, Inc. <developers@hyperweb.io>
+Copyright (c) 2025 Dan Lynch <pyramation@gmail.com>
+Copyright (c) 2025 Constructive <developers@constructive.io>
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,108 +1,111 @@
-# Agentic Kit
+# agentic-kit
 
-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.
+<p align="center" width="100%">
+  <img height="250" src="https://raw.githubusercontent.com/constructive-io/constructive/refs/heads/main/assets/outline-logo.svg" />
+</p>
+
+<p align="center" width="100%">
+  <a href="https://github.com/constructive-io/agentic-kit/actions/workflows/run-tests.yaml">
+    <img height="20" src="https://github.com/constructive-io/agentic-kit/actions/workflows/run-tests.yaml/badge.svg" />
+  </a>
+   <a href="https://github.com/constructive-io/agentic-kit/blob/main/LICENSE"><img height="20" src="https://img.shields.io/badge/license-MIT-blue.svg"/></a>
+   <a href="https://www.npmjs.com/package/agentic-kit"><img height="20" src="https://img.shields.io/github/package-json/v/constructive-io/agentic-kit?filename=packages%2Fagentic-kit%2Fpackage.json"/></a>
+</p>
+
+A unified, streaming-capable interface for multiple LLM providers. Plug in any supported adapter and swap between them at runtime.
 
 ## Installation
 
 ```bash
 npm install agentic-kit
-# or
-yarn add agentic-kit
 ```
 
-Agentic Kit includes adapters for Ollama and Bradie out of the box.
-
 ## Quick Start
 
 ```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);
+import { createOllamaKit, createMultiProviderKit, OllamaAdapter, AgentKit } from 'agentic-kit';
+
+// Ollama
+const kit = createOllamaKit('http://localhost:11434');
+const text = await kit.generate({ model: 'mistral', prompt: 'Hello' });
+
+// Multi-provider with fallback
+const multi = createMultiProviderKit();
+multi.addProvider(new OllamaAdapter('http://localhost:11434'));
+const reply = await multi.generate({ model: 'mistral', prompt: 'Hello' });
 ```
 
 ## Streaming
 
-Both adapters support a streaming mode that invokes a callback for each data chunk.
-
 ```typescript
-await ollamaKit.generate(
+await kit.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)
+  { onChunk: (chunk) => process.stdout.write(chunk) }
 );
 ```
 
 ## API Reference
 
-### AgentKit
+### `AgentKit`
 
 - `.generate(input: GenerateInput, options?: StreamingOptions): Promise<string | void>`
-- `.listProviders(): string[]`
+- `.addProvider(provider: AgentProvider): void`
 - `.setProvider(name: string): void`
+- `.listProviders(): string[]`
 - `.getCurrentProvider(): AgentProvider | undefined`
 
-### GenerateInput
+### `GenerateInput`
 
 ```ts
 interface GenerateInput {
-  model?: string;      // For services that support named models
-  prompt: string;      // The text prompt
-  stream?: boolean;    // If true, use streaming mode
+  model: string;
+  prompt: string;
+  stream?: boolean;
 }
 ```
 
-### StreamingOptions
+### `StreamingOptions`
 
 ```ts
 interface StreamingOptions {
   onChunk?: (chunk: string) => void;
   onStateChange?: (state: string) => void;
   onError?: (error: Error) => void;
+  onComplete?: () => void;
 }
 ```
 
-## Contributing
+---
+
+## Related Constructive Tooling
 
-Contributions are welcome! Please submit issues and pull requests on [GitHub](https://github.com/hyperweb-io/agentic-kit).
+### 🤖 AI & Agent Development
 
----
+* [agentic-kit](https://github.com/constructive-io/agentic-kit): **🧰 Provider-agnostic LLM adapter** with streaming and multi-turn support. Swap between Anthropic, OpenAI, Ollama, and any OpenAI-compatible endpoint.
+
+### 📦 Package Management
+
+* [pgpm](https://github.com/constructive-io/constructive/tree/main/pgpm/pgpm): **🖥️ PostgreSQL Package Manager** for modular Postgres development. Works with database workspaces, scaffolding, migrations, seeding, and installing database packages.
+
+### 🧪 Testing
+
+* [pgsql-test](https://github.com/constructive-io/constructive/tree/main/postgres/pgsql-test): **📊 Isolated testing environments** with per-test transaction rollbacks—ideal for integration tests, complex migrations, and RLS simulation.
+* [pgsql-seed](https://github.com/constructive-io/constructive/tree/main/postgres/pgsql-seed): **🌱 PostgreSQL seeding utilities** for CSV, JSON, SQL data loading, and pgpm deployment.
+* [supabase-test](https://github.com/constructive-io/constructive/tree/main/postgres/supabase-test): **🧪 Supabase-native test harness** preconfigured for the local Supabase stack—per-test rollbacks, JWT/role context helpers, and CI/GitHub Actions ready.
+
+### 🧠 Parsing & AST
+
+* [pgsql-parser](https://www.npmjs.com/package/pgsql-parser): **🔄 SQL conversion engine** that interprets and converts PostgreSQL syntax.
+* [libpg-query-node](https://www.npmjs.com/package/libpg-query): **🌉 Node.js bindings** for `libpg_query`, converting SQL into parse trees.
+* [@pgsql/types](https://www.npmjs.com/package/@pgsql/types): **📝 Type definitions** for PostgreSQL AST nodes in TypeScript.
+* [@pgsql/utils](https://www.npmjs.com/package/@pgsql/utils): **🛠️ AST utilities** for constructing and transforming PostgreSQL syntax trees.
+
+## Credits
+
+**🛠 Built by the [Constructive](https://constructive.io) team — creators of modular Postgres tooling for secure, composable backends. If you like our work, contribute on [GitHub](https://github.com/constructive-io).**
+
+## Disclaimer
+
+AS DESCRIBED IN THE LICENSES, THE SOFTWARE IS PROVIDED "AS IS", AT YOUR OWN RISK, AND WITHOUT WARRANTIES OF ANY KIND.
 
-© Hyperweb (formerly Cosmology). See LICENSE for full licensing and disclaimer. 
+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.

package/esm/index.js

@@ -1,5 +1,10 @@
-import { Bradie } from '@agentic-kit/bradie';
 import OllamaClient from '@agentic-kit/ollama';
+import { AnthropicAdapter } from '@agentic-kit/anthropic';
+import { OpenAIAdapter } from '@agentic-kit/openai';
+export { OllamaClient };
+export { AnthropicAdapter };
+export { OpenAIAdapter };
+// ─── Ollama Adapter ───────────────────────────────────────────────────────────
 export class OllamaAdapter {
     name = 'ollama';
     client;
@@ -10,72 +15,68 @@ export class OllamaAdapter {
         return this.client.generate(input);
     }
     async generateStreaming(input, onChunk) {
-        await this.client.generate({ ...input, stream: true }, onChunk);
+        return this.client.generate(input, 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();
+    async listModels() {
+        return this.client.listModels();
     }
 }
+// ─── AgentKit ─────────────────────────────────────────────────────────────────
 export class AgentKit {
     providers = new Map();
-    currentProvider;
+    current;
     addProvider(provider) {
         this.providers.set(provider.name, provider);
-        if (!this.currentProvider) {
-            this.currentProvider = provider;
-        }
+        if (!this.current)
+            this.current = provider;
+        return this;
     }
     setProvider(name) {
         const provider = this.providers.get(name);
-        if (!provider) {
+        if (!provider)
             throw new Error(`Provider '${name}' not found`);
-        }
-        this.currentProvider = provider;
-    }
-    getCurrentProvider() {
-        return this.currentProvider;
+        this.current = provider;
+        return this;
     }
+    getCurrentProvider() { return this.current; }
+    listProviders() { return Array.from(this.providers.keys()); }
     async generate(input, options) {
-        if (!this.currentProvider) {
-            throw new Error('No provider set');
+        if (!this.current)
+            throw new Error('No provider set. Call addProvider() first.');
+        if (options?.onChunk) {
+            try {
+                await this.current.generateStreaming(input, options.onChunk);
+                options.onComplete?.();
+            }
+            catch (err) {
+                options.onError?.(err);
+                throw err;
+            }
+            return;
+        }
+        try {
+            const result = await this.current.generate(input);
+            options?.onComplete?.();
+            return result;
         }
-        if (input.stream && options?.onChunk) {
-            return this.currentProvider.generateStreaming(input, options.onChunk);
+        catch (err) {
+            options?.onError?.(err);
+            throw err;
         }
-        return this.currentProvider.generate(input);
     }
-    listProviders() {
-        return Array.from(this.providers.keys());
+    async listModels() {
+        return this.current?.listModels?.() ?? [];
     }
 }
+// ─── Factory helpers ──────────────────────────────────────────────────────────
 export function createOllamaKit(baseUrl) {
-    const kit = new AgentKit();
-    kit.addProvider(new OllamaAdapter(baseUrl));
-    return kit;
+    return new AgentKit().addProvider(new OllamaAdapter(baseUrl));
+}
+export function createAnthropicKit(options) {
+    return new AgentKit().addProvider(new AnthropicAdapter(options));
 }
-export function createBradieKit(config) {
-    const kit = new AgentKit();
-    kit.addProvider(new BradieAdapter(config));
-    return kit;
+export function createOpenAIKit(options) {
+    return new AgentKit().addProvider(new OpenAIAdapter(options));
 }
 export function createMultiProviderKit() {
     return new AgentKit();

package/index.d.ts

@@ -1,51 +1,41 @@
-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>;
-}
+import OllamaClient, { ChatMessage, GenerateInput } from '@agentic-kit/ollama';
+import { AnthropicAdapter, type AnthropicOptions } from '@agentic-kit/anthropic';
+import { OpenAIAdapter, type OpenAIOptions } from '@agentic-kit/openai';
+export type { ChatMessage, GenerateInput };
+export { OllamaClient };
+export { AnthropicAdapter, type AnthropicOptions };
+export { OpenAIAdapter, type OpenAIOptions };
 export interface StreamingOptions {
     onChunk?: (chunk: string) => void;
     onStateChange?: (state: string) => void;
     onError?: (error: Error) => void;
+    onComplete?: () => void;
 }
-export declare class OllamaAdapter implements AgentProvider {
-    readonly name = "ollama";
-    private client;
-    constructor(baseUrl?: string);
+export interface AgentProvider {
+    readonly name: string;
     generate(input: GenerateInput): Promise<string>;
     generateStreaming(input: GenerateInput, onChunk: (chunk: string) => void): Promise<void>;
+    listModels?(): Promise<string[]>;
 }
-export declare class BradieAdapter implements AgentProvider {
-    readonly name = "bradie";
+export declare class OllamaAdapter implements AgentProvider {
+    readonly name = "ollama";
     private client;
-    constructor(config: {
-        domain: string;
-        onSystemMessage: (msg: string) => void;
-        onAssistantReply: (msg: string) => void;
-        onError?: (err: Error) => void;
-        onComplete?: () => void;
-    });
+    constructor(baseUrl?: string);
     generate(input: GenerateInput): Promise<string>;
     generateStreaming(input: GenerateInput, onChunk: (chunk: string) => void): Promise<void>;
-    getState(): BradieState;
+    listModels(): Promise<string[]>;
 }
 export declare class AgentKit {
     private providers;
-    private currentProvider?;
-    addProvider(provider: AgentProvider): void;
-    setProvider(name: string): void;
+    private current?;
+    addProvider(provider: AgentProvider): this;
+    setProvider(name: string): this;
     getCurrentProvider(): AgentProvider | undefined;
-    generate(input: GenerateInput, options?: StreamingOptions): Promise<string | void>;
     listProviders(): string[];
+    generate(input: GenerateInput, options?: StreamingOptions): Promise<string | void>;
+    listModels(): Promise<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 createAnthropicKit(options: AnthropicOptions | string): AgentKit;
+export declare function createOpenAIKit(options: OpenAIOptions | string): AgentKit;
 export declare function createMultiProviderKit(): AgentKit;

package/index.js

@@ -3,12 +3,18 @@ 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.AgentKit = exports.OllamaAdapter = exports.OpenAIAdapter = exports.AnthropicAdapter = exports.OllamaClient = void 0;
 exports.createOllamaKit = createOllamaKit;
-exports.createBradieKit = createBradieKit;
+exports.createAnthropicKit = createAnthropicKit;
+exports.createOpenAIKit = createOpenAIKit;
 exports.createMultiProviderKit = createMultiProviderKit;
-const bradie_1 = require("@agentic-kit/bradie");
 const ollama_1 = __importDefault(require("@agentic-kit/ollama"));
+exports.OllamaClient = ollama_1.default;
+const anthropic_1 = require("@agentic-kit/anthropic");
+Object.defineProperty(exports, "AnthropicAdapter", { enumerable: true, get: function () { return anthropic_1.AnthropicAdapter; } });
+const openai_1 = require("@agentic-kit/openai");
+Object.defineProperty(exports, "OpenAIAdapter", { enumerable: true, get: function () { return openai_1.OpenAIAdapter; } });
+// ─── Ollama Adapter ───────────────────────────────────────────────────────────
 class OllamaAdapter {
     name = 'ollama';
     client;
@@ -19,75 +25,70 @@ class OllamaAdapter {
         return this.client.generate(input);
     }
     async generateStreaming(input, onChunk) {
-        await this.client.generate({ ...input, stream: true }, onChunk);
+        return this.client.generate(input, 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();
+    async listModels() {
+        return this.client.listModels();
     }
 }
-exports.BradieAdapter = BradieAdapter;
+exports.OllamaAdapter = OllamaAdapter;
+// ─── AgentKit ─────────────────────────────────────────────────────────────────
 class AgentKit {
     providers = new Map();
-    currentProvider;
+    current;
     addProvider(provider) {
         this.providers.set(provider.name, provider);
-        if (!this.currentProvider) {
-            this.currentProvider = provider;
-        }
+        if (!this.current)
+            this.current = provider;
+        return this;
     }
     setProvider(name) {
         const provider = this.providers.get(name);
-        if (!provider) {
+        if (!provider)
             throw new Error(`Provider '${name}' not found`);
-        }
-        this.currentProvider = provider;
-    }
-    getCurrentProvider() {
-        return this.currentProvider;
+        this.current = provider;
+        return this;
     }
+    getCurrentProvider() { return this.current; }
+    listProviders() { return Array.from(this.providers.keys()); }
     async generate(input, options) {
-        if (!this.currentProvider) {
-            throw new Error('No provider set');
+        if (!this.current)
+            throw new Error('No provider set. Call addProvider() first.');
+        if (options?.onChunk) {
+            try {
+                await this.current.generateStreaming(input, options.onChunk);
+                options.onComplete?.();
+            }
+            catch (err) {
+                options.onError?.(err);
+                throw err;
+            }
+            return;
+        }
+        try {
+            const result = await this.current.generate(input);
+            options?.onComplete?.();
+            return result;
         }
-        if (input.stream && options?.onChunk) {
-            return this.currentProvider.generateStreaming(input, options.onChunk);
+        catch (err) {
+            options?.onError?.(err);
+            throw err;
         }
-        return this.currentProvider.generate(input);
     }
-    listProviders() {
-        return Array.from(this.providers.keys());
+    async listModels() {
+        return this.current?.listModels?.() ?? [];
     }
 }
 exports.AgentKit = AgentKit;
+// ─── Factory helpers ──────────────────────────────────────────────────────────
 function createOllamaKit(baseUrl) {
-    const kit = new AgentKit();
-    kit.addProvider(new OllamaAdapter(baseUrl));
-    return kit;
+    return new AgentKit().addProvider(new OllamaAdapter(baseUrl));
+}
+function createAnthropicKit(options) {
+    return new AgentKit().addProvider(new anthropic_1.AnthropicAdapter(options));
 }
-function createBradieKit(config) {
-    const kit = new AgentKit();
-    kit.addProvider(new BradieAdapter(config));
-    return kit;
+function createOpenAIKit(options) {
+    return new AgentKit().addProvider(new openai_1.OpenAIAdapter(options));
 }
 function createMultiProviderKit() {
     return new AgentKit();

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "agentic-kit",
-  "version": "0.1.1",
+  "version": "0.3.0",
   "author": "Dan Lynch <pyramation@gmail.com>",
-  "description": "Agentic Kit",
+  "description": "Provider-agnostic LLM adapter with streaming and multi-turn support",
   "main": "index.js",
   "module": "esm/index.js",
   "types": "index.d.ts",
-  "homepage": "https://github.com/hyperweb-io/agentic-kit",
+  "homepage": "https://github.com/constructive-io/agentic-kit",
   "license": "SEE LICENSE IN LICENSE",
   "publishConfig": {
     "access": "public",
@@ -14,25 +14,26 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/hyperweb-io/agentic-kit"
+    "url": "https://github.com/constructive-io/agentic-kit"
   },
   "bugs": {
-    "url": "https://github.com/hyperweb-io/agentic-kit/issues"
+    "url": "https://github.com/constructive-io/agentic-kit/issues"
   },
   "scripts": {
-    "copy": "copyfiles -f ../../LICENSE README.md package.json dist",
-    "clean": "rimraf dist/**",
-    "prepare": "npm run build",
-    "build": "npm run clean; tsc; tsc -p tsconfig.esm.json; npm run copy",
-    "build:dev": "npm run clean; tsc --declarationMap; tsc -p tsconfig.esm.json; npm run copy",
+    "clean": "makage clean",
+    "build": "makage build",
+    "build:dev": "makage build --dev",
     "lint": "eslint . --fix",
     "test": "jest",
     "test:watch": "jest --watch"
   },
   "dependencies": {
-    "@agentic-kit/bradie": "^0.1.1",
-    "@agentic-kit/ollama": "^0.1.1"
+    "@agentic-kit/anthropic": "workspace:*",
+    "@agentic-kit/ollama": "workspace:*",
+    "@agentic-kit/openai": "workspace:*"
   },
-  "keywords": [],
-  "gitHead": "0204aa87ae43833af29965684146ff22ebf77564"
+  "devDependencies": {
+    "cross-fetch": "^4.1.0"
+  },
+  "keywords": []
 }