@fllf/agent-sdk 0.1.0 → 0.1.2

package/README.md

@@ -1,240 +1,548 @@
-# FAgent
-
-FAgent is a composable TypeScript foundation for building Agent runtimes.
-
-It provides the shared building blocks for an Agent instead of forcing users to subclass a base class. An Agent is assembled from an LLM, session-scoped message history, tools, config, and an executor.
-
-## Status
-
-The project is in an early runtime-foundation stage. The core architecture is in place:
-
-- Composable `Agent`
-- Unified `LLM.chat()` interface
-- OpenAI and local OpenAI-compatible providers
-- Streaming support through `LLM.stream()`
-- Timeout, retry, abort, and normalized LLM errors
-- `generateObject()` structured output with Zod validation
-- Session-scoped message history with an in-memory store
-- Simple chat and tool-calling executors
-- Zod-driven tool system
-- Optional observer events for debugging and tracing
-
-## Install
-
-```bash
-npm install
-```
-
-## Scripts
-
-```bash
-npm test
-npm run typecheck
-npm run build
-```
-
-Examples:
-
-```bash
-npm run example:simple-chat
-npm run example:tool-calling
-npm run example:local-ollama
-```
-
-## Environment
-
-OpenAI:
-
-```bash
-OPENAI_API_KEY=...
-OPENAI_MODEL=gpt-4o-mini
-```
-
-Local OpenAI-compatible runtime, such as Ollama, LM Studio, vLLM, or compatible services:
-
-```bash
-LOCAL_BASE_URL=http://127.0.0.1:11434/v1
-LOCAL_MODEL=llama3
-LOCAL_API_KEY=local-key
-```
-
-If no OpenAI key is configured, FAgent falls back to the local provider.
-
-## Basic Usage
-
-```ts
-import { Agent } from 'fagent';
-
-const agent = new Agent({
-  name: 'simple-chat',
-  systemPrompt: 'You are a concise assistant.',
-});
-
-const result = await agent.run('What is FAgent?');
-console.log(result.output);
-```
-
-## Sessions
-
-FAgent uses LangChain-style session-scoped message history. The `Agent` is the reusable runtime, and `sessionId` selects the conversation context.
-
-```ts
-const agent = new Agent({
-  name: 'support-bot',
-  systemPrompt: 'You are a helpful support assistant.',
-});
-
-await agent.run('Hi, I need help with an order.', {
-  sessionId: 'session_a',
-});
-
-await agent.run('Start a separate conversation.', {
-  sessionId: 'session_b',
-});
-```
-
-Runs from different sessions can proceed concurrently. Runs for the same session are serialized so the conversation history stays ordered.
-
-If `sessionId` is omitted or blank, FAgent uses the shared `default` session. For production apps where every request should belong to an explicit user, tenant, or conversation, enable strict session ids:
-
-```ts
-const agent = new Agent({
-  name: 'support-bot',
-  requireSessionId: true,
-});
-
-await agent.run('Hi, I need help with an order.', {
-  sessionId: 'user_123:order_456',
-});
-```
-
-With `requireSessionId: true`, `run`, `addMessage`, `clearHistory`, and `getHistory` reject missing or blank session ids instead of falling back to `default`.
-
-Recoverable tool failures stay inside the agent loop: FAgent records the failure as a `tool` message, sends it back to the model, and commits the full turn if the executor completes successfully. If the run cannot continue because the model/provider fails before producing a response, FAgent leaves that session's history unchanged and reports the failure through runtime events such as `agent:error` and `llm:error`.
-
-For the built-in `InMemoryMessageHistoryStore`, `clear(sessionId)` empties a session while keeping its history entry alive. Use `deleteSession(sessionId)` to release one session entry, or `clearAll()` to release every in-memory session entry.
-
-## Tool Calling
-
-Tools are defined with Zod schemas. The framework turns the schema into an OpenAI-compatible tool schema and validates model-supplied arguments before running the tool.
-
-```ts
-import { z } from 'zod';
-import { Agent, Tool, ToolCallingExecutor } from 'fagent';
-
-const AddToolSchema = z.object({
-  left: z.number().describe('Left number.'),
-  right: z.number().describe('Right number.'),
-});
-
-class AddTool extends Tool<typeof AddToolSchema, number> {
-  constructor() {
-    super({
-      name: 'add',
-      description: 'Adds two numbers.',
-      schema: AddToolSchema,
-    });
-  }
-
-  protected run(input: z.infer<typeof AddToolSchema>): number {
-    return input.left + input.right;
-  }
-}
-
-const agent = new Agent({
-  name: 'tool-agent',
-  tools: [new AddTool()],
-  executor: new ToolCallingExecutor(),
-});
-
-const result = await agent.run('Use the add tool to calculate 19 + 23.');
-console.log(result.output);
-```
-
-## Structured Output
-
-```ts
-import { z } from 'zod';
-import { LLM } from 'fagent';
-
-const llm = new LLM();
-
-const result = await llm.generateObject({
-  messages: [
-    { role: 'user', content: 'Return a short project summary.' },
-  ],
-  schema: z.object({
-    summary: z.string(),
-    confidence: z.number(),
-  }),
-});
-
-console.log(result.value);
-```
-
-## Observability
-
-FAgent emits structured runtime events, but it does not print anything by default. Pass an observer when you want to debug or forward events to a logging system.
-
-```ts
-import { Agent, ConsoleObserver } from 'fagent';
-
-const agent = new Agent({
-  name: 'debug-agent',
-  observer: new ConsoleObserver(),
-});
-
-await agent.run('Hello');
-```
-
-Events include:
-
-- `agent:start`
-- `agent:end`
-- `agent:error`
-- `llm:start`
-- `llm:end`
-- `llm:error`
-- `tool:start`
-- `tool:end`
-- `tool:error`
-
-Custom observers can send events anywhere:
-
-```ts
-const observer = {
-  onEvent(event) {
-    myLogger.info(event);
-  },
-};
-```
-
-## Architecture
-
-```txt
-Agent
-  -> Executor
-      -> LLM
-      -> MessageHistory(sessionId)
-      -> ToolRegistry
-      -> ToolExecutor
-```
-
-Main responsibilities:
-
-- `Agent`: assembles runtime components and delegates execution.
-- `Executor`: controls the run strategy, such as simple chat or tool calling.
-- `LLM`: provides a unified model interface with timeout, retry, abort, and structured output support.
-- `Provider`: adapts OpenAI-compatible SDK calls to the unified LLM interface.
-- `MessageHistoryStore`: stores conversation history by `sessionId`.
-- `Tool`: defines external capabilities with Zod schemas.
-
-## Public Entry
-
-All public APIs are exported from:
-
-```ts
-import { Agent, LLM, Tool } from 'fagent';
-```
-
-During local development, examples import from `../src` so they can run without building first.
+# FAgent Agent SDK
+
+FAgent is a composable TypeScript SDK for building LLM agents, tool-calling
+workflows, and RAG-powered chat systems.
+
+The published npm package is:
+
+```bash
+npm install @fllf/agent-sdk
+```
+
+Use it as the runtime core behind a web chat product, backend API, worker, or
+third-party integration layer. The SDK does not include a web UI, database
+migrations for your application, authentication, or deployment code.
+
+## Capabilities
+
+- Composable `Agent` runtime.
+- Unified `LLM.chat()` interface.
+- OpenAI and OpenAI-compatible local providers.
+- Streaming through `LLM.stream()`.
+- Timeout, retry, abort, and normalized LLM errors.
+- `generateObject()` structured output with Zod validation.
+- Session-scoped message history.
+- Simple chat, tool-calling, and RAG executors.
+- Zod-driven tool definitions.
+- RAG ingestion, chunking, embedding, retrieval, reranking, context building,
+  generation, and verification.
+- In-memory stores for development and tests.
+- Postgres RAG store adapters that work with any compatible `query()` client.
+- Observer events for logging, tracing, and debugging.
+
+## Runtime requirements
+
+- Node.js 18 or newer.
+- TypeScript is recommended for typed integration.
+- Install optional document conversion dependencies only if you use those
+  loaders:
+  - HTML: `turndown`, `turndown-plugin-gfm`
+  - DOCX: `mammoth`
+  - PDF: `pdf-parse`
+
+## Environment variables
+
+OpenAI:
+
+```bash
+OPENAI_API_KEY=...
+OPENAI_MODEL=gpt-4o-mini
+OPENAI_BASE_URL=https://api.openai.com/v1
+OPENAI_EMBEDDING_MODEL=text-embedding-3-small
+```
+
+OpenAI-compatible local runtime, such as Ollama, LM Studio, vLLM, or a gateway:
+
+```bash
+LOCAL_BASE_URL=http://127.0.0.1:11434/v1
+LOCAL_MODEL=llama3
+LOCAL_API_KEY=local-key
+```
+
+If no OpenAI key is configured, the default `LLM` auto-detection falls back to
+the local OpenAI-compatible provider.
+
+`OPENAI_BASE_URL` also applies to `OpenAIEmbedder`. For OpenAI-compatible
+embedding providers, configure it as the API root, for example
+`https://gateway.example.test/v1`; the SDK posts embedding requests to
+`{OPENAI_BASE_URL}/embeddings`.
+
+## Basic chat integration
+
+```ts
+import { Agent } from '@fllf/agent-sdk';
+
+const agent = new Agent({
+  name: 'support-chat',
+  systemPrompt: 'You are a concise support assistant.',
+  requireSessionId: true,
+});
+
+const result = await agent.run('How do I reset my password?', {
+  sessionId: 'tenant_1:user_42:conversation_1001',
+  metadata: {
+    tenantId: 'tenant_1',
+    userId: 'user_42',
+  },
+});
+
+console.log(result.output);
+```
+
+### Suggested HTTP contract
+
+Your API layer owns authentication, authorization, persistence, rate limits, and
+request validation. A typical chat endpoint can adapt incoming requests to
+`Agent.run()`:
+
+```ts
+import { Agent } from '@fllf/agent-sdk';
+
+const agent = new Agent({
+  name: 'web-chat',
+  requireSessionId: true,
+});
+
+export async function handleChatRequest(body: {
+  conversationId: string;
+  userId: string;
+  tenantId: string;
+  message: string;
+}) {
+  const sessionId = `${body.tenantId}:${body.userId}:${body.conversationId}`;
+
+  const result = await agent.run(body.message, {
+    sessionId,
+    metadata: {
+      tenantId: body.tenantId,
+      userId: body.userId,
+    },
+  });
+
+  return {
+    message: result.output,
+    usage: result.usage,
+  };
+}
+```
+
+Recommended request body:
+
+```json
+{
+  "conversationId": "conversation_1001",
+  "userId": "user_42",
+  "tenantId": "tenant_1",
+  "message": "How do I reset my password?"
+}
+```
+
+Recommended response body:
+
+```json
+{
+  "message": "Open the account settings page and choose Reset password.",
+  "usage": {
+    "promptTokens": 120,
+    "completionTokens": 30,
+    "totalTokens": 150
+  }
+}
+```
+
+## Sessions and message history
+
+`Agent` is reusable. `sessionId` selects a conversation context.
+
+```ts
+await agent.run('Hi', { sessionId: 'tenant_1:user_42:conversation_a' });
+await agent.run('Start another conversation', {
+  sessionId: 'tenant_1:user_42:conversation_b',
+});
+```
+
+Runs from different sessions can proceed concurrently. Runs for the same session
+are serialized so message order remains stable.
+
+For production APIs, set `requireSessionId: true` and pass an explicit
+tenant/user/conversation scoped session id. The built-in
+`InMemoryMessageHistoryStore` is suitable for development and tests. Production
+systems should provide a persistent `MessageHistoryStore`.
+
+## Tool calling
+
+Tools are defined with Zod schemas. The SDK converts the schema into an
+OpenAI-compatible tool schema and validates model-supplied arguments before
+running the tool.
+
+```ts
+import { z } from 'zod';
+import { Agent, Tool, ToolCallingExecutor } from '@fllf/agent-sdk';
+
+const AddToolSchema = z.object({
+  left: z.number().describe('Left number.'),
+  right: z.number().describe('Right number.'),
+});
+
+class AddTool extends Tool<typeof AddToolSchema, number> {
+  constructor() {
+    super({
+      name: 'add',
+      description: 'Adds two numbers.',
+      schema: AddToolSchema,
+    });
+  }
+
+  protected run(input: z.infer<typeof AddToolSchema>): number {
+    return input.left + input.right;
+  }
+}
+
+const agent = new Agent({
+  name: 'tool-agent',
+  executor: new ToolCallingExecutor(),
+  tools: [new AddTool()],
+  requireSessionId: true,
+});
+
+const result = await agent.run('Calculate 19 + 23 with the tool.', {
+  sessionId: 'tenant_1:user_42:conversation_tools',
+});
+
+console.log(result.output);
+```
+
+## RAG integration
+
+RAG is exposed as an independent subsystem. Agent code only depends on
+`RagPipeline` through either:
+
+- `RagExecutor`: always retrieve before answering. Use this for knowledge-base
+  QA.
+- `RagSearchTool`: let a tool-calling agent retrieve evidence only when the
+  model decides it needs knowledge-base context.
+
+### Build an in-memory RAG pipeline
+
+This example is suitable for local development, tests, or a minimal MVP. Replace
+the stores with Postgres, pgvector, Qdrant, Elasticsearch, or your own adapters
+for production.
+
+```ts
+import {
+  AutoChunker,
+  AutoDocumentLoader,
+  DefaultContextBuilder,
+  DefaultDocumentNormalizer,
+  DefaultRagGenerator,
+  DefaultRagPipeline,
+  DenseRetriever,
+  HybridRetriever,
+  InMemoryDocumentStore,
+  InMemoryKeywordStore,
+  InMemoryVectorStore,
+  OpenAIEmbedder,
+  RuleBasedVerifier,
+  SparseRetriever,
+} from '@fllf/agent-sdk';
+
+const documentStore = new InMemoryDocumentStore();
+const keywordStore = new InMemoryKeywordStore();
+const embedder = new OpenAIEmbedder();
+const vectorStore = new InMemoryVectorStore({
+  dimensions: embedder.dimensions,
+});
+
+const denseRetriever = new DenseRetriever({
+  embedder,
+  vectorStore,
+  documentStore,
+});
+
+const sparseRetriever = new SparseRetriever({
+  keywordStore,
+  documentStore,
+});
+
+export const ragPipeline = new DefaultRagPipeline({
+  loader: new AutoDocumentLoader(),
+  normalizer: new DefaultDocumentNormalizer(),
+  chunker: new AutoChunker(),
+  embedder,
+  documentStore,
+  vectorStore,
+  keywordStore,
+  retriever: new HybridRetriever({
+    denseRetriever,
+    sparseRetriever,
+  }),
+  contextBuilder: new DefaultContextBuilder({
+    maxContextTokens: 3000,
+  }),
+  generator: new DefaultRagGenerator(),
+  verifier: new RuleBasedVerifier(),
+});
+```
+
+`OpenAIEmbedder` and `OpenAICompatibleEmbedder` send embedding requests with
+`encoding_format: "float"` and validate that the returned embedding length
+matches `embedder.dimensions`. When using a third-party OpenAI-compatible
+embedding model whose dimension is not known by the SDK, pass `dimensions`
+explicitly and create the vector store with the same value:
+
+```ts
+import {
+  InMemoryVectorStore,
+  OpenAICompatibleEmbedder,
+} from '@fllf/agent-sdk';
+
+const embedder = new OpenAICompatibleEmbedder({
+  apiKey: process.env.OPENAI_API_KEY,
+  baseURL: 'https://gateway.example.test/v1',
+  model: 'bge-m3',
+  dimensions: 1024,
+});
+
+const vectorStore = new InMemoryVectorStore({
+  dimensions: embedder.dimensions,
+});
+```
+
+If you change the embedding model or dimensions, build a new vector collection
+or re-ingest documents. Vectors from different models or dimensions must not be
+mixed in the same index.
+
+### Ingest documents
+
+Your application should run ingestion from an admin API, background worker, or
+document synchronization job.
+
+```ts
+await ragPipeline.ingest({
+  content: '# Refund policy\n\nRefunds are available within 30 days.',
+  source: 'policies/refund.md',
+  tenantId: 'tenant_1',
+  knowledgeBaseId: 'kb_support',
+  acl: ['user:user_42', 'role:support'],
+  replaceExisting: true,
+});
+```
+
+Important ingestion fields:
+
+- `source`: stable source path, URL, or document id shown in citations.
+- `tenantId`: tenant boundary.
+- `knowledgeBaseId`: knowledge-base boundary.
+- `acl`: access-control labels used at retrieval time.
+- `replaceExisting`: delete previous chunks and indexes for the same document id
+  before writing new ones.
+
+### Knowledge-base QA agent
+
+```ts
+import { Agent, RagExecutor } from '@fllf/agent-sdk';
+import { ragPipeline } from './rag-pipeline';
+
+const knowledgeAgent = new Agent({
+  name: 'knowledge-agent',
+  executor: new RagExecutor({
+    pipeline: ragPipeline,
+    requireCitations: true,
+  }),
+  requireSessionId: true,
+});
+
+const result = await knowledgeAgent.run('What is the refund window?', {
+  sessionId: 'tenant_1:user_42:conversation_1001',
+  metadata: {
+    tenantId: 'tenant_1',
+    knowledgeBaseId: 'kb_support',
+    acl: ['user:user_42', 'role:support'],
+    topK: 5,
+    maxContextTokens: 3000,
+  },
+});
+
+console.log(result.output);
+console.log(result.raw);
+```
+
+`result.raw` is the `RagAnswer`:
+
+```ts
+type RagAnswer = {
+  answer: string;
+  citations: Array<{
+    index: number;
+    chunkId: string;
+    documentId: string;
+    source: string;
+    title?: string;
+    headingPath?: string[];
+    page?: number;
+    quote?: string;
+  }>;
+  confidence: 'high' | 'medium' | 'low';
+  retrieved: unknown[];
+  usage?: unknown;
+  metadata?: Record<string, unknown>;
+};
+```
+
+Recommended RAG chat response:
+
+```ts
+return {
+  message: result.output,
+  citations: (result.raw as any).citations,
+  confidence: (result.raw as any).confidence,
+  usage: result.usage,
+};
+```
+
+### RAG as an optional search tool
+
+Use `RagSearchTool` when the agent should decide whether to search the knowledge
+base.
+
+```ts
+import {
+  Agent,
+  RagSearchTool,
+  ToolCallingExecutor,
+} from '@fllf/agent-sdk';
+import { ragPipeline } from './rag-pipeline';
+
+const agent = new Agent({
+  name: 'general-agent',
+  executor: new ToolCallingExecutor(),
+  tools: [
+    new RagSearchTool({
+      pipeline: ragPipeline,
+      defaultRetrieveOptions: {
+        topK: 5,
+      },
+    }),
+  ],
+  requireSessionId: true,
+});
+```
+
+## Structured output
+
+```ts
+import { z } from 'zod';
+import { LLM } from '@fllf/agent-sdk';
+
+const llm = new LLM();
+
+const result = await llm.generateObject({
+  messages: [
+    { role: 'user', content: 'Return a short project summary.' },
+  ],
+  schema: z.object({
+    summary: z.string(),
+    confidence: z.number(),
+  }),
+});
+
+console.log(result.value);
+```
+
+## Observability
+
+The SDK emits structured runtime events and does not print by default.
+
+```ts
+import { Agent, ConsoleObserver } from '@fllf/agent-sdk';
+
+const agent = new Agent({
+  name: 'debug-agent',
+  observer: new ConsoleObserver(),
+});
+
+await agent.run('Hello');
+```
+
+Event types include:
+
+- `agent:start`
+- `agent:end`
+- `agent:error`
+- `llm:start`
+- `llm:end`
+- `llm:error`
+- `tool:start`
+- `tool:end`
+- `tool:error`
+
+Forward events to your logging or tracing system:
+
+```ts
+const observer = {
+  onEvent(event) {
+    logger.info({ event }, 'agent runtime event');
+  },
+};
+```
+
+## Production integration checklist
+
+The SDK provides runtime primitives. A complete product should add:
+
+- Persistent users, conversations, messages, and audit logs.
+- A persistent `MessageHistoryStore`.
+- Persistent RAG stores and a vector/search backend.
+- AuthN/AuthZ before `Agent.run()` or `RagPipeline.retrieve()`.
+- Tenant, knowledge-base, and ACL filters in every RAG request.
+- Background document ingestion and index rebuild jobs.
+- Rate limits, model cost controls, and request timeouts.
+- Redaction or filtering for logs that may contain user messages or document
+  snippets.
+
+## Public API map
+
+All public APIs are exported from the package root:
+
+```ts
+import {
+  Agent,
+  LLM,
+  Tool,
+  ToolCallingExecutor,
+  RagExecutor,
+  RagSearchTool,
+  DefaultRagPipeline,
+} from '@fllf/agent-sdk';
+```
+
+Main areas:
+
+- `agent`: runtime composition.
+- `llm`: provider abstraction and structured output.
+- `history`: session-scoped message history interfaces and in-memory store.
+- `tools`: Zod-driven tools and tool execution.
+- `executors`: simple chat, tool calling, and RAG execution strategies.
+- `rag`: ingestion, chunking, embeddings, stores, retrieval, generation, and
+  verification.
+- `observability`: observer interface and console observer.
+
+## Development
+
+```bash
+npm install
+npm run typecheck
+npm test
+npm run build
+```
+
+Examples:
+
+```bash
+npm run example:simple-chat
+npm run example:tool-calling
+npm run example:local-ollama
+```
+
+During local development, examples may import from `../src` so they can run
+without building first.

