@flightdev/ai 0.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-2026 Flight Contributors
+
+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,95 @@
+# @flight-framework/ai
+
+AI utilities for Flight Framework. Integrate with OpenAI, Anthropic, and other LLM providers.
+
+## Installation
+
+```bash
+npm install @flight-framework/ai
+```
+
+## Quick Start
+
+```typescript
+import { createAI } from '@flight-framework/ai';
+import { openai } from '@flight-framework/ai/openai';
+
+const ai = createAI(openai({
+    apiKey: process.env.OPENAI_API_KEY,
+}));
+
+const response = await ai.chat([
+    { role: 'user', content: 'Hello!' }
+]);
+
+console.log(response.content);
+```
+
+## Adapters
+
+### OpenAI
+
+```typescript
+import { openai } from '@flight-framework/ai/openai';
+
+const adapter = openai({
+    apiKey: process.env.OPENAI_API_KEY,
+    model: 'gpt-4-turbo',
+});
+```
+
+### Anthropic
+
+```typescript
+import { anthropic } from '@flight-framework/ai/anthropic';
+
+const adapter = anthropic({
+    apiKey: process.env.ANTHROPIC_API_KEY,
+    model: 'claude-3-opus-20240229',
+});
+```
+
+### Google AI (Gemini)
+
+```typescript
+import { google } from '@flight-framework/ai/google';
+
+const adapter = google({
+    apiKey: process.env.GOOGLE_AI_API_KEY,
+    model: 'gemini-pro',
+});
+```
+
+## Streaming
+
+```typescript
+const stream = await ai.stream([
+    { role: 'user', content: 'Write a poem' }
+]);
+
+for await (const chunk of stream) {
+    process.stdout.write(chunk.content);
+}
+```
+
+## React Integration
+
+```tsx
+import { useChat } from '@flight-framework/ai/react';
+
+function ChatBox() {
+    const { messages, input, setInput, send, isLoading } = useChat();
+    
+    return (
+        <div>
+            {messages.map(m => <div key={m.id}>{m.content}</div>)}
+            <input value={input} onChange={e => setInput(e.target.value)} />
+            <button onClick={send} disabled={isLoading}>Send</button>
+        </div>
+    );
+}
+```
+
+## License
+
+MIT

package/dist/adapters/anthropic.d.ts

@@ -0,0 +1,14 @@
+import { AIAdapterFactory } from '../index.js';
+
+/**
+ * Anthropic Adapter for @flightdev/ai
+ */
+
+interface AnthropicConfig {
+    apiKey: string;
+    model?: string;
+    baseUrl?: string;
+}
+declare const anthropic: AIAdapterFactory<AnthropicConfig>;
+
+export { type AnthropicConfig, anthropic, anthropic as default };

package/dist/adapters/anthropic.js

@@ -0,0 +1,118 @@
+// src/adapters/anthropic.ts
+var anthropic = (config) => {
+  const {
+    apiKey,
+    model: defaultModel = "claude-3-5-sonnet-20241022",
+    baseUrl = "https://api.anthropic.com/v1"
+  } = config;
+  const headers = {
+    "x-api-key": apiKey,
+    "Content-Type": "application/json",
+    "anthropic-version": "2023-06-01"
+  };
+  async function request(endpoint, body) {
+    const response = await fetch(`${baseUrl}${endpoint}`, {
+      method: "POST",
+      headers,
+      body: JSON.stringify(body)
+    });
+    if (!response.ok) {
+      const error = await response.json().catch(() => ({}));
+      throw new Error(`Anthropic error: ${error.error?.message ?? response.statusText}`);
+    }
+    return response.json();
+  }
+  const adapter = {
+    name: "anthropic",
+    async listModels() {
+      return ["claude-3-5-sonnet-20241022", "claude-3-opus-20240229", "claude-3-haiku-20240307"];
+    },
+    async chat(messages, options) {
+      const model = options?.model ?? defaultModel;
+      const systemMsg = messages.find((m) => m.role === "system");
+      const nonSystemMessages = messages.filter((m) => m.role !== "system");
+      const body = {
+        model,
+        messages: nonSystemMessages.map((m) => ({
+          role: m.role === "assistant" ? "assistant" : "user",
+          content: m.content
+        })),
+        max_tokens: options?.maxTokens ?? 4096
+      };
+      if (systemMsg || options?.system) {
+        body.system = options?.system ?? systemMsg?.content;
+      }
+      if (options?.temperature !== void 0) body.temperature = options.temperature;
+      if (options?.stop) body.stop_sequences = options.stop;
+      const response = await request("/messages", body);
+      return {
+        content: response.content.find((c) => c.type === "text")?.text ?? "",
+        finishReason: response.stop_reason === "end_turn" ? "stop" : "length",
+        usage: {
+          promptTokens: response.usage.input_tokens,
+          completionTokens: response.usage.output_tokens,
+          totalTokens: response.usage.input_tokens + response.usage.output_tokens
+        }
+      };
+    },
+    async *chatStream(messages, options) {
+      const model = options?.model ?? defaultModel;
+      const systemMsg = messages.find((m) => m.role === "system");
+      const nonSystemMessages = messages.filter((m) => m.role !== "system");
+      const body = {
+        model,
+        messages: nonSystemMessages.map((m) => ({
+          role: m.role === "assistant" ? "assistant" : "user",
+          content: m.content
+        })),
+        max_tokens: options?.maxTokens ?? 4096,
+        stream: true
+      };
+      if (systemMsg || options?.system) {
+        body.system = options?.system ?? systemMsg?.content;
+      }
+      const response = await fetch(`${baseUrl}/messages`, {
+        method: "POST",
+        headers,
+        body: JSON.stringify(body)
+      });
+      if (!response.ok || !response.body) {
+        throw new Error(`Anthropic stream error: ${response.statusText}`);
+      }
+      const reader = response.body.getReader();
+      const decoder = new TextDecoder();
+      let buffer = "";
+      while (true) {
+        const { done, value } = await reader.read();
+        if (done) break;
+        buffer += decoder.decode(value, { stream: true });
+        const lines = buffer.split("\n");
+        buffer = lines.pop() ?? "";
+        for (const line of lines) {
+          if (line.startsWith("data: ")) {
+            try {
+              const data = JSON.parse(line.slice(6));
+              if (data.type === "content_block_delta" && data.delta?.text) {
+                yield { content: data.delta.text, done: false };
+              }
+              if (data.type === "message_stop") {
+                yield { done: true };
+                return;
+              }
+            } catch {
+            }
+          }
+        }
+      }
+    },
+    async embed() {
+      throw new Error("Anthropic does not support embeddings. Use a different adapter.");
+    }
+  };
+  return adapter;
+};
+var anthropic_default = anthropic;
+
+export { anthropic, anthropic_default as default };
+//# sourceMappingURL=anthropic.js.map
+//# sourceMappingURL=anthropic.js.map

