ai-pipeline-orchestrator 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,32 @@
+## 0.1.0 (2026-01-10)
+
+* Add AI generation capabilities with new AI handler, example implementation, and updates to package d ([e6ce00d](https://github.com/emmanuel-adu/ai-pipeline-orchestrator/commit/e6ce00d))
+* Add configuration files for editor, npm, and nvm; create CI and publish workflows; update package.js ([c2361c1](https://github.com/emmanuel-adu/ai-pipeline-orchestrator/commit/c2361c1))
+* Add content moderation, rate limiting, and context handling modules with respective configurations a ([f207aab](https://github.com/emmanuel-adu/ai-pipeline-orchestrator/commit/f207aab))
+* Add context management module with context building and optimization functionality ([023ec93](https://github.com/emmanuel-adu/ai-pipeline-orchestrator/commit/023ec93))
+* Add core orchestration module with orchestrator implementation and type definitions ([32b6400](https://github.com/emmanuel-adu/ai-pipeline-orchestrator/commit/32b6400))
+* Add example implementation for a basic chatbot using intent classification, context optimization, an ([61a4edb](https://github.com/emmanuel-adu/ai-pipeline-orchestrator/commit/61a4edb))
+* Add initial project structure with essential files ([6ddb8aa](https://github.com/emmanuel-adu/ai-pipeline-orchestrator/commit/6ddb8aa))
+* Add intent classification module with detectIntent and LLM classification functionality ([dbc8738](https://github.com/emmanuel-adu/ai-pipeline-orchestrator/commit/dbc8738))
+* add interactive chat CLI. ([a50e4f4](https://github.com/emmanuel-adu/ai-pipeline-orchestrator/commit/a50e4f4))
+* Add Prettier and ESLint configuration files, update package.json for linting and formatting scripts, ([d573b5d](https://github.com/emmanuel-adu/ai-pipeline-orchestrator/commit/d573b5d))
+* Add README.md with project overview, features, installation instructions, quick start guide, core co ([636e34b](https://github.com/emmanuel-adu/ai-pipeline-orchestrator/commit/636e34b))
+* Add streaming AI generation support ([a522b95](https://github.com/emmanuel-adu/ai-pipeline-orchestrator/commit/a522b95))
+* Add support for multiple AI providers by introducing a new provider configuration interface and mode ([e6d659e](https://github.com/emmanuel-adu/ai-pipeline-orchestrator/commit/e6d659e))
+* adjust package dependencies for ai-sdk-ollama. ([5dc6622](https://github.com/emmanuel-adu/ai-pipeline-orchestrator/commit/5dc6622))
+* adjust package.json for module exports and dependencies. ([e5e348e](https://github.com/emmanuel-adu/ai-pipeline-orchestrator/commit/e5e348e))
+* Cast model parameters to string in all handler examples for type consistency ([c10c6c3](https://github.com/emmanuel-adu/ai-pipeline-orchestrator/commit/c10c6c3))
+* Enhance documentation across various handlers and classifiers, adding descriptive comments for conte ([08c3a72](https://github.com/emmanuel-adu/ai-pipeline-orchestrator/commit/08c3a72))
+* Enhance intent detection documentation by detailing the keyword matching algorithm and scoring syste ([316f319](https://github.com/emmanuel-adu/ai-pipeline-orchestrator/commit/316f319))
+* Enhance support for DeepSeek provider by updating configuration instructions in .env.example, README ([73355e8](https://github.com/emmanuel-adu/ai-pipeline-orchestrator/commit/73355e8))
+* Introduce utility file in example folder ([5af9aa9](https://github.com/emmanuel-adu/ai-pipeline-orchestrator/commit/5af9aa9))
+* Refactor context and intent modules by removing unused exports and enhancing documentation. Update c ([fd14466](https://github.com/emmanuel-adu/ai-pipeline-orchestrator/commit/fd14466))
+* Refactor provider types to use AIProvider type across the codebase ([781f3a2](https://github.com/emmanuel-adu/ai-pipeline-orchestrator/commit/781f3a2))
+* Update .env.example and all-handlers.ts to improve environment variable configuration instructions a ([7db6923](https://github.com/emmanuel-adu/ai-pipeline-orchestrator/commit/7db6923))
+* Update .env.example and README to enhance provider configuration instructions; add dotenv dependency ([57a4193](https://github.com/emmanuel-adu/ai-pipeline-orchestrator/commit/57a4193))
+* Update .env.example, README, and examples to streamline provider configuration instructions and enha ([bec25c1](https://github.com/emmanuel-adu/ai-pipeline-orchestrator/commit/bec25c1))
+* Update dependencies for ollama-ai-provider and related packages to version 1.2.0. Improve documentat ([2d71dfe](https://github.com/emmanuel-adu/ai-pipeline-orchestrator/commit/2d71dfe))
+* Update README with comprehensive handler configuration guide ([cf76caf](https://github.com/emmanuel-adu/ai-pipeline-orchestrator/commit/cf76caf))
+
+
+

package/CONTRIBUTING.md

@@ -0,0 +1,77 @@
+# Contributing to ai-pipeline-orchestrator
+
+## Conventional Commits
+
+This project uses [Conventional Commits](https://www.conventionalcommits.org/) to automate changelog generation and semantic versioning.
+
+### Commit Message Format
+
+Each commit message consists of a **type**, optional **scope**, and **subject**:
+
+```
+<type>(<scope>): <subject>
+```
+
+### Types
+
+- **feat**: A new feature
+- **fix**: A bug fix
+- **docs**: Documentation only changes
+- **style**: Changes that don't affect code meaning (formatting, semicolons, etc)
+- **refactor**: Code refactoring (neither fixes a bug nor adds a feature)
+- **perf**: Performance improvements
+- **test**: Adding or updating tests
+- **chore**: Maintenance tasks (dependencies, build config, etc)
+- **ci**: CI/CD configuration changes
+- **build**: Build system or external dependency changes
+
+### Examples
+
+```bash
+# Adding a new feature
+git commit -m "feat(intent): add support for multi-language classification"
+
+# Fixing a bug
+git commit -m "fix(streaming): resolve token counting issue with Ollama"
+
+# Documentation update
+git commit -m "docs(readme): add Ollama setup instructions"
+
+# Breaking change (adds BREAKING CHANGE footer)
+git commit -m "feat(handlers)!: change handler signature to async
+
+BREAKING CHANGE: All handlers must now return Promises"
+
+# Chore task
+git commit -m "chore(deps): upgrade ai-sdk to v6.1.0"
+```
+
+### Scopes
+
+Common scopes:
+- `core` - orchestration pipeline
+- `intent` - intent classification
+- `context` - context optimization
+- `handlers` - handler functions
+- `providers` - AI provider integration
+- `examples` - example code
+- `deps` - dependencies
+- `ci` - CI/CD
+
+### Commit Linting
+
+Commits are automatically validated using commitlint. Invalid commits will be rejected.
+
+### Changelog Generation
+
+The CHANGELOG is auto-generated from commits:
+
+```bash
+# Generate changelog for new commits since last release
+npm run changelog
+
+# Regenerate entire changelog
+npm run changelog:init
+```
+
+The changelog is automatically updated during the publish process.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Emmanuel Adu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,466 @@
+<div align="center">
+
+# AI Pipeline Orchestrator
+
+Build production-ready AI chatbots with composable handler pipelines. Handles intent detection, context optimization, token management, rate limiting, and moderation out of the box.
+
+[![npm version](https://img.shields.io/npm/v/ai-pipeline-orchestrator.svg)](https://www.npmjs.com/package/ai-pipeline-orchestrator)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-blue.svg)](https://www.typescriptlang.org/)
+
+</div>
+
+---
+
+<p align="center">
+  <img src="./assets/demo.gif" alt="AI Pipeline Orchestrator Demo" width="900">
+</p>
+
+<p align="center">
+  <em>Interactive CLI demo showcasing hybrid intent detection, context optimization, and real-time streaming</em><br>
+  <a href="#demo-screenshots">View detailed screenshot</a>
+</p>
+
+---
+
+## Features
+
+| Feature | Description |
+|---------|-------------|
+| **Sequential Pipelines** | Compose handlers that run in order with automatic error handling |
+| **Hybrid Intent Detection** | Keyword matching (fast, free) → LLM fallback (accurate, paid) |
+| **Context Optimization** | Load only relevant context based on intent (30-50% token savings) |
+| **Multi-Provider** | Works with Anthropic, OpenAI, or Ollama (local/cloud) |
+| **Production Ready** | Rate limiting, moderation, logging, error handling built-in |
+| **TypeScript** | Full type safety with minimal dependencies (just Zod) |
+
+## Installation
+
+```bash
+npm install ai-pipeline-orchestrator
+```
+
+Install a provider SDK:
+
+```bash
+# Anthropic (recommended)
+npm install @ai-sdk/anthropic ai
+
+# OpenAI
+npm install @ai-sdk/openai ai
+
+# Ollama (free, local/cloud)
+npm install ai-sdk-ollama ai
+```
+
+## Quick Start
+
+```typescript
+import { executeOrchestration, createAIHandler } from 'ai-pipeline-orchestrator'
+
+const result = await executeOrchestration(
+  {
+    request: {
+      messages: [{ role: 'user', content: 'Tell me a joke' }],
+    },
+  },
+  [
+    {
+      name: 'ai',
+      handler: createAIHandler({
+        provider: 'anthropic',
+        model: 'claude-3-5-haiku-20241022',
+        apiKey: process.env.ANTHROPIC_API_KEY,
+        getSystemPrompt: () => 'You are a helpful assistant.',
+      }),
+    },
+  ]
+)
+
+console.log(result.context.aiResponse.text)
+```
+
+## Providers
+
+### Supported Providers
+
+| Provider | Package | Models | API Key | Best For |
+|----------|---------|--------|---------|----------|
+| **Anthropic** | `@ai-sdk/anthropic` | `claude-3-5-haiku-20241022`<br/>`claude-3-5-sonnet-20241022` | [Get key](https://console.anthropic.com) | Production, high-quality responses |
+| **OpenAI** | `@ai-sdk/openai` | `gpt-4o-mini`<br/>`gpt-4o` | [Get key](https://platform.openai.com) | Production, wide model selection |
+| **Ollama** | `ai-sdk-ollama` | `llama3.2`, `deepseek-r1`, `qwen2.5`<br/>100+ more | Optional ([Cloud](https://ollama.com)) | Development, cost savings, offline |
+
+### Provider Setup
+
+<details>
+<summary><strong>Anthropic / OpenAI</strong></summary>
+
+```bash
+# .env
+AI_PROVIDER=anthropic
+AI_MODEL=claude-3-5-haiku-20241022
+ANTHROPIC_API_KEY=your-key-here
+```
+
+</details>
+
+<details>
+<summary><strong>Ollama Local</strong></summary>
+
+```bash
+# Install and run
+curl -fsSL https://ollama.com/install.sh | sh
+ollama serve
+ollama pull llama3.2
+
+# .env
+AI_PROVIDER=ollama
+AI_MODEL=llama3.2:latest
+OLLAMA_BASE_URL=http://localhost:11434
+```
+
+</details>
+
+<details>
+<summary><strong>Ollama Cloud (Free Tier)</strong></summary>
+
+```bash
+# .env
+AI_PROVIDER=ollama
+AI_MODEL=llama3.2:latest
+OLLAMA_BASE_URL=https://ollama.com
+OLLAMA_API_KEY=your-key-here  # Get from https://ollama.com
+```
+
+</details>
+
+<details>
+<summary><strong>💡 Hybrid Setup (Recommended)</strong></summary>
+
+Use a cloud provider for chat (best quality) + Ollama for intent classification (free):
+
+```bash
+# .env
+AI_PROVIDER=anthropic
+AI_MODEL=claude-3-5-haiku-20241022
+ANTHROPIC_API_KEY=your-key-here
+
+INTENT_PROVIDER=ollama
+INTENT_MODEL=deepseek-r1:latest
+OLLAMA_BASE_URL=http://localhost:11434
+```
+
+This gives you high-quality chat responses with zero-cost intent classification.
+
+</details>
+
+## Usage
+
+### Pipeline Orchestration
+
+Handlers run sequentially, passing context between them:
+
+```typescript
+import {
+  executeOrchestration,
+  createModerationHandler,
+  createIntentHandler,
+  createContextHandler,
+  createAIHandler,
+} from 'ai-pipeline-orchestrator'
+
+const result = await executeOrchestration(
+  context,
+  [
+    { name: 'moderation', handler: createModerationHandler() },
+    { name: 'intent', handler: createIntentHandler({ classifier }) },
+    { name: 'context', handler: createContextHandler({ optimizer }) },
+    { name: 'ai', handler: createAIHandler({ provider, model, apiKey }) },
+  ],
+  {
+    logger: myLogger,
+    onStepComplete: (step, duration) => console.log(`${step}: ${duration}ms`),
+  }
+)
+```
+
+If any handler sets `context.error` or throws, the pipeline stops.
+
+### Handlers
+
+#### Content Moderation
+
+```typescript
+import { createModerationHandler } from 'ai-pipeline-orchestrator'
+
+const handler = createModerationHandler({
+  spamPatterns: ['buy now', 'click here'],
+  customRules: [{ pattern: /badword/i, reason: 'Profanity detected' }],
+})
+```
+
+#### Rate Limiting
+
+Bring your own rate limiter (Upstash, Redis, etc):
+
+```typescript
+import { createRateLimitHandler } from 'ai-pipeline-orchestrator'
+
+const handler = createRateLimitHandler({
+  limiter: {
+    check: async (id) => ({
+      allowed: await checkLimit(id),
+      retryAfter: 60, // seconds
+    }),
+  },
+  identifierKey: 'userId',
+})
+```
+
+#### Intent Detection
+
+Three modes: keyword-only, LLM-only, or hybrid.
+
+<details>
+<summary><strong>Keyword-based</strong> (fast, free)</summary>
+
+```typescript
+import { IntentClassifier, createIntentHandler } from 'ai-pipeline-orchestrator'
+
+const classifier = new IntentClassifier({
+  patterns: [
+    { category: 'greeting', keywords: ['hello', 'hi', 'hey'] },
+    { category: 'help', keywords: ['help', 'support'] },
+  ],
+})
+
+const handler = createIntentHandler({ classifier })
+```
+
+</details>
+
+<details>
+<summary><strong>LLM-based</strong> (accurate, paid)</summary>
+
+```typescript
+import { LLMIntentClassifier, createIntentHandler } from 'ai-pipeline-orchestrator'
+
+const classifier = new LLMIntentClassifier({
+  provider: 'anthropic',
+  model: 'claude-3-5-haiku-20241022',
+  apiKey: process.env.ANTHROPIC_API_KEY,
+  categories: ['greeting', 'help', 'question'],
+  categoryDescriptions: {
+    greeting: 'User says hello',
+    help: 'User needs help',
+    question: 'User asks a question',
+  },
+})
+
+const handler = createIntentHandler({ classifier })
+```
+
+</details>
+
+<details>
+<summary><strong>Hybrid</strong> (best of both)</summary>
+
+```typescript
+const handler = createIntentHandler({
+  classifier: keywordClassifier,
+  llmFallback: {
+    enabled: true,
+    classifier: llmClassifier,
+    confidenceThreshold: 0.5, // use LLM if keyword confidence < 0.5
+  },
+})
+```
+
+</details>
+
+#### Context Optimization
+
+Load only relevant context based on intent:
+
+```typescript
+import { ContextOptimizer, createContextHandler } from 'ai-pipeline-orchestrator'
+
+const optimizer = new ContextOptimizer({
+  sections: [
+    {
+      id: 'core',
+      content: 'You are a helpful assistant.',
+      alwaysInclude: true,
+    },
+    {
+      id: 'help',
+      content: 'Help documentation...',
+      topics: ['help', 'support'],
+    },
+  ],
+  strategy: {
+    firstMessage: 'full',
+    followUp: 'selective',
+  },
+})
+
+const handler = createContextHandler({
+  optimizer,
+  getTopics: (ctx) => [ctx.intent?.intent],
+})
+```
+
+#### AI Generation
+
+<details>
+<summary><strong>Non-streaming</strong></summary>
+
+```typescript
+import { createAIHandler } from 'ai-pipeline-orchestrator'
+
+const handler = createAIHandler({
+  provider: 'anthropic',
+  model: 'claude-3-5-sonnet-20241022',
+  apiKey: process.env.ANTHROPIC_API_KEY,
+  temperature: 0.7,
+  maxTokens: 1024,
+  getSystemPrompt: (ctx) => ctx.promptContext?.systemPrompt || 'You are a helpful assistant.',
+})
+```
+
+</details>
+
+<details>
+<summary><strong>Streaming</strong></summary>
+
+```typescript
+import { createStreamingAIHandler } from 'ai-pipeline-orchestrator'
+
+const handler = createStreamingAIHandler({
+  provider: 'anthropic',
+  model: 'claude-3-5-sonnet-20241022',
+  apiKey: process.env.ANTHROPIC_API_KEY,
+  onChunk: (chunk) => sendToClient(chunk),
+})
+
+// Full text still available after streaming
+console.log(result.context.aiResponse.text)
+```
+
+</details>
+
+#### Custom Handlers
+
+```typescript
+import { OrchestrationHandler } from 'ai-pipeline-orchestrator'
+
+const authHandler: OrchestrationHandler = async (context) => {
+  const userId = context.request.metadata?.userId
+
+  if (!userId) {
+    return {
+      ...context,
+      error: {
+        message: 'Authentication required',
+        statusCode: 401,
+        step: 'auth',
+      },
+    }
+  }
+
+  return { ...context, user: await fetchUser(userId) }
+}
+```
+
+## Try the Interactive Demo
+
+```bash
+git clone https://github.com/emmanuel-adu/ai-pipeline-orchestrator.git
+cd ai-pipeline-orchestrator
+npm install
+
+# Configure (copy .env.example to .env and add your API key)
+cp .env.example .env
+
+# Run the demo
+npm run example:chat
+```
+
+The demo showcases all features in real-time:
+
+- Content moderation
+- Rate limiting
+- Hybrid intent classification
+- Context optimization (30-50% token savings)
+- Real-time streaming
+- Token usage breakdown
+
+## API Reference
+
+### Core
+
+| Export | Description |
+|--------|-------------|
+| `executeOrchestration(context, steps, config?)` | Run the pipeline |
+| `Orchestrator` | Class-based version for stateful pipelines |
+| `OrchestrationHandler` | Handler function type |
+| `OrchestrationContext` | Context object passed between handlers |
+
+### Intent
+
+| Export | Description |
+|--------|-------------|
+| `IntentClassifier` | Keyword-based detection |
+| `LLMIntentClassifier` | LLM-based detection with structured output |
+| `createIntentHandler(config)` | Creates intent handler |
+
+### Context
+
+| Export | Description |
+|--------|-------------|
+| `ContextOptimizer` | Smart context selection |
+| `createContextHandler(config)` | Creates context handler |
+
+### AI
+
+| Export | Description |
+|--------|-------------|
+| `createAIHandler(config)` | Text generation |
+| `createStreamingAIHandler(config)` | Streaming generation |
+
+### Utilities
+
+| Export | Description |
+|--------|-------------|
+| `createRateLimitHandler(config)` | Rate limiting |
+| `createModerationHandler(config)` | Content moderation |
+
+## Examples
+
+Check out the [examples](./examples) directory:
+
+- [`basic-chatbot.ts`](./examples/basic-chatbot.ts) - Minimal working example
+- [`complete-chatbot.ts`](./examples/complete-chatbot.ts) - All features combined
+- [`streaming-chatbot.ts`](./examples/streaming-chatbot.ts) - Streaming responses
+- [`chat-cli.ts`](./examples/chat-cli.ts) - Interactive CLI demo
+
+### Demo Screenshots
+
+<details>
+<summary>📸 Click to see detailed CLI output</summary>
+
+<p align="center">
+  <img src="./assets/demo_image.png" alt="CLI Demo Screenshot" width="800">
+</p>
+
+*The interactive CLI displays real-time metadata including moderation status, rate limits, intent classification, context optimization savings, and token usage for full transparency.*
+
+</details>
+
+## Contributing
+
+Contributions are welcome! Please read [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.
+
+## License
+
+MIT © [Emmanuel Adu](https://github.com/emmanuel-adu)

package/dist/context/index.cjs

@@ -0,0 +1,75 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/context/index.ts
+var context_exports = {};
+__export(context_exports, {
+  ContextOptimizer: () => ContextOptimizer
+});
+module.exports = __toCommonJS(context_exports);
+
+// src/context/optimizer.ts
+function buildContext(topics, isFirstMessage, config) {
+  const { sections, strategy } = config;
+  const useFullContext = isFirstMessage && strategy?.firstMessage !== "selective" || !isFirstMessage && strategy?.followUp === "full";
+  let selectedSections;
+  if (useFullContext) {
+    selectedSections = sections;
+  } else {
+    selectedSections = sections.filter((section) => {
+      if (section.alwaysInclude) return true;
+      if (!section.topics || section.topics.length === 0) return false;
+      return section.topics.some((topic) => topics.includes(topic));
+    });
+    selectedSections.sort((a, b) => (b.priority || 0) - (a.priority || 0));
+  }
+  const systemPrompt = selectedSections.map((section) => section.content).join("\n\n");
+  const tokenEstimate = Math.ceil(systemPrompt.length / 4);
+  const allSectionsPrompt = sections.map((section) => section.content).join("\n\n");
+  const maxTokenEstimate = Math.ceil(allSectionsPrompt.length / 4);
+  return {
+    systemPrompt,
+    sectionsIncluded: selectedSections.map((s) => s.id),
+    totalSections: sections.length,
+    tokenEstimate,
+    maxTokenEstimate
+  };
+}
+var ContextOptimizer = class {
+  constructor(config) {
+    this.config = config;
+  }
+  build(topics, isFirstMessage) {
+    return buildContext(topics, isFirstMessage, this.config);
+  }
+  addSection(section) {
+    this.config.sections.push(section);
+  }
+  removeSection(id) {
+    this.config.sections = this.config.sections.filter((s) => s.id !== id);
+  }
+  getSections() {
+    return [...this.config.sections];
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ContextOptimizer
+});
+//# sourceMappingURL=index.cjs.map

package/dist/context/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/context/index.ts","../../src/context/optimizer.ts"],"sourcesContent":["export { ContextOptimizer } from './optimizer'\nexport type { ContextSection, ContextStrategy, ContextConfig, ContextResult } from './types'\n","import type { ContextConfig, ContextResult, ContextSection } from './types'\n\nfunction buildContext(\n  topics: string[],\n  isFirstMessage: boolean,\n  config: ContextConfig\n): ContextResult {\n  const { sections, strategy } = config\n\n  const useFullContext =\n    (isFirstMessage && strategy?.firstMessage !== 'selective') ||\n    (!isFirstMessage && strategy?.followUp === 'full')\n\n  let selectedSections: ContextSection[]\n\n  if (useFullContext) {\n    selectedSections = sections\n  } else {\n    selectedSections = sections.filter(section => {\n      if (section.alwaysInclude) return true\n\n      if (!section.topics || section.topics.length === 0) return false\n\n      return section.topics.some(topic => topics.includes(topic))\n    })\n\n    selectedSections.sort((a, b) => (b.priority || 0) - (a.priority || 0))\n  }\n\n  const systemPrompt = selectedSections.map(section => section.content).join('\\n\\n')\n\n  // Calculate token estimates\n  const tokenEstimate = Math.ceil(systemPrompt.length / 4)\n\n  // Calculate what tokens WOULD be if all sections were loaded (for savings calculation)\n  const allSectionsPrompt = sections.map(section => section.content).join('\\n\\n')\n  const maxTokenEstimate = Math.ceil(allSectionsPrompt.length / 4)\n\n  return {\n    systemPrompt,\n    sectionsIncluded: selectedSections.map(s => s.id),\n    totalSections: sections.length,\n    tokenEstimate,\n    maxTokenEstimate,\n  }\n}\n\n/**\n * Dynamic context optimizer for token reduction.\n * Selectively loads context sections based on topics and message position.\n */\nexport class ContextOptimizer {\n  constructor(private config: ContextConfig) {}\n\n  build(topics: string[], isFirstMessage: boolean): ContextResult {\n    return buildContext(topics, isFirstMessage, this.config)\n  }\n\n  addSection(section: ContextSection): void {\n    this.config.sections.push(section)\n  }\n\n  removeSection(id: string): void {\n    this.config.sections = this.config.sections.filter(s => s.id !== id)\n  }\n\n  getSections(): ContextSection[] {\n    return [...this.config.sections]\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACEA,SAAS,aACP,QACA,gBACA,QACe;AACf,QAAM,EAAE,UAAU,SAAS,IAAI;AAE/B,QAAM,iBACH,kBAAkB,UAAU,iBAAiB,eAC7C,CAAC,kBAAkB,UAAU,aAAa;AAE7C,MAAI;AAEJ,MAAI,gBAAgB;AAClB,uBAAmB;AAAA,EACrB,OAAO;AACL,uBAAmB,SAAS,OAAO,aAAW;AAC5C,UAAI,QAAQ,cAAe,QAAO;AAElC,UAAI,CAAC,QAAQ,UAAU,QAAQ,OAAO,WAAW,EAAG,QAAO;AAE3D,aAAO,QAAQ,OAAO,KAAK,WAAS,OAAO,SAAS,KAAK,CAAC;AAAA,IAC5D,CAAC;AAED,qBAAiB,KAAK,CAAC,GAAG,OAAO,EAAE,YAAY,MAAM,EAAE,YAAY,EAAE;AAAA,EACvE;AAEA,QAAM,eAAe,iBAAiB,IAAI,aAAW,QAAQ,OAAO,EAAE,KAAK,MAAM;AAGjF,QAAM,gBAAgB,KAAK,KAAK,aAAa,SAAS,CAAC;AAGvD,QAAM,oBAAoB,SAAS,IAAI,aAAW,QAAQ,OAAO,EAAE,KAAK,MAAM;AAC9E,QAAM,mBAAmB,KAAK,KAAK,kBAAkB,SAAS,CAAC;AAE/D,SAAO;AAAA,IACL;AAAA,IACA,kBAAkB,iBAAiB,IAAI,OAAK,EAAE,EAAE;AAAA,IAChD,eAAe,SAAS;AAAA,IACxB;AAAA,IACA;AAAA,EACF;AACF;AAMO,IAAM,mBAAN,MAAuB;AAAA,EAC5B,YAAoB,QAAuB;AAAvB;AAAA,EAAwB;AAAA,EAE5C,MAAM,QAAkB,gBAAwC;AAC9D,WAAO,aAAa,QAAQ,gBAAgB,KAAK,MAAM;AAAA,EACzD;AAAA,EAEA,WAAW,SAA+B;AACxC,SAAK,OAAO,SAAS,KAAK,OAAO;AAAA,EACnC;AAAA,EAEA,cAAc,IAAkB;AAC9B,SAAK,OAAO,WAAW,KAAK,OAAO,SAAS,OAAO,OAAK,EAAE,OAAO,EAAE;AAAA,EACrE;AAAA,EAEA,cAAgC;AAC9B,WAAO,CAAC,GAAG,KAAK,OAAO,QAAQ;AAAA,EACjC;AACF;","names":[]}