package/dist/rag/embeddings/openai-compatible-embedder.d.ts

@@ -1,6 +1,10 @@
-import OpenAI from 'openai';
 import type { Embedder } from './embedder';
-type OpenAIEmbeddingBody = Parameters<OpenAI['embeddings']['create']>[0];
+export interface OpenAIEmbeddingRequestBody {
+    model: string;
+    input: string[];
+    encoding_format: 'float';
+    dimensions?: number;
+}
 export interface OpenAIEmbeddingResponseLike {
     data: Array<{
         embedding: unknown;
@@ -9,9 +13,21 @@ export interface OpenAIEmbeddingResponseLike {
 }
 export interface OpenAIEmbeddingsClientLike {
     embeddings: {
-        create(body: OpenAIEmbeddingBody): Promise<OpenAIEmbeddingResponseLike>;
+        create(body: OpenAIEmbeddingRequestBody): Promise<OpenAIEmbeddingResponseLike>;
     };
 }
+export type OpenAIEmbeddingFetchLike = (input: string, init?: {
+    method?: string;
+    headers?: Record<string, string>;
+    body?: string;
+    signal?: AbortSignal;
+}) => Promise<OpenAIEmbeddingHttpResponseLike>;
+export interface OpenAIEmbeddingHttpResponseLike {
+    ok: boolean;
+    status: number;
+    statusText: string;
+    text(): Promise<string>;
+}
 export interface OpenAICompatibleEmbedderOptions {
     apiKey?: string;
     model: string;
@@ -19,6 +35,9 @@ export interface OpenAICompatibleEmbedderOptions {
     baseURL?: string;
     batchSize?: number;
     sendDimensions?: boolean;
+    timeoutMs?: number;
+    headers?: Record<string, string>;
+    fetch?: OpenAIEmbeddingFetchLike;
     client?: OpenAIEmbeddingsClientLike;
 }
 export interface OpenAIEmbedderOptions extends Omit<OpenAICompatibleEmbedderOptions, 'model'> {
@@ -42,5 +61,4 @@ export declare class OpenAICompatibleEmbedder implements Embedder {
 export declare class OpenAIEmbedder extends OpenAICompatibleEmbedder {
     constructor(options?: OpenAIEmbedderOptions);
 }
-export {};
 //# sourceMappingURL=openai-compatible-embedder.d.ts.map

package/dist/rag/embeddings/openai-compatible-embedder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openai-compatible-embedder.d.ts","sourceRoot":"","sources":["../../../src/rag/embeddings/openai-compatible-embedder.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAO5B,OAAO,KAAK,EACR,QAAQ,EACX,MAAM,YAAY,CAAC;AAEpB,KAAK,mBAAmB,GAAG,UAAU,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAEzE,MAAM,WAAW,2BAA2B;IACxC,IAAI,EAAE,KAAK,CAAC;QACR,SAAS,EAAE,OAAO,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;CACN;AAED,MAAM,WAAW,0BAA0B;IACvC,UAAU,EAAE;QACR,MAAM,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAAC;KAC3E,CAAC;CACL;AAED,MAAM,WAAW,+BAA+B;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,MAAM,CAAC,EAAE,0BAA0B,CAAC;CACvC;AAED,MAAM,WAAW,qBAAsB,SAAQ,IAAI,CAAC,+BAA+B,EAAE,OAAO,CAAC;IACzF,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAUD;;;GAGG;AACH,qBAAa,wBAAyB,YAAW,QAAQ;IACrD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IACpD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAU;gBAE7B,OAAO,EAAE,+BAA+B;IAS9C,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;IAcpD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;YAUnC,gBAAgB;CAiBjC;AAED,qBAAa,cAAe,SAAQ,wBAAwB;gBAC5C,OAAO,GAAE,qBAA0B;CAgBlD"}
+{"version":3,"file":"openai-compatible-embedder.d.ts","sourceRoot":"","sources":["../../../src/rag/embeddings/openai-compatible-embedder.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACR,QAAQ,EACX,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,0BAA0B;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,eAAe,EAAE,OAAO,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,2BAA2B;IACxC,IAAI,EAAE,KAAK,CAAC;QACR,SAAS,EAAE,OAAO,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;CACN;AAED,MAAM,WAAW,0BAA0B;IACvC,UAAU,EAAE;QACR,MAAM,CAAC,IAAI,EAAE,0BAA0B,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAAC;KAClF,CAAC;CACL;AAED,MAAM,MAAM,wBAAwB,GAAG,CACnC,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,WAAW,CAAC;CACxB,KACA,OAAO,CAAC,+BAA+B,CAAC,CAAC;AAE9C,MAAM,WAAW,+BAA+B;IAC5C,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,+BAA+B;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,wBAAwB,CAAC;IACjC,MAAM,CAAC,EAAE,0BAA0B,CAAC;CACvC;AAED,MAAM,WAAW,qBAAsB,SAAQ,IAAI,CAAC,+BAA+B,EAAE,OAAO,CAAC;IACzF,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAYD;;;GAGG;AACH,qBAAa,wBAAyB,YAAW,QAAQ;IACrD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IACpD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAU;gBAE7B,OAAO,EAAE,+BAA+B;IAQ9C,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;IAcpD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;YAUnC,gBAAgB;CAkBjC;AAED,qBAAa,cAAe,SAAQ,wBAAwB;gBAC5C,OAAO,GAAE,qBAA0B;CAgBlD"}

package/dist/rag/embeddings/openai-compatible-embedder.js

@@ -1,13 +1,11 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OpenAIEmbedder = exports.OpenAICompatibleEmbedder = void 0;
-const openai_1 = __importDefault(require("openai"));
 const embedder_1 = require("./embedder");
 const DEFAULT_OPENAI_EMBEDDING_MODEL = 'text-embedding-3-small';
+const DEFAULT_OPENAI_BASE_URL = 'https://api.openai.com/v1';
 const DEFAULT_BATCH_SIZE = 100;
+const DEFAULT_TIMEOUT_MS = 30000;
 const DEFAULT_OPENAI_EMBEDDING_DIMENSIONS = {
     'text-embedding-3-small': 1536,
     'text-embedding-3-large': 3072,
@@ -27,9 +25,8 @@ class OpenAICompatibleEmbedder {
         this.model = options.model;
         this.dimensions = resolveEmbeddingDimensions(options.model, options.dimensions);
         this.batchSize = resolveBatchSize(options.batchSize);
-        this.sendDimensions = options.sendDimensions
-            ?? (options.dimensions !== undefined && supportsDimensionsParam(options.model));
-        this.client = options.client ?? createOpenAIClient(options);
+        this.sendDimensions = options.sendDimensions ?? options.dimensions !== undefined;
+        this.client = options.client ?? createHttpEmbeddingsClient(options);
     }
     async embedDocuments(texts) {
         const embeddings = [];
@@ -56,6 +53,7 @@ class OpenAICompatibleEmbedder {
         const body = {
             model: this.model,
             input: texts,
+            encoding_format: 'float',
         };
         if (this.sendDimensions) {
             body.dimensions = this.dimensions;
@@ -83,17 +81,22 @@ class OpenAIEmbedder extends OpenAICompatibleEmbedder {
     }
 }
 exports.OpenAIEmbedder = OpenAIEmbedder;
-function createOpenAIClient(options) {
+function createHttpEmbeddingsClient(options) {
     if (!options.apiKey) {
         throw new Error('OpenAI-compatible embedder requires an apiKey.');
     }
     const clientOptions = {
         apiKey: options.apiKey,
+        baseURL: options.baseURL ?? DEFAULT_OPENAI_BASE_URL,
+        timeoutMs: options.timeoutMs ?? DEFAULT_TIMEOUT_MS,
     };
-    if (options.baseURL) {
-        clientOptions.baseURL = options.baseURL;
+    if (options.headers !== undefined) {
+        clientOptions.headers = options.headers;
+    }
+    if (options.fetch !== undefined) {
+        clientOptions.fetch = options.fetch;
     }
-    return new openai_1.default(clientOptions);
+    return new HttpOpenAIEmbeddingsClient(clientOptions);
 }
 function resolveEmbeddingDimensions(model, dimensions) {
     if (dimensions !== undefined) {
@@ -114,9 +117,6 @@ function resolveBatchSize(batchSize) {
     }
     return batchSize;
 }
-function supportsDimensionsParam(model) {
-    return model === 'text-embedding-3-small' || model === 'text-embedding-3-large';
-}
 function toOrderedEmbeddings(response, expectedSize, expectedDimensions) {
     (0, embedder_1.assertEmbeddingBatchSize)(response.data, expectedSize);
     const ordered = new Array(expectedSize);
@@ -142,4 +142,98 @@ function readEmbedding(value) {
     }
     return value;
 }
+class HttpOpenAIEmbeddingsClient {
+    embeddings = {
+        create: async (body) => {
+            const controller = this.timeoutMs > 0 ? new AbortController() : undefined;
+            const timeoutId = controller === undefined
+                ? undefined
+                : setTimeout(() => controller.abort(), this.timeoutMs);
+            try {
+                const request = {
+                    method: 'POST',
+                    headers: this.createHeaders(),
+                    body: JSON.stringify(body),
+                };
+                if (controller !== undefined) {
+                    request.signal = controller.signal;
+                }
+                const response = await this.fetchImpl(this.url, request);
+                const text = await response.text();
+                if (!response.ok) {
+                    throw new Error(`Embedding API failed: ${response.status} ${response.statusText}${formatBody(text)}`);
+                }
+                return parseEmbeddingResponse(text);
+            }
+            finally {
+                if (timeoutId !== undefined) {
+                    clearTimeout(timeoutId);
+                }
+            }
+        },
+    };
+    url;
+    apiKey;
+    timeoutMs;
+    headers;
+    fetchImpl;
+    constructor(options) {
+        this.url = joinURL(options.baseURL, '/embeddings');
+        this.apiKey = options.apiKey;
+        this.timeoutMs = options.timeoutMs;
+        this.headers = { ...(options.headers ?? {}) };
+        this.fetchImpl = options.fetch ?? getGlobalFetch();
+    }
+    createHeaders() {
+        const headers = {
+            'content-type': 'application/json',
+            ...this.headers,
+        };
+        const hasAuthorization = Object.keys(headers).some((key) => key.toLowerCase() === 'authorization');
+        if (!hasAuthorization) {
+            headers.authorization = `Bearer ${this.apiKey}`;
+        }
+        return headers;
+    }
+}
+function parseEmbeddingResponse(text) {
+    const parsed = JSON.parse(text);
+    if (!isRecord(parsed) || !Array.isArray(parsed.data)) {
+        throw new TypeError('Embedding API response must contain a data array.');
+    }
+    return {
+        data: parsed.data.map((item) => {
+            if (!isRecord(item)) {
+                throw new TypeError('Embedding API response data items must be objects.');
+            }
+            const embedding = item.embedding;
+            const result = { embedding };
+            if (item.index !== undefined) {
+                if (typeof item.index !== 'number') {
+                    throw new TypeError('Embedding API response item index must be a number.');
+                }
+                result.index = item.index;
+            }
+            return result;
+        }),
+    };
+}
+function joinURL(baseURL, endpoint) {
+    return `${baseURL.replace(/\/+$/, '')}/${endpoint.replace(/^\/+/, '')}`;
+}
+function getGlobalFetch() {
+    if (typeof fetch !== 'function') {
+        throw new Error('OpenAI-compatible embedder requires fetch support or a custom fetch option.');
+    }
+    return fetch;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function formatBody(text) {
+    if (text.length === 0) {
+        return '';
+    }
+    return `: ${text}`;
+}
 //# sourceMappingURL=openai-compatible-embedder.js.map

package/dist/rag/embeddings/openai-compatible-embedder.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
-  "name": "@fllf/agent-sdk",
-  "version": "0.1.0",
+  "name": "@fllf/agent-sdk",
+  "version": "0.1.2",
   "description": "A composable TypeScript Agent runtime foundation.",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -10,20 +10,20 @@
       "default": "./dist/index.js"
     }
   },
-  "files": [
-    "dist",
-    "README.md"
-  ],
-  "publishConfig": {
-    "access": "public",
-    "registry": "https://registry.npmjs.org/"
-  },
-  "scripts": {
-    "build": "tsc -p tsconfig.build.json",
-    "typecheck": "tsc --noEmit",
-    "test": "tsx --test test/**/*.test.ts",
-    "prepublishOnly": "npm run typecheck && npm test && npm run build",
-    "example:simple-chat": "tsx examples/simple-chat.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "tsx --test test/**/*.test.ts",
+    "prepublishOnly": "npm run typecheck && npm test && npm run build",
+    "example:simple-chat": "tsx examples/simple-chat.ts",
     "example:tool-calling": "tsx examples/tool-calling.ts",
     "example:local-ollama": "tsx examples/local-ollama.ts"
   },