@cachly-dev/mcp-server 0.10.227 → 0.10.229

package/dist/src/handlers/cache.js

@@ -1,54 +1,55 @@
-import{randomUUID as j}from"node:crypto";import{McpError as V,ErrorCode as Y}from"@modelcontextprotocol/sdk/types.js";import{readdir as F,stat as z,readFile as G}from"node:fs/promises";import{join as Q,relative as Z,extname as ee}from"node:path";import{computeEmbedding as R,hasEmbedProvider as K,embedProviderHint as J}from"../embeddings.js";import{einbettTakt as te}from"../einbett-takt.js";import{detectNamespace as P}from"../namespace.js";import{simpleHash as se}from"../confidence.js";import{scanKeys as ae}from"../utils.js";import{cachlyUrl as X}from"../cachly-url.js";const _e=new Set(["cache_get","cache_set","cache_delete","cache_exists","cache_ttl","cache_keys","cache_stats","semantic_search","detect_namespace","cache_warmup","index_project","cache_mset","cache_mget","cache_lock_acquire","cache_lock_release","cache_stream_set","cache_stream_get","cache_org_stats","set_cost_per_call"]);async function $e(W,p,$,b){switch(W){case"cache_get":{const{instance_id:n,key:e,org_id:a}=p,t=await $(n);let s=await t.get(e),i="direct";if(s===null&&a){const r=`org:${a}:sem:${e}`;s=await t.get(r),s!==null&&(i=`org:${a}:sem`)}if(s===null)return`Key \`${e}\` \u2192 **not found** (null)`;let o=s;try{o=JSON.stringify(JSON.parse(s),null,2)}catch{}const c=i!=="direct"?` _(from shared org namespace \`${i}\`)_`:"";return`Key \`${e}\`:${c}
+import{randomUUID as M}from"node:crypto";import{McpError as F,ErrorCode as W}from"@modelcontextprotocol/sdk/types.js";import{readdir as Z,stat as ee,readFile as te}from"node:fs/promises";import{join as se,relative as ae,extname as ne}from"node:path";import{computeEmbedding as I,hasEmbedProvider as D,embedProviderHint as B}from"../embeddings.js";import{einbettTakt as ie}from"../einbett-takt.js";import{detectNamespace as q}from"../namespace.js";import{simpleHash as ce}from"../confidence.js";import{scanKeys as re}from"../utils.js";import{cachlyUrl as z}from"../cachly-url.js";const we=new Set(["cache_get","cache_set","cache_delete","cache_exists","cache_ttl","cache_keys","cache_stats","semantic_search","detect_namespace","cache_warmup","index_project","cache_mset","cache_mget","cache_lock_acquire","cache_lock_release","cache_stream_set","cache_stream_get","cache_org_stats","set_cost_per_call"]);async function ge(G,h,_,O){switch(G){case"cache_get":{const{instance_id:n,key:e,org_id:a}=h,t=await _(n);let s=await t.get(e),i="direct";if(s===null&&a){const o=`org:${a}:sem:${e}`;s=await t.get(o),s!==null&&(i=`org:${a}:sem`)}if(s===null)return`Key \`${e}\` \u2192 **not found** (null)`;let r=s;try{r=JSON.stringify(JSON.parse(s),null,2)}catch{}const c=i!=="direct"?` _(from shared org namespace \`${i}\`)_`:"";return`Key \`${e}\`:${c}
 \`\`\`
-${o}
-\`\`\``}case"cache_set":{const{instance_id:n,key:e,value:a,ttl:t,org_id:s}=p,i=await $(n);return t&&t>0?(await i.set(e,a,"EX",t),s&&await i.set(`org:${s}:sem:${e}`,a,"EX",t),`\u2705 Set \`${e}\` (TTL: ${t}s)${s?` + shared to \`org:${s}:sem\``:""}`):(await i.set(e,a),s&&await i.set(`org:${s}:sem:${e}`,a),`\u2705 Set \`${e}\` (no expiry)${s?` + shared to \`org:${s}:sem\``:""}`)}case"cache_delete":{const{instance_id:n,keys:e}=p;return`\u2705 Deleted **${await(await $(n)).del(...e)}** of ${e.length} key(s): ${e.map(s=>`\`${s}\``).join(", ")}`}case"cache_exists":{const{instance_id:n,keys:e}=p;return`**${await(await $(n)).exists(...e)}** of ${e.length} key(s) exist in cache.`}case"cache_ttl":{const{instance_id:n,key:e}=p,t=await(await $(n)).ttl(e);if(t===-2)return`Key \`${e}\` \u2192 **does not exist**`;if(t===-1)return`Key \`${e}\` \u2192 **no expiry** (persists forever)`;const s=Math.floor(t/60),i=t%60;return`Key \`${e}\` \u2192 TTL: **${t}s** (${s}m ${i}s remaining)`}case"cache_keys":{const{instance_id:n,pattern:e="*",count:a=50}=p,t=Math.min(a,500),s=await $(n),i=[],o=s.scanStream({match:e,count:100});await new Promise((r,l)=>{o.on("data",f=>{i.push(...f),i.length>=t&&(o.destroy(),r())}),o.on("end",r),o.on("error",l)});const c=i.slice(0,t);return c.length===0?`No keys found matching pattern \`${e}\`.`:[`Found **${c.length}** key(s) matching \`${e}\`:`,...c.map(r=>`  \u2022 \`${r}\``),c.length===t?`
+${r}
+\`\`\``}case"cache_set":{const{instance_id:n,key:e,value:a,ttl:t,org_id:s}=h,i=await _(n);return t&&t>0?(await i.set(e,a,"EX",t),s&&await i.set(`org:${s}:sem:${e}`,a,"EX",t),`\u2705 Set \`${e}\` (TTL: ${t}s)${s?` + shared to \`org:${s}:sem\``:""}`):(await i.set(e,a),s&&await i.set(`org:${s}:sem:${e}`,a),`\u2705 Set \`${e}\` (no expiry)${s?` + shared to \`org:${s}:sem\``:""}`)}case"cache_delete":{const{instance_id:n,keys:e}=h;return`\u2705 Deleted **${await(await _(n)).del(...e)}** of ${e.length} key(s): ${e.map(s=>`\`${s}\``).join(", ")}`}case"cache_exists":{const{instance_id:n,keys:e}=h;return`**${await(await _(n)).exists(...e)}** of ${e.length} key(s) exist in cache.`}case"cache_ttl":{const{instance_id:n,key:e}=h,t=await(await _(n)).ttl(e);if(t===-2)return`Key \`${e}\` \u2192 **does not exist**`;if(t===-1)return`Key \`${e}\` \u2192 **no expiry** (persists forever)`;const s=Math.floor(t/60),i=t%60;return`Key \`${e}\` \u2192 TTL: **${t}s** (${s}m ${i}s remaining)`}case"cache_keys":{const{instance_id:n,pattern:e="*",count:a=50}=h,t=Math.min(a,500),s=await _(n),i=[],r=s.scanStream({match:e,count:100});await new Promise((o,p)=>{r.on("data",m=>{i.push(...m),i.length>=t&&(r.destroy(),o())}),r.on("end",o),r.on("error",p)});const c=i.slice(0,t);return c.length===0?`No keys found matching pattern \`${e}\`.`:[`Found **${c.length}** key(s) matching \`${e}\`:`,...c.map(o=>`  \u2022 \`${o}\``),c.length===t?`
 _(showing first ${t} \u2014 narrow pattern to see more)_`:""].filter(Boolean).join(`
-`)}case"cache_stats":{const{instance_id:n}=p,e=await $(n),[a,t,s]=await Promise.all([e.info("memory"),e.info("stats"),e.info("keyspace")]),i=(g,T)=>g.match(new RegExp(`${T}:([^\r
-]+)`))?.[1]?.trim()??"n/a",o=i(a,"used_memory_human"),c=i(a,"used_memory_peak_human"),r=i(t,"keyspace_hits"),l=i(t,"keyspace_misses"),f=i(t,"instantaneous_ops_per_sec"),d=(await e.info("clients")).match(/connected_clients:(\d+)/)?.[1]??"n/a",y=parseInt(r)||0,w=parseInt(l)||0,x=y+w,S=x>0?(y/x*100).toFixed(1):"n/a",k=s.split(`
-`).filter(g=>g.startsWith("db")).map(g=>`  ${g.trim()}`),h=[`\u{1F4CA} **Cache Stats for instance \`${n}\`:**`,"",`  \u{1F4BE} Memory used:   ${o} (peak: ${c})`,`  \u26A1 Ops/sec:       ${f}`,`  \u{1F3AF} Hit rate:      ${S}% (${r} hits / ${l} misses)`,`  \u{1F517} Clients:       ${d}`,"",k.length>0?`  \u{1F5C2}\uFE0F Keyspace:
-${k.join(`
-`)}`:"  \u{1F5C2}\uFE0F Keyspace: (empty)"];try{const g=await b(`/api/v1/instances/${n}`);if(g.vector_token){const T=process.env.CACHLY_VECTOR_URL??"https://api.cachly.dev",O=await fetch(`${T}/v1/sem/${g.vector_token}/stats`,{signal:AbortSignal.timeout(5e3)});if(O.ok){const m=await O.json(),L=u=>u!==void 0?u.toLocaleString("en-US"):"n/a",U=m.total_hits??0,v=m.total_entries??0;if(U===0&&v===0)h.push("","**Cache usage:**","  \u{1F4ED} No cache hits yet \u2014 you're just getting started.","","  \u{1F680} Next: route LLM calls through cachly to start accumulating hits.",`     Docs: ${X("/docs/semantic","cache-stats")}`);else{const u=m.savings?.week_over_week_pct,_=u!==void 0?`  ${u>=0?"\u{1F4C8}":"\u{1F4C9}"} 7d trend:          ${u>=0?"+":""}${u.toFixed(1)}% vs prev week`:"";h.push("","**Cache usage:**",`  \u{1F4E6} Semantic entries:  ${L(m.total_entries)}`,`  \u{1F3AF} Total cache hits:  ${L(m.total_hits)}`,`  \u23F1\uFE0F Hits last 24h:     ${L(m.savings?.hits_last_24h)}`,`  \u{1F4C5} Hits last 7d:      ${L(m.savings?.hits_last_7d)}`,..._?[_]:[])}m.top_hits&&m.top_hits.length>0&&(h.push("","\u{1F51D} Top cached prompts:"),m.top_hits.slice(0,3).forEach((_,E)=>{const C=_.prompt.length>50?`${_.prompt.slice(0,50)}\u2026`:_.prompt;h.push(`  ${E+1}. "${C}" (hit ${_.hit_count}\xD7)`)}))}}}catch{}return h.join(`
-`)}case"semantic_search":{const{instance_id:n,query:e,threshold:a=.82,namespace:t="cachly:sem",top_k:s=5,use_hybrid:i=!1,auto_namespace:o=!1}=p,c=o?P(e):t;if(!K())return`\u274C semantic_search requires an embedding provider.
+`)}case"cache_stats":{const{instance_id:n}=h,e=await _(n),[a,t,s]=await Promise.all([e.info("memory"),e.info("stats"),e.info("keyspace")]),i=(y,C)=>y.match(new RegExp(`${C}:([^\r
+]+)`))?.[1]?.trim()??"n/a",r=i(a,"used_memory_human"),c=i(a,"used_memory_peak_human"),o=i(t,"keyspace_hits"),p=i(t,"keyspace_misses"),m=i(t,"instantaneous_ops_per_sec"),d=(await e.info("clients")).match(/connected_clients:(\d+)/)?.[1]??"n/a",u=parseInt(o)||0,w=parseInt(p)||0,k=u+w,S=k>0?(u/k*100).toFixed(1):"n/a",$=s.split(`
+`).filter(y=>y.startsWith("db")).map(y=>`  ${y.trim()}`),l=[`\u{1F4CA} **Cache Stats for instance \`${n}\`:**`,"",`  \u{1F4BE} Memory used:   ${r} (peak: ${c})`,`  \u26A1 Ops/sec:       ${m}`,`  \u{1F3AF} Hit rate:      ${S}% (${o} hits / ${p} misses)`,`  \u{1F517} Clients:       ${d}`,"",$.length>0?`  \u{1F5C2}\uFE0F Keyspace:
+${$.join(`
+`)}`:"  \u{1F5C2}\uFE0F Keyspace: (empty)"];try{const y=await O(`/api/v1/instances/${n}`);if(y.vector_token){const C=process.env.CACHLY_VECTOR_URL??"https://api.cachly.dev",j=await fetch(`${C}/v1/sem/${y.vector_token}/stats`,{signal:AbortSignal.timeout(5e3)});if(j.ok){const g=await j.json(),L=v=>v!==void 0?v.toLocaleString("en-US"):"n/a",H=g.total_hits??0,T=g.total_entries??0;if(H===0&&T===0)l.push("","**Cache usage:**","  \u{1F4ED} No cache hits yet \u2014 you're just getting started.","","  \u{1F680} Next: route LLM calls through cachly to start accumulating hits.",`     Docs: ${z("/docs/semantic","cache-stats")}`);else{const v=g.savings?.week_over_week_pct,A=v!==void 0?`  ${v>=0?"\u{1F4C8}":"\u{1F4C9}"} 7d trend:          ${v>=0?"+":""}${v.toFixed(1)}% vs prev week`:"";l.push("","**Cache usage:**",`  \u{1F4E6} Semantic entries:  ${L(g.total_entries)}`,`  \u{1F3AF} Total cache hits:  ${L(g.total_hits)}`,`  \u23F1\uFE0F Hits last 24h:     ${L(g.savings?.hits_last_24h)}`,`  \u{1F4C5} Hits last 7d:      ${L(g.savings?.hits_last_7d)}`,...A?[A]:[])}g.top_hits&&g.top_hits.length>0&&(l.push("","\u{1F51D} Top cached prompts:"),g.top_hits.slice(0,3).forEach((A,f)=>{const x=A.prompt.length>50?`${A.prompt.slice(0,50)}\u2026`:A.prompt;l.push(`  ${f+1}. "${x}" (hit ${A.hit_count}\xD7)`)}))}}}catch{}return l.join(`
+`)}case"semantic_search":{const{instance_id:n,query:e,threshold:a=.82,namespace:t="cachly:sem",top_k:s=5,use_hybrid:i=!1,auto_namespace:r=!1}=h,c=r?q(e):t;if(!D())return`\u274C semantic_search requires an embedding provider.
 
-Current: ${J()}
+Current: ${B()}
 
 Easiest: sign in (CACHLY_JWT). Embeddings then run on the cachly servers in the EU, no extra key.
 Or set OLLAMA_BASE_URL to use a local model (no key needed).
-Your own key with a third-party provider works only if you name the provider yourself: CACHLY_EMBED_PROVIDER=<openai|gemini|mistral|cohere> plus its API key. The text is then sent to that provider.`;const r=await b(`/api/v1/instances/${n}`);if(!r.vector_token)return`\u274C Instance "${r.name}" needs a vector token for semantic search.
+Your own key with a third-party provider works only if you name the provider yourself: CACHLY_EMBED_PROVIDER=<openai|gemini|mistral|cohere> plus its API key. The text is then sent to that provider.`;const o=await O(`/api/v1/instances/${n}`);if(!o.vector_token)return`\u274C Instance "${o.name}" needs a vector token for semantic search.
 
-Every tier includes one. Open ${X(`/instances/${n}`,"health")} and rotate the vector token.`;const l=await R(e),f=process.env.CACHLY_VECTOR_URL??`https://api.cachly.dev/v1/sem/${r.vector_token}`,d={embedding:l,namespace:c,threshold:a,top_k:s};i&&(d.hybrid=!0,d.prompt=e);const y=await fetch(`${f}/search`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(d),signal:AbortSignal.timeout(8e3)});if(!y.ok)throw new V(Y.InternalError,`Vector search failed: ${y.statusText}`);const w=await y.json();if(!w.length||w.length===1&&!w[0].found)return`\u{1F50D} No semantically similar entries found for:
+Every tier includes one. Open ${z(`/instances/${n}`,"health")} and rotate the vector token.`;const p=await I(e),m=process.env.CACHLY_VECTOR_URL??`https://api.cachly.dev/v1/sem/${o.vector_token}`,d={embedding:p,namespace:c,threshold:a,top_k:s};i&&(d.hybrid=!0,d.prompt=e);const u=await fetch(`${m}/search`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(d),signal:AbortSignal.timeout(8e3)});if(!u.ok){const $=(await u.text().catch(()=>"")).replace(/\s+/g," ").trim().slice(0,200);throw new F(W.InternalError,`Vector search failed (HTTP ${u.status}${u.statusText?` ${u.statusText}`:""})${$?`: ${$}`:""}`)}const w=await u.json();if(!w.length||w.length===1&&!w[0].found)return`\u{1F50D} No semantically similar entries found for:
   _"${e}"_
 
-Try lowering the threshold (current: ${a}) or using different keywords.`;const x=await $(n),S=[`\u{1F50D} **Semantic search results** for: _"${e}"_`,`   Threshold: ${a} \xB7 Namespace: \`${c}\``,""];for(const k of w){if(!k.found||!k.id)continue;const h=await x.get(`${c}:val:${k.id}`);S.push(`**Match** (similarity: ${((k.similarity??0)*100).toFixed(1)}%)`,`  Prompt: _"${k.prompt??"(unknown)"}"_`,h?`  Value:  \`${h.slice(0,200)}${h.length>200?"\u2026":""}\``:"  Value:  _(evicted from cache)_","")}return S.join(`
-`)}case"detect_namespace":{const{prompt:n}=p,e=P(n),a=e.split(":").pop(),t={code:"\u{1F4BB} Code \u2014 contains programming constructs or syntax",translation:"\u{1F310} Translation \u2014 asks to translate between languages",summary:"\u{1F4DD} Summary \u2014 requests a summary or key points (TL;DR)",qa:"\u2753 Q&A \u2014 a direct question or query",creative:"\u{1F3A8} Creative \u2014 general, creative, or conversational prompt"};return[`**Detected namespace:** \`${e}\``,`**Type:** ${t[a]??a}`,"",`_Prompt: "${n.slice(0,120)}${n.length>120?"\u2026":""}"_`,"","\u{1F4A1} Use this namespace in `semantic_search` or `cache_warmup` for better hit rates.","   Set `auto_namespace: true` to apply this detection automatically."].join(`
-`)}case"cache_warmup":{const{instance_id:n,entries:e,namespace:a="cachly:sem",ttl:t,auto_namespace:s=!1}=p;if(!K())return`\u274C cache_warmup requires an embedding provider.
+Try lowering the threshold (current: ${a}) or using different keywords.`+(c==="cachly:sem"?`
+Files indexed with index_project are stored in namespace "cachly:sem:code". Search there with namespace: "cachly:sem:code".`:"");const k=await _(n),S=[`\u{1F50D} **Semantic search results** for: _"${e}"_`,`   Threshold: ${a} \xB7 Namespace: \`${c}\``,""];for(const $ of w){if(!$.found||!$.id)continue;const l=await k.get(`${c}:val:${$.id}`);S.push(`**Match** (similarity: ${(($.similarity??0)*100).toFixed(1)}%)`,`  Prompt: _"${$.prompt??"(unknown)"}"_`,l?`  Value:  \`${l.slice(0,200)}${l.length>200?"\u2026":""}\``:"  Value:  _(evicted from cache)_","")}return S.join(`
+`)}case"detect_namespace":{const{prompt:n}=h,e=q(n),a=e.split(":").pop(),t={code:"\u{1F4BB} Code \u2014 contains programming constructs or syntax",translation:"\u{1F310} Translation \u2014 asks to translate between languages",summary:"\u{1F4DD} Summary \u2014 requests a summary or key points (TL;DR)",qa:"\u2753 Q&A \u2014 a direct question or query",creative:"\u{1F3A8} Creative \u2014 general, creative, or conversational prompt"};return[`**Detected namespace:** \`${e}\``,`**Type:** ${t[a]??a}`,"",`_Prompt: "${n.slice(0,120)}${n.length>120?"\u2026":""}"_`,"","\u{1F4A1} Use this namespace in `semantic_search` or `cache_warmup` for better hit rates.","   Set `auto_namespace: true` to apply this detection automatically."].join(`
+`)}case"cache_warmup":{const{instance_id:n,entries:e,namespace:a="cachly:sem",ttl:t,auto_namespace:s=!1}=h;if(!D())return`\u274C cache_warmup requires an embedding provider.
 
-Current: ${J()}
+Current: ${B()}
 
 Supported: openai (default) \xB7 mistral \xB7 cohere \xB7 ollama (local) \xB7 gemini
-Set CACHLY_EMBED_PROVIDER and the matching API key env var.`;const i=await b(`/api/v1/instances/${n}`),o=process.env.CACHLY_VECTOR_URL??(i.vector_token?`https://api.cachly.dev/v1/sem/${i.vector_token}`:null),c=await $(n);let r=0,l=0;const f=[];for(const d of e){const y=d.namespace??(s?P(d.prompt):a),w=await R(d.prompt);let x=!1;if(o){const h=await fetch(`${o}/search`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({embedding:w,namespace:y,threshold:.98}),signal:AbortSignal.timeout(8e3)}).catch(()=>null);h?.ok&&(x=(await h.json())[0]?.found??!1)}if(x){l++,f.push(`  \u23ED\uFE0F  _"${d.prompt.slice(0,60)}${d.prompt.length>60?"\u2026":""}"_ \u2192 already cached`);continue}const S=j(),k=`${y}:val:${S}`;if(t&&t>0?await c.set(k,d.value,"EX",t):await c.set(k,d.value),o){const h={id:S,prompt:d.prompt,namespace:y,embedding:w};t&&t>0&&(h.expires_at=new Date(Date.now()+t*1e3).toISOString()),await fetch(`${o}/entries`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(h),signal:AbortSignal.timeout(8e3)}).catch(()=>{})}else{const h=`${y}:emb:${S}`,g=JSON.stringify({embedding:w,prompt:d.prompt});t&&t>0?await c.set(h,g,"EX",t):await c.set(h,g)}r++,f.push(`  \u2705 _"${d.prompt.slice(0,60)}${d.prompt.length>60?"\u2026":""}"_ \u2192 \`${y}\``)}return["\u{1F525} **Cache Warmup Complete**","",`  \u2705 Warmed:  **${r}** new entries`,`  \u23ED\uFE0F  Skipped: **${l}** (already cached at \u2265 0.98 similarity)`,`  \u{1F4E6} Total:   ${e.length}`,s?"  \u{1F3F7}\uFE0F  Namespacing: auto-detected per prompt":`  \u{1F3F7}\uFE0F  Namespace: \`${a}\``,o?"  \u{1F50D} Mode: pgvector HNSW":"  \u{1F50D} Mode: Valkey SCAN (set CACHLY_VECTOR_URL for pgvector search)","",...f].join(`
-`)}case"index_project":{const{instance_id:n,dir:e,extensions:a,max_files:t=100,ttl:s=86400,summary_chars:i=1200,namespace:o="cachly:sem:code",hintergrund:c=!1}=p,r=new Set((a??["ts","js","tsx","jsx","go","py","java","rs","md","kt","swift"]).map(v=>v.startsWith(".")?v:`.${v}`)),l=[];async function f(v){if(l.length>=t)return;const u=await F(v,{withFileTypes:!0}).catch(()=>null);if(u)for(const _ of u){if(l.length>=t)break;const E=Q(v,_.name);if(_.isDirectory()){if([".git","node_modules","dist","build",".next","__pycache__","vendor"].includes(_.name))continue;await f(E)}else _.isFile()&&r.has(ee(_.name).toLowerCase())&&l.push(E)}}if(await f(e),l.length===0)return`\u274C No matching files found in \`${e}\`.
-Extensions checked: ${[...r].join(", ")}`;const d=await b(`/api/v1/instances/${n}`),y=process.env.CACHLY_VECTOR_URL??(d.vector_token?`https://api.cachly.dev/v1/sem/${d.vector_token}`:null),w=y&&K();let x=0,S=0,k=0,h=0,g=0;const T=[],O=new Date(Date.now()+s*1e3).toISOString(),m=await $(n),L=te({hintergrund:c});for(const v of l){const u=Z(e,v);let _,E;try{const A=await z(v);if(A.size>2e5){S++;continue}E=A.size,_=await G(v,"utf-8")}catch{k++;continue}const C=`cachly:idx:hash:${u}`,N=`${E}:${_.length}:${se(_)}`;if(await m.get(C)===N){const A=`cachly:idx:${u}`;s>0&&await m.expire(A,s),s>0&&await m.expire(C,s),g++;continue}const H=_.slice(0,i).replace(/\s+/g," ").trim(),M=`cachly:idx:${u}`,I=`File: ${u}
-${H}`;if(s>0?await m.set(M,I,"EX",s):await m.set(M,I),s>0?await m.set(C,N,"EX",s):await m.set(C,N),x++,T.push(`  \u2705 ${u}`),w&&L.darf())try{const A=`File: ${u}
-${H}`;await L.warte();const B=await R(A).catch(q=>{throw L.fehler(q),q}),D=j();await fetch(`${y}/entries`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({id:D,prompt:A,namespace:o,embedding:B,expires_at:O}),signal:AbortSignal.timeout(8e3)}),await m.set(`${o}:val:${D}`,u,"EX",s),h++}catch{}}return[`\u{1F4C2} **index_project Complete** \u2014 ${w?"\u{1F50D} Keyword + \u{1F3AF} Semantic":"\u{1F50D} Keyword only (no embedding provider)"}`,"",`  \u{1F4C1} Dir:       ${e}`,`  \u2705 Indexed:   **${x}** files (new/changed)`,`  \u267B\uFE0F  Unchanged: ${g} files (hash match \u2014 skipped)`,...w?[`  \u{1F3AF} Semantic:  **${h}** files (vector-searchable)`]:[],`  \u23ED\uFE0F  Skipped:   ${S} (too large or filtered)`,`  \u274C Errors:    ${k}`,`  \u23F1\uFE0F  TTL:       ${s}s (${Math.round(s/3600)}h)`,"","\u{1F4A1} **Next steps:**",'   1. Use `smart_recall("how does auth work")` to find relevant files.',"   2. Re-run index_project after major refactors.",...w?[]:["   3. Sign in (CACHLY_JWT) or set OLLAMA_BASE_URL to also enable semantic search."],"",...T.length<=20?T:[...T.slice(0,20),`  \u2026 and ${T.length-20} more`]].join(`
-`)}case"cache_mset":{const{instance_id:n,items:e}=p;if(!Array.isArray(e)||e.length===0)return"\u26A0\uFE0F No items provided.";const t=(await $(n)).pipeline();for(const s of e){const i=typeof s.value=="string"?s.value:JSON.stringify(s.value);s.ttl&&s.ttl>0?t.set(s.key,i,"EX",s.ttl):t.set(s.key,i)}return await t.exec(),`\u2705 **cache_mset** \u2013 ${e.length} key(s) written in one pipeline round-trip.
+Set CACHLY_EMBED_PROVIDER and the matching API key env var.`;const i=await O(`/api/v1/instances/${n}`),r=process.env.CACHLY_VECTOR_URL??(i.vector_token?`https://api.cachly.dev/v1/sem/${i.vector_token}`:null),c=await _(n);let o=0,p=0;const m=[];for(const d of e){const u=d.namespace??(s?q(d.prompt):a),w=await I(d.prompt);let k=!1;if(r){const l=await fetch(`${r}/search`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({embedding:w,namespace:u,threshold:.98}),signal:AbortSignal.timeout(8e3)}).catch(()=>null);l?.ok&&(k=(await l.json())[0]?.found??!1)}if(k){p++,m.push(`  \u23ED\uFE0F  _"${d.prompt.slice(0,60)}${d.prompt.length>60?"\u2026":""}"_ \u2192 already cached`);continue}const S=M(),$=`${u}:val:${S}`;if(t&&t>0?await c.set($,d.value,"EX",t):await c.set($,d.value),r){const l={id:S,prompt:d.prompt,namespace:u,embedding:w};t&&t>0&&(l.expires_at=new Date(Date.now()+t*1e3).toISOString()),await fetch(`${r}/entries`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(l),signal:AbortSignal.timeout(8e3)}).catch(()=>{})}else{const l=`${u}:emb:${S}`,y=JSON.stringify({embedding:w,prompt:d.prompt});t&&t>0?await c.set(l,y,"EX",t):await c.set(l,y)}o++,m.push(`  \u2705 _"${d.prompt.slice(0,60)}${d.prompt.length>60?"\u2026":""}"_ \u2192 \`${u}\``)}return["\u{1F525} **Cache Warmup Complete**","",`  \u2705 Warmed:  **${o}** new entries`,`  \u23ED\uFE0F  Skipped: **${p}** (already cached at \u2265 0.98 similarity)`,`  \u{1F4E6} Total:   ${e.length}`,s?"  \u{1F3F7}\uFE0F  Namespacing: auto-detected per prompt":`  \u{1F3F7}\uFE0F  Namespace: \`${a}\``,r?"  \u{1F50D} Mode: pgvector HNSW":"  \u{1F50D} Mode: Valkey SCAN (set CACHLY_VECTOR_URL for pgvector search)","",...m].join(`
+`)}case"index_project":{const{instance_id:n,dir:e,extensions:a,max_files:t=100,ttl:s=86400,summary_chars:i=1200,namespace:r="cachly:sem:code",hintergrund:c=!1}=h;let o=e;const p=new Set((a??["ts","js","tsx","jsx","go","py","java","rs","md","kt","swift"]).map(f=>f.startsWith(".")?f:`.${f}`)),m=[];async function d(f){if(m.length>=t)return;const x=await Z(f,{withFileTypes:!0}).catch(()=>null);if(x)for(const b of x){if(m.length>=t)break;const N=se(f,b.name);if(b.isDirectory()){if([".git","node_modules","dist","build",".next","__pycache__","vendor"].includes(b.name))continue;await d(N)}else b.isFile()&&p.has(ne(b.name).toLowerCase())&&m.push(N)}}if(typeof o!="string"||!o.trim()){const f=h.path;if(typeof f=="string"&&f.trim())o=f;else return"\u274C index_project needs `dir`: the absolute path of the folder to index."}if(await d(o),m.length===0)return`\u274C No matching files found in \`${o}\`.
+Extensions checked: ${[...p].join(", ")}`;const u=await O(`/api/v1/instances/${n}`),w=process.env.CACHLY_VECTOR_URL??(u.vector_token?`https://api.cachly.dev/v1/sem/${u.vector_token}`:null),k=w&&D();let S=0,$=0,l=0,y=0,C=0,j,g=0;const L=[],H=new Date(Date.now()+s*1e3).toISOString(),T=await _(n),v=ie({hintergrund:c});for(const f of m){const x=ae(o,f);let b,N;try{const E=await ee(f);if(E.size>2e5){$++;continue}N=E.size,b=await te(f,"utf-8")}catch{l++;continue}const P=`cachly:idx:hash:${x}`,K=`${N}:${b.length}:${ce(b)}`;if(await T.get(P)===K){const E=`cachly:idx:${x}`;s>0&&await T.expire(E,s),s>0&&await T.expire(P,s),g++;continue}const V=b.slice(0,i).replace(/\s+/g," ").trim(),Y=`cachly:idx:${x}`,J=`File: ${x}
+${V}`;if(s>0?await T.set(Y,J,"EX",s):await T.set(Y,J),s>0?await T.set(P,K,"EX",s):await T.set(P,K),S++,L.push(`  \u2705 ${x}`),k&&v.darf())try{const E=`File: ${x}
+${V}`;await v.warte();const Q=await I(E).catch(R=>{throw v.fehler(R),R}),X=M(),U=await fetch(`${w}/entries`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({id:X,prompt:E,namespace:r,embedding:Q,expires_at:H}),signal:AbortSignal.timeout(8e3)});if(!U.ok){const R=(await U.text().catch(()=>"")).replace(/\s+/g," ").trim().slice(0,200);throw new Error(`HTTP ${U.status}${R?`: ${R}`:""}`)}await T.set(`${r}:val:${X}`,x,"EX",s),y++}catch(E){C++,j??=E instanceof Error?E.message:String(E),await T.del(P).catch(()=>{})}}return[`\u{1F4C2} **index_project Complete** \u2014 ${k?"\u{1F50D} Keyword + \u{1F3AF} Semantic":"\u{1F50D} Keyword only (no embedding provider)"}`,"",`  \u{1F4C1} Dir:       ${o}`,`  \u2705 Indexed:   **${S}** files (new/changed)`,`  \u267B\uFE0F  Unchanged: ${g} files (hash match \u2014 skipped)`,...k?[`  \u{1F3AF} Semantic:  **${y}** files (vector-searchable)`]:[],...C>0?[`  \u26A0\uFE0F  Semantic failed for ${C} file(s): ${j}. The keyword index still works (brain_search).`]:[],`  \u23ED\uFE0F  Skipped:   ${$} (too large or filtered)`,`  \u274C Errors:    ${l}`,`  \u23F1\uFE0F  TTL:       ${s}s (${Math.round(s/3600)}h)`,"","\u{1F4A1} **Next steps:**",'   1. Use `smart_recall("how does auth work")` to find relevant files.',"   2. Re-run index_project after major refactors.",...k?[]:["   3. Sign in (CACHLY_JWT) or set OLLAMA_BASE_URL to also enable semantic search."],"",...L.length<=20?L:[...L.slice(0,20),`  \u2026 and ${L.length-20} more`]].join(`
+`)}case"cache_mset":{const{instance_id:n,items:e}=h;if(!Array.isArray(e)||e.length===0)return"\u26A0\uFE0F No items provided.";const t=(await _(n)).pipeline();for(const s of e){const i=typeof s.value=="string"?s.value:JSON.stringify(s.value);s.ttl&&s.ttl>0?t.set(s.key,i,"EX",s.ttl):t.set(s.key,i)}return await t.exec(),`\u2705 **cache_mset** \u2013 ${e.length} key(s) written in one pipeline round-trip.
 `+e.map(s=>`  \u2022 \`${s.key}\`${s.ttl?` (TTL ${s.ttl}s)`:""}`).join(`
-`)}case"cache_mget":{const{instance_id:n,keys:e}=p;if(!Array.isArray(e)||e.length===0)return"\u26A0\uFE0F No keys provided.";const t=await(await $(n)).mget(...e),s=e.map((i,o)=>{const c=t[o];return c===null?`  \u2022 \`${i}\`: _null (miss)_`:`  \u2022 \`${i}\`: ${c}`});return`\u2705 **cache_mget** \u2013 ${e.length} key(s) fetched in one round-trip.
+`)}case"cache_mget":{const{instance_id:n,keys:e}=h;if(!Array.isArray(e)||e.length===0)return"\u26A0\uFE0F No keys provided.";const t=await(await _(n)).mget(...e),s=e.map((i,r)=>{const c=t[r];return c===null?`  \u2022 \`${i}\`: _null (miss)_`:`  \u2022 \`${i}\`: ${c}`});return`\u2705 **cache_mget** \u2013 ${e.length} key(s) fetched in one round-trip.
 `+s.join(`
-`)}case"cache_lock_acquire":{const{instance_id:n,key:e,ttl_ms:a=5e3,retries:t=3,retry_delay_ms:s=50}=p,i=await $(n),o=`cachly:lock:${e}`,c=j();for(let r=0;r<=t;r++){if(await i.set(o,c,"PX",a,"NX")==="OK")return`\u{1F512} **cache_lock_acquire** \u2013 Lock acquired!
+`)}case"cache_lock_acquire":{const{instance_id:n,key:e,ttl_ms:a=5e3,retries:t=3,retry_delay_ms:s=50}=h,i=await _(n),r=`cachly:lock:${e}`,c=M();for(let o=0;o<=t;o++){if(await i.set(r,c,"PX",a,"NX")==="OK")return`\u{1F512} **cache_lock_acquire** \u2013 Lock acquired!
 
   Key:   \`${e}\`
   Token: \`${c}\`
   TTL:   ${a} ms
 
-\u{1F4A1} Use **cache_lock_release** with this token to release early.`;r<t&&await new Promise(f=>setTimeout(f,s))}return`\u274C **cache_lock_acquire** \u2013 Could not acquire lock for \`${e}\` after ${t+1} attempts.`}case"cache_lock_release":{const{instance_id:n,key:e,token:a}=p;return await(await $(n)).eval('if redis.call("get",KEYS[1])==ARGV[1] then return redis.call("del",KEYS[1]) else return 0 end',1,`cachly:lock:${e}`,a)===1?`\u{1F513} **cache_lock_release** \u2013 Lock \`${e}\` released.`:`\u26A0\uFE0F **cache_lock_release** \u2013 Lock \`${e}\` expired or token mismatch.`}case"cache_stream_set":{const{instance_id:n,key:e,chunks:a,ttl:t}=p;if(!Array.isArray(a)||a.length===0)return"\u26A0\uFE0F No chunks provided.";const s=await $(n),i=`cachly:stream:${e}`;await s.del(i);const o=s.pipeline();for(const c of a)o.rpush(i,c);return t&&t>0&&o.expire(i,t),await o.exec(),`\u2705 **cache_stream_set** \u2013 ${a.length} chunk(s) stored.
+\u{1F4A1} Use **cache_lock_release** with this token to release early.`;o<t&&await new Promise(m=>setTimeout(m,s))}return`\u274C **cache_lock_acquire** \u2013 Could not acquire lock for \`${e}\` after ${t+1} attempts.`}case"cache_lock_release":{const{instance_id:n,key:e,token:a}=h;return await(await _(n)).eval('if redis.call("get",KEYS[1])==ARGV[1] then return redis.call("del",KEYS[1]) else return 0 end',1,`cachly:lock:${e}`,a)===1?`\u{1F513} **cache_lock_release** \u2013 Lock \`${e}\` released.`:`\u26A0\uFE0F **cache_lock_release** \u2013 Lock \`${e}\` expired or token mismatch.`}case"cache_stream_set":{const{instance_id:n,key:e,chunks:a,ttl:t}=h;if(!Array.isArray(a)||a.length===0)return"\u26A0\uFE0F No chunks provided.";const s=await _(n),i=`cachly:stream:${e}`;await s.del(i);const r=s.pipeline();for(const c of a)r.rpush(i,c);return t&&t>0&&r.expire(i,t),await r.exec(),`\u2705 **cache_stream_set** \u2013 ${a.length} chunk(s) stored.
   Key: \`${e}\`
 ${t?`  TTL: ${t}s
-`:""}  Total size: ${a.reduce((c,r)=>c+r.length,0)} chars`}case"cache_stream_get":{const{instance_id:n,key:e}=p,a=await $(n),t=`cachly:stream:${e}`,s=await a.llen(t);if(s===0)return`\u26A0\uFE0F **cache_stream_get** \u2013 Cache miss for key \`${e}\`.`;const o=(await a.lrange(t,0,-1)).join(""),c=o.slice(0,500);return`\u2705 **cache_stream_get** \u2013 ${s} chunk(s) retrieved for \`${e}\`.
+`:""}  Total size: ${a.reduce((c,o)=>c+o.length,0)} chars`}case"cache_stream_get":{const{instance_id:n,key:e}=h,a=await _(n),t=`cachly:stream:${e}`,s=await a.llen(t);if(s===0)return`\u26A0\uFE0F **cache_stream_get** \u2013 Cache miss for key \`${e}\`.`;const r=(await a.lrange(t,0,-1)).join(""),c=r.slice(0,500);return`\u2705 **cache_stream_get** \u2013 ${s} chunk(s) retrieved for \`${e}\`.
 
 **Preview** (first 500 chars):
 \`\`\`
-${c}${c.length<o.length?"\u2026":""}
-\`\`\``}case"cache_org_stats":{const{instance_id:n,org_id:e}=p,a=await $(n),t=`org:${e}:sem`,i=(await ae(a,`${t}:*`,{max:1e4,timeoutMs:5e3})).length,o=[`\u{1F3E2} Org Cache Stats for org \`${e}\`:`,`  \u{1F4E6} Shared entries:  ${i}`,`  \u{1F511} Namespace:       ${t}`,"  \u{1F465} Benefit:         All instances sharing this org_id serve from the same cache","",`\u{1F4A1} To enable sharing: set org_id="${e}" in cache_set calls`];try{const c=await b(`/api/v1/orgs/${e}/savings`);o.push("","Org-wide cache usage:",`  \u{1F5A5}\uFE0F Instances:        ${c.instance_count}`,`  \u{1F3AF} Total cache hits:  ${c.total_hits.toLocaleString("en-US")}`,`  \u23F1\uFE0F Hits last 24h:     ${c.hits_last_24h.toLocaleString("en-US")}`);const r=[...c.per_instance??[]].sort((l,f)=>f.total_hits-l.total_hits).slice(0,5);if(r.length>0){o.push("","  Top instances by hits:");for(const l of r)o.push(`    \u2022 ${l.name||l.instance_id}: ${l.total_hits.toLocaleString("en-US")} hits`)}}catch{}return o.join(`
-`)}case"set_cost_per_call":{const{instance_id:n,cost_per_call_usd:e}=p;if(!e||e<=0||e>100)throw new V(Y.InvalidParams,"cost_per_call_usd must be a positive number \u2264 100");await b(`/api/v1/instances/${n}/cost-per-call`,{method:"PUT",body:JSON.stringify({cost_per_call_usd:e})});const a={"0.02":"claude-opus-4.8","0.015":"gpt-5.5","0.009":"claude-sonnet-4.6","0.002":"gpt-5.5-mini","0.001":"claude-haiku-4.5"},t=a[e.toString()]?` (${a[e.toString()]})`:"";return[`\u2705 **Cost per call updated** \u2014 $${e.toFixed(4)}${t}`,"",`ROI savings in \`cache_stats\` will now use $${e.toFixed(4)} per avoided LLM call.`,"Run `cache_stats` to see your updated savings estimate."].join(`
-`)}default:return null}}export{_e as CACHE_TOOL_NAMES,$e as handleCacheTool};
+${c}${c.length<r.length?"\u2026":""}
+\`\`\``}case"cache_org_stats":{const{instance_id:n,org_id:e}=h,a=await _(n),t=`org:${e}:sem`,i=(await re(a,`${t}:*`,{max:1e4,timeoutMs:5e3})).length,r=[`\u{1F3E2} Org Cache Stats for org \`${e}\`:`,`  \u{1F4E6} Shared entries:  ${i}`,`  \u{1F511} Namespace:       ${t}`,"  \u{1F465} Benefit:         All instances sharing this org_id serve from the same cache","",`\u{1F4A1} To enable sharing: set org_id="${e}" in cache_set calls`];try{const c=await O(`/api/v1/orgs/${e}/savings`);r.push("","Org-wide cache usage:",`  \u{1F5A5}\uFE0F Instances:        ${c.instance_count}`,`  \u{1F3AF} Total cache hits:  ${c.total_hits.toLocaleString("en-US")}`,`  \u23F1\uFE0F Hits last 24h:     ${c.hits_last_24h.toLocaleString("en-US")}`);const o=[...c.per_instance??[]].sort((p,m)=>m.total_hits-p.total_hits).slice(0,5);if(o.length>0){r.push("","  Top instances by hits:");for(const p of o)r.push(`    \u2022 ${p.name||p.instance_id}: ${p.total_hits.toLocaleString("en-US")} hits`)}}catch{}return r.join(`
+`)}case"set_cost_per_call":{const{instance_id:n,cost_per_call_usd:e}=h;if(!e||e<=0||e>100)throw new F(W.InvalidParams,"cost_per_call_usd must be a positive number \u2264 100");await O(`/api/v1/instances/${n}/cost-per-call`,{method:"PUT",body:JSON.stringify({cost_per_call_usd:e})});const a={"0.02":"claude-opus-4.8","0.015":"gpt-5.5","0.009":"claude-sonnet-4.6","0.002":"gpt-5.5-mini","0.001":"claude-haiku-4.5"},t=a[e.toString()]?` (${a[e.toString()]})`:"";return[`\u2705 **Cost per call updated** \u2014 $${e.toFixed(4)}${t}`,"",`ROI savings in \`cache_stats\` will now use $${e.toFixed(4)} per avoided LLM call.`,"Run `cache_stats` to see your updated savings estimate."].join(`
+`)}default:return null}}export{we as CACHE_TOOL_NAMES,ge as handleCacheTool};

