@rcrsr/rill-ext-openai 0.16.0 → 0.18.1

package/README.md

@@ -1,8 +1,6 @@
 # @rcrsr/rill-ext-openai
 
-[rill](https://rill.run) extension for [OpenAI](https://platform.openai.com/docs) API integration. Provides `message`, `messages`, `embed`, `embed_batch`, `tool_loop`, and `generate` host functions. Compatible with any OpenAI-compatible server (LM Studio, Ollama, vLLM).
-
-> **Experimental.** Breaking changes will occur before stabilization.
+[rill](https://rill.run) extension for [OpenAI](https://platform.openai.com/docs) API integration. Provides `message`, `messages`, `embed`, `embed_batch`, `tool_loop`, and `generate` host functions. Compatible with OpenAI-compatible servers (LM Studio, Ollama, vLLM).
 
 ## Install
 
@@ -10,42 +8,54 @@
 npm install @rcrsr/rill-ext-openai
 ```
 
-**Peer dependencies:** `@rcrsr/rill`
-
 ## Quick Start
 
-```typescript
-import { parse, execute, createRuntimeContext, prefixFunctions } from '@rcrsr/rill';
-import { createOpenAIExtension } from '@rcrsr/rill-ext-openai';
+**rill-config.json**
+
+```json
+{
+  "main": "hello.rill",
+  "extensions": {
+    "mounts": {
+      "llm": "@rcrsr/rill-ext-openai"
+    },
+    "config": {
+      "llm": {
+        "api_key": "${OPENAI_API_KEY}",
+        "model": "gpt-4o"
+      }
+    }
+  }
+}
+```
+
+**hello.rill**
+
+```rill
+use<ext:llm> => $llm
 
-const ext = createOpenAIExtension({
-  api_key: process.env.OPENAI_API_KEY!,
-  model: 'gpt-4o',
-});
-const prefixed = prefixFunctions('openai', ext);
-const { dispose, ...functions } = prefixed;
+$llm.message("Explain TCP handshakes") -> each { log }
+```
 
-const ctx = createRuntimeContext({
-  functions,
-  callbacks: { onLog: (v) => console.log(v) },
-});
+```bash
+rill-run
+```
 
-const script = `openai::message("Explain TCP handshakes")`;
-const result = await execute(parse(script), ctx);
+For local models, set `base_url` to point at the compatible server:
 
-dispose?.();
+```json
+{
+  "llm": {
+    "base_url": "http://localhost:1234/v1",
+    "model": "llama3"
+  }
+}
 ```
 
 ## Documentation
 
 See [full documentation](docs/extension-llm-openai.md) for configuration, functions, error handling, events, and examples.
 
-## Related
-
-- [rill](https://github.com/rcrsr/rill) — Core language runtime
-- [Extensions Guide](https://github.com/rcrsr/rill/blob/main/docs/integration-extensions.md) — Extension contract and patterns
-- [Host API Reference](https://github.com/rcrsr/rill/blob/main/docs/ref-host-api.md) — Runtime context and host functions
-
 ## License
 
 MIT

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 // Generated by dts-bundle-generator v9.5.1
 
-import { ExtensionConfigSchema, ExtensionManifest, ExtensionResult } from '@rcrsr/rill';
+import { ExtensionConfigSchema, ExtensionFactoryResult, ExtensionManifest } from '@rcrsr/rill';
 
 /**
  * Base configuration for LLM extensions
@@ -72,7 +72,7 @@ export type OpenAIExtensionConfig = LLMProviderConfig;
  * await ext.dispose();
  * ```
  */
-export declare function createOpenAIExtension(config: OpenAIExtensionConfig): ExtensionResult;
+export declare function createOpenAIExtension(config: OpenAIExtensionConfig): ExtensionFactoryResult;
 export declare const VERSION: string;
 export declare const configSchema: ExtensionConfigSchema;
 export declare const extensionManifest: ExtensionManifest;