ai-lcr 0.7.0 → 0.7.1

package/CHANGELOG.md

@@ -4,6 +4,21 @@ All notable changes to `ai-lcr` are documented here. The format follows
 [Keep a Changelog](https://keepachangelog.com/), and the project adheres to
 [Semantic Versioning](https://semver.org/).
 
+## [0.7.1] — 2026-06-20
+
+Async media adapters now forward a caller-supplied webhook URL to the provider,
+so async video jobs can complete by **push** instead of poll-only.
+
+### Added
+
+- **`metadata.webhookUrl` is forwarded to the provider on async `submit`.**
+  `runware-media` adds it as the `videoInference` task's `webhookURL`; `fal-media`
+  appends it as the `?fal_webhook=` query param on the submit POST. The webhook is
+  a push path — the caller still polls as a fallback. Fixed task fields stay
+  un-clobberable (placed after the input spread). `metadata` was previously
+  accepted but dropped, so the documented "webhook hint" never reached the
+  provider; now it does.
+
 ## [0.7.0] — 2026-06-20
 
 The text router now records the **provider-reported actual cost** when a provider

package/dist/index.cjs

@@ -2059,6 +2059,7 @@ function createRunwareMediaAdapter(config) {
     // (a `getResponse` poll). Image generation stays on the synchronous `run()`.
     async submit(req) {
       const taskUUID = crypto.randomUUID();
+      const webhookUrl = typeof req.metadata?.["webhookUrl"] === "string" ? req.metadata["webhookUrl"] : void 0;
       await postTask({
         outputType: "URL",
         includeCost: true,
@@ -2066,7 +2067,8 @@ function createRunwareMediaAdapter(config) {
         taskType: "videoInference",
         taskUUID,
         model: req.externalId,
-        deliveryMethod: "async"
+        deliveryMethod: "async",
+        ...webhookUrl ? { webhookURL: webhookUrl } : {}
       });
       return { requestId: taskUUID };
     },
@@ -2134,7 +2136,9 @@ function createFalMediaAdapter(config) {
   };
   const queueBase = (externalId) => externalId.split("/").slice(0, 2).join("/");
   async function submit(req) {
-    const submitRes = await fetchImpl(`${baseUrl}/${req.externalId}`, {
+    const webhookUrl = typeof req.metadata?.["webhookUrl"] === "string" ? req.metadata["webhookUrl"] : void 0;
+    const submitUrl = webhookUrl ? `${baseUrl}/${req.externalId}?fal_webhook=${encodeURIComponent(webhookUrl)}` : `${baseUrl}/${req.externalId}`;
+    const submitRes = await fetchImpl(submitUrl, {
       method: "POST",
       headers,
       body: JSON.stringify(req.input)

package/dist/index.js

@@ -2005,6 +2005,7 @@ function createRunwareMediaAdapter(config) {
     // (a `getResponse` poll). Image generation stays on the synchronous `run()`.
     async submit(req) {
       const taskUUID = crypto.randomUUID();
+      const webhookUrl = typeof req.metadata?.["webhookUrl"] === "string" ? req.metadata["webhookUrl"] : void 0;
       await postTask({
         outputType: "URL",
         includeCost: true,
@@ -2012,7 +2013,8 @@ function createRunwareMediaAdapter(config) {
         taskType: "videoInference",
         taskUUID,
         model: req.externalId,
-        deliveryMethod: "async"
+        deliveryMethod: "async",
+        ...webhookUrl ? { webhookURL: webhookUrl } : {}
       });
       return { requestId: taskUUID };
     },
@@ -2080,7 +2082,9 @@ function createFalMediaAdapter(config) {
   };
   const queueBase = (externalId) => externalId.split("/").slice(0, 2).join("/");
   async function submit(req) {
-    const submitRes = await fetchImpl(`${baseUrl}/${req.externalId}`, {
+    const webhookUrl = typeof req.metadata?.["webhookUrl"] === "string" ? req.metadata["webhookUrl"] : void 0;
+    const submitUrl = webhookUrl ? `${baseUrl}/${req.externalId}?fal_webhook=${encodeURIComponent(webhookUrl)}` : `${baseUrl}/${req.externalId}`;
+    const submitRes = await fetchImpl(submitUrl, {
       method: "POST",
       headers,
       body: JSON.stringify(req.input)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-lcr",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "Least Cost Routing for LLMs — route every model call to the cheapest available provider, fall back automatically, and track real cost. Built for the Vercel AI SDK.",
   "keywords": [
     "ai",