@homie-rocks/studio 0.51.4 → 0.51.6

package/worker/mcp-tools.mjs

@@ -14,6 +14,7 @@ export async function allowed(audience, caller, env) {
   if (audience === 'signed-in') return true;
   if (audience === 'owner') return caller.owner === true;
   if (audience && typeof audience === 'object' && audience.app && audience.role) {
+    if(env.HOMIE_LOCAL_TEST_SECRET && caller.localTest)return caller.owner || Boolean(caller.roles?.[audience.app]?.includes(audience.role));
     return caller.owner || Boolean(await env.DB.prepare("SELECT player FROM app_roles WHERE app IN (?1,'*') AND role=?2 AND player=?3").bind(audience.app,audience.role,caller.id).first());
   }
   return false;
@@ -86,7 +87,7 @@ export function builtins(env,cat,origin) {
       const {readableFeed,feedEvents,matchesFeed,eventFeeds}=await import('./event-resources.mjs');
       if(!await readableFeed(env,cat,ctx.caller,feed))throw new Error('Event feed unavailable');
       if(!Number.isSafeInteger(after)||after<0)throw new Error('Invalid event cursor');
-      const page=await feedEvents(env,feed,{after});
+      const page=await feedEvents(env,feed,{after,caller:ctx.caller});
       return {kind:'untrusted-event-data',events:page.filter(e=>matchesFeed(eventFeeds(env)[feed],e)),next:page.length===100?page.at(-1).seq:null};
     }),
     tool('studio_events_webhook_status','Owner delivery attempts, last errors and next page for an outbound event webhook.','owner',object({feed:str,after:{type:'integer',minimum:0}},['feed']),async({feed,after},ctx)=>{
@@ -105,6 +106,23 @@ export function builtins(env,cat,origin) {
       const {replayFunction,runFunctions}=await import('./functions.mjs');
       await replayFunction(env,name);await runFunctions(env,cat,origin);return {ok:true};
     }),
+    tool('studio_schedule_fire','Locally invoke a named scheduled function at a simulated timestamp.','owner',object({name:str,at:{type:'integer',minimum:0}},['name','at']),async({name,at},ctx)=>{
+      if(!env.HOMIE_LOCAL_TEST_SECRET || !['localhost','127.0.0.1','[::1]'].includes(new URL(origin).hostname))throw new Error('Local dev testing only');
+      const {syncFunctions,emitEvent,runFunctions}=await import('./functions.mjs');
+      const definitions=await syncFunctions(env), fn=definitions.find(f=>f.name===name&&f.schedule);
+      if(!fn)throw new Error(`Unknown scheduled function ${name}; declare it and rebuild dev`);
+      const data={function:name,cron:fn.schedule,scheduledTime:at,...(ctx.caller.testScope?{app:`${ctx.caller.testApp}:check:${ctx.caller.testScope}`}:{})};
+      const id=await emitEvent(env,fn.event,data);
+      await runFunctions(env,cat,origin);
+      let run;const end=Date.now()+10000;
+      do {
+        run=await env.DB.prepare('SELECT outcome,error FROM function_runs WHERE event=?1 AND function=?2 ORDER BY started DESC LIMIT 1').bind(id,name).first();
+        if(run && !['running','interrupted'].includes(run.outcome))break;
+        await new Promise(resolve=>setTimeout(resolve,50));
+      }while(Date.now()<end);
+      if(!run || run.outcome!=='complete')throw new Error(`Schedule ${name}: ${run?.error??run?.outcome??'no handler run'}`);
+      return {id,name,scheduledTime:at,simulated:true};
+    }),
     tool('studio_function_fire','Fire an event locally through the durable function dispatcher.','owner',object({event:str,id:str,data:{type:'object'}},['event']),async(args)=>{
       if(!['localhost','127.0.0.1','[::1]'].includes(new URL(origin).hostname))throw new Error('Local testing only');
       const {emitEvent,runFunctions}=await import('./functions.mjs');

package/worker/mcp.mjs

@@ -82,7 +82,7 @@ export async function remoteMcp(request,env,ctx,{catalogueOf,definitions=[]}) {
         const readPage=async(resourceUri,after=0)=>read('events:'+name,async fresh=>{
           if(!await readableFeed(env,cat,fresh,name))throw new Error('Event resource unavailable');
           if(!Number.isSafeInteger(after)||after<0)throw new Error('Invalid event cursor');
-          const page=await feedEvents(env,name,{after});
+          const page=await feedEvents(env,name,{after,caller:fresh});
           const events=page.filter(e=>matchesFeed(eventFeeds(env)[name],e));
           return {contents:[{uri:String(resourceUri),mimeType:'application/json',text:JSON.stringify({kind:'untrusted-event-data',events,next:page.length===100?uri+'?after='+page.at(-1).seq:null})}]};
         });

package/worker/purchase-reconciliation.mjs

@@ -1,3 +1,4 @@
+import { stripeEventOwner } from './stripe-ownership.mjs';
 import { hasStripeKey, shopMode, rememberMoneyEvent, rememberedMoney } from './shop-links.mjs';
 import { paymentRefunds } from './shop-refunds.mjs';
 import { orderFact, bindHostedSession } from './purchase-core.mjs';
@@ -303,11 +304,25 @@ export async function reconcileOrder(env, o) {
 
 /** Called only AFTER the existing shop webhook signature/mode check. Return null for player orders. */
 export async function purchasePaymentEvent(env, event) {
+  const obj = event.data?.object ?? {};
+  const owner = stripeEventOwner(obj);
+  if (owner === 'shop') return null;
+  // Stripe can omit metadata on lifecycle events; an established shop subscription
+  // still belongs to the shop. Explicit ownership takes precedence over ID lookup.
+  if (!owner && (event.type.startsWith('invoice.') || event.type.startsWith('customer.subscription.'))) {
+    const subscription = event.type.startsWith('customer.subscription.') ? obj.id : idOf(obj.parent?.subscription_details?.subscription ?? obj.subscription);
+    if (subscription) {
+      try {
+        if (await env.DB.prepare('SELECT 1 FROM shop_subscriptions WHERE id = ?1').bind(subscription).first()) return null;
+      } catch (error) {
+        if (!/no such table: (?:main\.)?shop_subscriptions\b/.test(String(error?.message))) throw error;
+      }
+    }
+  }
   // An existing player shop may receive webhooks before purchase migrations run.
   try { await env.DB.prepare("SELECT 1 FROM purchase_orders LIMIT 0").first(); }
   catch (error) { if (/no such table/.test(error.message)) return null; throw error; }
 
-  const obj = event.data?.object ?? {};
   if (!event.type.startsWith('checkout.session.')) await rememberMoneyEvent(env,event);
   if (obj.payment_link && obj.metadata?.homie === 'purchase-links-v1') return reconcileLinkSession(env,obj);
   if (!hasStripeKey(env) && event.type.startsWith('customer.subscription.')) {

package/worker/shop-links.mjs

@@ -9,7 +9,7 @@ export function linkConfig(env) {
 export const shopMode = (env) => hasStripeKey(env) ? modeOf(env.STRIPE_KEY) : linkConfig(env)?.mode ?? 'test';
 export function linkSettings(shop) {
   return JSON.stringify({ currency: shop.currency, till: shop.till, automaticTax: shop.automaticTax, policy: shop.policy,
-    cap: shop.capPerPlayerMonth, checkoutMinutes: shop.checkoutMinutes, items: shop.items });
+    cap: shop.capPerPlayerMonth, checkoutMinutes: shop.checkoutMinutes, items: shop.items, ...(shop.basket ? {basket:shop.basket} : {}) });
 }
 export function fullerReason(shop) {
   if (shop.items.some(item => item.interval && item.price === 'choose')) return 'A giver-chosen monthly amount needs a Stripe Checkout connection.';

package/worker/shop-rules.mjs

@@ -209,7 +209,10 @@ export function checkShop(raw, { games = null, audience = 'general', studioName
   const kids = audience === 'kids' && !policy.kidsStudio;
   const finalTill = kids ? 'off' : TILLS.includes(till) ? till : 'off';
   if (kids && till !== 'off') warnings.push({ at: 'till', message: 'studio.json says "audience": "kids": the studio sells nothing in its games (the till is off under policy.kidsStudio).' });
+  if (raw.basket !== undefined && (!isObj(raw.basket) || typeof raw.basket.name !== "string" || !raw.basket.name.trim() || raw.basket.name.length > 120 || typeof raw.basket.description !== "string" || raw.basket.description.length > 500)) errors.push({at:"basket",message:"A basket needs a name (1–120 characters) and description (up to 500 characters)."});
+  if (raw.basket && (raw.automaticTax || till !== "stripe")) errors.push({at:"basket",message:"Saved baskets use Stripe with tax already included in the menu prices."});
   const shop = {
+    ...(isObj(raw.basket) ? {basket:{name:raw.basket.name,description:raw.basket.description}} : {}),
     v: 1, ...(isObj(raw.giving) ? { giving: { receiptText: String(raw.giving.receiptText ?? '') } } : {}), policy, purchasesTill: TILLS.includes(raw.purchasesTill ?? till) ? (raw.purchasesTill ?? till) : 'off', ...(/^https:\/\/billing\.stripe\.com\/p\/login\/[A-Za-z0-9_]+$/.test(raw.purchasesPortalLogin ?? '') ? { purchasesPortalLogin: raw.purchasesPortalLogin } : {}), checkoutMinutes, requestBytes, automaticTax: raw.automaticTax === true, guestBuyersPerAddressPerHour, purchaseAttemptsPerMinute, purchaseAttemptsPerAddressPerMinute, till: finalTill, currency: CURRENCY.test(currency) ? currency : 'usd', refundDays, capPerPlayerMonth: cap, items,
     open: finalTill !== 'off' && items.length > 0, ...(kids ? { audience: 'kids' } : {}), ...(catalog.length ? { catalog } : {}),
   };

package/worker/shop-subscriptions.mjs

@@ -1,3 +1,4 @@
+import { stripeEventOwner } from './stripe-ownership.mjs';
 import { linkConfig, hasStripeKey } from './shop-links.mjs';
 import { KEY_SHAPE, stripeCall } from './stripe.mjs';
 /** Only verified shop Checkout sessions establish ownership. Provider customer IDs
@@ -48,6 +49,7 @@ export async function bindSubscription(env, order, session, shop) {
 export async function subscriptionEvent(env, event, shop) {
   if (!['invoice.paid','invoice.payment_failed','customer.subscription.updated','customer.subscription.deleted'].includes(event.type)) return null;
   const obj=event.data.object;
+  if (stripeEventOwner(obj) === 'parts') return null;
   const subscription=event.type.startsWith('customer.subscription.') ? obj.id : idOf(obj.parent?.subscription_details?.subscription ?? obj.subscription);
   if (!subscription) return 'ignored';
   let row;

package/worker/shop.mjs

@@ -1,3 +1,4 @@
+import { stripeEventOwner } from './stripe-ownership.mjs';
 import { localSession } from './local-test.mjs';
 import { bindSubscription, subscriptionEvent, subscriptionPortal } from './shop-subscriptions.mjs';
 import { bookingStatement } from './booking-store.mjs';
@@ -162,10 +163,10 @@ export const MISSING_WORDS = Object.freeze({
   'shop.json-refused': 'shop.json conflicts with the studio settings or payment requirements (homie-studio shop check says which), so nothing is sold.',
   'till-off': 'shop.json says "till": "off".',
   items: 'shop.json has no items.',
-  'payment-links': 'Run homie-studio shop connect to sync your items and connect Stripe; approve its browser page if asked.',
-  'fuller-checkout': 'Your spending allowance or checkout expiry needs the fuller checkout connection. Ask your AI to connect it.',
-  'stripe-key': 'The Worker has no Stripe key yet (homie-studio shop connect: approve Stripe in your browser; the command names any remaining Worker credential step).',
-  'webhook-secret': 'The Worker has no webhook signing secret yet (run homie-studio shop connect to create and store it automatically).',
+  'payment-links': 'Ask your AI to plan and verify this shop through Stripe’s official plugin, then install its private webhook (homie-studio shop plan, shop verify, shop webhook).',
+  'fuller-checkout': 'These spending allowance, expiry or recurring amount settings are not supported by Payment Links. Ask your AI to review them with you before setup.',
+  'stripe-key': 'This older checkout connection is unavailable. Ask your AI to set up Payment Links through Stripe’s official plugin.',
+  'webhook-secret': 'Ask your AI to run homie-studio shop webhook after verifying the Stripe plugin setup; it installs the signing secret privately.',
   database: 'This Worker has no database.',
   migration: 'The shop\'s tables are not in the studio\'s D1 yet: npm run deploy applies migrations 0008_studio_shop.sql, 0010_shop_reservations.sql and 0012_shop_lines.sql.',
 });
@@ -516,7 +517,7 @@ async function startCheckout(env, url, cat, shop, item, { player, game, amount,
   const keyless = (amount > 0 || lines.some(l => l.item.interval)) && !hasStripeKey(env);
   const config=linkConfig(env);
   if(booking && amount===0 && !hasStripeKey(env) && config?.slots?.some(l=>l.app===game&&l.slots===booking.slots&&l.slot===booking.slot))return {error:fail(409,'booking','Publish a separate local slot for a free booking; it cannot share a paid Stripe capacity budget.')};
-  const menu=keyless && !booking && lines.length>1 ? config?.menus?.find(m=>lines.every(l=>m.items.some(i=>i.item===l.item.id))) : null;
+  const menu=keyless && !booking && lines.length>0 ? config?.menus?.find(m=>(m.basket || lines.length>1)&&lines.every(l=>m.items.some(i=>i.item===l.item.id))) : null;
   const link=keyless ? booking ? config?.slots?.find(l=>l.app===game&&l.collection===booking.collection&&l.slots===booking.slots&&l.slot===booking.slot&&l.item===item.id) : menu ?? config?.items.find(l=>l.item===item.id) : null;
   if(keyless && lines.length>1 && !menu)return {error:fail(409,'menu','These items need separate Stripe menus. Custom amounts and monthly gifts use their own links.')};
   if(keyless && (!link || !paymentLinkURL(link.url)))return {error:fail(503,'payment-links','Ask the owner’s AI to sync the shop and published booking slots.')};
@@ -532,7 +533,7 @@ async function startCheckout(env, url, cat, shop, item, { player, game, amount,
   }
   if(keyless && item.price==='choose' && lines[0].quantity!==1)return {error:fail(400,'quantity','A tip is one chosen amount; choose it on Stripe.')};
   if(menu && menu.items.some(e=>{const i=shop.items.find(i=>i.id===e.item);return !i || i.game && i.game!==game;}))return {error:fail(409,'menu','This menu includes items from another app; sync separate menus for each app.')};
-  if(menu)lines=menu.items.map(entry=>{const i=shop.items.find(i=>i.id===entry.item);return {item:i,quantity:1,amount:i.price};});
+  if(menu && !menu.basket)lines=menu.items.map(entry=>{const i=shop.items.find(i=>i.id===entry.item);return {item:i,quantity:1,amount:i.price};});
   if(keyless)lines=lines.map(l=>({...l,item:{...l.item,paymentLink:link,stripePrice:menu?.items.find(i=>i.item===l.item.id)?.price??link.price}}));
   const order = { id: newOrderId(), player: player.id, amount, currency: shop.currency };
   if (booking && reference === null) reference = order.id;
@@ -574,6 +575,7 @@ async function startCheckout(env, url, cat, shop, item, { player, game, amount,
   }
   if (keyless) {
     const checkout = new URL(link.url); checkout.searchParams.set('client_reference_id', order.id);
+    if(menu?.basket)checkout.searchParams.set('prefilled_amount',String(amount));
     return { order, url: checkout.href, reconciled };
   }
   let session = null;
@@ -832,6 +834,7 @@ async function hook(request, env, cat, shop, ready) {
       if (payment) await syncRefunds(env, payment);
       await env.DB.prepare('INSERT INTO shop_events (id, type, at) VALUES (?1, ?2, ?3) ON CONFLICT(id) DO NOTHING').bind(ev.id, ev.type, Date.now()).run(); return json({ ok: true, did: purchase }); }
   }
+  if (stripeEventOwner(obj) === 'parts') return json({ ok: true, did: 'ignored' });
   needed.push('payment_link.updated','invoice.paid','invoice.payment_failed','customer.subscription.updated','customer.subscription.deleted');
   if (!needed.includes(ev.type)) return json({ ok: true, did: 'ignored' });
   if (typeof ev.livemode === 'boolean' && (hasStripeKey(env) || linkConfig(env)) && ev.livemode !== (shopMode(env) === 'live')) return json({ ok: true, ignored: 'mode' });
@@ -953,6 +956,7 @@ async function bindLinkSession(env, session, mode) {
   if (!source || source.mode !== mode) return false;
   const lines = await orderLines(env, source.id);
   if (!lines.length || !lines[0].snapshot) return false;
+  if(JSON.parse(lines[0].snapshot).paymentLink?.basket) return bindBasketSession(env,session,source,lines);
   if(JSON.parse(lines[0].snapshot).paymentLink?.items) {
     const saved=await env.DB.prepare('SELECT value FROM meta WHERE key=?1').bind(`shop-menu:${source.id}`).first();
     const original=saved?JSON.parse(saved.value).map(l=>({item:l.item.id,snapshot:JSON.stringify(l.item),unit_amount:l.amount})):lines;
@@ -988,6 +992,50 @@ async function bindLinkSession(env, session, mode) {
   return true;
 }
 
+/** A saved basket is immutable. A reopened link buys that same basket again. */
+async function bindBasketSession(env,session,source,lines) {
+  const link=JSON.parse(lines[0].snapshot).paymentLink;
+  if((session.payment_link?.id??session.payment_link)!==link.id || session.metadata?.revision!==link.revision || session.currency!==source.currency)return false;
+  if(session.payment_status!=='paid' || !Number.isSafeInteger(session.amount_total) || session.amount_total<=0 || session.amount_subtotal!==session.amount_total)return false;
+  await env.DB.prepare('UPDATE shop_orders SET session=?2 WHERE id=?1 AND session IS NULL').bind(source.id,session.id).run();
+  let order=await orderBySession(env,session.id);
+  if(!order) {
+    const id=`ord_${(await sha256Hex(session.id)).slice(0,20)}`;
+    await env.DB.batch([
+      env.DB.prepare("INSERT OR IGNORE INTO shop_orders(id,player,checkout_player,item,game,amount,currency,till,mode,status,parent,created_at,updated_at,session) SELECT ?2,player,checkout_player,item,game,amount,currency,till,mode,'started',parent,?4,?4,?3 FROM shop_orders WHERE id=?1").bind(source.id,id,session.id,Date.now()),
+      env.DB.prepare('INSERT OR IGNORE INTO meta(key,value) SELECT ?1,value FROM meta WHERE key=?2').bind(`shop-reference:${id}`,`shop-reference:${source.id}`),
+      ...lines.map((l,i)=>env.DB.prepare('INSERT OR IGNORE INTO shop_order_lines(id,order_id,position,item,quantity,unit_amount,amount,snapshot) VALUES(?1,?2,?3,?4,?5,?6,?7,?8)').bind(`${id}_${i}`,id,i,l.item,l.quantity,l.unit_amount,l.amount,l.snapshot)),
+    ]);
+    order=await orderBySession(env,session.id);
+  }
+  return Boolean(order);
+}
+
+// Keep the actual payment in financial totals and the ordered amounts in lines.
+// Aggregate refunds are allocated proportionally; they do not change quantities.
+async function paidBasket(env,shop,o,lines,session,paidAt) {
+  const total=session.amount_total;
+  if(session.payment_status!=='paid' || session.currency!==o.currency || !Number.isSafeInteger(total) || total<=0 || session.amount_subtotal!==total)return 'mismatch';
+  if(o.paid_at!==null)return 'already';
+  const expected=lines.reduce((n,l)=>n+Number(l.amount),0);
+  if(!Number.isSafeInteger(expected)||expected<=0)return 'mismatch';
+  const writes=[];let cumulative=0,allocated=0;
+  for(const l of lines) {
+    cumulative+=Number(l.amount);
+    const next=Number(BigInt(total)*BigInt(cumulative)/BigInt(expected));
+    const gross=next-allocated;allocated=next;
+    if(total>=expected && o.player)writes.push(...grantStatements(env,o,JSON.parse(l.snapshot),paidAt,l));
+    writes.push(env.DB.prepare("UPDATE shop_order_lines SET status='paid',total=?2 WHERE id=?1 AND EXISTS(SELECT 1 FROM shop_orders WHERE id=?3 AND paid_at IS NULL)").bind(l.id,gross,o.id));
+  }
+  const payment=typeof session.payment_intent==='string'?session.payment_intent:session.payment_intent?.id;
+  writes.push(env.DB.prepare("UPDATE shop_orders SET status='paid',amount=?2,total=?2,tax=0,payment=?3,paid_at=?4,updated_at=?4,attention=0,note=?5 WHERE id=?1 AND paid_at IS NULL").bind(o.id,total,payment??null,paidAt,total<expected?'Settle the difference at the bar':''));
+  // Enrich the trigger's durable event in this same transaction, before dispatch.
+  writes.push(env.DB.prepare("UPDATE studio_events SET data=json_set(data,'$.basketTotal',?2,'$.settlement',?3) WHERE id=?1").bind(`shop_orders:${o.id}:paid`,expected,total<expected?'short':'paid'));
+  const result=await env.DB.batch(writes);
+  if(payment)await syncRefunds(env,payment);
+  return result.at(-2)?.meta?.changes?'paid':'already';
+}
+
 /** Menu totals are never decoded into quantities. Only signed invoice lines are authoritative. */
 async function bindMenuSession(env,session,source,lines) {
   const first=JSON.parse(lines[0].snapshot),link=first.paymentLink;
@@ -1027,7 +1075,9 @@ export async function paid(env, shop, session, paidAt = Date.now()) {
   const o = await orderBySession(env, session.id);
   if (!o) return 'unknown-order';
   // The session must be the one this order opened, for this player and this price.
-  const linkOrder = (await orderLines(env, o.id)).some((l) => l.snapshot && JSON.parse(l.snapshot).paymentLink);
+  const savedLines=await orderLines(env,o.id);
+  if(savedLines[0]?.snapshot && JSON.parse(savedLines[0].snapshot).paymentLink?.basket)return paidBasket(env,shop,o,savedLines,session,paidAt);
+  const linkOrder = savedLines.some((l) => l.snapshot && JSON.parse(l.snapshot).paymentLink);
   if (!linkOrder && (session.metadata?.order !== o.id || ((o.checkout_player ?? o.player) && session.client_reference_id && session.client_reference_id !== (o.checkout_player ?? o.player)))) return 'mismatch';
   if (session.currency !== o.currency || !Number.isSafeInteger(session.amount_subtotal) || session.amount_subtotal !== Number(o.amount)) return 'mismatch';
   if (['refunded', 'lost', 'disputed'].includes(o.status)) {
@@ -1194,7 +1244,7 @@ async function disputeClosed(env, payment, status) {
 }
 
 /** What the owner reads when Stripe holds a refund for approval (the shop's key is an Agent key). */
-export const REFUND_HELD = 'Stripe is holding this refund until a person approves it in Stripe (Settings, Approvals, Requests): the shop\'s Stripe key is marked as an Agent key, and Stripe asks a person before an agent\'s refund. Approve it there; Stripe then refunds, and the item leaves the player\'s account when Stripe says so. To refund with one tap again, connect the shop with a plain restricted key (homie-studio shop connect), not one made for "Authorizing agent access".';
+export const REFUND_HELD = 'Stripe is holding this refund for your approval in Stripe (Settings, Approvals, Requests). Approve it there; the item leaves the player’s account after Stripe confirms the refund. You can also manage refunds through your connected Stripe AI; no credential change is needed.';
 
 /** Refund selected lines through Stripe, revoking each only after success. */
 export async function refundOrder(env, o, { reason = 'requested_by_customer', by = 'owner', line: lineId = null } = {}) {

package/worker/stripe-ownership.mjs

@@ -0,0 +1,7 @@
+/** Subscription metadata takes precedence over invoice-level metadata. */
+export function stripeEventOwner(object) {
+  const metadata = object.parent?.subscription_details?.metadata ?? object.subscription_details?.metadata ?? object.metadata;
+  if (['shop-links-v1', 'shop-v1'].includes(metadata?.homie)) return 'shop';
+  if (['purchase-links-v1', 'purchase-v1'].includes(metadata?.homie)) return 'parts';
+  return null;
+}

package/worker/version.mjs

@@ -1,2 +1,2 @@
 /** The @homie-rocks/studio version this Worker code is (package.json's; a test keeps them equal). Cache-busts /_homie/site.js. */
-export const STUDIO_VERSION_TAG = '0.51.4';
+export const STUDIO_VERSION_TAG = '0.51.6';

package/guides/models/references/models.json

@@ -1,175 +0,0 @@
-{
-  "v": 1,
-  "checked": "2026-10-03",
-  "note": "The endpoints the models skill uses, with the prices and schemas read live on the date above (fal's pricing API, its OpenAPI pages, the providers' terms). Endpoints retire and reprice monthly: `models.mjs registry` reads every price again for free and flags what moved; every receipt names the exact endpoint. Never hard-code one of these anywhere else.",
-  "concept": {
-    "withRefs": {
-      "endpoint": "fal-ai/bytedance/seedream/v5/lite/edit",
-      "price": {
-        "usd": 0.035,
-        "per": "image",
-        "read": "2026-10-02"
-      },
-      "input": {
-        "num_images": 1,
-        "image_size": {
-          "width": 2048,
-          "height": 2048
-        }
-      },
-      "refs": "image_urls",
-      "maxRefs": 10,
-      "why": "the cheapest multi-reference editor: the golden images keep every prop in one style"
-    },
-    "noRefs": {
-      "endpoint": "fal-ai/bytedance/seedream/v5/lite/text-to-image",
-      "price": {
-        "usd": 0.035,
-        "per": "image",
-        "read": "2026-10-02"
-      },
-      "input": {
-        "num_images": 1,
-        "image_size": {
-          "width": 2048,
-          "height": 2048
-        }
-      },
-      "why": "before there are golden images; the derived style prompt carries the look"
-    },
-    "minPixels": 3686400
-  },
-  "mesh": {
-    "prop": {
-      "endpoint": "tripo3d/p1/image-to-3d",
-      "price": {
-        "usd": 0.5,
-        "per": "model with textures (0.40 without)",
-        "read": "2026-10-02"
-      },
-      "credits": {
-        "base": 40,
-        "texture": 10,
-        "defaults": {
-          "texture": true
-        }
-      },
-      "input": {
-        "texture": true
-      },
-      "faceLimit": "face_limit",
-      "output": "model_mesh",
-      "why": "Tripo P1: built for low-poly game meshes, a face_limit that reaches a phone budget, $0.50 textured"
-    },
-    "fallbacks": [
-      {
-        "endpoint": "fal-ai/hyper3d/rodin/v2.5",
-        "price": {
-          "usd": 0.4,
-          "per": "generation",
-          "read": "2026-10-02"
-        },
-        "why": "quad presets and texture_delight; not wired by default"
-      },
-      {
-        "endpoint": "fal-ai/trellis",
-        "price": {
-          "usd": 0.02,
-          "per": "generation",
-          "read": "2026-10-02"
-        },
-        "why": "drafts for exploring, then local simplify; not wired by default"
-      }
-    ]
-  },
-  "mood": {
-    "endpoint": "fal-ai/bytedance/seedream/v5/lite/text-to-image",
-    "price": {
-      "usd": 0.035,
-      "per": "image",
-      "read": "2026-10-02"
-    },
-    "input": {
-      "num_images": 1,
-      "image_size": {
-        "width": 2560,
-        "height": 1440
-      }
-    }
-  },
-  "terms": [
-    {
-      "who": "fal",
-      "url": "https://fal.ai/terms",
-      "read": "2026-10-02",
-      "lastUpdated": "2026-09-08",
-      "says": "Customer owns its input; no express assignment of output; output not promised original or non-infringing; no training competing models on third-party outputs."
-    },
-    {
-      "who": "Tripo (developer terms)",
-      "url": "https://developers.tripo3d.ai/en/terms",
-      "read": "2026-10-02",
-      "lastUpdated": "2025-07-11",
-      "says": "\"you may use Outputs for lawful commercial or non-commercial purposes\"."
-    },
-    {
-      "who": "Meshy (through fal)",
-      "url": "https://fal.ai/models/meshy/v7.1/image-to-3d",
-      "read": "2026-10-03",
-      "says": "fal labels the endpoint \"Commercial use\"; calls through fal are paid calls on the person's own fal account (fal's terms apply to the output). Meshy's own free plan (CC BY 4.0, Meshy owns output) does not apply: this skill never uses a Meshy free plan."
-    }
-  ],
-  "character": {
-    "mesh": {
-      "endpoint": "meshy/v7.1/image-to-3d",
-      "price": {
-        "usd": 1.4,
-        "per": "textured model with auto-rigging: US$0.80 base + US$0.40 textures + US$0.20 rigging (+US$0.12 an animation preset, not used)",
-        "read": "2026-10-03",
-        "api": "the pricing API says US$0.80 a generation (the base); the page's add-ons are added on top"
-      },
-      "addons": {
-        "base": 0.8,
-        "should_texture": 0.4,
-        "enable_rigging": 0.2,
-        "enable_animation": 0.12,
-        "defaults": {
-          "should_texture": true
-        }
-      },
-      "input": {
-        "model_type": "standard",
-        "topology": "triangle",
-        "target_polycount": 7000,
-        "should_remesh": true,
-        "should_texture": true,
-        "enable_pbr": false,
-        "pose_mode": "a-pose",
-        "enable_rigging": true,
-        "enable_animation": false,
-        "symmetry_mode": "on"
-      },
-      "polycount": "target_polycount",
-      "height": "rigging_height_meters",
-      "output": "rigged_character_glb",
-      "why": "Meshy 7.1 through fal: a textured mesh, a humanoid auto-rig and basic walk and run clips in one call, on the person's own fal account; the library's clips are retargeted onto its skeleton for free"
-    },
-    "rig": {
-      "endpoint": "fal-ai/meshy/rigging",
-      "price": {
-        "usd": 0.8,
-        "per": "request (the page says US$0.20; the pricing API says US$0.80: quoted at the higher until they agree)",
-        "read": "2026-10-03"
-      },
-      "addons": {
-        "base": 0.2,
-        "enable_animation": 0.12
-      },
-      "input": {
-        "enable_animation": false
-      },
-      "why": "rig a humanoid mesh made elsewhere (a Tripo prop-style mesh, the person's own); humanoids with clear limbs only; not wired by default"
-    },
-    "concept": "uses concept.withRefs or concept.noRefs: one full-body image in an A-pose, front view, plain background"
-  }
-}