@lunora/ai 1.0.0-alpha.25 → 1.0.0-alpha.26

package/README.md

@@ -36,7 +36,7 @@
 
 ---
 
-A small AI helper for Lunora, built on the [Vercel AI SDK](https://ai-sdk.dev) v6 core and Cloudflare's official [`workers-ai-provider`](https://github.com/cloudflare/ai). Call `generateText`/`streamText`/`generateObject`/`embed`/`tool` from any function handler. **Cloudflare Workers AI is the zero-config default**, but the helper is provider-agnostic: every call takes either a Workers AI model id (a string) or any AI SDK model object — `@ai-sdk/openai`, `@ai-sdk/anthropic`, OpenRouter, … — so apps are never locked to Workers AI. Pair `embed` with [`@lunora/bindings/vectors`](https://www.npmjs.com/package/@lunora/bindings) for RAG.
+A small AI helper for Lunora, built on the [Vercel AI SDK](https://ai-sdk.dev) v7 core and Cloudflare's official [`workers-ai-provider`](https://github.com/cloudflare/ai). Call `generateText`/`streamText`/`generateObject`/`embed`/`tool` from any function handler. **Cloudflare Workers AI is the zero-config default**, but the helper is provider-agnostic: every call takes either a Workers AI model id (a string) or any AI SDK model object — `@ai-sdk/openai`, `@ai-sdk/anthropic`, OpenRouter, … — so apps are never locked to Workers AI. Pair `embed` with [`@lunora/bindings/vectors`](https://www.npmjs.com/package/@lunora/bindings) for RAG.
 
 Part of the [Lunora](https://github.com/anolilab/lunora) framework — a type-safe, real-time backend on Cloudflare Workers + Durable Objects with a Vite-first DX.
 

package/dist/index.mjs

@@ -1,4 +1 @@
-export { default as createAi } from './packem_shared/createAi-Cep3l8Rk.mjs';
-export { AI_GATEWAY_ACCOUNT_ID_ENV, AI_GATEWAY_ID_ENV, AI_GATEWAY_TOKEN_ENV, buildAiGatewayMetadataFields, resolveAiGateway } from './packem_shared/AI_GATEWAY_ACCOUNT_ID_ENV-CIAjehQF.mjs';
-export { embed, embedMany, generateObject, generateText, hasToolCall, jsonSchema, streamObject, streamText, tool } from 'ai';
-export { createWorkersAI } from 'workers-ai-provider';
+import{default as a}from"./packem_shared/createAi-k_AcrXgH.mjs";import{AI_GATEWAY_ACCOUNT_ID_ENV as o,AI_GATEWAY_ID_ENV as A,AI_GATEWAY_TOKEN_ENV as _,buildAiGatewayMetadataFields as m,resolveAiGateway as l}from"./packem_shared/AI_GATEWAY_ACCOUNT_ID_ENV-JzYYnjLP.mjs";import{embed as T,embedMany as E,generateObject as d,generateText as x,hasToolCall as I,jsonSchema as b,streamObject as c,streamText as f,tool as i}from"ai";import{createWorkersAI as N}from"workers-ai-provider";export{o as AI_GATEWAY_ACCOUNT_ID_ENV,A as AI_GATEWAY_ID_ENV,_ as AI_GATEWAY_TOKEN_ENV,m as buildAiGatewayMetadataFields,a as createAi,N as createWorkersAI,T as embed,E as embedMany,d as generateObject,x as generateText,I as hasToolCall,b as jsonSchema,l as resolveAiGateway,c as streamObject,f as streamText,i as tool};

package/dist/packem_shared/AI_GATEWAY_ACCOUNT_ID_ENV-JzYYnjLP.mjs

@@ -0,0 +1 @@
+const r=(t,a)=>{const n=t[a];return typeof n=="string"&&n.length>0?n:void 0},c=t=>{if(t===void 0)return;const a={};return typeof t.functionPath=="string"&&t.functionPath.length>0&&(a.functionPath=t.functionPath),typeof t.traceId=="string"&&t.traceId.length>0&&(a.traceId=t.traceId),Object.keys(a).length>0?a:void 0},d=t=>{const a=c(t);return a===void 0?void 0:JSON.stringify(a)},s="LUNORA_AI_GATEWAY_ACCOUNT_ID",_="LUNORA_AI_GATEWAY_ID",I="LUNORA_AI_GATEWAY_TOKEN",u=(t,a)=>{const n=r(t,s),o=r(t,_);if(n===void 0||o===void 0)return;const e=r(t,I),i={};e!==void 0&&(i["cf-aig-authorization"]=`Bearer ${e}`);const A=d(a);return A!==void 0&&(i["cf-aig-metadata"]=A),{accountId:n,baseURL:`https://gateway.ai.cloudflare.com/v1/${n}/${o}`,gatewayId:o,headers:i}};export{s as AI_GATEWAY_ACCOUNT_ID_ENV,_ as AI_GATEWAY_ID_ENV,I as AI_GATEWAY_TOKEN_ENV,c as buildAiGatewayMetadataFields,u as resolveAiGateway};

package/dist/packem_shared/bm25LexicalStore-RA9sesFC.mjs

@@ -0,0 +1 @@
+const P=/[a-z0-9]+/g,x=l=>l.toLowerCase().match(P)??[],L=new WeakSet,k=()=>{const l=new Map,g=(s="")=>{let e=l.get(s);return e||(e={documents:new Map,postings:new Map,totalLength:0},l.set(s,e)),e},u=(s,e)=>{const t=g(s),o=t.documents.get(e);if(o){for(const r of o.termFrequency.keys()){const a=t.postings.get(r);a&&(a.delete(e),a.size===0&&t.postings.delete(r))}t.totalLength-=o.length,t.documents.delete(e)}},d={index:(s,e)=>{const t=g(e.namespace);for(const o of s){u(e.namespace,o.id);const r=x(o.text);if(r.length===0)continue;const a=new Map;for(const c of r)a.set(c,(a.get(c)??0)+1);for(const[c,f]of a){let n=t.postings.get(c);n||(n=new Map,t.postings.set(c,n)),n.set(o.id,f)}t.documents.set(o.id,{length:r.length,termFrequency:a,text:o.text}),t.totalLength+=r.length}return Promise.resolve()},remove:(s,e)=>{for(const t of s)u(e.namespace,t);return Promise.resolve()},search:(s,e)=>{if(e.filter&&Object.keys(e.filter).length>0)return L.has(d)||(L.add(d),console.warn("[@lunora/ai/rag] bm25LexicalStore cannot evaluate a metadata filter (it stores no metadata);\nthe lexical leg is skipped for filtered queries. Fold the RLS dimension into `namespace`,\nor plug a filter-aware RagLexicalStore, to keep a lexical leg under metadata-based RLS.")),Promise.resolve([]);const t=g(e.namespace),o=t.documents.size;if(o===0)return Promise.resolve([]);const r=[...new Set(x(s))];if(r.length===0)return Promise.resolve([]);const a=t.totalLength/o,c=new Map;for(const n of r){const i=t.postings.get(n);if(!i)continue;const p=i.size,v=Math.log(1+(o-p+.5)/(p+.5));for(const[m,h]of i){const w=t.documents.get(m);if(!w)continue;const M=h+1.5*(1-.75+.75*w.length/a),S=v*(h*(1.5+1)/M);c.set(m,(c.get(m)??0)+S)}}const f=[...c.entries()].map(([n,i])=>({id:n,score:i,text:t.documents.get(n)?.text??""}));return Promise.resolve(f.toSorted((n,i)=>i.score-n.score).slice(0,e.topK))}};return d};export{k as default};

package/dist/packem_shared/contentHash-BIn6ECP8.mjs

@@ -0,0 +1 @@
+const o=/^\.+/u,p={avif:"image/avif",bmp:"image/bmp",gif:"image/gif",ico:"image/x-icon",jpeg:"image/jpeg",jpg:"image/jpeg",png:"image/png",svg:"image/svg+xml",tiff:"image/tiff",tif:"image/tiff",webp:"image/webp",avi:"video/x-msvideo",mkv:"video/x-matroska",mov:"video/quicktime",mp4:"video/mp4",mpeg:"video/mpeg",mpg:"video/mpeg",webm:"video/webm",wmv:"video/x-ms-wmv",aac:"audio/aac",flac:"audio/flac",m4a:"audio/mp4",mp3:"audio/mpeg",ogg:"audio/ogg",opus:"audio/opus",wav:"audio/wav",wma:"audio/x-ms-wma",csv:"text/csv",doc:"application/msword",docx:"application/vnd.openxmlformats-officedocument.wordprocessingml.document",odp:"application/vnd.oasis.opendocument.presentation",ods:"application/vnd.oasis.opendocument.spreadsheet",odt:"application/vnd.oasis.opendocument.text",pdf:"application/pdf",ppt:"application/vnd.ms-powerpoint",pptx:"application/vnd.openxmlformats-officedocument.presentationml.presentation",rtf:"application/rtf",xls:"application/vnd.ms-excel",xlsx:"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",css:"text/css",html:"text/html",htm:"text/html",ini:"text/plain",json:"application/json",js:"text/javascript",mjs:"text/javascript",md:"text/markdown",jsx:"text/javascript",ts:"text/typescript",tsx:"text/typescript",txt:"text/plain",xml:"application/xml",yaml:"application/x-yaml",yml:"application/x-yaml","7z":"application/x-7z-compressed",bz2:"application/x-bzip2",gz:"application/gzip",jar:"application/java-archive",rar:"application/vnd.rar",tar:"application/x-tar",zip:"application/zip",otf:"font/otf",ttf:"font/ttf",woff:"font/woff",woff2:"font/woff2",bin:"application/octet-stream",epub:"application/epub+zip",exe:"application/vnd.microsoft.portable-executable",iso:"application/x-iso9660-image",sql:"application/sql",toml:"application/toml"},e=t=>{const a=t.replace(o,"").toLowerCase();return p[a]??"application/octet-stream"},n=async t=>{const a=await crypto.subtle.digest("SHA-256",t);return[...new Uint8Array(a)].map(i=>i.toString(16).padStart(2,"0")).join("")};export{n as contentHash,e as guessMimeTypeFromExtension};

package/dist/packem_shared/createAi-k_AcrXgH.mjs

@@ -0,0 +1 @@
+import{LunoraError as t}from"@lunora/errors";import{createWorkersAI as v}from"workers-ai-provider";import{buildAiGatewayMetadataFields as c,resolveAiGateway as A}from"./AI_GATEWAY_ACCOUNT_ID_ENV-JzYYnjLP.mjs";const I=(i,o,s)=>{const d=c(s);if(i!==void 0)return d!==void 0&&i.metadata===void 0?{...i,metadata:d}:i;if(o===void 0)return;const a=A(o,s);if(a!==void 0)return d===void 0?{id:a.gatewayId}:{id:a.gatewayId,metadata:d}},y=(i,o)=>v({binding:i,gateway:o}),h=i=>{const{binding:o,defaultEmbeddingModel:s,defaultModel:d,env:a,gateway:f,metadata:g,provider:m}=i;if(!m&&!o)throw new t("INTERNAL","@lunora/ai: createAi requires a `binding` (env.AI) or a pre-built `provider`");const u=I(f,a,g),n=m??y(o,u),p=e=>{if(e===void 0){if(!d)throw new t("INTERNAL","@lunora/ai: no model supplied and no `defaultModel` configured — pass a model id or an AI SDK model");return n(d)}return typeof e=="string"?n(e):e},w=e=>{const r=n.textEmbeddingModel;if(typeof r!="function")throw new t("INTERNAL","@lunora/ai: the Workers AI provider does not expose `textEmbeddingModel`; pass an AI SDK EmbeddingModel (e.g. from @ai-sdk/openai) to embed()");return r.call(n,e)};return{embeddingModel:e=>{if(typeof e=="object")return e;const r=e??s;if(!r)throw new t("INTERNAL","@lunora/ai: no embedding model supplied and no `defaultEmbeddingModel` configured — pass an embedding model id or an AI SDK EmbeddingModel");return w(r)},model:p,run:async(e,r,l)=>{if(!o)throw new t("INTERNAL","@lunora/ai: ai.run requires the `binding` (env.AI) — it is unavailable when only a custom `provider` was supplied");const b=u!==void 0&&l?.gateway===void 0?{...l,gateway:u}:l;return o.run(e,r,b)},workersai:n}};export{h as default};

package/dist/packem_shared/defineRag-BF3RwHZj.mjs

@@ -0,0 +1,8 @@
+import{LunoraError as x}from"@lunora/errors";import{tool as G,jsonSchema as J,embed as ee}from"ai";import te from"./fixedWindowChunks-XJRXHEoz.mjs";import ne from"./hybridRank-U6PmGuz1.mjs";const ae=8,re=async(e,s,h)=>{if(!Number.isInteger(s)||s<1)throw new RangeError("concurrentMap: `limit` must be a positive integer");if(e.length===0)return[];const b=Math.max(1,Math.min(s,e.length)),y=Array.from({length:e.length});let f=0,k=!1,v;const E=async()=>{for(;;){if(k)return;const I=f;if(f+=1,I>=e.length)return;try{y[I]=await h(e[I],I)}catch(N){k||(k=!0,v=N);return}}},m=Array.from({length:b},()=>E());if(await Promise.all(m),k)throw v;return y},oe=1e3,ie=200,se=5,ce=20,de=100,z="__ragChunk",V="__ragSource",A="__ragText",R="__ragHash",T="__ragChunks",M="__ragImportance",F="__ragModel",ue=new Set([z,T,R,M,F,V,A]),le=/^[\w.-]{1,40}$/,P=e=>e===void 0?"":`${encodeURIComponent(e)}#`,_=(e,s,h)=>`${P(e)}${s}#${String(h)}`,K=(e,s)=>{const h=P(s),b=h!==""&&e.startsWith(h)?e.slice(h.length):e,y=b.lastIndexOf("#"),f=y===-1?Number.NaN:Number(b.slice(y+1));return y===-1||!Number.isInteger(f)||f<0?{chunkIndex:0,sourceId:b}:{chunkIndex:f,sourceId:b.slice(0,y)}},me=async e=>{const s=await crypto.subtle.digest("SHA-256",new TextEncoder().encode(e));return[...new Uint8Array(s)].map(h=>h.toString(16).padStart(2,"0")).join("")},O=e=>{if(!e)return;const s=Object.entries(e).filter(([h])=>!ue.has(h));return s.length>0?Object.fromEntries(s):void 0},Q=new Set,he=e=>{Q.has(e)||(Q.add(e),console.warn(`[@lunora/ai/rag] index "${e}" is used without a namespace — in a multi-tenant/sharded
+app this shares one tenant's chunks (text included) with every other tenant, since
+Vectorize indexes are account-global. Pass \`namespace\` (the shard/tenant key) on both
+index() and retrieve(). Single-tenant apps suppress this via { allowSharedNamespace: true }.`))},pe=e=>e.map(s=>`[source:${s.sourceId}#${String(s.chunkIndex)}]
+${s.text}`).join(`
+
+`),ge=(e,s)=>{if(typeof e=="object")return e;if(s===void 0)throw new x("INTERNAL","@lunora/ai/rag: `embeddingModel` is a Workers AI model id (or omitted) but the bound context has no `ai` (env.AI). Pass an AI SDK EmbeddingModel object to embed without Workers AI, or bind a context whose `ctx.ai` is wired.");return s.embeddingModel(e)},fe=e=>{const s=e.modelId;return typeof s=="string"&&s.length>0?s:void 0},we=e=>{if(!(typeof e!="object"||e===null)){for(const s of Object.values(e))if(typeof s=="object"&&s!==null){const{cost:h}=s;if(typeof h=="number"&&Number.isFinite(h))return h}}},Ie=e=>{if(typeof e.index!="string"||e.index.length===0)throw new x("BAD_REQUEST","@lunora/ai/rag: `index` must be a non-empty Vectorize index name");const s=e.chunkSize??oe,h=e.chunkOverlap??ie;if(!Number.isInteger(s)||s<1)throw new x("BAD_REQUEST","@lunora/ai/rag: `chunkSize` must be a positive integer");if(!Number.isInteger(h)||h<0||h>=s)throw new x("BAD_REQUEST","@lunora/ai/rag: `chunkOverlap` must be a non-negative integer smaller than `chunkSize`");const b=e.topK??se;if(!Number.isInteger(b)||b<1)throw new x("BAD_REQUEST","@lunora/ai/rag: `topK` must be a positive integer");if(e.embeddingModelVersion!==void 0&&!le.test(e.embeddingModelVersion))throw new x("BAD_REQUEST",'@lunora/ai/rag: `embeddingModelVersion` must match /^[A-Za-z0-9._-]{1,40}$/ (a short, stable tag like "bge-v1.5")');const y=e.chunk??(m=>te(m,s,h)),{textStore:f}=e,k=f?de:ce,v=e.embeddingModelVersion,E=m=>v===void 0?m:m===void 0?v:`${v}::${m}`;return m=>{let I;const N=typeof m.trace=="function"?m.trace:void 0,B=async t=>{I??=ge(e.embeddingModel,m.ai);const n=I,o=async d=>{const{embedding:r,providerMetadata:u,usage:l}=await ee({model:n,value:t});if(d!==void 0){const c=l.tokens;typeof c=="number"&&Number.isFinite(c)&&d.setAttribute("gen_ai.usage.input_tokens",c);const p=we(u);p!==void 0&&d.setAttribute("gen_ai.usage.cost",p)}return r};if(N===void 0)return o();const i=fe(n),a=typeof m.conversationId=="string"&&m.conversationId.length>0?m.conversationId:void 0;return N("ai.embed",(d,r)=>o(r),{"gen_ai.operation.name":"embeddings",...i===void 0?{}:{"gen_ai.request.model":i},...a===void 0?{}:{"gen_ai.conversation.id":a}})},$=t=>{if(t===void 0){if(e.requireNamespace)throw new x("BAD_REQUEST",`@lunora/ai/rag: index "${e.index}" requires a namespace (requireNamespace is set) — pass the tenant/shard key on index()/retrieve()/remove()`);e.allowSharedNamespace||he(e.index)}},U=async(t,n)=>{const[o]=await m.vectors.getByIds(e.index,[_(n,t,0)],n),i=o?.metadata?.[R],a=o?.metadata?.[T];return{chunks:typeof a=="number"&&Number.isInteger(a)&&a>0?a:void 0,hash:typeof i=="string"?i:void 0}},j=async(t,n,o,i)=>{const a=Array.from({length:o-n},(d,r)=>_(i,t,n+r));a.length!==0&&(await m.vectors.deleteByIds(e.index,a,i),await f?.remove?.(a,{namespace:i}),await e.lexicalStore?.remove?.(a,{namespace:i}))},W=async t=>{if($(t.namespace),t.importance!==void 0&&(typeof t.importance!="number"||t.importance<0||t.importance>1))throw new x("BAD_REQUEST","@lunora/ai/rag: `importance` must be a number in [0, 1]");const n=E(t.namespace),o=await me(t.text),i=await U(t.id,n);if(i.hash===o&&i.chunks!==void 0)return{chunks:i.chunks,ids:Array.from({length:i.chunks},(r,u)=>_(n,t.id,u)),unchanged:!0};const a=y(t.text),d=a.map((r,u)=>_(n,t.id,u));if(a.length===0&&t.allowEmptySources===!1)throw new x("BAD_REQUEST",`@lunora/ai/rag: source "${t.id}" produced zero chunks — set allowEmptySources: true to allow this`);if(a.length>0){const r=a.map((u,l)=>({chunkIndex:l,id:d[l],sourceId:t.id,text:u}));f&&await f.put(r,{namespace:n}),e.lexicalStore&&await e.lexicalStore.index(r,{namespace:n})}return await re(a,ae,async(r,u)=>{const l=d[u],c={...t.metadata,[z]:u,[V]:t.id};f||(c[A]=r),t.importance!==void 0&&(c[M]=t.importance),u===0&&(c[R]=o,c[T]=a.length,v!==void 0&&(c[F]=v)),await m.vectors.upsert(e.index,{embed:B,id:l,input:r,metadata:c,namespace:n}),t.onChunk?.({chunkIndex:u,id:l,text:r,total:a.length})}),i.chunks!==void 0&&i.chunks>a.length&&await j(t.id,a.length,i.chunks,n),{chunks:a.length,ids:d,unchanged:!1}},H=async t=>{$(t.namespace);const n=E(t.namespace),o=(await U(t.id,n)).chunks??1;await j(t.id,0,o,n)},q=async(t,n)=>{const o=new Map;if(t.length===0)return o;if(f){const a=await f.getMany(t,{namespace:n});for(const[d,r]of t.entries()){const u=a[d];typeof u=="string"&&o.set(r,u)}return o}const i=await m.vectors.getByIds(e.index,t,n);for(const a of i){const d=a.metadata?.[A];typeof d=="string"&&o.set(a.id,d)}return o},L=async(t,n,o)=>{const i=n?.chunkContext?.before??0,a=n?.chunkContext?.after??0;if(i===0&&a===0)return t;if(!Number.isInteger(i)||i<0||!Number.isInteger(a)||a<0)throw new x("BAD_REQUEST","@lunora/ai/rag: `chunkContext.before`/`chunkContext.after` must be non-negative integers");const d=new Map(t.map(c=>[c.id,c.text])),r=new Set;for(const c of t)for(let p=-i;p<=a;p+=1){const w=c.chunkIndex+p,g=_(o,c.sourceId,w);p!==0&&w>=0&&!d.has(g)&&r.add(g)}const u=await q([...r],o),l=(c,p)=>{const w=_(o,c,p);return d.get(w)??u.get(w)};return t.map(c=>{const p=[];for(let w=-i;w<=a;w+=1){const g=w===0?c.text:l(c.sourceId,c.chunkIndex+w);g!==void 0&&p.push(g)}return{...c,text:p.join(`
+`)}})},X=t=>{if(typeof t=="string"){const n=e.filters?.[t];if(!n)throw new x("NOT_FOUND",`@lunora/ai/rag: unknown named filter "${t}" — must be one of the keys declared in RagConfig.filters`);return n.filter}return t},Y=(t,n)=>t.matches.map(o=>{const i=o.metadata??{},a=K(o.id,n),d=i[A],r=i[M],u=typeof r=="number"&&r>=0&&r<=1?r:1;return{chunkIndex:a.chunkIndex,id:o.id,importance:u,metadata:O(i),score:o.score*u,sourceId:a.sourceId,text:typeof d=="string"?d:""}}),Z=async(t,n)=>{if(!f)return t;const o=t.map(r=>r.id),[i,a]=await Promise.all([q(o,n),m.vectors.getByIds(e.index,o,n)]),d=new Map(a.map(r=>[r.id,r.metadata]));return t.flatMap(r=>{const u=i.get(r.id);if(u===void 0)return[];const l=d.get(r.id),c=l?.[M],p=typeof c=="number"&&c>=0&&c<=1?c:r.importance,w=r.score/r.importance*p;return[{...r,importance:p,metadata:O(l)??r.metadata,score:w,text:u}]})},C=async(t,n)=>{$(n?.namespace);const o=E(n?.namespace),i=X(n?.filter),a=e.rlsFilter?await e.rlsFilter(m.auth):void 0,d=a?{...i,...a}:i,r=Math.min(n?.topK??b,k),u=await m.vectors.query(e.index,{embed:B,filter:d,input:t,namespace:o,returnMetadata:f?"indexed":"all",topK:r});let l=await Z(Y(u,o),o);const c=n?.minScore;if(c!==void 0&&(l=l.filter(g=>g.score>=c)),e.lexicalStore){const g=(await e.lexicalStore.search(t,{filter:d,namespace:o,topK:e.lexicalTopK??r})).map(S=>{const D=K(S.id,o);return{chunkIndex:D.chunkIndex,id:S.id,importance:1,metadata:void 0,score:S.score,sourceId:D.sourceId,text:S.text}});l=[...ne(l,g)]}l.sort((g,S)=>S.score-g.score),l=[...await L(l,n,o)];const p=[],w=new Set;for(const g of l)w.has(g.sourceId)||(w.add(g.sourceId),p.push({id:g.sourceId,metadata:g.metadata,weight:g.importance}));return n?.onRetrieve?.({matches:l.length,query:t}),{chunks:l,context:pe(l),sources:p}};return{asTool:t=>G({description:t?.description??`Search the "${e.index}" knowledge base for passages relevant to a natural-language query.`,execute:async({query:n})=>C(n,{namespace:t?.namespace,topK:t?.topK}),inputSchema:J({properties:{query:{description:"The natural-language search query.",type:"string"}},required:["query"],type:"object"})}),index:W,remove:H,retrieve:C}}};export{Ie as default};

package/dist/packem_shared/fixedWindowChunks-XJRXHEoz.mjs

@@ -0,0 +1 @@
+const a=(s,e,i)=>{if(!Number.isInteger(e)||e<1)throw new RangeError("fixedWindowChunks: `size` must be a positive integer");if(!Number.isInteger(i)||i<0||i>=e)throw new RangeError("fixedWindowChunks: `overlap` must be a non-negative integer smaller than `size`");const t=s.trim();if(t.length===0)return[];if(t.length<=e)return[t];const o=Math.max(1,e-i),n=[];for(let r=0;r<t.length&&(n.push(t.slice(r,r+e)),!(r+e>=t.length));r+=o);return n};export{a as default};

package/dist/packem_shared/hybridRank-U6PmGuz1.mjs

@@ -0,0 +1 @@
+const a=(c,s,o=60)=>{const n=new Map;for(const[e,t]of c.entries())n.set(t.id,{chunk:t,score:1/(o+e),vectorRank:e});for(const[e,t]of s.entries()){const r=n.get(t.id);r?r.score+=1/(o+e):n.set(t.id,{chunk:t,score:1/(o+e),vectorRank:Number.POSITIVE_INFINITY})}return[...n.values()].toSorted((e,t)=>{const r=t.score-e.score;return r===0?e.vectorRank-t.vectorRank:r}).map(e=>e.chunk)};export{a as default};

package/dist/rag/index.mjs

@@ -1,5 +1 @@
-export { default as fixedWindowChunks } from '../packem_shared/fixedWindowChunks-J-WfQDw9.mjs';
-export { default as defineRag } from '../packem_shared/defineRag-DmczmIDj.mjs';
-export { contentHash, guessMimeTypeFromExtension } from '../packem_shared/contentHash-Cgz5KRGD.mjs';
-export { default as hybridRank } from '../packem_shared/hybridRank-DPC9c2ON.mjs';
-export { default as bm25LexicalStore } from '../packem_shared/bm25LexicalStore-BQzWLMqX.mjs';
+import{default as r}from"../packem_shared/fixedWindowChunks-XJRXHEoz.mjs";import{default as a}from"../packem_shared/defineRag-BF3RwHZj.mjs";import{contentHash as s,guessMimeTypeFromExtension as d}from"../packem_shared/contentHash-BIn6ECP8.mjs";import{default as n}from"../packem_shared/hybridRank-U6PmGuz1.mjs";import{default as i}from"../packem_shared/bm25LexicalStore-RA9sesFC.mjs";export{i as bm25LexicalStore,s as contentHash,a as defineRag,r as fixedWindowChunks,d as guessMimeTypeFromExtension,n as hybridRank};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/ai",
-  "version": "1.0.0-alpha.25",
+  "version": "1.0.0-alpha.26",
   "description": "Workers AI helper for Lunora: provider-agnostic AI SDK access from functions, Workers AI by default",
   "keywords": [
     "ai",
@@ -54,12 +54,12 @@
   },
   "dependencies": {
     "@lunora/errors": "1.0.0-alpha.8",
-    "ai": "7.0.31",
-    "workers-ai-provider": "3.3.1"
+    "ai": "7.0.37",
+    "workers-ai-provider": "4.0.0"
   },
   "peerDependencies": {
-    "@ai-sdk/anthropic": "4.0.16",
-    "@ai-sdk/openai": "4.0.16"
+    "@ai-sdk/anthropic": "4.0.20",
+    "@ai-sdk/openai": "4.0.20"
   },
   "peerDependenciesMeta": {
     "@ai-sdk/anthropic": {

package/dist/packem_shared/AI_GATEWAY_ACCOUNT_ID_ENV-CIAjehQF.mjs

@@ -1,48 +0,0 @@
-const readEnv = (env, key) => {
-  const value = env[key];
-  return typeof value === "string" && value.length > 0 ? value : void 0;
-};
-const buildAiGatewayMetadataFields = (metadata) => {
-  if (metadata === void 0) {
-    return void 0;
-  }
-  const fields = {};
-  if (typeof metadata.functionPath === "string" && metadata.functionPath.length > 0) {
-    fields["functionPath"] = metadata.functionPath;
-  }
-  if (typeof metadata.traceId === "string" && metadata.traceId.length > 0) {
-    fields["traceId"] = metadata.traceId;
-  }
-  return Object.keys(fields).length > 0 ? fields : void 0;
-};
-const encodeMetadata = (metadata) => {
-  const fields = buildAiGatewayMetadataFields(metadata);
-  return fields === void 0 ? void 0 : JSON.stringify(fields);
-};
-const AI_GATEWAY_ACCOUNT_ID_ENV = "LUNORA_AI_GATEWAY_ACCOUNT_ID";
-const AI_GATEWAY_ID_ENV = "LUNORA_AI_GATEWAY_ID";
-const AI_GATEWAY_TOKEN_ENV = "LUNORA_AI_GATEWAY_TOKEN";
-const resolveAiGateway = (env, metadata) => {
-  const accountId = readEnv(env, AI_GATEWAY_ACCOUNT_ID_ENV);
-  const gatewayId = readEnv(env, AI_GATEWAY_ID_ENV);
-  if (accountId === void 0 || gatewayId === void 0) {
-    return void 0;
-  }
-  const token = readEnv(env, AI_GATEWAY_TOKEN_ENV);
-  const headers = {};
-  if (token !== void 0) {
-    headers["cf-aig-authorization"] = `Bearer ${token}`;
-  }
-  const metadataHeader = encodeMetadata(metadata);
-  if (metadataHeader !== void 0) {
-    headers["cf-aig-metadata"] = metadataHeader;
-  }
-  return {
-    accountId,
-    baseURL: `https://gateway.ai.cloudflare.com/v1/${accountId}/${gatewayId}`,
-    gatewayId,
-    headers
-  };
-};
-
-export { AI_GATEWAY_ACCOUNT_ID_ENV, AI_GATEWAY_ID_ENV, AI_GATEWAY_TOKEN_ENV, buildAiGatewayMetadataFields, resolveAiGateway };

package/dist/packem_shared/bm25LexicalStore-BQzWLMqX.mjs

@@ -1,117 +0,0 @@
-const BM25_K1 = 1.5;
-const BM25_B = 0.75;
-const TOKEN_PATTERN = /[a-z0-9]+/g;
-const tokenize = (text) => text.toLowerCase().match(TOKEN_PATTERN) ?? [];
-const filterWarned = /* @__PURE__ */ new WeakSet();
-const bm25LexicalStore = () => {
-  const namespaces = /* @__PURE__ */ new Map();
-  const stateFor = (namespace = "") => {
-    let state = namespaces.get(namespace);
-    if (!state) {
-      state = { documents: /* @__PURE__ */ new Map(), postings: /* @__PURE__ */ new Map(), totalLength: 0 };
-      namespaces.set(namespace, state);
-    }
-    return state;
-  };
-  const removeDocument = (namespace, id) => {
-    const state = stateFor(namespace);
-    const existing = state.documents.get(id);
-    if (!existing) {
-      return;
-    }
-    for (const term of existing.termFrequency.keys()) {
-      const posting = state.postings.get(term);
-      if (posting) {
-        posting.delete(id);
-        if (posting.size === 0) {
-          state.postings.delete(term);
-        }
-      }
-    }
-    state.totalLength -= existing.length;
-    state.documents.delete(id);
-  };
-  const store = {
-    index: (chunks, options) => {
-      const state = stateFor(options.namespace);
-      for (const chunk of chunks) {
-        removeDocument(options.namespace, chunk.id);
-        const tokens = tokenize(chunk.text);
-        if (tokens.length === 0) {
-          continue;
-        }
-        const termFrequency = /* @__PURE__ */ new Map();
-        for (const token of tokens) {
-          termFrequency.set(token, (termFrequency.get(token) ?? 0) + 1);
-        }
-        for (const [term, frequency] of termFrequency) {
-          let posting = state.postings.get(term);
-          if (!posting) {
-            posting = /* @__PURE__ */ new Map();
-            state.postings.set(term, posting);
-          }
-          posting.set(chunk.id, frequency);
-        }
-        state.documents.set(chunk.id, { length: tokens.length, termFrequency, text: chunk.text });
-        state.totalLength += tokens.length;
-      }
-      return Promise.resolve();
-    },
-    remove: (ids, options) => {
-      for (const id of ids) {
-        removeDocument(options.namespace, id);
-      }
-      return Promise.resolve();
-    },
-    search: (query, options) => {
-      if (options.filter && Object.keys(options.filter).length > 0) {
-        if (!filterWarned.has(store)) {
-          filterWarned.add(store);
-          console.warn(
-            "[@lunora/ai/rag] bm25LexicalStore cannot evaluate a metadata filter (it stores no metadata);\nthe lexical leg is skipped for filtered queries. Fold the RLS dimension into `namespace`,\nor plug a filter-aware RagLexicalStore, to keep a lexical leg under metadata-based RLS."
-          );
-        }
-        return Promise.resolve([]);
-      }
-      const state = stateFor(options.namespace);
-      const documentCount = state.documents.size;
-      if (documentCount === 0) {
-        return Promise.resolve([]);
-      }
-      const queryTerms = [...new Set(tokenize(query))];
-      if (queryTerms.length === 0) {
-        return Promise.resolve([]);
-      }
-      const averageLength = state.totalLength / documentCount;
-      const scores = /* @__PURE__ */ new Map();
-      for (const term of queryTerms) {
-        const posting = state.postings.get(term);
-        if (!posting) {
-          continue;
-        }
-        const documentFrequency = posting.size;
-        const idf = Math.log(1 + (documentCount - documentFrequency + 0.5) / (documentFrequency + 0.5));
-        for (const [id, frequency] of posting) {
-          const document = state.documents.get(id);
-          if (!document) {
-            continue;
-          }
-          const denominator = frequency + BM25_K1 * (1 - BM25_B + BM25_B * document.length / averageLength);
-          const contribution = idf * (frequency * (BM25_K1 + 1) / denominator);
-          scores.set(id, (scores.get(id) ?? 0) + contribution);
-        }
-      }
-      const matches = [...scores.entries()].map(([id, score]) => {
-        return {
-          id,
-          score,
-          text: state.documents.get(id)?.text ?? ""
-        };
-      });
-      return Promise.resolve(matches.toSorted((a, b) => b.score - a.score).slice(0, options.topK));
-    }
-  };
-  return store;
-};
-
-export { bm25LexicalStore as default };

package/dist/packem_shared/contentHash-Cgz5KRGD.mjs

@@ -1,92 +0,0 @@
-const DOT_PREFIX_RE = /^\.+/u;
-const EXTENSION_MIME_MAP = {
-  // Images
-  avif: "image/avif",
-  bmp: "image/bmp",
-  gif: "image/gif",
-  ico: "image/x-icon",
-  jpeg: "image/jpeg",
-  jpg: "image/jpeg",
-  png: "image/png",
-  svg: "image/svg+xml",
-  tiff: "image/tiff",
-  tif: "image/tiff",
-  webp: "image/webp",
-  // Video
-  avi: "video/x-msvideo",
-  mkv: "video/x-matroska",
-  mov: "video/quicktime",
-  mp4: "video/mp4",
-  mpeg: "video/mpeg",
-  mpg: "video/mpeg",
-  webm: "video/webm",
-  wmv: "video/x-ms-wmv",
-  // Audio
-  aac: "audio/aac",
-  flac: "audio/flac",
-  m4a: "audio/mp4",
-  mp3: "audio/mpeg",
-  ogg: "audio/ogg",
-  opus: "audio/opus",
-  wav: "audio/wav",
-  wma: "audio/x-ms-wma",
-  // Documents (office / PDF)
-  csv: "text/csv",
-  doc: "application/msword",
-  docx: "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
-  odp: "application/vnd.oasis.opendocument.presentation",
-  ods: "application/vnd.oasis.opendocument.spreadsheet",
-  odt: "application/vnd.oasis.opendocument.text",
-  pdf: "application/pdf",
-  ppt: "application/vnd.ms-powerpoint",
-  pptx: "application/vnd.openxmlformats-officedocument.presentationml.presentation",
-  rtf: "application/rtf",
-  xls: "application/vnd.ms-excel",
-  xlsx: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
-  // Text / markup
-  css: "text/css",
-  html: "text/html",
-  htm: "text/html",
-  ini: "text/plain",
-  json: "application/json",
-  js: "text/javascript",
-  mjs: "text/javascript",
-  md: "text/markdown",
-  jsx: "text/javascript",
-  ts: "text/typescript",
-  tsx: "text/typescript",
-  txt: "text/plain",
-  xml: "application/xml",
-  yaml: "application/x-yaml",
-  yml: "application/x-yaml",
-  // Archives / binaries
-  "7z": "application/x-7z-compressed",
-  bz2: "application/x-bzip2",
-  gz: "application/gzip",
-  jar: "application/java-archive",
-  rar: "application/vnd.rar",
-  tar: "application/x-tar",
-  zip: "application/zip",
-  // Fonts
-  otf: "font/otf",
-  ttf: "font/ttf",
-  woff: "font/woff",
-  woff2: "font/woff2",
-  // Other common
-  bin: "application/octet-stream",
-  epub: "application/epub+zip",
-  exe: "application/vnd.microsoft.portable-executable",
-  iso: "application/x-iso9660-image",
-  sql: "application/sql",
-  toml: "application/toml"
-};
-const guessMimeTypeFromExtension = (extension) => {
-  const normalizedExtension = extension.replace(DOT_PREFIX_RE, "").toLowerCase();
-  return EXTENSION_MIME_MAP[normalizedExtension] ?? "application/octet-stream";
-};
-const contentHash = async (data) => {
-  const digest = await crypto.subtle.digest("SHA-256", data);
-  return [...new Uint8Array(digest)].map((byte) => byte.toString(16).padStart(2, "0")).join("");
-};
-
-export { contentHash, guessMimeTypeFromExtension };

package/dist/packem_shared/createAi-Cep3l8Rk.mjs

@@ -1,72 +0,0 @@
-import { LunoraError } from '@lunora/errors';
-import { createWorkersAI } from 'workers-ai-provider';
-import { buildAiGatewayMetadataFields, resolveAiGateway } from './AI_GATEWAY_ACCOUNT_ID_ENV-CIAjehQF.mjs';
-
-const resolveGatewayOption = (gateway, env, metadata) => {
-  const metadataFields = buildAiGatewayMetadataFields(metadata);
-  if (gateway !== void 0) {
-    return metadataFields !== void 0 && gateway.metadata === void 0 ? { ...gateway, metadata: metadataFields } : gateway;
-  }
-  if (env === void 0) {
-    return void 0;
-  }
-  const resolved = resolveAiGateway(env, metadata);
-  if (resolved === void 0) {
-    return void 0;
-  }
-  return metadataFields === void 0 ? { id: resolved.gatewayId } : { id: resolved.gatewayId, metadata: metadataFields };
-};
-const buildProvider = (binding, gateway) => createWorkersAI({ binding, gateway });
-const createAi = (options) => {
-  const { binding, defaultEmbeddingModel, defaultModel, env, gateway, metadata, provider } = options;
-  if (!provider && !binding) {
-    throw new LunoraError("INTERNAL", "@lunora/ai: createAi requires a `binding` (env.AI) or a pre-built `provider`");
-  }
-  const resolvedGateway = resolveGatewayOption(gateway, env, metadata);
-  const workersai = provider ?? buildProvider(binding, resolvedGateway);
-  const model = (input) => {
-    if (input === void 0) {
-      if (!defaultModel) {
-        throw new LunoraError("INTERNAL", "@lunora/ai: no model supplied and no `defaultModel` configured — pass a model id or an AI SDK model");
-      }
-      return workersai(defaultModel);
-    }
-    return typeof input === "string" ? workersai(input) : input;
-  };
-  const resolveEmbeddingModel = (modelId) => {
-    const factory = workersai.textEmbeddingModel;
-    if (typeof factory !== "function") {
-      throw new LunoraError(
-        "INTERNAL",
-        "@lunora/ai: the Workers AI provider does not expose `textEmbeddingModel`; pass an AI SDK EmbeddingModel (e.g. from @ai-sdk/openai) to embed()"
-      );
-    }
-    return factory.call(workersai, modelId);
-  };
-  const embeddingModel = (input) => {
-    if (typeof input === "object") {
-      return input;
-    }
-    const modelId = input ?? defaultEmbeddingModel;
-    if (!modelId) {
-      throw new LunoraError(
-        "INTERNAL",
-        "@lunora/ai: no embedding model supplied and no `defaultEmbeddingModel` configured — pass an embedding model id or an AI SDK EmbeddingModel"
-      );
-    }
-    return resolveEmbeddingModel(modelId);
-  };
-  const run = async (modelId, inputs, runOptions) => {
-    if (!binding) {
-      throw new LunoraError(
-        "INTERNAL",
-        "@lunora/ai: ai.run requires the `binding` (env.AI) — it is unavailable when only a custom `provider` was supplied"
-      );
-    }
-    const mergedOptions = resolvedGateway !== void 0 && runOptions?.gateway === void 0 ? { ...runOptions, gateway: resolvedGateway } : runOptions;
-    return binding.run(modelId, inputs, mergedOptions);
-  };
-  return { embeddingModel, model, run, workersai };
-};
-
-export { createAi as default };

package/dist/packem_shared/defineRag-DmczmIDj.mjs

@@ -1,474 +0,0 @@
-import { LunoraError } from '@lunora/errors';
-import { tool, jsonSchema, embed } from 'ai';
-import fixedWindowChunks from './fixedWindowChunks-J-WfQDw9.mjs';
-import hybridRank from './hybridRank-DPC9c2ON.mjs';
-
-const INDEX_CONCURRENCY = 8;
-const concurrentMap = async (items, limit, function_) => {
-  if (!Number.isInteger(limit) || limit < 1) {
-    throw new RangeError("concurrentMap: `limit` must be a positive integer");
-  }
-  if (items.length === 0) {
-    return [];
-  }
-  const effectiveLimit = Math.max(1, Math.min(limit, items.length));
-  const results = Array.from({ length: items.length });
-  let cursor = 0;
-  let failed = false;
-  let firstError;
-  const worker = async () => {
-    for (; ; ) {
-      if (failed) {
-        return;
-      }
-      const index = cursor;
-      cursor += 1;
-      if (index >= items.length) {
-        return;
-      }
-      try {
-        results[index] = await function_(items[index], index);
-      } catch (error) {
-        if (!failed) {
-          failed = true;
-          firstError = error;
-        }
-        return;
-      }
-    }
-  };
-  const workers = Array.from({ length: effectiveLimit }, () => worker());
-  await Promise.all(workers);
-  if (failed) {
-    throw firstError;
-  }
-  return results;
-};
-
-const DEFAULT_CHUNK_SIZE = 1e3;
-const DEFAULT_CHUNK_OVERLAP = 200;
-const DEFAULT_TOP_K = 5;
-const MAX_TOP_K_FULL_METADATA = 20;
-const MAX_TOP_K = 100;
-const CHUNK_INDEX_KEY = "__ragChunk";
-const SOURCE_KEY = "__ragSource";
-const TEXT_KEY = "__ragText";
-const HASH_KEY = "__ragHash";
-const COUNT_KEY = "__ragChunks";
-const IMPORTANCE_KEY = "__ragImportance";
-const MODEL_KEY = "__ragModel";
-const INTERNAL_KEYS = /* @__PURE__ */ new Set([CHUNK_INDEX_KEY, COUNT_KEY, HASH_KEY, IMPORTANCE_KEY, MODEL_KEY, SOURCE_KEY, TEXT_KEY]);
-const MODEL_VERSION_PATTERN = /^[\w.-]{1,40}$/;
-const namespacePrefix = (namespace) => namespace === void 0 ? "" : `${encodeURIComponent(namespace)}#`;
-const chunkVectorId = (namespace, sourceId, chunkIndex) => `${namespacePrefix(namespace)}${sourceId}#${String(chunkIndex)}`;
-const parseChunkVectorId = (id, namespace) => {
-  const prefix = namespacePrefix(namespace);
-  const body = prefix !== "" && id.startsWith(prefix) ? id.slice(prefix.length) : id;
-  const separator = body.lastIndexOf("#");
-  const chunkIndex = separator === -1 ? Number.NaN : Number(body.slice(separator + 1));
-  if (separator === -1 || !Number.isInteger(chunkIndex) || chunkIndex < 0) {
-    return { chunkIndex: 0, sourceId: body };
-  }
-  return { chunkIndex, sourceId: body.slice(0, separator) };
-};
-const sha256Hex = async (text) => {
-  const digest = await crypto.subtle.digest("SHA-256", new TextEncoder().encode(text));
-  return [...new Uint8Array(digest)].map((byte) => byte.toString(16).padStart(2, "0")).join("");
-};
-const userMetadataOf = (metadata) => {
-  if (!metadata) {
-    return void 0;
-  }
-  const entries = Object.entries(metadata).filter(([key]) => !INTERNAL_KEYS.has(key));
-  return entries.length > 0 ? Object.fromEntries(entries) : void 0;
-};
-const sharedNamespaceWarned = /* @__PURE__ */ new Set();
-const warnSharedNamespace = (indexName) => {
-  if (sharedNamespaceWarned.has(indexName)) {
-    return;
-  }
-  sharedNamespaceWarned.add(indexName);
-  console.warn(
-    `[@lunora/ai/rag] index "${indexName}" is used without a namespace — in a multi-tenant/sharded
-app this shares one tenant's chunks (text included) with every other tenant, since
-Vectorize indexes are account-global. Pass \`namespace\` (the shard/tenant key) on both
-index() and retrieve(). Single-tenant apps suppress this via { allowSharedNamespace: true }.`
-  );
-};
-const assembleContext = (chunks) => chunks.map((chunk) => `[source:${chunk.sourceId}#${String(chunk.chunkIndex)}]
-${chunk.text}`).join("\n\n");
-const resolveEmbeddingModel = (input, ai) => {
-  if (typeof input === "object") {
-    return input;
-  }
-  if (ai === void 0) {
-    throw new LunoraError(
-      "INTERNAL",
-      "@lunora/ai/rag: `embeddingModel` is a Workers AI model id (or omitted) but the bound context has no `ai` (env.AI). Pass an AI SDK EmbeddingModel object to embed without Workers AI, or bind a context whose `ctx.ai` is wired."
-    );
-  }
-  return ai.embeddingModel(input);
-};
-const modelIdOf = (model) => {
-  const id = model.modelId;
-  return typeof id === "string" && id.length > 0 ? id : void 0;
-};
-const embedCostOf = (providerMetadata) => {
-  if (typeof providerMetadata !== "object" || providerMetadata === null) {
-    return void 0;
-  }
-  for (const bag of Object.values(providerMetadata)) {
-    if (typeof bag === "object" && bag !== null) {
-      const { cost } = bag;
-      if (typeof cost === "number" && Number.isFinite(cost)) {
-        return cost;
-      }
-    }
-  }
-  return void 0;
-};
-const defineRag = (config) => {
-  if (typeof config.index !== "string" || config.index.length === 0) {
-    throw new LunoraError("BAD_REQUEST", "@lunora/ai/rag: `index` must be a non-empty Vectorize index name");
-  }
-  const chunkSize = config.chunkSize ?? DEFAULT_CHUNK_SIZE;
-  const chunkOverlap = config.chunkOverlap ?? DEFAULT_CHUNK_OVERLAP;
-  if (!Number.isInteger(chunkSize) || chunkSize < 1) {
-    throw new LunoraError("BAD_REQUEST", "@lunora/ai/rag: `chunkSize` must be a positive integer");
-  }
-  if (!Number.isInteger(chunkOverlap) || chunkOverlap < 0 || chunkOverlap >= chunkSize) {
-    throw new LunoraError("BAD_REQUEST", "@lunora/ai/rag: `chunkOverlap` must be a non-negative integer smaller than `chunkSize`");
-  }
-  const defaultTopK = config.topK ?? DEFAULT_TOP_K;
-  if (!Number.isInteger(defaultTopK) || defaultTopK < 1) {
-    throw new LunoraError("BAD_REQUEST", "@lunora/ai/rag: `topK` must be a positive integer");
-  }
-  if (config.embeddingModelVersion !== void 0 && !MODEL_VERSION_PATTERN.test(config.embeddingModelVersion)) {
-    throw new LunoraError(
-      "BAD_REQUEST",
-      '@lunora/ai/rag: `embeddingModelVersion` must match /^[A-Za-z0-9._-]{1,40}$/ (a short, stable tag like "bge-v1.5")'
-    );
-  }
-  const splitter = config.chunk ?? ((text) => fixedWindowChunks(text, chunkSize, chunkOverlap));
-  const { textStore } = config;
-  const topKCeiling = textStore ? MAX_TOP_K : MAX_TOP_K_FULL_METADATA;
-  const modelTag = config.embeddingModelVersion;
-  const withModelTag = (namespace) => {
-    if (modelTag === void 0) {
-      return namespace;
-    }
-    return namespace === void 0 ? modelTag : `${modelTag}::${namespace}`;
-  };
-  return (context) => {
-    let model;
-    const tracer = typeof context.trace === "function" ? context.trace : void 0;
-    const embedText = async (text) => {
-      model ??= resolveEmbeddingModel(config.embeddingModel, context.ai);
-      const resolvedModel = model;
-      const run = async (span) => {
-        const { embedding, providerMetadata, usage } = await embed({ model: resolvedModel, value: text });
-        if (span !== void 0) {
-          const inputTokens = usage.tokens;
-          if (typeof inputTokens === "number" && Number.isFinite(inputTokens)) {
-            span.setAttribute("gen_ai.usage.input_tokens", inputTokens);
-          }
-          const cost = embedCostOf(providerMetadata);
-          if (cost !== void 0) {
-            span.setAttribute("gen_ai.usage.cost", cost);
-          }
-        }
-        return embedding;
-      };
-      if (tracer === void 0) {
-        return run();
-      }
-      const modelId = modelIdOf(resolvedModel);
-      const conversationId = typeof context.conversationId === "string" && context.conversationId.length > 0 ? context.conversationId : void 0;
-      return tracer("ai.embed", (_trace, span) => run(span), {
-        "gen_ai.operation.name": "embeddings",
-        ...modelId === void 0 ? {} : { "gen_ai.request.model": modelId },
-        // Session/thread grouping — absent unless a conversation id was set.
-        ...conversationId === void 0 ? {} : { "gen_ai.conversation.id": conversationId }
-      });
-    };
-    const checkNamespace = (namespace) => {
-      if (namespace !== void 0) {
-        return;
-      }
-      if (config.requireNamespace) {
-        throw new LunoraError(
-          "BAD_REQUEST",
-          `@lunora/ai/rag: index "${config.index}" requires a namespace (requireNamespace is set) — pass the tenant/shard key on index()/retrieve()/remove()`
-        );
-      }
-      if (!config.allowSharedNamespace) {
-        warnSharedNamespace(config.index);
-      }
-    };
-    const readHead = async (sourceId, namespace) => {
-      const [head] = await context.vectors.getByIds(config.index, [chunkVectorId(namespace, sourceId, 0)], namespace);
-      const hash = head?.metadata?.[HASH_KEY];
-      const chunks = head?.metadata?.[COUNT_KEY];
-      return {
-        chunks: typeof chunks === "number" && Number.isInteger(chunks) && chunks > 0 ? chunks : void 0,
-        hash: typeof hash === "string" ? hash : void 0
-      };
-    };
-    const deleteChunkRange = async (sourceId, from, to, namespace) => {
-      const ids = Array.from({ length: to - from }, (_, offset) => chunkVectorId(namespace, sourceId, from + offset));
-      if (ids.length === 0) {
-        return;
-      }
-      await context.vectors.deleteByIds(config.index, ids, namespace);
-      await textStore?.remove?.(ids, { namespace });
-      await config.lexicalStore?.remove?.(ids, { namespace });
-    };
-    const index = async (input) => {
-      checkNamespace(input.namespace);
-      if (input.importance !== void 0 && (typeof input.importance !== "number" || input.importance < 0 || input.importance > 1)) {
-        throw new LunoraError("BAD_REQUEST", "@lunora/ai/rag: `importance` must be a number in [0, 1]");
-      }
-      const effectiveNamespace = withModelTag(input.namespace);
-      const hash = await sha256Hex(input.text);
-      const previous = await readHead(input.id, effectiveNamespace);
-      if (previous.hash === hash && previous.chunks !== void 0) {
-        return {
-          chunks: previous.chunks,
-          ids: Array.from({ length: previous.chunks }, (_, chunkIndex) => chunkVectorId(effectiveNamespace, input.id, chunkIndex)),
-          unchanged: true
-        };
-      }
-      const pieces = splitter(input.text);
-      const ids = pieces.map((_, chunkIndex) => chunkVectorId(effectiveNamespace, input.id, chunkIndex));
-      if (pieces.length === 0 && input.allowEmptySources === false) {
-        throw new LunoraError("BAD_REQUEST", `@lunora/ai/rag: source "${input.id}" produced zero chunks — set allowEmptySources: true to allow this`);
-      }
-      if (pieces.length > 0) {
-        const storedChunks = pieces.map((text, chunkIndex) => {
-          return { chunkIndex, id: ids[chunkIndex], sourceId: input.id, text };
-        });
-        if (textStore) {
-          await textStore.put(storedChunks, { namespace: effectiveNamespace });
-        }
-        if (config.lexicalStore) {
-          await config.lexicalStore.index(storedChunks, { namespace: effectiveNamespace });
-        }
-      }
-      await concurrentMap(pieces, INDEX_CONCURRENCY, async (piece, chunkIndex) => {
-        const id = ids[chunkIndex];
-        const metadata = {
-          ...input.metadata,
-          [CHUNK_INDEX_KEY]: chunkIndex,
-          [SOURCE_KEY]: input.id
-        };
-        if (!textStore) {
-          metadata[TEXT_KEY] = piece;
-        }
-        if (input.importance !== void 0) {
-          metadata[IMPORTANCE_KEY] = input.importance;
-        }
-        if (chunkIndex === 0) {
-          metadata[HASH_KEY] = hash;
-          metadata[COUNT_KEY] = pieces.length;
-          if (modelTag !== void 0) {
-            metadata[MODEL_KEY] = modelTag;
-          }
-        }
-        await context.vectors.upsert(config.index, {
-          embed: embedText,
-          id,
-          input: piece,
-          metadata,
-          namespace: effectiveNamespace
-        });
-        input.onChunk?.({ chunkIndex, id, text: piece, total: pieces.length });
-      });
-      if (previous.chunks !== void 0 && previous.chunks > pieces.length) {
-        await deleteChunkRange(input.id, pieces.length, previous.chunks, effectiveNamespace);
-      }
-      return { chunks: pieces.length, ids, unchanged: false };
-    };
-    const remove = async (input) => {
-      checkNamespace(input.namespace);
-      const effectiveNamespace = withModelTag(input.namespace);
-      const previous = await readHead(input.id, effectiveNamespace);
-      const totalChunks = previous.chunks ?? 1;
-      await deleteChunkRange(input.id, 0, totalChunks, effectiveNamespace);
-    };
-    const textsByIds = async (ids, namespace) => {
-      const texts = /* @__PURE__ */ new Map();
-      if (ids.length === 0) {
-        return texts;
-      }
-      if (textStore) {
-        const stored = await textStore.getMany(ids, { namespace });
-        for (const [position, id] of ids.entries()) {
-          const text = stored[position];
-          if (typeof text === "string") {
-            texts.set(id, text);
-          }
-        }
-        return texts;
-      }
-      const records = await context.vectors.getByIds(config.index, ids, namespace);
-      for (const record of records) {
-        const text = record.metadata?.[TEXT_KEY];
-        if (typeof text === "string") {
-          texts.set(record.id, text);
-        }
-      }
-      return texts;
-    };
-    const expandChunks = async (chunks, options, effectiveNamespace) => {
-      const before = options?.chunkContext?.before ?? 0;
-      const after = options?.chunkContext?.after ?? 0;
-      if (before === 0 && after === 0) {
-        return chunks;
-      }
-      if (!Number.isInteger(before) || before < 0 || !Number.isInteger(after) || after < 0) {
-        throw new LunoraError("BAD_REQUEST", "@lunora/ai/rag: `chunkContext.before`/`chunkContext.after` must be non-negative integers");
-      }
-      const known = new Map(chunks.map((chunk) => [chunk.id, chunk.text]));
-      const neighbourIds = /* @__PURE__ */ new Set();
-      for (const chunk of chunks) {
-        for (let offset = -before; offset <= after; offset += 1) {
-          const neighbourIndex = chunk.chunkIndex + offset;
-          const id = chunkVectorId(effectiveNamespace, chunk.sourceId, neighbourIndex);
-          if (offset !== 0 && neighbourIndex >= 0 && !known.has(id)) {
-            neighbourIds.add(id);
-          }
-        }
-      }
-      const neighbourTexts = await textsByIds([...neighbourIds], effectiveNamespace);
-      const textOf = (sourceId, chunkIndex) => {
-        const id = chunkVectorId(effectiveNamespace, sourceId, chunkIndex);
-        return known.get(id) ?? neighbourTexts.get(id);
-      };
-      return chunks.map((chunk) => {
-        const parts = [];
-        for (let offset = -before; offset <= after; offset += 1) {
-          const text = offset === 0 ? chunk.text : textOf(chunk.sourceId, chunk.chunkIndex + offset);
-          if (text !== void 0) {
-            parts.push(text);
-          }
-        }
-        return { ...chunk, text: parts.join("\n") };
-      });
-    };
-    const resolveFilter = (filter) => {
-      if (typeof filter === "string") {
-        const resolved = config.filters?.[filter];
-        if (!resolved) {
-          throw new LunoraError(
-            "NOT_FOUND",
-            `@lunora/ai/rag: unknown named filter "${filter}" — must be one of the keys declared in RagConfig.filters`
-          );
-        }
-        return resolved.filter;
-      }
-      return filter;
-    };
-    const parseMatches = (result, namespace) => result.matches.map((match) => {
-      const metadata = match.metadata ?? {};
-      const parsed = parseChunkVectorId(match.id, namespace);
-      const rawText = metadata[TEXT_KEY];
-      const rawImportance = metadata[IMPORTANCE_KEY];
-      const importance = typeof rawImportance === "number" && rawImportance >= 0 && rawImportance <= 1 ? rawImportance : 1;
-      return {
-        chunkIndex: parsed.chunkIndex,
-        id: match.id,
-        importance,
-        metadata: userMetadataOf(metadata),
-        score: match.score * importance,
-        sourceId: parsed.sourceId,
-        text: typeof rawText === "string" ? rawText : ""
-      };
-    });
-    const hydrateFromStore = async (chunks, namespace) => {
-      if (!textStore) {
-        return chunks;
-      }
-      const ids = chunks.map((chunk) => chunk.id);
-      const [texts, records] = await Promise.all([textsByIds(ids, namespace), context.vectors.getByIds(config.index, ids, namespace)]);
-      const fullMetadataById = new Map(records.map((record) => [record.id, record.metadata]));
-      return chunks.flatMap((chunk) => {
-        const text = texts.get(chunk.id);
-        if (text === void 0) {
-          return [];
-        }
-        const fullMetadata = fullMetadataById.get(chunk.id);
-        const rawImportance = fullMetadata?.[IMPORTANCE_KEY];
-        const importance = typeof rawImportance === "number" && rawImportance >= 0 && rawImportance <= 1 ? rawImportance : chunk.importance;
-        const score = chunk.score / chunk.importance * importance;
-        return [{ ...chunk, importance, metadata: userMetadataOf(fullMetadata) ?? chunk.metadata, score, text }];
-      });
-    };
-    const retrieve = async (query, options) => {
-      checkNamespace(options?.namespace);
-      const effectiveNamespace = withModelTag(options?.namespace);
-      const resolvedFilter = resolveFilter(options?.filter);
-      const rlsFilter = config.rlsFilter ? await config.rlsFilter(context.auth) : void 0;
-      const effectiveFilter = rlsFilter ? { ...resolvedFilter, ...rlsFilter } : resolvedFilter;
-      const topK = Math.min(options?.topK ?? defaultTopK, topKCeiling);
-      const vectorResult = await context.vectors.query(config.index, {
-        embed: embedText,
-        filter: effectiveFilter,
-        input: query,
-        namespace: effectiveNamespace,
-        returnMetadata: textStore ? "indexed" : "all",
-        topK
-      });
-      let chunks = await hydrateFromStore(parseMatches(vectorResult, effectiveNamespace), effectiveNamespace);
-      const minScore = options?.minScore;
-      if (minScore !== void 0) {
-        chunks = chunks.filter((chunk) => chunk.score >= minScore);
-      }
-      if (config.lexicalStore) {
-        const lexicalMatches = await config.lexicalStore.search(query, {
-          filter: effectiveFilter,
-          namespace: effectiveNamespace,
-          topK: config.lexicalTopK ?? topK
-        });
-        const lexicalChunks = lexicalMatches.map((match) => {
-          const parsed = parseChunkVectorId(match.id, effectiveNamespace);
-          return {
-            chunkIndex: parsed.chunkIndex,
-            id: match.id,
-            importance: 1,
-            metadata: void 0,
-            score: match.score,
-            sourceId: parsed.sourceId,
-            text: match.text
-          };
-        });
-        chunks = [...hybridRank(chunks, lexicalChunks)];
-      }
-      chunks.sort((a, b) => b.score - a.score);
-      chunks = [...await expandChunks(chunks, options, effectiveNamespace)];
-      const sources = [];
-      const seen = /* @__PURE__ */ new Set();
-      for (const chunk of chunks) {
-        if (!seen.has(chunk.sourceId)) {
-          seen.add(chunk.sourceId);
-          sources.push({ id: chunk.sourceId, metadata: chunk.metadata, weight: chunk.importance });
-        }
-      }
-      options?.onRetrieve?.({ matches: chunks.length, query });
-      return { chunks, context: assembleContext(chunks), sources };
-    };
-    const asTool = (options) => tool({
-      description: options?.description ?? `Search the "${config.index}" knowledge base for passages relevant to a natural-language query.`,
-      execute: async ({ query }) => retrieve(query, { namespace: options?.namespace, topK: options?.topK }),
-      inputSchema: jsonSchema({
-        properties: {
-          query: { description: "The natural-language search query.", type: "string" }
-        },
-        required: ["query"],
-        type: "object"
-      })
-    });
-    return { asTool, index, remove, retrieve };
-  };
-};
-
-export { defineRag as default };

package/dist/packem_shared/fixedWindowChunks-J-WfQDw9.mjs

@@ -1,26 +0,0 @@
-const fixedWindowChunks = (text, size, overlap) => {
-  if (!Number.isInteger(size) || size < 1) {
-    throw new RangeError("fixedWindowChunks: `size` must be a positive integer");
-  }
-  if (!Number.isInteger(overlap) || overlap < 0 || overlap >= size) {
-    throw new RangeError("fixedWindowChunks: `overlap` must be a non-negative integer smaller than `size`");
-  }
-  const trimmed = text.trim();
-  if (trimmed.length === 0) {
-    return [];
-  }
-  if (trimmed.length <= size) {
-    return [trimmed];
-  }
-  const step = Math.max(1, size - overlap);
-  const chunks = [];
-  for (let start = 0; start < trimmed.length; start += step) {
-    chunks.push(trimmed.slice(start, start + size));
-    if (start + size >= trimmed.length) {
-      break;
-    }
-  }
-  return chunks;
-};
-
-export { fixedWindowChunks as default };

package/dist/packem_shared/hybridRank-DPC9c2ON.mjs

@@ -1,20 +0,0 @@
-const hybridRank = (vectorResults, textResults, k = 60) => {
-  const fused = /* @__PURE__ */ new Map();
-  for (const [rank, chunk] of vectorResults.entries()) {
-    fused.set(chunk.id, { chunk, score: 1 / (k + rank), vectorRank: rank });
-  }
-  for (const [rank, chunk] of textResults.entries()) {
-    const existing = fused.get(chunk.id);
-    if (existing) {
-      existing.score += 1 / (k + rank);
-    } else {
-      fused.set(chunk.id, { chunk, score: 1 / (k + rank), vectorRank: Number.POSITIVE_INFINITY });
-    }
-  }
-  return [...fused.values()].toSorted((a, b) => {
-    const delta = b.score - a.score;
-    return delta === 0 ? a.vectorRank - b.vectorRank : delta;
-  }).map((entry) => entry.chunk);
-};
-
-export { hybridRank as default };