@vpxa/aikit 0.1.234 → 0.1.235
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/package.json +1 -1
- package/packages/cli/dist/index.js +3 -3
- package/packages/cli/dist/{init-KEqLRZvX.js → init-C0s-ZRbw.js} +1 -1
- package/packages/cli/dist/{templates-DCTrIlP5.js → templates-BcHM0wJo.js} +2 -2
- package/packages/embeddings/dist/index.js +1 -1
- package/packages/server/dist/bin.js +1 -1
- package/packages/server/dist/config-DzZLgNQT.js +2 -0
- package/packages/server/dist/config-Ymr8iMyI.js +1 -0
- package/packages/server/dist/index.js +1 -1
- package/packages/server/dist/{server-BnJ23Hc4.js → server-992x1P0e.js} +113 -113
- package/packages/server/dist/{server-B3q3h9L3.js → server-DUwue6o8.js} +113 -113
- package/scaffold/definitions/mcp-entry.json +1 -1
- package/scaffold/dist/definitions/mcp-entry.json +1 -1
- package/scaffold/dist/definitions/models.mjs +1 -1
- package/scaffold/dist/definitions/protocols.mjs +1 -1
- package/packages/server/dist/config-8WXJx-zc.js +0 -2
- package/packages/server/dist/config-C35F4tJm.js +0 -1
|
@@ -143,27 +143,27 @@ Changed values:
|
|
|
143
143
|
${o.length>0?o.join(`
|
|
144
144
|
`):`- No effective changes; requested values already matched the file.`}
|
|
145
145
|
|
|
146
|
-
These changes take effect on the next server restart.`;return r(`Configuration`,nl(t)),{content:[{type:`text`,text:s}],ui:{type:`resource`,uri:Uc}}}catch(e){return Hc.error(`Failed to update config`,{configPath:a,error:e instanceof Error?e.message:String(e)}),{content:[{type:`text`,text:`Failed to update configuration in ${a}: ${e instanceof Error?e.message:String(e)}`}]}}})),r(`Configuration`,nl(t))}const sl=F(`cross-workspace`);function cl(e,t){if(!Pe())return[];let n=Fe();if(n.length===0)return[];if(e.includes(`*`))return t?n.filter(e=>e.partition!==t):n;let r=[];for(let i of e){let e=n.find(e=>e.partition===i);if(e){e.partition!==t&&r.push(e);continue}let a=n.filter(e=>e.partition!==t&&e.partition.replace(/-[a-f0-9]{8}$/,``)===i.toLowerCase());r.push(...a)}let i=new Set;return r.filter(e=>i.has(e.partition)?!1:(i.add(e.partition),!0))}async function ll(e){let t=new Map;for(let n of e)try{let e=await _r({backend:`sqlite-vec`,path:Ne(n.partition)});await e.initialize(),t.set(n.partition,e)}catch(e){sl.warn(`Failed to open workspace store`,{partition:n.partition,err:e})}return{stores:t,closeAll:async()=>{for(let[,e]of t)try{await e.close()}catch{}}}}async function ul(e,t,n){let r=[...e.entries()].map(async([e,r])=>{try{return(await r.search(t,n)).map(t=>({...t,workspace:e}))}catch(t){return sl.warn(`Cross-workspace search failed for partition`,{partition:e,err:t}),[]}});return(await Promise.all(r)).flat().sort((e,t)=>t.score-e.score).slice(0,n.limit)}async function dl(e,t,n){let r=[...e.entries()].map(async([e,r])=>{try{return(await r.ftsSearch(t,n)).map(t=>({...t,workspace:e}))}catch(t){return sl.warn(`Cross-workspace FTS search failed for partition`,{partition:e,err:t}),[]}});return(await Promise.all(r)).flat().sort((e,t)=>t.score-e.score).slice(0,n.limit)}function fl(e){return e.toLowerCase().replace(/[-_]/g,``)}function pl(e){let t=_e(e),n=fl(ge(e));try{let e=ue(t);for(let r of e)if(fl(r)===n){let e=P(t,r);if(A(e))return e}}catch{}}function ml(e,t,n){if(ve(e))return A(e)?e:pl(e)||e;let r=P(t,e);if(A(r))return r;let i=pl(r);if(i)return i;if(n)for(let r of n){if(r===t)continue;let n=P(r,e);if(A(n))return n;let i=pl(n);if(i)return i}try{let n=ue(t,{withFileTypes:!0});for(let r of n){if(!r.isDirectory()||r.name.startsWith(`.`)||r.name===`node_modules`)continue;let n=P(t,r.name,e);if(A(n))return n;let i=pl(n);if(i)return i}}catch{}return r}const hl=F(`tools:context`);function gl(e,t,n,r){if(!r||!e)return;let i=e.replace(/\\/g,`/`);if(![t,...n??[]].map(e=>e.replace(/\\/g,`/`)).some(e=>{let t=e.endsWith(`/`)?e.slice(0,-1):e;return i===t||i.startsWith(`${t}/`)}))try{r(e)}catch{}}function
|
|
147
|
-
`);if(f&&a){let e=await W(a,{query:c,filePath:p});h+=G(e)}return{content:[{type:`text`,text:h}],structuredContent:{text:h,originalChars:m.originalChars,compressedChars:m.compressedChars,ratio:m.ratio,segmentsKept:m.segmentsKept,segmentsTotal:m.segmentsTotal}}}catch(e){return
|
|
148
|
-
`)+"\n\n---\n_Next: Use `search` to dive into specific files, or `compact` to compress file contents for context._";if(s&&r){let t=await W(r,{query:e});l+=G(t)}return{content:[{type:`text`,text:o?L(l,o):l}],structuredContent:{files:c.files.map(e=>({path:e.path,relevance:e.relevance,estimatedTokens:e.estimatedTokens,...e.focusRanges.length>0?{focusLines:e.focusRanges.map(e=>`L${e.start}-${e.end}`)}:{}})),totalFiles:c.files.length,totalEstimatedTokens:c.totalEstimatedTokens,task:e}}}catch(e){return
|
|
146
|
+
These changes take effect on the next server restart.`;return r(`Configuration`,nl(t)),{content:[{type:`text`,text:s}],ui:{type:`resource`,uri:Uc}}}catch(e){return Hc.error(`Failed to update config`,{configPath:a,error:e instanceof Error?e.message:String(e)}),{content:[{type:`text`,text:`Failed to update configuration in ${a}: ${e instanceof Error?e.message:String(e)}`}]}}})),r(`Configuration`,nl(t))}const sl=F(`cross-workspace`);function cl(e,t){if(!Pe())return[];let n=Fe();if(n.length===0)return[];if(e.includes(`*`))return t?n.filter(e=>e.partition!==t):n;let r=[];for(let i of e){let e=n.find(e=>e.partition===i);if(e){e.partition!==t&&r.push(e);continue}let a=n.filter(e=>e.partition!==t&&e.partition.replace(/-[a-f0-9]{8}$/,``)===i.toLowerCase());r.push(...a)}let i=new Set;return r.filter(e=>i.has(e.partition)?!1:(i.add(e.partition),!0))}async function ll(e){let t=new Map;for(let n of e)try{let e=await _r({backend:`sqlite-vec`,path:Ne(n.partition)});await e.initialize(),t.set(n.partition,e)}catch(e){sl.warn(`Failed to open workspace store`,{partition:n.partition,err:e})}return{stores:t,closeAll:async()=>{for(let[,e]of t)try{await e.close()}catch{}}}}async function ul(e,t,n){let r=[...e.entries()].map(async([e,r])=>{try{return(await r.search(t,n)).map(t=>({...t,workspace:e}))}catch(t){return sl.warn(`Cross-workspace search failed for partition`,{partition:e,err:t}),[]}});return(await Promise.all(r)).flat().sort((e,t)=>t.score-e.score).slice(0,n.limit)}async function dl(e,t,n){let r=[...e.entries()].map(async([e,r])=>{try{return(await r.ftsSearch(t,n)).map(t=>({...t,workspace:e}))}catch(t){return sl.warn(`Cross-workspace FTS search failed for partition`,{partition:e,err:t}),[]}});return(await Promise.all(r)).flat().sort((e,t)=>t.score-e.score).slice(0,n.limit)}function fl(e){return e.toLowerCase().replace(/[-_]/g,``)}function pl(e){let t=_e(e),n=fl(ge(e));try{let e=ue(t);for(let r of e)if(fl(r)===n){let e=P(t,r);if(A(e))return e}}catch{}}function ml(e,t,n){if(ve(e))return A(e)?e:pl(e)||e;let r=P(t,e);if(A(r))return r;let i=pl(r);if(i)return i;if(n)for(let r of n){if(r===t)continue;let n=P(r,e);if(A(n))return n;let i=pl(n);if(i)return i}try{let n=ue(t,{withFileTypes:!0});for(let r of n){if(!r.isDirectory()||r.name.startsWith(`.`)||r.name===`node_modules`)continue;let n=P(t,r.name,e);if(A(n))return n;let i=pl(n);if(i)return i}}catch{}return r}const hl=F(`tools:context`);function gl(e){return e instanceof Error&&`code`in e&&e.code===`ENOENT`}function _l(e,t){return gl(t)?(hl.warn(`${e} failed`,{error:`File not found`}),K(`NOT_FOUND`,`File not found`)):(hl.error(`${e} failed`,I(t)),K(`INTERNAL`,`${e} failed: ${t instanceof Error?t.message:String(t)}`))}function vl(e,t,n,r){if(!r||!e)return;let i=e.replace(/\\/g,`/`);if(![t,...n??[]].map(e=>e.replace(/\\/g,`/`)).some(e=>{let t=e.endsWith(`/`)?e.slice(0,-1):e;return i===t||i.startsWith(`${t}/`)}))try{r(e)}catch{}}function yl(e,t,n,r,i,a,o){let s=U(`compact`);e.registerTool(`compact`,{title:s.title,description:"Compress text to relevant sections using embedding similarity (no LLM). Provide either `text` or `path` (server reads the file — saves a round-trip). Segments by paragraph/sentence/line.",outputSchema:Ws,inputSchema:{text:R.string().optional().describe(`The text to compress (provide this OR path, not both)`),path:R.string().optional().describe(`File path to read server-side — avoids read_file round-trip + token doubling (provide this OR text)`),query:R.string().describe(`Focus query — what are you trying to understand?`),max_chars:R.number().min(100).max(5e4).default(3e3).describe(`Target output size in characters`),segmentation:R.enum([`paragraph`,`sentence`,`line`]).default(`paragraph`).describe(`How to split the text for scoring`),token_budget:R.number().min(50).max(12500).optional().describe(`Token budget — overrides max_chars (approx 4 chars per token). Use to fit output into a specific context window.`),enrich:R.boolean().default(!1).describe(`Append curated knowledge and graph context to output. Adds ~150-250 tokens. Default false — set true when you need stored decisions, conventions, or relationship context for the file/query.`)},annotations:s.annotations},q(`compact`,async({text:e,path:s,query:c,max_chars:l,segmentation:u,token_budget:d,enrich:f})=>{try{let p=s?ml(s,r,i):void 0;if(!e&&!p)return K(`VALIDATION`,`Either "text" or "path" must be provided.`);let m=await Ze(t,{text:e,path:p,query:c,maxChars:l,tokenBudget:d,segmentation:u,cache:n});vl(p,r,i,o);let h=[`Compressed ${m.originalChars} → ${m.compressedChars} chars (${(m.ratio*100).toFixed(0)}%)`,`Kept ${m.segmentsKept}/${m.segmentsTotal} segments`,``,m.text].join(`
|
|
147
|
+
`);if(f&&a){let e=await W(a,{query:c,filePath:p});h+=G(e)}return{content:[{type:`text`,text:h}],structuredContent:{text:h,originalChars:m.originalChars,compressedChars:m.compressedChars,ratio:m.ratio,segmentsKept:m.segmentsKept,segmentsTotal:m.segmentsTotal}}}catch(e){return{..._l(`Compact`,e),structuredContent:{text:``,originalChars:0,compressedChars:0,ratio:0,segmentsKept:0,segmentsTotal:0}}}}))}function bl(e,t,n,r){let i=U(`scope_map`);e.registerTool(`scope_map`,{title:i.title,description:`Generate a task-scoped reading plan. Given a task description, identifies which files and sections are relevant, with estimated token counts and suggested reading order.`,outputSchema:Ns,inputSchema:{task:R.string().describe(`Description of the task to scope`),max_files:R.number().min(1).max(50).default(15).describe(`Maximum files to include`),content_type:R.enum(Ce).optional().describe(`Filter by content type`),max_tokens:R.number().min(100).max(5e4).optional().describe(`Maximum token budget for the response. When set, output is truncated to fit.`),enrich:R.boolean().default(!0).describe(`Append curated knowledge and graph context to output. Adds ~150-250 tokens. Default true for planning tools — set false to save tokens when enrichment is not needed.`)},annotations:i.annotations},q(`scope_map`,async({task:e,max_files:i,content_type:a,max_tokens:o,enrich:s})=>{try{let c=await un(t,n,{task:e,maxFiles:i,contentType:a}),l=[`## Scope Map: ${e}`,`Total estimated tokens: ~${c.totalEstimatedTokens}`,``,`### Files (by relevance)`,...c.files.map((e,t)=>`${t+1}. **${e.path}** (~${e.estimatedTokens} tokens, ${(e.relevance*100).toFixed(0)}% relevant)\n ${e.reason}\n Focus: ${e.focusRanges.map(e=>`L${e.start}-${e.end}`).join(`, `)}`),``,`### Suggested Reading Order`,...c.readingOrder.map((e,t)=>`${t+1}. ${e}`),``,`### Suggested Compact Calls`,`_Estimated compressed total: ~${Math.ceil(c.totalEstimatedTokens/5)} tokens_`,...c.compactCommands.map((e,t)=>`${t+1}. ${e}`)].join(`
|
|
148
|
+
`)+"\n\n---\n_Next: Use `search` to dive into specific files, or `compact` to compress file contents for context._";if(s&&r){let t=await W(r,{query:e});l+=G(t)}return{content:[{type:`text`,text:o?L(l,o):l}],structuredContent:{files:c.files.map(e=>({path:e.path,relevance:e.relevance,estimatedTokens:e.estimatedTokens,...e.focusRanges.length>0?{focusLines:e.focusRanges.map(e=>`L${e.start}-${e.end}`)}:{}})),totalFiles:c.files.length,totalEstimatedTokens:c.totalEstimatedTokens,task:e}}}catch(e){return _l(`Scope map`,e)}}))}function xl(e,t,n,r,i){let a=U(`find`);e.registerTool(`find`,{title:a.title,description:`Multi-strategy search combining vector, FTS, glob, and regex. Use for precise queries needing multiple strategies. mode=examples finds real usage of a symbol. For general discovery use search instead.`,outputSchema:js,inputSchema:{query:R.string().optional().describe(`Semantic/keyword search query (required for mode "examples")`),glob:R.string().optional().describe(`File glob pattern (search mode only)`),pattern:R.string().optional().describe(`Regex pattern to match in content (search mode only)`),limit:R.number().min(1).max(50).default(10).describe(`Max results`),content_type:R.enum(Ce).optional().describe(`Filter by content type`),mode:R.enum([`search`,`examples`]).default(`search`).describe(`Mode: "search" (default) for federated search, "examples" to find usage examples of a symbol/pattern`),max_tokens:R.number().min(100).max(5e4).optional().describe(`Maximum token budget for the response. When set, output is truncated to fit.`),workspaces:R.array(R.string()).optional().describe(`Cross-workspace search: partition names or folder basenames to include. Use ["*"] for all. User-level mode only.`),enrich:R.boolean().default(!1).describe(`Append curated knowledge and graph context to output. Adds ~150-250 tokens. Default false — set true when you need stored decisions, conventions, or relationship context for the file/query.`)},annotations:a.annotations},q(`find`,async({query:e,glob:a,pattern:o,limit:s,content_type:c,mode:l,max_tokens:u,workspaces:d,enrich:f})=>{try{if(l===`examples`){if(!e)return K(`VALIDATION`,`"query" is required for mode "examples".`);let r=await ht(t,n,{query:e,limit:s,contentType:c}),a=JSON.stringify(r);if(f&&i){let t=await W(i,{query:e});a+=G(t)}return{content:[{type:`text`,text:u?L(a,u):a}]}}let p=await pt(t,n,{query:e,glob:a,pattern:o,limit:s,contentType:c,cwd:r}),m=``;if(d&&d.length>0&&e){let n=cl(d,je(process.cwd()));if(n.length>0){let{stores:r,closeAll:i}=await ll(n);try{let i=await ul(r,await t.embedQuery(e),{limit:s,contentType:c});for(let e of i)p.results.push({path:`[${e.workspace}] ${e.record.sourcePath}`,score:e.score,source:`cross-workspace`,lineRange:e.record.startLine?{start:e.record.startLine,end:e.record.endLine}:void 0,preview:e.record.content.slice(0,200)});p.results.sort((e,t)=>t.score-e.score),p.results=p.results.slice(0,s),p.totalFound=p.results.length,m=` + ${n.length} workspace(s)`}finally{await i()}}}if(p.results.length===0){let t=`No results found.${p.failedStrategies?.length?`\nStrategies attempted: ${p.strategies.join(`, `)}\nFailed: ${p.failedStrategies.map(e=>`${e.strategy} (${e.reason})`).join(`, `)}`:p.strategies.length===0?`
|
|
149
149
|
No search strategies were activated. Provide at least one of: query, glob, or pattern.`:``}`;if(f&&i){let n=await W(i,{query:e});t+=G(n)}return{content:[{type:`text`,text:t}],structuredContent:{matches:[],totalMatches:0,pattern:e??a??o??``,truncated:!1}}}let h=[`Found ${p.totalFound} results via ${p.strategies.join(` + `)}${m}`,``,...p.results.map(e=>{let t=e.lineRange?`:${e.lineRange.start}-${e.lineRange.end}`:``,n=e.preview?`\n ${e.preview.slice(0,100)}...`:``;return`- [${e.source}] ${e.path}${t} (${(e.score*100).toFixed(0)}%)${n}`})].join(`
|
|
150
|
-
`);if(f&&i){let t=await W(i,{query:e,filePath:p.results[0]?.path});h+=G(t)}return{content:[{type:`text`,text:u?L(h,u):h}],structuredContent:{matches:p.results.map(e=>({path:e.path,...e.lineRange?{line:e.lineRange.start}:{},matchType:e.source,preview:e.preview?.slice(0,200)??``})),totalMatches:p.totalFound,pattern:e??a??o??``,truncated:p.results.length<p.totalFound}}}catch(e){return
|
|
151
|
-
`);if(c&&i){let t=await W(i,{query:`trace ${e}`});d+=G(t)}return{content:[{type:`text`,text:s?L(d,s):d}],structuredContent:{start:l.start,direction:l.direction,depth:l.depth,nodes:l.nodes,graphContext:l.graphContext??null}}}catch(e){return
|
|
152
|
-
`);if(c&&a){let t=await W(a,{query:`dead symbols ${e??l??``}`});f+=G(t)}return{content:[{type:`text`,text:s?L(f,s):f}],structuredContent:{symbols:[...u.deadInSource,...u.deadInDocs].map(e=>({name:e.name,path:e.path,...e.line===void 0?{}:{line:e.line},kind:e.kind})),totalDead:u.totalDeadSource+u.totalDeadDocs}}}catch(e){return
|
|
153
|
-
`)}function
|
|
154
|
-
`)}function
|
|
150
|
+
`);if(f&&i){let t=await W(i,{query:e,filePath:p.results[0]?.path});h+=G(t)}return{content:[{type:`text`,text:u?L(h,u):h}],structuredContent:{matches:p.results.map(e=>({path:e.path,...e.lineRange?{line:e.lineRange.start}:{},matchType:e.source,preview:e.preview?.slice(0,200)??``})),totalMatches:p.totalFound,pattern:e??a??o??``,truncated:p.results.length<p.totalFound}}}catch(e){return _l(`Find`,e)}}))}function Sl(e,t,n,r,i){let a=U(`symbol`);e.registerTool(`symbol`,{title:a.title,description:`Find definition, imports, and references of a named symbol (function, class, type). For tracing data flow across call sites use trace instead.`,inputSchema:{name:R.string().describe(`Symbol name to look up (function, class, type, etc.)`),limit:R.number().min(1).max(50).default(20).describe(`Max results per category`),workspaces:R.array(R.string()).optional().describe(`Cross-workspace search: partition names or folder basenames to include. Use ["*"] for all. User-level mode only.`),max_tokens:R.number().min(100).max(5e4).optional().describe(`Maximum token budget for the response. When set, output is truncated to fit.`),enrich:R.boolean().default(!1).optional().describe(`Append curated knowledge and graph context to output. Adds ~150-250 tokens.`)},outputSchema:Ds,annotations:a.annotations},q(`symbol`,async({name:e,limit:a,workspaces:o,max_tokens:s,enrich:c})=>{try{let l=await xn(t,n,{name:e,limit:a,graphStore:r});if(o&&o.length>0){let n=cl(o,je(process.cwd()));if(n.length>0){let{stores:r,closeAll:i}=await ll(n);try{for(let[n,i]of r){let r=await xn(t,i,{name:e,limit:a});r.definedIn&&!l.definedIn&&(l.definedIn={...r.definedIn,path:`[${n}] ${r.definedIn.path}`});for(let e of r.referencedIn)l.referencedIn.push({...e,path:`[${n}] ${e.path}`});if(r.importedBy){l.importedBy=l.importedBy??[];for(let e of r.importedBy)l.importedBy.push({...e,path:`[${n}] ${e.path}`})}}}finally{await i()}}}let u={name:l.name,definedIn:l.definedIn??null,importedBy:l.importedBy??[],referencedIn:l.referencedIn??[],graphContext:l.graphContext??null},d=El(l);if(c&&i){let t=await W(i,{query:`symbol ${e}`});d+=G(t)}return{content:[{type:`text`,text:s?L(d,s):d}],structuredContent:u}}catch(e){return _l(`Symbol lookup`,e)}}))}function Cl(e,t,n,r,i,a){let o=new $n,s=U(`file_summary`);e.registerTool(`file_summary`,{title:s.title,description:`Create a concise structural summary of a source file: imports, exports, functions, classes, interfaces, and types.`,outputSchema:Hs,inputSchema:{path:R.string().describe(`Absolute path to the file to summarize`),max_tokens:R.number().min(100).max(5e4).optional().describe(`Maximum token budget for the response.`),enrich:R.boolean().default(!1).describe(`Append curated knowledge and graph context to output. Adds ~150-250 tokens. Default false — set true when you need stored decisions, conventions, or relationship context for the file/query.`)},annotations:s.annotations},q(`file_summary`,async({path:e,max_tokens:s,enrich:c})=>{try{let l=ml(e,n,r);if((await Pn(l)).isDirectory()){let t=await o.analyze(l,{format:`markdown`,maxDepth:3,maxTokens:s});vl(l,n,r,a);let u=t.data.stats?.languages??{},d=Object.entries(u).sort((e,t)=>t[1]-e[1])[0]?.[0],f=`📁 **Directory**: \`${e}\`\n\n${t.output}\n\n---\n_Path is a directory. Showing structure analysis. Use \`analyze({ aspect: "structure", ... })\` for deeper analysis with custom depth._`;if(c&&i){let t=await W(i,{query:e,filePath:l});f+=G(t)}return{content:[{type:`text`,text:s?L(f,s):f}],structuredContent:{path:l,language:d??`directory`,lines:0,imports:0,exports:0,functions:0,classes:0}}}let u=await ft({path:l,content:(await t.get(l)).content,maxTokens:s});vl(l,n,r,a);let d=Dl(u);if(c&&i){let t=await W(i,{query:e,filePath:l});d+=G(t)}return{content:[{type:`text`,text:d}],structuredContent:{path:u.path,language:u.language,lines:u.lines,imports:u.importCount??u.imports?.length??0,exports:u.exports?.length??0,functions:u.functions?.length??0,classes:u.classes?.length??0}}}catch(e){return _l(`File summary`,e)}}))}function wl(e,t,n,r,i){let a=U(`trace`);e.registerTool(`trace`,{title:a.title,description:`Follow data flow forward/backward across imports and call sites from a starting symbol or file:line. For finding a single symbol definition use symbol instead.`,inputSchema:{start:R.string().describe(`Starting point — symbol name or file:line reference`),direction:R.enum([`forward`,`backward`,`both`]).describe(`Which direction to trace relationships`),max_depth:R.number().min(1).max(10).default(3).optional().describe(`Maximum trace depth`),max_tokens:R.number().min(100).max(5e4).optional().describe(`Maximum token budget for the response. When set, output is truncated to fit.`),enrich:R.boolean().default(!1).optional().describe(`Append curated knowledge and graph context to output. Adds ~150-250 tokens.`)},annotations:a.annotations},q(`trace`,async({start:e,direction:a,max_depth:o,max_tokens:s,enrich:c})=>{try{let l=await wn(t,n,{start:e,direction:a,maxDepth:o,graphStore:r}),u=[`## Trace: ${l.start}`,`Direction: ${l.direction} | Depth: ${l.depth}`,``];if(l.graphContext&&(u.push(`### Graph Context`),l.graphContext.definingModule&&u.push(`- Module: ${l.graphContext.definingModule}`),l.graphContext.community&&u.push(`- Community: ${l.graphContext.community}`),l.graphContext.importedByModules.length>0&&u.push(`- Imported by modules: ${l.graphContext.importedByModules.join(`, `)}`),l.graphContext.siblingSymbols.length>0&&u.push(`- Sibling symbols: ${l.graphContext.siblingSymbols.join(`, `)}`),u.push(``)),l.nodes.length===0)u.push(`No connections found.`);else{let e=l.nodes.filter(e=>e.relationship===`calls`),t=l.nodes.filter(e=>e.relationship===`called-by`),n=l.nodes.filter(e=>e.relationship===`imports`),r=l.nodes.filter(e=>e.relationship===`imported-by`),i=l.nodes.filter(e=>e.relationship===`references`);if(e.length>0){u.push(`### Calls (${e.length})`);for(let t of e){let e=t.scope?` (from ${t.scope}())`:``;u.push(`- ${t.symbol}() — ${t.path}:${t.line}${e}`)}u.push(``)}if(t.length>0){u.push(`### Called by (${t.length})`);for(let e of t){let t=e.scope?` in ${e.scope}()`:``;u.push(`- ${e.symbol}()${t} — ${e.path}:${e.line}`)}u.push(``)}if(n.length>0){u.push(`### Imports (${n.length})`);for(let e of n)u.push(`- ${e.symbol} — ${e.path}:${e.line}`);u.push(``)}if(r.length>0){u.push(`### Imported by (${r.length})`);for(let e of r)u.push(`- ${e.path}:${e.line}`);u.push(``)}if(i.length>0){u.push(`### References (${i.length})`);for(let e of i)u.push(`- ${e.path}:${e.line}`);u.push(``)}}u.push(`---`,"_Next: `symbol` for definition details | `compact` to read a referenced file | `blast_radius` for impact analysis_");let d=u.join(`
|
|
151
|
+
`);if(c&&i){let t=await W(i,{query:`trace ${e}`});d+=G(t)}return{content:[{type:`text`,text:s?L(d,s):d}],structuredContent:{start:l.start,direction:l.direction,depth:l.depth,nodes:l.nodes,graphContext:l.graphContext??null}}}catch(e){return _l(`Trace`,e)}}))}function Tl(e,t,n,r,i,a){let o=U(`dead_symbols`);e.registerTool(`dead_symbols`,{title:o.title,description:`Find exported symbols that appear to be unused because they are never imported or re-exported.`,outputSchema:Vs,inputSchema:{path:R.string().optional().describe(`Root path to scope the search (default: cwd)`),limit:R.number().min(1).max(500).default(100).optional().describe(`Maximum exported symbols to scan`),max_tokens:R.number().min(100).max(5e4).optional().describe(`Maximum token budget for the response. When set, output is truncated to fit.`),enrich:R.boolean().default(!1).describe(`Append curated knowledge and graph context to output. Adds ~150-250 tokens. Default false — set true when you need stored decisions, conventions, or relationship context for the file/query.`)},annotations:o.annotations},q(`dead_symbols`,async({path:e,limit:o,max_tokens:s,enrich:c})=>{try{let l=e&&r?ml(e,r,i):e,u=await mt(t,n,{rootPath:l,limit:o}),d=[`## Dead Symbol Analysis`,``,`**Exports scanned:** ${u.totalExports}`,`**Dead in source:** ${u.totalDeadSource} (actionable)`,`**Dead in docs:** ${u.totalDeadDocs} (informational — code samples in .md files)`,``];if(u.deadInSource.length>0){d.push(`### Dead in Source (actionable)`);for(let e of u.deadInSource)d.push(`- \`${e.name}\` (${e.kind}) — ${e.path}:${e.line}`);d.push(``)}if(u.deadInDocs.length>0){d.push(`### Dead in Docs (informational)`),d.push(`_${u.totalDeadDocs} symbol(s) found only in documentation code samples — not actionable dead code._`);for(let e of u.deadInDocs.slice(0,5))d.push(`- \`${e.name}\` — ${e.path}:${e.line}`);u.deadInDocs.length>5&&d.push(`- _... ${u.deadInDocs.length-5} more omitted_`)}u.totalDeadSource>0?d.push(``,`---`,`_Next: \`codemod\` to remove ${u.totalDeadSource} unused exports | \`symbol\` to verify usage before removing_`):d.push(``,`---`,"_Next: `check` — no dead symbols found, validate types and lint_");let f=d.join(`
|
|
152
|
+
`);if(c&&a){let t=await W(a,{query:`dead symbols ${e??l??``}`});f+=G(t)}return{content:[{type:`text`,text:s?L(f,s):f}],structuredContent:{symbols:[...u.deadInSource,...u.deadInDocs].map(e=>({name:e.name,path:e.path,...e.line===void 0?{}:{line:e.line},kind:e.kind})),totalDead:u.totalDeadSource+u.totalDeadDocs}}}catch(e){return _l(`Dead symbol scan`,e)}}))}function El(e){let t=[`Symbol: ${e.name}`];if(e.definedIn){let n=`Defined in: ${e.definedIn.path}:${e.definedIn.line} (${e.definedIn.kind})`;e.definedIn.signature&&(n+=`\nSignature: ${e.definedIn.signature}`),t.push(n)}else t.push(`Defined in: not found`);if(t.push(``,`Imported by:`),e.importedBy.length===0)t.push(` none`);else for(let n of e.importedBy)t.push(` - ${n.path}:${n.line} ${n.importStatement}`);if(t.push(``,`Referenced in:`),e.referencedIn.length===0)t.push(` none`);else for(let n of e.referencedIn){let e=`scope`in n&&n.scope?` in ${n.scope}()`:``;t.push(` - ${n.path}:${n.line}${e} ${n.context}`)}if(e.graphContext){let n=e.graphContext;t.push(``,`Graph context:`),n.definingModule&&t.push(` Module: ${n.definingModule}`),n.importedByModules.length>0&&t.push(` Imported by modules: ${n.importedByModules.join(`, `)}`),n.siblingSymbols.length>0&&t.push(` Sibling symbols: ${n.siblingSymbols.join(`, `)}`)}return t.join(`
|
|
153
|
+
`)}function Dl(e){let t=[e.path,`Language: ${e.language}`,`Lines: ${e.lines}`,`Estimated tokens: ~${e.estimatedTokens}`,``,`Imports (${e.importCount??e.imports.length}):`,...Ol(e.imports),``,`Exports (${e.exports.length}):`,...Ol(e.exports),``,`Functions (${e.functions.length}):`,...Ol(e.functions.map(e=>`${e.name} @ line ${e.line}${e.exported?` [exported]`:``}${`signature`in e&&e.signature?` — ${e.signature}`:``}`)),``,`Classes (${e.classes.length}):`,...Ol(e.classes.map(e=>`${e.name} @ line ${e.line}${e.exported?` [exported]`:``}${e.signature?` — ${e.signature}`:``}`)),``,`Interfaces (${e.interfaces.length}):`,...Ol(e.interfaces.map(e=>`${e.name} @ line ${e.line}${`exported`in e&&e.exported?` [exported]`:``}`)),``,`Types (${e.types.length}):`,...Ol(e.types.map(e=>`${e.name} @ line ${e.line}${`exported`in e&&e.exported?` [exported]`:``}`))];if(`importDetails`in e&&e.importDetails&&e.importDetails.length>0){let n=e.importDetails.filter(e=>e.isExternal).length,r=e.importDetails.length-n;t.push(``,`Import breakdown: ${n} external, ${r} internal`)}if(`callEdges`in e&&e.callEdges&&e.callEdges.length>0){t.push(``,`Call edges (${e.callEdgeCount??e.callEdges.length} intra-file):`);for(let n of e.callEdges.slice(0,30))t.push(` - ${n.caller}() → ${n.callee}() @ line ${n.line}`);e.callEdges.length>30&&t.push(` - ... ${e.callEdges.length-30} more`)}return t.join(`
|
|
154
|
+
`)}function Ol(e){return e.length===0?[` none`]:e.map(e=>` - ${e}`)}const kl=F(`tools`);function Al(e,t){let n=U(`er_evolve_review`);e.registerTool(`er_evolve_review`,{title:n.title,description:`Review evolution metrics for the AI Kit ↔ ER bridge. Shows local miss rates, push acceptance, rule effectiveness, and top missed queries. Use this to reason about improving classification rules and knowledge flow.`,inputSchema:{include_details:R.boolean().default(!0).describe(`Include detailed breakdowns (top missed queries, rule stats)`),reset_after:R.boolean().default(!1).describe(`Reset collected metrics after review`)},annotations:n.annotations},async({include_details:e,reset_after:n})=>{try{let r=t.getMetrics(),i=[`## ER Evolution Review
|
|
155
155
|
`,`**Period**: ${r.period.startedAt} → ${r.period.queriedAt}`,`**Total events**: ${r.period.totalEvents}\n`,`### Search`,`- Total searches: ${r.search.totalSearches}`,`- ER fallback triggered: ${r.search.erFallbackCount} (${(r.search.erFallbackRate*100).toFixed(1)}%)`,`- ER cache hits: ${r.search.erCacheHitCount} (${(r.search.erCacheHitRate*100).toFixed(1)}% of fallbacks)`];if(e&&r.search.topMissedQueries.length>0){i.push(`
|
|
156
|
-
**Top missed queries** (triggered ER fallback):`);for(let e of r.search.topMissedQueries.slice(0,10)){let t=e.query.length>60?`${e.query.slice(0,57)}...`:e.query;i.push(` - "${t}" (${e.count}x)`)}}if(i.push(``,`### Push`,`- Total pushes: ${r.push.totalPushes} (${r.push.successCount} ok, ${r.push.failCount} failed)`,`- Classification match rate: ${(r.push.classificationMatchRate*100).toFixed(1)}%`,`- Push acceptance rate: ${(r.push.pushAcceptanceRate*100).toFixed(1)}%`),i.push(``,`### Rule Effectiveness`),Object.keys(r.rules.matchCounts).length>0)for(let[e,t]of Object.entries(r.rules.matchCounts)){let n=r.rules.pushCounts[e]??0,a=t>0?(n/t*100).toFixed(0):`0`;i.push(`- **${e}**: ${t} matches → ${n} pushes (${a}% conversion)`)}else i.push(`- _No rule activity recorded yet_`);if(e&&r.rules.lowConversionRules.length>0){i.push(``,`### ⚠️ Low Conversion Rules (potential false positives)`);for(let e of r.rules.lowConversionRules)i.push(`- **${e.ruleId}**: ${e.matchCount} matches, ${e.pushCount} pushes (${(e.conversionRate*100).toFixed(0)}% conversion) — consider tightening patterns`)}return i.push(``,`---`,"_Next: Use `er_update_policy` to refine rules based on these metrics, or `er_push` to share high-value knowledge._"),n&&(
|
|
156
|
+
**Top missed queries** (triggered ER fallback):`);for(let e of r.search.topMissedQueries.slice(0,10)){let t=e.query.length>60?`${e.query.slice(0,57)}...`:e.query;i.push(` - "${t}" (${e.count}x)`)}}if(i.push(``,`### Push`,`- Total pushes: ${r.push.totalPushes} (${r.push.successCount} ok, ${r.push.failCount} failed)`,`- Classification match rate: ${(r.push.classificationMatchRate*100).toFixed(1)}%`,`- Push acceptance rate: ${(r.push.pushAcceptanceRate*100).toFixed(1)}%`),i.push(``,`### Rule Effectiveness`),Object.keys(r.rules.matchCounts).length>0)for(let[e,t]of Object.entries(r.rules.matchCounts)){let n=r.rules.pushCounts[e]??0,a=t>0?(n/t*100).toFixed(0):`0`;i.push(`- **${e}**: ${t} matches → ${n} pushes (${a}% conversion)`)}else i.push(`- _No rule activity recorded yet_`);if(e&&r.rules.lowConversionRules.length>0){i.push(``,`### ⚠️ Low Conversion Rules (potential false positives)`);for(let e of r.rules.lowConversionRules)i.push(`- **${e.ruleId}**: ${e.matchCount} matches, ${e.pushCount} pushes (${(e.conversionRate*100).toFixed(0)}% conversion) — consider tightening patterns`)}return i.push(``,`---`,"_Next: Use `er_update_policy` to refine rules based on these metrics, or `er_push` to share high-value knowledge._"),n&&(kl.info(`Evolution metrics reset requested`,{requestedAt:new Date().toISOString(),clearedEvents:r.period.totalEvents}),t.reset(),i.push(`
|
|
157
157
|
_Metrics have been reset._`)),{content:[{type:`text`,text:i.join(`
|
|
158
|
-
`)}]}}catch(e){return
|
|
159
|
-
`);if(s&&t){let e=await W(t,{query:`known issues failures`});i+=G(e)}return{content:[{type:`text`,text:i}],structuredContent:{...e}}}let f=JSON.stringify(u);if(s&&t){let e=await W(t,{query:`known issues failures`});f+=G(e)}return{content:[{type:`text`,text:f}]}}catch(e){return
|
|
160
|
-
`).replace(/\\t/g,` `),t);return{content:[{type:`text`,text:JSON.stringify(n)}]}}catch(e){return
|
|
161
|
-
`)}const
|
|
162
|
-
`);if(e&&typeof e==`object`&&`type`in e){let t=e;if(t.type===`text`&&typeof t.text==`string`)return t.text}return JSON.stringify(e)}function
|
|
163
|
-
`);return{content:n,tokens:Math.ceil(n.length/4)}}};function
|
|
164
|
-
`),i=Math.ceil(n.length/4);return{content:`**Recalled Knowledge:**\n${n}`,tokens:Math.min(i,200)}}catch{return null}}}}const
|
|
158
|
+
`)}]}}catch(e){return kl.error(`Evolution review failed`,I(e)),K(`INTERNAL`,`Evolution review failed: unable to compute metrics`)}})}const jl=F(`tools:execution`);function Ml(e,t,n){let r=U(`check`);e.registerTool(`check`,{title:r.title,description:`Run incremental typecheck (tsc) and lint (biome) on the project or specific files. Returns structured error and warning lists. Default detail level is "efficient" (~300 tokens).`,inputSchema:{files:R.array(R.string()).optional().describe(`Specific files to check (if omitted, checks all)`),cwd:R.string().optional().describe(`Working directory`),skip_types:R.boolean().default(!1).describe(`Skip TypeScript typecheck`),skip_lint:R.boolean().default(!1).describe(`Skip Biome lint`),detail:R.enum(ke).optional().describe(`Output detail level: efficient (default, ~300 tokens — pass/fail + counts + top errors), normal (parsed error objects), full (includes raw terminal output)`),enrich:R.boolean().default(!1).describe(`Append curated knowledge and graph context to output. Adds ~150-250 tokens. Default false — set true when you need stored decisions, conventions, or relationship context.`)},outputSchema:Es,annotations:r.annotations},q(`check`,async({files:e,cwd:r,skip_types:i,skip_lint:a,detail:o,enrich:s},c)=>{try{let l=o??n??`efficient`,u=await He({files:e,cwd:r,skipTypes:i,skipLint:a,detail:l===`efficient`?`normal`:l}),d=kc(c).createTask(`Check`,2);if(d.progress(0,`tsc: ${u.tsc.errors.length} errors`),d.progress(1,`biome: ${u.biome.errors.length} errors`),d.complete(`Check ${u.passed?`passed`:`failed`}`),l===`efficient`){let e=bn(u),n=[];if(u.passed)n.push({tool:`test_run`,reason:`Types and lint clean — run tests next`});else{let t=u.tsc.errors[0]?.file??u.biome.errors[0]?.file,r=e.tsc.topErrors[0]??e.biome.topErrors[0]??`reported errors`;t&&n.push({tool:`compact`,reason:`Inspect failing code with compact({ path: ${JSON.stringify(t)}, query: ${JSON.stringify(r)} })`,suggested_args:{path:t,query:r}}),n.push({tool:`check`,reason:`Re-check after fixing errors`,suggested_args:{detail:`normal`}})}let r=[`## Check ${e.passed?`✅ PASS`:`❌ FAIL`}`,``,`**tsc**: ${e.tsc.passed?`✅`:`❌`} ${e.tsc.errorCount} errors, ${e.tsc.warningCount} warnings`];if(e.tsc.topErrors.length>0)for(let t of e.tsc.topErrors)r.push(` - ${t}`);if(r.push(`**biome**: ${e.biome.passed?`✅`:`❌`} ${e.biome.errorCount} errors, ${e.biome.warningCount} warnings`),e.biome.topErrors.length>0)for(let t of e.biome.topErrors)r.push(` - ${t}`);if(n.length>0){r.push(``,`**Next steps:**`);for(let e of n)r.push(`- \`${e.tool}\`: ${e.reason}`)}let i=r.join(`
|
|
159
|
+
`);if(s&&t){let e=await W(t,{query:`known issues failures`});i+=G(e)}return{content:[{type:`text`,text:i}],structuredContent:{...e}}}let f=JSON.stringify(u);if(s&&t){let e=await W(t,{query:`known issues failures`});f+=G(e)}return{content:[{type:`text`,text:f}]}}catch(e){return jl.error(`Check failed`,I(e)),K(`INTERNAL`,`Check failed: ${e instanceof Error?e.message:String(e)}`)}}))}function Nl(e){let t=U(`eval`);e.registerTool(`eval`,{title:t.title,description:`Execute a JavaScript or TypeScript snippet in a constrained VM sandbox with a timeout. Captures console output and returned values.`,inputSchema:{code:R.string().max(1e5).describe(`Code snippet to execute`),lang:R.enum([`js`,`ts`]).default(`js`).optional().describe(`Language mode: js executes directly, ts strips common type syntax first`),timeout:R.number().min(1).max(6e4).default(5e3).optional().describe(`Execution timeout in milliseconds`)},annotations:t.annotations},q(`eval`,async({code:e,lang:t,timeout:n})=>{try{let r=ut({code:e,lang:t,timeout:n});return r.success?{content:[{type:`text`,text:`Eval succeeded in ${r.durationMs}ms\n\n${r.output}`}]}:K(`INTERNAL`,`Eval failed in ${r.durationMs}ms: ${r.error??`Unknown error`}`)}catch(e){return jl.error(`Eval failed`,I(e)),K(`INTERNAL`,`Eval failed: ${e instanceof Error?e.message:String(e)}`)}}))}function Pl(e,t){let n=U(`test_run`);e.registerTool(`test_run`,{title:n.title,description:`Run Vitest for the current project or a subset of files, then return a structured summary of passing and failing tests.`,inputSchema:{files:R.array(R.string()).optional().describe(`Specific test files or patterns to run`),grep:R.string().optional().describe(`Only run tests whose names match this pattern`),cwd:R.string().optional().describe(`Working directory for the test run`),enrich:R.boolean().default(!1).describe(`Append curated knowledge and graph context to output. Adds ~150-250 tokens. Default false — set true when you need stored decisions, conventions, or relationship context.`)},annotations:n.annotations,outputSchema:Gs},q(`test_run`,async({files:e,grep:n,cwd:r,enrich:i},a)=>{try{let o=await Sn({files:e,grep:n,cwd:r}),s=kc(a).createTask(`Test Run`,1),c=o.summary.passed+o.summary.failed+o.summary.skipped;s.complete(`Tests: ${o.passed?`passed`:`failed`} (${c} tests)`);let l=Ll(o);if(i&&t){let e=await W(t,{query:`test patterns known failures`});l+=G(e)}return{content:[{type:`text`,text:l}],structuredContent:{passed:o.passed,totalTests:c,passedTests:o.summary.passed,failedTests:o.summary.failed,skippedTests:o.summary.skipped,duration:o.summary.duration??0,failures:o.summary.tests.filter(e=>e.status===`fail`).map(e=>({name:e.name,message:e.error??``,...e.file?{file:e.file}:{}}))},isError:!o.passed}}catch(e){return jl.error(`Test run failed`,I(e)),K(`INTERNAL`,`Test run failed: ${e instanceof Error?e.message:String(e)}`)}}))}function Fl(e){let t=U(`parse_output`);e.registerTool(`parse_output`,{title:t.title,description:`Parse structured data from build tool output. Supports tsc, vitest, biome, and git status. Auto-detects the tool or specify explicitly.`,inputSchema:{output:R.string().max(5e5).describe(`Raw output text from a build tool`),tool:R.enum([`tsc`,`vitest`,`biome`,`git-status`]).optional().describe(`Tool to parse as (auto-detects if omitted)`)},annotations:t.annotations},async({output:e,tool:t})=>{try{let n=It(e.replace(/\\n/g,`
|
|
160
|
+
`).replace(/\\t/g,` `),t);return{content:[{type:`text`,text:JSON.stringify(n)}]}}catch(e){return jl.error(`Parse failed`,I(e)),K(`INTERNAL`,`Parse failed: ${e instanceof Error?e.message:String(e)}`)}})}function Il(e,t){let n=U(`delegate`);e.registerTool(`delegate`,{title:n.title,description:`Delegate a subtask to a local Ollama model. Use for summarization, classification, naming, or any task that can offload work from the host agent. Fails fast if Ollama is not running.`,inputSchema:{prompt:R.string().max(2e5).describe(`The task or question to send to the local model`),model:R.string().optional().describe(`Ollama model name (default: first available model)`),system:R.string().optional().describe(`System prompt for the model`),context:R.string().max(5e5).optional().describe(`Context text to include before the prompt (e.g. file contents)`),temperature:R.number().min(0).max(2).default(.3).optional().describe(`Sampling temperature (0=deterministic, default 0.3)`),timeout:R.number().min(1e3).max(6e5).default(12e4).optional().describe(`Timeout in milliseconds (default 120000)`),action:R.enum([`generate`,`list_models`]).default(`generate`).optional().describe(`Action: generate a response or list available models`)},annotations:n.annotations},async({prompt:e,model:n,system:r,context:i,temperature:a,timeout:o,action:s})=>{try{if(s===`list_models`){let e=await rt();return{content:[{type:`text`,text:JSON.stringify({models:e,count:e.length,_Next:`Use delegate with a model name`},null,2)}]}}if(t?.available)try{let n=await t.createMessage({prompt:e,systemPrompt:r,context:i,maxTokens:4e3,modelPreferences:{intelligencePriority:.8,speedPriority:.5,costPriority:.3}});return{content:[{type:`text`,text:JSON.stringify({model:n.model??`sampling`,response:n.text,provider:`mcp-sampling`,_Next:`Use the response in your workflow. stash to save it.`},null,2)}]}}catch{jl.debug(`Sampling failed, falling back to Ollama`)}let c=await nt({prompt:e,model:n,system:r,context:i,temperature:a,timeout:o});return c.error?K(`INTERNAL`,JSON.stringify({error:c.error,model:c.model,durationMs:c.durationMs},null,2)):{content:[{type:`text`,text:JSON.stringify({model:c.model,response:c.response,durationMs:c.durationMs,tokenCount:c.tokenCount,_Next:`Use the response in your workflow. stash to save it.`},null,2)}]}}catch(e){return jl.error(`Delegate failed`,I(e)),K(`INTERNAL`,`Delegate failed: ${e instanceof Error?e.message:String(e)}`)}})}function Ll(e){let t=[`Vitest run: ${e.passed?`passed`:`failed`}`,`Duration: ${e.durationMs}ms`,`Passed: ${e.summary.passed}`,`Failed: ${e.summary.failed}`,`Skipped: ${e.summary.skipped}`];e.summary.suites!==void 0&&t.push(`Suites: ${e.summary.suites}`);let n=e.summary.tests.filter(e=>e.status===`fail`);if(n.length>0){t.push(``,`Failed tests:`);for(let e of n)t.push(`- ${e.name}${e.file?` (${e.file})`:``}`),e.error&&t.push(` ${e.error}`)}return t.join(`
|
|
161
|
+
`)}const Rl=F(`sampling`);function zl(e){if(!e.modelPreferences)return;let t={...e.modelPreferences.costPriority===void 0?{}:{costPriority:e.modelPreferences.costPriority},...e.modelPreferences.speedPriority===void 0?{}:{speedPriority:e.modelPreferences.speedPriority},...e.modelPreferences.intelligencePriority===void 0?{}:{intelligencePriority:e.modelPreferences.intelligencePriority}};return Object.keys(t).length>0?t:void 0}function Bl(e){if(Array.isArray(e))return e.map(e=>Bl(e)).filter(e=>e.length>0).join(`
|
|
162
|
+
`);if(e&&typeof e==`object`&&`type`in e){let t=e;if(t.type===`text`&&typeof t.text==`string`)return t.text}return JSON.stringify(e)}function Vl(e){let t=e.server,n=typeof t?.createMessage==`function`;return{get available(){return n},async createMessage(e){if(!n)throw Error(`Sampling not available: client does not support createMessage`);let r=e.context?`${e.context}\n\n---\n\n${e.prompt}`:e.prompt;try{let n=await t.createMessage({messages:[{role:`user`,content:{type:`text`,text:r}}],systemPrompt:e.systemPrompt,modelPreferences:zl(e),maxTokens:e.maxTokens??4e3});return{text:Bl(n.content),model:n.model,stopReason:n.stopReason}}catch(e){throw Rl.warn(`Sampling createMessage failed`,{error:String(e)}),e}}}}const Hl=[],Ul=[`_docs-sync`],Wl=new Map([[`_docs-sync`,`Synchronize project documentation — update docs/ folder based on changes made during the flow.`]]);function Gl(e){function t(t,n,r){let i=n?.installPath?ge(n.installPath):t.replaceAll(`:`,`-`),a=P(Ln(),`.copilot`,`flows`,i).replaceAll(`\\`,`/`);if(A(a))return a;let o=P(Ln(),`.claude`,`flows`,i).replaceAll(`\\`,`/`);if(A(o))return o;let s=P(r??e(),`.github`,`flows`,i).replaceAll(`\\`,`/`);return A(s)?s:n?.installPath&&A(n.installPath)?n.installPath.replaceAll(`\\`,`/`):null}function n(e,n,r){let i=t(e.name,e,r);return i?P(i,n).replaceAll(`\\`,`/`):n}function r(t,n){let r=t.replace(/^_/,``),i=n??e(),a=[N(i,`.github`,`flows`,`_epilogue`,`steps`,r,`README.md`),N(i,`.github`,`flows`,`_epilogue`,r,`README.md`)];for(let e of a)if(A(e))return e.replaceAll(`\\`,`/`);return null}function i(e){return[...Hl,...e.manifest.steps.map(e=>e.id),...Ul]}function a(e,t,r){let i=t?e.manifest.steps.find(e=>e.id===t)??null:null,a=t?Wl.get(t)??null:null;return{currentStep:i,epilogueStep:a?{id:t,description:a}:null,instructionPath:i&&t?n(e,i.instruction,r):null,description:i?.description??a}}function o(){try{let e=N(br(`npm root -g`,{encoding:`utf-8`}).trim(),`@fission-ai`,`openspec`);if(A(e))return{path:e,sourceType:`npm-global`,isGit:!1}}catch{}return{path:`https://github.com/Fission-AI/OpenSpec.git`,sourceType:`git`,isGit:!0}}function s(e){let t=P(e);if(A(N(t,`.claude-plugin`,`plugin.json`)))return{path:t,sourceType:`claude-plugin`};let n=Ln(),r=N(n,`.claude`,`plugins`,e);if(A(N(r,`.claude-plugin`,`plugin.json`)))return{path:r,sourceType:`claude-plugin`};let i=N(n,`.claude`,`plugins`);if(!A(i))return null;for(let t of ue(i,{withFileTypes:!0})){if(!t.isDirectory())continue;let n=N(i,t.name,`.claude-plugin`,`plugin.json`);if(A(n))try{if(JSON.parse(M(n,`utf-8`)).name===e)return{path:N(i,t.name),sourceType:`claude-plugin`}}catch{}}return null}return{resolveInstallPath:t,resolveInstructionPath:n,resolveEpilogueInstructionPath:r,getStepSequence:i,resolveCurrentStepInfo:a,resolveOpenSpecSource:o,resolveClaudePluginSource:s}}function Kl(e){function t(){return e.sources?.[0]?.path??process.cwd()}function n(){return e.allRoots?.length?e.allRoots:[t()]}function r(e){return e.map(e=>e.replaceAll(`\\`,`/`))}function i(e){let t=[];try{let n=ue(e,{withFileTypes:!0});for(let r of n){if(!r.isDirectory()||r.name.startsWith(`.`))continue;let n=N(e,r.name);A(N(n,`.git`))&&t.push(n)}}catch{}return t}function a(){let e=n(),t=new Set(e);for(let n of e)for(let e of i(n))t.add(e);return[...t]}function o(e){let t=e.replaceAll(`\\`,`/`);if(r(a()).includes(t))return!0;let i=r(n());for(let n of i)if(t.startsWith(`${n}/`)&&A(N(e,`.git`)))return!0;return!1}function s(e){return N(e??t(),`.flows`)}async function c(){let e=a();for(let t of e){let e=s(t);if(A(e))for(let n of ue(e,{withFileTypes:!0})){if(!n.isDirectory())continue;let r=N(e,n.name,`meta.json`);if(A(r))try{let e=JSON.parse(M(r,`utf-8`));if(e.status===`active`)return e.primaryRoot?e.primaryRoot:t}catch{}}}return null}async function l(e){return e||(await c()??t())}function u(){let e=t(),i=r(n()),o=a(),s=r(o),c=s.filter(e=>!i.includes(e));return{workspaceRoot:e,allRoots:o,normalizedAllRoots:s,discoveredRepos:c.length>0?c:void 0}}function d(e,t,n){let r=N(s(t),e,`meta.json`),i=M(r,`utf-8`),a=JSON.parse(i);a.roots=n.map(e=>e.replaceAll(`\\`,`/`)),a.primaryRoot=t.replaceAll(`\\`,`/`);let o=`${r}.tmp`;he(o,JSON.stringify(a,null,2),`utf-8`),de(o,r)}function f(e,t){let n=N(s(t),e,`meta.json`);if(!A(n))return;let r=M(n,`utf-8`),i=JSON.parse(r),a=i.roots;if(!a||a.length<=1)return;let o=t.replaceAll(`\\`,`/`);for(let t of a){if(t===o)continue;let n=N(t,`.flows`,e);j(n,{recursive:!0});let a=N(n,`meta.json`),s=`${a}.tmp`;he(s,r,`utf-8`),de(s,a),j(N(n,i.artifactsDir??`.spec`),{recursive:!0})}}return{getWorkspaceRoot:t,getAllRoots:a,getFlowsDir:s,isValidFlowRoot:o,resolveFlowRoot:l,resolveRoots:u,patchMetaRoots:d,syncMetaToRoots:f}}const ql={name:`flow-context`,order:40,maxTokens:120,runInBrief:!1,async execute(e){let t=["**Flow Context:** Call `knowledge({ action: 'withdraw', scope: 'flow', profile: 'implementer', budget: 4000 })` as FIRST action for prior context.","Remember decisions: `knowledge({ action: 'remember', title: '...', content: '...', category: 'flow-context', scope: 'flow' })`"];e.completedSteps.length>0&&t.push(`Completed steps: ${e.completedSteps.join(`, `)}`);let n=t.join(`
|
|
163
|
+
`);return{content:n,tokens:Math.ceil(n.length/4)}}};function Jl(e){return{name:`knowledge-recall`,order:20,maxTokens:200,runInBrief:!1,async execute(t){if(!e.store)return null;let n=[t.stepDescription,t.topic].filter(e=>typeof e==`string`&&e.trim().length>0);if(n.length===0)return null;let r=[...n,t.flowName].filter(Boolean).join(` `);if(!r.trim())return null;try{let t=await e.store.search(r,{limit:3});if(!t||t.length===0)return null;let n=t.map(e=>`• ${e.content.slice(0,200)}`).join(`
|
|
164
|
+
`),i=Math.ceil(n.length/4);return{content:`**Recalled Knowledge:**\n${n}`,tokens:Math.min(i,200)}}catch{return null}}}}const Yl=[`**Read Code:** Structure → file_summary(). Specific section → compact(path, query).`,`Multiple files → digest(). Repeated ref → stratum_card(). Edit lines → read_file().`,`NEVER read_file >50 lines to understand. Use search() for discovery.`].join(` `),Xl={name:`token-efficiency`,order:30,maxTokens:80,runInBrief:!1,runOnce:!0,async execute(e){return{content:Yl,tokens:25}}},Zl=[`**Tool Routing:** search() not grep_search. file_summary() or compact() not read_file (for understanding).`,`check() not terminal tsc/lint. test_run() not terminal test. trace() for data flow.`,`read_file ONLY for exact lines before editing. symbol() for definition+refs.`].join(` `),Ql={name:`tool-routing`,order:10,maxTokens:100,runInBrief:!0,runOnce:!0,async execute(e){return{content:Zl,tokens:30}}};function $l(e,t){return Promise.race([e,new Promise(e=>setTimeout(()=>e(null),t))])}var eu=class{hooks=[];firedOnce=new Set;sealed=!1;log;constructor(e){this.log=e?.log}seal(){this.sealed=!0}register(e){if(this.sealed){this.log?.warn(`Attempted to register hook "%s" on sealed pipeline`,e.name);return}this.hooks.push(e),this.hooks.sort((e,t)=>e.order-t.order)}get hookCount(){return this.hooks.length}async enrich(e,t,n){let r=this.resolveBudget(t.mode,n),i=new Set(n?.disable??[]),a=this.hooks.filter(e=>!(i.has(e.name)||t.mode===`brief`&&!e.runInBrief||e.runOnce&&this.firedOnce.has(e.name)));if(a.length===0)return e;let o=[],s=0;for(let e of a){if(s>=r){this.log?.debug(`[step-hooks] Budget exhausted (${s}/${r}), skipping remaining hooks`);break}try{let n=await $l(e.execute(t),5e3);if(!n||n.content.length===0)continue;e.runOnce&&this.firedOnce.add(e.name);let i=n.content.replace(/<\/(step-context|step-hints)>/gi,``);if(i.length===0)continue;let a=this.truncateToTokens(i,e.maxTokens),c=Math.min(n.tokens,e.maxTokens);if(s+c<=r){o.push({content:a,tokens:c}),s+=c;continue}let l=r-s;if(l<=0)break;o.push({content:this.truncateToTokens(a,l),tokens:l}),s=r}catch(t){this.log?.warn(`[step-hooks] Hook "${e.name}" failed: ${t instanceof Error?t.message:String(t)}`)}}if(o.length===0)return e;let c=t.mode===`full`?`<step-context>`:`<step-hints>`,l=t.mode===`full`?`</step-context>`:`</step-hints>`;return`${e}\n\n${c}\n${o.map(e=>e.content).join(`
|
|
165
165
|
|
|
166
|
-
`)}\n${l}`}resolveBudget(e,t){return e===`full`?t?.tokenBudget?.full??500:t?.tokenBudget?.brief??150}truncateToTokens(e,t){let n=t*4;return e.length<=n?e:`${e.slice(0,n).trimEnd()}…`}};function
|
|
166
|
+
`)}\n${l}`}resolveBudget(e,t){return e===`full`?t?.tokenBudget?.full??500:t?.tokenBudget?.brief??150}truncateToTokens(e,t){let n=t*4;return e.length<=n?e:`${e.slice(0,n).trimEnd()}…`}};function tu(e={}){let t=new eu({log:e.log});return t.register(Ql),t.register(Jl({store:e.store,graphStore:e.graphStore,embedder:e.embedder})),t.register(Xl),t.register(ql),t.seal(),t}const nu=F(`flow-tools`);function ru(e){return Array.isArray(e)?e.filter(e=>typeof e==`string`&&e.trim().length>0):[]}function iu(e){return{content:[{type:`text`,text:e}]}}function au(e){return e instanceof Error?e.message:String(e)}const ou={before:[],after:[{id:`_docs-sync`,description:`Synchronize project documentation — update docs/ folder based on changes made during the flow.`,position:`after`,skills:[`docs`]}]};function su(e,t,n){let r=Kl(t),i=Gl(r.getWorkspaceRoot),a=tu({store:n?.store,graphStore:n?.graphStore,embedder:n?.embedder,log:nu});function o(){return N(Me(),`flows`,`registry.json`)}function s(){let t=Vl(e);return async({content:e,sourceFormat:n,stepName:r,metadata:i})=>{let a=r.charAt(0).toUpperCase()+r.slice(1),o=i?JSON.stringify(i,null,2):void 0,s=`You are converting a flow step definition from "${n}" format to aikit native flow step README.md format.
|
|
167
167
|
|
|
168
168
|
Convert the provided content into a well-structured README.md for a flow step named "${r}".
|
|
169
169
|
|
|
@@ -176,23 +176,23 @@ The output must:
|
|
|
176
176
|
6. Preserve ALL tool restrictions, constraints, and requirements from the source
|
|
177
177
|
7. Be formatted as clean Markdown
|
|
178
178
|
|
|
179
|
-
Output ONLY the README.md content, nothing else.`;if(t.available)try{let i=(await t.createMessage({prompt:e,systemPrompt:s,context:o?`Step name: ${r}\nSource format: ${n}\nMetadata:\n${o}`:`Step name: ${r}\nSource format: ${n}`,maxTokens:4096,modelPreferences:{intelligencePriority:.8,speedPriority:.4,costPriority:.2}})).text.trim();if(i.length>0)return i}catch(e){
|
|
179
|
+
Output ONLY the README.md content, nothing else.`;if(t.available)try{let i=(await t.createMessage({prompt:e,systemPrompt:s,context:o?`Step name: ${r}\nSource format: ${n}\nMetadata:\n${o}`:`Step name: ${r}\nSource format: ${n}`,maxTokens:4096,modelPreferences:{intelligencePriority:.8,speedPriority:.4,costPriority:.2}})).text.trim();if(i.length>0)return i}catch(e){nu.debug(`Flow transform sampling failed; using fallback formatting`,{error:au(e),sourceFormat:n,stepName:r})}let c=typeof i?.description==`string`&&i.description.trim().length>0?i.description.trim():null,l=ru(i?.produces),u=ru(i?.requires);return[`# ${a}`,``,`## Purpose`,``,c??`${a} step.`,``,`## Instructions`,``,e.trim(),``,`## Artifacts`,``,...l.length>0?l.map(e=>`- ${e}`):[`- ${r}.md`],...u.length>0?[``,`## Prerequisites`,``,...u.map(e=>`- ${e}`)]:[],``].join(`
|
|
180
180
|
`).trimEnd().concat(`
|
|
181
|
-
`)}}async function c(e){let{FlowRegistryManager:n,FlowStateMachine:i,FlowLoader:a,GitInstaller:s}=await import(`../../flows/dist/index.js`),c=N(t.stateDir??``,`flows`,`installed`);return{registry:new n(o()),stateMachine:new i(r.getFlowsDir(e),
|
|
182
|
-
`),t.lastIndexOf(` `),t.lastIndexOf(` `));return`${(n>=Math.floor(t.length*.6)?t.slice(0,n):t).trimEnd()}…`}function
|
|
181
|
+
`)}}async function c(e){let{FlowRegistryManager:n,FlowStateMachine:i,FlowLoader:a,GitInstaller:s}=await import(`../../flows/dist/index.js`),c=N(t.stateDir??``,`flows`,`installed`);return{registry:new n(o()),stateMachine:new i(r.getFlowsDir(e),ou),loader:new a,installer:new s(c)}}return{server:e,config:t,log:nu,toTextResponse:iu,toErrorText:au,createFlowTransform:s,getFlows:c,stepPipeline:a,stateDir:t.stateDir??``,...r,...i}}var X=class extends Error{code;constructor(e,t){super(t),this.code=e,this.name=`FlowError`}};function cu(e){return e instanceof X}async function lu(e){let{entry:t,stepId:n,runDir:r,slug:i,primaryRoot:a,roots:o,activeRoot:s,resolveInstructionPath:c,resolveEpilogueInstructionPath:l}=e;if(!n)return null;try{let e=t.manifest.steps.find(e=>e.id===n||e.name===n),u;if(e)u=await jn(c(t,e.instruction,s),`utf-8`);else{let e=l(n,s);if(!e)return null;u=await jn(e,`utf-8`)}let d=N(r,t.manifest.artifacts_dir).replaceAll(`\\`,`/`),f=r.replaceAll(`\\`,`/`);u=u.replaceAll(`{{artifacts_path}}`,d).replaceAll(`{{run_dir}}`,f).replaceAll(`{{workspace_root}}`,(a??s).replaceAll(`\\`,`/`)).replaceAll(`{{all_roots}}`,JSON.stringify(o??[s.replaceAll(`\\`,`/`)],null,2));for(let e of[`spec-driven`])u=u.replaceAll(`${e}/${i}/`,`${d}/`);return u}catch{return null}}async function uu(e,t){let{getFlows:n,log:r,resolveEpilogueInstructionPath:i,resolveFlowRoot:a,resolveInstructionPath:o,stepPipeline:s,toErrorText:c,toTextResponse:l}=t,{step:u}=e;try{let e=await a(),{registry:t,stateMachine:r}=await n(e),c=r.getStatus();if(!c.success||!c.data)throw new X(`NO_ACTIVE_FLOW`,`No active flow. Use flow({ action: "start", name: "<flow>" }) to begin one, or flow({ action: "list" }) to see available flows.`);let d=c.data,f=t.get(d.flow);if(!f)throw new X(`FLOW_NOT_FOUND`,`Flow "${d.flow}" not found in registry.`);let p=u??d.currentStep;if(!p)throw new X(`STEP_OUT_OF_RANGE`,`No current step is available for the active flow.`);let m=await lu({entry:f,stepId:p,runDir:d.runDir,slug:d.slug,primaryRoot:d.primaryRoot,roots:d.roots,activeRoot:e,resolveInstructionPath:o,resolveEpilogueInstructionPath:i});if(!m)throw new X(`STEP_OUT_OF_RANGE`,`Step "${p}" not found in flow "${d.flow}".`);let h=f.manifest.steps.find(e=>e.id===p||e.name===p),g=N(d.runDir,f.manifest.artifacts_dir).replaceAll(`\\`,`/`),_={stepId:p,flowName:d.flow,flowSlug:d.slug,phase:d.phase??`flow`,runDir:d.runDir,artifactsPath:g,completedSteps:d.completedSteps??[],stepDescription:h?.description,agents:h?.agents??[],mode:`full`,topic:d.topic??``,activeRoot:e};return l(await s.enrich(m,_,f.manifest.hooks))}catch(e){return cu(e)?l(e.message):(r.error(`flow action read failed`,I(e)),e instanceof Error&&`code`in e&&e.code===`ENOENT`?l(`Could not read instruction file: ${e.message}`):l(`Error: ${c(e)}`))}}async function du(e,t){let{registry:n,loader:r,installer:i}=await e.getFlows(),a=e.createFlowTransform(),o=P(t.source);if(!A(o))return e.toTextResponse(`Source path no longer exists: ${o}`);let s=`${t.installPath}.updating`,c=`${t.installPath}.backup`;A(s)&&fe(s,{recursive:!0,force:!0}),A(c)&&fe(c,{recursive:!0,force:!0});let l=i.copyLocal(o,ge(s));if(!l.success||!l.data)return e.toTextResponse(`Failed to copy flow: ${l.error}`);let u=await r.load(s,{forceAssetSync:!0,transform:a});if(!u.success||!u.data)return i.remove(s),e.toTextResponse(`Failed to load flow manifest: ${u.error}`);let d=!1;try{de(t.installPath,c),de(s,t.installPath);let e=await r.load(t.installPath,{forceAssetSync:!0,transform:a});if(!e.success||!e.data)throw Error(`Failed to load flow manifest: ${e.error}`);let o=e.data.manifest,l=e.data.format,u=n.register({...t,version:o.version,format:l,installPath:t.installPath,manifest:o,updatedAt:new Date().toISOString()});if(!u.success)throw Error(`Failed to refresh flow registry entry: ${u.error}`);if(d=!0,o.install.length>0){let e=i.runInstallDeps(o.install);if(!e.success)throw Error(`Dependency install failed: ${e.error}`)}fe(c,{recursive:!0,force:!0})}catch(r){return A(s)&&fe(s,{recursive:!0,force:!0}),A(c)&&(A(t.installPath)&&fe(t.installPath,{recursive:!0,force:!0}),de(c,t.installPath)),d&&n.register(t),e.toTextResponse(e.toErrorText(r))}return e.toTextResponse(`Flow "${t.name}" updated from ${t.sourceType} source successfully.`)}async function fu(e,t){let{registry:n,loader:r}=await e.getFlows(),i=e.createFlowTransform();try{br(`npm update -g @fission-ai/openspec`,{encoding:`utf-8`,stdio:`pipe`})}catch(t){return e.toTextResponse(`npm update failed: ${e.toErrorText(t)}`)}let a=e.resolveOpenSpecSource(),o=await r.load(a.path,{forceAssetSync:!0,transform:i}),s=o.success&&o.data?o.data.manifest:null,c=o.success&&o.data?o.data.format:t.format;if(s){let r=n.register({...t,version:s.version,format:c,installPath:a.path,manifest:s,updatedAt:new Date().toISOString()});if(!r.success)return e.toTextResponse(`Failed to refresh flow registry entry: ${r.error}`)}return e.toTextResponse(`Flow "${t.name}" updated via npm successfully.`)}async function pu(e,t){let{registry:n,loader:r,installer:i}=await e.getFlows(),a=e.createFlowTransform(),o=i.update(t.installPath);if(!o.success)return e.toTextResponse(`Update failed: ${o.error}`);let s=await r.load(t.installPath,{forceAssetSync:!0,transform:a}),c=s.success&&s.data?s.data.manifest:null,l=s.success&&s.data?s.data.format:t.format;if(c){let r=i.getLocalCommit(t.installPath),a=n.register({...t,version:c.version,format:l,manifest:c,updatedAt:new Date().toISOString(),...r?{commitSha:r}:{}});if(!a.success)return e.toTextResponse(`Failed to refresh flow registry entry: ${a.error}`)}let u=c?.install??t.manifest.install;if(u.length>0){let t=i.runInstallDeps(u);if(!t.success)return e.toTextResponse(`Dependency install failed: ${t.error}`)}return e.toTextResponse(`Flow "${t.name}" updated successfully.`)}async function mu(e,t){let{createFlowTransform:n,getFlows:r,log:i,resolveClaudePluginSource:a,resolveOpenSpecSource:o,toErrorText:s,toTextResponse:c}=t,{source:l,name:u,token:d}=e;try{let{registry:e,loader:t,installer:i}=await r(),s=n(),f=l===`openspec`||l.startsWith(`openspec:`),p,m=l,h;if(f){let e=o();m=e.path,p=e.sourceType}let g=f?null:a(m);g&&(m=g.path,p=g.sourceType);let _=/^https?:\/\/|^git@/.test(m),v;if(_){let e=i.clone(m,d);if(!e.success||!e.data)return c(`Failed to clone flow: ${e.error}`);v=e.data}else{let e=P(m);h=e;let t=u||ge(e)||`custom-flow`,n=i.copyLocal(e,t);if(!n.success||!n.data)return c(`Failed to copy flow: ${n.error}`);v=n.data}let y=await t.load(v,{forceAssetSync:!0,transform:s});if(!y.success||!y.data)return i.remove(v),c(`Failed to load flow manifest: ${y.error}`);let{manifest:b,format:x}=y.data,S=u||b.name,C=p??(_?`git`:`local`);if(e.has(S))return i.remove(v),c(`Flow "${S}" is already installed. Use flow({ action: "update", name: "${S}" }) to update it, or flow({ action: "remove", name: "${S}" }) then flow({ action: "add", source: "..." }) to replace.`);if(b.install.length>0){let e=i.runInstallDeps(b.install);if(!e.success)return i.remove(v),c(`Dependency install failed: ${e.error}`)}let w=new Date().toISOString(),T=_?i.getLocalCommit(v):void 0,E=e.register({name:S,version:b.version,source:C===`local`||C===`claude-plugin`?h??l:l,sourceType:C,installPath:v,format:x,registeredAt:w,updatedAt:w,manifest:b,...T?{commitSha:T}:{}});if(!E.success)return i.remove(v),c(`Failed to register flow: ${E.error}`);let D=b.steps.length;return c(`Flow "${S}" installed successfully (${D} steps). Use flow({ action: "start", name: "${S}" }) to begin.`)}catch(e){return i.error(`flow action add failed`,I(e)),c(`Error: ${s(e)}`)}}async function hu(e,t){let{getFlows:n,log:r,toErrorText:i,toTextResponse:a}=t,{name:o}=e;try{let{registry:e,installer:t}=await n();if(!e.has(o))return a(`Flow "${o}" is not installed.`);let r=e.get(o);if(!r)return a(`Flow "${o}" is not installed.`);if(r.sourceType===`builtin`)return a(`Cannot remove builtin flow "${o}".`);let i=t.remove(r.installPath);if(!i.success)return a(`Failed to remove flow files: ${i.error}`);let s=e.unregister(o);return s.success?a(`Flow "${o}" removed successfully.`):a(`Failed to unregister flow: ${s.error}`)}catch(e){return r.error(`flow action remove failed`,I(e)),a(`Error: ${i(e)}`)}}async function gu(e,t){let{getFlows:n,log:r,toErrorText:i,toTextResponse:a}=t,{name:o}=e,s={createFlowTransform:t.createFlowTransform,getFlows:t.getFlows,resolveOpenSpecSource:t.resolveOpenSpecSource,toErrorText:t.toErrorText,toTextResponse:t.toTextResponse};try{let{registry:e}=await n();if(!e.has(o))return a(`Flow "${o}" is not installed.`);let t=e.get(o);return!t||t.sourceType!==`git`&&t.sourceType!==`npm-global`&&t.sourceType!==`local`&&t.sourceType!==`claude-plugin`?a(`Flow "${o}" was not installed from git, npm, or a local source — cannot update. Remove and re-add instead.`):t.sourceType===`local`||t.sourceType===`claude-plugin`?du(s,t):t.sourceType===`npm-global`?fu(s,t):pu(s,t)}catch(e){return r.error(`flow action update failed`,I(e)),a(`Error: ${i(e)}`)}}const _u=`IMPORTANT: Start/status/step only include a brief. Call flow({ action: "read" }) before executing this flow step.`,vu=1200,yu=/artifact|output contract|gate|completion criteria|deliverable|must|do not|forbidden/i;function bu(){return{artifactsPath:null,currentStepInstruction:null,currentStepDescription:null,currentStepContent:null,currentStepBrief:null,currentStepPins:null,stepSequence:[]}}function xu(e){if(e.length<=vu)return e;let t=e.slice(0,vu-1),n=Math.max(t.lastIndexOf(`
|
|
182
|
+
`),t.lastIndexOf(` `),t.lastIndexOf(` `));return`${(n>=Math.floor(t.length*.6)?t.slice(0,n):t).trimEnd()}…`}function Su(e){if(!e?.trim())return{brief:null,pins:null};let t=/^##\s+/m.exec(e),n=(t?e.slice(0,t.index):e).trim(),r=null;if(n){let e=n.split(/\n\s*\n/).filter(e=>e.trim().length>0),t=(e[0]?.startsWith(`#`)&&e[1]?e.slice(0,2):e.slice(0,1)).join(`
|
|
183
183
|
|
|
184
|
-
`).trim();r=t?
|
|
184
|
+
`).trim();r=t?xu(t):null}let i=Array.from(e.matchAll(/^##\s+.*$/gm)),a=[];for(let[t,n]of i.entries()){let r=n[0];if(!yu.test(r))continue;let o=n.index??0,s=i[t+1]?.index??e.length;a.push(e.slice(o,s).replace(/\s+$/,``))}return{brief:r,pins:a.length>0?a.join(`
|
|
185
185
|
|
|
186
|
-
`):null}}function xu(e,t){return t(e)}async function Su(e){let{context:t,entry:n,state:r,activeRoot:i,primaryRoot:a,roots:o}=e,{instructionPath:s,description:c}=t.resolveCurrentStepInfo(n,r.currentStep,i),l=xu(n,t.getStepSequence),u=await su({entry:n,stepId:r.currentStep,runDir:r.runDir,slug:r.slug,primaryRoot:a,roots:o,activeRoot:i,resolveInstructionPath:t.resolveInstructionPath,resolveEpilogueInstructionPath:t.resolveEpilogueInstructionPath}),{brief:d,pins:f}=bu(u),p=d;if(d&&r.currentStep){let e=n.manifest.steps.find(e=>e.id===r.currentStep),a={stepId:r.currentStep,flowName:r.flow,flowSlug:r.slug,phase:`flow`,runDir:r.runDir,artifactsPath:N(r.runDir,n.manifest.artifacts_dir).replaceAll(`\\`,`/`),completedSteps:r.completedSteps??[],stepDescription:e?.description??c??void 0,agents:e?.agents??[],mode:`brief`,topic:r.topic??``,activeRoot:i};p=await t.stepPipeline.enrich(d,a,n.manifest.hooks)}return{artifactsPath:N(r.runDir,n.manifest.artifacts_dir).replaceAll(`\\`,`/`),currentStepInstruction:s,currentStepDescription:c,currentStepContent:u,currentStepBrief:p,currentStepPins:f,stepSequence:l}}function Cu(e){let{state:t,data:n,started:r,includeStatus:i,action:a,includeInstructionPath:o}=e,s={};return r&&(s.started=!0),s.flow=t.flow,i&&(s.status=t.status),a&&(s.action=a),s.slug=t.slug,s.topic=t.topic,s.runDir=t.runDir,s.artifactsPath=n.artifactsPath,s.currentStep=t.currentStep,s.currentStepInstruction=n.currentStepInstruction,o&&(s.instructionPath=n.currentStepInstruction),s.currentStepDescription=n.currentStepDescription,s.currentStepContent=null,s.currentStepBrief=n.currentStepBrief,s.currentStepPins=n.currentStepPins,s.fullContentHint=`Call flow({ action: 'read' }) for the complete step instructions.`,s}async function wu(e,t){let{getAllRoots:n,getFlows:r,getWorkspaceRoot:i,isValidFlowRoot:a,log:o,patchMetaRoots:s,stateDir:c,toErrorText:l,toTextResponse:u}=t,{flow:d,topic:f,roots:p}=e;try{if(p&&p.length>0){let e=n().map(e=>e.replaceAll(`\\`,`/`)),t=p.filter(e=>!a(e));if(t.length>0)return u(`Invalid roots — not part of the workspace or a recognized sub-repository: ${t.join(`, `)}. Available roots: ${e.join(`, `)}`)}let e=n(),o=e.map(e=>e.replaceAll(`\\`,`/`)),l=i(),m=e.length>1,h=!p&&m,g=p?.[0]??l,{registry:_,stateMachine:v}=await r(g),y=_.get(d);if(!y)throw new X(`UNKNOWN_FLOW`,`Flow "${d}" not found. Use flow({ action: "list" }) to see available flows.`);let b=v.start(y.name,y.manifest,f);if(!b.success||!b.data){let e=b.error??`Unknown flow start error.`;return e.includes(`already active`)?u(`Cannot start: ${new X(`FLOW_ALREADY_ACTIVE`,e).message}`):u(`Cannot start: ${e}`)}let x=b.data;if(p&&p.length>1)try{s(x.slug,g,p),t.syncMetaToRoots(x.slug,g)}catch(e){return v.reset(),u(`Flow created but failed to sync to secondary roots — rolled back. Error: ${e instanceof Error?e.message:String(e)}`)}let S=N(c,`flow-context`),C=typeof Mn==`function`?await Mn(S).catch(()=>[]):[];for(let e of C)e!==x.slug&&typeof Nn==`function`&&await Nn(N(S,e),{recursive:!0,force:!0}).catch(()=>{});if(typeof An==`function`)try{await An(N(S,x.slug),{recursive:!0})}catch{}let w=await Su({context:t,entry:y,state:x,activeRoot:g,primaryRoot:null,roots:p??null}),T={...Cu({state:x,data:w,started:!0}),phase:x.phase,isEpilogue:x.isEpilogue,totalSteps:w.stepSequence.length,stepSequence:w.stepSequence,artifactsDir:y.manifest.artifacts_dir,roots:p??[g.replaceAll(`\\`,`/`)],_hint:hu,...h?{multiRootWarning:`No roots specified in multi-root workspace. Flow created at workspace root. Pass roots parameter with target repo for precise placement.`,availableRoots:o}:{}};return u(JSON.stringify(T,null,2))}catch(e){return ou(e)?u(e.message):(o.error(`flow action start failed`,I(e)),u(`Error: ${l(e)}`))}}async function Tu(e){let{getFlows:t,log:n,resolveFlowRoot:r,resolveRoots:i,toErrorText:a,toTextResponse:o}=e;try{let n=await r(),{registry:a,stateMachine:s}=await t(n),c=s.getStatus();if(!c.success||!c.data)throw new X(`NO_ACTIVE_FLOW`,`No active flow. Use flow({ action: "start", name: "<flow>" }) to begin one, or flow({ action: "list" }) to see available flows.`);let l=c.data,u=a.get(l.flow),d=u?await Su({context:e,entry:u,state:l,activeRoot:n,primaryRoot:l.primaryRoot,roots:l.roots}):vu(),f={...Cu({state:l,data:d,includeStatus:!0,includeInstructionPath:!0}),_hint:l.currentStep?hu:void 0,phase:l.phase,isEpilogue:l.isEpilogue,completedSteps:l.completedSteps,skippedSteps:l.skippedSteps,artifacts:l.artifacts,startedAt:l.startedAt,updatedAt:l.updatedAt,totalSteps:d.stepSequence.length,progress:u?`${l.completedSteps.length+l.skippedSteps.length}/${d.stepSequence.length}`:`unknown`,workspaceRoot:n.replaceAll(`\\`,`/`),primaryRoot:(l.primaryRoot??n).replaceAll(`\\`,`/`),roots:l.roots??[n.replaceAll(`\\`,`/`)],allRoots:i().normalizedAllRoots,discoveredRepos:i().discoveredRepos};return o(JSON.stringify(f,null,2))}catch(e){return ou(e)?o(e.message):(n.error(`flow action status failed`,I(e)),o(`Error: ${a(e)}`))}}async function Eu(e){let{getFlows:t,log:n,resolveFlowRoot:r,stateDir:i,syncMetaToRoots:a,toErrorText:o,toTextResponse:s}=e;try{let e=await r(),{stateMachine:n}=await t(e),o=n.getStatus(),c=n.reset();if(!c.success)return s(`Reset failed: ${c.error}`);if(o.success&&o.data&&a(o.data.slug,e),o.success&&o.data?.slug)try{await Nn(N(i,`flow-context`,o.data.slug),{recursive:!0,force:!0})}catch{}return s(`Flow abandoned. Use flow({ action: "start", name: "<flow>" }) to begin a new flow.`)}catch(e){return n.error(`flow action reset failed`,I(e)),s(`Error: ${o(e)}`)}}async function Du(e,t){let{getFlows:n,log:r,resolveFlowRoot:i,syncMetaToRoots:a,toErrorText:o,toTextResponse:s}=t,{action:c}=e;try{let e=await i(),{registry:r,stateMachine:o}=await n(e),l=o.getStatus();if(!l.success||!l.data)throw new X(`NO_ACTIVE_FLOW`,`No active flow. Use flow({ action: "start", name: "<flow>" }) first.`);let u=r.get(l.data.flow);if(!u)throw new X(`FLOW_NOT_FOUND`,`Flow "${l.data.flow}" not found in registry.`);let d=o.step(c,u.manifest);if(!d.success||!d.data)return s(`Cannot ${c}: ${d.error}`);a(d.data.slug,e);let f=d.data,p=[];if(f.status===`completed`){let e=N(t.stateDir,`flow-context`,f.slug);for(let t of[`decision`,`pattern`]){let n=N(e,t);try{let e=await Mn(n);for(let r of e){if(!r.endsWith(`.md`))continue;let e=await jn(N(n,r),`utf-8`);e.length>100&&p.push({type:t,title:r.replace(/\.md$/,``).replace(/-/g,` `),content:e.length>500?`${e.slice(0,497)}...`:e})}}catch{}}typeof Nn==`function`&&await Nn(e,{recursive:!0,force:!0}).catch(()=>{})}let m=await Su({context:t,entry:u,state:f,activeRoot:e,primaryRoot:f.primaryRoot,roots:f.roots}),h={...Cu({state:f,data:m,includeStatus:!0,action:c}),_hint:f.currentStep?hu:void 0,phase:f.phase,isEpilogue:f.isEpilogue,completedSteps:f.completedSteps,skippedSteps:f.skippedSteps,totalSteps:m.stepSequence.length,remaining:m.stepSequence.filter(e=>!f.completedSteps.includes(e)&&!f.skippedSteps.includes(e)&&e!==f.currentStep),...p.length>0?{promotionCandidates:p}:{}};return s(JSON.stringify(h,null,2))}catch(e){return ou(e)?s(e.message):(r.error(`flow action step failed`,I(e)),s(`Error: ${o(e)}`))}}async function Ou(e){let{getFlows:t,log:n,resolveFlowRoot:r,resolveRoots:i,toErrorText:a,toTextResponse:o}=e;try{let{registry:e,stateMachine:n,installer:a}=await t(await r()),s=e.list(),c=n.getStatus(),l={flows:s.map(e=>{let t={name:e.name,version:e.version,source:e.source,sourceType:e.sourceType,format:e.format,steps:e.manifest.steps.map(e=>e.id)};if(e.sourceType===`git`&&e.commitSha){let n=a.hasUpdates(e.installPath);return{...t,commitSha:e.commitSha,updateAvailable:n.success&&n.data?n.data.hasUpdates:void 0}}return t}),activeFlow:c.success&&c.data?{flow:c.data.flow,status:c.data.status,currentStep:c.data.currentStep,slug:c.data.slug,topic:c.data.topic,runDir:c.data.runDir}:null,allRoots:i().normalizedAllRoots,discoveredRepos:i().discoveredRepos};return o(JSON.stringify(l,null,2))}catch(e){return n.error(`flow action list failed`,I(e)),o(`Error: ${a(e)}`)}}async function ku(e,t){let{getFlows:n,log:r,resolveInstallPath:i,resolveInstructionPath:a,toErrorText:o,toTextResponse:s}=t,{name:c}=e;try{let{registry:e,installer:t}=await n(),r=e.get(c);if(!r)throw new X(`UNKNOWN_FLOW`,`Flow "${c}" not found. Use flow({ action: "list" }) to see available flows.`);let o=r.commitSha??null,l;if(r.sourceType===`git`&&r.installPath){let e=t.hasUpdates(r.installPath);l=e.success&&e.data?e.data.hasUpdates:void 0}let u={name:r.name,version:r.version,description:r.manifest.description,source:r.source,sourceType:r.sourceType,format:r.format,commitSha:o,updateAvailable:l,installPath:i(r.name,r),registeredAt:r.registeredAt,updatedAt:r.updatedAt,steps:r.manifest.steps.map(e=>({id:e.id,name:e.name,instruction:a(r,e.instruction),produces:e.produces,requires:e.requires,description:e.description})),agents:r.manifest.agents,artifactsDir:r.manifest.artifacts_dir,install:r.manifest.install};return s(JSON.stringify(u,null,2))}catch(e){return ou(e)?s(e.message):(r.error(`flow action info failed`,I(e)),s(`Error: ${o(e)}`))}}async function Au(e,t){let{getAllRoots:n,getFlows:r,log:i,toErrorText:a,toTextResponse:o}=t,{flow:s,status:c,limit:l=50}=e,u=e=>{for(let t of[`updatedAt`,`startedAt`,`createdAt`]){let n=e[t];if(typeof n==`number`&&Number.isFinite(n))return n;if(typeof n==`string`){let e=Date.parse(n);if(!Number.isNaN(e))return e}}return null};try{let e=n(),t=[];for(let n of e){let{stateMachine:e}=await r(n),i=e.listRuns({flow:s,status:c});for(let e of i)t.push({...JSON.parse(JSON.stringify(e)),root:n.replaceAll(`\\`,`/`)})}let i=new Set,a=t.filter(e=>{let t=e.id;return i.has(t)?!1:(i.add(t),!0)});if(a.length===0)return o(`No flow runs found.`);let d=a.map((e,t)=>({run:e,index:t,recency:u(e)})).sort((e,t)=>e.recency==null&&t.recency==null?e.index-t.index:e.recency==null?1:t.recency==null?-1:t.recency===e.recency?e.index-t.index:t.recency-e.recency).map(({run:e})=>e).slice(0,l);return o(JSON.stringify({total:a.length,returned:d.length,truncated:a.length>d.length,runs:d},null,2))}catch(e){return i.error(`flow action runs failed`,I(e)),o(`Error: ${a(e)}`)}}function ju(e){let t=e.content?.find(e=>e.type===`text`)?.text??``;if(!t)return null;try{let e=JSON.parse(t);if(typeof e.slug==`string`&&e.slug.length>0)return e.slug}catch{}return t.match(/[Ss]lug[:\s]*`?([^`\s,]+)`?/)?.[1]??null}function Mu(e,t,n,r){let i=n&&typeof n!=`function`?n:void 0,a=typeof n==`function`?n:r,o=au(e,t,i),s=U(`flow`);e.registerTool(`flow`,{title:s.title,description:`Manage development flows — list available flows, start/stop runs, navigate steps, read instructions, and install/remove/update flows. Use action parameter to select operation.`,annotations:s.annotations,inputSchema:{action:R.enum([`list`,`info`,`start`,`step`,`status`,`reset`,`read`,`runs`,`add`,`remove`,`update`]).describe(`The flow operation to perform.`),name:R.string().optional().describe(`Flow name — required for info, start, remove, update. Optional override for add.`),topic:R.string().optional().describe(`Human-readable topic for the run (used by start).`),roots:R.array(R.string()).optional().describe(`Workspace roots participating in this flow (used by start).`),advance:R.enum([`next`,`skip`,`redo`]).optional().describe(`Step navigation action — required for step.`),step:R.string().optional().describe(`Step id or name to read (used by read). Defaults to current step.`),source:R.string().optional().describe(`Git URL, local path, or "openspec" shorthand — required for add.`),token:R.string().optional().describe(`Auth token for private repos (used by add).`),filter_flow:R.string().optional().describe(`Filter runs by flow name (used by runs).`),filter_status:R.string().optional().describe(`Filter runs by status: active, completed, abandoned (used by runs).`),limit:R.number().int().positive().optional().describe(`Max runs to return (default 50).`)}},q(`flow`,async e=>{switch(e.action){case`list`:return Ou(o);case`info`:return e.name?ku({name:e.name},o):o.toTextResponse(`Missing required parameter: name`);case`start`:{if(!e.name)return o.toTextResponse(`Missing required parameter: name (flow to start)`);let t=await wu({flow:e.name,topic:e.topic,roots:e.roots},o),n=ju(t);return n&&a&&a(n),t}case`step`:return e.advance?Du({action:e.advance},o):o.toTextResponse(`Missing required parameter: advance (next/skip/redo)`);case`status`:{let e=await Tu(o);return a&&a(ju(e)),e}case`reset`:{let e=await Eu(o);return a&&a(null),e}case`read`:return cu({step:e.step},o);case`runs`:return Au({flow:e.filter_flow,status:e.filter_status,limit:e.limit},o);case`add`:return e.source?fu({source:e.source,name:e.name,token:e.token},o):o.toTextResponse(`Missing required parameter: source`);case`remove`:return e.name?pu({name:e.name},o):o.toTextResponse(`Missing required parameter: name`);case`update`:return e.name?mu({name:e.name},o):o.toTextResponse(`Missing required parameter: name`);default:return o.toTextResponse(`Unknown action: ${e.action}`)}}))}const Nu=F(`tools`);function Pu(e){let t=U(`evidence_map`);e.registerTool(`evidence_map`,{title:t.title,description:`Track verified/assumed/unresolved claims for complex tasks. Gate readiness: YIELD (proceed), HOLD (unknowns), HARD_BLOCK (critical gaps). Persists across calls.`,inputSchema:{action:R.enum([`create`,`add`,`update`,`get`,`gate`,`list`,`delete`]).describe(`Operation to perform`),task_id:R.string().optional().describe(`Task identifier (required for all except list)`),tier:R.enum([`floor`,`standard`,`critical`]).optional().describe(`FORGE tier (required for create)`),claim:R.string().optional().describe(`Critical-path claim text (for add)`),status:R.enum([`V`,`A`,`U`]).optional().describe(`Evidence status: V=Verified, A=Assumed, U=Unresolved`),receipt:R.string().optional().describe(`Evidence receipt: tool→ref for V, reasoning for A, attempts for U`),id:R.number().optional().describe(`Entry ID (for update)`),critical_path:R.boolean().default(!0).describe(`Whether this claim is on the critical path`),unknown_type:R.enum([`contract`,`convention`,`freshness`,`runtime`,`data-flow`,`impact`]).optional().describe(`Typed unknown classification`),safety_gate:R.enum([`provenance`,`commitment`,`coverage`]).optional().describe(`Safety gate tag: provenance (claim→evidence), commitment (user-approved), coverage (nothing dropped)`),retry_count:R.number().default(0).describe(`Retry count for gate evaluation (0 = first attempt)`),max_retries:R.number().int().min(0).optional().describe(`Maximum retries before escalating. Default: 3`),timeout_action:R.enum([`iterate`,`retry`,`manual`,`terminate`]).optional().describe(`Action to take when gate retries are exhausted. Default: manual`),cwd:R.string().optional().describe(`Working directory for evidence map storage (default: server cwd). Use root_path from forge_ground to match.`)},annotations:t.annotations},q(`evidence_map`,async({action:e,task_id:t,tier:n,claim:r,status:i,receipt:a,id:o,critical_path:s,unknown_type:c,safety_gate:l,retry_count:u,max_retries:d,timeout_action:f,cwd:p})=>{try{switch(e){case`create`:if(!t)throw Error(`task_id required for create`);if(!n)throw Error(`tier required for create`);return dt({action:`create`,taskId:t,tier:n},p),{content:[{type:`text`,text:`Created evidence map "${t}" (tier: ${n}).\n\n---\n_Next: Use \`evidence_map\` with action "add" to record critical-path claims._`}]};case`add`:{if(!t)throw Error(`task_id required for add`);if(!r)throw Error(`claim required for add`);if(!i)throw Error(`status required for add`);let e=dt({action:`add`,taskId:t,claim:r,status:i,receipt:a??``,criticalPath:s,unknownType:c,safetyGate:l},p),n=e.autoCreated?[`⚠️ Evidence map "${t}" was auto-created with tier "standard". Use \`create\` action to set a specific tier.`,``,`Added entry #${e.entry?.id} to "${t}": [${i}] ${r}`]:[`Added entry #${e.entry?.id} to "${t}": [${i}] ${r}`];return e.summary&&n.push(``,e.summary),{content:[{type:`text`,text:n.join(`
|
|
186
|
+
`):null}}function Cu(e,t){return t(e)}async function wu(e){let{context:t,entry:n,state:r,activeRoot:i,primaryRoot:a,roots:o}=e,{instructionPath:s,description:c}=t.resolveCurrentStepInfo(n,r.currentStep,i),l=Cu(n,t.getStepSequence),u=await lu({entry:n,stepId:r.currentStep,runDir:r.runDir,slug:r.slug,primaryRoot:a,roots:o,activeRoot:i,resolveInstructionPath:t.resolveInstructionPath,resolveEpilogueInstructionPath:t.resolveEpilogueInstructionPath}),{brief:d,pins:f}=Su(u),p=d;if(d&&r.currentStep){let e=n.manifest.steps.find(e=>e.id===r.currentStep),a={stepId:r.currentStep,flowName:r.flow,flowSlug:r.slug,phase:`flow`,runDir:r.runDir,artifactsPath:N(r.runDir,n.manifest.artifacts_dir).replaceAll(`\\`,`/`),completedSteps:r.completedSteps??[],stepDescription:e?.description??c??void 0,agents:e?.agents??[],mode:`brief`,topic:r.topic??``,activeRoot:i};p=await t.stepPipeline.enrich(d,a,n.manifest.hooks)}return{artifactsPath:N(r.runDir,n.manifest.artifacts_dir).replaceAll(`\\`,`/`),currentStepInstruction:s,currentStepDescription:c,currentStepContent:u,currentStepBrief:p,currentStepPins:f,stepSequence:l}}function Tu(e){let{state:t,data:n,started:r,includeStatus:i,action:a,includeInstructionPath:o}=e,s={};return r&&(s.started=!0),s.flow=t.flow,i&&(s.status=t.status),a&&(s.action=a),s.slug=t.slug,s.topic=t.topic,s.runDir=t.runDir,s.artifactsPath=n.artifactsPath,s.currentStep=t.currentStep,s.currentStepInstruction=n.currentStepInstruction,o&&(s.instructionPath=n.currentStepInstruction),s.currentStepDescription=n.currentStepDescription,s.currentStepContent=null,s.currentStepBrief=n.currentStepBrief,s.currentStepPins=n.currentStepPins,s.fullContentHint=`Call flow({ action: 'read' }) for the complete step instructions.`,s}async function Eu(e,t){let{getAllRoots:n,getFlows:r,getWorkspaceRoot:i,isValidFlowRoot:a,log:o,patchMetaRoots:s,stateDir:c,toErrorText:l,toTextResponse:u}=t,{flow:d,topic:f,roots:p}=e;try{if(p&&p.length>0){let e=n().map(e=>e.replaceAll(`\\`,`/`)),t=p.filter(e=>!a(e));if(t.length>0)return u(`Invalid roots — not part of the workspace or a recognized sub-repository: ${t.join(`, `)}. Available roots: ${e.join(`, `)}`)}let e=n(),o=e.map(e=>e.replaceAll(`\\`,`/`)),l=i(),m=e.length>1,h=!p&&m,g=p?.[0]??l,{registry:_,stateMachine:v}=await r(g),y=_.get(d);if(!y)throw new X(`UNKNOWN_FLOW`,`Flow "${d}" not found. Use flow({ action: "list" }) to see available flows.`);let b=v.start(y.name,y.manifest,f);if(!b.success||!b.data){let e=b.error??`Unknown flow start error.`;return e.includes(`already active`)?u(`Cannot start: ${new X(`FLOW_ALREADY_ACTIVE`,e).message}`):u(`Cannot start: ${e}`)}let x=b.data;if(p&&p.length>1)try{s(x.slug,g,p),t.syncMetaToRoots(x.slug,g)}catch(e){return v.reset(),u(`Flow created but failed to sync to secondary roots — rolled back. Error: ${e instanceof Error?e.message:String(e)}`)}let S=N(c,`flow-context`),C=typeof Mn==`function`?await Mn(S).catch(()=>[]):[];for(let e of C)e!==x.slug&&typeof Nn==`function`&&await Nn(N(S,e),{recursive:!0,force:!0}).catch(()=>{});if(typeof An==`function`)try{await An(N(S,x.slug),{recursive:!0})}catch{}let w=await wu({context:t,entry:y,state:x,activeRoot:g,primaryRoot:null,roots:p??null}),T={...Tu({state:x,data:w,started:!0}),phase:x.phase,isEpilogue:x.isEpilogue,totalSteps:w.stepSequence.length,stepSequence:w.stepSequence,artifactsDir:y.manifest.artifacts_dir,roots:p??[g.replaceAll(`\\`,`/`)],_hint:_u,...h?{multiRootWarning:`No roots specified in multi-root workspace. Flow created at workspace root. Pass roots parameter with target repo for precise placement.`,availableRoots:o}:{}};return u(JSON.stringify(T,null,2))}catch(e){return cu(e)?u(e.message):(o.error(`flow action start failed`,I(e)),u(`Error: ${l(e)}`))}}async function Du(e){let{getFlows:t,log:n,resolveFlowRoot:r,resolveRoots:i,toErrorText:a,toTextResponse:o}=e;try{let n=await r(),{registry:a,stateMachine:s}=await t(n),c=s.getStatus();if(!c.success||!c.data)throw new X(`NO_ACTIVE_FLOW`,`No active flow. Use flow({ action: "start", name: "<flow>" }) to begin one, or flow({ action: "list" }) to see available flows.`);let l=c.data,u=a.get(l.flow),d=u?await wu({context:e,entry:u,state:l,activeRoot:n,primaryRoot:l.primaryRoot,roots:l.roots}):bu(),f={...Tu({state:l,data:d,includeStatus:!0,includeInstructionPath:!0}),_hint:l.currentStep?_u:void 0,phase:l.phase,isEpilogue:l.isEpilogue,completedSteps:l.completedSteps,skippedSteps:l.skippedSteps,artifacts:l.artifacts,startedAt:l.startedAt,updatedAt:l.updatedAt,totalSteps:d.stepSequence.length,progress:u?`${l.completedSteps.length+l.skippedSteps.length}/${d.stepSequence.length}`:`unknown`,workspaceRoot:n.replaceAll(`\\`,`/`),primaryRoot:(l.primaryRoot??n).replaceAll(`\\`,`/`),roots:l.roots??[n.replaceAll(`\\`,`/`)],allRoots:i().normalizedAllRoots,discoveredRepos:i().discoveredRepos};return o(JSON.stringify(f,null,2))}catch(e){return cu(e)?o(e.message):(n.error(`flow action status failed`,I(e)),o(`Error: ${a(e)}`))}}async function Ou(e){let{getFlows:t,log:n,resolveFlowRoot:r,stateDir:i,syncMetaToRoots:a,toErrorText:o,toTextResponse:s}=e;try{let e=await r(),{stateMachine:n}=await t(e),o=n.getStatus(),c=n.reset();if(!c.success)return s(`Reset failed: ${c.error}`);if(o.success&&o.data&&a(o.data.slug,e),o.success&&o.data?.slug)try{await Nn(N(i,`flow-context`,o.data.slug),{recursive:!0,force:!0})}catch{}return s(`Flow abandoned. Use flow({ action: "start", name: "<flow>" }) to begin a new flow.`)}catch(e){return n.error(`flow action reset failed`,I(e)),s(`Error: ${o(e)}`)}}async function ku(e,t){let{getFlows:n,log:r,resolveFlowRoot:i,syncMetaToRoots:a,toErrorText:o,toTextResponse:s}=t,{action:c}=e;try{let e=await i(),{registry:r,stateMachine:o}=await n(e),l=o.getStatus();if(!l.success||!l.data)throw new X(`NO_ACTIVE_FLOW`,`No active flow. Use flow({ action: "start", name: "<flow>" }) first.`);let u=r.get(l.data.flow);if(!u)throw new X(`FLOW_NOT_FOUND`,`Flow "${l.data.flow}" not found in registry.`);let d=o.step(c,u.manifest);if(!d.success||!d.data)return s(`Cannot ${c}: ${d.error}`);a(d.data.slug,e);let f=d.data,p=[];if(f.status===`completed`){let e=N(t.stateDir,`flow-context`,f.slug);for(let t of[`decision`,`pattern`]){let n=N(e,t);try{let e=await Mn(n);for(let r of e){if(!r.endsWith(`.md`))continue;let e=await jn(N(n,r),`utf-8`);e.length>100&&p.push({type:t,title:r.replace(/\.md$/,``).replace(/-/g,` `),content:e.length>500?`${e.slice(0,497)}...`:e})}}catch{}}typeof Nn==`function`&&await Nn(e,{recursive:!0,force:!0}).catch(()=>{})}let m=await wu({context:t,entry:u,state:f,activeRoot:e,primaryRoot:f.primaryRoot,roots:f.roots}),h={...Tu({state:f,data:m,includeStatus:!0,action:c}),_hint:f.currentStep?_u:void 0,phase:f.phase,isEpilogue:f.isEpilogue,completedSteps:f.completedSteps,skippedSteps:f.skippedSteps,totalSteps:m.stepSequence.length,remaining:m.stepSequence.filter(e=>!f.completedSteps.includes(e)&&!f.skippedSteps.includes(e)&&e!==f.currentStep),...p.length>0?{promotionCandidates:p}:{}};return s(JSON.stringify(h,null,2))}catch(e){return cu(e)?s(e.message):(r.error(`flow action step failed`,I(e)),s(`Error: ${o(e)}`))}}async function Au(e){let{getFlows:t,log:n,resolveFlowRoot:r,resolveRoots:i,toErrorText:a,toTextResponse:o}=e;try{let{registry:e,stateMachine:n,installer:a}=await t(await r()),s=e.list(),c=n.getStatus(),l={flows:s.map(e=>{let t={name:e.name,version:e.version,source:e.source,sourceType:e.sourceType,format:e.format,steps:e.manifest.steps.map(e=>e.id)};if(e.sourceType===`git`&&e.commitSha){let n=a.hasUpdates(e.installPath);return{...t,commitSha:e.commitSha,updateAvailable:n.success&&n.data?n.data.hasUpdates:void 0}}return t}),activeFlow:c.success&&c.data?{flow:c.data.flow,status:c.data.status,currentStep:c.data.currentStep,slug:c.data.slug,topic:c.data.topic,runDir:c.data.runDir}:null,allRoots:i().normalizedAllRoots,discoveredRepos:i().discoveredRepos};return o(JSON.stringify(l,null,2))}catch(e){return n.error(`flow action list failed`,I(e)),o(`Error: ${a(e)}`)}}async function ju(e,t){let{getFlows:n,log:r,resolveInstallPath:i,resolveInstructionPath:a,toErrorText:o,toTextResponse:s}=t,{name:c}=e;try{let{registry:e,installer:t}=await n(),r=e.get(c);if(!r)throw new X(`UNKNOWN_FLOW`,`Flow "${c}" not found. Use flow({ action: "list" }) to see available flows.`);let o=r.commitSha??null,l;if(r.sourceType===`git`&&r.installPath){let e=t.hasUpdates(r.installPath);l=e.success&&e.data?e.data.hasUpdates:void 0}let u={name:r.name,version:r.version,description:r.manifest.description,source:r.source,sourceType:r.sourceType,format:r.format,commitSha:o,updateAvailable:l,installPath:i(r.name,r),registeredAt:r.registeredAt,updatedAt:r.updatedAt,steps:r.manifest.steps.map(e=>({id:e.id,name:e.name,instruction:a(r,e.instruction),produces:e.produces,requires:e.requires,description:e.description})),agents:r.manifest.agents,artifactsDir:r.manifest.artifacts_dir,install:r.manifest.install};return s(JSON.stringify(u,null,2))}catch(e){return cu(e)?s(e.message):(r.error(`flow action info failed`,I(e)),s(`Error: ${o(e)}`))}}async function Mu(e,t){let{getAllRoots:n,getFlows:r,log:i,toErrorText:a,toTextResponse:o}=t,{flow:s,status:c,limit:l=50}=e,u=e=>{for(let t of[`updatedAt`,`startedAt`,`createdAt`]){let n=e[t];if(typeof n==`number`&&Number.isFinite(n))return n;if(typeof n==`string`){let e=Date.parse(n);if(!Number.isNaN(e))return e}}return null};try{let e=n(),t=[];for(let n of e){let{stateMachine:e}=await r(n),i=e.listRuns({flow:s,status:c});for(let e of i)t.push({...JSON.parse(JSON.stringify(e)),root:n.replaceAll(`\\`,`/`)})}let i=new Set,a=t.filter(e=>{let t=e.id;return i.has(t)?!1:(i.add(t),!0)});if(a.length===0)return o(`No flow runs found.`);let d=a.map((e,t)=>({run:e,index:t,recency:u(e)})).sort((e,t)=>e.recency==null&&t.recency==null?e.index-t.index:e.recency==null?1:t.recency==null?-1:t.recency===e.recency?e.index-t.index:t.recency-e.recency).map(({run:e})=>e).slice(0,l);return o(JSON.stringify({total:a.length,returned:d.length,truncated:a.length>d.length,runs:d},null,2))}catch(e){return i.error(`flow action runs failed`,I(e)),o(`Error: ${a(e)}`)}}function Nu(e){let t=e.content?.find(e=>e.type===`text`)?.text??``;if(!t)return null;try{let e=JSON.parse(t);if(typeof e.slug==`string`&&e.slug.length>0)return e.slug}catch{}return t.match(/[Ss]lug[:\s]*`?([^`\s,]+)`?/)?.[1]??null}function Pu(e,t,n,r){let i=n&&typeof n!=`function`?n:void 0,a=typeof n==`function`?n:r,o=su(e,t,i),s=U(`flow`);e.registerTool(`flow`,{title:s.title,description:`Manage development flows — list available flows, start/stop runs, navigate steps, read instructions, and install/remove/update flows. Use action parameter to select operation.`,annotations:s.annotations,inputSchema:{action:R.enum([`list`,`info`,`start`,`step`,`status`,`reset`,`read`,`runs`,`add`,`remove`,`update`]).describe(`The flow operation to perform.`),name:R.string().optional().describe(`Flow name — required for info, start, remove, update. Optional override for add.`),topic:R.string().optional().describe(`Human-readable topic for the run (used by start).`),roots:R.array(R.string()).optional().describe(`Workspace roots participating in this flow (used by start).`),advance:R.enum([`next`,`skip`,`redo`]).optional().describe(`Step navigation action — required for step.`),step:R.string().optional().describe(`Step id or name to read (used by read). Defaults to current step.`),source:R.string().optional().describe(`Git URL, local path, or "openspec" shorthand — required for add.`),token:R.string().optional().describe(`Auth token for private repos (used by add).`),filter_flow:R.string().optional().describe(`Filter runs by flow name (used by runs).`),filter_status:R.string().optional().describe(`Filter runs by status: active, completed, abandoned (used by runs).`),limit:R.number().int().positive().optional().describe(`Max runs to return (default 50).`)}},q(`flow`,async e=>{switch(e.action){case`list`:return Au(o);case`info`:return e.name?ju({name:e.name},o):o.toTextResponse(`Missing required parameter: name`);case`start`:{if(!e.name)return o.toTextResponse(`Missing required parameter: name (flow to start)`);let t=await Eu({flow:e.name,topic:e.topic,roots:e.roots},o),n=Nu(t);return n&&a&&a(n),t}case`step`:return e.advance?ku({action:e.advance},o):o.toTextResponse(`Missing required parameter: advance (next/skip/redo)`);case`status`:{let e=await Du(o);return a&&a(Nu(e)),e}case`reset`:{let e=await Ou(o);return a&&a(null),e}case`read`:return uu({step:e.step},o);case`runs`:return Mu({flow:e.filter_flow,status:e.filter_status,limit:e.limit},o);case`add`:return e.source?mu({source:e.source,name:e.name,token:e.token},o):o.toTextResponse(`Missing required parameter: source`);case`remove`:return e.name?hu({name:e.name},o):o.toTextResponse(`Missing required parameter: name`);case`update`:return e.name?gu({name:e.name},o):o.toTextResponse(`Missing required parameter: name`);default:return o.toTextResponse(`Unknown action: ${e.action}`)}}))}const Fu=F(`tools`);function Iu(e){let t=U(`evidence_map`);e.registerTool(`evidence_map`,{title:t.title,description:`Track verified/assumed/unresolved claims for complex tasks. Gate readiness: YIELD (proceed), HOLD (unknowns), HARD_BLOCK (critical gaps). Persists across calls.`,inputSchema:{action:R.enum([`create`,`add`,`update`,`get`,`gate`,`list`,`delete`]).describe(`Operation to perform`),task_id:R.string().optional().describe(`Task identifier (required for all except list)`),tier:R.enum([`floor`,`standard`,`critical`]).optional().describe(`FORGE tier (required for create)`),claim:R.string().optional().describe(`Critical-path claim text (for add)`),status:R.enum([`V`,`A`,`U`]).optional().describe(`Evidence status: V=Verified, A=Assumed, U=Unresolved`),receipt:R.string().optional().describe(`Evidence receipt: tool→ref for V, reasoning for A, attempts for U`),id:R.number().optional().describe(`Entry ID (for update)`),critical_path:R.boolean().default(!0).describe(`Whether this claim is on the critical path`),unknown_type:R.enum([`contract`,`convention`,`freshness`,`runtime`,`data-flow`,`impact`]).optional().describe(`Typed unknown classification`),safety_gate:R.enum([`provenance`,`commitment`,`coverage`]).optional().describe(`Safety gate tag: provenance (claim→evidence), commitment (user-approved), coverage (nothing dropped)`),retry_count:R.number().default(0).describe(`Retry count for gate evaluation (0 = first attempt)`),max_retries:R.number().int().min(0).optional().describe(`Maximum retries before escalating. Default: 3`),timeout_action:R.enum([`iterate`,`retry`,`manual`,`terminate`]).optional().describe(`Action to take when gate retries are exhausted. Default: manual`),cwd:R.string().optional().describe(`Working directory for evidence map storage (default: server cwd). Use root_path from forge_ground to match.`)},annotations:t.annotations},q(`evidence_map`,async({action:e,task_id:t,tier:n,claim:r,status:i,receipt:a,id:o,critical_path:s,unknown_type:c,safety_gate:l,retry_count:u,max_retries:d,timeout_action:f,cwd:p})=>{try{switch(e){case`create`:if(!t)throw Error(`task_id required for create`);if(!n)throw Error(`tier required for create`);return dt({action:`create`,taskId:t,tier:n},p),{content:[{type:`text`,text:`Created evidence map "${t}" (tier: ${n}).\n\n---\n_Next: Use \`evidence_map\` with action "add" to record critical-path claims._`}]};case`add`:{if(!t)throw Error(`task_id required for add`);if(!r)throw Error(`claim required for add`);if(!i)throw Error(`status required for add`);let e=dt({action:`add`,taskId:t,claim:r,status:i,receipt:a??``,criticalPath:s,unknownType:c,safetyGate:l},p),n=e.autoCreated?[`⚠️ Evidence map "${t}" was auto-created with tier "standard". Use \`create\` action to set a specific tier.`,``,`Added entry #${e.entry?.id} to "${t}": [${i}] ${r}`]:[`Added entry #${e.entry?.id} to "${t}": [${i}] ${r}`];return e.summary&&n.push(``,e.summary),{content:[{type:`text`,text:n.join(`
|
|
187
187
|
`)}]}}case`update`:{if(!t)throw Error(`task_id required for update`);if(o===void 0)throw Error(`id required for update`);if(!i)throw Error(`status required for update`);let e=dt({action:`update`,taskId:t,id:o,status:i,receipt:a??``},p),n=[`Updated entry #${o} in "${t}" → ${i}`];return e.summary&&n.push(``,e.summary),{content:[{type:`text`,text:n.join(`
|
|
188
188
|
`)}]}}case`get`:{if(!t)throw Error(`task_id required for get`);let e=dt({action:`get`,taskId:t},p);return e.state?{content:[{type:`text`,text:[`## Evidence Map: ${t} (${e.state.tier})`,``,e.formattedMap??`No entries.`,``,`_${e.state.entries.length} entries — created ${e.state.createdAt}_`].join(`
|
|
189
189
|
`)}]}:{content:[{type:`text`,text:`Evidence map "${t}" not found.`}]}}case`gate`:{if(!t)throw Error(`task_id required for gate`);let e=dt({action:`gate`,taskId:t,retryCount:u,maxRetries:d,timeoutAction:f},p);if(!e.gate)return{content:[{type:`text`,text:`Evidence map "${t}" not found.`}]};let n=e.gate,r=[`## FORGE Gate: **${n.verdict}**`,``,`**Reason:** ${n.reason}`,``,`**Stats:** ${n.stats.verified}V / ${n.stats.assumed}A / ${n.stats.unresolved}U (${n.stats.total} total)`];return n.action&&r.push(``,`**Recommended action:** ${n.action}`),n.retriesRemaining!==void 0&&r.push(`**Retries remaining:** ${n.retriesRemaining}`),n.summary&&r.push(``,`**Summary:** ${n.summary}`),n.warnings.length>0&&r.push(``,`**Warnings:**`,...n.warnings.map(e=>`- ⚠️ ${e}`)),n.unresolvedCritical.length>0&&r.push(``,`**Blocking entries:**`,...n.unresolvedCritical.map(e=>`- #${e.id}: ${e.claim} [${e.unknownType??`untyped`}]`)),n.safetyGates&&(r.push(``,`**Safety Gates:**`,`- Provenance: ${n.safetyGates.provenance}`,`- Commitment: ${n.safetyGates.commitment}`,`- Coverage: ${n.safetyGates.coverage}`),n.safetyGates.failures.length>0&&r.push(``,`**Safety failures:**`,...n.safetyGates.failures.map(e=>`- \u{1F6D1} ${e}`))),n.annotation&&r.push(``,`**Annotation:**`,n.annotation),e.formattedMap&&r.push(``,`---`,``,e.formattedMap),r.push(``,`---`,`_Next: ${n.verdict===`YIELD`?`Proceed to implementation.`:n.action===`iterate`?`Re-run the build loop, then evaluate the gate again.`:n.action===`retry`?`Re-evaluate the gate after refreshing evidence.`:n.action===`manual`?`Ask for human review before proceeding.`:`Abort the current path and terminate the task.`}_`),{content:[{type:`text`,text:r.join(`
|
|
190
190
|
`)}]}}case`list`:{let e=dt({action:`list`},p);return!e.states||e.states.length===0?{content:[{type:`text`,text:`No evidence maps found.`}]}:{content:[{type:`text`,text:e.states.map(e=>`- **${e.taskId}** (${e.tier}) — ${e.entries.length} entries — ${e.updatedAt}`).join(`
|
|
191
|
-
`)}]}}case`delete`:if(!t)throw Error(`task_id required for delete`);return{content:[{type:`text`,text:dt({action:`delete`,taskId:t},p).deleted?`Deleted evidence map "${t}".`:`Evidence map "${t}" not found.`}]}}}catch(e){return
|
|
192
|
-
`)}]}}catch(e){return
|
|
193
|
-
`);if(i&&t){let e=await W(t,{query:`forge classify ${n}`});c+=G(e)}return{content:[{type:`text`,text:c}]}}catch(e){return
|
|
194
|
-
`)}]}}catch(e){return
|
|
195
|
-
`)}]}}catch(e){return
|
|
191
|
+
`)}]}}case`delete`:if(!t)throw Error(`task_id required for delete`);return{content:[{type:`text`,text:dt({action:`delete`,taskId:t},p).deleted?`Deleted evidence map "${t}".`:`Evidence map "${t}" not found.`}]}}}catch(e){return Fu.error(`Evidence map error`,I(e)),K(`INTERNAL`,`Evidence map error: ${e instanceof Error?e.message:String(e)}`)}}))}function Lu(e,t){let n=U(`digest`);e.registerTool(`digest`,{title:n.title,description:`Compress multiple text sources (handoffs, debates, phase summaries) into a token-budgeted digest. Jointly ranks across all sources, pins structured fields (status, files, decisions, blockers), and allocates budget by priority weight.`,inputSchema:{sources:R.array(R.object({id:R.string().describe(`Source identifier (e.g., "phase-2-handoff")`),text:R.string().max(5e5).describe(`Source text to compress`),weight:R.number().min(0).default(1).describe(`Priority weight (higher = more budget)`)})).min(1).max(20).describe(`Text sources to compress`),query:R.string().describe(`Focus query — what matters for the next step?`),max_chars:R.number().min(100).max(5e4).default(4e3).describe(`Target budget in characters`),pin_fields:R.array(R.string()).optional().describe(`Key fields to always extract (default: status, files, decisions, blockers, next)`),segmentation:R.enum([`paragraph`,`sentence`,`line`]).default(`paragraph`).describe(`How to split text for scoring`),token_budget:R.number().min(50).max(12500).optional().describe(`Token budget — overrides max_chars (approx 4 chars per token). Use to fit output into a specific context window.`)},annotations:n.annotations},async({sources:e,query:n,max_chars:r,pin_fields:i,segmentation:a,token_budget:o})=>{try{let s=await ot(t,{sources:e,query:n,maxChars:o?o*4:r,pinFields:i,segmentation:a}),c=[`## Digest (${s.totalOriginalChars} → ${s.totalCompressedChars} chars, ${(s.ratio*100).toFixed(0)}%)`,``],l=Object.keys(s.fields);if(l.length>0){c.push(`### Extracted Fields`);for(let e of l){let t=s.fields[e];c.push(`**${e}:**`);for(let e of t)c.push(` - [${e.sourceId}] ${e.value}`)}c.push(``)}c.push(`### Compressed Content`,``,s.text),c.push(``,`### Source Stats`);for(let e of s.sourceStats)c.push(`- **${e.id}**: ${e.originalChars} → ${e.keptChars} chars (${e.segmentsKept}/${e.segmentsTotal} segments)`);return c.push(``,`---`,"_Next: Use the digest as compressed context for the next phase. Use `stash` to persist it if needed._"),{content:[{type:`text`,text:c.join(`
|
|
192
|
+
`)}]}}catch(e){return Fu.error(`Digest failed`,I(e)),K(`INTERNAL`,`Digest failed: ${e instanceof Error?e.message:String(e)}`)}})}function Ru(e,t){let n=U(`forge_classify`);e.registerTool(`forge_classify`,{title:n.title,description:`Classify FORGE tier (Floor/Standard/Critical) from target files and task description. Checks blast radius, cross-package boundaries, schema/contract patterns, and security signals. Returns tier, triggers, typed unknown seeds, and ceremony guidance.`,inputSchema:{files:R.array(R.string()).min(1).max(100).describe(`Files being modified (paths)`),task:R.string().describe(`Task description`),root_path:R.string().describe(`Root path of the codebase`),enrich:R.boolean().default(!1).optional().describe(`Append curated knowledge and graph context to output. Adds ~150-250 tokens.`)},annotations:n.annotations},q(`forge_classify`,async({files:e,task:n,root_path:r,enrich:i})=>{try{let a=await gt({files:e,task:n,rootPath:r}),o=[`## FORGE Classification: **${a.tier.toUpperCase()}**`,``];if(a.triggers.length>0){o.push(`### Triggers`);for(let e of a.triggers)o.push(`- **${e.rule}** (${e.source}): ${e.detail}`);o.push(``)}if(a.packagesCrossed.length>0&&o.push(`**Packages crossed:** ${a.packagesCrossed.join(`, `)}`),a.typedUnknownSeeds.length>0){o.push(``,`### Typed Unknown Seeds`);for(let e of a.typedUnknownSeeds)o.push(`- [${e.type}] ${e.description} → use \`${e.suggestedTool}\``)}o.push(``,`### Ceremony`);let s=a.ceremony;o.push(`- **Ground:** ${s.ground}`,`- **Build:** ${s.build}`,`- **Break:** ${s.break}`,`- **Evidence Map:** ${s.evidenceMap}`,`- **Gate:** ${s.gate}`),o.push(``,`---`,`_Next: ${a.tier===`floor`?`Proceed directly to implementation.`:"Run `forge_ground` to execute the full Ground phase."}_`);let c=o.join(`
|
|
193
|
+
`);if(i&&t){let e=await W(t,{query:`forge classify ${n}`});c+=G(e)}return{content:[{type:`text`,text:c}]}}catch(e){return Fu.error(`FORGE classify failed`,I(e)),K(`INTERNAL`,`FORGE classify failed: ${e instanceof Error?e.message:String(e)}`)}}))}function zu(e,t,n){let r=U(`stratum_card`);e.registerTool(`stratum_card`,{title:r.title,description:`Generate context cards from files — a compressed alternative to reading full files (10-100x token reduction). Tier 1 (T1): structure only (~100 tokens/file — imports, exports, functions). Tier 2 (T2): structure + query-relevant content (~300 tokens/file).`,inputSchema:{files:R.array(R.string()).min(1).max(50).describe(`Absolute file paths to generate cards for`),query:R.string().describe(`Current task query — guides relevance scoring`),tier:R.enum([`T1`,`T2`]).default(`T1`).describe(`Card tier: T1 = structural only, T2 = T1 + compressed content`),max_content_chars:R.number().min(100).max(5e3).default(800).describe(`For T2: max chars for compressed content section`)},annotations:r.annotations},async({files:e,query:r,tier:i,max_content_chars:a})=>{try{let o=await yn(t,{files:e,query:r,tier:i,maxContentChars:a,cache:n}),s=[`## STRATUM Cards (${i}) — ${o.cards.length} files`,`Total: ~${o.totalTokenEstimate} tokens (was ~${o.totalOriginalTokenEstimate}, ${(o.compressionRatio*100).toFixed(0)}% of original)`,``];for(let e of o.cards)s.push(e.card,``);return s.push(`---`,"_Next: Use these cards as context instead of reading full files. Use `compact` for deeper content extraction on specific files._"),{content:[{type:`text`,text:s.join(`
|
|
194
|
+
`)}]}}catch(e){return Fu.error(`STRATUM cards failed`,I(e)),K(`INTERNAL`,`STRATUM cards failed: ${e instanceof Error?e.message:String(e)}`)}})}function Bu(e,t,n){let r=U(`forge_ground`);e.registerTool(`forge_ground`,{title:r.title,description:`Execute the complete FORGE Ground phase in a single call. Chains: tier classification → scope map → typed unknown seeds → constraint loading → file summaries → evidence map creation. Replaces 5-15 manual tool calls.`,inputSchema:{task:R.string().describe(`Task description`),files:R.array(R.string()).min(1).max(100).describe(`Target files being modified (absolute paths)`),root_path:R.string().describe(`Root path of the codebase`),max_constraints:R.number().min(0).max(10).default(3).describe(`Max constraint entries to load from AI Kit memory`),force_tier:R.enum([`floor`,`standard`,`critical`]).optional().describe(`Force a specific tier (skips auto-classification)`),task_id:R.string().optional().describe(`Custom task ID for evidence map (auto-generated if omitted)`)},annotations:r.annotations},q(`forge_ground`,async({task:e,files:r,root_path:i,max_constraints:a,force_tier:o,task_id:s},c)=>{try{let l=await _t(t,n,{task:e,files:r,rootPath:i,maxConstraints:a,forceTier:o,taskId:s}),u=kc(c).createTask(`FORGE Ground`,3);u.progress(0,`Classification: ${l.tier}`),u.progress(1,`Files analyzed: ${l.fileSummaries.length}`),u.progress(2,`Unknowns: ${l.typedUnknownSeeds.length}`),u.complete(`FORGE Ground complete: tier=${l.tier}`);let d=[`## FORGE Ground: **${l.tier.toUpperCase()}**`,`Estimated output: ~${l.estimatedTokens} tokens`,``];if(l.classifyTriggers.length>0){d.push(`### Classification Triggers`);for(let e of l.classifyTriggers)d.push(`- **${e.rule}** (${e.source}): ${e.detail}`);d.push(``)}if(l.fileSummaries.length>0){d.push(`### Target Files`);for(let e of l.fileSummaries)d.push(`- **${e.path}** (${e.lines} lines) — exports: ${e.exports.join(`, `)||`none`} — functions: ${e.functions.join(`, `)||`none`}`);d.push(``)}if(l.typedUnknownSeeds.length>0){d.push(`### Typed Unknown Seeds`);for(let e of l.typedUnknownSeeds)d.push(`- [${e.type}] ${e.description} → \`${e.suggestedTool}\``);d.push(``)}if(l.constraints.length>0){d.push(`### Constraint Seed`);for(let e of l.constraints)d.push(`- **${e.source}** (${(e.relevance*100).toFixed(0)}%): ${e.snippet}`);d.push(``)}if(l.scopeMap){d.push(`### Scope Map: ${l.scopeMap.files.length} files (~${l.scopeMap.totalEstimatedTokens} tokens)`);for(let e of l.scopeMap.files.slice(0,5))d.push(`- ${e.path} (${(e.relevance*100).toFixed(0)}%) — ${e.reason}`);l.scopeMap.files.length>5&&d.push(`- _...and ${l.scopeMap.files.length-5} more_`),d.push(``)}l.evidenceMapTaskId&&(d.push(`**Evidence Map:** \`${l.evidenceMapTaskId}\` (initialized)`),d.push(``)),d.push(`### Ceremony Guidance`);let f=l.ceremony;return d.push(`- **Ground:** ${f.ground}`,`- **Build:** ${f.build}`,`- **Break:** ${f.break}`,`- **Evidence Map:** ${f.evidenceMap}`,`- **Gate:** ${f.gate}`),d.push(``,`---`,`_Next: ${l.tier===`floor`?`Proceed to Build phase.`:"Use `evidence_map` to track claims during Build, then `evidence_map` gate after Break."}_`),{content:[{type:`text`,text:d.join(`
|
|
195
|
+
`)}]}}catch(e){return Fu.error(`FORGE Ground failed`,I(e)),K(`INTERNAL`,`FORGE Ground failed: ${e instanceof Error?e.message:String(e)}`)}}))}const Vu=F(`tools`),Hu=R.object({id:R.string().optional().describe(`Node ID (auto-generated if omitted)`),type:R.string().describe(`Node type (entity, service, api, concept, decision)`),name:R.string().describe(`Display name`),properties:R.record(R.string(),R.unknown()).optional().describe(`Arbitrary properties`),sourceRecordId:R.string().optional().describe(`Back-link to knowledge record ID`),sourcePath:R.string().optional().describe(`Source file path`)}),Uu=R.object({id:R.string().optional().describe(`Edge ID (auto-generated if omitted)`),fromId:R.string().describe(`Source node ID`),toId:R.string().describe(`Target node ID`),type:R.string().describe(`Relationship type (depends-on, implements, calls, affects)`),weight:R.number().min(0).max(1).optional().describe(`Relationship weight`),properties:R.record(R.string(),R.unknown()).optional().describe(`Arbitrary properties`)});function Wu(e,t,n){let r=U(`graph`);e.registerTool(`graph`,{title:r.title,description:`Query the auto-populated code knowledge graph (modules, symbols, imports) to answer
|
|
196
196
|
structural questions vector search cannot.
|
|
197
197
|
|
|
198
198
|
Common flow (when you don't have a node_id yet — TWO STEPS):
|
|
@@ -211,7 +211,7 @@ Single-step read actions:
|
|
|
211
211
|
Mutating actions (use deliberately): add, delete, clear, set_community,
|
|
212
212
|
detect_communities, trace_process, delete_process.
|
|
213
213
|
|
|
214
|
-
Complements: \`symbol\` (single lookup), \`trace\` (call-chain AST), \`blast_radius\` (change impact).`,outputSchema:Bs,inputSchema:{action:R.enum([`find_nodes`,`find_edges`,`neighbors`,`traverse`,`stats`,`validate`,`add`,`delete`,`clear`,`detect_communities`,`set_community`,`trace_process`,`list_processes`,`delete_process`,`depth_traverse`,`cohesion`,`symbol360`]).describe(`Action: find_nodes (search nodes), find_edges (search edges), neighbors (direct connections), traverse (multi-hop), stats (graph overview), validate (check graph integrity), add (insert nodes/edges), delete (remove nodes), clear (remove all), detect_communities (find clusters), set_community (label a node), trace_process (persist execution flow), list_processes (list traced flows), delete_process (remove a flow), depth_traverse (bucket traversal by depth), cohesion (score a community), symbol360 (full node context)`),node_type:R.string().optional().describe(`Node type filter (for find_nodes)`),name_pattern:R.string().optional().describe(`Name substring match (for find_nodes)`),source_path:R.string().optional().describe(`Source path filter`),node_id:R.string().optional().describe(`Node ID (for neighbors, traverse, delete)`),edge_type:R.string().optional().describe(`Edge type filter`),from_id:R.string().optional().describe(`Source node ID (for find_edges)`),to_id:R.string().optional().describe(`Target node ID (for find_edges)`),direction:R.enum([`outgoing`,`incoming`,`both`]).default(`both`).describe(`Traversal direction`),max_depth:R.number().min(1).max(5).default(2).describe(`Max traversal depth`),limit:R.number().min(1).max(100).default(50).describe(`Max results`),max_tokens:R.number().min(100).max(5e4).optional().describe(`Maximum token budget for the response. When set, output is truncated to fit.`),nodes:R.array(
|
|
214
|
+
Complements: \`symbol\` (single lookup), \`trace\` (call-chain AST), \`blast_radius\` (change impact).`,outputSchema:Bs,inputSchema:{action:R.enum([`find_nodes`,`find_edges`,`neighbors`,`traverse`,`stats`,`validate`,`add`,`delete`,`clear`,`detect_communities`,`set_community`,`trace_process`,`list_processes`,`delete_process`,`depth_traverse`,`cohesion`,`symbol360`]).describe(`Action: find_nodes (search nodes), find_edges (search edges), neighbors (direct connections), traverse (multi-hop), stats (graph overview), validate (check graph integrity), add (insert nodes/edges), delete (remove nodes), clear (remove all), detect_communities (find clusters), set_community (label a node), trace_process (persist execution flow), list_processes (list traced flows), delete_process (remove a flow), depth_traverse (bucket traversal by depth), cohesion (score a community), symbol360 (full node context)`),node_type:R.string().optional().describe(`Node type filter (for find_nodes)`),name_pattern:R.string().optional().describe(`Name substring match (for find_nodes)`),source_path:R.string().optional().describe(`Source path filter`),node_id:R.string().optional().describe(`Node ID (for neighbors, traverse, delete)`),edge_type:R.string().optional().describe(`Edge type filter`),from_id:R.string().optional().describe(`Source node ID (for find_edges)`),to_id:R.string().optional().describe(`Target node ID (for find_edges)`),direction:R.enum([`outgoing`,`incoming`,`both`]).default(`both`).describe(`Traversal direction`),max_depth:R.number().min(1).max(5).default(2).describe(`Max traversal depth`),limit:R.number().min(1).max(100).default(50).describe(`Max results`),max_tokens:R.number().min(100).max(5e4).optional().describe(`Maximum token budget for the response. When set, output is truncated to fit.`),nodes:R.array(Hu).max(500).optional().describe(`Nodes to add (for action=add)`),edges:R.array(Uu).max(500).optional().describe(`Edges to add (for action=add)`),community:R.string().optional().describe(`Community label (for set_community, cohesion)`),process_id:R.string().optional().describe(`Process ID (for delete_process)`),label:R.string().optional().describe(`Label for process tracing (for trace_process)`),enrich:R.boolean().default(!1).optional().describe(`Append curated knowledge and graph context to output. Adds ~150-250 tokens.`)},annotations:r.annotations},q(`graph`,async e=>{try{let r=await xt(t,{action:e.action,nodeType:e.node_type,namePattern:e.name_pattern,sourcePath:e.source_path,nodeId:e.node_id,edgeType:e.edge_type,fromId:e.from_id,toId:e.to_id,direction:e.direction,maxDepth:e.max_depth,limit:e.limit,nodes:e.nodes,edges:e.edges,community:e.community,processId:e.process_id,label:e.label}),i=[r.summary];if(r.nodes&&r.nodes.length>0){i.push(`
|
|
215
215
|
### Nodes`);for(let e of r.nodes){let t=Object.keys(e.properties).length>0?` — ${JSON.stringify(e.properties)}`:``;i.push(`- **${e.name}** (${e.type}, id: \`${e.id}\`)${t}`)}}if(r.edges&&r.edges.length>0){i.push(`
|
|
216
216
|
### Edges`);for(let e of r.edges)i.push(`- \`${e.fromId}\` —[${e.type}]→ \`${e.toId}\`${e.weight===1?``:` (weight: ${e.weight})`}`)}if(r.stats&&(i.push(`\nNode types: ${JSON.stringify(r.stats.nodeTypes)}`),i.push(`Edge types: ${JSON.stringify(r.stats.edgeTypes)}`)),r.validation){if(i.push(`
|
|
217
217
|
### Validation`),i.push(`- **Valid**: ${r.validation.valid?`yes`:`no`}`),r.validation.danglingEdges.length>0){i.push(`- **Dangling edges**:`);for(let e of r.validation.danglingEdges)i.push(` - \`${e.edgeId}\` references missing node \`${e.missingNodeId}\``)}r.validation.orphanNodes.length>0&&i.push(`- **Orphan nodes**: ${r.validation.orphanNodes.map(e=>`\`${e}\``).join(`, `)}`)}if(r.communities){i.push(`
|
|
@@ -220,59 +220,59 @@ Complements: \`symbol\` (single lookup), \`trace\` (call-chain AST), \`blast_rad
|
|
|
220
220
|
### Processes`);for(let e of r.processes)i.push(`- **${e.label}** (id: \`${e.id}\`) — ${e.steps.length} step(s)`)}if(r.depthGroups){i.push(`
|
|
221
221
|
### Depth Groups`);for(let[e,t]of Object.entries(r.depthGroups))i.push(`- **Depth ${e}**: ${t.map(e=>`${e.name} (${e.type})`).join(`, `)}`)}if(r.cohesionScore!==void 0&&i.push(`\n**Cohesion Score**: ${(r.cohesionScore*100).toFixed(1)}%`),r.symbol360){let e=r.symbol360;i.push(`
|
|
222
222
|
### 360° Symbol View`),i.push(`- **Node**: ${e.node.name} (${e.node.type})`),i.push(`- **Community**: ${e.community??`none`}`),i.push(`- **Incoming**: ${e.incoming.length} edge(s)`),i.push(`- **Outgoing**: ${e.outgoing.length} edge(s)`),i.push(`- **Processes**: ${e.processes.length}`)}i.push("\n---\n_Next: Use `graph(traverse)` to explore connections, `graph(add)` to insert entities, `graph(symbol360)` for full node context, or `graph(detect_communities)` to find clusters._");let a=i.join(`
|
|
223
|
-
`);if(e.enrich&&n){let t=await W(n,{query:`graph ${e.action} ${e.name_pattern??e.node_id??e.community??``}`.trim(),filePath:e.source_path});a+=G(t)}return{content:[{type:`text`,text:e.max_tokens?L(a,e.max_tokens):a}],structuredContent:{nodes:(r.nodes??[]).map(e=>({id:e.id,name:e.name,type:e.type,...e.sourcePath?{sourcePath:e.sourcePath}:{}})),edges:(r.edges??[]).map(e=>({fromId:e.fromId,toId:e.toId,type:e.type})),totalNodes:r.stats?.nodeCount??r.nodes?.length??0,totalEdges:r.stats?.edgeCount??r.edges?.length??0,query:e.action}}}catch(e){return
|
|
224
|
-
`)};if(c.length===1)try{return{content:[{type:`text`,text:await l(c[0])+"\n\n---\n_Next: Use `remember` to save key findings, or `web_fetch` with a `selector` to extract a specific section._"}]}}catch(e){let t=e instanceof Error?e.message:String(e);return/HTTP [45]\d{2}/.test(t)?
|
|
223
|
+
`);if(e.enrich&&n){let t=await W(n,{query:`graph ${e.action} ${e.name_pattern??e.node_id??e.community??``}`.trim(),filePath:e.source_path});a+=G(t)}return{content:[{type:`text`,text:e.max_tokens?L(a,e.max_tokens):a}],structuredContent:{nodes:(r.nodes??[]).map(e=>({id:e.id,name:e.name,type:e.type,...e.sourcePath?{sourcePath:e.sourcePath}:{}})),edges:(r.edges??[]).map(e=>({fromId:e.fromId,toId:e.toId,type:e.type})),totalNodes:r.stats?.nodeCount??r.nodes?.length??0,totalEdges:r.stats?.edgeCount??r.edges?.length??0,query:e.action}}}catch(e){return Vu.error(`Graph query failed`,I(e)),K(`INTERNAL`,`Graph query failed: ${e instanceof Error?e.message:String(e)}`)}}))}const Gu=F(`tools:infra`);function Ku(e){let t=U(`process`);e.registerTool(`process`,{title:t.title,description:`Start, stop, inspect, list, and tail logs for in-memory managed child processes.`,inputSchema:{action:R.enum([`start`,`stop`,`status`,`list`,`logs`]).describe(`Process action to perform`),id:R.string().optional().describe(`Managed process ID`),command:R.string().optional().describe(`Executable to start`),args:R.array(R.string()).optional().describe(`Arguments for start actions`),tail:R.number().min(1).max(500).optional().describe(`Log lines to return for logs actions`)},annotations:t.annotations},q(`process`,async({action:e,id:t,command:n,args:r,tail:i})=>{try{switch(e){case`start`:if(!t||!n)throw Error(`id and command are required for start`);return{content:[{type:`text`,text:JSON.stringify(zt(t,n,r??[]))}]};case`stop`:if(!t)throw Error(`id is required for stop`);return{content:[{type:`text`,text:JSON.stringify(Vt(t)??null)}]};case`status`:if(!t)throw Error(`id is required for status`);return{content:[{type:`text`,text:JSON.stringify(Bt(t)??null)}]};case`list`:return{content:[{type:`text`,text:JSON.stringify(Lt())}]};case`logs`:if(!t)throw Error(`id is required for logs`);return{content:[{type:`text`,text:JSON.stringify(Rt(t,i))}]}}}catch(e){return Gu.error(`Process action failed`,I(e)),K(`INTERNAL`,`Process action failed: ${e instanceof Error?e.message:String(e)}`)}}))}function qu(e){let t=U(`watch`);e.registerTool(`watch`,{title:t.title,description:`Watch a directory for file changes (create/modify/delete). Actions: start (begin watching), stop (by ID), list (show active watchers). Events are emitted as structured JSON with path, event type, and timestamp.`,inputSchema:{action:R.enum([`start`,`stop`,`list`]).describe(`Watch action to perform`),path:R.string().optional().describe(`Directory path to watch for start actions`),id:R.string().optional().describe(`Watcher ID for stop actions`)},annotations:t.annotations},q(`watch`,async({action:e,path:t,id:n})=>{try{switch(e){case`start`:if(!t)throw Error(`path is required for start`);return{content:[{type:`text`,text:JSON.stringify(En({path:t}))}]};case`stop`:if(!n)throw Error(`id is required for stop`);return{content:[{type:`text`,text:JSON.stringify({stopped:Dn(n)})}]};case`list`:return{content:[{type:`text`,text:JSON.stringify(Tn())}]}}}catch(e){return Gu.error(`Watch action failed`,I(e)),K(`INTERNAL`,`Watch action failed: ${e instanceof Error?e.message:String(e)}`)}}))}function Ju(e){let t=U(`health`);e.registerTool(`health`,{title:t.title,description:`Run project health checks — verifies package.json, tsconfig, scripts, lockfile, README, LICENSE, .gitignore.`,outputSchema:xs,inputSchema:{path:R.string().optional().describe(`Root directory to check (defaults to cwd)`)},annotations:t.annotations},q(`health`,async({path:e})=>{try{let t=Ct(e),n={ok:t.checks.every(e=>e.status!==`fail`),checks:t.checks.map(e=>({name:e.name,ok:e.status===`pass`,message:e.message}))};return{content:[{type:`text`,text:JSON.stringify(t)}],structuredContent:n}}catch(e){return Gu.error(`Health check failed`,I(e)),K(`INTERNAL`,`Health check failed: ${e instanceof Error?e.message:String(e)}`)}}))}function Yu(e){let t=U(`web_fetch`);e.registerTool(`web_fetch`,{title:t.title,description:`PREFERRED web fetcher — fetch one or many URLs and convert to LLM-optimized markdown. Pass one URL or multiple for parallel fetching. Supports CSS selectors, 4 output modes (markdown/raw/links/outline), smart paragraph-boundary truncation. Strips scripts/styles/nav automatically.`,inputSchema:{urls:R.array(R.string().url()).min(1).max(10).describe('URLs to fetch (1–10). Single URL: `["https://..."]`. Multiple fetched in parallel.'),mode:R.enum([`markdown`,`raw`,`links`,`outline`]).default(`markdown`).describe(`Output mode: markdown (clean content), raw (HTML), links (extracted URLs), outline (heading hierarchy)`),selector:R.string().optional().describe(`CSS selector to extract a specific element instead of auto-detecting main content`),max_length:R.number().min(500).max(1e5).default(15e3).describe(`Max characters in output — truncates at paragraph boundaries`),include_metadata:R.boolean().default(!0).describe(`Include page title, description, and URL as a header`),include_links:R.boolean().default(!1).describe(`Append extracted links list at the end`),include_images:R.boolean().default(!1).describe(`Include image alt texts inline`),timeout:R.number().min(1e3).max(12e4).default(3e4).describe(`Request timeout in milliseconds`)},annotations:t.annotations},q(`web_fetch`,async({urls:e,mode:t,selector:n,max_length:r,include_metadata:i,include_links:a,include_images:o,timeout:s})=>{let c=e,l=async(e,c)=>{let l=await On({url:e,mode:t,selector:n,maxLength:r,includeMetadata:i,includeLinks:a,includeImages:o,timeout:s}),u=[c?`## ${c} ${l.title||`Web Page`}\n> Source: ${e}`:`## ${l.title||`Web Page`}`,``,l.content];return l.truncated&&u.push(``,`_Original length: ${l.originalLength.toLocaleString()} chars_`),u.join(`
|
|
224
|
+
`)};if(c.length===1)try{return{content:[{type:`text`,text:await l(c[0])+"\n\n---\n_Next: Use `remember` to save key findings, or `web_fetch` with a `selector` to extract a specific section._"}]}}catch(e){let t=e instanceof Error?e.message:String(e);return/HTTP [45]\d{2}/.test(t)?Gu.warn(`Web fetch failed`,{error:t}):Gu.error(`Web fetch failed`,I(e)),{...K(`INTERNAL`,`Web fetch failed: ${t}`)}}let u=c.length,d=await Promise.allSettled(c.map((e,t)=>l(e,`[${t+1}/${u}]`))),f=[],p=0;for(let e=0;e<d.length;e++){let t=d[e];if(t.status===`fulfilled`)f.push(t.value);else{p++;let n=t.reason instanceof Error?t.reason.message:String(t.reason);/HTTP [45]\d{2}/.test(n)?Gu.warn(`Web fetch failed`,{url:c[e],error:n}):Gu.error(`Web fetch failed`,{url:c[e],...I(t.reason)}),f.push(`## ❌ Failed: ${c[e]}\n\n${n}`)}}let m=`_Fetched ${d.length-p}/${d.length} URLs successfully._`;f.push(``,`---`,m,"_Next: Use `remember` to save key findings, or `web_fetch` with a `selector` to extract a specific section._");let h=f.join(`
|
|
225
225
|
|
|
226
|
-
`);return p===d.length?K(`INTERNAL`,h):{content:[{type:`text`,text:h}]}}))}function
|
|
227
|
-
`)}]}}catch(e){return
|
|
226
|
+
`);return p===d.length?K(`INTERNAL`,h):{content:[{type:`text`,text:h}]}}))}function Xu(e,t){let n=U(`guide`);e.registerTool(`guide`,{title:n.title,description:`Tool discovery — given a goal description, recommends which AI Kit tools to use and in what order. Matches against 10 predefined workflows: onboard, audit, bugfix, implement, refactor, search, context, memory, validate, analyze.`,inputSchema:{goal:R.string().describe(`What you want to accomplish (e.g., "audit this monorepo", "fix a failing test")`),max_recommendations:R.number().min(1).max(10).default(5).describe(`Maximum number of tool recommendations`)},annotations:n.annotations},q(`guide`,async({goal:e,max_recommendations:n})=>{try{let r=St(e,n,t),i=[`## Recommended Workflow: **${r.workflow}**`,r.description,``,`### Tools`,...r.tools.map(e=>{let t=e,n=t.suggestedArgs?` — \`${JSON.stringify(t.suggestedArgs)}\``:``,r=t.tokenTip?`\n 💡 ${t.tokenTip}`:``;return`${t.order}. **${t.tool}** — ${t.reason}${n}${r}`})];return r.alternativeWorkflows.length>0&&i.push(``,`_Alternative workflows: ${r.alternativeWorkflows.join(`, `)}_`),i.push(``,`---`,"_Next: Run the first recommended tool, or use `guide` again with a more specific goal._"),{content:[{type:`text`,text:i.join(`
|
|
227
|
+
`)}]}}catch(e){return Gu.error(`Guide failed`,I(e)),K(`INTERNAL`,`Guide failed: ${e instanceof Error?e.message:String(e)}`)}}))}const Zu=/^(export|import|function|class|interface|type|const|let|var|→|├|└|─|##)/,Qu=/^(decision|rationale|status|context|consequence)/i,$u=/finding|recommendation|warning|error|issue/i,ed=/status|done|decision|blocker|next|file|created|modified/i,td=/(score|relevance)/i,nd=/[/.]|\.(ts|js)$/i;function rd(e){return e.split(/\r?\n/u).map(e=>e.replace(/[ \t]+$/u,``)).join(`
|
|
228
228
|
`).replace(/\n{3,}/gu,`
|
|
229
229
|
|
|
230
|
-
`).trim()}function
|
|
230
|
+
`).trim()}function id(e,t){if(e.length<=t)return e;let n=e.split(`
|
|
231
231
|
`),r=[],i=0;for(let e of n){let n=r.length===0?e.length:e.length+1;if(i+n>t)break;r.push(e),i+=n}return r.length>0?r.join(`
|
|
232
|
-
`):e.slice(0,t).trimEnd()}function
|
|
233
|
-
`)}function
|
|
234
|
-
`))}function
|
|
235
|
-
`),.7,e.length))}function
|
|
236
|
-
`),.65,e.length))}function
|
|
237
|
-
`),.6,e.length))}function
|
|
238
|
-
`),.5,e.length))}function
|
|
239
|
-
`)}`}async function
|
|
240
|
-
`);return{content:[{type:`text`,text:`## Lessons (${y.length})\n\n${x}`}],structuredContent:{entries:y.map(({storedConfidence:e,...t})=>t),totalCount:y.length,archivedCount:g}}}function
|
|
241
|
-
`)}],structuredContent:{bufferPath:a,observations:o.length,createdCount:l.length,skippedCount:u.length,candidates:s.map(e=>({title:e.title,detector:e.detector,confidence:e.confidence,tags:e.tags})),created:l,skipped:u}}}function
|
|
242
|
-
`)}function
|
|
243
|
-
`)}function
|
|
244
|
-
`)}async function
|
|
232
|
+
`):e.slice(0,t).trimEnd()}function ad(e,t,n){return id(e,Math.max(1,Math.floor(n*t)))}function od(e,t){if(e.length<50)return e;let n=rd(t);return!n||n.length<e.length*.2?e:n}function sd(e,t,n){let r=new Set;for(let n=0;n<Math.min(t,e.length);n+=1)r.add(n);return e.forEach((e,t)=>{n(e,t)&&r.add(t)}),e.filter((e,t)=>r.has(t)).join(`
|
|
233
|
+
`)}function cd(e,t){e.includes(t)||e.push(t)}function ld(e){return od(e,ad(sd(e.split(/\r?\n/u),3,e=>Zu.test(e)||e.startsWith(`- `)),.6,e.length))}function ud(e){let t=e.split(/\r?\n/u),n=[];return t.forEach((e,t)=>{if(t<5||td.test(e)||nd.test(e)||/^Content:/i.test(e)){if(/^Content:/i.test(e)){cd(n,`Content: ${e.replace(/^Content:\s*/i,``).trim().slice(0,200)}`);return}cd(n,e)}}),od(e,n.join(`
|
|
234
|
+
`))}function dd(e){let t=e.split(/\r?\n/u),n=new Set;for(let e=0;e<t.length&&t[e].trim()!==``;e+=1)n.add(e);return t.forEach((e,t)=>{(e.startsWith(`- `)||e.startsWith(`* `)||Qu.test(e))&&n.add(t)}),od(e,ad(t.filter((e,t)=>n.has(t)).join(`
|
|
235
|
+
`),.7,e.length))}function fd(e){let t=e.split(/\r?\n/u),n=new Set,r=!1;for(let e=0;e<Math.min(2,t.length);e+=1)n.add(e);return t.forEach((e,t)=>{if(e.startsWith("```")){n.add(t),r=!r;return}(r||e.startsWith(`##`)||e.startsWith(`- `)||e.startsWith(`* `))&&n.add(t)}),od(e,ad(t.filter((e,t)=>n.has(t)).join(`
|
|
236
|
+
`),.65,e.length))}function pd(e){return od(e,ad(e.split(/\r?\n/u).filter(e=>e.startsWith(`#`)||e.startsWith(`- `)||/\d/.test(e)||/\d+%/.test(e)||$u.test(e)).join(`
|
|
237
|
+
`),.6,e.length))}function md(e){return od(e,ad(e.split(/\r?\n/u).filter(e=>e.startsWith(`- `)||e.startsWith(`* `)||ed.test(e)).join(`
|
|
238
|
+
`),.5,e.length))}function hd(e,t){switch(e){case`file-card`:return ld(t);case`search-result`:return ud(t);case`decision`:return dd(t);case`pattern`:return fd(t);case`analysis`:return pd(t);case`step-summary`:return md(t)}}const gd={decision:6,pattern:5,"file-card":4,analysis:3,"search-result":2,"step-summary":1},_d={"search-result":864e5,"file-card":1728e5,analysis:1728e5,"step-summary":2592e5,decision:6048e5,pattern:6048e5},vd={implementer:{name:`implementer`,contextTypes:[`file-card`,`decision`,`pattern`],priority:{...gd}},documenter:{name:`documenter`,contextTypes:[`decision`,`pattern`,`step-summary`],priority:{...gd}},reviewer:{name:`reviewer`,contextTypes:[`file-card`,`search-result`,`decision`,`pattern`,`step-summary`,`analysis`],priority:{...gd}},researcher:{name:`researcher`,contextTypes:[`search-result`,`decision`,`analysis`],priority:{...gd}},debugger:{name:`debugger`,contextTypes:[`file-card`,`search-result`,`pattern`,`analysis`],priority:{...gd}}};function yd(e){return vd[e]}function bd(e,t,n=Date.now()){let r=n-t;if(r<36e5)return!1;let i=_d[e];return i==null?!1:r>i}function xd(e,t,n){if(n<=0)return[];let r=new Set(t.contextTypes),i=e.filter(e=>r.has(e.type)).map((e,t)=>({entry:e,index:t})).sort((e,n)=>{let r=t.priority[n.entry.type]-t.priority[e.entry.type];return r===0?e.index-n.index:r}),a=[],o=0;for(let{entry:e}of i){let t=hd(e.type,e.content),r=t.length;o+r>n||(a.push({type:e.type,content:t}),o+=r)}return a}function Sd(e,t,n){if(!(!e||typeof e!=`string`)&&!(e.includes(`..`)||e.startsWith(`/`)||e.startsWith(`[`)))return{type:`resource_link`,uri:`aikit://curated/${e}`,name:t??e,mimeType:`text/markdown`,...n?{description:n}:{}}}function Cd(e){let t=new Set,n=[];for(let r of e){let e=Sd(r.path,r.title,r.category?`[${r.category}]`:void 0);e&&!t.has(e.uri)&&(t.add(e.uri),n.push(e))}return n}function wd(e){if(e.startsWith(`.ai/curated/`))return e.slice(12)}const Td=F(`tools`),Ed=R.enum([`remember`,`read`,`update`,`forget`,`list`,`history`,`diff`,`recover`,`orphaned`,`withdraw`,`flush`,`flagged`,`lesson`]),Dd=R.string().min(3).max(120).describe(`Short descriptive title for the knowledge entry`),Od=R.string().min(10).max(1e5),kd=R.string().regex(/^[a-z][a-z0-9-]*$/).describe(`Category slug (e.g., "decisions", "patterns", "conventions", "api-contracts")`),Ad=R.array(R.string()).default([]).describe(`Optional tags for filtering`),jd=R.string().describe(`Relative path within .ai/curated/ (e.g., "decisions/use-lancedb.md")`),Md=R.string().min(3),Nd=R.object({title:Dd,content:Od.describe(`The markdown content to store`),category:kd,tags:Ad,force:R.boolean().optional().describe(`When true, supersede flagged similar entries without waiting for confirmation`)}),Pd=R.object({path:jd}),Fd=R.object({path:jd,content:Od.describe(`New markdown content to replace existing content`),reason:Md.max(1e3).describe(`Why this update is being made (recorded in changelog)`)}),Id=R.object({path:R.string().describe(`Relative path within .ai/curated/ (e.g., "decisions/deprecated-approach.md")`),reason:Md.describe(`Why this entry is being removed`)}),Ld=R.object({category:R.string().optional().describe(`Filter by category (e.g., "decisions", "patterns")`),tag:R.string().optional().describe(`Filter by tag`)}),Rd=R.enum([`create`,`confirm`,`contradict`,`list-lessons`,`auto-observe`,`prune`,`group`,`promote`,`demote`]),zd=R.enum([`confidence`,`recent`]),Bd=R.number().int().min(0).max(100).describe(`Lesson confidence from 0-100`),Vd=R.object({action:Ed.describe(`Knowledge operation to perform`),title:Dd.optional(),content:Od.optional(),category:kd.optional(),tags:R.array(R.string()).optional().describe(`Optional tags for remember`),path:jd.optional(),reason:Md.max(1e3).optional(),scope:R.enum([`curated`,`flow`]).optional().describe(`Storage scope: curated (default) or flow-scoped ephemeral context`),profile:R.string().optional().describe(`Role profile for withdraw filtering (e.g., "implementer", "reviewer", "debugger")`),budget:R.number().int().min(100).max(5e4).optional().describe(`Maximum character budget for withdraw results (default: 6000)`),token_budget:R.number().int().min(50).max(12500).optional().describe(`Token budget (overrides budget). Approx 4 chars per token.`),tag:R.string().optional().describe(`Filter by tag when action="list"`),id:jd.optional().describe(`Alias for path when action="lesson"`),subAction:Rd.optional().describe(`Lesson sub-action when action="lesson"`),bufferPath:R.string().optional().describe(`Optional observation buffer path for lesson auto-observe`),context:Od.optional().describe(`What happened (the situation) for lesson creation`),insight:Od.optional().describe(`What was learned (the lesson) for lesson creation`),evidence:Od.optional().describe(`Proof or justification for lesson creation`),confidence:Bd.optional(),minConfidence:Bd.optional().describe(`Minimum confidence when listing lessons`),topic:R.string().optional().describe(`Topic filter when listing lessons`),sortBy:zd.optional().describe(`Sort lessons by confidence or recency`),includeArchived:R.boolean().optional().describe(`Include auto-archived lessons in list-lessons`),maxConfidence:Bd.optional().describe(`Prune lessons below this effective confidence`),minIdleDays:R.number().int().min(1).optional().describe(`Minimum idle days required before pruning a lesson`),safetyDays:R.number().int().min(0).optional().describe(`Never prune if accessed within this many days`),maxPrune:R.number().int().min(1).max(1e3).optional().describe(`Maximum number of lessons to prune in one run`),similarityThreshold:R.number().min(0).max(1).optional().describe(`Minimum Jaccard similarity required to group lesson titles`),minGroupSize:R.number().int().min(2).max(1e3).optional().describe(`Minimum number of lessons required to form a group`),maxGroups:R.number().int().min(1).max(1e3).optional().describe(`Maximum number of lesson groups to create in one run`),minWorkspaces:R.number().int().min(2).max(1e3).optional().describe(`Minimum number of distinct workspaces required before promoting a lesson`),minAvgConfidence:Bd.optional().describe(`Minimum average lesson confidence required before promoting a lesson`),dryRun:R.boolean().optional().describe(`Preview the operation without modifying stored lessons`),limit:R.number().int().min(1).max(100).optional().describe(`Maximum history entries to return (for action="history", default: 20)`),force:R.boolean().optional().describe(`When true, supersede flagged similar entries without waiting for confirmation`),from_sha:R.string().optional().describe(`Start SHA for diff (older version). If omitted with to_sha, shows full content.`),to_sha:R.string().optional().describe(`End SHA for diff (newer version). If omitted, uses the latest two versions.`),max_tokens:R.number().min(100).max(5e4).optional().describe(`Maximum token budget for the response. When set, output is truncated to fit.`),enrich:R.boolean().default(!1).optional().describe(`Append curated knowledge and graph context to output. Adds ~150-250 tokens.`)});function Hd(e,t){return[`knowledge`,e,t.path,t.id,t.title,t.topic,t.category,t.tag,t.profile].filter(e=>typeof e==`string`&&e.length>0).join(` `)}async function Ud(e,t,n){let r=e.content.find(e=>e.type===`text`);if(!r)return e;let i=r.text;if(t.enrich&&n){let e=await W(n,{query:Hd(t.action,t)});i+=G(e)}return t.max_tokens&&(i=L(i,t.max_tokens)),{...e,content:e.content.map(e=>e.type===`text`?{...e,text:i}:e)}}const Wd=R.object({title:Dd,context:Od.describe(`What happened (the situation)`),insight:Od.describe(`What was learned (the lesson)`),evidence:Od.describe(`Proof or justification`),confidence:Bd.default(50),tags:Ad.optional().default([])}),Gd=R.object({path:jd.optional(),id:jd.optional(),reason:Md.max(1e3).optional()}).refine(e=>!!(e.path??e.id),{message:`path or id is required`,path:[`path`]}),Kd=R.object({topic:R.string().optional(),minConfidence:Bd.optional(),tag:R.string().optional(),tags:R.array(R.string()).optional(),sortBy:zd.default(`confidence`),includeArchived:R.boolean().default(!1)}),qd=R.object({bufferPath:R.string().optional()}),Jd=R.object({maxConfidence:Bd.optional(),minIdleDays:R.number().int().min(1).optional(),safetyDays:R.number().int().min(0).optional(),maxPrune:R.number().int().min(1).max(1e3).optional(),dryRun:R.boolean().default(!0)}),Yd=R.object({similarityThreshold:R.number().min(0).max(1).optional(),minGroupSize:R.number().int().min(2).max(1e3).optional(),maxGroups:R.number().int().min(1).max(1e3).optional(),dryRun:R.boolean().default(!0)}),Xd=R.object({minWorkspaces:R.number().int().min(2).max(1e3).optional(),minAvgConfidence:Bd.optional(),similarityThreshold:R.number().min(0).max(1).optional(),dryRun:R.boolean().default(!0)});function Zd(e,t,i,c){r(e,t,i);let l=e.memoryMetaGet(t);if(!l)return;let u=a(l,{...n,...c});return u?(s(e,t,u),o(e,t,i)??e.memoryMetaGet(t)):l}function Qd(e,t){return`\n\n### ${e}\n${t.map(e=>`- **${e.title}** (${e.id}) — similarity ${e.similarity.toFixed(3)}`).join(`
|
|
239
|
+
`)}`}async function $d(e,t,n,r){if(typeof e.list!=`function`||typeof e.read!=`function`)return[];let i=c(r),a=await e.list({category:n});return a.length===0?[]:g(t,await Promise.all(a.slice(0,i.maxCompare).map(async t=>{let n=await e.read(t.path);return{id:t.path,title:n.title,content:n.content,path:t.path}})),i)}function ef(e,t,n){return{superseded:e.filter(e=>n||e.similarity>=t).map(e=>({id:e.entryId,title:e.title,similarity:e.similarity})),supersessionCandidates:n?[]:e.filter(e=>e.similarity<t).map(e=>({id:e.entryId,title:e.title,similarity:e.similarity}))}}const tf={decisions:`decision`,patterns:`pattern`,conventions:`pattern`,context:`analysis`,session:`step-summary`},nf=new Set([`decision`,`pattern`,`file-card`,`analysis`,`search-result`,`step-summary`]);function rf(e){if(!e)return`analysis`;let t=tf[e]??e;return nf.has(t)?t:`analysis`}function af(e){let t=[...new Set(e.issues.filter(e=>e.code===`invalid_type`&&/received undefined$/i.test(e.message)).map(e=>e.path.join(`.`)).filter(e=>e.length>0))];if(t.length>0)return`Missing required fields: ${t.join(`, `)}`;let n=e.issues.map(e=>`${e.path.length>0?`${e.path.join(`.`)}: `:``}${e.message}`).join(`; `);return n.length>0?`Invalid parameters: ${n}`:`Invalid parameters.`}function of(e,t){return e??t??``}function sf(e){return[...new Set([...e??[],`lesson`])]}function cf(e,t,n){if(e)return e.memoryMetaCreate(t,`working`),e.memoryMetaUpdateConfidence(t,n),e.memoryMetaGet(t)}function lf(e,t,n,r=_){if(!e)return;let i=v(r);e.memoryMetaCreate(t,`working`),e.memoryMetaTouch(t);let a=n??e.memoryMetaGet(t)?.confidence??50,o=Math.min(100,a+i.implicitUseIncrement);return e.memoryMetaUpdateConfidence(t,o),e.memoryMetaGet(t)}function uf(e){let t=e.matchAll(/(?:\.ai\/curated\/)?(lessons\/[A-Za-z0-9._/%-]+\.md)/g);return[...new Set(Array.from(t,e=>e[1]))]}async function df(e,t,n){let r=await e.read(n),i=d(r.content),a=t?.memoryMetaGet(n)?.confidence??i.confidence??50;return{entry:r,confidence:a,meta:cf(t,n,a)??t?.memoryMetaGet(n)}}function ff(e){if(typeof e!=`object`||!e)return e;let t=e;if(t.title)return e;let n=typeof t.topic==`string`&&t.topic||typeof t.insight==`string`&&t.insight||``;if(!n)return e;let r=n.length<=120?n:`${n.slice(0,117)}...`;return{...t,title:r}}async function pf(e,{curated:t,stateStore:n,resourceNotifier:r}){let i=ff(e),{title:a,context:o,insight:s,evidence:c,confidence:l,tags:u}=Wd.parse(i),d=x({title:a,context:o,insight:s,evidence:c,confidence:l,tags:u}),f=await t.remember(a,d,`lessons`,sf(u));return cf(n,f.path,l),r&&r.notifyAfterCuratedWrite(f.path).catch(()=>{}),{content:[{type:`text`,text:`Recorded lesson: **${a}**\n\nStored at \`.ai/curated/${f.path}\` with confidence ${l}/100.`}],structuredContent:{path:f.path,confidence:l,category:`lessons`,tags:sf(u)}}}async function mf(e,t,n){let{curated:r,stateStore:i,resourceNotifier:a,retentionConfig:o,consolidationConfig:s,lessonConfig:c}=n,u=Gd.parse(e);if(t===`contradict`&&!u.reason)throw new R.ZodError([{code:`custom`,path:[`reason`],message:`reason is required`}]);let d=of(u.path,u.id),f=v(c??_);i&&Zd(i,d,o,s);let{entry:p,confidence:m}=await df(r,i,d),g=l(m,t,f),y=h(p.content,g),b=t===`confirm`?u.reason??`Confirmed lesson confidence`:`Contradicted lesson confidence: ${u.reason}`,x=await r.update(d,y,b);return i&&i.memoryMetaUpdateConfidence(d,g),a&&a.notifyAfterCuratedWrite(d).catch(()=>{}),{content:[{type:`text`,text:`${t===`confirm`?`Confirmed`:`Contradicted`} lesson: \`${d}\`\n\nConfidence ${m}/100 → ${g}/100.`}],structuredContent:{path:x.path,confidence:g,previousConfidence:m,version:x.version}}}async function hf(e,{curated:t,stateStore:n,lessonConfig:r}){let{topic:i,minConfidence:a,tag:o,tags:s,sortBy:c,includeArchived:l}=Kd.parse(e),u=sf([...s??[],...o?[o]:[]]),d=v(r??_),p=await t.list({category:`lessons`,...o?{tag:o}:{}}),h=await Promise.all(p.filter(e=>e.tags.includes(`lesson`)).map(async e=>{let{confidence:r,meta:i}=await df(t,n,e.path),a=i??n?.memoryMetaGet(e.path);a&&a.supersededBy===null&&f(a,d)&&n?.memoryMetaSetSuperseded(e.path,b);let o=n?.memoryMetaGet(e.path)??a,s=o?.createdAt??e.created,c=o?.confidence??r,l=m(c,o?.lastAccessedAt,s,d),u=o?.lastAccessedAt??o?.createdAt??null;return{path:e.path,title:e.title,category:e.category,tags:e.tags,version:e.version,preview:e.contentPreview,confidence:l,storedConfidence:c,createdAt:s,lastAccessedAt:o?.lastAccessedAt??null,recency:u,archived:o?.supersededBy===b,supersededBy:o?.supersededBy??null}})),g=h.filter(e=>e.archived).length,y=h.filter(e=>l?!0:e.supersededBy===null).filter(e=>a===void 0?!0:e.confidence>=a).filter(e=>u.length===0?!0:u.every(t=>e.tags.includes(t))).filter(e=>i?`${e.title}\n${e.preview}\n${e.tags.join(` `)}`.toLowerCase().includes(i.toLowerCase()):!0).sort((e,t)=>c===`recent`?Date.parse(t.recency??``)-Date.parse(e.recency??``)||t.confidence-e.confidence:t.confidence-e.confidence||Date.parse(t.recency??``)-Date.parse(e.recency??``));if(y.forEach(e=>{lf(n,e.path,e.storedConfidence,d)}),y.length===0)return{content:[{type:`text`,text:`No lessons matched the requested filters.`}],structuredContent:{entries:[],totalCount:0,archivedCount:g}};let x=y.map(e=>{let t=e.recency?` | recent ${e.recency}`:``;return`- **${e.title}** (${e.confidence}/100)${t}\n \`${e.path}\` — ${e.preview.slice(0,80)}…`}).join(`
|
|
240
|
+
`);return{content:[{type:`text`,text:`## Lessons (${y.length})\n\n${x}`}],structuredContent:{entries:y.map(({storedConfidence:e,...t})=>t),totalCount:y.length,archivedCount:g}}}function gf(e){if(e){let t=P(e);return A(t)?t:void 0}return ue(Rn(),{withFileTypes:!0}).filter(e=>e.isFile()&&e.name.startsWith(`aikit-obs-`)&&e.name.endsWith(`.jsonl`)).map(e=>N(Rn(),e.name)).sort((e,t)=>pe(t).mtimeMs-pe(e).mtimeMs)[0]}function _f(e,t){return t.map(t=>({path:t.path,title:t.title,similarity:y(e,t.title)})).filter(e=>e.similarity>.8).sort((e,t)=>t.similarity-e.similarity)[0]}async function vf(e,{curated:t,stateStore:n,resourceNotifier:r}){let{bufferPath:i}=qd.parse(e),a=gf(i);if(!a)return{content:[{type:`text`,text:`No observation buffer found for auto-observe.`}],structuredContent:{bufferPath:null,observations:0,createdCount:0,skippedCount:0,candidates:[]}};let o=Ci(M(a,`utf8`)),s=Si(o,Qr),c=await t.list({category:`lessons`}),l=[],u=[];try{for(let e of s){let i=_f(e.title,c);if(i){u.push({title:e.title,path:i.path,similarity:i.similarity});continue}let a=x({title:e.title,context:e.context,insight:e.insight,evidence:e.evidence,confidence:e.confidence,tags:e.tags}),o=await t.remember(e.title,a,`lessons`,sf(e.tags));cf(n,o.path,e.confidence),l.push({path:o.path,title:e.title,detector:e.detector}),c.push({path:o.path,title:e.title,category:`lessons`,tags:sf(e.tags),version:1,created:new Date().toISOString(),updated:new Date().toISOString(),contentPreview:e.insight}),r&&r.notifyAfterCuratedWrite(o.path).catch(()=>{})}}finally{try{me(a)}catch{}}let d=[`Auto-observe processed ${o.length} observations from \`${a}\`.`,`Created ${l.length} lessons and skipped ${u.length} duplicates from ${s.length} candidates.`];return l.length>0&&(d.push(``,`Created:`),d.push(...l.map(e=>`- **${e.title}** (${e.path})`))),u.length>0&&(d.push(``,`Skipped:`),d.push(...u.map(e=>`- **${e.title}** matched ${e.path} (${e.similarity.toFixed(2)})`))),{content:[{type:`text`,text:d.join(`
|
|
241
|
+
`)}],structuredContent:{bufferPath:a,observations:o.length,createdCount:l.length,skippedCount:u.length,candidates:s.map(e=>({title:e.title,detector:e.detector,confidence:e.confidence,tags:e.tags})),created:l,skipped:u}}}function yf(e){let t=[`Lesson prune ${e.dryRun?`preview`:`completed`}: ${e.pruned.length} lessons selected.`,`Skipped ${e.skipped} lessons.`];return e.pruned.length>0&&(t.push(``,`Pruned:`),t.push(...e.pruned.map(e=>`- ${e}`))),t.join(`
|
|
242
|
+
`)}function bf(e){let t=[`Lesson grouping ${e.dryRun?`preview`:`completed`}: ${e.groupsCreated} groups, ${e.lessonsGrouped} lessons.`];return e.groups.length>0&&(t.push(``,`Groups:`),t.push(...e.groups.map(e=>`- ${e.label}: ${e.members.join(`, `)}`))),t.join(`
|
|
243
|
+
`)}function xf(e,n){let r=e;return new t(n,r.store,r.embedder)}function Sf(e,t){let n=e.candidates.filter(e=>e.action===`promote`),r=e.candidates.filter(e=>e.action===`skip`),i=[`Lesson promotion ${t?`preview`:`completed`}: ${n.length} candidates ready.`,`Skipped ${r.length} candidates.`];return n.length>0&&(i.push(``,`Candidates:`),i.push(...n.map(e=>`- ${e.insight} (${e.foundIn.join(`, `)}) avg ${e.avgConfidence}/100`))),r.length>0&&(i.push(``,`Skipped:`),i.push(...r.map(e=>`- ${e.insight}: ${e.reason}`))),e.promoted.length>0&&(i.push(``,`Promoted:`),i.push(...e.promoted.map(e=>`- ${e}`))),i.join(`
|
|
244
|
+
`)}async function Cf(e,t){switch(e.subAction??`create`){case`create`:return pf(e,t);case`confirm`:return mf(e,`confirm`,t);case`contradict`:return mf(e,`contradict`,t);case`list-lessons`:return hf(e,t);case`auto-observe`:return vf(e,t);case`prune`:{if(!t.stateStore)return K(`VALIDATION`,`StateStore required for lesson/prune`);let n=Jd.parse(e),r=await T(t.curated,t.stateStore,{maxConfidence:n.maxConfidence,minIdleDays:n.minIdleDays,safetyDays:n.safetyDays,maxPrune:n.maxPrune,dryRun:n.dryRun},t.lessonConfig?v(t.lessonConfig):_);return{content:[{type:`text`,text:yf(r)}],structuredContent:r}}case`group`:{if(!t.stateStore)return K(`VALIDATION`,`StateStore required for lesson/group`);let n=Yd.parse(e),r=await w(t.curated,t.stateStore,{similarityThreshold:n.similarityThreshold,minGroupSize:n.minGroupSize,maxGroups:n.maxGroups,dryRun:n.dryRun});return{content:[{type:`text`,text:bf(r)}],structuredContent:r}}case`promote`:{if(!Pe())return{content:[{type:`text`,text:`Promotion requires user-level install (not workspace-scoped).`}]};let n=Xd.parse(e),r={minWorkspaces:n.minWorkspaces??ne.minWorkspaces,minAvgConfidence:n.minAvgConfidence??ne.minAvgConfidence,similarityThreshold:n.similarityThreshold??ne.similarityThreshold,dryRun:n.dryRun},i=await E(te(await O(),r),xf(t.curated,D()),r);return{content:[{type:`text`,text:Sf(i,r.dryRun)}],structuredContent:i}}case`demote`:{if(!Pe())return{content:[{type:`text`,text:`Demotion requires user-level install.`}]};let n=of(e.path,e.id);if(!n)return{content:[{type:`text`,text:`Missing required "path" or "id" parameter for demote.`}]};let r=await ee(xf(t.curated,D()),n);return{content:[{type:`text`,text:r.removed?`Demoted: ${n}`:`Not found in global: ${n}`}],structuredContent:r}}}}async function wf(e,t){if(e.scope===`flow`){let{flowContextAdapter:n,stateStore:r}=t;if(!n)return{content:[{type:`text`,text:`Flow context not available.`}]};let{title:i,content:a,category:o}=Nd.parse(e),s=`${rf(o)}/${i.toLowerCase().replace(/[^a-z0-9]+/g,`-`).slice(0,60)}.md`;return await n.write(s,`# ${i}\n\n${a}`),r?.memoryMetaCreate(s,`working`),{content:[{type:`text`,text:`Deposited flow context: **${i}** at \`${s}\``}]}}let{curated:n,policyStore:r,evolutionCollector:i,resourceNotifier:a,stateStore:o,supersessionConfig:s}=t,{title:l,content:u,category:d,tags:f,force:m=!1}=Nd.parse(e),h=c(s),g=await $d(n,u,d,h),_=await n.remember(l,u,d,f);o?.memoryMetaCreate(_.path,`working`);let v=ef(g,h.autoThreshold,m);if(o)for(let e of v.superseded)p(o,e.id,_.path);let y=``;if(r){let e=r.classify(l,u,f);i&&i.recordClassification(l,e.matchingRules.map(e=>e.ruleId),e.pushRecommended),e.matchingRules.length>0&&(y=`\n\n### Classification Signals\n${e.matchingRules.map(e=>` - **${e.ruleId}** (${e.category}, weight: ${e.pushWeight}) — matched: ${e.matchedPatterns.join(`, `)}`).join(`
|
|
245
245
|
`)}\n- **Push recommended**: ${e.pushRecommended?`yes`:`no`} (max weight: ${e.maxPushWeight})`,e.pushRecommended&&(y+=`
|
|
246
246
|
|
|
247
|
-
> 💡 This entry matches push rules. Consider \`er_push\` to share with Enterprise RAG.`))}a&&a.notifyAfterCuratedWrite(_.path).catch(()=>{});let b=
|
|
248
|
-
`),l=
|
|
249
|
-
`);return{content:[{type:`text`,text:`## Flow Context (${e.length} entries)\n\n${a}`}],structuredContent:{entries:t.map(({entry:e,retentionMeta:t})=>({path:e.path,size:e.size,...t?{retentionScore:t.retentionScore,tier:t.tier}:{}})),totalCount:e.length}}}let{category:a,tag:s}=
|
|
250
|
-
`),f=
|
|
251
|
-
`);return{content:[{type:`text`,text:`## History for \`${n}\` (${i.length} entries)\n\n${a}\n\n_Use \`knowledge({ action: "diff", path: "${n}", from_sha: "...", to_sha: "..." })\` to compare versions._`}]}}async function
|
|
252
|
-
`);return{content:[{type:`text`,text:`## Orphaned Knowledge Entries (${n.length})\n\nThese entries exist in git but are missing from the filesystem:\n\n${r}\n\n_Use \`knowledge({ action: "recover", path: "..." })\` to restore any of these entries._`}]}}async function
|
|
247
|
+
> 💡 This entry matches push rules. Consider \`er_push\` to share with Enterprise RAG.`))}a&&a.notifyAfterCuratedWrite(_.path).catch(()=>{});let b=Sd(_.path,l,`[${d}]`),x=v.superseded.length>0?Qd(`Superseded Entries`,v.superseded):``,S=v.supersessionCandidates.length>0?Qd(`Supersession Suggestions`,v.supersessionCandidates):``;return{content:[{type:`text`,text:`Remembered: **${l}**\n\nStored at \`.ai/curated/${_.path}\` and indexed for semantic search.${y}${x}${S}\n\n---\n_Next: Use \`search\` to verify the entry is findable, or \`knowledge({ action: "list" })\` to see all curated entries._`},...b?[b]:[]],structuredContent:{path:_.path,superseded:v.superseded,supersessionCandidates:v.supersessionCandidates}}}async function Tf(e,{curated:t,stateStore:n,retentionConfig:r,consolidationConfig:i}){let{path:a}=Pd.parse(e),o=await t.read(a),s=n?Zd(n,a,r,i):void 0,c=[`## ${o.title}`,`- **Path**: .ai/curated/${a}`,`- **Category**: ${o.category}`,o.tags.length?`- **Tags**: ${o.tags.join(`, `)}`:null,`- **Version**: ${o.version}`,`- **Created**: ${o.created}`,o.updated===o.created?null:`- **Updated**: ${o.updated}`,s?`- **Tier**: ${s.tier}`:null,s?`- **Retention**: ${s.retentionScore.toFixed(3)}`:null,``].filter(e=>e!==null).join(`
|
|
248
|
+
`),l=Sd(a,o.title,`[${o.category}]`);return{content:[{type:`text`,text:`${c}\n${o.content}\n\n---\n_Next: Use \`knowledge({ action: "update", ... })\` to modify this entry, or \`search\` to find related entries._`},...l?[l]:[]]}}async function Ef(e,{curated:t,resourceNotifier:n}){let{path:r,content:i,reason:a}=Fd.parse(e),o=await t.update(r,i,a);return n&&n.notifyAfterCuratedWrite(r).catch(()=>{}),{content:[{type:`text`,text:`Updated: \`.ai/curated/${o.path}\` → version ${o.version}\n\nReason: ${a}\n\n---\n_Next: Use \`knowledge({ action: "read", path: "${o.path}" })\` to verify the updated content, or \`search\` to test searchability._`}]}}async function Df(e,{curated:t,resourceNotifier:n}){let{path:r,reason:i}=Id.parse(e),a=P(t.curatedDir,r);if(A(a))try{$e(`forget`,[{path:a,content:M(a,`utf-8`)}],`forget: ${r}`)}catch{}let o=await t.forget(r,i);return Td.info(`Forgot entry`,{path:o.path,reason:i}),n&&(n.notifyAfterCuratedWrite().catch(()=>{}),n.notifyResourceListChanged().catch(()=>{})),{content:[{type:`text`,text:`Forgotten: \`.ai/curated/${o.path}\`\n\nRemoved from disk and vector store.\nReason: ${i}\n\n---\n_Next: Use \`knowledge({ action: "list" })\` to verify removal, or \`search\` to confirm the entry is no longer returned._`}]}}async function Of(e,{curated:t,flowContextAdapter:n,stateStore:r,retentionConfig:i}){if(e.scope===`flow`){if(!n)return{content:[{type:`text`,text:`Flow context not available.`}]};let e=await n.list();if(e.length===0)return{content:[{type:`text`,text:`No flow context entries.`}]};let t=e.map(e=>({entry:e,retentionMeta:r?o(r,e.path,i):void 0})),a=t.map(({entry:e,retentionMeta:t})=>{let n=t?`, tier ${t.tier}, retention ${t.retentionScore.toFixed(3)}`:``;return`- \`${e.path}\` (${e.size} bytes${n})`}).join(`
|
|
249
|
+
`);return{content:[{type:`text`,text:`## Flow Context (${e.length} entries)\n\n${a}`}],structuredContent:{entries:t.map(({entry:e,retentionMeta:t})=>({path:e.path,size:e.size,...t?{retentionScore:t.retentionScore,tier:t.tier}:{}})),totalCount:e.length}}}let{category:a,tag:s}=Ld.parse(e),c=await t.list({category:a,tag:s}),l=c.map(e=>({entry:e,retentionMeta:r?o(r,e.path,i):void 0})),u={entries:l.map(({entry:e,retentionMeta:t})=>({path:e.path,title:e.title,category:e.category,tags:e.tags,version:e.version,preview:e.contentPreview?.slice(0,120)??``,...t?{retentionScore:t.retentionScore,tier:t.tier}:{}})),totalCount:c.length};if(c.length===0)return{content:[{type:`text`,text:`No curated knowledge entries found.`+(a?` (category: ${a})`:``)+(s?` (tag: ${s})`:``)}],structuredContent:u};let d=l.map(({entry:e,retentionMeta:t})=>{let n=e.tags.length>0?` [${e.tags.join(`, `)}]`:``,r=t?` | tier ${t.tier} | retention ${t.retentionScore.toFixed(3)}`:``;return`- **${e.title}** (v${e.version})${n}${r}\n \`${e.path}\` — ${e.contentPreview.slice(0,80)}…`}).join(`
|
|
250
|
+
`),f=Cd(c);return{content:[{type:`text`,text:`## Curated Knowledge (${c.length} entries)\n\n${d}\n\n---\n_Next: Use \`knowledge({ action: "read", path: "..." })\` to view full content of any entry, or \`knowledge({ action: "remember", ... })\` to store new knowledge._`},...f],structuredContent:u}}async function kf(e,{curated:t}){let{path:n}=Pd.parse(e),r=e.limit??20,i=await t.history(n,r);if(i.length===0)return{content:[{type:`text`,text:`No git history available for this entry. Git-backing may not be available or the entry predates git-backing.`}]};let a=i.map((e,t)=>`${t+1}. **${e.date}** \`${e.sha.slice(0,8)}\` — ${e.message}`).join(`
|
|
251
|
+
`);return{content:[{type:`text`,text:`## History for \`${n}\` (${i.length} entries)\n\n${a}\n\n_Use \`knowledge({ action: "diff", path: "${n}", from_sha: "...", to_sha: "..." })\` to compare versions._`}]}}async function Af(e,{curated:t}){let{path:n}=Pd.parse(e),{from_sha:r,to_sha:i}=e,a=await t.diff(n,r,i);return a?{content:[{type:`text`,text:`## Diff for \`${n}\`\n\n\`\`\`diff\n${a}\n\`\`\``}]}:{content:[{type:`text`,text:`No diff available. Git-backing may not be available or the entry has no history.`}]}}async function jf(e,{curated:t}){let{path:n}=Pd.parse(e),r=await t.recover(n);return r?{content:[{type:`text`,text:`✅ Recovered \`${r.path}\` (version ${r.version}) from git history. The entry has been restored to the filesystem and re-indexed.`}]}:{content:[{type:`text`,text:`No git history found for \`${n}\`. Cannot recover — the entry either never existed or was never git-backed.`}]}}async function Mf(e,{curated:t}){let n=await t.listOrphaned();if(n.length===0)return{content:[{type:`text`,text:`No orphaned entries found. All git-backed entries have corresponding filesystem files.`}]};let r=n.map((e,t)=>`${t+1}. \`${e.path}\` — last: ${e.lastMessage}`).join(`
|
|
252
|
+
`);return{content:[{type:`text`,text:`## Orphaned Knowledge Entries (${n.length})\n\nThese entries exist in git but are missing from the filesystem:\n\n${r}\n\n_Use \`knowledge({ action: "recover", path: "..." })\` to restore any of these entries._`}]}}async function Nf(e,{curated:t,flowContextAdapter:n,stateStore:r,retentionConfig:i,consolidationConfig:a,lessonConfig:o}){let s=R.object({profile:R.string(),budget:R.number().int().min(100).max(5e4).default(6e3).describe(`Character budget for withdraw results`),token_budget:R.number().int().min(50).max(12500).optional().describe(`Token budget (overrides budget). Approx 4 chars per token.`)}).parse(e),c=s.token_budget?s.token_budget*4:s.budget;if(!n)return{content:[{type:`text`,text:`Flow context not available — no active flow or adapter not configured.`}]};let l=yd(s.profile);if(!l)return{content:[{type:`text`,text:`Unknown profile: "${s.profile}". Available: implementer, documenter, reviewer, researcher, debugger`}]};let u=await n.list();if(u.length===0)return{content:[{type:`text`,text:`No flow context available yet. Context is deposited automatically as agents use search, file_summary, and other analysis tools.`}]};let d=Date.now(),f=u.filter(e=>{let t=e.path.split(`/`)[0];return nf.has(t)?!bd(t,e.mtimeMs,d):!0}),p=(await Promise.all(f.map(async e=>{let t=e.path.split(`/`),o=t[0];if(t.length<2||!nf.has(o))return null;let s=await n.read(e.path);return s?(r&&Zd(r,e.path,i,a),{type:o,content:s}):null}))).filter(e=>e!==null),m=xd(p,l,c),h=v(o??_),g=[...new Set(m.flatMap(e=>uf(e.content)))];if(await Promise.all(g.map(async e=>{let n=r?.memoryMetaGet(e)?.confidence;if(n===void 0)try{n=(await df(t,r,e)).confidence}catch{return}lf(r,e,n,h)})),m.length===0)return{content:[{type:`text`,text:`No relevant context for profile "${s.profile}". ${p.length} entries available but none match your role's context types.`}]};let y=m.map(e=>`### [${e.type}]\n${e.content}`).join(`
|
|
253
253
|
|
|
254
|
-
`),b=m.reduce((e,t)=>e+t.content.length,0);return{content:[{type:`text`,text:`## Flow Context (${m.length}/${p.length} entries, ${b} chars, profile: ${s.profile})\n\n${y}`}]}}async function
|
|
254
|
+
`),b=m.reduce((e,t)=>e+t.content.length,0);return{content:[{type:`text`,text:`## Flow Context (${m.length}/${p.length} entries, ${b} chars, profile: ${s.profile})\n\n${y}`}]}}async function Pf(e,{flowContextAdapter:t}){return t?{content:[{type:`text`,text:`Flushed ${await t.flushAll()} flow context entries.`}]}:{content:[{type:`text`,text:`Flow context not available — no active flow or adapter not configured.`}]}}async function Ff(e,{curated:t,stateStore:n,retentionConfig:r,lessonConfig:a}){if(!n)return{content:[{type:`text`,text:`Retention state store not available.`}],structuredContent:{entries:[],totalCount:0}};let o=i(n,r),s=v(a??_),c=await t.list({category:`lessons`}),l=(await Promise.all(c.filter(e=>e.tags.includes(`lesson`)).map(async e=>{let r=n.memoryMetaGet(e.path);return r||=(await df(t,n,e.path)).meta,!r||!u(r,s)?null:{path:e.path,title:e.title,confidence:m(r.confidence,r.lastAccessedAt,r.createdAt,s),createdAt:r.createdAt,lastAccessedAt:r.lastAccessedAt,supersededBy:r.supersededBy}}))).filter(e=>e!==null).sort((e,t)=>e.confidence-t.confidence||Date.parse(e.lastAccessedAt??e.createdAt)-Date.parse(t.lastAccessedAt??t.createdAt));if(o.length===0&&l.length===0)return{content:[{type:`text`,text:`No flagged knowledge entries found below the current retention threshold.`}],structuredContent:{entries:[],totalCount:0}};let d=o.length===0?`### Retention
|
|
255
255
|
None.`:`### Retention\n${o.map(e=>`- \`${e.entryId}\` — score ${e.retentionScore.toFixed(3)}, tier ${e.tier}, accesses ${e.accessCount}`).join(`
|
|
256
256
|
`)}`,f=l.length===0?`### Stale Lessons
|
|
257
257
|
None.`:`### Stale Lessons\n${l.map(e=>`- **${e.title}** (\`${e.path}\`) — effective confidence ${e.confidence}/100, last access ${e.lastAccessedAt??e.createdAt}`).join(`
|
|
258
|
-
`)}`;return{content:[{type:`text`,text:`## Flagged Knowledge Entries (${o.length+l.length})\n\n${d}\n\n${f}`}],structuredContent:{entries:o,staleLessons:l,totalCount:o.length+l.length}}}async function
|
|
258
|
+
`)}`;return{content:[{type:`text`,text:`## Flagged Knowledge Entries (${o.length+l.length})\n\n${d}\n\n${f}`}],structuredContent:{entries:o,staleLessons:l,totalCount:o.length+l.length}}}async function If(e,t,n){switch(e){case`remember`:return wf(t,n);case`read`:return Tf(t,n);case`update`:return Ef(t,n);case`forget`:return Df(t,n);case`list`:return Of(t,n);case`history`:return kf(t,n);case`diff`:return Af(t,n);case`recover`:return jf(t,n);case`orphaned`:return Mf(t,n);case`withdraw`:return Nf(t,n);case`flush`:return Pf(t,n);case`flagged`:return Ff(t,n);case`lesson`:return Cf(t,n)}}function Lf(e,t,n,r,i,a,o,s,c,l,u,d){let f=U(`knowledge`),p={curated:t,policyStore:n,evolutionCollector:r,resourceNotifier:i,flowContextAdapter:a,stateStore:o,retentionConfig:s,consolidationConfig:l,supersessionConfig:c,lessonConfig:u};e.registerTool(`knowledge`,{title:f.title,description:"Operate on curated knowledge entries with a single tool. Use `action` to remember, read, update, forget, list, history, diff, recover, orphaned, withdraw, flush, flagged, or lesson entries.",inputSchema:Vd.shape,annotations:f.annotations},q(`knowledge`,async({action:e,...t})=>{try{let n=Vd.parse({action:e,...t});return await Ud(await If(n.action,n,p),n,d)}catch(e){return e instanceof R.ZodError?K(`VALIDATION`,af(e)):(Td.error(`Knowledge operation failed`,I(e)),K(`INTERNAL`,`Knowledge operation failed: ${e instanceof Error?e.message:String(e)}`))}}))}const Rf=F(`tools`);function zf(e,t,n){let r=U(`lookup`);e.registerTool(`lookup`,{title:r.title,description:`Get all indexed content for a known file path, sorted by position. Use when you know the exact file. For discovery across files use search.`,inputSchema:{path:R.string().describe(`Relative file path to look up (e.g., "src/index.ts")`),enrich:R.boolean().default(!1).describe(`Append curated knowledge and graph context to output. Adds ~150-250 tokens. Default false — set true when you need stored decisions, conventions, or relationship context.`)},annotations:r.annotations},q(`lookup`,async({path:e,enrich:r})=>{try{let i=await t.getBySourcePath(e);if(i.length===0)return{content:[{type:`text`,text:`No indexed content found for: ${e}`}]};i.sort((e,t)=>e.chunkIndex-t.chunkIndex);let a=`## ${e}\n**Chunks**: ${i.length} | **Type**: ${i[0].contentType}\n`,o=i.map(e=>{let t=e.startLine?` (lines ${e.startLine}-${e.endLine})`:``;return`### Chunk ${e.chunkIndex+1}/${e.totalChunks}${t}\n${e.content}`}).join(`
|
|
259
259
|
|
|
260
|
-
`),s=
|
|
261
|
-
`).replace(/\\t/g,` `)}))}]}}catch(e){return
|
|
262
|
-
`)}function
|
|
263
|
-
`)}const
|
|
260
|
+
`),s=wd(e),c=s?Sd(s):void 0,l=`${a}\n${o}\n\n---\n_Next: Use \`search\` to find related content, or \`analyze({ aspect: "dependencies", path: "${e}" })\` to see what this file imports._`;if(r&&n){let t=await W(n,{query:e});l+=G(t)}return{content:[{type:`text`,text:l},...c?[c]:[]]}}catch(e){return Rf.error(`Lookup failed`,I(e)),K(`INTERNAL`,`Lookup failed: ${e instanceof Error?e.message:String(e)}`)}}))}const Bf=F(`tools:manipulation`);function Vf(e){return e.sources[0]?.path??process.cwd()}function Hf(e,t){let n=P(t,e),r=ye(t,n);if(r.startsWith(`..`)||ve(r))throw Error(`Path "${e}" escapes workspace root: ${t}`);return n}function Uf(e){let t=U(`git_context`);e.registerTool(`git_context`,{title:t.title,description:`Summarize the current Git branch, working tree state, recent commits, and optional diff statistics for the repository.`,inputSchema:{cwd:R.string().optional().describe(`Repository root or working directory`),commit_count:R.number().min(1).max(50).default(5).optional().describe(`How many recent commits to include`),include_diff:R.boolean().default(!1).optional().describe(`Include diff stat for working tree changes`)},annotations:t.annotations,outputSchema:Us},async({cwd:e,commit_count:t,include_diff:n})=>{try{let r=await yt({cwd:e,commitCount:t,includeDiff:n});return{content:[{type:`text`,text:Jf(r)}],structuredContent:{gitRoot:r.gitRoot,branch:r.branch,commitCount:r.recentCommits.length,hasUncommitted:r.status.staged.length>0||r.status.modified.length>0||r.status.untracked.length>0,recentCommits:r.recentCommits.map(e=>({hash:e.hash,message:e.message,author:e.author,date:e.date}))}}}catch(e){return Bf.error(`Git context failed`,I(e)),K(`INTERNAL`,`Git context failed: ${e instanceof Error?e.message:String(e)}`)}})}function Wf(e){let t=U(`diff_parse`);e.registerTool(`diff_parse`,{title:t.title,description:`Parse raw unified diff text into file-level and hunk-level structural changes.`,inputSchema:{diff:R.string().max(1e6).describe(`Raw unified diff text`)},annotations:t.annotations},async({diff:e})=>{try{return{content:[{type:`text`,text:Yf(at({diff:e.replace(/\\n/g,`
|
|
261
|
+
`).replace(/\\t/g,` `)}))}]}}catch(e){return Bf.error(`Diff parse failed`,I(e)),K(`INTERNAL`,`Diff parse failed: ${e instanceof Error?e.message:String(e)}`)}})}function Gf(e,t){let n=U(`rename`),r=Vf(t);e.registerTool(`rename`,{title:n.title,description:`Rename a symbol across files using whole-word regex matching for exports, imports, and general usage references.`,inputSchema:{old_name:R.string().describe(`Existing symbol name to replace`),new_name:R.string().describe(`New symbol name to use`),root_path:R.string().describe(`Root directory to search within`),extensions:R.array(R.string()).optional().describe(`Optional file extensions to include, such as .ts,.tsx,.js,.jsx`),dry_run:R.boolean().default(!0).describe(`Preview changes without writing files`)},annotations:n.annotations},q(`rename`,async({old_name:e,new_name:t,root_path:n,extensions:i,dry_run:a},o)=>{let s;try{s=kc(o).createTask(`Rename Symbol`,2),s.progress(0,`Scanning for references`);let c=Hf(n,r);s.progress(1,`Applying renames`);let l=await tn({oldName:e,newName:t,rootPath:c,extensions:i,dryRun:a});return s.complete(`Rename complete`),{content:[{type:`text`,text:JSON.stringify(l)}]}}catch(e){return s?.fail?.(`Rename failed`),Bf.error(`Rename failed`,I(e)),K(`INTERNAL`,`Rename failed: ${e instanceof Error?e.message:String(e)}`)}}))}function Kf(e,t){let n=U(`codemod`),r=Vf(t);e.registerTool(`codemod`,{title:n.title,description:`Apply regex-based codemod rules across files and return structured before/after changes for each affected line.`,inputSchema:{root_path:R.string().describe(`Root directory to transform within`),rules:R.array(R.object({description:R.string().describe(`What the codemod rule does`),pattern:R.string().describe(`Regex pattern in string form`),replacement:R.string().describe(`Replacement string with optional capture groups`)})).min(1).describe(`Codemod rules to apply`),dry_run:R.boolean().default(!0).describe(`Preview changes without writing files`)},annotations:n.annotations},q(`codemod`,async({root_path:e,rules:t,dry_run:n},i)=>{let a;try{a=kc(i).createTask(`Codemod`,2),a.progress(0,`Scanning files`);let o=Hf(e,r);a.progress(1,`Applying transforms`);let s=await Xe({rootPath:o,rules:t,dryRun:n});return a.complete(`Codemod complete`),{content:[{type:`text`,text:JSON.stringify(s)}]}}catch(e){return a?.fail?.(`Codemod failed`),Bf.error(`Codemod failed`,I(e)),K(`INTERNAL`,`Codemod failed: ${e instanceof Error?e.message:String(e)}`)}}))}function qf(e){let t=U(`data_transform`);e.registerTool(`data_transform`,{title:t.title,description:`Apply small jq-like transforms to JSON input for filtering, projection, grouping, and path extraction.`,inputSchema:{input:R.string().max(5e5).describe(`Input JSON string`),expression:R.string().max(1e4).describe(`Transform expression to apply`)},annotations:t.annotations},async({input:e,expression:t})=>{try{return{content:[{type:`text`,text:tt({input:e,expression:t}).outputString}]}}catch(e){return Bf.error(`Data transform failed`,I(e)),K(`INTERNAL`,`Data transform failed: ${e instanceof Error?e.message:String(e)}`)}})}function Jf(e){let t=[`Git root: ${e.gitRoot}`,`Branch: ${e.branch}`,`Staged: ${e.status.staged.length}`,...e.status.staged.map(e=>` - ${e}`),`Modified: ${e.status.modified.length}`,...e.status.modified.map(e=>` - ${e}`),`Untracked: ${e.status.untracked.length}`,...e.status.untracked.map(e=>` - ${e}`),``,`Recent commits:`];if(e.recentCommits.length===0)t.push(` none`);else for(let n of e.recentCommits)t.push(` - ${n.hash} ${n.message}`),t.push(` ${n.author} @ ${n.date}`);return e.diff&&t.push(``,`Diff stat:`,e.diff),t.join(`
|
|
262
|
+
`)}function Yf(e){if(e.length===0)return`No diff files found.`;let t=[];for(let n of e){let e=n.oldPath?` (from ${n.oldPath})`:``;t.push(`${n.path}${e} [${n.status}] +${n.additions} -${n.deletions} (${n.hunks.length} hunks)`);for(let e of n.hunks){let n=e.header?` ${e.header}`:``;t.push(` @@ -${e.oldStart},${e.oldLines} +${e.newStart},${e.newLines} @@${n}`)}}return t.join(`
|
|
263
|
+
`)}const Xf=[`list_tools`,`describe_tool`,`search_tools`];function Zf(e,t,n){let r=[...new Set(n)].sort();e.registerTool(`list_tools`,{title:U(`list_tools`).title,description:`List the available AI Kit tools with names, titles, and categories. Use this before describe_tool when you need to discover the active toolset.`,inputSchema:{category:R.string().optional().describe(`Optional category filter`)},annotations:U(`list_tools`).annotations},q(`list_tools`,async({category:e})=>{let t=e?.trim().toLowerCase();return{content:[{type:`text`,text:r.filter(e=>t?(Yo[e]?.category??[]).some(e=>e.toLowerCase()===t):!0).map(e=>{let t=Yo[e]??{title:e,category:[]},n=t.category?.join(`, `)||`uncategorized`;return`${e}: ${t.title} [${n}]`}).join(`
|
|
264
264
|
`)||`No tools matched the filter.`}]}})),e.registerTool(`describe_tool`,{title:U(`describe_tool`).title,description:`Describe a specific active AI Kit tool using centralized metadata. Use this after list_tools when you need a tool title, categories, and annotations before calling it directly.`,inputSchema:{tool_name:R.string().describe(`The active tool name to describe`)},annotations:U(`describe_tool`).annotations},q(`describe_tool`,async({tool_name:e})=>{if(!r.includes(e))return K(`VALIDATION`,`Unknown or inactive tool: ${e}`);let t=Yo[e],n={name:e,title:t?.title??e,categories:t?.category??[],annotations:t?.annotations??{},note:`Call the tool directly after discovery. AI Kit does not expose an execute_tool proxy.`};return{content:[{type:`text`,text:JSON.stringify(n,null,2)}]}})),e.registerTool(`search_tools`,{title:U(`search_tools`).title,description:`Search active AI Kit tools by keyword across tool names, titles, and categories.`,inputSchema:{query:R.string().min(1).describe(`Keyword query to match against active tools`)},annotations:U(`search_tools`).annotations},q(`search_tools`,async({query:e})=>{let t=e.trim().toLowerCase(),n=r.filter(e=>{let n=Yo[e];return e.toLowerCase().includes(t)||n?.title.toLowerCase().includes(t)||(n?.category??[]).some(e=>e.toLowerCase().includes(t))}).map(e=>{let t=Yo[e]??{title:e,category:[]},n=t.category?.join(`, `)||`uncategorized`;return`${e}: ${t.title} [${n}]`});return{content:[{type:`text`,text:n.length>0?n.join(`
|
|
265
|
-
`):`No tools found matching "${e}"`}]}}))}const
|
|
266
|
-
`);if(c&&a){let e=await W(a,{query:`onboard codebase conventions`});h+=G(e)}return{content:[{type:`text`,text:h}]}}catch(e){return
|
|
267
|
-
`)}]}}case`delete`:if(!t)throw Error(`name required for delete`);return{content:[{type:`text`,text:it(t)?`Deleted workset "${t}".`:`Workset "${t}" not found.`}]};case`add`:{if(!t||!n)throw Error(`name and files required for add`);let e=Re(t,n);return{content:[{type:`text`,text:`Added to workset "${e.name}": now ${e.files.length} files.`}]}}case`remove`:{if(!t||!n)throw Error(`name and files required for remove`);let e=en(t,n);return e?{content:[{type:`text`,text:`Removed from workset "${e.name}": now ${e.files.length} files.`}]}:{content:[{type:`text`,text:`Workset "${t}" not found.`}]}}}}catch(e){return
|
|
268
|
-
`)}]}}case`delete`:if(!n)throw Error(`key required for delete`);return{content:[{type:`text`,text:hn(t,n)?`Deleted stash entry "${n}".`:`Stash entry "${n}" not found.`}]};case`clear`:{let e=mn(t);return{content:[{type:`text`,text:`Cleared ${e} stash entr${e===1?`y`:`ies`}.`}]}}}}catch(e){return
|
|
269
|
-
`)}]}}case`latest`:{let e=Ke(t,{label:n});return{content:[{type:`text`,text:e?
|
|
265
|
+
`):`No tools found matching "${e}"`}]}}))}const Qf=F(`tools`);let $f=!1;async function ep(e,t,n){for(let r of n.steps)if(!(r.status!==`success`||!r.output))try{let i=k(`sha256`).update(n.path).digest(`hex`).slice(0,12),a=`produced/onboard/${r.name}/${i}.md`,o=k(`sha256`).update(r.output).digest(`hex`).slice(0,16),s=new Date().toISOString(),c=r.output.length>2e3?r.output.split(/(?=^## )/m).filter(e=>e.trim().length>0):[r.output],l=c.map((e,t)=>({id:k(`sha256`).update(`${a}::${t}`).digest(`hex`).slice(0,16),content:e.trim(),sourcePath:a,contentType:`produced-knowledge`,chunkIndex:t,totalChunks:c.length,startLine:0,endLine:0,fileHash:o,indexedAt:s,origin:`produced`,tags:[`onboard`,r.name],category:`analysis`,version:1})),u=await t.embedBatch(l.map(e=>e.content));await e.upsert(l,u)}catch(e){Qf.warn(`Auto-persist onboard step failed`,{stepName:r.name,...I(e)})}}async function tp(e,t,n){if(n.autoRemember?.length)for(let r of n.autoRemember)try{let n=k(`sha256`).update(`onboard-remember::${r.title}`).digest(`hex`).slice(0,16),i=new Date().toISOString(),a={id:n,content:`# ${r.title}\n\n${r.content}`,sourcePath:`curated/onboard/${r.category}/${n}.md`,contentType:`curated`,chunkIndex:0,totalChunks:1,startLine:0,endLine:0,fileHash:k(`sha256`).update(r.content).digest(`hex`).slice(0,16),indexedAt:i,origin:`curated`,tags:r.tags,category:r.category,version:1},[o]=await t.embedBatch([a.content]);await e.upsert([a],[o])}catch(e){Qf.warn(`Auto-persist remember entry failed`,{title:r.title,...I(e)})}}function np(e,t,n,r,i,a){let o=U(`onboard`);e.registerTool(`onboard`,{title:o.title,description:`First-time codebase onboarding: runs all analysis tools (structure, dependencies, entry-points, symbols, patterns, diagram) in one command. Results are auto-persisted to AI Kit memory. Use mode=generate to also write structured output to .ai/context/ directory.`,inputSchema:{path:R.string().describe(`Root path of the codebase to onboard`),mode:R.enum([`memory`,`generate`]).default(`generate`).describe(`Output mode: generate (default) = persist to AI Kit + write .ai/context/ files; memory = AI Kit vector store only`),out_dir:R.string().optional().describe(`Custom output directory for generate mode (default: <path>/.ai/context)`),enrich:R.boolean().default(!0).describe(`Append curated knowledge and graph context to output. Adds ~150-250 tokens. Default true for planning tools — set false to save tokens when enrichment is not needed.`)},annotations:o.annotations},q(`onboard`,async({path:e,mode:o,out_dir:s,enrich:c},l)=>{try{if($f)return{content:[{type:`text`,text:`Onboard is already running. Please wait for it to complete before starting another.`}]};$f=!0,Qf.info(`Starting onboard`,{path:e,mode:o});let u=await Ft({path:e,mode:o,outDir:s??r?.onboardDir}),d=kc(l).createTask(`Onboard`,u.steps.length);for(let e=0;e<u.steps.length;e++){let t=u.steps[e];d.progress(e,`${t.name}: ${t.status}`)}d.complete(`Onboard complete: ${u.steps.filter(e=>e.status===`success`).length}/${u.steps.length} steps succeeded`),ep(t,n,u),u.autoRemember?.length&&tp(t,n,u).catch(e=>{Qf.warn(`Auto-persist autoRemember failed`,I(e))}),i&&(i.onboardComplete=!0,i.onboardTimestamp=new Date().toISOString());let f=[`## Onboard Complete`,``,`**Path:** \`${u.path}\``,`**Mode:** ${u.mode}`,`**Duration:** ${u.totalDurationMs}ms`,``];u.outDir&&(f.push(`**Output directory:** \`${u.outDir}\``),f.push(``)),f.push(`### Analysis Results`,``);let p=[],m=[];for(let e of u.steps)e.status===`success`?p.push(`- ✓ **${e.name}** (${e.durationMs}ms) — ${e.output.length} chars`):m.push(`- ✗ **${e.name}** — ${e.error}`);f.push(...p),m.length>0&&f.push(``,`### Failed`,``,...m),f.push(``,`---`,``);for(let e of u.steps)e.status===`success`&&f.push(`### ${e.name}`,``,e.output,``,`---`,``);f.push(`_All results auto-saved to AI Kit memory._`,u.mode===`generate`?` Files written to \`${u.outDir}\`.`:``,' Next: Use `search` to query the knowledge, or `knowledge({ action: "remember", ... })` to add custom insights.');let h=f.join(`
|
|
266
|
+
`);if(c&&a){let e=await W(a,{query:`onboard codebase conventions`});h+=G(e)}return{content:[{type:`text`,text:h}]}}catch(e){return Qf.error(`Onboard failed`,I(e)),K(`INTERNAL`,`Onboard failed: ${e instanceof Error?e.message:String(e)}`)}finally{$f=!1}}))}const rp=F(`tools:persistence`);function ip(e){let t=U(`workset`);e.registerTool(`workset`,{title:t.title,description:`Manage named file sets (worksets). Save, load, list, add/remove files. Worksets persist across sessions in .aikit-state/worksets.json.`,inputSchema:{action:R.enum([`save`,`get`,`list`,`delete`,`add`,`remove`]).describe(`Operation to perform`),name:R.string().optional().describe(`Workset name (required for all except list)`),files:R.array(R.string()).optional().describe(`File paths (required for save, add, remove)`),description:R.string().optional().describe(`Description (for save)`)},annotations:t.annotations},q(`workset`,async({action:e,name:t,files:n,description:r})=>{try{switch(e){case`save`:{if(!t||!n)throw Error(`name and files required for save`);let e=cn(t,n,{description:r});return{content:[{type:`text`,text:`Saved workset "${e.name}" with ${e.files.length} files.`}]}}case`get`:{if(!t)throw Error(`name required for get`);let e=vt(t);return e?{content:[{type:`text`,text:JSON.stringify(e)}]}:{content:[{type:`text`,text:`Workset "${t}" not found.`}]}}case`list`:{let e=Nt();return e.length===0?{content:[{type:`text`,text:`No worksets.`}]}:{content:[{type:`text`,text:e.map(e=>`- **${e.name}** (${e.files.length} files) — ${e.description??`no description`}`).join(`
|
|
267
|
+
`)}]}}case`delete`:if(!t)throw Error(`name required for delete`);return{content:[{type:`text`,text:it(t)?`Deleted workset "${t}".`:`Workset "${t}" not found.`}]};case`add`:{if(!t||!n)throw Error(`name and files required for add`);let e=Re(t,n);return{content:[{type:`text`,text:`Added to workset "${e.name}": now ${e.files.length} files.`}]}}case`remove`:{if(!t||!n)throw Error(`name and files required for remove`);let e=en(t,n);return e?{content:[{type:`text`,text:`Removed from workset "${e.name}": now ${e.files.length} files.`}]}:{content:[{type:`text`,text:`Workset "${t}" not found.`}]}}}}catch(e){return rp.error(`Workset operation failed`,I(e)),K(`INTERNAL`,`Workset operation failed: ${e instanceof Error?e.message:String(e)}`)}}))}function ap(e,t){let n=U(`stash`);e.registerTool(`stash`,{title:n.title,description:`Persist and retrieve named values in the SQLite-backed state store for intermediate results between tool calls.`,inputSchema:{action:R.enum([`set`,`get`,`list`,`delete`,`clear`]).describe(`Operation to perform on the stash`),key:R.string().optional().describe(`Entry key for set/get/delete operations`),value:R.string().optional().describe(`String or JSON value for set operations`)},annotations:n.annotations},q(`stash`,async({action:e,key:n,value:r})=>{try{switch(e){case`set`:{if(!n)throw Error(`key required for set`);let e=vn(t,n,up(r??``));return{content:[{type:`text`,text:`Stored stash entry "${e.key}" (${e.type}) at ${e.storedAt}.`}]}}case`get`:{if(!n)throw Error(`key required for get`);let e=gn(t,n);return{content:[{type:`text`,text:e?JSON.stringify(e):`Stash entry "${n}" not found.`}]}}case`list`:{let e=_n(t);return{content:[{type:`text`,text:e.length===0?`Stash is empty.`:e.map(e=>`- ${e.key} (${e.type}) — ${e.storedAt}`).join(`
|
|
268
|
+
`)}]}}case`delete`:if(!n)throw Error(`key required for delete`);return{content:[{type:`text`,text:hn(t,n)?`Deleted stash entry "${n}".`:`Stash entry "${n}" not found.`}]};case`clear`:{let e=mn(t);return{content:[{type:`text`,text:`Cleared ${e} stash entr${e===1?`y`:`ies`}.`}]}}}}catch(e){return rp.error(`Stash operation failed`,I(e)),K(`INTERNAL`,`Stash operation failed: ${e instanceof Error?e.message:String(e)}`)}}))}function op(e,t){let n=U(`checkpoint`);e.registerTool(`checkpoint`,{title:n.title,description:`Save and restore lightweight session checkpoints in the SQLite-backed state store for cross-session continuity. Legacy .aikit-state/checkpoints directories are imported automatically on first access.`,inputSchema:{action:R.enum([`save`,`load`,`list`,`latest`,`diff`,`history`,`gc`]).describe(`Checkpoint action to perform`),label:R.string().optional().describe(`Checkpoint label for save, or checkpoint id for load`),data:R.string().max(5e5).optional().describe(`JSON object string for save actions`),notes:R.string().max(1e4).optional().describe(`Optional notes for save actions`),from_id:R.string().optional().describe(`Checkpoint ID to diff FROM (for diff action)`),to_id:R.string().optional().describe(`Checkpoint ID to diff TO (for diff action)`),limit:R.number().min(1).max(50).optional().describe(`Max history entries to return`),keep_last:R.number().min(1).max(100).optional().describe(`Keep N most recent checkpoints per label (default: 10, for gc action)`),max_age_days:R.number().min(1).optional().describe(`Delete checkpoints older than N days (for gc action)`),dry_run:R.boolean().optional().describe(`Preview changes without deleting (default: true, for gc action)`)},annotations:n.annotations},q(`checkpoint`,async({action:e,label:n,data:r,notes:i,from_id:a,to_id:o,limit:s,keep_last:c,max_age_days:l,dry_run:u})=>{try{switch(e){case`save`:if(!n)throw Error(`label required for save`);return{content:[{type:`text`,text:lp(Ye(t,n,dp(r),{notes:i}))}]};case`load`:{if(!n)throw Error(`label required for load`);let e=Je(t,n);return{content:[{type:`text`,text:e?lp(e):`Checkpoint "${n}" not found.`}]}}case`list`:{let e=qe(t,{label:n,limit:s});return{content:[{type:`text`,text:e.length===0?`No checkpoints saved.`:e.map(e=>`- ${e.id} — ${e.label} (${e.createdAt})`).join(`
|
|
269
|
+
`)}]}}case`latest`:{let e=Ke(t,{label:n});return{content:[{type:`text`,text:e?lp(e):`No checkpoints saved.`}]}}case`diff`:{if(!a||!o)throw Error(`from_id and to_id required for diff`);let e=Ue(t,a,o);return e?{content:[{type:`text`,text:[`## Checkpoint Diff: ${a} → ${o}`,e.added.length?`**Added:** ${e.added.join(`, `)}`:``,e.removed.length?`**Removed:** ${e.removed.join(`, `)}`:``,e.modified.length?`**Modified:** ${e.modified.join(`, `)}`:``,!e.added.length&&!e.removed.length&&!e.modified.length?`No differences found.`:``].filter(Boolean).join(`
|
|
270
270
|
`)}]}:{content:[{type:`text`,text:`One or both checkpoints not found.`}]}}case`history`:{if(!n)throw Error(`label required for history`);let e=Ge(t,n,{limit:s??20});return e.length===0?{content:[{type:`text`,text:`No history found for "${n}".`}]}:{content:[{type:`text`,text:`## History: ${n}\n${e.map(e=>`- ${e.sha?e.sha.slice(0,8):e.id} — ${e.createdAt}${e.label?` (${e.label})`:``}`).join(`
|
|
271
271
|
`)}`}]}}case`gc`:{let e=We(t,{label:n,keepLast:c,maxAgeDays:l,dryRun:u});return{content:[{type:`text`,text:[`## Checkpoint GC${e.labels.length?`: ${e.labels.join(`, `)}`:``}`,`Deleted: ${e.deleted}`,`Kept: ${e.kept}`,`Mode: ${u??!0?`dry-run`:`delete`}`,e.deletedIds.length?`Deleted IDs: ${e.deletedIds.join(`, `)}`:`Deleted IDs: none`].join(`
|
|
272
|
-
`)}]}}}}catch(e){return
|
|
273
|
-
`)}function
|
|
274
|
-
`)}function
|
|
275
|
-
`)}\n\n---\n_${e.length} rules total. Use \`action: "update"\` to modify a rule._`}]}}if(e===`get`){if(!n)return K(`VALIDATION`,'`rule_id` is required for "get" action.');let e=t.getRule(n);return e?{content:[{type:`text`,text:
|
|
272
|
+
`)}]}}}}catch(e){return rp.error(`Checkpoint failed`,I(e)),K(`INTERNAL`,`Checkpoint failed: ${e instanceof Error?e.message:String(e)}`)}}))}function sp(e){let t=U(`lane`);e.registerTool(`lane`,{title:t.title,description:`Manage verified lanes — isolated file copies for parallel exploration. Also provides advisory write-intent leases for multi-agent coordination.`,inputSchema:{action:R.enum([`create`,`list`,`status`,`diff`,`merge`,`discard`,`lease`,`unlease`,`leases`]).describe(`Lane action to perform`),name:R.string().optional().describe(`Lane name (required for create/status/diff/merge/discard)`),files:R.array(R.string()).optional().describe(`File paths to copy into the lane (required for create)`),agent:R.string().optional().describe(`Agent identifier (required for lease)`),intent:R.string().optional().describe(`What the agent plans to do (required for lease)`),id:R.string().optional().describe(`Lease ID (required for unlease)`),symbols:R.array(R.string()).optional().describe(`Symbol names within files (optional for lease)`),ttl_minutes:R.number().optional().describe(`Lease TTL in minutes (default 10, optional for lease)`)},annotations:t.annotations},q(`lane`,async({action:e,name:t,files:n,agent:r,intent:i,id:a,symbols:o,ttl_minutes:s})=>{try{switch(e){case`create`:{if(!t)throw Error(`name is required for create`);if(!n||n.length===0)throw Error(`files are required for create`);let e=Tt(t,n);return{content:[{type:`text`,text:JSON.stringify(e)}]}}case`list`:return{content:[{type:`text`,text:JSON.stringify(Ot())}]};case`status`:if(!t)throw Error(`name is required for status`);return{content:[{type:`text`,text:JSON.stringify(At(t))}]};case`diff`:if(!t)throw Error(`name is required for diff`);return{content:[{type:`text`,text:JSON.stringify(Et(t))}]};case`merge`:if(!t)throw Error(`name is required for merge`);return{content:[{type:`text`,text:JSON.stringify(kt(t))}]};case`discard`:if(!t)throw Error(`name is required for discard`);return{content:[{type:`text`,text:JSON.stringify({discarded:Dt(t)})}]};case`lease`:{if(!r)throw Error(`agent is required for lease`);if(!n||n.length===0)throw Error(`files are required for lease`);if(!i)throw Error(`intent is required for lease`);let e=Le({agent:r,files:n,intent:i,symbols:o,ttl_minutes:s});return{content:[{type:`text`,text:JSON.stringify(e)}]}}case`unlease`:{if(!a)throw Error(`id is required for unlease`);let e=$t({id:a});return{content:[{type:`text`,text:JSON.stringify(e)}]}}case`leases`:{let e=jt({agent:r});return{content:[{type:`text`,text:JSON.stringify(e)}]}}}}catch(e){return rp.error(`Lane action failed`,I(e)),K(`INTERNAL`,`Lane action failed: ${e instanceof Error?e.message:String(e)}`)}}))}function cp(e){let t=U(`queue`);e.registerTool(`queue`,{title:t.title,description:`Manage task queues with optional DAG dependencies. Push items with dependsOn for wave-based execution. Take next, mark done/failed, list queues.`,inputSchema:{action:R.enum([`create`,`push`,`next`,`done`,`fail`,`get`,`list`,`clear`,`delete`,`dag`]).describe(`Queue action`),name:R.string().optional().describe(`Queue name (required for most actions)`),title:R.string().optional().describe(`Item title (required for push)`),id:R.string().optional().describe(`Item ID (required for done/fail)`),data:R.unknown().optional().describe(`Arbitrary data to attach to a queue item`),error:R.string().optional().describe(`Error message (required for fail)`),dependsOn:R.array(R.string()).optional().describe(`Item IDs this task depends on. Dependent items start as blocked until deps complete.`)},annotations:t.annotations},q(`queue`,async({action:e,name:t,title:n,id:r,data:i,error:a,dependsOn:o})=>{try{switch(e){case`create`:if(!t)throw Error(`name is required for create`);return{content:[{type:`text`,text:JSON.stringify(Ut(t))}]};case`push`:if(!t)throw Error(`name is required for push`);if(!n)throw Error(`title is required for push`);return{content:[{type:`text`,text:JSON.stringify(Zt(t,n,i,void 0,o))}]};case`next`:{if(!t)throw Error(`name is required for next`);let e=Xt(t);return{content:[{type:`text`,text:JSON.stringify(e)}]}}case`done`:if(!t)throw Error(`name is required for done`);if(!r)throw Error(`id is required for done`);return{content:[{type:`text`,text:JSON.stringify(Kt(t,r))}]};case`fail`:if(!t)throw Error(`name is required for fail`);if(!r)throw Error(`id is required for fail`);if(!a)throw Error(`error is required for fail`);return{content:[{type:`text`,text:JSON.stringify(qt(t,r,a))}]};case`get`:if(!t)throw Error(`name is required for get`);return{content:[{type:`text`,text:JSON.stringify(Jt(t))}]};case`list`:return{content:[{type:`text`,text:JSON.stringify(Yt())}]};case`clear`:if(!t)throw Error(`name is required for clear`);return{content:[{type:`text`,text:JSON.stringify({cleared:Ht(t)})}]};case`delete`:if(!t)throw Error(`name is required for delete`);return{content:[{type:`text`,text:JSON.stringify({deleted:Gt(t)})}]};case`dag`:if(!t)throw Error(`name is required for dag`);return{content:[{type:`text`,text:JSON.stringify(Wt(t))}]}}}catch(e){return rp.error(`Queue action failed`,I(e)),K(`INTERNAL`,`Queue action failed: ${e instanceof Error?e.message:String(e)}`)}}))}function lp(e){let t=[e.id,`Label: ${e.label}`,`Created: ${e.createdAt}`];return e.notes&&t.push(`Notes: ${e.notes}`),t.push(``,`Data:`,JSON.stringify(e.data)),t.join(`
|
|
273
|
+
`)}function up(e){let t=e.trim();if(!t)return``;try{return JSON.parse(t)}catch{return e}}function dp(e){let t=e?.trim();if(!t)return{};let n;try{n=JSON.parse(t)}catch{throw Error(`data must be a valid JSON object string`)}if(!n||typeof n!=`object`||Array.isArray(n))throw Error(`data must be a JSON object string`);return n}const fp=F(`tools`);function pp(e){let t=[`## Rule: ${e.id}`,``,`- **Status**: ${e.enabled?`enabled`:`disabled`}`,`- **Description**: ${e.description??`—`}`,`- **Category**: ${e.category??`—`}`,`- **Push weight**: ${e.pushWeight??`—`}`];return e.patterns?.length&&t.push(`- **Patterns**: ${e.patterns.join(`, `)}`),e.examples?.length&&t.push(`- **Examples**: ${e.examples.join(`, `)}`),t.join(`
|
|
274
|
+
`)}function mp(e,t){let n=U(`er_update_policy`);e.registerTool(`er_update_policy`,{title:n.title,description:`Manage ER push classification rules. Supports listing, updating, creating, and deleting rules that determine when knowledge should be pushed to Enterprise RAG.`,inputSchema:{action:R.enum([`list`,`get`,`update`,`create`,`delete`]).describe(`Action to perform on classification rules`),rule_id:R.string().optional().describe(`Rule ID (required for get, update, delete)`),changes:R.object({patterns:R.array(R.string()).optional(),category:R.string().optional(),pushWeight:R.number().min(0).max(1).optional(),description:R.string().optional(),examples:R.array(R.string()).optional(),enabled:R.boolean().optional()}).optional().describe(`Changes to apply (for update action)`),new_rule:R.object({id:R.string().regex(/^[a-z][a-z0-9-]*$/),patterns:R.array(R.string()).min(1),category:R.string(),pushWeight:R.number().min(0).max(1),description:R.string(),examples:R.array(R.string()).default([]),enabled:R.boolean().default(!0)}).optional().describe(`New rule definition (for create action)`)},annotations:n.annotations},q(`er_update_policy`,async({action:e,rule_id:n,changes:r,new_rule:i})=>{try{if(e===`list`){let e=t.getRules();return{content:[{type:`text`,text:`## Classification Rules\n\n${e.map(e=>`- **${e.id}** (${e.enabled?`enabled`:`disabled`}) — ${e.description}\n Category: ${e.category} | Weight: ${e.pushWeight} | Patterns: ${e.patterns.join(`, `)}`).join(`
|
|
275
|
+
`)}\n\n---\n_${e.length} rules total. Use \`action: "update"\` to modify a rule._`}]}}if(e===`get`){if(!n)return K(`VALIDATION`,'`rule_id` is required for "get" action.');let e=t.getRule(n);return e?{content:[{type:`text`,text:pp(e)}]}:K(`NOT_FOUND`,`Rule "${n}" not found.`)}if(e===`update`){if(!n||!r)return K(`VALIDATION`,'`rule_id` and `changes` are required for "update" action.');let e=t.updateRule(n,r);return e?{content:[{type:`text`,text:`${pp(e)}\n\n---\n_Updated. Next: Use \`action: "list"\` to verify._`}]}:K(`NOT_FOUND`,`Rule "${n}" not found.`)}return e===`create`?i?{content:[{type:`text`,text:`${pp(t.addRule(i))}\n\n---\n_Created. Next: Test classification with \`remember\`._`}]}:K(`VALIDATION`,'`new_rule` is required for "create" action.'):e===`delete`?n?t.deleteRule(n)?{content:[{type:`text`,text:`Deleted rule **${n}**.\n\n---\n_Next: Use \`action: "list"\` to verify._`}]}:K(`NOT_FOUND`,`Rule "${n}" not found.`):K(`VALIDATION`,'`rule_id` is required for "delete" action.'):K(`VALIDATION`,`Unknown action: ${e}`)}catch(e){return fp.error(`Policy update failed`,I(e)),K(`INTERNAL`,`Policy update failed: ${e instanceof Error?e.message:String(e)}`)}}))}const hp=new Map([{type:`markdown`,category:`content`,description:`Markdown content rendered with the marked parser.`,valueShape:`string`,relevantSkills:[`present`,`docs`]},{type:`code`,category:`content`,description:`Formatted code block rendered inside pre/code tags.`,valueShape:`string`,relevantSkills:[`present`,`docs`]},{type:`mermaid`,category:`visualization`,description:`Mermaid diagram source rendered in a mermaid pre block.`,valueShape:`string`,vendorScripts:[`mermaid`],relevantSkills:[`present`,`c4-architecture`,`docs`]},{type:`table`,category:`data`,description:`Tabular data rendered from records or explicit headers and rows.`,valueShape:`Record<string, unknown>[] | { headers: string[]; rows: unknown[][] }`,relevantSkills:[`present`,`docs`]},{type:`metrics`,category:`data`,description:`Metric cards showing label/value pairs with optional trend and status.`,valueShape:`Array<{ label: string; value: string | number; trend?: string | number; status?: string }>`,relevantSkills:[`present`]},{type:`cards`,category:`visualization`,description:`Card grid for titled items with optional body, badge, and status.`,valueShape:`Array<{ title: string; body?: string; badge?: string; status?: string; description?: string }>`,relevantSkills:[`present`,`docs`]},{type:`tree`,category:`visualization`,description:`Hierarchical object or name/children tree rendered recursively.`,valueShape:`{ name: string; children?: unknown[] } | Record<string, unknown>`,relevantSkills:[`present`]},{type:`graph`,category:`visualization`,description:`Node and edge graph rendered as a Mermaid flow graph in HTML mode.`,valueShape:`{ nodes: Array<{ id: string; label?: string }>; edges: Array<{ from: string; to: string; label?: string }> }`,vendorScripts:[`mermaid`],relevantSkills:[`present`,`c4-architecture`]},{type:`chart`,category:`data`,description:`Structured chart definition rendered as SVG.`,valueShape:`{ chartType: string; data: Record<string, unknown>[]; xKey: string; yKeys: string[] }`,relevantSkills:[`present`]},{type:`timeline`,category:`interactive`,description:`Timeline entries rendered as a vertical sequence of events.`,valueShape:`Array<{ title: string; description?: string; timestamp?: string; status?: string }>`,relevantSkills:[`present`]},{type:`checklist`,category:`interactive`,description:`Checklist items with boolean checked state.`,valueShape:`Array<{label, checked}> | {items: Array<{label, checked}>}`,relevantSkills:[`present`]},{type:`comparison`,category:`interactive`,description:`Side-by-side comparison columns with titled item lists.`,valueShape:`Array<{title, items}> | {columns: Array<{title, items}>}`,relevantSkills:[`present`]},{type:`status-board`,category:`interactive`,description:`Status categories containing labeled status items.`,valueShape:`Array<{category, items}> | {items: Array<{category, items}>}`,relevantSkills:[`present`]},{type:`prompt`,category:`interactive`,description:`Prompt payload rendered through the prompt display helper.`,valueShape:`unknown`,relevantSkills:[`present`]},{type:`progress`,category:`interactive`,description:`Progress bar with current value and optional maximum.`,valueShape:`{label, value, max?} | {items: Array<{label, value, max?, color?}>}`,relevantSkills:[`present`]},{type:`docs-browser`,category:`interactive`,description:`Documentation file list with inline content previews for chat-safe rendering.`,valueShape:`{ files: Array<{ path: string; title?: string; content?: string; status?: "current" | "stale" | "missing" }>; title?: string }`,relevantSkills:[`present`,`docs`],usageExample:`{
|
|
276
276
|
type: 'docs-browser',
|
|
277
277
|
value: {
|
|
278
278
|
title: 'Project Docs',
|
|
@@ -281,7 +281,7 @@ None.`:`### Stale Lessons\n${l.map(e=>`- **${e.title}** (\`${e.path}\`) — effe
|
|
|
281
281
|
{ path: 'docs/api.md', title: 'API Reference', status: 'stale' },
|
|
282
282
|
],
|
|
283
283
|
},
|
|
284
|
-
}`},{type:`text`,category:`content`,description:`Plain text content rendered through the markdown parser.`,valueShape:`string`},{type:`heading`,category:`content`,description:`Single heading with configurable level from h1 to h6.`,valueShape:`string`},{type:`paragraph`,category:`content`,description:`Single paragraph rendered inside a p tag.`,valueShape:`string`},{type:`separator`,category:`layout`,description:`Horizontal rule used to separate adjacent blocks.`,valueShape:`undefined`},{type:`actions`,category:`layout`,description:`Action bar containing button and select action definitions.`,valueShape:`Array<{ type: string; id: string; label: string; variant?: string; options?: Array<string | { label: string; value: string }> }>`}].map(e=>[e.type,{...e}]));function mp(){let e={};for(let[t,n]of pp)n.vendorScripts?.length&&(e[t]=n.vendorScripts);return e}const hp=1024,gp=new Set([`user-closed`,`host-dismissed`,`replaced`]);function _p(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function vp(e,t,n){let r={code:e,message:t};return n!==void 0&&(r.details=n),{kind:`error`,error:r}}function yp(e,t,n,r){e.writeHead(t,{"Content-Type":`application/json`,"Access-Control-Allow-Origin":r??`null`}),e.end(JSON.stringify(n))}async function bp(e){return await new Promise((t,n)=>{let r=[],i=0;e.on(`data`,t=>{if(i+=t.length,i>65536){n(Error(`Callback payload exceeds 64KB limit`)),e.destroy();return}r.push(t)}),e.on(`end`,()=>t(Buffer.concat(r).toString(`utf8`))),e.on(`error`,n)})}function xp(e,t){if(typeof e!=`string`||e.length!==t.length)return!1;let n=Buffer.from(e,`utf8`),r=Buffer.from(t,`utf8`);return n.length===r.length?le(n,r):!1}function Sp(e,t){let n=e.headers.origin;if(n!=null)return n===t;let r=e.headers.referer;return r==null?!1:r.startsWith(t)}function Cp(e){return(e.headers[`content-type`]??``).startsWith(`application/json`)}function wp(e){for(let[t,n]of Object.entries(e)){let e=typeof n==`string`?n:JSON.stringify(n);if(Buffer.byteLength(e,`utf8`)>8192)return`Form field "${t}" exceeds 8KB limit`}return null}function Tp(e){return Array.isArray(e)&&e.length>hp?`Selection exceeds ${hp} items (got ${e.length})`:null}function Ep(e,t,n){let r=typeof e.actionId==`string`?e.actionId:``,i=n.find(e=>e.id===r);if(!i)return vp(`INVALID_ACTION`,`Unknown actionId: ${r||`(missing)`}`);let a=typeof e.selection==`string`||Array.isArray(e.selection)?e.selection:void 0,o=_p(e.formData)?e.formData:void 0,s={surfaceId:t,actionId:i.id,actionType:i.type,timestamp:typeof e.timestamp==`string`?e.timestamp:new Date().toISOString(),sourceTransport:`browser`};return e.value!==void 0&&(s.value=e.value),a!==void 0&&(s.selection=a),o!==void 0&&(s.formData=o),typeof e.label==`string`?s.label=e.label:i.label&&(s.label=i.label),{kind:`result`,result:s}}function Dp(e,t){let n=se(16).toString(`hex`),r=!1,i=!1,a,o,s=new Promise(e=>{o=e}),c=e=>r?a??e:(r=!0,a=e,o?.(e),e);return{nonce:n,promise:s,settleTimeout(e){return c({kind:`timeout`,waitedMs:e})},settleCancelled(e){return c({kind:`cancelled`,reason:e})},settleError(e,t,n){return c(vp(e,t,n))},async handle(r,a,o){if(!Cp(r)){let e=c(vp(`INVALID_CONTENT_TYPE`,`Content-Type must be application/json`));return yp(a,415,{ok:!1,error:`unsupported-media-type`},o),e}if(!Sp(r,o)){let e=c(vp(`INVALID_ORIGIN`,`Unexpected callback origin: ${r.headers.origin??r.headers.referer??`(missing)`}`));return yp(a,403,{ok:!1,error:`invalid-origin`},o),e}let s=``;try{s=await bp(r)}catch(e){let t=c(vp(`INVALID_PAYLOAD`,e instanceof Error?e.message:`Unable to read callback payload`));return yp(a,413,{ok:!1,error:`payload-too-large`},o),t}let l;try{let e=JSON.parse(s);if(!_p(e))throw Error(`Callback payload must be an object`);l=e}catch(e){let t=c(vp(`INVALID_PAYLOAD`,e instanceof Error?e.message:`Malformed callback payload`));return yp(a,400,{ok:!1,error:`invalid-json`},o),t}if(i){let e=vp(`NONCE_CONSUMED`,`Nonce has already been used`);return yp(a,403,{ok:!1,error:`nonce-consumed`},o),e}if(!xp(typeof l.nonce==`string`?l.nonce:``,n)){let e=c(vp(`INVALID_NONCE`,`Callback nonce did not match`));return yp(a,403,{ok:!1,error:`invalid-nonce`},o),e}i=!0;let u=Tp(l.selection);if(u){let e=c(vp(`SELECTION_TOO_LARGE`,u));return yp(a,413,{ok:!1,error:`selection-too-large`},o),e}if(_p(l.formData)){let e=wp(l.formData);if(e){let t=c(vp(`PAYLOAD_FIELD_TOO_LARGE`,e));return yp(a,413,{ok:!1,error:`field-too-large`},o),t}}if(l.kind===`cancelled`){let e=typeof l.reason==`string`?l.reason:``;if(!gp.has(e)){let t=c(vp(`INVALID_CANCEL_REASON`,`Unsupported cancel reason: ${e||`(missing)`}`));return yp(a,400,{ok:!1,error:`invalid-cancel-reason`},o),t}let t=c({kind:`cancelled`,reason:e});return yp(a,200,{ok:!0,kind:`cancelled`},o),t}let d=c(Ep(l,e,t));return yp(a,d.kind===`error`?400:200,{ok:d.kind!==`error`,kind:d.kind},o),d}}}const Op=new Map;function kp(e){return e.replace(/[|\\{}()[\]^$+*?.]/g,`\\$&`)}function Ap(e){let t=`(?=[^>]*\\bid=['"]${kp(e)}['"])`;return RegExp(`(<script\\b(?=[^>]*\\btype=['"]application\\/json['"])${t}[^>]*>)[\\s\\S]*?(<\/script>)`,`i`)}function jp(e){Op.has(e.id)&&console.warn(`[viewer-registry] Overwriting viewer template "${e.id}"`),Op.set(e.id,e)}function Mp(e){return Op.get(e)}function Np(e){return typeof e==`string`&&Op.has(e)}function Pp(){return[...Op.values()]}function Fp(e,t,n,r){let i=Ap(n);if(!i.test(e))throw Error(`No <script type="application/json" id="${n}"> found in template`);let a=r?r(t):t,o=JSON.stringify(a??null).replace(/<\/script/gi,`<\\/script`).replace(/<script/gi,`\\u003Cscript`).replace(/-->/g,`--\\u003E`).replace(/<!--/g,`\\u003C!--`);return e.replace(i,`$1\n${o}\n$2`)}const Ip=import.meta.dirname??_e(xe(import.meta.url)),Lp={type:`object`,properties:{title:{type:`string`},description:{type:`string`},layout:{type:`object`,properties:{direction:{type:`string`},spacing:{type:`number`},layerSpacing:{type:`number`}}},nodes:{type:`array`,items:{type:`object`,properties:{id:{type:`string`},type:{type:`string`,enum:[`person`,`system`,`container`,`component`,`database`,`queue`,`external`,`boundary`]},label:{type:`string`},technology:{type:`string`},icon:{type:`string`},description:{type:`string`}},required:[`id`,`type`,`label`]}},edges:{type:`array`,items:{type:`object`,properties:{source:{type:`string`},target:{type:`string`},label:{type:`string`},style:{type:`string`,enum:[`sync`,`async`,`dashed`,`dotted`,`solid`]}},required:[`source`,`target`]},default:[]}},required:[`nodes`]},Rp={type:`object`,properties:{nodes:{type:`array`,items:{type:`object`,properties:{id:{type:`string`},label:{type:`string`},type:{type:`string`,enum:[`start-end`,`manual`,`automated`,`integration`,`decision`,`prerequisite`]},description:{type:`string`}},required:[`id`,`label`]}},edges:{type:`array`,items:{type:`object`,properties:{source:{type:`string`},target:{type:`string`},label:{type:`string`},type:{type:`string`,enum:[`standard`,`loop-back`,`exception`]}},required:[`source`,`target`]}}},required:[`nodes`]},zp={type:`object`,properties:{title:{type:`string`},description:{type:`string`},phases:{type:`array`,items:{type:`object`,properties:{id:{type:`string`},label:{type:`string`},outcome:{type:`string`},batches:{type:`array`,items:{type:`object`,properties:{id:{type:`string`},order:{type:`number`},parallel:{type:`boolean`},label:{type:`string`},tasks:{type:`array`,items:{type:`object`,properties:{id:{type:`string`},title:{type:`string`},agent:{type:`string`},files:{type:`array`,items:{type:`string`},default:[]},status:{type:`string`,enum:[`pending`,`in-progress`,`done`,`blocked`]},dependsOn:{type:`array`,items:{type:`string`},default:[]}},required:[`id`,`title`]},default:[]}},required:[`id`,`tasks`]},default:[]}},required:[`id`,`label`,`batches`]}}},required:[`phases`]};function Bp(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function Vp(e,t){return Bp(t)?{...t,kind:e}:{kind:e}}function Hp(e){let t=e===`canvas.html`?[N(Ip,`..`,`..`,`..`,`..`,`..`,`scaffold`,`general`,`viewers`,`src`,`canvas`,`index.html`),N(Ip,`..`,`..`,`scaffold`,`general`,`viewers`,`src`,`canvas`,`index.html`)]:[],n=S(`server`,[N(`viewers`,`dist`,e),N(`viewers`,e)]),r=[...t,...n?[n]:[],N(Ip,`..`,`..`,`..`,`viewers`,e),N(Ip,`..`,`..`,`..`,`..`,`..`,`scaffold`,`general`,`viewers`,`src`,`static`,e),N(Ip,`..`,`..`,`..`,`..`,`..`,`scaffold`,`general`,`viewers`,`dist`,e),N(Ip,`..`,`..`,`..`,`..`,`..`,`scaffold`,`general`,`viewers`,e),N(Ip,`..`,`..`,`scaffold`,`general`,`viewers`,`dist`,e),N(Ip,`..`,`..`,`scaffold`,`general`,`viewers`,e),N(Ip,`..`,`viewers`,`dist`,e),N(Ip,`..`,`viewers`,e)];for(let e of r)try{return M(e,`utf8`)}catch{}throw Error(`Viewer HTML not found: ${e}. Searched: ${r.join(`, `)}`)}let Up,Wp,Gp,Kp,qp,Jp;function Yp(){return Up??=Hp(`c4-viewer.html`),Up}function Xp(){return Wp??=Hp(`tour-viewer.html`),Wp}function Zp(){return Gp??=Hp(`canvas.html`),Gp}function Qp(){return Kp??=Hp(`architecture-static.html`),Kp}function $p(){return qp??=Hp(`process-flow-static.html`),qp}function em(){return Jp??=Hp(`task-plan-static.html`),Jp}function tm(){jp({id:`c4@1`,label:`C4 Architecture Diagram`,description:`Interactive C4 architecture diagram with zoom, pan, and ELK auto-layout`,inputSchema:Lp,injectId:`diagram-data`,supportedTransports:[`browser`],resolveHtml:Yp}),jp({id:`c4-static@1`,label:`C4 Architecture Diagram (Static)`,description:`Static SVG architecture diagram for inline rendering`,inputSchema:Lp,injectId:`diagram-data`,supportedTransports:[`mcp-app`],resolveHtml:Qp}),jp({id:`tour@1`,label:`Code Tour Viewer`,description:`Interactive code tour with step navigation and dependency graph`,inputSchema:{type:`object`,properties:{title:{type:`string`},description:{type:`string`},estimatedTime:{type:`string`},steps:{type:`array`,items:{type:`object`,properties:{stepNumber:{type:`number`},id:{type:`string`},title:{type:`string`},file:{type:`string`},explanation:{type:`string`},description:{type:`string`},learnsConcept:{type:`string`},duration:{type:`string`},line:{type:`number`},code:{type:`string`}},required:[`id`,`title`]}},dependencies:{type:`array`,items:{type:`object`,properties:{source:{type:`string`},target:{type:`string`}},required:[`source`,`target`]},default:[]}},required:[`steps`]},injectId:`tour-data`,supportedTransports:[`browser`],resolveHtml:Xp}),jp({id:`process-flow-static@1`,label:`Process Flow Diagram (Static)`,description:`Static SVG process flow diagram for inline rendering`,inputSchema:Rp,injectId:`diagram-data`,supportedTransports:[`mcp-app`],resolveHtml:$p}),jp({id:`task-plan-static@1`,label:`Task Execution Plan (Static)`,description:`Static SVG task execution plan for inline rendering`,inputSchema:zp,injectId:`diagram-data`,supportedTransports:[`mcp-app`],resolveHtml:em}),jp({id:`task-plan@1`,label:`Task Execution Plan (Interactive)`,description:`Interactive task execution plan with ReactFlow, phase grouping, and dependency edges`,inputSchema:zp,injectId:`diagram-data`,supportedTransports:[`browser`],resolveHtml:Zp,transformData:e=>Vp(`task-plan`,e)}),jp({id:`process-flow@1`,label:`Process Flow Diagram (Interactive)`,description:`Interactive process flow diagram with ReactFlow`,inputSchema:Rp,injectId:`diagram-data`,supportedTransports:[`browser`],resolveHtml:Zp,transformData:e=>Vp(`process-flow`,e)})}function nm(){let e=new xr;for(let t of wr.list())e.register(t);return e.register(Cr),e.register(Or),e.register(kr),e.register(Tr),e}function rm(e,t){return e?.supportedTransports.includes(t)??!1}const im=nm();function am(e){if(e.template)return im.get(e.template)}function om(e){if((e.actions?.length??0)>0)return!0;if(e.template&&Np(e.template)){let t=Mp(e.template);return t?.supportedTransports.includes(`browser`)===!0&&!t.supportedTransports.includes(`mcp-app`)}let t=am(e);return rm(t,`browser`)&&!rm(t,`mcp-app`)}tm();const sm=String.raw`(function(){
|
|
284
|
+
}`},{type:`text`,category:`content`,description:`Plain text content rendered through the markdown parser.`,valueShape:`string`},{type:`heading`,category:`content`,description:`Single heading with configurable level from h1 to h6.`,valueShape:`string`},{type:`paragraph`,category:`content`,description:`Single paragraph rendered inside a p tag.`,valueShape:`string`},{type:`separator`,category:`layout`,description:`Horizontal rule used to separate adjacent blocks.`,valueShape:`undefined`},{type:`actions`,category:`layout`,description:`Action bar containing button and select action definitions.`,valueShape:`Array<{ type: string; id: string; label: string; variant?: string; options?: Array<string | { label: string; value: string }> }>`}].map(e=>[e.type,{...e}]));function gp(){let e={};for(let[t,n]of hp)n.vendorScripts?.length&&(e[t]=n.vendorScripts);return e}const _p=1024,vp=new Set([`user-closed`,`host-dismissed`,`replaced`]);function yp(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function bp(e,t,n){let r={code:e,message:t};return n!==void 0&&(r.details=n),{kind:`error`,error:r}}function xp(e,t,n,r){e.writeHead(t,{"Content-Type":`application/json`,"Access-Control-Allow-Origin":r??`null`}),e.end(JSON.stringify(n))}async function Sp(e){return await new Promise((t,n)=>{let r=[],i=0;e.on(`data`,t=>{if(i+=t.length,i>65536){n(Error(`Callback payload exceeds 64KB limit`)),e.destroy();return}r.push(t)}),e.on(`end`,()=>t(Buffer.concat(r).toString(`utf8`))),e.on(`error`,n)})}function Cp(e,t){if(typeof e!=`string`||e.length!==t.length)return!1;let n=Buffer.from(e,`utf8`),r=Buffer.from(t,`utf8`);return n.length===r.length?le(n,r):!1}function wp(e,t){let n=e.headers.origin;if(n!=null)return n===t;let r=e.headers.referer;return r==null?!1:r.startsWith(t)}function Tp(e){return(e.headers[`content-type`]??``).startsWith(`application/json`)}function Ep(e){for(let[t,n]of Object.entries(e)){let e=typeof n==`string`?n:JSON.stringify(n);if(Buffer.byteLength(e,`utf8`)>8192)return`Form field "${t}" exceeds 8KB limit`}return null}function Dp(e){return Array.isArray(e)&&e.length>_p?`Selection exceeds ${_p} items (got ${e.length})`:null}function Op(e,t,n){let r=typeof e.actionId==`string`?e.actionId:``,i=n.find(e=>e.id===r);if(!i)return bp(`INVALID_ACTION`,`Unknown actionId: ${r||`(missing)`}`);let a=typeof e.selection==`string`||Array.isArray(e.selection)?e.selection:void 0,o=yp(e.formData)?e.formData:void 0,s={surfaceId:t,actionId:i.id,actionType:i.type,timestamp:typeof e.timestamp==`string`?e.timestamp:new Date().toISOString(),sourceTransport:`browser`};return e.value!==void 0&&(s.value=e.value),a!==void 0&&(s.selection=a),o!==void 0&&(s.formData=o),typeof e.label==`string`?s.label=e.label:i.label&&(s.label=i.label),{kind:`result`,result:s}}function kp(e,t){let n=se(16).toString(`hex`),r=!1,i=!1,a,o,s=new Promise(e=>{o=e}),c=e=>r?a??e:(r=!0,a=e,o?.(e),e);return{nonce:n,promise:s,settleTimeout(e){return c({kind:`timeout`,waitedMs:e})},settleCancelled(e){return c({kind:`cancelled`,reason:e})},settleError(e,t,n){return c(bp(e,t,n))},async handle(r,a,o){if(!Tp(r)){let e=c(bp(`INVALID_CONTENT_TYPE`,`Content-Type must be application/json`));return xp(a,415,{ok:!1,error:`unsupported-media-type`},o),e}if(!wp(r,o)){let e=c(bp(`INVALID_ORIGIN`,`Unexpected callback origin: ${r.headers.origin??r.headers.referer??`(missing)`}`));return xp(a,403,{ok:!1,error:`invalid-origin`},o),e}let s=``;try{s=await Sp(r)}catch(e){let t=c(bp(`INVALID_PAYLOAD`,e instanceof Error?e.message:`Unable to read callback payload`));return xp(a,413,{ok:!1,error:`payload-too-large`},o),t}let l;try{let e=JSON.parse(s);if(!yp(e))throw Error(`Callback payload must be an object`);l=e}catch(e){let t=c(bp(`INVALID_PAYLOAD`,e instanceof Error?e.message:`Malformed callback payload`));return xp(a,400,{ok:!1,error:`invalid-json`},o),t}if(i){let e=bp(`NONCE_CONSUMED`,`Nonce has already been used`);return xp(a,403,{ok:!1,error:`nonce-consumed`},o),e}if(!Cp(typeof l.nonce==`string`?l.nonce:``,n)){let e=c(bp(`INVALID_NONCE`,`Callback nonce did not match`));return xp(a,403,{ok:!1,error:`invalid-nonce`},o),e}i=!0;let u=Dp(l.selection);if(u){let e=c(bp(`SELECTION_TOO_LARGE`,u));return xp(a,413,{ok:!1,error:`selection-too-large`},o),e}if(yp(l.formData)){let e=Ep(l.formData);if(e){let t=c(bp(`PAYLOAD_FIELD_TOO_LARGE`,e));return xp(a,413,{ok:!1,error:`field-too-large`},o),t}}if(l.kind===`cancelled`){let e=typeof l.reason==`string`?l.reason:``;if(!vp.has(e)){let t=c(bp(`INVALID_CANCEL_REASON`,`Unsupported cancel reason: ${e||`(missing)`}`));return xp(a,400,{ok:!1,error:`invalid-cancel-reason`},o),t}let t=c({kind:`cancelled`,reason:e});return xp(a,200,{ok:!0,kind:`cancelled`},o),t}let d=c(Op(l,e,t));return xp(a,d.kind===`error`?400:200,{ok:d.kind!==`error`,kind:d.kind},o),d}}}const Ap=new Map;function jp(e){return e.replace(/[|\\{}()[\]^$+*?.]/g,`\\$&`)}function Mp(e){let t=`(?=[^>]*\\bid=['"]${jp(e)}['"])`;return RegExp(`(<script\\b(?=[^>]*\\btype=['"]application\\/json['"])${t}[^>]*>)[\\s\\S]*?(<\/script>)`,`i`)}function Np(e){Ap.has(e.id)&&console.warn(`[viewer-registry] Overwriting viewer template "${e.id}"`),Ap.set(e.id,e)}function Pp(e){return Ap.get(e)}function Fp(e){return typeof e==`string`&&Ap.has(e)}function Ip(){return[...Ap.values()]}function Lp(e,t,n,r){let i=Mp(n);if(!i.test(e))throw Error(`No <script type="application/json" id="${n}"> found in template`);let a=r?r(t):t,o=JSON.stringify(a??null).replace(/<\/script/gi,`<\\/script`).replace(/<script/gi,`\\u003Cscript`).replace(/-->/g,`--\\u003E`).replace(/<!--/g,`\\u003C!--`);return e.replace(i,`$1\n${o}\n$2`)}const Rp=import.meta.dirname??_e(xe(import.meta.url)),zp={type:`object`,properties:{title:{type:`string`},description:{type:`string`},layout:{type:`object`,properties:{direction:{type:`string`},spacing:{type:`number`},layerSpacing:{type:`number`}}},nodes:{type:`array`,items:{type:`object`,properties:{id:{type:`string`},type:{type:`string`,enum:[`person`,`system`,`container`,`component`,`database`,`queue`,`external`,`boundary`]},label:{type:`string`},technology:{type:`string`},icon:{type:`string`},description:{type:`string`}},required:[`id`,`type`,`label`]}},edges:{type:`array`,items:{type:`object`,properties:{source:{type:`string`},target:{type:`string`},label:{type:`string`},style:{type:`string`,enum:[`sync`,`async`,`dashed`,`dotted`,`solid`]}},required:[`source`,`target`]},default:[]}},required:[`nodes`]},Bp={type:`object`,properties:{nodes:{type:`array`,items:{type:`object`,properties:{id:{type:`string`},label:{type:`string`},type:{type:`string`,enum:[`start-end`,`manual`,`automated`,`integration`,`decision`,`prerequisite`]},description:{type:`string`}},required:[`id`,`label`]}},edges:{type:`array`,items:{type:`object`,properties:{source:{type:`string`},target:{type:`string`},label:{type:`string`},type:{type:`string`,enum:[`standard`,`loop-back`,`exception`]}},required:[`source`,`target`]}}},required:[`nodes`]},Vp={type:`object`,properties:{title:{type:`string`},description:{type:`string`},phases:{type:`array`,items:{type:`object`,properties:{id:{type:`string`},label:{type:`string`},outcome:{type:`string`},batches:{type:`array`,items:{type:`object`,properties:{id:{type:`string`},order:{type:`number`},parallel:{type:`boolean`},label:{type:`string`},tasks:{type:`array`,items:{type:`object`,properties:{id:{type:`string`},title:{type:`string`},agent:{type:`string`},files:{type:`array`,items:{type:`string`},default:[]},status:{type:`string`,enum:[`pending`,`in-progress`,`done`,`blocked`]},dependsOn:{type:`array`,items:{type:`string`},default:[]}},required:[`id`,`title`]},default:[]}},required:[`id`,`tasks`]},default:[]}},required:[`id`,`label`,`batches`]}}},required:[`phases`]};function Hp(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function Up(e,t){return Hp(t)?{...t,kind:e}:{kind:e}}function Wp(e){let t=e===`canvas.html`?[N(Rp,`..`,`..`,`..`,`..`,`..`,`scaffold`,`general`,`viewers`,`src`,`canvas`,`index.html`),N(Rp,`..`,`..`,`scaffold`,`general`,`viewers`,`src`,`canvas`,`index.html`)]:[],n=S(`server`,[N(`viewers`,`dist`,e),N(`viewers`,e)]),r=[...t,...n?[n]:[],N(Rp,`..`,`..`,`..`,`viewers`,e),N(Rp,`..`,`..`,`..`,`..`,`..`,`scaffold`,`general`,`viewers`,`src`,`static`,e),N(Rp,`..`,`..`,`..`,`..`,`..`,`scaffold`,`general`,`viewers`,`dist`,e),N(Rp,`..`,`..`,`..`,`..`,`..`,`scaffold`,`general`,`viewers`,e),N(Rp,`..`,`..`,`scaffold`,`general`,`viewers`,`dist`,e),N(Rp,`..`,`..`,`scaffold`,`general`,`viewers`,e),N(Rp,`..`,`viewers`,`dist`,e),N(Rp,`..`,`viewers`,e)];for(let e of r)try{return M(e,`utf8`)}catch{}throw Error(`Viewer HTML not found: ${e}. Searched: ${r.join(`, `)}`)}let Gp,Kp,qp,Jp,Yp,Xp;function Zp(){return Gp??=Wp(`c4-viewer.html`),Gp}function Qp(){return Kp??=Wp(`tour-viewer.html`),Kp}function $p(){return qp??=Wp(`canvas.html`),qp}function em(){return Jp??=Wp(`architecture-static.html`),Jp}function tm(){return Yp??=Wp(`process-flow-static.html`),Yp}function nm(){return Xp??=Wp(`task-plan-static.html`),Xp}function rm(){Np({id:`c4@1`,label:`C4 Architecture Diagram`,description:`Interactive C4 architecture diagram with zoom, pan, and ELK auto-layout`,inputSchema:zp,injectId:`diagram-data`,supportedTransports:[`browser`],resolveHtml:Zp}),Np({id:`c4-static@1`,label:`C4 Architecture Diagram (Static)`,description:`Static SVG architecture diagram for inline rendering`,inputSchema:zp,injectId:`diagram-data`,supportedTransports:[`mcp-app`],resolveHtml:em}),Np({id:`tour@1`,label:`Code Tour Viewer`,description:`Interactive code tour with step navigation and dependency graph`,inputSchema:{type:`object`,properties:{title:{type:`string`},description:{type:`string`},estimatedTime:{type:`string`},steps:{type:`array`,items:{type:`object`,properties:{stepNumber:{type:`number`},id:{type:`string`},title:{type:`string`},file:{type:`string`},explanation:{type:`string`},description:{type:`string`},learnsConcept:{type:`string`},duration:{type:`string`},line:{type:`number`},code:{type:`string`}},required:[`id`,`title`]}},dependencies:{type:`array`,items:{type:`object`,properties:{source:{type:`string`},target:{type:`string`}},required:[`source`,`target`]},default:[]}},required:[`steps`]},injectId:`tour-data`,supportedTransports:[`browser`],resolveHtml:Qp}),Np({id:`process-flow-static@1`,label:`Process Flow Diagram (Static)`,description:`Static SVG process flow diagram for inline rendering`,inputSchema:Bp,injectId:`diagram-data`,supportedTransports:[`mcp-app`],resolveHtml:tm}),Np({id:`task-plan-static@1`,label:`Task Execution Plan (Static)`,description:`Static SVG task execution plan for inline rendering`,inputSchema:Vp,injectId:`diagram-data`,supportedTransports:[`mcp-app`],resolveHtml:nm}),Np({id:`task-plan@1`,label:`Task Execution Plan (Interactive)`,description:`Interactive task execution plan with ReactFlow, phase grouping, and dependency edges`,inputSchema:Vp,injectId:`diagram-data`,supportedTransports:[`browser`],resolveHtml:$p,transformData:e=>Up(`task-plan`,e)}),Np({id:`process-flow@1`,label:`Process Flow Diagram (Interactive)`,description:`Interactive process flow diagram with ReactFlow`,inputSchema:Bp,injectId:`diagram-data`,supportedTransports:[`browser`],resolveHtml:$p,transformData:e=>Up(`process-flow`,e)})}function im(){let e=new xr;for(let t of wr.list())e.register(t);return e.register(Cr),e.register(Or),e.register(kr),e.register(Tr),e}function am(e,t){return e?.supportedTransports.includes(t)??!1}const om=im();function sm(e){if(e.template)return om.get(e.template)}function cm(e){if((e.actions?.length??0)>0)return!0;if(e.template&&Fp(e.template)){let t=Pp(e.template);return t?.supportedTransports.includes(`browser`)===!0&&!t.supportedTransports.includes(`mcp-app`)}let t=sm(e);return am(t,`browser`)&&!am(t,`mcp-app`)}rm();const lm=String.raw`(function(){
|
|
285
285
|
'use strict';
|
|
286
286
|
|
|
287
287
|
var SVG_NS = 'http://www.w3.org/2000/svg';
|
|
@@ -2657,7 +2657,7 @@ None.`:`### Stale Lessons\n${l.map(e=>`- **${e.title}** (\`${e.path}\`) — effe
|
|
|
2657
2657
|
};
|
|
2658
2658
|
|
|
2659
2659
|
init();
|
|
2660
|
-
})();`;function
|
|
2660
|
+
})();`;function um(){let e;return()=>{if(e!==void 0)return e;try{e=M(oe(import.meta.url).resolve(`mermaid/dist/mermaid.min.js`),`utf-8`)}catch{e=``}return e}}const dm={id:`mermaid`,cdn:`https://cdn.jsdelivr.net/npm/mermaid@11/dist/mermaid.min.js`,inlineSource:lm,initScript:`window.__aikit_initMermaid = function() {
|
|
2661
2661
|
if (typeof mermaid === 'undefined') return;
|
|
2662
2662
|
if (document.readyState === 'loading') {
|
|
2663
2663
|
document.addEventListener('DOMContentLoaded', window.__aikit_initMermaid);
|
|
@@ -2670,8 +2670,8 @@ None.`:`### Stale Lessons\n${l.map(e=>`- **${e.title}** (\`${e.path}\`) — effe
|
|
|
2670
2670
|
}
|
|
2671
2671
|
mermaid.initialize({ startOnLoad: false, theme: theme });
|
|
2672
2672
|
mermaid.run();
|
|
2673
|
-
};`,onload:`window.__aikit_initMermaid&&window.__aikit_initMermaid()`,local:{route:`/vendor/mermaid.min.js`,getSource:
|
|
2674
|
-
`)}function
|
|
2673
|
+
};`,onload:`window.__aikit_initMermaid&&window.__aikit_initMermaid()`,local:{route:`/vendor/mermaid.min.js`,getSource:um()}},fm=new Map([[`mermaid`,dm]]);function pm(e,t){if(!e?.length)return;let n=[];for(let r of e){let e=fm.get(r);if(e){if(t===`browser`){n.push({inlineSource:e.inlineSource,onload:e.onload});continue}if(t===`mcp-app`){n.push({inlineSource:e.inlineSource,onload:e.onload});continue}n.push({src:e.cdn,initScript:e.initScript,onload:e.onload})}}return n.length>0?n:void 0}function mm(){let e=[];for(let t of fm.values())t.local&&e.push({route:t.local.route,getSource:t.local.getSource,cdn:t.cdn});return e}const hm=300*1e3,gm=15*1e3;let Z=null,_m;process.on(`exit`,()=>{let e=Z;if(e){try{e.close()}catch{}Z=null}});function vm(e){let t=typeof e.description==`string`&&e.description.trim().length>0?`<p class="present-surface-description">${J(e.description)}</p>`:``;return[`<h1 class="present-surface-title">${J(e.title)}</h1>`,t].filter(Boolean).join(`
|
|
2674
|
+
`)}function ym(e,t){return e.length===0?``:`
|
|
2675
2675
|
<section class="present-surface-actions">
|
|
2676
2676
|
<div class="present-action-bar">${e.map(e=>{let t=J(e.id),n=J(e.label);if(e.type===`select`||e.type===`multi-select`)return`<label class="present-action-field"><span>${n}</span><select data-action-id="${t}"${e.type===`multi-select`?` multiple`:``}>${(e.options??[]).map(e=>`<option value="${J(e.value)}">${J(e.label)}</option>`).join(``)}</select></label>`;if(e.type===`text-submit`)return`<label class="present-action-field"><span>${n}</span><div class="present-text-submit"><input type="text" class="present-text-input" data-action-id="${t}" data-action-label="${n}" placeholder="${n}" /><button type="button" class="present-action-btn present-action-primary present-submit-btn" data-submit-for="${t}">Send</button></div></label>`;if(e.type===`form-submit`){let r=e.schema;if(r)return`<form class="present-form" data-action-id="${t}" data-action-label="${n}">${Object.entries(r).map(([e,t])=>{let n=J(t.description??e);return`<label class="present-action-field"><span>${n}</span><input type="${t.type===`number`?`number`:t.type===`boolean`?`checkbox`:`text`}" class="present-text-input" name="${J(e)}" placeholder="${n}" /></label>`}).join(``)}<button type="submit" class="present-action-btn present-action-primary">${n}</button></form>`}return`<button type="button" class="present-action-btn present-action-${J(e.variant??`default`)}" data-action-id="${t}" data-action-label="${n}">${n}</button>`}).join(``)}</div>
|
|
2677
2677
|
<p id="present-action-status" class="present-action-status" aria-live="polite"></p>
|
|
@@ -2876,8 +2876,8 @@ None.`:`### Stale Lessons\n${l.map(e=>`- **${e.title}** (\`${e.path}\`) — effe
|
|
|
2876
2876
|
navigator.sendBeacon('/callback', new Blob([body], { type: 'application/json' }));
|
|
2877
2877
|
});
|
|
2878
2878
|
})();
|
|
2879
|
-
<\/script>`}function
|
|
2880
|
-
`)}function
|
|
2879
|
+
<\/script>`}function bm(e){try{if(process.platform===`win32`){yr(`cmd`,[`/c`,`start`,``,e],{windowsHide:!0});return}if(process.platform===`darwin`){yr(`open`,[e]);return}yr(`xdg-open`,[e])}catch{}}async function xm(e){try{let t=Gn();return await t.launch(`ui`),t.resetIdleTimer(),await(await t.getContext().newPage()).goto(e,{waitUntil:`domcontentloaded`}),!0}catch{return bm(e),!1}}function Sm(e,t,n){let r=[e.title];return e.description&&r.push(e.description),r.push(``,`Opened in browser at ${t}`,n),r.join(`
|
|
2880
|
+
`)}function Cm(e){return e.some(e=>e.id!==`__dismiss`)}function wm(){return _m===void 0&&(_m=C(`blocks-interactive`)),_m}function Tm(e){let t=e?.split(`?`)[0];if(!t?.startsWith(`/@aikit/blocks-interactive/dist/`))return;let n=wm();if(n)return N(n,`dist`,t.slice(32))}function Em(e){return e.replace(`</head>`,`<style>
|
|
2881
2881
|
.toolbar, .badge, body > header, body > footer { display: none !important; }
|
|
2882
2882
|
body { padding-top: 0 !important; margin-top: 0 !important; }
|
|
2883
2883
|
</style>
|
|
@@ -2888,8 +2888,8 @@ window.addEventListener('message', function(e) {
|
|
|
2888
2888
|
}
|
|
2889
2889
|
});
|
|
2890
2890
|
<\/script>
|
|
2891
|
-
</body>`)}function
|
|
2892
|
-
`);return{content:[{type:`text`,text:`[ERROR:VALIDATION] Template "${t.id}" data validation failed:\n${e}\n\nExpected schema: ${JSON.stringify(t.inputSchema,null,2)}`}],structuredContent:{kind:`error`,error:{code:`VIEWER_DATA_INVALID`,message:`Template "${t.id}" data validation failed:\n${e}\n\nExpected schema: ${JSON.stringify(t.inputSchema,null,2)}`}},isError:!0}}}let n=
|
|
2891
|
+
</body>`)}function Dm(){let e=Z;e&&(Z=null,setTimeout(()=>{try{e.close()}catch{}},2e3))}function Om(e){if(!e.headersSent)try{e.writeHead(500,{"Content-Type":`text/plain`}),e.end(`Internal Server Error`)}catch{try{e.end()}catch{}}}async function km(e,t){if(Fm(`<html><body style="font-family:system-ui;padding:2rem;color:#888;text-align:center"><p>Content opened in browser window.</p></body></html>`),e.data!=null&&t.inputSchema){let n=ln({data:e.data,schema:t.inputSchema});if(!n.valid){let e=n.errors.map(e=>` ${e.path}: ${e.message}${e.expected?` (expected: ${e.expected}, got: ${e.received})`:``}`).join(`
|
|
2892
|
+
`);return{content:[{type:`text`,text:`[ERROR:VALIDATION] Template "${t.id}" data validation failed:\n${e}\n\nExpected schema: ${JSON.stringify(t.inputSchema,null,2)}`}],structuredContent:{kind:`error`,error:{code:`VIEWER_DATA_INVALID`,message:`Template "${t.id}" data validation failed:\n${e}\n\nExpected schema: ${JSON.stringify(t.inputSchema,null,2)}`}},isError:!0}}}let n=Em(Lp(t.resolveHtml(),e.data??null,t.injectId,t.transformData)),r=Sr({title:e.title,html:[vm(e),`<div class="present-viewer-container">`,` <iframe class="present-viewer-iframe" src="/viewer" sandbox="allow-scripts allow-same-origin"></iframe>`,` <script>
|
|
2893
2893
|
(function() {
|
|
2894
2894
|
const iframe = document.querySelector('.present-viewer-iframe');
|
|
2895
2895
|
if (!iframe) return;
|
|
@@ -2905,11 +2905,11 @@ window.addEventListener('message', function(e) {
|
|
|
2905
2905
|
})();
|
|
2906
2906
|
<\/script>`,`</div>`].join(`
|
|
2907
2907
|
`),css:[[`.present-viewer-container {`,` flex: 1;`,` min-height: calc(100vh - 12rem);`,` position: relative;`,` border-radius: 0.75rem;`,` overflow: hidden;`,` border: none;`,`}`,`.present-viewer-iframe {`,` border: none;`,` width: 100%;`,` height: 100%;`,` position: absolute;`,` inset: 0;`,` border-radius: inherit;`,`}`].join(`
|
|
2908
|
-
`)],islands:[],payload:void 0,nonce:``,generatedAt:new Date().toISOString(),colorScheme:e.colorScheme,lang:e.lang,dir:e.dir,transport:`browser`,exportPolicy:`local-interactive`}),i=``;try{
|
|
2909
|
-
`),css:t.css,islands:t.islands,payload:t.payload,nonce:t.nonce,generatedAt:new Date().toISOString(),colorScheme:e.colorScheme,lang:e.lang,dir:e.dir,transport:`browser`,exportPolicy:t.exportPolicy,headScripts:r}),o=``,s=``,c=!1;try{let e=Z;e&&(e.close(),Z=null),o=await new Promise((e,t)=>{let r=jr((e,t)=>{try{if(c=!0,e.method===`OPTIONS`){t.writeHead(204,{"Access-Control-Allow-Origin":s||`*`,"Access-Control-Allow-Methods":`POST`,"Access-Control-Allow-Headers":`Content-Type`}),t.end();return}if(e.method===`POST`&&e.url===`/callback`){n.handle(e,t,s).catch(()=>{
|
|
2910
|
-
`)}),r.length=0)},a=0;for(;a<t.length;){let e=t[a],o=t[a+1];if(o!==void 0&&
|
|
2911
|
-
`)}function
|
|
2912
|
-
`)}const
|
|
2908
|
+
`)],islands:[],payload:void 0,nonce:``,generatedAt:new Date().toISOString(),colorScheme:e.colorScheme,lang:e.lang,dir:e.dir,transport:`browser`,exportPolicy:`local-interactive`}),i=``;try{Dm(),i=await new Promise((e,t)=>{let i=jr((e,t)=>{try{if(e.url===`/viewer`){t.writeHead(200,{"Content-Type":`text/html; charset=utf-8`}),t.end(n);return}t.writeHead(200,{"Content-Type":`text/html; charset=utf-8`}),t.end(r)}catch{Om(t)}});i.listen(0,`127.0.0.1`,()=>{let n=i.address();if(typeof n!=`object`||!n){t(Error(`Failed to resolve local browser address`));return}Z=i,e(`http://127.0.0.1:${n.port}`)})})}catch(t){return{content:[{type:`text`,text:`${e.title}\n\nUnable to start local browser transport.`}],structuredContent:{kind:`error`,error:{code:`BROWSER_START_FAILED`,message:t instanceof Error?t.message:`Unable to start browser transport`}},isError:!0}}await xm(i);let a=Z;return a&&setTimeout(()=>{Z===a&&(a.close(),Z=null)},hm),{content:[{type:`text`,text:Sm(e,i,`Rendered.`)}],structuredContent:{kind:`rendered`,reason:`no-response-required`}}}async function Am(e){Fm(`<html><body style="font-family:system-ui;padding:2rem;color:#888;text-align:center"><p>Content opened in browser window.</p></body></html>`);let t=Ar(e,{transport:`browser`,registry:om,blockVendorScripts:gp()}),n=kp(t.surfaceId,t.actions),r=pm(t.vendorScripts,`browser`),i=mm(),a=Sr({title:e.title,html:[vm(e),t.html,ym(t.actions,n.nonce)].filter(Boolean).join(`
|
|
2909
|
+
`),css:t.css,islands:t.islands,payload:t.payload,nonce:t.nonce,generatedAt:new Date().toISOString(),colorScheme:e.colorScheme,lang:e.lang,dir:e.dir,transport:`browser`,exportPolicy:t.exportPolicy,headScripts:r}),o=``,s=``,c=!1;try{let e=Z;e&&(e.close(),Z=null),o=await new Promise((e,t)=>{let r=jr((e,t)=>{try{if(c=!0,e.method===`OPTIONS`){t.writeHead(204,{"Access-Control-Allow-Origin":s||`*`,"Access-Control-Allow-Methods":`POST`,"Access-Control-Allow-Headers":`Content-Type`}),t.end();return}if(e.method===`POST`&&e.url===`/callback`){n.handle(e,t,s).catch(()=>{Om(t)});return}let r=i.find(t=>e.url===t.route);if(r){let e=r.getSource();if(e){t.writeHead(200,{"Content-Type":`application/javascript; charset=utf-8`,"Cache-Control":`public, max-age=86400`}),t.end(e);return}t.writeHead(302,{Location:r.cdn}),t.end();return}let o=Tm(e.url);if(o)try{let e=M(o,`utf8`);t.writeHead(200,{"Content-Type":`application/javascript; charset=utf-8`}),t.end(e);return}catch{}t.writeHead(200,{"Content-Type":`text/html; charset=utf-8`}),t.end(a)}catch{Om(t)}});r.listen(0,`127.0.0.1`,()=>{let n=r.address();if(typeof n!=`object`||!n){t(Error(`Failed to resolve local browser address`));return}Z=r,s=`http://127.0.0.1:${n.port}`,e(s)})})}catch(t){return{content:[{type:`text`,text:`${e.title}\n\nUnable to start local browser transport.`}],structuredContent:n.settleError(`BROWSER_START_FAILED`,t instanceof Error?t.message:`Unable to start browser transport`),isError:!0}}let l=await xm(o);if(!Cm(t.actions)){let t=Z;return t&&(n.promise.finally(()=>{Z===t&&(t.close(),Z=null)}),setTimeout(()=>{Z===t&&(t.close(),Z=null)},hm)),{content:[{type:`text`,text:Sm(e,o,`Rendered.`)}],structuredContent:{kind:`rendered`,reason:`no-response-required`}}}let u=await Promise.race([n.promise,new Promise(e=>{setTimeout(()=>{c||(Dm(),e(n.settleError(`BROWSER_CONNECT_TIMEOUT`,l?`No browser client connected within ${gm}ms.`:`Fell back to system browser, but no browser client connected within ${gm}ms.`)))},gm)}),new Promise(e=>{setTimeout(()=>e(n.settleTimeout(hm)),hm)})]),d=Z;d&&setTimeout(()=>{Z===d&&(d.close(),Z=null)},hm);let f=u.kind===`result`?`Selected action: ${u.result.actionId}`:u.kind===`timeout`?`Timed out after ${u.waitedMs}ms.`:u.kind===`cancelled`?`Cancelled: ${u.reason}.`:u.kind===`error`?`Error: ${u.error.message}`:`Rendered.`;return{content:[{type:`text`,text:Sm(e,o,f)}],structuredContent:u,isError:u.kind===`error`}}const jm=`ui://aikit/present.html`,Mm=`Install AI Kit with <code>${J(`npx -y @vpxa/aikit@latest init --user`)}</code>.`;let Nm=``;function Pm(){return Nm}function Fm(e){Nm=e}function Im(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}const Lm=/\\u[0-9a-fA-F]{4}/,Rm=/^\s*\|(?:[^|\r\n]+\|){2,}\s*$/,zm=/^\s*\|?(?:\s*:?-{3,}:?\s*\|){2,}\s*$/,Bm=/\b(cli|terminal|tty|console|command(?:-|\s)?line)\b/i;function Vm(e){let t=[e.value,e.markdown,e.text,e.content];for(let e of t)if(typeof e==`string`&&e.trim().length>0)return e}function Hm(e){let t=e.split(/\r?\n/);for(let e=0;e<t.length-1;e+=1)if(Rm.test(t[e])&&zm.test(t[e+1]))return!0;return!1}function Um(e){let t=e.trim().split(`|`),n=+(t[0]?.trim()===``),r=t.at(-1)?.trim()===``?t.length-1:t.length;return t.slice(n,r).map(e=>e.trim())}function Wm(e,t){if(t<2)return!1;let n=e.trim();return n.startsWith(`|`)?Um(n).length===t:!1}function Gm(e){let t=e.split(/\r?\n/),n=[],r=[],i=()=>{r.length!==0&&(n.push({type:`text`,content:r.join(`
|
|
2910
|
+
`)}),r.length=0)},a=0;for(;a<t.length;){let e=t[a],o=t[a+1];if(o!==void 0&&Rm.test(e)&&zm.test(o)){let r=Um(e),o=[];i();let s=a+2;for(;s<t.length&&Wm(t[s],r.length);)o.push(Um(t[s])),s+=1;n.push({type:`table`,headers:r,rows:o}),a=s;continue}r.push(e),a+=1}return i(),n}function Km(e){let t=Vm(e);return!t||!Hm(t)?[e]:Gm(t).flatMap(e=>{if(e.type===`text`){let t=e.content.trim();return t.length>0?[{type:`markdown`,value:t}]:[]}return[{type:`table`,value:{headers:e.headers,rows:e.rows}}]})}function qm(e){if(typeof e==`string`)return Bm.test(e);if(Array.isArray(e))return e.some(e=>qm(e));if(!Im(e))return!1;let t=[`client`,`clientInfo`,`host`,`source`,`mode`,`name`,`title`,`channel`];return Object.entries(e).some(([e,n])=>t.includes(e)?qm(n):!1)}function Jm(e,t){return{preferBrowser:[t,e._meta,Im(e.metadata)?e.metadata.source:void 0].some(e=>qm(e))}}function Ym(e){if(!e.template)return!0;let t=Pp(e.template);return t?t.supportedTransports.includes(`browser`):sm(e)?.supportedTransports.includes(`browser`)??!1}function Xm(e){let t=typeof e.description==`string`&&e.description.trim().length>0?`<p class="present-surface-description">${J(e.description)}</p>`:``;return[`<section class="present-surface-header">`,` <h1>${J(e.title)}</h1>`,t,`</section>`,`<style>`,` .present-surface-header { display: grid; gap: 0.75rem; margin-bottom: 1.5rem; }`,` .present-surface-header h1 { margin: 0; font-size: 1.875rem; }`,` .present-surface-description { margin: 0; color: var(--dt-text-secondary, #475467); }`,`</style>`].filter(Boolean).join(`
|
|
2911
|
+
`)}function Zm(e,t){let n=[e.title];return e.description&&n.push(e.description),Dr(t)?n.push(``,`Selected action: ${t.result.actionId}`):Er(t)?n.push(``,`Error: ${t.error.message}`):t.kind===`timeout`?n.push(``,`Timed out after ${t.waitedMs}ms.`):t.kind===`cancelled`&&n.push(``,`Cancelled: ${t.reason}.`),n.join(`
|
|
2912
|
+
`)}const Qm={id:`__dismiss`,type:`button`,label:`Done`,variant:`default`};function $m(e){if((e.actions?.length??0)>0||!e.template)return e;let t=sm(e);return t?.supportedTransports.includes(`browser`)===!0&&!t.supportedTransports.includes(`mcp-app`)?{...e,actions:[Qm]}:e}function eh(e){return e.replace(`</head>`,`<style>
|
|
2913
2913
|
.toolbar, .badge, body > header, body > footer { display: none !important; }
|
|
2914
2914
|
body { padding-top: 0 !important; margin-top: 0 !important; }
|
|
2915
2915
|
</style>
|
|
@@ -2931,7 +2931,7 @@ window.addEventListener('message', function(e) {
|
|
|
2931
2931
|
}
|
|
2932
2932
|
});
|
|
2933
2933
|
<\/script>
|
|
2934
|
-
</body>`)}function
|
|
2934
|
+
</body>`)}function th(e){let t=`<script>
|
|
2935
2935
|
(function(){
|
|
2936
2936
|
var last=0;
|
|
2937
2937
|
function notify(){
|
|
@@ -2942,9 +2942,9 @@ window.addEventListener('message', function(e) {
|
|
|
2942
2942
|
if(typeof ResizeObserver!=="undefined"){new ResizeObserver(notify).observe(document.documentElement)}
|
|
2943
2943
|
else{setInterval(notify,500)}
|
|
2944
2944
|
})();
|
|
2945
|
-
<\/script>`;return e.includes(`</body>`)?e.replace(`</body>`,`${t}</body>`):`${e}${t}`}function
|
|
2946
|
-
`)}function
|
|
2947
|
-
`);return
|
|
2945
|
+
<\/script>`;return e.includes(`</body>`)?e.replace(`</body>`,`${t}</body>`):`${e}${t}`}function nh(e,t){return[`<!DOCTYPE html>`,`<html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">`,`<title>Error — ${J(e)}</title>`,`<style>`,` * { box-sizing: border-box; margin: 0; padding: 0; }`,` body { font-family: system-ui, -apple-system, sans-serif; min-height: 100vh; display: flex; align-items: center; justify-content: center; padding: 2rem; background: #fafafa; color: #333; }`,` .error-card { max-width: 560px; width: 100%; padding: 2.5rem; border-radius: 1rem; background: #fff; border: 1px solid #e5e7eb; box-shadow: 0 1px 3px rgba(0,0,0,0.06); }`,` .error-badge { display: inline-block; font-size: 0.75rem; font-weight: 600; text-transform: uppercase; letter-spacing: 0.05em; color: #dc2626; background: #fef2f2; border: 1px solid #fecaca; border-radius: 0.375rem; padding: 0.25rem 0.625rem; margin-bottom: 1rem; }`,` .error-title { font-size: 1.25rem; font-weight: 600; margin-bottom: 0.75rem; color: #111; }`,` .error-message { font-size: 0.875rem; line-height: 1.6; color: #6b7280; white-space: pre-wrap; word-break: break-word; }`,`</style></head><body>`,`<div class="error-card">`,` <span class="error-badge">Render Error</span>`,` <h1 class="error-title">${J(e)}</h1>`,` <p class="error-message">${J(t)}</p>`,`</div>`,`</body></html>`].join(`
|
|
2946
|
+
`)}function rh(e,t,n,r){return Fm(nh(r??`Present`,t)),{content:[{type:`text`,text:`[ERROR:VALIDATION] ${t}`}],isError:!0}}function ih(e,t){if(!Im(e)||!(`schemaVersion`in e))return{ok:!1,response:rh(`INVALID_CHANNEL_SURFACE`,`present expects a ChannelSurface object with schemaVersion: 1`)};if(e.schemaVersion!==1)return{ok:!1,response:rh(`UNSUPPORTED_SCHEMA_VERSION`,`Unsupported ChannelSurface schemaVersion: ${String(e.schemaVersion)}`)};if(typeof e.title==`string`&&Lm.test(e.title))return{ok:!1,response:rh(`TITLE_UNICODE_ESCAPE_NOT_ALLOWED`,`Use actual Unicode characters in title, not escape sequences.`)};let n=Array.isArray(e.blocks)?{...e,blocks:e.blocks.flatMap(e=>{if(!Im(e)||e.type!==`markdown`)return[e];let t=Vm(e);return!t||!Hm(t)?[e]:Km(e)})}:e;return{ok:!0,surface:n,options:Jm(n,t)}}async function ah(e,t={}){let n=$m(e);if(e.template){let r=Pp(e.template);if(r)return await oh(n,r,t)}return cm(n)||t.preferBrowser&&Ym(n)?await Am(n):sh(n)}async function oh(e,t,n={}){if(e.data!=null&&t.inputSchema){let n=ln({data:e.data,schema:t.inputSchema});if(!n.valid){let r=n.errors.map(e=>` ${e.path}: ${e.message}${e.expected?` (expected: ${e.expected}, got: ${e.received})`:``}`).join(`
|
|
2947
|
+
`);return rh(`VIEWER_DATA_INVALID`,`Template "${t.id}" data validation failed:\n${r}\n\nExpected schema: ${JSON.stringify(t.inputSchema,null,2)}`,void 0,e.title)}}let r=t.supportedTransports.includes(`browser`),i=t.supportedTransports.includes(`mcp-app`);if(n.preferBrowser&&r||r&&!i)return await km(e,t);if(!i)return rh(`VIEWER_TRANSPORT_UNSUPPORTED`,`Viewer template "${t.id}" does not support an available transport`,void 0,e.title);try{let n=eh(Lp(t.resolveHtml(),e.data??null,t.injectId,t.transformData)).replace(/&/g,`&`).replace(/"/g,`"`);return Fm(th(Sr({title:e.title,html:[Xm(e),`<div class="present-viewer-container">`,` <iframe class="present-viewer-iframe" srcdoc="${n}" sandbox="allow-scripts allow-same-origin"></iframe>`,` <script>
|
|
2948
2948
|
(function() {
|
|
2949
2949
|
const iframe = document.querySelector('.present-viewer-iframe');
|
|
2950
2950
|
if (!iframe) return;
|
|
@@ -2967,12 +2967,12 @@ window.addEventListener('message', function(e) {
|
|
|
2967
2967
|
});
|
|
2968
2968
|
<\/script>`,`</div>`].join(`
|
|
2969
2969
|
`),css:[[`.present-viewer-container {`,` flex: 1;`,` min-height: 640px;`,` position: relative;`,` border-radius: 0.75rem;`,` overflow: hidden;`,` border: none;`,`}`,`.present-viewer-iframe {`,` border: none;`,` width: 100%;`,` height: 100%;`,` position: absolute;`,` inset: 0;`,` border-radius: inherit;`,`}`].join(`
|
|
2970
|
-
`)],islands:[],payload:void 0,nonce:``,generatedAt:new Date().toISOString(),footerContentHtml:
|
|
2971
|
-
`),css:t.css,islands:t.islands,payload:t.payload,nonce:t.nonce,colorScheme:e.colorScheme,lang:e.lang,dir:e.dir,transport:`mcp-app`,exportPolicy:t.exportPolicy,footerContentHtml:
|
|
2972
|
-
`);fr(e,`present`,{title:n.title,description:r,inputSchema:
|
|
2970
|
+
`)],islands:[],payload:void 0,nonce:``,generatedAt:new Date().toISOString(),footerContentHtml:Mm,colorScheme:e.colorScheme,lang:e.lang,dir:e.dir,transport:`mcp-app`,exportPolicy:`local-interactive`}))),{content:[{type:`text`,text:Zm(e,{kind:`rendered`,reason:`no-response-required`})}],ui:{type:`resource`,uri:jm}}}catch(t){return rh(`VIEWER_RENDER_FAILED`,t instanceof Error?t.message:`Failed to render viewer template`,void 0,e.title)}}function sh(e){try{let t=Ar(e,{transport:`mcp-app`,registry:om,blockVendorScripts:gp()}),n=pm(t.vendorScripts,`mcp-app`);return Nm=th(Sr({title:e.title,html:[Xm(e),t.html].filter(Boolean).join(`
|
|
2971
|
+
`),css:t.css,islands:t.islands,payload:t.payload,nonce:t.nonce,colorScheme:e.colorScheme,lang:e.lang,dir:e.dir,transport:`mcp-app`,exportPolicy:t.exportPolicy,footerContentHtml:Mm,headScripts:n})),{content:[{type:`text`,text:Zm(e,{kind:`rendered`,reason:`no-response-required`})}],ui:{type:`resource`,uri:jm}}}catch(t){return rh(`RENDER_FAILED`,t instanceof Error?t.message:`Failed to render ChannelSurface`,void 0,e.title)}}const ch=R.object({label:R.string(),value:R.string(),description:R.string().optional()}),lh=R.object({id:R.string().describe(`Unique action identifier`),type:R.enum([`button`,`select`,`multi-select`,`form-submit`,`text-submit`,`confirm`,`custom`]).describe(`Interactive action type`),label:R.string().describe(`Visible action label`),variant:R.enum([`primary`,`danger`,`default`]).optional(),options:R.array(ch).optional(),schema:R.record(R.string(),R.unknown()).optional()}),uh=R.object({type:R.string(),title:R.string().optional(),value:R.unknown().optional(),language:R.string().optional()}).catchall(R.unknown()),dh={schemaVersion:R.literal(1).describe(`ChannelSurface schema version. Must be 1.`),title:R.string().describe(`Surface title shown to the user.`),description:R.string().optional().describe(`Optional supporting copy for the surface.`),template:R.string().optional().describe(`Optional template id such as report@1.`),layout:R.object({maxWidth:R.string().optional(),padding:R.string().optional(),columns:R.number().optional()}).optional(),blocks:R.array(uh).optional().describe(`Typed block content for the surface.`),data:R.unknown().optional().describe(`Template data payload, if the template expands data.`),actions:R.array(lh).optional().describe(`Interactive actions. Presence triggers browser transport.`),response:R.object({timeout:R.number().optional(),required:R.boolean().optional()}).optional(),metadata:R.object({surfaceId:R.string().optional(),createdAt:R.string().optional(),source:R.string().optional()}).optional(),colorScheme:R.enum([`light`,`dark`,`auto`]).optional(),lang:R.string().optional(),dir:R.enum([`ltr`,`rtl`,`auto`]).optional()};R.object({surfaceId:R.string(),actionId:R.string(),actionType:R.enum([`button`,`select`,`multi-select`,`form-submit`,`text-submit`,`confirm`,`custom`]),value:R.unknown().optional(),formData:R.record(R.string(),R.unknown()).optional(),selection:R.union([R.string(),R.array(R.string())]).optional(),label:R.string().optional(),timestamp:R.string(),sourceTransport:R.enum([`mcp-app`,`browser`,`export`])});function fh(e,t){let n=U(`present`),r=[`Render a ChannelSurface for the user.`,`Quick ref:`,`- Full schema: aikit://schemas/channel-surface`,`- Required: schemaVersion: 1, title`,`- Content: blocks[] for direct rendering, or template + data for registry-backed rendering`,`- Actions: actions[] of SurfaceAction; interactive surfaces use browser transport and return ChannelOutcome`,`- Optional fields: description, layout, response, metadata, colorScheme, lang, dir`,`- Transports: mcp-app, browser, export`,`- Use schema resource for block enums and action details.`].join(`
|
|
2972
|
+
`);fr(e,`present`,{title:n.title,description:r,inputSchema:dh,annotations:n.annotations,_meta:{ui:{resourceUri:jm}}},q(`present`,async(e,t)=>{let n=ih(e,t);return n.ok?await ah(n.surface,n.options):n.response}));try{dr(e,`Present View`,jm,{description:`AI Kit present tool viewer`},async()=>({contents:[{uri:jm,mimeType:ur,text:Pm()||`<html><body><p>No content generated yet. Call the present tool first.</p></body></html>`}]}))}catch{}try{e.registerResource(`present-templates`,`aikit://present/templates`,{description:`List all registered present viewer templates with their input schemas`},async()=>{let e=Ip().map(e=>({id:e.id,label:e.label,description:e.description,transports:e.supportedTransports,inputSchema:e.inputSchema}));return{contents:[{uri:`aikit://present/templates`,mimeType:`application/json`,text:JSON.stringify(e,null,2)}]}})}catch{}}const ph=F(`tools`);function mh(e,t){let n=new Zn({structure:new $n,dependencies:new Jn,symbols:new er,patterns:new Qn,entryPoints:new Xn,diagrams:new Yn}),r=U(`produce_knowledge`);e.registerTool(`produce_knowledge`,{title:r.title,description:`Run automated codebase analysis and produce synthesis instructions. Executes Tier 1 deterministic analyzers, then returns structured baselines and instructions for you to synthesize knowledge using remember.`,inputSchema:{scope:R.string().optional().describe(`Root path to analyze (defaults to workspace root)`),aspects:R.array(R.enum([`all`,`structure`,`dependencies`,`symbols`,`patterns`,`entry-points`,`diagrams`])).default([`all`]).describe(`Which analysis aspects to run`)},annotations:r.annotations},q(`produce_knowledge`,async({scope:e,aspects:r},i)=>{let a;try{a=kc(i).createTask(`Produce Knowledge`,3),a.progress(0,`Running analyzers`);let o=e??`.`;ph.info(`Running knowledge production`,{rootPath:o,aspects:r});let s=await n.runExtraction(o,r);try{let e=t?.onboardDir??``;if(!e)throw ph.warn(`onboardDir not configured — skipping artifact persistence.`),Error(`skip`);j(e,{recursive:!0});let n=`<!-- Generated by produce_knowledge at ${new Date().toISOString()} -->\n\n`;for(let[t,r]of Object.entries(s))r&&typeof r==`string`&&he(N(e,`${t}.md`),n+r,`utf-8`);ph.info(`Knowledge persisted to .ai/context/`,{files:Object.keys(s).length})}catch(e){ph.warn(`Failed to persist knowledge to .ai/context/`,{error:I(e)})}a.progress(1,`Synthesizing results`);let c=n.buildSynthesisInstructions(s,r);return a.complete(`Knowledge production complete`),{content:[{type:`text`,text:c+`
|
|
2973
2973
|
|
|
2974
2974
|
---
|
|
2975
|
-
_Next: Review the baselines above and use \`remember\` to store synthesized knowledge entries._`}]}}catch(e){return a?.fail?.(`Production failed`),
|
|
2975
|
+
_Next: Review the baselines above and use \`remember\` to store synthesized knowledge entries._`}]}}catch(e){return a?.fail?.(`Production failed`),ph.error(`Knowledge production failed`,I(e)),K(`INTERNAL`,`Knowledge production failed: ${e instanceof Error?e.message:String(e)}`)}}))}const hh=F(`tools`);function gh(e,t,n,r,i,a,o){let s=U(`reindex`);e.registerTool(`reindex`,{title:s.title,description:`Trigger re-indexing of the AI Kit index. Can do incremental (only changed files) or full re-index. When smart indexing is active, use force: true to override the automatic trickle indexer.`,inputSchema:{full:R.boolean().default(!1).describe(`If true, force full re-index ignoring file hashes`),force:R.boolean().default(!1).describe(`If true, override smart indexing guard and run reindex anyway`)},annotations:s.annotations},q(`reindex`,async({full:e,force:s},c)=>{try{if(t.isIndexing)return{content:[{type:`text`,text:`## Reindex Already in Progress
|
|
2976
2976
|
|
|
2977
2977
|
A reindex operation is currently running. Search and other tools continue to work with existing data. Use \`status({})\` to check when it completes.`}]};if(o===`smart`&&!s)return{content:[{type:`text`,text:`## Smart Indexing Active
|
|
2978
2978
|
|
|
@@ -2980,45 +2980,45 @@ Smart indexing (trickle mode) is enabled — files are automatically indexed as
|
|
|
2980
2980
|
|
|
2981
2981
|
**If the index is severely outdated**, use \`reindex({ force: true })\` to override.
|
|
2982
2982
|
|
|
2983
|
-
Use \`status({})\` to check smart indexing queue status.`}]};let l=kc(c).createTask(`Reindex`,1);l.progress(0,`Starting ${e?`full`:`incremental`} reindex`),
|
|
2983
|
+
Use \`status({})\` to check smart indexing queue status.`}]};let l=kc(c).createTask(`Reindex`,1);l.progress(0,`Starting ${e?`full`:`incremental`} reindex`),hh.info(`Starting background re-index`,{mode:e?`full`:`incremental`});let u=e=>t=>{t.phase===`chunking`&&t.currentFile&&hh.debug(`Re-index progress`,{prefix:e,current:t.filesProcessed+1,total:t.filesTotal,file:t.currentFile})};return(e?t.reindexAll(n,u(`Reindex`)):t.index(n,u(`Index`))).then(async e=>{if(hh.info(`Background re-index complete`,{filesProcessed:e.filesProcessed,chunksCreated:e.chunksCreated,durationMs:e.durationMs}),l.complete(`Reindex complete: ${e.filesProcessed} files, ${e.chunksCreated} chunks in ${e.durationMs}ms`),i)try{await i.createFtsIndex(),hh.info(`FTS index rebuilt after reindex`)}catch(e){hh.warn(`FTS index rebuild failed`,I(e))}try{let e=await r.reindexAll();hh.info(`Curated re-index complete`,{indexed:e.indexed})}catch(e){hh.warn(`Curated re-index failed`,I(e))}if(a)try{await a.notifyAfterReindex()}catch(e){hh.warn(`Post-reindex resource notification failed`,I(e))}}).catch(e=>{l.fail(`Reindex failed: ${e instanceof Error?e.message:String(e)}`),hh.error(`Background reindex failed`,I(e))}),{content:[{type:`text`,text:`## Reindex Started (Background)\n\n- **Mode**: ${e?`Full`:`Incremental`}\n- Search and other tools continue to work with existing data during reindex.\n- Completion will be logged. Use \`status({})\` to check index stats afterward.\n\n---\n_Next: Continue working — the reindex runs in the background._`}]}}catch(e){return hh.error(`Reindex failed`,I(e)),K(`INTERNAL`,`Reindex failed: ${e instanceof Error?e.message:String(e)}`)}}))}const _h=F(`tools`);function vh(e){let t=U(`replay`);e.registerTool(`replay`,{title:t.title,description:`View or clear the audit trail of recent MCP tool and CLI invocations. Shows tool name, duration, status, and input/output summaries.`,inputSchema:{action:R.enum([`list`,`clear`]).default(`list`).describe(`Action: "list" (default) to view entries, "clear" to wipe the log`),last:R.number().optional().describe(`Number of entries to return (default: 20, list only)`),tool:R.string().optional().describe(`Filter by tool name (list only)`),source:R.enum([`mcp`,`cli`]).optional().describe(`Filter by source: "mcp" or "cli" (list only)`),since:R.string().optional().describe(`ISO timestamp — only show entries after this time (list only)`)},annotations:t.annotations},q(`replay`,async({action:e,last:t,tool:n,source:r,since:i})=>{try{if(e===`clear`)return rn(),{content:[{type:`text`,text:`Replay log cleared.`}]};let a=an({last:t,tool:n,source:r,since:i});if(a.length===0)return{content:[{type:`text`,text:`No replay entries found. Activity is logged when tools are invoked via MCP or CLI.`}]};let o=a.map(e=>`${e.ts.split(`T`)[1]?.split(`.`)[0]??e.ts} ${e.status===`ok`?`✓`:`✗`} ${e.tool} (${e.durationMs}ms) [${e.source}]\n in: ${e.input}\n out: ${e.output}`);return on().catch(()=>{}),{content:[{type:`text`,text:`**Replay Log** (${a.length} entries)\n\n${o.join(`
|
|
2984
2984
|
|
|
2985
|
-
`)}`}]}}catch(e){return
|
|
2985
|
+
`)}`}]}}catch(e){return _h.error(`Replay failed`,I(e)),K(`INTERNAL`,`Replay failed: ${e instanceof Error?e.message:String(e)}`)}}))}const yh=F(`tools`);function bh(e){let t=U(`restore`);e.registerTool(`restore`,{title:t.title,description:`List and restore file snapshots taken before destructive operations (codemod, rename, forget). Use action=list to see available restore points, action=restore with an id to undo.`,inputSchema:{action:R.enum([`list`,`restore`]).describe(`list: show restore points, restore: apply a restore point`),id:R.string().optional().describe(`Restore point ID (required for action=restore)`),limit:R.number().min(1).max(50).default(10).describe(`Max restore points to list`)},annotations:t.annotations},async({action:e,id:t,limit:n})=>{try{if(e===`list`){let e=Mt().slice(0,n);return e.length===0?{content:[{type:`text`,text:`No restore points found.`}]}:{content:[{type:`text`,text:`## Restore Points\n\n${e.map(e=>`- **${e.id}** (${e.timestamp}) — ${e.operation}: ${e.description} (${e.files.length} files)`).join(`
|
|
2986
2986
|
`)}`}]}}if(!t)throw Error(`id is required for restore action`);let r=await sn(t);return{content:[{type:`text`,text:`Restored ${r.length} files:\n${r.map(e=>`- \`${e}\``).join(`
|
|
2987
|
-
`)}`}]}}catch(e){return
|
|
2987
|
+
`)}`}]}}catch(e){return yh.error(`Restore failed`,I(e)),K(`INTERNAL`,`Restore failed: ${e instanceof Error?e.message:String(e)}`)}})}const xh=/<\/?curated-context>/gi;function Sh(e){return e.replace(xh,``)}function Ch(e){return`<curated-context>\n${Sh(e)}\n</curated-context>`}const wh=F(`tools`);function Th(e,t,i,c){r(e,t,i);let l=e.memoryMetaGet(t);if(!l)return;let u=a(l,{...n,...c});u&&(s(e,t,u),o(e,t,i))}function Eh(e,t){let n=[],r=ge(process.cwd());r&&n.push(`[project: ${r}]`);let i=t?gn(t,`__context_boost`):void 0;return i&&n.push(`[focus: ${i.value}]`),n.length===0?e:`${n.join(` `)} ${e}`}function Dh(e,t,n){return n?e:t===`curated`?e*1.2:e}function Oh(e,t){return t?e:e.map(e=>({record:e.record,score:Dh(e.score,e.record.origin,t)})).sort((e,t)=>t.score-e.score)}async function kh(e,t,n,r,i){if(!e||t>=e.config.fallbackThreshold&&n.length>0)return{results:n,triggered:!1,cacheHit:!1};let a=!1;try{let t=e.cache.get(r);return t?a=!0:(t=await e.client.search(r,i),t.length>0&&e.cache.set(r,t)),t.length>0?{results:lr(n,t,i).map(e=>({record:{id:`er:${e.sourcePath}`,content:e.content,sourcePath:e.source===`er`?`[ER] ${e.sourcePath}`:e.sourcePath,startLine:e.startLine??0,endLine:e.endLine??0,contentType:e.contentType??`documentation`,headingPath:e.headingPath,origin:e.source===`er`?`curated`:e.origin??`indexed`,category:e.category,tags:e.tags??[],chunkIndex:0,totalChunks:1,fileHash:``,indexedAt:new Date().toISOString(),version:1},score:e.score})),triggered:!0,cacheHit:a}:{results:n,triggered:!0,cacheHit:a}}catch(e){return wh.warn(`ER fallback failed`,I(e)),{results:n,triggered:!0,cacheHit:a}}}function Ah(e,t,n=60){let r=new Map,i=e[0]?.score||1,a=t[0]?.score||1;for(let t=0;t<e.length;t++){let a=e[t],o=a.score/i;r.set(a.record.id,{record:a.record,score:1/(n+t+1)*o})}for(let e=0;e<t.length;e++){let i=t[e],o=i.score/a,s=r.get(i.record.id);s?s.score+=1/(n+e+1)*o:r.set(i.record.id,{record:i.record,score:1/(n+e+1)*o})}return[...r.values()].sort((e,t)=>t.score-e.score).map(({record:e,score:t})=>({record:e,score:t}))}function jh(e,t){let n=t.toLowerCase().split(/\s+/).filter(e=>e.length>=2);return n.length<2?e:e.map(e=>{let t=e.record.content.toLowerCase();if(t.length>5e3)return e;let r=n.map(e=>{let n=[],r=t.indexOf(e);for(;r!==-1&&n.length<10;)n.push(r),r=t.indexOf(e,r+1);return n});if(r.some(e=>e.length===0))return e;let i=t.length;for(let e of r[0]){let t=e,a=e+n[0].length;for(let i=1;i<r.length;i++){let o=r[i][0],s=Math.abs(o-e);for(let t=1;t<r[i].length;t++){let n=Math.abs(r[i][t]-e);n<s&&(s=n,o=r[i][t])}t=Math.min(t,o),a=Math.max(a,o+n[i].length)}i=Math.min(i,a-t)}let a=1+.25/(1+i/200);return{record:e.record,score:e.score*a}}).sort((e,t)=>t.score-e.score)}function Mh(e){if(e.length<=1)return e;let t=new Set;return e.filter(e=>{let n=e.record.contentHash;return n?t.has(n)?!1:(t.add(n),!0):!0})}function Nh(e,t,n=8){let r=new Set(t.toLowerCase().split(/\s+/).filter(e=>e.length>=2)),i=new Map,a=e.length;for(let t of e){let e=t.record.content.split(/[^a-zA-Z0-9_]+/).filter(e=>e.length>=3&&!Ph.has(e.toLowerCase())),n=new Set;for(let t of e){let e=t.toLowerCase();/[_A-Z]/.test(t)&&i.set(`__id__${e}`,1),n.has(e)||(n.add(e),i.set(e,(i.get(e)??0)+1))}}let o=[];for(let[e,t]of i){if(e.startsWith(`__id__`)||r.has(e)||t>a*.8)continue;let n=Math.log(a/t),s=+!!i.has(`__id__${e}`),c=e.length>8?.5:0;o.push({term:e,score:n+s+c})}return o.sort((e,t)=>t.score-e.score).slice(0,n).map(e=>e.term)}const Ph=new Set(`the.and.for.are.but.not.you.all.can.had.her.was.one.our.out.has.have.from.this.that.with.they.been.said.each.which.their.will.other.about.many.then.them.these.some.would.make.like.into.could.time.very.when.come.just.know.take.people.also.back.after.only.more.than.over.such.import.export.const.function.return.true.false.null.undefined.string.number.boolean.void.type.interface`.split(`.`));async function Fh(e,t){try{let n=await e.getStats();if(!n.lastIndexedAt)return;let r=new Date(n.lastIndexedAt).getTime(),i=Date.now(),a=[...new Set(t.map(e=>e.record.sourcePath))].filter(e=>!e.startsWith(`[ER]`)).slice(0,5);if(a.length===0)return;let o=0;for(let e of a)try{(await Pn(e)).mtimeMs>r&&o++}catch{o++}if(o>0){let e=i-r,t=Math.floor(e/6e4),n=t<1?`<1 min`:`${t} min`;return`> ⚠️ **Index may be stale** — ${o} file(s) modified since last index (${n} ago). Use \`reindex\` to refresh.`}}catch{}}function Ih(e,t,n,r,i,a,o,s,c,l){let u=U(`search`);e.registerTool(`search`,{title:u.title,description:`Search AI Kit for code, docs, and prior decisions. Default choice for discovery. Modes: hybrid (default), semantic, keyword. For multi-strategy precision queries use find; for a known file path use lookup.`,outputSchema:ks,inputSchema:{query:R.string().max(5e3).describe(`Natural language search query`),limit:R.number().min(1).max(20).default(5).describe(`Maximum results to return`),search_mode:R.enum([`hybrid`,`semantic`,`keyword`]).default(`hybrid`).describe(`Search strategy: hybrid (vector + FTS + RRF fusion, default), semantic (vector only), keyword (FTS only)`),content_type:R.enum(Ce).optional().describe(`Filter by content type`),source_type:R.enum(Oe).optional().describe(`Coarse filter: "source" (code only), "documentation" (md, curated), "test", "config". Overrides content_type if both set.`),origin:R.enum(De).optional().describe(`Filter by knowledge origin`),category:R.string().optional().describe(`Filter by category (e.g., decisions, patterns, conventions)`),tags:R.array(R.string()).optional().describe(`Filter by tags (returns results matching ANY of the specified tags)`),min_score:R.number().min(0).max(1).default(.25).describe(`Minimum similarity score`),graph_hops:R.number().min(0).max(3).default(1).describe(`Number of graph hops to augment results with connected entities (0 = disabled, 1 = direct connections, 2-3 = deeper traversal). Default 1 provides module/symbol context automatically.`),max_tokens:R.number().min(100).max(5e4).optional().describe(`Maximum token budget for the response. When set, output is truncated to fit.`),dedup:R.enum([`file`,`chunk`]).default(`chunk`).describe(`Deduplication mode: "chunk" (default, show all matching chunks) or "file" (collapse chunks from same file into single result with merged line ranges)`),workspaces:R.array(R.string()).optional().describe(`Cross-workspace search: partition names or folder basenames to include. Use ["*"] for all registered workspaces. Only works in user-level install mode.`)},annotations:u.annotations},async({query:e,limit:u,search_mode:d,content_type:f,source_type:p,origin:m,category:h,tags:g,min_score:_,graph_hops:v,max_tokens:y,dedup:b,workspaces:x})=>{let S=Date.now();try{let C={limit:u,minScore:_,contentType:f,sourceType:p,origin:m,category:h,tags:g},w,T=!1,E=!1,D=``,O=d!==`keyword`,ee=Eh(e,s);if(d===`keyword`)w=await n.ftsSearch(e,C),w=w.slice(0,u);else if(d===`semantic`)try{let r=await t.embedQuery(ee);w=await n.search(r,C);let a=await kh(i,w[0]?.score??0,w,e,u);w=a.results,T=a.triggered,E=a.cacheHit}catch(t){O=!1,wh.warn(`Embedder unavailable in semantic mode, falling back to FTS`,I(t)),w=await n.ftsSearch(e,{...C,limit:u}),D=`> _⚠️ Semantic search unavailable (embedder recovering). Showing keyword results instead._
|
|
2988
2988
|
|
|
2989
|
-
`}else{let r=[],a=[];try{let i=await t.embedQuery(ee),o=n.coarseSearch,s=o?o.bind(n):n.search.bind(n);[r,a]=await Promise.all([s(i,{...C,limit:u*2}),n.ftsSearch(e,{...C,limit:u*2}).catch(()=>[])])}catch(t){O=!1,
|
|
2989
|
+
`}else{let r=[],a=[];try{let i=await t.embedQuery(ee),o=n.coarseSearch,s=o?o.bind(n):n.search.bind(n);[r,a]=await Promise.all([s(i,{...C,limit:u*2}),n.ftsSearch(e,{...C,limit:u*2}).catch(()=>[])])}catch(t){O=!1,wh.warn(`Embedder unavailable, falling back to FTS-only`,I(t)),a=await n.ftsSearch(e,{...C,limit:u*2}),D=`> _⚠️ Vector search unavailable (embedder recovering). Results from keyword search only._
|
|
2990
2990
|
|
|
2991
|
-
`}if(O?r.length===0&&a.length>0?(w=a.slice(0,u),D=` (FTS-only: vector index rebuilding)`):w=a.length===0&&r.length>0?r.slice(0,u):
|
|
2992
|
-
`)[0].slice(0,500);if(r&&r!==e){let i=d===`keyword`||!O?await n.ftsSearch(r,C):await n.search(await t.embedQuery(r),C);i.length>0&&(w=i,D=`> _Original query "${e}" returned 0 results. Auto-reformulated to "${r}"._\n\n`,
|
|
2991
|
+
`}if(O?r.length===0&&a.length>0?(w=a.slice(0,u),D=` (FTS-only: vector index rebuilding)`):w=a.length===0&&r.length>0?r.slice(0,u):Ah(r,a).slice(0,u):w=a.slice(0,u),O){let t=await kh(i,r[0]?.score??0,w,e,u);w=t.results,T=t.triggered,E=t.cacheHit}}w=Oh(w,m).slice(0,u),a&&a.recordSearch(e,T,E),w.length>1&&(w=jh(w,e)),w=Mh(w);let te=``;if(x&&x.length>0){let n=cl(x,je(process.cwd()));if(n.length>0){let{stores:r,closeAll:i}=await ll(n);try{let i;i=d===`keyword`||!O?await dl(r,e,{...C,limit:u}):await ul(r,await t.embedQuery(e),{...C,limit:u});for(let e of i)w.push({record:{...e.record,sourcePath:`[${e.workspace}] ${e.record.sourcePath}`},score:e.score});w=w.sort((e,t)=>t.score-e.score).slice(0,u),te=` + ${n.length} workspace(s)`}finally{await i()}}}if(b===`file`&&w.length>1){let e=new Map;for(let t of w){let n=t.record.sourcePath,r=e.get(n);r?(t.score>r.best.score&&(r.best=t),r.ranges.push({start:t.record.startLine,end:t.record.endLine})):e.set(n,{best:t,ranges:[{start:t.record.startLine,end:t.record.endLine}]})}w=[...e.values()].sort((e,t)=>t.best.score-e.best.score).map(({best:e,ranges:t})=>({record:{...e.record,content:t.length>1?`${e.record.content}\n\n_Matched ${t.length} sections: ${t.sort((e,t)=>e.start-t.start).map(e=>`L${e.start}-${e.end}`).join(`, `)}_`:e.record.content},score:e.score}))}if(w.length>1){let e=w[0].score,t=Math.max(e*.4,.1);w=w.filter(e=>e.score>=t)}if(w.length===0){if(o?.available)try{let r=(await o.createMessage({prompt:`The search query "${e}" returned 0 results in AI Kit code search. Suggest ONE alternative search query that might find relevant results. Reply with ONLY the alternative query, nothing else.`,systemPrompt:`You are a search query optimizer for AI Kit code search. Generate a single alternative query.`,maxTokens:100})).text.trim().split(`
|
|
2992
|
+
`)[0].slice(0,500);if(r&&r!==e){let i=d===`keyword`||!O?await n.ftsSearch(r,C):await n.search(await t.embedQuery(r),C);i.length>0&&(w=i,D=`> _Original query "${e}" returned 0 results. Auto-reformulated to "${r}"._\n\n`,wh.info(`Smart search fallback succeeded`,{originalQuery:e,altQuery:r,resultCount:i.length}))}}catch(e){wh.debug(`Smart search fallback failed`,{error:String(e)})}if(w.length===0){let t=et({text:`No results found for the given query.`,query:e,searchMode:d,limit:u,results:[],durationMs:Date.now()-S});return{content:[{type:`text`,text:t.summary}],isError:!t.ok,structuredContent:t.data??{results:[],totalResults:0,searchMode:d,query:e}}}}let ne,re;if(v>0&&!r&&(re="> **Note:** `graph_hops` was set but no graph store is available. Graph augmentation skipped."),v>0&&r)try{let e=await bt(r,w.map(e=>({recordId:e.record.id,score:e.score,sourcePath:e.record.sourcePath})),{hops:v,maxPerHit:5});ne=new Map;for(let t of e)if(t.graphContext.nodes.length>0){let e=t.graphContext.nodes.slice(0,5).map(e=>` - **${e.name}** (${e.type})`).join(`
|
|
2993
2993
|
`),n=new Map;for(let e of t.graphContext.nodes)n.set(e.id,e.name);let r=t.graphContext.edges.slice(0,5).map(e=>` - ${n.get(e.fromId)??e.fromId} —[${e.type}]→ ${n.get(e.toId)??e.toId}`).join(`
|
|
2994
2994
|
`),i=[`- **Graph Context** (${v} hop${v>1?`s`:``}):`];e&&i.push(` Entities:\n${e}`),r&&i.push(` Relationships:\n${r}`),ne.set(t.recordId,i.join(`
|
|
2995
|
-
`))}}catch(e){
|
|
2996
|
-
`)}\n\n${n.origin===`curated`?
|
|
2995
|
+
`))}}catch(e){wh.warn(`Graph augmentation failed`,I(e)),re=`> **Note:** Graph augmentation failed. Results shown without graph context.`}let ie=Date.now();for(let e of w)if(e.record.origin===`curated`&&e.record.indexedAt){let t=ie-new Date(e.record.indexedAt).getTime(),n=Math.max(0,t/864e5);e.score*=.95**n}if(w.sort((e,t)=>t.score-e.score),w=Be(w),s)for(let e of w){if(e.record.origin!==`curated`)continue;let t=wd(e.record.sourcePath);t&&Th(s,t,c,l)}let ae=w.map((e,t)=>{let n=e.record;return`${`### Result ${t+1} (score: ${e.score.toFixed(3)})`}\n${[`- **Source**: ${n.sourcePath}`,n.headingPath?`- **Section**: ${n.headingPath}`:null,`- **Type**: ${n.contentType}`,n.startLine?`- **Lines**: ${n.startLine}-${n.endLine}`:null,n.origin===`indexed`?null:`- **Origin**: ${n.origin}`,n.category?`- **Category**: ${n.category}`:null,n.tags?.length?`- **Tags**: ${n.tags.join(`, `)}`:null,ne?.get(n.id)??null].filter(Boolean).join(`
|
|
2996
|
+
`)}\n\n${n.origin===`curated`?Ch(n.content):n.content}`}).join(`
|
|
2997
2997
|
|
|
2998
2998
|
---
|
|
2999
2999
|
|
|
3000
|
-
`),oe=(d===`hybrid`?`hybrid (vector + keyword RRF)`:d===`keyword`?`keyword (FTS)`:`semantic (vector)`)+te,k=jh(w,e),se=k.length>0?`\n_Distinctive terms: ${k.map(e=>`\`${e}\``).join(`, `)}_`:``,ce=await Nh(n,w),le=[];if(w.length===0)le.push("`reindex` — no results found, index may be stale"),le.push("`find` — try federated search with glob/regex");else{let e=w[0]?.record.sourcePath;e&&le.push(`\`lookup\` — see all chunks from \`${e}\``),le.push("`symbol` — resolve a specific symbol from the results"),le.push("`compact` — compress a result file for focused reading")}let A=[re?`${re}\n\n`:``,ce?`${ce}\n\n`:``,ae,`\n\n---\n_Search mode: ${oe} | ${w.length} results_${se}`,`\n_Next: ${le.join(` | `)}_`],j=D+A.join(``),M=!1;if(y){let e=L(j,y);M=e!==j,j=e}let ue=w.map(e=>({sourcePath:e.record.sourcePath,contentType:e.record.contentType,score:e.score,...e.record.headingPath?{headingPath:e.record.headingPath}:{},...e.record.startLine?{startLine:e.record.startLine}:{},...e.record.endLine?{endLine:e.record.endLine}:{},...e.record.origin===`indexed`?{}:{origin:e.record.origin},...e.record.category?{category:e.record.category}:{},...e.record.tags?.length?{tags:e.record.tags}:{}})),de=[re,ce].filter(e=>!!e),fe=et({text:j,query:e,searchMode:d,limit:u,results:ue,durationMs:Date.now()-S,truncated:M,caveats:de}),pe=new Set,me=[];for(let e of w){if(e.record.origin!==`curated`||e.record.sourcePath.startsWith(`[`))continue;let t=Sd(e.record.sourcePath);if(!t)continue;let n=bd(t,e.record.headingPath??t);n&&!pe.has(n.uri)&&(pe.add(n.uri),me.push(n))}return{content:[{type:`text`,text:fe.summary},...me],isError:!fe.ok,structuredContent:fe.data??{results:[],totalResults:0,searchMode:d,query:e}}}catch(t){Sh.error(`Search failed`,I(t));let n=et({text:`Search failed: ${t instanceof Error?t.message:String(t)}`,query:e??``,searchMode:d??`hybrid`,limit:u,results:[],durationMs:Date.now()-S});return{content:[{type:`text`,text:n.summary}],structuredContent:n.data??{results:[],totalResults:0,searchMode:d??`hybrid`,query:e??``}}}})}const Fh=F(`tools`);function Ih(e,t,n){let r=U(`session_digest`);e.registerTool(`session_digest`,{title:r.title,description:`Compress the current session's tool trajectory into a focused digest. Aggregates replay log, stash state, and checkpoints. Supports deterministic and LLM-assisted (sampling) modes with configurable token budget.`,inputSchema:{scope:R.enum([`tools`,`stash`,`all`]).default(`all`).describe(`What to include: tools (replay only), stash (stash + checkpoints only), or all`),since:R.string().optional().describe(`ISO timestamp — only include activity after this time`),last:R.number().min(1).max(500).optional().describe(`Max replay entries to consider (default: 50)`),focus:R.string().optional().describe(`Focus query — prioritize entries matching this topic`),mode:R.enum([`deterministic`,`sampling`]).default(`deterministic`).describe(`Summary mode: deterministic (fast, template-based) or sampling (LLM-assisted, richer)`),token_budget:R.number().min(100).max(8e3).default(2e3).describe(`Target token budget for the digest output`),persist:R.boolean().default(!0).describe(`Auto-save digest to stash for crash recovery`)},annotations:r.annotations},q(`session_digest`,async({scope:e,since:r,last:i,focus:a,mode:o,token_budget:s,persist:c})=>{try{let l={scope:e,since:r,last:i,focus:a,mode:o,tokenBudget:s,persist:c},u=t?{stateStore:t}:void 0;return{content:[{type:`text`,text:(o===`sampling`&&n?.available?await pn(l,async(e,t,r)=>(await n.createMessage({prompt:e,systemPrompt:t,maxTokens:r})).text,u):fn(l,u)).digest}]}}catch(e){return Fh.error(`Session digest failed`,I(e)),K(`INTERNAL`,`Session digest failed: ${e instanceof Error?e.message:String(e)}`)}}))}const Lh=1e4,Rh={defaultTtlSeconds:300,defaultLeaseTtlMinutes:10,globalEnabled:!1};function zh(e){return e??Rh}function Bh(e,t){let n=e.trim();if(!n)throw Error(`${t} is required`);return n}function Vh(e,t,n){let r=Bh(e,t);if(r.length>n)throw Error(`${t} exceeds max length of ${n}`);return r}function Hh(e,t){if(!Number.isFinite(e)||e<=0)throw Error(`${t} must be greater than 0`);return Math.trunc(e)}function Uh(e,t=!1,n){Bh(e,`workspace`);let r=zh(n);if(!t)return e;if(!r.globalEnabled)throw Error(`Global signal scope is disabled`);return`__global__`}function Wh(e,t,n){let r=zh(n),i=Uh(t.workspace,t.global??!1,r),a=Vh(t.key,`key`,500),o=Vh(t.value,`value`,Lh),s=t.agent?Vh(t.agent,`agent`,500):void 0,c=Hh(t.ttlSeconds??r.defaultTtlSeconds,`ttlSeconds`);return e.signalPost(i,a,o,s,c)}function Gh(e,t,n){let r=Bh(t,`workspace`),i=Vh(n,`key`,500);return e.signalGet(r,i)}function Kh(e,t){let n=Bh(t,`workspace`);return e.signalList(n)}function qh(e,t,n){let r=Bh(t,`workspace`),i=n===void 0?void 0:Vh(n,`key`,500);return e.signalClear(r,i)}function Jh(e,t,n){let r=zh(n),i=Vh(t.resource,`resource`,500),a=Vh(t.holder,`holder`,500),o=Bh(t.workspace,`workspace`),s=t.intent?Vh(t.intent,`intent`,Lh):void 0,c=Hh(t.ttlMinutes??r.defaultLeaseTtlMinutes,`ttlMinutes`);if(c>60)throw Error(`ttlMinutes exceeds max of 60`);let l=e.leaseAcquire(i,a,o,s,c),u=e.leaseGet(i,o);return u?{acquired:l,holder:u.holder,expiresAt:u.expiresAt}:{acquired:l}}function Yh(e,t,n,r){let i=Bh(t,`workspace`),a=Vh(n,`resource`,500),o=Vh(r,`holder`,500);return e.leaseRelease(a,o,i)}function Xh(e,t){let n=Bh(t,`workspace`);return e.leaseList(n)}const Zh=F(`tools:signal`);function Qh(e){return JSON.stringify(e,null,2)}function $h(e,t,n){let r=U(`signal`),i={...Rh,...n};e.registerTool(`signal`,{title:r.title,description:`Inter-agent signaling and lease coordination`,inputSchema:{action:R.enum([`post`,`get`,`list`,`clear`,`lease`,`unlease`,`leases`]).describe(`Signal action to perform`),workspace:R.string().describe(`Workspace identifier (required)`),key:R.string().optional().describe(`Signal key (for post/get/clear)`),value:R.string().optional().describe(`Signal value (for post)`),agent:R.string().optional().describe(`Agent identifier`),resource:R.string().optional().describe(`Resource path (for lease/unlease)`),holder:R.string().optional().describe(`Lease holder ID (for lease/unlease)`),intent:R.string().optional().describe(`What the holder plans to do`),ttl:R.number().optional().describe(`TTL (seconds for signals, minutes for leases)`),global:R.boolean().optional().describe(`Use global scope (default: false)`)},annotations:r.annotations},q(`signal`,async({action:e,workspace:n,key:r,value:a,agent:o,resource:s,holder:c,intent:l,ttl:u,global:d})=>{try{switch(e){case`post`:{if(!r||a===void 0)throw Error(`key and value are required for post`);let e=Wh(t,{workspace:n,key:r,value:a,agent:o,ttlSeconds:u,global:d},i);return{content:[{type:`text`,text:Qh({id:e})}],structuredContent:{id:e}}}case`get`:{if(!r)throw Error(`key is required for get`);let e=Gh(t,Uh(n,d??!1,i),r);return{content:[{type:`text`,text:e.length===0?`[]`:Qh(e)}],structuredContent:{signals:e}}}case`list`:{let e=Kh(t,Uh(n,d??!1,i));return{content:[{type:`text`,text:e.length===0?`[]`:Qh(e)}],structuredContent:{signals:e}}}case`clear`:{let e=qh(t,Uh(n,d??!1,i),r);return{content:[{type:`text`,text:Qh({cleared:e})}],structuredContent:{cleared:e}}}case`lease`:{if(!s||!c)throw Error(`resource and holder are required for lease`);let e=Jh(t,{resource:s,holder:c,workspace:n,intent:l,ttlMinutes:u},i);return{content:[{type:`text`,text:Qh(e)}],structuredContent:e}}case`unlease`:{if(!s||!c)throw Error(`resource and holder are required for unlease`);let e=Yh(t,n,s,c);return{content:[{type:`text`,text:Qh({released:e})}],structuredContent:{released:e}}}case`leases`:{let e=Xh(t,n);return{content:[{type:`text`,text:e.length===0?`[]`:Qh(e)}],structuredContent:{leases:e}}}}}catch(e){return Zh.error(`Signal operation failed`,I(e)),K(`INTERNAL`,`Signal operation failed: ${e instanceof Error?e.message:String(e)}`)}}))}function eg(e,t){return e.length<=t?e:e.slice(0,t)}function tg(e){if(!e)return 0;let t=Date.parse(e);return Number.isNaN(t)?0:t}async function ng(e,t,n=_){if(!e||!t)return null;try{let[r,i,a]=await Promise.all([e.list({category:`lessons`}),e.list({category:`conventions`}),e.list({category:`session`})]),o=r.filter(e=>e.tags.includes(`lesson`)).map(e=>{let r=t.memoryMetaGet(e.path);return!r||r.supersededBy!=null?null:{entry:e,confidence:m(r.confidence,r.lastAccessedAt,r.createdAt,n)}}).filter(e=>e!==null).sort((e,t)=>t.confidence-e.confidence).slice(0,3);return{lessons:await Promise.all(o.map(async({entry:t,confidence:n})=>{let r=d((await e.read(t.path)).content);return{title:t.title,insight:eg(r.insight??``,150),confidence:n}})),conventions:i.map(e=>({entry:e,lastAccessedAt:t.memoryMetaGet(e.path)?.lastAccessedAt??null})).sort((e,t)=>tg(t.lastAccessedAt)-tg(e.lastAccessedAt)).slice(0,2).map(({entry:e})=>({title:e.title,preview:e.contentPreview})),checkpoint:a.map(e=>({entry:e,lastAccessedAt:t.memoryMetaGet(e.path)?.lastAccessedAt??null})).sort((e,t)=>tg(t.lastAccessedAt)-tg(e.lastAccessedAt)).map(({entry:e})=>eg(e.contentPreview,200))[0]??null}}catch{return null}}const rg=F(`tools`),ig=14400*1e3,ag={includePrelude:R.boolean().default(!1).describe(`Include session prelude with top lessons, conventions, and last checkpoint`)};function og(e,t,n,r=15e3){let i,a=new Promise(e=>{i=setTimeout(()=>{rg.warn(`Status sub-operation "${n}" timed out after ${r}ms`),e({value:t,timedOut:!0})},r)});return Promise.race([e.then(e=>(clearTimeout(i),{value:e,timedOut:!1}),e=>(clearTimeout(i),rg.warn(`Status sub-operation "${n}" failed: ${e instanceof Error?e.message:String(e)}`),{value:t,timedOut:!1})),a])}function sg(e){return e.onboarded?e.indexStale?{kind:`reindex`,reason:`Index stale. Run reindex() to update.`}:e.contextPressure>70?{kind:`handoff`,reason:`Context pressure high. Consider session handoff.`}:{kind:`proceed`,reason:`Ready to work.`}:{kind:`onboard`,reason:`Index not initialized. Run onboard({ path: "." }) first.`}}function cg(){let e=nr.get(),t=tr.get();if(e)return`- **Tree-sitter (WASM)**: ✅ Available (${t.grammarCount} grammars, dir: ${t.wasmDir})`;let n=t.pathsChecked.length?t.pathsChecked.map(e=>` ${e.exists?`✓`:`✗`} ${e.path}`).join(`
|
|
3000
|
+
`),oe=(d===`hybrid`?`hybrid (vector + keyword RRF)`:d===`keyword`?`keyword (FTS)`:`semantic (vector)`)+te,k=Nh(w,e),se=k.length>0?`\n_Distinctive terms: ${k.map(e=>`\`${e}\``).join(`, `)}_`:``,ce=await Fh(n,w),le=[];if(w.length===0)le.push("`reindex` — no results found, index may be stale"),le.push("`find` — try federated search with glob/regex");else{let e=w[0]?.record.sourcePath;e&&le.push(`\`lookup\` — see all chunks from \`${e}\``),le.push("`symbol` — resolve a specific symbol from the results"),le.push("`compact` — compress a result file for focused reading")}let A=[re?`${re}\n\n`:``,ce?`${ce}\n\n`:``,ae,`\n\n---\n_Search mode: ${oe} | ${w.length} results_${se}`,`\n_Next: ${le.join(` | `)}_`],j=D+A.join(``),M=!1;if(y){let e=L(j,y);M=e!==j,j=e}let ue=w.map(e=>({sourcePath:e.record.sourcePath,contentType:e.record.contentType,score:e.score,...e.record.headingPath?{headingPath:e.record.headingPath}:{},...e.record.startLine?{startLine:e.record.startLine}:{},...e.record.endLine?{endLine:e.record.endLine}:{},...e.record.origin===`indexed`?{}:{origin:e.record.origin},...e.record.category?{category:e.record.category}:{},...e.record.tags?.length?{tags:e.record.tags}:{}})),de=[re,ce].filter(e=>!!e),fe=et({text:j,query:e,searchMode:d,limit:u,results:ue,durationMs:Date.now()-S,truncated:M,caveats:de}),pe=new Set,me=[];for(let e of w){if(e.record.origin!==`curated`||e.record.sourcePath.startsWith(`[`))continue;let t=wd(e.record.sourcePath);if(!t)continue;let n=Sd(t,e.record.headingPath??t);n&&!pe.has(n.uri)&&(pe.add(n.uri),me.push(n))}return{content:[{type:`text`,text:fe.summary},...me],isError:!fe.ok,structuredContent:fe.data??{results:[],totalResults:0,searchMode:d,query:e}}}catch(t){wh.error(`Search failed`,I(t));let n=et({text:`Search failed: ${t instanceof Error?t.message:String(t)}`,query:e??``,searchMode:d??`hybrid`,limit:u,results:[],durationMs:Date.now()-S});return{content:[{type:`text`,text:n.summary}],structuredContent:n.data??{results:[],totalResults:0,searchMode:d??`hybrid`,query:e??``}}}})}const Lh=F(`tools`);function Rh(e,t,n){let r=U(`session_digest`);e.registerTool(`session_digest`,{title:r.title,description:`Compress the current session's tool trajectory into a focused digest. Aggregates replay log, stash state, and checkpoints. Supports deterministic and LLM-assisted (sampling) modes with configurable token budget.`,inputSchema:{scope:R.enum([`tools`,`stash`,`all`]).default(`all`).describe(`What to include: tools (replay only), stash (stash + checkpoints only), or all`),since:R.string().optional().describe(`ISO timestamp — only include activity after this time`),last:R.number().min(1).max(500).optional().describe(`Max replay entries to consider (default: 50)`),focus:R.string().optional().describe(`Focus query — prioritize entries matching this topic`),mode:R.enum([`deterministic`,`sampling`]).default(`deterministic`).describe(`Summary mode: deterministic (fast, template-based) or sampling (LLM-assisted, richer)`),token_budget:R.number().min(100).max(8e3).default(2e3).describe(`Target token budget for the digest output`),persist:R.boolean().default(!0).describe(`Auto-save digest to stash for crash recovery`)},annotations:r.annotations},q(`session_digest`,async({scope:e,since:r,last:i,focus:a,mode:o,token_budget:s,persist:c})=>{try{let l={scope:e,since:r,last:i,focus:a,mode:o,tokenBudget:s,persist:c},u=t?{stateStore:t}:void 0;return{content:[{type:`text`,text:(o===`sampling`&&n?.available?await pn(l,async(e,t,r)=>(await n.createMessage({prompt:e,systemPrompt:t,maxTokens:r})).text,u):fn(l,u)).digest}]}}catch(e){return Lh.error(`Session digest failed`,I(e)),K(`INTERNAL`,`Session digest failed: ${e instanceof Error?e.message:String(e)}`)}}))}const zh=1e4,Bh={defaultTtlSeconds:300,defaultLeaseTtlMinutes:10,globalEnabled:!1};function Vh(e){return e??Bh}function Hh(e,t){let n=e.trim();if(!n)throw Error(`${t} is required`);return n}function Uh(e,t,n){let r=Hh(e,t);if(r.length>n)throw Error(`${t} exceeds max length of ${n}`);return r}function Wh(e,t){if(!Number.isFinite(e)||e<=0)throw Error(`${t} must be greater than 0`);return Math.trunc(e)}function Gh(e,t=!1,n){Hh(e,`workspace`);let r=Vh(n);if(!t)return e;if(!r.globalEnabled)throw Error(`Global signal scope is disabled`);return`__global__`}function Kh(e,t,n){let r=Vh(n),i=Gh(t.workspace,t.global??!1,r),a=Uh(t.key,`key`,500),o=Uh(t.value,`value`,zh),s=t.agent?Uh(t.agent,`agent`,500):void 0,c=Wh(t.ttlSeconds??r.defaultTtlSeconds,`ttlSeconds`);return e.signalPost(i,a,o,s,c)}function qh(e,t,n){let r=Hh(t,`workspace`),i=Uh(n,`key`,500);return e.signalGet(r,i)}function Jh(e,t){let n=Hh(t,`workspace`);return e.signalList(n)}function Yh(e,t,n){let r=Hh(t,`workspace`),i=n===void 0?void 0:Uh(n,`key`,500);return e.signalClear(r,i)}function Xh(e,t,n){let r=Vh(n),i=Uh(t.resource,`resource`,500),a=Uh(t.holder,`holder`,500),o=Hh(t.workspace,`workspace`),s=t.intent?Uh(t.intent,`intent`,zh):void 0,c=Wh(t.ttlMinutes??r.defaultLeaseTtlMinutes,`ttlMinutes`);if(c>60)throw Error(`ttlMinutes exceeds max of 60`);let l=e.leaseAcquire(i,a,o,s,c),u=e.leaseGet(i,o);return u?{acquired:l,holder:u.holder,expiresAt:u.expiresAt}:{acquired:l}}function Zh(e,t,n,r){let i=Hh(t,`workspace`),a=Uh(n,`resource`,500),o=Uh(r,`holder`,500);return e.leaseRelease(a,o,i)}function Qh(e,t){let n=Hh(t,`workspace`);return e.leaseList(n)}const $h=F(`tools:signal`);function eg(e){return JSON.stringify(e,null,2)}function tg(e,t,n){let r=U(`signal`),i={...Bh,...n};e.registerTool(`signal`,{title:r.title,description:`Inter-agent signaling and lease coordination`,inputSchema:{action:R.enum([`post`,`get`,`list`,`clear`,`lease`,`unlease`,`leases`]).describe(`Signal action to perform`),workspace:R.string().describe(`Workspace identifier (required)`),key:R.string().optional().describe(`Signal key (for post/get/clear)`),value:R.string().optional().describe(`Signal value (for post)`),agent:R.string().optional().describe(`Agent identifier`),resource:R.string().optional().describe(`Resource path (for lease/unlease)`),holder:R.string().optional().describe(`Lease holder ID (for lease/unlease)`),intent:R.string().optional().describe(`What the holder plans to do`),ttl:R.number().optional().describe(`TTL (seconds for signals, minutes for leases)`),global:R.boolean().optional().describe(`Use global scope (default: false)`)},annotations:r.annotations},q(`signal`,async({action:e,workspace:n,key:r,value:a,agent:o,resource:s,holder:c,intent:l,ttl:u,global:d})=>{try{switch(e){case`post`:{if(!r||a===void 0)throw Error(`key and value are required for post`);let e=Kh(t,{workspace:n,key:r,value:a,agent:o,ttlSeconds:u,global:d},i);return{content:[{type:`text`,text:eg({id:e})}],structuredContent:{id:e}}}case`get`:{if(!r)throw Error(`key is required for get`);let e=qh(t,Gh(n,d??!1,i),r);return{content:[{type:`text`,text:e.length===0?`[]`:eg(e)}],structuredContent:{signals:e}}}case`list`:{let e=Jh(t,Gh(n,d??!1,i));return{content:[{type:`text`,text:e.length===0?`[]`:eg(e)}],structuredContent:{signals:e}}}case`clear`:{let e=Yh(t,Gh(n,d??!1,i),r);return{content:[{type:`text`,text:eg({cleared:e})}],structuredContent:{cleared:e}}}case`lease`:{if(!s||!c)throw Error(`resource and holder are required for lease`);let e=Xh(t,{resource:s,holder:c,workspace:n,intent:l,ttlMinutes:u},i);return{content:[{type:`text`,text:eg(e)}],structuredContent:e}}case`unlease`:{if(!s||!c)throw Error(`resource and holder are required for unlease`);let e=Zh(t,n,s,c);return{content:[{type:`text`,text:eg({released:e})}],structuredContent:{released:e}}}case`leases`:{let e=Qh(t,n);return{content:[{type:`text`,text:e.length===0?`[]`:eg(e)}],structuredContent:{leases:e}}}}}catch(e){return $h.error(`Signal operation failed`,I(e)),K(`INTERNAL`,`Signal operation failed: ${e instanceof Error?e.message:String(e)}`)}}))}function ng(e,t){return e.length<=t?e:e.slice(0,t)}function rg(e){if(!e)return 0;let t=Date.parse(e);return Number.isNaN(t)?0:t}async function ig(e,t,n=_){if(!e||!t)return null;try{let[r,i,a]=await Promise.all([e.list({category:`lessons`}),e.list({category:`conventions`}),e.list({category:`session`})]),o=r.filter(e=>e.tags.includes(`lesson`)).map(e=>{let r=t.memoryMetaGet(e.path);return!r||r.supersededBy!=null?null:{entry:e,confidence:m(r.confidence,r.lastAccessedAt,r.createdAt,n)}}).filter(e=>e!==null).sort((e,t)=>t.confidence-e.confidence).slice(0,3);return{lessons:await Promise.all(o.map(async({entry:t,confidence:n})=>{let r=d((await e.read(t.path)).content);return{title:t.title,insight:ng(r.insight??``,150),confidence:n}})),conventions:i.map(e=>({entry:e,lastAccessedAt:t.memoryMetaGet(e.path)?.lastAccessedAt??null})).sort((e,t)=>rg(t.lastAccessedAt)-rg(e.lastAccessedAt)).slice(0,2).map(({entry:e})=>({title:e.title,preview:e.contentPreview})),checkpoint:a.map(e=>({entry:e,lastAccessedAt:t.memoryMetaGet(e.path)?.lastAccessedAt??null})).sort((e,t)=>rg(t.lastAccessedAt)-rg(e.lastAccessedAt)).map(({entry:e})=>ng(e.contentPreview,200))[0]??null}}catch{return null}}const ag=F(`tools`),og=14400*1e3,sg={includePrelude:R.boolean().default(!1).describe(`Include session prelude with top lessons, conventions, and last checkpoint`)};function cg(e,t,n,r=15e3){let i,a=new Promise(e=>{i=setTimeout(()=>{ag.warn(`Status sub-operation "${n}" timed out after ${r}ms`),e({value:t,timedOut:!0})},r)});return Promise.race([e.then(e=>(clearTimeout(i),{value:e,timedOut:!1}),e=>(clearTimeout(i),ag.warn(`Status sub-operation "${n}" failed: ${e instanceof Error?e.message:String(e)}`),{value:t,timedOut:!1})),a])}function lg(e){return e.onboarded?e.indexStale?{kind:`reindex`,reason:`Index stale. Run reindex() to update.`}:e.contextPressure>70?{kind:`handoff`,reason:`Context pressure high. Consider session handoff.`}:{kind:`proceed`,reason:`Ready to work.`}:{kind:`onboard`,reason:`Index not initialized. Run onboard({ path: "." }) first.`}}function ug(){let e=nr.get(),t=tr.get();if(e)return`- **Tree-sitter (WASM)**: ✅ Available (${t.grammarCount} grammars, dir: ${t.wasmDir})`;let n=t.pathsChecked.length?t.pathsChecked.map(e=>` ${e.exists?`✓`:`✗`} ${e.path}`).join(`
|
|
3001
3001
|
`):` none`,r=t.healAttempted?` Auto-heal: ${t.healSuccess?`✓ succeeded`:`✗ failed (${t.healError??`unknown`})`}`:` Auto-heal: not attempted`;return[`- **Tree-sitter (WASM)**: ⚠ Unavailable (regex fallback)`,` Reason: ${t.reason||`unknown`}`,` Paths checked:`,n,r,` OS: ${t.os} ${t.arch} | Node: ${t.nodeVersion}`,` Fix: Reinstall package or run vendor:wasm script`].join(`
|
|
3002
|
-
`)}const
|
|
3003
|
-
`)}],structuredContent:o}}))}function
|
|
3004
|
-
`),ue=e||D>=
|
|
3005
|
-
`)};if(i.length===1)try{return{content:[{type:`text`,text:`${await a(i[0])}\n---\n_Next: Use \`web_fetch\` to read any of these pages in full._`}]}}catch(e){return
|
|
3006
|
-
|
|
3007
|
-
`);return c===o.length?K(`INTERNAL`,u):{content:[{type:`text`,text:u}]}}))}function
|
|
3008
|
-
`)}]}}catch(e){return
|
|
3009
|
-
`)}]}}))}function
|
|
3002
|
+
`)}const dg=5*6e4;let fg=null,pg=null;function mg(e,t,n,r){let i=Math.min(e/2e4,1),a=Math.min((t+n)/5e4,1),o=Math.min(r/200,1);return Math.round(i*40+a*35+o*25)}function hg(){let e=Date.now();if(fg&&e-fg.ts<dg)return fg.value;try{let t=P(Ln(),`.copilot`,`.aikit-scaffold.json`);if(!A(t))return fg={value:null,ts:e},null;let n=JSON.parse(M(t,`utf-8`)).version??null;return fg={value:n,ts:e},n}catch{return fg={value:null,ts:e},null}}function gg(){let e=Date.now();if(pg&&e-pg.ts<dg)return pg.value;try{let t=P(process.cwd(),`.github`,`.aikit-scaffold.json`);if(!A(t))return pg={value:null,ts:e},null;let n=JSON.parse(M(t,`utf-8`)).version??null;return pg={value:n,ts:e},n}catch{return pg={value:null,ts:e},null}}function _g(e){let t=U(`status`);e.registerTool(`status`,{title:t.title,description:`Get the current status and statistics of the AI Kit index.`,inputSchema:sg,outputSchema:bs,annotations:t.annotations},q(`status`,async()=>{let e=ie(),t=hg(),n=gg(),r=t!=null&&t!==e,i=n!=null&&n!==e,a=[`## AI Kit Status`,``,`⏳ **AI Kit is initializing** — index stats will be available shortly.`,``,`### Runtime`,`- **Tree-sitter (WASM)**: ${nr.get()?`✅ Available (AST analysis)`:`⚠ Unavailable (regex fallback)`}`,``,`### Version`,`- **Server**: ${e}`,`- **Scaffold (user)**: ${t??`not installed`}`,`- **Scaffold (workspace)**: ${n??`not installed`}`];if(r||i){let o=ae(),s=[];r&&s.push(`user scaffold v${t}`),i&&s.push(`workspace scaffold v${n}`);let c=s.join(`, `);o.state===`success`?a.push(``,`### ✅ Upgrade Applied`,`- Server v${e} — ${c} auto-upgraded successfully.`,`- _Restart the MCP server to use the updated version._`):o.state===`pending`?a.push(``,`### ⏳ Upgrade In Progress`,`- Server v${e} ≠ ${c}`,`- Auto-upgrade is running in the background…`):o.state===`failed`?(re(),a.push(``,`### ⬆ Upgrade Available (auto-upgrade failed, retrying)`,`- Server v${e} ≠ ${c}`,`- Error: ${o.error??`unknown`}`)):(re(),a.push(``,`### ⬆ Upgrade Available`,`- Server v${e} ≠ ${c}`,`- Auto-upgrade triggered — check again shortly.`))}let o={totalRecords:0,totalFiles:0,lastIndexedAt:null,onboarded:!1,onboardDir:``,contentTypes:{},wasmAvailable:!!nr.get(),wasmDiagnostics:tr.get(),graphStats:null,curatedCount:0,serverVersion:e,scaffoldVersion:t??null,workspaceScaffoldVersion:n??null,upgradeAvailable:r||i,contextPressure:0,nextAction:lg({onboarded:!1,indexStale:!1,contextPressure:0})};return{content:[{type:`text`,text:a.join(`
|
|
3003
|
+
`)}],structuredContent:o}}))}function vg(e,t,n,r,i,a,o,s,c){let l=U(`status`);e.registerTool(`status`,{title:l.title,description:`Get the current status and statistics of the AI Kit index.`,inputSchema:sg,outputSchema:bs,annotations:l.annotations},q(`status`,async({includePrelude:e=!1})=>{let l=[];try{let[u,d]=await Promise.all([cg(t.getStats(),{totalRecords:0,totalFiles:0,lastIndexedAt:null,contentTypeBreakdown:{}},`store.getStats`),cg(t.listSourcePaths(),[],`store.listSourcePaths`)]),f=u.value;u.timedOut&&l.push(`⚠ Index stats timed out — values may be incomplete`);let p=d.value;d.timedOut&&l.push(`⚠ File listing timed out`);let m=null,h=0,g=[`## AI Kit Status`,``,`- **Total Records**: ${f.totalRecords}`,`- **Total Files**: ${f.totalFiles}`,`- **Last Indexed**: ${f.lastIndexedAt??`Never`}`,``,`### Content Types`,...Object.entries(f.contentTypeBreakdown).map(([e,t])=>`- ${e}: ${t}`),``,`### Indexed Files`,...p.slice(0,50).map(e=>`- ${e}`),p.length>50?`\n... and ${p.length-50} more files`:``];if(n)try{let e=await cg(n.getStats(),{nodeCount:0,edgeCount:0,nodeTypes:{},edgeTypes:{}},`graphStore.getStats`);if(e.timedOut)l.push(`⚠ Graph stats timed out`),g.push(``,`### Knowledge Graph`,`- Graph stats timed out`);else{let t=e.value;m={nodes:t.nodeCount,edges:t.edgeCount},g.push(``,`### Knowledge Graph`,`- **Nodes**: ${t.nodeCount}`,`- **Edges**: ${t.edgeCount}`,...Object.entries(t.nodeTypes).map(([e,t])=>` - ${e}: ${t}`));try{let e=await cg(n.validate(),{valid:!0,danglingEdges:[],orphanNodes:[],stats:{nodeCount:0,edgeCount:0,nodeTypes:{},edgeTypes:{}}},`graphStore.validate`);if(!e.timedOut){let t=e.value;t.valid||g.push(`- **⚠ Integrity Issues**: ${t.danglingEdges.length} dangling edges`),t.orphanNodes.length>0&&g.push(`- **Orphan nodes**: ${t.orphanNodes.length}`)}}catch{}}}catch{g.push(``,`### Knowledge Graph`,`- Graph store unavailable`)}let _=a?.onboardDir??``,v=A(_),y=i?.onboardComplete||v;if(g.push(``,`### Onboard Status`,y?`- ✅ Complete${i?.onboardTimestamp?` (last: ${i.onboardTimestamp})`:``}`:'- ❌ Not run — call `onboard({ path: "." })` to analyze the codebase',`- **Onboard Directory**: \`${_}\``),r)try{let e=await cg(r.list(),[],`curated.list`);if(e.timedOut)l.push(`⚠ Curated knowledge listing timed out`),g.push(``,`### Curated Knowledge`,`- Listing timed out`);else{let t=e.value;h=t.length,g.push(``,`### Curated Knowledge`,t.length>0?`- ${t.length} entries`:'- Empty — use `knowledge({ action: "remember", ... })` to persist decisions')}}catch{g.push(``,`### Curated Knowledge`,`- Unable to read curated entries`)}let b=mg(f.totalRecords,m?.nodes??0,m?.edges??0,h),x=f.lastIndexedAt?new Date(f.lastIndexedAt).getTime():0,S=x>0?Date.now()-x:1/0,C=lg({onboarded:y,indexStale:y&&S>1440*60*1e3,contextPressure:b});g.push(``),g.push(`## 📊 Context Pressure: ${b}/100`),b>=80?g.push(`⚠️ High pressure — consider pruning stale entries or compacting context.`):b>=50?g.push(`ℹ️ Moderate pressure — AI Kit memory is well-populated.`):g.push(`✅ Low pressure — plenty of headroom for more content.`);let w=0;if(f.lastIndexedAt){w=new Date(f.lastIndexedAt).getTime();let e=(Date.now()-w)/(1e3*60*60);g.push(``,`### Index Freshness`,e>24?o===`smart`?`- ⚠ Last indexed ${Math.floor(e)}h ago — smart indexing will refresh automatically`:`- ⚠ Last indexed ${Math.floor(e)}h ago — may be stale. Run \`reindex({})\``:`- ✅ Last indexed ${e<1?`less than 1h`:`${Math.floor(e)}h`} ago`)}g.push(``,`### Next Action`,`- **${C.kind}**: ${C.reason}`);let T=null,E=t;if(typeof E.getDiagnostics==`function`)try{T=E.getDiagnostics(),g.push(``,`### Storage`,`- **Backend**: ${a?.store?.backend??`unknown`}`,`- **Adapter**: ${T.adapterType}`,`- **Vector search**: ${T.vectorSearchEnabled?`✅ enabled`:`⚠ disabled (FTS-only fallback)`}`,T.dbPath?`- **DB**: ${T.dbPath}`:``,T.dbSizeBytes==null?``:`- **DB size**: ${(T.dbSizeBytes/1024/1024).toFixed(2)} MB`,`- **Embedding dim**: ${T.embeddingDim}`,`- **Vector dtype**: ${T.vectorDtype}`)}catch{}if(o===`smart`)if(g.push(``,`### Smart Indexing`),s){let e=s();e?g.push(`- **Mode**: Smart (trickle)`,`- **Status**: ${e.running?`✅ Running`:`⏸ Stopped`}`,`- **Queue**: ${e.queueSize} files pending`,`- **Changed files**: ${e.changedFilesSize} detected`,`- **Interval**: ${Math.round(e.intervalMs/1e3)}s per batch of ${e.batchSize}`):g.push(`- **Mode**: Smart (trickle)`,`- **Status**: scheduler state unavailable (init may have failed)`)}else g.push(`- **Mode**: Smart (trickle) — scheduler state unavailable`);let D=0;{try{let e=a?.stateDir?N(a.stateDir,`stash`):null;if(e&&A(e)){let t=pe(e).mtimeMs;t>w&&(w=t)}}catch{}let e=[];if(r)try{let t=h>0?await r.list():[];for(let e of t){let t=new Date(e.updated||e.created).getTime();t>w&&(w=t)}e.push(...t.sort((e,t)=>new Date(t.updated).getTime()-new Date(e.updated).getTime()).slice(0,5))}catch{}if(D=w>0?Date.now()-w:0,D>=og){let t=Math.floor(D/36e5);if(g.push(``,`### 🌅 Session Briefing`,`_${t}+ hours since last activity — here's what to pick up:_`,``),e.length>0){g.push(`**Recent decisions/notes:**`);for(let t of e)g.push(`- **${t.title}** (${t.category??`note`}) — ${(t.contentPreview??``).slice(0,80)}…`)}g.push(``,`**Suggested next steps:**`,'- `search({ query: "SESSION CHECKPOINT", origin: "curated" })` — find your last checkpoint',"- `restore({})` — resume from a saved checkpoint",'- `knowledge({ action: "list" })` — browse all stored knowledge')}}g.push(``,`### Runtime`,ug());let O=Ee.instance().getAll(),ee=O.filter(e=>e.status!==`healthy`);if(ee.length>0){g.push(``,`### ⚠️ Subsystem Health`);for(let e of ee){let t=Math.round((Date.now()-e.since)/1e3);g.push(`- **${e.name}**: ${e.status} (${t}s ago${e.reason?` — ${e.reason}`:``})`)}}else O.length>0&&g.push(``,`### ✅ Subsystem Health`,`- All ${O.length} subsystems healthy`);let te=we.getAll();if(te.size>0){g.push(``,`### 🔌 Circuit Breakers`);for(let[e,t]of te){let n=t.getState(),r=`- **${e}**: ${n===`closed`?`🟢`:n===`open`?`🔴`:`🟡`} ${n}`;if(n===`open`){let e=t.remainingCooldownMs();r+=` (recovery in ${Math.ceil(e/1e3)}s)`}g.push(r)}}let ne=hg(),oe=gg(),k=ie(),se=ne!=null&&ne!==k,ce=oe!=null&&oe!==k;if(se||ce){let e=ae(),t=[];se&&t.push(`user scaffold v${ne}`),ce&&t.push(`workspace scaffold v${oe}`);let n=t.join(`, `);e.state===`success`?g.push(``,`### ✅ Upgrade Applied`,`- Server v${k} — ${n} auto-upgraded successfully.`,`- _Restart the MCP server to use the updated version._`):e.state===`pending`?g.push(``,`### ⏳ Upgrade In Progress`,`- Server v${k} ≠ ${n}`,`- Auto-upgrade is running in the background…`):e.state===`failed`?(re(),g.push(``,`### ⬆ Upgrade Available (auto-upgrade failed, retrying)`,`- Server v${k} ≠ ${n}`,`- Error: ${e.error??`unknown`}`)):(re(),g.push(``,`### ⬆ Upgrade Available`,`- Server v${k} ≠ ${n}`,`- Auto-upgrade triggered — check again shortly.`))}l.length>0&&g.push(``,`### ⚠ Warnings`,...l.map(e=>`- ${e}`));let le=wo();if(le.length>0){let e=le.sort((e,t)=>t.callCount-e.callCount);g.push(``,`### Tool Usage This Session`,``),g.push(`| Tool | Calls | Tokens In | Tokens Out | Errors | Avg Latency |`),g.push(`|------|-------|-----------|------------|--------|-------------|`);for(let t of e.slice(0,15)){let e=Math.round(t.totalInputChars/4),n=Math.round(t.totalOutputChars/4),r=Math.round(t.totalDurationMs/t.callCount);g.push(`| ${t.tool} | ${t.callCount} | ${e.toLocaleString()} | ${n.toLocaleString()} | ${t.errorCount} | ${r}ms |`)}}let j=go();if(j.bufferSize>=10){let e=j.state===`healthy`?`🟢`:j.state===`degraded`?`🔴`:`🟡`;g.push(``,`### Auto-GC: ${e} ${j.state}`),g.push(`- p95 latency: ${j.p95}ms | buffer: ${j.bufferSize} samples`),j.gcCount>0&&g.push(`- GC cycles triggered: ${j.gcCount}`)}let M=g.join(`
|
|
3004
|
+
`),ue=e||D>=og?await ig(r,c):void 0,de={totalRecords:f.totalRecords,totalFiles:f.totalFiles,lastIndexedAt:f.lastIndexedAt??null,onboarded:y,onboardDir:_,contentTypes:f.contentTypeBreakdown,wasmAvailable:!!nr.get(),wasmDiagnostics:tr.get(),graphStats:m,curatedCount:h,serverVersion:k,scaffoldVersion:ne??null,workspaceScaffoldVersion:oe??null,upgradeAvailable:se||ce,storeBackend:a?.store?.backend,storeDiagnostics:T??null,contextPressure:b,nextAction:C,...ue===void 0?{}:{prelude:ue}};return{content:[{type:`text`,text:M+(o===`smart`?"\n\n---\n_Next: Use `search` to query indexed content or `graph({action:'find_nodes', name_pattern:'<top-level-module>'})` → then `graph({action:'neighbors', node_id})` for relationships. Smart indexing handles updates automatically._":"\n\n---\n_Next: Use `search` to query indexed content, `graph({action:'find_nodes', name_pattern:'<top-level-module>'})` → then `graph({action:'neighbors', node_id})` for relationships, or `reindex` to refresh the index._")}],structuredContent:de}}catch(e){return ag.error(`Status failed`,I(e)),K(`INTERNAL`,`Status check failed: ${e instanceof Error?e.message:String(e)}`)}}))}const yg=F(`tools`);function bg(e){let t=U(`web_search`);e.registerTool(`web_search`,{title:t.title,description:`PREFERRED web search — fans out to multiple keyless providers (DuckDuckGo + Bing-HTML + Mojeek) by default, returning a deduplicated, consensus-ranked union within a 10s deadline. Optional providers (SearXNG, Google, Brave, Bing API) join the fan-out automatically when their env vars are set. Pass one query or multiple for parallel searching.`,inputSchema:{queries:R.array(R.string().max(2e3)).min(1).max(5).describe('Search queries (1–5). Single: `["react hooks"]`. Multiple searched in parallel.'),limit:R.number().min(1).max(20).default(5).describe(`Max results per query`),site:R.string().optional().describe(`Restrict to domain (e.g., "docs.aws.amazon.com")`),provider:R.enum([`multi`,`duckduckgo`,`bing-html`,`mojeek`,`searxng`,`google`,`brave`,`bing`]).optional().describe("Search provider. Defaults to env AIKIT_SEARCH_PROVIDER, then `multi` (fan-out). Single keyless: `duckduckgo`, `bing-html`, `mojeek`. Self-hosted: `searxng` (requires SEARXNG_URL). Keyed APIs: `google` (GOOGLE_API_KEY+GOOGLE_CSE_ID), `brave` (BRAVE_API_KEY), `bing` (BING_API_KEY). Missing keys auto-fall back to duckduckgo.")},annotations:t.annotations},q(`web_search`,async({queries:e,limit:t,site:n,provider:r})=>{let i=e,a=async e=>{let i=await kn({query:e,limit:t,site:n,provider:r}),a=[`## Search: ${i.query} _(via ${i.provider})_`,``];if(i.results.length===0)a.push(`No results found.`);else for(let e of i.results)a.push(`### [${e.title}](${e.url})`,e.snippet,``);return a.join(`
|
|
3005
|
+
`)};if(i.length===1)try{return{content:[{type:`text`,text:`${await a(i[0])}\n---\n_Next: Use \`web_fetch\` to read any of these pages in full._`}]}}catch(e){return yg.error(`Web search failed`,I(e)),K(`INTERNAL`,`Web search failed: ${e instanceof Error?e.message:String(e)}`)}let o=await Promise.allSettled(i.map(e=>a(e))),s=[],c=0;for(let e=0;e<o.length;e++){let t=o[e];if(t.status===`fulfilled`)s.push(t.value);else{c++;let n=t.reason instanceof Error?t.reason.message:String(t.reason);yg.error(`Web search failed`,{query:i[e],error:n}),s.push(`## ❌ Search failed: ${i[e]}\n\n${n}`)}}let l=`_Searched ${o.length-c}/${o.length} queries successfully._`;s.push(``,`---`,l,"_Next: Use `web_fetch` to read any of these pages in full._");let u=s.join(`
|
|
3006
|
+
|
|
3007
|
+
`);return c===o.length?K(`INTERNAL`,u):{content:[{type:`text`,text:u}]}}))}function xg(e){let t=U(`http`);e.registerTool(`http`,{title:t.title,description:`Make HTTP requests (GET/POST/PUT/PATCH/DELETE/HEAD) for API testing. Returns status, headers, and formatted body with timing info.`,inputSchema:{url:R.string().url().describe(`Request URL (http/https only)`),method:R.enum([`GET`,`POST`,`PUT`,`PATCH`,`DELETE`,`HEAD`]).default(`GET`).describe(`HTTP method`),headers:R.record(R.string(),R.string()).optional().describe(`Request headers as key-value pairs`),body:R.string().optional().describe(`Request body (for POST/PUT/PATCH)`),timeout:R.number().min(1e3).max(6e4).default(15e3).describe(`Timeout in milliseconds`)},annotations:t.annotations},q(`http`,async({url:e,method:t,headers:n,body:r,timeout:i})=>{try{let a=await wt({url:e,method:t,headers:n,body:r,timeout:i}),o=[`## ${t} ${e}`,``,`**Status:** ${a.status} ${a.statusText}`,`**Time:** ${a.durationMs}ms`,`**Size:** ${a.sizeBytes} bytes`,`**Content-Type:** ${a.contentType}`,``,`### Headers`,"```json",JSON.stringify(a.headers),"```",``,`### Body`,a.contentType.includes(`json`)?"```json":"```",a.body,"```"];return a.truncated&&o.push(``,`_Response truncated — total size: ${a.sizeBytes} bytes_`),{content:[{type:`text`,text:o.join(`
|
|
3008
|
+
`)}]}}catch(e){return yg.error(`HTTP request failed`,I(e)),K(`INTERNAL`,`HTTP request failed: ${e instanceof Error?e.message:String(e)}`)}}))}function Sg(e){let t=U(`regex_test`);e.registerTool(`regex_test`,{title:t.title,description:`Test a regex pattern against sample strings. Supports match, replace, and split modes.`,inputSchema:{pattern:R.string().max(500).describe(`Regex pattern (without delimiters)`),flags:R.string().max(10).regex(/^[gimsuy]*$/).default(``).describe(`Regex flags (g, i, m, s, etc.)`),test_strings:R.array(R.string().max(1e4)).max(50).describe(`Strings to test the pattern against`),mode:R.enum([`match`,`replace`,`split`]).default(`match`).describe(`Test mode`),replacement:R.string().optional().describe(`Replacement string (for replace mode)`)},annotations:t.annotations},q(`regex_test`,async({pattern:e,flags:t,test_strings:n,mode:r,replacement:i})=>{let a=Qt({pattern:e,flags:t,testStrings:n,mode:r,replacement:i});if(!a.valid)return K(`VALIDATION`,`Invalid regex: ${a.error}`);let o=[`## Regex: \`/${a.pattern}/${a.flags}\``,``,`Mode: ${r}`,``];for(let e of a.results){if(o.push(`**Input:** \`${e.input}\``),o.push(`**Matched:** ${e.matched}`),e.matches)for(let t of e.matches){let e=t.groups.length>0?` groups: [${t.groups.join(`, `)}]`:``;o.push(` - "${t.full}" at index ${t.index}${e}`)}e.replaced!==void 0&&o.push(`**Result:** \`${e.replaced}\``),e.split&&o.push(`**Split:** ${JSON.stringify(e.split)}`),o.push(``)}return{content:[{type:`text`,text:o.join(`
|
|
3009
|
+
`)}]}}))}function Cg(e){let t=U(`encode`);e.registerTool(`encode`,{title:t.title,description:`Encode, decode, or hash text. Supports base64, URL encoding, SHA-256, MD5, JWT decode, hex.`,inputSchema:{operation:R.enum([`base64_encode`,`base64_decode`,`url_encode`,`url_decode`,`sha256`,`md5`,`jwt_decode`,`hex_encode`,`hex_decode`]).describe(`Operation to perform`),input:R.string().max(1e6).describe(`Input text`)},annotations:t.annotations},q(`encode`,async({operation:e,input:t})=>{try{let n=st({operation:e,input:t});return{content:[{type:`text`,text:`## ${e}\n\n**Input:** \`${t.length>100?`${t.slice(0,100)}...`:t}\`\n**Output:**\n\`\`\`\n${n.output}\n\`\`\``}]}}catch(e){return yg.error(`Encode failed`,I(e)),K(`INTERNAL`,`Encode failed: ${e instanceof Error?e.message:String(e)}`)}}))}function wg(e){let t=U(`measure`);e.registerTool(`measure`,{title:t.title,description:`Measure code complexity, line counts, and function counts for a file or directory. Returns per-file metrics sorted by complexity.`,outputSchema:Ss,inputSchema:{path:R.string().describe(`File or directory path to measure`),extensions:R.array(R.string()).optional().describe(`File extensions to include (default: .ts,.tsx,.js,.jsx)`),max_tokens:R.number().min(100).max(5e4).optional().describe(`Maximum token budget for the response. When set, output is truncated to fit.`)},annotations:t.annotations},q(`measure`,async({path:e,extensions:t,max_tokens:n})=>{try{let r=await Pt({path:e,extensions:t}),i=[`## Code Metrics`,``,`**Files:** ${r.summary.totalFiles}`,`**Total lines:** ${r.summary.totalLines} (${r.summary.totalCodeLines} code)`,`**Functions:** ${r.summary.totalFunctions}`,`**Avg complexity:** ${r.summary.avgComplexity}`,`**Max complexity:** ${r.summary.maxComplexity.value} (${r.summary.maxComplexity.file})`,``,`### Top files by complexity`,``,`| File | Lines | Code | Complexity | Cognitive | Functions | Imports |`,`|------|-------|------|------------|-----------|-----------|---------|`];for(let e of r.files.slice(0,20)){let t=e.cognitiveComplexity===void 0?`—`:String(e.cognitiveComplexity);i.push(`| ${e.path} | ${e.lines.total} | ${e.lines.code} | ${e.complexity} | ${t} | ${e.functions} | ${e.imports} |`)}r.files.length>20&&i.push(``,`_...and ${r.files.length-20} more files_`);let a={summary:{totalFiles:r.summary.totalFiles,totalLines:r.summary.totalLines,totalCodeLines:r.summary.totalCodeLines,totalFunctions:r.summary.totalFunctions,avgComplexity:r.summary.avgComplexity,maxComplexity:{value:r.summary.maxComplexity.value,file:r.summary.maxComplexity.file}},files:r.files.map(e=>({path:e.path,lines:e.lines.total,code:e.lines.code,complexity:e.complexity,functions:e.functions}))};return{content:[{type:`text`,text:n?L(i.join(`
|
|
3010
3010
|
`),n):i.join(`
|
|
3011
|
-
`)}],structuredContent:a}}catch(e){return
|
|
3011
|
+
`)}],structuredContent:a}}catch(e){return yg.error(`Measure failed`,I(e)),K(`INTERNAL`,`Measure failed: ${e instanceof Error?e.message:String(e)}`)}}))}function Tg(e){let t=U(`changelog`);e.registerTool(`changelog`,{title:t.title,description:`Generate a changelog from git history between two refs. Groups by conventional commit type.`,inputSchema:{from:R.string().max(200).describe(`Start ref (tag, SHA, HEAD~N)`),to:R.string().max(200).default(`HEAD`).describe(`End ref (default: HEAD)`),format:R.enum([`grouped`,`chronological`,`per-scope`]).default(`grouped`).describe(`Output format`),include_breaking:R.boolean().default(!0).describe(`Highlight breaking changes`),cwd:R.string().optional().describe(`Repository root or working directory`)},annotations:t.annotations},q(`changelog`,async({from:e,to:t,format:n,include_breaking:r,cwd:i})=>{try{let a=Ve({from:e,to:t,format:n,includeBreaking:r,cwd:i}),o=`${a.stats.total} commits (${Object.entries(a.stats.types).map(([e,t])=>`${t} ${e}`).join(`, `)})`;return{content:[{type:`text`,text:`${a.markdown}\n---\n_${o}_`}]}}catch(e){return yg.error(`Changelog failed`,I(e)),K(`INTERNAL`,`Changelog failed: ${e instanceof Error?e.message:String(e)}`)}}))}function Eg(e){let t=U(`schema_validate`);e.registerTool(`schema_validate`,{title:t.title,description:`Validate JSON data against a JSON Schema. Supports type, required, properties, items, enum, pattern, min/max.`,inputSchema:{data:R.string().max(5e5).describe(`JSON data to validate (as string)`),schema:R.string().max(5e5).describe(`JSON Schema to validate against (as string)`)},annotations:t.annotations},q(`schema_validate`,async({data:e,schema:t})=>{try{let n=ln({data:JSON.parse(e),schema:JSON.parse(t)});if(n.valid)return{content:[{type:`text`,text:`## Validation: PASSED
|
|
3012
3012
|
|
|
3013
3013
|
Data matches the schema.`}]};let r=[`## Validation: FAILED`,``,`**${n.errors.length} error(s):**`,``];for(let e of n.errors){let t=e.expected?` (expected: ${e.expected}, got: ${e.received})`:``;r.push(`- \`${e.path}\`: ${e.message}${t}`)}return{content:[{type:`text`,text:r.join(`
|
|
3014
|
-
`)}]}}catch(e){return
|
|
3015
|
-
`)}],structuredContent:a}}))}function
|
|
3016
|
-
`)}],structuredContent:o}}catch(e){return
|
|
3014
|
+
`)}]}}catch(e){return yg.error(`Schema validation failed`,I(e)),K(`INTERNAL`,`Schema validation failed: ${e instanceof Error?e.message:String(e)}`)}}))}function Dg(e){let t=U(`env`);e.registerTool(`env`,{title:t.title,description:`Get system and runtime environment info. Sensitive env vars are redacted by default.`,outputSchema:Cs,inputSchema:{include_env:R.boolean().default(!1).describe(`Include environment variables`),filter_env:R.string().optional().describe(`Filter env vars by name substring`),show_sensitive:R.boolean().default(!1).describe(`Show sensitive values (keys, tokens, etc.) — redacted by default`)},annotations:t.annotations},q(`env`,async({include_env:e,filter_env:t,show_sensitive:n})=>{let r=lt({includeEnv:e,filterEnv:t,showSensitive:n}),i=[`## Environment`,``,`**Platform:** ${r.system.platform} ${r.system.arch}`,`**OS:** ${r.system.type} ${r.system.release}`,`**Host:** ${r.system.hostname}`,`**CPUs:** ${r.system.cpus}`,`**Memory:** ${r.system.memoryFreeGb}GB free / ${r.system.memoryTotalGb}GB total`,``,`**Node:** ${r.runtime.node}`,`**V8:** ${r.runtime.v8}`,`**CWD:** ${r.cwd}`];if(r.env){i.push(``,`### Environment Variables`,``);for(let[e,t]of Object.entries(r.env))i.push(`- \`${e}\`: ${t}`)}let a={platform:r.system.platform,arch:r.system.arch,nodeVersion:r.runtime.node,cwd:r.cwd,cpus:r.system.cpus,memoryFreeGb:r.system.memoryFreeGb,memoryTotalGb:r.system.memoryTotalGb};return{content:[{type:`text`,text:i.join(`
|
|
3015
|
+
`)}],structuredContent:a}}))}function Og(e){let t=U(`time`);e.registerTool(`time`,{title:t.title,description:`Parse dates, convert timezones, calculate durations, add time. Supports ISO 8601, unix timestamps, and human-readable formats.`,outputSchema:ws,inputSchema:{operation:R.enum([`now`,`parse`,`convert`,`diff`,`add`]).describe(`now: current time | parse: parse a date string | convert: timezone conversion | diff: duration between two dates | add: add duration to date`),input:R.string().optional().describe(`Date input (ISO, unix timestamp, or parseable string). For diff: two comma-separated dates`),timezone:R.string().optional().describe(`Target timezone (e.g., "America/New_York", "Asia/Tokyo")`),duration:R.string().optional().describe(`Duration to add (e.g., "2h30m", "1d", "30s") — for add operation`)},annotations:t.annotations},q(`time`,async({operation:e,input:t,timezone:n,duration:r})=>{try{let i=Cn({operation:e,input:t,timezone:n,duration:r}),a=[`**${i.output}**`,``,`ISO: ${i.iso}`,`Unix: ${i.unix}`];i.details&&a.push(``,"```json",JSON.stringify(i.details),"```");let o={iso:i.iso,unix:i.unix,timezone:n??Intl.DateTimeFormat().resolvedOptions().timeZone,formatted:i.output};return{content:[{type:`text`,text:a.join(`
|
|
3016
|
+
`)}],structuredContent:o}}catch(e){return yg.error(`Time failed`,I(e)),K(`INTERNAL`,`Time failed: ${e instanceof Error?e.message:String(e)}`)}}))}function kg(e){try{let t=N(e,`.flows`);if(!A(t))return null;let n=ue(t,{withFileTypes:!0});for(let e of n){if(!e.isDirectory())continue;let n=N(t,e.name,`meta.json`);if(A(n)&&JSON.parse(M(n,`utf-8`)).status===`active`)return e.name}}catch{return null}return null}function Ag(e,t,n,r,i,a,o,s,c,l){let u=new co,d=n.sources[0]?.path??process.cwd(),f={activeSlug:null};f.activeSlug=kg(d);let p=new Oa(N(n.stateDir??``,`flow-context`),()=>f.activeSlug),m=new ya;m.register(Ti()),m.register(ga),m.register(Fi),m.register(aa),m.register(Mi),m.register(Ei),m.register(Di),m.register(pa),m.register(ki),m.register(va),m.register(ia(()=>f.activeSlug?{active:!0,slug:f.activeSlug}:null));let h=new wa(m,t.curated,{},p),g=l??hs(n,[...Bo,...Po],Yo,Io(n)),_=e=>g.has(e),v=new Set([...g].filter(e=>!Xf.includes(e)&&!Ja.has(e))),y=new Qa;u.use(Sa(h),{order:5,name:`auto-knowledge`}),u.use(Eo(),{order:10,name:`replay`}),u.use(to(y,{stateStore:t.stateStore,curatedStore:t.curated},{trackedTools:v}),{order:94,name:`procedural-memory`}),u.use(Wa(new Ha(t.stateStore,t.curated)),{order:95,name:`observation-capture`}),u.use(Ho(),{order:1,name:`structured-content-guard`}),u.use(Da(Ea(n.tokenBudget)),{order:90,name:`compression`}),es(e,u,n.toolPrefix??``);let b=[...g].filter(e=>Fo.has(e)?No.includes(e)?!!t.bridge:e===`er_update_policy`?!!t.policyStore:e===`er_evolve_review`?!!t.evolutionCollector:!1:!0);_(`search`)&&Ih(e,t.embedder,t.store,t.graphStore,t.bridge,t.evolutionCollector,a,t.stateStore,n.memory?.retention,n.memory?.consolidation);let x={store:t.store,graphStore:t.graphStore,embedder:t.embedder},S=c?e=>{c()?.prioritize(e)}:void 0;_(`lookup`)&&zf(e,t.store,x);let C={onboardComplete:t.onboardComplete,onboardTimestamp:t.onboardTimestamp};_(`status`)&&vg(e,t.store,t.graphStore,t.curated,C,n,o,s,t.stateStore),_(`config`)&&ol(e,n),_(`reindex`)&&gh(e,t.indexer,n,t.curated,t.store,i,o),_(`knowledge`)&&Lf(e,t.curated,t.policyStore,t.evolutionCollector,i,p,t.stateStore,n.memory?.retention,n.memory?.supersession,n.memory?.consolidation,n.memory?.lessons,x),_(`analyze`)&&Tc(e,t.store,t.embedder,x),_(`blast_radius`)&&Ec(e,t.store,t.embedder,t.graphStore,x),_(`produce_knowledge`)&&mh(e,n),_(`onboard`)&&np(e,t.store,t.embedder,n,C,x),_(`graph`)&&Wu(e,t.graphStore,x),_(`audit`)&&jc(e,t.store,t.embedder,n.tokenBudget),_(`compact`)&&yl(e,t.embedder,t.fileCache,d,n.allRoots,x,S),_(`scope_map`)&&bl(e,t.embedder,t.store,x),_(`find`)&&xl(e,t.embedder,t.store,d,x),_(`parse_output`)&&Fl(e),_(`workset`)&&ip(e),_(`check`)&&Ml(e,x,n.tokenBudget),_(`symbol`)&&Sl(e,t.embedder,t.store,t.graphStore,x),_(`eval`)&&Nl(e),_(`test_run`)&&Pl(e,x),_(`stash`)&&ap(e,t.stateStore),_(`signal`)&&tg(e,t.stateStore),_(`git_context`)&&Uf(e),_(`diff_parse`)&&Wf(e),_(`rename`)&&Gf(e,n),_(`codemod`)&&Kf(e,n),_(`restore`)&&bh(e),_(`file_summary`)&&Cl(e,t.fileCache,d,n.allRoots,x,S),_(`checkpoint`)&&op(e,t.stateStore),_(`data_transform`)&&qf(e),_(`trace`)&&wl(e,t.embedder,t.store,t.graphStore,x),_(`process`)&&Ku(e),_(`watch`)&&qu(e),_(`dead_symbols`)&&Tl(e,t.embedder,t.store,d,n.allRoots,x),_(`delegate`)&&Il(e,a),_(`health`)&&Ju(e),_(`lane`)&&sp(e),_(`queue`)&&cp(e),_(`web_fetch`)&&Yu(e),_(`guide`)&&Xu(e,o),Xf.some(e=>_(e))&&Zf(e,n,b),_(`evidence_map`)&&Iu(e),_(`digest`)&&Lu(e,t.embedder),_(`forge_classify`)&&Ru(e,x),_(`stratum_card`)&&zu(e,t.embedder,t.fileCache),_(`forge_ground`)&&Bu(e,t.embedder,t.store),_(`present`)&&fh(e,r),_(`browser`)&&Kn(e,n),_(`web_search`)&&bg(e),_(`http`)&&xg(e),_(`regex_test`)&&Sg(e),_(`encode`)&&Cg(e),_(`measure`)&&wg(e),_(`changelog`)&&Tg(e),_(`schema_validate`)&&Eg(e),_(`env`)&&Dg(e),_(`time`)&&Og(e),_(`flow`)&&Pu(e,n,{store:t.store?{search:async(e,n)=>(await t.store.ftsSearch(e,n)).map(e=>({content:e.record.content}))}:null,graphStore:t.graphStore,embedder:t.embedder},e=>{f.activeSlug=e}),t.bridge&&No.some(e=>_(e))&&(Fc(e,t.bridge,t.evolutionCollector),Ic(e,t.bridge),Lc(e,t.bridge)),t.policyStore&&_(`er_update_policy`)&&mp(e,t.policyStore),t.evolutionCollector&&_(`er_evolve_review`)&&Al(e,t.evolutionCollector),Mo(e,t.store,t.curated),_(`compliance_score`)&&Bc(e),_(`replay`)&&vh(e),_(`session_digest`)&&Rh(e,t.stateStore,a)}function jg(e,t,n){let r=e=>!n||n.has(e);r(`check`)&&Ml(e,void 0,t.tokenBudget),r(`eval`)&&Nl(e),r(`test_run`)&&Pl(e),r(`parse_output`)&&Fl(e),r(`delegate`)&&Il(e),r(`git_context`)&&Uf(e),r(`diff_parse`)&&Wf(e),r(`rename`)&&Gf(e,t),r(`codemod`)&&Kf(e,t),r(`data_transform`)&&qf(e),r(`workset`)&&ip(e),r(`restore`)&&bh(e),r(`lane`)&&sp(e),r(`queue`)&&cp(e),r(`session_digest`)&&Rh(e),r(`health`)&&Ju(e),r(`process`)&&Ku(e),r(`watch`)&&qu(e),r(`web_fetch`)&&Yu(e),r(`guide`)&&Xu(e),Xf.some(e=>r(e))&&Zf(e,t,[...n??new Set(Bo)]),r(`evidence_map`)&&Iu(e),r(`forge_classify`)&&Ru(e),r(`present`)&&fh(e),r(`browser`)&&Kn(e,t),r(`produce_knowledge`)&&mh(e),r(`compliance_score`)&&Bc(e),r(`replay`)&&vh(e),r(`status`)&&_g(e),r(`flow`)&&Pu(e,t),r(`web_search`)&&bg(e),r(`http`)&&xg(e),r(`regex_test`)&&Sg(e),r(`encode`)&&Cg(e),r(`measure`)&&wg(e),r(`changelog`)&&Tg(e),r(`schema_validate`)&&Eg(e),r(`env`)&&Dg(e),r(`time`)&&Og(e)}const Mg=F(`resource-notifier`);var Ng=class{mcpServer;constructor(e){this.mcpServer=e}async notifyStatusChanged(){await this.sendUpdate(`aikit://status`)}async notifyFileTreeChanged(){await this.sendUpdate(`aikit://file-tree`)}async notifyCuratedIndexChanged(){await this.sendUpdate(`aikit://curated`)}async notifyCuratedEntryChanged(e){await this.sendUpdate(`aikit://curated/${e}`)}async notifyResourceListChanged(){try{await this.mcpServer.server.sendResourceListChanged()}catch(e){Mg.debug(`sendResourceListChanged failed`,{error:String(e)})}}async notifyAfterReindex(){await Promise.allSettled([this.notifyStatusChanged(),this.notifyFileTreeChanged()])}async notifyAfterCuratedWrite(e){let t=[this.notifyStatusChanged(),this.notifyCuratedIndexChanged()];e&&t.push(this.notifyCuratedEntryChanged(e)),await Promise.allSettled(t)}async sendUpdate(e){try{await this.mcpServer.server.sendResourceUpdated({uri:e})}catch(t){Mg.debug(`sendResourceUpdated failed`,{uri:e,error:String(t)})}}};const Q=F(`server`);function Pg(e){let t=e?.trim().toLowerCase();return t===`1`||t===`true`||t===`yes`||t===`on`}async function Fg(n){Q.info(`Initializing AI Kit components`);let r=n.store.backend,i=n.store.path,a=Pg(process.env.AIKIT_SPLIT_STATE),o=N(i,`aikit.db`),s={splitEnabled:a,contentDbPath:o,controlDbPath:a?N(i,`aikit-control.db`):o},c=null;if(r===`sqlite-vec`){let e=s.contentDbPath;A(i)||j(i,{recursive:!0}),c=await hr(e),Q.info(`SQLite adapter ready`,{type:c.type,vectorCapable:c.vectorCapable,dbPath:e}),c.vectorCapable||Q.warn(`┌──────────────────────────────────────────────────────────────────┐
|
|
3017
3017
|
│ ⚠ SQLite vector extension unavailable — DEGRADED MODE │
|
|
3018
3018
|
│ Vector search is disabled. Hybrid search returns FTS only. │
|
|
3019
3019
|
│ To enable: install/rebuild better-sqlite3 (native module). │
|
|
3020
|
-
└──────────────────────────────────────────────────────────────────┘`);let t=N(i,`lance`);A(t)&&Q.info(`Old LanceDB data found at ${t} — ignored. Safe to delete after verifying sqlite-vec works.`)}let l;if(c)if(s.splitEnabled&&s.controlDbPath!==s.contentDbPath){let{migrateToSplitState:e}=await import(`../../store/dist/index.js`);await e(s),l=await hr(s.controlDbPath),vr(l,mr),Q.info(`State store adapter ready`,{type:l.type,dbPath:s.controlDbPath,splitEnabled:!0})}else l=c;else{let e=N(i,`aikit-state.db`);A(i)||j(i,{recursive:!0}),l=await hr(e),vr(l,mr),Q.info(`State store adapter ready`,{type:l.type,dbPath:e})}let[u,d,f,p]=await Promise.all([(async()=>{if(n.embedding.childProcess!==!1){let e=new Mr({model:n.embedding.model,dimensions:n.embedding.dimensions,interOpNumThreads:n.embedding.interOpNumThreads,intraOpNumThreads:n.embedding.intraOpNumThreads,idleTimeoutMs:n.embedding.idleTimeoutMs});return await e.initialize(),Q.info(`Embedder loaded (child process)`,{modelId:e.modelId,dimensions:e.dimensions}),e}let{OnnxEmbedder:e}=await import(`../../embeddings/dist/index.js`),t=new e({model:n.embedding.model,dimensions:n.embedding.dimensions,interOpNumThreads:n.embedding.interOpNumThreads,intraOpNumThreads:n.embedding.intraOpNumThreads});return await t.initialize(),Q.info(`Embedder loaded (in-process)`,{modelId:t.modelId,dimensions:t.dimensions}),t})(),(async()=>{let e=await _r({backend:r,path:i,adapter:c??void 0,embeddingDim:n.embedding.dimensions,partition:r===`sqlite-vec`?s:void 0});return await e.initialize(),Q.info(`Store initialized`,{backend:r}),e})(),(async()=>{let e=c?new pr({adapter:c}):new pr({path:i});return await e.initialize(),Q.info(`Graph store initialized`,{shared:!!c}),e})(),(async()=>{let e=await rr();if(e){let e=tr.get();Q.info(`WASM tree-sitter enabled`,{grammars:e.grammarCount,dir:e.wasmDir})}else{let e=tr.get();Q.warn(`WASM tree-sitter not available; analyzers will use regex fallback`,{reason:e.reason,os:e.os,arch:e.arch,healAttempted:e.healAttempted,healSuccess:e.healSuccess,healError:e.healError,pathsChecked:e.pathsChecked.map(e=>`${e.path} (${e.exists?`found`:`missing`})`)})}return e})()]),m=new Pr(u,d),h=gr(l),g=new Nr(n.store.path);g.load(),m.setHashCache(g);let _=n.curated.path,v=new e(_);await v.initialize();let y=new t(_,d,u,v);m.setGraphStore(f);let b=Pc(n.er),x=b?new sr(n.curated.path):void 0;x&&Q.info(`Policy store initialized`,{ruleCount:x.getRules().length});let S=b?new or:void 0,C=P(n.sources[0]?.path??process.cwd(),Se.aiContext),w=A(C),T=n.onboardDir?A(n.onboardDir):!1,E=w||T,D,O=w?C:n.onboardDir;if(E&&O)try{D=pe(O).mtime.toISOString()}catch{}return Q.info(`Onboard state detected`,{onboardComplete:E,onboardTimestamp:D,aiKbExists:w,onboardDirExists:T}),{embedder:u,store:d,stateStore:h,closeStateStore:l===c?void 0:async()=>l.close(),indexer:m,curated:y,graphStore:f,fileCache:new Ie,bridge:b,policyStore:x,evolutionCollector:S,onboardComplete:E,onboardTimestamp:D}}function
|
|
3021
|
-
`)}const
|
|
3022
|
-
`),`utf8`),$.info(`Auto-heal: created ESM shim for @huggingface/transformers (.mjs wrapper → .cjs)`,{path:t}))}catch(e){$.warn(`Auto-heal: failed to create ESM shim`,{error:e instanceof Error?e.message:String(e),path:t})}}}if(n.includes(`embedding`)||n.includes(`onnx`)||n.includes(`protobuf`)||n.includes(`model`)){let t=e.embedding?.model??Te.model,n=N(Ln(),`.cache`,`huggingface`,`transformers-js`,t);try{await r(n,{recursive:!0,force:!0}),$.info(`Auto-heal: cleared embedding model cache`,{path:n})}catch{}}if(n.includes(`lance`)||n.includes(`database`)||n.includes(`store`)){let t=N(e.store.path,`lance`);try{await r(t,{recursive:!0,force:!0}),$.info(`Auto-heal: cleared LanceDB store`,{path:t})}catch{}}if(n.includes(`sqlite`)||n.includes(`database disk image`)||n.includes(`graph`)){let t=N(e.store.path,`graph.db`);try{await r(t,{force:!0}),$.info(`Auto-heal: cleared graph database`,{path:t})}catch{}let n=N(e.store.path,`aikit.db`);try{await r(n,{force:!0}),await r(`${n}-wal`,{force:!0}).catch(()=>{}),await r(`${n}-shm`,{force:!0}).catch(()=>{}),$.info(`Auto-heal: cleared corrupted aikit database`,{path:n})}catch{}}n.includes(`cannot find module`)&&!n.includes(`huggingface`)&&!n.includes(`.cache`)&&$.warn(`Auto-heal: missing module detected during initialization cleanup`,{hint:`Run: npm cache clean --force && npx -y @vpxa/aikit serve`})}function
|
|
3020
|
+
└──────────────────────────────────────────────────────────────────┘`);let t=N(i,`lance`);A(t)&&Q.info(`Old LanceDB data found at ${t} — ignored. Safe to delete after verifying sqlite-vec works.`)}let l;if(c)if(s.splitEnabled&&s.controlDbPath!==s.contentDbPath){let{migrateToSplitState:e}=await import(`../../store/dist/index.js`);await e(s),l=await hr(s.controlDbPath),vr(l,mr),Q.info(`State store adapter ready`,{type:l.type,dbPath:s.controlDbPath,splitEnabled:!0})}else l=c;else{let e=N(i,`aikit-state.db`);A(i)||j(i,{recursive:!0}),l=await hr(e),vr(l,mr),Q.info(`State store adapter ready`,{type:l.type,dbPath:e})}let[u,d,f,p]=await Promise.all([(async()=>{if(n.embedding.childProcess!==!1){let e=new Mr({model:n.embedding.model,dimensions:n.embedding.dimensions,interOpNumThreads:n.embedding.interOpNumThreads,intraOpNumThreads:n.embedding.intraOpNumThreads,idleTimeoutMs:n.embedding.idleTimeoutMs});return await e.initialize(),Q.info(`Embedder loaded (child process)`,{modelId:e.modelId,dimensions:e.dimensions}),e}let{OnnxEmbedder:e}=await import(`../../embeddings/dist/index.js`),t=new e({model:n.embedding.model,dimensions:n.embedding.dimensions,interOpNumThreads:n.embedding.interOpNumThreads,intraOpNumThreads:n.embedding.intraOpNumThreads});return await t.initialize(),Q.info(`Embedder loaded (in-process)`,{modelId:t.modelId,dimensions:t.dimensions}),t})(),(async()=>{let e=await _r({backend:r,path:i,adapter:c??void 0,embeddingDim:n.embedding.dimensions,partition:r===`sqlite-vec`?s:void 0});return await e.initialize(),Q.info(`Store initialized`,{backend:r}),e})(),(async()=>{let e=c?new pr({adapter:c}):new pr({path:i});return await e.initialize(),Q.info(`Graph store initialized`,{shared:!!c}),e})(),(async()=>{let e=await rr();if(e){let e=tr.get();Q.info(`WASM tree-sitter enabled`,{grammars:e.grammarCount,dir:e.wasmDir})}else{let e=tr.get();Q.warn(`WASM tree-sitter not available; analyzers will use regex fallback`,{reason:e.reason,os:e.os,arch:e.arch,healAttempted:e.healAttempted,healSuccess:e.healSuccess,healError:e.healError,pathsChecked:e.pathsChecked.map(e=>`${e.path} (${e.exists?`found`:`missing`})`)})}return e})()]),m=new Pr(u,d),h=gr(l),g=new Nr(n.store.path);g.load(),m.setHashCache(g);let _=n.curated.path,v=new e(_);await v.initialize();let y=new t(_,d,u,v);m.setGraphStore(f);let b=Pc(n.er),x=b?new sr(n.curated.path):void 0;x&&Q.info(`Policy store initialized`,{ruleCount:x.getRules().length});let S=b?new or:void 0,C=P(n.sources[0]?.path??process.cwd(),Se.aiContext),w=A(C),T=n.onboardDir?A(n.onboardDir):!1,E=w||T,D,O=w?C:n.onboardDir;if(E&&O)try{D=pe(O).mtime.toISOString()}catch{}return Q.info(`Onboard state detected`,{onboardComplete:E,onboardTimestamp:D,aiKbExists:w,onboardDirExists:T}),{embedder:u,store:d,stateStore:h,closeStateStore:l===c?void 0:async()=>l.close(),indexer:m,curated:y,graphStore:f,fileCache:new Ie,bridge:b,policyStore:x,evolutionCollector:S,onboardComplete:E,onboardTimestamp:D}}function Ig(e,t,n){if(e.serverInstructions)return e.serverInstructions;let r=new Set;for(let e of t){let t=n[e];if(t?.category)for(let e of t.category)r.add(e)}let i=[`This server provides ${t.size} tools across ${r.size} categories: ${[...r].sort().join(`, `)}.`,`TOOL ROUTING:`,`- Understand a file -> file_summary (structure) or compact (extract section)`,`- Find code/symbols -> search (hybrid) or symbol (definition + refs)`,`- Validate changes -> check (typecheck+lint) or test_run (tests)`,`- Read file for editing -> read_file (only for exact lines before edits)`,`FORBIDDEN: DO NOT USE native equivalents when AI Kit provides same:`,`- grep/find -> search or find tool`,`- cat/read_file (for understanding) -> file_summary or compact`,`- terminal tsc/lint -> check tool`,`- terminal test -> test_run tool`];return e.readOnly&&i.push(`Server is in read-only mode. Mutating operations are disabled.`),e.features?.length&&i.push(`Active feature groups: ${e.features.join(`, `)}.`),i.join(`
|
|
3021
|
+
`)}const Lg=F(`background-task`);var Rg=class{queue=[];running=null;get isRunning(){return this.running!==null}get currentTask(){return this.running}get pendingCount(){return this.queue.length}schedule(e){return new Promise((t,n)=>{this.queue.push({...e,resolve:t,reject:n}),this.running||this.processQueue()})}async processQueue(){for(;this.queue.length>0;){let e=this.queue.shift();if(!e)break;this.running=e.name,Lg.info(`Background task started`,{task:e.name,pending:this.queue.length});let t=Date.now();try{await e.fn();let n=Date.now()-t;Lg.info(`Background task completed`,{task:e.name,durationMs:n}),e.resolve()}catch(n){let r=Date.now()-t;Lg.error(`Background task failed`,{task:e.name,durationMs:r,err:n}),e.reject(n instanceof Error?n:Error(String(n)))}}this.running=null}};const zg=F(`idle-timer`);var Bg=class{timer=null;cleanupFns=[];idleMs;disposed=!1;sessionActive=!1;_busy=!1;constructor(e){this.idleMs=e?.idleMs??3e5}setBusy(e){this._busy=e,e?this.cancel():this.touch()}onIdle(e){this.cleanupFns.push(e)}markSessionActive(){this.sessionActive=!0}touch(){this.disposed||this._busy||(this.cancel(),this.timer=setTimeout(()=>{this.runCleanup()},this.idleMs),this.timer.unref&&this.timer.unref())}cancel(){this.timer&&=(clearTimeout(this.timer),null)}dispose(){this.cancel(),this.cleanupFns.length=0,this.disposed=!0}async runCleanup(){if(!this.sessionActive){zg.info(`Idle timeout reached with no active session — skipping cleanup (waiting for first tool call)`);return}if(this._busy){zg.info(`Skipping idle cleanup — background work in progress`);return}zg.info(`Idle for ${this.idleMs/1e3}s — running cleanup`);let e=await Promise.allSettled(this.cleanupFns.map(e=>e()));for(let t of e)t.status===`rejected`&&zg.warn(`Idle cleanup callback failed`,{error:String(t.reason)})}};const Vg=F(`memory-monitor`);var Hg=class{timer=null;warningBytes;criticalBytes;intervalMs;pressureFns=[];memoryPressureFns=[];lastLevel=`normal`;constructor(e){this.warningBytes=e?.warningBytes??4294967296,this.criticalBytes=e?.criticalBytes??8589934592,this.intervalMs=e?.intervalMs??6e4}onPressure(e){this.pressureFns.push(e)}registerMemoryPressureCallback(e){this.memoryPressureFns.push(e)}start(){this.timer||(this.timer=setInterval(()=>this.check(),this.intervalMs),this.timer.unref&&this.timer.unref(),Vg.info(`Memory monitor started`,{warningMB:Math.round(this.warningBytes/1024/1024),criticalMB:Math.round(this.criticalBytes/1024/1024),intervalSec:Math.round(this.intervalMs/1e3)}))}stop(){this.timer&&=(clearInterval(this.timer),null)}getRssBytes(){return process.memoryUsage.rss()}check(){let e=this.getRssBytes(),t=`normal`;if(e>=this.criticalBytes?t=`critical`:e>=this.warningBytes&&(t=`warning`),t!==this.lastLevel||t===`critical`){let n=Math.round(e/1024/1024);t===`critical`?Vg.warn(`Memory CRITICAL: ${n}MB RSS — consider restarting the server`):t===`warning`?Vg.warn(`Memory WARNING: ${n}MB RSS`):this.lastLevel!==`normal`&&Vg.info(`Memory returned to normal: ${n}MB RSS`),this.lastLevel=t}if(t!==`normal`)for(let n of this.pressureFns)try{n(t,e)}catch{}if(t===`critical`)for(let e of this.memoryPressureFns)try{let t=e();t&&typeof t.catch==`function`&&t.catch(()=>{})}catch{}return t===`critical`&&typeof globalThis.gc==`function`&&globalThis.gc(),t}};const Ug=F(`tool-timeout`),Wg=new Set([`onboard`,`reindex`,`produce_knowledge`,`analyze`,`codemod`,`audit`]);var Gg=class extends Error{toolName;timeoutMs;constructor(e,t){super(`Tool "${e}" timed out after ${t}ms`),this.toolName=e,this.timeoutMs=t,this.name=`ToolTimeoutError`}};function Kg(e){return Wg.has(e)?6e5:12e4}function qg(e,t,n){return new Promise((r,i)=>{let a=!1,o=setTimeout(()=>{if(!a){a=!0;let e=new Gg(n,t);Ug.warn(e.message),i(e)}},t);o.unref&&o.unref(),e().then(e=>{a||(a=!0,clearTimeout(o),r(e))},e=>{a||(a=!0,clearTimeout(o),i(e))})})}const $=F(`server`),Jg=new Set([`status`,`list_tools`,`describe_tool`,`config`,`env`]);function Yg(e,t=28){let n=e.replace(/\s+/g,` `).trim();return n.length<=t?n:`${n.slice(0,t-3)}...`}function Xg(e){let t=[`query`,`path`,`task`,`name`,`start`,`symbol`,`file`,`pattern`],n=[];for(let r of t){let t=e[r];typeof t==`string`&&t.length>0&&t.length<200&&n.push(t)}return n.join(` `).slice(0,200)}async function Zg(e,t,n){let r=[];try{t.statePath&&ct(e.stateStore,{stateDir:t.statePath});let i=e.stateStore.stashList().map(e=>e.key);if(i.length>0){let e=n.toLowerCase().split(/\s+/).filter(e=>e.length>2);if(e.length===0)r.push(`stash: ${i.length} entries available`);else{let t=i.filter(t=>e.some(e=>t.toLowerCase().includes(e))).slice(0,3);t.length>0?r.push(`stash: ${t.map(e=>`"${Yg(e)}"`).join(`, `)}${i.length>t.length?` (${i.length} total)`:``}`):r.push(`stash: ${i.length} entries available`)}}}catch{}try{if(n){let t=await Promise.race([e.store.ftsSearch(n,{limit:3}),new Promise(e=>setTimeout(()=>e(null),50))]);if(Array.isArray(t)&&t.length>0){let e=t.filter(e=>e&&typeof e==`object`&&`record`in e&&(e.record.origin===`produced`||e.record.origin===`curated`));if(e.length>0){let t=e.slice(0,2).map(e=>{let t=e.record;return`"${Yg(t.headingPath||t.sourcePath||`knowledge`)}"`});r.push(`knowledge: ${t.join(`, `)}`)}}}}catch{}return r.length===0?null:`\n---\nContext available: ${r.join(` | `)}\nPull with: stash({action:'get', key:'...'}) or search({query:'...', origin:'produced'})\n---`}function Qg(e,t,n){let r=3;for(let[i,a]of Object.entries(e)){let e=a.handler;a.handler=async(...a)=>{let o=await e(...a);if(!o||typeof o!=`object`||r<=0||o.isError||Jg.has(i))return o;try{r--;let e=a[0],i=await Zg(t,n,Xg(e&&typeof e==`object`?e:{}));i&&(o.content=Array.isArray(o.content)?o.content:[],o.content.push({type:`text`,text:i}))}catch{}return o}}}function $g(e){let t=e.toLowerCase();return[`protobuf`,`invalid model`,`invalid onnx`,`unexpected end`,`unexpected token`,`failed to load`,`failed to initialize embedding`,`checksum`,`corrupt`,`malformed`,`could not load`,`onnx`,`database disk image is malformed`,`file is not a database`,`lance`,`cannot find module`,`module not found`].some(e=>t.includes(e))}async function e_(e,t){let n=t.toLowerCase(),r;try{({rm:r}=await import(`node:fs/promises`))}catch{return}if(n.includes(`transformers.node.mjs`)&&n.includes(`cannot find module`)){let e=t.match(/Cannot find module '([^']+transformers\.node\.mjs)'/);if(e){let t=e[1],n=t.replace(/\.mjs$/,`.cjs`);try{let{existsSync:e,writeFileSync:r}=await import(`node:fs`);e(n)&&!e(t)&&(r(t,[`// Auto-generated ESM shim — published package missing this file`,`import { createRequire } from 'node:module';`,`const require = createRequire(import.meta.url);`,`const mod = require('./transformers.node.cjs');`,`export default mod;`,``].join(`
|
|
3022
|
+
`),`utf8`),$.info(`Auto-heal: created ESM shim for @huggingface/transformers (.mjs wrapper → .cjs)`,{path:t}))}catch(e){$.warn(`Auto-heal: failed to create ESM shim`,{error:e instanceof Error?e.message:String(e),path:t})}}}if(n.includes(`embedding`)||n.includes(`onnx`)||n.includes(`protobuf`)||n.includes(`model`)){let t=e.embedding?.model??Te.model,n=N(Ln(),`.cache`,`huggingface`,`transformers-js`,t);try{await r(n,{recursive:!0,force:!0}),$.info(`Auto-heal: cleared embedding model cache`,{path:n})}catch{}}if(n.includes(`lance`)||n.includes(`database`)||n.includes(`store`)){let t=N(e.store.path,`lance`);try{await r(t,{recursive:!0,force:!0}),$.info(`Auto-heal: cleared LanceDB store`,{path:t})}catch{}}if(n.includes(`sqlite`)||n.includes(`database disk image`)||n.includes(`graph`)){let t=N(e.store.path,`graph.db`);try{await r(t,{force:!0}),$.info(`Auto-heal: cleared graph database`,{path:t})}catch{}let n=N(e.store.path,`aikit.db`);try{await r(n,{force:!0}),await r(`${n}-wal`,{force:!0}).catch(()=>{}),await r(`${n}-shm`,{force:!0}).catch(()=>{}),$.info(`Auto-heal: cleared corrupted aikit database`,{path:n})}catch{}}n.includes(`cannot find module`)&&!n.includes(`huggingface`)&&!n.includes(`.cache`)&&$.warn(`Auto-heal: missing module detected during initialization cleanup`,{hint:`Run: npm cache clean --force && npx -y @vpxa/aikit@latest serve`})}function t_(e,t){let n=hs(e,Bo,Yo,Io(e)),r=Ig(e,n,Yo),i=new zn({name:e.serverName??`aikit`,version:ie()},{capabilities:{logging:{},completions:{},prompts:{}},instructions:r}),a=`initializing`,o=``,s=!1,c=null,l=null,u=null;function d(e){if(!e||typeof e!=`object`)return[];let t=e,n=[];for(let e of[`path`,`file`,`source_path`,`sourcePath`,`filePath`]){let r=t[e];typeof r==`string`&&r&&n.push(r)}for(let e of[`changed_files`,`paths`,`files`]){let r=t[e];if(Array.isArray(r))for(let e of r){if(typeof e==`string`){n.push(e);continue}e&&typeof e==`object`&&typeof e.path==`string`&&n.push(e.path)}}if(Array.isArray(t.sources))for(let e of t.sources)e&&typeof e==`object`&&typeof e.path==`string`&&n.push(e.path);return n}let f=()=>a===`failed`?[`❌ AI Kit initialization failed — this tool is unavailable.`,``,o?`Error: ${o}`:``,``,`**${zo.size} tools are still available** and fully functional:`,`check, eval, test_run, git_context, health, measure, web_fetch, web_search,`,`flow, regex_test, encode,`,`stash, checkpoint, lane, process, time, env, and more.`,``,`To fix embedding errors, try deleting the cached model:`,` rm -rf ~/.cache/huggingface/transformers-js/mixedbread-ai/`,`Then restart the server to re-download a fresh copy.`,``,`Try restarting the MCP server to retry initialization.`].filter(Boolean).join(`
|
|
3023
3023
|
`):[`AI Kit is still initializing (loading embeddings model & store).`,``,`**${zo.size} tools are already available** while initialization completes — including:`,`check, eval, test_run, git_context, health, measure, web_fetch, web_search,`,`flow, regex_test, encode,`,`stash, checkpoint, lane, process, time, env, and more.`,``,`This tool requires the AI Kit index. Please retry in a few seconds,`,`or use one of the available tools above in the meantime.`].join(`
|
|
3024
|
-
`);Lr(i);let p=new co;p.use(Ho(),{order:1,name:`structured-content-guard`}),es(i,p,e.toolPrefix??``);let m=i.sendToolListChanged.bind(i);i.sendToolListChanged=()=>{};let h=[];for(let e of Bo){if(!n.has(e))continue;let t=U(e),r=i.registerTool(e,{title:t.title,description:`${t.title} — initializing, available shortly`,inputSchema:{},annotations:t.annotations},async()=>({content:[{type:`text`,text:f()}]}));zo.has(e)?r.remove():h.push(r)}
|
|
3024
|
+
`);Lr(i);let p=new co;p.use(Ho(),{order:1,name:`structured-content-guard`}),es(i,p,e.toolPrefix??``);let m=i.sendToolListChanged.bind(i);i.sendToolListChanged=()=>{};let h=[];for(let e of Bo){if(!n.has(e))continue;let t=U(e),r=i.registerTool(e,{title:t.title,description:`${t.title} — initializing, available shortly`,inputSchema:{},annotations:t.annotations},async()=>({content:[{type:`text`,text:f()}]}));zo.has(e)?r.remove():h.push(r)}jg(i,e,n),i.sendToolListChanged=m;let g=i.registerResource(`aikit-status`,`aikit://status`,{description:`AI Kit status (initializing...)`,mimeType:`text/plain`},async()=>({contents:[{uri:`aikit://status`,text:`AI Kit is initializing...`,mimeType:`text/plain`}]})),_=i.registerPrompt(`_init`,{description:`Initializing AI Kit…`,argsSchema:{_dummy:Wn(R.string(),()=>[])}},async()=>({messages:[]})),v,y,b=new Promise((e,t)=>{v=e,y=t}),x,S=new Promise(e=>{x=e}),C=()=>x?.(),w=(async()=>{await S;try{let{createRequire:e}=await import(`node:module`),{readFileSync:t,existsSync:n}=await import(`node:fs`),{fileURLToPath:r}=await import(`node:url`),{resolve:i,dirname:a}=await import(`node:path`),o=e(import.meta.url),s=a(r(import.meta.url)),c=i(s,`..`,`package.json`),l=i(s,`..`,`..`),u=JSON.parse(t(c,`utf8`)),d=Object.keys(u.dependencies??{}),f=[`@mixmark-io/domino`],p=[...d,...f.filter(e=>!d.includes(e))],m=p.filter(e=>!e.startsWith(`@aikit/`)),h=p.filter(e=>e.startsWith(`@aikit/`)),g=[];for(let e of m)try{o.resolve(e)}catch{try{o.resolve(`${e}/package.json`)}catch{g.push(e)}}g.length>0&&$.warn(`Dependencies not resolvable — server may operate in degraded mode`,{missing:g,hint:`Run: npm cache clean --force && npx -y @vpxa/aikit@latest serve`});let _=[];if(h.length>0){for(let e of h)n(i(l,e.slice(7),`dist`))||_.push(e);_.length>0&&$.warn(`Workspace sibling packages missing dist — server may have degraded features`,{missing:_,hint:`Reinstall: npm cache clean --force && npx -y @vpxa/aikit@latest serve`})}}catch{}let n;try{n=await Fg(e)}catch(t){let r=t instanceof Error?t.message:String(t);if($g(r)){$.warn(`AI Kit initialization failed with recoverable error — attempting auto-heal retry`,{error:r}),await e_(e,r);try{n=await Fg(e),$.info(`AI Kit auto-heal successful — initialization recovered after retry`)}catch(e){a=`failed`,o=e instanceof Error?e.message:String(e),$.error(`AI Kit initialization failed after auto-heal attempt — server continuing with zero-dep tools only`,{error:o,originalError:r}),y?.(e instanceof Error?e:Error(o));return}}else{a=`failed`,o=r,$.error(`AI Kit initialization failed — server continuing with zero-dep tools only`,{error:o}),y?.(t instanceof Error?t:Error(o));return}}let r=i.sendToolListChanged.bind(i);i.sendToolListChanged=()=>{};let f=i.sendPromptListChanged.bind(i);i.sendPromptListChanged=()=>{};let p=i.sendResourceListChanged.bind(i);i.sendResourceListChanged=()=>{};for(let e of h)e.remove();g.remove(),_.remove();let m=i._registeredTools??{};for(let e of zo)m[e]?.remove();let b=new Ng(i),x=Vl(i);Ag(i,n,e,Fr(i),b,x,t,t===`smart`?(()=>{let e=u;return e?.getState?e.getState():null}):null,t===`smart`?()=>{let e=u;return e?{prioritize:e.prioritize.bind(e)}:null}:null),Jr(i,{curated:n.curated,store:n.store,graphStore:n.graphStore,stateStore:n.stateStore},t),i.sendToolListChanged=r,i.sendPromptListChanged=f,i.sendResourceListChanged=p,Promise.resolve(i.sendToolListChanged()).catch(()=>{}),Promise.resolve(i.sendPromptListChanged()).catch(()=>{}),Promise.resolve(i.sendResourceListChanged()).catch(()=>{});let C=i._registeredTools??{};for(let[e,t]of Object.entries(C)){if(Lo.has(e))continue;let r=t.handler;t.handler=async(...i)=>{if(!n.indexer.isIndexing)return r(...i);let a=s?`re-indexing`:`running initial index`,o=new Promise(n=>setTimeout(()=>n({content:[{type:`text`,text:`⏳ AI Kit is ${a}. The tool "${e}" timed out waiting for index data (${Ro/1e3}s).\n\nThe existing index may be temporarily locked. Please retry shortly — indexing will complete automatically.`}],...t.config?.outputSchema?{structuredContent:Jo(t.config.outputSchema)}:{}}),Ro));return Promise.race([r(...i),o])}}for(let[e,t]of Object.entries(C)){let n=t.handler,r=Kg(e);t.handler=async(...i)=>{try{return await qg(()=>n(...i),r,e)}catch(n){if(n instanceof Gg)return{content:[{type:`text`,text:`⏳ Tool "${e}" timed out after ${r/1e3}s. This may indicate a long-running operation. Please retry or break the task into smaller steps.`}],...t.config?.outputSchema?{structuredContent:Jo(t.config.outputSchema)}:{}};throw n}}}let w=Object.keys(C).length;w<Bo.length&&$.warn(`ALL_TOOL_NAMES count mismatch`,{expectedToolCount:Bo.length,registeredToolCount:w}),$.info(`MCP server configured`,{toolCount:Bo.length,resourceCount:4});let T=new Hg;T.onPressure((e,t)=>{e===`warning`&&Vr(),e===`critical`&&($.warn(`Memory pressure critical — consider restarting`,{rssMB:Math.round(t/1024/1024)}),Vr())}),T.registerMemoryPressureCallback(()=>n.embedder.shutdown?.()),T.start();let D=new Bg;l=D,D.onIdle(async()=>{if(E.isRunning||n.indexer.isIndexing){$.info(`Idle cleanup deferred — background tasks still running`),D.touch();return}$.info(`Idle cleanup: releasing cached memory (connections stay open)`);try{n.store.releaseMemory?.(),n.graphStore.releaseMemory?.()}catch{}}),D.touch();let O=!1;for(let e of Object.values(C)){let t=e.handler;e.handler=async(...e)=>{if(O||(O=!0,D.markSessionActive()),D.touch(),u){let t=d(e[0]);t.length>0&&u.prioritize(...t)}return t(...e)}}Qg(C,n,{statePath:e.stateDir??``});for(let[,e]of Object.entries(C)){let t=e.config?.outputSchema;if(!t)continue;let n=e.handler;e.handler=async(...e)=>{let r=await n(...e);if(!r||typeof r!=`object`)return r;let i=r;return!(`content`in i)||i.isError||i.structuredContent!=null&&typeof i.structuredContent==`object`?r:(i.structuredContent=Jo(t),i.structuredContent??={},r)}}process.stdin.on(`end`,()=>($.info(`stdin closed — MCP client disconnected. Shutting down.`),process.exit(0))),process.stdin.on(`error`,()=>($.info(`stdin error — MCP client disconnected. Shutting down.`),process.exit(0))),c=n,v?.(n)})(),T=async()=>{let t;try{t=await b}catch{$.warn(`Skipping initial index — AI Kit initialization failed`);return}l?.setBusy(!0);try{let n=e.sources.map(e=>e.path).join(`, `);$.info(`Running initial index`,{sourcePaths:n});let r=await t.indexer.index(e,e=>{e.phase===`crawling`||e.phase===`done`||(e.phase===`chunking`&&e.currentFile&&$.debug(`Indexing file`,{current:e.filesProcessed+1,total:e.filesTotal,file:e.currentFile}),e.phase===`cleanup`&&$.debug(`Index cleanup`,{staleEntries:e.filesTotal-e.filesProcessed}))});s=!0,$.info(`Initial index complete`,{filesProcessed:r.filesProcessed,filesSkipped:r.filesSkipped,chunksCreated:r.chunksCreated,durationMs:r.durationMs});try{await t.store.createFtsIndex()}catch(e){$.warn(`FTS index creation failed`,I(e))}try{let e=await t.curated.reindexAll();$.info(`Curated re-index complete`,{indexed:e.indexed})}catch(e){$.error(`Curated re-index failed`,I(e))}}catch(e){$.error(`Initial index failed; will retry on aikit_reindex`,I(e))}finally{l?.setBusy(!1)}},E=new Rg,D=()=>E.schedule({name:`initial-index`,fn:T}),O=process.ppid,ee=setInterval(()=>{try{process.kill(O,0)}catch{$.info(`Parent process died; shutting down`,{parentPid:O}),clearInterval(ee),u?.stop&&u.stop(),import(`../../tools/dist/index.js`).then(({processStopAll:e})=>e()).catch(()=>{}),b.then(async e=>{await Promise.all([e.embedder.shutdown?.().catch(()=>{})??Promise.resolve(),e.graphStore.close().catch(()=>{}),e.closeStateStore?.().catch(()=>{})??Promise.resolve(),e.store.close().catch(()=>{})])}).catch(()=>{}).finally(()=>process.exit(0))}},5e3);return ee.unref(),{server:i,startInit:C,ready:w,runInitialIndex:D,get aikit(){return c},scheduler:E,setSmartScheduler(e){u=e}}}const n_=F(`server`);function r_(e,t){let n=hs(t,[...Bo,...Po],Yo,Io(t)),r=Ig(t,n,Yo),i=new zn({name:t.serverName??`aikit`,version:ie()},{capabilities:{logging:{},completions:{},prompts:{}},instructions:r});return Lr(i),Ag(i,e,t,Fr(i),new Ng(i),Vl(i),void 0,null,null,n),Jr(i,{curated:e.curated,store:e.store,graphStore:e.graphStore,stateStore:e.stateStore},t.indexMode),i}async function i_(e){let t=await Fg(e),n=r_(t,e);n_.info(`MCP server configured`,{toolCount:Bo.length,resourceCount:2});let r=async()=>{try{let n=e.sources.map(e=>e.path).join(`, `);n_.info(`Running initial index`,{sourcePaths:n});let r=await t.indexer.index(e,e=>{e.phase===`crawling`||e.phase===`done`||(e.phase===`chunking`&&e.currentFile&&n_.debug(`Indexing file`,{current:e.filesProcessed+1,total:e.filesTotal,file:e.currentFile}),e.phase===`cleanup`&&n_.debug(`Index cleanup`,{staleEntries:e.filesTotal-e.filesProcessed}))});n_.info(`Initial index complete`,{filesProcessed:r.filesProcessed,filesSkipped:r.filesSkipped,chunksCreated:r.chunksCreated,durationMs:r.durationMs});try{await t.store.createFtsIndex()}catch(e){n_.warn(`FTS index creation failed`,I(e))}try{let e=await t.curated.reindexAll();n_.info(`Curated re-index complete`,{indexed:e.indexed})}catch(e){n_.error(`Curated re-index failed`,I(e))}}catch(e){n_.error(`Initial index failed; will retry on aikit_reindex`,I(e))}},i=async()=>{n_.info(`Shutting down`),await Promise.all([t.embedder.shutdown?.().catch(()=>{})??Promise.resolve(),t.graphStore.close().catch(()=>{}),t.closeStateStore?.().catch(()=>{})??Promise.resolve(),t.store.close().catch(()=>{})]),process.exit(0)};process.on(`SIGINT`,i),process.on(`SIGTERM`,i);let a=process.ppid,o=setInterval(()=>{try{process.kill(a,0)}catch{n_.info(`Parent process died; shutting down`,{parentPid:a}),clearInterval(o),i()}},5e3);return o.unref(),{server:n,runInitialIndex:r,shutdown:i}}export{Bo as ALL_TOOL_NAMES,t_ as createLazyServer,r_ as createMcpServer,i_ as createServer,Fg as initializeAikit,Ag as registerMcpTools};
|