package/dist/src/handlers/context.js

@@ -1,17 +1,17 @@
-import{computeEmbedding as _}from"../embeddings.js";import{schwaerzeFelder as k}from"../geheimnis-filter.js";import{pruefeFelder as S,verdachtsWarnung as b}from"../tuersteher.js";import{sofortAntwortNeuesBrain as w}from"../leeres-brain.js";const j=new Set(["remember_context","recall_context","list_remembered","forget_context"]);async function z(g,f,$,x){switch(g){case"remember_context":{const d=k(f).felder,n=S(d),{instance_id:l,key:c,content:a,category:e="custom",ttl:t=86400}=d,o=await $(l),s=`cachly:ctx:${e}:${c}`,r=JSON.stringify({key:c,category:e,size:a.length,created:new Date().toISOString(),...n.length?{verdacht:n}:{}});t&&t>0?(await o.set(s,a,"EX",t),await o.set(`${s}:meta`,r,"EX",t)):(await o.set(s,a),await o.set(`${s}:meta`,r));const h=await x(`/api/v1/instances/${l}`);if(h.vector_token)try{const i=await _(`${c}: ${a.slice(0,500)}`),m=`https://api.cachly.dev/v1/sem/${h.vector_token}`,y={id:`ctx:${e}:${c}`,prompt:c,namespace:"cachly:ctx",embedding:i};t&&t>0&&(y.expires_at=new Date(Date.now()+t*1e3).toISOString());const u=await fetch(`${m}/entries`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(y),signal:AbortSignal.timeout(8e3)});u.ok||process.stderr.write(`[cachly] semantic index skipped (HTTP ${u.status}) \u2014 smart_recall on this context will be keyword-only
-`)}catch(i){process.stderr.write(`[cachly] semantic index failed: ${i instanceof Error?i.message:String(i)} \u2014 smart_recall on this context will be keyword-only
-`)}return["\u{1F9E0} **Context Saved**","",`  Key:      \`${c}\``,`  Category: ${e}`,`  Size:     ${a.length} chars`,`  TTL:      ${t>0?`${t}s (${Math.round(t/3600)}h)`:"no expiry"}`,"",`\u{1F4A1} Use \`recall_context("${c}")\` to retrieve this later.`,`   Or \`smart_recall("${c.split("_").join(" ")}")\` for semantic search.`,...n.length?[b(n)]:[]].join(`
-`)}case"recall_context":{const{instance_id:d,key:n}=f,l=await w(d,x,`\u26A0\uFE0F No cached context found ${n.includes("*")?"matching pattern":"for key"} \`${n}\`.`);if(l)return l;const c=await $(d);if(n.includes("*")){const e=[],t=c.scanStream({match:`cachly:ctx:*:${n}`,count:100});if(await new Promise((s,r)=>{t.on("data",h=>{e.push(...h.filter(i=>!i.endsWith(":meta"))),e.length>=20&&(t.destroy(),s())}),t.on("end",s),t.on("error",r)}),e.length===0)return`\u26A0\uFE0F No cached context found matching pattern \`${n}\`.`;const o=[`\u{1F9E0} **Recalled ${e.length} context entries matching \`${n}\`:**
-`];for(const s of e.slice(0,10)){const r=await c.get(s),h=s.replace("cachly:ctx:","");o.push(`### ${h}
+import{computeEmbedding as _}from"../embeddings.js";import{schwaerzeFelder as k}from"../geheimnis-filter.js";import{pruefeFelder as S,verdachtsWarnung as b}from"../tuersteher.js";import{sofortAntwortNeuesBrain as g}from"../leeres-brain.js";const j=new Set(["remember_context","recall_context","list_remembered","forget_context"]);async function z(p,m,y,x){switch(p){case"remember_context":{const d=k(m).felder,c=S(d),{instance_id:h,key:o,content:a,category:e="custom",ttl:t=86400}=d,n=await y(h),s=`cachly:ctx:${e}:${o}`,r=JSON.stringify({key:o,category:e,size:a.length,created:new Date().toISOString(),...c.length?{verdacht:c}:{}});t&&t>0?(await n.set(s,a,"EX",t),await n.set(`${s}:meta`,r,"EX",t)):(await n.set(s,a),await n.set(`${s}:meta`,r));const i=await x(`/api/v1/instances/${h}`);if(i.vector_token)try{const l=await _(`${o}: ${a.slice(0,500)}`),f=`https://api.cachly.dev/v1/sem/${i.vector_token}`,$={id:`ctx:${e}:${o}`,prompt:o,namespace:"cachly:ctx",embedding:l};t&&t>0&&($.expires_at=new Date(Date.now()+t*1e3).toISOString());const u=await fetch(`${f}/entries`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify($),signal:AbortSignal.timeout(8e3)});u.ok||process.stderr.write(`[cachly] semantic index skipped (HTTP ${u.status}) \u2014 smart_recall on this context will be keyword-only
+`)}catch(l){process.stderr.write(`[cachly] semantic index failed: ${l instanceof Error?l.message:String(l)} \u2014 smart_recall on this context will be keyword-only
+`)}return["\u{1F9E0} **Context Saved**","",`  Key:      \`${o}\``,`  Category: ${e}`,`  Size:     ${a.length} chars`,`  TTL:      ${t>0?`${t}s (${Math.round(t/3600)}h)`:"no expiry"}`,"",`\u{1F4A1} Use \`recall_context("${o}")\` to retrieve this later.`,`   Or \`smart_recall("${o.split("_").join(" ")}")\` for semantic search.`,...c.length?[b(c)]:[]].join(`
+`)}case"recall_context":{const{instance_id:d,key:c}=m,h=await g(d,x,`\u26A0\uFE0F No cached context found ${c.includes("*")?"matching pattern":"for key"} \`${c}\`.`);if(h)return h;const o=await y(d);if(c.includes("*")){const e=[],t=o.scanStream({match:`cachly:ctx:*:${c}`,count:100});if(await new Promise((s,r)=>{t.on("data",i=>{e.push(...i.filter(l=>!l.endsWith(":meta"))),e.length>=20&&(t.destroy(),s())}),t.on("end",s),t.on("error",r)}),e.length===0)return`\u26A0\uFE0F No cached context found matching pattern \`${c}\`.`;const n=[`\u{1F9E0} **Recalled ${e.length} context entries matching \`${c}\`:**
+`];for(const s of e.slice(0,10)){const r=await o.get(s),i=s.replace("cachly:ctx:","");n.push(`### ${i}
 \`\`\`
 ${r?.slice(0,500)}${(r?.length??0)>500?"\u2026":""}
 \`\`\`
-`)}return e.length>10&&o.push(`_(+${e.length-10} more matches)_`),o.join(`
-`)}const a=["overview","architecture","file_summary","dependency","thinking","custom"];for(const e of a){const t=await c.get(`cachly:ctx:${e}:${n}`);if(t){const o=await c.ttl(`cachly:ctx:${e}:${n}`);return[`\u{1F9E0} **Recalled Context: \`${n}\`**`,"",`  Category: ${e}`,`  Size:     ${t.length} chars`,`  TTL:      ${o===-1?"no expiry":o===-2?"expired":`${o}s remaining`}`,"","---","",t].join(`
-`)}}return`\u26A0\uFE0F No cached context found for key \`${n}\`.
+`)}return e.length>10&&n.push(`_(+${e.length-10} more matches)_`),n.join(`
+`)}const a=["overview","architecture","file_summary","dependency","thinking","custom"];for(const e of a){const t=await o.get(`cachly:ctx:${e}:${c}`);if(t){const n=await o.ttl(`cachly:ctx:${e}:${c}`);return[`\u{1F9E0} **Recalled Context: \`${c}\`**`,"",`  Category: ${e}`,`  Size:     ${t.length} chars`,`  TTL:      ${n===-1?"no expiry":n===-2?"expired":`${n}s remaining`}`,"","---","",t].join(`
+`)}}return`\u26A0\uFE0F No cached context found for key \`${c}\`.
 
-Use \`list_remembered\` to see available cached context.`}case"list_remembered":{const{instance_id:d,category:n="all",limit:l=50}=f,c=await w(d,x,"\u{1F4ED} No cached context found.");if(c)return c;const a=await $(d),e=n==="all"?"cachly:ctx:*":`cachly:ctx:${n}:*`,t=[],o=a.scanStream({match:e,count:100});if(await new Promise((r,h)=>{o.on("data",i=>{t.push(...i.filter(m=>!m.endsWith(":meta"))),t.length>=l&&(o.destroy(),r())}),o.on("end",r),o.on("error",h)}),t.length===0)return"\u{1F4ED} No cached context found.\n\nUse `remember_context` to cache context for faster future access.";const s=[`\u{1F9E0} **Cached Context** (${t.length} entries):
-`];for(const r of t.slice(0,l)){const h=await a.ttl(r),i=await a.get(r),m=r.replace("cachly:ctx:","").split(":"),y=m[0],u=m.slice(1).join(":"),p=i?.slice(0,80).replace(/\n/g," ")??"";s.push(`  \u2022 **${u}** (${y})`,`    Size: ${i?.length??0} chars \xB7 TTL: ${h===-1?"\u221E":`${Math.round(h/60)}m`}`,`    _"${p}${(i?.length??0)>80?"\u2026":""}"_`,"")}return s.join(`
-`)}case"forget_context":{const{instance_id:d,keys:n}=f,l=await $(d);let c=0;for(const a of n)if(a.includes("*")){const e=[],t=l.scanStream({match:`cachly:ctx:*:${a}*`,count:100});await new Promise((o,s)=>{t.on("data",r=>e.push(...r)),t.on("end",o),t.on("error",s)}),e.length>0&&(c+=await l.del(...e))}else{const e=["overview","architecture","file_summary","dependency","thinking","custom"];for(const t of e)c+=await l.del(`cachly:ctx:${t}:${a}`,`cachly:ctx:${t}:${a}:meta`)}return`\u{1F5D1}\uFE0F **Forgot ${c} context entries.**
+Use \`list_remembered\` to see available cached context.`}case"list_remembered":{const{instance_id:d,category:c="all",limit:h=50}=m,o=await g(d,x,"\u{1F4ED} No cached context found.");if(o)return o;const a=await y(d),e=c==="all"?"cachly:ctx:*":`cachly:ctx:${c}:*`,t=[],n=a.scanStream({match:e,count:100});if(await new Promise((r,i)=>{n.on("data",l=>{t.push(...l.filter(f=>!f.endsWith(":meta"))),t.length>=h&&(n.destroy(),r())}),n.on("end",r),n.on("error",i)}),t.length===0)return"\u{1F4ED} No cached context found.\n\nUse `remember_context` to cache context for faster future access.";const s=[`\u{1F9E0} **Cached Context** (${t.length} entries):
+`];for(const r of t.slice(0,h)){const i=await a.ttl(r),l=await a.get(r),f=r.replace("cachly:ctx:","").split(":"),$=f[0],u=f.slice(1).join(":"),w=l?.slice(0,80).replace(/\n/g," ")??"";s.push(`  \u2022 **${u}** (${$})`,`    Size: ${l?.length??0} chars \xB7 TTL: ${i===-1?"\u221E":`${Math.round(i/60)}m`}`,`    _"${w}${(l?.length??0)>80?"\u2026":""}"_`,"")}return s.join(`
+`)}case"forget_context":{const{instance_id:d}=m,c=m.keys??m.key,h=(Array.isArray(c)?c:[c]).filter(e=>typeof e=="string"&&e.trim()!=="");if(h.length===0)return'\u274C forget_context needs `keys`: a list of context keys to delete, e.g. keys: ["wip:billing"]. Use list_remembered to see the keys.';const o=await y(d);let a=0;for(const e of h)if(e.includes("*")){const t=[],n=o.scanStream({match:`cachly:ctx:*:${e}*`,count:100});await new Promise((s,r)=>{n.on("data",i=>t.push(...i)),n.on("end",s),n.on("error",r)}),t.length>0&&(a+=await o.del(...t))}else{const t=["overview","architecture","file_summary","dependency","thinking","custom"];for(const n of t)a+=await o.del(`cachly:ctx:${n}:${e}`,`cachly:ctx:${n}:${e}:meta`)}return`\u{1F5D1}\uFE0F **Forgot ${a} context entries.**
 
-Keys: ${n.map(a=>`\`${a}\``).join(", ")}`}default:return null}}export{j as CONTEXT_TOOL_NAMES,z as handleContextTool};
+Keys: ${h.map(e=>`\`${e}\``).join(", ")}`}default:return null}}export{j as CONTEXT_TOOL_NAMES,z as handleContextTool};

package/dist/src/handlers/roadmap.js

@@ -1,13 +1,13 @@
-import{safeJsonParse as S}from"../utils.js";import{sofortAntwortNeuesBrain as I}from"../leeres-brain.js";import{fuerEigenenSpeicher as R,hinweise as T}from"../schreibtor.js";const v=new Set(["roadmap_add","roadmap_update","roadmap_list","roadmap_next"]);async function k(N,y,w,O){switch(N){case"roadmap_add":{const{instance_id:n,title:a,description:d="",priority:m="medium",tags:h=[],milestone:f=""}=y,g=R({title:a,description:d,tags:h,milestone:f}),{title:r,description:t,tags:p,milestone:u}=g.felder,$=await w(n),i=`rm_${Date.now().toString(36)}_${Math.random().toString(36).slice(2,6)}`,o={id:i,title:r,description:t,priority:m,tags:p,milestone:u,status:"planned",created:new Date().toISOString(),updated:new Date().toISOString(),notes:"",...g.verdacht.length?{verdacht:g.verdacht}:{}};await $.hset(`cachly:roadmap:${n}`,i,JSON.stringify(o));const s={critical:"\u{1F534}",high:"\u{1F7E0}",medium:"\u{1F7E1}",low:"\u{1F535}"};return["\u{1F4CB} **Roadmap item added**","",`  ID:       \`${i}\``,`  Title:    ${r}`,`  Priority: ${s[m]??"\u26AA"} ${m}`,"  Status:   planned",u?`  Milestone: ${u}`:"",p.length?`  Tags:     ${p.join(", ")}`:"","",`\u{1F4A1} Use \`roadmap_update(id: "${i}", status: "in-progress")\` when you start working on it.`,...T(g,"notiz")].filter(Boolean).join(`
-`)}case"roadmap_update":{const{instance_id:n,id:a,status:d,priority:m,notes:h,title:f,description:g}=y,r=R({notes:h,title:f,description:g}),{notes:t,title:p,description:u}=r.felder,$=await w(n),i=await $.hget(`cachly:roadmap:${n}`,a);if(!i)return`\u26A0\uFE0F **roadmap_update** \u2013 Item \`${a}\` not found. Use \`roadmap_list\` to see all items.`;const o=S(i,null);if(!o)return`\u26A0\uFE0F **roadmap_update** \u2013 Item \`${a}\` data is corrupted. Re-add with \`roadmap_add\`.`;const s=o.status;return d&&(o.status=d),m&&(o.priority=m),p&&(o.title=p),u&&(o.description=u),t&&(o.notes=o.notes?`${o.notes}
-[${new Date().toISOString().slice(0,10)}] ${t}`:`[${new Date().toISOString().slice(0,10)}] ${t}`),o.updated=new Date().toISOString(),r.verdacht.length&&(o.verdacht=[...new Set([...Array.isArray(o.verdacht)?o.verdacht:[],...r.verdacht])]),await $.hset(`cachly:roadmap:${n}`,a,JSON.stringify(o)),[`${{planned:"\u{1F4CB}","in-progress":"\u26A1",done:"\u2705",blocked:"\u{1F6AB}",cancelled:"\u{1F5D1}\uFE0F"}[d??s]??"\u{1F4CB}"} **Roadmap updated** \`${a}\``,"",`  Title:  ${o.title}`,d&&s!==d?`  Status: ${s} \u2192 ${d}`:`  Status: ${o.status}`,t?`  Notes:  ${t}`:"",...T(r,"notiz")].filter(Boolean).join(`
-`)}case"roadmap_list":{const{instance_id:n,status:a="open",tag:d,milestone:m,priority:h}=y,f=await I(n,O,"\u{1F4CB} **Roadmap is empty.**");if(f)return f;const r=await(await w(n)).hgetall(`cachly:roadmap:${n}`);if(!r||Object.keys(r).length===0)return"\u{1F4CB} **Roadmap is empty.**\n\nUse `roadmap_add` to create your first item.";const t={critical:0,high:1,medium:2,low:3},p={critical:"\u{1F534}",high:"\u{1F7E0}",medium:"\u{1F7E1}",low:"\u{1F535}"},u={planned:"\u{1F4CB}","in-progress":"\u26A1",done:"\u2705",blocked:"\u{1F6AB}",cancelled:"\u{1F5D1}\uFE0F"},$=new Set(["planned","in-progress","blocked"]);let i=Object.values(r).flatMap(e=>{const c=S(e,null);return c?[c]:[]});if(a==="open"?i=i.filter(e=>$.has(e.status)):a&&(i=i.filter(e=>e.status===a)),d&&(i=i.filter(e=>e.tags.includes(d))),m&&(i=i.filter(e=>e.milestone===m)),h&&(i=i.filter(e=>(t[e.priority]??99)<=(t[h]??99))),i.sort((e,c)=>{const l=t[e.priority]??99,_=t[c.priority]??99;return l!==_?l-_:e.created.localeCompare(c.created)}),i.length===0)return`\u{1F4CB} **No roadmap items** match the current filter (status: ${a}).`;const o={};for(const e of i){const c=e.status;o[c]||(o[c]=[]),o[c].push(e)}const s=[`\u{1F4CB} **Roadmap** (${i.length} item${i.length!==1?"s":""})`,""];for(const[e,c]of Object.entries(o)){s.push(`**${u[e]??"\u2022"} ${e.toUpperCase()}** (${c.length})`);for(const l of c){const _=l.tags.length?` [${l.tags.join(", ")}]`:"",j=l.milestone?` \xB7 ${l.milestone}`:"";s.push(`  ${p[l.priority]??"\u26AA"} \`${l.id}\` **${l.title}**${_}${j}`),l.description&&s.push(`      ${l.description.slice(0,120)}`),l.notes&&s.push(`      \u{1F4DD} ${l.notes.split(`
-`).pop()?.slice(0,100)}`)}s.push("")}return s.push('\u{1F4A1} `roadmap_update(id, status: "in-progress")` to start \xB7 `roadmap_next` for top priority item'),s.join(`
-`)}case"roadmap_next":{const{instance_id:n,tag:a}=y,d=await I(n,O,"\u{1F4CB} **Roadmap is empty.**");if(d)return d;const h=await(await w(n)).hgetall(`cachly:roadmap:${n}`);if(!h||Object.keys(h).length===0)return"\u{1F4CB} **Roadmap is empty.** Use `roadmap_add` to plan your first task.";const f={critical:0,high:1,medium:2,low:3},g={critical:"\u{1F534}",high:"\u{1F7E0}",medium:"\u{1F7E1}",low:"\u{1F535}"},r=Object.values(h).flatMap(s=>{const e=S(s,null);return e?[e]:[]}).filter(s=>s.status==="in-progress"||s.status==="planned").filter(s=>!a||(Array.isArray(s.tags)?s.tags:[]).includes(a));if(r.length===0)return"\u{1F389} **No open roadmap items!** All tasks are done (or use `roadmap_list` to check).";r.sort((s,e)=>s.status==="in-progress"&&e.status!=="in-progress"?-1:e.status==="in-progress"&&s.status!=="in-progress"?1:(f[s.priority]??99)-(f[e.priority]??99));const t=r[0],p=r.length-1,u=Array.isArray(t.tags)?t.tags:[],$=u.length?`
-Tags:      ${u.join(", ")}`:"",i=t.milestone?`
+import{safeJsonParse as O}from"../utils.js";import{sofortAntwortNeuesBrain as I}from"../leeres-brain.js";import{fuerEigenenSpeicher as T,hinweise as j}from"../schreibtor.js";const A=["planned","in-progress","done","blocked","cancelled"],S=["critical","high","medium","low"],M=new Set(["roadmap_add","roadmap_update","roadmap_list","roadmap_next"]);async function v(D,w,y,R){switch(D){case"roadmap_add":{const{instance_id:l,title:a,description:n="",priority:d="medium",tags:f=[],milestone:h=""}=w,g=T({title:a,description:n,tags:f,milestone:h}),{title:r,description:t,tags:c,milestone:m}=g.felder;if(!S.includes(d))return`\u26A0\uFE0F **roadmap_add** \u2013 Unknown priority \`${d}\`. Use one of: ${S.join(", ")}.`;const $=await y(l),s=`rm_${Date.now().toString(36)}_${Math.random().toString(36).slice(2,6)}`,o={id:s,title:r,description:t,priority:d,tags:c,milestone:m,status:"planned",created:new Date().toISOString(),updated:new Date().toISOString(),notes:"",...g.verdacht.length?{verdacht:g.verdacht}:{}};await $.hset(`cachly:roadmap:${l}`,s,JSON.stringify(o));const i={critical:"\u{1F534}",high:"\u{1F7E0}",medium:"\u{1F7E1}",low:"\u{1F535}"};return["\u{1F4CB} **Roadmap item added**","",`  ID:       \`${s}\``,`  Title:    ${r}`,`  Priority: ${i[d]??"\u26AA"} ${d}`,"  Status:   planned",m?`  Milestone: ${m}`:"",c.length?`  Tags:     ${c.join(", ")}`:"","",`\u{1F4A1} Use \`roadmap_update(id: "${s}", status: "in-progress")\` when you start working on it.`,...j(g,"notiz")].filter(Boolean).join(`
+`)}case"roadmap_update":{const{instance_id:l,id:a,status:n,priority:d,notes:f,title:h,description:g}=w,r=T({notes:f,title:h,description:g}),{notes:t,title:c,description:m}=r.felder;if(n&&!A.includes(n))return`\u26A0\uFE0F **roadmap_update** \u2013 Unknown status \`${n}\`. Use one of: ${A.join(", ")}.`;if(d&&!S.includes(d))return`\u26A0\uFE0F **roadmap_update** \u2013 Unknown priority \`${d}\`. Use one of: ${S.join(", ")}.`;const $=await y(l),s=await $.hget(`cachly:roadmap:${l}`,a);if(!s)return`\u26A0\uFE0F **roadmap_update** \u2013 Item \`${a}\` not found. Use \`roadmap_list\` to see all items.`;const o=O(s,null);if(!o)return`\u26A0\uFE0F **roadmap_update** \u2013 Item \`${a}\` data is corrupted. Re-add with \`roadmap_add\`.`;const i=o.status;return n&&(o.status=n),d&&(o.priority=d),c&&(o.title=c),m&&(o.description=m),t&&(o.notes=o.notes?`${o.notes}
+[${new Date().toISOString().slice(0,10)}] ${t}`:`[${new Date().toISOString().slice(0,10)}] ${t}`),o.updated=new Date().toISOString(),r.verdacht.length&&(o.verdacht=[...new Set([...Array.isArray(o.verdacht)?o.verdacht:[],...r.verdacht])]),await $.hset(`cachly:roadmap:${l}`,a,JSON.stringify(o)),[`${{planned:"\u{1F4CB}","in-progress":"\u26A1",done:"\u2705",blocked:"\u{1F6AB}",cancelled:"\u{1F5D1}\uFE0F"}[n??i]??"\u{1F4CB}"} **Roadmap updated** \`${a}\``,"",`  Title:  ${o.title}`,n&&i!==n?`  Status: ${i} \u2192 ${n}`:`  Status: ${o.status}`,t?`  Notes:  ${t}`:"",...j(r,"notiz")].filter(Boolean).join(`
+`)}case"roadmap_list":{const{instance_id:l,status:a="open",tag:n,milestone:d,priority:f}=w,h=await I(l,R,"\u{1F4CB} **Roadmap is empty.**");if(h)return h;const r=await(await y(l)).hgetall(`cachly:roadmap:${l}`);if(!r||Object.keys(r).length===0)return"\u{1F4CB} **Roadmap is empty.**\n\nUse `roadmap_add` to create your first item.";const t={critical:0,high:1,medium:2,low:3},c={critical:"\u{1F534}",high:"\u{1F7E0}",medium:"\u{1F7E1}",low:"\u{1F535}"},m={planned:"\u{1F4CB}","in-progress":"\u26A1",done:"\u2705",blocked:"\u{1F6AB}",cancelled:"\u{1F5D1}\uFE0F"},$=new Set(["planned","in-progress","blocked"]);let s=Object.values(r).flatMap(e=>{const u=O(e,null);return u?[u]:[]});if(a==="open"?s=s.filter(e=>$.has(e.status)):a&&(s=s.filter(e=>e.status===a)),n&&(s=s.filter(e=>e.tags.includes(n))),d&&(s=s.filter(e=>e.milestone===d)),f&&(s=s.filter(e=>(t[e.priority]??99)<=(t[f]??99))),s.sort((e,u)=>{const p=t[e.priority]??99,_=t[u.priority]??99;return p!==_?p-_:e.created.localeCompare(u.created)}),s.length===0)return`\u{1F4CB} **No roadmap items** match the current filter (status: ${a}).`;const o={};for(const e of s){const u=e.status;o[u]||(o[u]=[]),o[u].push(e)}const i=[`\u{1F4CB} **Roadmap** (${s.length} item${s.length!==1?"s":""})`,""];for(const[e,u]of Object.entries(o)){i.push(`**${m[e]??"\u2022"} ${e.toUpperCase()}** (${u.length})`);for(const p of u){const _=p.tags.length?` [${p.tags.join(", ")}]`:"",N=p.milestone?` \xB7 ${p.milestone}`:"";i.push(`  ${c[p.priority]??"\u26AA"} \`${p.id}\` **${p.title}**${_}${N}`),p.description&&i.push(`      ${p.description.slice(0,120)}`),p.notes&&i.push(`      \u{1F4DD} ${p.notes.split(`
+`).pop()?.slice(0,100)}`)}i.push("")}return i.push('\u{1F4A1} `roadmap_update(id, status: "in-progress")` to start \xB7 `roadmap_next` for top priority item'),i.join(`
+`)}case"roadmap_next":{const{instance_id:l,tag:a}=w,n=await I(l,R,"\u{1F4CB} **Roadmap is empty.**");if(n)return n;const f=await(await y(l)).hgetall(`cachly:roadmap:${l}`);if(!f||Object.keys(f).length===0)return"\u{1F4CB} **Roadmap is empty.** Use `roadmap_add` to plan your first task.";const h={critical:0,high:1,medium:2,low:3},g={critical:"\u{1F534}",high:"\u{1F7E0}",medium:"\u{1F7E1}",low:"\u{1F535}"},r=Object.values(f).flatMap(i=>{const e=O(i,null);return e?[e]:[]}).filter(i=>i.status==="in-progress"||i.status==="planned").filter(i=>!a||(Array.isArray(i.tags)?i.tags:[]).includes(a));if(r.length===0)return"\u{1F389} **No open roadmap items!** All tasks are done (or use `roadmap_list` to check).";r.sort((i,e)=>i.status==="in-progress"&&e.status!=="in-progress"?-1:e.status==="in-progress"&&i.status!=="in-progress"?1:(h[i.priority]??99)-(h[e.priority]??99));const t=r[0],c=r.length-1,m=Array.isArray(t.tags)?t.tags:[],$=m.length?`
+Tags:      ${m.join(", ")}`:"",s=t.milestone?`
 Milestone: ${t.milestone}`:"",o=t.notes?`
 Notes:     ${t.notes.split(`
 `).pop()?.slice(0,120)}`:"";return[`${t.status==="in-progress"?"\u26A1":"\u{1F4CB}"} **Next up: ${t.title}**`,"",`ID:        \`${t.id}\``,`Priority:  ${g[t.priority]??"\u26AA"} ${t.priority}`,`Status:    ${t.status}`,t.description?`
 What to do:
-${t.description}`:"",$,i,o,"",p>0?`(+${p} more open item${p!==1?"s":""} in roadmap)`:"(last open item)","",t.status==="planned"?`\u{1F4A1} Start with: \`roadmap_update(id: "${t.id}", status: "in-progress")\``:`\u{1F4A1} Finish with: \`roadmap_update(id: "${t.id}", status: "done", notes: "...")\``].filter(s=>s!==void 0).join(`
-`)}default:return null}}export{v as ROADMAP_TOOL_NAMES,k as handleRoadmapTool};
+${t.description}`:"",$,s,o,"",c>0?`(+${c} more open item${c!==1?"s":""} in roadmap)`:"(last open item)","",t.status==="planned"?`\u{1F4A1} Start with: \`roadmap_update(id: "${t.id}", status: "in-progress")\``:`\u{1F4A1} Finish with: \`roadmap_update(id: "${t.id}", status: "done", notes: "...")\``].filter(i=>i!==void 0).join(`
+`)}default:return null}}export{S as ROADMAP_PRIORITY,A as ROADMAP_STATUS,M as ROADMAP_TOOL_NAMES,v as handleRoadmapTool};