@chinudotdev/provider-openai 0.1.0 → 0.1.2

package/README.md

@@ -0,0 +1,66 @@
+# @chinudotdev/provider-openai
+
+OpenAI-compatible **agent-core/v1** provider adapter — Chat Completions API, SSE streaming, tools, images, reasoning extensions.
+
+Works with OpenAI, Azure OpenAI, and any OpenAI-compatible endpoint.
+
+## Install
+
+```bash
+npm install @chinudotdev/provider-openai
+```
+
+## Quick start
+
+```typescript
+import { createOpenAIProvider } from "@chinudotdev/provider-openai";
+
+const provider = createOpenAIProvider({
+  apiKey: process.env.OPENAI_API_KEY!,
+  baseURL: "https://api.openai.com", // optional
+});
+
+for await (const event of provider.stream(
+  {
+    spec: "agent-core/v1",
+    model: "gpt-4o-mini",
+    messages: [{ role: "user", content: [{ type: "text", text: "Hello" }] }],
+  },
+  new AbortController().signal,
+)) {
+  if (event.type === "text_delta") process.stdout.write(event.text);
+  if (event.type === "stop") break;
+}
+```
+
+## Environment helper
+
+```typescript
+import { createProviderFromEnv } from "@chinudotdev/provider-openai";
+// Reads OPENAI_API_KEY, optional OPENAI_BASE_URL
+```
+
+## With Agent SDK
+
+```typescript
+import { Agent } from "@chinudotdev/agent";
+import { createProviderFromEnv } from "@chinudotdev/provider-openai";
+
+const agent = new Agent({
+  model: "gpt-4o-mini",
+  provider: createProviderFromEnv(),
+});
+```
+
+## Examples
+
+After install, a minimal smoke script ships at `node_modules/@chinudotdev/provider-openai/examples/01-chat.ts`.
+
+## Docs
+
+- [Provider guide](https://github.com/chinudotdev/agent-sdk/tree/main/packages/providers)
+- [Examples](https://github.com/chinudotdev/agent-sdk/tree/main/packages/providers/openai/examples)
+
+## License
+
+MIT

package/examples/01-chat.ts

@@ -0,0 +1,30 @@
+/**
+ * Minimal provider smoke — no Agent SDK.
+ *
+ * Env: OPENAI_API_KEY (required), OPENAI_BASE_URL (optional), OPENAI_MODEL (optional, default gpt-4o-mini)
+ * Run: bun run packages/providers/openai/examples/01-chat.ts
+ *      npx tsx packages/providers/openai/examples/01-chat.ts
+ */
+import { createProviderFromEnv } from "@chinudotdev/provider-openai";
+
+const provider = createProviderFromEnv();
+const model = process.env.OPENAI_MODEL ?? "gpt-4o-mini";
+
+for await (const event of provider.stream(
+  {
+    spec: "agent-core/v1",
+    model,
+    messages: [
+      { role: "user", content: [{ type: "text", text: "Say hello in one sentence." }] },
+    ],
+  },
+  new AbortController().signal,
+)) {
+  if (event.type === "text_delta") {
+    process.stdout.write(event.text);
+  }
+  if (event.type === "stop" || event.type === "error") {
+    break;
+  }
+}
+console.log();

package/package.json

@@ -1,10 +1,22 @@
 {
   "name": "@chinudotdev/provider-openai",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "OpenAI-compatible agent-core/v1 provider adapter",
   "type": "module",
   "license": "MIT",
   "sideEffects": false,
+  "homepage": "https://github.com/chinudotdev/agent-sdk/tree/main/packages/providers/openai#readme",
+  "bugs": {
+    "url": "https://github.com/chinudotdev/agent-sdk/issues"
+  },
+  "keywords": [
+    "agent",
+    "agent-core",
+    "openai",
+    "provider",
+    "llm",
+    "typescript"
+  ],
   "repository": {
     "type": "git",
     "url": "git+https://github.com/chinudotdev/agent-sdk.git",
@@ -14,7 +26,9 @@
     "access": "public"
   },
   "files": [
-    "dist"
+    "dist",
+    "README.md",
+    "examples"
   ],
   "exports": {
     ".": {