@vpxa/aikit 0.1.139 → 0.1.141
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/embeddings/dist/embedder-worker.js +1 -1
- package/packages/embeddings/dist/index.d.ts +1 -0
- package/packages/embeddings/dist/index.js +1 -1
- package/packages/flows/dist/index.js +6 -6
- package/packages/indexer/dist/index.js +1 -1
- package/packages/server/dist/index.js +1 -1
- package/packages/server/dist/{server-Ceit0yIx.js → server-DmbZccrE.js} +118 -118
- package/packages/store/dist/index.js +2 -2
- package/packages/store/dist/lance-store-DZkqHpPW.js +1 -0
- package/packages/store/dist/{sqlite-vec-store-Dfo9BAg8.js → sqlite-vec-store-C-GvCcJH.js} +2 -2
- package/packages/tools/dist/index.d.ts +3 -1
- package/packages/tools/dist/index.js +73 -71
- package/scaffold/generated/block-docs.mjs +1 -1
- package/packages/store/dist/lance-store-D1JolXlO.js +0 -1
|
@@ -130,23 +130,23 @@ Changed values:
|
|
|
130
130
|
${o.length>0?o.join(`
|
|
131
131
|
`):`- No effective changes; requested values already matched the file.`}
|
|
132
132
|
|
|
133
|
-
These changes take effect on the next server restart.`;return Io(e,`Configuration`,No(n)),{content:[{type:`text`,text:s}],ui:{type:`resource`,uri:bo}}}catch(e){return yo.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)}`}]}}})}const Ro=k(`cross-workspace`);function zo(e,t){if(!ie())return[];let n=A();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 Bo(e){let t=new Map;for(let n of e)try{let e=await Nn({backend:`sqlite-vec`,path:re(n.partition)});await e.initialize(),t.set(n.partition,e)}catch(e){Ro.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 Vo(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 Ro.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 Ho(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 Ro.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 Uo(e,t,n){if(_(e))return o(e)
|
|
134
|
-
`);if(d&&a){let e=await H(a,{query:s,filePath:f});m+=U(e)}return{content:[{type:`text`,text:m}],structuredContent:{originalChars:p.originalChars,compressedChars:p.compressedChars,ratio:p.ratio,segmentsKept:p.segmentsKept,segmentsTotal:p.segmentsTotal}}}catch(e){return
|
|
135
|
-
`)+"\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 H(r,{query:e});l+=U(t)}return{content:[{type:`text`,text:o?Gt(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
|
|
133
|
+
These changes take effect on the next server restart.`;return Io(e,`Configuration`,No(n)),{content:[{type:`text`,text:s}],ui:{type:`resource`,uri:bo}}}catch(e){return yo.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)}`}]}}})}const Ro=k(`cross-workspace`);function zo(e,t){if(!ie())return[];let n=A();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 Bo(e){let t=new Map;for(let n of e)try{let e=await Nn({backend:`sqlite-vec`,path:re(n.partition)});await e.initialize(),t.set(n.partition,e)}catch(e){Ro.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 Vo(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 Ro.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 Ho(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 Ro.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 Uo(e){return e.toLowerCase().replace(/[-_]/g,``)}function Wo(e){let t=g(e),n=Uo(h(e));try{let e=l(t);for(let r of e)if(Uo(r)===n){let e=b(t,r);if(o(e))return e}}catch{}}function Go(e,t,n){if(_(e))return o(e)?e:Wo(e)||e;let r=b(t,e);if(o(r))return r;let i=Wo(r);if(i)return i;if(n)for(let r of n){if(r===t)continue;let n=b(r,e);if(o(n))return n;let i=Wo(n);if(i)return i}try{let n=l(t,{withFileTypes:!0});for(let r of n){if(!r.isDirectory()||r.name.startsWith(`.`)||r.name===`node_modules`)continue;let n=b(t,r.name,e);if(o(n))return n;let i=Wo(n);if(i)return i}}catch{}return r}const Ko=k(`tools:context`);function qo(e,t,n,r,i,a){let o=V(`compact`);e.registerTool(`compact`,{title:o.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:ba,inputSchema:{text:N.string().optional().describe(`The text to compress (provide this OR path, not both)`),path:N.string().optional().describe(`File path to read server-side — avoids read_file round-trip + token doubling (provide this OR text)`),query:N.string().describe(`Focus query — what are you trying to understand?`),max_chars:N.number().min(100).max(5e4).default(3e3).describe(`Target output size in characters`),segmentation:N.enum([`paragraph`,`sentence`,`line`]).default(`paragraph`).describe(`How to split the text for scoring`),token_budget:N.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:N.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},async({text:e,path:o,query:s,max_chars:c,segmentation:l,token_budget:u,enrich:d})=>{try{let f=o?Go(o,r,i):void 0;if(!e&&!f)return W(`VALIDATION`,`Either "text" or "path" must be provided.`);let p=await xe(t,{text:e,path:f,query:s,maxChars:c,tokenBudget:u,segmentation:l,cache:n}),m=[`Compressed ${p.originalChars} → ${p.compressedChars} chars (${(p.ratio*100).toFixed(0)}%)`,`Kept ${p.segmentsKept}/${p.segmentsTotal} segments`,``,p.text].join(`
|
|
134
|
+
`);if(d&&a){let e=await H(a,{query:s,filePath:f});m+=U(e)}return{content:[{type:`text`,text:m}],structuredContent:{originalChars:p.originalChars,compressedChars:p.compressedChars,ratio:p.ratio,segmentsKept:p.segmentsKept,segmentsTotal:p.segmentsTotal}}}catch(e){return Ko.error(`Compact failed`,j(e)),W(`INTERNAL`,`Compact failed: ${e instanceof Error?e.message:String(e)}`)}})}function Jo(e,t,n,r){let i=V(`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:la,inputSchema:{task:N.string().describe(`Description of the task to scope`),max_files:N.number().min(1).max(50).default(15).describe(`Maximum files to include`),content_type:N.enum(w).optional().describe(`Filter by content type`),max_tokens:N.number().min(100).max(5e4).optional().describe(`Maximum token budget for the response. When set, output is truncated to fit.`),enrich:N.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},async({task:e,max_files:i,content_type:a,max_tokens:o,enrich:s})=>{try{let c=await jt(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(`
|
|
135
|
+
`)+"\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 H(r,{query:e});l+=U(t)}return{content:[{type:`text`,text:o?Gt(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 Ko.error(`Scope map failed`,j(e)),W(`INTERNAL`,`Scope map failed: ${e instanceof Error?e.message:String(e)}`)}})}function Yo(e,t,n,r,i){let a=V(`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:sa,inputSchema:{query:N.string().optional().describe(`Semantic/keyword search query (required for mode "examples")`),glob:N.string().optional().describe(`File glob pattern (search mode only)`),pattern:N.string().optional().describe(`Regex pattern to match in content (search mode only)`),limit:N.number().min(1).max(50).default(10).describe(`Max results`),content_type:N.enum(w).optional().describe(`Filter by content type`),mode:N.enum([`search`,`examples`]).default(`search`).describe(`Mode: "search" (default) for federated search, "examples" to find usage examples of a symbol/pattern`),max_tokens:N.number().min(100).max(5e4).optional().describe(`Maximum token budget for the response. When set, output is truncated to fit.`),workspaces:N.array(N.string()).optional().describe(`Cross-workspace search: partition names or folder basenames to include. Use ["*"] for all. User-level mode only.`),enrich:N.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},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 W(`VALIDATION`,`"query" is required for mode "examples".`);let r=await Le(t,n,{query:e,limit:s,contentType:c}),a=JSON.stringify(r);if(f&&i){let t=await H(i,{query:e});a+=U(t)}return{content:[{type:`text`,text:u?Gt(a,u):a}]}}let p=await Fe(t,n,{query:e,glob:a,pattern:o,limit:s,contentType:c,cwd:r}),m=``;if(d&&d.length>0&&e){let n=zo(d,te(process.cwd()));if(n.length>0){let{stores:r,closeAll:i}=await Bo(n);try{let i=await Vo(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?`
|
|
136
136
|
No search strategies were activated. Provide at least one of: query, glob, or pattern.`:``}`;if(f&&i){let n=await H(i,{query:e});t+=U(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(`
|
|
137
|
-
`);if(f&&i){let t=await H(i,{query:e,filePath:p.results[0]?.path});h+=U(t)}return{content:[{type:`text`,text:u?Gt(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
|
|
138
|
-
`)}],structuredContent:{start:o.start,direction:o.direction,depth:o.depth,nodes:o.nodes,graphContext:o.graphContext??null}}}catch(e){return
|
|
139
|
-
`);if(s&&a){let t=await H(a,{query:`dead symbols ${e??c??``}`});d+=U(t)}return{content:[{type:`text`,text:d}],structuredContent:{symbols:[...l.deadInSource,...l.deadInDocs].map(e=>({name:e.name,path:e.path,...e.line===void 0?{}:{line:e.line},kind:e.kind})),totalDead:l.totalDeadSource+l.totalDeadDocs}}}catch(e){return
|
|
140
|
-
`)}function
|
|
141
|
-
`)}function
|
|
137
|
+
`);if(f&&i){let t=await H(i,{query:e,filePath:p.results[0]?.path});h+=U(t)}return{content:[{type:`text`,text:u?Gt(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 Ko.error(`Find failed`,j(e)),W(`INTERNAL`,`Find failed: ${e instanceof Error?e.message:String(e)}`)}})}function Xo(e,t,n,r){let i=V(`symbol`);e.registerTool(`symbol`,{title:i.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:N.string().describe(`Symbol name to look up (function, class, type, etc.)`),limit:N.number().min(1).max(50).default(20).describe(`Max results per category`),workspaces:N.array(N.string()).optional().describe(`Cross-workspace search: partition names or folder basenames to include. Use ["*"] for all. User-level mode only.`)},outputSchema:ra,annotations:i.annotations},async({name:e,limit:i,workspaces:a})=>{try{let o=await Vt(t,n,{name:e,limit:i,graphStore:r});if(a&&a.length>0){let n=zo(a,te(process.cwd()));if(n.length>0){let{stores:r,closeAll:a}=await Bo(n);try{for(let[n,a]of r){let r=await Vt(t,a,{name:e,limit:i});r.definedIn&&!o.definedIn&&(o.definedIn={...r.definedIn,path:`[${n}] ${r.definedIn.path}`});for(let e of r.referencedIn)o.referencedIn.push({...e,path:`[${n}] ${e.path}`});if(r.importedBy){o.importedBy=o.importedBy??[];for(let e of r.importedBy)o.importedBy.push({...e,path:`[${n}] ${e.path}`})}}}finally{await a()}}}let s={name:o.name,definedIn:o.definedIn??null,importedBy:o.importedBy??[],referencedIn:o.referencedIn??[],graphContext:o.graphContext??null};return{content:[{type:`text`,text:es(o)}],structuredContent:s}}catch(e){return Ko.error(`Symbol lookup failed`,j(e)),W(`INTERNAL`,`Symbol lookup failed: ${e instanceof Error?e.message:String(e)}`)}})}function Zo(e,t,n,r,i){let a=new _n,o=V(`file_summary`);e.registerTool(`file_summary`,{title:o.title,description:`Create a concise structural summary of a source file: imports, exports, functions, classes, interfaces, and types.`,outputSchema:va,inputSchema:{path:N.string().describe(`Absolute path to the file to summarize`),max_tokens:N.number().min(100).max(5e4).optional().describe(`Maximum token budget for the response.`),enrich:N.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},async({path:e,max_tokens:o,enrich:s})=>{try{let c=Go(e,n,r);if((await tn(c)).isDirectory()){let t=await a.analyze(c,{format:`markdown`,maxDepth:3,maxTokens:o}),n=t.data.stats?.languages??{},r=Object.entries(n).sort((e,t)=>t[1]-e[1])[0]?.[0],l=`📁 **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(s&&i){let t=await H(i,{query:e,filePath:c});l+=U(t)}return{content:[{type:`text`,text:o?Gt(l,o):l}],structuredContent:{path:c,language:r??`directory`,lines:0,imports:0,exports:0,functions:0,classes:0}}}let l=await Pe({path:c,content:(await t.get(c)).content}),u=ts(l);if(s&&i){let t=await H(i,{query:e,filePath:c});u+=U(t)}return{content:[{type:`text`,text:u}],structuredContent:{path:l.path,language:l.language,lines:l.lines,imports:l.imports?.length??0,exports:l.exports?.length??0,functions:l.functions?.length??0,classes:l.classes?.length??0}}}catch(e){return Ko.error(`File summary failed`,j(e)),W(`INTERNAL`,`File summary failed: ${e instanceof Error?e.message:String(e)}`)}})}function Qo(e,t,n,r){let i=V(`trace`);e.registerTool(`trace`,{title:i.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:N.string().describe(`Starting point — symbol name or file:line reference`),direction:N.enum([`forward`,`backward`,`both`]).describe(`Which direction to trace relationships`),max_depth:N.number().min(1).max(10).default(3).optional().describe(`Maximum trace depth`)},annotations:i.annotations},async({start:e,direction:i,max_depth:a})=>{try{let o=await Wt(t,n,{start:e,direction:i,maxDepth:a,graphStore:r}),s=[`## Trace: ${o.start}`,`Direction: ${o.direction} | Depth: ${o.depth}`,``];if(o.graphContext&&(s.push(`### Graph Context`),o.graphContext.definingModule&&s.push(`- Module: ${o.graphContext.definingModule}`),o.graphContext.community&&s.push(`- Community: ${o.graphContext.community}`),o.graphContext.importedByModules.length>0&&s.push(`- Imported by modules: ${o.graphContext.importedByModules.join(`, `)}`),o.graphContext.siblingSymbols.length>0&&s.push(`- Sibling symbols: ${o.graphContext.siblingSymbols.join(`, `)}`),s.push(``)),o.nodes.length===0)s.push(`No connections found.`);else{let e=o.nodes.filter(e=>e.relationship===`calls`),t=o.nodes.filter(e=>e.relationship===`called-by`),n=o.nodes.filter(e=>e.relationship===`imports`),r=o.nodes.filter(e=>e.relationship===`imported-by`),i=o.nodes.filter(e=>e.relationship===`references`);if(e.length>0){s.push(`### Calls (${e.length})`);for(let t of e){let e=t.scope?` (from ${t.scope}())`:``;s.push(`- ${t.symbol}() — ${t.path}:${t.line}${e}`)}s.push(``)}if(t.length>0){s.push(`### Called by (${t.length})`);for(let e of t){let t=e.scope?` in ${e.scope}()`:``;s.push(`- ${e.symbol}()${t} — ${e.path}:${e.line}`)}s.push(``)}if(n.length>0){s.push(`### Imports (${n.length})`);for(let e of n)s.push(`- ${e.symbol} — ${e.path}:${e.line}`);s.push(``)}if(r.length>0){s.push(`### Imported by (${r.length})`);for(let e of r)s.push(`- ${e.path}:${e.line}`);s.push(``)}if(i.length>0){s.push(`### References (${i.length})`);for(let e of i)s.push(`- ${e.path}:${e.line}`);s.push(``)}}return s.push(`---`,"_Next: `symbol` for definition details | `compact` to read a referenced file | `blast_radius` for impact analysis_"),{content:[{type:`text`,text:s.join(`
|
|
138
|
+
`)}],structuredContent:{start:o.start,direction:o.direction,depth:o.depth,nodes:o.nodes,graphContext:o.graphContext??null}}}catch(e){return Ko.error(`Trace failed`,j(e)),W(`INTERNAL`,`Trace failed: ${e instanceof Error?e.message:String(e)}`)}})}function $o(e,t,n,r,i,a){let o=V(`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:_a,inputSchema:{path:N.string().optional().describe(`Root path to scope the search (default: cwd)`),limit:N.number().min(1).max(500).default(100).optional().describe(`Maximum exported symbols to scan`),enrich:N.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},async({path:e,limit:o,enrich:s})=>{try{let c=e&&r?Go(e,r,i):e,l=await Ie(t,n,{rootPath:c,limit:o}),u=[`## Dead Symbol Analysis`,``,`**Exports scanned:** ${l.totalExports}`,`**Dead in source:** ${l.totalDeadSource} (actionable)`,`**Dead in docs:** ${l.totalDeadDocs} (informational — code samples in .md files)`,``];if(l.deadInSource.length>0){u.push(`### Dead in Source (actionable)`);for(let e of l.deadInSource)u.push(`- \`${e.name}\` (${e.kind}) — ${e.path}:${e.line}`);u.push(``)}if(l.deadInDocs.length>0){u.push(`### Dead in Docs (informational)`),u.push(`_${l.totalDeadDocs} symbol(s) found only in documentation code samples — not actionable dead code._`);for(let e of l.deadInDocs.slice(0,5))u.push(`- \`${e.name}\` — ${e.path}:${e.line}`);l.deadInDocs.length>5&&u.push(`- _... ${l.deadInDocs.length-5} more omitted_`)}l.totalDeadSource>0?u.push(``,`---`,`_Next: \`codemod\` to remove ${l.totalDeadSource} unused exports | \`symbol\` to verify usage before removing_`):u.push(``,`---`,"_Next: `check` — no dead symbols found, validate types and lint_");let d=u.join(`
|
|
139
|
+
`);if(s&&a){let t=await H(a,{query:`dead symbols ${e??c??``}`});d+=U(t)}return{content:[{type:`text`,text:d}],structuredContent:{symbols:[...l.deadInSource,...l.deadInDocs].map(e=>({name:e.name,path:e.path,...e.line===void 0?{}:{line:e.line},kind:e.kind})),totalDead:l.totalDeadSource+l.totalDeadDocs}}}catch(e){return Ko.error(`Dead symbol scan failed`,j(e)),W(`INTERNAL`,`Dead symbol scan failed: ${e instanceof Error?e.message:String(e)}`)}})}function es(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(`
|
|
140
|
+
`)}function ts(e){let t=[e.path,`Language: ${e.language}`,`Lines: ${e.lines}`,`Estimated tokens: ~${e.estimatedTokens}`,``,`Imports (${e.imports.length}):`,...ns(e.imports),``,`Exports (${e.exports.length}):`,...ns(e.exports),``,`Functions (${e.functions.length}):`,...ns(e.functions.map(e=>`${e.name} @ line ${e.line}${e.exported?` [exported]`:``}${`signature`in e&&e.signature?` — ${e.signature}`:``}`)),``,`Classes (${e.classes.length}):`,...ns(e.classes.map(e=>`${e.name} @ line ${e.line}${e.exported?` [exported]`:``}${e.signature?` — ${e.signature}`:``}`)),``,`Interfaces (${e.interfaces.length}):`,...ns(e.interfaces.map(e=>`${e.name} @ line ${e.line}${`exported`in e&&e.exported?` [exported]`:``}`)),``,`Types (${e.types.length}):`,...ns(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.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(`
|
|
141
|
+
`)}function ns(e){return e.length===0?[` none`]:e.map(e=>` - ${e}`)}const rs=k(`tools`);function is(e,t){let n=V(`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:N.boolean().default(!0).describe(`Include detailed breakdowns (top missed queries, rule stats)`),reset_after:N.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
|
|
142
142
|
`,`**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(`
|
|
143
|
-
**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&&(
|
|
143
|
+
**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&&(rs.info(`Evolution metrics reset requested`,{requestedAt:new Date().toISOString(),clearedEvents:r.period.totalEvents}),t.reset(),i.push(`
|
|
144
144
|
_Metrics have been reset._`)),{content:[{type:`text`,text:i.join(`
|
|
145
|
-
`)}]}}catch(e){return
|
|
146
|
-
`);if(s&&t){let e=await H(t,{query:`known issues failures`});i+=U(e)}return{content:[{type:`text`,text:i}],structuredContent:{...e}}}let f=JSON.stringify(u);if(s&&t){let e=await H(t,{query:`known issues failures`});f+=U(e)}return{content:[{type:`text`,text:f}]}}catch(e){return
|
|
147
|
-
`).replace(/\\t/g,` `),t);return{content:[{type:`text`,text:JSON.stringify(n)}]}}catch(e){return
|
|
148
|
-
`)}const
|
|
149
|
-
`);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
|
|
145
|
+
`)}]}}catch(e){return rs.error(`Evolution review failed`,j(e)),W(`INTERNAL`,`Evolution review failed: unable to compute metrics`)}})}const as=k(`tools:execution`);function os(e,t,n){let r=V(`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:N.array(N.string()).optional().describe(`Specific files to check (if omitted, checks all)`),cwd:N.string().optional().describe(`Working directory`),skip_types:N.boolean().default(!1).describe(`Skip TypeScript typecheck`),skip_lint:N.boolean().default(!1).describe(`Skip Biome lint`),detail:N.enum(O).optional().describe(`Output detail level: efficient (default, ~300 tokens — pass/fail + counts + top errors), normal (parsed error objects), full (includes raw terminal output)`),enrich:N.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:na,annotations:r.annotations},async({files:e,cwd:r,skip_types:i,skip_lint:a,detail:o,enrich:s},c)=>{try{let l=o??n??`efficient`,u=await fe({files:e,cwd:r,skipTypes:i,skipLint:a,detail:l===`efficient`?`normal`:l}),d=ao(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=Bt(u),n=[];if(u.passed)n.push({tool:`test_run`,reason:`Types and lint clean — run tests next`});else{let e=u.tsc.errors[0]?.file??u.biome.errors[0]?.file;e&&n.push({tool:`symbol`,reason:`Resolve failing symbol in ${e}`,suggested_args:{name:e}}),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(`
|
|
146
|
+
`);if(s&&t){let e=await H(t,{query:`known issues failures`});i+=U(e)}return{content:[{type:`text`,text:i}],structuredContent:{...e}}}let f=JSON.stringify(u);if(s&&t){let e=await H(t,{query:`known issues failures`});f+=U(e)}return{content:[{type:`text`,text:f}]}}catch(e){return as.error(`Check failed`,j(e)),W(`INTERNAL`,`Check failed: ${e instanceof Error?e.message:String(e)}`)}})}function ss(e){let t=V(`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:N.string().max(1e5).describe(`Code snippet to execute`),lang:N.enum([`js`,`ts`]).default(`js`).optional().describe(`Language mode: js executes directly, ts strips common type syntax first`),timeout:N.number().min(1).max(6e4).default(5e3).optional().describe(`Execution timeout in milliseconds`)},annotations:t.annotations},async({code:e,lang:t,timeout:n})=>{try{let r=Me({code:e,lang:t,timeout:n});return r.success?{content:[{type:`text`,text:`Eval succeeded in ${r.durationMs}ms\n\n${r.output}`}]}:W(`INTERNAL`,`Eval failed in ${r.durationMs}ms: ${r.error??`Unknown error`}`)}catch(e){return as.error(`Eval failed`,j(e)),W(`INTERNAL`,`Eval failed: ${e instanceof Error?e.message:String(e)}`)}})}function cs(e,t){let n=V(`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:N.array(N.string()).optional().describe(`Specific test files or patterns to run`),grep:N.string().optional().describe(`Only run tests whose names match this pattern`),cwd:N.string().optional().describe(`Working directory for the test run`),enrich:N.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:xa},async({files:e,grep:n,cwd:r,enrich:i},a)=>{try{let o=await Ht({files:e,grep:n,cwd:r}),s=ao(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=ds(o);if(i&&t){let e=await H(t,{query:`test patterns known failures`});l+=U(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 as.error(`Test run failed`,j(e)),W(`INTERNAL`,`Test run failed: ${e instanceof Error?e.message:String(e)}`)}})}function ls(e){let t=V(`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:N.string().max(5e5).describe(`Raw output text from a build tool`),tool:N.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,`
|
|
147
|
+
`).replace(/\\t/g,` `),t);return{content:[{type:`text`,text:JSON.stringify(n)}]}}catch(e){return as.error(`Parse failed`,j(e)),W(`INTERNAL`,`Parse failed: ${e instanceof Error?e.message:String(e)}`)}})}function us(e,t){let n=V(`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:N.string().max(2e5).describe(`The task or question to send to the local model`),model:N.string().optional().describe(`Ollama model name (default: first available model)`),system:N.string().optional().describe(`System prompt for the model`),context:N.string().max(5e5).optional().describe(`Context text to include before the prompt (e.g. file contents)`),temperature:N.number().min(0).max(2).default(.3).optional().describe(`Sampling temperature (0=deterministic, default 0.3)`),timeout:N.number().min(1e3).max(6e5).default(12e4).optional().describe(`Timeout in milliseconds (default 120000)`),action:N.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 Ee();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{as.debug(`Sampling failed, falling back to Ollama`)}let c=await Te({prompt:e,model:n,system:r,context:i,temperature:a,timeout:o});return c.error?W(`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 as.error(`Delegate failed`,j(e)),W(`INTERNAL`,`Delegate failed: ${e instanceof Error?e.message:String(e)}`)}})}function ds(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(`
|
|
148
|
+
`)}const fs=k(`sampling`);function ps(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 ms(e){if(Array.isArray(e))return e.map(e=>ms(e)).filter(e=>e.length>0).join(`
|
|
149
|
+
`);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 hs(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:ps(e),maxTokens:e.maxTokens??4e3});return{text:ms(n.content),model:n.model,stopReason:n.stopReason}}catch(e){throw fs.warn(`Sampling createMessage failed`,{error:String(e)}),e}}}}const gs=[],_s=[`_docs-sync`],vs=new Map([[`_docs-sync`,`Synchronize project documentation — update docs/ folder based on changes made during the flow.`]]);function ys(e){function t(t,n,r){let i=n?.installPath?h(n.installPath):t.replaceAll(`:`,`-`),a=b(In(),`.copilot`,`flows`,i).replaceAll(`\\`,`/`);if(o(a))return a;let s=b(In(),`.claude`,`flows`,i).replaceAll(`\\`,`/`);if(o(s))return s;let c=b(r??e(),`.github`,`flows`,i).replaceAll(`\\`,`/`);return o(c)?c:n?.installPath&&o(n.installPath)?n.installPath.replaceAll(`\\`,`/`):null}function n(e,n,r){let i=t(e.name,e,r);return i?b(i,n).replaceAll(`\\`,`/`):n}function r(t,n){let r=t.replace(/^_/,``),i=n??e(),a=[v(i,`.github`,`flows`,`_epilogue`,`steps`,r,`README.md`),v(i,`.github`,`flows`,`_epilogue`,r,`README.md`)];for(let e of a)if(o(e))return e.replaceAll(`\\`,`/`);return null}function i(e){return[...gs,...e.manifest.steps.map(e=>e.id),..._s]}function a(e,t,r){let i=t?e.manifest.steps.find(e=>e.id===t)??null:null,a=t?vs.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 s(){try{let e=v(Fn(`npm root -g`,{encoding:`utf-8`}).trim(),`@fission-ai`,`openspec`);if(o(e))return{path:e,sourceType:`npm-global`,isGit:!1}}catch{}return{path:`https://github.com/Fission-AI/OpenSpec.git`,sourceType:`git`,isGit:!0}}function u(e){let t=b(e);if(o(v(t,`.claude-plugin`,`plugin.json`)))return{path:t,sourceType:`claude-plugin`};let n=In(),r=v(n,`.claude`,`plugins`,e);if(o(v(r,`.claude-plugin`,`plugin.json`)))return{path:r,sourceType:`claude-plugin`};let i=v(n,`.claude`,`plugins`);if(!o(i))return null;for(let t of l(i,{withFileTypes:!0})){if(!t.isDirectory())continue;let n=v(i,t.name,`.claude-plugin`,`plugin.json`);if(o(n))try{if(JSON.parse(c(n,`utf-8`)).name===e)return{path:v(i,t.name),sourceType:`claude-plugin`}}catch{}}return null}return{resolveInstallPath:t,resolveInstructionPath:n,resolveEpilogueInstructionPath:r,getStepSequence:i,resolveCurrentStepInfo:a,resolveOpenSpecSource:s,resolveClaudePluginSource:u}}function bs(e){function t(){return e.sources?.[0]?.path??process.cwd()}function n(e){let t=[];try{let n=l(e,{withFileTypes:!0});for(let r of n){if(!r.isDirectory()||r.name.startsWith(`.`))continue;let n=v(e,r.name);o(v(n,`.git`))&&t.push(n)}}catch{}return t}function r(){let r=e.allRoots?.length?e.allRoots:[t()],i=new Set(r);for(let e of r)for(let t of n(e))i.add(t);return[...i]}function i(n){let i=n.replaceAll(`\\`,`/`);if(r().map(e=>e.replaceAll(`\\`,`/`)).includes(i))return!0;let a=(e.allRoots?.length?e.allRoots:[t()]).map(e=>e.replaceAll(`\\`,`/`));for(let e of a)if(i.startsWith(`${e}/`)&&o(v(n,`.git`)))return!0;return!1}function a(e){return v(e??t(),`.flows`)}async function d(){let e=r();for(let t of e){let e=a(t);if(o(e))for(let n of l(e,{withFileTypes:!0})){if(!n.isDirectory())continue;let r=v(e,n.name,`meta.json`);if(o(r))try{let e=JSON.parse(c(r,`utf-8`));if(e.status===`active`)return e.primaryRoot?e.primaryRoot:t}catch{}}}return null}async function f(e){return e||(await d()??t())}function m(e,t,n){let r=v(a(t),e,`meta.json`),i=c(r,`utf-8`),o=JSON.parse(i);o.roots=n.map(e=>e.replaceAll(`\\`,`/`)),o.primaryRoot=t.replaceAll(`\\`,`/`);let s=`${r}.tmp`;p(s,JSON.stringify(o,null,2),`utf-8`),u(s,r)}function h(e,t){let n=v(a(t),e,`meta.json`);if(!o(n))return;let r=c(n,`utf-8`),i=JSON.parse(r),l=i.roots;if(!l||l.length<=1)return;let d=t.replaceAll(`\\`,`/`);for(let t of l){if(t===d)continue;let n=v(t,`.flows`,e);s(n,{recursive:!0});let a=v(n,`meta.json`),o=`${a}.tmp`;p(o,r,`utf-8`),u(o,a),s(v(n,i.artifactsDir??`.spec`),{recursive:!0})}}return{getWorkspaceRoot:t,getAllRoots:r,getFlowsDir:a,isValidFlowRoot:i,resolveFlowRoot:f,patchMetaRoots:m,syncMetaToRoots:h}}const xs=k(`flow-tools`);function Ss(e){return Array.isArray(e)?e.filter(e=>typeof e==`string`&&e.trim().length>0):[]}function Cs(e){return{content:[{type:`text`,text:e}]}}function ws(e){return e instanceof Error?e.message:String(e)}const Ts={before:[],after:[{id:`_docs-sync`,description:`Synchronize project documentation — update docs/ folder based on changes made during the flow.`,position:`after`,skills:[`docs`]}]};function Es(e,t){let n=bs(t),r=ys(n.getWorkspaceRoot);function i(){return v(ne(),`flows`,`registry.json`)}function a(){let t=hs(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.
|
|
150
150
|
|
|
151
151
|
Convert the provided content into a well-structured README.md for a flow step named "${r}".
|
|
152
152
|
|
|
@@ -159,18 +159,18 @@ The output must:
|
|
|
159
159
|
6. Preserve ALL tool restrictions, constraints, and requirements from the source
|
|
160
160
|
7. Be formatted as clean Markdown
|
|
161
161
|
|
|
162
|
-
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){
|
|
162
|
+
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){xs.debug(`Flow transform sampling failed; using fallback formatting`,{error:ws(e),sourceFormat:n,stepName:r})}let c=typeof i?.description==`string`&&i.description.trim().length>0?i.description.trim():null,l=Ss(i?.produces),u=Ss(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(`
|
|
163
163
|
`).trimEnd().concat(`
|
|
164
|
-
`)}}async function o(e){let{FlowRegistryManager:r,FlowStateMachine:a,FlowLoader:o,GitInstaller:s}=await import(`../../flows/dist/index.js`),c=v(t.stateDir??v(n.getWorkspaceRoot(),`.aikit-state`),`flows`,`installed`);return{registry:new r(i()),stateMachine:new a(n.getFlowsDir(e),Cs),loader:new o,installer:new s(c)}}return{server:e,config:t,log:ys,toTextResponse:xs,toErrorText:Ss,createFlowTransform:a,getFlows:o,...n,...r}}async function Ts(e,t){let{getFlows:n,log:r,resolveEpilogueInstructionPath:i,resolveFlowRoot:a,resolveInstructionPath:o,toErrorText:s,toTextResponse:c}=t,{step:l}=e;try{let e=await a(),{registry:t,stateMachine:r}=await n(e),s=r.getStatus();if(!s.success||!s.data)return c(`No active flow. Use flow({ action: "start", name: "<flow>" }) to begin one, or flow({ action: "list" }) to see available flows.`);let u=s.data,d=t.get(u.flow);if(!d)return c(`Flow "${u.flow}" not found in registry.`);let f=l??u.currentStep;if(!f)return c(`No current step is available for the active flow.`);let p=d.manifest.steps.find(e=>e.id===f||e.name===f);if(!p){let t=i(f,e);if(t){let n=await Qt(t,`utf-8`),r=v(u.runDir,d.manifest.artifacts_dir).replaceAll(`\\`,`/`),i=u.runDir.replaceAll(`\\`,`/`);return n=n.replaceAll(`{{artifacts_path}}`,r).replaceAll(`{{run_dir}}`,i).replaceAll(`{{workspace_root}}`,(u.primaryRoot??e).replaceAll(`\\`,`/`)).replaceAll(`{{all_roots}}`,JSON.stringify(u.roots??[e.replaceAll(`\\`,`/`)],null,2)),c(n)}return c(`Step "${f}" not found in flow "${u.flow}".`)}let m=await Qt(o(d,p.instruction,e),`utf-8`),h=v(u.runDir,d.manifest.artifacts_dir).replaceAll(`\\`,`/`),g=u.runDir.replaceAll(`\\`,`/`);m=m.replaceAll(`{{artifacts_path}}`,h).replaceAll(`{{run_dir}}`,g).replaceAll(`{{workspace_root}}`,(u.primaryRoot??e).replaceAll(`\\`,`/`)).replaceAll(`{{all_roots}}`,JSON.stringify(u.roots??[e.replaceAll(`\\`,`/`)],null,2));for(let e of[`spec-driven`])m=m.replaceAll(`${e}/${u.slug}/`,`${h}/`);return c(m)}catch(e){return r.error(`flow action read failed`,j(e)),e instanceof Error&&`code`in e&&e.code===`ENOENT`?c(`Could not read instruction file: ${e.message}`):c(`Error: ${s(e)}`)}}async function Es(e,t){let{registry:n,loader:r,installer:i}=await e.getFlows(),a=e.createFlowTransform(),s=b(t.source);if(!o(s))return e.toTextResponse(`Source path no longer exists: ${s}`);let c=`${t.installPath}.updating`,l=`${t.installPath}.backup`;o(c)&&d(c,{recursive:!0,force:!0}),o(l)&&d(l,{recursive:!0,force:!0});let f=i.copyLocal(s,h(c));if(!f.success||!f.data)return e.toTextResponse(`Failed to copy flow: ${f.error}`);let p=await r.load(c,{forceAssetSync:!0,transform:a});if(!p.success||!p.data)return i.remove(c),e.toTextResponse(`Failed to load flow manifest: ${p.error}`);let m=!1;try{u(t.installPath,l),u(c,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,s=e.data.format,f=n.register({...t,version:o.version,format:s,installPath:t.installPath,manifest:o,updatedAt:new Date().toISOString()});if(!f.success)throw Error(`Failed to refresh flow registry entry: ${f.error}`);if(m=!0,o.install.length>0){let e=i.runInstallDeps(o.install);if(!e.success)throw Error(`Dependency install failed: ${e.error}`)}d(l,{recursive:!0,force:!0})}catch(r){return o(c)&&d(c,{recursive:!0,force:!0}),o(l)&&(o(t.installPath)&&d(t.installPath,{recursive:!0,force:!0}),u(l,t.installPath)),m&&n.register(t),e.toTextResponse(e.toErrorText(r))}return e.toTextResponse(`Flow "${t.name}" updated from ${t.sourceType} source successfully.`)}async function Ds(e,t){let{registry:n,loader:r}=await e.getFlows(),i=e.createFlowTransform();try{Fn(`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 Os(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 ks(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,g;if(f){let e=o();m=e.path,p=e.sourceType}let _=f?null:a(m);_&&(m=_.path,p=_.sourceType);let v=/^https?:\/\/|^git@/.test(m),y;if(v){let e=i.clone(m,d);if(!e.success||!e.data)return c(`Failed to clone flow: ${e.error}`);y=e.data}else{let e=b(m);g=e;let t=u||h(e)||`custom-flow`,n=i.copyLocal(e,t);if(!n.success||!n.data)return c(`Failed to copy flow: ${n.error}`);y=n.data}let x=await t.load(y,{forceAssetSync:!0,transform:s});if(!x.success||!x.data)return i.remove(y),c(`Failed to load flow manifest: ${x.error}`);let{manifest:S,format:C}=x.data,w=u||S.name,T=p??(v?`git`:`local`);if(e.has(w))return i.remove(y),c(`Flow "${w}" is already installed. Use flow({ action: "update", name: "${w}" }) to update it, or flow({ action: "remove", name: "${w}" }) then flow({ action: "add", source: "..." }) to replace.`);if(S.install.length>0){let e=i.runInstallDeps(S.install);if(!e.success)return i.remove(y),c(`Dependency install failed: ${e.error}`)}let E=new Date().toISOString(),D=v?i.getLocalCommit(y):void 0,O=e.register({name:w,version:S.version,source:T===`local`||T===`claude-plugin`?g??l:l,sourceType:T,installPath:y,format:C,registeredAt:E,updatedAt:E,manifest:S,...D?{commitSha:D}:{}});if(!O.success)return i.remove(y),c(`Failed to register flow: ${O.error}`);let ee=S.steps.length;return c(`Flow "${w}" installed successfully (${ee} steps). Use flow({ action: "start", name: "${w}" }) to begin.`)}catch(e){return i.error(`flow action add failed`,j(e)),c(`Error: ${s(e)}`)}}async function As(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`,j(e)),a(`Error: ${i(e)}`)}}async function js(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`?Es(s,t):t.sourceType===`npm-global`?Ds(s,t):Os(s,t)}catch(e){return r.error(`flow action update failed`,j(e)),a(`Error: ${i(e)}`)}}async function Ms(e,t){let{getAllRoots:n,getFlows:r,getStepSequence:i,getWorkspaceRoot:a,isValidFlowRoot:o,log:s,patchMetaRoots:c,resolveCurrentStepInfo:l,toErrorText:u,toTextResponse:d}=t,{flow:f,topic:p,roots:m}=e;try{if(m&&m.length>0){let e=m.filter(e=>!o(e));if(e.length>0)return d(`Invalid roots — not part of the workspace or a recognized sub-repository: ${e.join(`, `)}. Available roots: ${n().map(e=>e.replaceAll(`\\`,`/`)).join(`, `)}`)}let e=n(),s=e.length>1,u=!m&&s,h=m?.[0]??a(),{registry:g,stateMachine:_}=await r(h),y=g.get(f);if(!y)return d(`Flow "${f}" not found. Use flow({ action: "list" }) to see available flows.`);let b=_.start(y.name,y.manifest,p);if(!b.success||!b.data)return d(`Cannot start: ${b.error}`);let x=b.data;if(m&&m.length>1)try{c(x.slug,h,m),t.syncMetaToRoots(x.slug,h)}catch(e){return _.reset(),d(`Flow created but failed to sync to secondary roots — rolled back. Error: ${e instanceof Error?e.message:String(e)}`)}try{await Zt(v(h,`.aikit-state`,`flow-context`,x.slug),{recursive:!0})}catch{}let{instructionPath:S,description:C}=l(y,x.currentStep,h),w=i(y),T={started:!0,flow:x.flow,slug:x.slug,topic:x.topic,runDir:x.runDir,artifactsPath:v(x.runDir,y.manifest.artifacts_dir).replaceAll(`\\`,`/`),currentStep:x.currentStep,currentStepInstruction:S,currentStepDescription:C,phase:x.phase,isEpilogue:x.isEpilogue,totalSteps:w.length,stepSequence:w,artifactsDir:y.manifest.artifacts_dir,roots:m??[h.replaceAll(`\\`,`/`)],...u?{multiRootWarning:`No roots specified in multi-root workspace. Flow created at workspace root. Pass roots parameter with target repo for precise placement.`,availableRoots:e.map(e=>e.replaceAll(`\\`,`/`))}:{}};return d(JSON.stringify(T,null,2))}catch(e){return s.error(`flow action start failed`,j(e)),d(`Error: ${u(e)}`)}}async function Ns(e){let{config:t,getAllRoots:n,getFlows:r,getStepSequence:i,getWorkspaceRoot:a,log:o,resolveCurrentStepInfo:s,resolveFlowRoot:c,toErrorText:l,toTextResponse:u}=e;try{let e=await c(),{registry:o,stateMachine:l}=await r(e),d=l.getStatus();if(!d.success||!d.data)return u(`No active flow. Use flow({ action: "start", name: "<flow>" }) to begin one, or flow({ action: "list" }) to see available flows.`);let f=d.data,p=o.get(f.flow),m=p?s(p,f.currentStep,e):null,h=p?i(p):[],g=m?.instructionPath??null,_={flow:f.flow,status:f.status,slug:f.slug,topic:f.topic,runDir:f.runDir,artifactsPath:p?v(f.runDir,p.manifest.artifacts_dir).replaceAll(`\\`,`/`):null,currentStep:f.currentStep,currentStepInstruction:g,instructionPath:g,currentStepDescription:m?.description??null,phase:f.phase,isEpilogue:f.isEpilogue,completedSteps:f.completedSteps,skippedSteps:f.skippedSteps,artifacts:f.artifacts,startedAt:f.startedAt,updatedAt:f.updatedAt,totalSteps:h.length,progress:p?`${f.completedSteps.length+f.skippedSteps.length}/${h.length}`:`unknown`,workspaceRoot:e.replaceAll(`\\`,`/`),primaryRoot:(f.primaryRoot??e).replaceAll(`\\`,`/`),roots:f.roots??[e.replaceAll(`\\`,`/`)],allRoots:n().map(e=>e.replaceAll(`\\`,`/`)),discoveredRepos:(()=>{let e=(t.allRoots?.length?t.allRoots:[a()]).map(e=>e.replaceAll(`\\`,`/`)),r=n().map(e=>e.replaceAll(`\\`,`/`)).filter(t=>!e.includes(t));return r.length>0?r:void 0})()};return u(JSON.stringify(_,null,2))}catch(e){return o.error(`flow action status failed`,j(e)),u(`Error: ${l(e)}`)}}async function Ps(e){let{getFlows:t,log:n,resolveFlowRoot:r,syncMetaToRoots:i,toErrorText:a,toTextResponse:o}=e;try{let e=await r(),{stateMachine:n}=await t(e),a=n.getStatus(),s=n.reset();if(!s.success)return o(`Reset failed: ${s.error}`);if(a.success&&a.data&&i(a.data.slug,e),a.success&&a.data?.slug)try{await en(v(e,`.aikit-state`,`flow-context`,a.data.slug),{recursive:!0,force:!0})}catch{}return o(`Flow abandoned. Use flow({ action: "start", name: "<flow>" }) to begin a new flow.`)}catch(e){return n.error(`flow action reset failed`,j(e)),o(`Error: ${a(e)}`)}}async function Fs(e,t){let{getFlows:n,getStepSequence:r,log:i,resolveCurrentStepInfo:a,resolveFlowRoot:o,syncMetaToRoots:s,toErrorText:c,toTextResponse:l}=t,{action:u}=e;try{let e=await o(),{registry:t,stateMachine:i}=await n(e),c=i.getStatus();if(!c.success||!c.data)return l(`No active flow. Use flow({ action: "start", name: "<flow>" }) first.`);let d=t.get(c.data.flow);if(!d)return l(`Flow "${c.data.flow}" not found in registry.`);let f=i.step(u,d.manifest);if(!f.success||!f.data)return l(`Cannot ${u}: ${f.error}`);s(f.data.slug,e);let p=f.data,{instructionPath:m,description:h}=a(d,p.currentStep,e),g=r(d),_={flow:p.flow,status:p.status,action:u,slug:p.slug,topic:p.topic,runDir:p.runDir,artifactsPath:v(p.runDir,d.manifest.artifacts_dir).replaceAll(`\\`,`/`),currentStep:p.currentStep,currentStepInstruction:m,currentStepDescription:h,phase:p.phase,isEpilogue:p.isEpilogue,completedSteps:p.completedSteps,skippedSteps:p.skippedSteps,totalSteps:g.length,remaining:g.filter(e=>!p.completedSteps.includes(e)&&!p.skippedSteps.includes(e)&&e!==p.currentStep)};return l(JSON.stringify(_,null,2))}catch(e){return i.error(`flow action step failed`,j(e)),l(`Error: ${c(e)}`)}}async function Is(e){let{config:t,getAllRoots:n,getFlows:r,getWorkspaceRoot:i,log:a,resolveFlowRoot:o,toErrorText:s,toTextResponse:c}=e;try{let{registry:e,stateMachine:a,installer:s}=await r(await o()),l=e.list(),u=a.getStatus(),d={flows:l.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=s.hasUpdates(e.installPath);return{...t,commitSha:e.commitSha,updateAvailable:n.success&&n.data?n.data.hasUpdates:void 0}}return t}),activeFlow:u.success&&u.data?{flow:u.data.flow,status:u.data.status,currentStep:u.data.currentStep,slug:u.data.slug,topic:u.data.topic,runDir:u.data.runDir}:null,allRoots:n().map(e=>e.replaceAll(`\\`,`/`)),discoveredRepos:(()=>{let e=(t.allRoots?.length?t.allRoots:[i()]).map(e=>e.replaceAll(`\\`,`/`)),r=n().map(e=>e.replaceAll(`\\`,`/`)).filter(t=>!e.includes(t));return r.length>0?r:void 0})()};return c(JSON.stringify(d,null,2))}catch(e){return a.error(`flow action list failed`,j(e)),c(`Error: ${s(e)}`)}}async function Ls(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)return s(`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 r.error(`flow action info failed`,j(e)),s(`Error: ${o(e)}`)}}async function Rs(e,t){let{getAllRoots:n,getFlows:r,log:i,toErrorText:a,toTextResponse:o}=t,{flow:s,status:c}=e;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)});return a.length===0?o(`No flow runs found.`):o(JSON.stringify(a,null,2))}catch(e){return i.error(`flow action runs failed`,j(e)),o(`Error: ${a(e)}`)}}function zs(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 Bs(e,t,n){let r=ws(e,t),i=V(`flow`);e.registerTool(`flow`,{title:i.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:i.annotations,inputSchema:{action:N.enum([`list`,`info`,`start`,`step`,`status`,`reset`,`read`,`runs`,`add`,`remove`,`update`]).describe(`The flow operation to perform.`),name:N.string().optional().describe(`Flow name — required for info, start, remove, update. Optional override for add.`),topic:N.string().optional().describe(`Human-readable topic for the run (used by start).`),roots:N.array(N.string()).optional().describe(`Workspace roots participating in this flow (used by start).`),advance:N.enum([`next`,`skip`,`redo`]).optional().describe(`Step navigation action — required for step.`),step:N.string().optional().describe(`Step id or name to read (used by read). Defaults to current step.`),source:N.string().optional().describe(`Git URL, local path, or "openspec" shorthand — required for add.`),token:N.string().optional().describe(`Auth token for private repos (used by add).`),filter_flow:N.string().optional().describe(`Filter runs by flow name (used by runs).`),filter_status:N.string().optional().describe(`Filter runs by status: active, completed, abandoned (used by runs).`)}},async e=>{switch(e.action){case`list`:return Is(r);case`info`:return e.name?Ls({name:e.name},r):r.toTextResponse(`Missing required parameter: name`);case`start`:{if(!e.name)return r.toTextResponse(`Missing required parameter: name (flow to start)`);let t=await Ms({flow:e.name,topic:e.topic,roots:e.roots},r),i=zs(t);return i&&n&&n(i),t}case`step`:return e.advance?Fs({action:e.advance},r):r.toTextResponse(`Missing required parameter: advance (next/skip/redo)`);case`status`:{let e=await Ns(r);return n&&n(zs(e)),e}case`reset`:{let e=await Ps(r);return n&&n(null),e}case`read`:return Ts({step:e.step},r);case`runs`:return Rs({flow:e.filter_flow,status:e.filter_status},r);case`add`:return e.source?ks({source:e.source,name:e.name,token:e.token},r):r.toTextResponse(`Missing required parameter: source`);case`remove`:return e.name?As({name:e.name},r):r.toTextResponse(`Missing required parameter: name`);case`update`:return e.name?js({name:e.name},r):r.toTextResponse(`Missing required parameter: name`);default:return r.toTextResponse(`Unknown action: ${e.action}`)}})}const Vs=k(`tools`);function Hs(e){let t=V(`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:N.enum([`create`,`add`,`update`,`get`,`gate`,`list`,`delete`]).describe(`Operation to perform`),task_id:N.string().optional().describe(`Task identifier (required for all except list)`),tier:N.enum([`floor`,`standard`,`critical`]).optional().describe(`FORGE tier (required for create)`),claim:N.string().optional().describe(`Critical-path claim text (for add)`),status:N.enum([`V`,`A`,`U`]).optional().describe(`Evidence status: V=Verified, A=Assumed, U=Unresolved`),receipt:N.string().optional().describe(`Evidence receipt: tool→ref for V, reasoning for A, attempts for U`),id:N.number().optional().describe(`Entry ID (for update)`),critical_path:N.boolean().default(!0).describe(`Whether this claim is on the critical path`),unknown_type:N.enum([`contract`,`convention`,`freshness`,`runtime`,`data-flow`,`impact`]).optional().describe(`Typed unknown classification`),safety_gate:N.enum([`provenance`,`commitment`,`coverage`]).optional().describe(`Safety gate tag: provenance (claim→evidence), commitment (user-approved), coverage (nothing dropped)`),retry_count:N.number().default(0).describe(`Retry count for gate evaluation (0 = first attempt)`),max_retries:N.number().int().min(0).optional().describe(`Maximum retries before escalating. Default: 3`),timeout_action:N.enum([`iterate`,`retry`,`manual`,`terminate`]).optional().describe(`Action to take when gate retries are exhausted. Default: manual`),cwd:N.string().optional().describe(`Working directory for evidence map storage (default: server cwd). Use root_path from forge_ground to match.`)},annotations:t.annotations},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 Ne({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=Ne({action:`add`,taskId:t,claim:r,status:i,receipt:a??``,criticalPath:s,unknownType:c,safetyGate:l},p),n=[`Added entry #${e.entry?.id} to "${t}": [${i}] ${r}`];return e.formattedMap&&n.push(``,e.formattedMap),{content:[{type:`text`,text:n.join(`
|
|
164
|
+
`)}}async function o(e){let{FlowRegistryManager:r,FlowStateMachine:a,FlowLoader:o,GitInstaller:s}=await import(`../../flows/dist/index.js`),c=v(t.stateDir??v(n.getWorkspaceRoot(),`.aikit-state`),`flows`,`installed`);return{registry:new r(i()),stateMachine:new a(n.getFlowsDir(e),Ts),loader:new o,installer:new s(c)}}return{server:e,config:t,log:xs,toTextResponse:Cs,toErrorText:ws,createFlowTransform:a,getFlows:o,...n,...r}}async function Ds(e,t){let{getFlows:n,log:r,resolveEpilogueInstructionPath:i,resolveFlowRoot:a,resolveInstructionPath:o,toErrorText:s,toTextResponse:c}=t,{step:l}=e;try{let e=await a(),{registry:t,stateMachine:r}=await n(e),s=r.getStatus();if(!s.success||!s.data)return c(`No active flow. Use flow({ action: "start", name: "<flow>" }) to begin one, or flow({ action: "list" }) to see available flows.`);let u=s.data,d=t.get(u.flow);if(!d)return c(`Flow "${u.flow}" not found in registry.`);let f=l??u.currentStep;if(!f)return c(`No current step is available for the active flow.`);let p=d.manifest.steps.find(e=>e.id===f||e.name===f);if(!p){let t=i(f,e);if(t){let n=await Qt(t,`utf-8`),r=v(u.runDir,d.manifest.artifacts_dir).replaceAll(`\\`,`/`),i=u.runDir.replaceAll(`\\`,`/`);return n=n.replaceAll(`{{artifacts_path}}`,r).replaceAll(`{{run_dir}}`,i).replaceAll(`{{workspace_root}}`,(u.primaryRoot??e).replaceAll(`\\`,`/`)).replaceAll(`{{all_roots}}`,JSON.stringify(u.roots??[e.replaceAll(`\\`,`/`)],null,2)),c(n)}return c(`Step "${f}" not found in flow "${u.flow}".`)}let m=await Qt(o(d,p.instruction,e),`utf-8`),h=v(u.runDir,d.manifest.artifacts_dir).replaceAll(`\\`,`/`),g=u.runDir.replaceAll(`\\`,`/`);m=m.replaceAll(`{{artifacts_path}}`,h).replaceAll(`{{run_dir}}`,g).replaceAll(`{{workspace_root}}`,(u.primaryRoot??e).replaceAll(`\\`,`/`)).replaceAll(`{{all_roots}}`,JSON.stringify(u.roots??[e.replaceAll(`\\`,`/`)],null,2));for(let e of[`spec-driven`])m=m.replaceAll(`${e}/${u.slug}/`,`${h}/`);return c(m)}catch(e){return r.error(`flow action read failed`,j(e)),e instanceof Error&&`code`in e&&e.code===`ENOENT`?c(`Could not read instruction file: ${e.message}`):c(`Error: ${s(e)}`)}}async function Os(e,t){let{registry:n,loader:r,installer:i}=await e.getFlows(),a=e.createFlowTransform(),s=b(t.source);if(!o(s))return e.toTextResponse(`Source path no longer exists: ${s}`);let c=`${t.installPath}.updating`,l=`${t.installPath}.backup`;o(c)&&d(c,{recursive:!0,force:!0}),o(l)&&d(l,{recursive:!0,force:!0});let f=i.copyLocal(s,h(c));if(!f.success||!f.data)return e.toTextResponse(`Failed to copy flow: ${f.error}`);let p=await r.load(c,{forceAssetSync:!0,transform:a});if(!p.success||!p.data)return i.remove(c),e.toTextResponse(`Failed to load flow manifest: ${p.error}`);let m=!1;try{u(t.installPath,l),u(c,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,s=e.data.format,f=n.register({...t,version:o.version,format:s,installPath:t.installPath,manifest:o,updatedAt:new Date().toISOString()});if(!f.success)throw Error(`Failed to refresh flow registry entry: ${f.error}`);if(m=!0,o.install.length>0){let e=i.runInstallDeps(o.install);if(!e.success)throw Error(`Dependency install failed: ${e.error}`)}d(l,{recursive:!0,force:!0})}catch(r){return o(c)&&d(c,{recursive:!0,force:!0}),o(l)&&(o(t.installPath)&&d(t.installPath,{recursive:!0,force:!0}),u(l,t.installPath)),m&&n.register(t),e.toTextResponse(e.toErrorText(r))}return e.toTextResponse(`Flow "${t.name}" updated from ${t.sourceType} source successfully.`)}async function ks(e,t){let{registry:n,loader:r}=await e.getFlows(),i=e.createFlowTransform();try{Fn(`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 As(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 js(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,g;if(f){let e=o();m=e.path,p=e.sourceType}let _=f?null:a(m);_&&(m=_.path,p=_.sourceType);let v=/^https?:\/\/|^git@/.test(m),y;if(v){let e=i.clone(m,d);if(!e.success||!e.data)return c(`Failed to clone flow: ${e.error}`);y=e.data}else{let e=b(m);g=e;let t=u||h(e)||`custom-flow`,n=i.copyLocal(e,t);if(!n.success||!n.data)return c(`Failed to copy flow: ${n.error}`);y=n.data}let x=await t.load(y,{forceAssetSync:!0,transform:s});if(!x.success||!x.data)return i.remove(y),c(`Failed to load flow manifest: ${x.error}`);let{manifest:S,format:C}=x.data,w=u||S.name,T=p??(v?`git`:`local`);if(e.has(w))return i.remove(y),c(`Flow "${w}" is already installed. Use flow({ action: "update", name: "${w}" }) to update it, or flow({ action: "remove", name: "${w}" }) then flow({ action: "add", source: "..." }) to replace.`);if(S.install.length>0){let e=i.runInstallDeps(S.install);if(!e.success)return i.remove(y),c(`Dependency install failed: ${e.error}`)}let E=new Date().toISOString(),D=v?i.getLocalCommit(y):void 0,O=e.register({name:w,version:S.version,source:T===`local`||T===`claude-plugin`?g??l:l,sourceType:T,installPath:y,format:C,registeredAt:E,updatedAt:E,manifest:S,...D?{commitSha:D}:{}});if(!O.success)return i.remove(y),c(`Failed to register flow: ${O.error}`);let ee=S.steps.length;return c(`Flow "${w}" installed successfully (${ee} steps). Use flow({ action: "start", name: "${w}" }) to begin.`)}catch(e){return i.error(`flow action add failed`,j(e)),c(`Error: ${s(e)}`)}}async function Ms(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`,j(e)),a(`Error: ${i(e)}`)}}async function Ns(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`?Os(s,t):t.sourceType===`npm-global`?ks(s,t):As(s,t)}catch(e){return r.error(`flow action update failed`,j(e)),a(`Error: ${i(e)}`)}}async function Ps(e,t){let{getAllRoots:n,getFlows:r,getStepSequence:i,getWorkspaceRoot:a,isValidFlowRoot:o,log:s,patchMetaRoots:c,resolveCurrentStepInfo:l,toErrorText:u,toTextResponse:d}=t,{flow:f,topic:p,roots:m}=e;try{if(m&&m.length>0){let e=m.filter(e=>!o(e));if(e.length>0)return d(`Invalid roots — not part of the workspace or a recognized sub-repository: ${e.join(`, `)}. Available roots: ${n().map(e=>e.replaceAll(`\\`,`/`)).join(`, `)}`)}let e=n(),s=e.length>1,u=!m&&s,h=m?.[0]??a(),{registry:g,stateMachine:_}=await r(h),y=g.get(f);if(!y)return d(`Flow "${f}" not found. Use flow({ action: "list" }) to see available flows.`);let b=_.start(y.name,y.manifest,p);if(!b.success||!b.data)return d(`Cannot start: ${b.error}`);let x=b.data;if(m&&m.length>1)try{c(x.slug,h,m),t.syncMetaToRoots(x.slug,h)}catch(e){return _.reset(),d(`Flow created but failed to sync to secondary roots — rolled back. Error: ${e instanceof Error?e.message:String(e)}`)}try{await Zt(v(h,`.aikit-state`,`flow-context`,x.slug),{recursive:!0})}catch{}let{instructionPath:S,description:C}=l(y,x.currentStep,h),w=i(y),T={started:!0,flow:x.flow,slug:x.slug,topic:x.topic,runDir:x.runDir,artifactsPath:v(x.runDir,y.manifest.artifacts_dir).replaceAll(`\\`,`/`),currentStep:x.currentStep,currentStepInstruction:S,currentStepDescription:C,phase:x.phase,isEpilogue:x.isEpilogue,totalSteps:w.length,stepSequence:w,artifactsDir:y.manifest.artifacts_dir,roots:m??[h.replaceAll(`\\`,`/`)],...u?{multiRootWarning:`No roots specified in multi-root workspace. Flow created at workspace root. Pass roots parameter with target repo for precise placement.`,availableRoots:e.map(e=>e.replaceAll(`\\`,`/`))}:{}};return d(JSON.stringify(T,null,2))}catch(e){return s.error(`flow action start failed`,j(e)),d(`Error: ${u(e)}`)}}async function Fs(e){let{config:t,getAllRoots:n,getFlows:r,getStepSequence:i,getWorkspaceRoot:a,log:o,resolveCurrentStepInfo:s,resolveFlowRoot:c,toErrorText:l,toTextResponse:u}=e;try{let e=await c(),{registry:o,stateMachine:l}=await r(e),d=l.getStatus();if(!d.success||!d.data)return u(`No active flow. Use flow({ action: "start", name: "<flow>" }) to begin one, or flow({ action: "list" }) to see available flows.`);let f=d.data,p=o.get(f.flow),m=p?s(p,f.currentStep,e):null,h=p?i(p):[],g=m?.instructionPath??null,_={flow:f.flow,status:f.status,slug:f.slug,topic:f.topic,runDir:f.runDir,artifactsPath:p?v(f.runDir,p.manifest.artifacts_dir).replaceAll(`\\`,`/`):null,currentStep:f.currentStep,currentStepInstruction:g,instructionPath:g,currentStepDescription:m?.description??null,phase:f.phase,isEpilogue:f.isEpilogue,completedSteps:f.completedSteps,skippedSteps:f.skippedSteps,artifacts:f.artifacts,startedAt:f.startedAt,updatedAt:f.updatedAt,totalSteps:h.length,progress:p?`${f.completedSteps.length+f.skippedSteps.length}/${h.length}`:`unknown`,workspaceRoot:e.replaceAll(`\\`,`/`),primaryRoot:(f.primaryRoot??e).replaceAll(`\\`,`/`),roots:f.roots??[e.replaceAll(`\\`,`/`)],allRoots:n().map(e=>e.replaceAll(`\\`,`/`)),discoveredRepos:(()=>{let e=(t.allRoots?.length?t.allRoots:[a()]).map(e=>e.replaceAll(`\\`,`/`)),r=n().map(e=>e.replaceAll(`\\`,`/`)).filter(t=>!e.includes(t));return r.length>0?r:void 0})()};return u(JSON.stringify(_,null,2))}catch(e){return o.error(`flow action status failed`,j(e)),u(`Error: ${l(e)}`)}}async function Is(e){let{getFlows:t,log:n,resolveFlowRoot:r,syncMetaToRoots:i,toErrorText:a,toTextResponse:o}=e;try{let e=await r(),{stateMachine:n}=await t(e),a=n.getStatus(),s=n.reset();if(!s.success)return o(`Reset failed: ${s.error}`);if(a.success&&a.data&&i(a.data.slug,e),a.success&&a.data?.slug)try{await en(v(e,`.aikit-state`,`flow-context`,a.data.slug),{recursive:!0,force:!0})}catch{}return o(`Flow abandoned. Use flow({ action: "start", name: "<flow>" }) to begin a new flow.`)}catch(e){return n.error(`flow action reset failed`,j(e)),o(`Error: ${a(e)}`)}}async function Ls(e,t){let{getFlows:n,getStepSequence:r,log:i,resolveCurrentStepInfo:a,resolveFlowRoot:o,syncMetaToRoots:s,toErrorText:c,toTextResponse:l}=t,{action:u}=e;try{let e=await o(),{registry:t,stateMachine:i}=await n(e),c=i.getStatus();if(!c.success||!c.data)return l(`No active flow. Use flow({ action: "start", name: "<flow>" }) first.`);let d=t.get(c.data.flow);if(!d)return l(`Flow "${c.data.flow}" not found in registry.`);let f=i.step(u,d.manifest);if(!f.success||!f.data)return l(`Cannot ${u}: ${f.error}`);s(f.data.slug,e);let p=f.data,{instructionPath:m,description:h}=a(d,p.currentStep,e),g=r(d),_={flow:p.flow,status:p.status,action:u,slug:p.slug,topic:p.topic,runDir:p.runDir,artifactsPath:v(p.runDir,d.manifest.artifacts_dir).replaceAll(`\\`,`/`),currentStep:p.currentStep,currentStepInstruction:m,currentStepDescription:h,phase:p.phase,isEpilogue:p.isEpilogue,completedSteps:p.completedSteps,skippedSteps:p.skippedSteps,totalSteps:g.length,remaining:g.filter(e=>!p.completedSteps.includes(e)&&!p.skippedSteps.includes(e)&&e!==p.currentStep)};return l(JSON.stringify(_,null,2))}catch(e){return i.error(`flow action step failed`,j(e)),l(`Error: ${c(e)}`)}}async function Rs(e){let{config:t,getAllRoots:n,getFlows:r,getWorkspaceRoot:i,log:a,resolveFlowRoot:o,toErrorText:s,toTextResponse:c}=e;try{let{registry:e,stateMachine:a,installer:s}=await r(await o()),l=e.list(),u=a.getStatus(),d={flows:l.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=s.hasUpdates(e.installPath);return{...t,commitSha:e.commitSha,updateAvailable:n.success&&n.data?n.data.hasUpdates:void 0}}return t}),activeFlow:u.success&&u.data?{flow:u.data.flow,status:u.data.status,currentStep:u.data.currentStep,slug:u.data.slug,topic:u.data.topic,runDir:u.data.runDir}:null,allRoots:n().map(e=>e.replaceAll(`\\`,`/`)),discoveredRepos:(()=>{let e=(t.allRoots?.length?t.allRoots:[i()]).map(e=>e.replaceAll(`\\`,`/`)),r=n().map(e=>e.replaceAll(`\\`,`/`)).filter(t=>!e.includes(t));return r.length>0?r:void 0})()};return c(JSON.stringify(d,null,2))}catch(e){return a.error(`flow action list failed`,j(e)),c(`Error: ${s(e)}`)}}async function zs(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)return s(`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 r.error(`flow action info failed`,j(e)),s(`Error: ${o(e)}`)}}async function Bs(e,t){let{getAllRoots:n,getFlows:r,log:i,toErrorText:a,toTextResponse:o}=t,{flow:s,status:c}=e;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)});return a.length===0?o(`No flow runs found.`):o(JSON.stringify(a,null,2))}catch(e){return i.error(`flow action runs failed`,j(e)),o(`Error: ${a(e)}`)}}function Vs(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 Hs(e,t,n){let r=Es(e,t),i=V(`flow`);e.registerTool(`flow`,{title:i.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:i.annotations,inputSchema:{action:N.enum([`list`,`info`,`start`,`step`,`status`,`reset`,`read`,`runs`,`add`,`remove`,`update`]).describe(`The flow operation to perform.`),name:N.string().optional().describe(`Flow name — required for info, start, remove, update. Optional override for add.`),topic:N.string().optional().describe(`Human-readable topic for the run (used by start).`),roots:N.array(N.string()).optional().describe(`Workspace roots participating in this flow (used by start).`),advance:N.enum([`next`,`skip`,`redo`]).optional().describe(`Step navigation action — required for step.`),step:N.string().optional().describe(`Step id or name to read (used by read). Defaults to current step.`),source:N.string().optional().describe(`Git URL, local path, or "openspec" shorthand — required for add.`),token:N.string().optional().describe(`Auth token for private repos (used by add).`),filter_flow:N.string().optional().describe(`Filter runs by flow name (used by runs).`),filter_status:N.string().optional().describe(`Filter runs by status: active, completed, abandoned (used by runs).`)}},async e=>{switch(e.action){case`list`:return Rs(r);case`info`:return e.name?zs({name:e.name},r):r.toTextResponse(`Missing required parameter: name`);case`start`:{if(!e.name)return r.toTextResponse(`Missing required parameter: name (flow to start)`);let t=await Ps({flow:e.name,topic:e.topic,roots:e.roots},r),i=Vs(t);return i&&n&&n(i),t}case`step`:return e.advance?Ls({action:e.advance},r):r.toTextResponse(`Missing required parameter: advance (next/skip/redo)`);case`status`:{let e=await Fs(r);return n&&n(Vs(e)),e}case`reset`:{let e=await Is(r);return n&&n(null),e}case`read`:return Ds({step:e.step},r);case`runs`:return Bs({flow:e.filter_flow,status:e.filter_status},r);case`add`:return e.source?js({source:e.source,name:e.name,token:e.token},r):r.toTextResponse(`Missing required parameter: source`);case`remove`:return e.name?Ms({name:e.name},r):r.toTextResponse(`Missing required parameter: name`);case`update`:return e.name?Ns({name:e.name},r):r.toTextResponse(`Missing required parameter: name`);default:return r.toTextResponse(`Unknown action: ${e.action}`)}})}const Us=k(`tools`);function Ws(e){let t=V(`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:N.enum([`create`,`add`,`update`,`get`,`gate`,`list`,`delete`]).describe(`Operation to perform`),task_id:N.string().optional().describe(`Task identifier (required for all except list)`),tier:N.enum([`floor`,`standard`,`critical`]).optional().describe(`FORGE tier (required for create)`),claim:N.string().optional().describe(`Critical-path claim text (for add)`),status:N.enum([`V`,`A`,`U`]).optional().describe(`Evidence status: V=Verified, A=Assumed, U=Unresolved`),receipt:N.string().optional().describe(`Evidence receipt: tool→ref for V, reasoning for A, attempts for U`),id:N.number().optional().describe(`Entry ID (for update)`),critical_path:N.boolean().default(!0).describe(`Whether this claim is on the critical path`),unknown_type:N.enum([`contract`,`convention`,`freshness`,`runtime`,`data-flow`,`impact`]).optional().describe(`Typed unknown classification`),safety_gate:N.enum([`provenance`,`commitment`,`coverage`]).optional().describe(`Safety gate tag: provenance (claim→evidence), commitment (user-approved), coverage (nothing dropped)`),retry_count:N.number().default(0).describe(`Retry count for gate evaluation (0 = first attempt)`),max_retries:N.number().int().min(0).optional().describe(`Maximum retries before escalating. Default: 3`),timeout_action:N.enum([`iterate`,`retry`,`manual`,`terminate`]).optional().describe(`Action to take when gate retries are exhausted. Default: manual`),cwd:N.string().optional().describe(`Working directory for evidence map storage (default: server cwd). Use root_path from forge_ground to match.`)},annotations:t.annotations},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 Ne({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=Ne({action:`add`,taskId:t,claim:r,status:i,receipt:a??``,criticalPath:s,unknownType:c,safetyGate:l},p),n=[`Added entry #${e.entry?.id} to "${t}": [${i}] ${r}`];return e.formattedMap&&n.push(``,e.formattedMap),{content:[{type:`text`,text:n.join(`
|
|
165
165
|
`)}]}}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=Ne({action:`update`,taskId:t,id:o,status:i,receipt:a??``},p),n=[`Updated entry #${o} in "${t}" → ${i}`];return e.formattedMap&&n.push(``,e.formattedMap),{content:[{type:`text`,text:n.join(`
|
|
166
166
|
`)}]}}case`get`:{if(!t)throw Error(`task_id required for get`);let e=Ne({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(`
|
|
167
167
|
`)}]}:{content:[{type:`text`,text:`Evidence map "${t}" not found.`}]}}case`gate`:{if(!t)throw Error(`task_id required for gate`);let e=Ne({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(`
|
|
168
168
|
`)}]}}case`list`:{let e=Ne({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(`
|
|
169
|
-
`)}]}}case`delete`:if(!t)throw Error(`task_id required for delete`);return{content:[{type:`text`,text:Ne({action:`delete`,taskId:t},p).deleted?`Deleted evidence map "${t}".`:`Evidence map "${t}" not found.`}]}}}catch(e){return
|
|
170
|
-
`)}]}}catch(e){return
|
|
171
|
-
`)}]}}catch(e){return
|
|
172
|
-
`)}]}}catch(e){return
|
|
173
|
-
`)}]}}catch(e){return
|
|
169
|
+
`)}]}}case`delete`:if(!t)throw Error(`task_id required for delete`);return{content:[{type:`text`,text:Ne({action:`delete`,taskId:t},p).deleted?`Deleted evidence map "${t}".`:`Evidence map "${t}" not found.`}]}}}catch(e){return Us.error(`Evidence map error`,j(e)),W(`INTERNAL`,`Evidence map error: ${e instanceof Error?e.message:String(e)}`)}})}function Gs(e,t){let n=V(`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:N.array(N.object({id:N.string().describe(`Source identifier (e.g., "phase-2-handoff")`),text:N.string().max(5e5).describe(`Source text to compress`),weight:N.number().min(0).default(1).describe(`Priority weight (higher = more budget)`)})).min(1).max(20).describe(`Text sources to compress`),query:N.string().describe(`Focus query — what matters for the next step?`),max_chars:N.number().min(100).max(5e4).default(4e3).describe(`Target budget in characters`),pin_fields:N.array(N.string()).optional().describe(`Key fields to always extract (default: status, files, decisions, blockers, next)`),segmentation:N.enum([`paragraph`,`sentence`,`line`]).default(`paragraph`).describe(`How to split text for scoring`),token_budget:N.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 ke(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(`
|
|
170
|
+
`)}]}}catch(e){return Us.error(`Digest failed`,j(e)),W(`INTERNAL`,`Digest failed: ${e instanceof Error?e.message:String(e)}`)}})}function Ks(e){let t=V(`forge_classify`);e.registerTool(`forge_classify`,{title:t.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:N.array(N.string()).min(1).max(100).describe(`Files being modified (paths)`),task:N.string().describe(`Task description`),root_path:N.string().describe(`Root path of the codebase`)},annotations:t.annotations},async({files:e,task:t,root_path:n})=>{try{let r=await Re({files:e,task:t,rootPath:n}),i=[`## FORGE Classification: **${r.tier.toUpperCase()}**`,``];if(r.triggers.length>0){i.push(`### Triggers`);for(let e of r.triggers)i.push(`- **${e.rule}** (${e.source}): ${e.detail}`);i.push(``)}if(r.packagesCrossed.length>0&&i.push(`**Packages crossed:** ${r.packagesCrossed.join(`, `)}`),r.typedUnknownSeeds.length>0){i.push(``,`### Typed Unknown Seeds`);for(let e of r.typedUnknownSeeds)i.push(`- [${e.type}] ${e.description} → use \`${e.suggestedTool}\``)}i.push(``,`### Ceremony`);let a=r.ceremony;return i.push(`- **Ground:** ${a.ground}`,`- **Build:** ${a.build}`,`- **Break:** ${a.break}`,`- **Evidence Map:** ${a.evidenceMap}`,`- **Gate:** ${a.gate}`),i.push(``,`---`,`_Next: ${r.tier===`floor`?`Proceed directly to implementation.`:"Run `forge_ground` to execute the full Ground phase."}_`),{content:[{type:`text`,text:i.join(`
|
|
171
|
+
`)}]}}catch(e){return Us.error(`FORGE classify failed`,j(e)),W(`INTERNAL`,`FORGE classify failed: ${e instanceof Error?e.message:String(e)}`)}})}function qs(e,t,n){let r=V(`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:N.array(N.string()).min(1).max(50).describe(`Absolute file paths to generate cards for`),query:N.string().describe(`Current task query — guides relevance scoring`),tier:N.enum([`T1`,`T2`]).default(`T1`).describe(`Card tier: T1 = structural only, T2 = T1 + compressed content`),max_content_chars:N.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 zt(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(`
|
|
172
|
+
`)}]}}catch(e){return Us.error(`STRATUM cards failed`,j(e)),W(`INTERNAL`,`STRATUM cards failed: ${e instanceof Error?e.message:String(e)}`)}})}function Js(e,t,n){let r=V(`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:N.string().describe(`Task description`),files:N.array(N.string()).min(1).max(100).describe(`Target files being modified (absolute paths)`),root_path:N.string().describe(`Root path of the codebase`),max_constraints:N.number().min(0).max(10).default(3).describe(`Max constraint entries to load from AI Kit memory`),force_tier:N.enum([`floor`,`standard`,`critical`]).optional().describe(`Force a specific tier (skips auto-classification)`),task_id:N.string().optional().describe(`Custom task ID for evidence map (auto-generated if omitted)`)},annotations:r.annotations},async({task:e,files:r,root_path:i,max_constraints:a,force_tier:o,task_id:s},c)=>{try{let l=await ze(t,n,{task:e,files:r,rootPath:i,maxConstraints:a,forceTier:o,taskId:s}),u=ao(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(`
|
|
173
|
+
`)}]}}catch(e){return Us.error(`FORGE Ground failed`,j(e)),W(`INTERNAL`,`FORGE Ground failed: ${e instanceof Error?e.message:String(e)}`)}})}const Ys=k(`tools`),Xs=N.object({id:N.string().optional().describe(`Node ID (auto-generated if omitted)`),type:N.string().describe(`Node type (entity, service, api, concept, decision)`),name:N.string().describe(`Display name`),properties:N.record(N.string(),N.unknown()).optional().describe(`Arbitrary properties`),sourceRecordId:N.string().optional().describe(`Back-link to knowledge record ID`),sourcePath:N.string().optional().describe(`Source file path`)}),Zs=N.object({id:N.string().optional().describe(`Edge ID (auto-generated if omitted)`),fromId:N.string().describe(`Source node ID`),toId:N.string().describe(`Target node ID`),type:N.string().describe(`Relationship type (depends-on, implements, calls, affects)`),weight:N.number().min(0).max(1).optional().describe(`Relationship weight`),properties:N.record(N.string(),N.unknown()).optional().describe(`Arbitrary properties`)});function Qs(e,t){let n=V(`graph`);e.registerTool(`graph`,{title:n.title,description:`Query the auto-populated code knowledge graph (modules, symbols, imports) to answer
|
|
174
174
|
structural questions vector search cannot.
|
|
175
175
|
|
|
176
176
|
Common flow (when you don't have a node_id yet — TWO STEPS):
|
|
@@ -189,7 +189,7 @@ Single-step read actions:
|
|
|
189
189
|
Mutating actions (use deliberately): add, delete, clear, set_community,
|
|
190
190
|
detect_communities, trace_process, delete_process.
|
|
191
191
|
|
|
192
|
-
Complements: \`symbol\` (single lookup), \`trace\` (call-chain AST), \`blast_radius\` (change impact).`,outputSchema:ga,inputSchema:{action:N.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:N.string().optional().describe(`Node type filter (for find_nodes)`),name_pattern:N.string().optional().describe(`Name substring match (for find_nodes)`),source_path:N.string().optional().describe(`Source path filter`),node_id:N.string().optional().describe(`Node ID (for neighbors, traverse, delete)`),edge_type:N.string().optional().describe(`Edge type filter`),from_id:N.string().optional().describe(`Source node ID (for find_edges)`),to_id:N.string().optional().describe(`Target node ID (for find_edges)`),direction:N.enum([`outgoing`,`incoming`,`both`]).default(`both`).describe(`Traversal direction`),max_depth:N.number().min(1).max(5).default(2).describe(`Max traversal depth`),limit:N.number().min(1).max(100).default(50).describe(`Max results`),nodes:N.array(
|
|
192
|
+
Complements: \`symbol\` (single lookup), \`trace\` (call-chain AST), \`blast_radius\` (change impact).`,outputSchema:ga,inputSchema:{action:N.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:N.string().optional().describe(`Node type filter (for find_nodes)`),name_pattern:N.string().optional().describe(`Name substring match (for find_nodes)`),source_path:N.string().optional().describe(`Source path filter`),node_id:N.string().optional().describe(`Node ID (for neighbors, traverse, delete)`),edge_type:N.string().optional().describe(`Edge type filter`),from_id:N.string().optional().describe(`Source node ID (for find_edges)`),to_id:N.string().optional().describe(`Target node ID (for find_edges)`),direction:N.enum([`outgoing`,`incoming`,`both`]).default(`both`).describe(`Traversal direction`),max_depth:N.number().min(1).max(5).default(2).describe(`Max traversal depth`),limit:N.number().min(1).max(100).default(50).describe(`Max results`),nodes:N.array(Xs).max(500).optional().describe(`Nodes to add (for action=add)`),edges:N.array(Zs).max(500).optional().describe(`Edges to add (for action=add)`),community:N.string().optional().describe(`Community label (for set_community, cohesion)`),process_id:N.string().optional().describe(`Process ID (for delete_process)`),label:N.string().optional().describe(`Label for process tracing (for trace_process)`)},annotations:n.annotations},async e=>{try{let n=await Ue(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}),r=[n.summary];if(n.nodes&&n.nodes.length>0){r.push(`
|
|
193
193
|
### Nodes`);for(let e of n.nodes){let t=Object.keys(e.properties).length>0?` — ${JSON.stringify(e.properties)}`:``;r.push(`- **${e.name}** (${e.type}, id: \`${e.id}\`)${t}`)}}if(n.edges&&n.edges.length>0){r.push(`
|
|
194
194
|
### Edges`);for(let e of n.edges)r.push(`- \`${e.fromId}\` —[${e.type}]→ \`${e.toId}\`${e.weight===1?``:` (weight: ${e.weight})`}`)}if(n.stats&&(r.push(`\nNode types: ${JSON.stringify(n.stats.nodeTypes)}`),r.push(`Edge types: ${JSON.stringify(n.stats.edgeTypes)}`)),n.validation){if(r.push(`
|
|
195
195
|
### Validation`),r.push(`- **Valid**: ${n.validation.valid?`yes`:`no`}`),n.validation.danglingEdges.length>0){r.push(`- **Dangling edges**:`);for(let e of n.validation.danglingEdges)r.push(` - \`${e.edgeId}\` references missing node \`${e.missingNodeId}\``)}n.validation.orphanNodes.length>0&&r.push(`- **Orphan nodes**: ${n.validation.orphanNodes.map(e=>`\`${e}\``).join(`, `)}`)}if(n.communities){r.push(`
|
|
@@ -198,38 +198,38 @@ Complements: \`symbol\` (single lookup), \`trace\` (call-chain AST), \`blast_rad
|
|
|
198
198
|
### Processes`);for(let e of n.processes)r.push(`- **${e.label}** (id: \`${e.id}\`) — ${e.steps.length} step(s)`)}if(n.depthGroups){r.push(`
|
|
199
199
|
### Depth Groups`);for(let[e,t]of Object.entries(n.depthGroups))r.push(`- **Depth ${e}**: ${t.map(e=>`${e.name} (${e.type})`).join(`, `)}`)}if(n.cohesionScore!==void 0&&r.push(`\n**Cohesion Score**: ${(n.cohesionScore*100).toFixed(1)}%`),n.symbol360){let e=n.symbol360;r.push(`
|
|
200
200
|
### 360° Symbol View`),r.push(`- **Node**: ${e.node.name} (${e.node.type})`),r.push(`- **Community**: ${e.community??`none`}`),r.push(`- **Incoming**: ${e.incoming.length} edge(s)`),r.push(`- **Outgoing**: ${e.outgoing.length} edge(s)`),r.push(`- **Processes**: ${e.processes.length}`)}return r.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._"),{content:[{type:`text`,text:r.join(`
|
|
201
|
-
`)}],structuredContent:{nodes:(n.nodes??[]).map(e=>({id:e.id,name:e.name,type:e.type,...e.sourcePath?{sourcePath:e.sourcePath}:{}})),edges:(n.edges??[]).map(e=>({fromId:e.fromId,toId:e.toId,type:e.type})),totalNodes:n.stats?.nodeCount??n.nodes?.length??0,totalEdges:n.stats?.edgeCount??n.edges?.length??0,query:e.action}}}catch(e){return
|
|
202
|
-
`)};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)
|
|
201
|
+
`)}],structuredContent:{nodes:(n.nodes??[]).map(e=>({id:e.id,name:e.name,type:e.type,...e.sourcePath?{sourcePath:e.sourcePath}:{}})),edges:(n.edges??[]).map(e=>({fromId:e.fromId,toId:e.toId,type:e.type})),totalNodes:n.stats?.nodeCount??n.nodes?.length??0,totalEdges:n.stats?.edgeCount??n.edges?.length??0,query:e.action}}}catch(e){return Ys.error(`Graph query failed`,j(e)),W(`INTERNAL`,`Graph query failed: ${e instanceof Error?e.message:String(e)}`)}})}const $s=k(`tools:infra`);function ec(e){let t=V(`process`);e.registerTool(`process`,{title:t.title,description:`Start, stop, inspect, list, and tail logs for in-memory managed child processes.`,inputSchema:{action:N.enum([`start`,`stop`,`status`,`list`,`logs`]).describe(`Process action to perform`),id:N.string().optional().describe(`Managed process ID`),command:N.string().optional().describe(`Executable to start`),args:N.array(N.string()).optional().describe(`Arguments for start actions`),tail:N.number().min(1).max(500).optional().describe(`Log lines to return for logs actions`)},annotations:t.annotations},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(st(t,n,r??[]))}]};case`stop`:if(!t)throw Error(`id is required for stop`);return{content:[{type:`text`,text:JSON.stringify(lt(t)??null)}]};case`status`:if(!t)throw Error(`id is required for status`);return{content:[{type:`text`,text:JSON.stringify(ct(t)??null)}]};case`list`:return{content:[{type:`text`,text:JSON.stringify(at())}]};case`logs`:if(!t)throw Error(`id is required for logs`);return{content:[{type:`text`,text:JSON.stringify(ot(t,i))}]}}}catch(e){return $s.error(`Process action failed`,j(e)),W(`INTERNAL`,`Process action failed: ${e instanceof Error?e.message:String(e)}`)}})}function tc(e){let t=V(`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:N.enum([`start`,`stop`,`list`]).describe(`Watch action to perform`),path:N.string().optional().describe(`Directory path to watch for start actions`),id:N.string().optional().describe(`Watcher ID for stop actions`)},annotations:t.annotations},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(qt({path:t}))}]};case`stop`:if(!n)throw Error(`id is required for stop`);return{content:[{type:`text`,text:JSON.stringify({stopped:Jt(n)})}]};case`list`:return{content:[{type:`text`,text:JSON.stringify(Kt())}]}}}catch(e){return $s.error(`Watch action failed`,j(e)),W(`INTERNAL`,`Watch action failed: ${e instanceof Error?e.message:String(e)}`)}})}function nc(e){let t=V(`health`);e.registerTool(`health`,{title:t.title,description:`Run project health checks — verifies package.json, tsconfig, scripts, lockfile, README, LICENSE, .gitignore.`,outputSchema:Zi,inputSchema:{path:N.string().optional().describe(`Root directory to check (defaults to cwd)`)},annotations:t.annotations},async({path:e})=>{try{let t=Ge(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 $s.error(`Health check failed`,j(e)),W(`INTERNAL`,`Health check failed: ${e instanceof Error?e.message:String(e)}`)}})}function rc(e){let t=V(`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:N.array(N.string().url()).min(1).max(10).describe('URLs to fetch (1–10). Single URL: `["https://..."]`. Multiple fetched in parallel.'),mode:N.enum([`markdown`,`raw`,`links`,`outline`]).default(`markdown`).describe(`Output mode: markdown (clean content), raw (HTML), links (extracted URLs), outline (heading hierarchy)`),selector:N.string().optional().describe(`CSS selector to extract a specific element instead of auto-detecting main content`),max_length:N.number().min(500).max(1e5).default(15e3).describe(`Max characters in output — truncates at paragraph boundaries`),include_metadata:N.boolean().default(!0).describe(`Include page title, description, and URL as a header`),include_links:N.boolean().default(!1).describe(`Append extracted links list at the end`),include_images:N.boolean().default(!1).describe(`Include image alt texts inline`),timeout:N.number().min(1e3).max(12e4).default(3e4).describe(`Request timeout in milliseconds`)},annotations:t.annotations},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 Yt({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(`
|
|
202
|
+
`)};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)?$s.warn(`Web fetch failed`,{error:t}):$s.error(`Web fetch failed`,j(e)),{...W(`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)?$s.warn(`Web fetch failed`,{url:c[e],error:n}):$s.error(`Web fetch failed`,{url:c[e],...j(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(`
|
|
203
203
|
|
|
204
|
-
`);return p===d.length?W(`INTERNAL`,h):{content:[{type:`text`,text:h}]}})}function
|
|
205
|
-
`)}]}}catch(e){return
|
|
204
|
+
`);return p===d.length?W(`INTERNAL`,h):{content:[{type:`text`,text:h}]}})}function ic(e,t){let n=V(`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:N.string().describe(`What you want to accomplish (e.g., "audit this monorepo", "fix a failing test")`),max_recommendations:N.number().min(1).max(10).default(5).describe(`Maximum number of tool recommendations`)},annotations:n.annotations},async({goal:e,max_recommendations:n})=>{try{let r=We(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(`
|
|
205
|
+
`)}]}}catch(e){return $s.error(`Guide failed`,j(e)),W(`INTERNAL`,`Guide failed: ${e instanceof Error?e.message:String(e)}`)}})}const ac={decision:6,pattern:5,"file-card":4,analysis:3,"search-result":2,"step-summary":1},oc={implementer:{name:`implementer`,contextTypes:[`file-card`,`decision`,`pattern`],priority:{...ac}},documenter:{name:`documenter`,contextTypes:[`decision`,`pattern`,`step-summary`],priority:{...ac}},reviewer:{name:`reviewer`,contextTypes:[`file-card`,`search-result`,`decision`,`pattern`,`step-summary`,`analysis`],priority:{...ac}},researcher:{name:`researcher`,contextTypes:[`search-result`,`decision`,`analysis`],priority:{...ac}},debugger:{name:`debugger`,contextTypes:[`file-card`,`search-result`,`pattern`,`analysis`],priority:{...ac}}};function sc(e){return oc[e]}function cc(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=e.content.length;o+t>n||(a.push(e),o+=t)}return a}function lc(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 uc(e){let t=new Set,n=[];for(let r of e){let e=lc(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 dc(e){if(e.startsWith(`.ai/curated/`))return e.slice(12)}const fc=k(`tools`),pc=N.enum([`remember`,`read`,`update`,`forget`,`list`,`history`,`diff`,`recover`,`orphaned`,`withdraw`,`flush`]),mc=N.string().min(3).max(120).describe(`Short descriptive title for the knowledge entry`),hc=N.string().min(10).max(1e5),gc=N.string().regex(/^[a-z][a-z0-9-]*$/).describe(`Category slug (e.g., "decisions", "patterns", "conventions", "api-contracts")`),_c=N.array(N.string()).default([]).describe(`Optional tags for filtering`),vc=N.string().describe(`Relative path within .ai/curated/ (e.g., "decisions/use-lancedb.md")`),yc=N.string().min(3),bc=N.object({title:mc,content:hc.describe(`The markdown content to store`),category:gc,tags:_c}),xc=N.object({path:vc}),Sc=N.object({path:vc,content:hc.describe(`New markdown content to replace existing content`),reason:yc.max(1e3).describe(`Why this update is being made (recorded in changelog)`)}),Cc=N.object({path:N.string().describe(`Relative path within .ai/curated/ (e.g., "decisions/deprecated-approach.md")`),reason:yc.describe(`Why this entry is being removed`)}),wc=N.object({category:N.string().optional().describe(`Filter by category (e.g., "decisions", "patterns")`),tag:N.string().optional().describe(`Filter by tag`)}),Tc=N.object({action:pc.describe(`Knowledge operation to perform`),title:mc.optional(),content:hc.optional(),category:gc.optional(),tags:N.array(N.string()).optional().describe(`Optional tags for remember`),path:vc.optional(),reason:yc.max(1e3).optional(),scope:N.enum([`curated`,`flow`]).optional().describe(`Storage scope: curated (default) or flow-scoped ephemeral context`),profile:N.string().optional().describe(`Role profile for withdraw filtering (e.g., "implementer", "reviewer", "debugger")`),budget:N.number().int().min(100).max(5e4).optional().describe(`Maximum character budget for withdraw results (default: 6000)`),tag:N.string().optional().describe(`Filter by tag when action="list"`),limit:N.number().int().min(1).max(100).optional().describe(`Maximum history entries to return (for action="history", default: 20)`),from_sha:N.string().optional().describe(`Start SHA for diff (older version). If omitted with to_sha, shows full content.`),to_sha:N.string().optional().describe(`End SHA for diff (newer version). If omitted, uses the latest two versions.`)}),Ec={decisions:`decision`,patterns:`pattern`,conventions:`pattern`,context:`analysis`,session:`step-summary`},Dc=new Set([`decision`,`pattern`,`file-card`,`analysis`,`search-result`,`step-summary`]);function Oc(e){if(!e)return`analysis`;let t=Ec[e]??e;return Dc.has(t)?t:`analysis`}function kc(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.`}async function Ac(e,t){if(e.scope===`flow`){let{flowContextAdapter:n}=t;if(!n)return{content:[{type:`text`,text:`Flow context not available.`}]};let{title:r,content:i,category:a}=bc.parse(e),o=`${Oc(a)}/${r.toLowerCase().replace(/[^a-z0-9]+/g,`-`).slice(0,60)}.md`;return await n.write(o,`# ${r}\n\n${i}`),{content:[{type:`text`,text:`Deposited flow context: **${r}** at \`${o}\``}]}}let{curated:n,policyStore:r,evolutionCollector:i,resourceNotifier:a}=t,{title:o,content:s,category:c,tags:l}=bc.parse(e),u=await n.remember(o,s,c,l),d=``;if(r){let e=r.classify(o,s,l);i&&i.recordClassification(o,e.matchingRules.map(e=>e.ruleId),e.pushRecommended),e.matchingRules.length>0&&(d=`\n\n### Classification Signals\n${e.matchingRules.map(e=>` - **${e.ruleId}** (${e.category}, weight: ${e.pushWeight}) — matched: ${e.matchedPatterns.join(`, `)}`).join(`
|
|
206
206
|
`)}\n- **Push recommended**: ${e.pushRecommended?`yes`:`no`} (max weight: ${e.maxPushWeight})`,e.pushRecommended&&(d+=`
|
|
207
207
|
|
|
208
|
-
> 💡 This entry matches push rules. Consider \`er_push\` to share with Enterprise RAG.`))}a&&a.notifyAfterCuratedWrite(u.path).catch(()=>{});let f=
|
|
209
|
-
`),a=
|
|
210
|
-
`);return{content:[{type:`text`,text:`## Flow Context (${e.length} entries)\n\n${t}`}]}}let{category:r,tag:i}=
|
|
211
|
-
`),c=
|
|
212
|
-
`);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
|
|
213
|
-
`);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
|
|
208
|
+
> 💡 This entry matches push rules. Consider \`er_push\` to share with Enterprise RAG.`))}a&&a.notifyAfterCuratedWrite(u.path).catch(()=>{});let f=lc(u.path,o,`[${c}]`);return{content:[{type:`text`,text:`Remembered: **${o}**\n\nStored at \`.ai/curated/${u.path}\` and indexed for semantic search.${d}\n\n---\n_Next: Use \`search\` to verify the entry is findable, or \`knowledge({ action: "list" })\` to see all curated entries._`},...f?[f]:[]]}}async function jc(e,{curated:t}){let{path:n}=xc.parse(e),r=await t.read(n),i=[`## ${r.title}`,`- **Path**: .ai/curated/${n}`,`- **Category**: ${r.category}`,r.tags.length?`- **Tags**: ${r.tags.join(`, `)}`:null,`- **Version**: ${r.version}`,`- **Created**: ${r.created}`,r.updated===r.created?null:`- **Updated**: ${r.updated}`,``].filter(e=>e!==null).join(`
|
|
209
|
+
`),a=lc(n,r.title,`[${r.category}]`);return{content:[{type:`text`,text:`${i}\n${r.content}\n\n---\n_Next: Use \`knowledge({ action: "update", ... })\` to modify this entry, or \`search\` to find related entries._`},...a?[a]:[]]}}async function Mc(e,{curated:t,resourceNotifier:n}){let{path:r,content:i,reason:a}=Sc.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 Nc(e,{curated:t,resourceNotifier:n}){let{path:r,reason:i}=Cc.parse(e),a=b(process.cwd(),C.aiCurated,r);if(o(a))try{Ce(`forget`,[{path:a,content:c(a,`utf-8`)}],`forget: ${r}`)}catch{}let s=await t.forget(r,i);return fc.info(`Forgot entry`,{path:s.path,reason:i}),n&&(n.notifyAfterCuratedWrite().catch(()=>{}),n.notifyResourceListChanged().catch(()=>{})),{content:[{type:`text`,text:`Forgotten: \`.ai/curated/${s.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 Pc(e,{curated:t,flowContextAdapter:n}){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=>`- \`${e.path}\` (${e.size} bytes)`).join(`
|
|
210
|
+
`);return{content:[{type:`text`,text:`## Flow Context (${e.length} entries)\n\n${t}`}]}}let{category:r,tag:i}=wc.parse(e),a=await t.list({category:r,tag:i}),o={entries:a.map(e=>({path:e.path,title:e.title,category:e.category,tags:e.tags,version:e.version,preview:e.contentPreview?.slice(0,120)??``})),totalCount:a.length};if(a.length===0)return{content:[{type:`text`,text:`No curated knowledge entries found.`+(r?` (category: ${r})`:``)+(i?` (tag: ${i})`:``)}],structuredContent:o};let s=a.map(e=>{let t=e.tags.length>0?` [${e.tags.join(`, `)}]`:``;return`- **${e.title}** (v${e.version})${t}\n \`${e.path}\` — ${e.contentPreview.slice(0,80)}…`}).join(`
|
|
211
|
+
`),c=uc(a);return{content:[{type:`text`,text:`## Curated Knowledge (${a.length} entries)\n\n${s}\n\n---\n_Next: Use \`knowledge({ action: "read", path: "..." })\` to view full content of any entry, or \`knowledge({ action: "remember", ... })\` to store new knowledge._`},...c],structuredContent:o}}async function Fc(e,{curated:t}){let{path:n}=xc.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(`
|
|
212
|
+
`);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 Ic(e,{curated:t}){let{path:n}=xc.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 Lc(e,{curated:t}){let{path:n}=xc.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 Rc(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(`
|
|
213
|
+
`);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 zc(e,{flowContextAdapter:t}){let n=N.object({profile:N.string(),budget:N.number().int().min(100).max(5e4).default(6e3)}).parse(e);if(!t)return{content:[{type:`text`,text:`Flow context not available — no active flow or adapter not configured.`}]};let r=sc(n.profile);if(!r)return{content:[{type:`text`,text:`Unknown profile: "${n.profile}". Available: implementer, documenter, reviewer, researcher, debugger`}]};let i=await t.list();if(i.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 a=(await Promise.all(i.map(async e=>{let n=e.path.split(`/`),r=n[0];if(n.length<2||!Dc.has(r))return null;let i=await t.read(e.path);return i?{type:r,content:i}:null}))).filter(e=>e!==null),o=cc(a,r,n.budget);if(o.length===0)return{content:[{type:`text`,text:`No relevant context for profile "${n.profile}". ${a.length} entries available but none match your role's context types.`}]};let s=o.map(e=>`### [${e.type}]\n${e.content}`).join(`
|
|
214
214
|
|
|
215
|
-
`),c=o.reduce((e,t)=>e+t.content.length,0);return{content:[{type:`text`,text:`## Flow Context (${o.length}/${a.length} entries, ${c} chars, profile: ${n.profile})\n\n${s}`}]}}async function
|
|
215
|
+
`),c=o.reduce((e,t)=>e+t.content.length,0);return{content:[{type:`text`,text:`## Flow Context (${o.length}/${a.length} entries, ${c} chars, profile: ${n.profile})\n\n${s}`}]}}async function Bc(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 Vc(e,t,n){switch(e){case`remember`:return Ac(t,n);case`read`:return jc(t,n);case`update`:return Mc(t,n);case`forget`:return Nc(t,n);case`list`:return Pc(t,n);case`history`:return Fc(t,n);case`diff`:return Ic(t,n);case`recover`:return Lc(t,n);case`orphaned`:return Rc(t,n);case`withdraw`:return zc(t,n);case`flush`:return Bc(t,n)}}function Hc(e,t,n,r,i,a){let o=V(`knowledge`),s={curated:t,policyStore:n,evolutionCollector:r,resourceNotifier:i,flowContextAdapter:a};e.registerTool(`knowledge`,{title:o.title,description:"Operate on curated knowledge entries with a single tool. Use `action` to remember, read, update, forget, list, history, diff, recover, orphaned, withdraw, or flush entries.",inputSchema:Tc.shape,annotations:o.annotations},async({action:e,...t})=>{try{let n=Tc.parse({action:e,...t});return await Vc(n.action,n,s)}catch(e){return e instanceof N.ZodError?W(`VALIDATION`,kc(e)):(fc.error(`Knowledge operation failed`,j(e)),W(`INTERNAL`,`Knowledge operation failed: ${e instanceof Error?e.message:String(e)}`))}})}const Uc=k(`tools`);function Wc(e,t,n){let r=V(`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:N.string().describe(`Relative file path to look up (e.g., "src/index.ts")`),enrich:N.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},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(`
|
|
216
216
|
|
|
217
|
-
`),s=
|
|
218
|
-
`).replace(/\\t/g,` `)}))}]}}catch(e){return
|
|
219
|
-
`)}function
|
|
220
|
-
`)}const
|
|
217
|
+
`),s=dc(e),c=s?lc(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 H(n,{query:e});l+=U(t)}return{content:[{type:`text`,text:l},...c?[c]:[]]}}catch(e){return Uc.error(`Lookup failed`,j(e)),W(`INTERNAL`,`Lookup failed: ${e instanceof Error?e.message:String(e)}`)}})}const Gc=k(`tools:manipulation`);function Kc(e){let t=V(`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:N.string().optional().describe(`Repository root or working directory`),commit_count:N.number().min(1).max(50).default(5).optional().describe(`How many recent commits to include`),include_diff:N.boolean().default(!1).optional().describe(`Include diff stat for working tree changes`)},annotations:t.annotations,outputSchema:ya},async({cwd:e,commit_count:t,include_diff:n})=>{try{let r=await Ve({cwd:e,commitCount:t,includeDiff:n});return{content:[{type:`text`,text:Zc(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 Gc.error(`Git context failed`,j(e)),W(`INTERNAL`,`Git context failed: ${e instanceof Error?e.message:String(e)}`)}})}function qc(e){let t=V(`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:N.string().max(1e6).describe(`Raw unified diff text`)},annotations:t.annotations},async({diff:e})=>{try{return{content:[{type:`text`,text:Qc(Oe({diff:e.replace(/\\n/g,`
|
|
218
|
+
`).replace(/\\t/g,` `)}))}]}}catch(e){return Gc.error(`Diff parse failed`,j(e)),W(`INTERNAL`,`Diff parse failed: ${e instanceof Error?e.message:String(e)}`)}})}function Jc(e){let t=V(`rename`);e.registerTool(`rename`,{title:t.title,description:`Rename a symbol across files using whole-word regex matching for exports, imports, and general usage references.`,inputSchema:{old_name:N.string().describe(`Existing symbol name to replace`),new_name:N.string().describe(`New symbol name to use`),root_path:N.string().describe(`Root directory to search within`),extensions:N.array(N.string()).optional().describe(`Optional file extensions to include, such as .ts,.tsx,.js,.jsx`),dry_run:N.boolean().default(!0).describe(`Preview changes without writing files`)},annotations:t.annotations},async({old_name:e,new_name:t,root_path:n,extensions:r,dry_run:i})=>{try{let a=await Ct({oldName:e,newName:t,rootPath:n,extensions:r,dryRun:i});return{content:[{type:`text`,text:JSON.stringify(a)}]}}catch(e){return Gc.error(`Rename failed`,j(e)),W(`INTERNAL`,`Rename failed: ${e instanceof Error?e.message:String(e)}`)}})}function Yc(e){let t=V(`codemod`);e.registerTool(`codemod`,{title:t.title,description:`Apply regex-based codemod rules across files and return structured before/after changes for each affected line.`,inputSchema:{root_path:N.string().describe(`Root directory to transform within`),rules:N.array(N.object({description:N.string().describe(`What the codemod rule does`),pattern:N.string().describe(`Regex pattern in string form`),replacement:N.string().describe(`Replacement string with optional capture groups`)})).min(1).describe(`Codemod rules to apply`),dry_run:N.boolean().default(!0).describe(`Preview changes without writing files`)},annotations:t.annotations},async({root_path:e,rules:t,dry_run:n})=>{try{let r=await be({rootPath:e,rules:t,dryRun:n});return{content:[{type:`text`,text:JSON.stringify(r)}]}}catch(e){return Gc.error(`Codemod failed`,j(e)),W(`INTERNAL`,`Codemod failed: ${e instanceof Error?e.message:String(e)}`)}})}function Xc(e){let t=V(`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:N.string().max(5e5).describe(`Input JSON string`),expression:N.string().max(1e4).describe(`Transform expression to apply`)},annotations:t.annotations},async({input:e,expression:t})=>{try{return{content:[{type:`text`,text:we({input:e,expression:t}).outputString}]}}catch(e){return Gc.error(`Data transform failed`,j(e)),W(`INTERNAL`,`Data transform failed: ${e instanceof Error?e.message:String(e)}`)}})}function Zc(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(`
|
|
219
|
+
`)}function Qc(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(`
|
|
220
|
+
`)}const $c=[`list_tools`,`describe_tool`,`search_tools`];function el(e,t,n){let r=[...new Set(n)].sort();e.registerTool(`list_tools`,{title:V(`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:N.string().optional().describe(`Optional category filter`)},annotations:V(`list_tools`).annotations},async({category:e})=>{let t=e?.trim().toLowerCase();return{content:[{type:`text`,text:r.filter(e=>t?(B[e]?.category??[]).some(e=>e.toLowerCase()===t):!0).map(e=>{let t=B[e]??{title:e,category:[]},n=t.category?.join(`, `)||`uncategorized`;return`${e}: ${t.title} [${n}]`}).join(`
|
|
221
221
|
`)||`No tools matched the filter.`}]}}),e.registerTool(`describe_tool`,{title:V(`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:N.string().describe(`The active tool name to describe`)},annotations:V(`describe_tool`).annotations},async({tool_name:e})=>{if(!r.includes(e))return W(`VALIDATION`,`Unknown or inactive tool: ${e}`);let t=B[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:V(`search_tools`).title,description:`Search active AI Kit tools by keyword across tool names, titles, and categories.`,inputSchema:{query:N.string().min(1).describe(`Keyword query to match against active tools`)},annotations:V(`search_tools`).annotations},async({query:e})=>{let t=e.trim().toLowerCase(),n=r.filter(e=>{let n=B[e];return e.toLowerCase().includes(t)||n?.title.toLowerCase().includes(t)||(n?.category??[]).some(e=>e.toLowerCase().includes(t))}).map(e=>{let t=B[e]??{title:e,category:[]},n=t.category?.join(`, `)||`uncategorized`;return`${e}: ${t.title} [${n}]`});return{content:[{type:`text`,text:n.length>0?n.join(`
|
|
222
|
-
`):`No tools found matching "${e}"`}]}})}const
|
|
223
|
-
`);if(c&&a){let e=await H(a,{query:`onboard codebase conventions`});h+=U(e)}return{content:[{type:`text`,text:h}]}}catch(e){return
|
|
224
|
-
`)}]}}case`delete`:if(!t)throw Error(`name required for delete`);return{content:[{type:`text`,text:De(t)?`Deleted workset "${t}".`:`Workset "${t}" not found.`}]};case`add`:{if(!t||!n)throw Error(`name and files required for add`);let e=ce(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=St(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
|
|
225
|
-
`)}]}}case`delete`:if(!t)throw Error(`key required for delete`);return{content:[{type:`text`,text:Ft(t)?`Deleted stash entry "${t}".`:`Stash entry "${t}" not found.`}]};case`clear`:{let e=Pt();return{content:[{type:`text`,text:`Cleared ${e} stash entr${e===1?`y`:`ies`}.`}]}}}}catch(e){return
|
|
226
|
-
`)}]}}case`latest`:{let e=ge();return{content:[{type:`text`,text:e?
|
|
222
|
+
`):`No tools found matching "${e}"`}]}})}const tl=k(`tools`);let nl=!1;async function rl(e,t,n){for(let r of n.steps)if(!(r.status!==`success`||!r.output))try{let i=M(`sha256`).update(n.path).digest(`hex`).slice(0,12),a=`produced/onboard/${r.name}/${i}.md`,o=M(`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:M(`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){tl.warn(`Auto-persist onboard step failed`,{stepName:r.name,...j(e)})}}async function il(e,t,n){if(n.autoRemember?.length)for(let r of n.autoRemember)try{let n=M(`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:M(`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){tl.warn(`Auto-persist remember entry failed`,{title:r.title,...j(e)})}}function al(e,t,n,r,i,a){let o=V(`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:N.string().describe(`Root path of the codebase to onboard`),mode:N.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:N.string().optional().describe(`Custom output directory for generate mode (default: <path>/.ai/context)`),enrich:N.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},async({path:e,mode:o,out_dir:s,enrich:c},l)=>{try{if(nl)return{content:[{type:`text`,text:`Onboard is already running. Please wait for it to complete before starting another.`}]};nl=!0,tl.info(`Starting onboard`,{path:e,mode:o});let u=await rt({path:e,mode:o,outDir:s??r?.onboardDir}),d=ao(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`),rl(t,n,u),u.autoRemember?.length&&il(t,n,u).catch(e=>{tl.warn(`Auto-persist autoRemember failed`,j(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(`
|
|
223
|
+
`);if(c&&a){let e=await H(a,{query:`onboard codebase conventions`});h+=U(e)}return{content:[{type:`text`,text:h}]}}catch(e){return tl.error(`Onboard failed`,j(e)),W(`INTERNAL`,`Onboard failed: ${e instanceof Error?e.message:String(e)}`)}finally{nl=!1}})}const ol=k(`tools:persistence`);function sl(e){let t=V(`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:N.enum([`save`,`get`,`list`,`delete`,`add`,`remove`]).describe(`Operation to perform`),name:N.string().optional().describe(`Workset name (required for all except list)`),files:N.array(N.string()).optional().describe(`File paths (required for save, add, remove)`),description:N.string().optional().describe(`Description (for save)`)},annotations:t.annotations},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=kt(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=Be(t);return e?{content:[{type:`text`,text:JSON.stringify(e)}]}:{content:[{type:`text`,text:`Workset "${t}" not found.`}]}}case`list`:{let e=tt();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(`
|
|
224
|
+
`)}]}}case`delete`:if(!t)throw Error(`name required for delete`);return{content:[{type:`text`,text:De(t)?`Deleted workset "${t}".`:`Workset "${t}" not found.`}]};case`add`:{if(!t||!n)throw Error(`name and files required for add`);let e=ce(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=St(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 ol.error(`Workset operation failed`,j(e)),W(`INTERNAL`,`Workset operation failed: ${e instanceof Error?e.message:String(e)}`)}})}function cl(e){let t=V(`stash`);e.registerTool(`stash`,{title:t.title,description:`Persist and retrieve named values in .aikit-state/stash.json for intermediate results between tool calls.`,inputSchema:{action:N.enum([`set`,`get`,`list`,`delete`,`clear`]).describe(`Operation to perform on the stash`),key:N.string().optional().describe(`Entry key for set/get/delete operations`),value:N.string().optional().describe(`String or JSON value for set operations`)},annotations:t.annotations},async({action:e,key:t,value:n})=>{try{switch(e){case`set`:{if(!t)throw Error(`key required for set`);let e=Rt(t,pl(n??``));return{content:[{type:`text`,text:`Stored stash entry "${e.key}" (${e.type}) at ${e.storedAt}.`}]}}case`get`:{if(!t)throw Error(`key required for get`);let e=It(t);return{content:[{type:`text`,text:e?JSON.stringify(e):`Stash entry "${t}" not found.`}]}}case`list`:{let e=Lt();return{content:[{type:`text`,text:e.length===0?`Stash is empty.`:e.map(e=>`- ${e.key} (${e.type}) — ${e.storedAt}`).join(`
|
|
225
|
+
`)}]}}case`delete`:if(!t)throw Error(`key required for delete`);return{content:[{type:`text`,text:Ft(t)?`Deleted stash entry "${t}".`:`Stash entry "${t}" not found.`}]};case`clear`:{let e=Pt();return{content:[{type:`text`,text:`Cleared ${e} stash entr${e===1?`y`:`ies`}.`}]}}}}catch(e){return ol.error(`Stash operation failed`,j(e)),W(`INTERNAL`,`Stash operation failed: ${e instanceof Error?e.message:String(e)}`)}})}function ll(e){let t=V(`checkpoint`);e.registerTool(`checkpoint`,{title:t.title,description:`Save and restore lightweight session checkpoints in .aikit-state/checkpoints for cross-session continuity. Supports diff between checkpoints and history viewing.`,inputSchema:{action:N.enum([`save`,`load`,`list`,`latest`,`diff`,`history`,`gc`]).describe(`Checkpoint action to perform`),label:N.string().optional().describe(`Checkpoint label for save, or checkpoint id for load`),data:N.string().max(5e5).optional().describe(`JSON object string for save actions`),notes:N.string().max(1e4).optional().describe(`Optional notes for save actions`),from_id:N.string().optional().describe(`Checkpoint ID to diff FROM (for diff action)`),to_id:N.string().optional().describe(`Checkpoint ID to diff TO (for diff action)`),limit:N.number().min(1).max(50).optional().describe(`Max history entries to return`),keep_last:N.number().min(1).max(100).optional().describe(`Keep N most recent checkpoints per label (default: 10, for gc action)`),max_age_days:N.number().min(1).optional().describe(`Delete checkpoints older than N days (for gc action)`),dry_run:N.boolean().optional().describe(`Preview changes without deleting (default: true, for gc action)`)},annotations:t.annotations},async({action:e,label:t,data:n,notes:r,from_id:i,to_id:a,limit:o,keep_last:s,max_age_days:c,dry_run:l})=>{try{switch(e){case`save`:if(!t)throw Error(`label required for save`);return{content:[{type:`text`,text:fl(ye(t,ml(n),{notes:r}))}]};case`load`:{if(!t)throw Error(`label required for load`);let e=ve(t);return{content:[{type:`text`,text:e?fl(e):`Checkpoint "${t}" not found.`}]}}case`list`:{let e=_e();return{content:[{type:`text`,text:e.length===0?`No checkpoints saved.`:e.map(e=>`- ${e.id} — ${e.label} (${e.createdAt})`).join(`
|
|
226
|
+
`)}]}}case`latest`:{let e=ge();return{content:[{type:`text`,text:e?fl(e):`No checkpoints saved.`}]}}case`diff`:{if(!i||!a)throw Error(`from_id and to_id required for diff`);let e=pe(i,a);return e?{content:[{type:`text`,text:[`## Checkpoint Diff: ${i} → ${a}`,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(`
|
|
227
227
|
`)}]}:{content:[{type:`text`,text:`One or both checkpoints not found.`}]}}case`history`:{if(!t)throw Error(`label required for history`);let e=he(t,{limit:o??20});return e.length===0?{content:[{type:`text`,text:`No history found for "${t}".`}]}:{content:[{type:`text`,text:`## History: ${t}\n${e.map(e=>`- ${e.sha?e.sha.slice(0,8):e.id} — ${e.createdAt}${e.label?` (${e.label})`:``}`).join(`
|
|
228
228
|
`)}`}]}}case`gc`:{let e=me({label:t,keepLast:s,maxAgeDays:c,dryRun:l});return{content:[{type:`text`,text:[`## Checkpoint GC${e.labels.length?`: ${e.labels.join(`, `)}`:``}`,`Deleted: ${e.deleted}`,`Kept: ${e.kept}`,`Mode: ${l??!0?`dry-run`:`delete`}`,e.deletedIds.length?`Deleted IDs: ${e.deletedIds.join(`, `)}`:`Deleted IDs: none`].join(`
|
|
229
|
-
`)}]}}}}catch(e){return
|
|
230
|
-
`)}function
|
|
231
|
-
`)}function
|
|
232
|
-
`)}\n\n---\n_${e.length} rules total. Use \`action: "update"\` to modify a rule._`}]}}if(e===`get`){if(!n)return W(`VALIDATION`,'`rule_id` is required for "get" action.');let e=t.getRule(n);return e?{content:[{type:`text`,text:
|
|
229
|
+
`)}]}}}}catch(e){return ol.error(`Checkpoint failed`,j(e)),W(`INTERNAL`,`Checkpoint failed: ${e instanceof Error?e.message:String(e)}`)}})}function ul(e){let t=V(`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:N.enum([`create`,`list`,`status`,`diff`,`merge`,`discard`,`lease`,`unlease`,`leases`]).describe(`Lane action to perform`),name:N.string().optional().describe(`Lane name (required for create/status/diff/merge/discard)`),files:N.array(N.string()).optional().describe(`File paths to copy into the lane (required for create)`),agent:N.string().optional().describe(`Agent identifier (required for lease)`),intent:N.string().optional().describe(`What the agent plans to do (required for lease)`),id:N.string().optional().describe(`Lease ID (required for unlease)`),symbols:N.array(N.string()).optional().describe(`Symbol names within files (optional for lease)`),ttl_minutes:N.number().optional().describe(`Lease TTL in minutes (default 10, optional for lease)`)},annotations:t.annotations},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=qe(t,n);return{content:[{type:`text`,text:JSON.stringify(e)}]}}case`list`:return{content:[{type:`text`,text:JSON.stringify(Xe())}]};case`status`:if(!t)throw Error(`name is required for status`);return{content:[{type:`text`,text:JSON.stringify(Qe(t))}]};case`diff`:if(!t)throw Error(`name is required for diff`);return{content:[{type:`text`,text:JSON.stringify(Je(t))}]};case`merge`:if(!t)throw Error(`name is required for merge`);return{content:[{type:`text`,text:JSON.stringify(Ze(t))}]};case`discard`:if(!t)throw Error(`name is required for discard`);return{content:[{type:`text`,text:JSON.stringify({discarded:Ye(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=se({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=xt({id:a});return{content:[{type:`text`,text:JSON.stringify(e)}]}}case`leases`:{let e=$e({agent:r});return{content:[{type:`text`,text:JSON.stringify(e)}]}}}}catch(e){return ol.error(`Lane action failed`,j(e)),W(`INTERNAL`,`Lane action failed: ${e instanceof Error?e.message:String(e)}`)}})}function dl(e){let t=V(`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:N.enum([`create`,`push`,`next`,`done`,`fail`,`get`,`list`,`clear`,`delete`,`dag`]).describe(`Queue action`),name:N.string().optional().describe(`Queue name (required for most actions)`),title:N.string().optional().describe(`Item title (required for push)`),id:N.string().optional().describe(`Item ID (required for done/fail)`),data:N.unknown().optional().describe(`Arbitrary data to attach to a queue item`),error:N.string().optional().describe(`Error message (required for fail)`),dependsOn:N.array(N.string()).optional().describe(`Item IDs this task depends on. Dependent items start as blocked until deps complete.`)},annotations:t.annotations},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(dt(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(yt(t,n,i,void 0,o))}]};case`next`:{if(!t)throw Error(`name is required for next`);let e=vt(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(mt(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(ht(t,r,a))}]};case`get`:if(!t)throw Error(`name is required for get`);return{content:[{type:`text`,text:JSON.stringify(gt(t))}]};case`list`:return{content:[{type:`text`,text:JSON.stringify(_t())}]};case`clear`:if(!t)throw Error(`name is required for clear`);return{content:[{type:`text`,text:JSON.stringify({cleared:ut(t)})}]};case`delete`:if(!t)throw Error(`name is required for delete`);return{content:[{type:`text`,text:JSON.stringify({deleted:pt(t)})}]};case`dag`:if(!t)throw Error(`name is required for dag`);return{content:[{type:`text`,text:JSON.stringify(ft(t))}]}}}catch(e){return ol.error(`Queue action failed`,j(e)),W(`INTERNAL`,`Queue action failed: ${e instanceof Error?e.message:String(e)}`)}})}function fl(e){let t=[e.id,`Label: ${e.label}`,`Created: ${e.createdAt}`];if(e.notes&&t.push(`Notes: ${e.notes}`),e.files?.length){t.push(`Files: ${e.files.length}`);for(let n of e.files)t.push(` - ${n}`)}return t.push(``,`Data:`,JSON.stringify(e.data)),t.join(`
|
|
230
|
+
`)}function pl(e){let t=e.trim();if(!t)return``;try{return JSON.parse(t)}catch{return e}}function ml(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 hl=k(`tools`);function gl(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(`
|
|
231
|
+
`)}function _l(e,t){let n=V(`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:N.enum([`list`,`get`,`update`,`create`,`delete`]).describe(`Action to perform on classification rules`),rule_id:N.string().optional().describe(`Rule ID (required for get, update, delete)`),changes:N.object({patterns:N.array(N.string()).optional(),category:N.string().optional(),pushWeight:N.number().min(0).max(1).optional(),description:N.string().optional(),examples:N.array(N.string()).optional(),enabled:N.boolean().optional()}).optional().describe(`Changes to apply (for update action)`),new_rule:N.object({id:N.string().regex(/^[a-z][a-z0-9-]*$/),patterns:N.array(N.string()).min(1),category:N.string(),pushWeight:N.number().min(0).max(1),description:N.string(),examples:N.array(N.string()).default([]),enabled:N.boolean().default(!0)}).optional().describe(`New rule definition (for create action)`)},annotations:n.annotations},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(`
|
|
232
|
+
`)}\n\n---\n_${e.length} rules total. Use \`action: "update"\` to modify a rule._`}]}}if(e===`get`){if(!n)return W(`VALIDATION`,'`rule_id` is required for "get" action.');let e=t.getRule(n);return e?{content:[{type:`text`,text:gl(e)}]}:W(`NOT_FOUND`,`Rule "${n}" not found.`)}if(e===`update`){if(!n||!r)return W(`VALIDATION`,'`rule_id` and `changes` are required for "update" action.');let e=t.updateRule(n,r);return e?{content:[{type:`text`,text:`${gl(e)}\n\n---\n_Updated. Next: Use \`action: "list"\` to verify._`}]}:W(`NOT_FOUND`,`Rule "${n}" not found.`)}return e===`create`?i?{content:[{type:`text`,text:`${gl(t.addRule(i))}\n\n---\n_Created. Next: Test classification with \`remember\`._`}]}:W(`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._`}]}:W(`NOT_FOUND`,`Rule "${n}" not found.`):W(`VALIDATION`,'`rule_id` is required for "delete" action.'):W(`VALIDATION`,`Unknown action: ${e}`)}catch(e){return hl.error(`Policy update failed`,j(e)),W(`INTERNAL`,`Policy update failed: ${e instanceof Error?e.message:String(e)}`)}})}const vl=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`,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 }> }`,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:`{
|
|
233
233
|
type: 'docs-browser',
|
|
234
234
|
value: {
|
|
235
235
|
title: 'Project Docs',
|
|
@@ -238,26 +238,26 @@ Complements: \`symbol\` (single lookup), \`trace\` (call-chain AST), \`blast_rad
|
|
|
238
238
|
{ path: 'docs/api.md', title: 'API Reference', status: 'stale' },
|
|
239
239
|
],
|
|
240
240
|
},
|
|
241
|
-
}`},{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
|
|
242
|
-
`)}const
|
|
241
|
+
}`},{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 yl(){let e=[];for(let[t,n]of vl)e.push(` - type:"${t}" → value: ${n.valueShape}`);return e.join(`
|
|
242
|
+
`)}const bl={error:`🔴`,warning:`⚠️`,"at-risk":`⚠️`,success:`✅`,done:`✅`,info:`ℹ️`,pending:`⏳`};function xl(e){if(e.type!==`cards`)return null;let t=e.value,n=Array.isArray(t)?t:t&&typeof t==`object`&&Array.isArray(t.items)?t.items:null;if(!n||n.length===0)return null;let r=n[0];if(r&&typeof r==`object`&&`category`in r){let t=n.map(e=>{if(!e||typeof e!=`object`)return null;let t=e;if(typeof t.category!=`string`||!Array.isArray(t.items))return null;let n=t.items.map(e=>{if(!e||typeof e!=`object`)return null;let t=e;if(typeof t.label!=`string`)return null;let n=typeof t.status==`string`?`${bl[t.status.toLowerCase()]??`●`} `:``,r=typeof t.description==`string`&&t.description.length>0?` — ${t.description}`:``;return`- ${n}${t.label}${r}`}).filter(e=>typeof e==`string`);return`### ${t.category}\n${n.join(`
|
|
243
243
|
`)}`}).filter(e=>typeof e==`string`);if(t.length>0)return{type:`markdown`,title:e.title,value:t.join(`
|
|
244
244
|
|
|
245
|
-
`)}}let i=n.map(e=>{if(!e||typeof e!=`object`)return null;let t=e,n=typeof t.label==`string`?t.label:typeof t.title==`string`?t.title:null;return n?`- ${typeof t.status==`string`?`${
|
|
246
|
-
`)}:null}function
|
|
247
|
-
`)}:null}function
|
|
245
|
+
`)}}let i=n.map(e=>{if(!e||typeof e!=`object`)return null;let t=e,n=typeof t.label==`string`?t.label:typeof t.title==`string`?t.title:null;return n?`- ${typeof t.status==`string`?`${bl[t.status.toLowerCase()]??`●`} `:``}${n}${typeof t.description==`string`&&t.description.length>0?` — ${t.description}`:``}`:null}).filter(e=>typeof e==`string`);return i.length>0?{type:`markdown`,title:e.title,value:i.join(`
|
|
246
|
+
`)}:null}function Sl(e){if(e.type!==`checklist`)return null;let t=e.value,n=Array.isArray(t)?t:t&&typeof t==`object`&&Array.isArray(t.items)?t.items:null;if(!n)return null;let r=n.map(e=>{if(!e||typeof e!=`object`)return null;let t=e;if(typeof t.label!=`string`)return null;let n=t.checked===!0?`x`:` `,r=typeof t.note==`string`&&t.note.length>0?` — ${t.note}`:``;return`- [${n}] ${t.label}${r}`}).filter(e=>typeof e==`string`);return r.length>0?{type:`markdown`,title:e.title,value:r.join(`
|
|
247
|
+
`)}:null}function Cl(e,t){let n=e=>{if(e==null)return``;if(typeof e==`string`)return e;if(typeof e==`number`||typeof e==`boolean`||typeof e==`bigint`)return String(e);if(typeof e==`object`)try{let t=JSON.stringify(e);return typeof t==`string`?t:String(e)}catch{return String(e)}return String(e)};if(e==null)return null;if(typeof e==`string`)return{type:`markdown`,title:t,value:e};if(typeof e==`number`||typeof e==`boolean`)return{type:`markdown`,title:t,value:String(e)};if(Array.isArray(e)){if(e.every(e=>typeof e==`string`||typeof e==`number`||typeof e==`boolean`))return{type:`markdown`,title:t,value:e.map(e=>`- ${String(e)}`).join(`
|
|
248
248
|
`)};let n=e.filter(e=>typeof e==`object`&&!!e);if(n.length===e.length){let e={success:`✅`,done:`✅`,warning:`⚠️`,"at-risk":`⚠️`,error:`❌`,info:`ℹ️`,pending:`⏳`};if(n.every(e=>typeof e.category==`string`&&Array.isArray(e.items))){let r=n.map(t=>{let n=typeof t.category==`string`?t.category:null,r=Array.isArray(t.items)?t.items:null;if(!n||!r)return null;let i=r.map(t=>{if(!t||typeof t!=`object`)return null;let n=t,r=n.label??n.title??n.name,i=typeof r==`string`||typeof r==`number`||typeof r==`boolean`?String(r):null;if(!i)return null;let a=typeof n.status==`string`?`${e[n.status.toLowerCase()]??`●`} `:``,o=n.detail??n.description;return`- ${a}${i}${typeof o==`string`&&o.length>0?` — ${o}`:typeof o==`number`||typeof o==`boolean`?` — ${String(o)}`:``}`}).filter(e=>typeof e==`string`);return i.length===0?null:`### ${n}\n${i.join(`
|
|
249
249
|
`)}`}).filter(e=>typeof e==`string`);if(r.length>0)return{type:`markdown`,title:t,value:r.join(`
|
|
250
250
|
|
|
251
|
-
`)}}let r=new Set;for(let e of n)for(let t of Object.keys(e))r.add(t);let i=Array.from(r);return{type:`table`,title:t,value:{headers:i,rows:n.map(e=>i.map(t=>{if(!(t in e)||e[t]===void 0||e[t]===null)return``;let n=e[t];if(typeof n==`object`)try{let e=JSON.stringify(n);return typeof e==`string`?e:``}catch{return String(n)}return String(n)}))}}}}if(typeof e==`object`){let r=e;if(Array.isArray(r.items))return
|
|
252
|
-
`)}:null}return null}function
|
|
251
|
+
`)}}let r=new Set;for(let e of n)for(let t of Object.keys(e))r.add(t);let i=Array.from(r);return{type:`table`,title:t,value:{headers:i,rows:n.map(e=>i.map(t=>{if(!(t in e)||e[t]===void 0||e[t]===null)return``;let n=e[t];if(typeof n==`object`)try{let e=JSON.stringify(n);return typeof e==`string`?e:``}catch{return String(n)}return String(n)}))}}}}if(typeof e==`object`){let r=e;if(Array.isArray(r.items))return Cl(r.items,t);let i=Object.entries(r).map(([e,t])=>`**${e}**: ${n(t)}`);return i.length>0?{type:`markdown`,title:t,value:i.join(`
|
|
252
|
+
`)}:null}return null}function wl(e){return e.type!==`table`||typeof e.value!=`string`?null:{type:`markdown`,title:e.title,value:e.value}}const Tl=new Set([`markdown`,`table`,`code`,`chart`,`metrics`,`tree`,`graph`,`mermaid`,`cards`,`timeline`,`checklist`,`comparison`,`status-board`,`prompt`,`progress`,`docs-browser`,`text`,`heading`,`paragraph`,`separator`,`actions`]);function El(e){return wl(e)||(Tl.has(e.type)?null:Cl(e.value,e.title)||{type:`code`,title:e.title,value:typeof e.value==`string`?e.value:JSON.stringify(e.value,null,2)})}function Dl(e){if(e.type!==`progress`||!e.value||typeof e.value!=`object`||!Array.isArray(e.value.items))return null;let t=e.value.items.map(e=>{if(!e||typeof e!=`object`)return null;let t=e;if(typeof t.label!=`string`||typeof t.value!=`number`)return null;let n=typeof t.max==`number`?t.max:100,r=Number.isFinite(n)&&n>0?n:100,i=Math.round(t.value/r*100);return[t.label,`${i}%`,`${t.value} / ${r}`]}).filter(e=>Array.isArray(e));return t.length>0?{type:`table`,title:e.title,value:{headers:[`Item`,`Progress`,`Value`],rows:t}}:null}function Ol(e){if(e.type!==`prompt`||!e.value||typeof e.value!=`object`)return null;let t=e.value;if(typeof t.question!=`string`)return null;let n=[`**${t.question}**`];return typeof t.context==`string`&&t.context.length>0&&n.push(t.context),typeof t.placeholder==`string`&&t.placeholder.length>0&&n.push(`*${t.placeholder}*`),{type:`markdown`,title:e.title,value:n.join(`
|
|
253
253
|
|
|
254
|
-
`)}}function
|
|
254
|
+
`)}}function kl(e){return e.type===`separator`?{type:`markdown`,title:e.title,value:`---`}:null}const Al={success:`✅`,done:`✅`,warning:`⚠️`,"at-risk":`⚠️`,error:`❌`,info:`ℹ️`,pending:`⏳`};function jl(e){if(e.type!==`status-board`)return null;let t=e.value,n=Array.isArray(t)?t:t&&typeof t==`object`&&Array.isArray(t.items)?t.items:null;if(!n||n.length===0)return null;let r=n[0];if(r&&typeof r==`object`&&`category`in r){let t=n.map(e=>{if(!e||typeof e!=`object`)return null;let t=e;if(typeof t.category!=`string`||!Array.isArray(t.items))return null;let n=t.items.map(e=>{if(!e||typeof e!=`object`)return null;let t=e;if(typeof t.label!=`string`)return null;let n=typeof t.status==`string`?`${Al[t.status.toLowerCase()]??`●`} `:``,r=typeof t.detail==`string`&&t.detail.length>0?` — ${t.detail}`:``;return`- ${n}${t.label}${r}`}).filter(e=>typeof e==`string`);return`### ${t.category}\n${n.join(`
|
|
255
255
|
`)}`}).filter(e=>typeof e==`string`);if(t.length>0)return{type:`markdown`,title:e.title,value:t.join(`
|
|
256
256
|
|
|
257
|
-
`)}}let i=n.map(e=>{if(!e||typeof e!=`object`)return null;let t=e;return typeof t.label!=`string`||typeof t.status!=`string`?null:[
|
|
257
|
+
`)}}let i=n.map(e=>{if(!e||typeof e!=`object`)return null;let t=e;return typeof t.label!=`string`||typeof t.status!=`string`?null:[Al[t.status.toLowerCase()]??`●`,t.label,typeof t.detail==`string`?t.detail:``]}).filter(e=>Array.isArray(e));return i.length>0?{type:`table`,title:e.title,value:{headers:[`Status`,`Service`,`Detail`],rows:i}}:null}const Ml={done:`✅`,active:`🔵`,pending:`⏳`,error:`❌`};function Nl(e,t){if(!Array.isArray(t))return null;let n=t.map(e=>{if(e&&typeof e==`object`){let t=e;return[String(t.status??t.state??``),String(t.time??t.date??t.timestamp??``),String(t.label??t.description??t.title??t.text??``)]}return[``,``,String(e)]});return{...e,type:`table`,value:{headers:[`Status`,`Time`,`Description`],rows:n}}}function Pl(e){if(e.type!==`timeline`||!e.value||typeof e.value!=`object`||!Array.isArray(e.value.items))return null;let t=e.value.items.map(e=>{if(!e||typeof e!=`object`)return null;let t=e;return typeof t.title==`string`?[Ml[typeof t.status==`string`?t.status.toLowerCase():``]??`●`,typeof t.phase==`string`&&t.phase.length>0?t.phase:t.title,typeof t.description==`string`?t.description:``]:null}).filter(e=>Array.isArray(e));return t.length>0?{type:`table`,title:e.title,value:{headers:[`Status`,`Phase`,`Description`],rows:t}}:null}function Fl(e){let t=e;if(e.type===`text`||e.type===`paragraph`)return{...e,type:`markdown`};if(e.type===`heading`)return{...e,type:`markdown`,value:`## ${String(t.value??``)}`};if(e.type===`header`){let n=Math.min(Math.max(Number(e.level)||2,1),6);return{...e,type:`markdown`,value:`${`#`.repeat(n)} ${String(t.value??``)}`}}if(e.type===`section`)return{...e,type:`markdown`};if(e.type===`list`||e.type===`bullet`||e.type===`bullets`){let n=Array.isArray(t.value)?t.value:t.value&&typeof t.value==`object`&&Array.isArray(t.value.items)?t.value.items:void 0;return Array.isArray(n)?{...e,type:`markdown`,value:n.map(e=>`- ${String(e)}`).join(`
|
|
258
258
|
`)}:{...e,type:`markdown`}}if(e.type===`note`||e.type===`info`||e.type===`warning`||e.type===`alert`||e.type===`callout`){let n=e.type===`warning`?`⚠️`:e.type===`alert`?`🚨`:`ℹ️`;return{...e,type:`markdown`,value:`> ${n} ${String(t.value??``)}`}}if(e.type===`quote`||e.type===`blockquote`){let n=String(t.value??``).split(`
|
|
259
259
|
`);return{...e,type:`markdown`,value:n.map(e=>`> ${e}`).join(`
|
|
260
|
-
`)}}if(e.type===`divider`||e.type===`hr`)return{...e,type:`separator`};if(e.type===`image`||e.type===`img`){let t=e,n=String(t.src??t.url??t.value??``),r=String(t.alt??t.label??t.title??`image`);return{...e,type:`markdown`,value:``}}if(e.type===`link`||e.type===`url`){let t=e,n=String(t.href??t.url??t.value??``),r=String(t.label??t.text??t.title??n);return{...e,type:`markdown`,value:`[${r}](${n})`}}return e}function
|
|
260
|
+
`)}}if(e.type===`divider`||e.type===`hr`)return{...e,type:`separator`};if(e.type===`image`||e.type===`img`){let t=e,n=String(t.src??t.url??t.value??``),r=String(t.alt??t.label??t.title??`image`);return{...e,type:`markdown`,value:``}}if(e.type===`link`||e.type===`url`){let t=e,n=String(t.href??t.url??t.value??``),r=String(t.label??t.text??t.title??n);return{...e,type:`markdown`,value:`[${r}](${n})`}}return e}function Il(e){let t=e;return`value`in t?e:typeof t.text==`string`?{...e,value:t.text}:typeof t.content==`string`?{...e,value:t.content}:typeof t.markdown==`string`?{...e,value:t.markdown}:typeof t.description==`string`?{...e,value:t.description}:typeof t.code==`string`?{...e,value:t.code}:Array.isArray(t.headers)&&Array.isArray(t.rows)?{...e,value:{headers:t.headers,rows:t.rows}}:Array.isArray(t.items)?{...e,value:{items:t.items}}:Array.isArray(t.metrics)?{...e,value:t.metrics}:Array.isArray(t.cards)?{...e,value:t.cards}:Array.isArray(t.nodes)&&Array.isArray(t.edges)?{...e,value:{nodes:t.nodes,edges:t.edges}}:typeof t.question==`string`?{...e,value:{question:t.question,context:t.context,placeholder:t.placeholder}}:`chartType`in t||Array.isArray(t.data)?{...e,value:{chartType:t.chartType,data:t.data,xKey:t.xKey??`label`,yKeys:t.yKeys??[`value`]}}:e}function Ll(e){if(e.type!==`chart`)return e;let t=e.value;if(!t||typeof t!=`object`||Array.isArray(t))return e;let n=t,r=n.data&&typeof n.data==`object`&&!Array.isArray(n.data)?n.data:null,i=Array.isArray(n.labels)?n.labels:Array.isArray(r?.labels)?r.labels:null,a=Array.isArray(n.datasets)?n.datasets:Array.isArray(r?.datasets)?r.datasets:null,o=typeof n.type==`string`?n.type:typeof n.chartType==`string`?n.chartType:null;if(!o||!i||!a||Array.isArray(n.data))return e;let s=a.map((e,t)=>String(e.label??`series${t+1}`)),c=i.map((e,t)=>{let n={label:String(e)};for(let[e,r]of a.entries()){let i=r,a=String(i.label??`series${e+1}`);n[a]=i.data?.[t]??0}return n});return{...e,value:{chartType:String(o),data:c,xKey:`label`,yKeys:s}}}function Rl(e){if(Array.isArray(e)){let t=e.filter(e=>typeof e==`object`&&!!e),n=t.map(e=>String(e.title??``)),r=Math.max(0,...t.map(e=>Array.isArray(e.items)?e.items.length:0));return{headers:n,rows:Array.from({length:r},(e,n)=>t.map(e=>Array.isArray(e.items)?e.items[n]??``:``))}}if(!e||typeof e!=`object`)return null;let t=e,n=Object.keys(t),r=Math.max(0,...n.map(e=>Array.isArray(t[e])?t[e].length:0));return{headers:n,rows:Array.from({length:r},(e,r)=>n.map(e=>Array.isArray(t[e])?t[e][r]??``:``))}}function zl(e,t,n){let r=Rl(t)??Rl(n);if(r)return{...e,type:`table`,value:r};if(n&&typeof n==`object`&&!Array.isArray(n)){let t=n;if(Array.isArray(t.headers)&&Array.isArray(t.rows))return{...e,type:`table`}}return null}function Bl(e,t,n){let r=t&&typeof t==`object`&&!Array.isArray(t)?t:n&&typeof n==`object`&&!Array.isArray(n)?n:null;return r?{...e,type:`table`,value:{headers:[`Key`,`Value`],rows:Object.entries(r).map(([e,t])=>[e,t])}}:null}function Vl(e){let t=e,n=Il(e);if(n=Ll(n),n.type===`kv`)return Bl(n,t.entries,n.value)??n;if(n.type===`comparison`){let e=n,r=t.columns??(e.value&&typeof e.value==`object`?e.value.columns:void 0);return zl(n,r,e.value)??n}return n=Fl(n),n.type===`timeline`?Nl(n,n.value)??n:n}const Hl=new Set([`separator`,`actions`]);function Ul(e){if(typeof e!=`object`||!e||!(`type`in e))return!1;let t=e,n=typeof t.type==`string`?t.type:``;return Hl.has(n)?!0:`value`in t||typeof t.text==`string`||Array.isArray(t.headers)&&Array.isArray(t.rows)||typeof t.code==`string`||Array.isArray(t.items)||!!t.entries&&typeof t.entries==`object`&&!Array.isArray(t.entries)||!!t.columns&&typeof t.columns==`object`||`chartType`in t||Array.isArray(t.data)||typeof t.content==`string`||typeof t.markdown==`string`||typeof t.description==`string`||Array.isArray(t.metrics)||Array.isArray(t.cards)||Array.isArray(t.nodes)||typeof t.question==`string`}function Wl(e){return kl(e)??Sl(e)??jl(e)??Ol(e)??Dl(e)??Pl(e)??xl(e)??El(e)??e}function Gl(e){if(!Array.isArray(e)&&typeof e==`object`&&e){let t=e;return Array.isArray(t.blocks)&&t.blocks.length>0?Gl(t.blocks):e}return Array.isArray(e)?e.map(e=>Ul(e)?Wl(Vl(e)):e):e}function Kl(e){let t=e;for(let e=0;e<10;e++){if(a.existsSync(m.join(t,`package.json`)))return t;let e=m.dirname(t);if(e===t)break;t=e}return e}function ql(){let e=Kl(m.dirname(S(import.meta.url))),t=m.join(e,`packages`,`present`,`dist`,`index.html`);if(a.existsSync(t))return t;let n=m.join(e,`node_modules`,`@aikit`,`present`,`dist`,`index.html`);return a.existsSync(n)?n:t}const Jl=ql();let Yl,Xl;function Zl(){if(Yl!==void 0)return Yl??void 0;if(!a.existsSync(Jl)){Yl=null;return}return Yl=a.readFileSync(Jl,`utf8`),Yl??void 0}function Ql(e){return new Map(Array.from(e.entries(),([e,t])=>[e,{...t}]))}function $l(e){let t=new Map,n=0;return{shell:e.replace(/<script(?![^>]*\btype\s*=\s*["']application\/json["'])([^>]*)>([\s\S]*?)<\/script>/gi,(e,r,i)=>{if(/\bsrc\s*=/i.test(r))return e;let a=i.trim();if(!a)return e;let o=`app-${n++}.js`;return t.set(`/assets/${o}`,{content:a,contentType:`application/javascript`}),`<script src="/assets/${o}"${r}><\/script>`}),assets:t}}function eu(){if(Xl!==void 0)return Xl?{shell:Xl.shell,assets:Ql(Xl.assets)}:void 0;let e=Zl();if(!e){Xl=null;return}return Xl=$l(e),{shell:Xl.shell,assets:Ql(Xl.assets)}}function tu(e){return JSON.stringify(e).replace(/</g,`\\u003c`).replace(/>/g,`\\u003e`).replace(/&/g,`\\u0026`).replace(/\u2028/g,`\\u2028`).replace(/\u2029/g,`\\u2029`)}function nu(e,t){return`<!DOCTYPE html>
|
|
261
261
|
<html>
|
|
262
262
|
<head>
|
|
263
263
|
<meta charset="utf-8">
|
|
@@ -277,25 +277,25 @@ Complements: \`symbol\` (single lookup), \`trace\` (call-chain AST), \`blast_rad
|
|
|
277
277
|
</div>
|
|
278
278
|
${t}
|
|
279
279
|
</body>
|
|
280
|
-
</html>`}function
|
|
280
|
+
</html>`}function ru(e,t,n,r){let i={title:e,content:Gl(t)};r!==void 0&&(i.template=r),Array.isArray(n)&&n.length>0&&(i.actions=n);let a=`<script type="application/json" id="present-data">${tu(i)}<\/script>`,o=G(e??`AI Kit Dashboard`),s=eu();return s?{html:s.shell.replace(/<title>[\s\S]*?<\/title>/i,`<title>${o}</title>`).replace(`</head>`,` ${a}\n</head>`),assets:s.assets}:{html:nu(o,a),assets:new Map}}const q=G;function iu(e){return e?/^(#[\da-f]{3,8}|rgba?\([^)]+\)|hsla?\([^)]+\)|var\(--[\w-]+\)|[a-z]{1,20})$/i.test(e.trim()):!1}function au(e){let t=e;return!t?.items||!Array.isArray(t.items)?``:`<div class="timeline">${t.items.map(e=>{let t=e.status??`pending`,n=e.phase?`<div class="timeline-phase">${q(e.phase)}</div>`:``,r=e.description?`<div class="timeline-desc">${q(e.description)}</div>`:``;return`<div class="timeline-item">
|
|
281
281
|
<div class="timeline-dot ${t}"></div>
|
|
282
282
|
${n}
|
|
283
283
|
<div class="timeline-title">${q(e.title)}</div>
|
|
284
284
|
${r}
|
|
285
|
-
</div>`}).join(``)}</div>`}function
|
|
285
|
+
</div>`}).join(``)}</div>`}function ou(e){let t=e;return!t?.items||!Array.isArray(t.items)?``:`<div class="checklist">${t.items.map(e=>{let t=e.checked?`checked`:``,n=e.checked?`✓`:``,r=e.note?`<div class="checklist-note">${q(e.note)}</div>`:``;return`<div class="checklist-item ${t}">
|
|
286
286
|
<div class="checklist-check ${t}">${n}</div>
|
|
287
287
|
<div>
|
|
288
288
|
<div class="checklist-label">${q(e.label)}</div>
|
|
289
289
|
${r}
|
|
290
290
|
</div>
|
|
291
|
-
</div>`}).join(``)}</div>`}function
|
|
291
|
+
</div>`}).join(``)}</div>`}function su(e){let t=e;if(t?.left&&t?.right)return su({columns:[{title:t.left.label??`Left`,items:t.left.items??[]},{title:t.right.label??`Right`,items:t.right.items??[]}]});if(!t?.columns||!Array.isArray(t.columns)||t.columns.length===0)return``;let n=t.columns.length,r=Math.max(...t.columns.map(e=>e.items?.length??0));return`<div class="comparison-grid" style="grid-template-columns:repeat(${n},1fr)">${t.columns.map(e=>{let t=`<div class="comparison-header">${q(e.title)}</div>`,n=[];for(let t=0;t<r;t++){let r=e.items?.[t]??``;n.push(`<div class="comparison-item">${q(r)}</div>`)}return`<div class="comparison-col">${t}${n.join(``)}</div>`}).join(``)}</div>`}function cu(e){let t=e;return!t?.items||!Array.isArray(t.items)?``:`<div class="status-board">${t.items.flatMap(e=>{let t=e;if(Array.isArray(t.items)){let e=t.category?.trim();return t.items.map(t=>({...t,label:e?`${e}: ${t.label}`:t.label}))}return[e]}).map(e=>{let t=e.detail?`<span class="status-detail">${q(e.detail)}</span>`:``;return`<div class="status-row">
|
|
292
292
|
<div class="status-indicator ${e.status??`pending`}"></div>
|
|
293
293
|
<span class="status-label">${q(e.label)}</span>
|
|
294
294
|
${t}
|
|
295
|
-
</div>`}).join(``)}</div>`}function
|
|
295
|
+
</div>`}).join(``)}</div>`}function lu(e){let t=e;if(!t?.question)return``;let n=t.context?`<div class="prompt-context">${q(t.context)}</div>`:``,r=t.placeholder?`<div class="prompt-placeholder">${q(t.placeholder)}</div>`:``;return`<div class="prompt-block">
|
|
296
296
|
<div class="prompt-question">${q(t.question)}</div>
|
|
297
297
|
${n}${r}
|
|
298
|
-
</div>`}function
|
|
298
|
+
</div>`}function uu(e){let t=e;if(!t?.items||!Array.isArray(t.items))return``;let n=e=>e>=100?`var(--success)`:e>=60?`var(--primary)`:e>=30?`var(--warning)`:`var(--error)`;return`<div class="progress-list">${t.items.map(e=>{let t=e.max??100,r=t>0?Math.min(100,e.value/t*100):0,i=iu(e.color??``)?e.color?.trim()??n(r):n(r);return`<div class="progress-item">
|
|
299
299
|
<div class="progress-header">
|
|
300
300
|
<span class="progress-label">${q(e.label)}</span>
|
|
301
301
|
<span class="progress-value">${e.value}/${t}</span>
|
|
@@ -303,26 +303,26 @@ Complements: \`symbol\` (single lookup), \`trace\` (call-chain AST), \`blast_rad
|
|
|
303
303
|
<div class="progress-track">
|
|
304
304
|
<div class="progress-fill" style="width:${r.toFixed(1)}%;background:${i}"></div>
|
|
305
305
|
</div>
|
|
306
|
-
</div>`}).join(``)}</div>`}function
|
|
306
|
+
</div>`}).join(``)}</div>`}function du(e){let t=e,n=Array.isArray(t?.files)?t.files:[],r={current:`✅`,stale:`⚠️`,missing:`❌`};return`<div class="docs-browser" style="border:1px solid var(--color-border, #334155); border-radius:8px; overflow:hidden;">${t?.title?.trim()?`<div style="padding:12px 12px 4px; font-weight:700; font-size:1.1rem; color:var(--color-text, #e2e8f0);">${q(t.title)}</div>`:``}${n.length?n.map(e=>{let t=e?.path?.trim()||`untitled`,n=e?.title?.trim()||t.split(/[\\/]/).pop()||t,i=e?.status&&r[e.status]||``,a=e?.status?` (${e.status})`:``,o=typeof e?.content==`string`&&e.content.trim().length>0?e.content.trim():``,s=`<div style="border-bottom:1px solid var(--color-border, #334155); padding:12px;">`;return s+=`<div><strong>${q(`${i}${i?` `:``}${n}`)}</strong>${q(a)}</div>`,s+=`<div style="font-family:monospace; font-size:0.85rem; color:var(--color-muted, #94a3b8);">${q(t)}</div>`,o&&(s+=`<div style="margin-top:8px; font-size:0.9rem;">${q(o)}</div>`),s+=`</div>`,s}).join(``):`<div style="padding:12px; color:var(--color-muted, #94a3b8);">No documentation files.</div>`}</div>`}const J=G;function fu(e){return Math.abs(e)>=1e6?`${(e/1e6).toFixed(1).replace(/\.0$/,``)}M`:Math.abs(e)>=1e3?`${(e/1e3).toFixed(1).replace(/\.0$/,``)}k`:Number.isInteger(e)?String(e):e.toFixed(1)}function pu(e){return`var(--chart-${e%12+1})`}let mu=0;function hu(e){let t=e.value;if(!t?.data?.length||!t.chartType)return`<pre>${J(JSON.stringify(e.value,null,2))}</pre>`;mu++;let n=e.title||t.title?`<div class="chart-title">${J(String(e.title||t.title))}</div>`:``,r;switch(t.chartType){case`line`:r=Cu(t,!1);break;case`area`:r=Cu(t,!0);break;case`bar`:r=wu(t,!1);break;case`horizontal-bar`:r=wu(t,!0);break;case`pie`:r=Tu(t,!1);break;case`donut`:r=Tu(t,!0);break;case`sparkline`:r=Eu(t);break;case`heatmap`:r=Du(t);break;default:r=`<pre>${J(JSON.stringify(t,null,2))}</pre>`}let i=t.showLegend!==!1&&t.yKeys.length>1&&t.chartType!==`sparkline`?gu(t.yKeys):``;return`<div class="chart-container">${n}${r}${i}</div>`}function gu(e){return`<div class="chart-legend">${e.map((e,t)=>`<span class="chart-legend-item"><span class="chart-legend-swatch" style="background:${pu(t)}"></span>${J(e)}</span>`).join(``)}</div>`}const Y={top:20,right:20,bottom:35,left:55};function _u(e,t){return e.map(e=>Number(e[t])||0)}function vu(e,t){return e.map(e=>String(e[t]??``))}function yu(e){let t=1/0,n=-1/0;for(let r of e)r<t&&(t=r),r>n&&(n=r);return t===n&&(t=t===0?0:t*.9,n=n===0?1:n*1.1),[t,n]}function bu(e){return e>=0?0:e}function xu(e,t,n,r=5){let i=[];for(let a=0;a<=r;a++){let o=a/r,s=Y.top+n-o*n,c=e+o*(t-e);i.push(`<line class="chart-grid-line" x1="${Y.left}" x2="${600-Y.right}" y1="${s}" y2="${s}"/>`),i.push(`<text class="chart-axis-label" x="${Y.left-8}" y="${s+4}" text-anchor="end">${fu(c)}</text>`)}return i.join(``)}function Su(e,t,n,r){let i=Math.floor(t/50),a=Math.max(1,Math.ceil(e.length/i));return e.map((e,t)=>t%a===0?`<text class="chart-axis-label" x="${Y.left+t*r+r/2}" y="${Y.top+n+18}" text-anchor="middle">${J(e.length>10?`${e.slice(0,9)}…`:e)}</text>`:``).join(``)}function Cu(e,t){let n=(e.height??300)-Y.top-Y.bottom,r=600-Y.left-Y.right,i=vu(e.data,e.xKey),a=e.data.length;if(a===0)return``;let o=r/Math.max(a-1,1),s=1/0,c=-1/0;for(let t of e.yKeys){let[n,r]=yu(_u(e.data,t));n<s&&(s=n),r>c&&(c=r)}s=bu(s);let l=c-s||1,u=e=>Y.top+n-(e-s)/l*n,d=e=>Y.left+e*o,f=``,p=[];for(let r=0;r<e.yKeys.length;r++){let i=_u(e.data,e.yKeys[r]),o=pu(r),s=`M${i.map((e,t)=>`${d(t).toFixed(1)},${u(e).toFixed(1)}`).join(`L`)}`;if(t){let e=`ag${mu}_${r}`;f+=`<linearGradient id="${e}" x1="0" y1="0" x2="0" y2="1">
|
|
307
307
|
<stop offset="0%" stop-color="${o}" stop-opacity="0.3"/>
|
|
308
308
|
<stop offset="100%" stop-color="${o}" stop-opacity="0"/>
|
|
309
|
-
</linearGradient>`;let t=`${s}L${d(a-1).toFixed(1)},${(Y.top+n).toFixed(1)}L${d(0).toFixed(1)},${(Y.top+n).toFixed(1)}Z`;p.push(`<path d="${t}" fill="url(#${e})" stroke="none"/>`)}p.push(`<path d="${s}" fill="none" stroke="${o}" stroke-width="2" stroke-linejoin="round" stroke-linecap="round"/>`);for(let e=0;e<i.length;e++)p.push(`<circle cx="${d(e).toFixed(1)}" cy="${u(i[e]).toFixed(1)}" r="3" fill="${o}" stroke="var(--card)" stroke-width="1.5"/>`)}let m=e.height??300,h=e.showGrid===!1?``:
|
|
309
|
+
</linearGradient>`;let t=`${s}L${d(a-1).toFixed(1)},${(Y.top+n).toFixed(1)}L${d(0).toFixed(1)},${(Y.top+n).toFixed(1)}Z`;p.push(`<path d="${t}" fill="url(#${e})" stroke="none"/>`)}p.push(`<path d="${s}" fill="none" stroke="${o}" stroke-width="2" stroke-linejoin="round" stroke-linecap="round"/>`);for(let e=0;e<i.length;e++)p.push(`<circle cx="${d(e).toFixed(1)}" cy="${u(i[e]).toFixed(1)}" r="3" fill="${o}" stroke="var(--card)" stroke-width="1.5"/>`)}let m=e.height??300,h=e.showGrid===!1?``:xu(s,c,n),g=Su(i,r,n,a>1?o:r);return`<svg class="chart-svg" viewBox="0 0 600 ${m}" preserveAspectRatio="xMidYMid meet">
|
|
310
310
|
${f?`<defs>${f}</defs>`:``}
|
|
311
311
|
${h}${g}${p.join(``)}
|
|
312
|
-
</svg>`}function
|
|
313
|
-
<title>${J(e.yKeys[i])}: ${
|
|
312
|
+
</svg>`}function wu(e,t){let n=(e.height??300)-Y.top-Y.bottom,r=600-Y.left-Y.right,i=vu(e.data,e.xKey),a=e.data.length;if(a===0)return``;let o=e.yKeys.length,s=0;for(let t of e.yKeys)for(let n of _u(e.data,t))n>s&&(s=n);s===0&&(s=1);let c=e.height??300,l=[];if(t){let t=Math.min(24,(n-(a-1)*4)/(a*o)),u=t*o+4,d=e.showGrid===!1?``:xu(0,s,n),f=i.map((e,t)=>{let n=Y.top+t*u+u/2,r=e.length>15?`${e.slice(0,14)}…`:e;return`<text class="chart-axis-label" x="${Y.left-8}" y="${n+4}" text-anchor="end">${J(r)}</text>`}).join(``);for(let n=0;n<a;n++)for(let i=0;i<o;i++){let a=Number(e.data[n][e.yKeys[i]])||0,o=a/s*r,c=Y.top+n*u+i*t;l.push(`<rect x="${Y.left}" y="${c}" width="${o.toFixed(1)}" height="${t-2}" rx="3" fill="${pu(i)}" opacity="0.85">
|
|
313
|
+
<title>${J(e.yKeys[i])}: ${fu(a)}</title>
|
|
314
314
|
</rect>`)}return`<svg class="chart-svg" viewBox="0 0 600 ${Math.max(c,a*u+Y.top+Y.bottom)}" preserveAspectRatio="xMidYMid meet">
|
|
315
315
|
${d}${f}${l.join(``)}
|
|
316
|
-
</svg>`}else{let t=r/a,u=Math.min(40,(t-8)/o),d=e.showGrid===!1?``:
|
|
317
|
-
<title>${J(e.yKeys[i])}: ${
|
|
316
|
+
</svg>`}else{let t=r/a,u=Math.min(40,(t-8)/o),d=e.showGrid===!1?``:xu(0,s,n),f=Su(i,r,n,t);for(let r=0;r<a;r++)for(let i=0;i<o;i++){let a=Number(e.data[r][e.yKeys[i]])||0,c=a/s*n,d=Y.left+r*t+(t-u*o)/2+i*u,f=Y.top+n-c;l.push(`<rect x="${d.toFixed(1)}" y="${f.toFixed(1)}" width="${(u-2).toFixed(1)}" height="${c.toFixed(1)}" rx="3" fill="${pu(i)}" opacity="0.85">
|
|
317
|
+
<title>${J(e.yKeys[i])}: ${fu(a)}</title>
|
|
318
318
|
</rect>`)}return`<svg class="chart-svg" viewBox="0 0 600 ${c}" preserveAspectRatio="xMidYMid meet">
|
|
319
319
|
${d}${f}${l.join(``)}
|
|
320
|
-
</svg>`}}function
|
|
321
|
-
<title>${J(l[e]||`Item ${e+1}`)}: ${
|
|
322
|
-
</path>`),f=p}let p=t?`<text x="${r}" y="${i-6}" text-anchor="middle" fill="var(--foreground)" font-size="18" font-weight="700">${
|
|
323
|
-
<text x="${r}" y="${i+12}" text-anchor="middle" fill="var(--muted-foreground)" font-size="11">Total</text>`:``,m=
|
|
320
|
+
</svg>`}}function Tu(e,t){let n=e.height??300,r=n/2,i=n/2,a=n/2-10,o=t?a*.55:0,s=e.yKeys[0]||`value`,c=e.data.map(e=>Math.max(0,Number(e[s])||0)),l=vu(e.data,e.xKey),u=c.reduce((e,t)=>e+t,0);if(u===0)return`<div style="color:var(--muted-foreground);text-align:center;padding:20px">No data</div>`;let d=[],f=-Math.PI/2;for(let e=0;e<c.length;e++){let t=c[e]/u;if(t===0)continue;let n=t*Math.PI*2,s=f,p=f+n,m=r+a*Math.cos(s),h=i+a*Math.sin(s),g=r+a*Math.cos(p),_=i+a*Math.sin(p),v=+(n>Math.PI),y;if(o>0){let e=r+o*Math.cos(s),t=i+o*Math.sin(s),n=r+o*Math.cos(p),c=i+o*Math.sin(p);y=`M${m.toFixed(2)},${h.toFixed(2)} A${a},${a} 0 ${v},1 ${g.toFixed(2)},${_.toFixed(2)} L${n.toFixed(2)},${c.toFixed(2)} A${o},${o} 0 ${v},0 ${e.toFixed(2)},${t.toFixed(2)}Z`}else y=`M${r},${i} L${m.toFixed(2)},${h.toFixed(2)} A${a},${a} 0 ${v},1 ${g.toFixed(2)},${_.toFixed(2)}Z`;d.push(`<path d="${y}" fill="${pu(e)}" stroke="var(--background)" stroke-width="2" opacity="0.9">
|
|
321
|
+
<title>${J(l[e]||`Item ${e+1}`)}: ${fu(c[e])} (${(t*100).toFixed(1)}%)</title>
|
|
322
|
+
</path>`),f=p}let p=t?`<text x="${r}" y="${i-6}" text-anchor="middle" fill="var(--foreground)" font-size="18" font-weight="700">${fu(u)}</text>
|
|
323
|
+
<text x="${r}" y="${i+12}" text-anchor="middle" fill="var(--muted-foreground)" font-size="11">Total</text>`:``,m=gu(l.filter((e,t)=>c[t]>0));return`<svg class="chart-svg" viewBox="0 0 ${n} ${n}" preserveAspectRatio="xMidYMid meet">
|
|
324
324
|
${d.join(``)}${p}
|
|
325
|
-
</svg>${m}`}function
|
|
325
|
+
</svg>${m}`}function Eu(e){let t=e.height??40,n=e.yKeys[0]||`value`,r=_u(e.data,n),i=r.length;if(i===0)return``;let[a,o]=yu(r),s=o-a||1,c=200/Math.max(i-1,1),l=r.map((e,n)=>`${(n*c).toFixed(1)},${(t-4-(e-a)/s*(t-8)).toFixed(1)}`),u=`spk${mu}`,d=pu(0);return`<svg class="chart-svg" viewBox="0 0 200 ${t}" preserveAspectRatio="xMidYMid meet" style="max-width:200px;height:${t}px">
|
|
326
326
|
<defs>
|
|
327
327
|
<linearGradient id="${u}" x1="0" y1="0" x2="0" y2="1">
|
|
328
328
|
<stop offset="0%" stop-color="${d}" stop-opacity="0.2"/>
|
|
@@ -332,29 +332,29 @@ Complements: \`symbol\` (single lookup), \`trace\` (call-chain AST), \`blast_rad
|
|
|
332
332
|
<path d="M${l.join(`L`)}L${((i-1)*c).toFixed(1)},${t}L0,${t}Z" fill="url(#${u})" stroke="none"/>
|
|
333
333
|
<polyline points="${l.join(` `)}" fill="none" stroke="${d}" stroke-width="1.5" stroke-linejoin="round"/>
|
|
334
334
|
<circle cx="${((i-1)*c).toFixed(1)}" cy="${l[i-1].split(`,`)[1]}" r="2.5" fill="${d}"/>
|
|
335
|
-
</svg>`}function
|
|
336
|
-
<title>${J(t[a])} / ${J(e.yKeys[n])}: ${
|
|
335
|
+
</svg>`}function Du(e){let t=vu(e.data,e.xKey),n=e.data.length,r=e.yKeys.length;if(n===0||r===0)return``;let i=1/0,a=-1/0;for(let t of e.yKeys)for(let n of _u(e.data,t))n<i&&(i=n),n>a&&(a=n);let o=a-i||1,s=Math.min(50,(600-Y.left-Y.right)/n),c=Math.min(30,200/r),l=Y.left+n*s+Y.right,u=Y.top+r*c+Y.bottom,d=[];for(let t=0;t<r;t++){let n=Y.top+t*c+c/2+4,r=e.yKeys[t].length>8?`${e.yKeys[t].slice(0,7)}…`:e.yKeys[t];d.push(`<text class="chart-axis-label" x="${Y.left-8}" y="${n}" text-anchor="end">${J(r)}</text>`)}let f=Math.floor((l-Y.left)/40),p=Math.max(1,Math.ceil(n/f));for(let e=0;e<n;e++){if(e%p!==0)continue;let n=Y.left+e*s+s/2,r=t[e].length>6?`${t[e].slice(0,5)}…`:t[e];d.push(`<text class="chart-axis-label" x="${n}" y="${u-8}" text-anchor="middle">${J(r)}</text>`)}for(let a=0;a<n;a++)for(let n=0;n<r;n++){let r=Number(e.data[a][e.yKeys[n]])||0,l=(r-i)/o,u=Y.left+a*s,f=Y.top+n*c;d.push(`<rect x="${u}" y="${f}" width="${s-1}" height="${c-1}" rx="2" fill="var(--primary)" opacity="${(.1+l*.8).toFixed(2)}">
|
|
336
|
+
<title>${J(t[a])} / ${J(e.yKeys[n])}: ${fu(r)}</title>
|
|
337
337
|
</rect>`)}return`<svg class="chart-svg" viewBox="0 0 ${l} ${u}" preserveAspectRatio="xMidYMid meet">
|
|
338
338
|
${d.join(``)}
|
|
339
|
-
</svg>`}function
|
|
340
|
-
`)}</tbody></table></div>`}function
|
|
341
|
-
`)}zn.setOptions({async:!1,gfm:!0,breaks:!0}),zn.use({renderer:{html(e){return G(e.text)},link(e){let t=e.href??``,n=t.replace(/\s/g,``).toLowerCase();if(n.startsWith(`javascript:`)||n.startsWith(`vbscript:`)||n.startsWith(`data:`))return this.parser.parseInline(e.tokens);let r=e.title?` title="${G(e.title)}"`:``,i=this.parser.parseInline(e.tokens);return`<a href="${G(t)}"${r}>${i}</a>`}}});function
|
|
339
|
+
</svg>`}function Ou(e){if(e.length===0)return`<p><em>empty table</em></p>`;let t=Object.keys(e[0]);return`<div class="table-wrap"><table><thead><tr>${t.map(e=>`<th>${G(e)}</th>`).join(``)}</tr></thead><tbody>${e.map(e=>`<tr>${t.map(t=>`<td>${G(String(e[t]??``))}</td>`).join(``)}</tr>`).join(`
|
|
340
|
+
`)}</tbody></table></div>`}function ku(e){return`<div class="metric-grid">${e.map(e=>`<div class="metric"><div class="metric-value">${G(String(e.value))}</div><div class="metric-label">${G(e.label)}</div></div>`).join(``)}</div>`}function Au(e){return`<div class="card-grid">${e.map(e=>{let t=[`<div class="card">`];return e.title&&t.push(`<div class="card-title">${G(String(e.title))}</div>`),(e.body||e.description)&&t.push(`<div class="card-body">${G(String(e.body??e.description))}</div>`),(e.badge||e.status)&&t.push(`<span class="badge">${G(String(e.badge??e.status))}</span>`),t.push(`</div>`),t.join(``)}).join(``)}</div>`}function ju(e){if(`name`in e&&`children`in e&&Array.isArray(e.children))return Mu(e);if(`name`in e&&!(`children`in e))return`<div class="tree-node"><span class="tree-key">${G(String(e.name))}</span></div>`;let t=[];for(let[n,r]of Object.entries(e))typeof r==`object`&&r&&!Array.isArray(r)?t.push(`<div class="tree-node"><span class="tree-key">${G(n)}:</span><div class="tree-children">${ju(r)}</div></div>`):t.push(`<div class="tree-node"><span class="tree-key">${G(n)}:</span> ${G(ho(r))}</div>`);return t.join(``)}function Mu(e){let t=G(String(e.name));return!e.children||e.children.length===0?`<div class="tree-node"><span class="tree-key">${t}</span></div>`:`<div class="tree-node"><span class="tree-key">${t}</span><div class="tree-children">${e.children.map(e=>typeof e==`object`&&e?Mu(e):`<div class="tree-node"><span class="tree-key">${G(String(e))}</span></div>`).join(``)}</div></div>`}function Nu(e){let t=[`graph LR`];for(let n of e.nodes){let e=go(String(n.id??n.name??``)),r=String(n.label??n.name??e);t.push(` ${e}["${r}"]`)}for(let n of e.edges){let e=go(String(n.source??n.from??``)),r=go(String(n.target??n.to??``)),i=n.label?`|${String(n.label)}|`:``;t.push(` ${e} -->${i} ${r}`)}return t.join(`
|
|
341
|
+
`)}zn.setOptions({async:!1,gfm:!0,breaks:!0}),zn.use({renderer:{html(e){return G(e.text)},link(e){let t=e.href??``,n=t.replace(/\s/g,``).toLowerCase();if(n.startsWith(`javascript:`)||n.startsWith(`vbscript:`)||n.startsWith(`data:`))return this.parser.parseInline(e.tokens);let r=e.title?` title="${G(e.title)}"`:``,i=this.parser.parseInline(e.tokens);return`<a href="${G(t)}"${r}>${i}</a>`}}});function Pu(e){let t=e.split(`
|
|
342
342
|
`),n=[],r=0;for(;r<t.length;){let e=t[r],i=t[r+1];if(e.trim().startsWith(`|`)&&e.trim().endsWith(`|`)&&i!==void 0&&/^\s*\|[\s:]*-+[\s:]*(\|[\s:]*-+[\s:]*)*\|?\s*$/.test(i)){let i=e.trim().replace(/^\||\|$/g,``).split(`|`).map(e=>e.trim());r+=2;let a=0;for(;r<t.length&&t[r].trim().startsWith(`|`);){a++;let e=t[r].trim().replace(/^\||\|$/g,``).split(`|`).map(e=>e.trim()),o=e[0]??``;if(i.length<=1)n.push(`${a}. **${o}**`);else{let t=i.slice(1).map((t,n)=>`**${t}**: ${e[n+1]??``}`).join(` · `);n.push(`${a}. **${o}** — ${t}`)}r++}}else n.push(e),r++}return n.join(`
|
|
343
|
-
`)}function
|
|
344
|
-
`)}function
|
|
343
|
+
`)}function Fu(e,t,n){let r=[];if(e&&r.push(`# ${e}\n`),typeof t==`string`)r.push(t);else if(Array.isArray(t))if(t.length===0)r.push(`*(empty)*`);else if(Ul(t[0])||typeof t[0]==`object`&&t[0]!==null&&typeof t[0].type==`string`)for(let e of t)r.push(Iu(Vl(e),n));else if(typeof t[0]==`object`&&t[0]!==null)n?.compactTables?r.push(Ru(t)):r.push(Lu(t));else for(let e of t)r.push(`- ${String(e)}`);else if(typeof t==`object`&&t){let e=t;if(Array.isArray(e.blocks)&&e.blocks.length>0)for(let t of e.blocks)Ul(t)||typeof t==`object`&&t&&typeof t.type==`string`?r.push(Iu(Vl(t),n)):typeof t==`object`&&t?r.push(Hu(t)):r.push(String(t));else Array.isArray(e.nodes)&&Array.isArray(e.edges)?r.push(Vu(e)):Array.isArray(e.metrics)?r.push(Bu(e.metrics)):r.push(Hu(e))}else r.push(String(t));return r.join(`
|
|
344
|
+
`)}function Iu(e,t){let n=[];switch(e.title&&n.push(`## ${e.title}\n`),e.type){case`markdown`:{let r=String(e.value??``);r=t?.compactTables?Pu(r):r.replace(/(^|\n)((?!\|)[^\n]+)\n(\|)/g,`$1$2
|
|
345
345
|
|
|
346
|
-
$3`),n.push(r);break}case`code`:n.push(`\`\`\`${e.language??``}\n${String(e.value??``)}\n\`\`\``);break;case`mermaid`:n.push(`\`\`\`mermaid\n${String(e.value??``)}\n\`\`\``);break;case`table`:{let r=e.value;if(Array.isArray(r)&&r.length>0)t?.compactTables?n.push(
|
|
347
|
-
`))}else{n.push(`| ${i.join(` | `)} |`),n.push(`| ${i.map(()=>`---`).join(` | `)} |`);for(let e of a)n.push(`| ${e.map(e=>String(e??``)).join(` | `)} |`)}}else n.push(`*(empty table)*`);break}case`metrics`:Array.isArray(e.value)&&n.push(
|
|
346
|
+
$3`),n.push(r);break}case`code`:n.push(`\`\`\`${e.language??``}\n${String(e.value??``)}\n\`\`\``);break;case`mermaid`:n.push(`\`\`\`mermaid\n${String(e.value??``)}\n\`\`\``);break;case`table`:{let r=e.value;if(Array.isArray(r)&&r.length>0)t?.compactTables?n.push(Ru(r,e.title)):n.push(Lu(r));else if(r&&typeof r==`object`&&!Array.isArray(r)&&`headers`in r&&`rows`in r){let{headers:i,rows:a}=r;if(t?.compactTables){let t=[];e.title&&t.push(`**${e.title}**\n`);for(let e=0;e<a.length;e++){let n=i.map((t,n)=>`**${t}**: ${String(a[e]?.[n]??``)}`).join(` · `);t.push(`${e+1}. ${n}`)}n.push(t.join(`
|
|
347
|
+
`))}else{n.push(`| ${i.join(` | `)} |`),n.push(`| ${i.map(()=>`---`).join(` | `)} |`);for(let e of a)n.push(`| ${e.map(e=>String(e??``)).join(` | `)} |`)}}else n.push(`*(empty table)*`);break}case`metrics`:Array.isArray(e.value)&&n.push(Bu(e.value));break;case`graph`:e.value&&typeof e.value==`object`&&n.push(Vu(e.value));break;case`cards`:if(Array.isArray(e.value))for(let t of e.value)n.push(`### ${t.title??`Card`}`),(t.body||t.description)&&n.push(String(t.body??t.description)),(t.badge||t.status)&&n.push(`> **${t.badge??t.status}**`),n.push(``);break;case`tree`:e.value&&typeof e.value==`object`&&n.push(Hu(e.value));break;case`chart`:{let t=e.value;t?.data&&Array.isArray(t.data)&&n.push(`*${String(t.chartType??`chart`)} chart — ${t.data.length} data points*`);break}case`timeline`:{let t=e.value;if(t?.items)for(let e of t.items){let t=e.status===`done`?`✅`:e.status===`active`?`🔄`:e.status===`error`?`❌`:`⬜`;n.push(`${t} **${e.title}**${e.description?` — ${e.description}`:``}`)}break}case`checklist`:{let t=e.value;if(t?.items)for(let e of t.items)n.push(`- [${e.checked?`x`:` `}] ${e.label}${e.note?` — ${e.note}`:``}`);break}case`comparison`:{let r=e.value;if(r?.columns&&r.columns.length>0)if(t?.compactTables)n.push(zu(r.columns,e.title));else{let e=Math.max(...r.columns.map(e=>e.items?.length??0)),t=r.columns.map(e=>e.title);n.push(`| ${t.join(` | `)} |`),n.push(`| ${t.map(()=>`---`).join(` | `)} |`);for(let t=0;t<e;t++)n.push(`| ${r.columns.map(e=>e.items?.[t]??``).join(` | `)} |`)}break}case`status-board`:{let t=e.value;if(t?.items)for(let e of t.items){let t=e.status===`success`?`🟢`:e.status===`warning`?`🟡`:e.status===`error`?`🔴`:e.status===`info`?`🔵`:`⚪`;n.push(`${t} **${e.label}**${e.detail?` — ${e.detail}`:``}`)}break}case`prompt`:{let t=e.value;t?.question&&(n.push(`> **${t.question}**`),t.context&&n.push(`> ${t.context}`));break}case`progress`:{let t=e.value;if(t?.items)for(let e of t.items){let t=e.max??100,r=t>0?Math.round(e.value/t*100):0,i=Math.round(r/5),a=`█`.repeat(i)+`░`.repeat(20-i);n.push(`${e.label}: ${a} ${r}%`)}break}case`docs-browser`:{let t=e.value,r={current:`✅`,stale:`⚠️`,missing:`❌`};t?.title?.trim()&&n.push(`## ${t.title.trim()}`);let i=Array.isArray(t?.files)?t.files:[];if(i.length===0){n.push(`*(No content available)*`);break}i.forEach((e,t)=>{let a=e?.path?.trim()||`document-${t+1}`,o=e?.title?.trim()||a.split(/[\\/]/).pop()||a,s=e?.status&&r[e.status]?r[e.status]:`📄`;n.push(`${s} **${o}** (\`${a}\`)`),n.push(``),typeof e?.content==`string`&&e.content.trim().length>0?n.push(e.content.trim()):n.push(`*(No content available)*`),t<i.length-1&&(n.push(``),n.push(`---`),n.push(``))});break}case`text`:n.push(String(e.value??``));break;case`heading`:{let t=Math.min(Math.max(Number(e.level)||2,1),6);n.push(`${`#`.repeat(t)} ${String(e.value??``)}\n`);break}case`paragraph`:n.push(String(e.value??``));break;case`separator`:n.push(`---
|
|
348
348
|
`);break;default:n.push(JSON.stringify(e.value,null,2))}return n.push(``),n.join(`
|
|
349
|
-
`)}function
|
|
350
|
-
`)}function
|
|
351
|
-
`)}function
|
|
352
|
-
`)}function
|
|
353
|
-
`)}function
|
|
354
|
-
`)}function
|
|
355
|
-
`)}function
|
|
356
|
-
`);return i.includes(`class="mermaid"`)&&!i.includes(`mermaid.min.js`)?`${i}\n<script src="https://cdn.jsdelivr.net/npm/mermaid@11/dist/mermaid.min.js"><\/script>\n<script>mermaid.run();<\/script>`:i}function
|
|
357
|
-
`)}const
|
|
349
|
+
`)}function Lu(e){if(e.length===0)return`*(empty table)*`;let t=Object.keys(e[0]),n=[];n.push(`| ${t.join(` | `)} |`),n.push(`| ${t.map(()=>`---`).join(` | `)} |`);for(let r of e)n.push(`| ${t.map(e=>String(r[e]??``)).join(` | `)} |`);return n.join(`
|
|
350
|
+
`)}function Ru(e,t){if(e.length===0)return`*(empty table)*`;let n=Object.keys(e[0]),r=[];t&&r.push(`**${t}**\n`);for(let t=0;t<e.length;t++){let i=e[t],a=String(i[n[0]]??``);if(n.length===1)r.push(`${t+1}. **${a}**`);else{let e=n.slice(1).map(e=>`${e}: ${String(i[e]??``)}`).join(` · `);r.push(`${t+1}. **${a}** — ${e}`)}}return r.join(`
|
|
351
|
+
`)}function zu(e,t){let n=[];t&&n.push(`**${t}**\n`);for(let t of e){if(n.push(`**${t.title}**`),t.items&&t.items.length>0)for(let e of t.items)n.push(`- ${e}`);else n.push(`- *(none)*`);n.push(``)}return n.join(`
|
|
352
|
+
`)}function Bu(e){return e.map(e=>`- **${e.label}**: ${e.value}`).join(`
|
|
353
|
+
`)}function Vu(e){let t=["```mermaid",`graph LR`];for(let n of e.nodes){let e=go(String(n.id??n.name??``)),r=String(n.label??n.name??e);t.push(` ${e}["${r}"]`)}for(let n of e.edges){let e=go(String(n.source??n.from??``)),r=go(String(n.target??n.to??``)),i=n.label?`|${String(n.label)}|`:``;t.push(` ${e} -->${i} ${r}`)}return t.push("```"),t.join(`
|
|
354
|
+
`)}function Hu(e,t=0){let n=` `.repeat(t),r=[];for(let[i,a]of Object.entries(e))typeof a==`object`&&a&&!Array.isArray(a)?(r.push(`${n}- **${i}**:`),r.push(Hu(a,t+1))):r.push(`${n}- **${i}**: ${ho(a)}`);return r.join(`
|
|
355
|
+
`)}function Uu(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function Wu(e){return e.replace(/<table\b/g,`<div class="table-wrap"><table`).replace(/<\/table>/g,`</table></div>`)}function Gu(e,t){if(typeof e!=`object`||!e)return`<p>${G(String(e))}</p>`;let n=e;return typeof n.type==`string`?fd(Vl(n),t):`<pre>${G(JSON.stringify(e,null,2))}</pre>`}function Ku(e,t,n=`inline`){let r=[];if(e&&r.push(`<h1>${G(e)}</h1>`),typeof t==`string`)r.push(`<div class="md-content">${Wu(zn.parse(t))}</div>`);else if(Array.isArray(t))if(t.length===0)r.push(`<p><em>empty</em></p>`);else if(Ul(t[0]))for(let e of t)r.push(Gu(e,n));else typeof t[0]==`object`&&t[0]!==null?r.push(Ou(t)):r.push(`<ul>${t.map(e=>`<li>${G(String(e))}</li>`).join(``)}</ul>`);else if(typeof t==`object`&&t){let e=t;if(Array.isArray(e.blocks)&&e.blocks.length>0)for(let t of e.blocks)r.push(Gu(t,n));else Array.isArray(e.metrics)?r.push(ku(e.metrics)):Array.isArray(e.nodes)&&Array.isArray(e.edges)?r.push(`<pre class="mermaid">${G(Nu(e))}</pre>`):r.push(ju(e))}else r.push(`<p>${G(String(t))}</p>`);let i=r.join(`
|
|
356
|
+
`);return i.includes(`class="mermaid"`)&&!i.includes(`mermaid.min.js`)?`${i}\n<script src="https://cdn.jsdelivr.net/npm/mermaid@11/dist/mermaid.min.js"><\/script>\n<script>mermaid.run();<\/script>`:i}function qu(e){let t=String(e.value??``);return/^\s*</.test(t)?`<div class="md-content">${t}</div>`:`<div class="md-content">${Wu(zn.parse(t))}</div>`}function Ju(e){return`<pre><code>${G(String(e.value??``))}</code></pre>`}function Yu(e){return`<pre class="mermaid">${G(String(e.value??``))}</pre>`}function Xu(e){if(Array.isArray(e.value)){let t=e.value;if(t.length>0&&Array.isArray(t[0])){let e=t,n=e[0].map(String);return Ou(e.slice(1).map(e=>Object.fromEntries(n.map((t,n)=>[t,e[n]]))))}return Ou(t)}if(e.value&&typeof e.value==`object`&&`headers`in e.value&&`rows`in e.value){let{headers:t,rows:n}=e.value;return Ou(n.map(e=>Object.fromEntries(t.map((t,n)=>[t,e[n]]))))}return``}function Zu(e){let t;return Array.isArray(e.value)?t=e.value:e.value&&typeof e.value==`object`&&(t=Object.entries(e.value).map(([e,t])=>({label:e,value:String(t)}))),t?ku(t):``}function Qu(e){return Array.isArray(e.value)?Au(e.value):``}function $u(e){return e.value&&typeof e.value==`object`?ju(e.value):``}function ed(e,t){return!e.value||typeof e.value!=`object`?``:`<pre class="mermaid">${G(Nu(e.value))}</pre>`}function td(e){let t=e.value;return Array.isArray(t)&&(t={items:t.map(e=>({title:String(e.event??e.title??``),phase:e.date==null?e.phase==null?void 0:String(e.phase):String(e.date),description:e.description==null?void 0:String(e.description),status:e.status??`done`}))}),t?au(t):``}function nd(e){return e.value?ou(Array.isArray(e.value)?{items:e.value}:e.value):``}function rd(e){return e.value?su(Array.isArray(e.value)?{columns:e.value}:e.value):``}function id(e){return e.value?cu(Array.isArray(e.value)?{items:e.value}:e.value):``}function ad(e){if(!e.value)return``;let t=e.value;return Array.isArray(t)?t={items:t}:Uu(t)&&!(`items`in t)&&`label`in t&&`value`in t&&(t={items:[t]}),uu(t)}function od(e){return`<div class="md-content">${zn.parse(String(e.value??``))}</div>`}function sd(e){let t=Math.min(Math.max(Number(e.level)||2,1),6);return`<h${t}>${G(String(e.value??``))}</h${t}>`}function cd(e){return`<p>${G(String(e.value??``))}</p>`}function ld(e){return`<div class="action-bar">${(Array.isArray(e.value)?e.value:[]).map(e=>{if(e.type===`select`){let t=Array.isArray(e.options)?e.options.map(e=>`<option value="${G(String(e.value??e.label??``))}">${G(String(e.label??e.value??``))}</option>`).join(``):``;return`<select class="action-select"><option value="">${G(String(e.label??`Select...`))}</option>${t}</select>`}return`<button class="action-btn action-${String(e.variant??`secondary`)}">${G(String(e.label??``))}</button>`}).join(``)}</div>`}function ud(e){return`<pre>${G(JSON.stringify(e.value,null,2))}</pre>`}const dd=new Map([[`markdown`,e=>qu(e)],[`code`,e=>Ju(e)],[`mermaid`,e=>Yu(e)],[`table`,e=>Xu(e)],[`metrics`,e=>Zu(e)],[`cards`,e=>Qu(e)],[`tree`,e=>$u(e)],[`graph`,(e,t)=>ed(e,t)],[`chart`,e=>hu(e)],[`timeline`,e=>td(e)],[`checklist`,e=>nd(e)],[`comparison`,e=>rd(e)],[`status-board`,e=>id(e)],[`prompt`,e=>e.value?lu(e.value):``],[`progress`,e=>ad(e)],[`docs-browser`,e=>e.value?du(e.value):``],[`text`,e=>od(e)],[`heading`,e=>sd(e)],[`paragraph`,e=>cd(e)],[`separator`,()=>`<hr class="separator">`],[`actions`,e=>ld(e)]]);function fd(e,t=`inline`){let n=[];e.title&&n.push(`<h2>${G(e.title)}</h2>`);let r=dd.get(e.type);return n.push(r?r(e,t):ud(e)),n.join(`
|
|
357
|
+
`)}const pd=import.meta.dirname??g(S(import.meta.url));function md(e){let t=e;for(let e=0;e<10;e++){try{let e=v(t,`package.json`);if(o(e)&&JSON.parse(c(e,`utf8`)).name===`@vpxa/aikit`)return t}catch{}let e=g(t);if(e===t)break;t=e}return b(e,`..`,`..`,`..`)}const hd=`ui://aikit/present.html`;function gd(e){return Array.isArray(e)?e:[]}function _d(e){return e.length===0?``:`<section class="present-inline-actions"><div class="action-bar">${e.map(e=>{let t=G(String(e.id??``)),n=G(String(e.label??`Action`));return e.type===`select`?`<label class="action-select-wrap"><span>${n}</span><select class="action-select" data-present-action="select" data-action-id="${t}"><option value="">${n}</option>${Array.isArray(e.options)?e.options.map(e=>{if(typeof e==`string`){let t=G(e);return`<option value="${t}">${t}</option>`}return`<option value="${G(String(e.value??e.label??``))}">${G(String(e.label??e.value??``))}</option>`}).join(``):``}</select></label>`:`<button type="button" class="action-btn action-${G(String(e.variant??`default`))}" data-present-action="button" data-action-id="${t}" data-action-value="clicked">${n}</button>`}).join(``)}</div><div id="action-feedback" class="action-feedback" aria-live="polite"></div></section>`}function vd(e,t,n){return`<!DOCTYPE html>
|
|
358
358
|
<html lang="en">
|
|
359
359
|
<head>
|
|
360
360
|
<meta charset="utf-8">
|
|
@@ -432,8 +432,8 @@ $3`),n.push(r);break}case`code`:n.push(`\`\`\`${e.language??``}\n${String(e.valu
|
|
|
432
432
|
</head>
|
|
433
433
|
<body>
|
|
434
434
|
<div class="present-inline-root">
|
|
435
|
-
${
|
|
436
|
-
${
|
|
435
|
+
${Ku(e,t,`inline`)}
|
|
436
|
+
${_d(n)}
|
|
437
437
|
</div>
|
|
438
438
|
<script>
|
|
439
439
|
function sendCallback(actionId, value) {
|
|
@@ -468,15 +468,15 @@ $3`),n.push(r);break}case`code`:n.push(`\`\`\`${e.language??``}\n${String(e.valu
|
|
|
468
468
|
});
|
|
469
469
|
<\/script>
|
|
470
470
|
</body>
|
|
471
|
-
</html>`}const
|
|
471
|
+
</html>`}const yd=N.object({type:N.enum([`button`,`select`]).describe(`Action type`),id:N.string().describe(`Unique action identifier`),label:N.string().describe(`Display label`),variant:N.enum([`primary`,`danger`,`default`]).optional().describe(`Button style variant`),options:N.array(N.union([N.string(),N.object({label:N.string(),value:N.string()})])).optional().describe(`Select options (for type=select)`)}),bd={format:N.enum([`html`,`browser`]).default(`html`).describe(`Output format.
|
|
472
472
|
- "html" (default): Rich markdown in chat + embedded UIResource for MCP-UI hosts. Actions shown as numbered choices.
|
|
473
473
|
- "browser": Rich markdown in chat + opens beautiful themed dashboard in the browser. When actions are provided, the browser shows interactive buttons and the tool blocks until user clicks, returning their selection.`),title:N.string().optional().describe(`Optional heading`),content:N.any().describe(`Content to present. Accepts these shapes:
|
|
474
474
|
• markdown string — rendered as rich text
|
|
475
475
|
• array of objects — auto-rendered as table
|
|
476
476
|
• { nodes, edges } — rendered as mermaid graph
|
|
477
477
|
• typed blocks array [{ type, title?, value }] — the primary format:
|
|
478
|
-
${
|
|
479
|
-
IMPORTANT: For charts, use the ChartValue format above. Do NOT use Chart.js format ({labels, datasets}) — it will be auto-converted but the native format is preferred.`),actions:N.array(
|
|
478
|
+
${yl()}\n• any JSON — rendered as collapsible tree
|
|
479
|
+
IMPORTANT: For charts, use the ChartValue format above. Do NOT use Chart.js format ({labels, datasets}) — it will be auto-converted but the native format is preferred.`),actions:N.array(yd).optional().describe(`Interactive actions (buttons/selects). In html mode, shown as numbered choices. In browser mode, rendered as clickable buttons and the tool blocks until user clicks.`),template:N.enum([`auto`,`list-sort`,`data-table`,`picker`,`flame-graph`,`form`,`timeline`,`kanban`,`tree`,`diff-view`,`dashboard`]).optional().describe(`UI template for interactive display in MCP Apps hosts.
|
|
480
480
|
- auto (default): detect from content shape
|
|
481
481
|
- list-sort: drag-drop reorderable list — content: { items: [{id, label}] }
|
|
482
482
|
- data-table: filterable sortable table — content: { columns: [{key, label}], rows: [{...}], stats?: [{label, value}] }
|
|
@@ -487,15 +487,15 @@ IMPORTANT: For charts, use the ChartValue format above. Do NOT use Chart.js form
|
|
|
487
487
|
- kanban: drag-drop board — content: { columns: [{id, label, color?}], cards: [{id, title, column, tags?[], priority?}] }
|
|
488
488
|
- tree: collapsible tree view — content: { root: {label, children?:[...]} | [...] }
|
|
489
489
|
- diff-view: side-by-side diff — content: { files: [{path, status, additions, deletions, hunks:[{header, changes:[{type, content}]}]}] }
|
|
490
|
-
- dashboard: metric cards grid — content: { metrics: [{label, value, trend?, status?, type?}] }`)};let
|
|
490
|
+
- dashboard: metric cards grid — content: { metrics: [{label, value, trend?, status?, type?}] }`)};let xd,Sd=!1,Cd=null;process.on(`exit`,()=>{if(Cd){try{Cd.close()}catch{}Cd=null}});function wd(){let e=md(pd),t=v(e,`packages`,`present`,`dist`,`index.html`);return o(t)?t:v(e,`packages`,`present`,`index.html`)}function Td(){if(!xd)try{xd=c(wd(),`utf-8`)}catch{xd=``}return xd}function Ed(e,t){let n=V(`present`),r=Td(),i=`Present content to the user in the best format. Two modes:
|
|
491
491
|
- "html" (default): Rich markdown in chat + embedded UIResource. Use for display-only content (tables, charts, reports, status boards) where no user interaction is needed.
|
|
492
492
|
- "browser": Serves a themed dashboard on a local URL. Use ONLY when you need user interaction back (confirmations, selections, form input). The tool blocks until user clicks an action button, then returns their selection.
|
|
493
493
|
FORMAT RULE: If no user interaction is needed → use "html". If you need user input back → use "browser".
|
|
494
494
|
CONTENT GUIDE: Pass typed blocks [{ type, title?, value }] for structured content. See the \`content\` parameter description for all supported block types and their value shapes. For charts: use {chartType, data:Record[], xKey, yKeys} — NOT Chart.js format.
|
|
495
|
-
BROWSER WORKFLOW: After calling present with format "browser", you MUST extract the URL from the response and call openBrowserPage({ url }) tool - PlayWright MCP to open it in VS Code Simple Browser. A system browser fallback also opens automatically, but always call openBrowserPage tool - PlayWright MCP yourself.`,a=async({format:e,title:n,content:r,actions:i,template:a})=>{let o=_o(r);return(e??`html`)===`browser`||Array.isArray(i)&&i.length>0?await
|
|
495
|
+
BROWSER WORKFLOW: After calling present with format "browser", you MUST extract the URL from the response and call openBrowserPage({ url }) tool - PlayWright MCP to open it in VS Code Simple Browser. A system browser fallback also opens automatically, but always call openBrowserPage tool - PlayWright MCP yourself.`,a=async({format:e,title:n,content:r,actions:i,template:a})=>{let o=_o(r);return(e??`html`)===`browser`||Array.isArray(i)&&i.length>0?await Dd(n,o,i,t,a):Od(n,o,i)};if(r){Sd||=(kn(e,`AI Kit Present App`,hd,{description:`Rich interactive content viewer for AI Kit tools`},async()=>({contents:[{uri:hd,mimeType:On,text:r}]})),!0),An(e,`present`,{title:n.title,description:i,annotations:n.annotations,inputSchema:bd,_meta:{ui:{resourceUri:hd}}},a);return}e.tool(`present`,i,bd,n.annotations,a)}async function Dd(e,t,n,r,i){let a=Fu(e,t,{compactTables:!0}),o=gd(n),s=vd(e,t,o),{html:c,assets:l}=ru(e,t,n,i),u=Rn({uri:`ui://aikit/present-browser.html`,content:{type:`rawHtml`,htmlString:s},encoding:`text`,adapters:{mcpApps:{enabled:!0}}}),d,f,p=``,m;try{Cd&&=(Cd.close(),null),o.length>0&&(d=new Promise(e=>{f=e}));let e=!1;p=await new Promise((t,n)=>{let r=Ln((t,n)=>{if(e||(e=!0,m&&clearTimeout(m)),t.method===`POST`&&t.url===`/callback`){let e=``;t.on(`data`,t=>{e+=t.toString()}),t.on(`end`,()=>{n.writeHead(200,{"Content-Type":`application/json`,"Access-Control-Allow-Origin":`*`}),n.end(`{"ok":true}`);try{let t=JSON.parse(e);f?.(t)}catch{}});return}if(t.method===`OPTIONS`){n.writeHead(204,{"Access-Control-Allow-Origin":`*`,"Access-Control-Allow-Methods":`POST`,"Access-Control-Allow-Headers":`Content-Type`}),n.end();return}let r=l.get(t.url??``);if(r){n.writeHead(200,{"Content-Type":r.contentType,"Cache-Control":`no-cache`}),n.end(r.content);return}n.writeHead(200,{"Content-Type":`text/html; charset=utf-8`}),n.end(c)});r.listen(0,`127.0.0.1`,()=>{let i=r.address();if(typeof i==`object`&&i){Cd=r;let n=`http://127.0.0.1:${i.port}`;m=setTimeout(()=>{if(!e)try{Pn(process.platform===`win32`?`start "" "${n}"`:process.platform===`darwin`?`open "${n}"`:`xdg-open "${n}"`)}catch{}},8e3),m.unref(),t(n)}else n(Error(`Failed to start present server`))}),setTimeout(()=>{r.close(),Cd===r&&(Cd=null)},300*1e3).unref()})}catch{}let h=p?`${a}\n\n---\n🌐 **Dashboard opened in browser:** ${p}\n\n**IMPORTANT:** You MUST now open this URL using the \`openBrowserPage\` tool - PlayWright MCP. If that tool is unavailable, open the URL in the system browser as a fallback. If neither works, ask the user to open the URL manually.`:a;if(o.length>0&&r?.available&&d)try{let e=await Promise.race([d,new Promise((e,t)=>setTimeout(()=>t(Error(`timeout`)),300*1e3))]);return{content:[{type:`text`,text:`${h}\n\n✅ **Selected:** ${e.actionId} = \`${e.value}\``},u]}}catch{return{content:[{type:`text`,text:`${h}\n\n⚠️ *No selection received (timed out).*`},u]}}return{content:[{type:`text`,text:h},u]}}function Od(e,t,n){let r=gd(n),i=Fu(e,t,{compactTables:!0}),a=Rn({uri:hd,content:{type:`rawHtml`,htmlString:Ku(e,t)},encoding:`text`,adapters:{mcpApps:{enabled:!0}}});return{content:[{type:`text`,text:i},a],structuredContent:{title:e,content:Gl(t),actions:r}}}const kd=k(`tools`);function Ad(e,t){let n=new hn({structure:new _n,dependencies:new fn,symbols:new vn,patterns:new gn,entryPoints:new mn,diagrams:new pn}),r=V(`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:N.string().optional().describe(`Root path to analyze (defaults to workspace root)`),aspects:N.array(N.enum([`all`,`structure`,`dependencies`,`symbols`,`patterns`,`entry-points`,`diagrams`])).default([`all`]).describe(`Which analysis aspects to run`)},annotations:r.annotations},async({scope:e,aspects:r})=>{try{let i=e??`.`;kd.info(`Running knowledge production`,{rootPath:i,aspects:r});let a=await n.runExtraction(i,r);try{let e=t?.onboardDir??v(i,`.ai`,`context`);s(e,{recursive:!0});let n=`<!-- Generated by produce_knowledge at ${new Date().toISOString()} -->\n\n`;for(let[t,r]of Object.entries(a))r&&typeof r==`string`&&p(v(e,`${t}.md`),n+r,`utf-8`);kd.info(`Knowledge persisted to .ai/context/`,{files:Object.keys(a).length})}catch(e){kd.warn(`Failed to persist knowledge to .ai/context/`,{error:j(e)})}return{content:[{type:`text`,text:n.buildSynthesisInstructions(a,r)+`
|
|
496
496
|
|
|
497
497
|
---
|
|
498
|
-
_Next: Review the baselines above and use \`remember\` to store synthesized knowledge entries._`}]}}catch(e){return
|
|
498
|
+
_Next: Review the baselines above and use \`remember\` to store synthesized knowledge entries._`}]}}catch(e){return kd.error(`Knowledge production failed`,j(e)),W(`INTERNAL`,`Knowledge production failed: ${e instanceof Error?e.message:String(e)}`)}})}const X=k(`tools`);function jd(e,t,n,r,i,a,o){let s=V(`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:N.boolean().default(!1).describe(`If true, force full re-index ignoring file hashes`),force:N.boolean().default(!1).describe(`If true, override smart indexing guard and run reindex anyway`)},annotations:s.annotations},async({full:e,force:s},c)=>{try{if(t.isIndexing)return{content:[{type:`text`,text:`## Reindex Already in Progress
|
|
499
499
|
|
|
500
500
|
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
|
|
501
501
|
|
|
@@ -503,38 +503,38 @@ Smart indexing (trickle mode) is enabled — files are automatically indexed as
|
|
|
503
503
|
|
|
504
504
|
**If the index is severely outdated**, use \`reindex({ force: true })\` to override.
|
|
505
505
|
|
|
506
|
-
Use \`status({})\` to check smart indexing queue status.`}]};let l=ao(c).createTask(`Reindex`,1);l.progress(0,`Starting ${e?`full`:`incremental`} reindex`),X.info(`Starting background re-index`,{mode:e?`full`:`incremental`});let u=e=>t=>{t.phase===`chunking`&&t.currentFile&&X.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(X.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(),X.info(`FTS index rebuilt after reindex`)}catch(e){X.warn(`FTS index rebuild failed`,j(e))}try{let e=await r.reindexAll();X.info(`Curated re-index complete`,{indexed:e.indexed})}catch(e){X.warn(`Curated re-index failed`,j(e))}if(a)try{await a.notifyAfterReindex()}catch(e){X.warn(`Post-reindex resource notification failed`,j(e))}}).catch(e=>{l.fail(`Reindex failed: ${e instanceof Error?e.message:String(e)}`),X.error(`Background reindex failed`,j(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 X.error(`Reindex failed`,j(e)),W(`INTERNAL`,`Reindex failed: ${e instanceof Error?e.message:String(e)}`)}})}const
|
|
506
|
+
Use \`status({})\` to check smart indexing queue status.`}]};let l=ao(c).createTask(`Reindex`,1);l.progress(0,`Starting ${e?`full`:`incremental`} reindex`),X.info(`Starting background re-index`,{mode:e?`full`:`incremental`});let u=e=>t=>{t.phase===`chunking`&&t.currentFile&&X.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(X.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(),X.info(`FTS index rebuilt after reindex`)}catch(e){X.warn(`FTS index rebuild failed`,j(e))}try{let e=await r.reindexAll();X.info(`Curated re-index complete`,{indexed:e.indexed})}catch(e){X.warn(`Curated re-index failed`,j(e))}if(a)try{await a.notifyAfterReindex()}catch(e){X.warn(`Post-reindex resource notification failed`,j(e))}}).catch(e=>{l.fail(`Reindex failed: ${e instanceof Error?e.message:String(e)}`),X.error(`Background reindex failed`,j(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 X.error(`Reindex failed`,j(e)),W(`INTERNAL`,`Reindex failed: ${e instanceof Error?e.message:String(e)}`)}})}const Md=k(`tools`);function Nd(e){let t=V(`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:N.enum([`list`,`clear`]).default(`list`).describe(`Action: "list" (default) to view entries, "clear" to wipe the log`),last:N.number().optional().describe(`Number of entries to return (default: 20, list only)`),tool:N.string().optional().describe(`Filter by tool name (list only)`),source:N.enum([`mcp`,`cli`]).optional().describe(`Filter by source: "mcp" or "cli" (list only)`),since:N.string().optional().describe(`ISO timestamp — only show entries after this time (list only)`)},annotations:t.annotations},async({action:e,last:t,tool:n,source:r,since:i})=>{try{if(e===`clear`)return Tt(),{content:[{type:`text`,text:`Replay log cleared.`}]};let a=Et({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 Dt().catch(()=>{}),{content:[{type:`text`,text:`**Replay Log** (${a.length} entries)\n\n${o.join(`
|
|
507
507
|
|
|
508
|
-
`)}`}]}}catch(e){return
|
|
508
|
+
`)}`}]}}catch(e){return Md.error(`Replay failed`,j(e)),W(`INTERNAL`,`Replay failed: ${e instanceof Error?e.message:String(e)}`)}})}const Pd=k(`tools`);function Fd(e){let t=V(`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:N.enum([`list`,`restore`]).describe(`list: show restore points, restore: apply a restore point`),id:N.string().optional().describe(`Restore point ID (required for action=restore)`),limit:N.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=et().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(`
|
|
509
509
|
`)}`}]}}if(!t)throw Error(`id is required for restore action`);let r=await Ot(t);return{content:[{type:`text`,text:`Restored ${r.length} files:\n${r.map(e=>`- \`${e}\``).join(`
|
|
510
|
-
`)}`}]}}catch(e){return
|
|
511
|
-
`)[0].slice(0,500);if(r&&r!==e){let i=await t.embedQuery(r),a=await n.search(i,y);a.length>0&&(b=a,C=`> _Original query "${e}" returned 0 results. Auto-reformulated to "${r}"._\n\n`,
|
|
510
|
+
`)}`}]}}catch(e){return Pd.error(`Restore failed`,j(e)),W(`INTERNAL`,`Restore failed: ${e instanceof Error?e.message:String(e)}`)}})}const Id=/<\/?curated-context>/gi;function Ld(e){return e.replace(Id,``)}function Rd(e){return`<curated-context>\n${Ld(e)}\n</curated-context>`}const zd=k(`tools`);function Bd(e){let t=[],n=h(process.cwd());n&&t.push(`[project: ${n}]`);let r=It(`__context_boost`);return r&&t.push(`[focus: ${r.value}]`),t.length===0?e:`${t.join(` `)} ${e}`}async function Vd(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:Dn(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 zd.warn(`ER fallback failed`,j(e)),{results:n,triggered:!0,cacheHit:a}}}function Hd(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 Ud(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 Wd(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 Gd(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&&!Kd.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 Kd=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 qd(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 tn(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 Jd(e,t,n,r,i,a,o){let s=V(`search`);e.registerTool(`search`,{title:s.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:aa,inputSchema:{query:N.string().max(5e3).describe(`Natural language search query`),limit:N.number().min(1).max(20).default(5).describe(`Maximum results to return`),search_mode:N.enum([`hybrid`,`semantic`,`keyword`]).default(`hybrid`).describe(`Search strategy: hybrid (vector + FTS + RRF fusion, default), semantic (vector only), keyword (FTS only)`),content_type:N.enum(w).optional().describe(`Filter by content type`),source_type:N.enum(D).optional().describe(`Coarse filter: "source" (code only), "documentation" (md, curated), "test", "config". Overrides content_type if both set.`),origin:N.enum(E).optional().describe(`Filter by knowledge origin`),category:N.string().optional().describe(`Filter by category (e.g., decisions, patterns, conventions)`),tags:N.array(N.string()).optional().describe(`Filter by tags (returns results matching ANY of the specified tags)`),min_score:N.number().min(0).max(1).default(.25).describe(`Minimum similarity score`),graph_hops:N.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:N.number().min(100).max(5e4).optional().describe(`Maximum token budget for the response. When set, output is truncated to fit.`),dedup:N.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:N.array(N.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:s.annotations},async({query:e,limit:s,search_mode:c,content_type:l,source_type:u,origin:d,category:f,tags:p,min_score:m,graph_hops:h,max_tokens:g,dedup:_,workspaces:v})=>{try{let y={limit:s,minScore:m,contentType:l,sourceType:u,origin:d,category:f,tags:p},b,x=!1,S=!1,C=``,w=Bd(e);if(c===`keyword`)b=await n.ftsSearch(e,y),b=b.slice(0,s);else if(c===`semantic`){let r=await t.embedQuery(w);b=await n.search(r,y);let a=await Vd(i,b[0]?.score??0,b,e,s);b=a.results,x=a.triggered,S=a.cacheHit}else{let r=await t.embedQuery(w),a=n.coarseSearch,o=a?a.bind(n):n.search.bind(n),[c,l]=await Promise.all([o(r,{...y,limit:s*2}),n.ftsSearch(e,{...y,limit:s*2}).catch(()=>[])]);c.length===0&&l.length>0?(b=l.slice(0,s),C=` (FTS-only: vector index rebuilding)`):b=l.length===0&&c.length>0?c.slice(0,s):Hd(c,l).slice(0,s);let u=await Vd(i,c[0]?.score??0,b,e,s);b=u.results,x=u.triggered,S=u.cacheHit}a&&a.recordSearch(e,x,S),b.length>1&&(b=Ud(b,e)),b=Wd(b);let T=``;if(v&&v.length>0){let n=zo(v,te(process.cwd()));if(n.length>0){let{stores:r,closeAll:i}=await Bo(n);try{let i;i=c===`keyword`?await Ho(r,e,{...y,limit:s}):await Vo(r,await t.embedQuery(e),{...y,limit:s});for(let e of i)b.push({record:{...e.record,sourcePath:`[${e.workspace}] ${e.record.sourcePath}`},score:e.score});b=b.sort((e,t)=>t.score-e.score).slice(0,s),T=` + ${n.length} workspace(s)`}finally{await i()}}}if(_===`file`&&b.length>1){let e=new Map;for(let t of b){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}]})}b=[...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(b.length>1){let e=b[0].score,t=Math.max(e*.4,.1);b=b.filter(e=>e.score>=t)}if(b.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(`
|
|
511
|
+
`)[0].slice(0,500);if(r&&r!==e){let i=await t.embedQuery(r),a=await n.search(i,y);a.length>0&&(b=a,C=`> _Original query "${e}" returned 0 results. Auto-reformulated to "${r}"._\n\n`,zd.info(`Smart search fallback succeeded`,{originalQuery:e,altQuery:r,resultCount:a.length}))}}catch(e){zd.debug(`Smart search fallback failed`,{error:String(e)})}if(b.length===0)return{content:[{type:`text`,text:`No results found for the given query.`}],structuredContent:{results:[],totalResults:0,searchMode:c,query:e}}}let E,D;if(h>0&&!r&&(D="> **Note:** `graph_hops` was set but no graph store is available. Graph augmentation skipped."),h>0&&r)try{let e=await He(r,b.map(e=>({recordId:e.record.id,score:e.score,sourcePath:e.record.sourcePath})),{hops:h,maxPerHit:5});E=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(`
|
|
512
512
|
`),n=t.graphContext.edges.slice(0,5).map(e=>` - ${e.fromId} —[${e.type}]→ ${e.toId}`).join(`
|
|
513
513
|
`),r=[`- **Graph Context** (${h} hop${h>1?`s`:``}):`];e&&r.push(` Entities:\n${e}`),n&&r.push(` Relationships:\n${n}`),E.set(t.recordId,r.join(`
|
|
514
|
-
`))}}catch(e){
|
|
515
|
-
`)}\n\n${n.origin===`curated`?
|
|
514
|
+
`))}}catch(e){zd.warn(`Graph augmentation failed`,j(e)),D=`> **Note:** Graph augmentation failed. Results shown without graph context.`}let O=Date.now();for(let e of b)if(e.record.origin===`curated`&&e.record.indexedAt){let t=O-new Date(e.record.indexedAt).getTime(),n=Math.max(0,t/864e5);e.score*=.95**n}b.sort((e,t)=>t.score-e.score),b=ue(b);let ee=b.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,E?.get(n.id)??null].filter(Boolean).join(`
|
|
515
|
+
`)}\n\n${n.origin===`curated`?Rd(n.content):n.content}`}).join(`
|
|
516
516
|
|
|
517
517
|
---
|
|
518
518
|
|
|
519
|
-
`),k=(c===`hybrid`?`hybrid (vector + keyword RRF)`:c===`keyword`?`keyword (FTS)`:`semantic (vector)`)+T,ne=
|
|
519
|
+
`),k=(c===`hybrid`?`hybrid (vector + keyword RRF)`:c===`keyword`?`keyword (FTS)`:`semantic (vector)`)+T,ne=Gd(b,e),re=ne.length>0?`\n_Distinctive terms: ${ne.map(e=>`\`${e}\``).join(`, `)}_`:``,ie=await qd(n,b),A=[];if(b.length===0)A.push("`reindex` — no results found, index may be stale"),A.push("`find` — try federated search with glob/regex");else{let e=b[0]?.record.sourcePath;e&&A.push(`\`lookup\` — see all chunks from \`${e}\``),A.push("`symbol` — resolve a specific symbol from the results"),A.push("`compact` — compress a result file for focused reading")}let M=[D?`${D}\n\n`:``,ie?`${ie}\n\n`:``,ee,`\n\n---\n_Search mode: ${k} | ${b.length} results_${re}`,`\n_Next: ${A.join(` | `)}_`],ae=C+M.join(``);g&&(ae=Gt(ae,g));let oe=new Set,se=[];for(let e of b){if(e.record.origin!==`curated`||e.record.sourcePath.startsWith(`[`))continue;let t=dc(e.record.sourcePath);if(!t)continue;let n=lc(t,e.record.headingPath??t);n&&!oe.has(n.uri)&&(oe.add(n.uri),se.push(n))}return{content:[{type:`text`,text:ae},...se],structuredContent:{results:b.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}:{}})),totalResults:b.length,searchMode:c,query:e}}}catch(e){return zd.error(`Search failed`,j(e)),W(`INTERNAL`,`Search failed: ${e instanceof Error?e.message:String(e)}`)}})}const Yd=k(`tools`);function Xd(e,t){let n=V(`session_digest`);e.registerTool(`session_digest`,{title:n.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:N.enum([`tools`,`stash`,`all`]).default(`all`).describe(`What to include: tools (replay only), stash (stash + checkpoints only), or all`),since:N.string().optional().describe(`ISO timestamp — only include activity after this time`),last:N.number().min(1).max(500).optional().describe(`Max replay entries to consider (default: 50)`),focus:N.string().optional().describe(`Focus query — prioritize entries matching this topic`),mode:N.enum([`deterministic`,`sampling`]).default(`deterministic`).describe(`Summary mode: deterministic (fast, template-based) or sampling (LLM-assisted, richer)`),token_budget:N.number().min(100).max(8e3).default(2e3).describe(`Target token budget for the digest output`),persist:N.boolean().default(!0).describe(`Auto-save digest to stash for crash recovery`)},annotations:n.annotations},async({scope:e,since:n,last:r,focus:i,mode:a,token_budget:o,persist:s})=>{try{let c={scope:e,since:n,last:r,focus:i,mode:a,tokenBudget:o,persist:s};return{content:[{type:`text`,text:(a===`sampling`&&t?.available?await Nt(c,async(e,n,r)=>(await t.createMessage({prompt:e,systemPrompt:n,maxTokens:r})).text):Mt(c)).digest}]}}catch(e){return Yd.error(`Session digest failed`,j(e)),W(`INTERNAL`,`Session digest failed: ${e instanceof Error?e.message:String(e)}`)}})}const Zd=k(`tools`);function Qd(e,t,n,r=15e3){let i,a=new Promise(e=>{i=setTimeout(()=>{Zd.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),Zd.warn(`Status sub-operation "${n}" failed: ${e instanceof Error?e.message:String(e)}`),{value:t,timedOut:!1})),a])}function $d(){let e=bn.get(),t=yn.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(`
|
|
520
520
|
`):` 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(`
|
|
521
|
-
`)}const
|
|
522
|
-
`)}],structuredContent:l}})}function
|
|
523
|
-
`),M={totalRecords:h.totalRecords,totalFiles:h.totalFiles,lastIndexedAt:h.lastIndexedAt??null,onboarded:w,onboardDir:x,contentTypes:h.contentTypeBreakdown,wasmAvailable:!!bn.get(),wasmDiagnostics:yn.get(),graphStats:_,curatedCount:v,serverVersion:k,scaffoldVersion:ee??null,workspaceScaffoldVersion:te??null,upgradeAvailable:ne||re,storeBackend:l?.store?.backend,storeDiagnostics:D??null,contextPressure:T};return{content:[{type:`text`,text:j+(u===`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:M}}catch(e){return
|
|
524
|
-
`)};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
|
|
521
|
+
`)}const ef=5*6e4;let tf=null,nf=null;function rf(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 af(){let e=Date.now();if(tf&&e-tf.ts<ef)return tf.value;try{let t=b(In(),`.copilot`,`.aikit-scaffold.json`);if(!o(t))return tf={value:null,ts:e},null;let n=JSON.parse(c(t,`utf-8`)).version??null;return tf={value:n,ts:e},n}catch{return tf={value:null,ts:e},null}}function of(){let e=Date.now();if(nf&&e-nf.ts<ef)return nf.value;try{let t=b(process.cwd(),`.github`,`.aikit-scaffold.json`);if(!o(t))return nf={value:null,ts:e},null;let n=JSON.parse(c(t,`utf-8`)).version??null;return nf={value:n,ts:e},n}catch{return nf={value:null,ts:e},null}}function sf(e){let t=V(`status`);e.registerTool(`status`,{title:t.title,description:`Get the current status and statistics of the AI Kit index.`,outputSchema:Xi,annotations:t.annotations},async()=>{let e=r(),t=af(),a=of(),o=t!=null&&t!==e,s=a!=null&&a!==e,c=[`## AI Kit Status`,``,`⏳ **AI Kit is initializing** — index stats will be available shortly.`,``,`### Runtime`,`- **Tree-sitter (WASM)**: ${bn.get()?`✅ Available (AST analysis)`:`⚠ Unavailable (regex fallback)`}`,``,`### Version`,`- **Server**: ${e}`,`- **Scaffold (user)**: ${t??`not installed`}`,`- **Scaffold (workspace)**: ${a??`not installed`}`];if(o||s){let r=i(),l=[];o&&l.push(`user scaffold v${t}`),s&&l.push(`workspace scaffold v${a}`);let u=l.join(`, `);r.state===`success`?c.push(``,`### ✅ Upgrade Applied`,`- Server v${e} — ${u} auto-upgraded successfully.`,`- _Restart the MCP server to use the updated version._`):r.state===`pending`?c.push(``,`### ⏳ Upgrade In Progress`,`- Server v${e} ≠ ${u}`,`- Auto-upgrade is running in the background…`):r.state===`failed`?(n(),c.push(``,`### ⬆ Upgrade Available (auto-upgrade failed, retrying)`,`- Server v${e} ≠ ${u}`,`- Error: ${r.error??`unknown`}`)):(n(),c.push(``,`### ⬆ Upgrade Available`,`- Server v${e} ≠ ${u}`,`- Auto-upgrade triggered — check again shortly.`))}let l={totalRecords:0,totalFiles:0,lastIndexedAt:null,onboarded:!1,onboardDir:``,contentTypes:{},wasmAvailable:!!bn.get(),wasmDiagnostics:yn.get(),graphStats:null,curatedCount:0,serverVersion:e,scaffoldVersion:t??null,workspaceScaffoldVersion:a??null,upgradeAvailable:o||s,contextPressure:0};return{content:[{type:`text`,text:c.join(`
|
|
522
|
+
`)}],structuredContent:l}})}function cf(e,t,a,s,c,l,u,d){let p=V(`status`);e.registerTool(`status`,{title:p.title,description:`Get the current status and statistics of the AI Kit index.`,outputSchema:Xi,annotations:p.annotations},async()=>{let e=[];try{let[p,m]=await Promise.all([Qd(t.getStats(),{totalRecords:0,totalFiles:0,lastIndexedAt:null,contentTypeBreakdown:{}},`store.getStats`),Qd(t.listSourcePaths(),[],`store.listSourcePaths`)]),h=p.value;p.timedOut&&e.push(`⚠ Index stats timed out — values may be incomplete`);let g=m.value;m.timedOut&&e.push(`⚠ File listing timed out`);let _=null,v=0,y=[`## AI Kit Status`,``,`- **Total Records**: ${h.totalRecords}`,`- **Total Files**: ${h.totalFiles}`,`- **Last Indexed**: ${h.lastIndexedAt??`Never`}`,``,`### Content Types`,...Object.entries(h.contentTypeBreakdown).map(([e,t])=>`- ${e}: ${t}`),``,`### Indexed Files`,...g.slice(0,50).map(e=>`- ${e}`),g.length>50?`\n... and ${g.length-50} more files`:``];if(a)try{let t=await Qd(a.getStats(),{nodeCount:0,edgeCount:0,nodeTypes:{},edgeTypes:{}},`graphStore.getStats`);if(t.timedOut)e.push(`⚠ Graph stats timed out`),y.push(``,`### Knowledge Graph`,`- Graph stats timed out`);else{let e=t.value;_={nodes:e.nodeCount,edges:e.edgeCount},y.push(``,`### Knowledge Graph`,`- **Nodes**: ${e.nodeCount}`,`- **Edges**: ${e.edgeCount}`,...Object.entries(e.nodeTypes).map(([e,t])=>` - ${e}: ${t}`));try{let e=await Qd(a.validate(),{valid:!0,danglingEdges:[],orphanNodes:[],stats:{nodeCount:0,edgeCount:0,nodeTypes:{},edgeTypes:{}}},`graphStore.validate`);if(!e.timedOut){let t=e.value;t.valid||y.push(`- **⚠ Integrity Issues**: ${t.danglingEdges.length} dangling edges`),t.orphanNodes.length>0&&y.push(`- **Orphan nodes**: ${t.orphanNodes.length}`)}}catch{}}}catch{y.push(``,`### Knowledge Graph`,`- Graph store unavailable`)}let x=l?.onboardDir??b(process.cwd(),C.aiContext),S=o(x),w=c?.onboardComplete||S;if(y.push(``,`### Onboard Status`,w?`- ✅ Complete${c?.onboardTimestamp?` (last: ${c.onboardTimestamp})`:``}`:'- ❌ Not run — call `onboard({ path: "." })` to analyze the codebase',`- **Onboard Directory**: \`${x}\``),s)try{let t=await Qd(s.list(),[],`curated.list`);if(t.timedOut)e.push(`⚠ Curated knowledge listing timed out`),y.push(``,`### Curated Knowledge`,`- Listing timed out`);else{let e=t.value;v=e.length,y.push(``,`### Curated Knowledge`,e.length>0?`- ${e.length} entries`:'- Empty — use `knowledge({ action: "remember", ... })` to persist decisions')}}catch{y.push(``,`### Curated Knowledge`,`- Unable to read curated entries`)}let T=rf(h.totalRecords,_?.nodes??0,_?.edges??0,v);y.push(``),y.push(`## 📊 Context Pressure: ${T}/100`),T>=80?y.push(`⚠️ High pressure — consider pruning stale entries or compacting context.`):T>=50?y.push(`ℹ️ Moderate pressure — AI Kit memory is well-populated.`):y.push(`✅ Low pressure — plenty of headroom for more content.`);let E=0;if(h.lastIndexedAt){E=new Date(h.lastIndexedAt).getTime();let e=(Date.now()-E)/(1e3*60*60);y.push(``,`### Index Freshness`,e>24?u===`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`)}let D=null,O=t;if(typeof O.getDiagnostics==`function`)try{D=O.getDiagnostics(),y.push(``,`### Storage`,`- **Backend**: ${l?.store?.backend??`unknown`}`,`- **Adapter**: ${D.adapterType}`,`- **Vector search**: ${D.vectorSearchEnabled?`✅ enabled`:`⚠ disabled (FTS-only fallback)`}`,D.dbPath?`- **DB**: ${D.dbPath}`:``,D.dbSizeBytes==null?``:`- **DB size**: ${(D.dbSizeBytes/1024/1024).toFixed(2)} MB`,`- **Embedding dim**: ${D.embeddingDim}`,`- **Vector dtype**: ${D.vectorDtype}`)}catch{}if(u===`smart`)if(y.push(``,`### Smart Indexing`),d){let e=d();e?y.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}`):y.push(`- **Mode**: Smart (trickle)`,`- **Status**: scheduler state unavailable (init may have failed)`)}else y.push(`- **Mode**: Smart (trickle) — scheduler state unavailable`);{try{let e=b(process.cwd(),C.data,`stash`);if(o(e)){let t=f(e).mtimeMs;t>E&&(E=t)}}catch{}let e=[];if(s)try{let t=v>0?await s.list():[];for(let e of t){let t=new Date(e.updated||e.created).getTime();t>E&&(E=t)}e.push(...t.sort((e,t)=>new Date(t.updated).getTime()-new Date(e.updated).getTime()).slice(0,5))}catch{}let t=E>0?Date.now()-E:0;if(t>=144e5){let n=Math.floor(t/36e5);if(y.push(``,`### 🌅 Session Briefing`,`_${n}+ hours since last activity — here's what to pick up:_`,``),e.length>0){y.push(`**Recent decisions/notes:**`);for(let t of e)y.push(`- **${t.title}** (${t.category??`note`}) — ${(t.contentPreview??``).slice(0,80)}…`)}y.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')}}y.push(``,`### Runtime`,$d());let ee=af(),te=of(),k=r(),ne=ee!=null&&ee!==k,re=te!=null&&te!==k;if(ne||re){let e=i(),t=[];ne&&t.push(`user scaffold v${ee}`),re&&t.push(`workspace scaffold v${te}`);let r=t.join(`, `);e.state===`success`?y.push(``,`### ✅ Upgrade Applied`,`- Server v${k} — ${r} auto-upgraded successfully.`,`- _Restart the MCP server to use the updated version._`):e.state===`pending`?y.push(``,`### ⏳ Upgrade In Progress`,`- Server v${k} ≠ ${r}`,`- Auto-upgrade is running in the background…`):e.state===`failed`?(n(),y.push(``,`### ⬆ Upgrade Available (auto-upgrade failed, retrying)`,`- Server v${k} ≠ ${r}`,`- Error: ${e.error??`unknown`}`)):(n(),y.push(``,`### ⬆ Upgrade Available`,`- Server v${k} ≠ ${r}`,`- Auto-upgrade triggered — check again shortly.`))}e.length>0&&y.push(``,`### ⚠ Warnings`,...e.map(e=>`- ${e}`));let ie=_i();if(ie.length>0){let e=ie.sort((e,t)=>t.callCount-e.callCount);y.push(``,`### Tool Usage This Session`,``),y.push(`| Tool | Calls | Tokens In | Tokens Out | Errors | Avg Latency |`),y.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);y.push(`| ${t.tool} | ${t.callCount} | ${e.toLocaleString()} | ${n.toLocaleString()} | ${t.errorCount} | ${r}ms |`)}}let A=li();if(A.bufferSize>=10){let e=A.state===`healthy`?`🟢`:A.state===`degraded`?`🔴`:`🟡`;y.push(``,`### Auto-GC: ${e} ${A.state}`),y.push(`- p95 latency: ${A.p95}ms | buffer: ${A.bufferSize} samples`),A.gcCount>0&&y.push(`- GC cycles triggered: ${A.gcCount}`)}let j=y.join(`
|
|
523
|
+
`),M={totalRecords:h.totalRecords,totalFiles:h.totalFiles,lastIndexedAt:h.lastIndexedAt??null,onboarded:w,onboardDir:x,contentTypes:h.contentTypeBreakdown,wasmAvailable:!!bn.get(),wasmDiagnostics:yn.get(),graphStats:_,curatedCount:v,serverVersion:k,scaffoldVersion:ee??null,workspaceScaffoldVersion:te??null,upgradeAvailable:ne||re,storeBackend:l?.store?.backend,storeDiagnostics:D??null,contextPressure:T};return{content:[{type:`text`,text:j+(u===`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:M}}catch(e){return Zd.error(`Status failed`,j(e)),W(`INTERNAL`,`Status check failed: ${e instanceof Error?e.message:String(e)}`)}})}const lf=k(`tools`);function uf(e){let t=V(`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:N.array(N.string().max(2e3)).min(1).max(5).describe('Search queries (1–5). Single: `["react hooks"]`. Multiple searched in parallel.'),limit:N.number().min(1).max(20).default(5).describe(`Max results per query`),site:N.string().optional().describe(`Restrict to domain (e.g., "docs.aws.amazon.com")`),provider:N.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},async({queries:e,limit:t,site:n,provider:r})=>{let i=e,a=async e=>{let i=await Xt({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(`
|
|
524
|
+
`)};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 lf.error(`Web search failed`,j(e)),W(`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);lf.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(`
|
|
525
525
|
|
|
526
|
-
`);return c===o.length?W(`INTERNAL`,u):{content:[{type:`text`,text:u}]}})}function
|
|
527
|
-
`)}]}}catch(e){return
|
|
528
|
-
`)}]}})}function
|
|
529
|
-
`)}],structuredContent:i}}catch(e){return
|
|
526
|
+
`);return c===o.length?W(`INTERNAL`,u):{content:[{type:`text`,text:u}]}})}function df(e){let t=V(`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:N.string().url().describe(`Request URL (http/https only)`),method:N.enum([`GET`,`POST`,`PUT`,`PATCH`,`DELETE`,`HEAD`]).default(`GET`).describe(`HTTP method`),headers:N.record(N.string(),N.string()).optional().describe(`Request headers as key-value pairs`),body:N.string().optional().describe(`Request body (for POST/PUT/PATCH)`),timeout:N.number().min(1e3).max(6e4).default(15e3).describe(`Timeout in milliseconds`)},annotations:t.annotations},async({url:e,method:t,headers:n,body:r,timeout:i})=>{try{let a=await Ke({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(`
|
|
527
|
+
`)}]}}catch(e){return lf.error(`HTTP request failed`,j(e)),W(`INTERNAL`,`HTTP request failed: ${e instanceof Error?e.message:String(e)}`)}})}function ff(e){let t=V(`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:N.string().max(500).describe(`Regex pattern (without delimiters)`),flags:N.string().max(10).regex(/^[gimsuy]*$/).default(``).describe(`Regex flags (g, i, m, s, etc.)`),test_strings:N.array(N.string().max(1e4)).max(50).describe(`Strings to test the pattern against`),mode:N.enum([`match`,`replace`,`split`]).default(`match`).describe(`Test mode`),replacement:N.string().optional().describe(`Replacement string (for replace mode)`)},annotations:t.annotations},async({pattern:e,flags:t,test_strings:n,mode:r,replacement:i})=>{let a=bt({pattern:e,flags:t,testStrings:n,mode:r,replacement:i});if(!a.valid)return W(`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(`
|
|
528
|
+
`)}]}})}function pf(e){let t=V(`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:N.enum([`base64_encode`,`base64_decode`,`url_encode`,`url_decode`,`sha256`,`md5`,`jwt_decode`,`hex_encode`,`hex_decode`]).describe(`Operation to perform`),input:N.string().max(1e6).describe(`Input text`)},annotations:t.annotations},async({operation:e,input:t})=>{try{let n=Ae({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 lf.error(`Encode failed`,j(e)),W(`INTERNAL`,`Encode failed: ${e instanceof Error?e.message:String(e)}`)}})}function mf(e){let t=V(`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:Qi,inputSchema:{path:N.string().describe(`File or directory path to measure`),extensions:N.array(N.string()).optional().describe(`File extensions to include (default: .ts,.tsx,.js,.jsx)`)},annotations:t.annotations},async({path:e,extensions:t})=>{try{let n=await nt({path:e,extensions:t}),r=[`## Code Metrics`,``,`**Files:** ${n.summary.totalFiles}`,`**Total lines:** ${n.summary.totalLines} (${n.summary.totalCodeLines} code)`,`**Functions:** ${n.summary.totalFunctions}`,`**Avg complexity:** ${n.summary.avgComplexity}`,`**Max complexity:** ${n.summary.maxComplexity.value} (${n.summary.maxComplexity.file})`,``,`### Top files by complexity`,``,`| File | Lines | Code | Complexity | Cognitive | Functions | Imports |`,`|------|-------|------|------------|-----------|-----------|---------|`];for(let e of n.files.slice(0,20)){let t=e.cognitiveComplexity===void 0?`—`:String(e.cognitiveComplexity);r.push(`| ${e.path} | ${e.lines.total} | ${e.lines.code} | ${e.complexity} | ${t} | ${e.functions} | ${e.imports} |`)}n.files.length>20&&r.push(``,`_...and ${n.files.length-20} more files_`);let i={summary:{totalFiles:n.summary.totalFiles,totalLines:n.summary.totalLines,totalCodeLines:n.summary.totalCodeLines,totalFunctions:n.summary.totalFunctions,avgComplexity:n.summary.avgComplexity,maxComplexity:{value:n.summary.maxComplexity.value,file:n.summary.maxComplexity.file}},files:n.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:r.join(`
|
|
529
|
+
`)}],structuredContent:i}}catch(e){return lf.error(`Measure failed`,j(e)),W(`INTERNAL`,`Measure failed: ${e instanceof Error?e.message:String(e)}`)}})}function hf(e){let t=V(`changelog`);e.registerTool(`changelog`,{title:t.title,description:`Generate a changelog from git history between two refs. Groups by conventional commit type.`,inputSchema:{from:N.string().max(200).describe(`Start ref (tag, SHA, HEAD~N)`),to:N.string().max(200).default(`HEAD`).describe(`End ref (default: HEAD)`),format:N.enum([`grouped`,`chronological`,`per-scope`]).default(`grouped`).describe(`Output format`),include_breaking:N.boolean().default(!0).describe(`Highlight breaking changes`),cwd:N.string().optional().describe(`Repository root or working directory`)},annotations:t.annotations},async({from:e,to:t,format:n,include_breaking:r,cwd:i})=>{try{let a=de({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 lf.error(`Changelog failed`,j(e)),W(`INTERNAL`,`Changelog failed: ${e instanceof Error?e.message:String(e)}`)}})}function gf(e){let t=V(`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:N.string().max(5e5).describe(`JSON data to validate (as string)`),schema:N.string().max(5e5).describe(`JSON Schema to validate against (as string)`)},annotations:t.annotations},async({data:e,schema:t})=>{try{let n=At({data:JSON.parse(e),schema:JSON.parse(t)});if(n.valid)return{content:[{type:`text`,text:`## Validation: PASSED
|
|
530
530
|
|
|
531
531
|
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(`
|
|
532
|
-
`)}]}}catch(e){return
|
|
533
|
-
`)}],structuredContent:a}})}function
|
|
534
|
-
`)}],structuredContent:o}}catch(e){return
|
|
532
|
+
`)}]}}catch(e){return lf.error(`Schema validation failed`,j(e)),W(`INTERNAL`,`Schema validation failed: ${e instanceof Error?e.message:String(e)}`)}})}function _f(e){let t=V(`env`);e.registerTool(`env`,{title:t.title,description:`Get system and runtime environment info. Sensitive env vars are redacted by default.`,outputSchema:$i,inputSchema:{include_env:N.boolean().default(!1).describe(`Include environment variables`),filter_env:N.string().optional().describe(`Filter env vars by name substring`),show_sensitive:N.boolean().default(!1).describe(`Show sensitive values (keys, tokens, etc.) — redacted by default`)},annotations:t.annotations},async({include_env:e,filter_env:t,show_sensitive:n})=>{let r=je({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(`
|
|
533
|
+
`)}],structuredContent:a}})}function vf(e){let t=V(`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:ea,inputSchema:{operation:N.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:N.string().optional().describe(`Date input (ISO, unix timestamp, or parseable string). For diff: two comma-separated dates`),timezone:N.string().optional().describe(`Target timezone (e.g., "America/New_York", "Asia/Tokyo")`),duration:N.string().optional().describe(`Duration to add (e.g., "2h30m", "1d", "30s") — for add operation`)},annotations:t.annotations},async({operation:e,input:t,timezone:n,duration:r})=>{try{let i=Ut({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(`
|
|
534
|
+
`)}],structuredContent:o}}catch(e){return lf.error(`Time failed`,j(e)),W(`INTERNAL`,`Time failed: ${e instanceof Error?e.message:String(e)}`)}})}function yf(e){try{let t=v(e,`.flows`);if(!o(t))return null;let n=l(t,{withFileTypes:!0});for(let e of n){if(!e.isDirectory())continue;let n=v(t,e.name,`meta.json`);if(o(n)&&JSON.parse(c(n,`utf-8`)).status===`active`)return e.name}}catch{return null}return null}function bf(e,t,n,r,i,a,o,s,c){let l=new ni,u=n.sources[0]?.path??process.cwd(),d={activeSlug:null};d.activeSlug=yf(u);let f=new Zr(v(u,`.aikit-state`,`flow-context`),()=>d.activeSlug),p=new Hr;p.register(zr),p.register(pr),p.register(Ir),p.register(ur),p.register(or),p.register(sr),p.register(Vr),p.register(Fr(()=>d.activeSlug?{active:!0,slug:d.activeSlug}:null));let m=new qr(p,t.curated,{},f);l.use(Gr(m),{order:5,name:`auto-knowledge`}),l.use(yi(),{order:10,name:`replay`}),l.use(ki(),{order:50,name:`structured-content-guard`}),l.use(Xr(Yr(n.tokenBudget)),{order:90,name:`compression`}),Pi(e,l,n.toolPrefix??``);let h=c??Ji(n,[...z,...Ci],B,Ti(n)),g=e=>h.has(e),_=[...h].filter(e=>wi.has(e)?Si.includes(e)?!!t.bridge:e===`er_update_policy`?!!t.policyStore:e===`er_evolve_review`?!!t.evolutionCollector:!1:!0);g(`search`)&&Jd(e,t.embedder,t.store,t.graphStore,t.bridge,t.evolutionCollector,a);let y={store:t.store,graphStore:t.graphStore,embedder:t.embedder};g(`lookup`)&&Wc(e,t.store,y);let b={onboardComplete:t.onboardComplete,onboardTimestamp:t.onboardTimestamp};g(`status`)&&cf(e,t.store,t.graphStore,t.curated,b,n,o,s),g(`config`)&&Lo(e,n),g(`reindex`)&&jd(e,t.indexer,n,t.curated,t.store,i,o),g(`knowledge`)&&Hc(e,t.curated,t.policyStore,t.evolutionCollector,i,f),g(`analyze`)&&to(e,t.store,t.embedder,y),g(`blast_radius`)&&no(e,t.store,t.embedder,t.graphStore,y),g(`produce_knowledge`)&&Ad(e,n),g(`onboard`)&&al(e,t.store,t.embedder,n,b,y),g(`graph`)&&Qs(e,t.graphStore),g(`audit`)&&so(e,t.store,t.embedder,n.tokenBudget),g(`compact`)&&qo(e,t.embedder,t.fileCache,u,n.allRoots,y),g(`scope_map`)&&Jo(e,t.embedder,t.store,y),g(`find`)&&Yo(e,t.embedder,t.store,u,y),g(`parse_output`)&&ls(e),g(`workset`)&&sl(e),g(`check`)&&os(e,y,n.tokenBudget),g(`symbol`)&&Xo(e,t.embedder,t.store,t.graphStore),g(`eval`)&&ss(e),g(`test_run`)&&cs(e,y),g(`stash`)&&cl(e),g(`git_context`)&&Kc(e),g(`diff_parse`)&&qc(e),g(`rename`)&&Jc(e),g(`codemod`)&&Yc(e),g(`restore`)&&Fd(e),g(`file_summary`)&&Zo(e,t.fileCache,u,n.allRoots,y),g(`checkpoint`)&&ll(e),g(`data_transform`)&&Xc(e),g(`trace`)&&Qo(e,t.embedder,t.store,t.graphStore),g(`process`)&&ec(e),g(`watch`)&&tc(e),g(`dead_symbols`)&&$o(e,t.embedder,t.store,u,n.allRoots,y),g(`delegate`)&&us(e,a),g(`health`)&&nc(e),g(`lane`)&&ul(e),g(`queue`)&&dl(e),g(`web_fetch`)&&rc(e),g(`guide`)&&ic(e,o),$c.some(e=>g(e))&&el(e,n,_),g(`evidence_map`)&&Ws(e),g(`digest`)&&Gs(e,t.embedder),g(`forge_classify`)&&Ks(e),g(`stratum_card`)&&qs(e,t.embedder,t.fileCache),g(`forge_ground`)&&Js(e,t.embedder,t.store),g(`present`)&&Ed(e,r),g(`web_search`)&&uf(e),g(`http`)&&df(e),g(`regex_test`)&&ff(e),g(`encode`)&&pf(e),g(`measure`)&&mf(e),g(`changelog`)&&hf(e),g(`schema_validate`)&&gf(e),g(`env`)&&_f(e),g(`time`)&&vf(e),g(`flow`)&&Hs(e,n,e=>{d.activeSlug=e}),t.bridge&&Si.some(e=>g(e))&&(fo(e,t.bridge,t.evolutionCollector),po(e,t.bridge),mo(e,t.bridge)),t.policyStore&&g(`er_update_policy`)&&_l(e,t.policyStore),t.evolutionCollector&&g(`er_evolve_review`)&&is(e,t.evolutionCollector),xi(e,t.store,t.curated),g(`replay`)&&Nd(e),g(`session_digest`)&&Xd(e,a)}function xf(e,t,n){let r=e=>!n||n.has(e);r(`check`)&&os(e,void 0,t.tokenBudget),r(`eval`)&&ss(e),r(`test_run`)&&cs(e),r(`parse_output`)&&ls(e),r(`delegate`)&&us(e),r(`git_context`)&&Kc(e),r(`diff_parse`)&&qc(e),r(`rename`)&&Jc(e),r(`codemod`)&&Yc(e),r(`data_transform`)&&Xc(e),r(`workset`)&&sl(e),r(`stash`)&&cl(e),r(`checkpoint`)&&ll(e),r(`restore`)&&Fd(e),r(`lane`)&&ul(e),r(`queue`)&&dl(e),r(`session_digest`)&&Xd(e),r(`health`)&&nc(e),r(`process`)&&ec(e),r(`watch`)&&tc(e),r(`web_fetch`)&&rc(e),r(`guide`)&&ic(e),$c.some(e=>r(e))&&el(e,t,[...n??new Set(z)]),r(`evidence_map`)&&Ws(e),r(`forge_classify`)&&Ks(e),r(`present`)&&Ed(e),r(`produce_knowledge`)&&Ad(e),r(`replay`)&&Nd(e),r(`status`)&&sf(e),r(`flow`)&&Hs(e,t),r(`web_search`)&&uf(e),r(`http`)&&df(e),r(`regex_test`)&&ff(e),r(`encode`)&&pf(e),r(`measure`)&&mf(e),r(`changelog`)&&hf(e),r(`schema_validate`)&&gf(e),r(`env`)&&_f(e),r(`time`)&&vf(e)}const Sf=k(`resource-notifier`);var Cf=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){Sf.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){Sf.debug(`sendResourceUpdated failed`,{uri:e,error:String(t)})}}};const Z=k(`server`);async function wf(n){Z.info(`Initializing AI Kit components`);let r=n.store.backend,i=n.store.path,a=null;if(r===`sqlite-vec`){let e=v(i,`aikit.db`);a=await Mn(e),Z.info(`SQLite adapter ready`,{type:a.type,vectorCapable:a.vectorCapable,dbPath:e}),a.vectorCapable||Z.warn(`┌──────────────────────────────────────────────────────────────────┐
|
|
535
535
|
│ ⚠ SQLite vector extension unavailable — DEGRADED MODE │
|
|
536
536
|
│ Vector search is disabled. Hybrid search returns FTS only. │
|
|
537
537
|
│ To enable: install/rebuild better-sqlite3 (native module). │
|
|
538
|
-
└──────────────────────────────────────────────────────────────────┘`);let t=v(i,`lance`);o(t)&&Z.info(`Old LanceDB data found at ${t} — ignored. Safe to delete after verifying sqlite-vec works.`)}let[s,c,l,u]=await Promise.all([(async()=>{if(n.embedding.childProcess!==!1){let e=new Bn({model:n.embedding.model,dimensions:n.embedding.dimensions,interOpNumThreads:n.embedding.interOpNumThreads,intraOpNumThreads:n.embedding.intraOpNumThreads,idleTimeoutMs:n.embedding.idleTimeoutMs});return await e.initialize(),Z.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(),Z.info(`Embedder loaded (in-process)`,{modelId:t.modelId,dimensions:t.dimensions}),t})(),(async()=>{let e=await Nn({backend:r,path:i,adapter:a??void 0,embeddingDim:n.embedding.dimensions});return await e.initialize(),Z.info(`Store initialized`,{backend:r}),e})(),(async()=>{let e=a?new jn({adapter:a}):new jn({path:i});return await e.initialize(),Z.info(`Graph store initialized`,{shared:!!a}),e})(),(async()=>{let e=await xn();if(e){let e=yn.get();Z.info(`WASM tree-sitter enabled`,{grammars:e.grammarCount,dir:e.wasmDir})}else{let e=yn.get();Z.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})()]),d=new Hn(s,c),p=new Vn(n.store.path);p.load(),d.setHashCache(p);let m=n.curated.path,h=new e(m);await h.initialize();let g=new t(m,c,s,h);d.setGraphStore(l);let _=uo(n.er),y=_?new Tn(n.curated.path):void 0;y&&Z.info(`Policy store initialized`,{ruleCount:y.getRules().length});let x=_?new wn:void 0,S=b(n.sources[0]?.path??process.cwd(),C.aiContext),w=o(S),T=n.onboardDir?o(n.onboardDir):!1,E=w||T,D,O=w?S:n.onboardDir;if(E&&O)try{D=f(O).mtime.toISOString()}catch{}return Z.info(`Onboard state detected`,{onboardComplete:E,onboardTimestamp:D,aiKbExists:w,onboardDirExists:T}),{embedder:s,store:c,indexer:d,curated:g,graphStore:l,fileCache:new oe,bridge:_,policyStore:y,evolutionCollector:x,onboardComplete:E,onboardTimestamp:D}}function
|
|
538
|
+
└──────────────────────────────────────────────────────────────────┘`);let t=v(i,`lance`);o(t)&&Z.info(`Old LanceDB data found at ${t} — ignored. Safe to delete after verifying sqlite-vec works.`)}let[s,c,l,u]=await Promise.all([(async()=>{if(n.embedding.childProcess!==!1){let e=new Bn({model:n.embedding.model,dimensions:n.embedding.dimensions,interOpNumThreads:n.embedding.interOpNumThreads,intraOpNumThreads:n.embedding.intraOpNumThreads,idleTimeoutMs:n.embedding.idleTimeoutMs});return await e.initialize(),Z.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(),Z.info(`Embedder loaded (in-process)`,{modelId:t.modelId,dimensions:t.dimensions}),t})(),(async()=>{let e=await Nn({backend:r,path:i,adapter:a??void 0,embeddingDim:n.embedding.dimensions});return await e.initialize(),Z.info(`Store initialized`,{backend:r}),e})(),(async()=>{let e=a?new jn({adapter:a}):new jn({path:i});return await e.initialize(),Z.info(`Graph store initialized`,{shared:!!a}),e})(),(async()=>{let e=await xn();if(e){let e=yn.get();Z.info(`WASM tree-sitter enabled`,{grammars:e.grammarCount,dir:e.wasmDir})}else{let e=yn.get();Z.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})()]),d=new Hn(s,c),p=new Vn(n.store.path);p.load(),d.setHashCache(p);let m=n.curated.path,h=new e(m);await h.initialize();let g=new t(m,c,s,h);d.setGraphStore(l);let _=uo(n.er),y=_?new Tn(n.curated.path):void 0;y&&Z.info(`Policy store initialized`,{ruleCount:y.getRules().length});let x=_?new wn:void 0,S=b(n.sources[0]?.path??process.cwd(),C.aiContext),w=o(S),T=n.onboardDir?o(n.onboardDir):!1,E=w||T,D,O=w?S:n.onboardDir;if(E&&O)try{D=f(O).mtime.toISOString()}catch{}return Z.info(`Onboard state detected`,{onboardComplete:E,onboardTimestamp:D,aiKbExists:w,onboardDirExists:T}),{embedder:s,store:c,indexer:d,curated:g,graphStore:l,fileCache:new oe,bridge:_,policyStore:y,evolutionCollector:x,onboardComplete:E,onboardTimestamp:D}}function Tf(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(`, `)}.`];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(` `)}const Ef=k(`background-task`);var Df=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,Ef.info(`Background task started`,{task:e.name,pending:this.queue.length});let t=Date.now();try{await e.fn();let n=Date.now()-t;Ef.info(`Background task completed`,{task:e.name,durationMs:n}),e.resolve()}catch(n){let r=Date.now()-t;Ef.error(`Background task failed`,{task:e.name,durationMs:r,err:n}),e.reject(n instanceof Error?n:Error(String(n)))}}this.running=null}};const Of=k(`idle-timer`);var kf=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){Of.info(`Idle timeout reached with no active session — skipping cleanup (waiting for first tool call)`);return}if(this._busy){Of.info(`Skipping idle cleanup — background work in progress`);return}Of.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`&&Of.warn(`Idle cleanup callback failed`,{error:String(t.reason)})}};const Af=k(`memory-monitor`);var jf=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(),Af.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`?Af.warn(`Memory CRITICAL: ${n}MB RSS — consider restarting the server`):t===`warning`?Af.warn(`Memory WARNING: ${n}MB RSS`):this.lastLevel!==`normal`&&Af.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 Mf=k(`tool-timeout`),Nf=new Set([`onboard`,`reindex`,`produce_knowledge`,`analyze`,`codemod`,`audit`]);var Pf=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 Ff(e){return Nf.has(e)?6e5:12e4}function If(e,t,n){return new Promise((r,i)=>{let a=!1,o=setTimeout(()=>{if(!a){a=!0;let e=new Pf(n,t);Mf.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 Q=k(`server`);function Lf(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 Rf(e,t){let n=t.toLowerCase(),r;try{({rm:r}=await import(`node:fs/promises`))}catch{return}if(n.includes(`embedding`)||n.includes(`onnx`)||n.includes(`protobuf`)||n.includes(`model`)){let t=e.embedding?.model??T.model,n=v(In(),`.cache`,`huggingface`,`transformers-js`,t);try{await r(n,{recursive:!0,force:!0}),Q.info(`Auto-heal: cleared embedding model cache`,{path:n})}catch{}}if(n.includes(`lance`)||n.includes(`database`)||n.includes(`store`)){let t=v(e.store.path,`lance`);try{await r(t,{recursive:!0,force:!0}),Q.info(`Auto-heal: cleared LanceDB store`,{path:t})}catch{}}if(n.includes(`sqlite`)||n.includes(`database disk image`)||n.includes(`graph`)){let t=v(e.store.path,`graph.db`);try{await r(t,{force:!0}),Q.info(`Auto-heal: cleared graph database`,{path:t})}catch{}}}function zf(e,t){let n=Ji(e,z,B,Ti(e)),i=Tf(e,n,B),a=new an({name:e.serverName??`aikit`,version:r()},{capabilities:{logging:{},completions:{},prompts:{}},instructions:i}),o=`initializing`,s=``,c=!1,l=null,u=null,d=null;function f(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 p=()=>o===`failed`?[`❌ AI Kit initialization failed — this tool is unavailable.`,``,s?`Error: ${s}`:``,``,`**${Oi.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(`
|
|
539
539
|
`):[`AI Kit is still initializing (loading embeddings model & store).`,``,`**${Oi.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(`
|
|
540
|
-
`);Gn(a),Pi(a,new ni,e.toolPrefix??``);let m=a.sendToolListChanged.bind(a);a.sendToolListChanged=()=>{};let h=[];for(let e of z){if(!n.has(e))continue;let t=V(e),r=a.registerTool(e,{title:t.title,description:`${t.title} — initializing, available shortly`,inputSchema:{},annotations:t.annotations},async()=>({content:[{type:`text`,text:p()}]}));Oi.has(e)?r.remove():h.push(r)}
|
|
540
|
+
`);Gn(a),Pi(a,new ni,e.toolPrefix??``);let m=a.sendToolListChanged.bind(a);a.sendToolListChanged=()=>{};let h=[];for(let e of z){if(!n.has(e))continue;let t=V(e),r=a.registerTool(e,{title:t.title,description:`${t.title} — initializing, available shortly`,inputSchema:{},annotations:t.annotations},async()=>({content:[{type:`text`,text:p()}]}));Oi.has(e)?r.remove():h.push(r)}xf(a,e,n),a.sendToolListChanged=m;let g=a.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`}]})),_=a.registerPrompt(`_init`,{description:`Initializing AI Kit…`,argsSchema:{_dummy:un(N.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}=await import(`node:fs`),{fileURLToPath:n}=await import(`node:url`),{resolve:r,dirname:i}=await import(`node:path`),a=e(import.meta.url),o=r(i(n(import.meta.url)),`..`,`package.json`),s=JSON.parse(t(o,`utf8`)),c=Object.keys(s.dependencies??{}),l=[];for(let e of c)try{a.resolve(e)}catch{l.push(e)}l.length>0&&Q.warn(`${l.length} dependencies not resolvable — init may fail`,{missing:l,hint:`Corrupted npx cache from interrupted downloads. Try: npx clear-npx-cache`})}catch{}let n;try{n=await wf(e)}catch(t){let r=t instanceof Error?t.message:String(t);if(Lf(r)){Q.warn(`AI Kit initialization failed with recoverable error — attempting auto-heal retry`,{error:r}),await Rf(e,r);try{n=await wf(e),Q.info(`AI Kit auto-heal successful — initialization recovered after retry`)}catch(e){o=`failed`,s=e instanceof Error?e.message:String(e),Q.error(`AI Kit initialization failed after auto-heal attempt — server continuing with zero-dep tools only`,{error:s,originalError:r}),y?.(e instanceof Error?e:Error(s));return}}else{o=`failed`,s=r,Q.error(`AI Kit initialization failed — server continuing with zero-dep tools only`,{error:s}),y?.(t instanceof Error?t:Error(s));return}}let r=a.sendToolListChanged.bind(a);a.sendToolListChanged=()=>{};let i=a.sendPromptListChanged.bind(a);a.sendPromptListChanged=()=>{};let p=a.sendResourceListChanged.bind(a);a.sendResourceListChanged=()=>{};for(let e of h)e.remove();g.remove(),_.remove();let m=a._registeredTools??{};for(let e of Oi)m[e]?.remove();let b=new Cf(a),x=hs(a);bf(a,n,e,Un(a),b,x,t,t===`smart`?(()=>{let e=d;return e?.getState?e.getState():null}):null),nr(a,{curated:n.curated,store:n.store,graphStore:n.graphStore},t),a.sendToolListChanged=r,a.sendPromptListChanged=i,a.sendResourceListChanged=p,Promise.resolve(a.sendToolListChanged()).catch(()=>{}),Promise.resolve(a.sendPromptListChanged()).catch(()=>{}),Promise.resolve(a.sendResourceListChanged()).catch(()=>{});let C=a._registeredTools??{};for(let[e,t]of Object.entries(C)){if(Ei.has(e))continue;let r=t.handler;t.handler=async(...t)=>{if(!n.indexer.isIndexing)return r(...t);let i=c?`re-indexing`:`running initial index`,a=new Promise(t=>setTimeout(()=>t({content:[{type:`text`,text:`⏳ AI Kit is ${i}. The tool "${e}" timed out waiting for index data (${Di/1e3}s).\n\nThe existing index may be temporarily locked. Please retry shortly — indexing will complete automatically.`}]}),Di));return Promise.race([r(...t),a])}}for(let[e,t]of Object.entries(C)){let n=t.handler,r=Ff(e);t.handler=async(...t)=>{try{return await If(()=>n(...t),r,e)}catch(t){if(t instanceof Pf)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.`}]};throw t}}}let w=Object.keys(C).length;w<z.length&&Q.warn(`ALL_TOOL_NAMES count mismatch`,{expectedToolCount:z.length,registeredToolCount:w}),Q.info(`MCP server configured`,{toolCount:z.length,resourceCount:4});let T=new jf;T.onPressure((e,t)=>{e===`warning`&&Yn(),e===`critical`&&(Q.warn(`Memory pressure critical — consider restarting`,{rssMB:Math.round(t/1024/1024)}),Yn())}),T.registerMemoryPressureCallback(()=>n.embedder.shutdown?.()),T.start();let D=new kf;u=D,D.onIdle(async()=>{if(E.isRunning||n.indexer.isIndexing){Q.info(`Idle cleanup deferred — background tasks still running`),D.touch();return}Q.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(),d){let t=f(e[0]);t.length>0&&d.prioritize(...t)}return t(...e)}}process.stdin.on(`end`,()=>(Q.info(`stdin closed — MCP client disconnected. Shutting down.`),process.exit(0))),process.stdin.on(`error`,()=>(Q.info(`stdin error — MCP client disconnected. Shutting down.`),process.exit(0))),l=n,v?.(n)})(),T=async()=>{let t;try{t=await b}catch{Q.warn(`Skipping initial index — AI Kit initialization failed`);return}u?.setBusy(!0);try{let n=e.sources.map(e=>e.path).join(`, `);Q.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&&Q.debug(`Indexing file`,{current:e.filesProcessed+1,total:e.filesTotal,file:e.currentFile}),e.phase===`cleanup`&&Q.debug(`Index cleanup`,{staleEntries:e.filesTotal-e.filesProcessed}))});c=!0,Q.info(`Initial index complete`,{filesProcessed:r.filesProcessed,filesSkipped:r.filesSkipped,chunksCreated:r.chunksCreated,durationMs:r.durationMs});try{await t.store.createFtsIndex()}catch(e){Q.warn(`FTS index creation failed`,j(e))}try{let e=await t.curated.reindexAll();Q.info(`Curated re-index complete`,{indexed:e.indexed})}catch(e){Q.error(`Curated re-index failed`,j(e))}}catch(e){Q.error(`Initial index failed; will retry on aikit_reindex`,j(e))}finally{u?.setBusy(!1)}},E=new Df,D=()=>E.schedule({name:`initial-index`,fn:T}),O=process.ppid,ee=setInterval(()=>{try{process.kill(O,0)}catch{Q.info(`Parent process died; shutting down`,{parentPid:O}),clearInterval(ee),d?.stop&&d.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.store.close().catch(()=>{})])}).catch(()=>{}).finally(()=>process.exit(0))}},5e3);return ee.unref(),{server:a,startInit:C,ready:w,runInitialIndex:D,get aikit(){return l},scheduler:E,setSmartScheduler(e){d=e}}}const $=k(`server`);function Bf(e,t){let n=Ji(t,[...z,...Ci],B,Ti(t)),i=Tf(t,n,B),a=new an({name:t.serverName??`aikit`,version:r()},{capabilities:{logging:{},completions:{},prompts:{}},instructions:i});return Gn(a),bf(a,e,t,Un(a),new Cf(a),hs(a),void 0,null,n),nr(a,{curated:e.curated,store:e.store,graphStore:e.graphStore},t.indexMode),a}async function Vf(e){let t=await wf(e),n=Bf(t,e);$.info(`MCP server configured`,{toolCount:z.length,resourceCount:2});let r=async()=>{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}))});$.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`,j(e))}try{let e=await t.curated.reindexAll();$.info(`Curated re-index complete`,{indexed:e.indexed})}catch(e){$.error(`Curated re-index failed`,j(e))}}catch(e){$.error(`Initial index failed; will retry on aikit_reindex`,j(e))}},i=async()=>{$.info(`Shutting down`),await Promise.all([t.embedder.shutdown?.().catch(()=>{})??Promise.resolve(),t.graphStore.close().catch(()=>{}),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{$.info(`Parent process died; shutting down`,{parentPid:a}),clearInterval(o),i()}},5e3);return o.unref(),{server:n,runInitialIndex:r,shutdown:i}}export{z as ALL_TOOL_NAMES,zf as createLazyServer,Bf as createMcpServer,Vf as createServer,wf as initializeAikit,bf as registerMcpTools};
|