@streetjs/ai 1.0.0

package/README.md

@@ -0,0 +1,107 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/hassanmubiru/StreetJS/main/docs/assets/images/logo-512.png" alt="StreetJS logo" width="100" height="100">
+</p>
+
+# @streetjs/ai
+
+Official StreetJS Framework AI module: a **provider-agnostic** surface for LLM
+chat, embeddings, retrieval-augmented generation (RAG), and tool calling.
+
+- One `AiProvider` contract; swap implementations freely
+- Adapters: `OpenAiProvider`, `AnthropicProvider`, `OllamaProvider`
+- `FakeAiProvider` — deterministic, network-free; default for tests/offline dev
+- `RagPipeline` — embed → store → retrieve → answer (with `InMemoryVectorStore`)
+- `ChatSession` — a tool-calling loop (model requests tools, you run handlers)
+
+## Install
+
+```bash
+npm install @streetjs/ai
+```
+
+## Chat
+
+```ts
+import { OpenAiProvider } from '@streetjs/ai';
+
+const ai = new OpenAiProvider({ apiKey: process.env.OPENAI_API_KEY });
+const res = await ai.chat({ messages: [{ role: 'user', content: 'Hello!' }] });
+console.log(res.message.content, res.usage);
+```
+
+Swap providers without touching call sites:
+
+```ts
+import { AnthropicProvider, OllamaProvider } from '@streetjs/ai';
+const claude = new AnthropicProvider({ apiKey: process.env.ANTHROPIC_API_KEY });
+const local  = new OllamaProvider({ baseUrl: 'http://127.0.0.1:11434' });
+```
+
+## Embeddings + RAG
+
+```ts
+import { RagPipeline, OpenAiProvider } from '@streetjs/ai';
+
+const rag = new RagPipeline({ provider: new OpenAiProvider({ apiKey }), topK: 4 });
+await rag.index([
+  { id: 'd1', text: 'The Eiffel Tower is in Paris.' },
+  { id: 'd2', text: 'Mount Everest is the tallest mountain.' },
+]);
+const { answer, context } = await rag.answer('Where is the Eiffel Tower?');
+```
+
+## Tool calling
+
+```ts
+import { ChatSession, OpenAiProvider } from '@streetjs/ai';
+
+const session = new ChatSession({
+  provider: new OpenAiProvider({ apiKey }),
+  system: 'You can do arithmetic.',
+  tools: [{
+    name: 'add',
+    description: 'Add two numbers',
+    parameters: { type: 'object', properties: { a: { type: 'number' }, b: { type: 'number' } } },
+    handler: ({ a, b }) => Number(a) + Number(b),
+  }],
+});
+
+const { message, toolCallsExecuted } = await session.send('what is 2 + 3?');
+// session runs the tool, feeds the result back, and returns the final answer
+```
+
+## Testing without network
+
+`FakeAiProvider` is deterministic and offline. Its embeddings are hashed
+bag-of-words vectors, so lexically similar text scores higher — enough to
+exercise RAG end-to-end in tests. The HTTP adapters accept an injectable
+`fetch`, so request/response handling is unit-tested without real API calls.
+
+```ts
+import { FakeAiProvider, RagPipeline } from '@streetjs/ai';
+const rag = new RagPipeline({ provider: new FakeAiProvider() });
+```
+
+## API
+
+- Providers: `OpenAiProvider`, `AnthropicProvider`, `OllamaProvider`, `FakeAiProvider`
+- `RagPipeline` (`index`, `retrieve`, `answer`), `InMemoryVectorStore`, `cosineSimilarity`, `hashEmbedding`
+- `ChatSession` (`send`, `messages`)
+- Types: `AiProvider`, `ChatRequest/Response`, `ChatMessage`, `ToolCall`, `ToolDefinition`, `EmbedRequest/Response`
+
+## Notes
+
+- `AnthropicProvider` does not support embeddings (use OpenAI or Ollama).
+- Tool-call wiring is implemented for the OpenAI adapter; Anthropic/Ollama
+  adapters cover chat + (Ollama) embeddings. Function-calling for those is a
+  tracked follow-up.
+
+## Testing
+
+```bash
+npm run test -w packages/ai     # unit + property tests, fully offline
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,183 @@
+export type Role = 'system' | 'user' | 'assistant' | 'tool';
+/** A request from the model to invoke a tool. */
+export interface ToolCall {
+    id: string;
+    name: string;
+    /** Parsed arguments object the tool was called with. */
+    arguments: Record<string, unknown>;
+}
+/** A chat message. `toolCalls` is set on assistant turns that request tools; */
+/** `toolCallId` links a `tool` message back to the call it answers. */
+export interface ChatMessage {
+    role: Role;
+    content: string;
+    toolCalls?: ToolCall[];
+    toolCallId?: string;
+}
+/** A callable tool exposed to the model. */
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    /** JSON-schema-ish parameter description (passed through to the provider). */
+    parameters: Record<string, unknown>;
+}
+export interface TokenUsage {
+    promptTokens: number;
+    completionTokens: number;
+}
+export interface ChatRequest {
+    messages: ChatMessage[];
+    tools?: ToolDefinition[];
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+}
+export interface ChatResponse {
+    message: ChatMessage;
+    finishReason: 'stop' | 'tool_calls' | 'length';
+    usage?: TokenUsage;
+}
+export interface EmbedRequest {
+    input: string[];
+    model?: string;
+}
+export interface EmbedResponse {
+    /** One embedding vector per input, in order. */
+    embeddings: number[][];
+    usage?: TokenUsage;
+}
+/** The common provider contract. */
+export interface AiProvider {
+    readonly name: string;
+    chat(request: ChatRequest): Promise<ChatResponse>;
+    embed(request: EmbedRequest): Promise<EmbedResponse>;
+}
+/** Cosine similarity of two equal-length vectors. Returns 0 for zero vectors. */
+export declare function cosineSimilarity(a: number[], b: number[]): number;
+/**
+ * Deterministic hashed bag-of-words embedding: lexical overlap → higher cosine
+ * similarity. Not semantic, but reproducible and good enough to exercise RAG.
+ */
+export declare function hashEmbedding(text: string, dim?: number): number[];
+export interface FakeAiProviderOptions {
+    /**
+     * Optional scripted chat behaviour. Given the request, return the assistant
+     * message and finish reason. Defaults to echoing a summary of the last user
+     * message. Use this to script tool-calls in tests.
+     */
+    chatScript?: (request: ChatRequest) => ChatResponse;
+    /** Embedding dimensionality. Default 64. */
+    dim?: number;
+}
+/** Deterministic, network-free provider for tests, examples, and offline dev. */
+export declare class FakeAiProvider implements AiProvider {
+    readonly name = "fake";
+    private readonly dim;
+    private readonly chatScript;
+    constructor(options?: FakeAiProviderOptions);
+    chat(request: ChatRequest): Promise<ChatResponse>;
+    embed(request: EmbedRequest): Promise<EmbedResponse>;
+}
+export interface VectorRecord {
+    id: string;
+    text: string;
+    embedding: number[];
+    metadata?: Record<string, unknown>;
+}
+export interface ScoredRecord {
+    record: VectorRecord;
+    score: number;
+}
+/** Pluggable vector store. */
+export interface VectorStore {
+    upsert(record: VectorRecord): Promise<void>;
+    remove(id: string): Promise<boolean>;
+    /** Top-`k` records by cosine similarity to `embedding`, score-desc. */
+    query(embedding: number[], k: number): Promise<ScoredRecord[]>;
+    size(): Promise<number>;
+}
+/** In-process vector store using exact cosine similarity. */
+export declare class InMemoryVectorStore implements VectorStore {
+    private readonly records;
+    upsert(record: VectorRecord): Promise<void>;
+    remove(id: string): Promise<boolean>;
+    query(embedding: number[], k: number): Promise<ScoredRecord[]>;
+    size(): Promise<number>;
+}
+/** A document to index into a {@link RagPipeline}. */
+export interface RagDocument {
+    id: string;
+    text: string;
+    metadata?: Record<string, unknown>;
+}
+export interface RagAnswer {
+    answer: string;
+    /** The records used as context, most relevant first. */
+    context: ScoredRecord[];
+    usage?: TokenUsage;
+}
+export interface RagPipelineOptions {
+    provider: AiProvider;
+    store?: VectorStore;
+    /** Records to retrieve per query. Default 4. */
+    topK?: number;
+    /** Embedding model passed to the provider. */
+    embedModel?: string;
+    /** Chat model passed to the provider. */
+    chatModel?: string;
+}
+/** Retrieval-augmented generation: embed → store → retrieve → answer. */
+export declare class RagPipeline {
+    private readonly provider;
+    private readonly store;
+    private readonly topK;
+    private readonly embedModel;
+    private readonly chatModel;
+    constructor(options: RagPipelineOptions);
+    /** Embed and store documents for later retrieval. */
+    index(docs: RagDocument[]): Promise<void>;
+    /** Retrieve the most relevant records for `query`. */
+    retrieve(query: string, k?: number): Promise<ScoredRecord[]>;
+    /**
+     * Answer `query` grounded in retrieved context. Builds a system prompt from
+     * the top-`k` records and asks the chat model. With {@link FakeAiProvider}
+     * this is deterministic.
+     */
+    answer(query: string, k?: number): Promise<RagAnswer>;
+}
+/** A tool the model may call, paired with its executor. */
+export interface RegisteredTool extends ToolDefinition {
+    handler: (args: Record<string, unknown>) => Promise<unknown> | unknown;
+}
+export interface ChatSessionOptions {
+    provider: AiProvider;
+    tools?: RegisteredTool[];
+    system?: string;
+    model?: string;
+    /** Max provider round-trips before giving up on a tool loop. Default 5. */
+    maxIterations?: number;
+}
+export interface SendResult {
+    message: ChatMessage;
+    /** Number of tool calls executed while producing this answer. */
+    toolCallsExecuted: number;
+}
+/**
+ * A stateful chat session that drives the tool-calling loop: when the model
+ * returns `tool_calls`, the session runs the matching handlers, appends the
+ * results as `tool` messages, and re-queries until the model produces a final
+ * answer (or `maxIterations` is reached).
+ */
+export declare class ChatSession {
+    private readonly provider;
+    private readonly tools;
+    private readonly toolDefs;
+    private readonly model;
+    private readonly maxIterations;
+    readonly messages: ChatMessage[];
+    constructor(options: ChatSessionOptions);
+    /** Send a user message and resolve to the final assistant message. */
+    send(userMessage: string): Promise<SendResult>;
+}
+export * from './providers.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,227 @@
+// packages/ai/src/index.ts
+// Official Street Framework AI module: @streetjs/ai.
+//
+// A provider-agnostic surface for LLM chat, embeddings, retrieval-augmented
+// generation (RAG), and tool calling.
+//
+//   * AiProvider          — the common contract (chat + embed).
+//   * FakeAiProvider      — deterministic, dependency-free; default for tests,
+//                            examples, and offline development. Its embeddings
+//                            are hashed bag-of-words vectors, so lexical overlap
+//                            yields higher cosine similarity (RAG is meaningful
+//                            and reproducible without network access).
+//   * OpenAiProvider / AnthropicProvider / OllamaProvider — real HTTP adapters
+//                            with an injectable `fetch`, so request shaping and
+//                            response parsing are unit-testable without network.
+//   * VectorStore / InMemoryVectorStore + cosineSimilarity — vector search.
+//   * RagPipeline         — embed → store → retrieve → answer.
+//   * ChatSession         — a tool-calling loop (model requests tools, we run
+//                            registered handlers, feed results back, repeat).
+// ── Vector math ───────────────────────────────────────────────────────────────
+/** Cosine similarity of two equal-length vectors. Returns 0 for zero vectors. */
+export function cosineSimilarity(a, b) {
+    if (a.length !== b.length) {
+        throw new Error(`cosineSimilarity: dimension mismatch (${a.length} vs ${b.length})`);
+    }
+    let dot = 0;
+    let na = 0;
+    let nb = 0;
+    for (let i = 0; i < a.length; i++) {
+        dot += a[i] * b[i];
+        na += a[i] * a[i];
+        nb += b[i] * b[i];
+    }
+    if (na === 0 || nb === 0)
+        return 0;
+    return dot / (Math.sqrt(na) * Math.sqrt(nb));
+}
+// ── Deterministic fake provider ─────────────────────────────────────────────────
+const FAKE_DIM = 64;
+/** Lowercase alphanumeric tokens. */
+function tokenize(text) {
+    return text.toLowerCase().match(/[a-z0-9]+/g) ?? [];
+}
+/** Stable 32-bit FNV-1a hash. */
+function fnv1a(s) {
+    let h = 0x811c9dc5;
+    for (let i = 0; i < s.length; i++) {
+        h ^= s.charCodeAt(i);
+        h = Math.imul(h, 0x01000193);
+    }
+    return h >>> 0;
+}
+/**
+ * Deterministic hashed bag-of-words embedding: lexical overlap → higher cosine
+ * similarity. Not semantic, but reproducible and good enough to exercise RAG.
+ */
+export function hashEmbedding(text, dim = FAKE_DIM) {
+    const v = new Array(dim).fill(0);
+    for (const tok of tokenize(text)) {
+        v[fnv1a(tok) % dim] += 1;
+    }
+    return v;
+}
+/** Deterministic, network-free provider for tests, examples, and offline dev. */
+export class FakeAiProvider {
+    name = 'fake';
+    dim;
+    chatScript;
+    constructor(options = {}) {
+        this.dim = options.dim ?? FAKE_DIM;
+        this.chatScript = options.chatScript;
+    }
+    async chat(request) {
+        if (this.chatScript)
+            return this.chatScript(request);
+        const lastUser = [...request.messages].reverse().find((m) => m.role === 'user');
+        const content = lastUser ? `echo: ${lastUser.content}` : 'echo: (no user message)';
+        return {
+            message: { role: 'assistant', content },
+            finishReason: 'stop',
+            usage: { promptTokens: countTokens(request.messages), completionTokens: tokenize(content).length },
+        };
+    }
+    async embed(request) {
+        return {
+            embeddings: request.input.map((t) => hashEmbedding(t, this.dim)),
+            usage: { promptTokens: request.input.reduce((n, t) => n + tokenize(t).length, 0), completionTokens: 0 },
+        };
+    }
+}
+function countTokens(messages) {
+    return messages.reduce((n, m) => n + tokenize(m.content).length, 0);
+}
+/** In-process vector store using exact cosine similarity. */
+export class InMemoryVectorStore {
+    records = new Map();
+    async upsert(record) {
+        this.records.set(record.id, record);
+    }
+    async remove(id) {
+        return this.records.delete(id);
+    }
+    async query(embedding, k) {
+        const scored = [];
+        for (const record of this.records.values()) {
+            scored.push({ record, score: cosineSimilarity(embedding, record.embedding) });
+        }
+        scored.sort((a, b) => b.score - a.score || (a.record.id < b.record.id ? -1 : 1));
+        return scored.slice(0, Math.max(0, k));
+    }
+    async size() {
+        return this.records.size;
+    }
+}
+/** Retrieval-augmented generation: embed → store → retrieve → answer. */
+export class RagPipeline {
+    provider;
+    store;
+    topK;
+    embedModel;
+    chatModel;
+    constructor(options) {
+        if (!options?.provider)
+            throw new Error('RagPipeline: a provider is required');
+        this.provider = options.provider;
+        this.store = options.store ?? new InMemoryVectorStore();
+        this.topK = options.topK ?? 4;
+        this.embedModel = options.embedModel;
+        this.chatModel = options.chatModel;
+    }
+    /** Embed and store documents for later retrieval. */
+    async index(docs) {
+        if (docs.length === 0)
+            return;
+        const { embeddings } = await this.provider.embed({ input: docs.map((d) => d.text), model: this.embedModel });
+        await Promise.all(docs.map((d, i) => this.store.upsert({ id: d.id, text: d.text, embedding: embeddings[i], metadata: d.metadata })));
+    }
+    /** Retrieve the most relevant records for `query`. */
+    async retrieve(query, k = this.topK) {
+        const { embeddings } = await this.provider.embed({ input: [query], model: this.embedModel });
+        return this.store.query(embeddings[0], k);
+    }
+    /**
+     * Answer `query` grounded in retrieved context. Builds a system prompt from
+     * the top-`k` records and asks the chat model. With {@link FakeAiProvider}
+     * this is deterministic.
+     */
+    async answer(query, k = this.topK) {
+        const context = await this.retrieve(query, k);
+        const contextBlock = context.map((c, i) => `[${i + 1}] ${c.record.text}`).join('\n');
+        const messages = [
+            {
+                role: 'system',
+                content: 'Answer the question using only the provided context. ' +
+                    'If the context is insufficient, say so.\n\nContext:\n' + contextBlock,
+            },
+            { role: 'user', content: query },
+        ];
+        const res = await this.provider.chat({ messages, model: this.chatModel });
+        return { answer: res.message.content, context, usage: res.usage };
+    }
+}
+/**
+ * A stateful chat session that drives the tool-calling loop: when the model
+ * returns `tool_calls`, the session runs the matching handlers, appends the
+ * results as `tool` messages, and re-queries until the model produces a final
+ * answer (or `maxIterations` is reached).
+ */
+export class ChatSession {
+    provider;
+    tools;
+    toolDefs;
+    model;
+    maxIterations;
+    messages = [];
+    constructor(options) {
+        if (!options?.provider)
+            throw new Error('ChatSession: a provider is required');
+        this.provider = options.provider;
+        this.tools = new Map((options.tools ?? []).map((t) => [t.name, t]));
+        this.toolDefs = (options.tools ?? []).map(({ name, description, parameters }) => ({ name, description, parameters }));
+        this.model = options.model;
+        this.maxIterations = options.maxIterations ?? 5;
+        if (options.system)
+            this.messages.push({ role: 'system', content: options.system });
+    }
+    /** Send a user message and resolve to the final assistant message. */
+    async send(userMessage) {
+        this.messages.push({ role: 'user', content: userMessage });
+        let toolCallsExecuted = 0;
+        for (let i = 0; i < this.maxIterations; i++) {
+            const res = await this.provider.chat({
+                messages: this.messages,
+                tools: this.toolDefs.length > 0 ? this.toolDefs : undefined,
+                model: this.model,
+            });
+            this.messages.push(res.message);
+            if (res.finishReason !== 'tool_calls' || !res.message.toolCalls?.length) {
+                return { message: res.message, toolCallsExecuted };
+            }
+            // Execute each requested tool and append its result.
+            for (const call of res.message.toolCalls) {
+                toolCallsExecuted++;
+                const tool = this.tools.get(call.name);
+                let content;
+                try {
+                    if (!tool)
+                        throw new Error(`unknown tool "${call.name}"`);
+                    const result = await tool.handler(call.arguments);
+                    content = typeof result === 'string' ? result : JSON.stringify(result);
+                }
+                catch (err) {
+                    content = JSON.stringify({ error: err.message });
+                }
+                this.messages.push({ role: 'tool', content, toolCallId: call.id });
+            }
+        }
+        // Loop budget exhausted: return the last assistant message we have.
+        const lastAssistant = [...this.messages].reverse().find((m) => m.role === 'assistant');
+        return {
+            message: lastAssistant ?? { role: 'assistant', content: '' },
+            toolCallsExecuted,
+        };
+    }
+}
+export * from './providers.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@streetjs/ai",
+  "version": "1.0.0",
+  "description": "Official Street Framework AI module: provider-agnostic chat, embeddings, RAG, and tool-calling with OpenAI/Anthropic/Ollama adapters and a deterministic in-memory provider for tests.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist/index.js",
+    "dist/index.js.map",
+    "dist/index.d.ts",
+    "dist/index.d.ts.map",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "lint": "tsc --noEmit",
+    "test": "tsc && node --test dist/tests/*.test.js",
+    "example": "npm run build && node examples/index.mjs",
+    "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "keywords": [
+    "street",
+    "streetjs",
+    "street-framework",
+    "ai",
+    "llm",
+    "embeddings",
+    "rag",
+    "tool-calling",
+    "openai",
+    "anthropic",
+    "ollama"
+  ],
+  "author": "street contributors",
+  "license": "MIT",
+  "homepage": "https://hassanmubiru.github.io/StreetJS/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hassanmubiru/StreetJS.git"
+  },
+  "bugs": {
+    "url": "https://github.com/hassanmubiru/StreetJS/issues"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.2",
+    "fast-check": "^4.8.0",
+    "typescript": "^6.0.3"
+  },
+  "peerDependencies": {
+    "typescript": ">=5.0.0"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}