package/dist/adapters/anthropic.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/anthropic.ts"],"names":[],"mappings":"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","file":"anthropic.js","sourcesContent":["/**\r\n * Anthropic Adapter for @flightdev/ai\r\n */\r\n\r\nimport type {\r\n    AIAdapter,\r\n    AIAdapterFactory,\r\n    ChatMessage,\r\n    ChatOptions,\r\n    ChatResult,\r\n    StreamChunk,\r\n    EmbeddingResult,\r\n} from '../index.js';\r\n\r\nexport interface AnthropicConfig {\r\n    apiKey: string;\r\n    model?: string;\r\n    baseUrl?: string;\r\n}\r\n\r\nexport const anthropic: AIAdapterFactory<AnthropicConfig> = (config) => {\r\n    const {\r\n        apiKey,\r\n        model: defaultModel = 'claude-3-5-sonnet-20241022',\r\n        baseUrl = 'https://api.anthropic.com/v1',\r\n    } = config;\r\n\r\n    const headers = {\r\n        'x-api-key': apiKey,\r\n        'Content-Type': 'application/json',\r\n        'anthropic-version': '2023-06-01',\r\n    };\r\n\r\n    async function request(endpoint: string, body: unknown): Promise<unknown> {\r\n        const response = await fetch(`${baseUrl}${endpoint}`, {\r\n            method: 'POST',\r\n            headers,\r\n            body: JSON.stringify(body),\r\n        });\r\n\r\n        if (!response.ok) {\r\n            const error = await response.json().catch(() => ({})) as { error?: { message?: string } };\r\n            throw new Error(`Anthropic error: ${error.error?.message ?? response.statusText}`);\r\n        }\r\n\r\n        return response.json();\r\n    }\r\n\r\n    const adapter: AIAdapter = {\r\n        name: 'anthropic',\r\n\r\n        async listModels(): Promise<string[]> {\r\n            return ['claude-3-5-sonnet-20241022', 'claude-3-opus-20240229', 'claude-3-haiku-20240307'];\r\n        },\r\n\r\n        async chat(messages: ChatMessage[], options?: ChatOptions): Promise<ChatResult> {\r\n            const model = options?.model ?? defaultModel;\r\n            const systemMsg = messages.find(m => m.role === 'system');\r\n            const nonSystemMessages = messages.filter(m => m.role !== 'system');\r\n\r\n            const body: Record<string, unknown> = {\r\n                model,\r\n                messages: nonSystemMessages.map(m => ({\r\n                    role: m.role === 'assistant' ? 'assistant' : 'user',\r\n                    content: m.content,\r\n                })),\r\n                max_tokens: options?.maxTokens ?? 4096,\r\n            };\r\n\r\n            if (systemMsg || options?.system) {\r\n                body.system = options?.system ?? systemMsg?.content;\r\n            }\r\n            if (options?.temperature !== undefined) body.temperature = options.temperature;\r\n            if (options?.stop) body.stop_sequences = options.stop;\r\n\r\n            const response = await request('/messages', body) as {\r\n                content: Array<{ type: string; text: string }>;\r\n                stop_reason: string;\r\n                usage: { input_tokens: number; output_tokens: number };\r\n            };\r\n\r\n            return {\r\n                content: response.content.find(c => c.type === 'text')?.text ?? '',\r\n                finishReason: response.stop_reason === 'end_turn' ? 'stop' : 'length',\r\n                usage: {\r\n                    promptTokens: response.usage.input_tokens,\r\n                    completionTokens: response.usage.output_tokens,\r\n                    totalTokens: response.usage.input_tokens + response.usage.output_tokens,\r\n                },\r\n            };\r\n        },\r\n\r\n        async *chatStream(messages: ChatMessage[], options?: ChatOptions): AsyncIterable<StreamChunk> {\r\n            const model = options?.model ?? defaultModel;\r\n            const systemMsg = messages.find(m => m.role === 'system');\r\n            const nonSystemMessages = messages.filter(m => m.role !== 'system');\r\n\r\n            const body: Record<string, unknown> = {\r\n                model,\r\n                messages: nonSystemMessages.map(m => ({\r\n                    role: m.role === 'assistant' ? 'assistant' : 'user',\r\n                    content: m.content,\r\n                })),\r\n                max_tokens: options?.maxTokens ?? 4096,\r\n                stream: true,\r\n            };\r\n\r\n            if (systemMsg || options?.system) {\r\n                body.system = options?.system ?? systemMsg?.content;\r\n            }\r\n\r\n            const response = await fetch(`${baseUrl}/messages`, {\r\n                method: 'POST',\r\n                headers,\r\n                body: JSON.stringify(body),\r\n            });\r\n\r\n            if (!response.ok || !response.body) {\r\n                throw new Error(`Anthropic stream error: ${response.statusText}`);\r\n            }\r\n\r\n            const reader = response.body.getReader();\r\n            const decoder = new TextDecoder();\r\n            let buffer = '';\r\n\r\n            while (true) {\r\n                const { done, value } = await reader.read();\r\n                if (done) break;\r\n\r\n                buffer += decoder.decode(value, { stream: true });\r\n                const lines = buffer.split('\\n');\r\n                buffer = lines.pop() ?? '';\r\n\r\n                for (const line of lines) {\r\n                    if (line.startsWith('data: ')) {\r\n                        try {\r\n                            const data = JSON.parse(line.slice(6)) as {\r\n                                type: string;\r\n                                delta?: { type: string; text?: string };\r\n                            };\r\n                            if (data.type === 'content_block_delta' && data.delta?.text) {\r\n                                yield { content: data.delta.text, done: false };\r\n                            }\r\n                            if (data.type === 'message_stop') {\r\n                                yield { done: true };\r\n                                return;\r\n                            }\r\n                        } catch {\r\n                            // Skip malformed JSON\r\n                        }\r\n                    }\r\n                }\r\n            }\r\n        },\r\n\r\n        async embed(): Promise<EmbeddingResult[]> {\r\n            throw new Error('Anthropic does not support embeddings. Use a different adapter.');\r\n        },\r\n    };\r\n\r\n    return adapter;\r\n};\r\n\r\nexport default anthropic;\r\n"]}

package/dist/adapters/ollama.d.ts

@@ -0,0 +1,13 @@
+import { AIAdapterFactory } from '../index.js';
+
+/**
+ * Ollama Adapter for @flightdev/ai (Local LLMs)
+ */
+
+interface OllamaConfig {
+    baseUrl?: string;
+    model?: string;
+}
+declare const ollama: AIAdapterFactory<OllamaConfig>;
+
+export { type OllamaConfig, ollama as default, ollama };

package/dist/adapters/ollama.js

@@ -0,0 +1,97 @@
+// src/adapters/ollama.ts
+var ollama = (config = {}) => {
+  const {
+    baseUrl = "http://localhost:11434",
+    model: defaultModel = "llama3.2"
+  } = config;
+  const adapter = {
+    name: "ollama",
+    async listModels() {
+      const response = await fetch(`${baseUrl}/api/tags`);
+      const data = await response.json();
+      return data.models.map((m) => m.name);
+    },
+    async chat(messages, options) {
+      const model = options?.model ?? defaultModel;
+      const allMessages = options?.system ? [{ role: "system", content: options.system }, ...messages] : messages;
+      const response = await fetch(`${baseUrl}/api/chat`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          model,
+          messages: allMessages,
+          stream: false,
+          options: {
+            temperature: options?.temperature,
+            num_predict: options?.maxTokens
+          }
+        })
+      });
+      const data = await response.json();
+      return {
+        content: data.message.content,
+        finishReason: "stop",
+        usage: {
+          promptTokens: data.prompt_eval_count ?? 0,
+          completionTokens: data.eval_count ?? 0,
+          totalTokens: (data.prompt_eval_count ?? 0) + (data.eval_count ?? 0)
+        }
+      };
+    },
+    async *chatStream(messages, options) {
+      const model = options?.model ?? defaultModel;
+      const allMessages = options?.system ? [{ role: "system", content: options.system }, ...messages] : messages;
+      const response = await fetch(`${baseUrl}/api/chat`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          model,
+          messages: allMessages,
+          stream: true
+        })
+      });
+      if (!response.body) throw new Error("No response body");
+      const reader = response.body.getReader();
+      const decoder = new TextDecoder();
+      while (true) {
+        const { done, value } = await reader.read();
+        if (done) break;
+        const lines = decoder.decode(value).split("\n").filter(Boolean);
+        for (const line of lines) {
+          try {
+            const data = JSON.parse(line);
+            if (data.message?.content) {
+              yield { content: data.message.content, done: false };
+            }
+            if (data.done) {
+              yield { done: true };
+              return;
+            }
+          } catch {
+          }
+        }
+      }
+    },
+    async embed(input, options) {
+      const model = options?.model ?? "nomic-embed-text";
+      const inputs = Array.isArray(input) ? input : [input];
+      const results = [];
+      for (const text of inputs) {
+        const response = await fetch(`${baseUrl}/api/embeddings`, {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({ model, prompt: text })
+        });
+        const data = await response.json();
+        results.push({ embedding: data.embedding });
+      }
+      return results;
+    }
+  };
+  return adapter;
+};
+var ollama_default = ollama;
+
+export { ollama_default as default, ollama };
+//# sourceMappingURL=ollama.js.map
+//# sourceMappingURL=ollama.js.map

package/dist/adapters/ollama.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/ollama.ts"],"names":[],"mappings":"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","file":"ollama.js","sourcesContent":["/**\r\n * Ollama Adapter for @flightdev/ai (Local LLMs)\r\n */\r\n\r\nimport type {\r\n    AIAdapter,\r\n    AIAdapterFactory,\r\n    ChatMessage,\r\n    ChatOptions,\r\n    ChatResult,\r\n    StreamChunk,\r\n    EmbeddingOptions,\r\n    EmbeddingResult,\r\n} from '../index.js';\r\n\r\nexport interface OllamaConfig {\r\n    baseUrl?: string;\r\n    model?: string;\r\n}\r\n\r\nexport const ollama: AIAdapterFactory<OllamaConfig> = (config = {}) => {\r\n    const {\r\n        baseUrl = 'http://localhost:11434',\r\n        model: defaultModel = 'llama3.2',\r\n    } = config;\r\n\r\n    const adapter: AIAdapter = {\r\n        name: 'ollama',\r\n\r\n        async listModels(): Promise<string[]> {\r\n            const response = await fetch(`${baseUrl}/api/tags`);\r\n            const data = await response.json() as { models: Array<{ name: string }> };\r\n            return data.models.map(m => m.name);\r\n        },\r\n\r\n        async chat(messages: ChatMessage[], options?: ChatOptions): Promise<ChatResult> {\r\n            const model = options?.model ?? defaultModel;\r\n            const allMessages = options?.system\r\n                ? [{ role: 'system' as const, content: options.system }, ...messages]\r\n                : messages;\r\n\r\n            const response = await fetch(`${baseUrl}/api/chat`, {\r\n                method: 'POST',\r\n                headers: { 'Content-Type': 'application/json' },\r\n                body: JSON.stringify({\r\n                    model,\r\n                    messages: allMessages,\r\n                    stream: false,\r\n                    options: {\r\n                        temperature: options?.temperature,\r\n                        num_predict: options?.maxTokens,\r\n                    },\r\n                }),\r\n            });\r\n\r\n            const data = await response.json() as {\r\n                message: { content: string };\r\n                done: boolean;\r\n                eval_count?: number;\r\n                prompt_eval_count?: number;\r\n            };\r\n\r\n            return {\r\n                content: data.message.content,\r\n                finishReason: 'stop',\r\n                usage: {\r\n                    promptTokens: data.prompt_eval_count ?? 0,\r\n                    completionTokens: data.eval_count ?? 0,\r\n                    totalTokens: (data.prompt_eval_count ?? 0) + (data.eval_count ?? 0),\r\n                },\r\n            };\r\n        },\r\n\r\n        async *chatStream(messages: ChatMessage[], options?: ChatOptions): AsyncIterable<StreamChunk> {\r\n            const model = options?.model ?? defaultModel;\r\n            const allMessages = options?.system\r\n                ? [{ role: 'system' as const, content: options.system }, ...messages]\r\n                : messages;\r\n\r\n            const response = await fetch(`${baseUrl}/api/chat`, {\r\n                method: 'POST',\r\n                headers: { 'Content-Type': 'application/json' },\r\n                body: JSON.stringify({\r\n                    model,\r\n                    messages: allMessages,\r\n                    stream: true,\r\n                }),\r\n            });\r\n\r\n            if (!response.body) throw new Error('No response body');\r\n\r\n            const reader = response.body.getReader();\r\n            const decoder = new TextDecoder();\r\n\r\n            while (true) {\r\n                const { done, value } = await reader.read();\r\n                if (done) break;\r\n\r\n                const lines = decoder.decode(value).split('\\n').filter(Boolean);\r\n                for (const line of lines) {\r\n                    try {\r\n                        const data = JSON.parse(line) as { message?: { content: string }; done: boolean };\r\n                        if (data.message?.content) {\r\n                            yield { content: data.message.content, done: false };\r\n                        }\r\n                        if (data.done) {\r\n                            yield { done: true };\r\n                            return;\r\n                        }\r\n                    } catch {\r\n                        // Skip\r\n                    }\r\n                }\r\n            }\r\n        },\r\n\r\n        async embed(input: string | string[], options?: EmbeddingOptions): Promise<EmbeddingResult[]> {\r\n            const model = options?.model ?? 'nomic-embed-text';\r\n            const inputs = Array.isArray(input) ? input : [input];\r\n            const results: EmbeddingResult[] = [];\r\n\r\n            for (const text of inputs) {\r\n                const response = await fetch(`${baseUrl}/api/embeddings`, {\r\n                    method: 'POST',\r\n                    headers: { 'Content-Type': 'application/json' },\r\n                    body: JSON.stringify({ model, prompt: text }),\r\n                });\r\n\r\n                const data = await response.json() as { embedding: number[] };\r\n                results.push({ embedding: data.embedding });\r\n            }\r\n\r\n            return results;\r\n        },\r\n    };\r\n\r\n    return adapter;\r\n};\r\n\r\nexport default ollama;\r\n"]}

package/dist/adapters/openai.d.ts

@@ -0,0 +1,33 @@
+import { AIAdapterFactory } from '../index.js';
+
+/**
+ * OpenAI Adapter for @flightdev/ai
+ *
+ * @example
+ * ```typescript
+ * import { createAI } from '@flightdev/ai';
+ * import { openai } from '@flightdev/ai/openai';
+ *
+ * const ai = createAI(openai({
+ *   apiKey: process.env.OPENAI_API_KEY,
+ *   model: 'gpt-4-turbo',
+ * }));
+ * ```
+ */
+
+interface OpenAIConfig {
+    /** OpenAI API key */
+    apiKey: string;
+    /** Default model */
+    model?: string;
+    /** Organization ID */
+    organization?: string;
+    /** Base URL (for Azure OpenAI or proxies) */
+    baseUrl?: string;
+}
+/**
+ * Create an OpenAI adapter
+ */
+declare const openai: AIAdapterFactory<OpenAIConfig>;
+
+export { type OpenAIConfig, openai as default, openai };

package/dist/adapters/openai.js

@@ -0,0 +1,147 @@
+// src/adapters/openai.ts
+var openai = (config) => {
+  const {
+    apiKey,
+    model: defaultModel = "gpt-4-turbo",
+    organization,
+    baseUrl = "https://api.openai.com/v1"
+  } = config;
+  const headers = {
+    "Authorization": `Bearer ${apiKey}`,
+    "Content-Type": "application/json"
+  };
+  if (organization) {
+    headers["OpenAI-Organization"] = organization;
+  }
+  async function request(endpoint, body) {
+    const response = await fetch(`${baseUrl}${endpoint}`, {
+      method: "POST",
+      headers,
+      body: JSON.stringify(body)
+    });
+    if (!response.ok) {
+      const error = await response.json().catch(() => ({}));
+      throw new Error(`OpenAI error: ${error.error?.message ?? response.statusText}`);
+    }
+    return response.json();
+  }
+  function mapTools(tools) {
+    if (!tools) return void 0;
+    return tools.map((tool) => ({
+      type: "function",
+      function: {
+        name: tool.name,
+        description: tool.description,
+        parameters: tool.parameters
+      }
+    }));
+  }
+  const adapter = {
+    name: "openai",
+    async listModels() {
+      const response = await fetch(`${baseUrl}/models`, { headers });
+      const data = await response.json();
+      return data.data.map((m) => m.id);
+    },
+    async chat(messages, options) {
+      const model = options?.model ?? defaultModel;
+      const allMessages = options?.system ? [{ role: "system", content: options.system }, ...messages] : messages;
+      const body = {
+        model,
+        messages: allMessages.map((m) => ({
+          role: m.role,
+          content: m.content,
+          ...m.name && { name: m.name },
+          ...m.toolCallId && { tool_call_id: m.toolCallId }
+        }))
+      };
+      if (options?.temperature !== void 0) body.temperature = options.temperature;
+      if (options?.maxTokens) body.max_tokens = options.maxTokens;
+      if (options?.stop) body.stop = options.stop;
+      if (options?.tools) body.tools = mapTools(options.tools);
+      const response = await request("/chat/completions", body);
+      const choice = response.choices[0];
+      if (!choice) {
+        throw new Error("OpenAI: No response choice");
+      }
+      const toolCalls = choice.message.tool_calls?.map((tc) => ({
+        id: tc.id,
+        name: tc.function.name,
+        arguments: JSON.parse(tc.function.arguments)
+      }));
+      return {
+        content: choice.message.content ?? "",
+        toolCalls,
+        finishReason: choice.finish_reason,
+        usage: response.usage ? {
+          promptTokens: response.usage.prompt_tokens,
+          completionTokens: response.usage.completion_tokens,
+          totalTokens: response.usage.total_tokens
+        } : void 0
+      };
+    },
+    async *chatStream(messages, options) {
+      const model = options?.model ?? defaultModel;
+      const allMessages = options?.system ? [{ role: "system", content: options.system }, ...messages] : messages;
+      const body = {
+        model,
+        messages: allMessages,
+        stream: true
+      };
+      if (options?.temperature !== void 0) body.temperature = options.temperature;
+      if (options?.maxTokens) body.max_tokens = options.maxTokens;
+      const response = await fetch(`${baseUrl}/chat/completions`, {
+        method: "POST",
+        headers,
+        body: JSON.stringify(body)
+      });
+      if (!response.ok || !response.body) {
+        throw new Error(`OpenAI stream error: ${response.statusText}`);
+      }
+      const reader = response.body.getReader();
+      const decoder = new TextDecoder();
+      let buffer = "";
+      while (true) {
+        const { done, value } = await reader.read();
+        if (done) break;
+        buffer += decoder.decode(value, { stream: true });
+        const lines = buffer.split("\n");
+        buffer = lines.pop() ?? "";
+        for (const line of lines) {
+          if (line.startsWith("data: ")) {
+            const data = line.slice(6);
+            if (data === "[DONE]") {
+              yield { done: true };
+              return;
+            }
+            try {
+              const parsed = JSON.parse(data);
+              const content = parsed.choices[0]?.delta?.content;
+              if (content) {
+                yield { content, done: false };
+              }
+            } catch {
+            }
+          }
+        }
+      }
+    },
+    async embed(input, options) {
+      const model = options?.model ?? "text-embedding-3-small";
+      const inputs = Array.isArray(input) ? input : [input];
+      const body = { model, input: inputs };
+      if (options?.dimensions) body.dimensions = options.dimensions;
+      const response = await request("/embeddings", body);
+      return response.data.map((d) => ({
+        embedding: d.embedding,
+        usage: response.usage ? { totalTokens: response.usage.total_tokens } : void 0
+      }));
+    }
+  };
+  return adapter;
+};
+var openai_default = openai;
+
+export { openai_default as default, openai };
+//# sourceMappingURL=openai.js.map
+//# sourceMappingURL=openai.js.map

package/dist/adapters/openai.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/openai.ts"],"names":[],"mappings":"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","file":"openai.js","sourcesContent":["/**\r\n * OpenAI Adapter for @flightdev/ai\r\n * \r\n * @example\r\n * ```typescript\r\n * import { createAI } from '@flightdev/ai';\r\n * import { openai } from '@flightdev/ai/openai';\r\n * \r\n * const ai = createAI(openai({\r\n *   apiKey: process.env.OPENAI_API_KEY,\r\n *   model: 'gpt-4-turbo',\r\n * }));\r\n * ```\r\n */\r\n\r\nimport type {\r\n    AIAdapter,\r\n    AIAdapterFactory,\r\n    ChatMessage,\r\n    ChatOptions,\r\n    ChatResult,\r\n    StreamChunk,\r\n    EmbeddingOptions,\r\n    EmbeddingResult,\r\n    ToolDefinition,\r\n} from '../index.js';\r\n\r\n// ============================================================================\r\n// Types\r\n// ============================================================================\r\n\r\nexport interface OpenAIConfig {\r\n    /** OpenAI API key */\r\n    apiKey: string;\r\n    /** Default model */\r\n    model?: string;\r\n    /** Organization ID */\r\n    organization?: string;\r\n    /** Base URL (for Azure OpenAI or proxies) */\r\n    baseUrl?: string;\r\n}\r\n\r\n// ============================================================================\r\n// OpenAI Adapter\r\n// ============================================================================\r\n\r\n/**\r\n * Create an OpenAI adapter\r\n */\r\nexport const openai: AIAdapterFactory<OpenAIConfig> = (config) => {\r\n    const {\r\n        apiKey,\r\n        model: defaultModel = 'gpt-4-turbo',\r\n        organization,\r\n        baseUrl = 'https://api.openai.com/v1',\r\n    } = config;\r\n\r\n    const headers: Record<string, string> = {\r\n        'Authorization': `Bearer ${apiKey}`,\r\n        'Content-Type': 'application/json',\r\n    };\r\n    if (organization) {\r\n        headers['OpenAI-Organization'] = organization;\r\n    }\r\n\r\n    async function request(endpoint: string, body: unknown): Promise<unknown> {\r\n        const response = await fetch(`${baseUrl}${endpoint}`, {\r\n            method: 'POST',\r\n            headers,\r\n            body: JSON.stringify(body),\r\n        });\r\n\r\n        if (!response.ok) {\r\n            const error = await response.json().catch(() => ({}));\r\n            throw new Error(`OpenAI error: ${(error as { error?: { message?: string } }).error?.message ?? response.statusText}`);\r\n        }\r\n\r\n        return response.json();\r\n    }\r\n\r\n    function mapTools(tools?: ToolDefinition[]): unknown[] | undefined {\r\n        if (!tools) return undefined;\r\n        return tools.map(tool => ({\r\n            type: 'function',\r\n            function: {\r\n                name: tool.name,\r\n                description: tool.description,\r\n                parameters: tool.parameters,\r\n            },\r\n        }));\r\n    }\r\n\r\n    const adapter: AIAdapter = {\r\n        name: 'openai',\r\n\r\n        async listModels(): Promise<string[]> {\r\n            const response = await fetch(`${baseUrl}/models`, { headers });\r\n            const data = await response.json() as { data: Array<{ id: string }> };\r\n            return data.data.map(m => m.id);\r\n        },\r\n\r\n        async chat(messages: ChatMessage[], options?: ChatOptions): Promise<ChatResult> {\r\n            const model = options?.model ?? defaultModel;\r\n            const allMessages = options?.system\r\n                ? [{ role: 'system' as const, content: options.system }, ...messages]\r\n                : messages;\r\n\r\n            const body: Record<string, unknown> = {\r\n                model,\r\n                messages: allMessages.map(m => ({\r\n                    role: m.role,\r\n                    content: m.content,\r\n                    ...(m.name && { name: m.name }),\r\n                    ...(m.toolCallId && { tool_call_id: m.toolCallId }),\r\n                })),\r\n            };\r\n\r\n            if (options?.temperature !== undefined) body.temperature = options.temperature;\r\n            if (options?.maxTokens) body.max_tokens = options.maxTokens;\r\n            if (options?.stop) body.stop = options.stop;\r\n            if (options?.tools) body.tools = mapTools(options.tools);\r\n\r\n            const response = await request('/chat/completions', body) as {\r\n                choices: Array<{\r\n                    message: { content: string | null; tool_calls?: Array<{ id: string; function: { name: string; arguments: string } }> };\r\n                    finish_reason: string;\r\n                }>;\r\n                usage?: { prompt_tokens: number; completion_tokens: number; total_tokens: number };\r\n            };\r\n\r\n            const choice = response.choices[0];\r\n            if (!choice) {\r\n                throw new Error('OpenAI: No response choice');\r\n            }\r\n            const toolCalls = choice.message.tool_calls?.map(tc => ({\r\n                id: tc.id,\r\n                name: tc.function.name,\r\n                arguments: JSON.parse(tc.function.arguments),\r\n            }));\r\n\r\n            return {\r\n                content: choice.message.content ?? '',\r\n                toolCalls,\r\n                finishReason: choice.finish_reason as ChatResult['finishReason'],\r\n                usage: response.usage ? {\r\n                    promptTokens: response.usage.prompt_tokens,\r\n                    completionTokens: response.usage.completion_tokens,\r\n                    totalTokens: response.usage.total_tokens,\r\n                } : undefined,\r\n            };\r\n        },\r\n\r\n        async *chatStream(messages: ChatMessage[], options?: ChatOptions): AsyncIterable<StreamChunk> {\r\n            const model = options?.model ?? defaultModel;\r\n            const allMessages = options?.system\r\n                ? [{ role: 'system' as const, content: options.system }, ...messages]\r\n                : messages;\r\n\r\n            const body: Record<string, unknown> = {\r\n                model,\r\n                messages: allMessages,\r\n                stream: true,\r\n            };\r\n\r\n            if (options?.temperature !== undefined) body.temperature = options.temperature;\r\n            if (options?.maxTokens) body.max_tokens = options.maxTokens;\r\n\r\n            const response = await fetch(`${baseUrl}/chat/completions`, {\r\n                method: 'POST',\r\n                headers,\r\n                body: JSON.stringify(body),\r\n            });\r\n\r\n            if (!response.ok || !response.body) {\r\n                throw new Error(`OpenAI stream error: ${response.statusText}`);\r\n            }\r\n\r\n            const reader = response.body.getReader();\r\n            const decoder = new TextDecoder();\r\n            let buffer = '';\r\n\r\n            while (true) {\r\n                const { done, value } = await reader.read();\r\n                if (done) break;\r\n\r\n                buffer += decoder.decode(value, { stream: true });\r\n                const lines = buffer.split('\\n');\r\n                buffer = lines.pop() ?? '';\r\n\r\n                for (const line of lines) {\r\n                    if (line.startsWith('data: ')) {\r\n                        const data = line.slice(6);\r\n                        if (data === '[DONE]') {\r\n                            yield { done: true };\r\n                            return;\r\n                        }\r\n                        try {\r\n                            const parsed = JSON.parse(data) as {\r\n                                choices: Array<{ delta: { content?: string } }>;\r\n                            };\r\n                            const content = parsed.choices[0]?.delta?.content;\r\n                            if (content) {\r\n                                yield { content, done: false };\r\n                            }\r\n                        } catch {\r\n                            // Skip malformed JSON\r\n                        }\r\n                    }\r\n                }\r\n            }\r\n        },\r\n\r\n        async embed(input: string | string[], options?: EmbeddingOptions): Promise<EmbeddingResult[]> {\r\n            const model = options?.model ?? 'text-embedding-3-small';\r\n            const inputs = Array.isArray(input) ? input : [input];\r\n\r\n            const body: Record<string, unknown> = { model, input: inputs };\r\n            if (options?.dimensions) body.dimensions = options.dimensions;\r\n\r\n            const response = await request('/embeddings', body) as {\r\n                data: Array<{ embedding: number[] }>;\r\n                usage?: { total_tokens: number };\r\n            };\r\n\r\n            return response.data.map(d => ({\r\n                embedding: d.embedding,\r\n                usage: response.usage ? { totalTokens: response.usage.total_tokens } : undefined,\r\n            }));\r\n        },\r\n    };\r\n\r\n    return adapter;\r\n};\r\n\r\nexport default openai;\r\n"]}

package/dist/index.d.ts

@@ -0,0 +1,157 @@
+/**
+ * @flightdev/ai - Agnostic AI/LLM Integration
+ *
+ * Flight provides AI primitives, you choose the provider.
+ *
+ * @example
+ * ```typescript
+ * import { createAI } from '@flightdev/ai';
+ * import { openai } from '@flightdev/ai/openai';
+ *
+ * const ai = createAI(openai({ apiKey: process.env.OPENAI_API_KEY }));
+ *
+ * const response = await ai.chat([
+ *   { role: 'user', content: 'Hello!' }
+ * ]);
+ * ```
+ */
+/** Message role */
+type MessageRole = 'system' | 'user' | 'assistant' | 'tool';
+/** Chat message */
+interface ChatMessage {
+    role: MessageRole;
+    content: string;
+    name?: string;
+    toolCallId?: string;
+}
+/** Tool definition */
+interface ToolDefinition {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+}
+/** Tool call from assistant */
+interface ToolCall {
+    id: string;
+    name: string;
+    arguments: Record<string, unknown>;
+}
+/** Chat completion options */
+interface ChatOptions {
+    /** Model to use */
+    model?: string;
+    /** Temperature (0-2) */
+    temperature?: number;
+    /** Max tokens to generate */
+    maxTokens?: number;
+    /** Stop sequences */
+    stop?: string[];
+    /** Available tools */
+    tools?: ToolDefinition[];
+    /** System prompt */
+    system?: string;
+    /** Stream response */
+    stream?: boolean;
+}
+/** Chat completion result */
+interface ChatResult {
+    /** Generated content */
+    content: string;
+    /** Tool calls (if any) */
+    toolCalls?: ToolCall[];
+    /** Finish reason */
+    finishReason: 'stop' | 'length' | 'tool_calls' | 'error';
+    /** Usage stats */
+    usage?: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+}
+/** Streaming chunk */
+interface StreamChunk {
+    /** Content delta */
+    content?: string;
+    /** Tool call delta */
+    toolCall?: Partial<ToolCall>;
+    /** Is final chunk */
+    done: boolean;
+}
+/** Embedding options */
+interface EmbeddingOptions {
+    model?: string;
+    dimensions?: number;
+}
+/** Embedding result */
+interface EmbeddingResult {
+    embedding: number[];
+    usage?: {
+        totalTokens: number;
+    };
+}
+/**
+ * AI Adapter Interface
+ *
+ * Implement this to create a custom AI provider.
+ */
+interface AIAdapter {
+    /** Adapter name */
+    readonly name: string;
+    /** List available models */
+    listModels(): Promise<string[]>;
+    /** Generate chat completion */
+    chat(messages: ChatMessage[], options?: ChatOptions): Promise<ChatResult>;
+    /** Generate streaming chat completion */
+    chatStream(messages: ChatMessage[], options?: ChatOptions): AsyncIterable<StreamChunk>;
+    /** Generate embeddings */
+    embed(input: string | string[], options?: EmbeddingOptions): Promise<EmbeddingResult[]>;
+}
+/** Adapter factory type */
+type AIAdapterFactory<TConfig = unknown> = (config: TConfig) => AIAdapter;
+/** AI service options */
+interface AIServiceOptions {
+    /** Default model */
+    defaultModel?: string;
+    /** Default temperature */
+    defaultTemperature?: number;
+    /** Default max tokens */
+    defaultMaxTokens?: number;
+}
+/** AI service */
+interface AIService {
+    /** The underlying adapter */
+    readonly adapter: AIAdapter;
+    /** List available models */
+    listModels(): Promise<string[]>;
+    /** Generate chat completion */
+    chat(messages: ChatMessage[], options?: ChatOptions): Promise<ChatResult>;
+    /** Generate streaming chat completion */
+    chatStream(messages: ChatMessage[], options?: ChatOptions): AsyncIterable<StreamChunk>;
+    /** Generate embeddings */
+    embed(input: string | string[], options?: EmbeddingOptions): Promise<EmbeddingResult[]>;
+    /** Simple text generation (convenience) */
+    generate(prompt: string, options?: ChatOptions): Promise<string>;
+    /** Create a conversation context */
+    conversation(systemPrompt?: string): Conversation;
+}
+/** Conversation context */
+interface Conversation {
+    /** Message history */
+    readonly messages: ChatMessage[];
+    /** Add a message */
+    add(role: MessageRole, content: string): void;
+    /** Send and get response */
+    send(content: string, options?: ChatOptions): Promise<string>;
+    /** Reset conversation */
+    reset(): void;
+}
+/**
+ * Create an AI service
+ */
+declare function createAI(adapter: AIAdapter, options?: AIServiceOptions): AIService;
+/** Count approximate tokens (rough estimation) */
+declare function estimateTokens(text: string): number;
+/** Truncate text to fit token limit */
+declare function truncateToTokens(text: string, maxTokens: number): string;
+
+export { type AIAdapter, type AIAdapterFactory, type AIService, type AIServiceOptions, type ChatMessage, type ChatOptions, type ChatResult, type Conversation, type EmbeddingOptions, type EmbeddingResult, type MessageRole, type StreamChunk, type ToolCall, type ToolDefinition, createAI, estimateTokens, truncateToTokens };

package/dist/index.js

@@ -0,0 +1,70 @@
+// src/index.ts
+function createAI(adapter, options = {}) {
+  const { defaultModel, defaultTemperature, defaultMaxTokens } = options;
+  function mergeOptions(opts) {
+    return {
+      model: opts?.model ?? defaultModel,
+      temperature: opts?.temperature ?? defaultTemperature,
+      maxTokens: opts?.maxTokens ?? defaultMaxTokens,
+      ...opts
+    };
+  }
+  const service = {
+    adapter,
+    listModels() {
+      return adapter.listModels();
+    },
+    chat(messages, options2) {
+      return adapter.chat(messages, mergeOptions(options2));
+    },
+    chatStream(messages, options2) {
+      return adapter.chatStream(messages, mergeOptions(options2));
+    },
+    embed(input, options2) {
+      return adapter.embed(input, options2);
+    },
+    async generate(prompt, options2) {
+      const result = await adapter.chat(
+        [{ role: "user", content: prompt }],
+        mergeOptions(options2)
+      );
+      return result.content;
+    },
+    conversation(systemPrompt) {
+      const messages = [];
+      if (systemPrompt) {
+        messages.push({ role: "system", content: systemPrompt });
+      }
+      return {
+        get messages() {
+          return [...messages];
+        },
+        add(role, content) {
+          messages.push({ role, content });
+        },
+        async send(content, options2) {
+          messages.push({ role: "user", content });
+          const result = await service.chat(messages, options2);
+          messages.push({ role: "assistant", content: result.content });
+          return result.content;
+        },
+        reset() {
+          messages.length = systemPrompt ? 1 : 0;
+        }
+      };
+    }
+  };
+  return service;
+}
+function estimateTokens(text) {
+  return Math.ceil(text.length / 4);
+}
+function truncateToTokens(text, maxTokens) {
+  const estimatedChars = maxTokens * 4;
+  if (text.length <= estimatedChars) return text;
+  return text.slice(0, estimatedChars - 3) + "...";
+}
+
+export { createAI, estimateTokens, truncateToTokens };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":["options"],"mappings":"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","file":"index.js","sourcesContent":["/**\r\n * @flightdev/ai - Agnostic AI/LLM Integration\r\n * \r\n * Flight provides AI primitives, you choose the provider.\r\n * \r\n * @example\r\n * ```typescript\r\n * import { createAI } from '@flightdev/ai';\r\n * import { openai } from '@flightdev/ai/openai';\r\n * \r\n * const ai = createAI(openai({ apiKey: process.env.OPENAI_API_KEY }));\r\n * \r\n * const response = await ai.chat([\r\n *   { role: 'user', content: 'Hello!' }\r\n * ]);\r\n * ```\r\n */\r\n\r\n// ============================================================================\r\n// Types\r\n// ============================================================================\r\n\r\n/** Message role */\r\nexport type MessageRole = 'system' | 'user' | 'assistant' | 'tool';\r\n\r\n/** Chat message */\r\nexport interface ChatMessage {\r\n    role: MessageRole;\r\n    content: string;\r\n    name?: string;\r\n    toolCallId?: string;\r\n}\r\n\r\n/** Tool definition */\r\nexport interface ToolDefinition {\r\n    name: string;\r\n    description: string;\r\n    parameters: Record<string, unknown>;\r\n}\r\n\r\n/** Tool call from assistant */\r\nexport interface ToolCall {\r\n    id: string;\r\n    name: string;\r\n    arguments: Record<string, unknown>;\r\n}\r\n\r\n/** Chat completion options */\r\nexport interface ChatOptions {\r\n    /** Model to use */\r\n    model?: string;\r\n    /** Temperature (0-2) */\r\n    temperature?: number;\r\n    /** Max tokens to generate */\r\n    maxTokens?: number;\r\n    /** Stop sequences */\r\n    stop?: string[];\r\n    /** Available tools */\r\n    tools?: ToolDefinition[];\r\n    /** System prompt */\r\n    system?: string;\r\n    /** Stream response */\r\n    stream?: boolean;\r\n}\r\n\r\n/** Chat completion result */\r\nexport interface ChatResult {\r\n    /** Generated content */\r\n    content: string;\r\n    /** Tool calls (if any) */\r\n    toolCalls?: ToolCall[];\r\n    /** Finish reason */\r\n    finishReason: 'stop' | 'length' | 'tool_calls' | 'error';\r\n    /** Usage stats */\r\n    usage?: {\r\n        promptTokens: number;\r\n        completionTokens: number;\r\n        totalTokens: number;\r\n    };\r\n}\r\n\r\n/** Streaming chunk */\r\nexport interface StreamChunk {\r\n    /** Content delta */\r\n    content?: string;\r\n    /** Tool call delta */\r\n    toolCall?: Partial<ToolCall>;\r\n    /** Is final chunk */\r\n    done: boolean;\r\n}\r\n\r\n/** Embedding options */\r\nexport interface EmbeddingOptions {\r\n    model?: string;\r\n    dimensions?: number;\r\n}\r\n\r\n/** Embedding result */\r\nexport interface EmbeddingResult {\r\n    embedding: number[];\r\n    usage?: { totalTokens: number };\r\n}\r\n\r\n// ============================================================================\r\n// Adapter Interface\r\n// ============================================================================\r\n\r\n/**\r\n * AI Adapter Interface\r\n * \r\n * Implement this to create a custom AI provider.\r\n */\r\nexport interface AIAdapter {\r\n    /** Adapter name */\r\n    readonly name: string;\r\n\r\n    /** List available models */\r\n    listModels(): Promise<string[]>;\r\n\r\n    /** Generate chat completion */\r\n    chat(messages: ChatMessage[], options?: ChatOptions): Promise<ChatResult>;\r\n\r\n    /** Generate streaming chat completion */\r\n    chatStream(messages: ChatMessage[], options?: ChatOptions): AsyncIterable<StreamChunk>;\r\n\r\n    /** Generate embeddings */\r\n    embed(input: string | string[], options?: EmbeddingOptions): Promise<EmbeddingResult[]>;\r\n}\r\n\r\n/** Adapter factory type */\r\nexport type AIAdapterFactory<TConfig = unknown> = (config: TConfig) => AIAdapter;\r\n\r\n// ============================================================================\r\n// AI Service\r\n// ============================================================================\r\n\r\n/** AI service options */\r\nexport interface AIServiceOptions {\r\n    /** Default model */\r\n    defaultModel?: string;\r\n    /** Default temperature */\r\n    defaultTemperature?: number;\r\n    /** Default max tokens */\r\n    defaultMaxTokens?: number;\r\n}\r\n\r\n/** AI service */\r\nexport interface AIService {\r\n    /** The underlying adapter */\r\n    readonly adapter: AIAdapter;\r\n\r\n    /** List available models */\r\n    listModels(): Promise<string[]>;\r\n\r\n    /** Generate chat completion */\r\n    chat(messages: ChatMessage[], options?: ChatOptions): Promise<ChatResult>;\r\n\r\n    /** Generate streaming chat completion */\r\n    chatStream(messages: ChatMessage[], options?: ChatOptions): AsyncIterable<StreamChunk>;\r\n\r\n    /** Generate embeddings */\r\n    embed(input: string | string[], options?: EmbeddingOptions): Promise<EmbeddingResult[]>;\r\n\r\n    /** Simple text generation (convenience) */\r\n    generate(prompt: string, options?: ChatOptions): Promise<string>;\r\n\r\n    /** Create a conversation context */\r\n    conversation(systemPrompt?: string): Conversation;\r\n}\r\n\r\n/** Conversation context */\r\nexport interface Conversation {\r\n    /** Message history */\r\n    readonly messages: ChatMessage[];\r\n\r\n    /** Add a message */\r\n    add(role: MessageRole, content: string): void;\r\n\r\n    /** Send and get response */\r\n    send(content: string, options?: ChatOptions): Promise<string>;\r\n\r\n    /** Reset conversation */\r\n    reset(): void;\r\n}\r\n\r\n// ============================================================================\r\n// Factory\r\n// ============================================================================\r\n\r\n/**\r\n * Create an AI service\r\n */\r\nexport function createAI(adapter: AIAdapter, options: AIServiceOptions = {}): AIService {\r\n    const { defaultModel, defaultTemperature, defaultMaxTokens } = options;\r\n\r\n    function mergeOptions(opts?: ChatOptions): ChatOptions {\r\n        return {\r\n            model: opts?.model ?? defaultModel,\r\n            temperature: opts?.temperature ?? defaultTemperature,\r\n            maxTokens: opts?.maxTokens ?? defaultMaxTokens,\r\n            ...opts,\r\n        };\r\n    }\r\n\r\n    const service: AIService = {\r\n        adapter,\r\n\r\n        listModels() {\r\n            return adapter.listModels();\r\n        },\r\n\r\n        chat(messages, options) {\r\n            return adapter.chat(messages, mergeOptions(options));\r\n        },\r\n\r\n        chatStream(messages, options) {\r\n            return adapter.chatStream(messages, mergeOptions(options));\r\n        },\r\n\r\n        embed(input, options) {\r\n            return adapter.embed(input, options);\r\n        },\r\n\r\n        async generate(prompt, options) {\r\n            const result = await adapter.chat(\r\n                [{ role: 'user', content: prompt }],\r\n                mergeOptions(options)\r\n            );\r\n            return result.content;\r\n        },\r\n\r\n        conversation(systemPrompt) {\r\n            const messages: ChatMessage[] = [];\r\n\r\n            if (systemPrompt) {\r\n                messages.push({ role: 'system', content: systemPrompt });\r\n            }\r\n\r\n            return {\r\n                get messages() {\r\n                    return [...messages];\r\n                },\r\n\r\n                add(role: MessageRole, content: string) {\r\n                    messages.push({ role, content });\r\n                },\r\n\r\n                async send(content: string, options?: ChatOptions) {\r\n                    messages.push({ role: 'user', content });\r\n                    const result = await service.chat(messages, options);\r\n                    messages.push({ role: 'assistant', content: result.content });\r\n                    return result.content;\r\n                },\r\n\r\n                reset() {\r\n                    messages.length = systemPrompt ? 1 : 0;\r\n                },\r\n            };\r\n        },\r\n    };\r\n\r\n    return service;\r\n}\r\n\r\n// ============================================================================\r\n// Utilities\r\n// ============================================================================\r\n\r\n/** Count approximate tokens (rough estimation) */\r\nexport function estimateTokens(text: string): number {\r\n    // Rough estimation: ~4 chars per token for English\r\n    return Math.ceil(text.length / 4);\r\n}\r\n\r\n/** Truncate text to fit token limit */\r\nexport function truncateToTokens(text: string, maxTokens: number): string {\r\n    const estimatedChars = maxTokens * 4;\r\n    if (text.length <= estimatedChars) return text;\r\n    return text.slice(0, estimatedChars - 3) + '...';\r\n}\r\n"]}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@flightdev/ai",
+  "version": "0.0.2",
+  "description": "Agnostic AI/LLM integration for Flight Framework. Choose your provider: OpenAI, Anthropic, Ollama, or custom.",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./openai": {
+      "types": "./dist/adapters/openai.d.ts",
+      "import": "./dist/adapters/openai.js"
+    },
+    "./anthropic": {
+      "types": "./dist/adapters/anthropic.d.ts",
+      "import": "./dist/adapters/anthropic.js"
+    },
+    "./ollama": {
+      "types": "./dist/adapters/ollama.d.ts",
+      "import": "./dist/adapters/ollama.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {},
+  "peerDependencies": {
+    "openai": ">=4.0.0",
+    "ai": ">=3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "openai": {
+      "optional": true
+    },
+    "ai": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^2.0.0"
+  },
+  "keywords": [
+    "flight",
+    "ai",
+    "llm",
+    "openai",
+    "anthropic",
+    "ollama"
+  ],
+  "license": "MIT",
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}