provider-kit 1.2.0 → 1.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "provider-kit",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "42 LLM provider unified API — one interface for OpenAI, Anthropic, Ollama, OpenRouter, and 38 more. Built-in retry, timeout, and error handling.",
   "type": "module",
   "main": "./src/index.js",

package/src/index.js

@@ -10,7 +10,7 @@
  *   const reply = await provider.chat('gpt-4', [{ role: 'user', content: 'Hi' }]);
  */
 
-export { ProviderError, AbortError, withRetry, withTimeout, safeProviderCall, classifyError, createCancelSignal, createRouter } from './providers/provider-error-adapter.js';
+export { ProviderError, AbortError, withRetry, withTimeout, safeProviderCall, classifyError, createCancelSignal, createRouter, createMonitor } from './providers/provider-error-adapter.js';
 export { ProviderManager, providerManager } from './providers/provider-manager.js';
 export { providerRegistry, createProvider, listPresetProviders, PRESET_PROVIDERS } from './providers/provider-registry.js';
 export { persistentConfig, createStore } from './core/persistent-config.js';

package/src/providers/provider-error-adapter.js

@@ -102,6 +102,59 @@ export function createCancelSignal() {
   };
 }
 
+/**
+ * createMonitor — observability wrapper
+ *
+ * Wraps provider calls with latency tracking, error classification,
+ * and logging hooks. No external dependencies.
+ *
+ * Usage:
+ *   const monitor = createMonitor({ onCall: (record) => console.table(record) });
+ *   const provider = monitor.wrap(await createProvider('openai', key));
+ *   await provider.chat('gpt-4', messages);
+ *   // → onCall receives { provider, model, latency, ok, error, timestamp }
+ */
+export function createMonitor(opts = {}) {
+  const onCall = opts.onCall || (() => {});
+
+  function wrap(provider) {
+    const origChat = provider.chat.bind(provider);
+    const origStream = provider.chatStream?.bind(provider);
+
+    provider.chat = async (model, messages, options) => {
+      const start = Date.now();
+      try {
+        const result = await origChat(model, messages, options);
+        onCall({ provider: provider.name || 'unknown', model, latency: Date.now() - start, ok: true, tokens: result.usage?.total_tokens || 0, timestamp: Date.now() });
+        return result;
+      } catch (e) {
+        const ce = classifyError(e, provider.name);
+        onCall({ provider: provider.name || 'unknown', model, latency: Date.now() - start, ok: false, error: ce.type, message: ce.message, timestamp: Date.now() });
+        throw e;
+      }
+    };
+
+    if (origStream) {
+      provider.chatStream = async function* (model, messages, options) {
+        const start = Date.now();
+        try {
+          const stream = origStream(model, messages, options);
+          for await (const chunk of stream) yield chunk;
+          onCall({ provider: provider.name || 'unknown', model, latency: Date.now() - start, ok: true, timestamp: Date.now() });
+        } catch (e) {
+          const ce = classifyError(e, provider.name);
+          onCall({ provider: provider.name || 'unknown', model, latency: Date.now() - start, ok: false, error: ce.type, timestamp: Date.now() });
+          throw e;
+        }
+      };
+    }
+
+    return provider;
+  }
+
+  return { wrap };
+}
+
 /**
  * createRouter — model health probe + auto-routing
  *